From 4308453088d7fc767bd86c1c7806f499d34a0a26 Mon Sep 17 00:00:00 2001
From: "oscal-compass-bot[bot]"
 <185132457+oscal-compass-bot[bot]@users.noreply.github.com>
Date: Thu, 5 Dec 2024 14:46:20 +0000
Subject: [PATCH] Deployed 6f515493 to latest with MkDocs 1.6.1 and mike 2.1.3

---
 latest/404.html                               |    1 +
 .../Canonical_trestle_auditree_workflows.png  |  Bin 0 -> 161907 bytes
 latest/assets/README                          |    1 +
 latest/assets/_mkdocstrings.css               |  143 +
 ...anonical_trestle_auditree_workflows.drawio |    1 +
 latest/assets/favicon.ico                     |  Bin 0 -> 12014 bytes
 latest/assets/images/favicon.png              |  Bin 0 -> 1870 bytes
 .../assets/images/social/contributing/DCO.png |  Bin 0 -> 46269 bytes
 .../social/contributing/code_of_conduct.png   |  Bin 0 -> 33332 bytes
 .../contributing/github_actions_setup.png     |  Bin 0 -> 42810 bytes
 .../images/social/contributing/index.png      |  Bin 0 -> 32039 bytes
 .../social/contributing/maintainers.png       |  Bin 0 -> 27216 bytes
 .../contributing/oscal_object_model.png       |  Bin 0 -> 39647 bytes
 .../images/social/contributing/plugins.png    |  Bin 0 -> 46313 bytes
 .../images/social/contributing/website.png    |  Bin 0 -> 42197 bytes
 latest/assets/images/social/demos.png         |  Bin 0 -> 26108 bytes
 latest/assets/images/social/index.png         |  Bin 0 -> 33541 bytes
 latest/assets/images/social/installation.png  |  Bin 0 -> 27694 bytes
 .../images/social/known_limitations.png       |  Bin 0 -> 30165 bytes
 latest/assets/images/social/license.png       |  Bin 0 -> 26143 bytes
 .../assets/images/social/plugins/fedramp.png  |  Bin 0 -> 41425 bytes
 .../social/reference/API/trestle/cli.png      |  Bin 0 -> 25580 bytes
 .../API/trestle/common/common_types.png       |  Bin 0 -> 29640 bytes
 .../reference/API/trestle/common/const.png    |  Bin 0 -> 28735 bytes
 .../reference/API/trestle/common/err.png      |  Bin 0 -> 28760 bytes
 .../API/trestle/common/file_utils.png         |  Bin 0 -> 29849 bytes
 .../API/trestle/common/list_utils.png         |  Bin 0 -> 29403 bytes
 .../API/trestle/common/load_validate.png      |  Bin 0 -> 31118 bytes
 .../reference/API/trestle/common/log.png      |  Bin 0 -> 30860 bytes
 .../API/trestle/common/model_utils.png        |  Bin 0 -> 29238 bytes
 .../API/trestle/common/str_utils.png          |  Bin 0 -> 28910 bytes
 .../reference/API/trestle/common/trash.png    |  Bin 0 -> 30211 bytes
 .../API/trestle/common/type_utils.png         |  Bin 0 -> 32042 bytes
 .../API/trestle/core/all_validator.png        |  Bin 0 -> 31630 bytes
 .../reference/API/trestle/core/base_model.png |  Bin 0 -> 30981 bytes
 .../API/trestle/core/catalog/catalog_api.png  |  Bin 0 -> 31669 bytes
 .../core/catalog/catalog_interface.png        |  Bin 0 -> 31561 bytes
 .../trestle/core/catalog/catalog_merger.png   |  Bin 0 -> 31445 bytes
 .../trestle/core/catalog/catalog_reader.png   |  Bin 0 -> 31502 bytes
 .../trestle/core/catalog/catalog_writer.png   |  Bin 0 -> 31981 bytes
 .../API/trestle/core/catalog_validator.png    |  Bin 0 -> 31631 bytes
 .../API/trestle/core/commands/add.png         |  Bin 0 -> 29771 bytes
 .../API/trestle/core/commands/assemble.png    |  Bin 0 -> 30207 bytes
 .../trestle/core/commands/author/catalog.png  |  Bin 0 -> 30573 bytes
 .../trestle/core/commands/author/command.png  |  Bin 0 -> 31663 bytes
 .../trestle/core/commands/author/common.png   |  Bin 0 -> 31610 bytes
 .../core/commands/author/component.png        |  Bin 0 -> 31976 bytes
 .../trestle/core/commands/author/consts.png   |  Bin 0 -> 30061 bytes
 .../API/trestle/core/commands/author/docs.png |  Bin 0 -> 30012 bytes
 .../trestle/core/commands/author/folders.png  |  Bin 0 -> 30099 bytes
 .../trestle/core/commands/author/headers.png  |  Bin 0 -> 30147 bytes
 .../trestle/core/commands/author/jinja.png    |  Bin 0 -> 30234 bytes
 .../API/trestle/core/commands/author/prof.png |  Bin 0 -> 30253 bytes
 .../API/trestle/core/commands/author/ssp.png  |  Bin 0 -> 30267 bytes
 .../author/versioning/template_versioning.png |  Bin 0 -> 34039 bytes
 .../trestle/core/commands/command_docs.png    |  Bin 0 -> 31508 bytes
 .../core/commands/common/cmd_utils.png        |  Bin 0 -> 31715 bytes
 .../core/commands/common/return_codes.png     |  Bin 0 -> 31681 bytes
 .../API/trestle/core/commands/create.png      |  Bin 0 -> 29842 bytes
 .../API/trestle/core/commands/describe.png    |  Bin 0 -> 30242 bytes
 .../API/trestle/core/commands/href.png        |  Bin 0 -> 29807 bytes
 .../API/trestle/core/commands/import_.png     |  Bin 0 -> 30174 bytes
 .../API/trestle/core/commands/init.png        |  Bin 0 -> 29791 bytes
 .../API/trestle/core/commands/merge.png       |  Bin 0 -> 30297 bytes
 .../core/commands/partial_object_validate.png |  Bin 0 -> 33026 bytes
 .../API/trestle/core/commands/remove.png      |  Bin 0 -> 30114 bytes
 .../API/trestle/core/commands/replicate.png   |  Bin 0 -> 30234 bytes
 .../API/trestle/core/commands/split.png       |  Bin 0 -> 30089 bytes
 .../API/trestle/core/commands/task.png        |  Bin 0 -> 30086 bytes
 .../API/trestle/core/commands/validate.png    |  Bin 0 -> 30238 bytes
 .../API/trestle/core/commands/version.png     |  Bin 0 -> 30126 bytes
 .../API/trestle/core/control_context.png      |  Bin 0 -> 28646 bytes
 .../API/trestle/core/control_interface.png    |  Bin 0 -> 28433 bytes
 .../API/trestle/core/control_reader.png       |  Bin 0 -> 28380 bytes
 .../API/trestle/core/control_writer.png       |  Bin 0 -> 28858 bytes
 .../API/trestle/core/crm/bycomp_interface.png |  Bin 0 -> 32145 bytes
 .../API/trestle/core/crm/export_reader.png    |  Bin 0 -> 31202 bytes
 .../API/trestle/core/crm/export_writer.png    |  Bin 0 -> 31666 bytes
 .../trestle/core/crm/leveraged_statements.png |  Bin 0 -> 30779 bytes
 .../trestle/core/crm/ssp_inheritance_api.png  |  Bin 0 -> 30112 bytes
 .../API/trestle/core/docs_control_writer.png  |  Bin 0 -> 29931 bytes
 .../reference/API/trestle/core/draw_io.png    |  Bin 0 -> 32372 bytes
 .../API/trestle/core/duplicates_validator.png |  Bin 0 -> 32493 bytes
 .../reference/API/trestle/core/generators.png |  Bin 0 -> 31646 bytes
 .../API/trestle/core/generic_oscal.png        |  Bin 0 -> 31068 bytes
 .../reference/API/trestle/core/jinja/base.png |  Bin 0 -> 31902 bytes
 .../reference/API/trestle/core/jinja/ext.png  |  Bin 0 -> 32119 bytes
 .../API/trestle/core/jinja/filters.png        |  Bin 0 -> 31664 bytes
 .../reference/API/trestle/core/jinja/tags.png |  Bin 0 -> 32698 bytes
 .../API/trestle/core/links_validator.png      |  Bin 0 -> 31942 bytes
 .../core/markdown/base_markdown_node.png      |  Bin 0 -> 34762 bytes
 .../core/markdown/control_markdown_node.png   |  Bin 0 -> 35116 bytes
 .../core/markdown/docs_markdown_node.png      |  Bin 0 -> 34469 bytes
 .../trestle/core/markdown/markdown_api.png    |  Bin 0 -> 32920 bytes
 .../trestle/core/markdown/markdown_const.png  |  Bin 0 -> 34232 bytes
 .../core/markdown/markdown_processor.png      |  Bin 0 -> 34608 bytes
 .../core/markdown/markdown_validator.png      |  Bin 0 -> 34608 bytes
 .../API/trestle/core/markdown/md_writer.png   |  Bin 0 -> 32708 bytes
 .../API/trestle/core/models/actions.png       |  Bin 0 -> 29851 bytes
 .../API/trestle/core/models/elements.png      |  Bin 0 -> 29831 bytes
 .../trestle/core/models/file_content_type.png |  Bin 0 -> 30924 bytes
 .../API/trestle/core/models/interfaces.png    |  Bin 0 -> 29954 bytes
 .../API/trestle/core/models/plans.png         |  Bin 0 -> 30063 bytes
 .../API/trestle/core/object_factory.png       |  Bin 0 -> 30874 bytes
 .../reference/API/trestle/core/parser.png     |  Bin 0 -> 29956 bytes
 .../reference/API/trestle/core/pipeline.png   |  Bin 0 -> 29837 bytes
 .../reference/API/trestle/core/plugins.png    |  Bin 0 -> 32293 bytes
 .../API/trestle/core/profile_resolver.png     |  Bin 0 -> 30266 bytes
 .../API/trestle/core/refs_validator.png       |  Bin 0 -> 30780 bytes
 .../API/trestle/core/remote/cache.png         |  Bin 0 -> 28798 bytes
 .../reference/API/trestle/core/repository.png |  Bin 0 -> 29911 bytes
 .../API/trestle/core/resolver/merge.png       |  Bin 0 -> 29777 bytes
 .../API/trestle/core/resolver/modify.png      |  Bin 0 -> 29719 bytes
 .../API/trestle/core/resolver/prune.png       |  Bin 0 -> 29594 bytes
 .../core/rule_parameters_validator.png        |  Bin 0 -> 31235 bytes
 .../reference/API/trestle/core/ssp_io.png     |  Bin 0 -> 29259 bytes
 .../API/trestle/core/trestle_base_model.png   |  Bin 0 -> 28396 bytes
 .../reference/API/trestle/core/validator.png  |  Bin 0 -> 31669 bytes
 .../API/trestle/core/validator_factory.png    |  Bin 0 -> 32337 bytes
 .../API/trestle/oscal/assessment_plan.png     |  Bin 0 -> 29684 bytes
 .../API/trestle/oscal/assessment_results.png  |  Bin 0 -> 29424 bytes
 .../reference/API/trestle/oscal/catalog.png   |  Bin 0 -> 30593 bytes
 .../reference/API/trestle/oscal/common.png    |  Bin 0 -> 29724 bytes
 .../reference/API/trestle/oscal/component.png |  Bin 0 -> 30905 bytes
 .../reference/API/trestle/oscal/poam.png      |  Bin 0 -> 30482 bytes
 .../reference/API/trestle/oscal/profile.png   |  Bin 0 -> 31074 bytes
 .../reference/API/trestle/oscal/ssp.png       |  Bin 0 -> 29729 bytes
 .../reference/API/trestle/tasks/base_task.png |  Bin 0 -> 29159 bytes
 .../tasks/cis_xlsx_to_oscal_catalog.png       |  Bin 0 -> 31725 bytes
 .../API/trestle/tasks/csv_to_oscal_cd.png     |  Bin 0 -> 31498 bytes
 .../ocp4_cis_profile_to_oscal_catalog.png     |  Bin 0 -> 34996 bytes
 .../tasks/ocp4_cis_profile_to_oscal_cd.png    |  Bin 0 -> 34692 bytes
 .../trestle/tasks/oscal_catalog_to_csv.png    |  Bin 0 -> 31393 bytes
 .../tasks/oscal_profile_to_osco_profile.png   |  Bin 0 -> 32583 bytes
 .../trestle/tasks/osco_result_to_oscal_ar.png |  Bin 0 -> 30384 bytes
 .../tasks/tanium_result_to_oscal_ar.png       |  Bin 0 -> 30020 bytes
 .../reference/API/trestle/tasks/transform.png |  Bin 0 -> 29589 bytes
 .../tasks/xccdf_result_to_oscal_ar.png        |  Bin 0 -> 32023 bytes
 .../API/trestle/tasks/xlsx_helper.png         |  Bin 0 -> 30294 bytes
 .../API/trestle/tasks/xlsx_to_oscal_cd.png    |  Bin 0 -> 30711 bytes
 .../trestle/tasks/xlsx_to_oscal_profile.png   |  Bin 0 -> 31261 bytes
 .../transforms/implementations/osco.png       |  Bin 0 -> 31826 bytes
 .../transforms/implementations/tanium.png     |  Bin 0 -> 31819 bytes
 .../transforms/implementations/xccdf.png      |  Bin 0 -> 32496 bytes
 .../API/trestle/transforms/results.png        |  Bin 0 -> 29687 bytes
 .../transforms/transformer_factory.png        |  Bin 0 -> 30371 bytes
 .../trestle/transforms/transformer_helper.png |  Bin 0 -> 30222 bytes
 .../transforms/transformer_singleton.png      |  Bin 0 -> 31820 bytes
 .../third-party-result-schema-IBM-SCC.png     |  Bin 0 -> 50878 bytes
 .../OCP4_CIS_profile_to_oscal_catalog.png     |  Bin 0 -> 62539 bytes
 .../OCP4_CIS_profile_to_oscal_cd.png          |  Bin 0 -> 57933 bytes
 .../Tanium_result_to_oscal_ar.png             |  Bin 0 -> 51540 bytes
 .../csv_to_oscal_cd.png                       |  Bin 0 -> 57672 bytes
 .../transformer_construction.png              |  Bin 0 -> 59517 bytes
 .../ssp_profile_catalog_authoring.png         |  Bin 0 -> 46799 bytes
 .../Trestle_authoring/trestle_author.png      |  Bin 0 -> 47538 bytes
 .../trestle_author_jinja.png                  |  Bin 0 -> 51275 bytes
 latest/assets/images/social/tutorials/cli.png |  Bin 0 -> 35482 bytes
 .../social/tutorials/compliance_posture.png   |  Bin 0 -> 46642 bytes
 .../tutorials/introduction_to_trestle.png     |  Bin 0 -> 43150 bytes
 .../assets/javascripts/bundle.83f73b43.min.js |   16 +
 .../javascripts/bundle.83f73b43.min.js.map    |    7 +
 .../javascripts/lunr/min/lunr.ar.min.js       |    1 +
 .../javascripts/lunr/min/lunr.da.min.js       |   18 +
 .../javascripts/lunr/min/lunr.de.min.js       |   18 +
 .../javascripts/lunr/min/lunr.du.min.js       |   18 +
 .../javascripts/lunr/min/lunr.el.min.js       |    1 +
 .../javascripts/lunr/min/lunr.es.min.js       |   18 +
 .../javascripts/lunr/min/lunr.fi.min.js       |   18 +
 .../javascripts/lunr/min/lunr.fr.min.js       |   18 +
 .../javascripts/lunr/min/lunr.he.min.js       |    1 +
 .../javascripts/lunr/min/lunr.hi.min.js       |    1 +
 .../javascripts/lunr/min/lunr.hu.min.js       |   18 +
 .../javascripts/lunr/min/lunr.hy.min.js       |    1 +
 .../javascripts/lunr/min/lunr.it.min.js       |   18 +
 .../javascripts/lunr/min/lunr.ja.min.js       |    1 +
 .../javascripts/lunr/min/lunr.jp.min.js       |    1 +
 .../javascripts/lunr/min/lunr.kn.min.js       |    1 +
 .../javascripts/lunr/min/lunr.ko.min.js       |    1 +
 .../javascripts/lunr/min/lunr.multi.min.js    |    1 +
 .../javascripts/lunr/min/lunr.nl.min.js       |   18 +
 .../javascripts/lunr/min/lunr.no.min.js       |   18 +
 .../javascripts/lunr/min/lunr.pt.min.js       |   18 +
 .../javascripts/lunr/min/lunr.ro.min.js       |   18 +
 .../javascripts/lunr/min/lunr.ru.min.js       |   18 +
 .../javascripts/lunr/min/lunr.sa.min.js       |    1 +
 .../lunr/min/lunr.stemmer.support.min.js      |    1 +
 .../javascripts/lunr/min/lunr.sv.min.js       |   18 +
 .../javascripts/lunr/min/lunr.ta.min.js       |    1 +
 .../javascripts/lunr/min/lunr.te.min.js       |    1 +
 .../javascripts/lunr/min/lunr.th.min.js       |    1 +
 .../javascripts/lunr/min/lunr.tr.min.js       |   18 +
 .../javascripts/lunr/min/lunr.vi.min.js       |    1 +
 .../javascripts/lunr/min/lunr.zh.min.js       |    1 +
 latest/assets/javascripts/lunr/tinyseg.js     |  206 +
 latest/assets/javascripts/lunr/wordcut.js     | 6708 +++++++++++++++++
 .../workers/search.6ce7567c.min.js            |   42 +
 .../workers/search.6ce7567c.min.js.map        |    7 +
 .../assets/stylesheets/main.6f8fc17f.min.css  |    1 +
 .../stylesheets/main.6f8fc17f.min.css.map     |    1 +
 .../stylesheets/palette.06af60db.min.css      |    1 +
 .../stylesheets/palette.06af60db.min.css.map  |    1 +
 latest/contributing/DCO/index.html            |   37 +
 .../contributing/code_of_conduct/index.html   |    1 +
 .../github_actions_setup/index.html           |    1 +
 .../images/trestle-OSCAL-upgrade.png          |  Bin 0 -> 202666 bytes
 latest/contributing/index.html                |   27 +
 latest/contributing/maintainers/index.html    |    1 +
 .../oscal_object_model/index.html             |    5 +
 latest/contributing/plugins/index.html        |   48 +
 latest/contributing/website/index.html        |    1 +
 latest/css/mkdocstrings.min.css               |    1 +
 latest/demos/index.html                       |    1 +
 latest/index.html                             |   14 +
 latest/installation/index.html                |   47 +
 latest/known_limitations/index.html           |    1 +
 latest/license/index.html                     |  202 +
 latest/objects.inv                            |  Bin 0 -> 29133 bytes
 latest/plugins/fedramp/index.html             |    1 +
 latest/reference/API/trestle/cli/index.html   |   81 +
 .../trestle/common/common_types/index.html    |    1 +
 .../API/trestle/common/const/index.html       |    1 +
 .../API/trestle/common/err/index.html         |  197 +
 .../API/trestle/common/file_utils/index.html  |  397 +
 .../API/trestle/common/list_utils/index.html  |  248 +
 .../trestle/common/load_validate/index.html   |   35 +
 .../API/trestle/common/log/index.html         |  174 +
 .../API/trestle/common/model_utils/index.html | 3056 ++++++++
 .../API/trestle/common/str_utils/index.html   |  119 +
 .../API/trestle/common/trash/index.html       |  335 +
 .../API/trestle/common/type_utils/index.html  |   90 +
 .../API/trestle/core/all_validator/index.html |   90 +
 .../API/trestle/core/base_model/index.html    | 1420 ++++
 .../core/catalog/catalog_api/index.html       |  300 +
 .../core/catalog/catalog_interface/index.html | 2473 ++++++
 .../core/catalog/catalog_merger/index.html    |  387 +
 .../core/catalog/catalog_reader/index.html    | 1153 +++
 .../core/catalog/catalog_writer/index.html    | 1323 ++++
 .../trestle/core/catalog_validator/index.html |  121 +
 .../API/trestle/core/commands/add/index.html  |  308 +
 .../trestle/core/commands/assemble/index.html |  253 +
 .../core/commands/author/catalog/index.html   |  677 ++
 .../core/commands/author/command/index.html   |   44 +
 .../core/commands/author/common/index.html    |  145 +
 .../core/commands/author/component/index.html |  881 +++
 .../core/commands/author/consts/index.html    |    1 +
 .../core/commands/author/docs/index.html      |  806 ++
 .../core/commands/author/folders/index.html   | 1036 +++
 .../core/commands/author/headers/index.html   |  766 ++
 .../core/commands/author/jinja/index.html     |  858 +++
 .../core/commands/author/prof/index.html      | 2062 +++++
 .../core/commands/author/ssp/index.html       | 2105 ++++++
 .../versioning/template_versioning/index.html |  698 ++
 .../core/commands/command_docs/index.html     |   92 +
 .../core/commands/common/cmd_utils/index.html |  386 +
 .../commands/common/return_codes/index.html   |   50 +
 .../trestle/core/commands/create/index.html   |  239 +
 .../trestle/core/commands/describe/index.html |  363 +
 .../API/trestle/core/commands/href/index.html |  323 +
 .../trestle/core/commands/import_/index.html  |  164 +
 .../API/trestle/core/commands/init/index.html |  158 +
 .../trestle/core/commands/merge/index.html    |  600 ++
 .../partial_object_validate/index.html        |  127 +
 .../trestle/core/commands/remove/index.html   |  275 +
 .../core/commands/replicate/index.html        |  277 +
 .../trestle/core/commands/split/index.html    | 1670 ++++
 .../API/trestle/core/commands/task/index.html |  204 +
 .../trestle/core/commands/validate/index.html |   36 +
 .../trestle/core/commands/version/index.html  |   92 +
 .../trestle/core/control_context/index.html   |  435 ++
 .../trestle/core/control_interface/index.html | 3638 +++++++++
 .../trestle/core/control_reader/index.html    | 1466 ++++
 .../trestle/core/control_writer/index.html    | 1348 ++++
 .../core/crm/bycomp_interface/index.html      |  455 ++
 .../trestle/core/crm/export_reader/index.html |  572 ++
 .../trestle/core/crm/export_writer/index.html |  218 +
 .../core/crm/leveraged_statements/index.html  | 1009 +++
 .../core/crm/ssp_inheritance_api/index.html   |  467 ++
 .../core/docs_control_writer/index.html       |  629 ++
 .../API/trestle/core/draw_io/index.html       |  707 ++
 .../core/duplicates_validator/index.html      |   77 +
 .../API/trestle/core/generators/index.html    |  396 +
 .../API/trestle/core/generic_oscal/index.html | 1008 +++
 .../API/trestle/core/jinja/base/index.html    |   94 +
 .../API/trestle/core/jinja/ext/index.html     |   26 +
 .../API/trestle/core/jinja/filters/index.html |   93 +
 .../API/trestle/core/jinja/tags/index.html    |  581 ++
 .../trestle/core/links_validator/index.html   |  189 +
 .../markdown/base_markdown_node/index.html    |  792 ++
 .../markdown/control_markdown_node/index.html | 1296 ++++
 .../markdown/docs_markdown_node/index.html    |  261 +
 .../core/markdown/markdown_api/index.html     |  216 +
 .../core/markdown/markdown_const/index.html   |    1 +
 .../markdown/markdown_processor/index.html    |  342 +
 .../markdown/markdown_validator/index.html    |  752 ++
 .../core/markdown/md_writer/index.html        |  548 ++
 .../trestle/core/models/actions/index.html    | 1372 ++++
 .../trestle/core/models/elements/index.html   | 2045 +++++
 .../core/models/file_content_type/index.html  |  254 +
 .../trestle/core/models/interfaces/index.html |   61 +
 .../API/trestle/core/models/plans/index.html  |  207 +
 .../trestle/core/object_factory/index.html    |   76 +
 .../API/trestle/core/parser/index.html        |   98 +
 .../API/trestle/core/pipeline/index.html      |   74 +
 .../API/trestle/core/plugins/index.html       |   24 +
 .../trestle/core/profile_resolver/index.html  |  434 ++
 .../trestle/core/refs_validator/index.html    |   89 +
 .../API/trestle/core/remote/cache/index.html  | 1278 ++++
 .../API/trestle/core/repository/index.html    | 2299 ++++++
 .../trestle/core/resolver/merge/index.html    |  384 +
 .../trestle/core/resolver/modify/index.html   |  698 ++
 .../trestle/core/resolver/prune/index.html    |  380 +
 .../core/rule_parameters_validator/index.html |  264 +
 .../API/trestle/core/ssp_io/index.html        | 1170 +++
 .../core/trestle_base_model/index.html        |   77 +
 .../API/trestle/core/validator/index.html     |  287 +
 .../trestle/core/validator_factory/index.html |   18 +
 .../trestle/oscal/assessment_plan/index.html  |  130 +
 .../oscal/assessment_results/index.html       |  356 +
 .../API/trestle/oscal/catalog/index.html      |  194 +
 .../API/trestle/oscal/common/index.html       | 4598 +++++++++++
 .../API/trestle/oscal/component/index.html    |  511 ++
 .../API/trestle/oscal/poam/index.html         |  192 +
 .../API/trestle/oscal/profile/index.html      |  703 ++
 .../API/trestle/oscal/ssp/index.html          | 1303 ++++
 .../API/trestle/tasks/base_task/index.html    |  248 +
 .../cis_xlsx_to_oscal_catalog/index.html      | 1095 +++
 .../trestle/tasks/csv_to_oscal_cd/index.html  | 2817 +++++++
 .../index.html                                |  525 ++
 .../ocp4_cis_profile_to_oscal_cd/index.html   | 1303 ++++
 .../tasks/oscal_catalog_to_csv/index.html     | 1037 +++
 .../oscal_profile_to_osco_profile/index.html  |  304 +
 .../tasks/osco_result_to_oscal_ar/index.html  |  388 +
 .../tanium_result_to_oscal_ar/index.html      |  414 +
 .../API/trestle/tasks/transform/index.html    |    1 +
 .../tasks/xccdf_result_to_oscal_ar/index.html |  520 ++
 .../API/trestle/tasks/xlsx_helper/index.html  | 1585 ++++
 .../trestle/tasks/xlsx_to_oscal_cd/index.html |  769 ++
 .../tasks/xlsx_to_oscal_profile/index.html    |  475 ++
 .../implementations/osco/index.html           |  669 ++
 .../implementations/tanium/index.html         | 1317 ++++
 .../implementations/xccdf/index.html          |  406 +
 .../API/trestle/transforms/results/index.html |    8 +
 .../transforms/transformer_factory/index.html |  251 +
 .../transforms/transformer_helper/index.html  |  585 ++
 .../transformer_singleton/index.html          |    1 +
 ...SCC-class-for-OSCO-and-Tanium-to-OSCAL.png |  Bin 0 -> 146161 bytes
 ...CC-class-for-OSCO-and-Tanium-to-OSCAL.xlsx |  Bin 0 -> 6952 bytes
 .../index.html                                |  184 +
 latest/search/search_index.json               |    1 +
 latest/sitemap.xml                            |  615 ++
 latest/sitemap.xml.gz                         |  Bin 0 -> 1392 bytes
 ...o-ocp4-cis-profile-to-oscal-catalog.config |    4 +
 .../index.html                                |  632 ++
 .../demo-ocp4-cis-profile-to-oscal-cd.config  |   30 +
 .../enabled_rules.json                        |   32 +
 .../OCP4_CIS_profile_to_oscal_cd/index.html   |  328 +
 .../selected_rules.json                       |    5 +
 ...scarsdale_nimons_bridge.copyright-info.txt |   10 +
 ...00px-Australia_scarsdale_nimons_bridge.jpg |  Bin 0 -> 111352 bytes
 .../Tanium_result_to_oscal_ar/index.html      |  772 ++
 .../csv_to_oscal_cd/component-definition.json |  154 +
 .../demo-csv-to-oscal-cd.config               |    6 +
 .../csv_to_oscal_cd/index.html                |  213 +
 .../csv_to_oscal_cd/ocp4-sample-input.csv     |    5 +
 .../csv_to_oscal_cd/rule-name-overlap.csv     |    7 +
 .../assessment-results-nist.png               |  Bin 0 -> 56735 bytes
 .../assessment-results.drawio                 |    1 +
 .../assessment-results.jpg                    |  Bin 0 -> 43615 bytes
 .../transformer_construction/index.html       |  215 +
 .../transformer-construction.drawio           |    1 +
 .../transformer-construction.jpg              |  Bin 0 -> 28213 bytes
 .../complex_resolved_profile_catalog.drawio   |    1 +
 .../complex_resolved_profile_catalog.png      |  Bin 0 -> 9520 bytes
 .../ssp_profile_catalog_authoring/index.html  |  688 ++
 .../profile_does.drawio                       |    1 +
 .../profile_does.png                          |  Bin 0 -> 37208 bytes
 .../resolved_profile_catalog.drawio           |    1 +
 .../resolved_profile_catalog.png              |  Bin 0 -> 5773 bytes
 .../resolved_profile_diagram.drawio           |    1 +
 .../resolved_profile_diagram.png              |  Bin 0 -> 67327 bytes
 .../simple_catalog.drawio                     |    1 +
 .../simple_catalog.png                        |  Bin 0 -> 2771 bytes
 .../ssp_profile_options.docx                  |  Bin 0 -> 17256 bytes
 .../trestle_ssp_author_options.png            |  Bin 0 -> 75117 bytes
 .../trestle_author/drawio_data_menu.png       |  Bin 0 -> 329379 bytes
 .../trestle_author/drawio_editing_data.png    |  Bin 0 -> 264094 bytes
 .../trestle_author/index.html                 |  171 +
 .../trestle_author/sample_ssp.md.jinja        |   48 +
 .../trestle_author/template_versioning.png    |  Bin 0 -> 44185 bytes
 .../trestle_author_jinja/index.html           |   37 +
 latest/tutorials/cli/index.html               |  750 ++
 .../ContinuousCompliance.drawio               |    1 +
 .../ContinuousCompliance.jpg                  |  Bin 0 -> 25984 bytes
 .../tutorials/compliance_posture/index.html   |    1 +
 .../introduction_to_trestle/index.html        |  499 ++
 versions.json                                 |    7 +
 397 files changed, 92840 insertions(+)
 create mode 100644 latest/404.html
 create mode 100644 latest/assets/Canonical_trestle_auditree_workflows.png
 create mode 100644 latest/assets/README
 create mode 100644 latest/assets/_mkdocstrings.css
 create mode 100644 latest/assets/canonical_trestle_auditree_workflows.drawio
 create mode 100644 latest/assets/favicon.ico
 create mode 100644 latest/assets/images/favicon.png
 create mode 100644 latest/assets/images/social/contributing/DCO.png
 create mode 100644 latest/assets/images/social/contributing/code_of_conduct.png
 create mode 100644 latest/assets/images/social/contributing/github_actions_setup.png
 create mode 100644 latest/assets/images/social/contributing/index.png
 create mode 100644 latest/assets/images/social/contributing/maintainers.png
 create mode 100644 latest/assets/images/social/contributing/oscal_object_model.png
 create mode 100644 latest/assets/images/social/contributing/plugins.png
 create mode 100644 latest/assets/images/social/contributing/website.png
 create mode 100644 latest/assets/images/social/demos.png
 create mode 100644 latest/assets/images/social/index.png
 create mode 100644 latest/assets/images/social/installation.png
 create mode 100644 latest/assets/images/social/known_limitations.png
 create mode 100644 latest/assets/images/social/license.png
 create mode 100644 latest/assets/images/social/plugins/fedramp.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/cli.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/common_types.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/const.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/err.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/file_utils.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/list_utils.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/load_validate.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/log.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/model_utils.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/str_utils.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/trash.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/common/type_utils.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/all_validator.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/base_model.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/catalog/catalog_api.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/catalog/catalog_interface.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/catalog/catalog_merger.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/catalog/catalog_reader.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/catalog/catalog_writer.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/catalog_validator.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/add.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/assemble.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/catalog.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/command.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/common.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/component.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/consts.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/docs.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/folders.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/headers.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/jinja.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/prof.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/ssp.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/author/versioning/template_versioning.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/command_docs.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/common/cmd_utils.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/common/return_codes.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/create.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/describe.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/href.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/import_.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/init.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/merge.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/partial_object_validate.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/remove.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/replicate.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/split.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/task.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/validate.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/commands/version.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/control_context.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/control_interface.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/control_reader.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/control_writer.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/crm/bycomp_interface.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/crm/export_reader.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/crm/export_writer.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/crm/leveraged_statements.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/crm/ssp_inheritance_api.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/docs_control_writer.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/draw_io.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/duplicates_validator.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/generators.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/generic_oscal.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/jinja/base.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/jinja/ext.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/jinja/filters.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/jinja/tags.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/links_validator.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/markdown/base_markdown_node.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/markdown/control_markdown_node.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/markdown/docs_markdown_node.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/markdown/markdown_api.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/markdown/markdown_const.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/markdown/markdown_processor.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/markdown/markdown_validator.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/markdown/md_writer.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/models/actions.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/models/elements.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/models/file_content_type.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/models/interfaces.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/models/plans.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/object_factory.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/parser.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/pipeline.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/plugins.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/profile_resolver.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/refs_validator.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/remote/cache.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/repository.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/resolver/merge.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/resolver/modify.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/resolver/prune.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/rule_parameters_validator.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/ssp_io.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/trestle_base_model.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/validator.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/core/validator_factory.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/oscal/assessment_plan.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/oscal/assessment_results.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/oscal/catalog.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/oscal/common.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/oscal/component.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/oscal/poam.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/oscal/profile.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/oscal/ssp.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/base_task.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/csv_to_oscal_cd.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/oscal_catalog_to_csv.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/oscal_profile_to_osco_profile.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/osco_result_to_oscal_ar.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/tanium_result_to_oscal_ar.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/transform.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/xccdf_result_to_oscal_ar.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/xlsx_helper.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_cd.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_profile.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/transforms/implementations/osco.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/transforms/implementations/tanium.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/transforms/implementations/xccdf.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/transforms/results.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/transforms/transformer_factory.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/transforms/transformer_helper.png
 create mode 100644 latest/assets/images/social/reference/API/trestle/transforms/transformer_singleton.png
 create mode 100644 latest/assets/images/social/reference/third-party-result-schema-IBM-SCC.png
 create mode 100644 latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog.png
 create mode 100644 latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd.png
 create mode 100644 latest/assets/images/social/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar.png
 create mode 100644 latest/assets/images/social/tutorials/Transformers_and_Tasks/csv_to_oscal_cd.png
 create mode 100644 latest/assets/images/social/tutorials/Transformers_and_Tasks/transformer_construction.png
 create mode 100644 latest/assets/images/social/tutorials/Trestle_authoring/ssp_profile_catalog_authoring.png
 create mode 100644 latest/assets/images/social/tutorials/Trestle_authoring/trestle_author.png
 create mode 100644 latest/assets/images/social/tutorials/Trestle_authoring/trestle_author_jinja.png
 create mode 100644 latest/assets/images/social/tutorials/cli.png
 create mode 100644 latest/assets/images/social/tutorials/compliance_posture.png
 create mode 100644 latest/assets/images/social/tutorials/introduction_to_trestle.png
 create mode 100644 latest/assets/javascripts/bundle.83f73b43.min.js
 create mode 100644 latest/assets/javascripts/bundle.83f73b43.min.js.map
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.ar.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.da.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.de.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.du.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.el.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.es.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.fi.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.fr.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.he.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.hi.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.hu.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.hy.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.it.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.ja.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.jp.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.kn.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.ko.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.multi.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.nl.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.no.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.pt.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.ro.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.ru.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.sa.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.stemmer.support.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.sv.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.ta.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.te.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.th.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.tr.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.vi.min.js
 create mode 100644 latest/assets/javascripts/lunr/min/lunr.zh.min.js
 create mode 100644 latest/assets/javascripts/lunr/tinyseg.js
 create mode 100644 latest/assets/javascripts/lunr/wordcut.js
 create mode 100644 latest/assets/javascripts/workers/search.6ce7567c.min.js
 create mode 100644 latest/assets/javascripts/workers/search.6ce7567c.min.js.map
 create mode 100644 latest/assets/stylesheets/main.6f8fc17f.min.css
 create mode 100644 latest/assets/stylesheets/main.6f8fc17f.min.css.map
 create mode 100644 latest/assets/stylesheets/palette.06af60db.min.css
 create mode 100644 latest/assets/stylesheets/palette.06af60db.min.css.map
 create mode 100644 latest/contributing/DCO/index.html
 create mode 100644 latest/contributing/code_of_conduct/index.html
 create mode 100644 latest/contributing/github_actions_setup/index.html
 create mode 100644 latest/contributing/images/trestle-OSCAL-upgrade.png
 create mode 100644 latest/contributing/index.html
 create mode 100644 latest/contributing/maintainers/index.html
 create mode 100644 latest/contributing/oscal_object_model/index.html
 create mode 100644 latest/contributing/plugins/index.html
 create mode 100644 latest/contributing/website/index.html
 create mode 100644 latest/css/mkdocstrings.min.css
 create mode 100644 latest/demos/index.html
 create mode 100644 latest/index.html
 create mode 100644 latest/installation/index.html
 create mode 100644 latest/known_limitations/index.html
 create mode 100644 latest/license/index.html
 create mode 100644 latest/objects.inv
 create mode 100644 latest/plugins/fedramp/index.html
 create mode 100644 latest/reference/API/trestle/cli/index.html
 create mode 100644 latest/reference/API/trestle/common/common_types/index.html
 create mode 100644 latest/reference/API/trestle/common/const/index.html
 create mode 100644 latest/reference/API/trestle/common/err/index.html
 create mode 100644 latest/reference/API/trestle/common/file_utils/index.html
 create mode 100644 latest/reference/API/trestle/common/list_utils/index.html
 create mode 100644 latest/reference/API/trestle/common/load_validate/index.html
 create mode 100644 latest/reference/API/trestle/common/log/index.html
 create mode 100644 latest/reference/API/trestle/common/model_utils/index.html
 create mode 100644 latest/reference/API/trestle/common/str_utils/index.html
 create mode 100644 latest/reference/API/trestle/common/trash/index.html
 create mode 100644 latest/reference/API/trestle/common/type_utils/index.html
 create mode 100644 latest/reference/API/trestle/core/all_validator/index.html
 create mode 100644 latest/reference/API/trestle/core/base_model/index.html
 create mode 100644 latest/reference/API/trestle/core/catalog/catalog_api/index.html
 create mode 100644 latest/reference/API/trestle/core/catalog/catalog_interface/index.html
 create mode 100644 latest/reference/API/trestle/core/catalog/catalog_merger/index.html
 create mode 100644 latest/reference/API/trestle/core/catalog/catalog_reader/index.html
 create mode 100644 latest/reference/API/trestle/core/catalog/catalog_writer/index.html
 create mode 100644 latest/reference/API/trestle/core/catalog_validator/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/add/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/assemble/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/catalog/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/command/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/common/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/component/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/consts/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/docs/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/folders/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/headers/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/jinja/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/prof/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/ssp/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/author/versioning/template_versioning/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/command_docs/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/common/cmd_utils/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/common/return_codes/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/create/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/describe/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/href/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/import_/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/init/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/merge/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/partial_object_validate/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/remove/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/replicate/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/split/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/task/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/validate/index.html
 create mode 100644 latest/reference/API/trestle/core/commands/version/index.html
 create mode 100644 latest/reference/API/trestle/core/control_context/index.html
 create mode 100644 latest/reference/API/trestle/core/control_interface/index.html
 create mode 100644 latest/reference/API/trestle/core/control_reader/index.html
 create mode 100644 latest/reference/API/trestle/core/control_writer/index.html
 create mode 100644 latest/reference/API/trestle/core/crm/bycomp_interface/index.html
 create mode 100644 latest/reference/API/trestle/core/crm/export_reader/index.html
 create mode 100644 latest/reference/API/trestle/core/crm/export_writer/index.html
 create mode 100644 latest/reference/API/trestle/core/crm/leveraged_statements/index.html
 create mode 100644 latest/reference/API/trestle/core/crm/ssp_inheritance_api/index.html
 create mode 100644 latest/reference/API/trestle/core/docs_control_writer/index.html
 create mode 100644 latest/reference/API/trestle/core/draw_io/index.html
 create mode 100644 latest/reference/API/trestle/core/duplicates_validator/index.html
 create mode 100644 latest/reference/API/trestle/core/generators/index.html
 create mode 100644 latest/reference/API/trestle/core/generic_oscal/index.html
 create mode 100644 latest/reference/API/trestle/core/jinja/base/index.html
 create mode 100644 latest/reference/API/trestle/core/jinja/ext/index.html
 create mode 100644 latest/reference/API/trestle/core/jinja/filters/index.html
 create mode 100644 latest/reference/API/trestle/core/jinja/tags/index.html
 create mode 100644 latest/reference/API/trestle/core/links_validator/index.html
 create mode 100644 latest/reference/API/trestle/core/markdown/base_markdown_node/index.html
 create mode 100644 latest/reference/API/trestle/core/markdown/control_markdown_node/index.html
 create mode 100644 latest/reference/API/trestle/core/markdown/docs_markdown_node/index.html
 create mode 100644 latest/reference/API/trestle/core/markdown/markdown_api/index.html
 create mode 100644 latest/reference/API/trestle/core/markdown/markdown_const/index.html
 create mode 100644 latest/reference/API/trestle/core/markdown/markdown_processor/index.html
 create mode 100644 latest/reference/API/trestle/core/markdown/markdown_validator/index.html
 create mode 100644 latest/reference/API/trestle/core/markdown/md_writer/index.html
 create mode 100644 latest/reference/API/trestle/core/models/actions/index.html
 create mode 100644 latest/reference/API/trestle/core/models/elements/index.html
 create mode 100644 latest/reference/API/trestle/core/models/file_content_type/index.html
 create mode 100644 latest/reference/API/trestle/core/models/interfaces/index.html
 create mode 100644 latest/reference/API/trestle/core/models/plans/index.html
 create mode 100644 latest/reference/API/trestle/core/object_factory/index.html
 create mode 100644 latest/reference/API/trestle/core/parser/index.html
 create mode 100644 latest/reference/API/trestle/core/pipeline/index.html
 create mode 100644 latest/reference/API/trestle/core/plugins/index.html
 create mode 100644 latest/reference/API/trestle/core/profile_resolver/index.html
 create mode 100644 latest/reference/API/trestle/core/refs_validator/index.html
 create mode 100644 latest/reference/API/trestle/core/remote/cache/index.html
 create mode 100644 latest/reference/API/trestle/core/repository/index.html
 create mode 100644 latest/reference/API/trestle/core/resolver/merge/index.html
 create mode 100644 latest/reference/API/trestle/core/resolver/modify/index.html
 create mode 100644 latest/reference/API/trestle/core/resolver/prune/index.html
 create mode 100644 latest/reference/API/trestle/core/rule_parameters_validator/index.html
 create mode 100644 latest/reference/API/trestle/core/ssp_io/index.html
 create mode 100644 latest/reference/API/trestle/core/trestle_base_model/index.html
 create mode 100644 latest/reference/API/trestle/core/validator/index.html
 create mode 100644 latest/reference/API/trestle/core/validator_factory/index.html
 create mode 100644 latest/reference/API/trestle/oscal/assessment_plan/index.html
 create mode 100644 latest/reference/API/trestle/oscal/assessment_results/index.html
 create mode 100644 latest/reference/API/trestle/oscal/catalog/index.html
 create mode 100644 latest/reference/API/trestle/oscal/common/index.html
 create mode 100644 latest/reference/API/trestle/oscal/component/index.html
 create mode 100644 latest/reference/API/trestle/oscal/poam/index.html
 create mode 100644 latest/reference/API/trestle/oscal/profile/index.html
 create mode 100644 latest/reference/API/trestle/oscal/ssp/index.html
 create mode 100644 latest/reference/API/trestle/tasks/base_task/index.html
 create mode 100644 latest/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/index.html
 create mode 100644 latest/reference/API/trestle/tasks/csv_to_oscal_cd/index.html
 create mode 100644 latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/index.html
 create mode 100644 latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/index.html
 create mode 100644 latest/reference/API/trestle/tasks/oscal_catalog_to_csv/index.html
 create mode 100644 latest/reference/API/trestle/tasks/oscal_profile_to_osco_profile/index.html
 create mode 100644 latest/reference/API/trestle/tasks/osco_result_to_oscal_ar/index.html
 create mode 100644 latest/reference/API/trestle/tasks/tanium_result_to_oscal_ar/index.html
 create mode 100644 latest/reference/API/trestle/tasks/transform/index.html
 create mode 100644 latest/reference/API/trestle/tasks/xccdf_result_to_oscal_ar/index.html
 create mode 100644 latest/reference/API/trestle/tasks/xlsx_helper/index.html
 create mode 100644 latest/reference/API/trestle/tasks/xlsx_to_oscal_cd/index.html
 create mode 100644 latest/reference/API/trestle/tasks/xlsx_to_oscal_profile/index.html
 create mode 100644 latest/reference/API/trestle/transforms/implementations/osco/index.html
 create mode 100644 latest/reference/API/trestle/transforms/implementations/tanium/index.html
 create mode 100644 latest/reference/API/trestle/transforms/implementations/xccdf/index.html
 create mode 100644 latest/reference/API/trestle/transforms/results/index.html
 create mode 100644 latest/reference/API/trestle/transforms/transformer_factory/index.html
 create mode 100644 latest/reference/API/trestle/transforms/transformer_helper/index.html
 create mode 100644 latest/reference/API/trestle/transforms/transformer_singleton/index.html
 create mode 100644 latest/reference/Unification-SCC-class-for-OSCO-and-Tanium-to-OSCAL.png
 create mode 100644 latest/reference/Unification-SCC-class-for-OSCO-and-Tanium-to-OSCAL.xlsx
 create mode 100644 latest/reference/third-party-result-schema-IBM-SCC/index.html
 create mode 100644 latest/search/search_index.json
 create mode 100644 latest/sitemap.xml
 create mode 100644 latest/sitemap.xml.gz
 create mode 100644 latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/demo-ocp4-cis-profile-to-oscal-catalog.config
 create mode 100644 latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/index.html
 create mode 100644 latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/demo-ocp4-cis-profile-to-oscal-cd.config
 create mode 100644 latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/enabled_rules.json
 create mode 100644 latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/index.html
 create mode 100644 latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/selected_rules.json
 create mode 100644 latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/800px-Australia_scarsdale_nimons_bridge.copyright-info.txt
 create mode 100644 latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/800px-Australia_scarsdale_nimons_bridge.jpg
 create mode 100644 latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/index.html
 create mode 100644 latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/component-definition.json
 create mode 100644 latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/demo-csv-to-oscal-cd.config
 create mode 100644 latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/index.html
 create mode 100644 latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ocp4-sample-input.csv
 create mode 100644 latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/rule-name-overlap.csv
 create mode 100644 latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results-nist.png
 create mode 100644 latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results.drawio
 create mode 100644 latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results.jpg
 create mode 100644 latest/tutorials/Transformers_and_Tasks/transformer_construction/index.html
 create mode 100644 latest/tutorials/Transformers_and_Tasks/transformer_construction/transformer-construction.drawio
 create mode 100644 latest/tutorials/Transformers_and_Tasks/transformer_construction/transformer-construction.jpg
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/complex_resolved_profile_catalog.drawio
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/complex_resolved_profile_catalog.png
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/index.html
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/profile_does.drawio
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/profile_does.png
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_catalog.drawio
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_catalog.png
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_diagram.drawio
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_diagram.png
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/simple_catalog.drawio
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/simple_catalog.png
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ssp_profile_options.docx
 create mode 100644 latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/trestle_ssp_author_options.png
 create mode 100644 latest/tutorials/Trestle_authoring/trestle_author/drawio_data_menu.png
 create mode 100644 latest/tutorials/Trestle_authoring/trestle_author/drawio_editing_data.png
 create mode 100644 latest/tutorials/Trestle_authoring/trestle_author/index.html
 create mode 100644 latest/tutorials/Trestle_authoring/trestle_author/sample_ssp.md.jinja
 create mode 100644 latest/tutorials/Trestle_authoring/trestle_author/template_versioning.png
 create mode 100644 latest/tutorials/Trestle_authoring/trestle_author_jinja/index.html
 create mode 100644 latest/tutorials/cli/index.html
 create mode 100644 latest/tutorials/compliance_posture/ContinuousCompliance.drawio
 create mode 100644 latest/tutorials/compliance_posture/ContinuousCompliance.jpg
 create mode 100644 latest/tutorials/compliance_posture/index.html
 create mode 100644 latest/tutorials/introduction_to_trestle/index.html
 create mode 100644 versions.json

diff --git a/latest/404.html b/latest/404.html
new file mode 100644
index 000000000..b5827f5ac
--- /dev/null
+++ b/latest/404.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for compliance-trestle package."><link rel=icon href=/compliance-trestle/latest/assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Compliance Trestle</title><link rel=stylesheet href=/compliance-trestle/latest/assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=/compliance-trestle/latest/assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=/compliance-trestle/latest/assets/_mkdocstrings.css><script>__md_scope=new URL("/compliance-trestle/latest",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=/compliance-trestle/latest/. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=/compliance-trestle/latest/. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=/compliance-trestle/latest/demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=/compliance-trestle/latest/installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=/compliance-trestle/latest/known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=/compliance-trestle/latest/license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=/compliance-trestle/latest/contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=/compliance-trestle/latest/plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=/compliance-trestle/latest/reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=/compliance-trestle/latest/tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=/compliance-trestle/latest/. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=/compliance-trestle/latest/tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>404 - Not found</h1> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "/compliance-trestle/latest", "features": ["content.code.annotate", "navigation.tabs"], "search": "/compliance-trestle/latest/assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=/compliance-trestle/latest/assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/assets/Canonical_trestle_auditree_workflows.png b/latest/assets/Canonical_trestle_auditree_workflows.png
new file mode 100644
index 0000000000000000000000000000000000000000..eb9b418e1871c9e2842fd1eee342405b5f9ad361
GIT binary patch
literal 161907
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
A1^@s6

literal 0
HcmV?d00001

diff --git a/latest/assets/README b/latest/assets/README
new file mode 100644
index 000000000..5d5339e16
--- /dev/null
+++ b/latest/assets/README
@@ -0,0 +1 @@
+Binary artifacts for documenation should be stored here.
diff --git a/latest/assets/_mkdocstrings.css b/latest/assets/_mkdocstrings.css
new file mode 100644
index 000000000..b500381b5
--- /dev/null
+++ b/latest/assets/_mkdocstrings.css
@@ -0,0 +1,143 @@
+
+/* Avoid breaking parameter names, etc. in table cells. */
+.doc-contents td code {
+  word-break: normal !important;
+}
+
+/* No line break before first paragraph of descriptions. */
+.doc-md-description,
+.doc-md-description>p:first-child {
+  display: inline;
+}
+
+/* Max width for docstring sections tables. */
+.doc .md-typeset__table,
+.doc .md-typeset__table table {
+  display: table !important;
+  width: 100%;
+}
+
+.doc .md-typeset__table tr {
+  display: table-row;
+}
+
+/* Defaults in Spacy table style. */
+.doc-param-default {
+  float: right;
+}
+
+/* Parameter headings must be inline, not blocks. */
+.doc-heading-parameter {
+  display: inline;
+}
+
+/* Prefer space on the right, not the left of parameter permalinks. */
+.doc-heading-parameter .headerlink {
+  margin-left: 0 !important;
+  margin-right: 0.2rem;
+}
+
+/* Backward-compatibility: docstring section titles in bold. */
+.doc-section-title {
+  font-weight: bold;
+}
+
+/* Symbols in Navigation and ToC. */
+:root, :host,
+[data-md-color-scheme="default"] {
+  --doc-symbol-parameter-fg-color: #df50af;
+  --doc-symbol-attribute-fg-color: #953800;
+  --doc-symbol-function-fg-color: #8250df;
+  --doc-symbol-method-fg-color: #8250df;
+  --doc-symbol-class-fg-color: #0550ae;
+  --doc-symbol-module-fg-color: #5cad0f;
+
+  --doc-symbol-parameter-bg-color: #df50af1a;
+  --doc-symbol-attribute-bg-color: #9538001a;
+  --doc-symbol-function-bg-color: #8250df1a;
+  --doc-symbol-method-bg-color: #8250df1a;
+  --doc-symbol-class-bg-color: #0550ae1a;
+  --doc-symbol-module-bg-color: #5cad0f1a;
+}
+
+[data-md-color-scheme="slate"] {
+  --doc-symbol-parameter-fg-color: #ffa8cc;
+  --doc-symbol-attribute-fg-color: #ffa657;
+  --doc-symbol-function-fg-color: #d2a8ff;
+  --doc-symbol-method-fg-color: #d2a8ff;
+  --doc-symbol-class-fg-color: #79c0ff;
+  --doc-symbol-module-fg-color: #baff79;
+
+  --doc-symbol-parameter-bg-color: #ffa8cc1a;
+  --doc-symbol-attribute-bg-color: #ffa6571a;
+  --doc-symbol-function-bg-color: #d2a8ff1a;
+  --doc-symbol-method-bg-color: #d2a8ff1a;
+  --doc-symbol-class-bg-color: #79c0ff1a;
+  --doc-symbol-module-bg-color: #baff791a;
+}
+
+code.doc-symbol {
+  border-radius: .1rem;
+  font-size: .85em;
+  padding: 0 .3em;
+  font-weight: bold;
+}
+
+code.doc-symbol-parameter {
+  color: var(--doc-symbol-parameter-fg-color);
+  background-color: var(--doc-symbol-parameter-bg-color);
+}
+
+code.doc-symbol-parameter::after {
+  content: "param";
+}
+
+code.doc-symbol-attribute {
+  color: var(--doc-symbol-attribute-fg-color);
+  background-color: var(--doc-symbol-attribute-bg-color);
+}
+
+code.doc-symbol-attribute::after {
+  content: "attr";
+}
+
+code.doc-symbol-function {
+  color: var(--doc-symbol-function-fg-color);
+  background-color: var(--doc-symbol-function-bg-color);
+}
+
+code.doc-symbol-function::after {
+  content: "func";
+}
+
+code.doc-symbol-method {
+  color: var(--doc-symbol-method-fg-color);
+  background-color: var(--doc-symbol-method-bg-color);
+}
+
+code.doc-symbol-method::after {
+  content: "meth";
+}
+
+code.doc-symbol-class {
+  color: var(--doc-symbol-class-fg-color);
+  background-color: var(--doc-symbol-class-bg-color);
+}
+
+code.doc-symbol-class::after {
+  content: "class";
+}
+
+code.doc-symbol-module {
+  color: var(--doc-symbol-module-fg-color);
+  background-color: var(--doc-symbol-module-bg-color);
+}
+
+code.doc-symbol-module::after {
+  content: "mod";
+}
+
+.doc-signature .autorefs {
+  color: inherit;
+  border-bottom: 1px dotted currentcolor;
+}
diff --git a/latest/assets/canonical_trestle_auditree_workflows.drawio b/latest/assets/canonical_trestle_auditree_workflows.drawio
new file mode 100644
index 000000000..ff51614b8
--- /dev/null
+++ b/latest/assets/canonical_trestle_auditree_workflows.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2020-10-12T20:31:59.842Z" agent="5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/13.3.5 Chrome/83.0.4103.119 Electron/9.0.5 Safari/537.36" etag="VmQh9cjPYKI0e-2Ul4LK" version="13.3.5" type="device" pages="3"><diagram id="Lkre-5FhP-HlhFluqD7U" name="v_0.1">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</diagram><diagram name="v_0.2" id="kbyqK4DoqSoq9axibZ__">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</diagram><diagram name="v_0.3 with forward flow." id="KHV7V-eYSbTiNwpk2qsf">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</diagram></mxfile>
\ No newline at end of file
diff --git a/latest/assets/favicon.ico b/latest/assets/favicon.ico
new file mode 100644
index 0000000000000000000000000000000000000000..fc00960ccb0c9bbfa7481ffc4dea7261f6b77645
GIT binary patch
literal 12014
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/favicon.png b/latest/assets/images/favicon.png
new file mode 100644
index 0000000000000000000000000000000000000000..1cf13b9f9d978896599290a74f77d5dbe7d1655c
GIT binary patch
literal 1870
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
IM6N<$f(jP3KmY&$

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/contributing/DCO.png b/latest/assets/images/social/contributing/DCO.png
new file mode 100644
index 0000000000000000000000000000000000000000..11488abbc14ef54883b60de1f5f98b291c0a15df
GIT binary patch
literal 46269
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
Y3B6X<TfD|bm(GylfusAA_8MONA8$f1fdBvi

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/contributing/code_of_conduct.png b/latest/assets/images/social/contributing/code_of_conduct.png
new file mode 100644
index 0000000000000000000000000000000000000000..05dc53640292a6dee758e8ad40f49ac70c24a3ba
GIT binary patch
literal 33332
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
a?0YuV;}`R?OYYMn*<reynY!6I;(q}T4@zwS

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/contributing/github_actions_setup.png b/latest/assets/images/social/contributing/github_actions_setup.png
new file mode 100644
index 0000000000000000000000000000000000000000..54974fffd078bd24717c6c29c0c95fded9394ad0
GIT binary patch
literal 42810
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
SWl!np?%$)QneqLRbN>dqr6ZsK

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/contributing/index.png b/latest/assets/images/social/contributing/index.png
new file mode 100644
index 0000000000000000000000000000000000000000..2a464184766d15c1b47f4a0ea890e6e32a265bfd
GIT binary patch
literal 32039
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
RP}P_IdGk)IjL-KS`zy#paH9YK

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/contributing/maintainers.png b/latest/assets/images/social/contributing/maintainers.png
new file mode 100644
index 0000000000000000000000000000000000000000..3a5f2862c7d7ca7f3cbe04dfc6fdac60b23045db
GIT binary patch
literal 27216
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/contributing/oscal_object_model.png b/latest/assets/images/social/contributing/oscal_object_model.png
new file mode 100644
index 0000000000000000000000000000000000000000..5099850216fad25e3584d1ef42009df9d51e2ae8
GIT binary patch
literal 39647
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/contributing/plugins.png b/latest/assets/images/social/contributing/plugins.png
new file mode 100644
index 0000000000000000000000000000000000000000..68483ddf5f88117d2b7908ea0bc04c5bec5282cd
GIT binary patch
literal 46313
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/contributing/website.png b/latest/assets/images/social/contributing/website.png
new file mode 100644
index 0000000000000000000000000000000000000000..8e8f4f7b0ec83102e2c9868b8c16da21285961b8
GIT binary patch
literal 42197
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%0A>~@m0;UXGU1oGpsCpg?GWD$q1Ajy
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
KPq90WUifcSU44=O

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/demos.png b/latest/assets/images/social/demos.png
new file mode 100644
index 0000000000000000000000000000000000000000..5db76aed8dc84be6231367253d432e241b3c8c5b
GIT binary patch
literal 26108
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
OKdh|2KjHTim;V<TWW5yt

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/index.png b/latest/assets/images/social/index.png
new file mode 100644
index 0000000000000000000000000000000000000000..898de497033eb2b66002c5cd7fc928eae00373cb
GIT binary patch
literal 33541
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/installation.png b/latest/assets/images/social/installation.png
new file mode 100644
index 0000000000000000000000000000000000000000..2a0d93a1eebf987707bcc2e625c4e342834fb8ff
GIT binary patch
literal 27694
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/known_limitations.png b/latest/assets/images/social/known_limitations.png
new file mode 100644
index 0000000000000000000000000000000000000000..2c43a962d1935fb13380c6da5e41f142e04942d1
GIT binary patch
literal 30165
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/license.png b/latest/assets/images/social/license.png
new file mode 100644
index 0000000000000000000000000000000000000000..fbc0c648d854b02d031ba929375b1ba832947796
GIT binary patch
literal 26143
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
Xl`*nwS|8smba0>c-sB%n{_;NnpIZ&d

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/plugins/fedramp.png b/latest/assets/images/social/plugins/fedramp.png
new file mode 100644
index 0000000000000000000000000000000000000000..b06f04fe476f6750275d677a7b7926fbab9d8740
GIT binary patch
literal 41425
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/cli.png b/latest/assets/images/social/reference/API/trestle/cli.png
new file mode 100644
index 0000000000000000000000000000000000000000..2454904efe5e98f4ae7b4c989d989b9c3386524d
GIT binary patch
literal 25580
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
P*;JI&6qA3w`1}6_iTWEU

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/common_types.png b/latest/assets/images/social/reference/API/trestle/common/common_types.png
new file mode 100644
index 0000000000000000000000000000000000000000..fa5fae36b8b374147cba64b32ce9b6aa48f95d18
GIT binary patch
literal 29640
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/const.png b/latest/assets/images/social/reference/API/trestle/common/const.png
new file mode 100644
index 0000000000000000000000000000000000000000..62ea57baa7961a0c7015b29fe2b638a86216b1ac
GIT binary patch
literal 28735
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/err.png b/latest/assets/images/social/reference/API/trestle/common/err.png
new file mode 100644
index 0000000000000000000000000000000000000000..941382cdf589a014b50b9a371c295352c1b3f1d6
GIT binary patch
literal 28760
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
bAw1UgIJ>lhbVDu{(3iS6eeTHpBp~^3GQ|Q&

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/file_utils.png b/latest/assets/images/social/reference/API/trestle/common/file_utils.png
new file mode 100644
index 0000000000000000000000000000000000000000..c59271ae7f62713e23f09cb2838106894eae29e8
GIT binary patch
literal 29849
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/list_utils.png b/latest/assets/images/social/reference/API/trestle/common/list_utils.png
new file mode 100644
index 0000000000000000000000000000000000000000..51ae6b916af7f3b27a1928063ae547d9614eb546
GIT binary patch
literal 29403
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
M%MR~vy!M{{H|gd_m;e9(

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/load_validate.png b/latest/assets/images/social/reference/API/trestle/common/load_validate.png
new file mode 100644
index 0000000000000000000000000000000000000000..837ba7bb0cc1227b566980bf057dcbfbcc1f724d
GIT binary patch
literal 31118
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
CBW&{k

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/log.png b/latest/assets/images/social/reference/API/trestle/common/log.png
new file mode 100644
index 0000000000000000000000000000000000000000..f19477b91dcd69b855c5c848b98c6e54c205469a
GIT binary patch
literal 30860
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
JORfFC{2$UFJyZYy

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/model_utils.png b/latest/assets/images/social/reference/API/trestle/common/model_utils.png
new file mode 100644
index 0000000000000000000000000000000000000000..4b2332e755891132bf5d211001ccef58e1626f32
GIT binary patch
literal 29238
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/str_utils.png b/latest/assets/images/social/reference/API/trestle/common/str_utils.png
new file mode 100644
index 0000000000000000000000000000000000000000..d92e81a343b6d3a2474759451fbd1dc865597c4a
GIT binary patch
literal 28910
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
GiT?uDe@V6g

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/trash.png b/latest/assets/images/social/reference/API/trestle/common/trash.png
new file mode 100644
index 0000000000000000000000000000000000000000..fa04187f93c766c86a5508646fefa7cbd480597d
GIT binary patch
literal 30211
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
b-$wKX@)X}v-sQ-vG`Q>CJy}=Re0k*G58@2>

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/common/type_utils.png b/latest/assets/images/social/reference/API/trestle/common/type_utils.png
new file mode 100644
index 0000000000000000000000000000000000000000..a9bf805dcfdb5162a75e7a31a8dabc17b3c1313e
GIT binary patch
literal 32042
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
TjD2rUfA#IQU5vZm>^=Rz97h17

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/all_validator.png b/latest/assets/images/social/reference/API/trestle/core/all_validator.png
new file mode 100644
index 0000000000000000000000000000000000000000..972baa787f345e3f11d9b5e8d37c3eeab9b3636f
GIT binary patch
literal 31630
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
LYnX!NTaNq(dT{yf

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/base_model.png b/latest/assets/images/social/reference/API/trestle/core/base_model.png
new file mode 100644
index 0000000000000000000000000000000000000000..f6b950d1de7d198d007d28dff856b07d7678e626
GIT binary patch
literal 30981
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
Sv8MF?Hf`MMaDDxbqyGUfEkE!8

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_api.png b/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_api.png
new file mode 100644
index 0000000000000000000000000000000000000000..f30b5e804d527ed9774130fcd2da6583c31d5e2c
GIT binary patch
literal 31669
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
Qrm3^mej}@3rF+c30T^{Rga7~l

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_interface.png b/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_interface.png
new file mode 100644
index 0000000000000000000000000000000000000000..c3a797db349b7bc72452142c247efa988035414f
GIT binary patch
literal 31561
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_merger.png b/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_merger.png
new file mode 100644
index 0000000000000000000000000000000000000000..26cdad6da29ebdccfd475c4a21e6eb0be1c06713
GIT binary patch
literal 31445
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
U3hQhNX-6zf*P3Ln-1O5w03HjyK>z>%

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_reader.png b/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_reader.png
new file mode 100644
index 0000000000000000000000000000000000000000..e86a3fdefbd79cc1726ac6e87addcd72bf8d840a
GIT binary patch
literal 31502
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_writer.png b/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_writer.png
new file mode 100644
index 0000000000000000000000000000000000000000..10153ee943f4d1bae396e3190e82a432d7046425
GIT binary patch
literal 31981
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
YGYd#vSoo^@0NtGxUaLI|JVFls6A_q9LI3~&

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/catalog_validator.png b/latest/assets/images/social/reference/API/trestle/core/catalog_validator.png
new file mode 100644
index 0000000000000000000000000000000000000000..5533a467241272b60cfc1a745d19f796c3370a98
GIT binary patch
literal 31631
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
HJ*WNy3)CHr

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/add.png b/latest/assets/images/social/reference/API/trestle/core/commands/add.png
new file mode 100644
index 0000000000000000000000000000000000000000..d4e473f455ca77cd7840a8f55c68ed5418da4cbf
GIT binary patch
literal 29771
zcmeFZWn5Ql*ENc|ZP0BZh^Qz^V^LBnC;}=Sk}4odN;jCGpdhVM3epYIsi-t4DJ@dc
z($Z&KZ13mX@9(_d&+}pPySKOThqczVt~uwJV~lw{k-j2EwTX5U1qB6__(f4!3W~py
zC@5B2ZdixEkve0iMnPe|U0n36ymjDko0auWh2@zsW7`7<51QYvdwqAZUGz+hxzQ?_
z+lq0I_t~v^ZyMIF_?K^}>`uz_w?hxGpLy<n;BVWF?0NnZ3!R+ve_MJFRit}&FJ>p0
zsq^wjRt)iVjU3HM)nEwy3zx&!7oUvC_5b{qVy833=6`;xa;R|i%J1$rY{1=-uh(3w
z+5Y+6t!Mv!?B50X|7C|vOili?2hWWC{rBGo9335hbafqKVBq89^YZm&q@kgqr>BuP
z{b#3M^Y-`me|Nj~!fErL2jW#T{G6%wN?2QG`micp5f%0F^6DOHN;Uoc>-rOScR$0H
zba8X@cTC{|0;WEvG#Ea_{SyJZuV24@Lc8SeteJMZ@Y}T!vibHlIRl@Hi_6>d?0N!>
z^F4LS{lwMO0`=Fs%095Wc9vg8Mkds!Ov#y&=7w3v>(>Wv*T?wQ#j7^vJ@_lIq$H3;
zo0{Rbr0Xe`!z#1A0mg47{W&aMlo%L#%KiOSjq?<4RtK}|H^h1Jk7O2EtT`Wj?yk-m
zW#tzF3%`m|%==~eOny9k`}XZcTifhFVJD4r!<Hkpky8E%>N&QyFTyW$<U91#Ma!j_
z^<8=L<ca4lR>j8!1qG2V3ZYbcjuo=pGI?kJ>;3v*p_OQ6kd2mQe0f~UnN2NIS|!71
z_>P@n^E=P;Zo5mVHSG`Lo6SFLka@N3TGRXDVzDEaUmZSrCGa_C{_k_^sAvzT={NeN
z=#)#GIdfM&R`GIkn*LEK!6~0O%>s?ku&|(%Z!(!zQ*Vkt+O&&pxvjv-$p#k|<YgeQ
zkSUmffkAuh$EWcxB3qwiWK4vvHa0f4`Q7Q#6B**@_4x6I$TYVa7mC;o@87>qv7OR;
zdD<f8;lqdD6e2AK8&WI=6|+Y3=hXzVYgmsRlm1Xt6rXN(_TiTM4;~mgHnSZ&_N7*2
z4K5Sc{YWXJ-8Qy-?q@@M0Gmeciy4Ds&nRO577`L7YuW!b%%w9M`{;yO@1+r~E{6X8
z{uGCK%h+M3rP;{!7s$_`_#}rX=x#AC@a?S($jME_ujM=)_THlbr|#z23kp&MU4C^+
z+$d+5J9gN_#ALi^t8mFkTMi=^mqLtEB8Q;ew2zR(++%D;9br5qS#GjK*t%`J<29WL
zIU`=x!pmw#Sv|X-xVd>RFOE8Gr=jWZzwUbrd#NT?DRK3Fr*2QNZsFxwseHq)U%!t3
zaO2#q+}B;|eP!={a*OjeHa4Yr>*3f-MuQU#s>Z&|auFqA9zrY<%o$T|UT0<EB<o`o
z6iiK1vNh!8ePU$8T`NyJ%uUMRi4`r{?I$jK?3XfO!37oj?vy+~NWY&t{O9;rvHe#C
ztzs49$A4$Gs$+HIs~*TotX;RRxiy4O>Wwth&P|WbjfrM;x%10kx#C{gn2_KT6cq2g
zW#7P9SLDvb4@w(0|N8!5tAw<)biSduxcCX{U)Qp%$3iPl<FWh@Pgf21bLsg=e%?SH
z<1WpcH*dzr%Q^X{oQJ2!$HqMUH65Eq<}a;bXk8O~#;VQ2zdrrtNnHs81A{kHh!exK
zc#S+;*+h-J)q}r(|1NpF?T~iohexJE-;Rr4zU(_WY0hWX`!r4^O(NJ~`s&8bn^}|c
z<M&=z9xLAOR~&3N!q=2*ld6_&E?!ex+w<|sj`23D4)OWv;fXZ4SVeZ5z91{@(e}LU
z`}cF+zI}W9jva^0dMiA4v#We-n{nO6Dk`e|<@MR|iE82UEVI7DhYpEwXyh^la2tB*
z2HSjQp*wYmg{3TJ^uq{WL#BzA&Eixeas|8T+~n=jl9J~iKZ^3%|4yn1;E|e}8P)vx
zDd&2Tv*IGVa?%-5QN6|l_R+kV;Gy<B)gM28ke^)@$alzXH+#x_SLWHXXUD&3d6eQF
zy0HnoUcF)|EiEPYx0#y5hkrCz&feaBNJ!XWe%cocP$Im%aEO_i*~`!GNaU3uFC?1s
z-(y{A*>5uAZQkjW@7^{$Besp<(4n51a7ps8`<)g{?hW&Hy;xja>>>Lz#Bomi#*G_?
z`S_YnIPn;_vyB!k=bzGVsJPj-I6vbiD}iikAQbH9catwa-(kMl<mM)&z+f%B(w{m%
zzr3kQ(UJ6+>d3axrxCDDDxMP?>mKvC*RL3(5PNe%%bi51`c&7CA8`X)=moy@<|CeD
zoR$}@JohJGx^zi?$B|1(P0sO&tixChi=SW42Jx9i6mqAgq|}LQ6?`iy+GbWQ$imDV
zUFcwDYFdX!8y=Yd@<v3jzb5<<eRZk#Q3b5KA-zYQW@L(00ah)hDOESNwYBwJ@mn8R
z)eIwrse$@bz62BqmEi*9Wv=TV{tD3Cm)EeFGgta&APu*{3)g4Q*iG%%Z=sW}e8t83
zF8<fAJ833epBY+CTMYONwCCl>HM%z?{@wgajC^LzI?ANe8Cdt!a`!9|mn{P!PD{)w
z`@((ZMsh~wFJ8QuKQ})!nh~2ID={_P()dfQp_4D-pKyA!bNR>MU@W)6w`(){N=jD?
z9P<zfW4~u#?+o}cw(6FW?aYXwnTh)H&9v7)Mn@A@uURv(OV!Qvd*MA6M#fKHR)=79
z6!_EI7mgk|67%unM~0U2iVAtoyh$(h4!f$VD#dt}G?o-&JN10~tM!SR9Rt>ZG}jd3
zlx2pSQj5Q2UI{uKj=W`59}-W&dh%p#0=Jo&*=EW!WK-mPNE6t&abt|lL@#%X9tvCb
zozDAhhC15XQA>;S{D#B4CktIYJThq3El<`;aq#t41@Z6I@Zh%^k;m3gd)MhsQC?ep
z{L#6U)DiyMpWCqc+mz$i`t94d$F*z8GOgW}f9{q@&}oafbktbM8#hALr%s+c$tWl&
zsEI9JnjwXo*KW_Xkxe(aDxzig{oeZS*}f1?(*o0;GVv_a9@p0D>T0QoOD}IU&ICKy
z+jlqVhNS5SPDd#xhuV*QqQ0VE?S~A~ypY{EJJF}pn4r!bQu~TazsznlPgiLkrNDBy
zuct?6!e+20+|7RStJth#UJBE}g9lTty<a^xRk?g96ycY0>nlUFN?J^t;q3f;d25zg
z_=RV*mW?L<U%p5)Yv$+HPY(?llote9RG`wFuo_W|oqF-&1rw`c-1ARv)aBS1TJ?&^
ztKH9d+LIP$8sb%T+OjQD92ac^97uLbF={(~HNz-KE#JOr<ai(R?dszQCV?=mVt30t
zP4l$p&;RcKmK+x8a_`2+F6LK8J>)SZoTY*V`s;)g6EzI$#UvzLZD)J@6;f|j*5N8q
zBl+`27TqP=0_N+ZWQuAO&xYKWkdjg|&K+~sYs*g4Ykn6^d-CR`H=4|Ws89oS(camB
zC-q6!iwqonSvWX2I!t!fS*fVJvh8}tBcEeAEdO8~Ro$=7qWU)?E(Rkl03!B=rw4Z^
zTMX1C&z454r?)<Xvc&A^B+NcD)u^dD?Ct6Krp%YsKT%jUq_B*?p;5!`a+*<_3fJu#
z(PwmgvipSWzxCn`IL<aN3?>%DO}jmLB4gFzkP)L<kU#L{&4X7$4%uZ@Rq4&fA0Ka<
zZJz7)mWrD$#g6tqDy4|9lzX<9N3rYkvsAwILQB83A}jQD9aj(9+JtOhSehRVa;(4_
zr`p;tFD<gLu~npapd`OKq2pTb=+CK{UJ)7UUi?+_VBLR3;^>c_p77p^ms%53F-Ps^
zhcgrtBbj|xyB4p1t!{(Gjo)4WHB2n1!4ZpWz|jgws5-2gWvYWEV2*X@u<oKN7h0Ql
zHGOJbre=X7_lyH_dfc=j0;kf!IJ484VSc1BF{Dz9&uS#FKEJUb*;4T?m;LWMvBhCw
zVe!oyw`@tD9cvma7}sSjEGsRQ$!N0-PzZQN%auYC%w_QHONx{~hk6{n6p|#De#1Nc
zD^)K~7LQv4ugK#?)eG%7dgYy7tWjGw3l~>?Ovhjm*U3*!s}#xBm~PTlKrH!WWMqub
z%w*X6Hoh!gC|t8uIqjrj^Ql-%q?LMP$@)i|smFaKd|8?-1l<2p&K4*pB_HAI^Fw|0
z>eUAMOOrnAs_9X8?^1Y#P`fTYO8ndQZoFohYU<5raaU76>&*j`XpeW7Dz><6*{7l{
zj7^`?Jlz-K)Z9Abv^*bDpI)#uC+X$w9iOfgCH<x(pCtZRLp+yPe{H0y;V2Th=kUw1
zE)QW>e}AR?nuyDLV;AvxLr1|l1pWExZPe7d6Uxg=^TvEmONcz=ca^2KSS8Nb;)3NR
zJ3fcGclDO4nrXSy{_MsDi<YsPf&9SGm3>pF6hMJB_AS_zeP1;XFcSdL{a~xmbGgVX
z;zmXZ+Ba{i<WKikXt^V)#hA^sS*b40-30Qki;@vR_3}%6F?;&84C53Z+V{J5v$M0}
zXfPsOu5Y8KH=2pRDxD4Je2w+p*vyQT%6$4cA756b-I>b(&2i~mdUYiO^cSZuUb*7;
z^eJWRaAUjDPZgyEwd7{Sh)Xm@i@nLaVz`W2znR-r-5BJvnq;u;uVIWeYz)ppx=<C&
zN8t`IRL`?jpgnc#0NE2h*o&(4#*GO<3PIQo7x4g<(_8kP)=rBj343PhEwJ;h-!D#j
z*dP#4vb{!=N$NxEpxsv$G~Vg5zf9e#&6o3(d4|^<9l&p49)QHV%w>gOBpei>vB_i7
zlzXJkNUTx~`MhDv7E3&oQG|VWiRbE>0+a&Mmq<%L*9iy-38{;_D(Ajmc;uZ)Q+Wwh
zaiXq%E)wUDzP_VZuU>VhjFrY(_$@E=3D<;)ZOuZe3AddZkWEnI^Ek4YF4So;(wen;
zCS!^@Ss+cX9$N;DLMh6<_KbDHqPeokcf1s!<&8Uzlr(BO8Ky~LW4%>~RrFgHvYm_~
zs7h$Idj|mZ$>XMG5?yAL1Yp|y{>zUlIXPLe<->;$fxB<0FLNE())GRIt%z_@AO6W9
zDA?9(sk`oB<M{NnA5Xir$dy3egPM-B;gtJ@)M$B(*mkkV|N31lpGb9h;@g~gU{m_j
zO&d3wWKvm~P9JxgsN^|u<Ktt7f-TAgjt(~XBLS5sZhbl6QhY73=J(2y&YGH<9%g1P
ztu0Erc<GW)U?82;)-|6fR{2o@*>h*K%qwK9S-+*^$&RDrzQKZaD)dqpFDAvv$?wr&
z{a%_w{rn{Fcr?qQO`Bp8mgoFZD}wlyG@KSKm{rr`DvL>}1XT2q<>)UsmcA6Z?eD*@
z#l+Xu$&0xhYH$BEX!_k%YYF8g97X;FFwPTKSC(IcHVn(oXC?jEl5IFoDlt7<DK&wd
ztgNwLj2$yu0BzOg4C#F6>>qt`F8Ajw$1V$ZT%4Ot?{J(SPC?^*Zm=OyQ`0Da_Gav`
zZgp_l!u*d<Zi*g_=(!8Ik>=LL-j!t5nOKs~c6<CdsoBrVi{a(Vmsdt(otBqOs|9De
zTl@k7SP7)GM}z^!YHeJLpUA16V`(wBXOq^Tw@`ho5>LHfJm1v(XhAs|&0!<0!G`#V
zx#^us`^=Ee?8i%w;(s9*XUBWO5xfAh)HKJg-92@?=5R+oYVdfw-Dp-%@6YhDl~A3~
zxp}j!v&bbJ5ILCM_3?t;sG?Hte$i5qy9##!49a5@^IsXapp|3WZ~yD;8_k)$JVt@_
z>EFJ6v!CH?PB#poq!-}r5L%p@^5!g9sJR)CXE&4HoNhJRzPi9YGL>G?R@tznz^OoT
zj+W2#ZGHMyq2FiFKX-dAJ#Ef1i<}(o5bj8y9&RZ|ebY@#M7)q^pEWYFM(<+N`G}g$
zQ1JKn2eSjnu8I+t1A6a!4!(a`+=_B+zZ?`C%t0FQ-@mPAQCWKs0KVwgWkzx*uFRs+
zO$csfS9$jwSR^1M&OG8j8_!2JMXPuV&B>cjBV8C6mL1oW?dW)XcC2VdeA6+l&y=y6
zy|I8apaPN#H4T2EFbT}GnklwWbEv%-<<CoZG`UlFcU4WiDo^b2pFU01kaI|BbLE|B
zr45OTW!k~GqRo#dN8{3so8Og2JM=}%MY`9g2k~2}7*33jdyV&$=V((tN}eixDHC=<
z91UrF`c~Rg7cV^BbI_{Q#3lUHtuKY+zY`0V^rkE_khzpsbEu-qbcg$Em^LjIt5v=%
zrrWoV9VH?oe5fU(x>vAfH-{S2`mOZunjII-6u&Ir-Iw*m_O`wIDhi74v_SS21MIge
zBraZj9u>tz;_PwgHx9XoOET$!d}bFe2XJ40MlY!HY|rs?mjiia7Uu>NS$KFF^*Yd;
zDdgE&#HO!QBL{CUuR64OiDZu}L|)lvQM}J83Q?*&>>nJQ0Q!O5aP9i_Ep)oquD!18
z0<6kto@t&=V8=^JYR&-uKR+Gh=NF-2H_TO^Yh#8q#clyK5sMw()S7`dcy{iot7}TL
zE;?^TEmpk(<VF=i`hEN2L6fk}zcXl(WmnIx>&?92PWLjgV5Ltn!&YD2R}H2ietHy@
zI^SVwZjdw9VatA@ID8-i2rdlSJtEj?$;Q{mM?0+p+0!R69u46)0e94gDBw1gUWH=!
zef4j}z1gaV@m=ywDLO$ZH-+YY9*SL3idRw477R1{)>KUJm`d7My^`kDsg4A7{@5w+
zmoKC5-@hOC+3)4c+x5L49&N6V&uEW9H}rO(G11t%YVa4G+zLPNM%vYBY-&njFSkL`
zY;#QzLOT&<MZi&r=~INYJw@|wVPWAk>`a&4-7k)78Kk$pyDjJY>XlwhrMUNz9(~DT
zigFE-o(5{Ku4+iF7E--dfHEnAj`orJFygwhF@$w>98ga5(9qDi;_KzfTE%g}9Ru~T
zu_tw__83Vrha*$*^b8IT{(5C%b+;!@D}Sm%)o|SxYEBJ#q%@_8-by*b_yA)iH}|>h
zcTD2rR_*Lg)3E8;Rb-~&()Z$@j^&Z;iL!6WT9@+@%p;Hn?G^;2U8Oo%A3iE6EAs;S
z3z)m81s>$mi(_Ze`sh!LA-$C18>l+sj8M<U(frZUOUblOu|8}(Z8se!u=Kl&Lx0(g
zGyi#*m`AgH+_^`a)-Ij6PM^vn&vOIGWxV2K^`5yZD-ev7bi7{%=x_B^hxnt{DhDp3
z^w2^bSJZsTz9rD2g4};)VuoUZ+SPTGdk%zMc;>~So~^v-+A-Eutn=gJ6YiD}9^>H7
z<GaF72^FIl-g#D1axox7*~I_n&s$fs&7(<Uj{Ns9Gn1DPW4RMm{FWW39A-w^Ov~9b
zN{)uu%l>o}Uiuw2`SYuYI{>?O0N%j~q*xk$OM~Rh_if0UdKLx2`ilq_(-y;wtjRuA
zIa%4aVjlD<`i%+aW?J&>G8SeEmeZQsV-#4GsMte1gqM`Dt8Y&z^(Ij7+QpdBYU)-w
zf9%O)kh5Yc=?2VrKN+#3K(Zz1HFU76oj=Fz(A_to8{%+;B#l5Jhvo!JKTb`Kef*Ye
zzij5wdG=&<IHtz3ANo`G`y`P7K!|ncXr|_LcXyY7G)c?cO6^MR;Y1mi>4RRLbo^<i
zJrWj3zlfH%AcX2s2Nb}Sk*;H)IW4x+68&UdiRYpEt-=e}Zu6kf1_|0JqRL&#`}JXS
z3_$YQ2CL6X8}#d<uA6D5Y96Gdq?AV@mIiAi1L8#%1oZ%NpdMNjy$=sJvK%<@y0FWn
zL21K;D+&NDzh#_CmT5Sc1_eN*0qkGBB4?@rz%oTNMSz=%iiV6wkM`wcc(Uf7vo_qg
zX_Ksn&|H*C@{LD?g^;*>Spl3cIwcW3uthN_uVpPQEh9Gdq31VGAyA@GtfRkuQ}#vd
zCTQfvfNhDwK8<zWx?iJPY4YiAE2l?ab``6kw+1?8N<))t0e*bf{{4w3PM)j>Z$#E(
z?pM)P1+;s^v>u6xiM9)4#r2>>73}SE%gV}R0o-LlfyrX?o)qx6uy$wu(=aebTHDw}
zgFF7vt8bz-H<ViKgZ``7BSbdWwQ+fI%`rw^US(j?xO9JJxz8g~aY*5$<wZ!WP;AI9
z1Aa>c7c9?KJ00fWsA6Ay)BT<GA^8}EkE~LnhVT4Hj@0x}Q`dOD<!C$mOox+j=dMc!
z{}HoZ@8q`}deLf9yf5W?(K`Prz#ylReO9dpj~_qIF}Q|t@2cG^KPg;I<MC9Fzvk|_
z2Wl63uvrKbj`wgV_rAy<HSDfhmg#wVo9=BiLiU-WVq*NQ?e6>dwL$8S{|xge16T<<
zcFyN!>&JatI**KypDI1>!>Or3NOM&A5HM$#06>RgsHv%s+D#968t2bmAUhZcJ7FJ_
z1l4Lb-iQCFY@2#}dKi1ke0Okia+X$B?h5zm?(LO8j=?s*Xla=q>7x7=B+5mQmf=A6
zHA&Y+Hg4TYXozjw#IfsBb*l-^VLW|Wg(wAJVkUn*cIzD+WCbW9>PdThJDOZZ{9mY#
z*W0&;Wn7~~dHzyfS&B>$RgdX-@0>w@bQBDzm#61JkT71)pC16xZHji}$+Ks^W_?wq
z$VS~@K}<(l`S`FC{W=vP3jCg(eUdR#V0E~xveGv$jt#8muU{o`q)S4xP8bte)Yxdn
z_*V~ITnIfKj(%?Y?%hX#F1GL7dHCMFd$Q<+#3dxWK0n(_$e>6UkHO!zwktPB;Ull1
zp|PEomIcd`YOfc4%%-yeb@T9%BNs>|Yy!-p<F~v73QBik@39ddun#)Q3TQCM0_`=<
zl~GC4V?^)j1GOPq`ptdvhEUOl^p1|!Du3A;^3S#@Jbz9^qz4JZ@{!UbvZ4f>gX7dj
z%}6ony1<7tuC1fPcl+%pH`4W>F*M4XQtWTdN<C%REKd+aWMCg4tK_+J_q{J{(*3g?
z3(p7cx~9%~{J2cIaR&#Q7q7|yo^l{UMgWj#ho7GzxBzFes%M*fLO!^NfMYy-_+zxg
z-`D!x{wT22CJJ{g;(=9W0gD+=oRC$FQ$9$*5jIC=oUqmS)RZq)x%BR;HQGQHWOGEi
zC^j+_)=>Z1>>NMbDF#)L#m7lBgr0ZP2C4uBJnH8d#LmWcY26k&rb8E=K1XqFa@fi$
zw(Y+!ZiR~<5_2!fwVBZV8hV~cX&E!d7Z58t;Ac+QPTq<Janmw?^uMoHO2Jx<-EtUr
zd$Z!j!5pj6>2JK7YQYfG2s`EiRVyRW^(LGA_hWuNSXkx_`i#^b`?>ze=D)6z_jWYc
z`W!IJ5xoD2$vYd8PF=XWmTZl?Za;Tk>k&tDMab{vr5Ry9w1i@x@6=xADcvC@a8T>>
zQ<MJ7P0#*&Awsq8`u1T9kM~E0lqqRCFalzjNQOWH^FjSA2mQc-xVDlExqv$>Z>e38
zhA1dTsOjlBMsp|J<J5B$iS9AJgkM?EoOq+)+@jGqYy2med~T3?28${~1U|&7h3!0O
zXK!+kD1uCQ{Z_W~O#A-i7^WUzB<-PZ$>UI-N~2`LJ{A`jcXB&8IOtToI8OLM0_5eI
zMf=bH^VAfg-5pYrmFNd=R=#5F?CgwaiIxd-u6V^I2?pyBC@GV63K_j^*H-c>#bzWF
z8uT;^z`QkS`btGpITnLQSd|idfS$6inKQ-zC)p9%s~nU?cXVX%c46THhMAd(32(@B
zDt;X5EWpqfMbHTU{_}GK&Ye4_JvZ4u{)t-iqO!8`y?KQw>9gcj6Jd*N;b(_LZ=d~h
z&zmfk7iY@RE;2GOd>BZcn;Im4=s~TTDlCy!`SU~XGFXhZtCP(QW;n%Q5U~}foO~|Z
zVz4*s-W&N}|F10k1zY@Tu61(Hx?!XxUu-2?Yk4NB|2#??{^E!mHRtYap5MP;+v>3{
zeC?k=IQH=SrjgHr|GFIzKmY6OA8I8n0U7O|)>ixG6TNliOM)fb2O$CNDK|IwV|lq`
zZeAWF12II+$438*p5W&}LF~jB;O%`VD=RD1XM4EM;lqa?%a+v^J)nZXe{v;)?`{Sv
zA;Q7OmKIfTo{R?$oPo~Cc<PiqD)d_vB-u1Q1yV5}cMx)qlq&G18#3s8U^$4C3h^T)
z7ErMVEfA@Hq$EOyC7u9W?;^;Fw~>*O;0#IOmX+Op(9ap$vHPTH_r;gOPWf+6<HNoO
zMVvElp235iVfLanB4P~C-%(u03tXS1sOUp-S=^<7peQ>dBV#E@8IW#=#?kqgg1+lU
zk6}7Bpzy@Q!{5her_|PMTNtWVa^aaBq+kaIvVoZK1xF#Ft^M}#<A=`95&)sZ&`^_Q
zrVE|SjTEkhg#`irYg<dv%#ep7npFUgu^(w--alB+c<|u+T9F5Ce}eLL*29N?p<Q${
zXi7Ox;u~KzXbt;YG7`;4TCbwyDg7`$6O8o-@Olnvz6{T#gLc#F#fzW)*WX|MPo}#G
z%7-9!ZxBkCkv`sn93Y;H6#_@E?jmUx1w|uEs;c}7mX}mX9`N+^H2wMI;JH{?*MDl^
z-5YGAlmg<QP<li1lSJFHQikq)KSLCmNEclRyb?Ced^HHThX)%I`{)%9{DFpVFN%v3
zt3(M=R6p-ECQNEMxZt;EAFK<ef29s8;xM#VFVLu^_$NU@x?6wn+1>3w$$MzlPb>we
z%^~7U>4|b7i4O}1vISTUH#45RS@9ekco~YG0KP9uyQ7ne?BKhyBiJ$HK$;Rzp?dDE
zr+?m-V`XQ1aW}LTFM?#VEr(g~-3M~d-P@3~X$*+jRklp}CAZ<LNS9~ZAMz2+yznYn
zJap%N*al?}H|`La+m(k_P%PN`$Hsn`9*An;<>S+xoc!AQKaabU)JE{5qT~u-%Yd2^
zGUG?_YYD{TLue|!rGyuKG<QC1`_DUi1Q>OcXo!;o^^%TDv%3DM0@cEj9`u6Ucm%(R
zzUrJ@VIQ{tDR$%`06fbxO}e_lvtKb51}^*TzK^xYWvf3t5xjX0K3o3tX;TF13Ee8X
z{-)GO!h<1byY2)uH8m0GjP#<QIUAV`Lnj&jd0`X`<D-$`pP$kk+A8qtZXmx^l{r7z
z;6!sG*8uNw=l>{n;XW0?f~qJlN5MiIQ*%OhVv2<+2MeTj?6i;KpBpJG1LL|P>Z9qB
zP*ha(oY&RSDV^-E)%o@PeTs315YN-U!#Dn^8A;68a>0&sw{76gKtqyHxQMQbrK{M(
z9|nL6crk6f=X`em`Pr|fHJujINdH0X39-fQ^nxs;e<d%7eh-br=0CP2>9>G6BBX^^
zO*cq3Xn{k4a?i0dXnaQhQ|!Le>Xi9--dnT2tnl8NaP)<;VHc>-4SE3zlJo<@tqfg@
z=jey7DD)f`5p(2IHE08gXi0!>nLj5d0|PMy0L&9E5z1mI(5DVyEu`dCk<Z@80T+`U
z^zPQzbF^G~htU!~NBxv|c|zx7M~5alLPmD>%itIe6HWsBMHzSrMiv$cn12}g`CDpT
zq<`${o9)?1d_wrxN{<5KST@5*JsNWCUu)Njqf2-j9u9=>8i-c<O0WPkX@`beGRpC;
z;Gn6mEusccxeZO@9hAaXJjNUV97K;2zjZ6BhffMF52PVJoAI|$x=XN0bpXA<HE^I=
zni^X5?R{J0?S|*a;|?x1N(bX9E>;H%5|<3Y!qKW33GftM!~-3MSqJZn5qorcw1X3A
zCWp92un#X!^$ZWQ<Bt3Z3Wv@|vJ<gQF)Jkm!gF#_PcKF-*IEWr2M5{nB+nuBfrc+C
z6&n@^EVvK3RfL#(kZhlcii%!DHkSuUgI41(6VpYa24ERs@>pr0CV$F+%kv;P)pF?D
zLBs_;4bOKyXlGu;4`%vc`ncBTiv|X9E@F>r&iVF^zhA$f$qEiP>3dor*|=IYLWCT~
z(>jNT<LT{&j_=yLS5><WG#a1%k`b8rDL98>PzGM{?UP^*2Zs}SL@GFr{7Z(=3^+k~
zaIe{?O}iiWC$omjqvM(bovcvcxQJd|DLME7Lnz^DGAqFx`3s1BvT?Ktm5-J^Pxuc#
zB;1H<B?u`h;F7=rhCoBHoIn0fzwwF#NP+<nIuRb73$qggNE}K4!{&3pU0W<(aebsc
zA(Fu*|AiOGIi?{&J=WCBj4I6^gsITtq#Ok7%OYmboZF?b&v*ouu*pgD&aXpdvZPkv
z4E5_Z@h=gkqDU)G5j?~kY<2Qbw1Q5rxKRYxSp{-R^mD*U#=^_{t*h&`PYj$C*6)7q
zq<>)}V+xy(%79Xgyf~<ws*&t!q4~J}2}QJ~Qw7V5QsI%2d+E*2o;Y!$uHxlM1z#2g
zwYfkS7nfKpl?r5p(}qJfgmb;%L2t-ZQgeHY>(6c1$i9C<cF7bhRM8M%B7-=?eNJ2d
zdX3wCuIl~<SyykkIqk~60$GW8xWT|XeZAeq#(~}Xw|>c0b7c|a$cn}bpi=4(mivU#
z(VI`fO0}D>oj`Bw)YGk+uyff$_TY0m!q>I1OEKHLKNRkco?pC%P48}d51_2eeHOoa
z{*APR&Dd`W0TuI2TPt#zNTaoVn*wl6n$xnQhy}v`)^B@g_0dq%co)wvr4e#yByUE;
zU!cQ7VEnO!goJ6+w+VxeeDyZ_iONq#TU@QV3t2`c%6I613&eFKIrudtnA5aNw=3YG
z{ht=x_~fdGo{)n)p93&H5!^e+1{{NKQYAa9ee%}-+5Go!v<UKGx~>SOL+Wjz(+34m
zkA^O=*&pA8GEmmo=s%(Bb*QgeG5Tt1gi5}BR&B9OUTdow7yNn(ps8FwOa6ZzkEkc|
zNGz_dt|!!Huv2)<6Jq3}Lmd~Vl!_K#Oo7B^c5-rx6sQKlpa;8{(cT<ciSUSs7=+f&
zSU#p7SroCn)tpj0@hQXvTSibKc;qOwLHtvDAX0`S&Ge;f@j_V6?(tKlqfM>)=e5-f
zq&btQ1JfLfCU5wD*jyvJw;<!dZQHhixs>A=GzJYED7^lKpi`s2=OMAvJ+;>_K*^A*
zkCrQ*e6cZ!X{Q7;C;k4rVs2MD@4cjE#6D42p6^(`^sL8Ij6Qi@pguue6+~x+ys*16
zc)ud!=SU=VfNK5I$$iWN^xUT_&u**!OL-+Wkz%8#1{-r0?ExD3hBfE``s7enjf9=y
zjpMrUaYJoa!_?_Y+8b0^Zbuuw07oRCS?szWHoJ@<RDk)-_i+?>l4v+Avfl}ZKh4|H
zwQ%*M*-`>KWUrLYc_+Sdh&=Lnwo{j$1yH!1d*d_yU!k=f3I-C~rDx$$^Sir!QBX2+
z|7I?M-O*s6_a{RrkX;=>p&<9P0Eo<6$uAx-jBHJEomdzb-3acKq~YQ!B}BAdL)=S|
z;$JYm*$iENAiJFZ6}j9eI(g7~Wka=Aw(0)_v&zA{NngyJP6m;#hoWcHPxuv7zGv7)
zFDLw!f^B+fGM*+MBOD2I+v5V3tJyX^k}Y#9UjO}TsGRk+-t$im4Q08I;!;#l(?<zn
zE+V>bW;ml`dh&~}tb~q^PBg+%UwHlb*1gwu%^=Eu3>1X6bO8iLXqdY_rahtkSggak
z4;We&kT$1tY|wJ$76rmH;|_)aNOm_Y5oNk6WX;oH;cd{IrfP3cF^AWIMWOTv`9GI1
zbN+nk&#z%_0>aQgOa@<U@(Kvh|DC@VMP|CBk#*BJD9)DL{-`Tv(jW6yDVhXp1~ZX>
zjg<2JL{xF>1!&k|aAeI)eql$6q3m!G%@{nT|Cp;={L^)+ehxmqtB;(WO_wg6uw4T3
zu7fp7Kyb)D+iKM47S*<EGE6=-YPoB}6)i0--*^a5f73dFO2hLk;tr^{aRky6c#GRC
zV7Fobo#;Fd<;x#9w~UZ11Pa5PSqjCn8=Q(Cqom)(n>QmmxzCHzavLz=&I_Wm8D&gD
zG)LfsVz+@cMnI6#4L&TT<_u%wnWgsjcH+6(NJVAQ8TFK4_=*r=&D^}HMa}Ei|5Wup
z)-C!Mt>7yl{esliuy1${Vp9fIIo8$ztCbFz#uY~{bk?JU-GD>#g^`qKcO_4Ud6W=^
z&yoCK`n!>fD06G`&)x#gFduDileU8q7BsQ*>iq?9tG=05i%#OX0PX)d-f7F5X%9L+
zhL#Lte{kt2y1t-CCDC>eRXm~@?7wF#u11jk?kr>UaN4luInOJnXg?tyZbF*|csRl8
zydBgL5{nPMjmBvC$<g5Fpme%h6lwdeVO4^EA$3XKxs%jCN4iYJd<nWtBJU%aG3+~S
ze#{{st#3Epg72y|>%OHS%XV<$awqDQf(c34;k3-ITNSts>Kf@^k-j8Jm}WG+5m`^H
z*zpbF9GkMalboMwQTgU_O(H5wh^ZafoDjn>zSlsAyZz<$J+#Ptc?GDuP03m=fu}7b
zYHDf@qeDhiGDA}EJ)u+f!pI5?Bf;=T-Rp$HhZlUITYvW0Zye(R+N>N|kR7dL`m8mG
z>J<@3Gxf=1cyG?X;x=T#-<{;*reHD@SUP@8y&Mvs{%@_q+K9_1+d^`LcMF;S{Ia@u
z9Lo`4WcA5)R}7HU+H?o7dC_RdUS=;B!Yttv5~AtZX9`)xxkV%C+PyX&hUw{PMPkA1
z6!MXcfmgG+>g=`|`$tKc)tpwudH6y|6ZfPD#Yys>Sq`k~1F#z(ueXG6CVTAjUN<@?
z(BH)2*st}1OW#kg=B@a>VXL8UGUqQ`cxAMVd_&+wLf<+6m5|aF6;}~Kavi|^vrguc
zL|ysfc+nfjgk3v!gc1AQF4!?rg;7<eV6=+D=8+rLBnH36{ei;z)4>JA4HMCvF+=Z!
zy+438<Ek(AVU`=p4<6ff?oXb2ZOA;b3Z01`L21oszg2Q9<C~MNKX7$-SHwn9L_yVq
zEt$Jm1_%a9&+W_tcub~{I-4AF!R1QB@$Ed%%w}EAD!e%9{e~OjwmckTl!BVr;L@;n
zIu{E=4KwU}{djOqoY%2}R`rVfWP6|_Vir?($epZ_jF_`V9d$F9&*}?4S#OC9O#ok8
z-)#_<EP%f9n(%c5syqC=vy%LV6lxm20Cvkm1sf6y2G`tbu4&`Pt{OoI_W}5~Z6icp
zpgdHCxK(#RXuOfx28NU-yWy|D{)&3Aek<+BQFy6Ggf{$7flLqQU8jtj9RM?{2pye$
zGVwcBjoX-sgJA$M!Bszle=+*~qWIZf-OT-VAG{C~d-TjOa}W`H@+7D8&8ooYVY;0r
z4tEu{_xkfof{VSpxaXdyjh|Ax)3QU+A|55|3wK^_ZXH^Fs*C`LX2j%QRD1`|_F}I4
z3zFr~CKmI|E2+-PBGXK_^_h@P0T?QNje!krkaq$ig4EPAI%*tMfUe=?0CBunrd7|T
zRt8VZfV1CgWChX4xw;9uH{}c@_1iO9427Z6OyRji829_J``RMZHn{aAw(Lvw@bDlq
zUuXV4o1&B(pEij&z<9fJwoxF=>3sl1%IM^PS>8F+)3l%m3<*?85@idfx;9I*eN-Wd
zFJA1~wP(+*OioQr%_8A@!M?r<KW7JOBRx9DSi|eQrG#$J1-@L=sYU{5v2dsB{JDb5
zQ<TJ2MYak~K9AO-L1BwtLPJEg{2}x)6OxL>?6^+RV$*!TK~;$1bYKD63R<HKBu!_J
zgG@{%^0zc#g34(=y7D|(zfzAge#A6RH#BfRXuAA$S2B#+-h!)k9w3q|dIIC@YUItv
zFH86`9gNS|oh=0z_l6s3+u+u+K(WVue{`udEO_e?b1WOl<3)m?p-Gs)&y)be)@e&9
z1K1ZuEbJW|2)ngb$PxRNmcAHXhwfS_VJ<b!YRuT^45(N)s$0Drsim(XuMZiJCbEUL
ztfImPFZET-JYui3V6^MmEc&Hxc(|MgQTa>JlTtOtVsxVO^z@H~#aN^aXlFW6bf?Wr
zekse!%65N$|G;^WCNF)>ncJdw6;>}`mSMa`l9Mky9^K=fgj4`z*p;0w&16A3DiS{1
zik9QteyJ;0xa%}vOAUvx=sfWF@lbP`BymwhJ>7Hs!yRG9^WrZxM~KvgK9ooPC~81&
zbqJOVZ5Zgi<MKxt7(xq+0ZnzRDfc@}dUhUHV+Ha7jV@R;Mf~E~)uFtDz<DQ}xwPGl
z^e-~&u!zF-KUD~_imGuQ_jGycC_{wf<pcoth<VmcebtLMw6v%iO}dq2SG|6Bppc~(
zfUpM^t5b^~x@~W^)3K{%e(7}NF>1YaYZ;8%&biF5)T(4!3N-+JM;`gDpM890dx$E(
z6Pr%Ng4?K-3G#Hr{8JAPo`v3n0s^hQ)0m*TO4?5mL$bgSpeXB;b(R)pofF+4Vbny)
z9CDe@4?dY#8+TAkS){lBoim*U3TTl9?&k80Zf~tVKzzi!8CO+^3D^whLHMN_)*f1Q
z*Xt2Q?2B?Rnb<N|{!P1BcFu9FQw3|GgEnK!%s$x6ZY^W`?V9@yL`UUu9fJxfHWN4d
z;e77QW>OJ<r8z<d7m6%UD!T6!pp+he=X5qi<5a3&XlN)Apzq`jVie&*x>1{6rUp7S
zx{-O?s_cLE)62+OT2r4x_ukTA?8SL-Pu|o$ev_rvqVn?cS`iA0VVe2W!xHcC_)Wi-
z1-8=hUK>cf)Od1EW{~jApj8R^(c6W&1){Vx|Ke?acl!__W3dAWYo(2kICnfQO!qof
z(E90?^1&M;vDA%ry)Shs+h(F(bKU6m-h+>Gt3@7wbL|uz#n0`z-#*ZuaOdiN;g#Y{
zH+$-N&fLUw!;EoRpfJT<jtxoIzJd}dvLN!gPkwDp4P|3A((=6!J!Gf{L<ENY(LhfC
zO{+I(%~E2&z@)=-&@rV*<cE=--`JJ<++@7%m_-P3%Ese!;xwwrKKmmp%%p_+7#J||
zz@tVY_R3&Kld{O?WM?|Lnuh1w>}fwAXY5=cIuV$YqlDlg^6WrEJgY*CyeC0dFqQtb
zZk_4iMv6NpSF<U%n%7=-9(=l&=L&@3zJ>SS-bC?;!CDZ?rkY;S=}3&4fXIH>+-{Fc
zfIoDAC5X8m0s9P(QrIaZ@xY6_p!NOFJY!MOs$jvv`<^f4kgkd>0&S`)b7vEvoYl@*
zaW_0Si91;A^N#DUokU(gVesu34ey=T{lfQGQ>eL6Y~G!)uu)fuX`oSs$oE8YLJ!HC
z)`9I-^7`xpHsMOg@ow>}fPQSsNriQJ84_;fx^Ixsod+Rb@H-ti;>)SoerKPqqs|PZ
zFXut|M2)uFi~M`_OL!ZeYe_WIo(Mf`f4{`rwRUy_rqrC#d{x3Z%FR@+p~&2-xyR+v
z7Gv(GNqyA1fLo(Jd&hT2;Qfr($w`%h4nGXxAIt<h3?v-Gsk|&tCL}YCL$4MGf^fT_
z75K7m0R;muq~e*&gZuXb8wyg<p9`;RkalD=q*~QTrXWav3iK#uy_Nz#)!l5H=5`%c
zZ<=sB2_&(?qQYj@dMwmQ*j5O1ZBvGE$mC#SHM_%ZYDN>sEH9Wuz?1EX39H?U@i*fl
z;f=wNX5fXnvR4GeA5%DG{n+G$#-0_LuGklA-93f}MO#@0GN2n=&h+FR3JObx!u#hz
z)d>jxB{H;VZ42%Lmyv3>>Dz}KXfhVHRR8+y8kq7mwb5gL8p+L;FyY@CyfpXVD^EMa
zjo;5ASYOWW3{5Rs6Yis}tGhR5$KQW{AM49Mu##EaS#Rr?JodUn8T@u)b^@55j69)}
zcss?riUL#6*JQkwj}k3|w7tNiXA$%R>5ecqvBPD^ZaI@+^2ke|K<$0SUYVdO6Vm9M
zzPZ{ZbPv@kA6b=0dm3x{XW6$Xi&V*YHT->m;e_3^0nKUis7RMp6vyrbWEOpRsmcFE
z0TZa^19jp=b@x7U*$Xb+tlVlMzk+vtYd13jviAG<lDPtHum8y&$VqsKZ+JZN^XJrR
zd}ZOzxc+lc6vY!`LB<2ma@cQ<eDe15>-EW3zsIFbsb6A3Ua5!R^ov#uOl?W?gpJf?
z>wZ6Yt3X4hR3<i0_t%Pnr|6Ovrl8QD%awgl>>EKHglg>%?~f#?;U4r!{wVQTlm6bs
zoJHD~ZHF#o#%*o$jhO9Wi;j*)nbMmfB^*;s`oCF)6QDjB{C4C;Pktq5qXj{ljbCko
z2L!m)|C0btJJ2Tb){HG+AVC3M*PAg$U=fLM?YJ-|Mn?1?o$bzc($+o<<~@^a!3z7+
zOx)ZJTEcury^Wp;8M@W<FOOZne+eee)0RU_P^^e|S^`{f(30eRA~_)KltRP~Y&J5H
zq3!bz!>Hb^pOqPpiDS5jPzSW0#|e)O1&B6A4kT7&-bxneJPp72mHw7p|C6x(mdNne
zur00Qv|E~PF+O2Aq|Ar$jm;O<QXIRFi~tPIt=2~-gUP4XhM6RSuObg&(4Ko$!(mDR
zzJRCi3|k0W#{j0D2sgA#TuiF?w|d#V*L-_tbsE3{_dtg_B_D~R-kdut1eXcC%pawL
zh@S&ZO_$FS9!@{g{iV$SN8G_KWf6Dg+xi>Al@KAsHQ+oL4~3i%s+Ex^P{6y6j3n_o
zE@XC|M#E<D{-OXUNav-62`PNumBbN?eAEH5Y_KB`&9dLJ1<l`$>Z>v@G(QIk*wozF
zchZ<wy$5WB^WZ5=CEQ-b9AGQ{cA`%Gf0pL?w$qMl6L`N4FH8+J)&7b+j-fv7)=ZO!
zN))fRA#V?L6m;APf>-L*9IvGb=7A29F;KK-L|M&+YX_r@dNJ_;q5L-HpVmy2XX2J<
z60|03X%pVr%@`F~fEpNmx5RJ$^BNxgc+Tek$&%;#>)}i;vdCYY#sp4}>%{ss6d3j0
zyxVDU%D*#Y-_}i=SS)ysU{uBj^M;b7&=5LVtz%z-ebk{|f0LW-8^E}K?R3OEihdTE
zYwH0l%4n*BY@?G2CJgS*p47od4<EibO${HFd8V<_bt;--+7pR~6At=l+`QiprYY;%
zVG0VdJ6qY5q578NNh#N}k)def(|7YwhCf^#)1F{AFmlAb=yr;fP`i;VF-J_jh)kjO
z>%<iNNH|=<X$3+d0EwDr?(99dZ^Yp&#!n0w$v_Pwl61~Ybw$OyEC=Gw>?zwN!t-Ve
zC8ZD1gzm51Jd~hS4!7i|j*brLAlNyZ()9gB7PGgntd<R<2^Gzo7Nzg5d)ul)UM8*!
zn5|=_C``j_g!e2g<+dBP%;L$Z8gJLUeIhXSamSVYEB!lkEgpGNzKJRIn>sNwyJ%=H
zqAhne_S2uF4u4u>vt>6ZF(c$-GNLVF0VSQxe@4v1t`Q0sbB%Nm_?K_3!SMTI#QnH{
zGh#$MH?MMev=kD4u<ZbI(G<qlh;Sb<Z?S%*B$!Ez)1K?!xqbVM%qvJ!n=h=UxbxR4
zKkrA69@&t41-T^3tdrS}PC0Nq%}oGin#|nsGS+d-#FauI8&1%j?8_<lVeb01c;#t(
zQbYYJ?<zCG0!SU3i1kIHJt0_450`(D#pd}}Xc88+ttklz0TtDFCr<!w&!p(RR|9Bb
zbCOp&1tqV>=XvJyf617HwV+mTErol7jeIds4pof!z2q!bQJk0C+0p~<U*W=eF|mM=
z>c+;#J5H#VSA<6}PV(s&uaE2ifK3d>BDYKpcXfrKjs@8dN4$L-1vJ{CP(T`^;zcwz
zr%&}FOVAFC;)N0hLk5<sQ?0t%+S<`CG#~k5%S5B2&|rtKJ=~flNB$$f7ld~|2F&f2
zw1A)>!{7Fog9V!IX!5j~drMrpbZQ}YXF~++YVewJ2`qJYYuBe6sumT0foAU;9Bh<X
zfY*c`uYjSYv2%qUZhF8qxlGCs<qS5HQtcuJj>_&hZQjk66l;k7?|e`JC}LWp37CXV
za4liYzTAN#zy+5>PV*=%0d0n-$8%u_ca8YewdPAY=4o2%mhS>N+>8<4*S_b;;{nLL
z(OrrX(eK`!B0|TjfeaunJs@E2mOPMfWC&1w7%JZ$`qVr_O-+nQ6K<JuD#L!(^bc9_
zL#QBu6V&7YQ5IlWeB?e)euuw_m{W!-6+JP9nZf2ZF*3SHTA!IQ%ui4^A&(ar>MbDC
z#{k1Q_Yx5)I=|g^kUeMa%bx{s<C-*P-nfdgFYyi@7W;$7XaasQB5Zv5)`5=}Ep{Iy
zz3$E&G9PG2q|@l-Rr>^O>%MIMoEuuSH!L^hW+km$ad01`BUwVlK*nW$7lN`BgRqLm
zUWg_`$t?n~tHq!d^wi>+_|XY!dBAzE(J^y(_%jGyPBk-C#+rDGfBkv2{e*+IaCnK4
z-?px$f!M@Lf=7YSPdX$x0tua4Q;E5)sfCH^Sg1#G!&WeQl#IDNdi2s!F3{UMOlaYk
zhyuFs)h&rw+&O&C&E9?Uc53QK$iv2sW^c;>VF9T1OVlW8kzQ*TVF0vR%K!aibCDrS
zcpcEU0th)bx{1p?ZQZ{tY>?|MgZ8hG>aX00tCt(9NAa)4X9<|+;v@6!hmRhWL|6aU
z`t_ts=te{717=uxc$A=pqctZ_oH&f*8z%Q`uEESa$y;wUjZz5fiJq$)AwZHHIx6Dd
zBF@oM2H&Ky%XNM#xf35H92EX_b#<#}vO1mj65oOIsMQ@9V{AsU`pDSud7-VubC;Mu
zCt*AJ^Lo_QZJq>PA-NAXH@2Bci)zDGbHZuKUSyF?JzJg};xV%XDMei$raRKvifGZp
zc8Bq@YUzF3Jjo<I%$1al<z`SHn~<@|ksKfb-omv^*i+I>A}@WG55RC&4Pq>3I_T7G
zuS-Fv>*a-Q$Q_dc0P_TVOnP-u2Qm5XiFT8>ZUhMJC`OO&sm~9Xu5f4-O!4}+(7M({
zO6?c107K6K4+~Fy2dsgV)n5tgj*a5h>M^0KD${5D`&TEKQI_i>m5ey<eTfGJL>BwZ
zL6B4F#GwP*HwOa2^ry=X(WShM?`Y{1yB!G#fFY#0KEh~*VGV`uFKgEbGoXT}B2Jf+
zb<hlQ&)4*D&fD}nqSm-Gm&{)T@Z{^^A@xRUdDLlHKYJ0pCXwez499@=h=S%31^GXU
zY;kH0>$7<6L`Qk4XNRs#rJ8WEt79{(6LU==eisezN5ItC#zC8x5EnOjzb!zwn{y~X
zKOga~9!#I&3qIl7qWvFL#ax=ML0bIxU)%nPN<<QEzHksbI8aP1S4|EUejqbU*pfo`
zhze@fskFfjg2Xzht?#u6J90Hm&llsG;TX|DOXhoS#s)%jH+0^J=0xy30>28^5SgPC
ziBB7NYaE%j4E(qbx^eOz<O*&cVi-r*(I&{rg0&CUWMH7$%S{}`MZ;py`mwx}jr_n}
zgfw*?%p%2^a?wJNpI;R|75$l`X06cpuM*D+N**TBm{+=yDy7y&>Fd9{UA4^loq(yy
z@gy!SL~6id2RQCieu1>lmv@<h>Gp;s*Cgw)8{~m}WHEiXf%u*yU2b@y$0E*M>@DhS
zO<7qlGQkKDyY*B`C^QjCOrC5lnvxixW2>5w?CwbPe5I2<0%Dd8ng3K<Vk)syAbzMC
zTXL)tTTu!*_IR2|Fw+RyzM~Vc#`!A8pK)o^>6h3@d_Z+3q+6ElR7|9c%xiFzzz`I#
z1y{#0h+eo*M$l^ib?ZyGhgQttqyWcBZT&RfsB0(k8dF(BiXfinPls6HcW&v14suK(
z<8bx+9|8q*Su@W)?KY|7td|jQ7-RzyMxy{{;QwDbM5v?zPL+2TiKutfqij#O4*@IW
z=#;M}ylYmVPM1UtZq5XRk<CzYv4G&y)qL9rz|Eb-lnYS#O97jdNS96-GHgujQ!tbY
za1&*e9B9&wF`#4e#z-1uMsZJmXY@%!2;g(m!>p*|5d;2{e9CHljX>&`XZkL-LE|UR
zHv<g5neV*`pX)_HMjg0KwjdkNnUn6M=R)R)50DR0=+t@2*g1fklfZ#&Z+y<4?XWf>
z^Xt?CIsSueO#d0JBd?8GGm}^NtT6Cd4=BpFpab)U_0QIJ54|t^&?Ho0b<0`YaT(l-
zKcQt10hj7Ep?|=qRX!=0Og9EqND?{zu#iyu8%v2fIyUzSjN+(A<hzo@NHT1vZ6hWM
z{D@cwkH$W|;>TdzB_PURYM_~U*Z~fM6W0nUFiUGDVK<!#a6LKPq6EudXSz_^qm|Aw
z&@0zj+BO$95F*p$#4TdmNkW08>PW1@c?{^ueum1dI#YV)u1+M@HS=Tpr4|j4wIp^V
zu>5q66W2Vj@Wk9kdLv+<K512WwVne9l|mYA9j6|IahJ>|Gm_CJfP~0*S8EV+0h$CX
zYEU@gtcELDohIOc$#y+q)XGcxfTH1Dhk1C&-5w;=6<R_5v|&Jc1=7A2ER4I!wWR5Q
zOe0j^RY)o2^W!^LV5gQu5%$h;lOLjFq%m-5<02dx7h%L9Brh4HESkcikJgP*oDuIH
z3pvNe@u{&<$pLq<W%<$wlFTN94ko2V0Xvybu$DgC$FDey?x%CYBoFsaYy}oYR6Lp5
zLomX~qveRjkc7qDH%`s`I5N+RIfbkneCyAXgAr=(*un1@Zt94GcVZ9)Ep0RClI776
z)b^c6)~XZR@9-8yC(t&5xMx(}-RktyF9ZD~4?aPzIMGKITBQ<>B)Ky{d#Y^5ABzd%
z7KPKdQ^*d5Fq`NTG$Y3E@2?FM<_RnqltgZ>2d_stW0i-aET+)+$3o^)ZgzzKo+`r(
zo_mHw6Kue=96=>DeGK}2Dgv-$vLq9=dZk{BEJu$P|5|>LlA2l%_1q}6?Z^1%pK~>-
zx>8e+UZcP%?4@5$>mz<K!P#za0;AZw+#f%dCXNS;<U|w)&Cn5-HwHAD8I9vwu^5v`
zcC`zesHhYmhclZ};#V2Wif{x`!<8co{W2GAoqxZX#n_MYWP~RM1Wu+72WFF@+i-z$
z!6cLM+#U$wbvVE&jQGbV$95I}qu$9w>R@EP+quwmle@5t6>5<@;)H9VxDuf~g=dHX
zDfu;~5(GgEc4|>^4Fr#K#S$z26SJ|o0;j@<SWs~^WH5yokz;}`0vj=6iUP{|;gcuj
zAfEJ)A(<Z^HxiNzgG0pSwl9CbR|1hMaOzeKq}kg|Dd9LTOo<!;1Uj7@bV3q8ZbBSE
zighc8Z=@SDUgU_cS!i6Xw);H>(fleAOn~j-A7GR%4w!fp=)@l|iSP}C@k3y!;m8*b
zwaf#ct$Y#VWe798fU?_~J5I%%syy4)r-V$=O_HsuQPz1By(0|E?d!F$7sjywWw=}Q
z=H)4JXJkz8opFbTQFi~4Xw+(X*r&?;*jd5*V1|nU2+ee9!G_GG=s?#X(<K+N8Fv@7
z_K%KoLiE52Wt|85KLTfrEF50MO$WEilgG;Lov>RHi)0fD57MbP?1X}IMO4{0sA!5{
zRCzN=a37&82-8CV6Ipc}kOryn;)M&&U{xhAU3xmymZO9-bPkZvI?TvuWBZLlTJJwY
z3TN~&n?+2x{|n9T6#pKuxbkBDJ#lhn8U8(jb7dL+_YI}|8>j!gn1AE+-#Gm@7XFQe
zf1%X>^?>Ya%IMRG9Fbx*szDAVCHw`tUID>4S)!(4>VEC!-PX2DXOh$4P>_)j#}NyW
zE<aAW)60nq9Gy0;Pd3Y2M^VU!5wO2$XqY9KW63$5=&il+eI@7vKD7kMZ7?HTE*Wzs
zM~Z+)ItW|L%1k$LUJ@|_&D+Z1NbvUr)6<ge`uZV*!*M1YpG$fLt9F}6wyP<k0Nddp
z0)pvxQ{MU-`iSv49gZ&&n`1%`LBv%YM?+3jv?$%9)`Jl#KX7}GAD5t!dMgzoMCOZZ
zdVG}x1X7l(_f;pe?wT1RLzZ__XEC#%Er~gPP!v~}_;Jt!IsO+TRb=);0u(<vpWx5P
z)7bZmGJzNhDkVeFI9=2q9#0!vUS}Mcq$w&2Q<4tsv{-`P&TT7`%sB5kjsXI387yAo
zhHf~^nQ);X8CFhPWKoDI!N^HCR5K!;zwr#sq&a@$VWi772@t{OMYTbNK%FFC88}N~
z3kE4&C~+hal!dn#r5J|*V{3cyZu#uoQh*&q7i(+idw8Up`xND8$*3Vbx$v0a+tBD$
z^g6<{G!8YPoE!jr@ZeeWLgWNlLXSm*VDwx(g?UDy`Jt117zH6zI7Vzl&z~=a#f%ZO
zx85>ZEY*=W6Yz(AGpL1Vlv0hO2iRL;aZ+lN5Dw2Ja}Z<%o-|0}a9d-PsTA)o9H(FS
zohE};80-6(A_e^dXAHL|NYOx(yiEMrpmV%28cI$W#&#&x@(?@%Pl)0?=3Yuq<U`UI
zht)V2$FPy<FS1WDRy7M#9$|cE2ZDG_&f)kd%vF`A<B3(9v%#;&%?-5WWDrv}j0)uR
zZ8A#+H-s<jxUMjU*Dqa|OX^d4Qc<xtwJ-7*TD9bNP4H-J+eVIo)oGauku`7lJ(@Er
zMCQB506iJO5)#sYFsAgKcUW-w!u+w*ViRcWO0Ym=vWr{+XNQ?i4_%!F(G-pjJ)+o{
zGqsDu_3NMvy;Y@)*PYgp%q=<dD#nwx19AGe-h*y3TMD6B0<HpZm(mz{Vgqe(-o5E3
zE%%3?vv(Sf^Mx%<wetDXISA_Xe%ohrS%*_eJp;#7-`@Et8yqHPjbWnaH0?lWL<>NG
zduO|Vx2yywV$1>Z3wHn7^kp1T7hO?Nv3d~aF^MT8Y6xluk@rdOgkwq#(sBHdev>Ya
zLi8I3jh|`|f@3x@S(DOa48t*w-h4WM=|^&zJN6hmxOuM_qrW^B*rlrnApk2t?(B&r
z#)R^&#N2ULG{4ICrb57dO6Gy9h=PVk&P=iq5EN9$Au+M|^DZ1h*whI6tujQopwQA+
zRu7wi<<zND9p9c#nt*H%_mL$6o{dpO6?sER#BNu99I=GwCFg7!;PAId$<M;Z?E=1F
zpb|CUmDo%dnb+5GasSQUTkWTtbF7T-O+m`Uxycqy3&;6KLS0`Ddh+*)i1Qg)skyXS
z#Piq*T6|6$B1cgtRe`yvLzw!=N}NA`o==CWMXn-vt1g}Q$$=J@kyn!L`N1dbhTL-_
z#=ECptsFABU0Fbgg5AxNf)xh`j5BnB%&eYKM%*dD`XVbq#!_N%UI96FDhj0g6nO)n
z9$9h!B_-0}8PfIa;7j*Q&oJ&tK!SM<%X&2Ug79{S8Fk4P!i&K)>}OlGDG5&jVowkA
zOfg6nF$gR@SYiBlJn?>6V5Y>xRSY>~Ee)&(`R_6gc~ZwYFwEiP=xbM;Y&TE<$Elws
zIedf*e5nG4GGPMepF*OHfdw0@4F<DHX|$P#3zQ`eEEdm$%{&I$LkvtA1JJP*L26?z
z5B7R_P)8H>#z?{8`SFD^qIGZq>NV+N<dxhV*s@FH)KmwEe166Ga|5gaQ^WmXN!0J$
zEB1<2OUW>fu62Y$d~cpte?fwoocFVvQzMQ@_EYdv#S|76G88M<&1Ph5O*NAjtwX@E
z8x}yKAU63JBxyaU_GCHy@<+1=IU=j~i+xsCK5i#y+Gx)tUOenRn3R(+bu%&2U89^R
z=aP$L<QS5$1i33B^>rjO>+r{!Xj4%u(#<Zrg%x+-TD<Sd-|H2Y7)i%xskBZxA=^lX
zoDU{@4%0WUb&hYp_T+I-;xoLx3<De%CktUrT7uc4w}K|XDJT&X6Z|q>c;%4z`s^wo
zwL=xZg1H%ZEDZ8Z_G6~4XKgKLSGJa*UDx*UnTo=xp<M4kj?$Zl-zydpl=ARNOoNvT
z5kp3O7pBsaa-YL77+2p#TwURgC`9Zni4Jn!uU^GKi_lk?0qvPFWVRUK7W&~H&eZY6
z;pRRpysyC>zr?K|pAt*|ROX>o55p!tf1Qw%XJ#oh?fvcT?X3W&m@-lG&??324ljbj
zkcQI?oG|JeKY$6jPo@jtw(krqm}s{?+LhXP$g0Z4%X}qqg>4l}h;&yg$FX;8ebWF4
z+`@T;HI?MO<8ZC>CoM-5uc;87;1RJwYDG0ce>!z3clsRGHEc?187rr)F~2AJddeQE
zB-k2bePs0zvwnu;i0z*9#ju%gikrt7MJm&SIMGUH9^xfii*e3y`szW<jjCWdacC=B
z3y!7{oF7W%9&CVmn^Fx{)o`S%t4nKEzaI)%@MtnLO636@-B)tc0pkq5US6TN62xr3
z;l})Ea&EdoL*8^{v3_En-)J({4l*<sCUnSuWS%o%SQwKqe%u&_{J*Roh6MC(8B7N|
z+0EV2c5k=tdghl+&bg}0Msa)lO3*Hy9LXiu=W(cuBkn~WeU`qE&$}+mVvBG49C%Fy
zExJ`Kha-D2a51vFdKr^((LO0#*yz-Y*6tFka#`7lA6#Smyut=cziL@2-0g`O+`V$7
zEo0i99acx>B(5$AB7C=PgN?-#BSh57eV{S@p%-o2MrP4<?ArgI_RjpP=`#!C(bIH#
zwCJQRjBK7kqZ1IRGAcn9N0yAmnmQm$Xo84>9Z&(444ZaQ3<zORj8Y{Ipa@}`vZ-)V
ztjOX(+)4lusZ%r*fzSql%9eR<pwlxy%|GDp3Vh$?zW2WOc|LC~pk{mF++wyZ2ec~%
z2*IyGn&l-P^a7GeHHZ%=o18$Czw9QY-BPj#yWM%|(TposkVim5BDAw=90wUS!&of3
z@>M11I%`ER_CgHbF;GKFX|%F91UdjP{^A6#H3O!Fz#+K~8rMIJIc(#5>2i+!VbUz@
zFu$1YY?hfzHg0t9kdR^ASE2P-HW?c%C%_u|^sAw3smML`tRm95VPK?5IGnw5Ir!ss
z+8^rt+r4tz%W#G#HP!0*BDgG7)s}m>W9^64CehF1?PIq~+peFt#@_9}D{MTNQCJcH
z;FkB-?n86qo=?So2)Wq405n(J-N0U2_1$Pcx?fFjbY4Xud5^^kdMrXDWU;u%CjXXg
zt01M*sfL3Ml|45%R@8{PgQ3oNUDaOTg?=dn4q(jRY??;ews%j)p7KL+OdS5$1?0bf
z1axA7cfpx&>#PFIvNm~SI=L_-$9@*pr*ppqi-X8oc;dlN;Ztmd=v_IvrxQ%kwPgB2
z*C%X~_V(;rY3PZ5<uGv1xhv91Sv7=9=wwL~x@rVvjR+_a)rHKgk^~-iJ?$^K^XTU{
zhAV%|V6f-Rku5rL^5iziktGs1*4xUI$fp4#n6Joru8hD*@m07rjB1iUXWO<VTgM%H
zIWEw?BQ1die1$*8^#wB`BqWa<R7eb|Ek%qG<P>ZBo;-}{`J_H!GR7<`m;PdOE}EKc
zYu8W<7lDUF#{d9+L|HyrdmV>c?C7D2&;?KSg*DI2XN840@>x<p7Sld=H?w)xA6F)-
z<O_LecbE0v@xpghThwSvPvXrVBYedXNZoWp@Xh#7XN_&;44w1}(m8*FY-3m9IQu6i
z@k%5T<o<Vb52tT0es%6GUn&8}&p`HlVk#5l5U@cG@;+GtT;Uu<Zt*s~^qwi-THABK
zCxvT*2MNgL=csF1@#w2yULQivEA7(&2eEby^$+NBpQNrx&D#FjRW&<1Z9Q#S*GjI%
z{N4kFlk1>;oY7`OzzfY<#E&@Q)E7J8P`h+4V+-#sza8(R$p;%lX+BY<!(G64lSo>@
zqDAo3DYqzn&=q(QX4T%k!g6T(cOW3KY;8-ox<nmUhPfz)5YNO;;=2=91n7se@w9=?
za>sAbCHp(d8LWsbaW{tmqG7*&QVaLX%uEh-CDG(>f{%nvEk%TOYCmkh>@0-ve4r?(
zCj3C=OjMfvmeqXu;`HOauFzV->#xcly;PZK&Rs6GI9q-{X*0K4Zsrv2tIT`!niiSE
z_p7uE=s|&ZO*d|LbAvo(H9?^rWn$MIh_z4+@Bi#T7h<d|&WYwjHVA<~e!R=ufgOPw
zGFgBkN9IF86;c+#v=BD1iz673dEwuxsUu>kpWbi;`Vb4#Q#M8>fBfg<1P=O*W05be
zeUDuw_vvc9+?dWqM&<n&09$HkYkJ7+h)(zErrN;OQ5wM!b?5q-WT3dQcr#zfr#B%$
z5jKk1#JK)q9LZ$luc2dXC9nN#ZlhMw?)~4HTkr!ukTxqh7$LXN0dAs+i$}5>1w=iI
zMSWmZoOxG7oskYYScEhn*T`d_>p=f)O>OlCR8(-8TvvQ|{ZJsm)_}ATh~7z(pvCoA
z=jn`4TNM-h6y0%C$34ACDJdCPo+#81$q(I3?;9a^`)ed-E8*b#Bq4BOYinC+lrSzW
z6~9N|B*Ge}_d0C!2l~5~s(C>)FnM)9n{)Ls2(-{{$`DdLff$${U!F0>`3&8;LjEHA
z^~ZdRZRj{xoq818ReiW&q%{Thg8)q(RdHkMYkYuGnD;K*9EVZlY-BYIkDcZVYmrxs
zjut@uxg5XqaP}Zy#37)7J5)x{b0RV}_aGy}9#sR{b8(RDllwwLk?bbVg7T><^Tujc
z<DhRv1fF#)qmT$t*ACy?Y%@iBZUicCDhtWW{}Kzu2L~Op&Z_XoIe;h)tEV6YvpEXv
zZ$9`i3K%pMq$7r)%=l<A1~dRM!beq>0Hi2Wp6iI_pmoG$2*Lj_^SVWmg((mR=w|Q2
z-}>*{%n_s;3T!C_DHZ8`BXai3oFVNGDey%(Q`2x>-0cF^ar_g&&32)Khs+9rsQ@nf
zLI^?>P<(M%J5k$KIm$uiG(dDw8L2VxBPh@5S)lmd5^PnU1Y`9nNj^v<s9yxoKzQ}0
z=JsC8CsGgw6Gtgi+avwS*eBURKROx|EloUeA|HA`f6W6=Tjdq{P@EkKXnS%=;pVA?
zOzdBM!;J$sLR&6m6959ho&)lQGZXwj`I@L10y7KGsao)fp5g-yc{DoNFO_56UO4Av
zjk!5FI`vWH!y7M~P3cdsXndYB&RimHVe<m{+}MGTK(C}5n%EENVT=zrHXs1VUUYt{
zcppjXN033<R20Kd?brRRgD_86Ql)eI`M8e(pK`I^amYdxIEQ>jtb9v~KrG+6TM6^8
z@amN-e#(w0-%r_=RMuEIIVo?g3jxwT^_yjLR8&x?eW89`ljZ`M6H`763O(r(nvVnO
z(;1?7AKBS4U%=C(E|??R+z{x^8JINft7|b^!crIc+aa13%<V_Qh>665CK69g+QZ1W
zm>7S}iNAb6mX-p;HaHX2#b)1nZ{2aK0>kltnDPmD5%F}2$JLC%Ten+GszRN)<9cJB
z^zO2e153mz!+=B?2E<<f%Ydw<0lE4QhBce*j%OnLRGD@>yk|uZOgvVLP<XWBErGzJ
zKR){t<)W}JqwuO}C7c0fRIqmn$7w$5rULwG=vzx5uE-$)6!7}?g?y1PfaaZGBS+Dj
zr)mlBk+dT6s#l~r<{&BYMqZ{qZ6ki$55dzt7I-_^;j@=66%qFXw>jnUhdPFn?Ydiu
zw*U_}sT&GgTDHUY8@$9V8g3CAggPP8K=48o#FD@}1U?(~KiC4tgL-`;%KZkzc(=|M
zln;BHXEdWCQ7n$0P8|(8BGsHj6W<`>gjB@vqme<939b@q(hbn8Z*4EJqtU;AVVx^5
z7E3$xB(M9^Yc#Ig?6qeW?@qc<BX{T*wAI3QjN8BhNW5`VV1U2kVkifAOEr{#d8liO
z)|Dp?X7Z)e`ug<XD31hwi!ZP3Y`OGlOPCd_{o_&t%9WE^->;vZfe148CtbWTLqgmV
zHp@9;JTRH%BQYvwfs71B@h{lHH~);T58n*P3~Tqz3Yl3A|7XkS7v_cfXFM?d5!pL~
OvCVylTglelpZ^EZsUxQV

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/assemble.png b/latest/assets/images/social/reference/API/trestle/core/commands/assemble.png
new file mode 100644
index 0000000000000000000000000000000000000000..0116f772006d66e06c3d91ec32410fc3967a39bb
GIT binary patch
literal 30207
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/catalog.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/catalog.png
new file mode 100644
index 0000000000000000000000000000000000000000..819a0981269e342581fa085ae187252066bfd447
GIT binary patch
literal 30573
zcmeFZcU;f=|34g#O@t^?ifD?WrGX@hN_!U#+Pk!ID5sFpkd{?xC)x{1TQs$`cWLkX
z-Jfx;>w8__|F7Hi$NAho$LWyXuh;YWe2n{eJpYlEme{&!?<NWgimewfoRg!V_$!Hm
zVzu3db@&~b(@q)`6!s@Bo;#y(Gi0dQ{^l;l<>^s##{-OvHg{}xJ#Go!uwiwj4-;Ft
zC-qz1I`!=weEp{49J~Bq>aeigKVi7)&cxyEjyG;kXnh^`$Qu;<aXFc%QQCKUAoHv3
z$H5Tpch&~iMe9Q+cTh3o<M6**k=eq+zrUn-e(W!m-(P;)yK49Euil@(wf6T{@l-mi
zR=zrI{NJ~ch4^nlR*u8}mnY;|V$}MT52f(*xOIzSbbNd#0|NsURdI2#Ph1>FaZ%B)
zUq!N&|DM#~?Ck8<rj4nUZ*?UMt0EtsFsi=rDL+3#Bg2Y`$=A>CP|w%UCkG`ST~JW)
zGigk{{PN|?bF5u$KCfPn?x1?aw(?0jRJ(T{7IWX?Ge4Xq^X#PY;jYrav{)@?=j_4e
zEalwADRtFUlc3K91sQhFSx%;}-~E0kEiJ2Lw6lKEV@BS(t(!La*2b$#HD}s3pStkj
zp9gf~__4QQw=#%mC?#rfwz|&8+YB|-4F8fm_u6@O%xWM$tz@wNU6;4$(&MZ7?ips!
zSrj)UZP~DS^AibrhjRf(HQA2Hg!%dT?Ybx<6FA;eQJQMnsQ2XoZDqVVpUk#*)xC{r
zi6J5`YIeg-tlz(XPrg>LX>@vedLl{k{i-$VRMv7n3fLwx^Pwu3#P#WOY>F|5c&>l-
zySI6dWH7HOomnClEcwQFrrCBcuGiNJJf&$EC3#kJoSK=LDe5eK(uIG<3ifChJwNmJ
zYrCNaxl|L?jT<&RHmZraI6pPi)fW{WFgZ{sg(a0gd}`D5WSzFuy-m~{%OkCMc|sH4
z#OUd$$inWD!FL4~c<m|8-zLh@((=`7Q+7^HmyZO!Pq^EXYJXkg$a}jhbK7;O8Tt8D
zl;YKxt0FHydHi^LR{wj$s`II4&1}=HZh2l3%8qN-t&_ZYGrh)2`u?{w78Xh6GQs#Q
zN5>mvrTw#i_1CJK+p01&XW5g_8xPwWNu@*msjyIjET*v2)CrBciV7Kn@@EAuCK`u?
zg*8*nTg_4y67!bEK9HY5@%(0t?29|j)6MpkFU2<pPS@bq*{MeJahE6Sk^*ripT8@9
za-`HWt=S+&=;%>t*M(7u`W&aU*O8Hull?Uj%86Q)Q8EmpV`Is2JwrpBWWC86;SlYU
z&=PENnQk7N?FldCOlxAYw6q+{TV9l5Vqy{!j@!Y>%`In^w>Y($!ENHZMAz3-BV}nE
zY;2NRj(riU2SNmGOAI^K;1P91xwyE3cuk*?!({5x;y4h`ZQHNlF!;6*M>^H@3O9?V
zZM0fSjHI-*Qk~a>2MUTY3U5`TWWq(*goT@9zN(w&bd3(NN;7kFR~j);(sF<9=y<tH
zQ)I69U~G?BSBXD8LtvH^R=37gRx<j-htt6W)@AZ6yEffB`$AUeiu=}mkych#CR$mU
za&~s9dj)OY6sCpCWpC1E<oF=AP5986GiPQ4n3<W2e}4SCt1?20cOXtJMKV$*+$_a;
zqWAkz+Jj`JDGctqyO*#hX17=GOKmL09%(srQD=?tY`t%>EpBx)R!XT9JH@<*ON--u
z3j!rRpe9yXrXRoP>_;x36|j2Ep^+~8h(Yvdbab?DSlH3)6=DAV?8+t96~afZUcI`u
zHqAD_*LI**mELJ-wnu-wyWDDaOrJ#4lOr-EI8<Ew1#ODzq~q06Iz#PSd~%$oC9zYl
zBO)%^*t{<b;*n5GH8HerWmk&ZPUUmv?{&poc?(R(k01B-@nH-+s_A<<n78;{g@`dV
z<ufW;TEiOqtJ8GGm9PKF9{sW}S-*6*fOYo+Jw3e(*RH*!6R<khT^@X7aekU>qO<wU
zm4mTMyE#-2FfpYV*9A<sILX+Jv~c1~ke^LnMBHn4{i0>l^XCT~7Dfy83p}Z<`m0$l
zUcT(#*{S!>qelUV;}T8#W@Zr)5xbG_T$lNh5CQ8>gp?0S8B$VDs-k2{$GS@OKi%D^
z)-2mpYxy3JL^V4tL4_mNi9gxFz`(`ewqSXCh+j8&adEM0IBO(;#N^9Yub2e{>a7;c
zTC!DJ+?HJoTe36CGv}vA_C)v{VrH&)7UJYAPj+#cpGwiK*p<L9T!<b0R{HIQScGD%
z68%6PR)+iLFCFhm@Al#jhBa033b9J%-Gy}KIg?6R{e=Yusx|wCZYGu6A``_>?iW<(
zl;GI8b7#%xe|DOtUL6>a%(5R*+JDMU0ZYM|RF0HC`73`LJJl7eRHCG$B%4KZNC@4@
ztDpYLniFxJNm9$SF?`WzjTNeiQDhHp)E%jd9@I=kRx_F!tY_onOZ#@5HKG~`S~16Q
z(&SO>l~?DL1`@S$)GmkcfA3b7NSs6#-0fJl1?gHd`{vuC(f#}ur%#%<WPeLVC8_!H
zaG#gSz(ikFjD$D6bm%FAyt6k3_ysL~-r9Ri=T=SbVppKHMrt{E<mH8N8J{7Rh-#d$
z#ItA5j@7j0x#elv`pd<bx8}Ng>+cWKT?r<ZU6P|*xw*MU`R-fow6iix<|YUHy}i8)
zr`JdP*yX+LbXH}Sy?OAHfjPd|wbX8IZqzh1PZNJU^INl?Qh}9~)&1~Hoa(!{hPRX5
zqQ{S4VLp6#cfFQ@L8RksSK!cGi#5X22<6DfrIDSNSLx)9Zy$`DLTGgq<5aE;)xRtJ
zmM$GG5+9?SXjT&*Pr=T^Q<cDLZEd}I%jxi&?HjW`r3h`@xG@Ijkhc*(CMDCN?M}0)
zzMkHjrN#MEro;R^A3VLi(`eV>eJhUEcOTWvqzUsrWk0N-UmB3|zU>i3X;sB>k~EMz
zB4z?ny&5K6zt`;8u_LZUSB_;Zb?(_4VxfYzaRCK|g;IzS%}E{}9%f--VQrN8;xrPM
zdM()wr0|I8I{o^%zU$r|Ef%XBtFDrZ8CG4M8WqUqk<y_?b<<%k&d!|~Jz?*RL#E!S
zynX3BTChjjxFSIHok9IVX5H*~kA7W(CU1BZ3VVsuNX~WTc~@6gyZD~2F8y(bfrgY=
zXJp-3*PLV)Mn=YDosX+WC(D-)zC<!3C6eURX4BdE`O>Bg>xlCY_uAE227db{%c`B5
zT{AW~Xi}ONno^EP<hCEyh@E}<^eGFH#$!_SM3)zIYm^3R<GafFTHi0Y;j3hW^1Z5g
zt~uqob@A#)jBDe3P8!!<Ffoa1*8M798K#R^x_LfII&{!6uh$5VQyDFPL}uHXg8PN?
zCz?riyY9aw90eiT1(~%Z#vAcIiB$Rq`6YIrdG?iNd`o}t_gB1iIOgsV@pnYl`iF%j
zv^bAnu8F+7uO?2F=cL`>kF$Al{MOx<YBH>^+m4s>#kS>pG%m0yYG`QW4zau$dH?>z
zWOuN6%+ye0ERuc<)xq;`@;$aSYNTmq+08cC)E-Idua4Foe{vaJ#`CeUF*&AXSGD0_
z^W3*;M-CnoLnc0|?UpKX+dnNH6*kideVI|i`{=zVjr;_yI`5ZHE-WmJrOYBq)Z_Q;
z-yc7m(L-PJ{LGpfG;t?&zijaj4K+<^De^fuo-$c{BwQu_NoZ(%<fWjO&-ly}o}Dm!
z`Nf;Te4J)xro%hbO5@b{PL;aSdB30AL>GQem=3q(WYu&aV=1E&1lXcKtgeohkFWK5
z_%MY|M%>i<Ro>Y*`PP?KPUpR|tStqlrBdZVJcZqpF-J%Ppj212OLA2~$C_^m*<&T_
zN>BQKyw#O9&T|;=<~?FI(vlNj8?TX(Ea)=#z9!Q=cQ#T#^iB&$qvM*UL~YUFfm|di
zr2#ZA4c(c1O%`H4F4F^b72T<yKYvz<cUs(Me0{CT!SfH29EI4}N@7BP{?rL(2+vt!
zcS~Izhs<W%Xqu*)QlD<A8{DS)>ik2F0aEV!M?Zf)r})m`a@M0_)D{)`M06{XQc~~K
zu2;UksAO6budW;s8L2ku<dSX>$$#pD<i(3uDuky)ViaQo#-^r}mX?+R62}CsgBhHE
zor$$0MY%>=N9Vbq{cs54`)saUv>bC*YM~E>RAA53-=TX?E?esK>09LkGBWka`d*th
zZ1^?f`l45RX48xHKjtE`MVDs8mS#G(#dZa9X$P>%N2+i#2-@86S&Y-js5GkAc3af9
zZeCs-aZ@T?TADY%C@r0;ruE|NJ*IiBEW7xc<kCQ{(g(CWaRK&&Ki(EimCc~B{9Ibf
zu5H+u8eijxOu(B*uY`DKn!oSm^)4gcgL1zw+F^ChL<D+QYg(%-c3O1d*WajrUyL&1
z6V<flO9SkiEIn$tzJ>}pRCbR$wtwEJiV~5lkN#%7m+SE^z0M+^v5)H+iu$UenECjW
zxp{avwdZZRc?$~*)oYMRoZ?(vc+esmRli|GO(|6_bKd{$jqe;Cny?Q!IJ$>~gqo`I
zlQwMImNs9@!P2}T$s~!oVP<~*RJ@BiW64O~vewVJ(g4nPYPHzLSf>N^2L%LFxw*OH
z0<@j9Ul?m<SQQwl265|enGP;gdQ<!Q;?Ale0k8O;rteRBfj!~_G_yt;-W%#p&IE9(
zo21%K_A46xNP2O?tm%gwV1TYeHtMgEEm`~G^754W76fp7K+28ppSm-{-lKO~&0yWl
zo2dHkyquien6MJgO?`@S;9ygRyvV{Yu?*mx@q6yWN^;>O<D>_o^6Z|@E7`eY2NN<`
z82viWRUI2Iu<8s{(R}>)QQEk*w%pH~URdqt+@7NvkCAjXZrYU0F+M*2ge28}b{+}g
zJ?cc8(Ka(_@{o^(<pNnFcJ@-AtJE>b*j7EE_L3E0!d=KI0qEkSu%klHCK~7NDqp&E
z>GnY5oS#aVT8fb>r_)TEM^~E%L#mTdovUCRzXdj>pr9D7LDx!hi9$<PnQ3cWy6nCG
z)M0dWPh>=9&$YL=UwY6KQaM95h~hN8$Zh?6<lp#!d-v`MaDL8QGCs|eD!R%h9(gUR
z;k%}zV`h2R*DV_oyU?eT_ze+qkjq^dlcGI-?d}P~%5!WAZ+?z?M{Di7(EWC@kN=%1
zE%lBa?H2onI|ogdfC=<*g2Y|-C!sGK1MVmWFwp<@{0yb{N3Doa0gybm#=AN@FUZOH
zMtNNIK}8S{5Lj8%)g1ePKTVFNO~;z8r=)v~X0)3fT}iS~*yG1KicxQll_-69V$XHp
zx<#kF;`v>>6f~D7Ij;wuvQHq5B`Jr&-q#HbB+s9BXNl0Lbh~PjbK|eS{(5S}e)43^
z_qO|K_M?LP)2{`)&Gj9LmXCULDTMzD)4_wA7aYTi@~(dKWtK8&DJ`Rx?6BT~rRpgy
zDPfxkW*FYRb7x1TdB^k4pX_&eKY#gB@>aL-HQsJEpw+T)e=^YG*#X`g-%gw5&Kksa
z0a3qOm`8uF<c%tp_JP+ty=`6WEh$$0@g;@KSna&rnq-`j;<7RuM{RVyfvCECt;tPI
z8V<{g(_Ql;d4avXH>6mSTo)btYU6{e3T0{3!zZG(ax$Y+P4>$h*CqI)*Kch8f~M{A
z<Pd8@LpOfjZ08dh{9nWe{i_t7Ap+mWt@DAx5RsB=OS*uZ=@#qK^6ygrzFk?FA3^@e
z8bZRm(Ehf>C)^ah@9RMkOMxsBSf}O0*_uocx5&)Tzt83k^SLhEjMWG1D6?OFiI*lg
zW<0(MS$%e_l*=@=9z9vCzSHzD=dXdAf&=yMqH2=yep#;*(Nn5&&j0*-o8DMw@zK7D
zH=(EOC6|{L$2kYSz4+T1udOsNH#=L5iWff8?Oy235V%L%`Fmw8V3S{>G_tGy+(h3|
znhg4ojPi$jPnJwCPfXYdIE=miTv%9Yp0{`y_%JwoqEgDLPSd^^h3@f)!;Sjn2tcWZ
z1-%F!|1Ui>*wL?1e!gf#i%_tHS6+FaY}m~CEuIXyGIF<qc&@80a%&@{>9>8lw|428
zSf1-*CqQYMTCPRgC+F6_lu56@*R0#}c(^%BopamPt^Ued4h2RISM$_vxWCIgdvi$n
z@Hhc)*agEBXMlC-p;Iy|ecVt}MwL-eU|^shmv#%YF3W>>nXeC!F=CYBjZ&Nu9Nbo&
z7if7+o<^K7`SERR2Crl=X`A+F|0%WAN7YxaUfqc<+OB@FP@_Dkk&c?08Jm{uhb&j0
zEz$7l-sUcBg;Hsv+t*EwtL!=t_y37AW0U60n&`CG$JrSf&)}d73vbzV(DPc>rBFe|
zdaJ2H)srrBHYW|rXinnePa0Mpnrt-Bi^fTewFTx-1aOaUSgA#s7cXAyM~^AX*XsN(
z29dKD&q{jy8ppoAJ~kx$N+m)&Sgu>QuAwObn-goBXgbnhHP(4C*7lU$po(6rp`l?v
zs1RjNwfC|qMm2Jz4mBX{0_vPJ4oIvhD!LGB>%N8d+R4<HweyS9t?~5Uo}O}G3DV-K
zfL&5-`s9K;&?G73F5y?b6loI^liP(A*p2ww5ky3;Eh(e1wvXrpUb=5%NI(<zigZL;
zH`~_w`}ygmw18&`NsLE>@T2Jwsm@#X3szfc*!EXnyc{M}Kh|XSBk7Dkr+O``b@wZ8
zk>q|i6h-k`9>*=GoPyovhxlT7bLaZmW0xA!%*{`_p)xAU%0907fiL14G}0|zWKPzq
zD<bw3|6aFs3&XgeP~mTKfW@y}+u6mX2Hm2GmU?E@{~OLUw)gZzq48|{c9-syU0iu8
zRwPnRUjA|l&UmM@X&;SFy>YQGvyzJ-`v*s~gPR7YOZ?f{n3*HKy=}H{b(x*B7Qa=K
z<7AK4P_vicM8I_+y=GiJ$I;dnyPR(dga`N<jc3>&#xqQr6p~V&*5VjjPBDi(Wi&h1
zWdu0Uk7iU3xmamn0i7dnp#ghHc5Q58uF=fXx;BAGf>r=p{2p+dHSx>W`F}lugX2B2
zUUHPx`Cig?RaI32%H$ag%Roh<=#>Bwn2O|@w~Em6nT50k*OZ5zQf_gX*39o<^~`d;
z_e+g%k4M68e$pRu11hl^{Bb<kTk(zTix1j|%XFvQ`_IQ|=V^txOsR^s&OY+;dUAWs
zdbQ>?LkqLxm3eM%8Gv1FmcV&m`q|$V+<uoji|0?Covg*ml-^pkMh~1yWs0$KtoG<B
z%l5mMo}DN*m`73M5sG~2_d6dXP*G7`9pBA9yaOR66?k+~WtqiwLz3tAJ$sIT74x%i
zaVQ)PjzmwZZkExto21xHnj=x+uD)TyP9@)8NqCv?Ff)rEmI>qN`0|i_H($EbP)c3g
zaGiC$+tRFrS=JD5;F7bkq@?G>V7)x3Ld9N3;P-&#rRhASQuQ>mp_mt4<D-QPrEjjh
zGFd8VnnaLx1*n_7bznG5<%37K5UUighyAgebU`SQ3VbP;xBS~v+x9rqrNMU<dOwn`
zT6LGvW;LkhI%nA6$baY=s*(})2fC_CNPWQau;MrpUkDcx007~$5!doz-zQHF%12)M
z-Y%lSq9wF+JgHrd0C}_#HR#O}z#Ap_`uZxM4-j-)%Ju|N#$!+>3%tzJlz>)<z?3;W
zGv|;2Ag^`L*JyyWH^|pl6r<%LKFocc*>n{-+9bhviv8~G+qYwYdX2t@2=s#^U<3Rq
z`0^#@;Xb|?9Fdq?w{ERYD^%5HEMo`iG-^t>>_-hyMvYOxdFn?uL@0oMP@-4x=P~GS
zluVhA9O=nQ^I^|Dd(#w+mYlcn)Kj&$*X|L(A$j?-;y?fV)Bme2pL}GD+wxLLV`JlR
z2YHBo6hQgLR8x8K<AZ{N$dB(w;xrm=$}swTpGw?SyyAxCwDJbcx8?YD#a9yEN?yA;
z<s=@_T^Su6W#i$IC(n*NHHjuH2HRPGl3rU|d-C&6nK$LZe6ce#H~sznBaUk4#_^gq
zyhfB?pHZp(AE6V{-qjV6JJY^7xUM~6qW*d~D=15EbJ2*K)QQXU>vbfNL%|}ca&pN>
zK4=bCAq^W4FUaH0Ky6na5R^5Xi}47G;p}ngf4sb`rQBEqW;QXBZ=;B)Mh@&+njZ<o
zxk=AX1le1<W}DFIn``AaKwrcESPBRyhy{JJbsukfoHv%UIO%HsAwj_geV6BY2S2PP
z-}T(Dbn{#Ed!=XH9+$oW<RUb<-psGIyUG?D{)l3a*_9KDkRsWD)E>Wi!{X7{_*U10
zP(<`jgU2%*Cu4S=zhC(vI6a@S>GOW_QzgUDmz07r?<7wMKrW@C@>FvY&8Z%G-?5>z
z))IUJIJ=gVHR91{Zmsp$z9P1r{zw!I$Q4*R=8TMtmwvvePekp&lNEpcIyJG~t2)(G
zy$_89Va0Je54E+m?by4Qjfn{~jn#0IfB-=CIdSn~A`>9z(9>IfM<xWfBH`@p{JF7F
z9Unpd<tOJ0MMRRyzt^2&GkIu=J@^SeAeAnlCqKl=c^M$(5U>iEnnNJDvC$kjOMXwE
z(vV~X1bgAqr3XZLD79ceaNsoh{LhW^t*3T$b$3fDDFuM>ym?cv7Qg)(AVluf`K_d>
z0|9uMNHUNQ<T9-EH$vtBfr69m3yK-2@c~Z6#V3a^A3A>gdsTj+t@FQXr6e0p&qlN%
z01>JpDGE=sEe4SLcI@BJ>9)L>M&JzDZ_u*5d8<04X=!QI+!ayLp8Wb{k%4|Wg1`k7
z)@Zb(3U6f3lmv2df!480c`|Lt(d!}eTkQPF^y0+}!mwt2iv4ux(4it^VZGK|mt===
z1HkZCA*bx6larG}PE@uRfOR6MkdzjizDjYT6_JKPe#&~NA%&Td@#DpV_ul>9SBjrZ
zUpFNs1fu;%H4P-}G!BJ6^b_CU;DKrpn~si-gZNud5;U_U!$n+PgImF}w^xg7NSYA;
zt;pW;N@x3!sYFO*L7NNUZuJNm-206Y$HP+9ZMbt_fE}480HP0+D6!XQL#4OHCy3vQ
z;9AYGvcDRi_pho=0SeSZdLw)m$)e~fvm&&wZ^lO8T}!~TM4+j)Yt1jY@|VgS)9)zx
zAl|fJM{@vV61RDakm~yzJ|MC`4=o0N2ZK#0cp&%ldr#c>IkmL$e?0I_?hhr_ZJ*Zu
zbN~KhG@K=9UW9oceR^+HBYF7J(*u96-xh##;9x@cKR?N4L(<rx!-q>`L>CW*yUs=P
zo>4+s=mhoS2V}c~7lr9ob3FVb`u$`QT&v=+W9LqNq`(y=1$|_<&+#Uks>@?2VI^pP
zH67*cUj5IN?4{A^Lgw_rXDE;+htP=Xb8#RNE<HVVCJekMIjib(C+<*4X}5&YuPh&h
zMIO$Q0|2ZZdPQ!VUfIBDKKu%D@geCkOMh*0{5PxYGOmg7Uzn(p;dYubiB?ZbsA^19
zP7EVrf-B&d;rEyKsv0HwPXFH8)2uz%e-zaxC}i^Iz3DlDyeZTAu%o(#kNi<_NE07g
zd06t_tvo<THj>K6h~5S<tj~^|MX)R><TFqiJF-{3tp2lo6uY&ww73CiW|4VbqY}Fh
z*pIYmx-Ku;lWt}6d5=oZKRG~!JQ|03>ZLH(IYa2J>{c$KqM{DnLD%*ADkCbv8S*{Y
z9<lLHW=vu|bm*Kx*;7Vs=h1t2@7<$L*FyT%>n;l#Yh7Ma2J79#f7WmJAOFB}*=<6<
zZgFU3t3d5DpHxBLs5jbPVAbj}?VzK_!ucn0pZ0N_=w&3t>DSOx>H)ThEu}aWMr8Qu
zrVp}gGmehGx8wQE8`W=o@Z)}1{XLao-6IJwBP_(`x9-o!eK5msJOTLkx_<$s#zW%o
z$~%AFlIE<%TKf+A|J)B)$^YNk8jf}jm8*}m-|3Om&iyy^nEmA>+dDeMS($N?NpWmx
zX~BOVM4Yq_lr~z)6n*^~Kx!mPB`W3>$$#V|kw77Z_O*Rn$3@i^wBlv?u=d~j3bqH`
z+K%np4}jDn^%MLsDM*Ckzw6;41<VF!PlJ>yXwi4oDN9O9e4*nO;h=S*C$}PL4H?91
z4_66TI%X6|QYX<LS5{R)ywJ3=wq|B!{b#$B7>?r@E!xPkaM4!T&<Lr(5~ODho&#9>
z=evqGr?Dx;u^^#5A+`bNV6R;l=XTK3A0-s!#P$>@|EPt>ttNV}%z`Z;`i0fPj3wzh
zkh-PNZAW=*SWngSyPNq3svxM<05qz_EjdoiOiX9bojWTg7J-^df)_FD1qxY_Bn$MI
zVf&Lj^z`+M$x8uG_@b{Xg@o9NKGFB_<DY#mK8pVd%5NHH&)zYqPZm!#sb?a3Hk5h8
z*4&(lp+@CQn?9zY#x$-`z5^9lf5JIHC(}ptCF>SaUc7W^Vj}71;XhHiiwDa#))Vel
z0*uB=WDU@wwA_04x6m9ry_e67V}*2lDX(|^dg%)>4^rfIP*E{@Y-2e5o-N|v-tG%Y
z_~>pyNAZF?^#uA6JO7A|72S&;Ix8o~n~|_+6yr<%?=QuZK`sqnUHhjDN_v7oQbiAq
ze1Fy~d-OalkHLcnbOLgK`MrHF>buZSlj<16XC4NCT2_^R`~1J3d;1Z+FdLCEoFOH1
z>lJMeI(GHWdz1Rgs{CX_Yz;S*6fn%uz{el)_uM6?_P4BLE0(UK8tDhLU1uX~25K+U
zgLfx}fhZ5Xx5jlxGnSX;BaoKK-~PnD>pn&7c0$*)L~QW~FYV;`gXIkWI&y&di9Y5G
zm4=u<g7__8O60wqt`J==0tv&41Q|GzJ1-45BgDIV*S0?k?#DzH9Od&unpv|R_%Sq4
z)M=A0_?6VM*QoYm;M&K$?j-H|lhz|-(b;9ADYlv)N-Krh-9EPDI@`6U4=fi^L9CV*
z90I33eDD2Er?=!x$g5xbyn$BKH9Lgg@>AcCgoH$Cx@CtRkVf+L3i_xt@5<Z%e)rKM
zM<h@p4ub6TCHy#i1axLRr%tJNe+^|PNEF9WFygYG)}J>xeQs&-eKjgz7npj|e^w2V
zK8!3PDPLf0D;?IHi~iFmQE>Rlk*eEQml$sHBk7~XB1o0e{q{|a*4<^6AA4oh{<RCS
zJ53F)==mNDt}H-c;tApY{>*@Xk3assp2R`Zv9o^vp4$(R5M4+e?EEgl;GdqJzPc_8
zF}Tt%0JP(j+jMNWqV}iXyLHwDyTons<Jby0fhxZL3EVx!U@v-Z`@DF6;CEj|A+DBY
z7D`S&!s?o8D!NQs=*VCKTCCTIMgJV=TlL{&i684ha<0*yNkTRxy5o*ryAEMjtw!6$
z>ocsQh|D=FE%e9;x&Tn|Mf^}sPW4nj=sl8v(-H6)!T;pzy8;n_tjRN(wB~B^nzwL(
zdbVhwDT_f{Y=fQvRtHwnMFLq|KmbQv3gT`b8Q}te^bH6&Or#xRK>{VL2S#%ToKIJ-
zT=5MJ9qPNxGU_=#+O?7R7)Tcj&h9l>W4Sal&1m#hf30165%SS%m@1I6$o5Hx3Nn)o
zK;|d~cw`1?U6sEFO+HC01l*{-zrk4k?Bo+kf3}M^ZoKIdkb&#r?%lrxZ2SGr;dr4t
z&?hn~0tmv#<lwp=ADep&yB{AfV_fW!4I^&=W&bsp;YxI=qzSuw_wEH`i$f<*Dk6U{
z3ks@DjkIzRiWwcbq?J{2bS^we5n>*c#J)q^4p3QCh+_)Lm^jaf?*hz8G0?moj(oCZ
z$9dHp#}q&veuvmlk45Dqd}<M~^?)(<$6HA)&P_%j;K+snZ4fd7%-{|%E+nUe1FC;_
z-J7IU@L`N#qv&b*ei|Xy1>mr#ntc-imzZ&L^reTyy~?xx-9)Kku@`invAC@}Iyrf=
zNeftEETwH|D4re$4qG%+Oasy&_u3Zi^SAQ73Dk1DIMkd~S2ipw$!d!Va#Fu!mo5Gz
zeKG@rP^4qWL%wPdJD0sRStGC_HQ<t;<Ef)iB|RsPvoN7dTybxFaR0tVv9&^oH<yeb
z7Gs6|7;4FBoLGYBD3A3}#9PXvBAd0k6PXxRHWhH*Unh7&MBTJpkSTExm82Q8El<ht
zcsvy|=;ig;w6_p8ks6Q^ie_dBFQzIhE2}{@#TeDb8TS6TiQuV$TEEqsI2v5we31?k
z8x*apctIp+ATFu>z#qR<5~&#&5{W0TCPHdY)T2ZgE9|^K?w|LP%OuvNO_Y>VGyE(O
zF*ltl=s5-Ntv5I-Ih;9gRB91tiV!(JG^e5Q@#M6^{*VBgYB?HYZocl(3(!=6=K^Bn
zB0QzS$I<prLbiWXR(2`sp>T!IL5b?8$91=?RTbR-H<ROEDh0DMW9On3qJ8IjUwJDS
z8O2mh1<Fan*&@4j?};ML#&6KpQyeFaq8@3pM${&1Ckop3cfPmW9XNi%`o2IXhhW(Y
ztsKWL<5xH}MgWDB=IYRk9D84Qc+!pVR0zGo-s~Ud0u~pZtd<`XeG>9^c@sM@q9T|H
zo0}o2CJpZ|+Cmv-?Kt$|r7TNC_WyWcAg$-;&MC&LDGs&fwaPZ56QFI;MjK_+{`nv2
zyrR5XFex=KTJ`w$%p<ocg8e?a&nXOX84IB;;|Ja`Y-^I|{Akxd+#o@1VV(*c;)?K7
zOV;}*1}`o3Mf>eFaR`n~f#m&MXWG_N@7~@0>!z*f%62ET7Yo>!Zdj<4;);fYC(5i5
zXwl>mI;<GNcS#RPu}0)BFFAD$43sYM6#Fb*kFAbVmFLvXZR+dD*23{1TfwHD8YkAl
z{J&mL%Xw6sdi(b0;1ajixwQXtWXn)2IixUJmRpD#xJ=e4m$bIFvQ}6_;8p`|-S{QJ
zPYzZwBk0Tp{WQBqHEt=AqrD5xnn|FkEK|2oVJ9Ubphh=Zpa90A;-s181He`zvfDvN
ziu``B?r4DtaL4Rm#ZIE&>@lgyYjK?)a_&I>&Lsq0>0IzB`=j#}s|==FC-o6a(z7;C
zsj$KFVBwDo8?5HobWg6tt8o3#?=R(V>U6&(<+<N&c|JV)tq{(V-AEKPgV>Hj@8JGI
zDj*_@nXPgl;pYYt^O{7agv6Wk&qwLXe&$)FWGRv>bmh*SJJkr^=G;6a`w%-W@6nFJ
zSlCk1%*DWO?gdWovm9^?GoU=~(NwV0y7wVpi|k5KtX*&e+Y|#(D0xl+ej9isqBI)9
z<-R23|8T1<8_Y8<g-7q&%#!w3tGNk7#Y8P(`HsW?YcHT@Do9H|ihjGxw)IZ7T%M~-
zn#TQIgv~o{Yi&by1+5)6U6CHAtB~F)PKEAorr~W#q-^}NgNEi!ZGz^&+eH%65Hg0p
z@d`oHrgy4(UY%$D9-!FNXizXLDoCu1(cXHR&hz0z+mA{rryM8VAk3AZx>!iLp(e&a
zJVu1znX|`08E5K0xF=xK`*_pFjmL%T{?~$krkZNXKXl?mb(?mdwL20^Y4!L#R9z>>
zUP;ynFg*&WWA8=Ri8t-jp`Pw2-C0oMCZ1MEa;Bz@*ZsZdTP0d=_7s<ttSCHfqXTv;
z%PSO-UdH%}l0js!c1dKmbLUj}ng_$8R9BEFtFBQ(pvZO@-{Kuk;RT6dtbKIV&G)^#
z=+oz4>Xkh`E<PO2EESM$duc7o+DYfuhlejeyV*HFy_UR3dGMotn=PK{d>`1p76u+E
z0WI0zr>Q@R^h86yj17GQSR^cL<CUJypFhp`eMqRB?i!_ooaIxoOet7FL2qGo9t`K9
ze<x~*%(heE^umrb&j3^4&pNTk{7m$UtkQujp1uW=(dAdHA<*)i5lH9+%<V&QHsJX3
zZp#JIA>!c*%K}K#iFFGEMN^85bx<mR!w2ay-_-LyabeTn{JBcrR_bNDt8<1rF<OG1
z9-lbI0jr@1Av2o?oSd9W@2uTS_Tt_v?ntyO+-^(Gqf@oh5lKnNlSMS$kH@J!1YT#s
z3rX-ol*bhl+GaP%=A>D9Iy?e#XRMIHtq2d!((1OHvjFauz_hBNf9_{PtD>w~f2;Cy
zUDcXj@6n{}o>}(-l49j6iEUy-;^)topt5XoUce7=Z?KN|)ItMo<_yBw)T2QZXN<H<
zN42t9;L{^85xsus2{`E#oJg|-T&7JpWTv`!IBd4i@qe>mAPYd`WYDH2<D)37vcQu1
zwQ;JIkdX6-L?N%B-7j-4mFzgK(uDj&3{1@Y{6B0K3CskEMPMeefx@`!ga3TClC;Mf
zj1!BY_YA5n-(FAu7??4*pS=RDVJFHd5jnxx5XzI#IMuPr6*j?uV}2g=jzvaV{V$(e
zudy!T@0KkN7K2^Sn>gADt&6za0oOZewy+AG*zKx$sY{pq2$Cbl7;wP^LxRSwOwc?<
zSlT{2k1e!JBzLr57?N+8(k7}k9Hx<TDk(<(*^5(+gfR{Fw(tFRCh~Hy!OXME=T<r~
zV9@$BbL6*Grwuzsy>Iuag*goi<TI=Z6LHDxTWVT-`wOUVH-7+j@rO+oa-J+6i#=&5
z*evrR;Autm;(ByA(V&$*n*w(pkv`Ehg<~_AOZ7G_Eo~0M@s{ZqesY(eo%lXQv&*tV
zd4m@U*Kj3B^Qw7c2x9#ZoLGPTfTcBK4%z;4N@#F!EKuMVrb31tJ6-~%={WAoU79nl
zK@YmRailu>iRb<M$C_PX%tN9{9mx3BwGvabSA4r=;jNrQmf6&7jw7Xnjk9?ZZY(Y#
z5$iOZA+h$azkUo>w6<ys!&1=SUf>nk;0@o|{M_G**UMWL?Sa0Y8MU@JEjTzi#R9o~
zRbY^hl1`a-{-V5rb(bV77d^wR)QI%;DnuOu_i6+ikr9{zQZ?D&2@e&pKCiE@AB{G<
zo=yUPplDza*|r2YRgLI1o1TI;EEf?KwQo2o=_hC60t}k&4VNS(<*3;dj!ig|1I~Qt
z5Yh(3uoU5S;u;J({&zb{n+pc_l|l@Zz+*Mm6axR5#CXFW5nq%F$nGF-3U5>_NQ(NL
zaKQX1s05cLC-JizYdk2?e{Z)g(qcBH)Xa5OwH<D%A0Bc*QNA?oe;r4JjfJHsVF^v&
zb-}wJ;zi~w3g$<EU5_^nqsDIuHHP?K4e+&f8bcL^_6#dI$!`xlu#IwbYvR!SPeO}}
zHEYhKo>R6kH#ZOF+qH*k5-}0fKmX5>uw&WfD3*Lp-ojUl5ffWd&^%w0uLuhAdI6T!
z&<TlC<OAEr!oX8fSgy;9G`D>^I1;k~zuo8S;WvC?>geDQ4YWpU#s>kc*{;#lJ*}<9
zY2@T&@r!rYD;lU3dM#EG{NR<!Zdo7(NXZ#(Lj(jwFZs!logv+ZtQ+Js-Wp|Kq#>j5
z#p}Vs^X8!U-5d9dIH$L{@S?5HU(_=&Xvj(2kOcqlzgxXl1w#ER(o~5x4t8|Bf-~1N
z-CUw22~@==S#5|K;!7thdbNLnbG>RbXdv<^*Qkcg)cXuo-8vQKt{JQA4sG}LY#B*}
zrv@(J8|hr=P4Y!=!w|37yVPG5<=r;Q9#JhXBdqTj9<-=m0gk9K#hb3J*WsDKXS!tN
zi@{<@RY}pNB*R880k3Rb{`B%b3pilvefx~lMV&-L%a`7jhb^Yrk7(r&@fuYZ{o)0<
z3))n^@5Buq<@rBl#FaPl?o)(x6HKT(_U#*xJw@mVZ1UciCjdcQ*}v}eiGcXk6dRa_
zpEf?NMXgtG)v8tQ4e$#lznB~cjc^u%j@cWiFi-nq53#Uf*GM~U5eg8kjM}rct`wvn
z^3%SU4lv~;P5c_o8qO^J#gD?vL9~N5M~9{H@a3n1dmzO(N6x?Z;Q3lr#@O*x>`Nc7
z2b>HfAxHKDp@ff(%-_@{Y9%q+v^gT=2y2u-iOsl{{wU{%+cMeen+^`NY`|x{LIEI=
z1aAI%-sX6|Vu(U^FO`lzMc&d}ETK)L4P!B9;Xc5jntTpFo1x0ZtSSBbFPZIVuyVc?
zVga_M)Iro|RZa+bA;`p(WjExzZtGqeHaL_{G|61NBKL^Po@iaL#M8t)K@9-t=4-xw
z?%dtZ&Q6*bd3beJGh`vlZuM?M2f!`lZVcP^ilaGQ3!ia$T6Nd;Q1nV)j(L=QH$}s7
z=^hKyveq_2&RFDthAL2SW4hK~*9r3RMrPj2q~)d&Bq;X*{xSAw3R%z?)Yj+-$8c1F
za*t(%1@TF2-gDF@y%ptduUZ}i<9i}z6W7=|I4%(;2ZmDj{*O<6t(-HY;8^}#S63$+
zif@$!UDYQ7acgUy193=ZED+n@KC|?Xvg%}off>YXO@c(-a@)qQLB$}Z#<twVp0Ym$
z-$AgPQ39Ey-XavNZq;JY?1UQH_`W5Lhl|%WKqRyY;!$irUZ8lc$M}J*8x33M%xDMJ
z|Lna@_go)-3_uT}nqd`@?*c+<pBl04-V*_{W0$W>gOL>z3^u^@YLb4`Q^^-=ZV1(;
zO%NokReCGJ9dG(vhU;07l#h=OF#GlNmdUSS!t7w`PHK>`DavUV;or-A+@q|@kW!$;
z=XB+R*RK!d+dgQS`w;rWZMdzgtE-QZ;?~rIMb#b54QSI$W(vkX++Gv8RAM9iiXkOI
zDgK!sr@9ghFz}C<)N>P#X^S_3f-9n9u1gkCbm09on0dItg#BV+U>40*_H$(}lkJWb
zBJ*)C=IN<VNR&D6&_#7~AK0Y_9m#zSh31_->Nw`dJ?P}+x*s15UuUK4*3vS!bUA2o
zJ;k@Rt9EmsYtl={`#6PE+N-HOYZC+x<oYEKwcO+}QGubtUV0csdZb(zr&(0FPCRz9
zVbx*c|2=p9yr2zNP-Wbq{o2EFu}YkHWmmZ`0dRs8vKD3>3Ad*5fgNsNLRHdLv8c%r
zla;7@#A;|=v_WKR$5Y>=WjHGj0AvQDttdw0$^wDbAIR+jxE5ykMpv&{lQH=hMLI1W
z)hx5`aK0^!-dsrU_Ded0vem(_2)lu0>9!C>wf8}jTy%Hi&U5EFQC`SXs=`_i;()>G
z=Z94u^DJ8>8%Db*&yTnqWFjj0o(G>pNXR90l)0F7m)pa`5mKA??zqPTT}pw-*X4}Q
zSxg(=`;c}PZ+&^0Y8S;%!M{|JEV^X)v(8@0t4(&EwF-h4^TGa8wb6@8sHOOEdb5U8
zDB&<KN$GvOvo>-#M^Vl1eMjkjyq8|OG^UEi*I$zZCAYQCvRm1XOEVL{i%Jyw|M=*G
zlAn&;7mDT|5=Dh09^}rT>tV-jTZJfY&HuV*snYw)Ab*3CtEB-NF6j(L^Q%U637n8J
z-~X9uBp?DFtDZ^`uUEb|o%?v*$*g2aiPiTT4|v8yv~wJ53>SklMlAp(tLE%^yB`k}
zexNH!#9RM#1gqeWJue18*^o%_oaVrXJK|^Z?!0El2Ofs5F`V8(Ig9q9>DWs*QAZIB
zI*@*D0<LyWm)(1qM`x^<QFGuRIj$fP#RpQT#ocX(5XfEh2_d}h$eLFqX=6J2dUB4H
zG3q`Qd&F*Ny`iWBdJLKO!{IAJj12a*QBVw?yS3JfTfgL{;|BL1^P>}xHVCJiJ^u9+
z>QYDhmBm=FWMja>#C+w|>}u=Zp2{G!IJy3ndA9iHU;8dAbC0v0yY8`Gk`>+wUWFqE
z4t(gSa5;mpIOaj8T-p7Yiuvk3p^H6>J*Xd$Uf*2`6H*<pTul*2rStLSp}hM&ot;Gh
zzD%TthPyR0zV*27mm)OXUd=hi8ZQnpXea1&KYSxS&yTSgi~T&e#jZSXr;ucgKl{MA
zZ(?Eh`ZC5ImW$RKwo?TOJEamdRh3Uc@$|#xrmJmbiTis=7l-`ALFio=hl!I_v*kK$
zIC=;I0!=PnxM1PnmdUoYFp%euui^!tcW&-nNTt6Vz`@ntfpbW{1eo<d%;Gc{E_f0U
z(CwG2d0Rkli*=DD8nIOb$Th)sOPS(>={Wd%e1Mq<+gYC2Fx6MJA{NVvQcxJrX+(eQ
zkgO8#A+iY$DH(or_<4IhvBMl)?0O9$tQZb7;+a1>AZ8!YH)9o0U9EsZmEz<A_JmN9
z3;qns5TJOSMME&m5Y>D)6Peh3pw~I1Ux-(eWFxZdf-ZX#`714#2`fdW4`R%afSea6
z>&D>bDuy)zUi`FglLwiYAiR87yCF&EYIoHcxKAd2$UF+3wS7H+$t8)y(jhEJQodl4
zFT$g-GIoi<mZ)XlpZBQ_>cME5jC>lEs;=SprK9u;M)kNSy46?4Zb?h>l8V+ELIz={
zUkD=eSTzKXASco!Sc6uNni$&jf2FJq5sjn^?hh0uLtR93fcqs~M}dOkARf&Uj<kGR
z!a_P=;!5+_-szI^a(^PF;YGSq>a?EV5MMxzUjaZMDv8gzP5bX;@@MQRtCS2ya?8l*
zMbpiWhwl9fiCUV$e67ST2;{UkrV9EP`V+U1N;lXxw$>fD4$0h1P~2l($p*T!eTtEn
zXjeRkjzlsCcrqG~zC^(?l>W~t4(Sm7tLf7CXpLh#Dx@$Bhz>;x&Nw#k5KlHyvt7Wl
z5#I#pqHCGWa0~_fa8cUzh^qrjs-ONSh%Y38kkt9Mn6qhrzoh>D##Q`oN44gk%CfST
zu4@zcznd;2jg|h2I^F?~)56T?U1f^rRI52u2EjR6gyP2q&GFk=l2!(04qxz6#I!(s
z?7q*Q8O6k-4?X2zQ?RBm&=T|*k49l{)JYA)>EUMg0h``$9}O2V74jVcrfavS`>|yi
zW1-)BfxDHl(5~DE$e0e%w0gF!qtL-c1{}l~n=g8b9+vrjvrAzx-7L>mxV=VJBf?ew
zWb<gLhhX~*_t&z0AMs=YO(XE_9K<w3Qdah_Pn&rgiO{-r8V#$te4evi4yY3O`D@q^
z%IP7tl|#|({}~@&dg)k>RhQ(R2Y*rg+%SB5try5+pa_q)TPsu1P_c|gsRqEVTp&0=
zOO%(lc7m&t4g-b5In!FI7<+l)2o{vPM%z+(2f7dFnZZzFY3I(|hEqlgjn3<+sNmr=
zG%a!|Mv7T=6=h}bGn}z1<aNdPUQlk?LR6s=0)P{AOL6Ew6YvoV?uU$ch%ILBSUD&T
z%$Ah2FB+A9dhTnU3J*$L7d%_dPVpgS=C6P!v+(gbZlJ`;)!tGE`+T$zm<efyQh1{|
zcOJfUOd*OSSycZ9O)a-YTaTm3NPpL73^LBUT`6G+_5Qd*=^&dB_q8mUV4_81)hB|(
z$O58=TcHPzZQj71?(Px{nO?oQ1#)8YO*o7lFe~N@%D=%P2kHQF#-l#h=HF>6#8=2e
zR`A~4yEF+;LP7@b_)t*Low?Pe2aP_A{*IXI((H8<kpw;rJV!YXF;(o85n@ctor`gv
zs=v-{@$+=n0PW)JFrtp%IdA7HzBpUk53k36vn<EPWBrl-cwIt-F`Mo_uzTuc6i{vb
zFB)Kz!#GLdzzp;bomBFC$-F#D_PUg`g>>8rhbkDI`ldF%Y(JldVqv@>b>yT`^|6}3
zyu7?7=&_Ogt0_DqSyD@Ny@ewmczSwrH-{%CCblgBriA7;6I{?{iBV9<OfbO3)AcvP
zj+cW%HrsF+vssuwPKtE}fZ6Ij4}-JqjWWzno~Ukx(C{9({2Unqun32JH==!pEsj{|
za&S&poXj|tM&uu)>waVjWzehEZ<@jR=Fb~LICP)S?28OmKpWoH6OqKbxUf(SLkwgU
zXbE5}zW(ARa`XyEFoJz5si;USnzH3z;kT!BC>NKLalrFk>;`JfZB{UCQ!6=aM!}2M
z)vwHh9Fcc#be`*ry8Lh%cJmWWkUhx5CQKoUjqQUU35~!;{nBuBhT=UZ+>^&9SA+Sq
zmS61q_2t4j1$ZGZo2JQ0MnptJ6N*Y94?Wiv^;DC$^~3N<D8L{zXmkXI&0kN4Oy}q1
zvg}O#pFGihlLyCz@gFchTv#_rhW2tW55dOC8UM{P4_}p(mX<0oK$<$4k{9OK&zd!V
z1KOw{oY8F}xwGBDOpPGw)9};)Ju&z;_eb%F19_Ll9?|8uvD@|&l-T_^=c(9ofbaGX
zNz0p*tCt$z8$M~{)xCC20cOq@Z<q0{$D3s638#GaZ7dX*h5&?Zu;VI0yTPX~Hh;-}
znZNH<HlZY+HcSZ-lOkc@*<eO~u}C_8fY}RBX)mF!?{4UZq^f|T??smt<mCbOAcml%
zZz5yk<MKE$+)Z`xrpF8&XKA0Kh)rkEt_vhHt-`}N_9fNUq(iTo@2}H#<2><g%f^jY
z2)@RAG<S_FWJ)hOH#~74UjYQher%HhI&IFRMf9t0;2p>=>PbI<iSrmxu6DwEGDB7<
zb|)a3wa1VG`I;G41-Q<ScyZ+(Yl@VUG;K=1g3;l(MaNs=u%iqQ#QchR-4f%97?5#u
zu~k%uO!IDOZS7Sf8fRw_6)~jX_KuB|lmQ^;i@`pC-{yF$)(V*TOXl@;jK&jCcYOD2
zXj4Sa70YYVlY#^XkWqpd=!DOcsMm1n$i=IjG=%HxJtiu@CDNIKl_h2|$T@2htRZX`
zL7CmsI`R`3U<{O0DY{rsXL|hC5p9=AfB4d?WEq&4FqH8aQ~nJp30a^{eBhKU2G_cE
z@*RdQ2=UQ8u&1YEK#h3sFg`)EcO2dWeasBF_us$Ip`EL-ZVQc0x>gv_dJ$^o3Qvp2
z1FQBJSmq+ak;vwe4M+sO#5bKXj5{>+A?-xY6~6=a6u>A6QAYjbh%1)l-1nx9wJ+=l
zyEcotp+Pm}-^!rgdBadKNPK=GE^{<7Rp<u^sEJ-8V#o}QCd8}<dr!s`P5y98rA}Es
z|A2-Ott0ozFhKPps7Ttxi9#GKRt%q@BjK295<dp_jc*4$T=~y*wmNNgMaC3Qs7o`~
zp2ZBxkdb_vlh3MKJU4~Jt1?1_ooZj?MgHK1-W=@GHx{^<JqB~Mpi5)uRivAe!osL;
zZ<isOo@`!1Qo%g&yK0Ouy~gm;D}=zCOuL~NoUzwhQ0P*SM&K6Lj~T+10ERB$;d*we
z6fDk^u)`U_)3k)sf2q7M({>;R0AY{GTZi*YpN0npVzGRH&+4SAHdmyXt<Z}X))!o*
z^uH^!9U>^gk{!Ze+k92MFU;s<`cHfP?rt*2WW4-qBhlBMZO%KZau>h?WsZIvTwXDb
z6J~?hNmCD8wkz{1WKLGxFmSTQ6>VTAF_|E&B$X00SON9@NzX)X4#7nVf!K(rb0_yv
z`G5~Cw+Quh+_Jl;L+Ttc+Y-4ef2b}|TN^&28|f`LiDZt6SEE7^H$3R{CJxls*OO_I
zEYYA2N*LA1*Z9}ygzTlOl(hMDR=MpW9-H!yDAT=aT#|y*01+<G^ayo?%u!9)>Rg44
z-aWy)>iKJM9iNc7goXd|z9Lx+&#pcWT^PNmIQVGdWcnH|s@>}dA(xnPa7&IwRgvcu
z*zQuS@RmCE=t3Rng>cpEjaD@n!0jc4$(Z`BS`?JRg%@zNe6+|xc$5%L_zo2<#>fcj
z0WFI$vZ|HNFC^+v8Kd7(vLdm{iH?pmYsr{Ylm`Vx!@&=1u$<jR@QH@eyBER{S4_M&
z7zCM`kmYc5N#*+sLl#7lxB!csrcg2&uDcxOJa!TK(AaSmNU;*b!g`%yXX~=S%aZFl
zA_q>f!Cyzl0ARB@q38xn7wJd@9TdK>M65W2@893x{V1RIcU!9L+r3@Vn+y~Krw;dB
z-Bsix%RnKyd3799C)yA{R(T=eE#8^Vv&p3RfdTAzdmNosDW(HDk*!ZC;JOC~tC5`P
zy}51CJS4}=O%1VQ^eeJIa6&gJon9NO&C?uy&{kevJ_4QtLN`>IKJ|b6_yE=|02U_x
z>aP&F^`Ni^>}$)EhlahP=QgvXrR%Kh^`(m;VyV4T)amW#>lV{+(SQR!Pou><=vF3@
zAQ|r5^I#o?Bqc85DGTP4fir5L@9Irb$cf_)<L~WLGAAJDYd55sb3qs2QFH_0K>S+4
zxkmyH5)r-+v+uA7o~o9<D7wz8V-)rNsJym#I$TSG4JoA-ImQ?+DTO2WD5x&GH~SA#
z(hISm6(J)IQSYbW7%PI%1nd7-)}i_i1WhH<M38`WWaFF-x^UQRtR=?)Kt_=iO0aH&
z$x{{KqFhM++|GG|V2t~qop_yJOToNmRX`|uDxV!rJf=?i*RPivC*~Xm(O^4M{<knu
z5s@;8vP75!F;i2_r9l8bik-JE)s6#6atMrX8kr!3OC+SyfV@uQDCq?HSI>a{v?|%^
zT~$@pl{-KD1jwQkT^6o2IspEX80v_fh`80GO_w21k`aJeL_%mo0w<R33Bj}|51K83
zQO7(UAP(jClEZ^ND26W4HzCtI0;Gv_#<G4JJrTrc5^#-&ThycV6p~Ed%e$^wvO*H<
zCr>eR-3rXGmd^b7jQ*Z_FE&sgWX8t`%|GRc_W)^f;2czIw#eUll-3DFy&8j$kqClN
zk*Oa)R3^XdGk-%G`%+!mbMOkh+LE@1is}lRcOoVuQlO?~&9|Tf*|cSg&79>G4Cqh7
ztPzcL88sXW<}MagSY}rUN$%9t)Lqqt=Z6`m23r^+xc=eT=M{$ED!})c2NIiMI(jds
zXT#<&PP)&lC+V!3uh=?2GDke3DYzdde^HYQoJ|fQFb1_OAT`{fn>K$4lPM8J)*3*K
zLuM7!J$uplj9Q?%^VB3FE-{3Z6c-;~_~eHx8VFGoJhVHI?|fY#+%3^~StU#q?WJE%
zna8C=a>UBQ#=%j>*^vOd#4}uF<oW0kukdhoj}APaM&PiHI_P$N#bS6<#PaXghH`BL
zVom(fRs6~ZnK+_QJVMgHdNWt{bCd~vM{Uhan~N?0GBLRO%S<33kt?m)F8CRU7s%Co
zIa|@=^aIr>qN%Z;oAK;eSrG1+*X1vKccH~I;n}Ct<qtR&gVo%()L{T0&m8pWYH*V`
zY7Fp9iZD^Mnf5{af1&%^i1NGNISZWg8u!6i;X<biI8+h1Z-(fpFt_>!1+gN>!@qNo
z+~NfYdQm~akNErA<{A4+>gtq<;f_=y9K?&j_Yrs%@^?XNQ-eqQ_oAPN5B<>-mVk~V
znLgR9Sum}ou)~p1rUYN2>~}^6oB29U_FqJ4hK#I2T!Wz4$%RO7-@YX}xB%KxI(U+B
z+tpDJ+S2pSo?nURqp4n;=|`q$LW8>U0zjnaI$P&;h^Gh<b&9kcQuBFQ(67j_o)0vM
zqRV{Ehsb9WYaZC(0%)8VD>=l<dJ&a}3zi9AaKEJ390I}Rr9C_`JspT4u@z?=h><|z
zj04;u7qby(9MiRWcOrTtc=e%PkaYTwr{`GjHojg@!eiYB*p5Q$NThR;R8E*SD8NX<
z3_M62+>ph{9Y*BxGl)|4Nmu_~K%`^3sk86un$u*wYQ=&}5pTKE{`Xfm9{w2wpiuiW
zu|aXG_K(Mx;`zxxMq!HozHMc>{#%fhW%%!e{0^S~LS|(h{!0%3C5QjY$M2NzUo89=
z3;)H!{~Zgru41@wtUorfgbd+f+yul_CkWgz+{)_@S`pKU;Dj(=M^R9VUKnGIXvo3e
z>;@loNRkzt4yaHeVY&@HjxttVv$uPwDaye4oCdMd#WdVNMsdisL2EbfE`sf|pfOl;
zgEhI#i?sMcqn~%;M=|0F2u^SSB@h87Ne(h0xu;MePUU-**vefCezLE*){)C}F^JWf
zkTnd~LIAlMnfOMl^6#tyIsN`GUtBvkc7Z{^#Lowy_#%YEE?5$*i)l1g?(T&#)$@K4
zw3F9xJXI#^OF6(NEG(3~T(Q66Ej#t}=$dcadZ_Dk@>Wy)6u~&>tzj^^M2ZVoUcY`l
z8IRHb_46aS$mk*vF@XypR}Vk}82x$SN(jb<ipd-}&_p0qFb79|_lc2K?Q`dd6_<$S
zxW#Lm_Xe`?<Q8aZMqJ?r?^lSqDqe$J3riM-jQS}=%ZYbagmV$_0T<!6hr0^OL7Ra<
zlgH@C(G?38Q})UXW%^oeMw<_KFCrk5fgJ!MUl0&=Rbs0(zSd2*Hk~?nFhBp`%0MZZ
zZKiC1ZinGcJQn<r<jPszy3O0R1>#0Jb#j|4ZdCvlIRveeO!G;BV)Pu0vh4UWhAT0O
z!K&eoRaG*M1WXJQ%OUKW(f}X4#a1%z>lvKC83co12(Sg^b4^tX^mpkP{tiJ;UC_$?
z;fIj|EY*P95(tu++=3S&O`sasi??x@S>hU~OH3P(KM!H(37p#{Fh7wgRdN*t3>RZC
z9eag`hu6&2ElE~l@R2}ATqev(IBIg8F{VBjK$n06{^dLg<1MQsE0GrU>p_@vni4KU
z$z^i5S)D8{E*B1X@L&r(3y)!zD8UgXa-@;VL6;xnn@<=#+V^fg>KORnl=r}BVpLSL
zxcXJUellFnrgjE%fUbn8iNjs2WHCfUw7@ti|KuNPUOqp6%<(}txpbP)GLRo}xxyKk
z_qt&FAcld97;L=c-Ku3!sJZJ^&nux}L3+tgc3B-lgTvN2-^ZihebtAO<V$Aj6SQ*J
zFo0$C>*pCVHj4YJb_*E1vi`B*)qMWoK<2?7f8%KfcoCZCo0@x;jDtd>n7)MVwAYaT
zQTpAu?9@oMJm|uM<bGa+Ai=p<Qb`P_W#bk-T-E_<p;4ILK1`ji*^Z}Yy+p#>p{|&^
z;}k3#cNJuwJ9myH!Vg>omsK-(2+b}s6kO9mZibS)a6xu0)=k!BZh|#w5%Y*D`UVEO
zRouYR!~oRK_7k)D*v#MCL~gv(1TRo32pQ=uM<UE)`m^wdDPmrz+!fch)<CMjct(x_
zF8jFM;e^}8H#Ma~mWl;WyIaK`^K#%^IJ857+*Rq_5UVu+-J9c<L8q$qle=!g3C6<I
zQQASSy28mM{|!HRX(qX{W@%w|ZECEa94@g?1|Ku~#o)C!(itm;fs%A?m%Hdrr6137
z+eGf6NHq}y>nSH0O|C^v#yD7}-U1jsd4ToVet$0Q+z*xwS<4S6u6EOu2TLG0IFrKU
zBy+HiM^CwyJ<57>t=qZtYsZV%CTXX><_`<j1q+7@c4$n2^rBYjfg74!dxIGb%>9IN
zdknD}OncPV*{*EhEY|OaQMglk(@3w-$?=f%j%T03taA?5J;l^hKZt3rBr_1*b5J}m
zR!%0_hIN}Xdv;4CCYFaW&}Do{?QyWJ8K5EeKRw29#tqd6f2n}X3E1P0`+7uMbrE0k
z;8yVIun$BK6EwMf3zr%s(!0)FwS~zb!cPt_8iT{GWV#J^YgbPF;o=k!xQf_?nyisr
zV?!s%q~yvTxeC=)0lz249^xhq+&8R&aV|yt^>VALL609lM@T4w`^6>Tfn*|u{8LS?
zFhYp<$w}gZ!8a%)>XWUY@1#zxNR1dHjls3AMu@37+?lKheI1(tou((&en{L5{|S9i
zj@)>N8%<xqK^E!=;~^oK@oh+}if^wKI8P!G8%CS6TkN8m#Eh_7Eunvj4|db$&GL9U
zMKaLb^_GZ`1};u>EQ9R@J{@1aFUl(vXFd12f1kx-|MiEM2}7{fK(DBQS1W;J7kHCZ
zI%&KbmZzq!PSH?Pm5RH;x=t=ER)nEP0qa|Xx>kck$LRu-aI>_iD;=%<)q=s<BF#dv
ziw$P>As)@P34Bf>wi6mt-^8}5_Ag^!jlgCS@{cIGv#FO^8&?G!v`$aDX6ME~7g--R
zUNSje-YYWQnbA5ZWZNn5);>?LGB-AX`rJ8Tj2Z>xdgC&vFOT-ef{cuTAtw&jq%f{6
zC-&*Ec0IH9det~wH2cwiRY0s(A-T)=FKYPGORpXJu!E{pI}i!bT(uiF9#PWqKlhXC
z$5rLL%l*n2e<cHR!F$%jrp0#n@OjMspthK3WnYHQGPYU(;##Q{Zh-}VsE9MBWQ(gb
z#7hOC6~$mMRcU}slO%sdmNT84!C&OqLkVgy#c=`G@x84!hhJ5HHf2u+1ke}|>Pof@
z7_=!Btjo(_>A%Kv;)DX&cJ_!(lyATeNBYU(4mEL1C8!7wU!Z8~we09!VvX5Fts`K)
z0Fp8Wk?h`+=tB{kBvMBI3Z{${4%`Em7T=Gnt_qSD;S06sAMGeg-^^}MAu%jOFIl;g
zWFLvp34{w;9o@WPL(*U)en|bo`?E+v9Omm1-Tv<Hr91kDKUowP$j~<Tgb7WbvdZb~
zHO`GqWYw^Z-;T+>Yr47!L)_3Rhe?;>7*{ZWoYtRBZgqKDd-0?;`;7n1zJ^0N`_UB`
z<u|fpCL*BV#x0B%2q4HH@}zNOVYr8riyNQJnKZ2HEo`8g2;DBA3%3_0apVo9Hg1Y@
zgGUSBPVPt14|=yc4yMYl2F)15RH-H2{c>BROAfdF^N_8^g=<qy)uk5CV5%Z+WMm`}
z%qC*&a;RWU@<M}G6S*eMpxL<9IeTetV3wX8>x@fKw$gI1`~wxV%3$7GXzYH(L(I~s
z{qL1V)#W+C>olDw?80yLpaq_<fJ}0$S9zw4@T4E1tDha$b(i;Mkocmha@<M8s&4fE
zw0GTKP1t*sqqTiSs|Ra~2#5!*I2fg^^f3ah4Px~u%YY+*fKWxDgdsA*cowCCq$0)z
zh#)8{K`YAu`dS4fBH$rKN)TnsN+kr!e)khRr+xoJe`V&oKJ(uDv3pkBs@>}zGWx1!
zqUl^<OVPC|f`zI|=b~m57aeLRKgi7tEKTpIne`8e_6oWdJ|dOXD3UUT6N1WYe@W3V
z&~q>l!^O@n7{J!--soldAmCBiqekD5(dn1DDq@z<6F3crB-JlDA)jR>cei8fpmh&H
zjeX@OI5EN0P68S2Beiqr8tmuy&Y0sOfynB1a0Y?QV~}CHU~~Ns^_k$lwX!3@5ftOU
zO?`iL0D$!xU^$q~e7{OFXu)H62b463dz*jl^5r9CM-C(IJ0>{aJgcCf4iE*CDMP}I
z!(DDiyi01nJ!Zg@@}n+pbgZ(QvgVAImhm@_+1jU=&O&~}Ecn>AN&l{u4B+-5yYMxW
zNjN2qFAo3I-K;5(Ky#CnZwOVb)%MQKv!YMw@*+YQIWFqA7)-QG3AWr4W;h@%`#ElU
z>Pk6ay;p;+AKsA(dvi?(UpK3-O&AWeO`Fm#a}7`gcI1v}x3!~Qe|I_@h3`eb)rSk}
z{@Th-f-voc(Mb<W`d9~f<!+nNfxWGt=OQYOivwf5_dsL?@z*g9ph@6zfJAWixdH*8
zre@0NU|u)Mz=IDyJm}3fPdoaJXrP+`b8_MPP&Cw-%!g2$LNFRXD0Il$0V`rMRqPBt
zJ?SpJyKJ>SAsXP)%ew1+$gDnV?>%n&wUiO*%;{QLhutQA+Q%56fG2$cXR$xB;wVh)
z2)-;Ph>>Q9`;#=DG}t1!YUuc=#o$v*DaW#+Sca(nOdN@PAz;+-6H5Z0I|_}S9v@O#
zP>trDg2>$|ZIzi*<}&ByLUx%h`V86C?)<gzq$O>Q@{@U`^50jgoY}lUUysI_fVYR0
z0_W%zie`#+SG#&cMpuO$U|xIq2nbx6HyYG?J8ILenN;#cMuVEr0-@*4{sTmrTB4z$
zy+Eoe;2fZ1*PB$S&G54*DCJr4GOPP=xeeivNTk%7gg_9T5E4w|-~Q<l5E7=ALMX5f
zB)Roet61E_Z;_u9C7ynEukBHc-qV}ZZc*d()#c>%6zaLTu^*qWF3(i1klm<Uq1G+O
zXip=oOQZKa=Y|=qE9k4}?ssrDcc#OEvEfGn(A-mD_wjn!hiuIMD9UwP?v{?;rZuw*
z!3v)jpq`!1OBZcL*x3b~&IL3_YC$Qc7BL+J!Ckyk-y%_5p54bO-bD7)%c(M61&K2f
zPNEJnX}}YFbQB>s$*z=01LCPs^X^iu4R}Y-e5A#f7&>JGCpHwc7C?^GR{r8HR7%a7
z5`XS3y!m!vYv&gxsr*@Btev_x?PXuF`M~tcV`gre3!@GHRhV)R08ZTznOhTe3im}q
zZbnV*NJDxI)P=i5d&``FChG2#HNW_9jm-6ZP?^<?jD%aQJh&A{t*#7pc6x>|LLN`u
z*pE<$=0}WV6r6-8*>-fduo;wR5|p|q%7&+DyLq^?zVnIa7a&`i9DBZos0VY?y;g*0
zBH9Kdr5@vo6E5iKs{cE+d-A4<QNYjeG2hrBwZ){1z*~&(>fCL{P7ezQ(kyzE57xL}
z`C!p|TcLK2<S@2xkAt|FnHPJQRvi}UFJU)L&}sg6msGn62pbJBwBq8Z=PqEEd4%fA
z-c5k#hT2!dg4WUjfk?l7XbuUHf%r>5DJV6OgJp&HA07iJ3cTBHpoH)0i^jIzK+JA3
z08hK(d3GN4vw^i3Xa+vh!er?If`?3uBewAsbk^EFG7XcS*w4|4T5Xfqh}h*Z#wvKh
zN0{iK%PM-3#yEiA_4)Dh-i*AzU0Pax5W;CJ|EjoL)3P;S=4^|+)Mu&r9jl-ym+>xR
zasYWed*>oq-|W-H&!FgV=;ec$MZb;9<)2%aI0pu`YBQ`#eGK~}e3z))Tk{~`D~NiN
z92co8(c}?07{m5XT&g5=9+Bfi(9$=uWagBn-%o(cIx?AvX!TIG;8#PP%YEXLG(6FG
z;2~KvNHKQ+YeZDukze$5fwew5(apz#Tgz_`1AVc?@3tJ)y#@jgxDbfKOQfYEVT8RT
zDc0p$T7!2hg%y7kD)QLPFC4D}V4)P3c80I~Ks@I=)S5B5A%Pyq>rW$X#*`a}{`nD1
zT!9W>)`R%Y^82bcp?^Q4cz*7U$j9&UUoYaj6x%vtsCJ*Yg!Hd_^|#Hi!fr9{r{O=>
zBn~dKacfTHxaue9@j`6`7quAM+Bm!1<1?qiahIuytE-FAC45}VeG(bC2&Bd@cvE^F
zp<x2T6v1sqD0cJFj~RO}0+E7%g9zyeB>2QX-4Zr>SlkIA4k);jUd7cRQesjDXvt`O
zJB>>NdG}tO(xeoD(l`ms0|F0Xc%pZ@S8|_j-weHW1yK92<-6JdJ?)3dvq$uXWCR*A
z8PG40OJ)$p7z6{*d<#}48)iKF)Kcx-$QgxmZ~-av_v4rA?nGc%z@p(y3!r$6{8NDe
z*_4$$3C?uEYB2eJ0*0N1&x*dW;<+a;2Y)CRE!P~Va<aIPu;yDrbl5M)nFa+^q10go
zife?J%jL3Q$dExG7|p>bkXvYH=K$2OQOzFklVS@DvbsU;nbdnFfRiZDV9$jtOT?4_
zDWDTqU2;0^)?XQ=BTv(2+}55HnJCrM)m3FzYj+yuuPB-u8v1q6coi7C9v&Y0)eU%g
z`Ls}IOy{B=lSfRxofVXrysqZ8aOzV`9cgAs>|*ubr8;jTfWL>YVTK}%YA{eN(>A-I
zoIn8`ej16P0AMT!Br<U)uKGm3*=MI0o2O}UxyDoX{A8hz8o9&$Wv<UFx0u^%b9b}3
zyI$oUU8H93S(R{mG#t>!V4!;T_tYTSyZU|NAlmE=a-pc+Akj~>7Uh9n5BK`KmS$tX
zC^lNtjEOsJO}mf00g1~6#Wl8g3k0UbvF8ooPgtnzgvTiKc3rsvey?gim~7ri(X8{r
zkODfvzUddf0LG66PMjn@PqaY)T$E87+|ObyPh?h-l__csgwu86Zt?xSNm)qP`_d9B
z)OHjSchAuWZi%wzt~hSrU&G1#Cb~QEjXF!Ub#B|_r-2D);wa~XqD4@QVxHu>Y2CVq
zpH%Z2IpLw9`x4*JO5TLhqT_sEReStmvdYef(-Tb^z3{u)AC<~7Gc##)&IO0!_Vg>4
ze;w1ZO)Rgx#C0hdFYid;4(FEn)z5EXT}bzqSY%`)wG^`)Yy-jj7UXy~W{oZ`Ou0Rj
zn4+VV8XwCLdJD}d1xu#!IARC8=nF|n8Ki^_GGZnQi0LqQgFZqiCH3E*n-L=JOs5$b
zh$4~by7ZIo1)hMxok$p33A}LuMja8l;~sP%Ns(z4bgU$LLV*E(ibX_HGX$5lPoC^S
zEzbvLx1V%UP!J(fx08`zcu64{_%66A{i*dRnn0a~$wjy^VW=WM^SNQ+NeFXLl?EJg
z`YS*xIDLHx$E-|>3F(Y8G7BHeC%nlXaEMu`)){#I2^53xnA;v5YZv4NenIaSvKg}(
zJKU$*59@5>HI~Ct=9Anv0d~O7%>(<f3CL&(aQ4@++s=K`;Ho#CK~g{~_8>uwE#Bxc
z8_^}`yuR*O$hWG6%qOX~slkQ=nA0|i<e3F_8Yv0`=d=eLHWnhNeoVD;+|d$w(&zZn
z)<6r>kx7r9V1{r-uq)>`%Mb~><h%AOsW%fX^aSO~G^5B1F2)DuYZJ<Mgm=Qx<q(q`
z!xu<yXG7NPOwd02p%Wd_4tU=HWDJHME6T4_45!;|NKSGspOxuQE%)FX)LC}I^&CQd
zm}pS8%idG5tDT2$q_055)-{F~d+O8<6bnH3Lm_u~)p8Y;Me}l(J1!IXo+__k7nV%?
ziK2twgmpCx@|TI2bkM5Ac|<#Sqwee=V4F_h`-gy*A?On%ozL7o+PvEv<EH8@<Pbi}
zcM&-u3VQvjae>O3Ul=4U9PO|k^hBb);-ohFr&6sGQorj!?>M`5p~?djC43}3xxY<R
zLa3T&Fe5pT6(lGm(kFr#CL;&f4y-1m`&6Ri-fD)ad=)5NIIqO}PcMb8fyzGsocV3|
j2Y{p8hra=Eiss(48?9d4{>hRG`qsDByP1Nm2mkXwJUa=T

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/command.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/command.png
new file mode 100644
index 0000000000000000000000000000000000000000..e0dbe241d4c0de3b831ddf0d4fdf061a22e5e53b
GIT binary patch
literal 31663
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
W{vcAgUsOW3y4~zER_2!7U;Ya>ob~Yl

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/common.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/common.png
new file mode 100644
index 0000000000000000000000000000000000000000..04b046bcb1f19329ddb0f20c70ea2b634781ce4d
GIT binary patch
literal 31610
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
FzXM*%6ORA@

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/component.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/component.png
new file mode 100644
index 0000000000000000000000000000000000000000..436f7d59503dbcb63c810cd141463cab0b35bcd9
GIT binary patch
literal 31976
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/consts.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/consts.png
new file mode 100644
index 0000000000000000000000000000000000000000..a95c7fc042f7a65d83fea0a845f3661bffe55abf
GIT binary patch
literal 30061
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
RZ6Q6cgWVyf$mS1m{{e2Ws~G?Q

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/docs.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/docs.png
new file mode 100644
index 0000000000000000000000000000000000000000..15883f37f6de356123ed0ceb520cd8493bc65c59
GIT binary patch
literal 30012
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/folders.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/folders.png
new file mode 100644
index 0000000000000000000000000000000000000000..691a74e1ed0ffa8cc5acbc18ec92de511db4e9c2
GIT binary patch
literal 30099
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
YB0T%GM3DYZ9r4x0$&FFHV}JU80C02OXaE2J

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/headers.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/headers.png
new file mode 100644
index 0000000000000000000000000000000000000000..41a9a6b5a3b37d61d329d45c032b0a093a830c9c
GIT binary patch
literal 30147
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
ZY4$DkySJ0dMdZ(a@9ODNxHkBQe*+p~tJ?qo

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/jinja.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/jinja.png
new file mode 100644
index 0000000000000000000000000000000000000000..012a2804662bb38ee056309aa5f47fdf4cd31260
GIT binary patch
literal 30234
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/prof.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/prof.png
new file mode 100644
index 0000000000000000000000000000000000000000..3fd34d0548ddb2c86885e5f089fa390dcecfa3ff
GIT binary patch
literal 30253
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/ssp.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/ssp.png
new file mode 100644
index 0000000000000000000000000000000000000000..056f765f1a44a975265db44ec8ff6ce7705b31fc
GIT binary patch
literal 30267
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
bnKv5aVt4+`_d?a8rM1~<yQB0&|G57Eg(n>`

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/author/versioning/template_versioning.png b/latest/assets/images/social/reference/API/trestle/core/commands/author/versioning/template_versioning.png
new file mode 100644
index 0000000000000000000000000000000000000000..70b81fe8cadb150a919b41ecc616c512f1bf23a2
GIT binary patch
literal 34039
zcmeFZ`CpG~_&u7Lly+n&6p>0LN~JWQOhxmk2`MyBnl!LcL_(7^DJ7bvdN&uLxim?$
zG|%%qopopL&-s4N`2)`RVSDY@-ge%e_w(G(bzj%I)>_y7NM80VEj1H06%`fj`Eyc=
zR8*@IsHj%jtY3?t$ep;YMMZT#`@GaiWxK%sCR;n@n#ti2AK8oRgTAj>6Fzld<@VL#
zR%^bTQc#F_m_^}Q@5|-z_3z7}9H&3YEB|$~k~Qm`+jp58Jy|hRbk6=lR}5YVEAg=x
zPK}B7*;{w^XVunOO<pnRC}CuwS6G2B#IFlQwGA8o{Fcf-^v;?;zg2qk-|zlg11hTj
z-><>gl+DWJkbP~wo|^i_ojX(`V`E$BpO=(eI4>vXS6!{ld)+nc>B?=(A4(|9&p%tA
zbaUTs5$k6^Vl`#*Txr?3xi1v?@^G=Tj*N_04mJu4J5DDUw`6NCF3y?NWjkfOi}K??
ztI)QOb(hNWMRHk>9#vjT$IMM9I(+A-NxgEB4_B9b#><yG>N0HO9p?rpiPk-ekDflA
zG!EksOkKC_0y`_~DP;jQ8fMX-ohcDAe!i-)m(Dk(-`Xg6KG);Pt}$HpP9*Ja5oP?G
zt;KmR*1D(iYwK^Hhv(8PJK853%>0IOmUI@U+vw8z;xa`2INY~VtFOK9>RR;1Q~aQe
zFZXjVb~)**SHr@?!wVj4+}@6l`+7<&s;Aow^bQ<->>=(nThLP#sh|IJ_hv>$&SF1a
zzueptW|1o46GJU6QQv<XI*wPIZEofv56G(c;p%CBai?@{^@J0bD5e9JE++L!&vD%%
zKV4_etp}COC0#knI4%q4mY2)vIM3({+mD7j&UE<kng2TRUOOYj`=E;S-+%udZdeml
z8K-^RzSIBuH9T&j)0_>3+os*5v&3I9+tI#wX{xVQj@fzo3a`Ox^34yFvK%I^RfL@$
zE!gMzFg|`xdQEnA_GtGT&!TdPCGLsd8Y|5l4rh+b9d9o9^Cen#Nc)T0C$3(%?s)av
zTYWzg^^3RJ4}V%G7N|X<5+=1_!^Vvt9Rjzomb}KN1>*&|6vFOPlvd%3Vy<nEH_chF
z@${&O)fCc5x<MaO_v<LNy8ZCjm=~Lj?>SFqF&YZ(`t{Ek`3=ljcG8_cfBt!_CgqaY
zVy&)={obAAZaD&r{CIg=oTh?~nl(4J=?R!MYh^D?HfXhkuh`WwG_bm)zr#=0*JYtk
zSJm_E*|WuXBODpFL%!kR``@d^z8deZQ*xLZ<PjGa_Z@I_a?+n2?@2Um5_$CK5od16
zW4GIbX=k&ie{W11NNLzFB64YQDrf1uon0!W>R=@+D{K4H<AVuv^Ln0Q2bS<hR$?hw
zUi%Iowf+?0TfN>5qvSz<9b;i(A&Z2Fipc$ziQCh!3_m|Q-RAi?YTM6L4kqt}rw3J{
zZk#&xcQXgVluIqn_~XT)<}3j=wy#m8$A>c8CKfm^(9_dj5pcV=j&9OHM{04TkUc~_
z%Z5ueX4pYz&2If7?+>rmsnl#{lm6KltQWjz{onX!_)O!iTJ2Z<{x`?6qS^JYUF&|f
zS28nuNvf4P`_zs6JUR((Y=yE3bw|fc8m6P?4r!-f`&f#-gv)WNdbYSMEif0-lZB?b
ze*gac0;Bk>&L2Bdju(-jyFDP_HpEZ+(43AtV=%3YIXd5<<mFxk1qJ(*xy8AmSmunL
zw*l>M156VezTxw(bS#H9ZsUH|mhUN}sQ7|xle&-B^}o7r9i1O5m$`A{UDITW>5eR$
zflI|!yqUv)8`meDKct(@&B@7WIof{S|F~^jl39zmnnbc;&5Nn#+j5hGO<YHg9C;BK
z$o>5Jb3UUV+&3%29^~oq>Sk+6Nv++qiz8=#^l_ksi;kj_Qb%QkOrk~G8GGDnjQhQ^
zhYuenFddJ-{ZzoTQN7urkEbrv{$rr9)fs%2?a(3FO)TQvR-Gl!ofl?1>_<(1CWO}5
zjdhi8r+;3bY*f6C#c>Y_qwek-=PzFL`FOp&=<|b(yR&yu@RCQrY>_J%?I`Z3ey{Yx
z+k5|p4I9XgCl8-7l&v{GKffzDgrtKQjgRdG&-cA}`I4isu+VaL{H8{VvHz2uLS@QA
z43t~DOqw$_q~ex1P9fs7vK=+9UcK60B`1;G;CXyf`0!zQvg$K4T_J3Ie2SYlZ|2S)
zdV4XT9dFg!p!8Lp@f<en!zgLI+tMyCFE5_C+DJK;bp{8_9`pzR>fA}AVdRs#lw#bI
zJfcZ4<+-<(cC>z)BQVpM@nu~Y@`fO<6$#eehAg{xo7C8Re|=JrVp19Yh*{L`aElCg
z+wb4j^V1`Oa|si-BAPO6jodcv#(w%}Gj~BwuJ$amz0_%`p^PDM4^K}@hKYf}+oyQ2
z&<}LGMZ%FT3$0vagG3^DG*gn&B%V446;%uzRDSmwA(v&KuixSC71is@qd88($6pO4
zA~r=g+0f@Hi$rs$+F2`yo(R8DQ3KaayQ2_rGo2KdC1;Z#F&e>64<0<|ai!fkI?y-X
zQ&pdJ+m;fy`+Cl)8-2&>b6j#Jk!lT1U1mDAdk$EU`^EClOumT{u^rT+-L$E!W--KN
z(c)cflp$Ua4NI|soyP{Uk@h_N%(A$+nC`sb;MS7iP?UbFue!Xvyl?Cz!>eJ3m2V&G
zWI5DnX$d*2CvU%d_wJ=IsYhB@j1)HQIDBHumMyeA!^mOk6MB7lE?QcF-@bnBXwbcM
z=~eb@Z}cXoA>n=dBsKAHLqDIUTXwkrh}Uf~bZOMcjgk-jd$8_fzPwJPT*wc+5Dky(
z(RX}&eLLktG&D49Hole<p9z=znr!^x!-x7zd#eB^Yz=8%oy=}?-S_X`*T?HhP-1u6
zZc9Mm7;n4hvN&_yv)`(#EQmHffA?{l8}Ah(xSbfJRunhHA36EgYW$-x{pMnT;3g-X
z@uZ(W)uYQ_uD-%MO&v;mtGD`t1NVUgXMX?wy~{Af*Y^N+Wg06#KYy(t*^a_io#${h
znhrsmes%kiuiM9(;*9GO6;q7s94Q--!_Rvi5FXFEE+HXdzc|yiyQqpDHS8I0&U~fG
zLLHypH<|$5sdV$!zx(Txi#v@jeKfc@^Xnenu3m{fdvZeu9335vvrV<rt)JtG_t(a&
zb+R8jrruc|!n?Sb<|37ZO_ylidJ1>op69e??b;%QVT8j(?<NW-$KJhr72~voqx1Rs
z__&t_;+!T?Uyyk;WAjr}k7;B(rg2|NI`?#!@YNc%Xw}&E0ZL2C{1RgC8fqP>1p#{T
z+8L^<@j5)wYVp2E&c_0+Qo<&gklS;Qi`evcfA2aiw{g=Z->18eI~=EFVAY8a^XCb6
zS+tKX8h)=7*(mZ288!CXxeFJnYjtj43=lASE7aonvHA8;mcw|rLO_E`yiQZ4Usm*M
zMMcGNeE$!?BBQFe7jIR+Q?PfAFh^0Uf3L)zHSt69R`>T%!5rzWyLSf}N%VUJ1qQ~L
z<t(J67}d(|JbL3bHcFMG+orn46qAOOv{~!gt?J~}+3Q#R{Ge9@;B`7qmuIR}s72kx
z>(#3${bJuzf#6uKgv6-{{IHsQuh)T#)?XgdJ4_E>320cedUbm*i5S&}(`U}~W=%Cm
zPxRH+ZrUx<ozLPD!^p^}+Ca-9E~=&*;xy@BBZwb}Sp1g4R`eG{Ud?~Ps5iD_db~=m
z$x<t0j5=ngzAoD|5>%>FNXD%`gNb>GrTI6Zp`pGec*WMJimDCTX_j9tMLQ@Gaf{TU
zj5>PD+i!iCxtph_XW1)(;?6l0v+2Q%p_pd5E%$?#Hy>8D)KCEtU1G8zWb~t?^YcJW
zv|mk%&q0;Ssz^CalR4lw&6E#QSL%MO`<3l9SKl~!k4`+HK1C&3Rge;^@a9am-qb)t
zZD%&BMYCbUP6_pl=sN<&KMzNDQOsIQYvla-^o@1IZ?~x}8gEVD<L95yU7Gb%3GrYO
zNYoHDLUqs&K=D);W7)nvQo!hkb@$6a0VCgz8I%DdOUuL>!7T?aB=km`Hl@Gv_P!=C
z=<!wH`sb!KF<-t&IblO219kTH^+h9h_{NW>TZI568r770b1KEmaso01AGejozJAGd
zP&KCe`(mnME?=?Hh2<@Kl3@_2J8@>QN>k9RIp*ZalR6>WKhJ+sTc4HtgSTU0B%fsz
z?@C?Fd1h4K|CmKsO`D`EO`&bzRxVX_u}NU5y2eSDrMZwAz2mln-uLgXj?M=-4H^1r
z^dshjLqDEi6xYxcYYvrkbDXpKCMU75A9yJ(44Fc;fo=c(pYsmt5z;=RyZ4ER)OTj1
zJjfr?O1(T`_kemU_mWfoZd-M+CA{<kfBx$+%#;b0;=mkZ`>r6{OAEgn3%%G)vg6og
z1D^r&wL8QhYv?Sj*?gP81s13A=Yir*ml6{b_w(?SjwZ|54q9Ef@I)m5Tc@_SR!B)v
zF&x`m5h+NkwWM~1$HA!hBLFMZswYm|x&PpS{c+mI2?>YY%u4_M?Xl9AHpN{KD{R`=
zqDtQ})#5_QSO6-BWj3mQ_q;~z*{<i$p6x;2RQ2r2jF*>Hi`PkZh`Cny!Zp9tAo|^p
zR13YxIjilO@oCZQ6<8rnF<+}eU~`j+`OeY+lgV2H^#V7)zrK6au)1LLzOzr0L|Xv7
zqXk{&N8GOI>(})UeGipX^#nw1>`ZA+a+om8C{MEr!PoErZl(oCYkYi*^e1D}|8uWW
zq^u9HC%alj!t1RywL9=kYl=~D7^ZTHw(Z)*?d<H_EW7H#oe}DDM=tjnKH<|ZN{w~V
z6jBm*7=PC^fKcJUH5JpXZx-vVSg}G8`Bd2A_x*-ZOYi49pSBdJW|I~Oof;Z6TeetH
zl_=%&iwi?8G63D}KQzsJP;JiFCF*Bg>Y?0vP&+f$HDGGickqKTRyxt4|M^*F{A2&6
z)zMOCx9W~mtB^Nu-sl4ij4r2^swfq%n>A5B9ZR0Oj~^f?s$6{TLfD%(K?RM%Uq=Y|
zpt@tMbyr_fS=qZr5BuMg>uS@qz#jSrHL4Epz`%Za2?M_uFRqSR*lt^IH99fjLuql=
zlnoZ;)ODKhq1h>Tfl0`eyQA1|YF0l=c;kyYW9{8t#=2+LtXr4Sc=n{_l(-98Kt9Lm
zVaJ?J>N(C%B-+~B3%y8p<Y#5BY~knu?&X)WzrX)x7M7ubqueNL`}z5+8g9P+>-8P|
zyvczE6Y;@rwI(12UUs?QlC5I5CzC{3cJ4H)IgoSJJ9eeqWY(R=Pd?F6PZHGLrH}M!
z4)WceG`8=HrGzWLR}>79lacX4>#LyR`6Oh!=F*MTYt{(Yr~&y#_dJX@YZcjTcQwRi
zwuc=R;^`9>2_3W({mx=??G8t7jQsv8IHcdX;m=atnTv>w?3yX{{M%-6-rm!B=epDD
zboVB;qNrH*|2*<uH^(_He<*WIc4lrUXUtd=kDG={5z8!LI~drJ!wXD5;fU66U{d4F
z8QSQTeo^(A5<Yb`(Q4(rACP~}%g9*GsV~e<c+CxF@Yd=9T8y^3u@p6?Spis9Dl({3
zOoOZk>T3ps+rR$s5wD3-v5Ml=%&&eWU~~=tvuWxBn!d<yliTD5tk3{EPS#x?t-Bs_
z9*uK20vTIudrwPF&e5Bd`)gAWxuc)fu`m>rRy=MqqCq4~$zY}O+~{QHCI_;D+#hP?
z*haI9(}i`1-qFv`v>$8t5Na-%_(|GqBm{+E-Km}Y22X1A0Q}Mhb;q%fi(j9-XK7MJ
zG1HytjgB{-tczCTjm}4VU^LZdXYk|AS-R+aBv}^ECjwW$tdGtYpY7gfk6u}fFIeHY
zP5(23@f~8E<|g?71EWn=tz3C+urV#o)YNW%+QJ@CliNvbemF0!o;1~OFZlnyTT=Qd
zXs$8gN}kqI$cq=O2oP^@4>PFU?TAz_H68oYgV}SYGgwE<tW7+ZlAb+#_E&(KYP!<D
zkr#EaA;rWCmB;@0R{FF>S`IVEeQO`kwXlECL%CPYDN&1%-l~ys`EHZ0ad!hHK6Ci<
zMpaK<^@KgOwhkr>zb`K>E<^yft9rWqY0L~J>~wN2b<^0oJUHB?cHrX!{8&j&On+kf
zo5#*35t|f|TfORHDSG*vqVrK~!?n^ZnG5&wro;uNEiKL=e;-u!q}z2&o+Mt|rdxh&
zOh<2AwqL~Ke4I_!1Xku=b4U}6LVJyx?!?c9e9_XNxlFXX!gj;2*|1%%k1^jQEzYWS
zn^0@oj0}cYE~}Y_>Fm<g!%MdN21M29Aj5S1>$h*xQd0LRRVVg_-5+>)^yZ6t%gKI?
zAU=I}fG|ZjI+i%p%I~0HE`Cf*j7jl${J4r>--#@PQl@B=wzjs3uiJI2HO;bA`l{c*
zA-6i%lG9?C;qA>p3$|fg<?RK=0DE5!h0mSN5#izLCIKIF0xi%%Mw=YB?tV7(6TQ}K
zXMmaESZ67zyAH?=y>Z$Z#-<HPH><St&PYkAoABEWUyg1ZZ5SkF!oeA#c`05;tXL5J
zN;L}A&k`eGq_l6O^4AEe#c6%GJ>TD))nGUmEOxuI-e4Iq?GkrX$GSxUfmNU(>v_zZ
z{SN$=YJ(WKm9$xGAK%giumBR)1<&^SwngdXKb;*d=GD|`0LC%`m~Bin5T9w^5<Q|8
zqyF6N_?!HMjHwy&LVDZ!;&W1%a<nsSRQuR@crMEL9WwFJL`$I(f_Lz}!7NAn_^sY>
zTt~>UB%oE`z%m`MhuUR&Zmw^3qR%9o!hNpqN30S6d3^agg&UvyHoO#ExpJj7qVf<=
z0phZ*KjUWATcDM8<q+U>%ed?k^<2y9-(MfcezR6v(TBd1a(ob3L;yW_c_Xvkue(}p
z_F;Ewz~+<|6cq5&X`)**otRaPR=rprEM}C-t5O5Fr?jxJpsmBdMmyKCRvd46Kyc%C
zzeC!Uz@k0qzsKWq7AwIVMw>X#kDLuit2-#$IX>GLzf-)kbeL%iX;M!9b$Z_!Pv(K@
zIcZxaVaxE^uDcwfz&m5lf`bo%y|V0m@eNmClyJ^02^MSU9K+l5s(5pDXSPNY8iS67
zsTQF?IcMr#we?nL`~pR1+P#?jmWp|EyzvU^9OE2kMr~aD4+ne{QWm<3%sJX<Rn9nD
zW@~MoM6=^?ZZGqV?T55T)+qe?csp&^2bA*Y_>ygF2kX0X7H5k)Yc;u4qV_M$P5B`s
z>!w@xT%F)@CJ<-CmIFWgUCIK5U9F1b{>cQ4t*xzsW*-#gQ_NZpp)npo5AFzh4PfdL
z+Jn7ASyRDzLKj=IZc`d<8caxL?MQ1PAWY0*{Mnnco}CTXk##fYM~nIJ`BN76GK8A#
z@_L=cgm(*DN-a*ryV#F+X`&5{IP1xrXjB^~N@>8w=0Rm8J7fX@2TSw#;d;tvp6s|X
zrq*f7Ku^Dy(qt1*I(PWdLoC=?a0HyizC2bp`oVD)A?sZmZ7+1S6x?DvFxC~~vYamP
z>b`|KW0M~M4o{j(2ROXAI6o%mHp>@wEc+W$fO!sDO8=ub731avwtM3R5irU*nD^lG
z*FL|yTYcAW+*mczmfr{BG%nwhrFMGS?&A6L6&tr7x`BLwXvhciqL#NXJ2TVskbd7d
zKyA`^0J<1#wkpJ7pA2tSxDS_FN<;H*-Muk7S?Q%FK?~GZ9&KhzI{kQ?2>2l}r`e>p
zZ{POfQ`TseM4adCXn~zGBnD@xuh^_!y}G-*;>`rMeC@k;92dc2V6}R%T_!5dveW=A
znE=$N=z`Bl8#HNu6#rM}6BM^T?BF=y!CJH$MyT&-?|T51twBeS4t!!_;?{JkA($y=
z@S?N0xDim#+lYvsWTV>g+`Fqp02_7-8mnjPR`4^eS=f3?uHOoqe;gcIEePM<);u=>
zblz2!mE$P+O!V}jD5^DR@I<^lb8>Q!A-vLWRvqwo^r&Kd+&ar~CegGpRRJ+?G_5X}
z_di`i(D2Ae1!=fDZ(GRCf^tJUnBO-i#}GF>le0t>sED-r2vm(jCLr%7-46t$Q4K!@
z{Kv+aXGPk%efJ3k{qPI|ho_>VVhta&`=;zu>&fR%93kkJ5Wo7^>dY)gQ-e*T-zDi3
zGXGZMxV$WL$v@dG;jA^7-gihN$2lwin|g*#EMX@>jrDvuBA=v?yDTESep!6zs?$V`
zn*HJ)KLy~kQ4qLAK+c>xpV%0n)8W@0tt<x>=G*;87zK@ALMCYHSj2K1K;!F!pwL1t
z?{uY62(;K@n|ePWm2j{pDwMzhFdj31Ejs<{US*61{{~vxTko{7qe*~+GS(#2+m|n2
z>;x4Ub}}UV+DxrZzUp!a+D>mCO;wc4{ajo!$||H8;pbOE56HG}UtR-eXEZ{+GTZ6)
z&8GC^qsBkwKY#wbfB$|dDXFV^dK~~!mguC3hB1%4lZf)mdmT-tiwn_6kbOrcCbohf
zCjU|KLC7maC|?!)=Q)R;{rYve4zv}yffrt0Yytu*;Q96o3aSE3ci`1*-nx~ot31T-
z@pj%Kfb@>}nK42mDs7{nQt#ih=Y*qEe9LnV+<0YG75;invA+hPV^DjfL2pD{N;X9E
zqym=S3k>u*pn&}lR!*Hd6%I;85&S);Mq>Dv{Ct_VZysPp%Nlyx)-E>7l9i#l6IKL5
zfqWJ{n{Tx5=nL(}bccy3sWWGa%7Ts)p~DjRN!VpEv(zk?Ask>>X<Iard9GZ!VmVeS
zBm=r79BE$>m6cOBJJXv>O;+0P(15%|otoY!$JCV@m%oP&`|UYGURXJ^NXFPWroSae
z7kGm`K+xm`?M}ghG^?)tVq#4f{kI(=txlH1tu(Nf5nwGUlWr;zDBQ$Xj=koK^dqEC
zZTpYFddDp_`p&I4;DGAVZ$-zbe>f#*QokRF$|oj<oAUIEAdqThiisvj`^V#hO`7#7
zCS0FBeKOsBZ>6vOKf#(SDXNlN#7XF4W>F3#@<hiOO9F_l85lSiXa3zjG{g&v;Kky?
zT=B0@_ad(3xtj7`>Hy=G`OmKSwRepIu5jdt!jCv@F626IEXer_7cSg=(r1dsi0^VP
z6{EOgs&(Iw($?GRY3~2$ms6+T@u@;#(?>-i{1;R+^ShoyPr!c`4Y%g$gIre3ab8%-
z67qlktxS#FBAb!lr#H~i`9Y8>9&F0U@;$3Vl04qB*U5Wp&jZzG`L0{TJr?#yg1+PS
zGW3oQ51!K*9gDx9$*Y^x8h}FHk--kqAYl*UrYCGf7!oc#`A6krzWR2hY6=$DA1G&j
z$Yse3rPZFzP17{(bg)A&C!>I&_gS+dQ-=TbB_Hni3?PL0OzMx$pyqe<)<m!2GXRZn
ztuYk{&Pz@j{U`Oc3;Q@O`}@UHwk*d7)f!&NhhWphG(e())Be)dMhj+}Fm@ob`1D7p
zJI}0Gj-@+SV{oUV;Lr<^hk2n_-MYOb)MV{d@=8F4Jlf6X%(RBNvm+<|{d^ge3t$Z%
zaHo-tkVAfVb#+;WfC}a_tme?ja!7u{Bv8cT6gK_ON>NF*&(<hH5AX%qA+4_dvT8v&
zUPs%YERge~LFo%%@KoND44VHYvIod6PZ;^n00s&5)F(%`P6BRtfdtnk0OxMMyw*RF
zMy2{n$m|ecp3n7Q`!fJ)qfO%2-oZ|j8XAe$9zg<4qT-XXIQ8egseUqmBw%rw|3D<c
z%}h*&wizUmgA(t^Sz3sPT(|wQE61UKg7A*0*!XwJ#2Xc?@73aiYpehp{ZKIrSJ8?7
zdQc*-CI2TiQ_b`?XJv3hUBP2qvyZ_JBk|tzBQ{`av*d?gklU7D$cfhP30EYc=soXP
zJ3y8Ksl`s1i(%crPn{Q~8hh~ZHlEG&&p}++3GZas{_h{{Wr&mi4!!ozo4w%iPdHKi
z_dD1`{{OQY%<X-}XNNxjU0aknpB41yWu5kkk_I{VE^2yu`XS<adUn=5BqU^dX68|j
z1WR$&UdSAzYNB|ehDxcNR$)USQ?6;~`LvdWzSU<LCFHImy(tRH@4h}RHfir?uV3%s
zRC@aa>f<>`gv#KlqLkmWqJsQex4`ecSBc*Cm1jF>l49(-c2aX&Kd(u%8wn%gUszaJ
zJ1LdBck@6eAz~Y}ix=qHL3Dupk)toZk9|;}kA{xVtXWjj#FtxxmB_3YPT|2$96?zl
zN=&15)x}CeY@y6oN2|%9%#-_UmaXvq-PX2Tc|qparCCK15)ZA<q1rfYFR%j0=HoW*
z=JXx#72($f*1daAqKcE-Otc-+K^lgr2zuaVW9kQDWk5^9O{5MaKN--Nwp%7&0M`kl
zQJJ5p)lCG{tD~5O>^f$C0stc`h)MMRKbz#h_MJPq0))(bO9O<+R%e4o0?5qnG&}wr
z1z9G;X25-(wg94yKDxZbD|u@*(kvs48&WQU{K^d4M!kLw_wp@L`y+ABjFn4tKtc2d
z2Du4>6wV3t*{S7vwi&p^EV6qW*nZ35Unhx%a^KCZ7@(Kq(pIH^wlc>TTy@z6k+Za@
zc|bOh0~(<pz-;lI6{`sQ&@5Zd2^g7ZT*s%8Y91P+NqKr({q8@{a{4rS8j@;!d36sF
zwd4u70YXjCG94YZG2A4KPM%vURUS5meE=F`HX?`V{~$IhhLh-XeDHUah;q*;YL@^-
zRrXTSjn;uAW2}eYg%ELV@{YIj>Wt&>g@!q~2`xXjdm6z}YPwErXsmrc=;arY+8FfW
zD-dNnNGosrw+IUhD0&D+1v_v`r&Vabf~C(45_JFT=}B^x!Oh#Zv$r^od4Mug`R2(o
zR1@D#8ZlD!NUC(4YO*DqW3ra~v40Zl>m83CKlUOVDa;}V(PQ~SY1;PlC#Yc`B6LG-
zJODYUZTp(m!~Z^{B!PXnRh7ZiwoOR#x}xIE1gDdx5PHZ(Fz~-dM&y(J=PMfU<b*l>
z_JnaCdQtP+OGGqx7{5V4G(d3vz``55*MI8$i6egg{>udmbjC6f2x_!L917aC$^N=Z
z5NiHnw^KA{rAAKwQ*a&@OhiYV@nB*@nfHNCe!L0XcGtE3pC8Cq5Od1hW~mSVep>xq
zl;hIER3#WY(hRgtf{O5h&p`<^Nyq=Hdic71V3fSUl1e)`IAk|OVv_^pb3?6u0mg3Y
z30Dr;f65qD0EsyC$3FSYw+Y=mU}}r5gi**eP;{!%3hzbj4r5sAKhH=tIu5eBK-;#7
z4c#WiVGs(LWv#Ytp>2y(*Z-<|m(Zz<54Gq*UNN>e#*3)TadFWADf(~K`^5-K$a}@A
zwFM-!(NPl+%Bh{6^yTZ<^Jw<43X<9A&$ZZ@)dX&QKLOE@Blc4Ai)}oY&OxIhn}JA_
z^z=v--ax5jxptvhN-=FZNKh`Agbbc_*U{rHhXSD!vDD`YfCp`-n0W2{1{xagq@<(g
zWo3QQi53(85gun0+xHxLXX2#d<KxTB+IU*$ig<QrsLen<VP$W&WM@^!>+1IYh~*-3
zEPf^<FaK;mJG%^aUm!FmNc3#CC;N%-hG^dVIXMd(dLARWCqZz8_Q8Wx;|J4$G;ADD
zg1(HtVrOGJ50D-xa!Z<Z-#*d=5KB-Uf)5&qz3sYP^545|{&;pIX75;hs4*VN4<QEB
zuN@9>tVl7{-T)=_1)GdCI%%?e*RF-5SCvQv`KR&W>H~CE#{_)i<Ktlk(IL*A(pLgr
zWHE395u|K%b+N-JWZ6^6Mg$L%iUo~-?m?&V0{w^3Q1aYimr3ZY+NK!;g5bA2NGeCB
zWygDXL7pFQpHwK)ZGnI(3z6W(BY1)QFM!BH^5zSF{~n*r6>@}2B>k)J&LmGJ0clj3
z%)qVg8+pn`Ko;CQDS|(4(wbjbpq;9PQ$))N<*;{)oM<TVE2KDK$7%=XFbNoTbH!(d
z-JTk}Wgw!gG6DL5=%+-Hyqi4<A+eg$>_9}BUhBcAC<_aVS?FjtTC$zcyhqBj++z*f
zcjn3A#_KSMoYi^r+0oH{-$Avw7~ZV$7lWW9duF6%Wq%+zm;Xv_EhTp<6sc{tCo-fL
z+cU7)4IM}Kc3sC%fO+fN&JPAeOPQ|H3g;Oc73eTSCagd(-&9rg4PC^7+=6S5DD#r}
z-#{?Nf&)7oNc;={&XJ}Xk|iNswer}O<3YB~72xxCmI*|n{Gk^!O9oUlEsd885#Q7$
z|JT@Qh9M5rbYD)TZ+-TEeLa{Nd`B(s!q-*To4p&IrkZ>wAx%~zG>$h;f@QRIXpT~e
ze!Dc+vUC)NDD$$(a8Niv%}JIWMa)j6d7nRz2bg77ApR*G!2@V~L@e9SNj~7_-+hm@
zljHK%&bH#63h>h{pn*7w2sRmuh;sOqyJGh-^UHVpB_m~ntkLk8mg=h90{X81pm&zi
zp`l(@6|?upvy7KlXeavX_|;f|uwhiAq-UCe!<`+@qw5M7`dBU=jhAxB)9=}{*Pzgj
zj&<#~Ez#Afz~<6Mv=-af6VK5AT1d^&@H?mfk~%^c&;G0Cu+m7bzYrVREhYL2pyO`v
zqI&NJ?r+#aQ|^b|MQknuW}{Xp2d~73b5}9jXR(0pfRkoQeXtH`Aqrt(6ncE^=}gVs
zgZ=q_LRZo2IY8j`EcJ`(1xK5F^{YE`Va}-s)Noat^6ZR{T8<n*sN$Jd3(IfW-d(6x
zzKnI41Yl23k7*MH=D42*anJ%Q&;exJ;#R3akVNI=NZ_&5I?Gk7V>Fcfcr-gFMa{f@
zd?NS_O1>*bNT+%8uHpWBkGs8{*ot^pfA@7|nVdv4Im*FtZXYWv4aI4+ke#+vrK8Aa
z0xS~0=+lqci?c?wG&I)5eOllcv=c6$yxS2M1+F>#%^8n_%K5J!PEo5rn3*0uvwH2?
z-V%TQjmFt!!D7+KHnx4@jTZU49Tw+jRyMftUoY!6p)_?WmKli4eRNfq4DO5-7>EDr
z9hfm^lo;lp(S6N`DJ}aS*ysqrfe#}F<-w)%X}NVX8Am{Qw)#frJ^2Yl_2a!#eor9h
zW%|_$C3$@t>;y`bMa?@e7D6_hAo{pcn&{+Dy-npx1NF%h(<5!N9&PTBAT#Dyya!n_
zTdV7`)o!qEG{eoq|LIBkA%+C%v5^iB4wQj7O-fvD7nitrv&q!x4v1F<*RC;4i^Brf
zjc5%jYluNg{LARwYdbw!V)7tVC0&2%k{=cse6}Ke1$deslt59D;3&8lN<sv#ck*7(
zoUAu;9a`!*MC?HUrs;+6GymUr52i!_#rwV1XolHI8)Uoq6U`5Qj)BuVcFW3|UI9=J
zj*Ey|%koJ`5!>DM<ime${ImAn915puV>H^5XWYRpqBN%^(aDL9+^-cs`c7x*^(`##
zai0vva<Wn6PjYn&Sa%d{rR#r?3{u(<h6$o2tl`r^hJecAGh_9Ff6Q-px!9D}-S(G$
z0N94+<_WEh|F2tq#I-BU?fkiO4~uguyEZ}Ce5w==A6a(aK(&gBfS8ze1I5g27Wa7>
z_ql)=v73$WetHbTw~|@<X{mK|%>6ZV&2=EWCd!Tv9SzK>`?HlP488)_ssU1|tuukO
zp3GR?t(e(DKLBx!^T)HOUNG1+U2-cP?|FEYSw}86`pVniCr{>ZG74K>%O3k^H}ZRB
zX<;z9p}eW48-VI+**aIsKiykr(rjIQA^-KcPuu>yaJ&8w`I%xW+Xw_~oj1##F#t0=
zV$-_~Sl4w(@@mT1QKN?f?H3<hq4n2><<s^4{lhM@d?GF&mmDC3nMDT4fIX#+-Ak>$
z`Xocw@Ky#*0Bw8mC1NXtf0LRcAaiDVx&Q&k12@Aa3OMx_=&~4@x!BlFZ{t?qBPTZD
zP2f6#hKwTC??mVNKPK9ZT!qrh-x&Gu9H{S(P&a1FC=&(cpPuo5L!sdzcB{-F*RSaL
z_h3nE?QZMp>iSE#WTW%4JItjA>X{va*%n>hu|=hqwf3(BuF)73EKuh$@nxWH5_&5u
z=uD`-^&)X2zX$tX)rKzSJaJ6Vz(1l7MRgQ%NHHXnpg}pQc2o(A_hM8G?BEk~8$g!p
zO|3eG79||T&~^6l!-vn1gc_U{adFq#vG7ds9X`CeI@rtFezOvI*~U%jDk!>NT3U3G
zLHEP&<O8Puc#SSn$TC=u&z?QlVq#Pi#kOiK&0*1R$ch~(%{~A~4UW#e)$ccN+jams
z>=_I}OoL1BBZFUn4(oD=ImUdC#FZ=2MBsyMvz|kmDFDOV4v*)HSFa92KJbMF>X?`=
zd@!TmcAA}o7`wZE5o`Jap)M?-ngYmHjNs@1u-^RFUwhE6R>Gi{21jh*;71VEqbMMn
zu`(YMY)voIGUhWKbTI0M7m+lCX<+d2I?p3llXeg?>>hlLDGM*?H$rn`xBIrYUn8t2
zp>eUvBEZ<oP92A2N!YfX{I@Px1mqwy7p7XY1v2R&@s7eURRo-7EDr2&o0ySXr;J%y
zNt=nE7GVVfi)g9bcgE|kHTXgL8d}}8qWVP)k@;NR#h=}17_SNuiKx2A*^gH@4up4d
z!xRstF$~@gi{8am(7&ti+_~e}1;Tg4buJiTlPAPFIWbYA>pb&yct=!}$4()^fg>D>
zhjsUI_vfpfJPTYK7#xo)^&o#6O#L*4Wo!|gpX@{svL3oOtL&L|>(=#=aA|f!TW<(1
zuYa-y)tQ!#&Nh7sM!XwHGP@jjN-Tp7Xg|0<;gB}s0LOq@Iwsl`3ydq`G;8hmt&kJ;
zSg2?^MCuXNxqSIGjC!hX!omW3mk`yPa+WSH#t4hJ5C?ZqZ%f7P`58bp(gjrSz;{|s
zJAPAJzu|9=&en<57j{0#y5kcZ9ETRO2Gyt!$iy1fiF63zVpg3`-bP0DLDDhlREWJK
za1q;0R0qaa@sTfEHVq9S*Aqwg@G<+X&53Og&IGHk!<>r_xA}XY3e5N(9v%XLODHWD
zZ_~KjW#3U@cpCrrrt1>w+2{gc59|BB13?|7q?bAJZRgD7!sm^=$7*cBxgg2cw%Rj^
zIS_SAMBv9p-ppU$cNiR7E{RVM8X9$j03jAax2Z1p#;swq0+m>Ut#$lp^F^Vic5C{#
zaIltyxOEXs!{0arNK6}K1QCHKRId4t9zHa;qghT!W5jaj@mW3B-NU1XY!U3)S6#ZF
zoSd9Yn&q{m#$nemH|%E*ajYB`_hjV%Hhk<UgA8mmX79>DDhf}$5*{<SfiCo|*xJ*g
zy156b5e{d->jusqS-CG?!^UyC)y*}(4%B<F)9mzgH~MgzsQ_Q!w@b6NIW$9gsODYO
zK9bkVgKxc)zvB8QojwdpaRsT8r18<fb?Q3coUBJ=6tU|9W*j}*4C!U4ns{8S-nn#^
z3!d#XL*L*!hY^%_t-?FOMYmd1R#xr`=K4P$Q8jlKiHjhqLjxbdWCe>m)erxSbG%Fl
zkI)Y=ijOTA1y|(!a)LG~+c8+u(T$)yiZK6Ow^CI>IGdVJ$8qFz-q=<~#`oZ|4vYE%
zm9&POkdu=ux5`HMVsgwyr6w}OxxPo(YSK^a_C#;T_g!h9YyLdbJ3JG!eLH>Rr2g=)
zPqH2WnU|-xZ#yjog9?!XUGuHRdyW4*4yFZM=S<*6XmuipL+SJwNru%D%gD@X_~Vh&
zUqDl|gC$4uic77QgOV4HlI~g$siFwZgzoW|5MHxG2Ue|G)d9#}ZWRFPP0~p<O1bd+
zWSwl_vAt-Mg&07g$$F?TF!;1Z@1fmw?7MjYm~>qjS7|841qIK*)$K5BgX}?a#N2$7
zZHvh<PvpBoSS#>}$&jV_{P$L^VpEN6<1e3@=aV|J%c$Vk$JkKdcmE@Lu1Y4@zjA4d
z!p$$iXDGt-bu(4l!66;|P?>oK9($*08%O6*I&L0vrDy0dG+M1%o40J~Ad%X@C`MUz
z!a{0A^!jPAWgRf9+>+7Fx;-V>XaHN4WqSdAWIl{L_gX{t48rajT+Y6K|Bl{xn5bY@
z){r!jl0xEOBgP2^^e{rAvI+{y*oBBKR+L4d>I2Z=&<S>pzl7X_Uhw9-i-2hT;<m6k
z?kH>Zk`q4?C@G7kfViA?nAXCI6q#S*nL#j!p1Ne&kp?D3l}L9E*4h@jz+)Dl%`-@f
zd_N-f<-M*~G<e3Uwhp%$E<3b|t_`W9T<@s}|9-F?lxaKKHk(<GLXW^1^Q6n4R{G^P
z;Xy(NG{LlYjh$&Ret>Bt%oOZDeE7Tk@f}L!zAKS0N2aEPstr)|!GPetVb^e#5QRIk
z&T*bt{m_K&=;Z>g+IC3m#ybxlRC#_!9U4f2=&ONwJsRziUm5e5EQ9@jJd4IihH>ge
z^n_Jy!d4TPpsoipmsh=%Xu~U@rEsc5d9UMJaVPA-O4Yr7@M9ooY-MzTlgr19Xi~x>
zA`0ENa%nLihqLVaBsO93*bKTVrm`!5HiX;ksebR(no^*vAd*cj4buTFr7qRtO>rAo
zf*;=}C*yRi4R}sVNu7go+iD{O?VLD9znW)2yh|nbdW+m^{y+Ds#d%I-A7Hon&Nmcs
zj&mitpCE#d*ichlcKEi){fKn{&o40V*#&(rXqKzW<B5);Hsnz95c}EK>KvWH28{N9
zEN3bsw)kc06<Q$?i+m4h8&2O_Z_Fi)>~-W)%wHCR(c6U_Fp)viG*!^dWYH=81b>Cm
zRIeOr9L;vB5=FZY50+zH;Iuw%nx%mJNsq2Rqvjk=eitgLk07NU<AY45&`X#pPvGmu
zA|omG>(nG5ixCm{sA=QR_l|_nMFZjmYDbHB6L$)kdZQ4@faZ~zdcj%dUOA#755JUt
zsz(KvzOk@n`$NsAR%Y3qtgP5qo~?o)P|X{r2fs1#Jr!twg%tDTm*I|Dh6giTkYEX|
z^GeX<AYojqV>Q)4CUF1DjNnbDPOPS400o(l+Tp87L%~qP6ZGNV77CB;$)P(NpE>Fd
z=DNDWg19qL@qI1YzCC(a0PXb}T3zC$pMh868o<&aPla6!$w(nPvZg#95(!uI*(0mo
z+IX{6kK<j9{&X#9|84)*ZQhwrGHtp<#74k5^I6Z=R8-}VayQB?-v7wnK4rv%U?IN#
z;&%#f8bwUuyw?Afd)GI_KmwCk+&Y<LTwtg=i{kz`%*Ju+eMBLXDNHeKi&BBgAm8##
z8fSc(P!$<Xl~B7W9z&)vd)w3{<2VhC3Lb`;uX!%C_3g|Utf=rFs}bETaxh>W6~{5h
zE4#KCOeb8qzc1$)ziHz!O5-yjULrRWq3+-LMZ#V~v=bFExT4J9$@{T`Se4LpGZ%e3
zc3o!-Hj^|H$Lpq|T5#<C`ReknT&AMfcd>haogpX<RA(U?6b_vgC-y>|+&1aFrZ8sL
z%vXQ7-qOa(j(3p3wmVPabREQDCm{mCIMUULZ`|DOzehUGL$CxhcKw})zqsAp>@3sb
z`Qax|XfV2TOLG&9!eLRa^>%Z&$~PJn?D+Al&%K^$Wg<XO5n5k;6irK*S{;t>rn+;F
z<MO94fX!yvPk)`|m6JPnj)3PPtOz@t8q8(A>1%133gF;6h%i26J=V+lz=Sz-VPf4I
zmdw*%hSyz`v+O)5WxJhDSp|F~P4Wh6>d{#vGrIrzTD~xj{(D0H_KP6SI)IRTG3{7a
zZNHK#Mj`j_(+Z1cMZwLH$+MpCq4%)yF;53>o#-$T-<vYNZE+tR>DW-__?JM{uE>Z8
zM$@(npY}?ec}x{$7{z)<*1*AO<EkIeZZkv(tbX{AFwlJ03jQ*STtQ{NQpm#X!SNiM
z%c|%u{Xlybg34_tvxE4(y<-VdelbFZG$)&P?(7>GDTz9^OLq`72pe9btGMXwTtJt1
zTol>^!|pyQ^ktiO?C7puXR8^Qwp|Vr0Gi(>S1;3^wOf+~R*M1=T4HQ5t@^CAv^y~h
z5_2;ky<m=ELx!yxF$K%CVMx-yD~KsG?pRij7VIh9nkg5E3`{3B{)}d~NcEeX!0JSO
z8B#TASi~Fk^j>OPh-5diadMuAEn`=+IA+8M1L@L{uY>|d(?S=CDNNIh4Y#m6Xemd=
zEDSpvOWglS1Ba_>>>fO4?1~4c3|W>Tvi<-&dojqD4j_~lNM`3%RaJu<+}zxhpa;_-
zV{N=1x5?ezeY9Tg>G83?b3*kWuX_?J^MMO5_rL|_jTyIdumeRvXE$A9`viiw5H(sK
zN!4_KlECpa-!Ga>9CqhX{!H1TxHA_OyaXqC4w^qr@_Y3UVGZJrkU^Tv1K`M_JQ>*V
zKbvy>*M{i$?A~hL+h|upmQ@BgP1Yr@q}p*38{~Rf;E~2o@RU9fNorQrF~p#CuS>e=
zMaBx7?b>LGvn9!-K^68q)}Z6IzR-4<76mvo@n;@a!K#(z`+bCJ#!gaUs2~s}f2rFL
zcuY((U8G4Sir6k;%P%}_wXvGD<~y%Ht@``(|D;rTM;~qtMM(H2sZBuM`lxMh(++N-
zazAeRd(-1B?6NydtAKCmuKjj`8Fdt$d|~)`uW+-LY%-IJF4U9M7!=f?K?)ZBv`yJ)
z-iUr9qJoBE(YY!zau;S@%mZNT%`hRu2Y^H+7MJAJCBJ=e)l#bd@r>SJo?7e5)s&gO
zx{r~q(MO0qzvSf+hIp!6DeU3jm~uPP_!e4?toBpwpWsuAu=eB=q$f7Zn(#&WgIhgb
zC#x|~yEPZzjeSl-IpUD)%02*M**pL(2fiC!@D6OUvNivfHWS*=X~+oyt%77I7e1|;
zg+eN-K=?1VVY=k#{Kqy79vrd}I^YS#YiYhqf($38VeqSUa?MDwo57b6{Xl+})o^8Z
zkERj|MJv;;qSX!)WhRp!t-56M^rm`iir?#sXDEO@QnEsGu*olflHtcQi<rG#TfYk2
z|6T0=c^q3+^w|cg+^vnPHg1F5n`qJ?n73v*C4>DlahHh!Cx3|a19o#{qHE#t(YdK1
zKN#TU2ov#68}dvbQ+xs!X-?)qTd=`l^qr0xHk^yn-W+>zNm<VZ*vOVg&Ki(w>Kq-x
z+E`BXsz?fj9>T~DoT4X4$uZxliNbyW8Nsz)3KPhPGcBfCujO|YsK!u>cQuE1rI#{e
z)fxS%OlyLgYM47N*OGr(Wc~Gmz(ezZ0~cQrH+RRR7GXe$q!mgk`LnLz+hwhGFjHwe
zcqL<WHczNnVD_=%8UL9b%YC*CQZ%^z9fnG<_c8KadswBX`cD2N%sw~Ym7=#c5f4TR
zBO@xUyL6l;R7NIlErzhekVXc^X(*bY2GJmhh?$-QO#uiftDqyv5&ZYPd$bf#bi*eO
zP*JJL=URUJ{$1WI^4AN*m4<SSc?LE~T8Gj0x?soA^Y#l9wH=Uf{2-7WYb@(7xAo)J
zsO*>v+L3i7Hge+y1M#&R=SDhc%jOL`Kuh+ITTFr+*=ZV3TN~(%k;Ob=LW96xydrNP
zQEayRjcijvy}#B*CbSKB?WgT&g^P^U{@N;N5Fp{=(xxjy$R{N|G6on+Y3^0lq&l(a
zov<4PGL<PAeR^d67yz-T4iay})ExGnK%iR``dzhTc!Lgk40Lrx61E`D8R!6?pWKuj
zkI9_YOt^BK{4AS4=(&ZCU^>{iUQb?%Ov<_D)6miJZp&BGQ2=&yLa5%t<V-pOvk9L)
zgq*Ew*SZD)6(zF(;&(@I{G%=GOw4`0nx+-d+4JIMbez_%UVQ^XVe9-B^su0^T&F^T
z30`3Y#x4_@wBd;pC$bj;TK}jse+!H+=|S&u&4;`dUDehEUy^G+9zI*riQgrqL&yb^
z247<rf4OLz@*<pb0;0ZAy|B#g>dhe%%v4WNpX^_&uT(B~^2o}<6Lj)$Cj~N<)37{|
zlDa+K-CFG&9fkDY2f3-gIu!{02S8>+{}d>LOBgV5n|<`;$<e@%Z=70o0PFmKn^&?8
zaaNK9?!If8mrXwcC&##tnodP~d%NhEGp6FJ;W&MN1k(HOYDck!@v2Rp6|YaO5`#|H
zdL(<MGr)1q8RB?Qk;K7+(#RIZ-9JG*TNuWWJh92+-&UXF$M*>i>NPt$dCg`@TaW{3
zr+^piX=!N%yysjN$5`^(uDyZQvbt3sibT~Jbh?4F>$;(bx;7s+aAOqTp$`FhzO_30
zdIQ`Vc$HePUHf+(gP2-*ch$OHJfi>?7gxDBrkCCV{T2z?UT+rNCFY=vL9r`0o)Vip
zI5pRN2SoP2R1J94oqAw3Hg(~Ly2mG80ZNzkq|M@g#<*{+1(WrU{a<#X1u4*Rj1C6W
zSxF1fLqHfR5WtNnOX%7ApvFBPGBTD!gM(qyve4Sk+{@}ffdUd7^<gMfRt}=n>YV{O
zXpbw+L!zQ~3L1Z>-g>Y-U<{Pp?@@bu<nc|Vbbng^>G>9yTvr&jc4X%$$P&{48MOiL
zjCrK<;LpNASdL;qvzQqBQ>L&p=C|}<2#%OPBdwAm0pZ~pKO~vccumI8FbcNT0(dxx
zGmkiFa8AH;P+-z%E+Zfnx;l5<z>`#B?E1X4bYjLum>=7}Jlf(qWNS|R!L1LrUxQb1
zCVLYx-8o{Vh?hW8@8Lrn-=KwooxblWYn*7@A3oV}<P_@K^&5c@FAKme?{3aM%%Urd
z>q(>W*XQVhLP`KJO)@<_aqdE&Z!ym>#`K6Uv75mCu!ju5p_<;TPkL|NTYX;Im%B$f
zgrGZ+s3J)NNHyHBTG$u{8WYneA#5R=OR12#VGN>fA>y#iLN>;3M!^~jC&g;~krDXa
z`<O04+k+>xK|TNmkzxqrflNcNYYRC(IfU~%ASyi{vMC8ML3k3geCy{2vK>}%T+YA;
z$%R;Zj>4-kC<zC&Nl#<iN8-xBX$9StbnF;@qWl8x4IZ)~t{tSDrcm)x8(uyt^L6oR
z6(zd}>(vv_nL^-Sr@FyRv9nF)c%_VKi><9XmI2=Q4*xl*Rl1RLp6>3I=+L^cg=0W~
z{6MX~0iE3%UD0f%3~vu=<WW?$_t`?GjW>FUo)Sm2L^YdbaIpm0+saT36p0%0pjbkF
z8UN^Z8y6RsCP?`dr4&+8-E_@921RN}#_Z+ipfP&Kp>^`hd<Rd?45lBvTj#3kUVtct
z>LHs$S5mx8NzR+E*>>`;ufo$?KRd?g<}^2O+Le-{6v!zSHcYC}%=dtvDzgfJPN)gN
zuTOc2aP7p2L(~p@j1;p1U6%!f1^081P3J&-1<eZVq<>C^9?S#69B8(6w#i5>y9wYc
z&RYNjBS%J=Qk#%=$?%duW0?{Pvsrh1A9NK09NpqeIM)MwliwGXl#JUPl)bWC?Q%Y6
zyN-VL;fg!bFwe%uR)}U-YcL;*1JF{}_*`zLa_ps=0jHHG6eL%0vB1$dYD2B_CJKXx
z=5@&Z6r~Rsgn33hPYA8i#zW%bIs^+~d#&--SR|%UWO;$cxOY$-W~Mi%Eea@J7jBq@
zKh<Z=#%;&M;xdSt8Z15y1zkbBD3O8-3XZAxJl}V=2&pPF$h~SANHj)r#O!6@MUj7w
zD`M<51NuhW00UL-I2k1o71hFQ)$f6$nFnwSgP0Yp!vqL!Z+@b#f>j>efhgwNUikQQ
zw3ducfzT@^SVOrX%#o~SvCnNf#<a-q9?XuzCkceE8qnSfHyt6&i7EX3B=Id1BvPuu
z_$F$!T1k$ak)k$czHS+o)ozUdENcT0CMRRq;pVhBdqL8j#G1i_#|OiMS!AmUlm!C9
zi;!Bfd?itxiMwJHgaMPG(DkxiX+zm_G%dr`LBth9HU~Q2$olOQdI<^4x)=dLR#dA$
z0QU(_ZXk4n>{M$Eyfi(S1SjsM2xsxdX+1I%)Nv+t4JRD&WPrfU)LT<M!S%@%+O)SE
zaeFmOCby=3{uVPP<g(~U6fsfpr~GSrQDbBP^hBT0QZejiNZ554w?hn2l&aw<RB(dV
zF9aU@kQ;wv7JD}w4hwSnP-K01h=eZD;39_}b-1%QPoE@4F3@j>CX}i@KYg}y1d&tx
zKAu%8!{#DbNBvZ7Swx{Fn8X6SgCRwUGsNXrPch>~+Om~#Av5;Ghy-g>Q)S4$IGwEJ
zg~0c3|M`+Ya42%Zz(b+acF^C+Q6UrROJr0Df(KK!t~T6+*8M*#BsEr?s5r5r_@t-!
z?2YGH{wZ(JjFTzLXXwUK=UYF~1KyGj@Mc3wY<~l#JR%!sQt%R|4bFLBDA0|;OzD0&
zsyvA!8pp5n`-(rFJ)-{eX*_U1WHXfu1b@@CRtvmC60&>-B|FkE7*M=W=LN8dF&RHR
zZ6UTrQ~eZ9FF1fb?TtNM6T47P7Vajx`It+|MQwWae+Y>qU$5YqULL;kx9CK*l4;H<
z7j%`Cp_1!_&41m2f3ehj4#QY!0xVP<?wN~94<E3h>zx1<YcX@(5)*ia6qh%m6Jz}|
z4`3X6$}Dzi3B#a%U2SL3e2G|fUVz=k^{k~CzIGAJ_bY6J$;NoCv@p^LVWKHTp7~#+
zjjo-Y-3QTZv;d(Huq^HR!Ezab7;ALaQjSqqkifLw#S0g#`?LV}q`}K7?CJ6*kOJLO
z)2o~)bVi!V5SmQ2@13!4TSjwfG79RFNNk5i4Pf&LWL~Z#qRnu@`{%5DnX~f^>QK7<
zm_c4!)3UfVKP<_E&NX7_dWh2xa|yI)rBl1e!7grdV_(u-_pJY144sNvoA{$(aEt*j
z<GOUEsG#6G{B>0ZIS)GSRd`f<ye>z4ITOfZu4CoGyf|BE79har#*G_y+qIE5gCG%}
zIdeuN$ac~w0VZ$4vYZuH-`akJ<Lc9us#ip^!7x~ZQJ?8dfU-=xVZ%tb1u@wy<6k&m
zWy@;-bH>r4SE6@eDEQ#0H{YkbR7p<J(z|*U)+3yqv+NB*^))SzKODSVNZx>ZIw%cr
zS1x#cqk7#Dj6Z;p^=Xwb#n$eDC>Kfkag`9*)xIME<jnzVOo>`W5O0merjVsMx?`b0
zGz5W=Gn>MpI4OpnT7zjHANW`yfP3M912U2lC~B{Wx57>U0r-hDM~VF(k^20ICl4XB
zJeLAD8aYY}hkQw6`xB)Zw&DG-@5X7Ru@aLh5jL>5u3;aqabWS>iP=ZBbTpR0%6??h
z!8E<+0H<19Af%Twz#p8Tiiq(T^P<m*(-d{B9fU~Ytv*#Eur<`K_Bbe;|GLgI9_K_9
z;)DtgGKPm5qaqd8vQ7_4Z4`n^A+m_5$fAc~Z5$8zbMmH5(>k`jhs%TnA?O=6beja8
zf$SzuXflzqY@$PhNG6duozwV14H5qyxxi7Q9~Y2x*<m;HhFMP<{LE=7?m6?$5=LR?
z`PBZV3^g3)!GV>U>ZKEUxs|YWe;KX+DhE;|0-OcW7;fTRpz0_UnNyOIZ1DY%LzFPH
zMjU`B(1~EM$!s)^jc9JTx$49R5H!n%TdKF;E;cUvzNs!7{^J||?{`?5|5oF_H6T0W
zzc~1B4gQM*vI76b!GCM890vd8#Q*lfav=PFP#brsf)yot20^tiaI`1btx+(%w~sHM
z+Ixcj^oruA!^7qZD$(aKii4w0i_ypt`R{jMF~etJaPdCi{tD5W_6#V~kdxhFaJC?k
zbO=r94bc!C89SOA%(#(<yu*57L*IHjI<>R?jcKqq_Z*1tk~zkV37~{bXN-Of7wrHO
zmL%$e<89*0A3Y~MGTRh6Wd&Zc2(%%!@bK7+3H>=l5C0Ck;hM8Y4t)X9-HMm|(3lYD
zPo}BJ*`#C$oODEFU>*Ex)=N%mFL+I7;5-V4MT!r^hgqcFISiFcN$m$qzm{gl9yHN9
zWy_~P$X8>Q{Vc3OyF{!xYW2v4Kw}l)7*u@-&WdT4`u;*@!KB?FlZ)P*)B)fCZXaJ0
zsf;6HmW@}ZN64w{RPuXL?|N+{W>+%%1yTVMp1zqlrl?tV!|*YerM_E3%cn{&pBTX*
zo4F`<hX2f@7&+&1w8;hxb5ztToQ#P1c|i)!HmE}1sAfCV91HUr6AMc`MEn|Xhc`gt
zkL`W~CV3VLav%Eiqv-8$tm#o4!pnZ)<!gBM66&)-E%?qcc<es@V{+>3!U9hNxSonp
zJ2XE$o^&`g7suqi$52=m-nJ1K51njB4K#S~Z5u7zA}*pcoPeY9qcKR-H=xF=@Wfpi
zX5h+eppo@JRXvK?f5@}9(A~{~9=idOriKi_B()1!cgyo&P9_`vj&vMwdQn=s5{%XY
z&i=8+F_3BXXwv!0=lpBlDdZXAyc35WoR&3?`NUT^6a|l(j=`%S1jO34YcH9YU3-Ga
zdmq({fE+0E;LrE?IOe5B&g3dzAhSwmM_q7wM>4ppbi<m1<j^I|?tuG<sV%4bbLbBK
zEp^wecFSS?9h{e&FoWSs*O+4Z(+S5X8DiqAiEatsSr79<#)1S6IC|ylYd~3mZ7T`G
z3u*N@Y(W5aTyhw!uqi_1DVTgrmc0iZW;1ph*XSPv5zsUaf0IpvDJ)%494|lSj=&Mz
zheKfoQe0rI;vRtGDIOFVCPl8<i^J^>xs1Fsi~w;rKtt=s0`yNtN1;Pj1tn4F6Y%`V
zDA#4-+l|MLOW2==Gn{+w8SKSTQDA<3^KsH%>+|`p68|?~WYg*i_1xFB?*HB^xfla^
z$@hdI0eUA7OPmBaQmyi2cm}Gfs#H`a5Z5ALjAP-|Aj2gruxe&O$&QMG3D*$sI(8OE
zAtpo&K|M2s=P4P&MLh<Ho!~p+aWaE_9hO<1fku^FMHMj+S>*I9ayBUJJ{33>QPZ88
zge%UIBx7GiT=6$>qzlm_$*DE497aV&85kHC;&(CM%#b`HLf~Rp{vHSz_1N7(BDcsV
zqM~}kPCvFxF4p)}P*PHjBSxHXHeNEQ3!G@7>4d}D1Yj&ziPzn#7JBM|*1+zWt)Ia;
zX{3<j#|5!hB_$=35v#MH&NYJP@Ip*dY_C1Zq*jmHB@|aC=WNmaeXoiNOxctSkBm_@
z71*AuK)du{ChI+!-YDhT^yds+a*Qr33q~uvuY})WWA%;pCK8W*2~H82!h4O1g1C{K
zE-ftuqgOf^W>QgU0*@2dwQ|*}350D_R60b50G7slkDb?NUWbfvT^T%hc{g;qd-v|e
z)@MTp@ihUJnFNP{Y6Cf`DX|n9sNTdpG6{z3;IF?FrOX-Kr3(X*%p91#OU&gOzs_M>
z;RBbFow`HaxEpZRlUQ1CaeOMn=FMRUlPJTS6UksDRaC(2Rl^e--KEWWInALlRYYRu
zwDTHn+s+V7f5A#@Ui|8xbGGoL)Mn;eY=tn_i-YjNrK&UcVF;|zp)Zz|brgrx6+sY)
zsSi44af+NhO;1k_o*-xJjcUPj!JRWb355m{n!Cyz*xh2-+D=P_L%TJt4`^JtKBOs&
zQ@#@Br?6S{A-$<K%!AB(@%;H-R#xJikLx1m>tkSzp8h!qX&rD*G4(F6Rr}@>Hk3aH
zr|3%IkqsuMLCW(iIko+qQBYxo8Je63O{!7A@)cQG6|r8#ixj#z*4As`<;C8~E-_fL
zgpB6(@Zow&=Q@(D$#GR_{!y0}GeB*!vceS02`MD8q0^1U`59a{^z=OyZ`?XY`j=!e
z-wLv=&IAJ-H!xTejvYl87jCL#v!eG5<{DDwr(n4;G4;YFAXVXf2=Gyz4yHJI8rOwo
z4&zHHb>cYi%x0*Whm{riDJkuu&5{sYNH0((0`$7r5zL?S^4K7GpbqF+1t5(TyAa2L
z{L+lYL~3E-mN73D+fJ6PTRVO<lG~?x;FUw!!f_CUrc}Gb2To1o?9)>F5lFRdLNK}e
zVEW@6einfY>zj`|IK)~TuUfeH+N>D!7g|M4jKX7u8c7)nlUA71NMkO~Hsr+7957ss
z?v96fT=p8LV7`qq25X565C*yZgdT+YmY$`q|2R6|L!qq9Q*2F;1i6>j-EZ!6tVQ7>
zXLr)mld1oX5s15(ucqsrDLnKWM|Ws4!?F_i@LcfeJD;O41L>N=`|z`ZEIDWf4h9Ws
zuA4V+l2d?SkM_gz6Yi5thwanLaA>sCyi(3WzUZ<zLqg+glmy?UW+-|cIXGDFbo;E+
zi%~D9HMP+6W9qkCkG$P;t);vVQ>m4R0!IpEO680k2k7T{qyaLl3q9ZoaeQIa&K7RM
zWMh6Dut<vh*>AQJsUs<$gO{Hwmqf^?mq+w)I*N)2*zN>TXB-VgPmjYZvmr!x9K6%c
zfKy6l(l3|YmeFr<c@Iq-rz&`LsZE%Ak8wHU*Cq-VN1a+!4Q3Frw8qV^n>ERC1PG_C
z^v?-)!CBLauiO6jGd6x{I*nroDD$V9Ar`j->iBjgn#nTn*ujD6)(;K&#Gsx=R{_hS
zp}pvw-vToISf=z%VwT>rWgj_hwBtiy&aRgWGOj|@m><FXd8}@Zj+7K}0pU|)mzYzI
z-uRw7+Olrbu7orX_IP)z|L23h2Hqfts{nO9hcB`SUYL-+8C07hoZa((wRh!VO`qAC
zI>T+1T1v%Y6<k8A6;bMf7&dEVQKyKCG0Lg~h=O1xWeEyYTOC9NL1iae5!4_?*&|?7
z6vAGR5ZP6hC~Hjw8`k?CI-NT+&wcJ+_ql)Fzw`kT!teXO^PTga_kEA0g&Q<RYX?Vn
z!km+f$c!&Qqw@*O{<%bAjd9tR2x~;>AnkJo(P;X9pk)tss=nnSjVNq`-66;6bgVsG
z4;qEVk4O8=K}#phS3^UIv$fpFPgF~iuJseYr2vI4@phHz4>XRb-cNex(}TB@DDVI;
zK}}jApUmxED_SXk*>j}B`=l92$w)ty+a8qv4NViM#M?hXK#2ks$_2;E9nB!v%IG2g
zU4<1#tG!IJmU?PIuNI+$dJ%z%7|AVQhVH=MbrS>{80Boi5-}hzjRN<S`~3L(zB#rq
z&j-8E-ok?P*br}=BdaB{hrvfmCxN3JPm2WSpm>tD?R@$;ZZiuD0`^y-N%tBI7@`NA
z`tUOby!X<-jr;1Mt0Lwy(nBuBX;`vIA&-Z-i0D7WXr6lS_K<?gWD_>oehJaHJoIUF
zk{=EX+5?EzWFbZ#9H8OkXeJQRn;Qa~2{|kyw~%TAVOWl4Klvst7iBMzPY!mt;Xcg&
z=fkyi%WiA5K#l(jbrxXuR@2eBNCg(dE4jY|&n5^hzGvR+_dWV^Rb^#%a|qH$dvqz%
z{lPY=11X`&I}dty+&4Q}5_GNYn^@>GXI4QU+}C}{8~epSj|t{GpO0uM?N-2SxE{@r
z0w!GL_H=DS7v^trh%vUYB<S#odxUhIpOb*oP@%wq&oPl9-J!l$#bl&5v#$F$<+&p;
zl4Y@yK_PO8oEK1O>->*P{hj#8;DL$%$^hR?zx`kp98@+VU15;94_IBBAORwp2RD~I
zrHBGd4h;}uUc{J<(}<urf)$`*E~gNM)VI-l5-Oxk5E^tLNr(a;aucW})CEO<Yzd8Y
zfuQyaX;EIL6Ow7_e}Y#gBufEuF++fd6N5f2C~X!514rI0Hh8MmB$Y#nl~ZX0`vR~t
zEyw_bjEIj>Lvq2p)L7?eoOF9?oT3%u`||O0I4)$HuE(<=A_lR<Y2pNZ4?}2_Smjjg
zNqLi(U{5Y+j|FzFou!hFlI9slC+K*nD1MFVz4W_hipqnFe;Agjq=D`@_5J_*|E13X
zbu#V-zw+|>_U4-^CmWCoTd=-hFdjAEjQa+pF-!RFxIg-7dfV3be@Oh5hvrM*JhFWW
zzk&!q)se!|fB~_qGHKqn`Z&L$ctZn>idec&2Sw*Ehp6TZGUtgWL8s#Ljd21|kbZp9
z5DRym&qo{4x#r2!7h-NIF1{FV5P_c$C7tm?VOu9RM$4_PSE(7(A`gEwasPqj*ZQNU
zUYZMdA7$M(%IXGTYeSp~J;NUui<!(lWXFXJh(-$pnj|~^>&H<ZHNhu;9s(}YJO3H}
z@l2yDH&*rrt@d)pqP(2(_a%v&t9ol5HTrh4sJ+fT)K<uiagp%R?hWglNX-ECWE)Q7
z5^{$?A0JU{D&OeIgMMNaDkGxNf4+F}7ErMc!BUYI_;UL64?eh)Xp6fXfo21RGvw&e
z7>57?!iCErBb#a3&-W7%zH0}^-~+zNd~%FKO={RyY=RD&*i$&f*DOwd;@^x(6=k@$
zmeCv$ly!7lqnC-pZFdcq`r76>!5QJ@A#6JN?Npy5*(isKsuTJ^Y9bO{g6<HVfR=p+
z?LZ|`La3tO3=2as*1T`xQue|UG5oxo$<&Am<4dr7x1dg=KuQE{v<P=K%Z~LUBh(`r
zS3n!rngk_q&j7=HS?KssEJ#LcYL4Jy`;zR>=zPKjf@D@i*+3aqX5^9L_3VQb#dc5v
zD~_E-iM*e@(XjBa`(fNpX8Tri!F@00IB)ZEvT%F*sy4=-a<;^$IEH$BJu+TV7Dg#f
z)jB3KBea#0b!=H<qo4aSqks&yMih8V?U^uF#T+M6yiyzU+k`d5ZSRDjPm4uyMb;b{
z#wiumhHf+sUQxx&BmXpNy;5wi5b6S>_|(8zpR)4<Tl-e}Zq*Cp8kXzGrlm0FGPTx?
z4xZjqqdF}2l?opu%idG@fg3n(<+wi_Y%niy<j`~8<Fg_@I{GRVoyhW`<JF5EwR!^G
zYb~yrs++KGi8040gEX|f?T%tYTt)7-OGrIi(1E@3lKDNjG6#1~FqG}*C5?rOGc*_l
zUY>o!1yK5AU<MJZfShk!U0wTg&p=YyR&>-MXSLjZcIx<Ta7Nt|Q2=;BCRzojw>`#i
zo$CjsyX5iXXF4dF+uoGVVO)jnp)nS@pnoR|cMTsCFZ^AI*y<Ds1KzxG6f_>3KIHt5
zeG(zf?|}p!Gwp0zlJ^ux{FL?k;!Rx)jd{=~x+fAn)m+e-q(DS4Hk7I6G-Rb<*Te)T
zLTKLV4Xq!FDI`vQ%3}vVXM04Zj8(rGi1YA}Udm``sTJU|4gm?)e`;a`nYr@$*y8>N
ziaujbB##?Cek!X=;+SCMN5$P^DM;FNKxQr$#4nRwI}yiDdC?<$5U;Icrj;-MV{LL=
zY?Iz61LLPZ5&F>iE`1$y@(Aj&e=9U$`TUKg1$Y^r+|`-jiubpRL@)t#g7eXJTniHX
zE*8rPVmZm2#>sqgU<EsYl*tVU0=-bylh!rn?jWY>6f4hkj-M*IRHz7tirYcn1lbo3
zhYMjnpmx-e<`E#k@*1dQ?3(}yG{}ja|2=lN{q?On8L-ha2L=*^L=2zP#zunpXfk9!
zJ7>IFd3+OV2)~F-N@z}o|LZzS=%)`gN)ZGIcR?fy23a;6rG68{+Hg%RMCHL^2}1AC
zaXucoh+zza#ELl}(nx_R9E4DO?ZG+=(MZp-3J!QQIjvH2$YjVVn}&%H?+<Cn5R8!|
zcyD|jc)}20)N>LUqC?XHT$EU*5E|{{k84kQ|7O#Qy~4~>iWwfV;>Kw)QHt_&y;ZN0
zwCe3eE5V#YrH-JHshm=GzRm-Fw&JqExz3)xBNwI2HYY`2<-N?<M3a%=m#3HL2a}PJ
z^|`sJHVJELk=4IOeDfXGc=+mlwsl0P$K=d6Z-sA5I{FdSV2iZd8$P+HOn0?&Wjgqr
zyI2zBis@2QQAb%LC;GZf693(><MTri5j-_V<-5nXWYer??5=*>Tc%KfGxUogqBMV~
zt9lD8kA6smszUH)X?*GWF_;jR_b6#nNS!T|V#_1hH+MXd=Vyq90oLuo$S7n}y;6Zu
zl4w)g;R8ukCV~$>{IDKQR_Xj6yvL!CIBo3H)OH*mzIaG<4V%k_#Ufv8g<dKGu6=h$
ziIHx^{au#cB2LIc07ExG`UTsE?Bko=+}wzJc`Ns`ulD}no(O4J+JjP14r}q(v2w;=
zSX&_D0W6ge7k2{_Jl495B6C6ln!#%R+x#GLrcJfc1il_4G{fy)CF*<E*Z5Tab7#r4
zm~^ja&iShrz)pLWu}oFiaQG~+TZblWh{rujpszQ2hSbxH%w?6_;#x;1W<+0dM=P_&
z%B7>wmy^>DIHL$7hxmLRZb{T-2PF5g#bOM5Pfv@<nmiRa;+VkkQ3u&waSRZbK~;JA
z4weLBPLsC@r}O={%HI|m&#LCBB~{f%agL`?^5TXZpKp4vB0jXhj60v^CKZyE2H`!1
zT)A6fFz&CC%qr}DZ=YFn=G?%I%TE~f9YPk^ST_u@bzb8zpymc5387+f#W8#q+VOl#
z8`rYh=p^aC`+NdGOF^p2<fMg%wZS(t#via=X7d2O`Vb0N_C^6~d&^+bf-oAvljseT
zc-O}LKx^0L!E!fi%x@S(Z1IrehO-*l+P7ds(ts20g?h$2Hxw1aa#t$ny1gbLm2Nzg
zsQB?AKHNdBsf@*e2w%{uoCN&3Q*!TzuAaHMTDL2$H)!2CTg}~&;pd?7@yC0W=Z68s
z$bwdU`K4GcotP)O{j%@BeexTA{Et1nqkvrd2c!r;EXla4K6`>r!x~vj+i%t<lJ3H|
zhgIafu;9%y@o>ZvcJ*c+kL~d&o^yN|)7W>#cSG&7vUqCROZR@(FMTR|5ApF)!9$yt
z)`fa{<=q{~7yzHZIFL+AtGuCZ*Ec$kP4ElKi*g7*EG;@=e@5iAaFHnVb}o{ao8&}F
z%0_m;LvOB(?81S%fJOu?GpnE#C;&Oi%E2cN3nRx1fFuYrAWXUCwW_ZlTZsEfSaL6_
zNV?_Pfx!SPt5a2_sFl2xg8(L*S{CDH!7u!r@z-~YpYgPHk;eZMPLmZ38-p$pSiJ{1
ziG34?HDPQF>e?>X08qCrEOxSh*6q*A2;1E~Va2mA9!Q8hvG@CGHP4J@f`!08)zr9q
zZ{>HSHp5i~Cab$&*1muwBYC-GR%w)ptnrms-<KXERop+xK}&1uHz_D85calzY<pS2
zl5}@480eW~g@uvt2C%C>pV$l6Yc}&n@*3xRRI3h@*R}~C*iG^@pKy-n)xc1?MqU#-
zYh60x8G}Lo9!L+AJ}xM{DniMij;LFBn`ju5h~Z_XFS<wmWlAJ1T`+-2t1vNu+yt(V
zsC=G{|6;(vcM}{ZU690SXh2wT5mPw|`pG^TRm~23m26ozGP`zazccYL=LX*>3#o>b
zV%y|^wl2t4RuS4uDM199`WIyQt<FhhOn+=>EHO}1cnu!TH?S4FI1v|l;yh>SnJKV_
zVlZo0kVqHx+HU8|i#DDL3ll?tK$g|Qrof)UsH$0|+c(r?t(MKigPV}t1N4RN6x(#w
zerMBQea*+p5!iCaOn#)Mwz|H-PWHKNP5N@H8r73;Oc(B0Q={5uuCAhDdS=-jQ*m3(
zN6nm$c|~Mwo3Q2}gXU{eN(_@9l1V`Up@$oV+?=VDY>Ced%je~pp*=H8qfB8Fy&Mg(
zkE41IUy)xJFIl;6-LqfjFrEa6)P6*Bs|?}J9l8th<RdW_xz-`s|AOXvh{c=oBKH8o
z)X=yd&Tcf#IaRcBf$GENQqs&V=fnngorJB!hZuTc@z~eTZ7a|CaA)U0hqzhMx3rPd
zTb|%&xj|cv7o%vu2?!V3r3<pp4_BtwayINURS(mw`eQSo;85SPc{9*fq*wO$BQ9z=
zxXcT~IwE#&BAW5*XLnP`4id=x7o;_8_9?I-N*$EU=kY`n^bR{@wtqV(xFe=@MZuNx
zFnah{LqiB(jh|Oqgb#)!I+aC#(S?NW5-yr@c%it_s2${$q{whj)X=pOqwxXJ^Kjx2
z20-T5M;1u$<aMVkjC&C`iMZH>7G*3hu5ySBJ9C?TE&vnRjF(mko?)Gj=myNU-XG^-
zD{eDjOK)Y(=-K`2wWKH0ttVf-e9ei@>z0UxSH9xCZxP-te9%luvd8uZ@+*B6708B`
zV&}&gt*hPyW+hA$Drf_(pHxoy1Ma%Ddl9l>njS^|;jNc)9Te3|N89FLAcn?*1(!`l
z)1t`nAJ8^>Y@cXqUhK6wvK6n05%hKyvcposd-10u(4?Xtz+m`78-$zNVTM}^vbodZ
zp^l#+MJD?3j?e-7Vua#q!9pc`keZKA+k472gbarOQ~m`9@ftz5f)9yqDjevzP-Q2Z
zd9>w-cKkk`*$Zf#fpcTn3K<XP=jTt;5nYK?wLO4IPF<qIWA|>E@yxA{dO4p<Qk&7i
z{rcJgo?2n>e3Z?fx-5Eo1%LAyqyy8ibt|_uqis`xK%xs#eztN9IbRnRNh_*1cHn(g
zRpCXit+zXqWAURvb49;)4{4Rtjz{1-2ETg-BWB)JYSp!U-9&$?!@!Tf;;NZjEyy3p
zYwQ~P+7Fg>iOqp8)7K%z{UoaQB(HB?Ym;xsx$m>Mo-+$pEnv2bF~P2?d+mT}>>T$~
zt`mqgWH^uUGLoNh$(;%77pR8^4oscwsL#3^XJx7_0c1@c;{`P8Ezs?l?E*E`MWf4n
z(fIH`tQo3ndpV`ZP+$dt=f9rnX)!v?^{<$U^rZ~Ozafsw!aop4*W05uD3C144glLe
zck~5wRIm>P=B`jf&KIF<d36Q#A4GRnyO(Ri!ZN!l4Hrh8kmG?}b+>R4UYiQpRefD`
zL(yW-`WuUA)LmE@DCxGCmZV+2^!m$t?fYXDZQ9TS+zq;qZ6b%G!=8zDC!^EkYStAP
zhZz%H&ik1|aLDo5UMDd;6uC@s1U_XI2FB1&in|?c(9IoqHn7g1`-y((7=j<dCP2Xp
zxRl9lzE#~DVZlxD_=sB!*FO(&y8=f0_!$&mQBXamdyfqFFGJ7n2!C=cA{5VWU==d^
zMAcLfgUN**pt{H*qHUvC!pV-8N&YE#T&J64(C(2j*y@I`6=AVpSDK0k)qsT46B<I6
zMK)lR1aH7K{-ZR!0FyD%!Nu)8gfk^YFaS`&8p5uY!a>1)ggQ8>PSC}|fXSJ~q5=R-
zI|&?~JOM0bLrFXWMZ0}dFc=J{6j~aTO!E2gxNP_4;=w!F+1dF$JfXT))&aYy-0Wr;
zZ$Ojf0C<G_2Gj2Yj-?`)&xgtIF4%+pr2rTD0bKNaKDgpNG#${;v;G$V6+JLvc#F#m
z87(wGXn<B5rllY+YaWDJ%s9Kf5mS`@8juM55ba4kbG2h<@w^=(x~M$~HERxf!A&5w
zQ?JwzF43GRO|jJcXvBI5Kpi97(b10?2EtfRZVWhXx6tjZQ#b$ZYn0adHP#juou0kr
zbE|s;ecjD1EJVNoD>yV62LcmMpsjwOWFR((x;;$*WfaS1vt=z$z05>83BisYvMc-%
z6i)ZX3tzl475Zv-`9&Cnari~jXU;wYuL6(*#h61icngR0vU}Bi&=Q0VeL#a}>dcGK
zo~)jjhp>6DT3FTgjxtMNp4qsNMqobaNjZ)oHETBt;!TjxC9&DXVmJ|M>o5nLf^82p
zaE=!hI`&I1O;t1dMy3RsKyP24!>xIhQ4-GhJJg$gKQk4Y<GvKYlR-ePsq~i$Tm<lt
z!@`!0&OEo8JNnyiok1z6ZkUPVTY*-=_ql%<Gkq3kz-5M2Ky~d5vs^-T2BA?&_qTFR
zzna}{nTpmdRbmC4SkMU2`^p}hMCWv-XqX$k5M@GUt1$BH*?L5-8+^a_DjE&@#BVzL
zj)jH6DQL4T+<J^IgGhb=2rS=T>y9>4kndV;meZi)l+L({hDG)vDI|Y+myOOQ#U_pC
zEfjGIuh-mc`*QE;un=@8{olO?kQ@Y8X;#(vLrJZxuBf9u-gN_+{ShPugRSPu<wzxI
zv}9I$;qQ5I5<B206d<da#z8Fwa^5c}3vFlLNitKXVL>Mu@E1Lpf&$AJ1OzH~Q2HN)
zuPov-+w!cIC5ZGH<dr`kVjIvj3_&PB$#aV^XGvmq(sn4Pr&JBVtAh|ZXf6yq<a+Uv
zpK;$;`{hJLjakY=H+Fp6MkP6H9Zg3yHK?3M2hvVgR~N2dmT2qpA<dGkbS>!=+9Hfd
zNj?>G43w4cfgOz?ZXLuSJ(Rn0#D4ar@fBNC^)+fyy1zoZ<1G}api`uwKQ4g^YHHFa
z+9-F=Mkx$B2S&bb!I+tG^hsz;%!TOasi87}FTsGQC7T$Qx7M8`r{V~0+v-Yde+;Ly
zyl#`2MxJf3T!QDA1cBkTYou8kaHP4jXQ%RW)pjeB*)4`Lo_%k`Z3zl|L>)vug<~SK
zSj;Vc#Vw2P5Jzzemtf`euyQo#7Ik9=$Q;DGp>s*T)nE?z!K9cUH14?|rPL~<RJ6ME
z1Q{g)f4qVO^(p$=y+~))prK0@IE`z@6r?sEky6L@cG3k?L&3lYDgVIgeqYy5?^q<6
zOf760yi~uQnt{1};a%W80C(WjEafb{@m;q%^Q2j(=#$qsaC*3A9#@}VUB@E~Df}C>
z<v}oVBRhBh%W5#ugSrb>xJ&$>wyilbA5%@rh6hCm%$lpH-lLnj4r&>i5h78*%`vSj
zc5iWUvD!Kl&1(o*^F~<q)}cc6?ouu=bhv_}g}Z6angi!AVq^>a><pBcobHC8N|Rd1
z6=n%9@EaN^!C)YJiUQ9kkm(S(0~bx6-4C(f(eJP7ZFl{g;I0$j8NwJj0|^C(_s+Np
z^Qn<h)%FTMb<-?8x>w_g(K>nznyt_0PyJRT5*Lx=Z2>jS9ly{Qbu#H)C~HSVCM#}V
zv==LoZx$x&si?m&RZ+2wjdT>a{Vu>zNqandYUGWI%2$SecNzcx|DlcZzxg!AM2M`^
z8rpkaG_=NF(+V?$6X2$TFW5|tNxHLmYQ)j*SyMlCYx-0tqv6j}^Dw;78$nOj@VF}e
e`5#}V+VD}ysP=zcti%thY_{BLar>LSC;k&ck0a6m

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/command_docs.png b/latest/assets/images/social/reference/API/trestle/core/commands/command_docs.png
new file mode 100644
index 0000000000000000000000000000000000000000..c61283a49ee23b01b560a6095931d9b59b00301c
GIT binary patch
literal 31508
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
MHd)KbFy4CTUx~n*kpKVy

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/common/cmd_utils.png b/latest/assets/images/social/reference/API/trestle/core/commands/common/cmd_utils.png
new file mode 100644
index 0000000000000000000000000000000000000000..23820be5f21a382a44333a03d88b5012e397669e
GIT binary patch
literal 31715
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/common/return_codes.png b/latest/assets/images/social/reference/API/trestle/core/commands/common/return_codes.png
new file mode 100644
index 0000000000000000000000000000000000000000..ac6248ec1d32aea8698e472cba3d9db0726ab54c
GIT binary patch
literal 31681
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/create.png b/latest/assets/images/social/reference/API/trestle/core/commands/create.png
new file mode 100644
index 0000000000000000000000000000000000000000..737821ca93e3859d69d1652a84420866b2154a0d
GIT binary patch
literal 29842
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/describe.png b/latest/assets/images/social/reference/API/trestle/core/commands/describe.png
new file mode 100644
index 0000000000000000000000000000000000000000..8add1b838f1058e9489d515736e02122ec6a4c68
GIT binary patch
literal 30242
zcmeFZcUaHu|304E9!XY&x<%3wQnV3LQE8`zO4@rbw^2q)X-G?WwfEj3lv2^&NlROM
z*Y~{Q{Tava&);!;kMAG%eH`4OUeD`!jmP7Boagzt9?D3GQE#B%Kt)AGEq?KwEEUzN
zL@KJktk<o<-$<W!P@|%<>J>kCM&34Pu*Jr9yTa1ch>88*`}bSkseXBTy!G7aEl<li
z|7I(Dv?EE&<ZoqTpQcCkRKBmS9cFuQ_~OPbo7A_g%UktVZ(dLjjZ1@DVxYEedho&F
zI;-IR_bq%nH!F7QiZldIY^7z!^YGv8@LVCG-(OO_Jhe*s_m^MkSM2=#RqBP?tABqL
zM|*9>@>iz~{{1#G5&ure@^<*YxkFwgM66wYD3yfU?b}o%V`JMG85wD5KbMw13kur%
zxuj(DSFud(e|BnMZf@=yQMb*N6iGV0w*0&kMve0C3kxZ-6bU9KZ*OlV-SQwW{JXfN
zWvXFQ`sG)zU!P~~YWI2_JF=Db=8okjC9d1J@mYJJTdBHD3p1x`x=)EOdy@j!v13;z
z2O17&I?qsIm6OhH-MUpxK*ncJ^U95l4<9|+N|6sc?l^54*tBN#YVjQF!8g|nU5EA^
z{C@62w;(?DyZ!+&51%xHx)Og)XI3Hm@kD{#t+Y{US;@_|9ZyCl>NHCe3KrQiTJ2-{
z*E}-6PgQz5G4ZI~_kY%E&y04N&rh3)OG-Zb^5qhr%}@{-`OUHy%t8*6<Kst5pR8E9
zrug$S7M-5*;H`W1u*WFIZFO;Rk*0~cv`5f3QQ_;4TXs_|HbQx-<o(XQxtgYbT(^9$
zO0I2Es!3aG`y{{R&%Y)8IJ~5VXU;_{#`WE!eI<C{ZSq}DPtQxi{0bh7B1b|UM;~t5
z$1mSkm%z1yUC{??5v360XW3UR&fqd{rc&UXcTP-9Kqu+7ZK%s)mVA`#$I-UCYpA{F
zhH@(I9{39nzFo=6#B|p0h&tO;n@fSMg8&!XugOWjwG6hWou}K^K78=N^lHvwmvxB}
zTlVhdFsP07+Rc6Q;>C*()U6sbOt@4tjD2&4^P4`tW-s__<w|Bj!R9_QsRv)rn3^V*
zNe8Z8v&P>37I}>ConL*Q_Lx|zFy`4$cvB?(M?<K?X|L@lEGiQ7<I+6hG&_Dwt*)X%
zy1P8M)X7loAUC&Mx=EYy#56|U`_DHrNvC_|DH1zo`eG8^SoPN)8IHm4qh0=*J7*73
zU*po0ra7%E7a`>vXq^4IZ{*&+RWn05!`gN6>fRwCN3h6#`A%~ZON$F1OG`_WgEKNR
zz65ZK)h1|iJ$(4kc(2`z>D*vOX%V9f$H`{Xy9W;*EM8ii5_#zEK0cmUk{TI#IBTXm
z@Ui3KyS0oyOY=P<_Zc30c=+{%IK&t8vq%M*Hcpc<)>o94O5XhPd_Q)RscPuSR@>K?
zLWR{C?0@dRB9RrR=|lbKhPr-jY?Q2=TusfZSFhxs(DNA9_O=xilzjP;8a>u%kYMNN
zA|Z$Eo6PT8=teU&oq3qqAFI>Wm!_I$pH@`VHMDi_UPG(BKC)~_kACf*{9?D^{@E~@
z!`mORl*DDUMvsn;8fxTZ%NiTU(;vHWuV^Y%HhY8SevbD}Q!OlK&YZc=ASo{Hg`@EK
z{zf{(T9uTWPrd~4RrQS|X%%H_yOY<TdQMAE&&HMe>yDgBy)hR~w_W>vx`F(P6Mw%K
zN_=FAsZtf<wHZ=-`1mn<dTX7gi_wJg>kCibTzP%reC^1{h}XB*Vx>PmKJNPY?KPSI
zfPet=*>OD;ynx_DwcOU7I~BE^R8P7uc6f?#R0u7MS0&qx-OREbd8K{xX30oLQCFZz
zzE^p$0G)n>MxOm>cc4j0h>*iU9QfnMk00daRqQScWHD+?P0AToh*5m_p!jQ;Xctz`
zCq=hHLQ&CAEz|T2uTkSc9G^D|r*2)4m-kU<``BU;Yd6+CTEd=C?8m9vSsf+k?d!|@
z`SWM<pI`T@BwqVx6a9(E`e!y(;g{oPRa0+yJ$O)^psCsFJZIF9X5f!qaS@*#B<yt6
zk3;3gRFT=;J9j$U-5C8ahR+YTu^bc<Qpd_NV|+WgG&nL^tOKW~r|X>@*KFGL_gHt?
zGnd5~vC7KIg9i?XN`(lrvMa^=h(9}|XC-Q;I(DnnkCSP1*punpg$pGgAJZ}8Wp7r5
zsA~(9*Xts7WGzfKb-6J*KdrA<7QcKs?Mqu(;K@>f;oJjpSJRSJY})djUio<Y_-qfX
z(ACyfo-}!TdxiDhfFHi$b-S>n_PeneQjMBwwH7i=+B96L_jD&MUg5W!*SePNi}2Gh
z|GeYL$<|v+3phJ5*@dpuDOpC3cXC#@xh$#w5aW3E>{(6c=VwOg*Zcb=5KLv&vn{Vg
zNQWLtE<@0_T3VQ5r@dm+Y8N3PF3xJ+l$$HaqgQz_XI9wu*UPK<j&@0N7C%0$uSqvj
z4V=>&u8SIIiPx`*?(0t|P@I{W`RF0eN=Y|viKge#*S1i*9LSs2=seh%ra#*GnYV!7
zo}wG-lwQxrZQglt2OXW#kLk(bwgik?!BDlmy<NZK(-Y=&tI<yJnj9OGi1>Xen)_3E
zJjwU0p<ytzGIW_A5%V9k@IRtnEwVH(cSAseb)xKKTjbNHPtQ(F4L0d2sZ)IDk6ydo
zo)ueYaEY8I94gj@k9BoQM)isBh76RHNIV_I-ku(L>GR^p$ckG^vlIQg7G~-TH`5}2
z3=bzD0&d))`q;eq>3%j&&a$t6g$mfjD+r{w&a<$v#B_FcZfz<pFITJ(S;|#!b0{w>
zQ@{(dCz&{WEGmlm^kk3fpeOgr*l2~A=$0ItJ@j=*ALKjYW>a=t)6vy!s=4Xx?CiDT
z=K)W_8%mjqf3vcRrx~|2-c-dm$@Nr(X5_@h#&Yo7`ucZ7+&<kk$_Q+{h2I&Sr{6Kp
zHRn0l6!x1T8%5vv_{fj9nf999EKm6F_YCt{tPB%fo72jbeN|T0yT;+t21?|6rFBNP
zzP|jYMhl<g9Ta4!v@kGW`1#8h4tYeF4MuVa8bajA$j2&w`&vJgH>F|M9iS`G9FM#%
z8zoEGnlUyu_N=!mqG=*emqd`hsE7gj2q7dhHj=rj8dG$JnzMKdhOCB~`S6USnHRNj
zs!HUr<up!>jind}aB*=3Ca8Kc2z4$@wQ-I2`!cUzzuxQo<DCx^OxhV~sW)u!W|s83
zSoVTv(73d%O|!cql*_8GIw{8^=bo#pL|2J#979D}S=xM)%G^Ll$APh)ij1qCIPb~&
zHEb%`mQnL#6(Wj8$PQ8(P7?~HE+#G63K#@Se_cXG!xW>-{QmyhxMxT-;*O5FEm}up
zYBjWQmTWH|uMFB3{M6sSe}83~fs!=MO3H&Gxf3lVa?(ONzMDc%nZ1v4id9MZ6z!Rs
zdSc@JMy^Q3xT{eH33-YwW<~q@ezh0!X2i%vcu?YA39t4I2#6vBsL6M7s7cn5<Z+&#
zzEL213W%U4PW7bK!bDw+*8#D{c{YW!XU~Q$9F87#ci%LDR2VH4%pY~=@{34B-l)54
zX&Rf;wTe9MH(J)RB+{R_b#3g~<*8PO1gw}W(~|Smp~qbLiH(QY*(DXC<)dU=(uMy~
zNKD`=m`~ORGSmO|>OMX9O?P0Ar)7il^Ya_hW)Ry|jOh04i5bf5*j$rord0zN$74{-
z;Tsrekk*3uzA<eANm1G8SzusH_~pQGoJz`zlP2+pq=If)Z2l4=)Wka07!dk4`|7)h
zRRs%^su9B$2^x8^A#E8Zp&K@COfl@}>Y{{8hZ?7;W0rM<eN#m|7B_@#PB`{EuWg`M
z(qSj?n6wH8*2RSUs!`HZQJ0oGe15wp&FP#`%&jtKG@#t6xCP8{gIeao>_kdqy8T37
z9|D$QQ~qpUjGxgX`xL`|>R)gFS!rZEH`!#OYSa|3E)dwHVNu4zJSk-Q{dC}*`Q(5~
zj8THK)?h4^L3QL6#R@SoG1atf$hTu1DM~I~6^gfg{rw}1vwIK4@CNc2+~gKCXiSaL
z31kqmR~8Bl3X1KkjWehV3OZ>L(lx`T5FLqiiZKem6mX+P5g}E<-acEQK*`PE=A)FA
zv1Dgd%SlIJq^u?;CSAkBCNpda+*32H4#R2sy4_y_6bDzWSrg5zTONt6OUG6dt&n2i
zvUh!=rQH)&5}^>NC^@TEt*Xym9QOe(jsynuWTbnvct2r_{p~o-k~yH*F05gi{XEj~
zaihi)F-2nTyRO_2iBU>Ow;w<-O3fN1P$#Bnakig}Bo_Nz312qm$%VP$0#zaFkss#+
zcnth%IuP$!lZ3eQmlhpHMn~D?u}iL{sq5=UmnFC<U_n0!1AiM1^&?+!BF?1P=OVuQ
zxwJWsl_^%Z05X{ORkOwv89CLAmT0EucKNBsI-3nmk96>A)?v?n9_=dKD5MxA%j~)M
zm-v+no(!DB`E&6>f_Ac_V`Iz$0!^c7(z-(yH*UOA2o@O1EbOa0$<578!2ys3x<32y
zOWlemY%vMPa6X$$0VPpm2nlU^{Ogx#j!D^_(I-@;YgEIY6ciLxHD>I1H9uO)b>6t(
z#>WjYMK7?BRx}44-h_t}>`>F8)T;DT0?8uTKKAVW4X$&X*VyF^T642{CxbrL8Vvmu
zAID@WdaBzE00o;&%mYjqrd!R7>gZLzd3eI0_KPgSxvpJ4@Tj7d^TLGE=ZcDqhSqm?
z*Tyjzv}C81842mNWLupV?)l=RkzpMChC<n4A8*`}y>;8R0|GWfJ~*?|#yBfy!@_cW
zYnJo(P*+FC>yHZw8}8k^_W)Hugxf!|Z*BjQ-CRF=;sWqC-pY!*3y6^}Yhh-rhnbV}
z@|`<(I6RSD#qq4J`Xnu>J^p#_&8GAE>7Vv&-+mC;#QWK^j^e~e3VHTcGZik22Y|!9
zkdZa?>*6_m*%U@^Rhsl~)6lI5;WT$p4c*EvgP<Q%G*qzUoVBz#H^@-o8@idDIw-3G
zarwC2sP@c{$6T@LdUf%^sRniBqitdyd%ad~+*!Pq(eZD5%b^R#Qg)6{2!rvGD)epg
z{v$`q`;t&pMch|ba-qKXVUp!`ypNaHbtQr9QsCj4OzxHM+3g%0N@Ei8*@`?F{iQ_~
z<S#s-X9o1~$MLeA*NRqJ<GtF@iND-X^}_vo_f9pt3h+6E7R--I?iRAQe5kqBusJg+
zce2rd6l}ZsEh7uH5|w@r;=7}rogFIBAHCO=53;aGYG{OzS-nkF>iYBNtw7JFIfaac
zxv5g%(T%<+AFhT-OGqR~%gOH2VgJsWN%xfd)Mymjfkzvn;}>WBQoe+WXlmGX?TAuN
zdR5kwl9IxVIO`*Oq_^Ny`eFp_mMzz!<HpA=#oP|Gwo>{nzdv$XT$~%GoVmM(OdSwE
z+i1TX(~|2M0KpVHE^ej6p3A#Ah>L|KqTa+gv#B9PSAEuKug^Zm`(ItBr)~MnJ0F}d
zZqEGLk<o1a7$s<2efE<*C;hO5t$ia18_J7L?eAB|^z7j^RMrlxQ?q!Y@Rs6}Z0Ew(
za{k;oWg$O5ze5cT4N}7fUtgXv?+LcqY0n`dqS<QKvk&Et34nI()(x?m1se8~1HI$N
zwing1IAL!XMRTfJ^r0y6N9t^B`Gk~td18<?zOe@(ZRY!3n$Ej4!cS47OJ*3iyb<$c
zIBxsvn%=ip=fjMg9349cGuo_6%f6L%7;M5$=m9A5BlSOmhLF&9+L@`=xOiKU2gz<!
zG3z$c9r5wku#ftxMI-p@b}lN{kIpS7KR!HE^!)ho<Bn{XZ|O!&+VzRo@2BrRW%|-_
zwl{*eX`n74v_{Kea)5QT-<H3>D#EiyYi@GTLR?eplY5f=K#NVAZ<Jg__8XDc)<ey#
zD2ds|mGN{^bR;#_B6j5C?a!V(DQG_)DL6Nf;+KwEGXJa<n_}!?%&O(P;)(BHoQxY&
z^}?3QzkKoODDsp<T$%@*7zLszwWttcA>iK;QSZKn8w!z&w{At2Nh|Wp{b%P%ur?%V
zxw$inv{s4Idbt#==z3`K;pKSy+`;qDxph5ixW;N?Rpd}bsC9DjZrXcFCd7GGFQ$kN
zfALcwFWuS9^w;-yl`%?OF-4-HqFwjtG!pG|Gc`F+6gFt?&mCodw)!mo`kNSIn!O{+
z8L7dX(|FHVhNdiwh#D;o4Gq~Wa~*&8uv6*6eB9Op%26sQ;WZst247OTp^nsNz5L=t
zlHd~FN7bn%PSXE~-|bRA<QKcenI3iPrDIAK-NHzZrHJ=NtPWE{X?C8eC|gSZS-Ccr
zp<tGWz0c*XNAtNn!Te8HWz#2dsu}zfekX1+Gc${$93v;~+!aHAAVhXmsZim#o8>`K
z2%8az{BcN_ubdZWbbUiZP120a&6A_mbJ7)>3YHdgYSLL*S^ENXL#`mL<>>>VW>3_r
z)+{c}#ib)=$fF$aOTTmXu8{{fDUY3XZr;3V<e=lA<cC#4(g*plb*{X)SY{dZAQ(q0
zC4^)n8_8d~<X&c^nr^5PS%G>##>kb1(U>RQJADo$Lu`nrhle69Ev=tXW4cicI16J7
zHS8wVYE4osra$!b<T76zXiO{BpF^bB+1L&0D7mp4WvPB=u~#$>Ie@+5^0+a6#ikaQ
zrG@*Az)2xx3)4u_H4kVHaEwJ8)Wz%fRY&>NSpzK)s4k_#JzTJqudsxCeIzO58{fcy
z6BZyeu5o%Gr6P8AxH{@t&Fp8?6)5c$wQ!cw^({tzd?a*>JmS6_;sLK<kCp9z1BQa>
z+1Y67J-qd~>6Q@_{dMd>=bnr-5>c!SjJMN2V*3x)Cl!XR=5wC64K&IyY>=fyL<H(v
zU|jbbE04WRu1nS_jh(eryiL%{j)q}Osr=QeSCh1I`r~spO!PdW!eBMnPM*xDH>)=v
z|9K^*F2j1Tv2VP$%C$*WBC5@K?()p+EPw9J=6%=r3_?wEM=k`e7zZ6ujhIn$XZ6Nv
z&^}QBt+DBZ#WD0KQ#@ryq0@By_A98a{lCkWC&#b9UnN)PTaF-j%9C-eL@%r3{lr~-
ze0-G&nj&(HdS5_EqKqn?pBXa}F0dKa2snEEPJ3WY8A5fdeLrVm2kXNe=lj1T2nQ*~
zVD~|1&}H;9i+N`;ZD550s+eNULmby8UHdMOAQ<8}DlXbKBX#lO)BU2Z$}KAgo3kvA
zqu%0kS<G!Wi&f1i?_*D){F5>{LvYp1L~UP9OzHP`cXbBplPX_}(Zpzu2v`q1zZ7u%
z<ITB^J2{RDhI{)IEvNT*+TFYL#&)s~ZQZwzv(%q!N_pw96L>dNsDG2Je6r24YA7&#
zxG_!AIJ12X39^q`h5*t0g`H-LL5)fpawFx3O9iuSJ9O#rj+2=Vy%hi0p*jl+Asq-}
z^<Q)}xO(*kRzd8>jT?_zj8Vjlwk<8z^^IV4vh;7=2Uu7A<i1;LOsPA5=Z+oBgbFL0
zJNod!Kx>{V_B}fYi`1B59Hded9NPF+*H5wAbO*=87@ZCho-~NxswCc8F<y;TJ;$1J
z)N1ZmAx&3Cn{!GG=Yf(x;a*Zg!W)O4E?YAtr?ac;bE;ldY9<Yx1f8eLrr1;;;58nk
z!--O^g2>lmp3xvQNO=S<C<1(0HEJsPiVz{{jDEl&4B&PC+>n4|j*5y(9|%2t?D)P0
z-B1M{{p!QX`P}(ul_R9~1vb4{*l_*YwU_!;;ZMks<F^}qQ&LhQi)x-w2ZUr``}^;g
z#S3P&O6xX03Jnc?fqgQIb1$!^7F6>2^A&$CO+_S88IpwnN99m*r|7fu@T7gsd!jb7
z<2}2ijLcK}pJ8s*IOf%)atG3vkdjhdOT!=!=0^^}SGKja)w&`E*&q^Af>4xx896Kp
zRW*T*R^Q*Q;Bi@W#K<GJ7QE6;&75Pu7hm7=Xa{>Vn7L>ax{(OaQ6D~>^9>G;`_a*%
zfGBD|oHr$3<gss%-ZLQ~!M@W=tQyRi0+JCKHL`_#Ag__^%C(zM2>Snz7@!kjYiAb)
za_mEQS|+>G_&2c<(4rl4(yZzq`<E71JO{<dLE@CBQl!kgA?es<(Mj+%3WHHlb|oN+
ze)=sE_H+rj@!<ab?>HC22EMc3L!_so@{z-I`5|MfS`W7lj^<-`F;6vH(6sNkwEr!k
zovB{#6+mijw(pNizFxS-e_{mGT``glTT)Wek^YrBd;Tb2U210@O!P*C?wq@;cA*QK
zg(cLH38mh_+&iM{Alc!++iKaC;tY<z&g|yV_aS_DbF0Tb0c`}`(XXO3pSw!^gO8r|
z(QW>)Z*%*hA@UP4lk)LuDz2ONvDvgaWu)rYNW6dlejwT(CoRWj*bjL@mh50q67l;E
zmr(!3aq1q`M)HG?y1TlV0gJby8U>=Kqxf|8^bpjDZ7dGDHNs8#)#iQt7Xc+GPIHr$
zsd{qjX=wbvewCr6700dzbSMrJbvww<e-)_Z5P<&puLqLd{r&91!opZk;KJ4)cm)3U
zo5{QKDDvFNKRRC~q1^}C3N!(G5ANQ*n=qGAQBffL4gy)5qf7%C`waAF3DAGnKtl>C
zX8Ewu{n`~zpT0dkGxIQGs=(%8NkxVKf2lOFf2xD!Dk{g?i0B9R+}tF=s8CRqf~P$c
z78bS@#lk=T{39E7cC|RDV{9-<q~r)U&zNa@donRtas@z&tssptJ;{#xQKwe7*CH(t
zrk0eI4L}`xh3w_aLxc>*_8cAZ@%5$XC?mi!lL;cMNMo7-3r>XZg9qynb{~-yLisYF
zAMw3P`72H6?``w;JOMQy9&WR~uk?}3C_(3~c@8=_VaaA47x*l?-NCb+(tAUBj6)25
zSIii>rMERNClzTdzF^TlVs8&<J4w)7&n|4x{j(k4o)6k_O`VgEPX(gG5hO1^Laj~?
zHZhBcv_(1n`~;bT-+JIMSpBB}8j?70%m)vCh;rI;t@rWoy+K81rf}Pe(%Gp!gP_cO
z{J1Q*2xcVt3~Y|9SP`4ii3wi_M4w4InEusHHb;b;q7u{FO1eLr{m2gws(uMQJ-tzK
z8o+F6gTV5B{`{w(b1)|d$0gTIyO|IX{XmE}IMJ|+(f-ee+u-3S{z{QNwLg0^6GA&<
z%H#sTiO%@XZ^w}z^-u>j&9VH?=Y6J%c}r?Vj22|W0kFEG^`{<HfujvLq36A65AP+E
z@Lfq}|MNA!?SISmG$@DzurJSXy4|gDl?qumWB~aK9(!3y)i`dtF7d=4$@=!=pWCnP
zxF{v%2j=}VAsR^0BKFC&#j5V}YfoV|Bomw7%MDNd=R~~Hx~=dXTX+=QdI^}{L#V~g
zB|`zAd_k9g1_8>1!oylJ^a4g!+Elgj_a+>oV_-O9l0Oq3tDd8H!F^Zz=pue!rtpw(
z40darG5K?te6+}z0jxCg7iSIh>J!7NnoO!Ay}ksVlqLiRs`Ip}Cb5~*zjgQ1d_6dw
z$g58Ybou15j~v*|8NE2U7`{LF!O!3^f-4V|aQ(%xJeI!++or!bKQjufCTVM%*=r5>
zbb#n^<QbsmzUQuZ)y(vJUsLVG={aup<J=6sn}TxNwSTIwM$&nvi;e)6jThWTAN|>8
z%4BFn>?9H&q*rz`2N4kwyB`l(h$vYJ^6;elmag@Gwp1eP!Gq_BEJ+yGd-w0}$Wq4w
zX_p7_k;JbAGO_v8Ss%JTv+`0IQQDJ3JzJiMi77V302_w<VJN%*2#x!uuGN1&^zfD8
z);t|>QI+5(OSM2&`(tIqK>-P#JnFMCKZN1;ava|Gg4c)*g+p5NOD9Z)Y|72cG@cu}
zR{Uphst_);dn+kSOh`8a?cZMJ{{3e@T(_vbYsp;uul<3F>i;>T$L)=F4r8@Bso&Eo
z{r}?xIITkQ@dh%vBJt4Q-yhiGAp}-PUxcWdo*hkZ-ezuL!OX=a4NQL!1cQ$(65N|N
z2d_xj+1n<*lRRguv%F_aS0J@U$wztHIyguIuz}jV2yTmz`O3=A<r6fBc*=?r50oD#
zNgY6oQA!C6?S6O7&CQ9RXWso~H__vRL|inGZP?As%t&q&2WH3f{s{I^F?{Cd9g)oT
zf2iEDV(0C%K#~W*HJp&w#VI1Dfx1oWFrvd^8{WqO(Mb?-6OgtN1U*FYr{u91WrSNK
z1^ATDVKR2Fu%j}`bU+PW2+}3M9Ynx`*e57-?$m=*bj$B|nNW<NOoR9=E)eH}mzNhd
zKhh@Qv%n%sObxYAz?aAZwc>D(4crz2F(rocdH^Us!mu@0Wpb#6eeLGG<ZYyBsE?fe
z9ieV_gU8YaafH%rX8;HUu!I*Qq=K~}0#-u%>BZCp6s)iVSV1i!%4^(wn5g;t1gtME
zr}EV&|AWkY#1X4Wm~);RJPBmsMUoce3LU~X#Hw%uGmngK31&KZQVH~xiAtKjFA*%k
zZLW_iVf_>SB$AK_8`6yei7f)6z@a>cDL+Cipm2I)-c=I95W<SjPB!n7P)XK)h~g^5
zLHVEGA?|iE6ABrUJwfYw6KnuhfQ2MJ=p458x2*Y~C~~MIpWDfy{5J^3k#W<Pw11vk
z@{;60lnxxwZjv@J3ajB~4nij$8Ba8PgrxyOC<f8og@Q1IVe<+3^x<E`^F?)<&t`Gn
zZf3knnuK3-pz4x%^&CN=gO8s--<1X0iTpKjXuN0N{*WqWm$cA?&tb|YUre>Vef?q4
z=Xc4c1Th0b<WK+D*xQg2aVbQw;kD+sxt>s$PVg|kNZX&4G@Y0Ms~Prelvw+pA$t+b
zfO75)d4krbO<9(`-c7Ul_&paa6rp%#P({t0KU4qY&jgwOB)Jh}Qz<k|4w1#_*QIlF
zfY21_P+=m66lYoVsI@Yd?EKFolJF7)9$yMNbp_zKdwfz$OH1edz4gaYCN<<aWc;sO
zhZD>~#A@&uB`7-&fF#|V5fB*24h>?t+Qj7je{<dZ^vLqGfup>fVS!Va1rnP)gYd3B
z)LXiC{wM6qNPGr$!-=BA2Q0*{_yXqz`z#PJ+O4^EM|SNiVgEDiYdSa$$1Q)#*kL(v
z3?e=ZT9}(_*T$+GH>^L}kYkgu=fZ>0KiHhA-UpyWT5#l^;Pm&q-cO&(bXt=tgy4l|
z(!#6|{fzhSFWLC#vt?qr@~6)l=S?W`p%AIDAVjsQNuC0<BKH54>%I{Y5W*S`XSy;&
zQ?6agCI&%eR6fI5|AeXini!}0PQQaqo)7}ieML!-AcuE7q)DtRf#ksgHYF%qWPg6>
zh{SHZh^m`HLP_}LJ%n^4NS941o`Z=A$d90TLUWS{0{FR%Yh9L{Bc8mA1u*WdiSb9Z
zd;xmJA;_Fw_`k&c4Ld$S`Ai1e3{$}ojoibiKAxdOD#r31WMh+nor?M7$-1f>nQq_i
znXdI9eEgwSEf*<f9iJ)_uZu=qO^aRyixkQPZEfv~;0Q>3k_tMtpVUKxO&O(t%*;YU
zEmeg?h(j!S29uJ;)eK`!;>7|+6bHT8#Um{(?T@g;XZGXXhfkkMP_pYlJ|&t4%8Zbf
z6#|)af@So_U3uOt(X+{5mU^2q5`a!c2~NOP@Ok=lOO#C5oi`B?q`)AbftTncJabKq
zk|g40RDNz=9>t=kyt2T>MXx5>7h=mL#OFh#Dg%urju9Y?7o%W4c<9iD<uF$l?+aO+
zWjJljbpDYdo|@I}x`!Cjw$jq>2csto@q;Ya%a?x>2O9)Ck}OCe1<6$#TabiQLe>Jv
z+i5r7j@c(@D?@fpDRm>(iVGQrfni6<Mum`4l)N#`y+HWqJ>VRuGj%|H!d2~xTxbuZ
zte~c*_RtDJx$oCVPWKCgYS6?H$O2m3riUp${EpL!n1>hH_?PC{#yUvhd2p%_r8vAO
z-bWT2xUb2iKmo@_9%zwbzxmMvBG$I^9yoA7eUzRo?nBwv7pNz|3xY1S4iMHrnW&F^
zrvLrzKP62~O@nh^qvTk493~B|a6YT%Od-6J(mMv#D8G{<We}@#gE}CriJnb=?|}>M
zGGHSWuyn4CrQl0pBnXRE&4>@n8X>|n7GXDo3zq4HkVCp$?Utg734=(Sw!XAF4LP^X
z`;H6NvNIn#6iv!$tKrs`sE$4GSF~uE7LB~}83y2s1xYI;yjdcP4YZ@!W2yFk0v>xe
z8RwMA7C=HKOpbM(6HEh_7&A~D#w;xiyRdO{SN(ea7^N=-MzI($CGC}Uf`Wo-P9q=b
z*dP(=X>pmN^5H?bBYMV9%0lLxCsoXe3NC4~Nu#ilG(lww4BE0%szFm%gPm<jrXegT
z-qfmZ+E-Q|+A$$vrS|CR@kyt+DvOrCDx~jg$}kDzh2Z%T_2JO3e9D_Qk;n-NA4Y^n
zK5S#-<7;SNB#tgEPoYmE+@E(BC1eu1FU@{J->pcm6bVosCWfHnQh#x5xG!7&xM=P7
zZ?EKRuXVrDu6!ddaZVofHnjh_O*O&Cbsn`t5AUKJk`5Ude>~5wp6{rFT1owgT^=J?
z4qwPs$w_qe`A#|6z#Eb+d$*4m-d1Sr@n<Q?H0!7a1FvqK>m#e*kgOApc|5Y)1xURH
z)ubA~GsR~X%C`cbRAEQW!t!coJz}Z*>bw6J*^7WsLD?oLH_MXwY7tuqM|>)c3qJ%Y
z$R{CztEl3jm`7-wY=*IV8Zvi;=a@crhdx{!gsI;A#GmT%*)X3mcw=l+e{N@Zo^{x6
zvO!k?Vdc@IN5|Esz_1>(jK!*j5pKV5;rRrpI#yVlB67>YFX)4|Hr|sXD}gnNf#&8P
z&3E`m*6;P(j_;a4ag;M?8w~pu@x4UNnU0m6jKM+8He!SdOd-6e+o#wuyB9nk=*@Yg
z<HF#UQU=i+4KBWMwZlXL@#B3xb%2S9Fm&p*ZAfH%&YO=q%*P)Amv2@QQRrTev_eFM
z-ecRYT{-Myt|2H)<+(HX{Yq{+X6~C`WR~XImM%T%g5x1|?o<uTVf%#atK~&Jl!1c^
zO`d|YAl!BDWD?!sUIt$NvNN<5tCT5r&UUX5VWSXya~5o|eNGK(Fl=LylF!P@GH!E&
zhm^;D{8m**?ZodzdCXG#l|3Q%6{wb;J9#rppd1yDCVd`6f|ZHF4`!x{P~6qs%;sYQ
z_?(se=rnBK{aPpp>Vn}R8di|-PnU0>50fde8=0mOylT0D=8GEP#$w>glG9@C&0oEm
znThE=CmqxI8Jz#iEqm3^`2eb4g%_~slg9TjHwLyH7BU|eRw(L)Xoeid;t;iOs(wV`
z(j|FRZRWQa8JwrDd*<oM^tGM53i+Og$9i8yRqX!Sr#V>;)NnNAT;qz}2T;6v?b;Z?
z%uGrF@*(O(PLELWn;x2H?7*|P9RKuV9@ZW<kSV|F*C!s{F2Tq3-_c;JSiJ?!Gtg&l
zE|iMh8V-XzatXtGOmf?M!`LZ4gy2MOt##h~DD&i7w!yK|Z69k~&Sw;X48N>y`S=07
zuw$lJn=M^2zLDso?IZoxAvdX$Tm>nqvHM?dW)S>YyC^*UeWgd}N_Pek+A9dH)i<aS
z8$hCL@(lgoyE$|2m3DKc88btuPN`p()ur=b08cu$J;4$=boTE!PiP;bR!jK^Y}(d8
zK?kz;*DALXh~oK21s4gFMMSi>|G5*`*L7I*RnziT9eq=o=xXWz;zcyrEk5T%yM>%#
zD<W!12!r*0AZOlG*L7rW?2feFF=r>TN)LkZbz<lXydWotlsto&4;auk#9tL5O@~BS
z=mg!Xgg7t>^d!z{0u_nhnI**bEWiwreO;Tj)9S&#(u~6&-sg9o;^dqKkLd&vXeY;y
za*)Emw>c}NrO5#j{Hybi51u$tegF0Ga3J_()Aq9?leJSW_df<lsEB?_bPY;45xc)-
z_3G86S`ZR)mo5D{63A~Ajmo3Q(uMAb+EY!J1qDLa6KS~<o@*}v%0Of3bDc;T7LmeK
zJ}lr4ZbvLY6+fSU<|kmr_)trejKh^HS3ncHGKChHw%-YxREx?yc>(?<FC6E>ut^$5
zVGhJ+|IEx&BjDH|xe$Ji0&ElBh#DuL8NSz1aL9g{MtC=EpfuMx<#fXU!C!AzlF~4+
zq5w#BE2tx+G+(3zdgCQBX($!8+s6u)zpE535WJ2&jhtney$Io08=r5E+zF?<H~fkh
z!A@Ob#42#vL2}VXon&p~QXw>T5q#RE359Dg9gpJll!AjI;u`V3gE6X%ymFw*$hx=k
zJQObB7^|qquga-o_jf3Z>X=Y3Ky^*ltzaOISd`Hh5wQt@`Qn5g6LP=QFc<0!>w)_H
zEYcx904(dNseQAp`X$JF!>|(GgoBp}o~h#Dfi!750cYY4M`{k}(?X&dg)&%-U27!V
zmSv$Ea7@d!-GG<Yi(o?3k2>IX!auE{>UvTnvL@Vsxb`-=Y_bJC7(Qn)RrH>ihdPzv
zOEt=F!D)`dR@&JxiTo6Sa_m~);z~dwB{)l%8A=gj_ZT}s^|x+&P~X&~x-i}0={hGP
z5ru~v2&_HdJhtOK=C)a#IEiL$jZoaSm=;o>FCQdUxlrfX&+<*kFMaStbDGVQBY}7w
zKGlx7QR2LsdN_FjC0cZG@x`jaA~-0&f4`Qau~EHzISA3}=uvldcSm~)&qmgFC>A(7
z@t}Bfo6V9nG>pye@DPwkRw`SZUs$Ngn`({u@#Dv(G#nd~sfo2k6)*CNhDDZUJfkKD
z^NK=&-e4e0xHNIhY1T5QLf7&B(?416ma2rqZQp0lUT<a;j!idgcvTy(9>Z%`{}PzH
z2Kz)_O3H&Cj*~L8>UeckSUC3#VUtJ;&HpO29v+5uPT}Uw@OI}%8(TM&(1^@mi!1|~
zpa7G*Xo3;|tvpET_7Uk2L6s)Nlv%16jxSs`bSWkruvA^{8XPoIVkBPDC}9ozUdq-c
zXLuhjrv*QM9=T@o-dj^<M8bl|b-bpoN?HWp%O8Yu8oS@YH;u;<+nyK;bEbMoPHs{9
z2RkGZ061qBwl}ZdEr*zx?sWA0=$JyD+huG6gydSzvtq@HKG^46=ZHByhvvVq%u6HI
zCo2>&Sb_xmQ2!;lte%>jOt%v?qrJkFH|`yk&uG_4TR0~OhO=;?ew!a;j5e7-FoQf3
zF9Nc5y?{?P9qDFbg`&!H%^?nOySx)xt1fh_oUwx^Wz$p&63mUJahMoUryXlHwzf{s
z?hOyzG+Y>L)2i3^OcXxkboR)v?aSG-;dN|WSar2La1VRoT#EJJRk;NObvT}V;Qk6*
z1b=G~od89?p+>l<g4e;L4MebUW((jxz3@#Cx+j~Z@r0J5NB@-pu+plxC*T{20*>TM
ztpNQ?yoIiF)}7R)s6RGM`1<-P{Lmb8UtDd10yX@Tad*d0M4xZg$WFX(+1STQgS%i_
zIOdppLrY5m)K+`GqmvW$(kgo?DXFBQ7?-6**P;X;Sx=$K=e=4tC;f%y;4ZE^W`6H=
zk6!H-gJKOGBWhwA2%jYKLHMlX<;y(t8y_>lbuupx-(>sZz=9?3@ArXKep5yh6o$gN
zE!($ivz;&jm8(9ujA%yHrW>9gzkvg7UbN5VB7RbIa2#YaF)l_*fgcha`@$VQ=hz>Y
zvB_w7c$f=ORx7CqOx!O06rc~+bS~3@`eUSQ4nw)B9i5Q;G8P+?Z1i@1le`H(SorDV
z{lOPN?>Zr01Pk?5m?}EQh$E)mY%i)O;rU;pg%cZc0bs++??VjD=@lMqcON@pP<*QP
zsabYh7(~$k?24#tnBW5E=Y(6IlSUYHy%=X|;8cMyYBkM6?A;Zw#pTgP3I=8bMpr^Z
zQF{{a+vdHeu4RUNvk;*25nH9K^A^UjgXFZxHTI#|qMaY1j=1rQEJOF4G(IuE?E`WH
z+vE(kjp!gX{fUcE*|Z})9$bVe1m=Qz8JNjZ+nq}uB_A(nW<GI3p5JE3Fj5L`K@PRd
zua==8^1S{1bt9$Dojd1M(E`t-Ytb*{u{{ihzA)K!A*1rDC1@5nhtF|5Od&B!OIfu0
zXS%D8Z1~yjUM>l1!OPstZ1ogbycI1%du+nM9MP4hMN|Bg^AH^!oo=SbfdcOhR3PCM
zS^Yypxt90I#%D1Bb{46&BRAaUS~AUEhYgZN9~is9l@3Xh@G0=6n?y3Wvts|LXIl@l
z<>%+S_Q4T%1%tXg74ZD|t?4pR$P;Bnz{vJls698OA)*~X>(Md!B0pF%=!Lmlp$MWX
z*gG_*UoMEE$o)EXKtvV2IVm=%>j(~N2@Q}=K)cV2p^BPQ&Yvh0%I<i%q#Nhy+*eV7
zhKiLv0v6MQL8#9s9lm4Pfx2CWu&nr@suyUsK|~H4RE3v+U<`Tuq@XM9feR!-QP5uG
z+W$&hN6$G+vMJq&x~?Hr?^)qOh_F-R*U9rv_TRo-MPcEMeuct`cx&{RG-O-FwA=6F
zw=~Thj^XP^G&t_Tqa7k;P<+K>mG{jzZ{A?PjMuIm`Y>WaLqajl3aV7yfeP=#RYV&s
zTpDXGa4Co?IIdpyQ!LJ)CYqUKPI&eLD-s~NgxLOAU)b^UYuH^v#1g5H&}8_QUCsyo
zYAUImH>Z1j{r-cj1P!%8DAgw{+g`t_eGnjh1K-|Y8vF|L{>_x?rR1+08<#h_R!IrH
zd1uw>p}vYH)wTjwi+L)l?7!dMIS<tiFAH8yZWd0ZqiPXQ(9b(Z0|QYfgAUSz6*X#v
z^m*}H^&Mn%8uuc)Fll#zd&vvlCAT4Fxe#B<OxKZ#z8Y?|qMs}}hA5s~f{s@R&AfR0
zV4x|Z!Za9U)TuZZT`lU}MfB#ER8&PT{L<T1<a5762`Olq<RO}A-sDxHkHHNs3a8W&
zxQw>$+EpCKLiM(6UE(z}l%~7mxe?d{PMN(LTdU>f-MUu@GEy>}wQh4{q$f;TmswaQ
zCc?*|v*R<^B;rZ-1v?_pEM_ND+wCu~D{tz_gJRIBYDc$P(4RCm%=F;)%nCT!2BORC
z>Qeb9vXq_Alha*qdlT}BXpN$-n~p7r$xz+y-*WBUdtZ_Efep+HS4-g`(t+G`9QLJ%
zNmaZHaea10G)RNcBF7&60|D7nigs7XbLC?c%S?kIUG&g=c!QtZ6W{SAVL&6(^qpxi
zXa|A+JwZPArMKA0>hU|bwziV+S-eeJ@Oodq9TnA7`^JvMukB^7w3G8czPu5C7Gy5k
z`h#>25uuJy;i$h#QK5gRsHmVg`CZU4bMEDJB})9~&t~6lxpR-b(9Cyi&|3)18Zm{L
zq-xfNxAtj&(OY`9*x0!J-}Q<3jAEb!#mTw^s+ZfzM!8aO=MB4qv)Li^%Nb{N?VN#=
ztmWt{7ZH15SV<aC%fdSNmD9;@CmxsO4T}iS<gVz~ReRt!Hz^cZAA&Fq?~K$QQLug>
zv};Dj`!)8~K0Ow@zX(8K)ppVjh@QV<WY5mo{)DM<Qz|NJCOjI%qoB|#(SZe9dk}NP
zq1Xyo0tU@uByzFljrg`1U~X-!17#>PTS8A@bI9WC-ESvbnQlx!31<(O+5Re}a3vfR
z-QD!j+qP`^K2n!|csVM1up1Z@KS)lb33)R%G6qDCTIURWP0<slR#4Sq&t36bVhI69
zP5RR;fuGSf)R*pD1d#v%gVSm%-t2y|V1e4ZFMF;8dzc}UxAWip%guWi^$H)^tM_*)
zRrXGBQiIsJ;#a%nZ>HrwPnhong*H*$UJskd&hq)jf8qh*Nc=gjUA!d#MT}*CZCRHS
zo^(|)L4%X186Z0Sry^oTj}`>6LeT<uvMJAQe4?huC*H>!grle?%jnb;9e4{llV+o1
z7F;0!>Jj6E8~*Dh*V%#;>?#)+wv2p2x=7J=u~)=d4MdWWb4@w`LFLOcE8S*SP$^gS
zNKi8<g&g5mf-i+MjlpnRic@v~1)XIt7fYH^lOhN)cF@MwDva6e(qpA6l~q;9Q`JL*
z3k#%;sqUAOvl=rGPtC6dQxI>#*4z4!;&#Qq9uuswGt9n0%@>YccEED>gofUmj*%EJ
z)1)g<z6GP6fz;4NtY%QDB!TUdn#3+#*m`Zn?TzHzeTldW_$)a2tmCHhzFvJo857H$
z53Af85NXG+y`>^FFX?LSEjV}zf&)2@P_W-e4f^fuGIQqZdw+kUYpdhq2ZRcT4MzP0
zlNPvR7LowvBaqsq9LCha+ZI~kIYE^f?1`@KTEEBZW3r5ZH7DnhV6}<Z0MiSd`v$6O
zt5)pf04b!CSx%aJ$#-qM(4m2Hf;1X7fX2@quaqQ?mfrfL*Mx)4wi!Nx=G_zX1~Td7
z-@1U>D#l7<iD?J*DX<YdUukw@PM}U<WxgNAk6LOOLa;8JG_3z>x{rITT3uQ6Q<Cdm
zx!T$-B?%jLuod51zim?;a+|OFu488drFH%~ZC7-;`MMbpRG}3tB|q<Y*=k(4;5v`+
zd>r)!F)<@Sp8rq7ApF!-gVsnnUl>xnj~2KKfLq6QZZ*v&?DVEO5@4%l(YBO^zwM67
z`R}PYU^%}*P489HNIz!3U0Ul9T3X?pS)V|4`oJpX#CkN}wDW@|=9w@Xs3aXhfUO6>
zED-~qU6-#CdKp{fRY8YZjQ*5Z+wE@#i!TpSNd%7?{Qc^#{gy+`h*mbel^^lyTGn&`
zZU`DaX*~BviT%^H-*KWw$-K9cxrb&A)ivB@z(MrULJ<Lm?c3#tj4y>iuL0=DCV33Y
zt(%!I;5;KE_JynCOD-*(v@wMX&Y*S8q08lza#sjyr34o&&X$_CVNBc;rMgNR*RMZj
z#Q_I*uW4KS`{h)xp`s>wxZumGDvZGT-9;)YkM9i1iN%n6K|$@>tW08YfQU=}PR696
zmYfW<dlnB3c64-HUScYPv4<Q+9~fI&WPk?y0{RkC**A`rwh*%xJf*JAGB5FBNPmaX
z&l)~w1pNVi#Hyh|c>Rrp^9|~b5bZ83P-g9#H6;*(v`Ot-m!yN-xs1c4&Yr#V;lqbh
z)d}oLWD5r<?W}uBo9(nZKK0w+bij;$Vt{nsUsP(3rLXY?EVp=ke+v2On`!V)&a1^R
z%k+&W<&J#Xa~zG8qE>_qAnmO!UGOPd|77Y1c0B5sqV~Gru#Qi;MPh0Nmko*pU-+&O
zVd3WkqkptT7gZ4j<`>sKDCDi(9XJuAXcwSoC`4J!)!N#<GzFc58K0HeZcij)P=-|t
z*((i-chx@S)3KutbKHP=S7SjaS$$vy)u}sFrJn&dkqg{V*V4T5Ij&|hJKifb(|G<L
zIBL&nIF6j3`T5$D5HHqs+_PgXkjqS`omnoJDEIf>7VqIxCgk<=nVJ%m%r8Q8(H0-t
zp8e6OtQYj{Q9)NQ3?*p$*U8lQ2Yu;ptDnS{x!1HTA2fINQWQqnPIn^71kTLTFI9>M
z^IKh-Kr0m&v4=-xQ{DDveKbg{fUK_((=Si;^!FQN79ie63{Rmb(6-$x!D@wFN;*^B
zW+z8RuE0TbGt9cGvQi#W+F-OM=<dP}XVgP`>Bq29sV8h8F&Oo{d=Pm|>(j0w?&HUk
z)xISBkN_`QjeYtW=D{fJ%H?0=YvSA|#HU+hSy>s6V=m-?o0$o)N=q@bu<UVGe`HVv
zS_oE9=qX60eF#YHPCua_qb2-Aa~lj=u)%9S9PBq;W-kZc(a$dF0NA<CK?aWKU9M*{
z3xH}GYEb{BdwaB@6?s#}4Ct0X`Xz_qJl#x?_(UsGAEeoJ^z9JuKD!pQkDad~U975T
zr_t$iIgQaDuL<33;(qSjL~m75wKF?K9)T$vO<0#En&5j#gA5ip2xN2y@=ATYHR@Pu
z&xY3Ygd<?Jl^_zk&Z=gaQ~nh4dZC(1L@b;Dxftc{?tY_a0bjA=Z{(afH1nIQN9+fZ
ziUx*W6Uhj@Nv?C#ph+bR=U^>8%CiVEuLiaSQ498C$G*vHk~pF6^z+XIe59Yv@VQUr
z+M$$-m&J5$%CJM+-?4M&&07QHTicyCYyo?}{gL{|j+I~2QQnqTFWvUo%Xj1FourpP
ze|?I4IS()sKAHCxoFs*G9I(kp${30O%gaL<RA5((mBGpQm~ICrIJ%=IwiX$8|7ZuX
z+4sUA{+OjZitcJiB%7utFlv2}S!#^ed?#nDtVq?`(y<6W_EO#<?8W0wv4ohpv9b)}
z=EN87ib!xga)VP~e?E-3-M=5;EEj~1LUjBI)g)doWNIR%`Ye`C((%b-$k;ET4I9=O
zgq1E+#mRIA#cEWDZd_Fhu>aZ23(s_JD>P!GRKp{ofTJzBcMM!y&o4VW^vGE6V_YU_
zLLS#GEv)1{aqH{bUkgv-Er~G{V1sy3z=Ew>yH*l!*qKzs@C?+piqSAm$TUl3N^<f+
zbWn`%dR&=nX8~W!vGLN&>DoFvq<dp8zvaav>e&aOS%VhkNYk(J#yXI`@J$OP-ymI6
zY=&FW`LEH*OS+Es3Rr*nwXpe!W<CebTq=ih;>!<pVGt@tp#X`83Oj9@*w0j%ZDj!V
z$Wy&3+X3RH`)=+FJCCT{iVTI9rW8{@*qVQ$B7yx0qlgBoL)}|ni1!ZNWxJveFcBxo
zZd|O<Zoe81+=HkVpMlL42dE|46#N4#IIL&L$j|k;VZTM@y;YY^u8RP+ecl)GmWb`(
zX$h-)MS{eTH#kqEDcY^k3Cq_7>L<-W^$)qYyUU6?P9yK?>=cS?DPo30N(!IdBVZld
z&X<j993Oh=VUyXsA$#vME_je2w*}}6qD9*u2FQYB#~E{Cg6tB$N5ps}qGdNdlKf_1
zv*LoOo%4v763xc&?x0JtpuQ&Dc#3HymF_RwN8uKHPP3_^E|-&Z;Be-htL);MTiu08
zw3^KqC`A3@>**<-q_s5cvSg6GfK$YSTN<p|oTj3X-eRy~k>GhFVM30Etx}P^L|13$
zbA1O?oL4K(&`vr26_Z+#aECNN6b>@-nSZFZH$?R(At`C`jv-LDlWPDB0^6ZOpQ=RD
zleLOA=V+R={AOG?OBB+xZ4CYU$MlYbHyuhS{tKrfQV`+9V3mEIznP<)(2#W_?c0>M
zZ=eX$Ip0rQ1xNj_@hyVg0B?i~aIoK{m~Gk1M9llvf$+*GpfAWMdI3C7F<4smP^Za&
zSPU63oQ>F_5J%L|HN=WK^5ld8FB20X8{7GHtTy{~&oDC)i!IDrN1L6`ox68JukwRw
z9_ceho-@e|iQ%}KTKrYB&cecim{hD?ju-6%@+Mz{$m!_~dk#e5%G2pcaiZSgCLMq3
zLPm!_ZnD6xvdY}2si{fsiRtZs`vZpm(q5y#POFICR=5Mpv%UQ~hSxsc#O#D*frhrn
z&CP0rJqki(s2`M-mDL6wfP~!@?&Ujx!T7_#Q)rr(%)eH0Y<}y^l);;u0dWEl>B(g<
zz0SepHVKsK+L^7O^*ZBohRokRaF>(#j9Ri2bZiL2BfVwWpj>VzP^UjiXktEt0K<f<
z0Nz%KQc(@kUi1AM9$)kgF-p@EYGDkWeyYY^K!0}jhy4nKoA&&5{`~pR<bn`Hy(0`N
zp9$n4+<8>CjvblJuHrm5_hz}D`ouC%=nP9IvaZE0i(`y1jPWYCz;ry?`AnMMPX5zj
z%Cg}J%)F;Z;qKp%SP8{eiRWWFu989;k%8Xp+dq5BFjB#f6T1~A`cl|hP=I;j@Vpuy
zXplpF)01?J+yz3K0<e99!|c&7^AxvTRQ;ls4%S0EAE_*0<U65I5L@xClD_~ZIjw9F
zvA*z#h|=3DR%&BQhc_K%$1Mrq8(2`5SVsoqvXjr?Z8=ZAw~BxP(C*i}wS(DLjP>3v
zul4ifOjpBigY2f1C-Frl0B@sE%X4xWxmQ?$=%GO4KC+9N%4gpyWou>Je1Lw>wyMHk
zk<c}F!`g5ukhg3w^cFgTLkXl+j8(oKy$I2)6KWT)lQf4I=>{ZrF7Zp3EF*)Hh1W`U
z%)^s*Y(n848h#|fG`8C-NdU2-4N-;olHD4Q{lE%WLZ*4>;bAS|00Y23#D0WE>!8XI
zArgRBuG#byN>yf@w9R$u-G%hWBRCTF`!H4r&&86~d!0dCLLmj_Pk-9k3Z)yltbp#x
z2C9-Ze{l#1K>^d5yxBNeQdZ`RE=zIy@t^I#0@pf_iAOgL1;-^BO;c`-jfvOql12$=
zJm38alr;eY(4K6)8xaqVp;MGH@-|KLXd>aZS}_maQ=rSWh+O(or*88ZRYw;tf7+a(
zL`;{&oJi&eVY;(A9miN#4}GiiaNbE7)%hU-UqtZML9KOUxKs{%2New~jlsIEA{3Nl
zTUpJrj3c*jq8;4}f^9K)(@k}ZCvH8JD_TjV<5lFcAt`k`&gTRf#XNTwN@R{?r`Ku|
zV*|`PKzi_?Wh~94P1wz|s0Me*RD%|akI(9+_jk_&EbhY}$$cbJj1FMN?NJBe(ji}o
zuD#o7d2W8$RXBM5!Uez5nH{@!Me>@o8rrmx_8Q3JQlWInzH+2hkHpHpq^mjBairZy
zwVagzif`Y(N$o3;l`v|{SEptWtdBDIdRY3mAfwB=(cso^IEPNv{{iRB=FzJie*_jQ
zdGLD2n%in%qOHLZcnz>}O>gcYOUTjYa)cZS!6Isc>n7FA;>pz|G<2RcFROhKeqxZ&
zqk!NGm$b0P3Pc4jvz9E~^EyTn*TvMJG>$^SP3^f<(y?{N4hn<Az%ihxZa*`zbLS$F
z#UgRnOjXAbTWTnB6hMp~?~{r{L3f$#;c3uwzVGT9jR*LiawU&}PVZm-nD}gTL+mbm
z{P5wqup(4n83=h%<Yo!g?$MgA@IYf(K&~|S2u|eDKnCwaf|CdQFrS^4=vc-$$D<+N
zByWFfI&a9m=h_Y*IO`&z2+=Qg+(b_mk>aXJJzjGY6TU2<IrYMVo}|V6_La=xt}NSy
zHj!&*@riG+OUw(YPhP|ly}__ZGYdpS@8Dog^vx`H$2iYt4z%Pbp)Md9d~+L(xDwJE
zapu95{ur0#DAMy99wtc|J?f;b8=aF97z9C1*dE053m3s*(y>p1c-+)T=2dXC1p5#$
zlLY~tT!}<lZP#z!><9RPMhFj_F7ngFp$tgMM9jSK*hvCaRplSLC2#lQZgvIC^!A?t
zIygxS9#V|txy3x1Pk>mR=!EwsHj>n(7-BymrWc~otJ$<zEqnPC<6huOmMc&;i3~zQ
zJ(?7k^=IOxLtXb2z3rUNSygZik~_S}1IW>a<^K(CAi&iv%y7ePrA-<rL_O9CoJxdf
z!n}jPbQpKrWBHK;%MbKtXXH@S5W>Q8uu<V^>aG3Q#LqBM>({M&3IYsa&Ij9vAUZ&Z
zGsN-(!!?Y!D_%DL$LD{$HuIqXan4dv{olO7?%#_Q$&CL$*IDrIZI1soy!^W@e>Zge
zdlvpZ3;&*lf6oH)^uPB&6SVUG7p}ZbeEasa9RwvETpvO1Bt`K-*hf2i<u0P7onvLj
zZI`3tGPh+7Pz<0y5k?AW8p;;+qAp{U8rvvn_|h)%VGUuB3h0Qo`?M5FMHPScw!%H|
z9Hr;0d`bTeEG}&L6mK|K9%P(!+tQs2Ybhbq>~J%KpwM<v+!5JDFgQ$AqJ)(stwUh#
zB=G<tp%YZ6S>>-TxuEl~`SJM2ml&`f?0C)AO-9Lv4adO&_<^j)fRDa}jl%D=`IqO%
z7<ymB@p)XQWIO3gj0mwWVb(JBB^US-CXI=S++Rpq)=>m?ex%bJ|5dywVw3wRUcRx2
zhH8?nY)NDl71dBzfA5N)N0^z<!%(6<GYl&w`80AztWieGA<`?2qJi+Mh7HLd?;bd>
z=k4XSpLBpjLAyvuf!_9A<RTPWTGH`^itQq#12?f%REOgv#+Kl+x$QtWDCp#<my~}d
z;nN7aMP`Rw#Ta$vwJUs7GQ`G(8i9eHRU!}snuGniaN?XicMkWJ!1F-0nLY0Jct0ww
z+m{IXkx0pqtHcR^4W?*x{3(_H*u=ugsd91&HS|CH2g{V-UBYLfF=#uj*ZOUTh@G}<
z5I)>4hz(D{f{DYt2y;*|2sUjP<IqL(Wb2$Byu*&T8N(bGbKqJ$U(h@-K6<mtg<phy
zuVxY#>!de}_K>^!8p7eM&<WJ53RhuBz!eHzBbYjIFwR{dyL_O^OTg%<mTP;3Xsl?d
zOQA?%i*@0WtVF|S&z~PA*G={(L=zSrCSh`;0jb@<@(>bh6sj7z&7fvdX_4()vDX3S
zQ>T=P8NLBtCDJN|!7t0l*k@-a$i>hS<nD?j!E{)(B~_O%{nEtap25sj0%e}uN=BMR
zu`|fF8JU{OXl%X6I5{uj8DOV1IlVms)VCjRAml|RCRDR2g4Poe+k<%)$%P)oa0FGK
zOa`g%a39DHJ}C#!f^Wj^<=_5-LzH|Zv0)v=El;pskVZ1nP)`~ndq<i|2QnpZj62G|
zRUZrE7|0MPFB}rC+anap->=4tM!y*l!JTN&B)f~0#h6fZmfd=&#hdN=#8g|2sk=Mt
z^_-R^b$yQW;6hC{h`mxgp%cyb<T?!EF^67y1y<;8Z(NTeFr;?ULqp_6fUbv{Xk)2D
zj~><OhKR$p<h}z|iaa*e!zP$k%A(&sKc*EMQa~<&!ep{Z;5WDgUAzXd#TU?5lv6wl
z{!kGt#1Z)j7|Z>7(2=MSI5;~ydo?`(O<P?f*t#kVq2RV~{cTc%iL-M)y@+!z8ix`<
zb#RzFCcsDKHCGGz50|}kG4-R=R=AIb{Ajtjt30J+T=~<l_|XF5HGxijamhST+A;7V
z`i6uU+X=(mLkSO$#-DdEFc>$G3(7dvG82of(XRv|l<mZc)UWmK<7S966dzf{pJY43
zFXekuiXt*e$8M=G7*^6SftyeT(=B?W{M}vN-C51X&K@I^hu}lEyn<fBU%q_1W0i_7
zRHlB|Wzh}Ul{}+m-ORj$yXSySxm$8_+t4YRoPITvNyk2Siv}1%G_`}#ZySU5NH&TO
zta#=n^ywL=jvq-GYyP%yEM?7rdcpbNiuhPu4%~(daJ2)SdU|?d&=rwboFp)o`@P)Y
zpjZN9Svj{@{Qk!dLh4Q-<VISFti$L5@%wo3_KvMvZ_I=af%203nFXRR8g?nXA@19j
z!DS3G@M+>^71};9eM*pO<s?|)!ljTa8EYn?7jYVy{ASyf;dNHR;z{M<rZB&BTz?#o
zHbTw`T>9~+5e!^9j9_u3ORE~X69-)w!VvnpRG?qP;F51C+)=ASeqDwe8_XjvD@GGu
z$fE}j68j23e)(AwZvzi*xl@2q1>SF#3B(1$ykWTTIdjSnmuzgrAJM+`YWb#D+@e~O
zq$M`-VVkt_5p!tB#IC%t#srihB|q-%m2=flzi%}_-r$43Sdk6)f27^|c9w`yem%l-
z1KfcVgT1daHwub%KY3jg@kZA4-JadMRXTag=|MBXYaRn)Fd77(N*?Y$#7*IeACCE1
z&JPY24(#1QOKw+EZUiOMqX1@G0nvfnKSp}uIGoV?Jt!3_;^Cf?d1KPCGk!+KZ?b7$
z&vl#N{<0A1eM0`ArJVd`m*&Sj>B0XJYOfCwE6ho*#9F4anEpuoDSom8ycUk-kR33&
zN?C#xmo`Tb^96b58c<^s^;(`gUbw)OVL3DNRlWbyw|+6P?f~|c97@3v(5COp8b2yp
z`%>rFR%D_sE>pzrR6$(7Lm_uM`^b{!7~UoRHZ-qV!OM<GhVsZZ9t3|kKbrAz#~41j
z-mya%PKnah9}qM-Jq6g`k{(OA7m}iJr(ea@^v|F~;i^k)ya{iDpAi{fOpnb#{q?NG
zXpnt1W5i)baRwjF>8WXVCJ={l?9N1p!%&i;#l%Nj@%GbbdnLT8#EyM3aWIHtS3q&x
zux?$VeXAGM`)_s~KSx-je70ZXvzQ0x7>%9aT9@EO6_Y9arTiQ8<EsoVxO6+VuO{+J
zVe%5>Fw?$yGwtS&J5qihxzyz&_nJnmJi;TW^sm4E;wYNL%kYYneakS>EDh|6X?rV>
z?fRI_!=rRS&_>&3Z`RHvn}x=0*T|jHYpCg!Ym6F_DKHYqOR%QhETi`irE5+y-YevC
zioZf__qD7af|tP<`<N@B&5iT%H>!Tn{t~Pd*cSBc2GA&yIxlUD&hGQIPPp5OqiJHG
zp=xv*4X&J?ZI)G+&)14r_4#17;jd~QeV+1HECC=lTgZdcRltCk896#Sa<~Z1L(twR
zR0lm(aslFFV=Rp23Ah^pKYKY;xMg(OmoAlD+)|dUq!Ej|J4^3}u(R%6w|@N<#1|#<
z3mr3Q4T~#j1h454%Yb5qz}C~J_)Yc-2{Ze8|HYyEf7(0OucodvjB8ulCDtOXh^-*5
z(2FgI6_tWP7;P{Lt8ym>1ZrtO0l{z&B2Zcj28qQA7LhQBRJnzMRY1^`K_p`^j39Cu
zC@mMEL4(}XgxfqXGV>SAM?bL^YoX`tbI#t+-tY7LUQzr!jm&RkwBnLB`{58B5f@Cs
z_R&#1g?Ft0wg3+pw&Vrl4QYHmPNVo#*H*(jopIHDR*yv1`j$D{LQSj3-uXPLi_cDL
zn8OXZ+Hs}dM1?QcbJI6C+aXZNW-UTDd^MuE`q6JOkdZ0HloI+le|Ba|OM1?&uzEqQ
z0bb+rq`dJ)x5XJnik5kVxXtmbN@k|>ov{&E(^HanW7Ysu<yYA@d}bw>m+>o<zfDf*
zO*66NBUkS8^$aA6jH-Kx`$l{{WR4t5XY4e}RvGbg@OPS5P)r#gL~`=J?t=obFVRK=
zmTj!(SGYDzrYGUH7z~KEt5sj@nBt^BkzwY^I(GJbOlS-vBU=8*8W)xY+pAn^jAFv&
znbR0dNx!hq<!yhF4X~^QzMGqqjKU_cw2}i$M@OI@ILkwgI>RT#<Wp29$?t20^s7jf
z*mB!TpI+FzN#!*?l5N`6dD{Nj4yj_fR<N?<%;|JvPG_+(Bf~d-E2rcDyMY%eW|rG1
zuCL-x#EQ?I^XLzw?ie~cD9%uSkO4j?TTiPppxYv5_DHz6N?7Ehjdgp_bL_)k*tMlq
zfaP-67WqhTCMP2yzA9!q0CP35g$wXI*zfnPEd^IQIT@aV;`Wr2War8)%i<42OWu4e
zaeo501t+&*&6b1f7z`A|>b=jb0-F2W2`Ay*n~!x@tXKyi+>a#RFrN8jKGZG>;)nmf
zng?Z6-`y9b%YJwehxn8#D-Zw6nIin;XBkU5Bn6$4u)@S%di=j38LR9OiIciJl9-B1
zoTpwe6Y1y>FoewL!E(32_Iv!y>_O3^Q;Igm5(J5Y)KRt3wp~X{_#d#_Qu7A2*@Kxy
z(aK3MwhUrlkuQbU>izZWce7Yj?-USY8BGJ0?AoI>%U+A+Qc#R=9)nTuU313$>GZ^S
zdY6vA7cSC|jN@cZq52^~RET&8ECi9cFpSrWL)e3<m(rh(>KzFe&EhVaFW4?q<0m|$
zZpbC_Fh!1GP5UQaV;+X68Ec&XTU^%uifaqs(s10_*Toh&sCzoGZsmS9BH34mSt(5r
z92sv{ca=5-13k61wHfilaV1VG*-eIupXMZv9(cG3*3Vzdcn4L4*0B*>l3cpXRA0;V
zeWA;fr4m#|JzF=X%)Q#w*od6OT!6<Dr)Rw@5yk?UE;o_thE(>j#5@Gx2A7aYh~<?B
zA*;KZTX`hcUK17md$h+P!}!JijrUNGsKRpIk66<ggvac#70gE{g9s@^1t7Uij$i7D
z;of(x{*hV+p<1J=P+3J-Z-{m=T)le8k*V;e8@ne6_M;n<rTf%Yn;mRXd*oS&#5U)*
z&SjVUdJ_mFz`-nQQTw#*?-_ZFdQRuqbL?qsSr;K7-(Io8aVT-d?!bWq8K-J|1U=s+
zP929o=WpnhBb-^SX_ZVrzYYgr_heW8A3p|Q@=J&MliQ}gg?<Jm$Yo<AgQ)x$WPN@x
zYmoh!*uAsC=eNwTE%^SCKwF2U<OdkwyhyJT&kSW5qIkoL-^Hzq?C3N*Y8~1ZyS{X)
zgz1p&K+br^oFWMYs+F4WMDHp*=nlE#UGsBZuPLgy*#kYCxVOCr15<k!zDwnM<uC5@
ziSEufCRN>@WXWeRs7#M_jw?2<+>wv<7{=ENGV|c-$L8`GZCIf`lJ_BTgGXtz%Dc;_
zkPr>ntx!PIW3Bz(z1OC(l6RU9FL~{?l^s79q4~lN*6hsiAK*<|nZM-;)8kj_XV57@
z!F_k6EatWltCC+&NfV61!ZH7sqpnMps=I^Gc&1cmOrD;a{KQ{k%PHCLVul*K-gABY
zzB(MT2j5NBNaC8W{vA4*+PJJTU^#O^xA6NtZe<FmbP|yfJ0X+S+M_ek06)8QtFUiK
zU3X9LurN^8tO5CMVn@P20<@1D<!$tpv4>q{1IRG0xr1%RT;Hm)A*`l{<DSjIGnPhn
z78Z->J&3br45FaQQ@4sy4HsgN+-4TP`uc9LCdjfKdSD#`FpCg%L>A_uj+!zR+!1f8
z%EpPa1GEc^)sNU)Sy%gb0E&KRV_}#)t~&JRW#f&FL0&6-1WhOKkL}w|;)smACUb{}
z+cWO7`TBTGey)3NU^%-)KQj*)AM$m9jdwIHWUbb0fEe;-vMqvrd!+Cx?}hO5e&!ja
zu*f-A2IU}+{fRa@)_XbcSseK??VFQ%f$eU6X3Qpo4nwxY_WWN6k`u}AfpQf0#<gB5
z1vqGD{O*bVtKS=u;P9QT?p=6gZmbtZptTM(Nji}El=k=-p&duq4X#>2-4SdPCEbdS
zz0l*X04qXa;LD9b;No(iq-qz*d2)flrUk7+DNE{J;5I|>h~_2~NnK&(aw9t?mdjG_
z=s%aFBU}w80@5GgU{pJH;|QkRISRaiLTq=ah8=J#Sx0#(C(fBe432zn{ISU?hfK44
znXl`YI1;c84nw{OIuqH;)YdR6>BA*}|6P$|Q%dc9VBY(jOr8<YbA^yHx0@SCbxuOO
z`?WpS5>3(Wd58~V0_{=Iy9am@U@^QR9<@6m%e?1Aav_$l0X5u#lbCgjQ2#B!W4sKi
zsy&Fwy4xag#!;@UzG%&28CZt0uyKL6<otpHTG)Y|JZTcTChDZL(z$uGqC)#h*cRa5
zvbP_7V3s6~pA}GR2{%C4TA{-x5m4HvJO(}kw7y@%cBEtJ!T_8O8jt>IyJ1zJ^_l#c
z$Ob{X!7+<a>xhZ{k%(e?C}}IF6fsqf$O3S1!r>Akow;@g)L|<_U0t`!5~IM%i|T$^
zWuqdD-L%KAE#XG#0jI$$#>2+>_pu|n4-;4k+;^9;vJ&E=7#^037!A;*5Mp?6Xz=(2
zVYMVp|3+MRxH$91_a>^z@cQ8$^BR>y8daXY*o}|qb1o|L`+__n4J-C{b%YW?6*LGv
zZahxtKH0djRHn)LEW{m81bk-zULqi38N-w;r`9aW-a0Qmf5rvEO`C1roTBfGql(tm
z=XL%?L__yu*lGP^Y#Np`&;CtK;KUNPZ$OHKiT{<k)0*|FSDMlUd7mc?h(^!43YoLJ
zG@ow9#E#<|yKE~#xhw`+8(359UVBfgeZ#wuOw6#%J>v`^6seqFQi>l%ahLwWYRqxS
z=9^}1^4*ozU=5qsVFdF&=1ncH$=n(=5*zyUe!nJrk@&~P;>Bp^0?>s!*iq(F3c1{c
zY*;OdW%asI-bR)&Gea_~%}1AWyN3S~wtY)oAqFJTv5P!1F1$ibCL#!l67sth?N5Og
z;c<>4ROLiKl~&B8v}GZz!=_D}l<6FACu;6d7Kc-Wd20-%RdINQ!^G1XkYDd(K`XHq
zMDR%WXmB#s3Q&g|M$gX9&Y4DB+xq$636Kjaj=P?rs>b3S^|Or=#1zrb!V*T8G6~(R
z8&l`)cz*Qf4<Tjlq7fHuSCIMCU9%=omqnp?_<LNvU^AkfESLsxJ!tIEP>2O8dW+fj
zfXX!c&3!QG)VxI8A;_~&7*H-eim6Yxv6tC_85e_YH22{hr)=zhS-8j#6d@M9vn;Uf
z-SLK@%E89WJmh3j4!hi%o_{VTcrIFaF4+#*5vI_HKWK0wg@d9Cb`B04oJcw1QaB)@
zDq+TV#;$K=Cb#aX;v@ELo}W0Y+mQVr0Udncvna&LR1uu6t_BG7@OZoe7~d$VPR&y;
z<>(1NQQh1XI-$9jCh&XsUU_9(i*D%~)Xn1#XH+ANpFg%-w8*3P1+VsH1>j}ROS}><
k4KnlJ#s9e));ag;(kIaqE|~|ZCFG(#wtHEUonI#Y2a&xLxc~qF

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/href.png b/latest/assets/images/social/reference/API/trestle/core/commands/href.png
new file mode 100644
index 0000000000000000000000000000000000000000..71a8fb12bdd63b13e00dc05f64ec13343d81540b
GIT binary patch
literal 29807
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
MPwkmSpZI?BUu3`&NB{r;

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/import_.png b/latest/assets/images/social/reference/API/trestle/core/commands/import_.png
new file mode 100644
index 0000000000000000000000000000000000000000..824419730e620df91d0c90245d1b2ce9d4e7c99c
GIT binary patch
literal 30174
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/init.png b/latest/assets/images/social/reference/API/trestle/core/commands/init.png
new file mode 100644
index 0000000000000000000000000000000000000000..155587bfbb73ebc917ba39887ebe5cabfbb093e7
GIT binary patch
literal 29791
zcmeFabySyI*Dj2@*}7FkY>}`fML<wm1yMmkx<REBB%~V?6cGdol@gTh?od=3l#~*Y
z5)hDX_^yTS=e*zd{e8|DXN+f$vG>EP!0*1-nrqH^#a!>B%Tnj4*3+)1prD|-a9&K7
zg5s|v3X0WM>;A@{NT0G-r=YMnd_nBAyiMRxyS0UU!_xGqiQV3(oB2=kON`Kqor*c$
zx&EO<>b0{!*ELyDzBOZRy8G}!nC!NVXDMl@YFGc&Pk(0QP`>}-LMO-gW<BppzB()K
zX~Xz@zv@7Z>KFOc+#!K{U5EBd;N!?Ymu&6ret$)A%4r=Qh5Yl1XEodJudY9#*zo%+
z)dNMVSH8O4_}_0M3-R9tSqX>#qY<JdO}+A=6x%kfTD9tXU*8d7Vd4Gzy?uQT?cTlH
z+t07J(<?OU-$>=PwY9x4*ccz~I6qYzqre)iRakKU!GjC^wc%&Q4({7`x;jLJ<D3Vb
zS5y>JbB0lX*x9p>WXp>WoRh%;sbpFCq$@PEv@G}jrt)@WbW(nK{KkIWa-ZZ_&6_vl
zezxZ-6)epes$`pmzkmNe%jy*qZ`Rr!X<K*iW|oLn*ZuVBG;b!=`t{y^>}nG6s_AV4
z=ZhY>SK8v&7B#qR+`S)9_AIe*NtNGv_@=eZq5ZNE7k6h5CgkdT&9fbAH7P7}oNn*S
zxf7<muZU~!@#FHr4r3QolCM1o<hPXY_Vzx=!=rFiGmoh?!{}LmU8JP{Q4K+%%4@Hs
zLxjzGD|a_%n@5VBJ6AE#5c{E{qob~vrFL$5#AJKgNmb#w9|xpIc98d@Vb&_ht9-$I
z&W}xHKOWL7E59*bt)ezuQg`ZSvuuJo-x2rCA9k<uqjzv{(0O<NAG3ja<`+Wt85`+N
zUN)$Y+IL9O&*%1SifHxhlr*DOMNOMd%0~|$KE;YgvRQSHRB#mfr07<tE){AOI*rYA
zdD@$bk<Yz+vLRaT99HJAwBYD{8+!o`mS0m-en&zaWStg9&qd2cdepU?9TmN;a9cK9
zqO2v|P<Nm{dJ7%hO{E~kc-1mIWRKT5hFhaQ+!Bk5PW`iCL#kci*8LWjW8|3wlmaOK
z{@c#(IzH#NZ{V+igxp~>6-JF*D_`9TztI;|5j0nNic3n)DaI-9YtOYlq25$eBi&ma
zRN;72ovdnxNr&;|jF$6a&z;ZYVNZ3+XWUeo?F}$_qmrt3bR-u49h+>@>YF=Eb%g^l
zc}jol;fqgmM+#a8MxQ_5HM=xFqB}j@?j0D&rVu0V#UNyNe&lQZhl+}dl%UMaOtRkl
z_wPT*%iH+m00#qu&9_yvKT~VEs|7}U$d7j{FCFRZ><ng5^xA=760)DF9G{I0wv$+z
zOmyzCV`E{F&~#p$6dVi`c5J!PwFZxPMTCQc;|0HEjKy$UvytOh%O(vj-STa=bN!KL
znR_yvWR5erSw_o8drMrrD4*%(?k>NbRWVH^(t6}83lC323_d!qYjlzM;vp`s+JRl0
zXpfh6b%kwH*Q*Y^G1(HYlKQc$%gmZtA;zcS)@6xkEO|gHcOUb%^$*U3US<krnr^oa
zDK9Tinf=<}%f-#z@a^qAp@L<fcM3D>uQD(=FWmZP{rd7r<uhmQw%L#5oAs1$53p=Z
z&|s~LxRh$=@ctpq(cK5gQd8*Nzkk2<&4p)ycEwiqvokZ~>z@TR$M?PyN*bFeT0^ZY
z#A`jQp6xJeRxsIH6`((<Jk*jNZZ*_m+c-Kp>UFi)rOf+~WcT|=TgmcAM@O3txA9@a
zp5!fzRcxW9eW~xLcEWvWyhen*CV#A)HN|#ZFWYW1=1oLIIl`_R2hSJ3t;ZnJZgODk
ztNlpX*L?d!yu6CCva$#H`Bi&sLO7}dPGsheG{h=Bepp&`XH8FJh?Dn*ok!2Bs=idu
zHap8})N+s`f5Kbg<aKc!oi_>{v+d?_GOxwQ8r4k75cAzXn^Tdi4&!;vx=U$PvP?rK
z2AeoKo>?!>O~%iu<=G@Zd{`ePBPu-eZB28&eJ0Wi`Q3p6)>3{)H4LVEvQD2qJyywG
zQ;O5wGtpm1UiHzVM_cIW*(Lqhyyiy=wQyd43JW{VO?b_Y_f>p;eeMu5^98&^H=-}a
zpn+w#fK{C0iEWuYo*6fr_wQd`U^-)Clck<-r*KVMTemSz#WthM-EnGq+J7yB%_(vy
zA9;BAy?-xOvCy7po9Zyr=~|n1LoUE_dZdFxg89Pv^GUM~5)y8@%X1U`+9h6PT379!
ztU@p0|MuQm$;Ug`1sk1X72~_HqLa$YOo4(<yPq3}BNBKy%=3`-e#S6v-KwoHjlWON
zHtPELq#;z)b$#A@E@5HKCwop*>+Q)XNJz7vHf|_zw6`2?%NA^{EG@lE(#IB>$xoux
z(TE(u%&PKoS?v;!^w^PNSL#><d3UZzq;!ZPyJ}iew#bxIQ2E!Pa$nX+gid5iYU()s
zGg%3v_8f(V1dZ0-tbwLPlk~+L%fb4rTU|GuEGP65^QTk`%=Jp2?i(2Esi5>2!G6cw
zsEe4**uG;&1g~+M@)b4x>Oh(H982?o7S8$YXVk`jkneF`UQ#TXLS&dV3ul^iXwnPW
zr4?EE$POUD6yCmln>{enQP`1?Bf;DdDa}}HuHxGCoSY>bDcPCFiHV6VNmuW+k7#Hd
z+Q0t{4uZ{s&E@r%MrSC}So7^BQ?j#+7n5EpjZRN1-MMoo+b#Yq-<2W?UmqWx>vw8`
z1e#*#)fkt$y1En)2X}_TBO_xUZ9UR5ncr7gd9eW*dG&loQ@UZ3Jf1s#s^rBg#cZ>l
z`d}gZjZX#<ATbiYEQ*WG>yv8h>V^!s1q1|YC?=ZqL(*B*D`<A^jC{#ssFxa#P>w;_
zX>M0UaAN5~>KZ+`*TjAKq8xDbm#4_m4{yie`sin!lUe3{QVJ<L7bN!#uS*hKq?IFY
ziI-jPe4{-lT_a?t2K&*Y)dSpzA9yQuvfk&dk5j1|NXGAZ<ms6i>ttt_gVWi|qN1Xb
zoe`~>pTnk}by>oX?Z)++o<dX4^X3L(DUFqKEN(Ds<XGHkot>R6^I?|zIrlZy)6<h2
zd#fjP3_az(&ze*91>%L&km?P`2Q_zcX!@WiG&@|1Rfs*z=<w@~#?buiY;$^$zrTM~
zQ@nX!HJ5pBrFx;J%F}P(uBhNx&dl{L(R_aOYOhL;MYMd3eA#fu!s4Rt+q;yq=>`h9
zgISX2&p*Uxe;gRaI#)Og7=}2aZsPA12RRYQiiw)+6@Ki`UZ3++O~*D!+RhJUvM(1}
z4l1e?I^~OriGBGwUn8>YGdb8)F*iBbgTiO!$#+i1o*bobyXpBYk_N}aVky_Im2}-i
zFDSHe+kOV=&lap4g$pSPTn=*+HzKE!t%g)%h0!6@BX`Op!!`_Mb|f%3{5oy<^9yG{
zt3teLL#?8w(&_Msh?vX{C$)5g1__=UwPH_bd009Uw^gG&;X7q`ZhpB;wVUgGuTu22
zYuC(%&S^SEzIhY1@)IcaNPp5)^!)Pl!VX`0GmKi&${He46N+L~QX{HZ0~qXoa`yD}
zgo`a@s}9E|7NoQsW@o?TdsKs8$vGpTsJyx9M2Cai$|vItQ85au)AO0V@3nGra>{O5
zKmv=;c<kY!NG&|`Dn>0c!Jwlc|D~{FPI+ZzT8r_Qq^sF2bLb}GGs-F}<)0mqR=gCz
ztAOX1)&A(7%(qsr>Sd3Q?NB9alCiJ3?>FlX$G!>2;g<B+hVl975v9=3P(P!*yu5mB
zRa{1{)zC{_;q7T69!u*(Hzjhel(cQ@!%cUhrt&y1IRuO-33UdT6eQb;Tng=$5fr8v
zD#y~s?PwV7DhX<I!V()DZPU!RQ!!EtJws`U?km=)!)e~Ag4fnjIb(8FmPtneZ|35+
zd(?3mM$IYVRYoScLm8{*hg&lfs~odUJMT7RWI82TDc<I>_;ES5?{!#MTnj0-RTcUs
zi{&Bl6s)YQlI`dR6^(eWe=5?mQ7m+Ftl$k2u+FeU2dt?Ot5}u5$A@RF7)Otzz|737
z*y_$G@-+rMok4VWw@$2+2~|_&HvP5A7cN{F=<(Mg`=|8v>(_ELhhqww`orVeo<e#J
z)oC~C;#&UMxKX~ZCPWE6Ww}DRKZi-v(#b7X`p5p)$+iAx-MXaNr8+rOkFeFNR|`6+
zGtKQRIP+swh7<D$V&oYXplV<=Rw=Q(yX;v!1EZjg>7B(mbP@x}g-df4y&22%9m{bH
z^VsV{oSdHrMv;|ve3@o+Ubs5>1rMi-I-=-_)LBq8Rf%fD_`afoRf!~w1}oG$-a-b&
z&@&HK&p&+hC^<V3r@{O2P7YNeP4ui4&eK1e>jq{=3g)G%gM|zyv*Hs~zb;hxO}CkQ
zHgHr2@mrSn4%&@%lYaVaLWzX`(V@>;d&?@4t`>K{_7wK!)~`NqWtH(JGE%Kzs=w0F
z<H?ism~rf%>f)T9fkBLXys83=QbJ(t^I85^GG`}wfZlK0Bk^2NR(>AodX;9!4!!Ak
zmCJcFSDLS|rXfpPtIlVf@j*|?Q!}KLpnhXg8K5F=_>PVzO6mnk$yB?A-ud<IKXK?4
zJ$;#E-kBEi-F#qxkmhO+PW@t6MKAOS5!Nt}9N?*eIvN+;k)r#!D#N%fYv1HR!?VAs
zXqC%Ly$-O~WE!<L##EaWE*@@fZsu(jaF|JI(5`yPlbRiWBwnjfxTY^KyJoN{(f`ex
zH|jNroJ(kT4hdKf`|Re{D_uh^_>}dyMP}F>E&9r$e3Xy0tYrlcBtWz)qZ7w2uiGVk
z%59aJlC}?vLivrM)|?k($=W4jZA$<R-abAD(VF;`EG#U%LFAcXi6fs>Xo?%3bYfNO
z0vg&PA|g^&T577JJR5U4^zOo-*0T3-d#+@$3spFZjx4gc=i$YSgkL$Poo9kuTXQ7X
z&f)#y8SKA5I@0~<NN|$9;0Y~y#a$=OL$t45(`n1PHP)b{rD9ZvY<dG{t7qAhQRFDP
zF&|VQWhAbP?rnkJXUN-7oZ6I7l+uYhuITx|#f6{!ea@uesr?y=6gevBTr`G$97QkO
z+f}`Bok{P|5Ifc|gMcmJ<puNI{1#Ei4eHOA`>_v>R>+%dI%xhShrjx!nmBT?K%0vI
zpM40z+Hg1TP31dUYvYi!^2VzL2wd8I()3lac9PO9hm|DmfHLO&^y#<$tIF?7N+cB(
z{UTlOoViU=;R4VU;MqE_khx~<rc(5xX1+iU%E6wGAE(C1UEZb3`mHQ`=Tq*JW(vME
zwv-B)NC7H4*p&C0<WKtfu&LDcj`#QXlg3hl*?%I0QEmD9Uw{4e+<=vjulaN5!%XW=
ze)_CyA<i?MYon2*-S?c3+JE4{_<~(<smRq&SQVqM6_wlFx(qjBsro8POG~E%7>BJo
z-%<KI?OA(vt=7J@PShi_g_&E?YMI6fB_r8=48YB51(txatW<k=)9e-&X2<=O3(R`l
z8pe^_%TudbjdQD5zR5~7=ZW|Z1H)-gD$B}x<75fsCps<8m5EXd`3xri{CRWsS21-D
z>ArvbxGu@GnTBQ`s`;(CU1QpV5+N)KG0zPu8UyFLJVkWSvsh&&qh`uE+PlS0@u9I5
zUYgOKML`I^_=2l8S^HdnTXyQiNQV~f3FAORHAY6pSsdOrGxLexkx(>?#-<0yr8YrB
zK$`k2s+4sst1xxgk9|eu#bIY3cRxAtwRG~!GihOFM#l-60<Gyi+<NW}+Ws6`)t1X)
zMy(lT`O{wm3<C-r=ga#-oQ+efNd6bf0H6{q^oUGFOsffHI4?W-Pw+U*n8ub6(EZ}r
z)w_~&+y;HsLA8lmh3cN@z@!Qmr_^GN78e!>^r*5lFW!1Ys?;zsU+>1?XbEGDLZnWa
zH<wY%@tyAK)YWZ$NDzH<%k}m0e3k<~?>~MlN9o^RxG?rOZ)tAOY<Y3I0@coc(DM4%
zyliyDU-D9FU;MkLauQ`8^a4777QqZ|4;RL%n4}#J{QZEs<49R?AfI`h(~Cr)?G${V
zpmTC4GB5B^qOwo{{y@E>KYjA?y~X)y{{)R(RUw8gTlPOYd@03FuuzNrcyY7VzPwr1
zXMAVQoaxT)3kIe`QIr}IIETa&&(I1kqCs0zQ<G2}{_gukG7<uJb6&eoI;ersJ8RaK
zlf+vvKb-0V(4`W*jQSK;Fx-evU$RJ7^3<u@7Xwdz)}3ZF=g}WFmzVdU<F_c4of>M@
zA7{8h0MEU()T%;GgNA-hB1Il;V)-WvJ|c!qpTw(W@=y95*Zc6{!v!EQa?r$NZu&FJ
zMKGyV2MI(*TndN~_n?b*q1qGi(UURJX|`vlZ%~j?x{-rJUW{zGn?kGe!l-LQ#y|i3
zGk`RsfFPIWF>I74c$eSw+wBG`AWRlEw#r(?XxZ?a9^A){ed={WW2I_jZ*G6WUoKKg
z#i$iQvU*<X!UY+Vg4qaz#<&+TXkv5vg6-?EmN$)C(M+g2ii?Y@8gXC$v^O?+ds;h)
zA%jT=ylM=n5Z!<s?5a@!GhgVMesva`Pb#7O#~R^>{rVONKx~*2vYRMPuj+7KHcGGZ
zI&iN3={`|;ti1wh|ImKLY}v9UE`#Jyv-FjgW_}dW77b{o)~kTpS%3eZt!#-ySO<B)
z=b#il0{k16(dVy^)3?|pU?1X)rHSP&nEAdTb_tY|VY(BJkizB5PaD4Ai})7x6rD#o
zz;W^=9`p)0p;R@t^qShg`GIW`og4)P1qMj+yd7#ea$;il$52dWMqh1v`F(WNbv2ZW
zdPF9j>eJWaPg0t#5LxnOW+~CUM=m~p8p}?<hRvQ`tDr4LTAxxG@opBps9ETwap=&Y
z9)S!Hb0?LY6V@f=SPjL1dl;v8Wj`Vnm}KV|D<2((UDnTH5BHf{obK=iswy`8*uKgy
zb!rx*P|EI8T7c_lktEoGC>BBKu&}aL7zB(IE`RO)a`VBn6Z6xB%SJZUgTMaM`M8Pi
z29k@O_N_i{)_vZSajirrv%`a9jNl(@W0g4M{EzGD>XrdMlCGaOq$ATL#GOH?<yX}J
zN!9qx1)ZbY-fI+|u}K~8tEot>5gtsL(ys|-FY#o|oK<g5(H&pVeMhHf5@ifHa6fON
zR??+loPO)p18e@?n3S`&<-_Bh;ULq@`fCprcPRrkG$`q9Sff8Qj^;vld@z1Hi~Q52
z#rcYdGzZ=Q!YCGgw?-A-E#j0{HMR4o`gNO&l*}H9oH!rq2LuJ%df64*4uMeu8P=J+
zBr~)5%J#j74~yqmj~pGzpAK$6aj63V)@IumG=_B4m)lM)valDdnLkkW_Ah$K<rkkH
zJ1y?XpuuEpI{k5viE?{lpWZo724BL5g^P5&L{C7zA5g0&w;g%0r*L^Ov7w7yEyJSW
zli3R%L%)rT!fm~YmF+BCT(ZM?<5B_BSGUjrta+wg|9l2?pRQ6zq*RbM2!ZnYXgR7U
zDo3hY`lLk`<%e@eg!$~J;xvZhu!;N@Kc4mtPL&-ADaAS)E2)WZD{0z=7p>m8bLSDc
zh>K;Gg?iRy<>lUG&yE=0Vm!L-C_~}KxFnyXq+>kBZ6_xO6ANRIeWUK*|I7E~%NVe$
zQK*m&AXpU832)3C?CN^$Ld}>^u)Jh1nS0~LjRBN91CTZY=}nq)IG>fN1>6N^lz{~U
zT3;@%zk21$D+A==mm<yu{N}yx5|WZ~O$i!udrlb3gW-?^hiyCTnObn>xg0qGKR&;1
zz`2h(s#Orj#l=+*+M^yPvL00^8h<Yj<QU%q0<Y52<baaHgI~Q{wrzV8>@;^H-EPu=
zpbp=_z_{;ST@9VZt_^rHg+ixAAMlOs<1x15y#x2Cg)ige%AtlSqEQ(5_+-xjcsc{b
zslks=p_EQ%Yp&m#R$8Z#Tmx2D{(!jqWuSWn5acq+$;m82LK@h@OJ~K!W6&r@f#mwa
z!=R<5H3{l628>uN@Vc*;S7?G}ehmKd&D_+Gq0Q0%d2*yi$Hrt+^=mR_HQRiJ7boNZ
z5PL=!Bex}dpLAYc^;{O@E#Z;u^28o(vC>LLQ%ynf%N@9&9GiX6y4})WZSFDHW#`2~
ztu0%(cKIz`w)nOE4EZ(+w`i<t=>bo{{q|EoZ`o?)T95dhV|4WSwLW6=6@X`O&h9}c
zZ=E3_(+p~*Vr~W;U=NDUGc+9jlXt@YNL{zD9X;}XZehG;eDU<r*C{C}I$*-NbV@hB
zV?BBQj~Z4AeBKis8B9V_0!g}fXy{9_C?WOnplRqyi~l(wcI)G%w$9DQ-#3vDKP&x$
zOIPPx(Va0o<9TG|L&uNTC)java;E6lFwD*kCh9iCC~VoYXRzf?*q6OUcSV1zY<o>e
z*+f^2wev=oBqMPFz(hw^_W~M69X&leyN8qpz(i^2B+zgl!h`uEoKdf6XuPtrP689=
z(easyg@uLbVDnSJ#87)?T|qWRpd0{p{EkK!A3^?Sg~i(({!qd~^fo1V=-ZF~TD!Ia
z_4$oOe=P`w{RnyQ=g*mL-MWS4KcJMT>09B?QSo5I&TcgSX6O_NmPIEaUSZ0*ckd|#
z?fcgG5P>ba`udXM;x2E(!)<MJ8u7;j91zL`Mbk|_L0#qDyLWHUddLDk|3gLP`}FB%
z5XRo1nVDt6?jJmO@I30mL1E#qb;Tv@4njiY;jrZ_0O)vAFMPOKf@-<6RF>u9oF(BY
z3zwJFtcKf|Q3##_3w&Al+g%_$Jp9IPMNkl`__Xe+Rug}s%z&AEBNfCi3x*$Uf%{*S
zl+6uN)eXv@sFi+)&A0vg_U$tRvy%HRcH#Yp4`o;nosI%WLL4_|-Fh7;;;f0&8hE_+
z-3RChF^cglBvLH~>Mszz2pxk(`K<(**Dm;3z8h~$cl^;-)!(bEYK+G&=*~|KrRY`B
zHiK5Z*-@YYS~94`)fmX@4OorZY;*no_S{V1a`C(O?gh21UFBEsM}ak^QKD2n@z~ST
zU(|Ke1<<!~n)#}m==l!<VjLZ;3370B3_pGE@7h9V=iSGzKdn#H>gW$`s9KjaarWO0
z&N@((qk<&9FxwZBV$m<Fl5XIOt}-WFOMe44V%3_zOVOLXF>Fe(>L@Ok`Ad0j|8E_*
z=xiJPmG+-slC@KS)CeDjFnd3=7$Ae*1SsgaI~||wKx6#i)Y3oy<MV8|ipp=Hbp1n3
z?ayc4TZ(!h#Otv@68%RHdREZCiHL`0?XJB=wL4d>XjBwO!$fcUB33n>09|IgpGl|v
zlcJh-eP4~xbl}F_Tw(;i_jhi-a>M=4@!a{Dxu~3mk&y!x)_-|%#F=0gPxnp_f#Ij<
zx}?OP(Du{@r0h9+JDlU+-4H9GU@ak$jBM-0Q805RL91}sPq@OD^$04RuYQQ5VvKzB
zcR%4LcryRY$hE&?u#JO_?IJj9A(c$ypp6WIUwRg)7zC9Y6SX){a6WV8-TnG!vzR`T
zXBJubb+0nugtS3JOwYs=mX)16Bcs#IY4lpX6H_vR|7NR7qJE$x^h|d+`_mi{e+V+O
z*l2EUt~^TSwGN67mq9&KWZI+ekN>>&!%`6?Np|I=Qw0lSl2F9B+oh0FdWZxE2|yCv
zV9<$E+tmJ2UU~AOcNG<qAKiB!AlL!N`-ABs`pI(C9~Q8aR&Re?R;T%W04P}TqtAR<
zmC848<n0APM`=6)<rQlb7N?wi20{Mag(mFezCZo|UI5|>luRNZ61}C*3XGI5*=y(J
zd98moZL;cGC!_x7EpIyr&HZ?ta<iF>NPZ3GK$1kHD=VfJ`FY1HG;8mlUrLEc3Lw$V
zZ}s!KZ5-O_6x6(aFnWD|yIgzQR7c=F{&^sZh0#S5<+mq|14{wi*xe};dh*}jV-*Xb
zl1(k+qL>)ihMvyPum1B9E}PZgwnM=E{fpAXf1eNviuiw*;gsQ@rK9*n`zJCf{`+k!
z%k{r|L2hrbwIBbSoAfQc)<5yj(K{s*?&FP~Lq_5e_<9>#+ec`1W@cu{IhmOoOK#f=
zFmMRGDN6W30Rc51*)Sh(R74pGTRWSiw~}Hux+~9ax(ZbU%0Zfqy}cwFHgG2AQI=42
z#LkF{hM#$`UN&0x5YE#x=th#@_lSi6l+-_&bUt2Q`_Q`kl13hFdC$K^&|x-ZMM%4L
z?cmX)Qh&61Svk2wcnkosb;-xYZd2~{N1Ijwu3=*XQS~=Ma^+b=EH-Xlfu;ykGud1#
zBf@B<fu09(a^ULKtE3T-rk0UJ(IeHC&+6y%1pu2A!=|Hrx4z#;;~@(54oY8Ho#_30
z56xHlo=;-eu7w>ue7GE0Ko>gn76yi+`$<u&jgmQVqxQ`sQmSA=U;`Jp9rRqyrZ1u>
zXx-=_$C|X9%OI8MqTZSP`gZ!!<HzF@pT6z?a}cf{#p@CIP%Y!87f$$jQ`02k0swP+
z0354#hEeN|**#D70f-3ifR;A}+C+1*wkwz~dpl**t$(ub`WFzmX7MH~$qroOjZd%c
zU`5WuvcN$_dweq(9BJy$%-GSMPobjZ?2`fliEpdwcDX-Kv+Wu%Wr|TNFY$6*3>H*@
zj&~T4^BIcRd30ZbLV|MO19gxTNu`5L;TwbEpTzJg>b!)6H&|!lm*^qA0YEfiCEkG6
z31)byv58Tb4c)LWDnvP0e<2~d>wlWT+xvf@2#&!WP>v#Tn0Q6Nhf0k1RtX8Q1rTl(
zB9a%tL20<8zaV}t>Uu{f6$!oD*M<=>W2n5uywROp!te}0$=>e#4oDK-=NN3oaxD7y
z<EQuKoe5r-G&VX`!SPtO{PGK4qnDAcPxjyETZi9Lq=Fuz2N>V`s76jHfT!Tx_I#x9
za`PIYBk0(DK{|*d>I8XrY}@qjQXRlj5j;meSO>vnhQ29t(h>i)1?nT^ehe_`*W<fM
zd;X-l51;VrI^W+vs!i3Gp6!neQUBUOx^e>TE<8J2hWOX`%INlQcjK0fk1oSr=~h1H
zT%mz88KF+&x%>!>gVGrIRoHFqpZ#~sj*DY^0hBcH<FhCs!~oLFvZ|n=sU%&wV=?ko
z1K|0a53h{FzsZ<pw$C6MntB;ji^G7m$J(nA-aTXup><cFngssOVt0o55H{o)Ve5dX
zHa2+zMc5B#pM#n|a`$s+)}N+^LJ>vl0O(i3g`Wo_bEj2bN2e6ktOqsT7e1owtM{3t
z{#5kam&hu9f6P%XCoKdGgVWa7y6Yp=ZYb*nwr^o%9QjBS_MZYX3!O5Nuw2i8F_nd^
z(UW9Dq3DLPG+I=8`9CFb^&%pI^lT_&k9(2<tt6M179j(_GhZW`{B5v*RS}Pb57R#I
z0Z&P20~Us(od6g-i03hz9n&S=pUPk%fu=_#GDI9eOStk~K!GHekv<p7m$;Z1NliGy
z=zkB9PI;&`vjV5R2l}<to_i{m1NC0$2}mfDHgct3hlRw4N#+bx&qDx&#7}?&V>bHz
zET7Xt*3XVYEdXXhC*Y(C<!?Bvc{Nxo`0{IUDniH-jDkAO3S!tB!v6)3M<m&TdOvvR
zP#M`iEHr^b%>|CRAV1E70*Z9y06M7!%Y36D#`m~k<3-X`_f+`%10z%z2E+IOG(y^Q
z()L3TD~B~m7a-d^C}^meKIvX=O<mkRZDrB9#85gUI6|qP2mcxl?pZcgksbYr-<CrX
z<f8~1Z()%}USesci<)>wkTqWpRJ69Lf%iU=Z$Iq^!cYPy{Efrx*a|3v;{@Uwv~#yW
zL0egJ*nvWQ(8XMUB>rr=#rC9=ZLDf~4B<~|b1V%>mjepp9E*I^UI-;*&xjlVXoc`u
zN$F%6n^Vt`tSVsj^C`}Sr~4k$bfmfp=zsdzr{~fBb%U*EVA$@qK_RdLAoopMKWIT)
zj}J{vO{VsE&gupi6hph-7y9*Bsts`hSKs~R>e*qG*&YGskY&2{h$gqID06r{GF3g~
zxd!}AZ(~ydP}x9y=2uy8c-%r(;XZDjo=P2#(?J6eD#ymgSnAC$i`C<!s4{mmFbsP)
zMIEc*koIxg&KlFCX@6<xYkup*s04UUR>io>I4la#7mYhyQ3jw2>qVnX27GmeN*7Zj
zJby9$`sa83U930zZZvK-EZx}Ncv-V+m!M6ODjMnX>T2G4O$5dq+HrZr%f_lFM0eK6
zv-$jM2DXL<2#J9yE+?H5v_ui%awB=;9{gtA4?B~;vcaq42rduAsgxAGR*10UPlkH}
z9y`Nr{DCl0*(Gcp=zOjzK*sgl5%g{iw~54X;j)wDBGxn(@VQlE8uT--V;kE2uqE(+
z(IDH4wW}quqb~)l6JnH;!z8uF0kS8-2uDv$SVTS%Dj}RJ^aLtO75=KzG(xN6-U${8
z%0N0z1d|%={p?wgRUXVAgl_=}VBGAAf*6B1;j>(jVBStc6AJR`TiUH1e&fdtAM$jw
z@yCTCQo9Xa<9iGM5I2pe!8~QRFj}&KZsajXK@^fc{V)e7r;O0@!Z@ACv%p&mW2}gO
zMZ?CpTQ-3iH(Sy!z$Vko+;y-h>@w4bJR1iJ26p}jYxTbRxYG+LK6;4v^KL10E)31-
zD)Btw06jd9*j@sc4lnDSFmAgHqAy8ObA%Yr4jnw0b@L}5jByFH5V(HyzIv#?Chnau
zUXjq}pnL{Wy25>A!3HQH;H=ALfSV%WRT`)rWeu-~A`yvRik=~H`1fur2xhw&Z@L4<
z(h`(WXT4(pwEe1NAgl{UUy|NNJ0di(-?0F&d`^e?%oc9?BEv=F{PH;lW+FNi!E7pk
zrLwr5_m?uX`sX`6sf%8pjr>(q8Q@J~k@By<qDo887h8rnPN|5N#9aH}HsG)2#M$Pl
zqUA99U<`_E`5@h{T~RPTe$Pl|4JUjvEsueG=*xTigEu6tA72;~Bkme4r`hmUkEU$%
zKKWF=s=yp-*zx31a7<f;1BL7r+i|crJyGfVy=?};s-iW5<L+aVlM2Y1=5I9@yV|Wg
zs(7mTEeE2YDrdzNQf}B`x<GejYNlNkT;i}#Y_a<nki^6{(a*W{iVTy_HO>DKn-Nk$
zF(e9K&{m+z=uY2?0hPdyW-r=_E*X80tH@qTO3G*=sSjz_$b1sIX+hrLpWkl)7DbkZ
zhQ?S#6D^}uu7AmMPHlNTy@=N7eK0zLo2Z<~vJ{d|bx{@_{{Dz(0uHrkB;wpFCQF52
zo6rz(9NHfPQDy+C`RI@|v-U{wNvFn2y25}8s1_SLmMc`M1NmMXG$j}rwEh3L0+Ob$
zudl8F8)bXu-biG=5_S`@v9UU7krz39IS-l8*QKK+^u!6mpJ^~5u;vk1<m{|ov!(%N
zfX?Ku?R)mbzT`C;_#`YiUdhcc|LIk|2xFSK`>v}7Kly_rRYc?VS({JOg8zTHVd`BA
za+*AjIS~}vYT<*+i&4+!DycchUBVGb>ay`}Z6{R3H(*n!JcB46p9$SI4i&;C?Z-BT
z=eBa+*VzwWMZfg@SK<U;F?^BQ1Cz+S)<QxSh;Y#SG3absYEIKk|E>JM(aAO}YcBD}
z)Je4B(I?vXhe3$%{!IOqj}W**({0)|3pqh6k0{N|W>^}9Jf53g2x<CxS0Bae5@|7c
zwASg$q7uyMpizpuj{Lt5>#&m?7d(QiJ!_Di+W8~$boBN26pV<24ig-kbju?`Sns8C
zme}%Ps^42~I}jZy=orOTFgL(j+*P<Z)v5rua-^#<4g7U8!Uz9-9F~oS=dEF+U^#g3
zewV)Y=dPV}ba9YN`ueZ-)yAux5H)<bvNnC+*_kqkuHv}#LO<9Gl2PuB<A4TZ-h?GV
zBQTV}4XY_y56(6vcq7<UQpAGohxrKOH1V@pj<BMHD`3+qP=``PmC3wc78H@~#OHID
z8ra>|&o7u|qKBwh%jiHfalwUO#YC0O&76iI7+oc?RBbq?3t?AR=X2QE??dq;A`fQC
zntn`j2~0c|x33)spzPJ@dxAplXDWV-20&$nL8HOK8Ab~)*ibGJzJ3->eGlM_FIwIg
z#?oTlLDpYyMF~@EJ5mtLa657l&9JT0sq3v7@fL%PRhR9(yu4CiCKU`RL~#$DQfDrt
z7AHgoa#>U8lqbEw;nqwOe<VEO)sv69e7Ys=#sMU2o(4@c2;DFzd%?(+S7ZbS%u%#z
z$J$D;g+1u1eefqO4o=`+w(Qt(7>UdmZ7HqsGIY~t08!m`aVM+alH7U~E=<CS*G<+0
z3$c=J0JT#BWk^0wS*9h^#AFVr*S2hrN!~u_vYCeSXa(d|Gj869Nu*o5iS8*#!7}8n
z_h2Onzlst}AZ48q(zqt^<i=V?KhCSBird$vEPB?23Jyj2so{23(7M}kE(s5N_|nVs
za2vvTQ_;Wpp`@e&XNnj|Ny7pFDI2fK125zgbcF9LatZQ5?hv^3W{TOkB$3G0RzH>H
z9OE={6~8)8YY=|3s;?ED6e=^%LhvOqqEFSnxv;ev`7b(o)u~%uqZLIK?8MC0S#dk^
zQh;8Lh_%)ZVVhsy1WULK8`<iHP-^g*wFhf5MzXp#kuxJV&3F=0_}KV3>n~*wI7Llc
zu}m5B;_uOY48VZN)#fTI!2|C`D<9MM;Ka>4re=GFNi$YgVu&O?0Pl09x$z037WqZ6
z{t+$JC@&~J_IJ9dH*Hb`K;p`$CRM-y@H%+N`p2i!4_sXXjF-_9qJ+v?<?qM|Tsh$f
z+-hlIP?HaVBvVil50=pYxpC8^c`6i!Nf;1f;FJ$ooSmPKEn%>~s8Qh1EI*G{HFbV*
zZAs0`{E`u^<vIW8siFLm5VUV|fRq;}IdQgfYxEr+JpGfWuB)xLzfFV|>_r4|U!mcR
z<h}Xj6)66Ch-L~P+G$}qsk()SI}7LMo?#BKAVNr;RwE;TwDLHlolavLzM7RI4_%L{
zg50G5`dc(n35Y{MT|KaK)Dz|qvRrc%u}qa5);m)f**ZXS_6!XfDKP@R9B(K=*vVXJ
zP0Sl}i_Xy2)>c3s8xocRz*B@u5HV-h<E!*@K-6`mFzO_RWw;Pwh|qV_OM>%1QzPcf
zlg)Z0wr|^}qvQ-91TXzNln2+YzVBVrIE#CXi5c3Zng<#g>6%>TAGy1y<x;O^gFm+N
zamm_OM$GQ36!Ea&P5lOdqYIoVkufrCMQ_o_nB<MRL>G|KUpz0USGlWr@yk{}x|60w
zmji&7xF=t}u;o4u8@W;6tA~SY;=+y<wy9t*uML!}bFWMd9E018c32->@N7muOpG3k
zBF0(m==3a62ljk*b!D(Ct@jlLj7VjT`qU{{MSG2^`E^u$D7;(^Fhv*7ry95O%Ppdd
z0owE_EG!INBIPQEI9{3?giC68?L9h((=DrgpQy_&VLjw?t~O~HUE53C{!@{#(`vUT
z!HUEpa|oo>K&=_T;d7a{>Rv;53aUw8KR?B9TI23ZlqTR@B0d`TnoVFW4FuMnRo`=E
zyYFmI^%y`Wt+3|j&!1V~O)%Ah^5f#XTIj%m107urxz;AdT}l$saIk!x;N+gK2qxa*
z!CidsKL4+M3%2?GkK8;LoC$J^hYla6U3zeqMg}zS01kl5eCqVTO^*<xDY`=74qD?(
zyrIkVJ|?D8`RkgQ#u~XTzbjhyuT;*n?;&Dzzg^4d1Ac+8UJ9Wf4#eRy06D7+1cpIQ
z4Y=-(Pg6@vOJ+?P);+nGVEqW?WtES*a($leh;*<ILT?uf0AIu$%X+u+1+z$qF|-Ne
z7`TumQEm6)#S7w<5w#@J2WSafVP{xk_Ar!yYwH2C&#BH);=DA@DA)H6w)P^6kSWuT
zwl8^f=nP9w0)b!yDq)_MZ-<dWV`-Moq!L)H2XW~#sH>xM9(sJI9hjWs>Lr?Vh0e#3
zGSD<{^hHtM!ypM2g-+1slc~__J}U|)k9A3Iw?mwlR1Ql8{_x4Ln;tgGswNcxlzzlK
zQpxMikiD>^8Wz+X!J-<#59CB3rKqKt7{QUGl*l7`^s++2!lG~niO_|=*d6l>4lk%y
zT<!W$e6V!83DOA?3>j=rjqK#C4CJf(waa)1)DL25?zF>>;#*G#S_bP;?JlO}I+w}w
z#)oTr82mp@-+=vG1{Wvlq$B3G(#RDaM#bc-TikxXtIr8CF|T@wm(~T!+u!d}#6GR4
zuJ&7rlReMWUd)=N>6C48oo~l`gboFqFbN(R7w@<US6w-1Lo#r5S!kD>e6N451@a{}
zgQ|gOWq{ZL!`zsA`Q_>g02SbQ0v==I+#z03Bdl*JPBB$OvM#E;OU+}@owct{uW_9(
z@a6u4;d}ejT<9z(2Na4eA(CC1*6$rihelYpm`z(!llA7!!D36;!u#)fQJngG=C(p9
z`JJ%62i7VQTg4*nJ$C5cL~3)L_wexGO>=|}JMQQNc;!-Z%;wh>QlTt<e)(*wu`Q0N
zio^QG=dcHz`~kd1W?3C5Rl8e+6JvK)#f1Y{pmE|<A5laKcm|UZZ9)_333=4iYS0a+
zrz?-zbAIm)alp1tesL4WZ&Gw3)4zbCCpJ@@vj4cm_Go`R8Vr}^Q9&4qq6@j&%YTG7
zLT2&9{E7t7NL3$pgPF8Woww4A+f{i@zOs>?12wh+R5X?I<~v4bZ#ZQ?{+x8?eVY=8
z@no$e$L^dF8BN3YmA<>MDZJ`OIKW37r=$3>CGX2SS}qTs?&o1CE_B(nr5cO2_Ji{$
zbUhd;PVM|lIVlRmah?1`JD2Eyeb{9X)#Ff2Ea2Xky`-5yHG4rT4GB3M=C?8Mf8|66
z#R3xBE^@QQ4^6HQDl#v%hGp~ZEQ>AOHJP=^*hvsqjnM4N#}7fPbeIMKN$|xx>uXc(
zE}=EMD5EASZp!1X?e=bzRV^cqP{)MbLGjJ4k5Q0hQH*0EZWj3MVMy+7+)D9H4^Nua
z<sq=K2?U+H`)=-!v-grkPcwQDT7yjD6)zH(CV<>Q;!mORBBlV4HU}|8;WR&Vf)7hw
z?6__1StF<Hd!Ow)9zKM8`<3zlXQXj^j?3W5@#g`vzce6BM^291T-ituW&^`@Oy^;_
z)xi)5*OelQI_JMADY7=L+QFtiyR|yu@~6af;yxkv9;9(IgF@0KVsTWRUM><s3!_S8
zb|Bi`WcyC?xuUaUJycDPo;<N!I(3l+TwEuA^+NeDc79_M(ZlQJta%%s-iq5-vMrrQ
zM@%N`Zt1i2b)(~GhtVTn)^r#>D>q%Wh9ZkvYnSVTO^m$mNqsx@p`H%<>>2Bg#72$1
z+rUu@*5x3GIN)<;B<rI?smEB{#w9a3b&$x=B0Lt?4t&wH027GRU`OQ>*L!#G1~wL^
zCcCJM{M~rj_^c7ts>}h9c0XG)rFR@vKW{@x@qhyFJT|xepholfV{S591qHSgF4<le
znnm;e*}Ie*h%jE8X`+=mp`yI)!)%YlZ=->Bl!p{!UVeT))$&0bz)u(f_>4Bfi5}*|
zC0|mPXz!#<x_LUK`o_&qi@~=6^|I{Yz4;Ug(9Z581%&|3mA7GVg#<I)-8ZEf91Ifz
z_$6P+#nO;>)CFUl>oJbtv^1*^!uWKkKth7-7ms_9g-cf^?qxpQwe+fALNDQrg_X@K
zA8)YAqL#$6zSPq9fJbMeVd*Wr?QWTEQ*WPH2s`14$KWz8ha)bH;Rr<$v_3YsF_G`!
z>A28%-oPZn&GwuIqeTx0+!;8RKZZ5B)}OU?%D(%8I*gyb3w=VdW#wO+C^>0YGli$E
z=QNI}8&ul`u=1KIe%~oEGT+ICY$Hv*hT_WV6SrI+a2Hy=iUm~e|C0QA<E~?;4qtq}
zmtMfi!Zw5`ukah5&opiaQCr=!*dKGUl0zR1h@ZRrMo~rvN5@INaMtjH?Ce#anjQg-
zk=$Fq)>^Hy?eURAhdwYn=B_p@-PQQC%dLfWb+B#kZrdNBu5<<m0RQm<`-!g#T}yyg
z`VdS8Wbh``iGreW!Zz}6PgW@tex-QTLx_EEOjMM?8P5Wf%dLKnBOve2V2p+p@`||%
zV-Bm-c!df`F7QO}hldvN6ksBMDLJVVXaBE7Q=+w|1zh%LS8Ft-59*7q)~?%bSjtJ3
zJ+!XD=7E<-32~m1(k*8x2U3}c)<hI1IS)4WSz|^91}P}AM^D|R+`z50mh{frB7DZZ
zO<u<7V2pRe=Zkp<O|WQt$;=yJdGXkROOkhig2-tsN6HLpF}^B8*XRE_K|TB0kK)XS
zL>B5s4L(Zi#Yx72z)GW<7C6{OI?g13w(aCc6||D*NGSS~J2PA^=UsvqwVuO%2~7u=
z-NbcbdD$RNNpb8h#fBYF19{Z@;3M-x-O0Ifd>C$0c4T5du=o`Os2!5<c?x&b3I&a_
zjf%IkxbSaX@^>;f*Tj7nEUe^*Wv30v%4L8w@B!2vn8fhMIo%UehkD3oHxVT_m#7fy
z*U7Kf8=afv;;v1_7ZDY|Z<`kR<w&`E5;8#y?FN_1tE9X7)UA?BZC7u>16XVcjM{bA
z%Z4zk3vfG<5z&57yFTn{E1Dg#BA|-a4I!*^N*Pk`9xHSgaGXoSCkdP85Z#Na=|+8&
zSKXWmOsxOk&p%+XuwMOYSnKHE=hv>Cv7E%75Ao-|62&W;)ojYY3jm0h=Q(t_Nf>!}
zhEBB{eAGeWps*WczaS;W+kgqF{6N8+cXwuW+W?C<HgVdeyRZ^w*)#~<4`2K;Y`=RF
zwDl^7|E*`(69>zomIl)xqI414#==_)ii-z|?tUPC*cts2<TkhVCuQJ`dqkFJJxQH`
zx9@sZfq>KO<#UxBU6l@-e|`$RSG?#1PM0_<b1O(cni>QjQLAYOX`v=7^fT9Q+Qe(g
z247LXX-C4!$LnaysEaZcRQ^>*XxF#rDJVR?F(@aUzjVnL2YA;eWik*=G^`!|%GQI8
zm*C#kpPoYF%f0ycI4P@u66cB9AUYYNlxQ4N_%4CqEtJ^+<mp{=r|%E}2CDR%h=`ZN
znE=~Fz{$;&mX^+(ogrpQ{6-h!GxWQ5F%dlod`YWD36a>`2<qS`{xXQeu5*@$R!Yja
z+jm;7Gnt7++j(>7MYy%7c+DGFDT>mwR#%k4a3m=7m+Jz$L6^bfn93q7PNZiK2uxpa
zYP2zOiJC&T{o(#Uj}jlVs7cDw!nkzti3*;%$Fk!6f@?PrDhJ7=Ima?Klpo_9-XMzt
zhEt(s*M^<lAZiJLQfGXWc>RYmJ2rY=g_`(%$Y?3#2o!kR&Ida;HmT)W#iONtG2BGI
zQV}Yd%MI6kkb|z=$&Z%n=&pY#ifH~)mfAr}JJ7%HWOoUp^R{rGPCIyQZk0D3H6zG!
zY{Yq4jo1r!AG>n9ebRl&!TQmbLv#flk3R2d%;CRMYrBb10RQMYrJG@*J)*A}>E1ZY
z*h$NL4#<<rGZesK4ATgE68yWs*BrMzV92d)d17S&yWGZTQ~ZsUHm@w8mR6S*e>4(B
zbOBOtING_0fz=f2BbYKOKxf9gySce>wTFNp>Rf{SA5_pGvb>Pmd5bB$9zufxns~Z_
zRt%zJl)yf_<&uPiEM}QgW1WcL;W-cBXMMdAgE`0RJ0LHl1>M^p2FBPptLE3QU)MMb
z$5_!aC?*!n#Q;S4wm|bE|B|l>_Lj%MBfY^1Ztl8Yqb~(*Q#uQVL70HpF`2O}OS}Y~
z-x5k;ahEg(!ZEzZnMaLr3mFu3m-$?aes4mjBstQPZnp8Mkh17<AsO8=4Z$~Yws*i=
zym30yX7pNaOYcmx;-}G-EWxXVV3+F(;na5NEbx&vnEBOdmEM8r*4$Q$Zp%o_wq9BR
z?qrrG+W9spU4s}Adf{D<9u9oX&y8MGl!*56**1wWj(~woaQz0r>b$L(7Iz~ffEq)%
z&R`EiYQ9m2DsCPKMcv;xnTbi}KOi2AnK5xP4j{29p@W_Em?vN1Pa@`&VX%nqngqSm
z+I|kFxgG{!s_9YaH`~8V!KZ9!us~d~@GNj0&xC{G(&S{w@<K_1u*Jz0ZhYz*)uNo+
z8H(c33a!&6Cg^%yTJw<i*HcmP9G_ZV=o4|7FFSqvEarEuwtG^aYOPH-RFYe!pcip!
z`?Tj{U|8|m*Ma0thZil=bU>t;Xse&I$b^X%EMjm+mI{|C#H(k^!Y0|*+KV)+@L>J+
z^>n!}PEdn`kjreh3JBHi?(2)h$h=`zB79UGE!C%Kn${8mx?PpbvrcCf!kRCacmb*7
z5@RfYCtt@Y?vp2#^PxJk?A!NNejeh`QPTy?K1PUagC!%HxOfpQJ<U$A>o*XC+c(2N
ze_TMIfGLe!%?%pAH$NX>X7zKVp_jv+6q1EqC+w$g78|jI*P|pUK>1uxH%@Qe*7?iU
z7Rla<o^get34GkNytwve6hw{A`91AF-#yqsM%^!5yhv_~Aft`)iJBV0&P%o`1rFH_
zQ!A{*ej$vAg7&}U$;pAiH*fIlyXSfitJT)l9)vTTv@1=CTBJg)`~uiUF?7rUANlbK
z)^h|Ip=w<)GcyZrZL?}MBBq1lX#pr&E_r0m-?a1HYAsh3`-+`f4lDOQ)Vn@B4^2l0
zo){~m!C^k8{ahH;QAxY*73xIph5(_NVm}Wt!k8CUJ7P}=<@BWGkw80qJ<8)@X^cYb
z8|UREm%*NskRETgW?UloaiFUuX3`a74W?+J)L)IMLUTumQjJzAnB~#j8pMRqktZgT
zUdY*JnGX?d8Y?P^Q7U?aX<sExFHhmQ(gY(*zLf~n+t$RB2INYtprQQOuxAe+u9I7Q
zvWxTGFFFm(Ucf`2S2T3eDPz0Eg3Bg)7SP;0Ji+*H8L{0FhY=lu(TwpOu+e#ReLApw
zbD4fS<?3|uba#mT1}9t<L22BC(>jY|Gh`r_Y45e_Hn)x7*}808JWw5481aR;paUHH
z$NU!q$65>%`5ZffuEI@IUQ%+TBY7Dj6;JyT<iCctZ1V=>)C7<o@!+WwVJ?dMdlOxh
zru`64I$i?o<<*!Wm|JfMtv%ajPN{e`M2oLyX0*$tRRsEX^rSMBdCanR-xcDmDb@Po
z=;(;~{9HjH9m0Yq%}+KCt#EGrua3oqhM7{*lyEpx(iZ|Z(-w#Xu|uO_Iehrz#C*{L
z*?Gid!iuVr{fqTJC1!{3MY?|DB;*K5X?4X(wU{%CMv5qC&4XG(?u(EcQUb+JW|(JT
z@6bUPo`P|+S@d-}AKbQ+HkIr{v{ot&jcwPH6C0bDW6YDFh0}PU97`gNY|PY(l%kJT
zN(}C_BfJ&5LE3~q77)|C6HSvqAY_Q7U8y%q6y7Y%ho~Z(2?}kKTPb>hiAjl}3#L78
z+7<#%Wo2btU@Bc(M<*wJ(Xc&tVtgKgUREIg5(SgNx}^0<Fi%QTzt#4U<+}Oh7_ojt
zx?b~o@q(FHpYVabxf-A#Heym6=cw&?%3a6V9{({gIkX8%@_koe(AdB1@T8tC)l$Fe
zB_vfg&i2Gqa&rt^O;k;-xz>q9k~zA|>y`xbZa%X&gyX6c<$SV2n%TO&qdhZ979<<z
zEYj7BTn%7nw~pc!B=FVuU0n$UASATW6Tbcx!;RI**P;GU<)yisChNB0auYDnS<tj{
zZFDF}(<6up-H3r5J$%Z~`}_|~GjN$nhpGv|Gf&*sb(8elVLM-*YbqpOaQQ_Ts>&rf
z^1HibcE9%VCeGe>#l=GWoAj@&@C)iPs-jH7pq*KWCX0tVa_)>H1=CS1+EcXU7#p9O
zI3_p%CY7||Dj20H`S|qZOBOQR<pA2yWq^zYG1&dsSA0UyG6L=xNw^7cLrjDGVwmvS
z4TB4$RqtP-iw=Mdg}@Gk^b6zSIJgY^8)E&z9hQVzMM#Gnh4U@7ZCz6kSSvC%kTNKq
z{eW@>mT99QOF8?yA!8^+Dp=9M#+)kuswXKBAq^BkaoJ+?mFBCR?;fOFdAnMgy7)EJ
z|8QLN!(}_Bld1JN4ReM!pj^eNXV=Ov;+IH5FuK&SwStD2H!Ox)$ekYa29Z%UZ{M9P
zL>sL;5W5Z%|5K7-6RcCwv-N{KgfF=!)XM#&&97I)sslYCu=XoDEH*Orhq@4%rtgWt
zVX_E15H^el>oopHlU9P6#luLaW-9XpN}<u;RiG6V5)uLi@a@^xt8a(hp{S6O7M|7d
z%72lOPpo_xvV01~QDC9-Edx3a5=JCTf^w({%^<`R){{8ya(Xx#iIzuhA_0%S57k}j
zMk;w5-a;Ili}|a9`OG8ajBNt3d&IT?VrT^jnA+Qx0V)$~BBF~7d`cP3!v^4mdAd@_
zb3f~?j0kH)?B|eC`o;<be=`Elzb64z5Jb7s1Z#yB0%Q{CkLbT__4CWsEGG=t1oAUb
zFu4gX$vu1!J~KBL^MYHSe}Ow27`ZIf@wNKo_)p61CMG64K#A$tB3I9ncsQo&@c_|;
z^z?VnKl^wGu_ed=<4Q5k0}$1#ndFDV(5}G*X(9@&^&VpmLBTxbYI4m{Iu1eZ{MWP_
z&(?3;Xfc<^gv*;=;>{%_B+LeqiE)NZ8>v+@qpZlw$jC_17vgpkj1)|cbaX@;eqxgT
zEmY|<uQ$Aoq~<dJ6OC8@iZ+o&g3o-R&2+(-{nE?hGO%=Vwspi~n;I}-7e&h0jrk8d
zwT`z{qj%jPSTfmPS28@Mek*}oT0#x~#j8)`;+$v{fLOSeikFY+>gmP6WLKh>`=ICE
z=lF08g$*EuDiZi3xD?<iiIGgZrP)4(>(`^yK58Ig@>mYYZ>Og>vTNf@e2a70fF08q
zds`j^-;pOp?6ImuxW3Y1zFJ+91X^u7RQg(58Q}Fvs2oI>e<7@hK#@WFlMT5pS*>?0
zz6TROiqQGwFvJuwy$`c(EAAjj5K@d<R|Qw9tN8YG9(kYDyC7uft%(aHEMGbloMPv;
zi&9dG9S-A9a!?uKTi7u3FLCJ-PaX#<aD{c;is9kp&cx+;>gSh1d-lVnzGC&tvo&YN
z_uhALkpOnVw6i4gyn2@DX=1el-~0>>0Su_7GfwAoU>5O(>rN7X9FBM(t~59sUC7U3
z786X05@A;0^g#(cjDGML@q*#l^dNvO1|0>B(K@h`PbTg-(&R^L<Yo|mA6S<|gc1N#
zbOC@AZ(N3q*^N3&yu2$WJ8^OTA;Y`k+avj+<`*F7#0nzUn)L-)O8`Ec?GBm0LVQF8
zv%P!B)81IlB<_=yH-to=4I=gp#`9#c0n92XZ)WD_i3kGcH0fzpjJk;WS&Uf`N8n?v
z;R)O(L~ieb^v+C<HcT<+fpy4q5plxpzt-%E@vw3fOVX32+^9SJ$jxo+2la^`ZiJ_M
z$aDXDBq$m}F!lqk6O0Pfd=xG1md%^@LUzRb6f2aj6!_c7j2Etc;rKmjzvfi(>Hiq|
zZ*8?E_FD>y|D$);{js|K_d|cL{eSP6Tv><z-lq9G9R7Qo=E^$!HzTbq!+(>*f0M(1
z3+3<3_}{bef9+YgeHC{zuE-I@R|zJEOwAMfd8DgC9OyW8AK4U;=+e}bOli0fR*d-&
zT&KYd>(wiL6M6cyDJa_RQLs|uD%dce6c&J9v+wW!Ayxv+87t@I^W8tD4-+YwZML0i
z))x}mCJOSDpaLJ5RF#O6f^`4jjLw6m6%;y7@hLdAdhx+z$2P3!fo&ghz|XMSlL5jQ
z05=9kjt@(<04^1SCqRRGPJo{Nr(zsb;n)l(r!20=G1-l~+LjaG;RpxI6G40Y`nS>K
z>~Wr{i5c9vl>o+n^!o?=ng_DVlCVn2N<_mblR42BWA1!<XvdU!*f4pkl`CP|<gy&1
zC}3$K79U9h`oUkS1C<{H5+-618h>vX9PR9)n8e7G5isaeOxlpUQX^fp&jWmmiIFK7
z0@a9`qyxso?8m2l)SeqDCVKISSC>xU4uc|1;_e+LybH!wvKb!Z*Mj3J1wo*Lxe-}h
z|3>&;;^g}N{k!0C*=@X_&BiA-UnEY9hYx?Yqyy5(3JTIvFsZ9s4s*mUM_}>3JZ4Rz
zOVTdcMDF&2UPb0Xd$5kv6Hh7p$0rw$OiM{hj{kxjh<`p%uJXGFHwH0nZK3f3AtnjH
zTQx*(At2fsCg>#LV<fN%SIz1|qs3!=SUpc>ARWNU60k;ybBsvBXX68TfQ+d&Ou-?R
z-e$9ek+;<52xv^Y0Z=v67!onz+%t+>c9p<S9}aOCdlZOkFCahl08o?pOG5R8OMzYL
z21lE5b1N_tMg*)D&t?Hz5lNWXaWRpF&vYl~kC+BV$H!A!3IM$QMsX!1nVmjFMs8rK
zJVn4MX2@{+6vu8Zo%0EHh?p(mK3KVmu`d{JWix6A8?WeyC6Xi?jN4MZ($bD&l$1E9
z%7I3SWx>Gyfa90(*t2@QPnx@)g@6fHYl#DW`tTvSFxaoeIA7wkN|!Ty)o<WGN&z^>
z-Jt#$|0Q>R26v@R&+Hj0{y|qo10aZT7JvL|2`nm*cLf<NBjE$}@i{|bex*n5Uh$f9
zd~H08Ztt9Oy99p@o9BNXk4~-DC4+y&`A06*BgYL3{{qq(uF=|dQt!3l7Y5s)dHQxO
zwITkl!0*+z-+$O2;!aFIFyjBSC&qjWcG|1N<bAkyS@t9Qn>TOXX~i%hcSpeMub9MS
z!4mb5b($P*7pR#Efv3_pI5=2;5#uCLWJ*0o4sOYcadM$)l@$nY_EwCrHjmi=hqHUu
z;7U$-E57_ZfeB*loWvyNBtLxo*vnU7{nhqJjpHDod(N#c@nB0hMPe{(W8Oe+_U@S_
zTG0S5L$+;nhH}d`xry%ND`X)B_{(}`G1%n${CO1lzcJUWs|HaJ#*Q$-Rt1S@u${3_
zpFUOB=B_<=`h+8ofJr4o$O0LDW19zi8t)^^0&Q{Z3y25}t|gFkF==UO>XYR@%+LBx
z4hb!Z&mH4FXWsZ3Aw3=!=_8BGQBcwA*?eoKd}W|#8y}-v`O4xanCCZ-M{`%}VmhWW
zwVDj1f%Wp0%`o|Cq({{%H>R5FF`O80^(0VkjAi)c5sv~Tu6b2~F{iTN@#NU*3oAFt
zZmT2LNU6C0rHq?({Z8zMb>wP7A5PM1jA8i5N(2czsy+eBj<GR0a`Cv(==-e$-#<K-
zU=9Z<E>G@LY+=B>LiiAQZQPy|OU8}J{kFuAS~~^LfiE1{;lZh^*}{GJL6Fjd2{&j-
zizXJSm$-MkM^p#lM&{)(2(cnTLdumR|B{P-AX_O(Fk=!XoZNud;EemN*oIaTFZ81r
zd{zvC+5pKM_fJW}H4IOkSwrsZB_~|+B60rwWpWcCxdPPyiPCQL!%p1ln}_rYwNwFC
z7WK)YS)K?mtM5~)aQO<k@|93(ga9M=*s#|);zxJ~1?E`IJSz8`^OQb)s895ijg3uk
z>q$e5pCJ$v@U9VG9mX$B!VMo)R8+LOMETQbW+rv2xx83Cxs2?FJ=A)zKjJaO*Z%9<
zTjI+0D`3Rs<&iav=RO8$aoP);H90Uz%nx~tC*@X8>eWPg1Xqwj1Ib0$!eelUMHJ3;
zEGV#^mJ{JO*D8C&buPFGt@3-ZSTz#(tu%3Sj&|_LIn6S!rWW5-e*f9ru75Xo|Fzl2
z-6W-WV(uXtr<DntVLcpJRao5wzn}&#ug2oR6=5#aH!_lVR6XkziV`R@UXd(JY&4EV
z7{J5lR}!@S3fvhNaZ!a@gX2(o6I&~8(uqMNs~K^lo>cI1<o&waFiy0lyk^X^ylEIG
zciq*Szz^Cp8qm>w<j9d&xOkKs95Kbh-r6?T8TRVL7$zccCghlXtxu)H+Ky=<Xn`zy
z_ZAJ<o?E@{T;G$|C6TXWFW>H|9EIgKh8S5i3&mH*EzBJgILE3Gqhq^(dXOHYgsN1r
zWI_hv#!I|z^(j>buN;`#l>_4;Ove|(Z+3J8E?}i=MXqbjdq=2MKZ?%A%f+900=1Hl
z6mgjkTb;Yz<AxlidTS!xN*7<7Z&|t7c4ZP!b;s*fjYy2XvgH3YLHXDh4eNGYTWwq^
z5+yhY??j#75N6M>+2$cW{Yo&UJS;dEf^j!2FX-wUww1WM1|F@Osm7p@*;{elWpytv
z{ONv$QBLSZvV#qACsFtk28oRtr!hr`g}_;hxcK6l?LzN~S#q;jRn7_L8JqE{6Xrrn
zpZ3gR=${7`bMh}PDCP+m62VO`e!Qqz`jdGFR^5L+{_%5{++}8_BD3BZlo*5SH>Vh!
z?dME&Jifv#<(ETlUaHDL_mlS$c4Tr{uw0+#fv)Pr=R%CxhQiy@7p+QcztB6LG!wS$
zR<{~gFvsP>SAt8H5#6#9Dz3C134fx|JX2sbo6`T&-nm6Jd8J_(YaKhbm5CPXk|-5w
zsTHx%VmO4LH7o=a&=xssZ8_+OKmv*=CU(|R&{1eOSqsDyh(Z97i3d>W=y1>wA`CWy
zNK_Jn93==C5t#Rjbj_Okx%3LSN%;SN|9ijt``-82^>f{nN6wZ?i|~7Hx`9}|wBca(
zRi_gh@9I=&iG0iuq0SwEUaxo;Zjci?4f7ZxjJ}{n3jF}O)F_$Ol~2I$9j2}m>F{VB
zY~!*~P~XWB0M;cVXS!<T72=UC^D9YC_J6cZkCZt~t0>q~H%k7B?8-o%GZ^GVmha@Z
zR^3N=9Z(BdxM~J1fX|=D5C{QP)7G}n;H%cDAo;#*7OZCGvRJXzgG-aYsujZLQIH~E
zYnD>q2+JAOfT5k_ELDcVq<X`q7JX21YEhKkvEqF%(|7@mIINF4L1j0)H-(e4i(|Lf
zx(D_|xW=P(5EhZYn=oW$RhgE`i^&lUk49pu*}S-7`&WULNATVn8GRISb4K(#`_!**
ztw%{%Q--c{a`M`^xVVy9*kC`lBy0wCqR}h0N`=YLm&^4Mvri0|mby&5ynVVXn>Vy4
zYIa{#=1|V@<9;QzuvaZLH;0iG{3-wMg}4hW8;`P<D>q=|48`r`V@P?R`$WlXFXN&}
zUR?Y9u#uPQ>PH>%CT^YE;CQ9dwt+N*+$+E}w{-9SKyb&`U~iE(p|2*_tXyjmFHd@U
zRh1%6deoBS)KI`04Z&z+Fv#Txg*HD*mcHY`<_1o@(=E{-FPBODO~o{$Q&%6)va);+
zsVVrC84Ln%X$GOF4%fLvSIkNq>io>!{(;UPjzcb2w||YFf6Gwp16HhCOk6oKgLUMl
z2GyQ&|8!0RQKcZt4P0IWpRBLz`rtoqaVD544UNdn`hsj~g`ZMH)UiS&lWjD-{+Go`
z#%5XI#(ALKmFp17;5}-!eKReWjD^hK^E5FK7<L9D>75U~i=RBLX_P)as%$lh6P}!I
zv})_WO#Hn-Y?vt%4v=_LIYgi1w+Cx1wX;fKqxQeQ;z;ygp(9<nYP5#4WRpYbO69!Z
z)3D|0P~-Q+L_#MU*n*@-7J?<Pq+XIkb(5dp`kAURp=0~O{jVKzY~0SCJ*#PSGs~oC
zF*!CN;Y8qUxZ|}p9D;$~z?}orriWtr3_SL5-qcg6P*n^y>%X?_dJoO7^9#KtZ!SQh
zY;B1X7%sr|faYBQz!@T8f7nI%3}hXk8vKPJ0tm!o)v8q`tX>wNR?@`vn$EGc>b4bm
zaJ4?wXfg-F^j9kMd;wB#l|9!y8z^k-n~tui%+z@yVPx?)_zTbiRb>4w9(Qt#W*1*f
zbxHb4yA7F<$Oji!Q@e6fuMisKDZZQHb95{VEa5qJk;jXd|IbytfHB-$r%3!9c(c5`
zJo{#`lQM?a@n*8VKei-Sr3J9gf6(NcnUMMGDMM*)PEcd?UxUQ5YugK8@546GUa^wG
z>$34r$onkoz;pUYB(%;{43x&>_Y4SRJxPF6g!h6bDxup~_8=OqZaG(kp!I6*g#Pd7
zq^xmXIXj4ETKxb>s;zA`nSRv{e_WzPEch@NE}@gtg2tm<3nI5Q+G%q|!ke2l_0q0F
zY1l}jx<v02JQ@@)c03u?em#IY@#jzZQFEeX#jJ3}lRI|7ZT1zLnEQ)Eh6V20Q3p&9
zo8I-G-G!bNv6zsdQNuE#L$^k|SAd7k2dAFFAk2w;Y%zIxbO>+atPL1KVFYT@wc&qV
zUR7a-ela52R|?5v_6#QtK&bn-TOCdguG}rx?QkKOm^}Li=9QMmi=4dac#G?MHgLI|
z*U#6;<X+Lk@c7B_P*=dJ$PZMpssg0L%e+{sBsxQ9lY%4#`BG(*4;?Sh7#5jf1uuB^
zrNAvkINPnW3(eX*$e|`69oQ~Dnqc>zb8;egRsUqs5r6-`FI}-yM2@%IAGXFY4heex
zit_B?zK1M@PgA3v#55vjZb<diTR3o>t>?@%I&fy)28k#BSqMCA`Fyc0@FeQ_0swP0
z3Hce2`G@d8(&f9!R)ggPYq+bMTM=agXs1PPKrG`My74Yz&4mCq=-X~=Y{s($L}nyg
z4(R0)n9$B6;h6{hkIw*@-Zf$0K5gL`4tfaawnmJ1*Rv*9Iv9Y6W|WQW4u@yrax*cs
zG=tcOY7>s~*JZC<uGk6f1dUH;TS)gt0dVjI_9@T`SZbQd2#NP6pT4obqQ`m|yY;|V
z^KC<u^EV?2(YIhr18=hHY%1Tmzo(}NavXXcW55&i5qBw|cbNe80ak#%qehRU;xJN?
zh3JG9;%t-icz9dD_SHD<M(<bJU3rSb<-&6pjIV~e&vlGuI&)@FJZo8g#w=rFMXYK3
zQJ1QXQ_A*h*yBR3#{APZ2^p>PsF$3<Ml26)^x|-Zc;|&tbi3{MPyDiQlteXRx0pK*
z%R9Ed8SNP(4;N~;#=m${r*CeIZCPXN9C|^B0)!#w35k3G)r&$Xj8#Zr28mOT9<BFP
zitK{#CEnf9=U7pt&z;-rP@wj0v+-u`FICs=SpLJr_{P<>?Y$0%4ab0Zh^srM-@DYt
z^wCfd5m>=M{bf=|vYE^vY*0_{9qBz0F^;EzZo7ot6OGpne$a-(&F~H)u~wjyjKaHd
z9y+9m71}@RBA0s%fd!z6I~{5eQ7E#pw>U*GJ;^KDC}{MEq*^I{6lZ0fy9s`rY%-PU
z&=fw2aj#1H(5>^>>}gp}HCue{47@abcDtTw!l0ldpra?)J-FM*X?%x9w`XT+BX3_q
zLO>^~KbbfO<APy9J#$Iry5zSxHbTy>nro35ya|iOu&7C~Va?Cz^SNEW;Bo{f!Th&N
z+MF~$o|4UbaU;#5RN6A?Il|mmK6wZR15}O5tP>C3JB1<;S>UYzcl*-^^FP79DHDUT
zGsu$74#u=#`R@X60}YXYE`T*cj%hI9vS^9LGN6;V#CERR4)=N@IlW;KBqKUzO3L<;
z&k49iZSZLOT^>?q+m$7`h5`)eGGNyKjJJ`HJZ#A0CL||irK5Z9!q}LPrOWomnh#`U
z?qEm}d5Jhsuq9@YALNFLa1_K%z9ty2fT_C<RT?66>0U!gFNOX|gP4(lw6Mg&Vhx>0
zhRHP@ktI4}!s_8}gwek<n*lkq=huSTfv!Qt*4-(%C_lWspW|?vU$G$h!t-v8<RibY
z)s8TP<bJ`mX7v;~H!!OjdCT(EaI>djw-|sC47y`$q_S6E7czAEYX6mn93IE62kZ55
zf(FCBMnwv$xM5kK<B!}?wW4l(!tZwFhx&58#g8SiXNqV#Pbd!23+{Y75NiYz%ysq2
zPp3`_yf<fxoN4rym}e*ezC{SWxeae&iH7^||A8e=8sCy|`ePQ~714*fyLxd;zWM%d
F{{e9kJSPAE

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/merge.png b/latest/assets/images/social/reference/API/trestle/core/commands/merge.png
new file mode 100644
index 0000000000000000000000000000000000000000..388ba0dfc9c70022e636e86ccee3a44c188944c1
GIT binary patch
literal 30297
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/partial_object_validate.png b/latest/assets/images/social/reference/API/trestle/core/commands/partial_object_validate.png
new file mode 100644
index 0000000000000000000000000000000000000000..028a95f1b2c1d73c68feda95383be8897808b957
GIT binary patch
literal 33026
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
Ddx!to

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/remove.png b/latest/assets/images/social/reference/API/trestle/core/commands/remove.png
new file mode 100644
index 0000000000000000000000000000000000000000..09d7b080a861d465ae27e320463a19788ce91f85
GIT binary patch
literal 30114
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/replicate.png b/latest/assets/images/social/reference/API/trestle/core/commands/replicate.png
new file mode 100644
index 0000000000000000000000000000000000000000..0383144706d07f36fe778d1d62e5e59a9de89da9
GIT binary patch
literal 30234
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
J@%y`y{{wh|Wa0n-

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/split.png b/latest/assets/images/social/reference/API/trestle/core/commands/split.png
new file mode 100644
index 0000000000000000000000000000000000000000..cee2b74af306aa5a4c73d39b3a52ede486b8056c
GIT binary patch
literal 30089
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
Q6a!B!%yzR2b{;zMAKCx{UH||9

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/task.png b/latest/assets/images/social/reference/API/trestle/core/commands/task.png
new file mode 100644
index 0000000000000000000000000000000000000000..9e952e27888b755785d41c1aaa8d8bff94a0d414
GIT binary patch
literal 30086
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/validate.png b/latest/assets/images/social/reference/API/trestle/core/commands/validate.png
new file mode 100644
index 0000000000000000000000000000000000000000..cbd51678d0ef857531035e40c9b7a6c866b2a4f5
GIT binary patch
literal 30238
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/commands/version.png b/latest/assets/images/social/reference/API/trestle/core/commands/version.png
new file mode 100644
index 0000000000000000000000000000000000000000..bd3115f31900ba39054772a2b2286e8cba37a900
GIT binary patch
literal 30126
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
PTg}nlg~qcz_|v}u3E;9b

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/control_context.png b/latest/assets/images/social/reference/API/trestle/core/control_context.png
new file mode 100644
index 0000000000000000000000000000000000000000..f1d668de18348df00a9336124ca5aba65fa1a714
GIT binary patch
literal 28646
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
F{sJRV4($K{

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/control_interface.png b/latest/assets/images/social/reference/API/trestle/core/control_interface.png
new file mode 100644
index 0000000000000000000000000000000000000000..e49283eed88c240ccdf5d6c36e5a25a4aad3a7ce
GIT binary patch
literal 28433
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/control_reader.png b/latest/assets/images/social/reference/API/trestle/core/control_reader.png
new file mode 100644
index 0000000000000000000000000000000000000000..57469c42dd28779f0006b728f4af9a4ed67221d5
GIT binary patch
literal 28380
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/control_writer.png b/latest/assets/images/social/reference/API/trestle/core/control_writer.png
new file mode 100644
index 0000000000000000000000000000000000000000..0a860dd4ad9d93012c5663938d102d2cd8e24317
GIT binary patch
literal 28858
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
bGmP=;nAwr|g<=i;*OxC{wIqG<`rUs6pnBUD

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/crm/bycomp_interface.png b/latest/assets/images/social/reference/API/trestle/core/crm/bycomp_interface.png
new file mode 100644
index 0000000000000000000000000000000000000000..1022ff2724b275333fda4049a3f59338bfe1e086
GIT binary patch
literal 32145
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
Lnw9^Z=a2sYj|f&e

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/crm/export_reader.png b/latest/assets/images/social/reference/API/trestle/core/crm/export_reader.png
new file mode 100644
index 0000000000000000000000000000000000000000..ee96930e55ad436737a5ab8a4ddf7722f8b8d6b3
GIT binary patch
literal 31202
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%0Af8UZwMrTd*f?e{o
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/crm/export_writer.png b/latest/assets/images/social/reference/API/trestle/core/crm/export_writer.png
new file mode 100644
index 0000000000000000000000000000000000000000..f763370c82c0522772ab81376fb6505d8fc56a1c
GIT binary patch
literal 31666
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/crm/leveraged_statements.png b/latest/assets/images/social/reference/API/trestle/core/crm/leveraged_statements.png
new file mode 100644
index 0000000000000000000000000000000000000000..633761721e11693d8a998b02eea71ea6fb5faa47
GIT binary patch
literal 30779
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/crm/ssp_inheritance_api.png b/latest/assets/images/social/reference/API/trestle/core/crm/ssp_inheritance_api.png
new file mode 100644
index 0000000000000000000000000000000000000000..d16e1576fd08b91727622bf8bf5df336321ed9ed
GIT binary patch
literal 30112
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
W7ay~1*;(=qZME59oxAD4`Tqc_3p6MI

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/docs_control_writer.png b/latest/assets/images/social/reference/API/trestle/core/docs_control_writer.png
new file mode 100644
index 0000000000000000000000000000000000000000..850964abf25bc85222891b5c1794471993983442
GIT binary patch
literal 29931
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
W9C+bQ7jDvr-E8-jZN`^AC;kiIZU;L6

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/draw_io.png b/latest/assets/images/social/reference/API/trestle/core/draw_io.png
new file mode 100644
index 0000000000000000000000000000000000000000..cd1db61e71b79de49f2d80a54ac01c2db09c2723
GIT binary patch
literal 32372
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
KazFO@;{O3OZB6t5

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/duplicates_validator.png b/latest/assets/images/social/reference/API/trestle/core/duplicates_validator.png
new file mode 100644
index 0000000000000000000000000000000000000000..49827b038c4d1cd68d20fdd6cbaeb6ba612493e2
GIT binary patch
literal 32493
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/generators.png b/latest/assets/images/social/reference/API/trestle/core/generators.png
new file mode 100644
index 0000000000000000000000000000000000000000..73a060eee6887df2feeb13ff389b9d16ad58e815
GIT binary patch
literal 31646
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
Ny~)mzC9n-V{2xmRJCFbX

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/generic_oscal.png b/latest/assets/images/social/reference/API/trestle/core/generic_oscal.png
new file mode 100644
index 0000000000000000000000000000000000000000..a6e18fca9ac60454470f5b0507c2c21637eca388
GIT binary patch
literal 31068
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/jinja/base.png b/latest/assets/images/social/reference/API/trestle/core/jinja/base.png
new file mode 100644
index 0000000000000000000000000000000000000000..67b7f6c45c79404c67633da7587d50dc54b9da87
GIT binary patch
literal 31902
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
Xzt8i<ah3J-U)zk$jncR5`|ZC0{mloz

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/jinja/ext.png b/latest/assets/images/social/reference/API/trestle/core/jinja/ext.png
new file mode 100644
index 0000000000000000000000000000000000000000..49bc54f6281140d6e4545fa1964284fa77f47c12
GIT binary patch
literal 32119
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/jinja/filters.png b/latest/assets/images/social/reference/API/trestle/core/jinja/filters.png
new file mode 100644
index 0000000000000000000000000000000000000000..0b225535abf744cc7a6775809e998d3e8adacd58
GIT binary patch
literal 31664
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/jinja/tags.png b/latest/assets/images/social/reference/API/trestle/core/jinja/tags.png
new file mode 100644
index 0000000000000000000000000000000000000000..6d65f9b1ce877af510391e02e6c9e3a5f9859a08
GIT binary patch
literal 32698
zcmeFa^;?$N8a9j_ASNn^q9{s=f}kLwg9V64cPJ&@E#auBsGyW0NGK&8(y54)g3|a9
z(vnIyyys$O@9+HwzVG;c*mLYX!*+P$UiVtpb=Gz7N7t`i-m;ltGZhup7V#?=WT~ju
zCR0(Zw%fQKe<FR(S)Gc??T+|`^YRYC!>#r<^7V7eqsLx9d$!Gq`|lcO?(i$mcf8t_
za-H*`rvKyplRwTUtNTCRa(!2_`|7{lSJ!OXPm_Oznrqv}i0M=}x0$aC8+pZhueOS}
zC8dX?+w>0cSWg9hx&2b0RP2HuK9BtMYRqPO?LR-d|GiCn)yj|OjMpmv^Jm`}R_*@h
zr}vlK*ZuQT!uJ3D8dl<e3$n5u{y*IzZ6hK7>_JwBg@uJrrKOki^71ZRICA!^8V@fo
zi?DF(S6(s8%m40F&app#o@JO)Buc&ZM@j|p*CgK%d#9N2%8yO%(uE5<cJAyM>#4LF
z>lSa$G!GqW%U7EkrW})CJ6+9K^7O&O<k*#uau>gH<sr>}LHPr&GdBzy;sgD-)EZ*#
zEG;dqetkO>c-lN<VTxkDW8c2PmPc<s{bW@BR+Xrcdx6bA+Jkn#ktN05oyxE^C%rB~
ztuftqEn`{Ps||SHVAD?zw~zIOx>e*kjvqO7s&3$q#Dxfx=G2-5wbQdBxxaN=b8LBT
z&sg+H?PA%yDqz*2Lx;vb?UXL_q~kck!z1hC>&wE$C6%b2&75ohJHT6XNjb;<_sEE0
zz~05VNnh$c$IF%$=X-{l(^8G<*+(ZQZKvORrY9$#NDC`zoBQ?FyJZn|hl=XqmHV6N
zbf<=zQyoTc8rDWVZCy+^r6{^C%^J*(RdPq(o*kooc}Rk1H7AFIqhmQ%j(mE-!k8qz
zkVA4^qK2Bpi{o6buCB6?5_E>`1^GhrLusjw<N9Pt#c1tz4Gkt023Yk}1TMM#EV{#U
z<Kx=XRU64Cdqz1;4wTnKO7@JFGVPI;F1@%eBqU_z8huzKBQ*1!Xb1POY+a>zX!V*k
zdc!}`d0ggfHf`RV8jCw=s@qrfdaUfQ_Zde!7NvKxkrArtM*5lKe{bBscKv$Qg$xz^
zS&J|qKBwranL|AmHTvoIx0ko7<k+x<Hf!^)j$ci#2df#Ol%(lFnVXp@Yst12@P6tW
z5gAz?BJBLdtUbpzZlC@d@?|f|Wn1-hQ_KtfcXO$paf!#@%W&hy7JSwx2V~|R3rk~@
ziz;iiZ#T7bHZh4`nCbGi`dPF}TwMHltU{c`@3#D&5a*HYTeohlwZm2NI8T{0=Q*Z*
zDk;gf=w&HhoNnjVx;=W|X84D~O&y&cx8?azPOXBL)>`%kyWt-!E^`y*(@V!fZ_AG4
zPqztW4pTCvH645WZ&QLr-P&%9lkcc4jCT(daml&o;gMtV#jG`_{Jmjqx7PC93)V<=
z{^On-E(R*~RQM~%%KGHAVvEX0O89eTWcP(Q%d4usQVGgzcclz_N3+)B-+c)w4i|fn
z<Dx0wG1(s-`f50r&$uDWMKdw6sOVf;-+4B?mR--%xk2cn%r5+=$BRMac2-4IRmMzP
zePC*8YF+Y;;+CbEcW)FH?ww%TdGzWtcXxN8OqQcZE1n$^>;92$yqglQk*lcx<>d{#
zd9kg+-F^bA$x3TK{`pheaX7t^(dna|u_Nx0aZ<kiq+`^o?NxXDljeUHwhv`wTlY!W
z*x1||E|?!Vn?@PQ>Y~l=@;W<a+SSv;^7hhGpOVLWDg${9j<B#?tf{H##x6_M|H|Ol
zaevPd{M9}caBXkCVeQdc7w&?YHzw@`8i`tk#|;e)chJ+bwYx3n+u&$Ri>4dZ`%Jev
zOVjQbJc9G?^Xe75L3N1#?0BDKWdK*g0q6Qy1!iU*hd<i0lZ{#|?CcUXwY5FCwjBo!
z9IqB#&Qm#a>#;_zUEouVZvv&SP8l+r7tBTtHKm9h*UV$>@9+0{_Uzy>=@7sB)O#w5
z?yRA{J!;mJ9Nz5kcsJLM?a%Q>l^d9DAKXC8_^hc(SzKEBh2)Fl<#=P0$wtdHt5<iw
ziw^Noh*K=bH)6r1`uO;ClM|1loc+6C{!?XT<v?GwR-r48+tTe>EFFu0fQqb~T+he*
z)TvfI5`kwd-zXm2mHFPwZm8)H^RoJ`8?$3QR*Q4Cj~+kv#rpM9ybm8pOG-*=aa&$Y
z)h*v4;5-$NMGb8DjZ)cDyj9e%_iK=viF0?^b{Prrn>XK-%*)BiNqHyXLluR1*KtV9
z@5N1ZqUSex`QE6$!n7;Xu=bJ%4Si?EsLZMCMPuz81%Gx0PS>v~YMEw=>E2JD@)@7i
zE!*~(!f*ORe!r+|-nS&>qeqU!i2EK@87i)+_NQe$6DDXk6mwi7$Im=8Ffecc^+SpI
z&4Js0&ilW7`SN#0b91v%=ch-CPhC1cZA!mc;<=is8Y_f_O5hYZVC;5HZ`iJ<@`X~n
z%k=At@^UtdYZ7ef)_vD(OZVF=2P+kOZ26k8JYFqYA0h6`xnwh;$X&Q#b;npA6`Ng9
zFz4IseqkqhKJ&J`q5>T5C^Q(wTUvXLt6vv(p0fFsqBAJHkt^Zt+soduq~7*THEOxp
z{?Hj|N_jhndq6#WnJuzldC8e>*Dk;4#pj1F#~a1@$)alW<^|X`m6GFhQAYkdx4F4_
zx?bh(xb|GZO02T~ix)2_p<83i{3yr5G$w~Bjh!EC=O5HBR5Ug!VGY@(RRmc#Y+;B%
zYuK{?r*&Ty-(YFYgXMeo*7`qtcKwzcJw5$Ey^>b?fPJ-!ib|~QV8eYc(}b5V_bL>+
zx}=qMl~Ki^+7JBvaMz>Pw&UYEg>)l@v{BA=%6OsTWT3CFuQ}D+M6I+MU1E=?x3?0P
z>igs-rNM@T`uaGfgb@y5VT~<}XTIGi^*X#JJ}c|Y;~Rfa$b-jT=Gye%oN;I=bSq@n
z$a(*6tI}HKk+%O{XA;&=b<**Bb7xoAR}mdqdDjxGUyNL|SF<TObkCk?E6hK6LL)9I
zSt*BG>zMIQAufPZJ?lC;kLfKlZ{ewzc@s5~_sx`|uF|6nUk#_sqMD=l#m}{-Vb${f
ze56+VTFZcY{sOnM=EkB5kNt@HW6|jxs~*n_7cMBbM5Da<Z55d*id}NKeLMa~RdI1~
zrz`cAE&kG?i>IpVIjDE;+I55+OY`4(d$w=cxba!2+mZ^qQlg2iRzX2Qs`iJ~?=<ss
z>P^*I&YV%M2;efdb5>Lg=r7zq`7%E*Pxr&$>-0-?{`%|hc-3@?fa4nMI8d1?S_x{I
z0hw)1l@rTn?MM8!?Bg%Po#yf)wW&Gz#$A)9<nuRg-i!~iPVCI^1~&hB;I*J_>cIG$
zv~}y&iAP_1-6FhY*C8|M?>2FJG#x&0(u=q)<%yLl=h`JS?=3GcA4qT1l=~WVTFJi6
zG1}?poeg#G<f1vvl=7Wy<+Ns9sM&!b@+TYANKcJbNz*q%aay+&VF5r8iyahe+4b27
z+kUs31l_)UL4B6pr|pc4Vx0yPGUex|h86Cv-%?lh{BZrFoyR!MDCiqPE`kI5lx+v<
zQf9tJl^$@u>geFW`rNI6Yx?Wy_Lru<At8wser&!5LXz!86)y4Sd7~ai03Aj@-oIlI
zc6u-9I2KVdeEat8v58rnnm|+gsUelgqBUD%<|YT@y!M}sB|t|{PcP8)v{7A*kjvLs
ze3d3a@$sB|wgd9@d5+dNvpe}*7aSfNYxjN$q*ZD3T3FvOY*olIgJN}N;pFtM@5Mt)
zhcA1@fK%1-A2@ITpKYj5Df#s2WrN%e@6xuoZ3D^PY@TmeJ>SH<(ICIDv@pB7Jt?Oc
z4bphZ_0^j(woK`BxlZU&Uua`%qovQrFOw=LWPv3y&M+<Uq^n0k|B~T?Wx7h~p1#ps
zv*G8eHS3jIrtWSPIYG(5(c7JwAoKQ8xX#wSCyF|C9(j85P^PA~Hh67LzU0MdXt!M8
zGXG_66AjJ#naO5~+n51c5t^%_eY;DhO6XGtzSO-Td?rob-b>xO71O-9Y15`y{jaYS
z6G$Tn8sSz-43?0R;-lz~b(ibA0Q@LLMnt@P>g=4QFDW2cBysJUB6r@Ozfrsb#wI4@
zv45jN#{|bticU4@=r4YGd9pY@6nO4k<qPh(IHjcCcbn<hl_wpBHYM9M|M%P;7ZnwK
z{9CkD58%3@y1II}nmW>Lbmw2ElWijNaE0YLwu4{H3SAd-uD%wmADX&R>_I13^@`8<
zix~yLs>F18x^OwLl~hM@K$7NRU=t3Tp{M&!ziPEZ3z`Ln`fB#ODMcrIvAOewmMhSc
zw@`hCsao1F8Xf17P&`WeeXs5N_8E_+91wL?2N=F-=Zp>}wcHvl&6GCpHq)^o+hO!g
z^KgKxk>j90*ZlNvbGwr4va&0W=O+R8Qt=K#nf`2YpA(c0mRHBfyzPGLE#d?8eC66T
zFI`>Tm#$O&Wu=UJ_82tu-q~>AMDCnEu#$X|rbev%JD+HiS%EN_5?dzVucCBpTY^GI
zLOjF)9O6azs3rJUb5e8O=f?um4z|la94lpV>&{&?FI?2OQv*!-Qgui7X+*>kboSG^
ziw)zOTL(Tr-KU>9J3qhg!08u}*Avk7_^10=1E#X`x!*J<X`Rj;Zs<$IVb!0;$`s$!
zI&I$Ow|)!56};P3KK(CyYZrkHPaCJ1wF=_+r!=+WXnrv>{{H5EiD|1LTH9<}Us-A1
zjpFs<*REArYvBN~Ff;!(^}C%r^!C^z(&ruj5>w(xT<P11Jv}{<C9_FZs5XyKNpqv`
zFc&$jmR+qp$A3v%JFIvv(}t%<F8W$e?jo81ffuV+ufCdz`g;ZM+=C^i4SJFOB-moX
zE}(bcwrvMRL_~Z70}ZR+Z<bHFc`+O4DiZj+Cd*Riooae4=*8y*@xn-Rhl>|4_T=VA
znm_6xyR_L9=RQklX{JlDy05|f0o^*U+h0;rQg{q&j?DH3nSaS36zjcN>yL@$Xz9=Z
zf~VqD(vI-+H+Te6qK=H{5NKIeaypswp_dnbF4vJGpKcs#7#3Z#BV}Prm|A31lxn^A
z2%sWo+en%FA4S4M8r00ib#)_dPu45(San}9tciH!$Dvd;tR<Jv_w0*aKgBX*N>Bd!
z^=GXvSw3%>#=!@4>tbZ?FEJ*&F3ydC6iVXdGzWy5Mg)}O{`n4PH0|s%jvPIj<IHdr
zr`G57>){c@u#E?cQnlL)Ty~phPDPtt_CDZWR#qldpKEVkyEr;Js&BfP`Yq==q3piZ
zR%@LL6!b2*p06JkZMX7UN4>i&$h?3pQu0NHgWIJ`9ud*ek7X;^y7qjkVcLQN8Z;*%
zE}mj9*x9f0UXwO>^rhQu&mOb@udA<4iGx}A|E?atu(auJ0GFEnsJedD^&QhEu~LlO
zyu4{eTCQ2D^74LiZcp!a-VNQRx^3sq!(??)i~F+k-IkY9ou@}uQyP-Av=~mCnb^&v
z!AdQ=4FBLun+GfiG7sf5syjiQ<tMwlS~@ZpbT6<qAUK#4c!HM67;JFt=iRNn*<8nt
zT^3pRBR0D<|C<ojsO#F}y<cnco$Vh~haU_m=$8W!37SiNAH{Fh!s@m(8(r@*)RJ8r
zmC{<G;w^wZhuX)IrvKF^Rj*P4ypZM8Dfy2dKSqGgI%Z6cjrowq&T{NB_oJ0f?e*gM
z^Fsu61J-9bvonuXXREy)b=+10t|{U=*MH1$ak6o|Ws0!v%S<lvKdTo%do!8asey5X
zjPDtSP5=PwV-SRrUZ$kwqL)&QYK@}x>s$D3H?Qb4P}jg#J3!*-Cwxv5x6&vgbH5G;
z^5}WWedaY<URva__*o>BY5VKjc>)8|Oo2GM0Sv3Ht%`XKs>&+43rz-$Ki=Eq_`~nG
zhAJ3R$GyP856```Q9>P;MA5RD4<BYZe*Bv2@}m7LxMPpMlIHXIkz8rlnT`iS^Wl1x
z0XrBOO-6(Kz2yJBq0($DxLN)wI;A-)m&_g3GWvM$F5!icBTQ)q)%>|UTByHzqn#zQ
znkhGm+*gftKIVSaTHr9+DOA{>Zd39BShoNB+Xv0VA3l5-`(d0E*sA$Wf!eg=SLn93
zIp1=1^2c9zt6#RFWsZDHv95n7S2~ojI6ocK+S}1_2;a%Jf^qZB{vh71!V}Nr6V;oC
zras)=P>G_eJM*U_%II6zo&F_|uhyYHv;Al7POVc9n3<g|k4q{Tct7qf5OkPn9P8XY
zGujm;czY(f#5#gYGfx?yK;LeDc%HLRv}h{$LjJ$!thDO&+5Juu3~D8%rIi3CD>%tB
zRlPP!N-jV>$430?%adYH>3J`qnMz272&pV$_pu*4R%${4U|xZ~1*gqgZe^H))HwA=
zzL4+w{8RzptL{%naXplTuNjh(l5!w`ypwc$_ujG$0V7VG$wCSFl98WYsK&v=Q)5EG
zx7#ha0-3s=o|XrGluuAim&YDZxNzZKiD?j@ae%=W!Vpb)ZGK%(%cjd{WpZ1%vC{wL
z^PMKIQox!d5|mRucII93KJeNg&tuEJSEf66?)3dVCt&f@y?H9%dAcg?tCriMUdGpQ
z-(&R;w;z_r_msyOs+Z)>kATeeHN$yfv~+xe4>a(xw+@sgqo(8=QMR~6$N2OrcGVWN
zrs_Q=;9Sfr5P-MNWC3`1*N>`S40aPbOW0vw=U(y}cs0+E=5p4RhlfZ0+&TB=7X0vK
zPCd^dWdO&0pd~vkR;#d}gD<IABnt2e|M7Hnbasy8Qp-@jZQd^tblO}|Q&ZE-O(cd{
z&MeeDqo=Fu?bJxCapNihyCLPrE~kwft^%qw)%Bqhj7>!9xa%cg;{-nKkD(g8zelso
zzGdHOvzYGg?$v!$e~P#E(O1*2QuIC`EU&1jcxODh`%56N{(PoUee3`zzsJ0+#JkDC
zMh-BkTyJ`%4a#0lUvTkhd(Ua*+DRp-XUlSdMwqtdDCij&1euO^d5fwB2Sr+pDK5`e
zyU`>$?w>mOkG`QGWYm&n$)BHO6LC`KbJn6`nCG?8ogY{0>g!9OaGTCa=%BEZqPm+?
zS$lM;_`%l7EXyvM(0DT-|1s>XeIe2})NScLs%aG5Rta&PGmM^G?s=hA(O(<Q)usgK
zay#kj%gTnGvHMb>o;fbf_H9}0J<HFpi0-ayNBf>bDX|O^LC-*aoJU^@`gdCBm)+}d
zLEz2lGvf_VvLuw1UkXip6WhVSU}Q&E2>f2&UGB>@RcO)iSFttwRq>Wm)OHImlxa1g
z63@6Hs7Q+O${nEM6Wg@unDJq#(Ja67r$g$GNr_^25j_gURpF;y;lkMCiGg~_Yp(?r
zZiNC`@L=E2pEgr}e&$0fBtA2{f)KSu>=di%R{OJ)V+r_`nm8ryM-LyeTI8<TKwAb)
zODm0nZ#x|SuIHq6?^SvL{*t&at!9mh8a3(0N{{<)?AR{g@F$FHdBsF^!}_M@&!3al
zOH{3Jfx%BQ-m{?PFFJ}JR6^iM7%)J|szEoqJxwtPbvZiNn3NgIeORJX1ZIkR7diPL
zfn&i*%?hb$X?g>7?^J^yP+xpZDO|589}B2vR1+aS0Az99pek7A(W6I%4QXUsU4+;u
z>4Fmzi<0Rvj}9UWGOsAQH1qad`^1Ee?d+IdI_|(E1kyO@U_F$!?V^X`LH|ljO&2%a
zfb=L2eW-q6cAO9ac_*hF&qt4BC>f@5zDK2GA(qaH9JsuA??fgbV;#0h9nO6Co40Qj
z^!1~19LJ-6;50gQK04;-?d@#@V56c1A<?nQwEGEat?H^(s|JXwhYRq}vFP|49bN`l
zV&K!GorJ0wp|Muf*47T#)~D)8PJY<H6w{h(ANT9mE&u1w!_C_A-k~T(VVj15X{h{?
zo_G=v=l0jHC#9&0hLhjKw!S0G_O+0sY)MJUI}mTWojczGDnyFRcJG8Xcs8!LYj`+;
zY~gg5c{{p2d!iw|*W;WiI5=c6oX~dfNRR)23V<{iU<_g1oz9j9a|`3u{tq5JpfHIl
zyszk5URskZ4j2hQ^s05__iyvb(+vcuQH{tXstXWJEfV|XIK4S)nH9FB1f*5T&tjt=
zq&KekRIKE3*t~_t9x@6!eCyZQf5zh60hbAxj~q?+sHn*sx$hW4Ngz6UGuE{BbJKf6
zUm7M6^{Noz!S^Sx=l$zsUH{nQp{(UHsc>gcHxE0^gcX7N<ju7mbVGmrYbJC9nvZq+
zN>_mJ>fy}WO=sHw)}%jq^WMUs*0K+3o1nG_Yx$W+XNNwDw~+4_Hp8Zt5f1>Ue891L
zyJ1^i_Pu-el<SY<oY5W-V#P)I`g15rsH+ECAM@OCmx|i%P!Z8U-50QCR{$736&H(H
zSy^3R1F#kVR^)>G;p6Y$Gs3nz)|8S_6E3!aNcN{pnyv#SA4LadX5PWX#QlO>E5P@d
zbOqX_?(|4&s@t;b>FO+twzjrT=%c8>o&Ei6Xw&2$5^UmEukMO`C}AV^&xN}Cu3fjT
z933w5Y9J4hJc&-}=XV4^6eb4;NXQH9B`{VWP(ume!wVNLmSda0r^)=+k`WSK7C0<J
z2o$O#Hh++TeifV=qlS1kkc1cbsyH+Xge%ErTj{-1PI-fMxng0Fymsx{D>yu#+S|3z
zwIV@&p#J<E>F?tIukTYrw$IuP8ziwjSKC$Dub5@oc75JLbjbzm7jmfr*1b>gom3Xq
zJ>iIqjy9%O1i`yR7Kn%-APK7YWR}T+dSBQQ;@B4~2M-p-x>^-JUAOpW3n$q&RKZ7}
z;#7r-nkzUcJe!$u5OA7^VHCNooMGO69Ou{<%vchK^{&3^`x$T@ycyZ4=sA0cLv+fl
zrRh+$HOdH!h)COc-urL=HCBHf0l_zW0oB)eYUnw7Y#C%!z3LEQXm(xSPTCOp8n5#G
z_U$^+<s*O$cI?{K{q5w&<cW*_xjkn%igFa7Br$^W25@T~hpg$-Rq8E?22}gmngz|y
zurB8Lz5DmezlDoM0yENXO)$IY9?8A>-)s9sx2holpQr~gG=_p&3E~YnS;f*Ns7kyp
zhErDni&%u6CX(kE6{nbsYWDnV0$=MKpc+(!?Bqij7KCU{;AorKnT%VIt)Bo%eSSiJ
z7?r?&c4n>e9P`R<rYaI|q1W!oahi;UrJ=509l`}c+kzsrxh7VDgGkUc^gI_pr#mwo
zw`uo3{^#IQ9s7Q$r~<;}LDG3{Pc<9-SgQi;<YN%xc<IuUy@&KF{4A$!HYT6?*Oqqo
z{k2QGN8-wrXV5?@mzSnR1zhIdtMytmYS@?aRtp{0DfO})5O03^e_zfU9d~~Y$o3-h
zL%fi?z0l)}S#+?dnn$k%vjPdd2VSdZ(P21`<&(CTUfCN|S(@PY-7sQ&MVA-k0LXeL
zM)CKf`}j?s;XE4BYo0g%*FX2uCf`}hb@n20D&DDOCKk^Z!l}?jp+@&8yaGtb*d{8m
z{@;5eafX|l8*Mc>UaL^^fYYx-qhn*Kxzf0&^k?nji5&RZYyaRg5gDuhc<|e2`zW&1
zyE&gF6)ve_lj~cHl0!!RS8sJFH>5brmbEfB|MTlRVG_|pRbK!kArz~4*m>gDA-9Fm
z2T%5$uG*9)CjRd}qx$mx*7v_$=Z8-_V)4;SqrVLkqJn+tOUI#j1$;~WgqYuve=oG?
zO<34LBH8rds{Eckdv-e$h$Z+-h_KqyeEYHlXfn0IL!ZC@y}P@9eZS1)585gLko#pM
z4zQ6^BWJ~8J^h7-W!=B~ja43JLk}RkCfnMe)>I?M<~dY+aR9!S(<l8l{<kWyGBEI)
zu)-YSdmZKiz(wlH>FUiatNwkTWK|R#-Ts<L)W^MhfAuzpMI8KRb5eP1Q~ywZX2btN
z4pdbCze|0%?{st;`<@%4t<_&iY2CSU`ogkgCB)G(StChz6cQ5pR9h>D5CF_B$-Mko
z<q=w#8~^E*zP^Vg*kDZEzMaPkJ6Krx=ON}H`jz(yF2c*9MIVOLBO5EvHab4;3vY81
zEo}glVbYX9QB_FSP>7X(4n{#ly$Hnw)q84o6<@yiJ>J7z0U%98ORLEN1=0`E7PBFD
ze){}b0v~wf*fB|Hg>aLhw0QyI?6_(8kc#@;0bt31P}jNg>p?h2WvJ1wc@I%pBm>w>
zLO_m$@JhZuR55>)e>CSOVsl&Zt$^Aj&}T~E_P`R*1&6d6X%ToZq1AH6*^TO)jPE`(
ze-tj_g|3KU@Y(Q|$8dOjfz`8|Jyj*HUiFKKVHL0)@FTr)$M)@q0DPYVxeyG3@0;uF
zX+Z_T<F7{W?j<fb(8J?ka_sSf_9O8bX01k}wwzFFP}3y%3~N61E*Uo_Cb%w)UiSC*
z*Ry=$GC%bWm?LM=@mpkYz9`{;YU?&^hyxdogAN%Bxhe*%gn-K8->r`y<Da&;20}|G
zQ99y4F5bcY&HR0=;$6?wrt7;RWwvX}>{4JHe17?W46MHU1tBcQj>SQWC|<N5YLaQq
zvV8k($=b@Q4pnDps;{`UXK3*}Ua^CnmG#QxNUNI5#P`ca(1ZZ$D6!Kc7gb=&{K&SB
zo`duR88@Hkca-ThJvCPIYgs*OVm2n@a?R?|$m2fxr~`J#p1-?Zaas#vr7eUlv7{hK
zmPwS*7o9oe`Xp{b8GQ#KDF!?)4y><l-t^}iR$gAY{em`E&?1~;u_*TxS#n!MR(ZZT
z#lD)8EXw@{5B9lg%+L0PCX6gYapq}RhNbNn9UV;x4eHEVd1t3}YuCo$O4DI2!F(~E
z;ZxcJwO4+;uUZLwN**-8%uSPRde1S-4bL{<Z`Xs-tQ6k7c|(&aDJA7kz>TV^YB(iC
z)J+rnSI^-Iwot`LYwngzjtcb@Q7WqC_Sg1pY&xHxJckz{4l}1kcz;~*8Oy&&{6i(n
zB0N~c<wtAnol8Qk!UWJ77`9}kNDVJ6E=D3=aNlgtwr$#S4lFn4TReFTes85Zr%9l}
z={5&3Co~mlk=Y2wGZsayaurHYJA_6*?W{>NkaisZdU{imwg>41yVQtsnQaO&fill+
z=1@RYB%G+3&kiW=Z}YoN<AC$f$%Mb-A3ogZ*!}!+1n3w^PGkd0<VLTR+OAFa6QaPj
zNWbt`Cv`k>qo3Zq$G4GcDy2`#0$N=-r6tc%4&3B*gPUd7(Bdk}Xvi8?`W-uVbVD<J
zj)ka%!P_#&6<xTzq!!}XOHcHz+w;SjJ}+PX%E%78wbCO>8t$ywa0EEcA{Rng1&Akg
z>v2$okHy7Xrjz`9VBs;CDb)$!5K_ha0<aJzlDzpue{Byq!|{FdggLZ1|0aE_JFQy8
z7Yfshr%&HJ{bvcVugBoa(wo5#S*&KG^s44LSUy^~^qgaA167fejEv0KKwOeUsEA89
zagyg83YX^M2p89M9_B+V#k00lY;=XCc&5W3YW$WhLWEM1C#k1!19I&?u6}EB3I_Ev
zu;hk;;m7;P&2qQgzI{7k*8~m(pS7>*SPT_*R>XHb27Ao!?uM;`d2W6*q`!wLOJ2Jc
zfRkMT>6g0IuH1)(2Xa+$U%C^HR}Ua0w@of?Qh#%r!6T9L2`gVbYiP(MP}Hqp0;iDZ
zoaG3I<W|F~Q%TmoL%u#J=+FNk8TXsN@zynPZ8lL;`;znqi8O$Yle7XD9PwB2?$J*e
z1!|&v%k=g2D{7@hxrlv=&#XjoIl{&!4ms)w&>S?4Ly&yK-WxYwBSi1sW##vzMpBs&
zJCOh>AsAgd=;-vUMF~|RJ|($qs10602PHVoSAbrTf?|>;7dVcc>M~Y}1e4ArEO&lx
zo?k<yy)V-5HiQmRLLu4u;dbvcDuiwmc*@WRJfTUP_k#GR(<=!pD)&IFWd&^Y9$#sZ
zl!3k$a>J2Xs6-HEW71EH{~{=C3&)Y{zV7m4p?*zGO}8_1p#@wGJ|h$2w&aKunneeV
zjO@Qm!hN+1&JiKDgzhxE5M7?=BJd~&Jp#l33vcej-Sj0~0B8SdrYVvxP{wsZJx7A}
zO02!ssd*J<Q)SrsySm@P&e!DF8WR_r@GuaJ3zsifk`Nhc>zDD5I!VN5!U2zfxmN>e
z;hlPRDzb2jFuOUB9pOJKBBBXldgXQ*R3B(AaLHv9cB;E!ovZ+m7Xe#?yozuW;-A4f
z=UiG^>Kq*8fFD43CSjID<w7Ox0mn`?ZahvxWV(8K+4F~XIbU>i$rdA&3hKU~&98%?
z882WlO2F>}fjbB8d4!Ko0kmc%)VH+YNTej#377fJ+c??S*hWGM96+l{izQLOHy5c1
zRg;goe*W*fcctcqke@*Up$DRk6?RE8(h4vc<d~V6(HKkfw-#+qbbZ~s_pe0qnV|nD
zT*p`Pgs`WGZ8h;@8;Z1(MiVZZNI}ZWyCR^b5n;=al95msrzB0<F<QPK5`mi#Ai(*k
z9mg(YA@`1K5!@nOB*oNswB7fdE7*)*IUwvrLS<Z1uTDMB9m$dW>#x6#oH%hE`Klu)
zPs$uu&pLSQTJSSS0p(DT4&j7b3<j@~ycT@s5L(d-9HGY#%V40g2nzoAn)a7?xP%qy
zhZX+#jpx7B^YZhzOxsrrPj~kh14Ic=*2%5pTQZQLNSU9FlX>gm1Z$xVNiY*fK|fgu
z$jTB@5CH3AWQrr_3!n@Rz}A<?o=9~ZkzfN`3xfl(fls@Ls;8qvCZaLyVGM+XeIwSm
zN!OY$lUw+fT_H9?({)zQ7WufK(4@LLc|>$Jue=6I!&vFJ0vBgK$b&>>3t}pULQ=O!
z>vlLed(WR)y7WdvuW&bZPR=iXx-<)2^XnJSj@zaoZR9a0B`KNK<PCX%Bnf_Gm<DxZ
zM@2@yBcKE9Z1<zZ8&Z6?zMacooT3as7xn0~ibF~TIUXU>?lY6DjU_Ut8CmqSz{{_G
zeSKC5P-EXKYk)UZe9%B^Zl+Y}^W4UL3JV;#2kX|a&v7{*|A;+Px+o#CmdQ#@WG`-&
zOVkt{yZm)f!Q`A_YVJJk@o`1iSCc61(vgvo^dZ)+$cWX$7*&8_5S&vThXhf<Z0|mZ
za~;XqeIx<Fz^nfx{GensAM2aT?h1a5FV4pPb${~!3Z4S?F|BifpX>ncs?ndHAC5cH
zygqBMNK7%Yz9c_cqOjvGSv3hgt{6O3dcBQZd{uy~1fayr{aUDE9`o56unC>e<c4W8
zTj{m$dw9g+dYcy2l@VG?{7X!%wV;ify|vAH*R+cQP|qapa16F;ZeJdPr1;Wwa_!4=
zjfI;{yGAB2A^CR?$f-qDaPd%P&)x6PApIZ4029ZdhwL>v>o}%cT>S#~1mQQIVo}!i
z0VE{`Ivz0DRV=xVl^;`pyHeX5Vhox`vL+YJws>ZpE@B@TtlUrBY+K|2qJ^~(&oXJ|
zQ3(HQUG$eil2Jl#)^1?IUv}UDlk0UPW9_Pyrm-;&RVvi1jz`4cRYNf}=|r3pnrWG5
zpp0zrLQSV1L?Yu7rJ8LODHggx63SW~xeuU)tpy`o{${@gJjV+L&}BS5J*|EPBg2+R
zf@T*kz$<$DZMZeR4Tz6XBluJPLk<Xg#GE4eQOHytKNy6~<#0oFfzWxdc}J(GPuDd(
z1d|{EVKlJIw_RNJ*BC(E(uK!1R<cLy3WQIwInFD&cEh@;Cp<7fqP-Q=clAv6&>}D}
z283Su_d4nb-1=+#jp5gjK&c^&e6jiA+Gua0MnS;s|K`f&h+I!Mcm%06(cZRamGZAy
z(;QO5nJb}C)QAf3J8#?zaaV!&%fK=fZ!SItcPb8F6s-L9{cR8ayJPq6-iZ{DsqU20
z1HO=pC9#QuMKmqt)TinZ&O8D;*B4w!@O?X?AZ0jC5s<rN;}p3bOl_gMxN4Q+cBKpx
zm04Iakzx;MJtzzU&q-ug56HWw(9Ny5tH}t4W-9JtuINGR#xhh<VwTgs3bX~B)Po#C
z422h7YP;yj0%RM{K_IYgeo3^9KYuK6j~<K7?IXekIw!50wbnBRKBF>V28|`vpPuC2
zx5Q#+kf0+yj!*69y@EC|LenkQ*9O~V2vC~E>xiOxd_NM1QK`0riX<_rE@&pBh-<`g
z(t~c$IXoO}tmhBcm0$>%kTw#_RAC4UGbc)iij39CNjKLu{BUbdQc4P;wB1A8?fPzR
zO_TA$F((97VLy{3_XpmzHiG?#Mo;<Ns3D`NHF6ycQw94DptiL~XT$pS6=(*Lj^n*{
zljC^Ta%2Y>mlC!alRbso(;fccfK~I$D$;R24#NRHv{mSjdu^#BFh?ZH?lq=TMUpQi
z$r{r^0M1vbPLoCmM_X0SToku#R)Tg%1fd`O-fxj9m(4WOi1u1VCCFUF-U&be&YLlO
z$yj7B$XO+hOUoQz4~l$+nt8sS90hqa$+@ZF!KO{kBtymTGXExvgPcer-I0hRWd=%f
zs!hLaP<!`Q1mp4XJq@7K#bO1EQ)(|<)XD>sY8l0nBhZ+R)0aZcT^bKv&eG+4yPjt6
zK_=Ik@Z9J_$h!IA5)g6zriw32`r^gMyC1>vSYxn`DvNHF;wF75_sQYRb_qlyHBJQm
zoxe0U=uxdvi-Z@V&q~3k4(p(U_2m98u>R3l{y6qcUO`I-uv1-Uo)G~D;2)nXa?k$G
zlOx(2S3v@73oc^fO!dXE4cWfZ**L<F8p8&eDmVK1We`DfP9HZiJa?;l&|T%`@J+??
zhY~P<0P5LUhf7rMYNLiZYdMDQewULLW<i$5`n$<y;%!^^etC`rg#;?Af@zdgkbbSS
zAB<pKB*91$cn`OxUw5}IkrvR!#9?=_pnpYK7ZBl|_!WV|&KVsUB{DKvT8WA{RI?zb
zFsyx1-IQ?$4kO{8VdN|=Ev@qY)^mv8XC3t$NCjFz8k1<w@Y<k-a<cy-7bW;-din)a
z-}2M#x4TB(y~Lis7^{?IW<3wGUQW2o(W948`yy~$hysg}<oVSFcaD;Z)L{^1k5Y-A
z7UHE!L5(_8tW^@X-P2K-Z;Kv$Z{FVar|{zt%&`oUW}n}SxDejDP+q!;4>9W5R$~}i
z_))(MJ5CqXe8>L%T<{xY(LoFw6JLLA-+c?fPY98H!gc6!OraqV$mvn4oM943xFLxh
zKc03&Q;<zi<qJG(pGbpjoW*jr(D)M-cZD5|+E|{E6DY2^iD8bTofn&P?UV4i7tv3N
zXi}4+b2%uK8~P^6ZzL4R)`3{FgCS%X#;cP|4K(sfpf)lzLS!8hUma|b#v%9HwDah#
zeVl#MKZ;JSRU`bDmPv&3<jIpL2VB_dH8C=WN&4rjs5RYodLG?}{HqjEko1r-=1+%4
zlaPn(MJl|o$J6!*bwo*rn$@1RK`V_!qS9*S&yAqoURJ^UKGx&&6*wd$4N~0IGJ;NM
z_2=jLTG0@Xd-uvT>|0szl`JX+4zD_=grovV=<ygqQ0MpV8y+@w5OSv3$IscG{UunS
zw%1iDK{XO5H^98zzSZ`HD!4k5%qLsykvJL~9c7!y4o1W6DA>cL8iBGN|3e8f*8u1v
zpOA+v(QYnK_*j{ZCVqYQC{-`GogIGCb8gPc7NZ{xy?w^O$g$Wgvx&p_j&Uf#lsbFB
zpq%llv(&HMa8QVt|JAz#JysD|`fKJgQEs4yQCi%fS8YaY(MappnBdowy78bJG@=1G
zk7})jyjrK{CkG9(eyi!}>c&8Dj|D>RIeQ76svar-C|Oxq6NWB)rsDFV&D2sB<P%dT
z8pP!?6c(MGoMQ1)L)1weu-+-1@Gz@MXRprGr1i9nw`%uhlUTUNR;EPsS*|H9*oU~t
zBLqVhyW~1cAyO?64hhCIE@p!=$&4chYlPt907{U&T84=XE?ExeR3871;HuqyGC*y>
zWH%i00DgdsrBxOkE<a_6#JQ&Nmb?BZKut1$^JJX?01T*1aQLDEK9i1#$=qQHCU1@1
z7SA)HMeMYLmGyeYXU4()*>Ha2K06>yX3Efo=Fa{8H*oFusDiG}&N}y1YvNr)KtiLj
zn@t%8fe+pr(d^fZ7VvnYB)%mXP(KW{LvOO{R&#2klv|^ptm6IV#3m-xex8<TG-R5D
zW577JLro`(yKqD+hfDuD-!m}Hh{L=HoylXqnhbLE?o)5o#FjR~{`Hu%pMHgqhSgu$
zE~|ei%FrZ(|J0)fD!?<OUQn{Y7w*B%8!f=TX^l#OW@%XL?YJ;A>QS1~E42({zhyF;
zw1KHWF7txks@HMD47)5{-4z%cUU0-ga$@J;sQlA)BDKnD5b4`fLRD?~&eTJ-I0LUC
zELjwS_zj?H@GtBo;r*Zj0h|6Bmbi~1|G93OWT;srF+(G&<SjB6Bh|G9R?*|d6w9tl
z#V+1^Pk#I}ehRp$xC>ED<^76TZ`Bt=-kupEpZyNEt$2|mvJRSu{!EGkwhv?lHDQn3
zM#Ss=-ad}ow)?Q?;)E|@W=o5|-Qd`(9pUBWZ8wFU$QiQc0|e!xS6^y73=x@@yh|3r
z_s5_J@YhATEidiZw(a^)exUsmb$y^(TTDYM19qn7j9X2QD5_%xkS_ZCCz~7M=P^>l
zI#MvPLni=yAI^_J4CkNO0ZL{PKE3*ny5{ZCi_Oq7JM2Uk{@lF{jN?I307-V59x=^&
zEi+XBK=*+GCNPgt9cwl`|Beh~RQ(`07Y`$PW1RJrckkjnH?tK&XT_!@UJj?&;|Hus
zzhBc-nH;q9B*o4DTGR|cZtS<)GQ}b{IGAxo`5|{gjf$0aW3uNXK&P@bTZImy_SsF=
zVqEGS@Nzgm-fXN!lDk=`7cn*STh3ZqTKx?PYIi7rEA#_t2+?|ER1+naXc6I<4ahW%
z?+nX|=T>6CkXQ%*@51E*=-~8bFZ}&kc=f-WsQV0HO3K&oMIf5c4o4K-k5S1ijp)`o
zwZ<LDk(iIaY_RwQ4zn$u-0n?Vw`RUGMT3P0_QB$;bK+d@73A9YpxleuV$7qs3pBkF
z@iv-FUZ;iK1|>JN$S{IMp#&SzRA?R;WfLh09X0tK7u7D?waO($fM7jnMz&Y9fD^qt
z_^|_gAq7%;PiC4@jzWOvtBXS8Sl1Tn=cgM}h}J0q*O?}L`*x&So&kIAi-m4Ve;_)G
z_4r_=0%U|0@cRQH%u0BNy5lcl6Q5p)$_X=9p6stJ{lh4-I3X9*-t_n(hLFlI+M}JN
zLDEA9(oT3e0qXtDhtof7#I$|;jVviBdqWIqtf@UgMpNoiyECjm7mQ6!1z<bv8?lFL
zO|0(XVayLJU(`f#UVzIM;O5$ECaNaFh+tgPh$XH<|JFRV^==0uFVjr!*|CEe^6?(r
zKe1u$tClKSiHOe}8=acsuhWOEO=c~|Ut;LOgL_;PP55ypB5=wG+TVyt`ts%KEb7RX
z^px)CP*<LX9A*3h5p!B~+N+)uyk~JA0i1nia)^-}`*Oh?pu~gX_o+{OLsgR!ZdE4R
zGh#Y!$y`OXaF;6XVI@oyXlG|4lAu)6&Bz^;gnXxq)Uchm3j`Q33dHWbqWS5eW*rAw
zfGuBS&nOc~hOFwAs`%bOF2$xMi_PB>FbJf3Ykr|1|5jxRB){X2FhkTbV)x>>h7Y(g
zgIOaY<GG~;uiuht`jZ_w9}mjj#eP?DXcQeIY(*0HhvU#w7)E%ZA7NV?4Ej-ped3*x
zo@Z?!xz?GdB=2WBr<6dUUo^5O(FN2gM9^=JF15SPOJT52pm_WiL>@9ohRKP;SmPJ?
zH(&oea8y<dZg>&5cMHdbPk%C_IahLBucuiHbv^}{^FoemwFp`;p=5luco=2<=i|w>
zN?5j&EgstIS)OvabzwB-^B^--(;X`6qX5jOT6!TP($b&h<Eys_0*L9IPw+r3DZ}?8
zX$k(X(Qq4TAfU`5XtP4>06)*#4Lt)&X|_Ec=o5b?fm<o1$4KE)A)8J)!j{9&Y)7hG
zj^Cuz$1<F{^)q>N|5Kff7J0-xAW9hlFnzD>C6JmU7>mF;B3<D}OQ%&*zcP}H8WT;k
zzT)#=pV&#oDzGtG+X{v|y%{fNFi3gnI;L~~qX=XESOv!z#wVMFuc12<%FJWgd13qZ
zY$%-f9y}oPO?vo@Jo*$_OEs-T?TG~$W@c!!b|0^r$YDIG*pzWLn6g6~MX~ip*I9<r
zZ9n&#{&@d<`{7Gv5HC%Z9vsi|sG6?`;4sG|K+7iHRqj3r)EvdlvYOsS!#4CO5YpmG
zUK&(yzn~dTmoEA|ncdsIT>wKfoN5_YG1aMCo1H1)*_lzG9uDH|LBWKkfGaaUJJ5Cq
zzt=+fNV;(&P3Ajf)r&vdpYl3XM8-MCFriXrT`g=-JG-t!@S>hp^VsP*AdG7-H&OX9
z27lUr^x|;wB>?Tst@;3sv;yyJ&tu`Zszv7G|1)+B7iK#X6H~O8$}YOn$w&$#nP=wZ
ztrbr@Sry>oI^HYw;Hi0K{a%dyG4dC@wWL{<u?gczBxs0fzI56P*WXY1b1C^f@%Fa=
zc$F%w`(V-E;;u?NYW?|?gd`*-eWB#$4ta8uRU@%+h{bw{`5vcFi(&N|tPBK|Dygij
zyuR=CM-DXpV)KzSsEin>zG017h~4m5_($4)uj|;m`pM|Tgdap&(l8@H4Msv}H(%d1
z?a!5D>6I0;p2|;mt?~&7Aof`Jlqt{4FwuCR2s$Fbg*k0XdD`4%SWQGJfvW#E^K_n|
zq>S@{7MF`$Z#(=S?xi&jE)Ot2Bq-=ECm{~EE}S2MIkWcZS$uRnkT4f;*K>?{CGX}_
zlArd^%pB!S!APROjiXf8t+r`@h+xe(JV7#Cg!T7h=#FH?^}4)}^|c#mQR%MI=%Oic
zbP>4Ab;IjgwIy0g2Y<#ryZa{@BG@9|Z(eO4S-Z5(25qUmoXoHaZ&4198R1Y{x;8jB
zy^hLr^R-UeotKwvE-T@D_@WxGi03epNkk#qyBWGN4$adED9;x{=fjS~b6*BBe~$7g
zw(1GjGQ$uj5?7e_nAk~;GK|6Obhd@mPXXg9m_ZQKH8J>!t6Y%;Fe-FQi3u~QWI+AV
zlP7){6nQKvUO;j|fZKLY<!b19T=Xi9t<aRZK~ZU6Z=mu!GI#sO9ZLVghp*oep=2YQ
zp3Eu}Ds=eL6N`cRQWAcG3G0v6C16U^>K`%L!wOlE1jZ+)AUuKen9dkjS0VGIJHvSB
z&Ye57XP-OcywGHRcYHk{bo$&LXtDu-3QcwVsF(#ybH=ksvg%?zpuWrfoI=+-R+K6x
z)2@^eTpb(px^f#83773uE7-pav=IHpEA$DSN%qI4VUmMGLGVFvS&~=_5OQlU_CQi?
z#Ysob5O)d)f(+Qx4rj)&J{qjlB&>6n_M?ZydVmp5WB{aRnZZ6z*G1vX(o!cAx|=0s
zWAk3@v)y{HLtz$41#_`dN<-?<aS?O522>e*f<sxhZo2-T;|#Zdr~YaxmJO?RU&Uzd
zt*oyQWV#79_-LZe0mpkK_mye>0!Ubc*q^AUNZBGWZ9{xSicNMmg~$^u{6*~LgO!TJ
zRRWZ$y-td>(N1lW`F+K2Y7`@dIh}66A-l2}xF~!rp95?M*crvneIOzj(nlT?;;jSD
zM}5sylKi_fISF>CQI-^7K532DUT&fCqag(a!WwT&6u!o_myhPLbt=%f^dRk!lSUMc
ziNQu`D1YXSEYHx`)l5RuJ|-7DIg3I^b~}HS)!c+(u_;v9&g4<G_qT3jJ>?p#Q#j+{
z{x@86%AZU{9UUD#Kz-G<%q-%TO-k^_JSeA(8@`P0T;;w4>B^&*y%<lnL}B)a-(@j3
zh72cTEh~`DkHiie!%&WdgoLM*3mH`XkjBBFto3<6j4_LSZ`&QLqF`X}HLFE_@xjw}
z@OE_az_d6EnpNutVZnCrqj@HfEY_&+`8%G)1%gQ5b?}FWhyPPhQC?<2J!!OdoH=+f
z?9=O)LWd5WZ*%P1Po6&@rQ~B-;=k4Q(;QD#z==qFKRfSvXxL?-u?dMUG@Z(Cin=XM
zzUWB7el@PGUt_*!*Dl>!>lDDL+)}&U*e==`YiAaMD~0jNsXa_|;EIQVJ?uZ4P=)E@
z`3@&AiRz2gJp-+Bh|81;u`_pT^^ZU|rUBv{7}mLY)1+W^6?$S1!nb}HXk#!^f~phr
znPb4Sc+M)F=&J}1hEs0_{}w|Qk_D%n-<yK*MdGQ|Qw+dn@)nWywnDT~?3fj|LaZN2
z<&pkmyH66bFB=Z3#}AS;fwQjBCAhP6+w~J_u78<IZd^4__rQhlK+;<~INC&Je%?)m
zA9w8QW-8Cq1$TP15da+t`CG$vaZ(9efZvpz(39dmBH&a&z~7Q?h*1oo<%My@#(m~_
zhY%FyueL;1&_nu+=|rr_rT)D2kD(T%qaZaSN)gVF8o^`IbRwt}0lz$?w=1p(EnL$L
zLiz@DgIDMQhGZ0kgiV*nyCIg5rq^KydBGnHEvVFXo!6m*Zs*UR_n`b!#aSLCK!`6c
zkd-LMp5Bs4Mi(NHKfd;IJJl|?waT=+ckJjKVQbQZ3;o8Ar^O7ro_4lhHW9E?l?aVx
za0iZ~!=&bDpag_l;%E(v7(DyFljH1J?Hb1|yC)$qXQ-!Jp=k3br9u4JYo_*1dff|7
zm75N<IAuh4YqH2ymlhhmCw1&@re0#==aXx@t0|P3t<<Ep)GA~7$;?{NkKM;I3W%^{
zgmwnF%dQ|nMwx<2CnhKT0Zy7)4p4dW;9(O@Rz4%>mx8X$$9Lfw10-<QVF&+{Je{Ms
zy(Q~4nNx<|!DHOOS-Z@w`o3&n=h@$s%<4Zc$+%1he`YL-RQNE&g7~(Ktb`A53JNv@
zhS51<HboaHBti#>X&H~H20|xSWWB{DDDobKbamKTj_`c8c-xXVBt~kCV!i^CQ!ni9
zMCTxnEb!<fzC}=CSR+z_v&cEqWIp!t%3$NP;UhOFL!BiHoR|OUBrtp>Vk3rfYHC@X
zGZsB7A`C7~f2QRg^YX$M;llCDyL%sV7g+qFb6yn|BjeY@AYc`ddJ(3xDFYUf@<$o_
zoz|@du5fC<B}b$@Mv7mZxbe4CR|Y~$!(^_p5LI3dqETjSC<IuBkhFA{c1_e5MZ#-8
zt3gT6Fus1F4%WpM?@S1pJJJfwi1asE!I2bGS68>XZxKJS;!lD;E2rGNFIC+L2hKdM
z^cJ=@!c4&(Ct<n;{Wb53MsNDc4I2d$Bag$=5ob53RVIFkg3hl$M8UfKgv5=i>%sRD
zM%n|Dg2<$P%QOo6kg5*M4nCn?jJdZIh^_=e_R-Nr!lk7V7A5b|VQKaBfUs(A*Wpa{
zStt|3ahPUlu5$xlbHap2LYq0ZzyNSD-zg8_!8>nQC2HZOy-$Ge+cdGEA1;E2h)qub
zEz=V#W58p6;VE@eyI_6zjZIH;TLeS>jl&RC9N{57-QByI`T)!npgU8)&gC*!1Wt$~
z^zD}bL_ryxIX<BVx216=Q#iBZYvQqo%#y$iRfT_pxi`I+{*h^JK5m^3Rc^JYI%44O
zP%p*t%#I&*ZntjT3LoFPX;X@TGMPjs!=kb9fC?62+iSUumh8Dd(zSqs6blzbHJ#hW
z5qy?Majo*_*qHUo2*5^mxcbW)p%)RG=Kho$_F=Qj&{HN+&Hrn4kbBPktU}yY9Q}gx
zL}jgqaui<`ETEHR?%c2j%8gfv!ba+C^z?>uWTH?UGY2Gq4gkS|1PDn1z?_Bt!-5EK
zp&od$*X#JZ!gweRvKlvj4H%H&Ab(B_j)7|HVV4nfm2KJOLE?IF<mBJUUL;vkq8rai
z+`y^!C5clg+SCiL=7R;SyD@8b(#G{ZwnHUWz6VMjd3?w2Iom&HN3z6-Tu=73(-ZYe
zu2J&pP^~q!G8z8OoG4a16C2Ew!cWpw^`;jt5V}YL+}LAc!xt_PgJjKmnr9@v4`4yk
zg+7>=#6NxEvWTPWm$bLHTNL7;>Dps4k-<VHACk&5-1mJ4h>d?#I)oE14}eoccp-U<
zH-0|QIwVoTBVoy8Ty57y&Gc~n5x2(ckWT3~2@mwBik;FzH?lOaA|!k<*1o)?L_9EL
z6Zl^nC!+omqk$d=nGCchQeS=e5GfJm{De5~txBkX*XGH+C2j{WNxES$W+258uOkl&
zLWF`mfQ3XnVAa-yonJ%xG)iSfRKcpSGgi)?QPu!b<%w<zDY}rU0%|WvE$NA7l90dy
zQM=2^IPGI&W9$|q%aG|zM??h$Rf#<>_435|R<N#EB)i!W3fY1|i~NPLN+XnTb}*-?
z0$5V%ns=EKXV)vjJIJ;rm}e0=svl8ZDG0E!3kWoC@@}#tL3gL6wzf8QX6BEra{OtS
z>xi4qG$W!$!=Cmc9>t53`;=iFC}PaUW4=HG&D-<o)AU($m-D35#)TeJT6$W}r38uJ
zY@P)E_}!?R0*4mQiplJXRI}VM{TEEQl2$p3AjFc+HN>lQjTpWp)I=V!_af6ar$H|0
zs6JAQO0n|dB=bhH=$Kz7goO=<%%3QbPw08OAvL7*4+t<b!`sX0;4iV=vb$%Jg?S~1
z0!y-EX%G>UEexklw2Z*n_K;2<xr%_f4=TM{z6-b%$#_Tku01P>fqU}vAMr8U4`^-v
zK0eIg1nId<NSd>O>wa|`q`o=4sj=1ecGiIKW%yvs%eUp`kejodVWgsRMD*?^4kus)
zg*B2GxupHrOP3ts;E*J<0~lyyv&jAQ=>pj?(8F?X>EEB98%!c22Obo<Mm}Z48p=dP
z52yPlm?DJAhB$48qxxk5%yA&`^xYyCm9-p4f9M`PeYBqshVIHB?zITh1%dhY5=RvB
zkj?a|F@@-B`{OdK8%H}TR>bZeC&blB2B|8LhU(mfjmewSQE*msZ`W!;A(KFCwg<p!
zB*e3SA7g{ZIk@jWKmcUi-`7Af3(%|*!vZ>Tlum%0vANXA7BS|VlLGfSNdS>h9RAEq
zC5$1pIRDNka+%ybnU*2}tqs)`dn5gX#=r2U-k!C}tSa6PG@VDDD<myE=?90A+qjs;
zem@+FY8mw@g+!nydOR};Zk(XuB|HK!{x6I*mO(XW72cAWgB&plK=PY3{mc-6c3O_H
z(;hrN;8dMi$H)6*aC*0stewG+Gy`t}_2EjG7-_Yj+GuEjd}KHZIsb@?h`55sFB}mP
zYUvd*fi=O6o#~ID(U1CSyb~vQ7td>lMt^vLE0Hte#`fr(r7qp}tdV%oAfOg=XEN5#
zlJpTd{W-65y|yY9_Oa5=4=8TfdccoR$VHdvvrDe4-Ju`HCu7i%z~S8J4suj#lC(qv
z1#M$13%}bym?oz_JZ`$x==+<CB<UAa{YcLnZt!`8MQ=>gRe8=caC#1M;0#8Eije3g
z3I|PQE_q%R8sTMP;^xks?1X+p2A@`*FE&R8XpwFc#~l%yOM`!Mnovj*5`FQspAaie
zjGm<u%gk_53tpk1?SSq~o-3Y0K;{Pj%Cznq?SM&g(M7A(3}u7o*0+Pvug6CbrWk8B
z2o;Dlr~0;kRe*npL+7KL&OD~Zc=Sj)sK;?|k>j&}o&^LPCAAmTu^f8J@PIKiks4qv
zQr#t&>IZ<Utd<w2D@lan-Me?R{b^ZAAKqjXU>woZsdy2Fj9_;}2hh+Ma9Sm}6A6sk
zO}_|*I8RJrSgxAaLWKIi6}Vy4+Yp@#(Xt=mi>gFR6Gz|Z#!a)CQyzhG*v*Hqjbm@1
z0ppVCOWbAh(7PTiRw}Al@i0bilz;J$h=>q}g!MOvWJ96`2d=_uppGr*N1p+iumcn_
zb{RQAWx=1RwK*lmFEcZfJnv_?AR-~Ma#P=wxnJ7xYE5NFSSgTw-XY=Bw0OJaI5Yqk
zIIgic_tyfQ@uliOa7X+q_m_V96ay1l4&zr*R}#-}@6)6$$Vx~8YJCSjr6z2L-i<Vv
zUvc9_JcO<e_&pW^!u~mRVpzojDIIr|BJ>}qBy=U+grO;!8#ivy3a@`^Rk{*y+DuK&
zyKn{&#N2kd>UQf;V^U~G0lZPYMpt?SKsrtW)W7+<l$8&&Aqo$<y5aDJf_wOGtLVaY
z1RsOuT!}d_Z4I6k*N~FC{5h)=)vj4-RsmRG4k%b2`jCeAvBQVO$YXLU;2l4D=!Atz
zFzSm*KZo)z1M}=+A_9qFz`#+sv0Ii`Ra8{SV(>k)$y{bu+s2vX&{2Y=@r;?hA<GHX
zWFEbaz)?Cd86U?+7*JB7A{wuSof~=``$p~paJ)moJHrxe(ZjIo`{5#Xi9rs`qe1D7
z|0Y0$O5`@q+G>#OVm_XHMA}wwAK7fk2^Yx1k+m&XEyy1!m^Yh*jP(vFw;(1l9FbSZ
zA`O6G7xyXc(t;SiG5Lw2C3UiuF^qWPgq~X1sthTJ08#}qE2k0)RYeKg(}PJG2q;}Z
zWHX1sO0$m*Ba_~9Luu9W2#R);B8%D{1N?JX+70zETVeQh$^nF>T2u}!PctQ-ho}*O
zC#S81A>m*8acgOkC?hiZB(e+K21SNI1>(CCSq-a2aS=J9f#GrTq_s$N_?4&v=BLOb
z2k}}W!4rEPUzZFg!muJcS-`UM-cWm?7M>l}U1QzRl87!(GUp^V)dK2cg(rMnArpVV
zh@gegSLIMSNg#rx&PfgvpF|%1rwbfJJ0BP(!(zB)prC-n*~yqGnTJNpW@cUvwm&Q+
zq)zfK<T-wFrG*-ZJ4FIvliHL$n3x-ZkCsJZjSW-vGjnqiR#vI_9Dp$;@&p57)HNfS
zOGdCCbJ)+}7w}NS2=aQO0-%@I#jD7X@f5`TnVF+XEf9Dh?iwS;3P3c-0IFHO#oa`S
zv6H)Y?>-8h?^K;WToR(51(jY{YRMNRUzA`;kN|N4{V=<N>^n2mRG*NL<51y9&Q-wX
z*E4{Vi>|0InOZ8>9u%G&aj2HrHLY--=v?HcVTzk1Wy$)H*W(M}2`+3H2PN|-E3a?M
zQ$beRbad?m+IRrE0-a#Ug9i_I53Hxk+CoOKSQ}dQzdXo2wLv=+&r6a7K;GQyg;^NO
z;+08Rv$t7S^A($zibRQ>py05Ms$}~=F9V*Z$t*7`v-o)R;K!wN<<~LTg^@Tbhe9%4
zP&~iZ{msfq*)C&1q*E=QHTw8DH#IS_j$pF78(C;yKyy#jvEsP|#9V~n<I@gqrSfDT
z<965M(+z7sTLfXzAs%nL;TAR%gh6vsb4Lo7U5Sc|joLOMA_;|tWbW}~NsRbXT|Y&J
z>D+HtBG`n-F`~G_f$F~3?7n!XGZ7qlti`%IaH$afA<2G_GW692P+ErQu_RJfM6)XF
z*UD^UNduGyRv>iVmJxt%sC)S8Rk4Z*>~N4y=gw(ic&7)Fqd!o)IEMS{`#z6hOo=>{
z1aXHVg)^(pT@bo(uQCTS!_1|{#fRJDYU{CYkTwu@{1yJdWPng45_GSgkYJqJAi+a2
zM4(qho&IJDe9n%G_s5qiLxP?>l#zgROjbTeaFJ|c#M$KMrhjw8MoD$Nmbt-@>U!PE
z#WTON|J}CoKtK#xA}2117z7bNz}q;`N7H7DDQJi!;6@u_I$FAPPJ9aJuM(Olpl|ni
z_jO@emMwbZQ8VhCXU;T5`To798;^LhyyeESX?_ih3?6Hh2Yx;ha_Imu=|Wahonh=F
z6MHkFNNDgNvuiKCX8FP5oi{%brO2GiQ%tnLc#h+r4;uiVs4UKq8|=P3j(=H+8iqex
zV4B+C`S;}mju()n_&H+u@L?H23%E-^zHFdkd_-n3&RrmIjXabL4?0>dUOFdZi9iCe
zSuos?S^XB*te(E}T*^f<iYt+aChdp^t^ihkZk4-}EP8!HJ<H;Jj!i$o(qE^If~zoW
zEJ(UG8H4H3S>ql@();c^%<)_<64?9CHL#+E9&lT*gsC1xCfQkZE+KjkDJ~M*X>9?O
zr|`;ty@_e&N}}XL4Yrz=KRC2?*H)|!sf?se;?ZrzY&s+nMF_<^)Mt`s1G)?5p{4ru
z>7M~Qiw6LK<@Yx2oGE{L6ua%3pDcM2B*`Y8GOD{m=64}c`(WENxAdV5>*28{W3b~Z
zK_FQW=eWbWo@&wY;ln|<h%I<nXEYKWm8kfJSsG~O3rH6DvPcGG^{Dfe(9N%5RsT=n
z$6x^w6-m~D6n>On_)X+-QE2#>kzSb_0Q6mX7B3`4te3mF>MGXn8!<w0?)fg19Wf7@
z=g>c|0H{O)X<#h+2y!fBd;tB)3icRz&==!byQ_A;+qjGy;-4d*pY1$QvIFB9RA+Yn
zI|xek{_{Vx`50>9`*-G+>ek924w(v6Jxul({&H_1pG^Mx-><DK!~Yg!Wf}grL;hKY
z{~ei?b@*R#_+N4OU;Fr{B>e9z{O>IMzi<}ZZ(yv-XL+Gdl>FZ<AWQTdk3uK<cy6@9
z8_cJx0>Iw-KkZ%nTg>^}uiedYSKoF;EkdnBiG-9xTFNO!2UAu;QlZm^)O23!FhXe!
zI)@lKIz-b!6N@IL(l;G69Vi)7O)aAtoo1fboqe9~b3NDf{0Hm0{E#bi_`Kim`+eW{
z>u^_V2W(M^Nbp7>iXXuNJSi>j`c_Hl#aLK6l1GlEZVnuAFOa<=TAO>JrfL&CvmYY}
zf!u(o5X=G5jb>Bz5ilNw_#YtpI-+GX8}OVRgiX4@wF_^IGD(CLI+@sz!jgRV4yEKo
zy*XM!^HVGrt&OY4IEf2J;DH#Bm3Uq#kKIQeTs873P$W8)K$v0NJY7>$Bo#i{0MEf!
zOJsmJGoY(ZM`n8yS#5r(Pj(Z(Cs_eB=YpLj^Z=z|$^1(4>8s&wySw+4=!l2b<NmXv
zZoN*v^~P)@=<}|#QMX+(AMEfyL5_QKlOk`as%t|Y3Y2hfI<+Q&l6IiE1|VrF6(iJh
z00i3IlXi8?Mm!X9rvdYRFZ#+o$x$;w&6ubb18TA6l6~hgow%Ecqr;D$9w2$H#9sm9
zMHpt2I(P^aLyjPc`K{1+Hom{jAI!qwuL{b+b^2k>=C}FaHinWBJweHPQODY)+0E)l
z!}A(yLU>g5a^kMu)C7)Mcw;vy%OY7Dz+||_f&bakh(j>5-w5i!{1#!RYu;r;cn?JU
z5$U`8l?&vtMA?IuoTN0*Ku7NF(N*3o6c2CdNlH%cc^5Zw2ra+oDxz%pWu~JYcI?=3
zMSzmeMt1~f9tQ+7&l*-9FQFUCAkhFw@1#OR2k#uY2%u|Xcg2-zp->>Sq_fmRe`*#S
z=mBh{0cOlV|1!=SUFOi5d@BNLPKO2s2PfoGr&}aNKQq>6Iy54rG^GC6OYBveuRtCB
z?a+#J*4&6rvqrNBg?f$^@e9+iiqP7wQy*x+n_mSLm4iN5CMqKadUoSfRUHXH0Dx;K
z;DO)7=|8JsxCZjmbo4iz$ci40i8tX<bsw5GqdiYpE5%S@S5&$j$-oYXJzLB5-PH%}
zXc`#fH{o6fAmA2or8MA#nGj1<<QgwJVI-V%$E~?xU})l2bPwnM<(C9Lwyq=`m<RcM
z*P_BpL+@uRY(n%P4(3VjN&AhLpQtv9cS1Yq0Ls}Bj|~)ZB<vvDXxdc%5W9)G_;t(`
z1AV2nU5~1xSJVT=`q-4*y6V>_hOw=&xxA(7TeAbbAKa%#3VG_m=^_I}?b;9R{92gz
zZG|gX5IX2M4AW3U&*X1~sG-<j%2U-q#Y?(e^2@`~W}w?`53&yfMPYyP*X7BwuT--9
zJhXhj*y*c~X}+80*xLi2M6N*+5784Y8nljRV)ciauwZ5n2KW}<Fw|k~dOA8ftx~`n
zThWKDs41~ku0ywkw#ZXIavH&oU|<_Eu(5cOV2~;#p<X}`ZGcBT=ZZlHtXT8N$!w}z
zXr{0Qvh|ER41WaQ0|B4j+g@O^ui>Ow$!<WG4E%?F#@=^ttV3UU7_IhxDJB6>mmA-L
z`ObasnLk%)G!*!Fg@%oz_IjL_IdCeNTEa!4#v5kV0cArFecuF>Ex89lnAewuS#)B)
z=MtF-cC-yo46QKA_khNMJN_-l!O>iwy+gG!uqoeb>}@a8QIaV&b@iO1W$L%iYF~v=
zh@{przGQTfj%Q)6>$dFS-Huqjn>+fsl`S%5l7R5Mw}4fE2zZ5kFf^hgvtILyS9(a9
z_=gvF&wR5DTpo_GCx9K7<UxccatFlnC7FfqM8jn>V%d67v9_4vQFo#pYN>l2AD@As
z`+PtPy|T1k0N3Pu!pL#Au0`K~2qy^xEdaXURlel@p{)_u*><$rV9eU$=r{t!IDlp4
zsK#J90Wq(p!|J$`xt1Ju=`ZlBjc|%FM+AUJ8VEeeuRfzmwYX1$-dY;H73}b9!J6)a
zdXTivcms3~Dr$P_R8N9%qK9BQVv>*Ma5|zuCp@t1fp1x+h4a)Mc_IBP#aa3Pt|N&^
zqdNfobc8s)pMJ71!UT&@=zTbYU<J6|DJpV|$?<4z7#y1DkUyP`Ybm*RX;gf%oh2O_
zz{~06oI>(+m9WSBMqz8Cp_g;2_MU+m$uMr*33oy=w`UX{@rL#LLSlH;G{{=RiyzlV
zn@Sek^a?dSSR3?fU3;b5rU<t#I$l!V(pQI?8dk`mS9B{-pdCd1{^?*>lDR)=%a})P
zHz{8<<+HCJtZiK$+&bDScHyHX{9+iQn8HbP<X7=1nD1_~J-^oXnD&2<lf{!y23%6n
zh?atD<BvU#X9wo}-OpLaAn{FyBETu+aZguQ20Hw35D+&P*0+t8q1zbW64)|uXySU6
zZQy;{Vb8dGBWAeOEQNg&(EOKP2{7J?%O&%%ik?<T{Y2j}fjC$6gu{2=O6&wNRKYOT
z2LJ%AiM#i72q|lpa>HYFyUn*FY!C=z*`b*E7s8}H%n1?`Gto_c-ou>}aXaA4DjZkY
z7L^zdd=X(j^-X*Ih6u(Bjoj>NY|8|naG*RD)b4-w=`+{sRoja`*Qy8O^_+G^@5t9m
z{E)Y{dpw<>`DaC}`q{xzQ-Vum5{W&42<&JCU<M$q=Z&!UtDhLu#GBA<%F(|tPhR(`
zP(C~~WF<=i3!#l0M*^RqmK~bAmvsfE((N5tcFW{c;qTCguvnxJ7v+KzL$*6C)`Nl0
z43bLZ903jFJOOJK7TfRbn+eR?xVautzDB*3I1`{JF7`AdpB!)sSS-N9RjZ?C`zrFI
z#SZAtFCCWQirEXchP!|S88DQD13cg!4;<HA?|JAotE<Ien#5{^s^^XH&_Br$tUsgS
z;unVFpVo~P?3N-l#>oezcgCl({~!)Nn9^?nHQmpv0QR>)TN}IiBCuAC&f<mA>;$J}
z?ftrEbcALgx4oidMd%^ckY-lHGOi}vDQE~_%Xz@DW$@l`13-VoY}ERS!Wp?dt^5O~
zCS87l@)-W*!d(g7n#H(w?RX(fH8mzw3BXfIGR34MN3Jkw&|hlUk%_w@8!s`q36I~x
z;_X@E78;$CBgIC%1kiEvfX1|q_3da~PJ~6@1P*)AZ~z+XEY@BRk8)t#5^o7e2gC-z
zgX^p<KOEc>J_o`g=o2K~W<E_OBrYEUSSz(^zS?Bm!7YRsOH`~t%6D2ouK|vlg~c^!
zZkat(kOkm{VO0Y@uYPV-Y3VuSR#;X*r20PR1qv}NUuS_4-_~#(?k?xhr!GeV+0pj&
z^dv3@@GKtY78e&^k&k!nEy%yHI637{lY{c=>gowe2{DG<zodeaOU`3305lgu7Gmw_
z`<#3;G@-g6;k$IzHz)s}r-(SlQOF^!{y0rXwk$s>CtBBII4dV$H~<8B3pvyG4)$4y
zK$z>V?i_85-0lH$GH-0A+SIA~pn>F-Qw)M?0$VIu;5!+_0#Z05)Dy5{#YIcq*+Sl5
z|LSN<qEAy^b#}g>t**c6$HwLbvQ;$0fh&}kKY-91d{6b|z*>G5v`Oz|bqIxX$ck#F
z`3Z7GB;SJxil6tLD(Whk>y(l*louqg+*9>q1!P0i#V3&)@z8<$Y=GOE7fhVV^@xa-
ziSVv1WKMokSFhukHQJHKF^R8sec^n|T6$(z>bmcsIsxD7sqZfJ5@$ZUD7>rNSwVK!
zYB4ZJgWuW`xl-b_xzl~o`vpvMFalTzG%x>Bi$PwK;8Qi6Zvk-WO6Xgj@`FB)?*UV*
ztLgq_?Q6?GhHEY;{P;MIMdKKVl*v)WKq<|G7^Z{QWh4K_tq}v56n%O@p-)rRO}H5s
zd47Tg@j0ByGH76DQ}-PnXq0>t<(Eu%p?$jqPU}uwE$yZISBM+#_VtxAx>n2TC$9Gs
zdY(6J7p`iR9$VP6oYU>nJ756Bk<}o3u*`hpvKC~{JICCfdKsw^M}bYf5NkZ8vdQ?e
z%Cq57^|(GO8YlCO!}5hyWD6&n^S#QmUg5OL*S)<45ISDO;UdQ?Hy9<;@QMv^bKRc+
zRvGEr-m*W4osD}OUJ6sn)jSDO`iQx5WiUC?g?j{9U~NJTfJm@_a9{coi0IF-P435Y
zXMH)`?}y^s=Jten-}M-3@+Xgk!gsHuT+6g@hMR24TZ9$WmVbU2rKI%9JfcGh`t8Xv
z;qqBQxVt%ms>EeF+S;g}CYzZRuk`&$VEUc`W@VO8P-@EGfKLFAi`0iH22DM6DW)*L
z_@%j$aj-be0cpiXOUt`~YxV_@*A%{CB&#%3);tFjcn*s`OS7j0%<F`Ds?;bRa{`c5
z#gM`Z$Q6;mFJYr>fJZ7xH1SM+SZ^)Z&%c<3tZKXJ@?wrj<Vct@1C(uHK@LZ_*CuU=
z^*J^#S~s|%P+pZ{W}vOe^b8LVN9AR-gqPDYo_&nM(fgC<^8{&tTR9nB`lwcLa9j!u
zWKTF?8iQMXJ7h2q6TPg272Aq}?u(>N8Pi}qr~cU>5pn!H0RDbJ|5n`Qfj2W`WiDKa
zL{iS(;vs<NF>6S2s|-|)!-AFi1i^@kqv4qEH^n1tUS*4ayU*HCc|L*(VA)IftqnkN
zo|5KHhlXR}|DM-huXVa|dG43&;zhsFQ`@HD#=TXa^Igc+1zU7(t0B$<=4Mp>y>J=h
zVTKX6d5rHf@tk{A9htJPX1xgn2s1Dfq7cvs+;EMzfe20lJzO(0tA+`L#0EXZB9fba
z^5Uz=b!q$t{sAbWWQTSb3P?_d4|(=e$<inT<%w`Mq{$p(wl=C=Lr#V^#KBM6HXcPj
zao{ht6_tpk)|Y-zAXrO^ng$Wp^~wB!KwPhGr`8uv1q1b2LOl^EBd>-@jN$xo$CHm^
zW5-WPok5$R#zih&si0?rSEsec$KJ%7zWh+JcMP<D(yVWT-}Pp?mVb#d0X$A#q|VNS
zac$4*OCZ(T0Apla*+}M4H|?nlgVc&_+5LQ^TJ}9KJA(mz)_!MX(zS;d6gYjSv2aGK
z&8uH}RsP=Z*XByLLza(JpQaI@*0iUojFggb24Q=H>nI)PYSJLENd^)oq#Q6h%g_pZ
zt;|4#qtw|5x@dop29S>dF{SxV?&99U-c>awfDAi9B(z0pV~dR3;Z~6}9$F1Mxa_#{
zCv=EJaW}*$16&RiqI|Cf8yuDDVoEu|3qIhVfr~o65wY&+;X$}4NkXFzVp()ry#az>
zL$QI9+_=ye(mD)Nz@W32$n|TB<$VSWc#x2L5RGE&Lq(EMq5<pdG-uq?nen@NBy#w@
zbmTWf7YvjWO^rwv%Lc4aTU5&SK%{N8uM#()z>IS74<%F5A<P8@C5(z2D&v^Rg&<AG
zo^@`}(7w7kWmOj2j(BDhoQ<Wc%#PE5DrBGYckx!Xdhak)98JIdcY2Kjs;8${cJIVU
zevL260K<TW4D~_M6yI18x0wHiN?7b$`d}FdhE5@?{*!C_4|+O>4L(%kU%qZQ?L*_%
z7q0$N&-PeDSEP8jhD;&8NQc^y^6in2itB(gs5;f;+>NZF|76`O@oSuAWaw=A*Tb(l
zLNT~^rIH8u?&X<9S-mQWeak^5g)^tydeDuw*JUX)R%32L2GOK<?;;X<=<S@hv@2j!
z)1RBNl6e;-?Mm)2@=pfb6_Ce*fUtJmx_1H}0J=nc?Y7RyXnA>hNb=k4`Sa(uE_27Q
zql!mr(<hk03pwWwsg(*8a04orEdy!55%VSPixm7bny!9Bf0oRB|NC#IUF%LNm8(k(
zGRFnU&z^B9|506yCU9YN-0=_rRvvsPa@Vx4i>_t{2L{I09ka8%fZ3^6MxrIvpiR?u
zpK6db?yVSkXy8KZWAf)-M+to+YPwlAdy(qxseV??JF|zJJbDKs&=V61a0liP)7VnC
zT=^nBnGgT{WIX7}ID{!XfN4W6TJi861U<|i@)d_Z8hF;%3QjY)4pw9#ijb+Urgo(z
zL}HB<?^q)+reX~=wobeO%>kf-5n9QOV5qlrCpdB)aGlqp#N$wI4^kLSz!PwN9f^lR
z<a#7#?!Mcd`#C$`ri9ljU}tJwWsTB;J__01OG17vo4-E9<l8Z0Y*1c1AgG|zU{0hj
zeHN;+)a?a_(+ZA=<I74*Z4esmNCQPPQPLp^+CKrXcaBMzi|a(`qlb0=shc7?y89<P
zsF*6&@fQ}XJ4B9TL<J*H3q8=8+}z!%_R2t9O9NL=J+OQEo?(q71oj*T&iZemkqz>o
zx9NSa-}94NJ(E^^rLQ)K;1!&SX3SKi9*r127kT=$JxGh4peuF4$<!X??E_#KQPr#b
z?!9ZL^kCme$q3bxO&08`X<PuCJ&_7iRK82pr%ugWr5HMNo!z0d=}GQLKPEWJc%)e{
z*QuP$|CN-sU6%Joo+f_)q|DbFqSAf`(Pk4#6yaoc5k#zl;N|G(y%+<3Q>BOF@~_zW
zO|OZA$8A(d?|As>%(jjPkpo>hXQNs8y@_gMrua4$9Dk02*QXcy)Z5B2knFL*`6XTS
zX<0FX2Pea60laOGFUBYM+4i-#XDo8P1RS5!pbF8nK#l;NL7VQ9!`CSrg}#z1jE{&=
z&ybwMO>aA?cd08!YC;PON<2Y1@RN9<Q+atx<!>rV4=Eo0gy3g9tiXuJYbcmdXfZPJ
zlCb|HUrdZ4KrkYPH^`b7F@|w+B|6qH(=wa+jneC-=(t{jHy+gLF~pHYgQNY^jAzqa
z3+%AJ&!7Vc;-c0s7`=k=E4E<K(RhNpFiK!{-{F%v*D*)D*lm{Y|BUJm`Fdm`!apPj
uFoWpNKM?lFWB3QQ8+i=>i{ElzG1_S9_%|<Hm^3a&Y2(_>7TIfdAN?-@)T%@P

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/links_validator.png b/latest/assets/images/social/reference/API/trestle/core/links_validator.png
new file mode 100644
index 0000000000000000000000000000000000000000..b4bdd00f43b91114da59107f45fb986e1b927e09
GIT binary patch
literal 31942
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
D8}$Zb

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/markdown/base_markdown_node.png b/latest/assets/images/social/reference/API/trestle/core/markdown/base_markdown_node.png
new file mode 100644
index 0000000000000000000000000000000000000000..875f954b6b6d6d2e3883a0b373cfb1be8359a17e
GIT binary patch
literal 34762
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/markdown/control_markdown_node.png b/latest/assets/images/social/reference/API/trestle/core/markdown/control_markdown_node.png
new file mode 100644
index 0000000000000000000000000000000000000000..4d3abff9b0d55f6f0708af339bad545b2a3bcb19
GIT binary patch
literal 35116
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
ZGHERK7#)2d`ena<t5?{v1mEvG@*l`y!t?+D

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/markdown/docs_markdown_node.png b/latest/assets/images/social/reference/API/trestle/core/markdown/docs_markdown_node.png
new file mode 100644
index 0000000000000000000000000000000000000000..b6aff5da307aa46afa77c2ef4b688347f38a246a
GIT binary patch
literal 34469
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_api.png b/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_api.png
new file mode 100644
index 0000000000000000000000000000000000000000..3579ef3d2f9cabeefd5723c27b8d6dc1d54c02ec
GIT binary patch
literal 32920
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
CskEK|

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_const.png b/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_const.png
new file mode 100644
index 0000000000000000000000000000000000000000..238ddc535064694889e21a6abb64ab70138f46ac
GIT binary patch
literal 34232
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
J{OPW5{{z(6$bSF;

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_processor.png b/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_processor.png
new file mode 100644
index 0000000000000000000000000000000000000000..8b61f5d1541345bd38192bd286ec2614d8984ab1
GIT binary patch
literal 34608
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
NUb&XZ|K4rie*pe{OMd_W

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_validator.png b/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_validator.png
new file mode 100644
index 0000000000000000000000000000000000000000..18bdfa23f0c8accb7f26365b394ee1269493ea5a
GIT binary patch
literal 34608
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
BPO|_2

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/markdown/md_writer.png b/latest/assets/images/social/reference/API/trestle/core/markdown/md_writer.png
new file mode 100644
index 0000000000000000000000000000000000000000..9e6e3b69e13c89b996e6851b21245ef460220a27
GIT binary patch
literal 32708
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/models/actions.png b/latest/assets/images/social/reference/API/trestle/core/models/actions.png
new file mode 100644
index 0000000000000000000000000000000000000000..dd52e4ee01845df3aabf6d513f811f523e087260
GIT binary patch
literal 29851
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
Ee=s+|hyVZp

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/models/elements.png b/latest/assets/images/social/reference/API/trestle/core/models/elements.png
new file mode 100644
index 0000000000000000000000000000000000000000..a62304be5678da80c40ffb790707b7336790fc0b
GIT binary patch
literal 29831
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
O#@t-@xrjeJa{k{>5==D!

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/models/file_content_type.png b/latest/assets/images/social/reference/API/trestle/core/models/file_content_type.png
new file mode 100644
index 0000000000000000000000000000000000000000..088848e8ff0e6a1c5e5ec66a93a643eaae137f67
GIT binary patch
literal 30924
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
apV8!0NYqqbQ{eE~@o-=7ma%N-zy1SrJ<l-!

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/models/interfaces.png b/latest/assets/images/social/reference/API/trestle/core/models/interfaces.png
new file mode 100644
index 0000000000000000000000000000000000000000..ffd49068601becf1ca90d639ea0928457e65fcae
GIT binary patch
literal 29954
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
EFY8;+B>(^b

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/models/plans.png b/latest/assets/images/social/reference/API/trestle/core/models/plans.png
new file mode 100644
index 0000000000000000000000000000000000000000..e78a7448dfb940315e184e6e7d07d3f14c5169a7
GIT binary patch
literal 30063
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
IKHYx!U*JH-I{*Lx

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/object_factory.png b/latest/assets/images/social/reference/API/trestle/core/object_factory.png
new file mode 100644
index 0000000000000000000000000000000000000000..6a0ee94e008e3611aa3f7d79ec3701a8de5499d7
GIT binary patch
literal 30874
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%0A&&X8=1<##t$C3`c)ReXVd1)m(?41&vCD>zmvI=
zGi9*!Ue6MF6!hrh*!&{_Sz2pT43HQOBcO47t^|z?y`rHF{^}3pxY*X!>(=Ez+{EH+
zehr@o<ahA9N}wV^K=9CB7@og3ww17$Oj<SL$>GZ1Jf$^_``r1Q+{u>y{_u#-Lqlle
z?6h5lGR}G5ppMWKr5|J7Vl;3)izB3TdqG+11IZ{DrNe5NRz#xdWV@;sHFsORa3n1=
zK+2dh)HcJ;pc$s!gXH&N_Npa43y^whL^zs7j39^TlFhP6;JwfXLhVMV^47aVwYUsl
zykh5*dnK;Y)$rw+uRDDraz5B3i_A2G0H_DEKwU~yrz9lwRN7^ep%wfQZyZ;Flx?!t
zxukTY#uVmLCM3GVOH^#L6m8tAL})qrIZ={8=B3_vLjYQ~;lA7c1dx5pM(8g^v(5=T
z^+o8p!Ysju$plTUuPYnhyzAZ<>S^;2!3inD1I$3~5o>6{4zamVRE5^f+3+b=kZ7&_
zHK;~v5Cb|Y&(e4PgO5$2mt)bBW0N5l4hL0Z+d=DG<+GK^gafZJT9$|VTh{PEPu>G}
zufZMYx0eOJHp-eY!?WYHW$*v<>;|_IfBv9c{6V?+-)wBB1m(6i7PmRyRMWZn8*2yi
J`nKJt{{v~wJe2?d

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/parser.png b/latest/assets/images/social/reference/API/trestle/core/parser.png
new file mode 100644
index 0000000000000000000000000000000000000000..aaf01e6a0141fe46f78c707553bb530885d3ed68
GIT binary patch
literal 29956
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/pipeline.png b/latest/assets/images/social/reference/API/trestle/core/pipeline.png
new file mode 100644
index 0000000000000000000000000000000000000000..33c99d8e45a7b019a086b5257d9bd5370ad63fb3
GIT binary patch
literal 29837
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
I&-<Hy0Z<YC%m4rY

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/plugins.png b/latest/assets/images/social/reference/API/trestle/core/plugins.png
new file mode 100644
index 0000000000000000000000000000000000000000..afad910568157e8066e5bc0fe938a25ec06a1cc1
GIT binary patch
literal 32293
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/profile_resolver.png b/latest/assets/images/social/reference/API/trestle/core/profile_resolver.png
new file mode 100644
index 0000000000000000000000000000000000000000..228239b30419e95e06d7f48cbae7a1e1b0bbb646
GIT binary patch
literal 30266
zcmeFaXHb>v)-8xRVir*m6h%Q16a_?*iim*ZEXe>WIY~~sRSc*|7D=KYQIh1Wh$I0e
z!y-t|IZ5vEpy&Heci+C%b-SwT{y4k#rZ@^~z3T~cjycAd^E{Q76ro<fXFU}a6}9N)
zi?UQyD`TmsmRqb{jX#k(XRAg<WwA{3;(2*1zkx<eyB$>viz8(p)?B{O{ZPZB$#(me
z^F8|&Vs`8lW_^;G9Qnj1^Q{u=lXv%?y*<5b>&}qv`*-O4bME=Mdq2uW%ckc)bI*#$
z`)b|pt81UI;}dXsTw3a5X3_awYpP^0O7x-!-je+DW^`oy&v#V!TDM$Vw)Fiuy_L#;
z{_w}1Wi)@jOSp7z)t~P^ZvD@XVI}^vAWO&L|JM`Z5J3Ou3=VI)fB$~#&=7l8Ru&_p
zo4fl#6%`dXSJ##n*Pw)hIm?%RO3~-a;hx&K_jd>C70%x6-Y?<H<@w~v+I8#JZQbhH
z-mdlZ#S722d>3(fd5`}3MDcg;-d$wrXmNd?aPsNePvn+TQN4cj_;K-*tq0o&(}%ni
zKVB8hd$!X+*ZbA0{cASUd#u_(Q?OZZZvV*0Nc2ADqK$+1R}Eaebm^IF#JLx=C%^Qj
zbrgGhPYzJTAFQTs;Juvl^!aydyl76<B^UbR*>j`Ltje+HY$kfO&8(OhW#euLr}ljC
zZ7*ie_6T%bP`UJCPe<DQcUKPNaO~&fQ=_-~wM-?`Ch_anua|XoBZ5Oii>JrBv}>Z(
zIcz8Odm7V|Lm#W$YOtUfn9hvr)TLX-Toe&0u20ls+P^=iBKK&O)5hI5wkDjpI+QgV
z9U8cFt+$5DhCKW3%Pr-_rhata*}KM8w)=Q3JhY3w3iBBpSv`*_S$tV5<F)l#T~1An
zQh@!W%G0M$U0nnhl%1&e9-io}ayRWL61{fqZDp8@&{@ktRu}%s*ZTDdqF75m)A;vR
zf%cO=@)7cdbBhnwZ1$QROfP$IaA|Xf@EZqJvg}eD92e(X+uAb1a`N*<$Y-2hm>mj{
zd4EZg!d67TJZhVKnDlur{o4JXZk4$G_#y3Ef4BR`d5ggYmZ=6a7iSSAi&d*uiC(<;
zFwd0j$&d4o*6)mRsApwnE~pS%fwg9Bf273Sc-Osnrn@54g;g`lZ%RLQ?=r=ccJ}t#
z_yFZGnu56o^YioC3v<&A`QL=gD=M_71{-OLllALb@Bbu+;GSiKe7Kw4NZzjU4-$L5
zr>gK(CHC6+`$pwdNuy)qRCg!)Ka~}ga5wA6@d*fMWKDPO<uU$sPc7X-Lbp1KCAq=W
zxxuFI;|&g<?|sw1e-~s}k7-qWkZ^nT>en|{Z)(d1lgD=BKSjzv-IjXl;^MtHKjav%
zTXj@wbELfU^XDE5^Rv6Ae<$cvv`<ou*kf6b9u*6)9ZY4U%#D=^O73MK&q%>p_u<s@
z8t<(tHn4BHTOq+=)_KKx`12ZJmX0I`nX}AA@exWf(Xz6#^4DEmT_dh0>MBymQyt~!
zZ+usx7n9jJ($yxhbN6nYxXmKZX<J52WSDAfhca)Q^gGP-9C2|eZd3@mu*!M<t%vOS
z^XC<7ZkNjK5SGEe0b$s#a6dn~$QX5X7G7S}7j!)3ZDoO@(XGcG3a8+_1=~%JuJU3!
za-?{;CAXtB&smY8UmJVA$)@kPbBAT4xwrVYwM#3_|K-b<_D8!kjC-jm1|5BU$JjH5
z|0$XBS$#2OjiT#dO4}x9?Xj*h@06638x;HL4sV*`JzV<C)O)#D<6p$Y#5~`}t4Pjr
zsHDG}UQM*9jZK;#zpWzq0M?_0N0|8dG72WE4Qc0Rhq8ScY<t5)wPq&=Onb_iM5Uy>
zU%#fE?v0EI7WZabl_ZyJsBS%0!rk%f^8@VEejOd1ZTt2e->{3#BgueL-!O%%C45n<
zHuieFX@?k(<)ELImR3QY^Db>llELWL?NZ7QA51=Z{yd>OJ;nBA;+>xtG^{&z*2Ud?
z?8jqviGzdV5DSawO9nwU=UwbxpC7E*WjkV6pAatW*z7R-@yV0QNF}Kz>#lv|Abrix
z7r%7LiF^{T<EppD@=c1p+1WSqkH3miPgh)+?qW!_7<dyL9DMoi-2_(kH2H5Y_8viG
z<QfX37^X|mu&FUS&QEv;fA}DF_39fx0sE`fQ7Q-JLM5wuom#6qf4<zud$E1Sg)!=C
zq8OWc+95>9QQX2^srzp8b=|v1mD=`_w;e0y-Q9ghR8;h2S@QrTx!7@Gj6tU{EwL);
z@n!~^5RXGgj;Px69Y0<&H)ohWz_oYs%1A~JEiU0X_JblXJuC+5t)mt<?K@k5Gr(Uh
znBkr;xcY-?RhUd}Z$6z-TF+tM`uzNS)r5Tlb}3cns!96c3pn801aJ6wcm#it3N$p|
zTb&hs_gBucszf~{^U3}?#$+E)&yd0FMF%FvUd_cBZ!t+pHq%C&L{9TwdEXfUi~iSF
zGi}V{%DNCxWd`aKKh4<b&!6@D*ryP!rb5ooQEu+!+LJ6Hm8Jf?3b{_yA74i5RD7W6
zTO2KB*PR*fQOrL3rukGEpIpD+Zho7DXU@*YOzcEn(#d>OO=h!D-MV$FZeR6BCd0n*
zo{9*g<}68m%l`TGL5bFP+Y7dGY87m8wok|L@aFG|R!@(}UYLpeI=~!KsibKiazRLF
zLxP~)?^p=~Puboiis30fZ}T(X{@f{#Deu6*!1@g9PbIii+K3iKH8nMDvkyk!jQ*xd
zh+MW}wK9L|`fQcs5zCh^mzS27z8`NPi`A76`S4-S+0R{Nfktur^o$nV-Q47H>7P=H
zzkio66I{%YXtpgaEmg!0vd0;zs%P1$a2ht$woacpl@p<s8b8zKBDnFz(#N?~@`h$!
zWkW2-sZ$2^w+sypU6*y|ZWh#+OYu5#@}x|nPQ|z0r21r|7&f((Yhy_`(v`R?{uYCH
zDY46!WB05^Y@cGYF6FlwKVc^@*qE+_j8d9GZMjl8K;XYVs8asReFiq!-MYvvG(#s@
zBEk?h6f0vin{TLGxbV**CZ@Vdfm5gC5Scf~OG--KH}9?fc#PZ{B%j@TC>|_w?LDD^
zY$lnnUTwkAWijD*baeFLG5dgzIyo`nc_h%T{DVpTJN)?QNInCvfo=8oK*8qTn#|Hb
zLH60Hp=6sYeU;${hcd=qN>HYzrjm8|-3zrQQjj0Sn-Bt*XKSdC+%t{%n^zX|%jJm|
zyQT)N;^C@DrDSW>Wy_Yu-}%WHt`O-}V$i_E%6jFfV$_{DK3-nRTyv>SDXt><d*`u}
zxboG}>c?<>y>S+bZ>VA$ym1(+<`#J^2R&Zw<u3Xl;Tttc;!`nhv3A?H7pBvr+P?XI
zp$YqLB1T$WN;YiNC(9KS6jc6Em0N1_3XQLAEN=`a+TEqD9?D&u8*`DHMOb<u%n%+P
z-iv4|jl-(Q-C+D6ZLE~H>go0)QPE0~ipR&2p3Ur#M~JkUs8UjRylJ0&q~gcQuTQr-
z&x^GnN68}(DvWiORCWJ+|IxwosDMCL&KPsVP(s4#353ZAT$#wj5^usz-uxDJGykQE
zdNM-Fs-&JMscTi(z1}0fAFlYkyK>llTk3*ND$ZWR4gcrQH}2fFP4=yzUSLj<Z8UrK
zTzv13pa;5j@gaKz9Wu^3%%xOK%+1el&^K$&vZv`277>Z$9m<fy8C5n1jw=b^SJl3K
zTQ!Q?qQ7=IW#-p|&8*dhIL}5IBTl-AM!G-WJ$l1u9bd&Wj1b1Ft-(9CUHMUmz1VPH
zOt!_0*&tv*UK=8oVoOU)r#YVP4Ngj)jW@d{S6QfAfXn;r3t_n@KQKRghkrBD@dH;=
zjDxCbA_Io=c4;bS1bhf%ENWZvBU;0%WtFpgZ+oG;B*g(i;A23_iq#uqm6LU=B6<-H
zX!^2ddLui{pV@rUAD|w7d;URG^lT~bka83y%icD!4+kOrYt|a-Jz5i~e!P~YHyXbf
zMfvZ%_G0&`Z>=L?Va(10z&@XQ^KWl(>?pf>&(q!gy<yh$EoTERz3T6}R@DhQa${#R
zZ6@Na_;9YO!sYTm@T3~ITo`NfJgOjzd_~ju{q@P*8>-ZMPD=wPe(Fv(PPrw;!<!=}
zA)z28FdZDBnjAekG9rTm+!-@^c8o{Lha>L>uTkcNSDwW`|NJAbuOF3$SG*qqoG4M2
z?@A@^ee(**`8$NIEmy5xebs)xhlSUoUm9?nzM0))Ax~*7e@;Dn$2>y!DBy`IYxdn9
zw~Uc*dufUhHdSs23eJza=fxjaO;T2$a$KAZ%!{|5ofH)ldzLpU=6Te!cFHJw{#IOn
zd5Ac{way*t=@!RLY$tyMfq&KF*cpaobv4S{&F#iS-*p9?;y9PzzpWz6CUCwy01Z@G
zV-UrrvvIABMt;|5Iv&4W>KCVMI1uSI?O12}E9X8<_L*JVx8IydS(u+{jtBf+UVP!g
z1-_XLhlF?YT0~_4r4j^PSW@Eo{ri=%8Ug=lzwO($vDP<Oclpy~XZZvKuqEnNx$WW9
z-N9^|wdsz$4*xgYOk;M0ou^Np43D4q&dA89pT)VMh-*3Pv8YE}SYJs>R^k@z`I!mf
z=tTrkWmdiFD4#t3SNg7QZj8Hk@1`jpYgS^;KBg3{%(`LICawk}dcB~l&NRpSn*u&5
z^LD<}xX7-arWMD!nAL|1lh=k-k4^g+sT3pTepn({<<qUsHz%(DGd+S^shTi7-4)2h
z&0W(wiRHQ#7lqPCv1TF|@r7pk^{K!ygcc@F&cvLX=Dn4!^RrXMO_{dZrG7l7`THz)
ztfg-Jm_Sd0O^P=#70pz3(e^!ijv|T$(67$8H?lH#W9+2P^YuHAo-vrMHvC}M`t>Pe
zO}25%KLlY+k9L$4;|7OF`kx)0YIfu`P)p)4%^mp?^&%NCkQ8mG)n0ClRL1UkQjD_I
zXD0fNl=yOczv0wF+IS-3?w}VqjA}y7wNG`{LpdPLyzeS&`r^WD2X1t-HQ%)0zD{bt
zX}`9%Hf^NnQG8a_s0!REo#w2}=|!mkJ{FQ4HVgbdhst7rHr2kU^(5g~?(x|zFMgJi
za>iL3mtS&2+<Hgq%U@@X+#3}a7yqQgn<g$Lm7Lb#v+TNqfPla#Vw~8OE6?o!964@%
zr`17ZA+<~!gIo#2<<7Xto-?+|+VXeqgym9<kK7jQBIRIh+)eShv)2%|I}&R&+<_=}
zbLqd%y&0>Z!nbrtvVcxRB_$_uNZj1qfSK|ua_{ZhpA*k`^k`A9scLqw1&{+$A&WGr
z8>UCTe!b|-#q>y~dU-&G?J}MR2LmHG-i5u57_Le7)BgERc(mwP%;i+mjwpcuA0HN+
zq<0>sqKkQPlOhLCocIxKfcsPOv*n44i>3M|wGqGU*+JfL&FrizfdcA`2M;>W*#s0!
zoVbI!R&hwXbG`NmL2NnG@$vD`<~tv!`y()gG=Dqa^I2)_#}vEict1XC**)BbYS*T7
z?yn%#XI_#)LrUCfqo#%%)(98V+3Xq_cSfvG@;+<01;}-LIa`QF)vR1kG^zxeVp%yk
zrc<XXdhDs``IHwXVjOoWd-?hvTbwR)Y>$k|as$LPV~*9SI7}+qihOB0y}<Esl}{hk
zDe+vP4zmN?0BxH3P2X_L2YM-TY7>5Pa&jFHHVeEW`;ENI+?a0Zt&wR{`09XAFe=$q
z)f2z~mQB|A$GJt=o%3mN5K6tVRQWCp-axxnHq4Bs^GzS4tpuNxKc<RYEAGYW>aAfD
zo)f=@-s)VF{Z!+P>_KkpQ7va}6BCnFgPI9?HEg>D?5ysaucqE}D9~>7X_dhy+7mf9
z>Hy=N=gtO{;zZw$>j%zd>(QJ0Jwj8AS5dc~th=pV9w=iwHRwt3zH)Vl_%2d!uvSk@
zO?k&;%|zssP)qrrWh&zvdv2{d)o7`CpR1$D(>=M#rg+uCng^!>%>V>9%sC=w6B+>M
zXzq8L%P1gQky#o45u7^rnCykL9Fsegq>m3DJyMz13OVJOcXJ~?bC;Z0VF16a7A|W5
z{j(=(i>p13WNlqBlshH*?1WJhpR;CXq(){M%7=skO?}$acV6*LRLap5V~wu<;?1mf
zFflH8b)Y;{iov<#`t|FhUpBBSv$78=Z5U|jkJ-|>SfmvY8+*dK-BpCu%ZQRx5^mo`
z&RJf3rtQ>K)>A%L2*Kg~Jm^fd0FPOXx}_-4)p4)Qd%3QBd%5q}`%5o4ln}_iyDZ`p
z(P&!s)h9;s{E9z(;)Ha7<ASw!qvQ7~-1+zK-nAprpRNfKdK}es(4eP0#B{t{#<}B>
zi;9fny?v=qZT?=g7dX0SC%jHi;tqQh6kH}a>7q=vUgvk8qBoyzmqlPz#U);!IR64Q
zW6A52Li2cIlmj(48iRumDSWym;cT!7z(><}_{fpS&_IW)oJLJ*05+O0_Hc^r<1zhu
zBXfNG?#``SuQw?Y+TrCXunxUrVu&Hi+>4W=N{AhKX(WBcEkPz!6p>s8^<fBS5%*WD
zi9py@RZm6`Ts89?Wuo%!uTQqp+&rd}Inh_6%16I*X9zNkmPROEK^JSKn9u1j_j~y~
zr$K$?4SyiWT|ADP=+0b=TR5KFAbZUpSyUy;Z0@%Sr_J~sg=`1=sx))GiSY`lNKjqQ
z6R46FmQ$9XOxFk!bENA*kvClm0F#xU$^`TTl6<+16mi(hig?C=c~!<2E2IQHYfHQ7
zEGEqs0Gp2|jR0j|9dAxGyX`!71c2O=U9;(izK@R&4Mi>OZg?8Vt0l;YV@O?Qz3=78
zC3av($9zXuS16ZJlm0|v2(JOyq3M|!8#_m74LN#-dr2KbLoul3+J3C#F=@RRNinR7
z@JvHFt4^`Qh1sAlo=;V*cuX-Ww!1=QS+%>AfQnYOQnZ>3ux;MU0iXi5AA!e~M+w-^
zg!T9L-^jmS5-u0Y`qHT64QEx|r`yy<;w&K!^Ak#Vh^}Ftwn3_5m9ps%zJ~F8&S_>?
z$$V7#bm_Q8hO$9jyl_W*yK)pt{$}NUzKO;h*}F9Deh&N9w9x(~Izrw9?rPQaiQOit
zHh*eG2S4zRv#X~k6G47`2Vd~;@Nn4A+*L`q<64!!dEePXIMN(;pVEY#X$q0*46OK=
zOlojjcJ1AJ49sC{and4|wz$y!$VUN1ka3KTJ||o<x#hWU;Gz=}fp(_U(#|ep<G!<%
zt@L+L)p;Xy6hGRqYop6etTT<K&%|m}7^s%xW+tj56e5cd_S&P<2i*_?Rpy>GH#;sK
zKXvPSY}!1iiM{l4qJMJXJv|irMZL!r8<;>RDaL3F#4WVguZ<Pk!oa`|l;Y0aY**3g
z`+?z%@j08xeijD1;q!5Qh=rDfF(W(mlyXHv!t-{Zy&@K+eJ6K{ZBK|d>tKz0v!>%b
z6Mp@ZxMLP4C#M2Q??7Yh7MUy7Y$^cc({%1Y*<)GtW4#sXLu~{|MMv%ESlrQ`x=*21
zvnQTDnZv4-N2~J!*1V9g&;R<h;PuIyT3{`lzC~@n&EJK!lLkM^M6jI>FQAmGVPo1(
z>xRx!|6`=cmY{IFV_kwUXEblzc=z3p=Tpx7n?^8DB289p)W-*NR}Hm}xZJlE7ruBg
ztfwM05|=I#<x4m&i)TPUG%CXwq{piMx=#v2O_|h2sJ@k6FbHbc<9u`u+|tqttF2W|
zG-<mu@%>a;7$E=7x~AQl2cl2|R+$gXufHxW{Yn>6nB2It_A?1Z1qITmF%(sk4HYUv
zrIY}eg#{RH+dn!H1F%#TEb3l~g;G#c^D8PUl2wY)P#_m_GvDyN(WxmVtXFcaqL`T2
zecQdMD37Nj0i}9BuVIh}%cT%16{v_zEC+6;7XU=J<;x@8;a{JNK&NzCS0x#!PN3`v
zLmUYQ_VM)b36IvujCe`UA3<~cYVfz`yX9Jy#-DqoXJ6=k)}<D$#$%4~9FEi(4t6~9
z;lq{WSJ*VOqR4`PypjjIroYDp{DjT#md8~fxD}9z$YUc{$b$WnL-ObNH!?%MhsC`x
zSYYAz&B&NM^&Y@q`NQsoOAH~$e6u5!MYwd(KZHJF-Mnd2()4ycq$?__vM{i&QEI8O
zhTw*h$CH5xQs*ZrOacN;$LE8_e;s?c^kW_}SS(NQp&|>v+ctYonS&rooocdO7jtdb
za@M6EDT>9;7J{YJLN&|Q*9KJT4KN}Kwyb#OT+d%+>)dYdT{r9j_VO0?d&}S^6SANf
zwePx^Ut9jZ(tbo9R}e&nIF5$^*jfe#>OP4OIv?octy-o{)w+WhRlZ3yv}`eK-9+9z
zL<-PK8|AoZ8UNH}!WHrHHGHsuWH1Vfz2Ki!8?+Fq2o+p^|K0cfIsXW)g(yfx_4dwT
zcTv<OsCh&U4WpSu4smlUnVOnnnMC40ed6c;y3M@5RwnIk4<m^CS6~gqK!PLZKYel;
zC;scVZ$%?*`Q&ngcw++Qm>7N{-r3bfc)?Z>s{pv*qrohSc*wf>`LT*^_3U<{+Cbi#
zYS%hyYEN)>mx0EELqbHsJrZ(}ylj4cafrD0AvQKi0I(yw*wkK`b(I#Tnsv3K;=Ssm
z`d5|_5U3ft>;YW&U$Tq}j<NSy^WMuJuO<eAS(1H!i5kVytKO<e@u~;~tcn`AUqTdb
z+p*)&=g*(XLmj`G@CwOTYBR&5-_|xu&qn2;h=swA9y)aB>s)w9Yx^TrvMIogb;(A7
z{UDi8crbO9`hS|CrnSVi`@s>le%(4(C_kw!PJ4rqCrM<{sSI-kninOA5i(7(4zG3K
zw|^Xdul%ETvTdWGIZUV&i53NuZQHkZ6u2HV?f!9~F3Ub$zcEeW#?6~d$Bq??9-LrX
zSXhun9ZIyDU=bJk@(6`vI!zg=a+7AL%@3VC`BU`ZqfdXO)nAOI>tol8i;1}br4~yG
z&L5&A8+qe<aqO|&><_|W-|ejwMODfKd=g2%2T$l<zh;?N)}MnxWxQ2smGU$b6H_5b
zO%_l#Zi#v|MdW*&S+>41|GBw2QV()~ecXNW#>3M93_U>#4l9*s82>0^Il>KFuXT98
zd2<w?Ae~h;=?dY4L7f@))YN^+&DHMy5yWB9uZ+0pQZf~5y5ry9+;WZbwEr2C3pDH+
zti@i(-4P?wGaYU5F7gD(Z9jbF6{<`8(Q;P%ze@2h#(<5nqiQL}=OLjn;SRbZ6Ikif
z<>}N!`(N=ttKhVmfsIqQa=7-)+Sqa7KSJ|8=k6`nIzSA#K|qj1V2_k|RfUZs2vcjk
z`{%Z8+gf{Cwp`PB{;yN}lO?Cf-NWM$q3DT*VmjI`>hiqh+g>9N5qj&3hb8^G%YEbb
z3f~K1|9hR)F6L7mE5qs48f-`%1-vN&LD^7#8#qY2w=#TmICrx+Zf9e8=vJ)We@W%{
zW|1`te2ubLh=}(bYDdRBG!I!W!v^M4w@WKIGX81$yIIV+kO_`7+fVu1p>QdGdwxZz
zQTFv*r+Ba`(*Q5QsLUms1&UVxD^#7))YSAjt>ZQ~(-&ikIQ$eRB9}5gHs%iAu82^A
z0PvD^hl|+$6_OZh1dl^rV4Q{sb%>Gi%ius|go3!hZ2u`0<Q~GKTCce1^LJILzJt)Z
z62Pb8FgGGXO01Si`<Zc9WWQphAhi=`Jrw?G|2Y?YxeVGLGdR4;r?<U=93`&S+}x~5
z?>J{dWXJ^Fsv>H{x(k180a5D_Gk~{>iExPOS~yxMT$ag)+bCdeDtplr>?!xlE!wO8
z+6kDeGpCxCXi#Kv6~5{elbcIoAOHqE?e3!We?Ob_yDa<JBCKEt0$8Uuc;r_&>tcZd
z_I%tYJl6f2989!bTw`COA6bNnMIrN8<Wc;+zel4s3U3o{H*LCgD@iqvMIOZe^Y^c4
zFBq?~Y@`2=-vQC}e>-OfTYFoss*%y>xN`5n&^1f(|C~;UhZ``7jM&pct!?gwhmgof
zJ|k(ZE1zO2RZv>$1&*b#u+X)kK@C49D~9+D6||@2^LqCu##&1+W4sK%df>nT5JU%|
zW^SXUW!`yI{uL_Nb(=SP14oOY<YHoEyr5edb^t2Rwyj$anD<pPHJC~(DtZwG4;i3i
zZhFkL<;yA}{(a5MD<qi_`Y+xN<eCEX3MPJjbyG7lCLSK2E#g8;7weus$vDUiZm0z>
zBY=hgxyqv2B=7t7?fwzm^vX(k68FITfZB3w2P02H8INiElZ(Q_qNb+tp@FNZULf%y
zT6sZ<7lVcwBJ_AuIW%>WQ=x-MZI%(o5||D)@Bpko?58A4O%64)6J3;0hQMp!>TGPD
z7;jldb8q=K7Y26F9w#er;Zt+m_`0@cBlOr3`EXfbqPeC*HV6TP!aD0sCE){+Y#0v~
zq%J|neGYZ4=}4<^=nK#6zH>cWkvB=&CT0m2dj4R5Gm;%gAghf3;A1>?OdJabY<V2C
zuLaND?pJjDHu6|8e*V)bYXe1AVt4eVu^iTesa;w{9xU7F==wbjW`6&^j7%4dYMDd3
zXorkgAw+R)=ygQp7C1?j!wNwPiogM|qOYvSIz_?C-5qRDAwp!&&-ah<eQIU%JwAXZ
z)S3qY!aboG7l03e3R_r_`;YIR1f6%n=gKHFg(4E%A+WFwMH0M#O4=G4iF*Amsv$3A
z7*b-80KE;gDDs2*)`OS8jR=vfyUG5n{E@o4x>4*LiCo$MH>UlyCoe>DJX;Dm%ol*F
zSk+RbFTJGesdjLI0*n&caA5nrDd2lIp!7lr1MM%kn_iLN2Ru*GF(FT+HkYvhH^$#8
z*`t!A?*pI3Q>oxTaV+-3jl5^^*K=3*G^Bo_%nD##DYGl3&tj989s)d^X)ZN)!NYai
zwfbx0%7aC>OKmPW4CT$8m_4A#cR<Gopx<=*PdwkTZOfMZ0IOq{t(fp9IXsenXATgt
zhWHf70r5F&9+6-`sjkS4*Iitg=Kz63vI27a=Zf6>PGVF0n#eul{qA#0B+YVYFm7R8
zEY+C`6s}OI1YAKk7ZcqM9AW^yTOBsD1D1xRKZfwMHb(l;QU=%`NQgW*ANbCa1R4Db
zYY(84IzHH_3PpJEXH56}M2+TX!9kbHNDA%F>{+i+z`49w)pVaKl9osu%pn`ARE;t_
zdal3UaedQrs$ULfo!_^*7q-VOxVyV|;MGQy7pcUu0W+tu@xhiuO&ogFtRPgMQD(C6
zHDkKdm#|(wyq0X)%xiuBV4B5H$Hj&6AfYubFI#>D3BB_e?WU#jpa$%8$Hr^Spxy<Q
zf7jX(Up*Y=X9_p4XY5D$ZfWhvte*0e7i%-@2zjhkdKOWtE>X{W3AtjGLH)WxVE_Wg
z(Pzc!aVMx5C3y(qk8Gl@g0sQ!#CfX0B*#UE-KTCnZ$P!S!~vt|@=Kcs4z?ahtZ9eZ
zMZ#dH;a=@EOG$S>BVLkV!u0yi&d#ESR5NW{1*fcq8h{dVN5=bVqzqF#Xu{Rgx$qk<
z1&E;7ucGRYs!Lop?_i1$Tr>OXZ&_F**`W+xdRLHKW~-lZI4_;;Ev~2v#Ibf8lR>3>
zgQF_~AE}!%Kv)Qf!O3>GMU0H)@!H}rx^QRgqcZlw1N)pYd8glyB6F+Mj|H*T!r%xO
zmm-nZ2!L@Hc@qE3cFA(cSPtPoy`KN~uLl;7l&a|j?358q{Ns;P#d^z%WzCI>?*?tD
z-;_~jJPSZjh|`7IP5w{ZeR5i-{Hw7q%9`QT)aSw{Nc9zaJy#2=hnuITLhB4l6{0wS
z**&BA*s0>rJ~LW0CRjnzaP#%;`{yUsJ$jJ#?WhaAQ3URs-Pwg;T2vV>*YWg70I5{|
z8{_O}1PF4Xzz&vn?GV-5K#-Pdgt0&bj<@Q^W#iDTWS(wyX6HM>;j#1YBNDyO*cal(
z((i;~)zsnIVnk3o!4A<dedBJ9i%1*osrQ4f{8Cy=+?rcQ#!fAipW)=JT6J(4l|AfR
zSMWC4S&Pj`8%%6$rMd4fsGPf}Ahv4Fnqr((5=_dWl@PJo11dHVAyCat4mKWR0JOW`
z-XJ6K<}{&GL`haLpd`t{K@qMT_f9@aS>|GNc8)msROlK!=Di;MO_{1mM$K$c_Dt$&
z`{Cs{NNNTI21STDhlxr?>N{iO*p(|+UcPnf1FA`qCEH2jBq<H<2dt179C%u{Z`;nW
zc-S=YW%C8$)|W>rv4h-oJ`Le_&*?k+Nva#|C>Dp=jFhBsz>yMHaB=RS<J`z&@*r54
zLtsJ1#)tDzGvg*Mr9^nObigQ*REDDQd;T0^vfJy|%%rxv2!k9EzVNg0xJ@xB3@_4S
zD*S{>e`Z*lk)wn%L+H(E9Y)k9B&ik_6}fqM?D*>&EQX<>1DD+^_wi<1n*w3eE;`l?
zU8kS7yjf|Lj2ff>gu}&)urK80zCW+>uE;bK%3_f}1UbcaWz=XJjfSdKjgH4sGcYhr
z{1Dm<awcUP1-SjwrlD*+Wn@=?t>ivFs~-W4K_0Tb*v?)g1!(|ai@vxRxzLw39iB>+
zs0#Y&(`Cg_4~FBeU4_<r8D6lMfCr54kk*Z?e33Uz3r~)APIo+wQ2hADrqkzkCHUw5
zCQV4hgjv@8@%B97iU!JpP|Wv26;+Chi?a}X3^_H@MPTMK-m<i(Z7iwpbk{5U{3!S+
zXefk=QP9!~ZZQD;aG8JnhtSazCt|OZo^LGe0dHN)ze$8-Na2?(ph<=&!RYFanRO1?
z^f23&+Dp0kykjm})iJWnD&g+>&HdB4*yb~4vqu#o!k|&sH%t~D2~4ofu8LBTLm{^)
z*VEJEl&|Ii_W-Bkf}O(0tDN5SW2opS0FWY~(uTg^F9Y3Ch5WX0mCD(Y^IQ2fx^2eh
zMlUL0<56qa_F_dPDVky|=8y|G^=nTg^F77}Mrt}t=Y_W^iG?FzgyYon82B}r`ghWq
z_P++--_VeSVoeut1$%->#cB6@nB&wMbN<kEvHH2q=JU^}oZm5vdE7Zc<>DpTa-ZMv
z^#@7+h>I5$Vl>oYWU7^>AV$+RX@awm2oz}SG4dEox0#4Y!%<K-%?Oq7{Q&c-I@cs$
zy5$ht@ah89&bLo)Yj)er;?apXp`LcPP<s{>wqlfW5NwF8ZX;kjR3M*!4<S!Ywj3T+
zUOtV+rIX8Z3wT9=@g0<@U|em#v_*lL?t?qGY?0ROdOO&4dYPBO@APQRt=FL7KW$Z7
zo2dqRiU}eMDB$D3Z6_+LyX}2}e-9)3yMrjx{O7>~>O@XP@G~^5%KHNyX2Nlo&uIGs
zHOJrWk)7^-@6tc>=)ikqsY5a{G8~|Wy{8neT4C`Y!aGK)QZ2}ovLRwSy(c+M+b<JG
z8&dkWaLPb)b~YVO4=BjC%7Lq9UH+CuptnPAmjwWLov>67<$3HEig3o^FlR;J#lwdW
z&zMs{jk^N~rjFC@?2P77RxH)2b<*2Ll~cDiHiLYe4#CA~m%BaXdBzlEK;N2=N-+Wb
z4XJXgH__cmVX$qqY_^ZTk+=S_=5rDN9Tui<?}qO0e(9F)uV2?l%HhKuG#seeYfU~w
z29Nzv=2Y6pGB_p+;rt^Uk7QjFA~;d=333nBFQdT~@dEE%HBhtMQjI(|(fx?&C*8rd
zlm>K%2dYzN)bip<ny+~~uc@33mEnjMrJ_>WpEGI-DaiXVy-h)MQqn@CF0?Q$oVfDX
z>q6->CST#H(ncf%Ti35Ugh~fm$SVX$9&4>6UpPMbkPYekG%ZQsJiyF+nNT^9+$?OH
zNkIe5Ac~#bS6?c$ng7rR8dhV9@6_D#6)QR*M|h?Wrok<mHgmRwr`--{dOI8p-jgSd
zf1R_Q9Y|KM7ok@w`y6i}`QA#+or)^@!o7|TVx$%jnA~?sRl~#S(W64bVc|^@BRAis
z1=*AV%Zo*#J<_~(&b?)&`(Ev9a$K}eU+73r7@M5#SVzboz*?KAMU+~k<bUYoRA1!)
z>1z~hw$*saqe3k=_N?Du3<5VAcbLC1D@f-DuWJgpk)FYzRQfsIO7i`krKh=gPr<2f
z+ckUQ%LRYH{rrO!d*--X%dA=g%$9(YJiA^L&<Y9)PNPCmpETcL)KM~4yd6yGhdlc#
zXxOYkf+rgWo%R~O0<@KNcHBLM;>##&`ciLA%ur9zj>upV@hqWTj@I1{6a}Ln`dBu&
zwR3;h>Gf@IR#F)=Esx@e3g*5<teAubl6cP&P^iUWXIAQS>URBvxf29J6-Z-zK&S*Y
z_u#-kr{}-AM54sqc%*gf)}E#hPcGv`H`<gjHd@clnI=OYEP~~!t>^mdM(`m{0t($I
zQi&@R>~5;D{5O(_y;xOlOdXMH2ui^tO7|dwulSgKOQVvm-S5)%rR7oV6x=k5P2M@(
z8ila#lpV2s_ih%53T&ezKp1=K1CH&S`WA+JIf^*Vn=rrqh-3jGA~1s_VGto{l!wb5
zNng~CMp;AH>jD_*WLxog)t*3hdj@afu8rob*j#{&9wi`fyOfR;pD?8t!|SxsXwg-K
z-W9djPGv=!uD8i$>{3MT**CMQ1RNPDy$A|`Xa4}fxF~t*Gqb@>WsH}L6O`&(osFm+
zf@o$j;n{_HbE%*L!ITFQ3icX8oNa2n9RmHs6!e;kpLZH_Z+#9=`)=f}C2AcH0;ho-
z`B{^;Z%&SNF|j10l6VNSuVwjV|Ijd=?vGt}QFg^m(Sz-J(-L#JEKpDr^2pWxvqvQT
zP9#Ve<#Mj0`o;DvUV~H<9K9cto8r@Ps04H8d2X~9xC+1QK*CJ6O(#MOxb35+6z(Rg
z_g6El;)+U2I5P$Sl^}6ywr0V1o7Q6Bh>KOE#Zh-R%FfQN5_}`|6tX)a?+=Sj&z=wu
zT#JCx$E(_5n~efB2cv-&ur9z@(NN)3+8dCe60as3`m0k)OG*^r=@WX|wwan*0Ze@C
zEDupkBT&!@8)l=##SSW17%c)dMO=8ao@?I*^=N>bB=7h6tk4pO`!xd9rtl;|JIHl>
zk7s;foU8f%x%{r=u4p`W?vmIX#ItATPVJO3vPBv83(<Y%67k9XJX8Gqx8RZ6<&nSU
zt%0@eJx^G1Q6&bU3J-Fa?%0)RJ$7p+L~P*e_i&R`0&7RTd=KXTDC{4`j^L_$gC5hz
zPfrs-6cQS`cQ7>N*YTLF#RXd-$`wgTMVQz)?q&cI1cM%+c5#H&r@r+3)|%`e$EnAP
z8?}e_rb1<ugQ32*G9QYzkrD&$Kb)=(uyyy>TY%#LaC}uVtAld)=)r@z(OCgDy)3>n
zKUxs)w4&&EZV{Oc^k-aZ46=MUpk4Y*Jq+4^mw;_~RNsFm%Wc%F@i}ka^L+g}jKs7m
zWb7M@d4*6=rl+S>?E6E!HR2<OK$zAJn+0GYTO9PQWz1pb5u&Ie(5dJ5!=-Y9Zvp30
zk9Uo*+Tw-e)8E-G6+s{<prUH&x~>(_QAJ$Ux$}@6Lu(D*TsdqGl$=W`fp?cEsx4i^
zF^==a(T*X4wv$m3*8?}z=#(C~sXcTO1|~TGu@eo=1If*XHFV!`Ism`R9X5F-nWY(T
zy{4Z3e?lt;#gyeyB-8;P<pp*1_w_|e1_~IY7>Q`m!Bk!?tqCVl1k{*3!&4|CesCct
z8`RXon`a?34+Aq;rv(28jM4T%s#iO`dHcYfb7f?|d;eYmQL-fq0i-hSX8y(roC<~h
zg|vxkRcaSamJoXTahdd~y7ZweJ*7aRnd>m{eECVD>`467YyQdFn-){k*^BdK(E<b;
z&C{_Oblq)X%t?Eh-8Zvy8I7=v2eZS65D%-qkIC&2H9g>i;7#y{_<z~|tog=7!ur9g
zQ9mf)obD6B3E!P*g#`D`bV-yAK?dNYs(#E^FD%R&k?JJ~&X9!2nDVy?*aox_yl&yb
z=Sx!OegK2C7ct#P@5Mz&`JmwH;<A^!bodO;>R|*^&IYzJJf%^3^dr)|(P&@)WjEQ0
zse+;+(>t58V0SbfsOQWbz?r>i8JJ}Jjl^XK5|;;&w$?|fCQA}mOQ?PyN&wD=TO^Xg
zt610AMXK#Dk2W~fdyF#*qIUQ(xq34_E0{{B`X^8No3k~Mxb(xIwCJS-mcJuUzHY+?
zclelSb=?t5!Q#cGmjNBYWA-wL3s#k*qj8{D_R{B)UJk2`OTrP-%gvO=d&^ez4}LmS
znkH$sDOCgll$N%3UE>1Cp!jQ_m*)<Ew=uK~WHPD#_lNK3ApGA?5eCn`z-<<O{OlLe
zZ_#T^;tgkl1H@lv`?;a)MXrR*;bCI}rhpb{b=TY!E1om;M)Z0L**J)c5O64$(`T<-
zzWfTz<!;^W@X?qfTa<)AuXIYnxnTkZI#v1Y4U@PRZ5G?5ix)4W1&D4i{lskz0IZCB
z5<8PYRwTi;T+(y%&top-KCE#^2Vzb;Ds#y?#Sk&iXY)s2ae`(Wg{g(7!4kr6&;*`A
zy}u2&n2XN|W|$)A*y=OvzqD0!-e?XIi7?jyaIe!i8%G}>O(swyp-b%<`f=bl%^g_J
ziyH`3Sz(-xLvgmj^7_&`T6+VU6Ju731<GiX8D&4tH9VoN3^j+S?xpXZ4Yl{sh1GEv
z?B!u4c+*3u+gq~QT3a`M)Px|)LX^xY+Ub_Z41{Fh=6i|PCJ#nhl9nVR{LRK}pU37Q
zIu5DMKe<;k-uPW1SIsx_b-UBxN!d!C8)ZirkSz>TBxI5d8+CtECzl$To_U-hjtE0Y
zU}7K^8ZgWlxs(gX{H{`+_I#4x3|A_j&_nl03m2)T<z^(s#ZNVSK(H2Ga31X}@g;<B
z`8(ka>E9|~{~;u!9i)F#1h={*179$TLhuIcOEVHuQGC<sonHA-wZ?ew`^BRMB>=@8
z9@c|}H`y3Xe-B^JHBcMr*>$^xZd3r|<0-mpxLn1;?@j2sPLD1@D(<WcYd`HZ%J^yQ
z3s;P@Y*EV$d|A{}>e&1n431!hHyTyEfpMV#o2w0{gDEUegsqE0(x$iVKbgKFK0Yj=
zgx&IlP0a4Cu5fAWdj3@aRV7!$Hy<Ome(O(>W>&xn_E_3mDKCx<-tS=bt0-_G6-49O
z*lQogoNwtJ1ryWXMtmi3?(k$b!<k%2$RaRi<WrC?I6x6`5C{HEN;<Oj2!UW2@{ISw
zhtPI(=P||8cr(qqOskQ1EnH`_Ka<aky*=6R0mU;L?Nc*j$%BFf{#zc*`Nt=D{`%(i
z>yMiF!?|>}<3n{`I4TxC1Vh5HKYjMhZQb_6PqMSK#b?Jag_t<>a5+Uqv4V^+{dwp4
zr>@tUupQ{kQ^xe3qsFkjx>))RpAJ1A8<T%pXPf-n8>z@-ANmlPlasTphO|3@1SkS6
z)$g?RDe0-hnjS(EfZO>8t5ZXyjAZt7c^^Y&BLZX)*V#u(5L#qm4iPed{eTJSROjYp
z35lH{9zk3I0)u(v6HcyFP8;Md)!FgwUuOzV=E?Cb8{;OtjqpHPfT^RMzD8)%dFd=-
zt`2jQR%4nuDU)I-G109Cv!A=!kMa2a92UE{F+0wT$yVS|cR!UR3lj)+r}~wvSKG|h
z?s{YvrvGDNdxl>H^Yedgn&O+q*sk{W0>ZKa(|E%Bm-ew4%T@qFGILO1Yqazme4N^`
zZ&IQ5em*`rDKGeg)J30X^^~Tck9~RfY*y@xpHi$(pS0ZjrhX<=hIZ+`ZoT&TyAQ)y
zjRN?oyF*Rtr0Ee{oUwQyTx_l=g^3TLp*%3U=*yhx2k^ML2fPs8oG;z<lPwxPxq0o{
zSEztPUwjU*ZLS@w=pX!ojp<((dzZfy4}Ya5bv+exCXSq<mqt7Bq1lXg9{}OzNt~=O
zAPto-fV4OQ7RFMCA?=v>Sg{H)*sVMBc+rm+SZxOv+rIlQSAr$kc&~p~c<Idt=9AxV
z`@5XNUAo!4oT@=0(DLkX3S^{QgVxqo$X%bOAH?0~&%PvI3$E_~Y)IZ<CoaPS*pBui
zcU8kwVU%~j#%EtW-+k&5`Lu#_!w=+=`;Hg2&Y4!iKt}Co8Uv+)w4|W8dW}aDhgMFV
zNcu=C91^3DVVx+D!gxZAlz!nvpjO~)=tQLczn=Lz6i6GB(M5Tm4@?{z?F-uukkTa5
zfpr`$7iSj*Y4|TE1kruL(@`cAUVYK9=?UT3d(E?BS~~`Jn^-zFCK7`%*D^)ej}!Fk
z%B6h~xC)m7&%)l*cdlWt$12qk1f@_}<5KV#xBM#^e^Xj}eG)9kUc(C1ItUbF<>lq1
z_$Im%VE~CmgosEalR-?W&um24@T#|0+}7!BLO8@0uE~tgW}faxr1ltAAVP*tG=p-?
zHR$&VUD|Gvu2UrNWE(EE(*1j!u~>?RsHQqAXH~m_PlZUAD_+M7yp}bny^YO*%w@>Y
zetc(#a^^S&LEbu1Xy@-fJhtzQagMPsa{if*i#QQ`3~!dbZhVAN+2fd!B#zAOltzFr
zwG(@~e*No%!sGM_wbbr~s!yl~ilHj0pJwDICK7^UNI+NTc7)L_eZ!>?L435yj1hEM
z`R2}p9_b<)r!RqcNomApx_i(TwY|lBx$<>LWEKO?pc~FMBu5%=vi8O{5sJ3O!f|0b
zbi<{#|Nh7+YiPcc=Gw9Vey0^)#8W^54lXv^9-o1k$$?|&5Kgk52cRp4UZbs~2~yeB
zalTKJ6tTN?Z<k5fi$5qok=<Ybk{67<cK4c9fLBDlg<fK4nT;kVFR;y&3<nU+RUK<K
z(Y=EBLYvlO21p76rF_=>q^d7P8E#10b!*q2s5}g<7NY2obawPto_4~t-$*Gz(jgAB
zRqstU{a12C*FYhZ4}SiYkKsovH}*yASJ6QizSi-$jD?v#4m2AI84#XWif`m$$pq*I
z=R&P`+vmhx)8bpPXMWX@_jdyxGznxk9A{z@M)R^xm;@}tTBsi_rc_c*wR1IX(P#5d
zRYz)SDruVmT*Fs(5G{+=9H1X+Z@TO@OoqM(fE$;tY59xJbTeq<bOC<PP*m_7I^~CQ
z2Y^;?Sq2W~@Vxkva(Ee4!&9o_Lb!RzW80zfe&@l_U<miK<aDoW0Lm0)4Z9KHX;@r{
zB*2w?YNk&D3el$KQw7};SJd~N=;2$FY42eD4}bPmLgLl)m%*<hkZa&Pd-W%-jFHtw
zl)G+#@)YBAK4Mf<=YE-VJ8BTwhaR3Nj+@^$rc(q7q_;O1^wxBUOP8|zuZ#DAxo-k;
z+fn$r-}Mic;U8m1ki3$PO<=1|@oft6NJCE7g+EBhes*Rif>b{_7O?s&z+<Sds~IY}
zFSiZt0LlCIjN!~tPgnv57<9dT5(XN0@1PlAh4u}Hol0Qtr9n|8T!oRe9zF5oKk~f|
zYD9UUW4d}nQhUu$z$HXG*oUw3a8WwBh?`Kx;k$(4-zh)P&Fvl7O|9QNM0Z>&Rfho4
zi<+CWzYg>ngDmDyoTU4d(RQnhjudWiLUJ@{!ZZg<Ox524Ebr@A+CkD<x@n*StzEhH
zK)F?&17nt%cRl#KvO@FGRn_qiY3=-ocDmY$HK_=l786}PyF#qtITuV1NR|}~2?+@Y
zaa<Pdz<am*Eeh@H=IOiGHRJ(ql5}`~{`~2buiuxnK?&{xG)le<S^yXLet>R=$@~U&
zunCWfwK&2F1%lVv$va5CgHn(_qYP$MeYOvnJ~7pWH1y%zQj8fOjas9ahQK<o#}U5N
zUTB0tsh+Q1T~pFrT$su>=oNZQDz~@+%HC_}phYhvvC0|@Mxq(87u=4;L?T*WV|*Tj
z^!Tx<tyHe@?8xp*qxn<C{k%q1uL#Yyf99qgYFr`qAERQA@nI)$?kN)uV+5=cXFg=B
zT@)z*JVGE;!uR_Y^@np~C+?{NHd&l*mISceHh#DqKxZTc*|)<`j!=3nB?kU&843?`
z>&&h++`aWRcqRk-Db$C$H77~PYn;^u{K#AV24Soh;Y|^@%fcWVtN_zXLD)10xr0Dc
z=z_tB04M^f0v@UNy^Fxn5!zh{5*i9o%0EBc3@Rox<)rDM9NFF(x;g0E^2jsK`rqSX
z_JTK5KqYN4RgvxJ`2VmJ6^rw0qQcNC(K5TY!;&~Q&;>~hmk6X}`T=Qog$xrGr5yL=
zhCQL41V#K%>ml-4xWq9Nw*?5~y)zT1^hjGd2Zt<aD<`D{j3mVGM5Z&m;W9W17cuvE
z<OP&GUc_1e&ia{JC=McN({c_BjAN+FfHpzeKH{xLTDQ3fffDW@Z2%CkclQciB%GV+
z@UQc})#g)lJGSlyS;eXn|5aKLDySDc5VaXu++{IyFxoLg|2loTlUUYJPEsds-AbI?
z>e;$pUB5@#2(0CCT*x5pVkpjttD`*A)^Z)pzk0sV5D4$+TWt?AOB*NHV#574${$i}
zkY8dB2?oj_5;B?XAw;pqO>PILpQxk$hu;bm!ex9%bOj=6qIe^1eBm<holf8RagNkK
zj}2!WkbFt+y2RABa_voCUS?^r;JXOy4&ow)4xHe+s=$H?Jslw8jfp)-h0rPM6WAPU
z46+aRd=D^dc4auaoJ!rAPq-qrG=N{PCi~FN+t3RYXUkhO6~=1NGu}4dHMkKqgbch%
zc`xU2PGcG=F3!$!fK5tp(gzY+L;=|hVo~PO@y0K`C$kFD2aVo&5GQqo&8BB5U7ETG
z#2r;Q^3+C)5FRZ2T}VqOIw07rzD@QKmu4HNYdN^=r^a6$M-0mEZ2L$d$I?9id!y5)
zeZA&pu?c<^kDR5hsVgZiM)#@NE&rEr^|5cMGnPTtXk9GncFlIktO(404|oxb=@lyd
zwL%vzR06K?@yl;O_OBw3H1sH%yNrFS3=TwMI*A#z=7d;%Uuyeq)75ybr!6A@l~*IT
zu<`Jy5E<=<*^eF~GNj$?lqBYvn$pkZ#*(`T!&cPVY~JYnM@DmbtBm|VHNJ)K5(^Xd
zz!S*A#)kP8Py+FzV*Bml`p6gwV!uWSB608-E|~q{r9^8HV!jEIADWFhWo_#ylb~h2
z!A#dT#(W||FUm#gWL~S`w+$fG*=Su&#8`aL#R2<KWra}O-mX_u;-aFiEOH;LY-lao
zfSZ~eB$iWkyHG{0BpzGRu3eEk{2KO>-Diy7(gA{12)Xw6>l3qP$pL9dp$!n0h)<x^
z)l(n4N?a+mRY|AI&Km`2zHI2qEtuzBpN^<YMow5HTgs!aqX8)llCqZ4EV1Eim*Q(_
zm)ZT^!;Sb=amqV>nw(hy1;X~%{WXUUAO2R6YrGcVeykI9&pF4H%1i}lQU%?dizf@i
z)Cy6=U(zy8zgGw?V$ad1L}rl)4G^#H;!I7ppT!DITcVW{NQ)9MInrJy@IlkrY}hCU
z2FqNN@YwETWCVc{Q(XPvI+?-Jy%Jpbof|ap9lh6N4nqZXr2la+$WT%aGdTPXqRd+C
zEIok!veY>SLE_;6^iC9?H74vr*GE!GSq}f6qRkA#Ad2p&m{!{o{@AD&Lon_rA-qab
zb|syGUkPlrr_jwISW-m>pF%&<^!)AqgDAOEjmL5+U8ED0K!TQqXtmT<58uMot5$^*
zp=g>ncrBn}+-#G&aMj!M4@e$roTMZD3UJ{J4fAmpsS|Fli~bWBFeQ{3dkpoQEt{-E
z<x9^S@r7>KHI<VV&AOmolL?4Q2u7qP4H-ZoUC1($)49DLmnmwPqx?hoEMu8{cZSI3
zxEM##?#0r!Y4c_!bm^Mb?RA?&kyVNCmT9=@nbja}NNEgUPn~f#k)`Ci@<@*dDs=VO
z$I-=wg)*dZ@Tg{1hIsT5i12dI56tU+j}aP!v~stM*yNH6Y@H8hj0sV%ohZ9db_+p9
z&XmWQ;>D9Mt2Wo37)mP@zK2#TCb84B_i8*yTLuJ6x`h>e1IxUgFasuX0v?(p;ys=c
zxsHeLMZ=dIu@My3QWEt-i4)j+r3z_IiOCp!2Cw``5t8OKlIH1bG=W#5Dl-_gMKofw
zzOD`#cLM!kJo7a<gykpQCCO@Xs1<M3_@=m#vqim|<7;@=TbY0q@QOS`uM_p_WYHy&
zKg_kB^69n<=}__UdC+9~_xkrXoBRL0{!r0lA`y4OK%mr4xOU@qaYBoXq)d423VGD$
zrD`Zc6wGe9{Rjw0k>~gka*iTVA8#{+ogbDHuV*h`CfPPv=U;>4P4~;gb%wJ_f=Ykw
z02OoVH*AoDe9COH5nrXz#mMHrOCdsDh9JcHY{%@z*<PfpUO3cbK;zvlR%25mz;gzO
zp0v0$mK{LWKaQbI6Fn9Aa729TyQ?Dj*w5rU(Q^DPn{;YY6V19L(Wqyo&EZqjPFFeq
ze@8wf-S<m_eC(kl$Bg&a$<-$r93%D?5T>N@0@(@>)D<+dD9lwPj{zh9YhF-KQ2Imc
zFmc$xQgIZY(j8L&WzuN?g&u|W5eEkc!ab9hAhi@ya648!-f~D|8WEAyHaBk?{djwS
ze1M`<pP+M)s8y%+Yo&=Tl_<v0z=_WV%4I6reTivb5)IW5y*){r0>T{ZH`ZDW+B%zh
z1+qy2M&>Y)k3pQWjEtm34ID-xu-5@dYNk4ik8mNSNDmpj46b1IWQd&ytL_RaO!VBj
zdjti*)9NSasDXhmQp6K9heq#h(2nxhEmy-hgd7}<JWgzwq-_I{Tm+plq*sKIv9rs#
z^ZRZ>=hN|7Nh59@27sWSZ&|JGS!Gs$x?<R_prGItoVAfIiO5MX0W5V0BWGPkrVqi3
zxcU1Z2lCs7o;*^u601OUj3ztuzgWG75Ne3MW9^(Q;Ntm)?#efCuB9sCAnrtIT})C~
z{%ami{~X?FtH13jROd|oTK}oua{jfkQ{8#-*KJO9^<Tru?p6O!e{2k6rN}=y>KL$s
zI&fxz*8vQD=wm9Xs~k_CjE?WeU#fjBE0Y4x4c+6<N8I&-j8U5WF%|fCP8!vLzq8Qp
zb^cG^?tk=D?oXJdHvgHVM#a27@Lw<VKY#B3(F^^rufl&`4cqy@aC-i;ZvR=g|J+k@
z2L4|M-2Yse|6G~>T$%q|ng1`K?SH2j;)JoNh3JQ2CWC5GTZ)2hu$$=#4WL)_A=Z1e
zP$f4z^z{UtJBUUFVgW3M9t^j-FofE6biES~2pM_!`pRKvuJ24WHyQeFqac3g;f6sC
zp@!Z!sj2Suk*@4C7-Ky*G6-P)4;i<~Ybi-utiVQi0{D}@<~5hr8gauNxcltgund^`
zI565tYIFWA@Ry^Qb0-ecp`;i#;}8@C^mIG#5d$P_Fr+bVl^3^O^%c@fK<3B7SJEW(
z9`lK)=yH$5Zd|{9y&DS8q7;)hEf{D}FfgI1YkWNR+Bp=f!YoW;EQF#InOVDOlNS*>
zLCdzoSbn#VR;}ay8u}BDmG*KQdO&SbASD>cgm;fcCKprNXw%)2T^IsR!V_m^1sBy(
zGEYF8cvOkok+kf?`AbiK01t9aP~g78KOlt&pFF*IOg?NsR0X$|+{eXutYB!-<gtXD
zHoBrS!^${#_%I6aQP7oz#MV2~nioL-@&G;?%~n^;W*{p>$}6jjR7aJfSxE=@lP9D<
z8-2e@zeZq>vA#h%Rqs`7x#qba6b!^j#cL{%r^(b$Xgde7)1F{b3f-8*gP|ax)1f=a
z^$X?sKHlmIp;*$)jG3iq*m|gR?=b4HYgySC6Vu1Xw+FA9GyQvg&<e77;C<a;oesx%
zxD5FG1L(K?GIemMF&lybf3wTVa{(x)#vG3@F<BcQB9EiD<r>c&Y-7AuAsQtKBlhs|
zV^wu_bR*9dOOuW!H1m^#NM`Q9T&{RSkg%*|iU-C}9A#l)0SR^pV`(88Jzs95Hi~wD
zTD#5uVB?e<KcL>V_9rY?Mh3j#ogL`6Ad>_N(8AP#T99;0K@@Vs-e1NiD=~lwc!a@j
z_`bD2`b0^KqC_A^1o&S}0g=Om%tPQ!w_(Z&&WJlq*O$@Se7rga0=Bi?dl45ej5RC3
zG~B~PekAt>QxEhp8wN8T)ZeP3AZHFC>({AG`X!Ab!JgCDQ`4R}2SY9+=5Tmng;2J8
zz<^K$5&aNmFW;~~XkR-jE<E{tukDnS$<-u%ou*r`K3u%0^?SIbQ~Qx%NO#moGX^-7
z!&^hfTan4IXm7`agWv*_`n1Itlh^OQ>|D2TqX$kgaWpWY+YwVanb0Pcg?V12kGrug
z*)y|^?di`x8G6f-HMa$Z=H{n*Dny9Yhsf;HZ?^2(b%c-~!|zwWeBRtG@P^kCV<ohp
zw{>bmC}lOK-m;YpV6m=4E91t26<cdcLih&HmR>3={6aUc8qf^>>U&u#v5ZE8-93v4
zLMH9do3#&x{_NA!a2&L=|JA)f4<p@D^ZG=uf~dH-JJz%aRsR97Ey77A?Gx@F)$9e9
zQAxjHDT)Wh8R8*(^uU3jujU}HV@97d2sX8jAP_~swV>dEFXnLi(WH`jn3~$RZqd{&
zVEVK)Cpz?ge1IC$nIC$^=Z1MYNRLi)GTCKp6wN2Ey~{Au8a%P;05>j)gx?vNM$_Ws
z<b4W8GAHZxgawkxydcOHG<6m*@qk0hIOhwi>1zf@*vY}ag+9|?#Q2@p6byR07!n*D
zhNIxaASETGgu{9iQ4$jXUe{o5mlDnai)p$TOQP+R;Z7PF#cTSPX3kiT2Fr?t!%bM-
zn-yo-RGaSjEE1*!pFknRL;MYxtuZnfD@|(-UTj4uM62qdCdK{P?(yqobS1nln=m0w
zi#No>hIsM09Q*fKifWfl6!?#Qt}EkpTqG(2BvZv?Ukrvs*Gcb>-vf0bWbnc9&MTPn
zYhC)B_T+`9PkOPZ(<29joOaYYg?757yL{sB3O?0oEHirsBQ)$9z}V^}s-r2@x-=7N
z_NJi~BGEC{vnO04H5ty#)c251{rCa!NW{_UAuA?)=@QMIu7bWJ>ZM1>kj$fb=;OJg
za%p)Kn*7H$xGc_f39h2YKvj1#5=M-LOlAxdbw3=A`8JWbz~N*s{lWIIgvdiACF4Ky
zk}z@ldK2`T^eP-ad3ZVHL6TRIkx5H`>gnR*lIs6yIctc=S)1`NGJXltT_SEenHuOd
zEo_8q3Lm#D8G)196(9$$NrwDKM(scelMz#Qyjg?xH0K4?L|yHsQs`fm<eea4%i{nn
zjkSSfimd@dyX%hk;wmfrPZ*UH$y_$juaTGs;ckPuL<+L9ZV>wRrh;tSb*CBpr<twZ
z{r6A8Fh=4{4H<Yqo@_m6VNi(jgyfx$1HV|QYpXiLJSZG}aO~U9c{$mR%x+CIbGr7O
z(VG)v@x+83%#@ARaG2JfsMm`LfBW|BwtVICh2+G|wq0RQ!Z4u0H<=98jD%|<4C6t<
z;U0{@-Fh>dh3U+G0*-XMElsqCCJNNYKJP3`H(o@ep{(48D>5MC6tJGMF`1KZ#NZMZ
zQ{QYpurK?)<FU~-^438LGA?`9#j0_7_wygwx7+<-SMdA%&@lTs*oco}u`xlpYMukl
zSz{?!=+0pQ<MEl^=$bVz2Zx9f&G!wuh<GDfP>Jn40xaRGZ($y`D_AZ4rO1>}g=fVW
zl^Xwir847<1*HO5IbVB2b0)56TzqhPi8J93L0}T`f(35}w)cKM1{zmlF>%xgZQQ$|
z7}xQQ=EWEE{Ph_Pm;r{PNTx0dQ*H-Xf6I`BeoxLp-dXraIb+6Pl~Cc!x?M&;=3ERw
zp~AO-Np-I&$>?Fr;9J}<jEfwO2{9@Oq${kXZ->JvS=lpNXlOpb*5)ZIyhfgQo^TGJ
zo$jQiy)%+>aM{E6fA-9C$2A_aIRt<Ryogho=D}r(Cib<wB8Ve~8XCXlwlls%a=YcQ
zfG!J*-Z>MkhCI*AnuC_5Yn1p9ju`|U8hVc$T)mO@+JaUq7=3D&=AZV5TGObCcg`jR
z&-XuT>o4HxdEO>hDL~Jm^~72YCn(`gGP<lnDkoxdcjxE*?2F{pU^tVOy<)|R5*L3y
z>+)V6+v4NNuX7nKS1S*m4J2c0BX)Shldrv-Iu^2yr>q#PW#2OTG4hNfdkb1^Z@3yD
zJDwl2LHyxjFI)UF2}>SZ{5&K+EICnKJGC*TCcth~G}552CdNpki?}z^UP6JH)|3_m
z=f2zpvxj~*IAE-iB4y3Wm0?({5c$tBO6`uz7Vv6U4SW|%itvAAp!O@y?aO_{1x|Fo
zkpC25+=!$&LeKh6xl<neG_URD$}KNT_litOi7Lq6>-auW_J*_gN3DM2V$yg^0bM5i
zUEi0UH`0Is=J5%n#|T(2dCeEja16E<HTAiscRq*=uv}R9xN5{2S_22xio1V0`>KBN
z?|qFTjL|sViBjVAWzlC!U;4S1o)HipxQRX|vsyCXlg5e_Q!?jt>gF`3EUKHOY@=fa
ztw<UxT@?KZoAjrGNz7K05ldyyG3}bZNJig=B&Iw~cV`LtzUXiHz5y@^ZA{j#23ZR;
zdYBozbE_-Vav$%mc}w)DqDMcxU=qomSU3y*kM_<r8tQeA<J393y*XWULbY9XqY~{%
zYP*H@$z_{DWJC!YMJY9;av9TQ)tXXTA$zM(x(H>W2ocq0gmj%GqJ?HkAtskGG3Wck
z+Gn4&&YQE&oAY9O(;H%*|MP#I@9+72zTXFgcW2e(Yt?mi1;t;Gmn4!mBeF;sj##I5
z^c@%sHIu_I4HoivAh91n^Ia==R9l+}_ZW{iBjR9VNvFCRHgPn~++_w1ScfRE9ee0#
z3|g@hIuz2fgRtvuFPj@zcjk*%E|=L_+amyu7miJ7XFyyfg4AH?wy|l)FebtCkjyPL
zdW7}Zkhn8AqMM#%yt&C%7yLe~F;af_Ar9yv27^*Iu$bf*JGr#&5m|-K-}7;8uowHR
zrkU=>h-e%`2Q=hu!e_9)%EpYO?5K8;NNq58YM`dNJ)fTwNyFL&#Ej=<?NbkDXMn7v
zpsO`g@{Pj2r@!&rS-!C)J~tg49hVv6g-Ye|(6v?f@b<vUPI()o>L9I`81ms<=JB9z
zS}N{59>O}MG5fY<?}>~;lkkWW$*V6<sKKO#^aO(h2c)YX7rlmD|3tt19UG8XTul)O
z&|P$u!zi_QUq4tQ#l)@wTXbtz&+Vf+VM`HG0nS*9>}hWBal#t8eWXtS2bLrC1&|wB
zAJSBjI}q8PBYjgBd~}(Vd&C%0cg=>4k7hY{uMPgFN$Y6#iANMaOu=AeNCO|{rzHSK
z4FL|!9o>dtZy!NheA)&6RE^gy2;#-9B-HdlFQiBJ4Wn4wL_wiMF|9oG02)JjXcY2(
z+OM9BMv>ad4~BWn_yNE9OP4+`xe6YW!Kk>iPvUOJ4QbN6>k>oS8b0?b@GhH>OF;&1
z@+^<%{LV8sf3=BYVZLMe!$v`x;E7pr%y8ru1aQ-BBq;voBEKBSfIi%DC((m{K&2S|
zt~!l8USU^L-q^=}AIuyXcEx=VE4PPR1}-mkzQzt%-JhC}V`W8db-CjM*^DGC7=J^)
zr_FDz&xGb$>VcuVxW9l<w6V$l#Ju>KK3~&*XJ4})p(bnPrEp+NxZ={i)lo*Qvn9?u
zHv(%;=WK~qNr1p-FvyO@Z7MUh<*@FmqFUSpbcgbk%)&&+D9n}~4Rn+!d_2sA?I6dx
z;w<U!5wj~bj>p9%QTvyA*7(5$Fk>}fD@OynaP0<B?1Tt{8#*T}yf*%9=|h@4wp(d6
z{#-RQ6Cj-|;vS(Xs6*u<dHJZ}Z5h>{NSQH^GZppkb}cukYsU(roR97)B9&yP`rE!z
z*k^$v=`QFE+xDSSWuiPJy~tESTpJqpaNu5Fp%Cx0cW<HegPF8j^W+}+CFmt^g!=s#
z1`oZJe_e*reAwAEuRCEYg*L;iBvH1|q(lJfr!g4#UlIs=&ga^Tk7q>41|_Cpaho@9
zt_Hrp2@|dtKI#p0M+*gTqdcntCUOaMd)@4Unz}_%eEY7`Q&aC;rj!J~?+c#xo$dK-
zm0#)Uza-SDxNVSv8+wsez(mzVx3h@&Q(?<I@z<`R1?gfod%pd^0D18l^#jfTcTvO6
z>S$r{)0i^$M1^uq)RhN;cm|JD$+6CX7+xq6^oBg0HEo)2jM3JIsFZ65_Ibe879quK
z!vK|iR3G4nlS>38oD@h^Z4KV#S~*+*j@g~Cuf{fA&feZ!;%Sp3SAGu~Wcd$Mf_uwU
zKnh<GhI>gfO@AMRCH8?2PtQZ(dlD8ePfj#YqF$_iN2~hy+2#_jUBaSq)%2`Bv4kIm
zaC!BJwvP07k#&0`)7JZU|Egi8`<fk1NEJe;R8M~J(b0g>mFE$|S!464t#vh|5XgYo
zs=iNp-G@KDm~rO_S8H8qjDDwJGWh<ULFYLg9w11dgu%|OX*UN$!y@Autmx=mvU2?@
z4p{fRYr6pLZ3t0hWMo8_v#2#9u(5!kP-qc4AQ;=IUSfP$Xqwu}2-5(}0FhP<0jRVb
zJ3~gID}}MZUg&u<#W*ldn6|%8ZrlLibpb-MBTz{l^%CQ;GxaVZntoxd7$mA0ekII<
zYalRhy&3`G>E048Ii3Y-EW&dnP0=tU8ohS>0OcT0sQLDXZ9ySi@>|}FLJnK)s4c3s
zhZG$6DTz7y(KkFYE?U_f9m(8|M{q%wagj76J_D+LPfpXuHp3j|tFgVE(|Sa=wow~O
zN4OjM4+C;4KECz2w5_TzcH!8B%!zE4%38o|DuE62$iRdUNw#4A92RuHvzo3V#H$--
ztz&m=L4VJ^u&1xXGXGsg)%oDFufaegp9r#`UK>YFPAMPaynSBx43$3_?i7myo2{{+
z-`cx<K7(=)M8OnlP|?<ZC+6wfXu1O6imMl5YLiZ>`%=ULHsv#;d?O-OmssZ{jwW?t
z)?F`7fhRk;<s~+)(F+R@Rks0kq&*d%DcHVH>>xObiXB@S3fE*AEjgnA7&bLGyq`jN
z7tUe%CD{u<4Q!1wf@EMalN&)qxb=ZN#Yq&CV&(ukJG~WmDXg*~Xsp)oJ43I+b6Sve
zz+Wb^U?U2L=PeU;OLda~2YC-WH6{nakVnOqv|<ZFnJB>14g2$S6_96^k~TEIJMc=l
z!wTtg>-Fw4RB*EV{QUNF>M8E|&Z>@;7Y9w2#?^l7JjtVLHkZvBFHC|U!==Zmdmjl*
z98dU~8&DP&oIOH_iESYRfGW*7BQGtwaCDW4qmg`Q*=*VUF?q3&R2!~7K}^e59Ij>I
zEF}wr*a44|JHiM>J-A7sI;Y2C=+-?|#Uvfs^Pr+3Q;SF^^T_CJ-&_Z7@N?Hny-P?X
zc=NfaYqDaJasNQsNS~o(CSe5O2os=u(<`VcvqAgV<MiOP_ANEv2HB9qFOnnlXqoJY
zXodCeBm1&UqxwI(fT>%sdjn?E;<DTuBIu1Qu6)F{AkE1CaP@-+dU?YDVOW@ai(Zk@
zw_Nv-62_^;4KlAndGVgo6{;%Be!lk?q{n)<&onkRUR3$!*uKpOo>JpLmOlM5h`^(x
zO=9d(1mGCU<xnD5`+Z!s=artv83ED`i~PULW3go|KWX>Zx~R|<GwwK2GRRADWzt%A
z=<wm<fRUM+x3DRE5;eTaP}3;VDhjqTl|_iVxiBs0BayOWcUWlXb8Iu3v&(e23%yi*
z%|fTl)LW+=7<e`zPD6Xcgzr^c@ER}P!S^YPacY^=Jl)r<xXjiDq9MDg01z=<Xv5U|
zpqNz3Pupeo$BIH#)fczRWKk+CRAd&86g-B5it@4ZB@JPB$)-qI<hv6pLo^NLlhAxv
zwXFrTW*<nsOhjl<x-Jl|^ceZ@o@JD(?(F@RkHOAH$(Myigi2u;ekoQ~h?s~(_@1Qx
zy{SsqZF0D+TW~rl;^0o3bgaiYR$o5dpRnVlq<WU3BQkn~h>jw_iUt0kIH0c?w|94D
zQCV%^U2+BIWt0ak1ekIjS}Yy6VTEX|bdfW?U9}5J&gTX;znkt`6gl<;g0$_#LEbFD
zx0b`7pKZm2?tpCq<GTun3Jz3<Z-uG2BK3CNuhw<~OB@vAa+3V%Edh;DmZA00J4F(M
zCN9QNm~I<O?4%q1Bt*5wuP+L{)PYo+wUs-%Ta?y)<q>ywVnLEc+>Hz3i#h_q3x!~$
zJ7TrP8Q;2AkB<$Lno)A*l}RYhw*zXDh4+G3unxS}TXEj253R<56L0i+@i_l_U^kQA
z%SUihK7(>Mitw9xJTjE^0^N$(y~6vuIdgu5cWIk9-9?c|p5;SyFWZVO<@{-5$j6G{
z7u=P|$}gXSC-`^x6(vKMxds~8(-fG>gmk=Fii6!$E&6um9Ju!IFTVbeA^1g!PRQ|f
zvr>07(-x_={{s^9|I}R>{aF7!)$`{^pn>~y+(xI*e|#5Y+?tro*ei~6+vs~7Y@KX!
I{^5JzpZ_(qvj6}9

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/refs_validator.png b/latest/assets/images/social/reference/API/trestle/core/refs_validator.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f4043ff7e5605be77abde9e26dbec9dfc58e4fd
GIT binary patch
literal 30780
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
Zw|e)ImtiHobg9s+T^9Syh1=XB{sFb6*lhp+

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/remote/cache.png b/latest/assets/images/social/reference/API/trestle/core/remote/cache.png
new file mode 100644
index 0000000000000000000000000000000000000000..637c7e217bb4e4270fe710bf9253dba43dabbc6a
GIT binary patch
literal 28798
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
Vlvkep1Sw{-mwCWX@>S%Se*yR=Pv8Im

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/repository.png b/latest/assets/images/social/reference/API/trestle/core/repository.png
new file mode 100644
index 0000000000000000000000000000000000000000..ce368e8d252262fdc869bde55340304570ad743b
GIT binary patch
literal 29911
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/resolver/merge.png b/latest/assets/images/social/reference/API/trestle/core/resolver/merge.png
new file mode 100644
index 0000000000000000000000000000000000000000..7c3e5e7d6a9ac6e4309761ba16120d5b5f33a03a
GIT binary patch
literal 29777
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
YuFL0oOWePv7gNK<+0ChFga1GN2bEut8vp<R

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/resolver/modify.png b/latest/assets/images/social/reference/API/trestle/core/resolver/modify.png
new file mode 100644
index 0000000000000000000000000000000000000000..c962ee3d3a5aaae96cb875a7973635b576c4c8e7
GIT binary patch
literal 29719
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/resolver/prune.png b/latest/assets/images/social/reference/API/trestle/core/resolver/prune.png
new file mode 100644
index 0000000000000000000000000000000000000000..5eb23b2e0389955db2e656dec12ce89ca022e8c3
GIT binary patch
literal 29594
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/rule_parameters_validator.png b/latest/assets/images/social/reference/API/trestle/core/rule_parameters_validator.png
new file mode 100644
index 0000000000000000000000000000000000000000..82138a18836ed955c1f79a8f481a31d1a15334dc
GIT binary patch
literal 31235
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/ssp_io.png b/latest/assets/images/social/reference/API/trestle/core/ssp_io.png
new file mode 100644
index 0000000000000000000000000000000000000000..3f541d1e3338ec0176fa79a2c6b24b004703f82b
GIT binary patch
literal 29259
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
GI`AK?IBm)R

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/trestle_base_model.png b/latest/assets/images/social/reference/API/trestle/core/trestle_base_model.png
new file mode 100644
index 0000000000000000000000000000000000000000..51d9002e48bdd7fe47a9cf14ce48c43a3768ced1
GIT binary patch
literal 28396
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
buCHzgYne9FHE!HPC*tcB;3<DS=KVha1lu?S

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/validator.png b/latest/assets/images/social/reference/API/trestle/core/validator.png
new file mode 100644
index 0000000000000000000000000000000000000000..c1d048f7429995305a7ee1d2bfedd6aa090f7217
GIT binary patch
literal 31669
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
LGbVe-p^$$ANWu|s

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/core/validator_factory.png b/latest/assets/images/social/reference/API/trestle/core/validator_factory.png
new file mode 100644
index 0000000000000000000000000000000000000000..23a6c51de576ee17d596af42535937d133118a7d
GIT binary patch
literal 32337
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/oscal/assessment_plan.png b/latest/assets/images/social/reference/API/trestle/oscal/assessment_plan.png
new file mode 100644
index 0000000000000000000000000000000000000000..d7ceb24b1938c98da082c8a7867d25183b6ec8b9
GIT binary patch
literal 29684
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
CS1(ln

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/oscal/assessment_results.png b/latest/assets/images/social/reference/API/trestle/oscal/assessment_results.png
new file mode 100644
index 0000000000000000000000000000000000000000..29aa602126bb96301684c28dc7a760ed2308c06a
GIT binary patch
literal 29424
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
P_3wZCr@i1~--Q1GBT5##

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/oscal/catalog.png b/latest/assets/images/social/reference/API/trestle/oscal/catalog.png
new file mode 100644
index 0000000000000000000000000000000000000000..59e202b44e1c33936dbe94a5cf56187ae5e774c9
GIT binary patch
literal 30593
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/oscal/common.png b/latest/assets/images/social/reference/API/trestle/oscal/common.png
new file mode 100644
index 0000000000000000000000000000000000000000..bb9f09ef0f2ba87f6559545e884697843fae56c3
GIT binary patch
literal 29724
zcmeFaby$|$_BD*1fQ=xbC@QU>AW{}0pdj6#5-Ji3(&gSNwn&SVsDN~Lx>1QoK<P%L
zySu)z&~tw8`+k3a?;qc__jUF;2JqbXT5HZZ<``qH^W?IuB=tsyjZ{=r)KVADDNs?Z
zj-#SlX|;YW{zUGSy%rUfMVr*Q(@Hk}15MU8JCx^^MubJTTv#u$_kv_ku%O$)jTa<W
z$lp|ndi?aMHp}Tak;AS#<#$|We_Fm{%js9U@KswLU!djA_8FVY*PWE9y_CS;P-@y7
z+m{h5W8L*lh~M5YVeabnYPoZs_(by0o6)K9-@l@|_iM|Q70bUqb!)ZS??3#`uwvKm
zUnQNtx90b+qPPD0Wmt)S7i9T3{9ipGe+4rCK7+$F`}XbIwqwVE6)RS-vby{D91;=|
za`*D;Xm$Hk^PltSH$OlB!K5LjJYG-oW<}_WV@8!1-o1PG!C__;-{bDi8YUOyo&Shd
z#@IN@xFO}zH9b8EcKn3=n&~I&6G@a(QK_9ff4=zVr~4g&_JeMnC4MpwH}32=@_GIG
zu>I7aS6$+DN`e99z`lK-l2=KDe-e#*8}Rz|Zh7gQ5ufg_YtRzl;<~7jYRYZdS8X}8
zcf}z-zAh4Bs(Vh}{TQX5c;2uqkXt+BZoF{Twyoipga5ueP_LXb+sirA;iKC=*<fbf
zbV@#A%N6=9^z`hsqT{c)v@?`mvWWBCym`~z*O&czS)do*uV}odB1ALQG?3Xa{70A^
zi_o245BeL^6@UHurT^vW&TWj0{XJJ_k`@={G}myytj-+D>FX(3iRakM>cy$*?aP0?
z_@9THLN56U(8R{#=Ox_u!8+6KA@@NcL|S(DK571yT*9kYuP*!`<<UMp(l%OjD5x;+
zuT>#d1N90i#_Ah3Y;ZHGijbO{9O%Gbc~11zkQG&=vDz^-RwnNAbSJ0AVy<qk(`eo*
zTASPF$g=(n=&gz6eMZOYy^h7<^87*o-OlN`Im%gD(E}~cOWBpNx-B>RBzn%?Q~uk$
zqqwNID$=00GJG2|v#F||fJuE}b+l$jv;C0eNVjzC_wSdVJbjvA=f9ox?&TOQA-@)Z
zP1MvA<KM{#ajt1qu8Gmsu9ln{Y%&=6^~J&P{>{~DU)HZ*|0+brN4hLflsc7q<3@M&
zM8i8Qd+3V3ee)b>NYxZwoEyruzjEyN!*ZxZ9oBW42}!!~<DU-4<QqTEVCS^Er5W;c
za3t@Q9=!DCfMC;IkE%8-#^^w5OYvY+CYz|Jc7$pyk6?>K;`m^bCQc(4Wd?8g&6nR`
zVRpj(_3Q4hZay^D&9-3<^CJc3Z7&3+&z$*te#m*rgH6WU#!gL)`{2Rzrs*BttU=Dx
zt&ciV8caFI)v&lCOY>tADKlL`&i(>o<QXT&#>PCt6~m-`c(fa<uj7>siaps!3-`M|
zRwy=E_($+?aYlqnbcBMUVpY|(Yu74|*J$Y_UK(o7RyH&YRragVb#7{FXuGs?`*yu#
z+I6(d{Udke*=n!|W)t<%8p*|NZRXZEEu}`{heMQZ-1u11;XAfNLLUF|Jk*P$s%mR%
zE6|dep<rqn!@#HixF9uXH0IZ~e^^C^^Hy!!wM(Tt-qUjj{jnRb{KcJ{4gIPjRVhg~
zE25ZLgv>w4d|gjo;vW6hty@QbJ>xw&;W99}5nDv3>+oZ6?&2!e##NCQ$U;@=B^s8v
zPft%@YjB*XQdM!q&ymCNP}TRlcaMr*%pr|SEA8@2CgFoUJv}5w!ej&7l_OP(K0n#c
z#>baXIGJL)d!fNBS3S_a)AzdmSZ9fO>pyGAwzn0yQm_o%OegOiP72gWHY)Nn%V8&B
z{`vE{qQb&gX=x`AD=(9b>&gdnRHM}Pv9hjON8`!jJTG7BFSK7>UEO?f-nK63riaMF
zc!f&qTl%9%kE%G*S(n9!Uh*rBjLqTDOfh!zI3y>nqT+qv&>>1|{v(6tEZg!}-P~((
z%`X^^C-j<q`g;v4t3sxgiS67#ssT=|`>R)b$<OYsWLHnR;nt*EK)q>`ha`)mk_w&y
z2f_72SeT5FQN-sjUy2aO9WR9kUtuvar{sdf9QE;Nqj)VT4UISY`uc@Wwja`;8SUUR
zZ9EZedf4<9vq@co#JR-<`3E?1g%3B;9XNVa-tgON`F1=1_>xbbKACp~SQk&VIP>1Q
zbI1M78zbLbKS48Z?1kjJ_wP+onsS|U4~HCJWBbxMMo&-gJ<wMX=E`IrYSTQ<u!@T6
z6z^G=&2B2u8n#hOByiuJzAsWOp5;-HyEar4`%=<b!<cC`V5B<t;KAz1l>2L`6Vi>b
z#g#$Mi|W5rxjZ~Ps*rO`V)Cmyq%*CDRG5UVl(459<^jm~y`R>xD6zg9%$YOwa(7o~
zPrxBGYD~LhHR0I(eP8n3p7Lv{h>=BkoZy6X(McUygCTP-4rK*h#|f|EvNB$)i_+}L
zmVGM9u{xrDZAO(J-Ks`!RY%F=ETr1@bbBG|r(f&(_C5HlvV()elQ!YoKkq$#`I5&<
zTV7t?sO{?uwwOMgtO!Y0W?50IZ#rjg++t=rar@N7P)mzZ%i?sKD^EiwPGdyw;%wyS
ziNhh4*ox?X^7A((w_xG4O}rE$uuCpo2{f@sm!oM%$HLCtyFUsT*It>jS5;Ndb;?E{
z3{Nk<%?cF}qZ&X)(Gj4Hi4>38rHtL-ICd=Qa^1<p>o)IxTV7tindv7MFG0gKns%wE
zsE9*IDE;$<!S(BrbUHSlV)_CtEG(4!s-tE48+7P+b(E+Xj>Xk8Utg<6*2I3Y|LC!p
z?T2JPBAzrSu5;!UmzJj73YeLhky!iIRdn*TcB{r;A3hwYdMB~Tug|C{Bl)EDpnp?e
zadEK%@|i__eA_oF&Z9?v819~5m}<$?_Y<}rG@iC;Ot%Qb$&WH%8eAVIvcRDDJ8v}W
zqShq$jlGLxV`Ecy{QBYJyQebiO+G4yy{yuE^5luTzrV5STz|hYf|E-LJNwW(TshMF
zo1dUuu{Zav8^$=4xgvA@iEKQoIS#h$x;YL{C~MZNDe`1j?9Uh!+PnAEL0SJBH75q-
z!xh*_LGw=$(=;r3V=!hOn|QsfI7U0uI4AV@t!mHI7N>@oiFIq%)Ft}|1qGGVM9cW_
zjG_e4%}x}%KX~+r^7ooe2ad!IyFPY#_^{}m#Ip~mcvi8TCr+q!mIiPhH>!-we35zX
z+_?+D2T{yrB_+x8sfj7%8SwYFEJY3?+EEDgQGrM_sz*lx6O7j1idA29#)c$V4QP<9
zF3EA88xT~_w2F?>&Q#&i$+|K1dee0Mt<A`eW!;tG9@;^4+T0={S|=@g+k39&J+l#!
zsE8)7>9u(Y#a4DeZ=$zK#qmQ(NH}t*yo97=WM53CY?Eb;c5k8EegU6I`S&gc+7gbN
zIQaP$vnT6sMWF6S*p77?jd%a}qN8xaqVu9<KDFRS)U=PmXCKvPd2;OA7yR97N0s&Y
z^DcG+$u&x-^vd}z)Kzg;^DFTs#ykyJ$}@d;s|DjwrS-=AE|IMn9UD_*U2@VKe8!s-
zr*V*zQ^t!|H|Mf*O3q)(anZ3^qfd<h%8aU`d>M{jdvMZWI<BPS@4x@v7(M1Hz8I&$
z!^5-u*b%4iuZ_?vcxf~{-oqg%SYwoqtVyR)1K@Ba`68;#8xh+C#H0$|Lm6L}EVK^k
ztJTwX;G5YM?dYGHf44Y{y{Je{M<!P(8*0hbl{kN1!+Qizrx<!MUSsgrmuKEHO68L$
zW;q|6%=-GLs9F2qAiP1kFPVxA90nfK$PNnq$XeXC>U)fi!-z!W{od{$?`1We@7_%+
zS(S>YRH3MZD@X*Kxbu%uU5$=?Ny0^W7H<<rs=<cT*b;*lr#X{I1E4e$i@IB}*(slM
zu!^@VG?AY5lKZPzq5^haq243#t#_ujRxNVE6Q#DZ=6Y;Sdzs2TFCU*U(~O>jk(L6c
zjkSh0)gR^eQ}_sQv=b8&Qm=|quZR&6x?aji8QaOJqJ%W8Lb>?*$R{Ih95Q7TLX`y_
zrWoMGb!tG4M!!Bk0Tj?EZfVh7vu>RxPlsiv08rP0N}sQQ$(t&>GiT3M^;CparCW4u
zRPHGD8mMQMT*;-aqxbaPVf?2!lk>oV&z*B}a&-v?&o*w@Ff#2FJkHCrZ=6aq*K>-(
zn_I}6JAZ9r8pT9^w7p2hm6o3G!)GUaq`^e(Q0|hcMcvZEkh6;G!bkxNDJc^+fT=S5
z_Dva<Dz4gTw@-)41({CR6ue}T(F&q(ahwX6o|)Mhkz&%I!R>>u9~+J1P>%4dl>}NU
zF<HR5@93{fRB=^}P%0X2No_QLRy9U8-CxAEy!Vc#kA}_+#XGgxF0zWZlu6vFv9oU$
z2b5ACBC|<U1*yYzaix^J3oQ%JP|jS8|A{+iaCF&(g&WN4!uV5#kkBGZw5^*ACi?t*
zeSH<)pQjGTy9D!D2)&ihnI%;&FB=E<00&2LMSdJw^Mtu-uES01<Ba2W)~{Z-PS|82
z<%}o5)2{S+bPG|;w;I#pt3+S*yS;hCfy%Dps%xto%!&Oh>W$|!DBeAodN2BNG+LI>
znl7#s9ScdhcXT{jad!R1jy0i|_C$828rNO3(Dvcg^>(4&BaJe|jSO^{G6v+DYBYu&
zxZvcJQ!)W0Q`j57i(8{stJ<SFMq9JpqO`Fy`BsgzhK5FP7ebF6wbwmB*t*z$DEkm<
z`t{)N-<upJj)Rc6XTN6k>Kk{KB3HJywr<<9<tNh3rrmO<q*rLRd_Alh<6lv2)@N8O
z`I3>{e8!@ylmLte4<D*CZvvWrbNp5@j?_TXojOV(bwRA*t*on8uabrhRr}@UNHygM
zCAS9C%u9BY{p^?C9CJg-kpV0beKX!L>rw-l^;E05I`#9$$_QmjZ#-!dm>q^sXBJp=
zq~>S+g<aXV@AOw!7G7P4k%v`$(VD5=XbChImk^VDX3ZiqKkw6$uIzJR3HyuKqXb;;
z__;?-;B!HNrsytu`ktgMeZ7=>=Zu|KbxR{&tfD2Yv9|&&)`q8S*qoi6ZIS1eo1LDp
zpkm~?57-Tb_-hib&X*>NPbJ)oHY@Pe_L0ZZ(8T5k_-B`(pm-xO`Pc|u0f=dzsL}Ny
zfD(NY6Z8FS>9*w*-bJBMJOG2`X!BVSxTB+^BBGmZR;=XOgWl6b%ycNkbR7-jD|{ne
z1i)wAsDpxnyRx7AKZi9}$bHJb=l{vgOqpI@>9XZShh{0C^`Mq5KyZk0U4lSRS!t<v
zR1}xIboz&-U$wLEw{F{Z%}5);|B^;>ej&T>?$4(ti-Va%A7leg@;S}hpu)1_^WB{D
z-?BJOf9lNsrWJfF=POp~c8<Tl|Fzip+o}B5OVh@U7^i7?_9e9<PnwT+%isL|_H=N8
zS@wiVU5bfjyvd$pH}+x&<L&0rhI%iFIWJ~ajUn%Fn+G5ZMl0uqcqZ67b2L?<r|XSR
zN;+0lT54sd3&7xkPBino9`MCzsqj!C$|5%~ruXG5_`C9GO~EkN;1el1J&M_OmWq7|
z$HTD0hXBsv?U|59k5{FJr5X8El$W>PrxkleD>i+KL+RsQ!N%M70sACor-pb--W=yl
zGCp<cUe>~7gK4^u-A#uVXup3t)Ya9QPY+-1`5t^f>=7&LQgde2&Y*Rz_Uq%G9&uiD
zutod5Np$l2S=u5zp=N)F6DccpTw-E5-xr=C3mwD`b0l4C$#LwckP}Z%FV)GmQx{FK
z9%^RgEvQgOPZ`bJ0C*=eODbEH9!V<~-yADqTcA(2=#uTJiPa4*IC-~wudee#a#h0V
z)2ByqUg$E?TjTW#+S9uN6Qlb6TE~32G88+@XHtKR?zt8%BKQ0YhMluZ-@aWGa+*&&
zaPVMpnfMZy_|kkLX$Q><n5+xYYbthI-l$6m0T!v9Hw@wT`dYIads-Ui=?>^zi1-i{
z-LZ9MYU5!!t*xtu@+S^RycV(ut>PV1j@D4##iOOx&MPoJ(4ZP<+esf;fV`vD{YFPK
z_e5>3vvW^#c4k%EpC(O1RHrd^*PGUUnf0+*`U$7boqHex#H-?JR-aT9?nw6=$N>T-
z*?lW3lf&-(bU(VIpjz<ydE^XW|71IdpLu`rIZWS9#|Ci&PMoETk=Lo}FvYVbt=39;
z@Zdq=Cf=-{33IOLZxHnY0xFC1V{$S`bY-2Q<#^n~=v9;K=6h?RK8okPY&@6!=M29<
zPB=N?easNxQtINx=V6al@V-0TaNMAHhXDnRawVG2%8&BzD~DV2s~&9FUWv7gLf((|
zz9cKFf`&3xV=BY4FUtFpl$3m#*j$uR`G+SFz@`~^)~df&t&8%eeEX(^Ho)7G^u?Vg
z&YnGMVycR6x++06W~lfi_NXcW@4*#6^!)keiDJ&!k4VKI(O8CSnq?~w)F)Fq6H5F9
zc`L8u`KtKtucJ+2(3GM?Yo(VjqX6YxCr1h&S{DVN(PW{Rt^3dK=#7<se_n;6m1PrO
zIFo2UWg6LGmNV0Nh5`bCMTNpB=AcH+bW*7*Tv3u>zw1GcDj^>}sBuprA@0(s@fWf%
zHZ4GTe&@28{+h39z)4F5kAs&IvQqX47+*G^cv}`99Ru#woX7>h-PS-KkYC!|i4LmH
zh$+Z%(pPzjl$euF35kiyYHF{mYVnKc>h#;KXR4BKsV?KjwbTr|1IPXcNKL6;x$?F?
z?&|%LDeu7~rv<y6s3ju{r)@9UI#AWCT)zCOK3?z9*>&wWnkF%sK%yL?qD_@24_$hr
zbVK{(TD8g9)<-N+vv*bQ9l!JIGwWRT-5z&o85vG1<Ecgqx!^^utye6EnzcJRJ9i1w
zXrkFNoS0RK)zQYg6%S{4D)b_;DF5}>Uo<TIgEVpe$tBvER>}0Ig2bJ5xOH>1umf@n
zcx4V=-ZCR!v)qO1&RXM#9;$XdAwHYSY?=NGdjyTXy*?V+ta`En$3`TF<?s+Y&pxj6
zva&D7d#fmwstjYJqx$pHBP1>Rl?^qd%6)xKuQzRIiQ?!5^g$W6k^U8<yDzI8;Ho3O
zfZ3vMR(z&?yO7=Z$C55kOo+VgyN=kOwcKAFtII1VzK|4rD`)$*ZTfllR;Wy!61Ja=
z8t<!-D-967Zo_!1CMG#Uzk1J!TYi9U)_y*z1bvdUw_oz5Cy#c9+QQQolwj`d2QS8@
zFJf8gnH8n})S()+1pOx^no((lr~|23ske|nx8;i0UQ|_5k#VF#n*=YlWZS1U+O)kG
zMVq}Nv(dW6@sOzfq$l}+v{Gbp-(xr3pVRYy<utuLHA>;tY>MrYc3zn9X}nu;iDzM^
z8eh^=ml)PxpB!1+VKvmuO<-R%vl%+aNEekte5?NF$6E!Q4F-+Clo0-_K8x1labcjS
z{RiZS1cw>(%vmwS(dIn@7ei$OjBb28d8b;ydHjc@Imi)8k;kC{jk3`WN{C{ZtVE6}
z>R9mnY+tNZH05#m^fEA;0ne)sChXy0O+OEMNIu(9eeS{hHABBfV*j$0k&uuGA89Ly
zL<Ex_BOJBa%hxx&G*C2>kYuQ6%BiMJn_~sh$i3Ko^o%1u)_cOxz#zOLOfC{gDxxdU
zURK+p<hVqN^;fnBq!CPys*_odWS~s(=B`4(Rf2L+0^yTkGxDxJ?aq4!ai=VxW_ELX
zf6EP5PorZEKdSfjBYA}BX&WyOkM}&fIZ+@0-ZI;D@7uX!#|KczCdo0Cm6d0v1kAs%
zJy2Ca?Af)uNminzT>kNPb{W!0TaRd%6f8Qw$)kWOE-o%wl|_1UYet~E)kLd(=}SRD
zB-&}qnNb7F;h(3E<D4Ehu8rHq`-5L&Fz3Pdoef%`bB~+1UjW0&YKaQz_4@TkM0nMg
zXLQQQQFcSwQ%XRL{S0!5X}kXTf=W>0%Ga*FD=sRMN2$0Ba#q1{Zt}Q@kEP8E_TT+N
z3%j_u_ym~YS_j@iX%@$EH>BCI=}E<AWv8VjaVo`PFU~{k?CdJ8KJ1EL2hF0EMJSQ?
z*S<U*ZF3cu2AA1X-ZDGUN9a!v&_t=@>smgsJs_Zt%2R=$V4zpk$^N>w(HwHhrkbo-
zT6bRDmq$2ms<%6Yt@>X#I?W9vT+LtWGcf}4uLu+^53mML->RG!RGY|`-BXC!`+0V}
zLhjkZX`c5$X5b6N+|b=_)A_XTj~sRiVRe93d_InxM<6yPoff1U{qFC<glH}7p!ftF
zIpb;A_?d~O_23}+sXy%rC?PB%c|;Iq;2_ImtiTc{TrXqx6}3;{LJHcpeY>{sWlx6H
zYPZ+_*4uWJpkfyL@bWr2Ik^V~@k+B7m6iEqWr-94KsGjN$<fB2!<Kr{FrB=BHUEI3
zux;l~HdJOP8=jsA{tsotYOt}Vb*m58kt3H^u3UKlhk1Ts;R`+j|0BW9hQ)ukL;i{B
zdZ>~3=eFDM@NFS5U7ozUI(&S52hh5MH^!GqZQHi39Tej>78c&?rT%WnY(>E8?O?Rc
ze|_G-oge+`)s_t#H*RxYavr+ii3k6$ETjIXEszGw`N3|YS0P&CIB0wK2<1p=uulj0
z_!L-KSr0%kLHikU(U*@1G-&C)+S~QzXjxP@jQ`Oohn2A=+qQ1qhviOnxD|e4O=~rn
z`~#p1fIevJKsGT7TU{i5_1MPU)*z?K`Jy;<bF$7!NECqvIYgQT^lwrKk`SCRh2S%5
zHf-9IcuRCm%h$i1rq})!JbB1R5OP(!RrwB{r5#8<!K_8BF3UF2xG_y$Hb{&cFDJ_o
zZjBdqXE<(j0S7e%D^i|iYjG1`L2=RoH6E*0B(?ux;va4GCu`}(xEODLf3Aj9Gan?m
zB1Dh@r~vHpP^H-2?OV3&#dmq&q+I|xAA(v1)nl+yY<=9g#BT-m-m^50ybJ|%^MrW_
z015g<+tlN)JtV(|4%U^h*vO7;W)L*xT9}*ifea<{{`?DnW)1BpR5H4M4szOK;gwOG
zAt50}sCNgS?c#RFV#*+nHD@hT3JWjLAGvaGGmDs3hV_u?lxP&A#Jv#Sm0Zh*L+f+X
zifXTyj6$rS&OIca?J7do)6|?xk9~E=FDWRFA3)id4h8+MpLb|g)XJ{X0HSLY68!_b
zHuE0II{-s$XkR_>4N}QQRU!g3E4dv1=yyL^Pp(#5<L=?n0Tk|mu)FNHHxes03RaZ@
zMm7XGULZ5g3h%G~Ik#H_Rz|G^?a2o!WTs_l@epX)iNf76xr=tTz()pPxOlSJGv!yS
z&9eSZ4tWxHH^*&6l0GjsKYVtkKe4PGtbl1xBBU=uk=r82k<)70Q?VXTHe+wMya-fz
z3lI|9O9WdyK_3>r+ILo~xds2NkF7%kzk@rUv-`h!C5k+AlXXjxs;(m&8Y9cu*}kgC
zL&(!^XbfaEl5Vt)PrSdo_fNX=+yvbN1)(rDcaejXT2T3qYUp?GKKx$N)f*+J7(gi?
zLDo~}KUoRveM%)r)()b!ef)U1qAwgIpTpuz7g-2k-Irr)A1gfjo#&|3z@-$`#_M%}
z822`9%AhwznYUI?HxD7De9il_H~*Y7swl`^XHY;6%8AW<SiNSASDFLRn#e?@V#3`X
zg`3S;>3hyUE`RXn=hp6EX68Xv^ubr3W8J_1nN|#<iw|_-3<NDsbjqfT`=mGhIYyVG
z<_0t6cJb<PK`u<Si@^a%uo=0A-p5|#2%qP!KkxSToT%OSE09`+)PjvyY@-lf3D>@C
zBz;KNS{H?V-z&hrkbjzkkpjt2pitN2oN;2!Cx$;>X84b#ArpUaiF_O@D;TY@;TxAV
z{_|I7*T?)cZCtfn1*oVr_W#}os(aOcjuqA0<9{BS>c*c<{rAg$Cxidb7bNfD{K8E4
z0Jlx__|ER0-|m#3k)8_BP7h17gTvhpY%wx5<%1yEfVjy!CFX5^2BdI%M~9S-PGEai
z*E0oad_8KSG`k!vtpKF`Si+`LQStoj>N<qHM+drR12wf5N*6n5Ekfe!>wi!Jng&bC
zfd=nCr3#@10b*CH_kDA7^Y->45A)gan?gY4{=(L>L;)Nb86je#)P)PLAd^VR$atVv
zC(`2lyn~dK)V|N<TUPA4cjo-_-TTJ6$^<J7d&)!jY=*DYY+g?llP9#1>Sy1^f1*(i
zrLyfNJ|I<;gY65~&CNmSk|OMw=s9k5bA_bjg3KQ+U~w)4^WKhVHV3Ffo9hY4El0bR
zhP8CrtaEC6cz8G%Rt|y(vhAme-PvT$ojbtFdghIQ2?shKA2btaF10^^S^zuOUbn*j
z0vZ~BF-Hw2bQPr7^`nuYVHP=z7YJl#(E3lfm!PjMLUPat$|XU*ftJ>1a-cy5lH&(b
z1alnigK}5cVh{Rj<IjS(J{+kU>y38!0t#2yqcwtm;8`Ap2%#j`5s3^^iwx?4!SK&d
z<=`7`f+&Uaz{c*etec-7r}N@WSd?1)8E-CiRzO|WB#w|jF*<w=X+OcFK>(bT-^D-?
zb-VHIeXw@;tXQ>{NHQX#B8tE+MENA{21qTUQ*kT*c$;!qxw$V9EtOLx>J?E-uo!IQ
zn?bJH+1;=by4(GVOC#w5D)n+j8NdB@>z|C^@ZD{{WV@HDjvF)!wY9X&T%?*|S?ui8
z1W*iQ3`_mlvA|wf5?i|y-(Q)vv{IA9cTZsu8G97$qBI(ecJ!Y<O_|pAb{BRLMwWm@
zkPipJza7Xr;|5;p=$&8Z<fZ8&KttNv)ei6bcAET@QfOpcgaW<WSA7X|=+F<D@x|Fb
zUQ+Espm&Tyw~&^Wep>K#<<P0$=;0JQ`5qRB;lIfDpsC`(_M2<A;J@7odxVnDgFb3s
z?&0;Be+u#CjR7c-IyS9q;6%`D$Emw(>ny%F{eHZ^PLXIKBnBvR_s#x`xEqph`4Ei!
z^(7N0y3^E(8WuXbLwaAIyIsw9DMEYapX207^C!o9nv=c^l`4Iv)32j1HrE?C_fd^6
zHXN(wg|9BgQvJUx9?D<`SvM@wYn?LEQ<LA3%88CHK=72O#-9(!JHyUK1Yg2x5nVM6
z$gi)XTGPx+$f7gt%H6}!e@@XoFSNJB+R~9d)$9Qhbem6EQIQ*dGzGe~KKMRU*kQK+
z+50PsILV|Mjt=M3%A7fK#*Lz#<DmZa#hyc?cgL~Lyz}5N_n)7ADn4iW*Cs-Abs$_-
z%9up$luUCMtY*+Si~esFFLz<mZ+xglHw7fWtuas*i3B1J{-@&Iy9I^w{MyaC_pVyI
z`4w1E8DKAhoPm|t#Kd%f_Su6RMx}zcyS`@-Fg^?-#GQN<A~gi84gtKxZ1ngsR6;2b
z%#7krTIgdA5=4reKmobsFR(U|ICO9(eQ=tI#1Mk0P)IgXW>*Y-4pBqK$|{BU2_W*c
zLwq63a2+Vm&!0bE0H@I2*=c9D-62r0j8|?L&J>avNS^|{NZ@g}R(b;RtlFeH8drD+
ziop8qM?aPTcC;?TG7^k|44OpI%oR&Pyo`PTJ>CQmBjyRTR7f?|4p$0yhuVNt`xsAg
z0ont}S%5q&@MO6fx8!IO4h8HtGm|}5r~T_5GfyzL(ggH7EzAPm?F8ueh>JTyIx6sU
zBx&O$75;cHX#fHjI?b-Sc)fMvUIVPnB4Otoy5{v=0rCrh`9PT5b;D{%L9b$i77Kb|
zKXIENuE;w$FFC2Fng&E^Buk@fx-`)-G{g%f=2dgHy$r;{W2TL29I7!~s63=<Ny*9i
zpcqgHRYOAm#U8<8s3+*TC`FnBjQyGJUU#`3K6qer*I`&23*e6SwaNVcB%V{o!6ECB
z<iqkaUY&O6dA)@3DIW{tSFc^mprecCVN-NIBtFsE?)My^u0N-M=rgxj(zYK+?nSep
ziu`aqQP@*Knn}p~+$H2p@;9cA1EAQ$bsQ&@E!zvXR_Liphob|Vz-xcZah&5oxs46H
z&-xBE?5a(Gj5pVvqFe1HV-&?IB>dxgUpHH#CRRYTuS@Jj^Nv0%d9+ZV+uZo1LXDQi
z3%kMeu1a{LF1d>D-+va~H>C*#B}`G7CjC%9l~4yVh!T8uP8>Frl0Z>S%fZIF@V1H`
z#xMSSDj7jR-?C^qjTm7nktaS4Xa_FUK5lNo1imXL8eTeU(Ux4JqX=i*agjwlIC-Q;
zOXm}Y#znjvMR_8|mD9~Tl<=>J7)^wdSHZfUKg!ufj*Jy7!8H??6pMqY0rkDf<PbD<
zyIlA}w82>|DMB1_DbVtSzyiR}Wm$5(CT;w<>(i$SB>TcAVO3wdiIA^2YsKFm83c5`
zeay^4lWpr{8)2H(x;ELcgduDoc4c2pEa6<uDFWSA#&5#Gd_+Qt)C~y>6SkZOldS}*
z;BHTC=G~rmSh|kNJ9M?M6ZMvdJX8D{o-b4!&{1L$@iwbtUcb|^7JH&~g9$W%G9uU7
zra?hLp>h?i$mL%)L3X|DUjF|5x1CY{d!HN%ywc+PvpdJ4BfdR`xVAj^P})`v-{{%F
z{CcKM9DNQOYXmZb(bD3AOT8?V<KabwpCWW9>)Aa$oFuI^S(J(L*k+?NT!q!<S3*2p
zZH{9mA;oJ-PH!!9Ix#*u)A1w%VTp#ujWVhF7f8hOklHhhh3|?8yntr?z7oko>*OMS
z#%bjkEo^IydSa+XjzhXkLA0j=_7aMudIU5Nnir|Z)~Gd~4BJ@TP%8Iw@$4_OHnBim
z{uw4{F;a!9K^sKiz??|t4e>-j6{~#Z%HFxs)roVZUIp%9WmoZ%JcnIr^WKLj+Fa>$
zUBc6cAw?^J#cE9<UY1}-vWXuFwS8OM&~dWvI>(6<wd}DL@V05B-41T}8sn*es3x`u
zo#X2yM5bE5`*rz*^?GZX%7gp3(;y~nJNhAG<m;Y*4C<3Cev>M<Z^zBfkCinEEP{><
z2iJeXpnw1Q=eLUmw>+;+H47r@!C5_l;)a!6W`T-pI$m@g;vdRqb{v-{jvwOtq%*F{
zZ3f|brY#Dn?<9Pjlv$W)c;-qE@c(%;ga7l*D#I14mKLYP74>Xk5gcfiL$*|bbk1Mp
zx*wpX^>*QwUAsaFnoD)fJ|#89P;ryysZD2oFv-nTs71<v%MDZNhK8XGu+J%`oSxFF
zXf{zp!D%Q6#8wYyhmazlKlS>KH*p7{9rk5Nja{dPyqLAHd=g=8i|G93+xB<#j5xND
zc$B2iDIxYNk=WbH7d`nVncW;!U;l9ID%LBi=;8-6Nay)K!6yz~r=z38mqA8qYTe<F
zD9@Q4v`+F)^COZKQ_%qSmjNCpYil=&fN0Y>x=x~T>CbNbkYt%q8-81v%d#G-QqOk*
zoBVing@-OK5rEIO#{Ez^IZmFeudEGnn!V}zA~O#g9uEH%wQG~lDzXhZx1IRL#QGs_
z^3-m;1vOh9{h=Z#!`m{>z?2bSDEfuBKOYoUWtIsP3xnY?{VjZ0uHLe(fBA|pzKrV<
zI|bT}W@+1N{w!dxP@NXRW}Ezqv#QeUgv*7@_jZAC$DN@^XU&3i13!Y0u^-RB`j@{y
zqh()o>YHX7vl9X`9IDP1dCd6qql_y_Mtmmp!BYXHpFgX`Q7CV;TBw7w>yULWEq^bF
z57U7mNS+93ef^g7QMJ)=p%-vvtmzn8VUu)sBW>eCfisjXw!t6-+NWqe4r!PHTJ1HD
znbcSA_c^ko14>ttt%V%PQTF1Dc4PCS=U{KJ<bctkB9p=j*}O9Qc~(a)R}3?vU5>T^
zj?A1m`$n|zu=gkiGMn#1SAHaE$np5{qsep~YC5~yTISLvWvm2Qt^VJu6^qpp%A8*l
zqGD=l8eb-kO2nsMxJB?qs0}#0(YotFQiz!*lhBL4tT1xB%oU?oLXId#<=}xFhEPkF
zaG_!1kQ1HooCnHs4+t=^31DR<Tod?%G9^vj_JJ`<6KG5W_$EQwwe|$7DSf<ry0a{Z
zcX9FSqNmMVyn3VxH!)M96mNuN<a)RJ`==NK=t~Dc*B@!BnHlQ>PIhtw7p9W4ID3n5
zA!zAJ$7j!-({Wy~d{jTT5+{W<$I|JaC4w5r9@_2JDeBLu7*ShE6|maQjw&z(Tng)b
ze}Z&enMF58^TN6dw0XH5)jdcsNlcZ4Coe)R{#_O_22J!5`nLqfIjbkGu0DBrr@|FN
zo+jO@k!3h`<BE|ZFu*dUEe0FuHlJvi-Zt+(l6RX$e17=8$oTiOq{;Lv%bjYrC!{Yi
z#G*7a=q!<C1BT%mSG(zdzga9-q%~)5&;!s<IO!z{OCiqwvLE*C+r5N(MTWY7M)P89
zBBT#u&Q>ewduLM-ukK0DZ+HPUa`Tk@PqeuSdIdBD;_Dk26u~yUA5GjbQR{{I`F1Ru
zH*Do}nOd*{8NhfMI;)m#mrPzU!FJ5hugtpp`)MNFOgpf#f>@&?q!Aj*vdUVAzfw!X
zSLT>InTMkBlbIZB;)H-ee5+5MKlendB?E^UDC)AF1vWH@z^CmnTDrTr?ZX*UK&8J~
z6B7U&{B_(8b(0Hh+MQn)WK`Zv1thw%Q4LElFEPB1fnazpU$-g%wx*uN#)XN#eP>;E
z2zlf6Uh51&J5fT2J=2<k_#TT-yxv>Ch>{oi_U+qkQyp-fQpeikR9UrrYXFW~0PW~9
zcUd|dUS1<%q#z61m#JmE)~Yr(X~YNF<2VUa6$yXg&h$liEW$x`zSdbH(g~KbzkZjQ
zxIjaS$t|NMSWdAxmXN!4rE~xI@uN2^$cZm`5F~*me0n>DVOGd2smvJ2mh{if&7DPq
zaB1QwSjFg4`N8FsW#wc(?x=>ejev4}+GIvDKKA|Y#~{uxU%rHA4ra&zG1m6;!k*ZK
z{tNK0xpI~lZo--wAIIw@&5m6$dQXruB#E6ZB}+7q=r<(y!JoX0tB4vLA0OX~-RC%T
zNRpcI#P`k<Nb50BgQ%x`;7226D>K!4dbkxv!iwACU)GqdnSkqakH&R0oaCSf*F=H<
z<N*IYJYC?*5<7q_xbWz#?rYt_nCpSIUx%#@PYm%sMY^jQbb?g+J|Q9D;>5%^{<7Mt
zN2x4+hT<1;(GkL?))F(4JN(b4&{-QeGoEP=5$m5#02I*UNkeDPoT)@SQcrD%bKROH
zXV(?mG5>8N(PJL_hw^!}(%usIm6_TFy_LU7^)E==;Q;-avnVKmJ$pmZ3-k-q4GLSc
z$e^(5=rFU~OX+yALIrKno1=Ozy$GK8mIGjzct=COKsQea&tb9eKbqelV%4vfzfe1N
zng|0f)#;!f6=QvUX&)dQ%dKdhrY+_N^M2#C_J)n{BoyA(fx^;K6*45yx=8%WiY+?A
zmc5?ZETP#mwNX0R8R33qdxSbS^#)isA8jndd4H<i1rA_ytOfKXmjW@n@f-OI`mpl;
z{COp_dPru4cWN2CuCTbTBa8Q&Hxba5sLjgIIb56w^Hjk8#m&8D{|I*CO>ZP-FP2|Y
zj&b=VwU%GfWJNWE!AP_s{oe)FtzP{RwSD(sgB$HS&>%-DRaI0}o-7#|j_Vc^H=a?y
zAy1JyVmrm+^5<k08b<@C^hCR<K@%Hi_K?c$aw1nV<PvkA*I`+=)eMvrbS9RG-LeTl
zKLm$z<?!^XRja6%`t4<9W#cX2lgV}|Xn~0_UypXvCjOnp$8LPji<y{HxYsdYQCw3h
zXV~&cbo%H0&=f)hh0da~9G}<}2cJwY>a@#TVpl_Wzi>nULUs0`mu$ciW?W8hzDQp5
z6Sy>((Z_?mcz3psaKx2xMqc&<onQ-mcWG({JwLsM7@{Hre%pRN%n-R$tD_Y>OQD;_
zr~~QDUC4n|(#^?J?er0Dx>La9(!hA~?gi3cR5&hni7y?s<VhbZ6_(NZ>gQU5R+)jh
z0Co;G(jYXzgHQ}#$>!t@n>UjjMmOVtjt_)8eZ<*EH1y2&=u;U*Y`)(Xe&4lL_vfFN
z#imj)4RkSi0f|V0-5{;$P>=&FLPoHW2f>F%)-0`w%xk2*5UsUdD%f7Ijml>KN-maR
zxQ~j6J;u{=Vz8;<wjV*(g#W2<G;K`#F<cf$mb$h}QBjdP8Z!n?3NSmKH92<<lRIqi
zejiZ+%O%+88awPY(;-WIldS^qXXb!B^&RAgL9H34)%*bfKILD0&34A;L5-pX-TY!7
z6hTy2Gn@W3;Nq@LTN1e1v*^!`M00zOq|?K)Jv0CKk0y_K&`Yx`o_<=G+m)ZYwAgSv
z6T=cel$=?w_11`SDo5yN<o=2qT6D!OQVpM9t){~xF0LDB^J_ze8C8to!7FM2;`s~Y
zUA~WUYo>5b+P*h4g0^4)wiRPd#vhrUkKoaHh=UNO+Um=GfK_BjBHytrNW5j(mW_i$
z8d8{6KY4ts-b$&JIETq~P~kz(_zm&{@(iyFC7Q{CkRmpxRe*S4K3y0m2a&E!F7P%=
zZN3Sbp-WTOI~#5V2M34FS+MEWSqF-EQ{^>mxni4+j}(H!tXQoaf9=aP-kou<j%t$b
z?RE=}zl*mk<^?8a;G5aQoKG|&)EsjdtaqC}bDt@nH>cybI0~o$c9L;$4)7`g;|Tc!
z_3+m9kKv(HjH-%n`#}g5Y8--;vzgnhv%x3>oXXhvmd4_SE>GUTAdydQr^=thyO3}4
zTxWKGCnsS@#FlHtz0{+Va?Zmyu{uZRSNuYr3SA6YFgnjG2><FEPi{?>@`?%*v0URi
zKHJ{#u+6UT(MyuLU5CyNBAq0dAH(SqG2^iitg&GZcO3pMY$Eqg+xdL6D4C5*SrfI#
z7;>Jz&TMQqTDGgqrQOLHWo{M=a~PR#-|*65f1&om%v|5hP!oA1M?4Z}-@hdwNN!Fg
zJdNUPX<^}!#!#Fv38y(@RDAQFc`I(#CxwTPB$>77)Tf&962kx^Mk+8pa)6A_V7~6r
zV1d$`<+YO=<lpKBopX<A1x%XPf~KnV60!6y4Z9aQgSd$orJz&@@{uQjWmx!*jJ_BT
zWYuDVV~7V8wE*1z#B@kN^S9rNnI&;^F6AA6Pul-H@E63TSy~CQg8|6wQkLgT(i?XN
zIxpI)rx^R@F92985k4Ix+4ik&6dzs+Ac8)aCRFa+LZk@B!S~08lV>_;NX#{U_0<y?
zTM<u4W}dbe1))FYJRUy=dsTmPA(N0~#81F?C6B6N-~RqK97EMIxqF$mvjCcA@4Br2
zZrvI)>#MKI-a{AZ&8y1;iqz6Bm%JiAs2GM712pmG^V4^H#T+xRhRr>WGuw3ibO$ek
z_RBZ%x7|<&yi1)L4$tBficMQQ(5^wg2`mUqgEdS9NJCm6$^xPBU|M`KTuhziC_B?T
zQ?#dhnw!-uxGiUFJbpD*Gn9Z`CmpT`{u8KcMK5UTuV`wg>0h6Givr^WJCKeCjO_Hs
zjXa?orYFgnwLcr9RDJ7D#QF$FJM#+`Vu~s8mXMjSz>CsHh#@pvN2`2<En(ioW*s8U
zkEP<B*IifvAFP1z?-e+6Z_OsNxd{$?r#dzaFqp!IN`@sHkGyl{&Gi+wjv;cz?Bqb7
zw^;T=-cnxGQHVnz^B9agz$e3OExYF|iSwX{RO?*Zig=={lGdZXd&jZbUtsFcx_g0G
zxB#+DMAToQ0EZ$rD2U4XM=RL?eEc&Ayf$|0U25l!4_8(y^}yYq1(-s#_h0f0ks!E7
zNm>SFoo$+%@icW{ot&=Wl}^7irHl6>J>6m6IBNnX!eJ1xbL{csR@&;p9e4=vf7!$%
z+BTMzG&(7y%up(Ka_phW@Q$X*02-3;K|8B;Pf9lV5^u^EI$cjdgkr#xrs^S3EBY8B
z(Xn1Sq&nO&)3Ff-SC@v@Gncity*G>TQg9KwVV@s=vorti(y;~f>h6HSHg>y1-lUd=
zmzz7S)Vk!Ow}C2aP41cX&&r1_+p%%!tuA|r?~Lze`2q54t>){n3FucvD3`yNq?MAE
zHn(-o;GiC(_(ELs@-pal_W>^1Ktm%i;ZnPcf9e?q=8jbPlolAG`D|}*-#r`0xcg&Q
zPz{+|Blzc0wHv1M9?`OR19Fq;wGx?h;0bQa-pV^4S#&!GEFzKuf~Zt~ulu{Q%zZXm
zH|_LN;R#a*V??BBn3=`sL3zqJ2YiIQ%LihP3;<GQziZ!oqgzTQ3#J3P(au}cmuLgj
z+(>)zJ~lC?z!0P}vBzdNlSkgX`Iy5K4^HBKMc5ifm|)6<Xy?n4J!&|cxOi@DhYy$f
znS07B&4Ls|M&>_k3dniUWpcOCI#3K%z;DZyPyc*Nz5lDNO>{D`+0f~)ZX*m+xj}}Y
zz*+hMN2(lSxkTO|L$<O@Y@dh>f_!X%wn<hyHudm}F^W8y=7si0Z={Hb49gCWhKS!P
z08LT0M>AD#Y<_0U<)5`~&dv-A06{Nl%5D-xMlsiF0+LDb>!W(ag~PL3xd){y;uwzX
z_0j)^=^?qmV~vJzNR9rpi8t-au|Y3bbI2GUq5F}fxG*g022dbHq(GwH!F`>dyG@V$
zotDw6sB)3qZzmmRlaAf0{&v|93I_$w<qpq99J*U+FMMm#Ph>Fq5seY*S?Twa0D&==
zYA=Ugq(`Uqyw!^6YB+K?#-dqte+^hX9ozns@%PHz-fpc%X2o0@(EXOK**}s6Dt-ok
zK&DsAQ_Xb4(MTYvNrGM4kJ**b8YC9Ypr-3=SDomsp*iH6AoKPnEovs+xJsU+ZoM3n
zAF=JUTE3aNH^4!LZ(Ggg4jed8i1fW7R_k*^*N(13Wj{vvPW<nwY;I~uurU;S70M$u
zB7jVhU^ihzFKiV>d_!b*6J%g$HH^W$hg?gAkK{gYfIG5P0G#`6jV00&H-7#0nyEEL
z&jLD;OU?Ch-Ae6naO^G(4#-gEJ>_g&v};*^E&Q*qkAw3I!r_tmie`*QgbaRdM;06n
zTAG(6m5-3vjm=ECF`@fAeeO8Vk34D>K)=p6(Wj-l334l%OnTE)NG6Zw1Snnwp}w@c
z4JTWwh|VNL2J<FhXQ|h6_5G=buzg9x@@05Z=*!H8+ca{_GE_fJ($?+b;^XHx09WX;
z${UbV0i$Y>UknZs%LV$Py6ky0ua}lMYEW6)5p3R|)aZ>=!KNrK*b0+AE(HeUbl7o&
z{W4u#T#E0lSf!7KnPx)Nxb_Ii1(gS3D8;!l7!yMGn+oSVEK@F~dx_(ONbZow&$gv0
z03(AetQzciHmh#Q?-S@dQ+=R+Iq{duHJ>k_{LFgza<0^aWWhZvxemb~Gd#Y9k(dJ+
zXm+FJIfyk(%K{xD%S72@mbH(}{6ZtIZwe*Z7@od{YzIVj)<m`DJ5N6Tb2G62wL@xf
zN8~gQ3Y>So`Sox>*IUxfQ(&{hq_@Oi)|l+s0TN*ZPQpgu*INU>Tp(n%`~kR&xuIDK
z1dUDV@gF~~4C;r2n2PNkk!(D0(hCu+1Ev-eHee48K9*pR%2<pU!|Q2Fs2KSsSHzJ=
za_%~<6e&_%#_~M-?k2!?B}e;dAE^W3w9he`cBeRmdJQw0O<OpT+uys2xkJpZZ7S`S
z(<esBR{N*Bv)Q8}R~`KQ=yKDLKdDm*!_o-0J9N&WJNVJXroAa?@w5LR`O}>P<E20Q
z+WF^S>o%uy_bPbiooZXsQN}n^K3amm@81uR@;De;?=A30?`k)>JHN{<^}A(@?JrXM
z&fQbq%rCgo6vG8$>wcX_f8qnrDubyi;+#0pTAk~%HORCD@*Hstt1UV&vnNq}0s_^y
zgJ5Mk*4QZx&~-G)0amjn%4|I&L<41iC=W$w7de3pe8?;kJP8I6>PNu@T!1O;VyrcO
zM@Fmj2Qb-pwO5rf)3VR7x4{&-@r%>$sfU<2G|M?UPyMpH`-Ux=DC*>`Thq}8bv&fg
zIa1jPgRsP6REDqa4RQjgQ@3ul1@qbtD9B%>q8f8DC)-x`$#m(=hT&tN0jPeK>@diL
z^dI`|@ynM2Rl2acw&oyE0&<!l4<Abgf8zzkiP`4o3dMz#n-%9VLH(uE4h=^vq3>$!
zaPPuq*Scm)U2Q_l;Gnq7YNBMJb3Rx3c<cVnQ>pqz?h5?5G3a*0C!iQaK7aoFTEPN-
z#fd*rbR_&)=%gy-z23(3#Ne8PXj7DQmuAYGrN6`@-W1OEaSeaoE>|l$iRX-1?yOiK
zL`k^yH9{_GogjKWq!)(zA@WU|rxdTiXRYD?zR}UazHhlNdwjk55%~Gy+d&X9`I}lm
zM^aCvUiq|gGGNnGK&C6{s(E=`X-_ruqK^(2KL9J;@rg(0e5hp3Rg&>OqlQgn<iH37
zPz2nXUnUiaclh?tQ^{y2P+oNVPl5)GfFPvstG2}9-bwTJ#~Bzmr5<<>`Y{=~HQzCN
zyj-Tf^z_y#hZEzSGnSSZ*r5#GaYnBms^fups9<RX*r|jYB8(6*?X#FQdMgH(=e8+%
zc{EH)aCTrt(5~3$_i>YMc;_CTM~@!;XYAp%hBFG<Q>`f^w`)cLdjw6DU^V5qldFZ!
zfQF?8v}aW(V@GLQgC<a3K+w6YLk|dT(6cCQe=nph$D$_wocxZC{b1H_XablVosj&H
z2RA?!I*3Yu%1TVFRRJPY!H8aElG<dLC=LfAP(%c5){jzhuQ(9B56qkrG1S|Qe4(o%
zY7G)hI8sIg_^!>-W+-Sx^7`^}0n@<BBtI6|p;%bLYaOx7M9LxOS0Y;(rO}2wcN8ve
z0s|wutSxG*!xAVU(h2LE@5zHCywi9!8wBkqjmenHaai3afQ=(ioK9pl!-Za-Or2wH
z40m~B<?JTHYLuYK10uPUJwHn6h37$$cyOfU<OH)z@l88~4HH{Bm88Ql+ZKUuk3e;g
z`JVdRs3s<w@GKJ~0WYTbal4Ame$<|8(O%&#>}qD_ub5-yv~Ax5_KhpNZ%qYoy0S@5
z@<MYACCjLd+-yEgTT}&F-zbqcU?ta9`7+Td|BBQmdbBe!uqQudnsZ*7)2--pb#+w*
zo2Ec3GJLPMDKoXVHvT=4LK#lne!DCrLj=6&xE=~M-r=SwDA{F=PW3dr6_vxYIDSUG
zHk&tZCYE*c#kImWQ0c6Ocy)yYfLkIlEq~GM5vS*Pa1@pwlk#<~PEZ(?FjLyIpyf{(
z%9w?r7z@uo?_}e|`XK%V6(xCDh}%Es^X{;8#ppCuQVcft>rLl#8*OCnb#!%wsl;gY
zj1O27u~P}d*w2{kk-o?g5fxS9L~Z?U2X=61S%2Fq4<&=INfM3kB_<D0!5WT*WZsB$
z>`7#=#6~`E4`fdGLh1=a;{MiP;rXfDrQ}<}jdxy-ejXWku}qgWZ~N!9EwB9L5YfEy
zJ46yP*I!cDA<?5Yzwzn@m>&Ck_SrmFkR}tZ7{?kPzszNBVPSyCH3uZT<|88|MSM9@
zm{IUMuaW?HNDFRx!TbRSOB$#{xSED=rB2^c;0B2m5ciGtbjOJ+BCKojn3tXfxZ4Cw
z0MWfDbOPZ)Y_pl(gmTx)aj5&UpDz|TC6M{=hlgI0v!OcraBTbARRLgpzEiJI*#Q1X
zp<nL8Tn6ZibfjnE3=U*|3IhqjwEc^3>9=p+Pfh@8aHfqu8^XnpjG2Yj&yF%8YhXS?
zKO+`EzQTl#TjKzsA$lfD-+H>Eh1DYDR77?xqaUzAtZ{QzUD5soU2JfpRf7q+UZ7@_
zXbxyeD!;tvD|7o^SSMoXVBg@M@rKtwh>EHEHW-VS>*J(f0WRa(j>+*OBE7J`6L_o+
zmq5YSSLk8DqGmckUUI1?qeP^)0f@Wvqfj~p`VO*%tG=P(8>68<i|?9UHTeCdsjdr}
zTbEr$&=@*eB3Csc?duY)Z3cWkqlPOiF94gQXCRk}cu1-wz)sjx73l+4MZx9FHJf%7
z!UZz$PJV%ff5nB0&`V?jlxO#gJAtTWcVx9o=t|`>zz~5V%JLQ*5GHu<EhldAA$KPL
z<n{GjwNZk3i2&<^a)JGmW|#Ug7f&!JJVN|cPN>`F6z<eQ5KjIg3GR+#C4%LEY%mz!
zy&;+-wl4dQ6U=Rt$__O$eF5l0Z)%-PMli|z5r!LRVktVrP$uR$OWfW831Ye@1i(VV
zK4$6`n=@O?-j+~+^AiGAblaXiw;~pRSPt<Ue!D&Taj^`{5E<xk4-7Q@s13*Q-QLO~
ziT8Y8Jql6<OT!~){+ZeE{Vzfpey3mI9YBU;>M&jw_NY}pJw1ICqziF0`j4*2Isj6Z
z595<WDk7>=u%$_D+-Wf7<kA(>8J{R(yaC_NPHfg_Ji?+XY5)UEV!;?I?#lxs%uA|w
zL)|Fs2QrZ=(d|%b%!_BACZfjOtcvggYx_04Z{ndIKez~3TbN0|poKYZ_P!+ajk?7B
z2jb5MG^=n@%!cg;3z0Gh$IbEv>JlYSTJ@9RMNeef-KH(Ey5eCk3%KN1TAELU#dL1!
zI&^B?AmJGI*v!k0HY;F&trvZf^)%h-tPa)n&p6>)J#P4IcQWiokERN$FsD%oM|Vt2
z_N0c-^KA6Pz4)yP)OcBzIpFvzqS0fbWXKEU!!h?v_ogw<W5<+C5EO$sf+qDJFm|EM
zC%Be|@gpW%0&;Rw%vxfwokOD*Pa(#vfrw==0fZ^MP*V$+#(Rwv<DT&m0kdW;0)JXZ
zKz&D8<5CzeK+}Z5ut2-wVLN!Xlztukg&fLLkeXV;uGzueb;xXnEgPP`H-oWBOB;iM
z>tWaserX20A?O1~fMr$i*>w~7wBjGJ3Hi>2$W&F)sm(?f+08qyXseTc?hVFf$S_sw
zh;F(r8PkIN5DZqhiEj|jfk+(Mh_tj56>U5=)G$B<gJ|nWxc!ed;Fl{E#jjHpgQ{et
zP?`~+GXEA+Ct6~H<az~+QtO7}uAhoIPP8q{=A)tJChoC1pO+<nN5C0m2V_zO!|g@a
zB_!lt;0<L!7K<4ha{CGvMel^jML9WDa#K_W3S?BZIxZgZ^7XxGlPNRnYi}L+{w@O4
zM7EBjsZ8#{k(8}h(yf-$wL}ZVr$DaUr6ral!Qd|m$C3^Z7y>q00Y8ICqL|6S<g_;$
z2)GuX6VD!@$sp1tV5aiXQ2M(_=*Tw#&hPfu%9FVYbZcIq<78lFCR{I=Z*n6QENLC!
z56ofiBEHss+!IEUy{k@(E^Ku@Ki)qg)Cw7yAX%SC>0~^M@B@USgFcT-yNc1!ka10O
zOpy_;7^c4y0}2P;OII*fIy#YI%)#s_o#hw6gRqVcW#1$0Em;=`1<fG~y4=uU>XUBn
zhgIVJIY~(wV#|YaO7sZ`>|jyhV}{|F+?7;}nP`2;7zsBk4nBGDVxqgGDz-hkpwkO5
zgqwUn<owgi&#RdlqZFg1j>};<aWjs0O)JvnD1x9E5_Jc%G$ABYTeipGnFzJegX>g4
zXk0}5!RF@X20Y1%uAex|iHpyANQY#Vd4O_vm|&`p+Wl>c{DVX6&@sQ-MnkH=eShx9
zjZ`Q9Op;(;Anl1TG3EYyHQ>LON8%9tdrjuQvGDIjs>^5K-&pv)4F6skySxtnSFeoy
zGXp~P?}sk0{l6LM{|6Z<FAjI!5><fUVzkLT<knfZX>IM)LW(gMf|34BySRqOFFWj-
z+nsX*;QE~>aP97}7@s!G1*S2qP}vG<gjJe7vKaT8f(9+Z{f7FOWBxT%#`8c3)MFqc
z=97r{AV>S<6+UfQGI=4`{0elZj4z+Thcgd1lFmeqc6prb=lct~n>Rwyfs><%$+~eL
zv8sOl`c)d-rHClk?(Yc(GBSIGu6<tbIxY{r!1u`2zj4X0E^aRDc0Za{d=?k~62@_>
z8z^&WycOwuM$2V*ZEf_I3YcQ!Ic?{r$@php-AYkWswPZ9Uck^i_mVCy{3R2Tn;DK>
z7))!UAzeB7T$mv66S$cf*|VgGpo{q!+_Ea}D`*xN_DJtSuG0eMATcXNrl@fL7c=u#
zaxU_4ceK}DH14=pL8&_){en6iNJLp8Q^)C@Z*J)?&d+RPV&X<~!py*)Rf5}tL`7FC
zl6!txS-~^1W-VVjk+#NX%gHO?8~MP9lL;gA97V8+b@c38!9%xu+H5dj`LgQe!$^jr
z*O3c4h-sOXm5j-O{Pv^Za*`q<XW`mYZ!%Aceu&I)!eG|^=2i@Qd=L?0L0%moECTvM
zDOp)>>@r!~2QDre+%0cUucC<F9n4*F^6LW+n#9EqN|@3HH84>`?8f)K;TXSgz|eqs
zf9+Ay+HIoaDFmfWSep2xaP7<#hv84_yba(DA@>zqIa0{wMP$Cc4$}-|cnnmUaea~$
z@q*$KganNoT-NM8LM|X8O(PlRA<iARjL6*)WCQ_n{f%HNNJn%bo*43?jMk!&=I$fH
zK=dp=+UHx4xUQ`KiG8FK!^|!&`tky8asf8+s?qbaab0wN-@ffhoC`aF#yc@85ws;M
zD<58kqNnOC^FzIjn4&{)14#k~ZpeC|ohKKAy0s-)FYOt~?`GuQf<6y-;=IB&5YljY
z67wBMx#c?s;NbRU&dvVzGV{Po|FY+U9-Q=|v^quI@%@`$KCk&EW;K!C(B!=5uF#S#
zB}MlpF0UFT+B+t>*f7mRhGfyNdOv>rn6=@=XwD~{n3IQAP~9s(D_@<ATN*+<6)=s!
z#$yj=?c+)ehQ!$|!jPzpeT^W~wGlAuNyIFXD{bN5kVt8PK`H_+onQfSO{)leyi*NY
zW>BLHd_g8_GRMNi)iDB{GXm79-$G|sS0rLT5>l8t+rfjogmQ52QFft89|VmIxF+08
zFlZV9nq*Tl8Nch8@zJr9Ld-=KP7=~IqzNjo5_}k-|5HVRa0w2W0%iREDeg1m+JjqY
za5{C{?YtC>5O^G{tna?pJ|DjW2_El-Y!jDm_N|ocOd2lWjW^f>%bb^jG*}@G<_28J
zA@fxn*YbIJc`1L?hHCSaF)Vwo<pPUg=Z#NylE}qr4X}}t07;n9vub4X+TX>`Klj;f
z?Ct)71kt&)G(KS+$;tT0vZlfLhPM?nWtu73Z=10stPRYVUV{jKfjtDnJr{$mUS^pM
zw+q4D{Pf*N1!Y)Wy$ufJZKS15&01lPtBf~_;+hU&GMRy!p<sxYN4UvD+mXjT1gfAg
z-=2iiT|qh=lU`Niu0=~)W|7*2L9lp{pb;XWHb+2;iX`_rE&nOu;berbuThg`U%pfa
z_b~2cVv5ed1Q#*B&*TMpdVauQrZV_eJJ?E;VW3pPzm?#At8i}#=I=215)R@@bD{;K
zkrX>}i%AtmK8Z3*rs^he(Rnz?Fsw7U7oN(&V%o!?B{|sGB$n@QMf#2a1q%mXpaPg@
zY4#9sfl49LUK^9mKnI0nN9W0(t9-=bbVJ<`HVTZxXh0i`0NoOfjjtSS#3f;diP@r#
zJEja<+-%#r7umx%ip_JWCwwS0@IUSp;)(e-6@0V`xwF*{`l|Ac8#kWlaot>MXn0g7
z#KCF=+1uNaShUG}as&i_Bh->!T$}HmGXx<$tc*qStG1Sqofv<n+_%7WOrqW;Yt;}^
zZjSxE7O9zw0^K%?V=g9iTPMgA!q;h>+;CWzm!A=8Fdf5tg+b~#Elb(u3rHg>F}L^D
zfPO>VxzD4q@gQ+iMR5AVXc$kt#il}H6Ie>lMlchu9?O9{fwa5RArV-1ext`KVz?)6
z=944F6}$yKz(6O93`SA)K>_6u5owGV02O^*{h*+rDy(Q<jC>)wt9jev();MZ7F<-;
zamfm%o#;SksCnE2n$Y)c=dmH+>&Yglm<+*`MB!6)-p#|#h)i%9l(cmCyHydWM(iP;
zxVKCZu49!l;ccf*oHS!>5@%DETH(!K5CjW12;m#k)5o`6*;#{SMXFV%w3%g%xF~1d
zib?;PumDr{?cVu2`i)<_-p5APIsPiN{r*F*?&7_ULK~*0f*3LD%r>+8F<s(jwUfBa
zfMNm7HhIP*l-wk_ZC5&fp81#m#D)5DTpY_IrXC!2WH3$UK3vn)L0t!4@0sx&?lV&J
zhD_$yF+%=-1DJDrLj9f^JCC+YVF3{~=^aOL=3yC6s!M^s<846bPYYj+Z%}d%z^YR4
zFz{AGN_5BqTuvq_v@|p-aPMF*FzRz{dBKPxT9Tsbq~_G&rMgj6RpG=IX66`7&_|Jf
zF$j3mVuAc$9vCpejhAHC>_+v^kKbogdSjfw&>~n~1_nPQkw7s<-}g1z)&U^{`&~t@
zB@Pfam<-b$cbvT&R{Hzo&1Sr5I`q<i`Q)u8C-2Ad$rHxOvm+-jcht`rBT%Yt1IQ`X
zA)a$9xl{u@$ZfYzIUK)SY7Dr@ZZI>1m3a2}0<JXR(#c9I6d+g3k_#ptU%<dHw=3Pe
z_5ah}nMO5zrD2@bQ9H-Bipx+H;WQ2v%cfL^ReIWngTirX6i_6_Q$(x6gvEr#gS1%3
zP(&JQVyn2I0Yg|K4zdM7rwCzCHbuiCIVEgG!~-b-Bq8&>f2QB&<9zfxOa3?id++n!
z_j!I7&O&lRs|~b=Q;!VC)jD-^<iEj#o|;4p)zNH1UrH1Dk&Dar#;c#Yu)Y%P97d!$
zRYceYFrS|uB;s{DtVJSGF|5D+u5({hhrkH{Pj>sT>aUpK4Dkp2woK4%`(3f6NX^d3
zWM_?EsA)-vwF@4;dd@x8NWQUEm&7zU<kWzvD^;X+P*xJMzSx);_ARVgWQpp-vJrD^
zN#@^1dffjQrA^U}UatEN*?1Lt#;Fob-BB}-1)Y54D8P+OQo~M>7Qt(N%Ef$y*va0$
zzdr4r&D`qYAEnZR3Hg})EY@NxtKh*=0(;kEuVQYBAef;JfvZK9Vi*=w8n;ZmUa?;f
z9}M-l;_!tkZ<+VNzyN*;WNVRVGul3~oE)i!hoxof8BT;DQi)fZ?4+dh5HbA_-V<Ts
z?(no5`dWKzJN6?s)p_o&ez8DvV8N82<q-g(6Ar|Nl=mrg#O3_Za?bm<KKakf(sY9_
zjtH;1>%0dW!`j886*^7y?_Dp4#*gc#njUxVL%PV)l1|xWGT8@O3#;e>?QyWYIw$8z
zm*74Sf6&)v9lK-kSZ3M1TDMDfYvXrX!QqpT4`Iw=J*X0o2N{g-PD;8gt+~0;x>_<e
z|Ge?2l#>0#6(P4A7L0l<Z+6bkjp0dNo_y~|opro>Eglsyeg22R#eRtVGl93j>mZ%V
z$a3s-1k=EN6xaWQZ;hZ%`pLdvY?UqgYpRTJzuFfLb!S)m>wTh*bwd9-u&xKj+g&#^
zpMMj5erl$TX`xha8{_U@Qm42{9;}_5_Y5mQLC18@rE*xZ@a!;a^xZz)vs6(34+nw`
zoOu1)np~W(<DKIWcGn@ekh0JXu8=W5z)!4_CHoDe--JkC;2w6i78emDO*~(N_R1~%
zzb%BaKp}7r&)R?*!X74P@-mUuytAUzsWFk8KC;BG@#GbE>8j;QrM1^t`$yCFS|VNE
zxkFv4b)NcTGshQNSX3@}OS<IDDz6~+%-z$!p!@HbVGGn3n+@L$(1jnK^4Y*$3&2`T
zd%a|$*}m*h0J7FKO-)Koz~Vw-U-r9j`U*>9FQo7lU}o>c&^qy>1kKoM>Dff0F2p^^
zeqU;MHCQ>ifp44q)}h80nvduNfRy*yjQ*;b>W*-{S&MNe3*nAn_wYQbarP?7G*xt{
zwp)8FOzhb$JWyE`GwgnS!>c)dr6#PGmg3|L6QuKI6eC$P-0`Z<2C64eaHyjGoOP05
zCD@0SS&D&atcNIYY+BZpzX3fGP&zrio>bU0++9asLW2%2mZjok7fbsQo|7Bi1S|lA
z5ecyg*tV_27zf8eWXS@;3tlcP0q_n}miPVX_g3~7MQd7#u$pX(07}1Wp)n{EQ|EDI
zl5sB92(mrHM^Dc62%l;+uBV3blz6iPx-t_SD~2>NzY8}0&xcEbQJXc!pWGGoMf~2v
znbGgwE=<&3(=#s|_nlkT&1hxq0j-p%Q&_VP06u=|3J*adYv?vMn=H3_pG8Cpu0#>Q
zVi98vk5uGcii)ejMMm}%c+(0xCeW-#&dw3>KdD<Pi-r3OijA!;0CPli%Z1>K&nwj=
zP*n@tBt{aw$hw#xpXE_*oo;0DM+h(T>4b#e8fkjFO)_Ciop}aSECH9RZOmL^h}@F2
zv<{ohVb3#Kv59w2?2$Oy<4b9TV}P}&7oMA|y|x+Z_;t>y)w;O0qQ2QxB*x}gZBfMe
z)w;G{HKWC?l?$z(8(<UNd)7oUeWXs9jdbQ;mgiRtC7oPj?gp?*d&B-k2v%_Hyg(GR
zp-c<76WJM*Ztc-JR>|?FxIJMH`V&b-q5%pa{YS2k7!4$gD3(s?JZ!0CTEUFU@6h7)
zm7YMSO$H-%0j5XJ#SMqAQ+8Vdb#b0^1PcPvbk#dL;g{633V;3ADFqfr2L4Za4b5#%
z@I}z{v$?R{Ic9ACX<e2&Y1e)<>U^DJas3Fkeuh{ai#=o)I?MRyn9?_G5_&Cx$>hR9
zy^%1m<A_V_ef<HP+1Xqy-!E72?w?3T0lr|94RY>qJwfvl8wbz02j%`YTnn%-RRsA|
z(l>=th9TvSJXhtxJs^k94!|z5tRoKQlhPrT%!kb;bPB2k99d+}N+`69PvdVoF^aWo
z{Y;NSX5#a04-R}y*-WhC;qTuiaf;bRm;(iB?IDB|ii&Z0L{p|u^24*oNf;y4<P=)g
z{F^dw^>ocJX{++Gq|mOanBK~lYNq((qWJSRC;U>9CaOUG*ePrh#(*}2r?cTgW<U?)
zxC)0Ln+<xp`{m`MDt=Vktmv{IQjl9H-(ilThmc5ZC_puW_fTDoefvNP?_(a)&e>`M
zYSSH%_o)8>Um~7DpbD^iIb8Bq?a;J>kDZ(z4W-Lf-SRXMfF$RUnRbjhgNiXIEUI??
zd91n33MJl<Jy)>JPN#JZpp+iM$1F9PkrRk8@Hn;)?zYDr=pJ0OzdX!n7Z^QTh{;8A
z*e3;;pG++VW8p50UO<0FOZ4>A)SmwDIR1h19rtsUc{iBR5r>t_lOmd`W-Bx0pLUP9
zCl9XJ?~!;WRdmr)a6}xb>*;xdBMJ$pWRBxMU#$#{o|W(4-~N)+XW*`HBvNS(?Z_DX
z8?YKEaYNE@2oIL1Cu9Jla*BQe#}CwWe?kTZy0_q~X)0aFr9_hg`xSJ$-8c*}x#$#!
zm=?@P0wJBp(cxE6nipS&1SJ@p3i)KQfnP`lqkciRs6wA!p{~}R`w2mra4pn^0yd32
z^0GD0H>AX1ED;Xc2(*;|tAOP4<pTIR^HbD_T__+f@=$g#G*!$C#$`uNOw75E+I8^X
zT{2yG;<trwc+|L(3n`gVE&KTI|2=<@<BTMixXg6%4!1J?%f8-TIZj^WWIIk@{z;A|
z?AdaC-C!9Y6S+7#N#ovZf7Z5~8S~+y&{nrw{vE*w>y8R-k(Ue?+D?A{P2b@9k5~%i
z`xw+QR!<O=xvRY6cWnLH)z_EJmgAu|uMPLQw|M<TRhCSbeeL0ufLS^#n>}SRo0(%M
z^sQ^QcFi)@-XQOoA$h|9oP9IiKoOa7_`l#E@0jOjZLeDF?!OI+*1}?o?>2Vf=lfIs
E18!V1&j0`b

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/oscal/component.png b/latest/assets/images/social/reference/API/trestle/oscal/component.png
new file mode 100644
index 0000000000000000000000000000000000000000..5b987264b37bbfc8e9726c00c5f07983eff93568
GIT binary patch
literal 30905
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
TT}4HU>1RH(-O0?`>T~Qr9Eg66

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/oscal/poam.png b/latest/assets/images/social/reference/API/trestle/oscal/poam.png
new file mode 100644
index 0000000000000000000000000000000000000000..61f788c571e46d5b29544c996e58db299baa9d9e
GIT binary patch
literal 30482
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
F{|4lktx5m@

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/oscal/profile.png b/latest/assets/images/social/reference/API/trestle/oscal/profile.png
new file mode 100644
index 0000000000000000000000000000000000000000..d42971d6c6476bb589f106f726252f5983c1853d
GIT binary patch
literal 31074
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
IzyELl1YRQVj{pDw

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/oscal/ssp.png b/latest/assets/images/social/reference/API/trestle/oscal/ssp.png
new file mode 100644
index 0000000000000000000000000000000000000000..86d5e6f6ca4db6681e60f281a3191596cbc5f3a6
GIT binary patch
literal 29729
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/base_task.png b/latest/assets/images/social/reference/API/trestle/tasks/base_task.png
new file mode 100644
index 0000000000000000000000000000000000000000..263ae7e4a4855b533b449c090b01a0fd61d4759b
GIT binary patch
literal 29159
zcmeFabySdB_ce-o?8GCWf}ohRB8o^E2ns6F9Ue+VK)S<LP!K6e6+xuCQxR#9Zcw_B
zmcDbN=e@u0j&Iz*?zrRo<2~a&9#rCa_Fj9fx#pZ}zt3)57umXL?<NWgimg{J3rSK?
z{1r<<vD$pYI{b<FIU8jP3Zv*NLg%F|{fApEEO*JwFOTuQ`0K*X)r>pNuIkU)R7HQo
zTI!s%?^fQR@ncR-$2Od1{r+IX{au%YJa+bPxV(9XljL8zZaX)yWqD7`=NV3mG+c|f
zt1xJb8BCAaY_8Me@595JFkdtj>HYNBD*R0R!__@Ju<iGU6ps$%u3q`jv2Ft%jQsQV
z)N0n>AKiLEvHAB$iU<GuX;_K>F33ta{QnvuwkoZ^<MuoK!s23nMTNMnt*wyIp`%Ad
z;^X5F9Xyzq&;KCw-}pRYWo30GLN+Q`CBwWbUP~-YE++8dqeoY6+<5u)>7m1ii$cV_
zySj?pcT!OuwwW36{P^*hglJl7?@umO#?K#rABA=A-o4|z`~95NWTi-mQRi354_Egj
z^f<e^dJ8TuNcB{_;fRon@k&iSQ((R;f89*(eRIZx2QM*s#;n^$cgwgbH}{-wWzeIV
zNQLUOfWL+cU!B;FRXfx4{nG=j>JQgA9hPkS8{*zK{_uQy*@sgrSSs}T_;5;l@z)o$
z-S^hh-&Gcoh}@yBu%C-dI?#SjS0U-Pr;vz<n5d{zaA;^rcZs*wXj>Mi#@8+VEoli6
z847nMhZ?2I-w1N7-$wT`L8n4gNa&%*F^SK$t>d@s=BH0>QoIx8D!9~88?hG8aZYF?
zwR4-#NgWqfrR1xM$#--o#ubxp9~NBt^}aNaU#ZxWMdt~9(3yj|oDW=GU9Y}Aem>~^
zd#&lA#;P0#hcMNwbPr}3QS3y>Klx5oAFk0_^@n(CHYe+2MYX(XcsFqyw(&73B}e{P
zwws%DJNm}9>Jk6Sy3XvPr)Ou8jeL1R<LlFul*ORchK7b#bN!*+p>OP8{rq`1gN-JC
z`zl#VQEzrO+S7Ml>Q;Zaa`$em!bIYoMoB!tL0A6i*AHyuY}fwv*JXM6*Oi@gJKjC0
z3K8?mY+~KNKetw84PNkh*CV-rvu4Kfv?}SQZd5F?KYg~!9?WHah_{JUOcG5u8`K`l
zw70kCv=~ty(dgXY-`^i^*e>wCz+rjOf@YE=W{MW6#&|8QPxseWCF)8&NvXxJK7tPR
z*@jgVJ>zC(>rGGJ{QTE!g~O7@q@}X5zwPqkjPb9ZH?Lf~<|*pQd}U^&HAKXfzN5Qa
z>vef^vr<o~&p|Aa`>$V?N2fC_E&JX*>2g?}f74=8!M~G+=BS$O*rQ10v?{V?Zf<VI
zqggZ5zZOnb@Ex3KcW}rq2nq`7nyOdhxEtuOG+SV>NZwOjfP;g>=d`}B=}<$ZuD<y|
z&6N+=1DGoW<|B`V_}8)XJqUUpapBP>W*#1eR(4KK$yTf0fFr&AmG7U3ii>mm>Wp_4
zv8ypygclZGey@K9@$Nn2%$zPTKXmfFU5fppwf9U(qfEM~?)%}l9+In8tvV8_Q!2IV
zk_7%2{c%0L<+<*zuGhAs1D6{c8*hJmd!Aj*p*YJaW(W26qN8s-a&vQST@T~HIj&mM
zHBcLIq_;8l=7Xzm1X}yXe&jvj4R$5#Od)^p&>^8C*ZptR(<b|s6cmV%kEiWEtfCyb
zC-e3Ry>($<T$)L*=$$)v-c8ue52pyb)`rW7-NrB9`2++6I8FO*C?wzU@#irSmXwk@
z%+IgFu9|slus+6ntg}Gu)~#FjCj8QGPS!;!ZLL_G$yxS9Vkk<|t3QO#B!OM@>Tp%E
zezR>!m~519=JL|~c<&nrQCr*0;E<4_#snR$AD<spMJk+3Xm)w}bO)u|(&BsxN6rG{
zi4!MYxw##Xi&6Cq;I$}biOKwD*EYq2oSao3hd+<-)WzPs=)<M^YN#zsiCsB$|DHX2
zUcG*O?5KF4N4_(S*c$=6P5hSi5poqDvl#4uofi@cmy2P?NAKtaY~?#TI*`{ck{2Pz
zveCP9-MV$fh?S$1l$7HYg3Fh0-wsCtEFsT_Kpp@7V7n8-yRkV`ry?-^?vD$z^P@Rf
z{7Y3;Rb30S6Y<(*d#wh-LKD;9rG^<L+RPYG&d!KX%0??Q)kmw4u$*0(sMxIR!e5sr
z^laz&w~O10#03`*;k$Wub!q1PYE9DfwnaLu3cm8U`vg6|wX}!iD-RFN@!7;guDrRa
zp~mXxY*J?|nhLO|-%8$|e-Lan(ZjBnqgCR?sh&&WowR+XYrG`aG{T9B#W%Aw4oOeD
zjDdzmhieo8a`k%iM~Q=oa0e=@XIlUK6SSAtJhDjZ^;~)tVnrsye7FXywpm$QR@Q6p
zN$ux5DW?h#x_%4}4qhEvR#YS*&Oha$p#SEK(S<0*r0{Q3v)DuFiJr1+(XMG~p_~@!
z#@)qXhB=F}-90_jO-DmKni6ze!(}48itKB#2e;;~`JE1n(<ty=80d>qwHZ#jP*93=
zErY0YTjVt#dVL!&{;p)x=FL+0-7#Z@-ikMJ2&AMzy@IBg9lm=-3S9O{k!0JHoU<_Q
zoL85Iza1FOS!Orp5oJo!EZRv$N9S+2^j^f(_f(9eC|R(MxX3(#567H>@V}NETRXej
z>EY%w`_X}8NEK3uZT5D0k7kb&-nS~P7VUON)Ra>k<k>!odK`PVdiCmY&oCOT9Q#FS
z)P+kNKXFF(vK7=kS^n}x$n*7U`L1!!lP7Cw4Kr`n%>*VSB*-{ZvpL;qR<4gxlSA~M
zR%EbQC*NJ{Ddn&*_T<vyS%;;}aOtpD5;h-JN0ydeP4M#Z^HWl%m_u0jQAKxOxqSHs
z*637PBsH7jM;5v0*IALzpKqxR6=%rEG9TKbo?lSlx8;GuT>sH0ktR>J?PIm)r$2M|
zoF}tPaqJeIzvQFa3Vx>!k9j$i=hC^%zFQkNZWMlVf+_rM2g}1FH6JDN`r;6YSFT>=
z(p$naToD(qkmKRunf*YHCaY?uJW{KcM0=oR$40BES~+Kb_G8B`-@kv~$-f+^0Lkw*
z-qp_5R&(LknD$gP9bV5JC!|^5>O*M&Z+%yN7Q0$DD;|zBO&rg_OpcpE$;`yWNxiek
zrS9`l8U-%njXH0-=ckH;{#w7jWV_(P{_N~o2O+NG$8Xp#jERKZcz3_Cgjpi!A**8I
zWoEhPJJWpSJ9qA6)GGEkVa><O+x*keCMp4E5r1FUH}x849%nZGpZrbaNWSo@4Z5@$
zdDvphayvrsPGkHfBp>bg;V7k)VlOr&%@Qv*<Hb3%gn9ph>gf|WOv;@j8Kb8MCxYIu
z#RDM_h6fCCU!?L~s*d{V%3$cRWqG1P&|F_5@9|b)eH@67&;C9de&m|($FpVwAD=MT
z%cB++cbR&!$em`5cpLGys=B(CcQo@oDu38sZi7f+7dnMLxlO&LKJS}S3}g0k-Fmxj
zJN=#U2x%iDquILmZ<DL5s%pqrG$rc3AE=9pc)Vp#&~^VaH;tQ+RC|>^WJTwOOT2$v
z#NtPGrn|d4L})2Xam3Fs`-JZiq_MSY*LLew)KJM=4bDwB8%E$Y!-Ze$4ZE55IL!U1
zxG&i~j&{!N^nACtTCrcXdD{geZ`VghH6`hVYL~u#7oU*u;sfnj(_7hEW&S+Xw|s|&
z?wryp-c^faREs=&%6jsayT*5{LrO_%axay9N=b(3&y3ORg!!`;{Z;vWvp9C)-@e_*
z<5E>sy**G9CS0wOW8Zo_&`FU&$>GtBCw5m!Roitb%>wW-?9pZ#U)!94O`EA%k6Q~~
zlUTcQ2Cw;_sqDLCHaDr8!IpEy{m2ou)R|U`H<gJ%WOB#{+`iKR7Huc4N_~5xCB@(f
zaH((HgaG<>s|jc3wSO|A_fm3ehJ~T~;LgAQ*5Dc*W{4c7Qs26V^Gn|>aOnGP4|bKN
zuI_{shwch#M^AV6_e&FRmUpuy*e}i<$xE=F8rbuJAjisyXV0F6qXcTdD8jSu4deja
z5)~6W>8st6Y9w3|u8{CS^xCykw`ZpBmifk8IC{Q%6@*}kLB{)#nUy8;Z0F%EYTZe_
zX9dT;{4HGKBVd<aX^fmw18`h}NExr)XVG%AZmwacdVjnt(@KUqHpA}V;NU(gsG<dQ
zQ{3L(-rfADD(Baxcbi|&g=D^<<t7031$~bBu<unL&iuZy^AFZhHI~m!4ZfhCUz};b
zc6~mdMr}90`Ooj?uUx-=+B$P3`WKrGbN29?4>z6iIic~mvU9j8iN)BePCnZ<&C<%M
z8|PGU&oys<|2yM@H?h(j@h<?p-3RATD~j;@7xWx*(f&W$XWDFHDks|QW&)H`?|$kt
zl2S{`obqO~nHtcVbT+B1tUNL^h#aX2+%QYOdDAB2evX&BH2c228y_oRD4Ct;J<QE5
zhm^ThZ9cL0Y(YT*ZP~=nyzR7$bK2I{>C(~43e2*RuVW%-&%O=eGh+Y%%S~HYSUAMW
zT3XwBe8c9=C+F)}kF{-xy?UIgiJ)(T5^k!XNTrnM+<ssL{Ym-7xv3W;_cUElPm2l*
zk6SO)&2MTQz?uoWda^21b(l}Q-c-By^qpH%<3ss10x47bt+6QY3k+J#*_4vGtnIPv
zN4(7@dai}xyVk_0wcj`>{QNjyJ23crtJ4N8$I{Z$j(A&ieA)QE!1uKNZDU2bCUije
zDjH1!QtmV|GBGjD21cMh(w#NEyp8V6{x|k>VSJO{F3w)Ks54Pxw*}dzcYJKDvSUfk
z>i&ZVNa+Q&t&X&@e5;t&T~&D@0W6ro)?QQQAs%p6=KG{vw6dFr$F7ZAws7(F^!6T=
ziIDX)=`C-JQtOHDdfb_EvbG(q(AdO;dt@Z5Qo78?@$Qlm1Oi8Ex|#dBt$Qzrh<YA6
zcC0YuN=_I{=0E@Zv&p}$M&=(YM5*><!|M|onx(H#XwUT4MdY>I<FDsoXTSc{Wgkns
z?Zk^pE;hx)mpE3tmmF{)6*4X3O8t4HfSV%w(#)JX1qg_D<Ws(<b>YsP$Vv?~bmp7m
z43_u4eA>_AXyEDPrCn!i>KzzpFm7bC?qSOK^t6{no0SLvVRuAK_NxOIA74g74MBvm
z=UkntJICo77SS20;uV5*(N}$Zve700N1o&2lWlC{gN`VuUPbOl#Y{~TCr8`cdjwub
zoEg!;BQ&U8zwUyrGcBEV9nS14clS<Y@2xx3eRiN*8aFb@889DeIPuKIrCbh~ft&Bm
z%a`h0;u1GK!W@r|s-BxxFOiY)I(F=1`r@F{bo{MKMuI8PfE9O5`1tq`04mD#BvEa*
z)X}Xtoe^H1zP`8hEWR{1XKh>WBHxPxBKBhMDb1mVxSf0UD15J<5L(*$z<y~~$9;y=
z<Y7muD_U!H2L%O%NA?qWjo1UaIej|IZP^!YeV!Vu@1E?hmIU~+b)6Zg6`LMuRqD$m
z?~2Xa&2QgdbvQ34Mm6j9q-~k+DS$H+`{%3KLp+M+rTW?V_*(kn5FSOPrHM95q!kpQ
zw>s3Wfgl~P6k!1D7V8>nOn7`l9cZU2%|s_-=H2lR(UW07Au=VLr#{%v4|6vr>bf_U
zG@w$-=w~>+uj2uv)h_pEI;m6c!Kqbzd47601U0)V#ZXNb03ur#)xQhn!?d`p(s?Bc
z92d2;wTrPiA^Oe9(IZYz7i>mlMQrIG_8!P(&PDIo9hK5nJkwAuF385<uwe8~ZHAWL
zI<ZnCE-r3%L@m)`RCUjB^>f*})-xk)YIakeMOtkDW5TYBz?f_8_lfHunon8}^;N##
zrmNQwdsEoeZegr|6Yb%XM4hlT>$hD7)*t7uOV(FXh}V2pnTXCaUbE<xEjKrxNze1l
z=_b9$TKuzJ?z25iGT|PiL0ZLM|A4<fO*PAUcIi!EAUm?xP6h@Jz4~ZRtbXxeOb+{Y
zfnRTJQGRBpFD7W09XfRAOP8nTv^3oefeb_9Oo!)ZM!nq*ilnErFpiIMzf~T4u{)I^
zTU^qS$E0WXBB$D;O;nob9M&%Va}jJpch2%+Ol2p)N6Acps#MOI2CQg*RfuzC=YazU
zIE^}l-WP11uf3qxFwgQZ#a@e3{PN|enLj^o7IqzNNvn?5?+pV2sMG)haooDJq(rRP
zgQ@eSz^<<~o+tC3Z1>(o#k`xp4gA5Lv!);Ue&()u9F83JV-~No*RC}RSoyJI$u2~&
zRp$$CI`icdA_=``MJ`<`Qgc|;`gl;p<#nbAa#=~&udz;H*Y@m+O=nj%8~;7^JAl9M
zwwWG^8)Vas^nCepKl<nBk##LkgRa)sgh_ca(Qv3rSBHwrAz9wQd6nt>`a%jzDT6>1
zu0C?)NI2^99=7?EcKegQr<s_pWX%mkgrjy5j4}W|<_4hsNndufi;o^X+T%q!V)w-@
z8#WwIQw4J%T-}zQsl;;jY}2hK6fvqsb45j8YxJoypn7DIZr4iVgw(vd_yjFZs!^w{
zzOb<H-fJh(ZNJZ^I)&I7d>-iP<Rtmy$B)OlzTAe<sCQcNYDhjM^$38e=O5D0ir?$(
z{rMwLxY}a0jlZ31{dRgT-yV=yw|{>BL>@C7aAcrXPEF>@l`F#4FZP@~(jHIEu6)aw
zA7$YqPOIi_IRtHr@9~@WZ?+q>XR8og&K~0fvY_<iB2GFD&zlg9hPJ^>^I^sJTDFT*
z^}@p`y47F%rrdpe!d9<Y^J31+$457@6#ZP-^?<WsXjLMB&y@Ij%o_fK?7d@RVw$q;
zGKyxr$`kdQPj`2Ac8(99PrH_uxu(hM&6_t(ISx73I0_M%zRKp<2pROTG9~`UZ(hjO
z>ff#IGl;(J^zCZZRdv|t&39%{9hnaw4*8bNKiBtuw#h`uu{K1E#xo#5<(A-8MDp{>
zr6}Z!bjz`z{1Qpgurfbx7Bw|BKedzP+hT{3%7J}3_ncG9vX+TbNDyX23$eH~KgxXc
zXu&OCG-qv^?N=YUr&v#vakJ4+oE_5mjdY4n-bON!&5B73r93E{YRh|LM9TJ2><*+!
zV;~F#vnv`%>(BS`%Ax|H1x9=pew296nyt_pbji8v!FGYzRKZI|bul~I29ROK(L?dx
znFTZFg*f!HjYd^jyTo~uUeEBO!84?#B0?TiT4Z;2bOfvA*bC2`%dnk|NA4AgR!;lJ
zNHF<M<3E$03Kr@yW=jM}*=Hr$&W@9$w@1J>mC!$Zatq}FyhpL3C({<tDJ!*v2JI?X
zsptjrX~rQ%N|9&8q@_K;e-&#D=Pm9~r#gUgis(CnWyo&iz9wk<E0(ZPoF+Y`7ebYQ
zzDx(}u3@KTx;UjIB{e@k+{k&m=2%MVr&cAyEG^TVK&3@I%lMn+g@Sj2?Y^&GF_N;5
z14ebW6+L^mySTs!>&#2e)Gh;x0&g6a(zei^F71jbU7?~z(t7FLXKwDKob7ZKBuoJz
zC=!}nTwJ_RdJ7YEt62vUu44n$>}NwrzA*mrd2NChQr+IP`H_sxEr$5;6?WS%iB;^+
zi_VK(zWg#wDzqm<Eg_++tE<q1Nh&dQJ57so3C9`}Z_>M?RLBh0MM>$D`%B=cFyl<C
zWZNoS5*7~Mb5i>wmQX2EnSp`f)SZUoQ+PXCFF!Z8ckC+Z!PtTz@B*jI(7I8d$>Gnw
zfMwNkuU4F=`t0aPQ44}73ABsZ(t?#Iz9d>LCmMzQ9q>v7sM5{K3^sO;j>iBnBCy`q
zVBMvGONxt&CBc?TH>ViNfo(|~pO}yWt~stKYiw+sZ9~h0zBolzUHz@~bfb<8SY6Vk
z1K7&|N(_8?_V;a2Q{m!o1d5xRn}>|ZGfe$>!VsQiGZWs>An%ETYtWV%=E5KtjW`WP
z+a}p1H_6JT<M8Mk<)Cu7G}9^DUw5al1L0`H!qIw@FCmW(I=dE}Y`9{IfxfH*VJ6U9
z#UQ<fbaZygfP+Z~$ZtwB2_0z7NXgew_)q_2b)EE2=;8cqIYus%%^M#dH=do78j(?5
zp4pzuj0VFiIQY=}0x>UE-DxU4R4WRK`eW!{7RF0Bs=}m>h9;&UbEJWYJIu~r&NTeV
z<R{gIl}~dD^W!!w)^O!NLO6@O=CcS{zNKHC59MMvt)gD}l>7z|+g(W7FNd2`cq3ns
zu6oUOzWv~_%;af*-uX*@<<oYVSRJU7Q?rxl+it9YY#^dt5y<vn{q`f7_pkj?!5q;^
zT@1A9*|UdJ^Qq9KOO2VCi}N!jAceX?5P0HAn%+G*R-XEd_s-{QEkvNmoj|||&&`Z-
z5Sp4xw@T>3#fxRW95`oq$nBtyvm=p&u!8%VC3eyNB_F%-_fzj81rs#J7yQTA#N-mw
zVU#97#e?8JUIhdU53o~*0b7HmRMKsX52=Ze6aW1AGitt&kPxVcE~FUa@vbY+oSa@^
z>x=KLS+CsE88kaLM<~HxzkY#hPeCj74F5S6atIa9gORy%>z@_dwv&#I6&23??c4oV
z#Khb|>YzFEdie0KXU@*<sFPO^s9(N(DMVX%=*SUaKtw_)Dn3?PT3YG=>ThdXZgV?^
z=IK9T%*lV70Z0jA!1%!s3U*RcAE9EFeu)+Uob1Pk4<BAeT>k|gA3*Rho(YZ5F@$yW
zh=4)o;2(AJdst>>CV5XR&K5Z~sv{gN=|-K8{rPQVx6$(*BXS3T;N`1VpBEYCo{<t3
ze(ZHq20{<fdyx5qk$kE$txPs<-|h|UAPTMJ(DCEnBD=d(UaVcbyY_d;Y$NQ=^1_6x
z!Vj67WH}q+G>p3nDI39f0yba7=|6<TZ$1!aLs}W~PNCNWf|2N|QjIipzrDSul58?H
zP<!~mflt@@A7$-OUs0>R@1NcjYv2v~2N=~I6}BW=B}214+wPU0ALutzRK|mdPA`{z
zyrQo3{J~~}b=ZkJ^`|$)PF`{(LJfuEgEP#z=`vtL7r>0h8+VI7d;0Wc&eEJ1(gR&x
z;7M$;D7wlJ!}e?<R}rbJ^<sn)rFy^fAKiAnk+7p#1W<Tmx>>}+uTEEzXP>#cT8L&$
zQ}5l&jIVYFHi6)xQkwn5GwOf&;k>!&waBNMV;%Y9ND>4@2ef6M0+)XjZ|{lHcp1%l
zK%2lSuk1gk=I#!;b@EoIT8y9wJy4(vQ3_P*Tt9OewkZc%4=@2sJ4#2&S86Tp&#j{Q
zHwJ?)I(i;GaYDk2LyaAYz3NEe?Y7J`f-gBOf2wapw{B*!A(l({-*xHRrQQvi&;#U0
zF^!t-fl%=`=2sX-(g)eCemtVl>?(BImc^72@;~3EZ?}3k;>%4TLAwal0UNhL%Uw}F
z!VrcAT8lzfu_BF!R8!(#c$>`sNRGBQZ{8dSWGMM?%})~=$2LPl{EBFz_Bm@7?)8Ie
z^3Ow^J5h&FQ$XFc1^AOp(7u+zkpnD8$awOnT>4ElBPAkZ=YGG#xf8tzfcL^LND(Um
zwj<4UkJjAWTrtoQKo%RPao6Px*1z-rU8Egu4l!PeiMQNJ{kX~bk5s*mr`KxBv?4!(
z!0*MgPyhLM<9Fl07ojK7!VZz<%DHzGXdZOLb-=}L$F_H=jDG}uVNeCkM9=hAwZ4J^
z<>cQ6GF8=nR*MLaTm~%-8~KHdF8qFMimRKpZSz8{EJW*en2Rehw;!w}3owJ5xWKFs
zn&W_mi@Rw4q}jJOAUmc;%Ew*!oR{|^FhV6Gnf!*{Zc>6~a!dZ&Kihvy5*ox|M#c-^
z9}O)d5nDScDGxxrGg2wI!TKvbov2;NulywQ$wtcGOg%pjoD~dhi+zO3Y0V$Ef_gHf
zg<||GBou7gU&TJM)oJs;e?@tp<qYl2e=Q7H#{c6i40rb%8VXovY@YVa{*Tnp=P4<Q
zLWxoc!WJs(;kLFm{Qe+Bk&eNV0%N(t@^UYKf4ZWgBDa<nWeL$|lA_4nLQLHQBcJ}_
zpuAbJ5;ET@@Z~#q?K*@n-??MQev~Xpv~SQI+`tAisbyzMf4p%Xhw0xEh0`t>rFiNy
z8?Ba>7U5P`itFsSR+@3Q6RO~46hq|<^J_$)J8<B<q@*N~5kaXF_VCrKR~zEEgdErI
ze*<c}2xXbgR|k9}$;}0(8;*SikUGr5QW9jv$;o*Ldi8n!`|o38R#8}ue~yAcbp_hh
zO3eakM`~7V?D3V<N0a2?;c*Chqwzou6OZN3w}ihd_vbkX?C3!RlPgz@%xG>N?0}aD
z|8Tka`?F$UjKR;$0=H=)O)xT&Dz}yPv<EsWF(@FxfWneMuqbIJ`cG62v9O4dLYK3=
zlrhwlB<4cL!&u<T;0+icXR&qLpVRNygYTjV8ZsUNB5@EvA`$aDtse|{RrT)Tdg%2p
z3fdj{0H~%%+c}_=y~K|!gkpO5#EHt<*8A@N7DsIm;9Ah<;;kmMHzK2eBreIlw}w<Q
z$sBvTv9U3{(J&(~uhP=oAO|UXfFH$BHa0{#G5tBzE%K<0L#-Kd;H6lkK3sJ}fi3>_
z?qUd9DB{?Vv#4N(gh49aEI3{*&`d3PoBpIGOD7aX@_nB^-GCbB@_hG+3y-($V@4S^
zGpjE(28p`zMW}toAQ<H=*6;mel*(NLXd&8WKd(RAzPxl41dj))Aik&cdIk)9O#8ka
zAS*+R1}K9a10&}y2HHL0UfCI^G*rbx;LgKPjJ=KqT3*=3ATTt*zK3imz0J@GV(2LK
zIr-%0rnQW@%wNz0Ut-ddxCTn7w)OG)n_D_$pRcE&n9R4@JF*|;GJCd%mV601(Yg?|
z%6SM(-H&KgUt%W<@2}kqs8^(Ach6@3@4WYRHz}ETIMLqn04<0)#+_fch9=qJS1Z^T
zfXvxB_3BvdC3a~4G1I)=?SzWS-DY`lBx^=>w%c2cuC0w|-=x#SW)y>7+}B3WxA{*Z
z&u;*h&@6m;fD?iYkHv_8tGC1Skiwo*w>`G(;S?e$ID>;Bf6c$2u8c04RXO!Wy2U6v
z`T@i(ou9W)KmZ%G%2x)h=|#x$L-AL4sr}isb3|9Vjp{!B<!^BU`)W(lO#5H)LBt@v
zDOl8Gwe=ErD1Rd`iZvk~q!w2}acKl8kw0PBoO}%;%Hhp4?55{NZz%u!i3dqP0peCo
zU~y8asJNKfcn*v;kt4S3K7I~oq2nP8G5;FnjvPL6q!<<e)(XCf=U?*ksm`>bhIfaB
z2ELM0wYr4J{$Fb#;j33#*q+io?|ZMm5n$WS_tTM8J~nqP|3#zoe+sKpqS>Hqe{)I<
z3<J$S8xYIEI1KS<h3d_=<lm2p;H4-yrVt-IIan`_({hyX-vo;SMFW<@9uY|gxfOj(
zz-X>U1RBg@NQG?Vv$V^6uYm0fhA2ah1tlf&g&V>5Xtn{L3$yL!HBo?#!9!<EeNqGw
zh0H~xTNmjAjX@0(Co2K&pld}T8yz}%Qi^yAK>ZjaE%MmSCDOqRfQIofGqWg!I+d(V
z^c4XGaz-S(r1b{c1fzA?3F8mGuVl8Z71RP)L(Y-J4d(#qF<!skO}-6CQwEY(8bJ}2
zI4JsP+#8JBKJ*@$lx$%Cw|5U}qLk#AWx@~LyLa!Er|026DUQc#JeXvG)A~(^V7W2V
zb!c5|IMBhP;XT3T7~~I20KMh+Re4*RL|o{YK<X06uvx}`5QtW`+_dA%v(@t*gM)fw
z<JOaXZiahMDF*P^QuxeE<-A~V{ZiCGmeqiCjb2)q5Z62X1UwVm3t>!BA3ox7&X~2!
zMJdW$^W`EvNAW;5ONcZQ(;QS=X)vpv-rn9yuIDKw!007d`XB+A777^mj%n%lpQbMj
z!$ySzS4W@$Z>sS|GCu`(SS^mxKUS>AW$OHCP+Ou53}Mxgjaf#R$>8Ym8!()S7)pv+
zzjbdg@~q)lJVG=m&}M|EdvtU((ad~C<H^w%tsR!xNy#l^eAgsg!m*<f_%|byK{}4v
z+afn4r20ysFLw-~k#8>Xj-+1HZ;a0$vO>-`oHCC95}xaD=8%T+m2by>8I6@MuSInF
zL^<!i^oqRCpKG|=ZQnyI8?Kw-gQG<n)M{*BS?G0*8$zxWB>@HANB6lqg`>3zN8`gA
ztj23GBE65-oK?19wN!U0#o)Uq^zqhqCpkH#k&5_@@j7=}>rd&`Nh3!mSY;qPUf;Tx
ztMJ|6z(~P1@x2-Ov$lHrY1LM~LC1>MlyvXAtJ`n7Grp&6P)eLXL`X;mMSLH>bxn{}
z!3$cQv1xD)l7#9B3k##3sZ}Nvi>tug$BWZ5a8$iVnWn>Yqb-xd54oFh;#fx$MM-Oc
zcj!L%P2muq!to?$G7Zs$-yUg6gDXNZze8R<+@DGvboKR+kPwBeK)mtK2D|T(@mgvY
z;K_jAo6R!pK%1K9>@E4*WnUntIZwNy+K6eO`BX9t9>(WDfwHp&T)%)e!EQLI-XkX`
z$Laa=M9Vf%o^3(;gjfp4_g8FjNy=WD(~}7j+L$ra3vMatP9taNlnPS_>`k?34q9(-
zaY|*+MGSR^6$Ib^DuQT}nzuyDD)U}=tE(XOYi9T@U~AzX)azaA!)FyQGP*{`Gig2@
zI^?#rO_!NMa8`oB=?=%+kJu0W42~<AtxGlzok)yGp}HjDv8MQctT3p!8njq9Wz+~6
zl8_>WR<{;KB=U9vHH;0XbNX?jr3r4Ro(~NDX!D|<YuzQ~ztz(wevNl&R1KekcHrsf
zH(0aO%|kpU@Z5+nY#uUGjXjjRY11Z2oXR-s054XBj<NY%1+B8|@}eT6J}NGlW`GU4
zdwX@N)6?eT^4!0&_bN4)1e8}tx5+}Q-*)VOgt3H#1mSeUv-zN-XzRa+mv9O$Df!yR
z{DfALZD0Qx&NBUm*iTw^6%#`V73ulAcNy6`c9(aSRJ&eDsRIGqQDg5jj?OUb`*(F$
ze(Hw7OmzcC5ZD^kGP}v^U1GT0YKBOSY^*Qm)G4Qns4r=C-51D(eQpYE>E|0B(1(Md
z+tJu+y|UujfQSBzJ+=PxJHd1`ER>v`R_~XS9v{e>X)`ga2e<{i41@9Gw&1!;{<P|8
z^S{O?H6&H1Mp~P-<iuMH06XYySYzw0KDAJkG(}i=&dnUDCS4&l7AeHUF~ma>z$4Kz
zfbU1c4<@9#sKw&{&C)a)s+Ohok6<Z=Y6Peb0i(8p;-wyLe!P`793~1mi`MTkIZKk+
z+1ZN7QN8QrNBFXx@=jb4l7{b+u<BCt(jKTq)?IPAs=aGXR!8c*v8x+c0>o0O#h*6}
zA+knR)d8KcraKjpz+YLAnExz@*629ZE+sew9|<gjUoL_(%)iF(Gibt<HXOpCJFy$}
zkaikem3)gVk`6&n<|8dkH0;VRiNXxL4!1)Q|4hq4c&t2k9u}3)Y(XV2LK0_3^BHHU
zD&95H8Ik%L0tdAE#(`O=F3eB1GkC!WC}v;~?ZF~<9qI}@?4XI(KFGFSAYXj>`3vqZ
zAW;ht_gj=NH_R%q@E!x5kbFyE`rdp5+&-C*gT{OO41G^!9i`(H;?o#1&YrrHoLxte
z8(>+Kb450;mei-3F!!QffU1MU6?V%CB2+vcb@iJZ>#1<a*m+$hSY(tfEeV_C-4MZ8
z)v{Z<Ot7V%&;$r2R$C%yHsCSToFe{@hDLsUy<D+32M1w@h{}>xsuO4>oQ+3e422`Y
z*B==YMh-T`CG0IL;f~RjMCIzDmC;1bA{Eowi;a=g^c7vSz;y2eMn;q%cfdTwnjRcO
z&F{JQw8ck9I!oM4_ihJG_X@D+G9*E^+fqWB_|)+>o6#cd@l}C#FptD&nm_0s3Z)6`
zm>XlLNvOs>CKRYYy-b%0lIcrm*kIwGUMkr|DIr>P(3S6>v9V9BGxri2Cirs+N&-GN
z21ibqMnVOmI|>2hmVI=>3cXY?HW_YMxjxgtyF)w1o|C+^L?Q_`S_w6Z+<mDFoX1u4
z;O?SU>*2MVGacl3VlrO89s-xNx|+c9f=ProEhXhU*qW5T$B%*zO0pdLCt}2za^F7v
zx|jnmfRj74mSOAAZda~>Eq4*gfjZ@#ha}pR8uKkqXL?y4jtFEsm7M4Y=aZ7kA5xlA
zKzLKdSoM1{`d0(a)<&LgS(I0=h}i+IN;QDrrY=02Iiv<&C*9gJ#xtZM6xcXo+rlAJ
zh|m7|wd>3}!lih^D``dx>}(u&#@w>Fq1$$_rD_;SWBB}^q>;#Gu{{<XDm2T`nvvFw
zS};yEP}yW4+oa$9ai53<V4%4hU7=To;mkNUm%#a0!9U~QILHeZtS8(IM!b*K8d^<3
z%vMM&1<&qmcv(65jsj#+b)#jlyb;65d$x|<8#_y6x`)P&oAlt@G{<W>U()|IKOfOq
z;HuPeT~jkyp~PZF<6hQkR!Fi*CcW34y*+hchL&|bXwkmDoLQ-D4Fr~tG^&=LhLWL`
zy(7pdqKUKjaTRv%=R>k_vmwn^O|{JrP_o;!8c$VzQ$?M!9m}U7=#nVicu^5BJ{-ik
zV>;5JKuqYsid6WK3JB&RErRR8FzXmKb7cPtvPJ))Ext^MNW7lD5iiIyW@BGqVWq@U
z;yyxnvHAA)l=%^xgmVuirEW`VT>gaRPVwDp`IivTY=Js3kyBrL1J?u&T}o;IWRcfq
z%e!6HE+aPtqIdfgZk1xt%B=DAd0e{w^u10<slxCZ=uS^UgD0m76k=Rz6i^$r)t#RY
zHJ&`3cU37*39Rs~-%F8tay9Grc+-AK(!8T)N+cV$tM+Aafz!X%_N5gSDA0ENigU9n
zc(qdBQzad<*^ARkv*32wd_z&2ckbRT-^XRqV)W!v$pTOTtFM4-2=@c3*_pt-`JSQA
zV>&)p)w?|{tb8wmSIKvxf<~ZG$p=4yc9z!}>Zh4gbxNF2bRv2dfmXXn1oyXH9a>YM
zm~I+o3yqVy!eXrB(jM3wWb~=cDlUqjF@KsmgIHAJlb=vrLt*hXW{36D{_4;Ye7(Vh
zak^<gBX%U|Rv<bv;<$`5n1HzXQowHRHNPFY0W!J}k49~E=-A9m%E#^K2UBj%@d4Di
zqqC6b62EZazKp)rYVkeT0rw-<{Hw0Rtx6|o-_j9rGaT$_SIiHp8I4ab4_wqF5Vs6=
zEgAfL*Dt_RHBUOSx6?6kbJu?`Stj%=;<qYJL&Ujf5Xly2F)6o~{|BIc8|t6_*!M_m
zLEn9fk~Ir+gE8Y@X$>2+6!@(tV=V)rJ}N9N%^OBEx5Q~YQBE_?4|?-;1abJz&=PCN
zHs=|ISGo-409G9ze%Ggk0N{7#r~*5_N`0jn;y8V}u4DT<(jXiAcG$As0_RWKw{W$0
zFw%RkTC=VY&ayirB1UcNUA&Our(^`J;P}@tazu^f9fP+B9F<>F@_Lbdyh1HDC?IPo
zEE%&e^z|S#x?zg*a2Tz=#jDr$6C)X=J?0ie4L2(%Q5sn$t;7UPA3c6t{Q1%5vTTlZ
zk)2GPo2R{Bz4~X24=Ee*-(k&qOeH;WVX|6W){b9<=`h4-4><ZWCPPw3)>r_d-5jg`
z31T(`%e`&DO^eQKXot}#PAE0S_h%boTa+Q^<$DLv1VfdkUZy&U2Cptg&CsM7q)yVU
zxgd6*wiLrR`F6XxZoMSb5Fu&DGLQKleZkT9$)Cm9X)sP5Bs6uq<Jk)0Oo2r&MM=$R
zP~a{N>NXjQaP9@Y9Jt8ad8kL#voD%7W)!(nl<J>=1=dkJ)Dp!-c5!OL96cBHHMO{Z
z@-HmkPq&`B9WhrKF2k}S#Gt_ow3}84lMHc^DY<t-e6QMFhWs)4@1vs}q=%82C<iMp
z@ay}UjOoxbc<+e<1_yb*3KfgiZpXmBe3b&AM+(Q#4tn|Hu{|+ib(#IA4zsb9by%T;
zlm1?-0}0j}ErY`1#Ap4cL^lBBLT@#DCL)XxcR%v+VL1Cg%wOE46UddVu82Ar0zWj7
zfCznrSs$s9%!%uSQv7S(I?;3I9IJB_^Wt)CL65yc?fyDaqQ%fRikwGXAr&ThI3p>h
zGw$LSyFbsxn0x=;DTixlViIcw^YkNv+J0t&`I23pnv^B19q?K)dL5ADg!3a$1n{T{
zxt~;czvg4x`1EamsKF-a@#(>OF}T7bmtOYXqT5_bz^<sddGbZCGJ$W+AT(J6d&_x8
z6T_}qki*}L!@rs0r?l;(9qW>__n0LI*<ZSaz#}O%BSi_NqrW{T2l(Zp3q3zGav&Ky
zA~auX^Z22_)7efZF~UPk2y}dwH!!3^Yyyf76y5Ubf%q(*JB>qYvhwru75Kynum~(@
zb=k)_!UM?6IGVJMBJeTA=5-^}>lpX%e_N<a<e^4r$`|J)vaHQkri#!%lQ}IkTRQ{=
z1)n7MyYLy=QsEStdl1h>N4|3iyaUlAE{$iXcj?0nL#9EVu)VQ+8v`4>b8p<_?*8b4
zZIm;#8UBXO2unSR@46de)pzXL)iuB_|E0Y>r%)Fib_lX>yiup{(aFB{7$M^9CIl$N
zRC7_kk<WjF&FB~&W`m)}9kR06gLPY#TlYB|u^z8LjP%Dwa5t=<LwSz3q&IPOLr1m4
zC<o^&*>e0LQqrzRc*(<JUZ!R=tpAK~3}I|Tj5w}fFMz9+ZvD)F8W4~tj7~BrM_uO4
zwGu7*yz+CKuLqU_1=_<=?*mk;WJu$(_EJWt3$G@M*fu4B`COCNCT1@~fk|8RhSHnQ
zSj@z|TO)2Awd&kWydq|BGV$$w&KLzHqHD$1bS9dMJl}l)Rw<*5d5JUkkGgV*&ycw@
z97E;Str_3tZzO_2R70%w#C9iapVTOmt1V6Yk#m$}EgfVnHhaEdY}?u&avN^GbaVSL
zz<x#<=p+$kj!;s6AG!JxfQ2`+4B5IEe-Z-u_|?mo-+xY<%FuoFK57lyM;B~>ak_ip
zoLbSW!9l?f3r31EL>eBu$-V=pZr8+y?GwApdaMO<xhCuyJ85YLV^3p^V~^xA54;`;
z!;UWE;54I2iaAAb7jo0_%VJ_CW;Fibx=s<oSGOrKj93GRd`NV?ye2&eiew1j9rxur
z6{EdsfkBXuIDsJ}daePCB8-XvNVPzOL7-LYn<PZd+>;xWE^F5^!C*`#<3@6p?VqIN
z3*6<`8}X5rzbr|IXr6OH{m*~GMjk{24}$Dci980sp5b!&>rcLF*V0?zD?EVY;)zkh
zBErh?+e~{PqllrO8(u1rx%ha?%2W}A)!}qy3kkXc?+hFG;3DTvMF7;4z%c@f@9U~8
z<1H?0zXI$Y+Ri`ul2s+WhG{r%yK*Q=+!ay{acO6;QIjj7zFm)mdNktTE{rqIy~KQw
zIrf!yTi**4jKCBF))UTeyiUpR3Iuq9!AWT)EE|Dhs4QA0yoOm*vT=*K(*6bByv(2;
zpYJ_Y+%e0@$Vh}x?N$a6kw9zKUvQj6rpMHRw(f?7&ZJLnqhW8@{5c(h1uO&ae-$#~
zH-Fl95@()zd)-RcWc0ViZZt6E9aiv{3_Av<s=_k20Jy?wHXz*(M~MfUlC1Ug5EB{_
zC?C5byqi%5TwAp--Ly^fCJRSej0sS$MB!|mThlkp_e1`;Zq*?x%++ba6hmF16s^oN
zI}i~=_l;%3>a)N%6-&$1{0UO}yE^H3mjvZrkZpT#ifo$&w(X4d<j4Gp7Q30&{En(_
zm>|fo+H-n-Mbc4W_U9FRwYBl2Rpgy1=Rcm^0x+P$8c0Afq0#3pgb$9Gvs!}0>B0_E
zQMwT-7^|#3#z{I#i~+=EWoVzWXkI_^Jvw6~-ZBu-$;Z}TL*$eHso!gpiH@=rRq;DK
zCZtiU<O9)}KO&q8%sGyqEQ(Ung&3u-7=5nBQbpNWlErnqrm({b<$4rFP7FW_GY>3i
zZci^PL+2T<65~)viX@Cbz~XT2sf<cHhSW9i$B_)4KM}xZRYg{#w6ky}UB&j`aF4jy
zsDIiIQEP=+q@5$GFmVs%hb*JB^<05|#4s4OH06buCOsZw&f>J+r3oO#vheAafTIAa
z!8nN26&ht~i~B-S88)Mn<R`}E%1&a?-@+iEjP2E}94Fc_@zidiJM(SG%4r^$f#i1Z
z!_GZu5m|n2Vzm%NnOgoI7*)hkO9wJw^vL~d_OsnI&h0<33YS$af2^Ga1{!YiMn54=
zCg;EloUjQbOgOREO;76T>W+U}&+t^T*q6N+lPleDz9sh!(m)<d2xl|t=UdlmXPb6V
zuizrMkNgSbX{B1PgS&b)&V&EVT%2xRE3jO8vZ4@UVyxLdlbBi~xy)@ed%irf-+4md
zE;VY@#?6}(`sL>7;UsqM1(oe^PwrRhJSzQ3!e7n&D4pP<NacmSS_hW&m3KgXk7#qe
z2BY0b_PjyHR407J-r!fIvKPk1`s-ufG)^eYi7B9hB+l-<BWCC|(C2ui_e38W_k9Yy
z^tN_v%k#o`hp5{TnB1#+dwxws58H-<`}Z%2h|ui4OV#7dk$rqV;vxEg2_R9h*7E!g
zFqTHnnH9G?ENA8Rwh+F24<V7}@Ag>jrD)l=O7=ixTAVhl7(?xpN1c$QksuWK)QDFH
zIz5^t1F3mz!iqBjCx7emGSWaWtc;lHgR$Mn52jz7ekFyuiB5=l+Tw${8sAzA<Zfb!
z;#f@fTsUz;kr4#q;Q`%Rh+$Z@j8@)4pH8IALS#a38GXB-pVmu;Uf+lJc^bNJ^U!cY
zg@8L;T8eyXKoe!zPM@V_?wwQ}^s>ZYVmINGEd{Uz3Zz#*(1!1^*|r=M9b@1LbN*S|
zh?A`q)fC@1?$Syp15A;X7#@mfnwXkON{yPFG|h;yK<5{!Xc*#wNg63}f!Sc0VYvPz
zhoQ%G8G}v=$4HWXopE^}zn;;XGL`9J8Nd__>1asU=+#A5f<AZ(6VvPb;V9*__=e{(
z%_Z=2WdX%8v#~{evxjeIuo!>zq5i|kf;?Ca*$j@tPX%zVSW}L3t5<uLDWoR$W**;?
z{P)6%3(&x%0o?LS<V3?@qVcPJd=z9`R$WwMy%ibl0~1_kP}1J6wn(6V5}b##7wRj1
zQ_uXvwu9UL@BVvL_xQG3N-$K!4IDCsnhAYjy>oN*;oO~+NkBajb^H~8jkVxrWU#}V
z^+Q2<hdV4U-3Hgo%*~zhO)F5qPSKM?ExRyVY2w2)P%JS`Q|lkZawpx)Tj$(NEVN1c
z9x%FWk8QEDZB@k_$f=BWfSROcI(Mj2`Z7w8gKr>CS&U~bTFt!6I@KrpD(M|q?@n6%
zc<(9@Z#gT<M21^rfbki<M>m4#j4@MM9m$7EEDdDK8oL!UdbJ5U;%30S5zTPey((bf
z<<lLqu9~geCz?X&>-B%=>u-dWxLJGUSOvPa8Vr7Zkd0A|I(?_%Eio}-9``LN=I+D&
zyVT+Jynzvcro<(yMaU0+zEE$ip@-JOV2QEs>KZ7iHG%v#(#QgrN}4k)Vo1yI&MpS6
z2myVmF|ZQdAeKMaH(8A5YcQRx-<H|faoQt(DCSN%{R77Gjj=6Owylc5tcj@=K(lw9
zHC`n-T#^+HL$?%xIpqip>vd&Fz6Yl{fRiLkW=QkpXkU+mGPPQW%dPBvBpD*AU>kBJ
z5X3%Bnyq-l`f}^2=7YJ#NOOBuys9qF#L7#0eL@#qD=8~2W#vqr1W9r9g^D;&d%9S^
zIn;>hw|~?K#d;Wp_0LlJ5Rl}qkEM9_)EdgfQ1-}lEHD(fZ>d}Dg0o$JM|d;P(nj=@
z2SgA8qxQYXcGB0@0x;Af!%a2m#e|_EC{2BkWeNdp8#V=!>AGY0NGD4S<WBvuad=dR
zsSASf3Sq$Ie%=9|o*`sb$G&V=4<-)`-I~FruPr~r(E^vcY}5nEo=03G+1vf66jO8@
zyN@9cF&p#qbrY()UaCB0MEYz%s7e+a=4R<`u#Y;{O`+!UbRRktq~=J*50Tt;W~NeV
zA*VPkY`%-WzRW?_{2|KmZGQ0WG(?=(NhuSf${*4E5pxJibnbU%fA(y7gSY$hC}%lX
z72>~yPaW@#c=-EC>iKg;uU?gg7J6Jyh0yLBe?N=tf1YJXWnt4zN*I&?j8mUWiV{Bo
z^4ncAxh)VzwJ>W2$+Y`IC~k6C88AXXxm(L766lF1W(%y4DtOE5%0cM{CQPB#g>B-j
z2_MEmRAA!mPn>3jy7PiDbSzlo-odQNDlq~(oO?HK-RcPjKmD6-3u^m7QnVid9$=8m
zeCv=47)J!nCsOBU>ss#yuA?Zx$jfJ(KvMb4&A641z;{XXaPZ{jW^#w%wtzWIYnnC%
z{DIYY(NUOM>Ob+bG__^f5MM#;ZB=pl2T%y$5{on-)kd~ruypM1aMLL(AbbBRuT!O4
z*YkDDf4>ZD>5ks0G299=8w=u|)pV~#+xlqhD8GYnz`QG|NVr|g>;qA;vD&5><uR*Z
zB&ucBcF^FA_!>uzH1NEwdS9MWUQgR1p8^}b;-^oaWZQ4m&_jEcUS3*^8kk3>95P-b
zr8f*}z>`VpE8AD~w&{3}Q)&lHXU4!QvqUuO)rNaEKVMHN!C?FIo=WpcV$tj%$&)R8
zV=OQIW`8@?1`HU<3{un3gaYXCL5UnpGAPToM`f2bHjb}dJXwI;D}zaxsJ-HW#zS}O
z<MhH?#%u>&LP`j`c@OL+$*!rF*pySh{Wy9cU`=G^5>y@=^Vzlg#prm9g-*di_aWP2
zq^0rjOq_hY<`p+V{-|o4kZX?JE}i7YgVt1|ypCyumeiZxesyQ{__}H#vS_DF8_@jy
z_j@vr3u>G-FhwcFfZmSv?zGhbK0f7;4<8hhT)^(or>z_lZM7#4AAUrdQp~DwGRB0Z
z477GX7a8)*1#wCZ@+P4ZQ5jy_dUfRt*I>$FJw{r;Q_J9Sl3+1-68O+`d+c~P6pI0%
zPxD6VM}S{aXn3V??}K^21@sAGJuEIOGqY^h(9potZC;DPZymB=YzkAoN-ZOp3+R^Z
z{84AUG}}9DzxFd(ISjyfJe5xpIH_Iwvrpq5OZn#Hg?}2+(eOdU##;AhU&pw2X)}!9
zX5jvu=jC5ROA3Gaaz_ST3_0;G8Y!`mCZl-&AJ2Ze8=}2;&Y^T0$HR;;z$;<QO_Yeh
zJ;O#Ba2A}xEhI7_qEt^Nvv9y}!v?v{YQhSW)u+%WP@(_#(zx+uYLyr7ix{G@>eaI+
zG`E3$P-)NQ)!=JU1*0sRVKJJVRtBAH3Il818R6gIfJwIGLB5Z*_Dcu5L)E($Xxa>(
zpNKkM_`GExJ-wg4mjFyMG6*ug*DnXYuG?_gdKnx!2$DgDFw4zG#eci*8{sl{X0||D
z)=Qg%4lot^CoLPu0Y=H-qL~C4Z&e)~od`?;`6x&8u9Z)bh4rcy=IdHyTegwqsAh0d
zl3BkxoSC_}YM2(cZQm|Owu}&W>FrkY`vKKn>^|{X*FnX!X7{ejgSp0`V^lkL24ViM
zmvR0lykX75x7X>oJh>kZLGL!cmfFEm4D$sTe7<2eP;)|28@{&{7r>x;zj$#*bzH7Y
z?;{Y2VOW%i<UC}a0g07DEjBZSj^i48C?=F{<IGbVW&i?&K~Gh|*gCXvtMRxzm9Noh
zAxK66B{GP^7;Y5ntdhayrBy7_5wh1XQ@}jaV&clBS9cXj>L>s*@urh8M;O{*f7`il
z9~<OiH;hU*qELe)&PX5J_G566g{X)q>{s9@3qj{031GGni4pbY877i~KYS3yVOEA_
ziFua8N3Z+8gm_wroJ%GQwCrLqE^Rv8Btwj_1e%Zvj`_8NfDT^7_5y;GT)cxtUx6<G
zP(1bvsYIzGwimF7hZosleL&WMvSBq8SI`A7h8v8iPEQNb1#5v0k5~V+nmqHxW*Vb1
z%a8JLL6aD!B!D0CoEv$2%nIZK%n>zBKtL5BlLa@ugx<lZR$a6T3kZ^FC0$;VdX0NW
z(Zu!rROBuIw|SV1Rc_mN_A)3bQeBC;v8b$!T-lL^38DpXOvc}HS2bo@B@DIaw1?#+
z_Uf*XC(&ujR@v9!^GB=28~wsgOH=bQILq1zn$Q`2itihK8?KbgtJknnIO_k$4o&g)
z_#Z14#kakGTwD~1e;m*h6jA>gs?O>Czkb^6A4~5y+=VbUT{km22(Lx-$ZCpRda8^;
z%B>q$+;S9e_s=ao`|bUu*zw2oM{&#LzgLoBdH#RBf$P5)!;yge?-h6}$MXL;|M-8;
z!hbJt{6BE4;lE+|-?02|SpI)=rL1}!dNeCgjNP!idDPTM6W=(RkEYsIW?AB>7iF3S
zZKm8x<xLb)A*REkOnU_FGb1wGV+5g+o0wUsuWJ4J$^feQ5mBaR@ZAm?^8{j0(*%?7
z>VWl+x#Ln~Aw!XC1nqzQSic8u2TPlTjW+{eu9GG|0zVnw?;kfj2^pr$M2}C@e<lcH
zWbPLoOYcDR%IGKGu72l7xJ@Y-jS{(;ub6oBU{RHfkY$sz*i3y3*7^f4>A)3>H4#hy
zb6W1}7?5iniCG{{J|fo&34wZMgnNa!_lw{z>+c9$bSQ5qa0%91HXEjC*{(rAve(L0
zl-`&Qf@$HzLJr2>h}C}0x-Bo)GuYlBhDZEda#28ImQBiLn@tw4yu6NpbM%IeL*#Q6
z=-A|*0U;q!Mr3dXf8WzV|NAu{15gr!3W(5IdS^@*!>w3^v2bS44#rTris7IMfgg}a
zyg`AVTes{xTT`nND+*(ZkWd%c<cD%Ah#~Yl%fr(Ru=SG>3yiJ?gWn=bOlrEAW8UoC
zlAn!^re<pDQS!--9dPgnlZ#o=eW8CM+9#UZE>kjxNeqb~6+q*hhl#t3!~!uZ;npn$
zO<uHT-tgB+V%(h_qXFcyMVK%-4O-4@#9bY}+2{`+&pQ)O*%9x4a0joo(c?WXz<s2*
zENycgS4k$_mhm~I=S3m_mVj>9F5^LMr(vJBPT&#`72*SXeFV)Jf=IhgMi^F74|qR{
zahU~dLzlp3YNFF4jO{brbWu5(vLspqG9?6?!f7?G$%9)2Nhb<R)QZ+=`SZK&1T-3F
zNl|ognwED!GCkG;`<?$Wig*XT*j1Qu#gI1{$i~G6(2NUle@HM`H{oifs>eJz>6&G!
zapv>8K1jS5eyoLVR!&H0-Im?zmP6AKyM}9*3+QdG5<@C+pn!G7)UWs3w{KU^>yAvP
zByJTexJ3`A-5zcOe~fa9V6cmfc90n`5+39xgjNR=g=RyW$&#x2>-1tNK0JugZs?Ce
z9<T5zw5=)MDD~UI!5<PgG#MtrlcvG#x-!U*p^^)|3Ffp->DQ<Ca(|HL{c5&H{L+iV
zQvP<=lcpAh!QqklFJln?#0v_pqy(o3v);kER(Gr_ZnBHGh*3~{7ucnxO!$9MCMpI7
zwXQ^LMojTZ+|Ka67gn(lJhk+B@(U)YHz_aS$|z}VZS8v#%a|nzM?XB<6NZ`7AF~*>
z`rKt~XJ@yynp{ox(-L~<R@VxjlOnhy)8`I1jL|RXcqGk6+f?A>r)kK+NCr)+0TdGn
z_-$D4wqf-@e*5;#cA~|oVBh0jjPzVHgTrfeuS2(|+?EN5mRAoSJsN?`ls5ru1G#dQ
z{2mj0dE~yI+t}N+>~c&Yut$VmxNu>7s_fNiB$X%+$pKu^cRWo$avyh{!JE(FxasY&
zSz%e3j3^UsInlQq!c^S0{$(6h8C)EbJ&Tx?QWq?1UGhr2S+={(X5Y#+MCG9#l7!>T
z`|6ssn5>o2G~N_v?$??vh<T1TqiM)Z5nyAOLOh(Doux3T5+~;Os5WYm%q4@<=1OaU
zKWz%y=I%1XlGBN10Yf|nclL=z?-oyf9&*3fr&n63-Ov_yP^>Mt!3d%mhT~vB$LX5w
zN$BQ(lHjWI`|><9%s41|9bP310rkhV8W9FNkI^&)W(20G@C9VZelKRh$Yp_>z*T_@
zlknzHlf|pz$_#Q7apDjzFWBpqh1+;*k+i@b%8>gKr;sdmul#BE@UZ^t3e{C!lA`+r
z?Uli9T>zga1Vu;!ZmhDO_XLp}FrO8UfS-a5Fal>aocs&XHk_8*;8=)9F-)_VMG_tc
zjn@$C4?Qs)!5U812(GV>B;Dg)TYREo+&`DHXAKq|-Ea{f^3Cr%5OF0TTnkae)0?;c
zD~LvLerdK7+<JAT$8*ARC4^uFOW0BkQB;IH8RWf{yAGjw7XNGk9j0$=Z_;#ZXln*r
z=hwPnDd}!IM+Hnu-K%bhSjIx&0uBfW@5p%JDI^W59XoDlGB`Ia^(5aM-c3cBWYBsx
zFTUNfb1S*`kO+{cZhhNtw(!g7Vly#?v=+Fstpvav2>_~HXNm8fL?=^-G_Kl7$2`_h
z`kPJR%>{Cp7_-LB&C)Q~kgJMnArrqI{ne0erk6qQ5UFxh<OQu>!7G-p?ra)iZ;k7C
zYU^fbi7NWe71t!E?1kqG5}Vrq(tNf6b2r8md^%r|n@o=lV?gIyJnP0-p)WsaK#6(p
zrJood=gj<(g?WNX8A-;V+jWs)5Mw?d`Z4)F8_0s|G%;x?fte2nsB#P~Z(s$>qx}p~
zl9oP2&Jk236BRB;;2PD7$<ls(1VRONyz-VWPRpJT#3}YXupRZ~#|vYKhtC6X4{XrQ
zB{+d;>2s#m2;;>op9oS)kYV(jzRiNcR8yaraI1utjt)!6rX|NzSPc=LxE_z(YS?F`
zw0eV5!HcNo(2vZ_x$!#7?(Xj723l78Ma7-!RCSM&G!o$*dR)*BSHt^RV*AUR!>nFw
zbZ3E=eRH~szSVF;eA(4U+s>aqe;YSGh%$x1*DZ~YUU=ya+B1JN7_LCIk^y7=`~xv5
z!$m5GcSp6!xN}jdzDT0;t8ZLa_?YIfJaeSK5fWzV;OMBK<p@gkkr?fPwycZ;tj5}o
z-K9oXaA~E4M_WFB><}h|C4_`<m4m)zB%B$<2|!6n?$aWs5#b3kRE29n4>2;5lVTz6
zf+AD#)7da4YuXp|CT*D@(s&xS=;>43CtiJB&)s3xYS26aMSssy7KRfW;hnAIBA1YX
z{H3Hs>ARlYOHA7sTi!|OMs8asE4{#AH|h3c?EXmoBrZxR!tn14de^5<k1xzmCp!l%
zjkZaEtbBz;UeQIq8LTo$)K{<;tcvy$clL3o7=M{&a^jyCgg2c4HNE9h{XDM|d$Iq&
zQo^RlJOy(2C0uVsE&z$O+BZ~dsMLsr*L!;Nh7B(vkBT9rx6bfnn3eJdmE9+K3(T?p
z<S!KJE<h<tN;l#m0<$gjWxCTfX|Su<NNUHvukL9YManK`Lz}EyhT%UTnVykx9MXmu
zF8Hooz>P0naKKQdxl9Llrv61i5l!wXvD_Qt@uMBO3El&CI|by7dlTehHr%6hl{kON
z7%Q^=C81#GH;jzPBaBd)S?(^OYG1(}=E~`&McedVs<rubHwOqhwEY}KM)LJPf*I;)
zjIaRq2y^Gt<JOF)Pc<=;j=NK@mcQ}wVIs3F_`YJ~lH=>Re?-RJwczVlQB2fgie{H}
zwV@Olu?Dhzbp3C5(SBJ#*=PG-R~VwMUVXNY<PF;7=aqeZx5$h;?&gpn$p?Y(PxkgV
zjEv;wrhWCF1s0P%*<$wD7$o4TOyYe4!h;&(1qs>DzkJU;6Aw>XZZEuHUD$Lgm_o@-
zHFsK4D|`O;D_k~zepQGEQssx-SrZczI5j9u>AZ2tgV_c|@@PF72if8Zi55QyWVqkx
zSo7gShYDd}4F=)>$ThIcgtUUY?bNPqwyFMwOGF!MEc9BM-Y8wnXzu3k?e6v*9m~w|
zn4g`cnp?#o-lq0A%E+d<XMASH8#k8}!oCv>8<cUuK8ptaNY4B^KzY3s@$>$z4kB?{
z&$Y4E<fb8VT|F+ZE5yLemYgN>V~XG?BL4>hO;gRPkvQpke*AD?JRUQ}9{6C2Ag?*G
z4rgP_ayf5XZ`|}Rjp4KX#|<`h;5Zk_$9qPhn7U?=IR{ENOuk+b6^*xDODEK81U&EW
z8ndJ6JhV1gh@GBxWo%*|WjO#7^(FR$qc3o+rp+;_56_=oerG7$>d7P6ZO5YXmq-ev
zn`}B{c*yfCWH^dEEs`$5--P?;v6+s{Yf3h2N%hT`5p<2xFvSFE6)xK*mO$b~g_n-Z
z6qC_s9;1$j<jNbMMvV$~=cj{eO39h#LvdvWi#O~E;9t2iX)?M=oRJZ3s>crPb5kZt
zu7Y)u?hyso&MWf-vH~?|4jQGvK*GqV_(%@+NCM;b{`G&gccwv2pLrZtXYIBq%(z`_
zK!t&h7a$Uqs#K({Z3G5Og9dOTO=+x-oa$~Uh=9jxV~e;I3NElXNJ~QwKw>o30Cm$L
zN*0iCN}5E<RZ&EwkU$9R_ZQvwyR&clqOT#x|H*Uwj?ee|M5i3aqF6SYfnJ%qe%$!-
zU@g-p%;-$w%uR)+S51E#FtmW{-wloMl&1vy*ZYsSn6d*nGQWbH?<SCj#jcxz31mkT
zM~A535W2fz@Z^mh(FY{$Ycg0bYuxzQy5!H`b3@DfYf`kM+oulPkM^`1vBf}6cHGM3
zYTYoE6XeNtQ!J8TV4Fn4w;xSDL26N_aw7htv@B6|*O*2p(2ZS^s#9zJ;&bzJnZ}^{
zz#Fy=^K0cLIemYaH&5xr^SE{za*QwT)SF|Y>oaS6$Dn%<3dtAeMK>p`+1=GO&N6*R
zX1=Y&L%@IXmD+-Ws8XJ{(jepQd^$G9Oy7R+?yU$J)KBPiB|Lj+qLNa!3M>wxaGT}9
z>6(KrZr@%{exy9&|LJI!TY63_<Ub^7r}mIB!yH3ApOjbsA(}{^G-SKz5F4Zm^xssi
zORr0j8V*1)b`f_jP=^Pue38RlRqOFJ^C+c&ihsGTTtU`3_*o{4YA*y0R_5kt_D5Y<
z&26|SzklpU8>A@j_M2=xxK<vI`hB6AJ-YS9T2(I4val!m&kQ#qLLEQ{@a)jDq%D7f
zb`=Tq2Pd_uK)4*uatkyrju(b(4s41HUy_v5EQ6oNct&k+CvR(`b){NAWwpMh4BM%_
zbtD1b6Mg|dd}8za2HWS^EO!V-`ZwjMyqY_Y^u;|f&TYeng=fBtp{MTJs>>!w6ne!u
zV2<?@ik}<1@@cP1l;g|`h4>F?7a2pKRksVOS2E0JMHOt}2RTo^{t7y1OTNqsnt|Em
zIpK)LJ-#bM!>^HOa#!;2b|eHo8I1XA5F${ehiYwIUHROTha&Ux0Q;m4_+9iHKldmk
zWN8DRs(y^XhRhku@s?!hOb_Q8k(w5%3U)v|-j56wACeUr2o1s0eK2zCeN9&$e%W_r
zXr5nT{R{UDEcCl(?<5$sZ=P9T!2T3w6s05HUs`$9CdJ(lPdA$AXl)I@Jwz9i41m>c
z`812cHB7UhmC<rXJ#>Jh%7y@=9kQ%Fx}<IM+v~;W|JjYjvFo#0eT{9rdjqSASMN)L
z0;HUOw8Z+2dI^!Ulu1@5Jgk46$IUrD(*0di*jB)>Dzue7J<0B$u*&hkQQ;fOW&oum
za?f^4)_r}hci4b;V$51%AB|~x1V<;C_lud8ZK+;yJ~s=oSm=+FbI4Z~n;)n+K;9S4
z@C(a~e^x%LMP=|_?v?C#98U<2a8PluU>phBAV)g&_;V7BFtuDQ8D2LwHzP|Bz)NBR
z;ynofED`CnaiELA2vblGaU7W>7tSG7*mO+}$r@ow9300Th=c4R<l<s!UPK&P=%5AO
zG^ysSrn$xAzPJNL0OA>xMl=MB!8Rlf!;x?kVg4%$FIM-VdgOh0*#IoEkDYAWr%Gi5
z(nC`?yW|ms5#S+^s0judohP8P5W@pRjJB^B8&m~&O-2u6TWWP|9pv?D>FhwF83E`P
zQy+AoUJ#n%eV{Vh11}bP2o6XIND=~i^*EZn!{G8GDgDG6-9wpOXmIeI8zT^8ecYbH
zP813Q;Ftg(0yx;;u6&+I`~yx0cu(Xpi;5duZ0n_;zsMRKotz@kJwMC*1)3-k)~EzW
zgov8>@abDNXvGtcY|oUAm{Iv4$PJ0u-#Pk@{H~mJ`p2C%^tw~aG7<BeQ%vD!5+z(~
zSzZJoZ*#WMEDmK45O%dg!qWj{A`i-DAPW?F4=N@sd~LwqH<Ol+xe7W`Yf^liBbyOk
zO=tFjn`QpeOUh#cqvN`(OA#m6PUE-b95_(kJ4H8=Ovy4@dPRLM_WMTM_5$<D7sS8C
zxdaWQ1OvVFJ1OOgr&jGIk3;yA7#9q=qnLs8ZtdY&Y)Taf4_um}fWbJgSP}E!I6=yx
zAtB6T8y`wH>picqvKghQ^DKJI$49c=A1}E_nmmyV2$V}n)=%eFJNyXqKNlF0rJbF-
z0E}Y4^*sf<dszy%;k?uQ{EgGRJ<iu{>kg?4nO>fD16Gh33n>#PJ4f(JPA)<DlLUeK
zt;&m_m^E@ji$PWBrJ{QtYt{sljSSK<+%!T7@vg+B3K<duY_^pM62p8qBLWPZ?B=s<
z_JQn{r>OK+|6zm?+GsCPaT=9T8o(zy6q|A8#X+eQy0&e8zG8Ii@*~^IC=qMq+cPl-
zhiU{<?I>w<Kt;wu8bY2Fd$kf^s?+_s;q8drIgsVSEiekRF#<nl1Sq#PM`tk<6@X_d
z;9M#OA}auKra&S<cKc=CRY@|MNAOdtK<r3~D+)2~NbB0kWC4g6Ib60Dg&eHAzjVr6
z^%w+@UqTVc1OdDXClEWjW?WiwHT<nt84M9hDP`n4Nn9%?<@r;0P_3&#flUPEm>7qh
z0J=p57z)mfq!>==I}3NX;})jm8rzkgHN%d#6n(6MdD>Rnda;9kHvf9;Lq-$1T}UWg
z0lv$P0r^3Kd!!o`n4}nPmh*IvLSwml%>;as4WEcJzHO~lE8?&3WtW~7iU7Pbw$Izi
zVtD~@E$Z<};2L@^BWaKTDuzAybSUa}5|q0HK;IPb<s&Klf*W#~#+}<xqUbY}RI#JZ
zujXnlRvewQC(bx!*hnBE!9sia`*WyvLB#hNFk7fu>Z*<9gNnhx&xHJ(=cSai57TU>
zAk;&B$oLr+%uv2!$Qps{jDAn$+3$BlMPaY5!qCebRrV7c)Rn?!f7<spAtZoOPST}I
zC%*lU&D)7ii-X7W7yR$Q#(&9m{Pu4&z`qTzeVYA0fY7gbBH4ltZV2sO_}7>odd!gb
M-ha39osUla8%u8_oB#j-

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog.png b/latest/assets/images/social/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog.png
new file mode 100644
index 0000000000000000000000000000000000000000..929bb0e9773f1ecc12323eca4f74a5f96a743f0e
GIT binary patch
literal 31725
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
CWU{{i

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/csv_to_oscal_cd.png b/latest/assets/images/social/reference/API/trestle/tasks/csv_to_oscal_cd.png
new file mode 100644
index 0000000000000000000000000000000000000000..92f492bae415b9089fe4ddcc12bbd641886e9618
GIT binary patch
literal 31498
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog.png b/latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog.png
new file mode 100644
index 0000000000000000000000000000000000000000..b92d37e00f0eff7e2e2f88ac17b5e32bd11283ea
GIT binary patch
literal 34996
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd.png b/latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd.png
new file mode 100644
index 0000000000000000000000000000000000000000..4d2050cf1fdd01a9399165b50474120184c4bbda
GIT binary patch
literal 34692
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
M9S8M=-<-JkpI9{M;{X5v

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/oscal_catalog_to_csv.png b/latest/assets/images/social/reference/API/trestle/tasks/oscal_catalog_to_csv.png
new file mode 100644
index 0000000000000000000000000000000000000000..2f05b4550f6a5423481c303193db5f13b1ffdc7e
GIT binary patch
literal 31393
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
FzX9;toKFA%

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/oscal_profile_to_osco_profile.png b/latest/assets/images/social/reference/API/trestle/tasks/oscal_profile_to_osco_profile.png
new file mode 100644
index 0000000000000000000000000000000000000000..53a134f78a90c91a9f5b2c5b1e25ab71496ef3b4
GIT binary patch
literal 32583
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/osco_result_to_oscal_ar.png b/latest/assets/images/social/reference/API/trestle/tasks/osco_result_to_oscal_ar.png
new file mode 100644
index 0000000000000000000000000000000000000000..844a3f6b04087e2858c4e51f57030494dd2ab93e
GIT binary patch
literal 30384
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/tanium_result_to_oscal_ar.png b/latest/assets/images/social/reference/API/trestle/tasks/tanium_result_to_oscal_ar.png
new file mode 100644
index 0000000000000000000000000000000000000000..4510964f044780ace2e6e302d837707cff587b64
GIT binary patch
literal 30020
zcmeFZ^;ec_*ENi~jg27cRxCnM6qHa@6eMg36{V3<DQW2r-6|$XgOo~lNv9%8gLETO
z(sI%L%>%uk_xb*Tcf3E`dkptxJAmsvk63H2Ip<o>Zd|`YOTC+#ii(O>ROF&071dt}
zR8*_YH>|_oNSw7%qM|a}D0=anw59)Wn}y{zndRv*!`**BI`HVmzos7TXGF4Yp5>Rk
z7|KSUu<vl%`v}K}j%zP{zr6We{_4XbQk(lv);eyBT-7g_<2}C6>Atwd+<i!|IPh9~
z{2+hB+ANcj3V+|WMRm>k3l}}`f#jbz6w}GyUr{;wZ@#^1<?FM$f64#;%c|Y0=zo9p
z;j-h}-(SUU`R})3CH}i0E63sg>IrF&WBPpt@6+Yx=KkpF+OMLb!ouPf7|0bF8R_Ql
zKlH<OU*7)w)hpjcZ)IsI;(qX2$fXzb)#*lRkvD^%JbLm(?Ce>`r%ykB`BKtT>fO^_
z?4IPXY~Pfu<ucTfr|Kce#l%P1L$~FQ?C-na{{8#y{<f?%fyId$$ut9HcG(yonaTI>
z-*?C7ExFB(_mxJ;L?7Vcsm@q)>A^?Agtq|+2}f^=X|U(mOsA&D<mKg^(5V$UEEngW
z_U~T|MMeJW@ofIFs(JR5z95H^h1v1YYks`4PI4?Ph0nLUr|P$qq;=RI8ElC6&b6E8
zH+;)>V?zSXhE1Eiw(P%LRN{H02S2ivnVDNuRMdEKK!!Z{RX^Tq%_+Kl19#|mDrcIy
zZrs6D^kB{U11v1(>thu5Kc?PpJefdA8EMP%Tgy4+B_X_6TgSZ-&*AvggYD+|-ZJ0)
z;@(`IUtaBLX;Z<1b%zJpyWtm$i-<g3bNT7RmsF+HSZE&2vYmVmOW9?Cf{NBtL+sm+
z$a=6`dj2#%KHh^}>hhbDx(DNPrrzi^C0&{t?HGL>z{ux!$}n&nw@T~8vO!yBu}P(1
z-={5PT^((rZly$VD5hQwbXc+)n=n<9{@&luzW?&e*Q)ljm!f222NKM0{@Q%I=l#8J
z?<rrI9g46~tVfSlMe)DdbIPkN%c3;lPJzEb=EKs;N{RCqE|fF%Ic{Lw#(AsuN0X+#
zy?q?hZhX$|gU7RVT2f<c=I(Xm=HT;Qj_M`sS|z(FJ3Cvwr^K^5QSC~BnVqd|_h5Wp
zuMqEbHxG{kHq#>~ZERao^|^M^;&)J`hyN&iQTlN0#t{3(x$C3R_&1Nk(gKHEHB~*u
ze3HtP7Yj36>9C|WWvQ+nvhb^b&iH55K2Z^o*GU?sB^T%f4+NaCpr@mwt1%7?4CK+O
zU}#FxcyaO4rJl~BjZg4$N=wsu%f<iF39-4lx>9<)RZE_4KcXZUW6R0Gah1t_rc*D-
zq4V*M?r&F^%PEaZi}O9hX&n`*6~fC4T?u1kK@$R<oSd!(3Me#x(013d!!eRQc<s#r
z?%bL8Y@w7G)o!}ycU8o^xnh6(_)(kl>C-3aNXbx+`u^68WHB)@p6KIuKK<pL$7FH%
z&Ye4&g9#R+?Oe<|Sf?q4J5+u2v&;tTGi;Ttl%Lac>ZCGxNS0JqR{o%rSy4Ye|Lz9c
zw&zF0I&$q~tgSN(E8{9Wyu8BZCi=T54H8E2pI9F?S&n4%eeUQGE>%lROstNU<IXVZ
zdQ!;murTIy)t9GmXzbj->-aQYlBK3<WMN|y`QpqtShXirv9z>Q9AE2B+J&v!GV;JP
z7E9GSl!%LWD^4{pP%XzWZ?S$T@vuyki05IMq}Z;W9@aJMXkLekdzaw&vhLe=&dtrO
zyE;@n$)JsYm!S2Bzt*qUQtYUv4L)Vqu4g@xx4alX)S4k>(4Ngs?$gqO)$B;tXo%H#
zuR?R=jdu@iC%#>wG^jd=N=thjICxO(;>AZCO6fOtpSXA1tV6dxX3G}WKtY=lJP~fV
zl52OjI(fID#>5NlmR+>T_p9j1dfN4wRwm+tmZlqZsW-$a8;||CBzpb2mygd*J}XKH
zhf215rrDrZ*T<~OuXbxLaw;TUym;}jYz!N-!$Kkhzo`hz{{5_cd<tC3nFoXyC*148
zyXNNSOU1c!4&WJF9hPRVY~8x`02kMF78Vxu{_0RlqngVzZ*T9q!Ejvcr2C!c`OF49
zK7aixe)sNsrS$vfWaCvh3!La02A=%z>irg{oOQ9ggZYwt;@!us*;Z1BZtB><rqr&d
z4N4I=_E{~AeZ`@)cYXSF!?PDJj+b}fJeM2_vSpbZs7scg{`oEVy@y+4qx_4?LkADO
zQBn2gQjU>7&Sw&?PlG+pndq;%vYS`$XVTK1QwAJ4)|18x%l9R?glVs)NrqkB^&*@P
z=e0g+4u@aU%w}>x!>EbhY#<_UdFf1p6o=Z~yR}8G`#DqZ^c#m>aM~0}&v`2XucgtV
zsiPBRy)@hB`7{C#BU$+6i)NM{PT_7L+jJSbpwmX@W0f*^zBY_k3NJ@Iq1|)KR<K^>
zy2h~azJ2=!S`71KcJ125=Pb$|YChT?8zmii*GTE4PVG^}C49g1{wvNOEc<`9wObFy
zGW1=|vtO*89BeRQ>_}AmDox%&@5qT0()t~_f(@x$O6hO;O@Dr`vin*uzJaqmSnaEG
zBnh{%EvgQSb=vV6NI?U&ky06{!5)$wcGCgWG&E(B%UC$sIvKG@Z0yd!Qhq(P|6Hi~
z9fpR6DQ1JR(ZX5$rCywh9@x#&hV_N|&r8?8Rqn5ibT14TZ0C+{@;v{Tnq62pkE5{q
zdQ<Qfy6w!&hWFMl&ke?xHz!W?2p>Fnx$yJn?q(G+vFFx(0TwZtBYd2k*YKWf4Y{$n
z*qk!4w@xNEbQMt@IdI@2qmXT5RXTZ}5-(2O`k+v%Bdn~2QM|`_c#>$(A~tJ8e@eOf
z?c28~L_zu%o!SW3O!MJ4b^5G_4n-rz^XYXMsXK1pzFp%O%@WRxKjn>Lnt{HhgTVdo
zj)x^fo<_dP-jJY_^NM}j?{^(heRD$lZr$`HtryPDyz|bY@6_eeA5}dR^E~V;NWXnM
z>#<|UWa}hEMO{NeLO56j1qDlawjY*$UHD>$xGT#gnpeY3T0x$tI&6<O^sHXJ`oP}3
zdmDOeZEe-7Lquhjr-u*{g0Hxw>iE}h`1@~HM1?akg5tSLbGk3QZIpAYWj+-Ya2nK5
zdP++XT=Zn-g@lA;Ir}<0?-*sJXxCiMo%!*CBTvQGFF*gRLX!G3OB=1lEjJw;9A^8&
zgF;OEt7X$<a6=S6+;jCfB3CiMZ^eoLhUl$1WqIq?oBj@G>vE*dq<i03k{6F*Ge|<l
zhPq3IU-wO^i@3Rem#}?y|8kbas236&7G05JD#vPEvnkyuSg$qxCe~DA(&u<j+R9aG
zxYv{vD$}tefb;0l8@E#R`Umdhze*RlR1^D>NwAq?*Ag%VLo?oF;ZFS(Tifj2XUt=w
z<l+M}mzU=2{*e%PcRff*-zdYlr^L6pWP~FkB;>$J`vuE7pd%T8o0IBAuNk=6{f}!o
z>(oVg0@-*CG{grLibo;>C1*Pi&0W8GRl4h|i(L7elTvlja&n9F({hKd`zNI9)r4J3
z{?H$BJOSZYeXJ}@E67e30F2Gmq0(!<*Uzxb3n5Q-)v8qrbIGRbWP5e(mKUdGy1u-U
z3E(%Y&3~|_uGsw$Cs$urmwRaWzw7DVaPHW$<z1lVkH5(Qt$TlI<4OJI6P{jPnyIah
ztJWlaIH~r9CRwApy1MrBvwvi8Bc+F%Q|hE71T~B{T@4ay+c)0qs&%{V$T-Kx(Y)pM
z&iD+w`6<mxW<hJ|wd>dWd5!)0bpv3BM{%S+RxxbWqh&C0T5f|`<Ci}tbK5i*6BCn8
z=cmW?!tt4(kpIhsB&67ywt3T?&Ehd1l1~m8DDyqONjFa=$C}=v^?CrmFQ;OXx~N&_
zr?tr%UtO3DZyn6yF7?W#vKVfz`;kPVc~jD>-6xaMhwP@?ymdR2v&>UwZpA5O+)W+I
zQH^2TetUAXqhn|mtLm2`_2J&l7vYudHpS!?3JNMO_6aW^(@oYae?wo8y!)h%kC%2$
z*sG>-+>j{SS&D3V@#Bp<-UM>1WT%T=y?R1Xvo_+UroK#^k^<|213r^BhUuE(My8I4
z5b>8?m|_o0N4ymf6qI>){_$0B3P0tf@cdA+<}gXgF^s~(!e+A+4Kpk$N9e_8TV->Y
zY*uq9ryl#A@u>@QUI6wLRtCi-={9in3=R%bCeMG%yZ`sQjq-D$*@%>-bCZMROnFx0
zVORZ6e;XPTvYYE}u0)<IV*<4DE7Ztapok}b-NYooW@Kcf>9T`cMW7+~lzy}NRAaf{
zDGdM_O_wy>n}#X9F+}hePEJ?6aH;=E?g573P+^iyQZH7TfBN#}hnZVA-i8_0lTl4w
z2<>4G!oXmfl@2&yB-JK=<y6+On&ws%q7?1d%sXv?H2<PyvNgjb2^WFGW$j;orBCb-
zNjiQzpK5lZMxy7_<Be{vuKU>8*~3bO7-!!EzkgpgATaj%AI-d6UjRe^M|U2L5_R@e
zrA_yw?c2T}$rULga%|nbdtl&>4~mRicDnT2^!}2km#5aJ-hQ|{VT$uHn{Go~x%sS2
zw5+e7Y_jIHWShMT`;oNW+}*KI^SS3Ovh3zlo7Aw2ysd@@#oyh+>gyX+-sI3Xv7vhp
z$a2DFXvC}mmo>Q$M@l0x_Kd}d2y$>J&O{iG<*(Z{<G7f|qm%6yt&59_5*pi|{d1^{
zDOxozw@^b_8<(v~sIRCY+o<dEGZ&Xiiqb5lhgCp8X%oZgy+IC383Ic)T?*$5vb|K(
zj^UjsUdTH1(|IM^cJ5?D6pLe8*XlU-R|r*tDevWP?=Lad=Z5;R2MO8nxAep-XB`|H
z8~ZUjYG_^d_3M=qZ*K0siU5<w^caoqCtcG?CsYtM@g1(UwbC|EJcHd>#Y=)+gbp*F
zG55HYq9Y1O%({1PeyC_(=<#e^3AbU2SH;#+>38SXCVwSWf)z4-EK_BhmQ%)>E4jTz
zMIyWSj6-b4%TH;Rk{Sy)LVa%8_qdk&*pEUU1czrh8h5%=*`K!T#LH0e7_IYK+YqmM
z%7)|g>Bc+z>T|qTJ(Cw&^V8tjvuCm?!C44~FI>*>?9KKI4-bFIEUZ!yB+RX9H|aSs
z+M%k`5XXs}V==28WwGAPmm`2tOIPvo+I8!i+b*jZPv`~;JLJ;rJi51`bXBxW^ud1)
zUVS~@S1Dc@C^*dYZwmDfUQj%aU7_LO;(B^9(N1@^{`1fN{{DWlq*SZC*3M6lrp=_M
zcxPfcuHtipLIozOE`;?32M3oAbkko}ptj^0UE953%3ns~qWQVH9B)IulJ}QhsJEsY
zNrs4Qc~Kc25+Y)3oWvIDU+r+6BS(8?Zmzjj_Wb#WIR#rJB&PWpPIsMLUKp>GjFe<0
z3-{>pV+|Xtz@of6Rmgsv?WJYA{^u#f!g?)xuBc=g_dJ)1|8j2WBkLpj)=V?;3V*)+
zbx|^<l$rf50xULDL&b>(DLQo_vaz=`T~u>zn<hqq@O%VSkzw>&vPX00%T{xRdKAt}
z^~WKhXu1>vf&z#X%n#JZ`U%W-yDKo278Sjg5SqQ1J3n&f+0&;-AFozS)pIo;ZsxP4
z;Y&0Plfc2y*D0;`CzZ{@Y+sOUTB6Ogf#00@cCDP=nHfvpV`@*ze2!f}(mfb^E5(gh
zzgc8@q%9QjSix(OLUD5uUOFvd;H<KF<xn$lv$9^g9w@+$AY(Ck1HjiNjlXMtFNJw^
zjNZabmkXucW>mvU@AK0w6y*3`%Zv_^Q>Gdb(~?{B?qNq!!^CrxnhrP1<jxHod7*DU
zP+L5dn71@{q@{Gsv>r8O@>gdj!2yrlb(<LOO*NvNKCJfTrIDD!WyaI@&l0TPlh|AC
zS8CB=r<EGx;^JaE-DaU+U|=~lq+m4|n|4)SaJtn*VPG4(<i)V7zCRwh4t{iv&p>sc
zuoQ#<)K?kg9TCAcyExs^Gu`3f4aPu`$!6%-?9%*bvYyjA+T9{IZoDo$euOb{uYnrQ
z{^>wTv8myfLl>UV7_GeXk+(`lmuOn)8r;>@u&bJRWpbIO+6wrSn%7vBqANE$>aeUk
zHG|qIS*b?1f5&<t6t3Zxv{N<$zbiD|Da-45x9)AcqI%wPn$_L+;lqdBo^mS3Y;3<e
zGj19_BNZy<S;lk*u&+rCc~mk+{#f|SeTTd%{CAzW_u7L?xp`=e)K19dA%-2fVUju4
zW;Nr${8>#s2AsD(99^sAg)>}oW;DC&!@LWh-+t9`Qu!j6^LhfD%V%F{#?$r8jCE<c
zbYzt$*{n(JJ2<e`XwMods(d~``r#_Y>c+$T{I^i<Dhbl0Z@HAHgrYcvBg3@c?G2B{
z^W6fL3A>Npc0}axn8RAiT)zCIDT$<0a2T5UhRq*}^_o!DOai`uuh5AED2)Uw69sth
z%jxam5dz}jn*Me|I-FiySm4NwLkvmQ7&RCjA+=<(h9YpGZU^Ga0Diq3PLLe1>kStH
z%2R4Oy0mn?woJ3+iCy&cnyFVu+jGjlc(oWKNu0E?UtU^_!i@>jK;0A}8>gggq_k%J
zrm|{Pz=txg3{(cG<9$`{E@+ktBTguI@mc<Q+r)E7B2ap9Zc+->uq4uglws~{*z;Gf
zPAZPz-c(lCBe8MjI^!{-k&S(NWdKC$e2%GIZ80CLkBt&>W!coE1;o2Cd8r{*(OXwA
z*rf4W{47q`DP6UZ)(p+XQ@ZtKddn!4Z!Rq@X{w2fiXPK7LBScN-;xTnC`(r9NniG+
z7M~Sjfco)|rNWjLMg6wSx*uAl*&j4Y>3i@GW%8Vn-w(>Fdx}8nwOG-i=6y~yyY40q
z<8DMfdi0lHGsAJst6r(5Gzl>&wzI~`Lcm6^m<0J->~U6N!TgypwA4rl2ZRc1{UwiM
zDW|Qi&F5U;maJ9zM!y5JOB5=^T?XRpp}cyHZ?ki9hTF9${Q1VUx(1+w3aREmcIjY=
zbdW1R5a}Nl6l~M;WwxLB_@j~IvAcy0E+lQG732Q^9##jBcNd(RCo-yC*U>QzQ6|qC
z1%ce)6S;QH6OpFLR7?$(=Sv1YNtCDRW3xD+Mc5zOju-=EN*=QT>4L7}YbuM>oo!sI
zxg6Yi3rRK2L4r1^{(L51ewZM&R8D#SeZ0x~g4zC5y(SjJ?6D{BbaVIb-yeF#g-LVz
zY!={+>0tde6ziIn3<$F)vefGtPY;|lY)LKu(G$xm?&X1!v-It`e?!11YUcg07-{9(
zg`-_K1#G2fc{SrtCag%jTS)yPO}_XDvW~as5xLA5hjc_grHhv@i{bM2AT1}&h4nja
zVsu;2Y<okq%*VCM7+h1b=}_ZMR1g8Wen{km4&23W8ll+weI#eP{dksYWgAw4bs1Ec
z|J-;izJ<_hf78)b8fBnvFGfXxswnvKEB})pIKm`?xNxFB%p5V9rrx;G9UoNn!_Md8
z#ZAmY9JG6QJy2aJ)=h(84Ru&v;<2KrUr?)m7OXNJqmWGE1p#)^%?dfzDIfHjcv^;e
zO?t03CEWQ}Mt|4M{{(tmecX4C9{X}D6pqRVulq+7+NFP2QL^9dljTuWb>pOQw@8Zl
z@GUdM-R*n!M1w7=#plY%%lo|H)qjJWAJA!@lbyX%p3n&|+}1e-8b&$SRzV-7S<Ym=
zB3J{-rh1Fdtd9T+lhb2jy*JOz&PE~vM*zk}fr*U(DMZTb6uWtI@_E3@e#3)CwXBbP
zkqxiVGV)8uDrd<m=h-WVhJ{4|(M7~6rbU76Wn*S$CKY0GDgbX%YfI5C@6GMX3yX_&
zFSv6fP)G)oIvvc9^wp~``Hg-&x|M$a9Z9T|iHQ%^Dktw%owWmVql1h!05E<Sd9N+Q
z<O-v(y%OT92ucm%2JwlPUfH>is&>U^;QH%Sy*)R8Y$Zto$<3QLSAGO}|MBC;k>Es>
zP=VD(jak~*M1u`d7zT58>C&Z006Mer-fJmpUpLhua}<~;IO$&{ydWz4V&TGqf(zw=
zf-OI^jI=-zdr^M<x<5M@o-Q{wv%E~DCy6TO8A6mz_WjOJvO$SN38T9IiZHH(RYP1U
zcV8kG!bNB<0td8L)S*Z?{n2LfZH}u4Dgw^%=rtbYvz<w(nFj^)T422F_#?T5zyIh~
zYa3DWhvK{>A!LS6CZe+LZ%K;>zjiv7uG{dB&b95n@4k9DRXfivI^$iQP!kYFyg+bl
zQTfRA=UdJibmVe!Xa9Ogz#!;tLkpYvsbP0~Q!#df4R_5bf5Xk!M*mneKK4sT3Zgo@
zB!!&U-;^9qvxoQUKwb2qj~_qE*1dT7(gW06DQJ8R1fZ?kxA(L@c%Q#F|Do~*h=Ej8
zdu@;|w{G6N7ylt;h!{Jd{OgGcQ&9;C?++hN$k82>yY}XUD*%Kz5Pc|60qTy!=gysD
zVcE*a$mz|k>g9e&q6EoO16yzWJ%7~>m(v#Q?d?B6h5*L@0Mm}&P5vXsj<w$&`c%yH
z!f$!c(fzM=>q<azfk-(Ej7n%noW29NN}vFG@R`Pob7p{d&y}*wuK}jB5Z)8V{N65u
z*}1vrz%rKBOEy>DzkEp}iqMF|zr&@>AAjw^t*Qd~;*dtEmnVuRk$d+d00M4_d2z5~
zUAAu9b^s~mM_=C|+#4?>-ALuE)X$$kr(4gYJEcVv)dWjw-_zN-4{wU)xy`T3e#p18
z9>Jd#LI<fM*KcBYjh(}%$Z@Ewa`#4Il|mCuSRpWVAbah#L06s7YrFw{;V>eu_uazh
z&!EuA466seTDy3E-EXb)I(ZmCWfz%Fnd|R^gL@hi)r`A~wlrm!gzI(WDwFsPxoOkx
zNE=empoSDh1_{L_CjwC<NRtcoCJ=L2`T3jA?SCBnM^^oQz?nK>WIJ#_1O`uhcQFpH
z2GTw@xwA^hl(5$b+@1u#qH+pFalduv&Yx968xkfi{bzShAIZ;D#C2Z)o=8F%S4h@;
zMZSgvHu7PK;+B?{RvV)rl?kv00m=)==Cr_v%ss2Ta(^E#s{3x>-$v*mAVHh)3bLOQ
zC0sD>x>a?2FnAGh7bZdVe8*MQxpp?uqjxm8S993?5q!TNuwuO3HVig5$#U#2A;7vJ
z%2>7Mae@ZiM~L^2|E?EDJwVBJ_}@PjN0Yz<rsJAyjQl>6-ZEF@f($(dKJCVYcQnjG
zO4gGDtQsXAMop*x_ly4Ad|TuBvuCa-OBFOL{3EZuu1mOc!K%koE(F>c_W%1p=jPkm
zFR6%*MMZV!8+(4qHmog<q6d<zBtUJK+cAM(`D-X8N8*cK@4Mh{EoC13|NDrYw>2_x
zlFR)0q<Sj?j-(lORJaRWIDcM!=2s_$Qpzok(qlYCVn2SUr+?tL9_X081DB22Zo-w+
zBGus%%;D1w_&4F}uD&@TTKbFH`i}tlmP!||xPY3A0=Y&E34*cR9?(o3loADuhB%-a
zW4jRby44&j??8Q;o12?tRK3Q8bI2eEa97RK`iF-(0oz>(JBYVns6I%|_2&onvMdL3
zrhp>xh0F%hp}F-sZl-#BwiTiLBc&tVy4F2i{o>CO`B++77NL}3B^djIZbQZWMU(`k
z&?Pi}R=vBvlac!HpWk~s3}G!vr|z)Ta7qJIgF_8HL?WAPP$g(V44`%V_9HftKPSrZ
z(t`&Nc)-p10?iPCB})mQN&_1}0W~Xn`}S=n=gn)^{t3uM-;P%btT3R!i*E$w!0jod
z>iH6Rm22lNYU)3a@H%=EBYzR{MF>!3*w<TW24JIOT=BqJ2DjNZXDbV?EE&~zCUW+G
zV~@AJwFA(SL<O_Mg?jC(KOdKH%a=z(9s9__LNd(`mv#U1Bu5{8r?z@!^ItOqR`UNj
zGs9`u@I$IOZEIV^RR2fxpY@a!gEV!Kot0!SBm#)3|4C`X<qgJiBI4rifAS>K&rPvs
z`2OJFOYA)ZogY_2(l1>(GvELElV8b?Bj3PDK#s=W)YNX!`q>qdLP%ahWfux6lw{U-
z@7_s*h5E#K1^}%Dd7}q}3DMp&pnNE07+-=I$pv=K1C-P=XJ;>P5~5;aZYTvw;zlYv
z&q0e2T6Fh&{sT&vi}3EKWaAz&Vk$6M_t&=DNX%|;-snVJ2YWL!JIkkikxGe(2)91m
z+ees22t36=gx#RXje+Rp=x81P)p()^qEj+dZ2L+|Gia43DGd+05*YXCu=DbwXv|;<
zmk9C#mo8>$neH!WBa0etKSDk11ET}`K3)Hufdz34BT6FxgV(Ax>z;z}YZ@nc)S}($
zN`1WQ=)-TT?mtOSKMmc_z0{k#6nYlx5!sl{t`7eWA#{i%7?8|Y9d>OGJ4_BUGc)Pt
z`CNFR!vu!_zL6}~1O3i;Va5onV?J5+{lE&Qa(qJGFmG|n4-Nr=7LDD|22qB(6EY+0
zdcYf};5Dxsuzwm*ObN*hX3rVmL<|IY2#UMvOfy|=fZ*J`RaU6HhFa1jQVlz}h^kD!
zzI*qsk|0O-mX&yN_Bg4I5J`G=s%QX!zGjySE9$Qa*8u-%b(Eiq|0yyJijE?Pga@Fk
z=+ws$|ArUpDRB_0oPjC*&JY^9!994L)U7W9)zl5q;gRgxZ7Xr+t#4YpwK$-Rc0>iL
zoP$`P*EoTPUQs*7;X%{^!;-WrnS4(hy*K??b#5Ka&b@-x6R!b3GOR6m!BdiIrxd=7
z1K_?onPm5_I9N<;@*Err%%G<nAh<x#X6p2vi&U+bpzELrT2Ycvn&;6l3CNS*h+knb
zSruda<MZDnHxm}rxVLPV9Nqfe#T`3}h$qJ2OGk$)c>mi{Z79_FEKg9iHenfh03f_c
zF4)MOy%$xV@#O2I?MzHu#EwD2Fl6fu@wcC><dG_r377QZ21iFn^IfTmxKWNCBpfLc
z%Jo3IDTUaFF#!0xc=de9-w<mFw$Ehp^;`DUF$@r?Zh1&PDS=%?Nl>qQf7!X#SF=>x
zXod#UP5PWe!or%Rr%|bFVxo0ifZTpLceZzrHi|Hm)zzU|d=QGnRIGZoYZEVre8Sng
zYHG^7^y%w=?=hiMlTd>cOnOKr>9_D6db#1O{Xc*N$2H4dgHJ35Sn0uATGdYjGm;|L
zjl44?oY_m~<X`=MyD}6u+UXS_miX3eblgY4Ex8HsVBDES{tIaDAXN$BtbvhBu;c;l
z%#<B}4jI{Yga^f(1z_0jlm-=(A5W>ewK_XHtFe<-1Cim~5FIud3Ine`*~EAlGLJV(
zfiu~5+i3n=i9oB~UA`xEW#dX8J2{DCFVe@3QDudMhnIr8>3QeG<OWjpdUZ|Bu)%T2
zxZoNNkcWZ1%olQPo6?`(A}J-+1M$@hr9m<H1#(um?$~h%f(F3qc7+V%P{O@df6$f!
z<9dJc{;KYOwrttLqh7SxYN|;KLFWi>nhE3|@_z&z5Hjm4?dG*!e}MR28@v<G-On53
z=+>NF1??Y33|T0t8gLC%$0?t=Fqwvm4HSq6{+!l+#P;;`n%_9hhg514Lrqdb%L^tb
z5X#MFQ9k;j*q#`ud-02U)0ICqLk<G|;Ji>)vFu!n8&YPTfzr6>S7$-bt5fZ-eSCZb
z820@ixDX7g>+;;x@DZ)bz>_v3*wpGYLsf-@+YdHge)90)9|+W~Gu~TXonvFsl%nh1
zp9mL&7?@&IB%E=3c2fUk@FP%SJC~BY^~BG8<bGoLL;<MaT~Wm??#9U^#S~zUxz`$(
z9O$ZCoQkO)<h%Y|M@z(DLUIy=80=*rx=l?#_zOFzR0IkhA&8%NCU9sNc-JXH(UfUU
zGvub-ed0ARju<{<<;T<S-(i=Icnzgn1V#;F#fVeMIjmLT?+OiD46FpPs38z3EpDX<
zS_G=DC6CwraXqsKcn%RT^P%7jB_TnMO;7KD+(IhG&z~=n0CPkxt_Tsd8w*H+X;YeE
zP^rT$U$qB=iL|Z%W{nQkM<`_^nGV#7608M#z-!1>BCyJVgMFjY0`_OW6CJY`c?oRx
z7uMsmBIL8li6jLJXvq+qEfg$lq<#a12hx-HMfj{IBJ`R+h(cpM1f7p}vIk`+sCRFq
z1#yVBA&{;l-(URu?+qI^1O5`z6u7OT43oYC5T;fl`qFIpfkTJR%*d>%=L5?zG29|Y
z&!xo1!a`s%jB;6)(rj$f=eSVJM3#s{jV?0hKvI3uGKkye#S4wI4px~EVj0qHJEr!f
zF=q)TAEC*q7Q<+e_N88R?>r<2P}b=D`21`DIz(xWKEw>GlLoD)&E_Vw{l3O|NP-m}
zm><oPLm?vr{9qus{?bKShSOE|{c!8=m+%_*&1&d=(-)GL!nue$c-7}EGzRSkc>tDL
zl=?ErY#X~1^Cc5|>>w-__b%aEZjTS<A?`&%KhAAgH#9hs7;n*EU0Ag<sYOCSKwyP+
zLWrWxBeXKX`7*(mX`QkUYUMId4>nZZZxQ$6NF1D`*?pqueh}o;7c%-S#xbZK-W8_e
zCI&Apj7xaBy55P%!67&af=mW)72O~T>sKvk^E!ktS{LFFxdyphU#Q~-MT`B`hls=Y
zQ~LEB`;Ee$HTSi@^{)xxG|Y7oobrjZf3}si7R+gE+!^bMdwvay0M>Pgn2{jPXk7Tt
z6c-l{z(^+x>fd;PmyVWJro(ppm6)igQDfur00ApWS|)+UsvU;{dfz@}TIF@7GJe7I
zYDw$|7%hNsD%iW46V;q_;3Rm!PcMJiYS(Q+2$H;c?O+k=kZ5c(Xd4^a)KpLHzRe!$
zk(cM-#fvl+ioi2$e+|J+=hLIVOKNIr;u<bG_OwzB;&7H!UxvnC+n!@Xn`RPExcpX=
z${zl95?SDjX>3zfQu4Q+tdmo=zZ!gl%|qZY7qg@Ii|fpL^{vKXhDqPLMFu5>*~HJA
z7tF4_+O1(}2UA0Y>;5Z*rY=xRsmG0|1rt5&F}(O`BX<NoBK(zL4L%T;Jf+oO)AMxR
zeB<d^&kkqNCQkszXsr4fJ3UyBR+j40^KI;#zpfT%jb9x@j7``nKh?hPAO9U6=Dn?I
z;bPb3MRjES>MpnkCm~Elf&g;LjROc_Q&m;<Q~hU^m&ux#tmO?0<TN9c7U*}YLn)*G
zdJB(D97Il2p}#Fhl&LB6*~C{M=KU4YpJkDA>q7(<MEg*r$0q~3b0kD?G`a!6+<^+j
zQKr(?on$$ETE4e3h})#Ef_ROPX5bBgP!zcUg~%NeB!5V`{|WtOX^>*vL|?L2oqdd*
zeW(t&Ydq9=tiL@ct7e{{E@BCp8fw~)8rWFGk6~k(OpN?Z;8b?_HF@inzyC`|K#MGQ
zCGUN@k=%I2{V*hfy4N7}GJ+fdrx#jAL2z=wA%_dX(9FdU40FN{l*k?S^RdLOhp!tI
z*W^t#>ry(Mm^H0p5D}9MJA|}B`(K#fy2Xl8d`M$yVRn<@4l2|0jy=6ZHVm?*JUe07
z-g;ko|EU|X@`>+<+H(|{th%=pEH(~g^aZ-ZDcr)yGXv8dl7I&2kxjdO&8T;9aS*xz
zA*EY8Z=@)oPwpJ?h0NlEi4RF)K2|E+S+6Da8u6CNoxuykYOqq&f;GkqL#@+*e*1r3
zm^iRVXai(7zr{=tD9&k{_HcnYtC+`YlHvdx20jSE6nO+-XzLbN1nHu%Yknc{e_S6l
z{Pq1K1&8o-tR2<;ldCySO~Z;xY=Y`i%DR>LM4Sn<f13?MRvU2%@-9zS!(r*gt;(g}
z{K4o~QOqgO>{eriJCy75Mp~`xw;v!X1hH>u3=)S41)e$7^KY+B^3nT@Ls^B<QVh?b
z7nKKcn_#|oOO5O1Os4JHo)Ux&!%^piz0kt13*k@b6UvXoXaATueq2yMKpnW9)Lf+U
zmyWpcF>>+Q)2jjeG605M6ZTa3+czY%DuLT9tf@&Yzjw`XI|w-h&{FqPtwR$dZHiyu
zt&wUQ>-y@qMClQ$371Ig=g3&7Xu}44Bid!Ry95M3;`c6lbFwrn6Dw~A_W*Cuq~$;@
zJE^>oV&#>c^xx(!B*gFe23JY=^ghbyE=Qm%gTRTkgO49Q>J}A7Ms){B>ua*zxM9O<
zB=25PRjStw8xp9G>aLDiyOCamuwA!L@Y#&!Op`o(LOL8*iGsU$M*HFy^>($7-=^j6
zTZ{<gQ9p-+%=e5%9IsX+(!L0|>e~^UzOFVQ7Ts)cRJ?ULaDNbm2UVJy8Dr{$B}zeV
zTr%O*a4VD{U=pjx_=h|Y^tYh4Qa(sf6>YS&K9X;|F+s(;pA~mjg6Y*kEu<$NixDO5
zs<#j79L9o9XuDlIrG5<+Dae}=XT~$#AlHe596TziYps5LTptR6!rOK#5?F>(cD%9(
zppmAb+@;mde)~2k*M#G2Qd&mjC&p%|k6!BP>LPH5gG{Z8E8T-!wik3_s<oB#S_Ly;
z2&g*-Qf&y^WUYz9bwlt!?*kkw4$DZlpJ6Vf=o?hHRN^2($t90tqNX}6{eUh3h{8kv
zbxn-I@dAg%jZlY>9W>_`K!MSu^j+m!D-V=?YQAS%FvKWMf~|l8UV!@a;82i+aHBK6
z>l7lS$DM*F#e~%#Od^g!CPC|+BWkGl2yo4SFR2iIss)q3X=y!y>2JZtsFS`Zr(#t&
zv{CAu|Gy(bdH$l|vo~O_*o8dsZi#1c>?<<~DkXp}oI)MhRwljzR!P^i<VpU5?sDXc
zGefbNf(1W)_hVeOV$^f$HBDE<*sbRJ!!;nRJsC)(<xo?t3~;q;bG`0=dLMqk6}Ryj
z9{sPiYei9Nl1R+kk$Uc8h+MqNU-AauVHza{<YGXkLR{8||Na{aOCS-;!~NgwM0G<{
z2t*+Q7|HLz`w`~YeDUz{RrHPvVmCRwzXe}85)2!`T@wcai{_KBVEvOAOM!Uw4J`1X
zQTUBbsf+n*=pwMN(WqPt^n-w0XJ=-*Gr91P+Udh6pxKavqEkI#j+sL#L^}=Cl%m^E
zZ@%gI)7_`<zwH!~i;=$*L1z)9y0*t>;%BhS?hy(0P=a$N?LXZ9xY}>d2WL^nE`2^R
z-)s6YFwF~nPwd#Gix(SD$cB1YLvz)Cb7dqKSw1<uCbvCQe1~6irH7l_dz_~@FdT36
znL&H#z+ZiM-@cDwLgc1QX44yu%p1X<OOuwPUc5D{cM=jP&Gc+3cb<G*YEIC*8dwBT
zFxR5W4bo>u*Mc-y=)~xtEPQapp+L*?5H4;F#ou^$egK4}3@k!vk&D=tj0O42kg=S(
zTGt$576-R<T&to8lz>LT6IxPW^1<7nlxZpoKz;!7@!cHA&dn45WFxh&u*WDZOcr$e
zBc;OC5tw=Ie?JQcBya5%NCV`)WpFj5>MLFt{!&=DA|Z*fM|)L*FwzRNx{PvzW^zBv
z@Ad?W`@+#YYHGy_pGH_<UhX+n5v2h?t~zn3fB@Jt^0j&KsoKXpTRXcR92HL_^cLx5
z#A;8tznZ1Je@D5NE?oO+99k=&ot~kl<R&hQ`6+#0Y{>_mx{|P2dIpA=LOW*HI$X98
z5I2-+aqeQolw{=*knpaZ1x_ut%lTQcDmk~vVTZ@=LTZqVq@*MvoU4;G#QiD)E2I5t
z*PK;h$uH3&6%)3=0|1s7b-R)5yx|inE}#?UfUgax?2QNxYhgo!oc;2m#S47_*bgD>
ztEG?P&em1MuLC74LGEh7A`K(|i3Sa@GTIU4a4+o1+?V*Y2*67njPH|yr%!8R6&vmc
zEF2Ini+}i@V3|SmsI*j3fJY%UZ7W!WKddOqhS`W?rXkyEJOqRlZ(UoqRk8qN9^UD4
z-YQl5#s+;eaC#&f!V=dyz)$3Fl77RM03kG_1Wyw~Em6Sn0UBljD5gq47wL_dK>VqW
zR~3e%E=^|^C686tt5bR-bX1goR>#<O!;I?zs=FjQKKC#Vm1k{jt)6!|%z2ihv?zG2
z&>TTCodZJ9m(L`u)0*HIg5{nJ2*9lfJ6%v050d}U+Fk@JwR^KyQ(Ki%fx~zwJ(;_`
zXJu~eY;(DI5pE-$^a`B6B*FbB&JYjtusFlUrA5zj^j0)UPZQ$m3bWmbuhZ_W3A7X5
z%u{BH2;oIA-*h7&KN;jg4+07#gY>{yt#hCFR2&w~W`X2s8je%er({8>E+uA$<=bV%
za)T}9o&1|>R`fyMGaLJ3SYfAyi&h9kp#TX_1_)b$=&o%N1e3ETVv9nKElj55OeJCM
z^t{I=Cr_Su0t4XgTS7Ic^o+Ax^WA>_yyrJpLPsfGILrpI)cepPYUonrc-kOZsa)Gx
zB?sF0x6B*orboG9u1km<K{g1%f<i#mXxK?T$9sSM>>bs#LZBg<Wwvu+9v<6>CPQqS
zPX?OCqhH>S!C%e77_T3db*Et6O|f0Mk@L6*q@n7`yg0;4RP!QeWT9<X>$vcU>Im};
zWSi~)i*_RsMI1I>B`us+V*m)h`PN*!EC`_GRZf{$jJ};mKNl8?!g5tNjH7jpD2}|m
z^#lAYEZ|96D?d3d@Z^2BB;Lb?&{Q-uWpGKoc3BJT;06rQI1#M?M-6F=;j<X=Z|h<!
zYN6`&Pl<2&^wVzZD2O<N)A@&C>Q%P;WaJ?!+o3zEf=Zfj!9eTJ-&v!EjlKp1#lUC$
zh-%~62VYqq8F202e?i4=QpT^taa2P*Kf$zLGHbpKPyMcE5A0W6<CpVHq4p70DZo02
zwmWEc?bqZfmAw{6;3kYK-Bzo14tI+*eI)i9%ZGZ<?Bcly8x;eO*TYQO+rG(DW^(CB
zp`HAhx%4}=N~aLG5;F3z9ZgC*s3;qOJ-xwc&$vAsBJE$lR4+*(PJk;mpJv>$<<7m?
zRxXRiEQ|QgW2864e592f#S)Lwj*L=?@r~9Ay=CtoT66e7)#~&M*Rq};PV0fO-Mmqr
zdVtrltI?SLj>=JMueVRf#C6_rE80J+W=btPMO9?DA>p=Uv@B-<^HvweGnzH3QllCZ
zmm?r97LUdIM9an|X)_Sz9Gh7J>sdFNn>^-6vMR&OZ*vKkbEmsJwB-0TIqCV8$)+qU
z6I78qVmH6306b-HZzuHV?N%;0y;G~QNqVG;nd;|Lo7*2l0GOT(GN5T<pB-9XcE?G<
zs-RaX)RJiy&2YxNEG%f<jxAuReNX7tUj@^_3KZZD!mbF_>;VprvbgzU+tp{a?LQ_V
zIExcz8`s4czGZQcaG|IY{zK-V!$TmC<E7ezNmA5Xp&5*!ovUT<@;4*Z^{uN`9i(b>
zqS|<nPT-egC%=T?q=&#{t&}tK%k9P+cedNl>-#NJ9MT9~kI1V5b(4j~xUYh-3Dq{~
z)&tMajR#B4a(TEnubg`!+NkRbiD>=bf}P4&Jx(^_NT?tt2Y9TmYy0VcUuwOh3PFB$
zkN4(JA$Z6*ric4777u^Jwbj6>*)*DFIrgJESxbWOdJOQ}6C*9EdUvb<Uv~V$fxPng
zhh;T2QbgojPsii|j9m&J+J~j{rHT3c&?3xlwdk#x?lzd`e|x3^Wcd8%+aEu-<tEI}
z&h})Mfx{wj>N+Dyr9I$T-NB6)5x)cSEK*2Utx(%ddw<onH~o0^yP-W0y_(3)(N1b7
zo!4dnEe64>o3A~bOxyY*Yh)0ni)EJlhoYdnqMdF(J(<_-4wt11Y<e-Oc|vrTCq`N6
zU(j>9fz1>FoefRc!j&1t2C+~O<pdd13<p?AkfGo-y}TBxo9ky3-SodRwc4#L)Q(m3
zS5Ykv4eZ-_cUZd-x3`*<DS$`>I1~rZ$pP8-kh&X0ZbqB68NG!foqzAL1FGMZ#w(PV
z>66x-@~^YDvWgWUXa&>@wVXAa)lgk;T4=wPYHA;z-rip78VEm>DPnk7b-)j+`cW_m
z8u-e<V)>9(QRVoNym=&-P>CR+IHo5T?sF8i5f3(uSf;n;_14(+gxfJvQFRM1Q1816
z_k^<GU*Roz4tW3wVuTbWr2uj`Urr^;;8J+?LZIctb22=!WGb_{SI&NdU<P*yA#J%m
zq@Rw`ElL_jNpM8&WD8B=K)BZ;!nE?@&X0+EwScHRfNV>V)C20*x18mkHCtJ*^;j^t
zPm~282_#!j>JXb(ZM>=~VaNNic^;gK_1cRk;p8BlJmKwo6)e_j+xP51J?e$Rvr+og
zv12#kRXK#5nLGrW5)TiLv64Mb3)ie9j#$#`*PDr2Eim^p`1<Gz{qNRmaiUH0n|@N=
zW?s$V(@1Ifi9;feuD`DJYLC&Um(_9_#5J+^;l{HP+7~@rMHkT8i8N$B!z~9ll`3h9
zMU*kVmo@T!Zw0r-bj6v`#)(1KJ-m9aVICyD6#t`#`@YNHj>85};59CVH`(XVVj`_l
z_}*b0!+dxxK9c$j2qs8awcV<Z@zBeIh8jrKC^|G?3nA`gQPfHV<P*_NyDc+?C@r9o
z?pg?=3{`os_(}S8pZA%=O6dszPPO-QPz#9w@*m*jEdM*$ICsICLmsV6*QQh6z&Z_b
zwm8yzYx|KrgEh+AYsvnnGaLNa<PO4TS6mG=f<rGqPhvAPfOB}Xs}J-yr$i&D1Nru|
z5c&ghr(cUcIx}*WwKDG5XLvg?S&N`PrKuylb9kWjVO6_#<#b;kBB~Ta{^Y_BolrUj
zs)M+v54|k0p1rf@=Sw@rqBBb8H>@1xVw5bj4ch2+y5`N8?uR;Z7C+b>86M~c*WRvE
z2L1;Q9B8bS4Zj}1AizJJzhKM_N#~T3*2jlyjR9)E(p}y^V$QJ>tyQ+bb1W>BFMAA&
zaL{PezGYb$TK#x-h(Yj#Uq%aW72`ZV{AN4;l0Ql;w2+{7M|F*ks(v?kv<Jl%v+b`3
zBy@v@*GacmS*Z4M_E8-n*77HVF<>nJ-v7;e<m*E^p_#L!&Y4@rV~~K992vXoxTXla
z2Mi}qIDNC*lfGtZ@?o)8avy_HKNl6%)ORNNqeLV|OVX~Tv&+r8@x`FhKBRlR#f_?t
zRXi2#orf~JJdYsGV=JT;0_c+gG@E@4TWVFd_W}8j96{TV*u!x~i~T1aLU`c@Ds-)>
z859NFP$b+)TcJ)oVlkyoPE`~|c5IwfRoa8B`_p!esfj(_4_@rx9(m-tjpNU{8y^KA
zm81K}MG!@&<2$_Oig^aPccd!OcBa$GxWAf}=&*HWMExM_P+ckVUJ0tyOY9n@n>CO$
z2|}{^{$PDf+&^2l-j!0VueREhIlo|hCAGo{97ur~{A79qrMsvpiF@HLYe$>TpY~?>
zte#Yc{RH?U@)QO2nqrFWx%PE&H*QR$FUw1H27xvXHkQV07i(+d&h=FJLfP)8<?r85
zK-dOWnJo;XJBZ4{4Q+J%dJM#5n~em|qg&5Ga#`Kv%Oy!!Tps;Q+aCs(4X=+3Ig0l2
z{TvxDWo+VS&dzzYY!?hcpLde<^bsT1HM8V`#Jx7~+gBd@UQ$fN!O74^djDq2kSFTJ
zjear+O}cqOWe9!*SR}KrnT`MRCu8;Gd-;9hy;qe#wx;+3vFxK--W?|gk%zdpR;ZID
zm`l5f5{c8|vy_MORl7YqLuPUs2E+79VE0{dCTS}`xxGkLaJ+@V6ihPdJt_jgW=9)>
z7eY7b^;bs%p>!-SHQbrrR8l&7yEHya5cLD^<ViS>Gr%<JNBIRTm~-6!0KSQs<?f}c
zfK`eW(mjTIKV_CPh1Ws;29bX^y&cHkK+1t+Hpn(D(mSXev)G^a5D`=31?*Z)wLxGk
zI&<;O3`?13%!lsP49bc{g1RQ`dQ+_-s5`>fbEMjIeW4}od(q9LwL?Htw<R}C8l*4!
zVD=0c;+dN(&TYAgcR1170V0;VY#}oZ`x`+#0IUZO_MRRgUx9INOfl^3vBd##>a>Tk
z;XQZ|+R1S+ZjBRfJS25MHP0@|e=nPUjPOi2@`B+bp|#)vVg~jL>*4)OGKU9Q-Xmn)
zO>aXuY)lETo*vOpuOw$?U@BnI-WJ5x$`4_zK+H%1h6<GX^VNjednDQ0W&Aikfn-NB
z-2`pZZ=L|?&ZQwMI~ZKwt98=EFf>w3x>#6XkFXfb;~~~y0@C~j-~=v)1l5Ba%!A%C
zc644lm+nAM$Dc$&Zoh_&j&-pcs|K*K?4sFX)@bf=fnFSx5_AY^MFhe)Sr%}n;g=vI
zh;y~cq*)_!mogj3uf@693S7wWbrEv`n(Xpov;FBn)*NdkEi)S6E@j)~em+>w^cvZ<
z6bz+SdeBwASQFO;GmiUDKruJl8fFly9GXu3290O6_awwGGq>R&e5qHfLYWK}Rj7C@
zYy><ZkL}ETKJy`;Y$W*9O~*Pqx1Og;2r892p)3xqhh{mn%K&x{S->se?^sD<!f1wD
zGShPGy){UA&Z+RyUGgmNVW^G;VK8L9=-btT5eRP(N|1tGYO%3(kmu{rWLXP_MFv)w
zcT;%dV5Bv-uEtTwb)KjvEMwr&lLh@Eg%UR-E(q3$2-r4uj$B|@bJ$lo$jA0$A#a8(
zP!<Z7&%b;CE{Ev99#E{Lx+xZk>k@^;5)BzoxYU=85J3_GV~<wItRQx^Vi4sXqb_SJ
z>{Z#&sN9(x!UIfqxM6C%07^_{AlH262Cdr~JQVv@VB><}4$g5wH0(6#P`ZnCAi1ox
z5}<tK4QjKBUoc-Mi-K5x#N~JbjL?@n?j5CyEd@TI$y4YKgM*QNzM4IM>lRqZ4fz&Q
z&V0h%^Yr$Xb5>g(O0Lv1SO&ma(T6Gpr~L;or9tQ0`^QkmUJbxcjE?lQS{z8dx$|Kj
zlDL0W)|;MpUvumk89$Ot*w*{=(2R{<s7Zo&A?ENl{cu>zVNdd#_Vr)Dtch|nyNvn7
zz1;0P&}gq-qkE$y^Yxduv{mz&W=c8n|J+_IEt*e+Gxj;U{adeq&zZ|R?|2Dh*!zqB
zuDYk3yS!vmU`U@~<V{rydpG>+^_}q@D)2x_LrgC>8bX`z08mUEQ<N_ZB=;beQn>OV
zk+QNx;ezr`-^{T#OFMnA=^uga$CX0!91W8_NTb=-sxwe#^{g3Tr!JoUsy1cTkgTbC
zD1XlT+jJLN0rrgS=k7_PD)p*-;QN^B1*EL>^|EmY_Pqo9(qBr75gQE5OZO*lTm>md
zY^<<p)iHR#c=gH?<$<`du`$yt4hvG*0SxSk^H%M9d!~|miz^ONW2=jx*|@O~OkbD4
zE4phf?vg=$t>j%S@pZM9HJp&$DD|HVlByZE&qV3>dJQTh#~1Jtq64%k>=0B`(U@8S
zXU}$$2j%DrG~iO{alOK{Vtch_bMx{#h!mePCw>Kbz5v?1ZrL7f!4Q|<8bEoaNmW3f
zH?DoT9Z2h<-b^b#W{jtZoGiD9rCm<}c=aXID!^E0UNa*-S&-a{jdoeILqCqwlGyyz
zpXjV)o=Ao@+8*T}Qytj>LXyYm$3;9$DEV2!z5%sn>d_F|0X7LDSkcreW?LqbybJHv
zK!|IP0q_FIo*h6bNs;#ULH~~M=fU}`XW}qbTRu3OfLt{T1RKyUfdkgbkC5esVKDM3
zdiJO3Pq&cPMBG!}x&R@&OjuKU(_dzhJoD9fDtA*C!L?-aMa{fInn8f_{6+ix_|2;w
z?KULDB%o9y-Sp8;okVjdPXOE0-N5Cwi<p*B4M{*DMaT2nq&J5G3lL8NU}*8j{iSUL
z^8kF2wz#b3;!%?-#y&Z?-mZDKVzaJ5BBpJ~QdFsQB1SE+$s-@8;$f{IKpr~og-P@w
zh2ZGQatARxudUz(>nMsAYNdFL#K=$)WBU=<;%L`qMA1=oI`*F-CZIoR<{DAxPYgCl
z7__E$eh@-U%)H9W^YY7``#^=5O&(P`43iEJyCCV*ZeuQqbwyn%6?WAXEL90a<RKkh
z=vtETDuN1F{RJBd@xDw95FvfIJol>h`sLExa_i`On^hhUU!z~{PdkWnuzDM$x93o-
zg<kGHx#EX%3KBG#`E^GdA%X$T9XO_1>Glx$XgF8i#uVKxzDMso#Cb6rB!{oujL(Aj
z4V+yY=J{Wejrd^Lp#p)7*(ogt>rbY_fP8B)jfcy2q?dB0I7@tNYD!kscI<JdDpiJe
z)&ljN>k#LpNcRe(pmpuYq)|Na7#Ow-m|?sHpT-cvvUDDd#wA5X_h%Xn+cHCeO~b*A
zwHhN<wZ(7lb(-zz>k9|>qixoK7<L09u)#^@5l%2@GFj%sNm-T1<CDdQf+9dt`8C@w
zPBuWp2fFubh=i7^G?x2)csLe2t8d+g$sthyZnHYbVJ(N^r_Agh|5BaGWk%zZ(jr9A
zC-W)Yh_D1FC^W00_<6@mX^G!#KGgWFcWGw(d3365VckuWKP-mWPzRNs472Gx<wl;M
zXupfRUPHj@n5<INdm+%m<3ZABST0z^dt=tq<Un+M)c5b-1$J2=<&rEWgDElPT@|hC
z;8?y%q}-o7=;g}JZ4q3}Vev*4*;EHSVute_{QEE)ThVau1#{BlH30Z{f<XY4O$1oM
z2xO^_m~s@Vo*o|RGbbCzle;sSH!4l$Rza;KV-RYr2|r1x`)v~lpc+(lwiY(P*ani&
zWH1_~^O!$ELC)BhJ*2fybGQOp=ncic<d@|({LV>VmzUS;LH1bNU-j-^ftm0BR=+*B
z=5LJ2fDiU>8X6DqrNs70tV0OC#KgHWDhr8wYWi%VCotd%^cWErCu!IM7#2s^V})M;
zS(^n?liTapdkIsC?k7IGxexvr$U-{JN#g->k@qXG-X+!VF07A4e>!pM6F)1lPhpCa
zG!fUyOfTFQoMbn2MHUnL5^O6;7NaVEZ`^3o6nbv0_ND=$JmRE6tRXFAH=rQzXIX9^
zCHznlG$$aT7gF;(jLL1<q{3d3mR(HEV24CWlyeaj4sbw-0c~IylPI=r0ZT_Zg-B;D
zD=1te?&goJlk%^FeiBh?{A=!}!Ije2eE2Z1fg5tL7^Z7s%RYbL{sOw1OcW#i5iola
z@|ofE{rtLubyVF_f4YdMs&=0;`rXUoSpUaAPxTg3{faZ0>fUb`BL3&re}<U-_uGCi
z&3_kUWgY%|LROaHzgK2u8U7m_{u><rn?8O|`~2@+`0ri#?_Ky`cVTBQn%m%Kj3c0y
zKyegF#1|+>7k!q`r1vFTs5*$pIHu>No)`k_A&E8)uwz-)r_Tm{-+AL`V%uag#&z5j
z69rFkp+!S+jUyi><iyA)ewujvbHvTZhYh_Jp74bcZRvB3yUd0bThx%G=g4Zd$6Hx&
z+l7UN1$7iu#56~`Mnlo!Pg*2UVi-+UQOSQ)b|Gz?Y>gtSG?ejicd#%;YA%8YL8N*^
z5*CL~7(HA&F_d79)Lyu)&U#PW1ba?qT1dy<svEA@x$D^7M<4EeJAd&auR$vtbbT*K
z%0(bi2Y<LO24y#XsR$XIF=O<0HdU4zu^oCa>3?k5G@yox>h1SmWOD0{J$sJ80C#*b
z53UT!6djp<B0fwts#T-exCzRq>1ew$JS#n)Tt5Y%BdG*68VBCQ9X>g%)DvRYym*oH
z|B-$XRKPo2HaMoV&NhMva(wveH}`^$tY;i9!)V>`;!-|L=4_GnEzFW(6<(SNu8o$H
zK$n~H3CVOnbl|01Z{THDOpST^^pTU(KPsyXivF`mn2NXwl%hMF3u35F;hQ~&Ho1X;
zeXFkb4KEsw1gwldUI_x!TQ42shQIrU7&}HW!v6@NM^=p8)5j+Q#5pI|Kf8BF5nHYq
zNbl{8jIp4o>d@F13X|Y_JeQ{~GdOZ-*byW##ZC?-++j2ckRcE^gD+#)q;PT%W?Y5w
z2*R;N-!d^Z#mjjd{8CL9oEFCf+hJrOjRvIQfDG0^{Tf0TEN~ihlc>f028aSs?sKf*
z!&L~Z&8W~Ygy(Erd@QIp9q5PyC^QcX38`GVd^rkUi3o2MYf)GceK=LoCsH#5W;7gw
zXrmywy@i`Kj10g)t4%Y8%3)Zcs+TpS7CF8QGJI+dGdJDmVB4%iQ;Iaoyywo&vLMZ5
zF@!`Cg&U7zy9hI=(wk!JDYy)J4X-%Iztm5<OTqVX-8p^`eN)$WEkh9?Yf+1xi-fC9
z8V^mqVMCF*e|?-ou-(ppU|(WlLkEo5Fl^(Ou3U*m;Y_CIO`^#=8mEWPZmE&qz~+m_
zV6NIAf0l&}>{`u3vv7q)fs;NQ>XC`rE>ZCEwAp1ED>r4iXq~bcvg#=EH}s|a$SHX9
zelXWyG_%6sOf%22|FQ7l#WFSV#Bd24=T(=5gPM{@`#vl;D-Q8(+GQ7C(b_<vSl$`+
zhesg18S_vw(O`mUfYM|m|2cGBn$QpEcM@X{g`LMg*G2J`i?d}=IHq-+BCQWzg(8kC
zo7C>OGP`PFzl*?o9M9y%UpsJ6_+e1epC>vOnmUS8mtYE%L5ZDQYb5P>5_63)L`65T
z1579;Np7C3x<D5h5fP#H_0*kDkMvX(aeC`;N0VZ+Fu*JM#;*~&Ya~AL+f3=DPIh2m
zu2c>goQiH!&)2VSTMMzXixw6ZlK<bnd$-Q5dW=h11m)P28towo1Emb!Md6EPh)b)G
zPb0sfp0Y5XC%UQLs9eAtCrL3P1J$SzI=Ey8JWve$49T^)6!NKEAIul`^cQ&Xy~$t(
ztEAdgFC`X9tUmfH`&1t-IPV-gIMhCDW$1|UiF{_TTA_)8kW6UR+0<X-IatzeCxFoi
zT6q@oil%K10h2xTMGGch{OJ>ykGpUd1_}-Ht!t#rmbG_<1h3(^!r=5WSFUez>{C16
zEL=zGiql{T25`K@BD3id7-oeez^xldD+y6?zHp^Ff;ra{nq#28)UD#c93DP-QieUW
z7G{QE`2V92CPQF`jUq$wY7|z%<QN5MT~i-6kCxgg(s_cfWWX+=UFcOUq}glwqitDo
z=#qUiz;`$wD}xE1(eRZ=L(7YV*E#}|H~oYnF5=|E>VOFq!NfCE2d^mkLx$Fvfp)_R
zpu>_(rP5r)c&LWj3jB(dk3u8Z$_0T=9Ea9Kv}uD^<q*%w5<UT;FB&Z|D?>&x!m|!`
zf=O8L$mfLC=4lneXRjXFK?1y;_=Di55#V^<coBt}Of99}v`H3J%}vr@+MfZV;H?<L
zYs`FhM-#Q$8?)?<kN7gzVn1Dnd7O9WNs5JrghYVDjRX~}dd=tPzJ|Peipfi{!v*zx
zhgo#MdWWTUfOrPEs4tUv_fj3EHkhF)S*imjjP!y&7s0Mnt(@kp(Z<Y*q>TyZ&!4Y_
zmBvF-4AV0s$atc6EyXhb+4xZZ>GnGzKQrUc%$LTV9Iw2W7<SD@c)U?^Xt<_c%`rBp
za;RzAq-7*^8}{C~IW6gkm05Ozg*_qs!;S@_k(D$7)I~~NNx^99(w&|qEmWlnqvMbi
zf2>2_RaMf?zY{Kgp70LF)X;AeKA7&^Us?nGh+}Dc9B8uvxLa_CA+C7zWWWv@36hR2
z)B{vlP$AtKG?kvpnQgPncpAJq23-Ns(A|?W4Ra>Fw0&_a>fjqm)_|es&aGaU6^`53
zL$(T|`wP8D$87B3t`3_6p?5;ie%dJv>^Rx9<jhKe@t4}ZHo~U8Q~SsWxX{p0_Ru7{
z2>5|;GDy6JjrxtCp#;^P(d<Nv#co-&B{1+U;r5c@tp)S(IN0GrdI7<B3tqt`V1hSw
zM`WTr`X|8-*S#D68fes#r83-PF{Gg7wK~SpktzjDAAUDzz$jdIP5tJq0Hu_;p|-E%
zEcwR0HcqYxjDgH+IBZ-NQ@7d7e=wVG8poBZ-04h{z+lFZ)RV){?Yv{Ef)1@xH71Dj
ziI%)I;BeKcUr>1RjqB$HFwOL*3Yww*#iW_1Peou}yXHd1{^F2hsLW{gxU*7@bzMw5
z&K{Yxh#?Yr_I9KrxjzHu2w(fL;n=ix(&?W(M<$z~E&bV35lp{kn9xZ|4VrBpNrmyU
zCJ(|GM@yRFDaBr#O)|r0%NC-^Ckr%y%hj$9fjCZDqmjwV1{~0!6!vv~a!||2mJse}
zX0IF?Lq7IdvNP<+03L(YJ%sp&u!6Ug$Zy=S1v=kz5u(JV1nsfuD{u2pv^VZ58mq)u
zMB>`y7t)<i&~je4Zrz(D{r<_0bfXIxhQ&tQJJ8-67k4w9G_XM;Ic*#;3(XpdDFk5$
zfDj!N8ouKdKWo^oFls3!x+oSXj51CY8O~=KFjx&$Mhoe;*-zODnM`WE%;MAGn97wq
zGl=Z7VA<_@B?O&WaNfZ8Esm-93X3>W#KdG`_sY4uWZDWHN``WDd-HCJ`7X7gC3njf
z(yfa7tD)Ej?%NxVh^J^Z`2X5F)2}AaG>peOQ%~nOEzD6Y0^$UhvX6!qD*_#*IF=Me
z*%wm<r69`y;>PB5MntHgRt18gSgo=YLj?`1*dwh0!K4~7hLF%g6)}(uTQCXBTsPY3
zzt9i;E}p#a^SsZ!UDxj+!L=|!X~$$D6<B0?3Th(+93SBX<k<u~NJgAp(ELf&TF*s2
zY77c4XIXDJ^h4iT9978>ACSA_=+UDN63hX8yu4tH-UD%hnHsdrHb}CFE<&kZUI$jU
zwXYxfLm?(DBcr2h)ou`xtpQ^v*Rt?LZtmLYCS<SK-I9|x#-1dIgFPFPeturfxd~xR
z$mbE(y3TvReRg09_7$=idT1K<)}*(Ynes3Jo6k8Gc{|=YO=q=PP>Wu=4?^MlUUNhh
zWRhXw;<Ji&KaqLRQ2)b!K1@6AKB{ODSZrQq9IM<KR#)m?DhZ!9?@!<^&AXxP60hI+
z$juW5la<WbOd$u8RN(~SxiiG(;d+lZ7y|F3kC!7fGDo$?d2CF%@z!#3avbt|?Ll#Z
z(3>XTBuOt`<_uy(&XiI1C0}Jp<XzdL_@v20n%9RlXZ3vI?TT2lxgavzAO&pD73!D#
zEv!dTcO6CpQd*K?nOgU_L*iD2^$M2UE%DQu)aj_z)gr9}UI^TX<O!o&9&q!3BTlF@
z5P8dyr_C9H1rheZj6F!`;qLBe=`T;Ep_??F#$TQ1TqT1U-8Rl#7FQ)2-la`D&Z<}A
zjRaX5hjG3R59COq1%^+*GzM$-Y7tcRe#kfRO#$YEdp(wB&GWs`YTUr6|5KsK`uC{G
zZ#3rRMCt9rU|GWR-Yz=V>3Y6tYqT?Ywg16QY}63PExSOXeq%env@^&;+9CaS#5EIz
zm_Sln{})UyeDc0(h3asBtj1%8trNp<CL<4A6g-9GvB!(Q4-C5=)St(Q?=>*Sk^a}_
zxC2wrTQ?*>Xn9qvnHlw~^taVxa+Dmd3Q%nM?z+f)%KD&EmfD{idDF&lZI4lI)U(Sn
zIAvGY72g=Ui1`hZ8G0;;Daa~azzFJF=&*oD;Df!;mtW3`Zux0X%e*Hm#uf_TkuU0!
z<R@<6P3En`%w=%VFhA<xkp|Wx_}Vj#!>$!@d51S2^7H0e+G40efG+7;90F%3&e%>X
z+!Dj@Dn+I3rYSC<6p-MO#KtrmC1XE<=dUFwLzkuh_wS@09)Ego6Xo?+ZpYhi9&+Ob
zN0Z_A(BZ@F1R4U?^($hSn>hsk_`u_2@<h_Bv!aN}RAqhNBW=0I$pp_dkJ7<wTD6N=
zG-6{^b|_|mzHgQc@1I%tXNDO2m_b_RoT;=MdW>4w`QRl6dU;{%t^%|r#KWY=5hUOJ
z>kUeok%MRQnsE<!)Y@tzl9p*xCu3ybCk4tn?0M0ZX8|80YP5>c6+mn(C^5}UPeJF+
z1}C(n?AOOWmEr<S9vwL3)gWCTGRjqiCBaOL<jfBQ5emQ71A{G(+W`Ad6~eedVB+r~
z7%Fy6bfVpZlZ$LZwEVt<QZs>vIQW9mm|a`Hn<L3rcP|!YZk~)8*3}M-@qCRfzL80<
zrVWUY++lFF%!1}##3P;@?#u`uko>^-F)n=L$7KlgMVZP-VtODIlcw-o106sLKo+@L
z@eZM1rKv_jsSJ*Ea>6jX>l|^Wh=Xx>xkKTdp6Pu~yqjlIoH?A{IK_Tpr$rRBNm~FJ
zjd<sEAEa6dhDkUr9G&_*Yx{;uTm?@w{gNn&C8Pv3q~FGzbk~R;e$=_UX_&J+TYhTG
zxOdiAfJFJ?LpiFj74RD%e39gWIs-tt)gbcK-n`J1?ABmd7kNUXwGj8^X1IF__Wkk|
zM@t4+CAy4~+kFdl;`~m|l5rfnN)y#z5);S9=J6Zy)l=q68T^xs4m|z-&#(ngAPpkN
z74YRHkM*dYH<1C5$;3qc>Y=*^NTyaJwM96DP&-O*-bYb0Q;w?Cb~^-pwFbHz2Z}bI
zZQHgLa7M|;I4G+?61-=`yB@`n%kx~TXpAr~m$GIceyW*{c|u-G+`qDbeDSS@7UQO4
zmpJu}#+|PnoE=ZSjFIQL%;b>oMnB9>QQNH6i7kSpyQXwivuqrH*g#v5bP^p$p853d
z)V@T(nB|;f!{#?xlaA3EH=TgxgG$h@y2Vfl4-@(TfMSd}NZc+;*oTw&NiND>SN`{l
zjg7Uk>o(kfc`NpRf3;WjGUQ5QdSx*V;*Ye1EcRrJvf=eA)?^&0gYGVL;hK_${H9Ts
z3*+f~ew`gq)*+3B-Mt)n4etXo#6ud#mOvtha?BsQ+ffL0sRgFW&=VolZghuhhDZoI
zaPkE~Vd94Z${!7c;^InRdg20SuZotjCTfZJ2tjuMF7ZGhb$lD<=fz8wltGXOl{}pI
zEFb0Uv^MK<BNC$kyo(()+s`nJ`_WcyRNw>oZ~}`Hc_baEdb!{t8w=TffQNq#f4>1z
zpw2JUsAHiaKqmt%`nM<g@|-L2*1v`XvK*I&RHA+qKiG_nh&}PanYVUzJzpy`V$F&l
zC*cB(vwVIPo(CKWB-x>WSNg+${g$a8;-8DVHF%%Uo@R6bbk_xy2?-_93n|&7yq?&r
zs?zotOiWYJ%R&MQ%tF%B7db6lo3K5`Vw1?7PA}<~RQxP_QDH27^UZPy6L%MHqO7qJ
zI#s)f#%pM2oG6CSyg~&Pij_xJoYf@sS=5PuJ-^~Zb=MaeqAy^I(cvq*Ca=%JPCK5s
zI!FLu$O!)l_lnknd3dhSXs%Y&3Q`o@hnAZxGr|}Dzsi(n3Nt-wCt2RU3gyS`dHvfC
ztgNP#7qw&heV1$~Fv4gpE766(u^IRbdnJ&#_5-cAZjHuS*G&|Ws!M;qKAjO-&@{i2
zk92b@)x07h2_y~6Bipe>9>BE6kDo^Or(%43JWj2Jq#l)9QI|bvS?jZA(uET!Bfo<6
z;;w4l*r-n%6p!Q#6h^W^2)6jQ%`3%J*i8hK`C3WGAoz+Csy9IU3lWxNd=_P7*pO$P
zN3zi*R^5E>uixIu8yN^p4xRNje6xp}n?t2wBY<{7fPG@IS?y3B+m4Bz*2788PT6RC
z3Hy7mv>vfF4hr-?29x*<2P4WOz&HGn6%Rd=cB$|1<`vNU)L4Dgu$xmC9TAqYuq}Q@
zzP&0&s*-F#0b#f{5FD=_V5M<SqktGP&ujWaFt_M5WUyjk0>lB`uupBjv*FuhokxOt
z4XMw1n&;lz&?{9)OH<)?xQ?IMg=7|(%3T3z&}Z)`&Cv1IXHM0Fj2T2kRcuCRuYAus
zMXZ+@sJKOcbO(|OJ2X4s&kBoIHHWyvyt6lYr!s;rY$Es}{4>>fopWt2$SRK@BA<ao
ztTA)CQEm~vGwZbqFbjxS8>58Rq5{9T5)$K(sc(jJjuP_eE|0YtT}vOTkYP})U0ws9
zNi6c{XAtEO<P`_w7Do`30;+dL;HP!FWFtwPTa+rjNo+^+y_I<C=PCB@UU}K^x`ck|
zv%9Xn{!r?Gda0x$jcU?ZFb!it40>17#4Yml7P+G-gl5iXk>|v!gK;6WJj@Gor2g~P
zW@eWmyTan2or1;5iKo@Eo?D&Nh_G6#E4(c4yzBAZMxLl(_tsLK<=64k>3h{l_wQjP
zBa_M)9i}NYIAvoY{;;#No2%2Qv$5s$s*3aHm*envkfwFqm_Q`Sdz9IEfqGm{PS%VU
zS6F-?T#3IiUxO}XVSb40LVx3fB(}ysIE%2gwr{<JxPm#lZ`o+#=eYau{3ZOSn{FO0
z;PWX$`&ynd-cO2nwr<tITZZ|JMT>rwcodqvXv6=0kK&7w)bBS&&b^1<9Apt{q?ee?
i-yQ&x@k96Q{MF_E>3{Xedu{akw!H7_CD{1UC;tO;9oIzw

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/transform.png b/latest/assets/images/social/reference/API/trestle/tasks/transform.png
new file mode 100644
index 0000000000000000000000000000000000000000..19bd6fb7263e798d09b13d04b00c2da13c6b8362
GIT binary patch
literal 29589
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
Dk1MJ2

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/xccdf_result_to_oscal_ar.png b/latest/assets/images/social/reference/API/trestle/tasks/xccdf_result_to_oscal_ar.png
new file mode 100644
index 0000000000000000000000000000000000000000..2bf764edc807ef91754120f422359869f7a951d1
GIT binary patch
literal 32023
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
Gr~Uz}?G=Rp

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/xlsx_helper.png b/latest/assets/images/social/reference/API/trestle/tasks/xlsx_helper.png
new file mode 100644
index 0000000000000000000000000000000000000000..59f321ada104bef1ef2e5895784f9672f11fc4d8
GIT binary patch
literal 30294
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
RXG&j=z3n!e%#9u={sRv{?D_xz

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_cd.png b/latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_cd.png
new file mode 100644
index 0000000000000000000000000000000000000000..a77c07e5b47c3bdd549c65720c28157918ba4ab4
GIT binary patch
literal 30711
zcmeFZby(L~_ce?<=!i8I7J{NkqoRVe0iqxvoq|e9cb5rRU=Y%xgf!9(iVD(_(jq0@
zApNd`&hL7j_s{ov{&}x!=9+tk@dm!1&pG?-z4lsbp9fbYMK@9HrJ|sq*mUWlunYyo
zUx^eHtF8ZDi$9S%<Df=CVUu@B_^h05;83fL<BqzyUt^3<?mfR(wO(e8Z<|BWBl=vX
z11u5=R9qbD($YCBEUWuJ-MP3misjYo1MW)yJf%J`$+4<0XtJ$hWJ_Kn-F5CS74^vh
zmGe{f>PNo?@$~xf=;~UBlvT{RyKlos;;%EZdBc*wzocOLo09GKmp7lRrvCj^%7s-M
zet)I%<`(7eui~T&R<C?@tDfoFs+F(K80^5CkiTA?qEh<(Rn^}Ae%*g-w-O8g*8^pt
zHRyMcjc&Ys`}Vef{yE_6>`YJpJSd3W&(H69aPV+X+4rG;qw|rYqhpwSj6!w%RX)AO
zr107pMX3*kg$$=pD+vp4+rGW~$EQc;KR&L1@bKaDAU+#0IXN$;@RmTHoF|^{$6|iJ
z!6hZ7mm6tLU!irHl-6s>c<04&wJCb)$B!Rf-{0R&y7qqc>{t;U0~c3)=7ZP8-)WVq
zB(=1{n8L?D7TjLL&Y_y5bxH5*>-)8_$~CE%R&UnQs#t^HTft>JdTn+ny<O}59m?uV
z3*DGUiuCm1;=Vo{SF?&=i#+OT&~WiyM{8SP_u%!#&|BJP@Dz{t^C>7KsI%)<1U~EP
z(z+xr{-V_PXlX?dpZ4d+d#Y0n6m24vwI&A}W${Oh4%36rY9ggdn^FzJmEPSLmMo2#
z8ftEct-4|2IQo9waNEj}r<aLW<MHFOiH}u!cTOeEP|wC8P9^oZN#5)QoyuT#?NT4B
zGp<Y}OxKj(S5`_Lkql%apWc|PE55w67;Zn+FY{V>{rZg?y~Mm(E(LHIb<OsM_(}wD
zUBXhHS07~hwlF&pe%X&RVtJ;oMl{&=$9is^zsSM{Gt<+bQ;1h%mJ*x|`!&ZKFZX?5
zfK{`|!+RueUXq@ko~EATAuW~CeJ1&6uZ8i_qnuX#a_iTxf2SYh!>(H5v7fK&T@kH?
zxwVMml`Bv0xw!=hRIJ*{OTPP4O!=KVcUpq>;$yBINw=*F7vB{*^)*hFTRGF5A*Auz
z2`VMZ(TRx{buo(KGsCT$680gELR^-3X5N`SPf0o1m}=nL*y*w~8@VrOCCydJMO@ya
zoM9Sz(x|Dn&*_v=lN>dh($n66lebb4k+&+y!YnWJ3YF7(K6&DukiVodJ<@)ZnVDH8
z(_A~VH`t*oZ+>_?9UWbbd0t)~r_HchV~XC3kDoqe9-DaG5$Z<!yi#!fGOtzt;dk%e
zjelVbDUOzpX$kUCeDwISm%~UdcYAM$eLr*N^3wbSKlRR?3<){oVtE6B0uJ@pXUQWb
z277vXUJl}w=d~FgOcKnt?4y^Bxcn?K#975lhGSq?+u5x>((i7Fczbz;4e!{qCyGVx
z?KQKY`QdD-@bGZIxD$5cTInX9j3Nl$MnRg>rmvbO=&3wC1?P$l2kR3wMy7Mr_J@mk
zb2e`gW8S%AhnAUL5C7SJ{=(lK9=6|auamR3PWv<yU*YBL9lmzc-md8(Mt;^`RM!Q`
zo-->aX$2SIz-brUT4g@ebn4N-%9a{6olGur+d?<&MYFQbi6S>|zP;>!@=GYUVY*L9
zNC^45fBy0s`j$1U8e0S=pEhb@pEA{Q?NbY;sM%Gtrj-z`VG407v+<q1y^QDGHhb@6
zRVa><jXcc2AW~gj-Sy%Ah9u`jd%t7X@7%k8zdJiGeBT9=mW;2HEsu`oF*T<dy%=an
z5LZ$059G19khd@{u7^Jhw#ND&K_tf0@Y`O&VLyE8l)Pk!Ap4_TM}2h4{gqp1aIQpz
z!(5h^#tXLy731h077(}^e>MAvYPzxaE_K`Yv8Qi7DlWd5oVOvXSE<l-Q}+|@wx>hQ
z>7}z1y$tx?ZQHhWeSEMz$+AzT4+r)3x)B^Fzo~S`S@W%1qttV=a%S2bl3bRZA0VVA
zCoMBgJMK76lyfU+c#y1O*W;(FHPn=9K0T;>>C&ZVVPS`PoaR!<Ii__SJv%lrk!-(A
zk^%KmbvBp9Dc{44jN<zG(Sdw6lJ&95hcrJw{@U;Q!>8x#^iZ=%SG^~FtV*g_yhc8U
znVH!*a$0Y*$Dy=Lq>k~b^IN{yv^z0IN`?5~V`>&!(~JUg5R27em$p9|pcQmf@{)P}
z^5xC3+1gsUn(3**#+ru$vd5(MY9cg$YFE8FTb*NPkv`R)q%FSZ*tJ{Db8fok^V-+4
zL=aMJ>OJ3ZLSyQ2bWW+-AVR2pjcVUM<Fy`C3iVYwa`^CDv(C@ThK1D)-Z)hWSolZ|
zwT!1G0m%6MI4g4WuW9YNwtByO`En$wv9VFV?B#KVDW`>BW~o@w)#<&1jmgn=6Ft=F
zMNJ8^%Gqj-N!oSDv2v1<lDB!7!)uXD<Pb(|J@N_a0?FMj^F!RHj9X4W(%7HdT6#2J
z?R(%Je%r(>`zig<+5J4`!l(4A!wS++Na~P^sEh_$GA;Utvq!9d8Whzh{G;M8D(XQa
z?KD4qsySU~Vf1cITISVk>waVfmX!VBUUNuh@)s{&44&FTCumrgCB|HrtSeP$q3m}2
z$lrGk;BS7Rg~i3Xp7MY==aGIkWK|gyIpcP^dqww}w^wo4PyW0<_Q|T(t#08pwugm@
ziAhSyUV3_<L5hKqai9HdWUgMFA*H#|kf%>yA<U?ZjvhL6K6kD^M!{)>hm}=4_2$>t
zRe5n%ou4<!XImR351DDLiZN_V>PO9T9Y+cYj8@A`Qg-p7Qrfd;k3y>7ix)3UR!uhQ
zhNMPk_^=8Jsv`x~-cV&%Nx7mJul6o04)IwRDMja&YfYnE@bJ;2WTlNuSdze`^8I|)
zCl~Bnl65^<q+j2Q+N8K6u|?oBNgQYYxz{TiqYxK6m-EwbY-~&?<oJ5}{O_#ysB7O!
z7Y@G5$T)rJ;>AS$#mA2~qS%#g$KKlcL@C7ivt7-S6Z2xa&Xit6=c1-=-xq$)cf;n*
zKHtB8#}|M9{ghcYLTM^jS4c>RoO^jYl{a`hPKRkjw^ZFPy&*2fV*~2GM>Tw~Ny;=e
zIO`=yvbyr~t5&U2VDIhh)HG|sDzMR^<_BveuwA}*(Va~rPi<jwV#)pHm*))K0Va9R
z9`0mSX;pZ4<C7NtL?&EpXH0{ccU9FD=BrsLjh)KM$`LMn`T>gz3*`UTNhrE^?=R(S
z>$q68Oqr#*fuqT3Dk(P)qS8k6E%R9qKHapBt2ja;fNeV0tn)%+;`O_R-xALnw`5$m
zs>sYSdW;15ofhdMy?^3$^8I`FF3wL6wFa%_cW;ilnf2-3`t4;bg}Rl&RyXPL7sekc
z(|!5!MIYxg`qGOd(UL*D{T*&}3XD?0DH&?sEb^C)x@~sKA?ev8p~#o|u*-LTeo|Nb
z?9he<u?~c@yxZpea(CBmss+YjclKuC;^L~b?rN|>{#f}5#H3tnmQ~%;gXe3<I*Zsj
znzO71_>Fk`sbcq@(pSn!>O%ri6ciK`>#DCa*Ki!W-^kh5*T-`D^l2#<pZJ23)_MS(
ztEq;KGN<%wFXGiN2c0(i@WUJ%VAs@=ZIjSwj%=f_MQ9;0`f7HXenWha|8Y&%l9Ccm
zRpXykp>|FFJQfj+oLJ@lAe%O63ICJQ_$_j8L_O0^uM=GQrRi2?AgX@bDzYW!ul%`w
zRyPxibmP{tU?Im}iBualoM7+l?0ge(+3!YL%aeWFmnWhUhu+O7{%y5ebL9yB{UN!q
zs7RDuJ?Gnxd3hTp)c(eKy*tH>Ey1^}kLy(*PTnPNX_->kWKtdW;L|Q+Pg;R8A9jtr
z9CCOXlgO^>`7H>tsm@X0ZA>1O<{_Eul&0PM`r${CO{<k+s1uM!^N%#OEXyy3jeJ5%
ze9^Z~X%+vI-23MB>#`<hf@4Z`M;1y#!dEMxw$AkmE$h|mEY3}_Q&;xa#ptR;SoBut
zR5BtxB7Rj)G4495ZfKteti^KbRGpz8wk04{K3PY?`}y-5^&>%_PN{zQN*N2_c<TCx
zzvSaoPIV6q#2|)s=2#LAr4tm(ZJ^tfqNg+T7bRsB3SBg-Vtm&F^X?MmRDtOoiI#i*
zXK4-{J682$UdpC1&ncT~<3`JQ=Yx}5^3MHS>*LHkLXfM5%VOQ&7z%4C-$;(;^siTE
z?@|rv;^B2X7l9C|eHXi4NR`nxW1~^0{RGsp6X)iaIz5HTXtSLcvyj0H2gj_3nszn?
zv*#^Nt0Fyo*^V5|smj63{N+bOVF`}!O*)_@>h!5^?=;P4$F-A-5Xc5|Gr2Qu2Ga|Q
z8cqzol_A^?E!B$bCd=BT>bdrQi$7ZYPUy0E479r}v&SeVR7@zDnkK5c+&(Nspu-ly
zUuOt*=HcOa{_NTHxu(cN={y`96^21>bk5%f8@Ow#tHXeFWuj!l`LCBYta>tDe;hsh
zEd$EG{<>&un~_~}Z2guk>2vjLOijSd*P?F9#ws0mOErmdAD^fc>djv86k57Dt%Q{*
zAHJ>i1l9DCloYqa!t^{<>o79Dj_1y!>Mf@EnQS}j_Hr5Cv~cjap;tB};I5wU+&cKK
zdFCqKu{^jP3;!wY#*G_c#;sX0`OZ$Vk9QycFzJYMSyn$g)u4ewP;|qg$diuSAy%&@
zg4)+A633%!KJZYw9k9srz`(%XOp^EVoaVJEg9XNs9!kz{5%7w<`BT4*_cQ9YDLc|9
z`>=~Q>*2$~3kwS^NH({|s4i~3)~Ej%>5eDXNt|0&5Wq37R3p<|<oSyi;mC9mMXOh@
z4%4rT9-nD<;bS{$uqU(QR}fn_!7S^Mn#;;AJ5;k=nH}%$UYZ~A9d6AQN1_Qsm~Eq>
z8LSt}4`<Cm6XZ2A?i0VQl*DOrQLy9qB|E_4xQgECm_q*B*cC1=h0jm+G5$_1s6$VI
z2461G?cdKX?#tngO%^jWjNRnd9Kqyq94|xB^@ECSL%e#f{<IQWslta!HqM(aejML<
zCS6=YA~kw{D`2p)W6Lwj56!c4b0x^{%%s!dvFIsAk_)?D=qiIAAYCKE-r+2#Z+J|n
zp;77Er%(UMZZ>5QHJP|Wxj_qQ>Av&+L_{qo76m`~cygq@eV8Uzen-)6Jc5TWy3_{`
z9t=ws9zJ;RY*KPE$=?)|Y#Uy`e$6ImJfzs_LBm6jkNvWJrp3auZ}!(O+hi*$)(grk
zqg`zqink7CMwhrRP|4dkJC#cNuqo4<<czs`F-d>;F@ZXb?w3Q1IdW3tA92Pf1qEjU
zn#3+$ddIzgY-%dD@b-zc*=Cb`Z=~nq471L|oSdBP3B3<mSk^i%FV0YpX!mRsF<U7z
zwt!WX&J%@o*oCfIlg<K%(Vgcupb#DW`t_?!w)GId=S+W{xb<+0^7pJ%g9abK{g(pH
zV?RV{@)NFR>r6YA`=6RHnuyOH=43Tx4rgl%5wqF4b*qjif>Qj#1=qs){+dWn{_)~N
zcC@8mzC1&mXb|8{;A<39qF&9BzNXZeLJKDMa8@T4#dt$mRiB<(I+ulm`HRy5bw-2V
z-W5jVwSH1=MijH1(5>(y+uc_k9*#3in(4mg^n{c8wM>;sz)j<A4kMXeJwN|_J1i7w
z`GNA|vSqhEQ=Kuk`rLcgmX1nkRw>QUZ($~XxqRXqQcCyTErLv=1I{QZTn>Xsxpu=E
zDHgqw0I+9*we4qy*)4j?-hI;{sh^e){d}HAQH?UPdO0m0ij3?W&hN`cO*+TX+m{1R
ze`Q|Wld4-uOQ3#mQB#@`tA_Jzcw-U@-gvjKMo(sD2bz{He94tM^>MpYmvW@=gKeDX
zkQlY%*NGZi<l0Y-F9@--OH>5%90Ej7GH&HnPB#w9882ZS|9*E%2@;;SE{*>wgCn7#
zq0|YnmSL|?ubgB4aIe9(T-6I6G=0Nz!d>;;uUf{Q?6#%NlX~u%Y0>My$f@z^;ZAM*
zZ+7X%`H{BV?oYckPC7W^5A5=44ElDh1Jqzexj*5+fAXZ<5ea{-Y1^~;DmOQXy4)X~
zPPp7dwP}+#n%s)Pu{hOq-joqF6!l{chR7>Ao(STL*qfl|=g+cT<vHQ_%QQ;q-Rs8A
z#rYZE(DQC3Yqs!TdkFO4AFP45X>4c(zSm_jRo=FHH&a61Ty)K_P>-QUOV8W4Ogz?u
zFPS&*=hYgc)niqNeTtp&7jW)<*=@5rt@lX(pB<(Fm@@szu4lNDj_&BQXU~Qu*U$=Y
z_0cTxVlH{UVHd|+<in_~hc3Lur$?ho##jy1M+FAbBx`TqwoR_P#Jjv{r4ac@T)r%K
zG<Wj3e$}hn(b8{R?a}7eK072@<|8gHF5A)35s`*kpnbgZ)vE)Kn!SB|bkYWghFWQH
zfRC%D0rKCU4)XVpR(Dyns!P$6C8-RI!_icecELxbTxc+)LhyJxrC^t;*wR1v%%d`v
z2YWtzD1*}yq3zFY5)Zn^=y(E>Pj_De>X%MwONQB@_Ss}~g~{C`AQt#b2V1in4E?q<
zO1^!6cU=sQ_giexTVHkiOAJSj__NQT(DvvVjQ#jTo!*JkERST%SssI)FXq8^M*q*&
z6Fue8h_uai<&KkIMRgVvH1hMRrXE*ZM^?kOlr_ENHVIZ<Hfl;a?y#t(rS<kXgSdaU
z56WYG572|0FUM6mf)>$=ZmP7~|M?~9VE(={x-dF3qZq(#lJ={u+MCO$DU6hmJfXim
z*QYbSGWzSUzuvZH+cZzzq2VzP`;@ki+c;K6M#fOz;>X7ac1_jqZfVDj<S)0yN{Q}F
zJaYNvQ<HpdlQubkTFRd3pKm;S`YQKO#-jK|#m2_2o=EJfjgr;rR0Z2&)$xI{&<I@}
zemow1)R1#|M%JzFw?@O&;g3G8o<zo~#UZJ!4i~Qjmk@<CT<$YFH;};IqZ4)7F1tb9
zp?oy3;riqCzk%S0yY!n2jgxuR&n`UP-7&p*##VB4=ZDo=Iyz!F`G#3x$NBhFNhuQd
zVSD#$0YRmO_QlmiAzkasHa|h9tPV%2&S;H;Ijx@_?dnDgWu-EotXt{x^XJV+mEO#<
zN7^-xlxYuas(bPclu*v-hYhZI6Z`k=V+BSyk-e^|yVN&aDnt<Vac7|&T7vh3tjWOz
z(#;EKV^kLG4NyqKP1^G~aj^PYGLst<el0G}v~xNy*ghIMdNr%oRPsLaL(Pq-KfOw+
z`re;ZV>1ZP8LOV#WVBc~aixGo7?sj;r0r^()6CTv6aPE}S6^+^i?TqT<brMjzWUm7
zvjh3<lB&4S2Wn%3IFVdEGv2qlEYE8s&rh`sqqlwTvNRDQxj0)7gh_s25J|Y8o6um(
z^X<!Jv?gFdlVwUff$@A0(8>$mnS3G_E{H`+2C=odT@vm>?@3q!<z$^F@=hTjV_Y}x
zp_h%6Jmr-vNt0ThtW*9Rgy@-y5FrzJK7;z$XNcimKI0JQxu^vo358T`VQCsdIGk2@
zbj$$`W~f~Bzsi8!X|wCy&pup8S@~nSw1A(1H0~&YwUt84vFMD#!Ar@b70Pm)O?vqF
zvD^urvMV^er&{7cK#?3ihv1MHiinJiA)pvA>aDMav$Fi#D+k-B_K)rSz#<>5q*jm4
ze=Tq`$e}1~bPT|G6q;hvVy9}CQWHL5=kDDvN2X8rv);?x`p-YFE<D*A?z}XsYc<s`
z@9pOo1vFO+1XzdCBY)=1Eq$z)vMQJzyJ4fQ#|i(m(K3kp$Vmw;rl_EaBy9$&yEGWl
z{$FFA`Z(Xwh?0_qhK7E-x>)5CQz&~;;IyNGa--2e@7%uqjR&njG*H89EUe5=#mUF6
zG5P0yJ~rY&U%pq+F=MVLz@!#QK~7CAu%x*73b%2~6(p#B@LO`o>uD@>E-o%pgUOZA
zM$Kta=+4PggD{FuGj5GWJv6fA7&!KCXFqcfgrvWK14zLi6(<eq*}Bnit&oC_OCxl*
zB#=27fQ58C(YCbov({tZC@6-dfw5)*MZ*B%IQmR#A|%X#PQ($Q;&XRrKn<*X+YagD
z$B&PH)Aamud(FDQwuYs}`EHHnxm}-Fzuo(zUx|Dp)%5l{+Nb3K+<bAK=<!IUIe@0p
zT7_=Z_>XGE^uzp-63RI9=(^0uB^4DuV75!q^D?Wy=lJt2w_0-SWP?Gz?%~vO7Zwp|
zY;6N()gJx+etfb<O8oNW$7?u+r9VrwT;FB<V>5Zawn)pq>gs$K7rViCMPcZ_w^38;
z)Y+p~G5=n$N;&b`?O5gH3m_E(1DGCeq*6-U@LMk{4#ATBwQk)b{Hv?0%Uwpy+}!*y
z;uk53ft9tim6;ldU7<S7NcDdeGf<L+g@1H*{=dYGl3)RcmO!%(q`*(0?vZ^zHZ&+g
z5F!6sq3f8$q*=ah`lHna9tO%M@bmrq_s{+PS<tON_wqW7zH1wDQA2`;F9N9qG-p?d
zH>-JHHAALl-*dtxmi|z<cI_4NxqHG$9N)I?uC9wZIuT)!k=Z;aEP!rgQuXE0E<Kcs
zS5wAGIgGj~10tFky)yXNOCWr`*py{J*oWDU{Q!x`gahUUs>CMJlkZnH-wH2Gk>iau
zx##LChHkAdI{Z!-b-Hm|4l^Mna~)>LtC9jh9_vy2EwgYOJoZQOc$00kv>aCbwa?HT
zTtuN`faU-gaEJ&kC}S#hlEZaMRa+E)i<#dK12_>nHRhor<pWPo-$SAv#U!7D5Kh7w
z&a@qSjkM3pBwI;@C;4c(XMo5Ti#+y+gP^Q_b#{&0U@vf@IMUBu&iik!{8mc~F44#r
zWXYa8cW1CERUBOUQ9?Q+!(5V-^f*6X^#o}q#kf_45Kc3#HY;DBJ9mzzX&oh-(;vmP
z;8Gxd$5s3epqtB}yBQ1`;=Q4kTmm&vGiSkolNp7=Jvr2@xOOuQ(^P+*h3(gV>m7-c
zB7byTMl+FB1J)>@NuZZzan!W{)3@!~)%)CeKRX-S<+-VW75W@CRoQ6^tAlhw^{#(o
z<6|9VY;zF5oebnDmUhR9CxIYqx)+;Y1CwxC{=Bm1_>FtD@mHI>7iIs~p9-RkRRcZv
z3_<$^q>?ryBjeIH2XG>Nk86G|zO`yi82U)#(z~mD^8QG6-w*TdNHk|Se7HEh-I<l-
zcCP!e$cm*Fl>&@+*KGmCcg-g9{3>zHKgZK_TM(5}CP+>#q(GvaTm&tnYW}N8Xz5_3
zz)av{8lLJXZf)*||J!F!Cz@Z)vb-d?I4SD~c!MKe!{7umR{=uWAxJT?h}K31r@d!a
ziEI3iPM)ET4nGHy$v7IRFQ7C6+uHF@E%eiz+9f;KA1PMt`?F#X6Uj4^S9nCt{v2?F
zH)l~LRsRe0#%|Juf#>7RaoVxzf6@?+CxH#)^CS7CqaB4fv6aJIi;IieUB%Cmt{1M|
z1C(^WN%-r(yXjsW7ZXl8z=_^U-_cRifM#;W%0h%R2;C3(ZK`&MDd}GwlqgSo1ng5{
zRnsN2tcUb%7qQD<Q2*H8TzF!B&YCIu-|svD?amvmmUOVok{#N0Cd=7dw<u;SU6u~v
z{QCgsWFI)cgW=!YD01-NK~Bxj8~u>zSJV|XKTd6};g-zt{N+U{M6ue-gAb|x7z19N
zS)Oai*8;-cwsq_EX*D25ZT!bL;9S<h6FYYP`K4z<hx6u*2~%qMv+Dh%63&-4zO@?q
z-3)^({rmRT^($3?qVfvpdPsWVeQSpRz6c+i#lyOT^52K6Bk2Yl){d>u5N4S?`~K%6
zZXMha|6RXj&3`KW%1ZuUSLy$arvLBmkXzel=f=M_%N|ph8@I9f?K-h#4fld%`anjE
zR57r#j!sVhmbUf~&+g%;-rfw*2#6T~4Bl(6ZTSA8qDL|%t$puT(`~)3weq&6t8p6E
zZ{AF;p`o#!it0I-62i8U>H=oS>!^l0i$W|DDN|803}Exf@q*~E_Y*sxwvJ8-)Vq~R
z3&Jtey!#>e+e@I8SV)EZ_DzYDjX&Bvgk)sfXCFTbKUCWL`WEE@Pr%+UC?p%>k|8DS
zfyQdFZS})rNZnt`%1)+8+S_M=dF5d~R6x_aiNZ9t<%a^4s&Hic>enJ0NXZu#7A7ns
zFhVw;2s`?_m4e*$<wcUsh<anXNk|~Cl^Ag3VGa&S&~dFn^n=1YyH?&>0zB&_8JXv5
zIkwW9Y5AF;yKLL~3~Ghmx5Uts#w|*a+n9hCeQ;<l0)9Gdw|)Vtj?}yb^rcBg&0IW|
zKcCVF*vkQHv<B@B{1<BZ1F!fJT@!d*8%H0xm>%8YGZbYpQX7#`)Lqt$4-OhO<~pQ9
zhY@j}?cPPc2IR=#W6${4eZ+qm^^HJzk_E*fxzr|TXpm|KmBt(8=@ANLwydRlY%CjL
z0%EUbE09VEk~8wAyzsx3@-8VJ#1qk55j0-GH&Wbc)6P!FUFXHQOCTazgMuY)XliPs
z`i+-!w-d=F!)@ok<%b>1MzT$k^^gh>qz7o#bFQ2Bvw$P8ve8%IabCzE8Y~fQA9#3J
z+wfNX`}8?gUtTbFgL?HPQa*WXD6G%W4rKDNKf=;5q9gD||6l6Os@M{=`D9nCjV-Z)
zP`q-_MjVy-oe)K8W&uB(G1#8p-pcHU4oZsFVemL%!^(pAe1Gg57g-fUvHi&9f5N>&
zUve4wXV<vyy1w~`b=f)!3bsy~^-7H374v@m*g$^d@jmW~IE}CK0}1(EU<zK4ln*hS
z;rQ{dMwtaC{-Bdre?wz?N(i)u_^aCewNd61JrcfCPWY!C&`3Dc?D4+Hknu-%692Vz
zJ$wap{v{?Mj|G}W!oq0b7Riwj5adsRi%WrbyT-dqB}cZj-TxmfPDp0ZsGRnbH)pZ8
z``ea4gK4AQaYFInG5vn4uvzr$ncqO=7Ci?bFR5aL19hD3_QiQNvI&6FlZ1|%w3ckj
zNgodyz5a<qwG!LlwCZF4*1U)s2uP-7!H2G5<-gEmF@TRT``@ZzxEGsB%0<H9fuG>Y
zSwaYeDJG~V*^b>{)N*_M@XvD}vjAN0YtPSj{MF(1+|N(>=QyZQQtpU`O~Y$hOu6SZ
zQ|O<EU=zbS5)a6Dt*q1~Lqo&7(oY{h7QZ~M*>!)H`coj<T{`Zs@BI1QOjWxy91m{c
zAH9VmTQZmlHoy+_l2*ru`^Lo^MJWH^h%0Z=xQK!6*9HX_QIuxXe1seZ9I4Es$9Jq>
zf`zX_I>*+muOT6168bMu6bUW`xD~@;f=@zzda&^j_=XCL@9z}B;f3SpSJFv+te;%0
zlC+pF2Rq;}^;TjjBH0UkDzQ&!Aski?y?K{=p?RXbu<$+0fqDr-FHQ|K_>wFEelQ%E
zT?Purm*V25kp43v-Kga`D!+d7rW+_`+nznl($dn;y}i4KB}VOo`STw>CqIampSZGs
z0uF-dlF4(lgFz&Wv;m~kfztx#vm5-(Hn92YHq)$_CJ<Y#OEo1l8(KV%-^zV?zKV1N
zDS9;*U|M1(pasxG90~dG$&<B{&PQPWAT1G;fAhIXJ#=-RV2#g{V~ENy+)D9%nMTN2
zjn?-2s+vtrkn5ST|5g?XOe}KJ9z+GotOheUQU0mDz1`FS=RhNv3)QCXL?!<lWP6pL
zSs>g}9F|+H8m{(xE2>Mc+d`Y7ZNn7q#cMYnX5SlRQ+w5>wY&OVf=X(%ediPIS|kUf
zimS}w$d0vOYQqtIaVTT__M0EN6Oy5WOEFHR+w1sv*Q~a|PcFLH2O!^~@l!GQq;KBh
z=*d;kIrf7cc*akyM5S7>K~GPQYla(ALqNLFks}xC;#3<3J{R~&0~Mh&*R$n=;Hj^e
z4}_Smw+wQpmAbj6BPX<mX57cD?l}J#4KsZ-R<0k6i~`O}3Xd=BWHBUroib@_8R|Uq
zPo{LV9BQK+b9(RD9Z{wZtBp4WN#09yykZ9jnZ$rEtD>Y47^!|M#>+3SO*qHEG%yFg
zkqFBjffFx+gX0C47cAsM&rwEt*r9OE{dja#jwk@;l~&;3Pu=+V_jwb0EC0Ln_KyFI
zb<K856oq|wjYO#r@=NlI!9aanH2zDZU+EgNnsR~t&rmnRwl?B5fY~j9W{qx<D4mm5
z%`}LpMXsra3^Pq{<cf@ZP=A8$T&;F(RaTqr3N!k52U~jV*jg8Qe%%z%HxGXTUONiG
zknO||va;nLW2u6;(3%HTK3iCjw591^0|C6<40p!OR)oR6HVr7*`k-D}7#Kd8#@9c5
z@IV^QsJF78=c6KnWk6#{mI~m!WE07p-+1%GjG4Rck(EbH_>Oe%LZHiotunJWM&$KF
z1XN^zbzxi4YVnTf)e4YP<RGe-H}haE685jr6-9}v!=c}3(f}&PD?dNKW661OO0m!h
z0#y`xi0<Zy?23K7l?P3BEAB7cUh$0nb%_sqOx|qIzR2F0Iz^4B#KdFio*Uq<*ibmM
zKI4=n@7AXAv)xb@6kwTT;pD6y%_1#Ms1w<kRLBU0i{JFya_pjECfU5F7i@OwjZaj*
z-SJ*BaIop41ED>&PNZe#?8g_qzUj0t#sla;J8_hcRfV39MuJs$VN2W*&vXs$nbzop
zpkCeat}p5WYvbMFK5L2?vY+dV+%#1K<~v}{kJm~+w21P}AdiV{3C;K<;?Pn^^r3qe
zDhX_QzG^<5z*q7}5G{gSFo<war89o7uj&)NS-Q>}St%NB!H*GYgpP@skwuqVhd(sz
zFQP>|oSI#H1sdZNc+o8W8MXVZ2A3mwn0^GW_F=?U2p(zO^Wunv3^swI{AdGokHI{d
zGc%gE-&Ab4K&1q(pdYWpWl{rfuWw58`$HH6ll5qbVmOs6iuP=yMpRsF-2Cv4dN<a}
zeZeQ)_?^_OHU?E<{V#aZ#w8^ssrkQ=N%xos*07rY1$#@z0hk3;&qr<#Wv7#a#Ale*
zds{|KVC>^|g`qd@?tfc>Y6zG!y+`N#>wS;I%U`pzQP6}w8D;je{7i`AEkC=pVOJu*
zowMEi@xE!>j{CdR{CydKsASP}sXMTl*4n*qT1{MXR}}@|_z7{PDhTFX8~@N@II}2X
z$ZjAmJyzcZN;+4n5G+IInyu^X3b*$@W%P{k2p!;&5w1lx>r4|GXR;bFm??DIVl%&c
z>tAP2^ZYMQJ$Sv`>DIaP=ZBU==tPgr?euQ3ogYeX4a$-civl{V0~IyY`^w#5gHo_y
ze$L`cuYI6ntOo+do7q7<8+cNB@E%oCEl8T`zZ!1b8W{;zR^-M;wLR!1xpD+RZbpOG
zrcB#MLlYaXmU$y%2%3PZ{C68Xsci4lNDn+|CwWqE!>OmGbaZs0!8l|(1>)2O?##PG
z&&tXgQ>9JKp~eJS-})>U<@|`tGHVd86=#YhvD_gwo5@`G{A+%`6o#*l$mXq4H$T1T
zRg~TelnO?ObjCK3u$$ujeX~dMnyYweHk1i0PS%XKSX4Hq41=s7^gB3W%_-i;x2@D|
zJ19}@j-^P#)T50^r{p+c_CuIxS{;r{iz6;*H%9F%zJIZBH=8mh+>^*7YCW^y$(b2n
z;tSQUecLfCM^V5$=`gd_mpS&<RN0BjV$cX`UJ~z75VUX*tHIyKwErcE#Ug<>18M09
z>Ape2lJ<jvhesKE5{_h09VN?1)Xp8O3T39*I1eve76&wlzqD|`{*Y9NhR7#a3}Lck
z;Yx6U@3Jx9B_Db0Jcz|GAaTOCN6AG!FE^45=2wO!b#rQ*X2W>@*EepC3u8rGaRHE&
z*R0#@1$c6P;P~2lU|t^_L18E|*KXz((K=ifTo^r1(0HQ-5}h~BUYjWg+#jii?Rl+O
zhaW5Jpbpb(5`2y8H*K=AVL3wRH#mzgA(n|xp|y|V*7@1uIPrH6W7~2a04}ex2{uGX
z>??HX^MwBuThKedfDP6HJ3}2Zft5t;onLI!gyKF96SazCJOYcLh3nU^bEUhCcU>YD
zUV?tWeug{Fj#p<{8Dz(2*!4$6YC%7}&w*llia^m%4GrH!T;T@ECGKjF*})^6X#K`<
zoW!AoZc1gRH}5Lmst2qZTx5wtMUSw0frsDIZ-M3JH2r=i#&>3Nw)-+~x!X1dv105G
z@jJWD?br(Fs?mkV^8sD1?3jmt5)X4>^NSd8!sdAPbG{Q{nztF!0(Vu{)G#nH75}i<
zwD%-|JI#~V#hDqPk-K+v-i`FU9RtHxF~C6hx%*VE^{S9ah_zsF3@cdzptUI#CLenA
zDBjRFl~Qw(EBCb>bK^HtvkI%h@#%WN82l6l$UXfNlE6C8z#D$KzhT$m0|(AP3kioF
zDifo?p4|kiUaYl<J%#CC=`Nnq4KHDx>lg`^3g9a5SyFS_5_|UU+U|f-fNVpHY$RNH
zl&OmJA(w?tI(<|vu2$CX=wet79C%gb!~?yf(CDZ}UQ55jxnFa0(Im;4(!uMPc>TN)
zNg2c1Kl&zO-qO4n&R=#eTx8Z>6!=6S7Fraeej?T?Om*}Xtrl%t6N3%xpX{sQ>W=o3
zNywe{mzXH7DJs~HL@M<yMF2$Jml{dfVvKmH^I)uV9k-gcD^%@y8u=t9@_tO^Go(wd
z*1K#Cu%gR@?;1DC2L^^gMINC7c_!U+J!<9l4@2v3?h95gC@CwGgHKMbIo(8&_zjwJ
z?2;cslZBT^5%516j$i7Dw?I0ONRG8=fPb}z6F0W4jmXL9`3o0!$k~=Yfp@s#N&ujN
ztI0(*s2UKXO-?U^C)VRzCla`P_T#=D-|P={6W4pn{9NaoVfPCaT)k#Z-Pbpwn`XA}
z*`p^vAMDI#Dz}RD*s&`{tyy)Zs+q`hHz)YVCy$$ok|o7k>}d-|&)%b_3#G)h`Lx4y
zEQ@+hMyO+uQ`@KyPnTY2zg|bbMHigTH#3C7y<p6gMS@Pt3W26c<f(u;^O=_@Ri}9~
z9%TEHPLP~#AkQNJDNo@?zX)l!3sRCd(2W>417hqU$~=%+^0&`GjvS!)UFVnJnqY@Q
zmt;RnMh8B7>^I0DpRqIRGLYP+)LAs4d$SI{bH50^gtTu}y!7-4AFdn^?lIR{dAXB@
z->OD=(Wh{wID!YcjF>YOf~_a9KkpRH24g=VmpseCZ(k#<AWAXe8N<q*POSY5v7s31
z*QNxLE%xwQzIAseqZ)+b%y>d1a2Z+IO$oi1+c@2JD~@z@b`sa~@f>vs6fJ;^vw7>%
zS7>8MNoJi+6#s0cQc~9f=R!J@WxSI%Dg<R4H%U@IBwFC)Bq!-u3+yj3-8E7|r*hiJ
zs0LsT$_@1SFxa0cIb<<Waoz~*M}5_J=Hr%&yo#y%b%y<=`)o@WSXdtCc?b&=XlWY+
zB0vn`6KVy+RIEL_8C%8_YrusO?-v8a&<5SB*~;a@=K?M?sXqALz3L;NGQ3HWA!b$E
zR#FbYd2USTHEcUcUa;zo=#~fW?#FW4h_&5iVa%;#Di5yT)gzxMDMTnC_A#K<?RgsF
zJ6s<Z0Lyb-6)*U*@oMp-jV--6VWiS29MwQWhx7bsVPT?jmSg+w-8Y%s(9-Wy5o{o~
zIe;^~E;J4aC%ZK!ei|Yoz*TD1Qs(AKV25f)>yDukuunFOKAd}ZjdcB_L#fZT9`eU0
zh(h)nED3$<d0Rl;aZH5Nu284lSZ?yPkZ_8wXaJ#&ql!1*e8|yZM5?GG8nRa%RvvUh
z#x-=E=DAb#sziVeSjzZ|qV3LVpIyH|P;>$LT3u8n0!oKf-tv+I2|2@I3*-eNos%k8
zH-HW{u3+_f&|sk&jl_fmCQbatjn{Pp?(Se)D&sYBS@m<Yo!^fU+?R0+txwcBU*?jc
zJMcIaBQt#}Dk>VyLgU4Gt$>2mkD-b;OrE!MmzL&D{NPXR5W13T)Ld_>L1=%Rw7u$;
zJ9CUSACC_n!67=8Q$hNbU;3TRgrp+7SR-#s@tyq_Rj6C(VyXX|yj>>Zx8HB|4L4~_
z`cyRzj*4~E?hRemhYue}penS=u1lNnnWZcemz3nnk$kX?f$D0+TiOjoO>K9Y36juo
zlNb8}A1?!7{=v*0b;nJ;;M`Z_(8wFCB_L-1wA(S=(a$^|GwkEZJE2R}z8QpaN)(~N
zVFv_%%Z3eSo?Tc~S_rmtZ(fUlkamgJaYssF^lh;k`EA2_2oj^4vmf%BQVbe63VAl}
zJ$aE36Z?5BkL7Ss^-4@^uutqMdHvd+?In(F$3Bf-djPR6bY50U93oa5X&7MP>=SXf
zX|of>I``KK4t6{t8?BaB7KMok%sZrJkD!tj!<av4ypDo@Cnej<lQ*jhMinI>QQoNW
z-fqJ=w>Ac>KBc<T7_v~47cr8r2z791*^!Q8`TnNaiHKRsO6eV*lxTdoT0=y-6gmv%
zCi^y*M>2Wbegku_5@2~?^)#A@t~Z{7=3>nrKjJLjzV(cWOzQSr1D(!7Y576|%Q^~^
zbE`HSLBT(fQvuDHraGNnXh;oogJVcD>H|D1AA20(ojpWc3TU`XI||*j0W>(xyDrW`
zin?wQAQHq~epE>TrJ%1dIWp(hk4Ky)ZTw^gj5r^NbV=A3<YZ|v<;SbmtUb-Z=s{Tz
zwB6o?Cez$D`|<5XFB#(Nh)h}hu;J)M?1yZV^$wGu^CC`a0^WS>mG0lB4e}9A84vg_
z8`>S>2Hi$fpUxNW&Ov9{urSxfnvip2Lc_?U0acg~zmNBvxF9SH##jp{BMHts;vF5b
zm%Zv`+r03Bon1A}3$7yZeCI{tfE<=AqQ^6l<t2JFv(bsQ(^#VbVvTp*w67<Ti`($q
z0U%XtC5MWx-wVl@)O}&u!%^t$stsqPKkrmJ7Ih``PPXi^utbdm1jmqK(6Q*lEPG*Y
zX5=Wm7f*r2OTkAHuvd+=?l#jckz?e%Q=1G<!Q|2i&oE^8FTk~_?CK9p*%IrKH-hT9
zG{5gAZY>E#FBLF`Ln$#Xf$sx)uSnA>O37te>J<*CWthIdzNnFHU4GqY)vZVnciW}r
z3ut%jkoyTz@9{I_Q{Gda$nB-*(vR}l412+IMx;%M+ow~dq`IC=#4z>4V*~2%B2hvC
zOl@p<6*`r!WMGv_(LV;&3u;~?j7uqU!^qP#6!%UuMRVH$8kT<4VnaKj?c29^CN9Bg
zMpI8sVY`<~=@_I4Ya1%pzt*m$&bkcdWD@2|((&)ovK$zYBf=Is%1Z#FSF0l<M?cTX
zd!hK3;GIczBC4}Zq~`9T)dOYzr%Lq{#W~k{9Cw<t%ueWW$J`Kin{DCQJ((Wdm7%Zs
z<Ab67H;j7bXlZL-LX|BvzbGk59qv`ww1z^81UQT<Hh2`J`A631&8lHsCmb*=G|gX>
zTV>LXug)UVl4%Cobd8`-HPd&$YFwVwSz1~eM`a>AB4D3y%Em+vh8B27NrR9TuFjNE
zHU4vHS()X{&G4tTCj3KTDT+@EUU;8!4E2W-c6vP+{E4qqd(i`oyY=9=4zn2-^R*_y
z8g0g3UyE?wtU6#5+3^p}1}YmAM!recYMUDy2TA9ZIS`*csDB6wcANbG`#S9|`?k|4
zhLzV!kMhmU&hqeYF`3gpNwFINc*G+oM_Cb!WHp!|LhO<zg~18tG&v&6L;dIIlTsA9
z?rir)H`wk187j(dx`;7Lv_QqA=7aNo4jfIy?1_(vQJNQt-lwT|3<3*yqZ0F`Zuwl0
z0fh7g;}|s6_27QP0D?B_m0r!!CPm;pv-YpW%a|AmBUDRiD3)@w!3GL`m@r<R?%!p~
z{~r8m7~nbS0R1rF05Y{PY7umt8X?jmr$e(}pUlq@0rRSjY=iy`P7Pv!B|ZdfOE}C^
zq$Sw{HxD`5z+nN5n`use|2`O3_^u!c;uG&w%)NBYjj=P(S@;H74T(ect0)~$7`x5H
zBq<AI!mDuL^thWLFnDKT8bv`3v0?l?Bq-Q6$_tv*8_u61Momi51*%fyLM`-@BrEB)
z=jD=dv*FBMTB21I9<8K>V+MVShV#Ohs9V|q^TQtt<CetJDPfWY_+_)_l)e|4e^{@~
zv#w~h1<14KZnX9np~Lq)U)p{5j@58WV@LirNJTb8EyH|TN$614BgTq@pX(+F&kW+r
z;ARl&JI|o+-!XDgKb~4s6v#4vFu(lr*x5apQ92ngk9Lu}MFZ!mFwF+?hU>fwLb_E@
zvcer=d<+)uExNHN;sFH#UO4~xIVcDNfpsFn@S&8MhM=t6aLzoS#zXgT*U@;OmyI*&
zI^}!2M@CFC@&R=A3>$n)ye`?^J1j{3&0IZ^z(=k)8}t?OaJi&cIM{gJ-rRvni|OIk
zfu}=xvaly$WFm!CNH>T($7yq)V0<ujJg+EP&o)z`HETDTezO*wtU9kSGcbJo;NN#l
zE#ba?xd2O_YlB{ER_b<6vwSe^vq({>%gp4AV%X{Nzk_~I9J$h)qvcr>T6OOukbMXl
zG%BD@6tBsjU)84uF1DGn*@BVoB2%Y0@cYz>Cda8;LBpt}Enu>Hjf24SH%-C}M5gQq
zFzYPxv=M900+WgWX6EH>8s){xSSl@pL$y*;rTDJLbnSf?nov9+Lg0LULqZIy7-@dB
z@QK8MLtN@%VPW5D72uep2@KM`h6jTjwMShSdIu4liWuK)mExn$0SbxGU~mA})dj)N
zwRtzTogWI5hh(`<FxT2?s`cxi;dM`^dScTqf!7FZa+9=tdH!)sZxg7E4l5X|2NIW>
zQw@4oBKJzcoiCsi7*3q1sp5ry&hl68K1<)HPY;;nPWeDR_#CnClQmoh>y`UFXS<aR
zXLrUx-QYX8-Ko!+%@z!r78st0<#u8LgCQbdW$MU>?w%Fh8d2NDsRq)IOAZ~vJb8p<
z5P*zjcl-*pT7iC%qMo#yXQv7<B|uiDb%^3t<c}l6$H?F|f^47jiD@A0QfM_PznZFu
zOzAW?`Obb8Uf6F7tOlf07p1imUi#I!<@^9btvq6hKZv_5;dK~PMc0OR-7I{%%>6}o
zU^7u|v+dlJTto()$k|6U)Ld~ue5}kb0A9qYM*?ymLeUTnb{OU<9Dx0(+|-O%PB`Js
z!~8pEOGxscGSx>+n{eBnv^+EeGMH#fsPHZEd2TRdBK0K4Y@!&oG|u1Z8-KmD`~Z3a
zr+|5j8HpC7R-JG!dr*=4^OoD4=Z#M3l<hu00Ai*7N*kEu5`gD;eyPCI*WXrx<XLHi
z9Zsl&r5fI>Sm6ez#_nO()2F}n7+Fk8wB&XxeSbW0?#bR$hItRB4tet5m|7b3Ic};8
z^W5jEX{K;F0QYFjh7sRphgG^!vyN<V1+NKSV%*DYD#f&$XB;g6S4#tGvv)#5LU}U=
z``(b&>#dZ{O3(l1Zo)sjWE>=0HnEfpxTaUwd<J>*Db)9*(EMQXc#}cG7kpfpM!vH`
zf(?9{=NEUtt{9OZ)>`qi{0kbw!Ty9}yp?D14#CCsv)@Nd7FJ(Xb!o~*ekY|lpuT)d
z(Vc}LxLJt}JfNP;J;g4u9MrrPLMvc@5z5}C1a6dTLadRF)3sr!D)g?x4BrI7=>4DS
zExPbvy0$@(w@Lv~^<`b?=}{o8ewKe<Rj^&UfaMlD_oN}jyw2@rp+vibtH;nb7rBj0
z{tqpk+K(w7QpL4_MIx407?}W#Ci4digf~jC$o}2gVaTapJJ)El{oDe}MVzaya9{Q3
zrwr<g(Z`bcpd{oxyRlEZ_FIn}P^?&|>g)%Yr_MEX3eOJo>>)AGQ`GE1=`oF3(r8KN
z3qw>fs$`r>y=qax&IBu%9A+UDZ%VL%J$tr&d5MvpegiezQ&_t88fyZRlY0aT2YBwL
zmm|4ns@Zv{0UW9!N=NNsM|vlbuLep_F`#ENh3%nqjkOU58~1R29PNG&MhQd60dqAS
ztoP_&XW5Jx*I2WL6HUeb#{)*g{&aA4`Vdd4n@I;s;zfQaP|&H#w4y%ENmnjG{i?RE
z?!JB#v|3FSXSen`->=%&(+~u%;ElRn_fBtrf0b)(n6`h|s$pc-?f5OrDyG93RU-^7
z*~Y1fdR3Fg6bZ4N3p>x5@KB$g$f<%=!`s_iJHsj5i<oNVooowtXLP0tf)G33{LJ8^
z`&PRqawCADKG8`)R`u8wq9^}NR<)nVU7T*_nj*1Q_fAtZW}fKXWS%za=<k^Q%~L_h
zP43g$x_`gX&yQaFvUVg23opW@%w^;dkJJ-Qs3=6hu5VK45anRItAnlJEl6J~!xOx`
zD&B~KsurW!Gmc<Np<vqVX%YpE(+}z6cuRvpLT<zm%?>l?Ri!n(4MAg|LREuia_lDf
zdtRQz2yMVzQ<C;07S%Mv(4pl{y5&R%+Q+m4O#_~k6@o{}RJd!iqFB_+m%HTw1J5<j
zxE?p1GRQ@ZVL5W-^Jp5dyE0o~+|}%QQ&l8|Xt3A{y@O>FuIXh5rDznTHYn!nVn8!F
zGtnz3D2~v}7-B4UY{qC&+8oTsR8Gs!L*TUeUuiq|-4grmJsZF~_v1~k2rd13Glv3H
zi@vlLjBFjsr^!1ZI0aF<<S+qbZRBF?Oa`l=F3OWJfB%zu&;5C=qE#^H+4N4+O$<|c
zwQaDG$dewsY!SmuGGPB)EpqK9BJAPol{<6hOz3<h3@H7WU*c|Ylli<<-P;er$)5;L
z3C)_&&0H<=CXV)H(Y`QT6i<^8y9&r60b~Nvim`HC0uW^kY!gb0I2f)8=80W?y1`>}
znzxfHH-LRR=6GK`o`inYbnf+yYKtl%rwn`~n#naEkA~nQsf;+Tl;@aP$HO;~)4^_0
zyuGNd=EMFGKU_s|Q!zxW)qdn1E+;t!W8xHCFmJ*4Mx*F7w+;iFwg?`9xF-2GCNZo?
zS2Vo6IB4w_TEllou|)K*)tzUx-Au9%5u5Vt?Cj2$^GHoX0nPdLQ_*uMS#{f`_(O-Y
zM+EEQukzJl;HoYk#&C?alj7Mt86nLaPAuV52qFm*M2g13qN4kZg#aE7d0fJ~U4edR
zogPF?@0yxM&gDD0Fmc3Y>0&qcu3%^HePqUODVxNU6~o5Bb#@!%0z`8;#Z6$bm=arI
zfv+_Uz`4gN#*ABo>#bRliWpsE+E2{R&&Pll<;jt97;4LH?w{eri_%gXOPv|`)gO~U
z<191gwb}>PfjNZrehfEc;ckdfjjL$F6u|J>*hK3P_hB3u>H#VxI2MGB7pIyP01v0!
zHJ=O6?Y-JTh8{xaOKUtS<9Uw~e+rk8+bIo($(2WK^@+KK(K<OuP*jHLXoN62U2ocq
z%UGn*zuxZ|8k}&AtUM^SUr}l!0)5+7lD)hG0|!T)jc|d%+r1}mexH7a`5Ds-qpbJt
zE5Y5EEo-_j+-u{0UOBW>ox^gMAvKa&LyWw3ul9uj-Rt0a*NbT99&xg^faBK2D7S0F
zL_N>XFB9Uz<ZcYE8O_S9_`oe7iC^Gc`cCP}p{!C}{T$#ySusg42s+tK3A?DNkD#Sw
zHQggcw?;9y9@Yycgba5}k#3075pd#crhdRC#a_&^8`E2n=j<>r1bX#mFh3fu2J<3^
z2&8lUWFc=EPN>;D_LFb3Wmi!|nmO#0=pCJ!l4q0*H2tY@fxnw7wuK4)Z)#srT}XP^
z)^Asa4_$a{TAXV=xD%I?zzv=fa+f|ndo@Wx@Ch3Z8{l3DTC>YZR)QI1W;JI?>3hk<
z9rhW!l2hPVpqwk_)UR2y#%Rv}1}J70Kw^0(sA9Mh#j3=V4lZPA$N-dSL(y3O@`F-z
zWc@=9nRpV%&gP+pw-_ZnH?rvxt}~(RnEorp69ZzWC;#fyqh#Akev+&Gd+k=R$?{01
zMkP*w{F^hcXT)I$G71iwp{*9jY+UweORXxE?Nvm}U^turz(#w5PFPqXM6fk<QF$Bq
zf7>7oVw~r0o%yJFJEn32Q5PhdsrT)RfeMprzEN#VC4K5b6$*Gxs1dnwLSm7m)B7GV
z(rLlm{Cb=1<}&Q{Gv;XQ9Qfgl;#$^!B>=-r9oo#6yb+8msSzW?p&K9yH}ie5y|Idw
zJ0IAvx!YxtAJ#n>7~WmYv>9ruW1p$~MJ}PhHwx&$tq^&u`@uvhh6GySgEn;m^s_8}
zB7gN1op~o=#gtrZvS9WnV{j5P|B!;DNVh@FN!{Ju{R%QTmr*B>2A)4~Q6&L1tAx-?
zQ`8lCu*ikY$?(m?x`5dkd{1w4L=2?!V{SRu)dYCdoIG*_hz$nx6HUF#bxfFs4(HCO
zr;k`*@@m)p=Ix{IOi(k>=)O2Fc`{g~pyUaL|K6g&@oH)8AUCo|1o77OB($~ef$pb|
z{+DC6^czwmG^WB88%6?ou>nw8+$~^~=QTY2x1<*(R|*b{veJ>OL@-VfA^b67h)}n9
zrxr8y#NJ)!M4#;Kw$l7Q*f2-5sHS*OIqeZfr1_GVUxfNqmM&ov$ZZ*NzU^3iFwO93
z(KcFqs3H_GtBcE&%D9^bMJ>8{hWn2N!}c=tXTC0$zod>{d(e_qRPa{%O)Ut*p*A`j
zF$oEI&_#;462Mp1+@vihQw39yvTc)XP-%0=KJUYo3EvJO8_h#vKben%L26p;umkwI
z&8)>)`hqQcpra^2txC_XgfnsqeSL4H|9hW#H{xpVaq3@RwAv<c*Wj%3FH}u=TvL&-
zca3gdy=tnyc1_wc(xA1GXIwsSBgBJ8Lzxpfp`FAaG&N~j#4}#;6D$eTuOvP<KDZ*q
z$qiCN^BD2_unDJxp9Aey3?bVC^7_feKe%p1``uM3mTRrF#JoogOIc=}t{n>|?PL<O
zAGj|awcX-U8+>2-=*CxMz1|?cwM0%N8Q`Ybhy4~;ggsG1%M;*EokHc_<zI*rn*hmM
zz*w+r7X&3)a&$Vj=pp*_(LqwX(B=_*!OmVj%B3_fI~{DxX4+sEiX+GZo-$%_6a<Z3
z-R{#9sm5VUKCFz4qOiR*#T&s-6D^^!Qve>fanJ+?Qf?Ejk`~3PpX*dV?C&k+>kL_5
zh=ix^84%cs!1M7~z*H1fIIXzTM`RJDHuo!+7uRsT#hoNAFjx^eUJqE@3zG!Ehh(G%
z#o#bA^Cck0!|)-lP<fcXGi*w^1TLW^C`%TxAr62OhK_7Sj#o~OAgB~S9)_{ZA0s2=
z8Ywc01Lf=K3r49DIFhspBF7j9m~t!CVZd}RSQk|Nxr|trG5A1Iz6=;o;%Y{_qQ-gR
z1Ow)V$pkl<#(<VjQZpGwp+9s8cDp)uyItWtZ|4{Kp$hSn<{z&?1QU06Lb9Ngvw)2E
zLch<G>aumF%nfP-;Uib9gm0w}ksDdaC=bSfF!n>7Y5>?O#AHmAE0oSl=+rv7n%?tI
zDSel)q+7FJeSqoZu*F41kc=|0?ASy;O8{j6Gj@`l)Bd&-xWVZ%vGpN$KgTfZMR*S(
zR>|MFdskv!5atKy7~Lpz=KZzIJhr2+3|q70!Q&rBlYc#v;uhm?Tj&n6Hgyc(*a~Xc
zFs`^nDJXXQYgwlFKe^q|KR<gr`Gw!rp-=v!q2aWg7WCpp=kN{+3gezb^d+sA{(Ri*
z*O|&c_bT4{<F=)^)$@Puji;da?;^%OGamolI{Dv?o&Q}=`rlowzccQC7tj88Y43kG
z6#qU8|6RxY|D&s{Z(Too_Uww<0Ih-nvnxcdgAsUGGUg(b0Z8;jfN71&xC%;Dn3+M0
znOtj_UGr{_CY9)Dm>ra?Bhq4*aCd9AtQn84aW-Q)=H?&2y5;SO9>`DdpH|was3?M$
zl|dO2!;Yg<<Nd^PLa5<Vr*Y7#S$sRsqr21sc{D!VY$A?-uMGE)K0-AuHd}UOR?U_<
z`Y3L>pu7~PlG^ot9i0~@E!2U%Ny{-TxnV6XdMJ~7N`rY8)j86;Kc*8>hq;=6_~Em6
znnhxmb`TaO^U~%pD_ug@)0NtwZegLb9K!nfo1bO5Mnlf4bv+nnqX_(hG2fpY$B#>+
z{nwmx!F2Os4DYYqxcdNcgPnvTPCgbFpCmcWTXXABNs&tnAUeenlNrnz{lk_UF=Xb6
z9tJjGGTe?8Fs}HUoDOn9^iFzofv}VX_r8P6L;2l}`((;%W$X_I6*kp0Ts^BtkLwSN
zOLhe7fNmR>e18NkJPb;KUzE;S8A;9fOXFZlAx4wJ;R+>Vr!bYiz^7*OF%<MIESl8i
z*3{Ir2CmF2zk2)XmUblEnk7)-u?mph$h{C|nHVp%gUyFb$Acs~3d^YZ==ZaJ81IvN
zdnL5WxxXRdD6tjcwj(h(*U(g6#72{q#eS9f5MI1b{V<su{6r?kB}#K9D)=IbSmmR&
z>>a_Hkqa1RaaBb()W7F&l9NeQ%o&IfuBC<-%!MzU4E{b39zA-27EjsATN?V07PMtp
zln>&L0v~j}jgUR~C(2IX-h*pt3q$#*$^F%&zq}0JIJq?fJt}#4a%b{JTK?0O_Gosu
z;@&Bk>L$P8g)bYCQ7Ij#sh?lZL*GAw;mj9k`H1BSu47{2B$rg{l<w;*^w(IQq}}!{
z%Y~{M&82Jr8pxenpTQCJk~VvSMMSiF8FtM}An&_CZoR-<9eHxx{OLH6V!ga?sPHFE
zIc{2Ef^JQI^+gyJacfaA)R2|Qd-zzJ0`pT1%bT~_?Qt6F;>@ay1sQP=*9qd75x>P?
z-hGe36S!4_Lp_H{jG4z}DF>rz)rNlX%MsHRQ#kRNDJ<`H|H>caS2|?qM>ie3-RQbh
z$aLA(H@zdxjdQ%_Cmqs45fdwutl%TVA|guQ?Cr)?m1O2Nz}&3cVTVI+6nnFA<vh0m
zPk#$85#(d~z>jkj?j^&*!4Y4jJ%SDLChh{AN^;>EyoWIhm}ic`4FpHqr$cZjo;OI9
zkvZ_RR}h&M$&#RGBq||(bW%4@fzMz^AdI}EC8S*67$#n#F^l|Yv8Su+EpD-jhBH9)
z)2C0}0qqzdo@hmzp9R(CrDH=Y^bfE!rOA@WHkT{&r<)8w)yU4qFT-~BvYroYiI|ue
znGK5Q#f6A+2ukwbu+2wkuUWmi7TY~;q{tkOi}1oh+Dvrmgn5E=z<Xi7EIq@-Fo-*C
zIONW24CF=_6@U36Eyhd~GkbDhnB*51SWj651OzJWVQ#PBmNJ;he<o<?_a-yp4cO(L
z>|hx&LaFLa6xHVpH6~2wSR1zL+IaLr))?nk1idu{vIvvn51%}d$E~1d7egpTaI_=_
za07R?PNfOv)l#+$-~!FMmreeWahbc<ADSo(*1Rk5djnM~+Nbk8sQ9>cZ&FP^D_jf1
zrq_r)F@$5zSP^$$!<ua+7;o=+V}w7|s(Hw6S*M)Fv@7#Ax%P@olAS3%CQ|^P!ttPA
zP{tSeD?v4>z)H!2*+BTSaY2_CxlHUK$W!8DCh9eYX>b<ma5-{v8aDH$z5|BIqLJI8
z;U$X3{D?jT(ug!rx8ZQeOAPQt-@;<TT|g+aE9B}^q!k5nRg%+pNE?b!S6DCzoQs>`
z$W=Y$e`I>CA9qrSF^7XPCexhC%fx@3nvBWux^xo_LJZcyZa0P7ccL+?jSqkzUzXf9
zM5mC9p8$oka`P)0SOfQ1hufa$ym7rSf)zxpH@hlV<s3BB6LBU{-<jz9LAae_KY=+E
zqHpY^rjEdShe3hXw8y<IcGL~&5uSJ2t~H%78Eh50FESi3j5^hw{rJr|q(hM8spj2c
zQxG&`$N=Q4SFg@luo*6^HoL`H$O)5sn+)~m;rEp%Y966p;T$5%acXK2S5@;kE`58E
zE-+u$*5DC0&z8TMOwrdN;=N?V!o$Me;>sr;%Rs7!xL7No#}*vZWzQ|J`qcIibL7;^
zrWcXyncue6mu+#Ve2{i8*QqIM#7MxUd7jr?YgK8mku7B9%L7XwmGys(c3>+nL_?3a
zYZGPCc336O+?yl%&Zgp9@=yiaHJ*W%Gvu0Mj*Sr7w0ARKd*I%8^cEb+Cj@$M$MD>!
zCB*PYE}_ubBA`Q&p(@;p*J~G#RM?OCS8SH`NSo2v-FZ;_mrZUEiO#-7nlctNU^HAM
z$yUhY+BM`7Trwu9Q;HGb%9Ju#gG{CuP?aQ1hB0b*eR=^y*_Q`E>$gn)!gk8a$dD~8
zuU~A)U(#0Tso1jfzEd&o@RP?c5{p{cAV>65JPZs`$fP%?a|9^=cIbVQJ0F?I6nm??
zc;UtK=W+;yjrq<`b|g~u7uNHr!0c4hX_CK~_W!hZ?r|}vdmIlN4lmNKv{rPsutmxi
zrTbzmQYeKsL$Qf8jc#VAX^cg*E{TZgHer>fyKd;ZE?w2ECe<|6IH-|sTT_#on)dT#
z&v~8m_xX4K^g_&Up5OC)p6~bbd4EO08Y`Sv(<ZRk7F%$-E5&W&-hyN0@$AFNr!<iB
zBD(?>jfu&w$#Db@tn%ap(hNG<3fjxoU&0U&zWx}fbEgjt=QqPPkWyCPW<{%f9;N4V
zvWexBxvaZK*ubU>M#OCa5qD?pmHTW&;qhn*T8wUmchFex{Z_-?XO+A8Tk8u&0cCA8
z#^EW|uF~m*=62lWxSGKX#2n^LB0;!IfbPzQvG_X*Wj}k!<q_URQ7~TG{6bXTb#&^W
ztE`6W-XjjxsVN~{QCN3O+&F+7_~V;XS0_&1GkMGDibvuT1*lryQckj)(H<8W;|WKi
z9uJf|Ud(tY+T6<^n!sH6#}~`D*x6kWjY2yWclM9<HlmHDU5W3jW(mxxX`K>=ociSu
zXE+?qz=%Tl0T$dOpvSN<kUlpcKjv|N{7I7~-B)^PeAkzoJ8T0w?0>m*De%b22Dyho
zYYw)aadDj-KgxlC&s+<C%0djfyq9*|xlR5+n)|kby<q<QrQ|yXcBna!mo1hSnv50-
z(Y*B>``C}q4O1C${SZ4AJk}bORaMuJ^?DH)VsNR5X<@9%S~t-2nr}mE9hS$Iw6f<`
zc?wL4Z53!J_&N}Cd;F}dEILhr&Pg@e72Q=Y7xp=J$C;!zpSat?^i@$QbtGdG@*VBC
z%2sSX>gttXZ{ZB<D5xdeUiet%gU&%(O+Iaft`rJ<9fmqO1YU%&Qb?mVHc^axsK%kb
zI8&9`K76|aW|KrtA6STQjA1DyGX{X}Fe}iPqkBl9pf<eA)ThbakFdl^2o7kO^#CmT
z`f<^Da19wlFP`W(xFJ>B2F2H)DqJC(ey#>@gsY??VZX6Qv#gC7VCmJ(d$P`W0`3=!
zHD=oex}L_H2Y0+!h?DYyGv9eDarpq$zad_2n~o0Y-cQSa@-0(b9p4zPJ1hbv_E!KE
zbaV#LSRg9Z8*2TEkbGn^+<-_|8%4JX2@{5e+4F3uXj0LGEW;~=j*pt2UM-)#XXt2G
zalUk{r#E1yAtVNz!8-n3)-Pcj9iW;arjo7|*T3X>oB3Nl&8#X;3O2D;=+vk)@054!
zk<aMN!somgRso4BvpSgsyev^Sq}>3KZhvJ@vePE?yYFQrm|2iK2KABnjXcEHsJT^t
z*j!tiXLUuYe7+8;v1`|^&FV24&fw-f%%&exoj$!POkMX!XidB^yY%;@#|mxqT58*v
zhpwk7zOhZOmAH0u@4`MY$!x<Sxp(mSg$H1u2s3Pz;7$`Xay8P<In`oEA7;-wZ{B5i
z#@6tl)s~|<#t7zxwg(`ECp7AZqBD@Bc*n*i>H24#w+x>nm*a^ro{fm9(u9533!uO^
zQQl$m1WN3E>}Rvx1w?3FD#*9CwTNAWK^d9{z79Nvh_p};DN$-xK&)J-NHa4Jtz?_{
zDH=5h4?)N2^&-6;o`YU>)R9E$yM`U-v_btR4qTE~A=CsS4Ph#Zv}Vc4!;EXlFOrqD
zT3Ju*lh?ikRnis5-BRLjf|(Yf#~YA3mE^Jo4RI5u`YlkeTHFU=4<~Xxu{WwKy5(xu
zux&;F8a)4DVRm^ZI*$WreZ?qkVaz0m=$3HZfk0=&Jpb~n-_+U75BhqnIR!GU>o}40
z!0!tS+pVf~Ol0X5*m{D&!{<Ey*{r>De=laUgeAj0Vy{s~Z_LdWGZWRyqSGtk!|`F$
zL%z7mGP;bT#12M+*_YvUDKN+<zA+dqmO>KyE611%u>+k2YaXZMuh1cNFqU%Rlo5{R
zGuj@;BuRPI>H&jTwgVZQ@ojM95=v|&@tg-rB5}@EHl(?=Lw5-c>2Bt4a^Hrr<uH1X
z`8E{FJD3}<LS12=N=FjjYT$sc+)_?dt<2a0hLn$Yb(_^<?!{Ftem=*YdEXBgSxe~*
z-Wh*U_MAtdaj+$x?|3&$Ub~Q*Pn8Z+RaEv~oEkL^KBONgzO9z-=n*EC?})Pi@Qo0P
zOG`^b8r493r}8-p_97r8jdb!26{e$WGsH%`VVTS%Cw=9+{mHxW&TqA|y9SrT{4et*
zeNRQBAm5_D287fM?U0>N=k0YV^Sk5BdOJEtr2g-;Y5=}~d7|2lUbKv~tFYS<@H7$w
z6)<4u)QI&q7ZZU>;=AAQLY(569SccZHmv2bBL_&|*aokY$f$Z^3=m<;k@W$G25G(#
z8tXan1G61o?FY|dp@;Vhn<tOG*2#tb6if?D?eMD*Drb82#bz<YaYIUn|2&E~;$jgR
z<&sGWP+UiY4TqO=;oXcR8BTE-(8foC13p5fahC|jU&TU92p!h1f>64M9j|?a|Dva)
zDpIj>17pSe%iQetw(d20dRxGae3NHoknEP9-YJ3J%6)jrL=qvkq_@-vWdcuu7M=iK
z3)4Vwm+<Z%K}VCDK93J9-NpkKdqZd<S+ifg4JHMofNn^RK;mhEr-D$!AAmTJy;3LE
zdb?4{*n^xSFE`+O<a~h0!`%;Fj4eDHcB*f=I@4l>ChOtbCU-h7ub0KDmGs)oXpN5v
zqlqI}LD9&<cP74%`l#q)tlW*azDV4gI!w1H>6@xjI&;&la`gKl0?DPP;064)#Cd>U
z$JuiB-!P<F2xPG6kTD%jcKSis(+M6S+qCy_mthbRWDqTYe7unDgWBkPgqQd}HZg9R
z1hYGCL`L4d?(_kM>MB_a^ym#IJ7jowfP8!_O+obZzP>_PcxONQrragkwkJc1#k^yv
zYm68MKt|vPL&n_`<srzr72H}JgT$U=kUjx08lPmwF|eU(5LTe})G8xP@4%nIVvLaX
zLsM`YIMAan8gQAD+6!zyzCLqU(3tAF3y#yW9DBHVYNGU0)zlqP<$;=vGCI)vJM&PV
zQr`fj5AYpG3U&dH;i6RC<e`v6+hChED*WSg@;EFuKkTDp!QgLUx7Yd~C3iyc)An1d
zzZL}Su<AeC`3Ngf%B*ekTcL+iMFwW>;F+#MtY@$}3^-LhOMFO;ufFoeg)0WydfnR~
zufD9`qB8S$xJ|y+EW!Gb8r{1d0#o$DW5PGWCbXKxS*pWl^tB}h>FVmH)mDop^+R~m
z2{%cJ#+n(iOkZ-}nyGmX15u3qXYa+8hYw|$c;prT2C-dsGI0Y0rUU0iPSbW&8yrGU
zgS<WIw<DDZa<d|2ix21{<0GO)PNrbgG;j#mWSn%Au|C**s2@Jw7&1s>1-kfn@}P#m
zOiYgtf<f3s_!t;!0*iGa9t?5|u^k_bd>ofD8!kHJndrgO7+5+(sJ^7&h~{GfB$LDe
z)_7fgIXI&ZT_U%Het?pJ+e|b&kN+(pt?mYm!j9sMxS50Co8`;-z&2A+1#!S!on5&5
zQc($ziWt~xO}Yv)Z78#p5gvj<KgN`5ml4hRp*@^qip-$!b7#-qve8?LzYclf0{-k?
zIC2~jMYXGmw-)E%7ADiO;rP_Bpk{I3rl#%9dXo5;RNuXG$~H<p{@I>C{8k(}(7Im>
zx9J+$l!rJ25*y2aF1qSfG*(t0Z$+zlzA(d*b!AT8Ics)v_T){8HP_#n+?3|250O2+
z!5aHrFp6s~DEyJZBJ~J9CczhBFX(bE^?zoS%MjDp6T6$VGKW6hm%f7c=XYaYqn#Q*
z0;kT0+g&wpEn+Rg7%QYT57uMALrmW&3Osut^+wW5Xkt^BJRjHWAq<7!Ni%X7qlg4L
zL+^+d{d127ys?)t93jy2)G|0f51X&M^PLPars$zpC@%?RD4hLNtgylpsNva41}CuD
z?Cmbew3(%d@aQUhdHYoRg|XQePs=}5A$0DbEO-ZJ<;}ieJN;ay?6Ah?pTD_2a%c^m
zO!tc2Y3Ew#T`J00>^AJ`p_&R>We~hj_v+J9yy+zarBODs#d`qoT5UayH4)Qp0_`r8
zk<hBkA@8o@thJh6g}vR@rcGbS2agJli5g`2))~5+7i4yermH*RB2mLABFh-tkKVn(
zmG0&T<D0X4@`^dxhvzm0Z`UR7gab*kFC5Xx1j_6cR8>9BbQc)SSM6`6=_Am3hlI70
zQBCBN`<<p{5|(rl$qyi~@_a)h9ix|`k=wKYjo%KObAsK*c}OO!m?~1FJ!Fd55S||&
zBK<xA3u|j<;M7YbOco842OrzFQdJGEx^Zana8(_ZfIF8==;VkdaoK;U``Q1Ti2dFh
ztL_6l?JF>tC=Pb))OjL!Ny)W82+|#Ot=ky!lz_ndeV9^Gfa5t*<$*JDfx;+N?U>Dv
zO~&*<eRp%qi6?gw#_2g~cLUa#;pMuAQ9#RbQ4l8B<$u$ONtO-<;rmk$6olWh{azN2
zX?H*;>t{N6m7MSqd4*zy_)=-t6}MLz8#`f;N7E~>lL|632e_Y2`axZ4T2T#ia63kc
za5r`{P+No=cA=M(Ut0B4{<Zq$WcAB_$Qv4?b#+y|R5f7bt*1ES%$lT-!|CIU<IV!E
zn`mRt3*@Gag06AV^0b=gH^|18B=;#;)h9`fo0b<ZB;Vna)_=)36DU<jAZ!HznHxNU
z=T}LrYtJqXzNn1M#BZK5d%b7oCq8b%+H}(RBIJKyuMQ0j5PWZR^oRfc!wG+Z%2d+&
wH8zkkxQfc(=7GP>1Am(bKD`V7mw8}9t+VdKYZC)%5cy$SH*Ke+Z*V{TC$qCQ_5c6?

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_profile.png b/latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_profile.png
new file mode 100644
index 0000000000000000000000000000000000000000..cfdcd094c3fc97ec0b6a643e78be9c454345202a
GIT binary patch
literal 31261
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/transforms/implementations/osco.png b/latest/assets/images/social/reference/API/trestle/transforms/implementations/osco.png
new file mode 100644
index 0000000000000000000000000000000000000000..3b239dfd094f4621cb5f5edfadb74427ad6ec8a8
GIT binary patch
literal 31826
zcmeFaXH-?$)-8%!XbCD-nU$br76p+cNGKyB2r4<FNRE=z2Fe_Ot)k?hA|P3E4r&P^
zNlBZGh{R10Hk%w?pX&MEefRfmuiYQV)=o7<*lVr1#vG%M-usy6-US7j)ofeYSXfwA
z%bq=TiG}62*DNec9e-br?<oH5rp?0QzD4%bab@Swp*E){>s1yOMvear+HyPe#<N{z
zTTbbp-gRfg;YSrgr{8ZdRJm|r)r0K7zfUh&_Ug;p^=pq`uzk4e?zhm(wreIQ?-cd(
zpPam@P+KoJLKB<h97@ufRBFqLbK{PSTefS<5?l{|Hg4#nFa7zYSLj;(pWiL6`5iY!
z{^*<jrvCG**FsAV{`^XP>ynK>zdGo{!v6Cs|1(~!KfjXOS^V?!yrTa2@5lXIlmD*W
z|KUJ6)JXdkZi^SvO)lQLd2`>seP<s(2@g-It5e>+ckgWWk@fb!Lbv$2mlsQhRh#Be
zOO{%^YGU29<I7YMHC3YI0{nNqFDV%q@2{PqCl{q#wuo4^=WDcNTKWl;ls=7ow({Y>
z2|t5bq_eYg>rtC$!v&MN!lpH+3_m_8Q!0A(YTr<MfmWJPWzE<34>oMs(%*LCqKOU1
zLG`NW^C4Hg%W9Ud;q0?%dc0dM&am7+PANuVVdF~Yhk|z82#oKUZ*HtG@Ba8SSlHZO
z+-W$p_xriWAD`@x46!cMi11v<@tEn~+vYJl)Xuy97TXg4b#LFjV}964HTnGFw7BD7
z;McCMr%#@|Of#-FWAs!8i#x>S+V_8@A7S?imvkHW_ujhZLQ0-5r`QWTXx!OHe--k@
z|4nbnO4j-G)yi#lD2q~{LBey_Q+_>NL8FRKbJL9aI2GP38ZFnsoWiISo%#NbLnTRD
zj6?bETW=O#j_cR23t6=u<vQjl&*L%md}eYaSu?{d_SC&U4``;pI-r)6kZIX65E~O-
zgC`=ZNgW*g(6l$g{Y9!_dGkV%VuY0I_ctpj>VJ^yPQ~Op(9PalXLap+erNsWzMNOv
z4<Eijl^DBQI6Hi-K2eKiKtJ7i((CDiOHt=c-{0ThI?tqS*t#`1Mk-M=qo%}Xn?na>
z(j_PNZM=HQl{n3exVA3NwU=3=&ONnt&eTY`^4?u%E3TuzS1><!x+kPS<P0rICqw_u
z(gmX%<-fnSUAun$%hL}w_WNsDUCXsTd-kr>!j!?VLDz0sS=r`P!v}3$MGG_W9C1H#
z;-Ye<g$8A!$=IwRA&6E={%cej{IvVr*6qpHDLP(HeYS}zEKZe54{}qzz3bHUC{ba@
zoDS^Raa<)%`Qqeon?s9b*8c6=i!-(L^`9A41U?rwZ`gO>zyTg!e$L@sIv)iqliMF1
zvVO~!*v0t~&--`pes|DdZAKv3(-X6dX6GWQQgNOOj0g>GL}*C3=fbqbET^<bs{xbT
z;fFj#dBMUAeV{eRuF%H?@6UYfTbb)%N+|*{>)OS`n}aFw%CV2{J$N8UYfd-yi&al~
z@lGnM%`rsw+__Y`;I*%(BCM&>8RtVpnhI_&Td`)`MJK(rCEc`kusyH4JYY6IY0e6(
zo9f2pEf9@0UlU+lRcj)&)#ps)XZO!mMe~k+;o-yI^WsILqN0M1-&j8FK5M#ApMCT2
zHV&z&XXpG626d-2Hma}QeE9E8eA+gR#(1m2M-1<`b-la2nsLsDgau3XUk4A$ca>5n
z`&PFw4q#j3>uLriddWREeM5Ru-f*hhU>8-oVVcovH#j-n8_^=^*ycd%&!s1oXDVK}
z@bLB;t~mT7{d?!Tb7#+9xOC~ULYR0I9>9FCF@=qTqdK!Fa@(23v2y;*-f+r<MxtJk
z?k0X+W&EHo*Rg2+!l@HO%^BsX;fUga44Q83a9iGn4I85V{r41?nC&U-H&yI6hQvfo
zl-zFF`PoU@WQS+6pmEhcF)<B1*C)jFc!gkf<E<M>jacWlMzJ=#glk<TuG8HC8JFKJ
z50h}YR904Y|K7dNdY<!9Id;8q*cxKo`P+m{^hMkAT^PG$GtBC1kOyK(5FI%}eq7vP
z;7K9kSR%q#EA^_Z<ib>!X0Cm#FOPK6&6~fyfB(M!!=s(S(w>FG*<EW`Sy{WMnf*;^
zF-FzliFlX$q@;B3-Mc4#?dwhdgBmaH@OU&{5?${kL=~}U+}=OJbNcSxyPw`a*hC)G
zse>Zg!gRh8@?ib`7kR_Ea@c2KB#~riA8nb_De@?2ccmW^wrsAu+#$U%b+TkLvZ%Pb
zlz_nJOp2u2M8!K^KS57dD#B9#(2eD*FFn|J$X&z(saHt9m?gr8WAPiKwm6{y8DsFf
zP$?c$OmTka&YeRuYc?M)?o1VJcaEH9R7=}QzCW^OPl-3TWOJuDr%qD3U9UoIA;ryZ
zpf1*e78D$8#_ig-V`o{bUA5#M5fPCV!`j-~%6A;np)o0wBOTTo4{1K>njl*w-Q@Gz
z&WUeK+qir_HDojf!Y0Jq+ndw;NJ$`eZZP7i>ax!2twOK0Jdlx%#``|6;pZx7#wQ1K
zg>I2>el6y?;GV=BYRjVuSvCumI-r8o&rP&g=OodQYNNHXthn2pv<q&2`Yh3$=ak%!
zMB8RQJ3rasW*O3wWo^BN^XNmmtG7VU1OCFp&!0cnm{}Yx<#8D>_ZGmC*}L*-bxKBm
z{<)i`J=xc+5izGFRWh8^tTob%d{(ltjZM>!GeUY8OApdq$NM^MdUGeJ^@Ey^{yHs>
zT$d^&bIh>FV_x3fJzweAR4I?AMHaV==UnN({|4fZHZ9=s<14z(owp=(CPV%GjWjbY
zg6NGd4*fN|m6CNO^M*#RdXZe8W=`Xa86aU2dnxLEo3roIgeOm)NF)m4{j{)*-`gAh
zK`GmRzqoj_ka<HzXD&X+v?}aaK(7O;Zip0R#@V6+AB8aLKD=sSIBz6BwK7cH!PeEY
z71e0}#TPd%xu*ZnpPu<&9@e}q*CBjCcRaJN&m^x%z%+euYrtCZ3we%~d8IF2yjZ_(
zonOqt{{8#Uojdojrlz(w?VwVc(fP`-V`{t4J+X<)T*2-9_u|52k)2MGeSggXom~5*
zazFwTq(7J3VKJl-gHqp0r7)L^ctFZj=N)dXh@Cv1b1Co23#!5;<5AF#x+|L3y?QR%
z;V!61=UBP2tk!nPk|k?8vhZx?NR}EN1xG~j)`CT?!>`{+Texdd_INk5Qnce0ij#}3
z8s37CaTTXZyy~H9%9xzGdLRn9!KAaMX7EsvWJcxj<Hv&qjeXk|Hm_S3iF!=xp192y
zuQsxPu`Ac@X<YE^D)B)%ecF(q(PcBJ=P`X68>S{sB_7WdB|!^~eO6G4^!VLp4VU=0
z{*lwx?5kI++*!lruCsjZZnct7d`5~vY4h%PrBt5DzRkR<39q;9l#*)q=8<kk#MWth
z&NF-PK15b<aNB2VBfnVCKMo&!_44H|!OL%dt3~CneJQ(6@XEh;Ir;a83K-n(Z%m0a
zt$X!|ME^Uv*uQq}OtX-2G}yamPcUvc5VbydhDi_Eaq@N`lHf7zOcV}{hW=Q=*JiY&
zq3;#ZcrV4j{r21D{*kn9srhlGJj2I+e&_KtY2Lkks}d?KDg99a@_5P$AJKM`;e3Vy
zgQn*xrp>o&*RFDL&&7GCyl$kOE5n7eRwPKt-WPNjQ1(OoX0?8Leljh=d}h4gvHT^<
zjjZ3EAk@lW;DV5gk!Qq0myHz8Cdu?<?5!@&RqfHZjunk6&C0>9a;zp>Z;ymTYo`3)
ze|rT<xTLn(2Jq>mR>rhumbU5bNPp`lANg}HGDbG8U8|2II`n-uj^7;sz_BC7G~FV&
zn*Fu*HffLiHU)>iPdliIMW(gUYn)oSC0!d2X+1x|YWMZum3fAH<pcG#_T)+XbImVl
z&2zH8Q%+L2V|k`UQ%z@TeY{$=!(e-X+p$)E)Q`qPZbLi`;cTyOuiA2Dat;eT*q{`r
zy#G#2wXR!PL?jEZq-5J%7ti8rEn^f+uG_{WVI8W?u`|x=HMnv`-e;@un9yG1>TpZ9
zLW`!<JxIt_K>`LPjfwFnfqQoBcw^OS{!UmeIA&SG)ReQJ<Dfd(N$WOmHo3ok|CPKa
zG{2U);$<9-iN*+DNBVx%gg`OMOuCrUu(rQyq5HIiCH2@6f0cHFA2r`ZDA+UW#pws)
za|`{v+e9o515Gif=_k@Wy8b-DV>2%2B0WFuM^J2DDZg(1E4-p6Nhy<0&$LT53f*(s
z3<$n@XSg_7wAds$F*{Pk%g0wWJPNSbBR(-uA3wyM=REo%S|QAA(s_1b$WAAMw{U(!
zi}knPu9_xlWo2sd;paQMFK;-Y{K3Kd!-unXT4s79JO>7w(j2J)ylPbw9a-(J@ofz9
z>J`EzOeeD=<qjn;7?$f6xHipyZN-M+EKHW6a@XT2QYBP#?M)*VmdZL31d-L@p|w{b
z^un1lw=Z3~WD!7dwGD}U@nUeMl``4pSX3AU=xtUX7i-)7Q6rc)V3~OQvqG{zKj`h)
zv4fz|<nq_C*w5kCmDk_;u#_*6d43*QLL$>cX2(Z7VyceE=-2m-RAGz8Ps7}2UH;g#
zDdyX^t9hl#g~^}l`Sc1cCe`r+VcepAkrxty9{7^0l{gD}hq+H-ElnmH>yve`bq2#b
zUSGcP&Os-~_B4}DQ$t)>T26iM%<Kh7G^h2(M0i}nBfMh{brf|BrvS5xX*UF@CTcz%
zvI}qRLBiTEB_&mECu~;t3Fs%CGV55ts5%BPm6v++_H^QZ9tsJ}KYLLn`qQTiz!uZF
ztEQIpu6uZ*_;b@{K*F)c8Ll?@=`U|?H1T;3w~D<lEseig_BgZj#EBEik!MzONxIe<
zICMW16y+@Pk93vuKN$P);o7L^=v*aL-vi38o)KJ|+wHGa_v+$KmDo$Cks>EdYexE3
z5nOdOFF!Kv-y`)28nweIceq{8a!8I}2&d=F3?BCUQfBE3yxsRXlGz^<(R`>j)le=2
zn`>ebsj&u7SeP<nfBMXs+zUD8Y+Y`v2*M0Hx~%*kMsIbC<VJ4p;gq%X=5nuHrN%5e
zhXe!!6zM6s$ccBTZb!D~YXYn9kq>-^`q2;gUGs3q$-3-o22T%ZHT1^B>T;bmvbA>%
zji=kHnwY$5p?^>eZ|_05HtqZLJV$qpI&#+e(4!YieYunt7v|fNb|nA0g=#rPMKueH
z1jGnH*+o~^+~jgEp6$i9`gm(=c&h19R&JBS^@z{ZbfC|caH_9wCf!eKbN9Y4W%-*P
z?#;GSeJYsB9+y<$Uar(r5fmAq=b=HW;gtKibN7*E4ZTM{PKjL`e|{1DaX`b<hY!D4
ziLtF3Pk#50Xy$Z_b&(1%uCVL4iDh&8{+4pa%c6JBZn19?&kqO^U0*V}8OszN5F8xb
z^^|9Ns3J&Ew_xiE))gqrHb4wq;`V2m1NG%&&dIt3=`M^O&e?`|HASSKRJS>F)0vBf
zHl5eo7!Ct<WsYIUa#`%z-U4ez6b&65=nWZe2LVP=&$)TxfqQd%!`)IP{2x7fj?F5k
z=RSIi<a~Bk)WJwTom}Vq+o4CrYh%tmJ;0Y({y9{$z%@fPNjs?5!J;+$b5siDy;ch+
z4^MJ`Z44;}2b7|{(Hy@*-Hx~JD9jx#*_L*28#+Bw+V!k_bvJhy;MtsYu}o-|_%qCD
zRkWzHGqdf9?Ne@RSvi)diWDx)m={caeW1bZ_U)0(I6z*nb56&ri;;ue$AAL;XEza=
zVA=9jA5!H<+6$PUWq8E2jj7y{gWN3zZcdp2T^db?vRbc9HUeaHK20H&Ew8lQW7ZN-
zvx>J%%pBQlpf*O)zqC2SJO&NNTdOAQ2g>OCO&V5K&QsqnOHQ`hWjaVseYv4A^JL$}
z6H3wYqbIr>5bai<o*nmJR6KXC2GOw|XdTzM2oxTPhR~($S}E5I8k@9yj>-^GHNcQ}
zg1nNkhks<I?-B;ynO1Faf9yOnmAhWnQ*TN41KulNJhQ`hZA1V6de*QIi)^|uH{G;w
z<s^Bq!L;gTNh!~Txr4NE@tOB;3MsR3q<&KG+`45tH#O==?H!N5mGpgl_f0juBSHJo
zxG73azijKGHzYFp8iRlXEGHW$hFXTW*?<52LeLSz{7WYlIK#vQEgBD_FD@G%U6`LW
z$8O1;pJ=g6^q8N??Dd=*mB}k_YX)X!&*t0@W&yC3HMz~RqD3O768obT+=!{U+r;2C
zXKFecJ@bx2iX&BTHr#M>$zav_I`*I2e55h^TBMA%Y*!p$C8E5HW>`$!9NZ=1GIq7=
zL#$Fv#gqL?6=)JGfg~ye1q>>v(hDX>jvN{E_qlgZ0JoQ-HA$+FzmJcPFu|ASBhUEA
zW7|{?Wp!9h47ZtQX`^REl8>|0A*_SCF@QLyl^VX;ma3LKGT=DaD3E6e^dCWQ#6Itd
z3eY`L87wS_)?cW=m3ict<DgBph2Ng@sopuJwR`dmK^K{*X<3yY(#otDp0;es3_>s2
z>~H${#Vw6=lSl7z5lU4DyM#?X6<Y<#1@IXj^K=|;HO+Dd!H{;4ffCwsh+wE7FiRnb
ztq_8UJQrs>&>l5d<sf(NE6*ih#^x9)%Yr7KwzuRDe0qLki>OuTP=QXKV<Lg*G7~{S
zGfh54?$cx1vtq~YNETF*5Ni`RstPp~^}tIQnuvJvWW5p^(Y$8V$H4~DAK8I)2tgGI
zc4ZETN%kgw=l%~pFjvI7VnqlxoA{hnPz1KN0mvlx1=mk=(bM@X<(Y{7GzYqBmg5IR
z=TU7Ztcm=I6W8VFoT66R{tg-f#UJC5o|=97V_8TW-{k8yJ!ZI$hbO|oa<bjc+J7|v
z4}FKB=6XQEZuL7m?{M&Bx_N@`xB}qQJ)Voc3&=p^&6_t?BZAXh`YvYZI;V~9EE&hA
zR)C+YK&hxqE?O`{e=+1gJrJMF+0e5uG`|^@i6^Evf5ZP^9?dr<J7s+B``x1UuI7<y
z?M+@*>4|=&XS=YlilpnfP5+aU@o{?}Zb?nMo{DQzb0Fh{Y`>k2u~rpDhfsioq(Jiv
znVZ@0Ha<*>qNyk`dXv_$*m;Ks@8RT{2wtsBi_9YVz_R*namNf0Ev`L5#-X`A$G`&2
z&oI;SRx~%I8P~@s@_-ts>K8{TH*_jXkp5mLvIrJ)4Zn5bh3D62CWhiKzq=i4*IVUS
z^wnv+@1oBZ!II9I-l{OV{rQ~z-Xj9Yg84iD`s;1yA=R;RU`_PMf05ptFmAw7ZMNly
zT!%7fWA3%%xY9s$h*b?zyPfthibp-t+lw13IC^rcfFlX@g(Vq(u&tG(O~*-kPV+y@
zR*X|U=ibFjcWgy=*0RbujcEUHEr)zo(c*k^TNi?ST-8(~e|9)87m$N%;bUuth-LH3
z5Ubp>PD<b|Q_yv0h<xxBk7H7(pk~l&^f76APH{%Oqje%hiwm<PZ#baOlSnj1Lq=9G
zbEL&>q#y=4LQIivd*-q`p&`DweE$47Si;5De^$6R0I%nKuu$2blbzQ+N2g8o7i!{E
z6V1+0xh?$<X&J5Ik+QgAU~nG0Sj=rAp$QC55V%#eEe~qxtJ&C&IJLXPkN~lupI1;2
ziBXIY0S-G-EjbwqM(s-GyyUf&m(gBv^3ex&-vq-Yh*T^J)<^_!@-T>;9`HszfR}=i
zGE@;j=1NC535S)Jjo4SN6u>eHmHQtO?5&Ovjg5`%`S_IA2pOm6kqoy0aAh=DWJmh_
z2M@|^t#?{$pKx~I)kuBm0*<c&A6j{D-CnY5kZJ^GCr5r<lQJ_d@XtU0xP+^byFkoG
zH|4veVYB9g<rDxHB7j;Xh)5MUd3#kE^G``*Ef2jDeLj|a$OBtMECSK4SXY3iGDIgX
zkD{4l-~X7biA!&olYEGX<(RUfjm>M9ulM#=pc_1|to%gw{CQ#UX+kIhf(34qj{hHO
zV?!wEr=;e-pS;uYzMvoch$tFusSb}|&kV1{MIJ9X)SxJkgn6Y8Ht~n|3N|24Sy&1$
z68d#<ev&Y`48we6(7uSpxfnF13`2?aoZ2UTCqMT04u|fK8`?l%A^8Q+N}F@+Vup(r
zJ>K$W-~1_6d7T(U$|qry;W(t3>@!-<U(|;RPkXdeCSPPZo5(Mfi!G;OEgg{W<LHW<
z(5KK9IHcz;AmaDrU)TC2j(Gv3C&=(nl(BN3v4L83I~o$Tgq^?ZOHMQz<l1)MUvc2n
z<&yKQog1ybt|7O_s)!O;SLEqQ?$E3`Jr;~UqmCatJI`^bCP5=D{c72tr%#`D$-1z9
z>u>5d>_3IJtNh!y{|!W}ie?q{>8kfdAbR8}a$D)?LV5v#@wjk2vNsx%r(1<go`E$u
zfMWc3Jr`FZa0bMUg&MNOT^L4|9ffVB8+!SU9#sdXXJcc#1dO|M>C*L^H}5m>M&KK+
zx_GbtmlF78H#iSMXPpb+O9cN3jt4!O0yfiqfNs!*4hwTGVPbY?kXLGh1dZ)`Dz=0j
zz4rETrz%8>4S)XmqPVzd<m?lGyZ_N;+(>_PG4eL<G5UZ?+$%Itq+P<7FWEL6*e4;O
zefjd`0|@K;8+fB3tMH15s3OCt%FBBvmzN5IY$r>J#Z<v^ynXvt8C_e8hMZX0sx0zC
zu!H)*$I^g08~~(nb0wV{4o~kF6Ki^WSp~aTCBsZb2V{s@Q)-lEy2*1?*f=!H1UM3g
zI)-^Q+=rFkx$39dnZFC`2uh_|$@!@tfCLCYH9(Kgh;=3sVLwvhx%20l7orw+@7i?=
z`bjNFp#&72SaiE)U{7Rpd(j0F!tCVJw@SZ4=lh?Etm-sE03+k1yHDE^4jPG{yjYpi
z*TK)8ZO<^RJ%e1?V42kxjjXs&NT@E-V6DE!reET#?$<;Xx)~al88D?A{`liL0%V|C
zdQln81g)f85v9(o@%3|32#|~8z{YcPBqp8lGSvAci#f}B{HCt<fJ&wD7tOsuW;lbk
z?4q)=a-lcf6mr)9EjfZT!bv)LJ=5H(!+#a0^8MNz`MZjiCB$<{IA1`0sRy!-L?_SN
zQR;LWY_E`g-vty#ZPFl2j;?&2@Zgt7%s*=A^|T*#7ShHi?=6Ca&W)&l<OiCz59P1H
zYsoU@99zSP`s4r0P2StEG(ny`CH5$@-EBl;&j(Ty!rjMYS943KlRnWw>^Jp|zw~FX
z0QLRFAHf(#qDaz#d?E;2=C{=<yK}kZG`<kHa#PJ3yw}o$^uK-z)x~lNoAnLF?RvcN
z@sgFHVoCx0dQ|}e<xhEIK$EMJ0v!k4gx^5?21|MF(*MNY2TwH5_2$V1(NB5R%z(;u
zd93kYLgDRE47Vuz&erhjrvBd1@ZvN(1(Ms$9HUw#MuCf(yoe6F7DNRTSTYVRBe$M3
z+lv3mJ$U~<oMM-x7w6J$uih4ozh=?4aB?O99GM`-$WzEP+<W_<l|}nv5i4fb)90rs
zbrJurqpOGlG+wqh!enBwDNZLZvzP7E^V7d1dJF7!A+x%D^HW{a0aDfGk$s3hY5MKM
zBi&bPZf*D#Vy|lxGz1Un=Bq18GM}K6x7CqCj4Mjdr{k5q+;cwo+sRw|<o}ZmPZD|*
zg_7j<TX*gl=V>>k8VVbfteOYEqhexWBBgrw?e$-=@U3rQc7%4Fm0dZ@N++)uFgu2o
zePbWq0Q0!vzJtF$^Y0{V&S<>jI5gmyrBFa#lE0t@Ddb&s>%{BiU+#m2=Lm1j*ZThq
zEgwQDy9hAuuDyY6*{}6{XpA@1fQ#*tC0xZd;s3dSm(uS^4?D6~{MXO$GpGJvXx`vw
zTlG!R+VhQ@q0XB^z8|;gb^YV!NNDd{4A!q*`wX%t>+<D9C?xf4O;5G0-dQ<0C8R-8
zA|E~4Vc_j8aNpP0U!a86{pKGQ*?hqtpW=KR^@G&4;^MzI@T$rKiGg{FTEB5)^!M*J
zDz7dae|kXW5_Xdck`nO?V7sdTkFU&XeG(iT=eJjp7ze}w5y3UYfTrq$fSwD&5}0HI
z>Mnrs?%lgVbI5MlvgN*y&+dOyx08VM;(P+Zy)Dm44FIVglskAWC2}dSeJU@{{((Bu
z_x2V$kzi26Vo=phfd~nbNtRo|GWEQ|CSE(oHW!+49pSpn>d%2wQ6cw<LZ}yDBAb$u
zLbBN!Zi!bNo{Ktw-Jd$&-66mT&;o2<J8k#d^C$wT*+AV);OS%a#;DfB-r&Txl!fPa
zHntitdCX5IIbyNZ6goI|LdM=L=RbbQfyMn0>LD>w;KItdTZk>PXmDwtBV{N$TiIT}
zetlTjs#P8M`eKYiSRJToEZcdM{6fCUy_b}f9A?H%=h3HVLPbPwilod=klIL#dLws~
z2flzW2hbST)Ws^*!=({GdjvuG&3zX2(~$hf@oR)D0A@*b^8jph?Yy;VyjD?q`kDB8
zdtj1gFrkn$pKTE|Lb+5%`>awOE?FO|v^N7^7k79`NJ{EJsH?XwnvcdSH^B=)4IXvS
z_^|g!QG5&*`~})cMIu+XkOILLj(0#u8MuICmZlSphtULeO}G})$xW+su|)<3Zk|V8
zpMj<bdqNx%w%M2Be+D1`ZWXcUJA9QXV`^$js&s~Z|E1HXPMLrUys3I?J;}2B#tGbo
zo8maCXqrrej2G+rgW$720r=RhN<IRv+XPg+xbydC8~L;YIqH{q-q8pVwQlIC41o`2
z7he7OlXuprK>1USmfxZm(EAv@+aZnAQyuOMAN1MpBoqE7d7mxo%NKoI-1%Vs<Anv<
z6&BV~Xqz!WTu1ABNk8`2Uw;9nbw<Upl)_j-ZuO8(t}?iUg4-NCNzYH-i32-R$ahF_
zVx%LPpaoL;@ojgVH3whn>upCWe)yowZ!aBoiqSrCv1RQ0)S+X1wT}Q4kB2m*`)c`z
zJRs-+uppPv+A;egshTsJY@G%hpUZH&oPr2g3otJ4%zBKxjAx%noiFj_qK`8F)L+6X
zgZ@qhVnx7=h*{l-cl9huP$fd8X8LwQ!#vF)@!c!xdIFTZKDbAeAm#|6@{kUhw)@Qs
zQcnJU&Metx?cBX7<oDNJ*CSzC;hV%dy<EY&q;(VU0?L{)g84I;WQwbQE$Lss`6-fG
zGXolI{kCoNG|ewOu#FssYO=*3)QnJa4o&<14!n`Qm9gY|0)!`egO)Y(W9~{^pbMQF
zfT2U|2pB3!?bTnl0K^1KQF7tYd4W~cAs{0wg&&BOrt5YdySyH4Ybih5U)9<7jv+9f
z4CnN6XU)V!MfHQ1`h<Qq7AX&z4p`(80n8}K63V+-^gt!UutTp))Dn%E*<vsbu<sgs
zpjfafR4j6nuJiE@kJ&_B_tDePiax}5ksd1e=(QJ)L(Sdw*Df3;9zCxUv7k!%m~sjV
z4Fu1SRtF8-xQz-+LLb3UwM!b1+we*~P=~p;9=Up#pb|nkgW(<Ro1wxRfZlTeukYJI
z!)$N4-<M#$m5`5+3mW@9R<2x0fQGJ1_lCE;&(_`p{sRnT<j>)k#_N<6T~hukW*}P&
zyG>X)jI`?z5?JPXG<uuLAVHa|R@(=lxKBE>W|6kU>qHDuL)!8wt=ZR_(adf-uvFgx
zkiV!MlA(4$ONzlAtVaod>>F$1*VuW+`_nQGiD$^r+4<q58~SGj_a}HI9Kg<1Z@7En
z2Z~xRj)Z2LtEjCV3XZG)mKn>`4YVwhqyMfWjRG<3K;$IN4>CGQuLJ_Q4d=*!S^SLN
z(Ork{%SHolsl_=v=5U)9!p0$Y5eAaFcs2gYaLE?-`sc5|a{q|y{d$G@wG@)5p!e`A
zFDs4!p>>iNpOVX2#@+*OlNRxO;Njzdo~M$eFFi)NA@ugwfA7uZZkO;C{1MJd`Oep3
zW<$jtKC(ZB(ZUk(<vP<JL$(zhBS%`gleBY)&qKXhg0ZS|L;erwwO;(qo2rPL+z97e
z=O89?M0m`^66X$=lzZcF4pK=!X@-p>C_OhmUQqwl26}1FgH$FN4R@{YW&s|G{Dmmh
zd2cW5gW>H*MSZvztOJdZqj|??@BXpV9?c<-+O4-<Eb(3kbn~;(GsPf@#1bo<YGN?D
ztytvFFlkR+QbBO5fxE?=)bQcRD=Q%4Tp}Dc5F5#CPxmXGdAuG>5_&LVKm)<oKzb*S
zc~|1eFc8j;vuev7XwHa-M4yE4#1=6lu>Jlf{-nQ7-`}@;_i6AVq&^eLpFAkpR^Ug8
zQ7tMeYT9)jn}lb$-iIQCO9%z~+Vi5Z$gXi(SxEy8iSbC3ub^m=zLda<z`$3?v!wGS
zG80}|I($8rZMiD_{r%j{S4KcD`@*I1oHT;Kra<`71ZqHLY|b2-8to$VL_@M(GBW=g
z<H_e=8V9z31~F^NM4dB>f=Wl)#{&oyG`JR}#W47smXV?37sYMA-OaS_NJ2+!hQ0Xl
z!-wxf%fJ1@UzqjnC4P0Fy&w-(!i43kx4y!)*<cX>tbqFS3@c4`1K9ODs>!;EutO2G
zH7aH4vSsy2I>*`^TPz79fs*xVth=0;4hS~@Hi=I=`x%%ja<v(}+jQIRa}jgTSZ0O1
z<Vn|$Z}G|U@hq~a1-@-18i!v5Dnx|kAvB;0$s?I9R^_R_fLIK48zB(gdYhfFZ>@?v
zAPb42U(IhSaLeN5zavl*h~f~8#|}a_&`WpIgKo$`*oENRx!QRGCI7<8f>yO=e7LOz
zwt^`p=aZ{MT8W`;`Qwkyr;{HddIRDs&oSQU`N~2H6<xPiK?r?*05AVPgq8||%d)>N
z)~~c3pukOB<s=BccT9Xx;IWbXT4Lo<uqM<!XbfLdG;)O%m*Y9Lb_b#3$W^%!4?SY!
z5iJ!!q6h4aFlax=9DlHS!N3Z|#9!1klA+@JM^fFRHo5?K^)#%L9|~&S%%AJlRU)?=
z6E>iimVD*?eWSNGSN5R!Q=svzTW8P?LD_xUBCSShsJv%rM5aBkw9umxPM}Km%3ju~
z^yyii2TrZm?j(9nk9AjqHW_P0%}n7dvVuk-0CIm(9=Ba9Y`hm7hx^=UX*4dOOQ{Ac
zX+~@pevco2O=%W{ds5E`%CG`OAgzY;NdinbjJdCYPdrOs0>FkKAdcx6=q6}oRoM@>
zHVsYIHnEg%HXxLUAs2R>5D_cfLcsM`!0&V(q>)-rQoV2D<HhCb<ez!flE$5N%o`E}
zpbma-bhCPDaFf@;exzNpTwF8D$`X!;uj8&s8@6pT=XU@8Mq4in(sVQ4X||*;lI}FE
zXhFqf!c<R$ce#2_rGZ|N5sZaBx8QejZ=Rc{zDIg!JbMH<`3MPNB}%FHmacL729Sw_
zxc&3bKSPs*lacbS5Q}bdeg{=*=G8qPAExF|5H5XXtFYNOC%X${mR{W>j0Xmn7C8Oz
zJ}!e>{%UVog>7`07=noSQ9csGyF|5T3nw;Y&-+b!LO^faZAl1&U~J!wQwH(hJeR2E
z*mhR{vUM?M3g^b;)<H*}m?e*#cf1)$&l*TKOjkw$-i3kJ4S;w-kUm`P4;pw+e|^9&
zZ)0QgPe%-;3B*IU2$eD)46jLW%(kKveZ2sCk+=-7&uO#P>=Y$RSOLdzkjPBf+WHW9
zWIKlq(7n;3pcj!tQBx+ag48O!b0Xc%e7V7)49^HPL2xfAO<?_muKfFZGF9cm6l3n~
z;^>4xf7P*(I+#xCv#j;h<SNq8KuLZtUPekOG43!&kDy&v!1fK6bju_)8-l-!{XCfD
z&#)$<<@z#_do<IvDlw})4%Ri34-a?f^3Y)|YJgPjfV}BKNigs3o%9bSjSfDCupZ22
z^W^<U8`H9GQQ#0B2Yqhjl7Nieoa+#81to^+yIU5TCl#r$d&0FbX8u7|uK<hs>LvaW
zykO>t;gCqR{e@Mn3E9v*nj!8%W$GS3nnXOs88)3KvQFNHkTZa=s(}t5sjShyo?llR
zTeKnjTGyC^w&%BM2D^p}BT&d=&Y8ljSA$b5J-$2V8*pJA7}7X+9{BW15Xhm#G>M+c
z&C(k<Z~(>vM{_PtElFe86Nqt+)D>$3q){C(G<JnWp3}^N-J;k*G+aCmXu#DXjJ6f#
zAe4X|vLyMFl#38_w#>)J(jgc-<Veq^FP2eVR<Wpd!42u&G&gS>hU^jqbt1s5Y>0bx
zP$Jf+2RWb5r*kDbxq|Y^v*^u^z}od)V<?E*ZBU>n@W!PD(Dl^_>Bo}RTz=s$JzD}A
z`ek7bj#;^SwZp)?efOVlVU}@y?&<~@rqE{7+<{H&seNJ!3Hcc1osA+1e%MCrOu5y&
zH+P=n0(iEKU2Y6|@6(e5DhE0y=%^h^2>7LWinFO2qkq0_?MX@26NCqdVc)gtpfnBM
zG1ld|6Cyp`%5!J{59t+ZgP^xJU8T4gO(hHzUoLh0@VGH+1CZ@>0v0lIo-rn;S>4)?
z?jdl=x`63_%+Tc&=)-XkLvEB%5ZZ2(Rd9}R!x^%eT^C>wZ@h~0=mp@n$q(J3No>FW
z{s}0>-`cp?b=FNz7a?0^K>sL<?hyq&)4e4b@@V2{SLv}fDy3Pvn<lZGC4PJHfq%!w
zPJd6UmQunGjy(?!C4!YgM|>o)=Ppe57AQZmJ2IkJT(B~AtaqBV+Rk1cHMAZE2+GWg
zg?a*e@ls%ap>C0K&;ICth_1}zn;3o#$(4?MpY?C+nl)=0;QoG^Jn3q8YwxmzIc4-_
z?p!0Fwp7&B)x!gfBbKvFu}g8WrL-3Q4$FBL2>T0CDt=@i684dR9ylGtXXL{rnxaB@
z_U_&d{r5C-Xc#<9v7i-h-MSTveL~#gb=boJ!y#m(p$+Ia7`DAy3j1H45qjSxWJ+J+
zsUT0A@g+0BC=dz(hKiTo-mAz4Kcty{0ajNX-CpE#CZKzEYsWc)mVj6K(N$O4;mL;C
zSFNhUt`B9~lAkCabYuoSIBBR2uU?(X<-9W|T>Q}*%s^f7Kg$5#2PF<wORZ-4zUh`!
zF?<>hnR<7dGcD=kMd{Yf>9WAYl@rtKoA{1qNLhdEf1r<+ddNevR0EF0I$${h7oifz
zpSZ<lRvYb8Zrmzl(Rg99%_#z1UZi$FBK8p=WbgQ9d`8_)s>BN@MB?rXVNUIY^kl-*
z7w<IEu8_P4;xm2rgzDzrXGPWg)(5;9J8CmpbY7fVDLME39bck3879E~&j5J5Q=Mf_
zQ^4-el`~dy7;e=7bMYDYKs&Bdg`in{2`IE1_r(k1WA!!>W!N-z3U|ppUcPGc!(Nv1
z2<)bDfS>`uNt?zP@EN4lQR=d2$vlq={Lvu?A=^7O2c;_+4=FA@kpb&KJQ4?{LBcL!
z>;PCe4zDwZX|N2$3hf4mlu6T<?b1sVVB0o<uum{6)bjP*+)3bEUjaeuifQrf*>i?a
z8R(#%0E}YS)xWxU5*hy*eUl4gtNwJ0luv$HXerBuwbOHFv{fz9xjD=j-AC7Y%|$}Z
zs=dz_@7YkRJa43sKIV!&Zx$?M`gkbU8cew${C)venr>*2*8TbCW4gH*j6yLqN$d7}
ziH?e6hYx>pM;oa?z3eRj9GW@E`DCnj&+vj&(a}9Fr5U9!iJOZr(HQ-TOFLD1c2F>&
zBoN|jc!^E-o?$gP2#>^@8H@YRG<brIOFXLZd}a%kATY<=2YL6Es>&JxCMr+`V7AVh
z?1Jsg4!*L0%+H$*q^7^Ev+ME^HOgB6xgU7<?(YFKPvT=n*(*AF#yQRxjUxkTBm}Ln
z6l^6b@&0f@-oBIhZy?m6Ks<5F`a_y^ozAE4uNNT90g*%H=tbZ>!YA^srz^VUX^i4V
z%gZI;$WCAS$z9jWFr;WPB@mW#&}t^63xWs9v>{2y90k^hcneYS&x6?EY5@DZfk3Wt
zXY>L+2+C^41n#qL*Y4e7k_rlMw2UBlkA!L(!~eBkD>Ff9L=79^yuE#TEfXH1=2W1R
zg-z+#4;Q)Dv$Y7A!qlWdO);xK5R;jL(H|qYT@<Kk@MlOQc7(C~FrNdKxU~C&63Vle
zKT`5-nj`$Wt;JLKP5P3vgJ}v>Sj;b8ycmtW;lgbUj(-nuVpIwleIU#A!WY{p7_N<;
zX$J~q+}8Fg2zwzYr9Gzk#24SamN({0-uB_zb}Q92uS3I12{0=KG*!=>?&5g>;_U|_
z26<98D*qTze;p_1;P;$OdhW1iML2(58I$FL!l^*@3*cV{TbqMf82iS9HvN)z-5i71
zHI4uK6GJ&tpo&6Ajmfh6_wFC~MR?ai%{`{)>a2bZUc&(6H~r(8t;l$MKBD@?UJ{8#
z&w$lCep4r)4b@+P8iL<h7^Qk1m28KZs;j2y6}H<ENa6m{XR@_q069(3?$jpJLDcB9
zw*y@C^fz8}fQ>a!&VY$_`@#@;;MK3Se?BnPM{mc$zlk*rqe*IuGqj>~2*|K78s%9K
zgQc77Z>+5SZ&vWwyAI-g^cPIF+vRq^bdp4RyjUsJn@gau?6jj{s!>Q}psp(%iYR-!
zO^gO#V^j*;_3KB99*Pcg`-QeqcN@ADMTQ<!fBiRNNP&sMJ=$Ct3KbQE8=34<m;|+z
zR23mTVqXMR<eRA&Qg#35$UA6N>Gnk^jH>Z!$&R@l;Ampei;B0ANiEVG*3O4^-y1nJ
z><p?vCs*+kEJGtT&ZDEFTg7Z&)=F<Y0vnG`p?g#R=-3e&U|2*vV>8R##pgx$+>Q$v
zeq2wT`^^^QoeG+>n3<O`G4zhbg{*ReLXe@v(H0)Sf9d620_foGIM`x%f8(J6<<%fG
zZOo?SiP0ADCv0FH7uQgYI_vS{L3$s;_WH_#9b{e*79(0DEM|4!#A9YiIzw+g<}8UP
zX#k<4J%CsG0t9S7wvS_+p04N9M+Wh3WZETWb`b8?C>H5j-sJojz+d8A%B>DG9Xw-%
zHn*r~_)PoPIM|gaXpZ=p^B`&sy|2wg50fc268PiJ@LFhM%z`i>F*7O&>H;)FJbcJ8
z^6-BwQC)&bIO)Dyn{>Z_$hFEF5{a2TsGWUb#Trf<mkRJ}=g|n;4HyqWM+-J6Ub|^i
zZ(X(DWPhy;ng&%13ybjCvo*Mm_CkH$+gHyj_`g;7mA;&_MZJR&n+y;{`GX3|ni*+K
zdDqVp4>j6F(-+TXRlrn@nT5-uvS0AG<c(k{(Q+se6Nl0~nE@FK%t?7G@OJY~18+G>
z*VnK1@cG1ej*jA`I+;qyHm4a=Yk#yVwmP>d%|$ta)Fs6{*H%7{DF5)`Q_%vGpGtAg
z`SWl^gmlNyHP6{0(HMWEco*Ml9{6=*nNab}!O<VU8&#VB5=!DzQjy1ROb#<9wUl#D
z_I2Jm*Ba1P-Q2q?x#ew2y#oxOm#}%m2K>NS;WkT#QXmYQ$4r)?YmI{+$%;xj<SBVZ
zyZq_=!JRwbb&mp%e6x>0@6w&SYF3D)IAX2-bPjm87{#(G1*F9=sbxFB+>{6KJGl)a
zc^}Piw+h&3*_8Uee=9hSm+153QP~tGPY<)z%$=B!aFI_HH|FR0$X^w{Wk>h?k-vNs
zlk5y<Md2#~VUtxVg()f#tJXgIA|T8>$%zcMj{<+~*|SHll+oZ(Nx%!FfY)T~q1N*u
zVV0r<Hzjosp1(udg03ygkSiTyeet{I;HgN<L|}N#Vg_du?^y=>>mzDaV;|^+Wmt@)
z&`QEiQGG@RgI@i4*+ZdKEaX5@3Hz#wd2^{B&kEkGQ3zJPeklab*au<}RG5SWbuM%9
zKE9(#yauSRj<Mk=GI2n)uBf^hP9wU&^9o2*guQCb<x#q<`mkqHLM+0D5J)KFFHrb&
zLCszS&{4rG!qbBqm+)m*>L$@^77k(j)PEkE7k$zw@}N+CILyN{%Kr1*Ii0t+g$@fs
z9LB5s$aw$lxYd$(z_lY|MF(|>37zz$+#XYxWouBW)2-UX0m{x0mp?EKePZ*i<Htkv
zUf)K4X8Qfh8{!}+_w;%r#;K*#^>KBAq{}MX-Nl6ZD=oR>kfOMZWsWsq?b|*4(peU}
zbLN*eqUMk(8Y&f52o2^)haMnOJ^J$Jc*Uj|`XY~4T6*9tTl3uYk>8dthr!|U41g8n
z9T6;)@Am^dc)s&6*@O;bNNhjV$FuV-Ys@Sd^Y;c_?}Cl>We00nSQd|av2OF6y&=h8
zl*GW!Ci6$SiIKQ#SM;VoOfmp(@9uD@0iCIpj?1uK^VqRSz#(ydfVsxF0J~m*k_j#r
z&RbfH&~UbJSF;k=g&mTtr~!faP@fy0@aZ(ub|2l13;AJQ0AmNpNFE>W++QdRHANvK
zJJfY@IE>$5=E3!&MGrl}#xaS^1<x0ui;~Otj~~qx-wVXm&vTo|nzpv7rDk`j)Bu5!
zSSijG>>LxOEMC&vi?5#tF+kC|t~BO)zyrk%pPER71=J7SqycN}6B=m!XD|s&wb2I-
zElh~3GcQr!?t=}8O!q;&D4o5sgHwx9^)yW$SVmIwhQJvx9}3L<n(6yyLsw|bXI#Z&
zsdFvaXpyk+{v#JYnY6gz#gei1JuTT-Fd9B*et1E#{ldfEP5GoFqCGo)0~1P|UmAl&
z!JI2hl1VmauBzpxC7WZao3DG4wNl@L50!9<y{>{FKMyuZ8Au9~lDFNrq`@0O6gTjo
zV}=s(2UaoI!za<X(!<?`ubFd^QC(1}gp3C@cnNe!9h@bp=?EB?=r1Sk8<<yl3n=g`
zBa@6^ft?eUs|_22z3odG?bK_GS;C^aevrOYpX*ltg8@Vz@n4~Hl_zS#at`jndOa<o
zLXpAX)qrs32I@MOgY~|96Q4Ag8b0QEdHFgr;0#4kl}<}mJ9FlYZ@J8=Q?H<}@cG<Y
ze3v5ZcJ10Vg${tz*h}1bkK9O78-91KC2ek0{wjHSPuJ?d*#il*Ukau_H4v4(56YIQ
zd0gz*L=LEd93^a2u^BT)$HBEIqa8r2!%JN}QblGFpcBBK(HKc*Zn|~N<BcSL{`c#0
zMXeK9cyj<fqEl>&JE3c1k>NBks6l$<SSipHlj>d&w1uG_NPD*LG<dg2_F{q;3%kf(
z#c=!FYB<rx-?H;NKM$URfc_l8L$aMK?CB~H9ez2JREfSDCATTY^Z3U{0DCE)Ja+I_
zFxabjLG_>U<?OdFLir=c7=@06t?h48n2VwCyOQBfB?_UL(cU;;odbM1+E)6sON32?
ztOoxzBt=e?pMEJcGovSV7Y3lcf&Wkig1ahA=_({O3^pl|F<jK4aynRdhkq!Qw(sVy
z3+6hF43ASTK!L|R%f7d~?7S7F4S*41ZA3HT-d2QYQkcBfo$WI?-L?B>&i)D{;_Zun
z=)dV9?OU!Q5Qlc|zoi|!_U<KJA}E_Dq&*{27eE+aVmvSmcT$z~;i50zVEx70dch^s
zVo4?SR^>+@=F)N+Ztb^^z}t7Rn1ghD438FkF?&NaWh=|W#ou4+6OT5puyB2>6x!y4
z_M*++Fo6-&f)q~%mlP%e0wOoXrAqZ|3hf+>QhiM9Vf@P1=PrH1klErwUM+=`{+i?!
zy1Wp%LAKiDcHl~F+}m!c9q&L$PgC6xQScq0zjByif2X7<8HIhX{xvlW+(j%#E?jgM
zU>D_E{MZB<&;ia>69T!J@o2E+x~B8cdOY;h&e5at8c*-AKAM?p4SbX9KAoy0YRiw2
zFrwpN=p#pX0x?KT05LPC&YU3vftAmLgarGQJ4kus`9t4D9pl)^ayI4IPb2olHfY)g
z(3{tRaPRu8sY_w1U^Mg`W)D8tMc_l}LB`=_j4_l!SN!Bv?`u(~i0(w@B;nt>Eirj*
zLhV(kVYgV{2&0@w!$s=bF1X_QrLe(tU;XxHsjA`!;2H?IFEO-S9_vAN1IF#Pfvm_D
zvVz+q+;w1o%xt21$_XSdKA)BJABlP=-;VLu;8XPizWAdrt%~B`i&%5)AG<jy0r_vH
z+H)Zi51@xFP;Mt}>^X+1w6A<RarVN-*0%Jazu$bc`_$1JAe}nq{z2B}HDj^x5;j*r
z3BgT-cD~f{_Bz-rcQ6?WlcqH<?-7PNpwu0+CEB@L@_94<GFBB|_5cy`g$jN7%g6J3
zq3{n+pBVd$5s!3>rXw-48^C0O&{Dx9b?a7XcwLeUCW50CBdlf@@g};b&t$@rZ|7Qp
zoGI4UYxWaxzk2mbf?w-X4_J`oP~{|T4Kl=#ffNT1s1A|bknzSLZpXobX_c&Zz?rdQ
zZ_=Er3Wj>Lx6(0_`3aK22yXwyGcGNPA-b1bjP=yc|Df<Z9wp+2_`(WY0b@xL>i780
z!|D=IMXfeq@fsn67FR#4?Ya+)k}ISOi*T(0>@Y6wdDc1I8v`<1HX9IK1Y}2FO*TZY
zBfv8@+3jF<0tu~aDk<a3c`dgmKWVmE6+^Y;V1YVk?3fgg4L?<%(g%0%?h|6rn~9;A
z7&81Y=WNhMB&C(V|88U60pI3JD0pI$6OeS|ot?9ly7I?9@}iw240wgZ{ExZo0z8ES
zJ!2b)%31>tyrZ0?tnFOTeULE3GCT~tgG4NYTkK}*)$|-(wGF%pR{$AFDZDfX^J?<Q
z*K!60_*k@+Q@Os#1ji(ez@}((TLYY+jRl}Sk)h}|%V=!rpeCeB6RQ8|He>znFR*y<
zF}1R7o|6u)(`>97AepFZ0W%w6M<S(cq-gPn^8)cE#-|7VieMrj&<5bov;z4AFlDHX
zF5wHzVN8|V<n};Wjm7dQFySTt4AOGL=Dt=dGN6SxSWDQjWOG6>lHh^6*59CweAP19
za^Nmw$1yTdldA}YB^}q3XcO(ez0K;!ZX%uh)3IIqODFTUA2?g8sz+>oFCrtuhSgH8
zoF;A_SD3+V=N{d_wfpf(KcT1IuyJG0_)+i<<cDkLA0Fe?Ik9g;K1Ezw8jk$JF2?%G
zxJ2Yhg+;j!^$HPEmY~QjH}dORs3xdihBRtTNR@@@YEN;_>T`=@H5j`itV+X#aYL3-
z<yJx1I~dRuf<W<xz)#UeMstn8%@J}VmWctaCd^I!Roaa1(Tb=sNleI^Jurs|!i<zt
zC`Hq83Y$hJ7{>i>b8pq{vJtU;E{l4b=P4dKZD+hUciLA1&-4a9xzjVyWK^=*4)v4F
z%i4kIHJ(<RKsy~oh@>AxSj5UNA8;f^INfpmOTpJ{H7P1%ZClind?|?_b3;&bf?$jZ
zA<|~G)NF-CTW<Xj6aAn_b<5?aBZn4jm#d<s*5R&3SZsKS6_TQgEqj1NH4c6T^Ay#B
z20nD*a9JfxSzNw`85~KNn5*h)8D5F~AOO>wSi=Ika9TGr0_B_tfIXlggvh}jrX7U^
zaNMT#cN7)5z)(_wHPD%PYwRrm>r>h|c)PvDW0TWQn}|zxe1?Nd{9l3n9EmW;pd~69
zvXq0B|IwpId?RUME?8f?Hs9;(^*5v&#PcspfS)MMpma?@W_<{z%7S~lB9f_p6edM(
z|4p6M^hX+4dJqyp+9`(15`QZ)f?Lb8Cnx1A&jVjg<YEozD5Y5)I%HCSjDn?*<1|8$
zcxQ5zkD;XhxI6x0u<*OfNR!kpfOeu9cUKuEoiO$ewv-O-tmn^I)mi%+2g+IG9uqp}
z9+f)zHoh|$^8>Y*B#p^@Lo5AVuc7mtSNBJWN{e>3*KBX4!t^3ae^VzU)@+I7Yugl@
z2!qrwSh5)qPZ?=((qX>{kndJ;`&Y0Egml@$P)9s3n5tyNrnXYX%J$B52k3<kt6k`Q
zCSA=hOT2j6+@)cKtPWB~kANh>Fz$Pr;njGAcOl=7jtwsj;*-fiL9mu3Czn4QpB%-E
zUnh`rM6%p*Dc;{_)03sJDW<6`yqo^`;}25slFPpb;VDp;<&HTGk2~x?Cnr}6(+XoQ
z%BVK_Jkh)W%{se3+GfGjPpr*+%tIgSK1KABrls6q!~RSEb{Dd`NNLlNXIv2!6rD4f
zY;+ze*6v0#R^kpLT2VxUzV~OihGW5^Ml>wx7@edvt3{Nuc+JUR3<ydA8I++JP7$wv
zJ-{9^^+#i2P?<k$BG5Uym5XqG$pFy!MKiOwfCJ@iAi3+(j1`gWbLxtoRUh{Z(<5TJ
zi-gn6#_?&JL}a6Wc;v@tj>55mf{2dt2bEx!ki4B!EAa~YyseV1>D~g<QjQ?jxGCco
z3oz+}zg@nXp|>MHSbC(ka0YVDH&Emff#AVl4(g&GaX$b`94Q_2k>A+7ULTYd4m5_U
zKRWhBXc*)e9elVFchW&85{|iWJ;PF!)u8kV@3ATweMh#vOABdi5!W%ZI*HG!@0gQG
zOjneJg3JX#&NzTc94ccIr-xM*x9|HB75D45LDLdX3>iqVtN>pTk1>46F=q;WR+=+t
zl;(gRt9sh&sSI)YfH|g<TRwE?JjOp?kkg;|d8W|KkmGQ0-b5rGBs(JstYjRR-r!?S
zR)urClbBVrN8U0;WjQA=KmI|SeTH*9YZ`MP!<Swi0aG3o6LYL>M3a>wrEOjjDBy}v
zmGp2dCYB<cod9(~kzm4H&j=}sgeJ9U|L>)$@l&9vNkco2PFR=69Bm|Nc|dRXGgH3k
z&0UL_U_y!AzPMJu`{I==F9^i0Ph**T4=t<?2StG>I0sUfIW>dyJdXBu0QG=IID?e(
zlLUxEeTJXr96YRykDJo4GUjkU#Hl5RgRk!W?6ApStWS|aM?}=&6UXxB00f!v(d9_A
z*Rz$oXE&2+E<z|Ew_7FS1Oy%QTA5h-XYhBNeJp3}f^lKOZrJ5<d-jZ!s`83?%w?0Y
zhb7CFJ9n?(BO|ZSOiYWtmWaEIy)30sLp7%Vd>cRA1-}Kb%HIoP(~3K0h-E8G1Jzho
zQPF9p*Q&OrMjk+jGYQ2-Dhp3&1iKR%-BO@=GU=%p*JLDn&X?c3bEj9X4KPEPXh>pk
z=af4b7p?%P5JvqF#eFg8q_P;lU~isdV`mox!l}r(jW-z#&88@rLse=I`m5>$?VOsc
zSFavb(Szk?8lbEK*vmSr3eYSF<LEJ2VlfeJBRJ2emac_Uf3%V-A-RQdGf;yVjc#51
zr40nH=+xr0rZGbg<4jMS6VZdWAc_jiSLBN%PVPS%56PWeeE><ZE(Lu>Oldwq%>RN_
zB&hj?3#tD*T+u3CT;#}p29XN<GRE`z_Xu0JYePI#0;)Q3^5jzxvp5@w*rCt_)Iu{O
zrYfS>6}P5!X_8Tt_WT^e6rfQjz9b+Wf6P9q0MZa;4fbMScsL^;6Voz$c4R=B<k&H0
zI}Z)Vrul;ZjmG8s2_ylr8-pzS3Jo=Jm7%zkW6-eTWVQr>@etim4CrSQ<VmT#CsBth
zkH=RhV-F0V`oo^k_7d<!4in$!Py}nil}DrHcXn`(wW+)#kKIqYOyWRmbMEpX+C8~Z
z4AGO>rvnGh0hfM;&w)&jkpT)AyO|D6w{914Yb8eGkTo)a^<#l7o0Sn2D%c)mK#4GL
zKkRGB>E!q)VqYVl0tO9~M`es?&zU!0IcC#0kUG!~e(IMWzl&G~$)EooA^3mz2*Lk;
z+<(vM{JFLMd&cR14|M&Xg!|vqYyW%l@6WXG-(!w{jjyt>{9ia0$m0LsyZis;c<oT|
zaRT$b(u)N3l0gE<=-?1*X@(mPKrMMJaE2U)>ahP7n_bcOD-p{uRB~u(g2ky*r#@^p
zpn>BhQ~0346v;uL`rG+;Xk+Sd1Y>+BU12tI*SW7m=KRr*pH42Ei6i1Q_=<Q~4RJbX
zXtLb0{QEg0+@6v>Z#)HhF&5>#s<IGcY=QYx(0wb>3iL8uO<k;Ufvf^gax#Zv$v!j%
zL(@<Ir{{#PMU!(+RA<2oTR=9sjENj0GL^?@9%D#OILzY-j+AT`v~HJ>t5<m#B3(g=
z7x9$pF%;1ov|DJ+r{wSZ5Rvxtgj>!m{T(u(f`|w`v?zzMJv1d|=qhu&e2>+kfhO7|
z?0>{0>aM<jP8Q8FIj#;~A{oreF&)Gd;3}f->c=P*QO2<}6zxAAN(as+F?tQS=hoS+
zVez_t2NV$IMVq1Q`IkZyiY6!7!r}NCou>-eRtoq>GN%Fhm7=_Vj+|Wt)mIMc;$O1O
zDF!P%iz6>w9?mP(qq=<8s}RHB-$tu1-)_S(5a+qLa1O_g!8T4N;ihtT71OWZSgb1W
z^Yf!<uY6b(IE%#RWj#G7eug)*!c8C3qTRWJ=&5`JN_OGUM@S@h%9U~KY5vSWyb&ZJ
zqFVl2QWA_=){y;5(Sdl8J>q9zC9Z_XWsNS(`0LlN@;JAFoEL(jOmA|YVA~itt+ck;
zPE29hxX+u|ytX7~H#Tu6Yv-g6jiPA}glG~7s;rt5GfAMDf`~s2<C=l63D-9eF2D$6
zOC~vxqyq1=0!v`mmWiG&gs`k2P6FYPUAJY6DOhr2ZqK=E@GxG<g6pc=l8G||8ewYw
zC?9(C^B~+Ea2*C>qKE;*L@>@wGVaG@g@B(QCQw>@>LX=180f-7Kr{rxp99yDC9ESR
zCEi;M$Z?5T`GN-Dx;+jgRcuq!iwJFoU=rBnNY2^gWp?0zk7xvh5t?K|rJg!{ItXvj
zSj$*f&(pZn#?jX(6E=SkL_g1;#XS&{8{xr8%+!KvORnZoqgN%<>YL`vmF!xACf}Rc
zfjh6Rs_JOfbhHzZ&g>tcWul?)K~sDfXOO2>7GS<6gis4u`(rvq@w3|^GLpF1*=l+d
zVkQNgvdY&9i_KE%*9ntjnG!DuM{LqB>yh_z05R5F_~B^oBNH$l^7i)jnR=NBuu7ag
z;XgFPgF|+4bB`?-F{K!Ub2_f}ci|K!ECV@JsxuqmY6P2JG&qtyIMBLfW{*N>;7}$x
zjR}LwyITskiCU$zvnDTmor+kTE5%zq+OmM5H1EU?$dBh?R**e=_O&F=le$Xc1%Ll>
zq!u|5jV!-$p00s6RPzTb+1bl4g<#Dm-Z$5~bPdq`l+1C$h2=I(yLk(g;N+(!?iL&}
zt2Ph;QczYwp{gbsd8DZ!h(_xO63`Bc44NfLENuw<w{`yLZCVdC-l4aYJ}|J*eJ^Kd
zaP~?@PJ~{mv09I{)gk^R{#j&&CqV3rfS6k|8yyo9LZ(n+XLQ;+rV<>6pl(VT7o<>g
z@^pq9zI~ijaWW?-_-Z~km*OveTp7dyfwpd9$t>6`Lzg6&-1b2D-E2?+$)XZe?s=Fz
z&V%W$Jjo$>6-+a1nnb)vH>>|>)dq1qJ<$!MSu{p7qtEzkB}f1CAjDq(`0gG!LK>=-
zmSCuTuqCT{6^~RaIpmd0?&RZGyG-c>yg!%|pf2ANAd(mkQwk&h+X8Ae2U4y;&xrKz
zU~|kxJ#f~R1$`Rn^gOJk=fTy<LrbiLMr(jcH|%}b5Vy+}#TOkV3jqG&$8oWs6G5+R
zV_^O|1mgh)6&=R!!JY8QE#}W1sUhP|T1JSFXt0;$pw(7zDLpt&Csk6^u1EgPeB1m6
zF{d7%yktcyOL#p>HXC66I8~=aiMh>yoHC?=!yH_2IxLwrvYX%3nxDVm!u76R>_FK;
z9F3MajKS77IE%iqE>5L<6$V?$B8W`rIJI?;PIoD^O^@d0=6bqZvC3l<s$U-NrHwX)
z(e~&02e6cDwb&1tyP+mAaL{QWI7pmf)Eo#KbuiAi!DB3mimdJ$9B^{*>`H4WsMhpc
z3}u!`^$a`aDEY;AsI?^qL6|YQm4su<<V1{@9+b`W6eALtB^9&UfjIAID>Oow%-(rA
z5aKEa=536&!LDiKk_3JTTs4#i1CWvf-#I2pI8EH@98jv4+@MbeE^gkw-OQvwsj>KR
zs4WJwS`O7F>q)m9A!l&3F+kr6LyY=TyhI7ySza$rrm?1Xp!l?Osd-+LKYR8tToWmD
zHyFi?XHWBH@fYAQojr#RRc`j9{GH)Edd0w70A|l<7>OOL^BC`&+g!Saaj<0h5Y<_+
zfoIdEfUez=O~S_4{X<J^9DG$F%uGzhCl{Lim|M#n(!&XHGQHGeKekQPLicd1<0K{J
zZEH2PD=jZs$?^Z)HlRaoohL5C(QIMdgi&&#YGz(;(WnN!-8fO&v&z++2dCDy#+HSR
z#19v4A|;kr+b1O3?JR<JS1h<aocDo2Mnt~sV{!msn50`nQU{J1V8Rk0_ZW#k8s@>q
za5`MCLtvBLhQ%N`G%+LK^ajJYTXq0s>7C3y^clgdAu}Y#tocb;gkHd|S!oqS4o!r{
z^Y|sPh?m=;JgR~W+${^#paKF`XAx&nmQPF(#jOF}K_Qq->W4?+XK7xTZBDT>@cxW{
z!ZCc?3s4K!1WbcN-z|&tH!omMhiQ6RwT6kRF-quu+Y}q5aR4b^N?9bc+hLVc4-P_k
zHB`i9xrjV1gb98O2Wvrea&p@yp^~-Na5C4`Y|+*b{|60}vXPvT#I7{{-ee>qGakzS
z)83UvHF<7pY_+4+<!!x3Dh{U&PN1oPmO(*lPi+cF6@<zZWsu6CNMs0vLEGxNw#p^8
z&?rOC5>aFnOauc-Tdz_Gh=LFy1WFYULP#adG0A;)XwSK8_5L~Q{JZP&2bY2H<^A4o
zzt7(Ld7eF%fpWTfxe+z?F(|=UGdiuEwKd$pw+gYY7o>SYi6MKu-MRlR?Nz59pRLn@
zIRBlWvtDR>=b=H2K*G<5x@bL~XN5C$KoB??ERt8NpEerLrl-rXsugM%xYdz?5B-GG
zC8w{aFHQNvx~yD3iGK7*GzpXfs-m~^QP&)_ZYDE-J{e+wnd>l|he|N^`bT^?EA>VT
z8pqixz#YJjc>B1+K|w)pz^DkVCX_&1dTmge78y4Ht$C`N&xp1C;oS+zF^}qJn!#(n
z-<fTGE5{)b$1&b-7k{k9m01V`BVw1!#y|iDJ8n10ot4VD>1}FOM{Q|tr_^7d=uTme
zCXFPiriNwHs*<Rioo#uo@`m~45KxegrK@55q2W$glp&>kW`@)5r~B4P(YMQegvTC#
zoHWO5&D04FdoDL)nkmFnBC10**OCRv?T49lW#s9B_9W;)z9b4(KgEl<2kcxMm+Q;+
z!IjicDE?(AF=i%srM5aPEzLST%-|Z1HW3cBm}O<a9~)rh96YcWVxCRBsc2d_U@=eN
zlC8_V9ex?9Iht8i<`Fk4PC0Tk>})|nfvH|i9yx`3ETPu<5KQ|S9Eifi@o<#4-ALQo
zH+0uy`dVs$(~Vla<de`5aT0H$?^)AXvEpkV$X9OY<3ShW1avD13Uv3Xn)e-12aiN%
zIc=)eCbzAtb2m#%{dvCi!j~2<^Z~!al7&{CXlo#R(pjmgPx@DBzwB$f9Gykt>zHTT
zCVc?Ij)hM@d+BUxd-;JKL{KH!Bz0Rri6b*CV9-;fPX<>vAu2L{;7r+cl3vi2a}h^b
zD~_)#=!UO_iXLH!KyWvAU>Oh-TdJS9KvE%G!@krWK2My=)h4f9!(opqpN$KPT#l4U
zEVsoKOQid1o!QG?EiNxh3|_&B7yFk`0P#*>nwc3svn}899r|-3V>d2BEe#G1w$vwU
zPIiUl{y^?0VuNJr`BsIECO!JspSP3xU*1<KuK95(iJr)U1B}`GfRN;hOX~}(K2azM
zj0tlGn)e`7Mi>H9S9vtvCzCM<Oyo3@1FiEbXg&-f4uQx)?u9Ib5>KeUt_R(I#kEcC
zF6ovsG_}lmp(A0Vx9Q^;-?=MW@yNTUr`SJ_nLf|E!)I%4IyXq{ZwiOrT>3P}&1BCb
z_*o8WbRSx?C0!F!pw3&e0G>Uufhu`x#lC31sK-=An)nQ^$6rB%v|71xWu5HB(%A8}
zU7!VUN3z&9&0a<DTEiB!=>E0Uhi()u@<Tqc=A*i*HnQvD<GZKMOXYd>=Qws?S_4nE
z;jP9StjewcznZ9*w{C5M>pEFEc!v5V;_gUO1DaYjuG<AVc|-HGDgq5GMAx=3uduoy
z-Gy&d+P-VwhwH9hp4jMdILp?w)xtIN%)ale`urXto=SaqGxCa9Sa>Qpf_L54gDC|z
z_t$Dix-Nx&QOZ>Bi;71A>E<^u@8yv++W>X;>C>lM;I<c%G(5z%ZFm;?ZN%dBzIKY(
zL<O$bl7&uNE9huE?^AF480S<T>2W?KOVAeE|9uMzE>ee%y26O|cYC$q7~h9HW5b}v
z_0uiYOkeKow$stJ>&eo}<(O~79MsrmREQ7Fw9(e9c4jYsl~-H#KhG{n3f-(P%w(_O
zbG71OB}*dEmJdOpy)T!2E$9ohwAPr~y0?;cdqFb#`YN~oWT-nTSIe3Um;pB*Ot^YM
zl(icw-r<=^5F0^>+XLfX^_N!}B&nH@*~4i#I)T%MEXkqzcJAwo79G$PKE?rMrO2z3
zAW?#pjomjG$l%7tRt-GyIaexKc&p82Ji8F*peT=%Y0*=)`NqZ=M3|?WtR86Ys`Ba)
zS)rIBryl&d3jL2QLK~x{0}SFv*xAa$o(sCn)qy@9!|c+S$>jPoi~A+36LhhoLTo{&
z`5#d86+)DcZ~(olZ7Il}8m+WuzB2lUbA5Jg>h2Buz5o8_06`=pg(bEh_|`(QmQ-_t
zzk;mvG^z4$jT3eShBpU%LKn3fA}M!lc6T(;8sR0;hzAo`G{2zWJOXgXxD-iu<Ren6
zcfq-!0BzC&xc(o6De)@U8UT+X3wPVUe}ATA1@G76B^sPU?x1D40qiz{lH3R~^#0P#
zIDh@5$Q%{RSJ)nO6P4{QKpq<+ZUo~783hl7*SKbIu6od!U4rXEm!7;f-LPhENbH)>
zw2qWa{qm|}2|Nl!<5p}5FLy}BQvzeCt<ztG<1NxgATCJf-@)&oLw|iEFvMoQ8+a6v
z&2`9~vjP+Ak0DbU8}4YWfrth<wWBOTE{yOIU*jy@!FNDE6H5ou1ov2Xm2T#7JKPnH
zAX5NdR)mgTG-Uf8E=vup16VtG^5l82#vb<HdzD$UAC;6K%GF4FPnK+cQn26>d4?+A
zNid|{z#|u6R*XE*Cw_t%KOhoozFgd&l46mk<mSYj-_g<3@$6wi5!(-`7i6R6V8;~(
z*4`{c-<GUCiT0+h1(%VPtNI60{yX|e;vE~%T^09ya|pQ3`wGoU2oXDe*HDj)+#L%M
z<1a_|I%-ANStN+JyAo9;9TT_#U!nEhEHZ)s;EruEJOdA|A1s{WtQ9FBac#zdd}j$1
zUVQRwhCAyX(WZj@{D*Bn|3_Ls#8#C{Rj6uQ-)aP`57C`pjcFwCqW-T5Biius_9=&h
zACKMc%;5%qVP@qr)LhaxHsfS_(u(6{;te@q_K`^c)kgAKU4^90N?X@)^ZDnVi{$*c
zBp5{RM?!g9n_l)hN0Bpm`xTCh^lWo!&93UEKNrpY1PYfTSf0jK5!e18V95e`POI}k
z!_gDXzLPEy`e{!4Qr)*=Mc>FkCM6Jsvk62IbU5c=TW}0mo?LFgF7-s-6^qF;7CKbV
zNasn^Im0up2Q0zXI6C@*2=w6dmtTK?lefgb+D2hO28Q_!O(xa_h~gi?zlYc>pvNhZ
zfzcqS%%mfsq#s3yyi6Qc<O@FF=>Un5VTsA7R4r0Oy0C_=P@~$5ix@|B?qT2slu(x0
zM{lEthbELDjpOpVz&qPTyhN}ZzX9TdE6Bm=+l5%>_i<BOATf@8`paJ+i8D=9gXq8Q
z`XSFV&~}O<ZyZ+ozxnpNBX^gwwXymUi9z6>b5R_x@rI@L80Pm7yMq|UEiEl1x5dZX
zgID(8*DCy903^&QQ7kc8G$Eg*8Aqu7)a=Q6EYQpLj!2l?URAZ`W!w>N&JKwPRscje
zA%7}7#{^ArJg<H0t@l9ixvm_jGndR*S0*NR8;ZvVfQLqcOAlv>>vsA`%Witwntd1j
z^1U7wthu%w_X4*vpeA8ApFE1D?c6X5E-k|T`G0og;j>r%Jlj#QK10qu^z|>c92ZB!
zXCq_d2V}qdBoVAVM(|fAHqH3#v^xLajUoS;D)|Cp2;W&^9!x`;NPVZNoy>(9axv&9
zv<k2txChIJaFr+cxbAt*N)bf?kV-D%Ea-O(BndWb9l}u<gxeluZ^dz%?h?e)E0A|p
zBWg*dDTe7V8dQOsNaQ!Dne#z{IVF>04vHw5l(@G-Pki=Sl+5kC-CFsZ7KJDY!b`Il
zH9eYN1riIX;HjjC@jg}8cbV4mV|#PocKC6Go;&ngNy?s|k#PVV&I8~o9mY<v*nk*}
zB3@%$F%&q0Cr_S4>OR=H^Mc~Ac)jT%l8H1Z{x!ji9!E?ha<%r$_(4(V@`Rt~oKn5E
zV1a18EshHD0G2ugQ34vd1-kg(>sy^v6a+~m*%0`<-MMLu6ULy-FZSOuc5esqj&MDH
zBL)lXl-prE|1}aN2>!8-0bm4q!A^yeT;Y+PK(Msng)+{hh2oE)Vzv`J5}{u_ZZ?Ry
zL0_CaNeWO>CV<RF9vFjUo(d8ku+mk~^oo#(#p&_jZr7{WMm_^&g^v*feQ@%TsS)W`
zh}8o0tx^8zr{lN@p8`8!E}9&a)CZ_Ffd3tUI7n0?GVVn!Q3Zxz{bZ+Uxzkcdxu*{b
z<HpTDfo|Uprk`=LEi|nl6wfX>0;w|x0qmm$mva->$vDvC9t58TB@cj+P?V{I<Wl^r
zA4PurAI$3oebwZOl<S0p?pCFMZW+o>TK)WDz%;6*fDB2tEJ`irz}+YjLtE>dDy4&k
z>M*8n`@~0I@ZLZcT|gM(I>=~_=rq((psYe^L(cWMHU<k!uH?*tKUNit|4UV&tthJ@
zi^*gqq6meNe23&lV8wPEO&sM19^n8m*oo^|Z#u;lBZd!Wa#2E!OkcQsi#=O~76`r!
zRLK|2c_7@CZGS+gfq#dx*9Ip9QRo?k2y**!X&7Ua0KTUoP6iU{f^Nxbp}`SJHK;@I
z@lccXd6cnHG98LO13w?aNFreN+CWJ~ZVrq>tj6?SnsSJ?izoaszh?(5n{OUm5wPL6
z92DLhuKZ(<e_Di*EMW>4oFb6;(7RN0?JPom!OurPUxPaC^lQKJaZ0%I;VbtB>OiVd
zL0AS27Bn*pIb~bU%g0g8H!QdkbIyD&_F(67E8G;uzI8QxGHP}d@<1G{^?KR#3v1S3
z!pcsY&n`EvT(=sT9zR64cgLXdy%IzM?%y2cDAXWx_E}`h<TSG4vOb-SS|M+JKbnD^
z>dGfOSZs=QsD}2&z>1h8gZagiN=GpJ@}*2mYt#(TKEVjSwk($y=FM{mNZLiE^CGge
z`u9&~ue$2A>r2TD?F$1?`QHcRs|Xl5>oiiXbRj#(@~yeksuM_(L`#2k`ZtTnyxoEN
zqSN3ZAAMMc+L(h^UM;wnK)8+NFrBZuZnEz-ODlqD(oguf$B;m>TJRWKbUR(eBY6Iu
z11A`V;41~{re~%B)X#4iV9v5ICiI%Bhvq(IJvD)O)n5VT%f&zN`W*wn^gU37ebZf`
ze4zIwZm?u#$O`=XhD%3H%ebv~ds^SyD6iiH|CP+XK|04l?0ys2crWZVC`gmL9Yl9<
zF13V-*&tj-np#}IDh1KJm|>#J;ni61SBt<89D=l{o2PY01I>Q^WyT>4A>-%c;D|s#
zBi9P*zLEO}7U&)ZV)%EK0>5q@{poF+J2dBvhDMUy702pM;EZ;_-(s4UNb^rodc6eR
z-%Y#Om0IIJe|-deN-OH^@LWb_$?UKcky%t21)8OaC%syfxa~muTjfM9^hjqSL@Jat
z<dy0qY*#JJwUG*-bL5$s0y)b&AQmD_V`sQS^@aC9Hq>z@38S|V+tGpKd?NoH7OFg0
ztoo<IOTR^j*>AGQ?BjjGSn{iEsRXu6S6yJh0ZA8*s&-UaH(>-CCNX^sDQBa|2;O8F
zgy<;n?4_d&jXXkOwG*8YM2*F<rY`S6q$S@pq9)U}1PgI7^w}^7d2+38c`G_62X&Wr
z_%vcj9kOFNRnrxve*{(4H7TZB{c*zFCmP0Y$fBHa_y4(Bre*n8fzoUw_&+kvT5X&o
Yt8MDL_@_mtDORk%?0UcSz5OTt8-U%&*8l(j

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/transforms/implementations/tanium.png b/latest/assets/images/social/reference/API/trestle/transforms/implementations/tanium.png
new file mode 100644
index 0000000000000000000000000000000000000000..92dd09296d84f5b6953b34efcbb863985cb5e9df
GIT binary patch
literal 31819
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/transforms/implementations/xccdf.png b/latest/assets/images/social/reference/API/trestle/transforms/implementations/xccdf.png
new file mode 100644
index 0000000000000000000000000000000000000000..f007d0416e9126c763438e9bb26549f98ab04283
GIT binary patch
literal 32496
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/transforms/results.png b/latest/assets/images/social/reference/API/trestle/transforms/results.png
new file mode 100644
index 0000000000000000000000000000000000000000..016975d891c644f99393cc6e309e017ac85d7f63
GIT binary patch
literal 29687
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/transforms/transformer_factory.png b/latest/assets/images/social/reference/API/trestle/transforms/transformer_factory.png
new file mode 100644
index 0000000000000000000000000000000000000000..c22b75c5ddcf96df926922e29a8b97b3f95e3eb2
GIT binary patch
literal 30371
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/transforms/transformer_helper.png b/latest/assets/images/social/reference/API/trestle/transforms/transformer_helper.png
new file mode 100644
index 0000000000000000000000000000000000000000..0c4615692437a034a503aea782eafed32ac119bb
GIT binary patch
literal 30222
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/API/trestle/transforms/transformer_singleton.png b/latest/assets/images/social/reference/API/trestle/transforms/transformer_singleton.png
new file mode 100644
index 0000000000000000000000000000000000000000..8a708cfef94998c589d0cb743372756d3827d50b
GIT binary patch
literal 31820
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
Zu=*lzebVc8-_q*ftl9Wc<|_At{{X0ZjuZd@

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/reference/third-party-result-schema-IBM-SCC.png b/latest/assets/images/social/reference/third-party-result-schema-IBM-SCC.png
new file mode 100644
index 0000000000000000000000000000000000000000..ce744c5bfbaa4bc59596d5f379c071f61c879b2b
GIT binary patch
literal 50878
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog.png b/latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog.png
new file mode 100644
index 0000000000000000000000000000000000000000..eed345c5de5b20e3fb335853914d08a3631e2556
GIT binary patch
literal 62539
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
U%4*Q;^m+Sq59p+Rf8@u12P%Gxy8r+H

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd.png b/latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd.png
new file mode 100644
index 0000000000000000000000000000000000000000..a0ec1fac6324d6c85f5b7f8ec3ef88f49b4187fd
GIT binary patch
literal 57933
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
AP5=M^

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar.png b/latest/assets/images/social/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar.png
new file mode 100644
index 0000000000000000000000000000000000000000..50a0f2607245ede5e24ccdf1bc797b268364060e
GIT binary patch
literal 51540
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
VF^TarcS(Uf=;`X`vd$@?2>^1clez!^

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/Transformers_and_Tasks/csv_to_oscal_cd.png b/latest/assets/images/social/tutorials/Transformers_and_Tasks/csv_to_oscal_cd.png
new file mode 100644
index 0000000000000000000000000000000000000000..a3aa49e2958d5bdddc1a0e495f2b9b103ba3a924
GIT binary patch
literal 57672
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/Transformers_and_Tasks/transformer_construction.png b/latest/assets/images/social/tutorials/Transformers_and_Tasks/transformer_construction.png
new file mode 100644
index 0000000000000000000000000000000000000000..3281f636241af9a71ae0a60520383ac59422cd81
GIT binary patch
literal 59517
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
X($D@_%8t^YZ_6;Z`ZjHY^YQ-z`D8xa

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/Trestle_authoring/ssp_profile_catalog_authoring.png b/latest/assets/images/social/tutorials/Trestle_authoring/ssp_profile_catalog_authoring.png
new file mode 100644
index 0000000000000000000000000000000000000000..081b855f4c8318d18978d6b9dd3cdd2d233acc07
GIT binary patch
literal 46799
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
SWa3Y{m$F9`4l@txUH%{N^nY&v

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/Trestle_authoring/trestle_author.png b/latest/assets/images/social/tutorials/Trestle_authoring/trestle_author.png
new file mode 100644
index 0000000000000000000000000000000000000000..b28af0440f1c717e60ce7bd53a1a13d0a18cae08
GIT binary patch
literal 47538
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

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/Trestle_authoring/trestle_author_jinja.png b/latest/assets/images/social/tutorials/Trestle_authoring/trestle_author_jinja.png
new file mode 100644
index 0000000000000000000000000000000000000000..5bc9adde2085b2d0b07b551a6c7c5d6b9ea20663
GIT binary patch
literal 51275
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
Z@A~UZ598dAT{#JgdQVqBmvv4FO#s0QX}$me

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/cli.png b/latest/assets/images/social/tutorials/cli.png
new file mode 100644
index 0000000000000000000000000000000000000000..eb0c2817b073684d59cc87627baa6f22ea53ba5e
GIT binary patch
literal 35482
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
QlAhvs-|90ncOClSpYH2Hy8r+H

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/compliance_posture.png b/latest/assets/images/social/tutorials/compliance_posture.png
new file mode 100644
index 0000000000000000000000000000000000000000..af2cdd59ecc4199200abd0742eb208027a414461
GIT binary patch
literal 46642
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
TWo~sOx5m-Ka+0wJHGlsfR2$UX

literal 0
HcmV?d00001

diff --git a/latest/assets/images/social/tutorials/introduction_to_trestle.png b/latest/assets/images/social/tutorials/introduction_to_trestle.png
new file mode 100644
index 0000000000000000000000000000000000000000..1663cb48ee5edd5ebe8cb79c7a49fd6a157705d1
GIT binary patch
literal 43150
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
QqIa#j@32bBo)ee;7o8X$B>(^b

literal 0
HcmV?d00001

diff --git a/latest/assets/javascripts/bundle.83f73b43.min.js b/latest/assets/javascripts/bundle.83f73b43.min.js
new file mode 100644
index 000000000..43d8b70f6
--- /dev/null
+++ b/latest/assets/javascripts/bundle.83f73b43.min.js
@@ -0,0 +1,16 @@
+"use strict";(()=>{var Wi=Object.create;var gr=Object.defineProperty;var Di=Object.getOwnPropertyDescriptor;var Vi=Object.getOwnPropertyNames,Vt=Object.getOwnPropertySymbols,Ni=Object.getPrototypeOf,yr=Object.prototype.hasOwnProperty,ao=Object.prototype.propertyIsEnumerable;var io=(e,t,r)=>t in e?gr(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,$=(e,t)=>{for(var r in t||(t={}))yr.call(t,r)&&io(e,r,t[r]);if(Vt)for(var r of Vt(t))ao.call(t,r)&&io(e,r,t[r]);return e};var so=(e,t)=>{var r={};for(var o in e)yr.call(e,o)&&t.indexOf(o)<0&&(r[o]=e[o]);if(e!=null&&Vt)for(var o of Vt(e))t.indexOf(o)<0&&ao.call(e,o)&&(r[o]=e[o]);return r};var xr=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var zi=(e,t,r,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of Vi(t))!yr.call(e,n)&&n!==r&&gr(e,n,{get:()=>t[n],enumerable:!(o=Di(t,n))||o.enumerable});return e};var Mt=(e,t,r)=>(r=e!=null?Wi(Ni(e)):{},zi(t||!e||!e.__esModule?gr(r,"default",{value:e,enumerable:!0}):r,e));var co=(e,t,r)=>new Promise((o,n)=>{var i=p=>{try{s(r.next(p))}catch(c){n(c)}},a=p=>{try{s(r.throw(p))}catch(c){n(c)}},s=p=>p.done?o(p.value):Promise.resolve(p.value).then(i,a);s((r=r.apply(e,t)).next())});var lo=xr((Er,po)=>{(function(e,t){typeof Er=="object"&&typeof po!="undefined"?t():typeof define=="function"&&define.amd?define(t):t()})(Er,function(){"use strict";function e(r){var o=!0,n=!1,i=null,a={text:!0,search:!0,url:!0,tel:!0,email:!0,password:!0,number:!0,date:!0,month:!0,week:!0,time:!0,datetime:!0,"datetime-local":!0};function s(k){return!!(k&&k!==document&&k.nodeName!=="HTML"&&k.nodeName!=="BODY"&&"classList"in k&&"contains"in k.classList)}function p(k){var ft=k.type,qe=k.tagName;return!!(qe==="INPUT"&&a[ft]&&!k.readOnly||qe==="TEXTAREA"&&!k.readOnly||k.isContentEditable)}function c(k){k.classList.contains("focus-visible")||(k.classList.add("focus-visible"),k.setAttribute("data-focus-visible-added",""))}function l(k){k.hasAttribute("data-focus-visible-added")&&(k.classList.remove("focus-visible"),k.removeAttribute("data-focus-visible-added"))}function f(k){k.metaKey||k.altKey||k.ctrlKey||(s(r.activeElement)&&c(r.activeElement),o=!0)}function u(k){o=!1}function d(k){s(k.target)&&(o||p(k.target))&&c(k.target)}function y(k){s(k.target)&&(k.target.classList.contains("focus-visible")||k.target.hasAttribute("data-focus-visible-added"))&&(n=!0,window.clearTimeout(i),i=window.setTimeout(function(){n=!1},100),l(k.target))}function L(k){document.visibilityState==="hidden"&&(n&&(o=!0),X())}function X(){document.addEventListener("mousemove",J),document.addEventListener("mousedown",J),document.addEventListener("mouseup",J),document.addEventListener("pointermove",J),document.addEventListener("pointerdown",J),document.addEventListener("pointerup",J),document.addEventListener("touchmove",J),document.addEventListener("touchstart",J),document.addEventListener("touchend",J)}function te(){document.removeEventListener("mousemove",J),document.removeEventListener("mousedown",J),document.removeEventListener("mouseup",J),document.removeEventListener("pointermove",J),document.removeEventListener("pointerdown",J),document.removeEventListener("pointerup",J),document.removeEventListener("touchmove",J),document.removeEventListener("touchstart",J),document.removeEventListener("touchend",J)}function J(k){k.target.nodeName&&k.target.nodeName.toLowerCase()==="html"||(o=!1,te())}document.addEventListener("keydown",f,!0),document.addEventListener("mousedown",u,!0),document.addEventListener("pointerdown",u,!0),document.addEventListener("touchstart",u,!0),document.addEventListener("visibilitychange",L,!0),X(),r.addEventListener("focus",d,!0),r.addEventListener("blur",y,!0),r.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&r.host?r.host.setAttribute("data-js-focus-visible",""):r.nodeType===Node.DOCUMENT_NODE&&(document.documentElement.classList.add("js-focus-visible"),document.documentElement.setAttribute("data-js-focus-visible",""))}if(typeof window!="undefined"&&typeof document!="undefined"){window.applyFocusVisiblePolyfill=e;var t;try{t=new CustomEvent("focus-visible-polyfill-ready")}catch(r){t=document.createEvent("CustomEvent"),t.initCustomEvent("focus-visible-polyfill-ready",!1,!1,{})}window.dispatchEvent(t)}typeof document!="undefined"&&e(document)})});var qr=xr((hy,On)=>{"use strict";/*!
+ * escape-html
+ * Copyright(c) 2012-2013 TJ Holowaychuk
+ * Copyright(c) 2015 Andreas Lubbe
+ * Copyright(c) 2015 Tiancheng "Timothy" Gu
+ * MIT Licensed
+ */var $a=/["'&<>]/;On.exports=Pa;function Pa(e){var t=""+e,r=$a.exec(t);if(!r)return t;var o,n="",i=0,a=0;for(i=r.index;i<t.length;i++){switch(t.charCodeAt(i)){case 34:o="&quot;";break;case 38:o="&amp;";break;case 39:o="&#39;";break;case 60:o="&lt;";break;case 62:o="&gt;";break;default:continue}a!==i&&(n+=t.substring(a,i)),a=i+1,n+=o}return a!==i?n+t.substring(a,i):n}});var Br=xr((It,Yr)=>{/*!
+ * clipboard.js v2.0.11
+ * https://clipboardjs.com/
+ *
+ * Licensed MIT © Zeno Rocha
+ */(function(t,r){typeof It=="object"&&typeof Yr=="object"?Yr.exports=r():typeof define=="function"&&define.amd?define([],r):typeof It=="object"?It.ClipboardJS=r():t.ClipboardJS=r()})(It,function(){return function(){var e={686:function(o,n,i){"use strict";i.d(n,{default:function(){return Ui}});var a=i(279),s=i.n(a),p=i(370),c=i.n(p),l=i(817),f=i.n(l);function u(V){try{return document.execCommand(V)}catch(A){return!1}}var d=function(A){var M=f()(A);return u("cut"),M},y=d;function L(V){var A=document.documentElement.getAttribute("dir")==="rtl",M=document.createElement("textarea");M.style.fontSize="12pt",M.style.border="0",M.style.padding="0",M.style.margin="0",M.style.position="absolute",M.style[A?"right":"left"]="-9999px";var F=window.pageYOffset||document.documentElement.scrollTop;return M.style.top="".concat(F,"px"),M.setAttribute("readonly",""),M.value=V,M}var X=function(A,M){var F=L(A);M.container.appendChild(F);var D=f()(F);return u("copy"),F.remove(),D},te=function(A){var M=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body},F="";return typeof A=="string"?F=X(A,M):A instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(A==null?void 0:A.type)?F=X(A.value,M):(F=f()(A),u("copy")),F},J=te;function k(V){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?k=function(M){return typeof M}:k=function(M){return M&&typeof Symbol=="function"&&M.constructor===Symbol&&M!==Symbol.prototype?"symbol":typeof M},k(V)}var ft=function(){var A=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{},M=A.action,F=M===void 0?"copy":M,D=A.container,Y=A.target,$e=A.text;if(F!=="copy"&&F!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"');if(Y!==void 0)if(Y&&k(Y)==="object"&&Y.nodeType===1){if(F==="copy"&&Y.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(F==="cut"&&(Y.hasAttribute("readonly")||Y.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`)}else throw new Error('Invalid "target" value, use a valid Element');if($e)return J($e,{container:D});if(Y)return F==="cut"?y(Y):J(Y,{container:D})},qe=ft;function Fe(V){"@babel/helpers - typeof";return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?Fe=function(M){return typeof M}:Fe=function(M){return M&&typeof Symbol=="function"&&M.constructor===Symbol&&M!==Symbol.prototype?"symbol":typeof M},Fe(V)}function ki(V,A){if(!(V instanceof A))throw new TypeError("Cannot call a class as a function")}function no(V,A){for(var M=0;M<A.length;M++){var F=A[M];F.enumerable=F.enumerable||!1,F.configurable=!0,"value"in F&&(F.writable=!0),Object.defineProperty(V,F.key,F)}}function Hi(V,A,M){return A&&no(V.prototype,A),M&&no(V,M),V}function $i(V,A){if(typeof A!="function"&&A!==null)throw new TypeError("Super expression must either be null or a function");V.prototype=Object.create(A&&A.prototype,{constructor:{value:V,writable:!0,configurable:!0}}),A&&br(V,A)}function br(V,A){return br=Object.setPrototypeOf||function(F,D){return F.__proto__=D,F},br(V,A)}function Pi(V){var A=ji();return function(){var F=Wt(V),D;if(A){var Y=Wt(this).constructor;D=Reflect.construct(F,arguments,Y)}else D=F.apply(this,arguments);return Ri(this,D)}}function Ri(V,A){return A&&(Fe(A)==="object"||typeof A=="function")?A:Ii(V)}function Ii(V){if(V===void 0)throw new ReferenceError("this hasn't been initialised - super() hasn't been called");return V}function ji(){if(typeof Reflect=="undefined"||!Reflect.construct||Reflect.construct.sham)return!1;if(typeof Proxy=="function")return!0;try{return Date.prototype.toString.call(Reflect.construct(Date,[],function(){})),!0}catch(V){return!1}}function Wt(V){return Wt=Object.setPrototypeOf?Object.getPrototypeOf:function(M){return M.__proto__||Object.getPrototypeOf(M)},Wt(V)}function vr(V,A){var M="data-clipboard-".concat(V);if(A.hasAttribute(M))return A.getAttribute(M)}var Fi=function(V){$i(M,V);var A=Pi(M);function M(F,D){var Y;return ki(this,M),Y=A.call(this),Y.resolveOptions(D),Y.listenClick(F),Y}return Hi(M,[{key:"resolveOptions",value:function(){var D=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof D.action=="function"?D.action:this.defaultAction,this.target=typeof D.target=="function"?D.target:this.defaultTarget,this.text=typeof D.text=="function"?D.text:this.defaultText,this.container=Fe(D.container)==="object"?D.container:document.body}},{key:"listenClick",value:function(D){var Y=this;this.listener=c()(D,"click",function($e){return Y.onClick($e)})}},{key:"onClick",value:function(D){var Y=D.delegateTarget||D.currentTarget,$e=this.action(Y)||"copy",Dt=qe({action:$e,container:this.container,target:this.target(Y),text:this.text(Y)});this.emit(Dt?"success":"error",{action:$e,text:Dt,trigger:Y,clearSelection:function(){Y&&Y.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(D){return vr("action",D)}},{key:"defaultTarget",value:function(D){var Y=vr("target",D);if(Y)return document.querySelector(Y)}},{key:"defaultText",value:function(D){return vr("text",D)}},{key:"destroy",value:function(){this.listener.destroy()}}],[{key:"copy",value:function(D){var Y=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body};return J(D,Y)}},{key:"cut",value:function(D){return y(D)}},{key:"isSupported",value:function(){var D=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],Y=typeof D=="string"?[D]:D,$e=!!document.queryCommandSupported;return Y.forEach(function(Dt){$e=$e&&!!document.queryCommandSupported(Dt)}),$e}}]),M}(s()),Ui=Fi},828:function(o){var n=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function a(s,p){for(;s&&s.nodeType!==n;){if(typeof s.matches=="function"&&s.matches(p))return s;s=s.parentNode}}o.exports=a},438:function(o,n,i){var a=i(828);function s(l,f,u,d,y){var L=c.apply(this,arguments);return l.addEventListener(u,L,y),{destroy:function(){l.removeEventListener(u,L,y)}}}function p(l,f,u,d,y){return typeof l.addEventListener=="function"?s.apply(null,arguments):typeof u=="function"?s.bind(null,document).apply(null,arguments):(typeof l=="string"&&(l=document.querySelectorAll(l)),Array.prototype.map.call(l,function(L){return s(L,f,u,d,y)}))}function c(l,f,u,d){return function(y){y.delegateTarget=a(y.target,f),y.delegateTarget&&d.call(l,y)}}o.exports=p},879:function(o,n){n.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},n.nodeList=function(i){var a=Object.prototype.toString.call(i);return i!==void 0&&(a==="[object NodeList]"||a==="[object HTMLCollection]")&&"length"in i&&(i.length===0||n.node(i[0]))},n.string=function(i){return typeof i=="string"||i instanceof String},n.fn=function(i){var a=Object.prototype.toString.call(i);return a==="[object Function]"}},370:function(o,n,i){var a=i(879),s=i(438);function p(u,d,y){if(!u&&!d&&!y)throw new Error("Missing required arguments");if(!a.string(d))throw new TypeError("Second argument must be a String");if(!a.fn(y))throw new TypeError("Third argument must be a Function");if(a.node(u))return c(u,d,y);if(a.nodeList(u))return l(u,d,y);if(a.string(u))return f(u,d,y);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function c(u,d,y){return u.addEventListener(d,y),{destroy:function(){u.removeEventListener(d,y)}}}function l(u,d,y){return Array.prototype.forEach.call(u,function(L){L.addEventListener(d,y)}),{destroy:function(){Array.prototype.forEach.call(u,function(L){L.removeEventListener(d,y)})}}}function f(u,d,y){return s(document.body,u,d,y)}o.exports=p},817:function(o){function n(i){var a;if(i.nodeName==="SELECT")i.focus(),a=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var s=i.hasAttribute("readonly");s||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),s||i.removeAttribute("readonly"),a=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var p=window.getSelection(),c=document.createRange();c.selectNodeContents(i),p.removeAllRanges(),p.addRange(c),a=p.toString()}return a}o.exports=n},279:function(o){function n(){}n.prototype={on:function(i,a,s){var p=this.e||(this.e={});return(p[i]||(p[i]=[])).push({fn:a,ctx:s}),this},once:function(i,a,s){var p=this;function c(){p.off(i,c),a.apply(s,arguments)}return c._=a,this.on(i,c,s)},emit:function(i){var a=[].slice.call(arguments,1),s=((this.e||(this.e={}))[i]||[]).slice(),p=0,c=s.length;for(p;p<c;p++)s[p].fn.apply(s[p].ctx,a);return this},off:function(i,a){var s=this.e||(this.e={}),p=s[i],c=[];if(p&&a)for(var l=0,f=p.length;l<f;l++)p[l].fn!==a&&p[l].fn._!==a&&c.push(p[l]);return c.length?s[i]=c:delete s[i],this}},o.exports=n,o.exports.TinyEmitter=n}},t={};function r(o){if(t[o])return t[o].exports;var n=t[o]={exports:{}};return e[o](n,n.exports,r),n.exports}return function(){r.n=function(o){var n=o&&o.__esModule?function(){return o.default}:function(){return o};return r.d(n,{a:n}),n}}(),function(){r.d=function(o,n){for(var i in n)r.o(n,i)&&!r.o(o,i)&&Object.defineProperty(o,i,{enumerable:!0,get:n[i]})}}(),function(){r.o=function(o,n){return Object.prototype.hasOwnProperty.call(o,n)}}(),r(686)}().default})});var lL=Mt(lo());var wr=function(e,t){return wr=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(r,o){r.__proto__=o}||function(r,o){for(var n in o)Object.prototype.hasOwnProperty.call(o,n)&&(r[n]=o[n])},wr(e,t)};function oe(e,t){if(typeof t!="function"&&t!==null)throw new TypeError("Class extends value "+String(t)+" is not a constructor or null");wr(e,t);function r(){this.constructor=e}e.prototype=t===null?Object.create(t):(r.prototype=t.prototype,new r)}function mo(e,t,r,o){function n(i){return i instanceof r?i:new r(function(a){a(i)})}return new(r||(r=Promise))(function(i,a){function s(l){try{c(o.next(l))}catch(f){a(f)}}function p(l){try{c(o.throw(l))}catch(f){a(f)}}function c(l){l.done?i(l.value):n(l.value).then(s,p)}c((o=o.apply(e,t||[])).next())})}function Nt(e,t){var r={label:0,sent:function(){if(i[0]&1)throw i[1];return i[1]},trys:[],ops:[]},o,n,i,a=Object.create((typeof Iterator=="function"?Iterator:Object).prototype);return a.next=s(0),a.throw=s(1),a.return=s(2),typeof Symbol=="function"&&(a[Symbol.iterator]=function(){return this}),a;function s(c){return function(l){return p([c,l])}}function p(c){if(o)throw new TypeError("Generator is already executing.");for(;a&&(a=0,c[0]&&(r=0)),r;)try{if(o=1,n&&(i=c[0]&2?n.return:c[0]?n.throw||((i=n.return)&&i.call(n),0):n.next)&&!(i=i.call(n,c[1])).done)return i;switch(n=0,i&&(c=[c[0]&2,i.value]),c[0]){case 0:case 1:i=c;break;case 4:return r.label++,{value:c[1],done:!1};case 5:r.label++,n=c[1],c=[0];continue;case 7:c=r.ops.pop(),r.trys.pop();continue;default:if(i=r.trys,!(i=i.length>0&&i[i.length-1])&&(c[0]===6||c[0]===2)){r=0;continue}if(c[0]===3&&(!i||c[1]>i[0]&&c[1]<i[3])){r.label=c[1];break}if(c[0]===6&&r.label<i[1]){r.label=i[1],i=c;break}if(i&&r.label<i[2]){r.label=i[2],r.ops.push(c);break}i[2]&&r.ops.pop(),r.trys.pop();continue}c=t.call(e,r)}catch(l){c=[6,l],n=0}finally{o=i=0}if(c[0]&5)throw c[1];return{value:c[0]?c[1]:void 0,done:!0}}}function he(e){var t=typeof Symbol=="function"&&Symbol.iterator,r=t&&e[t],o=0;if(r)return r.call(e);if(e&&typeof e.length=="number")return{next:function(){return e&&o>=e.length&&(e=void 0),{value:e&&e[o++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function N(e,t){var r=typeof Symbol=="function"&&e[Symbol.iterator];if(!r)return e;var o=r.call(e),n,i=[],a;try{for(;(t===void 0||t-- >0)&&!(n=o.next()).done;)i.push(n.value)}catch(s){a={error:s}}finally{try{n&&!n.done&&(r=o.return)&&r.call(o)}finally{if(a)throw a.error}}return i}function q(e,t,r){if(r||arguments.length===2)for(var o=0,n=t.length,i;o<n;o++)(i||!(o in t))&&(i||(i=Array.prototype.slice.call(t,0,o)),i[o]=t[o]);return e.concat(i||Array.prototype.slice.call(t))}function nt(e){return this instanceof nt?(this.v=e,this):new nt(e)}function fo(e,t,r){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var o=r.apply(e,t||[]),n,i=[];return n=Object.create((typeof AsyncIterator=="function"?AsyncIterator:Object).prototype),s("next"),s("throw"),s("return",a),n[Symbol.asyncIterator]=function(){return this},n;function a(d){return function(y){return Promise.resolve(y).then(d,f)}}function s(d,y){o[d]&&(n[d]=function(L){return new Promise(function(X,te){i.push([d,L,X,te])>1||p(d,L)})},y&&(n[d]=y(n[d])))}function p(d,y){try{c(o[d](y))}catch(L){u(i[0][3],L)}}function c(d){d.value instanceof nt?Promise.resolve(d.value.v).then(l,f):u(i[0][2],d)}function l(d){p("next",d)}function f(d){p("throw",d)}function u(d,y){d(y),i.shift(),i.length&&p(i[0][0],i[0][1])}}function uo(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t=e[Symbol.asyncIterator],r;return t?t.call(e):(e=typeof he=="function"?he(e):e[Symbol.iterator](),r={},o("next"),o("throw"),o("return"),r[Symbol.asyncIterator]=function(){return this},r);function o(i){r[i]=e[i]&&function(a){return new Promise(function(s,p){a=e[i](a),n(s,p,a.done,a.value)})}}function n(i,a,s,p){Promise.resolve(p).then(function(c){i({value:c,done:s})},a)}}function H(e){return typeof e=="function"}function ut(e){var t=function(o){Error.call(o),o.stack=new Error().stack},r=e(t);return r.prototype=Object.create(Error.prototype),r.prototype.constructor=r,r}var zt=ut(function(e){return function(r){e(this),this.message=r?r.length+` errors occurred during unsubscription:
+`+r.map(function(o,n){return n+1+") "+o.toString()}).join(`
+  `):"",this.name="UnsubscriptionError",this.errors=r}});function Qe(e,t){if(e){var r=e.indexOf(t);0<=r&&e.splice(r,1)}}var Ue=function(){function e(t){this.initialTeardown=t,this.closed=!1,this._parentage=null,this._finalizers=null}return e.prototype.unsubscribe=function(){var t,r,o,n,i;if(!this.closed){this.closed=!0;var a=this._parentage;if(a)if(this._parentage=null,Array.isArray(a))try{for(var s=he(a),p=s.next();!p.done;p=s.next()){var c=p.value;c.remove(this)}}catch(L){t={error:L}}finally{try{p&&!p.done&&(r=s.return)&&r.call(s)}finally{if(t)throw t.error}}else a.remove(this);var l=this.initialTeardown;if(H(l))try{l()}catch(L){i=L instanceof zt?L.errors:[L]}var f=this._finalizers;if(f){this._finalizers=null;try{for(var u=he(f),d=u.next();!d.done;d=u.next()){var y=d.value;try{ho(y)}catch(L){i=i!=null?i:[],L instanceof zt?i=q(q([],N(i)),N(L.errors)):i.push(L)}}}catch(L){o={error:L}}finally{try{d&&!d.done&&(n=u.return)&&n.call(u)}finally{if(o)throw o.error}}}if(i)throw new zt(i)}},e.prototype.add=function(t){var r;if(t&&t!==this)if(this.closed)ho(t);else{if(t instanceof e){if(t.closed||t._hasParent(this))return;t._addParent(this)}(this._finalizers=(r=this._finalizers)!==null&&r!==void 0?r:[]).push(t)}},e.prototype._hasParent=function(t){var r=this._parentage;return r===t||Array.isArray(r)&&r.includes(t)},e.prototype._addParent=function(t){var r=this._parentage;this._parentage=Array.isArray(r)?(r.push(t),r):r?[r,t]:t},e.prototype._removeParent=function(t){var r=this._parentage;r===t?this._parentage=null:Array.isArray(r)&&Qe(r,t)},e.prototype.remove=function(t){var r=this._finalizers;r&&Qe(r,t),t instanceof e&&t._removeParent(this)},e.EMPTY=function(){var t=new e;return t.closed=!0,t}(),e}();var Tr=Ue.EMPTY;function qt(e){return e instanceof Ue||e&&"closed"in e&&H(e.remove)&&H(e.add)&&H(e.unsubscribe)}function ho(e){H(e)?e():e.unsubscribe()}var Pe={onUnhandledError:null,onStoppedNotification:null,Promise:void 0,useDeprecatedSynchronousErrorHandling:!1,useDeprecatedNextContext:!1};var dt={setTimeout:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=dt.delegate;return n!=null&&n.setTimeout?n.setTimeout.apply(n,q([e,t],N(r))):setTimeout.apply(void 0,q([e,t],N(r)))},clearTimeout:function(e){var t=dt.delegate;return((t==null?void 0:t.clearTimeout)||clearTimeout)(e)},delegate:void 0};function Qt(e){dt.setTimeout(function(){var t=Pe.onUnhandledError;if(t)t(e);else throw e})}function be(){}var bo=function(){return Sr("C",void 0,void 0)}();function vo(e){return Sr("E",void 0,e)}function go(e){return Sr("N",e,void 0)}function Sr(e,t,r){return{kind:e,value:t,error:r}}var it=null;function ht(e){if(Pe.useDeprecatedSynchronousErrorHandling){var t=!it;if(t&&(it={errorThrown:!1,error:null}),e(),t){var r=it,o=r.errorThrown,n=r.error;if(it=null,o)throw n}}else e()}function yo(e){Pe.useDeprecatedSynchronousErrorHandling&&it&&(it.errorThrown=!0,it.error=e)}var _t=function(e){oe(t,e);function t(r){var o=e.call(this)||this;return o.isStopped=!1,r?(o.destination=r,qt(r)&&r.add(o)):o.destination=Yi,o}return t.create=function(r,o,n){return new at(r,o,n)},t.prototype.next=function(r){this.isStopped?Lr(go(r),this):this._next(r)},t.prototype.error=function(r){this.isStopped?Lr(vo(r),this):(this.isStopped=!0,this._error(r))},t.prototype.complete=function(){this.isStopped?Lr(bo,this):(this.isStopped=!0,this._complete())},t.prototype.unsubscribe=function(){this.closed||(this.isStopped=!0,e.prototype.unsubscribe.call(this),this.destination=null)},t.prototype._next=function(r){this.destination.next(r)},t.prototype._error=function(r){try{this.destination.error(r)}finally{this.unsubscribe()}},t.prototype._complete=function(){try{this.destination.complete()}finally{this.unsubscribe()}},t}(Ue);var qi=Function.prototype.bind;function Or(e,t){return qi.call(e,t)}var Qi=function(){function e(t){this.partialObserver=t}return e.prototype.next=function(t){var r=this.partialObserver;if(r.next)try{r.next(t)}catch(o){Kt(o)}},e.prototype.error=function(t){var r=this.partialObserver;if(r.error)try{r.error(t)}catch(o){Kt(o)}else Kt(t)},e.prototype.complete=function(){var t=this.partialObserver;if(t.complete)try{t.complete()}catch(r){Kt(r)}},e}(),at=function(e){oe(t,e);function t(r,o,n){var i=e.call(this)||this,a;if(H(r)||!r)a={next:r!=null?r:void 0,error:o!=null?o:void 0,complete:n!=null?n:void 0};else{var s;i&&Pe.useDeprecatedNextContext?(s=Object.create(r),s.unsubscribe=function(){return i.unsubscribe()},a={next:r.next&&Or(r.next,s),error:r.error&&Or(r.error,s),complete:r.complete&&Or(r.complete,s)}):a=r}return i.destination=new Qi(a),i}return t}(_t);function Kt(e){Pe.useDeprecatedSynchronousErrorHandling?yo(e):Qt(e)}function Ki(e){throw e}function Lr(e,t){var r=Pe.onStoppedNotification;r&&dt.setTimeout(function(){return r(e,t)})}var Yi={closed:!0,next:be,error:Ki,complete:be};var bt=function(){return typeof Symbol=="function"&&Symbol.observable||"@@observable"}();function le(e){return e}function xo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Mr(e)}function Mr(e){return e.length===0?le:e.length===1?e[0]:function(r){return e.reduce(function(o,n){return n(o)},r)}}var j=function(){function e(t){t&&(this._subscribe=t)}return e.prototype.lift=function(t){var r=new e;return r.source=this,r.operator=t,r},e.prototype.subscribe=function(t,r,o){var n=this,i=Gi(t)?t:new at(t,r,o);return ht(function(){var a=n,s=a.operator,p=a.source;i.add(s?s.call(i,p):p?n._subscribe(i):n._trySubscribe(i))}),i},e.prototype._trySubscribe=function(t){try{return this._subscribe(t)}catch(r){t.error(r)}},e.prototype.forEach=function(t,r){var o=this;return r=Eo(r),new r(function(n,i){var a=new at({next:function(s){try{t(s)}catch(p){i(p),a.unsubscribe()}},error:i,complete:n});o.subscribe(a)})},e.prototype._subscribe=function(t){var r;return(r=this.source)===null||r===void 0?void 0:r.subscribe(t)},e.prototype[bt]=function(){return this},e.prototype.pipe=function(){for(var t=[],r=0;r<arguments.length;r++)t[r]=arguments[r];return Mr(t)(this)},e.prototype.toPromise=function(t){var r=this;return t=Eo(t),new t(function(o,n){var i;r.subscribe(function(a){return i=a},function(a){return n(a)},function(){return o(i)})})},e.create=function(t){return new e(t)},e}();function Eo(e){var t;return(t=e!=null?e:Pe.Promise)!==null&&t!==void 0?t:Promise}function Bi(e){return e&&H(e.next)&&H(e.error)&&H(e.complete)}function Gi(e){return e&&e instanceof _t||Bi(e)&&qt(e)}function Ji(e){return H(e==null?void 0:e.lift)}function E(e){return function(t){if(Ji(t))return t.lift(function(r){try{return e(r,this)}catch(o){this.error(o)}});throw new TypeError("Unable to lift unknown Observable type")}}function T(e,t,r,o,n){return new Xi(e,t,r,o,n)}var Xi=function(e){oe(t,e);function t(r,o,n,i,a,s){var p=e.call(this,r)||this;return p.onFinalize=a,p.shouldUnsubscribe=s,p._next=o?function(c){try{o(c)}catch(l){r.error(l)}}:e.prototype._next,p._error=i?function(c){try{i(c)}catch(l){r.error(l)}finally{this.unsubscribe()}}:e.prototype._error,p._complete=n?function(){try{n()}catch(c){r.error(c)}finally{this.unsubscribe()}}:e.prototype._complete,p}return t.prototype.unsubscribe=function(){var r;if(!this.shouldUnsubscribe||this.shouldUnsubscribe()){var o=this.closed;e.prototype.unsubscribe.call(this),!o&&((r=this.onFinalize)===null||r===void 0||r.call(this))}},t}(_t);var vt={schedule:function(e){var t=requestAnimationFrame,r=cancelAnimationFrame,o=vt.delegate;o&&(t=o.requestAnimationFrame,r=o.cancelAnimationFrame);var n=t(function(i){r=void 0,e(i)});return new Ue(function(){return r==null?void 0:r(n)})},requestAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=vt.delegate;return((r==null?void 0:r.requestAnimationFrame)||requestAnimationFrame).apply(void 0,q([],N(e)))},cancelAnimationFrame:function(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=vt.delegate;return((r==null?void 0:r.cancelAnimationFrame)||cancelAnimationFrame).apply(void 0,q([],N(e)))},delegate:void 0};var wo=ut(function(e){return function(){e(this),this.name="ObjectUnsubscribedError",this.message="object unsubscribed"}});var g=function(e){oe(t,e);function t(){var r=e.call(this)||this;return r.closed=!1,r.currentObservers=null,r.observers=[],r.isStopped=!1,r.hasError=!1,r.thrownError=null,r}return t.prototype.lift=function(r){var o=new To(this,this);return o.operator=r,o},t.prototype._throwIfClosed=function(){if(this.closed)throw new wo},t.prototype.next=function(r){var o=this;ht(function(){var n,i;if(o._throwIfClosed(),!o.isStopped){o.currentObservers||(o.currentObservers=Array.from(o.observers));try{for(var a=he(o.currentObservers),s=a.next();!s.done;s=a.next()){var p=s.value;p.next(r)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}}})},t.prototype.error=function(r){var o=this;ht(function(){if(o._throwIfClosed(),!o.isStopped){o.hasError=o.isStopped=!0,o.thrownError=r;for(var n=o.observers;n.length;)n.shift().error(r)}})},t.prototype.complete=function(){var r=this;ht(function(){if(r._throwIfClosed(),!r.isStopped){r.isStopped=!0;for(var o=r.observers;o.length;)o.shift().complete()}})},t.prototype.unsubscribe=function(){this.isStopped=this.closed=!0,this.observers=this.currentObservers=null},Object.defineProperty(t.prototype,"observed",{get:function(){var r;return((r=this.observers)===null||r===void 0?void 0:r.length)>0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var o=this,n=this,i=n.hasError,a=n.isStopped,s=n.observers;return i||a?Tr:(this.currentObservers=null,s.push(r),new Ue(function(){o.currentObservers=null,Qe(s,r)}))},t.prototype._checkFinalizedStatuses=function(r){var o=this,n=o.hasError,i=o.thrownError,a=o.isStopped;n?r.error(i):a&&r.complete()},t.prototype.asObservable=function(){var r=new j;return r.source=this,r},t.create=function(r,o){return new To(r,o)},t}(j);var To=function(e){oe(t,e);function t(r,o){var n=e.call(this)||this;return n.destination=r,n.source=o,n}return t.prototype.next=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.next)===null||n===void 0||n.call(o,r)},t.prototype.error=function(r){var o,n;(n=(o=this.destination)===null||o===void 0?void 0:o.error)===null||n===void 0||n.call(o,r)},t.prototype.complete=function(){var r,o;(o=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||o===void 0||o.call(r)},t.prototype._subscribe=function(r){var o,n;return(n=(o=this.source)===null||o===void 0?void 0:o.subscribe(r))!==null&&n!==void 0?n:Tr},t}(g);var _r=function(e){oe(t,e);function t(r){var o=e.call(this)||this;return o._value=r,o}return Object.defineProperty(t.prototype,"value",{get:function(){return this.getValue()},enumerable:!1,configurable:!0}),t.prototype._subscribe=function(r){var o=e.prototype._subscribe.call(this,r);return!o.closed&&r.next(this._value),o},t.prototype.getValue=function(){var r=this,o=r.hasError,n=r.thrownError,i=r._value;if(o)throw n;return this._throwIfClosed(),i},t.prototype.next=function(r){e.prototype.next.call(this,this._value=r)},t}(g);var At={now:function(){return(At.delegate||Date).now()},delegate:void 0};var Ct=function(e){oe(t,e);function t(r,o,n){r===void 0&&(r=1/0),o===void 0&&(o=1/0),n===void 0&&(n=At);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=o,i._timestampProvider=n,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=o===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,o),i}return t.prototype.next=function(r){var o=this,n=o.isStopped,i=o._buffer,a=o._infiniteTimeWindow,s=o._timestampProvider,p=o._windowTime;n||(i.push(r),!a&&i.push(s.now()+p)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var o=this._innerSubscribe(r),n=this,i=n._infiniteTimeWindow,a=n._buffer,s=a.slice(),p=0;p<s.length&&!r.closed;p+=i?1:2)r.next(s[p]);return this._checkFinalizedStatuses(r),o},t.prototype._trimBuffer=function(){var r=this,o=r._bufferSize,n=r._timestampProvider,i=r._buffer,a=r._infiniteTimeWindow,s=(a?1:2)*o;if(o<1/0&&s<i.length&&i.splice(0,i.length-s),!a){for(var p=n.now(),c=0,l=1;l<i.length&&i[l]<=p;l+=2)c=l;c&&i.splice(0,c+1)}},t}(g);var So=function(e){oe(t,e);function t(r,o){return e.call(this)||this}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),this},t}(Ue);var kt={setInterval:function(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];var n=kt.delegate;return n!=null&&n.setInterval?n.setInterval.apply(n,q([e,t],N(r))):setInterval.apply(void 0,q([e,t],N(r)))},clearInterval:function(e){var t=kt.delegate;return((t==null?void 0:t.clearInterval)||clearInterval)(e)},delegate:void 0};var gt=function(e){oe(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n.pending=!1,n}return t.prototype.schedule=function(r,o){var n;if(o===void 0&&(o=0),this.closed)return this;this.state=r;var i=this.id,a=this.scheduler;return i!=null&&(this.id=this.recycleAsyncId(a,i,o)),this.pending=!0,this.delay=o,this.id=(n=this.id)!==null&&n!==void 0?n:this.requestAsyncId(a,this.id,o),this},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),kt.setInterval(r.flush.bind(r,this),n)},t.prototype.recycleAsyncId=function(r,o,n){if(n===void 0&&(n=0),n!=null&&this.delay===n&&this.pending===!1)return o;o!=null&&kt.clearInterval(o)},t.prototype.execute=function(r,o){if(this.closed)return new Error("executing a cancelled action");this.pending=!1;var n=this._execute(r,o);if(n)return n;this.pending===!1&&this.id!=null&&(this.id=this.recycleAsyncId(this.scheduler,this.id,null))},t.prototype._execute=function(r,o){var n=!1,i;try{this.work(r)}catch(a){n=!0,i=a||new Error("Scheduled action threw falsy error")}if(n)return this.unsubscribe(),i},t.prototype.unsubscribe=function(){if(!this.closed){var r=this,o=r.id,n=r.scheduler,i=n.actions;this.work=this.state=this.scheduler=null,this.pending=!1,Qe(i,this),o!=null&&(this.id=this.recycleAsyncId(n,o,null)),this.delay=null,e.prototype.unsubscribe.call(this)}},t}(So);var Ar=function(){function e(t,r){r===void 0&&(r=e.now),this.schedulerActionCtor=t,this.now=r}return e.prototype.schedule=function(t,r,o){return r===void 0&&(r=0),new this.schedulerActionCtor(this,t).schedule(o,r)},e.now=At.now,e}();var yt=function(e){oe(t,e);function t(r,o){o===void 0&&(o=Ar.now);var n=e.call(this,r,o)||this;return n.actions=[],n._active=!1,n}return t.prototype.flush=function(r){var o=this.actions;if(this._active){o.push(r);return}var n;this._active=!0;do if(n=r.execute(r.state,r.delay))break;while(r=o.shift());if(this._active=!1,n){for(;r=o.shift();)r.unsubscribe();throw n}},t}(Ar);var se=new yt(gt),Cr=se;var Oo=function(e){oe(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.schedule=function(r,o){return o===void 0&&(o=0),o>0?e.prototype.schedule.call(this,r,o):(this.delay=o,this.state=r,this.scheduler.flush(this),this)},t.prototype.execute=function(r,o){return o>0||this.closed?e.prototype.execute.call(this,r,o):this._execute(r,o)},t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!=null&&n>0||n==null&&this.delay>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.flush(this),0)},t}(gt);var Lo=function(e){oe(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t}(yt);var kr=new Lo(Oo);var Mo=function(e){oe(t,e);function t(r,o){var n=e.call(this,r,o)||this;return n.scheduler=r,n.work=o,n}return t.prototype.requestAsyncId=function(r,o,n){return n===void 0&&(n=0),n!==null&&n>0?e.prototype.requestAsyncId.call(this,r,o,n):(r.actions.push(this),r._scheduled||(r._scheduled=vt.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,o,n){var i;if(n===void 0&&(n=0),n!=null?n>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,o,n);var a=r.actions;o!=null&&((i=a[a.length-1])===null||i===void 0?void 0:i.id)!==o&&(vt.cancelAnimationFrame(o),r._scheduled=void 0)},t}(gt);var _o=function(e){oe(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var o=this._scheduled;this._scheduled=void 0;var n=this.actions,i;r=r||n.shift();do if(i=r.execute(r.state,r.delay))break;while((r=n[0])&&r.id===o&&n.shift());if(this._active=!1,i){for(;(r=n[0])&&r.id===o&&n.shift();)r.unsubscribe();throw i}},t}(yt);var me=new _o(Mo);var S=new j(function(e){return e.complete()});function Yt(e){return e&&H(e.schedule)}function Hr(e){return e[e.length-1]}function Xe(e){return H(Hr(e))?e.pop():void 0}function ke(e){return Yt(Hr(e))?e.pop():void 0}function Bt(e,t){return typeof Hr(e)=="number"?e.pop():t}var xt=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Gt(e){return H(e==null?void 0:e.then)}function Jt(e){return H(e[bt])}function Xt(e){return Symbol.asyncIterator&&H(e==null?void 0:e[Symbol.asyncIterator])}function Zt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function Zi(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var er=Zi();function tr(e){return H(e==null?void 0:e[er])}function rr(e){return fo(this,arguments,function(){var r,o,n,i;return Nt(this,function(a){switch(a.label){case 0:r=e.getReader(),a.label=1;case 1:a.trys.push([1,,9,10]),a.label=2;case 2:return[4,nt(r.read())];case 3:return o=a.sent(),n=o.value,i=o.done,i?[4,nt(void 0)]:[3,5];case 4:return[2,a.sent()];case 5:return[4,nt(n)];case 6:return[4,a.sent()];case 7:return a.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function or(e){return H(e==null?void 0:e.getReader)}function U(e){if(e instanceof j)return e;if(e!=null){if(Jt(e))return ea(e);if(xt(e))return ta(e);if(Gt(e))return ra(e);if(Xt(e))return Ao(e);if(tr(e))return oa(e);if(or(e))return na(e)}throw Zt(e)}function ea(e){return new j(function(t){var r=e[bt]();if(H(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function ta(e){return new j(function(t){for(var r=0;r<e.length&&!t.closed;r++)t.next(e[r]);t.complete()})}function ra(e){return new j(function(t){e.then(function(r){t.closed||(t.next(r),t.complete())},function(r){return t.error(r)}).then(null,Qt)})}function oa(e){return new j(function(t){var r,o;try{for(var n=he(e),i=n.next();!i.done;i=n.next()){var a=i.value;if(t.next(a),t.closed)return}}catch(s){r={error:s}}finally{try{i&&!i.done&&(o=n.return)&&o.call(n)}finally{if(r)throw r.error}}t.complete()})}function Ao(e){return new j(function(t){ia(e,t).catch(function(r){return t.error(r)})})}function na(e){return Ao(rr(e))}function ia(e,t){var r,o,n,i;return mo(this,void 0,void 0,function(){var a,s;return Nt(this,function(p){switch(p.label){case 0:p.trys.push([0,5,6,11]),r=uo(e),p.label=1;case 1:return[4,r.next()];case 2:if(o=p.sent(),!!o.done)return[3,4];if(a=o.value,t.next(a),t.closed)return[2];p.label=3;case 3:return[3,1];case 4:return[3,11];case 5:return s=p.sent(),n={error:s},[3,11];case 6:return p.trys.push([6,,9,10]),o&&!o.done&&(i=r.return)?[4,i.call(r)]:[3,8];case 7:p.sent(),p.label=8;case 8:return[3,10];case 9:if(n)throw n.error;return[7];case 10:return[7];case 11:return t.complete(),[2]}})})}function we(e,t,r,o,n){o===void 0&&(o=0),n===void 0&&(n=!1);var i=t.schedule(function(){r(),n?e.add(this.schedule(null,o)):this.unsubscribe()},o);if(e.add(i),!n)return i}function ve(e,t){return t===void 0&&(t=0),E(function(r,o){r.subscribe(T(o,function(n){return we(o,e,function(){return o.next(n)},t)},function(){return we(o,e,function(){return o.complete()},t)},function(n){return we(o,e,function(){return o.error(n)},t)}))})}function Ke(e,t){return t===void 0&&(t=0),E(function(r,o){o.add(e.schedule(function(){return r.subscribe(o)},t))})}function Co(e,t){return U(e).pipe(Ke(t),ve(t))}function ko(e,t){return U(e).pipe(Ke(t),ve(t))}function Ho(e,t){return new j(function(r){var o=0;return t.schedule(function(){o===e.length?r.complete():(r.next(e[o++]),r.closed||this.schedule())})})}function $o(e,t){return new j(function(r){var o;return we(r,t,function(){o=e[er](),we(r,t,function(){var n,i,a;try{n=o.next(),i=n.value,a=n.done}catch(s){r.error(s);return}a?r.complete():r.next(i)},0,!0)}),function(){return H(o==null?void 0:o.return)&&o.return()}})}function nr(e,t){if(!e)throw new Error("Iterable cannot be null");return new j(function(r){we(r,t,function(){var o=e[Symbol.asyncIterator]();we(r,t,function(){o.next().then(function(n){n.done?r.complete():r.next(n.value)})},0,!0)})})}function Po(e,t){return nr(rr(e),t)}function Ro(e,t){if(e!=null){if(Jt(e))return Co(e,t);if(xt(e))return Ho(e,t);if(Gt(e))return ko(e,t);if(Xt(e))return nr(e,t);if(tr(e))return $o(e,t);if(or(e))return Po(e,t)}throw Zt(e)}function ue(e,t){return t?Ro(e,t):U(e)}function I(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e);return ue(e,r)}function $r(e,t){var r=H(e)?e:function(){return e},o=function(n){return n.error(r())};return new j(t?function(n){return t.schedule(o,0,n)}:o)}var ir=ut(function(e){return function(){e(this),this.name="EmptyError",this.message="no elements in sequence"}});function Io(e){return e instanceof Date&&!isNaN(e)}function m(e,t){return E(function(r,o){var n=0;r.subscribe(T(o,function(i){o.next(e.call(t,i,n++))}))})}var aa=Array.isArray;function sa(e,t){return aa(t)?e.apply(void 0,q([],N(t))):e(t)}function Ze(e){return m(function(t){return sa(e,t)})}var ca=Array.isArray,pa=Object.getPrototypeOf,la=Object.prototype,ma=Object.keys;function jo(e){if(e.length===1){var t=e[0];if(ca(t))return{args:t,keys:null};if(fa(t)){var r=ma(t);return{args:r.map(function(o){return t[o]}),keys:r}}}return{args:e,keys:null}}function fa(e){return e&&typeof e=="object"&&pa(e)===la}function Fo(e,t){return e.reduce(function(r,o,n){return r[o]=t[n],r},{})}function z(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e),o=Xe(e),n=jo(e),i=n.args,a=n.keys;if(i.length===0)return ue([],r);var s=new j(Pr(i,r,a?function(p){return Fo(a,p)}:le));return o?s.pipe(Ze(o)):s}function Pr(e,t,r){return r===void 0&&(r=le),function(o){Uo(t,function(){for(var n=e.length,i=new Array(n),a=n,s=n,p=function(l){Uo(t,function(){var f=ue(e[l],t),u=!1;f.subscribe(T(o,function(d){i[l]=d,u||(u=!0,s--),s||o.next(r(i.slice()))},function(){--a||o.complete()}))},o)},c=0;c<n;c++)p(c)},o)}}function Uo(e,t,r){e?we(r,e,t):t()}function Wo(e,t,r,o,n,i,a,s){var p=[],c=0,l=0,f=!1,u=function(){f&&!p.length&&!c&&t.complete()},d=function(L){return c<o?y(L):p.push(L)},y=function(L){i&&t.next(L),c++;var X=!1;U(r(L,l++)).subscribe(T(t,function(te){n==null||n(te),i?d(te):t.next(te)},function(){X=!0},void 0,function(){if(X)try{c--;for(var te=function(){var J=p.shift();a?we(t,a,function(){return y(J)}):y(J)};p.length&&c<o;)te();u()}catch(J){t.error(J)}}))};return e.subscribe(T(t,d,function(){f=!0,u()})),function(){s==null||s()}}function ne(e,t,r){return r===void 0&&(r=1/0),H(t)?ne(function(o,n){return m(function(i,a){return t(o,i,n,a)})(U(e(o,n)))},r):(typeof t=="number"&&(r=t),E(function(o,n){return Wo(o,n,e,r)}))}function Et(e){return e===void 0&&(e=1/0),ne(le,e)}function Do(){return Et(1)}function We(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Do()(ue(e,ke(e)))}function C(e){return new j(function(t){U(e()).subscribe(t)})}var ua=["addListener","removeListener"],da=["addEventListener","removeEventListener"],ha=["on","off"];function h(e,t,r,o){if(H(r)&&(o=r,r=void 0),o)return h(e,t,r).pipe(Ze(o));var n=N(ga(e)?da.map(function(s){return function(p){return e[s](t,p,r)}}):ba(e)?ua.map(Vo(e,t)):va(e)?ha.map(Vo(e,t)):[],2),i=n[0],a=n[1];if(!i&&xt(e))return ne(function(s){return h(s,t,r)})(U(e));if(!i)throw new TypeError("Invalid event target");return new j(function(s){var p=function(){for(var c=[],l=0;l<arguments.length;l++)c[l]=arguments[l];return s.next(1<c.length?c:c[0])};return i(p),function(){return a(p)}})}function Vo(e,t){return function(r){return function(o){return e[r](t,o)}}}function ba(e){return H(e.addListener)&&H(e.removeListener)}function va(e){return H(e.on)&&H(e.off)}function ga(e){return H(e.addEventListener)&&H(e.removeEventListener)}function ar(e,t,r){return r?ar(e,t).pipe(Ze(r)):new j(function(o){var n=function(){for(var a=[],s=0;s<arguments.length;s++)a[s]=arguments[s];return o.next(a.length===1?a[0]:a)},i=e(n);return H(t)?function(){return t(n,i)}:void 0})}function Le(e,t,r){e===void 0&&(e=0),r===void 0&&(r=Cr);var o=-1;return t!=null&&(Yt(t)?r=t:o=t),new j(function(n){var i=Io(e)?+e-r.now():e;i<0&&(i=0);var a=0;return r.schedule(function(){n.closed||(n.next(a++),0<=o?this.schedule(void 0,o):n.complete())},i)})}function O(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e),o=Bt(e,1/0),n=e;return n.length?n.length===1?U(n[0]):Et(o)(ue(n,r)):S}var Ye=new j(be);var ya=Array.isArray;function wt(e){return e.length===1&&ya(e[0])?e[0]:e}function b(e,t){return E(function(r,o){var n=0;r.subscribe(T(o,function(i){return e.call(t,i,n++)&&o.next(i)}))})}function st(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e),o=wt(e);return o.length?new j(function(n){var i=o.map(function(){return[]}),a=o.map(function(){return!1});n.add(function(){i=a=null});for(var s=function(c){U(o[c]).subscribe(T(n,function(l){if(i[c].push(l),i.every(function(u){return u.length})){var f=i.map(function(u){return u.shift()});n.next(r?r.apply(void 0,q([],N(f))):f),i.some(function(u,d){return!u.length&&a[d]})&&n.complete()}},function(){a[c]=!0,!i[c].length&&n.complete()}))},p=0;!n.closed&&p<o.length;p++)s(p);return function(){i=a=null}}):S}function No(e){return E(function(t,r){var o=!1,n=null,i=null,a=!1,s=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var c=n;n=null,r.next(c)}a&&r.complete()},p=function(){i=null,a&&r.complete()};t.subscribe(T(r,function(c){o=!0,n=c,i||U(e(c)).subscribe(i=T(r,s,p))},function(){a=!0,(!o||!i||i.closed)&&r.complete()}))})}function Me(e,t){return t===void 0&&(t=se),No(function(){return Le(e,t)})}function Be(e,t){return t===void 0&&(t=null),t=t!=null?t:e,E(function(r,o){var n=[],i=0;r.subscribe(T(o,function(a){var s,p,c,l,f=null;i++%t===0&&n.push([]);try{for(var u=he(n),d=u.next();!d.done;d=u.next()){var y=d.value;y.push(a),e<=y.length&&(f=f!=null?f:[],f.push(y))}}catch(te){s={error:te}}finally{try{d&&!d.done&&(p=u.return)&&p.call(u)}finally{if(s)throw s.error}}if(f)try{for(var L=he(f),X=L.next();!X.done;X=L.next()){var y=X.value;Qe(n,y),o.next(y)}}catch(te){c={error:te}}finally{try{X&&!X.done&&(l=L.return)&&l.call(L)}finally{if(c)throw c.error}}},function(){var a,s;try{for(var p=he(n),c=p.next();!c.done;c=p.next()){var l=c.value;o.next(l)}}catch(f){a={error:f}}finally{try{c&&!c.done&&(s=p.return)&&s.call(p)}finally{if(a)throw a.error}}o.complete()},void 0,function(){n=null}))})}function de(e){return E(function(t,r){var o=null,n=!1,i;o=t.subscribe(T(r,void 0,void 0,function(a){i=U(e(a,de(e)(t))),o?(o.unsubscribe(),o=null,i.subscribe(r)):n=!0})),n&&(o.unsubscribe(),o=null,i.subscribe(r))})}function zo(e,t,r,o,n){return function(i,a){var s=r,p=t,c=0;i.subscribe(T(a,function(l){var f=c++;p=s?e(p,l,f):(s=!0,l),o&&a.next(p)},n&&function(){s&&a.next(p),a.complete()}))}}function Rr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return r?xo(Rr.apply(void 0,q([],N(e))),Ze(r)):E(function(o,n){Pr(q([o],N(wt(e))))(n)})}function He(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Rr.apply(void 0,q([],N(e)))}function Ht(e){return E(function(t,r){var o=!1,n=null,i=null,a=function(){if(i==null||i.unsubscribe(),i=null,o){o=!1;var s=n;n=null,r.next(s)}};t.subscribe(T(r,function(s){i==null||i.unsubscribe(),o=!0,n=s,i=T(r,a,be),U(e(s)).subscribe(i)},function(){a(),r.complete()},void 0,function(){n=i=null}))})}function _e(e,t){return t===void 0&&(t=se),E(function(r,o){var n=null,i=null,a=null,s=function(){if(n){n.unsubscribe(),n=null;var c=i;i=null,o.next(c)}};function p(){var c=a+e,l=t.now();if(l<c){n=this.schedule(void 0,c-l),o.add(n);return}s()}r.subscribe(T(o,function(c){i=c,a=t.now(),n||(n=t.schedule(p,e),o.add(n))},function(){s(),o.complete()},void 0,function(){i=n=null}))})}function De(e){return E(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){o||r.next(e),r.complete()}))})}function Te(e){return e<=0?function(){return S}:E(function(t,r){var o=0;t.subscribe(T(r,function(n){++o<=e&&(r.next(n),e<=o&&r.complete())}))})}function Z(){return E(function(e,t){e.subscribe(T(t,be))})}function qo(e){return m(function(){return e})}function Ir(e,t){return t?function(r){return We(t.pipe(Te(1),Z()),r.pipe(Ir(e)))}:ne(function(r,o){return U(e(r,o)).pipe(Te(1),qo(r))})}function Ge(e,t){t===void 0&&(t=se);var r=Le(e,t);return Ir(function(){return r})}function K(e,t){return t===void 0&&(t=le),e=e!=null?e:xa,E(function(r,o){var n,i=!0;r.subscribe(T(o,function(a){var s=t(a);(i||!e(n,s))&&(i=!1,n=s,o.next(a))}))})}function xa(e,t){return e===t}function ee(e,t){return K(function(r,o){return t?t(r[e],o[e]):r[e]===o[e]})}function Qo(e){return e===void 0&&(e=Ea),E(function(t,r){var o=!1;t.subscribe(T(r,function(n){o=!0,r.next(n)},function(){return o?r.complete():r.error(e())}))})}function Ea(){return new ir}function ie(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return function(r){return We(r,I.apply(void 0,q([],N(e))))}}function _(e){return E(function(t,r){try{t.subscribe(r)}finally{r.add(e)}})}function Ae(e,t){var r=arguments.length>=2;return function(o){return o.pipe(e?b(function(n,i){return e(n,i,o)}):le,Te(1),r?De(t):Qo(function(){return new ir}))}}function jr(e){return e<=0?function(){return S}:E(function(t,r){var o=[];t.subscribe(T(r,function(n){o.push(n),e<o.length&&o.shift()},function(){var n,i;try{for(var a=he(o),s=a.next();!s.done;s=a.next()){var p=s.value;r.next(p)}}catch(c){n={error:c}}finally{try{s&&!s.done&&(i=a.return)&&i.call(a)}finally{if(n)throw n.error}}r.complete()},void 0,function(){o=null}))})}function Ko(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e),o=Bt(e,1/0);return e=wt(e),E(function(n,i){Et(o)(ue(q([n],N(e)),r)).subscribe(i)})}function Re(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Ko.apply(void 0,q([],N(e)))}function ct(e){var t,r=1/0,o;return e!=null&&(typeof e=="object"?(t=e.count,r=t===void 0?1/0:t,o=e.delay):r=e),r<=0?function(){return S}:E(function(n,i){var a=0,s,p=function(){if(s==null||s.unsubscribe(),s=null,o!=null){var l=typeof o=="number"?Le(o):U(o(a)),f=T(i,function(){f.unsubscribe(),c()});l.subscribe(f)}else c()},c=function(){var l=!1;s=n.subscribe(T(i,void 0,function(){++a<r?s?p():l=!0:i.complete()})),l&&p()};c()})}function Fr(e,t){return E(zo(e,t,arguments.length>=2,!0))}function pe(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new g}:t,o=e.resetOnError,n=o===void 0?!0:o,i=e.resetOnComplete,a=i===void 0?!0:i,s=e.resetOnRefCountZero,p=s===void 0?!0:s;return function(c){var l,f,u,d=0,y=!1,L=!1,X=function(){f==null||f.unsubscribe(),f=void 0},te=function(){X(),l=u=void 0,y=L=!1},J=function(){var k=l;te(),k==null||k.unsubscribe()};return E(function(k,ft){d++,!L&&!y&&X();var qe=u=u!=null?u:r();ft.add(function(){d--,d===0&&!L&&!y&&(f=Ur(J,p))}),qe.subscribe(ft),!l&&d>0&&(l=new at({next:function(Fe){return qe.next(Fe)},error:function(Fe){L=!0,X(),f=Ur(te,n,Fe),qe.error(Fe)},complete:function(){y=!0,X(),f=Ur(te,a),qe.complete()}}),U(k).subscribe(l))})(c)}}function Ur(e,t){for(var r=[],o=2;o<arguments.length;o++)r[o-2]=arguments[o];if(t===!0){e();return}if(t!==!1){var n=new at({next:function(){n.unsubscribe(),e()}});return U(t.apply(void 0,q([],N(r)))).subscribe(n)}}function G(e,t,r){var o,n,i,a,s=!1;return e&&typeof e=="object"?(o=e.bufferSize,a=o===void 0?1/0:o,n=e.windowTime,t=n===void 0?1/0:n,i=e.refCount,s=i===void 0?!1:i,r=e.scheduler):a=e!=null?e:1/0,pe({connector:function(){return new Ct(a,t,r)},resetOnError:!0,resetOnComplete:!1,resetOnRefCountZero:s})}function Ce(e){return b(function(t,r){return e<=r})}function Wr(e){return E(function(t,r){var o=!1,n=T(r,function(){n==null||n.unsubscribe(),o=!0},be);U(e).subscribe(n),t.subscribe(T(r,function(i){return o&&r.next(i)}))})}function Q(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=ke(e);return E(function(o,n){(r?We(e,o,r):We(e,o)).subscribe(n)})}function v(e,t){return E(function(r,o){var n=null,i=0,a=!1,s=function(){return a&&!n&&o.complete()};r.subscribe(T(o,function(p){n==null||n.unsubscribe();var c=0,l=i++;U(e(p,l)).subscribe(n=T(o,function(f){return o.next(t?t(p,f,l,c++):f)},function(){n=null,s()}))},function(){a=!0,s()}))})}function W(e){return E(function(t,r){U(e).subscribe(T(r,function(){return r.complete()},be)),!r.closed&&t.subscribe(r)})}function Dr(e,t){return t===void 0&&(t=!1),E(function(r,o){var n=0;r.subscribe(T(o,function(i){var a=e(i,n++);(a||t)&&o.next(i),!a&&o.complete()}))})}function w(e,t,r){var o=H(e)||t||r?{next:e,error:t,complete:r}:e;return o?E(function(n,i){var a;(a=o.subscribe)===null||a===void 0||a.call(o);var s=!0;n.subscribe(T(i,function(p){var c;(c=o.next)===null||c===void 0||c.call(o,p),i.next(p)},function(){var p;s=!1,(p=o.complete)===null||p===void 0||p.call(o),i.complete()},function(p){var c;s=!1,(c=o.error)===null||c===void 0||c.call(o,p),i.error(p)},function(){var p,c;s&&((p=o.unsubscribe)===null||p===void 0||p.call(o)),(c=o.finalize)===null||c===void 0||c.call(o)}))}):le}function Yo(e,t){return E(function(r,o){var n=t!=null?t:{},i=n.leading,a=i===void 0?!0:i,s=n.trailing,p=s===void 0?!1:s,c=!1,l=null,f=null,u=!1,d=function(){f==null||f.unsubscribe(),f=null,p&&(X(),u&&o.complete())},y=function(){f=null,u&&o.complete()},L=function(te){return f=U(e(te)).subscribe(T(o,d,y))},X=function(){if(c){c=!1;var te=l;l=null,o.next(te),!u&&L(te)}};r.subscribe(T(o,function(te){c=!0,l=te,!(f&&!f.closed)&&(a?X():L(te))},function(){u=!0,!(p&&c&&f&&!f.closed)&&o.complete()}))})}function pt(e,t,r){t===void 0&&(t=se);var o=Le(e,t);return Yo(function(){return o},r)}function re(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];var r=Xe(e);return E(function(o,n){for(var i=e.length,a=new Array(i),s=e.map(function(){return!1}),p=!1,c=function(f){U(e[f]).subscribe(T(n,function(u){a[f]=u,!p&&!s[f]&&(s[f]=!0,(p=s.every(le))&&(s=null))},be))},l=0;l<i;l++)c(l);o.subscribe(T(n,function(f){if(p){var u=q([f],N(a));n.next(r?r.apply(void 0,q([],N(u))):u)}}))})}function Bo(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return E(function(r,o){st.apply(void 0,q([r],N(e))).subscribe(o)})}function Vr(){for(var e=[],t=0;t<arguments.length;t++)e[t]=arguments[t];return Bo.apply(void 0,q([],N(e)))}function Go(){let e=new Ct(1);return h(document,"DOMContentLoaded",{once:!0}).subscribe(()=>e.next(document)),e}function P(e,t=document){return Array.from(t.querySelectorAll(e))}function R(e,t=document){let r=fe(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function fe(e,t=document){return t.querySelector(e)||void 0}function Ie(){var e,t,r,o;return(o=(r=(t=(e=document.activeElement)==null?void 0:e.shadowRoot)==null?void 0:t.activeElement)!=null?r:document.activeElement)!=null?o:void 0}var wa=O(h(document.body,"focusin"),h(document.body,"focusout")).pipe(_e(1),Q(void 0),m(()=>Ie()||document.body),G(1));function et(e){return wa.pipe(m(t=>e.contains(t)),K())}function $t(e,t){return C(()=>O(h(e,"mouseenter").pipe(m(()=>!0)),h(e,"mouseleave").pipe(m(()=>!1))).pipe(t?Ht(r=>Le(+!r*t)):le,Q(e.matches(":hover"))))}function Jo(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)Jo(e,r)}function x(e,t,...r){let o=document.createElement(e);if(t)for(let n of Object.keys(t))typeof t[n]!="undefined"&&(typeof t[n]!="boolean"?o.setAttribute(n,t[n]):o.setAttribute(n,""));for(let n of r)Jo(o,n);return o}function sr(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function Tt(e){let t=x("script",{src:e});return C(()=>(document.head.appendChild(t),O(h(t,"load"),h(t,"error").pipe(v(()=>$r(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),_(()=>document.head.removeChild(t)),Te(1))))}var Xo=new g,Ta=C(()=>typeof ResizeObserver=="undefined"?Tt("https://unpkg.com/resize-observer-polyfill"):I(void 0)).pipe(m(()=>new ResizeObserver(e=>e.forEach(t=>Xo.next(t)))),v(e=>O(Ye,I(e)).pipe(_(()=>e.disconnect()))),G(1));function ce(e){return{width:e.offsetWidth,height:e.offsetHeight}}function ge(e){let t=e;for(;t.clientWidth===0&&t.parentElement;)t=t.parentElement;return Ta.pipe(w(r=>r.observe(t)),v(r=>Xo.pipe(b(o=>o.target===t),_(()=>r.unobserve(t)))),m(()=>ce(e)),Q(ce(e)))}function St(e){return{width:e.scrollWidth,height:e.scrollHeight}}function cr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}function Zo(e){let t=[],r=e.parentElement;for(;r;)(e.clientWidth>r.clientWidth||e.clientHeight>r.clientHeight)&&t.push(r),r=(e=r).parentElement;return t.length===0&&t.push(document.documentElement),t}function Ve(e){return{x:e.offsetLeft,y:e.offsetTop}}function en(e){let t=e.getBoundingClientRect();return{x:t.x+window.scrollX,y:t.y+window.scrollY}}function tn(e){return O(h(window,"load"),h(window,"resize")).pipe(Me(0,me),m(()=>Ve(e)),Q(Ve(e)))}function pr(e){return{x:e.scrollLeft,y:e.scrollTop}}function Ne(e){return O(h(e,"scroll"),h(window,"scroll"),h(window,"resize")).pipe(Me(0,me),m(()=>pr(e)),Q(pr(e)))}var rn=new g,Sa=C(()=>I(new IntersectionObserver(e=>{for(let t of e)rn.next(t)},{threshold:0}))).pipe(v(e=>O(Ye,I(e)).pipe(_(()=>e.disconnect()))),G(1));function tt(e){return Sa.pipe(w(t=>t.observe(e)),v(t=>rn.pipe(b(({target:r})=>r===e),_(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function on(e,t=16){return Ne(e).pipe(m(({y:r})=>{let o=ce(e),n=St(e);return r>=n.height-o.height-t}),K())}var lr={drawer:R("[data-md-toggle=drawer]"),search:R("[data-md-toggle=search]")};function nn(e){return lr[e].checked}function Je(e,t){lr[e].checked!==t&&lr[e].click()}function ze(e){let t=lr[e];return h(t,"change").pipe(m(()=>t.checked),Q(t.checked))}function Oa(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function La(){return O(h(window,"compositionstart").pipe(m(()=>!0)),h(window,"compositionend").pipe(m(()=>!1))).pipe(Q(!1))}function an(){let e=h(window,"keydown").pipe(b(t=>!(t.metaKey||t.ctrlKey)),m(t=>({mode:nn("search")?"search":"global",type:t.key,claim(){t.preventDefault(),t.stopPropagation()}})),b(({mode:t,type:r})=>{if(t==="global"){let o=Ie();if(typeof o!="undefined")return!Oa(o,r)}return!0}),pe());return La().pipe(v(t=>t?S:e))}function ye(){return new URL(location.href)}function lt(e,t=!1){if(B("navigation.instant")&&!t){let r=x("a",{href:e.href});document.body.appendChild(r),r.click(),r.remove()}else location.href=e.href}function sn(){return new g}function cn(){return location.hash.slice(1)}function pn(e){let t=x("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function Ma(e){return O(h(window,"hashchange"),e).pipe(m(cn),Q(cn()),b(t=>t.length>0),G(1))}function ln(e){return Ma(e).pipe(m(t=>fe(`[id="${t}"]`)),b(t=>typeof t!="undefined"))}function Pt(e){let t=matchMedia(e);return ar(r=>t.addListener(()=>r(t.matches))).pipe(Q(t.matches))}function mn(){let e=matchMedia("print");return O(h(window,"beforeprint").pipe(m(()=>!0)),h(window,"afterprint").pipe(m(()=>!1))).pipe(Q(e.matches))}function Nr(e,t){return e.pipe(v(r=>r?t():S))}function zr(e,t){return new j(r=>{let o=new XMLHttpRequest;return o.open("GET",`${e}`),o.responseType="blob",o.addEventListener("load",()=>{o.status>=200&&o.status<300?(r.next(o.response),r.complete()):r.error(new Error(o.statusText))}),o.addEventListener("error",()=>{r.error(new Error("Network error"))}),o.addEventListener("abort",()=>{r.complete()}),typeof(t==null?void 0:t.progress$)!="undefined"&&(o.addEventListener("progress",n=>{var i;if(n.lengthComputable)t.progress$.next(n.loaded/n.total*100);else{let a=(i=o.getResponseHeader("Content-Length"))!=null?i:0;t.progress$.next(n.loaded/+a*100)}}),t.progress$.next(5)),o.send(),()=>o.abort()})}function je(e,t){return zr(e,t).pipe(v(r=>r.text()),m(r=>JSON.parse(r)),G(1))}function fn(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/html")),G(1))}function un(e,t){let r=new DOMParser;return zr(e,t).pipe(v(o=>o.text()),m(o=>r.parseFromString(o,"text/xml")),G(1))}function dn(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function hn(){return O(h(window,"scroll",{passive:!0}),h(window,"resize",{passive:!0})).pipe(m(dn),Q(dn()))}function bn(){return{width:innerWidth,height:innerHeight}}function vn(){return h(window,"resize",{passive:!0}).pipe(m(bn),Q(bn()))}function gn(){return z([hn(),vn()]).pipe(m(([e,t])=>({offset:e,size:t})),G(1))}function mr(e,{viewport$:t,header$:r}){let o=t.pipe(ee("size")),n=z([o,r]).pipe(m(()=>Ve(e)));return z([r,t,n]).pipe(m(([{height:i},{offset:a,size:s},{x:p,y:c}])=>({offset:{x:a.x-p,y:a.y-c+i},size:s})))}function _a(e){return h(e,"message",t=>t.data)}function Aa(e){let t=new g;return t.subscribe(r=>e.postMessage(r)),t}function yn(e,t=new Worker(e)){let r=_a(t),o=Aa(t),n=new g;n.subscribe(o);let i=o.pipe(Z(),ie(!0));return n.pipe(Z(),Re(r.pipe(W(i))),pe())}var Ca=R("#__config"),Ot=JSON.parse(Ca.textContent);Ot.base=`${new URL(Ot.base,ye())}`;function xe(){return Ot}function B(e){return Ot.features.includes(e)}function Ee(e,t){return typeof t!="undefined"?Ot.translations[e].replace("#",t.toString()):Ot.translations[e]}function Se(e,t=document){return R(`[data-md-component=${e}]`,t)}function ae(e,t=document){return P(`[data-md-component=${e}]`,t)}function ka(e){let t=R(".md-typeset > :first-child",e);return h(t,"click",{once:!0}).pipe(m(()=>R(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function xn(e){if(!B("announce.dismiss")||!e.childElementCount)return S;if(!e.hidden){let t=R(".md-typeset",e);__md_hash(t.innerHTML)===__md_get("__announce")&&(e.hidden=!0)}return C(()=>{let t=new g;return t.subscribe(({hash:r})=>{e.hidden=!0,__md_set("__announce",r)}),ka(e).pipe(w(r=>t.next(r)),_(()=>t.complete()),m(r=>$({ref:e},r)))})}function Ha(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function En(e,t){let r=new g;return r.subscribe(({hidden:o})=>{e.hidden=o}),Ha(e,t).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))}function Rt(e,t){return t==="inline"?x("div",{class:"md-tooltip md-tooltip--inline",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"})):x("div",{class:"md-tooltip",id:e,role:"tooltip"},x("div",{class:"md-tooltip__inner md-typeset"}))}function wn(...e){return x("div",{class:"md-tooltip2",role:"tooltip"},x("div",{class:"md-tooltip2__inner md-typeset"},e))}function Tn(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return x("aside",{class:"md-annotation",tabIndex:0},Rt(t),x("a",{href:r,class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}else return x("aside",{class:"md-annotation",tabIndex:0},Rt(t),x("span",{class:"md-annotation__index",tabIndex:-1},x("span",{"data-md-annotation-id":e})))}function Sn(e){return x("button",{class:"md-clipboard md-icon",title:Ee("clipboard.copy"),"data-clipboard-target":`#${e} > code`})}var Ln=Mt(qr());function Qr(e,t){let r=t&2,o=t&1,n=Object.keys(e.terms).filter(p=>!e.terms[p]).reduce((p,c)=>[...p,x("del",null,(0,Ln.default)(c))," "],[]).slice(0,-1),i=xe(),a=new URL(e.location,i.base);B("search.highlight")&&a.searchParams.set("h",Object.entries(e.terms).filter(([,p])=>p).reduce((p,[c])=>`${p} ${c}`.trim(),""));let{tags:s}=xe();return x("a",{href:`${a}`,class:"md-search-result__link",tabIndex:-1},x("article",{class:"md-search-result__article md-typeset","data-md-score":e.score.toFixed(2)},r>0&&x("div",{class:"md-search-result__icon md-icon"}),r>0&&x("h1",null,e.title),r<=0&&x("h2",null,e.title),o>0&&e.text.length>0&&e.text,e.tags&&x("nav",{class:"md-tags"},e.tags.map(p=>{let c=s?p in s?`md-tag-icon md-tag--${s[p]}`:"md-tag-icon":"";return x("span",{class:`md-tag ${c}`},p)})),o>0&&n.length>0&&x("p",{class:"md-search-result__terms"},Ee("search.result.term.missing"),": ",...n)))}function Mn(e){let t=e[0].score,r=[...e],o=xe(),n=r.findIndex(l=>!`${new URL(l.location,o.base)}`.includes("#")),[i]=r.splice(n,1),a=r.findIndex(l=>l.score<t);a===-1&&(a=r.length);let s=r.slice(0,a),p=r.slice(a),c=[Qr(i,2|+(!n&&a===0)),...s.map(l=>Qr(l,1)),...p.length?[x("details",{class:"md-search-result__more"},x("summary",{tabIndex:-1},x("div",null,p.length>0&&p.length===1?Ee("search.result.more.one"):Ee("search.result.more.other",p.length))),...p.map(l=>Qr(l,1)))]:[]];return x("li",{class:"md-search-result__item"},c)}function _n(e){return x("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>x("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?sr(r):r)))}function Kr(e){let t=`tabbed-control tabbed-control--${e}`;return x("div",{class:t,hidden:!0},x("button",{class:"tabbed-button",tabIndex:-1,"aria-hidden":"true"}))}function An(e){return x("div",{class:"md-typeset__scrollwrap"},x("div",{class:"md-typeset__table"},e))}function Ra(e){var o;let t=xe(),r=new URL(`../${e.version}/`,t.base);return x("li",{class:"md-version__item"},x("a",{href:`${r}`,class:"md-version__link"},e.title,((o=t.version)==null?void 0:o.alias)&&e.aliases.length>0&&x("span",{class:"md-version__alias"},e.aliases[0])))}function Cn(e,t){var o;let r=xe();return e=e.filter(n=>{var i;return!((i=n.properties)!=null&&i.hidden)}),x("div",{class:"md-version"},x("button",{class:"md-version__current","aria-label":Ee("select.version")},t.title,((o=r.version)==null?void 0:o.alias)&&t.aliases.length>0&&x("span",{class:"md-version__alias"},t.aliases[0])),x("ul",{class:"md-version__list"},e.map(Ra)))}var Ia=0;function ja(e){let t=z([et(e),$t(e)]).pipe(m(([o,n])=>o||n),K()),r=C(()=>Zo(e)).pipe(ne(Ne),pt(1),He(t),m(()=>en(e)));return t.pipe(Ae(o=>o),v(()=>z([t,r])),m(([o,n])=>({active:o,offset:n})),pe())}function Fa(e,t){let{content$:r,viewport$:o}=t,n=`__tooltip2_${Ia++}`;return C(()=>{let i=new g,a=new _r(!1);i.pipe(Z(),ie(!1)).subscribe(a);let s=a.pipe(Ht(c=>Le(+!c*250,kr)),K(),v(c=>c?r:S),w(c=>c.id=n),pe());z([i.pipe(m(({active:c})=>c)),s.pipe(v(c=>$t(c,250)),Q(!1))]).pipe(m(c=>c.some(l=>l))).subscribe(a);let p=a.pipe(b(c=>c),re(s,o),m(([c,l,{size:f}])=>{let u=e.getBoundingClientRect(),d=u.width/2;if(l.role==="tooltip")return{x:d,y:8+u.height};if(u.y>=f.height/2){let{height:y}=ce(l);return{x:d,y:-16-y}}else return{x:d,y:16+u.height}}));return z([s,i,p]).subscribe(([c,{offset:l},f])=>{c.style.setProperty("--md-tooltip-host-x",`${l.x}px`),c.style.setProperty("--md-tooltip-host-y",`${l.y}px`),c.style.setProperty("--md-tooltip-x",`${f.x}px`),c.style.setProperty("--md-tooltip-y",`${f.y}px`),c.classList.toggle("md-tooltip2--top",f.y<0),c.classList.toggle("md-tooltip2--bottom",f.y>=0)}),a.pipe(b(c=>c),re(s,(c,l)=>l),b(c=>c.role==="tooltip")).subscribe(c=>{let l=ce(R(":scope > *",c));c.style.setProperty("--md-tooltip-width",`${l.width}px`),c.style.setProperty("--md-tooltip-tail","0px")}),a.pipe(K(),ve(me),re(s)).subscribe(([c,l])=>{l.classList.toggle("md-tooltip2--active",c)}),z([a.pipe(b(c=>c)),s]).subscribe(([c,l])=>{l.role==="dialog"?(e.setAttribute("aria-controls",n),e.setAttribute("aria-haspopup","dialog")):e.setAttribute("aria-describedby",n)}),a.pipe(b(c=>!c)).subscribe(()=>{e.removeAttribute("aria-controls"),e.removeAttribute("aria-describedby"),e.removeAttribute("aria-haspopup")}),ja(e).pipe(w(c=>i.next(c)),_(()=>i.complete()),m(c=>$({ref:e},c)))})}function mt(e,{viewport$:t},r=document.body){return Fa(e,{content$:new j(o=>{let n=e.title,i=wn(n);return o.next(i),e.removeAttribute("title"),r.append(i),()=>{i.remove(),e.setAttribute("title",n)}}),viewport$:t})}function Ua(e,t){let r=C(()=>z([tn(e),Ne(t)])).pipe(m(([{x:o,y:n},i])=>{let{width:a,height:s}=ce(e);return{x:o-i.x+a/2,y:n-i.y+s/2}}));return et(e).pipe(v(o=>r.pipe(m(n=>({active:o,offset:n})),Te(+!o||1/0))))}function kn(e,t,{target$:r}){let[o,n]=Array.from(e.children);return C(()=>{let i=new g,a=i.pipe(Z(),ie(!0));return i.subscribe({next({offset:s}){e.style.setProperty("--md-tooltip-x",`${s.x}px`),e.style.setProperty("--md-tooltip-y",`${s.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),tt(e).pipe(W(a)).subscribe(s=>{e.toggleAttribute("data-md-visible",s)}),O(i.pipe(b(({active:s})=>s)),i.pipe(_e(250),b(({active:s})=>!s))).subscribe({next({active:s}){s?e.prepend(o):o.remove()},complete(){e.prepend(o)}}),i.pipe(Me(16,me)).subscribe(({active:s})=>{o.classList.toggle("md-tooltip--active",s)}),i.pipe(pt(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:s})=>s)).subscribe({next(s){s?e.style.setProperty("--md-tooltip-0",`${-s}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),h(n,"click").pipe(W(a),b(s=>!(s.metaKey||s.ctrlKey))).subscribe(s=>{s.stopPropagation(),s.preventDefault()}),h(n,"mousedown").pipe(W(a),re(i)).subscribe(([s,{active:p}])=>{var c;if(s.button!==0||s.metaKey||s.ctrlKey)s.preventDefault();else if(p){s.preventDefault();let l=e.parentElement.closest(".md-annotation");l instanceof HTMLElement?l.focus():(c=Ie())==null||c.blur()}}),r.pipe(W(a),b(s=>s===o),Ge(125)).subscribe(()=>e.focus()),Ua(e,t).pipe(w(s=>i.next(s)),_(()=>i.complete()),m(s=>$({ref:e},s)))})}function Wa(e){return e.tagName==="CODE"?P(".c, .c1, .cm",e):[e]}function Da(e){let t=[];for(let r of Wa(e)){let o=[],n=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=n.nextNode();i;i=n.nextNode())o.push(i);for(let i of o){let a;for(;a=/(\(\d+\))(!)?/.exec(i.textContent);){let[,s,p]=a;if(typeof p=="undefined"){let c=i.splitText(a.index);i=c.splitText(s.length),t.push(c)}else{i.textContent=s,t.push(i);break}}}}return t}function Hn(e,t){t.append(...Array.from(e.childNodes))}function fr(e,t,{target$:r,print$:o}){let n=t.closest("[id]"),i=n==null?void 0:n.id,a=new Map;for(let s of Da(t)){let[,p]=s.textContent.match(/\((\d+)\)/);fe(`:scope > li:nth-child(${p})`,e)&&(a.set(p,Tn(p,i)),s.replaceWith(a.get(p)))}return a.size===0?S:C(()=>{let s=new g,p=s.pipe(Z(),ie(!0)),c=[];for(let[l,f]of a)c.push([R(".md-typeset",f),R(`:scope > li:nth-child(${l})`,e)]);return o.pipe(W(p)).subscribe(l=>{e.hidden=!l,e.classList.toggle("md-annotation-list",l);for(let[f,u]of c)l?Hn(f,u):Hn(u,f)}),O(...[...a].map(([,l])=>kn(l,t,{target$:r}))).pipe(_(()=>s.complete()),pe())})}function $n(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return $n(t)}}function Pn(e,t){return C(()=>{let r=$n(e);return typeof r!="undefined"?fr(r,e,t):S})}var Rn=Mt(Br());var Va=0;function In(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return In(t)}}function Na(e){return ge(e).pipe(m(({width:t})=>({scrollable:St(e).width>t})),ee("scrollable"))}function jn(e,t){let{matches:r}=matchMedia("(hover)"),o=C(()=>{let n=new g,i=n.pipe(jr(1));n.subscribe(({scrollable:c})=>{c&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")});let a=[];if(Rn.default.isSupported()&&(e.closest(".copy")||B("content.code.copy")&&!e.closest(".no-copy"))){let c=e.closest("pre");c.id=`__code_${Va++}`;let l=Sn(c.id);c.insertBefore(l,e),B("content.tooltips")&&a.push(mt(l,{viewport$}))}let s=e.closest(".highlight");if(s instanceof HTMLElement){let c=In(s);if(typeof c!="undefined"&&(s.classList.contains("annotate")||B("content.code.annotate"))){let l=fr(c,e,t);a.push(ge(s).pipe(W(i),m(({width:f,height:u})=>f&&u),K(),v(f=>f?l:S)))}}return P(":scope > span[id]",e).length&&e.classList.add("md-code__content"),Na(e).pipe(w(c=>n.next(c)),_(()=>n.complete()),m(c=>$({ref:e},c)),Re(...a))});return B("content.lazy")?tt(e).pipe(b(n=>n),Te(1),v(()=>o)):o}function za(e,{target$:t,print$:r}){let o=!0;return O(t.pipe(m(n=>n.closest("details:not([open])")),b(n=>e===n),m(()=>({action:"open",reveal:!0}))),r.pipe(b(n=>n||!o),w(()=>o=e.open),m(n=>({action:n?"open":"close"}))))}function Fn(e,t){return C(()=>{let r=new g;return r.subscribe(({action:o,reveal:n})=>{e.toggleAttribute("open",o==="open"),n&&e.scrollIntoView()}),za(e,t).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))})}var Un=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel p,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel p{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}";var Gr,Qa=0;function Ka(){return typeof mermaid=="undefined"||mermaid instanceof Element?Tt("https://unpkg.com/mermaid@11/dist/mermaid.min.js"):I(void 0)}function Wn(e){return e.classList.remove("mermaid"),Gr||(Gr=Ka().pipe(w(()=>mermaid.initialize({startOnLoad:!1,themeCSS:Un,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),G(1))),Gr.subscribe(()=>co(this,null,function*(){e.classList.add("mermaid");let t=`__mermaid_${Qa++}`,r=x("div",{class:"mermaid"}),o=e.textContent,{svg:n,fn:i}=yield mermaid.render(t,o),a=r.attachShadow({mode:"closed"});a.innerHTML=n,e.replaceWith(r),i==null||i(a)})),Gr.pipe(m(()=>({ref:e})))}var Dn=x("table");function Vn(e){return e.replaceWith(Dn),Dn.replaceWith(An(e)),I({ref:e})}function Ya(e){let t=e.find(r=>r.checked)||e[0];return O(...e.map(r=>h(r,"change").pipe(m(()=>R(`label[for="${r.id}"]`))))).pipe(Q(R(`label[for="${t.id}"]`)),m(r=>({active:r})))}function Nn(e,{viewport$:t,target$:r}){let o=R(".tabbed-labels",e),n=P(":scope > input",e),i=Kr("prev");e.append(i);let a=Kr("next");return e.append(a),C(()=>{let s=new g,p=s.pipe(Z(),ie(!0));z([s,ge(e),tt(e)]).pipe(W(p),Me(1,me)).subscribe({next([{active:c},l]){let f=Ve(c),{width:u}=ce(c);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let d=pr(o);(f.x<d.x||f.x+u>d.x+l.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),z([Ne(o),ge(o)]).pipe(W(p)).subscribe(([c,l])=>{let f=St(o);i.hidden=c.x<16,a.hidden=c.x>f.width-l.width-16}),O(h(i,"click").pipe(m(()=>-1)),h(a,"click").pipe(m(()=>1))).pipe(W(p)).subscribe(c=>{let{width:l}=ce(o);o.scrollBy({left:l*c,behavior:"smooth"})}),r.pipe(W(p),b(c=>n.includes(c))).subscribe(c=>c.click()),o.classList.add("tabbed-labels--linked");for(let c of n){let l=R(`label[for="${c.id}"]`);l.replaceChildren(x("a",{href:`#${l.htmlFor}`,tabIndex:-1},...Array.from(l.childNodes))),h(l.firstElementChild,"click").pipe(W(p),b(f=>!(f.metaKey||f.ctrlKey)),w(f=>{f.preventDefault(),f.stopPropagation()})).subscribe(()=>{history.replaceState({},"",`#${l.htmlFor}`),l.click()})}return B("content.tabs.link")&&s.pipe(Ce(1),re(t)).subscribe(([{active:c},{offset:l}])=>{let f=c.innerText.trim();if(c.hasAttribute("data-md-switching"))c.removeAttribute("data-md-switching");else{let u=e.offsetTop-l.y;for(let y of P("[data-tabs]"))for(let L of P(":scope > input",y)){let X=R(`label[for="${L.id}"]`);if(X!==c&&X.innerText.trim()===f){X.setAttribute("data-md-switching",""),L.click();break}}window.scrollTo({top:e.offsetTop-u});let d=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...d])])}}),s.pipe(W(p)).subscribe(()=>{for(let c of P("audio, video",e))c.pause()}),Ya(n).pipe(w(c=>s.next(c)),_(()=>s.complete()),m(c=>$({ref:e},c)))}).pipe(Ke(se))}function zn(e,{viewport$:t,target$:r,print$:o}){return O(...P(".annotate:not(.highlight)",e).map(n=>Pn(n,{target$:r,print$:o})),...P("pre:not(.mermaid) > code",e).map(n=>jn(n,{target$:r,print$:o})),...P("pre.mermaid",e).map(n=>Wn(n)),...P("table:not([class])",e).map(n=>Vn(n)),...P("details",e).map(n=>Fn(n,{target$:r,print$:o})),...P("[data-tabs]",e).map(n=>Nn(n,{viewport$:t,target$:r})),...P("[title]",e).filter(()=>B("content.tooltips")).map(n=>mt(n,{viewport$:t})))}function Ba(e,{alert$:t}){return t.pipe(v(r=>O(I(!0),I(!1).pipe(Ge(2e3))).pipe(m(o=>({message:r,active:o})))))}function qn(e,t){let r=R(".md-typeset",e);return C(()=>{let o=new g;return o.subscribe(({message:n,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=n}),Ba(e,t).pipe(w(n=>o.next(n)),_(()=>o.complete()),m(n=>$({ref:e},n)))})}var Ga=0;function Ja(e,t){document.body.append(e);let{width:r}=ce(e);e.style.setProperty("--md-tooltip-width",`${r}px`),e.remove();let o=cr(t),n=typeof o!="undefined"?Ne(o):I({x:0,y:0}),i=O(et(t),$t(t)).pipe(K());return z([i,n]).pipe(m(([a,s])=>{let{x:p,y:c}=Ve(t),l=ce(t),f=t.closest("table");return f&&t.parentElement&&(p+=f.offsetLeft+t.parentElement.offsetLeft,c+=f.offsetTop+t.parentElement.offsetTop),{active:a,offset:{x:p-s.x+l.width/2-r/2,y:c-s.y+l.height+8}}}))}function Qn(e){let t=e.title;if(!t.length)return S;let r=`__tooltip_${Ga++}`,o=Rt(r,"inline"),n=R(".md-typeset",o);return n.innerHTML=t,C(()=>{let i=new g;return i.subscribe({next({offset:a}){o.style.setProperty("--md-tooltip-x",`${a.x}px`),o.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){o.style.removeProperty("--md-tooltip-x"),o.style.removeProperty("--md-tooltip-y")}}),O(i.pipe(b(({active:a})=>a)),i.pipe(_e(250),b(({active:a})=>!a))).subscribe({next({active:a}){a?(e.insertAdjacentElement("afterend",o),e.setAttribute("aria-describedby",r),e.removeAttribute("title")):(o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t))},complete(){o.remove(),e.removeAttribute("aria-describedby"),e.setAttribute("title",t)}}),i.pipe(Me(16,me)).subscribe(({active:a})=>{o.classList.toggle("md-tooltip--active",a)}),i.pipe(pt(125,me),b(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?o.style.setProperty("--md-tooltip-0",`${-a}px`):o.style.removeProperty("--md-tooltip-0")},complete(){o.style.removeProperty("--md-tooltip-0")}}),Ja(o,e).pipe(w(a=>i.next(a)),_(()=>i.complete()),m(a=>$({ref:e},a)))}).pipe(Ke(se))}function Xa({viewport$:e}){if(!B("header.autohide"))return I(!1);let t=e.pipe(m(({offset:{y:n}})=>n),Be(2,1),m(([n,i])=>[n<i,i]),ee(0)),r=z([e,t]).pipe(b(([{offset:n},[,i]])=>Math.abs(i-n.y)>100),m(([,[n]])=>n),K()),o=ze("search");return z([e,o]).pipe(m(([{offset:n},i])=>n.y>400&&!i),K(),v(n=>n?r:I(!1)),Q(!1))}function Kn(e,t){return C(()=>z([ge(e),Xa(t)])).pipe(m(([{height:r},o])=>({height:r,hidden:o})),K((r,o)=>r.height===o.height&&r.hidden===o.hidden),G(1))}function Yn(e,{header$:t,main$:r}){return C(()=>{let o=new g,n=o.pipe(Z(),ie(!0));o.pipe(ee("active"),He(t)).subscribe(([{active:a},{hidden:s}])=>{e.classList.toggle("md-header--shadow",a&&!s),e.hidden=s});let i=ue(P("[title]",e)).pipe(b(()=>B("content.tooltips")),ne(a=>Qn(a)));return r.subscribe(o),t.pipe(W(n),m(a=>$({ref:e},a)),Re(i.pipe(W(n))))})}function Za(e,{viewport$:t,header$:r}){return mr(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:o}})=>{let{height:n}=ce(e);return{active:o>=n}}),ee("active"))}function Bn(e,t){return C(()=>{let r=new g;r.subscribe({next({active:n}){e.classList.toggle("md-header__title--active",n)},complete(){e.classList.remove("md-header__title--active")}});let o=fe(".md-content h1");return typeof o=="undefined"?S:Za(o,t).pipe(w(n=>r.next(n)),_(()=>r.complete()),m(n=>$({ref:e},n)))})}function Gn(e,{viewport$:t,header$:r}){let o=r.pipe(m(({height:i})=>i),K()),n=o.pipe(v(()=>ge(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),ee("bottom"))));return z([o,n,t]).pipe(m(([i,{top:a,bottom:s},{offset:{y:p},size:{height:c}}])=>(c=Math.max(0,c-Math.max(0,a-p,i)-Math.max(0,c+p-s)),{offset:a-i,height:c,active:a-i<=p})),K((i,a)=>i.offset===a.offset&&i.height===a.height&&i.active===a.active))}function es(e){let t=__md_get("__palette")||{index:e.findIndex(o=>matchMedia(o.getAttribute("data-md-color-media")).matches)},r=Math.max(0,Math.min(t.index,e.length-1));return I(...e).pipe(ne(o=>h(o,"change").pipe(m(()=>o))),Q(e[r]),m(o=>({index:e.indexOf(o),color:{media:o.getAttribute("data-md-color-media"),scheme:o.getAttribute("data-md-color-scheme"),primary:o.getAttribute("data-md-color-primary"),accent:o.getAttribute("data-md-color-accent")}})),G(1))}function Jn(e){let t=P("input",e),r=x("meta",{name:"theme-color"});document.head.appendChild(r);let o=x("meta",{name:"color-scheme"});document.head.appendChild(o);let n=Pt("(prefers-color-scheme: light)");return C(()=>{let i=new g;return i.subscribe(a=>{if(document.body.setAttribute("data-md-color-switching",""),a.color.media==="(prefers-color-scheme)"){let s=matchMedia("(prefers-color-scheme: light)"),p=document.querySelector(s.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");a.color.scheme=p.getAttribute("data-md-color-scheme"),a.color.primary=p.getAttribute("data-md-color-primary"),a.color.accent=p.getAttribute("data-md-color-accent")}for(let[s,p]of Object.entries(a.color))document.body.setAttribute(`data-md-color-${s}`,p);for(let s=0;s<t.length;s++){let p=t[s].nextElementSibling;p instanceof HTMLElement&&(p.hidden=a.index!==s)}__md_set("__palette",a)}),h(e,"keydown").pipe(b(a=>a.key==="Enter"),re(i,(a,s)=>s)).subscribe(({index:a})=>{a=(a+1)%t.length,t[a].click(),t[a].focus()}),i.pipe(m(()=>{let a=Se("header"),s=window.getComputedStyle(a);return o.content=s.colorScheme,s.backgroundColor.match(/\d+/g).map(p=>(+p).toString(16).padStart(2,"0")).join("")})).subscribe(a=>r.content=`#${a}`),i.pipe(ve(se)).subscribe(()=>{document.body.removeAttribute("data-md-color-switching")}),es(t).pipe(W(n.pipe(Ce(1))),ct(),w(a=>i.next(a)),_(()=>i.complete()),m(a=>$({ref:e},a)))})}function Xn(e,{progress$:t}){return C(()=>{let r=new g;return r.subscribe(({value:o})=>{e.style.setProperty("--md-progress-value",`${o}`)}),t.pipe(w(o=>r.next({value:o})),_(()=>r.complete()),m(o=>({ref:e,value:o})))})}var Jr=Mt(Br());function ts(e){e.setAttribute("data-md-copying","");let t=e.closest("[data-copy]"),r=t?t.getAttribute("data-copy"):e.innerText;return e.removeAttribute("data-md-copying"),r.trimEnd()}function Zn({alert$:e}){Jr.default.isSupported()&&new j(t=>{new Jr.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||ts(R(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(w(t=>{t.trigger.focus()}),m(()=>Ee("clipboard.copied"))).subscribe(e)}function ei(e,t){return e.protocol=t.protocol,e.hostname=t.hostname,e}function rs(e,t){let r=new Map;for(let o of P("url",e)){let n=R("loc",o),i=[ei(new URL(n.textContent),t)];r.set(`${i[0]}`,i);for(let a of P("[rel=alternate]",o)){let s=a.getAttribute("href");s!=null&&i.push(ei(new URL(s),t))}}return r}function ur(e){return un(new URL("sitemap.xml",e)).pipe(m(t=>rs(t,new URL(e))),de(()=>I(new Map)))}function os(e,t){if(!(e.target instanceof Element))return S;let r=e.target.closest("a");if(r===null)return S;if(r.target||e.metaKey||e.ctrlKey)return S;let o=new URL(r.href);return o.search=o.hash="",t.has(`${o}`)?(e.preventDefault(),I(new URL(r.href))):S}function ti(e){let t=new Map;for(let r of P(":scope > *",e.head))t.set(r.outerHTML,r);return t}function ri(e){for(let t of P("[href], [src]",e))for(let r of["href","src"]){let o=t.getAttribute(r);if(o&&!/^(?:[a-z]+:)?\/\//i.test(o)){t[r]=t[r];break}}return I(e)}function ns(e){for(let o of["[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...B("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let n=fe(o),i=fe(o,e);typeof n!="undefined"&&typeof i!="undefined"&&n.replaceWith(i)}let t=ti(document);for(let[o,n]of ti(e))t.has(o)?t.delete(o):document.head.appendChild(n);for(let o of t.values()){let n=o.getAttribute("name");n!=="theme-color"&&n!=="color-scheme"&&o.remove()}let r=Se("container");return We(P("script",r)).pipe(v(o=>{let n=e.createElement("script");if(o.src){for(let i of o.getAttributeNames())n.setAttribute(i,o.getAttribute(i));return o.replaceWith(n),new j(i=>{n.onload=()=>i.complete()})}else return n.textContent=o.textContent,o.replaceWith(n),S}),Z(),ie(document))}function oi({location$:e,viewport$:t,progress$:r}){let o=xe();if(location.protocol==="file:")return S;let n=ur(o.base);I(document).subscribe(ri);let i=h(document.body,"click").pipe(He(n),v(([p,c])=>os(p,c)),pe()),a=h(window,"popstate").pipe(m(ye),pe());i.pipe(re(t)).subscribe(([p,{offset:c}])=>{history.replaceState(c,""),history.pushState(null,"",p)}),O(i,a).subscribe(e);let s=e.pipe(ee("pathname"),v(p=>fn(p,{progress$:r}).pipe(de(()=>(lt(p,!0),S)))),v(ri),v(ns),pe());return O(s.pipe(re(e,(p,c)=>c)),s.pipe(v(()=>e),ee("pathname"),v(()=>e),ee("hash")),e.pipe(K((p,c)=>p.pathname===c.pathname&&p.hash===c.hash),v(()=>i),w(()=>history.back()))).subscribe(p=>{var c,l;history.state!==null||!p.hash?window.scrollTo(0,(l=(c=history.state)==null?void 0:c.y)!=null?l:0):(history.scrollRestoration="auto",pn(p.hash),history.scrollRestoration="manual")}),e.subscribe(()=>{history.scrollRestoration="manual"}),h(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}),t.pipe(ee("offset"),_e(100)).subscribe(({offset:p})=>{history.replaceState(p,"")}),s}var ni=Mt(qr());function ii(e){let t=e.separator.split("|").map(n=>n.replace(/(\(\?[!=<][^)]+\))/g,"").length===0?"\uFFFD":n).join("|"),r=new RegExp(t,"img"),o=(n,i,a)=>`${i}<mark data-md-highlight>${a}</mark>`;return n=>{n=n.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator}|)(${n.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return a=>(0,ni.default)(a).replace(i,o).replace(/<\/mark>(\s+)<mark[^>]*>/img,"$1")}}function jt(e){return e.type===1}function dr(e){return e.type===3}function ai(e,t){let r=yn(e);return O(I(location.protocol!=="file:"),ze("search")).pipe(Ae(o=>o),v(()=>t)).subscribe(({config:o,docs:n})=>r.next({type:0,data:{config:o,docs:n,options:{suggest:B("search.suggest")}}})),r}function si(e){var l;let{selectedVersionSitemap:t,selectedVersionBaseURL:r,currentLocation:o,currentBaseURL:n}=e,i=(l=Xr(n))==null?void 0:l.pathname;if(i===void 0)return;let a=ss(o.pathname,i);if(a===void 0)return;let s=ps(t.keys());if(!t.has(s))return;let p=Xr(a,s);if(!p||!t.has(p.href))return;let c=Xr(a,r);if(c)return c.hash=o.hash,c.search=o.search,c}function Xr(e,t){try{return new URL(e,t)}catch(r){return}}function ss(e,t){if(e.startsWith(t))return e.slice(t.length)}function cs(e,t){let r=Math.min(e.length,t.length),o;for(o=0;o<r&&e[o]===t[o];++o);return o}function ps(e){let t;for(let r of e)t===void 0?t=r:t=t.slice(0,cs(t,r));return t!=null?t:""}function ci({document$:e}){let t=xe(),r=je(new URL("../versions.json",t.base)).pipe(de(()=>S)),o=r.pipe(m(n=>{let[,i]=t.base.match(/([^/]+)\/?$/);return n.find(({version:a,aliases:s})=>a===i||s.includes(i))||n[0]}));r.pipe(m(n=>new Map(n.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),v(n=>h(document.body,"click").pipe(b(i=>!i.metaKey&&!i.ctrlKey),re(o),v(([i,a])=>{if(i.target instanceof Element){let s=i.target.closest("a");if(s&&!s.target&&n.has(s.href)){let p=s.href;return!i.target.closest(".md-version")&&n.get(p)===a?S:(i.preventDefault(),I(new URL(p)))}}return S}),v(i=>ur(i).pipe(m(a=>{var s;return(s=si({selectedVersionSitemap:a,selectedVersionBaseURL:i,currentLocation:ye(),currentBaseURL:t.base}))!=null?s:i})))))).subscribe(n=>lt(n,!0)),z([r,o]).subscribe(([n,i])=>{R(".md-header__topic").appendChild(Cn(n,i))}),e.pipe(v(()=>o)).subscribe(n=>{var a;let i=__md_get("__outdated",sessionStorage);if(i===null){i=!0;let s=((a=t.version)==null?void 0:a.default)||"latest";Array.isArray(s)||(s=[s]);e:for(let p of s)for(let c of n.aliases.concat(n.version))if(new RegExp(p,"i").test(c)){i=!1;break e}__md_set("__outdated",i,sessionStorage)}if(i)for(let s of ae("outdated"))s.hidden=!1})}function ls(e,{worker$:t}){let{searchParams:r}=ye();r.has("q")&&(Je("search",!0),e.value=r.get("q"),e.focus(),ze("search").pipe(Ae(i=>!i)).subscribe(()=>{let i=ye();i.searchParams.delete("q"),history.replaceState({},"",`${i}`)}));let o=et(e),n=O(t.pipe(Ae(jt)),h(e,"keyup"),o).pipe(m(()=>e.value),K());return z([n,o]).pipe(m(([i,a])=>({value:i,focus:a})),G(1))}function pi(e,{worker$:t}){let r=new g,o=r.pipe(Z(),ie(!0));z([t.pipe(Ae(jt)),r],(i,a)=>a).pipe(ee("value")).subscribe(({value:i})=>t.next({type:2,data:i})),r.pipe(ee("focus")).subscribe(({focus:i})=>{i&&Je("search",i)}),h(e.form,"reset").pipe(W(o)).subscribe(()=>e.focus());let n=R("header [for=__search]");return h(n,"click").subscribe(()=>e.focus()),ls(e,{worker$:t}).pipe(w(i=>r.next(i)),_(()=>r.complete()),m(i=>$({ref:e},i)),G(1))}function li(e,{worker$:t,query$:r}){let o=new g,n=on(e.parentElement).pipe(b(Boolean)),i=e.parentElement,a=R(":scope > :first-child",e),s=R(":scope > :last-child",e);ze("search").subscribe(l=>s.setAttribute("role",l?"list":"presentation")),o.pipe(re(r),Wr(t.pipe(Ae(jt)))).subscribe(([{items:l},{value:f}])=>{switch(l.length){case 0:a.textContent=f.length?Ee("search.result.none"):Ee("search.result.placeholder");break;case 1:a.textContent=Ee("search.result.one");break;default:let u=sr(l.length);a.textContent=Ee("search.result.other",u)}});let p=o.pipe(w(()=>s.innerHTML=""),v(({items:l})=>O(I(...l.slice(0,10)),I(...l.slice(10)).pipe(Be(4),Vr(n),v(([f])=>f)))),m(Mn),pe());return p.subscribe(l=>s.appendChild(l)),p.pipe(ne(l=>{let f=fe("details",l);return typeof f=="undefined"?S:h(f,"toggle").pipe(W(o),m(()=>f))})).subscribe(l=>{l.open===!1&&l.offsetTop<=i.scrollTop&&i.scrollTo({top:l.offsetTop})}),t.pipe(b(dr),m(({data:l})=>l)).pipe(w(l=>o.next(l)),_(()=>o.complete()),m(l=>$({ref:e},l)))}function ms(e,{query$:t}){return t.pipe(m(({value:r})=>{let o=ye();return o.hash="",r=r.replace(/\s+/g,"+").replace(/&/g,"%26").replace(/=/g,"%3D"),o.search=`q=${r}`,{url:o}}))}function mi(e,t){let r=new g,o=r.pipe(Z(),ie(!0));return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),h(e,"click").pipe(W(o)).subscribe(n=>n.preventDefault()),ms(e,t).pipe(w(n=>r.next(n)),_(()=>r.complete()),m(n=>$({ref:e},n)))}function fi(e,{worker$:t,keyboard$:r}){let o=new g,n=Se("search-query"),i=O(h(n,"keydown"),h(n,"focus")).pipe(ve(se),m(()=>n.value),K());return o.pipe(He(i),m(([{suggest:s},p])=>{let c=p.split(/([\s-]+)/);if(s!=null&&s.length&&c[c.length-1]){let l=s[s.length-1];l.startsWith(c[c.length-1])&&(c[c.length-1]=l)}else c.length=0;return c})).subscribe(s=>e.innerHTML=s.join("").replace(/\s/g,"&nbsp;")),r.pipe(b(({mode:s})=>s==="search")).subscribe(s=>{switch(s.type){case"ArrowRight":e.innerText.length&&n.selectionStart===n.value.length&&(n.value=e.innerText);break}}),t.pipe(b(dr),m(({data:s})=>s)).pipe(w(s=>o.next(s)),_(()=>o.complete()),m(()=>({ref:e})))}function ui(e,{index$:t,keyboard$:r}){let o=xe();try{let n=ai(o.search,t),i=Se("search-query",e),a=Se("search-result",e);h(e,"click").pipe(b(({target:p})=>p instanceof Element&&!!p.closest("a"))).subscribe(()=>Je("search",!1)),r.pipe(b(({mode:p})=>p==="search")).subscribe(p=>{let c=Ie();switch(p.type){case"Enter":if(c===i){let l=new Map;for(let f of P(":first-child [href]",a)){let u=f.firstElementChild;l.set(f,parseFloat(u.getAttribute("data-md-score")))}if(l.size){let[[f]]=[...l].sort(([,u],[,d])=>d-u);f.click()}p.claim()}break;case"Escape":case"Tab":Je("search",!1),i.blur();break;case"ArrowUp":case"ArrowDown":if(typeof c=="undefined")i.focus();else{let l=[i,...P(":not(details) > [href], summary, details[open] [href]",a)],f=Math.max(0,(Math.max(0,l.indexOf(c))+l.length+(p.type==="ArrowUp"?-1:1))%l.length);l[f].focus()}p.claim();break;default:i!==Ie()&&i.focus()}}),r.pipe(b(({mode:p})=>p==="global")).subscribe(p=>{switch(p.type){case"f":case"s":case"/":i.focus(),i.select(),p.claim();break}});let s=pi(i,{worker$:n});return O(s,li(a,{worker$:n,query$:s})).pipe(Re(...ae("search-share",e).map(p=>mi(p,{query$:s})),...ae("search-suggest",e).map(p=>fi(p,{worker$:n,keyboard$:r}))))}catch(n){return e.hidden=!0,Ye}}function di(e,{index$:t,location$:r}){return z([t,r.pipe(Q(ye()),b(o=>!!o.searchParams.get("h")))]).pipe(m(([o,n])=>ii(o.config)(n.searchParams.get("h"))),m(o=>{var a;let n=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let s=i.nextNode();s;s=i.nextNode())if((a=s.parentElement)!=null&&a.offsetHeight){let p=s.textContent,c=o(p);c.length>p.length&&n.set(s,c)}for(let[s,p]of n){let{childNodes:c}=x("span",null,p);s.replaceWith(...Array.from(c))}return{ref:e,nodes:n}}))}function fs(e,{viewport$:t,main$:r}){let o=e.closest(".md-grid"),n=o.offsetTop-o.parentElement.offsetTop;return z([r,t]).pipe(m(([{offset:i,height:a},{offset:{y:s}}])=>(a=a+Math.min(n,Math.max(0,s-i))-n,{height:a,locked:s>=i+n})),K((i,a)=>i.height===a.height&&i.locked===a.locked))}function Zr(e,o){var n=o,{header$:t}=n,r=so(n,["header$"]);let i=R(".md-sidebar__scrollwrap",e),{y:a}=Ve(i);return C(()=>{let s=new g,p=s.pipe(Z(),ie(!0)),c=s.pipe(Me(0,me));return c.pipe(re(t)).subscribe({next([{height:l},{height:f}]){i.style.height=`${l-2*a}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),c.pipe(Ae()).subscribe(()=>{for(let l of P(".md-nav__link--active[href]",e)){if(!l.clientHeight)continue;let f=l.closest(".md-sidebar__scrollwrap");if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=ce(f);f.scrollTo({top:u-d/2})}}}),ue(P("label[tabindex]",e)).pipe(ne(l=>h(l,"click").pipe(ve(se),m(()=>l),W(p)))).subscribe(l=>{let f=R(`[id="${l.htmlFor}"]`);R(`[aria-labelledby="${l.id}"]`).setAttribute("aria-expanded",`${f.checked}`)}),fs(e,r).pipe(w(l=>s.next(l)),_(()=>s.complete()),m(l=>$({ref:e},l)))})}function hi(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return st(je(`${r}/releases/latest`).pipe(de(()=>S),m(o=>({version:o.tag_name})),De({})),je(r).pipe(de(()=>S),m(o=>({stars:o.stargazers_count,forks:o.forks_count})),De({}))).pipe(m(([o,n])=>$($({},o),n)))}else{let r=`https://api.github.com/users/${e}`;return je(r).pipe(m(o=>({repositories:o.public_repos})),De({}))}}function bi(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return st(je(`${r}/releases/permalink/latest`).pipe(de(()=>S),m(({tag_name:o})=>({version:o})),De({})),je(r).pipe(de(()=>S),m(({star_count:o,forks_count:n})=>({stars:o,forks:n})),De({}))).pipe(m(([o,n])=>$($({},o),n)))}function vi(e){let t=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);if(t){let[,r,o]=t;return hi(r,o)}if(t=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i),t){let[,r,o]=t;return bi(r,o)}return S}var us;function ds(e){return us||(us=C(()=>{let t=__md_get("__source",sessionStorage);if(t)return I(t);if(ae("consent").length){let o=__md_get("__consent");if(!(o&&o.github))return S}return vi(e.href).pipe(w(o=>__md_set("__source",o,sessionStorage)))}).pipe(de(()=>S),b(t=>Object.keys(t).length>0),m(t=>({facts:t})),G(1)))}function gi(e){let t=R(":scope > :last-child",e);return C(()=>{let r=new g;return r.subscribe(({facts:o})=>{t.appendChild(_n(o)),t.classList.add("md-source__repository--active")}),ds(e).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))})}function hs(e,{viewport$:t,header$:r}){return ge(document.body).pipe(v(()=>mr(e,{header$:r,viewport$:t})),m(({offset:{y:o}})=>({hidden:o>=10})),ee("hidden"))}function yi(e,t){return C(()=>{let r=new g;return r.subscribe({next({hidden:o}){e.hidden=o},complete(){e.hidden=!1}}),(B("navigation.tabs.sticky")?I({hidden:!1}):hs(e,t)).pipe(w(o=>r.next(o)),_(()=>r.complete()),m(o=>$({ref:e},o)))})}function bs(e,{viewport$:t,header$:r}){let o=new Map,n=P(".md-nav__link",e);for(let s of n){let p=decodeURIComponent(s.hash.substring(1)),c=fe(`[id="${p}"]`);typeof c!="undefined"&&o.set(s,c)}let i=r.pipe(ee("height"),m(({height:s})=>{let p=Se("main"),c=R(":scope > :first-child",p);return s+.8*(c.offsetTop-p.offsetTop)}),pe());return ge(document.body).pipe(ee("height"),v(s=>C(()=>{let p=[];return I([...o].reduce((c,[l,f])=>{for(;p.length&&o.get(p[p.length-1]).tagName>=f.tagName;)p.pop();let u=f.offsetTop;for(;!u&&f.parentElement;)f=f.parentElement,u=f.offsetTop;let d=f.offsetParent;for(;d;d=d.offsetParent)u+=d.offsetTop;return c.set([...p=[...p,l]].reverse(),u)},new Map))}).pipe(m(p=>new Map([...p].sort(([,c],[,l])=>c-l))),He(i),v(([p,c])=>t.pipe(Fr(([l,f],{offset:{y:u},size:d})=>{let y=u+d.height>=Math.floor(s.height);for(;f.length;){let[,L]=f[0];if(L-c<u||y)l=[...l,f.shift()];else break}for(;l.length;){let[,L]=l[l.length-1];if(L-c>=u&&!y)f=[l.pop(),...f];else break}return[l,f]},[[],[...p]]),K((l,f)=>l[0]===f[0]&&l[1]===f[1])))))).pipe(m(([s,p])=>({prev:s.map(([c])=>c),next:p.map(([c])=>c)})),Q({prev:[],next:[]}),Be(2,1),m(([s,p])=>s.prev.length<p.prev.length?{prev:p.prev.slice(Math.max(0,s.prev.length-1),p.prev.length),next:[]}:{prev:p.prev.slice(-1),next:p.next.slice(0,p.next.length-s.next.length)}))}function xi(e,{viewport$:t,header$:r,main$:o,target$:n}){return C(()=>{let i=new g,a=i.pipe(Z(),ie(!0));if(i.subscribe(({prev:s,next:p})=>{for(let[c]of p)c.classList.remove("md-nav__link--passed"),c.classList.remove("md-nav__link--active");for(let[c,[l]]of s.entries())l.classList.add("md-nav__link--passed"),l.classList.toggle("md-nav__link--active",c===s.length-1)}),B("toc.follow")){let s=O(t.pipe(_e(1),m(()=>{})),t.pipe(_e(250),m(()=>"smooth")));i.pipe(b(({prev:p})=>p.length>0),He(o.pipe(ve(se))),re(s)).subscribe(([[{prev:p}],c])=>{let[l]=p[p.length-1];if(l.offsetHeight){let f=cr(l);if(typeof f!="undefined"){let u=l.offsetTop-f.offsetTop,{height:d}=ce(f);f.scrollTo({top:u-d/2,behavior:c})}}})}return B("navigation.tracking")&&t.pipe(W(a),ee("offset"),_e(250),Ce(1),W(n.pipe(Ce(1))),ct({delay:250}),re(i)).subscribe(([,{prev:s}])=>{let p=ye(),c=s[s.length-1];if(c&&c.length){let[l]=c,{hash:f}=new URL(l.href);p.hash!==f&&(p.hash=f,history.replaceState({},"",`${p}`))}else p.hash="",history.replaceState({},"",`${p}`)}),bs(e,{viewport$:t,header$:r}).pipe(w(s=>i.next(s)),_(()=>i.complete()),m(s=>$({ref:e},s)))})}function vs(e,{viewport$:t,main$:r,target$:o}){let n=t.pipe(m(({offset:{y:a}})=>a),Be(2,1),m(([a,s])=>a>s&&s>0),K()),i=r.pipe(m(({active:a})=>a));return z([i,n]).pipe(m(([a,s])=>!(a&&s)),K(),W(o.pipe(Ce(1))),ie(!0),ct({delay:250}),m(a=>({hidden:a})))}function Ei(e,{viewport$:t,header$:r,main$:o,target$:n}){let i=new g,a=i.pipe(Z(),ie(!0));return i.subscribe({next({hidden:s}){e.hidden=s,s?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(W(a),ee("height")).subscribe(({height:s})=>{e.style.top=`${s+16}px`}),h(e,"click").subscribe(s=>{s.preventDefault(),window.scrollTo({top:0})}),vs(e,{viewport$:t,main$:o,target$:n}).pipe(w(s=>i.next(s)),_(()=>i.complete()),m(s=>$({ref:e},s)))}function wi({document$:e,viewport$:t}){e.pipe(v(()=>P(".md-ellipsis")),ne(r=>tt(r).pipe(W(e.pipe(Ce(1))),b(o=>o),m(()=>r),Te(1))),b(r=>r.offsetWidth<r.scrollWidth),ne(r=>{let o=r.innerText,n=r.closest("a")||r;return n.title=o,B("content.tooltips")?mt(n,{viewport$:t}).pipe(W(e.pipe(Ce(1))),_(()=>n.removeAttribute("title"))):S})).subscribe(),B("content.tooltips")&&e.pipe(v(()=>P(".md-status")),ne(r=>mt(r,{viewport$:t}))).subscribe()}function Ti({document$:e,tablet$:t}){e.pipe(v(()=>P(".md-toggle--indeterminate")),w(r=>{r.indeterminate=!0,r.checked=!1}),ne(r=>h(r,"change").pipe(Dr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),re(t)).subscribe(([r,o])=>{r.classList.remove("md-toggle--indeterminate"),o&&(r.checked=!1)})}function gs(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function Si({document$:e}){e.pipe(v(()=>P("[data-md-scrollfix]")),w(t=>t.removeAttribute("data-md-scrollfix")),b(gs),ne(t=>h(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function Oi({viewport$:e,tablet$:t}){z([ze("search"),t]).pipe(m(([r,o])=>r&&!o),v(r=>I(r).pipe(Ge(r?400:100))),re(e)).subscribe(([r,{offset:{y:o}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${o}px`;else{let n=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",n&&window.scrollTo(0,n)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let o=e[r];typeof o=="string"?o=document.createTextNode(o):o.parentNode&&o.parentNode.removeChild(o),r?t.insertBefore(this.previousSibling,o):t.replaceChild(o,this)}}}));function ys(){return location.protocol==="file:"?Tt(`${new URL("search/search_index.js",eo.base)}`).pipe(m(()=>__index),G(1)):je(new URL("search/search_index.json",eo.base))}document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var ot=Go(),Ut=sn(),Lt=ln(Ut),to=an(),Oe=gn(),hr=Pt("(min-width: 960px)"),Mi=Pt("(min-width: 1220px)"),_i=mn(),eo=xe(),Ai=document.forms.namedItem("search")?ys():Ye,ro=new g;Zn({alert$:ro});var oo=new g;B("navigation.instant")&&oi({location$:Ut,viewport$:Oe,progress$:oo}).subscribe(ot);var Li;((Li=eo.version)==null?void 0:Li.provider)==="mike"&&ci({document$:ot});O(Ut,Lt).pipe(Ge(125)).subscribe(()=>{Je("drawer",!1),Je("search",!1)});to.pipe(b(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=fe("link[rel=prev]");typeof t!="undefined"&&lt(t);break;case"n":case".":let r=fe("link[rel=next]");typeof r!="undefined"&&lt(r);break;case"Enter":let o=Ie();o instanceof HTMLLabelElement&&o.click()}});wi({viewport$:Oe,document$:ot});Ti({document$:ot,tablet$:hr});Si({document$:ot});Oi({viewport$:Oe,tablet$:hr});var rt=Kn(Se("header"),{viewport$:Oe}),Ft=ot.pipe(m(()=>Se("main")),v(e=>Gn(e,{viewport$:Oe,header$:rt})),G(1)),xs=O(...ae("consent").map(e=>En(e,{target$:Lt})),...ae("dialog").map(e=>qn(e,{alert$:ro})),...ae("palette").map(e=>Jn(e)),...ae("progress").map(e=>Xn(e,{progress$:oo})),...ae("search").map(e=>ui(e,{index$:Ai,keyboard$:to})),...ae("source").map(e=>gi(e))),Es=C(()=>O(...ae("announce").map(e=>xn(e)),...ae("content").map(e=>zn(e,{viewport$:Oe,target$:Lt,print$:_i})),...ae("content").map(e=>B("search.highlight")?di(e,{index$:Ai,location$:Ut}):S),...ae("header").map(e=>Yn(e,{viewport$:Oe,header$:rt,main$:Ft})),...ae("header-title").map(e=>Bn(e,{viewport$:Oe,header$:rt})),...ae("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Nr(Mi,()=>Zr(e,{viewport$:Oe,header$:rt,main$:Ft})):Nr(hr,()=>Zr(e,{viewport$:Oe,header$:rt,main$:Ft}))),...ae("tabs").map(e=>yi(e,{viewport$:Oe,header$:rt})),...ae("toc").map(e=>xi(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Lt})),...ae("top").map(e=>Ei(e,{viewport$:Oe,header$:rt,main$:Ft,target$:Lt})))),Ci=ot.pipe(v(()=>Es),Re(xs),G(1));Ci.subscribe();window.document$=ot;window.location$=Ut;window.target$=Lt;window.keyboard$=to;window.viewport$=Oe;window.tablet$=hr;window.screen$=Mi;window.print$=_i;window.alert$=ro;window.progress$=oo;window.component$=Ci;})();
+//# sourceMappingURL=bundle.83f73b43.min.js.map
+
diff --git a/latest/assets/javascripts/bundle.83f73b43.min.js.map b/latest/assets/javascripts/bundle.83f73b43.min.js.map
new file mode 100644
index 000000000..fe920b7d6
--- /dev/null
+++ b/latest/assets/javascripts/bundle.83f73b43.min.js.map
@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["node_modules/focus-visible/dist/focus-visible.js", "node_modules/escape-html/index.js", "node_modules/clipboard/dist/clipboard.js", "src/templates/assets/javascripts/bundle.ts", "node_modules/tslib/tslib.es6.mjs", "node_modules/rxjs/src/internal/util/isFunction.ts", "node_modules/rxjs/src/internal/util/createErrorClass.ts", "node_modules/rxjs/src/internal/util/UnsubscriptionError.ts", "node_modules/rxjs/src/internal/util/arrRemove.ts", "node_modules/rxjs/src/internal/Subscription.ts", "node_modules/rxjs/src/internal/config.ts", "node_modules/rxjs/src/internal/scheduler/timeoutProvider.ts", "node_modules/rxjs/src/internal/util/reportUnhandledError.ts", "node_modules/rxjs/src/internal/util/noop.ts", "node_modules/rxjs/src/internal/NotificationFactories.ts", "node_modules/rxjs/src/internal/util/errorContext.ts", "node_modules/rxjs/src/internal/Subscriber.ts", "node_modules/rxjs/src/internal/symbol/observable.ts", "node_modules/rxjs/src/internal/util/identity.ts", "node_modules/rxjs/src/internal/util/pipe.ts", "node_modules/rxjs/src/internal/Observable.ts", "node_modules/rxjs/src/internal/util/lift.ts", "node_modules/rxjs/src/internal/operators/OperatorSubscriber.ts", "node_modules/rxjs/src/internal/scheduler/animationFrameProvider.ts", "node_modules/rxjs/src/internal/util/ObjectUnsubscribedError.ts", "node_modules/rxjs/src/internal/Subject.ts", "node_modules/rxjs/src/internal/BehaviorSubject.ts", "node_modules/rxjs/src/internal/scheduler/dateTimestampProvider.ts", "node_modules/rxjs/src/internal/ReplaySubject.ts", "node_modules/rxjs/src/internal/scheduler/Action.ts", "node_modules/rxjs/src/internal/scheduler/intervalProvider.ts", "node_modules/rxjs/src/internal/scheduler/AsyncAction.ts", "node_modules/rxjs/src/internal/Scheduler.ts", "node_modules/rxjs/src/internal/scheduler/AsyncScheduler.ts", "node_modules/rxjs/src/internal/scheduler/async.ts", "node_modules/rxjs/src/internal/scheduler/QueueAction.ts", "node_modules/rxjs/src/internal/scheduler/QueueScheduler.ts", "node_modules/rxjs/src/internal/scheduler/queue.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameAction.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameScheduler.ts", "node_modules/rxjs/src/internal/scheduler/animationFrame.ts", "node_modules/rxjs/src/internal/observable/empty.ts", "node_modules/rxjs/src/internal/util/isScheduler.ts", "node_modules/rxjs/src/internal/util/args.ts", "node_modules/rxjs/src/internal/util/isArrayLike.ts", "node_modules/rxjs/src/internal/util/isPromise.ts", "node_modules/rxjs/src/internal/util/isInteropObservable.ts", "node_modules/rxjs/src/internal/util/isAsyncIterable.ts", "node_modules/rxjs/src/internal/util/throwUnobservableError.ts", "node_modules/rxjs/src/internal/symbol/iterator.ts", "node_modules/rxjs/src/internal/util/isIterable.ts", "node_modules/rxjs/src/internal/util/isReadableStreamLike.ts", "node_modules/rxjs/src/internal/observable/innerFrom.ts", "node_modules/rxjs/src/internal/util/executeSchedule.ts", "node_modules/rxjs/src/internal/operators/observeOn.ts", "node_modules/rxjs/src/internal/operators/subscribeOn.ts", "node_modules/rxjs/src/internal/scheduled/scheduleObservable.ts", "node_modules/rxjs/src/internal/scheduled/schedulePromise.ts", "node_modules/rxjs/src/internal/scheduled/scheduleArray.ts", "node_modules/rxjs/src/internal/scheduled/scheduleIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleAsyncIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleReadableStreamLike.ts", "node_modules/rxjs/src/internal/scheduled/scheduled.ts", "node_modules/rxjs/src/internal/observable/from.ts", "node_modules/rxjs/src/internal/observable/of.ts", "node_modules/rxjs/src/internal/observable/throwError.ts", "node_modules/rxjs/src/internal/util/EmptyError.ts", "node_modules/rxjs/src/internal/util/isDate.ts", "node_modules/rxjs/src/internal/operators/map.ts", "node_modules/rxjs/src/internal/util/mapOneOrManyArgs.ts", "node_modules/rxjs/src/internal/util/argsArgArrayOrObject.ts", "node_modules/rxjs/src/internal/util/createObject.ts", "node_modules/rxjs/src/internal/observable/combineLatest.ts", "node_modules/rxjs/src/internal/operators/mergeInternals.ts", "node_modules/rxjs/src/internal/operators/mergeMap.ts", "node_modules/rxjs/src/internal/operators/mergeAll.ts", "node_modules/rxjs/src/internal/operators/concatAll.ts", "node_modules/rxjs/src/internal/observable/concat.ts", "node_modules/rxjs/src/internal/observable/defer.ts", "node_modules/rxjs/src/internal/observable/fromEvent.ts", "node_modules/rxjs/src/internal/observable/fromEventPattern.ts", "node_modules/rxjs/src/internal/observable/timer.ts", "node_modules/rxjs/src/internal/observable/merge.ts", "node_modules/rxjs/src/internal/observable/never.ts", "node_modules/rxjs/src/internal/util/argsOrArgArray.ts", "node_modules/rxjs/src/internal/operators/filter.ts", "node_modules/rxjs/src/internal/observable/zip.ts", "node_modules/rxjs/src/internal/operators/audit.ts", "node_modules/rxjs/src/internal/operators/auditTime.ts", "node_modules/rxjs/src/internal/operators/bufferCount.ts", "node_modules/rxjs/src/internal/operators/catchError.ts", "node_modules/rxjs/src/internal/operators/scanInternals.ts", "node_modules/rxjs/src/internal/operators/combineLatest.ts", "node_modules/rxjs/src/internal/operators/combineLatestWith.ts", "node_modules/rxjs/src/internal/operators/debounce.ts", "node_modules/rxjs/src/internal/operators/debounceTime.ts", "node_modules/rxjs/src/internal/operators/defaultIfEmpty.ts", "node_modules/rxjs/src/internal/operators/take.ts", "node_modules/rxjs/src/internal/operators/ignoreElements.ts", "node_modules/rxjs/src/internal/operators/mapTo.ts", "node_modules/rxjs/src/internal/operators/delayWhen.ts", "node_modules/rxjs/src/internal/operators/delay.ts", "node_modules/rxjs/src/internal/operators/distinctUntilChanged.ts", "node_modules/rxjs/src/internal/operators/distinctUntilKeyChanged.ts", "node_modules/rxjs/src/internal/operators/throwIfEmpty.ts", "node_modules/rxjs/src/internal/operators/endWith.ts", "node_modules/rxjs/src/internal/operators/finalize.ts", "node_modules/rxjs/src/internal/operators/first.ts", "node_modules/rxjs/src/internal/operators/takeLast.ts", "node_modules/rxjs/src/internal/operators/merge.ts", "node_modules/rxjs/src/internal/operators/mergeWith.ts", "node_modules/rxjs/src/internal/operators/repeat.ts", "node_modules/rxjs/src/internal/operators/scan.ts", "node_modules/rxjs/src/internal/operators/share.ts", "node_modules/rxjs/src/internal/operators/shareReplay.ts", "node_modules/rxjs/src/internal/operators/skip.ts", "node_modules/rxjs/src/internal/operators/skipUntil.ts", "node_modules/rxjs/src/internal/operators/startWith.ts", "node_modules/rxjs/src/internal/operators/switchMap.ts", "node_modules/rxjs/src/internal/operators/takeUntil.ts", "node_modules/rxjs/src/internal/operators/takeWhile.ts", "node_modules/rxjs/src/internal/operators/tap.ts", "node_modules/rxjs/src/internal/operators/throttle.ts", "node_modules/rxjs/src/internal/operators/throttleTime.ts", "node_modules/rxjs/src/internal/operators/withLatestFrom.ts", "node_modules/rxjs/src/internal/operators/zip.ts", "node_modules/rxjs/src/internal/operators/zipWith.ts", "src/templates/assets/javascripts/browser/document/index.ts", "src/templates/assets/javascripts/browser/element/_/index.ts", "src/templates/assets/javascripts/browser/element/focus/index.ts", "src/templates/assets/javascripts/browser/element/hover/index.ts", "src/templates/assets/javascripts/utilities/h/index.ts", "src/templates/assets/javascripts/utilities/round/index.ts", "src/templates/assets/javascripts/browser/script/index.ts", "src/templates/assets/javascripts/browser/element/size/_/index.ts", "src/templates/assets/javascripts/browser/element/size/content/index.ts", "src/templates/assets/javascripts/browser/element/offset/_/index.ts", "src/templates/assets/javascripts/browser/element/offset/content/index.ts", "src/templates/assets/javascripts/browser/element/visibility/index.ts", "src/templates/assets/javascripts/browser/toggle/index.ts", "src/templates/assets/javascripts/browser/keyboard/index.ts", "src/templates/assets/javascripts/browser/location/_/index.ts", "src/templates/assets/javascripts/browser/location/hash/index.ts", "src/templates/assets/javascripts/browser/media/index.ts", "src/templates/assets/javascripts/browser/request/index.ts", "src/templates/assets/javascripts/browser/viewport/offset/index.ts", "src/templates/assets/javascripts/browser/viewport/size/index.ts", "src/templates/assets/javascripts/browser/viewport/_/index.ts", "src/templates/assets/javascripts/browser/viewport/at/index.ts", "src/templates/assets/javascripts/browser/worker/index.ts", "src/templates/assets/javascripts/_/index.ts", "src/templates/assets/javascripts/components/_/index.ts", "src/templates/assets/javascripts/components/announce/index.ts", "src/templates/assets/javascripts/components/consent/index.ts", "src/templates/assets/javascripts/templates/tooltip/index.tsx", "src/templates/assets/javascripts/templates/annotation/index.tsx", "src/templates/assets/javascripts/templates/clipboard/index.tsx", "src/templates/assets/javascripts/templates/search/index.tsx", "src/templates/assets/javascripts/templates/source/index.tsx", "src/templates/assets/javascripts/templates/tabbed/index.tsx", "src/templates/assets/javascripts/templates/table/index.tsx", "src/templates/assets/javascripts/templates/version/index.tsx", "src/templates/assets/javascripts/components/tooltip2/index.ts", "src/templates/assets/javascripts/components/content/annotation/_/index.ts", "src/templates/assets/javascripts/components/content/annotation/list/index.ts", "src/templates/assets/javascripts/components/content/annotation/block/index.ts", "src/templates/assets/javascripts/components/content/code/_/index.ts", "src/templates/assets/javascripts/components/content/details/index.ts", "src/templates/assets/javascripts/components/content/mermaid/index.css", "src/templates/assets/javascripts/components/content/mermaid/index.ts", "src/templates/assets/javascripts/components/content/table/index.ts", "src/templates/assets/javascripts/components/content/tabs/index.ts", "src/templates/assets/javascripts/components/content/_/index.ts", "src/templates/assets/javascripts/components/dialog/index.ts", "src/templates/assets/javascripts/components/tooltip/index.ts", "src/templates/assets/javascripts/components/header/_/index.ts", "src/templates/assets/javascripts/components/header/title/index.ts", "src/templates/assets/javascripts/components/main/index.ts", "src/templates/assets/javascripts/components/palette/index.ts", "src/templates/assets/javascripts/components/progress/index.ts", "src/templates/assets/javascripts/integrations/clipboard/index.ts", "src/templates/assets/javascripts/integrations/sitemap/index.ts", "src/templates/assets/javascripts/integrations/instant/index.ts", "src/templates/assets/javascripts/integrations/search/highlighter/index.ts", "src/templates/assets/javascripts/integrations/search/worker/message/index.ts", "src/templates/assets/javascripts/integrations/search/worker/_/index.ts", "src/templates/assets/javascripts/integrations/version/findurl/index.ts", "src/templates/assets/javascripts/integrations/version/index.ts", "src/templates/assets/javascripts/components/search/query/index.ts", "src/templates/assets/javascripts/components/search/result/index.ts", "src/templates/assets/javascripts/components/search/share/index.ts", "src/templates/assets/javascripts/components/search/suggest/index.ts", "src/templates/assets/javascripts/components/search/_/index.ts", "src/templates/assets/javascripts/components/search/highlight/index.ts", "src/templates/assets/javascripts/components/sidebar/index.ts", "src/templates/assets/javascripts/components/source/facts/github/index.ts", "src/templates/assets/javascripts/components/source/facts/gitlab/index.ts", "src/templates/assets/javascripts/components/source/facts/_/index.ts", "src/templates/assets/javascripts/components/source/_/index.ts", "src/templates/assets/javascripts/components/tabs/index.ts", "src/templates/assets/javascripts/components/toc/index.ts", "src/templates/assets/javascripts/components/top/index.ts", "src/templates/assets/javascripts/patches/ellipsis/index.ts", "src/templates/assets/javascripts/patches/indeterminate/index.ts", "src/templates/assets/javascripts/patches/scrollfix/index.ts", "src/templates/assets/javascripts/patches/scrolllock/index.ts", "src/templates/assets/javascripts/polyfills/index.ts"],
+  "sourcesContent": ["(function (global, factory) {\n  typeof exports === 'object' && typeof module !== 'undefined' ? factory() :\n  typeof define === 'function' && define.amd ? define(factory) :\n  (factory());\n}(this, (function () { 'use strict';\n\n  /**\n   * Applies the :focus-visible polyfill at the given scope.\n   * A scope in this case is either the top-level Document or a Shadow Root.\n   *\n   * @param {(Document|ShadowRoot)} scope\n   * @see https://github.com/WICG/focus-visible\n   */\n  function applyFocusVisiblePolyfill(scope) {\n    var hadKeyboardEvent = true;\n    var hadFocusVisibleRecently = false;\n    var hadFocusVisibleRecentlyTimeout = null;\n\n    var inputTypesAllowlist = {\n      text: true,\n      search: true,\n      url: true,\n      tel: true,\n      email: true,\n      password: true,\n      number: true,\n      date: true,\n      month: true,\n      week: true,\n      time: true,\n      datetime: true,\n      'datetime-local': true\n    };\n\n    /**\n     * Helper function for legacy browsers and iframes which sometimes focus\n     * elements like document, body, and non-interactive SVG.\n     * @param {Element} el\n     */\n    function isValidFocusTarget(el) {\n      if (\n        el &&\n        el !== document &&\n        el.nodeName !== 'HTML' &&\n        el.nodeName !== 'BODY' &&\n        'classList' in el &&\n        'contains' in el.classList\n      ) {\n        return true;\n      }\n      return false;\n    }\n\n    /**\n     * Computes whether the given element should automatically trigger the\n     * `focus-visible` class being added, i.e. whether it should always match\n     * `:focus-visible` when focused.\n     * @param {Element} el\n     * @return {boolean}\n     */\n    function focusTriggersKeyboardModality(el) {\n      var type = el.type;\n      var tagName = el.tagName;\n\n      if (tagName === 'INPUT' && inputTypesAllowlist[type] && !el.readOnly) {\n        return true;\n      }\n\n      if (tagName === 'TEXTAREA' && !el.readOnly) {\n        return true;\n      }\n\n      if (el.isContentEditable) {\n        return true;\n      }\n\n      return false;\n    }\n\n    /**\n     * Add the `focus-visible` class to the given element if it was not added by\n     * the author.\n     * @param {Element} el\n     */\n    function addFocusVisibleClass(el) {\n      if (el.classList.contains('focus-visible')) {\n        return;\n      }\n      el.classList.add('focus-visible');\n      el.setAttribute('data-focus-visible-added', '');\n    }\n\n    /**\n     * Remove the `focus-visible` class from the given element if it was not\n     * originally added by the author.\n     * @param {Element} el\n     */\n    function removeFocusVisibleClass(el) {\n      if (!el.hasAttribute('data-focus-visible-added')) {\n        return;\n      }\n      el.classList.remove('focus-visible');\n      el.removeAttribute('data-focus-visible-added');\n    }\n\n    /**\n     * If the most recent user interaction was via the keyboard;\n     * and the key press did not include a meta, alt/option, or control key;\n     * then the modality is keyboard. Otherwise, the modality is not keyboard.\n     * Apply `focus-visible` to any current active element and keep track\n     * of our keyboard modality state with `hadKeyboardEvent`.\n     * @param {KeyboardEvent} e\n     */\n    function onKeyDown(e) {\n      if (e.metaKey || e.altKey || e.ctrlKey) {\n        return;\n      }\n\n      if (isValidFocusTarget(scope.activeElement)) {\n        addFocusVisibleClass(scope.activeElement);\n      }\n\n      hadKeyboardEvent = true;\n    }\n\n    /**\n     * If at any point a user clicks with a pointing device, ensure that we change\n     * the modality away from keyboard.\n     * This avoids the situation where a user presses a key on an already focused\n     * element, and then clicks on a different element, focusing it with a\n     * pointing device, while we still think we're in keyboard modality.\n     * @param {Event} e\n     */\n    function onPointerDown(e) {\n      hadKeyboardEvent = false;\n    }\n\n    /**\n     * On `focus`, add the `focus-visible` class to the target if:\n     * - the target received focus as a result of keyboard navigation, or\n     * - the event target is an element that will likely require interaction\n     *   via the keyboard (e.g. a text box)\n     * @param {Event} e\n     */\n    function onFocus(e) {\n      // Prevent IE from focusing the document or HTML element.\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (hadKeyboardEvent || focusTriggersKeyboardModality(e.target)) {\n        addFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * On `blur`, remove the `focus-visible` class from the target.\n     * @param {Event} e\n     */\n    function onBlur(e) {\n      if (!isValidFocusTarget(e.target)) {\n        return;\n      }\n\n      if (\n        e.target.classList.contains('focus-visible') ||\n        e.target.hasAttribute('data-focus-visible-added')\n      ) {\n        // To detect a tab/window switch, we look for a blur event followed\n        // rapidly by a visibility change.\n        // If we don't see a visibility change within 100ms, it's probably a\n        // regular focus change.\n        hadFocusVisibleRecently = true;\n        window.clearTimeout(hadFocusVisibleRecentlyTimeout);\n        hadFocusVisibleRecentlyTimeout = window.setTimeout(function() {\n          hadFocusVisibleRecently = false;\n        }, 100);\n        removeFocusVisibleClass(e.target);\n      }\n    }\n\n    /**\n     * If the user changes tabs, keep track of whether or not the previously\n     * focused element had .focus-visible.\n     * @param {Event} e\n     */\n    function onVisibilityChange(e) {\n      if (document.visibilityState === 'hidden') {\n        // If the tab becomes active again, the browser will handle calling focus\n        // on the element (Safari actually calls it twice).\n        // If this tab change caused a blur on an element with focus-visible,\n        // re-apply the class when the user switches back to the tab.\n        if (hadFocusVisibleRecently) {\n          hadKeyboardEvent = true;\n        }\n        addInitialPointerMoveListeners();\n      }\n    }\n\n    /**\n     * Add a group of listeners to detect usage of any pointing devices.\n     * These listeners will be added when the polyfill first loads, and anytime\n     * the window is blurred, so that they are active when the window regains\n     * focus.\n     */\n    function addInitialPointerMoveListeners() {\n      document.addEventListener('mousemove', onInitialPointerMove);\n      document.addEventListener('mousedown', onInitialPointerMove);\n      document.addEventListener('mouseup', onInitialPointerMove);\n      document.addEventListener('pointermove', onInitialPointerMove);\n      document.addEventListener('pointerdown', onInitialPointerMove);\n      document.addEventListener('pointerup', onInitialPointerMove);\n      document.addEventListener('touchmove', onInitialPointerMove);\n      document.addEventListener('touchstart', onInitialPointerMove);\n      document.addEventListener('touchend', onInitialPointerMove);\n    }\n\n    function removeInitialPointerMoveListeners() {\n      document.removeEventListener('mousemove', onInitialPointerMove);\n      document.removeEventListener('mousedown', onInitialPointerMove);\n      document.removeEventListener('mouseup', onInitialPointerMove);\n      document.removeEventListener('pointermove', onInitialPointerMove);\n      document.removeEventListener('pointerdown', onInitialPointerMove);\n      document.removeEventListener('pointerup', onInitialPointerMove);\n      document.removeEventListener('touchmove', onInitialPointerMove);\n      document.removeEventListener('touchstart', onInitialPointerMove);\n      document.removeEventListener('touchend', onInitialPointerMove);\n    }\n\n    /**\n     * When the polfyill first loads, assume the user is in keyboard modality.\n     * If any event is received from a pointing device (e.g. mouse, pointer,\n     * touch), turn off keyboard modality.\n     * This accounts for situations where focus enters the page from the URL bar.\n     * @param {Event} e\n     */\n    function onInitialPointerMove(e) {\n      // Work around a Safari quirk that fires a mousemove on <html> whenever the\n      // window blurs, even if you're tabbing out of the page. \u00AF\\_(\u30C4)_/\u00AF\n      if (e.target.nodeName && e.target.nodeName.toLowerCase() === 'html') {\n        return;\n      }\n\n      hadKeyboardEvent = false;\n      removeInitialPointerMoveListeners();\n    }\n\n    // For some kinds of state, we are interested in changes at the global scope\n    // only. For example, global pointer input, global key presses and global\n    // visibility change should affect the state at every scope:\n    document.addEventListener('keydown', onKeyDown, true);\n    document.addEventListener('mousedown', onPointerDown, true);\n    document.addEventListener('pointerdown', onPointerDown, true);\n    document.addEventListener('touchstart', onPointerDown, true);\n    document.addEventListener('visibilitychange', onVisibilityChange, true);\n\n    addInitialPointerMoveListeners();\n\n    // For focus and blur, we specifically care about state changes in the local\n    // scope. This is because focus / blur events that originate from within a\n    // shadow root are not re-dispatched from the host element if it was already\n    // the active element in its own scope:\n    scope.addEventListener('focus', onFocus, true);\n    scope.addEventListener('blur', onBlur, true);\n\n    // We detect that a node is a ShadowRoot by ensuring that it is a\n    // DocumentFragment and also has a host property. This check covers native\n    // implementation and polyfill implementation transparently. If we only cared\n    // about the native implementation, we could just check if the scope was\n    // an instance of a ShadowRoot.\n    if (scope.nodeType === Node.DOCUMENT_FRAGMENT_NODE && scope.host) {\n      // Since a ShadowRoot is a special kind of DocumentFragment, it does not\n      // have a root element to add a class to. So, we add this attribute to the\n      // host element instead:\n      scope.host.setAttribute('data-js-focus-visible', '');\n    } else if (scope.nodeType === Node.DOCUMENT_NODE) {\n      document.documentElement.classList.add('js-focus-visible');\n      document.documentElement.setAttribute('data-js-focus-visible', '');\n    }\n  }\n\n  // It is important to wrap all references to global window and document in\n  // these checks to support server-side rendering use cases\n  // @see https://github.com/WICG/focus-visible/issues/199\n  if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n    // Make the polyfill helper globally available. This can be used as a signal\n    // to interested libraries that wish to coordinate with the polyfill for e.g.,\n    // applying the polyfill to a shadow root:\n    window.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;\n\n    // Notify interested libraries of the polyfill's presence, in case the\n    // polyfill was loaded lazily:\n    var event;\n\n    try {\n      event = new CustomEvent('focus-visible-polyfill-ready');\n    } catch (error) {\n      // IE11 does not support using CustomEvent as a constructor directly:\n      event = document.createEvent('CustomEvent');\n      event.initCustomEvent('focus-visible-polyfill-ready', false, false, {});\n    }\n\n    window.dispatchEvent(event);\n  }\n\n  if (typeof document !== 'undefined') {\n    // Apply the polyfill to the global document, so that no JavaScript\n    // coordination is required to use the polyfill in the top-level document:\n    applyFocusVisiblePolyfill(document);\n  }\n\n})));\n", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param  {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n  var str = '' + string;\n  var match = matchHtmlRegExp.exec(str);\n\n  if (!match) {\n    return str;\n  }\n\n  var escape;\n  var html = '';\n  var index = 0;\n  var lastIndex = 0;\n\n  for (index = match.index; index < str.length; index++) {\n    switch (str.charCodeAt(index)) {\n      case 34: // \"\n        escape = '&quot;';\n        break;\n      case 38: // &\n        escape = '&amp;';\n        break;\n      case 39: // '\n        escape = '&#39;';\n        break;\n      case 60: // <\n        escape = '&lt;';\n        break;\n      case 62: // >\n        escape = '&gt;';\n        break;\n      default:\n        continue;\n    }\n\n    if (lastIndex !== index) {\n      html += str.substring(lastIndex, index);\n    }\n\n    lastIndex = index + 1;\n    html += escape;\n  }\n\n  return lastIndex !== index\n    ? html + str.substring(lastIndex, index)\n    : html;\n}\n", "/*!\n * clipboard.js v2.0.11\n * https://clipboardjs.com/\n *\n * Licensed MIT \u00A9 Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function() { // webpackBootstrap\n/******/ \tvar __webpack_modules__ = ({\n\n/***/ 686:\n/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n\n// EXPORTS\n__webpack_require__.d(__webpack_exports__, {\n  \"default\": function() { return /* binding */ clipboard; }\n});\n\n// EXTERNAL MODULE: ./node_modules/tiny-emitter/index.js\nvar tiny_emitter = __webpack_require__(279);\nvar tiny_emitter_default = /*#__PURE__*/__webpack_require__.n(tiny_emitter);\n// EXTERNAL MODULE: ./node_modules/good-listener/src/listen.js\nvar listen = __webpack_require__(370);\nvar listen_default = /*#__PURE__*/__webpack_require__.n(listen);\n// EXTERNAL MODULE: ./node_modules/select/src/select.js\nvar src_select = __webpack_require__(817);\nvar select_default = /*#__PURE__*/__webpack_require__.n(src_select);\n;// CONCATENATED MODULE: ./src/common/command.js\n/**\n * Executes a given operation type.\n * @param {String} type\n * @return {Boolean}\n */\nfunction command(type) {\n  try {\n    return document.execCommand(type);\n  } catch (err) {\n    return false;\n  }\n}\n;// CONCATENATED MODULE: ./src/actions/cut.js\n\n\n/**\n * Cut action wrapper.\n * @param {String|HTMLElement} target\n * @return {String}\n */\n\nvar ClipboardActionCut = function ClipboardActionCut(target) {\n  var selectedText = select_default()(target);\n  command('cut');\n  return selectedText;\n};\n\n/* harmony default export */ var actions_cut = (ClipboardActionCut);\n;// CONCATENATED MODULE: ./src/common/create-fake-element.js\n/**\n * Creates a fake textarea element with a value.\n * @param {String} value\n * @return {HTMLElement}\n */\nfunction createFakeElement(value) {\n  var isRTL = document.documentElement.getAttribute('dir') === 'rtl';\n  var fakeElement = document.createElement('textarea'); // Prevent zooming on iOS\n\n  fakeElement.style.fontSize = '12pt'; // Reset box model\n\n  fakeElement.style.border = '0';\n  fakeElement.style.padding = '0';\n  fakeElement.style.margin = '0'; // Move element out of screen horizontally\n\n  fakeElement.style.position = 'absolute';\n  fakeElement.style[isRTL ? 'right' : 'left'] = '-9999px'; // Move element to the same position vertically\n\n  var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n  fakeElement.style.top = \"\".concat(yPosition, \"px\");\n  fakeElement.setAttribute('readonly', '');\n  fakeElement.value = value;\n  return fakeElement;\n}\n;// CONCATENATED MODULE: ./src/actions/copy.js\n\n\n\n/**\n * Create fake copy action wrapper using a fake element.\n * @param {String} target\n * @param {Object} options\n * @return {String}\n */\n\nvar fakeCopyAction = function fakeCopyAction(value, options) {\n  var fakeElement = createFakeElement(value);\n  options.container.appendChild(fakeElement);\n  var selectedText = select_default()(fakeElement);\n  command('copy');\n  fakeElement.remove();\n  return selectedText;\n};\n/**\n * Copy action wrapper.\n * @param {String|HTMLElement} target\n * @param {Object} options\n * @return {String}\n */\n\n\nvar ClipboardActionCopy = function ClipboardActionCopy(target) {\n  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n    container: document.body\n  };\n  var selectedText = '';\n\n  if (typeof target === 'string') {\n    selectedText = fakeCopyAction(target, options);\n  } else if (target instanceof HTMLInputElement && !['text', 'search', 'url', 'tel', 'password'].includes(target === null || target === void 0 ? void 0 : target.type)) {\n    // If input type doesn't support `setSelectionRange`. Simulate it. https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setSelectionRange\n    selectedText = fakeCopyAction(target.value, options);\n  } else {\n    selectedText = select_default()(target);\n    command('copy');\n  }\n\n  return selectedText;\n};\n\n/* harmony default export */ var actions_copy = (ClipboardActionCopy);\n;// CONCATENATED MODULE: ./src/actions/default.js\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return _typeof(obj); }\n\n\n\n/**\n * Inner function which performs selection from either `text` or `target`\n * properties and then executes copy or cut operations.\n * @param {Object} options\n */\n\nvar ClipboardActionDefault = function ClipboardActionDefault() {\n  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n  // Defines base properties passed from constructor.\n  var _options$action = options.action,\n      action = _options$action === void 0 ? 'copy' : _options$action,\n      container = options.container,\n      target = options.target,\n      text = options.text; // Sets the `action` to be performed which can be either 'copy' or 'cut'.\n\n  if (action !== 'copy' && action !== 'cut') {\n    throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n  } // Sets the `target` property using an element that will be have its content copied.\n\n\n  if (target !== undefined) {\n    if (target && _typeof(target) === 'object' && target.nodeType === 1) {\n      if (action === 'copy' && target.hasAttribute('disabled')) {\n        throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n      }\n\n      if (action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n        throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n      }\n    } else {\n      throw new Error('Invalid \"target\" value, use a valid Element');\n    }\n  } // Define selection strategy based on `text` property.\n\n\n  if (text) {\n    return actions_copy(text, {\n      container: container\n    });\n  } // Defines which selection strategy based on `target` property.\n\n\n  if (target) {\n    return action === 'cut' ? actions_cut(target) : actions_copy(target, {\n      container: container\n    });\n  }\n};\n\n/* harmony default export */ var actions_default = (ClipboardActionDefault);\n;// CONCATENATED MODULE: ./src/clipboard.js\nfunction clipboard_typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { clipboard_typeof = function _typeof(obj) { return typeof obj; }; } else { clipboard_typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return clipboard_typeof(obj); }\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }\n\nfunction _inherits(subClass, superClass) { if (typeof superClass !== \"function\" && superClass !== null) { throw new TypeError(\"Super expression must either be null or a function\"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }\n\nfunction _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }\n\nfunction _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }\n\nfunction _possibleConstructorReturn(self, call) { if (call && (clipboard_typeof(call) === \"object\" || typeof call === \"function\")) { return call; } return _assertThisInitialized(self); }\n\nfunction _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\"); } return self; }\n\nfunction _isNativeReflectConstruct() { if (typeof Reflect === \"undefined\" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === \"function\") return true; try { Date.prototype.toString.call(Reflect.construct(Date, [], function () {})); return true; } catch (e) { return false; } }\n\nfunction _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }\n\n\n\n\n\n\n/**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n\nfunction getAttributeValue(suffix, element) {\n  var attribute = \"data-clipboard-\".concat(suffix);\n\n  if (!element.hasAttribute(attribute)) {\n    return;\n  }\n\n  return element.getAttribute(attribute);\n}\n/**\n * Base class which takes one or more elements, adds event listeners to them,\n * and instantiates a new `ClipboardAction` on each click.\n */\n\n\nvar Clipboard = /*#__PURE__*/function (_Emitter) {\n  _inherits(Clipboard, _Emitter);\n\n  var _super = _createSuper(Clipboard);\n\n  /**\n   * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n   * @param {Object} options\n   */\n  function Clipboard(trigger, options) {\n    var _this;\n\n    _classCallCheck(this, Clipboard);\n\n    _this = _super.call(this);\n\n    _this.resolveOptions(options);\n\n    _this.listenClick(trigger);\n\n    return _this;\n  }\n  /**\n   * Defines if attributes would be resolved using internal setter functions\n   * or custom functions that were passed in the constructor.\n   * @param {Object} options\n   */\n\n\n  _createClass(Clipboard, [{\n    key: \"resolveOptions\",\n    value: function resolveOptions() {\n      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n      this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n      this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n      this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n      this.container = clipboard_typeof(options.container) === 'object' ? options.container : document.body;\n    }\n    /**\n     * Adds a click event listener to the passed trigger.\n     * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n     */\n\n  }, {\n    key: \"listenClick\",\n    value: function listenClick(trigger) {\n      var _this2 = this;\n\n      this.listener = listen_default()(trigger, 'click', function (e) {\n        return _this2.onClick(e);\n      });\n    }\n    /**\n     * Defines a new `ClipboardAction` on each click event.\n     * @param {Event} e\n     */\n\n  }, {\n    key: \"onClick\",\n    value: function onClick(e) {\n      var trigger = e.delegateTarget || e.currentTarget;\n      var action = this.action(trigger) || 'copy';\n      var text = actions_default({\n        action: action,\n        container: this.container,\n        target: this.target(trigger),\n        text: this.text(trigger)\n      }); // Fires an event based on the copy operation result.\n\n      this.emit(text ? 'success' : 'error', {\n        action: action,\n        text: text,\n        trigger: trigger,\n        clearSelection: function clearSelection() {\n          if (trigger) {\n            trigger.focus();\n          }\n\n          window.getSelection().removeAllRanges();\n        }\n      });\n    }\n    /**\n     * Default `action` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultAction\",\n    value: function defaultAction(trigger) {\n      return getAttributeValue('action', trigger);\n    }\n    /**\n     * Default `target` lookup function.\n     * @param {Element} trigger\n     */\n\n  }, {\n    key: \"defaultTarget\",\n    value: function defaultTarget(trigger) {\n      var selector = getAttributeValue('target', trigger);\n\n      if (selector) {\n        return document.querySelector(selector);\n      }\n    }\n    /**\n     * Allow fire programmatically a copy action\n     * @param {String|HTMLElement} target\n     * @param {Object} options\n     * @returns Text copied.\n     */\n\n  }, {\n    key: \"defaultText\",\n\n    /**\n     * Default `text` lookup function.\n     * @param {Element} trigger\n     */\n    value: function defaultText(trigger) {\n      return getAttributeValue('text', trigger);\n    }\n    /**\n     * Destroy lifecycle.\n     */\n\n  }, {\n    key: \"destroy\",\n    value: function destroy() {\n      this.listener.destroy();\n    }\n  }], [{\n    key: \"copy\",\n    value: function copy(target) {\n      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n        container: document.body\n      };\n      return actions_copy(target, options);\n    }\n    /**\n     * Allow fire programmatically a cut action\n     * @param {String|HTMLElement} target\n     * @returns Text cutted.\n     */\n\n  }, {\n    key: \"cut\",\n    value: function cut(target) {\n      return actions_cut(target);\n    }\n    /**\n     * Returns the support of the given action, or all actions if no action is\n     * given.\n     * @param {String} [action]\n     */\n\n  }, {\n    key: \"isSupported\",\n    value: function isSupported() {\n      var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n      var actions = typeof action === 'string' ? [action] : action;\n      var support = !!document.queryCommandSupported;\n      actions.forEach(function (action) {\n        support = support && !!document.queryCommandSupported(action);\n      });\n      return support;\n    }\n  }]);\n\n  return Clipboard;\n}((tiny_emitter_default()));\n\n/* harmony default export */ var clipboard = (Clipboard);\n\n/***/ }),\n\n/***/ 828:\n/***/ (function(module) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n    var proto = Element.prototype;\n\n    proto.matches = proto.matchesSelector ||\n                    proto.mozMatchesSelector ||\n                    proto.msMatchesSelector ||\n                    proto.oMatchesSelector ||\n                    proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n    while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n        if (typeof element.matches === 'function' &&\n            element.matches(selector)) {\n          return element;\n        }\n        element = element.parentNode;\n    }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n\n/***/ 438:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar closest = __webpack_require__(828);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n    var listenerFn = listener.apply(this, arguments);\n\n    element.addEventListener(type, listenerFn, useCapture);\n\n    return {\n        destroy: function() {\n            element.removeEventListener(type, listenerFn, useCapture);\n        }\n    }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n    // Handle the regular Element usage\n    if (typeof elements.addEventListener === 'function') {\n        return _delegate.apply(null, arguments);\n    }\n\n    // Handle Element-less usage, it defaults to global delegation\n    if (typeof type === 'function') {\n        // Use `document` as the first parameter, then apply arguments\n        // This is a short way to .unshift `arguments` without running into deoptimizations\n        return _delegate.bind(null, document).apply(null, arguments);\n    }\n\n    // Handle Selector-based usage\n    if (typeof elements === 'string') {\n        elements = document.querySelectorAll(elements);\n    }\n\n    // Handle Array-like based usage\n    return Array.prototype.map.call(elements, function (element) {\n        return _delegate(element, selector, type, callback, useCapture);\n    });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n    return function(e) {\n        e.delegateTarget = closest(e.target, selector);\n\n        if (e.delegateTarget) {\n            callback.call(element, e);\n        }\n    }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n\n/***/ 879:\n/***/ (function(__unused_webpack_module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n    return value !== undefined\n        && value instanceof HTMLElement\n        && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return value !== undefined\n        && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n        && ('length' in value)\n        && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n    return typeof value === 'string'\n        || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n    var type = Object.prototype.toString.call(value);\n\n    return type === '[object Function]';\n};\n\n\n/***/ }),\n\n/***/ 370:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar is = __webpack_require__(879);\nvar delegate = __webpack_require__(438);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n    if (!target && !type && !callback) {\n        throw new Error('Missing required arguments');\n    }\n\n    if (!is.string(type)) {\n        throw new TypeError('Second argument must be a String');\n    }\n\n    if (!is.fn(callback)) {\n        throw new TypeError('Third argument must be a Function');\n    }\n\n    if (is.node(target)) {\n        return listenNode(target, type, callback);\n    }\n    else if (is.nodeList(target)) {\n        return listenNodeList(target, type, callback);\n    }\n    else if (is.string(target)) {\n        return listenSelector(target, type, callback);\n    }\n    else {\n        throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n    }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n    node.addEventListener(type, callback);\n\n    return {\n        destroy: function() {\n            node.removeEventListener(type, callback);\n        }\n    }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n    Array.prototype.forEach.call(nodeList, function(node) {\n        node.addEventListener(type, callback);\n    });\n\n    return {\n        destroy: function() {\n            Array.prototype.forEach.call(nodeList, function(node) {\n                node.removeEventListener(type, callback);\n            });\n        }\n    }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n    return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n\n/***/ 817:\n/***/ (function(module) {\n\nfunction select(element) {\n    var selectedText;\n\n    if (element.nodeName === 'SELECT') {\n        element.focus();\n\n        selectedText = element.value;\n    }\n    else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n        var isReadOnly = element.hasAttribute('readonly');\n\n        if (!isReadOnly) {\n            element.setAttribute('readonly', '');\n        }\n\n        element.select();\n        element.setSelectionRange(0, element.value.length);\n\n        if (!isReadOnly) {\n            element.removeAttribute('readonly');\n        }\n\n        selectedText = element.value;\n    }\n    else {\n        if (element.hasAttribute('contenteditable')) {\n            element.focus();\n        }\n\n        var selection = window.getSelection();\n        var range = document.createRange();\n\n        range.selectNodeContents(element);\n        selection.removeAllRanges();\n        selection.addRange(range);\n\n        selectedText = selection.toString();\n    }\n\n    return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ }),\n\n/***/ 279:\n/***/ (function(module) {\n\nfunction E () {\n  // Keep this empty so it's easier to inherit from\n  // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n  on: function (name, callback, ctx) {\n    var e = this.e || (this.e = {});\n\n    (e[name] || (e[name] = [])).push({\n      fn: callback,\n      ctx: ctx\n    });\n\n    return this;\n  },\n\n  once: function (name, callback, ctx) {\n    var self = this;\n    function listener () {\n      self.off(name, listener);\n      callback.apply(ctx, arguments);\n    };\n\n    listener._ = callback\n    return this.on(name, listener, ctx);\n  },\n\n  emit: function (name) {\n    var data = [].slice.call(arguments, 1);\n    var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n    var i = 0;\n    var len = evtArr.length;\n\n    for (i; i < len; i++) {\n      evtArr[i].fn.apply(evtArr[i].ctx, data);\n    }\n\n    return this;\n  },\n\n  off: function (name, callback) {\n    var e = this.e || (this.e = {});\n    var evts = e[name];\n    var liveEvents = [];\n\n    if (evts && callback) {\n      for (var i = 0, len = evts.length; i < len; i++) {\n        if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n          liveEvents.push(evts[i]);\n      }\n    }\n\n    // Remove event from queue to prevent memory leak\n    // Suggested by https://github.com/lazd\n    // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n    (liveEvents.length)\n      ? e[name] = liveEvents\n      : delete e[name];\n\n    return this;\n  }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n\n\n/***/ })\n\n/******/ \t});\n/************************************************************************/\n/******/ \t// The module cache\n/******/ \tvar __webpack_module_cache__ = {};\n/******/ \t\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(__webpack_module_cache__[moduleId]) {\n/******/ \t\t\treturn __webpack_module_cache__[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = __webpack_module_cache__[moduleId] = {\n/******/ \t\t\t// no module.id needed\n/******/ \t\t\t// no module.loaded needed\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/ \t\n/******/ \t\t// Execute the module function\n/******/ \t\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n/******/ \t\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/ \t\n/************************************************************************/\n/******/ \t/* webpack/runtime/compat get default export */\n/******/ \t!function() {\n/******/ \t\t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t\t__webpack_require__.n = function(module) {\n/******/ \t\t\tvar getter = module && module.__esModule ?\n/******/ \t\t\t\tfunction() { return module['default']; } :\n/******/ \t\t\t\tfunction() { return module; };\n/******/ \t\t\t__webpack_require__.d(getter, { a: getter });\n/******/ \t\t\treturn getter;\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/define property getters */\n/******/ \t!function() {\n/******/ \t\t// define getter functions for harmony exports\n/******/ \t\t__webpack_require__.d = function(exports, definition) {\n/******/ \t\t\tfor(var key in definition) {\n/******/ \t\t\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n/******/ \t\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n/******/ \t\t\t\t}\n/******/ \t\t\t}\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/hasOwnProperty shorthand */\n/******/ \t!function() {\n/******/ \t\t__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }\n/******/ \t}();\n/******/ \t\n/************************************************************************/\n/******/ \t// module exports must be returned from runtime so entry inlining is disabled\n/******/ \t// startup\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(686);\n/******/ })()\n.default;\n});", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport \"focus-visible\"\n\nimport {\n  EMPTY,\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  delay,\n  filter,\n  map,\n  merge,\n  mergeWith,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"./_\"\nimport {\n  at,\n  getActiveElement,\n  getOptionalElement,\n  requestJSON,\n  setLocation,\n  setToggle,\n  watchDocument,\n  watchKeyboard,\n  watchLocation,\n  watchLocationTarget,\n  watchMedia,\n  watchPrint,\n  watchScript,\n  watchViewport\n} from \"./browser\"\nimport {\n  getComponentElement,\n  getComponentElements,\n  mountAnnounce,\n  mountBackToTop,\n  mountConsent,\n  mountContent,\n  mountDialog,\n  mountHeader,\n  mountHeaderTitle,\n  mountPalette,\n  mountProgress,\n  mountSearch,\n  mountSearchHiglight,\n  mountSidebar,\n  mountSource,\n  mountTableOfContents,\n  mountTabs,\n  watchHeader,\n  watchMain\n} from \"./components\"\nimport {\n  SearchIndex,\n  setupClipboardJS,\n  setupInstantNavigation,\n  setupVersionSelector\n} from \"./integrations\"\nimport {\n  patchEllipsis,\n  patchIndeterminate,\n  patchScrollfix,\n  patchScrolllock\n} from \"./patches\"\nimport \"./polyfills\"\n\n/* ----------------------------------------------------------------------------\n * Functions - @todo refactor\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch search index\n *\n * @returns Search index observable\n */\nfunction fetchSearchIndex(): Observable<SearchIndex> {\n  if (location.protocol === \"file:\") {\n    return watchScript(\n      `${new URL(\"search/search_index.js\", config.base)}`\n    )\n      .pipe(\n        // @ts-ignore - @todo fix typings\n        map(() => __index),\n        shareReplay(1)\n      )\n  } else {\n    return requestJSON<SearchIndex>(\n      new URL(\"search/search_index.json\", config.base)\n    )\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Application\n * ------------------------------------------------------------------------- */\n\n/* Yay, JavaScript is available */\ndocument.documentElement.classList.remove(\"no-js\")\ndocument.documentElement.classList.add(\"js\")\n\n/* Set up navigation observables and subjects */\nconst document$ = watchDocument()\nconst location$ = watchLocation()\nconst target$   = watchLocationTarget(location$)\nconst keyboard$ = watchKeyboard()\n\n/* Set up media observables */\nconst viewport$ = watchViewport()\nconst tablet$   = watchMedia(\"(min-width: 960px)\")\nconst screen$   = watchMedia(\"(min-width: 1220px)\")\nconst print$    = watchPrint()\n\n/* Retrieve search index, if search is enabled */\nconst config = configuration()\nconst index$ = document.forms.namedItem(\"search\")\n  ? fetchSearchIndex()\n  : NEVER\n\n/* Set up Clipboard.js integration */\nconst alert$ = new Subject<string>()\nsetupClipboardJS({ alert$ })\n\n/* Set up progress indicator */\nconst progress$ = new Subject<number>()\n\n/* Set up instant navigation, if enabled */\nif (feature(\"navigation.instant\"))\n  setupInstantNavigation({ location$, viewport$, progress$ })\n    .subscribe(document$)\n\n/* Set up version selector */\nif (config.version?.provider === \"mike\")\n  setupVersionSelector({ document$ })\n\n/* Always close drawer and search on navigation */\nmerge(location$, target$)\n  .pipe(\n    delay(125)\n  )\n    .subscribe(() => {\n      setToggle(\"drawer\", false)\n      setToggle(\"search\", false)\n    })\n\n/* Set up global keyboard handlers */\nkeyboard$\n  .pipe(\n    filter(({ mode }) => mode === \"global\")\n  )\n    .subscribe(key => {\n      switch (key.type) {\n\n        /* Go to previous page */\n        case \"p\":\n        case \",\":\n          const prev = getOptionalElement<HTMLLinkElement>(\"link[rel=prev]\")\n          if (typeof prev !== \"undefined\")\n            setLocation(prev)\n          break\n\n        /* Go to next page */\n        case \"n\":\n        case \".\":\n          const next = getOptionalElement<HTMLLinkElement>(\"link[rel=next]\")\n          if (typeof next !== \"undefined\")\n            setLocation(next)\n          break\n\n        /* Expand navigation, see https://bit.ly/3ZjG5io */\n        case \"Enter\":\n          const active = getActiveElement()\n          if (active instanceof HTMLLabelElement)\n            active.click()\n      }\n    })\n\n/* Set up patches */\npatchEllipsis({ viewport$, document$ })\npatchIndeterminate({ document$, tablet$ })\npatchScrollfix({ document$ })\npatchScrolllock({ viewport$, tablet$ })\n\n/* Set up header and main area observable */\nconst header$ = watchHeader(getComponentElement(\"header\"), { viewport$ })\nconst main$ = document$\n  .pipe(\n    map(() => getComponentElement(\"main\")),\n    switchMap(el => watchMain(el, { viewport$, header$ })),\n    shareReplay(1)\n  )\n\n/* Set up control component observables */\nconst control$ = merge(\n\n  /* Consent */\n  ...getComponentElements(\"consent\")\n    .map(el => mountConsent(el, { target$ })),\n\n  /* Dialog */\n  ...getComponentElements(\"dialog\")\n    .map(el => mountDialog(el, { alert$ })),\n\n  /* Color palette */\n  ...getComponentElements(\"palette\")\n    .map(el => mountPalette(el)),\n\n  /* Progress bar */\n  ...getComponentElements(\"progress\")\n    .map(el => mountProgress(el, { progress$ })),\n\n  /* Search */\n  ...getComponentElements(\"search\")\n    .map(el => mountSearch(el, { index$, keyboard$ })),\n\n  /* Repository information */\n  ...getComponentElements(\"source\")\n    .map(el => mountSource(el))\n)\n\n/* Set up content component observables */\nconst content$ = defer(() => merge(\n\n  /* Announcement bar */\n  ...getComponentElements(\"announce\")\n    .map(el => mountAnnounce(el)),\n\n  /* Content */\n  ...getComponentElements(\"content\")\n    .map(el => mountContent(el, { viewport$, target$, print$ })),\n\n  /* Search highlighting */\n  ...getComponentElements(\"content\")\n    .map(el => feature(\"search.highlight\")\n      ? mountSearchHiglight(el, { index$, location$ })\n      : EMPTY\n    ),\n\n  /* Header */\n  ...getComponentElements(\"header\")\n    .map(el => mountHeader(el, { viewport$, header$, main$ })),\n\n  /* Header title */\n  ...getComponentElements(\"header-title\")\n    .map(el => mountHeaderTitle(el, { viewport$, header$ })),\n\n  /* Sidebar */\n  ...getComponentElements(\"sidebar\")\n    .map(el => el.getAttribute(\"data-md-type\") === \"navigation\"\n      ? at(screen$, () => mountSidebar(el, { viewport$, header$, main$ }))\n      : at(tablet$, () => mountSidebar(el, { viewport$, header$, main$ }))\n    ),\n\n  /* Navigation tabs */\n  ...getComponentElements(\"tabs\")\n    .map(el => mountTabs(el, { viewport$, header$ })),\n\n  /* Table of contents */\n  ...getComponentElements(\"toc\")\n    .map(el => mountTableOfContents(el, {\n      viewport$, header$, main$, target$\n    })),\n\n  /* Back-to-top button */\n  ...getComponentElements(\"top\")\n    .map(el => mountBackToTop(el, { viewport$, header$, main$, target$ }))\n))\n\n/* Set up component observables */\nconst component$ = document$\n  .pipe(\n    switchMap(() => content$),\n    mergeWith(control$),\n    shareReplay(1)\n  )\n\n/* Subscribe to all components */\ncomponent$.subscribe()\n\n/* ----------------------------------------------------------------------------\n * Exports\n * ------------------------------------------------------------------------- */\n\nwindow.document$  = document$          /* Document observable */\nwindow.location$  = location$          /* Location subject */\nwindow.target$    = target$            /* Location target observable */\nwindow.keyboard$  = keyboard$          /* Keyboard observable */\nwindow.viewport$  = viewport$          /* Viewport observable */\nwindow.tablet$    = tablet$            /* Media tablet observable */\nwindow.screen$    = screen$            /* Media screen observable */\nwindow.print$     = print$             /* Media print observable */\nwindow.alert$     = alert$             /* Alert subject */\nwindow.progress$  = progress$          /* Progress indicator subject */\nwindow.component$ = component$         /* Component observable */\n", "/******************************************************************************\nCopyright (c) Microsoft Corporation.\n\nPermission to use, copy, modify, and/or distribute this software for any\npurpose with or without fee is hereby granted.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\nPERFORMANCE OF THIS SOFTWARE.\n***************************************************************************** */\n/* global Reflect, Promise, SuppressedError, Symbol, Iterator */\n\nvar extendStatics = function(d, b) {\n  extendStatics = Object.setPrototypeOf ||\n      ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\n      function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\n  return extendStatics(d, b);\n};\n\nexport function __extends(d, b) {\n  if (typeof b !== \"function\" && b !== null)\n      throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\n  extendStatics(d, b);\n  function __() { this.constructor = d; }\n  d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\n}\n\nexport var __assign = function() {\n  __assign = Object.assign || function __assign(t) {\n      for (var s, i = 1, n = arguments.length; i < n; i++) {\n          s = arguments[i];\n          for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\n      }\n      return t;\n  }\n  return __assign.apply(this, arguments);\n}\n\nexport function __rest(s, e) {\n  var t = {};\n  for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\n      t[p] = s[p];\n  if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\n      for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\n          if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\n              t[p[i]] = s[p[i]];\n      }\n  return t;\n}\n\nexport function __decorate(decorators, target, key, desc) {\n  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\n  if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\n  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\n  return c > 3 && r && Object.defineProperty(target, key, r), r;\n}\n\nexport function __param(paramIndex, decorator) {\n  return function (target, key) { decorator(target, key, paramIndex); }\n}\n\nexport function __esDecorate(ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {\n  function accept(f) { if (f !== void 0 && typeof f !== \"function\") throw new TypeError(\"Function expected\"); return f; }\n  var kind = contextIn.kind, key = kind === \"getter\" ? \"get\" : kind === \"setter\" ? \"set\" : \"value\";\n  var target = !descriptorIn && ctor ? contextIn[\"static\"] ? ctor : ctor.prototype : null;\n  var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});\n  var _, done = false;\n  for (var i = decorators.length - 1; i >= 0; i--) {\n      var context = {};\n      for (var p in contextIn) context[p] = p === \"access\" ? {} : contextIn[p];\n      for (var p in contextIn.access) context.access[p] = contextIn.access[p];\n      context.addInitializer = function (f) { if (done) throw new TypeError(\"Cannot add initializers after decoration has completed\"); extraInitializers.push(accept(f || null)); };\n      var result = (0, decorators[i])(kind === \"accessor\" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);\n      if (kind === \"accessor\") {\n          if (result === void 0) continue;\n          if (result === null || typeof result !== \"object\") throw new TypeError(\"Object expected\");\n          if (_ = accept(result.get)) descriptor.get = _;\n          if (_ = accept(result.set)) descriptor.set = _;\n          if (_ = accept(result.init)) initializers.unshift(_);\n      }\n      else if (_ = accept(result)) {\n          if (kind === \"field\") initializers.unshift(_);\n          else descriptor[key] = _;\n      }\n  }\n  if (target) Object.defineProperty(target, contextIn.name, descriptor);\n  done = true;\n};\n\nexport function __runInitializers(thisArg, initializers, value) {\n  var useValue = arguments.length > 2;\n  for (var i = 0; i < initializers.length; i++) {\n      value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);\n  }\n  return useValue ? value : void 0;\n};\n\nexport function __propKey(x) {\n  return typeof x === \"symbol\" ? x : \"\".concat(x);\n};\n\nexport function __setFunctionName(f, name, prefix) {\n  if (typeof name === \"symbol\") name = name.description ? \"[\".concat(name.description, \"]\") : \"\";\n  return Object.defineProperty(f, \"name\", { configurable: true, value: prefix ? \"\".concat(prefix, \" \", name) : name });\n};\n\nexport function __metadata(metadataKey, metadataValue) {\n  if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\n}\n\nexport function __awaiter(thisArg, _arguments, P, generator) {\n  function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\n  return new (P || (P = Promise))(function (resolve, reject) {\n      function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\n      function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\n      function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\n      step((generator = generator.apply(thisArg, _arguments || [])).next());\n  });\n}\n\nexport function __generator(thisArg, body) {\n  var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === \"function\" ? Iterator : Object).prototype);\n  return g.next = verb(0), g[\"throw\"] = verb(1), g[\"return\"] = verb(2), typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\n  function verb(n) { return function (v) { return step([n, v]); }; }\n  function step(op) {\n      if (f) throw new TypeError(\"Generator is already executing.\");\n      while (g && (g = 0, op[0] && (_ = 0)), _) try {\n          if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\n          if (y = 0, t) op = [op[0] & 2, t.value];\n          switch (op[0]) {\n              case 0: case 1: t = op; break;\n              case 4: _.label++; return { value: op[1], done: false };\n              case 5: _.label++; y = op[1]; op = [0]; continue;\n              case 7: op = _.ops.pop(); _.trys.pop(); continue;\n              default:\n                  if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\n                  if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\n                  if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\n                  if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\n                  if (t[2]) _.ops.pop();\n                  _.trys.pop(); continue;\n          }\n          op = body.call(thisArg, _);\n      } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\n      if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\n  }\n}\n\nexport var __createBinding = Object.create ? (function(o, m, k, k2) {\n  if (k2 === undefined) k2 = k;\n  var desc = Object.getOwnPropertyDescriptor(m, k);\n  if (!desc || (\"get\" in desc ? !m.__esModule : desc.writable || desc.configurable)) {\n      desc = { enumerable: true, get: function() { return m[k]; } };\n  }\n  Object.defineProperty(o, k2, desc);\n}) : (function(o, m, k, k2) {\n  if (k2 === undefined) k2 = k;\n  o[k2] = m[k];\n});\n\nexport function __exportStar(m, o) {\n  for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\n}\n\nexport function __values(o) {\n  var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\n  if (m) return m.call(o);\n  if (o && typeof o.length === \"number\") return {\n      next: function () {\n          if (o && i >= o.length) o = void 0;\n          return { value: o && o[i++], done: !o };\n      }\n  };\n  throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\n}\n\nexport function __read(o, n) {\n  var m = typeof Symbol === \"function\" && o[Symbol.iterator];\n  if (!m) return o;\n  var i = m.call(o), r, ar = [], e;\n  try {\n      while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\n  }\n  catch (error) { e = { error: error }; }\n  finally {\n      try {\n          if (r && !r.done && (m = i[\"return\"])) m.call(i);\n      }\n      finally { if (e) throw e.error; }\n  }\n  return ar;\n}\n\n/** @deprecated */\nexport function __spread() {\n  for (var ar = [], i = 0; i < arguments.length; i++)\n      ar = ar.concat(__read(arguments[i]));\n  return ar;\n}\n\n/** @deprecated */\nexport function __spreadArrays() {\n  for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\n  for (var r = Array(s), k = 0, i = 0; i < il; i++)\n      for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\n          r[k] = a[j];\n  return r;\n}\n\nexport function __spreadArray(to, from, pack) {\n  if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\n      if (ar || !(i in from)) {\n          if (!ar) ar = Array.prototype.slice.call(from, 0, i);\n          ar[i] = from[i];\n      }\n  }\n  return to.concat(ar || Array.prototype.slice.call(from));\n}\n\nexport function __await(v) {\n  return this instanceof __await ? (this.v = v, this) : new __await(v);\n}\n\nexport function __asyncGenerator(thisArg, _arguments, generator) {\n  if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\n  var g = generator.apply(thisArg, _arguments || []), i, q = [];\n  return i = Object.create((typeof AsyncIterator === \"function\" ? AsyncIterator : Object).prototype), verb(\"next\"), verb(\"throw\"), verb(\"return\", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;\n  function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }\n  function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }\n  function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\n  function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\n  function fulfill(value) { resume(\"next\", value); }\n  function reject(value) { resume(\"throw\", value); }\n  function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\n}\n\nexport function __asyncDelegator(o) {\n  var i, p;\n  return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\n  function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v; } : f; }\n}\n\nexport function __asyncValues(o) {\n  if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\n  var m = o[Symbol.asyncIterator], i;\n  return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\n  function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\n  function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\n}\n\nexport function __makeTemplateObject(cooked, raw) {\n  if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\n  return cooked;\n};\n\nvar __setModuleDefault = Object.create ? (function(o, v) {\n  Object.defineProperty(o, \"default\", { enumerable: true, value: v });\n}) : function(o, v) {\n  o[\"default\"] = v;\n};\n\nexport function __importStar(mod) {\n  if (mod && mod.__esModule) return mod;\n  var result = {};\n  if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\n  __setModuleDefault(result, mod);\n  return result;\n}\n\nexport function __importDefault(mod) {\n  return (mod && mod.__esModule) ? mod : { default: mod };\n}\n\nexport function __classPrivateFieldGet(receiver, state, kind, f) {\n  if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\n  if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\n  return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\n}\n\nexport function __classPrivateFieldSet(receiver, state, value, kind, f) {\n  if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\n  if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\n  if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\n  return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\n}\n\nexport function __classPrivateFieldIn(state, receiver) {\n  if (receiver === null || (typeof receiver !== \"object\" && typeof receiver !== \"function\")) throw new TypeError(\"Cannot use 'in' operator on non-object\");\n  return typeof state === \"function\" ? receiver === state : state.has(receiver);\n}\n\nexport function __addDisposableResource(env, value, async) {\n  if (value !== null && value !== void 0) {\n    if (typeof value !== \"object\" && typeof value !== \"function\") throw new TypeError(\"Object expected.\");\n    var dispose, inner;\n    if (async) {\n      if (!Symbol.asyncDispose) throw new TypeError(\"Symbol.asyncDispose is not defined.\");\n      dispose = value[Symbol.asyncDispose];\n    }\n    if (dispose === void 0) {\n      if (!Symbol.dispose) throw new TypeError(\"Symbol.dispose is not defined.\");\n      dispose = value[Symbol.dispose];\n      if (async) inner = dispose;\n    }\n    if (typeof dispose !== \"function\") throw new TypeError(\"Object not disposable.\");\n    if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };\n    env.stack.push({ value: value, dispose: dispose, async: async });\n  }\n  else if (async) {\n    env.stack.push({ async: true });\n  }\n  return value;\n}\n\nvar _SuppressedError = typeof SuppressedError === \"function\" ? SuppressedError : function (error, suppressed, message) {\n  var e = new Error(message);\n  return e.name = \"SuppressedError\", e.error = error, e.suppressed = suppressed, e;\n};\n\nexport function __disposeResources(env) {\n  function fail(e) {\n    env.error = env.hasError ? new _SuppressedError(e, env.error, \"An error was suppressed during disposal.\") : e;\n    env.hasError = true;\n  }\n  var r, s = 0;\n  function next() {\n    while (r = env.stack.pop()) {\n      try {\n        if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);\n        if (r.dispose) {\n          var result = r.dispose.call(r.value);\n          if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });\n        }\n        else s |= 1;\n      }\n      catch (e) {\n        fail(e);\n      }\n    }\n    if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();\n    if (env.hasError) throw env.error;\n  }\n  return next();\n}\n\nexport default {\n  __extends,\n  __assign,\n  __rest,\n  __decorate,\n  __param,\n  __metadata,\n  __awaiter,\n  __generator,\n  __createBinding,\n  __exportStar,\n  __values,\n  __read,\n  __spread,\n  __spreadArrays,\n  __spreadArray,\n  __await,\n  __asyncGenerator,\n  __asyncDelegator,\n  __asyncValues,\n  __makeTemplateObject,\n  __importStar,\n  __importDefault,\n  __classPrivateFieldGet,\n  __classPrivateFieldSet,\n  __classPrivateFieldIn,\n  __addDisposableResource,\n  __disposeResources,\n};\n", "/**\n * Returns true if the object is a function.\n * @param value The value to check\n */\nexport function isFunction(value: any): value is (...args: any[]) => any {\n  return typeof value === 'function';\n}\n", "/**\n * Used to create Error subclasses until the community moves away from ES5.\n *\n * This is because compiling from TypeScript down to ES5 has issues with subclassing Errors\n * as well as other built-in types: https://github.com/Microsoft/TypeScript/issues/12123\n *\n * @param createImpl A factory function to create the actual constructor implementation. The returned\n * function should be a named function that calls `_super` internally.\n */\nexport function createErrorClass<T>(createImpl: (_super: any) => any): T {\n  const _super = (instance: any) => {\n    Error.call(instance);\n    instance.stack = new Error().stack;\n  };\n\n  const ctorFunc = createImpl(_super);\n  ctorFunc.prototype = Object.create(Error.prototype);\n  ctorFunc.prototype.constructor = ctorFunc;\n  return ctorFunc;\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface UnsubscriptionError extends Error {\n  readonly errors: any[];\n}\n\nexport interface UnsubscriptionErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (errors: any[]): UnsubscriptionError;\n}\n\n/**\n * An error thrown when one or more errors have occurred during the\n * `unsubscribe` of a {@link Subscription}.\n */\nexport const UnsubscriptionError: UnsubscriptionErrorCtor = createErrorClass(\n  (_super) =>\n    function UnsubscriptionErrorImpl(this: any, errors: (Error | string)[]) {\n      _super(this);\n      this.message = errors\n        ? `${errors.length} errors occurred during unsubscription:\n${errors.map((err, i) => `${i + 1}) ${err.toString()}`).join('\\n  ')}`\n        : '';\n      this.name = 'UnsubscriptionError';\n      this.errors = errors;\n    }\n);\n", "/**\n * Removes an item from an array, mutating it.\n * @param arr The array to remove the item from\n * @param item The item to remove\n */\nexport function arrRemove<T>(arr: T[] | undefined | null, item: T) {\n  if (arr) {\n    const index = arr.indexOf(item);\n    0 <= index && arr.splice(index, 1);\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { UnsubscriptionError } from './util/UnsubscriptionError';\nimport { SubscriptionLike, TeardownLogic, Unsubscribable } from './types';\nimport { arrRemove } from './util/arrRemove';\n\n/**\n * Represents a disposable resource, such as the execution of an Observable. A\n * Subscription has one important method, `unsubscribe`, that takes no argument\n * and just disposes the resource held by the subscription.\n *\n * Additionally, subscriptions may be grouped together through the `add()`\n * method, which will attach a child Subscription to the current Subscription.\n * When a Subscription is unsubscribed, all its children (and its grandchildren)\n * will be unsubscribed as well.\n *\n * @class Subscription\n */\nexport class Subscription implements SubscriptionLike {\n  /** @nocollapse */\n  public static EMPTY = (() => {\n    const empty = new Subscription();\n    empty.closed = true;\n    return empty;\n  })();\n\n  /**\n   * A flag to indicate whether this Subscription has already been unsubscribed.\n   */\n  public closed = false;\n\n  private _parentage: Subscription[] | Subscription | null = null;\n\n  /**\n   * The list of registered finalizers to execute upon unsubscription. Adding and removing from this\n   * list occurs in the {@link #add} and {@link #remove} methods.\n   */\n  private _finalizers: Exclude<TeardownLogic, void>[] | null = null;\n\n  /**\n   * @param initialTeardown A function executed first as part of the finalization\n   * process that is kicked off when {@link #unsubscribe} is called.\n   */\n  constructor(private initialTeardown?: () => void) {}\n\n  /**\n   * Disposes the resources held by the subscription. May, for instance, cancel\n   * an ongoing Observable execution or cancel any other type of work that\n   * started when the Subscription was created.\n   * @return {void}\n   */\n  unsubscribe(): void {\n    let errors: any[] | undefined;\n\n    if (!this.closed) {\n      this.closed = true;\n\n      // Remove this from it's parents.\n      const { _parentage } = this;\n      if (_parentage) {\n        this._parentage = null;\n        if (Array.isArray(_parentage)) {\n          for (const parent of _parentage) {\n            parent.remove(this);\n          }\n        } else {\n          _parentage.remove(this);\n        }\n      }\n\n      const { initialTeardown: initialFinalizer } = this;\n      if (isFunction(initialFinalizer)) {\n        try {\n          initialFinalizer();\n        } catch (e) {\n          errors = e instanceof UnsubscriptionError ? e.errors : [e];\n        }\n      }\n\n      const { _finalizers } = this;\n      if (_finalizers) {\n        this._finalizers = null;\n        for (const finalizer of _finalizers) {\n          try {\n            execFinalizer(finalizer);\n          } catch (err) {\n            errors = errors ?? [];\n            if (err instanceof UnsubscriptionError) {\n              errors = [...errors, ...err.errors];\n            } else {\n              errors.push(err);\n            }\n          }\n        }\n      }\n\n      if (errors) {\n        throw new UnsubscriptionError(errors);\n      }\n    }\n  }\n\n  /**\n   * Adds a finalizer to this subscription, so that finalization will be unsubscribed/called\n   * when this subscription is unsubscribed. If this subscription is already {@link #closed},\n   * because it has already been unsubscribed, then whatever finalizer is passed to it\n   * will automatically be executed (unless the finalizer itself is also a closed subscription).\n   *\n   * Closed Subscriptions cannot be added as finalizers to any subscription. Adding a closed\n   * subscription to a any subscription will result in no operation. (A noop).\n   *\n   * Adding a subscription to itself, or adding `null` or `undefined` will not perform any\n   * operation at all. (A noop).\n   *\n   * `Subscription` instances that are added to this instance will automatically remove themselves\n   * if they are unsubscribed. Functions and {@link Unsubscribable} objects that you wish to remove\n   * will need to be removed manually with {@link #remove}\n   *\n   * @param teardown The finalization logic to add to this subscription.\n   */\n  add(teardown: TeardownLogic): void {\n    // Only add the finalizer if it's not undefined\n    // and don't add a subscription to itself.\n    if (teardown && teardown !== this) {\n      if (this.closed) {\n        // If this subscription is already closed,\n        // execute whatever finalizer is handed to it automatically.\n        execFinalizer(teardown);\n      } else {\n        if (teardown instanceof Subscription) {\n          // We don't add closed subscriptions, and we don't add the same subscription\n          // twice. Subscription unsubscribe is idempotent.\n          if (teardown.closed || teardown._hasParent(this)) {\n            return;\n          }\n          teardown._addParent(this);\n        }\n        (this._finalizers = this._finalizers ?? []).push(teardown);\n      }\n    }\n  }\n\n  /**\n   * Checks to see if a this subscription already has a particular parent.\n   * This will signal that this subscription has already been added to the parent in question.\n   * @param parent the parent to check for\n   */\n  private _hasParent(parent: Subscription) {\n    const { _parentage } = this;\n    return _parentage === parent || (Array.isArray(_parentage) && _parentage.includes(parent));\n  }\n\n  /**\n   * Adds a parent to this subscription so it can be removed from the parent if it\n   * unsubscribes on it's own.\n   *\n   * NOTE: THIS ASSUMES THAT {@link _hasParent} HAS ALREADY BEEN CHECKED.\n   * @param parent The parent subscription to add\n   */\n  private _addParent(parent: Subscription) {\n    const { _parentage } = this;\n    this._parentage = Array.isArray(_parentage) ? (_parentage.push(parent), _parentage) : _parentage ? [_parentage, parent] : parent;\n  }\n\n  /**\n   * Called on a child when it is removed via {@link #remove}.\n   * @param parent The parent to remove\n   */\n  private _removeParent(parent: Subscription) {\n    const { _parentage } = this;\n    if (_parentage === parent) {\n      this._parentage = null;\n    } else if (Array.isArray(_parentage)) {\n      arrRemove(_parentage, parent);\n    }\n  }\n\n  /**\n   * Removes a finalizer from this subscription that was previously added with the {@link #add} method.\n   *\n   * Note that `Subscription` instances, when unsubscribed, will automatically remove themselves\n   * from every other `Subscription` they have been added to. This means that using the `remove` method\n   * is not a common thing and should be used thoughtfully.\n   *\n   * If you add the same finalizer instance of a function or an unsubscribable object to a `Subscription` instance\n   * more than once, you will need to call `remove` the same number of times to remove all instances.\n   *\n   * All finalizer instances are removed to free up memory upon unsubscription.\n   *\n   * @param teardown The finalizer to remove from this subscription\n   */\n  remove(teardown: Exclude<TeardownLogic, void>): void {\n    const { _finalizers } = this;\n    _finalizers && arrRemove(_finalizers, teardown);\n\n    if (teardown instanceof Subscription) {\n      teardown._removeParent(this);\n    }\n  }\n}\n\nexport const EMPTY_SUBSCRIPTION = Subscription.EMPTY;\n\nexport function isSubscription(value: any): value is Subscription {\n  return (\n    value instanceof Subscription ||\n    (value && 'closed' in value && isFunction(value.remove) && isFunction(value.add) && isFunction(value.unsubscribe))\n  );\n}\n\nfunction execFinalizer(finalizer: Unsubscribable | (() => void)) {\n  if (isFunction(finalizer)) {\n    finalizer();\n  } else {\n    finalizer.unsubscribe();\n  }\n}\n", "import { Subscriber } from './Subscriber';\nimport { ObservableNotification } from './types';\n\n/**\n * The {@link GlobalConfig} object for RxJS. It is used to configure things\n * like how to react on unhandled errors.\n */\nexport const config: GlobalConfig = {\n  onUnhandledError: null,\n  onStoppedNotification: null,\n  Promise: undefined,\n  useDeprecatedSynchronousErrorHandling: false,\n  useDeprecatedNextContext: false,\n};\n\n/**\n * The global configuration object for RxJS, used to configure things\n * like how to react on unhandled errors. Accessible via {@link config}\n * object.\n */\nexport interface GlobalConfig {\n  /**\n   * A registration point for unhandled errors from RxJS. These are errors that\n   * cannot were not handled by consuming code in the usual subscription path. For\n   * example, if you have this configured, and you subscribe to an observable without\n   * providing an error handler, errors from that subscription will end up here. This\n   * will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onUnhandledError: ((err: any) => void) | null;\n\n  /**\n   * A registration point for notifications that cannot be sent to subscribers because they\n   * have completed, errored or have been explicitly unsubscribed. By default, next, complete\n   * and error notifications sent to stopped subscribers are noops. However, sometimes callers\n   * might want a different behavior. For example, with sources that attempt to report errors\n   * to stopped subscribers, a caller can configure RxJS to throw an unhandled error instead.\n   * This will _always_ be called asynchronously on another job in the runtime. This is because\n   * we do not want errors thrown in this user-configured handler to interfere with the\n   * behavior of the library.\n   */\n  onStoppedNotification: ((notification: ObservableNotification<any>, subscriber: Subscriber<any>) => void) | null;\n\n  /**\n   * The promise constructor used by default for {@link Observable#toPromise toPromise} and {@link Observable#forEach forEach}\n   * methods.\n   *\n   * @deprecated As of version 8, RxJS will no longer support this sort of injection of a\n   * Promise constructor. If you need a Promise implementation other than native promises,\n   * please polyfill/patch Promise as you see appropriate. Will be removed in v8.\n   */\n  Promise?: PromiseConstructorLike;\n\n  /**\n   * If true, turns on synchronous error rethrowing, which is a deprecated behavior\n   * in v6 and higher. This behavior enables bad patterns like wrapping a subscribe\n   * call in a try/catch block. It also enables producer interference, a nasty bug\n   * where a multicast can be broken for all observers by a downstream consumer with\n   * an unhandled error. DO NOT USE THIS FLAG UNLESS IT'S NEEDED TO BUY TIME\n   * FOR MIGRATION REASONS.\n   *\n   * @deprecated As of version 8, RxJS will no longer support synchronous throwing\n   * of unhandled errors. All errors will be thrown on a separate call stack to prevent bad\n   * behaviors described above. Will be removed in v8.\n   */\n  useDeprecatedSynchronousErrorHandling: boolean;\n\n  /**\n   * If true, enables an as-of-yet undocumented feature from v5: The ability to access\n   * `unsubscribe()` via `this` context in `next` functions created in observers passed\n   * to `subscribe`.\n   *\n   * This is being removed because the performance was severely problematic, and it could also cause\n   * issues when types other than POJOs are passed to subscribe as subscribers, as they will likely have\n   * their `this` context overwritten.\n   *\n   * @deprecated As of version 8, RxJS will no longer support altering the\n   * context of next functions provided as part of an observer to Subscribe. Instead,\n   * you will have access to a subscription or a signal or token that will allow you to do things like\n   * unsubscribe and test closed status. Will be removed in v8.\n   */\n  useDeprecatedNextContext: boolean;\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetTimeoutFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearTimeoutFunction = (handle: TimerHandle) => void;\n\ninterface TimeoutProvider {\n  setTimeout: SetTimeoutFunction;\n  clearTimeout: ClearTimeoutFunction;\n  delegate:\n    | {\n        setTimeout: SetTimeoutFunction;\n        clearTimeout: ClearTimeoutFunction;\n      }\n    | undefined;\n}\n\nexport const timeoutProvider: TimeoutProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setTimeout(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = timeoutProvider;\n    if (delegate?.setTimeout) {\n      return delegate.setTimeout(handler, timeout, ...args);\n    }\n    return setTimeout(handler, timeout, ...args);\n  },\n  clearTimeout(handle) {\n    const { delegate } = timeoutProvider;\n    return (delegate?.clearTimeout || clearTimeout)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { config } from '../config';\nimport { timeoutProvider } from '../scheduler/timeoutProvider';\n\n/**\n * Handles an error on another job either with the user-configured {@link onUnhandledError},\n * or by throwing it on that new job so it can be picked up by `window.onerror`, `process.on('error')`, etc.\n *\n * This should be called whenever there is an error that is out-of-band with the subscription\n * or when an error hits a terminal boundary of the subscription and no error handler was provided.\n *\n * @param err the error to report\n */\nexport function reportUnhandledError(err: any) {\n  timeoutProvider.setTimeout(() => {\n    const { onUnhandledError } = config;\n    if (onUnhandledError) {\n      // Execute the user-configured error handler.\n      onUnhandledError(err);\n    } else {\n      // Throw so it is picked up by the runtime's uncaught error mechanism.\n      throw err;\n    }\n  });\n}\n", "/* tslint:disable:no-empty */\nexport function noop() { }\n", "import { CompleteNotification, NextNotification, ErrorNotification } from './types';\n\n/**\n * A completion object optimized for memory use and created to be the\n * same \"shape\" as other notifications in v8.\n * @internal\n */\nexport const COMPLETE_NOTIFICATION = (() => createNotification('C', undefined, undefined) as CompleteNotification)();\n\n/**\n * Internal use only. Creates an optimized error notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function errorNotification(error: any): ErrorNotification {\n  return createNotification('E', undefined, error) as any;\n}\n\n/**\n * Internal use only. Creates an optimized next notification that is the same \"shape\"\n * as other notifications.\n * @internal\n */\nexport function nextNotification<T>(value: T) {\n  return createNotification('N', value, undefined) as NextNotification<T>;\n}\n\n/**\n * Ensures that all notifications created internally have the same \"shape\" in v8.\n *\n * TODO: This is only exported to support a crazy legacy test in `groupBy`.\n * @internal\n */\nexport function createNotification(kind: 'N' | 'E' | 'C', value: any, error: any) {\n  return {\n    kind,\n    value,\n    error,\n  };\n}\n", "import { config } from '../config';\n\nlet context: { errorThrown: boolean; error: any } | null = null;\n\n/**\n * Handles dealing with errors for super-gross mode. Creates a context, in which\n * any synchronously thrown errors will be passed to {@link captureError}. Which\n * will record the error such that it will be rethrown after the call back is complete.\n * TODO: Remove in v8\n * @param cb An immediately executed function.\n */\nexport function errorContext(cb: () => void) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    const isRoot = !context;\n    if (isRoot) {\n      context = { errorThrown: false, error: null };\n    }\n    cb();\n    if (isRoot) {\n      const { errorThrown, error } = context!;\n      context = null;\n      if (errorThrown) {\n        throw error;\n      }\n    }\n  } else {\n    // This is the general non-deprecated path for everyone that\n    // isn't crazy enough to use super-gross mode (useDeprecatedSynchronousErrorHandling)\n    cb();\n  }\n}\n\n/**\n * Captures errors only in super-gross mode.\n * @param err the error to capture\n */\nexport function captureError(err: any) {\n  if (config.useDeprecatedSynchronousErrorHandling && context) {\n    context.errorThrown = true;\n    context.error = err;\n  }\n}\n", "import { isFunction } from './util/isFunction';\nimport { Observer, ObservableNotification } from './types';\nimport { isSubscription, Subscription } from './Subscription';\nimport { config } from './config';\nimport { reportUnhandledError } from './util/reportUnhandledError';\nimport { noop } from './util/noop';\nimport { nextNotification, errorNotification, COMPLETE_NOTIFICATION } from './NotificationFactories';\nimport { timeoutProvider } from './scheduler/timeoutProvider';\nimport { captureError } from './util/errorContext';\n\n/**\n * Implements the {@link Observer} interface and extends the\n * {@link Subscription} class. While the {@link Observer} is the public API for\n * consuming the values of an {@link Observable}, all Observers get converted to\n * a Subscriber, in order to provide Subscription-like capabilities such as\n * `unsubscribe`. Subscriber is a common type in RxJS, and crucial for\n * implementing operators, but it is rarely used as a public API.\n *\n * @class Subscriber<T>\n */\nexport class Subscriber<T> extends Subscription implements Observer<T> {\n  /**\n   * A static factory for a Subscriber, given a (potentially partial) definition\n   * of an Observer.\n   * @param next The `next` callback of an Observer.\n   * @param error The `error` callback of an\n   * Observer.\n   * @param complete The `complete` callback of an\n   * Observer.\n   * @return A Subscriber wrapping the (partially defined)\n   * Observer represented by the given arguments.\n   * @nocollapse\n   * @deprecated Do not use. Will be removed in v8. There is no replacement for this\n   * method, and there is no reason to be creating instances of `Subscriber` directly.\n   * If you have a specific use case, please file an issue.\n   */\n  static create<T>(next?: (x?: T) => void, error?: (e?: any) => void, complete?: () => void): Subscriber<T> {\n    return new SafeSubscriber(next, error, complete);\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected isStopped: boolean = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  protected destination: Subscriber<any> | Observer<any>; // this `any` is the escape hatch to erase extra type param (e.g. R)\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * There is no reason to directly create an instance of Subscriber. This type is exported for typings reasons.\n   */\n  constructor(destination?: Subscriber<any> | Observer<any>) {\n    super();\n    if (destination) {\n      this.destination = destination;\n      // Automatically chain subscriptions together here.\n      // if destination is a Subscription, then it is a Subscriber.\n      if (isSubscription(destination)) {\n        destination.add(this);\n      }\n    } else {\n      this.destination = EMPTY_OBSERVER;\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `next` from\n   * the Observable, with a value. The Observable may call this method 0 or more\n   * times.\n   * @param {T} [value] The `next` value.\n   * @return {void}\n   */\n  next(value?: T): void {\n    if (this.isStopped) {\n      handleStoppedNotification(nextNotification(value), this);\n    } else {\n      this._next(value!);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive notifications of type `error` from\n   * the Observable, with an attached `Error`. Notifies the Observer that\n   * the Observable has experienced an error condition.\n   * @param {any} [err] The `error` exception.\n   * @return {void}\n   */\n  error(err?: any): void {\n    if (this.isStopped) {\n      handleStoppedNotification(errorNotification(err), this);\n    } else {\n      this.isStopped = true;\n      this._error(err);\n    }\n  }\n\n  /**\n   * The {@link Observer} callback to receive a valueless notification of type\n   * `complete` from the Observable. Notifies the Observer that the Observable\n   * has finished sending push-based notifications.\n   * @return {void}\n   */\n  complete(): void {\n    if (this.isStopped) {\n      handleStoppedNotification(COMPLETE_NOTIFICATION, this);\n    } else {\n      this.isStopped = true;\n      this._complete();\n    }\n  }\n\n  unsubscribe(): void {\n    if (!this.closed) {\n      this.isStopped = true;\n      super.unsubscribe();\n      this.destination = null!;\n    }\n  }\n\n  protected _next(value: T): void {\n    this.destination.next(value);\n  }\n\n  protected _error(err: any): void {\n    try {\n      this.destination.error(err);\n    } finally {\n      this.unsubscribe();\n    }\n  }\n\n  protected _complete(): void {\n    try {\n      this.destination.complete();\n    } finally {\n      this.unsubscribe();\n    }\n  }\n}\n\n/**\n * This bind is captured here because we want to be able to have\n * compatibility with monoid libraries that tend to use a method named\n * `bind`. In particular, a library called Monio requires this.\n */\nconst _bind = Function.prototype.bind;\n\nfunction bind<Fn extends (...args: any[]) => any>(fn: Fn, thisArg: any): Fn {\n  return _bind.call(fn, thisArg);\n}\n\n/**\n * Internal optimization only, DO NOT EXPOSE.\n * @internal\n */\nclass ConsumerObserver<T> implements Observer<T> {\n  constructor(private partialObserver: Partial<Observer<T>>) {}\n\n  next(value: T): void {\n    const { partialObserver } = this;\n    if (partialObserver.next) {\n      try {\n        partialObserver.next(value);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n\n  error(err: any): void {\n    const { partialObserver } = this;\n    if (partialObserver.error) {\n      try {\n        partialObserver.error(err);\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    } else {\n      handleUnhandledError(err);\n    }\n  }\n\n  complete(): void {\n    const { partialObserver } = this;\n    if (partialObserver.complete) {\n      try {\n        partialObserver.complete();\n      } catch (error) {\n        handleUnhandledError(error);\n      }\n    }\n  }\n}\n\nexport class SafeSubscriber<T> extends Subscriber<T> {\n  constructor(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((e?: any) => void) | null,\n    complete?: (() => void) | null\n  ) {\n    super();\n\n    let partialObserver: Partial<Observer<T>>;\n    if (isFunction(observerOrNext) || !observerOrNext) {\n      // The first argument is a function, not an observer. The next\n      // two arguments *could* be observers, or they could be empty.\n      partialObserver = {\n        next: (observerOrNext ?? undefined) as (((value: T) => void) | undefined),\n        error: error ?? undefined,\n        complete: complete ?? undefined,\n      };\n    } else {\n      // The first argument is a partial observer.\n      let context: any;\n      if (this && config.useDeprecatedNextContext) {\n        // This is a deprecated path that made `this.unsubscribe()` available in\n        // next handler functions passed to subscribe. This only exists behind a flag\n        // now, as it is *very* slow.\n        context = Object.create(observerOrNext);\n        context.unsubscribe = () => this.unsubscribe();\n        partialObserver = {\n          next: observerOrNext.next && bind(observerOrNext.next, context),\n          error: observerOrNext.error && bind(observerOrNext.error, context),\n          complete: observerOrNext.complete && bind(observerOrNext.complete, context),\n        };\n      } else {\n        // The \"normal\" path. Just use the partial observer directly.\n        partialObserver = observerOrNext;\n      }\n    }\n\n    // Wrap the partial observer to ensure it's a full observer, and\n    // make sure proper error handling is accounted for.\n    this.destination = new ConsumerObserver(partialObserver);\n  }\n}\n\nfunction handleUnhandledError(error: any) {\n  if (config.useDeprecatedSynchronousErrorHandling) {\n    captureError(error);\n  } else {\n    // Ideal path, we report this as an unhandled error,\n    // which is thrown on a new call stack.\n    reportUnhandledError(error);\n  }\n}\n\n/**\n * An error handler used when no error handler was supplied\n * to the SafeSubscriber -- meaning no error handler was supplied\n * do the `subscribe` call on our observable.\n * @param err The error to handle\n */\nfunction defaultErrorHandler(err: any) {\n  throw err;\n}\n\n/**\n * A handler for notifications that cannot be sent to a stopped subscriber.\n * @param notification The notification being sent\n * @param subscriber The stopped subscriber\n */\nfunction handleStoppedNotification(notification: ObservableNotification<any>, subscriber: Subscriber<any>) {\n  const { onStoppedNotification } = config;\n  onStoppedNotification && timeoutProvider.setTimeout(() => onStoppedNotification(notification, subscriber));\n}\n\n/**\n * The observer used as a stub for subscriptions where the user did not\n * pass any arguments to `subscribe`. Comes with the default error handling\n * behavior.\n */\nexport const EMPTY_OBSERVER: Readonly<Observer<any>> & { closed: true } = {\n  closed: true,\n  next: noop,\n  error: defaultErrorHandler,\n  complete: noop,\n};\n", "/**\n * Symbol.observable or a string \"@@observable\". Used for interop\n *\n * @deprecated We will no longer be exporting this symbol in upcoming versions of RxJS.\n * Instead polyfill and use Symbol.observable directly *or* use https://www.npmjs.com/package/symbol-observable\n */\nexport const observable: string | symbol = (() => (typeof Symbol === 'function' && Symbol.observable) || '@@observable')();\n", "/**\n * This function takes one parameter and just returns it. Simply put,\n * this is like `<T>(x: T): T => x`.\n *\n * ## Examples\n *\n * This is useful in some cases when using things like `mergeMap`\n *\n * ```ts\n * import { interval, take, map, range, mergeMap, identity } from 'rxjs';\n *\n * const source$ = interval(1000).pipe(take(5));\n *\n * const result$ = source$.pipe(\n *   map(i => range(i)),\n *   mergeMap(identity) // same as mergeMap(x => x)\n * );\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * Or when you want to selectively apply an operator\n *\n * ```ts\n * import { interval, take, identity } from 'rxjs';\n *\n * const shouldLimit = () => Math.random() < 0.5;\n *\n * const source$ = interval(1000);\n *\n * const result$ = source$.pipe(shouldLimit() ? take(5) : identity);\n *\n * result$.subscribe({\n *   next: console.log\n * });\n * ```\n *\n * @param x Any value that is returned by this function\n * @returns The value passed as the first parameter to this function\n */\nexport function identity<T>(x: T): T {\n  return x;\n}\n", "import { identity } from './identity';\nimport { UnaryFunction } from '../types';\n\nexport function pipe(): typeof identity;\nexport function pipe<T, A>(fn1: UnaryFunction<T, A>): UnaryFunction<T, A>;\nexport function pipe<T, A, B>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>): UnaryFunction<T, B>;\nexport function pipe<T, A, B, C>(fn1: UnaryFunction<T, A>, fn2: UnaryFunction<A, B>, fn3: UnaryFunction<B, C>): UnaryFunction<T, C>;\nexport function pipe<T, A, B, C, D>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>\n): UnaryFunction<T, D>;\nexport function pipe<T, A, B, C, D, E>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>\n): UnaryFunction<T, E>;\nexport function pipe<T, A, B, C, D, E, F>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>\n): UnaryFunction<T, F>;\nexport function pipe<T, A, B, C, D, E, F, G>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>\n): UnaryFunction<T, G>;\nexport function pipe<T, A, B, C, D, E, F, G, H>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>\n): UnaryFunction<T, H>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>\n): UnaryFunction<T, I>;\nexport function pipe<T, A, B, C, D, E, F, G, H, I>(\n  fn1: UnaryFunction<T, A>,\n  fn2: UnaryFunction<A, B>,\n  fn3: UnaryFunction<B, C>,\n  fn4: UnaryFunction<C, D>,\n  fn5: UnaryFunction<D, E>,\n  fn6: UnaryFunction<E, F>,\n  fn7: UnaryFunction<F, G>,\n  fn8: UnaryFunction<G, H>,\n  fn9: UnaryFunction<H, I>,\n  ...fns: UnaryFunction<any, any>[]\n): UnaryFunction<T, unknown>;\n\n/**\n * pipe() can be called on one or more functions, each of which can take one argument (\"UnaryFunction\")\n * and uses it to return a value.\n * It returns a function that takes one argument, passes it to the first UnaryFunction, and then\n * passes the result to the next one, passes that result to the next one, and so on.  \n */\nexport function pipe(...fns: Array<UnaryFunction<any, any>>): UnaryFunction<any, any> {\n  return pipeFromArray(fns);\n}\n\n/** @internal */\nexport function pipeFromArray<T, R>(fns: Array<UnaryFunction<T, R>>): UnaryFunction<T, R> {\n  if (fns.length === 0) {\n    return identity as UnaryFunction<any, any>;\n  }\n\n  if (fns.length === 1) {\n    return fns[0];\n  }\n\n  return function piped(input: T): R {\n    return fns.reduce((prev: any, fn: UnaryFunction<T, R>) => fn(prev), input as any);\n  };\n}\n", "import { Operator } from './Operator';\nimport { SafeSubscriber, Subscriber } from './Subscriber';\nimport { isSubscription, Subscription } from './Subscription';\nimport { TeardownLogic, OperatorFunction, Subscribable, Observer } from './types';\nimport { observable as Symbol_observable } from './symbol/observable';\nimport { pipeFromArray } from './util/pipe';\nimport { config } from './config';\nimport { isFunction } from './util/isFunction';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A representation of any set of values over any amount of time. This is the most basic building block\n * of RxJS.\n *\n * @class Observable<T>\n */\nexport class Observable<T> implements Subscribable<T> {\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  source: Observable<any> | undefined;\n\n  /**\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   */\n  operator: Operator<any, T> | undefined;\n\n  /**\n   * @constructor\n   * @param {Function} subscribe the function that is called when the Observable is\n   * initially subscribed to. This function is given a Subscriber, to which new values\n   * can be `next`ed, or an `error` method can be called to raise an error, or\n   * `complete` can be called to notify of a successful completion.\n   */\n  constructor(subscribe?: (this: Observable<T>, subscriber: Subscriber<T>) => TeardownLogic) {\n    if (subscribe) {\n      this._subscribe = subscribe;\n    }\n  }\n\n  // HACK: Since TypeScript inherits static properties too, we have to\n  // fight against TypeScript here so Subject can have a different static create signature\n  /**\n   * Creates a new Observable by calling the Observable constructor\n   * @owner Observable\n   * @method create\n   * @param {Function} subscribe? the subscriber function to be passed to the Observable constructor\n   * @return {Observable} a new observable\n   * @nocollapse\n   * @deprecated Use `new Observable()` instead. Will be removed in v8.\n   */\n  static create: (...args: any[]) => any = <T>(subscribe?: (subscriber: Subscriber<T>) => TeardownLogic) => {\n    return new Observable<T>(subscribe);\n  };\n\n  /**\n   * Creates a new Observable, with this Observable instance as the source, and the passed\n   * operator defined as the new observable's operator.\n   * @method lift\n   * @param operator the operator defining the operation to take on the observable\n   * @return a new observable with the Operator applied\n   * @deprecated Internal implementation detail, do not use directly. Will be made internal in v8.\n   * If you have implemented an operator using `lift`, it is recommended that you create an\n   * operator by simply returning `new Observable()` directly. See \"Creating new operators from\n   * scratch\" section here: https://rxjs.dev/guide/operators\n   */\n  lift<R>(operator?: Operator<T, R>): Observable<R> {\n    const observable = new Observable<R>();\n    observable.source = this;\n    observable.operator = operator;\n    return observable;\n  }\n\n  subscribe(observerOrNext?: Partial<Observer<T>> | ((value: T) => void)): Subscription;\n  /** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\n  subscribe(next?: ((value: T) => void) | null, error?: ((error: any) => void) | null, complete?: (() => void) | null): Subscription;\n  /**\n   * Invokes an execution of an Observable and registers Observer handlers for notifications it will emit.\n   *\n   * <span class=\"informal\">Use it when you have all these Observables, but still nothing is happening.</span>\n   *\n   * `subscribe` is not a regular operator, but a method that calls Observable's internal `subscribe` function. It\n   * might be for example a function that you passed to Observable's constructor, but most of the time it is\n   * a library implementation, which defines what will be emitted by an Observable, and when it be will emitted. This means\n   * that calling `subscribe` is actually the moment when Observable starts its work, not when it is created, as it is often\n   * the thought.\n   *\n   * Apart from starting the execution of an Observable, this method allows you to listen for values\n   * that an Observable emits, as well as for when it completes or errors. You can achieve this in two\n   * of the following ways.\n   *\n   * The first way is creating an object that implements {@link Observer} interface. It should have methods\n   * defined by that interface, but note that it should be just a regular JavaScript object, which you can create\n   * yourself in any way you want (ES6 class, classic function constructor, object literal etc.). In particular, do\n   * not attempt to use any RxJS implementation details to create Observers - you don't need them. Remember also\n   * that your object does not have to implement all methods. If you find yourself creating a method that doesn't\n   * do anything, you can simply omit it. Note however, if the `error` method is not provided and an error happens,\n   * it will be thrown asynchronously. Errors thrown asynchronously cannot be caught using `try`/`catch`. Instead,\n   * use the {@link onUnhandledError} configuration option or use a runtime handler (like `window.onerror` or\n   * `process.on('error)`) to be notified of unhandled errors. Because of this, it's recommended that you provide\n   * an `error` method to avoid missing thrown errors.\n   *\n   * The second way is to give up on Observer object altogether and simply provide callback functions in place of its methods.\n   * This means you can provide three functions as arguments to `subscribe`, where the first function is equivalent\n   * of a `next` method, the second of an `error` method and the third of a `complete` method. Just as in case of an Observer,\n   * if you do not need to listen for something, you can omit a function by passing `undefined` or `null`,\n   * since `subscribe` recognizes these functions by where they were placed in function call. When it comes\n   * to the `error` function, as with an Observer, if not provided, errors emitted by an Observable will be thrown asynchronously.\n   *\n   * You can, however, subscribe with no parameters at all. This may be the case where you're not interested in terminal events\n   * and you also handled emissions internally by using operators (e.g. using `tap`).\n   *\n   * Whichever style of calling `subscribe` you use, in both cases it returns a Subscription object.\n   * This object allows you to call `unsubscribe` on it, which in turn will stop the work that an Observable does and will clean\n   * up all resources that an Observable used. Note that cancelling a subscription will not call `complete` callback\n   * provided to `subscribe` function, which is reserved for a regular completion signal that comes from an Observable.\n   *\n   * Remember that callbacks provided to `subscribe` are not guaranteed to be called asynchronously.\n   * It is an Observable itself that decides when these functions will be called. For example {@link of}\n   * by default emits all its values synchronously. Always check documentation for how given Observable\n   * will behave when subscribed and if its default behavior can be modified with a `scheduler`.\n   *\n   * #### Examples\n   *\n   * Subscribe with an {@link guide/observer Observer}\n   *\n   * ```ts\n   * import { of } from 'rxjs';\n   *\n   * const sumObserver = {\n   *   sum: 0,\n   *   next(value) {\n   *     console.log('Adding: ' + value);\n   *     this.sum = this.sum + value;\n   *   },\n   *   error() {\n   *     // We actually could just remove this method,\n   *     // since we do not really care about errors right now.\n   *   },\n   *   complete() {\n   *     console.log('Sum equals: ' + this.sum);\n   *   }\n   * };\n   *\n   * of(1, 2, 3) // Synchronously emits 1, 2, 3 and then completes.\n   *   .subscribe(sumObserver);\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Subscribe with functions ({@link deprecations/subscribe-arguments deprecated})\n   *\n   * ```ts\n   * import { of } from 'rxjs'\n   *\n   * let sum = 0;\n   *\n   * of(1, 2, 3).subscribe(\n   *   value => {\n   *     console.log('Adding: ' + value);\n   *     sum = sum + value;\n   *   },\n   *   undefined,\n   *   () => console.log('Sum equals: ' + sum)\n   * );\n   *\n   * // Logs:\n   * // 'Adding: 1'\n   * // 'Adding: 2'\n   * // 'Adding: 3'\n   * // 'Sum equals: 6'\n   * ```\n   *\n   * Cancel a subscription\n   *\n   * ```ts\n   * import { interval } from 'rxjs';\n   *\n   * const subscription = interval(1000).subscribe({\n   *   next(num) {\n   *     console.log(num)\n   *   },\n   *   complete() {\n   *     // Will not be called, even when cancelling subscription.\n   *     console.log('completed!');\n   *   }\n   * });\n   *\n   * setTimeout(() => {\n   *   subscription.unsubscribe();\n   *   console.log('unsubscribed!');\n   * }, 2500);\n   *\n   * // Logs:\n   * // 0 after 1s\n   * // 1 after 2s\n   * // 'unsubscribed!' after 2.5s\n   * ```\n   *\n   * @param {Observer|Function} observerOrNext (optional) Either an observer with methods to be called,\n   * or the first of three possible handlers, which is the handler for each value emitted from the subscribed\n   * Observable.\n   * @param {Function} error (optional) A handler for a terminal event resulting from an error. If no error handler is provided,\n   * the error will be thrown asynchronously as unhandled.\n   * @param {Function} complete (optional) A handler for a terminal event resulting from successful completion.\n   * @return {Subscription} a subscription reference to the registered handlers\n   * @method subscribe\n   */\n  subscribe(\n    observerOrNext?: Partial<Observer<T>> | ((value: T) => void) | null,\n    error?: ((error: any) => void) | null,\n    complete?: (() => void) | null\n  ): Subscription {\n    const subscriber = isSubscriber(observerOrNext) ? observerOrNext : new SafeSubscriber(observerOrNext, error, complete);\n\n    errorContext(() => {\n      const { operator, source } = this;\n      subscriber.add(\n        operator\n          ? // We're dealing with a subscription in the\n            // operator chain to one of our lifted operators.\n            operator.call(subscriber, source)\n          : source\n          ? // If `source` has a value, but `operator` does not, something that\n            // had intimate knowledge of our API, like our `Subject`, must have\n            // set it. We're going to just call `_subscribe` directly.\n            this._subscribe(subscriber)\n          : // In all other cases, we're likely wrapping a user-provided initializer\n            // function, so we need to catch errors and handle them appropriately.\n            this._trySubscribe(subscriber)\n      );\n    });\n\n    return subscriber;\n  }\n\n  /** @internal */\n  protected _trySubscribe(sink: Subscriber<T>): TeardownLogic {\n    try {\n      return this._subscribe(sink);\n    } catch (err) {\n      // We don't need to return anything in this case,\n      // because it's just going to try to `add()` to a subscription\n      // above.\n      sink.error(err);\n    }\n  }\n\n  /**\n   * Used as a NON-CANCELLABLE means of subscribing to an observable, for use with\n   * APIs that expect promises, like `async/await`. You cannot unsubscribe from this.\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * #### Example\n   *\n   * ```ts\n   * import { interval, take } from 'rxjs';\n   *\n   * const source$ = interval(1000).pipe(take(4));\n   *\n   * async function getTotal() {\n   *   let total = 0;\n   *\n   *   await source$.forEach(value => {\n   *     total += value;\n   *     console.log('observable -> ' + value);\n   *   });\n   *\n   *   return total;\n   * }\n   *\n   * getTotal().then(\n   *   total => console.log('Total: ' + total)\n   * );\n   *\n   * // Expected:\n   * // 'observable -> 0'\n   * // 'observable -> 1'\n   * // 'observable -> 2'\n   * // 'observable -> 3'\n   * // 'Total: 6'\n   * ```\n   *\n   * @param next a handler for each value emitted by the observable\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   */\n  forEach(next: (value: T) => void): Promise<void>;\n\n  /**\n   * @param next a handler for each value emitted by the observable\n   * @param promiseCtor a constructor function used to instantiate the Promise\n   * @return a promise that either resolves on observable completion or\n   *  rejects with the handled error\n   * @deprecated Passing a Promise constructor will no longer be available\n   * in upcoming versions of RxJS. This is because it adds weight to the library, for very\n   * little benefit. If you need this functionality, it is recommended that you either\n   * polyfill Promise, or you create an adapter to convert the returned native promise\n   * to whatever promise implementation you wanted. Will be removed in v8.\n   */\n  forEach(next: (value: T) => void, promiseCtor: PromiseConstructorLike): Promise<void>;\n\n  forEach(next: (value: T) => void, promiseCtor?: PromiseConstructorLike): Promise<void> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor<void>((resolve, reject) => {\n      const subscriber = new SafeSubscriber<T>({\n        next: (value) => {\n          try {\n            next(value);\n          } catch (err) {\n            reject(err);\n            subscriber.unsubscribe();\n          }\n        },\n        error: reject,\n        complete: resolve,\n      });\n      this.subscribe(subscriber);\n    }) as Promise<void>;\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<any>): TeardownLogic {\n    return this.source?.subscribe(subscriber);\n  }\n\n  /**\n   * An interop point defined by the es7-observable spec https://github.com/zenparsing/es-observable\n   * @method Symbol.observable\n   * @return {Observable} this instance of the observable\n   */\n  [Symbol_observable]() {\n    return this;\n  }\n\n  /* tslint:disable:max-line-length */\n  pipe(): Observable<T>;\n  pipe<A>(op1: OperatorFunction<T, A>): Observable<A>;\n  pipe<A, B>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>): Observable<B>;\n  pipe<A, B, C>(op1: OperatorFunction<T, A>, op2: OperatorFunction<A, B>, op3: OperatorFunction<B, C>): Observable<C>;\n  pipe<A, B, C, D>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>\n  ): Observable<D>;\n  pipe<A, B, C, D, E>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>\n  ): Observable<E>;\n  pipe<A, B, C, D, E, F>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>\n  ): Observable<F>;\n  pipe<A, B, C, D, E, F, G>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>\n  ): Observable<G>;\n  pipe<A, B, C, D, E, F, G, H>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>\n  ): Observable<H>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>\n  ): Observable<I>;\n  pipe<A, B, C, D, E, F, G, H, I>(\n    op1: OperatorFunction<T, A>,\n    op2: OperatorFunction<A, B>,\n    op3: OperatorFunction<B, C>,\n    op4: OperatorFunction<C, D>,\n    op5: OperatorFunction<D, E>,\n    op6: OperatorFunction<E, F>,\n    op7: OperatorFunction<F, G>,\n    op8: OperatorFunction<G, H>,\n    op9: OperatorFunction<H, I>,\n    ...operations: OperatorFunction<any, any>[]\n  ): Observable<unknown>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Used to stitch together functional operators into a chain.\n   * @method pipe\n   * @return {Observable} the Observable result of all of the operators having\n   * been called in the order they were passed in.\n   *\n   * ## Example\n   *\n   * ```ts\n   * import { interval, filter, map, scan } from 'rxjs';\n   *\n   * interval(1000)\n   *   .pipe(\n   *     filter(x => x % 2 === 0),\n   *     map(x => x + x),\n   *     scan((acc, x) => acc + x)\n   *   )\n   *   .subscribe(x => console.log(x));\n   * ```\n   */\n  pipe(...operations: OperatorFunction<any, any>[]): Observable<any> {\n    return pipeFromArray(operations)(this);\n  }\n\n  /* tslint:disable:max-line-length */\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: typeof Promise): Promise<T | undefined>;\n  /** @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise */\n  toPromise(PromiseCtor: PromiseConstructorLike): Promise<T | undefined>;\n  /* tslint:enable:max-line-length */\n\n  /**\n   * Subscribe to this Observable and get a Promise resolving on\n   * `complete` with the last emission (if any).\n   *\n   * **WARNING**: Only use this with observables you *know* will complete. If the source\n   * observable does not complete, you will end up with a promise that is hung up, and\n   * potentially all of the state of an async function hanging out in memory. To avoid\n   * this situation, look into adding something like {@link timeout}, {@link take},\n   * {@link takeWhile}, or {@link takeUntil} amongst others.\n   *\n   * @method toPromise\n   * @param [promiseCtor] a constructor function used to instantiate\n   * the Promise\n   * @return A Promise that resolves with the last value emit, or\n   * rejects on an error. If there were no emissions, Promise\n   * resolves with undefined.\n   * @deprecated Replaced with {@link firstValueFrom} and {@link lastValueFrom}. Will be removed in v8. Details: https://rxjs.dev/deprecations/to-promise\n   */\n  toPromise(promiseCtor?: PromiseConstructorLike): Promise<T | undefined> {\n    promiseCtor = getPromiseCtor(promiseCtor);\n\n    return new promiseCtor((resolve, reject) => {\n      let value: T | undefined;\n      this.subscribe(\n        (x: T) => (value = x),\n        (err: any) => reject(err),\n        () => resolve(value)\n      );\n    }) as Promise<T | undefined>;\n  }\n}\n\n/**\n * Decides between a passed promise constructor from consuming code,\n * A default configured promise constructor, and the native promise\n * constructor and returns it. If nothing can be found, it will throw\n * an error.\n * @param promiseCtor The optional promise constructor to passed by consuming code\n */\nfunction getPromiseCtor(promiseCtor: PromiseConstructorLike | undefined) {\n  return promiseCtor ?? config.Promise ?? Promise;\n}\n\nfunction isObserver<T>(value: any): value is Observer<T> {\n  return value && isFunction(value.next) && isFunction(value.error) && isFunction(value.complete);\n}\n\nfunction isSubscriber<T>(value: any): value is Subscriber<T> {\n  return (value && value instanceof Subscriber) || (isObserver(value) && isSubscription(value));\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { OperatorFunction } from '../types';\nimport { isFunction } from './isFunction';\n\n/**\n * Used to determine if an object is an Observable with a lift function.\n */\nexport function hasLift(source: any): source is { lift: InstanceType<typeof Observable>['lift'] } {\n  return isFunction(source?.lift);\n}\n\n/**\n * Creates an `OperatorFunction`. Used to define operators throughout the library in a concise way.\n * @param init The logic to connect the liftedSource to the subscriber at the moment of subscription.\n */\nexport function operate<T, R>(\n  init: (liftedSource: Observable<T>, subscriber: Subscriber<R>) => (() => void) | void\n): OperatorFunction<T, R> {\n  return (source: Observable<T>) => {\n    if (hasLift(source)) {\n      return source.lift(function (this: Subscriber<R>, liftedSource: Observable<T>) {\n        try {\n          return init(liftedSource, this);\n        } catch (err) {\n          this.error(err);\n        }\n      });\n    }\n    throw new TypeError('Unable to lift unknown Observable type');\n  };\n}\n", "import { Subscriber } from '../Subscriber';\n\n/**\n * Creates an instance of an `OperatorSubscriber`.\n * @param destination The downstream subscriber.\n * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n * and send to the `destination` error handler.\n * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n * this handler are sent to the `destination` error handler.\n * @param onFinalize Additional teardown logic here. This will only be called on teardown if the\n * subscriber itself is not already closed. This is called after all other teardown logic is executed.\n */\nexport function createOperatorSubscriber<T>(\n  destination: Subscriber<any>,\n  onNext?: (value: T) => void,\n  onComplete?: () => void,\n  onError?: (err: any) => void,\n  onFinalize?: () => void\n): Subscriber<T> {\n  return new OperatorSubscriber(destination, onNext, onComplete, onError, onFinalize);\n}\n\n/**\n * A generic helper for allowing operators to be created with a Subscriber and\n * use closures to capture necessary state from the operator function itself.\n */\nexport class OperatorSubscriber<T> extends Subscriber<T> {\n  /**\n   * Creates an instance of an `OperatorSubscriber`.\n   * @param destination The downstream subscriber.\n   * @param onNext Handles next values, only called if this subscriber is not stopped or closed. Any\n   * error that occurs in this function is caught and sent to the `error` method of this subscriber.\n   * @param onError Handles errors from the subscription, any errors that occur in this handler are caught\n   * and send to the `destination` error handler.\n   * @param onComplete Handles completion notification from the subscription. Any errors that occur in\n   * this handler are sent to the `destination` error handler.\n   * @param onFinalize Additional finalization logic here. This will only be called on finalization if the\n   * subscriber itself is not already closed. This is called after all other finalization logic is executed.\n   * @param shouldUnsubscribe An optional check to see if an unsubscribe call should truly unsubscribe.\n   * NOTE: This currently **ONLY** exists to support the strange behavior of {@link groupBy}, where unsubscription\n   * to the resulting observable does not actually disconnect from the source if there are active subscriptions\n   * to any grouped observable. (DO NOT EXPOSE OR USE EXTERNALLY!!!)\n   */\n  constructor(\n    destination: Subscriber<any>,\n    onNext?: (value: T) => void,\n    onComplete?: () => void,\n    onError?: (err: any) => void,\n    private onFinalize?: () => void,\n    private shouldUnsubscribe?: () => boolean\n  ) {\n    // It's important - for performance reasons - that all of this class's\n    // members are initialized and that they are always initialized in the same\n    // order. This will ensure that all OperatorSubscriber instances have the\n    // same hidden class in V8. This, in turn, will help keep the number of\n    // hidden classes involved in property accesses within the base class as\n    // low as possible. If the number of hidden classes involved exceeds four,\n    // the property accesses will become megamorphic and performance penalties\n    // will be incurred - i.e. inline caches won't be used.\n    //\n    // The reasons for ensuring all instances have the same hidden class are\n    // further discussed in this blog post from Benedikt Meurer:\n    // https://benediktmeurer.de/2018/03/23/impact-of-polymorphism-on-component-based-frameworks-like-react/\n    super(destination);\n    this._next = onNext\n      ? function (this: OperatorSubscriber<T>, value: T) {\n          try {\n            onNext(value);\n          } catch (err) {\n            destination.error(err);\n          }\n        }\n      : super._next;\n    this._error = onError\n      ? function (this: OperatorSubscriber<T>, err: any) {\n          try {\n            onError(err);\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._error;\n    this._complete = onComplete\n      ? function (this: OperatorSubscriber<T>) {\n          try {\n            onComplete();\n          } catch (err) {\n            // Send any errors that occur down stream.\n            destination.error(err);\n          } finally {\n            // Ensure finalization.\n            this.unsubscribe();\n          }\n        }\n      : super._complete;\n  }\n\n  unsubscribe() {\n    if (!this.shouldUnsubscribe || this.shouldUnsubscribe()) {\n      const { closed } = this;\n      super.unsubscribe();\n      // Execute additional teardown if we have any and we didn't already do so.\n      !closed && this.onFinalize?.();\n    }\n  }\n}\n", "import { Subscription } from '../Subscription';\n\ninterface AnimationFrameProvider {\n  schedule(callback: FrameRequestCallback): Subscription;\n  requestAnimationFrame: typeof requestAnimationFrame;\n  cancelAnimationFrame: typeof cancelAnimationFrame;\n  delegate:\n    | {\n        requestAnimationFrame: typeof requestAnimationFrame;\n        cancelAnimationFrame: typeof cancelAnimationFrame;\n      }\n    | undefined;\n}\n\nexport const animationFrameProvider: AnimationFrameProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  schedule(callback) {\n    let request = requestAnimationFrame;\n    let cancel: typeof cancelAnimationFrame | undefined = cancelAnimationFrame;\n    const { delegate } = animationFrameProvider;\n    if (delegate) {\n      request = delegate.requestAnimationFrame;\n      cancel = delegate.cancelAnimationFrame;\n    }\n    const handle = request((timestamp) => {\n      // Clear the cancel function. The request has been fulfilled, so\n      // attempting to cancel the request upon unsubscription would be\n      // pointless.\n      cancel = undefined;\n      callback(timestamp);\n    });\n    return new Subscription(() => cancel?.(handle));\n  },\n  requestAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.requestAnimationFrame || requestAnimationFrame)(...args);\n  },\n  cancelAnimationFrame(...args) {\n    const { delegate } = animationFrameProvider;\n    return (delegate?.cancelAnimationFrame || cancelAnimationFrame)(...args);\n  },\n  delegate: undefined,\n};\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface ObjectUnsubscribedError extends Error {}\n\nexport interface ObjectUnsubscribedErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): ObjectUnsubscribedError;\n}\n\n/**\n * An error thrown when an action is invalid because the object has been\n * unsubscribed.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n *\n * @class ObjectUnsubscribedError\n */\nexport const ObjectUnsubscribedError: ObjectUnsubscribedErrorCtor = createErrorClass(\n  (_super) =>\n    function ObjectUnsubscribedErrorImpl(this: any) {\n      _super(this);\n      this.name = 'ObjectUnsubscribedError';\n      this.message = 'object unsubscribed';\n    }\n);\n", "import { Operator } from './Operator';\nimport { Observable } from './Observable';\nimport { Subscriber } from './Subscriber';\nimport { Subscription, EMPTY_SUBSCRIPTION } from './Subscription';\nimport { Observer, SubscriptionLike, TeardownLogic } from './types';\nimport { ObjectUnsubscribedError } from './util/ObjectUnsubscribedError';\nimport { arrRemove } from './util/arrRemove';\nimport { errorContext } from './util/errorContext';\n\n/**\n * A Subject is a special type of Observable that allows values to be\n * multicasted to many Observers. Subjects are like EventEmitters.\n *\n * Every Subject is an Observable and an Observer. You can subscribe to a\n * Subject, and you can call next to feed values as well as error and complete.\n */\nexport class Subject<T> extends Observable<T> implements SubscriptionLike {\n  closed = false;\n\n  private currentObservers: Observer<T>[] | null = null;\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  observers: Observer<T>[] = [];\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  isStopped = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  hasError = false;\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  thrownError: any = null;\n\n  /**\n   * Creates a \"subject\" by basically gluing an observer to an observable.\n   *\n   * @nocollapse\n   * @deprecated Recommended you do not use. Will be removed at some point in the future. Plans for replacement still under discussion.\n   */\n  static create: (...args: any[]) => any = <T>(destination: Observer<T>, source: Observable<T>): AnonymousSubject<T> => {\n    return new AnonymousSubject<T>(destination, source);\n  };\n\n  constructor() {\n    // NOTE: This must be here to obscure Observable's constructor.\n    super();\n  }\n\n  /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n  lift<R>(operator: Operator<T, R>): Observable<R> {\n    const subject = new AnonymousSubject(this, this);\n    subject.operator = operator as any;\n    return subject as any;\n  }\n\n  /** @internal */\n  protected _throwIfClosed() {\n    if (this.closed) {\n      throw new ObjectUnsubscribedError();\n    }\n  }\n\n  next(value: T) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        if (!this.currentObservers) {\n          this.currentObservers = Array.from(this.observers);\n        }\n        for (const observer of this.currentObservers) {\n          observer.next(value);\n        }\n      }\n    });\n  }\n\n  error(err: any) {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.hasError = this.isStopped = true;\n        this.thrownError = err;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.error(err);\n        }\n      }\n    });\n  }\n\n  complete() {\n    errorContext(() => {\n      this._throwIfClosed();\n      if (!this.isStopped) {\n        this.isStopped = true;\n        const { observers } = this;\n        while (observers.length) {\n          observers.shift()!.complete();\n        }\n      }\n    });\n  }\n\n  unsubscribe() {\n    this.isStopped = this.closed = true;\n    this.observers = this.currentObservers = null!;\n  }\n\n  get observed() {\n    return this.observers?.length > 0;\n  }\n\n  /** @internal */\n  protected _trySubscribe(subscriber: Subscriber<T>): TeardownLogic {\n    this._throwIfClosed();\n    return super._trySubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._checkFinalizedStatuses(subscriber);\n    return this._innerSubscribe(subscriber);\n  }\n\n  /** @internal */\n  protected _innerSubscribe(subscriber: Subscriber<any>) {\n    const { hasError, isStopped, observers } = this;\n    if (hasError || isStopped) {\n      return EMPTY_SUBSCRIPTION;\n    }\n    this.currentObservers = null;\n    observers.push(subscriber);\n    return new Subscription(() => {\n      this.currentObservers = null;\n      arrRemove(observers, subscriber);\n    });\n  }\n\n  /** @internal */\n  protected _checkFinalizedStatuses(subscriber: Subscriber<any>) {\n    const { hasError, thrownError, isStopped } = this;\n    if (hasError) {\n      subscriber.error(thrownError);\n    } else if (isStopped) {\n      subscriber.complete();\n    }\n  }\n\n  /**\n   * Creates a new Observable with this Subject as the source. You can do this\n   * to create custom Observer-side logic of the Subject and conceal it from\n   * code that uses the Observable.\n   * @return {Observable} Observable that the Subject casts to\n   */\n  asObservable(): Observable<T> {\n    const observable: any = new Observable<T>();\n    observable.source = this;\n    return observable;\n  }\n}\n\n/**\n * @class AnonymousSubject<T>\n */\nexport class AnonymousSubject<T> extends Subject<T> {\n  constructor(\n    /** @deprecated Internal implementation detail, do not use directly. Will be made internal in v8. */\n    public destination?: Observer<T>,\n    source?: Observable<T>\n  ) {\n    super();\n    this.source = source;\n  }\n\n  next(value: T) {\n    this.destination?.next?.(value);\n  }\n\n  error(err: any) {\n    this.destination?.error?.(err);\n  }\n\n  complete() {\n    this.destination?.complete?.();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    return this.source?.subscribe(subscriber) ?? EMPTY_SUBSCRIPTION;\n  }\n}\n", "import { Subject } from './Subject';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\n\n/**\n * A variant of Subject that requires an initial value and emits its current\n * value whenever it is subscribed to.\n *\n * @class BehaviorSubject<T>\n */\nexport class BehaviorSubject<T> extends Subject<T> {\n  constructor(private _value: T) {\n    super();\n  }\n\n  get value(): T {\n    return this.getValue();\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    const subscription = super._subscribe(subscriber);\n    !subscription.closed && subscriber.next(this._value);\n    return subscription;\n  }\n\n  getValue(): T {\n    const { hasError, thrownError, _value } = this;\n    if (hasError) {\n      throw thrownError;\n    }\n    this._throwIfClosed();\n    return _value;\n  }\n\n  next(value: T): void {\n    super.next((this._value = value));\n  }\n}\n", "import { TimestampProvider } from '../types';\n\ninterface DateTimestampProvider extends TimestampProvider {\n  delegate: TimestampProvider | undefined;\n}\n\nexport const dateTimestampProvider: DateTimestampProvider = {\n  now() {\n    // Use the variable rather than `this` so that the function can be called\n    // without being bound to the provider.\n    return (dateTimestampProvider.delegate || Date).now();\n  },\n  delegate: undefined,\n};\n", "import { Subject } from './Subject';\nimport { TimestampProvider } from './types';\nimport { Subscriber } from './Subscriber';\nimport { Subscription } from './Subscription';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * A variant of {@link Subject} that \"replays\" old values to new subscribers by emitting them when they first subscribe.\n *\n * `ReplaySubject` has an internal buffer that will store a specified number of values that it has observed. Like `Subject`,\n * `ReplaySubject` \"observes\" values by having them passed to its `next` method. When it observes a value, it will store that\n * value for a time determined by the configuration of the `ReplaySubject`, as passed to its constructor.\n *\n * When a new subscriber subscribes to the `ReplaySubject` instance, it will synchronously emit all values in its buffer in\n * a First-In-First-Out (FIFO) manner. The `ReplaySubject` will also complete, if it has observed completion; and it will\n * error if it has observed an error.\n *\n * There are two main configuration items to be concerned with:\n *\n * 1. `bufferSize` - This will determine how many items are stored in the buffer, defaults to infinite.\n * 2. `windowTime` - The amount of time to hold a value in the buffer before removing it from the buffer.\n *\n * Both configurations may exist simultaneously. So if you would like to buffer a maximum of 3 values, as long as the values\n * are less than 2 seconds old, you could do so with a `new ReplaySubject(3, 2000)`.\n *\n * ### Differences with BehaviorSubject\n *\n * `BehaviorSubject` is similar to `new ReplaySubject(1)`, with a couple of exceptions:\n *\n * 1. `BehaviorSubject` comes \"primed\" with a single value upon construction.\n * 2. `ReplaySubject` will replay values, even after observing an error, where `BehaviorSubject` will not.\n *\n * @see {@link Subject}\n * @see {@link BehaviorSubject}\n * @see {@link shareReplay}\n */\nexport class ReplaySubject<T> extends Subject<T> {\n  private _buffer: (T | number)[] = [];\n  private _infiniteTimeWindow = true;\n\n  /**\n   * @param bufferSize The size of the buffer to replay on subscription\n   * @param windowTime The amount of time the buffered items will stay buffered\n   * @param timestampProvider An object with a `now()` method that provides the current timestamp. This is used to\n   * calculate the amount of time something has been buffered.\n   */\n  constructor(\n    private _bufferSize = Infinity,\n    private _windowTime = Infinity,\n    private _timestampProvider: TimestampProvider = dateTimestampProvider\n  ) {\n    super();\n    this._infiniteTimeWindow = _windowTime === Infinity;\n    this._bufferSize = Math.max(1, _bufferSize);\n    this._windowTime = Math.max(1, _windowTime);\n  }\n\n  next(value: T): void {\n    const { isStopped, _buffer, _infiniteTimeWindow, _timestampProvider, _windowTime } = this;\n    if (!isStopped) {\n      _buffer.push(value);\n      !_infiniteTimeWindow && _buffer.push(_timestampProvider.now() + _windowTime);\n    }\n    this._trimBuffer();\n    super.next(value);\n  }\n\n  /** @internal */\n  protected _subscribe(subscriber: Subscriber<T>): Subscription {\n    this._throwIfClosed();\n    this._trimBuffer();\n\n    const subscription = this._innerSubscribe(subscriber);\n\n    const { _infiniteTimeWindow, _buffer } = this;\n    // We use a copy here, so reentrant code does not mutate our array while we're\n    // emitting it to a new subscriber.\n    const copy = _buffer.slice();\n    for (let i = 0; i < copy.length && !subscriber.closed; i += _infiniteTimeWindow ? 1 : 2) {\n      subscriber.next(copy[i] as T);\n    }\n\n    this._checkFinalizedStatuses(subscriber);\n\n    return subscription;\n  }\n\n  private _trimBuffer() {\n    const { _bufferSize, _timestampProvider, _buffer, _infiniteTimeWindow } = this;\n    // If we don't have an infinite buffer size, and we're over the length,\n    // use splice to truncate the old buffer values off. Note that we have to\n    // double the size for instances where we're not using an infinite time window\n    // because we're storing the values and the timestamps in the same array.\n    const adjustedBufferSize = (_infiniteTimeWindow ? 1 : 2) * _bufferSize;\n    _bufferSize < Infinity && adjustedBufferSize < _buffer.length && _buffer.splice(0, _buffer.length - adjustedBufferSize);\n\n    // Now, if we're not in an infinite time window, remove all values where the time is\n    // older than what is allowed.\n    if (!_infiniteTimeWindow) {\n      const now = _timestampProvider.now();\n      let last = 0;\n      // Search the array for the first timestamp that isn't expired and\n      // truncate the buffer up to that point.\n      for (let i = 1; i < _buffer.length && (_buffer[i] as number) <= now; i += 2) {\n        last = i;\n      }\n      last && _buffer.splice(0, last + 1);\n    }\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Subscription } from '../Subscription';\nimport { SchedulerAction } from '../types';\n\n/**\n * A unit of work to be executed in a `scheduler`. An action is typically\n * created from within a {@link SchedulerLike} and an RxJS user does not need to concern\n * themselves about creating and manipulating an Action.\n *\n * ```ts\n * class Action<T> extends Subscription {\n *   new (scheduler: Scheduler, work: (state?: T) => void);\n *   schedule(state?: T, delay: number = 0): Subscription;\n * }\n * ```\n *\n * @class Action<T>\n */\nexport class Action<T> extends Subscription {\n  constructor(scheduler: Scheduler, work: (this: SchedulerAction<T>, state?: T) => void) {\n    super();\n  }\n  /**\n   * Schedules this action on its parent {@link SchedulerLike} for execution. May be passed\n   * some context object, `state`. May happen at some point in the future,\n   * according to the `delay` parameter, if specified.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler.\n   * @return {void}\n   */\n  public schedule(state?: T, delay: number = 0): Subscription {\n    return this;\n  }\n}\n", "import type { TimerHandle } from './timerHandle';\ntype SetIntervalFunction = (handler: () => void, timeout?: number, ...args: any[]) => TimerHandle;\ntype ClearIntervalFunction = (handle: TimerHandle) => void;\n\ninterface IntervalProvider {\n  setInterval: SetIntervalFunction;\n  clearInterval: ClearIntervalFunction;\n  delegate:\n    | {\n        setInterval: SetIntervalFunction;\n        clearInterval: ClearIntervalFunction;\n      }\n    | undefined;\n}\n\nexport const intervalProvider: IntervalProvider = {\n  // When accessing the delegate, use the variable rather than `this` so that\n  // the functions can be called without being bound to the provider.\n  setInterval(handler: () => void, timeout?: number, ...args) {\n    const { delegate } = intervalProvider;\n    if (delegate?.setInterval) {\n      return delegate.setInterval(handler, timeout, ...args);\n    }\n    return setInterval(handler, timeout, ...args);\n  },\n  clearInterval(handle) {\n    const { delegate } = intervalProvider;\n    return (delegate?.clearInterval || clearInterval)(handle as any);\n  },\n  delegate: undefined,\n};\n", "import { Action } from './Action';\nimport { SchedulerAction } from '../types';\nimport { Subscription } from '../Subscription';\nimport { AsyncScheduler } from './AsyncScheduler';\nimport { intervalProvider } from './intervalProvider';\nimport { arrRemove } from '../util/arrRemove';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncAction<T> extends Action<T> {\n  public id: TimerHandle | undefined;\n  public state?: T;\n  // @ts-ignore: Property has no initializer and is not definitely assigned\n  public delay: number;\n  protected pending: boolean = false;\n\n  constructor(protected scheduler: AsyncScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (this.closed) {\n      return this;\n    }\n\n    // Always replace the current state with the new state.\n    this.state = state;\n\n    const id = this.id;\n    const scheduler = this.scheduler;\n\n    //\n    // Important implementation note:\n    //\n    // Actions only execute once by default, unless rescheduled from within the\n    // scheduled callback. This allows us to implement single and repeat\n    // actions via the same code path, without adding API surface area, as well\n    // as mimic traditional recursion but across asynchronous boundaries.\n    //\n    // However, JS runtimes and timers distinguish between intervals achieved by\n    // serial `setTimeout` calls vs. a single `setInterval` call. An interval of\n    // serial `setTimeout` calls can be individually delayed, which delays\n    // scheduling the next `setTimeout`, and so on. `setInterval` attempts to\n    // guarantee the interval callback will be invoked more precisely to the\n    // interval period, regardless of load.\n    //\n    // Therefore, we use `setInterval` to schedule single and repeat actions.\n    // If the action reschedules itself with the same delay, the interval is not\n    // canceled. If the action doesn't reschedule, or reschedules with a\n    // different delay, the interval will be canceled after scheduled callback\n    // execution.\n    //\n    if (id != null) {\n      this.id = this.recycleAsyncId(scheduler, id, delay);\n    }\n\n    // Set the pending flag indicating that this action has been scheduled, or\n    // has recursively rescheduled itself.\n    this.pending = true;\n\n    this.delay = delay;\n    // If this action has already an async Id, don't request a new one.\n    this.id = this.id ?? this.requestAsyncId(scheduler, this.id, delay);\n\n    return this;\n  }\n\n  protected requestAsyncId(scheduler: AsyncScheduler, _id?: TimerHandle, delay: number = 0): TimerHandle {\n    return intervalProvider.setInterval(scheduler.flush.bind(scheduler, this), delay);\n  }\n\n  protected recycleAsyncId(_scheduler: AsyncScheduler, id?: TimerHandle, delay: number | null = 0): TimerHandle | undefined {\n    // If this action is rescheduled with the same delay time, don't clear the interval id.\n    if (delay != null && this.delay === delay && this.pending === false) {\n      return id;\n    }\n    // Otherwise, if the action's delay time is different from the current delay,\n    // or the action has been rescheduled before it's executed, clear the interval id\n    if (id != null) {\n      intervalProvider.clearInterval(id);\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Immediately executes this action and the `work` it contains.\n   * @return {any}\n   */\n  public execute(state: T, delay: number): any {\n    if (this.closed) {\n      return new Error('executing a cancelled action');\n    }\n\n    this.pending = false;\n    const error = this._execute(state, delay);\n    if (error) {\n      return error;\n    } else if (this.pending === false && this.id != null) {\n      // Dequeue if the action didn't reschedule itself. Don't call\n      // unsubscribe(), because the action could reschedule later.\n      // For example:\n      // ```\n      // scheduler.schedule(function doWork(counter) {\n      //   /* ... I'm a busy worker bee ... */\n      //   var originalAction = this;\n      //   /* wait 100ms before rescheduling the action */\n      //   setTimeout(function () {\n      //     originalAction.schedule(counter + 1);\n      //   }, 100);\n      // }, 1000);\n      // ```\n      this.id = this.recycleAsyncId(this.scheduler, this.id, null);\n    }\n  }\n\n  protected _execute(state: T, _delay: number): any {\n    let errored: boolean = false;\n    let errorValue: any;\n    try {\n      this.work(state);\n    } catch (e) {\n      errored = true;\n      // HACK: Since code elsewhere is relying on the \"truthiness\" of the\n      // return here, we can't have it return \"\" or 0 or false.\n      // TODO: Clean this up when we refactor schedulers mid-version-8 or so.\n      errorValue = e ? e : new Error('Scheduled action threw falsy error');\n    }\n    if (errored) {\n      this.unsubscribe();\n      return errorValue;\n    }\n  }\n\n  unsubscribe() {\n    if (!this.closed) {\n      const { id, scheduler } = this;\n      const { actions } = scheduler;\n\n      this.work = this.state = this.scheduler = null!;\n      this.pending = false;\n\n      arrRemove(actions, this);\n      if (id != null) {\n        this.id = this.recycleAsyncId(scheduler, id, null);\n      }\n\n      this.delay = null!;\n      super.unsubscribe();\n    }\n  }\n}\n", "import { Action } from './scheduler/Action';\nimport { Subscription } from './Subscription';\nimport { SchedulerLike, SchedulerAction } from './types';\nimport { dateTimestampProvider } from './scheduler/dateTimestampProvider';\n\n/**\n * An execution context and a data structure to order tasks and schedule their\n * execution. Provides a notion of (potentially virtual) time, through the\n * `now()` getter method.\n *\n * Each unit of work in a Scheduler is called an `Action`.\n *\n * ```ts\n * class Scheduler {\n *   now(): number;\n *   schedule(work, delay?, state?): Subscription;\n * }\n * ```\n *\n * @class Scheduler\n * @deprecated Scheduler is an internal implementation detail of RxJS, and\n * should not be used directly. Rather, create your own class and implement\n * {@link SchedulerLike}. Will be made internal in v8.\n */\nexport class Scheduler implements SchedulerLike {\n  public static now: () => number = dateTimestampProvider.now;\n\n  constructor(private schedulerActionCtor: typeof Action, now: () => number = Scheduler.now) {\n    this.now = now;\n  }\n\n  /**\n   * A getter method that returns a number representing the current time\n   * (at the time this function was called) according to the scheduler's own\n   * internal clock.\n   * @return {number} A number that represents the current time. May or may not\n   * have a relation to wall-clock time. May or may not refer to a time unit\n   * (e.g. milliseconds).\n   */\n  public now: () => number;\n\n  /**\n   * Schedules a function, `work`, for execution. May happen at some point in\n   * the future, according to the `delay` parameter, if specified. May be passed\n   * some context object, `state`, which will be passed to the `work` function.\n   *\n   * The given arguments will be processed an stored as an Action object in a\n   * queue of actions.\n   *\n   * @param {function(state: ?T): ?Subscription} work A function representing a\n   * task, or some unit of work to be executed by the Scheduler.\n   * @param {number} [delay] Time to wait before executing the work, where the\n   * time unit is implicit and defined by the Scheduler itself.\n   * @param {T} [state] Some contextual data that the `work` function uses when\n   * called by the Scheduler.\n   * @return {Subscription} A subscription in order to be able to unsubscribe\n   * the scheduled work.\n   */\n  public schedule<T>(work: (this: SchedulerAction<T>, state?: T) => void, delay: number = 0, state?: T): Subscription {\n    return new this.schedulerActionCtor<T>(this, work).schedule(state, delay);\n  }\n}\n", "import { Scheduler } from '../Scheduler';\nimport { Action } from './Action';\nimport { AsyncAction } from './AsyncAction';\nimport { TimerHandle } from './timerHandle';\n\nexport class AsyncScheduler extends Scheduler {\n  public actions: Array<AsyncAction<any>> = [];\n  /**\n   * A flag to indicate whether the Scheduler is currently executing a batch of\n   * queued actions.\n   * @type {boolean}\n   * @internal\n   */\n  public _active: boolean = false;\n  /**\n   * An internal ID used to track the latest asynchronous task such as those\n   * coming from `setTimeout`, `setInterval`, `requestAnimationFrame`, and\n   * others.\n   * @type {any}\n   * @internal\n   */\n  public _scheduled: TimerHandle | undefined;\n\n  constructor(SchedulerAction: typeof Action, now: () => number = Scheduler.now) {\n    super(SchedulerAction, now);\n  }\n\n  public flush(action: AsyncAction<any>): void {\n    const { actions } = this;\n\n    if (this._active) {\n      actions.push(action);\n      return;\n    }\n\n    let error: any;\n    this._active = true;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions.shift()!)); // exhaust the scheduler queue\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions.shift()!)) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\n/**\n *\n * Async Scheduler\n *\n * <span class=\"informal\">Schedule task as if you used setTimeout(task, duration)</span>\n *\n * `async` scheduler schedules tasks asynchronously, by putting them on the JavaScript\n * event loop queue. It is best used to delay tasks in time or to schedule tasks repeating\n * in intervals.\n *\n * If you just want to \"defer\" task, that is to perform it right after currently\n * executing synchronous code ends (commonly achieved by `setTimeout(deferredTask, 0)`),\n * better choice will be the {@link asapScheduler} scheduler.\n *\n * ## Examples\n * Use async scheduler to delay task\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * const task = () => console.log('it works!');\n *\n * asyncScheduler.schedule(task, 2000);\n *\n * // After 2 seconds logs:\n * // \"it works!\"\n * ```\n *\n * Use async scheduler to repeat task in intervals\n * ```ts\n * import { asyncScheduler } from 'rxjs';\n *\n * function task(state) {\n *   console.log(state);\n *   this.schedule(state + 1, 1000); // `this` references currently executing Action,\n *                                   // which we reschedule with new state and delay\n * }\n *\n * asyncScheduler.schedule(task, 3000, 0);\n *\n * // Logs:\n * // 0 after 3s\n * // 1 after 4s\n * // 2 after 5s\n * // 3 after 6s\n * ```\n */\n\nexport const asyncScheduler = new AsyncScheduler(AsyncAction);\n\n/**\n * @deprecated Renamed to {@link asyncScheduler}. Will be removed in v8.\n */\nexport const async = asyncScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { Subscription } from '../Subscription';\nimport { QueueScheduler } from './QueueScheduler';\nimport { SchedulerAction } from '../types';\nimport { TimerHandle } from './timerHandle';\n\nexport class QueueAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: QueueScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  public schedule(state?: T, delay: number = 0): Subscription {\n    if (delay > 0) {\n      return super.schedule(state, delay);\n    }\n    this.delay = delay;\n    this.state = state;\n    this.scheduler.flush(this);\n    return this;\n  }\n\n  public execute(state: T, delay: number): any {\n    return delay > 0 || this.closed ? super.execute(state, delay) : this._execute(state, delay);\n  }\n\n  protected requestAsyncId(scheduler: QueueScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n\n    if ((delay != null && delay > 0) || (delay == null && this.delay > 0)) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n\n    // Otherwise flush the scheduler starting with this action.\n    scheduler.flush(this);\n\n    // HACK: In the past, this was returning `void`. However, `void` isn't a valid\n    // `TimerHandle`, and generally the return value here isn't really used. So the\n    // compromise is to return `0` which is both \"falsy\" and a valid `TimerHandle`,\n    // as opposed to refactoring every other instanceo of `requestAsyncId`.\n    return 0;\n  }\n}\n", "import { AsyncScheduler } from './AsyncScheduler';\n\nexport class QueueScheduler extends AsyncScheduler {\n}\n", "import { QueueAction } from './QueueAction';\nimport { QueueScheduler } from './QueueScheduler';\n\n/**\n *\n * Queue Scheduler\n *\n * <span class=\"informal\">Put every next task on a queue, instead of executing it immediately</span>\n *\n * `queue` scheduler, when used with delay, behaves the same as {@link asyncScheduler} scheduler.\n *\n * When used without delay, it schedules given task synchronously - executes it right when\n * it is scheduled. However when called recursively, that is when inside the scheduled task,\n * another task is scheduled with queue scheduler, instead of executing immediately as well,\n * that task will be put on a queue and wait for current one to finish.\n *\n * This means that when you execute task with `queue` scheduler, you are sure it will end\n * before any other task scheduled with that scheduler will start.\n *\n * ## Examples\n * Schedule recursively first, then do something\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(() => {\n *   queueScheduler.schedule(() => console.log('second')); // will not happen now, but will be put on a queue\n *\n *   console.log('first');\n * });\n *\n * // Logs:\n * // \"first\"\n * // \"second\"\n * ```\n *\n * Reschedule itself recursively\n * ```ts\n * import { queueScheduler } from 'rxjs';\n *\n * queueScheduler.schedule(function(state) {\n *   if (state !== 0) {\n *     console.log('before', state);\n *     this.schedule(state - 1); // `this` references currently executing Action,\n *                               // which we reschedule with new state\n *     console.log('after', state);\n *   }\n * }, 0, 3);\n *\n * // In scheduler that runs recursively, you would expect:\n * // \"before\", 3\n * // \"before\", 2\n * // \"before\", 1\n * // \"after\", 1\n * // \"after\", 2\n * // \"after\", 3\n *\n * // But with queue it logs:\n * // \"before\", 3\n * // \"after\", 3\n * // \"before\", 2\n * // \"after\", 2\n * // \"before\", 1\n * // \"after\", 1\n * ```\n */\n\nexport const queueScheduler = new QueueScheduler(QueueAction);\n\n/**\n * @deprecated Renamed to {@link queueScheduler}. Will be removed in v8.\n */\nexport const queue = queueScheduler;\n", "import { AsyncAction } from './AsyncAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\nimport { SchedulerAction } from '../types';\nimport { animationFrameProvider } from './animationFrameProvider';\nimport { TimerHandle } from './timerHandle';\n\nexport class AnimationFrameAction<T> extends AsyncAction<T> {\n  constructor(protected scheduler: AnimationFrameScheduler, protected work: (this: SchedulerAction<T>, state?: T) => void) {\n    super(scheduler, work);\n  }\n\n  protected requestAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle {\n    // If delay is greater than 0, request as an async action.\n    if (delay !== null && delay > 0) {\n      return super.requestAsyncId(scheduler, id, delay);\n    }\n    // Push the action to the end of the scheduler queue.\n    scheduler.actions.push(this);\n    // If an animation frame has already been requested, don't request another\n    // one. If an animation frame hasn't been requested yet, request one. Return\n    // the current animation frame request id.\n    return scheduler._scheduled || (scheduler._scheduled = animationFrameProvider.requestAnimationFrame(() => scheduler.flush(undefined)));\n  }\n\n  protected recycleAsyncId(scheduler: AnimationFrameScheduler, id?: TimerHandle, delay: number = 0): TimerHandle | undefined {\n    // If delay exists and is greater than 0, or if the delay is null (the\n    // action wasn't rescheduled) but was originally scheduled as an async\n    // action, then recycle as an async action.\n    if (delay != null ? delay > 0 : this.delay > 0) {\n      return super.recycleAsyncId(scheduler, id, delay);\n    }\n    // If the scheduler queue has no remaining actions with the same async id,\n    // cancel the requested animation frame and set the scheduled flag to\n    // undefined so the next AnimationFrameAction will request its own.\n    const { actions } = scheduler;\n    if (id != null && actions[actions.length - 1]?.id !== id) {\n      animationFrameProvider.cancelAnimationFrame(id as number);\n      scheduler._scheduled = undefined;\n    }\n    // Return undefined so the action knows to request a new async id if it's rescheduled.\n    return undefined;\n  }\n}\n", "import { AsyncAction } from './AsyncAction';\nimport { AsyncScheduler } from './AsyncScheduler';\n\nexport class AnimationFrameScheduler extends AsyncScheduler {\n  public flush(action?: AsyncAction<any>): void {\n    this._active = true;\n    // The async id that effects a call to flush is stored in _scheduled.\n    // Before executing an action, it's necessary to check the action's async\n    // id to determine whether it's supposed to be executed in the current\n    // flush.\n    // Previous implementations of this method used a count to determine this,\n    // but that was unsound, as actions that are unsubscribed - i.e. cancelled -\n    // are removed from the actions array and that can shift actions that are\n    // scheduled to be executed in a subsequent flush into positions at which\n    // they are executed within the current flush.\n    const flushId = this._scheduled;\n    this._scheduled = undefined;\n\n    const { actions } = this;\n    let error: any;\n    action = action || actions.shift()!;\n\n    do {\n      if ((error = action.execute(action.state, action.delay))) {\n        break;\n      }\n    } while ((action = actions[0]) && action.id === flushId && actions.shift());\n\n    this._active = false;\n\n    if (error) {\n      while ((action = actions[0]) && action.id === flushId && actions.shift()) {\n        action.unsubscribe();\n      }\n      throw error;\n    }\n  }\n}\n", "import { AnimationFrameAction } from './AnimationFrameAction';\nimport { AnimationFrameScheduler } from './AnimationFrameScheduler';\n\n/**\n *\n * Animation Frame Scheduler\n *\n * <span class=\"informal\">Perform task when `window.requestAnimationFrame` would fire</span>\n *\n * When `animationFrame` scheduler is used with delay, it will fall back to {@link asyncScheduler} scheduler\n * behaviour.\n *\n * Without delay, `animationFrame` scheduler can be used to create smooth browser animations.\n * It makes sure scheduled task will happen just before next browser content repaint,\n * thus performing animations as efficiently as possible.\n *\n * ## Example\n * Schedule div height animation\n * ```ts\n * // html: <div style=\"background: #0ff;\"></div>\n * import { animationFrameScheduler } from 'rxjs';\n *\n * const div = document.querySelector('div');\n *\n * animationFrameScheduler.schedule(function(height) {\n *   div.style.height = height + \"px\";\n *\n *   this.schedule(height + 1);  // `this` references currently executing Action,\n *                               // which we reschedule with new state\n * }, 0, 0);\n *\n * // You will see a div element growing in height\n * ```\n */\n\nexport const animationFrameScheduler = new AnimationFrameScheduler(AnimationFrameAction);\n\n/**\n * @deprecated Renamed to {@link animationFrameScheduler}. Will be removed in v8.\n */\nexport const animationFrame = animationFrameScheduler;\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\n/**\n * A simple Observable that emits no items to the Observer and immediately\n * emits a complete notification.\n *\n * <span class=\"informal\">Just emits 'complete', and nothing else.</span>\n *\n * ![](empty.png)\n *\n * A simple Observable that only emits the complete notification. It can be used\n * for composing with other Observables, such as in a {@link mergeMap}.\n *\n * ## Examples\n *\n * Log complete notification\n *\n * ```ts\n * import { EMPTY } from 'rxjs';\n *\n * EMPTY.subscribe({\n *   next: () => console.log('Next'),\n *   complete: () => console.log('Complete!')\n * });\n *\n * // Outputs\n * // Complete!\n * ```\n *\n * Emit the number 7, then complete\n *\n * ```ts\n * import { EMPTY, startWith } from 'rxjs';\n *\n * const result = EMPTY.pipe(startWith(7));\n * result.subscribe(x => console.log(x));\n *\n * // Outputs\n * // 7\n * ```\n *\n * Map and flatten only odd numbers to the sequence `'a'`, `'b'`, `'c'`\n *\n * ```ts\n * import { interval, mergeMap, of, EMPTY } from 'rxjs';\n *\n * const interval$ = interval(1000);\n * const result = interval$.pipe(\n *   mergeMap(x => x % 2 === 1 ? of('a', 'b', 'c') : EMPTY),\n * );\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following to the console:\n * // x is equal to the count on the interval, e.g. (0, 1, 2, 3, ...)\n * // x will occur every 1000ms\n * // if x % 2 is equal to 1, print a, b, c (each on its own)\n * // if x % 2 is not equal to 1, nothing will be output\n * ```\n *\n * @see {@link Observable}\n * @see {@link NEVER}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const EMPTY = new Observable<never>((subscriber) => subscriber.complete());\n\n/**\n * @param scheduler A {@link SchedulerLike} to use for scheduling\n * the emission of the complete notification.\n * @deprecated Replaced with the {@link EMPTY} constant or {@link scheduled} (e.g. `scheduled([], scheduler)`). Will be removed in v8.\n */\nexport function empty(scheduler?: SchedulerLike) {\n  return scheduler ? emptyScheduled(scheduler) : EMPTY;\n}\n\nfunction emptyScheduled(scheduler: SchedulerLike) {\n  return new Observable<never>((subscriber) => scheduler.schedule(() => subscriber.complete()));\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport function isScheduler(value: any): value is SchedulerLike {\n  return value && isFunction(value.schedule);\n}\n", "import { SchedulerLike } from '../types';\nimport { isFunction } from './isFunction';\nimport { isScheduler } from './isScheduler';\n\nfunction last<T>(arr: T[]): T | undefined {\n  return arr[arr.length - 1];\n}\n\nexport function popResultSelector(args: any[]): ((...args: unknown[]) => unknown) | undefined {\n  return isFunction(last(args)) ? args.pop() : undefined;\n}\n\nexport function popScheduler(args: any[]): SchedulerLike | undefined {\n  return isScheduler(last(args)) ? args.pop() : undefined;\n}\n\nexport function popNumber(args: any[], defaultValue: number): number {\n  return typeof last(args) === 'number' ? args.pop()! : defaultValue;\n}\n", "export const isArrayLike = (<T>(x: any): x is ArrayLike<T> => x && typeof x.length === 'number' && typeof x !== 'function');", "import { isFunction } from \"./isFunction\";\n\n/**\n * Tests to see if the object is \"thennable\".\n * @param value the object to test\n */\nexport function isPromise(value: any): value is PromiseLike<any> {\n  return isFunction(value?.then);\n}\n", "import { InteropObservable } from '../types';\nimport { observable as Symbol_observable } from '../symbol/observable';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being Observable (but not necessary an Rx Observable) */\nexport function isInteropObservable(input: any): input is InteropObservable<any> {\n  return isFunction(input[Symbol_observable]);\n}\n", "import { isFunction } from './isFunction';\n\nexport function isAsyncIterable<T>(obj: any): obj is AsyncIterable<T> {\n  return Symbol.asyncIterator && isFunction(obj?.[Symbol.asyncIterator]);\n}\n", "/**\n * Creates the TypeError to throw if an invalid object is passed to `from` or `scheduled`.\n * @param input The object that was passed.\n */\nexport function createInvalidObservableTypeError(input: any) {\n  // TODO: We should create error codes that can be looked up, so this can be less verbose.\n  return new TypeError(\n    `You provided ${\n      input !== null && typeof input === 'object' ? 'an invalid object' : `'${input}'`\n    } where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.`\n  );\n}\n", "export function getSymbolIterator(): symbol {\n  if (typeof Symbol !== 'function' || !Symbol.iterator) {\n    return '@@iterator' as any;\n  }\n\n  return Symbol.iterator;\n}\n\nexport const iterator = getSymbolIterator();\n", "import { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from './isFunction';\n\n/** Identifies an input as being an Iterable */\nexport function isIterable(input: any): input is Iterable<any> {\n  return isFunction(input?.[Symbol_iterator]);\n}\n", "import { ReadableStreamLike } from '../types';\nimport { isFunction } from './isFunction';\n\nexport async function* readableStreamLikeToAsyncGenerator<T>(readableStream: ReadableStreamLike<T>): AsyncGenerator<T> {\n  const reader = readableStream.getReader();\n  try {\n    while (true) {\n      const { value, done } = await reader.read();\n      if (done) {\n        return;\n      }\n      yield value!;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nexport function isReadableStreamLike<T>(obj: any): obj is ReadableStreamLike<T> {\n  // We don't want to use instanceof checks because they would return\n  // false for instances from another Realm, like an <iframe>.\n  return isFunction(obj?.getReader);\n}\n", "import { isArrayLike } from '../util/isArrayLike';\nimport { isPromise } from '../util/isPromise';\nimport { Observable } from '../Observable';\nimport { ObservableInput, ObservedValueOf, ReadableStreamLike } from '../types';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isIterable } from '../util/isIterable';\nimport { isReadableStreamLike, readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\nimport { Subscriber } from '../Subscriber';\nimport { isFunction } from '../util/isFunction';\nimport { reportUnhandledError } from '../util/reportUnhandledError';\nimport { observable as Symbol_observable } from '../symbol/observable';\n\nexport function innerFrom<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\nexport function innerFrom<T>(input: ObservableInput<T>): Observable<T> {\n  if (input instanceof Observable) {\n    return input;\n  }\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return fromInteropObservable(input);\n    }\n    if (isArrayLike(input)) {\n      return fromArrayLike(input);\n    }\n    if (isPromise(input)) {\n      return fromPromise(input);\n    }\n    if (isAsyncIterable(input)) {\n      return fromAsyncIterable(input);\n    }\n    if (isIterable(input)) {\n      return fromIterable(input);\n    }\n    if (isReadableStreamLike(input)) {\n      return fromReadableStreamLike(input);\n    }\n  }\n\n  throw createInvalidObservableTypeError(input);\n}\n\n/**\n * Creates an RxJS Observable from an object that implements `Symbol.observable`.\n * @param obj An object that properly implements `Symbol.observable`.\n */\nexport function fromInteropObservable<T>(obj: any) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    const obs = obj[Symbol_observable]();\n    if (isFunction(obs.subscribe)) {\n      return obs.subscribe(subscriber);\n    }\n    // Should be caught by observable subscribe function error handling.\n    throw new TypeError('Provided object does not correctly implement Symbol.observable');\n  });\n}\n\n/**\n * Synchronously emits the values of an array like and completes.\n * This is exported because there are creation functions and operators that need to\n * make direct use of the same logic, and there's no reason to make them run through\n * `from` conditionals because we *know* they're dealing with an array.\n * @param array The array to emit values from\n */\nexport function fromArrayLike<T>(array: ArrayLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    // Loop over the array and emit each value. Note two things here:\n    // 1. We're making sure that the subscriber is not closed on each loop.\n    //    This is so we don't continue looping over a very large array after\n    //    something like a `take`, `takeWhile`, or other synchronous unsubscription\n    //    has already unsubscribed.\n    // 2. In this form, reentrant code can alter that array we're looping over.\n    //    This is a known issue, but considered an edge case. The alternative would\n    //    be to copy the array before executing the loop, but this has\n    //    performance implications.\n    for (let i = 0; i < array.length && !subscriber.closed; i++) {\n      subscriber.next(array[i]);\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromPromise<T>(promise: PromiseLike<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    promise\n      .then(\n        (value) => {\n          if (!subscriber.closed) {\n            subscriber.next(value);\n            subscriber.complete();\n          }\n        },\n        (err: any) => subscriber.error(err)\n      )\n      .then(null, reportUnhandledError);\n  });\n}\n\nexport function fromIterable<T>(iterable: Iterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    for (const value of iterable) {\n      subscriber.next(value);\n      if (subscriber.closed) {\n        return;\n      }\n    }\n    subscriber.complete();\n  });\n}\n\nexport function fromAsyncIterable<T>(asyncIterable: AsyncIterable<T>) {\n  return new Observable((subscriber: Subscriber<T>) => {\n    process(asyncIterable, subscriber).catch((err) => subscriber.error(err));\n  });\n}\n\nexport function fromReadableStreamLike<T>(readableStream: ReadableStreamLike<T>) {\n  return fromAsyncIterable(readableStreamLikeToAsyncGenerator(readableStream));\n}\n\nasync function process<T>(asyncIterable: AsyncIterable<T>, subscriber: Subscriber<T>) {\n  for await (const value of asyncIterable) {\n    subscriber.next(value);\n    // A side-effect may have closed our subscriber,\n    // check before the next iteration.\n    if (subscriber.closed) {\n      return;\n    }\n  }\n  subscriber.complete();\n}\n", "import { Subscription } from '../Subscription';\nimport { SchedulerAction, SchedulerLike } from '../types';\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay: number,\n  repeat: true\n): void;\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay?: number,\n  repeat?: false\n): Subscription;\n\nexport function executeSchedule(\n  parentSubscription: Subscription,\n  scheduler: SchedulerLike,\n  work: () => void,\n  delay = 0,\n  repeat = false\n): Subscription | void {\n  const scheduleSubscription = scheduler.schedule(function (this: SchedulerAction<any>) {\n    work();\n    if (repeat) {\n      parentSubscription.add(this.schedule(null, delay));\n    } else {\n      this.unsubscribe();\n    }\n  }, delay);\n\n  parentSubscription.add(scheduleSubscription);\n\n  if (!repeat) {\n    // Because user-land scheduler implementations are unlikely to properly reuse\n    // Actions for repeat scheduling, we can't trust that the returned subscription\n    // will control repeat subscription scenarios. So we're trying to avoid using them\n    // incorrectly within this library.\n    return scheduleSubscription;\n  }\n}\n", "/** @prettier */\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Re-emits all notifications from source Observable with specified scheduler.\n *\n * <span class=\"informal\">Ensure a specific scheduler is used, from outside of an Observable.</span>\n *\n * `observeOn` is an operator that accepts a scheduler as a first parameter, which will be used to reschedule\n * notifications emitted by the source Observable. It might be useful, if you do not have control over\n * internal scheduler of a given Observable, but want to control when its values are emitted nevertheless.\n *\n * Returned Observable emits the same notifications (nexted values, complete and error events) as the source Observable,\n * but rescheduled with provided scheduler. Note that this doesn't mean that source Observables internal\n * scheduler will be replaced in any way. Original scheduler still will be used, but when the source Observable emits\n * notification, it will be immediately scheduled again - this time with scheduler passed to `observeOn`.\n * An anti-pattern would be calling `observeOn` on Observable that emits lots of values synchronously, to split\n * that emissions into asynchronous chunks. For this to happen, scheduler would have to be passed into the source\n * Observable directly (usually into the operator that creates it). `observeOn` simply delays notifications a\n * little bit more, to ensure that they are emitted at expected moments.\n *\n * As a matter of fact, `observeOn` accepts second parameter, which specifies in milliseconds with what delay notifications\n * will be emitted. The main difference between {@link delay} operator and `observeOn` is that `observeOn`\n * will delay all notifications - including error notifications - while `delay` will pass through error\n * from source Observable immediately when it is emitted. In general it is highly recommended to use `delay` operator\n * for any kind of delaying of values in the stream, while using `observeOn` to specify which scheduler should be used\n * for notification emissions in general.\n *\n * ## Example\n *\n * Ensure values in subscribe are called just before browser repaint\n *\n * ```ts\n * import { interval, observeOn, animationFrameScheduler } from 'rxjs';\n *\n * const someDiv = document.createElement('div');\n * someDiv.style.cssText = 'width: 200px;background: #09c';\n * document.body.appendChild(someDiv);\n * const intervals = interval(10);      // Intervals are scheduled\n *                                      // with async scheduler by default...\n * intervals.pipe(\n *   observeOn(animationFrameScheduler) // ...but we will observe on animationFrame\n * )                                    // scheduler to ensure smooth animation.\n * .subscribe(val => {\n *   someDiv.style.height = val + 'px';\n * });\n * ```\n *\n * @see {@link delay}\n *\n * @param scheduler Scheduler that will be used to reschedule notifications from source Observable.\n * @param delay Number of milliseconds that states with what delay every notification should be rescheduled.\n * @return A function that returns an Observable that emits the same\n * notifications as the source Observable, but with provided scheduler.\n */\nexport function observeOn<T>(scheduler: SchedulerLike, delay = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => executeSchedule(subscriber, scheduler, () => subscriber.next(value), delay),\n        () => executeSchedule(subscriber, scheduler, () => subscriber.complete(), delay),\n        (err) => executeSchedule(subscriber, scheduler, () => subscriber.error(err), delay)\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Asynchronously subscribes Observers to this Observable on the specified {@link SchedulerLike}.\n *\n * With `subscribeOn` you can decide what type of scheduler a specific Observable will be using when it is subscribed to.\n *\n * Schedulers control the speed and order of emissions to observers from an Observable stream.\n *\n * ![](subscribeOn.png)\n *\n * ## Example\n *\n * Given the following code:\n *\n * ```ts\n * import { of, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3);\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 1\n * // 2\n * // 3\n * // 4\n * // 5\n * // 6\n * ```\n *\n * Both Observable `a` and `b` will emit their values directly and synchronously once they are subscribed to.\n *\n * If we instead use the `subscribeOn` operator declaring that we want to use the {@link asyncScheduler} for values emitted by Observable `a`:\n *\n * ```ts\n * import { of, subscribeOn, asyncScheduler, merge } from 'rxjs';\n *\n * const a = of(1, 2, 3).pipe(subscribeOn(asyncScheduler));\n * const b = of(4, 5, 6);\n *\n * merge(a, b).subscribe(console.log);\n *\n * // Outputs\n * // 4\n * // 5\n * // 6\n * // 1\n * // 2\n * // 3\n * ```\n *\n * The reason for this is that Observable `b` emits its values directly and synchronously like before\n * but the emissions from `a` are scheduled on the event loop because we are now using the {@link asyncScheduler} for that specific Observable.\n *\n * @param scheduler The {@link SchedulerLike} to perform subscription actions on.\n * @param delay A delay to pass to the scheduler to delay subscriptions\n * @return A function that returns an Observable modified so that its\n * subscriptions happen on the specified {@link SchedulerLike}.\n */\nexport function subscribeOn<T>(scheduler: SchedulerLike, delay: number = 0): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    subscriber.add(scheduler.schedule(() => source.subscribe(subscriber), delay));\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { InteropObservable, SchedulerLike } from '../types';\n\nexport function scheduleObservable<T>(input: InteropObservable<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { observeOn } from '../operators/observeOn';\nimport { subscribeOn } from '../operators/subscribeOn';\nimport { SchedulerLike } from '../types';\n\nexport function schedulePromise<T>(input: PromiseLike<T>, scheduler: SchedulerLike) {\n  return innerFrom(input).pipe(subscribeOn(scheduler), observeOn(scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\n\nexport function scheduleArray<T>(input: ArrayLike<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    // The current array index.\n    let i = 0;\n    // Start iterating over the array like on a schedule.\n    return scheduler.schedule(function () {\n      if (i === input.length) {\n        // If we have hit the end of the array like in the\n        // previous job, we can complete.\n        subscriber.complete();\n      } else {\n        // Otherwise let's next the value at the current index,\n        // then increment our index.\n        subscriber.next(input[i++]);\n        // If the last emission didn't cause us to close the subscriber\n        // (via take or some side effect), reschedule the job and we'll\n        // make another pass.\n        if (!subscriber.closed) {\n          this.schedule();\n        }\n      }\n    });\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { iterator as Symbol_iterator } from '../symbol/iterator';\nimport { isFunction } from '../util/isFunction';\nimport { executeSchedule } from '../util/executeSchedule';\n\n/**\n * Used in {@link scheduled} to create an observable from an Iterable.\n * @param input The iterable to create an observable from\n * @param scheduler The scheduler to use\n */\nexport function scheduleIterable<T>(input: Iterable<T>, scheduler: SchedulerLike) {\n  return new Observable<T>((subscriber) => {\n    let iterator: Iterator<T, T>;\n\n    // Schedule the initial creation of the iterator from\n    // the iterable. This is so the code in the iterable is\n    // not called until the scheduled job fires.\n    executeSchedule(subscriber, scheduler, () => {\n      // Create the iterator.\n      iterator = (input as any)[Symbol_iterator]();\n\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          let value: T;\n          let done: boolean | undefined;\n          try {\n            // Pull the value out of the iterator\n            ({ value, done } = iterator.next());\n          } catch (err) {\n            // We got an error while pulling from the iterator\n            subscriber.error(err);\n            return;\n          }\n\n          if (done) {\n            // If it is \"done\" we just complete. This mimics the\n            // behavior of JavaScript's `for..of` consumption of\n            // iterables, which will not emit the value from an iterator\n            // result of `{ done: true: value: 'here' }`.\n            subscriber.complete();\n          } else {\n            // The iterable is not done, emit the value.\n            subscriber.next(value);\n          }\n        },\n        0,\n        true\n      );\n    });\n\n    // During finalization, if we see this iterator has a `return` method,\n    // then we know it is a Generator, and not just an Iterator. So we call\n    // the `return()` function. This will ensure that any `finally { }` blocks\n    // inside of the generator we can hit will be hit properly.\n    return () => isFunction(iterator?.return) && iterator.return();\n  });\n}\n", "import { SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { executeSchedule } from '../util/executeSchedule';\n\nexport function scheduleAsyncIterable<T>(input: AsyncIterable<T>, scheduler: SchedulerLike) {\n  if (!input) {\n    throw new Error('Iterable cannot be null');\n  }\n  return new Observable<T>((subscriber) => {\n    executeSchedule(subscriber, scheduler, () => {\n      const iterator = input[Symbol.asyncIterator]();\n      executeSchedule(\n        subscriber,\n        scheduler,\n        () => {\n          iterator.next().then((result) => {\n            if (result.done) {\n              // This will remove the subscriptions from\n              // the parent subscription.\n              subscriber.complete();\n            } else {\n              subscriber.next(result.value);\n            }\n          });\n        },\n        0,\n        true\n      );\n    });\n  });\n}\n", "import { SchedulerLike, ReadableStreamLike } from '../types';\nimport { Observable } from '../Observable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { readableStreamLikeToAsyncGenerator } from '../util/isReadableStreamLike';\n\nexport function scheduleReadableStreamLike<T>(input: ReadableStreamLike<T>, scheduler: SchedulerLike): Observable<T> {\n  return scheduleAsyncIterable(readableStreamLikeToAsyncGenerator(input), scheduler);\n}\n", "import { scheduleObservable } from './scheduleObservable';\nimport { schedulePromise } from './schedulePromise';\nimport { scheduleArray } from './scheduleArray';\nimport { scheduleIterable } from './scheduleIterable';\nimport { scheduleAsyncIterable } from './scheduleAsyncIterable';\nimport { isInteropObservable } from '../util/isInteropObservable';\nimport { isPromise } from '../util/isPromise';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isIterable } from '../util/isIterable';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { Observable } from '../Observable';\nimport { isAsyncIterable } from '../util/isAsyncIterable';\nimport { createInvalidObservableTypeError } from '../util/throwUnobservableError';\nimport { isReadableStreamLike } from '../util/isReadableStreamLike';\nimport { scheduleReadableStreamLike } from './scheduleReadableStreamLike';\n\n/**\n * Converts from a common {@link ObservableInput} type to an observable where subscription and emissions\n * are scheduled on the provided scheduler.\n *\n * @see {@link from}\n * @see {@link of}\n *\n * @param input The observable, array, promise, iterable, etc you would like to schedule\n * @param scheduler The scheduler to use to schedule the subscription and emissions from\n * the returned observable.\n */\nexport function scheduled<T>(input: ObservableInput<T>, scheduler: SchedulerLike): Observable<T> {\n  if (input != null) {\n    if (isInteropObservable(input)) {\n      return scheduleObservable(input, scheduler);\n    }\n    if (isArrayLike(input)) {\n      return scheduleArray(input, scheduler);\n    }\n    if (isPromise(input)) {\n      return schedulePromise(input, scheduler);\n    }\n    if (isAsyncIterable(input)) {\n      return scheduleAsyncIterable(input, scheduler);\n    }\n    if (isIterable(input)) {\n      return scheduleIterable(input, scheduler);\n    }\n    if (isReadableStreamLike(input)) {\n      return scheduleReadableStreamLike(input, scheduler);\n    }\n  }\n  throw createInvalidObservableTypeError(input);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf } from '../types';\nimport { scheduled } from '../scheduled/scheduled';\nimport { innerFrom } from './innerFrom';\n\nexport function from<O extends ObservableInput<any>>(input: O): Observable<ObservedValueOf<O>>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function from<O extends ObservableInput<any>>(input: O, scheduler: SchedulerLike | undefined): Observable<ObservedValueOf<O>>;\n\n/**\n * Creates an Observable from an Array, an array-like object, a Promise, an iterable object, or an Observable-like object.\n *\n * <span class=\"informal\">Converts almost anything to an Observable.</span>\n *\n * ![](from.png)\n *\n * `from` converts various other objects and data types into Observables. It also converts a Promise, an array-like, or an\n * <a href=\"https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#iterable\" target=\"_blank\">iterable</a>\n * object into an Observable that emits the items in that promise, array, or iterable. A String, in this context, is treated\n * as an array of characters. Observable-like objects (contains a function named with the ES2015 Symbol for Observable) can also be\n * converted through this operator.\n *\n * ## Examples\n *\n * Converts an array to an Observable\n *\n * ```ts\n * import { from } from 'rxjs';\n *\n * const array = [10, 20, 30];\n * const result = from(array);\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 10\n * // 20\n * // 30\n * ```\n *\n * Convert an infinite iterable (from a generator) to an Observable\n *\n * ```ts\n * import { from, take } from 'rxjs';\n *\n * function* generateDoubles(seed) {\n *    let i = seed;\n *    while (true) {\n *      yield i;\n *      i = 2 * i; // double it\n *    }\n * }\n *\n * const iterator = generateDoubles(3);\n * const result = from(iterator).pipe(take(10));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 3\n * // 6\n * // 12\n * // 24\n * // 48\n * // 96\n * // 192\n * // 384\n * // 768\n * // 1536\n * ```\n *\n * With `asyncScheduler`\n *\n * ```ts\n * import { from, asyncScheduler } from 'rxjs';\n *\n * console.log('start');\n *\n * const array = [10, 20, 30];\n * const result = from(array, asyncScheduler);\n *\n * result.subscribe(x => console.log(x));\n *\n * console.log('end');\n *\n * // Logs:\n * // 'start'\n * // 'end'\n * // 10\n * // 20\n * // 30\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link fromEventPattern}\n *\n * @param {ObservableInput<T>} A subscription object, a Promise, an Observable-like,\n * an Array, an iterable, or an array-like object to be converted.\n * @param {SchedulerLike} An optional {@link SchedulerLike} on which to schedule the emission of values.\n * @return {Observable<T>}\n */\nexport function from<T>(input: ObservableInput<T>, scheduler?: SchedulerLike): Observable<T> {\n  return scheduler ? scheduled(input, scheduler) : innerFrom(input);\n}\n", "import { SchedulerLike, ValueFromArray } from '../types';\nimport { Observable } from '../Observable';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function of(value: null): Observable<null>;\nexport function of(value: undefined): Observable<undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of(scheduler: SchedulerLike): Observable<never>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function of<A extends readonly unknown[]>(...valuesAndScheduler: [...A, SchedulerLike]): Observable<ValueFromArray<A>>;\n\nexport function of(): Observable<never>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function of<T>(): Observable<T>;\nexport function of<T>(value: T): Observable<T>;\nexport function of<A extends readonly unknown[]>(...values: A): Observable<ValueFromArray<A>>;\n\n/**\n * Converts the arguments to an observable sequence.\n *\n * <span class=\"informal\">Each argument becomes a `next` notification.</span>\n *\n * ![](of.png)\n *\n * Unlike {@link from}, it does not do any flattening and emits each argument in whole\n * as a separate `next` notification.\n *\n * ## Examples\n *\n * Emit the values `10, 20, 30`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of(10, 20, 30)\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: 10\n * // next: 20\n * // next: 30\n * // the end\n * ```\n *\n * Emit the array `[1, 2, 3]`\n *\n * ```ts\n * import { of } from 'rxjs';\n *\n * of([1, 2, 3])\n *   .subscribe({\n *     next: value => console.log('next:', value),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // Outputs\n * // next: [1, 2, 3]\n * // the end\n * ```\n *\n * @see {@link from}\n * @see {@link range}\n *\n * @param {...T} values A comma separated list of arguments you want to be emitted\n * @return {Observable} An Observable that emits the arguments\n * described above and then completes.\n */\nexport function of<T>(...args: Array<T | SchedulerLike>): Observable<T> {\n  const scheduler = popScheduler(args);\n  return from(args as T[], scheduler);\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { SchedulerLike } from '../types';\nimport { isFunction } from '../util/isFunction';\n\n/**\n * Creates an observable that will create an error instance and push it to the consumer as an error\n * immediately upon subscription.\n *\n * <span class=\"informal\">Just errors and does nothing else</span>\n *\n * ![](throw.png)\n *\n * This creation function is useful for creating an observable that will create an error and error every\n * time it is subscribed to. Generally, inside of most operators when you might want to return an errored\n * observable, this is unnecessary. In most cases, such as in the inner return of {@link concatMap},\n * {@link mergeMap}, {@link defer}, and many others, you can simply throw the error, and RxJS will pick\n * that up and notify the consumer of the error.\n *\n * ## Example\n *\n * Create a simple observable that will create a new error with a timestamp and log it\n * and the message every time you subscribe to it\n *\n * ```ts\n * import { throwError } from 'rxjs';\n *\n * let errorCount = 0;\n *\n * const errorWithTimestamp$ = throwError(() => {\n *   const error: any = new Error(`This is error number ${ ++errorCount }`);\n *   error.timestamp = Date.now();\n *   return error;\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * errorWithTimestamp$.subscribe({\n *   error: err => console.log(err.timestamp, err.message)\n * });\n *\n * // Logs the timestamp and a new error message for each subscription\n * ```\n *\n * ### Unnecessary usage\n *\n * Using `throwError` inside of an operator or creation function\n * with a callback, is usually not necessary\n *\n * ```ts\n * import { of, concatMap, timer, throwError } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // This is probably overkill.\n *       return throwError(() => new Error(`Invalid time ${ ms }`));\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * You can just throw the error instead\n *\n * ```ts\n * import { of, concatMap, timer } from 'rxjs';\n *\n * const delays$ = of(1000, 2000, Infinity, 3000);\n *\n * delays$.pipe(\n *   concatMap(ms => {\n *     if (ms < 10000) {\n *       return timer(ms);\n *     } else {\n *       // Cleaner and easier to read for most folks.\n *       throw new Error(`Invalid time ${ ms }`);\n *     }\n *   })\n * )\n * .subscribe({\n *   next: console.log,\n *   error: console.error\n * });\n * ```\n *\n * @param errorFactory A factory function that will create the error instance that is pushed.\n */\nexport function throwError(errorFactory: () => any): Observable<never>;\n\n/**\n * Returns an observable that will error with the specified error immediately upon subscription.\n *\n * @param error The error instance to emit\n * @deprecated Support for passing an error value will be removed in v8. Instead, pass a factory function to `throwError(() => new Error('test'))`. This is\n * because it will create the error at the moment it should be created and capture a more appropriate stack trace. If\n * for some reason you need to create the error ahead of time, you can still do that: `const err = new Error('test'); throwError(() => err);`.\n */\nexport function throwError(error: any): Observable<never>;\n\n/**\n * Notifies the consumer of an error using a given scheduler by scheduling it at delay `0` upon subscription.\n *\n * @param errorOrErrorFactory An error instance or error factory\n * @param scheduler A scheduler to use to schedule the error notification\n * @deprecated The `scheduler` parameter will be removed in v8.\n * Use `throwError` in combination with {@link observeOn}: `throwError(() => new Error('test')).pipe(observeOn(scheduler));`.\n * Details: https://rxjs.dev/deprecations/scheduler-argument\n */\nexport function throwError(errorOrErrorFactory: any, scheduler: SchedulerLike): Observable<never>;\n\nexport function throwError(errorOrErrorFactory: any, scheduler?: SchedulerLike): Observable<never> {\n  const errorFactory = isFunction(errorOrErrorFactory) ? errorOrErrorFactory : () => errorOrErrorFactory;\n  const init = (subscriber: Subscriber<never>) => subscriber.error(errorFactory());\n  return new Observable(scheduler ? (subscriber) => scheduler.schedule(init as any, 0, subscriber) : init);\n}\n", "import { createErrorClass } from './createErrorClass';\n\nexport interface EmptyError extends Error {}\n\nexport interface EmptyErrorCtor {\n  /**\n   * @deprecated Internal implementation detail. Do not construct error instances.\n   * Cannot be tagged as internal: https://github.com/ReactiveX/rxjs/issues/6269\n   */\n  new (): EmptyError;\n}\n\n/**\n * An error thrown when an Observable or a sequence was queried but has no\n * elements.\n *\n * @see {@link first}\n * @see {@link last}\n * @see {@link single}\n * @see {@link firstValueFrom}\n * @see {@link lastValueFrom}\n *\n * @class EmptyError\n */\nexport const EmptyError: EmptyErrorCtor = createErrorClass((_super) => function EmptyErrorImpl(this: any) {\n  _super(this);\n  this.name = 'EmptyError';\n  this.message = 'no elements in sequence';\n});\n", "/**\n * Checks to see if a value is not only a `Date` object,\n * but a *valid* `Date` object that can be converted to a\n * number. For example, `new Date('blah')` is indeed an\n * `instanceof Date`, however it cannot be converted to a\n * number.\n */\nexport function isValidDate(value: any): value is Date {\n  return value instanceof Date && !isNaN(value as any);\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function map<T, R>(project: (value: T, index: number) => R): OperatorFunction<T, R>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function map<T, R, A>(project: (this: A, value: T, index: number) => R, thisArg: A): OperatorFunction<T, R>;\n\n/**\n * Applies a given `project` function to each value emitted by the source\n * Observable, and emits the resulting values as an Observable.\n *\n * <span class=\"informal\">Like [Array.prototype.map()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map),\n * it passes each source value through a transformation function to get\n * corresponding output values.</span>\n *\n * ![](map.png)\n *\n * Similar to the well known `Array.prototype.map` function, this operator\n * applies a projection to each value and emits that projection in the output\n * Observable.\n *\n * ## Example\n *\n * Map every click to the `clientX` position of that click\n *\n * ```ts\n * import { fromEvent, map } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const positions = clicks.pipe(map(ev => ev.clientX));\n *\n * positions.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link mapTo}\n * @see {@link pluck}\n *\n * @param {function(value: T, index: number): R} project The function to apply\n * to each `value` emitted by the source Observable. The `index` parameter is\n * the number `i` for the i-th emission that has happened since the\n * subscription, starting from the number `0`.\n * @param {any} [thisArg] An optional argument to define what `this` is in the\n * `project` function.\n * @return A function that returns an Observable that emits the values from the\n * source Observable transformed by the given `project` function.\n */\nexport function map<T, R>(project: (value: T, index: number) => R, thisArg?: any): OperatorFunction<T, R> {\n  return operate((source, subscriber) => {\n    // The index of the value from the source. Used with projection.\n    let index = 0;\n    // Subscribe to the source, all errors and completions are sent along\n    // to the consumer.\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value: T) => {\n        // Call the projection function with the appropriate this context,\n        // and send the resulting value to the consumer.\n        subscriber.next(project.call(thisArg, value, index++));\n      })\n    );\n  });\n}\n", "import { OperatorFunction } from \"../types\";\nimport { map } from \"../operators/map\";\n\nconst { isArray } = Array;\n\nfunction callOrApply<T, R>(fn: ((...values: T[]) => R), args: T|T[]): R {\n    return isArray(args) ? fn(...args) : fn(args);\n}\n\n/**\n * Used in several -- mostly deprecated -- situations where we need to \n * apply a list of arguments or a single argument to a result selector.\n */\nexport function mapOneOrManyArgs<T, R>(fn: ((...values: T[]) => R)): OperatorFunction<T|T[], R> {\n    return map(args => callOrApply(fn, args))\n}", "const { isArray } = Array;\nconst { getPrototypeOf, prototype: objectProto, keys: getKeys } = Object;\n\n/**\n * Used in functions where either a list of arguments, a single array of arguments, or a\n * dictionary of arguments can be returned. Returns an object with an `args` property with\n * the arguments in an array, if it is a dictionary, it will also return the `keys` in another\n * property.\n */\nexport function argsArgArrayOrObject<T, O extends Record<string, T>>(args: T[] | [O] | [T[]]): { args: T[]; keys: string[] | null } {\n  if (args.length === 1) {\n    const first = args[0];\n    if (isArray(first)) {\n      return { args: first, keys: null };\n    }\n    if (isPOJO(first)) {\n      const keys = getKeys(first);\n      return {\n        args: keys.map((key) => first[key]),\n        keys,\n      };\n    }\n  }\n\n  return { args: args as T[], keys: null };\n}\n\nfunction isPOJO(obj: any): obj is object {\n  return obj && typeof obj === 'object' && getPrototypeOf(obj) === objectProto;\n}\n", "export function createObject(keys: string[], values: any[]) {\n  return keys.reduce((result, key, i) => ((result[key] = values[i]), result), {} as any);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, SchedulerLike, ObservedValueOf, ObservableInputTuple } from '../types';\nimport { argsArgArrayOrObject } from '../util/argsArgArrayOrObject';\nimport { Subscriber } from '../Subscriber';\nimport { from } from './from';\nimport { identity } from '../util/identity';\nimport { Subscription } from '../Subscription';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { popResultSelector, popScheduler } from '../util/args';\nimport { createObject } from '../util/createObject';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { AnyCatcher } from '../AnyCatcher';\nimport { executeSchedule } from '../util/executeSchedule';\n\n// combineLatest(any)\n// We put this first because we need to catch cases where the user has supplied\n// _exactly `any`_ as the argument. Since `any` literally matches _anything_,\n// we don't want it to randomly hit one of the other type signatures below,\n// as we have no idea at build-time what type we should be returning when given an any.\n\n/**\n * You have passed `any` here, we can't figure out if it is\n * an array or an object, so you're getting `unknown`. Use better types.\n * @param arg Something typed as `any`\n */\nexport function combineLatest<T extends AnyCatcher>(arg: T): Observable<unknown>;\n\n// combineLatest([a, b, c])\nexport function combineLatest(sources: []): Observable<never>;\nexport function combineLatest<A extends readonly unknown[]>(sources: readonly [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R,\n  scheduler: SchedulerLike\n): Observable<R>;\nexport function combineLatest<A extends readonly unknown[], R>(\n  sources: readonly [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  sources: readonly [...ObservableInputTuple<A>],\n  scheduler: SchedulerLike\n): Observable<A>;\n\n// combineLatest(a, b, c)\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelectorAndScheduler: [...ObservableInputTuple<A>, (...values: A) => R, SchedulerLike]\n): Observable<R>;\n/** @deprecated Pass an array of sources instead. The rest-parameters signature will be removed in v8. Details: https://rxjs.dev/deprecations/array-argument */\nexport function combineLatest<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `combineLatestAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function combineLatest<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): Observable<A>;\n\n// combineLatest({a, b, c})\nexport function combineLatest(sourcesObject: { [K in any]: never }): Observable<never>;\nexport function combineLatest<T extends Record<string, ObservableInput<any>>>(\n  sourcesObject: T\n): Observable<{ [K in keyof T]: ObservedValueOf<T[K]> }>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are\n * calculated from the latest values of each of its input Observables.\n *\n * <span class=\"informal\">Whenever any input Observable emits a value, it\n * computes a formula using the latest values from all the inputs, then emits\n * the output of that formula.</span>\n *\n * ![](combineLatest.png)\n *\n * `combineLatest` combines the values from all the Observables passed in the\n * observables array. This is done by subscribing to each Observable in order and,\n * whenever any Observable emits, collecting an array of the most recent\n * values from each Observable. So if you pass `n` Observables to this operator,\n * the returned Observable will always emit an array of `n` values, in an order\n * corresponding to the order of the passed Observables (the value from the first Observable\n * will be at index 0 of the array and so on).\n *\n * Static version of `combineLatest` accepts an array of Observables. Note that an array of\n * Observables is a good choice, if you don't know beforehand how many Observables\n * you will combine. Passing an empty array will result in an Observable that\n * completes immediately.\n *\n * To ensure the output array always has the same length, `combineLatest` will\n * actually wait for all input Observables to emit at least once,\n * before it starts emitting results. This means if some Observable emits\n * values before other Observables started emitting, all these values but the last\n * will be lost. On the other hand, if some Observable does not emit a value but\n * completes, resulting Observable will complete at the same moment without\n * emitting anything, since it will now be impossible to include a value from the\n * completed Observable in the resulting array. Also, if some input Observable does\n * not emit any value and never completes, `combineLatest` will also never emit\n * and never complete, since, again, it will wait for all streams to emit some\n * value.\n *\n * If at least one Observable was passed to `combineLatest` and all passed Observables\n * emitted something, the resulting Observable will complete when all combined\n * streams complete. So even if some Observable completes, the result of\n * `combineLatest` will still emit values when other Observables do. In case\n * of a completed Observable, its value from now on will always be the last\n * emitted value. On the other hand, if any Observable errors, `combineLatest`\n * will error immediately as well, and all other Observables will be unsubscribed.\n *\n * ## Examples\n *\n * Combine two timer Observables\n *\n * ```ts\n * import { timer, combineLatest } from 'rxjs';\n *\n * const firstTimer = timer(0, 1000); // emit 0, 1, 2... after every second, starting from now\n * const secondTimer = timer(500, 1000); // emit 0, 1, 2... after every second, starting 0,5s from now\n * const combinedTimers = combineLatest([firstTimer, secondTimer]);\n * combinedTimers.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0] after 0.5s\n * // [1, 0] after 1s\n * // [1, 1] after 1.5s\n * // [2, 1] after 2s\n * ```\n *\n * Combine a dictionary of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = {\n *   a: of(1).pipe(delay(1000), startWith(0)),\n *   b: of(5).pipe(delay(5000), startWith(0)),\n *   c: of(10).pipe(delay(10000), startWith(0))\n * };\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // { a: 0, b: 0, c: 0 } immediately\n * // { a: 1, b: 0, c: 0 } after 1s\n * // { a: 1, b: 5, c: 0 } after 5s\n * // { a: 1, b: 5, c: 10 } after 10s\n * ```\n *\n * Combine an array of Observables\n *\n * ```ts\n * import { of, delay, startWith, combineLatest } from 'rxjs';\n *\n * const observables = [1, 5, 10].map(\n *   n => of(n).pipe(\n *     delay(n * 1000), // emit 0 and then emit n after n seconds\n *     startWith(0)\n *   )\n * );\n * const combined = combineLatest(observables);\n * combined.subscribe(value => console.log(value));\n * // Logs\n * // [0, 0, 0] immediately\n * // [1, 0, 0] after 1s\n * // [1, 5, 0] after 5s\n * // [1, 5, 10] after 10s\n * ```\n *\n * Use map operator to dynamically calculate the Body-Mass Index\n *\n * ```ts\n * import { of, combineLatest, map } from 'rxjs';\n *\n * const weight = of(70, 72, 76, 79, 75);\n * const height = of(1.76, 1.77, 1.78);\n * const bmi = combineLatest([weight, height]).pipe(\n *   map(([w, h]) => w / (h * h)),\n * );\n * bmi.subscribe(x => console.log('BMI is ' + x));\n *\n * // With output to console:\n * // BMI is 24.212293388429753\n * // BMI is 23.93948099205209\n * // BMI is 23.671253629592222\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link merge}\n * @see {@link withLatestFrom}\n *\n * @param {ObservableInput} [observables] An array of input Observables to combine with each other.\n * An array of Observables must be given as the first argument.\n * @param {function} [project] An optional function to project the values from\n * the combined latest values into a new value on the output Observable.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for subscribing to\n * each input Observable.\n * @return {Observable} An Observable of projected values from the most recent\n * values from each input Observable, or an array of the most recent values from\n * each input Observable.\n */\nexport function combineLatest<O extends ObservableInput<any>, R>(...args: any[]): Observable<R> | Observable<ObservedValueOf<O>[]> {\n  const scheduler = popScheduler(args);\n  const resultSelector = popResultSelector(args);\n\n  const { args: observables, keys } = argsArgArrayOrObject(args);\n\n  if (observables.length === 0) {\n    // If no observables are passed, or someone has passed an empty array\n    // of observables, or even an empty object POJO, we need to just\n    // complete (EMPTY), but we have to honor the scheduler provided if any.\n    return from([], scheduler as any);\n  }\n\n  const result = new Observable<ObservedValueOf<O>[]>(\n    combineLatestInit(\n      observables as ObservableInput<ObservedValueOf<O>>[],\n      scheduler,\n      keys\n        ? // A handler for scrubbing the array of args into a dictionary.\n          (values) => createObject(keys, values)\n        : // A passthrough to just return the array\n          identity\n    )\n  );\n\n  return resultSelector ? (result.pipe(mapOneOrManyArgs(resultSelector)) as Observable<R>) : result;\n}\n\nexport function combineLatestInit(\n  observables: ObservableInput<any>[],\n  scheduler?: SchedulerLike,\n  valueTransform: (values: any[]) => any = identity\n) {\n  return (subscriber: Subscriber<any>) => {\n    // The outer subscription. We're capturing this in a function\n    // because we may have to schedule it.\n    maybeSchedule(\n      scheduler,\n      () => {\n        const { length } = observables;\n        // A store for the values each observable has emitted so far. We match observable to value on index.\n        const values = new Array(length);\n        // The number of currently active subscriptions, as they complete, we decrement this number to see if\n        // we are all done combining values, so we can complete the result.\n        let active = length;\n        // The number of inner sources that still haven't emitted the first value\n        // We need to track this because all sources need to emit one value in order\n        // to start emitting values.\n        let remainingFirstValues = length;\n        // The loop to kick off subscription. We're keying everything on index `i` to relate the observables passed\n        // in to the slot in the output array or the key in the array of keys in the output dictionary.\n        for (let i = 0; i < length; i++) {\n          maybeSchedule(\n            scheduler,\n            () => {\n              const source = from(observables[i], scheduler as any);\n              let hasFirstValue = false;\n              source.subscribe(\n                createOperatorSubscriber(\n                  subscriber,\n                  (value) => {\n                    // When we get a value, record it in our set of values.\n                    values[i] = value;\n                    if (!hasFirstValue) {\n                      // If this is our first value, record that.\n                      hasFirstValue = true;\n                      remainingFirstValues--;\n                    }\n                    if (!remainingFirstValues) {\n                      // We're not waiting for any more\n                      // first values, so we can emit!\n                      subscriber.next(valueTransform(values.slice()));\n                    }\n                  },\n                  () => {\n                    if (!--active) {\n                      // We only complete the result if we have no more active\n                      // inner observables.\n                      subscriber.complete();\n                    }\n                  }\n                )\n              );\n            },\n            subscriber\n          );\n        }\n      },\n      subscriber\n    );\n  };\n}\n\n/**\n * A small utility to handle the couple of locations where we want to schedule if a scheduler was provided,\n * but we don't if there was no scheduler.\n */\nfunction maybeSchedule(scheduler: SchedulerLike | undefined, execute: () => void, subscription: Subscription) {\n  if (scheduler) {\n    executeSchedule(subscription, scheduler, execute);\n  } else {\n    execute();\n  }\n}\n", "import { Observable } from '../Observable';\nimport { innerFrom } from '../observable/innerFrom';\nimport { Subscriber } from '../Subscriber';\nimport { ObservableInput, SchedulerLike } from '../types';\nimport { executeSchedule } from '../util/executeSchedule';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A process embodying the general \"merge\" strategy. This is used in\n * `mergeMap` and `mergeScan` because the logic is otherwise nearly identical.\n * @param source The original source observable\n * @param subscriber The consumer subscriber\n * @param project The projection function to get our inner sources\n * @param concurrent The number of concurrent inner subscriptions\n * @param onBeforeNext Additional logic to apply before nexting to our consumer\n * @param expand If `true` this will perform an \"expand\" strategy, which differs only\n * in that it recurses, and the inner subscription must be schedule-able.\n * @param innerSubScheduler A scheduler to use to schedule inner subscriptions,\n * this is to support the expand strategy, mostly, and should be deprecated\n */\nexport function mergeInternals<T, R>(\n  source: Observable<T>,\n  subscriber: Subscriber<R>,\n  project: (value: T, index: number) => ObservableInput<R>,\n  concurrent: number,\n  onBeforeNext?: (innerValue: R) => void,\n  expand?: boolean,\n  innerSubScheduler?: SchedulerLike,\n  additionalFinalizer?: () => void\n) {\n  // Buffered values, in the event of going over our concurrency limit\n  const buffer: T[] = [];\n  // The number of active inner subscriptions.\n  let active = 0;\n  // An index to pass to our accumulator function\n  let index = 0;\n  // Whether or not the outer source has completed.\n  let isComplete = false;\n\n  /**\n   * Checks to see if we can complete our result or not.\n   */\n  const checkComplete = () => {\n    // If the outer has completed, and nothing is left in the buffer,\n    // and we don't have any active inner subscriptions, then we can\n    // Emit the state and complete.\n    if (isComplete && !buffer.length && !active) {\n      subscriber.complete();\n    }\n  };\n\n  // If we're under our concurrency limit, just start the inner subscription, otherwise buffer and wait.\n  const outerNext = (value: T) => (active < concurrent ? doInnerSub(value) : buffer.push(value));\n\n  const doInnerSub = (value: T) => {\n    // If we're expanding, we need to emit the outer values and the inner values\n    // as the inners will \"become outers\" in a way as they are recursively fed\n    // back to the projection mechanism.\n    expand && subscriber.next(value as any);\n\n    // Increment the number of active subscriptions so we can track it\n    // against our concurrency limit later.\n    active++;\n\n    // A flag used to show that the inner observable completed.\n    // This is checked during finalization to see if we should\n    // move to the next item in the buffer, if there is on.\n    let innerComplete = false;\n\n    // Start our inner subscription.\n    innerFrom(project(value, index++)).subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (innerValue) => {\n          // `mergeScan` has additional handling here. For example\n          // taking the inner value and updating state.\n          onBeforeNext?.(innerValue);\n\n          if (expand) {\n            // If we're expanding, then just recurse back to our outer\n            // handler. It will emit the value first thing.\n            outerNext(innerValue as any);\n          } else {\n            // Otherwise, emit the inner value.\n            subscriber.next(innerValue);\n          }\n        },\n        () => {\n          // Flag that we have completed, so we know to check the buffer\n          // during finalization.\n          innerComplete = true;\n        },\n        // Errors are passed to the destination.\n        undefined,\n        () => {\n          // During finalization, if the inner completed (it wasn't errored or\n          // cancelled), then we want to try the next item in the buffer if\n          // there is one.\n          if (innerComplete) {\n            // We have to wrap this in a try/catch because it happens during\n            // finalization, possibly asynchronously, and we want to pass\n            // any errors that happen (like in a projection function) to\n            // the outer Subscriber.\n            try {\n              // INNER SOURCE COMPLETE\n              // Decrement the active count to ensure that the next time\n              // we try to call `doInnerSub`, the number is accurate.\n              active--;\n              // If we have more values in the buffer, try to process those\n              // Note that this call will increment `active` ahead of the\n              // next conditional, if there were any more inner subscriptions\n              // to start.\n              while (buffer.length && active < concurrent) {\n                const bufferedValue = buffer.shift()!;\n                // Particularly for `expand`, we need to check to see if a scheduler was provided\n                // for when we want to start our inner subscription. Otherwise, we just start\n                // are next inner subscription.\n                if (innerSubScheduler) {\n                  executeSchedule(subscriber, innerSubScheduler, () => doInnerSub(bufferedValue));\n                } else {\n                  doInnerSub(bufferedValue);\n                }\n              }\n              // Check to see if we can complete, and complete if so.\n              checkComplete();\n            } catch (err) {\n              subscriber.error(err);\n            }\n          }\n        }\n      )\n    );\n  };\n\n  // Subscribe to our source observable.\n  source.subscribe(\n    createOperatorSubscriber(subscriber, outerNext, () => {\n      // Outer completed, make a note of it, and check to see if we can complete everything.\n      isComplete = true;\n      checkComplete();\n    })\n  );\n\n  // Additional finalization (for when the destination is torn down).\n  // Other finalization is added implicitly via subscription above.\n  return () => {\n    additionalFinalizer?.();\n  };\n}\n", "import { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { map } from './map';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { mergeInternals } from './mergeInternals';\nimport { isFunction } from '../util/isFunction';\n\n/* tslint:disable:max-line-length */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined,\n  concurrent?: number\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R,\n  concurrent?: number\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link mergeAll}.</span>\n *\n * ![](mergeMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an Observable, and then merging those resulting Observables and\n * emitting the results of this merger.\n *\n * ## Example\n *\n * Map and flatten each letter to an Observable ticking every 1 second\n *\n * ```ts\n * import { of, mergeMap, interval, map } from 'rxjs';\n *\n * const letters = of('a', 'b', 'c');\n * const result = letters.pipe(\n *   mergeMap(x => interval(1000).pipe(map(i => x + i)))\n * );\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // a0\n * // b0\n * // c0\n * // a1\n * // b1\n * // c1\n * // continues to list a, b, c every second with respective ascending integers\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link merge}\n * @see {@link mergeAll}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchMap}\n *\n * @param {function(value: T, ?index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and merging\n * the results of the Observables obtained from this transformation.\n */\nexport function mergeMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: ((outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R) | number,\n  concurrent: number = Infinity\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  if (isFunction(resultSelector)) {\n    // DEPRECATED PATH\n    return mergeMap((a, i) => map((b: any, ii: number) => resultSelector(a, b, i, ii))(innerFrom(project(a, i))), concurrent);\n  } else if (typeof resultSelector === 'number') {\n    concurrent = resultSelector;\n  }\n\n  return operate((source, subscriber) => mergeInternals(source, subscriber, project, concurrent));\n}\n", "import { mergeMap } from './mergeMap';\nimport { identity } from '../util/identity';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable which\n * concurrently delivers all values that are emitted on the inner Observables.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables.</span>\n *\n * ![](mergeAll.png)\n *\n * `mergeAll` subscribes to an Observable that emits Observables, also known as\n * a higher-order Observable. Each time it observes one of these emitted inner\n * Observables, it subscribes to that and delivers all the values from the\n * inner Observable on the output Observable. The output Observable only\n * completes once all inner Observables have completed. Any error delivered by\n * a inner Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Spawn a new interval Observable for each click event, and blend their outputs as one Observable\n *\n * ```ts\n * import { fromEvent, map, interval, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(map(() => interval(1000)));\n * const firstOrder = higherOrder.pipe(mergeAll());\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * Count from 0 to 9 every second for each click, but only allow 2 concurrent timers\n *\n * ```ts\n * import { fromEvent, map, interval, take, mergeAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(10)))\n * );\n * const firstOrder = higherOrder.pipe(mergeAll(2));\n *\n * firstOrder.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concatAll}\n * @see {@link exhaustAll}\n * @see {@link merge}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @param {number} [concurrent=Infinity] Maximum number of inner\n * Observables being subscribed to concurrently.\n * @return A function that returns an Observable that emits values coming from\n * all the inner Observables emitted by the source Observable.\n */\nexport function mergeAll<O extends ObservableInput<any>>(concurrent: number = Infinity): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeMap(identity, concurrent);\n}\n", "import { mergeAll } from './mergeAll';\nimport { OperatorFunction, ObservableInput, ObservedValueOf } from '../types';\n\n/**\n * Converts a higher-order Observable into a first-order Observable by\n * concatenating the inner Observables in order.\n *\n * <span class=\"informal\">Flattens an Observable-of-Observables by putting one\n * inner Observable after the other.</span>\n *\n * ![](concatAll.svg)\n *\n * Joins every Observable emitted by the source (a higher-order Observable), in\n * a serial fashion. It subscribes to each inner Observable only after the\n * previous inner Observable has completed, and merges all of their values into\n * the returned observable.\n *\n * __Warning:__ If the source Observable emits Observables quickly and\n * endlessly, and the inner Observables it emits generally complete slower than\n * the source emits, you can run into memory issues as the incoming Observables\n * collect in an unbounded buffer.\n *\n * Note: `concatAll` is equivalent to `mergeAll` with concurrency parameter set\n * to `1`.\n *\n * ## Example\n *\n * For each click event, tick every second from 0 to 3, with no concurrency\n *\n * ```ts\n * import { fromEvent, map, interval, take, concatAll } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const higherOrder = clicks.pipe(\n *   map(() => interval(1000).pipe(take(4)))\n * );\n * const firstOrder = higherOrder.pipe(concatAll());\n * firstOrder.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // (results are not concurrent)\n * // For every click on the \"document\" it will emit values 0 to 3 spaced\n * // on a 1000ms interval\n * // one click = 1000ms-> 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3\n * ```\n *\n * @see {@link combineLatestAll}\n * @see {@link concat}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link exhaustAll}\n * @see {@link mergeAll}\n * @see {@link switchAll}\n * @see {@link switchMap}\n * @see {@link zipAll}\n *\n * @return A function that returns an Observable emitting values from all the\n * inner Observables concatenated.\n */\nexport function concatAll<O extends ObservableInput<any>>(): OperatorFunction<O, ObservedValueOf<O>> {\n  return mergeAll(1);\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple, SchedulerLike } from '../types';\nimport { concatAll } from '../operators/concatAll';\nimport { popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function concat<T extends readonly unknown[]>(...inputs: [...ObservableInputTuple<T>]): Observable<T[number]>;\nexport function concat<T extends readonly unknown[]>(\n  ...inputsAndScheduler: [...ObservableInputTuple<T>, SchedulerLike]\n): Observable<T[number]>;\n\n/**\n * Creates an output Observable which sequentially emits all values from the first given\n * Observable and then moves on to the next.\n *\n * <span class=\"informal\">Concatenates multiple Observables together by\n * sequentially emitting their values, one Observable after the other.</span>\n *\n * ![](concat.png)\n *\n * `concat` joins multiple Observables together, by subscribing to them one at a time and\n * merging their results into the output Observable. You can pass either an array of\n * Observables, or put them directly as arguments. Passing an empty array will result\n * in Observable that completes immediately.\n *\n * `concat` will subscribe to first input Observable and emit all its values, without\n * changing or affecting them in any way. When that Observable completes, it will\n * subscribe to then next Observable passed and, again, emit its values. This will be\n * repeated, until the operator runs out of Observables. When last input Observable completes,\n * `concat` will complete as well. At any given moment only one Observable passed to operator\n * emits values. If you would like to emit values from passed Observables concurrently, check out\n * {@link merge} instead, especially with optional `concurrent` parameter. As a matter of fact,\n * `concat` is an equivalent of `merge` operator with `concurrent` parameter set to `1`.\n *\n * Note that if some input Observable never completes, `concat` will also never complete\n * and Observables following the one that did not complete will never be subscribed. On the other\n * hand, if some Observable simply completes immediately after it is subscribed, it will be\n * invisible for `concat`, which will just move on to the next Observable.\n *\n * If any Observable in chain errors, instead of passing control to the next Observable,\n * `concat` will error immediately as well. Observables that would be subscribed after\n * the one that emitted error, never will.\n *\n * If you pass to `concat` the same Observable many times, its stream of values\n * will be \"replayed\" on every subscription, which means you can repeat given Observable\n * as many times as you like. If passing the same Observable to `concat` 1000 times becomes tedious,\n * you can always use {@link repeat}.\n *\n * ## Examples\n *\n * Concatenate a timer counting from 0 to 3 with a synchronous sequence from 1 to 10\n *\n * ```ts\n * import { interval, take, range, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(4));\n * const sequence = range(1, 10);\n * const result = concat(timer, sequence);\n * result.subscribe(x => console.log(x));\n *\n * // results in:\n * // 0 -1000ms-> 1 -1000ms-> 2 -1000ms-> 3 -immediate-> 1 ... 10\n * ```\n *\n * Concatenate 3 Observables\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const result = concat(timer1, timer2, timer3);\n * result.subscribe(x => console.log(x));\n *\n * // results in the following:\n * // (Prints to console sequentially)\n * // -1000ms-> 0 -1000ms-> 1 -1000ms-> ... 9\n * // -2000ms-> 0 -2000ms-> 1 -2000ms-> ... 5\n * // -500ms-> 0 -500ms-> 1 -500ms-> ... 9\n * ```\n *\n * Concatenate the same Observable to repeat it\n *\n * ```ts\n * import { interval, take, concat } from 'rxjs';\n *\n * const timer = interval(1000).pipe(take(2));\n *\n * concat(timer, timer) // concatenating the same Observable!\n *   .subscribe({\n *     next: value => console.log(value),\n *     complete: () => console.log('...and it is done!')\n *   });\n *\n * // Logs:\n * // 0 after 1s\n * // 1 after 2s\n * // 0 after 3s\n * // 1 after 4s\n * // '...and it is done!' also after 4s\n * ```\n *\n * @see {@link concatAll}\n * @see {@link concatMap}\n * @see {@link concatMapTo}\n * @see {@link startWith}\n * @see {@link endWith}\n *\n * @param args Input Observables to concatenate.\n */\nexport function concat(...args: any[]): Observable<unknown> {\n  return concatAll()(from(args, popScheduler(args)));\n}\n", "import { Observable } from '../Observable';\nimport { ObservedValueOf, ObservableInput } from '../types';\nimport { innerFrom } from './innerFrom';\n\n/**\n * Creates an Observable that, on subscribe, calls an Observable factory to\n * make an Observable for each new Observer.\n *\n * <span class=\"informal\">Creates the Observable lazily, that is, only when it\n * is subscribed.\n * </span>\n *\n * ![](defer.png)\n *\n * `defer` allows you to create an Observable only when the Observer\n * subscribes. It waits until an Observer subscribes to it, calls the given\n * factory function to get an Observable -- where a factory function typically\n * generates a new Observable -- and subscribes the Observer to this Observable.\n * In case the factory function returns a falsy value, then EMPTY is used as\n * Observable instead. Last but not least, an exception during the factory\n * function call is transferred to the Observer by calling `error`.\n *\n * ## Example\n *\n * Subscribe to either an Observable of clicks or an Observable of interval, at random\n *\n * ```ts\n * import { defer, fromEvent, interval } from 'rxjs';\n *\n * const clicksOrInterval = defer(() => {\n *   return Math.random() > 0.5\n *     ? fromEvent(document, 'click')\n *     : interval(1000);\n * });\n * clicksOrInterval.subscribe(x => console.log(x));\n *\n * // Results in the following behavior:\n * // If the result of Math.random() is greater than 0.5 it will listen\n * // for clicks anywhere on the \"document\"; when document is clicked it\n * // will log a MouseEvent object to the console. If the result is less\n * // than 0.5 it will emit ascending numbers, one every second(1000ms).\n * ```\n *\n * @see {@link Observable}\n *\n * @param {function(): ObservableInput} observableFactory The Observable\n * factory function to invoke for each Observer that subscribes to the output\n * Observable. May also return a Promise, which will be converted on the fly\n * to an Observable.\n * @return {Observable} An Observable whose Observers' subscriptions trigger\n * an invocation of the given Observable factory function.\n */\nexport function defer<R extends ObservableInput<any>>(observableFactory: () => R): Observable<ObservedValueOf<R>> {\n  return new Observable<ObservedValueOf<R>>((subscriber) => {\n    innerFrom(observableFactory()).subscribe(subscriber);\n  });\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Observable } from '../Observable';\nimport { mergeMap } from '../operators/mergeMap';\nimport { isArrayLike } from '../util/isArrayLike';\nimport { isFunction } from '../util/isFunction';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n// These constants are used to create handler registry functions using array mapping below.\nconst nodeEventEmitterMethods = ['addListener', 'removeListener'] as const;\nconst eventTargetMethods = ['addEventListener', 'removeEventListener'] as const;\nconst jqueryMethods = ['on', 'off'] as const;\n\nexport interface NodeStyleEventEmitter {\n  addListener(eventName: string | symbol, handler: NodeEventHandler): this;\n  removeListener(eventName: string | symbol, handler: NodeEventHandler): this;\n}\n\nexport type NodeEventHandler = (...args: any[]) => void;\n\n// For APIs that implement `addListener` and `removeListener` methods that may\n// not use the same arguments or return EventEmitter values\n// such as React Native\nexport interface NodeCompatibleEventEmitter {\n  addListener(eventName: string, handler: NodeEventHandler): void | {};\n  removeListener(eventName: string, handler: NodeEventHandler): void | {};\n}\n\n// Use handler types like those in @types/jquery. See:\n// https://github.com/DefinitelyTyped/DefinitelyTyped/blob/847731ba1d7fa6db6b911c0e43aa0afe596e7723/types/jquery/misc.d.ts#L6395\nexport interface JQueryStyleEventEmitter<TContext, T> {\n  on(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n  off(eventName: string, handler: (this: TContext, t: T, ...args: any[]) => any): void;\n}\n\nexport interface EventListenerObject<E> {\n  handleEvent(evt: E): void;\n}\n\nexport interface HasEventTargetAddRemove<E> {\n  addEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: boolean | AddEventListenerOptions\n  ): void;\n  removeEventListener(\n    type: string,\n    listener: ((evt: E) => void) | EventListenerObject<E> | null,\n    options?: EventListenerOptions | boolean\n  ): void;\n}\n\nexport interface EventListenerOptions {\n  capture?: boolean;\n  passive?: boolean;\n  once?: boolean;\n}\n\nexport interface AddEventListenerOptions extends EventListenerOptions {\n  once?: boolean;\n  passive?: boolean;\n}\n\nexport function fromEvent<T>(target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>, eventName: string): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  resultSelector: (event: T) => R\n): Observable<R>;\nexport function fromEvent<T>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: HasEventTargetAddRemove<T> | ArrayLike<HasEventTargetAddRemove<T>>,\n  eventName: string,\n  options: EventListenerOptions,\n  resultSelector: (event: T) => R\n): Observable<R>;\n\nexport function fromEvent(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeStyleEventEmitter | ArrayLike<NodeStyleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string\n): Observable<unknown>;\n/** @deprecated Do not specify explicit type parameters. Signatures with type parameters that cannot be inferred will be removed in v8. */\nexport function fromEvent<T>(target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>, eventName: string): Observable<T>;\nexport function fromEvent<R>(\n  target: NodeCompatibleEventEmitter | ArrayLike<NodeCompatibleEventEmitter>,\n  eventName: string,\n  resultSelector: (...args: any[]) => R\n): Observable<R>;\n\nexport function fromEvent<T>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string\n): Observable<T>;\nexport function fromEvent<T, R>(\n  target: JQueryStyleEventEmitter<any, T> | ArrayLike<JQueryStyleEventEmitter<any, T>>,\n  eventName: string,\n  resultSelector: (value: T, ...args: any[]) => R\n): Observable<R>;\n\n/**\n * Creates an Observable that emits events of a specific type coming from the\n * given event target.\n *\n * <span class=\"informal\">Creates an Observable from DOM events, or Node.js\n * EventEmitter events or others.</span>\n *\n * ![](fromEvent.png)\n *\n * `fromEvent` accepts as a first argument event target, which is an object with methods\n * for registering event handler functions. As a second argument it takes string that indicates\n * type of event we want to listen for. `fromEvent` supports selected types of event targets,\n * which are described in detail below. If your event target does not match any of the ones listed,\n * you should use {@link fromEventPattern}, which can be used on arbitrary APIs.\n * When it comes to APIs supported by `fromEvent`, their methods for adding and removing event\n * handler functions have different names, but they all accept a string describing event type\n * and function itself, which will be called whenever said event happens.\n *\n * Every time resulting Observable is subscribed, event handler function will be registered\n * to event target on given event type. When that event fires, value\n * passed as a first argument to registered function will be emitted by output Observable.\n * When Observable is unsubscribed, function will be unregistered from event target.\n *\n * Note that if event target calls registered function with more than one argument, second\n * and following arguments will not appear in resulting stream. In order to get access to them,\n * you can pass to `fromEvent` optional project function, which will be called with all arguments\n * passed to event handler. Output Observable will then emit value returned by project function,\n * instead of the usual value.\n *\n * Remember that event targets listed below are checked via duck typing. It means that\n * no matter what kind of object you have and no matter what environment you work in,\n * you can safely use `fromEvent` on that object if it exposes described methods (provided\n * of course they behave as was described above). So for example if Node.js library exposes\n * event target which has the same method names as DOM EventTarget, `fromEvent` is still\n * a good choice.\n *\n * If the API you use is more callback then event handler oriented (subscribed\n * callback function fires only once and thus there is no need to manually\n * unregister it), you should use {@link bindCallback} or {@link bindNodeCallback}\n * instead.\n *\n * `fromEvent` supports following types of event targets:\n *\n * **DOM EventTarget**\n *\n * This is an object with `addEventListener` and `removeEventListener` methods.\n *\n * In the browser, `addEventListener` accepts - apart from event type string and event\n * handler function arguments - optional third parameter, which is either an object or boolean,\n * both used for additional configuration how and when passed function will be called. When\n * `fromEvent` is used with event target of that type, you can provide this values\n * as third parameter as well.\n *\n * **Node.js EventEmitter**\n *\n * An object with `addListener` and `removeListener` methods.\n *\n * **JQuery-style event target**\n *\n * An object with `on` and `off` methods\n *\n * **DOM NodeList**\n *\n * List of DOM Nodes, returned for example by `document.querySelectorAll` or `Node.childNodes`.\n *\n * Although this collection is not event target in itself, `fromEvent` will iterate over all Nodes\n * it contains and install event handler function in every of them. When returned Observable\n * is unsubscribed, function will be removed from all Nodes.\n *\n * **DOM HtmlCollection**\n *\n * Just as in case of NodeList it is a collection of DOM nodes. Here as well event handler function is\n * installed and removed in each of elements.\n *\n *\n * ## Examples\n *\n * Emit clicks happening on the DOM document\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * clicks.subscribe(x => console.log(x));\n *\n * // Results in:\n * // MouseEvent object logged to console every time a click\n * // occurs on the document.\n * ```\n *\n * Use `addEventListener` with capture option\n *\n * ```ts\n * import { fromEvent } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * // note optional configuration parameter which will be passed to addEventListener\n * const clicksInDocument = fromEvent(document, 'click', { capture: true });\n * const clicksInDiv = fromEvent(div, 'click');\n *\n * clicksInDocument.subscribe(() => console.log('document'));\n * clicksInDiv.subscribe(() => console.log('div'));\n *\n * // By default events bubble UP in DOM tree, so normally\n * // when we would click on div in document\n * // \"div\" would be logged first and then \"document\".\n * // Since we specified optional `capture` option, document\n * // will catch event when it goes DOWN DOM tree, so console\n * // will log \"document\" and then \"div\".\n * ```\n *\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n * @see {@link fromEventPattern}\n *\n * @param {FromEventTarget<T>} target The DOM EventTarget, Node.js\n * EventEmitter, JQuery-like event target, NodeList or HTMLCollection to attach the event handler to.\n * @param {string} eventName The event name of interest, being emitted by the\n * `target`.\n * @param {EventListenerOptions} [options] Options to pass through to addEventListener\n * @return {Observable<T>}\n */\nexport function fromEvent<T>(\n  target: any,\n  eventName: string,\n  options?: EventListenerOptions | ((...args: any[]) => T),\n  resultSelector?: (...args: any[]) => T\n): Observable<T> {\n  if (isFunction(options)) {\n    resultSelector = options;\n    options = undefined;\n  }\n  if (resultSelector) {\n    return fromEvent<T>(target, eventName, options as EventListenerOptions).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  // Figure out our add and remove methods. In order to do this,\n  // we are going to analyze the target in a preferred order, if\n  // the target matches a given signature, we take the two \"add\" and \"remove\"\n  // method names and apply them to a map to create opposite versions of the\n  // same function. This is because they all operate in duplicate pairs,\n  // `addListener(name, handler)`, `removeListener(name, handler)`, for example.\n  // The call only differs by method name, as to whether or not you're adding or removing.\n  const [add, remove] =\n    // If it is an EventTarget, we need to use a slightly different method than the other two patterns.\n    isEventTarget(target)\n      ? eventTargetMethods.map((methodName) => (handler: any) => target[methodName](eventName, handler, options as EventListenerOptions))\n      : // In all other cases, the call pattern is identical with the exception of the method names.\n      isNodeStyleEventEmitter(target)\n      ? nodeEventEmitterMethods.map(toCommonHandlerRegistry(target, eventName))\n      : isJQueryStyleEventEmitter(target)\n      ? jqueryMethods.map(toCommonHandlerRegistry(target, eventName))\n      : [];\n\n  // If add is falsy, it's because we didn't match a pattern above.\n  // Check to see if it is an ArrayLike, because if it is, we want to\n  // try to apply fromEvent to all of it's items. We do this check last,\n  // because there are may be some types that are both ArrayLike *and* implement\n  // event registry points, and we'd rather delegate to that when possible.\n  if (!add) {\n    if (isArrayLike(target)) {\n      return mergeMap((subTarget: any) => fromEvent(subTarget, eventName, options as EventListenerOptions))(\n        innerFrom(target)\n      ) as Observable<T>;\n    }\n  }\n\n  // If add is falsy and we made it here, it's because we didn't\n  // match any valid target objects above.\n  if (!add) {\n    throw new TypeError('Invalid event target');\n  }\n\n  return new Observable<T>((subscriber) => {\n    // The handler we are going to register. Forwards the event object, by itself, or\n    // an array of arguments to the event handler, if there is more than one argument,\n    // to the consumer.\n    const handler = (...args: any[]) => subscriber.next(1 < args.length ? args : args[0]);\n    // Do the work of adding the handler to the target.\n    add(handler);\n    // When we finalize, we want to remove the handler and free up memory.\n    return () => remove!(handler);\n  });\n}\n\n/**\n * Used to create `add` and `remove` functions to register and unregister event handlers\n * from a target in the most common handler pattern, where there are only two arguments.\n * (e.g.  `on(name, fn)`, `off(name, fn)`, `addListener(name, fn)`, or `removeListener(name, fn)`)\n * @param target The target we're calling methods on\n * @param eventName The event name for the event we're creating register or unregister functions for\n */\nfunction toCommonHandlerRegistry(target: any, eventName: string) {\n  return (methodName: string) => (handler: any) => target[methodName](eventName, handler);\n}\n\n/**\n * Checks to see if the target implements the required node-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isNodeStyleEventEmitter(target: any): target is NodeStyleEventEmitter {\n  return isFunction(target.addListener) && isFunction(target.removeListener);\n}\n\n/**\n * Checks to see if the target implements the required jQuery-style EventEmitter methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isJQueryStyleEventEmitter(target: any): target is JQueryStyleEventEmitter<any, any> {\n  return isFunction(target.on) && isFunction(target.off);\n}\n\n/**\n * Checks to see if the target implements the required EventTarget methods\n * for adding and removing event handlers.\n * @param target the object to check\n */\nfunction isEventTarget(target: any): target is HasEventTargetAddRemove<any> {\n  return isFunction(target.addEventListener) && isFunction(target.removeEventListener);\n}\n", "import { Observable } from '../Observable';\nimport { isFunction } from '../util/isFunction';\nimport { NodeEventHandler } from './fromEvent';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\n\n/* tslint:disable:max-line-length */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void\n): Observable<T>;\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Creates an Observable from an arbitrary API for registering event handlers.\n *\n * <span class=\"informal\">When that method for adding event handler was something {@link fromEvent}\n * was not prepared for.</span>\n *\n * ![](fromEventPattern.png)\n *\n * `fromEventPattern` allows you to convert into an Observable any API that supports registering handler functions\n * for events. It is similar to {@link fromEvent}, but far\n * more flexible. In fact, all use cases of {@link fromEvent} could be easily handled by\n * `fromEventPattern` (although in slightly more verbose way).\n *\n * This operator accepts as a first argument an `addHandler` function, which will be injected with\n * handler parameter. That handler is actually an event handler function that you now can pass\n * to API expecting it. `addHandler` will be called whenever Observable\n * returned by the operator is subscribed, so registering handler in API will not\n * necessarily happen when `fromEventPattern` is called.\n *\n * After registration, every time an event that we listen to happens,\n * Observable returned by `fromEventPattern` will emit value that event handler\n * function was called with. Note that if event handler was called with more\n * than one argument, second and following arguments will not appear in the Observable.\n *\n * If API you are using allows to unregister event handlers as well, you can pass to `fromEventPattern`\n * another function - `removeHandler` - as a second parameter. It will be injected\n * with the same handler function as before, which now you can use to unregister\n * it from the API. `removeHandler` will be called when consumer of resulting Observable\n * unsubscribes from it.\n *\n * In some APIs unregistering is actually handled differently. Method registering an event handler\n * returns some kind of token, which is later used to identify which function should\n * be unregistered or it itself has method that unregisters event handler.\n * If that is the case with your API, make sure token returned\n * by registering method is returned by `addHandler`. Then it will be passed\n * as a second argument to `removeHandler`, where you will be able to use it.\n *\n * If you need access to all event handler parameters (not only the first one),\n * or you need to transform them in any way, you can call `fromEventPattern` with optional\n * third parameter - project function which will accept all arguments passed to\n * event handler when it is called. Whatever is returned from project function will appear on\n * resulting stream instead of usual event handlers first argument. This means\n * that default project can be thought of as function that takes its first parameter\n * and ignores the rest.\n *\n * ## Examples\n *\n * Emits clicks happening on the DOM document\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * function addClickHandler(handler) {\n *   document.addEventListener('click', handler);\n * }\n *\n * function removeClickHandler(handler) {\n *   document.removeEventListener('click', handler);\n * }\n *\n * const clicks = fromEventPattern(\n *   addClickHandler,\n *   removeClickHandler\n * );\n * clicks.subscribe(x => console.log(x));\n *\n * // Whenever you click anywhere in the browser, DOM MouseEvent\n * // object will be logged.\n * ```\n *\n * Use with API that returns cancellation token\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * const token = someAPI.registerEventHandler(function() {});\n * someAPI.unregisterEventHandler(token); // this APIs cancellation method accepts\n *                                        // not handler itself, but special token.\n *\n * const someAPIObservable = fromEventPattern(\n *   function(handler) { return someAPI.registerEventHandler(handler); }, // Note that we return the token here...\n *   function(handler, token) { someAPI.unregisterEventHandler(token); }  // ...to then use it here.\n * );\n * ```\n *\n * Use with project function\n *\n * ```ts\n * import { fromEventPattern } from 'rxjs';\n *\n * someAPI.registerEventHandler((eventType, eventMessage) => {\n *   console.log(eventType, eventMessage); // Logs 'EVENT_TYPE' 'EVENT_MESSAGE' to console.\n * });\n *\n * const someAPIObservable = fromEventPattern(\n *   handler => someAPI.registerEventHandler(handler),\n *   handler => someAPI.unregisterEventHandler(handler)\n *   (eventType, eventMessage) => eventType + ' --- ' + eventMessage // without that function only 'EVENT_TYPE'\n * );                                                                // would be emitted by the Observable\n *\n * someAPIObservable.subscribe(value => console.log(value));\n *\n * // Logs:\n * // 'EVENT_TYPE --- EVENT_MESSAGE'\n * ```\n *\n * @see {@link fromEvent}\n * @see {@link bindCallback}\n * @see {@link bindNodeCallback}\n *\n * @param {function(handler: Function): any} addHandler A function that takes\n * a `handler` function as argument and attaches it somehow to the actual\n * source of events.\n * @param {function(handler: Function, token?: any): void} [removeHandler] A function that\n * takes a `handler` function as an argument and removes it from the event source. If `addHandler`\n * returns some kind of token, `removeHandler` function will have it as a second parameter.\n * @param {function(...args: any): T} [project] A function to\n * transform results. It takes the arguments from the event handler and\n * should return a single value.\n * @return {Observable<T>} Observable which, when an event happens, emits first parameter\n * passed to registered event handler. Alternatively it emits whatever project function returns\n * at that moment.\n */\nexport function fromEventPattern<T>(\n  addHandler: (handler: NodeEventHandler) => any,\n  removeHandler?: (handler: NodeEventHandler, signal?: any) => void,\n  resultSelector?: (...args: any[]) => T\n): Observable<T | T[]> {\n  if (resultSelector) {\n    return fromEventPattern<T>(addHandler, removeHandler).pipe(mapOneOrManyArgs(resultSelector));\n  }\n\n  return new Observable<T | T[]>((subscriber) => {\n    const handler = (...e: T[]) => subscriber.next(e.length === 1 ? e[0] : e);\n    const retValue = addHandler(handler);\n    return isFunction(removeHandler) ? () => removeHandler(handler, retValue) : undefined;\n  });\n}\n", "import { Observable } from '../Observable';\nimport { SchedulerLike } from '../types';\nimport { async as asyncScheduler } from '../scheduler/async';\nimport { isScheduler } from '../util/isScheduler';\nimport { isValidDate } from '../util/isDate';\n\n/**\n * Creates an observable that will wait for a specified time period, or exact date, before\n * emitting the number 0.\n *\n * <span class=\"informal\">Used to emit a notification after a delay.</span>\n *\n * This observable is useful for creating delays in code, or racing against other values\n * for ad-hoc timeouts.\n *\n * The `delay` is specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Examples\n *\n * Wait 3 seconds and start another observable\n *\n * You might want to use `timer` to delay subscription to an\n * observable by a set amount of time. Here we use a timer with\n * {@link concatMapTo} or {@link concatMap} in order to wait\n * a few seconds and start a subscription to a source.\n *\n * ```ts\n * import { of, timer, concatMap } from 'rxjs';\n *\n * // This could be any observable\n * const source = of(1, 2, 3);\n *\n * timer(3000)\n *   .pipe(concatMap(() => source))\n *   .subscribe(console.log);\n * ```\n *\n * Take all values until the start of the next minute\n *\n * Using a `Date` as the trigger for the first emission, you can\n * do things like wait until midnight to fire an event, or in this case,\n * wait until a new minute starts (chosen so the example wouldn't take\n * too long to run) in order to stop watching a stream. Leveraging\n * {@link takeUntil}.\n *\n * ```ts\n * import { interval, takeUntil, timer } from 'rxjs';\n *\n * // Build a Date object that marks the\n * // next minute.\n * const currentDate = new Date();\n * const startOfNextMinute = new Date(\n *   currentDate.getFullYear(),\n *   currentDate.getMonth(),\n *   currentDate.getDate(),\n *   currentDate.getHours(),\n *   currentDate.getMinutes() + 1\n * );\n *\n * // This could be any observable stream\n * const source = interval(1000);\n *\n * const result = source.pipe(\n *   takeUntil(timer(startOfNextMinute))\n * );\n *\n * result.subscribe(console.log);\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `dueTime`.\n *\n * @param due If a `number`, the amount of time in milliseconds to wait before emitting.\n * If a `Date`, the exact time at which to emit.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(due: number | Date, scheduler?: SchedulerLike): Observable<0>;\n\n/**\n * Creates an observable that starts an interval after a specified delay, emitting incrementing numbers -- starting at `0` --\n * on each interval after words.\n *\n * The `delay` and `intervalDuration` are specified by default in milliseconds, however providing a custom scheduler could\n * create a different behavior.\n *\n * ## Example\n *\n * ### Start an interval that starts right away\n *\n * Since {@link interval} waits for the passed delay before starting,\n * sometimes that's not ideal. You may want to start an interval immediately.\n * `timer` works well for this. Here we have both side-by-side so you can\n * see them in comparison.\n *\n * Note that this observable will never complete.\n *\n * ```ts\n * import { timer, interval } from 'rxjs';\n *\n * timer(0, 1000).subscribe(n => console.log('timer', n));\n * interval(1000).subscribe(n => console.log('interval', n));\n * ```\n *\n * ### Known Limitations\n *\n * - The {@link asyncScheduler} uses `setTimeout` which has limitations for how far in the future it can be scheduled.\n *\n * - If a `scheduler` is provided that returns a timestamp other than an epoch from `now()`, and\n * a `Date` object is passed to the `dueTime` argument, the calculation for when the first emission\n * should occur will be incorrect. In this case, it would be best to do your own calculations\n * ahead of time, and pass a `number` in as the `startDue`.\n * @param startDue If a `number`, is the time to wait before starting the interval.\n * If a `Date`, is the exact time at which to start the interval.\n * @param intervalDuration The delay between each value emitted in the interval. Passing a\n * negative number here will result in immediate completion after the first value is emitted, as though\n * no `intervalDuration` was passed at all.\n * @param scheduler The scheduler to use to schedule the delay. Defaults to {@link asyncScheduler}.\n */\nexport function timer(startDue: number | Date, intervalDuration: number, scheduler?: SchedulerLike): Observable<number>;\n\n/**\n * @deprecated The signature allowing `undefined` to be passed for `intervalDuration` will be removed in v8. Use the `timer(dueTime, scheduler?)` signature instead.\n */\nexport function timer(dueTime: number | Date, unused: undefined, scheduler?: SchedulerLike): Observable<0>;\n\nexport function timer(\n  dueTime: number | Date = 0,\n  intervalOrScheduler?: number | SchedulerLike,\n  scheduler: SchedulerLike = asyncScheduler\n): Observable<number> {\n  // Since negative intervalDuration is treated as though no\n  // interval was specified at all, we start with a negative number.\n  let intervalDuration = -1;\n\n  if (intervalOrScheduler != null) {\n    // If we have a second argument, and it's a scheduler,\n    // override the scheduler we had defaulted. Otherwise,\n    // it must be an interval.\n    if (isScheduler(intervalOrScheduler)) {\n      scheduler = intervalOrScheduler;\n    } else {\n      // Note that this *could* be negative, in which case\n      // it's like not passing an intervalDuration at all.\n      intervalDuration = intervalOrScheduler;\n    }\n  }\n\n  return new Observable((subscriber) => {\n    // If a valid date is passed, calculate how long to wait before\n    // executing the first value... otherwise, if it's a number just schedule\n    // that many milliseconds (or scheduler-specified unit size) in the future.\n    let due = isValidDate(dueTime) ? +dueTime - scheduler!.now() : dueTime;\n\n    if (due < 0) {\n      // Ensure we don't schedule in the future.\n      due = 0;\n    }\n\n    // The incrementing value we emit.\n    let n = 0;\n\n    // Start the timer.\n    return scheduler.schedule(function () {\n      if (!subscriber.closed) {\n        // Emit the next value and increment.\n        subscriber.next(n++);\n\n        if (0 <= intervalDuration) {\n          // If we have a interval after the initial timer,\n          // reschedule with the period.\n          this.schedule(undefined, intervalDuration);\n        } else {\n          // We didn't have an interval. So just complete.\n          subscriber.complete();\n        }\n      }\n    }, due);\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInput, ObservableInputTuple, SchedulerLike } from '../types';\nimport { mergeAll } from '../operators/mergeAll';\nimport { innerFrom } from './innerFrom';\nimport { EMPTY } from './empty';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from './from';\n\nexport function merge<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A[number]>;\nexport function merge<A extends readonly unknown[]>(...sourcesAndConcurrency: [...ObservableInputTuple<A>, number?]): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike?]\n): Observable<A[number]>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `mergeAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function merge<A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number?, SchedulerLike?]\n): Observable<A[number]>;\n\n/**\n * Creates an output Observable which concurrently emits all values from every\n * given input Observable.\n *\n * <span class=\"informal\">Flattens multiple Observables together by blending\n * their values into one Observable.</span>\n *\n * ![](merge.png)\n *\n * `merge` subscribes to each given input Observable (as arguments), and simply\n * forwards (without doing any transformation) all the values from all the input\n * Observables to the output Observable. The output Observable only completes\n * once all input Observables have completed. Any error delivered by an input\n * Observable will be immediately emitted on the output Observable.\n *\n * ## Examples\n *\n * Merge together two Observables: 1s interval and clicks\n *\n * ```ts\n * import { merge, fromEvent, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const clicksOrTimer = merge(clicks, timer);\n * clicksOrTimer.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // timer will emit ascending values, one every second(1000ms) to console\n * // clicks logs MouseEvents to console every time the \"document\" is clicked\n * // Since the two streams are merged you see these happening\n * // as they occur.\n * ```\n *\n * Merge together 3 Observables, but run only 2 concurrently\n *\n * ```ts\n * import { interval, take, merge } from 'rxjs';\n *\n * const timer1 = interval(1000).pipe(take(10));\n * const timer2 = interval(2000).pipe(take(6));\n * const timer3 = interval(500).pipe(take(10));\n *\n * const concurrent = 2; // the argument\n * const merged = merge(timer1, timer2, timer3, concurrent);\n * merged.subscribe(x => console.log(x));\n *\n * // Results in the following:\n * // - First timer1 and timer2 will run concurrently\n * // - timer1 will emit a value every 1000ms for 10 iterations\n * // - timer2 will emit a value every 2000ms for 6 iterations\n * // - after timer1 hits its max iteration, timer2 will\n * //   continue, and timer3 will start to run concurrently with timer2\n * // - when timer2 hits its max iteration it terminates, and\n * //   timer3 will continue to emit a value every 500ms until it is complete\n * ```\n *\n * @see {@link mergeAll}\n * @see {@link mergeMap}\n * @see {@link mergeMapTo}\n * @see {@link mergeScan}\n *\n * @param {...ObservableInput} observables Input Observables to merge together.\n * @param {number} [concurrent=Infinity] Maximum number of input\n * Observables being subscribed to concurrently.\n * @param {SchedulerLike} [scheduler=null] The {@link SchedulerLike} to use for managing\n * concurrency of input Observables.\n * @return {Observable} an Observable that emits items that are the result of\n * every input Observable.\n */\nexport function merge(...args: (ObservableInput<unknown> | number | SchedulerLike)[]): Observable<unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  const sources = args as ObservableInput<unknown>[];\n  return !sources.length\n    ? // No source provided\n      EMPTY\n    : sources.length === 1\n    ? // One source? Just return it.\n      innerFrom(sources[0])\n    : // Merge all sources\n      mergeAll(concurrent)(from(sources, scheduler));\n}\n", "import { Observable } from '../Observable';\nimport { noop } from '../util/noop';\n\n/**\n * An Observable that emits no items to the Observer and never completes.\n *\n * ![](never.png)\n *\n * A simple Observable that emits neither values nor errors nor the completion\n * notification. It can be used for testing purposes or for composing with other\n * Observables. Please note that by never emitting a complete notification, this\n * Observable keeps the subscription from being disposed automatically.\n * Subscriptions need to be manually disposed.\n *\n * ##  Example\n *\n * Emit the number 7, then never emit anything else (not even complete)\n *\n * ```ts\n * import { NEVER, startWith } from 'rxjs';\n *\n * const info = () => console.log('Will not be called');\n *\n * const result = NEVER.pipe(startWith(7));\n * result.subscribe({\n *   next: x => console.log(x),\n *   error: info,\n *   complete: info\n * });\n * ```\n *\n * @see {@link Observable}\n * @see {@link EMPTY}\n * @see {@link of}\n * @see {@link throwError}\n */\nexport const NEVER = new Observable<never>(noop);\n\n/**\n * @deprecated Replaced with the {@link NEVER} constant. Will be removed in v8.\n */\nexport function never() {\n  return NEVER;\n}\n", "const { isArray } = Array;\n\n/**\n * Used in operators and functions that accept either a list of arguments, or an array of arguments\n * as a single argument.\n */\nexport function argsOrArgArray<T>(args: (T | T[])[]): T[] {\n  return args.length === 1 && isArray(args[0]) ? args[0] : (args as T[]);\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, S extends T, A>(predicate: (this: A, value: T, index: number) => value is S, thisArg: A): OperatorFunction<T, S>;\nexport function filter<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function filter<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\n/** @deprecated Use a closure instead of a `thisArg`. Signatures accepting a `thisArg` will be removed in v8. */\nexport function filter<T, A>(predicate: (this: A, value: T, index: number) => boolean, thisArg: A): MonoTypeOperatorFunction<T>;\nexport function filter<T>(predicate: (value: T, index: number) => boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Filter items emitted by the source Observable by only emitting those that\n * satisfy a specified predicate.\n *\n * <span class=\"informal\">Like\n * [Array.prototype.filter()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter),\n * it only emits a value from the source if it passes a criterion function.</span>\n *\n * ![](filter.png)\n *\n * Similar to the well-known `Array.prototype.filter` method, this operator\n * takes values from the source Observable, passes them through a `predicate`\n * function and only emits those values that yielded `true`.\n *\n * ## Example\n *\n * Emit only click events whose target was a DIV element\n *\n * ```ts\n * import { fromEvent, filter } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksOnDivs = clicks.pipe(filter(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * clicksOnDivs.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n * @see {@link distinctUntilKeyChanged}\n * @see {@link ignoreElements}\n * @see {@link partition}\n * @see {@link skip}\n *\n * @param predicate A function that\n * evaluates each value emitted by the source Observable. If it returns `true`,\n * the value is emitted, if `false` the value is not passed to the output\n * Observable. The `index` parameter is the number `i` for the i-th source\n * emission that has happened since the subscription, starting from the number\n * `0`.\n * @param thisArg An optional argument to determine the value of `this`\n * in the `predicate` function.\n * @return A function that returns an Observable that emits items from the\n * source Observable that satisfy the specified `predicate`.\n */\nexport function filter<T>(predicate: (value: T, index: number) => boolean, thisArg?: any): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // An index passed to our predicate function on each call.\n    let index = 0;\n\n    // Subscribe to the source, all errors and completions are\n    // forwarded to the consumer.\n    source.subscribe(\n      // Call the predicate with the appropriate `this` context,\n      // if the predicate returns `true`, then send the value\n      // to the consumer.\n      createOperatorSubscriber(subscriber, (value) => predicate.call(thisArg, value, index++) && subscriber.next(value))\n    );\n  });\n}\n", "import { Observable } from '../Observable';\nimport { ObservableInputTuple } from '../types';\nimport { innerFrom } from './innerFrom';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { EMPTY } from './empty';\nimport { createOperatorSubscriber } from '../operators/OperatorSubscriber';\nimport { popResultSelector } from '../util/args';\n\nexport function zip<A extends readonly unknown[]>(sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  resultSelector: (...values: A) => R\n): Observable<R>;\nexport function zip<A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): Observable<A>;\nexport function zip<A extends readonly unknown[], R>(\n  ...sourcesAndResultSelector: [...ObservableInputTuple<A>, (...values: A) => R]\n): Observable<R>;\n\n/**\n * Combines multiple Observables to create an Observable whose values are calculated from the values, in order, of each\n * of its input Observables.\n *\n * If the last parameter is a function, this function is used to compute the created value from the input values.\n * Otherwise, an array of the input values is returned.\n *\n * ## Example\n *\n * Combine age and name from different sources\n *\n * ```ts\n * import { of, zip, map } from 'rxjs';\n *\n * const age$ = of(27, 25, 29);\n * const name$ = of('Foo', 'Bar', 'Beer');\n * const isDev$ = of(true, true, false);\n *\n * zip(age$, name$, isDev$).pipe(\n *   map(([age, name, isDev]) => ({ age, name, isDev }))\n * )\n * .subscribe(x => console.log(x));\n *\n * // Outputs\n * // { age: 27, name: 'Foo', isDev: true }\n * // { age: 25, name: 'Bar', isDev: true }\n * // { age: 29, name: 'Beer', isDev: false }\n * ```\n *\n * @param sources\n * @return {Observable<R>}\n */\nexport function zip(...args: unknown[]): Observable<unknown> {\n  const resultSelector = popResultSelector(args);\n\n  const sources = argsOrArgArray(args) as Observable<unknown>[];\n\n  return sources.length\n    ? new Observable<unknown[]>((subscriber) => {\n        // A collection of buffers of values from each source.\n        // Keyed by the same index with which the sources were passed in.\n        let buffers: unknown[][] = sources.map(() => []);\n\n        // An array of flags of whether or not the sources have completed.\n        // This is used to check to see if we should complete the result.\n        // Keyed by the same index with which the sources were passed in.\n        let completed = sources.map(() => false);\n\n        // When everything is done, release the arrays above.\n        subscriber.add(() => {\n          buffers = completed = null!;\n        });\n\n        // Loop over our sources and subscribe to each one. The index `i` is\n        // especially important here, because we use it in closures below to\n        // access the related buffers and completion properties\n        for (let sourceIndex = 0; !subscriber.closed && sourceIndex < sources.length; sourceIndex++) {\n          innerFrom(sources[sourceIndex]).subscribe(\n            createOperatorSubscriber(\n              subscriber,\n              (value) => {\n                buffers[sourceIndex].push(value);\n                // if every buffer has at least one value in it, then we\n                // can shift out the oldest value from each buffer and emit\n                // them as an array.\n                if (buffers.every((buffer) => buffer.length)) {\n                  const result: any = buffers.map((buffer) => buffer.shift()!);\n                  // Emit the array. If theres' a result selector, use that.\n                  subscriber.next(resultSelector ? resultSelector(...result) : result);\n                  // If any one of the sources is both complete and has an empty buffer\n                  // then we complete the result. This is because we cannot possibly have\n                  // any more values to zip together.\n                  if (buffers.some((buffer, i) => !buffer.length && completed[i])) {\n                    subscriber.complete();\n                  }\n                }\n              },\n              () => {\n                // This source completed. Mark it as complete so we can check it later\n                // if we have to.\n                completed[sourceIndex] = true;\n                // But, if this complete source has nothing in its buffer, then we\n                // can complete the result, because we can't possibly have any more\n                // values from this to zip together with the other values.\n                !buffers[sourceIndex].length && subscriber.complete();\n              }\n            )\n          );\n        }\n\n        // When everything is done, release the arrays above.\n        return () => {\n          buffers = completed = null!;\n        };\n      })\n    : EMPTY;\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\n\nimport { operate } from '../util/lift';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Ignores source values for a duration determined by another Observable, then\n * emits the most recent value from the source Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link auditTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](audit.svg)\n *\n * `audit` is similar to `throttle`, but emits the last value from the silenced\n * time window, instead of the first value. `audit` emits the most recent value\n * from the source Observable on the output Observable as soon as its internal\n * timer becomes disabled, and ignores source values while the timer is enabled.\n * Initially, the timer is disabled. As soon as the first source value arrives,\n * the timer is enabled by calling the `durationSelector` function with the\n * source value, which returns the \"duration\" Observable. When the duration\n * Observable emits a value, the timer is disabled, then the most\n * recent source value is emitted on the output Observable, and this process\n * repeats for the next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, audit, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(audit(ev => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttle}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the silencing\n * duration, returned as an Observable or a Promise.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function audit<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    let durationSubscriber: Subscriber<any> | null = null;\n    let isComplete = false;\n\n    const endDuration = () => {\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n      isComplete && subscriber.complete();\n    };\n\n    const cleanupDuration = () => {\n      durationSubscriber = null;\n      isComplete && subscriber.complete();\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          lastValue = value;\n          if (!durationSubscriber) {\n            innerFrom(durationSelector(value)).subscribe(\n              (durationSubscriber = createOperatorSubscriber(subscriber, endDuration, cleanupDuration))\n            );\n          }\n        },\n        () => {\n          isComplete = true;\n          (!hasValue || !durationSubscriber || durationSubscriber.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { audit } from './audit';\nimport { timer } from '../observable/timer';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\n\n/**\n * Ignores source values for `duration` milliseconds, then emits the most recent\n * value from the source Observable, then repeats this process.\n *\n * <span class=\"informal\">When it sees a source value, it ignores that plus\n * the next ones for `duration` milliseconds, and then it emits the most recent\n * value from the source.</span>\n *\n * ![](auditTime.png)\n *\n * `auditTime` is similar to `throttleTime`, but emits the last value from the\n * silenced time window, instead of the first value. `auditTime` emits the most\n * recent value from the source Observable on the output Observable as soon as\n * its internal timer becomes disabled, and ignores source values while the\n * timer is enabled. Initially, the timer is disabled. As soon as the first\n * source value arrives, the timer is enabled. After `duration` milliseconds (or\n * the time unit determined internally by the optional `scheduler`) has passed,\n * the timer is disabled, then the most recent source value is emitted on the\n * output Observable, and this process repeats for the next source value.\n * Optionally takes a {@link SchedulerLike} for managing timers.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, auditTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(auditTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttleTime}\n *\n * @param {number} duration Time to wait before emitting the most recent source\n * value, measured in milliseconds or the time unit determined internally\n * by the optional `scheduler`.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the rate-limiting behavior.\n * @return A function that returns an Observable that performs rate-limiting of\n * emissions from the source Observable.\n */\nexport function auditTime<T>(duration: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return audit(() => timer(duration, scheduler));\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { arrRemove } from '../util/arrRemove';\n\n/**\n * Buffers the source Observable values until the size hits the maximum\n * `bufferSize` given.\n *\n * <span class=\"informal\">Collects values from the past as an array, and emits\n * that array only when its size reaches `bufferSize`.</span>\n *\n * ![](bufferCount.png)\n *\n * Buffers a number of values from the source Observable by `bufferSize` then\n * emits the buffer and clears it, and starts a new buffer each\n * `startBufferEvery` values. If `startBufferEvery` is not provided or is\n * `null`, then new buffers are started immediately at the start of the source\n * and when each buffer closes and is emitted.\n *\n * ## Examples\n *\n * Emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * On every click, emit the last two click events as an array\n *\n * ```ts\n * import { fromEvent, bufferCount } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const buffered = clicks.pipe(bufferCount(2, 1));\n * buffered.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link buffer}\n * @see {@link bufferTime}\n * @see {@link bufferToggle}\n * @see {@link bufferWhen}\n * @see {@link pairwise}\n * @see {@link windowCount}\n *\n * @param {number} bufferSize The maximum size of the buffer emitted.\n * @param {number} [startBufferEvery] Interval at which to start a new buffer.\n * For example if `startBufferEvery` is `2`, then a new buffer will be started\n * on every other value from the source. A new buffer is started at the\n * beginning of the source by default.\n * @return A function that returns an Observable of arrays of buffered values.\n */\nexport function bufferCount<T>(bufferSize: number, startBufferEvery: number | null = null): OperatorFunction<T, T[]> {\n  // If no `startBufferEvery` value was supplied, then we're\n  // opening and closing on the bufferSize itself.\n  startBufferEvery = startBufferEvery ?? bufferSize;\n\n  return operate((source, subscriber) => {\n    let buffers: T[][] = [];\n    let count = 0;\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          let toEmit: T[][] | null = null;\n\n          // Check to see if we need to start a buffer.\n          // This will start one at the first value, and then\n          // a new one every N after that.\n          if (count++ % startBufferEvery! === 0) {\n            buffers.push([]);\n          }\n\n          // Push our value into our active buffers.\n          for (const buffer of buffers) {\n            buffer.push(value);\n            // Check to see if we're over the bufferSize\n            // if we are, record it so we can emit it later.\n            // If we emitted it now and removed it, it would\n            // mutate the `buffers` array while we're looping\n            // over it.\n            if (bufferSize <= buffer.length) {\n              toEmit = toEmit ?? [];\n              toEmit.push(buffer);\n            }\n          }\n\n          if (toEmit) {\n            // We have found some buffers that are over the\n            // `bufferSize`. Emit them, and remove them from our\n            // buffers list.\n            for (const buffer of toEmit) {\n              arrRemove(buffers, buffer);\n              subscriber.next(buffer);\n            }\n          }\n        },\n        () => {\n          // When the source completes, emit all of our\n          // active buffers.\n          for (const buffer of buffers) {\n            subscriber.next(buffer);\n          }\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Clean up our memory when we finalize\n          buffers = null!;\n        }\n      )\n    );\n  });\n}\n", "import { Observable } from '../Observable';\n\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { Subscription } from '../Subscription';\nimport { innerFrom } from '../observable/innerFrom';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { operate } from '../util/lift';\n\n/* tslint:disable:max-line-length */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>>;\n/* tslint:enable:max-line-length */\n\n/**\n * Catches errors on the observable to be handled by returning a new observable or throwing an error.\n *\n * <span class=\"informal\">\n * It only listens to the error channel and ignores notifications.\n * Handles errors from the source observable, and maps them to a new observable.\n * The error may also be rethrown, or a new error can be thrown to emit an error from the result.\n * </span>\n *\n * ![](catch.png)\n *\n * This operator handles errors, but forwards along all other events to the resulting observable.\n * If the source observable terminates with an error, it will map that error to a new observable,\n * subscribe to it, and forward all of its events to the resulting observable.\n *\n * ## Examples\n *\n * Continue with a different Observable when there's an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => of('I', 'II', 'III', 'IV', 'V'))\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, I, II, III, IV, V\n * ```\n *\n * Retry the caught source Observable again in case of error, similar to `retry()` operator\n *\n * ```ts\n * import { of, map, catchError, take } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError((err, caught) => caught),\n *     take(30)\n *   )\n *   .subscribe(x => console.log(x));\n *   // 1, 2, 3, 1, 2, 3, ...\n * ```\n *\n * Throw a new error when the source Observable throws an error\n *\n * ```ts\n * import { of, map, catchError } from 'rxjs';\n *\n * of(1, 2, 3, 4, 5)\n *   .pipe(\n *     map(n => {\n *       if (n === 4) {\n *         throw 'four!';\n *       }\n *       return n;\n *     }),\n *     catchError(err => {\n *       throw 'error in source. Details: ' + err;\n *     })\n *   )\n *   .subscribe({\n *     next: x => console.log(x),\n *     error: err => console.log(err)\n *   });\n *   // 1, 2, 3, error in source. Details: four!\n * ```\n *\n * @see {@link onErrorResumeNext}\n * @see {@link repeat}\n * @see {@link repeatWhen}\n * @see {@link retry }\n * @see {@link retryWhen}\n *\n * @param {function} selector a function that takes as arguments `err`, which is the error, and `caught`, which\n * is the source observable, in case you'd like to \"retry\" that observable by returning it again. Whatever observable\n * is returned by the `selector` will be used to continue the observable chain.\n * @return A function that returns an Observable that originates from either\n * the source or the Observable returned by the `selector` function.\n */\nexport function catchError<T, O extends ObservableInput<any>>(\n  selector: (err: any, caught: Observable<T>) => O\n): OperatorFunction<T, T | ObservedValueOf<O>> {\n  return operate((source, subscriber) => {\n    let innerSub: Subscription | null = null;\n    let syncUnsub = false;\n    let handledResult: Observable<ObservedValueOf<O>>;\n\n    innerSub = source.subscribe(\n      createOperatorSubscriber(subscriber, undefined, undefined, (err) => {\n        handledResult = innerFrom(selector(err, catchError(selector)(source)));\n        if (innerSub) {\n          innerSub.unsubscribe();\n          innerSub = null;\n          handledResult.subscribe(subscriber);\n        } else {\n          // We don't have an innerSub yet, that means the error was synchronous\n          // because the subscribe call hasn't returned yet.\n          syncUnsub = true;\n        }\n      })\n    );\n\n    if (syncUnsub) {\n      // We have a synchronous error, we need to make sure to\n      // finalize right away. This ensures that callbacks in the `finalize` operator are called\n      // at the right time, and that finalization occurs at the expected\n      // time between the source error and the subscription to the\n      // next observable.\n      innerSub.unsubscribe();\n      innerSub = null;\n      handledResult!.subscribe(subscriber);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { Subscriber } from '../Subscriber';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * A basic scan operation. This is used for `scan` and `reduce`.\n * @param accumulator The accumulator to use\n * @param seed The seed value for the state to accumulate\n * @param hasSeed Whether or not a seed was provided\n * @param emitOnNext Whether or not to emit the state on next\n * @param emitBeforeComplete Whether or not to emit the before completion\n */\n\nexport function scanInternals<V, A, S>(\n  accumulator: (acc: V | A | S, value: V, index: number) => A,\n  seed: S,\n  hasSeed: boolean,\n  emitOnNext: boolean,\n  emitBeforeComplete?: undefined | true\n) {\n  return (source: Observable<V>, subscriber: Subscriber<any>) => {\n    // Whether or not we have state yet. This will only be\n    // false before the first value arrives if we didn't get\n    // a seed value.\n    let hasState = hasSeed;\n    // The state that we're tracking, starting with the seed,\n    // if there is one, and then updated by the return value\n    // from the accumulator on each emission.\n    let state: any = seed;\n    // An index to pass to the accumulator function.\n    let index = 0;\n\n    // Subscribe to our source. All errors and completions are passed through.\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Always increment the index.\n          const i = index++;\n          // Set the state\n          state = hasState\n            ? // We already have state, so we can get the new state from the accumulator\n              accumulator(state, value, i)\n            : // We didn't have state yet, a seed value was not provided, so\n\n              // we set the state to the first value, and mark that we have state now\n              ((hasState = true), value);\n\n          // Maybe send it to the consumer.\n          emitOnNext && subscriber.next(state);\n        },\n        // If an onComplete was given, call it, otherwise\n        // just pass through the complete notification to the consumer.\n        emitBeforeComplete &&\n          (() => {\n            hasState && subscriber.next(state);\n            subscriber.complete();\n          })\n      )\n    );\n  };\n}\n", "import { combineLatestInit } from '../observable/combineLatest';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mapOneOrManyArgs } from '../util/mapOneOrManyArgs';\nimport { pipe } from '../util/pipe';\nimport { popResultSelector } from '../util/args';\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  sources: [...ObservableInputTuple<A>],\n  project: (...values: [T, ...A]) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(\n  ...sourcesAndProject: [...ObservableInputTuple<A>, (...values: [T, ...A]) => R]\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8. */\nexport function combineLatest<T, A extends readonly unknown[], R>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, [T, ...A]>;\n\n/**\n * @deprecated Replaced with {@link combineLatestWith}. Will be removed in v8.\n */\nexport function combineLatest<T, R>(...args: (ObservableInput<any> | ((...values: any[]) => R))[]): OperatorFunction<T, unknown> {\n  const resultSelector = popResultSelector(args);\n  return resultSelector\n    ? pipe(combineLatest(...(args as Array<ObservableInput<any>>)), mapOneOrManyArgs(resultSelector))\n    : operate((source, subscriber) => {\n        combineLatestInit([source, ...argsOrArgArray(args)])(subscriber);\n      });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { combineLatest } from './combineLatest';\n\n/**\n * Create an observable that combines the latest values from all passed observables and the source\n * into arrays and emits them.\n *\n * Returns an observable, that when subscribed to, will subscribe to the source observable and all\n * sources provided as arguments. Once all sources emit at least one value, all of the latest values\n * will be emitted as an array. After that, every time any source emits a value, all of the latest values\n * will be emitted as an array.\n *\n * This is a useful operator for eagerly calculating values based off of changed inputs.\n *\n * ## Example\n *\n * Simple concatenation of values from two inputs\n *\n * ```ts\n * import { fromEvent, combineLatestWith, map } from 'rxjs';\n *\n * // Setup: Add two inputs to the page\n * const input1 = document.createElement('input');\n * document.body.appendChild(input1);\n * const input2 = document.createElement('input');\n * document.body.appendChild(input2);\n *\n * // Get streams of changes\n * const input1Changes$ = fromEvent(input1, 'change');\n * const input2Changes$ = fromEvent(input2, 'change');\n *\n * // Combine the changes by adding them together\n * input1Changes$.pipe(\n *   combineLatestWith(input2Changes$),\n *   map(([e1, e2]) => (<HTMLInputElement>e1.target).value + ' - ' + (<HTMLInputElement>e2.target).value)\n * )\n * .subscribe(x => console.log(x));\n * ```\n *\n * @param otherSources the other sources to subscribe to.\n * @return A function that returns an Observable that emits the latest\n * emissions from both source and provided Observables.\n */\nexport function combineLatestWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, Cons<T, A>> {\n  return combineLatest(...otherSources);\n}\n", "import { Subscriber } from '../Subscriber';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { noop } from '../util/noop';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * determined by another Observable has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link debounceTime}, but the time span of\n * emission silence is determined by a second Observable.</span>\n *\n * ![](debounce.svg)\n *\n * `debounce` delays notifications emitted by the source Observable, but drops previous\n * pending delayed emissions if a new notification arrives on the source Observable.\n * This operator keeps track of the most recent notification from the source\n * Observable, and spawns a duration Observable by calling the\n * `durationSelector` function. The notification is emitted only when the duration\n * Observable emits a next notification, and if no other notification was emitted on\n * the source Observable since the duration Observable was spawned. If a new\n * notification appears before the duration Observable emits, the previous notification will\n * not be emitted and a new duration is scheduled from `durationSelector` is scheduled.\n * If the completing event happens during the scheduled duration the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during the scheduled duration or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * Like {@link debounceTime}, this is a rate-limiting operator, and also a\n * delay-like operator since output emissions do not necessarily occur at the\n * same time as they did on the source Observable.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, scan, debounce, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(\n *   scan(i => ++i, 1),\n *   debounce(i => interval(200 * i))\n * );\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function\n * that receives a value from the source Observable, for computing the timeout\n * duration for each source value, returned as an Observable or a Promise.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified duration Observable returned by\n * `durationSelector`, and may drop some values if they occur too frequently.\n */\nexport function debounce<T>(durationSelector: (value: T) => ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    let lastValue: T | null = null;\n    // The subscriber/subscription for the current debounce, if there is one.\n    let durationSubscriber: Subscriber<any> | null = null;\n\n    const emit = () => {\n      // Unsubscribe any current debounce subscription we have,\n      // we only cared about the first notification from it, and we\n      // want to clean that subscription up as soon as possible.\n      durationSubscriber?.unsubscribe();\n      durationSubscriber = null;\n      if (hasValue) {\n        // We have a value! Free up memory first, then emit the value.\n        hasValue = false;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          // Cancel any pending debounce duration. We don't\n          // need to null it out here yet tho, because we're just going\n          // to create another one in a few lines.\n          durationSubscriber?.unsubscribe();\n          hasValue = true;\n          lastValue = value;\n          // Capture our duration subscriber, so we can unsubscribe it when we're notified\n          // and we're going to emit the value.\n          durationSubscriber = createOperatorSubscriber(subscriber, emit, noop);\n          // Subscribe to the duration.\n          innerFrom(durationSelector(value)).subscribe(durationSubscriber);\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = durationSubscriber = null;\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SchedulerAction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a notification from the source Observable only after a particular time span\n * has passed without another source emission.\n *\n * <span class=\"informal\">It's like {@link delay}, but passes only the most\n * recent notification from each burst of emissions.</span>\n *\n * ![](debounceTime.png)\n *\n * `debounceTime` delays notifications emitted by the source Observable, but drops\n * previous pending delayed emissions if a new notification arrives on the source\n * Observable. This operator keeps track of the most recent notification from the\n * source Observable, and emits that only when `dueTime` has passed\n * without any other notification appearing on the source Observable. If a new value\n * appears before `dueTime` silence occurs, the previous notification will be dropped\n * and will not be emitted and a new `dueTime` is scheduled.\n * If the completing event happens during `dueTime` the last cached notification\n * is emitted before the completion event is forwarded to the output observable.\n * If the error event happens during `dueTime` or after it only the error event is\n * forwarded to the output observable. The cache notification is not emitted in this case.\n *\n * This is a rate-limiting operator, because it is impossible for more than one\n * notification to be emitted in any time window of duration `dueTime`, but it is also\n * a delay-like operator since output emissions do not occur at the same time as\n * they did on the source Observable. Optionally takes a {@link SchedulerLike} for\n * managing timers.\n *\n * ## Example\n *\n * Emit the most recent click after a burst of clicks\n *\n * ```ts\n * import { fromEvent, debounceTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(debounceTime(1000));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link auditTime}\n * @see {@link debounce}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link throttle}\n * @see {@link throttleTime}\n *\n * @param {number} dueTime The timeout duration in milliseconds (or the time\n * unit determined internally by the optional `scheduler`) for the window of\n * time required to wait for emission silence before emitting the most recent\n * source value.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the timeout for each value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified `dueTime`, and may drop some values\n * if they occur too frequently.\n */\nexport function debounceTime<T>(dueTime: number, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let activeTask: Subscription | null = null;\n    let lastValue: T | null = null;\n    let lastTime: number | null = null;\n\n    const emit = () => {\n      if (activeTask) {\n        // We have a value! Free up memory first, then emit the value.\n        activeTask.unsubscribe();\n        activeTask = null;\n        const value = lastValue!;\n        lastValue = null;\n        subscriber.next(value);\n      }\n    };\n    function emitWhenIdle(this: SchedulerAction<unknown>) {\n      // This is called `dueTime` after the first value\n      // but we might have received new values during this window!\n\n      const targetTime = lastTime! + dueTime;\n      const now = scheduler.now();\n      if (now < targetTime) {\n        // On that case, re-schedule to the new target\n        activeTask = this.schedule(undefined, targetTime - now);\n        subscriber.add(activeTask);\n        return;\n      }\n\n      emit();\n    }\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value: T) => {\n          lastValue = value;\n          lastTime = scheduler.now();\n\n          // Only set up a task if it's not already up\n          if (!activeTask) {\n            activeTask = scheduler.schedule(emitWhenIdle, dueTime);\n            subscriber.add(activeTask);\n          }\n        },\n        () => {\n          // Source completed.\n          // Emit any pending debounced values then complete\n          emit();\n          subscriber.complete();\n        },\n        // Pass all errors through to consumer.\n        undefined,\n        () => {\n          // Finalization.\n          lastValue = activeTask = null;\n        }\n      )\n    );\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits a given value if the source Observable completes without emitting any\n * `next` value, otherwise mirrors the source Observable.\n *\n * <span class=\"informal\">If the source Observable turns out to be empty, then\n * this operator will emit a default value.</span>\n *\n * ![](defaultIfEmpty.png)\n *\n * `defaultIfEmpty` emits the values emitted by the source Observable or a\n * specified default value if the source Observable is empty (completes without\n * having emitted any `next` value).\n *\n * ## Example\n *\n * If no clicks happen in 5 seconds, then emit 'no clicks'\n *\n * ```ts\n * import { fromEvent, takeUntil, interval, defaultIfEmpty } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const clicksBeforeFive = clicks.pipe(takeUntil(interval(5000)));\n * const result = clicksBeforeFive.pipe(defaultIfEmpty('no clicks'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link empty}\n * @see {@link last}\n *\n * @param defaultValue The default value used if the source\n * Observable is empty.\n * @return A function that returns an Observable that emits either the\n * specified `defaultValue` if the source Observable emits no items, or the\n * values emitted by the source Observable.\n */\nexport function defaultIfEmpty<T, R>(defaultValue: R): OperatorFunction<T, T | R> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => {\n          if (!hasValue) {\n            subscriber.next(defaultValue!);\n          }\n          subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Emits only the first `count` values emitted by the source Observable.\n *\n * <span class=\"informal\">Takes the first `count` values from the source, then\n * completes.</span>\n *\n * ![](take.png)\n *\n * `take` returns an Observable that emits only the first `count` values emitted\n * by the source Observable. If the source emits fewer than `count` values then\n * all of its values are emitted. After that, it completes, regardless if the\n * source completes.\n *\n * ## Example\n *\n * Take the first 5 seconds of an infinite 1-second interval Observable\n *\n * ```ts\n * import { interval, take } from 'rxjs';\n *\n * const intervalCount = interval(1000);\n * const takeFive = intervalCount.pipe(take(5));\n * takeFive.subscribe(x => console.log(x));\n *\n * // Logs:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * ```\n *\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of `next` values to emit.\n * @return A function that returns an Observable that emits only the first\n * `count` values emitted by the source Observable, or all of the values from\n * the source if the source emits fewer than `count` values.\n */\nexport function take<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? // If we are taking no values, that's empty.\n      () => EMPTY\n    : operate((source, subscriber) => {\n        let seen = 0;\n        source.subscribe(\n          createOperatorSubscriber(subscriber, (value) => {\n            // Increment the number of values we have seen,\n            // then check it against the allowed count to see\n            // if we are still letting values through.\n            if (++seen <= count) {\n              subscriber.next(value);\n              // If we have met or passed our allowed count,\n              // we need to complete. We have to do <= here,\n              // because re-entrant code will increment `seen` twice.\n              if (count <= seen) {\n                subscriber.complete();\n              }\n            }\n          })\n        );\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { noop } from '../util/noop';\n\n/**\n * Ignores all items emitted by the source Observable and only passes calls of `complete` or `error`.\n *\n * ![](ignoreElements.png)\n *\n * The `ignoreElements` operator suppresses all items emitted by the source Observable,\n * but allows its termination notification (either `error` or `complete`) to pass through unchanged.\n *\n * If you do not care about the items being emitted by an Observable, but you do want to be notified\n * when it completes or when it terminates with an error, you can apply the `ignoreElements` operator\n * to the Observable, which will ensure that it will never call its observers\u2019 `next` handlers.\n *\n * ## Example\n *\n * Ignore all `next` emissions from the source\n *\n * ```ts\n * import { of, ignoreElements } from 'rxjs';\n *\n * of('you', 'talking', 'to', 'me')\n *   .pipe(ignoreElements())\n *   .subscribe({\n *     next: word => console.log(word),\n *     error: err => console.log('error:', err),\n *     complete: () => console.log('the end'),\n *   });\n *\n * // result:\n * // 'the end'\n * ```\n *\n * @return A function that returns an empty Observable that only calls\n * `complete` or `error`, based on which one is called by the source\n * Observable.\n */\nexport function ignoreElements(): OperatorFunction<unknown, never> {\n  return operate((source, subscriber) => {\n    source.subscribe(createOperatorSubscriber(subscriber, noop));\n  });\n}\n", "import { OperatorFunction } from '../types';\nimport { map } from './map';\n\n/** @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`. */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R>;\n/**\n * @deprecated Do not specify explicit type parameters. Signatures with type parameters\n * that cannot be inferred will be removed in v8. `mapTo` itself will be removed in v9,\n * use {@link map} instead: `map(() => value)`.\n * */\nexport function mapTo<T, R>(value: R): OperatorFunction<T, R>;\n\n/**\n * Emits the given constant value on the output Observable every time the source\n * Observable emits a value.\n *\n * <span class=\"informal\">Like {@link map}, but it maps every source value to\n * the same output value every time.</span>\n *\n * ![](mapTo.png)\n *\n * Takes a constant `value` as argument, and emits that whenever the source\n * Observable emits a value. In other words, ignores the actual source value,\n * and simply uses the emission moment to know when to emit the given `value`.\n *\n * ## Example\n *\n * Map every click to the string `'Hi'`\n *\n * ```ts\n * import { fromEvent, mapTo } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const greetings = clicks.pipe(mapTo('Hi'));\n *\n * greetings.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link map}\n *\n * @param value The value to map each source value to.\n * @return A function that returns an Observable that emits the given `value`\n * every time the source Observable emits.\n * @deprecated To be removed in v9. Use {@link map} instead: `map(() => value)`.\n */\nexport function mapTo<R>(value: R): OperatorFunction<unknown, R> {\n  return map(() => value);\n}\n", "import { Observable } from '../Observable';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { concat } from '../observable/concat';\nimport { take } from './take';\nimport { ignoreElements } from './ignoreElements';\nimport { mapTo } from './mapTo';\nimport { mergeMap } from './mergeMap';\nimport { innerFrom } from '../observable/innerFrom';\n\n/** @deprecated The `subscriptionDelay` parameter will be removed in v8. */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay: Observable<any>\n): MonoTypeOperatorFunction<T>;\nexport function delayWhen<T>(delayDurationSelector: (value: T, index: number) => ObservableInput<any>): MonoTypeOperatorFunction<T>;\n\n/**\n * Delays the emission of items from the source Observable by a given time span\n * determined by the emissions of another Observable.\n *\n * <span class=\"informal\">It's like {@link delay}, but the time span of the\n * delay duration is determined by a second Observable.</span>\n *\n * ![](delayWhen.png)\n *\n * `delayWhen` operator shifts each emitted value from the source Observable by\n * a time span determined by another Observable. When the source emits a value,\n * the `delayDurationSelector` function is called with the value emitted from\n * the source Observable as the first argument to the `delayDurationSelector`.\n * The `delayDurationSelector` function should return an {@link ObservableInput},\n * that is internally converted to an Observable that is called the \"duration\"\n * Observable.\n *\n * The source value is emitted on the output Observable only when the \"duration\"\n * Observable emits ({@link guide/glossary-and-semantics#next next}s) any value.\n * Upon that, the \"duration\" Observable gets unsubscribed.\n *\n * Before RxJS V7, the {@link guide/glossary-and-semantics#complete completion}\n * of the \"duration\" Observable would have been triggering the emission of the\n * source value to the output Observable, but with RxJS V7, this is not the case\n * anymore.\n *\n * Only next notifications (from the \"duration\" Observable) trigger values from\n * the source Observable to be passed to the output Observable. If the \"duration\"\n * Observable only emits the complete notification (without next), the value\n * emitted by the source Observable will never get to the output Observable - it\n * will be swallowed. If the \"duration\" Observable errors, the error will be\n * propagated to the output Observable.\n *\n * Optionally, `delayWhen` takes a second argument, `subscriptionDelay`, which\n * is an Observable. When `subscriptionDelay` emits its first value or\n * completes, the source Observable is subscribed to and starts behaving like\n * described in the previous paragraph. If `subscriptionDelay` is not provided,\n * `delayWhen` will subscribe to the source Observable as soon as the output\n * Observable is subscribed.\n *\n * ## Example\n *\n * Delay each click by a random amount of time, between 0 and 5 seconds\n *\n * ```ts\n * import { fromEvent, delayWhen, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(\n *   delayWhen(() => interval(Math.random() * 5000))\n * );\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delay}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param delayDurationSelector A function that returns an `ObservableInput` for\n * each `value` emitted by the source Observable, which is then used to delay the\n * emission of that `value` on the output Observable until the `ObservableInput`\n * returned from this function emits a next value. When called, beside `value`,\n * this function receives a zero-based `index` of the emission order.\n * @param subscriptionDelay An Observable that triggers the subscription to the\n * source Observable once it emits any value.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by an amount of time specified by the Observable\n * returned by `delayDurationSelector`.\n */\nexport function delayWhen<T>(\n  delayDurationSelector: (value: T, index: number) => ObservableInput<any>,\n  subscriptionDelay?: Observable<any>\n): MonoTypeOperatorFunction<T> {\n  if (subscriptionDelay) {\n    // DEPRECATED PATH\n    return (source: Observable<T>) =>\n      concat(subscriptionDelay.pipe(take(1), ignoreElements()), source.pipe(delayWhen(delayDurationSelector)));\n  }\n\n  return mergeMap((value, index) => innerFrom(delayDurationSelector(value, index)).pipe(take(1), mapTo(value)));\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { delayWhen } from './delayWhen';\nimport { timer } from '../observable/timer';\n\n/**\n * Delays the emission of items from the source Observable by a given timeout or\n * until a given Date.\n *\n * <span class=\"informal\">Time shifts each item by some specified amount of\n * milliseconds.</span>\n *\n * ![](delay.svg)\n *\n * If the delay argument is a Number, this operator time shifts the source\n * Observable by that amount of time expressed in milliseconds. The relative\n * time intervals between the values are preserved.\n *\n * If the delay argument is a Date, this operator time shifts the start of the\n * Observable execution until the given date occurs.\n *\n * ## Examples\n *\n * Delay each click by one second\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const delayedClicks = clicks.pipe(delay(1000)); // each click emitted after 1 second\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * Delay all clicks until a future date happens\n *\n * ```ts\n * import { fromEvent, delay } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const date = new Date('March 15, 2050 12:00:00'); // in the future\n * const delayedClicks = clicks.pipe(delay(date)); // click emitted only after that date\n * delayedClicks.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link delayWhen}\n * @see {@link throttle}\n * @see {@link throttleTime}\n * @see {@link debounce}\n * @see {@link debounceTime}\n * @see {@link sample}\n * @see {@link sampleTime}\n * @see {@link audit}\n * @see {@link auditTime}\n *\n * @param {number|Date} due The delay duration in milliseconds (a `number`) or\n * a `Date` until which the emission of the source items is delayed.\n * @param {SchedulerLike} [scheduler=async] The {@link SchedulerLike} to use for\n * managing the timers that handle the time-shift for each item.\n * @return A function that returns an Observable that delays the emissions of\n * the source Observable by the specified timeout or Date.\n */\nexport function delay<T>(due: number | Date, scheduler: SchedulerLike = asyncScheduler): MonoTypeOperatorFunction<T> {\n  const duration = timer(due, scheduler);\n  return delayWhen(() => duration);\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { identity } from '../util/identity';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function distinctUntilChanged<T>(comparator?: (previous: T, current: T) => boolean): MonoTypeOperatorFunction<T>;\nexport function distinctUntilChanged<T, K>(\n  comparator: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a result {@link Observable} that emits all values pushed by the source observable if they\n * are distinct in comparison to the last value the result observable emitted.\n *\n * When provided without parameters or with the first parameter (`{@link distinctUntilChanged#comparator comparator}`),\n * it behaves like this:\n *\n * 1. It will always emit the first value from the source.\n * 2. For all subsequent values pushed by the source, they will be compared to the previously emitted values\n *    using the provided `comparator` or an `===` equality check.\n * 3. If the value pushed by the source is determined to be unequal by this check, that value is emitted and\n *    becomes the new \"previously emitted value\" internally.\n *\n * When the second parameter (`{@link distinctUntilChanged#keySelector keySelector}`) is provided, the behavior\n * changes:\n *\n * 1. It will always emit the first value from the source.\n * 2. The `keySelector` will be run against all values, including the first value.\n * 3. For all values after the first, the selected key will be compared against the key selected from\n *    the previously emitted value using the `comparator`.\n * 4. If the keys are determined to be unequal by this check, the value (not the key), is emitted\n *    and the selected key from that value is saved for future comparisons against other keys.\n *\n * ## Examples\n *\n * A very basic example with no `{@link distinctUntilChanged#comparator comparator}`. Note that `1` is emitted more than once,\n * because it's distinct in comparison to the _previously emitted_ value,\n * not in comparison to _all other emitted values_.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * of(1, 1, 1, 2, 2, 2, 1, 1, 3, 3)\n *   .pipe(distinctUntilChanged())\n *   .subscribe(console.log);\n * // Logs: 1, 2, 1, 3\n * ```\n *\n * With a `{@link distinctUntilChanged#comparator comparator}`, you can do custom comparisons. Let's say\n * you only want to emit a value when all of its components have\n * changed:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const totallyDifferentBuilds$ = of(\n *   { engineVersion: '1.1.0', transmissionVersion: '1.2.0' },\n *   { engineVersion: '1.1.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.4.0' },\n *   { engineVersion: '1.3.0', transmissionVersion: '1.5.0' },\n *   { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ).pipe(\n *   distinctUntilChanged((prev, curr) => {\n *     return (\n *       prev.engineVersion === curr.engineVersion ||\n *       prev.transmissionVersion === curr.transmissionVersion\n *     );\n *   })\n * );\n *\n * totallyDifferentBuilds$.subscribe(console.log);\n *\n * // Logs:\n * // { engineVersion: '1.1.0', transmissionVersion: '1.2.0' }\n * // { engineVersion: '1.3.0', transmissionVersion: '1.4.0' }\n * // { engineVersion: '2.0.0', transmissionVersion: '1.5.0' }\n * ```\n *\n * You can also provide a custom `{@link distinctUntilChanged#comparator comparator}` to check that emitted\n * changes are only in one direction. Let's say you only want to get\n * the next record temperature:\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * const temps$ = of(30, 31, 20, 34, 33, 29, 35, 20);\n *\n * const recordHighs$ = temps$.pipe(\n *   distinctUntilChanged((prevHigh, temp) => {\n *     // If the current temp is less than\n *     // or the same as the previous record,\n *     // the record hasn't changed.\n *     return temp <= prevHigh;\n *   })\n * );\n *\n * recordHighs$.subscribe(console.log);\n * // Logs: 30, 31, 34, 35\n * ```\n *\n * Selecting update events only when the `updatedBy` field shows\n * the account changed hands.\n *\n * ```ts\n * import { of, distinctUntilChanged } from 'rxjs';\n *\n * // A stream of updates to a given account\n * const accountUpdates$ = of(\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'blesh', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'ncjamieson', data: [] },\n *   { updatedBy: 'blesh', data: [] }\n * );\n *\n * // We only want the events where it changed hands\n * const changedHands$ = accountUpdates$.pipe(\n *   distinctUntilChanged(undefined, update => update.updatedBy)\n * );\n *\n * changedHands$.subscribe(console.log);\n * // Logs:\n * // { updatedBy: 'blesh', data: Array[0] }\n * // { updatedBy: 'ncjamieson', data: Array[0] }\n * // { updatedBy: 'blesh', data: Array[0] }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilKeyChanged}\n *\n * @param comparator A function used to compare the previous and current keys for\n * equality. Defaults to a `===` check.\n * @param keySelector Used to select a key value to be passed to the `comparator`.\n *\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values.\n */\nexport function distinctUntilChanged<T, K>(\n  comparator?: (previous: K, current: K) => boolean,\n  keySelector: (value: T) => K = identity as (value: T) => K\n): MonoTypeOperatorFunction<T> {\n  // We've been allowing `null` do be passed as the `compare`, so we can't do\n  // a default value for the parameter, because that will only work\n  // for `undefined`.\n  comparator = comparator ?? defaultCompare;\n\n  return operate((source, subscriber) => {\n    // The previous key, used to compare against keys selected\n    // from new arrivals to determine \"distinctiveness\".\n    let previousKey: K;\n    // Whether or not this is the first value we've gotten.\n    let first = true;\n\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        // We always call the key selector.\n        const currentKey = keySelector(value);\n\n        // If it's the first value, we always emit it.\n        // Otherwise, we compare this key to the previous key, and\n        // if the comparer returns false, we emit.\n        if (first || !comparator!(previousKey, currentKey)) {\n          // Update our state *before* we emit the value\n          // as emission can be the source of re-entrant code\n          // in functional libraries like this. We only really\n          // need to do this if it's the first value, or if the\n          // key we're tracking in previous needs to change.\n          first = false;\n          previousKey = currentKey;\n\n          // Emit the value!\n          subscriber.next(value);\n        }\n      })\n    );\n  });\n}\n\nfunction defaultCompare(a: any, b: any) {\n  return a === b;\n}\n", "import { distinctUntilChanged } from './distinctUntilChanged';\nimport { MonoTypeOperatorFunction } from '../types';\n\n/* tslint:disable:max-line-length */\nexport function distinctUntilKeyChanged<T>(key: keyof T): MonoTypeOperatorFunction<T>;\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T>;\n/* tslint:enable:max-line-length */\n\n/**\n * Returns an Observable that emits all items emitted by the source Observable that are distinct by comparison from the previous item,\n * using a property accessed by using the key provided to check if the two items are distinct.\n *\n * If a comparator function is provided, then it will be called for each item to test for whether or not that value should be emitted.\n *\n * If a comparator function is not provided, an equality check is used by default.\n *\n * ## Examples\n *\n * An example comparing the name of persons\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo' },\n *   { age: 6, name: 'Foo' }\n * ).pipe(\n *   distinctUntilKeyChanged('name')\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo' }\n * ```\n *\n * An example comparing the first letters of the name\n *\n * ```ts\n * import { of, distinctUntilKeyChanged } from 'rxjs';\n *\n * of(\n *   { age: 4, name: 'Foo1' },\n *   { age: 7, name: 'Bar' },\n *   { age: 5, name: 'Foo2' },\n *   { age: 6, name: 'Foo3' }\n * ).pipe(\n *   distinctUntilKeyChanged('name', (x, y) => x.substring(0, 3) === y.substring(0, 3))\n * )\n * .subscribe(x => console.log(x));\n *\n * // displays:\n * // { age: 4, name: 'Foo1' }\n * // { age: 7, name: 'Bar' }\n * // { age: 5, name: 'Foo2' }\n * ```\n *\n * @see {@link distinct}\n * @see {@link distinctUntilChanged}\n *\n * @param {string} key String key for object property lookup on each item.\n * @param {function} [compare] Optional comparison function called to test if an item is distinct from the previous item in the source.\n * @return A function that returns an Observable that emits items from the\n * source Observable with distinct values based on the key specified.\n */\nexport function distinctUntilKeyChanged<T, K extends keyof T>(key: K, compare?: (x: T[K], y: T[K]) => boolean): MonoTypeOperatorFunction<T> {\n  return distinctUntilChanged((x: T, y: T) => compare ? compare(x[key], y[key]) : x[key] === y[key]);\n}\n", "import { EmptyError } from '../util/EmptyError';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * If the source observable completes without emitting a value, it will emit\n * an error. The error will be created at that time by the optional\n * `errorFactory` argument, otherwise, the error will be {@link EmptyError}.\n *\n * ![](throwIfEmpty.png)\n *\n * ## Example\n *\n * Throw an error if the document wasn't clicked within 1 second\n *\n * ```ts\n * import { fromEvent, takeUntil, timer, throwIfEmpty } from 'rxjs';\n *\n * const click$ = fromEvent(document, 'click');\n *\n * click$.pipe(\n *   takeUntil(timer(1000)),\n *   throwIfEmpty(() => new Error('The document was not clicked within 1 second'))\n * )\n * .subscribe({\n *   next() {\n *    console.log('The document was clicked');\n *   },\n *   error(err) {\n *     console.error(err.message);\n *   }\n * });\n * ```\n *\n * @param errorFactory A factory function called to produce the\n * error to be thrown when the source observable completes without emitting a\n * value.\n * @return A function that returns an Observable that throws an error if the\n * source Observable completed without emitting.\n */\nexport function throwIfEmpty<T>(errorFactory: () => any = defaultErrorFactory): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let hasValue = false;\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          hasValue = true;\n          subscriber.next(value);\n        },\n        () => (hasValue ? subscriber.complete() : subscriber.error(errorFactory()))\n      )\n    );\n  });\n}\n\nfunction defaultErrorFactory() {\n  return new EmptyError();\n}\n", "/** prettier */\nimport { Observable } from '../Observable';\nimport { concat } from '../observable/concat';\nimport { of } from '../observable/of';\nimport { MonoTypeOperatorFunction, SchedulerLike, OperatorFunction, ValueFromArray } from '../types';\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T>(scheduler: SchedulerLike): MonoTypeOperatorFunction<T>;\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function endWith<T, A extends unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\n\nexport function endWith<T, A extends unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that will emit all values from the source, then synchronously emit\n * the provided value(s) immediately after the source completes.\n *\n * NOTE: Passing a last argument of a Scheduler is _deprecated_, and may result in incorrect\n * types in TypeScript.\n *\n * This is useful for knowing when an observable ends. Particularly when paired with an\n * operator like {@link takeUntil}\n *\n * ![](endWith.png)\n *\n * ## Example\n *\n * Emit values to know when an interval starts and stops. The interval will\n * stop when a user clicks anywhere on the document.\n *\n * ```ts\n * import { interval, map, fromEvent, startWith, takeUntil, endWith } from 'rxjs';\n *\n * const ticker$ = interval(5000).pipe(\n *   map(() => 'tick')\n * );\n *\n * const documentClicks$ = fromEvent(document, 'click');\n *\n * ticker$.pipe(\n *   startWith('interval started'),\n *   takeUntil(documentClicks$),\n *   endWith('interval ended by click')\n * )\n * .subscribe(x => console.log(x));\n *\n * // Result (assuming a user clicks after 15 seconds)\n * // 'interval started'\n * // 'tick'\n * // 'tick'\n * // 'tick'\n * // 'interval ended by click'\n * ```\n *\n * @see {@link startWith}\n * @see {@link concat}\n * @see {@link takeUntil}\n *\n * @param values Items you want the modified Observable to emit last.\n * @return A function that returns an Observable that emits all values from the\n * source, then synchronously emits the provided value(s) immediately after the\n * source completes.\n */\nexport function endWith<T>(...values: Array<T | SchedulerLike>): MonoTypeOperatorFunction<T> {\n  return (source: Observable<T>) => concat(source, of(...values)) as Observable<T>;\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\n\n/**\n * Returns an Observable that mirrors the source Observable, but will call a specified function when\n * the source terminates on complete or error.\n * The specified function will also be called when the subscriber explicitly unsubscribes.\n *\n * ## Examples\n *\n * Execute callback function when the observable completes\n *\n * ```ts\n * import { interval, take, finalize } from 'rxjs';\n *\n * // emit value in sequence every 1 second\n * const source = interval(1000);\n * const example = source.pipe(\n *   take(5), //take only the first 5 values\n *   finalize(() => console.log('Sequence complete')) // Execute when the observable completes\n * );\n * const subscribe = example.subscribe(val => console.log(val));\n *\n * // results:\n * // 0\n * // 1\n * // 2\n * // 3\n * // 4\n * // 'Sequence complete'\n * ```\n *\n * Execute callback function when the subscriber explicitly unsubscribes\n *\n * ```ts\n * import { interval, finalize, tap, noop, timer } from 'rxjs';\n *\n * const source = interval(100).pipe(\n *   finalize(() => console.log('[finalize] Called')),\n *   tap({\n *     next: () => console.log('[next] Called'),\n *     error: () => console.log('[error] Not called'),\n *     complete: () => console.log('[tap complete] Not called')\n *   })\n * );\n *\n * const sub = source.subscribe({\n *   next: x => console.log(x),\n *   error: noop,\n *   complete: () => console.log('[complete] Not called')\n * });\n *\n * timer(150).subscribe(() => sub.unsubscribe());\n *\n * // results:\n * // '[next] Called'\n * // 0\n * // '[finalize] Called'\n * ```\n *\n * @param {function} callback Function to be called when source terminates.\n * @return A function that returns an Observable that mirrors the source, but\n * will call the specified function on termination.\n */\nexport function finalize<T>(callback: () => void): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    // TODO: This try/finally was only added for `useDeprecatedSynchronousErrorHandling`.\n    // REMOVE THIS WHEN THAT HOT GARBAGE IS REMOVED IN V8.\n    try {\n      source.subscribe(subscriber);\n    } finally {\n      subscriber.add(callback);\n    }\n  });\n}\n", "import { Observable } from '../Observable';\nimport { EmptyError } from '../util/EmptyError';\nimport { OperatorFunction, TruthyTypesOf } from '../types';\nimport { filter } from './filter';\nimport { take } from './take';\nimport { defaultIfEmpty } from './defaultIfEmpty';\nimport { throwIfEmpty } from './throwIfEmpty';\nimport { identity } from '../util/identity';\n\nexport function first<T, D = T>(predicate?: null, defaultValue?: D): OperatorFunction<T, T | D>;\nexport function first<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function first<T, D>(predicate: BooleanConstructor, defaultValue: D): OperatorFunction<T, TruthyTypesOf<T> | D>;\nexport function first<T, S extends T>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue?: S\n): OperatorFunction<T, S>;\nexport function first<T, S extends T, D>(\n  predicate: (value: T, index: number, source: Observable<T>) => value is S,\n  defaultValue: D\n): OperatorFunction<T, S | D>;\nexport function first<T, D = T>(\n  predicate: (value: T, index: number, source: Observable<T>) => boolean,\n  defaultValue?: D\n): OperatorFunction<T, T | D>;\n\n/**\n * Emits only the first value (or the first value that meets some condition)\n * emitted by the source Observable.\n *\n * <span class=\"informal\">Emits only the first value. Or emits only the first\n * value that passes some test.</span>\n *\n * ![](first.png)\n *\n * If called with no arguments, `first` emits the first value of the source\n * Observable, then completes. If called with a `predicate` function, `first`\n * emits the first value of the source that matches the specified condition. Throws an error if\n * `defaultValue` was not provided and a matching element is not found.\n *\n * ## Examples\n *\n * Emit only the first click that happens on the DOM\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first());\n * result.subscribe(x => console.log(x));\n * ```\n *\n * Emits the first click that happens on a DIV\n *\n * ```ts\n * import { fromEvent, first } from 'rxjs';\n *\n * const div = document.createElement('div');\n * div.style.cssText = 'width: 200px; height: 200px; background: #09c;';\n * document.body.appendChild(div);\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(first(ev => (<HTMLElement>ev.target).tagName === 'DIV'));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link filter}\n * @see {@link find}\n * @see {@link take}\n *\n * @throws {EmptyError} Delivers an EmptyError to the Observer's `error`\n * callback if the Observable completes before any `next` notification was sent.\n * This is how `first()` is different from {@link take}(1) which completes instead.\n *\n * @param {function(value: T, index: number, source: Observable<T>): boolean} [predicate]\n * An optional function called with each item to test for condition matching.\n * @param {D} [defaultValue] The default value emitted in case no valid value\n * was found on the source.\n * @return A function that returns an Observable that emits the first item that\n * matches the condition.\n */\nexport function first<T, D>(\n  predicate?: ((value: T, index: number, source: Observable<T>) => boolean) | null,\n  defaultValue?: D\n): OperatorFunction<T, T | D> {\n  const hasDefaultValue = arguments.length >= 2;\n  return (source: Observable<T>) =>\n    source.pipe(\n      predicate ? filter((v, i) => predicate(v, i, source)) : identity,\n      take(1),\n      hasDefaultValue ? defaultIfEmpty(defaultValue!) : throwIfEmpty(() => new EmptyError())\n    );\n}\n", "import { EMPTY } from '../observable/empty';\nimport { MonoTypeOperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/**\n * Waits for the source to complete, then emits the last N values from the source,\n * as specified by the `count` argument.\n *\n * ![](takeLast.png)\n *\n * `takeLast` results in an observable that will hold values up to `count` values in memory,\n * until the source completes. It then pushes all values in memory to the consumer, in the\n * order they were received from the source, then notifies the consumer that it is\n * complete.\n *\n * If for some reason the source completes before the `count` supplied to `takeLast` is reached,\n * all values received until that point are emitted, and then completion is notified.\n *\n * **Warning**: Using `takeLast` with an observable that never completes will result\n * in an observable that never emits a value.\n *\n * ## Example\n *\n * Take the last 3 values of an Observable with many values\n *\n * ```ts\n * import { range, takeLast } from 'rxjs';\n *\n * const many = range(1, 100);\n * const lastThree = many.pipe(takeLast(3));\n * lastThree.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeUntil}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param count The maximum number of values to emit from the end of\n * the sequence of values emitted by the source Observable.\n * @return A function that returns an Observable that emits at most the last\n * `count` values emitted by the source Observable.\n */\nexport function takeLast<T>(count: number): MonoTypeOperatorFunction<T> {\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        // This buffer will hold the values we are going to emit\n        // when the source completes. Since we only want to take the\n        // last N values, we can't emit until we're sure we're not getting\n        // any more values.\n        let buffer: T[] = [];\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              // Add the most recent value onto the end of our buffer.\n              buffer.push(value);\n              // If our buffer is now larger than the number of values we\n              // want to take, we remove the oldest value from the buffer.\n              count < buffer.length && buffer.shift();\n            },\n            () => {\n              // The source completed, we now know what are last values\n              // are, emit them in the order they were received.\n              for (const value of buffer) {\n                subscriber.next(value);\n              }\n              subscriber.complete();\n            },\n            // Errors are passed through to the consumer\n            undefined,\n            () => {\n              // During finalization release the values in our buffer.\n              buffer = null!;\n            }\n          )\n        );\n      });\n}\n", "import { ObservableInput, ObservableInputTuple, OperatorFunction, SchedulerLike } from '../types';\nimport { operate } from '../util/lift';\nimport { argsOrArgArray } from '../util/argsOrArgArray';\nimport { mergeAll } from './mergeAll';\nimport { popNumber, popScheduler } from '../util/args';\nimport { from } from '../observable/from';\n\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(...sources: [...ObservableInputTuple<A>]): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrency: [...ObservableInputTuple<A>, number]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndScheduler: [...ObservableInputTuple<A>, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n/** @deprecated Replaced with {@link mergeWith}. Will be removed in v8. */\nexport function merge<T, A extends readonly unknown[]>(\n  ...sourcesAndConcurrencyAndScheduler: [...ObservableInputTuple<A>, number, SchedulerLike]\n): OperatorFunction<T, T | A[number]>;\n\nexport function merge<T>(...args: unknown[]): OperatorFunction<T, unknown> {\n  const scheduler = popScheduler(args);\n  const concurrent = popNumber(args, Infinity);\n  args = argsOrArgArray(args);\n\n  return operate((source, subscriber) => {\n    mergeAll(concurrent)(from([source, ...(args as ObservableInput<T>[])], scheduler)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction } from '../types';\nimport { merge } from './merge';\n\n/**\n * Merge the values from all observables to a single observable result.\n *\n * Creates an observable, that when subscribed to, subscribes to the source\n * observable, and all other sources provided as arguments. All values from\n * every source are emitted from the resulting subscription.\n *\n * When all sources complete, the resulting observable will complete.\n *\n * When any source errors, the resulting observable will error.\n *\n * ## Example\n *\n * Joining all outputs from multiple user input event streams\n *\n * ```ts\n * import { fromEvent, map, mergeWith } from 'rxjs';\n *\n * const clicks$ = fromEvent(document, 'click').pipe(map(() => 'click'));\n * const mousemoves$ = fromEvent(document, 'mousemove').pipe(map(() => 'mousemove'));\n * const dblclicks$ = fromEvent(document, 'dblclick').pipe(map(() => 'dblclick'));\n *\n * mousemoves$\n *   .pipe(mergeWith(clicks$, dblclicks$))\n *   .subscribe(x => console.log(x));\n *\n * // result (assuming user interactions)\n * // 'mousemove'\n * // 'mousemove'\n * // 'mousemove'\n * // 'click'\n * // 'click'\n * // 'dblclick'\n * ```\n *\n * @see {@link merge}\n *\n * @param otherSources the sources to combine the current source with.\n * @return A function that returns an Observable that merges the values from\n * all given Observables.\n */\nexport function mergeWith<T, A extends readonly unknown[]>(\n  ...otherSources: [...ObservableInputTuple<A>]\n): OperatorFunction<T, T | A[number]> {\n  return merge(...otherSources);\n}\n", "import { Subscription } from '../Subscription';\nimport { EMPTY } from '../observable/empty';\nimport { operate } from '../util/lift';\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { timer } from '../observable/timer';\n\nexport interface RepeatConfig {\n  /**\n   * The number of times to repeat the source. Defaults to `Infinity`.\n   */\n  count?: number;\n\n  /**\n   * If a `number`, will delay the repeat of the source by that number of milliseconds.\n   * If a function, it will provide the number of times the source has been subscribed to,\n   * and the return value should be a valid observable input that will notify when the source\n   * should be repeated. If the notifier observable is empty, the result will complete.\n   */\n  delay?: number | ((count: number) => ObservableInput<any>);\n}\n\n/**\n * Returns an Observable that will resubscribe to the source stream when the source stream completes.\n *\n * <span class=\"informal\">Repeats all values emitted on the source. It's like {@link retry}, but for non error cases.</span>\n *\n * ![](repeat.png)\n *\n * Repeat will output values from a source until the source completes, then it will resubscribe to the\n * source a specified number of times, with a specified delay. Repeat can be particularly useful in\n * combination with closing operators like {@link take}, {@link takeUntil}, {@link first}, or {@link takeWhile},\n * as it can be used to restart a source again from scratch.\n *\n * Repeat is very similar to {@link retry}, where {@link retry} will resubscribe to the source in the error case, but\n * `repeat` will resubscribe if the source completes.\n *\n * Note that `repeat` will _not_ catch errors. Use {@link retry} for that.\n *\n * - `repeat(0)` returns an empty observable\n * - `repeat()` will repeat forever\n * - `repeat({ delay: 200 })` will repeat forever, with a delay of 200ms between repetitions.\n * - `repeat({ count: 2, delay: 400 })` will repeat twice, with a delay of 400ms between repetitions.\n * - `repeat({ delay: (count) => timer(count * 1000) })` will repeat forever, but will have a delay that grows by one second for each repetition.\n *\n * ## Example\n *\n * Repeat a message stream\n *\n * ```ts\n * import { of, repeat } from 'rxjs';\n *\n * const source = of('Repeat message');\n * const result = source.pipe(repeat(3));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results\n * // 'Repeat message'\n * // 'Repeat message'\n * // 'Repeat message'\n * ```\n *\n * Repeat 3 values, 2 times\n *\n * ```ts\n * import { interval, take, repeat } from 'rxjs';\n *\n * const source = interval(1000);\n * const result = source.pipe(take(3), repeat(2));\n *\n * result.subscribe(x => console.log(x));\n *\n * // Results every second\n * // 0\n * // 1\n * // 2\n * // 0\n * // 1\n * // 2\n * ```\n *\n * Defining two complex repeats with delays on the same source.\n * Note that the second repeat cannot be called until the first\n * repeat as exhausted it's count.\n *\n * ```ts\n * import { defer, of, repeat } from 'rxjs';\n *\n * const source = defer(() => {\n *    return of(`Hello, it is ${new Date()}`)\n * });\n *\n * source.pipe(\n *    // Repeat 3 times with a delay of 1 second between repetitions\n *    repeat({\n *      count: 3,\n *      delay: 1000,\n *    }),\n *\n *    // *Then* repeat forever, but with an exponential step-back\n *    // maxing out at 1 minute.\n *    repeat({\n *      delay: (count) => timer(Math.min(60000, 2 ^ count * 1000))\n *    })\n * )\n * ```\n *\n * @see {@link repeatWhen}\n * @see {@link retry}\n *\n * @param count The number of times the source Observable items are repeated, a count of 0 will yield\n * an empty Observable.\n */\nexport function repeat<T>(countOrConfig?: number | RepeatConfig): MonoTypeOperatorFunction<T> {\n  let count = Infinity;\n  let delay: RepeatConfig['delay'];\n\n  if (countOrConfig != null) {\n    if (typeof countOrConfig === 'object') {\n      ({ count = Infinity, delay } = countOrConfig);\n    } else {\n      count = countOrConfig;\n    }\n  }\n\n  return count <= 0\n    ? () => EMPTY\n    : operate((source, subscriber) => {\n        let soFar = 0;\n        let sourceSub: Subscription | null;\n\n        const resubscribe = () => {\n          sourceSub?.unsubscribe();\n          sourceSub = null;\n          if (delay != null) {\n            const notifier = typeof delay === 'number' ? timer(delay) : innerFrom(delay(soFar));\n            const notifierSubscriber = createOperatorSubscriber(subscriber, () => {\n              notifierSubscriber.unsubscribe();\n              subscribeToSource();\n            });\n            notifier.subscribe(notifierSubscriber);\n          } else {\n            subscribeToSource();\n          }\n        };\n\n        const subscribeToSource = () => {\n          let syncUnsub = false;\n          sourceSub = source.subscribe(\n            createOperatorSubscriber(subscriber, undefined, () => {\n              if (++soFar < count) {\n                if (sourceSub) {\n                  resubscribe();\n                } else {\n                  syncUnsub = true;\n                }\n              } else {\n                subscriber.complete();\n              }\n            })\n          );\n\n          if (syncUnsub) {\n            resubscribe();\n          }\n        };\n\n        subscribeToSource();\n      });\n}\n", "import { OperatorFunction } from '../types';\nimport { operate } from '../util/lift';\nimport { scanInternals } from './scanInternals';\n\nexport function scan<V, A = V>(accumulator: (acc: A | V, value: V, index: number) => A): OperatorFunction<V, V | A>;\nexport function scan<V, A>(accumulator: (acc: A, value: V, index: number) => A, seed: A): OperatorFunction<V, A>;\nexport function scan<V, A, S>(accumulator: (acc: A | S, value: V, index: number) => A, seed: S): OperatorFunction<V, A>;\n\n// TODO: link to a \"redux pattern\" section in the guide (location TBD)\n\n/**\n * Useful for encapsulating and managing state. Applies an accumulator (or \"reducer function\")\n * to each value from the source after an initial state is established -- either via\n * a `seed` value (second argument), or from the first value from the source.\n *\n * <span class=\"informal\">It's like {@link reduce}, but emits the current\n * accumulation state after each update</span>\n *\n * ![](scan.png)\n *\n * This operator maintains an internal state and emits it after processing each value as follows:\n *\n * 1. First value arrives\n *   - If a `seed` value was supplied (as the second argument to `scan`), let `state = seed` and `value = firstValue`.\n *   - If NO `seed` value was supplied (no second argument), let `state = firstValue` and go to 3.\n * 2. Let `state = accumulator(state, value)`.\n *   - If an error is thrown by `accumulator`, notify the consumer of an error. The process ends.\n * 3. Emit `state`.\n * 4. Next value arrives, let `value = nextValue`, go to 2.\n *\n * ## Examples\n *\n * An average of previous numbers. This example shows how\n * not providing a `seed` can prime the stream with the\n * first value from the source.\n *\n * ```ts\n * import { of, scan, map } from 'rxjs';\n *\n * const numbers$ = of(1, 2, 3);\n *\n * numbers$\n *   .pipe(\n *     // Get the sum of the numbers coming in.\n *     scan((total, n) => total + n),\n *     // Get the average by dividing the sum by the total number\n *     // received so far (which is 1 more than the zero-based index).\n *     map((sum, index) => sum / (index + 1))\n *   )\n *   .subscribe(console.log);\n * ```\n *\n * The Fibonacci sequence. This example shows how you can use\n * a seed to prime accumulation process. Also... you know... Fibonacci.\n * So important to like, computers and stuff that its whiteboarded\n * in job interviews. Now you can show them the Rx version! (Please don't, haha)\n *\n * ```ts\n * import { interval, scan, map, startWith } from 'rxjs';\n *\n * const firstTwoFibs = [0, 1];\n * // An endless stream of Fibonacci numbers.\n * const fibonacci$ = interval(1000).pipe(\n *   // Scan to get the fibonacci numbers (after 0, 1)\n *   scan(([a, b]) => [b, a + b], firstTwoFibs),\n *   // Get the second number in the tuple, it's the one you calculated\n *   map(([, n]) => n),\n *   // Start with our first two digits :)\n *   startWith(...firstTwoFibs)\n * );\n *\n * fibonacci$.subscribe(console.log);\n * ```\n *\n * @see {@link expand}\n * @see {@link mergeScan}\n * @see {@link reduce}\n * @see {@link switchScan}\n *\n * @param accumulator A \"reducer function\". This will be called for each value after an initial state is\n * acquired.\n * @param seed The initial state. If this is not provided, the first value from the source will\n * be used as the initial state, and emitted without going through the accumulator. All subsequent values\n * will be processed by the accumulator function. If this is provided, all values will go through\n * the accumulator function.\n * @return A function that returns an Observable of the accumulated values.\n */\nexport function scan<V, A, S>(accumulator: (acc: V | A | S, value: V, index: number) => A, seed?: S): OperatorFunction<V, V | A> {\n  // providing a seed of `undefined` *should* be valid and trigger\n  // hasSeed! so don't use `seed !== undefined` checks!\n  // For this reason, we have to check it here at the original call site\n  // otherwise inside Operator/Subscriber we won't know if `undefined`\n  // means they didn't provide anything or if they literally provided `undefined`\n  return operate(scanInternals(accumulator, seed as S, arguments.length >= 2, true));\n}\n", "import { innerFrom } from '../observable/innerFrom';\nimport { Subject } from '../Subject';\nimport { SafeSubscriber } from '../Subscriber';\nimport { Subscription } from '../Subscription';\nimport { MonoTypeOperatorFunction, SubjectLike, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\n\nexport interface ShareConfig<T> {\n  /**\n   * The factory used to create the subject that will connect the source observable to\n   * multicast consumers.\n   */\n  connector?: () => SubjectLike<T>;\n  /**\n   * If `true`, the resulting observable will reset internal state on error from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"retried\" in the event of an error.\n   * If `false`, when an error comes from the source it will push the error into the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent retries\n   * or resubscriptions will resubscribe to that same subject. In all cases, RxJS subjects will emit the same error again, however\n   * {@link ReplaySubject} will also push its buffered values before pushing the error.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnError?: boolean | ((error: any) => ObservableInput<any>);\n  /**\n   * If `true`, the resulting observable will reset internal state on completion from source and return to a \"cold\" state. This\n   * allows the resulting observable to be \"repeated\" after it is done.\n   * If `false`, when the source completes, it will push the completion through the connecting subject, and the subject\n   * will remain the connecting subject, meaning the resulting observable will not go \"cold\" again, and subsequent repeats\n   * or resubscriptions will resubscribe to that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnComplete?: boolean | (() => ObservableInput<any>);\n  /**\n   * If `true`, when the number of subscribers to the resulting observable reaches zero due to those subscribers unsubscribing, the\n   * internal state will be reset and the resulting observable will return to a \"cold\" state. This means that the next\n   * time the resulting observable is subscribed to, a new subject will be created and the source will be subscribed to\n   * again.\n   * If `false`, when the number of subscribers to the resulting observable reaches zero due to unsubscription, the subject\n   * will remain connected to the source, and new subscriptions to the result will be connected through that same subject.\n   * It is also possible to pass a notifier factory returning an `ObservableInput` instead which grants more fine-grained\n   * control over how and when the reset should happen. This allows behaviors like conditional or delayed resets.\n   */\n  resetOnRefCountZero?: boolean | (() => ObservableInput<any>);\n}\n\nexport function share<T>(): MonoTypeOperatorFunction<T>;\n\nexport function share<T>(options: ShareConfig<T>): MonoTypeOperatorFunction<T>;\n\n/**\n * Returns a new Observable that multicasts (shares) the original Observable. As long as there is at least one\n * Subscriber this Observable will be subscribed and emitting data. When all subscribers have unsubscribed it will\n * unsubscribe from the source Observable. Because the Observable is multicasting it makes the stream `hot`.\n * This is an alias for `multicast(() => new Subject()), refCount()`.\n *\n * The subscription to the underlying source Observable can be reset (unsubscribe and resubscribe for new subscribers),\n * if the subscriber count to the shared observable drops to 0, or if the source Observable errors or completes. It is\n * possible to use notifier factories for the resets to allow for behaviors like conditional or delayed resets. Please\n * note that resetting on error or complete of the source Observable does not behave like a transparent retry or restart\n * of the source because the error or complete will be forwarded to all subscribers and their subscription will be\n * closed. Only new subscribers after a reset on error or complete happened will cause a fresh subscription to the\n * source. To achieve transparent retries or restarts pipe the source through appropriate operators before sharing.\n *\n * ![](share.png)\n *\n * ## Example\n *\n * Generate new multicast Observable from the `source` Observable value\n *\n * ```ts\n * import { interval, tap, map, take, share } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   tap(x => console.log('Processing: ', x)),\n *   map(x => x * x),\n *   take(6),\n *   share()\n * );\n *\n * source.subscribe(x => console.log('subscription 1: ', x));\n * source.subscribe(x => console.log('subscription 2: ', x));\n *\n * // Logs:\n * // Processing: 0\n * // subscription 1: 0\n * // subscription 2: 0\n * // Processing: 1\n * // subscription 1: 1\n * // subscription 2: 1\n * // Processing: 2\n * // subscription 1: 4\n * // subscription 2: 4\n * // Processing: 3\n * // subscription 1: 9\n * // subscription 2: 9\n * // Processing: 4\n * // subscription 1: 16\n * // subscription 2: 16\n * // Processing: 5\n * // subscription 1: 25\n * // subscription 2: 25\n * ```\n *\n * ## Example with notifier factory: Delayed reset\n *\n * ```ts\n * import { interval, take, share, timer } from 'rxjs';\n *\n * const source = interval(1000).pipe(\n *   take(3),\n *   share({\n *     resetOnRefCountZero: () => timer(1000)\n *   })\n * );\n *\n * const subscriptionOne = source.subscribe(x => console.log('subscription 1: ', x));\n * setTimeout(() => subscriptionOne.unsubscribe(), 1300);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 2: ', x)), 1700);\n *\n * setTimeout(() => source.subscribe(x => console.log('subscription 3: ', x)), 5000);\n *\n * // Logs:\n * // subscription 1:  0\n * // (subscription 1 unsubscribes here)\n * // (subscription 2 subscribes here ~400ms later, source was not reset)\n * // subscription 2:  1\n * // subscription 2:  2\n * // (subscription 2 unsubscribes here)\n * // (subscription 3 subscribes here ~2000ms later, source did reset before)\n * // subscription 3:  0\n * // subscription 3:  1\n * // subscription 3:  2\n * ```\n *\n * @see {@link shareReplay}\n *\n * @return A function that returns an Observable that mirrors the source.\n */\nexport function share<T>(options: ShareConfig<T> = {}): MonoTypeOperatorFunction<T> {\n  const { connector = () => new Subject<T>(), resetOnError = true, resetOnComplete = true, resetOnRefCountZero = true } = options;\n  // It's necessary to use a wrapper here, as the _operator_ must be\n  // referentially transparent. Otherwise, it cannot be used in calls to the\n  // static `pipe` function - to create a partial pipeline.\n  //\n  // The _operator function_ - the function returned by the _operator_ - will\n  // not be referentially transparent - as it shares its source - but the\n  // _operator function_ is called when the complete pipeline is composed via a\n  // call to a source observable's `pipe` method - not when the static `pipe`\n  // function is called.\n  return (wrapperSource) => {\n    let connection: SafeSubscriber<T> | undefined;\n    let resetConnection: Subscription | undefined;\n    let subject: SubjectLike<T> | undefined;\n    let refCount = 0;\n    let hasCompleted = false;\n    let hasErrored = false;\n\n    const cancelReset = () => {\n      resetConnection?.unsubscribe();\n      resetConnection = undefined;\n    };\n    // Used to reset the internal state to a \"cold\"\n    // state, as though it had never been subscribed to.\n    const reset = () => {\n      cancelReset();\n      connection = subject = undefined;\n      hasCompleted = hasErrored = false;\n    };\n    const resetAndUnsubscribe = () => {\n      // We need to capture the connection before\n      // we reset (if we need to reset).\n      const conn = connection;\n      reset();\n      conn?.unsubscribe();\n    };\n\n    return operate<T, T>((source, subscriber) => {\n      refCount++;\n      if (!hasErrored && !hasCompleted) {\n        cancelReset();\n      }\n\n      // Create the subject if we don't have one yet. Grab a local reference to\n      // it as well, which avoids non-null assertions when using it and, if we\n      // connect to it now, then error/complete need a reference after it was\n      // reset.\n      const dest = (subject = subject ?? connector());\n\n      // Add the finalization directly to the subscriber - instead of returning it -\n      // so that the handling of the subscriber's unsubscription will be wired\n      // up _before_ the subscription to the source occurs. This is done so that\n      // the assignment to the source connection's `closed` property will be seen\n      // by synchronous firehose sources.\n      subscriber.add(() => {\n        refCount--;\n\n        // If we're resetting on refCount === 0, and it's 0, we only want to do\n        // that on \"unsubscribe\", really. Resetting on error or completion is a different\n        // configuration.\n        if (refCount === 0 && !hasErrored && !hasCompleted) {\n          resetConnection = handleReset(resetAndUnsubscribe, resetOnRefCountZero);\n        }\n      });\n\n      // The following line adds the subscription to the subscriber passed.\n      // Basically, `subscriber === dest.subscribe(subscriber)` is `true`.\n      dest.subscribe(subscriber);\n\n      if (\n        !connection &&\n        // Check this shareReplay is still activate - it can be reset to 0\n        // and be \"unsubscribed\" _before_ it actually subscribes.\n        // If we were to subscribe then, it'd leak and get stuck.\n        refCount > 0\n      ) {\n        // We need to create a subscriber here - rather than pass an observer and\n        // assign the returned subscription to connection - because it's possible\n        // for reentrant subscriptions to the shared observable to occur and in\n        // those situations we want connection to be already-assigned so that we\n        // don't create another connection to the source.\n        connection = new SafeSubscriber({\n          next: (value) => dest.next(value),\n          error: (err) => {\n            hasErrored = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnError, err);\n            dest.error(err);\n          },\n          complete: () => {\n            hasCompleted = true;\n            cancelReset();\n            resetConnection = handleReset(reset, resetOnComplete);\n            dest.complete();\n          },\n        });\n        innerFrom(source).subscribe(connection);\n      }\n    })(wrapperSource);\n  };\n}\n\nfunction handleReset<T extends unknown[] = never[]>(\n  reset: () => void,\n  on: boolean | ((...args: T) => ObservableInput<any>),\n  ...args: T\n): Subscription | undefined {\n  if (on === true) {\n    reset();\n    return;\n  }\n\n  if (on === false) {\n    return;\n  }\n\n  const onSubscriber = new SafeSubscriber({\n    next: () => {\n      onSubscriber.unsubscribe();\n      reset();\n    },\n  });\n\n  return innerFrom(on(...args)).subscribe(onSubscriber);\n}\n", "import { ReplaySubject } from '../ReplaySubject';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { share } from './share';\n\nexport interface ShareReplayConfig {\n  bufferSize?: number;\n  windowTime?: number;\n  refCount: boolean;\n  scheduler?: SchedulerLike;\n}\n\nexport function shareReplay<T>(config: ShareReplayConfig): MonoTypeOperatorFunction<T>;\nexport function shareReplay<T>(bufferSize?: number, windowTime?: number, scheduler?: SchedulerLike): MonoTypeOperatorFunction<T>;\n\n/**\n * Share source and replay specified number of emissions on subscription.\n *\n * This operator is a specialization of `replay` that connects to a source observable\n * and multicasts through a `ReplaySubject` constructed with the specified arguments.\n * A successfully completed source will stay cached in the `shareReplay`ed observable forever,\n * but an errored source can be retried.\n *\n * ## Why use `shareReplay`?\n *\n * You generally want to use `shareReplay` when you have side-effects or taxing computations\n * that you do not wish to be executed amongst multiple subscribers.\n * It may also be valuable in situations where you know you will have late subscribers to\n * a stream that need access to previously emitted values.\n * This ability to replay values on subscription is what differentiates {@link share} and `shareReplay`.\n *\n * ## Reference counting\n *\n * By default `shareReplay` will use `refCount` of false, meaning that it will _not_ unsubscribe the\n * source when the reference counter drops to zero, i.e. the inner `ReplaySubject` will _not_ be unsubscribed\n * (and potentially run for ever).\n * This is the default as it is expected that `shareReplay` is often used to keep around expensive to setup\n * observables which we want to keep running instead of having to do the expensive setup again.\n *\n * As of RXJS version 6.4.0 a new overload signature was added to allow for manual control over what\n * happens when the operators internal reference counter drops to zero.\n * If `refCount` is true, the source will be unsubscribed from once the reference count drops to zero, i.e.\n * the inner `ReplaySubject` will be unsubscribed. All new subscribers will receive value emissions from a\n * new `ReplaySubject` which in turn will cause a new subscription to the source observable.\n *\n * ## Examples\n *\n * Example with a third subscriber coming late to the party\n *\n * ```ts\n * import { interval, take, shareReplay } from 'rxjs';\n *\n * const shared$ = interval(2000).pipe(\n *   take(6),\n *   shareReplay(3)\n * );\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * setTimeout(() => {\n *   shared$.subscribe(y => console.log('sub C: ', y));\n * }, 11000);\n *\n * // Logs:\n * // (after ~2000 ms)\n * // sub A: 0\n * // sub B: 0\n * // (after ~4000 ms)\n * // sub A: 1\n * // sub B: 1\n * // (after ~6000 ms)\n * // sub A: 2\n * // sub B: 2\n * // (after ~8000 ms)\n * // sub A: 3\n * // sub B: 3\n * // (after ~10000 ms)\n * // sub A: 4\n * // sub B: 4\n * // (after ~11000 ms, sub C gets the last 3 values)\n * // sub C: 2\n * // sub C: 3\n * // sub C: 4\n * // (after ~12000 ms)\n * // sub A: 5\n * // sub B: 5\n * // sub C: 5\n * ```\n *\n * Example for `refCount` usage\n *\n * ```ts\n * import { Observable, tap, interval, shareReplay, take } from 'rxjs';\n *\n * const log = <T>(name: string, source: Observable<T>) => source.pipe(\n *   tap({\n *     subscribe: () => console.log(`${ name }: subscribed`),\n *     next: value => console.log(`${ name }: ${ value }`),\n *     complete: () => console.log(`${ name }: completed`),\n *     finalize: () => console.log(`${ name }: unsubscribed`)\n *   })\n * );\n *\n * const obs$ = log('source', interval(1000));\n *\n * const shared$ = log('shared', obs$.pipe(\n *   shareReplay({ bufferSize: 1, refCount: true }),\n *   take(2)\n * ));\n *\n * shared$.subscribe(x => console.log('sub A: ', x));\n * shared$.subscribe(y => console.log('sub B: ', y));\n *\n * // PRINTS:\n * // shared: subscribed <-- reference count = 1\n * // source: subscribed\n * // shared: subscribed <-- reference count = 2\n * // source: 0\n * // shared: 0\n * // sub A: 0\n * // shared: 0\n * // sub B: 0\n * // source: 1\n * // shared: 1\n * // sub A: 1\n * // shared: completed <-- take(2) completes the subscription for sub A\n * // shared: unsubscribed <-- reference count = 1\n * // shared: 1\n * // sub B: 1\n * // shared: completed <-- take(2) completes the subscription for sub B\n * // shared: unsubscribed <-- reference count = 0\n * // source: unsubscribed <-- replaySubject unsubscribes from source observable because the reference count dropped to 0 and refCount is true\n *\n * // In case of refCount being false, the unsubscribe is never called on the source and the source would keep on emitting, even if no subscribers\n * // are listening.\n * // source: 2\n * // source: 3\n * // source: 4\n * // ...\n * ```\n *\n * @see {@link publish}\n * @see {@link share}\n * @see {@link publishReplay}\n *\n * @param configOrBufferSize Maximum element count of the replay buffer or {@link ShareReplayConfig configuration}\n * object.\n * @param windowTime Maximum time length of the replay buffer in milliseconds.\n * @param scheduler Scheduler where connected observers within the selector function\n * will be invoked on.\n * @return A function that returns an Observable sequence that contains the\n * elements of a sequence produced by multicasting the source sequence within a\n * selector function.\n */\nexport function shareReplay<T>(\n  configOrBufferSize?: ShareReplayConfig | number,\n  windowTime?: number,\n  scheduler?: SchedulerLike\n): MonoTypeOperatorFunction<T> {\n  let bufferSize: number;\n  let refCount = false;\n  if (configOrBufferSize && typeof configOrBufferSize === 'object') {\n    ({ bufferSize = Infinity, windowTime = Infinity, refCount = false, scheduler } = configOrBufferSize);\n  } else {\n    bufferSize = (configOrBufferSize ?? Infinity) as number;\n  }\n  return share<T>({\n    connector: () => new ReplaySubject(bufferSize, windowTime, scheduler),\n    resetOnError: true,\n    resetOnComplete: false,\n    resetOnRefCountZero: refCount,\n  });\n}\n", "import { MonoTypeOperatorFunction } from '../types';\nimport { filter } from './filter';\n\n/**\n * Returns an Observable that skips the first `count` items emitted by the source Observable.\n *\n * ![](skip.png)\n *\n * Skips the values until the sent notifications are equal or less than provided skip count. It raises\n * an error if skip count is equal or more than the actual number of emits and source raises an error.\n *\n * ## Example\n *\n * Skip the values before the emission\n *\n * ```ts\n * import { interval, skip } from 'rxjs';\n *\n * // emit every half second\n * const source = interval(500);\n * // skip the first 10 emitted values\n * const result = source.pipe(skip(10));\n *\n * result.subscribe(value => console.log(value));\n * // output: 10...11...12...13...\n * ```\n *\n * @see {@link last}\n * @see {@link skipWhile}\n * @see {@link skipUntil}\n * @see {@link skipLast}\n *\n * @param {Number} count - The number of times, items emitted by source Observable should be skipped.\n * @return A function that returns an Observable that skips the first `count`\n * values emitted by the source Observable.\n */\nexport function skip<T>(count: number): MonoTypeOperatorFunction<T> {\n  return filter((_, index) => count <= index);\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Returns an Observable that skips items emitted by the source Observable until a second Observable emits an item.\n *\n * The `skipUntil` operator causes the observable stream to skip the emission of values until the passed in observable\n * emits the first value. This can be particularly useful in combination with user interactions, responses of HTTP\n * requests or waiting for specific times to pass by.\n *\n * ![](skipUntil.png)\n *\n * Internally, the `skipUntil` operator subscribes to the passed in `notifier` `ObservableInput` (which gets converted\n * to an Observable) in order to recognize the emission of its first value. When `notifier` emits next, the operator\n * unsubscribes from it and starts emitting the values of the *source* observable until it completes or errors. It\n * will never let the *source* observable emit any values if the `notifier` completes or throws an error without\n * emitting a value before.\n *\n * ## Example\n *\n * In the following example, all emitted values of the interval observable are skipped until the user clicks anywhere\n * within the page\n *\n * ```ts\n * import { interval, fromEvent, skipUntil } from 'rxjs';\n *\n * const intervalObservable = interval(1000);\n * const click = fromEvent(document, 'click');\n *\n * const emitAfterClick = intervalObservable.pipe(\n *   skipUntil(click)\n * );\n * // clicked at 4.6s. output: 5...6...7...8........ or\n * // clicked at 7.3s. output: 8...9...10..11.......\n * emitAfterClick.subscribe(value => console.log(value));\n * ```\n *\n * @see {@link last}\n * @see {@link skip}\n * @see {@link skipWhile}\n * @see {@link skipLast}\n *\n * @param notifier An `ObservableInput` that has to emit an item before the source Observable elements begin to\n * be mirrored by the resulting Observable.\n * @return A function that returns an Observable that skips items from the\n * source Observable until the `notifier` Observable emits an item, then emits the\n * remaining items.\n */\nexport function skipUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let taking = false;\n\n    const skipSubscriber = createOperatorSubscriber(\n      subscriber,\n      () => {\n        skipSubscriber?.unsubscribe();\n        taking = true;\n      },\n      noop\n    );\n\n    innerFrom(notifier).subscribe(skipSubscriber);\n\n    source.subscribe(createOperatorSubscriber(subscriber, (value) => taking && subscriber.next(value)));\n  });\n}\n", "import { concat } from '../observable/concat';\nimport { OperatorFunction, SchedulerLike, ValueFromArray } from '../types';\nimport { popScheduler } from '../util/args';\nimport { operate } from '../util/lift';\n\n// Devs are more likely to pass null or undefined than they are a scheduler\n// without accompanying values. To make things easier for (naughty) devs who\n// use the `strictNullChecks: false` TypeScript compiler option, these\n// overloads with explicit null and undefined values are included.\n\nexport function startWith<T>(value: null): OperatorFunction<T, T | null>;\nexport function startWith<T>(value: undefined): OperatorFunction<T, T | undefined>;\n\n/** @deprecated The `scheduler` parameter will be removed in v8. Use `scheduled` and `concatAll`. Details: https://rxjs.dev/deprecations/scheduler-argument */\nexport function startWith<T, A extends readonly unknown[] = T[]>(\n  ...valuesAndScheduler: [...A, SchedulerLike]\n): OperatorFunction<T, T | ValueFromArray<A>>;\nexport function startWith<T, A extends readonly unknown[] = T[]>(...values: A): OperatorFunction<T, T | ValueFromArray<A>>;\n\n/**\n * Returns an observable that, at the moment of subscription, will synchronously emit all\n * values provided to this operator, then subscribe to the source and mirror all of its emissions\n * to subscribers.\n *\n * This is a useful way to know when subscription has occurred on an existing observable.\n *\n * <span class=\"informal\">First emits its arguments in order, and then any\n * emissions from the source.</span>\n *\n * ![](startWith.png)\n *\n * ## Examples\n *\n * Emit a value when a timer starts.\n *\n * ```ts\n * import { timer, map, startWith } from 'rxjs';\n *\n * timer(1000)\n *   .pipe(\n *     map(() => 'timer emit'),\n *     startWith('timer start')\n *   )\n *   .subscribe(x => console.log(x));\n *\n * // results:\n * // 'timer start'\n * // 'timer emit'\n * ```\n *\n * @param values Items you want the modified Observable to emit first.\n * @return A function that returns an Observable that synchronously emits\n * provided values before subscribing to the source Observable.\n *\n * @see {@link endWith}\n * @see {@link finalize}\n * @see {@link concat}\n */\nexport function startWith<T, D>(...values: D[]): OperatorFunction<T, T | D> {\n  const scheduler = popScheduler(values);\n  return operate((source, subscriber) => {\n    // Here we can't pass `undefined` as a scheduler, because if we did, the\n    // code inside of `concat` would be confused by the `undefined`, and treat it\n    // like an invalid observable. So we have to split it two different ways.\n    (scheduler ? concat(values, source, scheduler) : concat(values, source)).subscribe(subscriber);\n  });\n}\n", "import { Subscriber } from '../Subscriber';\nimport { ObservableInput, OperatorFunction, ObservedValueOf } from '../types';\nimport { innerFrom } from '../observable/innerFrom';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\n/* tslint:disable:max-line-length */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: undefined\n): OperatorFunction<T, ObservedValueOf<O>>;\n/** @deprecated The `resultSelector` parameter will be removed in v8. Use an inner `map` instead. Details: https://rxjs.dev/deprecations/resultSelector */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, R>;\n/* tslint:enable:max-line-length */\n\n/**\n * Projects each source value to an Observable which is merged in the output\n * Observable, emitting values only from the most recently projected Observable.\n *\n * <span class=\"informal\">Maps each value to an Observable, then flattens all of\n * these inner Observables using {@link switchAll}.</span>\n *\n * ![](switchMap.png)\n *\n * Returns an Observable that emits items based on applying a function that you\n * supply to each item emitted by the source Observable, where that function\n * returns an (so-called \"inner\") Observable. Each time it observes one of these\n * inner Observables, the output Observable begins emitting the items emitted by\n * that inner Observable. When a new inner Observable is emitted, `switchMap`\n * stops emitting items from the earlier-emitted inner Observable and begins\n * emitting items from the new one. It continues to behave like this for\n * subsequent inner Observables.\n *\n * ## Example\n *\n * Generate new Observable according to source Observable values\n *\n * ```ts\n * import { of, switchMap } from 'rxjs';\n *\n * const switched = of(1, 2, 3).pipe(switchMap(x => of(x, x ** 2, x ** 3)));\n * switched.subscribe(x => console.log(x));\n * // outputs\n * // 1\n * // 1\n * // 1\n * // 2\n * // 4\n * // 8\n * // 3\n * // 9\n * // 27\n * ```\n *\n * Restart an interval Observable on every click event\n *\n * ```ts\n * import { fromEvent, switchMap, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(switchMap(() => interval(1000)));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link concatMap}\n * @see {@link exhaustMap}\n * @see {@link mergeMap}\n * @see {@link switchAll}\n * @see {@link switchMapTo}\n *\n * @param {function(value: T, index: number): ObservableInput} project A function\n * that, when applied to an item emitted by the source Observable, returns an\n * Observable.\n * @return A function that returns an Observable that emits the result of\n * applying the projection function (and the optional deprecated\n * `resultSelector`) to each item emitted by the source Observable and taking\n * only the values from the most recently projected inner Observable.\n */\nexport function switchMap<T, R, O extends ObservableInput<any>>(\n  project: (value: T, index: number) => O,\n  resultSelector?: (outerValue: T, innerValue: ObservedValueOf<O>, outerIndex: number, innerIndex: number) => R\n): OperatorFunction<T, ObservedValueOf<O> | R> {\n  return operate((source, subscriber) => {\n    let innerSubscriber: Subscriber<ObservedValueOf<O>> | null = null;\n    let index = 0;\n    // Whether or not the source subscription has completed\n    let isComplete = false;\n\n    // We only complete the result if the source is complete AND we don't have an active inner subscription.\n    // This is called both when the source completes and when the inners complete.\n    const checkComplete = () => isComplete && !innerSubscriber && subscriber.complete();\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        (value) => {\n          // Cancel the previous inner subscription if there was one\n          innerSubscriber?.unsubscribe();\n          let innerIndex = 0;\n          const outerIndex = index++;\n          // Start the next inner subscription\n          innerFrom(project(value, outerIndex)).subscribe(\n            (innerSubscriber = createOperatorSubscriber(\n              subscriber,\n              // When we get a new inner value, next it through. Note that this is\n              // handling the deprecate result selector here. This is because with this architecture\n              // it ends up being smaller than using the map operator.\n              (innerValue) => subscriber.next(resultSelector ? resultSelector(value, innerValue, outerIndex, innerIndex++) : innerValue),\n              () => {\n                // The inner has completed. Null out the inner subscriber to\n                // free up memory and to signal that we have no inner subscription\n                // currently.\n                innerSubscriber = null!;\n                checkComplete();\n              }\n            ))\n          );\n        },\n        () => {\n          isComplete = true;\n          checkComplete();\n        }\n      )\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { noop } from '../util/noop';\n\n/**\n * Emits the values emitted by the source Observable until a `notifier`\n * Observable emits a value.\n *\n * <span class=\"informal\">Lets values pass until a second Observable,\n * `notifier`, emits a value. Then, it completes.</span>\n *\n * ![](takeUntil.png)\n *\n * `takeUntil` subscribes and begins mirroring the source Observable. It also\n * monitors a second Observable, `notifier` that you provide. If the `notifier`\n * emits a value, the output Observable stops mirroring the source Observable\n * and completes. If the `notifier` doesn't emit any value and completes\n * then `takeUntil` will pass all values.\n *\n * ## Example\n *\n * Tick every second until the first click happens\n *\n * ```ts\n * import { interval, fromEvent, takeUntil } from 'rxjs';\n *\n * const source = interval(1000);\n * const clicks = fromEvent(document, 'click');\n * const result = source.pipe(takeUntil(clicks));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeWhile}\n * @see {@link skip}\n *\n * @param {Observable} notifier The Observable whose first emitted value will\n * cause the output Observable of `takeUntil` to stop emitting values from the\n * source Observable.\n * @return A function that returns an Observable that emits the values from the\n * source Observable until `notifier` emits its first value.\n */\nexport function takeUntil<T>(notifier: ObservableInput<any>): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    innerFrom(notifier).subscribe(createOperatorSubscriber(subscriber, () => subscriber.complete(), noop));\n    !subscriber.closed && source.subscribe(subscriber);\n  });\n}\n", "import { OperatorFunction, MonoTypeOperatorFunction, TruthyTypesOf } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\n\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: true): MonoTypeOperatorFunction<T>;\nexport function takeWhile<T>(predicate: BooleanConstructor, inclusive: false): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T>(predicate: BooleanConstructor): OperatorFunction<T, TruthyTypesOf<T>>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S): OperatorFunction<T, S>;\nexport function takeWhile<T, S extends T>(predicate: (value: T, index: number) => value is S, inclusive: false): OperatorFunction<T, S>;\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive?: boolean): MonoTypeOperatorFunction<T>;\n\n/**\n * Emits values emitted by the source Observable so long as each value satisfies\n * the given `predicate`, and then completes as soon as this `predicate` is not\n * satisfied.\n *\n * <span class=\"informal\">Takes values from the source only while they pass the\n * condition given. When the first value does not satisfy, it completes.</span>\n *\n * ![](takeWhile.png)\n *\n * `takeWhile` subscribes and begins mirroring the source Observable. Each value\n * emitted on the source is given to the `predicate` function which returns a\n * boolean, representing a condition to be satisfied by the source values. The\n * output Observable emits the source values until such time as the `predicate`\n * returns false, at which point `takeWhile` stops mirroring the source\n * Observable and completes the output Observable.\n *\n * ## Example\n *\n * Emit click events only while the clientX property is greater than 200\n *\n * ```ts\n * import { fromEvent, takeWhile } from 'rxjs';\n *\n * const clicks = fromEvent<PointerEvent>(document, 'click');\n * const result = clicks.pipe(takeWhile(ev => ev.clientX > 200));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link take}\n * @see {@link takeLast}\n * @see {@link takeUntil}\n * @see {@link skip}\n *\n * @param {function(value: T, index: number): boolean} predicate A function that\n * evaluates a value emitted by the source Observable and returns a boolean.\n * Also takes the (zero-based) index as the second argument.\n * @param {boolean} inclusive When set to `true` the value that caused\n * `predicate` to return `false` will also be emitted.\n * @return A function that returns an Observable that emits values from the\n * source Observable so long as each value satisfies the condition defined by\n * the `predicate`, then completes.\n */\nexport function takeWhile<T>(predicate: (value: T, index: number) => boolean, inclusive = false): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    let index = 0;\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        const result = predicate(value, index++);\n        (result || inclusive) && subscriber.next(value);\n        !result && subscriber.complete();\n      })\n    );\n  });\n}\n", "import { MonoTypeOperatorFunction, Observer } from '../types';\nimport { isFunction } from '../util/isFunction';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { identity } from '../util/identity';\n\n/**\n * An extension to the {@link Observer} interface used only by the {@link tap} operator.\n *\n * It provides a useful set of callbacks a user can register to do side-effects in\n * cases other than what the usual {@link Observer} callbacks are\n * ({@link guide/glossary-and-semantics#next next},\n * {@link guide/glossary-and-semantics#error error} and/or\n * {@link guide/glossary-and-semantics#complete complete}).\n *\n * ## Example\n *\n * ```ts\n * import { fromEvent, switchMap, tap, interval, take } from 'rxjs';\n *\n * const source$ = fromEvent(document, 'click');\n * const result$ = source$.pipe(\n *   switchMap((_, i) => i % 2 === 0\n *     ? fromEvent(document, 'mousemove').pipe(\n *         tap({\n *           subscribe: () => console.log('Subscribed to the mouse move events after click #' + i),\n *           unsubscribe: () => console.log('Mouse move events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('Mouse move events #' + i + ' finalized')\n *         })\n *       )\n *     : interval(1_000).pipe(\n *         take(5),\n *         tap({\n *           subscribe: () => console.log('Subscribed to the 1-second interval events after click #' + i),\n *           unsubscribe: () => console.log('1-second interval events #' + i + ' unsubscribed'),\n *           finalize: () => console.log('1-second interval events #' + i + ' finalized')\n *         })\n *       )\n *   )\n * );\n *\n * const subscription = result$.subscribe({\n *   next: console.log\n * });\n *\n * setTimeout(() => {\n *   console.log('Unsubscribe after 60 seconds');\n *   subscription.unsubscribe();\n * }, 60_000);\n * ```\n */\nexport interface TapObserver<T> extends Observer<T> {\n  /**\n   * The callback that `tap` operator invokes at the moment when the source Observable\n   * gets subscribed to.\n   */\n  subscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when an explicit\n   * {@link guide/glossary-and-semantics#unsubscription unsubscribe} happens. It won't get invoked on\n   * `error` or `complete` events.\n   */\n  unsubscribe: () => void;\n  /**\n   * The callback that `tap` operator invokes when any kind of\n   * {@link guide/glossary-and-semantics#finalization finalization} happens - either when\n   * the source Observable `error`s or `complete`s or when it gets explicitly unsubscribed\n   * by the user. There is no difference in using this callback or the {@link finalize}\n   * operator, but if you're already using `tap` operator, you can use this callback\n   * instead. You'd get the same result in either case.\n   */\n  finalize: () => void;\n}\nexport function tap<T>(observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void)): MonoTypeOperatorFunction<T>;\n/** @deprecated Instead of passing separate callback arguments, use an observer argument. Signatures taking separate callback arguments will be removed in v8. Details: https://rxjs.dev/deprecations/subscribe-arguments */\nexport function tap<T>(\n  next?: ((value: T) => void) | null,\n  error?: ((error: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T>;\n\n/**\n * Used to perform side-effects for notifications from the source observable\n *\n * <span class=\"informal\">Used when you want to affect outside state with a notification without altering the notification</span>\n *\n * ![](tap.png)\n *\n * Tap is designed to allow the developer a designated place to perform side effects. While you _could_ perform side-effects\n * inside of a `map` or a `mergeMap`, that would make their mapping functions impure, which isn't always a big deal, but will\n * make it so you can't do things like memoize those functions. The `tap` operator is designed solely for such side-effects to\n * help you remove side-effects from other operations.\n *\n * For any notification, next, error, or complete, `tap` will call the appropriate callback you have provided to it, via a function\n * reference, or a partial observer, then pass that notification down the stream.\n *\n * The observable returned by `tap` is an exact mirror of the source, with one exception: Any error that occurs -- synchronously -- in a handler\n * provided to `tap` will be emitted as an error from the returned observable.\n *\n * > Be careful! You can mutate objects as they pass through the `tap` operator's handlers.\n *\n * The most common use of `tap` is actually for debugging. You can place a `tap(console.log)` anywhere\n * in your observable `pipe`, log out the notifications as they are emitted by the source returned by the previous\n * operation.\n *\n * ## Examples\n *\n * Check a random number before it is handled. Below is an observable that will use a random number between 0 and 1,\n * and emit `'big'` or `'small'` depending on the size of that number. But we wanted to log what the original number\n * was, so we have added a `tap(console.log)`.\n *\n * ```ts\n * import { of, tap, map } from 'rxjs';\n *\n * of(Math.random()).pipe(\n *   tap(console.log),\n *   map(n => n > 0.5 ? 'big' : 'small')\n * ).subscribe(console.log);\n * ```\n *\n * Using `tap` to analyze a value and force an error. Below is an observable where in our system we only\n * want to emit numbers 3 or less we get from another source. We can force our observable to error\n * using `tap`.\n *\n * ```ts\n * import { of, tap } from 'rxjs';\n *\n * const source = of(1, 2, 3, 4, 5);\n *\n * source.pipe(\n *   tap(n => {\n *     if (n > 3) {\n *       throw new TypeError(`Value ${ n } is greater than 3`);\n *     }\n *   })\n * )\n * .subscribe({ next: console.log, error: err => console.log(err.message) });\n * ```\n *\n * We want to know when an observable completes before moving on to the next observable. The system\n * below will emit a random series of `'X'` characters from 3 different observables in sequence. The\n * only way we know when one observable completes and moves to the next one, in this case, is because\n * we have added a `tap` with the side effect of logging to console.\n *\n * ```ts\n * import { of, concatMap, interval, take, map, tap } from 'rxjs';\n *\n * of(1, 2, 3).pipe(\n *   concatMap(n => interval(1000).pipe(\n *     take(Math.round(Math.random() * 10)),\n *     map(() => 'X'),\n *     tap({ complete: () => console.log(`Done with ${ n }`) })\n *   ))\n * )\n * .subscribe(console.log);\n * ```\n *\n * @see {@link finalize}\n * @see {@link TapObserver}\n *\n * @param observerOrNext A next handler or partial observer\n * @param error An error handler\n * @param complete A completion handler\n * @return A function that returns an Observable identical to the source, but\n * runs the specified Observer or callback(s) for each item.\n */\nexport function tap<T>(\n  observerOrNext?: Partial<TapObserver<T>> | ((value: T) => void) | null,\n  error?: ((e: any) => void) | null,\n  complete?: (() => void) | null\n): MonoTypeOperatorFunction<T> {\n  // We have to check to see not only if next is a function,\n  // but if error or complete were passed. This is because someone\n  // could technically call tap like `tap(null, fn)` or `tap(null, null, fn)`.\n  const tapObserver =\n    isFunction(observerOrNext) || error || complete\n      ? // tslint:disable-next-line: no-object-literal-type-assertion\n        ({ next: observerOrNext as Exclude<typeof observerOrNext, Partial<TapObserver<T>>>, error, complete } as Partial<TapObserver<T>>)\n      : observerOrNext;\n\n  return tapObserver\n    ? operate((source, subscriber) => {\n        tapObserver.subscribe?.();\n        let isUnsub = true;\n        source.subscribe(\n          createOperatorSubscriber(\n            subscriber,\n            (value) => {\n              tapObserver.next?.(value);\n              subscriber.next(value);\n            },\n            () => {\n              isUnsub = false;\n              tapObserver.complete?.();\n              subscriber.complete();\n            },\n            (err) => {\n              isUnsub = false;\n              tapObserver.error?.(err);\n              subscriber.error(err);\n            },\n            () => {\n              if (isUnsub) {\n                tapObserver.unsubscribe?.();\n              }\n              tapObserver.finalize?.();\n            }\n          )\n        );\n      })\n    : // Tap was called with no valid tap observer or handler\n      // (e.g. `tap(null, null, null)` or `tap(null)` or `tap()`)\n      // so we're going to just mirror the source.\n      identity;\n}\n", "import { Subscription } from '../Subscription';\n\nimport { MonoTypeOperatorFunction, ObservableInput } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\n\n/**\n * An object interface used by {@link throttle} or {@link throttleTime} that ensure\n * configuration options of these operators.\n *\n * @see {@link throttle}\n * @see {@link throttleTime}\n */\nexport interface ThrottleConfig {\n  /**\n   * If `true`, the resulting Observable will emit the first value from the source\n   * Observable at the **start** of the \"throttling\" process (when starting an\n   * internal timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the first value from the source Observable at the\n   * start of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `true`.\n   */\n  leading?: boolean;\n  /**\n   * If `true`, the resulting Observable will emit the last value from the source\n   * Observable at the **end** of the \"throttling\" process (when ending an internal\n   * timer that prevents other emissions from the source to pass through).\n   * If `false`, it will not emit the last value from the source Observable at the\n   * end of the \"throttling\" process.\n   *\n   * If not provided, defaults to: `false`.\n   */\n  trailing?: boolean;\n}\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for a duration determined by another Observable, then repeats this\n * process.\n *\n * <span class=\"informal\">It's like {@link throttleTime}, but the silencing\n * duration is determined by a second Observable.</span>\n *\n * ![](throttle.svg)\n *\n * `throttle` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled by calling the `durationSelector` function with the source value,\n * which returns the \"duration\" Observable. When the duration Observable emits a\n * value, the timer is disabled, and this process repeats for the\n * next source value.\n *\n * ## Example\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttle, interval } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttle(() => interval(1000)));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link audit}\n * @see {@link debounce}\n * @see {@link delayWhen}\n * @see {@link sample}\n * @see {@link throttleTime}\n *\n * @param durationSelector A function that receives a value from the source\n * Observable, for computing the silencing duration for each source value,\n * returned as an `ObservableInput`.\n * @param config A configuration object to define `leading` and `trailing`\n * behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttle<T>(durationSelector: (value: T) => ObservableInput<any>, config?: ThrottleConfig): MonoTypeOperatorFunction<T> {\n  return operate((source, subscriber) => {\n    const { leading = true, trailing = false } = config ?? {};\n    let hasValue = false;\n    let sendValue: T | null = null;\n    let throttled: Subscription | null = null;\n    let isComplete = false;\n\n    const endThrottling = () => {\n      throttled?.unsubscribe();\n      throttled = null;\n      if (trailing) {\n        send();\n        isComplete && subscriber.complete();\n      }\n    };\n\n    const cleanupThrottling = () => {\n      throttled = null;\n      isComplete && subscriber.complete();\n    };\n\n    const startThrottle = (value: T) =>\n      (throttled = innerFrom(durationSelector(value)).subscribe(createOperatorSubscriber(subscriber, endThrottling, cleanupThrottling)));\n\n    const send = () => {\n      if (hasValue) {\n        // Ensure we clear out our value and hasValue flag\n        // before we emit, otherwise reentrant code can cause\n        // issues here.\n        hasValue = false;\n        const value = sendValue!;\n        sendValue = null;\n        // Emit the value.\n        subscriber.next(value);\n        !isComplete && startThrottle(value);\n      }\n    };\n\n    source.subscribe(\n      createOperatorSubscriber(\n        subscriber,\n        // Regarding the presence of throttled.closed in the following\n        // conditions, if a synchronous duration selector is specified - weird,\n        // but legal - an already-closed subscription will be assigned to\n        // throttled, so the subscription's closed property needs to be checked,\n        // too.\n        (value) => {\n          hasValue = true;\n          sendValue = value;\n          !(throttled && !throttled.closed) && (leading ? send() : startThrottle(value));\n        },\n        () => {\n          isComplete = true;\n          !(trailing && hasValue && throttled && !throttled.closed) && subscriber.complete();\n        }\n      )\n    );\n  });\n}\n", "import { asyncScheduler } from '../scheduler/async';\nimport { throttle, ThrottleConfig } from './throttle';\nimport { MonoTypeOperatorFunction, SchedulerLike } from '../types';\nimport { timer } from '../observable/timer';\n\n/**\n * Emits a value from the source Observable, then ignores subsequent source\n * values for `duration` milliseconds, then repeats this process.\n *\n * <span class=\"informal\">Lets a value pass, then ignores source values for the\n * next `duration` milliseconds.</span>\n *\n * ![](throttleTime.png)\n *\n * `throttleTime` emits the source Observable values on the output Observable\n * when its internal timer is disabled, and ignores source values when the timer\n * is enabled. Initially, the timer is disabled. As soon as the first source\n * value arrives, it is forwarded to the output Observable, and then the timer\n * is enabled. After `duration` milliseconds (or the time unit determined\n * internally by the optional `scheduler`) has passed, the timer is disabled,\n * and this process repeats for the next source value. Optionally takes a\n * {@link SchedulerLike} for managing timers.\n *\n * ## Examples\n *\n * ### Limit click rate\n *\n * Emit clicks at a rate of at most one click per second\n *\n * ```ts\n * import { fromEvent, throttleTime } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const result = clicks.pipe(throttleTime(1000));\n *\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link auditTime}\n * @see {@link debounceTime}\n * @see {@link delay}\n * @see {@link sampleTime}\n * @see {@link throttle}\n *\n * @param duration Time to wait before emitting another value after\n * emitting the last value, measured in milliseconds or the time unit determined\n * internally by the optional `scheduler`.\n * @param scheduler The {@link SchedulerLike} to use for\n * managing the timers that handle the throttling. Defaults to {@link asyncScheduler}.\n * @param config A configuration object to define `leading` and\n * `trailing` behavior. Defaults to `{ leading: true, trailing: false }`.\n * @return A function that returns an Observable that performs the throttle\n * operation to limit the rate of emissions from the source.\n */\nexport function throttleTime<T>(\n  duration: number,\n  scheduler: SchedulerLike = asyncScheduler,\n  config?: ThrottleConfig\n): MonoTypeOperatorFunction<T> {\n  const duration$ = timer(duration, scheduler);\n  return throttle(() => duration$, config);\n}\n", "import { OperatorFunction, ObservableInputTuple } from '../types';\nimport { operate } from '../util/lift';\nimport { createOperatorSubscriber } from './OperatorSubscriber';\nimport { innerFrom } from '../observable/innerFrom';\nimport { identity } from '../util/identity';\nimport { noop } from '../util/noop';\nimport { popResultSelector } from '../util/args';\n\nexport function withLatestFrom<T, O extends unknown[]>(...inputs: [...ObservableInputTuple<O>]): OperatorFunction<T, [T, ...O]>;\n\nexport function withLatestFrom<T, O extends unknown[], R>(\n  ...inputs: [...ObservableInputTuple<O>, (...value: [T, ...O]) => R]\n): OperatorFunction<T, R>;\n\n/**\n * Combines the source Observable with other Observables to create an Observable\n * whose values are calculated from the latest values of each, only when the\n * source emits.\n *\n * <span class=\"informal\">Whenever the source Observable emits a value, it\n * computes a formula using that value plus the latest values from other input\n * Observables, then emits the output of that formula.</span>\n *\n * ![](withLatestFrom.png)\n *\n * `withLatestFrom` combines each value from the source Observable (the\n * instance) with the latest values from the other input Observables only when\n * the source emits a value, optionally using a `project` function to determine\n * the value to be emitted on the output Observable. All input Observables must\n * emit at least one value before the output Observable will emit a value.\n *\n * ## Example\n *\n * On every click event, emit an array with the latest timer event plus the click event\n *\n * ```ts\n * import { fromEvent, interval, withLatestFrom } from 'rxjs';\n *\n * const clicks = fromEvent(document, 'click');\n * const timer = interval(1000);\n * const result = clicks.pipe(withLatestFrom(timer));\n * result.subscribe(x => console.log(x));\n * ```\n *\n * @see {@link combineLatest}\n *\n * @param {ObservableInput} other An input Observable to combine with the source\n * Observable. More than one input Observables may be given as argument.\n * @param {Function} [project] Projection function for combining values\n * together. Receives all values in order of the Observables passed, where the\n * first parameter is a value from the source Observable. (e.g.\n * `a.pipe(withLatestFrom(b, c), map(([a1, b1, c1]) => a1 + b1 + c1))`). If this is not\n * passed, arrays will be emitted on the output Observable.\n * @return A function that returns an Observable of projected values from the\n * most recent values from each input Observable, or an array of the most\n * recent values from each input Observable.\n */\nexport function withLatestFrom<T, R>(...inputs: any[]): OperatorFunction<T, R | any[]> {\n  const project = popResultSelector(inputs) as ((...args: any[]) => R) | undefined;\n\n  return operate((source, subscriber) => {\n    const len = inputs.length;\n    const otherValues = new Array(len);\n    // An array of whether or not the other sources have emitted. Matched with them by index.\n    // TODO: At somepoint, we should investigate the performance implications here, and look\n    // into using a `Set()` and checking the `size` to see if we're ready.\n    let hasValue = inputs.map(() => false);\n    // Flipped true when we have at least one value from all other sources and\n    // we are ready to start emitting values.\n    let ready = false;\n\n    // Other sources. Note that here we are not checking `subscriber.closed`,\n    // this causes all inputs to be subscribed to, even if nothing can be emitted\n    // from them. This is an important distinction because subscription constitutes\n    // a side-effect.\n    for (let i = 0; i < len; i++) {\n      innerFrom(inputs[i]).subscribe(\n        createOperatorSubscriber(\n          subscriber,\n          (value) => {\n            otherValues[i] = value;\n            if (!ready && !hasValue[i]) {\n              // If we're not ready yet, flag to show this observable has emitted.\n              hasValue[i] = true;\n              // Intentionally terse code.\n              // If all of our other observables have emitted, set `ready` to `true`,\n              // so we know we can start emitting values, then clean up the `hasValue` array,\n              // because we don't need it anymore.\n              (ready = hasValue.every(identity)) && (hasValue = null!);\n            }\n          },\n          // Completing one of the other sources has\n          // no bearing on the completion of our result.\n          noop\n        )\n      );\n    }\n\n    // Source subscription\n    source.subscribe(\n      createOperatorSubscriber(subscriber, (value) => {\n        if (ready) {\n          // We have at least one value from the other sources. Go ahead and emit.\n          const values = [value, ...otherValues];\n          subscriber.next(project ? project(...values) : values);\n        }\n      })\n    );\n  });\n}\n", "import { zip as zipStatic } from '../observable/zip';\nimport { ObservableInput, ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { operate } from '../util/lift';\n\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  otherInputsAndProject: [...ObservableInputTuple<A>],\n  project: (...values: Cons<T, A>) => R\n): OperatorFunction<T, R>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>>;\n/** @deprecated Replaced with {@link zipWith}. Will be removed in v8. */\nexport function zip<T, A extends readonly unknown[], R>(\n  ...otherInputsAndProject: [...ObservableInputTuple<A>, (...values: Cons<T, A>) => R]\n): OperatorFunction<T, R>;\n\n/**\n * @deprecated Replaced with {@link zipWith}. Will be removed in v8.\n */\nexport function zip<T, R>(...sources: Array<ObservableInput<any> | ((...values: Array<any>) => R)>): OperatorFunction<T, any> {\n  return operate((source, subscriber) => {\n    zipStatic(source as ObservableInput<any>, ...(sources as Array<ObservableInput<any>>)).subscribe(subscriber);\n  });\n}\n", "import { ObservableInputTuple, OperatorFunction, Cons } from '../types';\nimport { zip } from './zip';\n\n/**\n * Subscribes to the source, and the observable inputs provided as arguments, and combines their values, by index, into arrays.\n *\n * What is meant by \"combine by index\": The first value from each will be made into a single array, then emitted,\n * then the second value from each will be combined into a single array and emitted, then the third value\n * from each will be combined into a single array and emitted, and so on.\n *\n * This will continue until it is no longer able to combine values of the same index into an array.\n *\n * After the last value from any one completed source is emitted in an array, the resulting observable will complete,\n * as there is no way to continue \"zipping\" values together by index.\n *\n * Use-cases for this operator are limited. There are memory concerns if one of the streams is emitting\n * values at a much faster rate than the others. Usage should likely be limited to streams that emit\n * at a similar pace, or finite streams of known length.\n *\n * In many cases, authors want `combineLatestWith` and not `zipWith`.\n *\n * @param otherInputs other observable inputs to collate values from.\n * @return A function that returns an Observable that emits items by index\n * combined from the source Observable and provided Observables, in form of an\n * array.\n */\nexport function zipWith<T, A extends readonly unknown[]>(...otherInputs: [...ObservableInputTuple<A>]): OperatorFunction<T, Cons<T, A>> {\n  return zip(...otherInputs);\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ReplaySubject,\n  Subject,\n  fromEvent\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch document\n *\n * Documents are implemented as subjects, so all downstream observables are\n * automatically updated when a new document is emitted.\n *\n * @returns Document subject\n */\nexport function watchDocument(): Subject<Document> {\n  const document$ = new ReplaySubject<Document>(1)\n  fromEvent(document, \"DOMContentLoaded\", { once: true })\n    .subscribe(() => document$.next(document))\n\n  /* Return document */\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T[]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T[] {\n  return Array.from(node.querySelectorAll<T>(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T {\n  const el = getOptionalElement<T>(selector, node)\n  if (typeof el === \"undefined\")\n    throw new ReferenceError(\n      `Missing element: expected \"${selector}\" to be present`\n    )\n\n  /* Return element */\n  return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T | undefined {\n  return node.querySelector<T>(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n  return (\n    document.activeElement?.shadowRoot?.activeElement as HTMLElement ??\n    document.activeElement as HTMLElement ??\n    undefined\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounceTime,\n  distinctUntilChanged,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Focus observable\n *\n * Previously, this observer used `focus` and `blur` events to determine whether\n * an element is focused, but this doesn't work if there are focusable elements\n * within the elements itself. A better solutions are `focusin` and `focusout`\n * events, which bubble up the tree and allow for more fine-grained control.\n *\n * `debounceTime` is necessary, because when a focus change happens inside an\n * element, the observable would first emit `false` and then `true` again.\n */\nconst observer$ = merge(\n  fromEvent(document.body, \"focusin\"),\n  fromEvent(document.body, \"focusout\")\n)\n  .pipe(\n    debounceTime(1),\n    startWith(undefined),\n    map(() => getActiveElement() || document.body),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element focus\n *\n * @param el - Element\n *\n * @returns Element focus observable\n */\nexport function watchElementFocus(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      map(active => el.contains(active)),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  debounce,\n  defer,\n  fromEvent,\n  identity,\n  map,\n  merge,\n  startWith,\n  timer\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element hover\n *\n * The second parameter allows to specify a timeout in milliseconds after which\n * the hover state will be reset to `false`. This is useful for tooltips which\n * should disappear after a certain amount of time, in order to allow the user\n * to move the cursor from the host to the tooltip.\n *\n * @param el - Element\n * @param timeout - Timeout\n *\n * @returns Element hover observable\n */\nexport function watchElementHover(\n  el: HTMLElement, timeout?: number\n): Observable<boolean> {\n  return defer(() => merge(\n    fromEvent(el, \"mouseenter\").pipe(map(() => true)),\n    fromEvent(el, \"mouseleave\").pipe(map(() => false))\n  )\n    .pipe(\n      timeout ? debounce(active => timer(+!active * timeout)) : identity,\n      startWith(el.matches(\":hover\"))\n    )\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { JSX as JSXInternal } from \"preact\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * HTML attributes\n */\ntype Attributes =\n  & JSXInternal.HTMLAttributes\n  & JSXInternal.SVGAttributes\n  & Record<string, any>\n\n/**\n * Child element\n */\ntype Child =\n  | ChildNode\n  | HTMLElement\n  | Text\n  | string\n  | number\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Append a child node to an element\n *\n * @param el - Element\n * @param child - Child node(s)\n */\nfunction appendChild(el: HTMLElement, child: Child | Child[]): void {\n\n  /* Handle primitive types (including raw HTML) */\n  if (typeof child === \"string\" || typeof child === \"number\") {\n    el.innerHTML += child.toString()\n\n  /* Handle nodes */\n  } else if (child instanceof Node) {\n    el.appendChild(child)\n\n  /* Handle nested children */\n  } else if (Array.isArray(child)) {\n    for (const node of child)\n      appendChild(el, node)\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * JSX factory\n *\n * @template T - Element type\n *\n * @param tag - HTML tag\n * @param attributes - HTML attributes\n * @param children - Child elements\n *\n * @returns Element\n */\nexport function h<T extends keyof HTMLElementTagNameMap>(\n  tag: T, attributes?: Attributes | null, ...children: Child[]\n): HTMLElementTagNameMap[T]\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T\n\nexport function h<T extends h.JSX.Element>(\n  tag: string, attributes?: Attributes | null, ...children: Child[]\n): T {\n  const el = document.createElement(tag)\n\n  /* Set attributes, if any */\n  if (attributes)\n    for (const attr of Object.keys(attributes)) {\n      if (typeof attributes[attr] === \"undefined\")\n        continue\n\n      /* Set default attribute or boolean */\n      if (typeof attributes[attr] !== \"boolean\")\n        el.setAttribute(attr, attributes[attr])\n      else\n        el.setAttribute(attr, \"\")\n    }\n\n  /* Append child nodes */\n  for (const child of children)\n    appendChild(el, child)\n\n  /* Return element */\n  return el as T\n}\n\n/* ----------------------------------------------------------------------------\n * Namespace\n * ------------------------------------------------------------------------- */\n\nexport declare namespace h {\n  namespace JSX {\n    type Element = HTMLElement\n    type IntrinsicElements = JSXInternal.IntrinsicElements\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Round a number for display with repository facts\n *\n * This is a reverse-engineered version of GitHub's weird rounding algorithm\n * for stars, forks and all other numbers. While all numbers below `1,000` are\n * returned as-is, bigger numbers are converted to fixed numbers:\n *\n * - `1,049` => `1k`\n * - `1,050` => `1.1k`\n * - `1,949` => `1.9k`\n * - `1,950` => `2k`\n *\n * @param value - Original value\n *\n * @returns Rounded value\n */\nexport function round(value: number): string {\n  if (value > 999) {\n    const digits = +((value - 950) % 1000 > 99)\n    return `${((value + 0.000001) / 1000).toFixed(digits)}k`\n  } else {\n    return value.toString()\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  switchMap,\n  take,\n  throwError\n} from \"rxjs\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create and load a `script` element\n *\n * This function returns an observable that will emit when the script was\n * successfully loaded, or throw an error if it wasn't.\n *\n * @param src - Script URL\n *\n * @returns Script observable\n */\nexport function watchScript(src: string): Observable<void> {\n  const script = h(\"script\", { src })\n  return defer(() => {\n    document.head.appendChild(script)\n    return merge(\n      fromEvent(script, \"load\"),\n      fromEvent(script, \"error\")\n        .pipe(\n          switchMap(() => (\n            throwError(() => new ReferenceError(`Invalid script: ${src}`))\n          ))\n        )\n    )\n      .pipe(\n        map(() => undefined),\n        finalize(() => document.head.removeChild(script)),\n        take(1)\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"../../../script\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementSize {\n  width: number                        /* Element width */\n  height: number                       /* Element height */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Resize observer entry subject\n */\nconst entry$ = new Subject<ResizeObserverEntry>()\n\n/**\n * Resize observer observable\n *\n * This observable will create a `ResizeObserver` on the first subscription\n * and will automatically terminate it when there are no more subscribers.\n * It's quite important to centralize observation in a single `ResizeObserver`,\n * as the performance difference can be quite dramatic, as the link shows.\n *\n * If the browser doesn't have a `ResizeObserver` implementation available, a\n * polyfill is automatically downloaded from unpkg.com. This is also compatible\n * with the built-in privacy plugin, which will download the polyfill and put\n * it alongside the built site for self-hosting.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => (\n  typeof ResizeObserver === \"undefined\"\n    ? watchScript(\"https://unpkg.com/resize-observer-polyfill\")\n    : of(undefined)\n))\n  .pipe(\n    map(() => new ResizeObserver(entries => (\n      entries.forEach(entry => entry$.next(entry))\n    ))),\n    switchMap(observer => merge(NEVER, of(observer)).pipe(\n      finalize(() => observer.disconnect())\n    )),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element size\n *\n * @param el - Element\n *\n * @returns Element size\n */\nexport function getElementSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.offsetWidth,\n    height: el.offsetHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element size\n *\n * This function returns an observable that subscribes to a single internal\n * instance of `ResizeObserver` upon subscription, and emit resize events until\n * termination. Note that this function should not be called with the same\n * element twice, as the first unsubscription will terminate observation.\n *\n * Sadly, we can't use the `DOMRect` objects returned by the observer, because\n * we need the emitted values to be consistent with `getElementSize`, which will\n * return the used values (rounded) and not actual values (unrounded). Thus, we\n * use the `offset*` properties. See the linked GitHub issue.\n *\n * @see https://bit.ly/3m0k3he - GitHub issue\n *\n * @param el - Element\n *\n * @returns Element size observable\n */\nexport function watchElementSize(\n  el: HTMLElement\n): Observable<ElementSize> {\n\n  // Compute target element - since inline elements cannot be observed by the\n  // current `ResizeObserver` implementation as provided by browsers, we need\n  // to determine the first containing parent element and use that one as a\n  // target, while we always compute the actual size from the element.\n  let target = el\n  while (target.clientWidth === 0)\n    if (target.parentElement)\n      target = target.parentElement\n    else\n      break\n\n  // Observe target element and recompute element size on resize - as described\n  // above, the target element is not necessarily the element of interest\n  return observer$.pipe(\n    tap(observer => observer.observe(target)),\n    switchMap(observer => entry$.pipe(\n      filter(entry => entry.target === target),\n      finalize(() => observer.unobserve(target))\n    )),\n    map(() => getElementSize(el)),\n    startWith(getElementSize(el))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ElementSize } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content size (= scroll width and height)\n *\n * @param el - Element\n *\n * @returns Element content size\n */\nexport function getElementContentSize(\n  el: HTMLElement\n): ElementSize {\n  return {\n    width:  el.scrollWidth,\n    height: el.scrollHeight\n  }\n}\n\n/**\n * Retrieve the overflowing container of an element, if any\n *\n * @param el - Element\n *\n * @returns Overflowing container or nothing\n */\nexport function getElementContainer(\n  el: HTMLElement\n): HTMLElement | undefined {\n  let parent = el.parentElement\n  while (parent)\n    if (\n      el.scrollWidth  <= parent.scrollWidth &&\n      el.scrollHeight <= parent.scrollHeight\n    )\n      parent = (el = parent).parentElement\n    else\n      break\n\n  /* Return overflowing container */\n  return parent ? el : undefined\n}\n\n/**\n * Retrieve all overflowing containers of an element, if any\n *\n * Note that this function has a slightly different behavior, so we should at\n * some point consider refactoring how overflowing containers are handled.\n *\n * @param el - Element\n *\n * @returns Overflowing containers\n */\nexport function getElementContainers(\n  el: HTMLElement\n): HTMLElement[] {\n  const containers: HTMLElement[] = []\n\n  // Walk up the DOM tree until we find an overflowing container\n  let parent = el.parentElement\n  while (parent) {\n    if (\n      el.clientWidth  > parent.clientWidth ||\n      el.clientHeight > parent.clientHeight\n    )\n      containers.push(parent)\n\n    // Continue with parent element\n    parent = (el = parent).parentElement\n  }\n\n  // If the page is short, the body might not be overflowing and there might be\n  // no other containers, which is why we need to make sure the body is present\n  if (containers.length === 0)\n    containers.push(document.documentElement)\n\n  // Return overflowing containers\n  return containers\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { watchElementSize } from \"../../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.offsetLeft,\n    y: el.offsetTop\n  }\n}\n\n/**\n * Retrieve absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffsetAbsolute(\n  el: HTMLElement\n): ElementOffset {\n  const rect = el.getBoundingClientRect()\n  return {\n    x: rect.x + window.scrollX,\n    y: rect.y + window.scrollY\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(window, \"load\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementOffset(el)),\n      startWith(getElementOffset(el))\n    )\n}\n\n/**\n * Watch absolute element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffsetAbsolute(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    watchElementOffset(el),\n    watchElementSize(document.body) // @todo find a better way for this\n  )\n    .pipe(\n      map(() => getElementOffsetAbsolute(el)),\n      startWith(getElementOffsetAbsolute(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  animationFrameScheduler,\n  auditTime,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\nimport { ElementOffset } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content offset (= scroll offset)\n *\n * @param el - Element\n *\n * @returns Element content offset\n */\nexport function getElementContentOffset(\n  el: HTMLElement\n): ElementOffset {\n  return {\n    x: el.scrollLeft,\n    y: el.scrollTop\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element content offset\n *\n * @param el - Element\n *\n * @returns Element content offset observable\n */\nexport function watchElementContentOffset(\n  el: HTMLElement\n): Observable<ElementOffset> {\n  return merge(\n    fromEvent(el, \"scroll\"),\n    fromEvent(window, \"scroll\"),\n    fromEvent(window, \"resize\")\n  )\n    .pipe(\n      auditTime(0, animationFrameScheduler),\n      map(() => getElementContentOffset(el)),\n      startWith(getElementContentOffset(el))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  shareReplay,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElementContentSize,\n  getElementSize,\n  watchElementContentOffset\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Intersection observer entry subject\n */\nconst entry$ = new Subject<IntersectionObserverEntry>()\n\n/**\n * Intersection observer observable\n *\n * This observable will create an `IntersectionObserver` on first subscription\n * and will automatically terminate it when there are no more subscribers.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n  new IntersectionObserver(entries => {\n    for (const entry of entries)\n      entry$.next(entry)\n  }, {\n    threshold: 0\n  })\n))\n  .pipe(\n    switchMap(observer => merge(NEVER, of(observer))\n      .pipe(\n        finalize(() => observer.disconnect())\n      )\n    ),\n    shareReplay(1)\n  )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element visibility\n *\n * @param el - Element\n *\n * @returns Element visibility observable\n */\nexport function watchElementVisibility(\n  el: HTMLElement\n): Observable<boolean> {\n  return observer$\n    .pipe(\n      tap(observer => observer.observe(el)),\n      switchMap(observer => entry$\n        .pipe(\n          filter(({ target }) => target === el),\n          finalize(() => observer.unobserve(el)),\n          map(({ isIntersecting }) => isIntersecting)\n        )\n      )\n    )\n}\n\n/**\n * Watch element boundary\n *\n * This function returns an observable which emits whether the bottom content\n * boundary (= scroll offset) of an element is within a certain threshold.\n *\n * @param el - Element\n * @param threshold - Threshold\n *\n * @returns Element boundary observable\n */\nexport function watchElementBoundary(\n  el: HTMLElement, threshold = 16\n): Observable<boolean> {\n  return watchElementContentOffset(el)\n    .pipe(\n      map(({ y }) => {\n        const visible = getElementSize(el)\n        const content = getElementContentSize(el)\n        return y >= (\n          content.height - visible.height - threshold\n        )\n      }),\n      distinctUntilChanged()\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getElement } from \"../element\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle\n */\nexport type Toggle =\n  | \"drawer\"                           /* Toggle for drawer */\n  | \"search\"                           /* Toggle for search */\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle map\n */\nconst toggles: Record<Toggle, HTMLInputElement> = {\n  drawer: getElement(\"[data-md-toggle=drawer]\"),\n  search: getElement(\"[data-md-toggle=search]\")\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the value of a toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value\n */\nexport function getToggle(name: Toggle): boolean {\n  return toggles[name].checked\n}\n\n/**\n * Set toggle\n *\n * Simulating a click event seems to be the most cross-browser compatible way\n * of changing the value while also emitting a `change` event. Before, Material\n * used `CustomEvent` to programmatically change the value of a toggle, but this\n * is a much simpler and cleaner solution which doesn't require a polyfill.\n *\n * @param name - Toggle\n * @param value - Toggle value\n */\nexport function setToggle(name: Toggle, value: boolean): void {\n  if (toggles[name].checked !== value)\n    toggles[name].click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value observable\n */\nexport function watchToggle(name: Toggle): Observable<boolean> {\n  const el = toggles[name]\n  return fromEvent(el, \"change\")\n    .pipe(\n      map(() => el.checked),\n      startWith(el.checked)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  share,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../element\"\nimport { getToggle } from \"../toggle\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Keyboard mode\n */\nexport type KeyboardMode =\n  | \"global\"                           /* Global */\n  | \"search\"                           /* Search is open */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Keyboard\n */\nexport interface Keyboard {\n  mode: KeyboardMode                   /* Keyboard mode */\n  type: string                         /* Key type */\n  claim(): void                        /* Key claim */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether an element may receive keyboard input\n *\n * @param el - Element\n * @param type - Key type\n *\n * @returns Test result\n */\nfunction isSusceptibleToKeyboard(\n  el: HTMLElement, type: string\n): boolean {\n  switch (el.constructor) {\n\n    /* Input elements */\n    case HTMLInputElement:\n      /* @ts-expect-error - omit unnecessary type cast */\n      if (el.type === \"radio\")\n        return /^Arrow/.test(type)\n      else\n        return true\n\n    /* Select element and textarea */\n    case HTMLSelectElement:\n    case HTMLTextAreaElement:\n      return true\n\n    /* Everything else */\n    default:\n      return el.isContentEditable\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch composition events\n *\n * @returns Composition observable\n */\nexport function watchComposition(): Observable<boolean> {\n  return merge(\n    fromEvent(window, \"compositionstart\").pipe(map(() => true)),\n    fromEvent(window, \"compositionend\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(false)\n    )\n}\n\n/**\n * Watch keyboard\n *\n * @returns Keyboard observable\n */\nexport function watchKeyboard(): Observable<Keyboard> {\n  const keyboard$ = fromEvent<KeyboardEvent>(window, \"keydown\")\n    .pipe(\n      filter(ev => !(ev.metaKey || ev.ctrlKey)),\n      map(ev => ({\n        mode: getToggle(\"search\") ? \"search\" : \"global\",\n        type: ev.key,\n        claim() {\n          ev.preventDefault()\n          ev.stopPropagation()\n        }\n      } as Keyboard)),\n      filter(({ mode, type }) => {\n        if (mode === \"global\") {\n          const active = getActiveElement()\n          if (typeof active !== \"undefined\")\n            return !isSusceptibleToKeyboard(active, type)\n        }\n        return true\n      }),\n      share()\n    )\n\n  /* Don't emit during composition events - see https://bit.ly/3te3Wl8 */\n  return watchComposition()\n    .pipe(\n      switchMap(active => !active ? keyboard$ : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Subject } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location\n *\n * This function returns a `URL` object (and not `Location`) to normalize the\n * typings across the application. Furthermore, locations need to be tracked\n * without setting them and `Location` is a singleton which represents the\n * current location.\n *\n * @returns URL\n */\nexport function getLocation(): URL {\n  return new URL(location.href)\n}\n\n/**\n * Set location\n *\n * If instant navigation is enabled, this function creates a temporary anchor\n * element, sets the `href` attribute, appends it to the body, clicks it, and\n * then removes it again. The event will bubble up the DOM and trigger be\n * intercepted by the instant loading business logic.\n *\n * Note that we must append and remove the anchor element, or the event will\n * not bubble up the DOM, making it impossible to intercept it.\n *\n * @param url - URL to navigate to\n * @param navigate - Force navigation\n */\nexport function setLocation(\n  url: URL | HTMLLinkElement, navigate = false\n): void {\n  if (feature(\"navigation.instant\") && !navigate) {\n    const el = h(\"a\", { href: url.href })\n    document.body.appendChild(el)\n    el.click()\n    el.remove()\n\n  // If we're not using instant navigation, and the page should not be reloaded\n  // just instruct the browser to navigate to the given URL\n  } else {\n    location.href = url.href\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location\n *\n * @returns Location subject\n */\nexport function watchLocation(): Subject<URL> {\n  return new Subject<URL>()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  merge,\n  shareReplay,\n  startWith\n} from \"rxjs\"\n\nimport { getOptionalElement } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location hash\n *\n * @returns Location hash\n */\nexport function getLocationHash(): string {\n  return location.hash.slice(1)\n}\n\n/**\n * Set location hash\n *\n * Setting a new fragment identifier via `location.hash` will have no effect\n * if the value doesn't change. When a new fragment identifier is set, we want\n * the browser to target the respective element at all times, which is why we\n * use this dirty little trick.\n *\n * @param hash - Location hash\n */\nexport function setLocationHash(hash: string): void {\n  const el = h(\"a\", { href: hash })\n  el.addEventListener(\"click\", ev => ev.stopPropagation())\n  el.click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location hash\n *\n * @param location$ - Location observable\n *\n * @returns Location hash observable\n */\nexport function watchLocationHash(\n  location$: Observable<URL>\n): Observable<string> {\n  return merge(\n    fromEvent<HashChangeEvent>(window, \"hashchange\"),\n    location$\n  )\n    .pipe(\n      map(getLocationHash),\n      startWith(getLocationHash()),\n      filter(hash => hash.length > 0),\n      shareReplay(1)\n    )\n}\n\n/**\n * Watch location target\n *\n * @param location$ - Location observable\n *\n * @returns Location target observable\n */\nexport function watchLocationTarget(\n  location$: Observable<URL>\n): Observable<HTMLElement> {\n  return watchLocationHash(location$)\n    .pipe(\n      map(id => getOptionalElement(`[id=\"${id}\"]`)!),\n      filter(el => typeof el !== \"undefined\")\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  fromEvent,\n  fromEventPattern,\n  map,\n  merge,\n  startWith,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch media query\n *\n * Note that although `MediaQueryList.addListener` is deprecated we have to\n * use it, because it's the only way to ensure proper downward compatibility.\n *\n * @see https://bit.ly/3dUBH2m - GitHub issue\n *\n * @param query - Media query\n *\n * @returns Media observable\n */\nexport function watchMedia(query: string): Observable<boolean> {\n  const media = matchMedia(query)\n  return fromEventPattern<boolean>(next => (\n    media.addListener(() => next(media.matches))\n  ))\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/**\n * Watch print mode\n *\n * @returns Print observable\n */\nexport function watchPrint(): Observable<boolean> {\n  const media = matchMedia(\"print\")\n  return merge(\n    fromEvent(window, \"beforeprint\").pipe(map(() => true)),\n    fromEvent(window, \"afterprint\").pipe(map(() => false))\n  )\n    .pipe(\n      startWith(media.matches)\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Toggle an observable with a media observable\n *\n * @template T - Data type\n *\n * @param query$ - Media observable\n * @param factory - Observable factory\n *\n * @returns Toggled observable\n */\nexport function at<T>(\n  query$: Observable<boolean>, factory: () => Observable<T>\n): Observable<T> {\n  return query$\n    .pipe(\n      switchMap(active => active ? factory() : EMPTY)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  map,\n  shareReplay,\n  switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Options\n */\ninterface Options {\n  progress$?: Subject<number>          // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the given URL\n *\n * This function returns an observable that emits the response as a blob and\n * completes, or emits an error if the request failed. The caller can cancel\n * the request by unsubscribing at any time, which will automatically abort\n * the inflight request and complete the observable.\n *\n * Note that we use `XMLHTTPRequest` not because we're nostalgic, but because\n * it's the only way to get progress events for downloads and also allow for\n * cancellation of requests, as the official Fetch API does not support this\n * yet, even though we're already in 2024.\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function request(\n  url: URL | string, options?: Options\n): Observable<Blob> {\n  return new Observable<Blob>(observer => {\n    const req = new XMLHttpRequest()\n    req.open(\"GET\", `${url}`)\n    req.responseType = \"blob\"\n\n    // Handle response\n    req.addEventListener(\"load\", () => {\n      if (req.status >= 200 && req.status < 300) {\n        observer.next(req.response)\n        observer.complete()\n\n      // Every response that is not in the 2xx range is considered an error\n      } else {\n        observer.error(new Error(req.statusText))\n      }\n    })\n\n    // Handle network errors\n    req.addEventListener(\"error\", () => {\n      observer.error(new Error(\"Network error\"))\n    })\n\n    // Handle aborted requests\n    req.addEventListener(\"abort\", () => {\n      observer.complete()\n    })\n\n    // Handle download progress\n    if (typeof options?.progress$ !== \"undefined\") {\n      req.addEventListener(\"progress\", event => {\n        if (event.lengthComputable) {\n          options.progress$!.next((event.loaded / event.total) * 100)\n\n        // Hack: Chromium doesn't report the total number of bytes if content\n        // is compressed, so we need this fallback - see https://t.ly/ZXofI\n        } else {\n          const length = req.getResponseHeader(\"Content-Length\") ?? 0\n          options.progress$!.next((event.loaded / +length) * 100)\n        }\n      })\n\n      // Immediately set progress to 5% to indicate that we're loading\n      options.progress$.next(5)\n    }\n\n    // Send request and automatically abort request upon unsubscription\n    req.send()\n    return () => req.abort()\n  })\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Fetch JSON from the given URL\n *\n * @template T - Data type\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestJSON<T>(\n  url: URL | string, options?: Options\n): Observable<T> {\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(body => JSON.parse(body) as T),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch HTML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestHTML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/html\")),\n      shareReplay(1)\n    )\n}\n\n/**\n * Fetch XML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestXML(\n  url: URL | string, options?: Options\n): Observable<Document> {\n  const dom = new DOMParser()\n  return request(url, options)\n    .pipe(\n      switchMap(res => res.text()),\n      map(res => dom.parseFromString(res, \"text/xml\")),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  merge,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport offset\n */\nexport interface ViewportOffset {\n  x: number                            /* Horizontal offset */\n  y: number                            /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport offset\n *\n * On iOS Safari, viewport offset can be negative due to overflow scrolling.\n * As this may induce strange behaviors downstream, we'll just limit it to 0.\n *\n * @returns Viewport offset\n */\nexport function getViewportOffset(): ViewportOffset {\n  return {\n    x: Math.max(0, scrollX),\n    y: Math.max(0, scrollY)\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport offset\n *\n * @returns Viewport offset observable\n */\nexport function watchViewportOffset(): Observable<ViewportOffset> {\n  return merge(\n    fromEvent(window, \"scroll\", { passive: true }),\n    fromEvent(window, \"resize\", { passive: true })\n  )\n    .pipe(\n      map(getViewportOffset),\n      startWith(getViewportOffset())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport size\n */\nexport interface ViewportSize {\n  width: number                        /* Viewport width */\n  height: number                       /* Viewport height */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport size\n *\n * @returns Viewport size\n */\nexport function getViewportSize(): ViewportSize {\n  return {\n    width:  innerWidth,\n    height: innerHeight\n  }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport size\n *\n * @returns Viewport size observable\n */\nexport function watchViewportSize(): Observable<ViewportSize> {\n  return fromEvent(window, \"resize\", { passive: true })\n    .pipe(\n      map(getViewportSize),\n      startWith(getViewportSize())\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  map,\n  shareReplay\n} from \"rxjs\"\n\nimport {\n  ViewportOffset,\n  watchViewportOffset\n} from \"../offset\"\nimport {\n  ViewportSize,\n  watchViewportSize\n} from \"../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport\n */\nexport interface Viewport {\n  offset: ViewportOffset               /* Viewport offset */\n  size: ViewportSize                   /* Viewport size */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport\n *\n * @returns Viewport observable\n */\nexport function watchViewport(): Observable<Viewport> {\n  return combineLatest([\n    watchViewportOffset(),\n    watchViewportSize()\n  ])\n    .pipe(\n      map(([offset, size]) => ({ offset, size })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilKeyChanged,\n  map\n} from \"rxjs\"\n\nimport { Header } from \"~/components\"\n\nimport { getElementOffset } from \"../../element\"\nimport { Viewport } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport relative to element\n *\n * @param el - Element\n * @param options - Options\n *\n * @returns Viewport observable\n */\nexport function watchViewportAt(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Viewport> {\n  const size$ = viewport$\n    .pipe(\n      distinctUntilKeyChanged(\"size\")\n    )\n\n  /* Compute element offset */\n  const offset$ = combineLatest([size$, header$])\n    .pipe(\n      map(() => getElementOffset(el))\n    )\n\n  /* Compute relative viewport, return hot observable */\n  return combineLatest([header$, viewport$, offset$])\n    .pipe(\n      map(([{ height }, { offset, size }, { x, y }]) => ({\n        offset: {\n          x: offset.x - x,\n          y: offset.y - y + height\n        },\n        size\n      }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  mergeWith,\n  share,\n  takeUntil\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Worker message\n */\nexport interface WorkerMessage {\n  type: unknown                        /* Message type */\n  data?: unknown                       /* Message data */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create an observable for receiving from a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message observable\n */\nfunction recv<T>(worker: Worker): Observable<T> {\n  return fromEvent<MessageEvent<T>, T>(worker, \"message\", ev => ev.data)\n}\n\n/**\n * Create a subject for sending to a web worker\n *\n * @template T - Data type\n *\n * @param worker - Web worker\n *\n * @returns Message subject\n */\nfunction send<T>(worker: Worker): Subject<T> {\n  const send$ = new Subject<T>()\n  send$.subscribe(data => worker.postMessage(data))\n\n  /* Return message subject */\n  return send$\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a bidirectional communication channel to a web worker\n *\n * @template T - Data type\n *\n * @param url - Worker URL\n * @param worker - Worker\n *\n * @returns Worker subject\n */\nexport function watchWorker<T extends WorkerMessage>(\n  url: string, worker = new Worker(url)\n): Subject<T> {\n  const recv$ = recv<T>(worker)\n  const send$ = send<T>(worker)\n\n  /* Create worker subject and forward messages */\n  const worker$ = new Subject<T>()\n  worker$.subscribe(send$)\n\n  /* Return worker subject */\n  const done$ = send$.pipe(ignoreElements(), endWith(true))\n  return worker$\n    .pipe(\n      ignoreElements(),\n      mergeWith(recv$.pipe(takeUntil(done$))),\n      share()\n    ) as Subject<T>\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getLocation } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Feature flag\n */\nexport type Flag =\n  | \"announce.dismiss\"                 /* Dismissable announcement bar */\n  | \"content.code.annotate\"            /* Code annotations */\n  | \"content.code.copy\"                /* Code copy button */\n  | \"content.lazy\"                     /* Lazy content elements */\n  | \"content.tabs.link\"                /* Link content tabs */\n  | \"content.tooltips\"                 /* Tooltips */\n  | \"header.autohide\"                  /* Hide header */\n  | \"navigation.expand\"                /* Automatic expansion */\n  | \"navigation.indexes\"               /* Section pages */\n  | \"navigation.instant\"               /* Instant navigation */\n  | \"navigation.instant.progress\"      /* Instant navigation progress */\n  | \"navigation.sections\"              /* Section navigation */\n  | \"navigation.tabs\"                  /* Tabs navigation */\n  | \"navigation.tabs.sticky\"           /* Tabs navigation (sticky) */\n  | \"navigation.top\"                   /* Back-to-top button */\n  | \"navigation.tracking\"              /* Anchor tracking */\n  | \"search.highlight\"                 /* Search highlighting */\n  | \"search.share\"                     /* Search sharing */\n  | \"search.suggest\"                   /* Search suggestions */\n  | \"toc.follow\"                       /* Following table of contents */\n  | \"toc.integrate\"                    /* Integrated table of contents */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Translation\n */\nexport type Translation =\n  | \"clipboard.copy\"                   /* Copy to clipboard */\n  | \"clipboard.copied\"                 /* Copied to clipboard */\n  | \"search.result.placeholder\"        /* Type to start searching */\n  | \"search.result.none\"               /* No matching documents */\n  | \"search.result.one\"                /* 1 matching document */\n  | \"search.result.other\"              /* # matching documents */\n  | \"search.result.more.one\"           /* 1 more on this page */\n  | \"search.result.more.other\"         /* # more on this page */\n  | \"search.result.term.missing\"       /* Missing */\n  | \"select.version\"                   /* Version selector */\n\n/**\n * Translations\n */\nexport type Translations =\n  Record<Translation, string>\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Versioning\n */\nexport interface Versioning {\n  provider: \"mike\"                     /* Version provider */\n  default?: string | string[]          /* Default version */\n  alias?: boolean                      /* Show alias */\n}\n\n/**\n * Configuration\n */\nexport interface Config {\n  base: string                         /* Base URL */\n  features: Flag[]                     /* Feature flags */\n  translations: Translations           /* Translations */\n  search: string                       /* Search worker URL */\n  tags?: Record<string, string>        /* Tags mapping */\n  version?: Versioning                 /* Versioning */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration and make base URL absolute\n */\nconst script = getElement(\"#__config\")\nconst config: Config = JSON.parse(script.textContent!)\nconfig.base = `${new URL(config.base, getLocation())}`\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration\n *\n * @returns Global configuration\n */\nexport function configuration(): Config {\n  return config\n}\n\n/**\n * Check whether a feature flag is enabled\n *\n * @param flag - Feature flag\n *\n * @returns Test result\n */\nexport function feature(flag: Flag): boolean {\n  return config.features.includes(flag)\n}\n\n/**\n * Retrieve the translation for the given key\n *\n * @param key - Key to be translated\n * @param value - Positional value, if any\n *\n * @returns Translation\n */\nexport function translation(\n  key: Translation, value?: string | number\n): string {\n  return typeof value !== \"undefined\"\n    ? config.translations[key].replace(\"#\", value.toString())\n    : config.translations[key]\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type\n */\nexport type ComponentType =\n  | \"announce\"                         /* Announcement bar */\n  | \"container\"                        /* Container */\n  | \"consent\"                          /* Consent */\n  | \"content\"                          /* Content */\n  | \"dialog\"                           /* Dialog */\n  | \"header\"                           /* Header */\n  | \"header-title\"                     /* Header title */\n  | \"header-topic\"                     /* Header topic */\n  | \"main\"                             /* Main area */\n  | \"outdated\"                         /* Version warning */\n  | \"palette\"                          /* Color palette */\n  | \"progress\"                         /* Progress indicator */\n  | \"search\"                           /* Search */\n  | \"search-query\"                     /* Search input */\n  | \"search-result\"                    /* Search results */\n  | \"search-share\"                     /* Search sharing */\n  | \"search-suggest\"                   /* Search suggestions */\n  | \"sidebar\"                          /* Sidebar */\n  | \"skip\"                             /* Skip link */\n  | \"source\"                           /* Repository information */\n  | \"tabs\"                             /* Navigation tabs */\n  | \"toc\"                              /* Table of contents */\n  | \"top\"                              /* Back-to-top button */\n\n/**\n * Component\n *\n * @template T - Component type\n * @template U - Reference type\n */\nexport type Component<\n  T extends {} = {},\n  U extends HTMLElement = HTMLElement\n> =\n  T & {\n    ref: U                             /* Component reference */\n  }\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type map\n */\ninterface ComponentTypeMap {\n  \"announce\": HTMLElement              /* Announcement bar */\n  \"container\": HTMLElement             /* Container */\n  \"consent\": HTMLElement               /* Consent */\n  \"content\": HTMLElement               /* Content */\n  \"dialog\": HTMLElement                /* Dialog */\n  \"header\": HTMLElement                /* Header */\n  \"header-title\": HTMLElement          /* Header title */\n  \"header-topic\": HTMLElement          /* Header topic */\n  \"main\": HTMLElement                  /* Main area */\n  \"outdated\": HTMLElement              /* Version warning */\n  \"palette\": HTMLElement               /* Color palette */\n  \"progress\": HTMLElement              /* Progress indicator */\n  \"search\": HTMLElement                /* Search */\n  \"search-query\": HTMLInputElement     /* Search input */\n  \"search-result\": HTMLElement         /* Search results */\n  \"search-share\": HTMLAnchorElement    /* Search sharing */\n  \"search-suggest\": HTMLElement        /* Search suggestions */\n  \"sidebar\": HTMLElement               /* Sidebar */\n  \"skip\": HTMLAnchorElement            /* Skip link */\n  \"source\": HTMLAnchorElement          /* Repository information */\n  \"tabs\": HTMLElement                  /* Navigation tabs */\n  \"toc\": HTMLElement                   /* Table of contents */\n  \"top\": HTMLAnchorElement             /* Back-to-top button */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the element for a given component or throw a reference error\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getComponentElement<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T] {\n  return getElement(`[data-md-component=${type}]`, node)\n}\n\n/**\n * Retrieve all elements for a given component\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getComponentElements<T extends ComponentType>(\n  type: T, node: ParentNode = document\n): ComponentTypeMap[T][] {\n  return getElements(`[data-md-component=${type}]`, node)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  fromEvent,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Announcement bar\n */\nexport interface Announce {\n  hash: number                        /* Content hash */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar observable\n */\nexport function watchAnnounce(\n  el: HTMLElement\n): Observable<Announce> {\n  const button = getElement(\".md-typeset > :first-child\", el)\n  return fromEvent(button, \"click\", { once: true })\n    .pipe(\n      map(() => getElement(\".md-typeset\", el)),\n      map(content => ({ hash: __md_hash(content.innerHTML) }))\n    )\n}\n\n/**\n * Mount announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar component observable\n */\nexport function mountAnnounce(\n  el: HTMLElement\n): Observable<Component<Announce>> {\n  if (!feature(\"announce.dismiss\") || !el.childElementCount)\n    return EMPTY\n\n  /* Support instant navigation - see https://t.ly/3FTme */\n  if (!el.hidden) {\n    const content = getElement(\".md-typeset\", el)\n    if (__md_hash(content.innerHTML) === __md_get(\"__announce\"))\n      el.hidden = true\n  }\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Announce>()\n    push$.subscribe(({ hash }) => {\n      el.hidden = true\n\n      /* Persist preference in local storage */\n      __md_set<number>(\"__announce\", hash)\n    })\n\n    /* Create and return component */\n    return watchAnnounce(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Consent\n */\nexport interface Consent {\n  hidden: boolean                      /* Consent is hidden */\n}\n\n/**\n * Consent defaults\n */\nexport interface ConsentDefaults {\n  analytics?: boolean                  /* Consent for Analytics */\n  github?: boolean                     /* Consent for GitHub */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent observable\n */\nexport function watchConsent(\n  el: HTMLElement, { target$ }: WatchOptions\n): Observable<Consent> {\n  return target$\n    .pipe(\n      map(target => ({ hidden: target !== el }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent component observable\n */\nexport function mountConsent(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Consent>> {\n  const internal$ = new Subject<Consent>()\n  internal$.subscribe(({ hidden }) => {\n    el.hidden = hidden\n  })\n\n  /* Create and return component */\n  return watchConsent(el, options)\n    .pipe(\n      tap(state => internal$.next(state)),\n      finalize(() => internal$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ComponentChild } from \"preact\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip style\n */\nexport type TooltipStyle =\n  | \"inline\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a tooltip\n *\n * @param id - Tooltip identifier\n * @param style - Tooltip style\n *\n * @returns Element\n */\nexport function renderTooltip(\n  id?: string, style?: TooltipStyle\n): HTMLElement {\n  if (style === \"inline\") { // @todo refactor control flow\n    return (\n      <div class=\"md-tooltip md-tooltip--inline\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  } else {\n    return (\n      <div class=\"md-tooltip\" id={id} role=\"tooltip\">\n        <div class=\"md-tooltip__inner md-typeset\"></div>\n      </div>\n    )\n  }\n}\n\n// @todo: rename\nexport function renderInlineTooltip2(\n  ...children: ComponentChild[]\n): HTMLElement {\n  return (\n    <div class=\"md-tooltip2\" role=\"tooltip\">\n      <div class=\"md-tooltip2__inner md-typeset\">\n        {children}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\nimport { renderTooltip } from \"../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render an annotation\n *\n * @param id - Annotation identifier\n * @param prefix - Tooltip identifier prefix\n *\n * @returns Element\n */\nexport function renderAnnotation(\n  id: string | number, prefix?: string\n): HTMLElement {\n  prefix = prefix ? `${prefix}_annotation_${id}` : undefined\n\n  /* Render tooltip with anchor, if given */\n  if (prefix) {\n    const anchor = prefix ? `#${prefix}` : undefined\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <a href={anchor} class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </a>\n      </aside>\n    )\n  } else {\n    return (\n      <aside class=\"md-annotation\" tabIndex={0}>\n        {renderTooltip(prefix)}\n        <span class=\"md-annotation__index\" tabIndex={-1}>\n          <span data-md-annotation-id={id}></span>\n        </span>\n      </aside>\n    )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a 'copy-to-clipboard' button\n *\n * @param id - Unique identifier\n *\n * @returns Element\n */\nexport function renderClipboardButton(id: string): HTMLElement {\n  return (\n    <button\n      class=\"md-clipboard md-icon\"\n      title={translation(\"clipboard.copy\")}\n      data-clipboard-target={`#${id} > code`}\n    ></button>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\nimport { ComponentChild } from \"preact\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport { SearchItem } from \"~/integrations/search\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Render flag\n */\nconst enum Flag {\n  TEASER = 1,                          /* Render teaser */\n  PARENT = 2                           /* Render as parent */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper function\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search document\n *\n * @param document - Search document\n * @param flag - Render flags\n *\n * @returns Element\n */\nfunction renderSearchDocument(\n  document: SearchItem, flag: Flag\n): HTMLElement {\n  const parent = flag & Flag.PARENT\n  const teaser = flag & Flag.TEASER\n\n  /* Render missing query terms */\n  const missing = Object.keys(document.terms)\n    .filter(key => !document.terms[key])\n    .reduce<ComponentChild[]>((list, key) => [\n      ...list, <del>{escapeHTML(key)}</del>, \" \"\n    ], [])\n    .slice(0, -1)\n\n  /* Assemble query string for highlighting */\n  const config = configuration()\n  const url = new URL(document.location, config.base)\n  if (feature(\"search.highlight\"))\n    url.searchParams.set(\"h\", Object.entries(document.terms)\n      .filter(([, match]) => match)\n      .reduce((highlight, [value]) => `${highlight} ${value}`.trim(), \"\")\n    )\n\n  /* Render article or section, depending on flags */\n  const { tags } = configuration()\n  return (\n    <a href={`${url}`} class=\"md-search-result__link\" tabIndex={-1}>\n      <article\n        class=\"md-search-result__article md-typeset\"\n        data-md-score={document.score.toFixed(2)}\n      >\n        {parent > 0 && <div class=\"md-search-result__icon md-icon\"></div>}\n        {parent > 0 && <h1>{document.title}</h1>}\n        {parent <= 0 && <h2>{document.title}</h2>}\n        {teaser > 0 && document.text.length > 0 &&\n          document.text\n        }\n        {document.tags && (\n          <nav class=\"md-tags\">\n            {document.tags.map(tag => {\n              const type = tags\n                ? tag in tags\n                  ? `md-tag-icon md-tag--${tags[tag]}`\n                  : \"md-tag-icon\"\n                : \"\"\n              return (\n                <span class={`md-tag ${type}`}>{tag}</span>\n              )\n            })}\n          </nav>\n        )}\n        {teaser > 0 && missing.length > 0 &&\n          <p class=\"md-search-result__terms\">\n            {translation(\"search.result.term.missing\")}: {...missing}\n          </p>\n        }\n      </article>\n    </a>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search result\n *\n * @param result - Search result\n *\n * @returns Element\n */\nexport function renderSearchResultItem(\n  result: SearchItem[]\n): HTMLElement {\n  const threshold = result[0].score\n  const docs = [...result]\n\n  const config = configuration()\n\n  /* Find and extract parent article */\n  const parent = docs.findIndex(doc => {\n    const l = `${new URL(doc.location, config.base)}` // @todo hacky\n    return !l.includes(\"#\")\n  })\n  const [article] = docs.splice(parent, 1)\n\n  /* Determine last index above threshold */\n  let index = docs.findIndex(doc => doc.score < threshold)\n  if (index === -1)\n    index = docs.length\n\n  /* Partition sections */\n  const best = docs.slice(0, index)\n  const more = docs.slice(index)\n\n  /* Render children */\n  const children = [\n    renderSearchDocument(article, Flag.PARENT | +(!parent && index === 0)),\n    ...best.map(section => renderSearchDocument(section, Flag.TEASER)),\n    ...more.length ? [\n      <details class=\"md-search-result__more\">\n        <summary tabIndex={-1}>\n          <div>\n            {more.length > 0 && more.length === 1\n              ? translation(\"search.result.more.one\")\n              : translation(\"search.result.more.other\", more.length)\n            }\n          </div>\n        </summary>\n        {...more.map(section => renderSearchDocument(section, Flag.TEASER))}\n      </details>\n    ] : []\n  ]\n\n  /* Render search result */\n  return (\n    <li class=\"md-search-result__item\">\n      {children}\n    </li>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SourceFacts } from \"~/components\"\nimport { h, round } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render repository facts\n *\n * @param facts - Repository facts\n *\n * @returns Element\n */\nexport function renderSourceFacts(facts: SourceFacts): HTMLElement {\n  return (\n    <ul class=\"md-source__facts\">\n      {Object.entries(facts).map(([key, value]) => (\n        <li class={`md-source__fact md-source__fact--${key}`}>\n          {typeof value === \"number\" ? round(value) : value}\n        </li>\n      ))}\n    </ul>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tabbed control type\n */\ntype TabbedControlType =\n  | \"prev\"\n  | \"next\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render control for content tabs\n *\n * @param type - Control type\n *\n * @returns Element\n */\nexport function renderTabbedControl(\n  type: TabbedControlType\n): HTMLElement {\n  const classes = `tabbed-control tabbed-control--${type}`\n  return (\n    <div class={classes} hidden>\n      <button class=\"tabbed-button\" tabIndex={-1} aria-hidden=\"true\"></button>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a table inside a wrapper to improve scrolling on mobile\n *\n * @param table - Table element\n *\n * @returns Element\n */\nexport function renderTable(table: HTMLElement): HTMLElement {\n  return (\n    <div class=\"md-typeset__scrollwrap\">\n      <div class=\"md-typeset__table\">\n        {table}\n      </div>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { configuration, translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Version properties\n */\nexport interface VersionProperties {\n  hidden?: boolean                     /* Version is hidden */\n}\n\n/**\n * Version\n */\nexport interface Version {\n  version: string                      /* Version identifier */\n  title: string                        /* Version title */\n  aliases: string[]                    /* Version aliases */\n  properties?: VersionProperties       /* Version properties */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version\n *\n * @param version - Version\n *\n * @returns Element\n */\nfunction renderVersion(version: Version): HTMLElement {\n  const config = configuration()\n\n  /* Ensure trailing slash - see https://bit.ly/3rL5u3f */\n  const url = new URL(`../${version.version}/`, config.base)\n  return (\n    <li class=\"md-version__item\">\n      <a href={`${url}`} class=\"md-version__link\">\n        {version.title}\n        {config.version?.alias && version.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {version.aliases[0]}\n          </span>\n        )}\n      </a>\n    </li>\n  )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version selector\n *\n * @param versions - Versions\n * @param active - Active version\n *\n * @returns Element\n */\nexport function renderVersionSelector(\n  versions: Version[], active: Version\n): HTMLElement {\n  const config = configuration()\n  versions = versions.filter(version => !version.properties?.hidden)\n  return (\n    <div class=\"md-version\">\n      <button\n        class=\"md-version__current\"\n        aria-label={translation(\"select.version\")}\n      >\n        {active.title}\n        {config.version?.alias && active.aliases.length > 0 && (\n          <span class=\"md-version__alias\">\n            {active.aliases[0]}\n          </span>\n        )}\n      </button>\n      <ul class=\"md-version__list\">\n        {versions.map(renderVersion)}\n      </ul>\n    </div>\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  BehaviorSubject,\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  combineLatest,\n  combineLatestWith,\n  debounce,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  filter,\n  finalize,\n  first,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  queueScheduler,\n  share,\n  startWith,\n  switchMap,\n  tap,\n  throttleTime,\n  timer,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  Viewport,\n  getElement,\n  getElementContainers,\n  getElementOffsetAbsolute,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderInlineTooltip2 } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      // Tooltip is active\n  offset: ElementOffset                // Tooltip offset\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dependencies\n */\ninterface Dependencies {\n  content$: Observable<HTMLElement>    // Tooltip content observable\n  viewport$: Observable<Viewport>      // Viewport observable\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function tracks the tooltip host element, and deduces the active state\n * and offset of the tooltip from it. The active state is determined by whether\n * the host element is focused or hovered, and the offset is determined by the\n * host element's absolute position in the document.\n *\n * @param el - Tooltip host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip2(\n  el: HTMLElement\n): Observable<Tooltip> {\n\n  // Compute whether tooltip should be shown - we need to watch both focus and\n  // hover events on the host element and emit if one of them is active. In case\n  // of a hover event, we keep the element visible for a short amount of time\n  // after the pointer left the host element for a better user experience.\n  const active$ =\n    combineLatest([\n      watchElementFocus(el),\n      watchElementHover(el)\n    ])\n      .pipe(\n        map(([focus, hover]) => focus || hover),\n        distinctUntilChanged()\n      )\n\n  // We need to determine all parent elements of the host element that are\n  // currently scrollable, as they might affect the position of the tooltip\n  // depending on their horizontal of vertical offset. We must track all of\n  // them and recompute the position of the tooltip if they change.\n  const offset$ =\n    defer(() => getElementContainers(el)).pipe(\n      mergeMap(watchElementContentOffset),\n      throttleTime(1),\n      // Note that we need to poll the value again if the active state changes,\n      // as otherwise the tooltip might be misplaced. This particularly happens\n      // when using third-party integrations like tablesort that change the\n      // position of elements \u2013 see https://t.ly/Y-V7X\n      combineLatestWith(active$),\n      map(() => getElementOffsetAbsolute(el)),\n    )\n\n  // Only track parent elements and compute offset of the tooltip host if the\n  // tooltip should be shown - we defer the computation of the offset until the\n  // tooltip becomes active for the first time. This is necessary, because we\n  // must also keep the tooltip active as long as it is focused or hovered.\n  return active$.pipe(\n    first(active => active),\n    switchMap(() => combineLatest([active$, offset$])),\n    map(([active, offset]) => ({ active, offset })),\n    share()\n  )\n}\n\n/**\n * Mount tooltip\n *\n * This function renders a tooltip with the content from the provided `content$`\n * observable as passed via the dependencies. If the returned element has a role\n * of type `dialog`, the tooltip is considered to be interactive, and rendered\n * either above or below the host element, depending on the available space.\n *\n * If the returned element has a role of type `tooltip`, the tooltip is always\n * rendered below the host element and considered to be non-interactive. This\n * allows us to reuse the same positioning logic for both interactive and\n * non-interactive tooltips, as it is largely the same.\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip2(\n  el: HTMLElement, dependencies: Dependencies\n): Observable<Component<Tooltip>> {\n  const { content$, viewport$ } = dependencies\n\n  // Compute unique tooltip id - this is necessary to associate the tooltip host\n  // element with the tooltip element for ARIA purposes\n  const id = `__tooltip2_${sequence++}`\n\n  // Create component on subscription\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n\n    // Create subject to track tooltip presence and visibility - we use another\n    // purely internal subject to track the tooltip's presence and visibility,\n    // as the tooltip should be visible if the host element or tooltip itself\n    // is focused or hovered to allow for smooth pointer migration\n    const show$ = new BehaviorSubject(false)\n    push$.pipe(ignoreElements(), endWith(false))\n      .subscribe(show$)\n\n    // Create observable controlling tooltip element - we create and attach the\n    // tooltip only if it is actually present, in order to keep the number of\n    // elements low. We need to keep the tooltip visible for a short time after\n    // the pointer left the host element or tooltip itself. For this, we use an\n    // inner subscription to the tooltip observable, which we terminate when the\n    // tooltip should not be shown, automatically removing the element. Moreover\n    // we use the queue scheduler, which will schedule synchronously in case the\n    // tooltip should be shown, and asynchronously if it should be hidden.\n    const node$ = show$.pipe(\n      debounce(active => timer(+!active * 250, queueScheduler)),\n      distinctUntilChanged(),\n      switchMap(active => active ? content$ : EMPTY),\n      tap(node => node.id = id),\n      share()\n    )\n\n    // Compute tooltip presence and visibility - the tooltip should be shown if\n    // the host element or the tooltip itself is focused or hovered\n    combineLatest([\n      push$.pipe(map(({ active }) => active)),\n      node$.pipe(\n        switchMap(node => watchElementHover(node, 250)),\n        startWith(false)\n      )\n    ])\n      .pipe(map(states => states.some(active => active)))\n      .subscribe(show$)\n\n    // Compute tooltip origin - we need to compute the tooltip origin depending\n    // on the position of the host element, the viewport size, as well as the\n    // actual size of the tooltip, if positioned above. The tooltip must about\n    // to be rendered for this to be correct, which is why we do it here.\n    const origin$ = show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, viewport$),\n      map(([_, node, { size }]) => {\n        const host = el.getBoundingClientRect()\n        const x = host.width / 2\n\n        // If the tooltip is non-interactive, we always render it below the\n        // actual element because all operating systems do it that way\n        if (node.role === \"tooltip\") {\n          return { x, y: 8 + host.height }\n\n        // Otherwise, we determine where there is more space, and render the\n        // tooltip either above or below the host element\n        } else if (host.y >= size.height / 2) {\n          const { height } = getElementSize(node)\n          return { x, y: -16 - height }\n        } else {\n          return { x, y: +16 + host.height }\n        }\n      })\n    )\n\n    // Update tooltip position - we always need to update the position of the\n    // tooltip, as it might change depending on the viewport offset of the host\n    combineLatest([node$, push$, origin$])\n      .subscribe(([node, { offset }, origin]) => {\n        node.style.setProperty(\"--md-tooltip-host-x\", `${offset.x}px`)\n        node.style.setProperty(\"--md-tooltip-host-y\", `${offset.y}px`)\n\n        // Update tooltip origin - this is mainly set to determine the position\n        // of the tooltip tail, to show the direction it is originating from\n        node.style.setProperty(\"--md-tooltip-x\", `${origin.x}px`)\n        node.style.setProperty(\"--md-tooltip-y\", `${origin.y}px`)\n\n        // Update tooltip render location, i.e., whether the tooltip is shown\n        // above or below the host element, depending on the available space\n        node.classList.toggle(\"md-tooltip2--top\",    origin.y <  0)\n        node.classList.toggle(\"md-tooltip2--bottom\", origin.y >= 0)\n      })\n\n    // Update tooltip width - we only explicitly set the width of the tooltip\n    // if it is non-interactive, in case it should always be rendered centered\n    show$.pipe(\n      filter(active => active),\n      withLatestFrom(node$, (_, node) => node),\n      filter(node => node.role === \"tooltip\")\n    )\n      .subscribe(node => {\n        const size = getElementSize(getElement(\":scope > *\", node))\n\n        // Set tooltip width and remove tail by setting it to a width of zero -\n        // if authors want to keep the tail, we can move this to CSS later\n        node.style.setProperty(\"--md-tooltip-width\", `${size.width}px`)\n        node.style.setProperty(\"--md-tooltip-tail\",  `${0}px`)\n      })\n\n    // Update tooltip visibility - we defer to the next animation frame, because\n    // the tooltip must first be added to the document before we make it appear,\n    // or it will appear instantly without delay. Additionally, we need to keep\n    // the tooltip visible for a short time after the pointer left the host.\n    show$.pipe(\n      distinctUntilChanged(),\n      observeOn(animationFrameScheduler),\n      withLatestFrom(node$)\n    )\n      .subscribe(([active, node]) => {\n        node.classList.toggle(\"md-tooltip2--active\", active)\n      })\n\n    // Set up ARIA attributes when tooltip is visible\n    combineLatest([\n      show$.pipe(filter(active => active)),\n      node$\n    ])\n      .subscribe(([_, node]) => {\n        if (node.role === \"dialog\") {\n          el.setAttribute(\"aria-controls\", id)\n          el.setAttribute(\"aria-haspopup\", \"dialog\")\n        } else {\n          el.setAttribute(\"aria-describedby\", id)\n        }\n      })\n\n    // Remove ARIA attributes when tooltip is hidden\n    show$.pipe(filter(active => !active))\n      .subscribe(() => {\n        el.removeAttribute(\"aria-controls\")\n        el.removeAttribute(\"aria-describedby\")\n        el.removeAttribute(\"aria-haspopup\")\n      })\n\n    // Create and return component\n    return watchTooltip2(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n\n// ----------------------------------------------------------------------------\n\n/**\n * Mount inline tooltip\n *\n * @todo refactor this function\n *\n * @param el - Tooltip host element\n * @param dependencies - Dependencies\n * @param container - Container\n *\n * @returns Tooltip component observable\n */\nexport function mountInlineTooltip2(\n  el: HTMLElement, { viewport$ }: { viewport$: Observable<Viewport> },\n  container = document.body\n): Observable<Component<Tooltip>> {\n  return mountTooltip2(el, {\n    content$: new Observable<HTMLElement>(observer => {\n      const title = el.title\n      const node = renderInlineTooltip2(title)\n      observer.next(node)\n      el.removeAttribute(\"title\")\n      // Append tooltip and remove on unsubscription\n      container.append(node)\n      return () => {\n        node.remove()\n        el.setAttribute(\"title\", title)\n      }\n    }),\n    viewport$\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  delay,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  switchMap,\n  take,\n  takeUntil,\n  tap,\n  throttleTime,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getActiveElement,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementOffset,\n  watchElementVisibility\n} from \"~/browser\"\n\nimport { Component } from \"../../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Annotation\n */\nexport interface Annotation {\n  active: boolean                      /* Annotation is active */\n  offset: ElementOffset                /* Annotation offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation observable\n */\nexport function watchAnnotation(\n  el: HTMLElement, container: HTMLElement\n): Observable<Annotation> {\n  const offset$ = defer(() => combineLatest([\n    watchElementOffset(el),\n    watchElementContentOffset(container)\n  ]))\n    .pipe(\n      map(([{ x, y }, scroll]): ElementOffset => {\n        const { width, height } = getElementSize(el)\n        return ({\n          x: x - scroll.x + width  / 2,\n          y: y - scroll.y + height / 2\n        })\n      })\n    )\n\n  /* Actively watch annotation on focus */\n  return watchElementFocus(el)\n    .pipe(\n      switchMap(active => offset$\n        .pipe(\n          map(offset => ({ active, offset })),\n          take(+!active || Infinity)\n        )\n      )\n    )\n}\n\n/**\n * Mount annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotation(\n  el: HTMLElement, container: HTMLElement, { target$ }: MountOptions\n): Observable<Component<Annotation>> {\n  const [tooltip, index] = Array.from(el.children)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Annotation>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        el.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        el.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.style.removeProperty(\"--md-tooltip-x\")\n        el.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Start animation only when annotation is visible */\n    watchElementVisibility(el)\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(visible => {\n          el.toggleAttribute(\"data-md-visible\", visible)\n        })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active)\n            el.prepend(tooltip)\n          else\n            tooltip.remove()\n        },\n\n        /* Handle complete */\n        complete() {\n          el.prepend(tooltip)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next(origin) {\n            if (origin)\n              el.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n            else\n              el.style.removeProperty(\"--md-tooltip-0\")\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-tooltip-0\")\n          }\n        })\n\n    /* Allow to copy link without scrolling to anchor */\n    fromEvent<MouseEvent>(index, \"click\")\n      .pipe(\n        takeUntil(done$),\n        filter(ev => !(ev.metaKey || ev.ctrlKey))\n      )\n        .subscribe(ev => {\n          ev.stopPropagation()\n          ev.preventDefault()\n        })\n\n    /* Allow to open link in new tab or blur on close */\n    fromEvent<MouseEvent>(index, \"mousedown\")\n      .pipe(\n        takeUntil(done$),\n        withLatestFrom(push$)\n      )\n        .subscribe(([ev, { active }]) => {\n\n          /* Open in new tab */\n          if (ev.button !== 0 || ev.metaKey || ev.ctrlKey) {\n            ev.preventDefault()\n\n          /* Close annotation */\n          } else if (active) {\n            ev.preventDefault()\n\n            /* Focus parent annotation, if any */\n            const parent = el.parentElement!.closest(\".md-annotation\")\n            if (parent instanceof HTMLElement)\n              parent.focus()\n            else\n              getActiveElement()?.blur()\n          }\n        })\n\n    /* Open and focus annotation on location target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(target => target === tooltip),\n        delay(125)\n      )\n        .subscribe(() => el.focus())\n\n    /* Create and return component */\n    return watchAnnotation(el, container)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  endWith,\n  finalize,\n  ignoreElements,\n  merge,\n  share,\n  takeUntil\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  getOptionalElement\n} from \"~/browser\"\nimport { renderAnnotation } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotation\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find all annotation hosts in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation hosts\n */\nfunction findHosts(container: HTMLElement): HTMLElement[] {\n  return container.tagName === \"CODE\"\n    ? getElements(\".c, .c1, .cm\", container)\n    : [container]\n}\n\n/**\n * Find all annotation markers in the containing element\n *\n * @param container - Containing element\n *\n * @returns Annotation markers\n */\nfunction findMarkers(container: HTMLElement): Text[] {\n  const markers: Text[] = []\n  for (const el of findHosts(container)) {\n    const nodes: Text[] = []\n\n    /* Find all text nodes in current element */\n    const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n    for (let node = it.nextNode(); node; node = it.nextNode())\n      nodes.push(node as Text)\n\n    /* Find all markers in each text node */\n    for (let text of nodes) {\n      let match: RegExpExecArray | null\n\n      /* Split text at marker and add to list */\n      while ((match = /(\\(\\d+\\))(!)?/.exec(text.textContent!))) {\n        const [, id, force] = match\n        if (typeof force === \"undefined\") {\n          const marker = text.splitText(match.index)\n          text = marker.splitText(id.length)\n          markers.push(marker)\n\n        /* Replace entire text with marker */\n        } else {\n          text.textContent = id\n          markers.push(text)\n          break\n        }\n      }\n    }\n  }\n  return markers\n}\n\n/**\n * Swap the child nodes of two elements\n *\n * @param source - Source element\n * @param target - Target element\n */\nfunction swap(source: HTMLElement, target: HTMLElement): void {\n  target.append(...Array.from(source.childNodes))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation list\n *\n * This function analyzes the containing code block and checks for markers\n * referring to elements in the given annotation list. If no markers are found,\n * the list is left untouched. Otherwise, list elements are rendered as\n * annotations inside the code block.\n *\n * @param el - Annotation list element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationList(\n  el: HTMLElement, container: HTMLElement, { target$, print$ }: MountOptions\n): Observable<Component<Annotation>> {\n\n  /* Compute prefix for tooltip anchors */\n  const parent = container.closest(\"[id]\")\n  const prefix = parent?.id\n\n  /* Find and replace all markers with empty annotations */\n  const annotations = new Map<string, HTMLElement>()\n  for (const marker of findMarkers(container)) {\n    const [, id] = marker.textContent!.match(/\\((\\d+)\\)/)!\n    if (getOptionalElement(`:scope > li:nth-child(${id})`, el)) {\n      annotations.set(id, renderAnnotation(id, prefix))\n      marker.replaceWith(annotations.get(id)!)\n    }\n  }\n\n  /* Keep list if there are no annotations to render */\n  if (annotations.size === 0)\n    return EMPTY\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n    /* Retrieve container pairs for swapping */\n    const pairs: [HTMLElement, HTMLElement][] = []\n    for (const [id, annotation] of annotations)\n      pairs.push([\n        getElement(\".md-typeset\", annotation),\n        getElement(`:scope > li:nth-child(${id})`, el)\n      ])\n\n    /* Handle print mode - see https://bit.ly/3rgPdpt */\n    print$.pipe(takeUntil(done$))\n      .subscribe(active => {\n        el.hidden = !active\n\n        /* Add class to discern list element */\n        el.classList.toggle(\"md-annotation-list\", active)\n\n        /* Show annotations in code block or list (print) */\n        for (const [inner, child] of pairs)\n          if (!active)\n            swap(child, inner)\n          else\n            swap(inner, child)\n      })\n\n    /* Create and return component */\n    return merge(...[...annotations]\n      .map(([, annotation]) => (\n        mountAnnotation(annotation, container, { target$ })\n      ))\n    )\n      .pipe(\n        finalize(() => push$.complete()),\n        share()\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable, defer } from \"rxjs\"\n\nimport { Component } from \"../../../_\"\nimport { Annotation } from \"../_\"\nimport { mountAnnotationList } from \"../list\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find list element directly following a block\n *\n * @param el - Annotation block element\n *\n * @returns List element or nothing\n */\nfunction findList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation block\n *\n * @param el - Annotation block element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Annotation>> {\n  return defer(() => {\n    const list = findList(el)\n    return typeof list !== \"undefined\"\n      ? mountAnnotationList(list, el, options)\n      : EMPTY\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  filter,\n  finalize,\n  map,\n  mergeWith,\n  switchMap,\n  take,\n  takeLast,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  getElementContentSize,\n  getElements,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"~/components/tooltip2\"\nimport { renderClipboardButton } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n  Annotation,\n  mountAnnotationList\n} from \"../../annotation\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Code block overflow\n */\nexport interface Overflow {\n  scrollable: boolean                  /* Code block overflows */\n}\n\n/**\n * Code block\n */\nexport type CodeBlock =\n  | Overflow\n  | Annotation\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for code blocks\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find candidate list element directly following a code block\n *\n * @param el - Code block element\n *\n * @returns List element or nothing\n */\nfunction findCandidateList(el: HTMLElement): HTMLElement | undefined {\n  if (el.nextElementSibling) {\n    const sibling = el.nextElementSibling as HTMLElement\n    if (sibling.tagName === \"OL\")\n      return sibling\n\n    /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n    else if (sibling.tagName === \"P\" && !sibling.children.length)\n      return findCandidateList(sibling)\n  }\n\n  /* Everything else */\n  return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch code block\n *\n * This function monitors size changes of the viewport, as well as switches of\n * content tabs with embedded code blocks, as both may trigger overflow.\n *\n * @param el - Code block element\n *\n * @returns Code block observable\n */\nexport function watchCodeBlock(\n  el: HTMLElement\n): Observable<Overflow> {\n  return watchElementSize(el)\n    .pipe(\n      map(({ width }) => {\n        const content = getElementContentSize(el)\n        return {\n          scrollable: content.width > width\n        }\n      }),\n      distinctUntilKeyChanged(\"scrollable\")\n    )\n}\n\n/**\n * Mount code block\n *\n * This function ensures that an overflowing code block is focusable through\n * keyboard, so it can be scrolled without a mouse to improve on accessibility.\n * Furthermore, if code annotations are enabled, they are mounted if and only\n * if the code block is currently visible, e.g., not in a hidden content tab.\n *\n * Note that code blocks may be mounted eagerly or lazily. If they're mounted\n * lazily (on first visibility), code annotation anchor links will not work,\n * as they are evaluated on initial page load, and code annotations in general\n * might feel a little bumpier.\n *\n * @param el - Code block element\n * @param options - Options\n *\n * @returns Code block and annotation component observable\n */\nexport function mountCodeBlock(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<CodeBlock>> {\n  const { matches: hover } = matchMedia(\"(hover)\")\n\n  /* Defer mounting of code block - see https://bit.ly/3vHVoVD */\n  const factory$ = defer(() => {\n    const push$ = new Subject<Overflow>()\n    const done$ = push$.pipe(takeLast(1))\n    push$.subscribe(({ scrollable }) => {\n      if (scrollable && hover)\n        el.setAttribute(\"tabindex\", \"0\")\n      else\n        el.removeAttribute(\"tabindex\")\n    })\n\n    /* Render button for Clipboard.js integration */\n    const content$: Array<Observable<Component<CodeBlock>>> = []\n    if (ClipboardJS.isSupported()) {\n      if (el.closest(\".copy\") || (\n        feature(\"content.code.copy\") && !el.closest(\".no-copy\")\n      )) {\n        const parent = el.closest(\"pre\")!\n        parent.id = `__code_${sequence++}`\n\n        /* Mount tooltip, if enabled */\n        const button = renderClipboardButton(parent.id)\n        parent.insertBefore(button, el)\n        if (feature(\"content.tooltips\"))\n          content$.push(mountInlineTooltip2(button, { viewport$ }))\n      }\n    }\n\n    /* Handle code annotations */\n    const container = el.closest(\".highlight\")\n    if (container instanceof HTMLElement) {\n      const list = findCandidateList(container)\n\n      /* Mount code annotations, if enabled */\n      if (typeof list !== \"undefined\" && (\n        container.classList.contains(\"annotate\") ||\n        feature(\"content.code.annotate\")\n      )) {\n        const annotations$ = mountAnnotationList(list, el, options)\n        content$.push(\n          watchElementSize(container)\n            .pipe(\n              takeUntil(done$),\n              map(({ width, height }) => width && height),\n              distinctUntilChanged(),\n              switchMap(active => active ? annotations$ : EMPTY)\n            )\n        )\n      }\n    }\n\n    // If the code block has line spans, we can add this additional class to\n    // the code block element, which fixes the problem for highlighted code\n    // lines not stretching to the entirety of the screen when the code block\n    // overflows, e.g., on mobile - see\n    const spans = getElements(\":scope > span[id]\", el)\n    if (spans.length)\n      el.classList.add(\"md-code__content\")\n\n    /* Create and return component */\n    return watchCodeBlock(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(...content$)\n      )\n  })\n\n  /* Mount code block lazily */\n  if (feature(\"content.lazy\"))\n    return watchElementVisibility(el)\n      .pipe(\n        filter(visible => visible),\n        take(1),\n        switchMap(() => factory$)\n      )\n\n  /* Mount code block */\n  return factory$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  filter,\n  finalize,\n  map,\n  merge,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Details\n */\nexport interface Details {\n  action: \"open\" | \"close\"             /* Details state */\n  reveal?: boolean                     /* Details is revealed */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch details\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details observable\n */\nexport function watchDetails(\n  el: HTMLDetailsElement, { target$, print$ }: WatchOptions\n): Observable<Details> {\n  let open = true\n  return merge(\n\n    /* Open and focus details on location target */\n    target$\n      .pipe(\n        map(target => target.closest(\"details:not([open])\")!),\n        filter(details => el === details),\n        map(() => ({\n          action: \"open\", reveal: true\n        }) as Details)\n      ),\n\n    /* Open details on print and close afterwards */\n    print$\n      .pipe(\n        filter(active => active || !open),\n        tap(() => open = el.open),\n        map(active => ({\n          action: active ? \"open\" : \"close\"\n        }) as Details)\n      )\n  )\n}\n\n/**\n * Mount details\n *\n * This function ensures that `details` tags are opened on anchor jumps and\n * prior to printing, so the whole content of the page is visible.\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details component observable\n */\nexport function mountDetails(\n  el: HTMLDetailsElement, options: MountOptions\n): Observable<Component<Details>> {\n  return defer(() => {\n    const push$ = new Subject<Details>()\n    push$.subscribe(({ action, reveal }) => {\n      el.toggleAttribute(\"open\", action === \"open\")\n      if (reveal)\n        el.scrollIntoView()\n    })\n\n    /* Create and return component */\n    return watchDetails(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", ".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:#0000}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel p,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel p{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color);stroke-width:.05rem}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}g #flowchart-circleEnd,g #flowchart-circleStart,g #flowchart-crossEnd,g #flowchart-crossStart,g #flowchart-pointEnd,g #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel,.nodeLabel p{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}a .nodeLabel{text-decoration:underline}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.attributeBoxEven,.attributeBoxOdd{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{fill:var(--md-mermaid-sequence-actor-bg-color);stroke:var(--md-mermaid-sequence-actor-border-color)}text.actor>tspan{fill:var(--md-mermaid-sequence-actor-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-mermaid-sequence-actor-line-color)}.actor-man circle,.actor-man line{fill:var(--md-mermaid-sequence-actorman-bg-color);stroke:var(--md-mermaid-sequence-actorman-line-color)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-sequence-message-line-color)}.note{fill:var(--md-mermaid-sequence-note-bg-color);stroke:var(--md-mermaid-sequence-note-border-color)}.loopText,.loopText>tspan,.messageText,.noteText>tspan{stroke:none;font-family:var(--md-mermaid-font-family)!important}.messageText{fill:var(--md-mermaid-sequence-message-fg-color)}.loopText,.loopText>tspan{fill:var(--md-mermaid-sequence-loop-fg-color)}.noteText>tspan{fill:var(--md-mermaid-sequence-note-fg-color)}#arrowhead path{fill:var(--md-mermaid-sequence-message-line-color);stroke:none}.loopLine{fill:var(--md-mermaid-sequence-loop-bg-color);stroke:var(--md-mermaid-sequence-loop-border-color)}.labelBox{fill:var(--md-mermaid-sequence-label-bg-color);stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-sequence-label-fg-color);font-family:var(--md-mermaid-font-family)}.sequenceNumber{fill:var(--md-mermaid-sequence-number-fg-color)}rect.rect{fill:var(--md-mermaid-sequence-box-bg-color);stroke:none}rect.rect+text.text{fill:var(--md-mermaid-sequence-box-fg-color)}defs #sequencenumber{fill:var(--md-mermaid-sequence-number-bg-color)!important}", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { watchScript } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\nimport themeCSS from \"./index.css\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid diagram\n */\nexport interface Mermaid {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid instance observable\n */\nlet mermaid$: Observable<void>\n\n/**\n * Global sequence number for diagrams\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch Mermaid script\n *\n * @returns Mermaid scripts observable\n */\nfunction fetchScripts(): Observable<void> {\n  return typeof mermaid === \"undefined\" || mermaid instanceof Element\n    ? watchScript(\"https://unpkg.com/mermaid@11/dist/mermaid.min.js\")\n    : of(undefined)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount Mermaid diagram\n *\n * @param el - Code block element\n *\n * @returns Mermaid diagram component observable\n */\nexport function mountMermaid(\n  el: HTMLElement\n): Observable<Component<Mermaid>> {\n  el.classList.remove(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n  mermaid$ ||= fetchScripts()\n    .pipe(\n      tap(() => mermaid.initialize({\n        startOnLoad: false,\n        themeCSS,\n        sequence: {\n          actorFontSize: \"16px\", // Hack: mitigate https://bit.ly/3y0NEi3\n          messageFontSize: \"16px\",\n          noteFontSize: \"16px\"\n        }\n      })),\n      map(() => undefined),\n      shareReplay(1)\n    )\n\n  /* Render diagram */\n  mermaid$.subscribe(async () => {\n    el.classList.add(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n    const id = `__mermaid_${sequence++}`\n\n    /* Create host element to replace code block */\n    const host = h(\"div\", { class: \"mermaid\" })\n    const text = el.textContent\n\n    /* Render and inject diagram */\n    const { svg, fn } = await mermaid.render(id, text)\n\n    /* Create a shadow root and inject diagram */\n    const shadow = host.attachShadow({ mode: \"closed\" })\n    shadow.innerHTML = svg\n\n    /* Replace code block with diagram and bind functions */\n    el.replaceWith(host)\n    fn?.(shadow)\n  })\n\n  /* Create and return component */\n  return mermaid$\n    .pipe(\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, of } from \"rxjs\"\n\nimport { renderTable } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Data table\n */\nexport interface DataTable {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Sentinel for replacement\n */\nconst sentinel = h(\"table\")\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount data table\n *\n * This function wraps a data table in another scrollable container, so it can\n * be smoothly scrolled on smaller screen sizes and won't break the layout.\n *\n * @param el - Data table element\n *\n * @returns Data table component observable\n */\nexport function mountDataTable(\n  el: HTMLElement\n): Observable<Component<DataTable>> {\n  el.replaceWith(sentinel)\n  sentinel.replaceWith(renderTable(el))\n\n  /* Create and return component */\n  return of({ ref: el })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  endWith,\n  filter,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  skip,\n  startWith,\n  subscribeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContentOffset,\n  getElementContentSize,\n  getElementOffset,\n  getElementSize,\n  getElements,\n  watchElementContentOffset,\n  watchElementSize,\n  watchElementVisibility\n} from \"~/browser\"\nimport { renderTabbedControl } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content tabs\n */\nexport interface ContentTabs {\n  active: HTMLLabelElement             /* Active tab label */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch content tabs\n *\n * @param inputs - Content tabs input elements\n *\n * @returns Content tabs observable\n */\nexport function watchContentTabs(\n  inputs: HTMLInputElement[]\n): Observable<ContentTabs> {\n  const initial = inputs.find(input => input.checked) || inputs[0]\n  return merge(...inputs.map(input => fromEvent(input, \"change\")\n    .pipe(\n      map(() => getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`))\n    )\n  ))\n    .pipe(\n      startWith(getElement<HTMLLabelElement>(`label[for=\"${initial.id}\"]`)),\n      map(active => ({ active }))\n    )\n}\n\n/**\n * Mount content tabs\n *\n * @param el - Content tabs element\n * @param options - Options\n *\n * @returns Content tabs component observable\n */\nexport function mountContentTabs(\n  el: HTMLElement, { viewport$, target$ }: MountOptions\n): Observable<Component<ContentTabs>> {\n  const container = getElement(\".tabbed-labels\", el)\n  const inputs = getElements<HTMLInputElement>(\":scope > input\", el)\n\n  /* Render content tab previous button for pagination */\n  const prev = renderTabbedControl(\"prev\")\n  el.append(prev)\n\n  /* Render content tab next button for pagination */\n  const next = renderTabbedControl(\"next\")\n  el.append(next)\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<ContentTabs>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    combineLatest([push$, watchElementSize(el), watchElementVisibility(el)])\n      .pipe(\n        takeUntil(done$),\n        auditTime(1, animationFrameScheduler)\n      )\n        .subscribe({\n\n          /* Handle emission */\n          next([{ active }, size]) {\n            const offset = getElementOffset(active)\n            const { width } = getElementSize(active)\n\n            /* Set tab indicator offset and width */\n            el.style.setProperty(\"--md-indicator-x\", `${offset.x}px`)\n            el.style.setProperty(\"--md-indicator-width\", `${width}px`)\n\n            /* Scroll container to active content tab */\n            const content = getElementContentOffset(container)\n            if (\n              offset.x         < content.x              ||\n              offset.x + width > content.x + size.width\n            )\n              container.scrollTo({\n                left: Math.max(0, offset.x - 16),\n                behavior: \"smooth\"\n              })\n          },\n\n          /* Handle complete */\n          complete() {\n            el.style.removeProperty(\"--md-indicator-x\")\n            el.style.removeProperty(\"--md-indicator-width\")\n          }\n        })\n\n    /* Hide content tab buttons on borders */\n    combineLatest([\n      watchElementContentOffset(container),\n      watchElementSize(container)\n    ])\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(([offset, size]) => {\n          const content = getElementContentSize(container)\n          prev.hidden = offset.x < 16\n          next.hidden = offset.x > content.width - size.width - 16\n        })\n\n    /* Paginate content tab container on click */\n    merge(\n      fromEvent(prev, \"click\").pipe(map(() => -1)),\n      fromEvent(next, \"click\").pipe(map(() => +1))\n    )\n      .pipe(\n        takeUntil(done$)\n      )\n        .subscribe(direction => {\n          const { width } = getElementSize(container)\n          container.scrollBy({\n            left: width * direction,\n            behavior: \"smooth\"\n          })\n        })\n\n    /* Switch to content tab target */\n    target$\n      .pipe(\n        takeUntil(done$),\n        filter(input => inputs.includes(input as HTMLInputElement))\n      )\n        .subscribe(input => input.click())\n\n    /* Add link to each content tab label */\n    container.classList.add(\"tabbed-labels--linked\")\n    for (const input of inputs) {\n      const label = getElement<HTMLLabelElement>(`label[for=\"${input.id}\"]`)\n      label.replaceChildren(h(\"a\", {\n        href: `#${label.htmlFor}`,\n        tabIndex: -1\n      }, ...Array.from(label.childNodes)))\n\n      /* Allow to copy link without scrolling to anchor */\n      fromEvent<MouseEvent>(label.firstElementChild!, \"click\")\n        .pipe(\n          takeUntil(done$),\n          filter(ev => !(ev.metaKey || ev.ctrlKey)),\n          tap(ev => {\n            ev.preventDefault()\n            ev.stopPropagation()\n          })\n        )\n          // @todo we might need to remove the anchor link on complete\n          .subscribe(() => {\n            history.replaceState({}, \"\", `#${label.htmlFor}`)\n            label.click()\n          })\n    }\n\n    /* Set up linking of content tabs, if enabled */\n    if (feature(\"content.tabs.link\"))\n      push$.pipe(\n        skip(1),\n        withLatestFrom(viewport$)\n      )\n        .subscribe(([{ active }, { offset }]) => {\n          const tab = active.innerText.trim()\n          if (active.hasAttribute(\"data-md-switching\")) {\n            active.removeAttribute(\"data-md-switching\")\n\n          /* Determine viewport offset of active tab */\n          } else {\n            const y = el.offsetTop - offset.y\n\n            /* Passively activate other tabs */\n            for (const set of getElements(\"[data-tabs]\"))\n              for (const input of getElements<HTMLInputElement>(\n                \":scope > input\", set\n              )) {\n                const label = getElement(`label[for=\"${input.id}\"]`)\n                if (\n                  label !== active &&\n                  label.innerText.trim() === tab\n                ) {\n                  label.setAttribute(\"data-md-switching\", \"\")\n                  input.click()\n                  break\n                }\n              }\n\n            /* Bring active tab into view */\n            window.scrollTo({\n              top: el.offsetTop - y\n            })\n\n            /* Persist active tabs in local storage */\n            const tabs = __md_get<string[]>(\"__tabs\") || []\n            __md_set(\"__tabs\", [...new Set([tab, ...tabs])])\n          }\n        })\n\n    /* Pause media (audio, video) on switch - see https://bit.ly/3Bk6cel */\n    push$.pipe(takeUntil(done$))\n      .subscribe(() => {\n        for (const media of getElements<HTMLAudioElement>(\"audio, video\", el))\n          media.pause()\n      })\n\n    /* Create and return component */\n    return watchContentTabs(inputs)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, merge } from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { Viewport, getElements } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport {\n  Tooltip,\n  mountInlineTooltip2\n} from \"../../tooltip2\"\nimport {\n  Annotation,\n  mountAnnotationBlock\n} from \"../annotation\"\nimport {\n  CodeBlock,\n  mountCodeBlock\n} from \"../code\"\nimport {\n  Details,\n  mountDetails\n} from \"../details\"\nimport {\n  Mermaid,\n  mountMermaid\n} from \"../mermaid\"\nimport {\n  DataTable,\n  mountDataTable\n} from \"../table\"\nimport {\n  ContentTabs,\n  mountContentTabs\n} from \"../tabs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content\n */\nexport type Content =\n  | Annotation\n  | CodeBlock\n  | ContentTabs\n  | DataTable\n  | Details\n  | Mermaid\n  | Tooltip\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n  print$: Observable<boolean>          /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount content\n *\n * This function mounts all components that are found in the content of the\n * actual article, including code blocks, data tables and details.\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Content component observable\n */\nexport function mountContent(\n  el: HTMLElement, { viewport$, target$, print$ }: MountOptions\n): Observable<Component<Content>> {\n  return merge(\n\n    /* Annotations */\n    ...getElements(\".annotate:not(.highlight)\", el)\n      .map(child => mountAnnotationBlock(child, { target$, print$ })),\n\n    /* Code blocks */\n    ...getElements(\"pre:not(.mermaid) > code\", el)\n      .map(child => mountCodeBlock(child, { target$, print$ })),\n\n    /* Mermaid diagrams */\n    ...getElements(\"pre.mermaid\", el)\n      .map(child => mountMermaid(child)),\n\n    /* Data tables */\n    ...getElements(\"table:not([class])\", el)\n      .map(child => mountDataTable(child)),\n\n    /* Details */\n    ...getElements(\"details\", el)\n      .map(child => mountDetails(child, { target$, print$ })),\n\n    /* Content tabs */\n    ...getElements(\"[data-tabs]\", el)\n      .map(child => mountContentTabs(child, { viewport$, target$ })),\n\n    /* Tooltips */\n    ...getElements(\"[title]\", el)\n      .filter(() => feature(\"content.tooltips\"))\n      .map(child => mountInlineTooltip2(child, { viewport$ }))\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  delay,\n  finalize,\n  map,\n  merge,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dialog\n */\nexport interface Dialog {\n  message: string                      /* Dialog message */\n  active: boolean                      /* Dialog is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch dialog\n *\n * @param _el - Dialog element\n * @param options - Options\n *\n * @returns Dialog observable\n */\nexport function watchDialog(\n  _el: HTMLElement, { alert$ }: WatchOptions\n): Observable<Dialog> {\n  return alert$\n    .pipe(\n      switchMap(message => merge(\n        of(true),\n        of(false).pipe(delay(2000))\n      )\n        .pipe(\n          map(active => ({ message, active }))\n        )\n      )\n    )\n}\n\n/**\n * Mount dialog\n *\n * This function reveals the dialog in the right corner when a new alert is\n * emitted through the subject that is passed as part of the options.\n *\n * @param el - Dialog element\n * @param options - Options\n *\n * @returns Dialog component observable\n */\nexport function mountDialog(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Dialog>> {\n  const inner = getElement(\".md-typeset\", el)\n  return defer(() => {\n    const push$ = new Subject<Dialog>()\n    push$.subscribe(({ message, active }) => {\n      el.classList.toggle(\"md-dialog--active\", active)\n      inner.textContent = message\n    })\n\n    /* Create and return component */\n    return watchDialog(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  map,\n  merge,\n  of,\n  subscribeOn,\n  tap,\n  throttleTime\n} from \"rxjs\"\n\nimport {\n  ElementOffset,\n  getElement,\n  getElementContainer,\n  getElementOffset,\n  getElementSize,\n  watchElementContentOffset,\n  watchElementFocus,\n  watchElementHover\n} from \"~/browser\"\nimport { renderTooltip } from \"~/templates\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tooltip\n */\nexport interface Tooltip {\n  active: boolean                      /* Tooltip is active */\n  offset: ElementOffset                /* Tooltip offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for tooltips\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch tooltip\n *\n * This function will append the tooltip temporarily to compute its width,\n * which is necessary for correct centering, and then removing it again.\n *\n * @param el - Tooltip element\n * @param host - Host element\n *\n * @returns Tooltip observable\n */\nexport function watchTooltip(\n  el: HTMLElement, host: HTMLElement\n): Observable<Tooltip> {\n  document.body.append(el)\n\n  /* Compute width and remove tooltip immediately */\n  const { width } = getElementSize(el)\n  el.style.setProperty(\"--md-tooltip-width\", `${width}px`)\n  el.remove()\n\n  /* Retrieve and watch containing element */\n  const container = getElementContainer(host)\n  const scroll$ =\n    typeof container !== \"undefined\"\n      ? watchElementContentOffset(container)\n      : of({ x: 0, y: 0 })\n\n  /* Compute tooltip visibility */\n  const active$ = merge(\n    watchElementFocus(host),\n    watchElementHover(host)\n  )\n    .pipe(\n      distinctUntilChanged()\n    )\n\n  /* Compute tooltip offset */\n  return combineLatest([active$, scroll$])\n    .pipe(\n      map(([active, scroll]) => {\n        let { x, y } = getElementOffset(host)\n        const size = getElementSize(host)\n\n        /**\n         * Experimental: fix handling of tables - see https://bit.ly/3TQEj5O\n         *\n         * If this proves to be a viable fix, we should refactor tooltip\n         * positioning and somehow streamline the current process. This might\n         * also fix positioning for annotations inside tables, which is another\n         * limitation.\n         */\n        const table = host.closest(\"table\")\n        if (table && host.parentElement) {\n          x += table.offsetLeft + host.parentElement.offsetLeft\n          y += table.offsetTop  + host.parentElement.offsetTop\n        }\n        return {\n          active,\n          offset: {\n            x: x - scroll.x + size.width  / 2 - width / 2,\n            y: y - scroll.y + size.height + 8\n          }\n        }\n      })\n    )\n}\n\n/**\n * Mount tooltip\n *\n * @param el - Host element\n *\n * @returns Tooltip component observable\n */\nexport function mountTooltip(\n  el: HTMLElement\n): Observable<Component<Tooltip>> {\n  const title = el.title\n  if (!title.length)\n    return EMPTY\n\n  /* Render tooltip and set title from host element */\n  const id = `__tooltip_${sequence++}`\n  const tooltip = renderTooltip(id, \"inline\")\n  const typeset = getElement(\".md-typeset\", tooltip)\n  typeset.innerHTML = title\n\n  /* Mount component on subscription */\n  return defer(() => {\n    const push$ = new Subject<Tooltip>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ offset }) {\n        tooltip.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n        tooltip.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n      },\n\n      /* Handle complete */\n      complete() {\n        tooltip.style.removeProperty(\"--md-tooltip-x\")\n        tooltip.style.removeProperty(\"--md-tooltip-y\")\n      }\n    })\n\n    /* Toggle tooltip presence to mitigate empty lines when copying */\n    merge(\n      push$.pipe(filter(({ active }) => active)),\n      push$.pipe(debounceTime(250), filter(({ active }) => !active))\n    )\n      .subscribe({\n\n        /* Handle emission */\n        next({ active }) {\n          if (active) {\n            el.insertAdjacentElement(\"afterend\", tooltip)\n            el.setAttribute(\"aria-describedby\", id)\n            el.removeAttribute(\"title\")\n          } else {\n            tooltip.remove()\n            el.removeAttribute(\"aria-describedby\")\n            el.setAttribute(\"title\", title)\n          }\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.remove()\n          el.removeAttribute(\"aria-describedby\")\n          el.setAttribute(\"title\", title)\n        }\n      })\n\n    /* Toggle tooltip visibility */\n    push$\n      .pipe(\n        auditTime(16, animationFrameScheduler)\n      )\n        .subscribe(({ active }) => {\n          tooltip.classList.toggle(\"md-tooltip--active\", active)\n        })\n\n    // @todo - refactor positioning together with annotations \u2013 there are\n    // several things that overlap and are identical in handling\n\n    /* Track relative origin of tooltip */\n    push$\n      .pipe(\n        throttleTime(125, animationFrameScheduler),\n        filter(() => !!el.offsetParent),\n        map(() => el.offsetParent!.getBoundingClientRect()),\n        map(({ x }) => x)\n      )\n      .subscribe({\n\n        /* Handle emission */\n        next(origin) {\n          if (origin)\n            tooltip.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n          else\n            tooltip.style.removeProperty(\"--md-tooltip-0\")\n        },\n\n        /* Handle complete */\n        complete() {\n          tooltip.style.removeProperty(\"--md-tooltip-0\")\n        }\n      })\n\n    /* Create and return component */\n    return watchTooltip(tooltip, el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n    .pipe(\n      subscribeOn(asyncScheduler)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  combineLatestWith,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  from,\n  ignoreElements,\n  map,\n  mergeMap,\n  mergeWith,\n  of,\n  shareReplay,\n  startWith,\n  switchMap,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementSize,\n  watchToggle\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Main } from \"../../main\"\nimport {\n  Tooltip,\n  mountTooltip\n} from \"../../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface Header {\n  height: number                       /* Header visible height */\n  hidden: boolean                      /* Header is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute whether the header is hidden\n *\n * If the user scrolls past a certain threshold, the header can be hidden when\n * scrolling down, and shown when scrolling up.\n *\n * @param options - Options\n *\n * @returns Toggle observable\n */\nfunction isHidden({ viewport$ }: WatchOptions): Observable<boolean> {\n  if (!feature(\"header.autohide\"))\n    return of(false)\n\n  /* Compute direction and turning point */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => [a < b, b] as const),\n      distinctUntilKeyChanged(0)\n    )\n\n  /* Compute whether header should be hidden */\n  const hidden$ = combineLatest([viewport$, direction$])\n    .pipe(\n      filter(([{ offset }, [, y]]) => Math.abs(y - offset.y) > 100),\n      map(([, [direction]]) => direction),\n      distinctUntilChanged()\n    )\n\n  /* Compute threshold for hiding */\n  const search$ = watchToggle(\"search\")\n  return combineLatest([viewport$, search$])\n    .pipe(\n      map(([{ offset }, search]) => offset.y > 400 && !search),\n      distinctUntilChanged(),\n      switchMap(active => active ? hidden$ : of(false)),\n      startWith(false)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header observable\n */\nexport function watchHeader(\n  el: HTMLElement, options: WatchOptions\n): Observable<Header> {\n  return defer(() => combineLatest([\n    watchElementSize(el),\n    isHidden(options)\n  ]))\n    .pipe(\n      map(([{ height }, hidden]) => ({\n        height,\n        hidden\n      })),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.hidden === b.hidden\n      )),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount header\n *\n * This function manages the different states of the header, i.e. whether it's\n * hidden or rendered with a shadow. This depends heavily on the main area.\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header component observable\n */\nexport function mountHeader(\n  el: HTMLElement, { header$, main$ }: MountOptions\n): Observable<Component<Header | Tooltip>> {\n  return defer(() => {\n    const push$ = new Subject<Main>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$\n      .pipe(\n        distinctUntilKeyChanged(\"active\"),\n        combineLatestWith(header$)\n      )\n        .subscribe(([{ active }, { hidden }]) => {\n          el.classList.toggle(\"md-header--shadow\", active && !hidden)\n          el.hidden = hidden\n        })\n\n    /* Mount tooltips, if enabled */\n    const tooltips = from(getElements(\"[title]\", el))\n      .pipe(\n        filter(() => feature(\"content.tooltips\")),\n        mergeMap(child => mountTooltip(child))\n      )\n\n    /* Link to main area */\n    main$.subscribe(push$)\n\n    /* Create and return component */\n    return header$\n      .pipe(\n        takeUntil(done$),\n        map(state => ({ ref: el, ...state })),\n        mergeWith(tooltips.pipe(takeUntil(done$)))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElementSize,\n  getOptionalElement,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Header } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface HeaderTitle {\n  active: boolean                      /* Header title is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header title\n *\n * @param el - Heading element\n * @param options - Options\n *\n * @returns Header title observable\n */\nexport function watchHeaderTitle(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<HeaderTitle> {\n  return watchViewportAt(el, { viewport$, header$ })\n    .pipe(\n      map(({ offset: { y } }) => {\n        const { height } = getElementSize(el)\n        return {\n          active: y >= height\n        }\n      }),\n      distinctUntilKeyChanged(\"active\")\n    )\n}\n\n/**\n * Mount header title\n *\n * This function swaps the header title from the site title to the title of the\n * current page when the user scrolls past the first headline.\n *\n * @param el - Header title element\n * @param options - Options\n *\n * @returns Header title component observable\n */\nexport function mountHeaderTitle(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<HeaderTitle>> {\n  return defer(() => {\n    const push$ = new Subject<HeaderTitle>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ active }) {\n        el.classList.toggle(\"md-header__title--active\", active)\n      },\n\n      /* Handle complete */\n      complete() {\n        el.classList.remove(\"md-header__title--active\")\n      }\n    })\n\n    /* Obtain headline, if any */\n    const heading = getOptionalElement(\".md-content h1\")\n    if (typeof heading === \"undefined\")\n      return EMPTY\n\n    /* Create and return component */\n    return watchHeaderTitle(heading, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  map,\n  switchMap\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchElementSize\n} from \"~/browser\"\n\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Main area\n */\nexport interface Main {\n  offset: number                       /* Main area top offset */\n  height: number                       /* Main area visible height */\n  active: boolean                      /* Main area is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch main area\n *\n * This function returns an observable that computes the visual parameters of\n * the main area which depends on the viewport vertical offset and height, as\n * well as the height of the header element, if the header is fixed.\n *\n * @param el - Main area element\n * @param options - Options\n *\n * @returns Main area observable\n */\nexport function watchMain(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Main> {\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      map(({ height }) => height),\n      distinctUntilChanged()\n    )\n\n  /* Compute the main area's top and bottom borders */\n  const border$ = adjust$\n    .pipe(\n      switchMap(() => watchElementSize(el)\n        .pipe(\n          map(({ height }) => ({\n            top:    el.offsetTop,\n            bottom: el.offsetTop + height\n          })),\n          distinctUntilKeyChanged(\"bottom\")\n        )\n      )\n    )\n\n  /* Compute the main area's offset, visible height and if we scrolled past */\n  return combineLatest([adjust$, border$, viewport$])\n    .pipe(\n      map(([header, { top, bottom }, { offset: { y }, size: { height } }]) => {\n        height = Math.max(0, height\n          - Math.max(0, top    - y,  header)\n          - Math.max(0, height + y - bottom)\n        )\n        return {\n          offset: top - header,\n          height,\n          active: top - header <= y\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.offset === b.offset &&\n        a.height === b.height &&\n        a.active === b.active\n      ))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  defer,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  mergeMap,\n  observeOn,\n  of,\n  repeat,\n  shareReplay,\n  skip,\n  startWith,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements, watchMedia } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Palette colors\n */\nexport interface PaletteColor {\n  media?: string                       /* Media query */\n  scheme?: string                      /* Color scheme */\n  primary?: string                     /* Primary color */\n  accent?: string                      /* Accent color */\n}\n\n/**\n * Palette\n */\nexport interface Palette {\n  index: number                        /* Palette index */\n  color: PaletteColor                  /* Palette colors */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch color palette\n *\n * @param inputs - Color palette element\n *\n * @returns Color palette observable\n */\nexport function watchPalette(\n  inputs: HTMLInputElement[]\n): Observable<Palette> {\n  const current = __md_get<Palette>(\"__palette\") || {\n    index: inputs.findIndex(input => matchMedia(\n      input.getAttribute(\"data-md-color-media\")!\n    ).matches)\n  }\n\n  /* Emit changes in color palette */\n  const index = Math.max(0, Math.min(current.index, inputs.length - 1))\n  return of(...inputs)\n    .pipe(\n      mergeMap(input => fromEvent(input, \"change\").pipe(map(() => input))),\n      startWith(inputs[index]),\n      map(input => ({\n        index: inputs.indexOf(input),\n        color: {\n          media:   input.getAttribute(\"data-md-color-media\"),\n          scheme:  input.getAttribute(\"data-md-color-scheme\"),\n          primary: input.getAttribute(\"data-md-color-primary\"),\n          accent:  input.getAttribute(\"data-md-color-accent\")\n        }\n      } as Palette)),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount color palette\n *\n * @param el - Color palette element\n *\n * @returns Color palette component observable\n */\nexport function mountPalette(\n  el: HTMLElement\n): Observable<Component<Palette>> {\n  const inputs = getElements<HTMLInputElement>(\"input\", el)\n  const meta = h(\"meta\", { name: \"theme-color\" })\n  document.head.appendChild(meta)\n\n  // Add color scheme meta tag\n  const scheme = h(\"meta\", { name: \"color-scheme\" })\n  document.head.appendChild(scheme)\n\n  /* Mount component on subscription */\n  const media$ = watchMedia(\"(prefers-color-scheme: light)\")\n  return defer(() => {\n    const push$ = new Subject<Palette>()\n    push$.subscribe(palette => {\n      document.body.setAttribute(\"data-md-color-switching\", \"\")\n\n      /* Retrieve color palette for system preference */\n      if (palette.color.media === \"(prefers-color-scheme)\") {\n        const media = matchMedia(\"(prefers-color-scheme: light)\")\n        const input = document.querySelector(media.matches\n          ? \"[data-md-color-media='(prefers-color-scheme: light)']\"\n          : \"[data-md-color-media='(prefers-color-scheme: dark)']\"\n        )!\n\n        /* Retrieve colors for system preference */\n        palette.color.scheme  = input.getAttribute(\"data-md-color-scheme\")!\n        palette.color.primary = input.getAttribute(\"data-md-color-primary\")!\n        palette.color.accent  = input.getAttribute(\"data-md-color-accent\")!\n      }\n\n      /* Set color palette */\n      for (const [key, value] of Object.entries(palette.color))\n        document.body.setAttribute(`data-md-color-${key}`, value)\n\n      /* Set toggle visibility */\n      for (let index = 0; index < inputs.length; index++) {\n        const label = inputs[index].nextElementSibling\n        if (label instanceof HTMLElement)\n          label.hidden = palette.index !== index\n      }\n\n      /* Persist preference in local storage */\n      __md_set(\"__palette\", palette)\n    })\n\n    // Handle color switch on Enter or Space - see https://t.ly/YIhVj\n    fromEvent<KeyboardEvent>(el, \"keydown\").pipe(\n      filter(ev => ev.key === \"Enter\"),\n      withLatestFrom(push$, (_, palette) => palette)\n    )\n      .subscribe(({ index }) => {\n        index = (index + 1) % inputs.length\n        inputs[index].click()\n        inputs[index].focus()\n      })\n\n    /* Update theme-color meta tag */\n    push$\n      .pipe(\n        map(() => {\n          const header = getComponentElement(\"header\")\n          const style  = window.getComputedStyle(header)\n\n          // Set color scheme\n          scheme.content = style.colorScheme\n\n          /* Return color in hexadecimal format */\n          return style.backgroundColor.match(/\\d+/g)!\n            .map(value => (+value).toString(16).padStart(2, \"0\"))\n            .join(\"\")\n        })\n      )\n        .subscribe(color => meta.content = `#${color}`)\n\n    /* Revert transition durations after color switch */\n    push$.pipe(observeOn(asyncScheduler))\n      .subscribe(() => {\n        document.body.removeAttribute(\"data-md-color-switching\")\n      })\n\n    /* Create and return component */\n    return watchPalette(inputs)\n      .pipe(\n        takeUntil(media$.pipe(skip(1))),\n        repeat(),\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  finalize,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Progress indicator\n */\nexport interface Progress {\n  value: number                        // Progress value\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount progress indicator\n *\n * @param el - Progress indicator element\n * @param options - Options\n *\n * @returns Progress indicator component observable\n */\nexport function mountProgress(\n  el: HTMLElement, { progress$ }: MountOptions\n): Observable<Component<Progress>> {\n\n  // Mount component on subscription\n  return defer(() => {\n    const push$ = new Subject<Progress>()\n    push$.subscribe(({ value }) => {\n      el.style.setProperty(\"--md-progress-value\", `${value}`)\n    })\n\n    // Create and return component\n    return progress$\n      .pipe(\n        tap(value => push$.next({ value })),\n        finalize(() => push$.complete()),\n        map(value => ({ ref: el, value }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n  Observable,\n  Subject,\n  map,\n  tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  alert$: Subject<string>              /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Extract text to copy\n *\n * @param el - HTML element\n *\n * @returns Extracted text\n */\nfunction extract(el: HTMLElement): string {\n  el.setAttribute(\"data-md-copying\", \"\")\n  const copy = el.closest(\"[data-copy]\")\n  const text = copy\n    ? copy.getAttribute(\"data-copy\")!\n    : el.innerText\n  el.removeAttribute(\"data-md-copying\")\n  return text.trimEnd()\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up Clipboard.js integration\n *\n * @param options - Options\n */\nexport function setupClipboardJS(\n  { alert$ }: SetupOptions\n): void {\n  if (ClipboardJS.isSupported()) {\n    new Observable<ClipboardJS.Event>(subscriber => {\n      new ClipboardJS(\"[data-clipboard-target], [data-clipboard-text]\", {\n        text: el => (\n          el.getAttribute(\"data-clipboard-text\")! ||\n          extract(getElement(\n            el.getAttribute(\"data-clipboard-target\")!\n          ))\n        )\n      })\n        .on(\"success\", ev => subscriber.next(ev))\n    })\n      .pipe(\n        tap(ev => {\n          const trigger = ev.trigger as HTMLElement\n          trigger.focus()\n        }),\n        map(() => translation(\"clipboard.copied\"))\n      )\n        .subscribe(alert$)\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  catchError,\n  map,\n  of\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getElements,\n  requestXML\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sitemap, i.e. a list of URLs\n */\nexport type Sitemap = Map<string, URL[]>\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Resolve URL to the given base URL\n *\n * When serving the site with instant navigation, MkDocs will set the hostname\n * to the value as specified in `dev_addr`, but the browser allows for several\n * hostnames to be used: `localhost`, `127.0.0.1` or even `0.0.0.0`, depending\n * on configuration. This function resolves the URL to the given hostname.\n *\n * @param url - URL\n * @param base - Base URL\n *\n * @returns Resolved URL\n */\nfunction resolve(url: URL, base: URL) {\n  url.protocol = base.protocol\n  url.hostname = base.hostname\n  return url\n}\n\n/**\n * Extract sitemap from document\n *\n * This function extracts the URLs and alternate links from the document, and\n * associates alternate links to the original URL as found in `loc`, allowing\n * the browser to navigate to the correct page when switching languages. The\n * format of the sitemap is expected to adhere to:\n *\n * ``` xml\n * <urlset>\n *   <url>\n *     <loc>...</loc>\n *     <xhtml:link rel=\"alternate\" hreflang=\"en\" href=\"...\"/>\n *     <xhtml:link rel=\"alternate\" hreflang=\"de\" href=\"...\"/>\n *     ...\n *   </url>\n *   ...\n * </urlset>\n * ```\n *\n * @param document - Document\n * @param base - Base URL\n *\n * @returns Sitemap\n */\nfunction extract(document: Document, base: URL): Sitemap {\n  const sitemap: Sitemap = new Map()\n  for (const el of getElements(\"url\", document)) {\n    const url = getElement(\"loc\", el)\n\n    // Create entry for location and add it to the list of links\n    const links = [resolve(new URL(url.textContent!), base)]\n    sitemap.set(`${links[0]}`, links)\n\n    // Attach alternate links to current entry\n    for (const link of getElements(\"[rel=alternate]\", el)) {\n      const href = link.getAttribute(\"href\")\n      if (href != null)\n        links.push(resolve(new URL(href), base))\n    }\n  }\n\n  // Return sitemap\n  return sitemap\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the sitemap for the given base URL\n *\n * If a network or parsing error occurs, we just default to an empty sitemap,\n * which means the caller should fall back to regular navigation.\n *\n * @param base - Base URL\n *\n * @returns Sitemap observable\n */\nexport function fetchSitemap(base: URL | string): Observable<Sitemap> {\n  return requestXML(new URL(\"sitemap.xml\", base))\n    .pipe(\n      map(document => extract(document, new URL(base))),\n      catchError(() => of(new Map())),\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  combineLatestWith,\n  concat,\n  debounceTime,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  of,\n  share,\n  switchMap,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration, feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  requestHTML,\n  setLocation,\n  setLocationHash\n} from \"~/browser\"\nimport { getComponentElement } from \"~/components\"\n\nimport { Sitemap, fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  location$: Subject<URL>              // Location subject\n  viewport$: Observable<Viewport>      // Viewport observable\n  progress$: Subject<number>           // Progress subject\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Handle clicks on internal URLs while skipping external URLs\n *\n * @param ev - Mouse event\n * @param sitemap - Sitemap\n *\n * @returns URL observable\n */\nfunction handle(\n  ev: MouseEvent, sitemap: Sitemap\n): Observable<URL> {\n  if (!(ev.target instanceof Element))\n    return EMPTY\n\n  // Skip, as target is not within a link - clicks on non-link elements are\n  // also captured, which we need to exclude from processing\n  const el = ev.target.closest(\"a\")\n  if (el === null)\n    return EMPTY\n\n  // Skip, as link opens in new window - we now know we have captured a click\n  // on a link, but the link either has a `target` property defined, or the\n  // user pressed the `meta` or `ctrl` key to open it in a new window. Thus,\n  // we need to filter this event as well.\n  if (el.target || ev.metaKey || ev.ctrlKey)\n    return EMPTY\n\n  // Next, we must check if the URL is relevant for us, i.e., if it's an\n  // internal link to a page that is managed by MkDocs. Only then we can be\n  // sure that the structure of the page to be loaded adheres to the current\n  // document structure and can subsequently be injected into it without doing\n  // a full reload. For this reason, we must canonicalize the URL by removing\n  // all search parameters and hash fragments.\n  const url = new URL(el.href)\n  url.search = url.hash = \"\"\n\n  // Skip, if URL is not included in the sitemap - this could be the case when\n  // linking between versions or languages, or to another page that the author\n  // included as part of the build, but that is not managed by MkDocs. In that\n  // case we must not continue with instant navigation.\n  if (!sitemap.has(`${url}`))\n    return EMPTY\n\n  // We now know that we have a link to an internal page, so we prevent the\n  // browser from navigation and emit the URL for instant navigation. Note that\n  // this also includes anchor links, which means we need to implement anchor\n  // positioning ourselves. The reason for this is that if we wouldn't manage\n  // anchor links as well, scroll restoration will not work correctly (e.g.\n  // following an anchor link and scrolling).\n  ev.preventDefault()\n  return of(new URL(el.href))\n}\n\n/**\n * Create a map of head elements for lookup and replacement\n *\n * @param document - Document\n *\n * @returns Tag map\n */\nfunction head(document: Document): Map<string, HTMLElement> {\n  const tags = new Map<string, HTMLElement>()\n  for (const el of getElements(\":scope > *\", document.head))\n    tags.set(el.outerHTML, el)\n\n  // Return tag map\n  return tags\n}\n\n/**\n * Resolve relative URLs in the given document\n *\n * This function resolves relative `href` and `src` attributes, which can belong\n * to all sorts of tags, like meta tags, links, images, scripts and more.\n *\n * @param document - Document\n *\n * @returns Document observable\n */\nfunction resolve(document: Document): Observable<Document> {\n  for (const el of getElements(\"[href], [src]\", document))\n    for (const key of [\"href\", \"src\"]) {\n      const value = el.getAttribute(key)\n      if (value && !/^(?:[a-z]+:)?\\/\\//i.test(value)) {\n        // @ts-expect-error - trick: self-assign to resolve URL\n        el[key] = el[key]\n        break\n      }\n    }\n\n  // Return document observable\n  return of(document)\n}\n\n/**\n * Inject the contents of a document into the current one\n *\n * @param next - Next document\n *\n * @returns Document observable\n */\nfunction inject(next: Document): Observable<Document> {\n  for (const selector of [\n    \"[data-md-component=announce]\",\n    \"[data-md-component=container]\",\n    \"[data-md-component=header-topic]\",\n    \"[data-md-component=outdated]\",\n    \"[data-md-component=logo]\",\n    \"[data-md-component=skip]\",\n    ...feature(\"navigation.tabs.sticky\")\n      ? [\"[data-md-component=tabs]\"]\n      : []\n  ]) {\n    const source = getOptionalElement(selector)\n    const target = getOptionalElement(selector, next)\n    if (\n      typeof source !== \"undefined\" &&\n      typeof target !== \"undefined\"\n    ) {\n      source.replaceWith(target)\n    }\n  }\n\n  // Update meta tags\n  const tags = head(document)\n  for (const [html, el] of head(next))\n    if (tags.has(html))\n      tags.delete(html)\n    else\n      document.head.appendChild(el)\n\n  // Remove meta tags that are not present in the new document\n  for (const el of tags.values()) {\n    const name = el.getAttribute(\"name\")\n    // @todo - find a better way to handle attributes we add dynamically in\n    // other components without mounting components on every navigation, as\n    // this might impact overall performance - see https://t.ly/ehp_O\n    if (name !== \"theme-color\" && name !== \"color-scheme\")\n      el.remove()\n  }\n\n  // After components and meta tags were replaced, re-evaluate scripts\n  // that were provided by the author as part of Markdown files\n  const container = getComponentElement(\"container\")\n  return concat(getElements(\"script\", container))\n    .pipe(\n      switchMap(el => {\n        const script = next.createElement(\"script\")\n        if (el.src) {\n          for (const name of el.getAttributeNames())\n            script.setAttribute(name, el.getAttribute(name)!)\n          el.replaceWith(script)\n\n          // Complete when script is loaded\n          return new Observable(observer => {\n            script.onload = () => observer.complete()\n          })\n\n        // Complete immediately\n        } else {\n          script.textContent = el.textContent\n          el.replaceWith(script)\n          return EMPTY\n        }\n      }),\n      ignoreElements(),\n      endWith(document)\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up instant navigation\n *\n * This is a heavily orchestrated operation - see inline comments to learn how\n * this works with Material for MkDocs, and how you can hook into it.\n *\n * @param options - Options\n *\n * @returns Document observable\n */\nexport function setupInstantNavigation(\n  { location$, viewport$, progress$ }: SetupOptions\n): Observable<Document> {\n  const config = configuration()\n  if (location.protocol === \"file:\")\n    return EMPTY\n\n  // Load sitemap immediately, so we have it available when the user initiates\n  // the first navigation request without any perceivable delay\n  const sitemap$ = fetchSitemap(config.base)\n\n  // Since we might be on a slow connection, the user might trigger multiple\n  // instant navigation events that overlap. MkDocs produces relative URLs for\n  // all internal links, which becomes a problem in this case, because we need\n  // to change the base URL the moment the user clicks a link that should be\n  // intercepted in order to be consistent with popstate, which means that the\n  // base URL would now be incorrect when resolving another relative link from\n  // the same site. For this reason we always resolve all relative links to\n  // absolute links, so we can be sure this never happens.\n  of(document)\n    .subscribe(resolve)\n\n  // --------------------------------------------------------------------------\n  // Navigation interception\n  // --------------------------------------------------------------------------\n\n  // Intercept navigation - to keep the number of event listeners down we use\n  // the fact that uncaptured events bubble up to the body. This has the nice\n  // property that we don't need to detach and then re-attach event listeners\n  // when the document is replaced after a navigation event.\n  const instant$ =\n    fromEvent<MouseEvent>(document.body, \"click\")\n      .pipe(\n        combineLatestWith(sitemap$),\n        switchMap(([ev, sitemap]) => handle(ev, sitemap)),\n        share()\n      )\n\n  // Intercept history change events, e.g. when the user uses the browser's\n  // back or forward buttons, and emit new location for fetching and parsing\n  const history$ =\n    fromEvent<PopStateEvent>(window, \"popstate\")\n      .pipe(\n        map(getLocation),\n        share()\n      )\n\n  // While it would be better UX to defer navigation events until the document\n  // is fully fetched and parsed, we must schedule it here to synchronize with\n  // popstate events, as they are emitted immediately. Moreover we need to\n  // store the current viewport offset for scroll restoration later on.\n  instant$.pipe(withLatestFrom(viewport$))\n    .subscribe(([url, { offset }]) => {\n      history.replaceState(offset, \"\")\n      history.pushState(null, \"\", url)\n    })\n\n  // Emit URLs that should be fetched via instant navigation on location subject\n  // which was passed into this function. The state of instant navigation can be\n  // intercepted by other parts of the application, which can synchronously back\n  // up or restore state before or after instant navigation happens.\n  merge(instant$, history$)\n    .subscribe(location$)\n\n  // --------------------------------------------------------------------------\n  // Fetching and parsing\n  // --------------------------------------------------------------------------\n\n  // Fetch document - we deduplicate requests to the same location, so we don't\n  // end up with multiple requests for the same page. We use `switchMap`, since\n  // we want to cancel the previous request when a new one is triggered, which\n  // is automatically handled by the observable returned by `request`. This is\n  // essential to ensure a good user experience, as we don't want to load pages\n  // that are not needed anymore, e.g., when the user clicks multiple links in\n  // quick succession or on slow connections. If the request fails for some\n  // reason, we fall back and use regular navigation, forcing a reload.\n  const document$ =\n    location$.pipe(\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(url => requestHTML(url, { progress$ })\n        .pipe(\n          catchError(() => {\n            setLocation(url, true)\n            return EMPTY\n          })\n        )\n      ),\n\n      // The document was successfully fetched and parsed, so we can inject its\n      // contents into the currently active document\n      switchMap(resolve),\n      switchMap(inject),\n      share()\n    )\n\n  // --------------------------------------------------------------------------\n  // Scroll restoration\n  // --------------------------------------------------------------------------\n\n  // Handle scroll restoration - we must restore the viewport offset after the\n  // document has been fetched and injected, and every time the user clicks an\n  // anchor that leads to an element on the same page, which might also happen\n  // when the user uses the back or forward button.\n  merge(\n    document$.pipe(withLatestFrom(location$, (_, url) => url)),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with a hash fragment different from the current one, as\n    // well as from popstate events, which are emitted when the user navigates\n    // back and forth between pages. We use a two-layered subscription to scope\n    // the scroll restoration to the current page, as we don't need to restore\n    // the viewport offset when the user navigates to a different page, as this\n    // is already handled by the previous observable.\n    document$.pipe(\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"pathname\"),\n      switchMap(() => location$),\n      distinctUntilKeyChanged(\"hash\")\n    ),\n\n    // Handle instant navigation events that are triggered by the user clicking\n    // on an anchor link with the same hash fragment as the current one in the\n    // URL. It is essential that we only intercept those from instant navigation\n    // events and not from history change events, or we'll end up in and endless\n    // loop. The top-level history entry must be removed, as it will be replaced\n    // with a new one, which would otherwise lead to a duplicate entry.\n    location$.pipe(\n      distinctUntilChanged((a, b) => (\n        a.pathname === b.pathname &&\n        a.hash     === b.hash\n      )),\n      switchMap(() => instant$),\n      tap(() => history.back())\n    )\n  )\n    .subscribe(url => {\n\n      // Check if the current history entry has a state, which happens when the\n      // user presses the back or forward button to visit a page we've already\n      // seen. If there's no state, it means a new page was visited and we must\n      // scroll to the top, unless an anchor is given.\n      if (history.state !== null || !url.hash) {\n        window.scrollTo(0, history.state?.y ?? 0)\n      } else {\n        history.scrollRestoration = \"auto\"\n        setLocationHash(url.hash)\n        history.scrollRestoration = \"manual\"\n      }\n    })\n\n  // Disable scroll restoration when an instant navigation event occurs, so the\n  // browser does not immediately set the viewport offset to the prior history\n  // entry, scrolling to the position on the same page, which would look odd.\n  // Instead, we manually restore the position once the page has loaded.\n  location$.subscribe(() => {\n    history.scrollRestoration = \"manual\"\n  })\n\n  // Enable scroll restoration before window unloads - this is essential to\n  // ensure that full reloads (F5) restore the viewport offset correctly. If\n  // only popstate events wouldn't reset the viewport offset prior to their\n  // emission, we could just reset this in popstate. Meh.\n  fromEvent(window, \"beforeunload\")\n    .subscribe(() => {\n      history.scrollRestoration = \"auto\"\n    })\n\n  // Track viewport offset, so we can restore it when the user navigates back\n  // and forth between pages. Note that this must be debounced and cannot be\n  // done in popstate, as popstate has already removed the entry from the\n  // history, which means it is too late.\n  viewport$.pipe(\n    distinctUntilKeyChanged(\"offset\"),\n    debounceTime(100)\n  )\n    .subscribe(({ offset }) => {\n      history.replaceState(offset, \"\")\n    })\n\n  // Return document observable\n  return document$\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchConfig } from \"../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search configuration\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n  config: SearchConfig\n): SearchHighlightFactoryFn {\n  // Hack: temporarily remove pure lookaheads and lookbehinds\n  const regex = config.separator.split(\"|\").map(term => {\n    const temp = term.replace(/(\\(\\?[!=<][^)]+\\))/g, \"\")\n    return temp.length === 0 ? \"\uFFFD\" : term\n  })\n    .join(\"|\")\n\n  const separator = new RegExp(regex, \"img\")\n  const highlight = (_: unknown, data: string, term: string) => {\n    return `${data}<mark data-md-highlight>${term}</mark>`\n  }\n\n  /* Return factory function */\n  return (query: string) => {\n    query = query\n      .replace(/[\\s*+\\-:~^]+/g, \" \")\n      .trim()\n\n    /* Create search term match expression */\n    const match = new RegExp(`(^|${config.separator}|)(${\n      query\n        .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n        .replace(separator, \"|\")\n    })`, \"img\")\n\n    /* Highlight string value */\n    return value => escapeHTML(value)\n      .replace(match, highlight)\n      .replace(/<\\/mark>(\\s+)<mark[^>]*>/img, \"$1\")\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SearchResult } from \"../../_\"\nimport { SearchIndex } from \"../../config\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search message type\n */\nexport const enum SearchMessageType {\n  SETUP,                               /* Search index setup */\n  READY,                               /* Search index ready */\n  QUERY,                               /* Search query */\n  RESULT                               /* Search results */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message containing the data necessary to setup the search index\n */\nexport interface SearchSetupMessage {\n  type: SearchMessageType.SETUP        /* Message type */\n  data: SearchIndex                    /* Message data */\n}\n\n/**\n * Message indicating the search index is ready\n */\nexport interface SearchReadyMessage {\n  type: SearchMessageType.READY        /* Message type */\n}\n\n/**\n * Message containing a search query\n */\nexport interface SearchQueryMessage {\n  type: SearchMessageType.QUERY        /* Message type */\n  data: string                         /* Message data */\n}\n\n/**\n * Message containing results for a search query\n */\nexport interface SearchResultMessage {\n  type: SearchMessageType.RESULT       /* Message type */\n  data: SearchResult                   /* Message data */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message exchanged with the search worker\n */\nexport type SearchMessage =\n  | SearchSetupMessage\n  | SearchReadyMessage\n  | SearchQueryMessage\n  | SearchResultMessage\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Type guard for search ready messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchReadyMessage(\n  message: SearchMessage\n): message is SearchReadyMessage {\n  return message.type === SearchMessageType.READY\n}\n\n/**\n * Type guard for search result messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchResultMessage(\n  message: SearchMessage\n): message is SearchResultMessage {\n  return message.type === SearchMessageType.RESULT\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  ObservableInput,\n  Subject,\n  first,\n  merge,\n  of,\n  switchMap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { watchToggle, watchWorker } from \"~/browser\"\n\nimport { SearchIndex } from \"../../config\"\nimport {\n  SearchMessage,\n  SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search worker\n *\n * This function creates and initializes a web worker that is used for search,\n * so that the user interface doesn't freeze. In general, the application does\n * not care how search is implemented, as long as the web worker conforms to\n * the format expected by the application as defined in `SearchMessage`. This\n * allows the author to implement custom search functionality, by providing a\n * custom web worker via configuration.\n *\n * Material for MkDocs' built-in search implementation makes use of Lunr.js, an\n * efficient and fast implementation for client-side search. Leveraging a tiny\n * iframe-based web worker shim, search is even supported for the `file://`\n * protocol, enabling search for local non-hosted builds.\n *\n * If the protocol is `file://`, search initialization is deferred to mitigate\n * freezing, as it's now synchronous by design - see https://bit.ly/3C521EO\n *\n * @see https://bit.ly/3igvtQv - How to implement custom search\n *\n * @param url - Worker URL\n * @param index$ - Search index observable input\n *\n * @returns Search worker\n */\nexport function setupSearchWorker(\n  url: string, index$: ObservableInput<SearchIndex>\n): Subject<SearchMessage> {\n  const worker$ = watchWorker<SearchMessage>(url)\n  merge(\n    of(location.protocol !== \"file:\"),\n    watchToggle(\"search\")\n  )\n    .pipe(\n      first(active => active),\n      switchMap(() => index$)\n    )\n      .subscribe(({ config, docs }) => worker$.next({\n        type: SearchMessageType.SETUP,\n        data: {\n          config,\n          docs,\n          options: {\n            suggest: feature(\"search.suggest\")\n          }\n        }\n      }))\n\n  /* Return search worker */\n  return worker$\n}\n", "import { Sitemap } from \"../../sitemap\"\n\n/** See docstring for `selectedVersionCorrespondingURL` for the meaning of these fields. */\ntype CorrespondingURLParams = {\n  selectedVersionSitemap: Sitemap\n  selectedVersionBaseURL: URL\n  currentLocation: URL\n  currentBaseURL: string\n}\n\n/**\n * Choose a URL to navigate to when the user chooses a version in the version\n * selector.\n *\n * The parameters in `params` are named as follows, in order to make it clearer\n * which parameter means what when invoking the function:\n *\n *  - selectedVersionSitemap: Sitemap - as obtained by fetchSitemap from `${selectedVersionBaseURL}/sitemap.xml`\n *\n *  - selectedVersionBaseURL: URL - usually `${currentBaseURL}/../selectedVersion`\n *\n *  - currentLocation: URL - current web browser location\n *\n *  - currentBaseURL: string - as obtained from `config.base`\n *\n * @param params - arguments with the meanings explained above.\n * @returns the URL to navigate to or null if we can't be sure that the\n * corresponding page to the current page exists in the selected version\n */\nexport function selectedVersionCorrespondingURL(\n  params: CorrespondingURLParams\n): URL | undefined {\n  const {selectedVersionSitemap,\n    selectedVersionBaseURL,\n    currentLocation,\n    currentBaseURL} = params\n  const current_path = safeURLParse(currentBaseURL)?.pathname\n  if (current_path === undefined) {\n    return\n  }\n  const currentRelativePath = stripPrefix(currentLocation.pathname, current_path)\n  if (currentRelativePath === undefined) {\n    return\n  }\n  const sitemapCommonPrefix = shortestCommonPrefix(selectedVersionSitemap.keys())\n  if (!selectedVersionSitemap.has(sitemapCommonPrefix)) {\n    // We could also check that `commonSitemapPrefix` ends in the canonical version,\n    // similarly to https://github.com/squidfunk/mkdocs-material/pull/7227. However,\n    // I don't believe that Mike/MkDocs ever generate sitemaps where it would matter\n    return\n  }\n\n  const potentialSitemapURL = safeURLParse(currentRelativePath, sitemapCommonPrefix)\n  if (!potentialSitemapURL || !selectedVersionSitemap.has(potentialSitemapURL.href)) {\n    return\n  }\n\n  const result = safeURLParse(currentRelativePath, selectedVersionBaseURL)\n  if (!result) {\n    return\n  }\n  result.hash = currentLocation.hash\n  result.search = currentLocation.search\n  return result\n}\n\n/**\n * A version of `new URL` that never throws. A polyfill for URL.parse() which is\n * not yet ubuquitous.\n *\n * @param url - passed to `new URL` constructor\n * @param base - passed to `new URL` constructor\n *\n * @returns `new URL(url, base)` or undefined if the URL is invalid.\n */\nfunction safeURLParse(url: string|URL, base?: string|URL): URL | undefined {\n  try {\n    return new URL(url, base)\n  } catch {\n    return\n  }\n}\n\n// Basic string manipulation\n\n/** Strip a given prefix from a function\n *\n * @param s - string\n * @param prefix - prefix to strip\n *\n * @returns either the string with the prefix stripped or undefined if the\n * string did not begin with the prefix.\n */\nexport function stripPrefix(s: string, prefix: string): string | undefined {\n  if (s.startsWith(prefix)) {\n    return s.slice(prefix.length)\n  }\n  return undefined\n}\n\n/** Find the length of the longest common prefix of two strings\n *\n * @param s1 - first string\n * @param s2 - second string\n *\n * @returns - the length of the longest common prefix of the two strings.\n */\nfunction commonPrefixLen(s1: string, s2: string): number {\n  const max = Math.min(s1.length, s2.length)\n  let result\n  for (result = 0; result < max; ++result) {\n    if (s1[result] !== s2[result]) {\n      break\n    }\n  }\n  return result\n}\n\n/** Find the longest common prefix of any number of strings\n *\n * @param strs - an iterable of strings\n *\n * @returns the longest common prefix of all the strings\n */\nexport function shortestCommonPrefix(strs: Iterable<string>): string {\n  let result  // Undefined if no iterations happened\n  for (const s of strs) {\n    if (result === undefined) {\n      result = s\n    } else {\n      result = result.slice(0, commonPrefixLen(result, s))\n    }\n  }\n  return result ?? \"\"\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Subject,\n  catchError,\n  combineLatest,\n  filter,\n  fromEvent,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  getElement,\n  getLocation,\n  requestJSON,\n  setLocation\n} from \"~/browser\"\nimport { getComponentElements } from \"~/components\"\nimport {\n  Version,\n  renderVersionSelector\n} from \"~/templates\"\n\nimport { fetchSitemap } from \"../sitemap\"\n\nimport { selectedVersionCorrespondingURL } from \"./findurl\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n  document$: Subject<Document>         /* Document subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up version selector\n *\n * @param options - Options\n */\nexport function setupVersionSelector(\n  { document$ }: SetupOptions\n): void {\n  const config = configuration()\n  const versions$ = requestJSON<Version[]>(\n    new URL(\"../versions.json\", config.base)\n  )\n    .pipe(\n      catchError(() => EMPTY) // @todo refactor instant loading\n    )\n\n  /* Determine current version */\n  const current$ = versions$\n    .pipe(\n      map(versions => {\n        const [, current] = config.base.match(/([^/]+)\\/?$/)!\n        return versions.find(({ version, aliases }) => (\n          version === current || aliases.includes(current)\n        )) || versions[0]\n      })\n    )\n\n  /* Intercept inter-version navigation */\n  versions$\n    .pipe(\n      map(versions => new Map(versions.map(version => [\n        `${new URL(`../${version.version}/`, config.base)}`,\n        version\n      ]))),\n      switchMap(urls => fromEvent<MouseEvent>(document.body, \"click\")\n        .pipe(\n          filter(ev => !ev.metaKey && !ev.ctrlKey),\n          withLatestFrom(current$),\n          switchMap(([ev, current]) => {\n            if (ev.target instanceof Element) {\n              const el = ev.target.closest(\"a\")\n              if (el && !el.target && urls.has(el.href)) {\n                const url = el.href\n                // This is a temporary hack to detect if a version inside the\n                // version selector or on another part of the site was clicked.\n                // If we're inside the version selector, we definitely want to\n                // find the same page, as we might have different deployments\n                // due to aliases. However, if we're outside the version\n                // selector, we must abort here, because we might otherwise\n                // interfere with instant navigation. We need to refactor this\n                // at some point together with instant navigation.\n                //\n                // See https://github.com/squidfunk/mkdocs-material/issues/4012\n                if (!ev.target.closest(\".md-version\")) {\n                  const version = urls.get(url)!\n                  if (version === current)\n                    return EMPTY\n                }\n                ev.preventDefault()\n                return of(new URL(url))\n              }\n            }\n            return EMPTY\n          }),\n          switchMap(selectedVersionBaseURL => {\n            return fetchSitemap(selectedVersionBaseURL).pipe(\n              map(\n                sitemap =>\n                  selectedVersionCorrespondingURL({\n                    selectedVersionSitemap: sitemap,\n                    selectedVersionBaseURL,\n                    currentLocation: getLocation(),\n                    currentBaseURL: config.base\n                  }) ?? selectedVersionBaseURL,\n              ),\n            )\n          })\n        )\n      )\n    )\n      .subscribe(url => setLocation(url, true))\n\n  /* Render version selector and warning */\n  combineLatest([versions$, current$])\n    .subscribe(([versions, current]) => {\n      const topic = getElement(\".md-header__topic\")\n      topic.appendChild(renderVersionSelector(versions, current))\n    })\n\n  /* Integrate outdated version banner with instant navigation */\n  document$.pipe(switchMap(() => current$))\n    .subscribe(current => {\n\n      /* Check if version state was already determined */\n      let outdated = __md_get(\"__outdated\", sessionStorage)\n      if (outdated === null) {\n        outdated = true\n\n        /* Obtain and normalize default versions */\n        let ignored = config.version?.default || \"latest\"\n        if (!Array.isArray(ignored))\n          ignored = [ignored]\n\n        /* Check if version is considered a default */\n        main: for (const ignore of ignored)\n          for (const version of current.aliases.concat(current.version))\n            if (new RegExp(ignore, \"i\").test(version)) {\n              outdated = false\n              break main\n            }\n\n        /* Persist version state in session storage */\n        __md_set(\"__outdated\", outdated, sessionStorage)\n      }\n\n      /* Unhide outdated version banner */\n      if (outdated)\n        for (const warning of getComponentElements(\"outdated\"))\n          warning.hidden = false\n    })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  first,\n  fromEvent,\n  ignoreElements,\n  map,\n  merge,\n  shareReplay,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport {\n  getElement,\n  getLocation,\n  setToggle,\n  watchElementFocus,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchMessageType,\n  isSearchReadyMessage\n} from \"~/integrations\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query\n */\nexport interface SearchQuery {\n  value: string                        /* Query value */\n  focus: boolean                       /* Query focus */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch search query\n *\n * Note that the focus event which triggers re-reading the current query value\n * is delayed by `1ms` so the input's empty state is allowed to propagate.\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query observable\n */\nexport function watchSearchQuery(\n  el: HTMLInputElement, { worker$ }: WatchOptions\n): Observable<SearchQuery> {\n\n  /* Support search deep linking */\n  const { searchParams } = getLocation()\n  if (searchParams.has(\"q\")) {\n    setToggle(\"search\", true)\n\n    /* Set query from parameter */\n    el.value = searchParams.get(\"q\")!\n    el.focus()\n\n    /* Remove query parameter on close */\n    watchToggle(\"search\")\n      .pipe(\n        first(active => !active)\n      )\n        .subscribe(() => {\n          const url = getLocation()\n          url.searchParams.delete(\"q\")\n          history.replaceState({}, \"\", `${url}`)\n        })\n  }\n\n  /* Intercept focus and input events */\n  const focus$ = watchElementFocus(el)\n  const value$ = merge(\n    worker$.pipe(first(isSearchReadyMessage)),\n    fromEvent(el, \"keyup\"),\n    focus$\n  )\n    .pipe(\n      map(() => el.value),\n      distinctUntilChanged()\n    )\n\n  /* Combine into single observable */\n  return combineLatest([value$, focus$])\n    .pipe(\n      map(([value, focus]) => ({ value, focus })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount search query\n *\n * @param el - Search query element\n * @param options - Options\n *\n * @returns Search query component observable\n */\nexport function mountSearchQuery(\n  el: HTMLInputElement, { worker$ }: MountOptions\n): Observable<Component<SearchQuery, HTMLInputElement>> {\n  const push$ = new Subject<SearchQuery>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n\n  /* Handle value change */\n  combineLatest([\n    worker$.pipe(first(isSearchReadyMessage)),\n    push$\n  ], (_, query) => query)\n    .pipe(\n      distinctUntilKeyChanged(\"value\")\n    )\n      .subscribe(({ value }) => worker$.next({\n        type: SearchMessageType.QUERY,\n        data: value\n      }))\n\n  /* Handle focus change */\n  push$\n    .pipe(\n      distinctUntilKeyChanged(\"focus\")\n    )\n      .subscribe(({ focus }) => {\n        if (focus)\n          setToggle(\"search\", focus)\n      })\n\n  /* Handle reset */\n  fromEvent(el.form!, \"reset\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(() => el.focus())\n\n  // Focus search query on label click - note that this is necessary to bring\n  // up the keyboard on iOS and other mobile platforms, as the search dialog is\n  // not visible at first, and programatically focusing an input element must\n  // be triggered by a user interaction - see https://t.ly/Cb30n\n  const label = getElement(\"header [for=__search]\")\n  fromEvent(label, \"click\")\n    .subscribe(() => el.focus())\n\n  /* Create and return component */\n  return watchSearchQuery(el, { worker$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state })),\n      shareReplay(1)\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  bufferCount,\n  filter,\n  finalize,\n  first,\n  fromEvent,\n  map,\n  merge,\n  mergeMap,\n  of,\n  share,\n  skipUntil,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom,\n  zipWith\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n  getElement,\n  getOptionalElement,\n  watchElementBoundary,\n  watchToggle\n} from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchReadyMessage,\n  isSearchResultMessage\n} from \"~/integrations\"\nimport { renderSearchResultItem } from \"~/templates\"\nimport { round } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search result list\n *\n * This function performs a lazy rendering of the search results, depending on\n * the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchResult(\n  el: HTMLElement, { worker$, query$ }: MountOptions\n): Observable<Component<SearchResult>> {\n  const push$ = new Subject<SearchResult>()\n  const boundary$ = watchElementBoundary(el.parentElement!)\n    .pipe(\n      filter(Boolean)\n    )\n\n  /* Retrieve container */\n  const container = el.parentElement!\n\n  /* Retrieve nested components */\n  const meta = getElement(\":scope > :first-child\", el)\n  const list = getElement(\":scope > :last-child\", el)\n\n  /* Reveal to accessibility tree \u2013 see https://bit.ly/3iAA7t8 */\n  watchToggle(\"search\")\n    .subscribe(active => list.setAttribute(\n      \"role\", active ? \"list\" : \"presentation\"\n    ))\n\n  /* Update search result metadata */\n  push$\n    .pipe(\n      withLatestFrom(query$),\n      skipUntil(worker$.pipe(first(isSearchReadyMessage)))\n    )\n      .subscribe(([{ items }, { value }]) => {\n        switch (items.length) {\n\n          /* No results */\n          case 0:\n            meta.textContent = value.length\n              ? translation(\"search.result.none\")\n              : translation(\"search.result.placeholder\")\n            break\n\n          /* One result */\n          case 1:\n            meta.textContent = translation(\"search.result.one\")\n            break\n\n          /* Multiple result */\n          default:\n            const count = round(items.length)\n            meta.textContent = translation(\"search.result.other\", count)\n        }\n      })\n\n  /* Render search result item */\n  const render$ = push$\n    .pipe(\n      tap(() => list.innerHTML = \"\"),\n      switchMap(({ items }) => merge(\n        of(...items.slice(0, 10)),\n        of(...items.slice(10))\n          .pipe(\n            bufferCount(4),\n            zipWith(boundary$),\n            switchMap(([chunk]) => chunk)\n          )\n      )),\n      map(renderSearchResultItem),\n      share()\n    )\n\n  /* Update search result list */\n  render$.subscribe(item => list.appendChild(item))\n  render$\n    .pipe(\n      mergeMap(item => {\n        const details = getOptionalElement(\"details\", item)\n        if (typeof details === \"undefined\")\n          return EMPTY\n\n        /* Keep position of details element stable */\n        return fromEvent(details, \"toggle\")\n          .pipe(\n            takeUntil(push$),\n            map(() => details)\n          )\n      })\n    )\n      .subscribe(details => {\n        if (\n          details.open === false &&\n          details.offsetTop <= container.scrollTop\n        )\n          container.scrollTo({ top: details.offsetTop })\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search sharing\n */\nexport interface SearchShare {\n  url: URL                             /* Deep link for sharing */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  query$: Observable<SearchQuery>      /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search sharing\n *\n * @param _el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing observable\n */\nexport function watchSearchShare(\n  _el: HTMLElement, { query$ }: WatchOptions\n): Observable<SearchShare> {\n  return query$\n    .pipe(\n      map(({ value }) => {\n        const url = getLocation()\n        url.hash = \"\"\n\n        /* Compute readable query strings */\n        value = value\n          .replace(/\\s+/g, \"+\")        /* Collapse whitespace */\n          .replace(/&/g, \"%26\")        /* Escape '&' character */\n          .replace(/=/g, \"%3D\")        /* Escape '=' character */\n\n        /* Replace query string */\n        url.search = `q=${value}`\n        return { url }\n      })\n    )\n}\n\n/**\n * Mount search sharing\n *\n * @param el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing component observable\n */\nexport function mountSearchShare(\n  el: HTMLAnchorElement, options: MountOptions\n): Observable<Component<SearchShare>> {\n  const push$ = new Subject<SearchShare>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe(({ url }) => {\n    el.setAttribute(\"data-clipboard-text\", el.href)\n    el.href = `${url}`\n  })\n\n  /* Prevent following of link */\n  fromEvent(el, \"click\")\n    .pipe(\n      takeUntil(done$)\n    )\n      .subscribe(ev => ev.preventDefault())\n\n  /* Create and return component */\n  return watchSearchShare(el, options)\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  combineLatestWith,\n  distinctUntilChanged,\n  filter,\n  finalize,\n  fromEvent,\n  map,\n  merge,\n  observeOn,\n  tap\n} from \"rxjs\"\n\nimport { Keyboard } from \"~/browser\"\nimport {\n  SearchMessage,\n  SearchResult,\n  isSearchResultMessage\n} from \"~/integrations\"\n\nimport { Component, getComponentElement } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search suggestions\n */\nexport interface SearchSuggest {}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n  worker$: Subject<SearchMessage>      /* Search worker */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search suggestions\n *\n * This function will perform a lazy rendering of the search results, depending\n * on the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchSuggest(\n  el: HTMLElement, { worker$, keyboard$ }: MountOptions\n): Observable<Component<SearchSuggest>> {\n  const push$ = new Subject<SearchResult>()\n\n  /* Retrieve query component and track all changes */\n  const query  = getComponentElement(\"search-query\")\n  const query$ = merge(\n    fromEvent(query, \"keydown\"),\n    fromEvent(query, \"focus\")\n  )\n    .pipe(\n      observeOn(asyncScheduler),\n      map(() => query.value),\n      distinctUntilChanged(),\n    )\n\n  /* Update search suggestions */\n  push$\n    .pipe(\n      combineLatestWith(query$),\n      map(([{ suggest }, value]) => {\n        const words = value.split(/([\\s-]+)/)\n        if (suggest?.length && words[words.length - 1]) {\n          const last = suggest[suggest.length - 1]\n          if (last.startsWith(words[words.length - 1]))\n            words[words.length - 1] = last\n        } else {\n          words.length = 0\n        }\n        return words\n      })\n    )\n      .subscribe(words => el.innerHTML = words\n        .join(\"\")\n        .replace(/\\s/g, \"&nbsp;\")\n      )\n\n  /* Set up search keyboard handlers */\n  keyboard$\n    .pipe(\n      filter(({ mode }) => mode === \"search\")\n    )\n      .subscribe(key => {\n        switch (key.type) {\n\n          /* Right arrow: accept current suggestion */\n          case \"ArrowRight\":\n            if (\n              el.innerText.length &&\n              query.selectionStart === query.value.length\n            )\n              query.value = el.innerText\n            break\n        }\n      })\n\n  /* Filter search result message */\n  const result$ = worker$\n    .pipe(\n      filter(isSearchResultMessage),\n      map(({ data }) => data)\n    )\n\n  /* Create and return component */\n  return result$\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(() => ({ ref: el }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  NEVER,\n  Observable,\n  ObservableInput,\n  filter,\n  fromEvent,\n  merge,\n  mergeWith\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n  Keyboard,\n  getActiveElement,\n  getElements,\n  setToggle\n} from \"~/browser\"\nimport {\n  SearchIndex,\n  SearchResult,\n  setupSearchWorker\n} from \"~/integrations\"\n\nimport {\n  Component,\n  getComponentElement,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SearchQuery,\n  mountSearchQuery\n} from \"../query\"\nimport { mountSearchResult } from \"../result\"\nimport {\n  SearchShare,\n  mountSearchShare\n} from \"../share\"\nimport {\n  SearchSuggest,\n  mountSearchSuggest\n} from \"../suggest\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search\n */\nexport type Search =\n  | SearchQuery\n  | SearchResult\n  | SearchShare\n  | SearchSuggest\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  keyboard$: Observable<Keyboard>      /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search\n *\n * This function sets up the search functionality, including the underlying\n * web worker and all keyboard bindings.\n *\n * @param el - Search element\n * @param options - Options\n *\n * @returns Search component observable\n */\nexport function mountSearch(\n  el: HTMLElement, { index$, keyboard$ }: MountOptions\n): Observable<Component<Search>> {\n  const config = configuration()\n  try {\n    const worker$ = setupSearchWorker(config.search, index$)\n\n    /* Retrieve query and result components */\n    const query  = getComponentElement(\"search-query\", el)\n    const result = getComponentElement(\"search-result\", el)\n\n    /* Always close search on result selection */\n    fromEvent<PointerEvent>(el, \"click\")\n      .pipe(\n        filter(({ target }) => (\n          target instanceof Element && !!target.closest(\"a\")\n        ))\n      )\n        .subscribe(() => setToggle(\"search\", false))\n\n    /* Set up search keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"search\")\n      )\n        .subscribe(key => {\n          const active = getActiveElement()\n          switch (key.type) {\n\n            /* Enter: go to first (best) result */\n            case \"Enter\":\n              if (active === query) {\n                const anchors = new Map<HTMLAnchorElement, number>()\n                for (const anchor of getElements<HTMLAnchorElement>(\n                  \":first-child [href]\", result\n                )) {\n                  const article = anchor.firstElementChild!\n                  anchors.set(anchor, parseFloat(\n                    article.getAttribute(\"data-md-score\")!\n                  ))\n                }\n\n                /* Go to result with highest score, if any */\n                if (anchors.size) {\n                  const [[best]] = [...anchors].sort(([, a], [, b]) => b - a)\n                  best.click()\n                }\n\n                /* Otherwise omit form submission */\n                key.claim()\n              }\n              break\n\n            /* Escape or Tab: close search */\n            case \"Escape\":\n            case \"Tab\":\n              setToggle(\"search\", false)\n              query.blur()\n              break\n\n            /* Vertical arrows: select previous or next search result */\n            case \"ArrowUp\":\n            case \"ArrowDown\":\n              if (typeof active === \"undefined\") {\n                query.focus()\n              } else {\n                const els = [query, ...getElements(\n                  \":not(details) > [href], summary, details[open] [href]\",\n                  result\n                )]\n                const i = Math.max(0, (\n                  Math.max(0, els.indexOf(active)) + els.length + (\n                    key.type === \"ArrowUp\" ? -1 : +1\n                  )\n                ) % els.length)\n                els[i].focus()\n              }\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n\n            /* All other keys: hand to search query */\n            default:\n              if (query !== getActiveElement())\n                query.focus()\n          }\n        })\n\n    /* Set up global keyboard handlers */\n    keyboard$\n      .pipe(\n        filter(({ mode }) => mode === \"global\")\n      )\n        .subscribe(key => {\n          switch (key.type) {\n\n            /* Open search and select query */\n            case \"f\":\n            case \"s\":\n            case \"/\":\n              query.focus()\n              query.select()\n\n              /* Prevent scrolling of page */\n              key.claim()\n              break\n          }\n        })\n\n    /* Create and return component */\n    const query$ = mountSearchQuery(query, { worker$ })\n    return merge(\n      query$,\n      mountSearchResult(result, { worker$, query$ })\n    )\n      .pipe(\n        mergeWith(\n\n          /* Search sharing */\n          ...getComponentElements(\"search-share\", el)\n            .map(child => mountSearchShare(child, { query$ })),\n\n          /* Search suggestions */\n          ...getComponentElements(\"search-suggest\", el)\n            .map(child => mountSearchSuggest(child, { worker$, keyboard$ }))\n        )\n      )\n\n  /* Gracefully handle broken search */\n  } catch (err) {\n    el.hidden = true\n    return NEVER\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  ObservableInput,\n  combineLatest,\n  filter,\n  map,\n  startWith\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\nimport {\n  SearchIndex,\n  setupSearchHighlighter\n} from \"~/integrations\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlighting\n */\nexport interface SearchHighlight {\n  nodes: Map<ChildNode, string>        /* Map of replacements */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  index$: ObservableInput<SearchIndex> /* Search index observable */\n  location$: Observable<URL>           /* Location observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search highlighting\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Search highlighting component observable\n */\nexport function mountSearchHiglight(\n  el: HTMLElement, { index$, location$ }: MountOptions\n): Observable<Component<SearchHighlight>> {\n  return combineLatest([\n    index$,\n    location$\n      .pipe(\n        startWith(getLocation()),\n        filter(url => !!url.searchParams.get(\"h\"))\n      )\n  ])\n    .pipe(\n      map(([index, url]) => setupSearchHighlighter(index.config)(\n        url.searchParams.get(\"h\")!\n      )),\n      map(fn => {\n        const nodes = new Map<ChildNode, string>()\n\n        /* Traverse text nodes and collect matches */\n        const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n        for (let node = it.nextNode(); node; node = it.nextNode()) {\n          if (node.parentElement?.offsetHeight) {\n            const original = node.textContent!\n            const replaced = fn(original)\n            if (replaced.length > original.length)\n              nodes.set(node as ChildNode, replaced)\n          }\n        }\n\n        /* Replace original nodes with matches */\n        for (const [node, text] of nodes) {\n          const { childNodes } = h(\"span\", null, text)\n          node.replaceWith(...Array.from(childNodes))\n        }\n\n        /* Return component */\n        return { ref: el, nodes }\n      })\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  animationFrameScheduler,\n  asyncScheduler,\n  auditTime,\n  combineLatest,\n  defer,\n  distinctUntilChanged,\n  endWith,\n  finalize,\n  first,\n  from,\n  fromEvent,\n  ignoreElements,\n  map,\n  mergeMap,\n  observeOn,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  getElement,\n  getElementOffset,\n  getElementSize,\n  getElements\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sidebar\n */\nexport interface Sidebar {\n  height: number                       /* Sidebar height */\n  locked: boolean                      /* Sidebar is locked */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch sidebar\n *\n * This function returns an observable that computes the visual parameters of\n * the sidebar which depends on the vertical viewport offset, as well as the\n * height of the main area. When the page is scrolled beyond the header, the\n * sidebar is locked and fills the remaining space.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar observable\n */\nexport function watchSidebar(\n  el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable<Sidebar> {\n  const parent = el.closest<HTMLElement>(\".md-grid\")!\n  const adjust =\n    parent.offsetTop -\n    parent.parentElement!.offsetTop\n\n  /* Compute the sidebar's available height and if it should be locked */\n  return combineLatest([main$, viewport$])\n    .pipe(\n      map(([{ offset, height }, { offset: { y } }]) => {\n        height = height\n          + Math.min(adjust, Math.max(0, y - offset))\n          - adjust\n        return {\n          height,\n          locked: y >= offset + adjust\n        }\n      }),\n      distinctUntilChanged((a, b) => (\n        a.height === b.height &&\n        a.locked === b.locked\n      ))\n    )\n}\n\n/**\n * Mount sidebar\n *\n * This function doesn't set the height of the actual sidebar, but of its first\n * child \u2013 the `.md-sidebar__scrollwrap` element in order to mitigiate jittery\n * sidebars when the footer is scrolled into view. At some point we switched\n * from `absolute` / `fixed` positioning to `sticky` positioning, significantly\n * reducing jitter in some browsers (respectively Firefox and Safari) when\n * scrolling from the top. However, top-aligned sticky positioning means that\n * the sidebar snaps to the bottom when the end of the container is reached.\n * This is what leads to the mentioned jitter, as the sidebar's height may be\n * updated too slowly.\n *\n * This behaviour can be mitigiated by setting the height of the sidebar to `0`\n * while preserving the padding, and the height on its first element.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar component observable\n */\nexport function mountSidebar(\n  el: HTMLElement, { header$, ...options }: MountOptions\n): Observable<Component<Sidebar>> {\n  const inner = getElement(\".md-sidebar__scrollwrap\", el)\n  const { y } = getElementOffset(inner)\n  return defer(() => {\n    const push$ = new Subject<Sidebar>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    const next$ = push$\n      .pipe(\n        auditTime(0, animationFrameScheduler)\n      )\n\n    /* Update sidebar height and offset */\n    next$.pipe(withLatestFrom(header$))\n      .subscribe({\n\n        /* Handle emission */\n        next([{ height }, { height: offset }]) {\n          inner.style.height = `${height - 2 * y}px`\n          el.style.top       = `${offset}px`\n        },\n\n        /* Handle complete */\n        complete() {\n          inner.style.height = \"\"\n          el.style.top       = \"\"\n        }\n      })\n\n    /* Bring active item into view on initial load */\n    next$.pipe(first())\n      .subscribe(() => {\n        for (const item of getElements(\".md-nav__link--active[href]\", el)) {\n          if (!item.clientHeight) // skip invisible toc in left sidebar\n            continue\n          const container = item.closest<HTMLElement>(\".md-sidebar__scrollwrap\")!\n          if (typeof container !== \"undefined\") {\n            const offset = item.offsetTop - container.offsetTop\n            const { height } = getElementSize(container)\n            container.scrollTo({\n              top: offset - height / 2\n            })\n          }\n        }\n      })\n\n    /* Handle accessibility for expandable items, see https://bit.ly/3jaod9p */\n    from(getElements<HTMLLabelElement>(\"label[tabindex]\", el))\n      .pipe(\n        mergeMap(label => fromEvent(label, \"click\")\n          .pipe(\n            observeOn(asyncScheduler),\n            map(() => label),\n            takeUntil(done$)\n          )\n        )\n      )\n        .subscribe(label => {\n          const input = getElement<HTMLInputElement>(`[id=\"${label.htmlFor}\"]`)\n          const nav = getElement(`[aria-labelledby=\"${label.id}\"]`)\n          nav.setAttribute(\"aria-expanded\", `${input.checked}`)\n        })\n\n    /* Create and return component */\n    return watchSidebar(el, options)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Repo, User } from \"github-types\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitHub release (partial)\n */\ninterface Release {\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitHub repository facts\n *\n * @param user - GitHub user or organization\n * @param repo - GitHub repository\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitHub(\n  user: string, repo?: string\n): Observable<SourceFacts> {\n  if (typeof repo !== \"undefined\") {\n    const url = `https://api.github.com/repos/${user}/${repo}`\n    return zip(\n\n      /* Fetch version */\n      requestJSON<Release>(`${url}/releases/latest`)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(release => ({\n            version: release.tag_name\n          })),\n          defaultIfEmpty({})\n        ),\n\n      /* Fetch stars and forks */\n      requestJSON<Repo>(url)\n        .pipe(\n          catchError(() => EMPTY), // @todo refactor instant loading\n          map(info => ({\n            stars: info.stargazers_count,\n            forks: info.forks_count\n          })),\n          defaultIfEmpty({})\n        )\n    )\n      .pipe(\n        map(([release, info]) => ({ ...release, ...info }))\n      )\n\n  /* User or organization */\n  } else {\n    const url = `https://api.github.com/users/${user}`\n    return requestJSON<User>(url)\n      .pipe(\n        map(info => ({\n          repositories: info.public_repos\n        })),\n        defaultIfEmpty({})\n      )\n  }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ProjectSchema } from \"gitlab\"\nimport {\n  EMPTY,\n  Observable,\n  catchError,\n  defaultIfEmpty,\n  map,\n  zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitLab release (partial)\n */\ninterface Release { // @todo remove and use the ReleaseSchema type instead after switching from gitlab to @gitbeaker/rest\n  tag_name: string                     /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitLab repository facts\n *\n * @param base - GitLab base\n * @param project - GitLab project\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitLab(\n  base: string, project: string\n): Observable<SourceFacts> {\n  const url = `https://${base}/api/v4/projects/${encodeURIComponent(project)}`\n  return zip(\n\n    /* Fetch version */\n    requestJSON<Release>(`${url}/releases/permalink/latest`)\n      .pipe(\n        catchError(() => EMPTY), // @todo refactor instant loading\n        map(({ tag_name }) => ({\n          version: tag_name\n        })),\n        defaultIfEmpty({})\n      ),\n\n    /* Fetch stars and forks */\n    requestJSON<ProjectSchema>(url)\n      .pipe(\n        catchError(() => EMPTY), // @todo refactor instant loading\n        map(({ star_count, forks_count }) => ({\n          stars: star_count,\n          forks: forks_count\n        })),\n        defaultIfEmpty({})\n      )\n  )\n    .pipe(\n      map(([release, info]) => ({ ...release, ...info }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable } from \"rxjs\"\n\nimport { fetchSourceFactsFromGitHub } from \"../github\"\nimport { fetchSourceFactsFromGitLab } from \"../gitlab\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository facts for repositories\n */\nexport interface RepositoryFacts {\n  stars?: number                       /* Number of stars */\n  forks?: number                       /* Number of forks */\n  version?: string                     /* Latest version */\n}\n\n/**\n * Repository facts for organizations\n */\nexport interface OrganizationFacts {\n  repositories?: number                /* Number of repositories */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Repository facts\n */\nexport type SourceFacts =\n  | RepositoryFacts\n  | OrganizationFacts\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch repository facts\n *\n * @param url - Repository URL\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFacts(\n  url: string\n): Observable<SourceFacts> {\n\n  /* Try to match GitHub repository */\n  let match = url.match(/^.+github\\.com\\/([^/]+)\\/?([^/]+)?/i)\n  if (match) {\n    const [, user, repo] = match\n    return fetchSourceFactsFromGitHub(user, repo)\n  }\n\n  /* Try to match GitLab repository */\n  match = url.match(/^.+?([^/]*gitlab[^/]+)\\/(.+?)\\/?$/i)\n  if (match) {\n    const [, base, slug] = match\n    return fetchSourceFactsFromGitLab(base, slug)\n  }\n\n  /* Fallback */\n  return EMPTY\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  Subject,\n  catchError,\n  defer,\n  filter,\n  finalize,\n  map,\n  of,\n  shareReplay,\n  tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\nimport { ConsentDefaults } from \"~/components/consent\"\nimport { renderSourceFacts } from \"~/templates\"\n\nimport {\n  Component,\n  getComponentElements\n} from \"../../_\"\nimport {\n  SourceFacts,\n  fetchSourceFacts\n} from \"../facts\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information\n */\nexport interface Source {\n  facts: SourceFacts                   /* Repository facts */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information observable\n */\nlet fetch$: Observable<Source>\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch repository information\n *\n * This function tries to read the repository facts from session storage, and\n * if unsuccessful, fetches them from the underlying provider.\n *\n * @param el - Repository information element\n *\n * @returns Repository information observable\n */\nexport function watchSource(\n  el: HTMLAnchorElement\n): Observable<Source> {\n  return fetch$ ||= defer(() => {\n    const cached = __md_get<SourceFacts>(\"__source\", sessionStorage)\n    if (cached) {\n      return of(cached)\n    } else {\n\n      /* Check if consent is configured and was given */\n      const els = getComponentElements(\"consent\")\n      if (els.length) {\n        const consent = __md_get<ConsentDefaults>(\"__consent\")\n        if (!(consent && consent.github))\n          return EMPTY\n      }\n\n      /* Fetch repository facts */\n      return fetchSourceFacts(el.href)\n        .pipe(\n          tap(facts => __md_set(\"__source\", facts, sessionStorage))\n        )\n    }\n  })\n    .pipe(\n      catchError(() => EMPTY),\n      filter(facts => Object.keys(facts).length > 0),\n      map(facts => ({ facts })),\n      shareReplay(1)\n    )\n}\n\n/**\n * Mount repository information\n *\n * @param el - Repository information element\n *\n * @returns Repository information component observable\n */\nexport function mountSource(\n  el: HTMLAnchorElement\n): Observable<Component<Source>> {\n  const inner = getElement(\":scope > :last-child\", el)\n  return defer(() => {\n    const push$ = new Subject<Source>()\n    push$.subscribe(({ facts }) => {\n      inner.appendChild(renderSourceFacts(facts))\n      inner.classList.add(\"md-source__repository--active\")\n    })\n\n    /* Create and return component */\n    return watchSource(el)\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  defer,\n  distinctUntilKeyChanged,\n  finalize,\n  map,\n  of,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  watchElementSize,\n  watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Navigation tabs\n */\nexport interface Tabs {\n  hidden: boolean                      /* Navigation tabs are hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch navigation tabs\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs observable\n */\nexport function watchTabs(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<Tabs> {\n  return watchElementSize(document.body)\n    .pipe(\n      switchMap(() => watchViewportAt(el, { header$, viewport$ })),\n      map(({ offset: { y } }) => {\n        return {\n          hidden: y >= 10\n        }\n      }),\n      distinctUntilKeyChanged(\"hidden\")\n    )\n}\n\n/**\n * Mount navigation tabs\n *\n * This function hides the navigation tabs when scrolling past the threshold\n * and makes them reappear in a nice CSS animation when scrolling back up.\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs component observable\n */\nexport function mountTabs(\n  el: HTMLElement, options: MountOptions\n): Observable<Component<Tabs>> {\n  return defer(() => {\n    const push$ = new Subject<Tabs>()\n    push$.subscribe({\n\n      /* Handle emission */\n      next({ hidden }) {\n        el.hidden = hidden\n      },\n\n      /* Handle complete */\n      complete() {\n        el.hidden = false\n      }\n    })\n\n    /* Create and return component */\n    return (\n      feature(\"navigation.tabs.sticky\")\n        ? of({ hidden: false })\n        : watchTabs(el, options)\n    )\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  asyncScheduler,\n  bufferCount,\n  combineLatestWith,\n  debounceTime,\n  defer,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  filter,\n  finalize,\n  ignoreElements,\n  map,\n  merge,\n  observeOn,\n  of,\n  repeat,\n  scan,\n  share,\n  skip,\n  startWith,\n  switchMap,\n  takeUntil,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElement,\n  getElementContainer,\n  getElementSize,\n  getElements,\n  getLocation,\n  getOptionalElement,\n  watchElementSize\n} from \"~/browser\"\n\nimport {\n  Component,\n  getComponentElement\n} from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Table of contents\n */\nexport interface TableOfContents {\n  prev: HTMLAnchorElement[][]          /* Anchors (previous) */\n  next: HTMLAnchorElement[][]          /* Anchors (next) */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch table of contents\n *\n * This is effectively a scroll spy implementation which will account for the\n * fixed header and automatically re-calculate anchor offsets when the viewport\n * is resized. The returned observable will only emit if the table of contents\n * needs to be repainted.\n *\n * This implementation tracks an anchor element's entire path starting from its\n * level up to the top-most anchor element, e.g. `[h3, h2, h1]`. Although the\n * Material theme currently doesn't make use of this information, it enables\n * the styling of the entire hierarchy through customization.\n *\n * Note that the current anchor is the last item of the `prev` anchor list.\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents observable\n */\nexport function watchTableOfContents(\n  el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable<TableOfContents> {\n  const table = new Map<HTMLAnchorElement, HTMLElement>()\n\n  /* Compute anchor-to-target mapping */\n  const anchors = getElements<HTMLAnchorElement>(\".md-nav__link\", el)\n  for (const anchor of anchors) {\n    const id = decodeURIComponent(anchor.hash.substring(1))\n    const target = getOptionalElement(`[id=\"${id}\"]`)\n    if (typeof target !== \"undefined\")\n      table.set(anchor, target)\n  }\n\n  /* Compute necessary adjustment for header */\n  const adjust$ = header$\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n      map(({ height }) => {\n        const main = getComponentElement(\"main\")\n        const grid = getElement(\":scope > :first-child\", main)\n        return height + 0.8 * (\n          grid.offsetTop -\n          main.offsetTop\n        )\n      }),\n      share()\n    )\n\n  /* Compute partition of previous and next anchors */\n  const partition$ = watchElementSize(document.body)\n    .pipe(\n      distinctUntilKeyChanged(\"height\"),\n\n      /* Build index to map anchor paths to vertical offsets */\n      switchMap(body => defer(() => {\n        let path: HTMLAnchorElement[] = []\n        return of([...table].reduce((index, [anchor, target]) => {\n          while (path.length) {\n            const last = table.get(path[path.length - 1])!\n            if (last.tagName >= target.tagName) {\n              path.pop()\n            } else {\n              break\n            }\n          }\n\n          /* If the current anchor is hidden, continue with its parent */\n          let offset = target.offsetTop\n          while (!offset && target.parentElement) {\n            target = target.parentElement\n            offset = target.offsetTop\n          }\n\n          /* Fix anchor offsets in tables - see https://bit.ly/3CUFOcn */\n          let parent = target.offsetParent as HTMLElement\n          for (; parent; parent = parent.offsetParent as HTMLElement)\n            offset += parent.offsetTop\n\n          /* Map reversed anchor path to vertical offset */\n          return index.set(\n            [...path = [...path, anchor]].reverse(),\n            offset\n          )\n        }, new Map<HTMLAnchorElement[], number>()))\n      })\n        .pipe(\n\n          /* Sort index by vertical offset (see https://bit.ly/30z6QSO) */\n          map(index => new Map([...index].sort(([, a], [, b]) => a - b))),\n          combineLatestWith(adjust$),\n\n          /* Re-compute partition when viewport offset changes */\n          switchMap(([index, adjust]) => viewport$\n            .pipe(\n              scan(([prev, next], { offset: { y }, size }) => {\n                const last = y + size.height >= Math.floor(body.height)\n\n                /* Look forward */\n                while (next.length) {\n                  const [, offset] = next[0]\n                  if (offset - adjust < y || last) {\n                    prev = [...prev, next.shift()!]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Look backward */\n                while (prev.length) {\n                  const [, offset] = prev[prev.length - 1]\n                  if (offset - adjust >= y && !last) {\n                    next = [prev.pop()!, ...next]\n                  } else {\n                    break\n                  }\n                }\n\n                /* Return partition */\n                return [prev, next]\n              }, [[], [...index]]),\n              distinctUntilChanged((a, b) => (\n                a[0] === b[0] &&\n                a[1] === b[1]\n              ))\n            )\n          )\n        )\n      )\n    )\n\n  /* Compute and return anchor list migrations */\n  return partition$\n    .pipe(\n      map(([prev, next]) => ({\n        prev: prev.map(([path]) => path),\n        next: next.map(([path]) => path)\n      })),\n\n      /* Extract anchor list migrations */\n      startWith({ prev: [], next: [] }),\n      bufferCount(2, 1),\n      map(([a, b]) => {\n\n        /* Moving down */\n        if (a.prev.length < b.prev.length) {\n          return {\n            prev: b.prev.slice(Math.max(0, a.prev.length - 1), b.prev.length),\n            next: []\n          }\n\n        /* Moving up */\n        } else {\n          return {\n            prev: b.prev.slice(-1),\n            next: b.next.slice(0, b.next.length - a.next.length)\n          }\n        }\n      })\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount table of contents\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents component observable\n */\nexport function mountTableOfContents(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<TableOfContents>> {\n  return defer(() => {\n    const push$ = new Subject<TableOfContents>()\n    const done$ = push$.pipe(ignoreElements(), endWith(true))\n    push$.subscribe(({ prev, next }) => {\n\n      /* Look forward */\n      for (const [anchor] of next) {\n        anchor.classList.remove(\"md-nav__link--passed\")\n        anchor.classList.remove(\"md-nav__link--active\")\n      }\n\n      /* Look backward */\n      for (const [index, [anchor]] of prev.entries()) {\n        anchor.classList.add(\"md-nav__link--passed\")\n        anchor.classList.toggle(\n          \"md-nav__link--active\",\n          index === prev.length - 1\n        )\n      }\n    })\n\n    /* Set up following, if enabled */\n    if (feature(\"toc.follow\")) {\n\n      /* Toggle smooth scrolling only for anchor clicks */\n      const smooth$ = merge(\n        viewport$.pipe(debounceTime(1), map(() => undefined)),\n        viewport$.pipe(debounceTime(250), map(() => \"smooth\" as const))\n      )\n\n      /* Bring active anchor into view */ // @todo: refactor\n      push$\n        .pipe(\n          filter(({ prev }) => prev.length > 0),\n          combineLatestWith(main$.pipe(observeOn(asyncScheduler))),\n          withLatestFrom(smooth$)\n        )\n          .subscribe(([[{ prev }], behavior]) => {\n            const [anchor] = prev[prev.length - 1]\n            if (anchor.offsetHeight) {\n\n              /* Retrieve overflowing container and scroll */\n              const container = getElementContainer(anchor)\n              if (typeof container !== \"undefined\") {\n                const offset = anchor.offsetTop - container.offsetTop\n                const { height } = getElementSize(container)\n                container.scrollTo({\n                  top: offset - height / 2,\n                  behavior\n                })\n              }\n            }\n          })\n    }\n\n    /* Set up anchor tracking, if enabled */\n    if (feature(\"navigation.tracking\"))\n      viewport$\n        .pipe(\n          takeUntil(done$),\n          distinctUntilKeyChanged(\"offset\"),\n          debounceTime(250),\n          skip(1),\n          takeUntil(target$.pipe(skip(1))),\n          repeat({ delay: 250 }),\n          withLatestFrom(push$)\n        )\n          .subscribe(([, { prev }]) => {\n            const url = getLocation()\n\n            /* Set hash fragment to active anchor */\n            const anchor = prev[prev.length - 1]\n            if (anchor && anchor.length) {\n              const [active] = anchor\n              const { hash } = new URL(active.href)\n              if (url.hash !== hash) {\n                url.hash = hash\n                history.replaceState({}, \"\", `${url}`)\n              }\n\n            /* Reset anchor when at the top */\n            } else {\n              url.hash = \"\"\n              history.replaceState({}, \"\", `${url}`)\n            }\n          })\n\n    /* Create and return component */\n    return watchTableOfContents(el, { viewport$, header$ })\n      .pipe(\n        tap(state => push$.next(state)),\n        finalize(() => push$.complete()),\n        map(state => ({ ref: el, ...state }))\n      )\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  Subject,\n  bufferCount,\n  combineLatest,\n  distinctUntilChanged,\n  distinctUntilKeyChanged,\n  endWith,\n  finalize,\n  fromEvent,\n  ignoreElements,\n  map,\n  repeat,\n  skip,\n  takeUntil,\n  tap\n} from \"rxjs\"\n\nimport { Viewport } from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Back-to-top button\n */\nexport interface BackToTop {\n  hidden: boolean                      /* Back-to-top button is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  header$: Observable<Header>          /* Header observable */\n  main$: Observable<Main>              /* Main area observable */\n  target$: Observable<HTMLElement>     /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch back-to-top\n *\n * @param _el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top observable\n */\nexport function watchBackToTop(\n  _el: HTMLElement, { viewport$, main$, target$ }: WatchOptions\n): Observable<BackToTop> {\n\n  /* Compute direction */\n  const direction$ = viewport$\n    .pipe(\n      map(({ offset: { y } }) => y),\n      bufferCount(2, 1),\n      map(([a, b]) => a > b && b > 0),\n      distinctUntilChanged()\n    )\n\n  /* Compute whether main area is active */\n  const active$ = main$\n    .pipe(\n      map(({ active }) => active)\n    )\n\n  /* Compute threshold for hiding */\n  return combineLatest([active$, direction$])\n    .pipe(\n      map(([active, direction]) => !(active && direction)),\n      distinctUntilChanged(),\n      takeUntil(target$.pipe(skip(1))),\n      endWith(true),\n      repeat({ delay: 250 }),\n      map(hidden => ({ hidden }))\n    )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount back-to-top\n *\n * @param el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top component observable\n */\nexport function mountBackToTop(\n  el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable<Component<BackToTop>> {\n  const push$ = new Subject<BackToTop>()\n  const done$ = push$.pipe(ignoreElements(), endWith(true))\n  push$.subscribe({\n\n    /* Handle emission */\n    next({ hidden }) {\n      el.hidden = hidden\n      if (hidden) {\n        el.setAttribute(\"tabindex\", \"-1\")\n        el.blur()\n      } else {\n        el.removeAttribute(\"tabindex\")\n      }\n    },\n\n    /* Handle complete */\n    complete() {\n      el.style.top = \"\"\n      el.hidden = true\n      el.removeAttribute(\"tabindex\")\n    }\n  })\n\n  /* Watch header height */\n  header$\n    .pipe(\n      takeUntil(done$),\n      distinctUntilKeyChanged(\"height\")\n    )\n      .subscribe(({ height }) => {\n        el.style.top = `${height + 16}px`\n      })\n\n  /* Go back to top */\n  fromEvent(el, \"click\")\n    .subscribe(ev => {\n      ev.preventDefault()\n      window.scrollTo({ top: 0 })\n    })\n\n  /* Create and return component */\n  return watchBackToTop(el, { viewport$, main$, target$ })\n    .pipe(\n      tap(state => push$.next(state)),\n      finalize(() => push$.complete()),\n      map(state => ({ ref: el, ...state }))\n    )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  EMPTY,\n  Observable,\n  filter,\n  finalize,\n  map,\n  mergeMap,\n  skip,\n  switchMap,\n  take,\n  takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n  Viewport,\n  getElements,\n  watchElementVisibility\n} from \"~/browser\"\nimport { mountInlineTooltip2 } from \"~/components/tooltip2\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  viewport$: Observable<Viewport>      /* Viewport observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch ellipsis\n *\n * This function will fetch all elements that are shortened with ellipsis, and\n * filter those which are visible. Once they become visible, they stay in that\n * state, even though they may be hidden again. This optimization is necessary\n * to reduce pressure on the browser, with elements fading in and out of view.\n *\n * @param options - Options\n */\nexport function patchEllipsis(\n  { document$, viewport$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\".md-ellipsis\")),\n      mergeMap(el => watchElementVisibility(el)\n        .pipe(\n          takeUntil(document$.pipe(skip(1))),\n          filter(visible => visible),\n          map(() => el),\n          take(1)\n        )\n      ),\n      filter(el => el.offsetWidth < el.scrollWidth),\n      mergeMap(el => {\n        const text = el.innerText\n        const host = el.closest(\"a\") || el\n        host.title = text\n\n        // Do not mount improved tooltip if feature is disabled\n        if (!feature(\"content.tooltips\"))\n          return EMPTY\n\n        /* Mount tooltip */\n        return mountInlineTooltip2(host, { viewport$ })\n          .pipe(\n            takeUntil(document$.pipe(skip(1))),\n            finalize(() => host.removeAttribute(\"title\"))\n          )\n      })\n    )\n      .subscribe()\n\n  // @todo move this outside of here and fix memleaks\n  if (feature(\"content.tooltips\"))\n    document$\n      .pipe(\n        switchMap(() => getElements(\".md-status\")),\n        mergeMap(el => mountInlineTooltip2(el, { viewport$ }))\n      )\n        .subscribe()\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  takeWhile,\n  tap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch indeterminate checkboxes\n *\n * This function replaces the indeterminate \"pseudo state\" with the actual\n * indeterminate state, which is used to keep navigation always expanded.\n *\n * @param options - Options\n */\nexport function patchIndeterminate(\n  { document$, tablet$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements<HTMLInputElement>(\n        \".md-toggle--indeterminate\"\n      )),\n      tap(el => {\n        el.indeterminate = true\n        el.checked = false\n      }),\n      mergeMap(el => fromEvent(el, \"change\")\n        .pipe(\n          takeWhile(() => el.classList.contains(\"md-toggle--indeterminate\")),\n          map(() => el)\n        )\n      ),\n      withLatestFrom(tablet$)\n    )\n      .subscribe(([el, tablet]) => {\n        el.classList.remove(\"md-toggle--indeterminate\")\n        if (tablet)\n          el.checked = false\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  filter,\n  fromEvent,\n  map,\n  mergeMap,\n  switchMap,\n  tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  document$: Observable<Document>      /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether the given device is an Apple device\n *\n * @returns Test result\n */\nfunction isAppleDevice(): boolean {\n  return /(iPad|iPhone|iPod)/.test(navigator.userAgent)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch all elements with `data-md-scrollfix` attributes\n *\n * This is a year-old patch which ensures that overflow scrolling works at the\n * top and bottom of containers on iOS by ensuring a `1px` scroll offset upon\n * the start of a touch event.\n *\n * @see https://bit.ly/2SCtAOO - Original source\n *\n * @param options - Options\n */\nexport function patchScrollfix(\n  { document$ }: PatchOptions\n): void {\n  document$\n    .pipe(\n      switchMap(() => getElements(\"[data-md-scrollfix]\")),\n      tap(el => el.removeAttribute(\"data-md-scrollfix\")),\n      filter(isAppleDevice),\n      mergeMap(el => fromEvent(el, \"touchstart\")\n        .pipe(\n          map(() => el)\n        )\n      )\n    )\n      .subscribe(el => {\n        const top = el.scrollTop\n\n        /* We're at the top of the container */\n        if (top === 0) {\n          el.scrollTop = 1\n\n        /* We're at the bottom of the container */\n        } else if (top + el.offsetHeight === el.scrollHeight) {\n          el.scrollTop = top - 1\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  Observable,\n  combineLatest,\n  delay,\n  map,\n  of,\n  switchMap,\n  withLatestFrom\n} from \"rxjs\"\n\nimport {\n  Viewport,\n  watchToggle\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n  viewport$: Observable<Viewport>      /* Viewport observable */\n  tablet$: Observable<boolean>         /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch the document body to lock when search is open\n *\n * For mobile and tablet viewports, the search is rendered full screen, which\n * leads to scroll leaking when at the top or bottom of the search result. This\n * function locks the body when the search is in full screen mode, and restores\n * the scroll position when leaving.\n *\n * @param options - Options\n */\nexport function patchScrolllock(\n  { viewport$, tablet$ }: PatchOptions\n): void {\n  combineLatest([watchToggle(\"search\"), tablet$])\n    .pipe(\n      map(([active, tablet]) => active && !tablet),\n      switchMap(active => of(active)\n        .pipe(\n          delay(active ? 400 : 100)\n        )\n      ),\n      withLatestFrom(viewport$)\n    )\n      .subscribe(([active, { offset: { y }}]) => {\n        if (active) {\n          document.body.setAttribute(\"data-md-scrolllock\", \"\")\n          document.body.style.top = `-${y}px`\n        } else {\n          const value = -1 * parseInt(document.body.style.top, 10)\n          document.body.removeAttribute(\"data-md-scrolllock\")\n          document.body.style.top = \"\"\n          if (value)\n            window.scrollTo(0, value)\n        }\n      })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n  Object.entries = function (obj: object) {\n    const data: [string, string][] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push([key, obj[key]])\n\n    /* Return entries */\n    return data\n  }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n  Object.values = function (obj: object) {\n    const data: string[] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push(obj[key])\n\n    /* Return values */\n    return data\n  }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n  /* Polyfill `Element.scrollTo` */\n  if (!Element.prototype.scrollTo)\n    Element.prototype.scrollTo = function (\n      x?: ScrollToOptions | number, y?: number\n    ): void {\n      if (typeof x === \"object\") {\n        this.scrollLeft = x.left!\n        this.scrollTop = x.top!\n      } else {\n        this.scrollLeft = x!\n        this.scrollTop = y!\n      }\n    }\n\n  /* Polyfill `Element.replaceWith` */\n  if (!Element.prototype.replaceWith)\n    Element.prototype.replaceWith = function (\n      ...nodes: Array<string | Node>\n    ): void {\n      const parent = this.parentNode\n      if (parent) {\n        if (nodes.length === 0)\n          parent.removeChild(this)\n\n        /* Replace children and create text nodes */\n        for (let i = nodes.length - 1; i >= 0; i--) {\n          let node = nodes[i]\n          if (typeof node === \"string\")\n            node = document.createTextNode(node)\n          else if (node.parentNode)\n            node.parentNode.removeChild(node)\n\n          /* Replace child or insert before previous sibling */\n          if (!i)\n            parent.replaceChild(node, this)\n          else\n            parent.insertBefore(this.previousSibling!, node)\n        }\n      }\n    }\n}\n"],
+  "mappings": "2rCAAA,IAAAA,GAAAC,GAAA,CAAAC,GAAAC,KAAA,EAAC,SAAUC,EAAQC,EAAS,CAC1B,OAAOH,IAAY,UAAY,OAAOC,IAAW,YAAcE,EAAQ,EACvE,OAAO,QAAW,YAAc,OAAO,IAAM,OAAOA,CAAO,EAC1DA,EAAQ,CACX,GAAEH,GAAO,UAAY,CAAE,aASrB,SAASI,EAA0BC,EAAO,CACxC,IAAIC,EAAmB,GACnBC,EAA0B,GAC1BC,EAAiC,KAEjCC,EAAsB,CACxB,KAAM,GACN,OAAQ,GACR,IAAK,GACL,IAAK,GACL,MAAO,GACP,SAAU,GACV,OAAQ,GACR,KAAM,GACN,MAAO,GACP,KAAM,GACN,KAAM,GACN,SAAU,GACV,iBAAkB,EACpB,EAOA,SAASC,EAAmBC,EAAI,CAC9B,MACE,GAAAA,GACAA,IAAO,UACPA,EAAG,WAAa,QAChBA,EAAG,WAAa,QAChB,cAAeA,GACf,aAAcA,EAAG,UAKrB,CASA,SAASC,EAA8BD,EAAI,CACzC,IAAIE,GAAOF,EAAG,KACVG,GAAUH,EAAG,QAUjB,MARI,GAAAG,KAAY,SAAWL,EAAoBI,EAAI,GAAK,CAACF,EAAG,UAIxDG,KAAY,YAAc,CAACH,EAAG,UAI9BA,EAAG,kBAKT,CAOA,SAASI,EAAqBJ,EAAI,CAC5BA,EAAG,UAAU,SAAS,eAAe,IAGzCA,EAAG,UAAU,IAAI,eAAe,EAChCA,EAAG,aAAa,2BAA4B,EAAE,EAChD,CAOA,SAASK,EAAwBL,EAAI,CAC9BA,EAAG,aAAa,0BAA0B,IAG/CA,EAAG,UAAU,OAAO,eAAe,EACnCA,EAAG,gBAAgB,0BAA0B,EAC/C,CAUA,SAASM,EAAUC,EAAG,CAChBA,EAAE,SAAWA,EAAE,QAAUA,EAAE,UAI3BR,EAAmBL,EAAM,aAAa,GACxCU,EAAqBV,EAAM,aAAa,EAG1CC,EAAmB,GACrB,CAUA,SAASa,EAAcD,EAAG,CACxBZ,EAAmB,EACrB,CASA,SAASc,EAAQF,EAAG,CAEbR,EAAmBQ,EAAE,MAAM,IAI5BZ,GAAoBM,EAA8BM,EAAE,MAAM,IAC5DH,EAAqBG,EAAE,MAAM,CAEjC,CAMA,SAASG,EAAOH,EAAG,CACZR,EAAmBQ,EAAE,MAAM,IAK9BA,EAAE,OAAO,UAAU,SAAS,eAAe,GAC3CA,EAAE,OAAO,aAAa,0BAA0B,KAMhDX,EAA0B,GAC1B,OAAO,aAAaC,CAA8B,EAClDA,EAAiC,OAAO,WAAW,UAAW,CAC5DD,EAA0B,EAC5B,EAAG,GAAG,EACNS,EAAwBE,EAAE,MAAM,EAEpC,CAOA,SAASI,EAAmBJ,EAAG,CACzB,SAAS,kBAAoB,WAK3BX,IACFD,EAAmB,IAErBiB,EAA+B,EAEnC,CAQA,SAASA,GAAiC,CACxC,SAAS,iBAAiB,YAAaC,CAAoB,EAC3D,SAAS,iBAAiB,YAAaA,CAAoB,EAC3D,SAAS,iBAAiB,UAAWA,CAAoB,EACzD,SAAS,iBAAiB,cAAeA,CAAoB,EAC7D,SAAS,iBAAiB,cAAeA,CAAoB,EAC7D,SAAS,iBAAiB,YAAaA,CAAoB,EAC3D,SAAS,iBAAiB,YAAaA,CAAoB,EAC3D,SAAS,iBAAiB,aAAcA,CAAoB,EAC5D,SAAS,iBAAiB,WAAYA,CAAoB,CAC5D,CAEA,SAASC,IAAoC,CAC3C,SAAS,oBAAoB,YAAaD,CAAoB,EAC9D,SAAS,oBAAoB,YAAaA,CAAoB,EAC9D,SAAS,oBAAoB,UAAWA,CAAoB,EAC5D,SAAS,oBAAoB,cAAeA,CAAoB,EAChE,SAAS,oBAAoB,cAAeA,CAAoB,EAChE,SAAS,oBAAoB,YAAaA,CAAoB,EAC9D,SAAS,oBAAoB,YAAaA,CAAoB,EAC9D,SAAS,oBAAoB,aAAcA,CAAoB,EAC/D,SAAS,oBAAoB,WAAYA,CAAoB,CAC/D,CASA,SAASA,EAAqBN,EAAG,CAG3BA,EAAE,OAAO,UAAYA,EAAE,OAAO,SAAS,YAAY,IAAM,SAI7DZ,EAAmB,GACnBmB,GAAkC,EACpC,CAKA,SAAS,iBAAiB,UAAWR,EAAW,EAAI,EACpD,SAAS,iBAAiB,YAAaE,EAAe,EAAI,EAC1D,SAAS,iBAAiB,cAAeA,EAAe,EAAI,EAC5D,SAAS,iBAAiB,aAAcA,EAAe,EAAI,EAC3D,SAAS,iBAAiB,mBAAoBG,EAAoB,EAAI,EAEtEC,EAA+B,EAM/BlB,EAAM,iBAAiB,QAASe,EAAS,EAAI,EAC7Cf,EAAM,iBAAiB,OAAQgB,EAAQ,EAAI,EAOvChB,EAAM,WAAa,KAAK,wBAA0BA,EAAM,KAI1DA,EAAM,KAAK,aAAa,wBAAyB,EAAE,EAC1CA,EAAM,WAAa,KAAK,gBACjC,SAAS,gBAAgB,UAAU,IAAI,kBAAkB,EACzD,SAAS,gBAAgB,aAAa,wBAAyB,EAAE,EAErE,CAKA,GAAI,OAAO,QAAW,aAAe,OAAO,UAAa,YAAa,CAIpE,OAAO,0BAA4BD,EAInC,IAAIsB,EAEJ,GAAI,CACFA,EAAQ,IAAI,YAAY,8BAA8B,CACxD,OAASC,EAAO,CAEdD,EAAQ,SAAS,YAAY,aAAa,EAC1CA,EAAM,gBAAgB,+BAAgC,GAAO,GAAO,CAAC,CAAC,CACxE,CAEA,OAAO,cAAcA,CAAK,CAC5B,CAEI,OAAO,UAAa,aAGtBtB,EAA0B,QAAQ,CAGtC,CAAE,ICvTF,IAAAwB,GAAAC,GAAA,CAAAC,GAAAC,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAeA,IAAIC,GAAkB,UAOtBD,GAAO,QAAUE,GAUjB,SAASA,GAAWC,EAAQ,CAC1B,IAAIC,EAAM,GAAKD,EACXE,EAAQJ,GAAgB,KAAKG,CAAG,EAEpC,GAAI,CAACC,EACH,OAAOD,EAGT,IAAIE,EACAC,EAAO,GACPC,EAAQ,EACRC,EAAY,EAEhB,IAAKD,EAAQH,EAAM,MAAOG,EAAQJ,EAAI,OAAQI,IAAS,CACrD,OAAQJ,EAAI,WAAWI,CAAK,EAAG,CAC7B,IAAK,IACHF,EAAS,SACT,MACF,IAAK,IACHA,EAAS,QACT,MACF,IAAK,IACHA,EAAS,QACT,MACF,IAAK,IACHA,EAAS,OACT,MACF,IAAK,IACHA,EAAS,OACT,MACF,QACE,QACJ,CAEIG,IAAcD,IAChBD,GAAQH,EAAI,UAAUK,EAAWD,CAAK,GAGxCC,EAAYD,EAAQ,EACpBD,GAAQD,CACV,CAEA,OAAOG,IAAcD,EACjBD,EAAOH,EAAI,UAAUK,EAAWD,CAAK,EACrCD,CACN,IC7EA,IAAAG,GAAAC,GAAA,CAAAC,GAAAC,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMC,SAA0CC,EAAMC,EAAS,CACtD,OAAOH,IAAY,UAAY,OAAOC,IAAW,SACnDA,GAAO,QAAUE,EAAQ,EAClB,OAAO,QAAW,YAAc,OAAO,IAC9C,OAAO,CAAC,EAAGA,CAAO,EACX,OAAOH,IAAY,SAC1BA,GAAQ,YAAiBG,EAAQ,EAEjCD,EAAK,YAAiBC,EAAQ,CAChC,GAAGH,GAAM,UAAW,CACpB,OAAiB,UAAW,CAClB,IAAII,EAAuB,CAE/B,IACC,SAASC,EAAyBC,EAAqBC,EAAqB,CAEnF,aAGAA,EAAoB,EAAED,EAAqB,CACzC,QAAW,UAAW,CAAE,OAAqBE,EAAW,CAC1D,CAAC,EAGD,IAAIC,EAAeF,EAAoB,GAAG,EACtCG,EAAoCH,EAAoB,EAAEE,CAAY,EAEtEE,EAASJ,EAAoB,GAAG,EAChCK,EAA8BL,EAAoB,EAAEI,CAAM,EAE1DE,EAAaN,EAAoB,GAAG,EACpCO,EAA8BP,EAAoB,EAAEM,CAAU,EAOlE,SAASE,EAAQC,EAAM,CACrB,GAAI,CACF,OAAO,SAAS,YAAYA,CAAI,CAClC,OAASC,EAAK,CACZ,MAAO,EACT,CACF,CAUA,IAAIC,EAAqB,SAA4BC,EAAQ,CAC3D,IAAIC,EAAeN,EAAe,EAAEK,CAAM,EAC1C,OAAAJ,EAAQ,KAAK,EACNK,CACT,EAEiCC,EAAeH,EAOhD,SAASI,EAAkBC,EAAO,CAChC,IAAIC,EAAQ,SAAS,gBAAgB,aAAa,KAAK,IAAM,MACzDC,EAAc,SAAS,cAAc,UAAU,EAEnDA,EAAY,MAAM,SAAW,OAE7BA,EAAY,MAAM,OAAS,IAC3BA,EAAY,MAAM,QAAU,IAC5BA,EAAY,MAAM,OAAS,IAE3BA,EAAY,MAAM,SAAW,WAC7BA,EAAY,MAAMD,EAAQ,QAAU,MAAM,EAAI,UAE9C,IAAIE,EAAY,OAAO,aAAe,SAAS,gBAAgB,UAC/D,OAAAD,EAAY,MAAM,IAAM,GAAG,OAAOC,EAAW,IAAI,EACjDD,EAAY,aAAa,WAAY,EAAE,EACvCA,EAAY,MAAQF,EACbE,CACT,CAYA,IAAIE,EAAiB,SAAwBJ,EAAOK,EAAS,CAC3D,IAAIH,EAAcH,EAAkBC,CAAK,EACzCK,EAAQ,UAAU,YAAYH,CAAW,EACzC,IAAIL,EAAeN,EAAe,EAAEW,CAAW,EAC/C,OAAAV,EAAQ,MAAM,EACdU,EAAY,OAAO,EACZL,CACT,EASIS,GAAsB,SAA6BV,EAAQ,CAC7D,IAAIS,EAAU,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAChF,UAAW,SAAS,IACtB,EACIR,EAAe,GAEnB,OAAI,OAAOD,GAAW,SACpBC,EAAeO,EAAeR,EAAQS,CAAO,EACpCT,aAAkB,kBAAoB,CAAC,CAAC,OAAQ,SAAU,MAAO,MAAO,UAAU,EAAE,SAASA,GAAW,KAA4B,OAASA,EAAO,IAAI,EAEjKC,EAAeO,EAAeR,EAAO,MAAOS,CAAO,GAEnDR,EAAeN,EAAe,EAAEK,CAAM,EACtCJ,EAAQ,MAAM,GAGTK,CACT,EAEiCU,EAAgBD,GAEjD,SAASE,EAAQC,EAAK,CAAE,0BAA2B,OAAI,OAAO,QAAW,YAAc,OAAO,OAAO,UAAa,SAAYD,EAAU,SAAiBC,EAAK,CAAE,OAAO,OAAOA,CAAK,EAAYD,EAAU,SAAiBC,EAAK,CAAE,OAAOA,GAAO,OAAO,QAAW,YAAcA,EAAI,cAAgB,QAAUA,IAAQ,OAAO,UAAY,SAAW,OAAOA,CAAK,EAAYD,EAAQC,CAAG,CAAG,CAUzX,IAAIC,GAAyB,UAAkC,CAC7D,IAAIL,EAAU,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAAC,EAE/EM,EAAkBN,EAAQ,OAC1BO,EAASD,IAAoB,OAAS,OAASA,EAC/CE,EAAYR,EAAQ,UACpBT,EAASS,EAAQ,OACjBS,GAAOT,EAAQ,KAEnB,GAAIO,IAAW,QAAUA,IAAW,MAClC,MAAM,IAAI,MAAM,oDAAoD,EAItE,GAAIhB,IAAW,OACb,GAAIA,GAAUY,EAAQZ,CAAM,IAAM,UAAYA,EAAO,WAAa,EAAG,CACnE,GAAIgB,IAAW,QAAUhB,EAAO,aAAa,UAAU,EACrD,MAAM,IAAI,MAAM,mFAAmF,EAGrG,GAAIgB,IAAW,QAAUhB,EAAO,aAAa,UAAU,GAAKA,EAAO,aAAa,UAAU,GACxF,MAAM,IAAI,MAAM,uGAAwG,CAE5H,KACE,OAAM,IAAI,MAAM,6CAA6C,EAKjE,GAAIkB,GACF,OAAOP,EAAaO,GAAM,CACxB,UAAWD,CACb,CAAC,EAIH,GAAIjB,EACF,OAAOgB,IAAW,MAAQd,EAAYF,CAAM,EAAIW,EAAaX,EAAQ,CACnE,UAAWiB,CACb,CAAC,CAEL,EAEiCE,GAAmBL,GAEpD,SAASM,GAAiBP,EAAK,CAAE,0BAA2B,OAAI,OAAO,QAAW,YAAc,OAAO,OAAO,UAAa,SAAYO,GAAmB,SAAiBP,EAAK,CAAE,OAAO,OAAOA,CAAK,EAAYO,GAAmB,SAAiBP,EAAK,CAAE,OAAOA,GAAO,OAAO,QAAW,YAAcA,EAAI,cAAgB,QAAUA,IAAQ,OAAO,UAAY,SAAW,OAAOA,CAAK,EAAYO,GAAiBP,CAAG,CAAG,CAE7Z,SAASQ,GAAgBC,EAAUC,EAAa,CAAE,GAAI,EAAED,aAAoBC,GAAgB,MAAM,IAAI,UAAU,mCAAmC,CAAK,CAExJ,SAASC,GAAkBxB,EAAQyB,EAAO,CAAE,QAASC,EAAI,EAAGA,EAAID,EAAM,OAAQC,IAAK,CAAE,IAAIC,EAAaF,EAAMC,CAAC,EAAGC,EAAW,WAAaA,EAAW,YAAc,GAAOA,EAAW,aAAe,GAAU,UAAWA,IAAYA,EAAW,SAAW,IAAM,OAAO,eAAe3B,EAAQ2B,EAAW,IAAKA,CAAU,CAAG,CAAE,CAE5T,SAASC,GAAaL,EAAaM,EAAYC,EAAa,CAAE,OAAID,GAAYL,GAAkBD,EAAY,UAAWM,CAAU,EAAOC,GAAaN,GAAkBD,EAAaO,CAAW,EAAUP,CAAa,CAEtN,SAASQ,GAAUC,EAAUC,EAAY,CAAE,GAAI,OAAOA,GAAe,YAAcA,IAAe,KAAQ,MAAM,IAAI,UAAU,oDAAoD,EAAKD,EAAS,UAAY,OAAO,OAAOC,GAAcA,EAAW,UAAW,CAAE,YAAa,CAAE,MAAOD,EAAU,SAAU,GAAM,aAAc,EAAK,CAAE,CAAC,EAAOC,GAAYC,GAAgBF,EAAUC,CAAU,CAAG,CAEhY,SAASC,GAAgBC,EAAGC,EAAG,CAAE,OAAAF,GAAkB,OAAO,gBAAkB,SAAyBC,EAAGC,EAAG,CAAE,OAAAD,EAAE,UAAYC,EAAUD,CAAG,EAAUD,GAAgBC,EAAGC,CAAC,CAAG,CAEzK,SAASC,GAAaC,EAAS,CAAE,IAAIC,EAA4BC,GAA0B,EAAG,OAAO,UAAgC,CAAE,IAAIC,EAAQC,GAAgBJ,CAAO,EAAGK,EAAQ,GAAIJ,EAA2B,CAAE,IAAIK,EAAYF,GAAgB,IAAI,EAAE,YAAaC,EAAS,QAAQ,UAAUF,EAAO,UAAWG,CAAS,CAAG,MAASD,EAASF,EAAM,MAAM,KAAM,SAAS,EAAK,OAAOI,GAA2B,KAAMF,CAAM,CAAG,CAAG,CAExa,SAASE,GAA2BC,EAAMC,EAAM,CAAE,OAAIA,IAAS3B,GAAiB2B,CAAI,IAAM,UAAY,OAAOA,GAAS,YAAsBA,EAAeC,GAAuBF,CAAI,CAAG,CAEzL,SAASE,GAAuBF,EAAM,CAAE,GAAIA,IAAS,OAAU,MAAM,IAAI,eAAe,2DAA2D,EAAK,OAAOA,CAAM,CAErK,SAASN,IAA4B,CAA0E,GAApE,OAAO,SAAY,aAAe,CAAC,QAAQ,WAA6B,QAAQ,UAAU,KAAM,MAAO,GAAO,GAAI,OAAO,OAAU,WAAY,MAAO,GAAM,GAAI,CAAE,YAAK,UAAU,SAAS,KAAK,QAAQ,UAAU,KAAM,CAAC,EAAG,UAAY,CAAC,CAAC,CAAC,EAAU,EAAM,OAASS,EAAG,CAAE,MAAO,EAAO,CAAE,CAEnU,SAASP,GAAgBP,EAAG,CAAE,OAAAO,GAAkB,OAAO,eAAiB,OAAO,eAAiB,SAAyBP,EAAG,CAAE,OAAOA,EAAE,WAAa,OAAO,eAAeA,CAAC,CAAG,EAAUO,GAAgBP,CAAC,CAAG,CAa5M,SAASe,GAAkBC,EAAQC,EAAS,CAC1C,IAAIC,EAAY,kBAAkB,OAAOF,CAAM,EAE/C,GAAKC,EAAQ,aAAaC,CAAS,EAInC,OAAOD,EAAQ,aAAaC,CAAS,CACvC,CAOA,IAAIC,GAAyB,SAAUC,EAAU,CAC/CxB,GAAUuB,EAAWC,CAAQ,EAE7B,IAAIC,EAASnB,GAAaiB,CAAS,EAMnC,SAASA,EAAUG,EAAShD,EAAS,CACnC,IAAIiD,EAEJ,OAAArC,GAAgB,KAAMiC,CAAS,EAE/BI,EAAQF,EAAO,KAAK,IAAI,EAExBE,EAAM,eAAejD,CAAO,EAE5BiD,EAAM,YAAYD,CAAO,EAElBC,CACT,CAQA,OAAA9B,GAAa0B,EAAW,CAAC,CACvB,IAAK,iBACL,MAAO,UAA0B,CAC/B,IAAI7C,EAAU,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAAC,EACnF,KAAK,OAAS,OAAOA,EAAQ,QAAW,WAAaA,EAAQ,OAAS,KAAK,cAC3E,KAAK,OAAS,OAAOA,EAAQ,QAAW,WAAaA,EAAQ,OAAS,KAAK,cAC3E,KAAK,KAAO,OAAOA,EAAQ,MAAS,WAAaA,EAAQ,KAAO,KAAK,YACrE,KAAK,UAAYW,GAAiBX,EAAQ,SAAS,IAAM,SAAWA,EAAQ,UAAY,SAAS,IACnG,CAMF,EAAG,CACD,IAAK,cACL,MAAO,SAAqBgD,EAAS,CACnC,IAAIE,EAAS,KAEb,KAAK,SAAWlE,EAAe,EAAEgE,EAAS,QAAS,SAAUR,GAAG,CAC9D,OAAOU,EAAO,QAAQV,EAAC,CACzB,CAAC,CACH,CAMF,EAAG,CACD,IAAK,UACL,MAAO,SAAiBA,EAAG,CACzB,IAAIQ,EAAUR,EAAE,gBAAkBA,EAAE,cAChCjC,GAAS,KAAK,OAAOyC,CAAO,GAAK,OACjCvC,GAAOC,GAAgB,CACzB,OAAQH,GACR,UAAW,KAAK,UAChB,OAAQ,KAAK,OAAOyC,CAAO,EAC3B,KAAM,KAAK,KAAKA,CAAO,CACzB,CAAC,EAED,KAAK,KAAKvC,GAAO,UAAY,QAAS,CACpC,OAAQF,GACR,KAAME,GACN,QAASuC,EACT,eAAgB,UAA0B,CACpCA,GACFA,EAAQ,MAAM,EAGhB,OAAO,aAAa,EAAE,gBAAgB,CACxC,CACF,CAAC,CACH,CAMF,EAAG,CACD,IAAK,gBACL,MAAO,SAAuBA,EAAS,CACrC,OAAOP,GAAkB,SAAUO,CAAO,CAC5C,CAMF,EAAG,CACD,IAAK,gBACL,MAAO,SAAuBA,EAAS,CACrC,IAAIG,EAAWV,GAAkB,SAAUO,CAAO,EAElD,GAAIG,EACF,OAAO,SAAS,cAAcA,CAAQ,CAE1C,CAQF,EAAG,CACD,IAAK,cAML,MAAO,SAAqBH,EAAS,CACnC,OAAOP,GAAkB,OAAQO,CAAO,CAC1C,CAKF,EAAG,CACD,IAAK,UACL,MAAO,UAAmB,CACxB,KAAK,SAAS,QAAQ,CACxB,CACF,CAAC,EAAG,CAAC,CACH,IAAK,OACL,MAAO,SAAczD,EAAQ,CAC3B,IAAIS,EAAU,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAChF,UAAW,SAAS,IACtB,EACA,OAAOE,EAAaX,EAAQS,CAAO,CACrC,CAOF,EAAG,CACD,IAAK,MACL,MAAO,SAAaT,EAAQ,CAC1B,OAAOE,EAAYF,CAAM,CAC3B,CAOF,EAAG,CACD,IAAK,cACL,MAAO,UAAuB,CAC5B,IAAIgB,EAAS,UAAU,OAAS,GAAK,UAAU,CAAC,IAAM,OAAY,UAAU,CAAC,EAAI,CAAC,OAAQ,KAAK,EAC3F6C,EAAU,OAAO7C,GAAW,SAAW,CAACA,CAAM,EAAIA,EAClD8C,GAAU,CAAC,CAAC,SAAS,sBACzB,OAAAD,EAAQ,QAAQ,SAAU7C,GAAQ,CAChC8C,GAAUA,IAAW,CAAC,CAAC,SAAS,sBAAsB9C,EAAM,CAC9D,CAAC,EACM8C,EACT,CACF,CAAC,CAAC,EAEKR,CACT,EAAG/D,EAAqB,CAAE,EAEOF,GAAaiE,EAExC,EAEA,IACC,SAASxE,EAAQ,CAExB,IAAIiF,EAAqB,EAKzB,GAAI,OAAO,SAAY,aAAe,CAAC,QAAQ,UAAU,QAAS,CAC9D,IAAIC,EAAQ,QAAQ,UAEpBA,EAAM,QAAUA,EAAM,iBACNA,EAAM,oBACNA,EAAM,mBACNA,EAAM,kBACNA,EAAM,qBAC1B,CASA,SAASC,EAASb,EAASQ,EAAU,CACjC,KAAOR,GAAWA,EAAQ,WAAaW,GAAoB,CACvD,GAAI,OAAOX,EAAQ,SAAY,YAC3BA,EAAQ,QAAQQ,CAAQ,EAC1B,OAAOR,EAETA,EAAUA,EAAQ,UACtB,CACJ,CAEAtE,EAAO,QAAUmF,CAGX,EAEA,IACC,SAASnF,EAAQoF,EAA0B9E,EAAqB,CAEvE,IAAI6E,EAAU7E,EAAoB,GAAG,EAYrC,SAAS+E,EAAUf,EAASQ,EAAU/D,EAAMuE,EAAUC,EAAY,CAC9D,IAAIC,EAAaC,EAAS,MAAM,KAAM,SAAS,EAE/C,OAAAnB,EAAQ,iBAAiBvD,EAAMyE,EAAYD,CAAU,EAE9C,CACH,QAAS,UAAW,CAChBjB,EAAQ,oBAAoBvD,EAAMyE,EAAYD,CAAU,CAC5D,CACJ,CACJ,CAYA,SAASG,EAASC,EAAUb,EAAU/D,EAAMuE,EAAUC,EAAY,CAE9D,OAAI,OAAOI,EAAS,kBAAqB,WAC9BN,EAAU,MAAM,KAAM,SAAS,EAItC,OAAOtE,GAAS,WAGTsE,EAAU,KAAK,KAAM,QAAQ,EAAE,MAAM,KAAM,SAAS,GAI3D,OAAOM,GAAa,WACpBA,EAAW,SAAS,iBAAiBA,CAAQ,GAI1C,MAAM,UAAU,IAAI,KAAKA,EAAU,SAAUrB,EAAS,CACzD,OAAOe,EAAUf,EAASQ,EAAU/D,EAAMuE,EAAUC,CAAU,CAClE,CAAC,EACL,CAWA,SAASE,EAASnB,EAASQ,EAAU/D,EAAMuE,EAAU,CACjD,OAAO,SAASnB,EAAG,CACfA,EAAE,eAAiBgB,EAAQhB,EAAE,OAAQW,CAAQ,EAEzCX,EAAE,gBACFmB,EAAS,KAAKhB,EAASH,CAAC,CAEhC,CACJ,CAEAnE,EAAO,QAAU0F,CAGX,EAEA,IACC,SAAStF,EAAyBL,EAAS,CAQlDA,EAAQ,KAAO,SAASuB,EAAO,CAC3B,OAAOA,IAAU,QACVA,aAAiB,aACjBA,EAAM,WAAa,CAC9B,EAQAvB,EAAQ,SAAW,SAASuB,EAAO,CAC/B,IAAIP,EAAO,OAAO,UAAU,SAAS,KAAKO,CAAK,EAE/C,OAAOA,IAAU,SACTP,IAAS,qBAAuBA,IAAS,4BACzC,WAAYO,IACZA,EAAM,SAAW,GAAKvB,EAAQ,KAAKuB,EAAM,CAAC,CAAC,EACvD,EAQAvB,EAAQ,OAAS,SAASuB,EAAO,CAC7B,OAAO,OAAOA,GAAU,UACjBA,aAAiB,MAC5B,EAQAvB,EAAQ,GAAK,SAASuB,EAAO,CACzB,IAAIP,EAAO,OAAO,UAAU,SAAS,KAAKO,CAAK,EAE/C,OAAOP,IAAS,mBACpB,CAGM,EAEA,IACC,SAASf,EAAQoF,EAA0B9E,EAAqB,CAEvE,IAAIsF,EAAKtF,EAAoB,GAAG,EAC5BoF,EAAWpF,EAAoB,GAAG,EAWtC,SAASI,EAAOQ,EAAQH,EAAMuE,EAAU,CACpC,GAAI,CAACpE,GAAU,CAACH,GAAQ,CAACuE,EACrB,MAAM,IAAI,MAAM,4BAA4B,EAGhD,GAAI,CAACM,EAAG,OAAO7E,CAAI,EACf,MAAM,IAAI,UAAU,kCAAkC,EAG1D,GAAI,CAAC6E,EAAG,GAAGN,CAAQ,EACf,MAAM,IAAI,UAAU,mCAAmC,EAG3D,GAAIM,EAAG,KAAK1E,CAAM,EACd,OAAO2E,EAAW3E,EAAQH,EAAMuE,CAAQ,EAEvC,GAAIM,EAAG,SAAS1E,CAAM,EACvB,OAAO4E,EAAe5E,EAAQH,EAAMuE,CAAQ,EAE3C,GAAIM,EAAG,OAAO1E,CAAM,EACrB,OAAO6E,EAAe7E,EAAQH,EAAMuE,CAAQ,EAG5C,MAAM,IAAI,UAAU,2EAA2E,CAEvG,CAWA,SAASO,EAAWG,EAAMjF,EAAMuE,EAAU,CACtC,OAAAU,EAAK,iBAAiBjF,EAAMuE,CAAQ,EAE7B,CACH,QAAS,UAAW,CAChBU,EAAK,oBAAoBjF,EAAMuE,CAAQ,CAC3C,CACJ,CACJ,CAWA,SAASQ,EAAeG,EAAUlF,EAAMuE,EAAU,CAC9C,aAAM,UAAU,QAAQ,KAAKW,EAAU,SAASD,EAAM,CAClDA,EAAK,iBAAiBjF,EAAMuE,CAAQ,CACxC,CAAC,EAEM,CACH,QAAS,UAAW,CAChB,MAAM,UAAU,QAAQ,KAAKW,EAAU,SAASD,EAAM,CAClDA,EAAK,oBAAoBjF,EAAMuE,CAAQ,CAC3C,CAAC,CACL,CACJ,CACJ,CAWA,SAASS,EAAejB,EAAU/D,EAAMuE,EAAU,CAC9C,OAAOI,EAAS,SAAS,KAAMZ,EAAU/D,EAAMuE,CAAQ,CAC3D,CAEAtF,EAAO,QAAUU,CAGX,EAEA,IACC,SAASV,EAAQ,CAExB,SAASkG,EAAO5B,EAAS,CACrB,IAAInD,EAEJ,GAAImD,EAAQ,WAAa,SACrBA,EAAQ,MAAM,EAEdnD,EAAemD,EAAQ,cAElBA,EAAQ,WAAa,SAAWA,EAAQ,WAAa,WAAY,CACtE,IAAI6B,EAAa7B,EAAQ,aAAa,UAAU,EAE3C6B,GACD7B,EAAQ,aAAa,WAAY,EAAE,EAGvCA,EAAQ,OAAO,EACfA,EAAQ,kBAAkB,EAAGA,EAAQ,MAAM,MAAM,EAE5C6B,GACD7B,EAAQ,gBAAgB,UAAU,EAGtCnD,EAAemD,EAAQ,KAC3B,KACK,CACGA,EAAQ,aAAa,iBAAiB,GACtCA,EAAQ,MAAM,EAGlB,IAAI8B,EAAY,OAAO,aAAa,EAChCC,EAAQ,SAAS,YAAY,EAEjCA,EAAM,mBAAmB/B,CAAO,EAChC8B,EAAU,gBAAgB,EAC1BA,EAAU,SAASC,CAAK,EAExBlF,EAAeiF,EAAU,SAAS,CACtC,CAEA,OAAOjF,CACX,CAEAnB,EAAO,QAAUkG,CAGX,EAEA,IACC,SAASlG,EAAQ,CAExB,SAASsG,GAAK,CAGd,CAEAA,EAAE,UAAY,CACZ,GAAI,SAAUC,EAAMjB,EAAUkB,EAAK,CACjC,IAAIrC,EAAI,KAAK,IAAM,KAAK,EAAI,CAAC,GAE7B,OAACA,EAAEoC,CAAI,IAAMpC,EAAEoC,CAAI,EAAI,CAAC,IAAI,KAAK,CAC/B,GAAIjB,EACJ,IAAKkB,CACP,CAAC,EAEM,IACT,EAEA,KAAM,SAAUD,EAAMjB,EAAUkB,EAAK,CACnC,IAAIxC,EAAO,KACX,SAASyB,GAAY,CACnBzB,EAAK,IAAIuC,EAAMd,CAAQ,EACvBH,EAAS,MAAMkB,EAAK,SAAS,CAC/B,CAEA,OAAAf,EAAS,EAAIH,EACN,KAAK,GAAGiB,EAAMd,EAAUe,CAAG,CACpC,EAEA,KAAM,SAAUD,EAAM,CACpB,IAAIE,EAAO,CAAC,EAAE,MAAM,KAAK,UAAW,CAAC,EACjCC,IAAW,KAAK,IAAM,KAAK,EAAI,CAAC,IAAIH,CAAI,GAAK,CAAC,GAAG,MAAM,EACvD3D,EAAI,EACJ+D,EAAMD,EAAO,OAEjB,IAAK9D,EAAGA,EAAI+D,EAAK/D,IACf8D,EAAO9D,CAAC,EAAE,GAAG,MAAM8D,EAAO9D,CAAC,EAAE,IAAK6D,CAAI,EAGxC,OAAO,IACT,EAEA,IAAK,SAAUF,EAAMjB,EAAU,CAC7B,IAAInB,EAAI,KAAK,IAAM,KAAK,EAAI,CAAC,GACzByC,EAAOzC,EAAEoC,CAAI,EACbM,EAAa,CAAC,EAElB,GAAID,GAAQtB,EACV,QAAS1C,EAAI,EAAG+D,EAAMC,EAAK,OAAQhE,EAAI+D,EAAK/D,IACtCgE,EAAKhE,CAAC,EAAE,KAAO0C,GAAYsB,EAAKhE,CAAC,EAAE,GAAG,IAAM0C,GAC9CuB,EAAW,KAAKD,EAAKhE,CAAC,CAAC,EAQ7B,OAACiE,EAAW,OACR1C,EAAEoC,CAAI,EAAIM,EACV,OAAO1C,EAAEoC,CAAI,EAEV,IACT,CACF,EAEAvG,EAAO,QAAUsG,EACjBtG,EAAO,QAAQ,YAAcsG,CAGvB,CAEI,EAGIQ,EAA2B,CAAC,EAGhC,SAASxG,EAAoByG,EAAU,CAEtC,GAAGD,EAAyBC,CAAQ,EACnC,OAAOD,EAAyBC,CAAQ,EAAE,QAG3C,IAAI/G,EAAS8G,EAAyBC,CAAQ,EAAI,CAGjD,QAAS,CAAC,CACX,EAGA,OAAA5G,EAAoB4G,CAAQ,EAAE/G,EAAQA,EAAO,QAASM,CAAmB,EAGlEN,EAAO,OACf,CAIA,OAAC,UAAW,CAEXM,EAAoB,EAAI,SAASN,EAAQ,CACxC,IAAIgH,EAAShH,GAAUA,EAAO,WAC7B,UAAW,CAAE,OAAOA,EAAO,OAAY,EACvC,UAAW,CAAE,OAAOA,CAAQ,EAC7B,OAAAM,EAAoB,EAAE0G,EAAQ,CAAE,EAAGA,CAAO,CAAC,EACpCA,CACR,CACD,EAAE,EAGD,UAAW,CAEX1G,EAAoB,EAAI,SAASP,EAASkH,EAAY,CACrD,QAAQC,KAAOD,EACX3G,EAAoB,EAAE2G,EAAYC,CAAG,GAAK,CAAC5G,EAAoB,EAAEP,EAASmH,CAAG,GAC/E,OAAO,eAAenH,EAASmH,EAAK,CAAE,WAAY,GAAM,IAAKD,EAAWC,CAAG,CAAE,CAAC,CAGjF,CACD,EAAE,EAGD,UAAW,CACX5G,EAAoB,EAAI,SAASyB,EAAKoF,EAAM,CAAE,OAAO,OAAO,UAAU,eAAe,KAAKpF,EAAKoF,CAAI,CAAG,CACvG,EAAE,EAMK7G,EAAoB,GAAG,CAC/B,EAAG,EACX,OACD,CAAC,ICn2BD,IAAA8G,GAAO,SCNP,IAAIC,GAAgB,SAASC,EAAGC,EAAG,CACjC,OAAAF,GAAgB,OAAO,gBAClB,CAAE,UAAW,CAAC,CAAE,YAAa,OAAS,SAAUC,EAAGC,EAAG,CAAED,EAAE,UAAYC,CAAG,GAC1E,SAAUD,EAAGC,EAAG,CAAE,QAASC,KAAKD,EAAO,OAAO,UAAU,eAAe,KAAKA,EAAGC,CAAC,IAAGF,EAAEE,CAAC,EAAID,EAAEC,CAAC,EAAG,EAC7FH,GAAcC,EAAGC,CAAC,CAC3B,EAEO,SAASE,GAAUH,EAAGC,EAAG,CAC9B,GAAI,OAAOA,GAAM,YAAcA,IAAM,KACjC,MAAM,IAAI,UAAU,uBAAyB,OAAOA,CAAC,EAAI,+BAA+B,EAC5FF,GAAcC,EAAGC,CAAC,EAClB,SAASG,GAAK,CAAE,KAAK,YAAcJ,CAAG,CACtCA,EAAE,UAAYC,IAAM,KAAO,OAAO,OAAOA,CAAC,GAAKG,EAAG,UAAYH,EAAE,UAAW,IAAIG,EACjF,CAqFO,SAASC,GAAUC,EAASC,EAAYC,EAAGC,EAAW,CAC3D,SAASC,EAAMC,EAAO,CAAE,OAAOA,aAAiBH,EAAIG,EAAQ,IAAIH,EAAE,SAAUI,EAAS,CAAEA,EAAQD,CAAK,CAAG,CAAC,CAAG,CAC3G,OAAO,IAAKH,IAAMA,EAAI,UAAU,SAAUI,EAASC,EAAQ,CACvD,SAASC,EAAUH,EAAO,CAAE,GAAI,CAAEI,EAAKN,EAAU,KAAKE,CAAK,CAAC,CAAG,OAASK,EAAG,CAAEH,EAAOG,CAAC,CAAG,CAAE,CAC1F,SAASC,EAASN,EAAO,CAAE,GAAI,CAAEI,EAAKN,EAAU,MAASE,CAAK,CAAC,CAAG,OAASK,EAAG,CAAEH,EAAOG,CAAC,CAAG,CAAE,CAC7F,SAASD,EAAKG,EAAQ,CAAEA,EAAO,KAAON,EAAQM,EAAO,KAAK,EAAIR,EAAMQ,EAAO,KAAK,EAAE,KAAKJ,EAAWG,CAAQ,CAAG,CAC7GF,GAAMN,EAAYA,EAAU,MAAMH,EAASC,GAAc,CAAC,CAAC,GAAG,KAAK,CAAC,CACxE,CAAC,CACH,CAEO,SAASY,GAAYb,EAASc,EAAM,CACzC,IAAIC,EAAI,CAAE,MAAO,EAAG,KAAM,UAAW,CAAE,GAAIC,EAAE,CAAC,EAAI,EAAG,MAAMA,EAAE,CAAC,EAAG,OAAOA,EAAE,CAAC,CAAG,EAAG,KAAM,CAAC,EAAG,IAAK,CAAC,CAAE,EAAGC,EAAGC,EAAGF,EAAGG,EAAI,OAAO,QAAQ,OAAO,UAAa,WAAa,SAAW,QAAQ,SAAS,EAC/L,OAAOA,EAAE,KAAOC,EAAK,CAAC,EAAGD,EAAE,MAAWC,EAAK,CAAC,EAAGD,EAAE,OAAYC,EAAK,CAAC,EAAG,OAAO,QAAW,aAAeD,EAAE,OAAO,QAAQ,EAAI,UAAW,CAAE,OAAO,IAAM,GAAIA,EAC1J,SAASC,EAAKC,EAAG,CAAE,OAAO,SAAUC,EAAG,CAAE,OAAOb,EAAK,CAACY,EAAGC,CAAC,CAAC,CAAG,CAAG,CACjE,SAASb,EAAKc,EAAI,CACd,GAAIN,EAAG,MAAM,IAAI,UAAU,iCAAiC,EAC5D,KAAOE,IAAMA,EAAI,EAAGI,EAAG,CAAC,IAAMR,EAAI,IAAKA,GAAG,GAAI,CAC1C,GAAIE,EAAI,EAAGC,IAAMF,EAAIO,EAAG,CAAC,EAAI,EAAIL,EAAE,OAAYK,EAAG,CAAC,EAAIL,EAAE,SAAcF,EAAIE,EAAE,SAAcF,EAAE,KAAKE,CAAC,EAAG,GAAKA,EAAE,OAAS,EAAEF,EAAIA,EAAE,KAAKE,EAAGK,EAAG,CAAC,CAAC,GAAG,KAAM,OAAOP,EAE3J,OADIE,EAAI,EAAGF,IAAGO,EAAK,CAACA,EAAG,CAAC,EAAI,EAAGP,EAAE,KAAK,GAC9BO,EAAG,CAAC,EAAG,CACX,IAAK,GAAG,IAAK,GAAGP,EAAIO,EAAI,MACxB,IAAK,GAAG,OAAAR,EAAE,QAAgB,CAAE,MAAOQ,EAAG,CAAC,EAAG,KAAM,EAAM,EACtD,IAAK,GAAGR,EAAE,QAASG,EAAIK,EAAG,CAAC,EAAGA,EAAK,CAAC,CAAC,EAAG,SACxC,IAAK,GAAGA,EAAKR,EAAE,IAAI,IAAI,EAAGA,EAAE,KAAK,IAAI,EAAG,SACxC,QACI,GAAMC,EAAID,EAAE,KAAM,EAAAC,EAAIA,EAAE,OAAS,GAAKA,EAAEA,EAAE,OAAS,CAAC,KAAOO,EAAG,CAAC,IAAM,GAAKA,EAAG,CAAC,IAAM,GAAI,CAAER,EAAI,EAAG,QAAU,CAC3G,GAAIQ,EAAG,CAAC,IAAM,IAAM,CAACP,GAAMO,EAAG,CAAC,EAAIP,EAAE,CAAC,GAAKO,EAAG,CAAC,EAAIP,EAAE,CAAC,GAAK,CAAED,EAAE,MAAQQ,EAAG,CAAC,EAAG,KAAO,CACrF,GAAIA,EAAG,CAAC,IAAM,GAAKR,EAAE,MAAQC,EAAE,CAAC,EAAG,CAAED,EAAE,MAAQC,EAAE,CAAC,EAAGA,EAAIO,EAAI,KAAO,CACpE,GAAIP,GAAKD,EAAE,MAAQC,EAAE,CAAC,EAAG,CAAED,EAAE,MAAQC,EAAE,CAAC,EAAGD,EAAE,IAAI,KAAKQ,CAAE,EAAG,KAAO,CAC9DP,EAAE,CAAC,GAAGD,EAAE,IAAI,IAAI,EACpBA,EAAE,KAAK,IAAI,EAAG,QACtB,CACAQ,EAAKT,EAAK,KAAKd,EAASe,CAAC,CAC7B,OAASL,EAAG,CAAEa,EAAK,CAAC,EAAGb,CAAC,EAAGQ,EAAI,CAAG,QAAE,CAAUD,EAAID,EAAI,CAAG,CACzD,GAAIO,EAAG,CAAC,EAAI,EAAG,MAAMA,EAAG,CAAC,EAAG,MAAO,CAAE,MAAOA,EAAG,CAAC,EAAIA,EAAG,CAAC,EAAI,OAAQ,KAAM,EAAK,CACnF,CACF,CAkBO,SAASC,GAASC,EAAG,CAC1B,IAAIC,EAAI,OAAO,QAAW,YAAc,OAAO,SAAUC,EAAID,GAAKD,EAAEC,CAAC,EAAGE,EAAI,EAC5E,GAAID,EAAG,OAAOA,EAAE,KAAKF,CAAC,EACtB,GAAIA,GAAK,OAAOA,EAAE,QAAW,SAAU,MAAO,CAC1C,KAAM,UAAY,CACd,OAAIA,GAAKG,GAAKH,EAAE,SAAQA,EAAI,QACrB,CAAE,MAAOA,GAAKA,EAAEG,GAAG,EAAG,KAAM,CAACH,CAAE,CAC1C,CACJ,EACA,MAAM,IAAI,UAAUC,EAAI,0BAA4B,iCAAiC,CACvF,CAEO,SAASG,EAAOJ,EAAGK,EAAG,CAC3B,IAAIH,EAAI,OAAO,QAAW,YAAcF,EAAE,OAAO,QAAQ,EACzD,GAAI,CAACE,EAAG,OAAOF,EACf,IAAIG,EAAID,EAAE,KAAKF,CAAC,EAAGM,EAAGC,EAAK,CAAC,EAAGC,EAC/B,GAAI,CACA,MAAQH,IAAM,QAAUA,KAAM,IAAM,EAAEC,EAAIH,EAAE,KAAK,GAAG,MAAMI,EAAG,KAAKD,EAAE,KAAK,CAC7E,OACOG,EAAO,CAAED,EAAI,CAAE,MAAOC,CAAM,CAAG,QACtC,CACI,GAAI,CACIH,GAAK,CAACA,EAAE,OAASJ,EAAIC,EAAE,SAAYD,EAAE,KAAKC,CAAC,CACnD,QACA,CAAU,GAAIK,EAAG,MAAMA,EAAE,KAAO,CACpC,CACA,OAAOD,CACT,CAkBO,SAASG,EAAcC,EAAIC,EAAMC,EAAM,CAC5C,GAAIA,GAAQ,UAAU,SAAW,EAAG,QAASC,EAAI,EAAGC,EAAIH,EAAK,OAAQI,EAAIF,EAAIC,EAAGD,KACxEE,GAAM,EAAEF,KAAKF,MACRI,IAAIA,EAAK,MAAM,UAAU,MAAM,KAAKJ,EAAM,EAAGE,CAAC,GACnDE,EAAGF,CAAC,EAAIF,EAAKE,CAAC,GAGtB,OAAOH,EAAG,OAAOK,GAAM,MAAM,UAAU,MAAM,KAAKJ,CAAI,CAAC,CACzD,CAEO,SAASK,GAAQC,EAAG,CACzB,OAAO,gBAAgBD,IAAW,KAAK,EAAIC,EAAG,MAAQ,IAAID,GAAQC,CAAC,CACrE,CAEO,SAASC,GAAiBC,EAASC,EAAYC,EAAW,CAC/D,GAAI,CAAC,OAAO,cAAe,MAAM,IAAI,UAAU,sCAAsC,EACrF,IAAIC,EAAID,EAAU,MAAMF,EAASC,GAAc,CAAC,CAAC,EAAGP,EAAGU,EAAI,CAAC,EAC5D,OAAOV,EAAI,OAAO,QAAQ,OAAO,eAAkB,WAAa,cAAgB,QAAQ,SAAS,EAAGW,EAAK,MAAM,EAAGA,EAAK,OAAO,EAAGA,EAAK,SAAUC,CAAW,EAAGZ,EAAE,OAAO,aAAa,EAAI,UAAY,CAAE,OAAO,IAAM,EAAGA,EACtN,SAASY,EAAYC,EAAG,CAAE,OAAO,SAAUT,EAAG,CAAE,OAAO,QAAQ,QAAQA,CAAC,EAAE,KAAKS,EAAGC,CAAM,CAAG,CAAG,CAC9F,SAASH,EAAKI,EAAGF,EAAG,CAAMJ,EAAEM,CAAC,IAAKf,EAAEe,CAAC,EAAI,SAAUX,EAAG,CAAE,OAAO,IAAI,QAAQ,SAAUY,EAAGC,GAAG,CAAEP,EAAE,KAAK,CAACK,EAAGX,EAAGY,EAAGC,EAAC,CAAC,EAAI,GAAKC,EAAOH,EAAGX,CAAC,CAAG,CAAC,CAAG,EAAOS,IAAGb,EAAEe,CAAC,EAAIF,EAAEb,EAAEe,CAAC,CAAC,GAAK,CACvK,SAASG,EAAOH,EAAGX,EAAG,CAAE,GAAI,CAAEe,EAAKV,EAAEM,CAAC,EAAEX,CAAC,CAAC,CAAG,OAASgB,EAAG,CAAEC,EAAOX,EAAE,CAAC,EAAE,CAAC,EAAGU,CAAC,CAAG,CAAE,CACjF,SAASD,EAAKG,EAAG,CAAEA,EAAE,iBAAiBnB,GAAU,QAAQ,QAAQmB,EAAE,MAAM,CAAC,EAAE,KAAKC,EAAST,CAAM,EAAIO,EAAOX,EAAE,CAAC,EAAE,CAAC,EAAGY,CAAC,CAAG,CACvH,SAASC,EAAQC,EAAO,CAAEN,EAAO,OAAQM,CAAK,CAAG,CACjD,SAASV,EAAOU,EAAO,CAAEN,EAAO,QAASM,CAAK,CAAG,CACjD,SAASH,EAAOR,EAAGT,EAAG,CAAMS,EAAET,CAAC,EAAGM,EAAE,MAAM,EAAGA,EAAE,QAAQQ,EAAOR,EAAE,CAAC,EAAE,CAAC,EAAGA,EAAE,CAAC,EAAE,CAAC,CAAC,CAAG,CACnF,CAQO,SAASe,GAAcC,EAAG,CAC/B,GAAI,CAAC,OAAO,cAAe,MAAM,IAAI,UAAU,sCAAsC,EACrF,IAAIC,EAAID,EAAE,OAAO,aAAa,EAAGE,EACjC,OAAOD,EAAIA,EAAE,KAAKD,CAAC,GAAKA,EAAI,OAAOG,IAAa,WAAaA,GAASH,CAAC,EAAIA,EAAE,OAAO,QAAQ,EAAE,EAAGE,EAAI,CAAC,EAAGE,EAAK,MAAM,EAAGA,EAAK,OAAO,EAAGA,EAAK,QAAQ,EAAGF,EAAE,OAAO,aAAa,EAAI,UAAY,CAAE,OAAO,IAAM,EAAGA,GAC9M,SAASE,EAAKC,EAAG,CAAEH,EAAEG,CAAC,EAAIL,EAAEK,CAAC,GAAK,SAAUC,EAAG,CAAE,OAAO,IAAI,QAAQ,SAAUC,EAASC,EAAQ,CAAEF,EAAIN,EAAEK,CAAC,EAAEC,CAAC,EAAGG,EAAOF,EAASC,EAAQF,EAAE,KAAMA,EAAE,KAAK,CAAG,CAAC,CAAG,CAAG,CAC/J,SAASG,EAAOF,EAASC,EAAQE,EAAGJ,EAAG,CAAE,QAAQ,QAAQA,CAAC,EAAE,KAAK,SAASA,EAAG,CAAEC,EAAQ,CAAE,MAAOD,EAAG,KAAMI,CAAE,CAAC,CAAG,EAAGF,CAAM,CAAG,CAC7H,CCxPM,SAAUG,EAAWC,EAAU,CACnC,OAAO,OAAOA,GAAU,UAC1B,CCGM,SAAUC,GAAoBC,EAAgC,CAClE,IAAMC,EAAS,SAACC,EAAa,CAC3B,MAAM,KAAKA,CAAQ,EACnBA,EAAS,MAAQ,IAAI,MAAK,EAAG,KAC/B,EAEMC,EAAWH,EAAWC,CAAM,EAClC,OAAAE,EAAS,UAAY,OAAO,OAAO,MAAM,SAAS,EAClDA,EAAS,UAAU,YAAcA,EAC1BA,CACT,CCDO,IAAMC,GAA+CC,GAC1D,SAACC,EAAM,CACL,OAAA,SAA4CC,EAA0B,CACpED,EAAO,IAAI,EACX,KAAK,QAAUC,EACRA,EAAO,OAAM;EACxBA,EAAO,IAAI,SAACC,EAAKC,EAAC,CAAK,OAAGA,EAAI,EAAC,KAAKD,EAAI,SAAQ,CAAzB,CAA6B,EAAE,KAAK;GAAM,EACzD,GACJ,KAAK,KAAO,sBACZ,KAAK,OAASD,CAChB,CARA,CAQC,ECvBC,SAAUG,GAAaC,EAA6BC,EAAO,CAC/D,GAAID,EAAK,CACP,IAAME,EAAQF,EAAI,QAAQC,CAAI,EAC9B,GAAKC,GAASF,EAAI,OAAOE,EAAO,CAAC,EAErC,CCOA,IAAAC,GAAA,UAAA,CAyBE,SAAAA,EAAoBC,EAA4B,CAA5B,KAAA,gBAAAA,EAdb,KAAA,OAAS,GAER,KAAA,WAAmD,KAMnD,KAAA,YAAqD,IAMV,CAQnD,OAAAD,EAAA,UAAA,YAAA,UAAA,aACME,EAEJ,GAAI,CAAC,KAAK,OAAQ,CAChB,KAAK,OAAS,GAGN,IAAAC,EAAe,KAAI,WAC3B,GAAIA,EAEF,GADA,KAAK,WAAa,KACd,MAAM,QAAQA,CAAU,MAC1B,QAAqBC,EAAAC,GAAAF,CAAU,EAAAG,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAA5B,IAAMG,EAAMD,EAAA,MACfC,EAAO,OAAO,IAAI,yGAGpBJ,EAAW,OAAO,IAAI,EAIlB,IAAiBK,EAAqB,KAAI,gBAClD,GAAIC,EAAWD,CAAgB,EAC7B,GAAI,CACFA,EAAgB,QACTE,EAAG,CACVR,EAASQ,aAAaC,GAAsBD,EAAE,OAAS,CAACA,CAAC,EAIrD,IAAAE,EAAgB,KAAI,YAC5B,GAAIA,EAAa,CACf,KAAK,YAAc,SACnB,QAAwBC,EAAAR,GAAAO,CAAW,EAAAE,EAAAD,EAAA,KAAA,EAAA,CAAAC,EAAA,KAAAA,EAAAD,EAAA,KAAA,EAAE,CAAhC,IAAME,EAASD,EAAA,MAClB,GAAI,CACFE,GAAcD,CAAS,QAChBE,EAAK,CACZf,EAASA,GAAM,KAANA,EAAU,CAAA,EACfe,aAAeN,GACjBT,EAAMgB,EAAAA,EAAA,CAAA,EAAAC,EAAOjB,CAAM,CAAA,EAAAiB,EAAKF,EAAI,MAAM,CAAA,EAElCf,EAAO,KAAKe,CAAG,sGAMvB,GAAIf,EACF,MAAM,IAAIS,GAAoBT,CAAM,EAG1C,EAoBAF,EAAA,UAAA,IAAA,SAAIoB,EAAuB,OAGzB,GAAIA,GAAYA,IAAa,KAC3B,GAAI,KAAK,OAGPJ,GAAcI,CAAQ,MACjB,CACL,GAAIA,aAAoBpB,EAAc,CAGpC,GAAIoB,EAAS,QAAUA,EAAS,WAAW,IAAI,EAC7C,OAEFA,EAAS,WAAW,IAAI,GAEzB,KAAK,aAAcC,EAAA,KAAK,eAAW,MAAAA,IAAA,OAAAA,EAAI,CAAA,GAAI,KAAKD,CAAQ,EAG/D,EAOQpB,EAAA,UAAA,WAAR,SAAmBsB,EAAoB,CAC7B,IAAAnB,EAAe,KAAI,WAC3B,OAAOA,IAAemB,GAAW,MAAM,QAAQnB,CAAU,GAAKA,EAAW,SAASmB,CAAM,CAC1F,EASQtB,EAAA,UAAA,WAAR,SAAmBsB,EAAoB,CAC7B,IAAAnB,EAAe,KAAI,WAC3B,KAAK,WAAa,MAAM,QAAQA,CAAU,GAAKA,EAAW,KAAKmB,CAAM,EAAGnB,GAAcA,EAAa,CAACA,EAAYmB,CAAM,EAAIA,CAC5H,EAMQtB,EAAA,UAAA,cAAR,SAAsBsB,EAAoB,CAChC,IAAAnB,EAAe,KAAI,WACvBA,IAAemB,EACjB,KAAK,WAAa,KACT,MAAM,QAAQnB,CAAU,GACjCoB,GAAUpB,EAAYmB,CAAM,CAEhC,EAgBAtB,EAAA,UAAA,OAAA,SAAOoB,EAAsC,CACnC,IAAAR,EAAgB,KAAI,YAC5BA,GAAeW,GAAUX,EAAaQ,CAAQ,EAE1CA,aAAoBpB,GACtBoB,EAAS,cAAc,IAAI,CAE/B,EAlLcpB,EAAA,MAAS,UAAA,CACrB,IAAMwB,EAAQ,IAAIxB,EAClB,OAAAwB,EAAM,OAAS,GACRA,CACT,EAAE,EA+KJxB,GArLA,EAuLO,IAAMyB,GAAqBC,GAAa,MAEzC,SAAUC,GAAeC,EAAU,CACvC,OACEA,aAAiBF,IAChBE,GAAS,WAAYA,GAASC,EAAWD,EAAM,MAAM,GAAKC,EAAWD,EAAM,GAAG,GAAKC,EAAWD,EAAM,WAAW,CAEpH,CAEA,SAASE,GAAcC,EAAwC,CACzDF,EAAWE,CAAS,EACtBA,EAAS,EAETA,EAAU,YAAW,CAEzB,CChNO,IAAMC,GAAuB,CAClC,iBAAkB,KAClB,sBAAuB,KACvB,QAAS,OACT,sCAAuC,GACvC,yBAA0B,ICGrB,IAAMC,GAAmC,CAG9C,WAAA,SAAWC,EAAqBC,EAAgB,SAAEC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,EAAA,CAAA,EAAA,UAAAA,CAAA,EACxC,IAAAC,EAAaL,GAAe,SACpC,OAAIK,GAAQ,MAARA,EAAU,WACLA,EAAS,WAAU,MAAnBA,EAAQC,EAAA,CAAYL,EAASC,CAAO,EAAAK,EAAKJ,CAAI,CAAA,CAAA,EAE/C,WAAU,MAAA,OAAAG,EAAA,CAACL,EAASC,CAAO,EAAAK,EAAKJ,CAAI,CAAA,CAAA,CAC7C,EACA,aAAA,SAAaK,EAAM,CACT,IAAAH,EAAaL,GAAe,SACpC,QAAQK,GAAQ,KAAA,OAARA,EAAU,eAAgB,cAAcG,CAAa,CAC/D,EACA,SAAU,QCjBN,SAAUC,GAAqBC,EAAQ,CAC3CC,GAAgB,WAAW,UAAA,CACjB,IAAAC,EAAqBC,GAAM,iBACnC,GAAID,EAEFA,EAAiBF,CAAG,MAGpB,OAAMA,CAEV,CAAC,CACH,CCtBM,SAAUI,IAAI,CAAK,CCMlB,IAAMC,GAAyB,UAAA,CAAM,OAAAC,GAAmB,IAAK,OAAW,MAAS,CAA5C,EAAsE,EAO5G,SAAUC,GAAkBC,EAAU,CAC1C,OAAOF,GAAmB,IAAK,OAAWE,CAAK,CACjD,CAOM,SAAUC,GAAoBC,EAAQ,CAC1C,OAAOJ,GAAmB,IAAKI,EAAO,MAAS,CACjD,CAQM,SAAUJ,GAAmBK,EAAuBD,EAAYF,EAAU,CAC9E,MAAO,CACL,KAAIG,EACJ,MAAKD,EACL,MAAKF,EAET,CCrCA,IAAII,GAAuD,KASrD,SAAUC,GAAaC,EAAc,CACzC,GAAIC,GAAO,sCAAuC,CAChD,IAAMC,EAAS,CAACJ,GAKhB,GAJII,IACFJ,GAAU,CAAE,YAAa,GAAO,MAAO,IAAI,GAE7CE,EAAE,EACEE,EAAQ,CACJ,IAAAC,EAAyBL,GAAvBM,EAAWD,EAAA,YAAEE,EAAKF,EAAA,MAE1B,GADAL,GAAU,KACNM,EACF,MAAMC,QAMVL,EAAE,CAEN,CAMM,SAAUM,GAAaC,EAAQ,CAC/BN,GAAO,uCAAyCH,KAClDA,GAAQ,YAAc,GACtBA,GAAQ,MAAQS,EAEpB,CCrBA,IAAAC,GAAA,SAAAC,EAAA,CAAmCC,GAAAF,EAAAC,CAAA,EA6BjC,SAAAD,EAAYG,EAA6C,CAAzD,IAAAC,EACEH,EAAA,KAAA,IAAA,GAAO,KATC,OAAAG,EAAA,UAAqB,GAUzBD,GACFC,EAAK,YAAcD,EAGfE,GAAeF,CAAW,GAC5BA,EAAY,IAAIC,CAAI,GAGtBA,EAAK,YAAcE,IAEvB,CAzBO,OAAAN,EAAA,OAAP,SAAiBO,EAAwBC,EAA2BC,EAAqB,CACvF,OAAO,IAAIC,GAAeH,EAAMC,EAAOC,CAAQ,CACjD,EAgCAT,EAAA,UAAA,KAAA,SAAKW,EAAS,CACR,KAAK,UACPC,GAA0BC,GAAiBF,CAAK,EAAG,IAAI,EAEvD,KAAK,MAAMA,CAAM,CAErB,EASAX,EAAA,UAAA,MAAA,SAAMc,EAAS,CACT,KAAK,UACPF,GAA0BG,GAAkBD,CAAG,EAAG,IAAI,GAEtD,KAAK,UAAY,GACjB,KAAK,OAAOA,CAAG,EAEnB,EAQAd,EAAA,UAAA,SAAA,UAAA,CACM,KAAK,UACPY,GAA0BI,GAAuB,IAAI,GAErD,KAAK,UAAY,GACjB,KAAK,UAAS,EAElB,EAEAhB,EAAA,UAAA,YAAA,UAAA,CACO,KAAK,SACR,KAAK,UAAY,GACjBC,EAAA,UAAM,YAAW,KAAA,IAAA,EACjB,KAAK,YAAc,KAEvB,EAEUD,EAAA,UAAA,MAAV,SAAgBW,EAAQ,CACtB,KAAK,YAAY,KAAKA,CAAK,CAC7B,EAEUX,EAAA,UAAA,OAAV,SAAiBc,EAAQ,CACvB,GAAI,CACF,KAAK,YAAY,MAAMA,CAAG,UAE1B,KAAK,YAAW,EAEpB,EAEUd,EAAA,UAAA,UAAV,UAAA,CACE,GAAI,CACF,KAAK,YAAY,SAAQ,UAEzB,KAAK,YAAW,EAEpB,EACFA,CAAA,EApHmCiB,EAAY,EA2H/C,IAAMC,GAAQ,SAAS,UAAU,KAEjC,SAASC,GAAyCC,EAAQC,EAAY,CACpE,OAAOH,GAAM,KAAKE,EAAIC,CAAO,CAC/B,CAMA,IAAAC,GAAA,UAAA,CACE,SAAAA,EAAoBC,EAAqC,CAArC,KAAA,gBAAAA,CAAwC,CAE5D,OAAAD,EAAA,UAAA,KAAA,SAAKE,EAAQ,CACH,IAAAD,EAAoB,KAAI,gBAChC,GAAIA,EAAgB,KAClB,GAAI,CACFA,EAAgB,KAAKC,CAAK,QACnBC,EAAO,CACdC,GAAqBD,CAAK,EAGhC,EAEAH,EAAA,UAAA,MAAA,SAAMK,EAAQ,CACJ,IAAAJ,EAAoB,KAAI,gBAChC,GAAIA,EAAgB,MAClB,GAAI,CACFA,EAAgB,MAAMI,CAAG,QAClBF,EAAO,CACdC,GAAqBD,CAAK,OAG5BC,GAAqBC,CAAG,CAE5B,EAEAL,EAAA,UAAA,SAAA,UAAA,CACU,IAAAC,EAAoB,KAAI,gBAChC,GAAIA,EAAgB,SAClB,GAAI,CACFA,EAAgB,SAAQ,QACjBE,EAAO,CACdC,GAAqBD,CAAK,EAGhC,EACFH,CAAA,EArCA,EAuCAM,GAAA,SAAAC,EAAA,CAAuCC,GAAAF,EAAAC,CAAA,EACrC,SAAAD,EACEG,EACAN,EACAO,EAA8B,CAHhC,IAAAC,EAKEJ,EAAA,KAAA,IAAA,GAAO,KAEHN,EACJ,GAAIW,EAAWH,CAAc,GAAK,CAACA,EAGjCR,EAAkB,CAChB,KAAOQ,GAAc,KAAdA,EAAkB,OACzB,MAAON,GAAK,KAALA,EAAS,OAChB,SAAUO,GAAQ,KAARA,EAAY,YAEnB,CAEL,IAAIG,EACAF,GAAQG,GAAO,0BAIjBD,EAAU,OAAO,OAAOJ,CAAc,EACtCI,EAAQ,YAAc,UAAA,CAAM,OAAAF,EAAK,YAAW,CAAhB,EAC5BV,EAAkB,CAChB,KAAMQ,EAAe,MAAQZ,GAAKY,EAAe,KAAMI,CAAO,EAC9D,MAAOJ,EAAe,OAASZ,GAAKY,EAAe,MAAOI,CAAO,EACjE,SAAUJ,EAAe,UAAYZ,GAAKY,EAAe,SAAUI,CAAO,IAI5EZ,EAAkBQ,EAMtB,OAAAE,EAAK,YAAc,IAAIX,GAAiBC,CAAe,GACzD,CACF,OAAAK,CAAA,EAzCuCS,EAAU,EA2CjD,SAASC,GAAqBC,EAAU,CAClCC,GAAO,sCACTC,GAAaF,CAAK,EAIlBG,GAAqBH,CAAK,CAE9B,CAQA,SAASI,GAAoBC,EAAQ,CACnC,MAAMA,CACR,CAOA,SAASC,GAA0BC,EAA2CC,EAA2B,CAC/F,IAAAC,EAA0BR,GAAM,sBACxCQ,GAAyBC,GAAgB,WAAW,UAAA,CAAM,OAAAD,EAAsBF,EAAcC,CAAU,CAA9C,CAA+C,CAC3G,CAOO,IAAMG,GAA6D,CACxE,OAAQ,GACR,KAAMC,GACN,MAAOR,GACP,SAAUQ,IC5QL,IAAMC,GAA+B,UAAA,CAAM,OAAC,OAAO,QAAW,YAAc,OAAO,YAAe,cAAvD,EAAsE,ECoClH,SAAUC,GAAYC,EAAI,CAC9B,OAAOA,CACT,CCiCM,SAAUC,IAAI,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACnB,OAAOC,GAAcF,CAAG,CAC1B,CAGM,SAAUE,GAAoBF,EAA+B,CACjE,OAAIA,EAAI,SAAW,EACVG,GAGLH,EAAI,SAAW,EACVA,EAAI,CAAC,EAGP,SAAeI,EAAQ,CAC5B,OAAOJ,EAAI,OAAO,SAACK,EAAWC,EAAuB,CAAK,OAAAA,EAAGD,CAAI,CAAP,EAAUD,CAAY,CAClF,CACF,CC9EA,IAAAG,EAAA,UAAA,CAkBE,SAAAA,EAAYC,EAA6E,CACnFA,IACF,KAAK,WAAaA,EAEtB,CA4BA,OAAAD,EAAA,UAAA,KAAA,SAAQE,EAAyB,CAC/B,IAAMC,EAAa,IAAIH,EACvB,OAAAG,EAAW,OAAS,KACpBA,EAAW,SAAWD,EACfC,CACT,EA6IAH,EAAA,UAAA,UAAA,SACEI,EACAC,EACAC,EAA8B,CAHhC,IAAAC,EAAA,KAKQC,EAAaC,GAAaL,CAAc,EAAIA,EAAiB,IAAIM,GAAeN,EAAgBC,EAAOC,CAAQ,EAErH,OAAAK,GAAa,UAAA,CACL,IAAAC,EAAuBL,EAArBL,EAAQU,EAAA,SAAEC,EAAMD,EAAA,OACxBJ,EAAW,IACTN,EAGIA,EAAS,KAAKM,EAAYK,CAAM,EAChCA,EAIAN,EAAK,WAAWC,CAAU,EAG1BD,EAAK,cAAcC,CAAU,CAAC,CAEtC,CAAC,EAEMA,CACT,EAGUR,EAAA,UAAA,cAAV,SAAwBc,EAAmB,CACzC,GAAI,CACF,OAAO,KAAK,WAAWA,CAAI,QACpBC,EAAK,CAIZD,EAAK,MAAMC,CAAG,EAElB,EA6DAf,EAAA,UAAA,QAAA,SAAQgB,EAA0BC,EAAoC,CAAtE,IAAAV,EAAA,KACE,OAAAU,EAAcC,GAAeD,CAAW,EAEjC,IAAIA,EAAkB,SAACE,EAASC,EAAM,CAC3C,IAAMZ,EAAa,IAAIE,GAAkB,CACvC,KAAM,SAACW,EAAK,CACV,GAAI,CACFL,EAAKK,CAAK,QACHN,EAAK,CACZK,EAAOL,CAAG,EACVP,EAAW,YAAW,EAE1B,EACA,MAAOY,EACP,SAAUD,EACX,EACDZ,EAAK,UAAUC,CAAU,CAC3B,CAAC,CACH,EAGUR,EAAA,UAAA,WAAV,SAAqBQ,EAA2B,OAC9C,OAAOI,EAAA,KAAK,UAAM,MAAAA,IAAA,OAAA,OAAAA,EAAE,UAAUJ,CAAU,CAC1C,EAOAR,EAAA,UAACG,EAAiB,EAAlB,UAAA,CACE,OAAO,IACT,EA4FAH,EAAA,UAAA,KAAA,UAAA,SAAKsB,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACH,OAAOC,GAAcF,CAAU,EAAE,IAAI,CACvC,EA6BAtB,EAAA,UAAA,UAAA,SAAUiB,EAAoC,CAA9C,IAAAV,EAAA,KACE,OAAAU,EAAcC,GAAeD,CAAW,EAEjC,IAAIA,EAAY,SAACE,EAASC,EAAM,CACrC,IAAIC,EACJd,EAAK,UACH,SAACkB,EAAI,CAAK,OAACJ,EAAQI,CAAT,EACV,SAACV,EAAQ,CAAK,OAAAK,EAAOL,CAAG,CAAV,EACd,UAAA,CAAM,OAAAI,EAAQE,CAAK,CAAb,CAAc,CAExB,CAAC,CACH,EA1aOrB,EAAA,OAAkC,SAAIC,EAAwD,CACnG,OAAO,IAAID,EAAcC,CAAS,CACpC,EAyaFD,GA9cA,EAudA,SAAS0B,GAAeC,EAA+C,OACrE,OAAOC,EAAAD,GAAW,KAAXA,EAAeE,GAAO,WAAO,MAAAD,IAAA,OAAAA,EAAI,OAC1C,CAEA,SAASE,GAAcC,EAAU,CAC/B,OAAOA,GAASC,EAAWD,EAAM,IAAI,GAAKC,EAAWD,EAAM,KAAK,GAAKC,EAAWD,EAAM,QAAQ,CAChG,CAEA,SAASE,GAAgBF,EAAU,CACjC,OAAQA,GAASA,aAAiBG,IAAgBJ,GAAWC,CAAK,GAAKI,GAAeJ,CAAK,CAC7F,CCzeM,SAAUK,GAAQC,EAAW,CACjC,OAAOC,EAAWD,GAAM,KAAA,OAANA,EAAQ,IAAI,CAChC,CAMM,SAAUE,EACdC,EAAqF,CAErF,OAAO,SAACH,EAAqB,CAC3B,GAAID,GAAQC,CAAM,EAChB,OAAOA,EAAO,KAAK,SAA+BI,EAA2B,CAC3E,GAAI,CACF,OAAOD,EAAKC,EAAc,IAAI,QACvBC,EAAK,CACZ,KAAK,MAAMA,CAAG,EAElB,CAAC,EAEH,MAAM,IAAI,UAAU,wCAAwC,CAC9D,CACF,CCjBM,SAAUC,EACdC,EACAC,EACAC,EACAC,EACAC,EAAuB,CAEvB,OAAO,IAAIC,GAAmBL,EAAaC,EAAQC,EAAYC,EAASC,CAAU,CACpF,CAMA,IAAAC,GAAA,SAAAC,EAAA,CAA2CC,GAAAF,EAAAC,CAAA,EAiBzC,SAAAD,EACEL,EACAC,EACAC,EACAC,EACQC,EACAI,EAAiC,CAN3C,IAAAC,EAoBEH,EAAA,KAAA,KAAMN,CAAW,GAAC,KAfV,OAAAS,EAAA,WAAAL,EACAK,EAAA,kBAAAD,EAeRC,EAAK,MAAQR,EACT,SAAuCS,EAAQ,CAC7C,GAAI,CACFT,EAAOS,CAAK,QACLC,EAAK,CACZX,EAAY,MAAMW,CAAG,EAEzB,EACAL,EAAA,UAAM,MACVG,EAAK,OAASN,EACV,SAAuCQ,EAAQ,CAC7C,GAAI,CACFR,EAAQQ,CAAG,QACJA,EAAK,CAEZX,EAAY,MAAMW,CAAG,UAGrB,KAAK,YAAW,EAEpB,EACAL,EAAA,UAAM,OACVG,EAAK,UAAYP,EACb,UAAA,CACE,GAAI,CACFA,EAAU,QACHS,EAAK,CAEZX,EAAY,MAAMW,CAAG,UAGrB,KAAK,YAAW,EAEpB,EACAL,EAAA,UAAM,WACZ,CAEA,OAAAD,EAAA,UAAA,YAAA,UAAA,OACE,GAAI,CAAC,KAAK,mBAAqB,KAAK,kBAAiB,EAAI,CAC/C,IAAAO,EAAW,KAAI,OACvBN,EAAA,UAAM,YAAW,KAAA,IAAA,EAEjB,CAACM,KAAUC,EAAA,KAAK,cAAU,MAAAA,IAAA,QAAAA,EAAA,KAAf,IAAI,GAEnB,EACFR,CAAA,EAnF2CS,EAAU,ECd9C,IAAMC,GAAiD,CAG5D,SAAA,SAASC,EAAQ,CACf,IAAIC,EAAU,sBACVC,EAAkD,qBAC9CC,EAAaJ,GAAsB,SACvCI,IACFF,EAAUE,EAAS,sBACnBD,EAASC,EAAS,sBAEpB,IAAMC,EAASH,EAAQ,SAACI,EAAS,CAI/BH,EAAS,OACTF,EAASK,CAAS,CACpB,CAAC,EACD,OAAO,IAAIC,GAAa,UAAA,CAAM,OAAAJ,GAAM,KAAA,OAANA,EAASE,CAAM,CAAf,CAAgB,CAChD,EACA,sBAAqB,UAAA,SAACG,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACZ,IAAAL,EAAaJ,GAAsB,SAC3C,QAAQI,GAAQ,KAAA,OAARA,EAAU,wBAAyB,uBAAsB,MAAA,OAAAM,EAAA,CAAA,EAAAC,EAAIH,CAAI,CAAA,CAAA,CAC3E,EACA,qBAAoB,UAAA,SAACA,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACX,IAAAL,EAAaJ,GAAsB,SAC3C,QAAQI,GAAQ,KAAA,OAARA,EAAU,uBAAwB,sBAAqB,MAAA,OAAAM,EAAA,CAAA,EAAAC,EAAIH,CAAI,CAAA,CAAA,CACzE,EACA,SAAU,QCrBL,IAAMI,GAAuDC,GAClE,SAACC,EAAM,CACL,OAAA,UAAoC,CAClCA,EAAO,IAAI,EACX,KAAK,KAAO,0BACZ,KAAK,QAAU,qBACjB,CAJA,CAIC,ECXL,IAAAC,EAAA,SAAAC,EAAA,CAAgCC,GAAAF,EAAAC,CAAA,EAwB9B,SAAAD,GAAA,CAAA,IAAAG,EAEEF,EAAA,KAAA,IAAA,GAAO,KAzBT,OAAAE,EAAA,OAAS,GAEDA,EAAA,iBAAyC,KAGjDA,EAAA,UAA2B,CAAA,EAE3BA,EAAA,UAAY,GAEZA,EAAA,SAAW,GAEXA,EAAA,YAAmB,MAenB,CAGA,OAAAH,EAAA,UAAA,KAAA,SAAQI,EAAwB,CAC9B,IAAMC,EAAU,IAAIC,GAAiB,KAAM,IAAI,EAC/C,OAAAD,EAAQ,SAAWD,EACZC,CACT,EAGUL,EAAA,UAAA,eAAV,UAAA,CACE,GAAI,KAAK,OACP,MAAM,IAAIO,EAEd,EAEAP,EAAA,UAAA,KAAA,SAAKQ,EAAQ,CAAb,IAAAL,EAAA,KACEM,GAAa,UAAA,SAEX,GADAN,EAAK,eAAc,EACf,CAACA,EAAK,UAAW,CACdA,EAAK,mBACRA,EAAK,iBAAmB,MAAM,KAAKA,EAAK,SAAS,OAEnD,QAAuBO,EAAAC,GAAAR,EAAK,gBAAgB,EAAAS,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAAzC,IAAMG,EAAQD,EAAA,MACjBC,EAAS,KAAKL,CAAK,qGAGzB,CAAC,CACH,EAEAR,EAAA,UAAA,MAAA,SAAMc,EAAQ,CAAd,IAAAX,EAAA,KACEM,GAAa,UAAA,CAEX,GADAN,EAAK,eAAc,EACf,CAACA,EAAK,UAAW,CACnBA,EAAK,SAAWA,EAAK,UAAY,GACjCA,EAAK,YAAcW,EAEnB,QADQC,EAAcZ,EAAI,UACnBY,EAAU,QACfA,EAAU,MAAK,EAAI,MAAMD,CAAG,EAGlC,CAAC,CACH,EAEAd,EAAA,UAAA,SAAA,UAAA,CAAA,IAAAG,EAAA,KACEM,GAAa,UAAA,CAEX,GADAN,EAAK,eAAc,EACf,CAACA,EAAK,UAAW,CACnBA,EAAK,UAAY,GAEjB,QADQY,EAAcZ,EAAI,UACnBY,EAAU,QACfA,EAAU,MAAK,EAAI,SAAQ,EAGjC,CAAC,CACH,EAEAf,EAAA,UAAA,YAAA,UAAA,CACE,KAAK,UAAY,KAAK,OAAS,GAC/B,KAAK,UAAY,KAAK,iBAAmB,IAC3C,EAEA,OAAA,eAAIA,EAAA,UAAA,WAAQ,KAAZ,UAAA,OACE,QAAOgB,EAAA,KAAK,aAAS,MAAAA,IAAA,OAAA,OAAAA,EAAE,QAAS,CAClC,kCAGUhB,EAAA,UAAA,cAAV,SAAwBiB,EAAyB,CAC/C,YAAK,eAAc,EACZhB,EAAA,UAAM,cAAa,KAAA,KAACgB,CAAU,CACvC,EAGUjB,EAAA,UAAA,WAAV,SAAqBiB,EAAyB,CAC5C,YAAK,eAAc,EACnB,KAAK,wBAAwBA,CAAU,EAChC,KAAK,gBAAgBA,CAAU,CACxC,EAGUjB,EAAA,UAAA,gBAAV,SAA0BiB,EAA2B,CAArD,IAAAd,EAAA,KACQa,EAAqC,KAAnCE,EAAQF,EAAA,SAAEG,EAASH,EAAA,UAAED,EAASC,EAAA,UACtC,OAAIE,GAAYC,EACPC,IAET,KAAK,iBAAmB,KACxBL,EAAU,KAAKE,CAAU,EAClB,IAAII,GAAa,UAAA,CACtBlB,EAAK,iBAAmB,KACxBmB,GAAUP,EAAWE,CAAU,CACjC,CAAC,EACH,EAGUjB,EAAA,UAAA,wBAAV,SAAkCiB,EAA2B,CACrD,IAAAD,EAAuC,KAArCE,EAAQF,EAAA,SAAEO,EAAWP,EAAA,YAAEG,EAASH,EAAA,UACpCE,EACFD,EAAW,MAAMM,CAAW,EACnBJ,GACTF,EAAW,SAAQ,CAEvB,EAQAjB,EAAA,UAAA,aAAA,UAAA,CACE,IAAMwB,EAAkB,IAAIC,EAC5B,OAAAD,EAAW,OAAS,KACbA,CACT,EAxHOxB,EAAA,OAAkC,SAAI0B,EAA0BC,EAAqB,CAC1F,OAAO,IAAIrB,GAAoBoB,EAAaC,CAAM,CACpD,EAuHF3B,GA7IgCyB,CAAU,EAkJ1C,IAAAG,GAAA,SAAAC,EAAA,CAAyCC,GAAAF,EAAAC,CAAA,EACvC,SAAAD,EAESG,EACPC,EAAsB,CAHxB,IAAAC,EAKEJ,EAAA,KAAA,IAAA,GAAO,KAHA,OAAAI,EAAA,YAAAF,EAIPE,EAAK,OAASD,GAChB,CAEA,OAAAJ,EAAA,UAAA,KAAA,SAAKM,EAAQ,UACXC,GAAAC,EAAA,KAAK,eAAW,MAAAA,IAAA,OAAA,OAAAA,EAAE,QAAI,MAAAD,IAAA,QAAAA,EAAA,KAAAC,EAAGF,CAAK,CAChC,EAEAN,EAAA,UAAA,MAAA,SAAMS,EAAQ,UACZF,GAAAC,EAAA,KAAK,eAAW,MAAAA,IAAA,OAAA,OAAAA,EAAE,SAAK,MAAAD,IAAA,QAAAA,EAAA,KAAAC,EAAGC,CAAG,CAC/B,EAEAT,EAAA,UAAA,SAAA,UAAA,UACEO,GAAAC,EAAA,KAAK,eAAW,MAAAA,IAAA,OAAA,OAAAA,EAAE,YAAQ,MAAAD,IAAA,QAAAA,EAAA,KAAAC,CAAA,CAC5B,EAGUR,EAAA,UAAA,WAAV,SAAqBU,EAAyB,SAC5C,OAAOH,GAAAC,EAAA,KAAK,UAAM,MAAAA,IAAA,OAAA,OAAAA,EAAE,UAAUE,CAAU,KAAC,MAAAH,IAAA,OAAAA,EAAII,EAC/C,EACFX,CAAA,EA1ByCY,CAAO,ECxJhD,IAAAC,GAAA,SAAAC,EAAA,CAAwCC,GAAAF,EAAAC,CAAA,EACtC,SAAAD,EAAoBG,EAAS,CAA7B,IAAAC,EACEH,EAAA,KAAA,IAAA,GAAO,KADW,OAAAG,EAAA,OAAAD,GAEpB,CAEA,cAAA,eAAIH,EAAA,UAAA,QAAK,KAAT,UAAA,CACE,OAAO,KAAK,SAAQ,CACtB,kCAGUA,EAAA,UAAA,WAAV,SAAqBK,EAAyB,CAC5C,IAAMC,EAAeL,EAAA,UAAM,WAAU,KAAA,KAACI,CAAU,EAChD,OAACC,EAAa,QAAUD,EAAW,KAAK,KAAK,MAAM,EAC5CC,CACT,EAEAN,EAAA,UAAA,SAAA,UAAA,CACQ,IAAAO,EAAoC,KAAlCC,EAAQD,EAAA,SAAEE,EAAWF,EAAA,YAAEJ,EAAMI,EAAA,OACrC,GAAIC,EACF,MAAMC,EAER,YAAK,eAAc,EACZN,CACT,EAEAH,EAAA,UAAA,KAAA,SAAKU,EAAQ,CACXT,EAAA,UAAM,KAAI,KAAA,KAAE,KAAK,OAASS,CAAM,CAClC,EACFV,CAAA,EA5BwCW,CAAO,ECJxC,IAAMC,GAA+C,CAC1D,IAAG,UAAA,CAGD,OAAQA,GAAsB,UAAY,MAAM,IAAG,CACrD,EACA,SAAU,QCwBZ,IAAAC,GAAA,SAAAC,EAAA,CAAsCC,GAAAF,EAAAC,CAAA,EAUpC,SAAAD,EACUG,EACAC,EACAC,EAA6D,CAF7DF,IAAA,SAAAA,EAAA,KACAC,IAAA,SAAAA,EAAA,KACAC,IAAA,SAAAA,EAAAC,IAHV,IAAAC,EAKEN,EAAA,KAAA,IAAA,GAAO,KAJC,OAAAM,EAAA,YAAAJ,EACAI,EAAA,YAAAH,EACAG,EAAA,mBAAAF,EAZFE,EAAA,QAA0B,CAAA,EAC1BA,EAAA,oBAAsB,GAc5BA,EAAK,oBAAsBH,IAAgB,IAC3CG,EAAK,YAAc,KAAK,IAAI,EAAGJ,CAAW,EAC1CI,EAAK,YAAc,KAAK,IAAI,EAAGH,CAAW,GAC5C,CAEA,OAAAJ,EAAA,UAAA,KAAA,SAAKQ,EAAQ,CACL,IAAAC,EAA+E,KAA7EC,EAASD,EAAA,UAAEE,EAAOF,EAAA,QAAEG,EAAmBH,EAAA,oBAAEJ,EAAkBI,EAAA,mBAAEL,EAAWK,EAAA,YAC3EC,IACHC,EAAQ,KAAKH,CAAK,EAClB,CAACI,GAAuBD,EAAQ,KAAKN,EAAmB,IAAG,EAAKD,CAAW,GAE7E,KAAK,YAAW,EAChBH,EAAA,UAAM,KAAI,KAAA,KAACO,CAAK,CAClB,EAGUR,EAAA,UAAA,WAAV,SAAqBa,EAAyB,CAC5C,KAAK,eAAc,EACnB,KAAK,YAAW,EAQhB,QANMC,EAAe,KAAK,gBAAgBD,CAAU,EAE9CJ,EAAmC,KAAjCG,EAAmBH,EAAA,oBAAEE,EAAOF,EAAA,QAG9BM,EAAOJ,EAAQ,MAAK,EACjBK,EAAI,EAAGA,EAAID,EAAK,QAAU,CAACF,EAAW,OAAQG,GAAKJ,EAAsB,EAAI,EACpFC,EAAW,KAAKE,EAAKC,CAAC,CAAM,EAG9B,YAAK,wBAAwBH,CAAU,EAEhCC,CACT,EAEQd,EAAA,UAAA,YAAR,UAAA,CACQ,IAAAS,EAAoE,KAAlEN,EAAWM,EAAA,YAAEJ,EAAkBI,EAAA,mBAAEE,EAAOF,EAAA,QAAEG,EAAmBH,EAAA,oBAK/DQ,GAAsBL,EAAsB,EAAI,GAAKT,EAK3D,GAJAA,EAAc,KAAYc,EAAqBN,EAAQ,QAAUA,EAAQ,OAAO,EAAGA,EAAQ,OAASM,CAAkB,EAIlH,CAACL,EAAqB,CAKxB,QAJMM,EAAMb,EAAmB,IAAG,EAC9Bc,EAAO,EAGFH,EAAI,EAAGA,EAAIL,EAAQ,QAAWA,EAAQK,CAAC,GAAgBE,EAAKF,GAAK,EACxEG,EAAOH,EAETG,GAAQR,EAAQ,OAAO,EAAGQ,EAAO,CAAC,EAEtC,EACFnB,CAAA,EAzEsCoB,CAAO,EClB7C,IAAAC,GAAA,SAAAC,EAAA,CAA+BC,GAAAF,EAAAC,CAAA,EAC7B,SAAAD,EAAYG,EAAsBC,EAAmD,QACnFH,EAAA,KAAA,IAAA,GAAO,IACT,CAWO,OAAAD,EAAA,UAAA,SAAP,SAAgBK,EAAWC,EAAiB,CAAjB,OAAAA,IAAA,SAAAA,EAAA,GAClB,IACT,EACFN,CAAA,EAjB+BO,EAAY,ECHpC,IAAMC,GAAqC,CAGhD,YAAA,SAAYC,EAAqBC,EAAgB,SAAEC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,EAAA,CAAA,EAAA,UAAAA,CAAA,EACzC,IAAAC,EAAaL,GAAgB,SACrC,OAAIK,GAAQ,MAARA,EAAU,YACLA,EAAS,YAAW,MAApBA,EAAQC,EAAA,CAAaL,EAASC,CAAO,EAAAK,EAAKJ,CAAI,CAAA,CAAA,EAEhD,YAAW,MAAA,OAAAG,EAAA,CAACL,EAASC,CAAO,EAAAK,EAAKJ,CAAI,CAAA,CAAA,CAC9C,EACA,cAAA,SAAcK,EAAM,CACV,IAAAH,EAAaL,GAAgB,SACrC,QAAQK,GAAQ,KAAA,OAARA,EAAU,gBAAiB,eAAeG,CAAa,CACjE,EACA,SAAU,QCrBZ,IAAAC,GAAA,SAAAC,EAAA,CAAoCC,GAAAF,EAAAC,CAAA,EAOlC,SAAAD,EAAsBG,EAAqCC,EAAmD,CAA9G,IAAAC,EACEJ,EAAA,KAAA,KAAME,EAAWC,CAAI,GAAC,KADF,OAAAC,EAAA,UAAAF,EAAqCE,EAAA,KAAAD,EAFjDC,EAAA,QAAmB,IAI7B,CAEO,OAAAL,EAAA,UAAA,SAAP,SAAgBM,EAAWC,EAAiB,OAC1C,GADyBA,IAAA,SAAAA,EAAA,GACrB,KAAK,OACP,OAAO,KAIT,KAAK,MAAQD,EAEb,IAAME,EAAK,KAAK,GACVL,EAAY,KAAK,UAuBvB,OAAIK,GAAM,OACR,KAAK,GAAK,KAAK,eAAeL,EAAWK,EAAID,CAAK,GAKpD,KAAK,QAAU,GAEf,KAAK,MAAQA,EAEb,KAAK,IAAKE,EAAA,KAAK,MAAE,MAAAA,IAAA,OAAAA,EAAI,KAAK,eAAeN,EAAW,KAAK,GAAII,CAAK,EAE3D,IACT,EAEUP,EAAA,UAAA,eAAV,SAAyBG,EAA2BO,EAAmBH,EAAiB,CAAjB,OAAAA,IAAA,SAAAA,EAAA,GAC9DI,GAAiB,YAAYR,EAAU,MAAM,KAAKA,EAAW,IAAI,EAAGI,CAAK,CAClF,EAEUP,EAAA,UAAA,eAAV,SAAyBY,EAA4BJ,EAAkBD,EAAwB,CAE7F,GAFqEA,IAAA,SAAAA,EAAA,GAEjEA,GAAS,MAAQ,KAAK,QAAUA,GAAS,KAAK,UAAY,GAC5D,OAAOC,EAILA,GAAM,MACRG,GAAiB,cAAcH,CAAE,CAIrC,EAMOR,EAAA,UAAA,QAAP,SAAeM,EAAUC,EAAa,CACpC,GAAI,KAAK,OACP,OAAO,IAAI,MAAM,8BAA8B,EAGjD,KAAK,QAAU,GACf,IAAMM,EAAQ,KAAK,SAASP,EAAOC,CAAK,EACxC,GAAIM,EACF,OAAOA,EACE,KAAK,UAAY,IAAS,KAAK,IAAM,OAc9C,KAAK,GAAK,KAAK,eAAe,KAAK,UAAW,KAAK,GAAI,IAAI,EAE/D,EAEUb,EAAA,UAAA,SAAV,SAAmBM,EAAUQ,EAAc,CACzC,IAAIC,EAAmB,GACnBC,EACJ,GAAI,CACF,KAAK,KAAKV,CAAK,QACRW,EAAG,CACVF,EAAU,GAIVC,EAAaC,GAAQ,IAAI,MAAM,oCAAoC,EAErE,GAAIF,EACF,YAAK,YAAW,EACTC,CAEX,EAEAhB,EAAA,UAAA,YAAA,UAAA,CACE,GAAI,CAAC,KAAK,OAAQ,CACV,IAAAS,EAAoB,KAAlBD,EAAEC,EAAA,GAAEN,EAASM,EAAA,UACbS,EAAYf,EAAS,QAE7B,KAAK,KAAO,KAAK,MAAQ,KAAK,UAAY,KAC1C,KAAK,QAAU,GAEfgB,GAAUD,EAAS,IAAI,EACnBV,GAAM,OACR,KAAK,GAAK,KAAK,eAAeL,EAAWK,EAAI,IAAI,GAGnD,KAAK,MAAQ,KACbP,EAAA,UAAM,YAAW,KAAA,IAAA,EAErB,EACFD,CAAA,EA9IoCoB,EAAM,ECgB1C,IAAAC,GAAA,UAAA,CAGE,SAAAA,EAAoBC,EAAoCC,EAAiC,CAAjCA,IAAA,SAAAA,EAAoBF,EAAU,KAAlE,KAAA,oBAAAC,EAClB,KAAK,IAAMC,CACb,CA6BO,OAAAF,EAAA,UAAA,SAAP,SAAmBG,EAAqDC,EAAmBC,EAAS,CAA5B,OAAAD,IAAA,SAAAA,EAAA,GAC/D,IAAI,KAAK,oBAAuB,KAAMD,CAAI,EAAE,SAASE,EAAOD,CAAK,CAC1E,EAnCcJ,EAAA,IAAoBM,GAAsB,IAoC1DN,GArCA,ECnBA,IAAAO,GAAA,SAAAC,EAAA,CAAoCC,GAAAF,EAAAC,CAAA,EAkBlC,SAAAD,EAAYG,EAAgCC,EAAiC,CAAjCA,IAAA,SAAAA,EAAoBC,GAAU,KAA1E,IAAAC,EACEL,EAAA,KAAA,KAAME,EAAiBC,CAAG,GAAC,KAlBtB,OAAAE,EAAA,QAAmC,CAAA,EAOnCA,EAAA,QAAmB,IAY1B,CAEO,OAAAN,EAAA,UAAA,MAAP,SAAaO,EAAwB,CAC3B,IAAAC,EAAY,KAAI,QAExB,GAAI,KAAK,QAAS,CAChBA,EAAQ,KAAKD,CAAM,EACnB,OAGF,IAAIE,EACJ,KAAK,QAAU,GAEf,EACE,IAAKA,EAAQF,EAAO,QAAQA,EAAO,MAAOA,EAAO,KAAK,EACpD,YAEMA,EAASC,EAAQ,MAAK,GAIhC,GAFA,KAAK,QAAU,GAEXC,EAAO,CACT,KAAQF,EAASC,EAAQ,MAAK,GAC5BD,EAAO,YAAW,EAEpB,MAAME,EAEV,EACFT,CAAA,EAhDoCK,EAAS,EC6CtC,IAAMK,GAAiB,IAAIC,GAAeC,EAAW,EAK/CC,GAAQH,GCjDrB,IAAAI,GAAA,SAAAC,EAAA,CAAoCC,GAAAF,EAAAC,CAAA,EAClC,SAAAD,EAAsBG,EAAqCC,EAAmD,CAA9G,IAAAC,EACEJ,EAAA,KAAA,KAAME,EAAWC,CAAI,GAAC,KADF,OAAAC,EAAA,UAAAF,EAAqCE,EAAA,KAAAD,GAE3D,CAEO,OAAAJ,EAAA,UAAA,SAAP,SAAgBM,EAAWC,EAAiB,CAC1C,OADyBA,IAAA,SAAAA,EAAA,GACrBA,EAAQ,EACHN,EAAA,UAAM,SAAQ,KAAA,KAACK,EAAOC,CAAK,GAEpC,KAAK,MAAQA,EACb,KAAK,MAAQD,EACb,KAAK,UAAU,MAAM,IAAI,EAClB,KACT,EAEON,EAAA,UAAA,QAAP,SAAeM,EAAUC,EAAa,CACpC,OAAOA,EAAQ,GAAK,KAAK,OAASN,EAAA,UAAM,QAAO,KAAA,KAACK,EAAOC,CAAK,EAAI,KAAK,SAASD,EAAOC,CAAK,CAC5F,EAEUP,EAAA,UAAA,eAAV,SAAyBG,EAA2BK,EAAkBD,EAAiB,CAKrF,OALoEA,IAAA,SAAAA,EAAA,GAK/DA,GAAS,MAAQA,EAAQ,GAAOA,GAAS,MAAQ,KAAK,MAAQ,EAC1DN,EAAA,UAAM,eAAc,KAAA,KAACE,EAAWK,EAAID,CAAK,GAIlDJ,EAAU,MAAM,IAAI,EAMb,EACT,EACFH,CAAA,EArCoCS,EAAW,ECJ/C,IAAAC,GAAA,SAAAC,EAAA,CAAoCC,GAAAF,EAAAC,CAAA,EAApC,SAAAD,GAAA,+CACA,CAAA,OAAAA,CAAA,EADoCG,EAAc,ECgE3C,IAAMC,GAAiB,IAAIC,GAAeC,EAAW,EC5D5D,IAAAC,GAAA,SAAAC,EAAA,CAA6CC,GAAAF,EAAAC,CAAA,EAC3C,SAAAD,EAAsBG,EAA8CC,EAAmD,CAAvH,IAAAC,EACEJ,EAAA,KAAA,KAAME,EAAWC,CAAI,GAAC,KADF,OAAAC,EAAA,UAAAF,EAA8CE,EAAA,KAAAD,GAEpE,CAEU,OAAAJ,EAAA,UAAA,eAAV,SAAyBG,EAAoCG,EAAkBC,EAAiB,CAE9F,OAF6EA,IAAA,SAAAA,EAAA,GAEzEA,IAAU,MAAQA,EAAQ,EACrBN,EAAA,UAAM,eAAc,KAAA,KAACE,EAAWG,EAAIC,CAAK,GAGlDJ,EAAU,QAAQ,KAAK,IAAI,EAIpBA,EAAU,aAAeA,EAAU,WAAaK,GAAuB,sBAAsB,UAAA,CAAM,OAAAL,EAAU,MAAM,MAAS,CAAzB,CAA0B,GACtI,EAEUH,EAAA,UAAA,eAAV,SAAyBG,EAAoCG,EAAkBC,EAAiB,OAI9F,GAJ6EA,IAAA,SAAAA,EAAA,GAIzEA,GAAS,KAAOA,EAAQ,EAAI,KAAK,MAAQ,EAC3C,OAAON,EAAA,UAAM,eAAc,KAAA,KAACE,EAAWG,EAAIC,CAAK,EAK1C,IAAAE,EAAYN,EAAS,QACzBG,GAAM,QAAQI,EAAAD,EAAQA,EAAQ,OAAS,CAAC,KAAC,MAAAC,IAAA,OAAA,OAAAA,EAAE,MAAOJ,IACpDE,GAAuB,qBAAqBF,CAAY,EACxDH,EAAU,WAAa,OAI3B,EACFH,CAAA,EApC6CW,EAAW,ECHxD,IAAAC,GAAA,SAAAC,EAAA,CAA6CC,GAAAF,EAAAC,CAAA,EAA7C,SAAAD,GAAA,+CAkCA,CAjCS,OAAAA,EAAA,UAAA,MAAP,SAAaG,EAAyB,CACpC,KAAK,QAAU,GAUf,IAAMC,EAAU,KAAK,WACrB,KAAK,WAAa,OAEV,IAAAC,EAAY,KAAI,QACpBC,EACJH,EAASA,GAAUE,EAAQ,MAAK,EAEhC,EACE,IAAKC,EAAQH,EAAO,QAAQA,EAAO,MAAOA,EAAO,KAAK,EACpD,aAEMA,EAASE,EAAQ,CAAC,IAAMF,EAAO,KAAOC,GAAWC,EAAQ,MAAK,GAIxE,GAFA,KAAK,QAAU,GAEXC,EAAO,CACT,MAAQH,EAASE,EAAQ,CAAC,IAAMF,EAAO,KAAOC,GAAWC,EAAQ,MAAK,GACpEF,EAAO,YAAW,EAEpB,MAAMG,EAEV,EACFN,CAAA,EAlC6CO,EAAc,ECgCpD,IAAMC,GAA0B,IAAIC,GAAwBC,EAAoB,EC8BhF,IAAMC,EAAQ,IAAIC,EAAkB,SAACC,EAAU,CAAK,OAAAA,EAAW,SAAQ,CAAnB,CAAqB,EC9D1E,SAAUC,GAAYC,EAAU,CACpC,OAAOA,GAASC,EAAWD,EAAM,QAAQ,CAC3C,CCDA,SAASE,GAAQC,EAAQ,CACvB,OAAOA,EAAIA,EAAI,OAAS,CAAC,CAC3B,CAEM,SAAUC,GAAkBC,EAAW,CAC3C,OAAOC,EAAWJ,GAAKG,CAAI,CAAC,EAAIA,EAAK,IAAG,EAAK,MAC/C,CAEM,SAAUE,GAAaF,EAAW,CACtC,OAAOG,GAAYN,GAAKG,CAAI,CAAC,EAAIA,EAAK,IAAG,EAAK,MAChD,CAEM,SAAUI,GAAUJ,EAAaK,EAAoB,CACzD,OAAO,OAAOR,GAAKG,CAAI,GAAM,SAAWA,EAAK,IAAG,EAAMK,CACxD,CClBO,IAAMC,GAAe,SAAIC,EAAM,CAAwB,OAAAA,GAAK,OAAOA,EAAE,QAAW,UAAY,OAAOA,GAAM,UAAlD,ECMxD,SAAUC,GAAUC,EAAU,CAClC,OAAOC,EAAWD,GAAK,KAAA,OAALA,EAAO,IAAI,CAC/B,CCHM,SAAUE,GAAoBC,EAAU,CAC5C,OAAOC,EAAWD,EAAME,EAAiB,CAAC,CAC5C,CCLM,SAAUC,GAAmBC,EAAQ,CACzC,OAAO,OAAO,eAAiBC,EAAWD,GAAG,KAAA,OAAHA,EAAM,OAAO,aAAa,CAAC,CACvE,CCAM,SAAUE,GAAiCC,EAAU,CAEzD,OAAO,IAAI,UACT,iBACEA,IAAU,MAAQ,OAAOA,GAAU,SAAW,oBAAsB,IAAIA,EAAK,KAAG,0HACwC,CAE9H,CCXM,SAAUC,IAAiB,CAC/B,OAAI,OAAO,QAAW,YAAc,CAAC,OAAO,SACnC,aAGF,OAAO,QAChB,CAEO,IAAMC,GAAWD,GAAiB,ECJnC,SAAUE,GAAWC,EAAU,CACnC,OAAOC,EAAWD,GAAK,KAAA,OAALA,EAAQE,EAAe,CAAC,CAC5C,CCHM,SAAiBC,GAAsCC,EAAqC,mGAC1FC,EAASD,EAAe,UAAS,2DAGX,MAAA,CAAA,EAAAE,GAAMD,EAAO,KAAI,CAAE,CAAA,gBAArCE,EAAkBC,EAAA,KAAA,EAAhBC,EAAKF,EAAA,MAAEG,EAAIH,EAAA,KACfG,iBAAA,CAAA,EAAA,CAAA,SACF,MAAA,CAAA,EAAAF,EAAA,KAAA,CAAA,qBAEIC,CAAM,CAAA,SAAZ,MAAA,CAAA,EAAAD,EAAA,KAAA,CAAA,SAAA,OAAAA,EAAA,KAAA,mCAGF,OAAAH,EAAO,YAAW,6BAIhB,SAAUM,GAAwBC,EAAQ,CAG9C,OAAOC,EAAWD,GAAG,KAAA,OAAHA,EAAK,SAAS,CAClC,CCPM,SAAUE,EAAaC,EAAyB,CACpD,GAAIA,aAAiBC,EACnB,OAAOD,EAET,GAAIA,GAAS,KAAM,CACjB,GAAIE,GAAoBF,CAAK,EAC3B,OAAOG,GAAsBH,CAAK,EAEpC,GAAII,GAAYJ,CAAK,EACnB,OAAOK,GAAcL,CAAK,EAE5B,GAAIM,GAAUN,CAAK,EACjB,OAAOO,GAAYP,CAAK,EAE1B,GAAIQ,GAAgBR,CAAK,EACvB,OAAOS,GAAkBT,CAAK,EAEhC,GAAIU,GAAWV,CAAK,EAClB,OAAOW,GAAaX,CAAK,EAE3B,GAAIY,GAAqBZ,CAAK,EAC5B,OAAOa,GAAuBb,CAAK,EAIvC,MAAMc,GAAiCd,CAAK,CAC9C,CAMM,SAAUG,GAAyBY,EAAQ,CAC/C,OAAO,IAAId,EAAW,SAACe,EAAyB,CAC9C,IAAMC,EAAMF,EAAIG,EAAiB,EAAC,EAClC,GAAIC,EAAWF,EAAI,SAAS,EAC1B,OAAOA,EAAI,UAAUD,CAAU,EAGjC,MAAM,IAAI,UAAU,gEAAgE,CACtF,CAAC,CACH,CASM,SAAUX,GAAiBe,EAAmB,CAClD,OAAO,IAAInB,EAAW,SAACe,EAAyB,CAU9C,QAASK,EAAI,EAAGA,EAAID,EAAM,QAAU,CAACJ,EAAW,OAAQK,IACtDL,EAAW,KAAKI,EAAMC,CAAC,CAAC,EAE1BL,EAAW,SAAQ,CACrB,CAAC,CACH,CAEM,SAAUT,GAAee,EAAuB,CACpD,OAAO,IAAIrB,EAAW,SAACe,EAAyB,CAC9CM,EACG,KACC,SAACC,EAAK,CACCP,EAAW,SACdA,EAAW,KAAKO,CAAK,EACrBP,EAAW,SAAQ,EAEvB,EACA,SAACQ,EAAQ,CAAK,OAAAR,EAAW,MAAMQ,CAAG,CAApB,CAAqB,EAEpC,KAAK,KAAMC,EAAoB,CACpC,CAAC,CACH,CAEM,SAAUd,GAAgBe,EAAqB,CACnD,OAAO,IAAIzB,EAAW,SAACe,EAAyB,aAC9C,QAAoBW,EAAAC,GAAAF,CAAQ,EAAAG,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAAzB,IAAMJ,EAAKM,EAAA,MAEd,GADAb,EAAW,KAAKO,CAAK,EACjBP,EAAW,OACb,yGAGJA,EAAW,SAAQ,CACrB,CAAC,CACH,CAEM,SAAUP,GAAqBqB,EAA+B,CAClE,OAAO,IAAI7B,EAAW,SAACe,EAAyB,CAC9Ce,GAAQD,EAAed,CAAU,EAAE,MAAM,SAACQ,EAAG,CAAK,OAAAR,EAAW,MAAMQ,CAAG,CAApB,CAAqB,CACzE,CAAC,CACH,CAEM,SAAUX,GAA0BmB,EAAqC,CAC7E,OAAOvB,GAAkBwB,GAAmCD,CAAc,CAAC,CAC7E,CAEA,SAAeD,GAAWD,EAAiCd,EAAyB,uIACxDkB,EAAAC,GAAAL,CAAa,gFAIrC,GAJeP,EAAKa,EAAA,MACpBpB,EAAW,KAAKO,CAAK,EAGjBP,EAAW,OACb,MAAA,CAAA,CAAA,6RAGJ,OAAAA,EAAW,SAAQ,WChHf,SAAUqB,GACdC,EACAC,EACAC,EACAC,EACAC,EAAc,CADdD,IAAA,SAAAA,EAAA,GACAC,IAAA,SAAAA,EAAA,IAEA,IAAMC,EAAuBJ,EAAU,SAAS,UAAA,CAC9CC,EAAI,EACAE,EACFJ,EAAmB,IAAI,KAAK,SAAS,KAAMG,CAAK,CAAC,EAEjD,KAAK,YAAW,CAEpB,EAAGA,CAAK,EAIR,GAFAH,EAAmB,IAAIK,CAAoB,EAEvC,CAACD,EAKH,OAAOC,CAEX,CCeM,SAAUC,GAAaC,EAA0BC,EAAS,CAAT,OAAAA,IAAA,SAAAA,EAAA,GAC9CC,EAAQ,SAACC,EAAQC,EAAU,CAChCD,EAAO,UACLE,EACED,EACA,SAACE,EAAK,CAAK,OAAAC,GAAgBH,EAAYJ,EAAW,UAAA,CAAM,OAAAI,EAAW,KAAKE,CAAK,CAArB,EAAwBL,CAAK,CAA1E,EACX,UAAA,CAAM,OAAAM,GAAgBH,EAAYJ,EAAW,UAAA,CAAM,OAAAI,EAAW,SAAQ,CAAnB,EAAuBH,CAAK,CAAzE,EACN,SAACO,EAAG,CAAK,OAAAD,GAAgBH,EAAYJ,EAAW,UAAA,CAAM,OAAAI,EAAW,MAAMI,CAAG,CAApB,EAAuBP,CAAK,CAAzE,CAA0E,CACpF,CAEL,CAAC,CACH,CCPM,SAAUQ,GAAeC,EAA0BC,EAAiB,CAAjB,OAAAA,IAAA,SAAAA,EAAA,GAChDC,EAAQ,SAACC,EAAQC,EAAU,CAChCA,EAAW,IAAIJ,EAAU,SAAS,UAAA,CAAM,OAAAG,EAAO,UAAUC,CAAU,CAA3B,EAA8BH,CAAK,CAAC,CAC9E,CAAC,CACH,CC7DM,SAAUI,GAAsBC,EAA6BC,EAAwB,CACzF,OAAOC,EAAUF,CAAK,EAAE,KAAKG,GAAYF,CAAS,EAAGG,GAAUH,CAAS,CAAC,CAC3E,CCFM,SAAUI,GAAmBC,EAAuBC,EAAwB,CAChF,OAAOC,EAAUF,CAAK,EAAE,KAAKG,GAAYF,CAAS,EAAGG,GAAUH,CAAS,CAAC,CAC3E,CCJM,SAAUI,GAAiBC,EAAqBC,EAAwB,CAC5E,OAAO,IAAIC,EAAc,SAACC,EAAU,CAElC,IAAIC,EAAI,EAER,OAAOH,EAAU,SAAS,UAAA,CACpBG,IAAMJ,EAAM,OAGdG,EAAW,SAAQ,GAInBA,EAAW,KAAKH,EAAMI,GAAG,CAAC,EAIrBD,EAAW,QACd,KAAK,SAAQ,EAGnB,CAAC,CACH,CAAC,CACH,CCfM,SAAUE,GAAoBC,EAAoBC,EAAwB,CAC9E,OAAO,IAAIC,EAAc,SAACC,EAAU,CAClC,IAAIC,EAKJ,OAAAC,GAAgBF,EAAYF,EAAW,UAAA,CAErCG,EAAYJ,EAAcI,EAAe,EAAC,EAE1CC,GACEF,EACAF,EACA,UAAA,OACMK,EACAC,EACJ,GAAI,CAEDC,EAAkBJ,EAAS,KAAI,EAA7BE,EAAKE,EAAA,MAAED,EAAIC,EAAA,WACPC,EAAK,CAEZN,EAAW,MAAMM,CAAG,EACpB,OAGEF,EAKFJ,EAAW,SAAQ,EAGnBA,EAAW,KAAKG,CAAK,CAEzB,EACA,EACA,EAAI,CAER,CAAC,EAMM,UAAA,CAAM,OAAAI,EAAWN,GAAQ,KAAA,OAARA,EAAU,MAAM,GAAKA,EAAS,OAAM,CAA/C,CACf,CAAC,CACH,CCvDM,SAAUO,GAAyBC,EAAyBC,EAAwB,CACxF,GAAI,CAACD,EACH,MAAM,IAAI,MAAM,yBAAyB,EAE3C,OAAO,IAAIE,EAAc,SAACC,EAAU,CAClCC,GAAgBD,EAAYF,EAAW,UAAA,CACrC,IAAMI,EAAWL,EAAM,OAAO,aAAa,EAAC,EAC5CI,GACED,EACAF,EACA,UAAA,CACEI,EAAS,KAAI,EAAG,KAAK,SAACC,EAAM,CACtBA,EAAO,KAGTH,EAAW,SAAQ,EAEnBA,EAAW,KAAKG,EAAO,KAAK,CAEhC,CAAC,CACH,EACA,EACA,EAAI,CAER,CAAC,CACH,CAAC,CACH,CCzBM,SAAUC,GAA8BC,EAA8BC,EAAwB,CAClG,OAAOC,GAAsBC,GAAmCH,CAAK,EAAGC,CAAS,CACnF,CCoBM,SAAUG,GAAaC,EAA2BC,EAAwB,CAC9E,GAAID,GAAS,KAAM,CACjB,GAAIE,GAAoBF,CAAK,EAC3B,OAAOG,GAAmBH,EAAOC,CAAS,EAE5C,GAAIG,GAAYJ,CAAK,EACnB,OAAOK,GAAcL,EAAOC,CAAS,EAEvC,GAAIK,GAAUN,CAAK,EACjB,OAAOO,GAAgBP,EAAOC,CAAS,EAEzC,GAAIO,GAAgBR,CAAK,EACvB,OAAOS,GAAsBT,EAAOC,CAAS,EAE/C,GAAIS,GAAWV,CAAK,EAClB,OAAOW,GAAiBX,EAAOC,CAAS,EAE1C,GAAIW,GAAqBZ,CAAK,EAC5B,OAAOa,GAA2Bb,EAAOC,CAAS,EAGtD,MAAMa,GAAiCd,CAAK,CAC9C,CCoDM,SAAUe,GAAQC,EAA2BC,EAAyB,CAC1E,OAAOA,EAAYC,GAAUF,EAAOC,CAAS,EAAIE,EAAUH,CAAK,CAClE,CCxBM,SAAUI,GAAE,SAAIC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACpB,IAAMC,EAAYC,GAAaH,CAAI,EACnC,OAAOI,GAAKJ,EAAaE,CAAS,CACpC,CCsCM,SAAUG,GAAWC,EAA0BC,EAAyB,CAC5E,IAAMC,EAAeC,EAAWH,CAAmB,EAAIA,EAAsB,UAAA,CAAM,OAAAA,CAAA,EAC7EI,EAAO,SAACC,EAA6B,CAAK,OAAAA,EAAW,MAAMH,EAAY,CAAE,CAA/B,EAChD,OAAO,IAAII,EAAWL,EAAY,SAACI,EAAU,CAAK,OAAAJ,EAAU,SAASG,EAAa,EAAGC,CAAU,CAA7C,EAAiDD,CAAI,CACzG,CCpGO,IAAMG,GAA6BC,GAAiB,SAACC,EAAM,CAAK,OAAA,UAAuB,CAC5FA,EAAO,IAAI,EACX,KAAK,KAAO,aACZ,KAAK,QAAU,yBACjB,CAJuE,CAItE,ECrBK,SAAUC,GAAYC,EAAU,CACpC,OAAOA,aAAiB,MAAQ,CAAC,MAAMA,CAAY,CACrD,CCsCM,SAAUC,EAAUC,EAAyCC,EAAa,CAC9E,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAEhC,IAAIC,EAAQ,EAGZF,EAAO,UACLG,EAAyBF,EAAY,SAACG,EAAQ,CAG5CH,EAAW,KAAKJ,EAAQ,KAAKC,EAASM,EAAOF,GAAO,CAAC,CACvD,CAAC,CAAC,CAEN,CAAC,CACH,CC1DQ,IAAAG,GAAY,MAAK,QAEzB,SAASC,GAAkBC,EAA6BC,EAAW,CAC/D,OAAOH,GAAQG,CAAI,EAAID,EAAE,MAAA,OAAAE,EAAA,CAAA,EAAAC,EAAIF,CAAI,CAAA,CAAA,EAAID,EAAGC,CAAI,CAChD,CAMM,SAAUG,GAAuBJ,EAA2B,CAC9D,OAAOK,EAAI,SAAAJ,EAAI,CAAI,OAAAF,GAAYC,EAAIC,CAAI,CAApB,CAAqB,CAC5C,CCfQ,IAAAK,GAAY,MAAK,QACjBC,GAA0D,OAAM,eAArCC,GAA+B,OAAM,UAAlBC,GAAY,OAAM,KAQlE,SAAUC,GAAqDC,EAAuB,CAC1F,GAAIA,EAAK,SAAW,EAAG,CACrB,IAAMC,EAAQD,EAAK,CAAC,EACpB,GAAIL,GAAQM,CAAK,EACf,MAAO,CAAE,KAAMA,EAAO,KAAM,IAAI,EAElC,GAAIC,GAAOD,CAAK,EAAG,CACjB,IAAME,EAAOL,GAAQG,CAAK,EAC1B,MAAO,CACL,KAAME,EAAK,IAAI,SAACC,EAAG,CAAK,OAAAH,EAAMG,CAAG,CAAT,CAAU,EAClC,KAAID,IAKV,MAAO,CAAE,KAAMH,EAAa,KAAM,IAAI,CACxC,CAEA,SAASE,GAAOG,EAAQ,CACtB,OAAOA,GAAO,OAAOA,GAAQ,UAAYT,GAAeS,CAAG,IAAMR,EACnE,CC7BM,SAAUS,GAAaC,EAAgBC,EAAa,CACxD,OAAOD,EAAK,OAAO,SAACE,EAAQC,EAAKC,EAAC,CAAK,OAAEF,EAAOC,CAAG,EAAIF,EAAOG,CAAC,EAAIF,CAA5B,EAAqC,CAAA,CAAS,CACvF,CCsMM,SAAUG,GAAa,SAAoCC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAC/D,IAAMC,EAAYC,GAAaH,CAAI,EAC7BI,EAAiBC,GAAkBL,CAAI,EAEvCM,EAA8BC,GAAqBP,CAAI,EAA/CQ,EAAWF,EAAA,KAAEG,EAAIH,EAAA,KAE/B,GAAIE,EAAY,SAAW,EAIzB,OAAOE,GAAK,CAAA,EAAIR,CAAgB,EAGlC,IAAMS,EAAS,IAAIC,EACjBC,GACEL,EACAN,EACAO,EAEI,SAACK,EAAM,CAAK,OAAAC,GAAaN,EAAMK,CAAM,CAAzB,EAEZE,EAAQ,CACb,EAGH,OAAOZ,EAAkBO,EAAO,KAAKM,GAAiBb,CAAc,CAAC,EAAsBO,CAC7F,CAEM,SAAUE,GACdL,EACAN,EACAgB,EAAiD,CAAjD,OAAAA,IAAA,SAAAA,EAAAF,IAEO,SAACG,EAA2B,CAGjCC,GACElB,EACA,UAAA,CAaE,QAZQmB,EAAWb,EAAW,OAExBM,EAAS,IAAI,MAAMO,CAAM,EAG3BC,EAASD,EAITE,EAAuBF,aAGlBG,EAAC,CACRJ,GACElB,EACA,UAAA,CACE,IAAMuB,EAASf,GAAKF,EAAYgB,CAAC,EAAGtB,CAAgB,EAChDwB,EAAgB,GACpBD,EAAO,UACLE,EACER,EACA,SAACS,EAAK,CAEJd,EAAOU,CAAC,EAAII,EACPF,IAEHA,EAAgB,GAChBH,KAEGA,GAGHJ,EAAW,KAAKD,EAAeJ,EAAO,MAAK,CAAE,CAAC,CAElD,EACA,UAAA,CACO,EAAEQ,GAGLH,EAAW,SAAQ,CAEvB,CAAC,CACF,CAEL,EACAA,CAAU,GAjCLK,EAAI,EAAGA,EAAIH,EAAQG,MAAnBA,CAAC,CAoCZ,EACAL,CAAU,CAEd,CACF,CAMA,SAASC,GAAclB,EAAsC2B,EAAqBC,EAA0B,CACtG5B,EACF6B,GAAgBD,EAAc5B,EAAW2B,CAAO,EAEhDA,EAAO,CAEX,CC3RM,SAAUG,GACdC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EAAgC,CAGhC,IAAMC,EAAc,CAAA,EAEhBC,EAAS,EAETC,EAAQ,EAERC,EAAa,GAKXC,EAAgB,UAAA,CAIhBD,GAAc,CAACH,EAAO,QAAU,CAACC,GACnCR,EAAW,SAAQ,CAEvB,EAGMY,EAAY,SAACC,EAAQ,CAAK,OAACL,EAASN,EAAaY,EAAWD,CAAK,EAAIN,EAAO,KAAKM,CAAK,CAA5D,EAE1BC,EAAa,SAACD,EAAQ,CAI1BT,GAAUJ,EAAW,KAAKa,CAAY,EAItCL,IAKA,IAAIO,EAAgB,GAGpBC,EAAUf,EAAQY,EAAOJ,GAAO,CAAC,EAAE,UACjCQ,EACEjB,EACA,SAACkB,GAAU,CAGTf,GAAY,MAAZA,EAAee,EAAU,EAErBd,EAGFQ,EAAUM,EAAiB,EAG3BlB,EAAW,KAAKkB,EAAU,CAE9B,EACA,UAAA,CAGEH,EAAgB,EAClB,EAEA,OACA,UAAA,CAIE,GAAIA,EAKF,GAAI,CAIFP,IAKA,sBACE,IAAMW,EAAgBZ,EAAO,MAAK,EAI9BF,EACFe,GAAgBpB,EAAYK,EAAmB,UAAA,CAAM,OAAAS,EAAWK,CAAa,CAAxB,CAAyB,EAE9EL,EAAWK,CAAa,GARrBZ,EAAO,QAAUC,EAASN,QAYjCS,EAAa,QACNU,EAAK,CACZrB,EAAW,MAAMqB,CAAG,EAG1B,CAAC,CACF,CAEL,EAGA,OAAAtB,EAAO,UACLkB,EAAyBjB,EAAYY,EAAW,UAAA,CAE9CF,EAAa,GACbC,EAAa,CACf,CAAC,CAAC,EAKG,UAAA,CACLL,GAAmB,MAAnBA,EAAmB,CACrB,CACF,CClEM,SAAUgB,GACdC,EACAC,EACAC,EAA6B,CAE7B,OAFAA,IAAA,SAAAA,EAAA,KAEIC,EAAWF,CAAc,EAEpBF,GAAS,SAACK,EAAGC,EAAC,CAAK,OAAAC,EAAI,SAACC,EAAQC,EAAU,CAAK,OAAAP,EAAeG,EAAGG,EAAGF,EAAGG,CAAE,CAA1B,CAA2B,EAAEC,EAAUT,EAAQI,EAAGC,CAAC,CAAC,CAAC,CAAjF,EAAoFH,CAAU,GAC/G,OAAOD,GAAmB,WACnCC,EAAaD,GAGRS,EAAQ,SAACC,EAAQC,EAAU,CAAK,OAAAC,GAAeF,EAAQC,EAAYZ,EAASE,CAAU,CAAtD,CAAuD,EAChG,CChCM,SAAUY,GAAyCC,EAA6B,CAA7B,OAAAA,IAAA,SAAAA,EAAA,KAChDC,GAASC,GAAUF,CAAU,CACtC,CCNM,SAAUG,IAAS,CACvB,OAAOC,GAAS,CAAC,CACnB,CCmDM,SAAUC,IAAM,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACrB,OAAOC,GAAS,EAAGC,GAAKH,EAAMI,GAAaJ,CAAI,CAAC,CAAC,CACnD,CC9DM,SAAUK,EAAsCC,EAA0B,CAC9E,OAAO,IAAIC,EAA+B,SAACC,EAAU,CACnDC,EAAUH,EAAiB,CAAE,EAAE,UAAUE,CAAU,CACrD,CAAC,CACH,CChDA,IAAME,GAA0B,CAAC,cAAe,gBAAgB,EAC1DC,GAAqB,CAAC,mBAAoB,qBAAqB,EAC/DC,GAAgB,CAAC,KAAM,KAAK,EAkO5B,SAAUC,EACdC,EACAC,EACAC,EACAC,EAAsC,CAMtC,GAJIC,EAAWF,CAAO,IACpBC,EAAiBD,EACjBA,EAAU,QAERC,EACF,OAAOJ,EAAaC,EAAQC,EAAWC,CAA+B,EAAE,KAAKG,GAAiBF,CAAc,CAAC,EAUzG,IAAAG,EAAAC,EAEJC,GAAcR,CAAM,EAChBH,GAAmB,IAAI,SAACY,EAAU,CAAK,OAAA,SAACC,EAAY,CAAK,OAAAV,EAAOS,CAAU,EAAER,EAAWS,EAASR,CAA+B,CAAtE,CAAlB,CAAyF,EAElIS,GAAwBX,CAAM,EAC5BJ,GAAwB,IAAIgB,GAAwBZ,EAAQC,CAAS,CAAC,EACtEY,GAA0Bb,CAAM,EAChCF,GAAc,IAAIc,GAAwBZ,EAAQC,CAAS,CAAC,EAC5D,CAAA,EAAE,CAAA,EATDa,EAAGR,EAAA,CAAA,EAAES,EAAMT,EAAA,CAAA,EAgBlB,GAAI,CAACQ,GACCE,GAAYhB,CAAM,EACpB,OAAOiB,GAAS,SAACC,EAAc,CAAK,OAAAnB,EAAUmB,EAAWjB,EAAWC,CAA+B,CAA/D,CAAgE,EAClGiB,EAAUnB,CAAM,CAAC,EAOvB,GAAI,CAACc,EACH,MAAM,IAAI,UAAU,sBAAsB,EAG5C,OAAO,IAAIM,EAAc,SAACC,EAAU,CAIlC,IAAMX,EAAU,UAAA,SAACY,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAAmB,OAAAF,EAAW,KAAK,EAAIC,EAAK,OAASA,EAAOA,EAAK,CAAC,CAAC,CAAhD,EAEpC,OAAAR,EAAIJ,CAAO,EAEJ,UAAA,CAAM,OAAAK,EAAQL,CAAO,CAAf,CACf,CAAC,CACH,CASA,SAASE,GAAwBZ,EAAaC,EAAiB,CAC7D,OAAO,SAACQ,EAAkB,CAAK,OAAA,SAACC,EAAY,CAAK,OAAAV,EAAOS,CAAU,EAAER,EAAWS,CAAO,CAArC,CAAlB,CACjC,CAOA,SAASC,GAAwBX,EAAW,CAC1C,OAAOI,EAAWJ,EAAO,WAAW,GAAKI,EAAWJ,EAAO,cAAc,CAC3E,CAOA,SAASa,GAA0Bb,EAAW,CAC5C,OAAOI,EAAWJ,EAAO,EAAE,GAAKI,EAAWJ,EAAO,GAAG,CACvD,CAOA,SAASQ,GAAcR,EAAW,CAChC,OAAOI,EAAWJ,EAAO,gBAAgB,GAAKI,EAAWJ,EAAO,mBAAmB,CACrF,CCnMM,SAAUwB,GACdC,EACAC,EACAC,EAAsC,CAEtC,OAAIA,EACKH,GAAoBC,EAAYC,CAAa,EAAE,KAAKE,GAAiBD,CAAc,CAAC,EAGtF,IAAIE,EAAoB,SAACC,EAAU,CACxC,IAAMC,EAAU,UAAA,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAAc,OAAAH,EAAW,KAAKE,EAAE,SAAW,EAAIA,EAAE,CAAC,EAAIA,CAAC,CAAzC,EACzBE,EAAWT,EAAWM,CAAO,EACnC,OAAOI,EAAWT,CAAa,EAAI,UAAA,CAAM,OAAAA,EAAcK,EAASG,CAAQ,CAA/B,EAAmC,MAC9E,CAAC,CACH,CCtBM,SAAUE,GACdC,EACAC,EACAC,EAAyC,CAFzCF,IAAA,SAAAA,EAAA,GAEAE,IAAA,SAAAA,EAAAC,IAIA,IAAIC,EAAmB,GAEvB,OAAIH,GAAuB,OAIrBI,GAAYJ,CAAmB,EACjCC,EAAYD,EAIZG,EAAmBH,GAIhB,IAAIK,EAAW,SAACC,EAAU,CAI/B,IAAIC,EAAMC,GAAYT,CAAO,EAAI,CAACA,EAAUE,EAAW,IAAG,EAAKF,EAE3DQ,EAAM,IAERA,EAAM,GAIR,IAAIE,EAAI,EAGR,OAAOR,EAAU,SAAS,UAAA,CACnBK,EAAW,SAEdA,EAAW,KAAKG,GAAG,EAEf,GAAKN,EAGP,KAAK,SAAS,OAAWA,CAAgB,EAGzCG,EAAW,SAAQ,EAGzB,EAAGC,CAAG,CACR,CAAC,CACH,CChGM,SAAUG,GAAK,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACpB,IAAMC,EAAYC,GAAaH,CAAI,EAC7BI,EAAaC,GAAUL,EAAM,GAAQ,EACrCM,EAAUN,EAChB,OAAQM,EAAQ,OAGZA,EAAQ,SAAW,EAEnBC,EAAUD,EAAQ,CAAC,CAAC,EAEpBE,GAASJ,CAAU,EAAEK,GAAKH,EAASJ,CAAS,CAAC,EAL7CQ,CAMN,CCjEO,IAAMC,GAAQ,IAAIC,EAAkBC,EAAI,ECpCvC,IAAAC,GAAY,MAAK,QAMnB,SAAUC,GAAkBC,EAAiB,CACjD,OAAOA,EAAK,SAAW,GAAKF,GAAQE,EAAK,CAAC,CAAC,EAAIA,EAAK,CAAC,EAAKA,CAC5D,CCoDM,SAAUC,EAAUC,EAAiDC,EAAa,CACtF,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAEhC,IAAIC,EAAQ,EAIZF,EAAO,UAILG,EAAyBF,EAAY,SAACG,EAAK,CAAK,OAAAP,EAAU,KAAKC,EAASM,EAAOF,GAAO,GAAKD,EAAW,KAAKG,CAAK,CAAhE,CAAiE,CAAC,CAEtH,CAAC,CACH,CCxBM,SAAUC,IAAG,SAACC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAClB,IAAMC,EAAiBC,GAAkBH,CAAI,EAEvCI,EAAUC,GAAeL,CAAI,EAEnC,OAAOI,EAAQ,OACX,IAAIE,EAAsB,SAACC,EAAU,CAGnC,IAAIC,EAAuBJ,EAAQ,IAAI,UAAA,CAAM,MAAA,CAAA,CAAA,CAAE,EAK3CK,EAAYL,EAAQ,IAAI,UAAA,CAAM,MAAA,EAAA,CAAK,EAGvCG,EAAW,IAAI,UAAA,CACbC,EAAUC,EAAY,IACxB,CAAC,EAKD,mBAASC,EAAW,CAClBC,EAAUP,EAAQM,CAAW,CAAC,EAAE,UAC9BE,EACEL,EACA,SAACM,EAAK,CAKJ,GAJAL,EAAQE,CAAW,EAAE,KAAKG,CAAK,EAI3BL,EAAQ,MAAM,SAACM,EAAM,CAAK,OAAAA,EAAO,MAAP,CAAa,EAAG,CAC5C,IAAMC,EAAcP,EAAQ,IAAI,SAACM,EAAM,CAAK,OAAAA,EAAO,MAAK,CAAZ,CAAe,EAE3DP,EAAW,KAAKL,EAAiBA,EAAc,MAAA,OAAAc,EAAA,CAAA,EAAAC,EAAIF,CAAM,CAAA,CAAA,EAAIA,CAAM,EAI/DP,EAAQ,KAAK,SAACM,EAAQI,EAAC,CAAK,MAAA,CAACJ,EAAO,QAAUL,EAAUS,CAAC,CAA7B,CAA8B,GAC5DX,EAAW,SAAQ,EAGzB,EACA,UAAA,CAGEE,EAAUC,CAAW,EAAI,GAIzB,CAACF,EAAQE,CAAW,EAAE,QAAUH,EAAW,SAAQ,CACrD,CAAC,CACF,GA9BIG,EAAc,EAAG,CAACH,EAAW,QAAUG,EAAcN,EAAQ,OAAQM,MAArEA,CAAW,EAmCpB,OAAO,UAAA,CACLF,EAAUC,EAAY,IACxB,CACF,CAAC,EACDU,CACN,CC9DM,SAAUC,GAASC,EAAoD,CAC3E,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAW,GACXC,EAAsB,KACtBC,EAA6C,KAC7CC,EAAa,GAEXC,EAAc,UAAA,CAGlB,GAFAF,GAAkB,MAAlBA,EAAoB,YAAW,EAC/BA,EAAqB,KACjBF,EAAU,CACZA,EAAW,GACX,IAAMK,EAAQJ,EACdA,EAAY,KACZF,EAAW,KAAKM,CAAK,EAEvBF,GAAcJ,EAAW,SAAQ,CACnC,EAEMO,EAAkB,UAAA,CACtBJ,EAAqB,KACrBC,GAAcJ,EAAW,SAAQ,CACnC,EAEAD,EAAO,UACLS,EACER,EACA,SAACM,EAAK,CACJL,EAAW,GACXC,EAAYI,EACPH,GACHM,EAAUZ,EAAiBS,CAAK,CAAC,EAAE,UAChCH,EAAqBK,EAAyBR,EAAYK,EAAaE,CAAe,CAAE,CAG/F,EACA,UAAA,CACEH,EAAa,IACZ,CAACH,GAAY,CAACE,GAAsBA,EAAmB,SAAWH,EAAW,SAAQ,CACxF,CAAC,CACF,CAEL,CAAC,CACH,CC3CM,SAAUU,GAAaC,EAAkBC,EAAyC,CAAzC,OAAAA,IAAA,SAAAA,EAAAC,IACtCC,GAAM,UAAA,CAAM,OAAAC,GAAMJ,EAAUC,CAAS,CAAzB,CAA0B,CAC/C,CCEM,SAAUI,GAAeC,EAAoBC,EAAsC,CAAtC,OAAAA,IAAA,SAAAA,EAAA,MAGjDA,EAAmBA,GAAgB,KAAhBA,EAAoBD,EAEhCE,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAiB,CAAA,EACjBC,EAAQ,EAEZH,EAAO,UACLI,EACEH,EACA,SAACI,EAAK,aACAC,EAAuB,KAKvBH,IAAUL,IAAsB,GAClCI,EAAQ,KAAK,CAAA,CAAE,MAIjB,QAAqBK,EAAAC,GAAAN,CAAO,EAAAO,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAAzB,IAAMG,EAAMD,EAAA,MACfC,EAAO,KAAKL,CAAK,EAMbR,GAAca,EAAO,SACvBJ,EAASA,GAAM,KAANA,EAAU,CAAA,EACnBA,EAAO,KAAKI,CAAM,uGAItB,GAAIJ,MAIF,QAAqBK,EAAAH,GAAAF,CAAM,EAAAM,EAAAD,EAAA,KAAA,EAAA,CAAAC,EAAA,KAAAA,EAAAD,EAAA,KAAA,EAAE,CAAxB,IAAMD,EAAME,EAAA,MACfC,GAAUX,EAASQ,CAAM,EACzBT,EAAW,KAAKS,CAAM,sGAG5B,EACA,UAAA,aAGE,QAAqBI,EAAAN,GAAAN,CAAO,EAAAa,EAAAD,EAAA,KAAA,EAAA,CAAAC,EAAA,KAAAA,EAAAD,EAAA,KAAA,EAAE,CAAzB,IAAMJ,EAAMK,EAAA,MACfd,EAAW,KAAKS,CAAM,oGAExBT,EAAW,SAAQ,CACrB,EAEA,OACA,UAAA,CAEEC,EAAU,IACZ,CAAC,CACF,CAEL,CAAC,CACH,CCbM,SAAUc,GACdC,EAAgD,CAEhD,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAgC,KAChCC,EAAY,GACZC,EAEJF,EAAWF,EAAO,UAChBK,EAAyBJ,EAAY,OAAW,OAAW,SAACK,EAAG,CAC7DF,EAAgBG,EAAUT,EAASQ,EAAKT,GAAWC,CAAQ,EAAEE,CAAM,CAAC,CAAC,EACjEE,GACFA,EAAS,YAAW,EACpBA,EAAW,KACXE,EAAc,UAAUH,CAAU,GAIlCE,EAAY,EAEhB,CAAC,CAAC,EAGAA,IAMFD,EAAS,YAAW,EACpBA,EAAW,KACXE,EAAe,UAAUH,CAAU,EAEvC,CAAC,CACH,CC/HM,SAAUO,GACdC,EACAC,EACAC,EACAC,EACAC,EAAqC,CAErC,OAAO,SAACC,EAAuBC,EAA2B,CAIxD,IAAIC,EAAWL,EAIXM,EAAaP,EAEbQ,EAAQ,EAGZJ,EAAO,UACLK,EACEJ,EACA,SAACK,EAAK,CAEJ,IAAMC,EAAIH,IAEVD,EAAQD,EAEJP,EAAYQ,EAAOG,EAAOC,CAAC,GAIzBL,EAAW,GAAOI,GAGxBR,GAAcG,EAAW,KAAKE,CAAK,CACrC,EAGAJ,GACG,UAAA,CACCG,GAAYD,EAAW,KAAKE,CAAK,EACjCF,EAAW,SAAQ,CACrB,CAAE,CACL,CAEL,CACF,CCnCM,SAAUO,IAAa,SAAOC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAClC,IAAMC,EAAiBC,GAAkBH,CAAI,EAC7C,OAAOE,EACHE,GAAKL,GAAa,MAAA,OAAAM,EAAA,CAAA,EAAAC,EAAKN,CAAoC,CAAA,CAAA,EAAGO,GAAiBL,CAAc,CAAC,EAC9FM,EAAQ,SAACC,EAAQC,EAAU,CACzBC,GAAiBN,EAAA,CAAEI,CAAM,EAAAH,EAAKM,GAAeZ,CAAI,CAAC,CAAA,CAAA,EAAGU,CAAU,CACjE,CAAC,CACP,CCUM,SAAUG,IAAiB,SAC/BC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAEA,OAAOC,GAAa,MAAA,OAAAC,EAAA,CAAA,EAAAC,EAAIJ,CAAY,CAAA,CAAA,CACtC,CCkBM,SAAUK,GAAYC,EAAoD,CAC9E,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAW,GACXC,EAAsB,KAEtBC,EAA6C,KAE3CC,EAAO,UAAA,CAMX,GAFAD,GAAkB,MAAlBA,EAAoB,YAAW,EAC/BA,EAAqB,KACjBF,EAAU,CAEZA,EAAW,GACX,IAAMI,EAAQH,EACdA,EAAY,KACZF,EAAW,KAAKK,CAAK,EAEzB,EAEAN,EAAO,UACLO,EACEN,EACA,SAACK,EAAQ,CAIPF,GAAkB,MAAlBA,EAAoB,YAAW,EAC/BF,EAAW,GACXC,EAAYG,EAGZF,EAAqBG,EAAyBN,EAAYI,EAAMG,EAAI,EAEpEC,EAAUX,EAAiBQ,CAAK,CAAC,EAAE,UAAUF,CAAkB,CACjE,EACA,UAAA,CAGEC,EAAI,EACJJ,EAAW,SAAQ,CACrB,EAEA,OACA,UAAA,CAEEE,EAAYC,EAAqB,IACnC,CAAC,CACF,CAEL,CAAC,CACH,CCvDM,SAAUM,GAAgBC,EAAiBC,EAAyC,CAAzC,OAAAA,IAAA,SAAAA,EAAAC,IACxCC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAkC,KAClCC,EAAsB,KACtBC,EAA0B,KAExBC,EAAO,UAAA,CACX,GAAIH,EAAY,CAEdA,EAAW,YAAW,EACtBA,EAAa,KACb,IAAMI,EAAQH,EACdA,EAAY,KACZF,EAAW,KAAKK,CAAK,EAEzB,EACA,SAASC,GAAY,CAInB,IAAMC,EAAaJ,EAAYR,EACzBa,EAAMZ,EAAU,IAAG,EACzB,GAAIY,EAAMD,EAAY,CAEpBN,EAAa,KAAK,SAAS,OAAWM,EAAaC,CAAG,EACtDR,EAAW,IAAIC,CAAU,EACzB,OAGFG,EAAI,CACN,CAEAL,EAAO,UACLU,EACET,EACA,SAACK,EAAQ,CACPH,EAAYG,EACZF,EAAWP,EAAU,IAAG,EAGnBK,IACHA,EAAaL,EAAU,SAASU,EAAcX,CAAO,EACrDK,EAAW,IAAIC,CAAU,EAE7B,EACA,UAAA,CAGEG,EAAI,EACJJ,EAAW,SAAQ,CACrB,EAEA,OACA,UAAA,CAEEE,EAAYD,EAAa,IAC3B,CAAC,CACF,CAEL,CAAC,CACH,CCpFM,SAAUS,GAAqBC,EAAe,CAClD,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAW,GACfF,EAAO,UACLG,EACEF,EACA,SAACG,EAAK,CACJF,EAAW,GACXD,EAAW,KAAKG,CAAK,CACvB,EACA,UAAA,CACOF,GACHD,EAAW,KAAKH,CAAa,EAE/BG,EAAW,SAAQ,CACrB,CAAC,CACF,CAEL,CAAC,CACH,CCXM,SAAUI,GAAQC,EAAa,CACnC,OAAOA,GAAS,EAEZ,UAAA,CAAM,OAAAC,CAAA,EACNC,EAAQ,SAACC,EAAQC,EAAU,CACzB,IAAIC,EAAO,EACXF,EAAO,UACLG,EAAyBF,EAAY,SAACG,EAAK,CAIrC,EAAEF,GAAQL,IACZI,EAAW,KAAKG,CAAK,EAIjBP,GAASK,GACXD,EAAW,SAAQ,EAGzB,CAAC,CAAC,CAEN,CAAC,CACP,CC9BM,SAAUI,GAAc,CAC5B,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChCD,EAAO,UAAUE,EAAyBD,EAAYE,EAAI,CAAC,CAC7D,CAAC,CACH,CCCM,SAAUC,GAASC,EAAQ,CAC/B,OAAOC,EAAI,UAAA,CAAM,OAAAD,CAAA,CAAK,CACxB,CC4CM,SAAUE,GACdC,EACAC,EAAmC,CAEnC,OAAIA,EAEK,SAACC,EAAqB,CAC3B,OAAAC,GAAOF,EAAkB,KAAKG,GAAK,CAAC,EAAGC,EAAc,CAAE,EAAGH,EAAO,KAAKH,GAAUC,CAAqB,CAAC,CAAC,CAAvG,EAGGM,GAAS,SAACC,EAAOC,EAAK,CAAK,OAAAC,EAAUT,EAAsBO,EAAOC,CAAK,CAAC,EAAE,KAAKJ,GAAK,CAAC,EAAGM,GAAMH,CAAK,CAAC,CAAzE,CAA0E,CAC9G,CCzCM,SAAUI,GAASC,EAAoBC,EAAyC,CAAzCA,IAAA,SAAAA,EAAAC,IAC3C,IAAMC,EAAWC,GAAMJ,EAAKC,CAAS,EACrC,OAAOI,GAAU,UAAA,CAAM,OAAAF,CAAA,CAAQ,CACjC,CC0EM,SAAUG,EACdC,EACAC,EAA0D,CAA1D,OAAAA,IAAA,SAAAA,EAA+BC,IAK/BF,EAAaA,GAAU,KAAVA,EAAcG,GAEpBC,EAAQ,SAACC,EAAQC,EAAU,CAGhC,IAAIC,EAEAC,EAAQ,GAEZH,EAAO,UACLI,EAAyBH,EAAY,SAACI,EAAK,CAEzC,IAAMC,EAAaV,EAAYS,CAAK,GAKhCF,GAAS,CAACR,EAAYO,EAAaI,CAAU,KAM/CH,EAAQ,GACRD,EAAcI,EAGdL,EAAW,KAAKI,CAAK,EAEzB,CAAC,CAAC,CAEN,CAAC,CACH,CAEA,SAASP,GAAeS,EAAQC,EAAM,CACpC,OAAOD,IAAMC,CACf,CCjHM,SAAUC,GAA8CC,EAAQC,EAAuC,CAC3G,OAAOC,EAAqB,SAACC,EAAMC,EAAI,CAAK,OAAAH,EAAUA,EAAQE,EAAEH,CAAG,EAAGI,EAAEJ,CAAG,CAAC,EAAIG,EAAEH,CAAG,IAAMI,EAAEJ,CAAG,CAApD,CAAqD,CACnG,CC7BM,SAAUK,GAAgBC,EAA6C,CAA7C,OAAAA,IAAA,SAAAA,EAAAC,IACvBC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAW,GACfF,EAAO,UACLG,EACEF,EACA,SAACG,EAAK,CACJF,EAAW,GACXD,EAAW,KAAKG,CAAK,CACvB,EACA,UAAA,CAAM,OAACF,EAAWD,EAAW,SAAQ,EAAKA,EAAW,MAAMJ,EAAY,CAAE,CAAnE,CAAqE,CAC5E,CAEL,CAAC,CACH,CAEA,SAASC,IAAmB,CAC1B,OAAO,IAAIO,EACb,CCMM,SAAUC,IAAO,SAAIC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACzB,OAAO,SAACC,EAAqB,CAAK,OAAAC,GAAOD,EAAQE,EAAE,MAAA,OAAAC,EAAA,CAAA,EAAAC,EAAIN,CAAM,CAAA,CAAA,CAAA,CAA3B,CACpC,CCHM,SAAUO,EAAYC,EAAoB,CAC9C,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAGhC,GAAI,CACFD,EAAO,UAAUC,CAAU,UAE3BA,EAAW,IAAIH,CAAQ,EAE3B,CAAC,CACH,CCMM,SAAUI,GACdC,EACAC,EAAgB,CAEhB,IAAMC,EAAkB,UAAU,QAAU,EAC5C,OAAO,SAACC,EAAqB,CAC3B,OAAAA,EAAO,KACLH,EAAYI,EAAO,SAACC,EAAG,EAAC,CAAK,OAAAL,EAAUK,EAAG,EAAGF,CAAM,CAAtB,CAAuB,EAAIG,GACxDC,GAAK,CAAC,EACNL,EAAkBM,GAAeP,CAAa,EAAIQ,GAAa,UAAA,CAAM,OAAA,IAAIC,EAAJ,CAAgB,CAAC,CAHxF,CAKJ,CC/CM,SAAUC,GAAYC,EAAa,CACvC,OAAOA,GAAS,EACZ,UAAA,CAAM,OAAAC,CAAA,EACNC,EAAQ,SAACC,EAAQC,EAAU,CAKzB,IAAIC,EAAc,CAAA,EAClBF,EAAO,UACLG,EACEF,EACA,SAACG,EAAK,CAEJF,EAAO,KAAKE,CAAK,EAGjBP,EAAQK,EAAO,QAAUA,EAAO,MAAK,CACvC,EACA,UAAA,aAGE,QAAoBG,EAAAC,GAAAJ,CAAM,EAAAK,EAAAF,EAAA,KAAA,EAAA,CAAAE,EAAA,KAAAA,EAAAF,EAAA,KAAA,EAAE,CAAvB,IAAMD,EAAKG,EAAA,MACdN,EAAW,KAAKG,CAAK,oGAEvBH,EAAW,SAAQ,CACrB,EAEA,OACA,UAAA,CAEEC,EAAS,IACX,CAAC,CACF,CAEL,CAAC,CACP,CC1DM,SAAUM,IAAK,SAAIC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACvB,IAAMC,EAAYC,GAAaH,CAAI,EAC7BI,EAAaC,GAAUL,EAAM,GAAQ,EAC3C,OAAAA,EAAOM,GAAeN,CAAI,EAEnBO,EAAQ,SAACC,EAAQC,EAAU,CAChCC,GAASN,CAAU,EAAEO,GAAIC,EAAA,CAAEJ,CAAM,EAAAK,EAAMb,CAA6B,CAAA,EAAGE,CAAS,CAAC,EAAE,UAAUO,CAAU,CACzG,CAAC,CACH,CCcM,SAAUK,IAAS,SACvBC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAEA,OAAOC,GAAK,MAAA,OAAAC,EAAA,CAAA,EAAAC,EAAIJ,CAAY,CAAA,CAAA,CAC9B,CCmEM,SAAUK,GAAUC,EAAqC,OACzDC,EAAQ,IACRC,EAEJ,OAAIF,GAAiB,OACf,OAAOA,GAAkB,UACxBG,EAA4BH,EAAa,MAAzCC,EAAKE,IAAA,OAAG,IAAQA,EAAED,EAAUF,EAAa,OAE5CC,EAAQD,GAILC,GAAS,EACZ,UAAA,CAAM,OAAAG,CAAA,EACNC,EAAQ,SAACC,EAAQC,EAAU,CACzB,IAAIC,EAAQ,EACRC,EAEEC,EAAc,UAAA,CAGlB,GAFAD,GAAS,MAATA,EAAW,YAAW,EACtBA,EAAY,KACRP,GAAS,KAAM,CACjB,IAAMS,EAAW,OAAOT,GAAU,SAAWU,GAAMV,CAAK,EAAIW,EAAUX,EAAMM,CAAK,CAAC,EAC5EM,EAAqBC,EAAyBR,EAAY,UAAA,CAC9DO,EAAmB,YAAW,EAC9BE,EAAiB,CACnB,CAAC,EACDL,EAAS,UAAUG,CAAkB,OAErCE,EAAiB,CAErB,EAEMA,EAAoB,UAAA,CACxB,IAAIC,EAAY,GAChBR,EAAYH,EAAO,UACjBS,EAAyBR,EAAY,OAAW,UAAA,CAC1C,EAAEC,EAAQP,EACRQ,EACFC,EAAW,EAEXO,EAAY,GAGdV,EAAW,SAAQ,CAEvB,CAAC,CAAC,EAGAU,GACFP,EAAW,CAEf,EAEAM,EAAiB,CACnB,CAAC,CACP,CCpFM,SAAUE,GAAcC,EAA6DC,EAAQ,CAMjG,OAAOC,EAAQC,GAAcH,EAAaC,EAAW,UAAU,QAAU,EAAG,EAAI,CAAC,CACnF,CC+CM,SAAUG,GAASC,EAA4B,CAA5BA,IAAA,SAAAA,EAAA,CAAA,GACf,IAAAC,EAAgHD,EAAO,UAAvHE,EAASD,IAAA,OAAG,UAAA,CAAM,OAAA,IAAIE,CAAJ,EAAgBF,EAAEG,EAA4EJ,EAAO,aAAnFK,EAAYD,IAAA,OAAG,GAAIA,EAAEE,EAAuDN,EAAO,gBAA9DO,EAAeD,IAAA,OAAG,GAAIA,EAAEE,EAA+BR,EAAO,oBAAtCS,EAAmBD,IAAA,OAAG,GAAIA,EAUnH,OAAO,SAACE,EAAa,CACnB,IAAIC,EACAC,EACAC,EACAC,EAAW,EACXC,EAAe,GACfC,EAAa,GAEXC,EAAc,UAAA,CAClBL,GAAe,MAAfA,EAAiB,YAAW,EAC5BA,EAAkB,MACpB,EAGMM,GAAQ,UAAA,CACZD,EAAW,EACXN,EAAaE,EAAU,OACvBE,EAAeC,EAAa,EAC9B,EACMG,EAAsB,UAAA,CAG1B,IAAMC,EAAOT,EACbO,GAAK,EACLE,GAAI,MAAJA,EAAM,YAAW,CACnB,EAEA,OAAOC,EAAc,SAACC,EAAQC,GAAU,CACtCT,IACI,CAACE,GAAc,CAACD,GAClBE,EAAW,EAOb,IAAMO,GAAQX,EAAUA,GAAO,KAAPA,EAAWX,EAAS,EAO5CqB,GAAW,IAAI,UAAA,CACbT,IAKIA,IAAa,GAAK,CAACE,GAAc,CAACD,IACpCH,EAAkBa,GAAYN,EAAqBV,CAAmB,EAE1E,CAAC,EAIDe,GAAK,UAAUD,EAAU,EAGvB,CAACZ,GAIDG,EAAW,IAOXH,EAAa,IAAIe,GAAe,CAC9B,KAAM,SAACC,GAAK,CAAK,OAAAH,GAAK,KAAKG,EAAK,CAAf,EACjB,MAAO,SAACC,GAAG,CACTZ,EAAa,GACbC,EAAW,EACXL,EAAkBa,GAAYP,GAAOb,EAAcuB,EAAG,EACtDJ,GAAK,MAAMI,EAAG,CAChB,EACA,SAAU,UAAA,CACRb,EAAe,GACfE,EAAW,EACXL,EAAkBa,GAAYP,GAAOX,CAAe,EACpDiB,GAAK,SAAQ,CACf,EACD,EACDK,EAAUP,CAAM,EAAE,UAAUX,CAAU,EAE1C,CAAC,EAAED,CAAa,CAClB,CACF,CAEA,SAASe,GACPP,EACAY,EAAoD,SACpDC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,EAAA,CAAA,EAAA,UAAAA,CAAA,EAEA,GAAIF,IAAO,GAAM,CACfZ,EAAK,EACL,OAGF,GAAIY,IAAO,GAIX,KAAMG,EAAe,IAAIP,GAAe,CACtC,KAAM,UAAA,CACJO,EAAa,YAAW,EACxBf,EAAK,CACP,EACD,EAED,OAAOW,EAAUC,EAAE,MAAA,OAAAI,EAAA,CAAA,EAAAC,EAAIJ,CAAI,CAAA,CAAA,CAAA,EAAG,UAAUE,CAAY,EACtD,CChHM,SAAUG,EACdC,EACAC,EACAC,EAAyB,WAErBC,EACAC,EAAW,GACf,OAAIJ,GAAsB,OAAOA,GAAuB,UACnDK,EAA8EL,EAAkB,WAAhGG,EAAUE,IAAA,OAAG,IAAQA,EAAEC,EAAuDN,EAAkB,WAAzEC,EAAUK,IAAA,OAAG,IAAQA,EAAEC,EAAgCP,EAAkB,SAAlDI,EAAQG,IAAA,OAAG,GAAKA,EAAEL,EAAcF,EAAkB,WAEnGG,EAAcH,GAAkB,KAAlBA,EAAsB,IAE/BQ,GAAS,CACd,UAAW,UAAA,CAAM,OAAA,IAAIC,GAAcN,EAAYF,EAAYC,CAAS,CAAnD,EACjB,aAAc,GACd,gBAAiB,GACjB,oBAAqBE,EACtB,CACH,CCxIM,SAAUM,GAAQC,EAAa,CACnC,OAAOC,EAAO,SAACC,EAAGC,EAAK,CAAK,OAAAH,GAASG,CAAT,CAAc,CAC5C,CCaM,SAAUC,GAAaC,EAA8B,CACzD,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAS,GAEPC,EAAiBC,EACrBH,EACA,UAAA,CACEE,GAAc,MAAdA,EAAgB,YAAW,EAC3BD,EAAS,EACX,EACAG,EAAI,EAGNC,EAAUR,CAAQ,EAAE,UAAUK,CAAc,EAE5CH,EAAO,UAAUI,EAAyBH,EAAY,SAACM,EAAK,CAAK,OAAAL,GAAUD,EAAW,KAAKM,CAAK,CAA/B,CAAgC,CAAC,CACpG,CAAC,CACH,CCVM,SAAUC,GAAS,SAAOC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EAC9B,IAAMC,EAAYC,GAAaH,CAAM,EACrC,OAAOI,EAAQ,SAACC,EAAQC,EAAU,EAI/BJ,EAAYK,GAAOP,EAAQK,EAAQH,CAAS,EAAIK,GAAOP,EAAQK,CAAM,GAAG,UAAUC,CAAU,CAC/F,CAAC,CACH,CCmBM,SAAUE,EACdC,EACAC,EAA6G,CAE7G,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAyD,KACzDC,EAAQ,EAERC,EAAa,GAIXC,EAAgB,UAAA,CAAM,OAAAD,GAAc,CAACF,GAAmBD,EAAW,SAAQ,CAArD,EAE5BD,EAAO,UACLM,EACEL,EACA,SAACM,EAAK,CAEJL,GAAe,MAAfA,EAAiB,YAAW,EAC5B,IAAIM,EAAa,EACXC,EAAaN,IAEnBO,EAAUb,EAAQU,EAAOE,CAAU,CAAC,EAAE,UACnCP,EAAkBI,EACjBL,EAIA,SAACU,EAAU,CAAK,OAAAV,EAAW,KAAKH,EAAiBA,EAAeS,EAAOI,EAAYF,EAAYD,GAAY,EAAIG,CAAU,CAAzG,EAChB,UAAA,CAIET,EAAkB,KAClBG,EAAa,CACf,CAAC,CACD,CAEN,EACA,UAAA,CACED,EAAa,GACbC,EAAa,CACf,CAAC,CACF,CAEL,CAAC,CACH,CCvFM,SAAUO,EAAaC,EAA8B,CACzD,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChCC,EAAUJ,CAAQ,EAAE,UAAUK,EAAyBF,EAAY,UAAA,CAAM,OAAAA,EAAW,SAAQ,CAAnB,EAAuBG,EAAI,CAAC,EACrG,CAACH,EAAW,QAAUD,EAAO,UAAUC,CAAU,CACnD,CAAC,CACH,CCIM,SAAUI,GAAaC,EAAiDC,EAAiB,CAAjB,OAAAA,IAAA,SAAAA,EAAA,IACrEC,EAAQ,SAACC,EAAQC,EAAU,CAChC,IAAIC,EAAQ,EACZF,EAAO,UACLG,EAAyBF,EAAY,SAACG,EAAK,CACzC,IAAMC,EAASR,EAAUO,EAAOF,GAAO,GACtCG,GAAUP,IAAcG,EAAW,KAAKG,CAAK,EAC9C,CAACC,GAAUJ,EAAW,SAAQ,CAChC,CAAC,CAAC,CAEN,CAAC,CACH,CCqGM,SAAUK,EACdC,EACAC,EACAC,EAA8B,CAK9B,IAAMC,EACJC,EAAWJ,CAAc,GAAKC,GAASC,EAElC,CAAE,KAAMF,EAA2E,MAAKC,EAAE,SAAQC,CAAA,EACnGF,EAEN,OAAOG,EACHE,EAAQ,SAACC,EAAQC,EAAU,QACzBC,EAAAL,EAAY,aAAS,MAAAK,IAAA,QAAAA,EAAA,KAArBL,CAAW,EACX,IAAIM,EAAU,GACdH,EAAO,UACLI,EACEH,EACA,SAACI,EAAK,QACJH,EAAAL,EAAY,QAAI,MAAAK,IAAA,QAAAA,EAAA,KAAhBL,EAAmBQ,CAAK,EACxBJ,EAAW,KAAKI,CAAK,CACvB,EACA,UAAA,OACEF,EAAU,IACVD,EAAAL,EAAY,YAAQ,MAAAK,IAAA,QAAAA,EAAA,KAApBL,CAAW,EACXI,EAAW,SAAQ,CACrB,EACA,SAACK,EAAG,OACFH,EAAU,IACVD,EAAAL,EAAY,SAAK,MAAAK,IAAA,QAAAA,EAAA,KAAjBL,EAAoBS,CAAG,EACvBL,EAAW,MAAMK,CAAG,CACtB,EACA,UAAA,SACMH,KACFD,EAAAL,EAAY,eAAW,MAAAK,IAAA,QAAAA,EAAA,KAAvBL,CAAW,IAEbU,EAAAV,EAAY,YAAQ,MAAAU,IAAA,QAAAA,EAAA,KAApBV,CAAW,CACb,CAAC,CACF,CAEL,CAAC,EAIDW,EACN,CCnIM,SAAUC,GAAYC,EAAsDC,EAAuB,CACvG,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAC1B,IAAAC,EAAuCJ,GAAM,KAANA,EAAU,CAAA,EAA/CK,EAAAD,EAAA,QAAAE,EAAOD,IAAA,OAAG,GAAIA,EAAEE,EAAAH,EAAA,SAAAI,EAAQD,IAAA,OAAG,GAAKA,EACpCE,EAAW,GACXC,EAAsB,KACtBC,EAAiC,KACjCC,EAAa,GAEXC,EAAgB,UAAA,CACpBF,GAAS,MAATA,EAAW,YAAW,EACtBA,EAAY,KACRH,IACFM,EAAI,EACJF,GAAcT,EAAW,SAAQ,EAErC,EAEMY,EAAoB,UAAA,CACxBJ,EAAY,KACZC,GAAcT,EAAW,SAAQ,CACnC,EAEMa,EAAgB,SAACC,GAAQ,CAC7B,OAACN,EAAYO,EAAUnB,EAAiBkB,EAAK,CAAC,EAAE,UAAUE,EAAyBhB,EAAYU,EAAeE,CAAiB,CAAC,CAAhI,EAEID,EAAO,UAAA,CACX,GAAIL,EAAU,CAIZA,EAAW,GACX,IAAMQ,GAAQP,EACdA,EAAY,KAEZP,EAAW,KAAKc,EAAK,EACrB,CAACL,GAAcI,EAAcC,EAAK,EAEtC,EAEAf,EAAO,UACLiB,EACEhB,EAMA,SAACc,GAAK,CACJR,EAAW,GACXC,EAAYO,GACZ,EAAEN,GAAa,CAACA,EAAU,UAAYL,EAAUQ,EAAI,EAAKE,EAAcC,EAAK,EAC9E,EACA,UAAA,CACEL,EAAa,GACb,EAAEJ,GAAYC,GAAYE,GAAa,CAACA,EAAU,SAAWR,EAAW,SAAQ,CAClF,CAAC,CACF,CAEL,CAAC,CACH,CCxFM,SAAUiB,GACdC,EACAC,EACAC,EAAuB,CADvBD,IAAA,SAAAA,EAAAE,IAGA,IAAMC,EAAYC,GAAML,EAAUC,CAAS,EAC3C,OAAOK,GAAS,UAAA,CAAM,OAAAF,CAAA,EAAWF,CAAM,CACzC,CCJM,SAAUK,IAAc,SAAOC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACnC,IAAMC,EAAUC,GAAkBH,CAAM,EAExC,OAAOI,EAAQ,SAACC,EAAQC,EAAU,CAehC,QAdMC,EAAMP,EAAO,OACbQ,EAAc,IAAI,MAAMD,CAAG,EAI7BE,EAAWT,EAAO,IAAI,UAAA,CAAM,MAAA,EAAA,CAAK,EAGjCU,EAAQ,cAMHC,EAAC,CACRC,EAAUZ,EAAOW,CAAC,CAAC,EAAE,UACnBE,EACEP,EACA,SAACQ,EAAK,CACJN,EAAYG,CAAC,EAAIG,EACb,CAACJ,GAAS,CAACD,EAASE,CAAC,IAEvBF,EAASE,CAAC,EAAI,IAKbD,EAAQD,EAAS,MAAMM,EAAQ,KAAON,EAAW,MAEtD,EAGAO,EAAI,CACL,GAnBIL,EAAI,EAAGA,EAAIJ,EAAKI,MAAhBA,CAAC,EAwBVN,EAAO,UACLQ,EAAyBP,EAAY,SAACQ,EAAK,CACzC,GAAIJ,EAAO,CAET,IAAMO,EAAMC,EAAA,CAAIJ,CAAK,EAAAK,EAAKX,CAAW,CAAA,EACrCF,EAAW,KAAKJ,EAAUA,EAAO,MAAA,OAAAgB,EAAA,CAAA,EAAAC,EAAIF,CAAM,CAAA,CAAA,EAAIA,CAAM,EAEzD,CAAC,CAAC,CAEN,CAAC,CACH,CCxFM,SAAUG,IAAG,SAAOC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACxB,OAAOC,EAAQ,SAACC,EAAQC,EAAU,CAChCL,GAAS,MAAA,OAAAM,EAAA,CAACF,CAA8B,EAAAG,EAAMN,CAAuC,CAAA,CAAA,EAAE,UAAUI,CAAU,CAC7G,CAAC,CACH,CCCM,SAAUG,IAAO,SAAkCC,EAAA,CAAA,EAAAC,EAAA,EAAAA,EAAA,UAAA,OAAAA,IAAAD,EAAAC,CAAA,EAAA,UAAAA,CAAA,EACvD,OAAOC,GAAG,MAAA,OAAAC,EAAA,CAAA,EAAAC,EAAIJ,CAAW,CAAA,CAAA,CAC3B,CCYO,SAASK,IAAmC,CACjD,IAAMC,EAAY,IAAIC,GAAwB,CAAC,EAC/C,OAAAC,EAAU,SAAU,mBAAoB,CAAE,KAAM,EAAK,CAAC,EACnD,UAAU,IAAMF,EAAU,KAAK,QAAQ,CAAC,EAGpCA,CACT,CCHO,SAASG,EACdC,EAAkBC,EAAmB,SAChC,CACL,OAAO,MAAM,KAAKA,EAAK,iBAAoBD,CAAQ,CAAC,CACtD,CAuBO,SAASE,EACdF,EAAkBC,EAAmB,SAClC,CACH,IAAME,EAAKC,GAAsBJ,EAAUC,CAAI,EAC/C,GAAI,OAAOE,GAAO,YAChB,MAAM,IAAI,eACR,8BAA8BH,CAAQ,iBACxC,EAGF,OAAOG,CACT,CAsBO,SAASC,GACdJ,EAAkBC,EAAmB,SACtB,CACf,OAAOA,EAAK,cAAiBD,CAAQ,GAAK,MAC5C,CAOO,SAASK,IAA4C,CAnH5D,IAAAC,EAAAC,EAAAC,EAAAC,EAoHE,OACEA,GAAAD,GAAAD,GAAAD,EAAA,SAAS,gBAAT,YAAAA,EAAwB,aAAxB,YAAAC,EAAoC,gBAApC,KAAAC,EACA,SAAS,gBADT,KAAAC,EAEA,MAEJ,CCvEA,IAAMC,GAAYC,EAChBC,EAAU,SAAS,KAAM,SAAS,EAClCA,EAAU,SAAS,KAAM,UAAU,CACrC,EACG,KACCC,GAAa,CAAC,EACdC,EAAU,MAAS,EACnBC,EAAI,IAAMC,GAAiB,GAAK,SAAS,IAAI,EAC7CC,EAAY,CAAC,CACf,EAaK,SAASC,GACdC,EACqB,CACrB,OAAOT,GACJ,KACCK,EAAIK,GAAUD,EAAG,SAASC,CAAM,CAAC,EACjCC,EAAqB,CACvB,CACJ,CC7BO,SAASC,GACdC,EAAiBC,EACI,CACrB,OAAOC,EAAM,IAAMC,EACjBC,EAAUJ,EAAI,YAAY,EAAE,KAAKK,EAAI,IAAM,EAAI,CAAC,EAChDD,EAAUJ,EAAI,YAAY,EAAE,KAAKK,EAAI,IAAM,EAAK,CAAC,CACnD,EACG,KACCJ,EAAUK,GAASC,GAAUC,GAAM,CAAC,CAACD,EAASN,CAAO,CAAC,EAAIQ,GAC1DC,EAAUV,EAAG,QAAQ,QAAQ,CAAC,CAChC,CACF,CACF,CCPA,SAASW,GAAYC,EAAiBC,EAA8B,CAGlE,GAAI,OAAOA,GAAU,UAAY,OAAOA,GAAU,SAChDD,EAAG,WAAaC,EAAM,SAAS,UAGtBA,aAAiB,KAC1BD,EAAG,YAAYC,CAAK,UAGX,MAAM,QAAQA,CAAK,EAC5B,QAAWC,KAAQD,EACjBF,GAAYC,EAAIE,CAAI,CAE1B,CAyBO,SAASC,EACdC,EAAaC,KAAmCC,EAC7C,CACH,IAAMN,EAAK,SAAS,cAAcI,CAAG,EAGrC,GAAIC,EACF,QAAWE,KAAQ,OAAO,KAAKF,CAAU,EACnC,OAAOA,EAAWE,CAAI,GAAM,cAI5B,OAAOF,EAAWE,CAAI,GAAM,UAC9BP,EAAG,aAAaO,EAAMF,EAAWE,CAAI,CAAC,EAEtCP,EAAG,aAAaO,EAAM,EAAE,GAI9B,QAAWN,KAASK,EAClBP,GAAYC,EAAIC,CAAK,EAGvB,OAAOD,CACT,CC9EO,SAASQ,GAAMC,EAAuB,CAC3C,GAAIA,EAAQ,IAAK,CACf,IAAMC,EAAS,GAAGD,EAAQ,KAAO,IAAO,IACxC,MAAO,KAAKA,EAAQ,MAAY,KAAM,QAAQC,CAAM,CAAC,GACvD,KACE,QAAOD,EAAM,SAAS,CAE1B,CCCO,SAASE,GAAYC,EAA+B,CACzD,IAAMC,EAASC,EAAE,SAAU,CAAE,IAAAF,CAAI,CAAC,EAClC,OAAOG,EAAM,KACX,SAAS,KAAK,YAAYF,CAAM,EACzBG,EACLC,EAAUJ,EAAQ,MAAM,EACxBI,EAAUJ,EAAQ,OAAO,EACtB,KACCK,EAAU,IACRC,GAAW,IAAM,IAAI,eAAe,mBAAmBP,CAAG,EAAE,CAAC,CAC9D,CACH,CACJ,EACG,KACCQ,EAAI,IAAG,EAAY,EACnBC,EAAS,IAAM,SAAS,KAAK,YAAYR,CAAM,CAAC,EAChDS,GAAK,CAAC,CACR,EACH,CACH,CCVA,IAAMC,GAAS,IAAIC,EAiBbC,GAAYC,EAAM,IACtB,OAAO,gBAAmB,YACtBC,GAAY,4CAA4C,EACxDC,EAAG,MAAS,CACjB,EACE,KACCC,EAAI,IAAM,IAAI,eAAeC,GAC3BA,EAAQ,QAAQC,GAASR,GAAO,KAAKQ,CAAK,CAAC,CAC5C,CAAC,EACFC,EAAUC,GAAYC,EAAMC,GAAOP,EAAGK,CAAQ,CAAC,EAAE,KAC/CG,EAAS,IAAMH,EAAS,WAAW,CAAC,CACtC,CAAC,EACDI,EAAY,CAAC,CACf,EAaK,SAASC,GACdC,EACa,CACb,MAAO,CACL,MAAQA,EAAG,YACX,OAAQA,EAAG,YACb,CACF,CAuBO,SAASC,GACdD,EACyB,CAMzB,IAAIE,EAASF,EACb,KAAOE,EAAO,cAAgB,GACxBA,EAAO,eACTA,EAASA,EAAO,cAMpB,OAAOhB,GAAU,KACfiB,EAAIT,GAAYA,EAAS,QAAQQ,CAAM,CAAC,EACxCT,EAAUC,GAAYV,GAAO,KAC3BoB,EAAOZ,GAASA,EAAM,SAAWU,CAAM,EACvCL,EAAS,IAAMH,EAAS,UAAUQ,CAAM,CAAC,CAC3C,CAAC,EACDZ,EAAI,IAAMS,GAAeC,CAAE,CAAC,EAC5BK,EAAUN,GAAeC,CAAE,CAAC,CAC9B,CACF,CC3HO,SAASM,GACdC,EACa,CACb,MAAO,CACL,MAAQA,EAAG,YACX,OAAQA,EAAG,YACb,CACF,CASO,SAASC,GACdD,EACyB,CACzB,IAAIE,EAASF,EAAG,cAChB,KAAOE,IAEHF,EAAG,aAAgBE,EAAO,aAC1BF,EAAG,cAAgBE,EAAO,eAE1BA,GAAUF,EAAKE,GAAQ,cAK3B,OAAOA,EAASF,EAAK,MACvB,CAYO,SAASG,GACdH,EACe,CACf,IAAMI,EAA4B,CAAC,EAG/BF,EAASF,EAAG,cAChB,KAAOE,IAEHF,EAAG,YAAeE,EAAO,aACzBF,EAAG,aAAeE,EAAO,eAEzBE,EAAW,KAAKF,CAAM,EAGxBA,GAAUF,EAAKE,GAAQ,cAKzB,OAAIE,EAAW,SAAW,GACxBA,EAAW,KAAK,SAAS,eAAe,EAGnCA,CACT,CC9CO,SAASC,GACdC,EACe,CACf,MAAO,CACL,EAAGA,EAAG,WACN,EAAGA,EAAG,SACR,CACF,CASO,SAASC,GACdD,EACe,CACf,IAAME,EAAOF,EAAG,sBAAsB,EACtC,MAAO,CACL,EAAGE,EAAK,EAAI,OAAO,QACnB,EAAGA,EAAK,EAAI,OAAO,OACrB,CACF,CAWO,SAASC,GACdH,EAC2B,CAC3B,OAAOI,EACLC,EAAU,OAAQ,MAAM,EACxBA,EAAU,OAAQ,QAAQ,CAC5B,EACG,KACCC,GAAU,EAAGC,EAAuB,EACpCC,EAAI,IAAMT,GAAiBC,CAAE,CAAC,EAC9BS,EAAUV,GAAiBC,CAAE,CAAC,CAChC,CACJ,CC3DO,SAASU,GACdC,EACe,CACf,MAAO,CACL,EAAGA,EAAG,WACN,EAAGA,EAAG,SACR,CACF,CAWO,SAASC,GACdD,EAC2B,CAC3B,OAAOE,EACLC,EAAUH,EAAI,QAAQ,EACtBG,EAAU,OAAQ,QAAQ,EAC1BA,EAAU,OAAQ,QAAQ,CAC5B,EACG,KACCC,GAAU,EAAGC,EAAuB,EACpCC,EAAI,IAAMP,GAAwBC,CAAE,CAAC,EACrCO,EAAUR,GAAwBC,CAAE,CAAC,CACvC,CACJ,CCzBA,IAAMQ,GAAS,IAAIC,EAUbC,GAAYC,EAAM,IAAMC,EAC5B,IAAI,qBAAqBC,GAAW,CAClC,QAAWC,KAASD,EAClBL,GAAO,KAAKM,CAAK,CACrB,EAAG,CACD,UAAW,CACb,CAAC,CACH,CAAC,EACE,KACCC,EAAUC,GAAYC,EAAMC,GAAON,EAAGI,CAAQ,CAAC,EAC5C,KACCG,EAAS,IAAMH,EAAS,WAAW,CAAC,CACtC,CACF,EACAI,EAAY,CAAC,CACf,EAaK,SAASC,GACdC,EACqB,CACrB,OAAOZ,GACJ,KACCa,EAAIP,GAAYA,EAAS,QAAQM,CAAE,CAAC,EACpCP,EAAUC,GAAYR,GACnB,KACCgB,EAAO,CAAC,CAAE,OAAAC,CAAO,IAAMA,IAAWH,CAAE,EACpCH,EAAS,IAAMH,EAAS,UAAUM,CAAE,CAAC,EACrCI,EAAI,CAAC,CAAE,eAAAC,CAAe,IAAMA,CAAc,CAC5C,CACF,CACF,CACJ,CAaO,SAASC,GACdN,EAAiBO,EAAY,GACR,CACrB,OAAOC,GAA0BR,CAAE,EAChC,KACCI,EAAI,CAAC,CAAE,EAAAK,CAAE,IAAM,CACb,IAAMC,EAAUC,GAAeX,CAAE,EAC3BY,EAAUC,GAAsBb,CAAE,EACxC,OAAOS,GACLG,EAAQ,OAASF,EAAQ,OAASH,CAEtC,CAAC,EACDO,EAAqB,CACvB,CACJ,CCjFA,IAAMC,GAA4C,CAChD,OAAQC,EAAW,yBAAyB,EAC5C,OAAQA,EAAW,yBAAyB,CAC9C,EAaO,SAASC,GAAUC,EAAuB,CAC/C,OAAOH,GAAQG,CAAI,EAAE,OACvB,CAaO,SAASC,GAAUD,EAAcE,EAAsB,CACxDL,GAAQG,CAAI,EAAE,UAAYE,GAC5BL,GAAQG,CAAI,EAAE,MAAM,CACxB,CAWO,SAASG,GAAYH,EAAmC,CAC7D,IAAMI,EAAKP,GAAQG,CAAI,EACvB,OAAOK,EAAUD,EAAI,QAAQ,EAC1B,KACCE,EAAI,IAAMF,EAAG,OAAO,EACpBG,EAAUH,EAAG,OAAO,CACtB,CACJ,CC9BA,SAASI,GACPC,EAAiBC,EACR,CACT,OAAQD,EAAG,YAAa,CAGtB,KAAK,iBAEH,OAAIA,EAAG,OAAS,QACP,SAAS,KAAKC,CAAI,EAElB,GAGX,KAAK,kBACL,KAAK,oBACH,MAAO,GAGT,QACE,OAAOD,EAAG,iBACd,CACF,CAWO,SAASE,IAAwC,CACtD,OAAOC,EACLC,EAAU,OAAQ,kBAAkB,EAAE,KAAKC,EAAI,IAAM,EAAI,CAAC,EAC1DD,EAAU,OAAQ,gBAAgB,EAAE,KAAKC,EAAI,IAAM,EAAK,CAAC,CAC3D,EACG,KACCC,EAAU,EAAK,CACjB,CACJ,CAOO,SAASC,IAAsC,CACpD,IAAMC,EAAYJ,EAAyB,OAAQ,SAAS,EACzD,KACCK,EAAOC,GAAM,EAAEA,EAAG,SAAWA,EAAG,QAAQ,EACxCL,EAAIK,IAAO,CACT,KAAMC,GAAU,QAAQ,EAAI,SAAW,SACvC,KAAMD,EAAG,IACT,OAAQ,CACNA,EAAG,eAAe,EAClBA,EAAG,gBAAgB,CACrB,CACF,EAAc,EACdD,EAAO,CAAC,CAAE,KAAAG,EAAM,KAAAX,CAAK,IAAM,CACzB,GAAIW,IAAS,SAAU,CACrB,IAAMC,EAASC,GAAiB,EAChC,GAAI,OAAOD,GAAW,YACpB,MAAO,CAACd,GAAwBc,EAAQZ,CAAI,CAChD,CACA,MAAO,EACT,CAAC,EACDc,GAAM,CACR,EAGF,OAAOb,GAAiB,EACrB,KACCc,EAAUH,GAAWA,EAAqBI,EAAZT,CAAiB,CACjD,CACJ,CC1GO,SAASU,IAAmB,CACjC,OAAO,IAAI,IAAI,SAAS,IAAI,CAC9B,CAgBO,SAASC,GACdC,EAA4BC,EAAW,GACjC,CACN,GAAIC,EAAQ,oBAAoB,GAAK,CAACD,EAAU,CAC9C,IAAME,EAAKC,EAAE,IAAK,CAAE,KAAMJ,EAAI,IAAK,CAAC,EACpC,SAAS,KAAK,YAAYG,CAAE,EAC5BA,EAAG,MAAM,EACTA,EAAG,OAAO,CAIZ,MACE,SAAS,KAAOH,EAAI,IAExB,CASO,SAASK,IAA8B,CAC5C,OAAO,IAAIC,CACb,CCxCO,SAASC,IAA0B,CACxC,OAAO,SAAS,KAAK,MAAM,CAAC,CAC9B,CAYO,SAASC,GAAgBC,EAAoB,CAClD,IAAMC,EAAKC,EAAE,IAAK,CAAE,KAAMF,CAAK,CAAC,EAChCC,EAAG,iBAAiB,QAASE,GAAMA,EAAG,gBAAgB,CAAC,EACvDF,EAAG,MAAM,CACX,CAWO,SAASG,GACdC,EACoB,CACpB,OAAOC,EACLC,EAA2B,OAAQ,YAAY,EAC/CF,CACF,EACG,KACCG,EAAIV,EAAe,EACnBW,EAAUX,GAAgB,CAAC,EAC3BY,EAAOV,GAAQA,EAAK,OAAS,CAAC,EAC9BW,EAAY,CAAC,CACf,CACJ,CASO,SAASC,GACdP,EACyB,CACzB,OAAOD,GAAkBC,CAAS,EAC/B,KACCG,EAAIK,GAAMC,GAAmB,QAAQD,CAAE,IAAI,CAAE,EAC7CH,EAAOT,GAAM,OAAOA,GAAO,WAAW,CACxC,CACJ,CCtDO,SAASc,GAAWC,EAAoC,CAC7D,IAAMC,EAAQ,WAAWD,CAAK,EAC9B,OAAOE,GAA0BC,GAC/BF,EAAM,YAAY,IAAME,EAAKF,EAAM,OAAO,CAAC,CAC5C,EACE,KACCG,EAAUH,EAAM,OAAO,CACzB,CACJ,CAOO,SAASI,IAAkC,CAChD,IAAMJ,EAAQ,WAAW,OAAO,EAChC,OAAOK,EACLC,EAAU,OAAQ,aAAa,EAAE,KAAKC,EAAI,IAAM,EAAI,CAAC,EACrDD,EAAU,OAAQ,YAAY,EAAE,KAAKC,EAAI,IAAM,EAAK,CAAC,CACvD,EACG,KACCJ,EAAUH,EAAM,OAAO,CACzB,CACJ,CAcO,SAASQ,GACdC,EAA6BC,EACd,CACf,OAAOD,EACJ,KACCE,EAAUC,GAAUA,EAASF,EAAQ,EAAIG,CAAK,CAChD,CACJ,CC/BO,SAASC,GACdC,EAAmBC,EACD,CAClB,OAAO,IAAIC,EAAiBC,GAAY,CACtC,IAAMC,EAAM,IAAI,eAChB,OAAAA,EAAI,KAAK,MAAO,GAAGJ,CAAG,EAAE,EACxBI,EAAI,aAAe,OAGnBA,EAAI,iBAAiB,OAAQ,IAAM,CAC7BA,EAAI,QAAU,KAAOA,EAAI,OAAS,KACpCD,EAAS,KAAKC,EAAI,QAAQ,EAC1BD,EAAS,SAAS,GAIlBA,EAAS,MAAM,IAAI,MAAMC,EAAI,UAAU,CAAC,CAE5C,CAAC,EAGDA,EAAI,iBAAiB,QAAS,IAAM,CAClCD,EAAS,MAAM,IAAI,MAAM,eAAe,CAAC,CAC3C,CAAC,EAGDC,EAAI,iBAAiB,QAAS,IAAM,CAClCD,EAAS,SAAS,CACpB,CAAC,EAGG,OAAOF,GAAA,YAAAA,EAAS,YAAc,cAChCG,EAAI,iBAAiB,WAAYC,GAAS,CA/FhD,IAAAC,EAgGQ,GAAID,EAAM,iBACRJ,EAAQ,UAAW,KAAMI,EAAM,OAASA,EAAM,MAAS,GAAG,MAIrD,CACL,IAAME,GAASD,EAAAF,EAAI,kBAAkB,gBAAgB,IAAtC,KAAAE,EAA2C,EAC1DL,EAAQ,UAAW,KAAMI,EAAM,OAAS,CAACE,EAAU,GAAG,CACxD,CACF,CAAC,EAGDN,EAAQ,UAAU,KAAK,CAAC,GAI1BG,EAAI,KAAK,EACF,IAAMA,EAAI,MAAM,CACzB,CAAC,CACH,CAcO,SAASI,GACdR,EAAmBC,EACJ,CACf,OAAOF,GAAQC,EAAKC,CAAO,EACxB,KACCQ,EAAUC,GAAOA,EAAI,KAAK,CAAC,EAC3BC,EAAIC,GAAQ,KAAK,MAAMA,CAAI,CAAM,EACjCC,EAAY,CAAC,CACf,CACJ,CAUO,SAASC,GACdd,EAAmBC,EACG,CACtB,IAAMc,EAAM,IAAI,UAChB,OAAOhB,GAAQC,EAAKC,CAAO,EACxB,KACCQ,EAAUC,GAAOA,EAAI,KAAK,CAAC,EAC3BC,EAAID,GAAOK,EAAI,gBAAgBL,EAAK,WAAW,CAAC,EAChDG,EAAY,CAAC,CACf,CACJ,CAUO,SAASG,GACdhB,EAAmBC,EACG,CACtB,IAAMc,EAAM,IAAI,UAChB,OAAOhB,GAAQC,EAAKC,CAAO,EACxB,KACCQ,EAAUC,GAAOA,EAAI,KAAK,CAAC,EAC3BC,EAAID,GAAOK,EAAI,gBAAgBL,EAAK,UAAU,CAAC,EAC/CG,EAAY,CAAC,CACf,CACJ,CC5HO,SAASI,IAAoC,CAClD,MAAO,CACL,EAAG,KAAK,IAAI,EAAG,OAAO,EACtB,EAAG,KAAK,IAAI,EAAG,OAAO,CACxB,CACF,CASO,SAASC,IAAkD,CAChE,OAAOC,EACLC,EAAU,OAAQ,SAAU,CAAE,QAAS,EAAK,CAAC,EAC7CA,EAAU,OAAQ,SAAU,CAAE,QAAS,EAAK,CAAC,CAC/C,EACG,KACCC,EAAIJ,EAAiB,EACrBK,EAAUL,GAAkB,CAAC,CAC/B,CACJ,CC3BO,SAASM,IAAgC,CAC9C,MAAO,CACL,MAAQ,WACR,OAAQ,WACV,CACF,CASO,SAASC,IAA8C,CAC5D,OAAOC,EAAU,OAAQ,SAAU,CAAE,QAAS,EAAK,CAAC,EACjD,KACCC,EAAIH,EAAe,EACnBI,EAAUJ,GAAgB,CAAC,CAC7B,CACJ,CCXO,SAASK,IAAsC,CACpD,OAAOC,EAAc,CACnBC,GAAoB,EACpBC,GAAkB,CACpB,CAAC,EACE,KACCC,EAAI,CAAC,CAACC,EAAQC,CAAI,KAAO,CAAE,OAAAD,EAAQ,KAAAC,CAAK,EAAE,EAC1CC,EAAY,CAAC,CACf,CACJ,CCVO,SAASC,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EAChB,CACtB,IAAMC,EAAQF,EACX,KACCG,GAAwB,MAAM,CAChC,EAGIC,EAAUC,EAAc,CAACH,EAAOD,CAAO,CAAC,EAC3C,KACCK,EAAI,IAAMC,GAAiBR,CAAE,CAAC,CAChC,EAGF,OAAOM,EAAc,CAACJ,EAASD,EAAWI,CAAO,CAAC,EAC/C,KACCE,EAAI,CAAC,CAAC,CAAE,OAAAE,CAAO,EAAG,CAAE,OAAAC,EAAQ,KAAAC,CAAK,EAAG,CAAE,EAAAC,EAAG,EAAAC,CAAE,CAAC,KAAO,CACjD,OAAQ,CACN,EAAGH,EAAO,EAAIE,EACd,EAAGF,EAAO,EAAIG,EAAIJ,CACpB,EACA,KAAAE,CACF,EAAE,CACJ,CACJ,CCzBA,SAASG,GAAQC,EAA+B,CAC9C,OAAOC,EAA8BD,EAAQ,UAAWE,GAAMA,EAAG,IAAI,CACvE,CAWA,SAASC,GAAQH,EAA4B,CAC3C,IAAMI,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAUE,GAAQN,EAAO,YAAYM,CAAI,CAAC,EAGzCF,CACT,CAgBO,SAASG,GACdC,EAAaR,EAAS,IAAI,OAAOQ,CAAG,EACxB,CACZ,IAAMC,EAAQV,GAAQC,CAAM,EACtBI,EAAQD,GAAQH,CAAM,EAGtBU,EAAU,IAAIL,EACpBK,EAAQ,UAAUN,CAAK,EAGvB,IAAMO,EAAQP,EAAM,KAAKQ,EAAe,EAAGC,GAAQ,EAAI,CAAC,EACxD,OAAOH,EACJ,KACCE,EAAe,EACfE,GAAUL,EAAM,KAAKM,EAAUJ,CAAK,CAAC,CAAC,EACtCK,GAAM,CACR,CACJ,CCJA,IAAMC,GAASC,EAAW,WAAW,EAC/BC,GAAiB,KAAK,MAAMF,GAAO,WAAY,EACrDE,GAAO,KAAO,GAAG,IAAI,IAAIA,GAAO,KAAMC,GAAY,CAAC,CAAC,GAW7C,SAASC,IAAwB,CACtC,OAAOF,EACT,CASO,SAASG,EAAQC,EAAqB,CAC3C,OAAOJ,GAAO,SAAS,SAASI,CAAI,CACtC,CAUO,SAASC,GACdC,EAAkBC,EACV,CACR,OAAO,OAAOA,GAAU,YACpBP,GAAO,aAAaM,CAAG,EAAE,QAAQ,IAAKC,EAAM,SAAS,CAAC,EACtDP,GAAO,aAAaM,CAAG,CAC7B,CChCO,SAASE,GACdC,EAASC,EAAmB,SACP,CACrB,OAAOC,EAAW,sBAAsBF,CAAI,IAAKC,CAAI,CACvD,CAYO,SAASE,GACdH,EAASC,EAAmB,SACL,CACvB,OAAOG,EAAY,sBAAsBJ,CAAI,IAAKC,CAAI,CACxD,CC7EO,SAASI,GACdC,EACsB,CACtB,IAAMC,EAASC,EAAW,6BAA8BF,CAAE,EAC1D,OAAOG,EAAUF,EAAQ,QAAS,CAAE,KAAM,EAAK,CAAC,EAC7C,KACCG,EAAI,IAAMF,EAAW,cAAeF,CAAE,CAAC,EACvCI,EAAIC,IAAY,CAAE,KAAM,UAAUA,EAAQ,SAAS,CAAE,EAAE,CACzD,CACJ,CASO,SAASC,GACdN,EACiC,CACjC,GAAI,CAACO,EAAQ,kBAAkB,GAAK,CAACP,EAAG,kBACtC,OAAOQ,EAGT,GAAI,CAACR,EAAG,OAAQ,CACd,IAAMK,EAAUH,EAAW,cAAeF,CAAE,EACxC,UAAUK,EAAQ,SAAS,IAAM,SAAS,YAAY,IACxDL,EAAG,OAAS,GAChB,CAGA,OAAOS,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,KAAAE,CAAK,IAAM,CAC5BZ,EAAG,OAAS,GAGZ,SAAiB,aAAcY,CAAI,CACrC,CAAC,EAGMb,GAAcC,CAAE,EACpB,KACCa,EAAIC,GAASJ,EAAM,KAAKI,CAAK,CAAC,EAC9BC,EAAS,IAAML,EAAM,SAAS,CAAC,EAC/BN,EAAIU,GAAUE,EAAA,CAAE,IAAKhB,GAAOc,EAAQ,CACtC,CACJ,CAAC,CACH,CC5BO,SAASG,GACdC,EAAiB,CAAE,QAAAC,CAAQ,EACN,CACrB,OAAOA,EACJ,KACCC,EAAIC,IAAW,CAAE,OAAQA,IAAWH,CAAG,EAAE,CAC3C,CACJ,CAYO,SAASI,GACdJ,EAAiBK,EACe,CAChC,IAAMC,EAAY,IAAIC,EACtB,OAAAD,EAAU,UAAU,CAAC,CAAE,OAAAE,CAAO,IAAM,CAClCR,EAAG,OAASQ,CACd,CAAC,EAGMT,GAAaC,EAAIK,CAAO,EAC5B,KACCI,EAAIC,GAASJ,EAAU,KAAKI,CAAK,CAAC,EAClCC,EAAS,IAAML,EAAU,SAAS,CAAC,EACnCJ,EAAIQ,GAAUE,EAAA,CAAE,IAAKZ,GAAOU,EAAQ,CACtC,CACJ,CCnEO,SAASG,GACdC,EAAaC,EACA,CACb,OAAIA,IAAU,SAEVC,EAAC,OAAI,MAAM,gCAAgC,GAAIF,EAAI,KAAK,WACtDE,EAAC,OAAI,MAAM,+BAA+B,CAC5C,EAIAA,EAAC,OAAI,MAAM,aAAa,GAAIF,EAAI,KAAK,WACnCE,EAAC,OAAI,MAAM,+BAA+B,CAC5C,CAGN,CAGO,SAASC,MACXC,EACU,CACb,OACEF,EAAC,OAAI,MAAM,cAAc,KAAK,WAC5BA,EAAC,OAAI,MAAM,iCACRE,CACH,CACF,CAEJ,CCvCO,SAASC,GACdC,EAAqBC,EACR,CAIb,GAHAA,EAASA,EAAS,GAAGA,CAAM,eAAeD,CAAE,GAAK,OAG7CC,EAAQ,CACV,IAAMC,EAASD,EAAS,IAAIA,CAAM,GAAK,OACvC,OACEE,EAAC,SAAM,MAAM,gBAAgB,SAAU,GACpCC,GAAcH,CAAM,EACrBE,EAAC,KAAE,KAAMD,EAAQ,MAAM,uBAAuB,SAAU,IACtDC,EAAC,QAAK,wBAAuBH,EAAI,CACnC,CACF,CAEJ,KACE,QACEG,EAAC,SAAM,MAAM,gBAAgB,SAAU,GACpCC,GAAcH,CAAM,EACrBE,EAAC,QAAK,MAAM,uBAAuB,SAAU,IAC3CA,EAAC,QAAK,wBAAuBH,EAAI,CACnC,CACF,CAGN,CC5BO,SAASK,GAAsBC,EAAyB,CAC7D,OACEC,EAAC,UACC,MAAM,uBACN,MAAOC,GAAY,gBAAgB,EACnC,wBAAuB,IAAIF,CAAE,UAC9B,CAEL,CCtBA,IAAAG,GAAuB,SA+BvB,SAASC,GACPC,EAAsBC,EACT,CACb,IAAMC,EAASD,EAAO,EAChBE,EAASF,EAAO,EAGhBG,EAAU,OAAO,KAAKJ,EAAS,KAAK,EACvC,OAAOK,GAAO,CAACL,EAAS,MAAMK,CAAG,CAAC,EAClC,OAAyB,CAACC,EAAMD,IAAQ,CACvC,GAAGC,EAAMC,EAAC,cAAK,GAAAC,SAAWH,CAAG,CAAE,EAAQ,GACzC,EAAG,CAAC,CAAC,EACJ,MAAM,EAAG,EAAE,EAGRI,EAASC,GAAc,EACvBC,EAAM,IAAI,IAAIX,EAAS,SAAUS,EAAO,IAAI,EAC9CG,EAAQ,kBAAkB,GAC5BD,EAAI,aAAa,IAAI,IAAK,OAAO,QAAQX,EAAS,KAAK,EACpD,OAAO,CAAC,CAAC,CAAEa,CAAK,IAAMA,CAAK,EAC3B,OAAO,CAACC,EAAW,CAACC,CAAK,IAAM,GAAGD,CAAS,IAAIC,CAAK,GAAG,KAAK,EAAG,EAAE,CACpE,EAGF,GAAM,CAAE,KAAAC,CAAK,EAAIN,GAAc,EAC/B,OACEH,EAAC,KAAE,KAAM,GAAGI,CAAG,GAAI,MAAM,yBAAyB,SAAU,IAC1DJ,EAAC,WACC,MAAM,uCACN,gBAAeP,EAAS,MAAM,QAAQ,CAAC,GAEtCE,EAAS,GAAKK,EAAC,OAAI,MAAM,iCAAiC,EAC1DL,EAAS,GAAKK,EAAC,UAAIP,EAAS,KAAM,EAClCE,GAAU,GAAKK,EAAC,UAAIP,EAAS,KAAM,EACnCG,EAAS,GAAKH,EAAS,KAAK,OAAS,GACpCA,EAAS,KAEVA,EAAS,MACRO,EAAC,OAAI,MAAM,WACRP,EAAS,KAAK,IAAIiB,GAAO,CACxB,IAAMC,EAAOF,EACTC,KAAOD,EACL,uBAAuBA,EAAKC,CAAG,CAAC,GAChC,cACF,GACJ,OACEV,EAAC,QAAK,MAAO,UAAUW,CAAI,IAAKD,CAAI,CAExC,CAAC,CACH,EAEDd,EAAS,GAAKC,EAAQ,OAAS,GAC9BG,EAAC,KAAE,MAAM,2BACNY,GAAY,4BAA4B,EAAE,KAAG,GAAGf,CACnD,CAEJ,CACF,CAEJ,CAaO,SAASgB,GACdC,EACa,CACb,IAAMC,EAAYD,EAAO,CAAC,EAAE,MACtBE,EAAO,CAAC,GAAGF,CAAM,EAEjBZ,EAASC,GAAc,EAGvBR,EAASqB,EAAK,UAAUC,GAErB,CADG,GAAG,IAAI,IAAIA,EAAI,SAAUf,EAAO,IAAI,CAAC,GACrC,SAAS,GAAG,CACvB,EACK,CAACgB,CAAO,EAAIF,EAAK,OAAOrB,EAAQ,CAAC,EAGnCwB,EAAQH,EAAK,UAAUC,GAAOA,EAAI,MAAQF,CAAS,EACnDI,IAAU,KACZA,EAAQH,EAAK,QAGf,IAAMI,EAAOJ,EAAK,MAAM,EAAGG,CAAK,EAC1BE,EAAOL,EAAK,MAAMG,CAAK,EAGvBG,EAAW,CACf9B,GAAqB0B,EAAS,EAAc,EAAE,CAACvB,GAAUwB,IAAU,EAAE,EACrE,GAAGC,EAAK,IAAIG,GAAW/B,GAAqB+B,EAAS,CAAW,CAAC,EACjE,GAAGF,EAAK,OAAS,CACfrB,EAAC,WAAQ,MAAM,0BACbA,EAAC,WAAQ,SAAU,IACjBA,EAAC,WACEqB,EAAK,OAAS,GAAKA,EAAK,SAAW,EAChCT,GAAY,wBAAwB,EACpCA,GAAY,2BAA4BS,EAAK,MAAM,CAEzD,CACF,EACC,GAAGA,EAAK,IAAIE,GAAW/B,GAAqB+B,EAAS,CAAW,CAAC,CACpE,CACF,EAAI,CAAC,CACP,EAGA,OACEvB,EAAC,MAAG,MAAM,0BACPsB,CACH,CAEJ,CC1IO,SAASE,GAAkBC,EAAiC,CACjE,OACEC,EAAC,MAAG,MAAM,oBACP,OAAO,QAAQD,CAAK,EAAE,IAAI,CAAC,CAACE,EAAKC,CAAK,IACrCF,EAAC,MAAG,MAAO,oCAAoCC,CAAG,IAC/C,OAAOC,GAAU,SAAWC,GAAMD,CAAK,EAAIA,CAC9C,CACD,CACH,CAEJ,CCAO,SAASE,GACdC,EACa,CACb,IAAMC,EAAU,kCAAkCD,CAAI,GACtD,OACEE,EAAC,OAAI,MAAOD,EAAS,OAAM,IACzBC,EAAC,UAAO,MAAM,gBAAgB,SAAU,GAAI,cAAY,OAAO,CACjE,CAEJ,CCpBO,SAASC,GAAYC,EAAiC,CAC3D,OACEC,EAAC,OAAI,MAAM,0BACTA,EAAC,OAAI,MAAM,qBACRD,CACH,CACF,CAEJ,CCcA,SAASE,GAAcC,EAA+B,CAzDtD,IAAAC,EA0DE,IAAMC,EAASC,GAAc,EAGvBC,EAAM,IAAI,IAAI,MAAMJ,EAAQ,OAAO,IAAKE,EAAO,IAAI,EACzD,OACEG,EAAC,MAAG,MAAM,oBACRA,EAAC,KAAE,KAAM,GAAGD,CAAG,GAAI,MAAM,oBACtBJ,EAAQ,QACRC,EAAAC,EAAO,UAAP,YAAAD,EAAgB,QAASD,EAAQ,QAAQ,OAAS,GACjDK,EAAC,QAAK,MAAM,qBACTL,EAAQ,QAAQ,CAAC,CACpB,CAEJ,CACF,CAEJ,CAcO,SAASM,GACdC,EAAqBC,EACR,CA1Ff,IAAAP,EA2FE,IAAMC,EAASC,GAAc,EAC7B,OAAAI,EAAWA,EAAS,OAAOP,GAAQ,CA5FrC,IAAAC,EA4FwC,SAACA,EAAAD,EAAQ,aAAR,MAAAC,EAAoB,QAAM,EAE/DI,EAAC,OAAI,MAAM,cACTA,EAAC,UACC,MAAM,sBACN,aAAYI,GAAY,gBAAgB,GAEvCD,EAAO,QACPP,EAAAC,EAAO,UAAP,YAAAD,EAAgB,QAASO,EAAO,QAAQ,OAAS,GAChDH,EAAC,QAAK,MAAM,qBACTG,EAAO,QAAQ,CAAC,CACnB,CAEJ,EACAH,EAAC,MAAG,MAAM,oBACPE,EAAS,IAAIR,EAAa,CAC7B,CACF,CAEJ,CCdA,IAAIW,GAAW,EAkBR,SAASC,GACdC,EACqB,CAMrB,IAAMC,EACJC,EAAc,CACZC,GAAkBH,CAAE,EACpBI,GAAkBJ,CAAE,CACtB,CAAC,EACE,KACCK,EAAI,CAAC,CAACC,EAAOC,CAAK,IAAMD,GAASC,CAAK,EACtCC,EAAqB,CACvB,EAMEC,EACJC,EAAM,IAAMC,GAAqBX,CAAE,CAAC,EAAE,KACpCY,GAASC,EAAyB,EAClCC,GAAa,CAAC,EAKdC,GAAkBd,CAAO,EACzBI,EAAI,IAAMW,GAAyBhB,CAAE,CAAC,CACxC,EAMF,OAAOC,EAAQ,KACbgB,GAAMC,GAAUA,CAAM,EACtBC,EAAU,IAAMjB,EAAc,CAACD,EAASQ,CAAO,CAAC,CAAC,EACjDJ,EAAI,CAAC,CAACa,EAAQE,CAAM,KAAO,CAAE,OAAAF,EAAQ,OAAAE,CAAO,EAAE,EAC9CC,GAAM,CACR,CACF,CAoBO,SAASC,GACdtB,EAAiBuB,EACe,CAChC,GAAM,CAAE,SAAAC,EAAU,UAAAC,CAAU,EAAIF,EAI1BG,EAAK,cAAc5B,IAAU,GAGnC,OAAOY,EAAM,IAAM,CACjB,IAAMiB,EAAQ,IAAIC,EAMZC,EAAQ,IAAIC,GAAgB,EAAK,EACvCH,EAAM,KAAKI,EAAe,EAAGC,GAAQ,EAAK,CAAC,EACxC,UAAUH,CAAK,EAUlB,IAAMI,EAAQJ,EAAM,KAClBK,GAAShB,GAAUiB,GAAM,CAAC,CAACjB,EAAS,IAAKkB,EAAc,CAAC,EACxD5B,EAAqB,EACrBW,EAAUD,GAAUA,EAASM,EAAWa,CAAK,EAC7CC,EAAIC,GAAQA,EAAK,GAAKb,CAAE,EACxBL,GAAM,CACR,EAIAnB,EAAc,CACZyB,EAAM,KAAKtB,EAAI,CAAC,CAAE,OAAAa,CAAO,IAAMA,CAAM,CAAC,EACtCe,EAAM,KACJd,EAAUoB,GAAQnC,GAAkBmC,EAAM,GAAG,CAAC,EAC9CC,EAAU,EAAK,CACjB,CACF,CAAC,EACE,KAAKnC,EAAIoC,GAAUA,EAAO,KAAKvB,GAAUA,CAAM,CAAC,CAAC,EACjD,UAAUW,CAAK,EAMlB,IAAMa,EAAUb,EAAM,KACpBc,EAAOzB,GAAUA,CAAM,EACvB0B,GAAeX,EAAOR,CAAS,EAC/BpB,EAAI,CAAC,CAACwC,EAAGN,EAAM,CAAE,KAAAO,CAAK,CAAC,IAAM,CAC3B,IAAMC,EAAO/C,EAAG,sBAAsB,EAChCgD,EAAID,EAAK,MAAQ,EAIvB,GAAIR,EAAK,OAAS,UAChB,MAAO,CAAE,EAAAS,EAAG,EAAG,EAAID,EAAK,MAAO,EAI1B,GAAIA,EAAK,GAAKD,EAAK,OAAS,EAAG,CACpC,GAAM,CAAE,OAAAG,CAAO,EAAIC,GAAeX,CAAI,EACtC,MAAO,CAAE,EAAAS,EAAG,EAAG,IAAMC,CAAO,CAC9B,KACE,OAAO,CAAE,EAAAD,EAAG,EAAG,GAAMD,EAAK,MAAO,CAErC,CAAC,CACH,EAIA,OAAA7C,EAAc,CAAC+B,EAAON,EAAOe,CAAO,CAAC,EAClC,UAAU,CAAC,CAACH,EAAM,CAAE,OAAAnB,CAAO,EAAG+B,CAAM,IAAM,CACzCZ,EAAK,MAAM,YAAY,sBAAuB,GAAGnB,EAAO,CAAC,IAAI,EAC7DmB,EAAK,MAAM,YAAY,sBAAuB,GAAGnB,EAAO,CAAC,IAAI,EAI7DmB,EAAK,MAAM,YAAY,iBAAkB,GAAGY,EAAO,CAAC,IAAI,EACxDZ,EAAK,MAAM,YAAY,iBAAkB,GAAGY,EAAO,CAAC,IAAI,EAIxDZ,EAAK,UAAU,OAAO,mBAAuBY,EAAO,EAAK,CAAC,EAC1DZ,EAAK,UAAU,OAAO,sBAAuBY,EAAO,GAAK,CAAC,CAC5D,CAAC,EAIHtB,EAAM,KACJc,EAAOzB,GAAUA,CAAM,EACvB0B,GAAeX,EAAO,CAACY,EAAGN,IAASA,CAAI,EACvCI,EAAOJ,GAAQA,EAAK,OAAS,SAAS,CACxC,EACG,UAAUA,GAAQ,CACjB,IAAMO,EAAOI,GAAeE,EAAW,aAAcb,CAAI,CAAC,EAI1DA,EAAK,MAAM,YAAY,qBAAsB,GAAGO,EAAK,KAAK,IAAI,EAC9DP,EAAK,MAAM,YAAY,oBAAsB,KAAQ,CACvD,CAAC,EAMHV,EAAM,KACJrB,EAAqB,EACrB6C,GAAUC,EAAuB,EACjCV,GAAeX,CAAK,CACtB,EACG,UAAU,CAAC,CAACf,EAAQqB,CAAI,IAAM,CAC7BA,EAAK,UAAU,OAAO,sBAAuBrB,CAAM,CACrD,CAAC,EAGHhB,EAAc,CACZ2B,EAAM,KAAKc,EAAOzB,GAAUA,CAAM,CAAC,EACnCe,CACF,CAAC,EACE,UAAU,CAAC,CAACY,EAAGN,CAAI,IAAM,CACpBA,EAAK,OAAS,UAChBvC,EAAG,aAAa,gBAAiB0B,CAAE,EACnC1B,EAAG,aAAa,gBAAiB,QAAQ,GAEzCA,EAAG,aAAa,mBAAoB0B,CAAE,CAE1C,CAAC,EAGHG,EAAM,KAAKc,EAAOzB,GAAU,CAACA,CAAM,CAAC,EACjC,UAAU,IAAM,CACflB,EAAG,gBAAgB,eAAe,EAClCA,EAAG,gBAAgB,kBAAkB,EACrCA,EAAG,gBAAgB,eAAe,CACpC,CAAC,EAGID,GAAcC,CAAE,EACpB,KACCsC,EAAIiB,GAAS5B,EAAM,KAAK4B,CAAK,CAAC,EAC9BC,EAAS,IAAM7B,EAAM,SAAS,CAAC,EAC/BtB,EAAIkD,GAAUE,EAAA,CAAE,IAAKzD,GAAOuD,EAAQ,CACtC,CACJ,CAAC,CACH,CAeO,SAASG,GACd1D,EAAiB,CAAE,UAAAyB,CAAU,EAC7BkC,EAAY,SAAS,KACW,CAChC,OAAOrC,GAActB,EAAI,CACvB,SAAU,IAAI4D,EAAwBC,GAAY,CAChD,IAAMC,EAAQ9D,EAAG,MACXuC,EAAOwB,GAAqBD,CAAK,EACvC,OAAAD,EAAS,KAAKtB,CAAI,EAClBvC,EAAG,gBAAgB,OAAO,EAE1B2D,EAAU,OAAOpB,CAAI,EACd,IAAM,CACXA,EAAK,OAAO,EACZvC,EAAG,aAAa,QAAS8D,CAAK,CAChC,CACF,CAAC,EACD,UAAArC,CACF,CAAC,CACH,CCjRO,SAASuC,GACdC,EAAiBC,EACO,CACxB,IAAMC,EAAUC,EAAM,IAAMC,EAAc,CACxCC,GAAmBL,CAAE,EACrBM,GAA0BL,CAAS,CACrC,CAAC,CAAC,EACC,KACCM,EAAI,CAAC,CAAC,CAAE,EAAAC,EAAG,EAAAC,CAAE,EAAGC,CAAM,IAAqB,CACzC,GAAM,CAAE,MAAAC,EAAO,OAAAC,CAAO,EAAIC,GAAeb,CAAE,EAC3C,MAAQ,CACN,EAAGQ,EAAIE,EAAO,EAAIC,EAAS,EAC3B,EAAGF,EAAIC,EAAO,EAAIE,EAAS,CAC7B,CACF,CAAC,CACH,EAGF,OAAOE,GAAkBd,CAAE,EACxB,KACCe,EAAUC,GAAUd,EACjB,KACCK,EAAIU,IAAW,CAAE,OAAAD,EAAQ,OAAAC,CAAO,EAAE,EAClCC,GAAK,CAAC,CAACF,GAAU,GAAQ,CAC3B,CACF,CACF,CACJ,CAWO,SAASG,GACdnB,EAAiBC,EAAwB,CAAE,QAAAmB,CAAQ,EAChB,CACnC,GAAM,CAACC,EAASC,CAAK,EAAI,MAAM,KAAKtB,EAAG,QAAQ,EAG/C,OAAOG,EAAM,IAAM,CACjB,IAAMoB,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,EAAe,EAAGC,GAAQ,EAAI,CAAC,EACxD,OAAAJ,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAN,CAAO,EAAG,CACfjB,EAAG,MAAM,YAAY,iBAAkB,GAAGiB,EAAO,CAAC,IAAI,EACtDjB,EAAG,MAAM,YAAY,iBAAkB,GAAGiB,EAAO,CAAC,IAAI,CACxD,EAGA,UAAW,CACTjB,EAAG,MAAM,eAAe,gBAAgB,EACxCA,EAAG,MAAM,eAAe,gBAAgB,CAC1C,CACF,CAAC,EAGD4B,GAAuB5B,CAAE,EACtB,KACC6B,EAAUJ,CAAK,CACjB,EACG,UAAUK,GAAW,CACpB9B,EAAG,gBAAgB,kBAAmB8B,CAAO,CAC/C,CAAC,EAGLC,EACER,EAAM,KAAKS,EAAO,CAAC,CAAE,OAAAhB,CAAO,IAAMA,CAAM,CAAC,EACzCO,EAAM,KAAKU,GAAa,GAAG,EAAGD,EAAO,CAAC,CAAE,OAAAhB,CAAO,IAAM,CAACA,CAAM,CAAC,CAC/D,EACG,UAAU,CAGT,KAAK,CAAE,OAAAA,CAAO,EAAG,CACXA,EACFhB,EAAG,QAAQqB,CAAO,EAElBA,EAAQ,OAAO,CACnB,EAGA,UAAW,CACTrB,EAAG,QAAQqB,CAAO,CACpB,CACF,CAAC,EAGHE,EACG,KACCW,GAAU,GAAIC,EAAuB,CACvC,EACG,UAAU,CAAC,CAAE,OAAAnB,CAAO,IAAM,CACzBK,EAAQ,UAAU,OAAO,qBAAsBL,CAAM,CACvD,CAAC,EAGLO,EACG,KACCa,GAAa,IAAKD,EAAuB,EACzCH,EAAO,IAAM,CAAC,CAAChC,EAAG,YAAY,EAC9BO,EAAI,IAAMP,EAAG,aAAc,sBAAsB,CAAC,EAClDO,EAAI,CAAC,CAAE,EAAAC,CAAE,IAAMA,CAAC,CAClB,EACG,UAAU,CAGT,KAAK6B,EAAQ,CACPA,EACFrC,EAAG,MAAM,YAAY,iBAAkB,GAAG,CAACqC,CAAM,IAAI,EAErDrC,EAAG,MAAM,eAAe,gBAAgB,CAC5C,EAGA,UAAW,CACTA,EAAG,MAAM,eAAe,gBAAgB,CAC1C,CACF,CAAC,EAGLsC,EAAsBhB,EAAO,OAAO,EACjC,KACCO,EAAUJ,CAAK,EACfO,EAAOO,GAAM,EAAEA,EAAG,SAAWA,EAAG,QAAQ,CAC1C,EACG,UAAUA,GAAM,CACfA,EAAG,gBAAgB,EACnBA,EAAG,eAAe,CACpB,CAAC,EAGLD,EAAsBhB,EAAO,WAAW,EACrC,KACCO,EAAUJ,CAAK,EACfe,GAAejB,CAAK,CACtB,EACG,UAAU,CAAC,CAACgB,EAAI,CAAE,OAAAvB,CAAO,CAAC,IAAM,CA3OzC,IAAAyB,EA8OU,GAAIF,EAAG,SAAW,GAAKA,EAAG,SAAWA,EAAG,QACtCA,EAAG,eAAe,UAGTvB,EAAQ,CACjBuB,EAAG,eAAe,EAGlB,IAAMG,EAAS1C,EAAG,cAAe,QAAQ,gBAAgB,EACrD0C,aAAkB,YACpBA,EAAO,MAAM,GAEbD,EAAAE,GAAiB,IAAjB,MAAAF,EAAoB,MACxB,CACF,CAAC,EAGLrB,EACG,KACCS,EAAUJ,CAAK,EACfO,EAAOY,GAAUA,IAAWvB,CAAO,EACnCwB,GAAM,GAAG,CACX,EACG,UAAU,IAAM7C,EAAG,MAAM,CAAC,EAGxBD,GAAgBC,EAAIC,CAAS,EACjC,KACC6C,EAAIC,GAASxB,EAAM,KAAKwB,CAAK,CAAC,EAC9BC,EAAS,IAAMzB,EAAM,SAAS,CAAC,EAC/BhB,EAAIwC,GAAUE,EAAA,CAAE,IAAKjD,GAAO+C,EAAQ,CACtC,CACJ,CAAC,CACH,CCxMA,SAASG,GAAUC,EAAuC,CACxD,OAAOA,EAAU,UAAY,OACzBC,EAAY,eAAgBD,CAAS,EACrC,CAACA,CAAS,CAChB,CASA,SAASE,GAAYF,EAAgC,CACnD,IAAMG,EAAkB,CAAC,EACzB,QAAWC,KAAML,GAAUC,CAAS,EAAG,CACrC,IAAMK,EAAgB,CAAC,EAGjBC,EAAK,SAAS,mBAAmBF,EAAI,WAAW,SAAS,EAC/D,QAASG,EAAOD,EAAG,SAAS,EAAGC,EAAMA,EAAOD,EAAG,SAAS,EACtDD,EAAM,KAAKE,CAAY,EAGzB,QAASC,KAAQH,EAAO,CACtB,IAAII,EAGJ,KAAQA,EAAQ,gBAAgB,KAAKD,EAAK,WAAY,GAAI,CACxD,GAAM,CAAC,CAAEE,EAAIC,CAAK,EAAIF,EACtB,GAAI,OAAOE,GAAU,YAAa,CAChC,IAAMC,EAASJ,EAAK,UAAUC,EAAM,KAAK,EACzCD,EAAOI,EAAO,UAAUF,EAAG,MAAM,EACjCP,EAAQ,KAAKS,CAAM,CAGrB,KAAO,CACLJ,EAAK,YAAcE,EACnBP,EAAQ,KAAKK,CAAI,EACjB,KACF,CACF,CACF,CACF,CACA,OAAOL,CACT,CAQA,SAASU,GAAKC,EAAqBC,EAA2B,CAC5DA,EAAO,OAAO,GAAG,MAAM,KAAKD,EAAO,UAAU,CAAC,CAChD,CAoBO,SAASE,GACdZ,EAAiBJ,EAAwB,CAAE,QAAAiB,EAAS,OAAAC,CAAO,EACxB,CAGnC,IAAMC,EAASnB,EAAU,QAAQ,MAAM,EACjCoB,EAASD,GAAA,YAAAA,EAAQ,GAGjBE,EAAc,IAAI,IACxB,QAAWT,KAAUV,GAAYF,CAAS,EAAG,CAC3C,GAAM,CAAC,CAAEU,CAAE,EAAIE,EAAO,YAAa,MAAM,WAAW,EAChDU,GAAmB,yBAAyBZ,CAAE,IAAKN,CAAE,IACvDiB,EAAY,IAAIX,EAAIa,GAAiBb,EAAIU,CAAM,CAAC,EAChDR,EAAO,YAAYS,EAAY,IAAIX,CAAE,CAAE,EAE3C,CAGA,OAAIW,EAAY,OAAS,EAChBG,EAGFC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,EAAe,EAAGC,GAAQ,EAAI,CAAC,EAGlDC,EAAsC,CAAC,EAC7C,OAAW,CAACrB,EAAIsB,CAAU,IAAKX,EAC7BU,EAAM,KAAK,CACTE,EAAW,cAAeD,CAAU,EACpCC,EAAW,yBAAyBvB,CAAE,IAAKN,CAAE,CAC/C,CAAC,EAGH,OAAAc,EAAO,KAAKgB,EAAUN,CAAK,CAAC,EACzB,UAAUO,GAAU,CACnB/B,EAAG,OAAS,CAAC+B,EAGb/B,EAAG,UAAU,OAAO,qBAAsB+B,CAAM,EAGhD,OAAW,CAACC,EAAOC,CAAK,IAAKN,EACtBI,EAGHtB,GAAKuB,EAAOC,CAAK,EAFjBxB,GAAKwB,EAAOD,CAAK,CAGvB,CAAC,EAGIE,EAAM,GAAG,CAAC,GAAGjB,CAAW,EAC5B,IAAI,CAAC,CAAC,CAAEW,CAAU,IACjBO,GAAgBP,EAAYhC,EAAW,CAAE,QAAAiB,CAAQ,CAAC,CACnD,CACH,EACG,KACCuB,EAAS,IAAMd,EAAM,SAAS,CAAC,EAC/Be,GAAM,CACR,CACJ,CAAC,CACH,CC7JA,SAASC,GAASC,EAA0C,CAC1D,GAAIA,EAAG,mBAAoB,CACzB,IAAMC,EAAUD,EAAG,mBACnB,GAAIC,EAAQ,UAAY,KACtB,OAAOA,EAGJ,GAAIA,EAAQ,UAAY,KAAO,CAACA,EAAQ,SAAS,OACpD,OAAOF,GAASE,CAAO,CAC3B,CAIF,CAcO,SAASC,GACdF,EAAiBG,EACkB,CACnC,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAON,GAASC,CAAE,EACxB,OAAO,OAAOK,GAAS,YACnBC,GAAoBD,EAAML,EAAIG,CAAO,EACrCI,CACN,CAAC,CACH,CCjEA,IAAAC,GAAwB,SA4ExB,IAAIC,GAAW,EAaf,SAASC,GAAkBC,EAA0C,CACnE,GAAIA,EAAG,mBAAoB,CACzB,IAAMC,EAAUD,EAAG,mBACnB,GAAIC,EAAQ,UAAY,KACtB,OAAOA,EAGJ,GAAIA,EAAQ,UAAY,KAAO,CAACA,EAAQ,SAAS,OACpD,OAAOF,GAAkBE,CAAO,CACpC,CAIF,CAgBO,SAASC,GACdF,EACsB,CACtB,OAAOG,GAAiBH,CAAE,EACvB,KACCI,EAAI,CAAC,CAAE,MAAAC,CAAM,KAEJ,CACL,WAFcC,GAAsBN,CAAE,EAElB,MAAQK,CAC9B,EACD,EACDE,GAAwB,YAAY,CACtC,CACJ,CAoBO,SAASC,GACdR,EAAiBS,EACiB,CAClC,GAAM,CAAE,QAASC,CAAM,EAAI,WAAW,SAAS,EAGzCC,EAAWC,EAAM,IAAM,CAC3B,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,GAAS,CAAC,CAAC,EACpCH,EAAM,UAAU,CAAC,CAAE,WAAAI,CAAW,IAAM,CAC9BA,GAAcP,EAChBV,EAAG,aAAa,WAAY,GAAG,EAE/BA,EAAG,gBAAgB,UAAU,CACjC,CAAC,EAGD,IAAMkB,EAAoD,CAAC,EAC3D,GAAI,GAAAC,QAAY,YAAY,IACtBnB,EAAG,QAAQ,OAAO,GACpBoB,EAAQ,mBAAmB,GAAK,CAACpB,EAAG,QAAQ,UAAU,GACrD,CACD,IAAMqB,EAASrB,EAAG,QAAQ,KAAK,EAC/BqB,EAAO,GAAK,UAAUvB,IAAU,GAGhC,IAAMwB,EAASC,GAAsBF,EAAO,EAAE,EAC9CA,EAAO,aAAaC,EAAQtB,CAAE,EAC1BoB,EAAQ,kBAAkB,GAC5BF,EAAS,KAAKM,GAAoBF,EAAQ,CAAE,SAAU,CAAC,CAAC,CAC5D,CAIF,IAAMG,EAAYzB,EAAG,QAAQ,YAAY,EACzC,GAAIyB,aAAqB,YAAa,CACpC,IAAMC,EAAO3B,GAAkB0B,CAAS,EAGxC,GAAI,OAAOC,GAAS,cAClBD,EAAU,UAAU,SAAS,UAAU,GACvCL,EAAQ,uBAAuB,GAC9B,CACD,IAAMO,EAAeC,GAAoBF,EAAM1B,EAAIS,CAAO,EAC1DS,EAAS,KACPf,GAAiBsB,CAAS,EACvB,KACCI,EAAUd,CAAK,EACfX,EAAI,CAAC,CAAE,MAAAC,EAAO,OAAAyB,CAAO,IAAMzB,GAASyB,CAAM,EAC1CC,EAAqB,EACrBC,EAAUC,GAAUA,EAASN,EAAeO,CAAK,CACnD,CACJ,CACF,CACF,CAOA,OADcC,EAAY,oBAAqBnC,CAAE,EACvC,QACRA,EAAG,UAAU,IAAI,kBAAkB,EAG9BE,GAAeF,CAAE,EACrB,KACCoC,EAAIC,GAASxB,EAAM,KAAKwB,CAAK,CAAC,EAC9BC,EAAS,IAAMzB,EAAM,SAAS,CAAC,EAC/BT,EAAIiC,GAAUE,EAAA,CAAE,IAAKvC,GAAOqC,EAAQ,EACpCG,GAAU,GAAGtB,CAAQ,CACvB,CACJ,CAAC,EAGD,OAAIE,EAAQ,cAAc,EACjBqB,GAAuBzC,CAAE,EAC7B,KACC0C,EAAOC,GAAWA,CAAO,EACzBC,GAAK,CAAC,EACNZ,EAAU,IAAMrB,CAAQ,CAC1B,EAGGA,CACT,CCnLO,SAASkC,GACdC,EAAwB,CAAE,QAAAC,EAAS,OAAAC,CAAO,EACrB,CACrB,IAAIC,EAAO,GACX,OAAOC,EAGLH,EACG,KACCI,EAAIC,GAAUA,EAAO,QAAQ,qBAAqB,CAAE,EACpDC,EAAOC,GAAWR,IAAOQ,CAAO,EAChCH,EAAI,KAAO,CACT,OAAQ,OAAQ,OAAQ,EAC1B,EAAa,CACf,EAGFH,EACG,KACCK,EAAOE,GAAUA,GAAU,CAACN,CAAI,EAChCO,EAAI,IAAMP,EAAOH,EAAG,IAAI,EACxBK,EAAII,IAAW,CACb,OAAQA,EAAS,OAAS,OAC5B,EAAa,CACf,CACJ,CACF,CAaO,SAASE,GACdX,EAAwBY,EACQ,CAChC,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,OAAAE,EAAQ,OAAAC,CAAO,IAAM,CACtCjB,EAAG,gBAAgB,OAAQgB,IAAW,MAAM,EACxCC,GACFjB,EAAG,eAAe,CACtB,CAAC,EAGMD,GAAaC,EAAIY,CAAO,EAC5B,KACCF,EAAIQ,GAASJ,EAAM,KAAKI,CAAK,CAAC,EAC9BC,EAAS,IAAML,EAAM,SAAS,CAAC,EAC/BT,EAAIa,GAAUE,EAAA,CAAE,IAAKpB,GAAOkB,EAAQ,CACtC,CACJ,CAAC,CACH,CCzIA,IAAAG,GAAA,mvLCqDA,IAAIC,GAKAC,GAAW,EAWf,SAASC,IAAiC,CACxC,OAAO,OAAO,SAAY,aAAe,mBAAmB,QACxDC,GAAY,kDAAkD,EAC9DC,EAAG,MAAS,CAClB,CAaO,SAASC,GACdC,EACgC,CAChC,OAAAA,EAAG,UAAU,OAAO,SAAS,EAC7BN,QAAaE,GAAa,EACvB,KACCK,EAAI,IAAM,QAAQ,WAAW,CAC3B,YAAa,GACb,SAAAC,GACA,SAAU,CACR,cAAe,OACf,gBAAiB,OACjB,aAAc,MAChB,CACF,CAAC,CAAC,EACFC,EAAI,IAAG,EAAY,EACnBC,EAAY,CAAC,CACf,GAGFV,GAAS,UAAU,IAAYW,GAAA,sBAC7BL,EAAG,UAAU,IAAI,SAAS,EAC1B,IAAMM,EAAK,aAAaX,IAAU,GAG5BY,EAAOC,EAAE,MAAO,CAAE,MAAO,SAAU,CAAC,EACpCC,EAAOT,EAAG,YAGV,CAAE,IAAAU,EAAK,GAAAC,CAAG,EAAI,MAAM,QAAQ,OAAOL,EAAIG,CAAI,EAG3CG,EAASL,EAAK,aAAa,CAAE,KAAM,QAAS,CAAC,EACnDK,EAAO,UAAYF,EAGnBV,EAAG,YAAYO,CAAI,EACnBI,GAAA,MAAAA,EAAKC,EACP,EAAC,EAGMlB,GACJ,KACCS,EAAI,KAAO,CAAE,IAAKH,CAAG,EAAE,CACzB,CACJ,CCtFA,IAAMa,GAAWC,EAAE,OAAO,EAgBnB,SAASC,GACdC,EACkC,CAClC,OAAAA,EAAG,YAAYH,EAAQ,EACvBA,GAAS,YAAYI,GAAYD,CAAE,CAAC,EAG7BE,EAAG,CAAE,IAAKF,CAAG,CAAC,CACvB,CC4BO,SAASG,GACdC,EACyB,CACzB,IAAMC,EAAUD,EAAO,KAAKE,GAASA,EAAM,OAAO,GAAKF,EAAO,CAAC,EAC/D,OAAOG,EAAM,GAAGH,EAAO,IAAIE,GAASE,EAAUF,EAAO,QAAQ,EAC1D,KACCG,EAAI,IAAMC,EAA6B,cAAcJ,EAAM,EAAE,IAAI,CAAC,CACpE,CACF,CAAC,EACE,KACCK,EAAUD,EAA6B,cAAcL,EAAQ,EAAE,IAAI,CAAC,EACpEI,EAAIG,IAAW,CAAE,OAAAA,CAAO,EAAE,CAC5B,CACJ,CAUO,SAASC,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACF,CACpC,IAAMC,EAAYP,EAAW,iBAAkBI,CAAE,EAC3CV,EAASc,EAA8B,iBAAkBJ,CAAE,EAG3DK,EAAOC,GAAoB,MAAM,EACvCN,EAAG,OAAOK,CAAI,EAGd,IAAME,EAAOD,GAAoB,MAAM,EACvC,OAAAN,EAAG,OAAOO,CAAI,EAGPC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,EAAe,EAAGC,GAAQ,EAAI,CAAC,EACxDC,EAAc,CAACL,EAAOM,GAAiBf,CAAE,EAAGgB,GAAuBhB,CAAE,CAAC,CAAC,EACpE,KACCiB,EAAUN,CAAK,EACfO,GAAU,EAAGC,EAAuB,CACtC,EACG,UAAU,CAGT,KAAK,CAAC,CAAE,OAAArB,CAAO,EAAGsB,CAAI,EAAG,CACvB,IAAMC,EAASC,GAAiBxB,CAAM,EAChC,CAAE,MAAAyB,CAAM,EAAIC,GAAe1B,CAAM,EAGvCE,EAAG,MAAM,YAAY,mBAAoB,GAAGqB,EAAO,CAAC,IAAI,EACxDrB,EAAG,MAAM,YAAY,uBAAwB,GAAGuB,CAAK,IAAI,EAGzD,IAAME,EAAUC,GAAwBvB,CAAS,GAE/CkB,EAAO,EAAYI,EAAQ,GAC3BJ,EAAO,EAAIE,EAAQE,EAAQ,EAAIL,EAAK,QAEpCjB,EAAU,SAAS,CACjB,KAAM,KAAK,IAAI,EAAGkB,EAAO,EAAI,EAAE,EAC/B,SAAU,QACZ,CAAC,CACL,EAGA,UAAW,CACTrB,EAAG,MAAM,eAAe,kBAAkB,EAC1CA,EAAG,MAAM,eAAe,sBAAsB,CAChD,CACF,CAAC,EAGLc,EAAc,CACZa,GAA0BxB,CAAS,EACnCY,GAAiBZ,CAAS,CAC5B,CAAC,EACE,KACCc,EAAUN,CAAK,CACjB,EACG,UAAU,CAAC,CAACU,EAAQD,CAAI,IAAM,CAC7B,IAAMK,EAAUG,GAAsBzB,CAAS,EAC/CE,EAAK,OAASgB,EAAO,EAAI,GACzBd,EAAK,OAASc,EAAO,EAAII,EAAQ,MAAQL,EAAK,MAAQ,EACxD,CAAC,EAGL3B,EACEC,EAAUW,EAAM,OAAO,EAAE,KAAKV,EAAI,IAAM,EAAE,CAAC,EAC3CD,EAAUa,EAAM,OAAO,EAAE,KAAKZ,EAAI,IAAM,CAAE,CAAC,CAC7C,EACG,KACCsB,EAAUN,CAAK,CACjB,EACG,UAAUkB,GAAa,CACtB,GAAM,CAAE,MAAAN,CAAM,EAAIC,GAAerB,CAAS,EAC1CA,EAAU,SAAS,CACjB,KAAMoB,EAAQM,EACd,SAAU,QACZ,CAAC,CACH,CAAC,EAGL3B,EACG,KACCe,EAAUN,CAAK,EACfmB,EAAOtC,GAASF,EAAO,SAASE,CAAyB,CAAC,CAC5D,EACG,UAAUA,GAASA,EAAM,MAAM,CAAC,EAGrCW,EAAU,UAAU,IAAI,uBAAuB,EAC/C,QAAWX,KAASF,EAAQ,CAC1B,IAAMyC,EAAQnC,EAA6B,cAAcJ,EAAM,EAAE,IAAI,EACrEuC,EAAM,gBAAgBC,EAAE,IAAK,CAC3B,KAAM,IAAID,EAAM,OAAO,GACvB,SAAU,EACZ,EAAG,GAAG,MAAM,KAAKA,EAAM,UAAU,CAAC,CAAC,EAGnCrC,EAAsBqC,EAAM,kBAAoB,OAAO,EACpD,KACCd,EAAUN,CAAK,EACfmB,EAAOG,GAAM,EAAEA,EAAG,SAAWA,EAAG,QAAQ,EACxCC,EAAID,GAAM,CACRA,EAAG,eAAe,EAClBA,EAAG,gBAAgB,CACrB,CAAC,CACH,EAEG,UAAU,IAAM,CACf,QAAQ,aAAa,CAAC,EAAG,GAAI,IAAIF,EAAM,OAAO,EAAE,EAChDA,EAAM,MAAM,CACd,CAAC,CACP,CAGA,OAAII,EAAQ,mBAAmB,GAC7B1B,EAAM,KACJ2B,GAAK,CAAC,EACNC,GAAepC,CAAS,CAC1B,EACG,UAAU,CAAC,CAAC,CAAE,OAAAH,CAAO,EAAG,CAAE,OAAAuB,CAAO,CAAC,IAAM,CACvC,IAAMiB,EAAMxC,EAAO,UAAU,KAAK,EAClC,GAAIA,EAAO,aAAa,mBAAmB,EACzCA,EAAO,gBAAgB,mBAAmB,MAGrC,CACL,IAAMyC,EAAIvC,EAAG,UAAYqB,EAAO,EAGhC,QAAWmB,KAAOpC,EAAY,aAAa,EACzC,QAAWZ,KAASY,EAClB,iBAAkBoC,CACpB,EAAG,CACD,IAAMT,EAAQnC,EAAW,cAAcJ,EAAM,EAAE,IAAI,EACnD,GACEuC,IAAUjC,GACViC,EAAM,UAAU,KAAK,IAAMO,EAC3B,CACAP,EAAM,aAAa,oBAAqB,EAAE,EAC1CvC,EAAM,MAAM,EACZ,KACF,CACF,CAGF,OAAO,SAAS,CACd,IAAKQ,EAAG,UAAYuC,CACtB,CAAC,EAGD,IAAME,EAAO,SAAmB,QAAQ,GAAK,CAAC,EAC9C,SAAS,SAAU,CAAC,GAAG,IAAI,IAAI,CAACH,EAAK,GAAGG,CAAI,CAAC,CAAC,CAAC,CACjD,CACF,CAAC,EAGLhC,EAAM,KAAKQ,EAAUN,CAAK,CAAC,EACxB,UAAU,IAAM,CACf,QAAW+B,KAAStC,EAA8B,eAAgBJ,CAAE,EAClE0C,EAAM,MAAM,CAChB,CAAC,EAGIrD,GAAiBC,CAAM,EAC3B,KACC4C,EAAIS,GAASlC,EAAM,KAAKkC,CAAK,CAAC,EAC9BC,EAAS,IAAMnC,EAAM,SAAS,CAAC,EAC/Bd,EAAIgD,GAAUE,EAAA,CAAE,IAAK7C,GAAO2C,EAAQ,CACtC,CACJ,CAAC,EACE,KACCG,GAAYC,EAAc,CAC5B,CACJ,CCpMO,SAASC,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,EAAS,OAAAC,CAAO,EACd,CAChC,OAAOC,EAGL,GAAGC,EAAY,4BAA6BL,CAAE,EAC3C,IAAIM,GAASC,GAAqBD,EAAO,CAAE,QAAAJ,EAAS,OAAAC,CAAO,CAAC,CAAC,EAGhE,GAAGE,EAAY,2BAA4BL,CAAE,EAC1C,IAAIM,GAASE,GAAeF,EAAO,CAAE,QAAAJ,EAAS,OAAAC,CAAO,CAAC,CAAC,EAG1D,GAAGE,EAAY,cAAeL,CAAE,EAC7B,IAAIM,GAASG,GAAaH,CAAK,CAAC,EAGnC,GAAGD,EAAY,qBAAsBL,CAAE,EACpC,IAAIM,GAASI,GAAeJ,CAAK,CAAC,EAGrC,GAAGD,EAAY,UAAWL,CAAE,EACzB,IAAIM,GAASK,GAAaL,EAAO,CAAE,QAAAJ,EAAS,OAAAC,CAAO,CAAC,CAAC,EAGxD,GAAGE,EAAY,cAAeL,CAAE,EAC7B,IAAIM,GAASM,GAAiBN,EAAO,CAAE,UAAAL,EAAW,QAAAC,CAAQ,CAAC,CAAC,EAG/D,GAAGG,EAAY,UAAWL,CAAE,EACzB,OAAO,IAAMa,EAAQ,kBAAkB,CAAC,EACxC,IAAIP,GAASQ,GAAoBR,EAAO,CAAE,UAAAL,CAAU,CAAC,CAAC,CAC3D,CACF,CCtDO,SAASc,GACdC,EAAkB,CAAE,OAAAC,CAAO,EACP,CACpB,OAAOA,EACJ,KACCC,EAAUC,GAAWC,EACnBC,EAAG,EAAI,EACPA,EAAG,EAAK,EAAE,KAAKC,GAAM,GAAI,CAAC,CAC5B,EACG,KACCC,EAAIC,IAAW,CAAE,QAAAL,EAAS,OAAAK,CAAO,EAAE,CACrC,CACF,CACF,CACJ,CAaO,SAASC,GACdC,EAAiBC,EACc,CAC/B,IAAMC,EAAQC,EAAW,cAAeH,CAAE,EAC1C,OAAOI,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,QAAAZ,EAAS,OAAAK,CAAO,IAAM,CACvCE,EAAG,UAAU,OAAO,oBAAqBF,CAAM,EAC/CI,EAAM,YAAcT,CACtB,CAAC,EAGMJ,GAAYW,EAAIC,CAAO,EAC3B,KACCM,EAAIC,GAASH,EAAM,KAAKG,CAAK,CAAC,EAC9BC,EAAS,IAAMJ,EAAM,SAAS,CAAC,EAC/BR,EAAIW,GAAUE,EAAA,CAAE,IAAKV,GAAOQ,EAAQ,CACtC,CACJ,CAAC,CACH,CCnDA,IAAIG,GAAW,EAiBR,SAASC,GACdC,EAAiBC,EACI,CACrB,SAAS,KAAK,OAAOD,CAAE,EAGvB,GAAM,CAAE,MAAAE,CAAM,EAAIC,GAAeH,CAAE,EACnCA,EAAG,MAAM,YAAY,qBAAsB,GAAGE,CAAK,IAAI,EACvDF,EAAG,OAAO,EAGV,IAAMI,EAAYC,GAAoBJ,CAAI,EACpCK,EACJ,OAAOF,GAAc,YACjBG,GAA0BH,CAAS,EACnCI,EAAG,CAAE,EAAG,EAAG,EAAG,CAAE,CAAC,EAGjBC,EAAUC,EACdC,GAAkBV,CAAI,EACtBW,GAAkBX,CAAI,CACxB,EACG,KACCY,EAAqB,CACvB,EAGF,OAAOC,EAAc,CAACL,EAASH,CAAO,CAAC,EACpC,KACCS,EAAI,CAAC,CAACC,EAAQC,CAAM,IAAM,CACxB,GAAI,CAAE,EAAAC,EAAG,EAAAC,CAAE,EAAIC,GAAiBnB,CAAI,EAC9BoB,EAAOlB,GAAeF,CAAI,EAU1BqB,EAAQrB,EAAK,QAAQ,OAAO,EAClC,OAAIqB,GAASrB,EAAK,gBAChBiB,GAAKI,EAAM,WAAarB,EAAK,cAAc,WAC3CkB,GAAKG,EAAM,UAAarB,EAAK,cAAc,WAEtC,CACL,OAAAe,EACA,OAAQ,CACN,EAAGE,EAAID,EAAO,EAAII,EAAK,MAAS,EAAInB,EAAQ,EAC5C,EAAGiB,EAAIF,EAAO,EAAII,EAAK,OAAS,CAClC,CACF,CACF,CAAC,CACH,CACJ,CASO,SAASE,GACdvB,EACgC,CAChC,IAAMwB,EAAQxB,EAAG,MACjB,GAAI,CAACwB,EAAM,OACT,OAAOC,EAGT,IAAMC,EAAK,aAAa5B,IAAU,GAC5B6B,EAAUC,GAAcF,EAAI,QAAQ,EACpCG,EAAUC,EAAW,cAAeH,CAAO,EACjD,OAAAE,EAAQ,UAAYL,EAGbO,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAE,CAAO,EAAG,CACfP,EAAQ,MAAM,YAAY,iBAAkB,GAAGO,EAAO,CAAC,IAAI,EAC3DP,EAAQ,MAAM,YAAY,iBAAkB,GAAGO,EAAO,CAAC,IAAI,CAC7D,EAGA,UAAW,CACTP,EAAQ,MAAM,eAAe,gBAAgB,EAC7CA,EAAQ,MAAM,eAAe,gBAAgB,CAC/C,CACF,CAAC,EAGDjB,EACEsB,EAAM,KAAKG,EAAO,CAAC,CAAE,OAAAnB,CAAO,IAAMA,CAAM,CAAC,EACzCgB,EAAM,KAAKI,GAAa,GAAG,EAAGD,EAAO,CAAC,CAAE,OAAAnB,CAAO,IAAM,CAACA,CAAM,CAAC,CAC/D,EACG,UAAU,CAGT,KAAK,CAAE,OAAAA,CAAO,EAAG,CACXA,GACFhB,EAAG,sBAAsB,WAAY2B,CAAO,EAC5C3B,EAAG,aAAa,mBAAoB0B,CAAE,EACtC1B,EAAG,gBAAgB,OAAO,IAE1B2B,EAAQ,OAAO,EACf3B,EAAG,gBAAgB,kBAAkB,EACrCA,EAAG,aAAa,QAASwB,CAAK,EAElC,EAGA,UAAW,CACTG,EAAQ,OAAO,EACf3B,EAAG,gBAAgB,kBAAkB,EACrCA,EAAG,aAAa,QAASwB,CAAK,CAChC,CACF,CAAC,EAGHQ,EACG,KACCK,GAAU,GAAIC,EAAuB,CACvC,EACG,UAAU,CAAC,CAAE,OAAAtB,CAAO,IAAM,CACzBW,EAAQ,UAAU,OAAO,qBAAsBX,CAAM,CACvD,CAAC,EAMLgB,EACG,KACCO,GAAa,IAAKD,EAAuB,EACzCH,EAAO,IAAM,CAAC,CAACnC,EAAG,YAAY,EAC9Be,EAAI,IAAMf,EAAG,aAAc,sBAAsB,CAAC,EAClDe,EAAI,CAAC,CAAE,EAAAG,CAAE,IAAMA,CAAC,CAClB,EACC,UAAU,CAGT,KAAKsB,EAAQ,CACPA,EACFb,EAAQ,MAAM,YAAY,iBAAkB,GAAG,CAACa,CAAM,IAAI,EAE1Db,EAAQ,MAAM,eAAe,gBAAgB,CACjD,EAGA,UAAW,CACTA,EAAQ,MAAM,eAAe,gBAAgB,CAC/C,CACF,CAAC,EAGI5B,GAAa4B,EAAS3B,CAAE,EAC5B,KACCyC,EAAIC,GAASV,EAAM,KAAKU,CAAK,CAAC,EAC9BC,EAAS,IAAMX,EAAM,SAAS,CAAC,EAC/BjB,EAAI2B,GAAUE,EAAA,CAAE,IAAK5C,GAAO0C,EAAQ,CACtC,CACJ,CAAC,EACE,KACCG,GAAYC,EAAc,CAC5B,CACJ,CC7JA,SAASC,GAAS,CAAE,UAAAC,CAAU,EAAsC,CAClE,GAAI,CAACC,EAAQ,iBAAiB,EAC5B,OAAOC,EAAG,EAAK,EAGjB,IAAMC,EAAaH,EAChB,KACCI,EAAI,CAAC,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,IAAMA,CAAC,EAC5BC,GAAY,EAAG,CAAC,EAChBF,EAAI,CAAC,CAACG,EAAGC,CAAC,IAAM,CAACD,EAAIC,EAAGA,CAAC,CAAU,EACnCC,GAAwB,CAAC,CAC3B,EAGIC,EAAUC,EAAc,CAACX,EAAWG,CAAU,CAAC,EAClD,KACCS,EAAO,CAAC,CAAC,CAAE,OAAAC,CAAO,EAAG,CAAC,CAAER,CAAC,CAAC,IAAM,KAAK,IAAIA,EAAIQ,EAAO,CAAC,EAAI,GAAG,EAC5DT,EAAI,CAAC,CAAC,CAAE,CAACU,CAAS,CAAC,IAAMA,CAAS,EAClCC,EAAqB,CACvB,EAGIC,EAAUC,GAAY,QAAQ,EACpC,OAAON,EAAc,CAACX,EAAWgB,CAAO,CAAC,EACtC,KACCZ,EAAI,CAAC,CAAC,CAAE,OAAAS,CAAO,EAAGK,CAAM,IAAML,EAAO,EAAI,KAAO,CAACK,CAAM,EACvDH,EAAqB,EACrBI,EAAUC,GAAUA,EAASV,EAAUR,EAAG,EAAK,CAAC,EAChDmB,EAAU,EAAK,CACjB,CACJ,CAcO,SAASC,GACdC,EAAiBC,EACG,CACpB,OAAOC,EAAM,IAAMd,EAAc,CAC/Be,GAAiBH,CAAE,EACnBxB,GAASyB,CAAO,CAClB,CAAC,CAAC,EACC,KACCpB,EAAI,CAAC,CAAC,CAAE,OAAAuB,CAAO,EAAGC,CAAM,KAAO,CAC7B,OAAAD,EACA,OAAAC,CACF,EAAE,EACFb,EAAqB,CAACR,EAAGC,IACvBD,EAAE,SAAWC,EAAE,QACfD,EAAE,SAAWC,EAAE,MAChB,EACDqB,EAAY,CAAC,CACf,CACJ,CAaO,SAASC,GACdP,EAAiB,CAAE,QAAAQ,EAAS,MAAAC,CAAM,EACO,CACzC,OAAOP,EAAM,IAAM,CACjB,IAAMQ,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,EAAe,EAAGC,GAAQ,EAAI,CAAC,EACxDJ,EACG,KACCxB,GAAwB,QAAQ,EAChC6B,GAAkBP,CAAO,CAC3B,EACG,UAAU,CAAC,CAAC,CAAE,OAAAX,CAAO,EAAG,CAAE,OAAAQ,CAAO,CAAC,IAAM,CACvCL,EAAG,UAAU,OAAO,oBAAqBH,GAAU,CAACQ,CAAM,EAC1DL,EAAG,OAASK,CACd,CAAC,EAGL,IAAMW,EAAWC,GAAKC,EAAY,UAAWlB,CAAE,CAAC,EAC7C,KACCX,EAAO,IAAMX,EAAQ,kBAAkB,CAAC,EACxCyC,GAASC,GAASC,GAAaD,CAAK,CAAC,CACvC,EAGF,OAAAX,EAAM,UAAUC,CAAK,EAGdF,EACJ,KACCc,EAAUV,CAAK,EACf/B,EAAI0C,GAAUC,EAAA,CAAE,IAAKxB,GAAOuB,EAAQ,EACpCE,GAAUT,EAAS,KAAKM,EAAUV,CAAK,CAAC,CAAC,CAC3C,CACJ,CAAC,CACH,CCjIO,SAASc,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACb,CACzB,OAAOC,GAAgBH,EAAI,CAAE,UAAAC,EAAW,QAAAC,CAAQ,CAAC,EAC9C,KACCE,EAAI,CAAC,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,IAAM,CACzB,GAAM,CAAE,OAAAC,CAAO,EAAIC,GAAeP,CAAE,EACpC,MAAO,CACL,OAAQK,GAAKC,CACf,CACF,CAAC,EACDE,GAAwB,QAAQ,CAClC,CACJ,CAaO,SAASC,GACdT,EAAiBU,EACmB,CACpC,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClBD,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAE,CAAO,EAAG,CACfd,EAAG,UAAU,OAAO,2BAA4Bc,CAAM,CACxD,EAGA,UAAW,CACTd,EAAG,UAAU,OAAO,0BAA0B,CAChD,CACF,CAAC,EAGD,IAAMe,EAAUC,GAAmB,gBAAgB,EACnD,OAAI,OAAOD,GAAY,YACdE,EAGFlB,GAAiBgB,EAASL,CAAO,EACrC,KACCQ,EAAIC,GAASP,EAAM,KAAKO,CAAK,CAAC,EAC9BC,EAAS,IAAMR,EAAM,SAAS,CAAC,EAC/BR,EAAIe,GAAUE,EAAA,CAAE,IAAKrB,GAAOmB,EAAQ,CACtC,CACJ,CAAC,CACH,CChEO,SAASG,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACpB,CAGlB,IAAMC,EAAUD,EACb,KACCE,EAAI,CAAC,CAAE,OAAAC,CAAO,IAAMA,CAAM,EAC1BC,EAAqB,CACvB,EAGIC,EAAUJ,EACb,KACCK,EAAU,IAAMC,GAAiBT,CAAE,EAChC,KACCI,EAAI,CAAC,CAAE,OAAAC,CAAO,KAAO,CACnB,IAAQL,EAAG,UACX,OAAQA,EAAG,UAAYK,CACzB,EAAE,EACFK,GAAwB,QAAQ,CAClC,CACF,CACF,EAGF,OAAOC,EAAc,CAACR,EAASI,EAASN,CAAS,CAAC,EAC/C,KACCG,EAAI,CAAC,CAACQ,EAAQ,CAAE,IAAAC,EAAK,OAAAC,CAAO,EAAG,CAAE,OAAQ,CAAE,EAAAC,CAAE,EAAG,KAAM,CAAE,OAAAV,CAAO,CAAE,CAAC,KAChEA,EAAS,KAAK,IAAI,EAAGA,EACjB,KAAK,IAAI,EAAGQ,EAASE,EAAIH,CAAM,EAC/B,KAAK,IAAI,EAAGP,EAASU,EAAID,CAAM,CACnC,EACO,CACL,OAAQD,EAAMD,EACd,OAAAP,EACA,OAAQQ,EAAMD,GAAUG,CAC1B,EACD,EACDT,EAAqB,CAACU,EAAGC,IACvBD,EAAE,SAAWC,EAAE,QACfD,EAAE,SAAWC,EAAE,QACfD,EAAE,SAAWC,EAAE,MAChB,CACH,CACJ,CCxCO,SAASC,GACdC,EACqB,CACrB,IAAMC,EAAU,SAAkB,WAAW,GAAK,CAChD,MAAOD,EAAO,UAAUE,GAAS,WAC/BA,EAAM,aAAa,qBAAqB,CAC1C,EAAE,OAAO,CACX,EAGMC,EAAQ,KAAK,IAAI,EAAG,KAAK,IAAIF,EAAQ,MAAOD,EAAO,OAAS,CAAC,CAAC,EACpE,OAAOI,EAAG,GAAGJ,CAAM,EAChB,KACCK,GAASH,GAASI,EAAUJ,EAAO,QAAQ,EAAE,KAAKK,EAAI,IAAML,CAAK,CAAC,CAAC,EACnEM,EAAUR,EAAOG,CAAK,CAAC,EACvBI,EAAIL,IAAU,CACZ,MAAOF,EAAO,QAAQE,CAAK,EAC3B,MAAO,CACL,MAASA,EAAM,aAAa,qBAAqB,EACjD,OAASA,EAAM,aAAa,sBAAsB,EAClD,QAASA,EAAM,aAAa,uBAAuB,EACnD,OAASA,EAAM,aAAa,sBAAsB,CACpD,CACF,EAAa,EACbO,EAAY,CAAC,CACf,CACJ,CASO,SAASC,GACdC,EACgC,CAChC,IAAMX,EAASY,EAA8B,QAASD,CAAE,EAClDE,EAAOC,EAAE,OAAQ,CAAE,KAAM,aAAc,CAAC,EAC9C,SAAS,KAAK,YAAYD,CAAI,EAG9B,IAAME,EAASD,EAAE,OAAQ,CAAE,KAAM,cAAe,CAAC,EACjD,SAAS,KAAK,YAAYC,CAAM,EAGhC,IAAMC,EAASC,GAAW,+BAA+B,EACzD,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAUE,GAAW,CAIzB,GAHA,SAAS,KAAK,aAAa,0BAA2B,EAAE,EAGpDA,EAAQ,MAAM,QAAU,yBAA0B,CACpD,IAAMC,EAAQ,WAAW,+BAA+B,EAClDpB,EAAQ,SAAS,cAAcoB,EAAM,QACvC,wDACA,sDACJ,EAGAD,EAAQ,MAAM,OAAUnB,EAAM,aAAa,sBAAsB,EACjEmB,EAAQ,MAAM,QAAUnB,EAAM,aAAa,uBAAuB,EAClEmB,EAAQ,MAAM,OAAUnB,EAAM,aAAa,sBAAsB,CACnE,CAGA,OAAW,CAACqB,EAAKC,CAAK,IAAK,OAAO,QAAQH,EAAQ,KAAK,EACrD,SAAS,KAAK,aAAa,iBAAiBE,CAAG,GAAIC,CAAK,EAG1D,QAASrB,EAAQ,EAAGA,EAAQH,EAAO,OAAQG,IAAS,CAClD,IAAMsB,EAAQzB,EAAOG,CAAK,EAAE,mBACxBsB,aAAiB,cACnBA,EAAM,OAASJ,EAAQ,QAAUlB,EACrC,CAGA,SAAS,YAAakB,CAAO,CAC/B,CAAC,EAGDf,EAAyBK,EAAI,SAAS,EAAE,KACtCe,EAAOC,GAAMA,EAAG,MAAQ,OAAO,EAC/BC,GAAeT,EAAO,CAACU,EAAGR,IAAYA,CAAO,CAC/C,EACG,UAAU,CAAC,CAAE,MAAAlB,CAAM,IAAM,CACxBA,GAASA,EAAQ,GAAKH,EAAO,OAC7BA,EAAOG,CAAK,EAAE,MAAM,EACpBH,EAAOG,CAAK,EAAE,MAAM,CACtB,CAAC,EAGHgB,EACG,KACCZ,EAAI,IAAM,CACR,IAAMuB,EAASC,GAAoB,QAAQ,EACrCC,EAAS,OAAO,iBAAiBF,CAAM,EAG7C,OAAAf,EAAO,QAAUiB,EAAM,YAGhBA,EAAM,gBAAgB,MAAM,MAAM,EACtC,IAAIR,IAAU,CAACA,GAAO,SAAS,EAAE,EAAE,SAAS,EAAG,GAAG,CAAC,EACnD,KAAK,EAAE,CACZ,CAAC,CACH,EACG,UAAUS,GAASpB,EAAK,QAAU,IAAIoB,CAAK,EAAE,EAGlDd,EAAM,KAAKe,GAAUC,EAAc,CAAC,EACjC,UAAU,IAAM,CACf,SAAS,KAAK,gBAAgB,yBAAyB,CACzD,CAAC,EAGIpC,GAAaC,CAAM,EACvB,KACCoC,EAAUpB,EAAO,KAAKqB,GAAK,CAAC,CAAC,CAAC,EAC9BC,GAAO,EACPC,EAAIC,GAASrB,EAAM,KAAKqB,CAAK,CAAC,EAC9BC,EAAS,IAAMtB,EAAM,SAAS,CAAC,EAC/BZ,EAAIiC,GAAUE,EAAA,CAAE,IAAK/B,GAAO6B,EAAQ,CACtC,CACJ,CAAC,CACH,CChJO,SAASG,GACdC,EAAiB,CAAE,UAAAC,CAAU,EACI,CAGjC,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,MAAAE,CAAM,IAAM,CAC7BL,EAAG,MAAM,YAAY,sBAAuB,GAAGK,CAAK,EAAE,CACxD,CAAC,EAGMJ,EACJ,KACCK,EAAID,GAASF,EAAM,KAAK,CAAE,MAAAE,CAAM,CAAC,CAAC,EAClCE,EAAS,IAAMJ,EAAM,SAAS,CAAC,EAC/BK,EAAIH,IAAU,CAAE,IAAKL,EAAI,MAAAK,CAAM,EAAE,CACnC,CACJ,CAAC,CACH,CChEA,IAAAI,GAAwB,SAiCxB,SAASC,GAAQC,EAAyB,CACxCA,EAAG,aAAa,kBAAmB,EAAE,EACrC,IAAMC,EAAOD,EAAG,QAAQ,aAAa,EAC/BE,EAAOD,EACTA,EAAK,aAAa,WAAW,EAC7BD,EAAG,UACP,OAAAA,EAAG,gBAAgB,iBAAiB,EAC7BE,EAAK,QAAQ,CACtB,CAWO,SAASC,GACd,CAAE,OAAAC,CAAO,EACH,CACF,GAAAC,QAAY,YAAY,GAC1B,IAAIC,EAA8BC,GAAc,CAC9C,IAAI,GAAAF,QAAY,iDAAkD,CAChE,KAAML,GACJA,EAAG,aAAa,qBAAqB,GACrCD,GAAQS,EACNR,EAAG,aAAa,uBAAuB,CACzC,CAAC,CAEL,CAAC,EACE,GAAG,UAAWS,GAAMF,EAAW,KAAKE,CAAE,CAAC,CAC5C,CAAC,EACE,KACCC,EAAID,GAAM,CACQA,EAAG,QACX,MAAM,CAChB,CAAC,EACDE,EAAI,IAAMC,GAAY,kBAAkB,CAAC,CAC3C,EACG,UAAUR,CAAM,CAEzB,CCrCA,SAASS,GAAQC,EAAUC,EAAW,CACpC,OAAAD,EAAI,SAAWC,EAAK,SACpBD,EAAI,SAAWC,EAAK,SACbD,CACT,CA2BA,SAASE,GAAQC,EAAoBF,EAAoB,CACvD,IAAMG,EAAmB,IAAI,IAC7B,QAAWC,KAAMC,EAAY,MAAOH,CAAQ,EAAG,CAC7C,IAAMH,EAAMO,EAAW,MAAOF,CAAE,EAG1BG,EAAQ,CAACT,GAAQ,IAAI,IAAIC,EAAI,WAAY,EAAGC,CAAI,CAAC,EACvDG,EAAQ,IAAI,GAAGI,EAAM,CAAC,CAAC,GAAIA,CAAK,EAGhC,QAAWC,KAAQH,EAAY,kBAAmBD,CAAE,EAAG,CACrD,IAAMK,EAAOD,EAAK,aAAa,MAAM,EACjCC,GAAQ,MACVF,EAAM,KAAKT,GAAQ,IAAI,IAAIW,CAAI,EAAGT,CAAI,CAAC,CAC3C,CACF,CAGA,OAAOG,CACT,CAgBO,SAASO,GAAaV,EAAyC,CACpE,OAAOW,GAAW,IAAI,IAAI,cAAeX,CAAI,CAAC,EAC3C,KACCY,EAAIV,GAAYD,GAAQC,EAAU,IAAI,IAAIF,CAAI,CAAC,CAAC,EAChDa,GAAW,IAAMC,EAAG,IAAI,GAAK,CAAC,CAChC,CACJ,CClDA,SAASC,GACPC,EAAgBC,EACC,CACjB,GAAI,EAAED,EAAG,kBAAkB,SACzB,OAAOE,EAIT,IAAMC,EAAKH,EAAG,OAAO,QAAQ,GAAG,EAChC,GAAIG,IAAO,KACT,OAAOD,EAMT,GAAIC,EAAG,QAAUH,EAAG,SAAWA,EAAG,QAChC,OAAOE,EAQT,IAAME,EAAM,IAAI,IAAID,EAAG,IAAI,EAO3B,OANAC,EAAI,OAASA,EAAI,KAAO,GAMnBH,EAAQ,IAAI,GAAGG,CAAG,EAAE,GASzBJ,EAAG,eAAe,EACXK,EAAG,IAAI,IAAIF,EAAG,IAAI,CAAC,GATjBD,CAUX,CASA,SAASI,GAAKC,EAA8C,CAC1D,IAAMC,EAAO,IAAI,IACjB,QAAWL,KAAMM,EAAY,aAAcF,EAAS,IAAI,EACtDC,EAAK,IAAIL,EAAG,UAAWA,CAAE,EAG3B,OAAOK,CACT,CAYA,SAASE,GAAQH,EAA0C,CACzD,QAAWJ,KAAMM,EAAY,gBAAiBF,CAAQ,EACpD,QAAWI,IAAO,CAAC,OAAQ,KAAK,EAAG,CACjC,IAAMC,EAAQT,EAAG,aAAaQ,CAAG,EACjC,GAAIC,GAAS,CAAC,qBAAqB,KAAKA,CAAK,EAAG,CAE9CT,EAAGQ,CAAG,EAAIR,EAAGQ,CAAG,EAChB,KACF,CACF,CAGF,OAAON,EAAGE,CAAQ,CACpB,CASA,SAASM,GAAOC,EAAsC,CACpD,QAAWC,IAAY,CACrB,+BACA,gCACA,mCACA,+BACA,2BACA,2BACA,GAAGC,EAAQ,wBAAwB,EAC/B,CAAC,0BAA0B,EAC3B,CAAC,CACP,EAAG,CACD,IAAMC,EAASC,GAAmBH,CAAQ,EACpCI,EAASD,GAAmBH,EAAUD,CAAI,EAE9C,OAAOG,GAAW,aAClB,OAAOE,GAAW,aAElBF,EAAO,YAAYE,CAAM,CAE7B,CAGA,IAAMX,EAAOF,GAAK,QAAQ,EAC1B,OAAW,CAACc,EAAMjB,CAAE,IAAKG,GAAKQ,CAAI,EAC5BN,EAAK,IAAIY,CAAI,EACfZ,EAAK,OAAOY,CAAI,EAEhB,SAAS,KAAK,YAAYjB,CAAE,EAGhC,QAAWA,KAAMK,EAAK,OAAO,EAAG,CAC9B,IAAMa,EAAOlB,EAAG,aAAa,MAAM,EAI/BkB,IAAS,eAAiBA,IAAS,gBACrClB,EAAG,OAAO,CACd,CAIA,IAAMmB,EAAYC,GAAoB,WAAW,EACjD,OAAOC,GAAOf,EAAY,SAAUa,CAAS,CAAC,EAC3C,KACCG,EAAUtB,GAAM,CACd,IAAMuB,EAASZ,EAAK,cAAc,QAAQ,EAC1C,GAAIX,EAAG,IAAK,CACV,QAAWkB,KAAQlB,EAAG,kBAAkB,EACtCuB,EAAO,aAAaL,EAAMlB,EAAG,aAAakB,CAAI,CAAE,EAClD,OAAAlB,EAAG,YAAYuB,CAAM,EAGd,IAAIC,EAAWC,GAAY,CAChCF,EAAO,OAAS,IAAME,EAAS,SAAS,CAC1C,CAAC,CAGH,KACE,QAAAF,EAAO,YAAcvB,EAAG,YACxBA,EAAG,YAAYuB,CAAM,EACdxB,CAEX,CAAC,EACD2B,EAAe,EACfC,GAAQ,QAAQ,CAClB,CACJ,CAgBO,SAASC,GACd,CAAE,UAAAC,EAAW,UAAAC,EAAW,UAAAC,CAAU,EACZ,CACtB,IAAMC,EAASC,GAAc,EAC7B,GAAI,SAAS,WAAa,QACxB,OAAOlC,EAIT,IAAMmC,EAAWC,GAAaH,EAAO,IAAI,EAUzC9B,EAAG,QAAQ,EACR,UAAUK,EAAO,EAUpB,IAAM6B,EACJC,EAAsB,SAAS,KAAM,OAAO,EACzC,KACCC,GAAkBJ,CAAQ,EAC1BZ,EAAU,CAAC,CAACzB,EAAIC,CAAO,IAAMF,GAAOC,EAAIC,CAAO,CAAC,EAChDyC,GAAM,CACR,EAIEC,EACJH,EAAyB,OAAQ,UAAU,EACxC,KACCI,EAAIC,EAAW,EACfH,GAAM,CACR,EAMJH,EAAS,KAAKO,GAAeb,CAAS,CAAC,EACpC,UAAU,CAAC,CAAC7B,EAAK,CAAE,OAAA2C,CAAO,CAAC,IAAM,CAChC,QAAQ,aAAaA,EAAQ,EAAE,EAC/B,QAAQ,UAAU,KAAM,GAAI3C,CAAG,CACjC,CAAC,EAMH4C,EAAMT,EAAUI,CAAQ,EACrB,UAAUX,CAAS,EActB,IAAMiB,EACJjB,EAAU,KACRkB,GAAwB,UAAU,EAClCzB,EAAUrB,GAAO+C,GAAY/C,EAAK,CAAE,UAAA8B,CAAU,CAAC,EAC5C,KACCkB,GAAW,KACTC,GAAYjD,EAAK,EAAI,EACdF,EACR,CACH,CACF,EAIAuB,EAAUf,EAAO,EACjBe,EAAUZ,EAAM,EAChB6B,GAAM,CACR,EAUF,OAAAM,EACEC,EAAU,KAAKH,GAAed,EAAW,CAACsB,EAAGlD,IAAQA,CAAG,CAAC,EASzD6C,EAAU,KACRxB,EAAU,IAAMO,CAAS,EACzBkB,GAAwB,UAAU,EAClCzB,EAAU,IAAMO,CAAS,EACzBkB,GAAwB,MAAM,CAChC,EAQAlB,EAAU,KACRuB,EAAqB,CAACC,EAAGC,IACvBD,EAAE,WAAaC,EAAE,UACjBD,EAAE,OAAaC,EAAE,IAClB,EACDhC,EAAU,IAAMc,CAAQ,EACxBmB,EAAI,IAAM,QAAQ,KAAK,CAAC,CAC1B,CACF,EACG,UAAUtD,GAAO,CA1YtB,IAAAuD,EAAAC,EAgZU,QAAQ,QAAU,MAAQ,CAACxD,EAAI,KACjC,OAAO,SAAS,GAAGwD,GAAAD,EAAA,QAAQ,QAAR,YAAAA,EAAe,IAAf,KAAAC,EAAoB,CAAC,GAExC,QAAQ,kBAAoB,OAC5BC,GAAgBzD,EAAI,IAAI,EACxB,QAAQ,kBAAoB,SAEhC,CAAC,EAMH4B,EAAU,UAAU,IAAM,CACxB,QAAQ,kBAAoB,QAC9B,CAAC,EAMDQ,EAAU,OAAQ,cAAc,EAC7B,UAAU,IAAM,CACf,QAAQ,kBAAoB,MAC9B,CAAC,EAMHP,EAAU,KACRiB,GAAwB,QAAQ,EAChCY,GAAa,GAAG,CAClB,EACG,UAAU,CAAC,CAAE,OAAAf,CAAO,IAAM,CACzB,QAAQ,aAAaA,EAAQ,EAAE,CACjC,CAAC,EAGIE,CACT,CClaA,IAAAc,GAAuB,SAqChB,SAASC,GACdC,EAC0B,CAE1B,IAAMC,EAAQD,EAAO,UAAU,MAAM,GAAG,EAAE,IAAIE,GAC/BA,EAAK,QAAQ,sBAAuB,EAAE,EACvC,SAAW,EAAI,SAAMA,CAClC,EACE,KAAK,GAAG,EAELC,EAAY,IAAI,OAAOF,EAAO,KAAK,EACnCG,EAAY,CAACC,EAAYC,EAAcJ,IACpC,GAAGI,CAAI,2BAA2BJ,CAAI,UAI/C,OAAQK,GAAkB,CACxBA,EAAQA,EACL,QAAQ,gBAAiB,GAAG,EAC5B,KAAK,EAGR,IAAMC,EAAQ,IAAI,OAAO,MAAMR,EAAO,SAAS,MAC7CO,EACG,QAAQ,uBAAwB,MAAM,EACtC,QAAQJ,EAAW,GAAG,CAC3B,IAAK,KAAK,EAGV,OAAOM,MAAS,GAAAC,SAAWD,CAAK,EAC7B,QAAQD,EAAOJ,CAAS,EACxB,QAAQ,8BAA+B,IAAI,CAChD,CACF,CCEO,SAASO,GACdC,EAC+B,CAC/B,OAAOA,EAAQ,OAAS,CAC1B,CASO,SAASC,GACdD,EACgC,CAChC,OAAOA,EAAQ,OAAS,CAC1B,CC1CO,SAASE,GACdC,EAAaC,EACW,CACxB,IAAMC,EAAUC,GAA2BH,CAAG,EAC9C,OAAAI,EACEC,EAAG,SAAS,WAAa,OAAO,EAChCC,GAAY,QAAQ,CACtB,EACG,KACCC,GAAMC,GAAUA,CAAM,EACtBC,EAAU,IAAMR,CAAM,CACxB,EACG,UAAU,CAAC,CAAE,OAAAS,EAAQ,KAAAC,CAAK,IAAMT,EAAQ,KAAK,CAC5C,OACA,KAAM,CACJ,OAAAQ,EACA,KAAAC,EACA,QAAS,CACP,QAASC,EAAQ,gBAAgB,CACnC,CACF,CACF,CAAC,CAAC,EAGCV,CACT,CCjEO,SAASW,GACdC,EACiB,CA/BnB,IAAAC,EAgCE,GAAM,CAAC,uBAAAC,EACL,uBAAAC,EACA,gBAAAC,EACA,eAAAC,CAAc,EAAIL,EACdM,GAAeL,EAAAM,GAAaF,CAAc,IAA3B,YAAAJ,EAA8B,SACnD,GAAIK,IAAiB,OACnB,OAEF,IAAME,EAAsBC,GAAYL,EAAgB,SAAUE,CAAY,EAC9E,GAAIE,IAAwB,OAC1B,OAEF,IAAME,EAAsBC,GAAqBT,EAAuB,KAAK,CAAC,EAC9E,GAAI,CAACA,EAAuB,IAAIQ,CAAmB,EAIjD,OAGF,IAAME,EAAsBL,GAAaC,EAAqBE,CAAmB,EACjF,GAAI,CAACE,GAAuB,CAACV,EAAuB,IAAIU,EAAoB,IAAI,EAC9E,OAGF,IAAMC,EAASN,GAAaC,EAAqBL,CAAsB,EACvE,GAAKU,EAGL,OAAAA,EAAO,KAAOT,EAAgB,KAC9BS,EAAO,OAAST,EAAgB,OACzBS,CACT,CAWA,SAASN,GAAaO,EAAiBC,EAAoC,CACzE,GAAI,CACF,OAAO,IAAI,IAAID,EAAKC,CAAI,CAC1B,OAAQC,EAAA,CACN,MACF,CACF,CAYO,SAASP,GAAYQ,EAAWC,EAAoC,CACzE,GAAID,EAAE,WAAWC,CAAM,EACrB,OAAOD,EAAE,MAAMC,EAAO,MAAM,CAGhC,CASA,SAASC,GAAgBC,EAAYC,EAAoB,CACvD,IAAMC,EAAM,KAAK,IAAIF,EAAG,OAAQC,EAAG,MAAM,EACrCR,EACJ,IAAKA,EAAS,EAAGA,EAASS,GACpBF,EAAGP,CAAM,IAAMQ,EAAGR,CAAM,EADC,EAAEA,EAC/B,CAIF,OAAOA,CACT,CAQO,SAASF,GAAqBY,EAAgC,CACnE,IAAIV,EACJ,QAAWI,KAAKM,EACVV,IAAW,OACbA,EAASI,EAETJ,EAASA,EAAO,MAAM,EAAGM,GAAgBN,EAAQI,CAAC,CAAC,EAGvD,OAAOJ,GAAA,KAAAA,EAAU,EACnB,CC9DO,SAASW,GACd,CAAE,UAAAC,CAAU,EACN,CACN,IAAMC,EAASC,GAAc,EACvBC,EAAYC,GAChB,IAAI,IAAI,mBAAoBH,EAAO,IAAI,CACzC,EACG,KACCI,GAAW,IAAMC,CAAK,CACxB,EAGIC,EAAWJ,EACd,KACCK,EAAIC,GAAY,CACd,GAAM,CAAC,CAAEC,CAAO,EAAIT,EAAO,KAAK,MAAM,aAAa,EACnD,OAAOQ,EAAS,KAAK,CAAC,CAAE,QAAAE,EAAS,QAAAC,CAAQ,IACvCD,IAAYD,GAAWE,EAAQ,SAASF,CAAO,CAChD,GAAKD,EAAS,CAAC,CAClB,CAAC,CACH,EAGFN,EACG,KACCK,EAAIC,GAAY,IAAI,IAAIA,EAAS,IAAIE,GAAW,CAC9C,GAAG,IAAI,IAAI,MAAMA,EAAQ,OAAO,IAAKV,EAAO,IAAI,CAAC,GACjDU,CACF,CAAC,CAAC,CAAC,EACHE,EAAUC,GAAQC,EAAsB,SAAS,KAAM,OAAO,EAC3D,KACCC,EAAOC,GAAM,CAACA,EAAG,SAAW,CAACA,EAAG,OAAO,EACvCC,GAAeX,CAAQ,EACvBM,EAAU,CAAC,CAACI,EAAIP,CAAO,IAAM,CAC3B,GAAIO,EAAG,kBAAkB,QAAS,CAChC,IAAME,EAAKF,EAAG,OAAO,QAAQ,GAAG,EAChC,GAAIE,GAAM,CAACA,EAAG,QAAUL,EAAK,IAAIK,EAAG,IAAI,EAAG,CACzC,IAAMC,EAAMD,EAAG,KAWf,MAAI,CAACF,EAAG,OAAO,QAAQ,aAAa,GAClBH,EAAK,IAAIM,CAAG,IACZV,EACPJ,GAEXW,EAAG,eAAe,EACXI,EAAG,IAAI,IAAID,CAAG,CAAC,EACxB,CACF,CACA,OAAOd,CACT,CAAC,EACDO,EAAUS,GACDC,GAAaD,CAAsB,EAAE,KAC1Cd,EACEgB,GAAQ,CAtIxB,IAAAC,EAuIkB,OAAAA,EAAAC,GAAgC,CAC9B,uBAAwBF,EACxB,uBAAAF,EACA,gBAAiBK,GAAY,EAC7B,eAAgB1B,EAAO,IACzB,CAAC,IALD,KAAAwB,EAKMH,EACV,CACF,CACD,CACH,CACF,CACF,EACG,UAAUF,GAAOQ,GAAYR,EAAK,EAAI,CAAC,EAG5CS,EAAc,CAAC1B,EAAWI,CAAQ,CAAC,EAChC,UAAU,CAAC,CAACE,EAAUC,CAAO,IAAM,CACpBoB,EAAW,mBAAmB,EACtC,YAAYC,GAAsBtB,EAAUC,CAAO,CAAC,CAC5D,CAAC,EAGHV,EAAU,KAAKa,EAAU,IAAMN,CAAQ,CAAC,EACrC,UAAUG,GAAW,CA9J1B,IAAAe,EAiKM,IAAIO,EAAW,SAAS,aAAc,cAAc,EACpD,GAAIA,IAAa,KAAM,CACrBA,EAAW,GAGX,IAAIC,IAAUR,EAAAxB,EAAO,UAAP,YAAAwB,EAAgB,UAAW,SACpC,MAAM,QAAQQ,CAAO,IACxBA,EAAU,CAACA,CAAO,GAGpBC,EAAM,QAAWC,KAAUF,EACzB,QAAWtB,KAAWD,EAAQ,QAAQ,OAAOA,EAAQ,OAAO,EAC1D,GAAI,IAAI,OAAOyB,EAAQ,GAAG,EAAE,KAAKxB,CAAO,EAAG,CACzCqB,EAAW,GACX,MAAME,CACR,CAGJ,SAAS,aAAcF,EAAU,cAAc,CACjD,CAGA,GAAIA,EACF,QAAWI,KAAWC,GAAqB,UAAU,EACnDD,EAAQ,OAAS,EACvB,CAAC,CACL,CCvFO,SAASE,GACdC,EAAsB,CAAE,QAAAC,CAAQ,EACP,CAGzB,GAAM,CAAE,aAAAC,CAAa,EAAIC,GAAY,EACjCD,EAAa,IAAI,GAAG,IACtBE,GAAU,SAAU,EAAI,EAGxBJ,EAAG,MAAQE,EAAa,IAAI,GAAG,EAC/BF,EAAG,MAAM,EAGTK,GAAY,QAAQ,EACjB,KACCC,GAAMC,GAAU,CAACA,CAAM,CACzB,EACG,UAAU,IAAM,CACf,IAAMC,EAAML,GAAY,EACxBK,EAAI,aAAa,OAAO,GAAG,EAC3B,QAAQ,aAAa,CAAC,EAAG,GAAI,GAAGA,CAAG,EAAE,CACvC,CAAC,GAIP,IAAMC,EAASC,GAAkBV,CAAE,EAC7BW,EAASC,EACbX,EAAQ,KAAKK,GAAMO,EAAoB,CAAC,EACxCC,EAAUd,EAAI,OAAO,EACrBS,CACF,EACG,KACCM,EAAI,IAAMf,EAAG,KAAK,EAClBgB,EAAqB,CACvB,EAGF,OAAOC,EAAc,CAACN,EAAQF,CAAM,CAAC,EAClC,KACCM,EAAI,CAAC,CAACG,EAAOC,CAAK,KAAO,CAAE,MAAAD,EAAO,MAAAC,CAAM,EAAE,EAC1CC,EAAY,CAAC,CACf,CACJ,CAUO,SAASC,GACdrB,EAAsB,CAAE,QAAAC,CAAQ,EACsB,CACtD,IAAMqB,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,EAAe,EAAGC,GAAQ,EAAI,CAAC,EAGxDT,EAAc,CACZhB,EAAQ,KAAKK,GAAMO,EAAoB,CAAC,EACxCS,CACF,EAAG,CAACK,EAAGC,IAAUA,CAAK,EACnB,KACCC,GAAwB,OAAO,CACjC,EACG,UAAU,CAAC,CAAE,MAAAX,CAAM,IAAMjB,EAAQ,KAAK,CACrC,OACA,KAAMiB,CACR,CAAC,CAAC,EAGNI,EACG,KACCO,GAAwB,OAAO,CACjC,EACG,UAAU,CAAC,CAAE,MAAAV,CAAM,IAAM,CACpBA,GACFf,GAAU,SAAUe,CAAK,CAC7B,CAAC,EAGLL,EAAUd,EAAG,KAAO,OAAO,EACxB,KACC8B,EAAUN,CAAK,CACjB,EACG,UAAU,IAAMxB,EAAG,MAAM,CAAC,EAM/B,IAAM+B,EAAQC,EAAW,uBAAuB,EAChD,OAAAlB,EAAUiB,EAAO,OAAO,EACrB,UAAU,IAAM/B,EAAG,MAAM,CAAC,EAGtBD,GAAiBC,EAAI,CAAE,QAAAC,CAAQ,CAAC,EACpC,KACCgC,EAAIC,GAASZ,EAAM,KAAKY,CAAK,CAAC,EAC9BC,EAAS,IAAMb,EAAM,SAAS,CAAC,EAC/BP,EAAImB,GAAUE,EAAA,CAAE,IAAKpC,GAAOkC,EAAQ,EACpCd,EAAY,CAAC,CACf,CACJ,CCnHO,SAASiB,GACdC,EAAiB,CAAE,QAAAC,EAAS,OAAAC,CAAO,EACE,CACrC,IAAMC,EAAQ,IAAIC,EACZC,EAAYC,GAAqBN,EAAG,aAAc,EACrD,KACCO,EAAO,OAAO,CAChB,EAGIC,EAAYR,EAAG,cAGfS,EAAOC,EAAW,wBAAyBV,CAAE,EAC7CW,EAAOD,EAAW,uBAAwBV,CAAE,EAGlDY,GAAY,QAAQ,EACjB,UAAUC,GAAUF,EAAK,aACxB,OAAQE,EAAS,OAAS,cAC5B,CAAC,EAGHV,EACG,KACCW,GAAeZ,CAAM,EACrBa,GAAUd,EAAQ,KAAKe,GAAMC,EAAoB,CAAC,CAAC,CACrD,EACG,UAAU,CAAC,CAAC,CAAE,MAAAC,CAAM,EAAG,CAAE,MAAAC,CAAM,CAAC,IAAM,CACrC,OAAQD,EAAM,OAAQ,CAGpB,IAAK,GACHT,EAAK,YAAcU,EAAM,OACrBC,GAAY,oBAAoB,EAChCA,GAAY,2BAA2B,EAC3C,MAGF,IAAK,GACHX,EAAK,YAAcW,GAAY,mBAAmB,EAClD,MAGF,QACE,IAAMC,EAAQC,GAAMJ,EAAM,MAAM,EAChCT,EAAK,YAAcW,GAAY,sBAAuBC,CAAK,CAC/D,CACF,CAAC,EAGL,IAAME,EAAUpB,EACb,KACCqB,EAAI,IAAMb,EAAK,UAAY,EAAE,EAC7Bc,EAAU,CAAC,CAAE,MAAAP,CAAM,IAAMQ,EACvBC,EAAG,GAAGT,EAAM,MAAM,EAAG,EAAE,CAAC,EACxBS,EAAG,GAAGT,EAAM,MAAM,EAAE,CAAC,EAClB,KACCU,GAAY,CAAC,EACbC,GAAQxB,CAAS,EACjBoB,EAAU,CAAC,CAACK,CAAK,IAAMA,CAAK,CAC9B,CACJ,CAAC,EACDC,EAAIC,EAAsB,EAC1BC,GAAM,CACR,EAGF,OAAAV,EAAQ,UAAUW,GAAQvB,EAAK,YAAYuB,CAAI,CAAC,EAChDX,EACG,KACCY,GAASD,GAAQ,CACf,IAAME,EAAUC,GAAmB,UAAWH,CAAI,EAClD,OAAI,OAAOE,GAAY,YACdE,EAGFC,EAAUH,EAAS,QAAQ,EAC/B,KACCI,EAAUrC,CAAK,EACf4B,EAAI,IAAMK,CAAO,CACnB,CACJ,CAAC,CACH,EACG,UAAUA,GAAW,CAElBA,EAAQ,OAAS,IACjBA,EAAQ,WAAa5B,EAAU,WAE/BA,EAAU,SAAS,CAAE,IAAK4B,EAAQ,SAAU,CAAC,CACjD,CAAC,EAGWnC,EACb,KACCM,EAAOkC,EAAqB,EAC5BV,EAAI,CAAC,CAAE,KAAAW,CAAK,IAAMA,CAAI,CACxB,EAIC,KACClB,EAAImB,GAASxC,EAAM,KAAKwC,CAAK,CAAC,EAC9BC,EAAS,IAAMzC,EAAM,SAAS,CAAC,EAC/B4B,EAAIY,GAAUE,EAAA,CAAE,IAAK7C,GAAO2C,EAAQ,CACtC,CACJ,CCpHO,SAASG,GACdC,EAAkB,CAAE,OAAAC,CAAO,EACF,CACzB,OAAOA,EACJ,KACCC,EAAI,CAAC,CAAE,MAAAC,CAAM,IAAM,CACjB,IAAMC,EAAMC,GAAY,EACxB,OAAAD,EAAI,KAAO,GAGXD,EAAQA,EACL,QAAQ,OAAQ,GAAG,EACnB,QAAQ,KAAM,KAAK,EACnB,QAAQ,KAAM,KAAK,EAGtBC,EAAI,OAAS,KAAKD,CAAK,GAChB,CAAE,IAAAC,CAAI,CACf,CAAC,CACH,CACJ,CAUO,SAASE,GACdC,EAAuBC,EACa,CACpC,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,EAAe,EAAGC,GAAQ,EAAI,CAAC,EACxD,OAAAJ,EAAM,UAAU,CAAC,CAAE,IAAAL,CAAI,IAAM,CAC3BG,EAAG,aAAa,sBAAuBA,EAAG,IAAI,EAC9CA,EAAG,KAAO,GAAGH,CAAG,EAClB,CAAC,EAGDU,EAAUP,EAAI,OAAO,EAClB,KACCQ,EAAUJ,CAAK,CACjB,EACG,UAAUK,GAAMA,EAAG,eAAe,CAAC,EAGjCjB,GAAiBQ,EAAIC,CAAO,EAChC,KACCS,EAAIC,GAAST,EAAM,KAAKS,CAAK,CAAC,EAC9BC,EAAS,IAAMV,EAAM,SAAS,CAAC,EAC/BP,EAAIgB,GAAUE,EAAA,CAAE,IAAKb,GAAOW,EAAQ,CACtC,CACJ,CCpDO,SAASG,GACdC,EAAiB,CAAE,QAAAC,EAAS,UAAAC,CAAU,EACA,CACtC,IAAMC,EAAQ,IAAIC,EAGZC,EAASC,GAAoB,cAAc,EAC3CC,EAASC,EACbC,EAAUJ,EAAO,SAAS,EAC1BI,EAAUJ,EAAO,OAAO,CAC1B,EACG,KACCK,GAAUC,EAAc,EACxBC,EAAI,IAAMP,EAAM,KAAK,EACrBQ,EAAqB,CACvB,EAGF,OAAAV,EACG,KACCW,GAAkBP,CAAM,EACxBK,EAAI,CAAC,CAAC,CAAE,QAAAG,CAAQ,EAAGC,CAAK,IAAM,CAC5B,IAAMC,EAAQD,EAAM,MAAM,UAAU,EACpC,GAAID,GAAA,MAAAA,EAAS,QAAUE,EAAMA,EAAM,OAAS,CAAC,EAAG,CAC9C,IAAMC,EAAOH,EAAQA,EAAQ,OAAS,CAAC,EACnCG,EAAK,WAAWD,EAAMA,EAAM,OAAS,CAAC,CAAC,IACzCA,EAAMA,EAAM,OAAS,CAAC,EAAIC,EAC9B,MACED,EAAM,OAAS,EAEjB,OAAOA,CACT,CAAC,CACH,EACG,UAAUA,GAASjB,EAAG,UAAYiB,EAChC,KAAK,EAAE,EACP,QAAQ,MAAO,QAAQ,CAC1B,EAGJf,EACG,KACCiB,EAAO,CAAC,CAAE,KAAAC,CAAK,IAAMA,IAAS,QAAQ,CACxC,EACG,UAAUC,GAAO,CAChB,OAAQA,EAAI,KAAM,CAGhB,IAAK,aAEDrB,EAAG,UAAU,QACbK,EAAM,iBAAmBA,EAAM,MAAM,SAErCA,EAAM,MAAQL,EAAG,WACnB,KACJ,CACF,CAAC,EAGWC,EACb,KACCkB,EAAOG,EAAqB,EAC5BV,EAAI,CAAC,CAAE,KAAAW,CAAK,IAAMA,CAAI,CACxB,EAIC,KACCC,EAAIC,GAAStB,EAAM,KAAKsB,CAAK,CAAC,EAC9BC,EAAS,IAAMvB,EAAM,SAAS,CAAC,EAC/BS,EAAI,KAAO,CAAE,IAAKZ,CAAG,EAAE,CACzB,CACJ,CCjDO,SAAS2B,GACdC,EAAiB,CAAE,OAAAC,EAAQ,UAAAC,CAAU,EACN,CAC/B,IAAMC,EAASC,GAAc,EAC7B,GAAI,CACF,IAAMC,EAAUC,GAAkBH,EAAO,OAAQF,CAAM,EAGjDM,EAASC,GAAoB,eAAgBR,CAAE,EAC/CS,EAASD,GAAoB,gBAAiBR,CAAE,EAGtDU,EAAwBV,EAAI,OAAO,EAChC,KACCW,EAAO,CAAC,CAAE,OAAAC,CAAO,IACfA,aAAkB,SAAW,CAAC,CAACA,EAAO,QAAQ,GAAG,CAClD,CACH,EACG,UAAU,IAAMC,GAAU,SAAU,EAAK,CAAC,EAG/CX,EACG,KACCS,EAAO,CAAC,CAAE,KAAAG,CAAK,IAAMA,IAAS,QAAQ,CACxC,EACG,UAAUC,GAAO,CAChB,IAAMC,EAASC,GAAiB,EAChC,OAAQF,EAAI,KAAM,CAGhB,IAAK,QACH,GAAIC,IAAWT,EAAO,CACpB,IAAMW,EAAU,IAAI,IACpB,QAAWC,KAAUC,EACnB,sBAAuBX,CACzB,EAAG,CACD,IAAMY,EAAUF,EAAO,kBACvBD,EAAQ,IAAIC,EAAQ,WAClBE,EAAQ,aAAa,eAAe,CACtC,CAAC,CACH,CAGA,GAAIH,EAAQ,KAAM,CAChB,GAAM,CAAC,CAACI,CAAI,CAAC,EAAI,CAAC,GAAGJ,CAAO,EAAE,KAAK,CAAC,CAAC,CAAEK,CAAC,EAAG,CAAC,CAAEC,CAAC,IAAMA,EAAID,CAAC,EAC1DD,EAAK,MAAM,CACb,CAGAP,EAAI,MAAM,CACZ,CACA,MAGF,IAAK,SACL,IAAK,MACHF,GAAU,SAAU,EAAK,EACzBN,EAAM,KAAK,EACX,MAGF,IAAK,UACL,IAAK,YACH,GAAI,OAAOS,GAAW,YACpBT,EAAM,MAAM,MACP,CACL,IAAMkB,EAAM,CAAClB,EAAO,GAAGa,EACrB,wDACAX,CACF,CAAC,EACKiB,EAAI,KAAK,IAAI,GACjB,KAAK,IAAI,EAAGD,EAAI,QAAQT,CAAM,CAAC,EAAIS,EAAI,QACrCV,EAAI,OAAS,UAAY,GAAK,IAE9BU,EAAI,MAAM,EACdA,EAAIC,CAAC,EAAE,MAAM,CACf,CAGAX,EAAI,MAAM,EACV,MAGF,QACMR,IAAUU,GAAiB,GAC7BV,EAAM,MAAM,CAClB,CACF,CAAC,EAGLL,EACG,KACCS,EAAO,CAAC,CAAE,KAAAG,CAAK,IAAMA,IAAS,QAAQ,CACxC,EACG,UAAUC,GAAO,CAChB,OAAQA,EAAI,KAAM,CAGhB,IAAK,IACL,IAAK,IACL,IAAK,IACHR,EAAM,MAAM,EACZA,EAAM,OAAO,EAGbQ,EAAI,MAAM,EACV,KACJ,CACF,CAAC,EAGL,IAAMY,EAASC,GAAiBrB,EAAO,CAAE,QAAAF,CAAQ,CAAC,EAClD,OAAOwB,EACLF,EACAG,GAAkBrB,EAAQ,CAAE,QAAAJ,EAAS,OAAAsB,CAAO,CAAC,CAC/C,EACG,KACCI,GAGE,GAAGC,GAAqB,eAAgBhC,CAAE,EACvC,IAAIiC,GAASC,GAAiBD,EAAO,CAAE,OAAAN,CAAO,CAAC,CAAC,EAGnD,GAAGK,GAAqB,iBAAkBhC,CAAE,EACzC,IAAIiC,GAASE,GAAmBF,EAAO,CAAE,QAAA5B,EAAS,UAAAH,CAAU,CAAC,CAAC,CACnE,CACF,CAGJ,OAASkC,EAAK,CACZ,OAAApC,EAAG,OAAS,GACLqC,EACT,CACF,CCnKO,SAASC,GACdC,EAAiB,CAAE,OAAAC,EAAQ,UAAAC,CAAU,EACG,CACxC,OAAOC,EAAc,CACnBF,EACAC,EACG,KACCE,EAAUC,GAAY,CAAC,EACvBC,EAAOC,GAAO,CAAC,CAACA,EAAI,aAAa,IAAI,GAAG,CAAC,CAC3C,CACJ,CAAC,EACE,KACCC,EAAI,CAAC,CAACC,EAAOF,CAAG,IAAMG,GAAuBD,EAAM,MAAM,EACvDF,EAAI,aAAa,IAAI,GAAG,CAC1B,CAAC,EACDC,EAAIG,GAAM,CA1FhB,IAAAC,EA2FQ,IAAMC,EAAQ,IAAI,IAGZC,EAAK,SAAS,mBAAmBd,EAAI,WAAW,SAAS,EAC/D,QAASe,EAAOD,EAAG,SAAS,EAAGC,EAAMA,EAAOD,EAAG,SAAS,EACtD,IAAIF,EAAAG,EAAK,gBAAL,MAAAH,EAAoB,aAAc,CACpC,IAAMI,EAAWD,EAAK,YAChBE,EAAWN,EAAGK,CAAQ,EACxBC,EAAS,OAASD,EAAS,QAC7BH,EAAM,IAAIE,EAAmBE,CAAQ,CACzC,CAIF,OAAW,CAACF,EAAMG,CAAI,IAAKL,EAAO,CAChC,GAAM,CAAE,WAAAM,CAAW,EAAIC,EAAE,OAAQ,KAAMF,CAAI,EAC3CH,EAAK,YAAY,GAAG,MAAM,KAAKI,CAAU,CAAC,CAC5C,CAGA,MAAO,CAAE,IAAKnB,EAAI,MAAAa,CAAM,CAC1B,CAAC,CACH,CACJ,CCPO,SAASQ,GACdC,EAAiB,CAAE,UAAAC,EAAW,MAAAC,CAAM,EACf,CACrB,IAAMC,EAASH,EAAG,QAAqB,UAAU,EAC3CI,EACJD,EAAO,UACPA,EAAO,cAAe,UAGxB,OAAOE,EAAc,CAACH,EAAOD,CAAS,CAAC,EACpC,KACCK,EAAI,CAAC,CAAC,CAAE,OAAAC,EAAQ,OAAAC,CAAO,EAAG,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,CAAC,KACzCD,EAASA,EACL,KAAK,IAAIJ,EAAQ,KAAK,IAAI,EAAGK,EAAIF,CAAM,CAAC,EACxCH,EACG,CACL,OAAAI,EACA,OAAQC,GAAKF,EAASH,CACxB,EACD,EACDM,EAAqB,CAACC,EAAGC,IACvBD,EAAE,SAAWC,EAAE,QACfD,EAAE,SAAWC,EAAE,MAChB,CACH,CACJ,CAuBO,SAASC,GACdb,EAAiBc,EACe,CADf,IAAAC,EAAAD,EAAE,SAAAE,CA5JrB,EA4JmBD,EAAcE,EAAAC,GAAdH,EAAc,CAAZ,YAEnB,IAAMI,EAAQC,EAAW,0BAA2BpB,CAAE,EAChD,CAAE,EAAAS,CAAE,EAAIY,GAAiBF,CAAK,EACpC,OAAOG,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,EAAe,EAAGC,GAAQ,EAAI,CAAC,EAClDC,EAAQL,EACX,KACCM,GAAU,EAAGC,EAAuB,CACtC,EAGF,OAAAF,EAAM,KAAKG,GAAef,CAAO,CAAC,EAC/B,UAAU,CAGT,KAAK,CAAC,CAAE,OAAAR,CAAO,EAAG,CAAE,OAAQD,CAAO,CAAC,EAAG,CACrCY,EAAM,MAAM,OAAS,GAAGX,EAAS,EAAIC,CAAC,KACtCT,EAAG,MAAM,IAAY,GAAGO,CAAM,IAChC,EAGA,UAAW,CACTY,EAAM,MAAM,OAAS,GACrBnB,EAAG,MAAM,IAAY,EACvB,CACF,CAAC,EAGH4B,EAAM,KAAKI,GAAM,CAAC,EACf,UAAU,IAAM,CACf,QAAWC,KAAQC,EAAY,8BAA+BlC,CAAE,EAAG,CACjE,GAAI,CAACiC,EAAK,aACR,SACF,IAAME,EAAYF,EAAK,QAAqB,yBAAyB,EACrE,GAAI,OAAOE,GAAc,YAAa,CACpC,IAAM5B,EAAS0B,EAAK,UAAYE,EAAU,UACpC,CAAE,OAAA3B,CAAO,EAAI4B,GAAeD,CAAS,EAC3CA,EAAU,SAAS,CACjB,IAAK5B,EAASC,EAAS,CACzB,CAAC,CACH,CACF,CACF,CAAC,EAGH6B,GAAKH,EAA8B,kBAAmBlC,CAAE,CAAC,EACtD,KACCsC,GAASC,GAASC,EAAUD,EAAO,OAAO,EACvC,KACCE,GAAUC,EAAc,EACxBpC,EAAI,IAAMiC,CAAK,EACfI,EAAUlB,CAAK,CACjB,CACF,CACF,EACG,UAAUc,GAAS,CAClB,IAAMK,EAAQxB,EAA6B,QAAQmB,EAAM,OAAO,IAAI,EACxDnB,EAAW,qBAAqBmB,EAAM,EAAE,IAAI,EACpD,aAAa,gBAAiB,GAAGK,EAAM,OAAO,EAAE,CACtD,CAAC,EAGE7C,GAAaC,EAAIiB,CAAO,EAC5B,KACC4B,EAAIC,GAASvB,EAAM,KAAKuB,CAAK,CAAC,EAC9BC,EAAS,IAAMxB,EAAM,SAAS,CAAC,EAC/BjB,EAAIwC,GAAUE,EAAA,CAAE,IAAKhD,GAAO8C,EAAQ,CACtC,CACJ,CAAC,CACH,CCxKO,SAASG,GACdC,EAAcC,EACW,CACzB,GAAI,OAAOA,GAAS,YAAa,CAC/B,IAAMC,EAAM,gCAAgCF,CAAI,IAAIC,CAAI,GACxD,OAAOE,GAGLC,GAAqB,GAAGF,CAAG,kBAAkB,EAC1C,KACCG,GAAW,IAAMC,CAAK,EACtBC,EAAIC,IAAY,CACd,QAASA,EAAQ,QACnB,EAAE,EACFC,GAAe,CAAC,CAAC,CACnB,EAGFL,GAAkBF,CAAG,EAClB,KACCG,GAAW,IAAMC,CAAK,EACtBC,EAAIG,IAAS,CACX,MAAOA,EAAK,iBACZ,MAAOA,EAAK,WACd,EAAE,EACFD,GAAe,CAAC,CAAC,CACnB,CACJ,EACG,KACCF,EAAI,CAAC,CAACC,EAASE,CAAI,IAAOC,IAAA,GAAKH,GAAYE,EAAO,CACpD,CAGJ,KAAO,CACL,IAAMR,EAAM,gCAAgCF,CAAI,GAChD,OAAOI,GAAkBF,CAAG,EACzB,KACCK,EAAIG,IAAS,CACX,aAAcA,EAAK,YACrB,EAAE,EACFD,GAAe,CAAC,CAAC,CACnB,CACJ,CACF,CC3CO,SAASG,GACdC,EAAcC,EACW,CACzB,IAAMC,EAAM,WAAWF,CAAI,oBAAoB,mBAAmBC,CAAO,CAAC,GAC1E,OAAOE,GAGLC,GAAqB,GAAGF,CAAG,4BAA4B,EACpD,KACCG,GAAW,IAAMC,CAAK,EACtBC,EAAI,CAAC,CAAE,SAAAC,CAAS,KAAO,CACrB,QAASA,CACX,EAAE,EACFC,GAAe,CAAC,CAAC,CACnB,EAGFL,GAA2BF,CAAG,EAC3B,KACCG,GAAW,IAAMC,CAAK,EACtBC,EAAI,CAAC,CAAE,WAAAG,EAAY,YAAAC,CAAY,KAAO,CACpC,MAAOD,EACP,MAAOC,CACT,EAAE,EACFF,GAAe,CAAC,CAAC,CACnB,CACJ,EACG,KACCF,EAAI,CAAC,CAACK,EAASC,CAAI,IAAOC,IAAA,GAAKF,GAAYC,EAAO,CACpD,CACJ,CCtBO,SAASE,GACdC,EACyB,CAGzB,IAAIC,EAAQD,EAAI,MAAM,qCAAqC,EAC3D,GAAIC,EAAO,CACT,GAAM,CAAC,CAAEC,EAAMC,CAAI,EAAIF,EACvB,OAAOG,GAA2BF,EAAMC,CAAI,CAC9C,CAIA,GADAF,EAAQD,EAAI,MAAM,oCAAoC,EAClDC,EAAO,CACT,GAAM,CAAC,CAAEI,EAAMC,CAAI,EAAIL,EACvB,OAAOM,GAA2BF,EAAMC,CAAI,CAC9C,CAGA,OAAOE,CACT,CCpBA,IAAIC,GAgBG,SAASC,GACdC,EACoB,CACpB,OAAOF,QAAWG,EAAM,IAAM,CAC5B,IAAMC,EAAS,SAAsB,WAAY,cAAc,EAC/D,GAAIA,EACF,OAAOC,EAAGD,CAAM,EAKhB,GADYE,GAAqB,SAAS,EAClC,OAAQ,CACd,IAAMC,EAAU,SAA0B,WAAW,EACrD,GAAI,EAAEA,GAAWA,EAAQ,QACvB,OAAOC,CACX,CAGA,OAAOC,GAAiBP,EAAG,IAAI,EAC5B,KACCQ,EAAIC,GAAS,SAAS,WAAYA,EAAO,cAAc,CAAC,CAC1D,CAEN,CAAC,EACE,KACCC,GAAW,IAAMJ,CAAK,EACtBK,EAAOF,GAAS,OAAO,KAAKA,CAAK,EAAE,OAAS,CAAC,EAC7CG,EAAIH,IAAU,CAAE,MAAAA,CAAM,EAAE,EACxBI,EAAY,CAAC,CACf,EACJ,CASO,SAASC,GACdd,EAC+B,CAC/B,IAAMe,EAAQC,EAAW,uBAAwBhB,CAAE,EACnD,OAAOC,EAAM,IAAM,CACjB,IAAMgB,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAAC,CAAE,MAAAR,CAAM,IAAM,CAC7BM,EAAM,YAAYI,GAAkBV,CAAK,CAAC,EAC1CM,EAAM,UAAU,IAAI,+BAA+B,CACrD,CAAC,EAGMhB,GAAYC,CAAE,EAClB,KACCQ,EAAIY,GAASH,EAAM,KAAKG,CAAK,CAAC,EAC9BC,EAAS,IAAMJ,EAAM,SAAS,CAAC,EAC/BL,EAAIQ,GAAUE,EAAA,CAAE,IAAKtB,GAAOoB,EAAQ,CACtC,CACJ,CAAC,CACH,CCtDO,SAASG,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACpB,CAClB,OAAOC,GAAiB,SAAS,IAAI,EAClC,KACCC,EAAU,IAAMC,GAAgBL,EAAI,CAAE,QAAAE,EAAS,UAAAD,CAAU,CAAC,CAAC,EAC3DK,EAAI,CAAC,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,KACZ,CACL,OAAQA,GAAK,EACf,EACD,EACDC,GAAwB,QAAQ,CAClC,CACJ,CAaO,SAASC,GACdT,EAAiBU,EACY,CAC7B,OAAOC,EAAM,IAAM,CACjB,IAAMC,EAAQ,IAAIC,EAClB,OAAAD,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAE,CAAO,EAAG,CACfd,EAAG,OAASc,CACd,EAGA,UAAW,CACTd,EAAG,OAAS,EACd,CACF,CAAC,GAICe,EAAQ,wBAAwB,EAC5BC,EAAG,CAAE,OAAQ,EAAM,CAAC,EACpBjB,GAAUC,EAAIU,CAAO,GAExB,KACCO,EAAIC,GAASN,EAAM,KAAKM,CAAK,CAAC,EAC9BC,EAAS,IAAMP,EAAM,SAAS,CAAC,EAC/BN,EAAIY,GAAUE,EAAA,CAAE,IAAKpB,GAAOkB,EAAQ,CACtC,CACJ,CAAC,CACH,CCfO,SAASG,GACdC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACT,CAC7B,IAAMC,EAAQ,IAAI,IAGZC,EAAUC,EAA+B,gBAAiBL,CAAE,EAClE,QAAWM,KAAUF,EAAS,CAC5B,IAAMG,EAAK,mBAAmBD,EAAO,KAAK,UAAU,CAAC,CAAC,EAChDE,EAASC,GAAmB,QAAQF,CAAE,IAAI,EAC5C,OAAOC,GAAW,aACpBL,EAAM,IAAIG,EAAQE,CAAM,CAC5B,CAGA,IAAME,EAAUR,EACb,KACCS,GAAwB,QAAQ,EAChCC,EAAI,CAAC,CAAE,OAAAC,CAAO,IAAM,CAClB,IAAMC,EAAOC,GAAoB,MAAM,EACjCC,EAAOC,EAAW,wBAAyBH,CAAI,EACrD,OAAOD,EAAS,IACdG,EAAK,UACLF,EAAK,UAET,CAAC,EACDI,GAAM,CACR,EAqFF,OAlFmBC,GAAiB,SAAS,IAAI,EAC9C,KACCR,GAAwB,QAAQ,EAGhCS,EAAUC,GAAQC,EAAM,IAAM,CAC5B,IAAIC,EAA4B,CAAC,EACjC,OAAOC,EAAG,CAAC,GAAGrB,CAAK,EAAE,OAAO,CAACsB,EAAO,CAACnB,EAAQE,CAAM,IAAM,CACvD,KAAOe,EAAK,QACGpB,EAAM,IAAIoB,EAAKA,EAAK,OAAS,CAAC,CAAC,EACnC,SAAWf,EAAO,SACzBe,EAAK,IAAI,EAOb,IAAIG,EAASlB,EAAO,UACpB,KAAO,CAACkB,GAAUlB,EAAO,eACvBA,EAASA,EAAO,cAChBkB,EAASlB,EAAO,UAIlB,IAAImB,EAASnB,EAAO,aACpB,KAAOmB,EAAQA,EAASA,EAAO,aAC7BD,GAAUC,EAAO,UAGnB,OAAOF,EAAM,IACX,CAAC,GAAGF,EAAO,CAAC,GAAGA,EAAMjB,CAAM,CAAC,EAAE,QAAQ,EACtCoB,CACF,CACF,EAAG,IAAI,GAAkC,CAAC,CAC5C,CAAC,EACE,KAGCd,EAAIa,GAAS,IAAI,IAAI,CAAC,GAAGA,CAAK,EAAE,KAAK,CAAC,CAAC,CAAEG,CAAC,EAAG,CAAC,CAAEC,CAAC,IAAMD,EAAIC,CAAC,CAAC,CAAC,EAC9DC,GAAkBpB,CAAO,EAGzBU,EAAU,CAAC,CAACK,EAAOM,CAAM,IAAM9B,EAC5B,KACC+B,GAAK,CAAC,CAACC,EAAMC,CAAI,EAAG,CAAE,OAAQ,CAAE,EAAAC,CAAE,EAAG,KAAAC,CAAK,IAAM,CAC9C,IAAMC,EAAOF,EAAIC,EAAK,QAAU,KAAK,MAAMf,EAAK,MAAM,EAGtD,KAAOa,EAAK,QAAQ,CAClB,GAAM,CAAC,CAAER,CAAM,EAAIQ,EAAK,CAAC,EACzB,GAAIR,EAASK,EAASI,GAAKE,EACzBJ,EAAO,CAAC,GAAGA,EAAMC,EAAK,MAAM,CAAE,MAE9B,MAEJ,CAGA,KAAOD,EAAK,QAAQ,CAClB,GAAM,CAAC,CAAEP,CAAM,EAAIO,EAAKA,EAAK,OAAS,CAAC,EACvC,GAAIP,EAASK,GAAUI,GAAK,CAACE,EAC3BH,EAAO,CAACD,EAAK,IAAI,EAAI,GAAGC,CAAI,MAE5B,MAEJ,CAGA,MAAO,CAACD,EAAMC,CAAI,CACpB,EAAG,CAAC,CAAC,EAAG,CAAC,GAAGT,CAAK,CAAC,CAAC,EACnBa,EAAqB,CAACV,EAAGC,IACvBD,EAAE,CAAC,IAAMC,EAAE,CAAC,GACZD,EAAE,CAAC,IAAMC,EAAE,CAAC,CACb,CACH,CACF,CACF,CACF,CACF,EAIC,KACCjB,EAAI,CAAC,CAACqB,EAAMC,CAAI,KAAO,CACrB,KAAMD,EAAK,IAAI,CAAC,CAACV,CAAI,IAAMA,CAAI,EAC/B,KAAMW,EAAK,IAAI,CAAC,CAACX,CAAI,IAAMA,CAAI,CACjC,EAAE,EAGFgB,EAAU,CAAE,KAAM,CAAC,EAAG,KAAM,CAAC,CAAE,CAAC,EAChCC,GAAY,EAAG,CAAC,EAChB5B,EAAI,CAAC,CAACgB,EAAGC,CAAC,IAGJD,EAAE,KAAK,OAASC,EAAE,KAAK,OAClB,CACL,KAAMA,EAAE,KAAK,MAAM,KAAK,IAAI,EAAGD,EAAE,KAAK,OAAS,CAAC,EAAGC,EAAE,KAAK,MAAM,EAChE,KAAM,CAAC,CACT,EAIO,CACL,KAAMA,EAAE,KAAK,MAAM,EAAE,EACrB,KAAMA,EAAE,KAAK,MAAM,EAAGA,EAAE,KAAK,OAASD,EAAE,KAAK,MAAM,CACrD,CAEH,CACH,CACJ,CAYO,SAASa,GACdzC,EAAiB,CAAE,UAAAC,EAAW,QAAAC,EAAS,MAAAwC,EAAO,QAAAC,CAAQ,EACd,CACxC,OAAOrB,EAAM,IAAM,CACjB,IAAMsB,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,EAAe,EAAGC,GAAQ,EAAI,CAAC,EAoBxD,GAnBAJ,EAAM,UAAU,CAAC,CAAE,KAAAX,EAAM,KAAAC,CAAK,IAAM,CAGlC,OAAW,CAAC5B,CAAM,IAAK4B,EACrB5B,EAAO,UAAU,OAAO,sBAAsB,EAC9CA,EAAO,UAAU,OAAO,sBAAsB,EAIhD,OAAW,CAACmB,EAAO,CAACnB,CAAM,CAAC,IAAK2B,EAAK,QAAQ,EAC3C3B,EAAO,UAAU,IAAI,sBAAsB,EAC3CA,EAAO,UAAU,OACf,uBACAmB,IAAUQ,EAAK,OAAS,CAC1B,CAEJ,CAAC,EAGGgB,EAAQ,YAAY,EAAG,CAGzB,IAAMC,EAAUC,EACdlD,EAAU,KAAKmD,GAAa,CAAC,EAAGxC,EAAI,IAAG,EAAY,CAAC,EACpDX,EAAU,KAAKmD,GAAa,GAAG,EAAGxC,EAAI,IAAM,QAAiB,CAAC,CAChE,EAGAgC,EACG,KACCS,EAAO,CAAC,CAAE,KAAApB,CAAK,IAAMA,EAAK,OAAS,CAAC,EACpCH,GAAkBY,EAAM,KAAKY,GAAUC,EAAc,CAAC,CAAC,EACvDC,GAAeN,CAAO,CACxB,EACG,UAAU,CAAC,CAAC,CAAC,CAAE,KAAAjB,CAAK,CAAC,EAAGwB,CAAQ,IAAM,CACrC,GAAM,CAACnD,CAAM,EAAI2B,EAAKA,EAAK,OAAS,CAAC,EACrC,GAAI3B,EAAO,aAAc,CAGvB,IAAMoD,EAAYC,GAAoBrD,CAAM,EAC5C,GAAI,OAAOoD,GAAc,YAAa,CACpC,IAAMhC,EAASpB,EAAO,UAAYoD,EAAU,UACtC,CAAE,OAAA7C,CAAO,EAAI+C,GAAeF,CAAS,EAC3CA,EAAU,SAAS,CACjB,IAAKhC,EAASb,EAAS,EACvB,SAAA4C,CACF,CAAC,CACH,CACF,CACF,CAAC,CACP,CAGA,OAAIR,EAAQ,qBAAqB,GAC/BhD,EACG,KACC4D,EAAUf,CAAK,EACfnC,GAAwB,QAAQ,EAChCyC,GAAa,GAAG,EAChBU,GAAK,CAAC,EACND,EAAUlB,EAAQ,KAAKmB,GAAK,CAAC,CAAC,CAAC,EAC/BC,GAAO,CAAE,MAAO,GAAI,CAAC,EACrBP,GAAeZ,CAAK,CACtB,EACG,UAAU,CAAC,CAAC,CAAE,CAAE,KAAAX,CAAK,CAAC,IAAM,CAC3B,IAAM+B,EAAMC,GAAY,EAGlB3D,EAAS2B,EAAKA,EAAK,OAAS,CAAC,EACnC,GAAI3B,GAAUA,EAAO,OAAQ,CAC3B,GAAM,CAAC4D,CAAM,EAAI5D,EACX,CAAE,KAAA6D,CAAK,EAAI,IAAI,IAAID,EAAO,IAAI,EAChCF,EAAI,OAASG,IACfH,EAAI,KAAOG,EACX,QAAQ,aAAa,CAAC,EAAG,GAAI,GAAGH,CAAG,EAAE,EAIzC,MACEA,EAAI,KAAO,GACX,QAAQ,aAAa,CAAC,EAAG,GAAI,GAAGA,CAAG,EAAE,CAEzC,CAAC,EAGAjE,GAAqBC,EAAI,CAAE,UAAAC,EAAW,QAAAC,CAAQ,CAAC,EACnD,KACCkE,EAAIC,GAASzB,EAAM,KAAKyB,CAAK,CAAC,EAC9BC,EAAS,IAAM1B,EAAM,SAAS,CAAC,EAC/BhC,EAAIyD,GAAUE,EAAA,CAAE,IAAKvE,GAAOqE,EAAQ,CACtC,CACJ,CAAC,CACH,CC9RO,SAASG,GACdC,EAAkB,CAAE,UAAAC,EAAW,MAAAC,EAAO,QAAAC,CAAQ,EACvB,CAGvB,IAAMC,EAAaH,EAChB,KACCI,EAAI,CAAC,CAAE,OAAQ,CAAE,EAAAC,CAAE,CAAE,IAAMA,CAAC,EAC5BC,GAAY,EAAG,CAAC,EAChBF,EAAI,CAAC,CAAC,EAAGG,CAAC,IAAM,EAAIA,GAAKA,EAAI,CAAC,EAC9BC,EAAqB,CACvB,EAGIC,EAAUR,EACb,KACCG,EAAI,CAAC,CAAE,OAAAM,CAAO,IAAMA,CAAM,CAC5B,EAGF,OAAOC,EAAc,CAACF,EAASN,CAAU,CAAC,EACvC,KACCC,EAAI,CAAC,CAACM,EAAQE,CAAS,IAAM,EAAEF,GAAUE,EAAU,EACnDJ,EAAqB,EACrBK,EAAUX,EAAQ,KAAKY,GAAK,CAAC,CAAC,CAAC,EAC/BC,GAAQ,EAAI,EACZC,GAAO,CAAE,MAAO,GAAI,CAAC,EACrBZ,EAAIa,IAAW,CAAE,OAAAA,CAAO,EAAE,CAC5B,CACJ,CAYO,SAASC,GACdC,EAAiB,CAAE,UAAAnB,EAAW,QAAAoB,EAAS,MAAAnB,EAAO,QAAAC,CAAQ,EACpB,CAClC,IAAMmB,EAAQ,IAAIC,EACZC,EAAQF,EAAM,KAAKG,EAAe,EAAGT,GAAQ,EAAI,CAAC,EACxD,OAAAM,EAAM,UAAU,CAGd,KAAK,CAAE,OAAAJ,CAAO,EAAG,CACfE,EAAG,OAASF,EACRA,GACFE,EAAG,aAAa,WAAY,IAAI,EAChCA,EAAG,KAAK,GAERA,EAAG,gBAAgB,UAAU,CAEjC,EAGA,UAAW,CACTA,EAAG,MAAM,IAAM,GACfA,EAAG,OAAS,GACZA,EAAG,gBAAgB,UAAU,CAC/B,CACF,CAAC,EAGDC,EACG,KACCP,EAAUU,CAAK,EACfE,GAAwB,QAAQ,CAClC,EACG,UAAU,CAAC,CAAE,OAAAC,CAAO,IAAM,CACzBP,EAAG,MAAM,IAAM,GAAGO,EAAS,EAAE,IAC/B,CAAC,EAGLC,EAAUR,EAAI,OAAO,EAClB,UAAUS,GAAM,CACfA,EAAG,eAAe,EAClB,OAAO,SAAS,CAAE,IAAK,CAAE,CAAC,CAC5B,CAAC,EAGI9B,GAAeqB,EAAI,CAAE,UAAAnB,EAAW,MAAAC,EAAO,QAAAC,CAAQ,CAAC,EACpD,KACC2B,EAAIC,GAAST,EAAM,KAAKS,CAAK,CAAC,EAC9BC,EAAS,IAAMV,EAAM,SAAS,CAAC,EAC/BjB,EAAI0B,GAAUE,EAAA,CAAE,IAAKb,GAAOW,EAAQ,CACtC,CACJ,CClHO,SAASG,GACd,CAAE,UAAAC,EAAW,UAAAC,CAAU,EACjB,CACND,EACG,KACCE,EAAU,IAAMC,EAAY,cAAc,CAAC,EAC3CC,GAASC,GAAMC,GAAuBD,CAAE,EACrC,KACCE,EAAUP,EAAU,KAAKQ,GAAK,CAAC,CAAC,CAAC,EACjCC,EAAOC,GAAWA,CAAO,EACzBC,EAAI,IAAMN,CAAE,EACZO,GAAK,CAAC,CACR,CACF,EACAH,EAAOJ,GAAMA,EAAG,YAAcA,EAAG,WAAW,EAC5CD,GAASC,GAAM,CACb,IAAMQ,EAAOR,EAAG,UACVS,EAAOT,EAAG,QAAQ,GAAG,GAAKA,EAIhC,OAHAS,EAAK,MAAQD,EAGRE,EAAQ,kBAAkB,EAIxBC,GAAoBF,EAAM,CAAE,UAAAb,CAAU,CAAC,EAC3C,KACCM,EAAUP,EAAU,KAAKQ,GAAK,CAAC,CAAC,CAAC,EACjCS,EAAS,IAAMH,EAAK,gBAAgB,OAAO,CAAC,CAC9C,EAPOI,CAQX,CAAC,CACH,EACG,UAAU,EAGXH,EAAQ,kBAAkB,GAC5Bf,EACG,KACCE,EAAU,IAAMC,EAAY,YAAY,CAAC,EACzCC,GAASC,GAAMW,GAAoBX,EAAI,CAAE,UAAAJ,CAAU,CAAC,CAAC,CACvD,EACG,UAAU,CACnB,CCpDO,SAASkB,GACd,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACf,CACND,EACG,KACCE,EAAU,IAAMC,EACd,2BACF,CAAC,EACDC,EAAIC,GAAM,CACRA,EAAG,cAAgB,GACnBA,EAAG,QAAU,EACf,CAAC,EACDC,GAASD,GAAME,EAAUF,EAAI,QAAQ,EAClC,KACCG,GAAU,IAAMH,EAAG,UAAU,SAAS,0BAA0B,CAAC,EACjEI,EAAI,IAAMJ,CAAE,CACd,CACF,EACAK,GAAeT,CAAO,CACxB,EACG,UAAU,CAAC,CAACI,EAAIM,CAAM,IAAM,CAC3BN,EAAG,UAAU,OAAO,0BAA0B,EAC1CM,IACFN,EAAG,QAAU,GACjB,CAAC,CACP,CC9BA,SAASO,IAAyB,CAChC,MAAO,qBAAqB,KAAK,UAAU,SAAS,CACtD,CAiBO,SAASC,GACd,CAAE,UAAAC,CAAU,EACN,CACNA,EACG,KACCC,EAAU,IAAMC,EAAY,qBAAqB,CAAC,EAClDC,EAAIC,GAAMA,EAAG,gBAAgB,mBAAmB,CAAC,EACjDC,EAAOP,EAAa,EACpBQ,GAASF,GAAMG,EAAUH,EAAI,YAAY,EACtC,KACCI,EAAI,IAAMJ,CAAE,CACd,CACF,CACF,EACG,UAAUA,GAAM,CACf,IAAMK,EAAML,EAAG,UAGXK,IAAQ,EACVL,EAAG,UAAY,EAGNK,EAAML,EAAG,eAAiBA,EAAG,eACtCA,EAAG,UAAYK,EAAM,EAEzB,CAAC,CACP,CCpCO,SAASC,GACd,CAAE,UAAAC,EAAW,QAAAC,CAAQ,EACf,CACNC,EAAc,CAACC,GAAY,QAAQ,EAAGF,CAAO,CAAC,EAC3C,KACCG,EAAI,CAAC,CAACC,EAAQC,CAAM,IAAMD,GAAU,CAACC,CAAM,EAC3CC,EAAUF,GAAUG,EAAGH,CAAM,EAC1B,KACCI,GAAMJ,EAAS,IAAM,GAAG,CAC1B,CACF,EACAK,GAAeV,CAAS,CAC1B,EACG,UAAU,CAAC,CAACK,EAAQ,CAAE,OAAQ,CAAE,EAAAM,CAAE,CAAC,CAAC,IAAM,CACzC,GAAIN,EACF,SAAS,KAAK,aAAa,qBAAsB,EAAE,EACnD,SAAS,KAAK,MAAM,IAAM,IAAIM,CAAC,SAC1B,CACL,IAAMC,EAAQ,GAAK,SAAS,SAAS,KAAK,MAAM,IAAK,EAAE,EACvD,SAAS,KAAK,gBAAgB,oBAAoB,EAClD,SAAS,KAAK,MAAM,IAAM,GACtBA,GACF,OAAO,SAAS,EAAGA,CAAK,CAC5B,CACF,CAAC,CACP,CC7DK,OAAO,UACV,OAAO,QAAU,SAAUC,EAAa,CACtC,IAAMC,EAA2B,CAAC,EAClC,QAAWC,KAAO,OAAO,KAAKF,CAAG,EAE/BC,EAAK,KAAK,CAACC,EAAKF,EAAIE,CAAG,CAAC,CAAC,EAG3B,OAAOD,CACT,GAGG,OAAO,SACV,OAAO,OAAS,SAAUD,EAAa,CACrC,IAAMC,EAAiB,CAAC,EACxB,QAAWC,KAAO,OAAO,KAAKF,CAAG,EAE/BC,EAAK,KAAKD,EAAIE,CAAG,CAAC,EAGpB,OAAOD,CACT,GAKE,OAAO,SAAY,cAGhB,QAAQ,UAAU,WACrB,QAAQ,UAAU,SAAW,SAC3BE,EAA8BC,EACxB,CACF,OAAOD,GAAM,UACf,KAAK,WAAaA,EAAE,KACpB,KAAK,UAAYA,EAAE,MAEnB,KAAK,WAAaA,EAClB,KAAK,UAAYC,EAErB,GAGG,QAAQ,UAAU,cACrB,QAAQ,UAAU,YAAc,YAC3BC,EACG,CACN,IAAMC,EAAS,KAAK,WACpB,GAAIA,EAAQ,CACND,EAAM,SAAW,GACnBC,EAAO,YAAY,IAAI,EAGzB,QAASC,EAAIF,EAAM,OAAS,EAAGE,GAAK,EAAGA,IAAK,CAC1C,IAAIC,EAAOH,EAAME,CAAC,EACd,OAAOC,GAAS,SAClBA,EAAO,SAAS,eAAeA,CAAI,EAC5BA,EAAK,YACZA,EAAK,WAAW,YAAYA,CAAI,EAG7BD,EAGHD,EAAO,aAAa,KAAK,gBAAkBE,CAAI,EAF/CF,EAAO,aAAaE,EAAM,IAAI,CAGlC,CACF,CACF,I3MMJ,SAASC,IAA4C,CACnD,OAAI,SAAS,WAAa,QACjBC,GACL,GAAG,IAAI,IAAI,yBAA0BC,GAAO,IAAI,CAAC,EACnD,EACG,KAECC,EAAI,IAAM,OAAO,EACjBC,EAAY,CAAC,CACf,EAEKC,GACL,IAAI,IAAI,2BAA4BH,GAAO,IAAI,CACjD,CAEJ,CAOA,SAAS,gBAAgB,UAAU,OAAO,OAAO,EACjD,SAAS,gBAAgB,UAAU,IAAI,IAAI,EAG3C,IAAMI,GAAYC,GAAc,EAC1BC,GAAYC,GAAc,EAC1BC,GAAYC,GAAoBH,EAAS,EACzCI,GAAYC,GAAc,EAG1BC,GAAYC,GAAc,EAC1BC,GAAYC,GAAW,oBAAoB,EAC3CC,GAAYD,GAAW,qBAAqB,EAC5CE,GAAYC,GAAW,EAGvBlB,GAASmB,GAAc,EACvBC,GAAS,SAAS,MAAM,UAAU,QAAQ,EAC5CtB,GAAiB,EACjBuB,GAGEC,GAAS,IAAIC,EACnBC,GAAiB,CAAE,OAAAF,EAAO,CAAC,EAG3B,IAAMG,GAAY,IAAIF,EAGlBG,EAAQ,oBAAoB,GAC9BC,GAAuB,CAAE,UAAArB,GAAW,UAAAM,GAAW,UAAAa,EAAU,CAAC,EACvD,UAAUrB,EAAS,EAzJxB,IAAAwB,KA4JIA,GAAA5B,GAAO,UAAP,YAAA4B,GAAgB,YAAa,QAC/BC,GAAqB,CAAE,UAAAzB,EAAU,CAAC,EAGpC0B,EAAMxB,GAAWE,EAAO,EACrB,KACCuB,GAAM,GAAG,CACX,EACG,UAAU,IAAM,CACfC,GAAU,SAAU,EAAK,EACzBA,GAAU,SAAU,EAAK,CAC3B,CAAC,EAGLtB,GACG,KACCuB,EAAO,CAAC,CAAE,KAAAC,CAAK,IAAMA,IAAS,QAAQ,CACxC,EACG,UAAUC,GAAO,CAChB,OAAQA,EAAI,KAAM,CAGhB,IAAK,IACL,IAAK,IACH,IAAMC,EAAOC,GAAoC,gBAAgB,EAC7D,OAAOD,GAAS,aAClBE,GAAYF,CAAI,EAClB,MAGF,IAAK,IACL,IAAK,IACH,IAAMG,EAAOF,GAAoC,gBAAgB,EAC7D,OAAOE,GAAS,aAClBD,GAAYC,CAAI,EAClB,MAGF,IAAK,QACH,IAAMC,EAASC,GAAiB,EAC5BD,aAAkB,kBACpBA,EAAO,MAAM,CACnB,CACF,CAAC,EAGLE,GAAc,CAAE,UAAA9B,GAAW,UAAAR,EAAU,CAAC,EACtCuC,GAAmB,CAAE,UAAAvC,GAAW,QAAAU,EAAQ,CAAC,EACzC8B,GAAe,CAAE,UAAAxC,EAAU,CAAC,EAC5ByC,GAAgB,CAAE,UAAAjC,GAAW,QAAAE,EAAQ,CAAC,EAGtC,IAAMgC,GAAUC,GAAYC,GAAoB,QAAQ,EAAG,CAAE,UAAApC,EAAU,CAAC,EAClEqC,GAAQ7C,GACX,KACCH,EAAI,IAAM+C,GAAoB,MAAM,CAAC,EACrCE,EAAUC,GAAMC,GAAUD,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,EAAQ,CAAC,CAAC,EACrD5C,EAAY,CAAC,CACf,EAGImD,GAAWvB,EAGf,GAAGwB,GAAqB,SAAS,EAC9B,IAAIH,GAAMI,GAAaJ,EAAI,CAAE,QAAA3C,EAAQ,CAAC,CAAC,EAG1C,GAAG8C,GAAqB,QAAQ,EAC7B,IAAIH,GAAMK,GAAYL,EAAI,CAAE,OAAA7B,EAAO,CAAC,CAAC,EAGxC,GAAGgC,GAAqB,SAAS,EAC9B,IAAIH,GAAMM,GAAaN,CAAE,CAAC,EAG7B,GAAGG,GAAqB,UAAU,EAC/B,IAAIH,GAAMO,GAAcP,EAAI,CAAE,UAAA1B,EAAU,CAAC,CAAC,EAG7C,GAAG6B,GAAqB,QAAQ,EAC7B,IAAIH,GAAMQ,GAAYR,EAAI,CAAE,OAAA/B,GAAQ,UAAAV,EAAU,CAAC,CAAC,EAGnD,GAAG4C,GAAqB,QAAQ,EAC7B,IAAIH,GAAMS,GAAYT,CAAE,CAAC,CAC9B,EAGMU,GAAWC,EAAM,IAAMhC,EAG3B,GAAGwB,GAAqB,UAAU,EAC/B,IAAIH,GAAMY,GAAcZ,CAAE,CAAC,EAG9B,GAAGG,GAAqB,SAAS,EAC9B,IAAIH,GAAMa,GAAab,EAAI,CAAE,UAAAvC,GAAW,QAAAJ,GAAS,OAAAS,EAAO,CAAC,CAAC,EAG7D,GAAGqC,GAAqB,SAAS,EAC9B,IAAIH,GAAMzB,EAAQ,kBAAkB,EACjCuC,GAAoBd,EAAI,CAAE,OAAA/B,GAAQ,UAAAd,EAAU,CAAC,EAC7C4D,CACJ,EAGF,GAAGZ,GAAqB,QAAQ,EAC7B,IAAIH,GAAMgB,GAAYhB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,EAAM,CAAC,CAAC,EAG3D,GAAGK,GAAqB,cAAc,EACnC,IAAIH,GAAMiB,GAAiBjB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,EAAQ,CAAC,CAAC,EAGzD,GAAGQ,GAAqB,SAAS,EAC9B,IAAIH,GAAMA,EAAG,aAAa,cAAc,IAAM,aAC3CkB,GAAGrD,GAAS,IAAMsD,GAAanB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,EAAM,CAAC,CAAC,EACjEoB,GAAGvD,GAAS,IAAMwD,GAAanB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,EAAM,CAAC,CAAC,CACrE,EAGF,GAAGK,GAAqB,MAAM,EAC3B,IAAIH,GAAMoB,GAAUpB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,EAAQ,CAAC,CAAC,EAGlD,GAAGQ,GAAqB,KAAK,EAC1B,IAAIH,GAAMqB,GAAqBrB,EAAI,CAClC,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,GAAO,QAAAzC,EAC7B,CAAC,CAAC,EAGJ,GAAG8C,GAAqB,KAAK,EAC1B,IAAIH,GAAMsB,GAAetB,EAAI,CAAE,UAAAvC,GAAW,QAAAkC,GAAS,MAAAG,GAAO,QAAAzC,EAAQ,CAAC,CAAC,CACzE,CAAC,EAGKkE,GAAatE,GAChB,KACC8C,EAAU,IAAMW,EAAQ,EACxBc,GAAUtB,EAAQ,EAClBnD,EAAY,CAAC,CACf,EAGFwE,GAAW,UAAU,EAMrB,OAAO,UAAatE,GACpB,OAAO,UAAaE,GACpB,OAAO,QAAaE,GACpB,OAAO,UAAaE,GACpB,OAAO,UAAaE,GACpB,OAAO,QAAaE,GACpB,OAAO,QAAaE,GACpB,OAAO,OAAaC,GACpB,OAAO,OAAaK,GACpB,OAAO,UAAaG,GACpB,OAAO,WAAaiD",
+  "names": ["require_focus_visible", "__commonJSMin", "exports", "module", "global", "factory", "applyFocusVisiblePolyfill", "scope", "hadKeyboardEvent", "hadFocusVisibleRecently", "hadFocusVisibleRecentlyTimeout", "inputTypesAllowlist", "isValidFocusTarget", "el", "focusTriggersKeyboardModality", "type", "tagName", "addFocusVisibleClass", "removeFocusVisibleClass", "onKeyDown", "e", "onPointerDown", "onFocus", "onBlur", "onVisibilityChange", "addInitialPointerMoveListeners", "onInitialPointerMove", "removeInitialPointerMoveListeners", "event", "error", "require_escape_html", "__commonJSMin", "exports", "module", "matchHtmlRegExp", "escapeHtml", "string", "str", "match", "escape", "html", "index", "lastIndex", "require_clipboard", "__commonJSMin", "exports", "module", "root", "factory", "__webpack_modules__", "__unused_webpack_module", "__webpack_exports__", "__webpack_require__", "clipboard", "tiny_emitter", "tiny_emitter_default", "listen", "listen_default", "src_select", "select_default", "command", "type", "err", "ClipboardActionCut", "target", "selectedText", "actions_cut", "createFakeElement", "value", "isRTL", "fakeElement", "yPosition", "fakeCopyAction", "options", "ClipboardActionCopy", "actions_copy", "_typeof", "obj", "ClipboardActionDefault", "_options$action", "action", "container", "text", "actions_default", "clipboard_typeof", "_classCallCheck", "instance", "Constructor", "_defineProperties", "props", "i", "descriptor", "_createClass", "protoProps", "staticProps", "_inherits", "subClass", "superClass", "_setPrototypeOf", "o", "p", "_createSuper", "Derived", "hasNativeReflectConstruct", "_isNativeReflectConstruct", "Super", "_getPrototypeOf", "result", "NewTarget", "_possibleConstructorReturn", "self", "call", "_assertThisInitialized", "e", "getAttributeValue", "suffix", "element", "attribute", "Clipboard", "_Emitter", "_super", "trigger", "_this", "_this2", "selector", "actions", "support", "DOCUMENT_NODE_TYPE", "proto", "closest", "__unused_webpack_exports", "_delegate", "callback", "useCapture", "listenerFn", "listener", "delegate", "elements", "is", "listenNode", "listenNodeList", "listenSelector", "node", "nodeList", "select", "isReadOnly", "selection", "range", "E", "name", "ctx", "data", "evtArr", "len", "evts", "liveEvents", "__webpack_module_cache__", "moduleId", "getter", "definition", "key", "prop", "import_focus_visible", "extendStatics", "d", "b", "p", "__extends", "__", "__awaiter", "thisArg", "_arguments", "P", "generator", "adopt", "value", "resolve", "reject", "fulfilled", "step", "e", "rejected", "result", "__generator", "body", "_", "t", "f", "y", "g", "verb", "n", "v", "op", "__values", "o", "s", "m", "i", "__read", "n", "r", "ar", "e", "error", "__spreadArray", "to", "from", "pack", "i", "l", "ar", "__await", "v", "__asyncGenerator", "thisArg", "_arguments", "generator", "g", "q", "verb", "awaitReturn", "f", "reject", "n", "a", "b", "resume", "step", "e", "settle", "r", "fulfill", "value", "__asyncValues", "o", "m", "i", "__values", "verb", "n", "v", "resolve", "reject", "settle", "d", "isFunction", "value", "createErrorClass", "createImpl", "_super", "instance", "ctorFunc", "UnsubscriptionError", "createErrorClass", "_super", "errors", "err", "i", "arrRemove", "arr", "item", "index", "Subscription", "initialTeardown", "errors", "_parentage", "_parentage_1", "__values", "_parentage_1_1", "parent_1", "initialFinalizer", "isFunction", "e", "UnsubscriptionError", "_finalizers", "_finalizers_1", "_finalizers_1_1", "finalizer", "execFinalizer", "err", "__spreadArray", "__read", "teardown", "_a", "parent", "arrRemove", "empty", "EMPTY_SUBSCRIPTION", "Subscription", "isSubscription", "value", "isFunction", "execFinalizer", "finalizer", "config", "timeoutProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "reportUnhandledError", "err", "timeoutProvider", "onUnhandledError", "config", "noop", "COMPLETE_NOTIFICATION", "createNotification", "errorNotification", "error", "nextNotification", "value", "kind", "context", "errorContext", "cb", "config", "isRoot", "_a", "errorThrown", "error", "captureError", "err", "Subscriber", "_super", "__extends", "destination", "_this", "isSubscription", "EMPTY_OBSERVER", "next", "error", "complete", "SafeSubscriber", "value", "handleStoppedNotification", "nextNotification", "err", "errorNotification", "COMPLETE_NOTIFICATION", "Subscription", "_bind", "bind", "fn", "thisArg", "ConsumerObserver", "partialObserver", "value", "error", "handleUnhandledError", "err", "SafeSubscriber", "_super", "__extends", "observerOrNext", "complete", "_this", "isFunction", "context_1", "config", "Subscriber", "handleUnhandledError", "error", "config", "captureError", "reportUnhandledError", "defaultErrorHandler", "err", "handleStoppedNotification", "notification", "subscriber", "onStoppedNotification", "timeoutProvider", "EMPTY_OBSERVER", "noop", "observable", "identity", "x", "pipe", "fns", "_i", "pipeFromArray", "identity", "input", "prev", "fn", "Observable", "subscribe", "operator", "observable", "observerOrNext", "error", "complete", "_this", "subscriber", "isSubscriber", "SafeSubscriber", "errorContext", "_a", "source", "sink", "err", "next", "promiseCtor", "getPromiseCtor", "resolve", "reject", "value", "operations", "_i", "pipeFromArray", "x", "getPromiseCtor", "promiseCtor", "_a", "config", "isObserver", "value", "isFunction", "isSubscriber", "Subscriber", "isSubscription", "hasLift", "source", "isFunction", "operate", "init", "liftedSource", "err", "createOperatorSubscriber", "destination", "onNext", "onComplete", "onError", "onFinalize", "OperatorSubscriber", "_super", "__extends", "shouldUnsubscribe", "_this", "value", "err", "closed_1", "_a", "Subscriber", "animationFrameProvider", "callback", "request", "cancel", "delegate", "handle", "timestamp", "Subscription", "args", "_i", "__spreadArray", "__read", "ObjectUnsubscribedError", "createErrorClass", "_super", "Subject", "_super", "__extends", "_this", "operator", "subject", "AnonymousSubject", "ObjectUnsubscribedError", "value", "errorContext", "_b", "__values", "_c", "observer", "err", "observers", "_a", "subscriber", "hasError", "isStopped", "EMPTY_SUBSCRIPTION", "Subscription", "arrRemove", "thrownError", "observable", "Observable", "destination", "source", "AnonymousSubject", "_super", "__extends", "destination", "source", "_this", "value", "_b", "_a", "err", "subscriber", "EMPTY_SUBSCRIPTION", "Subject", "BehaviorSubject", "_super", "__extends", "_value", "_this", "subscriber", "subscription", "_a", "hasError", "thrownError", "value", "Subject", "dateTimestampProvider", "ReplaySubject", "_super", "__extends", "_bufferSize", "_windowTime", "_timestampProvider", "dateTimestampProvider", "_this", "value", "_a", "isStopped", "_buffer", "_infiniteTimeWindow", "subscriber", "subscription", "copy", "i", "adjustedBufferSize", "now", "last", "Subject", "Action", "_super", "__extends", "scheduler", "work", "state", "delay", "Subscription", "intervalProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "AsyncAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "_a", "_id", "intervalProvider", "_scheduler", "error", "_delay", "errored", "errorValue", "e", "actions", "arrRemove", "Action", "Scheduler", "schedulerActionCtor", "now", "work", "delay", "state", "dateTimestampProvider", "AsyncScheduler", "_super", "__extends", "SchedulerAction", "now", "Scheduler", "_this", "action", "actions", "error", "asyncScheduler", "AsyncScheduler", "AsyncAction", "async", "QueueAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "AsyncAction", "QueueScheduler", "_super", "__extends", "AsyncScheduler", "queueScheduler", "QueueScheduler", "QueueAction", "AnimationFrameAction", "_super", "__extends", "scheduler", "work", "_this", "id", "delay", "animationFrameProvider", "actions", "_a", "AsyncAction", "AnimationFrameScheduler", "_super", "__extends", "action", "flushId", "actions", "error", "AsyncScheduler", "animationFrameScheduler", "AnimationFrameScheduler", "AnimationFrameAction", "EMPTY", "Observable", "subscriber", "isScheduler", "value", "isFunction", "last", "arr", "popResultSelector", "args", "isFunction", "popScheduler", "isScheduler", "popNumber", "defaultValue", "isArrayLike", "x", "isPromise", "value", "isFunction", "isInteropObservable", "input", "isFunction", "observable", "isAsyncIterable", "obj", "isFunction", "createInvalidObservableTypeError", "input", "getSymbolIterator", "iterator", "isIterable", "input", "isFunction", "iterator", "readableStreamLikeToAsyncGenerator", "readableStream", "reader", "__await", "_a", "_b", "value", "done", "isReadableStreamLike", "obj", "isFunction", "innerFrom", "input", "Observable", "isInteropObservable", "fromInteropObservable", "isArrayLike", "fromArrayLike", "isPromise", "fromPromise", "isAsyncIterable", "fromAsyncIterable", "isIterable", "fromIterable", "isReadableStreamLike", "fromReadableStreamLike", "createInvalidObservableTypeError", "obj", "subscriber", "obs", "observable", "isFunction", "array", "i", "promise", "value", "err", "reportUnhandledError", "iterable", "iterable_1", "__values", "iterable_1_1", "asyncIterable", "process", "readableStream", "readableStreamLikeToAsyncGenerator", "asyncIterable_1", "__asyncValues", "asyncIterable_1_1", "executeSchedule", "parentSubscription", "scheduler", "work", "delay", "repeat", "scheduleSubscription", "observeOn", "scheduler", "delay", "operate", "source", "subscriber", "createOperatorSubscriber", "value", "executeSchedule", "err", "subscribeOn", "scheduler", "delay", "operate", "source", "subscriber", "scheduleObservable", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "schedulePromise", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "scheduleArray", "input", "scheduler", "Observable", "subscriber", "i", "scheduleIterable", "input", "scheduler", "Observable", "subscriber", "iterator", "executeSchedule", "value", "done", "_a", "err", "isFunction", "scheduleAsyncIterable", "input", "scheduler", "Observable", "subscriber", "executeSchedule", "iterator", "result", "scheduleReadableStreamLike", "input", "scheduler", "scheduleAsyncIterable", "readableStreamLikeToAsyncGenerator", "scheduled", "input", "scheduler", "isInteropObservable", "scheduleObservable", "isArrayLike", "scheduleArray", "isPromise", "schedulePromise", "isAsyncIterable", "scheduleAsyncIterable", "isIterable", "scheduleIterable", "isReadableStreamLike", "scheduleReadableStreamLike", "createInvalidObservableTypeError", "from", "input", "scheduler", "scheduled", "innerFrom", "of", "args", "_i", "scheduler", "popScheduler", "from", "throwError", "errorOrErrorFactory", "scheduler", "errorFactory", "isFunction", "init", "subscriber", "Observable", "EmptyError", "createErrorClass", "_super", "isValidDate", "value", "map", "project", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "isArray", "callOrApply", "fn", "args", "__spreadArray", "__read", "mapOneOrManyArgs", "map", "isArray", "getPrototypeOf", "objectProto", "getKeys", "argsArgArrayOrObject", "args", "first_1", "isPOJO", "keys", "key", "obj", "createObject", "keys", "values", "result", "key", "i", "combineLatest", "args", "_i", "scheduler", "popScheduler", "resultSelector", "popResultSelector", "_a", "argsArgArrayOrObject", "observables", "keys", "from", "result", "Observable", "combineLatestInit", "values", "createObject", "identity", "mapOneOrManyArgs", "valueTransform", "subscriber", "maybeSchedule", "length", "active", "remainingFirstValues", "i", "source", "hasFirstValue", "createOperatorSubscriber", "value", "execute", "subscription", "executeSchedule", "mergeInternals", "source", "subscriber", "project", "concurrent", "onBeforeNext", "expand", "innerSubScheduler", "additionalFinalizer", "buffer", "active", "index", "isComplete", "checkComplete", "outerNext", "value", "doInnerSub", "innerComplete", "innerFrom", "createOperatorSubscriber", "innerValue", "bufferedValue", "executeSchedule", "err", "mergeMap", "project", "resultSelector", "concurrent", "isFunction", "a", "i", "map", "b", "ii", "innerFrom", "operate", "source", "subscriber", "mergeInternals", "mergeAll", "concurrent", "mergeMap", "identity", "concatAll", "mergeAll", "concat", "args", "_i", "concatAll", "from", "popScheduler", "defer", "observableFactory", "Observable", "subscriber", "innerFrom", "nodeEventEmitterMethods", "eventTargetMethods", "jqueryMethods", "fromEvent", "target", "eventName", "options", "resultSelector", "isFunction", "mapOneOrManyArgs", "_a", "__read", "isEventTarget", "methodName", "handler", "isNodeStyleEventEmitter", "toCommonHandlerRegistry", "isJQueryStyleEventEmitter", "add", "remove", "isArrayLike", "mergeMap", "subTarget", "innerFrom", "Observable", "subscriber", "args", "_i", "fromEventPattern", "addHandler", "removeHandler", "resultSelector", "mapOneOrManyArgs", "Observable", "subscriber", "handler", "e", "_i", "retValue", "isFunction", "timer", "dueTime", "intervalOrScheduler", "scheduler", "async", "intervalDuration", "isScheduler", "Observable", "subscriber", "due", "isValidDate", "n", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "sources", "innerFrom", "mergeAll", "from", "EMPTY", "NEVER", "Observable", "noop", "isArray", "argsOrArgArray", "args", "filter", "predicate", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "zip", "args", "_i", "resultSelector", "popResultSelector", "sources", "argsOrArgArray", "Observable", "subscriber", "buffers", "completed", "sourceIndex", "innerFrom", "createOperatorSubscriber", "value", "buffer", "result", "__spreadArray", "__read", "i", "EMPTY", "audit", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "isComplete", "endDuration", "value", "cleanupDuration", "createOperatorSubscriber", "innerFrom", "auditTime", "duration", "scheduler", "asyncScheduler", "audit", "timer", "bufferCount", "bufferSize", "startBufferEvery", "operate", "source", "subscriber", "buffers", "count", "createOperatorSubscriber", "value", "toEmit", "buffers_1", "__values", "buffers_1_1", "buffer", "toEmit_1", "toEmit_1_1", "arrRemove", "buffers_2", "buffers_2_1", "catchError", "selector", "operate", "source", "subscriber", "innerSub", "syncUnsub", "handledResult", "createOperatorSubscriber", "err", "innerFrom", "scanInternals", "accumulator", "seed", "hasSeed", "emitOnNext", "emitBeforeComplete", "source", "subscriber", "hasState", "state", "index", "createOperatorSubscriber", "value", "i", "combineLatest", "args", "_i", "resultSelector", "popResultSelector", "pipe", "__spreadArray", "__read", "mapOneOrManyArgs", "operate", "source", "subscriber", "combineLatestInit", "argsOrArgArray", "combineLatestWith", "otherSources", "_i", "combineLatest", "__spreadArray", "__read", "debounce", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "emit", "value", "createOperatorSubscriber", "noop", "innerFrom", "debounceTime", "dueTime", "scheduler", "asyncScheduler", "operate", "source", "subscriber", "activeTask", "lastValue", "lastTime", "emit", "value", "emitWhenIdle", "targetTime", "now", "createOperatorSubscriber", "defaultIfEmpty", "defaultValue", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "take", "count", "EMPTY", "operate", "source", "subscriber", "seen", "createOperatorSubscriber", "value", "ignoreElements", "operate", "source", "subscriber", "createOperatorSubscriber", "noop", "mapTo", "value", "map", "delayWhen", "delayDurationSelector", "subscriptionDelay", "source", "concat", "take", "ignoreElements", "mergeMap", "value", "index", "innerFrom", "mapTo", "delay", "due", "scheduler", "asyncScheduler", "duration", "timer", "delayWhen", "distinctUntilChanged", "comparator", "keySelector", "identity", "defaultCompare", "operate", "source", "subscriber", "previousKey", "first", "createOperatorSubscriber", "value", "currentKey", "a", "b", "distinctUntilKeyChanged", "key", "compare", "distinctUntilChanged", "x", "y", "throwIfEmpty", "errorFactory", "defaultErrorFactory", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "EmptyError", "endWith", "values", "_i", "source", "concat", "of", "__spreadArray", "__read", "finalize", "callback", "operate", "source", "subscriber", "first", "predicate", "defaultValue", "hasDefaultValue", "source", "filter", "v", "identity", "take", "defaultIfEmpty", "throwIfEmpty", "EmptyError", "takeLast", "count", "EMPTY", "operate", "source", "subscriber", "buffer", "createOperatorSubscriber", "value", "buffer_1", "__values", "buffer_1_1", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "argsOrArgArray", "operate", "source", "subscriber", "mergeAll", "from", "__spreadArray", "__read", "mergeWith", "otherSources", "_i", "merge", "__spreadArray", "__read", "repeat", "countOrConfig", "count", "delay", "_a", "EMPTY", "operate", "source", "subscriber", "soFar", "sourceSub", "resubscribe", "notifier", "timer", "innerFrom", "notifierSubscriber_1", "createOperatorSubscriber", "subscribeToSource", "syncUnsub", "scan", "accumulator", "seed", "operate", "scanInternals", "share", "options", "_a", "connector", "Subject", "_b", "resetOnError", "_c", "resetOnComplete", "_d", "resetOnRefCountZero", "wrapperSource", "connection", "resetConnection", "subject", "refCount", "hasCompleted", "hasErrored", "cancelReset", "reset", "resetAndUnsubscribe", "conn", "operate", "source", "subscriber", "dest", "handleReset", "SafeSubscriber", "value", "err", "innerFrom", "on", "args", "_i", "onSubscriber", "__spreadArray", "__read", "shareReplay", "configOrBufferSize", "windowTime", "scheduler", "bufferSize", "refCount", "_a", "_b", "_c", "share", "ReplaySubject", "skip", "count", "filter", "_", "index", "skipUntil", "notifier", "operate", "source", "subscriber", "taking", "skipSubscriber", "createOperatorSubscriber", "noop", "innerFrom", "value", "startWith", "values", "_i", "scheduler", "popScheduler", "operate", "source", "subscriber", "concat", "switchMap", "project", "resultSelector", "operate", "source", "subscriber", "innerSubscriber", "index", "isComplete", "checkComplete", "createOperatorSubscriber", "value", "innerIndex", "outerIndex", "innerFrom", "innerValue", "takeUntil", "notifier", "operate", "source", "subscriber", "innerFrom", "createOperatorSubscriber", "noop", "takeWhile", "predicate", "inclusive", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "result", "tap", "observerOrNext", "error", "complete", "tapObserver", "isFunction", "operate", "source", "subscriber", "_a", "isUnsub", "createOperatorSubscriber", "value", "err", "_b", "identity", "throttle", "durationSelector", "config", "operate", "source", "subscriber", "_a", "_b", "leading", "_c", "trailing", "hasValue", "sendValue", "throttled", "isComplete", "endThrottling", "send", "cleanupThrottling", "startThrottle", "value", "innerFrom", "createOperatorSubscriber", "throttleTime", "duration", "scheduler", "config", "asyncScheduler", "duration$", "timer", "throttle", "withLatestFrom", "inputs", "_i", "project", "popResultSelector", "operate", "source", "subscriber", "len", "otherValues", "hasValue", "ready", "i", "innerFrom", "createOperatorSubscriber", "value", "identity", "noop", "values", "__spreadArray", "__read", "zip", "sources", "_i", "operate", "source", "subscriber", "__spreadArray", "__read", "zipWith", "otherInputs", "_i", "zip", "__spreadArray", "__read", "watchDocument", "document$", "ReplaySubject", "fromEvent", "getElements", "selector", "node", "getElement", "el", "getOptionalElement", "getActiveElement", "_a", "_b", "_c", "_d", "observer$", "merge", "fromEvent", "debounceTime", "startWith", "map", "getActiveElement", "shareReplay", "watchElementFocus", "el", "active", "distinctUntilChanged", "watchElementHover", "el", "timeout", "defer", "merge", "fromEvent", "map", "debounce", "active", "timer", "identity", "startWith", "appendChild", "el", "child", "node", "h", "tag", "attributes", "children", "attr", "round", "value", "digits", "watchScript", "src", "script", "h", "defer", "merge", "fromEvent", "switchMap", "throwError", "map", "finalize", "take", "entry$", "Subject", "observer$", "defer", "watchScript", "of", "map", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "getElementSize", "el", "watchElementSize", "target", "tap", "filter", "startWith", "getElementContentSize", "el", "getElementContainer", "parent", "getElementContainers", "containers", "getElementOffset", "el", "getElementOffsetAbsolute", "rect", "watchElementOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "getElementContentOffset", "el", "watchElementContentOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "entry$", "Subject", "observer$", "defer", "of", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "watchElementVisibility", "el", "tap", "filter", "target", "map", "isIntersecting", "watchElementBoundary", "threshold", "watchElementContentOffset", "y", "visible", "getElementSize", "content", "getElementContentSize", "distinctUntilChanged", "toggles", "getElement", "getToggle", "name", "setToggle", "value", "watchToggle", "el", "fromEvent", "map", "startWith", "isSusceptibleToKeyboard", "el", "type", "watchComposition", "merge", "fromEvent", "map", "startWith", "watchKeyboard", "keyboard$", "filter", "ev", "getToggle", "mode", "active", "getActiveElement", "share", "switchMap", "EMPTY", "getLocation", "setLocation", "url", "navigate", "feature", "el", "h", "watchLocation", "Subject", "getLocationHash", "setLocationHash", "hash", "el", "h", "ev", "watchLocationHash", "location$", "merge", "fromEvent", "map", "startWith", "filter", "shareReplay", "watchLocationTarget", "id", "getOptionalElement", "watchMedia", "query", "media", "fromEventPattern", "next", "startWith", "watchPrint", "merge", "fromEvent", "map", "at", "query$", "factory", "switchMap", "active", "EMPTY", "request", "url", "options", "Observable", "observer", "req", "event", "_a", "length", "requestJSON", "switchMap", "res", "map", "body", "shareReplay", "requestHTML", "dom", "requestXML", "getViewportOffset", "watchViewportOffset", "merge", "fromEvent", "map", "startWith", "getViewportSize", "watchViewportSize", "fromEvent", "map", "startWith", "watchViewport", "combineLatest", "watchViewportOffset", "watchViewportSize", "map", "offset", "size", "shareReplay", "watchViewportAt", "el", "viewport$", "header$", "size$", "distinctUntilKeyChanged", "offset$", "combineLatest", "map", "getElementOffset", "height", "offset", "size", "x", "y", "recv", "worker", "fromEvent", "ev", "send", "send$", "Subject", "data", "watchWorker", "url", "recv$", "worker$", "done$", "ignoreElements", "endWith", "mergeWith", "takeUntil", "share", "script", "getElement", "config", "getLocation", "configuration", "feature", "flag", "translation", "key", "value", "getComponentElement", "type", "node", "getElement", "getComponentElements", "getElements", "watchAnnounce", "el", "button", "getElement", "fromEvent", "map", "content", "mountAnnounce", "feature", "EMPTY", "defer", "push$", "Subject", "hash", "tap", "state", "finalize", "__spreadValues", "watchConsent", "el", "target$", "map", "target", "mountConsent", "options", "internal$", "Subject", "hidden", "tap", "state", "finalize", "__spreadValues", "renderTooltip", "id", "style", "h", "renderInlineTooltip2", "children", "renderAnnotation", "id", "prefix", "anchor", "h", "renderTooltip", "renderClipboardButton", "id", "h", "translation", "import_escape_html", "renderSearchDocument", "document", "flag", "parent", "teaser", "missing", "key", "list", "h", "escapeHTML", "config", "configuration", "url", "feature", "match", "highlight", "value", "tags", "tag", "type", "translation", "renderSearchResultItem", "result", "threshold", "docs", "doc", "article", "index", "best", "more", "children", "section", "renderSourceFacts", "facts", "h", "key", "value", "round", "renderTabbedControl", "type", "classes", "h", "renderTable", "table", "h", "renderVersion", "version", "_a", "config", "configuration", "url", "h", "renderVersionSelector", "versions", "active", "translation", "sequence", "watchTooltip2", "el", "active$", "combineLatest", "watchElementFocus", "watchElementHover", "map", "focus", "hover", "distinctUntilChanged", "offset$", "defer", "getElementContainers", "mergeMap", "watchElementContentOffset", "throttleTime", "combineLatestWith", "getElementOffsetAbsolute", "first", "active", "switchMap", "offset", "share", "mountTooltip2", "dependencies", "content$", "viewport$", "id", "push$", "Subject", "show$", "BehaviorSubject", "ignoreElements", "endWith", "node$", "debounce", "timer", "queueScheduler", "EMPTY", "tap", "node", "startWith", "states", "origin$", "filter", "withLatestFrom", "_", "size", "host", "x", "height", "getElementSize", "origin", "getElement", "observeOn", "animationFrameScheduler", "state", "finalize", "__spreadValues", "mountInlineTooltip2", "container", "Observable", "observer", "title", "renderInlineTooltip2", "watchAnnotation", "el", "container", "offset$", "defer", "combineLatest", "watchElementOffset", "watchElementContentOffset", "map", "x", "y", "scroll", "width", "height", "getElementSize", "watchElementFocus", "switchMap", "active", "offset", "take", "mountAnnotation", "target$", "tooltip", "index", "push$", "Subject", "done$", "ignoreElements", "endWith", "watchElementVisibility", "takeUntil", "visible", "merge", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "fromEvent", "ev", "withLatestFrom", "_a", "parent", "getActiveElement", "target", "delay", "tap", "state", "finalize", "__spreadValues", "findHosts", "container", "getElements", "findMarkers", "markers", "el", "nodes", "it", "node", "text", "match", "id", "force", "marker", "swap", "source", "target", "mountAnnotationList", "target$", "print$", "parent", "prefix", "annotations", "getOptionalElement", "renderAnnotation", "EMPTY", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "pairs", "annotation", "getElement", "takeUntil", "active", "inner", "child", "merge", "mountAnnotation", "finalize", "share", "findList", "el", "sibling", "mountAnnotationBlock", "options", "defer", "list", "mountAnnotationList", "EMPTY", "import_clipboard", "sequence", "findCandidateList", "el", "sibling", "watchCodeBlock", "watchElementSize", "map", "width", "getElementContentSize", "distinctUntilKeyChanged", "mountCodeBlock", "options", "hover", "factory$", "defer", "push$", "Subject", "done$", "takeLast", "scrollable", "content$", "ClipboardJS", "feature", "parent", "button", "renderClipboardButton", "mountInlineTooltip2", "container", "list", "annotations$", "mountAnnotationList", "takeUntil", "height", "distinctUntilChanged", "switchMap", "active", "EMPTY", "getElements", "tap", "state", "finalize", "__spreadValues", "mergeWith", "watchElementVisibility", "filter", "visible", "take", "watchDetails", "el", "target$", "print$", "open", "merge", "map", "target", "filter", "details", "active", "tap", "mountDetails", "options", "defer", "push$", "Subject", "action", "reveal", "state", "finalize", "__spreadValues", "mermaid_default", "mermaid$", "sequence", "fetchScripts", "watchScript", "of", "mountMermaid", "el", "tap", "mermaid_default", "map", "shareReplay", "__async", "id", "host", "h", "text", "svg", "fn", "shadow", "sentinel", "h", "mountDataTable", "el", "renderTable", "of", "watchContentTabs", "inputs", "initial", "input", "merge", "fromEvent", "map", "getElement", "startWith", "active", "mountContentTabs", "el", "viewport$", "target$", "container", "getElements", "prev", "renderTabbedControl", "next", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatest", "watchElementSize", "watchElementVisibility", "takeUntil", "auditTime", "animationFrameScheduler", "size", "offset", "getElementOffset", "width", "getElementSize", "content", "getElementContentOffset", "watchElementContentOffset", "getElementContentSize", "direction", "filter", "label", "h", "ev", "tap", "feature", "skip", "withLatestFrom", "tab", "y", "set", "tabs", "media", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "mountContent", "el", "viewport$", "target$", "print$", "merge", "getElements", "child", "mountAnnotationBlock", "mountCodeBlock", "mountMermaid", "mountDataTable", "mountDetails", "mountContentTabs", "feature", "mountInlineTooltip2", "watchDialog", "_el", "alert$", "switchMap", "message", "merge", "of", "delay", "map", "active", "mountDialog", "el", "options", "inner", "getElement", "defer", "push$", "Subject", "tap", "state", "finalize", "__spreadValues", "sequence", "watchTooltip", "el", "host", "width", "getElementSize", "container", "getElementContainer", "scroll$", "watchElementContentOffset", "of", "active$", "merge", "watchElementFocus", "watchElementHover", "distinctUntilChanged", "combineLatest", "map", "active", "scroll", "x", "y", "getElementOffset", "size", "table", "mountTooltip", "title", "EMPTY", "id", "tooltip", "renderTooltip", "typeset", "getElement", "defer", "push$", "Subject", "offset", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "tap", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "isHidden", "viewport$", "feature", "of", "direction$", "map", "y", "bufferCount", "a", "b", "distinctUntilKeyChanged", "hidden$", "combineLatest", "filter", "offset", "direction", "distinctUntilChanged", "search$", "watchToggle", "search", "switchMap", "active", "startWith", "watchHeader", "el", "options", "defer", "watchElementSize", "height", "hidden", "shareReplay", "mountHeader", "header$", "main$", "push$", "Subject", "done$", "ignoreElements", "endWith", "combineLatestWith", "tooltips", "from", "getElements", "mergeMap", "child", "mountTooltip", "takeUntil", "state", "__spreadValues", "mergeWith", "watchHeaderTitle", "el", "viewport$", "header$", "watchViewportAt", "map", "y", "height", "getElementSize", "distinctUntilKeyChanged", "mountHeaderTitle", "options", "defer", "push$", "Subject", "active", "heading", "getOptionalElement", "EMPTY", "tap", "state", "finalize", "__spreadValues", "watchMain", "el", "viewport$", "header$", "adjust$", "map", "height", "distinctUntilChanged", "border$", "switchMap", "watchElementSize", "distinctUntilKeyChanged", "combineLatest", "header", "top", "bottom", "y", "a", "b", "watchPalette", "inputs", "current", "input", "index", "of", "mergeMap", "fromEvent", "map", "startWith", "shareReplay", "mountPalette", "el", "getElements", "meta", "h", "scheme", "media$", "watchMedia", "defer", "push$", "Subject", "palette", "media", "key", "value", "label", "filter", "ev", "withLatestFrom", "_", "header", "getComponentElement", "style", "color", "observeOn", "asyncScheduler", "takeUntil", "skip", "repeat", "tap", "state", "finalize", "__spreadValues", "mountProgress", "el", "progress$", "defer", "push$", "Subject", "value", "tap", "finalize", "map", "import_clipboard", "extract", "el", "copy", "text", "setupClipboardJS", "alert$", "ClipboardJS", "Observable", "subscriber", "getElement", "ev", "tap", "map", "translation", "resolve", "url", "base", "extract", "document", "sitemap", "el", "getElements", "getElement", "links", "link", "href", "fetchSitemap", "requestXML", "map", "catchError", "of", "handle", "ev", "sitemap", "EMPTY", "el", "url", "of", "head", "document", "tags", "getElements", "resolve", "key", "value", "inject", "next", "selector", "feature", "source", "getOptionalElement", "target", "html", "name", "container", "getComponentElement", "concat", "switchMap", "script", "Observable", "observer", "ignoreElements", "endWith", "setupInstantNavigation", "location$", "viewport$", "progress$", "config", "configuration", "sitemap$", "fetchSitemap", "instant$", "fromEvent", "combineLatestWith", "share", "history$", "map", "getLocation", "withLatestFrom", "offset", "merge", "document$", "distinctUntilKeyChanged", "requestHTML", "catchError", "setLocation", "_", "distinctUntilChanged", "a", "b", "tap", "_a", "_b", "setLocationHash", "debounceTime", "import_escape_html", "setupSearchHighlighter", "config", "regex", "term", "separator", "highlight", "_", "data", "query", "match", "value", "escapeHTML", "isSearchReadyMessage", "message", "isSearchResultMessage", "setupSearchWorker", "url", "index$", "worker$", "watchWorker", "merge", "of", "watchToggle", "first", "active", "switchMap", "config", "docs", "feature", "selectedVersionCorrespondingURL", "params", "_a", "selectedVersionSitemap", "selectedVersionBaseURL", "currentLocation", "currentBaseURL", "current_path", "safeURLParse", "currentRelativePath", "stripPrefix", "sitemapCommonPrefix", "shortestCommonPrefix", "potentialSitemapURL", "result", "url", "base", "e", "s", "prefix", "commonPrefixLen", "s1", "s2", "max", "strs", "setupVersionSelector", "document$", "config", "configuration", "versions$", "requestJSON", "catchError", "EMPTY", "current$", "map", "versions", "current", "version", "aliases", "switchMap", "urls", "fromEvent", "filter", "ev", "withLatestFrom", "el", "url", "of", "selectedVersionBaseURL", "fetchSitemap", "sitemap", "_a", "selectedVersionCorrespondingURL", "getLocation", "setLocation", "combineLatest", "getElement", "renderVersionSelector", "outdated", "ignored", "main", "ignore", "warning", "getComponentElements", "watchSearchQuery", "el", "worker$", "searchParams", "getLocation", "setToggle", "watchToggle", "first", "active", "url", "focus$", "watchElementFocus", "value$", "merge", "isSearchReadyMessage", "fromEvent", "map", "distinctUntilChanged", "combineLatest", "value", "focus", "shareReplay", "mountSearchQuery", "push$", "Subject", "done$", "ignoreElements", "endWith", "_", "query", "distinctUntilKeyChanged", "takeUntil", "label", "getElement", "tap", "state", "finalize", "__spreadValues", "mountSearchResult", "el", "worker$", "query$", "push$", "Subject", "boundary$", "watchElementBoundary", "filter", "container", "meta", "getElement", "list", "watchToggle", "active", "withLatestFrom", "skipUntil", "first", "isSearchReadyMessage", "items", "value", "translation", "count", "round", "render$", "tap", "switchMap", "merge", "of", "bufferCount", "zipWith", "chunk", "map", "renderSearchResultItem", "share", "item", "mergeMap", "details", "getOptionalElement", "EMPTY", "fromEvent", "takeUntil", "isSearchResultMessage", "data", "state", "finalize", "__spreadValues", "watchSearchShare", "_el", "query$", "map", "value", "url", "getLocation", "mountSearchShare", "el", "options", "push$", "Subject", "done$", "ignoreElements", "endWith", "fromEvent", "takeUntil", "ev", "tap", "state", "finalize", "__spreadValues", "mountSearchSuggest", "el", "worker$", "keyboard$", "push$", "Subject", "query", "getComponentElement", "query$", "merge", "fromEvent", "observeOn", "asyncScheduler", "map", "distinctUntilChanged", "combineLatestWith", "suggest", "value", "words", "last", "filter", "mode", "key", "isSearchResultMessage", "data", "tap", "state", "finalize", "mountSearch", "el", "index$", "keyboard$", "config", "configuration", "worker$", "setupSearchWorker", "query", "getComponentElement", "result", "fromEvent", "filter", "target", "setToggle", "mode", "key", "active", "getActiveElement", "anchors", "anchor", "getElements", "article", "best", "a", "b", "els", "i", "query$", "mountSearchQuery", "merge", "mountSearchResult", "mergeWith", "getComponentElements", "child", "mountSearchShare", "mountSearchSuggest", "err", "NEVER", "mountSearchHiglight", "el", "index$", "location$", "combineLatest", "startWith", "getLocation", "filter", "url", "map", "index", "setupSearchHighlighter", "fn", "_a", "nodes", "it", "node", "original", "replaced", "text", "childNodes", "h", "watchSidebar", "el", "viewport$", "main$", "parent", "adjust", "combineLatest", "map", "offset", "height", "y", "distinctUntilChanged", "a", "b", "mountSidebar", "_a", "_b", "header$", "options", "__objRest", "inner", "getElement", "getElementOffset", "defer", "push$", "Subject", "done$", "ignoreElements", "endWith", "next$", "auditTime", "animationFrameScheduler", "withLatestFrom", "first", "item", "getElements", "container", "getElementSize", "from", "mergeMap", "label", "fromEvent", "observeOn", "asyncScheduler", "takeUntil", "input", "tap", "state", "finalize", "__spreadValues", "fetchSourceFactsFromGitHub", "user", "repo", "url", "zip", "requestJSON", "catchError", "EMPTY", "map", "release", "defaultIfEmpty", "info", "__spreadValues", "fetchSourceFactsFromGitLab", "base", "project", "url", "zip", "requestJSON", "catchError", "EMPTY", "map", "tag_name", "defaultIfEmpty", "star_count", "forks_count", "release", "info", "__spreadValues", "fetchSourceFacts", "url", "match", "user", "repo", "fetchSourceFactsFromGitHub", "base", "slug", "fetchSourceFactsFromGitLab", "EMPTY", "fetch$", "watchSource", "el", "defer", "cached", "of", "getComponentElements", "consent", "EMPTY", "fetchSourceFacts", "tap", "facts", "catchError", "filter", "map", "shareReplay", "mountSource", "inner", "getElement", "push$", "Subject", "renderSourceFacts", "state", "finalize", "__spreadValues", "watchTabs", "el", "viewport$", "header$", "watchElementSize", "switchMap", "watchViewportAt", "map", "y", "distinctUntilKeyChanged", "mountTabs", "options", "defer", "push$", "Subject", "hidden", "feature", "of", "tap", "state", "finalize", "__spreadValues", "watchTableOfContents", "el", "viewport$", "header$", "table", "anchors", "getElements", "anchor", "id", "target", "getOptionalElement", "adjust$", "distinctUntilKeyChanged", "map", "height", "main", "getComponentElement", "grid", "getElement", "share", "watchElementSize", "switchMap", "body", "defer", "path", "of", "index", "offset", "parent", "a", "b", "combineLatestWith", "adjust", "scan", "prev", "next", "y", "size", "last", "distinctUntilChanged", "startWith", "bufferCount", "mountTableOfContents", "main$", "target$", "push$", "Subject", "done$", "ignoreElements", "endWith", "feature", "smooth$", "merge", "debounceTime", "filter", "observeOn", "asyncScheduler", "withLatestFrom", "behavior", "container", "getElementContainer", "getElementSize", "takeUntil", "skip", "repeat", "url", "getLocation", "active", "hash", "tap", "state", "finalize", "__spreadValues", "watchBackToTop", "_el", "viewport$", "main$", "target$", "direction$", "map", "y", "bufferCount", "b", "distinctUntilChanged", "active$", "active", "combineLatest", "direction", "takeUntil", "skip", "endWith", "repeat", "hidden", "mountBackToTop", "el", "header$", "push$", "Subject", "done$", "ignoreElements", "distinctUntilKeyChanged", "height", "fromEvent", "ev", "tap", "state", "finalize", "__spreadValues", "patchEllipsis", "document$", "viewport$", "switchMap", "getElements", "mergeMap", "el", "watchElementVisibility", "takeUntil", "skip", "filter", "visible", "map", "take", "text", "host", "feature", "mountInlineTooltip2", "finalize", "EMPTY", "patchIndeterminate", "document$", "tablet$", "switchMap", "getElements", "tap", "el", "mergeMap", "fromEvent", "takeWhile", "map", "withLatestFrom", "tablet", "isAppleDevice", "patchScrollfix", "document$", "switchMap", "getElements", "tap", "el", "filter", "mergeMap", "fromEvent", "map", "top", "patchScrolllock", "viewport$", "tablet$", "combineLatest", "watchToggle", "map", "active", "tablet", "switchMap", "of", "delay", "withLatestFrom", "y", "value", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "fetchSearchIndex", "watchScript", "config", "map", "shareReplay", "requestJSON", "document$", "watchDocument", "location$", "watchLocation", "target$", "watchLocationTarget", "keyboard$", "watchKeyboard", "viewport$", "watchViewport", "tablet$", "watchMedia", "screen$", "print$", "watchPrint", "configuration", "index$", "NEVER", "alert$", "Subject", "setupClipboardJS", "progress$", "feature", "setupInstantNavigation", "_a", "setupVersionSelector", "merge", "delay", "setToggle", "filter", "mode", "key", "prev", "getOptionalElement", "setLocation", "next", "active", "getActiveElement", "patchEllipsis", "patchIndeterminate", "patchScrollfix", "patchScrolllock", "header$", "watchHeader", "getComponentElement", "main$", "switchMap", "el", "watchMain", "control$", "getComponentElements", "mountConsent", "mountDialog", "mountPalette", "mountProgress", "mountSearch", "mountSource", "content$", "defer", "mountAnnounce", "mountContent", "mountSearchHiglight", "EMPTY", "mountHeader", "mountHeaderTitle", "at", "mountSidebar", "mountTabs", "mountTableOfContents", "mountBackToTop", "component$", "mergeWith"]
+}
diff --git a/latest/assets/javascripts/lunr/min/lunr.ar.min.js b/latest/assets/javascripts/lunr/min/lunr.ar.min.js
new file mode 100644
index 000000000..9b06c26c1
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.ar.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ar=function(){this.pipeline.reset(),this.pipeline.add(e.ar.trimmer,e.ar.stopWordFilter,e.ar.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ar.stemmer))},e.ar.wordCharacters="ء-ٛٱـ",e.ar.trimmer=e.trimmerSupport.generateTrimmer(e.ar.wordCharacters),e.Pipeline.registerFunction(e.ar.trimmer,"trimmer-ar"),e.ar.stemmer=function(){var e=this;return e.result=!1,e.preRemoved=!1,e.sufRemoved=!1,e.pre={pre1:"ف ك ب و س ل ن ا ي ت",pre2:"ال لل",pre3:"بال وال فال تال كال ولل",pre4:"فبال كبال وبال وكال"},e.suf={suf1:"ه ك ت ن ا ي",suf2:"نك نه ها وك يا اه ون ين تن تم نا وا ان كم كن ني نن ما هم هن تك ته ات يه",suf3:"تين كهم نيه نهم ونه وها يهم ونا ونك وني وهم تكم تنا تها تني تهم كما كها ناه نكم هنا تان يها",suf4:"كموه ناها ونني ونهم تكما تموه تكاه كماه ناكم ناهم نيها وننا"},e.patterns=JSON.parse('{"pt43":[{"pt":[{"c":"ا","l":1}]},{"pt":[{"c":"ا,ت,ن,ي","l":0}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"و","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ي","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ا","l":2},{"c":"ل","l":3,"m":3}]},{"pt":[{"c":"م","l":0}]}],"pt53":[{"pt":[{"c":"ت","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":3},{"c":"ل","l":3,"m":4},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":3}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ن","l":4}]},{"pt":[{"c":"ت","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"م","l":0},{"c":"و","l":3}]},{"pt":[{"c":"ا","l":1},{"c":"و","l":3}]},{"pt":[{"c":"و","l":1},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"ا","l":2},{"c":"ن","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":1},{"c":"ا","l":3}]},{"pt":[{"c":"ي,ت,ا,ن","l":0},{"c":"ت","l":1}],"mPt":[{"c":"ف","l":0,"m":2},{"c":"ع","l":1,"m":3},{"c":"ا","l":2},{"c":"ل","l":3,"m":4}]},{"pt":[{"c":"ت,ي,ا,ن","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":2},{"c":"ي","l":3}]},{"pt":[{"c":"ا,ي,ت,ن","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ء","l":4}]}],"pt63":[{"pt":[{"c":"ا","l":0},{"c":"ت","l":2},{"c":"ا","l":4}]},{"pt":[{"c":"ا,ت,ن,ي","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"و","l":3}]},{"pt":[{"c":"م","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ي","l":1},{"c":"ي","l":3},{"c":"ا","l":4},{"c":"ء","l":5}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ا","l":4}]}],"pt54":[{"pt":[{"c":"ت","l":0}]},{"pt":[{"c":"ا,ي,ت,ن","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"م","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":2}]}],"pt64":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":1}]}],"pt73":[{"pt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ا","l":5}]}],"pt75":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":5}]}]}'),e.execArray=["cleanWord","removeDiacritics","cleanAlef","removeStopWords","normalizeHamzaAndAlef","removeStartWaw","removePre432","removeEndTaa","wordCheck"],e.stem=function(){var r=0;for(e.result=!1,e.preRemoved=!1,e.sufRemoved=!1;r<e.execArray.length&&1!=e.result;)e.result=e[e.execArray[r]](),r++},e.setCurrent=function(r){e.word=r},e.getCurrent=function(){return e.word},e.cleanWord=function(){var r=new RegExp("[^ء-ٛٱـ]");return e.word=e.word.replace(new RegExp("ـ","g"),""),!!r.test("")},e.removeDiacritics=function(){new RegExp("[ً-ٛ]");return e.word=e.word.replace(/[\u064b-\u065b]/gi,""),!1},e.cleanAlef=function(){var r=new RegExp("[آأإٱى]");return e.word=e.word.replace(r,"ا"),!1},e.removeStopWords=function(){if("، اض امين اه اها اي ا اب اجل اجمع اخ اخذ اصبح اضحى اقبل اقل اكثر الا ام اما امامك امامك امسى اما ان انا انت انتم انتما انتن انت انشا انى او اوشك اولئك اولئكم اولاء اولالك اوه اي ايا اين اينما اي ان اي اف اذ اذا اذا اذما اذن الى اليكم اليكما اليكن اليك اليك الا اما ان انما اي اياك اياكم اياكما اياكن ايانا اياه اياها اياهم اياهما اياهن اياي ايه ان ا ابتدا اثر اجل احد اخرى اخلولق اذا اربعة ارتد استحال اطار اعادة اعلنت اف اكثر اكد الالاء الالى الا الاخيرة الان الاول الاولى التى التي الثاني الثانية الذاتي الذى الذي الذين السابق الف اللائي اللاتي اللتان اللتيا اللتين اللذان اللذين اللواتي الماضي المقبل الوقت الى اليوم اما امام امس ان انبرى انقلب انه انها او اول اي ايار ايام ايضا ب بات باسم بان بخ برس بسبب بس بشكل بضع بطان بعد بعض بك بكم بكما بكن بل بلى بما بماذا بمن بن بنا به بها بي بيد بين بس بله بئس تان تانك تبدل تجاه تحول تلقاء تلك تلكم تلكما تم تينك تين ته تي ثلاثة ثم ثم ثمة ثم جعل جلل جميع جير حار حاشا حاليا حاي حتى حرى حسب حم حوالى حول حيث حيثما حين حي حبذا حتى حذار خلا خلال دون دونك ذا ذات ذاك ذانك ذان ذلك ذلكم ذلكما ذلكن ذو ذوا ذواتا ذواتي ذيت ذينك ذين ذه ذي راح رجع رويدك ريث رب زيارة سبحان سرعان سنة سنوات سوف سوى ساء ساءما شبه شخصا شرع شتان صار صباح صفر صه صه ضد ضمن طاق طالما طفق طق ظل عاد عام عاما عامة عدا عدة عدد عدم عسى عشر عشرة علق على عليك عليه عليها عل عن عند عندما عوض عين عدس عما غدا غير  ف فان فلان فو فى في فيم فيما فيه فيها قال قام قبل قد قط قلما قوة كانما كاين كاي كاين كاد كان كانت كذا كذلك كرب كل كلا كلاهما كلتا كلم كليكما كليهما كلما كلا كم كما كي كيت كيف كيفما كان كخ لئن لا لات لاسيما لدن لدى لعمر لقاء لك لكم لكما لكن لكنما لكي لكيلا للامم لم لما لما لن لنا له لها لو لوكالة لولا لوما لي لست لست لستم لستما لستن لست لسن لعل لكن ليت ليس ليسا ليستا ليست ليسوا لسنا ما ماانفك مابرح مادام ماذا مازال مافتئ مايو متى مثل مذ مساء مع معاذ مقابل مكانكم مكانكما مكانكن مكانك مليار مليون مما ممن من منذ منها مه مهما من من نحن نحو نعم نفس نفسه نهاية نخ نعما نعم ها هاؤم هاك هاهنا هب هذا هذه هكذا هل هلم هلا هم هما هن هنا هناك هنالك هو هي هيا هيت هيا هؤلاء هاتان هاتين هاته هاتي هج هذا هذان هذين هذه هذي هيهات و وا واحد واضاف واضافت واكد وان واها واوضح وراءك وفي وقال وقالت وقد وقف وكان وكانت ولا ولم ومن وهو وهي ويكان وي وشكان يكون يمكن يوم ايان".split(" ").indexOf(e.word)>=0)return!0},e.normalizeHamzaAndAlef=function(){return e.word=e.word.replace("ؤ","ء"),e.word=e.word.replace("ئ","ء"),e.word=e.word.replace(/([\u0627])\1+/gi,"ا"),!1},e.removeEndTaa=function(){return!(e.word.length>2)||(e.word=e.word.replace(/[\u0627]$/,""),e.word=e.word.replace("ة",""),!1)},e.removeStartWaw=function(){return e.word.length>3&&"و"==e.word[0]&&"و"==e.word[1]&&(e.word=e.word.slice(1)),!1},e.removePre432=function(){var r=e.word;if(e.word.length>=7){var t=new RegExp("^("+e.pre.pre4.split(" ").join("|")+")");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=6){var c=new RegExp("^("+e.pre.pre3.split(" ").join("|")+")");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=5){var l=new RegExp("^("+e.pre.pre2.split(" ").join("|")+")");e.word=e.word.replace(l,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.patternCheck=function(r){for(var t=0;t<r.length;t++){for(var c=!0,l=0;l<r[t].pt.length;l++){var n=r[t].pt[l].c.split(","),o=!1;if(n.forEach(function(c){e.word[r[t].pt[l].l]==c&&(o=!0)}),!o){c=!1;break}}if(1==c){if(r[t].mPt){for(var p=[],m=0;m<r[t].mPt.length;m++)null!=r[t].mPt[m].m?p[r[t].mPt[m].l]=e.word[r[t].mPt[m].m]:p[r[t].mPt[m].l]=r[t].mPt[m].c;e.word=p.join("")}e.result=!0;break}}},e.removePre1=function(){var r=e.word;if(0==e.preRemoved&&e.word.length>3){var t=new RegExp("^("+e.pre.pre1.split(" ").join("|")+")");e.word=e.word.replace(t,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.removeSuf1=function(){var r=e.word;if(0==e.sufRemoved&&e.word.length>3){var t=new RegExp("("+e.suf.suf1.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.removeSuf432=function(){var r=e.word;if(e.word.length>=6){var t=new RegExp("("+e.suf.suf4.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=5){var c=new RegExp("("+e.suf.suf3.split(" ").join("|")+")$");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=4){var l=new RegExp("("+e.suf.suf2.split(" ").join("|")+")$");e.word=e.word.replace(l,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.wordCheck=function(){for(var r=(e.word,[e.removeSuf432,e.removeSuf1,e.removePre1]),t=0,c=!1;e.word.length>=7&&!e.result&&t<r.length;)7!=e.word.length||c?(r[t](),t++,c=!1):(e.checkPattern73(),c=!0);var l=[e.checkPattern63,e.removeSuf432,e.removeSuf1,e.removePre1,e.checkPattern64];for(t=0;6==e.word.length&&!e.result&&t<l.length;)l[t](),t++;var n=[e.checkPattern53,e.removeSuf432,e.removeSuf1,e.removePre1,e.checkPattern54];for(t=0;5==e.word.length&&!e.result&&t<n.length;)n[t](),t++;var o=[e.checkPattern43,e.removeSuf1,e.removePre1,e.removeSuf432];for(t=0;4==e.word.length&&!e.result&&t<o.length;)o[t](),t++;return!0},e.checkPattern43=function(){e.patternCheck(e.patterns.pt43)},e.checkPattern53=function(){e.patternCheck(e.patterns.pt53)},e.checkPattern54=function(){e.patternCheck(e.patterns.pt54)},e.checkPattern63=function(){e.patternCheck(e.patterns.pt63)},e.checkPattern64=function(){e.patternCheck(e.patterns.pt64)},e.checkPattern73=function(){e.patternCheck(e.patterns.pt73)},function(r){return"function"==typeof r.update?r.update(function(r){return e.setCurrent(r),e.stem(),e.getCurrent()}):(e.setCurrent(r),e.stem(),e.getCurrent())}}(),e.Pipeline.registerFunction(e.ar.stemmer,"stemmer-ar"),e.ar.stopWordFilter=e.generateStopWordFilter("، اض امين اه اها اي ا اب اجل اجمع اخ اخذ اصبح اضحى اقبل اقل اكثر الا ام اما امامك امامك امسى اما ان انا انت انتم انتما انتن انت انشا انى او اوشك اولئك اولئكم اولاء اولالك اوه اي ايا اين اينما اي ان اي اف اذ اذا اذا اذما اذن الى اليكم اليكما اليكن اليك اليك الا اما ان انما اي اياك اياكم اياكما اياكن ايانا اياه اياها اياهم اياهما اياهن اياي ايه ان ا ابتدا اثر اجل احد اخرى اخلولق اذا اربعة ارتد استحال اطار اعادة اعلنت اف اكثر اكد الالاء الالى الا الاخيرة الان الاول الاولى التى التي الثاني الثانية الذاتي الذى الذي الذين السابق الف اللائي اللاتي اللتان اللتيا اللتين اللذان اللذين اللواتي الماضي المقبل الوقت الى اليوم اما امام امس ان انبرى انقلب انه انها او اول اي ايار ايام ايضا ب بات باسم بان بخ برس بسبب بس بشكل بضع بطان بعد بعض بك بكم بكما بكن بل بلى بما بماذا بمن بن بنا به بها بي بيد بين بس بله بئس تان تانك تبدل تجاه تحول تلقاء تلك تلكم تلكما تم تينك تين ته تي ثلاثة ثم ثم ثمة ثم جعل جلل جميع جير حار حاشا حاليا حاي حتى حرى حسب حم حوالى حول حيث حيثما حين حي حبذا حتى حذار خلا خلال دون دونك ذا ذات ذاك ذانك ذان ذلك ذلكم ذلكما ذلكن ذو ذوا ذواتا ذواتي ذيت ذينك ذين ذه ذي راح رجع رويدك ريث رب زيارة سبحان سرعان سنة سنوات سوف سوى ساء ساءما شبه شخصا شرع شتان صار صباح صفر صه صه ضد ضمن طاق طالما طفق طق ظل عاد عام عاما عامة عدا عدة عدد عدم عسى عشر عشرة علق على عليك عليه عليها عل عن عند عندما عوض عين عدس عما غدا غير  ف فان فلان فو فى في فيم فيما فيه فيها قال قام قبل قد قط قلما قوة كانما كاين كاي كاين كاد كان كانت كذا كذلك كرب كل كلا كلاهما كلتا كلم كليكما كليهما كلما كلا كم كما كي كيت كيف كيفما كان كخ لئن لا لات لاسيما لدن لدى لعمر لقاء لك لكم لكما لكن لكنما لكي لكيلا للامم لم لما لما لن لنا له لها لو لوكالة لولا لوما لي لست لست لستم لستما لستن لست لسن لعل لكن ليت ليس ليسا ليستا ليست ليسوا لسنا ما ماانفك مابرح مادام ماذا مازال مافتئ مايو متى مثل مذ مساء مع معاذ مقابل مكانكم مكانكما مكانكن مكانك مليار مليون مما ممن من منذ منها مه مهما من من نحن نحو نعم نفس نفسه نهاية نخ نعما نعم ها هاؤم هاك هاهنا هب هذا هذه هكذا هل هلم هلا هم هما هن هنا هناك هنالك هو هي هيا هيت هيا هؤلاء هاتان هاتين هاته هاتي هج هذا هذان هذين هذه هذي هيهات وا واحد واضاف واضافت واكد وان واها واوضح وراءك وفي وقال وقالت وقد وقف وكان وكانت ولا ولم ومن وهو وهي ويكان وي وشكان يكون يمكن يوم ايان".split(" ")),e.Pipeline.registerFunction(e.ar.stopWordFilter,"stopWordFilter-ar")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.da.min.js b/latest/assets/javascripts/lunr/min/lunr.da.min.js
new file mode 100644
index 000000000..b9d850986
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.da.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Danish` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.da=function(){this.pipeline.reset(),this.pipeline.add(e.da.trimmer,e.da.stopWordFilter,e.da.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.da.stemmer))},e.da.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.da.trimmer=e.trimmerSupport.generateTrimmer(e.da.wordCharacters),e.Pipeline.registerFunction(e.da.trimmer,"trimmer-da"),e.da.stemmer=function(){var r=e.stemmerSupport.Among,i=e.stemmerSupport.SnowballProgram,n=new function(){function e(){var e,r=f.cursor+3;if(d=f.limit,0<=r&&r<=f.limit){for(a=r;;){if(e=f.cursor,f.in_grouping(w,97,248)){f.cursor=e;break}if(f.cursor=e,e>=f.limit)return;f.cursor++}for(;!f.out_grouping(w,97,248);){if(f.cursor>=f.limit)return;f.cursor++}d=f.cursor,d<a&&(d=a)}}function n(){var e,r;if(f.cursor>=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(c,32),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del();break;case 2:f.in_grouping_b(p,97,229)&&f.slice_del()}}function t(){var e,r=f.limit-f.cursor;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.find_among_b(l,4)?(f.bra=f.cursor,f.limit_backward=e,f.cursor=f.limit-r,f.cursor>f.limit_backward&&(f.cursor--,f.bra=f.cursor,f.slice_del())):f.limit_backward=e)}function s(){var e,r,i,n=f.limit-f.cursor;if(f.ket=f.cursor,f.eq_s_b(2,"st")&&(f.bra=f.cursor,f.eq_s_b(2,"ig")&&f.slice_del()),f.cursor=f.limit-n,f.cursor>=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(m,5),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del(),i=f.limit-f.cursor,t(),f.cursor=f.limit-i;break;case 2:f.slice_from("løs")}}function o(){var e;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.out_grouping_b(w,97,248)?(f.bra=f.cursor,u=f.slice_to(u),f.limit_backward=e,f.eq_v_b(u)&&f.slice_del()):f.limit_backward=e)}var a,d,u,c=[new r("hed",-1,1),new r("ethed",0,1),new r("ered",-1,1),new r("e",-1,1),new r("erede",3,1),new r("ende",3,1),new r("erende",5,1),new r("ene",3,1),new r("erne",3,1),new r("ere",3,1),new r("en",-1,1),new r("heden",10,1),new r("eren",10,1),new r("er",-1,1),new r("heder",13,1),new r("erer",13,1),new r("s",-1,2),new r("heds",16,1),new r("es",16,1),new r("endes",18,1),new r("erendes",19,1),new r("enes",18,1),new r("ernes",18,1),new r("eres",18,1),new r("ens",16,1),new r("hedens",24,1),new r("erens",24,1),new r("ers",16,1),new r("ets",16,1),new r("erets",28,1),new r("et",-1,1),new r("eret",30,1)],l=[new r("gd",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("elig",1,1),new r("els",-1,1),new r("løst",-1,2)],w=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],p=[239,254,42,3,0,0,0,0,0,0,0,0,0,0,0,0,16],f=new i;this.setCurrent=function(e){f.setCurrent(e)},this.getCurrent=function(){return f.getCurrent()},this.stem=function(){var r=f.cursor;return e(),f.limit_backward=r,f.cursor=f.limit,n(),f.cursor=f.limit,t(),f.cursor=f.limit,s(),f.cursor=f.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.da.stemmer,"stemmer-da"),e.da.stopWordFilter=e.generateStopWordFilter("ad af alle alt anden at blev blive bliver da de dem den denne der deres det dette dig din disse dog du efter eller en end er et for fra ham han hans har havde have hende hendes her hos hun hvad hvis hvor i ikke ind jeg jer jo kunne man mange med meget men mig min mine mit mod ned noget nogle nu når og også om op os over på selv sig sin sine sit skal skulle som sådan thi til ud under var vi vil ville vor være været".split(" ")),e.Pipeline.registerFunction(e.da.stopWordFilter,"stopWordFilter-da")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.de.min.js b/latest/assets/javascripts/lunr/min/lunr.de.min.js
new file mode 100644
index 000000000..f3b5c108c
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.de.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `German` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.de=function(){this.pipeline.reset(),this.pipeline.add(e.de.trimmer,e.de.stopWordFilter,e.de.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.de.stemmer))},e.de.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.de.trimmer=e.trimmerSupport.generateTrimmer(e.de.wordCharacters),e.Pipeline.registerFunction(e.de.trimmer,"trimmer-de"),e.de.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!v.eq_s(1,e)||(v.ket=v.cursor,!v.in_grouping(p,97,252)))&&(v.slice_from(r),v.cursor=n,!0)}function i(){for(var r,n,i,s,t=v.cursor;;)if(r=v.cursor,v.bra=r,v.eq_s(1,"ß"))v.ket=v.cursor,v.slice_from("ss");else{if(r>=v.limit)break;v.cursor=r+1}for(v.cursor=t;;)for(n=v.cursor;;){if(i=v.cursor,v.in_grouping(p,97,252)){if(s=v.cursor,v.bra=s,e("u","U",i))break;if(v.cursor=s,e("y","Y",i))break}if(i>=v.limit)return void(v.cursor=n);v.cursor=i+1}}function s(){for(;!v.in_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}for(;!v.out_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}return!1}function t(){m=v.limit,l=m;var e=v.cursor+3;0<=e&&e<=v.limit&&(d=e,s()||(m=v.cursor,m<d&&(m=d),s()||(l=v.cursor)))}function o(){for(var e,r;;){if(r=v.cursor,v.bra=r,!(e=v.find_among(h,6)))return;switch(v.ket=v.cursor,e){case 1:v.slice_from("y");break;case 2:case 5:v.slice_from("u");break;case 3:v.slice_from("a");break;case 4:v.slice_from("o");break;case 6:if(v.cursor>=v.limit)return;v.cursor++}}}function c(){return m<=v.cursor}function u(){return l<=v.cursor}function a(){var e,r,n,i,s=v.limit-v.cursor;if(v.ket=v.cursor,(e=v.find_among_b(w,7))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:v.slice_del(),v.ket=v.cursor,v.eq_s_b(1,"s")&&(v.bra=v.cursor,v.eq_s_b(3,"nis")&&v.slice_del());break;case 3:v.in_grouping_b(g,98,116)&&v.slice_del()}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(f,4))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:if(v.in_grouping_b(k,98,116)){var t=v.cursor-3;v.limit_backward<=t&&t<=v.limit&&(v.cursor=t,v.slice_del())}}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(_,8))&&(v.bra=v.cursor,u()))switch(e){case 1:v.slice_del(),v.ket=v.cursor,v.eq_s_b(2,"ig")&&(v.bra=v.cursor,r=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-r,u()&&v.slice_del()));break;case 2:n=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-n,v.slice_del());break;case 3:if(v.slice_del(),v.ket=v.cursor,i=v.limit-v.cursor,!v.eq_s_b(2,"er")&&(v.cursor=v.limit-i,!v.eq_s_b(2,"en")))break;v.bra=v.cursor,c()&&v.slice_del();break;case 4:v.slice_del(),v.ket=v.cursor,e=v.find_among_b(b,2),e&&(v.bra=v.cursor,u()&&1==e&&v.slice_del())}}var d,l,m,h=[new r("",-1,6),new r("U",0,2),new r("Y",0,1),new r("ä",0,3),new r("ö",0,4),new r("ü",0,5)],w=[new r("e",-1,2),new r("em",-1,1),new r("en",-1,2),new r("ern",-1,1),new r("er",-1,1),new r("s",-1,3),new r("es",5,2)],f=[new r("en",-1,1),new r("er",-1,1),new r("st",-1,2),new r("est",2,1)],b=[new r("ig",-1,1),new r("lich",-1,1)],_=[new r("end",-1,1),new r("ig",-1,2),new r("ung",-1,1),new r("lich",-1,3),new r("isch",-1,2),new r("ik",-1,2),new r("heit",-1,3),new r("keit",-1,4)],p=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32,8],g=[117,30,5],k=[117,30,4],v=new n;this.setCurrent=function(e){v.setCurrent(e)},this.getCurrent=function(){return v.getCurrent()},this.stem=function(){var e=v.cursor;return i(),v.cursor=e,t(),v.limit_backward=e,v.cursor=v.limit,a(),v.cursor=v.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.de.stemmer,"stemmer-de"),e.de.stopWordFilter=e.generateStopWordFilter("aber alle allem allen aller alles als also am an ander andere anderem anderen anderer anderes anderm andern anderr anders auch auf aus bei bin bis bist da damit dann das dasselbe dazu daß dein deine deinem deinen deiner deines dem demselben den denn denselben der derer derselbe derselben des desselben dessen dich die dies diese dieselbe dieselben diesem diesen dieser dieses dir doch dort du durch ein eine einem einen einer eines einig einige einigem einigen einiger einiges einmal er es etwas euch euer eure eurem euren eurer eures für gegen gewesen hab habe haben hat hatte hatten hier hin hinter ich ihm ihn ihnen ihr ihre ihrem ihren ihrer ihres im in indem ins ist jede jedem jeden jeder jedes jene jenem jenen jener jenes jetzt kann kein keine keinem keinen keiner keines können könnte machen man manche manchem manchen mancher manches mein meine meinem meinen meiner meines mich mir mit muss musste nach nicht nichts noch nun nur ob oder ohne sehr sein seine seinem seinen seiner seines selbst sich sie sind so solche solchem solchen solcher solches soll sollte sondern sonst um und uns unse unsem unsen unser unses unter viel vom von vor war waren warst was weg weil weiter welche welchem welchen welcher welches wenn werde werden wie wieder will wir wird wirst wo wollen wollte während würde würden zu zum zur zwar zwischen über".split(" ")),e.Pipeline.registerFunction(e.de.stopWordFilter,"stopWordFilter-de")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.du.min.js b/latest/assets/javascripts/lunr/min/lunr.du.min.js
new file mode 100644
index 000000000..49a0f3f0a
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.du.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Dutch` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");console.warn('[Lunr Languages] Please use the "nl" instead of the "du". The "nl" code is the standard code for Dutch language, and "du" will be removed in the next major versions.'),e.du=function(){this.pipeline.reset(),this.pipeline.add(e.du.trimmer,e.du.stopWordFilter,e.du.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.du.stemmer))},e.du.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.du.trimmer=e.trimmerSupport.generateTrimmer(e.du.wordCharacters),e.Pipeline.registerFunction(e.du.trimmer,"trimmer-du"),e.du.stemmer=function(){var r=e.stemmerSupport.Among,i=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e,r,i,o=C.cursor;;){if(C.bra=C.cursor,e=C.find_among(b,11))switch(C.ket=C.cursor,e){case 1:C.slice_from("a");continue;case 2:C.slice_from("e");continue;case 3:C.slice_from("i");continue;case 4:C.slice_from("o");continue;case 5:C.slice_from("u");continue;case 6:if(C.cursor>=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(r=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=r);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=r;else if(n(r))break}else if(n(r))break}function n(e){return C.cursor=e,e>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,f=_,t()||(_=C.cursor,_<3&&(_=3),t()||(f=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var e;;)if(C.bra=C.cursor,e=C.find_among(p,3))switch(C.ket=C.cursor,e){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return f<=C.cursor}function a(){var e=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-e,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var e;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.slice_del(),w=!0,a())))}function m(){var e;u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.eq_s_b(3,"gem")||(C.cursor=C.limit-e,C.slice_del(),a())))}function d(){var e,r,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,e=C.find_among_b(h,5))switch(C.bra=C.cursor,e){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(z,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(r=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-r,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,e=C.find_among_b(k,6))switch(C.bra=C.cursor,e){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(j,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var f,_,w,b=[new r("",-1,6),new r("á",0,1),new r("ä",0,1),new r("é",0,2),new r("ë",0,2),new r("í",0,3),new r("ï",0,3),new r("ó",0,4),new r("ö",0,4),new r("ú",0,5),new r("ü",0,5)],p=[new r("",-1,3),new r("I",0,2),new r("Y",0,1)],g=[new r("dd",-1,-1),new r("kk",-1,-1),new r("tt",-1,-1)],h=[new r("ene",-1,2),new r("se",-1,3),new r("en",-1,2),new r("heden",2,1),new r("s",-1,3)],k=[new r("end",-1,1),new r("ig",-1,2),new r("ing",-1,1),new r("lijk",-1,3),new r("baar",-1,4),new r("bar",-1,5)],v=[new r("aa",-1,-1),new r("ee",-1,-1),new r("oo",-1,-1),new r("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(e){C.setCurrent(e)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var r=C.cursor;return e(),C.cursor=r,o(),C.limit_backward=r,C.cursor=C.limit,d(),C.cursor=C.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.du.stemmer,"stemmer-du"),e.du.stopWordFilter=e.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),e.Pipeline.registerFunction(e.du.stopWordFilter,"stopWordFilter-du")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.el.min.js b/latest/assets/javascripts/lunr/min/lunr.el.min.js
new file mode 100644
index 000000000..ace017bd6
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.el.min.js
@@ -0,0 +1 @@
+!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.el=function(){this.pipeline.reset(),void 0===this.searchPipeline&&this.pipeline.add(e.el.trimmer,e.el.normilizer),this.pipeline.add(e.el.stopWordFilter,e.el.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.el.stemmer))},e.el.wordCharacters="A-Za-zΑαΒβΓγΔδΕεΖζΗηΘθΙιΚκΛλΜμΝνΞξΟοΠπΡρΣσςΤτΥυΦφΧχΨψΩωΆάΈέΉήΊίΌόΎύΏώΪΐΫΰΐΰ",e.el.trimmer=e.trimmerSupport.generateTrimmer(e.el.wordCharacters),e.Pipeline.registerFunction(e.el.trimmer,"trimmer-el"),e.el.stemmer=function(){function e(e){return s.test(e)}function t(e){return/[ΑΕΗΙΟΥΩ]$/.test(e)}function r(e){return/[ΑΕΗΙΟΩ]$/.test(e)}function n(n){var s=n;if(n.length<3)return s;if(!e(n))return s;if(i.indexOf(n)>=0)return s;var u=new RegExp("(.*)("+Object.keys(l).join("|")+")$"),o=u.exec(s);return null!==o&&(s=o[1]+l[o[2]]),null!==(o=/^(.+?)(ΑΔΕΣ|ΑΔΩΝ)$/.exec(s))&&(s=o[1],/(ΟΚ|ΜΑΜ|ΜΑΝ|ΜΠΑΜΠ|ΠΑΤΕΡ|ΓΙΑΓΙ|ΝΤΑΝΤ|ΚΥΡ|ΘΕΙ|ΠΕΘΕΡ|ΜΟΥΣΑΜ|ΚΑΠΛΑΜ|ΠΑΡ|ΨΑΡ|ΤΖΟΥΡ|ΤΑΜΠΟΥΡ|ΓΑΛΑΤ|ΦΑΦΛΑΤ)$/.test(o[1])||(s+="ΑΔ")),null!==(o=/^(.+?)(ΕΔΕΣ|ΕΔΩΝ)$/.exec(s))&&(s=o[1],/(ΟΠ|ΙΠ|ΕΜΠ|ΥΠ|ΓΗΠ|ΔΑΠ|ΚΡΑΣΠ|ΜΙΛ)$/.test(o[1])&&(s+="ΕΔ")),null!==(o=/^(.+?)(ΟΥΔΕΣ|ΟΥΔΩΝ)$/.exec(s))&&(s=o[1],/(ΑΡΚ|ΚΑΛΙΑΚ|ΠΕΤΑΛ|ΛΙΧ|ΠΛΕΞ|ΣΚ|Σ|ΦΛ|ΦΡ|ΒΕΛ|ΛΟΥΛ|ΧΝ|ΣΠ|ΤΡΑΓ|ΦΕ)$/.test(o[1])&&(s+="ΟΥΔ")),null!==(o=/^(.+?)(ΕΩΣ|ΕΩΝ|ΕΑΣ|ΕΑ)$/.exec(s))&&(s=o[1],/^(Θ|Δ|ΕΛ|ΓΑΛ|Ν|Π|ΙΔ|ΠΑΡ|ΣΤΕΡ|ΟΡΦ|ΑΝΔΡ|ΑΝΤΡ)$/.test(o[1])&&(s+="Ε")),null!==(o=/^(.+?)(ΕΙΟ|ΕΙΟΣ|ΕΙΟΙ|ΕΙΑ|ΕΙΑΣ|ΕΙΕΣ|ΕΙΟΥ|ΕΙΟΥΣ|ΕΙΩΝ)$/.exec(s))&&o[1].length>4&&(s=o[1]),null!==(o=/^(.+?)(ΙΟΥΣ|ΙΑΣ|ΙΕΣ|ΙΟΣ|ΙΟΥ|ΙΟΙ|ΙΩΝ|ΙΟΝ|ΙΑ|ΙΟ)$/.exec(s))&&(s=o[1],(t(s)||s.length<2||/^(ΑΓ|ΑΓΓΕΛ|ΑΓΡ|ΑΕΡ|ΑΘΛ|ΑΚΟΥΣ|ΑΞ|ΑΣ|Β|ΒΙΒΛ|ΒΥΤ|Γ|ΓΙΑΓ|ΓΩΝ|Δ|ΔΑΝ|ΔΗΛ|ΔΗΜ|ΔΟΚΙΜ|ΕΛ|ΖΑΧΑΡ|ΗΛ|ΗΠ|ΙΔ|ΙΣΚ|ΙΣΤ|ΙΟΝ|ΙΩΝ|ΚΙΜΩΛ|ΚΟΛΟΝ|ΚΟΡ|ΚΤΗΡ|ΚΥΡ|ΛΑΓ|ΛΟΓ|ΜΑΓ|ΜΠΑΝ|ΜΠΡ|ΝΑΥΤ|ΝΟΤ|ΟΠΑΛ|ΟΞ|ΟΡ|ΟΣ|ΠΑΝΑΓ|ΠΑΤΡ|ΠΗΛ|ΠΗΝ|ΠΛΑΙΣ|ΠΟΝΤ|ΡΑΔ|ΡΟΔ|ΣΚ|ΣΚΟΡΠ|ΣΟΥΝ|ΣΠΑΝ|ΣΤΑΔ|ΣΥΡ|ΤΗΛ|ΤΙΜ|ΤΟΚ|ΤΟΠ|ΤΡΟΧ|ΦΙΛ|ΦΩΤ|Χ|ΧΙΛ|ΧΡΩΜ|ΧΩΡ)$/.test(o[1]))&&(s+="Ι"),/^(ΠΑΛ)$/.test(o[1])&&(s+="ΑΙ")),null!==(o=/^(.+?)(ΙΚΟΣ|ΙΚΟΝ|ΙΚΕΙΣ|ΙΚΟΙ|ΙΚΕΣ|ΙΚΟΥΣ|ΙΚΗ|ΙΚΗΣ|ΙΚΟ|ΙΚΑ|ΙΚΟΥ|ΙΚΩΝ|ΙΚΩΣ)$/.exec(s))&&(s=o[1],(t(s)||/^(ΑΔ|ΑΛ|ΑΜΑΝ|ΑΜΕΡ|ΑΜΜΟΧΑΛ|ΑΝΗΘ|ΑΝΤΙΔ|ΑΠΛ|ΑΤΤ|ΑΦΡ|ΒΑΣ|ΒΡΩΜ|ΓΕΝ|ΓΕΡ|Δ|ΔΙΚΑΝ|ΔΥΤ|ΕΙΔ|ΕΝΔ|ΕΞΩΔ|ΗΘ|ΘΕΤ|ΚΑΛΛΙΝ|ΚΑΛΠ|ΚΑΤΑΔ|ΚΟΥΖΙΝ|ΚΡ|ΚΩΔ|ΛΟΓ|Μ|ΜΕΡ|ΜΟΝΑΔ|ΜΟΥΛ|ΜΟΥΣ|ΜΠΑΓΙΑΤ|ΜΠΑΝ|ΜΠΟΛ|ΜΠΟΣ|ΜΥΣΤ|Ν|ΝΙΤ|ΞΙΚ|ΟΠΤ|ΠΑΝ|ΠΕΤΣ|ΠΙΚΑΝΤ|ΠΙΤΣ|ΠΛΑΣΤ|ΠΛΙΑΤΣ|ΠΟΝΤ|ΠΟΣΤΕΛΝ|ΠΡΩΤΟΔ|ΣΕΡΤ|ΣΗΜΑΝΤ|ΣΤΑΤ|ΣΥΝΑΔ|ΣΥΝΟΜΗΛ|ΤΕΛ|ΤΕΧΝ|ΤΡΟΠ|ΤΣΑΜ|ΥΠΟΔ|Φ|ΦΙΛΟΝ|ΦΥΛΟΔ|ΦΥΣ|ΧΑΣ)$/.test(o[1])||/(ΦΟΙΝ)$/.test(o[1]))&&(s+="ΙΚ")),"ΑΓΑΜΕ"===s&&(s="ΑΓΑΜ"),null!==(o=/^(.+?)(ΑΓΑΜΕ|ΗΣΑΜΕ|ΟΥΣΑΜΕ|ΗΚΑΜΕ|ΗΘΗΚΑΜΕ)$/.exec(s))&&(s=o[1]),null!==(o=/^(.+?)(ΑΜΕ)$/.exec(s))&&(s=o[1],/^(ΑΝΑΠ|ΑΠΟΘ|ΑΠΟΚ|ΑΠΟΣΤ|ΒΟΥΒ|ΞΕΘ|ΟΥΛ|ΠΕΘ|ΠΙΚΡ|ΠΟΤ|ΣΙΧ|Χ)$/.test(o[1])&&(s+="ΑΜ")),null!==(o=/^(.+?)(ΑΓΑΝΕ|ΗΣΑΝΕ|ΟΥΣΑΝΕ|ΙΟΝΤΑΝΕ|ΙΟΤΑΝΕ|ΙΟΥΝΤΑΝΕ|ΟΝΤΑΝΕ|ΟΤΑΝΕ|ΟΥΝΤΑΝΕ|ΗΚΑΝΕ|ΗΘΗΚΑΝΕ)$/.exec(s))&&(s=o[1],/^(ΤΡ|ΤΣ)$/.test(o[1])&&(s+="ΑΓΑΝ")),null!==(o=/^(.+?)(ΑΝΕ)$/.exec(s))&&(s=o[1],(r(s)||/^(ΒΕΤΕΡ|ΒΟΥΛΚ|ΒΡΑΧΜ|Γ|ΔΡΑΔΟΥΜ|Θ|ΚΑΛΠΟΥΖ|ΚΑΣΤΕΛ|ΚΟΡΜΟΡ|ΛΑΟΠΛ|ΜΩΑΜΕΘ|Μ|ΜΟΥΣΟΥΛΜΑΝ|ΟΥΛ|Π|ΠΕΛΕΚ|ΠΛ|ΠΟΛΙΣ|ΠΟΡΤΟΛ|ΣΑΡΑΚΑΤΣ|ΣΟΥΛΤ|ΤΣΑΡΛΑΤ|ΟΡΦ|ΤΣΙΓΓ|ΤΣΟΠ|ΦΩΤΟΣΤΕΦ|Χ|ΨΥΧΟΠΛ|ΑΓ|ΟΡΦ|ΓΑΛ|ΓΕΡ|ΔΕΚ|ΔΙΠΛ|ΑΜΕΡΙΚΑΝ|ΟΥΡ|ΠΙΘ|ΠΟΥΡΙΤ|Σ|ΖΩΝΤ|ΙΚ|ΚΑΣΤ|ΚΟΠ|ΛΙΧ|ΛΟΥΘΗΡ|ΜΑΙΝΤ|ΜΕΛ|ΣΙΓ|ΣΠ|ΣΤΕΓ|ΤΡΑΓ|ΤΣΑΓ|Φ|ΕΡ|ΑΔΑΠ|ΑΘΙΓΓ|ΑΜΗΧ|ΑΝΙΚ|ΑΝΟΡΓ|ΑΠΗΓ|ΑΠΙΘ|ΑΤΣΙΓΓ|ΒΑΣ|ΒΑΣΚ|ΒΑΘΥΓΑΛ|ΒΙΟΜΗΧ|ΒΡΑΧΥΚ|ΔΙΑΤ|ΔΙΑΦ|ΕΝΟΡΓ|ΘΥΣ|ΚΑΠΝΟΒΙΟΜΗΧ|ΚΑΤΑΓΑΛ|ΚΛΙΒ|ΚΟΙΛΑΡΦ|ΛΙΒ|ΜΕΓΛΟΒΙΟΜΗΧ|ΜΙΚΡΟΒΙΟΜΗΧ|ΝΤΑΒ|ΞΗΡΟΚΛΙΒ|ΟΛΙΓΟΔΑΜ|ΟΛΟΓΑΛ|ΠΕΝΤΑΡΦ|ΠΕΡΗΦ|ΠΕΡΙΤΡ|ΠΛΑΤ|ΠΟΛΥΔΑΠ|ΠΟΛΥΜΗΧ|ΣΤΕΦ|ΤΑΒ|ΤΕΤ|ΥΠΕΡΗΦ|ΥΠΟΚΟΠ|ΧΑΜΗΛΟΔΑΠ|ΨΗΛΟΤΑΒ)$/.test(o[1]))&&(s+="ΑΝ")),null!==(o=/^(.+?)(ΗΣΕΤΕ)$/.exec(s))&&(s=o[1]),null!==(o=/^(.+?)(ΕΤΕ)$/.exec(s))&&(s=o[1],(r(s)||/(ΟΔ|ΑΙΡ|ΦΟΡ|ΤΑΘ|ΔΙΑΘ|ΣΧ|ΕΝΔ|ΕΥΡ|ΤΙΘ|ΥΠΕΡΘ|ΡΑΘ|ΕΝΘ|ΡΟΘ|ΣΘ|ΠΥΡ|ΑΙΝ|ΣΥΝΔ|ΣΥΝ|ΣΥΝΘ|ΧΩΡ|ΠΟΝ|ΒΡ|ΚΑΘ|ΕΥΘ|ΕΚΘ|ΝΕΤ|ΡΟΝ|ΑΡΚ|ΒΑΡ|ΒΟΛ|ΩΦΕΛ)$/.test(o[1])||/^(ΑΒΑΡ|ΒΕΝ|ΕΝΑΡ|ΑΒΡ|ΑΔ|ΑΘ|ΑΝ|ΑΠΛ|ΒΑΡΟΝ|ΝΤΡ|ΣΚ|ΚΟΠ|ΜΠΟΡ|ΝΙΦ|ΠΑΓ|ΠΑΡΑΚΑΛ|ΣΕΡΠ|ΣΚΕΛ|ΣΥΡΦ|ΤΟΚ|Υ|Δ|ΕΜ|ΘΑΡΡ|Θ)$/.test(o[1]))&&(s+="ΕΤ")),null!==(o=/^(.+?)(ΟΝΤΑΣ|ΩΝΤΑΣ)$/.exec(s))&&(s=o[1],/^ΑΡΧ$/.test(o[1])&&(s+="ΟΝΤ"),/ΚΡΕ$/.test(o[1])&&(s+="ΩΝΤ")),null!==(o=/^(.+?)(ΟΜΑΣΤΕ|ΙΟΜΑΣΤΕ)$/.exec(s))&&(s=o[1],/^ΟΝ$/.test(o[1])&&(s+="ΟΜΑΣΤ")),null!==(o=/^(.+?)(ΙΕΣΤΕ)$/.exec(s))&&(s=o[1],/^(Π|ΑΠ|ΣΥΜΠ|ΑΣΥΜΠ|ΑΚΑΤΑΠ|ΑΜΕΤΑΜΦ)$/.test(o[1])&&(s+="ΙΕΣΤ")),null!==(o=/^(.+?)(ΕΣΤΕ)$/.exec(s))&&(s=o[1],/^(ΑΛ|ΑΡ|ΕΚΤΕΛ|Ζ|Μ|Ξ|ΠΑΡΑΚΑΛ|ΠΡΟ|ΝΙΣ)$/.test(o[1])&&(s+="ΕΣΤ")),null!==(o=/^(.+?)(ΗΘΗΚΑ|ΗΘΗΚΕΣ|ΗΘΗΚΕ)$/.exec(s))&&(s=o[1]),null!==(o=/^(.+?)(ΗΚΑ|ΗΚΕΣ|ΗΚΕ)$/.exec(s))&&(s=o[1],(/(ΣΚΩΛ|ΣΚΟΥΛ|ΝΑΡΘ|ΣΦ|ΟΘ|ΠΙΘ)$/.test(o[1])||/^(ΔΙΑΘ|Θ|ΠΑΡΑΚΑΤΑΘ|ΠΡΟΣΘ|ΣΥΝΘ)$/.test(o[1]))&&(s+="ΗΚ")),null!==(o=/^(.+?)(ΟΥΣΑ|ΟΥΣΕΣ|ΟΥΣΕ)$/.exec(s))&&(s=o[1],(t(s)||/^(ΦΑΡΜΑΚ|ΧΑΔ|ΑΓΚ|ΑΝΑΡΡ|ΒΡΟΜ|ΕΚΛΙΠ|ΛΑΜΠΙΔ|ΛΕΧ|Μ|ΠΑΤ|Ρ|Λ|ΜΕΔ|ΜΕΣΑΖ|ΥΠΟΤΕΙΝ|ΑΜ|ΑΙΘ|ΑΝΗΚ|ΔΕΣΠΟΖ|ΕΝΔΙΑΦΕΡ)$/.test(o[1])||/(ΠΟΔΑΡ|ΒΛΕΠ|ΠΑΝΤΑΧ|ΦΡΥΔ|ΜΑΝΤΙΛ|ΜΑΛΛ|ΚΥΜΑΤ|ΛΑΧ|ΛΗΓ|ΦΑΓ|ΟΜ|ΠΡΩΤ)$/.test(o[1]))&&(s+="ΟΥΣ")),null!==(o=/^(.+?)(ΑΓΑ|ΑΓΕΣ|ΑΓΕ)$/.exec(s))&&(s=o[1],(/^(ΑΒΑΣΤ|ΠΟΛΥΦ|ΑΔΗΦ|ΠΑΜΦ|Ρ|ΑΣΠ|ΑΦ|ΑΜΑΛ|ΑΜΑΛΛΙ|ΑΝΥΣΤ|ΑΠΕΡ|ΑΣΠΑΡ|ΑΧΑΡ|ΔΕΡΒΕΝ|ΔΡΟΣΟΠ|ΞΕΦ|ΝΕΟΠ|ΝΟΜΟΤ|ΟΛΟΠ|ΟΜΟΤ|ΠΡΟΣΤ|ΠΡΟΣΩΠΟΠ|ΣΥΜΠ|ΣΥΝΤ|Τ|ΥΠΟΤ|ΧΑΡ|ΑΕΙΠ|ΑΙΜΟΣΤ|ΑΝΥΠ|ΑΠΟΤ|ΑΡΤΙΠ|ΔΙΑΤ|ΕΝ|ΕΠΙΤ|ΚΡΟΚΑΛΟΠ|ΣΙΔΗΡΟΠ|Λ|ΝΑΥ|ΟΥΛΑΜ|ΟΥΡ|Π|ΤΡ|Μ)$/.test(o[1])||/(ΟΦ|ΠΕΛ|ΧΟΡΤ|ΛΛ|ΣΦ|ΡΠ|ΦΡ|ΠΡ|ΛΟΧ|ΣΜΗΝ)$/.test(o[1])&&!/^(ΨΟΦ|ΝΑΥΛΟΧ)$/.test(o[1])||/(ΚΟΛΛ)$/.test(o[1]))&&(s+="ΑΓ")),null!==(o=/^(.+?)(ΗΣΕ|ΗΣΟΥ|ΗΣΑ)$/.exec(s))&&(s=o[1],/^(Ν|ΧΕΡΣΟΝ|ΔΩΔΕΚΑΝ|ΕΡΗΜΟΝ|ΜΕΓΑΛΟΝ|ΕΠΤΑΝ|Ι)$/.test(o[1])&&(s+="ΗΣ")),null!==(o=/^(.+?)(ΗΣΤΕ)$/.exec(s))&&(s=o[1],/^(ΑΣΒ|ΣΒ|ΑΧΡ|ΧΡ|ΑΠΛ|ΑΕΙΜΝ|ΔΥΣΧΡ|ΕΥΧΡ|ΚΟΙΝΟΧΡ|ΠΑΛΙΜΨ)$/.test(o[1])&&(s+="ΗΣΤ")),null!==(o=/^(.+?)(ΟΥΝΕ|ΗΣΟΥΝΕ|ΗΘΟΥΝΕ)$/.exec(s))&&(s=o[1],/^(Ν|Ρ|ΣΠΙ|ΣΤΡΑΒΟΜΟΥΤΣ|ΚΑΚΟΜΟΥΤΣ|ΕΞΩΝ)$/.test(o[1])&&(s+="ΟΥΝ")),null!==(o=/^(.+?)(ΟΥΜΕ|ΗΣΟΥΜΕ|ΗΘΟΥΜΕ)$/.exec(s))&&(s=o[1],/^(ΠΑΡΑΣΟΥΣ|Φ|Χ|ΩΡΙΟΠΛ|ΑΖ|ΑΛΛΟΣΟΥΣ|ΑΣΟΥΣ)$/.test(o[1])&&(s+="ΟΥΜ")),null!=(o=/^(.+?)(ΜΑΤΟΙ|ΜΑΤΟΥΣ|ΜΑΤΟ|ΜΑΤΑ|ΜΑΤΩΣ|ΜΑΤΩΝ|ΜΑΤΟΣ|ΜΑΤΕΣ|ΜΑΤΗ|ΜΑΤΗΣ|ΜΑΤΟΥ)$/.exec(s))&&(s=o[1]+"Μ",/^(ΓΡΑΜ)$/.test(o[1])?s+="Α":/^(ΓΕ|ΣΤΑ)$/.test(o[1])&&(s+="ΑΤ")),null!==(o=/^(.+?)(ΟΥΑ)$/.exec(s))&&(s=o[1]+"ΟΥ"),n.length===s.length&&null!==(o=/^(.+?)(Α|ΑΓΑΤΕ|ΑΓΑΝ|ΑΕΙ|ΑΜΑΙ|ΑΝ|ΑΣ|ΑΣΑΙ|ΑΤΑΙ|ΑΩ|Ε|ΕΙ|ΕΙΣ|ΕΙΤΕ|ΕΣΑΙ|ΕΣ|ΕΤΑΙ|Ι|ΙΕΜΑΙ|ΙΕΜΑΣΤΕ|ΙΕΤΑΙ|ΙΕΣΑΙ|ΙΕΣΑΣΤΕ|ΙΟΜΑΣΤΑΝ|ΙΟΜΟΥΝ|ΙΟΜΟΥΝΑ|ΙΟΝΤΑΝ|ΙΟΝΤΟΥΣΑΝ|ΙΟΣΑΣΤΑΝ|ΙΟΣΑΣΤΕ|ΙΟΣΟΥΝ|ΙΟΣΟΥΝΑ|ΙΟΤΑΝ|ΙΟΥΜΑ|ΙΟΥΜΑΣΤΕ|ΙΟΥΝΤΑΙ|ΙΟΥΝΤΑΝ|Η|ΗΔΕΣ|ΗΔΩΝ|ΗΘΕΙ|ΗΘΕΙΣ|ΗΘΕΙΤΕ|ΗΘΗΚΑΤΕ|ΗΘΗΚΑΝ|ΗΘΟΥΝ|ΗΘΩ|ΗΚΑΤΕ|ΗΚΑΝ|ΗΣ|ΗΣΑΝ|ΗΣΑΤΕ|ΗΣΕΙ|ΗΣΕΣ|ΗΣΟΥΝ|ΗΣΩ|Ο|ΟΙ|ΟΜΑΙ|ΟΜΑΣΤΑΝ|ΟΜΟΥΝ|ΟΜΟΥΝΑ|ΟΝΤΑΙ|ΟΝΤΑΝ|ΟΝΤΟΥΣΑΝ|ΟΣ|ΟΣΑΣΤΑΝ|ΟΣΑΣΤΕ|ΟΣΟΥΝ|ΟΣΟΥΝΑ|ΟΤΑΝ|ΟΥ|ΟΥΜΑΙ|ΟΥΜΑΣΤΕ|ΟΥΝ|ΟΥΝΤΑΙ|ΟΥΝΤΑΝ|ΟΥΣ|ΟΥΣΑΝ|ΟΥΣΑΤΕ|Υ||ΥΑ|ΥΣ|Ω|ΩΝ|ΟΙΣ)$/.exec(s))&&(s=o[1]),null!=(o=/^(.+?)(ΕΣΤΕΡ|ΕΣΤΑΤ|ΟΤΕΡ|ΟΤΑΤ|ΥΤΕΡ|ΥΤΑΤ|ΩΤΕΡ|ΩΤΑΤ)$/.exec(s))&&(/^(ΕΞ|ΕΣ|ΑΝ|ΚΑΤ|Κ|ΠΡ)$/.test(o[1])||(s=o[1]),/^(ΚΑ|Μ|ΕΛΕ|ΛΕ|ΔΕ)$/.test(o[1])&&(s+="ΥΤ")),s}var l={"ΦΑΓΙΑ":"ΦΑ","ΦΑΓΙΟΥ":"ΦΑ","ΦΑΓΙΩΝ":"ΦΑ","ΣΚΑΓΙΑ":"ΣΚΑ","ΣΚΑΓΙΟΥ":"ΣΚΑ","ΣΚΑΓΙΩΝ":"ΣΚΑ","ΣΟΓΙΟΥ":"ΣΟ","ΣΟΓΙΑ":"ΣΟ","ΣΟΓΙΩΝ":"ΣΟ","ΤΑΤΟΓΙΑ":"ΤΑΤΟ","ΤΑΤΟΓΙΟΥ":"ΤΑΤΟ","ΤΑΤΟΓΙΩΝ":"ΤΑΤΟ","ΚΡΕΑΣ":"ΚΡΕ","ΚΡΕΑΤΟΣ":"ΚΡΕ","ΚΡΕΑΤΑ":"ΚΡΕ","ΚΡΕΑΤΩΝ":"ΚΡΕ","ΠΕΡΑΣ":"ΠΕΡ","ΠΕΡΑΤΟΣ":"ΠΕΡ","ΠΕΡΑΤΑ":"ΠΕΡ","ΠΕΡΑΤΩΝ":"ΠΕΡ","ΤΕΡΑΣ":"ΤΕΡ","ΤΕΡΑΤΟΣ":"ΤΕΡ","ΤΕΡΑΤΑ":"ΤΕΡ","ΤΕΡΑΤΩΝ":"ΤΕΡ","ΦΩΣ":"ΦΩ","ΦΩΤΟΣ":"ΦΩ","ΦΩΤΑ":"ΦΩ","ΦΩΤΩΝ":"ΦΩ","ΚΑΘΕΣΤΩΣ":"ΚΑΘΕΣΤ","ΚΑΘΕΣΤΩΤΟΣ":"ΚΑΘΕΣΤ","ΚΑΘΕΣΤΩΤΑ":"ΚΑΘΕΣΤ","ΚΑΘΕΣΤΩΤΩΝ":"ΚΑΘΕΣΤ","ΓΕΓΟΝΟΣ":"ΓΕΓΟΝ","ΓΕΓΟΝΟΤΟΣ":"ΓΕΓΟΝ","ΓΕΓΟΝΟΤΑ":"ΓΕΓΟΝ","ΓΕΓΟΝΟΤΩΝ":"ΓΕΓΟΝ","ΕΥΑ":"ΕΥ"},i=["ΑΚΡΙΒΩΣ","ΑΛΑ","ΑΛΛΑ","ΑΛΛΙΩΣ","ΑΛΛΟΤΕ","ΑΜΑ","ΑΝΩ","ΑΝΑ","ΑΝΑΜΕΣΑ","ΑΝΑΜΕΤΑΞΥ","ΑΝΕΥ","ΑΝΤΙ","ΑΝΤΙΠΕΡΑ","ΑΝΤΙΟ","ΑΞΑΦΝΑ","ΑΠΟ","ΑΠΟΨΕ","ΑΡΑ","ΑΡΑΓΕ","ΑΥΡΙΟ","ΑΦΟΙ","ΑΦΟΥ","ΑΦΟΤΟΥ","ΒΡΕ","ΓΕΙΑ","ΓΙΑ","ΓΙΑΤΙ","ΓΡΑΜΜΑ","ΔΕΗ","ΔΕΝ","ΔΗΛΑΔΗ","ΔΙΧΩΣ","ΔΥΟ","ΕΑΝ","ΕΓΩ","ΕΔΩ","ΕΔΑ","ΕΙΘΕ","ΕΙΜΑΙ","ΕΙΜΑΣΤΕ","ΕΙΣΑΙ","ΕΙΣΑΣΤΕ","ΕΙΝΑΙ","ΕΙΣΤΕ","ΕΙΤΕ","ΕΚΕΙ","ΕΚΟ","ΕΛΑ","ΕΜΑΣ","ΕΜΕΙΣ","ΕΝΤΕΛΩΣ","ΕΝΤΟΣ","ΕΝΤΩΜΕΤΑΞΥ","ΕΝΩ","ΕΞΙ","ΕΞΙΣΟΥ","ΕΞΗΣ","ΕΞΩ","ΕΟΚ","ΕΠΑΝΩ","ΕΠΕΙΔΗ","ΕΠΕΙΤΑ","ΕΠΙ","ΕΠΙΣΗΣ","ΕΠΟΜΕΝΩΣ","ΕΠΤΑ","ΕΣΑΣ","ΕΣΕΙΣ","ΕΣΤΩ","ΕΣΥ","ΕΣΩ","ΕΤΣΙ","ΕΥΓΕ","ΕΦΕ","ΕΦΕΞΗΣ","ΕΧΤΕΣ","ΕΩΣ","ΗΔΗ","ΗΜΙ","ΗΠΑ","ΗΤΟΙ","ΘΕΣ","ΙΔΙΩΣ","ΙΔΗ","ΙΚΑ","ΙΣΩΣ","ΚΑΘΕ","ΚΑΘΕΤΙ","ΚΑΘΟΛΟΥ","ΚΑΘΩΣ","ΚΑΙ","ΚΑΝ","ΚΑΠΟΤΕ","ΚΑΠΟΥ","ΚΑΤΑ","ΚΑΤΙ","ΚΑΤΟΠΙΝ","ΚΑΤΩ","ΚΕΙ","ΚΙΧ","ΚΚΕ","ΚΟΛΑΝ","ΚΥΡΙΩΣ","ΚΩΣ","ΜΑΚΑΡΙ","ΜΑΛΙΣΤΑ","ΜΑΛΛΟΝ","ΜΑΙ","ΜΑΟ","ΜΑΟΥΣ","ΜΑΣ","ΜΕΘΑΥΡΙΟ","ΜΕΣ","ΜΕΣΑ","ΜΕΤΑ","ΜΕΤΑΞΥ","ΜΕΧΡΙ","ΜΗΔΕ","ΜΗΝ","ΜΗΠΩΣ","ΜΗΤΕ","ΜΙΑ","ΜΙΑΣ","ΜΙΣ","ΜΜΕ","ΜΟΛΟΝΟΤΙ","ΜΟΥ","ΜΠΑ","ΜΠΑΣ","ΜΠΟΥΦΑΝ","ΜΠΡΟΣ","ΝΑΙ","ΝΕΣ","ΝΤΑ","ΝΤΕ","ΞΑΝΑ","ΟΗΕ","ΟΚΤΩ","ΟΜΩΣ","ΟΝΕ","ΟΠΑ","ΟΠΟΥ","ΟΠΩΣ","ΟΣΟ","ΟΤΑΝ","ΟΤΕ","ΟΤΙ","ΟΥΤΕ","ΟΧΙ","ΠΑΛΙ","ΠΑΝ","ΠΑΝΟ","ΠΑΝΤΟΤΕ","ΠΑΝΤΟΥ","ΠΑΝΤΩΣ","ΠΑΝΩ","ΠΑΡΑ","ΠΕΡΑ","ΠΕΡΙ","ΠΕΡΙΠΟΥ","ΠΙΑ","ΠΙΟ","ΠΙΣΩ","ΠΛΑΙ","ΠΛΕΟΝ","ΠΛΗΝ","ΠΟΤΕ","ΠΟΥ","ΠΡΟ","ΠΡΟΣ","ΠΡΟΧΤΕΣ","ΠΡΟΧΘΕΣ","ΡΟΔΙ","ΠΩΣ","ΣΑΙ","ΣΑΣ","ΣΑΝ","ΣΕΙΣ","ΣΙΑ","ΣΚΙ","ΣΟΙ","ΣΟΥ","ΣΡΙ","ΣΥΝ","ΣΥΝΑΜΑ","ΣΧΕΔΟΝ","ΤΑΔΕ","ΤΑΞΙ","ΤΑΧΑ","ΤΕΙ","ΤΗΝ","ΤΗΣ","ΤΙΠΟΤΑ","ΤΙΠΟΤΕ","ΤΙΣ","ΤΟΝ","ΤΟΤΕ","ΤΟΥ","ΤΟΥΣ","ΤΣΑ","ΤΣΕ","ΤΣΙ","ΤΣΟΥ","ΤΩΝ","ΥΠΟ","ΥΠΟΨΗ","ΥΠΟΨΙΝ","ΥΣΤΕΡΑ","ΦΕΤΟΣ","ΦΙΣ","ΦΠΑ","ΧΑΦ","ΧΘΕΣ","ΧΤΕΣ","ΧΩΡΙΣ","ΩΣ","ΩΣΑΝ","ΩΣΟΤΟΥ","ΩΣΠΟΥ","ΩΣΤΕ","ΩΣΤΟΣΟ"],s=new RegExp("^[ΑΒΓΔΕΖΗΘΙΚΛΜΝΞΟΠΡΣΤΥΦΧΨΩ]+$");return function(e){return"function"==typeof e.update?e.update(function(e){return n(e.toUpperCase()).toLowerCase()}):n(e.toUpperCase()).toLowerCase()}}(),e.Pipeline.registerFunction(e.el.stemmer,"stemmer-el"),e.el.stopWordFilter=e.generateStopWordFilter("αλλα αν αντι απο αυτα αυτεσ αυτη αυτο αυτοι αυτοσ αυτουσ αυτων για δε δεν εαν ειμαι ειμαστε ειναι εισαι ειστε εκεινα εκεινεσ εκεινη εκεινο εκεινοι εκεινοσ εκεινουσ εκεινων ενω επι η θα ισωσ κ και κατα κι μα με μετα μη μην να ο οι ομωσ οπωσ οσο οτι παρα ποια ποιεσ ποιο ποιοι ποιοσ ποιουσ ποιων που προσ πωσ σε στη στην στο στον τα την τησ το τον τοτε του των ωσ".split(" ")),e.Pipeline.registerFunction(e.el.stopWordFilter,"stopWordFilter-el"),e.el.normilizer=function(){var e={"Ά":"Α","ά":"α","Έ":"Ε","έ":"ε","Ή":"Η","ή":"η","Ί":"Ι","ί":"ι","Ό":"Ο","ο":"ο","Ύ":"Υ","ύ":"υ","Ώ":"Ω","ώ":"ω","Ϊ":"Ι","ϊ":"ι","Ϋ":"Υ","ϋ":"υ","ΐ":"ι","ΰ":"υ"};return function(t){if("function"==typeof t.update)return t.update(function(t){for(var r="",n=0;n<t.length;n++)r+=e[t.charAt(n)]||t.charAt(n);return r});for(var r="",n=0;n<t.length;n++)r+=e[t.charAt(n)]||t.charAt(n);return r}}(),e.Pipeline.registerFunction(e.el.normilizer,"normilizer-el")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.es.min.js b/latest/assets/javascripts/lunr/min/lunr.es.min.js
new file mode 100644
index 000000000..2989d3426
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.es.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Spanish` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,s){"function"==typeof define&&define.amd?define(s):"object"==typeof exports?module.exports=s():s()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.es=function(){this.pipeline.reset(),this.pipeline.add(e.es.trimmer,e.es.stopWordFilter,e.es.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.es.stemmer))},e.es.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.es.trimmer=e.trimmerSupport.generateTrimmer(e.es.wordCharacters),e.Pipeline.registerFunction(e.es.trimmer,"trimmer-es"),e.es.stemmer=function(){var s=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,n=new function(){function e(){if(A.out_grouping(x,97,252)){for(;!A.in_grouping(x,97,252);){if(A.cursor>=A.limit)return!0;A.cursor++}return!1}return!0}function n(){if(A.in_grouping(x,97,252)){var s=A.cursor;if(e()){if(A.cursor=s,!A.in_grouping(x,97,252))return!0;for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!0;A.cursor++}}return!1}return!0}function i(){var s,r=A.cursor;if(n()){if(A.cursor=r,!A.out_grouping(x,97,252))return;if(s=A.cursor,e()){if(A.cursor=s,!A.in_grouping(x,97,252)||A.cursor>=A.limit)return;A.cursor++}}g=A.cursor}function a(){for(;!A.in_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}return!0}function t(){var e=A.cursor;g=A.limit,p=g,v=g,i(),A.cursor=e,a()&&(p=A.cursor,a()&&(v=A.cursor))}function o(){for(var e;;){if(A.bra=A.cursor,e=A.find_among(k,6))switch(A.ket=A.cursor,e){case 1:A.slice_from("a");continue;case 2:A.slice_from("e");continue;case 3:A.slice_from("i");continue;case 4:A.slice_from("o");continue;case 5:A.slice_from("u");continue;case 6:if(A.cursor>=A.limit)break;A.cursor++;continue}break}}function u(){return g<=A.cursor}function w(){return p<=A.cursor}function c(){return v<=A.cursor}function m(){var e;if(A.ket=A.cursor,A.find_among_b(y,13)&&(A.bra=A.cursor,(e=A.find_among_b(q,11))&&u()))switch(e){case 1:A.bra=A.cursor,A.slice_from("iendo");break;case 2:A.bra=A.cursor,A.slice_from("ando");break;case 3:A.bra=A.cursor,A.slice_from("ar");break;case 4:A.bra=A.cursor,A.slice_from("er");break;case 5:A.bra=A.cursor,A.slice_from("ir");break;case 6:A.slice_del();break;case 7:A.eq_s_b(1,"u")&&A.slice_del()}}function l(e,s){if(!c())return!0;A.slice_del(),A.ket=A.cursor;var r=A.find_among_b(e,s);return r&&(A.bra=A.cursor,1==r&&c()&&A.slice_del()),!1}function d(e){return!c()||(A.slice_del(),A.ket=A.cursor,A.eq_s_b(2,e)&&(A.bra=A.cursor,c()&&A.slice_del()),!1)}function b(){var e;if(A.ket=A.cursor,e=A.find_among_b(S,46)){switch(A.bra=A.cursor,e){case 1:if(!c())return!1;A.slice_del();break;case 2:if(d("ic"))return!1;break;case 3:if(!c())return!1;A.slice_from("log");break;case 4:if(!c())return!1;A.slice_from("u");break;case 5:if(!c())return!1;A.slice_from("ente");break;case 6:if(!w())return!1;A.slice_del(),A.ket=A.cursor,e=A.find_among_b(C,4),e&&(A.bra=A.cursor,c()&&(A.slice_del(),1==e&&(A.ket=A.cursor,A.eq_s_b(2,"at")&&(A.bra=A.cursor,c()&&A.slice_del()))));break;case 7:if(l(P,3))return!1;break;case 8:if(l(F,3))return!1;break;case 9:if(d("at"))return!1}return!0}return!1}function f(){var e,s;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(W,12),A.limit_backward=s,e)){if(A.bra=A.cursor,1==e){if(!A.eq_s_b(1,"u"))return!1;A.slice_del()}return!0}return!1}function _(){var e,s,r,n;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(L,96),A.limit_backward=s,e))switch(A.bra=A.cursor,e){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"u")?(n=A.limit-A.cursor,A.eq_s_b(1,"g")?A.cursor=A.limit-n:A.cursor=A.limit-r):A.cursor=A.limit-r,A.bra=A.cursor;case 2:A.slice_del()}}function h(){var e,s;if(A.ket=A.cursor,e=A.find_among_b(z,8))switch(A.bra=A.cursor,e){case 1:u()&&A.slice_del();break;case 2:u()&&(A.slice_del(),A.ket=A.cursor,A.eq_s_b(1,"u")&&(A.bra=A.cursor,s=A.limit-A.cursor,A.eq_s_b(1,"g")&&(A.cursor=A.limit-s,u()&&A.slice_del())))}}var v,p,g,k=[new s("",-1,6),new s("á",0,1),new s("é",0,2),new s("í",0,3),new s("ó",0,4),new s("ú",0,5)],y=[new s("la",-1,-1),new s("sela",0,-1),new s("le",-1,-1),new s("me",-1,-1),new s("se",-1,-1),new s("lo",-1,-1),new s("selo",5,-1),new s("las",-1,-1),new s("selas",7,-1),new s("les",-1,-1),new s("los",-1,-1),new s("selos",10,-1),new s("nos",-1,-1)],q=[new s("ando",-1,6),new s("iendo",-1,6),new s("yendo",-1,7),new s("ándo",-1,2),new s("iéndo",-1,1),new s("ar",-1,6),new s("er",-1,6),new s("ir",-1,6),new s("ár",-1,3),new s("ér",-1,4),new s("ír",-1,5)],C=[new s("ic",-1,-1),new s("ad",-1,-1),new s("os",-1,-1),new s("iv",-1,1)],P=[new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,1)],F=[new s("ic",-1,1),new s("abil",-1,1),new s("iv",-1,1)],S=[new s("ica",-1,1),new s("ancia",-1,2),new s("encia",-1,5),new s("adora",-1,2),new s("osa",-1,1),new s("ista",-1,1),new s("iva",-1,9),new s("anza",-1,1),new s("logía",-1,3),new s("idad",-1,8),new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,2),new s("mente",-1,7),new s("amente",13,6),new s("ación",-1,2),new s("ución",-1,4),new s("ico",-1,1),new s("ismo",-1,1),new s("oso",-1,1),new s("amiento",-1,1),new s("imiento",-1,1),new s("ivo",-1,9),new s("ador",-1,2),new s("icas",-1,1),new s("ancias",-1,2),new s("encias",-1,5),new s("adoras",-1,2),new s("osas",-1,1),new s("istas",-1,1),new s("ivas",-1,9),new s("anzas",-1,1),new s("logías",-1,3),new s("idades",-1,8),new s("ables",-1,1),new s("ibles",-1,1),new s("aciones",-1,2),new s("uciones",-1,4),new s("adores",-1,2),new s("antes",-1,2),new s("icos",-1,1),new s("ismos",-1,1),new s("osos",-1,1),new s("amientos",-1,1),new s("imientos",-1,1),new s("ivos",-1,9)],W=[new s("ya",-1,1),new s("ye",-1,1),new s("yan",-1,1),new s("yen",-1,1),new s("yeron",-1,1),new s("yendo",-1,1),new s("yo",-1,1),new s("yas",-1,1),new s("yes",-1,1),new s("yais",-1,1),new s("yamos",-1,1),new s("yó",-1,1)],L=[new s("aba",-1,2),new s("ada",-1,2),new s("ida",-1,2),new s("ara",-1,2),new s("iera",-1,2),new s("ía",-1,2),new s("aría",5,2),new s("ería",5,2),new s("iría",5,2),new s("ad",-1,2),new s("ed",-1,2),new s("id",-1,2),new s("ase",-1,2),new s("iese",-1,2),new s("aste",-1,2),new s("iste",-1,2),new s("an",-1,2),new s("aban",16,2),new s("aran",16,2),new s("ieran",16,2),new s("ían",16,2),new s("arían",20,2),new s("erían",20,2),new s("irían",20,2),new s("en",-1,1),new s("asen",24,2),new s("iesen",24,2),new s("aron",-1,2),new s("ieron",-1,2),new s("arán",-1,2),new s("erán",-1,2),new s("irán",-1,2),new s("ado",-1,2),new s("ido",-1,2),new s("ando",-1,2),new s("iendo",-1,2),new s("ar",-1,2),new s("er",-1,2),new s("ir",-1,2),new s("as",-1,2),new s("abas",39,2),new s("adas",39,2),new s("idas",39,2),new s("aras",39,2),new s("ieras",39,2),new s("ías",39,2),new s("arías",45,2),new s("erías",45,2),new s("irías",45,2),new s("es",-1,1),new s("ases",49,2),new s("ieses",49,2),new s("abais",-1,2),new s("arais",-1,2),new s("ierais",-1,2),new s("íais",-1,2),new s("aríais",55,2),new s("eríais",55,2),new s("iríais",55,2),new s("aseis",-1,2),new s("ieseis",-1,2),new s("asteis",-1,2),new s("isteis",-1,2),new s("áis",-1,2),new s("éis",-1,1),new s("aréis",64,2),new s("eréis",64,2),new s("iréis",64,2),new s("ados",-1,2),new s("idos",-1,2),new s("amos",-1,2),new s("ábamos",70,2),new s("áramos",70,2),new s("iéramos",70,2),new s("íamos",70,2),new s("aríamos",74,2),new s("eríamos",74,2),new s("iríamos",74,2),new s("emos",-1,1),new s("aremos",78,2),new s("eremos",78,2),new s("iremos",78,2),new s("ásemos",78,2),new s("iésemos",78,2),new s("imos",-1,2),new s("arás",-1,2),new s("erás",-1,2),new s("irás",-1,2),new s("ís",-1,2),new s("ará",-1,2),new s("erá",-1,2),new s("irá",-1,2),new s("aré",-1,2),new s("eré",-1,2),new s("iré",-1,2),new s("ió",-1,2)],z=[new s("a",-1,1),new s("e",-1,2),new s("o",-1,1),new s("os",-1,1),new s("á",-1,1),new s("é",-1,2),new s("í",-1,1),new s("ó",-1,1)],x=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,4,10],A=new r;this.setCurrent=function(e){A.setCurrent(e)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return t(),A.limit_backward=e,A.cursor=A.limit,m(),A.cursor=A.limit,b()||(A.cursor=A.limit,f()||(A.cursor=A.limit,_())),A.cursor=A.limit,h(),A.cursor=A.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.es.stemmer,"stemmer-es"),e.es.stopWordFilter=e.generateStopWordFilter("a al algo algunas algunos ante antes como con contra cual cuando de del desde donde durante e el ella ellas ellos en entre era erais eran eras eres es esa esas ese eso esos esta estaba estabais estaban estabas estad estada estadas estado estados estamos estando estar estaremos estará estarán estarás estaré estaréis estaría estaríais estaríamos estarían estarías estas este estemos esto estos estoy estuve estuviera estuvierais estuvieran estuvieras estuvieron estuviese estuvieseis estuviesen estuvieses estuvimos estuviste estuvisteis estuviéramos estuviésemos estuvo está estábamos estáis están estás esté estéis estén estés fue fuera fuerais fueran fueras fueron fuese fueseis fuesen fueses fui fuimos fuiste fuisteis fuéramos fuésemos ha habida habidas habido habidos habiendo habremos habrá habrán habrás habré habréis habría habríais habríamos habrían habrías habéis había habíais habíamos habían habías han has hasta hay haya hayamos hayan hayas hayáis he hemos hube hubiera hubierais hubieran hubieras hubieron hubiese hubieseis hubiesen hubieses hubimos hubiste hubisteis hubiéramos hubiésemos hubo la las le les lo los me mi mis mucho muchos muy más mí mía mías mío míos nada ni no nos nosotras nosotros nuestra nuestras nuestro nuestros o os otra otras otro otros para pero poco por porque que quien quienes qué se sea seamos sean seas seremos será serán serás seré seréis sería seríais seríamos serían serías seáis sido siendo sin sobre sois somos son soy su sus suya suyas suyo suyos sí también tanto te tendremos tendrá tendrán tendrás tendré tendréis tendría tendríais tendríamos tendrían tendrías tened tenemos tenga tengamos tengan tengas tengo tengáis tenida tenidas tenido tenidos teniendo tenéis tenía teníais teníamos tenían tenías ti tiene tienen tienes todo todos tu tus tuve tuviera tuvierais tuvieran tuvieras tuvieron tuviese tuvieseis tuviesen tuvieses tuvimos tuviste tuvisteis tuviéramos tuviésemos tuvo tuya tuyas tuyo tuyos tú un una uno unos vosotras vosotros vuestra vuestras vuestro vuestros y ya yo él éramos".split(" ")),e.Pipeline.registerFunction(e.es.stopWordFilter,"stopWordFilter-es")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.fi.min.js b/latest/assets/javascripts/lunr/min/lunr.fi.min.js
new file mode 100644
index 000000000..29f5dfcea
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.fi.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Finnish` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(i,e){"function"==typeof define&&define.amd?define(e):"object"==typeof exports?module.exports=e():e()(i.lunr)}(this,function(){return function(i){if(void 0===i)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===i.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");i.fi=function(){this.pipeline.reset(),this.pipeline.add(i.fi.trimmer,i.fi.stopWordFilter,i.fi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(i.fi.stemmer))},i.fi.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",i.fi.trimmer=i.trimmerSupport.generateTrimmer(i.fi.wordCharacters),i.Pipeline.registerFunction(i.fi.trimmer,"trimmer-fi"),i.fi.stemmer=function(){var e=i.stemmerSupport.Among,r=i.stemmerSupport.SnowballProgram,n=new function(){function i(){f=A.limit,d=f,n()||(f=A.cursor,n()||(d=A.cursor))}function n(){for(var i;;){if(i=A.cursor,A.in_grouping(W,97,246))break;if(A.cursor=i,i>=A.limit)return!0;A.cursor++}for(A.cursor=i;!A.out_grouping(W,97,246);){if(A.cursor>=A.limit)return!0;A.cursor++}return!1}function t(){return d<=A.cursor}function s(){var i,e;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(h,10)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.in_grouping_b(x,97,246))return;break;case 2:if(!t())return}A.slice_del()}else A.limit_backward=e}function o(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(v,9))switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"k")||(A.cursor=A.limit-r,A.slice_del());break;case 2:A.slice_del(),A.ket=A.cursor,A.eq_s_b(3,"kse")&&(A.bra=A.cursor,A.slice_from("ksi"));break;case 3:A.slice_del();break;case 4:A.find_among_b(p,6)&&A.slice_del();break;case 5:A.find_among_b(g,6)&&A.slice_del();break;case 6:A.find_among_b(j,2)&&A.slice_del()}else A.limit_backward=e}function l(){return A.find_among_b(q,7)}function a(){return A.eq_s_b(1,"i")&&A.in_grouping_b(L,97,246)}function u(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(C,30)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.eq_s_b(1,"a"))return;break;case 2:case 9:if(!A.eq_s_b(1,"e"))return;break;case 3:if(!A.eq_s_b(1,"i"))return;break;case 4:if(!A.eq_s_b(1,"o"))return;break;case 5:if(!A.eq_s_b(1,"ä"))return;break;case 6:if(!A.eq_s_b(1,"ö"))return;break;case 7:if(r=A.limit-A.cursor,!l()&&(A.cursor=A.limit-r,!A.eq_s_b(2,"ie"))){A.cursor=A.limit-r;break}if(A.cursor=A.limit-r,A.cursor<=A.limit_backward){A.cursor=A.limit-r;break}A.cursor--,A.bra=A.cursor;break;case 8:if(!A.in_grouping_b(W,97,246)||!A.out_grouping_b(W,97,246))return}A.slice_del(),k=!0}else A.limit_backward=e}function c(){var i,e,r;if(A.cursor>=d)if(e=A.limit_backward,A.limit_backward=d,A.ket=A.cursor,i=A.find_among_b(P,14)){if(A.bra=A.cursor,A.limit_backward=e,1==i){if(r=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-r}A.slice_del()}else A.limit_backward=e}function m(){var i;A.cursor>=f&&(i=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.find_among_b(F,2)?(A.bra=A.cursor,A.limit_backward=i,A.slice_del()):A.limit_backward=i)}function w(){var i,e,r,n,t,s;if(A.cursor>=f){if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.eq_s_b(1,"t")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.in_grouping_b(W,97,246)&&(A.cursor=A.limit-r,A.slice_del(),A.limit_backward=e,n=A.limit-A.cursor,A.cursor>=d&&(A.cursor=d,t=A.limit_backward,A.limit_backward=A.cursor,A.cursor=A.limit-n,A.ket=A.cursor,i=A.find_among_b(S,2))))){if(A.bra=A.cursor,A.limit_backward=t,1==i){if(s=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-s}return void A.slice_del()}A.limit_backward=e}}function _(){var i,e,r,n;if(A.cursor>=f){for(i=A.limit_backward,A.limit_backward=f,e=A.limit-A.cursor,l()&&(A.cursor=A.limit-e,A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.in_grouping_b(y,97,228)&&(A.bra=A.cursor,A.out_grouping_b(W,97,246)&&A.slice_del()),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"j")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.eq_s_b(1,"o")?A.slice_del():(A.cursor=A.limit-r,A.eq_s_b(1,"u")&&A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"o")&&(A.bra=A.cursor,A.eq_s_b(1,"j")&&A.slice_del()),A.cursor=A.limit-e,A.limit_backward=i;;){if(n=A.limit-A.cursor,A.out_grouping_b(W,97,246)){A.cursor=A.limit-n;break}if(A.cursor=A.limit-n,A.cursor<=A.limit_backward)return;A.cursor--}A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,b=A.slice_to(),A.eq_v_b(b)&&A.slice_del())}}var k,b,d,f,h=[new e("pa",-1,1),new e("sti",-1,2),new e("kaan",-1,1),new e("han",-1,1),new e("kin",-1,1),new e("hän",-1,1),new e("kään",-1,1),new e("ko",-1,1),new e("pä",-1,1),new e("kö",-1,1)],p=[new e("lla",-1,-1),new e("na",-1,-1),new e("ssa",-1,-1),new e("ta",-1,-1),new e("lta",3,-1),new e("sta",3,-1)],g=[new e("llä",-1,-1),new e("nä",-1,-1),new e("ssä",-1,-1),new e("tä",-1,-1),new e("ltä",3,-1),new e("stä",3,-1)],j=[new e("lle",-1,-1),new e("ine",-1,-1)],v=[new e("nsa",-1,3),new e("mme",-1,3),new e("nne",-1,3),new e("ni",-1,2),new e("si",-1,1),new e("an",-1,4),new e("en",-1,6),new e("än",-1,5),new e("nsä",-1,3)],q=[new e("aa",-1,-1),new e("ee",-1,-1),new e("ii",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1),new e("ää",-1,-1),new e("öö",-1,-1)],C=[new e("a",-1,8),new e("lla",0,-1),new e("na",0,-1),new e("ssa",0,-1),new e("ta",0,-1),new e("lta",4,-1),new e("sta",4,-1),new e("tta",4,9),new e("lle",-1,-1),new e("ine",-1,-1),new e("ksi",-1,-1),new e("n",-1,7),new e("han",11,1),new e("den",11,-1,a),new e("seen",11,-1,l),new e("hen",11,2),new e("tten",11,-1,a),new e("hin",11,3),new e("siin",11,-1,a),new e("hon",11,4),new e("hän",11,5),new e("hön",11,6),new e("ä",-1,8),new e("llä",22,-1),new e("nä",22,-1),new e("ssä",22,-1),new e("tä",22,-1),new e("ltä",26,-1),new e("stä",26,-1),new e("ttä",26,9)],P=[new e("eja",-1,-1),new e("mma",-1,1),new e("imma",1,-1),new e("mpa",-1,1),new e("impa",3,-1),new e("mmi",-1,1),new e("immi",5,-1),new e("mpi",-1,1),new e("impi",7,-1),new e("ejä",-1,-1),new e("mmä",-1,1),new e("immä",10,-1),new e("mpä",-1,1),new e("impä",12,-1)],F=[new e("i",-1,-1),new e("j",-1,-1)],S=[new e("mma",-1,1),new e("imma",0,-1)],y=[17,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8],W=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],x=[17,97,24,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],A=new r;this.setCurrent=function(i){A.setCurrent(i)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return i(),k=!1,A.limit_backward=e,A.cursor=A.limit,s(),A.cursor=A.limit,o(),A.cursor=A.limit,u(),A.cursor=A.limit,c(),A.cursor=A.limit,k?(m(),A.cursor=A.limit):(A.cursor=A.limit,w(),A.cursor=A.limit),_(),!0}};return function(i){return"function"==typeof i.update?i.update(function(i){return n.setCurrent(i),n.stem(),n.getCurrent()}):(n.setCurrent(i),n.stem(),n.getCurrent())}}(),i.Pipeline.registerFunction(i.fi.stemmer,"stemmer-fi"),i.fi.stopWordFilter=i.generateStopWordFilter("ei eivät emme en et ette että he heidän heidät heihin heille heillä heiltä heissä heistä heitä hän häneen hänelle hänellä häneltä hänen hänessä hänestä hänet häntä itse ja johon joiden joihin joiksi joilla joille joilta joina joissa joista joita joka joksi jolla jolle jolta jona jonka jos jossa josta jota jotka kanssa keiden keihin keiksi keille keillä keiltä keinä keissä keistä keitä keneen keneksi kenelle kenellä keneltä kenen kenenä kenessä kenestä kenet ketkä ketkä ketä koska kuin kuka kun me meidän meidät meihin meille meillä meiltä meissä meistä meitä mihin miksi mikä mille millä miltä minkä minkä minua minulla minulle minulta minun minussa minusta minut minuun minä minä missä mistä mitkä mitä mukaan mutta ne niiden niihin niiksi niille niillä niiltä niin niin niinä niissä niistä niitä noiden noihin noiksi noilla noille noilta noin noina noissa noista noita nuo nyt näiden näihin näiksi näille näillä näiltä näinä näissä näistä näitä nämä ole olemme olen olet olette oli olimme olin olisi olisimme olisin olisit olisitte olisivat olit olitte olivat olla olleet ollut on ovat poikki se sekä sen siihen siinä siitä siksi sille sillä sillä siltä sinua sinulla sinulle sinulta sinun sinussa sinusta sinut sinuun sinä sinä sitä tai te teidän teidät teihin teille teillä teiltä teissä teistä teitä tuo tuohon tuoksi tuolla tuolle tuolta tuon tuona tuossa tuosta tuota tähän täksi tälle tällä tältä tämä tämän tänä tässä tästä tätä vaan vai vaikka yli".split(" ")),i.Pipeline.registerFunction(i.fi.stopWordFilter,"stopWordFilter-fi")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.fr.min.js b/latest/assets/javascripts/lunr/min/lunr.fr.min.js
new file mode 100644
index 000000000..68cd0094a
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.fr.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `French` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.fr=function(){this.pipeline.reset(),this.pipeline.add(e.fr.trimmer,e.fr.stopWordFilter,e.fr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.fr.stemmer))},e.fr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.fr.trimmer=e.trimmerSupport.generateTrimmer(e.fr.wordCharacters),e.Pipeline.registerFunction(e.fr.trimmer,"trimmer-fr"),e.fr.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,s){return!(!W.eq_s(1,e)||(W.ket=W.cursor,!W.in_grouping(F,97,251)))&&(W.slice_from(r),W.cursor=s,!0)}function i(e,r,s){return!!W.eq_s(1,e)&&(W.ket=W.cursor,W.slice_from(r),W.cursor=s,!0)}function n(){for(var r,s;;){if(r=W.cursor,W.in_grouping(F,97,251)){if(W.bra=W.cursor,s=W.cursor,e("u","U",r))continue;if(W.cursor=s,e("i","I",r))continue;if(W.cursor=s,i("y","Y",r))continue}if(W.cursor=r,W.bra=r,!e("y","Y",r)){if(W.cursor=r,W.eq_s(1,"q")&&(W.bra=W.cursor,i("u","U",r)))continue;if(W.cursor=r,r>=W.limit)return;W.cursor++}}}function t(){for(;!W.in_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}for(;!W.out_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}return!1}function u(){var e=W.cursor;if(q=W.limit,g=q,p=q,W.in_grouping(F,97,251)&&W.in_grouping(F,97,251)&&W.cursor<W.limit)W.cursor++;else if(W.cursor=e,!W.find_among(v,3)){W.cursor=e;do{if(W.cursor>=W.limit){W.cursor=q;break}W.cursor++}while(!W.in_grouping(F,97,251))}q=W.cursor,W.cursor=e,t()||(g=W.cursor,t()||(p=W.cursor))}function o(){for(var e,r;;){if(r=W.cursor,W.bra=r,!(e=W.find_among(h,4)))break;switch(W.ket=W.cursor,e){case 1:W.slice_from("i");break;case 2:W.slice_from("u");break;case 3:W.slice_from("y");break;case 4:if(W.cursor>=W.limit)return;W.cursor++}}}function c(){return q<=W.cursor}function a(){return g<=W.cursor}function l(){return p<=W.cursor}function w(){var e,r;if(W.ket=W.cursor,e=W.find_among_b(C,43)){switch(W.bra=W.cursor,e){case 1:if(!l())return!1;W.slice_del();break;case 2:if(!l())return!1;W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")&&(W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU"));break;case 3:if(!l())return!1;W.slice_from("log");break;case 4:if(!l())return!1;W.slice_from("u");break;case 5:if(!l())return!1;W.slice_from("ent");break;case 6:if(!c())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(z,6))switch(W.bra=W.cursor,e){case 1:l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&W.slice_del()));break;case 2:l()?W.slice_del():a()&&W.slice_from("eux");break;case 3:l()&&W.slice_del();break;case 4:c()&&W.slice_from("i")}break;case 7:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(y,3))switch(W.bra=W.cursor,e){case 1:l()?W.slice_del():W.slice_from("abl");break;case 2:l()?W.slice_del():W.slice_from("iqU");break;case 3:l()&&W.slice_del()}break;case 8:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")))){W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU");break}break;case 9:W.slice_from("eau");break;case 10:if(!a())return!1;W.slice_from("al");break;case 11:if(l())W.slice_del();else{if(!a())return!1;W.slice_from("eux")}break;case 12:if(!a()||!W.out_grouping_b(F,97,251))return!1;W.slice_del();break;case 13:return c()&&W.slice_from("ant"),!1;case 14:return c()&&W.slice_from("ent"),!1;case 15:return r=W.limit-W.cursor,W.in_grouping_b(F,97,251)&&c()&&(W.cursor=W.limit-r,W.slice_del()),!1}return!0}return!1}function f(){var e,r;if(W.cursor<q)return!1;if(r=W.limit_backward,W.limit_backward=q,W.ket=W.cursor,!(e=W.find_among_b(x,35)))return W.limit_backward=r,!1;if(W.bra=W.cursor,1==e){if(!W.out_grouping_b(F,97,251))return W.limit_backward=r,!1;W.slice_del()}return W.limit_backward=r,!0}function m(){var e,r,s;if(W.cursor<q)return!1;if(r=W.limit_backward,W.limit_backward=q,W.ket=W.cursor,!(e=W.find_among_b(I,38)))return W.limit_backward=r,!1;switch(W.bra=W.cursor,e){case 1:if(!l())return W.limit_backward=r,!1;W.slice_del();break;case 2:W.slice_del();break;case 3:W.slice_del(),s=W.limit-W.cursor,W.ket=W.cursor,W.eq_s_b(1,"e")?(W.bra=W.cursor,W.slice_del()):W.cursor=W.limit-s}return W.limit_backward=r,!0}function _(){var e,r,s,i,n=W.limit-W.cursor;if(W.ket=W.cursor,W.eq_s_b(1,"s")?(W.bra=W.cursor,r=W.limit-W.cursor,W.out_grouping_b(S,97,232)?(W.cursor=W.limit-r,W.slice_del()):W.cursor=W.limit-n):W.cursor=W.limit-n,W.cursor>=q){if(s=W.limit_backward,W.limit_backward=q,W.ket=W.cursor,e=W.find_among_b(P,7))switch(W.bra=W.cursor,e){case 1:if(l()){if(i=W.limit-W.cursor,!W.eq_s_b(1,"s")&&(W.cursor=W.limit-i,!W.eq_s_b(1,"t")))break;W.slice_del()}break;case 2:W.slice_from("i");break;case 3:W.slice_del();break;case 4:W.eq_s_b(2,"gu")&&W.slice_del()}W.limit_backward=s}}function b(){var e=W.limit-W.cursor;W.find_among_b(U,5)&&(W.cursor=W.limit-e,W.ket=W.cursor,W.cursor>W.limit_backward&&(W.cursor--,W.bra=W.cursor,W.slice_del()))}function d(){for(var e,r=1;W.out_grouping_b(F,97,251);)r--;if(r<=0){if(W.ket=W.cursor,e=W.limit-W.cursor,!W.eq_s_b(1,"é")&&(W.cursor=W.limit-e,!W.eq_s_b(1,"è")))return;W.bra=W.cursor,W.slice_from("e")}}function k(){if(!w()&&(W.cursor=W.limit,!f()&&(W.cursor=W.limit,!m())))return W.cursor=W.limit,void _();W.cursor=W.limit,W.ket=W.cursor,W.eq_s_b(1,"Y")?(W.bra=W.cursor,W.slice_from("i")):(W.cursor=W.limit,W.eq_s_b(1,"ç")&&(W.bra=W.cursor,W.slice_from("c")))}var p,g,q,v=[new r("col",-1,-1),new r("par",-1,-1),new r("tap",-1,-1)],h=[new r("",-1,4),new r("I",0,1),new r("U",0,2),new r("Y",0,3)],z=[new r("iqU",-1,3),new r("abl",-1,3),new r("Ièr",-1,4),new r("ièr",-1,4),new r("eus",-1,2),new r("iv",-1,1)],y=[new r("ic",-1,2),new r("abil",-1,1),new r("iv",-1,3)],C=[new r("iqUe",-1,1),new r("atrice",-1,2),new r("ance",-1,1),new r("ence",-1,5),new r("logie",-1,3),new r("able",-1,1),new r("isme",-1,1),new r("euse",-1,11),new r("iste",-1,1),new r("ive",-1,8),new r("if",-1,8),new r("usion",-1,4),new r("ation",-1,2),new r("ution",-1,4),new r("ateur",-1,2),new r("iqUes",-1,1),new r("atrices",-1,2),new r("ances",-1,1),new r("ences",-1,5),new r("logies",-1,3),new r("ables",-1,1),new r("ismes",-1,1),new r("euses",-1,11),new r("istes",-1,1),new r("ives",-1,8),new r("ifs",-1,8),new r("usions",-1,4),new r("ations",-1,2),new r("utions",-1,4),new r("ateurs",-1,2),new r("ments",-1,15),new r("ements",30,6),new r("issements",31,12),new r("ités",-1,7),new r("ment",-1,15),new r("ement",34,6),new r("issement",35,12),new r("amment",34,13),new r("emment",34,14),new r("aux",-1,10),new r("eaux",39,9),new r("eux",-1,1),new r("ité",-1,7)],x=[new r("ira",-1,1),new r("ie",-1,1),new r("isse",-1,1),new r("issante",-1,1),new r("i",-1,1),new r("irai",4,1),new r("ir",-1,1),new r("iras",-1,1),new r("ies",-1,1),new r("îmes",-1,1),new r("isses",-1,1),new r("issantes",-1,1),new r("îtes",-1,1),new r("is",-1,1),new r("irais",13,1),new r("issais",13,1),new r("irions",-1,1),new r("issions",-1,1),new r("irons",-1,1),new r("issons",-1,1),new r("issants",-1,1),new r("it",-1,1),new r("irait",21,1),new r("issait",21,1),new r("issant",-1,1),new r("iraIent",-1,1),new r("issaIent",-1,1),new r("irent",-1,1),new r("issent",-1,1),new r("iront",-1,1),new r("ît",-1,1),new r("iriez",-1,1),new r("issiez",-1,1),new r("irez",-1,1),new r("issez",-1,1)],I=[new r("a",-1,3),new r("era",0,2),new r("asse",-1,3),new r("ante",-1,3),new r("ée",-1,2),new r("ai",-1,3),new r("erai",5,2),new r("er",-1,2),new r("as",-1,3),new r("eras",8,2),new r("âmes",-1,3),new r("asses",-1,3),new r("antes",-1,3),new r("âtes",-1,3),new r("ées",-1,2),new r("ais",-1,3),new r("erais",15,2),new r("ions",-1,1),new r("erions",17,2),new r("assions",17,3),new r("erons",-1,2),new r("ants",-1,3),new r("és",-1,2),new r("ait",-1,3),new r("erait",23,2),new r("ant",-1,3),new r("aIent",-1,3),new r("eraIent",26,2),new r("èrent",-1,2),new r("assent",-1,3),new r("eront",-1,2),new r("ât",-1,3),new r("ez",-1,2),new r("iez",32,2),new r("eriez",33,2),new r("assiez",33,3),new r("erez",32,2),new r("é",-1,2)],P=[new r("e",-1,3),new r("Ière",0,2),new r("ière",0,2),new r("ion",-1,1),new r("Ier",-1,2),new r("ier",-1,2),new r("ë",-1,4)],U=[new r("ell",-1,-1),new r("eill",-1,-1),new r("enn",-1,-1),new r("onn",-1,-1),new r("ett",-1,-1)],F=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,128,130,103,8,5],S=[1,65,20,0,0,0,0,0,0,0,0,0,0,0,0,0,128],W=new s;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){var e=W.cursor;return n(),W.cursor=e,u(),W.limit_backward=e,W.cursor=W.limit,k(),W.cursor=W.limit,b(),W.cursor=W.limit,d(),W.cursor=W.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.fr.stemmer,"stemmer-fr"),e.fr.stopWordFilter=e.generateStopWordFilter("ai aie aient aies ait as au aura aurai auraient aurais aurait auras aurez auriez aurions aurons auront aux avaient avais avait avec avez aviez avions avons ayant ayez ayons c ce ceci celà ces cet cette d dans de des du elle en es est et eu eue eues eurent eus eusse eussent eusses eussiez eussions eut eux eûmes eût eûtes furent fus fusse fussent fusses fussiez fussions fut fûmes fût fûtes ici il ils j je l la le les leur leurs lui m ma mais me mes moi mon même n ne nos notre nous on ont ou par pas pour qu que quel quelle quelles quels qui s sa sans se sera serai seraient serais serait seras serez seriez serions serons seront ses soi soient sois soit sommes son sont soyez soyons suis sur t ta te tes toi ton tu un une vos votre vous y à étaient étais était étant étiez étions été étée étées étés êtes".split(" ")),e.Pipeline.registerFunction(e.fr.stopWordFilter,"stopWordFilter-fr")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.he.min.js b/latest/assets/javascripts/lunr/min/lunr.he.min.js
new file mode 100644
index 000000000..b863d3eae
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.he.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.he=function(){this.pipeline.reset(),this.pipeline.add(e.he.trimmer,e.he.stopWordFilter,e.he.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.he.stemmer))},e.he.wordCharacters="֑-״א-תa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.he.trimmer=e.trimmerSupport.generateTrimmer(e.he.wordCharacters),e.Pipeline.registerFunction(e.he.trimmer,"trimmer-he"),e.he.stemmer=function(){var e=this;return e.result=!1,e.preRemoved=!1,e.sufRemoved=!1,e.pre={pre1:"ה ו י ת",pre2:"ב כ ל מ ש כש",pre3:"הב הכ הל המ הש בש לכ",pre4:"וב וכ ול ומ וש",pre5:"מה שה כל",pre6:"מב מכ מל ממ מש",pre7:"בה בו בי בת כה כו כי כת לה לו לי לת",pre8:"ובה ובו ובי ובת וכה וכו וכי וכת ולה ולו ולי ולת"},e.suf={suf1:"ך כ ם ן נ",suf2:"ים ות וך וכ ום ון ונ הם הן יכ יך ינ ים",suf3:"תי תך תכ תם תן תנ",suf4:"ותי ותך ותכ ותם ותן ותנ",suf5:"נו כם כן הם הן",suf6:"ונו וכם וכן והם והן",suf7:"תכם תכן תנו תהם תהן",suf8:"הוא היא הם הן אני אתה את אנו אתם אתן",suf9:"ני נו כי כו כם כן תי תך תכ תם תן",suf10:"י ך כ ם ן נ ת"},e.patterns=JSON.parse('{"hebrewPatterns": [{"pt1": [{"c": "ה", "l": 0}]}, {"pt2": [{"c": "ו", "l": 0}]}, {"pt3": [{"c": "י", "l": 0}]}, {"pt4": [{"c": "ת", "l": 0}]}, {"pt5": [{"c": "מ", "l": 0}]}, {"pt6": [{"c": "ל", "l": 0}]}, {"pt7": [{"c": "ב", "l": 0}]}, {"pt8": [{"c": "כ", "l": 0}]}, {"pt9": [{"c": "ש", "l": 0}]}, {"pt10": [{"c": "כש", "l": 0}]}, {"pt11": [{"c": "בה", "l": 0}]}, {"pt12": [{"c": "וב", "l": 0}]}, {"pt13": [{"c": "וכ", "l": 0}]}, {"pt14": [{"c": "ול", "l": 0}]}, {"pt15": [{"c": "ומ", "l": 0}]}, {"pt16": [{"c": "וש", "l": 0}]}, {"pt17": [{"c": "הב", "l": 0}]}, {"pt18": [{"c": "הכ", "l": 0}]}, {"pt19": [{"c": "הל", "l": 0}]}, {"pt20": [{"c": "המ", "l": 0}]}, {"pt21": [{"c": "הש", "l": 0}]}, {"pt22": [{"c": "מה", "l": 0}]}, {"pt23": [{"c": "שה", "l": 0}]}, {"pt24": [{"c": "כל", "l": 0}]}]}'),e.execArray=["cleanWord","removeDiacritics","removeStopWords","normalizeHebrewCharacters"],e.stem=function(){var r=0;for(e.result=!1,e.preRemoved=!1,e.sufRemoved=!1;r<e.execArray.length&&1!=e.result;)e.result=e[e.execArray[r]](),r++},e.setCurrent=function(r){e.word=r},e.getCurrent=function(){return e.word},e.cleanWord=function(){return!!new RegExp("[^֑-״א-ת]").test("")},e.removeDiacritics=function(){var r=new RegExp("[ְ-ֿ]","g");return e.word=e.word.replace(r,""),!1},e.removeStopWords=function(){if("אבל או אולי אותו אותי אותך אותם אותן אותנו אז אחר אחרות אחרי אחריכן אחרים אחרת אי איזה איך אין איפה אל אלה אלו אם אנחנו אני אף אפשר את אתה אתכם אתכן אתם אתן באיזה באיזו בגלל בין בלבד בעבור בעזרת בכל בכן בלי במידה במקום שבו ברוב בשביל בשעה ש בתוך גם דרך הוא היא היה היי היכן היתה היתי הם הן הנה הסיבה שבגללה הרי ואילו ואת זאת זה זות יהיה יוכל יוכלו יותר מדי יכול יכולה יכולות יכולים יכל יכלה יכלו יש כאן כאשר כולם כולן כזה כי כיצד כך כל כלל כמו כן כפי כש לא לאו לאיזותך לאן לבין לה להיות להם להן לו לזה לזות לי לך לכם לכן למה למעלה למעלה מ למטה למטה מ למעט למקום שבו למרות לנו לעבר לעיכן לפיכך לפני מאד מאחורי מאיזו סיבה מאין מאיפה מבלי מבעד מדוע מה מהיכן מול מחוץ מי מידע מכאן מכל מכן מלבד מן מנין מסוגל מעט מעטים מעל מצד מקום בו מתחת מתי נגד נגר נו עד עז על עלי עליו עליה עליהם עליך עלינו עם עצמה עצמהם עצמהן עצמו עצמי עצמם עצמן עצמנו פה רק שוב של שלה שלהם שלהן שלו שלי שלך שלכה שלכם שלכן שלנו שם תהיה תחת".split(" ").indexOf(e.word)>=0)return!0},e.normalizeHebrewCharacters=function(){return e.word=e.word.replace("ך","כ"),e.word=e.word.replace("ם","מ"),e.word=e.word.replace("ן","נ"),e.word=e.word.replace("ף","פ"),e.word=e.word.replace("ץ","צ"),!1},function(r){return"function"==typeof r.update?r.update(function(r){return e.setCurrent(r),e.stem(),e.getCurrent()}):(e.setCurrent(r),e.stem(),e.getCurrent())}}(),e.Pipeline.registerFunction(e.he.stemmer,"stemmer-he"),e.he.stopWordFilter=e.generateStopWordFilter("אבל או אולי אותו אותי אותך אותם אותן אותנו אז אחר אחרות אחרי אחריכן אחרים אחרת אי איזה איך אין איפה אל אלה אלו אם אנחנו אני אף אפשר את אתה אתכם אתכן אתם אתן באיזה באיזו בגלל בין בלבד בעבור בעזרת בכל בכן בלי במידה במקום שבו ברוב בשביל בשעה ש בתוך גם דרך הוא היא היה היי היכן היתה היתי הם הן הנה הסיבה שבגללה הרי ואילו ואת זאת זה זות יהיה יוכל יוכלו יותר מדי יכול יכולה יכולות יכולים יכל יכלה יכלו יש כאן כאשר כולם כולן כזה כי כיצד כך כל כלל כמו כן כפי כש לא לאו לאיזותך לאן לבין לה להיות להם להן לו לזה לזות לי לך לכם לכן למה למעלה למעלה מ למטה למטה מ למעט למקום שבו למרות לנו לעבר לעיכן לפיכך לפני מאד מאחורי מאיזו סיבה מאין מאיפה מבלי מבעד מדוע מה מהיכן מול מחוץ מי מידע מכאן מכל מכן מלבד מן מנין מסוגל מעט מעטים מעל מצד מקום בו מתחת מתי נגד נגר נו עד עז על עלי עליו עליה עליהם עליך עלינו עם עצמה עצמהם עצמהן עצמו עצמי עצמם עצמן עצמנו פה רק שוב של שלה שלהם שלהן שלו שלי שלך שלכה שלכם שלכן שלנו שם תהיה תחת".split(" ")),e.Pipeline.registerFunction(e.he.stopWordFilter,"stopWordFilter-he")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.hi.min.js b/latest/assets/javascripts/lunr/min/lunr.hi.min.js
new file mode 100644
index 000000000..7dbc41402
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.hi.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hi=function(){this.pipeline.reset(),this.pipeline.add(e.hi.trimmer,e.hi.stopWordFilter,e.hi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hi.stemmer))},e.hi.wordCharacters="ऀ-ःऄ-एऐ-टठ-यर-िी-ॏॐ-य़ॠ-९॰-ॿa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.hi.trimmer=e.trimmerSupport.generateTrimmer(e.hi.wordCharacters),e.Pipeline.registerFunction(e.hi.trimmer,"trimmer-hi"),e.hi.stopWordFilter=e.generateStopWordFilter("अत अपना अपनी अपने अभी अंदर आदि आप इत्यादि इन इनका इन्हीं इन्हें इन्हों इस इसका इसकी इसके इसमें इसी इसे उन उनका उनकी उनके उनको उन्हीं उन्हें उन्हों उस उसके उसी उसे एक एवं एस ऐसे और कई कर करता करते करना करने करें कहते कहा का काफ़ी कि कितना किन्हें किन्हों किया किर किस किसी किसे की कुछ कुल के को कोई कौन कौनसा गया घर जब जहाँ जा जितना जिन जिन्हें जिन्हों जिस जिसे जीधर जैसा जैसे जो तक तब तरह तिन तिन्हें तिन्हों तिस तिसे तो था थी थे दबारा दिया दुसरा दूसरे दो द्वारा न नके नहीं ना निहायत नीचे ने पर पहले पूरा पे फिर बनी बही बहुत बाद बाला बिलकुल भी भीतर मगर मानो मे में यदि यह यहाँ यही या यिह ये रखें रहा रहे ऱ्वासा लिए लिये लेकिन व वग़ैरह वर्ग वह वहाँ वहीं वाले वुह वे वो सकता सकते सबसे सभी साथ साबुत साभ सारा से सो संग ही हुआ हुई हुए है हैं हो होता होती होते होना होने".split(" ")),e.hi.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var r=e.wordcut;r.init(),e.hi.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(r){return isLunr2?new e.Token(r.toLowerCase()):r.toLowerCase()});var t=i.toString().toLowerCase().replace(/^\s+/,"");return r.cut(t).split("|")},e.Pipeline.registerFunction(e.hi.stemmer,"stemmer-hi"),e.Pipeline.registerFunction(e.hi.stopWordFilter,"stopWordFilter-hi")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.hu.min.js b/latest/assets/javascripts/lunr/min/lunr.hu.min.js
new file mode 100644
index 000000000..ed9d909f7
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.hu.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Hungarian` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hu=function(){this.pipeline.reset(),this.pipeline.add(e.hu.trimmer,e.hu.stopWordFilter,e.hu.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hu.stemmer))},e.hu.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.hu.trimmer=e.trimmerSupport.generateTrimmer(e.hu.wordCharacters),e.Pipeline.registerFunction(e.hu.trimmer,"trimmer-hu"),e.hu.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,n=L.cursor;if(d=L.limit,L.in_grouping(W,97,252))for(;;){if(e=L.cursor,L.out_grouping(W,97,252))return L.cursor=e,L.find_among(g,8)||(L.cursor=e,e<L.limit&&L.cursor++),void(d=L.cursor);if(L.cursor=e,e>=L.limit)return void(d=e);L.cursor++}if(L.cursor=n,L.out_grouping(W,97,252)){for(;!L.in_grouping(W,97,252);){if(L.cursor>=L.limit)return;L.cursor++}d=L.cursor}}function i(){return d<=L.cursor}function a(){var e;if(L.ket=L.cursor,(e=L.find_among_b(h,2))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e")}}function t(){var e=L.limit-L.cursor;return!!L.find_among_b(p,23)&&(L.cursor=L.limit-e,!0)}function s(){if(L.cursor>L.limit_backward){L.cursor--,L.ket=L.cursor;var e=L.cursor-1;L.limit_backward<=e&&e<=L.limit&&(L.cursor=e,L.bra=e,L.slice_del())}}function c(){var e;if(L.ket=L.cursor,(e=L.find_among_b(_,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function o(){L.ket=L.cursor,L.find_among_b(v,44)&&(L.bra=L.cursor,i()&&(L.slice_del(),a()))}function w(){var e;if(L.ket=L.cursor,(e=L.find_among_b(z,3))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("e");break;case 2:case 3:L.slice_from("a")}}function l(){var e;if(L.ket=L.cursor,(e=L.find_among_b(y,6))&&(L.bra=L.cursor,i()))switch(e){case 1:case 2:L.slice_del();break;case 3:L.slice_from("a");break;case 4:L.slice_from("e")}}function u(){var e;if(L.ket=L.cursor,(e=L.find_among_b(j,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function m(){var e;if(L.ket=L.cursor,(e=L.find_among_b(C,7))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e");break;case 3:case 4:case 5:case 6:case 7:L.slice_del()}}function k(){var e;if(L.ket=L.cursor,(e=L.find_among_b(P,12))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 9:L.slice_del();break;case 2:case 5:case 8:L.slice_from("e");break;case 3:case 6:L.slice_from("a")}}function f(){var e;if(L.ket=L.cursor,(e=L.find_among_b(F,31))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 8:case 9:case 12:case 13:case 16:case 17:case 18:L.slice_del();break;case 2:case 5:case 10:case 14:case 19:L.slice_from("a");break;case 3:case 6:case 11:case 15:case 20:L.slice_from("e")}}function b(){var e;if(L.ket=L.cursor,(e=L.find_among_b(S,42))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 5:case 6:case 9:case 10:case 11:case 14:case 15:case 16:case 17:case 20:case 21:case 24:case 25:case 26:case 29:L.slice_del();break;case 2:case 7:case 12:case 18:case 22:case 27:L.slice_from("a");break;case 3:case 8:case 13:case 19:case 23:case 28:L.slice_from("e")}}var d,g=[new n("cs",-1,-1),new n("dzs",-1,-1),new n("gy",-1,-1),new n("ly",-1,-1),new n("ny",-1,-1),new n("sz",-1,-1),new n("ty",-1,-1),new n("zs",-1,-1)],h=[new n("á",-1,1),new n("é",-1,2)],p=[new n("bb",-1,-1),new n("cc",-1,-1),new n("dd",-1,-1),new n("ff",-1,-1),new n("gg",-1,-1),new n("jj",-1,-1),new n("kk",-1,-1),new n("ll",-1,-1),new n("mm",-1,-1),new n("nn",-1,-1),new n("pp",-1,-1),new n("rr",-1,-1),new n("ccs",-1,-1),new n("ss",-1,-1),new n("zzs",-1,-1),new n("tt",-1,-1),new n("vv",-1,-1),new n("ggy",-1,-1),new n("lly",-1,-1),new n("nny",-1,-1),new n("tty",-1,-1),new n("ssz",-1,-1),new n("zz",-1,-1)],_=[new n("al",-1,1),new n("el",-1,2)],v=[new n("ba",-1,-1),new n("ra",-1,-1),new n("be",-1,-1),new n("re",-1,-1),new n("ig",-1,-1),new n("nak",-1,-1),new n("nek",-1,-1),new n("val",-1,-1),new n("vel",-1,-1),new n("ul",-1,-1),new n("nál",-1,-1),new n("nél",-1,-1),new n("ból",-1,-1),new n("ról",-1,-1),new n("tól",-1,-1),new n("bõl",-1,-1),new n("rõl",-1,-1),new n("tõl",-1,-1),new n("ül",-1,-1),new n("n",-1,-1),new n("an",19,-1),new n("ban",20,-1),new n("en",19,-1),new n("ben",22,-1),new n("képpen",22,-1),new n("on",19,-1),new n("ön",19,-1),new n("képp",-1,-1),new n("kor",-1,-1),new n("t",-1,-1),new n("at",29,-1),new n("et",29,-1),new n("ként",29,-1),new n("anként",32,-1),new n("enként",32,-1),new n("onként",32,-1),new n("ot",29,-1),new n("ért",29,-1),new n("öt",29,-1),new n("hez",-1,-1),new n("hoz",-1,-1),new n("höz",-1,-1),new n("vá",-1,-1),new n("vé",-1,-1)],z=[new n("án",-1,2),new n("én",-1,1),new n("ánként",-1,3)],y=[new n("stul",-1,2),new n("astul",0,1),new n("ástul",0,3),new n("stül",-1,2),new n("estül",3,1),new n("éstül",3,4)],j=[new n("á",-1,1),new n("é",-1,2)],C=[new n("k",-1,7),new n("ak",0,4),new n("ek",0,6),new n("ok",0,5),new n("ák",0,1),new n("ék",0,2),new n("ök",0,3)],P=[new n("éi",-1,7),new n("áéi",0,6),new n("ééi",0,5),new n("é",-1,9),new n("ké",3,4),new n("aké",4,1),new n("eké",4,1),new n("oké",4,1),new n("áké",4,3),new n("éké",4,2),new n("öké",4,1),new n("éé",3,8)],F=[new n("a",-1,18),new n("ja",0,17),new n("d",-1,16),new n("ad",2,13),new n("ed",2,13),new n("od",2,13),new n("ád",2,14),new n("éd",2,15),new n("öd",2,13),new n("e",-1,18),new n("je",9,17),new n("nk",-1,4),new n("unk",11,1),new n("ánk",11,2),new n("énk",11,3),new n("ünk",11,1),new n("uk",-1,8),new n("juk",16,7),new n("ájuk",17,5),new n("ük",-1,8),new n("jük",19,7),new n("éjük",20,6),new n("m",-1,12),new n("am",22,9),new n("em",22,9),new n("om",22,9),new n("ám",22,10),new n("ém",22,11),new n("o",-1,18),new n("á",-1,19),new n("é",-1,20)],S=[new n("id",-1,10),new n("aid",0,9),new n("jaid",1,6),new n("eid",0,9),new n("jeid",3,6),new n("áid",0,7),new n("éid",0,8),new n("i",-1,15),new n("ai",7,14),new n("jai",8,11),new n("ei",7,14),new n("jei",10,11),new n("ái",7,12),new n("éi",7,13),new n("itek",-1,24),new n("eitek",14,21),new n("jeitek",15,20),new n("éitek",14,23),new n("ik",-1,29),new n("aik",18,26),new n("jaik",19,25),new n("eik",18,26),new n("jeik",21,25),new n("áik",18,27),new n("éik",18,28),new n("ink",-1,20),new n("aink",25,17),new n("jaink",26,16),new n("eink",25,17),new n("jeink",28,16),new n("áink",25,18),new n("éink",25,19),new n("aitok",-1,21),new n("jaitok",32,20),new n("áitok",-1,22),new n("im",-1,5),new n("aim",35,4),new n("jaim",36,1),new n("eim",35,4),new n("jeim",38,1),new n("áim",35,2),new n("éim",35,3)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,52,14],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var n=L.cursor;return e(),L.limit_backward=n,L.cursor=L.limit,c(),L.cursor=L.limit,o(),L.cursor=L.limit,w(),L.cursor=L.limit,l(),L.cursor=L.limit,u(),L.cursor=L.limit,k(),L.cursor=L.limit,f(),L.cursor=L.limit,b(),L.cursor=L.limit,m(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.hu.stemmer,"stemmer-hu"),e.hu.stopWordFilter=e.generateStopWordFilter("a abban ahhoz ahogy ahol aki akik akkor alatt amely amelyek amelyekben amelyeket amelyet amelynek ami amikor amit amolyan amíg annak arra arról az azok azon azonban azt aztán azután azzal azért be belül benne bár cikk cikkek cikkeket csak de e ebben eddig egy egyes egyetlen egyik egyre egyéb egész ehhez ekkor el ellen elsõ elég elõ elõször elõtt emilyen ennek erre ez ezek ezen ezt ezzel ezért fel felé hanem hiszen hogy hogyan igen ill ill. illetve ilyen ilyenkor ismét ison itt jobban jó jól kell kellett keressünk keresztül ki kívül között közül legalább legyen lehet lehetett lenne lenni lesz lett maga magát majd majd meg mellett mely melyek mert mi mikor milyen minden mindenki mindent mindig mint mintha mit mivel miért most már más másik még míg nagy nagyobb nagyon ne nekem neki nem nincs néha néhány nélkül olyan ott pedig persze rá s saját sem semmi sok sokat sokkal szemben szerint szinte számára talán tehát teljes tovább továbbá több ugyanis utolsó után utána vagy vagyis vagyok valaki valami valamint való van vannak vele vissza viszont volna volt voltak voltam voltunk által általában át én éppen és így õ õk õket össze úgy új újabb újra".split(" ")),e.Pipeline.registerFunction(e.hu.stopWordFilter,"stopWordFilter-hu")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.hy.min.js b/latest/assets/javascripts/lunr/min/lunr.hy.min.js
new file mode 100644
index 000000000..b37f79298
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.hy.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hy=function(){this.pipeline.reset(),this.pipeline.add(e.hy.trimmer,e.hy.stopWordFilter)},e.hy.wordCharacters="[A-Za-z԰-֏ff-ﭏ]",e.hy.trimmer=e.trimmerSupport.generateTrimmer(e.hy.wordCharacters),e.Pipeline.registerFunction(e.hy.trimmer,"trimmer-hy"),e.hy.stopWordFilter=e.generateStopWordFilter("դու և եք էիր էիք հետո նաև նրանք որը վրա է որ պիտի են այս մեջ ն իր ու ի այդ որոնք այն կամ էր մի ես համար այլ իսկ էին ենք հետ ին թ էինք մենք նրա նա դուք եմ էի ըստ որպես ում".split(" ")),e.Pipeline.registerFunction(e.hy.stopWordFilter,"stopWordFilter-hy"),e.hy.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}(),e.Pipeline.registerFunction(e.hy.stemmer,"stemmer-hy")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.it.min.js b/latest/assets/javascripts/lunr/min/lunr.it.min.js
new file mode 100644
index 000000000..344b6a3c0
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.it.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Italian` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.it=function(){this.pipeline.reset(),this.pipeline.add(e.it.trimmer,e.it.stopWordFilter,e.it.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.it.stemmer))},e.it.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.it.trimmer=e.trimmerSupport.generateTrimmer(e.it.wordCharacters),e.Pipeline.registerFunction(e.it.trimmer,"trimmer-it"),e.it.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!x.eq_s(1,e)||(x.ket=x.cursor,!x.in_grouping(L,97,249)))&&(x.slice_from(r),x.cursor=n,!0)}function i(){for(var r,n,i,o,t=x.cursor;;){if(x.bra=x.cursor,r=x.find_among(h,7))switch(x.ket=x.cursor,r){case 1:x.slice_from("à");continue;case 2:x.slice_from("è");continue;case 3:x.slice_from("ì");continue;case 4:x.slice_from("ò");continue;case 5:x.slice_from("ù");continue;case 6:x.slice_from("qU");continue;case 7:if(x.cursor>=x.limit)break;x.cursor++;continue}break}for(x.cursor=t;;)for(n=x.cursor;;){if(i=x.cursor,x.in_grouping(L,97,249)){if(x.bra=x.cursor,o=x.cursor,e("u","U",i))break;if(x.cursor=o,e("i","I",i))break}if(x.cursor=i,x.cursor>=x.limit)return void(x.cursor=n);x.cursor++}}function o(e){if(x.cursor=e,!x.in_grouping(L,97,249))return!1;for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function t(){if(x.in_grouping(L,97,249)){var e=x.cursor;if(x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return o(e);x.cursor++}return!0}return o(e)}return!1}function s(){var e,r=x.cursor;if(!t()){if(x.cursor=r,!x.out_grouping(L,97,249))return;if(e=x.cursor,x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return x.cursor=e,void(x.in_grouping(L,97,249)&&x.cursor<x.limit&&x.cursor++);x.cursor++}return void(k=x.cursor)}if(x.cursor=e,!x.in_grouping(L,97,249)||x.cursor>=x.limit)return;x.cursor++}k=x.cursor}function a(){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function u(){var e=x.cursor;k=x.limit,p=k,g=k,s(),x.cursor=e,a()&&(p=x.cursor,a()&&(g=x.cursor))}function c(){for(var e;;){if(x.bra=x.cursor,!(e=x.find_among(q,3)))break;switch(x.ket=x.cursor,e){case 1:x.slice_from("i");break;case 2:x.slice_from("u");break;case 3:if(x.cursor>=x.limit)return;x.cursor++}}}function w(){return k<=x.cursor}function l(){return p<=x.cursor}function m(){return g<=x.cursor}function f(){var e;if(x.ket=x.cursor,x.find_among_b(C,37)&&(x.bra=x.cursor,(e=x.find_among_b(z,5))&&w()))switch(e){case 1:x.slice_del();break;case 2:x.slice_from("e")}}function v(){var e;if(x.ket=x.cursor,!(e=x.find_among_b(S,51)))return!1;switch(x.bra=x.cursor,e){case 1:if(!m())return!1;x.slice_del();break;case 2:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del());break;case 3:if(!m())return!1;x.slice_from("log");break;case 4:if(!m())return!1;x.slice_from("u");break;case 5:if(!m())return!1;x.slice_from("ente");break;case 6:if(!w())return!1;x.slice_del();break;case 7:if(!l())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(P,4),e&&(x.bra=x.cursor,m()&&(x.slice_del(),1==e&&(x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&x.slice_del()))));break;case 8:if(!m())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(F,3),e&&(x.bra=x.cursor,1==e&&m()&&x.slice_del());break;case 9:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del())))}return!0}function b(){var e,r;x.cursor>=k&&(r=x.limit_backward,x.limit_backward=k,x.ket=x.cursor,e=x.find_among_b(W,87),e&&(x.bra=x.cursor,1==e&&x.slice_del()),x.limit_backward=r)}function d(){var e=x.limit-x.cursor;if(x.ket=x.cursor,x.in_grouping_b(y,97,242)&&(x.bra=x.cursor,w()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(1,"i")&&(x.bra=x.cursor,w()))))return void x.slice_del();x.cursor=x.limit-e}function _(){d(),x.ket=x.cursor,x.eq_s_b(1,"h")&&(x.bra=x.cursor,x.in_grouping_b(U,99,103)&&w()&&x.slice_del())}var g,p,k,h=[new r("",-1,7),new r("qu",0,6),new r("á",0,1),new r("é",0,2),new r("í",0,3),new r("ó",0,4),new r("ú",0,5)],q=[new r("",-1,3),new r("I",0,1),new r("U",0,2)],C=[new r("la",-1,-1),new r("cela",0,-1),new r("gliela",0,-1),new r("mela",0,-1),new r("tela",0,-1),new r("vela",0,-1),new r("le",-1,-1),new r("cele",6,-1),new r("gliele",6,-1),new r("mele",6,-1),new r("tele",6,-1),new r("vele",6,-1),new r("ne",-1,-1),new r("cene",12,-1),new r("gliene",12,-1),new r("mene",12,-1),new r("sene",12,-1),new r("tene",12,-1),new r("vene",12,-1),new r("ci",-1,-1),new r("li",-1,-1),new r("celi",20,-1),new r("glieli",20,-1),new r("meli",20,-1),new r("teli",20,-1),new r("veli",20,-1),new r("gli",20,-1),new r("mi",-1,-1),new r("si",-1,-1),new r("ti",-1,-1),new r("vi",-1,-1),new r("lo",-1,-1),new r("celo",31,-1),new r("glielo",31,-1),new r("melo",31,-1),new r("telo",31,-1),new r("velo",31,-1)],z=[new r("ando",-1,1),new r("endo",-1,1),new r("ar",-1,2),new r("er",-1,2),new r("ir",-1,2)],P=[new r("ic",-1,-1),new r("abil",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],F=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],S=[new r("ica",-1,1),new r("logia",-1,3),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,9),new r("anza",-1,1),new r("enza",-1,5),new r("ice",-1,1),new r("atrice",7,1),new r("iche",-1,1),new r("logie",-1,3),new r("abile",-1,1),new r("ibile",-1,1),new r("usione",-1,4),new r("azione",-1,2),new r("uzione",-1,4),new r("atore",-1,2),new r("ose",-1,1),new r("ante",-1,1),new r("mente",-1,1),new r("amente",19,7),new r("iste",-1,1),new r("ive",-1,9),new r("anze",-1,1),new r("enze",-1,5),new r("ici",-1,1),new r("atrici",25,1),new r("ichi",-1,1),new r("abili",-1,1),new r("ibili",-1,1),new r("ismi",-1,1),new r("usioni",-1,4),new r("azioni",-1,2),new r("uzioni",-1,4),new r("atori",-1,2),new r("osi",-1,1),new r("anti",-1,1),new r("amenti",-1,6),new r("imenti",-1,6),new r("isti",-1,1),new r("ivi",-1,9),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,6),new r("imento",-1,6),new r("ivo",-1,9),new r("ità",-1,8),new r("istà",-1,1),new r("istè",-1,1),new r("istì",-1,1)],W=[new r("isca",-1,1),new r("enda",-1,1),new r("ata",-1,1),new r("ita",-1,1),new r("uta",-1,1),new r("ava",-1,1),new r("eva",-1,1),new r("iva",-1,1),new r("erebbe",-1,1),new r("irebbe",-1,1),new r("isce",-1,1),new r("ende",-1,1),new r("are",-1,1),new r("ere",-1,1),new r("ire",-1,1),new r("asse",-1,1),new r("ate",-1,1),new r("avate",16,1),new r("evate",16,1),new r("ivate",16,1),new r("ete",-1,1),new r("erete",20,1),new r("irete",20,1),new r("ite",-1,1),new r("ereste",-1,1),new r("ireste",-1,1),new r("ute",-1,1),new r("erai",-1,1),new r("irai",-1,1),new r("isci",-1,1),new r("endi",-1,1),new r("erei",-1,1),new r("irei",-1,1),new r("assi",-1,1),new r("ati",-1,1),new r("iti",-1,1),new r("eresti",-1,1),new r("iresti",-1,1),new r("uti",-1,1),new r("avi",-1,1),new r("evi",-1,1),new r("ivi",-1,1),new r("isco",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("Yamo",-1,1),new r("iamo",-1,1),new r("avamo",-1,1),new r("evamo",-1,1),new r("ivamo",-1,1),new r("eremo",-1,1),new r("iremo",-1,1),new r("assimo",-1,1),new r("ammo",-1,1),new r("emmo",-1,1),new r("eremmo",54,1),new r("iremmo",54,1),new r("immo",-1,1),new r("ano",-1,1),new r("iscano",58,1),new r("avano",58,1),new r("evano",58,1),new r("ivano",58,1),new r("eranno",-1,1),new r("iranno",-1,1),new r("ono",-1,1),new r("iscono",65,1),new r("arono",65,1),new r("erono",65,1),new r("irono",65,1),new r("erebbero",-1,1),new r("irebbero",-1,1),new r("assero",-1,1),new r("essero",-1,1),new r("issero",-1,1),new r("ato",-1,1),new r("ito",-1,1),new r("uto",-1,1),new r("avo",-1,1),new r("evo",-1,1),new r("ivo",-1,1),new r("ar",-1,1),new r("ir",-1,1),new r("erà",-1,1),new r("irà",-1,1),new r("erò",-1,1),new r("irò",-1,1)],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2,1],y=[17,65,0,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2],U=[17],x=new n;this.setCurrent=function(e){x.setCurrent(e)},this.getCurrent=function(){return x.getCurrent()},this.stem=function(){var e=x.cursor;return i(),x.cursor=e,u(),x.limit_backward=e,x.cursor=x.limit,f(),x.cursor=x.limit,v()||(x.cursor=x.limit,b()),x.cursor=x.limit,_(),x.cursor=x.limit_backward,c(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.it.stemmer,"stemmer-it"),e.it.stopWordFilter=e.generateStopWordFilter("a abbia abbiamo abbiano abbiate ad agl agli ai al all alla alle allo anche avemmo avendo avesse avessero avessi avessimo aveste avesti avete aveva avevamo avevano avevate avevi avevo avrai avranno avrebbe avrebbero avrei avremmo avremo avreste avresti avrete avrà avrò avuta avute avuti avuto c che chi ci coi col come con contro cui da dagl dagli dai dal dall dalla dalle dallo degl degli dei del dell della delle dello di dov dove e ebbe ebbero ebbi ed era erano eravamo eravate eri ero essendo faccia facciamo facciano facciate faccio facemmo facendo facesse facessero facessi facessimo faceste facesti faceva facevamo facevano facevate facevi facevo fai fanno farai faranno farebbe farebbero farei faremmo faremo fareste faresti farete farà farò fece fecero feci fosse fossero fossi fossimo foste fosti fu fui fummo furono gli ha hai hanno ho i il in io l la le lei li lo loro lui ma mi mia mie miei mio ne negl negli nei nel nell nella nelle nello noi non nostra nostre nostri nostro o per perché più quale quanta quante quanti quanto quella quelle quelli quello questa queste questi questo sarai saranno sarebbe sarebbero sarei saremmo saremo sareste saresti sarete sarà sarò se sei si sia siamo siano siate siete sono sta stai stando stanno starai staranno starebbe starebbero starei staremmo staremo stareste staresti starete starà starò stava stavamo stavano stavate stavi stavo stemmo stesse stessero stessi stessimo steste stesti stette stettero stetti stia stiamo stiano stiate sto su sua sue sugl sugli sui sul sull sulla sulle sullo suo suoi ti tra tu tua tue tuo tuoi tutti tutto un una uno vi voi vostra vostre vostri vostro è".split(" ")),e.Pipeline.registerFunction(e.it.stopWordFilter,"stopWordFilter-it")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.ja.min.js b/latest/assets/javascripts/lunr/min/lunr.ja.min.js
new file mode 100644
index 000000000..5f254ebe9
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.ja.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.ja=function(){this.pipeline.reset(),this.pipeline.add(e.ja.trimmer,e.ja.stopWordFilter,e.ja.stemmer),r?this.tokenizer=e.ja.tokenizer:(e.tokenizer&&(e.tokenizer=e.ja.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.ja.tokenizer))};var t=new e.TinySegmenter;e.ja.tokenizer=function(i){var n,o,s,p,a,u,m,l,c,f;if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t.toLowerCase()):t.toLowerCase()});for(o=i.toString().toLowerCase().replace(/^\s+/,""),n=o.length-1;n>=0;n--)if(/\S/.test(o.charAt(n))){o=o.substring(0,n+1);break}for(a=[],s=o.length,c=0,l=0;c<=s;c++)if(u=o.charAt(c),m=c-l,u.match(/\s/)||c==s){if(m>0)for(p=t.segment(o.slice(l,c)).filter(function(e){return!!e}),f=l,n=0;n<p.length;n++)r?a.push(new e.Token(p[n],{position:[f,p[n].length],index:a.length})):a.push(p[n]),f+=p[n].length;l=c+1}return a},e.ja.stemmer=function(){return function(e){return e}}(),e.Pipeline.registerFunction(e.ja.stemmer,"stemmer-ja"),e.ja.wordCharacters="一二三四五六七八九十百千万億兆一-龠々〆ヵヶぁ-んァ-ヴーｱ-ﾝﾞa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.ja.trimmer=e.trimmerSupport.generateTrimmer(e.ja.wordCharacters),e.Pipeline.registerFunction(e.ja.trimmer,"trimmer-ja"),e.ja.stopWordFilter=e.generateStopWordFilter("これ それ あれ この その あの ここ そこ あそこ こちら どこ だれ なに なん 何 私 貴方 貴方方 我々 私達 あの人 あのかた 彼女 彼 です あります おります います は が の に を で え から まで より も どの と し それで しかし".split(" ")),e.Pipeline.registerFunction(e.ja.stopWordFilter,"stopWordFilter-ja"),e.jp=e.ja,e.Pipeline.registerFunction(e.jp.stemmer,"stemmer-jp"),e.Pipeline.registerFunction(e.jp.trimmer,"trimmer-jp"),e.Pipeline.registerFunction(e.jp.stopWordFilter,"stopWordFilter-jp")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.jp.min.js b/latest/assets/javascripts/lunr/min/lunr.jp.min.js
new file mode 100644
index 000000000..c055ebaf3
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.jp.min.js
@@ -0,0 +1 @@
+module.exports=require("./lunr.ja");
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.kn.min.js b/latest/assets/javascripts/lunr/min/lunr.kn.min.js
new file mode 100644
index 000000000..1cef9befd
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.kn.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.kn=function(){this.pipeline.reset(),this.pipeline.add(e.kn.trimmer,e.kn.stopWordFilter,e.kn.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.kn.stemmer))},e.kn.wordCharacters="ಀ-಄ಅ-ಔಕ-ಹಾ-ೌ಼-ಽೕ-ೖೝ-ೞೠ-ೡೢ-ೣ೤೥೦-೯ೱ-ೳ",e.kn.trimmer=e.trimmerSupport.generateTrimmer(e.kn.wordCharacters),e.Pipeline.registerFunction(e.kn.trimmer,"trimmer-kn"),e.kn.stopWordFilter=e.generateStopWordFilter("ಮತ್ತು ಈ ಒಂದು ರಲ್ಲಿ ಹಾಗೂ ಎಂದು ಅಥವಾ ಇದು ರ ಅವರು ಎಂಬ ಮೇಲೆ ಅವರ ತನ್ನ ಆದರೆ ತಮ್ಮ ನಂತರ ಮೂಲಕ ಹೆಚ್ಚು ನ ಆ ಕೆಲವು ಅನೇಕ ಎರಡು ಹಾಗು ಪ್ರಮುಖ ಇದನ್ನು ಇದರ ಸುಮಾರು ಅದರ ಅದು ಮೊದಲ ಬಗ್ಗೆ ನಲ್ಲಿ ರಂದು ಇತರ ಅತ್ಯಂತ ಹೆಚ್ಚಿನ ಸಹ ಸಾಮಾನ್ಯವಾಗಿ ನೇ ಹಲವಾರು ಹೊಸ ದಿ ಕಡಿಮೆ ಯಾವುದೇ ಹೊಂದಿದೆ ದೊಡ್ಡ ಅನ್ನು ಇವರು ಪ್ರಕಾರ ಇದೆ ಮಾತ್ರ ಕೂಡ ಇಲ್ಲಿ ಎಲ್ಲಾ ವಿವಿಧ ಅದನ್ನು ಹಲವು ರಿಂದ ಕೇವಲ ದ ದಕ್ಷಿಣ ಗೆ ಅವನ ಅತಿ ನೆಯ ಬಹಳ ಕೆಲಸ ಎಲ್ಲ ಪ್ರತಿ ಇತ್ಯಾದಿ ಇವು ಬೇರೆ ಹೀಗೆ ನಡುವೆ ಇದಕ್ಕೆ ಎಸ್ ಇವರ ಮೊದಲು ಶ್ರೀ ಮಾಡುವ ಇದರಲ್ಲಿ ರೀತಿಯ ಮಾಡಿದ ಕಾಲ ಅಲ್ಲಿ ಮಾಡಲು ಅದೇ ಈಗ ಅವು ಗಳು ಎ ಎಂಬುದು ಅವನು ಅಂದರೆ ಅವರಿಗೆ ಇರುವ ವಿಶೇಷ ಮುಂದೆ ಅವುಗಳ ಮುಂತಾದ ಮೂಲ ಬಿ ಮೀ ಒಂದೇ ಇನ್ನೂ ಹೆಚ್ಚಾಗಿ ಮಾಡಿ ಅವರನ್ನು ಇದೇ ಯ ರೀತಿಯಲ್ಲಿ ಜೊತೆ ಅದರಲ್ಲಿ ಮಾಡಿದರು ನಡೆದ ಆಗ ಮತ್ತೆ ಪೂರ್ವ ಆತ ಬಂದ ಯಾವ ಒಟ್ಟು ಇತರೆ ಹಿಂದೆ ಪ್ರಮಾಣದ ಗಳನ್ನು ಕುರಿತು ಯು ಆದ್ದರಿಂದ ಅಲ್ಲದೆ ನಗರದ ಮೇಲಿನ ಏಕೆಂದರೆ ರಷ್ಟು ಎಂಬುದನ್ನು ಬಾರಿ ಎಂದರೆ ಹಿಂದಿನ ಆದರೂ ಆದ ಸಂಬಂಧಿಸಿದ ಮತ್ತೊಂದು ಸಿ ಆತನ ".split(" ")),e.kn.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var r=e.wordcut;r.init(),e.kn.tokenizer=function(t){if(!arguments.length||null==t||void 0==t)return[];if(Array.isArray(t))return t.map(function(r){return isLunr2?new e.Token(r.toLowerCase()):r.toLowerCase()});var n=t.toString().toLowerCase().replace(/^\s+/,"");return r.cut(n).split("|")},e.Pipeline.registerFunction(e.kn.stemmer,"stemmer-kn"),e.Pipeline.registerFunction(e.kn.stopWordFilter,"stopWordFilter-kn")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.ko.min.js b/latest/assets/javascripts/lunr/min/lunr.ko.min.js
new file mode 100644
index 000000000..eaf9dabf7
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.ko.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ko=function(){this.pipeline.reset(),this.pipeline.add(e.ko.trimmer,e.ko.stopWordFilter)},e.ko.wordCharacters="[A-Za-z가-힣]",e.ko.trimmer=e.trimmerSupport.generateTrimmer(e.ko.wordCharacters),e.Pipeline.registerFunction(e.ko.trimmer,"trimmer-ko"),e.ko.stopWordFilter=e.generateStopWordFilter("아 휴 아이구 아이쿠 아이고 어 나 우리 저희 따라 의해 을 를 에 의 가 으로 로 에게 뿐이다 의거하여 근거하여 입각하여 기준으로 예하면 예를 들면 예를 들자면 저 소인 소생 저희 지말고 하지마 하지마라 다른 물론 또한 그리고 비길수 없다 해서는 안된다 뿐만 아니라 만이 아니다 만은 아니다 막론하고 관계없이 그치지 않다 그러나 그런데 하지만 든간에 논하지 않다 따지지 않다 설사 비록 더라도 아니면 만 못하다 하는 편이 낫다 불문하고 향하여 향해서 향하다 쪽으로 틈타 이용하여 타다 오르다 제외하고 이 외에 이 밖에 하여야 비로소 한다면 몰라도 외에도 이곳 여기 부터 기점으로 따라서 할 생각이다 하려고하다 이리하여 그리하여 그렇게 함으로써 하지만 일때 할때 앞에서 중에서 보는데서 으로써 로써 까지 해야한다 일것이다 반드시 할줄알다 할수있다 할수있어 임에 틀림없다 한다면 등 등등 제 겨우 단지 다만 할뿐 딩동 댕그 대해서 대하여 대하면 훨씬 얼마나 얼마만큼 얼마큼 남짓 여 얼마간 약간 다소 좀 조금 다수 몇 얼마 지만 하물며 또한 그러나 그렇지만 하지만 이외에도 대해 말하자면 뿐이다 다음에 반대로 반대로 말하자면 이와 반대로 바꾸어서 말하면 바꾸어서 한다면 만약 그렇지않으면 까악 툭 딱 삐걱거리다 보드득 비걱거리다 꽈당 응당 해야한다 에 가서 각 각각 여러분 각종 각자 제각기 하도록하다 와 과 그러므로 그래서 고로 한 까닭에 하기 때문에 거니와 이지만 대하여 관하여 관한 과연 실로 아니나다를가 생각한대로 진짜로 한적이있다 하곤하였다 하 하하 허허 아하 거바 와 오 왜 어째서 무엇때문에 어찌 하겠는가 무슨 어디 어느곳 더군다나 하물며 더욱이는 어느때 언제 야 이봐 어이 여보시오 흐흐 흥 휴 헉헉 헐떡헐떡 영차 여차 어기여차 끙끙 아야 앗 아야 콸콸 졸졸 좍좍 뚝뚝 주룩주룩 솨 우르르 그래도 또 그리고 바꾸어말하면 바꾸어말하자면 혹은 혹시 답다 및 그에 따르는 때가 되어 즉 지든지 설령 가령 하더라도 할지라도 일지라도 지든지 몇 거의 하마터면 인젠 이젠 된바에야 된이상 만큼\t어찌됏든 그위에 게다가 점에서 보아 비추어 보아 고려하면 하게될것이다 일것이다 비교적 좀 보다더 비하면 시키다 하게하다 할만하다 의해서 연이서 이어서 잇따라 뒤따라 뒤이어 결국 의지하여 기대여 통하여 자마자 더욱더 불구하고 얼마든지 마음대로 주저하지 않고 곧 즉시 바로 당장 하자마자 밖에 안된다 하면된다 그래 그렇지 요컨대 다시 말하자면 바꿔 말하면 즉 구체적으로 말하자면 시작하여 시초에 이상 허 헉 허걱 바와같이 해도좋다 해도된다 게다가 더구나 하물며 와르르 팍 퍽 펄렁 동안 이래 하고있었다 이었다 에서 로부터 까지 예하면 했어요 해요 함께 같이 더불어 마저 마저도 양자 모두 습니다 가까스로 하려고하다 즈음하여 다른 다른 방면으로 해봐요 습니까 했어요 말할것도 없고 무릎쓰고 개의치않고 하는것만 못하다 하는것이 낫다 매 매번 들 모 어느것 어느 로써 갖고말하자면 어디 어느쪽 어느것 어느해 어느 년도 라 해도 언젠가 어떤것 어느것 저기 저쪽 저것 그때 그럼 그러면 요만한걸 그래 그때 저것만큼 그저 이르기까지 할 줄 안다 할 힘이 있다 너 너희 당신 어찌 설마 차라리 할지언정 할지라도 할망정 할지언정 구토하다 게우다 토하다 메쓰겁다 옆사람 퉤 쳇 의거하여 근거하여 의해 따라 힘입어 그 다음 버금 두번째로 기타 첫번째로 나머지는 그중에서 견지에서 형식으로 쓰여 입장에서 위해서 단지 의해되다 하도록시키다 뿐만아니라 반대로 전후 전자 앞의것 잠시 잠깐 하면서 그렇지만 다음에 그러한즉 그런즉 남들 아무거나 어찌하든지 같다 비슷하다 예컨대 이럴정도로 어떻게 만약 만일 위에서 서술한바와같이 인 듯하다 하지 않는다면 만약에 무엇 무슨 어느 어떤 아래윗 조차 한데 그럼에도 불구하고 여전히 심지어 까지도 조차도 하지 않도록 않기 위하여 때 시각 무렵 시간 동안 어때 어떠한 하여금 네 예 우선 누구 누가 알겠는가 아무도 줄은모른다 줄은 몰랏다 하는 김에 겸사겸사 하는바 그런 까닭에 한 이유는 그러니 그러니까 때문에 그 너희 그들 너희들 타인 것 것들 너 위하여 공동으로 동시에 하기 위하여 어찌하여 무엇때문에 붕붕 윙윙 나 우리 엉엉 휘익 윙윙 오호 아하 어쨋든 만 못하다\t하기보다는 차라리 하는 편이 낫다 흐흐 놀라다 상대적으로 말하자면 마치 아니라면 쉿 그렇지 않으면 그렇지 않다면 안 그러면 아니었다면 하든지 아니면 이라면 좋아 알았어 하는것도 그만이다 어쩔수 없다 하나 일 일반적으로 일단 한켠으로는 오자마자 이렇게되면 이와같다면 전부 한마디 한항목 근거로 하기에 아울러 하지 않도록 않기 위해서 이르기까지 이 되다 로 인하여 까닭으로 이유만으로 이로 인하여 그래서 이 때문에 그러므로 그런 까닭에 알 수 있다 결론을 낼 수 있다 으로 인하여 있다 어떤것 관계가 있다 관련이 있다 연관되다 어떤것들 에 대해 이리하여 그리하여 여부 하기보다는 하느니 하면 할수록 운운 이러이러하다 하구나 하도다 다시말하면 다음으로 에 있다 에 달려 있다 우리 우리들 오히려 하기는한데 어떻게 어떻해 어찌됏어 어때 어째서 본대로 자 이 이쪽 여기 이것 이번 이렇게말하자면 이런 이러한 이와 같은 요만큼 요만한 것 얼마 안 되는 것 이만큼 이 정도의 이렇게 많은 것 이와 같다 이때 이렇구나 것과 같이 끼익 삐걱 따위 와 같은 사람들 부류의 사람들 왜냐하면 중의하나 오직 오로지 에 한하다 하기만 하면 도착하다 까지 미치다 도달하다 정도에 이르다 할 지경이다 결과에 이르다 관해서는 여러분 하고 있다 한 후 혼자 자기 자기집 자신 우에 종합한것과같이 총적으로 보면 총적으로 말하면 총적으로 대로 하다 으로서 참 그만이다 할 따름이다 쿵 탕탕 쾅쾅 둥둥 봐 봐라 아이야 아니 와아 응 아이 참나 년 월 일 령 영 일 이 삼 사 오 육 륙 칠 팔 구 이천육 이천칠 이천팔 이천구 하나 둘 셋 넷 다섯 여섯 일곱 여덟 아홉 령 영".split(" ")),e.Pipeline.registerFunction(e.ko.stopWordFilter,"stopWordFilter-ko"),e.ko.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}(),e.Pipeline.registerFunction(e.ko.stemmer,"stemmer-ko")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.multi.min.js b/latest/assets/javascripts/lunr/min/lunr.multi.min.js
new file mode 100644
index 000000000..7debad096
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.multi.min.js
@@ -0,0 +1 @@
+!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){e.multiLanguage=function(){for(var t=Array.prototype.slice.call(arguments),i=t.join("-"),r="",n=[],s=[],p=0;p<t.length;++p)"en"==t[p]?(r+="\\w",n.unshift(e.stopWordFilter),n.push(e.stemmer),s.push(e.stemmer)):(r+=e[t[p]].wordCharacters,e[t[p]].stopWordFilter&&n.unshift(e[t[p]].stopWordFilter),e[t[p]].stemmer&&(n.push(e[t[p]].stemmer),s.push(e[t[p]].stemmer)));var o=e.trimmerSupport.generateTrimmer(r);return e.Pipeline.registerFunction(o,"lunr-multi-trimmer-"+i),n.unshift(o),function(){this.pipeline.reset(),this.pipeline.add.apply(this.pipeline,n),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add.apply(this.searchPipeline,s))}}}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.nl.min.js b/latest/assets/javascripts/lunr/min/lunr.nl.min.js
new file mode 100644
index 000000000..c4a253594
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.nl.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Dutch` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(r,e){"function"==typeof define&&define.amd?define(e):"object"==typeof exports?module.exports=e():e()(r.lunr)}(this,function(){return function(r){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");r.nl=function(){this.pipeline.reset(),this.pipeline.add(r.nl.trimmer,r.nl.stopWordFilter,r.nl.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(r.nl.stemmer))},r.nl.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",r.nl.trimmer=r.trimmerSupport.generateTrimmer(r.nl.wordCharacters),r.Pipeline.registerFunction(r.nl.trimmer,"trimmer-nl"),r.nl.stemmer=function(){var e=r.stemmerSupport.Among,i=r.stemmerSupport.SnowballProgram,n=new function(){function r(){for(var r,e,i,o=C.cursor;;){if(C.bra=C.cursor,r=C.find_among(b,11))switch(C.ket=C.cursor,r){case 1:C.slice_from("a");continue;case 2:C.slice_from("e");continue;case 3:C.slice_from("i");continue;case 4:C.slice_from("o");continue;case 5:C.slice_from("u");continue;case 6:if(C.cursor>=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(e=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=e);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=e;else if(n(e))break}else if(n(e))break}function n(r){return C.cursor=r,r>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,d=_,t()||(_=C.cursor,_<3&&(_=3),t()||(d=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var r;;)if(C.bra=C.cursor,r=C.find_among(p,3))switch(C.ket=C.cursor,r){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return d<=C.cursor}function a(){var r=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-r,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var r;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.slice_del(),w=!0,a())))}function m(){var r;u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.eq_s_b(3,"gem")||(C.cursor=C.limit-r,C.slice_del(),a())))}function f(){var r,e,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,r=C.find_among_b(h,5))switch(C.bra=C.cursor,r){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(j,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(e=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-e,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,r=C.find_among_b(k,6))switch(C.bra=C.cursor,r){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(z,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var d,_,w,b=[new e("",-1,6),new e("á",0,1),new e("ä",0,1),new e("é",0,2),new e("ë",0,2),new e("í",0,3),new e("ï",0,3),new e("ó",0,4),new e("ö",0,4),new e("ú",0,5),new e("ü",0,5)],p=[new e("",-1,3),new e("I",0,2),new e("Y",0,1)],g=[new e("dd",-1,-1),new e("kk",-1,-1),new e("tt",-1,-1)],h=[new e("ene",-1,2),new e("se",-1,3),new e("en",-1,2),new e("heden",2,1),new e("s",-1,3)],k=[new e("end",-1,1),new e("ig",-1,2),new e("ing",-1,1),new e("lijk",-1,3),new e("baar",-1,4),new e("bar",-1,5)],v=[new e("aa",-1,-1),new e("ee",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(r){C.setCurrent(r)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var e=C.cursor;return r(),C.cursor=e,o(),C.limit_backward=e,C.cursor=C.limit,f(),C.cursor=C.limit_backward,s(),!0}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.nl.stemmer,"stemmer-nl"),r.nl.stopWordFilter=r.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),r.Pipeline.registerFunction(r.nl.stopWordFilter,"stopWordFilter-nl")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.no.min.js b/latest/assets/javascripts/lunr/min/lunr.no.min.js
new file mode 100644
index 000000000..92bc7e4e8
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.no.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Norwegian` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.no=function(){this.pipeline.reset(),this.pipeline.add(e.no.trimmer,e.no.stopWordFilter,e.no.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.no.stemmer))},e.no.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.no.trimmer=e.trimmerSupport.generateTrimmer(e.no.wordCharacters),e.Pipeline.registerFunction(e.no.trimmer,"trimmer-no"),e.no.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,r=w.cursor+3;if(a=w.limit,0<=r||r<=w.limit){for(s=r;;){if(e=w.cursor,w.in_grouping(d,97,248)){w.cursor=e;break}if(e>=w.limit)return;w.cursor=e+1}for(;!w.out_grouping(d,97,248);){if(w.cursor>=w.limit)return;w.cursor++}a=w.cursor,a<s&&(a=s)}}function i(){var e,r,n;if(w.cursor>=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(m,29),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:n=w.limit-w.cursor,w.in_grouping_b(c,98,122)?w.slice_del():(w.cursor=w.limit-n,w.eq_s_b(1,"k")&&w.out_grouping_b(d,97,248)&&w.slice_del());break;case 3:w.slice_from("er")}}function t(){var e,r=w.limit-w.cursor;w.cursor>=a&&(e=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,w.find_among_b(u,2)?(w.bra=w.cursor,w.limit_backward=e,w.cursor=w.limit-r,w.cursor>w.limit_backward&&(w.cursor--,w.bra=w.cursor,w.slice_del())):w.limit_backward=e)}function o(){var e,r;w.cursor>=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(l,11),e?(w.bra=w.cursor,w.limit_backward=r,1==e&&w.slice_del()):w.limit_backward=r)}var s,a,m=[new r("a",-1,1),new r("e",-1,1),new r("ede",1,1),new r("ande",1,1),new r("ende",1,1),new r("ane",1,1),new r("ene",1,1),new r("hetene",6,1),new r("erte",1,3),new r("en",-1,1),new r("heten",9,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",12,1),new r("s",-1,2),new r("as",14,1),new r("es",14,1),new r("edes",16,1),new r("endes",16,1),new r("enes",16,1),new r("hetenes",19,1),new r("ens",14,1),new r("hetens",21,1),new r("ers",14,1),new r("ets",14,1),new r("et",-1,1),new r("het",25,1),new r("ert",-1,3),new r("ast",-1,1)],u=[new r("dt",-1,-1),new r("vt",-1,-1)],l=[new r("leg",-1,1),new r("eleg",0,1),new r("ig",-1,1),new r("eig",2,1),new r("lig",2,1),new r("elig",4,1),new r("els",-1,1),new r("lov",-1,1),new r("elov",7,1),new r("slov",7,1),new r("hetslov",9,1)],d=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],c=[119,125,149,1],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,i(),w.cursor=w.limit,t(),w.cursor=w.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.no.stemmer,"stemmer-no"),e.no.stopWordFilter=e.generateStopWordFilter("alle at av bare begge ble blei bli blir blitt både båe da de deg dei deim deira deires dem den denne der dere deres det dette di din disse ditt du dykk dykkar då eg ein eit eitt eller elles en enn er et ett etter for fordi fra før ha hadde han hans har hennar henne hennes her hjå ho hoe honom hoss hossen hun hva hvem hver hvilke hvilken hvis hvor hvordan hvorfor i ikke ikkje ikkje ingen ingi inkje inn inni ja jeg kan kom korleis korso kun kunne kva kvar kvarhelst kven kvi kvifor man mange me med medan meg meget mellom men mi min mine mitt mot mykje ned no noe noen noka noko nokon nokor nokre nå når og også om opp oss over på samme seg selv si si sia sidan siden sin sine sitt sjøl skal skulle slik so som som somme somt så sånn til um upp ut uten var vart varte ved vere verte vi vil ville vore vors vort vår være være vært å".split(" ")),e.Pipeline.registerFunction(e.no.stopWordFilter,"stopWordFilter-no")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.pt.min.js b/latest/assets/javascripts/lunr/min/lunr.pt.min.js
new file mode 100644
index 000000000..6c16996d6
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.pt.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Portuguese` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.pt=function(){this.pipeline.reset(),this.pipeline.add(e.pt.trimmer,e.pt.stopWordFilter,e.pt.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.pt.stemmer))},e.pt.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.pt.trimmer=e.trimmerSupport.generateTrimmer(e.pt.wordCharacters),e.Pipeline.registerFunction(e.pt.trimmer,"trimmer-pt"),e.pt.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(k,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("a~");continue;case 2:z.slice_from("o~");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function n(){if(z.out_grouping(y,97,250)){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!0;z.cursor++}return!1}return!0}function i(){if(z.in_grouping(y,97,250))for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return g=z.cursor,!0}function o(){var e,r,s=z.cursor;if(z.in_grouping(y,97,250))if(e=z.cursor,n()){if(z.cursor=e,i())return}else g=z.cursor;if(z.cursor=s,z.out_grouping(y,97,250)){if(r=z.cursor,n()){if(z.cursor=r,!z.in_grouping(y,97,250)||z.cursor>=z.limit)return;z.cursor++}g=z.cursor}}function t(){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return!0}function a(){var e=z.cursor;g=z.limit,b=g,h=g,o(),z.cursor=e,t()&&(b=z.cursor,t()&&(h=z.cursor))}function u(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(q,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("ã");continue;case 2:z.slice_from("õ");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function w(){return g<=z.cursor}function m(){return b<=z.cursor}function c(){return h<=z.cursor}function l(){var e;if(z.ket=z.cursor,!(e=z.find_among_b(F,45)))return!1;switch(z.bra=z.cursor,e){case 1:if(!c())return!1;z.slice_del();break;case 2:if(!c())return!1;z.slice_from("log");break;case 3:if(!c())return!1;z.slice_from("u");break;case 4:if(!c())return!1;z.slice_from("ente");break;case 5:if(!m())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(j,4),e&&(z.bra=z.cursor,c()&&(z.slice_del(),1==e&&(z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del()))));break;case 6:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(C,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 7:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(P,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 8:if(!c())return!1;z.slice_del(),z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del());break;case 9:if(!w()||!z.eq_s_b(1,"e"))return!1;z.slice_from("ir")}return!0}function f(){var e,r;if(z.cursor>=g){if(r=z.limit_backward,z.limit_backward=g,z.ket=z.cursor,e=z.find_among_b(S,120))return z.bra=z.cursor,1==e&&z.slice_del(),z.limit_backward=r,!0;z.limit_backward=r}return!1}function d(){var e;z.ket=z.cursor,(e=z.find_among_b(W,7))&&(z.bra=z.cursor,1==e&&w()&&z.slice_del())}function v(e,r){if(z.eq_s_b(1,e)){z.bra=z.cursor;var s=z.limit-z.cursor;if(z.eq_s_b(1,r))return z.cursor=z.limit-s,w()&&z.slice_del(),!1}return!0}function p(){var e;if(z.ket=z.cursor,e=z.find_among_b(L,4))switch(z.bra=z.cursor,e){case 1:w()&&(z.slice_del(),z.ket=z.cursor,z.limit-z.cursor,v("u","g")&&v("i","c"));break;case 2:z.slice_from("c")}}function _(){if(!l()&&(z.cursor=z.limit,!f()))return z.cursor=z.limit,void d();z.cursor=z.limit,z.ket=z.cursor,z.eq_s_b(1,"i")&&(z.bra=z.cursor,z.eq_s_b(1,"c")&&(z.cursor=z.limit,w()&&z.slice_del()))}var h,b,g,k=[new r("",-1,3),new r("ã",0,1),new r("õ",0,2)],q=[new r("",-1,3),new r("a~",0,1),new r("o~",0,2)],j=[new r("ic",-1,-1),new r("ad",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],C=[new r("ante",-1,1),new r("avel",-1,1),new r("ível",-1,1)],P=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],F=[new r("ica",-1,1),new r("ância",-1,1),new r("ência",-1,4),new r("ira",-1,9),new r("adora",-1,1),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,8),new r("eza",-1,1),new r("logía",-1,2),new r("idade",-1,7),new r("ante",-1,1),new r("mente",-1,6),new r("amente",12,5),new r("ável",-1,1),new r("ível",-1,1),new r("ución",-1,3),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,1),new r("imento",-1,1),new r("ivo",-1,8),new r("aça~o",-1,1),new r("ador",-1,1),new r("icas",-1,1),new r("ências",-1,4),new r("iras",-1,9),new r("adoras",-1,1),new r("osas",-1,1),new r("istas",-1,1),new r("ivas",-1,8),new r("ezas",-1,1),new r("logías",-1,2),new r("idades",-1,7),new r("uciones",-1,3),new r("adores",-1,1),new r("antes",-1,1),new r("aço~es",-1,1),new r("icos",-1,1),new r("ismos",-1,1),new r("osos",-1,1),new r("amentos",-1,1),new r("imentos",-1,1),new r("ivos",-1,8)],S=[new r("ada",-1,1),new r("ida",-1,1),new r("ia",-1,1),new r("aria",2,1),new r("eria",2,1),new r("iria",2,1),new r("ara",-1,1),new r("era",-1,1),new r("ira",-1,1),new r("ava",-1,1),new r("asse",-1,1),new r("esse",-1,1),new r("isse",-1,1),new r("aste",-1,1),new r("este",-1,1),new r("iste",-1,1),new r("ei",-1,1),new r("arei",16,1),new r("erei",16,1),new r("irei",16,1),new r("am",-1,1),new r("iam",20,1),new r("ariam",21,1),new r("eriam",21,1),new r("iriam",21,1),new r("aram",20,1),new r("eram",20,1),new r("iram",20,1),new r("avam",20,1),new r("em",-1,1),new r("arem",29,1),new r("erem",29,1),new r("irem",29,1),new r("assem",29,1),new r("essem",29,1),new r("issem",29,1),new r("ado",-1,1),new r("ido",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("indo",-1,1),new r("ara~o",-1,1),new r("era~o",-1,1),new r("ira~o",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("ir",-1,1),new r("as",-1,1),new r("adas",47,1),new r("idas",47,1),new r("ias",47,1),new r("arias",50,1),new r("erias",50,1),new r("irias",50,1),new r("aras",47,1),new r("eras",47,1),new r("iras",47,1),new r("avas",47,1),new r("es",-1,1),new r("ardes",58,1),new r("erdes",58,1),new r("irdes",58,1),new r("ares",58,1),new r("eres",58,1),new r("ires",58,1),new r("asses",58,1),new r("esses",58,1),new r("isses",58,1),new r("astes",58,1),new r("estes",58,1),new r("istes",58,1),new r("is",-1,1),new r("ais",71,1),new r("eis",71,1),new r("areis",73,1),new r("ereis",73,1),new r("ireis",73,1),new r("áreis",73,1),new r("éreis",73,1),new r("íreis",73,1),new r("ásseis",73,1),new r("ésseis",73,1),new r("ísseis",73,1),new r("áveis",73,1),new r("íeis",73,1),new r("aríeis",84,1),new r("eríeis",84,1),new r("iríeis",84,1),new r("ados",-1,1),new r("idos",-1,1),new r("amos",-1,1),new r("áramos",90,1),new r("éramos",90,1),new r("íramos",90,1),new r("ávamos",90,1),new r("íamos",90,1),new r("aríamos",95,1),new r("eríamos",95,1),new r("iríamos",95,1),new r("emos",-1,1),new r("aremos",99,1),new r("eremos",99,1),new r("iremos",99,1),new r("ássemos",99,1),new r("êssemos",99,1),new r("íssemos",99,1),new r("imos",-1,1),new r("armos",-1,1),new r("ermos",-1,1),new r("irmos",-1,1),new r("ámos",-1,1),new r("arás",-1,1),new r("erás",-1,1),new r("irás",-1,1),new r("eu",-1,1),new r("iu",-1,1),new r("ou",-1,1),new r("ará",-1,1),new r("erá",-1,1),new r("irá",-1,1)],W=[new r("a",-1,1),new r("i",-1,1),new r("o",-1,1),new r("os",-1,1),new r("á",-1,1),new r("í",-1,1),new r("ó",-1,1)],L=[new r("e",-1,1),new r("ç",-1,2),new r("é",-1,1),new r("ê",-1,1)],y=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,3,19,12,2],z=new s;this.setCurrent=function(e){z.setCurrent(e)},this.getCurrent=function(){return z.getCurrent()},this.stem=function(){var r=z.cursor;return e(),z.cursor=r,a(),z.limit_backward=r,z.cursor=z.limit,_(),z.cursor=z.limit,p(),z.cursor=z.limit_backward,u(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.pt.stemmer,"stemmer-pt"),e.pt.stopWordFilter=e.generateStopWordFilter("a ao aos aquela aquelas aquele aqueles aquilo as até com como da das de dela delas dele deles depois do dos e ela elas ele eles em entre era eram essa essas esse esses esta estamos estas estava estavam este esteja estejam estejamos estes esteve estive estivemos estiver estivera estiveram estiverem estivermos estivesse estivessem estivéramos estivéssemos estou está estávamos estão eu foi fomos for fora foram forem formos fosse fossem fui fôramos fôssemos haja hajam hajamos havemos hei houve houvemos houver houvera houveram houverei houverem houveremos houveria houveriam houvermos houverá houverão houveríamos houvesse houvessem houvéramos houvéssemos há hão isso isto já lhe lhes mais mas me mesmo meu meus minha minhas muito na nas nem no nos nossa nossas nosso nossos num numa não nós o os ou para pela pelas pelo pelos por qual quando que quem se seja sejam sejamos sem serei seremos seria seriam será serão seríamos seu seus somos sou sua suas são só também te tem temos tenha tenham tenhamos tenho terei teremos teria teriam terá terão teríamos teu teus teve tinha tinham tive tivemos tiver tivera tiveram tiverem tivermos tivesse tivessem tivéramos tivéssemos tu tua tuas tém tínhamos um uma você vocês vos à às éramos".split(" ")),e.Pipeline.registerFunction(e.pt.stopWordFilter,"stopWordFilter-pt")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.ro.min.js b/latest/assets/javascripts/lunr/min/lunr.ro.min.js
new file mode 100644
index 000000000..727714018
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.ro.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Romanian` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ro=function(){this.pipeline.reset(),this.pipeline.add(e.ro.trimmer,e.ro.stopWordFilter,e.ro.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ro.stemmer))},e.ro.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.ro.trimmer=e.trimmerSupport.generateTrimmer(e.ro.wordCharacters),e.Pipeline.registerFunction(e.ro.trimmer,"trimmer-ro"),e.ro.stemmer=function(){var i=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,n=new function(){function e(e,i){L.eq_s(1,e)&&(L.ket=L.cursor,L.in_grouping(W,97,259)&&L.slice_from(i))}function n(){for(var i,r;;){if(i=L.cursor,L.in_grouping(W,97,259)&&(r=L.cursor,L.bra=r,e("u","U"),L.cursor=r,e("i","I")),L.cursor=i,L.cursor>=L.limit)break;L.cursor++}}function t(){if(L.out_grouping(W,97,259)){for(;!L.in_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}return!0}function a(){if(L.in_grouping(W,97,259))for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}function o(){var e,i,r=L.cursor;if(L.in_grouping(W,97,259)){if(e=L.cursor,!t())return void(h=L.cursor);if(L.cursor=e,!a())return void(h=L.cursor)}L.cursor=r,L.out_grouping(W,97,259)&&(i=L.cursor,t()&&(L.cursor=i,L.in_grouping(W,97,259)&&L.cursor<L.limit&&L.cursor++),h=L.cursor)}function u(){for(;!L.in_grouping(W,97,259);){if(L.cursor>=L.limit)return!1;L.cursor++}for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!1;L.cursor++}return!0}function c(){var e=L.cursor;h=L.limit,k=h,g=h,o(),L.cursor=e,u()&&(k=L.cursor,u()&&(g=L.cursor))}function s(){for(var e;;){if(L.bra=L.cursor,e=L.find_among(z,3))switch(L.ket=L.cursor,e){case 1:L.slice_from("i");continue;case 2:L.slice_from("u");continue;case 3:if(L.cursor>=L.limit)break;L.cursor++;continue}break}}function w(){return h<=L.cursor}function m(){return k<=L.cursor}function l(){return g<=L.cursor}function f(){var e,i;if(L.ket=L.cursor,(e=L.find_among_b(C,16))&&(L.bra=L.cursor,m()))switch(e){case 1:L.slice_del();break;case 2:L.slice_from("a");break;case 3:L.slice_from("e");break;case 4:L.slice_from("i");break;case 5:i=L.limit-L.cursor,L.eq_s_b(2,"ab")||(L.cursor=L.limit-i,L.slice_from("i"));break;case 6:L.slice_from("at");break;case 7:L.slice_from("aţi")}}function p(){var e,i=L.limit-L.cursor;if(L.ket=L.cursor,(e=L.find_among_b(P,46))&&(L.bra=L.cursor,m())){switch(e){case 1:L.slice_from("abil");break;case 2:L.slice_from("ibil");break;case 3:L.slice_from("iv");break;case 4:L.slice_from("ic");break;case 5:L.slice_from("at");break;case 6:L.slice_from("it")}return _=!0,L.cursor=L.limit-i,!0}return!1}function d(){var e,i;for(_=!1;;)if(i=L.limit-L.cursor,!p()){L.cursor=L.limit-i;break}if(L.ket=L.cursor,(e=L.find_among_b(F,62))&&(L.bra=L.cursor,l())){switch(e){case 1:L.slice_del();break;case 2:L.eq_s_b(1,"ţ")&&(L.bra=L.cursor,L.slice_from("t"));break;case 3:L.slice_from("ist")}_=!0}}function b(){var e,i,r;if(L.cursor>=h){if(i=L.limit_backward,L.limit_backward=h,L.ket=L.cursor,e=L.find_among_b(q,94))switch(L.bra=L.cursor,e){case 1:if(r=L.limit-L.cursor,!L.out_grouping_b(W,97,259)&&(L.cursor=L.limit-r,!L.eq_s_b(1,"u")))break;case 2:L.slice_del()}L.limit_backward=i}}function v(){var e;L.ket=L.cursor,(e=L.find_among_b(S,5))&&(L.bra=L.cursor,w()&&1==e&&L.slice_del())}var _,g,k,h,z=[new i("",-1,3),new i("I",0,1),new i("U",0,2)],C=[new i("ea",-1,3),new i("aţia",-1,7),new i("aua",-1,2),new i("iua",-1,4),new i("aţie",-1,7),new i("ele",-1,3),new i("ile",-1,5),new i("iile",6,4),new i("iei",-1,4),new i("atei",-1,6),new i("ii",-1,4),new i("ului",-1,1),new i("ul",-1,1),new i("elor",-1,3),new i("ilor",-1,4),new i("iilor",14,4)],P=[new i("icala",-1,4),new i("iciva",-1,4),new i("ativa",-1,5),new i("itiva",-1,6),new i("icale",-1,4),new i("aţiune",-1,5),new i("iţiune",-1,6),new i("atoare",-1,5),new i("itoare",-1,6),new i("ătoare",-1,5),new i("icitate",-1,4),new i("abilitate",-1,1),new i("ibilitate",-1,2),new i("ivitate",-1,3),new i("icive",-1,4),new i("ative",-1,5),new i("itive",-1,6),new i("icali",-1,4),new i("atori",-1,5),new i("icatori",18,4),new i("itori",-1,6),new i("ători",-1,5),new i("icitati",-1,4),new i("abilitati",-1,1),new i("ivitati",-1,3),new i("icivi",-1,4),new i("ativi",-1,5),new i("itivi",-1,6),new i("icităi",-1,4),new i("abilităi",-1,1),new i("ivităi",-1,3),new i("icităţi",-1,4),new i("abilităţi",-1,1),new i("ivităţi",-1,3),new i("ical",-1,4),new i("ator",-1,5),new i("icator",35,4),new i("itor",-1,6),new i("ător",-1,5),new i("iciv",-1,4),new i("ativ",-1,5),new i("itiv",-1,6),new i("icală",-1,4),new i("icivă",-1,4),new i("ativă",-1,5),new i("itivă",-1,6)],F=[new i("ica",-1,1),new i("abila",-1,1),new i("ibila",-1,1),new i("oasa",-1,1),new i("ata",-1,1),new i("ita",-1,1),new i("anta",-1,1),new i("ista",-1,3),new i("uta",-1,1),new i("iva",-1,1),new i("ic",-1,1),new i("ice",-1,1),new i("abile",-1,1),new i("ibile",-1,1),new i("isme",-1,3),new i("iune",-1,2),new i("oase",-1,1),new i("ate",-1,1),new i("itate",17,1),new i("ite",-1,1),new i("ante",-1,1),new i("iste",-1,3),new i("ute",-1,1),new i("ive",-1,1),new i("ici",-1,1),new i("abili",-1,1),new i("ibili",-1,1),new i("iuni",-1,2),new i("atori",-1,1),new i("osi",-1,1),new i("ati",-1,1),new i("itati",30,1),new i("iti",-1,1),new i("anti",-1,1),new i("isti",-1,3),new i("uti",-1,1),new i("işti",-1,3),new i("ivi",-1,1),new i("ităi",-1,1),new i("oşi",-1,1),new i("ităţi",-1,1),new i("abil",-1,1),new i("ibil",-1,1),new i("ism",-1,3),new i("ator",-1,1),new i("os",-1,1),new i("at",-1,1),new i("it",-1,1),new i("ant",-1,1),new i("ist",-1,3),new i("ut",-1,1),new i("iv",-1,1),new i("ică",-1,1),new i("abilă",-1,1),new i("ibilă",-1,1),new i("oasă",-1,1),new i("ată",-1,1),new i("ită",-1,1),new i("antă",-1,1),new i("istă",-1,3),new i("ută",-1,1),new i("ivă",-1,1)],q=[new i("ea",-1,1),new i("ia",-1,1),new i("esc",-1,1),new i("ăsc",-1,1),new i("ind",-1,1),new i("ând",-1,1),new i("are",-1,1),new i("ere",-1,1),new i("ire",-1,1),new i("âre",-1,1),new i("se",-1,2),new i("ase",10,1),new i("sese",10,2),new i("ise",10,1),new i("use",10,1),new i("âse",10,1),new i("eşte",-1,1),new i("ăşte",-1,1),new i("eze",-1,1),new i("ai",-1,1),new i("eai",19,1),new i("iai",19,1),new i("sei",-1,2),new i("eşti",-1,1),new i("ăşti",-1,1),new i("ui",-1,1),new i("ezi",-1,1),new i("âi",-1,1),new i("aşi",-1,1),new i("seşi",-1,2),new i("aseşi",29,1),new i("seseşi",29,2),new i("iseşi",29,1),new i("useşi",29,1),new i("âseşi",29,1),new i("işi",-1,1),new i("uşi",-1,1),new i("âşi",-1,1),new i("aţi",-1,2),new i("eaţi",38,1),new i("iaţi",38,1),new i("eţi",-1,2),new i("iţi",-1,2),new i("âţi",-1,2),new i("arăţi",-1,1),new i("serăţi",-1,2),new i("aserăţi",45,1),new i("seserăţi",45,2),new i("iserăţi",45,1),new i("userăţi",45,1),new i("âserăţi",45,1),new i("irăţi",-1,1),new i("urăţi",-1,1),new i("ârăţi",-1,1),new i("am",-1,1),new i("eam",54,1),new i("iam",54,1),new i("em",-1,2),new i("asem",57,1),new i("sesem",57,2),new i("isem",57,1),new i("usem",57,1),new i("âsem",57,1),new i("im",-1,2),new i("âm",-1,2),new i("ăm",-1,2),new i("arăm",65,1),new i("serăm",65,2),new i("aserăm",67,1),new i("seserăm",67,2),new i("iserăm",67,1),new i("userăm",67,1),new i("âserăm",67,1),new i("irăm",65,1),new i("urăm",65,1),new i("ârăm",65,1),new i("au",-1,1),new i("eau",76,1),new i("iau",76,1),new i("indu",-1,1),new i("ându",-1,1),new i("ez",-1,1),new i("ească",-1,1),new i("ară",-1,1),new i("seră",-1,2),new i("aseră",84,1),new i("seseră",84,2),new i("iseră",84,1),new i("useră",84,1),new i("âseră",84,1),new i("iră",-1,1),new i("ură",-1,1),new i("âră",-1,1),new i("ează",-1,1)],S=[new i("a",-1,1),new i("e",-1,1),new i("ie",1,1),new i("i",-1,1),new i("ă",-1,1)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,2,32,0,0,4],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var e=L.cursor;return n(),L.cursor=e,c(),L.limit_backward=e,L.cursor=L.limit,f(),L.cursor=L.limit,d(),L.cursor=L.limit,_||(L.cursor=L.limit,b(),L.cursor=L.limit),v(),L.cursor=L.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.ro.stemmer,"stemmer-ro"),e.ro.stopWordFilter=e.generateStopWordFilter("acea aceasta această aceea acei aceia acel acela acele acelea acest acesta aceste acestea aceşti aceştia acolo acord acum ai aia aibă aici al ale alea altceva altcineva am ar are asemenea asta astea astăzi asupra au avea avem aveţi azi aş aşadar aţi bine bucur bună ca care caut ce cel ceva chiar cinci cine cineva contra cu cum cumva curând curînd când cât câte câtva câţi cînd cît cîte cîtva cîţi că căci cărei căror cărui către da dacă dar datorită dată dau de deci deja deoarece departe deşi din dinaintea dintr- dintre doi doilea două drept după dă ea ei el ele eram este eu eşti face fata fi fie fiecare fii fim fiu fiţi frumos fără graţie halbă iar ieri la le li lor lui lângă lîngă mai mea mei mele mereu meu mi mie mine mult multă mulţi mulţumesc mâine mîine mă ne nevoie nici nicăieri nimeni nimeri nimic nişte noastre noastră noi noroc nostru nouă noştri nu opt ori oricare orice oricine oricum oricând oricât oricînd oricît oriunde patra patru patrulea pe pentru peste pic poate pot prea prima primul prin puţin puţina puţină până pînă rog sa sale sau se spate spre sub sunt suntem sunteţi sută sînt sîntem sînteţi să săi său ta tale te timp tine toate toată tot totuşi toţi trei treia treilea tu tăi tău un una unde undeva unei uneia unele uneori unii unor unora unu unui unuia unul vi voastre voastră voi vostru vouă voştri vreme vreo vreun vă zece zero zi zice îi îl îmi împotriva în  înainte înaintea încotro încât încît între întrucât întrucît îţi ăla ălea ăsta ăstea ăştia şapte şase şi ştiu ţi ţie".split(" ")),e.Pipeline.registerFunction(e.ro.stopWordFilter,"stopWordFilter-ro")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.ru.min.js b/latest/assets/javascripts/lunr/min/lunr.ru.min.js
new file mode 100644
index 000000000..186cc485c
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.ru.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Russian` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ru=function(){this.pipeline.reset(),this.pipeline.add(e.ru.trimmer,e.ru.stopWordFilter,e.ru.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ru.stemmer))},e.ru.wordCharacters="Ѐ-҄҇-ԯᴫᵸⷠ-ⷿꙀ-ꚟ︮︯",e.ru.trimmer=e.trimmerSupport.generateTrimmer(e.ru.wordCharacters),e.Pipeline.registerFunction(e.ru.trimmer,"trimmer-ru"),e.ru.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,t=new function(){function e(){for(;!W.in_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function t(){for(;!W.out_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function w(){b=W.limit,_=b,e()&&(b=W.cursor,t()&&e()&&t()&&(_=W.cursor))}function i(){return _<=W.cursor}function u(e,n){var r,t;if(W.ket=W.cursor,r=W.find_among_b(e,n)){switch(W.bra=W.cursor,r){case 1:if(t=W.limit-W.cursor,!W.eq_s_b(1,"а")&&(W.cursor=W.limit-t,!W.eq_s_b(1,"я")))return!1;case 2:W.slice_del()}return!0}return!1}function o(){return u(h,9)}function s(e,n){var r;return W.ket=W.cursor,!!(r=W.find_among_b(e,n))&&(W.bra=W.cursor,1==r&&W.slice_del(),!0)}function c(){return s(g,26)}function m(){return!!c()&&(u(C,8),!0)}function f(){return s(k,2)}function l(){return u(P,46)}function a(){s(v,36)}function p(){var e;W.ket=W.cursor,(e=W.find_among_b(F,2))&&(W.bra=W.cursor,i()&&1==e&&W.slice_del())}function d(){var e;if(W.ket=W.cursor,e=W.find_among_b(q,4))switch(W.bra=W.cursor,e){case 1:if(W.slice_del(),W.ket=W.cursor,!W.eq_s_b(1,"н"))break;W.bra=W.cursor;case 2:if(!W.eq_s_b(1,"н"))break;case 3:W.slice_del()}}var _,b,h=[new n("в",-1,1),new n("ив",0,2),new n("ыв",0,2),new n("вши",-1,1),new n("ивши",3,2),new n("ывши",3,2),new n("вшись",-1,1),new n("ившись",6,2),new n("ывшись",6,2)],g=[new n("ее",-1,1),new n("ие",-1,1),new n("ое",-1,1),new n("ые",-1,1),new n("ими",-1,1),new n("ыми",-1,1),new n("ей",-1,1),new n("ий",-1,1),new n("ой",-1,1),new n("ый",-1,1),new n("ем",-1,1),new n("им",-1,1),new n("ом",-1,1),new n("ым",-1,1),new n("его",-1,1),new n("ого",-1,1),new n("ему",-1,1),new n("ому",-1,1),new n("их",-1,1),new n("ых",-1,1),new n("ею",-1,1),new n("ою",-1,1),new n("ую",-1,1),new n("юю",-1,1),new n("ая",-1,1),new n("яя",-1,1)],C=[new n("ем",-1,1),new n("нн",-1,1),new n("вш",-1,1),new n("ивш",2,2),new n("ывш",2,2),new n("щ",-1,1),new n("ющ",5,1),new n("ующ",6,2)],k=[new n("сь",-1,1),new n("ся",-1,1)],P=[new n("ла",-1,1),new n("ила",0,2),new n("ыла",0,2),new n("на",-1,1),new n("ена",3,2),new n("ете",-1,1),new n("ите",-1,2),new n("йте",-1,1),new n("ейте",7,2),new n("уйте",7,2),new n("ли",-1,1),new n("или",10,2),new n("ыли",10,2),new n("й",-1,1),new n("ей",13,2),new n("уй",13,2),new n("л",-1,1),new n("ил",16,2),new n("ыл",16,2),new n("ем",-1,1),new n("им",-1,2),new n("ым",-1,2),new n("н",-1,1),new n("ен",22,2),new n("ло",-1,1),new n("ило",24,2),new n("ыло",24,2),new n("но",-1,1),new n("ено",27,2),new n("нно",27,1),new n("ет",-1,1),new n("ует",30,2),new n("ит",-1,2),new n("ыт",-1,2),new n("ют",-1,1),new n("уют",34,2),new n("ят",-1,2),new n("ны",-1,1),new n("ены",37,2),new n("ть",-1,1),new n("ить",39,2),new n("ыть",39,2),new n("ешь",-1,1),new n("ишь",-1,2),new n("ю",-1,2),new n("ую",44,2)],v=[new n("а",-1,1),new n("ев",-1,1),new n("ов",-1,1),new n("е",-1,1),new n("ие",3,1),new n("ье",3,1),new n("и",-1,1),new n("еи",6,1),new n("ии",6,1),new n("ами",6,1),new n("ями",6,1),new n("иями",10,1),new n("й",-1,1),new n("ей",12,1),new n("ией",13,1),new n("ий",12,1),new n("ой",12,1),new n("ам",-1,1),new n("ем",-1,1),new n("ием",18,1),new n("ом",-1,1),new n("ям",-1,1),new n("иям",21,1),new n("о",-1,1),new n("у",-1,1),new n("ах",-1,1),new n("ях",-1,1),new n("иях",26,1),new n("ы",-1,1),new n("ь",-1,1),new n("ю",-1,1),new n("ию",30,1),new n("ью",30,1),new n("я",-1,1),new n("ия",33,1),new n("ья",33,1)],F=[new n("ост",-1,1),new n("ость",-1,1)],q=[new n("ейше",-1,1),new n("н",-1,2),new n("ейш",-1,1),new n("ь",-1,3)],S=[33,65,8,232],W=new r;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){return w(),W.cursor=W.limit,!(W.cursor<b)&&(W.limit_backward=b,o()||(W.cursor=W.limit,f()||(W.cursor=W.limit),m()||(W.cursor=W.limit,l()||(W.cursor=W.limit,a()))),W.cursor=W.limit,W.ket=W.cursor,W.eq_s_b(1,"и")?(W.bra=W.cursor,W.slice_del()):W.cursor=W.limit,p(),W.cursor=W.limit,d(),!0)}};return function(e){return"function"==typeof e.update?e.update(function(e){return t.setCurrent(e),t.stem(),t.getCurrent()}):(t.setCurrent(e),t.stem(),t.getCurrent())}}(),e.Pipeline.registerFunction(e.ru.stemmer,"stemmer-ru"),e.ru.stopWordFilter=e.generateStopWordFilter("алло без близко более больше будем будет будете будешь будто буду будут будь бы бывает бывь был была были было быть в важная важное важные важный вам вами вас ваш ваша ваше ваши вверх вдали вдруг ведь везде весь вниз внизу во вокруг вон восемнадцатый восемнадцать восемь восьмой вот впрочем времени время все всегда всего всем всеми всему всех всею всю всюду вся всё второй вы г где говорил говорит год года году да давно даже далеко дальше даром два двадцатый двадцать две двенадцатый двенадцать двух девятнадцатый девятнадцать девятый девять действительно дел день десятый десять для до довольно долго должно другая другие других друго другое другой е его ее ей ему если есть еще ещё ею её ж же жизнь за занят занята занято заняты затем зато зачем здесь значит и из или им именно иметь ими имя иногда их к каждая каждое каждые каждый кажется как какая какой кем когда кого ком кому конечно которая которого которой которые который которых кроме кругом кто куда лет ли лишь лучше люди м мало между меля менее меньше меня миллионов мимо мира мне много многочисленная многочисленное многочисленные многочисленный мной мною мог могут мож может можно можхо мои мой мор мочь моя моё мы на наверху над надо назад наиболее наконец нам нами нас начала наш наша наше наши не него недавно недалеко нее ней нельзя нем немного нему непрерывно нередко несколько нет нею неё ни нибудь ниже низко никогда никуда ними них ничего но ну нужно нх о об оба обычно один одиннадцатый одиннадцать однажды однако одного одной около он она они оно опять особенно от отовсюду отсюда очень первый перед по под пожалуйста позже пока пор пора после посреди потом потому почему почти прекрасно при про просто против процентов пятнадцатый пятнадцать пятый пять раз разве рано раньше рядом с сам сама сами самим самими самих само самого самой самом самому саму свое своего своей свои своих свою сеаой себе себя сегодня седьмой сейчас семнадцатый семнадцать семь сих сказал сказала сказать сколько слишком сначала снова со собой собою совсем спасибо стал суть т та так такая также такие такое такой там твой твоя твоё те тебе тебя тем теми теперь тех то тобой тобою тогда того тоже только том тому тот тою третий три тринадцатый тринадцать ту туда тут ты тысяч у уж уже уметь хорошо хотеть хоть хотя хочешь часто чаще чего человек чем чему через четвертый четыре четырнадцатый четырнадцать что чтоб чтобы чуть шестнадцатый шестнадцать шестой шесть эта эти этим этими этих это этого этой этом этому этот эту я \ufeffа".split(" ")),e.Pipeline.registerFunction(e.ru.stopWordFilter,"stopWordFilter-ru")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.sa.min.js b/latest/assets/javascripts/lunr/min/lunr.sa.min.js
new file mode 100644
index 000000000..50ee56420
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.sa.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.sa=function(){this.pipeline.reset(),this.pipeline.add(e.sa.trimmer,e.sa.stopWordFilter,e.sa.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.sa.stemmer))},e.sa.wordCharacters="ऀ-ःऄ-एऐ-टठ-यर-िी-ॏॐ-य़ॠ-९॰-ॿ꣠-꣱ꣲ-ꣷ꣸-ꣻ꣼-ꣽꣾ-ꣿᆰ0-ᆰ9",e.sa.trimmer=e.trimmerSupport.generateTrimmer(e.sa.wordCharacters),e.Pipeline.registerFunction(e.sa.trimmer,"trimmer-sa"),e.sa.stopWordFilter=e.generateStopWordFilter('तथा अयम्‌ एकम्‌ इत्यस्मिन्‌ तथा तत्‌ वा अयम्‌ इत्यस्य ते आहूत उपरि तेषाम्‌  किन्तु तेषाम्‌ तदा इत्यनेन अधिकः इत्यस्य तत्‌ केचन बहवः द्वि तथा महत्वपूर्णः अयम्‌ अस्य  विषये अयं अस्ति तत्‌ प्रथमः विषये इत्युपरि इत्युपरि इतर अधिकतमः अधिकः अपि सामान्यतया ठ इतरेतर नूतनम्‌ द  न्यूनम्‌ कश्चित्‌ वा विशालः द  सः अस्ति तदनुसारम् तत्र अस्ति केवलम्‌ अपि अत्र सर्वे विविधाः तत्‌ बहवः यतः इदानीम्‌ द  दक्षिण इत्यस्मै तस्य उपरि नथ अतीव कार्यम्‌ सर्वे एकैकम्‌ इत्यादि। एते सन्ति  उत इत्थम्‌ मध्ये एतदर्थं . स कस्य प्रथमः श्री. करोति अस्मिन् प्रकारः निर्मिता कालः तत्र कर्तुं  समान अधुना ते सन्ति स एकः अस्ति सः अर्थात् तेषां कृते . स्थितम्  विशेषः अग्रिम तेषाम्‌ समान स्रोतः ख म समान इदानीमपि अधिकतया करोतु ते समान इत्यस्य वीथी सह यस्मिन्  कृतवान्‌ धृतः तदा पुनः पूर्वं सः आगतः किम्‌ कुल इतर पुरा  मात्रा स विषये उ अतएव अपि नगरस्य  उपरि यतः प्रतिशतं  कतरः कालः साधनानि भूत तथापि जात सम्बन्धि अन्यत्‌ ग अतः अस्माकं स्वकीयाः अस्माकं इदानीं अन्तः इत्यादयः भवन्तः इत्यादयः एते एताः तस्य अस्य इदम् एते तेषां तेषां तेषां तान् तेषां तेषां तेषां समानः सः एकः च तादृशाः बहवः अन्ये च वदन्ति यत् कियत् कस्मै  कस्मै  यस्मै  यस्मै  यस्मै  यस्मै न अतिनीचः किन्तु प्रथमं सम्पूर्णतया  ततः चिरकालानन्तरं पुस्तकं सम्पूर्णतया अन्तः  किन्तु अत्र वा इह इव श्रद्धाय अवशिष्यते  परन्तु अन्ये वर्गाः सन्ति ते सन्ति शक्नुवन्ति सर्वे मिलित्वा सर्वे एकत्र"'.split(" ")),e.sa.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var r=e.wordcut;r.init(),e.sa.tokenizer=function(t){if(!arguments.length||null==t||void 0==t)return[];if(Array.isArray(t))return t.map(function(r){return isLunr2?new e.Token(r.toLowerCase()):r.toLowerCase()});var i=t.toString().toLowerCase().replace(/^\s+/,"");return r.cut(i).split("|")},e.Pipeline.registerFunction(e.sa.stemmer,"stemmer-sa"),e.Pipeline.registerFunction(e.sa.stopWordFilter,"stopWordFilter-sa")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.stemmer.support.min.js b/latest/assets/javascripts/lunr/min/lunr.stemmer.support.min.js
new file mode 100644
index 000000000..abd4475bb
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.stemmer.support.min.js
@@ -0,0 +1 @@
+!function(r,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(r.lunr)}(this,function(){return function(r){r.stemmerSupport={Among:function(r,t,i,s){if(this.toCharArray=function(r){for(var t=r.length,i=new Array(t),s=0;s<t;s++)i[s]=r.charCodeAt(s);return i},!r&&""!=r||!t&&0!=t||!i)throw"Bad Among initialisation: s:"+r+", substring_i: "+t+", result: "+i;this.s_size=r.length,this.s=this.toCharArray(r),this.substring_i=t,this.result=i,this.method=s},SnowballProgram:function(){var r;return{bra:0,ket:0,limit:0,cursor:0,limit_backward:0,setCurrent:function(t){r=t,this.cursor=0,this.limit=t.length,this.limit_backward=0,this.bra=this.cursor,this.ket=this.limit},getCurrent:function(){var t=r;return r=null,t},in_grouping:function(t,i,s){if(this.cursor<this.limit){var e=r.charCodeAt(this.cursor);if(e<=s&&e>=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor++,!0}return!1},in_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e<=s&&e>=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor--,!0}return!1},out_grouping:function(t,i,s){if(this.cursor<this.limit){var e=r.charCodeAt(this.cursor);if(e>s||e<i)return this.cursor++,!0;if(e-=i,!(t[e>>3]&1<<(7&e)))return this.cursor++,!0}return!1},out_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e>s||e<i)return this.cursor--,!0;if(e-=i,!(t[e>>3]&1<<(7&e)))return this.cursor--,!0}return!1},eq_s:function(t,i){if(this.limit-this.cursor<t)return!1;for(var s=0;s<t;s++)if(r.charCodeAt(this.cursor+s)!=i.charCodeAt(s))return!1;return this.cursor+=t,!0},eq_s_b:function(t,i){if(this.cursor-this.limit_backward<t)return!1;for(var s=0;s<t;s++)if(r.charCodeAt(this.cursor-t+s)!=i.charCodeAt(s))return!1;return this.cursor-=t,!0},find_among:function(t,i){for(var s=0,e=i,n=this.cursor,u=this.limit,o=0,h=0,c=!1;;){for(var a=s+(e-s>>1),f=0,l=o<h?o:h,_=t[a],m=l;m<_.s_size;m++){if(n+l==u){f=-1;break}if(f=r.charCodeAt(n+l)-_.s[m])break;l++}if(f<0?(e=a,h=l):(s=a,o=l),e-s<=1){if(s>0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n+_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n+_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},find_among_b:function(t,i){for(var s=0,e=i,n=this.cursor,u=this.limit_backward,o=0,h=0,c=!1;;){for(var a=s+(e-s>>1),f=0,l=o<h?o:h,_=t[a],m=_.s_size-1-l;m>=0;m--){if(n-l==u){f=-1;break}if(f=r.charCodeAt(n-1-l)-_.s[m])break;l++}if(f<0?(e=a,h=l):(s=a,o=l),e-s<=1){if(s>0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n-_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n-_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},replace_s:function(t,i,s){var e=s.length-(i-t),n=r.substring(0,t),u=r.substring(i);return r=n+s+u,this.limit+=e,this.cursor>=i?this.cursor+=e:this.cursor>t&&(this.cursor=t),e},slice_check:function(){if(this.bra<0||this.bra>this.ket||this.ket>this.limit||this.limit>r.length)throw"faulty slice operation"},slice_from:function(r){this.slice_check(),this.replace_s(this.bra,this.ket,r)},slice_del:function(){this.slice_from("")},insert:function(r,t,i){var s=this.replace_s(r,t,i);r<=this.bra&&(this.bra+=s),r<=this.ket&&(this.ket+=s)},slice_to:function(){return this.slice_check(),r.substring(this.bra,this.ket)},eq_v_b:function(r){return this.eq_s_b(r.length,r)}}}},r.trimmerSupport={generateTrimmer:function(r){var t=new RegExp("^[^"+r+"]+"),i=new RegExp("[^"+r+"]+$");return function(r){return"function"==typeof r.update?r.update(function(r){return r.replace(t,"").replace(i,"")}):r.replace(t,"").replace(i,"")}}}}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.sv.min.js b/latest/assets/javascripts/lunr/min/lunr.sv.min.js
new file mode 100644
index 000000000..3e5eb6400
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.sv.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Swedish` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.sv=function(){this.pipeline.reset(),this.pipeline.add(e.sv.trimmer,e.sv.stopWordFilter,e.sv.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.sv.stemmer))},e.sv.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.sv.trimmer=e.trimmerSupport.generateTrimmer(e.sv.wordCharacters),e.Pipeline.registerFunction(e.sv.trimmer,"trimmer-sv"),e.sv.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,t=new function(){function e(){var e,r=w.cursor+3;if(o=w.limit,0<=r||r<=w.limit){for(a=r;;){if(e=w.cursor,w.in_grouping(l,97,246)){w.cursor=e;break}if(w.cursor=e,w.cursor>=w.limit)return;w.cursor++}for(;!w.out_grouping(l,97,246);){if(w.cursor>=w.limit)return;w.cursor++}o=w.cursor,o<a&&(o=a)}}function t(){var e,r=w.limit_backward;if(w.cursor>=o&&(w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(u,37),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.in_grouping_b(d,98,121)&&w.slice_del()}}function i(){var e=w.limit_backward;w.cursor>=o&&(w.limit_backward=o,w.cursor=w.limit,w.find_among_b(c,7)&&(w.cursor=w.limit,w.ket=w.cursor,w.cursor>w.limit_backward&&(w.bra=--w.cursor,w.slice_del())),w.limit_backward=e)}function s(){var e,r;if(w.cursor>=o){if(r=w.limit_backward,w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(m,5))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.slice_from("lös");break;case 3:w.slice_from("full")}w.limit_backward=r}}var a,o,u=[new r("a",-1,1),new r("arna",0,1),new r("erna",0,1),new r("heterna",2,1),new r("orna",0,1),new r("ad",-1,1),new r("e",-1,1),new r("ade",6,1),new r("ande",6,1),new r("arne",6,1),new r("are",6,1),new r("aste",6,1),new r("en",-1,1),new r("anden",12,1),new r("aren",12,1),new r("heten",12,1),new r("ern",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",18,1),new r("or",-1,1),new r("s",-1,2),new r("as",21,1),new r("arnas",22,1),new r("ernas",22,1),new r("ornas",22,1),new r("es",21,1),new r("ades",26,1),new r("andes",26,1),new r("ens",21,1),new r("arens",29,1),new r("hetens",29,1),new r("erns",21,1),new r("at",-1,1),new r("andet",-1,1),new r("het",-1,1),new r("ast",-1,1)],c=[new r("dd",-1,-1),new r("gd",-1,-1),new r("nn",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1),new r("tt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("els",-1,1),new r("fullt",-1,3),new r("löst",-1,2)],l=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,24,0,32],d=[119,127,149],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,t(),w.cursor=w.limit,i(),w.cursor=w.limit,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return t.setCurrent(e),t.stem(),t.getCurrent()}):(t.setCurrent(e),t.stem(),t.getCurrent())}}(),e.Pipeline.registerFunction(e.sv.stemmer,"stemmer-sv"),e.sv.stopWordFilter=e.generateStopWordFilter("alla allt att av blev bli blir blivit de dem den denna deras dess dessa det detta dig din dina ditt du där då efter ej eller en er era ert ett från för ha hade han hans har henne hennes hon honom hur här i icke ingen inom inte jag ju kan kunde man med mellan men mig min mina mitt mot mycket ni nu när någon något några och om oss på samma sedan sig sin sina sitta själv skulle som så sådan sådana sådant till under upp ut utan vad var vara varför varit varje vars vart vem vi vid vilka vilkas vilken vilket vår våra vårt än är åt över".split(" ")),e.Pipeline.registerFunction(e.sv.stopWordFilter,"stopWordFilter-sv")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.ta.min.js b/latest/assets/javascripts/lunr/min/lunr.ta.min.js
new file mode 100644
index 000000000..a644bed22
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.ta.min.js
@@ -0,0 +1 @@
+!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ta=function(){this.pipeline.reset(),this.pipeline.add(e.ta.trimmer,e.ta.stopWordFilter,e.ta.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ta.stemmer))},e.ta.wordCharacters="஀-உஊ-ஏஐ-ஙச-ட஠-னப-யர-ஹ஺-ிீ-௉ொ-௏ௐ-௙௚-௟௠-௩௪-௯௰-௹௺-௿a-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.ta.trimmer=e.trimmerSupport.generateTrimmer(e.ta.wordCharacters),e.Pipeline.registerFunction(e.ta.trimmer,"trimmer-ta"),e.ta.stopWordFilter=e.generateStopWordFilter("அங்கு அங்கே அது அதை அந்த அவர் அவர்கள் அவள் அவன் அவை ஆக ஆகவே ஆகையால் ஆதலால் ஆதலினால் ஆனாலும் ஆனால் இங்கு இங்கே இது இதை இந்த இப்படி இவர் இவர்கள் இவள் இவன் இவை இவ்வளவு உனக்கு உனது உன் உன்னால் எங்கு எங்கே எது எதை எந்த எப்படி எவர் எவர்கள் எவள் எவன் எவை எவ்வளவு எனக்கு எனது எனவே என் என்ன என்னால் ஏது ஏன் தனது தன்னால் தானே தான் நாங்கள் நாம் நான் நீ நீங்கள்".split(" ")),e.ta.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var t=e.wordcut;t.init(),e.ta.tokenizer=function(r){if(!arguments.length||null==r||void 0==r)return[];if(Array.isArray(r))return r.map(function(t){return isLunr2?new e.Token(t.toLowerCase()):t.toLowerCase()});var i=r.toString().toLowerCase().replace(/^\s+/,"");return t.cut(i).split("|")},e.Pipeline.registerFunction(e.ta.stemmer,"stemmer-ta"),e.Pipeline.registerFunction(e.ta.stopWordFilter,"stopWordFilter-ta")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.te.min.js b/latest/assets/javascripts/lunr/min/lunr.te.min.js
new file mode 100644
index 000000000..9fa7a93b9
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.te.min.js
@@ -0,0 +1 @@
+!function(e,t){"function"==typeof define&&define.amd?define(t):"object"==typeof exports?module.exports=t():t()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.te=function(){this.pipeline.reset(),this.pipeline.add(e.te.trimmer,e.te.stopWordFilter,e.te.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.te.stemmer))},e.te.wordCharacters="ఀ-ఄఅ-ఔక-హా-ౌౕ-ౖౘ-ౚౠ-ౡౢ-ౣ౦-౯౸-౿఼ఽ్ౝ౷౤౥",e.te.trimmer=e.trimmerSupport.generateTrimmer(e.te.wordCharacters),e.Pipeline.registerFunction(e.te.trimmer,"trimmer-te"),e.te.stopWordFilter=e.generateStopWordFilter("అందరూ అందుబాటులో అడగండి అడగడం అడ్డంగా అనుగుణంగా అనుమతించు అనుమతిస్తుంది అయితే ఇప్పటికే ఉన్నారు ఎక్కడైనా ఎప్పుడు ఎవరైనా ఎవరో ఏ ఏదైనా ఏమైనప్పటికి ఒక ఒకరు కనిపిస్తాయి కాదు కూడా గా గురించి చుట్టూ చేయగలిగింది తగిన తర్వాత దాదాపు దూరంగా నిజంగా పై ప్రకారం ప్రక్కన మధ్య మరియు మరొక మళ్ళీ మాత్రమే మెచ్చుకో వద్ద వెంట వేరుగా వ్యతిరేకంగా సంబంధం".split(" ")),e.te.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var t=e.wordcut;t.init(),e.te.tokenizer=function(r){if(!arguments.length||null==r||void 0==r)return[];if(Array.isArray(r))return r.map(function(t){return isLunr2?new e.Token(t.toLowerCase()):t.toLowerCase()});var i=r.toString().toLowerCase().replace(/^\s+/,"");return t.cut(i).split("|")},e.Pipeline.registerFunction(e.te.stemmer,"stemmer-te"),e.Pipeline.registerFunction(e.te.stopWordFilter,"stopWordFilter-te")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.th.min.js b/latest/assets/javascripts/lunr/min/lunr.th.min.js
new file mode 100644
index 000000000..dee3aac6e
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.th.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.th=function(){this.pipeline.reset(),this.pipeline.add(e.th.trimmer),r?this.tokenizer=e.th.tokenizer:(e.tokenizer&&(e.tokenizer=e.th.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.th.tokenizer))},e.th.wordCharacters="[฀-๿]",e.th.trimmer=e.trimmerSupport.generateTrimmer(e.th.wordCharacters),e.Pipeline.registerFunction(e.th.trimmer,"trimmer-th");var t=e.wordcut;t.init(),e.th.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t):t});var n=i.toString().replace(/^\s+/,"");return t.cut(n).split("|")}}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.tr.min.js b/latest/assets/javascripts/lunr/min/lunr.tr.min.js
new file mode 100644
index 000000000..563f6ec1f
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.tr.min.js
@@ -0,0 +1,18 @@
+/*!
+ * Lunr languages, `Turkish` language
+ * https://github.com/MihaiValentin/lunr-languages
+ *
+ * Copyright 2014, Mihai Valentin
+ * http://www.mozilla.org/MPL/
+ */
+/*!
+ * based on
+ * Snowball JavaScript Library v0.3
+ * http://code.google.com/p/urim/
+ * http://snowball.tartarus.org/
+ *
+ * Copyright 2010, Oleg Mazko
+ * http://www.mozilla.org/MPL/
+ */
+
+!function(r,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(r.lunr)}(this,function(){return function(r){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");r.tr=function(){this.pipeline.reset(),this.pipeline.add(r.tr.trimmer,r.tr.stopWordFilter,r.tr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(r.tr.stemmer))},r.tr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",r.tr.trimmer=r.trimmerSupport.generateTrimmer(r.tr.wordCharacters),r.Pipeline.registerFunction(r.tr.trimmer,"trimmer-tr"),r.tr.stemmer=function(){var i=r.stemmerSupport.Among,e=r.stemmerSupport.SnowballProgram,n=new function(){function r(r,i,e){for(;;){var n=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(r,i,e)){Dr.cursor=Dr.limit-n;break}if(Dr.cursor=Dr.limit-n,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function n(){var i,e;i=Dr.limit-Dr.cursor,r(Wr,97,305);for(var n=0;n<Br.length;n++){e=Dr.limit-Dr.cursor;var t=Br[n];if(Dr.eq_s_b(1,t[0])&&r(t[1],t[2],t[3]))return Dr.cursor=Dr.limit-i,!0;Dr.cursor=Dr.limit-e}return Dr.cursor=Dr.limit-e,!(!Dr.eq_s_b(1,"ü")||!r(Zr,246,252))&&(Dr.cursor=Dr.limit-i,!0)}function t(r,i){var e,n=Dr.limit-Dr.cursor;return r()&&(Dr.cursor=Dr.limit-n,Dr.cursor>Dr.limit_backward&&(Dr.cursor--,e=Dr.limit-Dr.cursor,i()))?(Dr.cursor=Dr.limit-e,!0):(Dr.cursor=Dr.limit-n,r()?(Dr.cursor=Dr.limit-n,!1):(Dr.cursor=Dr.limit-n,!(Dr.cursor<=Dr.limit_backward)&&(Dr.cursor--,!!i()&&(Dr.cursor=Dr.limit-n,!0))))}function u(r){return t(r,function(){return Dr.in_grouping_b(Wr,97,305)})}function o(){return u(function(){return Dr.eq_s_b(1,"n")})}function s(){return u(function(){return Dr.eq_s_b(1,"s")})}function c(){return u(function(){return Dr.eq_s_b(1,"y")})}function l(){return t(function(){return Dr.in_grouping_b(Lr,105,305)},function(){return Dr.out_grouping_b(Wr,97,305)})}function a(){return Dr.find_among_b(ur,10)&&l()}function m(){return n()&&Dr.in_grouping_b(Lr,105,305)&&s()}function d(){return Dr.find_among_b(or,2)}function f(){return n()&&Dr.in_grouping_b(Lr,105,305)&&c()}function b(){return n()&&Dr.find_among_b(sr,4)}function w(){return n()&&Dr.find_among_b(cr,4)&&o()}function _(){return n()&&Dr.find_among_b(lr,2)&&c()}function k(){return n()&&Dr.find_among_b(ar,2)}function p(){return n()&&Dr.find_among_b(mr,4)}function g(){return n()&&Dr.find_among_b(dr,2)}function y(){return n()&&Dr.find_among_b(fr,4)}function z(){return n()&&Dr.find_among_b(br,2)}function v(){return n()&&Dr.find_among_b(wr,2)&&c()}function h(){return Dr.eq_s_b(2,"ki")}function q(){return n()&&Dr.find_among_b(_r,2)&&o()}function C(){return n()&&Dr.find_among_b(kr,4)&&c()}function P(){return n()&&Dr.find_among_b(pr,4)}function F(){return n()&&Dr.find_among_b(gr,4)&&c()}function S(){return Dr.find_among_b(yr,4)}function W(){return n()&&Dr.find_among_b(zr,2)}function L(){return n()&&Dr.find_among_b(vr,4)}function x(){return n()&&Dr.find_among_b(hr,8)}function A(){return Dr.find_among_b(qr,2)}function E(){return n()&&Dr.find_among_b(Cr,32)&&c()}function j(){return Dr.find_among_b(Pr,8)&&c()}function T(){return n()&&Dr.find_among_b(Fr,4)&&c()}function Z(){return Dr.eq_s_b(3,"ken")&&c()}function B(){var r=Dr.limit-Dr.cursor;return!(T()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,Z()))))}function D(){if(A()){var r=Dr.limit-Dr.cursor;if(S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T())return!1}return!0}function G(){if(W()){Dr.bra=Dr.cursor,Dr.slice_del();var r=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,x()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,T()||(Dr.cursor=Dr.limit-r)))),nr=!1,!1}return!0}function H(){if(!L())return!0;var r=Dr.limit-Dr.cursor;return!E()&&(Dr.cursor=Dr.limit-r,!j())}function I(){var r,i=Dr.limit-Dr.cursor;return!(S()||(Dr.cursor=Dr.limit-i,F()||(Dr.cursor=Dr.limit-i,P()||(Dr.cursor=Dr.limit-i,C()))))||(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,T()||(Dr.cursor=Dr.limit-r),!1)}function J(){var r,i=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,nr=!0,B()&&(Dr.cursor=Dr.limit-i,D()&&(Dr.cursor=Dr.limit-i,G()&&(Dr.cursor=Dr.limit-i,H()&&(Dr.cursor=Dr.limit-i,I()))))){if(Dr.cursor=Dr.limit-i,!x())return;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T()||(Dr.cursor=Dr.limit-r)}Dr.bra=Dr.cursor,Dr.slice_del()}function K(){var r,i,e,n;if(Dr.ket=Dr.cursor,h()){if(r=Dr.limit-Dr.cursor,p())return Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,a()&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))),!0;if(Dr.cursor=Dr.limit-r,w()){if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,e=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-e,!m()&&(Dr.cursor=Dr.limit-e,!K())))return!0;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}return!0}if(Dr.cursor=Dr.limit-r,g()){if(n=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-n,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-n,!K())return!1;return!0}}return!1}function M(r){if(Dr.ket=Dr.cursor,!g()&&(Dr.cursor=Dr.limit-r,!k()))return!1;var i=Dr.limit-Dr.cursor;if(d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-i,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-i,!K())return!1;return!0}function N(r){if(Dr.ket=Dr.cursor,!z()&&(Dr.cursor=Dr.limit-r,!b()))return!1;var i=Dr.limit-Dr.cursor;return!(!m()&&(Dr.cursor=Dr.limit-i,!d()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)}function O(){var r,i=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,!(!w()&&(Dr.cursor=Dr.limit-i,!v()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,!(!W()||(Dr.bra=Dr.cursor,Dr.slice_del(),!K()))||(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!(a()||(Dr.cursor=Dr.limit-r,m()||(Dr.cursor=Dr.limit-r,K())))||(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)))}function Q(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,!p()&&(Dr.cursor=Dr.limit-e,!f()&&(Dr.cursor=Dr.limit-e,!_())))return!1;if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,a())Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()||(Dr.cursor=Dr.limit-i);else if(Dr.cursor=Dr.limit-r,!W())return!0;return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,K(),!0}function R(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,W())return Dr.bra=Dr.cursor,Dr.slice_del(),void K();if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,q())if(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-r,!m())){if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!W())return;if(Dr.bra=Dr.cursor,Dr.slice_del(),!K())return}Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}else if(Dr.cursor=Dr.limit-e,!M(e)&&(Dr.cursor=Dr.limit-e,!N(e))){if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,y())return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,i=Dr.limit-Dr.cursor,void(a()?(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())):(Dr.cursor=Dr.limit-i,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,K())));if(Dr.cursor=Dr.limit-e,!O()){if(Dr.cursor=Dr.limit-e,d())return Dr.bra=Dr.cursor,void Dr.slice_del();Dr.cursor=Dr.limit-e,K()||(Dr.cursor=Dr.limit-e,Q()||(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,(a()||(Dr.cursor=Dr.limit-e,m()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))))}}}function U(){var r;if(Dr.ket=Dr.cursor,r=Dr.find_among_b(Sr,4))switch(Dr.bra=Dr.cursor,r){case 1:Dr.slice_from("p");break;case 2:Dr.slice_from("ç");break;case 3:Dr.slice_from("t");break;case 4:Dr.slice_from("k")}}function V(){for(;;){var r=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(Wr,97,305)){Dr.cursor=Dr.limit-r;break}if(Dr.cursor=Dr.limit-r,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function X(r,i,e){if(Dr.cursor=Dr.limit-r,V()){var n=Dr.limit-Dr.cursor;if(!Dr.eq_s_b(1,i)&&(Dr.cursor=Dr.limit-n,!Dr.eq_s_b(1,e)))return!0;Dr.cursor=Dr.limit-r;var t=Dr.cursor;return Dr.insert(Dr.cursor,Dr.cursor,e),Dr.cursor=t,!1}return!0}function Y(){var r=Dr.limit-Dr.cursor;(Dr.eq_s_b(1,"d")||(Dr.cursor=Dr.limit-r,Dr.eq_s_b(1,"g")))&&X(r,"a","ı")&&X(r,"e","i")&&X(r,"o","u")&&X(r,"ö","ü")}function $(){for(var r,i=Dr.cursor,e=2;;){for(r=Dr.cursor;!Dr.in_grouping(Wr,97,305);){if(Dr.cursor>=Dr.limit)return Dr.cursor=r,!(e>0)&&(Dr.cursor=i,!0);Dr.cursor++}e--}}function rr(r,i,e){for(;!Dr.eq_s(i,e);){if(Dr.cursor>=Dr.limit)return!0;Dr.cursor++}return(tr=i)!=Dr.limit||(Dr.cursor=r,!1)}function ir(){var r=Dr.cursor;return!rr(r,2,"ad")||(Dr.cursor=r,!rr(r,5,"soyad"))}function er(){var r=Dr.cursor;return!ir()&&(Dr.limit_backward=r,Dr.cursor=Dr.limit,Y(),Dr.cursor=Dr.limit,U(),!0)}var nr,tr,ur=[new i("m",-1,-1),new i("n",-1,-1),new i("miz",-1,-1),new i("niz",-1,-1),new i("muz",-1,-1),new i("nuz",-1,-1),new i("müz",-1,-1),new i("nüz",-1,-1),new i("mız",-1,-1),new i("nız",-1,-1)],or=[new i("leri",-1,-1),new i("ları",-1,-1)],sr=[new i("ni",-1,-1),new i("nu",-1,-1),new i("nü",-1,-1),new i("nı",-1,-1)],cr=[new i("in",-1,-1),new i("un",-1,-1),new i("ün",-1,-1),new i("ın",-1,-1)],lr=[new i("a",-1,-1),new i("e",-1,-1)],ar=[new i("na",-1,-1),new i("ne",-1,-1)],mr=[new i("da",-1,-1),new i("ta",-1,-1),new i("de",-1,-1),new i("te",-1,-1)],dr=[new i("nda",-1,-1),new i("nde",-1,-1)],fr=[new i("dan",-1,-1),new i("tan",-1,-1),new i("den",-1,-1),new i("ten",-1,-1)],br=[new i("ndan",-1,-1),new i("nden",-1,-1)],wr=[new i("la",-1,-1),new i("le",-1,-1)],_r=[new i("ca",-1,-1),new i("ce",-1,-1)],kr=[new i("im",-1,-1),new i("um",-1,-1),new i("üm",-1,-1),new i("ım",-1,-1)],pr=[new i("sin",-1,-1),new i("sun",-1,-1),new i("sün",-1,-1),new i("sın",-1,-1)],gr=[new i("iz",-1,-1),new i("uz",-1,-1),new i("üz",-1,-1),new i("ız",-1,-1)],yr=[new i("siniz",-1,-1),new i("sunuz",-1,-1),new i("sünüz",-1,-1),new i("sınız",-1,-1)],zr=[new i("lar",-1,-1),new i("ler",-1,-1)],vr=[new i("niz",-1,-1),new i("nuz",-1,-1),new i("nüz",-1,-1),new i("nız",-1,-1)],hr=[new i("dir",-1,-1),new i("tir",-1,-1),new i("dur",-1,-1),new i("tur",-1,-1),new i("dür",-1,-1),new i("tür",-1,-1),new i("dır",-1,-1),new i("tır",-1,-1)],qr=[new i("casına",-1,-1),new i("cesine",-1,-1)],Cr=[new i("di",-1,-1),new i("ti",-1,-1),new i("dik",-1,-1),new i("tik",-1,-1),new i("duk",-1,-1),new i("tuk",-1,-1),new i("dük",-1,-1),new i("tük",-1,-1),new i("dık",-1,-1),new i("tık",-1,-1),new i("dim",-1,-1),new i("tim",-1,-1),new i("dum",-1,-1),new i("tum",-1,-1),new i("düm",-1,-1),new i("tüm",-1,-1),new i("dım",-1,-1),new i("tım",-1,-1),new i("din",-1,-1),new i("tin",-1,-1),new i("dun",-1,-1),new i("tun",-1,-1),new i("dün",-1,-1),new i("tün",-1,-1),new i("dın",-1,-1),new i("tın",-1,-1),new i("du",-1,-1),new i("tu",-1,-1),new i("dü",-1,-1),new i("tü",-1,-1),new i("dı",-1,-1),new i("tı",-1,-1)],Pr=[new i("sa",-1,-1),new i("se",-1,-1),new i("sak",-1,-1),new i("sek",-1,-1),new i("sam",-1,-1),new i("sem",-1,-1),new i("san",-1,-1),new i("sen",-1,-1)],Fr=[new i("miş",-1,-1),new i("muş",-1,-1),new i("müş",-1,-1),new i("mış",-1,-1)],Sr=[new i("b",-1,1),new i("c",-1,2),new i("d",-1,3),new i("ğ",-1,4)],Wr=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,8,0,0,0,0,0,0,1],Lr=[1,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,0,0,0,0,0,1],xr=[1,64,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],Ar=[17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,130],Er=[1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],jr=[17],Tr=[65],Zr=[65],Br=[["a",xr,97,305],["e",Ar,101,252],["ı",Er,97,305],["i",jr,101,105],["o",Tr,111,117],["ö",Zr,246,252],["u",Tr,111,117]],Dr=new e;this.setCurrent=function(r){Dr.setCurrent(r)},this.getCurrent=function(){return Dr.getCurrent()},this.stem=function(){return!!($()&&(Dr.limit_backward=Dr.cursor,Dr.cursor=Dr.limit,J(),Dr.cursor=Dr.limit,nr&&(R(),Dr.cursor=Dr.limit_backward,er())))}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.tr.stemmer,"stemmer-tr"),r.tr.stopWordFilter=r.generateStopWordFilter("acaba altmış altı ama ancak arada aslında ayrıca bana bazı belki ben benden beni benim beri beş bile bin bir biri birkaç birkez birçok birşey birşeyi biz bizden bize bizi bizim bu buna bunda bundan bunlar bunları bunların bunu bunun burada böyle böylece da daha dahi de defa değil diye diğer doksan dokuz dolayı dolayısıyla dört edecek eden ederek edilecek ediliyor edilmesi ediyor elli en etmesi etti ettiği ettiğini eğer gibi göre halen hangi hatta hem henüz hep hepsi her herhangi herkesin hiç hiçbir iki ile ilgili ise itibaren itibariyle için işte kadar karşın katrilyon kendi kendilerine kendini kendisi kendisine kendisini kez ki kim kimden kime kimi kimse kırk milyar milyon mu mü mı nasıl ne neden nedenle nerde nerede nereye niye niçin o olan olarak oldu olduklarını olduğu olduğunu olmadı olmadığı olmak olması olmayan olmaz olsa olsun olup olur olursa oluyor on ona ondan onlar onlardan onları onların onu onun otuz oysa pek rağmen sadece sanki sekiz seksen sen senden seni senin siz sizden sizi sizin tarafından trilyon tüm var vardı ve veya ya yani yapacak yapmak yaptı yaptıkları yaptığı yaptığını yapılan yapılması yapıyor yedi yerine yetmiş yine yirmi yoksa yüz zaten çok çünkü öyle üzere üç şey şeyden şeyi şeyler şu şuna şunda şundan şunları şunu şöyle".split(" ")),r.Pipeline.registerFunction(r.tr.stopWordFilter,"stopWordFilter-tr")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.vi.min.js b/latest/assets/javascripts/lunr/min/lunr.vi.min.js
new file mode 100644
index 000000000..22aed28c4
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.vi.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.vi=function(){this.pipeline.reset(),this.pipeline.add(e.vi.stopWordFilter,e.vi.trimmer)},e.vi.wordCharacters="[A-Za-ẓ̀͐́͑̉̃̓ÂâÊêÔôĂ-ăĐ-đƠ-ơƯ-ư]",e.vi.trimmer=e.trimmerSupport.generateTrimmer(e.vi.wordCharacters),e.Pipeline.registerFunction(e.vi.trimmer,"trimmer-vi"),e.vi.stopWordFilter=e.generateStopWordFilter("là cái nhưng mà".split(" "))}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/min/lunr.zh.min.js b/latest/assets/javascripts/lunr/min/lunr.zh.min.js
new file mode 100644
index 000000000..fda66e9c5
--- /dev/null
+++ b/latest/assets/javascripts/lunr/min/lunr.zh.min.js
@@ -0,0 +1 @@
+!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r(require("@node-rs/jieba")):r()(e.lunr)}(this,function(e){return function(r,t){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var i="2"==r.version[0];r.zh=function(){this.pipeline.reset(),this.pipeline.add(r.zh.trimmer,r.zh.stopWordFilter,r.zh.stemmer),i?this.tokenizer=r.zh.tokenizer:(r.tokenizer&&(r.tokenizer=r.zh.tokenizer),this.tokenizerFn&&(this.tokenizerFn=r.zh.tokenizer))},r.zh.tokenizer=function(n){if(!arguments.length||null==n||void 0==n)return[];if(Array.isArray(n))return n.map(function(e){return i?new r.Token(e.toLowerCase()):e.toLowerCase()});t&&e.load(t);var o=n.toString().trim().toLowerCase(),s=[];e.cut(o,!0).forEach(function(e){s=s.concat(e.split(" "))}),s=s.filter(function(e){return!!e});var u=0;return s.map(function(e,t){if(i){var n=o.indexOf(e,u),s={};return s.position=[n,e.length],s.index=t,u=n,new r.Token(e,s)}return e})},r.zh.wordCharacters="\\w一-龥",r.zh.trimmer=r.trimmerSupport.generateTrimmer(r.zh.wordCharacters),r.Pipeline.registerFunction(r.zh.trimmer,"trimmer-zh"),r.zh.stemmer=function(){return function(e){return e}}(),r.Pipeline.registerFunction(r.zh.stemmer,"stemmer-zh"),r.zh.stopWordFilter=r.generateStopWordFilter("的 一 不 在 人 有 是 为 為 以 于 於 上 他 而 后 後 之 来 來 及 了 因 下 可 到 由 这 這 与 與 也 此 但 并 並 个 個 其 已 无 無 小 我 们 們 起 最 再 今 去 好 只 又 或 很 亦 某 把 那 你 乃 它 吧 被 比 别 趁 当 當 从 從 得 打 凡 儿 兒 尔 爾 该 該 各 给 給 跟 和 何 还 還 即 几 幾 既 看 据 據 距 靠 啦 另 么 麽 每 嘛 拿 哪 您 凭 憑 且 却 卻 让 讓 仍 啥 如 若 使 谁 誰 虽 雖 随 隨 同 所 她 哇 嗡 往 些 向 沿 哟 喲 用 咱 则 則 怎 曾 至 致 着 著 诸 諸 自".split(" ")),r.Pipeline.registerFunction(r.zh.stopWordFilter,"stopWordFilter-zh")}});
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/tinyseg.js b/latest/assets/javascripts/lunr/tinyseg.js
new file mode 100644
index 000000000..167fa6dd6
--- /dev/null
+++ b/latest/assets/javascripts/lunr/tinyseg.js
@@ -0,0 +1,206 @@
+/**
+ * export the module via AMD, CommonJS or as a browser global
+ * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js
+ */
+;(function (root, factory) {
+    if (typeof define === 'function' && define.amd) {
+        // AMD. Register as an anonymous module.
+        define(factory)
+    } else if (typeof exports === 'object') {
+        /**
+         * Node. Does not work with strict CommonJS, but
+         * only CommonJS-like environments that support module.exports,
+         * like Node.
+         */
+        module.exports = factory()
+    } else {
+        // Browser globals (root is window)
+        factory()(root.lunr);
+    }
+}(this, function () {
+    /**
+     * Just return a value to define the module export.
+     * This example returns an object, but the module
+     * can return a function as the exported value.
+     */
+
+    return function(lunr) {
+        // TinySegmenter 0.1 -- Super compact Japanese tokenizer in Javascript
+        // (c) 2008 Taku Kudo <taku@chasen.org>
+        // TinySegmenter is freely distributable under the terms of a new BSD licence.
+        // For details, see http://chasen.org/~taku/software/TinySegmenter/LICENCE.txt
+
+        function TinySegmenter() {
+          var patterns = {
+            "[一二三四五六七八九十百千万億兆]":"M",
+            "[一-龠々〆ヵヶ]":"H",
+            "[ぁ-ん]":"I",
+            "[ァ-ヴーｱ-ﾝﾞｰ]":"K",
+            "[a-zA-Zａ-ｚＡ-Ｚ]":"A",
+            "[0-9０-９]":"N"
+          }
+          this.chartype_ = [];
+          for (var i in patterns) {
+            var regexp = new RegExp(i);
+            this.chartype_.push([regexp, patterns[i]]);
+          }
+
+          this.BIAS__ = -332
+          this.BC1__ = {"HH":6,"II":2461,"KH":406,"OH":-1378};
+          this.BC2__ = {"AA":-3267,"AI":2744,"AN":-878,"HH":-4070,"HM":-1711,"HN":4012,"HO":3761,"IA":1327,"IH":-1184,"II":-1332,"IK":1721,"IO":5492,"KI":3831,"KK":-8741,"MH":-3132,"MK":3334,"OO":-2920};
+          this.BC3__ = {"HH":996,"HI":626,"HK":-721,"HN":-1307,"HO":-836,"IH":-301,"KK":2762,"MK":1079,"MM":4034,"OA":-1652,"OH":266};
+          this.BP1__ = {"BB":295,"OB":304,"OO":-125,"UB":352};
+          this.BP2__ = {"BO":60,"OO":-1762};
+          this.BQ1__ = {"BHH":1150,"BHM":1521,"BII":-1158,"BIM":886,"BMH":1208,"BNH":449,"BOH":-91,"BOO":-2597,"OHI":451,"OIH":-296,"OKA":1851,"OKH":-1020,"OKK":904,"OOO":2965};
+          this.BQ2__ = {"BHH":118,"BHI":-1159,"BHM":466,"BIH":-919,"BKK":-1720,"BKO":864,"OHH":-1139,"OHM":-181,"OIH":153,"UHI":-1146};
+          this.BQ3__ = {"BHH":-792,"BHI":2664,"BII":-299,"BKI":419,"BMH":937,"BMM":8335,"BNN":998,"BOH":775,"OHH":2174,"OHM":439,"OII":280,"OKH":1798,"OKI":-793,"OKO":-2242,"OMH":-2402,"OOO":11699};
+          this.BQ4__ = {"BHH":-3895,"BIH":3761,"BII":-4654,"BIK":1348,"BKK":-1806,"BMI":-3385,"BOO":-12396,"OAH":926,"OHH":266,"OHK":-2036,"ONN":-973};
+          this.BW1__ = {",と":660,",同":727,"B1あ":1404,"B1同":542,"、と":660,"、同":727,"」と":1682,"あっ":1505,"いう":1743,"いっ":-2055,"いる":672,"うし":-4817,"うん":665,"から":3472,"がら":600,"こう":-790,"こと":2083,"こん":-1262,"さら":-4143,"さん":4573,"した":2641,"して":1104,"すで":-3399,"そこ":1977,"それ":-871,"たち":1122,"ため":601,"った":3463,"つい":-802,"てい":805,"てき":1249,"でき":1127,"です":3445,"では":844,"とい":-4915,"とみ":1922,"どこ":3887,"ない":5713,"なっ":3015,"など":7379,"なん":-1113,"にし":2468,"には":1498,"にも":1671,"に対":-912,"の一":-501,"の中":741,"ませ":2448,"まで":1711,"まま":2600,"まる":-2155,"やむ":-1947,"よっ":-2565,"れた":2369,"れで":-913,"をし":1860,"を見":731,"亡く":-1886,"京都":2558,"取り":-2784,"大き":-2604,"大阪":1497,"平方":-2314,"引き":-1336,"日本":-195,"本当":-2423,"毎日":-2113,"目指":-724,"Ｂ１あ":1404,"Ｂ１同":542,"｣と":1682};
+          this.BW2__ = {"..":-11822,"11":-669,"――":-5730,"−−":-13175,"いう":-1609,"うか":2490,"かし":-1350,"かも":-602,"から":-7194,"かれ":4612,"がい":853,"がら":-3198,"きた":1941,"くな":-1597,"こと":-8392,"この":-4193,"させ":4533,"され":13168,"さん":-3977,"しい":-1819,"しか":-545,"した":5078,"して":972,"しな":939,"その":-3744,"たい":-1253,"たた":-662,"ただ":-3857,"たち":-786,"たと":1224,"たは":-939,"った":4589,"って":1647,"っと":-2094,"てい":6144,"てき":3640,"てく":2551,"ては":-3110,"ても":-3065,"でい":2666,"でき":-1528,"でし":-3828,"です":-4761,"でも":-4203,"とい":1890,"とこ":-1746,"とと":-2279,"との":720,"とみ":5168,"とも":-3941,"ない":-2488,"なが":-1313,"など":-6509,"なの":2614,"なん":3099,"にお":-1615,"にし":2748,"にな":2454,"によ":-7236,"に対":-14943,"に従":-4688,"に関":-11388,"のか":2093,"ので":-7059,"のに":-6041,"のの":-6125,"はい":1073,"はが":-1033,"はず":-2532,"ばれ":1813,"まし":-1316,"まで":-6621,"まれ":5409,"めて":-3153,"もい":2230,"もの":-10713,"らか":-944,"らし":-1611,"らに":-1897,"りし":651,"りま":1620,"れた":4270,"れて":849,"れば":4114,"ろう":6067,"われ":7901,"を通":-11877,"んだ":728,"んな":-4115,"一人":602,"一方":-1375,"一日":970,"一部":-1051,"上が":-4479,"会社":-1116,"出て":2163,"分の":-7758,"同党":970,"同日":-913,"大阪":-2471,"委員":-1250,"少な":-1050,"年度":-8669,"年間":-1626,"府県":-2363,"手権":-1982,"新聞":-4066,"日新":-722,"日本":-7068,"日米":3372,"曜日":-601,"朝鮮":-2355,"本人":-2697,"東京":-1543,"然と":-1384,"社会":-1276,"立て":-990,"第に":-1612,"米国":-4268,"１１":-669};
+          this.BW3__ = {"あた":-2194,"あり":719,"ある":3846,"い.":-1185,"い。":-1185,"いい":5308,"いえ":2079,"いく":3029,"いた":2056,"いっ":1883,"いる":5600,"いわ":1527,"うち":1117,"うと":4798,"えと":1454,"か.":2857,"か。":2857,"かけ":-743,"かっ":-4098,"かに":-669,"から":6520,"かり":-2670,"が,":1816,"が、":1816,"がき":-4855,"がけ":-1127,"がっ":-913,"がら":-4977,"がり":-2064,"きた":1645,"けど":1374,"こと":7397,"この":1542,"ころ":-2757,"さい":-714,"さを":976,"し,":1557,"し、":1557,"しい":-3714,"した":3562,"して":1449,"しな":2608,"しま":1200,"す.":-1310,"す。":-1310,"する":6521,"ず,":3426,"ず、":3426,"ずに":841,"そう":428,"た.":8875,"た。":8875,"たい":-594,"たの":812,"たり":-1183,"たる":-853,"だ.":4098,"だ。":4098,"だっ":1004,"った":-4748,"って":300,"てい":6240,"てお":855,"ても":302,"です":1437,"でに":-1482,"では":2295,"とう":-1387,"とし":2266,"との":541,"とも":-3543,"どう":4664,"ない":1796,"なく":-903,"など":2135,"に,":-1021,"に、":-1021,"にし":1771,"にな":1906,"には":2644,"の,":-724,"の、":-724,"の子":-1000,"は,":1337,"は、":1337,"べき":2181,"まし":1113,"ます":6943,"まっ":-1549,"まで":6154,"まれ":-793,"らし":1479,"られ":6820,"るる":3818,"れ,":854,"れ、":854,"れた":1850,"れて":1375,"れば":-3246,"れる":1091,"われ":-605,"んだ":606,"んで":798,"カ月":990,"会議":860,"入り":1232,"大会":2217,"始め":1681,"市":965,"新聞":-5055,"日,":974,"日、":974,"社会":2024,"ｶ月":990};
+          this.TC1__ = {"AAA":1093,"HHH":1029,"HHM":580,"HII":998,"HOH":-390,"HOM":-331,"IHI":1169,"IOH":-142,"IOI":-1015,"IOM":467,"MMH":187,"OOI":-1832};
+          this.TC2__ = {"HHO":2088,"HII":-1023,"HMM":-1154,"IHI":-1965,"KKH":703,"OII":-2649};
+          this.TC3__ = {"AAA":-294,"HHH":346,"HHI":-341,"HII":-1088,"HIK":731,"HOH":-1486,"IHH":128,"IHI":-3041,"IHO":-1935,"IIH":-825,"IIM":-1035,"IOI":-542,"KHH":-1216,"KKA":491,"KKH":-1217,"KOK":-1009,"MHH":-2694,"MHM":-457,"MHO":123,"MMH":-471,"NNH":-1689,"NNO":662,"OHO":-3393};
+          this.TC4__ = {"HHH":-203,"HHI":1344,"HHK":365,"HHM":-122,"HHN":182,"HHO":669,"HIH":804,"HII":679,"HOH":446,"IHH":695,"IHO":-2324,"IIH":321,"III":1497,"IIO":656,"IOO":54,"KAK":4845,"KKA":3386,"KKK":3065,"MHH":-405,"MHI":201,"MMH":-241,"MMM":661,"MOM":841};
+          this.TQ1__ = {"BHHH":-227,"BHHI":316,"BHIH":-132,"BIHH":60,"BIII":1595,"BNHH":-744,"BOHH":225,"BOOO":-908,"OAKK":482,"OHHH":281,"OHIH":249,"OIHI":200,"OIIH":-68};
+          this.TQ2__ = {"BIHH":-1401,"BIII":-1033,"BKAK":-543,"BOOO":-5591};
+          this.TQ3__ = {"BHHH":478,"BHHM":-1073,"BHIH":222,"BHII":-504,"BIIH":-116,"BIII":-105,"BMHI":-863,"BMHM":-464,"BOMH":620,"OHHH":346,"OHHI":1729,"OHII":997,"OHMH":481,"OIHH":623,"OIIH":1344,"OKAK":2792,"OKHH":587,"OKKA":679,"OOHH":110,"OOII":-685};
+          this.TQ4__ = {"BHHH":-721,"BHHM":-3604,"BHII":-966,"BIIH":-607,"BIII":-2181,"OAAA":-2763,"OAKK":180,"OHHH":-294,"OHHI":2446,"OHHO":480,"OHIH":-1573,"OIHH":1935,"OIHI":-493,"OIIH":626,"OIII":-4007,"OKAK":-8156};
+          this.TW1__ = {"につい":-4681,"東京都":2026};
+          this.TW2__ = {"ある程":-2049,"いった":-1256,"ころが":-2434,"しょう":3873,"その後":-4430,"だって":-1049,"ていた":1833,"として":-4657,"ともに":-4517,"もので":1882,"一気に":-792,"初めて":-1512,"同時に":-8097,"大きな":-1255,"対して":-2721,"社会党":-3216};
+          this.TW3__ = {"いただ":-1734,"してい":1314,"として":-4314,"につい":-5483,"にとっ":-5989,"に当た":-6247,"ので,":-727,"ので、":-727,"のもの":-600,"れから":-3752,"十二月":-2287};
+          this.TW4__ = {"いう.":8576,"いう。":8576,"からな":-2348,"してい":2958,"たが,":1516,"たが、":1516,"ている":1538,"という":1349,"ました":5543,"ません":1097,"ようと":-4258,"よると":5865};
+          this.UC1__ = {"A":484,"K":93,"M":645,"O":-505};
+          this.UC2__ = {"A":819,"H":1059,"I":409,"M":3987,"N":5775,"O":646};
+          this.UC3__ = {"A":-1370,"I":2311};
+          this.UC4__ = {"A":-2643,"H":1809,"I":-1032,"K":-3450,"M":3565,"N":3876,"O":6646};
+          this.UC5__ = {"H":313,"I":-1238,"K":-799,"M":539,"O":-831};
+          this.UC6__ = {"H":-506,"I":-253,"K":87,"M":247,"O":-387};
+          this.UP1__ = {"O":-214};
+          this.UP2__ = {"B":69,"O":935};
+          this.UP3__ = {"B":189};
+          this.UQ1__ = {"BH":21,"BI":-12,"BK":-99,"BN":142,"BO":-56,"OH":-95,"OI":477,"OK":410,"OO":-2422};
+          this.UQ2__ = {"BH":216,"BI":113,"OK":1759};
+          this.UQ3__ = {"BA":-479,"BH":42,"BI":1913,"BK":-7198,"BM":3160,"BN":6427,"BO":14761,"OI":-827,"ON":-3212};
+          this.UW1__ = {",":156,"、":156,"「":-463,"あ":-941,"う":-127,"が":-553,"き":121,"こ":505,"で":-201,"と":-547,"ど":-123,"に":-789,"の":-185,"は":-847,"も":-466,"や":-470,"よ":182,"ら":-292,"り":208,"れ":169,"を":-446,"ん":-137,"・":-135,"主":-402,"京":-268,"区":-912,"午":871,"国":-460,"大":561,"委":729,"市":-411,"日":-141,"理":361,"生":-408,"県":-386,"都":-718,"｢":-463,"･":-135};
+          this.UW2__ = {",":-829,"、":-829,"〇":892,"「":-645,"」":3145,"あ":-538,"い":505,"う":134,"お":-502,"か":1454,"が":-856,"く":-412,"こ":1141,"さ":878,"ざ":540,"し":1529,"す":-675,"せ":300,"そ":-1011,"た":188,"だ":1837,"つ":-949,"て":-291,"で":-268,"と":-981,"ど":1273,"な":1063,"に":-1764,"の":130,"は":-409,"ひ":-1273,"べ":1261,"ま":600,"も":-1263,"や":-402,"よ":1639,"り":-579,"る":-694,"れ":571,"を":-2516,"ん":2095,"ア":-587,"カ":306,"キ":568,"ッ":831,"三":-758,"不":-2150,"世":-302,"中":-968,"主":-861,"事":492,"人":-123,"会":978,"保":362,"入":548,"初":-3025,"副":-1566,"北":-3414,"区":-422,"大":-1769,"天":-865,"太":-483,"子":-1519,"学":760,"実":1023,"小":-2009,"市":-813,"年":-1060,"強":1067,"手":-1519,"揺":-1033,"政":1522,"文":-1355,"新":-1682,"日":-1815,"明":-1462,"最":-630,"朝":-1843,"本":-1650,"東":-931,"果":-665,"次":-2378,"民":-180,"気":-1740,"理":752,"発":529,"目":-1584,"相":-242,"県":-1165,"立":-763,"第":810,"米":509,"自":-1353,"行":838,"西":-744,"見":-3874,"調":1010,"議":1198,"込":3041,"開":1758,"間":-1257,"｢":-645,"｣":3145,"ｯ":831,"ｱ":-587,"ｶ":306,"ｷ":568};
+          this.UW3__ = {",":4889,"1":-800,"−":-1723,"、":4889,"々":-2311,"〇":5827,"」":2670,"〓":-3573,"あ":-2696,"い":1006,"う":2342,"え":1983,"お":-4864,"か":-1163,"が":3271,"く":1004,"け":388,"げ":401,"こ":-3552,"ご":-3116,"さ":-1058,"し":-395,"す":584,"せ":3685,"そ":-5228,"た":842,"ち":-521,"っ":-1444,"つ":-1081,"て":6167,"で":2318,"と":1691,"ど":-899,"な":-2788,"に":2745,"の":4056,"は":4555,"ひ":-2171,"ふ":-1798,"へ":1199,"ほ":-5516,"ま":-4384,"み":-120,"め":1205,"も":2323,"や":-788,"よ":-202,"ら":727,"り":649,"る":5905,"れ":2773,"わ":-1207,"を":6620,"ん":-518,"ア":551,"グ":1319,"ス":874,"ッ":-1350,"ト":521,"ム":1109,"ル":1591,"ロ":2201,"ン":278,"・":-3794,"一":-1619,"下":-1759,"世":-2087,"両":3815,"中":653,"主":-758,"予":-1193,"二":974,"人":2742,"今":792,"他":1889,"以":-1368,"低":811,"何":4265,"作":-361,"保":-2439,"元":4858,"党":3593,"全":1574,"公":-3030,"六":755,"共":-1880,"円":5807,"再":3095,"分":457,"初":2475,"別":1129,"前":2286,"副":4437,"力":365,"動":-949,"務":-1872,"化":1327,"北":-1038,"区":4646,"千":-2309,"午":-783,"協":-1006,"口":483,"右":1233,"各":3588,"合":-241,"同":3906,"和":-837,"員":4513,"国":642,"型":1389,"場":1219,"外":-241,"妻":2016,"学":-1356,"安":-423,"実":-1008,"家":1078,"小":-513,"少":-3102,"州":1155,"市":3197,"平":-1804,"年":2416,"広":-1030,"府":1605,"度":1452,"建":-2352,"当":-3885,"得":1905,"思":-1291,"性":1822,"戸":-488,"指":-3973,"政":-2013,"教":-1479,"数":3222,"文":-1489,"新":1764,"日":2099,"旧":5792,"昨":-661,"時":-1248,"曜":-951,"最":-937,"月":4125,"期":360,"李":3094,"村":364,"東":-805,"核":5156,"森":2438,"業":484,"氏":2613,"民":-1694,"決":-1073,"法":1868,"海":-495,"無":979,"物":461,"特":-3850,"生":-273,"用":914,"町":1215,"的":7313,"直":-1835,"省":792,"県":6293,"知":-1528,"私":4231,"税":401,"立":-960,"第":1201,"米":7767,"系":3066,"約":3663,"級":1384,"統":-4229,"総":1163,"線":1255,"者":6457,"能":725,"自":-2869,"英":785,"見":1044,"調":-562,"財":-733,"費":1777,"車":1835,"軍":1375,"込":-1504,"通":-1136,"選":-681,"郎":1026,"郡":4404,"部":1200,"金":2163,"長":421,"開":-1432,"間":1302,"関":-1282,"雨":2009,"電":-1045,"非":2066,"駅":1620,"１":-800,"｣":2670,"･":-3794,"ｯ":-1350,"ｱ":551,"ｸﾞ":1319,"ｽ":874,"ﾄ":521,"ﾑ":1109,"ﾙ":1591,"ﾛ":2201,"ﾝ":278};
+          this.UW4__ = {",":3930,".":3508,"―":-4841,"、":3930,"。":3508,"〇":4999,"「":1895,"」":3798,"〓":-5156,"あ":4752,"い":-3435,"う":-640,"え":-2514,"お":2405,"か":530,"が":6006,"き":-4482,"ぎ":-3821,"く":-3788,"け":-4376,"げ":-4734,"こ":2255,"ご":1979,"さ":2864,"し":-843,"じ":-2506,"す":-731,"ず":1251,"せ":181,"そ":4091,"た":5034,"だ":5408,"ち":-3654,"っ":-5882,"つ":-1659,"て":3994,"で":7410,"と":4547,"な":5433,"に":6499,"ぬ":1853,"ね":1413,"の":7396,"は":8578,"ば":1940,"ひ":4249,"び":-4134,"ふ":1345,"へ":6665,"べ":-744,"ほ":1464,"ま":1051,"み":-2082,"む":-882,"め":-5046,"も":4169,"ゃ":-2666,"や":2795,"ょ":-1544,"よ":3351,"ら":-2922,"り":-9726,"る":-14896,"れ":-2613,"ろ":-4570,"わ":-1783,"を":13150,"ん":-2352,"カ":2145,"コ":1789,"セ":1287,"ッ":-724,"ト":-403,"メ":-1635,"ラ":-881,"リ":-541,"ル":-856,"ン":-3637,"・":-4371,"ー":-11870,"一":-2069,"中":2210,"予":782,"事":-190,"井":-1768,"人":1036,"以":544,"会":950,"体":-1286,"作":530,"側":4292,"先":601,"党":-2006,"共":-1212,"内":584,"円":788,"初":1347,"前":1623,"副":3879,"力":-302,"動":-740,"務":-2715,"化":776,"区":4517,"協":1013,"参":1555,"合":-1834,"和":-681,"員":-910,"器":-851,"回":1500,"国":-619,"園":-1200,"地":866,"場":-1410,"塁":-2094,"士":-1413,"多":1067,"大":571,"子":-4802,"学":-1397,"定":-1057,"寺":-809,"小":1910,"屋":-1328,"山":-1500,"島":-2056,"川":-2667,"市":2771,"年":374,"庁":-4556,"後":456,"性":553,"感":916,"所":-1566,"支":856,"改":787,"政":2182,"教":704,"文":522,"方":-856,"日":1798,"時":1829,"最":845,"月":-9066,"木":-485,"来":-442,"校":-360,"業":-1043,"氏":5388,"民":-2716,"気":-910,"沢":-939,"済":-543,"物":-735,"率":672,"球":-1267,"生":-1286,"産":-1101,"田":-2900,"町":1826,"的":2586,"目":922,"省":-3485,"県":2997,"空":-867,"立":-2112,"第":788,"米":2937,"系":786,"約":2171,"経":1146,"統":-1169,"総":940,"線":-994,"署":749,"者":2145,"能":-730,"般":-852,"行":-792,"規":792,"警":-1184,"議":-244,"谷":-1000,"賞":730,"車":-1481,"軍":1158,"輪":-1433,"込":-3370,"近":929,"道":-1291,"選":2596,"郎":-4866,"都":1192,"野":-1100,"銀":-2213,"長":357,"間":-2344,"院":-2297,"際":-2604,"電":-878,"領":-1659,"題":-792,"館":-1984,"首":1749,"高":2120,"｢":1895,"｣":3798,"･":-4371,"ｯ":-724,"ｰ":-11870,"ｶ":2145,"ｺ":1789,"ｾ":1287,"ﾄ":-403,"ﾒ":-1635,"ﾗ":-881,"ﾘ":-541,"ﾙ":-856,"ﾝ":-3637};
+          this.UW5__ = {",":465,".":-299,"1":-514,"E2":-32768,"]":-2762,"、":465,"。":-299,"「":363,"あ":1655,"い":331,"う":-503,"え":1199,"お":527,"か":647,"が":-421,"き":1624,"ぎ":1971,"く":312,"げ":-983,"さ":-1537,"し":-1371,"す":-852,"だ":-1186,"ち":1093,"っ":52,"つ":921,"て":-18,"で":-850,"と":-127,"ど":1682,"な":-787,"に":-1224,"の":-635,"は":-578,"べ":1001,"み":502,"め":865,"ゃ":3350,"ょ":854,"り":-208,"る":429,"れ":504,"わ":419,"を":-1264,"ん":327,"イ":241,"ル":451,"ン":-343,"中":-871,"京":722,"会":-1153,"党":-654,"務":3519,"区":-901,"告":848,"員":2104,"大":-1296,"学":-548,"定":1785,"嵐":-1304,"市":-2991,"席":921,"年":1763,"思":872,"所":-814,"挙":1618,"新":-1682,"日":218,"月":-4353,"査":932,"格":1356,"機":-1508,"氏":-1347,"田":240,"町":-3912,"的":-3149,"相":1319,"省":-1052,"県":-4003,"研":-997,"社":-278,"空":-813,"統":1955,"者":-2233,"表":663,"語":-1073,"議":1219,"選":-1018,"郎":-368,"長":786,"間":1191,"題":2368,"館":-689,"１":-514,"Ｅ２":-32768,"｢":363,"ｲ":241,"ﾙ":451,"ﾝ":-343};
+          this.UW6__ = {",":227,".":808,"1":-270,"E1":306,"、":227,"。":808,"あ":-307,"う":189,"か":241,"が":-73,"く":-121,"こ":-200,"じ":1782,"す":383,"た":-428,"っ":573,"て":-1014,"で":101,"と":-105,"な":-253,"に":-149,"の":-417,"は":-236,"も":-206,"り":187,"る":-135,"を":195,"ル":-673,"ン":-496,"一":-277,"中":201,"件":-800,"会":624,"前":302,"区":1792,"員":-1212,"委":798,"学":-960,"市":887,"広":-695,"後":535,"業":-697,"相":753,"社":-507,"福":974,"空":-822,"者":1811,"連":463,"郎":1082,"１":-270,"Ｅ１":306,"ﾙ":-673,"ﾝ":-496};
+          
+          return this;
+        }
+        TinySegmenter.prototype.ctype_ = function(str) {
+          for (var i in this.chartype_) {
+            if (str.match(this.chartype_[i][0])) {
+              return this.chartype_[i][1];
+            }
+          }
+          return "O";
+        }
+
+        TinySegmenter.prototype.ts_ = function(v) {
+          if (v) { return v; }
+          return 0;
+        }
+
+        TinySegmenter.prototype.segment = function(input) {
+          if (input == null || input == undefined || input == "") {
+            return [];
+          }
+          var result = [];
+          var seg = ["B3","B2","B1"];
+          var ctype = ["O","O","O"];
+          var o = input.split("");
+          for (i = 0; i < o.length; ++i) {
+            seg.push(o[i]);
+            ctype.push(this.ctype_(o[i]))
+          }
+          seg.push("E1");
+          seg.push("E2");
+          seg.push("E3");
+          ctype.push("O");
+          ctype.push("O");
+          ctype.push("O");
+          var word = seg[3];
+          var p1 = "U";
+          var p2 = "U";
+          var p3 = "U";
+          for (var i = 4; i < seg.length - 3; ++i) {
+            var score = this.BIAS__;
+            var w1 = seg[i-3];
+            var w2 = seg[i-2];
+            var w3 = seg[i-1];
+            var w4 = seg[i];
+            var w5 = seg[i+1];
+            var w6 = seg[i+2];
+            var c1 = ctype[i-3];
+            var c2 = ctype[i-2];
+            var c3 = ctype[i-1];
+            var c4 = ctype[i];
+            var c5 = ctype[i+1];
+            var c6 = ctype[i+2];
+            score += this.ts_(this.UP1__[p1]);
+            score += this.ts_(this.UP2__[p2]);
+            score += this.ts_(this.UP3__[p3]);
+            score += this.ts_(this.BP1__[p1 + p2]);
+            score += this.ts_(this.BP2__[p2 + p3]);
+            score += this.ts_(this.UW1__[w1]);
+            score += this.ts_(this.UW2__[w2]);
+            score += this.ts_(this.UW3__[w3]);
+            score += this.ts_(this.UW4__[w4]);
+            score += this.ts_(this.UW5__[w5]);
+            score += this.ts_(this.UW6__[w6]);
+            score += this.ts_(this.BW1__[w2 + w3]);
+            score += this.ts_(this.BW2__[w3 + w4]);
+            score += this.ts_(this.BW3__[w4 + w5]);
+            score += this.ts_(this.TW1__[w1 + w2 + w3]);
+            score += this.ts_(this.TW2__[w2 + w3 + w4]);
+            score += this.ts_(this.TW3__[w3 + w4 + w5]);
+            score += this.ts_(this.TW4__[w4 + w5 + w6]);
+            score += this.ts_(this.UC1__[c1]);
+            score += this.ts_(this.UC2__[c2]);
+            score += this.ts_(this.UC3__[c3]);
+            score += this.ts_(this.UC4__[c4]);
+            score += this.ts_(this.UC5__[c5]);
+            score += this.ts_(this.UC6__[c6]);
+            score += this.ts_(this.BC1__[c2 + c3]);
+            score += this.ts_(this.BC2__[c3 + c4]);
+            score += this.ts_(this.BC3__[c4 + c5]);
+            score += this.ts_(this.TC1__[c1 + c2 + c3]);
+            score += this.ts_(this.TC2__[c2 + c3 + c4]);
+            score += this.ts_(this.TC3__[c3 + c4 + c5]);
+            score += this.ts_(this.TC4__[c4 + c5 + c6]);
+        //  score += this.ts_(this.TC5__[c4 + c5 + c6]);    
+            score += this.ts_(this.UQ1__[p1 + c1]);
+            score += this.ts_(this.UQ2__[p2 + c2]);
+            score += this.ts_(this.UQ3__[p3 + c3]);
+            score += this.ts_(this.BQ1__[p2 + c2 + c3]);
+            score += this.ts_(this.BQ2__[p2 + c3 + c4]);
+            score += this.ts_(this.BQ3__[p3 + c2 + c3]);
+            score += this.ts_(this.BQ4__[p3 + c3 + c4]);
+            score += this.ts_(this.TQ1__[p2 + c1 + c2 + c3]);
+            score += this.ts_(this.TQ2__[p2 + c2 + c3 + c4]);
+            score += this.ts_(this.TQ3__[p3 + c1 + c2 + c3]);
+            score += this.ts_(this.TQ4__[p3 + c2 + c3 + c4]);
+            var p = "O";
+            if (score > 0) {
+              result.push(word);
+              word = "";
+              p = "B";
+            }
+            p1 = p2;
+            p2 = p3;
+            p3 = p;
+            word += seg[i];
+          }
+          result.push(word);
+
+          return result;
+        }
+
+        lunr.TinySegmenter = TinySegmenter;
+    };
+
+}));
\ No newline at end of file
diff --git a/latest/assets/javascripts/lunr/wordcut.js b/latest/assets/javascripts/lunr/wordcut.js
new file mode 100644
index 000000000..0d898c9ed
--- /dev/null
+++ b/latest/assets/javascripts/lunr/wordcut.js
@@ -0,0 +1,6708 @@
+(function(f){if(typeof exports==="object"&&typeof module!=="undefined"){module.exports=f()}else if(typeof define==="function"&&define.amd){define([],f)}else{var g;if(typeof window!=="undefined"){g=window}else if(typeof global!=="undefined"){g=global}else if(typeof self!=="undefined"){g=self}else{g=this}(g.lunr || (g.lunr = {})).wordcut = f()}})(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
+var _ = require("underscore");
+
+var Acceptors = {
+  creators: null,
+  current: null,
+  tag: null,
+
+  init: function() {
+    this.creators = [];
+    this.current = [];
+    this.tag = {};
+  },
+
+  reset: function() {
+    this.current = [];
+    this.tag = {}
+  },
+
+  transit: function(ch) {
+    var self = this;
+
+    self.creators.forEach(function(creator) {
+      var acceptor = creator.createAcceptor(self.tag);
+      if (acceptor) 
+        self.current.push(acceptor);
+    });
+    
+    var _current = [];
+    self.tag = {};
+
+    for (var i = 0; i < self.current.length; i++) {
+      var _acceptor = self.current[i]
+        , acceptor = _acceptor.transit(ch);
+      
+      if (!acceptor.isError) {
+        _current.push(acceptor);
+        self.tag[acceptor.tag] = acceptor;
+      }
+    }
+    self.current = _current;
+
+  },
+
+  getFinalAcceptors: function() {    
+    return this.current.filter(function(acceptor) {
+      return acceptor.isFinal;
+    });
+  }
+};
+
+module.exports = function() {
+  var acceptors = _.clone(Acceptors);
+  acceptors.init();
+  return acceptors;
+};
+
+},{"underscore":25}],2:[function(require,module,exports){
+(function (__dirname){
+
+var LEFT = 0;
+var RIGHT = 1;
+var path = require("path");
+var glob = require("glob");
+
+var WordcutDict = {
+
+
+  init: function (dictPathFile, withDefault, words) {
+    withDefault = withDefault || false
+    var defaultDict = path.normalize(__dirname + "/..") + "/data/tdict-*.txt";
+    this.dict=[]
+    var dictPathIsDefined = dictPathFile !== undefined
+    var dictPath = (withDefault || !dictPathIsDefined) ? [defaultDict]: [];
+    var dictPathFile = dictPathFile || defaultDict
+
+    if(dictPathIsDefined){
+      if (Array.isArray(dictPathFile)) {
+        dictPath.concat.apply(dictPath, dictPathFile);
+      } else {
+        dictPath.push(dictPathFile)
+      }
+    }
+
+    this.addFiles(dictPath, false)
+
+    if(words!==undefined){
+      this.addWords(words, false)
+    }
+    this.finalizeDict();
+  },
+
+  addWords: function(words, finalize){
+    finalize = finalize===undefined || finalize;
+    this.dict.push.apply(this.dict, words)
+    if(finalize){
+      this.finalizeDict();
+    }
+  },
+
+  finalizeDict: function(){
+    this.dict = this.sortuniq(this.dict);
+  },
+
+  addFiles: function(files, finalize){
+    finalize = finalize===undefined || finalize;
+    
+    for (var i = 0; i < 1; i++) {
+      var words = "ก.ก.\nก.ก.น.\nก.ข.ค.\nก.ค.\nก.จ.\nก.ช.น.\nก.ฌ.\nก.ต.\nก.ต.ง.\nก.ต.ช.\nก.ตร.\nก.ท.\nก.น.ช.\nก.บช.\nก.บถ.\nก.ป.ส.\nก.พ.\nก.ม.\nก.ย.\nก.ร.\nก.ล.ต.\nก.ว.\nก.ศ.ว.\nก.ส.ท.\nก.ส.ธ.\nก.ส.อ.\nก.อ.\nกก.ตชด.\nกก.ตร.น.\nกก.ภ.จว.\nกก.รสช.\nกกบ.ขส.ทบ.\nกกล.รพน.\nกง.กห.\nกง.ทบ.\nกง.ทร.\nกซข.ป.\nกซม.ป.\nกทม.กรุงเทพมหานคร\nกบ.ทบ.\nกป.สป.\nกพ.ทบ.\nกพ.ทร.\nกพ.ทหาร\nกร.ทบ.\nกรป.กลาง\nกรอ.พอ.\nกศ.ด.\nกศ.บ.\nกศ.บป.\nกศ.ม.\nกษ.ด.\nกษ.บ.\nกษ.ม.\nกส.ด.\nกส.ทบ.\nกส.บ.\nกส.ม.\nกอ.ปค.\nกอ.รพน.\nกอ.รมน.\nกอ.รสต.\nข.ต.ว.\nขว.ทบ.\nขว.ทร.\nขว.ทหาร\nขส.ทบ.\nขส.ทร.\nขส.ทอ.\nค.ด.\nค.บ.\nค.พ.ศ.\nค.ม.\nค.ร.น.\nค.ร.ฟ.\nค.ร.ม.\nค.ศ.\nค.อ.ด.\nค.อ.บ.\nค.อ.ม.\nคศ.ด.\nคศ.บ.\nคศ.ม.\nง.ด.\nจ.จ.\nจ.จ.จ.\nจ.ช.\nจ.ต.\nจ.ท.\nจ.ป.ร.\nจ.ม.\nจ.ศ.\nจ.ส.ต.\nจ.ส.ท.\nจ.ส.อ.\nจ.อ.\nจ.อ.ร.\nจ.๑๘\nจก.ธน.\nจก.สน.\nช.ค.\nช.ค.บ.\nช.พ.ค.\nช.ส.\nช.ส.ค.\nฌ.ป.ค.\nฌ.ศ.ร.\nฌ.ส.อ.\nฐท.สห.\nด.ช.\nด.ญ.\nด.ต.\nด.ศ.ค.\nด.ศ.ร.\nดย.ทร.\nต.ก.\nต.ค.\nต.จ.\nต.จ.ว.\nต.ช.\nต.ต.\nต.บ.\nต.ม.\nต.ร.\nต.ศ.ร.\nต.ห.\nต.อ.\nต.อ.จ.\nตร.กม.\nตร.ซม.\nตร.ต.\nตร.ทล.\nตร.น.\nตร.ปม.\nตร.ภ.\nตร.ม.\nตร.รฟ.\nตร.ว.\nตร.ส.\nตร.สข.\nท.จ.\nท.จ.ว.\nท.ช.\nท.ญ.\nท.ด.\nท.ท.ท.\nท.ทบ.\nท.บ.\nท.พ.\nท.ม.\nท.ศ.\nทก.ด.\nทก.บ.\nทก.ม.\nทส.ปช.\nทส.รมว.กห.\nทุ.ส.นิ.ม.\nธ.ก.ส.\nธ.ค.\nธ.ญ\nธ.บ.\nน.ช.\nน.ญ.\nน.ด.\nน.ต.\nน.ท.\nน.น.\nน.บ.\nน.บ.ท.\nน.ป.ท.\nน.พ.\nน.ม.\nน.ร.\nน.ว.\nน.ศ.\nน.ส.\nน.ส.พ.\nน.ส.๓\nน.สพ.\nน.อ.\nนปพ.ภ.\nนศ.ด.\nนศ.บ.\nนศ.ม.\nบ.ก.\nบ.ข.ส.\nบ.ช.\nบ.ด.ท.\nบ.ตร.\nบ.ภ.\nบ.ม.\nบก.จร.\nบก.ตชด.\nบก.ตม.\nบก.ทล.\nบก.น.\nบก.ป.\nบก.ปค.\nบก.ปม.\nบก.ภ.เขต\nบก.รน.\nบก.รฟ.\nบก.ร้อย.ตชด.\nบก.ส.\nบกข.ป.\nบจพ.ป.\nบช.ก.\nบช.ด.\nบช.ตชด.\nบช.น.\nบช.บ.\nบช.ปส.\nบช.ภ.\nบช.ม.\nบชท.ป.\nบชน.ป.\nบชส.ป.\nบธ.ด.\nบธ.บ.\nบธ.ม.\nบนท.ป.\nบนอ.ป.\nบปช.ป.\nป.กท.\nป.กศ.\nป.กศ.สูง\nป.จ.\nป.จ.ว.\nป.ช.\nป.ธ.\nป.ป.\nป.ป.ก.\nป.ป.ช.\nป.ป.ป.\nป.ป.ร.\nป.ป.ส.\nป.พ.\nป.พ.พ.\nป.พย.\nป.ม.\nป.ม.ก.\nป.ม.ช.\nป.ม.ธ.\nป.ม.ศ.\nป.ม.อ.\nป.ร.ร.๔\nป.ร.ร.๕\nป.ร.ร.๖\nป.ล.\nป.ว.พ.\nป.วิ.อ.\nป.ส.ส.\nป.อ.\nป.อ.ร.ส.\nป.๑\nปม.วส.\nปอ.พ.\nผกก.ภ.\nผช.ผอ.\nผต.มท.\nผบ.ตร.\nผบ.ทบ.\nผบ.ทร.\nผบ.ทสส.\nผบ.ทอ.\nผบก.น.\nผบก.ป.\nผบก.ปค.\nผบก.ปม.\nผบก.ภ.\nผบช.ก.\nผบช.ตชด.\nผบช.น.\nผบช.ภ.\nผว.กทม.\nผอ.ปจ.\nพ.ก.ง.\nพ.กศ.\nพ.ข.ต.\nพ.ค.\nพ.ค.ช.\nพ.ค.ว.\nพ.ค.ศ.\nพ.จ.ต.\nพ.จ.ท.\nพ.จ.อ.\nพ.ช.\nพ.ช.ค.\nพ.ด.\nพ.ต.\nพ.ต.ต.\nพ.ต.ท.\nพ.ต.อ.\nพ.ต.อ.พิเศษ\nพ.ท.\nพ.บ.\nพ.ป.\nพ.ภ.ม.\nพ.ม.\nพ.ม.ช.\nพ.ย.\nพ.ร.ก.\nพ.ร.ฎ.\nพ.ร.ต.\nพ.ร.ธ.\nพ.ร.บ.\nพ.ศ.\nพ.ศ.บ.\nพ.ส.ร.\nพ.ส.ล.\nพ.อ.\nพ.อ.ต.\nพ.อ.ท.\nพ.อ.พิเศษ\nพ.อ.อ.\nพณ.ด.\nพณ.บ.\nพณ.ม.\nพธ.ด.\nพธ.บ.\nพธ.ม.\nพบ.ด.\nพบ.บ.\nพบ.ม.\nพย.ด.\nพย.บ.\nพย.ม.\nพล.จ.\nพล.ต.\nพล.ต.จ.\nพล.ต.ต.\nพล.ต.ท.\nพล.ต.อ.\nพล.ท.\nพล.ปตอ.\nพล.ม.\nพล.ม.๒\nพล.ร.จ.\nพล.ร.ต.\nพล.ร.ท.\nพล.ร.อ.\nพล.อ.\nพล.อ.จ.\nพล.อ.ต.\nพล.อ.ท.\nพล.อ.อ.\nพลา.ทร.\nพศ.ด.\nพศ.บ.\nพศ.ม.\nพอ.สว.\nภ.ง.ด.\nภ.ง.ด.๙\nภ.ด.\nภ.บ.\nภ.บ.ท.๕\nภ.ป.ร.\nภ.พ.\nภ.ม.\nภ.สถ.บ.\nม.ค.\nม.จ.\nม.ป.ท.\nม.ป.ป.\nม.ป.พ.\nม.ร.ว.\nม.ศ.\nม.อ.\nม.อ.ปัตตานี\nมิ.ย.\nมี.ค.\nยศ.ทบ.\nยศ.ทร.\nยศ.ทอ.\nร.ง.\nร.ด.\nร.ต.\nร.ต.ต.\nร.ต.ท.\nร.ต.อ.\nร.ท.\nร.น.\nร.บ.\nร.พ.\nร.ฟ.ล.\nร.ย.ล.\nร.ย.ส.ท.\nร.ล.\nร.ศ.\nร.ส.พ.\nร.อ.\nรป.ม.\nรร.จปร.\nรร.จอ.\nรร.ชท.\nรร.ตท.\nรร.นร.\nรร.นรต.\nรร.นอ.\nล.ญ.\nล.ว.\nลส.ชบ.\nว.ค.\nว.ฉ.\nว.ช.\nว.ด.ป.\nว.ป.ถ.\nวท.บ.\nศ.บ.\nศ.ป.ก.\nศ.ศ.ป.\nศฝร.ภ.\nศศ.บ.\nศษ.บ.\nศส.บ.\nส.ก.\nส.ก.ศ.ท.\nส.ค.\nส.ค.1\nส.ค.ร.\nส.ค.ส.\nส.ต.\nส.ต.ต.\nส.ต.ท.\nส.ต.อ.\nส.ท.\nส.ทร.\nส.ป.ช.\nส.ป.ส.ท.\nส.ป.อ.\nส.ร.\nส.ล.น.\nส.ว.\nส.ว.ท.\nส.ว.ส.ท.\nส.ส.\nส.ส.ท.\nส.ส.ร.\nส.ห.\nส.อ.\nสถ.บ.\nสนง.สสอ.\nสพ.ญ.\nสพ.บ.\nสว.จร.\nสว.ธร.\nสว.ส.\nสว.สป.\nสว.สส.\nสว.อก.\nสส.บ.\nสุ.จิ.ปุ.ลิ.\nห.ร.ม.\nอ.ก.ค.\nอ.ก.จ.\nอ.จ.\nอ.ช.พ.\nอ.ตร.\nอ.บ.\nอ.ส.ท.\nอ.ส.ม.ท.\nอ.ส.ย.\nอ.อ.ป.\nอส.รด.\nอุ.อา.ก.ส.\nฮ.จ.\nฮ.ท.\nฮ.ฝ.\nฮ.ล.\nฮ.ศ.\nเม.ย.\n\nกรีนิช\nกลันตัน\nกัลกัตตา\nกัวลาลัมเปอร์\nกัศมีร์\nกาฐมาณฑุ\nโกลกาตา\nควิเบก\nคอนเนตทิคัต\nคาบูล\nคุชราต\nคุนหมิง\nเคนตักกี\nเคนทักกี\nเคมบริดจ์\nแคชเมียร์\nแคนซัส\nแคนเบอร์รา\nแคโรไลนา\nแคลิฟอร์เนีย\nโคเปนเฮเกน\nโคลัมโบ\nโคโลราโด\nไครสต์เชิร์ช\nไคโร\nจาการ์ตา\nจำปาศักดิ์\nเจนไน\nเจนีวา\nเจ้อเจียง\nฉงชิ่ง\nเฉิงตู\nชานตง\nชิคาโก\nเชนไน\nเชอร์โนบิล\nซัปโปโร\nซานมารีโน\nซาบาห์\nซาราเยโว\nซาราวัก\nซิดนีย์\nซีอาน\nซีแอตเทิล\nซูริก\nซูริค\nเซเชลส์\nเซนได\nเซี่ยงไฮ้\nโซเฟีย\nโซล\nโซโลมอน\nไซ่ง่อน\nไซบีเรีย\nดัลลัส\nดาโคตา\nดานัง\nดีทรอยต์\nดูไบ\nเดนเวอร์\nเดลาแวร์\nเดียนเบียนฟู\nโดเวอร์\nโดฮา\nไดฟุกุ\nไดฟูกุ\nตรังกานู\nตริโปลี\nตูวาลู\nเตหะราน\nโตเกียว\nโตรอนโต\nทมิฬนาฑู\nทริโปลี\nทิเบต\nเทกซัส\nเท็กซัส\nเทนเนสซี\nเทลอาวีฟ\nแทสเมเนีย\nโทรอนโต\nไทเป\nธากา\nนางาซากิ\nนาริตะ\nนิวเจอร์ซีย์\nนิวเดลี\nนิวยอร์ก\nนิวยอร์ค\nนิวแฮมป์เชียร์\nเนบราสกา\nเนแบรสกา\nเนวาดา\nบรัสเซลส์\nบราซิเลีย\nบอมเบย์\nบอสตัน\nบังกาลอร์\nบังคาลอร์\nบูคาเรสต์\nบูดาเปสต์\nเบงกาซี\nเบนกาซี\nเบรุต\nเบลเกรด\nเบอร์ลิน\nแบกแดด\nปอยเปต\nปะลิส\nปะหัง\nปักกิ่ง\nปัญจาบ\nปัฏนา\nปารีส\nปีนัง\nเประ\nเปียงยาง\nพนมเปญ\nพระตะบอง\nพะโค\nพะสิม\nพาราณสี\nพิหารี\nเพนซิลวาเนีย\nเพนซิลเวเนีย\nฟรานซ์\nฟลอริดา\nฟิลาเดลเฟีย\nฟุกุชิมะ\nฟุกุชิมา\nฟุกุโอกะ\nฟูกูโอกะ\nแฟรงก์เฟิร์ต\nมอสโก\nมะนิลา\nมะละแหม่ง\nมัณฑะเลย์\nมัทราส\nมาดริด\nมิชิแกน\nมินนิโซตา\nมิยางิ\nมิลาน\nมิวนิก\nมิสซูรี\nมุมไบ\nเมน\nเมลเบิร์น\nเมาะตะมะ\nเมาะลำเลิง\nแมนจูเรีย\nแมนเชสเตอร์\nแมนฮัตตัน\nแมริแลนด์\nแมรีแลนด์\nแมสซาชูเซตส์\nยะไข่\nย่างกุ้ง\nยูทาห์\nยูนนาน\nเยรูซาเล็ม\nโยโกฮามา\nริยาด\nรีโอเดจาเนโร\nโรดไอแลนด์\nลอนดอน\nลอสแองเจลิส\nลาปาซ\nลาสเวกัส\nลิสบอน\nลุยเซียนา\nโลซาน\nโลซานน์\nวอชิงตัน\nวอร์ซอ\nวิสคอนซิน\nเวนิส\nเวลส์\nเวอร์จิเนีย\nเวอร์มอนต์\nเวียงจันทน์\nเวียนนา\nแวนคูเวอร์\nไวโอมิง\nสกอตแลนด์\nสก็อตแลนด์\nสตอกโฮล์ม\nสลังงอร์\nเสฉวน\nเสียมราฐ\nเสียมเรียบ\nหงสา\nหงสาวดี\nหนานไห่\nหลวงพระบาง\nหูเป่ย\nหูเป่ย์\nหูหนาน\nเหอเป่ย\nเหอเป่ย์\nเหอหนาน\nอชันตา\nอลาสกา\nอวันตี\nออริกอน\nออสโล\nอะแลสกา\nอัตตะปือ\nอัมมาน\nอัมสเตอร์ดัม\nอัสสัม\nอาบูดาบี\nอาร์คันซอ\nอินเดียนา\nอิบารากิ\nอิลลินอยส์\nอิสตันบูล\nอิสลามาบัด\nอุรุมชี\nอูลานบาตอร์\nเอดินบะระ\nเอเธนส์\nแอตแลนตา\nแอริโซนา\nแอลเจียร์\nโอคลาโฮมา\nโอค็อตสค์\nโอกินาวา\nโอซากา\nโอริสสา\nโอเรกอน\nโอไฮโอ\nไอดาโฮ\nไอโอวา\nฮอนโนลูลู\nฮานอย\nฮาเนดะ\nฮาราเร\nฮาวาย\nฮิโรชิมา\nฮุสตัน\nเฮลซิงกิ\n\nมกรา\nกุมภา\nมีนา\nเมษา\nพฤษภา\nมิถุนา\nกรกฎา\nสิงหา\nกันยา\nตุลา\nพฤศจิกา\nธันวา\nเอ\nบี\nซี\nดี\nอี\nเอฟ\nจี\nเอช\nไอ\nเจ\nเค\nแอล\nเอ็ม\nเอ็น\nโอ\nพี\nคิว\nอาร์\nเอส\nที\nยู\nวี\nดับเบิล\nดับบลิว\nเอ็กซ์\nเอ๊กซ์\nวาย\nแซด\nแอลฟา\nแอลฟ่า\nเบตา\nเบต้า\nแกมมา\nแกมม่า\nเดลตา\nเดลต้า\nโอเมกา\nโอเมก้า\nเมกะ\nกิกะ\nนาโน\nไมโคร\n\nกรรมาชน\nกรอบรูป\nกระดี๊กระด๊า\nกระบับ\nกราวนด์\nกรีน\nกรุ๊ป\nกฤษณ์\nกลาส\nก๊วน\nกษัตริยา\nกษัตริยาธิราช\nก่อนหน้า\nกะบับ\nกับดัก\nกัมมันตะ\nก๊าก\nก๋ากั่น\nกาญจน์\nกาญจนาภิเษก\nกามิกาเซ่\nการันตี\nกาหลิบ\nกิฟท์\nกิมจิ\nกีวี\nกึ๊ก\nกึ๋ย\nกุนซือ\nกุมภาพันธ์\nกู๋\nเกจิ\nเกมส์\nเกย์\nเกรด\nเกรย์\nเกสต์เฮาส์\nเก๊ะ\nเก๋ากี้\nเกิร์ล\nแกงค์\nแกรนด์\nแกสโซฮอล์\nแก๊สโซฮอล์\nโกเต็กซ์\nโกลด์\nโกะ\nโก๊ะ\nไกด์\nขั้นตอน\nเขวี้ยง\nคณาญาติ\nครัวซอง\nครัวซองต์\nคร่ำครวญ\nครีเอทีฟ\nครูเสด\nคลับ\nคลาสสิก\nคลิตอริส\nคลิป\nความหมาย\nควิก\nควีน\nคองเกรส\nคอนซูเมอร์\nคอนเซปต์\nคอนเซ็ปต์\nคอนโด\nคอนโดมิเนียม\nคอนเทนเนอร์\nคอนแทค\nคอนแท็ค\nคอนโทรล\nคอนเฟิร์ม\nคอปเตอร์\nคอมพ์\nคอมเพล็กซ์\nคอมมอนส์\nคอมเมนท์\nคอมเมนต์\nคอร์ป\nคอร์ปอเรชั่น\nคอร์รัปชัน\nคอร์รัปชั่น\nคอรัปชัน\nคอรัปชั่น\nคอร์ส\nคอลเล็กชั่น\nคอลัมน์\nคอลัมนิสต์\nคัตเอาต์\nคันคาก\nคันถธุระ\nคันธาระ\nคันยิ\nคัสตาร์ด\nคาราโอเกะ\nคีตกวี\nคีตปฏิภาณ\nคีตราชัน\nคาปูชิโน\nคามิคาเซ่\nคาเฟ่\nคาร์\nคาร์โก้\nคาราเมล\nคาแรกเตอร์\nคาแร็กเตอร์\nคาแรคเตอร์\nคาแร็คเตอร์\nคาวบอย\nคาสิโน\nคิกขุ\nคิวบิก\nคูลเลอร์\nเคบับ\nเครป\nเคลม\nเคลียร์\nเคลื่อนย้าย\nเคส\nเคอร์ฟิว\nแคชเชียร์\nแคทวอล์ค\nแคนดิเดต\nแคนตาลูป\nแคนยอน\nแคนู\nแคป\nแคมป์\nแคมปัส\nแคมเปญ\nแคร์\nแครกเกอร์\nแคร็กเกอร์\nแครอท\nแคสต์\nแคสติง\nแคสติ้ง\nโค้ก\nโค้ช\nโคโยตี\nโคโยตี้\nโครนา\nโคอะล่า\nโคอาลา\nโคอาล่า\nไคลแมกซ์\nไคลแม็กซ์\nงั้น\nง่าว\nงี้\nเง็ง\nโง่เขลา\nไง\nจตุคาม\nจ๊อกกี้\nจอหงวน\nจังโก้\nจัมโบ้\nจ๊าบ\nจารกรรม\nจารชน\nจิ๊ก\nจิ๊กโก๋\nจิ๊กซอว์\nจิตพิสัย\nจิตเภท\nจีดีพี\nจึ๊ก\nจุ๊ย\nจูน\nจูเนียร์\nเจ๊\nเจได\nเจ็ต\nเจล\nเจ๊าะแจ๊ะ\nเจี๊ยว\nแจ็กเก็ต\nแจ๊กเก็ต\nแจ็กพอต\nแจ็กพ็อต\nแจ๊กพอต\nแจ๊กพ็อต\nแจม\nแจ๊ส\nโจ๋\nฉลุย\nเฉิ่ม\nชนะเลิศ\nช็อค\nช็อต\nช็อป\nช็อปปิ้ง\nช็อปเปอร์\nชะโนด\nชัตเตอร์\nชัวร์\nชาร์จ\nชาร์ต\nชาร์ป\nชินบัญชร\nชิฟฟอน\nชีส\nชีอะห์\nเช็ก\nเช็งเม้ง\nเชฟ\nเชลียร์\nเชอร์รี่\nแชเชือน\nแช่แข็ง\nแชมป์\nแชมปิยอง\nแชมเปญ\nแชมเปี้ยน\nแชมพู\nโชว์รูม\nโชห่วย\nใช้งาน\nไชน่า\nซ้อ\nซอมบี้\nซะ\nซังเต\nซันตาคลอส\nซัพพลาย\nซัพพลายเออร์\nซัมเมอร์\nซากุระ\nซาดิสต์\nซาดิสม์\nซาตาน\nซานตาคลอส\nซาฟารี\nซาบะ\nซามูไร\nซาร์\nซาร์ดีน\nซาเล้ง\nซิง\nซิ่ง\nซิงเกิล\nซิตี\nซิตี้\nซินโดรม\nซิม\nซิ้ม\nซิมโฟนี\nซิมโฟนี่\nซิลเวอร์\nซี้\nซี้ซั้ว\nซีดาน\nซีน\nซีนีเพล็กซ์\nซีเนียร์\nซีร็อกซ์\nซีรีส์\nซีเรียส\nซีอีโอ\nซื่อบื้อ\nซุนหนี่\nซุปเปอร์\nซูชิ\nซูเปอร์\nซูม\nซูโม่\nซูเอี๋ย\nซูฮก\nเซ็กซ์\nเซ็กซี่\nเซ็กส์\nเซนเซอร์\nเซ็นเซอร์\nเซนเตอร์\nเซ็นเตอร์\nเซ็นทรัล\nเซนส์\nเซ่นไหว้\nเซฟตี้\nเซรามิก\nเซลส์\nเซลส์แมน\nเซอร์\nเซอร์ไพรส์\nเซอร์วิส\nเซาท์\nเซี้ยว\nแซ็ก\nแซกโซโฟน\nแซ็กโซโฟน\nแซนด์วิช\nแซมบ้า\nแซลมอน\nแซว\nโซเชียล\nโซน\nโซนี่\nโซลาร์\nโซโล\nโซโล่\nญาณทัสสนะ\nดยุก\nดยุค\nดร็อป\nดรัมเมเยอร์\nดรามา\nดราม่า\nดอกเตอร์\nด็อกเตอร์\nดัมพ์\nดั๊มพ์\nดาวน์\nดิกชันนารี\nดิสเครดิต\nดีกรี\nดีเจ\nดีไซน์\nดีไซน์เนอร์\nดีไซเนอร์\nดีเบต\nดีพาร์ตเมนต์\nดีพาร์ตเมนท์\nดีพาร์ทเมนต์\nดีพาร์ทเมนท์\nดีมานด์\nดีล\nดีลเลอร์\nดีเลย์\nเดชานุภาพ\nเดบิต\nเดโม\nเดย์\nเด้อ\nเดอะ\nเด๊ะ\nเดี้ยง\nเดี๊ยะ\nแดนซ์\nแดนเซอร์\nแดรี่\nโดนัท\nโดมิโน\nโดรายากิ\nไดเอ็ต\nตถตา\nตนเอง\nตรวจทาน\nตรวจสอบ\nตอกย้ำ\nต๊อง\nต่อยอด\nต่อรอง\nตะหงิด\nตังค์\nตันเถียน\nตัวตน\nตัวเอง\nตาปรือ\nต้าอ่วย\nติงต๊อง\nติ๋ม\nติ่มซำ\nติว\nติวเตอร์\nตี๋\nตื้บ\nตุ๊ก\nตุ๊กตุ๊ก\nตุ๊ด\nตุ๋ย\nตู้เซฟ\nเต๊ะ\nเตี๊ยม\nแตงกวา\nแตงโม\nแต๋ว\nโต๋เต๋\nโต๊ะจีน\nไตรมาส\nถ่ายทำ\nถูกต้อง\nทงคัตสึ\nทริป\nทรู\nทอม\nท็อป\nทอร์นาโด\nทอล์ค\nทักซิโด\nทันตกรรม\nทันตแพทยศาสตร์\nทับซ้อน\nทัวร์\nทัวร์นาเมนต์\nทัวร์นาเมนท์\nทัวริสต์\nทาเลนต์\nทาวน์\nทาวน์เฮาส์\nทำงาน\nทิป\nทิพยสมบัติ\nทิวลิป\nทีรามิสุ\nทีวี\nทูน่า\nเท็กซ์\nเทค\nเทคโน\nเทคโนแครต\nเทควันโด\nเทป\nเทรด\nเทรนด์\nเทรนเนอร์\nเทรลเลอร์\nเทรลเล่อร์\nเทเลกราฟ\nเทวบัญชา\nเทวบุตร\nเทวา\nเทวาธิราช\nเทโวโรหนะ\nเทอร์โบ\nเที่ยงคืน\nเที่ยงวัน\nเทียมทาน\nแทกติค\nแทคติค\nแทงกั๊ก\nแทงโก้\nโทมาฮอก\nโทมาฮอว์ก\nโทมาฮอว์ค\nโทร\nโทรโข่ง\nไทม์\nไทยแลนด์\nไทเฮา\nธรรมา\nธรรมาภิบาล\nธัมโม\nธีม\nธุรกรรม\nธุหร่ำ\nเธค\nนพมาศ\nนรีแพทย์\nน็อก\nน็อค\nน้องใหม่\nนอมินี\nนอร์ท\nน่ะ\nนางแบบ\nนาฏยศาลา\nนายแบบ\nนายพราน\nนินจา\nนิรันดร์\nนิว\nนิวส์\nนู้ด\nเนอะ\nเนิร์สเซอรี\nเนิร์สเซอรี่\nเนี้ยบ\nโนติส\nไนท์\nไนน์\nบรรพชน\nบร็อกโคลี\nบร็อคโคลี\nบรา\nบริกร\nบริวเวอรี่ส์\nบลอนด์\nบลูเบอร์รี\nบลูเบอร์รี่\nบ๊วย\nบอกซ์\nบ็อกซ์\nบ๊อกซ์\nบอดี้\nบอนด์\nบ๊อบ\nบอมบ์\nบ๋อย\nบอยคอต\nบอยคอตต์\nบอร์ด\nบังเกอร์\nบัตเตอร์\nบัลลาสต์\nบัส\nบาบูน\nบาร์บีคิว\nบาร์บี้\nบาลานซ์\nบิ๊ก\nบิล\nบึม\nบึ้ม\nบุญคุณ\nบุ๋น\nบุปผา\nบู๊\nบูชิโด\nบูติก\nบูติค\nบูม\nเบเกอรี่\nเบญจมบพิตร\nเบตาดีน\nเบนโตะ\nเบนโล\nเบบี้\nเบลอ\nเบอร์เกอร์\nเบอร์รี\nเบิร์ด\nเบิร์น\nแบ็กโฮ\nแบคโฮ\nแบด\nแบต\nแบนเนอร์\nแบรนด์\nแบล็ก\nแบล็ค\nไบโอ\nโบกี้\nโบตั๋น\nโบ้ย\nโบรกเกอร์\nโบรชัวร์\nโบว์\nโบว์ลิ่ง\nไบเบิล\nปฏิสัมพันธ์\nป๊อก\nปอดแหก\nป๊อป\nป๋อหลอ\nปักขคณนา\nปัจเจกชน\nปัจฉิมนิเทศ\nป๊า\nป๋า\nป่าไม้\nปาร์ตี้\nปาสกาล\nปาสคาล\nปาสเตอร์\nปิกอัพ\nปิ๊ง\nปิโตรเคมี\nปิยมิตร\nปึ้ก\nปูอัด\nเปโซ\nเป็นไง\nเปปเปอร์มินต์\nเปเปอร์\nเปราะบาง\nเป๊ะ\nเป่ายิงฉุบ\nเป่ายิ้งฉุบ\nเปียโน\nแป้ก\nแป๋ว\nแป๊ะเจี๊ยะ\nโปร\nโปรเจกต์\nโปรเจ็กต์\nโปรเจกเตอร์\nโปรเจ็กเตอร์\nโปรเจคท์\nโปรเจ็คท์\nโปรดักชั่น\nโปรดิวเซอร์\nโปรโมชั่น\nโปรโมต\nโปรโมเตอร์\nโปรโมท\nโปลิศ\nโปสเตอร์\nผลไม้\nผลักดัน\nผ้าห่ม\nผิดพลาด\nผู้นำ\nแผดเผา\nเฝอ\nพงษ์\nพริตตี้\nพรีเซนต์\nพรีเซ็นเตอร์\nพรีเมียม\nพรีเมียร์\nพฤหัส\nพล็อต\nพลาซ่า\nพลานุภาพ\nพ่อค้า\nพอเพียง\nพะเรอ\nพันธกิจ\nพันธุวิศวกรรม\nพาร์\nพาร์ตเนอร์\nพาร์ทเนอร์\nพาวเวอร์\nพาสเจอร์ไรส์\nพาสตา\nพาสต้า\nพาสปอร์ต\nพาเหรด\nพิซซ่า\nพีเรียด\nพุดดิ้ง\nพุทธภูมิ\nพุทธศตวรรษ\nพุทโธ\nพูล\nเพทนาการ\nเพนกวิน\nเพนตากอน\nเพรส\nเพรียวบาง\nเพลซ\nเพลท\nเพลย์บอย\nเพียบแปร้\nเพียว\nเพาเวอร์\nแพกเกจ\nแพ็ค\nแพตเทิร์น\nแพทเทิร์น\nแพทยสภา\nแพนงเชิญ\nแพนดา\nแพนด้า\nแพลน\nโพลล์\nโพลารอยด์\nโพสต์\nไพลิน\nฟยอร์ด\nฟรังก์\nฟรุต\nฟลอร์\nฟลุก\nฟลุค\nฟลุต\nฟลุท\nฟอยล์\nฟอร์ม\nฟันด์\nฟาวล์\nฟาสต์ฟู้ด\nฟินิกซ์\nฟิวเจอร์\nฟีด\nฟีเวอร์\nฟุตบาท\nเฟรช\nเฟรชชี่\nเฟรม\nเฟมินิสต์\nเฟส\nเฟอร์นิเจอร์\nเฟอร์รี่\nเฟิร์ม\nเฟี้ยวฟ้าว\nแฟกซ์\nแฟ็กซ์\nแฟนซี\nแฟนตาซี\nแฟ้บ\nแฟร์\nแฟรนไชส์\nแฟรี\nแฟรี่\nแฟลช\nแฟล็ต\nโฟน\nโฟม\nโฟล์ค\nไฟต์\nไฟแนนซ์\nไฟลต์\nไฟลท์\nภควัทคีตา\nภควัมบดี\nภควัมปติ\nภคันทลาพาธ\nภววิสัย\nภารตะ\nภูมิทัศน์\nม้ง\nมวลชน\nมยุราภิรมย์\nมลภาวะ\nมหภาค\nมหาอุปราชา\nมอคคา\nมอคค่า\nมอนสเตอร์\nม็อบ\nมอบตัว\nมอยส์เจอไรเซอร์\nมอลล์\nมะกัน\nมั้ง\nมัฟฟิน\nมั้ย\nม้านั่ง\nมาเฟีย\nมาม่า\nมายองเนส\nมายาคติ\nมาร์ก\nมาร์เก็ต\nมาร์เก็ตติ้ง\nมาร์ค\nมาร์จิน\nมาร์ช\nมาร์ต\nมาร์ท\nมาราธอน\nม้าหินอ่อน\nมินต์\nมินท์\nมินิ\nมิลค์\nมิวสิค\nมิสซัง\nมิสไซล์\nมิสเตอร์\nมือถือ\nมุมมอง\nเมคอัพ\nเมจิก\nเมจิค\nเมทัล\nเมเปิล\nเมาท์\nเมี่ยงคำ\nแมกกาซีน\nแม็กกาซีน\nแมคเคอเรล\nแม่ค้า\nแมชชีน\nแมชีน\nแมนชั่น\nแมมบ้า\nแมมโบ้\nโมจิ\nโมเดล\nโมเดิร์น\nโมเต็ล\nโมโนเรล\nโมหจริต\nไมค์\nไมเกรน\nยนตรกรรม\nยอมรับ\nยะเยือก\nยังไง\nยากูซ่า\nยาวี\nยิม\nยิว\nยุวทูต\nยูโทเปีย\nยูโร\nยูวี\nเยน\nเยลลี่\nเย้ว\nเยอบีรา\nเยอบีร่า\nเยอร์บีรา\nเยอร์บีร่า\nแยมโรล\nโยเกิร์ต\nโยโย่\nรวมมิตร\nร็อค\nร็อคเก็ต\nรองรับ\nรอมฎอน\nรอยัลตี้\nระโงก\nรันเวย์\nรัม\nรากหญ้า\nราชบัณฑิตยสถาน\nราชานุญาต\nราชานุสาวรีย์\nรามเทพ\nรามาธิบดี\nรามายณะ\nราเม็ง\nราเมน\nรายชื่อ\nราสเบอร์รี\nริกเตอร์\nริคเตอร์\nรีไซเคิล\nรีดไถ\nรีทัช\nรีเทิร์น\nรีไทร์\nรีแบรนด์\nรีพอร์ท\nรีโมต\nรีโมท\nรีวิว\nรีสอร์ต\nรีสอร์ท\nรีเสิร์ช\nรุมบ้า\nรุสโซ\nรูบิก\nรูบิค\nเรซิน\nเรซิ่น\nเรดิโอ\nเรต\nเรตติ้ง\nแรงใจ\nแรงดูด\nแรงผลัก\nแรลลี\nแรลลี่\nโรดแมป\nโรเนียว\nโรแมนติก\nโรแมนติค\nโรล\nโรลออน\nไรเฟิล\nล็อกเกอร์\nลอจิสติกส์\nล็อต\nล็อบบี้\nลอร์ด\nล้มเหลว\nละติน\nละอ่อน\nลาซานญ่า\nลาติน\nลาเต้\nลานีญา\nลามะ\nลิมิต\nลิมูซีน\nลิสต์\nลีก\nลีด\nลีดเดอร์\nลีเมอร์\nลีลาวดี\nลุค\nลูกชาย\nลูกสาว\nเลกเชอร์\nเลคเชอร์\nเลดี้\nเลสเบี้ยน\nเลิฟ\nแลนด์\nแล็บ\nโลโก้\nโลชั่น\nไลท์\nไลน์\nไลฟ์\nวนาราม\nวราราม\nวโรกาส\nว้อดก้า\nวอเตอร์\nวอฟเฟิล\nว้อย\nวอร์ม\nวอร์มอัพ\nวอร์รูม\nวอล์ก\nวอล์ค\nวอลซ์\nวอลนัต\nวอลนัท\nวอลล์\nว่ะ\nวันเวย์\nวัสสา\nวาซาบิ\nวาทกรรม\nวาทะ\nวานิลลา\nวานิลา\nวาฟเฟิล\nวาริชศาสตร์\nว้าว\nวัคค์\nวัจนะ\nวาไรตี้\nวิก\nวิดีโอ\nวิทย์\nวิน\nวิป\nวิปปิ้ง\nวิภัชภาค\nวิว\nวิลล์\nวิลเลจ\nวีเจ\nวีซ่า\nวีดิทัศน์\nวีน\nวีไอพี\nวืด\nเวณิกา\nเวเฟอร์\nเวสต์\nเวอร์\nเวิร์ก\nเวิร์กช็อป\nเวิร์ค\nเวิร์ลด์\nเวิลด์\nแวมไพร์\nไวกิ้ง\nไวเบรเตอร์\nไวอะกร้า\nไวอากร้า\nศากยบุตร\nศิรินทร์\nศิลปวัฒนธรรม\nศิลปากร\nศิวิไลซ์\nศึกษาศาสตร์\nสกรัม\nสกาย\nสกู๊ป\nสเกตช์\nสเก็ตช์\nสคริปต์\nสแควร์\nสงบสุข\nสจ๊วต\nสตรอเบอร์รี\nสตรอเบอรี\nสตรอว์เบอร์รี\nสตริง\nสต็อก\nสต๊อก\nสต็อค\nสต๊อค\nสตอรี\nสตาร์\nสตาร์ท\nสติกเกอร์\nสติ๊กเกอร์\nสตีล\nสตูดิโอ\nสเตชัน\nสเตชั่น\nสเตเดียม\nสเตนเลส\nสเต็ป\nสเตย์\nสเตริโอ\nสเตอริโอ\nสแตนดาร์ด\nสแตนเลส\nสโตน\nสโตร์\nสไตรค์\nสไตล์\nสถาปัตย์\nสไนเปอร์\nสปอต\nสป็อต\nสปอนเซอร์\nสปอร์ต\nสปา\nสปาย\nสปิริต\nสเปก\nสเปค\nสไปเดอร์\nสมณพราหมณ์\nสมาพันธ์\nสมิติเวช\nสโรชา\nสลัม\nสแล็ก\nสโลแกน\nสโลว์\nสไลด์\nสวีท\nสหรัฐ\nสหัชญาณ\nสหัสวรรษ\nสะกอม\nสะเด่า\nสะบึม\nสะบึมส์\nสะออน\nสังโฆ\nสะโหลสะเหล\nสันทนาการ\nสัมนา\nสามช่า\nสามแยก\nสารขัณฑ์\nสี่แยก\nสึนามิ\nสุนทรีย์\nสุริยยาตร\nสุริยยาตร์\nสุหนี่\nเสกสรรค์\nเสพติด\nเสือโคร่ง\nหงวน\nหน่อมแน้ม\nหมวย\nหมั่นโถว\nหม่านโถว\nหมายปอง\nหมิง\nหยวน\nหลวงตา\nหลวงปู่\nหลวงพี่\nหล่อฮังก้วย\nหลินจือ\nห่วย\nเห็นด้วย\nเหมย\nเห่ย\nเหี่ยวย่น\nแหม็บ\nแหวว\nโหงว\nโหงวเฮ้ง\nโหลน\nโหลยโท่ย\nไหง\nไหร่\nอพาร์ตเมนต์\nอพาร์ตเมนท์\nอพาร์ทเมนต์\nอพาร์ทเมนท์\nอมาตยาธิปไตย\nอยุติธรรม\nอริยสงฆ์\nอ่วม\nอวอร์ด\nออกแบบ\nออดิชั่น\nออดิทอเรียม\nออเดอร์\nออโต้\nออทิสติก\nอ่อนด้อย\nออฟ\nออยล์\nออร์แกน\nออร์แกนิก\nออร์แกนิค\nออร์เดอร์\nออรัล\nออสซี่\nอะ\nอัตลักษณ์\nอัตวิสัย\nอันเดอร์\nอันตรกิริยา\nอัลตรา\nอัลไซเมอร์\nอัลบัม\nอัลบั้ม\nอัลมอนด์\nอาข่า\nอาโนเนะ\nอาฟเตอร์\nอาร์ติสต์\nอาร์พีจี\nอาว์\nอาสวะ\nอิกัวนา\nอินดอร์\nอินดัสตรีส์\nอินเตอร์\nอิ่มแปร้\nอิมพีเรียล\nอิเล็กทริก\nอิเล็กทริค\nอิเลียด\nอิสรชน\nอิเหนา\nอิออน\nอีแต๋น\nอีโรติก\nอีเวนท์\nอีสต์\nอีสเตอร์\nอึ๊บ\nอึ้ม\nอึ๋ม\nอึมครึม\nอุด้ง\nอุตสาหการ\nอุเทน\nอุปการคุณ\nอุปทาน\nอุปนายก\nอุปนายิกา\nอุปสงค์\nอุปัทวเหตุ\nอุรังคธาตุ\nอูคูเลเล่\nอู้ฟู่\nเอ๋\nเอ็กซ์โป\nเอ็กซ์เพรส\nเอ็กโซเซต์\nเอ็กโซเซ่ต์\nเอเซีย\nเอ็นจีโอ\nเอ็นเตอร์เทน\nเอนทรานซ์\nเอ็นทรานซ์\nเอฟเฟ็กต์\nเอเยนต์\nเอลนีโญ\nเอสเปรสโซ\nเอสเพรสโซ\nเอ๋อ\nเอาต์\nเอาท์\nเอาท์ดอร์\nเอ๊าะ\nแอ็กชั่น\nแอ็คชั่น\nแอคทีฟ\nแอดมิชชั่น\nแอดมิสชัน\nแอนด์\nแอ๊บแบ๊ว\nแอปเปิล\nแอปเปิ้ล\nแอปพริคอท\nแอพพริคอท\nแอพริคอต\nแอร์\nแอโรบิก\nแอโรบิค\nแอลมอนด์\nแอสเตอร์\nโอเค\nโอเปอเรเตอร์\nโอเปร่า\nโอเพ่น\nโอ้ย\nโอยัวะ\nโอรสาธิราช\nโอเลี้ยง\nโอวัลติน\nโอเวอร์\nไอซ์\nไอซียู\nไอดอล\nไอเดีย\nไอติม\nฮวงจุ้ย\nฮ่องเต้\nฮองเฮา\nฮอต\nฮ็อต\nฮอตดอก\nฮ็อตด็อก\nฮันนีมูน\nฮัม\nฮัลโลวีน\nฮัลโหล\nฮากกา\nฮาร์ด\nฮาราคีรี\nฮาลาล\nฮาโลวีน\nฮิ\nฮิต\nฮิบรู\nฮิปโป\nฮิปฮอป\nฮีโร่\nฮูลาฮูป\nฮูล่าฮูป\nเฮฟวี\nเฮฟวี่\nเฮอร์ริเคน\nเฮีย\nแฮนด์\nแฮปปี้\nแฮมเบอร์เกอร์\nโฮป\nโฮม\nโฮลดิงส์\nโฮลวีต\nโฮสเตส\nไฮกุ\nไฮแจ็ค\nไฮโซ\nไฮเทค\nไฮบริด\nไฮเปอร์\nไฮไลต์\nไฮไลท์\nไฮเวย์\nไฮสคูล\nไฮเอนด์\n\nกรีซ\nกัมพูชา\nกัวเตมาลา\nกาตาร์\nกานา\nกาบอง\nกายอานา\nกินี\nเกรนาดีนส์\nเกรเนดา\nเกาหลี\nแกมเบีย\nโกตดิวัวร์\nคองโก\nคอโมโรส\nคอสตาริกา\nคาซัคสถาน\nคิตส์\nคิริบาตี\nคิริบาส\nคิวบา\nคีร์กีซสถาน\nคูเวต\nเคนยา\nเคปเวิร์ด\nเคย์แมน\nแคนาดา\nแคเมอรูน\nโครเอเชีย\nโคลอมเบีย\nจอร์เจีย\nจอร์แดน\nจาเมกา\nจิบูตี\nจีน\nชาด\nชิลี\nเช็ก\nซามัว\nซาอุ\nซิมบับเว\nซีเรีย\nซูดาน\nซูรินาเม\nเซนต์\nเซเนกัล\nเซอร์เบีย\nเซาตูเม\nเซียร์รา\nแซมเบีย\nโซมาเลีย\nโซเวียต\nไซปรัส\nญี่ปุ่น\nดารุสซาลาม\nเดนมาร์ก\nโดมินิกัน\nโดมินิกา\nตรินิแดด\nตองกา\nติมอร์\nตุรกี\nตูนิเซีย\nเติร์กเมนิสถาน\nโตโก\nโตเบโก\nไต้หวัน\nทาจิกิสถาน\nแทนซาเนีย\nนอร์เวย์\nนามิเบีย\nนาอูรู\nนิการากัว\nนิวซีแลนด์\nเนเธอร์แลนด์\nเนปาล\nเนวิส\nไนจีเรีย\nไนเจอร์\nบราซิล\nบริติช\nบริเตน\nบรูไน\nบอตสวานา\nบอสเนีย\nบังกลาเทศ\nบังคลาเทศ\nบัลแกเรีย\nบาร์บูดา\nบาร์เบโดส\nบาห์เรน\nบาฮามาส\nบิสเซา\nบุรุนดี\nบูร์กินาฟาโซ\nเบนิน\nเบลเยียม\nเบลารุส\nเบลีซ\nเบอร์มิวดา\nโบลิเวีย\nปรินซิปี\nปากีสถาน\nปานามา\nปาปัวนิวกินี\nปารากวัย\nปาเลสไตน์\nปาเลา\nเปรู\nเปอร์เซีย\nเปอร์โตริโก\nโปรตุเกส\nโปแลนด์\nฝรั่งเศส\nพม่า\nฟิจิ\nฟินแลนด์\nฟิลิปปินส์\nเฟรนช์\nภูฏาน\nภูฐาน\nมองโกเลีย\nมอนเตเนโกร\nมอนแทนา\nมอริเชียส\nมอริเตเนีย\nมอลโดวา\nมอลตา\nมัลดีฟส์\nมาเก๊า\nมาซิโดเนีย\nมาดากัสการ์\nมาร์แชลล์\nมาลาวี\nมาลี\nมาเลเซีย\nเม็กซิโก\nเมียนมาร์\nโมซัมบิก\nโมนาโก\nโมนาโค\nโมร็อกโก\nไมโครนีเซีย\nยูกันดา\nยูโกสลาเวีย\nยูเครน\nเยเมน\nเยอรมนี\nรวันดา\nรัสเซีย\nโรมาเนีย\nลักเซมเบิร์ก\nลัตเวีย\nลาว\nลิกเตนสไตน์\nลิทัวเนีย\nลิเบีย\nลีโอน\nลูเซีย\nเลโซโท\nเลบานอน\nเลสเต\nไลบีเรีย\nวาติกัน\nวานูอาตู\nวินเซนต์\nเวเนซุเอลา\nเวียดนาม\nศรีลังกา\nสเปน\nสโลวะเกีย\nสโลวัก\nสโลวีเนีย\nสวาซิแลนด์\nสวิตเซอร์แลนด์\nสวีเดน\nสหรัฐ\nสหราชอาณาจักร\nสิกขิม\nสิงคโปร์\nอเมริกา\nออสเตรเลีย\nออสเตรีย\nอันดอร์รา\nอัฟกานิสถาน\nอาเซอร์ไบจาน\nอาร์เจนตินา\nอาร์เมเนีย\nอาระเบีย\nอิเควทอเรียล\nอิตาลี\nอินเดีย\nอินโดนีเซีย\nอิรัก\nอิสราเอล\nอิหร่าน\nอียิปต์\nอุซเบกิสถาน\nอุรุกวัย\nเอกวาดอร์\nเอธิโอเปีย\nเอมิเรตส์\nเอริเทรีย\nเอลซัลวาดอร์\nเอสโตเนีย\nแองโกลา\nแอนติกา\nแอลจีเรีย\nแอลเบเนีย\nโอมาน\nไอซ์แลนด์\nไอร์แลนด์\nฮ่องกง\nฮอนดูรัส\nฮังการี\nเฮติ\nเฮอร์เซโกวีนา\n\nกระบี่\nกรุงเทพ\nกาญจนบุรี\nกาฬสินธุ์\nกำแพงเพชร\nขอนแก่น\nจันทบุรี\nฉะเชิงเทรา\nชลบุรี\nชัยนาท\nชัยภูมิ\nชุมพร\nเชียงราย\nเชียงใหม่\nตรัง\nตราด\nตาก\nนครนายก\nนครปฐม\nนครพนม\nนครราชสีมา\nนครศรีธรรมราช\nนครสวรรค์\nนนทบุรี\nนราธิวาส\nน่าน\nบึงกาฬ\nบุรีรัมย์\nปทุมธานี\nประจวบคีรีขันธ์\nปราจีนบุรี\nปัตตานี\nพะเยา\nพังงา\nพัทลุง\nพิจิตร\nพิษณุโลก\nเพชรบุรี\nเพชรบูรณ์\nแพร่\nภูเก็ต\nมหาสารคาม\nมุกดาหาร\nแม่ฮ่องสอน\nยโสธร\nยะลา\nร้อยเอ็ด\nระนอง\nระยอง\nราชบุรี\nลพบุรี\nลำปาง\nลำพูน\nเลย\nศรีสะเกษ\nสกลนคร\nสงขลา\nสตูล\nสมุทรปราการ\nสมุทรสงคราม\nสมุทรสาคร\nสระแก้ว\nสระบุรี\nสิงห์บุรี\nสุโขทัย\nสุพรรณบุรี\nสุราษฎร์\nสุราษฎร์ธานี\nสุรินทร์\nหนองคาย\nหนองบัวลำภู\nอยุธยา\nอ่างทอง\nอำนาจเจริญ\nอุดรธานี\nอุตรดิตถ์\nอุทัยธานี\nอุบลราชธานี\nกันทรลักษ์\nจตุจักร\nไชยา\nซีคอน\nดอนเมือง\nถลาง\nไทรโยค\nธนบุรี\nธัญบุรี\nบางกอก\nบางปะกง\nบางระจัน\nปะทิว\nปาย\nพญาไท\nพัฒน์พงษ์\nพัทยา\nพารากอน\nภูมิซรอล\nรัตนาธิเบศร์\nรังสิต\nลันตา\nลาดพร้าว\nวโรรส\nวิภาวดี\nสตึก\nสมุย\nสัตหีบ\nสิมิลัน\nสุขุมวิท\nสุไหง\nเสลภูมิ\nอังรีดูนังต์\nอ่างขาง\nอินทนนท์\nเอ็มโพเรียม\n\nคิวชู\nแคริบเบียน\nแคสเปียน\nดานูบ\nตะนาวศรี\nนอร์วีเจียน\nนิโคบาร์\nเนรัญชรา\nไนล์\nบอร์เนียว\nบอลติก\nเบงกอล\nปิง\nแปซิฟิก\nมะละกา\nมินดาเนา\nมิสซิสซิปปี\nเมดิเตอร์เรเนียน\nเมโสโปเตเมีย\nยมุนา\nยุโรป\nยูเรเชีย\nยูเรเซีย\nแยงซี\nแยงซีเกียง\nสแกนดิเนเวีย\nสะโตง\nสาละวิน\nสุมาตรา\nสุเอซ\nอะเมซอน\nอันดามัน\nอัลไต\nอาร์กติก\nอาหรับ\nอินโดจีน\nอิรวดี\nอิระวดี\nอีเจียน\nอุษาคเณย์\nอูราล\nเอเชีย\nเอเดรียติก\nเอเวอเรสต์\nแอตแลนติก\nแอนตาร์กติก\nแอนตาร์กติกา\nแอฟริกา\nโอลิมปัส\nไอโอเนียน\nฮวงโห\nฮอกไกโด\nฮอนชู\n\nกบิลพัสดุ์\nกุสินารา\nโกลิยะ\nโกสัมพี\nโคตรบอง\nโคตรบูรณ์\nตองอู\nทรอย\nทวารวดี\nทวาราวดี\nเทวทหะ\nไทรบุรี\nนาลันทา\nไบแซนไทน์\nปรัสเซีย\nปัลลวะ\nปาฏลีบุตร\nพุทธคยา\nมถุรา\nมายัน\nมิถิลา\nราชคฤห์\nล้านช้าง\nล้านนา\nลุมพินี\nวัชชี\nเวสาลี\nสารนาถ\nสาวัตถี\nหริภุญชัย\nอโยธยา\nออตโตมัน\nอังวะ\nอินทปัตถ์\nอุชเชนี\n\nกราฟิก\nกราฟิกส์\nกราฟิค\nกริด\nกิกะไบต์\nกูเกิล\nกูเกิ้ล\nเกตเวย์\nโกลบอล\nคลัสเตอร์\nคลาส\nคลิก\nคลิปอาร์ต\nคอนโซล\nคอนเทนต์\nคอมพิวติ้ง\nคอมไพล์\nคอมไพเลอร์\nคอมมูนิเคชั่น\nคอร์\nคีย์\nคีย์บอร์ด\nเครือข่าย\nเคอร์เซอร์\nเคอร์เนล\nแคช\nแคมฟรอก\nแคมฟร็อก\nแคร็ก\nโค้ด\nจาวา\nจีพีเอส\nชิป\nชิพ\nเชลล์\nแช็ต\nแชนเนล\nแชนแนล\nซ็อกเก็ต\nซอฟต์แวร์\nซอฟท์แวร์\nซอร์ส\nซัพพอร์ต\nซัพพอร์ท\nซีดี\nซีดีรอม\nซีเนอร์\nเซิร์ฟเวอร์\nโซลูชัน\nโซลูชั่น\nไซต์\nไซเบอร์\nทรานแซกชัน\nทรานแซกชั่น\nทรานแซ็กชัน\nทรานแซ็กชั่น\nทรานแซคชัน\nทรานแซคชั่น\nทรานแซ็คชัน\nทรานแซ็คชั่น\nทวิตเตอร์\nทวีต\nทัชแพด\nเทมเพลต\nเทอร์มินัล\nแท็ก\nแท็บ\nแทบเล็ต\nโทรจัน\nเน็ต\nเน็ตบุ๊ก\nเน็ตบุค\nเน็ตบุ๊ค\nเน็ตเวิร์ก\nเน็ตเวิร์ค\nโน้ตบุ๊ก\nโน้ตบุค\nโน้ตบุ๊ค\nดอส\nดาวน์เกรด\nดาวน์โหลด\nดิจิตอล\nดิจิทัล\nดีบั๊ก\nดีวีดี\nดีไวซ์\nเดเบียน\nเดลไฟ\nเดสก์ท็อป\nโดเมน\nไดรว์\nไดรเวอร์\nไดเรกทอรี\nไดโอด\nเทเลคอม\nบล็อกเกอร์\nบรอดแบนด์\nบราวเซอร์\nบลูทูท\nบลูทูธ\nบลูเรย์\nบั๊ก\nบัฟเฟอร์\nบิต\nบิท\nบูต\nเบราว์เซอร์\nแบนด์วิดท์\nไบต์\nไบนารี\nโปรแกรมเมอร์\nโปรเซส\nโปรเซสเซอร์\nโปรโตคอล\nพร็อกซี\nพอร์ต\nพอร์ท\nพาเนล\nพาร์ทิชัน\nพารามิเตอร์\nพาสเวิร์ด\nพิกเซล\nเพจ\nเพจเจอร์\nแพกเก็ต\nแพตช์\nแพลตฟอร์ม\nโพรเซส\nโพรเซสเซอร์\nโพรโทคอล\nไพธอน\nฟล็อปส์\nฟอนต์\nฟอร์แมต\nฟอร์เวิร์ด\nฟอรัม\nฟีเจอร์\nเฟซบุ๊ก\nเฟิร์มแวร์\nแฟล็ก\nโฟลเดอร์\nไฟร์ฟอกซ์\nไฟร์วอลล์\nไฟล์\nมอดูล\nมอนิเตอร์\nมัลติ\nมัลติทัช\nมัลติเพล็กซ์\nมัลแวร์\nมาสเตอร์\nมีเดีย\nเมนู\nเมมโมรี\nเมล\nเมาส์\nแมค\nโมดูล\nโมเด็ม\nโมบาย\nโมบายล์\nโมไบล์\nไมโครซอฟท์\nยูนิกซ์\nยูนิโคด\nยูนิโค้ด\nริงโทน\nรีเฟรช\nรีเลย์\nเราเตอร์\nเรียลไทม์\nลิงก์\nลินุกซ์\nลีนุกซ์\nลูป\nเลเยอร์\nแล็ปท็อป\nไลเซนส์\nไลบรารี\nวิกิ\nวิกิพีเดีย\nวินโดวส์\nวินโดว์ส\nเว็บ\nเวอร์ชวล\nเวอร์ชัน\nเวอร์ชั่น\nเวิร์กสเตชัน\nเวิร์กสเตชั่น\nเวิร์คสเตชัน\nเวิร์คสเตชั่น\nเวิร์ด\nเวิร์ม\nไวแมกซ์\nสกรีน\nสแกน\nสแกนเนอร์\nสแต็ก\nสนิฟเฟอร์\nสปายแวร์\nสเปซ\nสแปม\nสมาร์ท\nสล็อต\nเสิร์ช\nโหลด\nออนไลน์\nออปติก\nออปติคอล\nออปติคัล\nออฟไลน์\nออราเคิล\nอัพเกรด\nอัพเดต\nอัพโหลด\nอัปเกรด\nอัปเดต\nอัปโหลด\nอัลกอริทึม\nอาร์กิวเมนต์\nอินเตอร์เน็ต\nอินทิเกรเตอร์\nอินเทอร์เน็ต\nอินเทอร์เฟซ\nอินเทล\nอินพุต\nอินพุท\nอีเมล\nอีเมล์\nอูบุนตู\nอูบันตู\nเอนจิน\nเอ็นจิน\nเอาต์พุต\nเอาต์พุท\nเอาท์พุต\nเอาท์พุท\nแอนะล็อก\nแอนิเมชัน\nแอนิเมชั่น\nแอปพลิเคชัน\nแอปพลิเคชั่น\nแอพพลิเคชัน\nแอพพลิเคชั่น\nแอสเซมบลี\nแอสเซมเบลอร์\nโอเพน\nไอคอน\nไอซี\nไอพอด\nไอพ็อด\nไอแพด\nไอโฟน\nฮับ\nฮาร์ดดิสก์\nฮาร์ดแวร์\nแฮกเกอร์\nแฮ็กเกอร์\nแฮนด์เฮลด์\nโฮสต์\n\nกรีก\nกัณณาฑ\nกัศมีรี\nคันจิ\nคาตาคานะ\nคุชราตี\nคุรุมุขี\nซีริลลิก\nซูลู\nเซลติก\nเซิร์บ\nตากาล็อก\nเตลุคู\nเติร์ก\nทราวิฑ\nเบงกาลี\nปัญจาบี\nพินอิน\nมลยาฬัม\nมองโกล\nมาราฐี\nมาเลย์\nเม็กซิกัน\nแมนจู\nแมนดาริน\nไมถิลี\nเยอรมัน\nรัสเซียน\nสวาฮิลี\nสวิส\nสินธี\nอูรดู\nอัสสมี\nอารบิก\nอิตาเลียน\nอุยกูร์\nแอฟริกัน\nโอริยา\nไอริช\nฮันกึล\nฮินดี\nฮิรางานะ\nฮีบรู\n\nกรีนพีซ\nกรือเซะ\nกวนอิม\nกวนอู\nกัดดาฟี\nกัลยาณวัตร\nกัสสปะ\nกาลิเลโอ\nกินเนส\nกุมภกรรณ\nกูเตนเบิร์ก\nเกตส์\nเกษมณี\nโกณฑัญญะ\nขงเบ้ง\nคริสโตเฟอร์\nคองคอร์ด\nคอลเกต\nคานธี\nคาเบรียล\nคาร์ฟูร์\nคาร์สัน\nคาราบาว\nคาสิโอ\nคิริน\nคุนลุ้น\nคูโบต้า\nเครมลิน\nแคทรีนา\nโคตมะ\nโคตมี\nโคลัมบัส\nไคฟง\nไครสเลอร์\nง้อไบ๊\nจตุพร\nจ็อบส์\nจอห์น\nจิ้น\nจิม\nจิ๋ม\nจิว\nจุฬาภรณ์\nจุฬาลงกรณ์\nเจมส์\nแจ็กสัน\nโจเซฟ\nโจว\nชมัยมรุเชฐ\nชมัยมรุเชษฐ์\nชเวดากอง\nชาร์ลส์\nชินราช\nชินวัตร\nชุนชิว\nเช็ง\nเชตวัน\nเชฟรอน\nเชฟโรเลต\nเชลซี\nไชยานุชิต\nซ่ง\nซังฮี้\nซัดดัม\nซันซิล\nซัมซุง\nซัวเจ๋ง\nซินหัว\nซีซาร์\nซีแพค\nซูซาน\nซูซูกิ\nซูบารุ\nเซ็นทารา\nเซเวน\nเซเว่น\nโซฟิเทล\nโซยุซ\nโซยูซ\nณัฐวุฒิ\nดาร์ลี่\nดาวโจนส์\nดิสนีย์\nดีแทค\nดูปองท์\nเดโมแครต\nเดลล์\nเดลินิวส์\nเดวิด\nแดวู\nโดนัลด์\nโดราเอมอน\nโดเรมอน\nต๋อง\nตั๊กม้อ\nตากสิน\nตาเมือน\nตาลีบัน\nตูน\nเตมีย์\nโต๋\nโตชิบา\nโตโยต้า\nถังซัมจั๋ง\nถังซำจั๋ง\nทรพา\nทราเวล\nทรูมูฟ\nทีปังกร\nเทปโก\nเทพรัตน\nเทวทัต\nเทสโก้\nโทมัส\nไททานิก\nไททานิค\nไทยรัฐ\nธีออส\nนครินทรา\nนโปเลียน\nนพดล\nนราดูร\nนเรนทร\nนอสตราดามุส\nนาซา\nนาซ่า\nนาซี\nนาโต\nนาโต้\nนาลแก\nนิคอน\nนิโคลัส\nนิด้า\nนินเทนโด\nนิปปอน\nนิวตัน\nนิสสัน\nเนคเทค\nเนชั่น\nเนชันแนล\nเนชั่นแนล\nเนวิน\nเนสเล่\nเนสาด\nแนท\nแนสแดค\nโนเกีย\nโนเบล\nโนเวลล์\nโนโวเทล\nไนเม็กซ์\nบรอดเวย์\nบรัดเลย์\nบรู๊ซ\nบัลเมอร์\nบารัก\nบารัค\nบู๊ตึ๊ง\nเบญกาย\nเบนซ์\nเบ็นซ์\nเบนจามิน\nโบตัน\nไบโอเทค\nประชาธิปัตย์\nปวีณา\nปอเต็กตึ๊ง\nปอเต๊กตึ๊ง\nป่อเต็กตึ๊ง\nปัตตะโชติ\nปารุสก์\nปีเตอร์\nปูติน\nเป๊ปซี่\nเป้ย\nเปอร์โยต์\nเปาบุ้นจิ้น\nโปเกมอน\nโป๊ยก่าย\nพรหมทัต\nพลาโต\nพอลล่า\nพานาโซนิค\nพานาโซนิก\nพิทยานุกูล\nพิมพิสาร\nเพนแทกซ์\nเพลโต\nไพโอเนียร์\nฟรอยด์\nฟรังซิส\nฟรานซิส\nฟลอเรนซ์\nฟอร์ด\nฟิลิปส์\nฟูจิ\nแฟซ่า\nโฟร์โมสต์\nภูมิพล\nภูริทัต\nมงฟอร์ต\nมณโฑ\nมติชน\nมหิตลาธิเบศร\nมโหสถ\nมัจฉานุ\nมาร์กาเร็ต\nมาร์ติน\nมาสด้า\nมิตซูบิชิ\nมิราเคิล\nมุสโสลินี\nเม้ง\nเมจิ\nเมอร์ซีเดส\nเมอร์เซเดส\nแมกซ์เวลล์\nแมกไซไซ\nแมคอินทอช\nแมชีนเนอรี่\nโมคคัลลานะ\nโมโตโรลา\nโมโตโรล่า\nโมเนีย\nไมเคิล\nไมยราพณ์\nยโสธรา\nยะโฮวา\nยะโฮวาห์\nยามาฮ่า\nยาเวห์\nยาฮู\nยูนิเซฟ\nยูเนสโก\nยูไล\nเยโฮวาห์\nรอยเตอร์\nรอยัล\nรัชดา\nรัสปูติน\nราฟาเอล\nรามาวตาร\nราเมศวร\nราหุล\nริชาร์ด\nรีพับลิกัน\nรูนีย์\nเรนโบว์\nแรมโบ้\nโรตารี\nโรนัลโด\nโรนัลโด้\nโรบินสัน\nโรเบิร์ต\nล็อกซเล่ย์\nลิงคอล์น\nลิจฉวี\nลิไท\nลิไทย\nลินคอล์น\nลิเวอร์พูล\nเลโนโว\nเลียดก๊ก\nโลตัส\nวชิราลงกรณ์\nวลาดิเมียร์\nวอลล์สตรีท\nวาเลนไทน์\nวิกตอเรีย\nวิทยานุสรณ์\nวิทยายน\nวิมเบิลดัน\nวิลเลียม\nวีระ\nวุฒิชัย\nเวียดกง\nไวตามิลค์\nศกุนตลา\nศรีวิชัย\nศิริพงษ์\nศิริราช\nศุภชลาศัย\nสดกก๊อกธม\nสดายุ\nสตาลิน\nสตีฟ\nสแตนฟอร์ด\nสวรินทิรา\nสังกัจจายน์\nสาทิตย์\nสารีบุตร\nสิริกิติ์\nสิรินธร\nสิหิงค์\nสีวลี\nสีหนุ\nสีหมุนี\nสีหโมนี\nสุครีพ\nสุทโธทนะ\nสุเทพ\nสุนทราภรณ์\nสุนีย์\nสุรนารี\nสุรยุทธ์\nสุริยาสน์\nเส้าหลิน\nโสกราตีส\nโสภิต\nหนุมาน\nหลินฮุ่ย\nหลุยส์\nเห้งเจีย\nไหหม่า\nองคต\nองคุลิมาล\nอชาตศัตรู\nอดุลยเดช\nอพอลโล\nอริสโตเติล\nอริสมันต์\nอลิซาเบธ\nอ๋อม\nออร์คิด\nออสการ์\nอะพอลโล\nอับราฮัม\nอั้ม\nอัลกออิดะห์\nอัลคาเทล\nอัลจาซีราห์\nอัลเฟรด\nอัลเลาะห์\nอัสซุส\nอัสสชิ\nอัสสัมชัญ\nอาเซม\nอาเซ็ม\nอาเซียน\nอาฟต้า\nอาร์เซนอล\nอินทรชิต\nอินทราทิตย์\nอีซูซุ\nอีเลฟเวน\nอีเลฟเว่น\nอุณรุท\nอุบลรัตน์\nอุบาลี\nอุ๋ย\nเอกทัศน์\nเอเซอร์\nเอ็ดเวิร์ด\nเอดิสัน\nเอแบค\nเอลิซาเบธ\nเอสพลานาด\nเอสพลานาร์ด\nแอคคอร์\nแอคคอร์ด\nแองเจลิน่า\nแอตแลนติส\nแอน\nแอ๋ม\nแอมบาสซาเดอร์\nแอมบาสเดอร์\nแอมเวย์\nแอ๋ว\nโอดีสซีย์\nโอเดียน\nโอบามา\nโอรสาราม\nโอลิมเปีย\nโออิชิ\nไอน์สไตน์\nฮอนด้า\nฮอปกินส์\nฮอลลีวูด\nฮอลลีวู้ด\nฮานามิ\nฮามาส\nฮิตเลอร์\nฮิตาชิ\nฮุนเซน\nฮุนเซ็น\nฮุนได\nฮุสเซ็น\nเฮนรี\nเฮนรี่\nเฮเลน\nโฮจิมินห์\nโฮปเวลล์\nโฮเมอร์\n\nกลีเซอรีน\nกำทอน\nแกนีมีด\nครอส\nคริสตัล\nคลอโรพลาสต์\nคลอไรด์\nควอนตัม\nคอนดักเตอร์\nคอปเปอร์\nคอลลาเจน\nคอเลสเตอรอล\nคอสมิก\nคูลอมบ์\nเคอราติน\nแคโรทีน\nแคสสินี\nโครมาโทกราฟี\nไคโตซาน\nจีโนม\nจุลชีววิทยา\nชิคุนกุนยา\nซัลฟิวริก\nซัลเฟต\nซัลไฟด์\nซิงค์\nซิริอุส\nซิลิกา\nซิลิเกต\nซิลิโคน\nซีเทน\nซีเวิร์ต\nเซ็กเตอร์\nเซ็กเมนต์\nเซมิ\nโซนาร์\nไซบอร์ก\nดอปเปลอร์\nดอปเพลอร์\nไดนามิก\nไดนามิกส์\nไดนามิค\nไดนามิคส์\nไดออกไซด์\nทรานส์\nทามิฟลู\nเทฟลอน\nเทสโทสเตอโรน\nเทอร์โม\nแทนนิน\nไททัน\nไทฟอยด์\nไทรอยด์\nธาลัสซีเมีย\nเนกาตีฟ\nโนวา\nบอแรกซ์\nโบทอกซ์\nโบท็อกซ์\nไบโอติน\nปฏิยานุพันธ์\nโปรเจสเตอโรน\nพอลิเมอร์\nพันธุศาสตร์\nพัลซาร์\nพาร์กินสัน\nพาราเซตามอล\nพาราโบลา\nเพอร์ออกไซด์\nโพรเจสเทอโรน\nโพลาไรซ์\nโพลิเมอร์\nโพลีเอทิลีน\nไพรเมต\nฟลาโวนอยด์\nฟลูออเรสเซนซ์\nฟลูออไรด์\nฟอสซิล\nฟิชชัน\nฟิวชัน\nฟีโรโมน\nไฟเบอร์\nมอนอกไซด์\nมิราจ\nเมตริกซ์\nเมทริกซ์\nเมลานิน\nเมลามีน\nโมเมนตัม\nไมโตคอนเดรีย\nไมโทคอนเดรีย\nยีสต์\nยูริก\nยูเรีย\nรูมาตอยด์\nวีก้า\nเวกเตอร์\nเวก้า\nเวสิเคิล\nโวลต์\nสเกล\nสเกลาร์\nสเต็ม\nสเตียรอยด์\nสปีชีส์\nสเปิร์ม\nสัมพัทธภาพ\nสุริยจักรวาล\nออกเทน\nออโรรา\nออโรร่า\nอะคริลิก\nอะครีลิก\nอะซีติก\nอะซีโตน\nอะมิโน\nอะลูมินา\nอันโดรเมดา\nอัลคาไลน์\nอัลตราซาวด์\nอัลตราซาวนด์\nอัลลอยด์\nอินทิกรัล\nอินทิเกรต\nอีโบลา\nอีโบล่า\nเอ็กซ์โพเนนเชียล\nเอทานอล\nเอทิลีน\nเอนโทรปี\nเอสเตอร์\nเอสโตรเจน\nเอสโทรเจน\nแอนดรอยด์\nแอนแทร็กซ์\nแอมพลิจูด\nแอมโมเนียม\nแอลกอฮอลิซึม\nแอสพาร์แตม\nโอเซลทามิเวียร์\nฮับเบิล\nฮิวมัส\nไฮดรอกไซด์\nไฮดรอลิก\nไฮโดรลิก\nไฮเพอร์โบลา\n\nกงเต็ก\nกฎุมพี\nกฏ\nกฏหมาย\nกบฎ\nกราไฟต์\nก๊อปปี้\nกะทะ\nกังวาล\nกุฎฐัง\nกุฏุมพี\nฃวด\nคฑา\nคลินิค\nคลีนิก\nคลีนิค\nคาทอลิค\nคึ่นฉ่าย\nแคตตาล็อก\nโควต้า\nฅน\nจุมพฎ\nช็อคโกแลต\nแซ่ด\nดัทช์\nทนง\nทรมาณ\nทราก\nทะแยง\nทิฏฐิ\nบล็อค\nบ๊องแบ๊ว\nบัลเล่ต์\nเบรค\nแบงค์\nปรากฎ\nปัคคหะ\nปาฏิโมกข์\nปิติ\nปิรามิด\nโปรเตสแตนท์\nพนิช\nพยักเพยิด\nพริ้ว\nพลูโตเนียม\nพากษ์\nเฟิร์น\nยากี้\nเยภุยยสิกา\nรุสเซีย\nฤาษี\nล็อค\nล็อคเกอร์\nวันทยาหัตถ์\nวานิช\nวิญญาน\nวิศิษฐ์\nศรีษะ\nสเปกโทรสโคป\nสฤษฎ์\nสลิ่ม\nสัตตสดก\nสาราณียากร\nสุกี้\nสุกี้ยากี้\nสูญญากาศ\nหยอมแหยม\nหยอย\nหล่ะ\nอะดรีนาลีน\nอะหลั่ย\nอัตคัต\nอัฟริกา\nอานิสงค์\nอาฟริกา\nอิริยาบท\nอิเลคโทรนิคส์\nอีรุงตุงนัง\nอุตรายัน\nอุลตรา\nอุลตร้า\nโอกาศ\n\nกกหู\nกงการ\nกงจักร\nกฎเกณฑ์\nกฎบัตร\nกฎหมาย\nกฎหมู่\nกดขี่\nกดดัน\nก้นกบ\nก้นบึ้ง\nก้นปล่อง\nกนิษฐภคินี\nกนิษฐภาดา\nกรงเล็บ\nกรมการ\nกรมท่า\nกรมธรรม์\nกรมนา\nกรมวัง\nกรรมกร\nกรรมการ\nกรรมฐาน\nกรรมบถ\nกรรมพันธุ์\nกรรมวิธี\nกรรมสิทธิ์\nกระจกเงา\nกระจกตา\nกระจกนูน\nกระจกเว้า\nกระจอกชวา\nกระจอกเทศ\nกระจ้อยร่อย\nกระจับบก\nกระจับปิ้ง\nกระจับปี่\nกระโชกโฮกฮาก\nกระดานดำ\nกระดานหก\nกระดาษแก้ว\nกระดาษไข\nกระดาษทราย\nกระดาษสา\nกระดูกงู\nกระทาชาย\nกระเท่เร่\nกระบวนการ\nกระบองเพชร\nกระผีกริ้น\nกระยาทิพย์\nกระยาสารท\nกระยาหาร\nกระสอบทราย\nกระสุนปืน\nกระแสจิต\nกระแสน้ำ\nกระแสลม\nกรับคู่\nกรับพวง\nกรับเสภา\nกราดเกรี้ยว\nกราวรูด\nกริ่งเกรง\nกรีฑาสถาน\nกรีดกราย\nกรี๊ดกร๊าด\nกลไก\nกลบท\nกลเม็ด\nกลยุทธ์\nกลวิธี\nกลศาสตร์\nกลอักษร\nกลบเกลื่อน\nกลมกล่อม\nกลมกลืน\nกลมเกลียว\nกล้วยแขก\nกล้วยไม้\nกล่องเสียง\nกล่อมเกลา\nกล่อมเกลี้ยง\nกลัดกลุ้ม\nกลัดมัน\nกลั่นกรอง\nกลั่นแกล้ง\nกลับกลอก\nกลางคน\nกลางคัน\nกลางค่ำ\nกลางคืน\nกลางแจ้ง\nกลางแปลง\nกลางวัน\nกลาดเกลื่อน\nกล่าวขวัญ\nกล่าวโทษ\nกล่าวหา\nกล้ำกราย\nกล้ำกลืน\nกลิ้งกลอก\nกลิ้งเกลือก\nกลิ่นอาย\nกลียุค\nกวดขัน\nกวัดแกว่ง\nกวัดไกว\nกวีนิพนธ์\nก่อกวน\nก่อการ\nก่อตั้ง\nก่อสร้าง\nก่อหวอด\nก้อร่อก้อติก\nกองกลาง\nกองเกิน\nกองโจร\nกองทัพ\nกองทุน\nกองพล\nกองพัน\nกองฟอน\nกองร้อย\nกองหนุน\nกอบโกย\nกะเกณฑ์\nกะบังลม\nกักกัน\nกักขัง\nกักตัว\nกักตุน\nกัณฑ์เทศน์\nกัดฟัน\nกันชน\nกันท่า\nกันสาด\nกันเอง\nกับแกล้ม\nกับข้าว\nกับระเบิด\nกากเพชร\nกากหมู\nกาชาด\nกาญจนาภิเษก\nก้านคอ\nกาฝาก\nก้ามกราม\nกามกิจ\nกามคุณ\nกามเทพ\nกามโรค\nก้ามปู\nกายกรรม\nกายบริหาร\nกายภาพ\nกายวิภาค\nกายสิทธิ์\nก่ายกอง\nการคลัง\nการเงิน\nการบ้าน\nการเปรียญ\nการเมือง\nการเรือน\nการละเล่น\nกาลกิริยา\nกาลเทศะ\nก้าวก่าย\nก้าวร้าว\nก้าวหน้า\nกาสาวพัสตร์\nกาฬพฤกษ์\nกาฬโรค\nกำปั้น\nกำมือ\nกำแพงขาว\nกำลังใจ\nกำลังม้า\nกี่งอำเภอ\nกิจกรรม\nกิจการ\nกิจวัตร\nกิจจะลักษณะ\nกิตติคุณ\nกิตติศัพท์\nกินขาด\nกินใจ\nกินดอง\nกินโต๊ะ\nกินแบ่ง\nกินเปล่า\nกินเลี้ยง\nกินเส้น\nกินแหนง\nกิโลกรัม\nกิโลเมตร\nกิโลลิตร\nกิโลเฮิรตซ์\nกีดกัน\nกีดกั้น\nกีดขวาง\nกึกก้อง\nกึกกัก\nกึกกือ\nกึ่งกลาง\nกุกกัก\nกุ๊กกิ๊ก\nกุ้งฝอย\nกุ้งมังกร\nกุ้งแห้ง\nกุ้งเต้น\nกุ้งยิง\nกุญแจผี\nกุญแจมือ\nกุญแจเลื่อน\nกุญแจเสียง\nกุลธิดา\nกุลบุตร\nกุลสตรี\nกู้ยืม\nเก้งก้าง\nเก็บกวาด\nเก็บเกี่ยว\nเก็บงำ\nเก็บตก\nเกรงกลัว\nเกรงใจ\nเกรงขาม\nเกรียงไกร\nเกรียมกรม\nเกรี้ยวกราด\nเกล็ดเลือด\nเกลี้ยกล่อม\nเกลี้ยงเกลา\nเกลือกกลั้ว\nเกลือกกลิ้ง\nเกลื่อนกล่น\nเกลื่อนกลาด\nเกศธาตุ\nเกษตรกร\nเกษตรกรรม\nเกษตรศาสตร์\nเกษมสันต์\nเกษียรสมุทร\nเก้อเขิน\nเกาะแกะ\nเกี่ยงงอน\nเกียจคร้าน\nเกียรติคุณ\nเกียรตินิยม\nเกียรติประวัติ\nเกียรติภูมิ\nเกียรติยศ\nเกียรติศักดิ์\nเกียรติมุข\nเกี่ยวข้อง\nเกี่ยวดอง\nเกี่ยวพัน\nเกี่ยวโยง\nเกี้ยวพาน\nเกี้ยวพาราสี\nแก่แดด\nแก้ขัด\nแก้ไข\nแก้ตัว\nแก้เผ็ด\nแก้ลำ\nแกงคั่ว\nแกงจืด\nแกงบวด\nแกงป่า\nแกงเผ็ด\nแกงส้ม\nแก่งแย่ง\nแก่นแก้ว\nแก่นสาร\nแก้วตา\nแก้วหู\nแกว่งกวัด\nแกว่งไกว\nแกะรอย\nโก้เก๋\nโกรธเกรี้ยว\nโกรธขึ้ง\nไก่เขี่ย\nไก่ชน\nไก่บ้าน\nไก่ป่า\nไก่ฟ้า\nไกล่เกลี่ย\nขจัดขจาย\nขนเพชร\nขนสัตว์\nขนหนู\nขนส่ง\nขนมจีน\nขบขัน\nขบวนการ\nข่มขี่\nข่มขู่\nข่มขืน\nข่มเหง\nขมหิน\nขมิ้นชัน\nขมุบขมิบ\nขยะแขยง\nขยักขย่อน\nขยักขย้อน\nขยับขยาย\nขยับเขยื้อน\nขวดโหล\nขวยเขิน\nขวัญใจ\nขวัญตา\nขวัญอ่อน\nขวากหนาม\nขวางโลก\nของ้าว\nขอสับ\nขอขมา\nขอทาน\nขอโทษ\nขอร้อง\nขออภัย\nข้อเขียน\nข้อความ\nข้อเท็จจริง\nของกลาง\nของขวัญ\nของแข็ง\nของชำ\nของลับ\nของเล่น\nของว่าง\nของเหลว\nของไหล\nของไหว้\nข้องใจ\nข้องแวะ\nขอบข่าย\nขอบเขต\nขอบคุณ\nขอบใจ\nขอบพระคุณ\nข้อมูล\nข้อแม้\nข้อหา\nข้อสังเกต\nขัดข้อง\nขัดขืน\nขัดเขิน\nขัดจังหวะ\nขัดดอก\nขัดแตะ\nขัดยอก\nขัดแย้ง\nขัดสมาธิ\nขันหมาก\nขันอาสา\nขับขี่\nขับเคี่ยว\nขั้วโลก\nขาจร\nขาประจำ\nข้าราชการ\nข้าศึก\nข้าหลวง\nขาดแคลน\nขาดใจ\nขาดตอน\nขาดตัว\nขาดทุน\nขาดเหลือ\nขายหน้า\nข่าวกรอง\nข่าวคราว\nข่าวล่า\nข่าวลือ\nข่าวสาร\nข้าวเกรียบ\nข้าวแกง\nข้าวของ\nข้าวจี่\nข้าวเจ้า\nข้าวซอย\nข้าวต้ม\nข้าวตอก\nข้าวตัง\nข้าวแตน\nข้าวทิพย์\nข้าวบิณฑ์\nข้าวเปลือก\nข้าวโพด\nข้าวฟ่าง\nข้าวเม่า\nข้าวสวย\nข้าวสาร\nข้าวเหนียว\nข้าวหมาก\nข้าวหลาม\nขี้เกียจ\nขี้ข้า\nขี้ครอก\nขี้คร้าน\nขี้คุก\nขี้ไคล\nขี้เซา\nขีดขั้น\nขีดคร่อม\nขีดคั่น\nขีดฆ่า\nขี้ตา\nขี้ตืด\nขี้เถ้า\nขี้ทูด\nขี้ปะติ๋ว\nขี้ผึ้ง\nขี้มูก\nขี้ยา\nขี้แย\nขี้ริ้ว\nขี้เรื้อน\nขี้เล็บ\nขี้หู\nขี้หน้า\nขี้เหนียว\nขี้เหล็ก\nขี้เหร่\nขึงขัง\nขึงพืด\nขึ้งโกรธ\nขึ้นใจ\nขึ้นชื่อ\nขึ้นมือ\nขืนใจ\nขื่นขม\nขุดคุ้ย\nขุนทอง\nขุนนาง\nขุนพล\nขุนศึก\nขุนหลวง\nขูดรีด\nเข็มกลัด\nเข็มขัด\nเข้มข้น\nเข้มแข็ง\nเข้มงวด\nเข็มทิศ\nเข็มหมุด\nเข้าขา\nเข้าเค้า\nเข้าใจ\nเข้าชื่อ\nเข้าตัว\nเข้าถึง\nเข้าทรง\nเข้าท่า\nเข้าที\nเข้าเนื้อ\nเข้าเล่ม\nเขียวเสวย\nเขียวหวาน\nแขกเต้า\nแข็งกร้าว\nแข็งกล้า\nแข็งแกร่ง\nแข็งข้อ\nแข็งขัน\nแข่งขัน\nแข็งใจ\nแข็งตัว\nแข็งเมือง\nแข็งแรง\nแขวนลอย\nโขกสับ\nโขยกเขยก\nไขข้อ\nไขควง\nไขมัน\nไข่มุก\nไขว่ห้าง\nไขสันหลัง\nไขสือ\nไข่เค็ม\nไข่เยี่ยวม้า\nไข่หงส์\nไข่เหี้ย\nคงกระพัน\nคงตัว\nคงทน\nคงที่\nคชลักษณ์\nคชสาร\nคชสีห์\nคชราช\nคณิตศาสตร์\nคดเคี้ยว\nคติธรรม\nคติพจน์\nคนกลาง\nคนไข้\nคนใช้\nคนทรง\nคบไฟ\nคบเพลิง\nคบค้า\nคบคิด\nคบหา\nคมคาย\nครบครัน\nครบถ้วน\nครอบครอง\nครอบคลุม\nครอบครัว\nครอบงำ\nครอบจักรวาล\nคริสตกาล\nคริสตจักร\nคริสต์มาส\nคริสต์ศตวรรษ\nคริสต์ศักราช\nคริสตัง\nคริสเตียน\nครุกรรม\nครุภัณฑ์\nครุศาสตร์\nครุฑพ่าห์\nครุ่นคิด\nคลอเคลีย\nคล่องแคล่ว\nคล่องตัว\nคล่องมือ\nคลั่งไคล้\nคลาคล่ำ\nคลาไคล\nคลาดเคลื่อน\nคลาดแคล้ว\nคลี่คลาย\nคลึงเคล้น\nคลึงเคล้า\nคลื่นไส้\nคลื่นเหียน\nคลุกคลี\nคลุกคลาน\nคลุมเครือ\nคลุมโปง\nคลุ้มคลั่ง\nควงสว่าน\nควบคุม\nควบคู่\nควบแน่น\nควันหลง\nความคิด\nความหลัง\nความเห็น\nคอหอย\nคอห่าน\nคอแห้ง\nค่อนขอด\nค่อนแคะ\nค้อนควัก\nคั่งค้าง\nคั่งแค้น\nคัดค้าน\nคัดง้าง\nคัดท้าย\nคัดเลือก\nคันจาม\nคันฉ่อง\nคันฉาย\nคันชัก\nคันชั่ง\nคันไถ\nคันนา\nคันเร่ง\nคับขัน\nคับคั่ง\nคับแค้น\nคับแคบ\nคางทูม\nคางหมู\nค้างคืน\nค้างปี\nคาดคั้น\nคาดเชือก\nคาดโทษ\nคาดหมาย\nคานหาม\nคาบเกี่ยว\nคาบศิลา\nคาบสมุทร\nคำขาด\nคำนำ\nคิดค้น\nคืนดี\nคืนตัว\nคุกเข่า\nคุณค่า\nคุณชาย\nคุณธรรม\nคุณนาย\nคุณภาพ\nคุณลักษณะ\nคุณวุฒิ\nคุณศัพท์\nคุณสมบัติ\nคุณหญิง\nคุณากร\nคุณูปการ\nคุโณปการ\nคุมเชิง\nคุ้มกัน\nคุยเขื่อง\nคุยโต\nคุ้ยเขี่ย\nคุ้มครอง\nคู่กรณี\nคู่กัด\nคู่ขา\nคู่แข่ง\nคู่ครอง\nคู่ควร\nคู่คิด\nคู่คี่\nคู่ใจ\nคู่ชีพ\nคู่ชีวิต\nคู่บารมี\nคู่บุญ\nคู่ปรปักษ์\nคู่ปรับ\nคู่ผสม\nคู่มือ\nคู่รัก\nคู่ลำดับ\nคู่สาย\nคู่หมั้น\nคู่หู\nคู่อริ\nคู่อาฆาต\nเคมีภัณฑ์\nเคยตัว\nเคร่งขรึม\nเคร่งครัด\nเคร่งเครียด\nเครดิตฟองซิเอร์\nเครื่องกล\nเครื่องกัณฑ์\nเครื่องแกง\nเครื่องเขิน\nเครื่องครัว\nเครื่องเคียง\nเครื่องเงิน\nเครื่องจักร\nเครื่องเซ่น\nเครื่องดนตรี\nเครื่องต้น\nเครื่องทุ่นแรง\nเครื่องเทศ\nเครื่องใน\nเครื่องบิน\nเครื่องบูชา\nเครื่องแบบ\nเครื่องประดับ\nเครื่องปรุง\nเครื่องปรุงรส\nเครื่องมือ\nเครื่องยนต์\nเครื่องร่อน\nเครื่องราง\nเครื่องเรือน\nเครื่องล่าง\nเครื่องเล่น\nเครื่องสาย\nเครื่องสำอาง\nเครื่องสุกำศพ\nเครื่องหมาย\nเครือรัฐ\nเคลียคลอ\nเคลื่อนที่\nเคลื่อนไหว\nเคลือบแคลง\nเคลือบแฝง\nเคลือบฟัน\nเคว้งคว้าง\nเคหสถาน\nเค้าโครง\nเคียดแค้น\nเคี่ยวเข็ญ\nเคี้ยวเอื้อง\nเคืองขุ่น\nโคนม\nโคบาล\nโคมูตร\nโคมลอย\nโครงการ\nโครงเรื่อง\nโครงงาน\nโครงสร้าง\nโครมคราม\nโคลงเคลง\nฆ้องกระแต\nฆ้องชัย\nฆ้องวง\nฆ้องหุ่ย\nฆ้องเหม่ง\nฆ้องโหม่ง\nฆาตกร\nฆาตกรรม\nฆานประสาท\nงงงวย\nงงงัน\nงดเว้น\nงบดุล\nงบประมาณ\nงมโข่ง\nงมงาย\nง่วงงุน\nง่วงเหงา\nงอหาย\nง้องอน\nงอนง้อ\nงอมแงม\nงาช้าง\nง่าเงย\nงานการ\nง่ายดาย\nงึมงำ\nเงินเดือน\nเงินตรา\nเงินยวง\nเงียบกริบ\nเงียบเชียบ\nเงียบเหงา\nเงื่องหงอย\nเงื่อนไข\nเงื่อนงำ\nเงื่อนเวลา\nเงื้อมมือ\nแง่งอน\nจงใจ\nจงรัก\nจดจ่อ\nจดจำ\nจดหมาย\nจดหมายเหตุ\nจรจัด\nจรรยาบรรณ\nจริงจัง\nจริงใจ\nจอมขวัญ\nจอมใจ\nจอมทัพ\nจอมปลวก\nจอมพล\nจ๊ะเอ๋\nจักสาน\nจักรพรรดิ\nจักรภพ\nจักรยาน\nจักรยานยนต์\nจักรราศี\nจักรวรรดิ\nจักรวรรดินิยม\nจักรวาล\nจังหนับ\nจัดการ\nจัดจ้าน\nจัดเจน\nจัดแจง\nจัดตั้ง\nจัดสรร\nจับกุม\nจับจด\nจับเจ่า\nจ่าหน้า\nจาตุทสี\nจาตุมหาราช\nจาตุมหาราชิก\nจาตุมหาราชิกา\nจาตุรงคสันนิบาต\nจาตุรราชการ\nจานเชิง\nจานบิน\nจานผี\nจานเสียง\nจาบจ้วง\nจำเป็น\nจำพรรษา\nจำวัด\nจ้ำจี้จ้ำไช\nจำเลาะตา\nจิงโจ้น้ำ\nจิตใจ\nจิตตภาวนา\nจิตตัง\nจิตตานุปัสสนา\nจิตนิยม\nจิตบำบัด\nจิตแพทย์\nจิตวิสัย\nจิตรกร\nจิตรกรรม\nจิตรลดา\nจิตวิทยา\nจิตเวช\nจิตเวชศาสตร์\nจินตกวี\nจินตนา\nจินตนาการ\nจินตภาพ\nจุฑามณี\nจุฑามาศ\nจุฑารัตน์\nจุนเจือ\nจุ้นจ้าน\nจุลชีพ\nจุลชีวัน\nจุลชีวิน\nจุลทรรศน์\nจุลภาค\nจุลวรรค\nจุลศักราช\nจุลสาร\nจุลินทรีย์\nจุฬามณี\nจุฬาลักษณ์\nเจตคติ\nเจตจำนง\nเจตนารมณ์\nเจตภูต\nเจริญพร\nเจ้ากรม\nเจ้ากรรม\nเจ้าของ\nเจ้าขา\nเจ้าข้า\nเจ้าคณะ\nเจ้าค่ะ\nเจ้าจอม\nเจ้าชู้\nเจ้าตัว\nเจ้าถิ่น\nเจ้าท่า\nเจ้าที่\nเจ้าทุกข์\nเจ้านาย\nเจ้าเนื้อ\nเจ้าบ้าน\nเจ้าบ่าว\nเจ้าประคุณ\nเจ้าประคู้น\nเจ้าพนักงาน\nเจ้าพระคุณ\nเจ้าพระยา\nเจ้าพ่อ\nเจ้าพายุ\nเจ้าฟ้า\nเจ้าภาพ\nเจ้ามือ\nเจ้าแม่\nเจ้าเรือน\nเจ้าสังกัด\nเจ้าสัว\nเจ้าสาว\nเจ้าหน้าที่\nเจ้าหนี้\nเจ้าอาวาส\nเจาะจง\nเจือจาง\nเจือจาน\nเจือปน\nเจื้อยแจ้ว\nแจกจ่าย\nแจ่มแจ้ง\nแจ่มใส\nโจงกระเบน\nโจมตี\nโจรกรรม\nโจรสลัด\nใจความ\nใจคอ\nฉกฉวย\nฉกชิง\nฉลองได\nฉ้อฉล\nฉัตรมงคล\nฉันทลักษณ์\nฉายาลักษณ์\nฉิบหาย\nฉุกเฉิน\nฉุกละหุก\nฉุนเฉียว\nฉุปศาสตร์\nเฉไฉ\nเฉยเมย\nเฉาโฉด\nเฉิดฉัน\nเฉิดฉาย\nเฉิดฉิน\nเฉียบขาด\nเฉียบพลัน\nเฉียบแหลม\nเฉื่อยชา\nแฉะแบะ\nโฉดเฉา\nโฉมงาม\nโฉมฉาย\nโฉมเฉลา\nโฉมตรู\nโฉมยง\nโฉมศรี\nโฉมหน้า\nชดช้อย\nชดเชย\nชดใช้\nชนบท\nชนินทร์\nชนกกรรม\nชนมพรรษา\nชนมายุ\nชมเชย\nชมพูทวีป\nชมพูนท\nชมพูนุท\nชราธรรม\nชราภาพ\nชลจร\nชลธาร\nชลธี\nชลนัยน์\nชลนา\nชลเนตร\nชลประทาน\nชลมารค\nชลาธาร\nชลาลัย\nชลาศัย\nชลาสินธุ์\nชโลทร\nช่วงชิง\nช่วงใช้\nชวนชม\nชวนหัว\nช่วยเหลือ\nช่อฟ้า\nช่อม่วง\nชอกช้ำ\nช่องเขา\nช่องแคบ\nช่องไฟ\nช่องว่าง\nช้องนาง\nชอบกล\nชอบใจ\nชอบธรรม\nชอบพอ\nชักโครก\nชักเงา\nชักจูง\nชักชวน\nชักนำ\nชักเนื้อ\nชักพระ\nชักเย่อ\nชักใย\nชั่งใจ\nชังฆวิหาร\nชัดเจน\nชั้นเชิง\nชั่วคน\nชั่วคราว\nชั่วช้า\nชั่วโมง\nชั่วแล่น\nชาเย็น\nช้านาน\nช่างเครื่อง\nช่างฝีมือ\nช่างฟิต\nช่างไฟ\nช้างน้ำ\nช้างเผือก\nช้างพลาย\nช้างพัง\nช้างสาร\nช้างสีดอ\nชาติธรรม\nชาตินิยม\nชาติพันธุ์\nชาติพันธุ์วิทยา\nชาติภูมิ\nชานชาลา\nชายชาตรี\nชายคา\nชายฝั่ง\nชายทะเล\nชาวเล\nชาววัง\nช้ำใจ\nช้ำชอก\nชิงชัง\nชิงพลบ\nชินชา\nชินบุตร\nชิ้นเอก\nชิมลาง\nชีเปลือย\nชี้ขาด\nชี้แจง\nชี้นำ\nชี้แนะ\nชี้ฟ้า\nชีพจร\nชีพิตักษัย\nชื่นชม\nชื่นบาน\nชื่นมื่น\nชื่อย่อ\nชื่อรอง\nชื่อเล่น\nชื่อเสียง\nชุกชุม\nชุติมา\nชุบตัว\nชุบเลี้ยง\nชุมชน\nชุมทาง\nชุมสาย\nชุ่มใจ\nชุ่มชื่น\nชุ่มชื้น\nชุมนุมชน\nชูชีพ\nชูโรง\nชู้สาว\nเชยชม\nเชลยศักดิ์\nเชลยศึก\nเช่าซื้อ\nเช้าตรู่\nเช้ามืด\nเชิงกราน\nเชิงกล\nเชิงชั้น\nเชิงชาย\nเชิงซ้อน\nเชิงเดียว\nเชิงเดี่ยว\nเชิงตะกอน\nเชิงเทิน\nเชิงมุม\nเชิดชู\nเชิงอรรถ\nเชี่ยนหมาก\nเชี่ยวชาญ\nเชื่องช้า\nเชื่อใจ\nเชื่อถือ\nเชื่อฟัง\nเชื่อมือ\nเชื้อชาติ\nเชื้อเพลิง\nเชื้อไฟ\nเชื้อโรค\nเชื้อสาย\nเชื้อเชิญ\nเชื่องช้า\nเชือนแช\nเชื่อวัน\nแช่เย็น\nแช่อิ่ม\nแช่มช้อย\nแช่มชื่น\nโชกโชน\nโชติช่วง\nโชติรส\nใช้สอย\nซบเซา\nซมซาน\nซวนเซ\nซอกซอน\nซอกแซก\nซ่องสุม\nซ่องเสพ\nซ่องแซ่ง\nซ่อนรูป\nซ่อนเร้น\nซ่อนหา\nซ่อนกลิ่น\nซ่อนทราย\nซ่อมแซม\nซักค้าน\nซักซ้อม\nซักไซ้\nซักฟอก\nซักแห้ง\nซังกะตาย\nซังตาย\nซัดเซ\nซัดทอด\nซับซ้อน\nซับใน\nซับพระพักตร์\nซากศพ\nซ่านเซ็น\nซ้ำซ้อน\nซ้ำซาก\nซ้ำเติม\nซ้ำร้าย\nซี่โครง\nซีดเซียว\nซึมกะทือ\nซึมซาบ\nซึมเซา\nซึมทราบ\nซึมเศร้า\nซื่อตรง\nซื่อสัตย์\nซื้อขาย\nซุกซน\nซุกซ่อน\nซุบซิบ\nซู่ซ่า\nเซซัง\nเซ่อซ่า\nแซ่ซ้อง\nโซดาไฟ\nญาณทัสนะ\nญาณวิทยา\nญาณศาสตร์\nญาติกา\nฐานราก\nดกดื่น\nดงดิบ\nดลใจ\nดลบันดาล\nดวงแก้ว\nดวงใจ\nดวงเดือน\nดวงตรา\nดวงตา\nดวงสมร\nดอกจัน\nดอกจิก\nดอกบัว\nดอกเบี้ย\nดอกฟ้า\nดอกไม้\nดอกยาง\nดอกเล็บ\nดอกทอง\nดอกสร้อย\nดองยา\nดักคอ\nดักฟัง\nดังนั้น\nดังนี้\nดังหนึ่ง\nดั้งเดิม\nดัดจริต\nดัดแปลง\nดันทุรัง\nดับขันธ์\nดับจิต\nดับชีพ\nด่าทอ\nด่างทับทิม\nด่างพร้อย\nดาดฟ้า\nดาราศาสตร์\nดาลเดือด\nดาวกระจาย\nดาวเคราะห์\nดาวตก\nดาวเทียม\nดาวรุ่ง\nดาวเรือง\nดาวฤกษ์\nดาวหาง\nดาวเหนือ\nดาษดื่น\nดินขาว\nดินดาน\nดินดำ\nดินประสิว\nดินปืน\nดินระเบิด\nดินสอ\nดินสอพอง\nดิ้นรน\nดิบดี\nดีเกลือ\nดีใจ\nดีซ่าน\nดีดัก\nดีเดือด\nดีฝ่อ\nดีดดิ้น\nดึกดำบรรพ์\nดึกดื่น\nดึงดัน\nดึงดูด\nดื่มด่ำ\nดื้อด้าน\nดื้อดึง\nดื้อแพ่ง\nดื้อยา\nดื้อรั้น\nดุดัน\nดุเดือด\nดุร้าย\nดุลการค้า\nดุลพินิจ\nดุลภาค\nดุลยพินิจ\nดุลยภาพ\nดุษฎีนิพนธ์\nดุษฎีบัณฑิต\nดุษณีภาพ\nดูแคลน\nดูถูก\nดูดาย\nดูเบา\nดูแล\nดูหมิ่น\nดูเหมือน\nดูดดื่ม\nเด็ดขาด\nเด็ดดวง\nเด็ดเดี่ยว\nเดนตาย\nเดาสวด\nเดาสุ่ม\nเดินทาง\nเดินสะพัด\nเดินสาย\nเดินเหิน\nเดิมพัน\nเดียงสา\nเดียดฉันท์\nเดียวกัน\nเดียวดาย\nเดี๋ยวเดียว\nเดี๋ยวนี้\nเดือดดาล\nเดือดร้อน\nเดือนมืด\nเดือนหงาย\nแดดาล\nแดดิ้น\nแดกดัน\nโด่เด่\nโด่งดัง\nโดดเดี่ยว\nโดยสาร\nได้การ\nได้แก่\nได้ใจ\nได้ที\nได้ยิน\nได้เสีย\nตกเขียว\nตกค้าง\nตกใจ\nตกต่ำ\nตกแต่ง\nตกทอด\nตกฟาก\nตกมัน\nตกยาก\nตกลง\nตกหล่น\nต้นขั้ว\nต้นคิด\nต้นฉบับ\nต้นตอ\nต้นตำรับ\nต้นทุน\nต้นแบบ\nต้นเพลิง\nต้นมือ\nต้นไม้\nต้นร่าง\nต้นเรื่อง\nต้นสังกัด\nต้นหน\nต้นเหตุ\nตบตา\nตบแต่ง\nตบแผละ\nตบมือ\nต้มข่า\nต้มโคล้ง\nต้มยำ\nต้มส้ม\nตรมตรอม\nตรรกวิทยา\nตรรกศาสตร์\nตรวจการ\nตรวจการณ์\nตรวจตรา\nตระบัดสัตย์\nตรัสรู้\nตราตั้ง\nตราบาป\nตรายาง\nตราสาร\nตริตรอง\nตรีกฏุก\nตรีกาย\nตรีโกณ\nตรีโกณมิติ\nตรีคูณ\nตรีทูต\nตรีปิฎก\nตรีภพ\nตรีมูรติ\nตรึกตรอง\nตรึงตรา\nตรุษจีน\nตฤณชาติ\nตฤณมัย\nตลกบาตร\nตลบตะแลง\nตลบหลัง\nตลาดนัด\nตลาดน้ำ\nตลาดมืด\nตลาดสด\nต่อตี\nต่อเติม\nต่อว่า\nต่อสู้\nต่อกร\nต่อต้าน\nต่อแย้ง\nต้องการ\nต้องโทษ\nต้องหา\nต้อนรับ\nตอบโต้\nตอบแทน\nต่อยหอย\nตะพาบน้ำ\nตักตวง\nตักบาตร\nตั้งเข็ม\nตั้งไข่\nตั้งเค้า\nตั้งแง่\nตั้งใจ\nตั้งต้น\nตั้งแต่\nตั้งท้อง\nตัดขาด\nตัดใจ\nตัดเชือก\nตัดตอน\nตัดทอน\nตัดบท\nตัดพ้อ\nตัดรอน\nตัดสิน\nตับเต่า\nตับแลบ\nตับอ่อน\nตัวกลาง\nตัวการ\nตัวเก็ง\nตัวดี\nตัวตั้ง\nตัวเต็ง\nตัวถัง\nตัวแทน\nตัวประกอบ\nตัวประกัน\nตัวแปร\nตัวผู้\nตัวพิมพ์\nตัวเมีย\nตัวยืน\nตัวเลข\nตัวอย่าง\nตั๋วเงิน\nตั๋วแลกเงิน\nตากล้อง\nตาไก่\nตาข่าย\nตาชั่ง\nตาตุ่ม\nตาทวด\nตาปลา\nตาราง\nต่างหาก\nต้านทาน\nตามใจ\nตายใจ\nตายซาก\nตายด้าน\nตายตัว\nตายทั้งกลม\nตายห่า\nตายโหง\nตาลปัตร\nต่ำช้า\nต่ำต้อย\nตำส้ม\nติเตียน\nติณชาติ\nติดขัด\nติดใจ\nติดต่อ\nติดตั้ง\nติดตาม\nติดตื้น\nติดพัน\nติดลม\nติดอ่าง\nตีเกลียว\nตีขลุม\nตีความ\nตีคู่\nตีจาก\nตีตื้น\nตีแผ่\nตีรวน\nตีลังกา\nตีวง\nตีเสมอ\nตีนกา\nตีนคู้\nตีนจก\nตีนตะขาบ\nตีนผี\nตีนเหยียด\nตึกแถว\nตึกระฟ้า\nตึงเครียด\nตึงตัง\nตื้นตัน\nตื่นตัว\nตื่นตูม\nตื่นเต้น\nตุ๊ต๊ะ\nตุ้บตั้บ\nตุ้มหู\nตุลาการ\nตุลาคม\nตู้นิรภัย\nตูมตาม\nตู้เสบียง\nเตโชธาตุ\nเตร็ดเตร่\nเต้นรำ\nเตาแก๊ส\nเตาผิง\nเตาฟู่\nเตาไฟ\nเตารีด\nเตาสูบ\nเต่าทอง\nเต้ารับ\nเต้าส่วน\nเต้าเสียบ\nเต้าหู้ยี้\nแต่ละ\nแตกคอ\nแตกคอก\nแตกฉาน\nแตกดับ\nแตกตื่น\nแตกพาน\nแตกแยก\nแตกร้าว\nแตกหัก\nแต่งงาน\nแต่งตั้ง\nแต้มคู\nแต้มต่อ\nแตรงอน\nแตรเดี่ยว\nแตรฝรั่ง\nแตรฟันฟาร์\nแตรวง\nโต้ตอบ\nโต้เถียง\nโต้แย้ง\nโต๊ะหมู่\nโต๊ะอิหม่าม\nใต้ถุน\nไต้ก๋ง\nไต่คู้\nไต่เต้า\nไต่ถาม\nไต้ฝุ่น\nไตรจักร\nไตรจีวร\nไตรตรึงษ์\nไตรทวาร\nไตรปิฎก\nไตรเพท\nไตรภพ\nไตรภูมิ\nไตรภาคี\nไตรยางศ์\nไตรรงค์\nไตรรัตน์\nไตรลักษณ์\nไตรโลก\nไตรสรณคมน์\nไตรสิกขา\nไต่สวน\nถกเถียง\nถดถอย\nถนัดถนี่\nถนิมสร้อย\nถมถืด\nถมเถ\nถมไป\nถลากไถล\nถ้วนถี่\nถ้วยฟู\nถ่องแท้\nถอดถอน\nถ้อยคำ\nถ้อยแถลง\nถากถาง\nถ่านไฟฉาย\nถ่านหิน\nถามไถ่\nถ่ายทอด\nถ่ายทุกข์\nถ่ายเท\nถาวรวัตถุ\nถ้ำมอง\nถี่ถ้วน\nถึงใจ\nถูกใจ\nถูกชะตา\nเถรวาท\nเถ้าแก่\nเถ้าแก่เนี้ย\nแถมพก\nแถลงการณ์\nไถ่ถอน\nไถ่ถาม\nทดแทน\nทดรอง\nทดลอง\nทดสอบ\nทนทาน\nทนายความ\nทบทวน\nทแยงมุม\nทรงกลด\nทรงเครื่อง\nทรงเจ้า\nทรัพย์สิน\nทรามชม\nทรามเชย\nทรามวัย\nทรามสงวน\nทรามสวาท\nทรุดโทรม\nทฤษฎีบท\nท้วงติง\nท่วมท้น\nทวาทศ\nทวาทศมาส\nทวาบรยุค\nทวารบาล\nทวิบถ\nทวิบท\nทวิบาท\nทวิภาค\nทวิภาคี\nทวีคูณ\nทศกัณฐ์\nทศชาติ\nทศทิศ\nทศนิยม\nทศพร\nทศพล\nทศพิธราชธรรม\nทศมาส\nทศวรรษ\nท่อไอเสีย\nท้อถอย\nท้อแท้\nทองขาว\nทองคำ\nทองคำขาว\nทองคำเปลว\nทองเค\nทองแดง\nทองบรอนซ์\nทองม้วน\nทองย้อย\nทองสัมฤทธิ์\nทองหยอด\nทองหยิบ\nทองเหลือง\nทองเอก\nท่องเที่ยว\nท้องตรา\nท้องถิ่น\nท้องที่\nท้องน้อย\nท้องร่อง\nท้องเรื่อง\nทอดมัน\nทอดทิ้ง\nทอดน่อง\nทอดยอด\nทอดหุ่ย\nทอยกอง\nทะเบียนบ้าน\nทะเลทราย\nทะเลสาบ\nทะเลหลวง\nทักขิณาวัฏ\nทักท้วง\nทักทาย\nทักษิณาวรรต\nทักษิณาทาน\nทักษิณานุประทาน\nทั้งกลม\nทั้งคน\nทั้งดุ้น\nทั้งที\nทั้งนั้น\nทั้งนี้\nทั้งปวง\nทั้งผอง\nทั้งเพ\nทั้งมวล\nทั้งสิ้น\nทั้งหมด\nทั้งหลาย\nทัณฑ์บน\nทัดทาน\nทัดเทียม\nทันควัน\nทันใจ\nทันใด\nทันตา\nทันสมัย\nทันที\nทับถม\nทับทรวง\nทับศัพท์\nทั่วถึง\nทั่วไป\nท่าทาง\nท่าที\nท้าทาย\nทางการ\nทางข้าม\nทางด่วน\nทางเท้า\nทางโท\nทางใน\nทางผ่าน\nทางม้าลาย\nทางหลวง\nทางออก\nทางเอก\nทานกัณฑ์\nทานตะวัน\nท่านชาย\nทานบารมี\nท่านผู้หญิง\nท่านหญิง\nทาบทาม\nท้ายทอย\nทารุณกรรม\nทำคลอด\nทำใจ\nทำซ้ำ\nทำท่า\nทำที\nทำแท้ง\nทำโทษ\nทำบาป\nทำบุญ\nทำพิษ\nทำฟัน\nทำร้าย\nทำวัตร\nทำสาว\nทำเสน่ห์\nทำหมัน\nทำให้\nทิ้งขว้าง\nทิ้งทวน\nทิ้งท้าย\nทินกร\nทิพจักขุ\nทิพโสต\nทิพยจักษุ\nทิพยญาณ\nทิพยเนตร\nทิพยรส\nทิพากร\nทิ่มตำ\nทิ่มแทง\nทิวากร\nทิวากาล\nทิศทาง\nทีเด็ด\nทีท่า\nทีนี้\nทีหลัง\nทีฆนิกาย\nทีฆสระ\nที่ดิน\nที่นอน\nที่นั่ง\nที่ปรึกษา\nที่พึ่ง\nที่มั่น\nที่ราบ\nที่ว่าการ\nที่สุด\nที่หมาย\nที่ไหน\nทุกที\nทุกเมื่อ\nทุกข์สุข\nทุนทรัพย์\nทุนนิยม\nทุนรอน\nทุนสำรอง\nทุ่มเถียง\nทุ่มเท\nทูนหัว\nทูลกระหม่อม\nเทกระจาด\nเทครัว\nเทพเจ้า\nเทพดา\nเทพธิดา\nเทพนม\nเทพนิยม\nเทพนิยาย\nเทพบุตร\nเทพสังหรณ์\nเทศกาล\nเทศนาโวหาร\nเทศบัญญัติ\nเทศบาล\nเทศมนตรี\nเทห์ฟากฟ้า\nเท่ากับ\nเท่าใด\nเท่าตัว\nเท่าทัน\nเท่าทุน\nเท่าเทียม\nเท่านั้น\nเท่าไร\nเท้าช้าง\nเทิดทูน\nเที่ยงตรง\nเที่ยงแท้\nเที่ยงธรรม\nเทียนชนวน\nเทียนพรรษา\nเทียบเคียง\nเทียบเท่า\nเทือกเขา\nเทือกเถา\nแท็งก์น้ำ\nแท่นพิมพ์\nแท่นมณฑล\nแท่นหมึก\nแทรกซอน\nแทรกซ้อน\nแทรกซึม\nแทรกแซง\nแทะโลม\nไทยดำ\nไทยทาน\nไทยธรรม\nไทยน้อย\nไทยใหญ่\nธงชัย\nธงชาติ\nธงทิว\nธรณีวิทยา\nธรณีสงฆ์\nธรรมกาย\nธรรมการ\nธรรมเกษตร\nธรรมขันธ์\nธรรมคุณ\nธรรมจรรยา\nธรรมจริยา\nธรรมจักร\nธรรมจักษุ\nธรรมจาคะ\nธรรมจารี\nธรรมชาติ\nธรรมดา\nธรรมเนียม\nธรรมราชา\nธรรมศาสตร์\nธรรมสภา\nธรรมสังเวช\nธัญพืช\nธารพระกร\nธีรภาพ\nธีรราช\nนกเขา\nนกต่อ\nนกยูง\nนกรู้\nนกหวีด\nนครบาล\nนครรัฐ\nนงคราญ\nนงนุช\nนงพะงา\nนงเยาว์\nนงราม\nนงลักษณ์\nนบนอบ\nนพเก้า\nนพคุณ\nนพเคราะห์\nนพปฎล\nนพพล\nนพรัตน์\nนพศก\nนพศูล\nนมข้น\nนมผง\nนมไม้\nนมนาน\nนมหนู\nนมแมว\nนรีเวช\nนรีเวชวิทยา\nนวดฟั้น\nนวยนาด\nนวลระหง\nนวลลออ\nนวลละออง\nนวลจันทร์\nนอกครู\nนอกคอก\nนอกจาก\nนอกใจ\nนอกชาน\nนอกรีต\nนอกเหนือ\nนองเนือง\nนองเลือด\nนอนก้น\nนอนใจ\nนอบนบ\nนอนเล่น\nนอบน้อม\nน้อมนำ\nน้อยใจ\nน้อยหน้า\nนักการ\nนักการเมือง\nนักกีฬา\nนักข่าว\nนักท่องเที่ยว\nนักเทศน์\nนักโทษ\nนักธรรม\nนักบวช\nนักบิน\nนักบุญ\nนักปราชญ์\nนักพรต\nนักรบ\nนักเรียน\nนักเลง\nนักวิชาการ\nนักศึกษา\nนักสิทธิ์\nนักสืบ\nนักหนา\nนั่งเทียน\nนั่งร้าน\nนัดแนะ\nนัดหมาย\nนั่นแหละ\nนั่นเอง\nนับถือ\nนับประสา\nนัยน์ตา\nนาดำ\nนาปรัง\nนาปี\nนาสวน\nนาหว่าน\nนาคบาศ\nนาคปรก\nนาคราช\nนางกวัก\nนางกำนัล\nนางงาม\nนางใน\nนางบำเรอ\nนางแบบ\nนางพญา\nนางฟ้า\nนางไม้\nนางโลม\nนางสาว\nนางห้าม\nนางเอก\nนาฏกรรม\nนาฏดนตรี\nนาฏศิลป์\nนานนม\nน่านน้ำ\nน่านฟ้า\nนามกร\nนามธรรม\nนามไธย\nนามบัตร\nนามปากกา\nนามแฝง\nนามสกุล\nนามสงเคราะห์\nนามสมญา\nนายทะเบียน\nนายท่า\nนายท้าย\nนายทุน\nนายประกัน\nนายหน้า\nนายอำเภอ\nนารายณ์หัตถ์\nนารีผล\nนาวิกโยธิน\nนำจับ\nนำพา\nนำทาง\nนำร่อง\nนำสืบ\nนำแสดง\nน้ำกรด\nน้ำกาม\nน้ำเกลือ\nน้ำข้าว\nน้ำแข็ง\nน้ำแข็งไส\nน้ำแข็งแห้ง\nน้ำครำ\nน้ำคร่ำ\nน้ำค้าง\nน้ำค้างแข็ง\nน้ำคาวปลา\nน้ำคำ\nน้ำเค็ม\nน้ำเคย\nน้ำเงิน\nน้ำเงี้ยว\nน้ำจัณฑ์\nน้ำจิ้ม\nน้ำใจ\nน้ำเชื้อ\nน้ำเชื่อม\nน้ำซาวข้าว\nน้ำดอกไม้\nน้ำดี\nน้ำตก\nน้ำตา\nน้ำตาล\nน้ำท่า\nน้ำนม\nน้ำนวล\nน้ำบาดาล\nน้ำประสานทอง\nน้ำประปา\nน้ำปลา\nน้ำป่า\nน้ำผึ้ง\nน้ำพริก\nน้ำพริกเผา\nน้ำพี้\nน้ำพุ\nน้ำมนต์\nน้ำมนตร์\nน้ำมัน\nน้ำมือ\nน้ำมูก\nน้ำเมา\nน้ำย่อย\nน้ำยา\nน้ำรัก\nน้ำแร่\nน้ำลาย\nน้ำเลี้ยง\nน้ำสต๊อก\nน้ำส้ม\nน้ำส้มสายชู\nน้ำสังข์\nน้ำสาบาน\nน้ำเสียง\nน้ำหนวก\nน้ำหนอง\nน้ำหนัก\nน้ำหน้า\nน้ำหนึ่ง\nน้ำหมึก\nน้ำหอม\nน้ำเหลือง\nน้ำอบ\nน้ำอ้อย\nน้ำอัดลม\nนิ่งเฉย\nนิจศีล\nนิดเดียว\nนิดหน่อย\nนิติกร\nนิติกรรม\nนิติธรรม\nนิตินัย\nนิติบัญญัติ\nนิติบุคคล\nนิติภาวะ\nนิติวิทยาศาสตร์\nนิติเวช\nนิติเวชศาสตร์\nนิติศาสตร์\nนิเทศศาสตร์\nนิ่มนวล\nนิรุกติศาสตร์\nนิเวศวิทยา\nนิศากร\nนิศากาล\nนิศาชล\nนิศารัตน์\nนี่แน่ะ\nนี่แหละ\nนี่เอง\nนึกคิด\nนุงถุง\nนุ่งห่ม\nนุ่มนวล\nนุ่มนิ่ม\nเนตรนารี\nเนติบัณฑิต\nเนยเทียม\nเนยใส\nเนิ่นนาน\nเนิบนาบ\nเนื้อความ\nเนื้อคู่\nเนื้อเค็ม\nเนื้องอก\nเนื้อตัว\nเนื้อตาย\nเนื้อที่\nเนื้อแท้\nเนื้อเปื่อย\nเนื้อผ้า\nเนื้อเพลง\nเนื้อไม้\nเนื้อเยื่อ\nเนื้อร้อง\nเนื้อร้าย\nเนื้อเรื่อง\nเนื้อหา\nเนืองนอง\nเนืองนิตย์\nเนืองแน่น\nแน่ใจ\nแน่ชัด\nแน่แท้\nแน่นอน\nแน่นิ่ง\nแน่แน่ว\nแน่นแฟ้น\nแน่นหนา\nแนบเนียน\nแนบแน่น\nแนวคิด\nแนวทาง\nแนวโน้ม\nแนวป่า\nแนวรบ\nแนวร่วม\nแนวหน้า\nแนวหลัง\nแน่วแน่\nแนะนำ\nแนะแนว\nโน้มน้าว\nในหลวง\nบกพร่อง\nบงกช\nบงการ\nบดบัง\nบทกลอน\nบทกวี\nบทความ\nบทคัดย่อ\nบทเฉพาะกาล\nบทนำ\nบทบัญญัติ\nบทบาท\nบทประพันธ์\nบทเพลง\nบทร้อง\nบทเรียน\nบทลงโทษ\nบทสนทนา\nบทอัศจรรย์\nบทจร\nบทบงสุ์\nบทมาลย์\nบทรัช\nบทเรศ\nบทวลัญช์\nบนบาน\nบรมครู\nบรมธาตุ\nบรมบพิตร\nบรมวงศานุวงศ์\nบรมอัฐิ\nบรรณพิภพ\nบรรณศาลา\nบรรณาการ\nบรรณาธิการ\nบรรณานุกรม\nบรรณารักษ์\nบรรณารักษศาสตร์\nบรรดามี\nบรรดาศักดิ์\nบรรทัดฐาน\nบรรพบุรุษ\nบรรลัยกัลป์\nบรรลัยจักร\nบริคณห์สนธิ\nบวงสรวง\nบ่วงบาศ\nบ้วนพระโอษฐ์\nบ่อเกิด\nบอกกล่าว\nบอกบท\nบอกบุญ\nบอกใบ้\nบอกปัด\nบ้องกัญชา\nบ้องตื้น\nบ้องไฟ\nบ้องหู\nบอดสี\nบ่อนทำลาย\nบอบช้ำ\nบอบบาง\nบอบแบบ\nบังโกลน\nบังโคลน\nบังใบ\nบั้งไฟ\nบังคับการ\nบังคับบัญชา\nบัญชาการ\nบัณฑุกัมพล\nบัดดล\nบัดเดี๋ยว\nบัดนั้น\nบัดนี้\nบัดสีบัดเถลิง\nบัตรเครดิต\nบัตรพลี\nบัตรสนเท่ห์\nบัตรสินเชื่อ\nบั่นทอน\nบั้นท้าย\nบั้นปลาย\nบั้นพระองค์\nบั้นเอว\nบันไดลิง\nบันไดเลื่อน\nบันเทิงคดี\nบัวลอย\nบัวบก\nบ้าจี้\nบ้าดีเดือด\nบ้าน้ำลาย\nบ้าบิ่น\nบ้าระห่ำ\nบ้าเลือด\nบ้าหอบฟาง\nบากบั่น\nบากหน้า\nบางตา\nบางเบา\nบางที\nบาดเจ็บ\nบาดแผล\nบาดหมาง\nบาตรใหญ่\nบาทบงกช\nบาทบงสุ์\nบาทบริจาริกา\nบาทวิถี\nบานเกล็ด\nบานตะเกียง\nบานตะไท\nบานเบอะ\nบานปลาย\nบานแผละ\nบานพับ\nบ้านจัดสรร\nบ้านช่อง\nบ้านนอก\nบ้านพัก\nบ้านเมือง\nบ้านรับรอง\nบ้านเรือน\nบาปกรรม\nบายศรี\nบ่ายเบี่ยง\nบ่ายหน้า\nบ่าวไพร่\nบิดเบี้ยว\nบิดเบือน\nบิดพลิ้ว\nบี้แบน\nบีบคั้น\nบีบรัด\nบึ้งตึง\nบึ้งบูด\nบุกบั่น\nบุกเบิก\nบุกรุก\nบุคลิกภาพ\nบุคลิกลักษณะ\nบุญธรรม\nบุญนิธิ\nบุญฤทธิ์\nบุบสลาย\nบุ้ยใบ้\nบุรุษเพศ\nบุหงารำไป\nบู้บี้\nบูชายัญ\nบูดบึ้ง\nบูดเบี้ยว\nเบาความ\nเบาใจ\nเบาบาง\nเบาปัญญา\nเบามือ\nเบาแรง\nเบาสมอง\nเบาหวาน\nเบาโหวง\nเบ้าตา\nเบาะแส\nเบิกความ\nเบิกบาน\nเบี้ยล่าง\nเบี้ยเลี้ยง\nเบี้ยหวัด\nเบี่ยงบ่าย\nเบียดบัง\nเบียดเบียน\nเบียดเสียด\nเบื้องต้น\nเบื้องบน\nเบื้องหน้า\nเบื้องหลัง\nแบกะดิน\nแบเบาะ\nแบ่งเบา\nแบ่งปัน\nแบ่งแยก\nแบบฉบับ\nแบบแปลน\nแบบแผน\nแบบฝึกหัด\nแบบพิมพ์\nแบบสอบถาม\nแบบอย่าง\nแบะแฉะ\nแบะท่า\nโบแดง\nโบราณคดี\nโบราณวัตถุ\nโบราณสถาน\nใบขับขี่\nใบจอง\nใบตอง\nใบแทรก\nใบบอก\nใบบุญ\nใบเบิกทาง\nใบปลิว\nใบพัด\nใบโพ\nใบไม้\nใบระกา\nใบรับรอง\nใบลา\nใบเลี้ยง\nใบสั่ง\nใบสำคัญ\nใบสุทธิ\nใบเสร็จ\nใบหน้า\nใบอนุญาต\nใบระกา\nปกครอง\nปกคลุม\nปกป้อง\nปกปิด\nปฏิบัติการ\nปฏิบัติบูชา\nปฐพีวิทยา\nปฐมฌาน\nปฐมทัศน์\nปฐมเทศนา\nปฐมนิเทศ\nปฐมพยาบาล\nปฐมยาม\nปฐมฤกษ์\nปฐมวัย\nปฐมสมโพธิ\nปนเป\nป่นปี้\nปมเขื่อง\nปมเด่น\nปมด้อย\nปรนเปรอ\nปรบไก่\nปรบมือ\nปรสิตวิทยา\nประโปรย\nประพรม\nประกันชีวิต\nประกันภัย\nประจักษ์พยาน\nประจัญบาน\nประจันหน้า\nประจำการ\nประจำเดือน\nประจำเมือง\nประจำยาม\nประชดประชัน\nประชากร\nประชากรศาสตร์\nประชาคม\nประชาชน\nประชาราษฎร์\nประชาชาติ\nประชาชี\nประชาทัณฑ์\nประชาบาล\nประชาพิจารณ์\nประชาภิบาล\nประชามติ\nประชาสงเคราะห์\nประชาสัมพันธ์\nประดับประดา\nประดามี\nประดาน้ำ\nประเดี๋ยวเดียว\nประเดี๋ยวนี้\nประทับใจ\nประทุษร้าย\nประเทศราช\nประพาสต้น\nประเพณีนิยม\nประลัยกัลป์\nประวัติการณ์\nประวัติศาสตร์\nประสบการณ์\nประสบการณ์นิยม\nประสาทการ\nประสูติการ\nประสูติกาล\nประเส\nปรับทุกข์\nปรับโทษ\nปรับปรุง\nปรากฏการณ์\nปราดเปรียว\nปราดเปรื่อง\nปราบปราม\nปริญญาบัตร\nปรัยัติธรรม\nปรุโปร่ง\nปลงใจ\nปลงตก\nปลดทุกข์\nปลดปลง\nปลดปล่อย\nปลดเปลื้อง\nปลดระวาง\nปลดแอก\nปล้นสะดม\nปลอกกระสุน\nปลอกคอ\nปลอดโปร่ง\nปลอดภัย\nปลอมปน\nปลอมแปลง\nปลอบโยน\nปล่อยใจ\nปล่อยตัว\nปล่อยปละ\nปลั๊กไฟ\nปลากริม\nปลาเค็ม\nปลาจ่อม\nปลาเจ่า\nปลาแดก\nปลาตู้\nปลาทอง\nปลาร้า\nปลาส้ม\nปลาดาว\nปลาบิน\nปลาฝา\nปลาวาฬ\nปลาหมึก\nปลาบปลื้ม\nปลายข้าว\nปลายแถว\nปลายทาง\nปลิ้นปลอก\nปลิ้นปล้อน\nปลีกตัว\nปลีกย่อย\nปลุกใจ\nปลุกปล้ำ\nปลุกปั่น\nปลุกระดม\nปลุกเสก\nปลูกฝัง\nปลูกสร้าง\nปวดถ่วง\nปวดมวน\nปวดร้าว\nป่วนปั่น\nป่วยการ\nปอกลอก\nป้องกัน\nปักใจ\nปักดำ\nปักหลัก\nปัจเจกบุคคล\nปัจเจกพุทธะ\nปัจเจกโพธิ\nปัจฉิมชน\nปัจฉิมทิศ\nปัจฉิมภาค\nปัจฉิมยาม\nปัจฉิมลิขิต\nปัจฉิมวัย\nปัจฉิมวาจา\nปัญญาชน\nปัญญาวิมุติ\nปัญญาอ่อน\nปัดเป่า\nปันส่วน\nปั่นป่วน\nปั่นแปะ\nปั่นหัว\nปั้นจิ้ม\nปั้นเจ๋อ\nปั้นปึ่ง\nปั้นสิบ\nปั๊มน้ำมัน\nป่าช้า\nป่าชายเลน\nป่าดง\nป่าดงดิบ\nป่าดิบ\nป่าเถื่อน\nป่าเบญจพรรณ\nป่าละเมาะ\nปากกา\nปากขอ\nปากแข็ง\nปากคอ\nปากคำ\nปากคีบ\nปากจัด\nปากน้ำ\nปากเปล่า\nปากเสียง\nปานกลาง\nป่านนี้\nป้านลม\nป้ายสี\nป่าวร้อง\nปิดฉาก\nปิดบัง\nปิตุฆาต\nปิตุภูมิ\nปีมะโว้\nปีแสง\nปี่กลาง\nปี่ไฉน\nปี่ชวา\nปี่นอก\nปี่ใน\nปี่พาทย์\nปี่อ้อ\nปีกกา\nปีนเกลียว\nปีนป่าย\nปึกแผ่น\nปึงปัง\nปืนกล\nปืนครก\nปืนพก\nปืนยา\nปืนยาว\nปืนลม\nปืนเล็ก\nปืนเล็กยาว\nปืนสั้น\nปืนใหญ่\nปุบปับ\nปุ๊บปั๊บ\nปุ่มเปือก\nปุยฝ้าย\nปุ๋ยคอก\nปุ๋ยเคมี\nปุ๋ยวิทยาศาสตร์\nปุ๋ยหมัก\nปุ๋ยอินทรีย์\nปูจ๋า\nปูเสฉวน\nปู่เจ้า\nปู่ทวด\nปูนขาว\nปูนซีเมนต์\nปูนดิบ\nปูนแดง\nปูนปลาสเตอร์\nปูนปั้น\nเป็ดเทศ\nเป็ดน้ำ\nเป็นกลาง\nเป็นใจ\nเป็นต้น\nเป็นต่อ\nเป็นรอง\nเป็นไร\nเป็นลม\nเป็นห่วง\nเป็นอยู่\nเปรมปรีดิ์\nเปรอะเปื้อน\nเปรียบเทียบ\nเปรียบเปรย\nเปรี้ยวปาก\nเปรี้ยวหวาน\nเปรื่องปราด\nเปลญวน\nเปล่งปลั่ง\nเปล่าดาย\nเปล่าเปลี่ยว\nเปลี่ยนใจ\nเปลี่ยนตัว\nเปลี่ยนแปลง\nเปลี่ยนมือ\nเปลี่ยนหน้า\nเป๋อเหลอ\nเปะปะ\nเป่ากบ\nเป้านิ่ง\nเป้าหมาย\nเปิดฉาก\nเปิดเปิง\nเปิดโปง\nเปิดผนึก\nเปิดเผย\nเปียกปูน\nแป้งสาลี\nแป้งนวล\nแป้งเปียก\nแป้งมัน\nแป้งฝุ่น\nแป้งร่ำ\nแป้งสิงคโปร์\nแป้งหมี่\nแปดปน\nแปดเปื้อน\nแปรปรวน\nแปรผัน\nแปรพักตร์\nแปรรูป\nแปรอักษร\nแปลกปลอม\nแปะโป้ง\nโป้ปด\nโปร่งแสง\nโปร่งใส\nโปรดปราน\nโปรยทาน\nโปรยปราย\nโปโลน้ำ\nผกผัน\nผกากรอง\nผงขาว\nผงชูรส\nผงซักฟอก\nผงฟู\nผดุงครรภ์\nผมไฟ\nผลพลอยได้\nผลลัพธ์\nผลัดเปลี่ยน\nผลิตผล\nผลิตภัณฑ์\nผลุบโผล่\nผสมเทียม\nผสมผสาน\nผสมผเส\nผสมพันธุ์\nผสมโรง\nผสมเสร็จ\nผ่องแผ้ว\nผ่องใส\nผ่อนคลาย\nผ่อนชำระ\nผ่อนปรน\nผ่อนผัน\nผ่อนส่ง\nผอมโซ\nผอมแห้ง\nผักชี\nผักตบชวา\nผักบุ้ง\nผังเมือง\nผัดผ่อน\nผันแปร\nผันผวน\nผ่าตัด\nผ่าเผย\nผ่าหมาก\nผ่าเหล่า\nผ้าขนหนู\nผ้าขาวม้า\nผ้าขี้ริ้ว\nผ้าเช็ดตัว\nผ้าเช็ดปาก\nผ้าเช็ดมือ\nผ้าเช็ดหน้า\nผ้าดิบ\nผ้าต่วน\nผ้าไตร\nผ้าถุง\nผ้าแถบ\nผ้านวม\nผ้านุ่ง\nผ้าใบ\nผ้าป่า\nผ้าป่าน\nผ้าผ่อน\nผ้าพันคอ\nผ้าพันแผล\nผ้าแพร\nผ้าโพกหัว\nผ้ามัดหมี่\nผ้ายาง\nผ้าลูกไม้\nผ้าเหลือง\nผ้าอนามัย\nผ้าอ้อม\nผาดโผน\nผาติกรรม\nผิดหวัง\nผิวเผิน\nผิวพรรณ\nผิวหนัง\nผีกระสือ\nผีกระหัง\nผีกองกอย\nผีโขมด\nผีดิบ\nผีตองเหลือง\nผีถ้วยแก้ว\nผีแถน\nผีทะเล\nผีบุญ\nผีปอบ\nผีพุ่งไต้\nผีฟ้า\nผีเรือน\nผีสาง\nผีเสื้อ\nผีห่า\nผึ่งผาย\nผุดผ่อง\nผุดผาด\nผู้คน\nผู้คุม\nผู้จัดการ\nผู้ชาย\nผู้เชี่ยวชาญ\nผู้ดี\nผู้โดยสาร\nผู้ต้องขัง\nผู้ต้องหา\nผู้แทน\nผู้น้อย\nผู้บริโภค\nผู้บังคับบัญชา\nผู้ปกครอง\nผู้ประกอบการ\nผู้ป่วย\nผู้พิพากษา\nผู้เยาว์\nผู้ร้าย\nผู้วิเศษ\nผู้สื่อข่าว\nผู้เสียหาย\nผู้หญิง\nผู้ใหญ่\nผู้ใหญ่บ้าน\nผูกขวัญ\nผูกขาด\nผูกพัน\nผูกมัด\nเผชิญหน้า\nเผด็จการ\nเผด็จศึก\nเผยแผ่\nเผยแพร่\nเผละผละ\nเผ่าพันธุ์\nเผื่อแผ่\nแผงลอย\nแผนการ\nแผนงาน\nแผนที่\nแผนผัง\nแผนภาพ\nแผนภูมิ\nแผ่นดิน\nแผ่นเสียง\nแผ้วพาน\nโผงผาง\nฝนทอง\nฝอยทอง\nฝักแค\nฝักบัว\nฝักฝ่าย\nฝักใฝ่\nฝังใจ\nฝังหัว\nฝาชี\nฝาแฝด\nฝาละมี\nฝ่าพระบาท\nฝ่าฝืน\nฝ่าฟัน\nฝ้าฟาง\nฝากตัว\nฝากฝัง\nฝีดาษ\nฝีมะม่วง\nฝีจักร\nฝีเท้า\nฝีปาก\nฝีพาย\nฝีมือ\nฝีเย็บ\nฝึกงาน\nฝึกปรือ\nฝึกฝน\nฝึกสอน\nฝึกหัด\nฝืดเคือง\nใฝ่ฝัน\nพงพี\nพงศ์พันธุ์\nพญาโศก\nพญาไฟ\nพบปะ\nพบพาน\nพรสวรรค์\nพรมคด\nพรมแดน\nพรมมิ\nพรรคพวก\nพรรณราย\nพรวดพราด\nพรหมชาติ\nพรหมลิขิต\nพรหมโลก\nพรหมวิหาร\nพร้อมใจ\nพร้อมพรั่ง\nพร้อมเพรียง\nพร้อมมูล\nพร้อมสรรพ\nพร้อมหน้า\nพระครู\nพระคุณ\nพระเคราะห์\nพระเครื่อง\nพระเจ้า\nพระเจ้าอยู่หัว\nพระชายา\nพระทัย\nพระนาง\nพระนางเจ้า\nพระเป็นเจ้า\nพระผู้เป็นเจ้า\nพระพิมพ์\nพระพุทธเจ้า\nพระพุทธองค์\nพระภูมิ\nพระยา\nพระรอง\nพระสนม\nพระสนมเอก\nพระองค์\nพระองค์เจ้า\nพระเอก\nพรั่งพร้อม\nพรั่งพรู\nพรั่นพรึง\nพร่างพราว\nพรายน้ำ\nพรายแพรว\nพราวแพรว\nพร่ำพลอด\nพร่ำเพรื่อ\nพร่ำเพ้อ\nพริกไทย\nพริ้งพราย\nพริ้งเพรา\nพริ้งเพริศ\nพริบตา\nพริ้มพราย\nพริ้มเพรา\nพรุ่งนี้\nพฤติกรรม\nพฤติการณ์\nพฤตินัย\nพลการ\nพลขับ\nพลความ\nพลเมือง\nพลรบ\nพลร่ม\nพลเรือน\nพลโลก\nพลศึกษา\nพลบค่ำ\nพลอดรัก\nพลังงาน\nพลังเงียบ\nพลังจิต\nพลั้งปาก\nพลั้งเผลอ\nพลั้งพลาด\nพลัดถิ่น\nพลัดพราก\nพลาดท่า\nพลาดพลั้ง\nพลิกแพลง\nพลีกรรม\nพลุ่งพล่าน\nพวกพ้อง\nพวงมาลัย\nพวงมาลา\nพวงหรีด\nพวงคราม\nพวงชมพู\nพวงแสด\nพ่วงพี\nพวยน้ำ\nพวยพุ่ง\nพสกนิกร\nพหุคูณ\nพหุภาคี\nพหูพจน์\nพหูสูต\nพอควร\nพอใจ\nพอใช้\nพอใช้ได้\nพอดี\nพอตัว\nพอทำเนา\nพอประมาณ\nพอเพียง\nพอแรง\nพอสมควร\nพอเหมาะ\nพ่อขุน\nพ่อครัว\nพ่อตา\nพ่อบ้าน\nพ่อพันธุ์\nพ่อม่าย\nพ่อเมือง\nพ่อเลี้ยง\nพ่อสื่อ\nพอกพูน\nพ้องพาน\nพักผ่อน\nพักพิง\nพักฟื้น\nพักร้อน\nพักแรม\nพัดยศ\nพัดลม\nพันพัว\nพับฐาน\nพับเพียบ\nพัวพัน\nพาซื่อ\nพาดพิง\nพิณพาทย์\nพิธีกร\nพิธีกรรม\nพิธีการ\nพิธีรีตอง\nพิธีสาร\nพินัยกรรม\nพิมพ์เขียว\nพิมพ์ใจ\nพิมพ์ดีด\nพิษสง\nพี่น้อง\nพี่เบิ้ม\nพี่เลี้ยง\nพึงใจ\nพึงพอใจ\nพึ่งพา\nพึ่งพิง\nพืชพันธุ์\nพืชมงคล\nพื้นฐาน\nพื้นที่\nพื้นบ้าน\nพื้นเพ\nพื้นเมือง\nพื้นเสีย\nพุพอง\nพุทธกาล\nพุทธคุณ\nพุทธจักร\nพุทธเจดีย์\nพุทธฎีกา\nพุทธปฏิมา\nพุทธปฏิมากร\nพุทธมามกะ\nพุทธศักราช\nพุทธศาสนิกชน\nพุทธองค์\nพุทธชาด\nพุทธรักษา\nพุ่มพวง\nพุ่มไม้\nพู่กัน\nพูดจา\nเพ่งเล็ง\nเพดานบิน\nเพดานปาก\nเพริศพราย\nเพริศพริ้ง\nเพริศแพร้ว\nเพรียกพร้อง\nเพรียวลม\nเพลงเชิด\nเพลงยาว\nเพลิงกัลป์\nเพลินใจ\nเพลินตา\nเพลี่ยงพล้ำ\nเพ้อฝัน\nเพาะกาย\nเพาะชำ\nเพาะปลูก\nเพิกถอน\nเพิกเฉย\nเพิ่มเติม\nเพิ่มพูน\nเพียงตา\nเพียงพอ\nเพียบแประ\nเพียบพร้อม\nเพื่อนเกลอ\nเพื่อนตาย\nเพื่อนบ้าน\nเพื่อนฝูง\nเพื่อนยาก\nแพ้ท้อง\nแพร่หลาย\nแพร่งพราย\nแพรวพราว\nโพธิญาณ\nโพธิบัลลังก์\nโพธิสมภาร\nโพธิสัตว์\nโพ้นทะเล\nโพยภัย\nไพ่ตาย\nไพ่ป๊อก\nไพรวัน\nไพรสณฑ์\nไพรสัณฑ์\nไพร่พล\nไพร่ฟ้า\nไพร่สม\nไพร่ส่วย\nไพร่หลวง\nฟกช้ำ\nฟองเต้าหู้\nฟองน้ำ\nฟองมัน\nฟ้องกลับ\nฟ้องร้อง\nฟอนเฟะ\nฟักทอง\nฟัดเฟียด\nฟันดาบ\nฟันฝ่า\nฟันแท้\nฟันน้ำนม\nฟันปลา\nฟันฟาง\nฟันเฟือง\nฟันม้า\nฟันเลื่อย\nฟันหนู\nฟั่นเฝือ\nฟั่นเฟือน\nฟื้นตัว\nฟื้นฝอย\nฟื้นฟู\nฟุ้งซ่าน\nฟุ้งเฟ้อ\nฟุ้งเฟื่อง\nฟุตบอล\nฟูฟ่อง\nฟูเฟื่อง\nฟูมฟัก\nฟูมฟาย\nเฟะฟะ\nเฟื่องฟ้า\nเฟื่องฟุ้ง\nเฟื่องฟู\nไฟฉาย\nไฟแช็ก\nไฟธาตุ\nไฟฟ้า\nภัตกิจ\nภาคทัณฑ์\nภาคพื้น\nภาคเรียน\nภาคภูมิ\nภาพถ่าย\nภาพนิ่ง\nภาพประกอบ\nภาพพจน์\nภาพยนตร์\nภาพลวงตา\nภาพลักษณ์\nภายนอก\nภายใน\nภายหน้า\nภายหลัง\nภารกิจ\nภารธุระ\nภารโรง\nภารตวิทยา\nภาษาศาสตร์\nภาสกร\nภิญโญภาพ\nภินชาติ\nภูธร\nภูธเรศ\nภูบาล\nภูเบศ\nภูเบศวร์\nภูเขา\nภูเขาไฟ\nภูผา\nภูตคาม\nภูตบดี\nภูตรูป\nภูเตศวร\nภูมินทร์\nภูมิบาล\nภูมิประเทศ\nภูมิภาค\nภูมิรัฐศาสตร์\nภูมิลำเนา\nภูมิศาสตร์\nภูมิอากาศ\nภูมิธรรม\nภูมิปัญญา\nภูมิรู้\nภูมิใจ\nภูมิฐาน\nภูมิคุ้มกัน\nภูมิแพ้\nภูษาโยง\nเภทภัย\nเภสัชกร\nเภสัชกรรม\nเภสัชวิทยา\nเภสัชศาสตร์\nโภคทรัพย์\nโภคภัณฑ์\nโภชนากร\nโภชนาการ\nมกุฎราชกุมาร\nมงคลแฝด\nมงคลสูตร\nมงคลหัตถี\nมณเฑียรบาล\nมดดำ\nมดแดง\nมดเท็จ\nมดยอบ\nมดลูก\nมธุปายาส\nมธุรส\nมนเทียรบาล\nมนุษย์กบ\nมโนกรรม\nมโนคติ\nมโนทุจริต\nมโนธรรม\nมโนภาพ\nมโนมัย\nมโนรถ\nมโนรมย์\nมโนสุจริต\nมรรคนายก\nมรรคผล\nมฤคชาติ\nมฤคทายวัน\nมฤคราช\nมลทิน\nมลพิษ\nมลสาร\nมวกเหล็ก\nม้วนหน้า\nมวยไทย\nมวยปล้ำ\nมวยล้ม\nมวยวัด\nมวยสากล\nมวยหมู่\nมวลสาร\nมอคราม\nมอซอ\nมอหมึก\nมองเมียง\nมอบตัว\nมอบหมาย\nมอมเมา\nมะขามเทศ\nมะขามป้อม\nมะขามเปียก\nมะเขือเทศ\nมะเขือพวง\nมะพร้าวแก้ว\nมักคุ้น\nมักจี่\nมักง่าย\nมักน้อย\nมักมาก\nมักใหญ่\nมั่งคั่ง\nมั่งมี\nมัจจุราช\nมัชฌิมนิกาย\nมัชฌิมประเทศ\nมัชฌิมยาม\nมัชฌิมวัย\nมัดจำ\nมัดหมี่\nมัธยมกาล\nมัธยมศึกษา\nมันแกว\nมันเทศ\nมันฝรั่ง\nมันเปลว\nมันสมอง\nมั่นคง\nมั่นใจ\nมั่นหมาย\nมั่นเหมาะ\nมัวเมา\nมัวหมอง\nมั่วสุม\nม้าเทศ\nม้าน้ำ\nม้ามืด\nม้าเร็ว\nม้าล่อ\nม้าลาย\nมากมาย\nมาตรการ\nมาตรฐาน\nมาตราส่วน\nมาตุคาม\nมาตุฆาต\nมาตุภูมิ\nม่านตา\nม่านบังตา\nมายากร\nมายากล\nมายาการ\nมายาวี\nมารผจญ\nมารวิชัย\nมารสังคม\nมารหัวขน\nมาลาการ\nมิ่งขวัญ\nมิ่งมิตร\nมิจฉาจาร\nมิจฉาชีพ\nมิดชิด\nมิดเมี้ยน\nมิดหมี\nมิตรจิต\nมิตรภาพ\nมิตรสหาย\nมิน่า\nมีหน้า\nมีดโกน\nมีดดาบ\nมีดโต้\nมีดพก\nมีดพับ\nมีดสั้น\nมึนงง\nมึนชา\nมึนตึง\nมึนเมา\nมืดครึ้ม\nมืดมน\nมืดมัว\nมือจับ\nมือดี\nมือเติบ\nมือปืน\nมือเปล่า\nมือมืด\nมือสอง\nมือเสือ\nมือหนึ่ง\nมือใหม่\nมุกตลก\nมุขปาฐะ\nมุขมนตรี\nมุ่งมั่น\nมุ่งมาด\nมุ่งหน้า\nมุ่งหมาย\nมุ่งหวัง\nมุ้งลวด\nมุ้งสายบัว\nมุมก้ม\nมุมกลับ\nมุมเงย\nมุมฉาก\nมุมตรง\nมุมป้าน\nมุมมืด\nมุมแย้ง\nมุมสะท้อน\nมุมหักเห\nมุมแหลม\nมุสาวาท\nมูกเลือด\nมูกมัน\nมูกหลวง\nมูนดิน\nมูลฐาน\nมูลนาย\nมูลนิธิ\nมูลเหตุ\nมูลค่า\nมูลฝอย\nเม็ดเงิน\nเม็ดเลือด\nเม็ดโลหิต\nเม่นทะเล\nเมรุมาศ\nเมรุราช\nเมล์อากาศ\nเมาดิบ\nเมามัน\nเมามัว\nเมามาย\nเมินเฉย\nเมียน้อย\nเมียหลวง\nเมียงมอง\nเมี่ยงลาว\nเมี่ยงส้ม\nเมื่อกี้\nเมื่อตะกี้\nเมื่อใด\nเมื่อไร\nเมื่อไหร่\nเมื่อนั้น\nเมืองขึ้น\nเมืองท่า\nเมืองนอก\nเมืองหลวง\nเมื่อยขบ\nเมื่อยล้า\nแม่กอง\nแม่กุญแจ\nแม่คุณ\nแม่งาน\nแม่เจ้า\nแม่ชี\nแม่ทัพ\nแม่นม\nแม่น้ำ\nแม่บท\nแม่บ้าน\nแม่เบี้ย\nแม่พระ\nแม่พิมพ์\nแม่เพลง\nแม่มด\nแม่ม่าย\nแม่ไม้\nแม่ยก\nแม่ยาย\nแม่ร้าง\nแม่เรือน\nแม่แรง\nแม่เล้า\nแม่เลี้ยง\nแม่สี\nแม่สื่อ\nแม่เหล็ก\nแมงมุม\nแม่นยำ\nแมลงช้าง\nแมลงวัน\nแมลงปอ\nแมลงภู่\nแมลงเม่า\nแมวเซา\nแมวน้ำ\nแมวป่า\nแมวมอง\nไม้กลัด\nไม้กวาด\nไม้กางเขน\nไม้เกาหลัง\nไม้ขีดไฟ\nไม้จิ้มฟัน\nไม้เด็ด\nไม้ตาย\nไม้ตีพริก\nไม้ที\nไม้เท้า\nไม้บรรทัด\nไม้เมตร\nไม้ระแนง\nไม้เรียว\nไม้หมอน\nไม้อัด\nไม้จัตวา\nไม้ตรี\nไม้ไต่คู้\nไม้โท\nไม้ผัด\nไม้มลาย\nไม้ม้วน\nไม้ยมก\nไม้หน้า\nไม้หันอากาศ\nไม้เอก\nยกกลีบ\nยกครู\nยกเครื่อง\nยกเค้า\nยกทรง\nยกฟ้อง\nยกเมฆ\nยกยอ\nยกย่อง\nยกเลิก\nยกเว้น\nย่นย่อ\nยมทูต\nยมบาล\nยมราช\nยมโลก\nยวดยิ่ง\nยวดยาน\nยวนยี\nยวบยาบ\nย่อท้อ\nย่อส่วน\nย่อหน้า\nย่อหย่อน\nยอกย้อน\nยองใย\nย่องเบา\nย่องแย่ง\nยอดเยี่ยม\nยอดอก\nย้อนยอก\nย้อนรอย\nย้อนศร\nย้อนแสง\nย้อนหลัง\nยอบแยบ\nยอมความ\nย่อมเยา\nย่อยยับ\nยักยอก\nยักย้าย\nยักเยื้อง\nยัญกรรม\nยัญพิธี\nยัดเยียด\nยับเยิน\nยับยั้ง\nยั่วยวน\nยั่วยุ\nยั่วเย้า\nยากวาด\nยากันยุง\nยาเขียว\nยาใจ\nยาฉุน\nยาชา\nยาซัด\nยาดอง\nยาแดง\nยาถ่าย\nยาธาตุ\nยานัตถุ์\nยาเบื่อ\nยาโป๊\nยาแฝด\nยาพิษ\nยาระบาย\nยาสลบ\nยาสั่ง\nยาสีฟัน\nยาสูบ\nยาเส้น\nยาเสพติด\nยาหม่อง\nยาเหลือง\nย่าทวด\nย่านาง\nยากแค้น\nยากจน\nยากเย็น\nยากไร้\nยางนอก\nยางใน\nยางมะตอย\nยางมะตูม\nยางลบ\nยางสน\nยางอาย\nย่างกราย\nย่างเยื้อง\nย่างสด\nย่างสามขุม\nย่างเหยียบ\nยานเกราะ\nยานพาหนะ\nยานอวกาศ\nยานคาง\nยายทวด\nยาวเฟื้อย\nยาวยืด\nยาวเหยียด\nยำทวาย\nยำใหญ่\nยำเกรง\nยำเยง\nย่ำต๊อก\nย่ำยี\nย่ำแย่\nยิงเป้า\nยิ่งนัก\nยิ่งยวด\nยิ่งใหญ่\nยินดี\nยินยอม\nยินร้าย\nยิ้มกริ่ม\nยิ้มแฉ่ง\nยิ้มแต้\nยิ้มแป้น\nยิ้มเผล่\nยิ้มเยาะ\nยิ้มแย้ม\nยียวน\nยึดครอง\nยึดถือ\nยึดมั่น\nยึดเหนี่ยว\nยืดยาด\nยืดยาว\nยืดเยื้อ\nยืดหยุ่น\nยืดอก\nยืนกราน\nยืนต้น\nยืนพื้น\nยืนยง\nยืนยัน\nยืนหยัด\nยื้อยุด\nยุยง\nยุแยง\nยุแหย่\nยุคลบาท\nยุคเข็ญ\nยุคทอง\nยุคมืด\nยุ่งขิง\nยุ่งยาก\nยุ่งเหยิง\nยุติธรรม\nยุทธการ\nยุทธนาวี\nยุทธปัจจัย\nยุทธภัณฑ์\nยุทธภูมิ\nยุทธวิธี\nยุทธศาสตร์\nยุทธหัตถี\nยุทธนาการ\nยุทธนาธิการ\nยุบยับ\nยุบยิบ\nยุพราช\nยู่ยี่\nเย็นเจี๊ยบ\nเย็นใจ\nเย็นฉ่ำ\nเย็นเฉียบ\nเย็นชา\nเย็นชืด\nเย็นตา\nเย็นเยียบ\nเย็นเยือก\nเย็นวาบ\nเย็นวูบ\nเย็บกี่\nเย็บจักร\nเย็บด้าย\nเย้ยหยัน\nเย้าหยอก\nเยาะเย้ย\nเยี่ยมกราย\nเยี่ยมเยียน\nเยี่ยมเยือน\nเยี่ยมยอด\nเยื่อเคย\nเยื่อใย\nเยือกเย็น\nเยื้องกราย\nเยื้องยัก\nเยื้องย่าง\nแยกย้าย\nแยกแยะ\nแย่งชิง\nแยบคาย\nแยบยล\nแย้มพราย\nแย้มยิ้ม\nแย้มสรวล\nโยเย\nโย้เย้\nโยกโคลง\nโยกย้าย\nโยกโย้\nโยนกลอง\nใยหิน\nรกชัฏ\nรกร้าง\nรกเรี้ยว\nรกเรื้อ\nรกราก\nรงควัตถุ\nรชนีกร\nรถกระบะ\nรถเก๋ง\nรถเข็น\nรถแข่ง\nรถจักร\nรถจี๊ป\nรถตู้\nรถทัวร์\nรถบรรทุก\nรถพ่วง\nรถพยาบาล\nรถไฟ\nรถไฟฟ้า\nรถม้า\nรถเมล์\nรถยนต์\nรถราง\nรถลาก\nรถสปอร์ต\nรถสิบล้อ\nรบกวน\nรบรา\nรบเร้า\nรมดำ\nร่มเกล้า\nร่มชูชีพ\nร่มเย็น\nร่มรื่น\nร่วงโรย\nรวงผึ้ง\nรวงรัง\nรวดเร็ว\nรวนเร\nรวบยอด\nรวบรวม\nรวบรัด\nรวมพล\nรวมหัว\nร่วมใจ\nร่วมเพศ\nร่วมมือ\nร่วมรัก\nร่วมสมัย\nรวยริน\nรวยรื่น\nรสชาติ\nรสนิยม\nรองท้อง\nรองเท้า\nรองพื้น\nร่องน้ำ\nร่องรอย\nร้องขอ\nร้องทุกข์\nร้องเรียน\nร้องห่ม\nร้องไห้\nรองช้ำ\nรองทรง\nรอดชีวิต\nรอดตัว\nรอดตาย\nรอนแรม\nร่อนเร่\nร้อนใจ\nร้อนตัว\nร้อนรน\nร้อนรุ่ม\nร้อนวิชา\nร้อนอาสน์\nรอบจัด\nรอบเดือน\nรอบรู้\nรอยร้าว\nร่อยหรอ\nร้อยละ\nร้อยกรอง\nร้อยแก้ว\nร้อยหวาย\nระนาดทุ้ม\nระนาดเอก\nระเบิดขวด\nระเบิดมือ\nระเบียบการ\nรักใคร่\nรักษาการ\nรักษาการณ์\nรังไข่\nรังแตน\nรังนก\nรังผึ้ง\nรังเพลิง\nรังมด\nรังสรรค์\nรังสฤษฏ์\nรั้งรอ\nรังสีแพทย์\nรังสีวิทยา\nรัชกาล\nรัชทายาท\nรัชนีกร\nรัฐธรรมนูญ\nรัฐบาล\nรัฐบุรุษ\nรัฐประศาสน์\nรัฐประหาร\nรัฐพิธี\nรัฐมนตรี\nรัฐวิสาหกิจ\nรัฐศาสตร์\nรัฐสภา\nรัดกุม\nรัดเกล้า\nรัดตัว\nรัดประคด\nรัดรึง\nรัดรูป\nรัตติกาล\nรับขวัญ\nรับจ้าง\nรับช่วง\nรับใช้\nรับซื้อ\nรับทราบ\nรับประกัน\nรับประทาน\nรับปาก\nรับผิด\nรับผิดชอบ\nรับฟ้อง\nรับฟัง\nรับมือ\nรับรอง\nรับรู้\nรับสมัคร\nรับสั่ง\nรับหน้า\nรับเหมา\nรั่วไหล\nรามือ\nร่าเริง\nรากแก้ว\nรากขวัญ\nรากฐาน\nรากฟัน\nรากศัพท์\nรากเหง้า\nร่างกาย\nร่างแห\nร้างรา\nราชกรณียกิจ\nราชการ\nราชกิจ\nราชครู\nราชฐาน\nราชทัณฑ์\nราชทินนาม\nราชทูต\nราชธานี\nราชนาวี\nราชบัณฑิต\nราชบัลลังก์\nราชบาตร\nราชบุตร\nราชปะแตน\nราชภัฏ\nราชมัล\nราชยาน\nราชรถ\nราชลัญจกร\nราชเลขาธิการ\nราชเลขานุการ\nราชวงศ์\nราชวัติ\nราชสกุล\nราชสมบัติ\nราชสาส์น\nราชหัตถเลขา\nราชองครักษ์\nราชโองการ\nราชาคณะ\nราชาศัพท์\nราชินีนาถ\nร้านชำ\nร้านรวง\nราบคาบ\nราบรื่น\nราบเรียบ\nรายการ\nรายงาน\nรายจ่าย\nรายได้\nรายทาง\nรายรับ\nรายล้อม\nรายละเอียด\nรายวิชา\nร่ายยาว\nร่ายรำ\nร้ายกาจ\nร้ายแรง\nราวนม\nราวป่า\nร้าวฉาน\nร้าวราน\nรำพัด\nรำแพน\nรำวง\nร่ำไป\nร่ำร้อง\nร่ำเรียน\nร่ำไร\nร่ำลา\nร่ำไห้\nริเริ่ม\nริอ่าน\nริมฝีปาก\nริ้วรอย\nรีบร้อน\nรีบรุด\nรีบเร่ง\nรื่นรมย์\nรื่นเริง\nรื้อถอน\nรื้อฟื้น\nรุกฆาต\nรุกราน\nรุกล้ำ\nรุกไล่\nรุ่งขึ้น\nรุ่งแจ้ง\nรุ่งเช้า\nรุ่งเรือง\nรุ่งโรจน์\nรุ่งสว่าง\nรุ่งสาง\nรุ่งอรุณ\nรุจิเรข\nรุดหน้า\nรุนแรง\nรุมเร้า\nรุมล้อม\nรุ่มรวย\nรุ่มร้อน\nรุ่ยร่าย\nรู้แกว\nรู้ความ\nรู้คุณ\nรู้งาน\nรู้จัก\nรู้แจ้ง\nรู้ใจ\nรู้เชิง\nรู้ตัว\nรู้ทัน\nรู้เท่า\nรู้เรื่อง\nรู้สำนึก\nรู้สึก\nรู้เห็น\nรูปการณ์\nรูปโฉม\nรูปฌาน\nรูปถ่าย\nรูปทรง\nรูปธรรม\nรูปแบบ\nรูปพรรณ\nรูปพรหม\nรูปภพ\nรูปภาพ\nรูปร่าง\nรูปสมบัติ\nเร่ร่อน\nเร่งด่วน\nเร่งมือ\nเร่งรัด\nเร่งรีบ\nเร่งเร้า\nเร้นลับ\nเร่อร่า\nเร่าร้อน\nเราะราย\nเราะร้าย\nเริงใจ\nเริงรมย์\nเริดร้าง\nเริ่มต้น\nเริ่มแรก\nเรี่ยราด\nเรี่ยไร\nเรียกคืน\nเรียกตัว\nเรียกร้อง\nเรียกหา\nเรียบร้อย\nเรียงความ\nเรียงตัว\nเรียงเบอร์\nเรียงพิมพ์\nเรียงเม็ด\nเรียงราย\nเรียนรู้\nเรียบร้อย\nเรียบเรียง\nเรียบวุธ\nเรี่ยมเร้\nเรี่ยวแรง\nเรือกลไฟ\nเรือกอและ\nเรือกำปั่น\nเรือจ้าง\nเรือดำน้ำ\nเรือโดยสาร\nเรือตรวจการณ์\nเรือตังเก\nเรือธง\nเรือนำร่อง\nเรือบด\nเรือบิน\nเรือใบ\nเรือประมง\nเรือพ่วง\nเรือพิฆาต\nเรือยนต์\nเรือยาว\nเรือโยง\nเรือรบ\nเรือลากจูง\nเรือสำปั้น\nเรือสำเภา\nเรือหลวง\nเรือหางยาว\nเรืออีโปง\nเรือเอี้ยมจุ๊น\nเรื้อรัง\nเรือกสวน\nเรืองนาม\nเรืองรอง\nเรืองแสง\nเรื่องราว\nเรื่องสั้น\nเรือนแก้ว\nเรือนจำ\nเรือนเบี้ย\nเรือนแพ\nเรือนหอ\nเรื่อยเจื้อย\nเรื่อยเฉื่อย\nเรื่อยเปื่อย\nแรเงา\nแรกนา\nแรกนาขวัญ\nแรงงาน\nแรงดึงดูด\nแรงเทียน\nแรงม้า\nแรงเหวี่ยง\nแรมรอน\nแรมรา\nแรมโรย\nโรคจิต\nโรงครัว\nโรงงาน\nโรงเจ\nโรงเตี๊ยม\nโรงทาน\nโรงนา\nโรงพยาบาล\nโรงพัก\nโรงพิมพ์\nโรงเรียน\nโรงเรือน\nโรงแรม\nโรงเลี้ยง\nโรงเลื่อย\nโรงสี\nโรงสีข้าว\nโรงอาหาร\nโรมรัน\nโรยรา\nฤชากร\nฤดูกาล\nลงขัน\nลงแขก\nลงคอ\nลงตัว\nลงท้าย\nลงทุน\nลงโทษ\nลงพุง\nลงมือ\nลงรัก\nลงรอย\nลงแรง\nลงโรง\nลงเอย\nลดตัว\nลดละ\nลดเลี้ยว\nลดหย่อน\nลดหลั่น\nลนลาน\nล้นพ้น\nล้นหลาม\nล้นเหลือ\nลบล้าง\nลบเลือน\nลบหลู่\nลมกรด\nลมค้า\nลมงวง\nลมแดด\nลมทะเล\nลมบก\nลมบน\nลมบ้าหมู\nลมปราณ\nลมปาก\nลมพิษ\nลมว่าว\nลมเสีย\nลมหนาว\nลมหายใจ\nล่มจม\nล่มสลาย\nล้มละลาย\nล้มลุก\nล้มเลิก\nล่วงเกิน\nล่วงรู้\nล่วงละเมิด\nล่วงลับ\nล่วงล้ำ\nล่วงเลย\nล่วงหน้า\nลวดลาย\nลวดสปริง\nลวดหนาม\nล้วนแล้ว\nลหุโทษ\nล่อลวง\nล่อหลอก\nล่อแหลม\nล้อต๊อก\nล้อเลื่อน\nล้อเล่น\nล้อเลียน\nล้อหลอก\nลองเชิง\nลองดี\nลองภูมิ\nล่องหน\nลอดช่อง\nล่อนจ้อน\nลอบกัด\nล้อมวง\nลอยแก้ว\nลอยชาย\nลอยตัว\nลอยนวล\nลอยแพ\nลอยลำ\nละทิ้ง\nละเลย\nละเว้น\nละครนอก\nละครใน\nละครเพลง\nละครร้อง\nละครรำ\nละครลิง\nละครสัตว์\nละเอียดอ่อน\nลักไก่\nลักพา\nลักเพศ\nลักยิ้ม\nลักลอบ\nลักลั่น\nลักหลับ\nลัดเลาะ\nลับตา\nลับแล\nลับหลัง\nลาออก\nล่าช้า\nล่าทัพ\nล้าสมัย\nล้าหลัง\nลากข้าง\nล้างบาง\nล้างผลาญ\nลาดเขา\nลาดตระเวน\nลาดเท\nลาดยาง\nลานบิน\nลาภปาก\nลาภลอย\nลามปาม\nลามเลีย\nลายคราม\nลายเซ็น\nลายแทง\nลายน้ำ\nลายพร้อย\nลายมือ\nลายลักษณ์\nลายเส้น\nลำกล้อง\nลำแข้ง\nลำธาร\nลำแสง\nลำไส้\nลำตัด\nลำนำ\nล่ำสัน\nล้ำยุค\nล้ำสมัย\nล้ำลึก\nล้ำเลิศ\nล้ำเส้น\nล้ำหน้า\nลิงจุ่น\nลิงลม\nลิงโลด\nลิดรอน\nลิ้นไก่\nลิ้นชัก\nลิ้นปี่\nลิ้นควาย\nลิ้นงูเห่า\nลิ้นหมา\nลิบลับ\nลิบลิ่ว\nลิ่มเลือด\nลี้ภัย\nลี้ลับ\nลึกซึ้ง\nลึกลับ\nลึกล้ำ\nลืมตน\nลืมต้น\nลืมตัว\nลืมตา\nลืมเลือน\nลือชา\nลือชื่อ\nลือลั่น\nลุล่วง\nลุกลน\nลุกลาม\nลุกลี้ลุกลน\nลุกฮือ\nลุ่มน้ำ\nลุ่มลึก\nลุ่มหลง\nลุ่ทาง\nลูกกรง\nลูกกรอก\nลูกกรุง\nลูกกลอน\nลูกกลิ้ง\nลูกกวาด\nลูกกะจ๊อก\nลูกกุญแจ\nลูกเกด\nลูกแก้ว\nลูกขนไก่\nลูกข่าง\nลูกขุน\nลูกเขย\nลูกครึ่ง\nลูกคลื่น\nลูกความ\nลูกคอ\nลูกค้า\nลูกคิด\nลูกคู่\nลูกจ้าง\nลูกช้าง\nลูกชิด\nลูกชิ้น\nลูกชุบ\nลูกซอง\nลูกโซ่\nลูกดอก\nลูกดิ่ง\nลูกตะกั่ว\nลูกตุ้ม\nลูกเต้า\nลูกเต๋า\nลูกถ้วย\nลูกทุ่ง\nลูกเธอ\nลูกน้อง\nลูกน้ำ\nลูกนิมิต\nลูกบอล\nลูกบ้าน\nลูกบาศก์\nลูกบิด\nลูกเบี้ยว\nลูกประคบ\nลูกประคำ\nลูกปัด\nลูกปืน\nลูกโป่ง\nลูกผสม\nลูกผู้ชาย\nลูกผู้หญิง\nลูกพรรค\nลูกพี่\nลูกฟูก\nลูกไฟ\nลูกมือ\nลูกโม่\nลูกไม้\nลูกยาเธอ\nลูกรอก\nลูกรัง\nลูกเรือ\nลูกล้อ\nลูกลอย\nลูกเล่น\nลูกเลี้ยง\nลูกโลก\nลูกวัด\nลูกศร\nลูกศิษย์\nลูกสมุน\nลูกสะใภ้\nลูกสูบ\nลูกเสือ\nลูกหนัง\nลูกหนี้\nลูกหนู\nลูกหมาก\nลูกหลง\nลูกหลาน\nลูกหาบ\nลูกหิน\nลูกเห็บ\nลูกเหม็น\nลูกแหง่\nลูกอม\nลูกหม้อ\nลูบคม\nลูบคลำ\nลูบไล้\nเล็กน้อย\nเลขคณิต\nเลขผา\nเลขหมาย\nเล็ดลอด\nเล่นงาน\nเล่นแง่\nเล่นชู้\nเล่นตัว\nเล่นลิ้น\nเล่นหัว\nเลนส์นูน\nเลนส์เว้า\nเล็บครุฑ\nเลยเถิด\nเลศนัย\nเล่ห์กล\nเล่ห์เหลี่ยม\nเลอโฉม\nเลอมาน\nเลอเลิศ\nเลอสรวง\nเล่อล่า\nเลอะเลือน\nเล่าเรียน\nเล่าลือ\nเลาะลัด\nเลิกรา\nเลิกร้าง\nเลิกล้ม\nเลิศเลอ\nเลี้ยงชีพ\nเลี้ยงดู\nเลี้ยงต้อย\nเลียบเคียง\nเลี้ยวลด\nเลือกตั้ง\nเลือกเฟ้น\nเลือกสรร\nเลื่องลือ\nเลือดกำเดา\nเลือดเนื้อ\nเลือดฝาด\nเลือดเย็น\nเลือดร้อน\nเลือดหมู\nเลือดอุ่น\nเลือนราง\nเลื่อนเปื้อน\nเลื่อนลอย\nเลื่อมพราย\nเลื่อมใส\nเลื่อยฉลุ\nเลื่อยลันดา\nเลื่อยวงเดือน\nเลื้อยคลาน\nแลเหลียว\nแลกเปลี่ยน\nแล้วกัน\nและเล็ม\nโล่งใจ\nโล่งโถง\nโล่งอก\nโลดเต้น\nโลดโผน\nโลดลิ่ว\nโลดแล่น\nไล่ที่\nไล่เบี้ย\nไล่เลี่ย\nไล่เลียง\nไล่หลัง\nไล่ออก\nวกวน\nวงกบ\nวงกลม\nวงการ\nวงแขน\nวงเงิน\nวงจร\nวงนอก\nวงใน\nวงรี\nวงเล็บ\nวงเวียน\nวงแหวน\nวงศ์วาน\nวจีกรรม\nวจีเภท\nวจีภาค\nวนเวียน\nวอดวาย\nว็อบแว็บ\nวังวน\nวังหน้า\nวังหลวง\nวังหลัง\nวัดราษฎร์\nวัดวา\nวัดหลวง\nวัดผล\nวัดพื้น\nวัตถุนิยม\nวัตถุประสงค์\nวัตรปฏิบัติ\nวันโกน\nวันพระ\nวันเพ็ญ\nวัยรุ่น\nวัยวุฒิ\nว่ากล่าว\nว่าจ้าง\nว่าด้วย\nว่าที่\nวางก้าม\nวางใจ\nวางตัว\nวางตา\nวางโต\nวางท่า\nวางมวย\nวางมาด\nวางมือ\nวางวาย\nว่างเปล่า\nว่างเว้น\nวาดเขียน\nว่านเครือ\nวาบหวาม\nวายชนม์\nวายปราณ\nวายวาง\nวายวอด\nวายร้าย\nวายุภักษ์\nวาววับ\nวาววาม\nวาวแวว\nวาวแสง\nวิกฤตการณ์\nวิกฤติการณ์\nวิกฤตกาล\nวิกฤติกาล\nวิกลจริต\nวิงเวียน\nวิ่งเต้น\nวิ่งผลัด\nวิ่งรอก\nวิ่งราว\nวิจิตรศิลป์\nวิชาการ\nวิชาชีพ\nวิชาธร\nวิญญูชน\nวิดพื้น\nวิตกจริต\nวิถีทาง\nวิทยากร\nวิทยากล\nวิทยาการ\nวิทยาเขต\nวิทยาทาน\nวิทยาธร\nวิทยานิพนธ์\nวิทยาศาสตร์\nวิเทศสัมพันธ์\nวิธีการ\nวินัยธร\nวินัยปิฎก\nวินาศกรรม\nวินาศภัย\nวินาศสันตะโร\nวิภัชพยากรณ์\nวิภัชวาที\nวิไลวรรณ\nวิสัญญีแพทย์\nวิสัญญีภาพ\nวิสัญญีวิทยา\nวุฒิบัตร\nวุฒิสภา\nวุฒิสมาชิก\nวุ่นวาย\nวุ้นเส้น\nวูบวาบ\nเวจกุฎี\nเวจมรรค\nเวชกรรม\nเวชภัณฑ์\nเวชศาสตร์\nเวทมนตร์\nเวนคืน\nเวรกรรม\nเวฬุการ\nเวฬุวัน\nเว้าวอน\nเวิ้งว้าง\nเวียงวัง\nเวียนเทียน\nแว้งกัด\nแวดล้อม\nแวดวง\nแว่นขยาย\nแว่นแคว้น\nแว่นตา\nแวบวับ\nแววตา\nแวววาม\nแวววาว\nแวะเวียน\nโวยวาย\nไวไฟ\nไว้ใจ\nไว้ชื่อ\nไว้ตัว\nไว้ทุกข์\nไว้ลาย\nไว้หน้า\nไว้อาลัย\nศนิวาร\nศอกกลับ\nศอกกำ\nศอกกำมา\nศักดิ์ศรี\nศักดิ์สิทธิ์\nศารทวิษุวัติ\nศาลแขวง\nศาลจังหวัด\nศาลชั้นต้น\nศาลฎีกา\nศาลเตี้ย\nศาลทหาร\nศาลปกครอง\nศาลพระภูมิ\nศาลเพียงตา\nศาลแพ่ง\nศาลรัฐธรรมนูญ\nศาลแรงงาน\nศาลล้มละลาย\nศาลโลก\nศาลสูง\nศาลสูงสุด\nศาลอาญา\nศาลอุทธรณ์\nศาลากลาง\nศาลาดิน\nศาลาราย\nศาลาวัด\nศิลาฤกษ์\nศิลาแลง\nศิษย์เก่า\nศิษย์เอก\nศีลจุ่ม\nศีลธรรม\nศีลวัต\nศีลอด\nศูนย์กลาง\nศูนย์การค้า\nศูนย์ถ่วง\nศูนย์สูตร\nศูนย์หน้า\nเศร้าใจ\nเศร้าโศก\nเศร้าสร้อย\nเศร้าสลด\nเศร้าหมอง\nเศวตฉัตร\nเศษเกิน\nเศษซ้อน\nเศษวรรค\nเศษส่วน\nเศษเหล็ก\nโศกนาฏกรรม\nโศกศัลย์\nโศกเศร้า\nโศกสลด\nสกลโลก\nส่งเดช\nส่งท้าย\nส่งเสริม\nส่งเสีย\nส่งเสียง\nสงบเงียบ\nสงบเสงี่ยม\nสง่างาม\nสง่าราศี\nสดชื่น\nสดใส\nสตรีเพศ\nสติปัญญา\nสถลมารค\nสถานกงสุล\nสถานที่\nสถานทูต\nสถานการณ์\nสถานภาพ\nสถิติศาสตร์\nสนตะพาย\nสนใจ\nส้นตีน\nสนธิสัญญา\nสนนราคา\nสนับแข้ง\nสนับเพลา\nสนับมือ\nสนามบิน\nสนามเพลาะ\nสนิทสนม\nสนิมขุม\nสนิมสร้อย\nสนุกสนาน\nสบประมาท\nสบายใจ\nสภาพธรรม\nสมควร\nสมจริง\nสมใจ\nสมนัย\nสมน้ำหน้า\nสมประกอบ\nสมส่วน\nสมหวัง\nสมคบ\nสมทบ\nสมยอม\nสมรัก\nสมรู้\nสมสู่\nส้มฉุน\nส้มตำ\nส้มลิ้ม\nส้มกุ้ง\nส้มเช้า\nสมญานาม\nสมมติฐาน\nสมมุติฐาน\nสมมติเทพ\nสมรภูมิ\nสมัครใจ\nสมัยนิยม\nสมุทรศาสตร์\nสมุทรเสนา\nสยดสยอง\nสยองขวัญ\nสยามรัฐ\nสรรหา\nสรวมชีพ\nสรวลเส\nสร้อยเศร้า\nสร้างสรรค์\nสร้างเสริม\nสลดใจ\nสลบไสล\nสละสลวย\nสลาเหิน\nสลากภัต\nสวนครัว\nสวนป่า\nสวนสนุก\nสวนหย่อม\nส่วนกลาง\nส่วนเกิน\nส่วนตัว\nส่วนบุญ\nส่วนแบ่ง\nส่วนประกอบ\nส่วนพระองค์\nส่วนผสม\nส่วนรวม\nส่วนร่วม\nส่วนลด\nส่วนสัด\nสวมกอด\nสวมเขา\nสวมรอย\nสวยมภู\nสว่างไสว\nสวามิภักดิ์\nสวิงสวาย\nสสารนิยม\nส่อเสียด\nสอดคล้อง\nสอดแทรก\nสอดแนม\nสอบถาม\nสอบทาน\nสอบไล่\nสอบสวน\nส้อมเสียง\nสะสวย\nสะแกวัลย์\nสะแกแสง\nสะใจ\nสะเด็ดยาด\nสะเทือนใจ\nสะบัดช่อ\nสั่งสม\nสั่งสอน\nสั่งเสีย\nสังเกตการณ์\nสังคมนิยม\nสังคมวิทยา\nสังคมศาสตร์\nสังคมศึกษา\nสังคมสงเคราะห์\nสัญญาบัตร\nสัดส่วน\nสัตการ\nสัตบุรุษ\nสัตบริภัณฑ์\nสัตภัณฑ์\nสัตมหาสถาน\nสัตโลหะ\nสันเขา\nสันดอน\nสันหลัง\nสั่นเทา\nสั่นเทิ้ม\nสันติบาล\nสันติภาพ\nสันติวิธี\nสันติสุข\nสับเปลี่ยน\nสับสน\nสับหลีก\nสับหว่าง\nสัมมาคารวะ\nสัมมาชีพ\nส่าเหล้า\nสากกะเบือ\nสาทิสลักษณ์\nสาธุการ\nสาธุชน\nสาบเสือ\nสาปสรร\nสาปแช่ง\nสาปส่ง\nสามง่าม\nสามล้อ\nสามเหลี่ยม\nสามเวท\nสามัญชน\nสามัญสำนึก\nสายดิ่ง\nสายดิน\nสายตรวจ\nสายน้ำ\nสายบัว\nสายพาน\nสายฟ้า\nสายยาง\nสายยู\nสายใย\nสายรก\nสายรุ้ง\nสายล่อฟ้า\nสายลับ\nสายเลือด\nสายโลหิต\nสายวัด\nสายส่ง\nสายสวาท\nสายสะดือ\nสายสะพาย\nสายสัมพันธ์\nสายสิญจน์\nสายสืบ\nสายไหม\nสายอากาศ\nสายตา\nสายหยุด\nสารตรา\nสารประกอบ\nสารละลาย\nสารส้ม\nสารหนู\nสารทฤดู\nสาวใช้\nสาวน้อย\nสาวใหญ่\nสำนักงาน\nสำนักพิมพ์\nสำนักสงฆ์\nสำมะโนครัว\nสำเร็จรูป\nสิกขาบท\nสิงสถิต\nสิงสู่\nสิ่งก่อสร้าง\nสิ่งของ\nสิ่งปฏิกูล\nสิ่งพิมพ์\nสิ่งแวดล้อม\nสิ่งศักดิ์สิทธิ์\nสิทธิกร\nสิทธิ์ขาด\nสิทธิชัย\nสิทธิโชค\nสิทธิบัตร\nสินค้า\nสินจ้าง\nสินเชื่อ\nสินไถ่\nสินทรัพย์\nสินน้ำใจ\nสินบน\nสินแร่\nสินสมรส\nสินสอด\nสินไหม\nสิ้นเชิง\nสิ้นสุด\nสีผึ้ง\nสีลม\nสีชอล์ก\nสีถ่าน\nสีเทียน\nสีน้ำ\nสีน้ำมัน\nสีโปสเตอร์\nสีฝุ่น\nสี่เหลี่ยม\nสีหน้า\nสึกหรอ\nสืบทอด\nสืบค้น\nสืบสวน\nสืบสาว\nสืบเสาะ\nสื่อผสม\nสื่อมวลชน\nสื่อสาร\nสุกงอม\nสุกดิบ\nสุกปลั่ง\nสุกใส\nสุขนาฏกรรม\nสุขภัณฑ์\nสุขภาพ\nสุขลักษณะ\nสุขวิทยา\nสุขศาลา\nสุขศึกษา\nสุดท้าย\nสุตกวี\nสุนทรพจน์\nสุภาพชน\nสู่ขอ\nสู่รู้\nสู่สม\nสูงส่ง\nสูญเปล่า\nสูญสิ้น\nสูญเสีย\nสูญหาย\nเสสรวล\nเสแสร้ง\nเสกสรร\nเสถียรภาพ\nเส้นชัย\nเส้นตรง\nเส้นตาย\nเส้นทาง\nเส้นใย\nเส้นรุ้ง\nเส้นเลือด\nเส้นแวง\nเส้นสาย\nเส้นเสียง\nเส้นหมี่\nเส้นเอ็น\nเสบียงกรัง\nเสมอภาค\nเสมอหน้า\nเสมอเหมือน\nเสมียนตรา\nเสร็จสรรพ\nเสร็จสิ้น\nเสริมส่ง\nเสริมสร้าง\nเสริมสวย\nเสรีไทย\nเสรีธรรม\nเสรีนิยม\nเสรีภาพ\nเสาเข็ม\nเสาธง\nเสียใจ\nเสียเชิง\nเสียดาย\nเสียที\nเสียเที่ยว\nเสียเปรียบ\nเสียเปล่า\nเสียรู้\nเสียแรง\nเสียสละ\nเสียหลัก\nเสียหาย\nเสี่ยงทาย\nเสียดแทง\nเสียดแทรก\nเสียดสี\nเสี้ยนศึก\nเสี้ยนหนาม\nเสี้ยมสอน\nเสียวซ่าน\nเสียวไส้\nเสือดาว\nเสือดำ\nเสือปลา\nเสือป่า\nเสือไฟ\nเสื่อกก\nเสื่อกระจูด\nเสื่อน้ำมัน\nเสื่อลำแพน\nเสื้อกล้าม\nเสื้อกั๊ก\nเสื้อเกราะ\nเสื้อครุย\nเสื้อแสง\nเสื้อเมือง\nเสือกคลาน\nเสือกสน\nเสือกไส\nเสื่อมคลาย\nเสื่อมถอย\nเสื่อมทราม\nเสื่อมโทรม\nเสื่อมสลาย\nเสื่อมสูญ\nเสื่อมเสีย\nเสือหมอบ\nแสกหน้า\nแสดงออก\nแสเถา\nแสนกล\nแสนรู้\nแสร้งว่า\nใส่ความ\nใส่ไคล้\nใส่ใจ\nใส่ไฟ\nไส้กรอก\nไส้ไก่\nไส้ติ่ง\nไส้ศึก\nไส้อั่ว\nไส้เดือน\nไส้ตัน\nไสยเวท\nไสยศาสตร์\nหกล้ม\nหงส์หยก\nหงอนไก่\nหงอยก๋อย\nหงอยเหงา\nหงายท้อง\nหงายหลัง\nหงำเหงอะ\nหงำเหงือก\nหดหาย\nหดหู่\nหนทาง\nหนวกหู\nหน่วงเหนี่ยว\nหน่วยก้าน\nหน่อไม้\nหนองใน\nหนองแซง\nหนักข้อ\nหนักใจ\nหนักแน่น\nหนักหน่วง\nหนักหนา\nหนังกลับ\nหนังตะลุง\nหนังเรียด\nหนังสด\nหนังใหญ่\nหนังสือพิมพ์\nหนาแน่น\nหน้ากระดาน\nหน้ากาก\nหน้ากาฬ\nหน้าแข้ง\nหน้าจั่ว\nหน้าฉาน\nหน้าตัก\nหน้าตา\nหน้าต่าง\nหน้าท้อง\nหน้าทับ\nหน้าที่\nหน้าที่นั่ง\nหน้าบัน\nหน้าปัด\nหน้าผา\nหน้าผาก\nหน้าม้า\nหน้ามุข\nหน้าไม้\nหน้าเลือด\nหน้าอก\nหนามเตย\nหน่ายหนี\nหน่ายแหนง\nหนาวเหน็บ\nหนำใจ\nหนี้สิน\nหนี้สูญ\nหนุนเนื่อง\nหนุนหลัง\nหมกมุ่น\nหมดจด\nหมอขวัญ\nหมอความ\nหมอแคน\nหมองู\nหมอดู\nหมอตำแย\nหมอทำขวัญ\nหมอนวด\nหมอผี\nหมอยา\nหมอลำ\nหมอเสน่ห์\nหม้อแกง\nหม้อตาล\nหม้อน้ำ\nหม้อแปลง\nหมองใจ\nหมองมัว\nหมองหม่น\nหมองหมาง\nหมอนขวาน\nหมอนข้าง\nหมอนทอง\nหม่อมเจ้า\nหม่อมฉัน\nหม่อมราชวงศ์\nหม่อมหลวง\nหม่อมห้าม\nหมั่นไส้\nหมาป่า\nหมาหมู่\nหมากฝรั่ง\nหมากสง\nหมากหอม\nหมากเก็บ\nหมากรุก\nหมากเม่า\nหมางใจ\nหมางเมิน\nหมาไม้\nหมายเกณฑ์\nหมายขัง\nหมายค้น\nหมายความ\nหมายจับ\nหมายใจ\nหมายตา\nหมายปล่อย\nหมายมั่น\nหมายเรียก\nหมายเลข\nหมายเหตุ\nหมิ่นเหม่\nหมึกจีน\nหมุนเวียน\nหมูแดง\nหมูป่า\nหมูแผ่น\nหมูยอ\nหมูหย็อง\nหมูหัน\nหมูแฮม\nหมู่บ้าน\nหยดย้อย\nหยอกเย้า\nหยักรั้ง\nหยักศก\nหยั่งทราบ\nหยั่งรู้\nหยั่งเสียง\nหยาบคาย\nหยาบช้า\nหยาบโลน\nหยาบหยาม\nหยิบมือ\nหยิบยก\nหยิบยืม\nหยิบหย่ง\nหยิบโหย่ง\nหริรักษ์\nหริวงศ์\nหลงผิด\nหลบฉาก\nหลบมุม\nหลวงจีน\nหลวงพ่อ\nหลวมตัว\nหล่อลื่น\nหล่อเลี้ยง\nหล่อหลอม\nหลอกลวง\nหลอกล่อ\nหลอกล้อ\nหลอดลม\nหลอดเลือด\nหลอดอาหาร\nหลอมตัว\nหลอมเหลว\nหลักการ\nหลักเกณฑ์\nหลักชัย\nหลักฐาน\nหลักทรัพย์\nหลักเมือง\nหลักลอย\nหลักสูตร\nหลักแหล่ง\nหลักแหลม\nหลังคา\nหลังเต่า\nหลั่งไหล\nหลับนก\nหลับใน\nหลากใจ\nหลากหลาย\nหลาบจำ\nหลายหลาก\nหลายแหล่\nหลุดพ้น\nหลุดลอย\nหลุดลุ่ย\nหลุมโจน\nหลุมพราง\nหวงก้าง\nหวงห้าม\nหวงแหน\nห่วงใย\nห้วงน้ำ\nหวังใจ\nหวังดี\nหวั่นกลัว\nหวั่นเกรง\nหวั่นใจ\nหวั่นวิตก\nหวั่นหวาด\nหวั่นไหว\nหวาดกลัว\nหวาดเกรง\nหวาดผวา\nหวาดเสียว\nหวาดหวั่น\nหวาดไหว\nหวานเย็น\nหว่านล้อม\nหอคอย\nหอคำ\nหอฉัน\nหอไตร\nหอประชุม\nหอพัก\nห่อหมก\nห่อเหี่ยว\nหอกซัด\nห้องเครื่อง\nห้องชุด\nห้องแถว\nห้องโถง\nห้องน้ำ\nห้องสมุด\nหอสมุด\nหอมหวน\nห้อมล้อม\nห้อยโหน\nหักล้าง\nหักหาญ\nหักห้าม\nหักเห\nหักโหม\nหักมุก\nหันเห\nหับเผย\nหัวขโมย\nหัวข้อ\nหัวขั้ว\nหัวเข่า\nหัวโขน\nหัวคะแนน\nหัวค่ำ\nหัวคิด\nหัวจุก\nหัวโจก\nหัวใจ\nหัวเทียน\nหัวนม\nหัวนอน\nหัวป่า\nหัวมุม\nหัวเรื่อง\nหัวแร้ง\nหัวใส\nหัวหน้า\nหัวหน่าว\nหัวหอก\nหัวเห็ด\nหัวไหล่\nหัวอก\nหัสดนตรี\nหัสนาฏกรรม\nหัสนิยาย\nหัสดีลิงค์\nหางเครื่อง\nหางแถว\nหางเลข\nหางว่าว\nหางเสียง\nหางเสือ\nห่างเหิน\nหาบเร่\nห้ามปราม\nห้ามล้อ\nหายตัว\nหาวนอน\nห้าวหาญ\nห้ำหั่น\nหินงอก\nหินทราย\nหินปูน\nหินย้อย\nหินอ่อน\nหินชาติ\nหินยาน\nหีบเพลง\nหีบห่อ\nหุ่นกระบอก\nหุ่นยนต์\nหุ้นลม\nหุ้นส่วน\nหุบเขา\nหุบผา\nหุบเหว\nหูกระต่าย\nหูช้าง\nหูรูด\nหูกวาง\nเหงาหงอย\nเหงื่อกาฬ\nเหตุการณ์\nเหตุผล\nเห็นแก่\nเห็นใจ\nเหน็บแนม\nเหน็บชา\nเหนียวแน่น\nเหนี่ยวนำ\nเหนี่ยวรั้ง\nเหนื่อยหน่าย\nเหมาะเจาะ\nเหมาะสม\nเหมาะเหม็ง\nเหยเก\nเหยียดหยาม\nเหล็กกล้า\nเหล็กจาร\nเหล็กใน\nเหล็กส่ง\nเหล็กเส้น\nเหล็กหล่อ\nเหล็กไหล\nเหลวแหลก\nเหลวไหล\nเหลอหลา\nเหล่ากอ\nเหลียวแล\nเหลือเกิน\nเหลือขอ\nเหลือใจ\nเหลือเชื่อ\nเหลือเฟือ\nเหลือร้าย\nเหลือล้น\nเหลือหลาย\nเหลือแหล่\nเหลือแสน\nเหลือหลอ\nเหลื่อมล้ำ\nเห่อเหิม\nเหินห่าง\nเหิมเกริม\nเหิมหาญ\nเหี้ยมเกรียม\nเหี้ยมหาญ\nเหี้ยมโหด\nเหี่ยวแห้ง\nเหือดหาย\nเหือดแห้ง\nแห่แหน\nแหนงหน่าย\nแหลกลาญ\nแหลกเหลว\nแหวกแนว\nแหวกว่าย\nโหงพราย\nโหดร้าย\nโหดเหี้ยม\nโหยหวน\nโหวงเหวง\nให้การ\nให้ท่า\nให้ท้าย\nให้ร้าย\nให้หลัง\nไหมพรม\nไหวพริบ\nอกไก่\nอกร่อง\nองค์กร\nองค์การ\nอดกลั้น\nอดทน\nอดสู\nอดอยาก\nอดออม\nอดีตกาล\nอดีตชาติ\nอดีตภพ\nอติชาตบุตร\nอธิการบดี\nอนาคตกาล\nอนิจกรรม\nอนุชาตบุตร\nอเนกประสงค์\nอบรม\nอบอวล\nอบอ้าว\nอบอุ่น\nอบายภูมิ\nอบายมุข\nอภัพบุคคล\nอภัยทาน\nอภัยโทษ\nอภิชาตบุตร\nอมยิ้ม\nอมรรัตน์\nอมฤตบท\nอมฤตรส\nอย่างไร\nอรรถกร\nอรรถกวี\nอรรถคดี\nอรรถประโยชน์\nอรรถรส\nอรรธนิศา\nอรรธภาค\nอรรธสระ\nอรสุมพล\nอรูปฌาน\nอรูปพรหม\nอรูปภพ\nอรูปภูมิ\nอวชาตบุตร\nอวดดี\nอวดอ้าง\nอ้วนท้วน\nอ้วนพี\nอวบอั๋น\nอวยชัย\nอวยพร\nอสุภกรรมฐาน\nอสุภสัญญา\nอโหสิกรรม\nออเจ้า\nออกแขก\nออกตัว\nออกโรง\nออกฤทธิ์\nออกลาย\nออกหาก\nออดอ้อน\nออดแอด\nอ่อนข้อ\nอ่อนใจ\nอ่อนช้อย\nอ่อนน้อม\nอ่อนเปลี้ย\nอ่อนเพลีย\nอ่อนโยน\nอ่อนหวาน\nอ่อนหัด\nอ่อนไหว\nอ่อนแอ\nอ้อนวอน\nอ้อนออด\nอ้อมค้อม\nอักษรศาสตร์\nอักษรสาส์น\nอัคคีภัย\nอัญชนะศักราช\nอัดฉีด\nอัดอั้น\nอัตราส่วน\nอันโตชน\nอันโตนาที\nอับจน\nอับเฉา\nอับอาย\nอัสสุชล\nอัสสุธารา\nอากัปกิริยา\nอาการนาม\nอากาศธาตุ\nอากาศยาน\nอาคารชุด\nอ่างเก็บน้ำ\nอ้างอิง\nอาจหาญ\nอาจอง\nอาชญากร\nอาชญากรรม\nอาชญาบัตร\nอาชญาสิทธิ์\nอาญาสิทธิ์\nอาณาเขต\nอาณาจักร\nอาณานิคม\nอาณาประโยชน์\nอาโปกสิณ\nอาโปธาตุ\nอาภากร\nอายุขัย\nอายุวัฒนะ\nอาโลกกสิณ\nอาหารว่าง\nอำพราง\nอิดโรย\nอิดออด\nอิดเอื้อน\nอิตถีลิงค์\nอิทธิปาฏิหาริย์\nอิทธิพล\nอิทธิฤทธิ์\nอินังขังขอบ\nอิ่มตัว\nอิ่มหนำ\nอิ่มเอม\nอิ่มเอิบ\nอีฉัน\nอีตัว\nอึงคะนึง\nอึงมี่\nอึงอล\nอึ่งยาง\nอึ่งอ่าง\nอึดใจ\nอึดอัด\nอืดอาด\nอื้อฉาว\nอื้อซ่า\nอื้ออึง\nอุกฉกรรจ์\nอุกอาจ\nอุดอู้\nอุ่นเครื่อง\nอุ่นใจ\nอุบอิบ\nอุบัติภัย\nอุบัติเหตุ\nอุโบสถกรรม\nอุโบสถหัตถี\nอุปมาโวหาร\nอุ้มชู\nอุ้มสม\nอุ้ยอ้าย\nอู้อี้\nเอกจิต\nเอกฉันท์\nเอกชน\nเอกเทศ\nเอกนัย\nเอกบุคคล\nเอกบุรุษ\nเอกพจน์\nเอกภพ\nเอกภาพ\nเอกมัย\nเอกราช\nเอกรูป\nเอกลักษณ์\nเอกศก\nเอกสาร\nเอกสิทธิ์\nเอกอุ\nเอ็ดอึง\nเอนเอียง\nเอมอร\nเอออวย\nเออออ\nเอาการ\nเอางาน\nเอาจริง\nเอาใจ\nเอาเปรียบ\nเอาเยี่ยง\nเอิบอาบ\nเอียงอาย\nเอียงเอน\nเอื้อเฟื้อ\nโอ่โถง\nโอ้โถง\nโอ่อวด\nโอ้อวด\nโอ่อ่า\nโอ้โลม\nโอดครวญ\nโอดโอย\nโอนอ่อน\nโอนเอน\nโอบอ้อม\nโอบอุ้ม\nโอสถกรรม\nไอเสีย\nไอกรน\nฮวบฮาบ\nฮาป่า\nฮึกหาญ\nฮึกห้าว\nฮึกเหิม\nฮึกโหม\nฮึกฮัก\nเฮงซวย\nโฮกฮือ\nโฮกฮาก\n\nก็\nกก\nก๊ก\nกกุธภัณฑ์\nกง\nก่ง\nก้ง\nก๊ง\nก๋ง\nกงกอน\nกงไฉ่\nกงเต๊ก\nกงสี\nกงสุล\nกช\nกฎ\nกฏุก\nกฐิน\nกณิกนันต์\nกณิการ์\nกด\nกตเวทิตา\nกตเวที\nกตัญชลี\nกตัญญุตา\nกตัญญู\nกตาธิการ\nกตาภินิหาร\nกติกา\nกถา\nกถิกาจารย์\nกทลี\nกน\nก่น\nก้น\nกนก\nกนิษฐ์\nกนิษฐา\nกบ\nกบฏ\nกบดาน\nกบทู\nกบาล\nกบินทร์\nกบิล\nกบี่\nกบูร\nกเบนทร์\nกม\nก้ม\nกมณฑลาภิเษก\nกมณฑโลทก\nกมล\nกมลา\nกมลาศ\nกมลาสน์\nกมเลศ\nกมัณฑลุ\nกมุท\nกร\nกรกฎ\nกรกฎาคม\nกรกฏ\nกรง\nกรชกาย\nกรณฑ์\nกรณิการ์\nกรณี\nกรณีย์\nกรณียกิจ\nกรณียะ\nกรด\nกรน\nกรบ\nกรบูร\nกรพินธุ์\nกรม\nกรรกฎ\nกรรกศ\nกรรเกด\nกรรไกร\nกรรเจียก\nกรรชิง\nกรรเชียง\nกรรโชก\nกรรฐ์\nกรรฐา\nกรรณ\nกรรณา\nกรรณิกา\nกรรณิการ์\nกรรดิ\nกรรดิก\nกรรดึก\nกรรตุ\nกรรไตร\nกรรทบ\nกรรแทก\nกรรบิด\nกรรบูร\nกรรภิรมย์\nกรรม\nกรรม์\nกรรม์ภิรมย์\nกรรมชวาต\nกรรมัชวาต\nกรรมาชีพ\nกรรมาธิการ\nกรรมาร\nกรรษก\nกรรสะ\nกรรแสง\nกรวด\nกรวบ\nกรวม\nกร้วม\nกรวย\nกรวิก\nกรสาปน์\nกรสุทธิ์\nกรอ\nกร้อ\nกรอก\nกร็อกกร๋อย\nกรอกแกรก\nกรอง\nกรองกรอย\nกรอด\nกร่อน\nกรอบ\nกรอม\nกร่อย\nกระ\nกระกร\nกระกรุ่น\nกระกลับกลอก\nกระกี้\nกระเกรอก\nกระเกริก\nกระเกริ่น\nกระคน\nกระคาย\nกระงกกระเงิ่น\nกระง่องกระแง่ง\nกระง่อนกระแง่น\nกระเง้ากระงอด\nกระโงก\nกระจก\nกระจง\nกระจร\nกระจอก\nกระจองหง่อง\nกระจ๋องหง่อง\nกระจองอแง\nกระจ้อน\nกระจอนหู\nกระจ้อย\nกระจ๋อหวอ\nกระจะ\nกระจัก\nกระจัง\nกระจัด\nกระจับ\nกระจ่า\nกระจ่าง\nกระจาด\nกระจาน\nกระจาบ\nกระจาม\nกระจาย\nกระจาว\nกระจิก\nกระจิ๋ง\nกระจิด\nกระจิบ\nกระจิ๋ม\nกระจิริด\nกระจิ๋ว\nกระจี้\nกระจี๋\nกระจุก\nกระจุ๋งกระจิ๋ง\nกระจุบ\nกระจุ๊บ\nกระจุ๋มกระจิ๋ม\nกระจุย\nกระจู้\nกระจู๋กระจี๋\nกระจูด\nกระเจอะกระเจิง\nกระเจา\nกระเจ่า\nกระเจ้า\nกระเจาะ\nกระเจิง\nกระเจิดกระเจิง\nกระเจี้ยง\nกระเจี๊ยบ\nกระเจียว\nกระเจี๊ยว\nกระแจะ\nกระโจน\nกระโจม\nกระฉอก\nกระฉ่อน\nกระฉับกระเฉง\nกระฉิ่ง\nกระฉีก\nกระฉูด\nกระเฉก\nกระเฉด\nกระแฉก\nกระโฉกกระเฉก\nกระโฉม\nกระชดกระช้อย\nกระชอน\nกระชอมดอก\nกระช้อย\nกระชัง\nกระชั้น\nกระชับ\nกระชาก\nกระชาย\nกระชิง\nกระชิด\nกระชุ\nกระชุก\nกระชุ่มกระชวย\nกระเชอ\nกระเชา\nกระเช้า\nกระเชียง\nกระแชง\nกระแชะ\nกระโชก\nกระซ่องกระแซ่ง\nกระซับ\nกระซาบ\nกระซิก\nกระซิบ\nกระซี้\nกระซุง\nกระซุบกระซิบ\nกระซุ้ม\nกระซู่\nกระเซ็น\nกระเซอ\nกระเซอะกระเซอ\nกระเซอะกระเซิง\nกระเซ้า\nกระเซิง\nกระแซ\nกระแซะ\nกระโซกระเซ\nกระฎี\nกระฎุมพี\nกระดก\nกระด้ง\nกระดนโด่\nกระดวง\nกระดวน\nกระด้วมกระเดี้ยม\nกระดอ\nกระดอง\nกระดองหาย\nกระดอน\nกระดอม\nกระดักกระเดี้ย\nกระดังงัว\nกระดังงา\nกระดาก\nกระด้าง\nกระดางลาง\nกระดาด\nกระดาดขาว\nกระดาน\nกระดานพน\nกระดาษ\nกระดำกระด่าง\nกระดิก\nกระดิ่ง\nกระดิ้ง\nกระดิบ\nกระดี่\nกระดี้กระเดียม\nกระดึง\nกระดืบ\nกระดุ\nกระดุกกระดิก\nกระดุ้งกระดิ้ง\nกระดุบ\nกระดุบกระดิบ\nกระดุม\nกระดูก\nกระเดก\nกระเด้ง\nกระเด็น\nกระเด้า\nกระเดาะ\nกระเดิด\nกระเดี้ย\nกระเดียด\nกระเดือก\nกระเดื่อง\nกระแด็ก\nกระแด้ง\nกระแด้แร่\nกระแด่ว\nกระแดะ\nกระโดก\nกระโดง\nกระโดด\nกระโดน\nกระได\nกระตรับ\nกระตราก\nกระตรุด\nกระตรุม\nกระต้วมกระเตี้ยม\nกระต้อ\nกระต่องกระแต่ง\nกระต๊อบ\nกระต้อยตีวิด\nกระตัก\nกระตั้ว\nกระต่าย\nกระติก\nกระติ๊ด\nกระติบ\nกระตือรือร้น\nกระตุก\nกระตุ้งกระติ้ง\nกระตุ่น\nกระตุ้น\nกระตูบ\nกระเตง\nกระเต็น\nกระเตอะ\nกระเตาะ\nกระเตาะกระแตะ\nกระเตื้อง\nกระแต\nกระแตแต้แว้ด\nกระโตกกระตาก\nกระโตน\nกระถด\nกระถอบ\nกระถั่ว\nกระถาง\nกระถิก\nกระถิน\nกระเถิบ\nกระโถน\nกระทก\nกระทง\nกระทบ\nกระทรวง\nกระทอก\nกระท้อน\nกระท่อนกระแท่น\nกระท่อม\nกระท้อมกระแท้ม\nกระทะ\nกระทั่ง\nกระทั้น\nกระทา\nกระทาย\nกระทาสี\nกระทาหอง\nกระทำ\nกระทิกกระทวย\nกระทิง\nกระทึง\nกระทืบ\nกระทุ\nกระทุง\nกระทุ้ง\nกระทุ่ม\nกระทู้\nกระเท่\nกระเทียบ\nกระเทียม\nกระเทือน\nกระเทื้อม\nกระแทก\nกระแท่น\nกระแทะ\nกระไทชาย\nกระน่อง\nกระนั้น\nกระนี้\nกระแนะกระแหน\nกระโน้น\nกระไน\nกระบก\nกระบม\nกระบวน\nกระบวย\nกระบวร\nกระบอก\nกระบอง\nกระบะ\nกระบัด\nกระบั้วกระเบี้ย\nกระบ่า\nกระบ้า\nกระบาก\nกระบาย\nกระบาล\nกระบิ\nกระบิ้ง\nกระบิด\nกระบิล\nกระบี่\nกระบือ\nกระบุง\nกระบุ่มกระบ่าม\nกระบู้กระบี้\nกระบูน\nกระบูร\nกระเบง\nกระเบญ\nกระเบ็ดกระบวน\nกระเบน\nกระเบา\nกระเบิก\nกระเบียด\nกระเบียน\nกระเบื้อง\nกระแบก\nกระแบะ\nกระโบม\nกระปมกระปำ\nกระปมกระเปา\nกระปรอก\nกระปรอกว่าว\nกระปรี้กระเปร่า\nกระปอก\nกระป้อกระแป้\nกระป่อง\nกระป๋อง\nกระปอดกระแปด\nกระป๋อหลอ\nกระปั้วกระเปี้ย\nกระป่ำ\nกระปุก\nกระปุ๊กลุก\nกระปุ่ม\nกระปุ่มกระป่ำ\nกระปุ่มกระปิ่ม\nกระเป๋า\nกระเปาะ\nกระโปก\nกระโปรง\nกระผม\nกระผลีกระผลาม\nกระผาน\nกระผีก\nกระพรวน\nกระพริ้ม\nกระพอก\nกระพอง\nกระพ้อม\nกระพัก\nกระพัง\nกระพังเหิร\nกระพังโหม\nกระพัด\nกระพัตร\nกระพัน\nกระพั่น\nกระพา\nกระพาก\nกระพี้\nกระพือ\nกระพุ้ง\nกระพุ่ม\nกระเพาะ\nกระเพิง\nกระเพื่อม\nกระแพ้ง\nกระฟัดกระเฟียด\nกระฟูมกระฟาย\nกระมล\nกระมอบ\nกระมอมกระแมม\nกระมัง\nกระมัน\nกระมิดกระเมี้ยน\nกระมุท\nกระเมาะ\nกระย่อง\nกระย่องกระแย่ง\nกระย่อน\nกระย่อม\nกระยา\nกระยาง\nกระยาจก\nกระยาหงัน\nกระยิก\nกระยิ้มกระย่อง\nกระยึกกระยือ\nกระยืดกระยาด\nกระเย้อกระแหย่ง\nกระรอก\nกระเรียน\nกระโรกน้ำข้าว\nกระโรกใหญ่\nกระไร\nกระลด\nกระลบ\nกระลอก\nกระลอม\nกระละหล่ำ\nกระลัด\nกระลับ\nกระลัมพร\nกระลา\nกระลำ\nกระลำพัก\nกระลำพุก\nกระลิง\nกระลี\nกระลุมพาง\nกระลุมพุก\nกระลุมพู\nกระลูน\nกระลู่น์\nกระเล็น\nกระเลียด\nกระเลือก\nกระโลง\nกระวน\nกระวัด\nกระวาด\nกระวาน\nกระวาย\nกระวิน\nกระวี\nกระวีกระวาด\nกระวูดกระวาด\nกระเวน\nกระเวยกระวาย\nกระแวน\nกระโวยกระวาย\nกระษัย\nกระษาปณ์\nกระสง\nกระสบ\nกระสม\nกระสรวล\nกระสร้อย\nกระสวน\nกระสวย\nกระสอบ\nกระสะ\nกระสัง\nกระสัน\nกระสับกระส่าย\nกระสา\nกระสานติ์\nกระสาบ\nกระสาย\nกระสือ\nกระสุงกระสิง\nกระสุน\nกระสูทธิ์\nกระสูบ\nกระเสด\nกระเส็นกระสาย\nกระเส่า\nกระเสาะกระแสะ\nกระเสียน\nกระเสียร\nกระเสือกกระสน\nกระแส\nกระแสง\nกระแสะ\nกระโสง\nกระไส\nกระหนก\nกระหนาก\nกระหนาบ\nกระหน่ำ\nกระหมวด\nกระหมอบ\nกระหม่อม\nกระหมั่ง\nกระหมิบ\nกระหมุดกระหมิด\nกระหมุบ\nกระหย่ง\nกระหย่อม\nกระหยัง\nกระหยับ\nกระหยิ่ม\nกระหรอด\nกระหริ่ง\nกระหวน\nกระหวัด\nกระหอง\nกระหัง\nกระหัด\nกระหาง\nกระหาย\nกระหึม\nกระหึ่ม\nกระหืดกระหอบ\nกระเห็น\nกระเหนียด\nกระเหม็ดกระเหมียด\nกระเหม็ดกระแหม่\nกระเหม่น\nกระเหม่า\nกระเหว่า\nกระเห่อ\nกระเหิม\nกระเหี้ยนกระหือรือ\nกระแห\nกระแหทอง\nกระแหนบ\nกระแหนะ\nกระแหมบ\nกระแหม่ว\nกระแหย่ง\nกระแหร่ม\nกระแหล่ง\nกระโห้\nกระโหนด\nกระโหม\nกระโหย\nกระโหย่ง\nกระอวล\nกระอ้อกระแอ้\nกระออดกระแอด\nกระออบ\nกระออม\nกระอ้อมกระแอ้ม\nกระอัก\nกระอักกระอ่วน\nกระอั้วแทงควาย\nกระอ้า\nกระอาน\nกระอิด\nกระอิดกระเอื้อน\nกระอึก\nกระอืด\nกระอุ\nกระอุก\nกระเอา\nกระเอิก\nกระเอิบ\nกระแอก\nกระแอบ\nกระแอม\nกระไอ\nกรัก\nกรักขี\nกรัง\nกรัชกาย\nกรัณฑ์\nกรัณย์\nกรัน\nกรับ\nกรัม\nกราก\nกราง\nกร่าง\nกราด\nกราดวง\nกราน\nกร้าน\nกราบ\nกราฟ\nกราม\nกราย\nกร่าย\nกราว\nกร้าว\nกรำ\nกร่ำ\nกริก\nกริ๊ก\nกริกกริว\nกริกกรี\nกริ่ง\nกริ๊ง\nกริงกริว\nกริ้งกริ้ว\nกริช\nกริณี\nกริน\nกรินทร์\nกรินี\nกริบ\nกริม\nกริ่ม\nกริยา\nกริยานุเคราะห์\nกริว\nกริ้ว\nกรี\nกรีฑา\nกรีด\nกรี๊ด\nกรีธา\nกรีษ\nกรีส\nกรึ๊บ\nกรุ\nกรุง\nกรุ้งกริ่ง\nกรุณ\nกรุณา\nกรุณาธิคุณ\nกรุ่น\nกรุบ\nกรุ่ม\nกรุ้มกริ่ม\nกรุย\nกรุยเกรียว\nกรู\nกรูด\nกรูม\nกเรณุ\nกเรนทร\nกเรนทร์\nกฤช\nกฤดาภินิหาร\nกฤตติกา\nกฤษฎา\nกฤษฎาธาร\nกฤษฎาภินิหาร\nกฤษฎีกา\nกฤษณา\nกล\nกลด\nกล่น\nกลบ\nกลม\nกลละ\nกลวง\nกล้วย\nกลศ\nกล้อ\nกลอก\nกลอง\nกล่อง\nกล้อง\nกล้องแกล้ง\nกลอน\nกล่อน\nกล้อน\nกล่อม\nกล้อมแกล้ม\nกลอย\nกลัก\nกลัด\nกลั่น\nกลั้น\nกลันทก์\nกลันทะ\nกลับ\nกลัมพร\nกลัมพัก\nกลัว\nกลั้ว\nกลา\nกล้า\nกลาก\nกลากลาด\nกลาง\nกลาด\nกลาบาต\nกลาป\nกล้าม\nกลาย\nกล้าย\nกลายกลอก\nกล่าว\nกลาโหม\nกล่ำ\nกล้ำ\nกลิ้ง\nกลิงค์\nกลิ่น\nกลี\nกลีบ\nกลึง\nกลึงค์\nกลืน\nกลุ่ม\nกลุ้ม\nกลูโคส\nกเลวระ\nกวด\nกวน\nกวม\nกวย\nกวยจั๊บ\nกวยจี๊\nก๋วยเตี๋ยว\nกวัก\nกวัด\nกวา\nกว่า\nกวาง\nกว่าง\nกว้าง\nกว่างโซ้ง\nกวางตุ้ง\nกวาด\nกว้าน\nกว๊าน\nกว้าว\nกวาวเครือ\nกวี\nกษณะ\nกษมา\nกษัตร\nกษัตรา\nกษัตริย์\nกษัตรี\nกษัตรีย์\nกษัย\nกษาปณ์\nกษิดิ\nกษีร\nกษีรธารา\nกษีระ\nกสานติ์\nกสิกร\nกสิกรรม\nกสิณ\nกหังปายา\nกหาปณะ\nกเฬวราก\nกอ\nก่อ\nก้อ\nก๊อ\nกอก\nก๊อก\nกอแก\nกอง\nก่อง\nก้อง\nกองกอย\nก๊อซ\nกอด\nก่อน\nก้อน\nกอบ\nกอบนาง\nก๊อบปี้\nกอปร\nก้อม\nกอมก้อ\nก่อมก้อ\nกอย\nก้อย\nก๋อย\nกอริลลา\nกอล์ฟ\nกอและ\nกอเอี๊ยะ\nกะ\nกะกัง\nกะง้องกะแง้ง\nกะจัง\nกะแจะ\nกะชะ\nกะชัง\nกะชามาศ\nกะชิง\nกะชึ่กกะชั่ก\nกะแช่\nกะซวก\nกะซ้าหอย\nกะซี่\nกะโซ่\nกะโซ้\nกะดก\nกะดง\nกะดวน\nกะดอก\nกะดะ\nกะดังบาย\nกะดัด\nกะด้าง\nกะดำกะด่าง\nกะดี\nกะดี่\nกะดุ้ง\nกะเด้\nกะเดก\nกะเดี๋ยว\nกะตรุด\nกะตอก\nกะต่อย\nกะตัก\nกะตั้ก\nกะตัง\nกะตังกะติ้ว\nกะต๊าก\nกะต้ำ\nกะติ๊กริก\nกะติงกะแตง\nกะตีบ\nกะตึงกะแตง\nกะตุ๊ก\nกะตุด\nกะตูก\nกะเตง\nกะโต๊ก\nกะโตงกะเตง\nกะโต้งโห่ง\nกะถัว\nกะทกรก\nกะทอ\nกะทัง\nกะทังหัน\nกะทัดรัด\nกะทันหัน\nกะทับ\nกะทิ\nกะทือ\nกะทุน\nกะเทย\nกะเทาะ\nกะแท้\nกะแท่ง\nกะแทน\nกะนวล\nกะนัด\nกะบ่อนกะแบ่น\nกะบัง\nกะบั้ง\nกะบิ้ง\nกะบิล\nกะบึงกะบอน\nกะบุด\nกะเบ้อ\nกะเบียน\nกะเบือ\nกะปริดกะปรอย\nกะปริบ\nกะปริบกะปรอย\nกะปลกกะเปลี้ย\nกะปวกกะเปียก\nกะปอม\nกะปอมขาง\nกะปะ\nกะป้ำกะเป๋อ\nกะปิ\nกะปู\nกะปูด\nกะปูดหลูด\nกะเปะ\nกะเปิ๊บกะป๊าบ\nกะเปียด\nกะแป้น\nกะแปะ\nกะโปรง\nกะโปโล\nกะผลุบกะโผล่\nกะเผ่น\nกะเผลก\nกะโผลกกะเผลก\nกะพง\nกะพรวดกะพราด\nกะพร่องกะแพร่ง\nกะพริบ\nกะพรุน\nกะพรูดกะพราด\nกะพล้อ\nกะพ้อ\nกะเพรา\nกะเพียด\nกะเม็ง\nกะร่องกะแร่ง\nกะระตะ\nกะระหนะ\nกะรัง\nกะรัต\nกะราง\nกะริง\nกะรุงกะรัง\nกะรุ่งกะริ่ง\nกะรุน\nกะเร\nกะเรกะร่อน\nกะเร่กะร่อน\nกะเร่อ\nกะเรี่ยกะราด\nกะโรกะเร\nกะลวย\nกะลอ\nกะล่อกะแล่\nกะลอจี๊\nกะล่อน\nกะล่อมกะแล่ม\nกะล่อยกะหลิบ\nกะละปังหา\nกะละมัง\nกะละแม\nกะละออม\nกะลังตังไก่\nกะลัน\nกะลันทา\nกะลา\nกะลาง\nกะลาสี\nกะลำพอ\nกะลิง\nกะลิงปลิง\nกะลิ้มกะเหลี่ย\nกะลิอ่อง\nกะลุมพี\nกะเล็ง\nกะเล่อกะล่า\nกะเลิด\nกะเลียว\nกะแล\nกะโล่\nกะโลง\nกะวอกกะแวก\nกะวะ\nกะส้มชื่น\nกะสัง\nกะส้าหอย\nกะหนอกะแหน\nกะหน็องกะแหน็ง\nกะหนะ\nกะหนุงกะหนิง\nกะหร่อง\nกะหรอด\nกะหร็อมกะแหร็ม\nกะหราน\nกะหรี่\nกะหรี่ปั๊บ\nกะหลาป๋า\nกะหล่ำ\nกะหลี่\nกะหลีกะหลอ\nกะหลุกกะหลิก\nกะหำ\nกะหำแพะ\nกะหือ\nกะหูด\nกะเหรี่ยง\nกะเหลาะเปาะ\nกะแหยก\nกะแหะ\nกะโหลก\nกะโหล้ง\nกะไหล่\nกะอวม\nกะออม\nกะอาน\nกะอาม\nกะอูบ\nกัก\nกั๊ก\nกักกรา\nกักการุ\nกักขฬะ\nกัง\nกั้ง\nกังก้า\nกังเกียง\nกังขา\nกังฉิน\nกังฟู\nกังวล\nกังวาน\nกังสดาล\nกังไส\nกังหัน\nกัจฉปะ\nกัจฉะ\nกัจฉา\nกัญ\nกัญจุก\nกัญจุการา\nกัญชา\nกัญญา\nกัฐ\nกัณฏกะ\nกัณฐกะ\nกัณฐชะ\nกัณฐัศ\nกัณฐัศว์\nกัณฐา\nกัณฐี\nกัณฑ์\nกัณณ์\nกัณหา\nกัด\nกัตติกมาส\nกัตติกา\nกัตติเกยา\nกัตรา\nกัทลี\nกัน\nกั่น\nกั้น\nกันเกรา\nกันไกร\nกันชิง\nกันเชอ\nกันดาร\nกันดาล\nกันได\nกันต์\nกันตัง\nกันไตร\nกันทร\nกันทรากร\nกันภิรมย์\nกันเมียง\nกันย์\nกันยา\nกันยายน\nกันลง\nกันลอง\nกันแสง\nกั้นหยั่น\nกับ\nกับแก้\nกัป\nกัปตัน\nกัปปาสิก\nกัปปิยภัณฑ์\nกัปปิยะ\nกัมปนาท\nกัมประโด\nกัมปี\nกัมพล\nกัมพุช\nกัมพู\nกัมพูชา\nกัมโพช\nกัมมัชวาต\nกัมมัฏฐาน\nกัมมันตภาพรังสี\nกัมมันตรังสี\nกัมมาร\nกัมลาศ\nกัยวิกัย\nกัลชาญ\nกัลบก\nกัลป์\nกัลปนา\nกัลปพฤกษ์\nกัลปังหา\nกัลปาวสาน\nกัลปิต\nกัลเม็ด\nกัลยา\nกัลยาณมิตร\nกัลยาณี\nกัลออม\nกัศยป\nกัษณ\nกา\nก๋า\nกาก\nกากบาท\nกากะทิง\nกากะเยีย\nกากี\nกาง\nก้าง\nกางเกง\nกางเขน\nก๊าซ\nกาซะลอง\nกาญจนา\nกาฐ\nกาด\nก๊าด\nกาน\nก่าน\nก้าน\nก๊าน\nกานดา\nกานต์\nกานน\nก้านพร้าว\nกานพลู\nกาน้า\nกาบ\nก้าบ\nกาบู\nกาพย์\nกาเฟอีน\nกาแฟ\nกาม\nก้าม\nกามารมณ์\nกามินี\nกาเมสุมิจฉาจาร\nกาย\nก่าย\nกาเยน\nการ\nการณ์\nการ์ด\nการ์ตูน\nการบูร\nการย์\nการวิก\nการเวก\nการะเกด\nการะบุหนิง\nการัณย์\nการันต์\nการางหัวขวาน\nการิตการก\nการิตวาจก\nการุญ\nการุณย์\nกาเรการ่อน\nกาล\nกาลกรรณี\nกาลกิณี\nกาลจักร\nกาลัญญุตา\nกาลัญญู\nกาลัด\nกาลานุกาล\nกาลิก\nกาลี\nกาแล\nกาแล็กซี\nกาแล็กโทส\nกาว\nก้าว\nกาววาว\nกาวาง\nกาแวน\nกาศิก\nกาษฐะ\nกาษา\nกาสร\nกาสะ\nกาสา\nกาสาร\nกาสาวะ\nกาสิโน\nกาหล\nกาหลง\nกาหลา\nกาเหว่า\nกาไหล่\nกาฬ\nกาฬาวก\nกาฮัง\nกำ\nก่ำ\nกำกวม\nกำกัด\nกำกับ\nก้ำกึ่ง\nกำกูน\nก้ำเกิน\nกำเกียง\nกำคูน\nกำจร\nกำจัด\nกำจาย\nกำชับ\nกำชำ\nกำซาบ\nกำซำ\nกำด้น\nกำดัด\nกำดาล\nกำเดา\nกำธร\nกำนล\nกำนัน\nกำนัล\nกำเนิด\nกำบัง\nก่ำบึ้ง\nกำเบ้อ\nกำปอ\nกำปั่น\nกำผลา\nกำพง\nกำพด\nกำพต\nกำพร้า\nกำพราก\nกำพวด\nกำพอง\nกำพืด\nกำพุด\nกำพู\nกำเพลิง\nกำแพง\nกำภู\nกำมลาศน์\nกำมเลศ\nกำมะถัน\nกำมะลอ\nกำมะหยี่\nกำมะหริด\nกำมังละการ\nกำมังวิลิต\nกำมัชพล\nกำยาน\nกำยำ\nกำรอ\nกำราบ\nกำราล\nกำเริบ\nกำไร\nกำลัง\nกำลุง\nกำเลา\nกำไล\nกำสรด\nกำสรวล\nกำหนด\nกำหนัด\nกำเหน็จ\nกำแหง\nกิก\nกิ๊ก\nกิ่ง\nกิ้งก่า\nกิ้งกือ\nกิ้งโครง\nกิจ\nกิจจะ\nกิจจา\nกิดาการ\nกิดาหยัน\nกิตติ\nกิตติมศักดิ์\nกิน\nกินนร\nกินปลี\nกินเปี้ยว\nกินริน\nกินรี\nกิ๊บ\nกิมตึ๋ง\nกิมิชาติ\nกิมิวิทยา\nกิโมโน\nกิโยตีน\nกิระ\nกิริณี\nกิรินท\nกิริเนศวร\nกิริยา\nกิเลน\nกิเลส\nกิโล\nกิโลมกะ\nกิ่ว\nกิ๋ว\nกี\nกี่\nกี้\nกี๊\nกี๋\nกีฏวิทยา\nกีด\nกีตาร์\nกีบ\nกีรติ\nกีฬา\nกึก\nกึง\nกึ่ง\nกึ๋น\nกุ\nกุก\nกุ๊ก\nกุกกุฏ\nกุกกุร\nกุกรรม\nกุ้ง\nกุงอน\nกุงาน\nกุโงก\nกุจี\nกุญแจ\nกุญชร\nกุฎ\nกุฎา\nกุฎี\nกุฎุมพี\nกุฏฐัง\nกุฏิ\nกุณฑ์\nกุณฑล\nกุณฑี\nกุณโฑ\nกุณาล\nกุณี\nกุด\nกุดัง\nกุดั่น\nกุดา\nกุทัณฑ์\nกุน\nกุ๊น\nกุนเชียง\nกุนที\nกุโนกามอ\nกุบ\nกุบกับ\nกุม\nกุ่ม\nกุมฝอย\nกุมภ์\nกุมภนิยา\nกุมภัณฑ์\nกุมภา\nกุมภิล\nกุมภีล์\nกุมเหง\nกุมาร\nกุมารา\nกุมารี\nกุมุท\nกุย\nกุ๊ย\nกุ๋ย\nกุยช่าย\nกุยเฮง\nกุรระ\nกุรุพินท์\nกุเรา\nกุล\nกุลา\nกุลาหล\nกุลี\nกุลีกุจอ\nกุเลา\nกุแล\nกุเวร\nกุศราช\nกุศล\nกุศโลบาย\nกุสุม\nกุสุมภ์\nกุสุมา\nกุสุมาลย์\nกุสุมิตลดาเวลลิตา\nกุหนี\nกุหนุง\nกุหร่า\nกุหล่า\nกุหลาบ\nกุแหละ\nกู\nกู่\nกู้\nกู๊ก\nกูฏ\nกูฏา\nกูณฑ์\nกูด\nกูบ\nกูปรี\nกูรมะ\nกูรมาวตาร\nเก\nเก้\nเก๊\nเก๋\nเกก\nเก๊ก\nเกกมะเหรก\nเก๊กฮวย\nเก้กัง\nเก็ง\nเก่ง\nเก้ง\nเก๋ง\nเกงกอย\nเก่งกาจ\nเกงเขง\nเก๋งเคง\nเก็จ\nเกจิอาจารย์\nเกชา\nเกณฑ์\nเกด\nเก็ด\nเกตุ\nเกน\nเก็บ\nเกม\nเกย\nเกยูร\nเกรง\nเกร็ง\nเกร็ด\nเกรน\nเกร่อ\nเกรอะ\nเกราะ\nเกริก\nเกริน\nเกริ่น\nเกรียก\nเกรียง\nเกรียด\nเกรียน\nเกรียบ\nเกรียม\nเกรียว\nเกรี้ยว\nเกเร\nเกล็ด\nเกลศ\nเกลอ\nเกลา\nเกล้า\nเกลาะ\nเกลี่ย\nเกลี้ย\nเกลียง\nเกลี้ยง\nเกลียด\nเกลียว\nเกลือ\nเกลื้อ\nเกลือก\nเกลื่อน\nเกลื้อน\nเกวัฏ\nเกวียน\nเกศ\nเกศว\nเกศวะ\nเกศา\nเกศินี\nเกศี\nเกษตร\nเกษม\nเกษียณ\nเกษียน\nเกษียร\nเกส\nเกสร\nเกสรี\nเกสา\nเกสี\nเก้อ\nเกอิชา\nเกะ\nเกะกะ\nเกา\nเก่า\nเก้า\nเก๋า\nเกาต์\nเกาทัณฑ์\nเกาบิล\nเกาลัด\nเกาลิน\nเกาไศย\nเกาหลี\nเกาเหลา\nเกาเหลียง\nเก้าอี้\nเกาะ\nเกิ้ง\nเกิด\nเกิน\nเกิบ\nเกีย\nเกียกกาย\nเกียง\nเกี่ยง\nเกี๋ยง\nเกียจ\nเกียด\nเกียน\nเกี้ยมไฉ่\nเกี้ยมอี๋\nเกียร์\nเกียรติ\nเกียรติ์\nเกี่ยว\nเกี้ยว\nเกี๊ยว\nเกี๊ยะ\nเกื้อ\nเกือก\nเกื้อกูล\nเกือบ\nแก\nแก่\nแก้\nแกง\nแก่ง\nแก้ง\nแก๊ง\nแกงได\nแกงแนง\nแกโดลิเนียม\nแกน\nแก่น\nแก๊ป\nแกม\nแก้ม\nแกมมา\nแกรก\nแกร่ง\nแกร็น\nแกรนิต\nแกรไฟต์\nแกร่ว\nแกระ\nแกล\nแกล้ง\nแกลน\nแกลบ\nแกล้ม\nแกลลอน\nแกลเลียม\nแกล้ว\nแกละ\nแกแล\nแกว\nแก้ว\nแกว่ง\nแก๊ส\nแกะ\nโก\nโก่\nโก้\nโก๋\nโกก\nโกกนุท\nโกกิลา\nโกโก้\nโกง\nโก่ง\nโกงกาง\nโก้งเก้ง\nโกงโก้\nโก้งโค้ง\nโกเชาว์\nโกญจนาท\nโกญจา\nโกฏิ\nโกฐ\nโกฐาส\nโกณะ\nโกดัง\nโกทัณฑ์\nโกน\nโก่น\nโก๋น\nโกมล\nโกมุท\nโกเมน\nโกเมศ\nโกย\nโกรก\nโกรกกราก\nโกรง\nโกร่ง\nโกร่งกร่าง\nโกรงเกรง\nโกร๋งเกร๋ง\nโกรญจ\nโกรต๋น\nโกรธ\nโกรธา\nโกร๋น\nโกรม\nโกรย\nโกรศ\nโกโรโกเต\nโกโรโกโรก\nโกโรโกโส\nโกลน\nโกลาหล\nโกไล\nโกวิท\nโกศ\nโกศล\nโกษม\nโกสน\nโกสัช\nโกสินทร์\nโกสีย์\nโกสุม\nโกไสย\nโกหก\nใกล้\nไก\nไก่\nไก๊\nไก๋\nไก่กอม\nไกพัล\nไกร\nไกรพ\nไกรลาส\nไกรศร\nไกรศรี\nไกรสร\nไกรสรี\nไกรสิทธิ\nไกล\nไกล่\nไกลาส\nไกว\nไกวัล\nขงจื๊อ\nขจร\nขจรจบ\nขจัด\nขจ่าง\nขจาย\nขจาว\nขจิต\nขจี\nขจุย\nขเจา\nขณะ\nขด\nขน\nข้น\nขนง\nขนด\nขนบ\nขนม\nขนอง\nขนอน\nขนอบ\nขนัด\nขนัน\nขนาก\nขนาง\nขนาด\nขนาน\nขนาบ\nขนาย\nขนำ\nขนิษฐ\nขนิษฐา\nขนุน\nขนุนนก\nขบ\nขบถ\nขบวน\nขบวร\nขม\nข่ม\nขมงโกรย\nขมวด\nขมวน\nขมอง\nขม่อม\nขมัง\nขมับ\nขมา\nขม้ำ\nขมิ้น\nขมิบ\nขมีขมัน\nขมึง\nขมึงทึง\nขมุ\nขมุกขมัว\nขมุบ\nขโมย\nขยด\nขยม\nขย่ม\nขยอก\nขยอง\nขย่อน\nขย้อน\nขยะ\nขยัก\nขยัน\nขยั้น\nขยับ\nขยาด\nขยาย\nขยำ\nขย้ำ\nขยิก\nขยิบ\nขยิ่ม\nขยี้\nขยุกขยิก\nขยุกขยุย\nขยุบ\nขยุบขยิบ\nขยุม\nขยุ้ม\nขยุย\nขรม\nขรรค์\nขรัว\nขริบ\nขรี\nขรึม\nขรุขระ\nขลบ\nขล้อ\nขลัง\nขลับ\nขลาด\nขลาย\nขลิบ\nขลุก\nขลุกขลัก\nขลุกขลิก\nขลุบ\nขลุม\nขลุ่ย\nขลู\nขลู่\nขวง\nข่วง\nขวด\nข่วน\nขวนขวาย\nขวบ\nขวย\nขวักไขว่\nขวัญ\nขวั้น\nขวับ\nขวับเขวียว\nขวา\nขวาก\nขวาง\nขว้าง\nขวาด\nขวาน\nขวายขวน\nขวาว\nขว้าว\nขวิด\nขอ\nข่อ\nข้อ\nของ\nข้อง\nขอด\nขอน\nข้อน\nขอบ\nขอม\nข่อย\nข้อย\nข่อยหยอง\nขะแจะ\nขะเน็ด\nขะมอมขะแมม\nขะมักเขม้น\nขะมุกขะมอม\nขะยิก\nขะยุก\nขะเย้อแขย่ง\nขัค\nขัง\nขังขอก\nขัช\nขัณฑสกร\nขัณฑสีมา\nขัด\nขัดมอน\nขัตติยมานะ\nขัน\nขั้น\nขันติ\nขันตี\nขันโตก\nขันที\nขันธ์\nขันธาวาร\nขับ\nขัว\nขั้ว\nขา\nข่า\nข้า\nขาก\nขาก๊วย\nขาง\nข่าง\nข้าง\nขาณุ\nขาด\nขาทนียะ\nขาน\nขาบ\nข้าพเจ้า\nขาม\nข่าม\nข้าม\nขาย\nข่าย\nขาล\nขาว\nข่าว\nข้าว\nข้าวอังกุลี\nขำ\nขิก\nขิง\nขิงแกลง\nขิงแครง\nขิด\nขิปสัทโท\nขิม\nขี่\nขี้\nขี้เข็บ\nขีณาสพ\nขีด\nขี้ตังนี\nขีปนาวุธ\nขี้ยอก\nขีระ\nขึง\nขึ้ง\nขึ้น\nขึ้นฉ่าย\nขืน\nขื่น\nขื่อ\nขุก\nขุด\nขุน\nขุ่น\nขุนเพ็ด\nขุม\nขุย\nขู่\nขูด\nเข\nเข้\nเขก\nเข็ง\nเข่ง\nเขจร\nเข็ญ\nเข็ด\nเขดา\nเขต\nเขน\nเข็น\nเข่น\nเขนง\nเขน็ด\nเขนย\nเขบ็จขบวน\nเขบ็ต\nเขม\nเข็ม\nเข้ม\nเข้มขาบ\nเขม็ง\nเขม็ดแขม่\nเขม่น\nเขม้น\nเขม้นขะมัก\nเขมร\nเขมา\nเขม่า\nเขมือบ\nเขย\nเขยก\nเขย่ง\nเขย้อแขย่ง\nเขย่า\nเขยิน\nเขยิบ\nเขยื้อน\nเขรอะ\nเขลง\nเขลอะ\nเขละ\nเขลา\nเขลาะ\nเขว\nเขษม\nเขฬะ\nเขะขะ\nเขา\nเข่า\nเข้า\nเขิง\nเขิน\nเขิบ\nเขี่ย\nเขียง\nเขียด\nเขียดตะปาด\nเขียน\nเขี่ยน\nเขียม\nเขียว\nเขี้ยว\nเขียะ\nเขือ\nเขือง\nเขื่อง\nเขื่อน\nเขือม\nแข\nแข้\nแขก\nแข็ง\nแข่ง\nแข้ง\nแขน\nแข่น\nแข้น\nแขนง\nแขม\nแขม็บ\nแขม่ว\nแขยง\nแขย่ง\nแขวก\nแขวง\nแขวน\nแขวะ\nโข\nโขก\nโขง\nโข่ง\nโขด\nโขดง\nโขน\nโขนง\nโขม\nโขมง\nโขมด\nโขยก\nโขยง\nโขย่ง\nโขยด\nโขลก\nโขลง\nโขลน\nโขษม\nไข\nไข่\nไข้\nไขว่\nไขว้\nคคนะ\nคคนัมพร\nคคนางค์\nคคนานต์\nคง\nคงคา\nคงไคย\nคช\nคชาชาติ\nคชาชีพ\nคชาธาร\nคชาภรณ์\nคณนา\nคณบดี\nคณะ\nคณาจารย์\nคณาธิการ\nคณาธิปไตย\nคณานับ\nคณิกา\nคณิต\nคเณศ\nคด\nคดี\nคติ\nคทา\nคน\nค้น\nคนทา\nคนทิสอ\nคนที\nคนโท\nคนธ์\nคันธ์\nคนธรรพ์\nคเนจร\nคบ\nคม\nคมน์\nคมนาการ\nคมนาคม\nคมิกภัต\nครก\nครบ\nครรชิต\nครรภ\nครรภ์\nครรลอง\nครรโลง\nครรไล\nครวญ\nครวี\nครหา\nครอก\nครอง\nครองแครง\nคร่อเงาะ\nคร่อเทียน\nครอบ\nคร่อม\nคระเมิม\nคระแลง\nคระไล\nคระแวง\nคระหน\nคระหวน\nคระหาย\nคระโหย\nครั่ง\nครั้ง\nครัดเคร่ง\nครัน\nครั่น\nครั้น\nครับ\nครัว\nครา\nคร่า\nคราก\nคราง\nคราญ\nคราด\nคร้าน\nคราบ\nคราม\nคร้าม\nครามครัน\nคราว\nคร่าว\nคราส\nครำ\nคร่ำ\nคร่ำเคร่ง\nคริปทอน\nคริสต์\nครีบ\nครีม\nครีษมายัน\nครึ\nครึกครื้น\nครึกโครม\nครึ่ง\nครึ่ด\nครึน\nครึ้ม\nครืด\nครืน\nครื้น\nครืนครั่น\nครื้นครั่น\nครื้นครึก\nครื้นเครง\nครือ\nครุ\nครุคระ\nครุฑ\nครุ่น\nครุมเครือ\nครุย\nครุวนา\nครู\nครู่\nครูด\nคฤโฆษ\nคฤนถ์\nคฤหบดี\nคฤหัสถ์\nคฤหาสน์\nคลวง\nคลอ\nคล้อ\nคลอก\nคลอง\nคล่อง\nคล้อง\nคลอด\nคลอน\nคล้อย\nคลอรีน\nคลอโรฟอร์ม\nคลอโรฟีลล์\nคละ\nคละคลุ้ง\nคลัก\nคลั่ก\nคลัง\nคลั่ง\nคลัตช์\nคลับคล้าย\nคลับคลา\nคลา\nคล้า\nคลางแคลง\nคลาด\nคลาน\nคลาย\nคล้าย\nคล้ายคลึง\nคล่าว\nคลำ\nคล่ำ\nคล้ำ\nคลิ้งโคลง\nคลิด\nคลินิก\nคลี\nคลี่\nคลึง\nคลื่น\nคลุก\nคลุ้ง\nคลุบ\nคลุม\nคลุ่ม\nคลุ้ม\nควง\nควณ\nควน\nควบ\nควย\nควร\nควัก\nควั่ก\nควั่งคว้าง\nควัน\nควั่น\nคว้า\nควาก\nคว้าง\nควาญ\nควาน\nคว้าน\nความ\nควาย\nคว่าว\nคว่ำ\nควินิน\nควิวคว่าง\nคหกรรม\nคหกรรมศาสตร์\nคหบดี\nคหัฐ\nคอ\nค้อ\nคอก\nค็อกคัส\nค็อกเทล\nคอเคซอยด์\nค่องอ้อย\nคอด\nคอแดง\nคอน\nค่อน\nค้อน\nคอนกรีต\nคอนเดนเซอร์\nคอนแวนต์\nคอนเสิร์ต\nคอม\nค่อม\nค้อม\nคอมพิวเตอร์\nคอมมานโด\nคอมมิวนิสต์\nคอย\nค่อย\nค้อย\nคอยล์\nคอร์ด\nคอแลน\nคอสติกโซดา\nคะ\nค่ะ\nคะไขว่\nคะค้อย\nคะคาน\nคะนน\nคะนอง\nคะน้า\nคะนึง\nคะเน\nคะเนงร้าย\nคะเน็ด\nคะแนน\nคะมำ\nคะยั้นคะยอ\nคะเยอ\nคัก\nคั่ก\nคัคนะ\nคัคนัมพร\nคัคนางค์\nคัคนานต์\nคั่ง\nคังไคย\nคัจฉ\nคัณฑมาลา\nคัณฑสูตร\nคัด\nคัดเค้า\nคัดมอน\nคัดเม็ง\nคัทลียา\nคัน\nคั่น\nคั้น\nคันถรจนาจารย์\nคันธกุฎี\nคันธมาทน์\nคันธารราษฎร์\nคับ\nคับค้อน\nคับคา\nคับแค\nคัพภ์\nคัมภีร์\nคัมภีรภาพ\nคัล\nคั่ว\nคา\nค่า\nค้า\nค่าคบ\nคาง\nค่าง\nค้าง\nคางคก\nค้างคาว\nคาด\nคาถา\nคาทอลิก\nคาน\nค้าน\nคาบ\nคาพยุต\nคาม\nคามวาสี\nคามณีย์\nคามภีร์\nคาย\nค่าย\nคาร์บอน\nคาร์บอเนต\nคาร์บอลิก\nคาร์บูเรเตอร์\nคาร์โบรันดัม\nคาร์โบไฮเดรต\nคารม\nคารวะ\nคาราเต้\nคาราวาน\nคาว\nค่าว\nค้าว\nคาวตอง\nคาวี\nคาวุต\nคาส\nคำ\nค่ำ\nค้ำ\nคำนวณ\nคำนวร\nคำนับ\nคำนัล\nคำนึง\nคำนูณ\nคำฝอย\nคำเพลิง\nคำรน\nคำรบ\nคำราม\nคำแสด\nคำแหง\nคำโอง\nคิก\nคิง\nคิด\nคิมหันต์\nคิรี\nคิลาน\nคิลานะ\nคิว\nคิ้ว\nคี่\nคีต\nคีบ\nคีม\nคีรี\nคีรีบูน\nคึก\nคึ่ก\nคึกคัก\nคืน\nคืบ\nคือ\nคุ\nคุก\nคุกกี้\nคุกคาม\nคุกพาทย์\nคุ้ง\nคุณ\nคุด\nคุดทะราด\nคุต\nคุตติ\nคุ่น\nคุ้น\nคุป\nคุปต์\nคุปติ\nคุม\nคุ่ม\nคุ้ม\nคุย\nคุ้ย\nคุยหฐาน\nคุยหประเทศ\nคุรุ\nคุลา\nคุลิก่า\nคุลีการ\nคุหา\nคู\nคู่\nคู้\nคูณ\nคูถ\nคูน\nคูปอง\nคูเรียม\nคูหา\nเค้ก\nเค้เก้\nเค้ง\nเคณฑะ\nเคด\nเค็ด\nเคน\nเค้น\nเคเบิล\nเค็ม\nเคมี\nเคย\nเครง\nเคร่ง\nเครงครา\nเครงครำ\nเครดิต\nเครน\nเครา\nเคร่า\nเคราหณี\nเคราะห์\nเครียด\nเครียว\nเครือ\nเครื่อง\nเคล้ง\nเคล็ด\nเคล้น\nเคล้า\nเคล่าคล่อง\nเคลิบเคลิ้ม\nเคลิ้ม\nเคลีย\nเคลื่อน\nเคลือบ\nเคว้ง\nเคหะ\nเคหา\nเคอะ\nเค้า\nเคาน์เตอร์\nเคารพ\nเคาะ\nเคาะแคะ\nเคียง\nเคียด\nเคียน\nเคียม\nเคี่ยม\nเคียร\nเคียว\nเคี่ยว\nเคี้ยว\nเคือง\nแค\nแค่\nแค้\nแคแล\nแคดเมียม\nแค็ตตาล็อก\nแคแตร\nแคโทด\nแคน\nแค่น\nแค้น\nแคบ\nแคบหมู\nแคปซูล\nแคม\nแคร่\nแครก\nแครง\nแคระ\nแคลคูลัส\nแคลง\nแคลเซียม\nแคลน\nแคล้ว\nแคล่วคล่อง\nแคลอรี\nแคลิฟอร์เนียม\nแคว\nแควก\nแคว้น\nแคแสด\nแคะ\nโค\nโคก\nโคเคน\nโค่ง\nโค้ง\nโคจร\nโคเซแคนต์\nโคไซน์\nโคตร\nโคแทนเจนต์\nโคธา\nโคน\nโค่น\nโคบอลต์\nโคปผกะ\nโคม\nโคม่า\nโครก\nโครกคราก\nโครง\nโคร่ง\nโคร่งคร่าง\nโครม\nโครเมียม\nโครโมโซม\nโคราช\nโครำ\nโคล\nโคลง\nโคลน\nโควตา\nโคออร์ดิเนต\nใคร\nใคร่\nใคร่ครวญ\nไค\nไค้\nไคร้\nไคร้เครือ\nไคล\nไคล้\nฆนะ\nฆราวาส\nฆ้อง\nฆ่า\nฆาต\nฆาน\nฆานินทรีย์\nเฆี่ยน\nโฆรวิส\nโฆษก\nโฆษณา\nโฆษะ\nโฆษิต\nงก\nงง\nงด\nงดงาม\nงบ\nงม\nงวง\nง่วง\nงวด\nง่วน\nง้วน\nงวยงง\nงอ\nง้อ\nงอก\nงอกแงก\nง่อกแง่ก\nง่อง\nง่องแง่ง\nงอแง\nงอด\nงอดแงด\nงอน\nง่อน\nง่อนแง่น\nงอนหง่อ\nงอบ\nงอม\nง้อม\nงอย\nง่อย\nงัก\nงั่ก\nงั่ง\nงัด\nงัน\nงันงก\nงับ\nงัว\nงั่ว\nงัวเงีย\nงา\nง่า\nง้าง\nงาน\nง่าน\nงาบ\nงาม\nง่าม\nงาย\nง่าย\nง้าว\nงำ\nง่ำ\nง้ำ\nงิ้ว\nงี่เง่า\nงีบ\nงึก\nงึน\nงึม\nงุด\nงุนงง\nงุ่นง่าน\nงุบ\nงุบงิบ\nงุ้ม\nงุ่มง่าม\nงุย\nงู\nงูบ\nงูสวัด\nเงก\nเงย\nเงอะ\nเงอะงะ\nเงา\nเง่า\nเง้า\nเงาะ\nเงิน\nเงี่ยง\nเงี่ยน\nเงียบ\nเงี้ยว\nเงี่ยหู\nเงื้อ\nเงือก\nเงื่อง\nเงือด\nเงื่อน\nเงือบ\nเงื้อม\nแง\nแง่\nแง่ง\nแง่น\nแง้ม\nแงะ\nโง\nโง่\nโงก\nโงกเงก\nโงง\nโง่ง\nโง้ง\nโงงเงง\nโง่งเง่ง\nโงเง\nโงน\nโงนเงน\nไง้\nจก\nจง\nจ่ง\nจงกรม\nจงกล\nจงกลนี\nจงโคร่ง\nโจงโคร่ง\nจงอร\nจงอาง\nจด\nจดุรงค์\nจตุปัจจัย\nจตุลังคบาท\nจตุโลกบาล\nจตุสดมภ์\nจตุตถ\nจตุตถี\nจตุร\nจตุรงค์\nจตุรพักตร์\nจตุรพิธ\nจตุรพิธพร\nจน\nจบ\nจม\nจ่ม\nจมร\nจมรี\nจมูก\nจยุติ\nจร\nจรณะ\nจรด\nจรรจา\nจรรโจษ\nจรรม\nจรรยา\nจรรโลง\nจรลี\nจรวจ\nจรวด\nจรส\nจรอก\nจระเข้\nจระนำ\nจระบี\nจรัล\nจรัส\nจราจร\nจราญ\nจริก\nจริง\nจริต\nจริม\nจริยธรรม\nจริยวัตร\nจริยาวัตร\nจริยศาสตร์\nจริยศึกษา\nจริยา\nจรุง\nจรูง\nจรูญ\nจเร\nจล\nจลนพลศาสตร์\nจลนศาสตร์\nจลนี\nจลาจล\nจวก\nจ๊วก\nจวง\nจ้วง\nจ๋วง\nจวด\nจวน\nจวบ\nจวัก\nจอ\nจ่อ\nจ้อ\nจ๋อ\nจอก\nจ้อก\nจ๊อก\nจ้อกแจ้ก\nจอง\nจ้อง\nจ๋อง\nจ้องเต\nจองเปรียง\nจ้องหน่อง\nจองหอง\nจอแจ\nจ๋อแจ๋\nจอด\nจอน\nจ้อน\nจอนจ่อ\nจอบ\nจอม\nจ่อม\nจอมสุรางค์\nจ่อย\nจ้อย\nจ๋อย\nจอแส\nจะ\nจ้ะ\nจ๊ะ\nจ๋ะ\nจะกละ\nจะกลาม\nจะกูด\nจะขาบ\nจะเข้\nจะเข็บ\nจะงอย\nจะจะ\nจ๊ะจ๋า\nจะแจ้ง\nจะแจ่ม\nจะละเม็ด\nจะละหวั่น\nจัก\nจั้ก\nจักกาย\nจั๊กกิ้ม\nจักขุ\nจักจั่น\nจักจี้\nจั๊กจี้\nจั๊กเดียม\nจักร\nจักรพาก\nจักรวาก\nจักริน\nจักรี\nจั๊กเล้อ\nจักษุ\nจักแหล่น\nจัง\nจั้ง\nจั๋ง\nจังกวด\nจังกอบ\nจังก้า\nจังกูด\nจังโกฏก์\nจังงัง\nจั้งมั่ง\nจังไร\nจังหนับ\nจังหรีด\nจังหวะ\nจังหวัด\nจังหัน\nจัญไร\nจัณฑ์\nจัณฑาล\nจัด\nจัตตาฬีสะ\nจัตวา\nจัตุ\nจัตุรงค์\nจัตุรัส\nจัตุลังคบาท\nจัตุโลกบาล\nจัตุสดมภ์\nจัน\nจั่น\nจันโจษ\nจั่นดิน\nจันท์\nจันทน์\nจันทร์\nจันทรคติ\nจันทรคราส\nจันทรุปราคา\nจันทรเม็ด\nจันทวาร\nจันทัน\nจันอับ\nจับ\nจับกัง\nจับฉ่าย\nจับเดิม\nจับปิ้ง\nจับยี่กี\nจัมบก\nจัมปกะ\nจัมปา\nจัมมะ\nจัว\nจั่ว\nจั๊วะ\nจา\nจ่า\nจ้า\nจ๋า\nจาก\nจากพาก\nจาคะ\nจาคี\nจาง\nจ่าง\nจ้าง\nจางปาง\nจางวาง\nจาด\nจาตุรงค์\nจาตุรนต์\nจาตุรันต์\nจาน\nจ้าน\nจาบ\nจาบัล\nจาบัลย์\nจาป\nจาม\nจ่ามงกุฎ\nจามจุรี\nจามร\nจามรี\nจามีกร\nจ่าย\nจาร\nจ่ารง\nจารวาก\nจาระไน\nจาระบี\nจาริก\nจารึก\nจารี\nจารีต\nจารุ\nจ้าละหวั่น\nจาว\nจ้าว\nจ่าหวัก\nจำ\nจ้ำ\nจำกัด\nจำงาย\nจ้ำจี้\nจำเจ\nจำเดิม\nจำทวย\nจำนง\nจำนน\nจำนรรจ์\nจำนรรจา\nจำนวน\nจำนอง\nจำนัล\nจำนำ\nจำเนียน\nจำเนียม\nจำเนียร\nจำแนก\nจำบ่ม\nจำบัง\nจ้ำเบ้า\nจำปา\nจำปาดะ\nจำปี\nจำปูน\nจำพวก\nจำเพาะ\nจ้ำม่ำ\nจำรัส\nจำราญ\nจำรูญ\nจำเริญ\nจำเรียง\nจำลอง\nจำเลย\nจำเลาะ\nจำแลง\nจำแล่น\nจำหนับ\nจ๋ำหนับ\nจำหน่าย\nจำหระ\nจำหล่อ\nจำหลัก\nจำเหียง\nจำอวด\nจิ\nจิก\nจิ้งโกร่ง\nจิ้งจก\nจิงจ้อ\nจิ้งจอก\nจิงจัง\nจิ้งจัง\nจิงโจ้\nจิ้งหรีด\nจิ้งเหลน\nจิต\nจิตกาธาน\nจิตต์\nจิตร\nจิตรจุล\nจิตระ\nจิตรา\nจินเจา\nจินดา\nจินดาหนา\nจินดาหรา\nจินต์\nจิบ\nจิปาถะ\nจิ่ม\nจิ้ม\nจิ้มก้อง\nจิ้มลิ้ม\nจิรกาล\nจิ๋ว\nจี\nจี่\nจี้\nจี๋\nจี๋จ้อ\nจีแจ๊บ\nจี๊ด\nจีน\nจีนแส\nจีบ\nจีโบ\nจีม\nจีวร\nจึง\nจึ่ง\nจึ้ง\nจืด\nจุ\nจุก\nจุ๊กกรู๊\nจุกจิก\nจุกชี\nจุกผาม\nจุกโรหินี\nจุ่ง\nจุ๋งจิ๋ง\nจุฑา\nจุณ\nจุณณียบท\nจุด\nจุติ\nจุตูปปาตญาณ\nจุทส\nจุน\nจุ่น\nจุ้น\nจุนจู๋\nจุ้นจู๊\nจุนทการ\nจุนสี\nจุบ\nจุ๊บ\nจุบจิบ\nจุ๊บแจง\nจุ่ม\nจุ้ม\nจุ๋มจิ๋ม\nจุมพฏ\nจุมพรวด\nจุมพล\nจุมพิต\nจุมโพล่\nจุ้ย\nจุรณ\nจูรณ\nจุรี\nจุไร\nจุล\nจุลจอมเกล้า\nจุลวงศ์\nจุฬา\nจุฬาราชมนตรี\nจุฬาลัมพา\nจุฬาลำพา\nจู\nจู่\nจู้\nจู๋\nจูง\nจู้จี้\nจู๋จี๋\nจู๊ด\nจูบ\nเจ\nเจ๊ก\nเจ่ง\nเจ้ง\nเจ๊ง\nเจ๋ง\nเจ็ด\nเจ็ดตะคลี\nเจดีย์\nเจดียสถาน\nเจต\nเจตนา\nเจตพังคี\nเจตมูลเพลิง\nเจตสิก\nเจโตวิมุติ\nเจน\nเจ็บ\nเจรจา\nเจริญ\nเจริด\nเจรียง\nเจลียง\nเจว็ด\nเจษฎา\nเจ๊สัว\nเจอ\nเจ่อ\nเจ๋อ\nเจ๋อเจ๊อะ\nเจอร์เมเนียม\nเจอะ\nเจา\nเจ่า\nเจ้า\nเจ๊า\nเจาะ\nเจิ่ง\nเจิด\nเจิ่น\nเจิม\nเจีย\nเจียง\nเจียด\nเจียน\nเจี๋ยน\nเจี๊ยบ\nเจียม\nเจี๋ยมเจี้ยม\nเจียร\nเจียระไน\nเจียระบาด\nเจียว\nเจี๊ยวจ๊าว\nเจือ\nเจื่อน\nเจื้อย\nเจือสม\nแจ\nแจ้\nแจ๋\nแจก\nแจกัน\nแจง\nแจ่ง\nแจ้ง\nแจงลอน\nแจ๊ด\nแจ๊ดแจ๋\nแจตร\nแจ้น\nแจบ\nแจ่ม\nแจรง\nแจว\nแจ่ว\nแจ้ว\nแจ๋ว\nแจะ\nโจก\nโจ๊ก\nโจง\nโจ่งครึ่ม\nโจ๋งครึ่ม\nโจ่งครุ่ม\nโจ๋งเจ๋ง\nโจ่งแจ้ง\nโจท\nโจทก์\nโจทนา\nโจทย์\nโจน\nโจม\nโจร\nโจล\nโจษ\nโจษจัน\nใจ\nไจ\nไจ้\nฉก\nฉกรรจ์\nฉกษัตริย์\nฉกาจ\nฉกามาพจร\nฉกามาวจร\nฉง\nฉงน\nฉงาย\nฉทึง\nฉนวน\nฉนัง\nฉนาก\nฉนำ\nฉบัง\nฉบัด\nฉบับ\nฉบำ\nฉม\nฉมบ\nฉมวก\nฉมวย\nฉม่อง\nฉมัง\nฉมัน\nฉมา\nฉมำ\nฉล\nฉลวย\nฉลอง\nฉลอม\nฉลัก\nฉลับ\nฉลาก\nฉลาง\nฉลาด\nฉลาม\nฉลาย\nฉลิว\nฉลีก\nฉลุ\nฉลู\nฉวย\nฉวะ\nฉวัดเฉวียน\nฉวาง\nฉวี\nฉศก\nฉ้อ\nฉอก\nฉ่อง\nฉอด\nฉ่อย\nฉอเลาะ\nฉะ\nฉะฉาด\nฉะฉาน\nฉะฉ่ำ\nฉะฉี่\nฉะเฉื่อย\nฉะนั้น\nฉะนี้\nฉะอ้อน\nฉักกะ\nฉัฐ\nฉัด\nฉัตร\nฉัททันต์\nฉัน\nฉันท\nฉันท์\nฉันทะ\nฉันทา\nฉันทาคติ\nฉันทานุมัติ\nฉับ\nฉัพพรรณรังสี\nฉัยยา\nฉ่า\nฉาก\nฉาง\nฉ่าง\nฉ่าฉาว\nฉาด\nฉาดฉาน\nฉาตกภัย\nฉาน\nฉาบ\nฉาบฉวย\nฉาย\nฉายา\nฉาว\nฉ่ำ\nฉำฉา\nฉำแฉะ\nฉิ่ง\nฉิน\nฉินท์\nฉินทฤกษ์\nฉิบ\nฉิมพลี\nฉิว\nฉี่\nฉีก\nฉีด\nฉุ\nฉุก\nฉุด\nฉุน\nฉุป\nฉุป\nฉุย\nฉุยฉาย\nฉู่\nฉู่ฉี่\nฉูด\nฉูดฉาด\nเฉ\nเฉก\nเฉโก\nเฉ่ง\nเฉด\nเฉท\nเฉนียน\nเฉพาะ\nเฉย\nเฉลย\nเฉลว\nเฉลา\nเฉลิม\nเฉลี่ย\nเฉลียง\nเฉลี่ยง\nเฉลียบ\nเฉลียว\nเฉวียง\nเฉวียน\nเฉอะแฉะ\nเฉา\nเฉาก๊วย\nเฉาฮื้อ\nเฉาะ\nเฉิด\nเฉิบ\nเฉียง\nเฉียงพร้านางแอ\nเฉียด\nเฉียบ\nเฉียว\nเฉี่ยว\nเฉือน\nเฉื่อย\nแฉ\nแฉ่\nแฉก\nแฉง\nแฉ่ง\nแฉลบ\nแฉล้ม\nแฉะ\nโฉ\nโฉ่\nโฉเก\nโฉ่งฉ่าง\nโฉงเฉง\nโฉด\nโฉนด\nโฉบ\nโฉเบ๊\nโฉม\nโฉลก\nไฉน\nไฉไล\nชก\nชคัตตรัย\nชง\nชงโค\nชงฆ์\nชงฆา\nชงโลง\nชฎา\nชฎามังษี\nชฎามังสี\nชฎิล\nชด\nชน\nชนก\nชนนี\nชนม์\nชนวน\nชนะ\nชนัก\nชนา\nชนาง\nชนิด\nชเนตตี\nชบา\nชม\nชมดชม้อย\nชมนาด\nชมพู\nชมพู่\nชมรม\nชม้อย\nชม้าย\nชไม\nชยา\nชโย\nชรทึง\nชรริน\nชรอุ่ม\nชระล้ำ\nชระลุ\nชระอาบ\nชระเอม\nชรัด\nชรา\nชล\nชโลง\nชโลม\nช่วง\nชวด\nชวน\nชวย\nช่วย\nชวร\nชวลิต\nชวา\nชวาล\nชวาลา\nช่อ\nชอก\nช็อก\nช็อกโกเลต\nช็อกโกแลต\nชอง\nช่อง\nช้อง\nชองระอา\nชอน\nช่อน\nช้อน\nชอบ\nชอม\nช้อย\nชอล์ก\nชอ่ำ\nชอุ่ม\nชะ\nชะคราม\nชะงอก\nชะง่อน\nชะงัก\nชะงัด\nชะง้ำ\nชะงุ้ม\nชะเง้อ\nชะเงื้อม\nชะแง้\nชะโงก\nชะฉ่า\nชะช่อง\nชะชะ\nชะช้า\nชะโด\nชะตา\nชะต้า\nชะนี\nชะเนาะ\nชะเนียง\nชะพลู\nชะเพลิง\nชะมด\nชะมบ\nชะมวง\nชะมัง\nชะมัด\nชะแม่\nชะรอย\nชะลอ\nชะลอม\nชะล่า\nชะลาน\nชะลิน\nชะลูด\nชะเลง\nชะเลย\nชะแล็ก\nชะแลง\nชะวาก\nชะวาด\nชะเวิกชะวาก\nชะแวง\nชะอม\nชะอ้อน\nชะเอม\nชะโอน\nชัก\nชักคราม\nชักช้า\nชัง\nชั่ง\nชังคา\nชังฆ\nชัชวาล\nชัฏ\nชัด\nชัดช้า\nชัน\nชั้น\nชันกาด\nชันชี\nชันตุ\nชันนะตุ\nชันนุ\nชันโรง\nชันษา\nชันสูตร\nชัปนะ\nชัพ\nชัมพูนท\nชัย\nชัยพฤกษ์\nชัยภูมิ\nชัลลุกา\nชั่ว\nชั้ว\nชัวชม\nชา\nช้า\nชาคระ\nชาคริต\nชาคริยานุโยค\nช่าง\nช้าง\nช้าช่อน\nชาญ\nชาด\nชาดก\nชาต\nชาตบุษย์\nชาตรี\nชาตะ\nชาตา\nชาติ\nชาน\nชานุ\nช้าปี่\nชาปีไหน\nช้าแป้น\nช้าพลู\nชาม\nชามพูนท\nชามาดร\nชามาดา\nชามาตุ\nชาย\nชายา\nชาล\nชาลา\nชาลินี\nช้าเลือด\nชาว\nชาวี\nชำ\nช่ำ\nช้ำ\nชำงัด\nชำงาย\nช่ำชอง\nชำนะ\nชำนัญ\nชำนัน\nชำนาญ\nชำนิ\nชำเนียร\nชำมะนาด\nชำมะเลียง\nชำร่วย\nชำระ\nช้ำรั่ว\nชำรุด\nชำเรา\nชำเราะ\nชำแรก\nชำแระ\nชำเลือง\nชำแหละ\nชิ\nชิง\nชิ่ง\nชิงชัน\nชิงช้า\nชิงช้าชาลี\nชิงชี่\nชิงฮื้อ\nชิชะ\nชิชิ\nชิณณะ\nชิด\nชิเดนทรีย์\nชิต\nชิตินทรีย์\nชิน\nชิ้น\nชินโต\nชิโนรส\nชิม\nชิมแปนซี\nชิยา\nชิรณะ\nชิระ\nชิวหา\nชิสา\nชี\nชี่\nชี้\nชีปะขาว\nชีผะขาว\nชีผ้าขาว\nชีพ\nชีฟอง\nชีรณ\nชีระ\nชีวเคมี\nชีวประวัติ\nชีวภาพ\nชีววิทยา\nชีวะ\nชีวัน\nชีวา\nชีวาตม์\nชีวาลัย\nชีวิต\nชีวิตักษัย\nชีวิน\nชีวี\nชืด\nชื่น\nชื้น\nชื่อ\nชุก\nชุกชี\nชุ้ง\nชุณห\nชุด\nชุติ\nชุน\nชุบ\nชุม\nชุ่ม\nชุมนุม\nชุมพร\nชุมพา\nชุมแพรก\nชุมรุม\nชุมแสง\nชุมเห็ด\nชุ่ย\nชุลมุน\nชุลี\nชุษณะ\nชู\nชู้\nเช็ค\nเช้ง\nเช้งวับ\nเชงเลง\nเช็ด\nเชน\nเช่น\nเชย\nเชลง\nเชลย\nเชลแล็ก\nเชลียง\nเชวง\nเชษฐะ\nเชษฐา\nเชอ\nเช่า\nเช้า\nเชาว์\nเชาวน์\nเชิง\nเชิญ\nเชิด\nเชิ้ต\nเชียง\nเชี่ยน\nเชียบ\nเชี่ยม\nเชียร\nเชียร์\nเชียว\nเชี่ยว\nเชื่อ\nเชื้อ\nเชือก\nเชื่อง\nเชือด\nเชือน\nเชื่อม\nแช\nแช่\nแช่ง\nแชงมา\nแชบ๊วย\nแช่ม\nแชร์\nแชล่ม\nแชสซี\nแชะ\nโชก\nโชค\nโชงโลง\nโชดก\nโชดึก\nโชต\nโชตก\nโชติ\nโชติก\nโชน\nโชมโรม\nโชย\nโชยงการ\nโชยชาย\nโชยติส\nโชว์\nใช่\nใช้\nไช\nไชนะ\nไชย\nไชโย\nซก\nซ่ก\nซงดำ\nซ่งฮื้อ\nซด\nซน\nซ้น\nซบ\nซม\nซวดเซ\nซวน\nซวย\nซอ\nซอก\nซอง\nซ่อง\nซ้อง\nซองแมว\nซ้องแมว\nซอน\nซ่อน\nซ้อน\nซอม\nซ่อม\nซ้อม\nซอมซ่อ\nซอย\nซอส\nซัก\nซักส้าว\nซัง\nซั้ง\nซัด\nซับ\nซัลฟา\nซั้ว\nซา\nซ่า\nซาก\nซาง\nซ่าง\nซาด\nซาน\nซ่าน\nซาบซ่าน\nซาบซึ้ง\nซ่าโบะ\nซาแมเรียม\nซ้าย\nซาลาเปา\nซาว\nซ่าหริ่ม\nซำ\nซ้ำ\nซิ\nซี\nซิก\nซิกข์\nซิกซี้\nซิกแซ็ก\nซิการ์\nซิงโคนา\nซิ่น\nซินนามิก\nซินแส\nซิบ\nซิป\nซิฟิลิส\nซิลิคอน\nซิว\nซี่\nซีก\nซีเซียม\nซีด\nซี้ด\nซีนอน\nซีป่าย\nซีเมนต์\nซีเรียม\nซีลีเนียม\nซีอิ๊ว\nซึก\nซึง\nซึ่ง\nซึ้ง\nซึม\nซื่อ\nซื้อ\nซุก\nซุง\nซุน\nซุบ\nซุป\nซุ่ม\nซุ้ม\nซุ่มซ่าม\nซุย\nซู่\nซูโครส\nซูด\nซู้ด\nซูดซาด\nซูบ\nเซ\nเซ็ก\nเซแคนต์\nเซ็ง\nเซ่ง\nเซ้ง\nเซ็งแซ่\nเซต\nเซน\nเซ็น\nเซ่น\nเซนติกรัม\nเซนติเกรด\nเซนติเมตร\nเซนติลิตร\nเซปักตะกร้อ\nเซราะ\nเซรุ่ม\nเซลเซียส\nเซลล์\nเซลลูลอยด์\nเซลลูโลส\nเซ่อ\nเซอร์โคเนียม\nเซอะ\nเซา\nเซ้าซี้\nเซาะ\nเซิง\nเซิ้ง\nเซียน\nเซียบ\nเซียมซี\nเซียว\nเซี่ยว\nเซี่ยวกาง\nเซื่อง\nแซ\nแซ่\nแซ็กคาริน\nแซง\nแซงแซว\nแซด\nแซบ\nแซม\nแซยิด\nแซ่ว\nแซะ\nโซ\nโซ่\nโซก\nโซ่ง\nโซงโขดง\nโซเซ\nโซดา\nโซเดียม\nโซม\nโซรม\nโซลา\nไซ\nไซ้\nไซเกิล\nไซโคลน\nไซน์\nไซยาไนด์\nไซร้\nไซเรน\nไซโล\nฌาน\nฌาปน\nฌาปนกิจ\nฌาปนสถาน\nเฌอ\nเฌอเอม\nญวน\nญัตติ\nญาณ\nญาติ\nญานาซะฮ์\nญิบ\nญี่ปุ่น\nเญยธรรม\nไญยธรรม\nฎีกา\nฐกัด\nฐากูร\nฐาน\nฐานะ\nฐานันดร\nฐานานุกรม\nฐานานุรูป\nฐานานุศักดิ์\nฐานียะ\nฐาปน\nฐาปนา\nฐายี\nฐิต\nฐิติ\nฑาหก\nฑาหะ\nเฒ่า\nณรงค์\nเณร\nดก\nดง\nด้ง\nด้น\nดนโด่\nดนตรี\nดนัย\nดนุ\nดนู\nดบัสวิน\nดบัสวี\nดม\nดรงค์\nดรณี\nดรรชนี\nดราฟต์\nดรุณ\nดรุณี\nดล\nดวง\nด้วง\nดวด\nด่วน\nด้วน\nด้วย\nดอก\nดอง\nด่อง\nด้อง\nดองฉาย\nดองดึง\nดอด\nดอน\nด่อน\nดอม\nด้อม\nดอย\nด้อย\nดอลลาร์\nดะ\nดะโต๊ะ\nดะหมัง\nดัก\nดักดาน\nดักแด้\nดัง\nดั่ง\nดั้ง\nดัชนี\nดัด\nดัตช์\nดัน\nดั้น\nดับ\nดัมพ์\nดั้วเดี้ย\nดัสกร\nดา\nด่า\nดาก\nด่าง\nด้าง\nดาด\nดาน\nด่าน\nด้าน\nดาบ\nดาบส\nดาม\nด้าม\nด้ามจิ้ว\nดามพ์\nดาย\nด้าย\nดารกะ\nดารณี\nดารดาษ\nดาระ\nดารา\nดาล\nดาลัด\nดาว\nด่าว\nด้าว\nดาวดึงส์\nดาวบส\nดาษ\nดาษดา\nดำ\nด่ำ\nด้ำ\nดำกล\nดำเกิง\nดำแคง\nดำดง\nดำนาณ\nดำเนิน\nดำบล\nดำรง\nดำรวจ\nดำรัส\nดำริ\nดำรี\nดำรู\nดำฤษณา\nดำเลิง\nดิก\nดิ่ง\nดิฉัน\nดิฐ\nดิตถ์\nดิถี\nดิน\nดิ้น\nดิบ\nดิรัจฉาน\nดิลก\nดิ่ว\nดิ้ว\nดิ้วเดี้ยว\nดิษฐ์\nดิสโพรเซียม\nดี\nดีเซล\nดีด\nดีดีที\nดีบุก\nดีปลี\nดีเปรสชัน\nดีหมี\nดีหลี\nดึก\nดึง\nดึ่ง\nดึ่ม\nดื่น\nดื่ม\nดือ\nดื้อ\nดุ\nดุก\nดุกดิก\nดุกทะเล\nดุ้ง\nดุ้งดิ้ง\nดุจ\nดุด\nดุน\nดุ้น\nดุบ\nดุม\nดุ่ม\nดุ่ย\nดุรงค์\nดุริยะ\nดุริยางค์\nดุริยางคศาสตร์\nดุริยางคศิลป์\nดุล\nดุษฎี\nดุษณี\nดุษณีภาพ\nดุษิต\nดุสิต\nดุเหว่า\nดู\nดูกค่าง\nดูกร\nดูด\nดูรา\nดูแล\nเด\nเด่\nเดก\nเด็ก\nเดกซ์โทรส\nเดคากรัม\nเดคาเมตร\nเดคาลิตร\nเด้ง\nเด็จ\nเดช\nเดชน์\nเดชนะ\nเดชะ\nเดโช\nเดซิกรัม\nเดซิเมตร\nเดซิลิตร\nเด็ด\nเดน\nเด่น\nเดนมาร์ก\nเดรัจฉาน\nเด๋อ\nเด๋อด๋า\nเดา\nเด้า\nเดาะ\nเดิน\nเดิ่น\nเดิม\nเดียง\nเดียด\nเดียรดาษ\nเดียรถีย์\nเดียรัจฉาน\nเดียว\nเดี่ยว\nเดี๋ยว\nเดียะ\nเดื่อ\nเดือก\nเดื่อง\nเดือด\nเดือน\nเดือย\nแด\nแด่\nแดก\nแด็ก\nแดกงา\nแดกแด้\nแดง\nแดด\nแดน\nแด่น\nแด่ว\nแดะ\nแดะแด๋\nโด\nโด่\nโดกเดก\nโด่ง\nโดด\nโดน\nโดม\nโดมร\nโดย\nโดรณ\nใด\nได\nได้\nไดแซ็กคาไรด์\nไดนาโม\nไดนาไมต์\nไดโนเสาร์\nไดเรกตริกซ์\nตก\nต๊กโต\nตง\nต๋ง\nตงฉิน\nตงิด\nตงุ่น\nตด\nตติย\nตถาคต\nตน\nต้น\nตนัย\nตนุ\nตบ\nตบะ\nตปนียะ\nตม\nต้ม\nตมูก\nตยาคี\nตรง\nตรณี\nตรม\nตรรก\nตรรกะ\nตรลบ\nตรลอด\nตรลาด\nตรวจ\nตรวน\nตรอก\nตรอง\nตรอมใจ\nตรอมตรม\nตระ\nตระกล\nตระกวน\nตระกอง\nตระการ\nตระกูล\nตระคัร\nตระเตรียม\nตระนาว\nตระบก\nตระบอก\nตระบอง\nตระบัด\nตระบัน\nตระเบ็ง\nตระแบก\nตระแบง\nตระโบม\nตระพอง\nตระพัง\nตระลาการ\nตระวัน\nตระเว็ด\nตระเวน\nตระสัก\nตระหง่าน\nตระหนก\nตระหนัก\nตระหน่ำ\nตระหนี่\nตรัง\nตรังค์\nตรับ\nตรับฟัง\nตรัย\nตรัยตรึงศ์\nตรัส\nตรัสสา\nตรา\nตรากตรำ\nตราชู\nตราบ\nตราสัง\nตรำ\nตริ\nตริว\nตรี\nตรีปวาย\nตรีพิธพรรณ\nตรียัมปวาย\nตรึก\nตรึง\nตรุ\nตรุณ\nตรุณะ\nตรุษ\nตรู\nตรู่\nตฤณ\nตฤตีย\nตฤษณา\nตลก\nตลบ\nตลอด\nตลับ\nตลาด\nตลิ่ง\nตลึง\nตวง\nต่วน\nต้วมเตี้ยม\nตวัก\nตวัด\nตวาด\nตอ\nตอม่อ\nต่อ\nต้อ\nตอก\nต๊อก\nต๊อกต๋อย\nตอง\nต้อง\nตองกราย\nต้องเต\nตองแตก\nต่องแต่ง\nตองเหลือง\nตอด\nตอน\nต้อน\nตอบ\nตอเบา\nตอม\nต่อม\nต๋อม\nต่อย\nต้อย\nต้อยตริ่ง\nต้อยติ่ง\nต้อยตีวิด\nตอแย\nตอร์ปิโด\nต่อไส้\nตอแหล\nตะ\nตะกรน\nตะกร้อ\nตะกรัน\nตะกรับ\nตะกร้า\nตะกราม\nตะกรุด\nตะกรุม\nตะกรุมตะกราม\nตะกละ\nตะกลาม\nตะกวด\nตะกอ\nตะกอน\nตะกัง\nตะกั่ว\nตะกาง\nตะกาด\nตะกาย\nตะกาว\nตะกุกตะกัก\nตะกุย\nตะกู\nตะกูด\nตะเกียกตะกาย\nตะเกียง\nตะเกียบ\nตะแก\nตะแก่\nตะแกรง\nตะโก\nตะโก้\nตะโกก\nตะโกน\nตะโกรง\nตะโกรม\nตะไกร\nตะขบ\nตะขอ\nตะขาบ\nตะขิดตะขวง\nตะเข้\nตะเข็บ\nตะโขง\nตะคร้อ\nตะครอง\nตะครั่นตะครอ\nตะคร้ำ\nตะคริว\nตะคิว\nตะครุบ\nตะคอก\nตะคัน\nตะค้า\nตะคาก\nตะค้าน\nตะคุ่ม\nตะเครียว\nตะเคียว\nตะเคียน\nตะแคง\nตะไคร่\nตะไคร้\nตะเฆ่\nตะนอย\nตะนาว\nตะบม\nตะบอง\nตะบอย\nตะบัน\nตะบิ้ง\nตะบิด\nตะบิดตะบอย\nตะบี้ตะบัน\nตะบึง\nตะบูน\nตะเบ็ง\nตะเบ็งมาน\nตะเบ๊ะ\nตะแบก\nตะแบง\nตะโบม\nตะไบ\nตะปบ\nตะปลิง\nตะปิ้ง\nตะปุ่มตะป่ำ\nตะปู\nตะพง\nตะพด\nตะพอง\nตะพัก\nตะพัง\nตะพัด\nตะพั้น\nตะพาก\nตะพาน\nตะพาบ\nตะพาย\nตะพึด\nตะพึดตะพือ\nตะพุ่น\nตะเพรา\nตะเพิง\nตะเพิด\nตะเพียน\nตะโพก\nตะโพง\nตะโพน\nตะเภา\nตะใภ้\nตะม่อ\nตะมอย\nตะรังกะนู\nตะรังตังกวาง\nตะรังตังช้าง\nตะราง\nตะลอง\nตะลอน\nตะล่อม\nตะละ\nตะลาน\nตะลิงปลิง\nตะลิบ\nตะลีตะลาน\nตะลึง\nตะลึงพรึงเพริด\nตะลุง\nตะลุ่ม\nตะลุ่มนก\nตะลุมบอน\nตะลุ่มโปง\nตะลุมพอ\nตะลุมพุก\nตะลุย\nตะเลง\nตะแลงแกง\nตะไล\nตะวัน\nตะเวน\nตะหลิว\nตะหลุก\nตะหลุง\nตะแหง่ว\nตะแหมะแขะ\nตะโหงก\nตัก\nตักกะ\nตักเตือน\nตั๊กแตน\nตักษัย\nตัง\nตั่ง\nตั้ง\nตังเก\nตังฉ่าย\nตังเม\nตังวาย\nตังโอ๋\nตัจฉก\nตัจฉนี\nตัณฑุล\nตัณหา\nตัด\nตัน\nตันตระ\nตันติ\nตันหยง\nตับ\nตับปิ้ง\nตัว\nตั๋ว\nตัวจี๊ด\nตัวตืด\nตั้วโผ\nตั้วเหี่ย\nตา\nตาก\nตากวาง\nต่าง\nตาด\nตาน\nต่าน\nต้าน\nตานนกกด\nตานี\nตาบ\nตาม\nตามะแน\nตามิน\nตาย\nตาราไต\nตาล\nตาลุ\nต๋าว\nตาเสือ\nตาหนู\nตาฬ\nตำ\nต่ำ\nตำนาน\nตำบล\nตำแบ\nตำแย\nตำรวจ\nตำรับ\nตำรา\nตำรุ\nตำลึง\nตำเสา\nตำหนัก\nตำหนิ\nตำแหน่ง\nติ\nติก\nติ๊ก\nติกะ\nติกาหรัง\nติง\nติ่ง\nติ๋ง\nติ่งตั่ง\nติ๋งต่าง\nติงส\nติงสติ\nติณ\nติด\nติตติกะ\nติตติร\nติตถ\nติตถะ\nติถี\nติมิงคละ\nติรัจฉาน\nติลก\nติละ\nติ้ว\nตี\nตี่\nตีน\nตีบ\nตีรถะ\nตีระ\nตึ\nตึก\nตึ้ก\nตึ้กตั้ก\nตึง\nตึดตื๋อ\nตึ๊ดตื๋อ\nตืด\nตื่น\nตื้น\nตื้อ\nตื๊อ\nตื๋อ\nตุ\nตุ๊\nตุ๊กแก\nตุ๊กตา\nตุ๊กต่ำ\nตุกติก\nตุ๊กติ๊ก\nตุ๊กตุ่น\nตุ๊กตุ๋ย\nตุง\nตุ้งก่า\nตุ้งติ้ง\nตุ๊ดตู่\nตุน\nตุ่น\nตุ๋น\nตุนาหงัน\nตุบ\nตุ้บ\nตุ๊บป่อง\nตุปัดตุป่อง\nตุปัดตุเป๋\nตุ่ม\nตุ้ม\nตุ๋ม\nตุ้มกว้าว\nตุมกา\nตุ้มแซะ\nตุมตัง\nตุ้มเต๋น\nตุ้มปี่\nตุมพะ\nตุ่ย\nตุ้ย\nตุ๊ย\nตุ๋ยตุ่ย\nตุรคะ\nตุรงค์\nตุล\nตุลา\nตุหรัดตุเหร่\nตู\nตู่\nตู้\nตูก\nตูด\nตูบ\nตูม\nเต๊ก\nเต็ง\nเต่ง\nเตช\nเตโช\nเต้น\nเต็นท์\nเต็ม\nเตย\nเตร่\nเตร็ด\nเตรตา\nเตรียม\nเตรียมตรม\nเตละ\nเตลิด\nเตว็ด\nเต่อ\nเตอะ\nเตะ\nเตา\nเต่า\nเต้า\nเต๋า\nเต่าเกียด\nเต้าเจี้ยว\nเต้าทึง\nเต้าหู้\nเต้าฮวย\nเต๊าะ\nเตาะแตะ\nเติ่ง\nเติบ\nเติม\nเตี้ย\nเตียง\nเตียน\nเตียบ\nเตี๋ยม\nเตียรถ์\nเตียว\nเตี่ยว\nเตือน\nแต่\nแต้\nแตก\nแตง\nแต่ง\nแตงเม\nแต้จิ๋ว\nแตด\nแต๊ดแต๋\nแตน\nแต้ม\nแตร\nแตระ\nแต้ว\nแต้วแร้ว\nแต้วแล้ว\nแต่ว่า\nแต้แว้ด\nแตะ\nโต\nโต้\nโตก\nโต่ง\nโต้ง\nโตงเตง\nโตฎก\nโต๊ด\nโตน\nโตนด\nโต้โผ\nโตมร\nโตย\nโตรก\nโต๊ะ\nใต้\nไต\nไต่\nไต้\nไต๋\nไตร\nไตรกิศยา\nไตรดายุค\nไตร่ตรอง\nไตรย\nไต้หวัน\nถก\nถกล\nถงาด\nถด\nถนน\nถนอม\nถนัด\nถนัน\nถนำ\nถนิม\nถม\nถ่ม\nถมอ\nถมึงทึง\nถลก\nถลกบาตร\nถลน\nถล่ม\nถลอก\nถลัน\nถลา\nถลาก\nถลาย\nถลำ\nถลึงตา\nถลุง\nถ่วง\nถ้วน\nถ้วย\nถวัล\nถวัลย์\nถวาย\nถวิน\nถวิล\nถ่อ\nถ้อ\nถอก\nถอง\nถ่อง\nถ้อง\nถอด\nถอน\nถอบ\nถอบแถบ\nถ่อม\nถอย\nถ่อย\nถ้อย\nถะ\nถะถั่น\nถะมัดถะแมง\nถัก\nถัง\nถั่ง\nถัด\nถัทธ\nถัน\nถั่น\nถับ\nถัมภ์\nถัว\nถั่ว\nถา\nถ้า\nถาก\nถาง\nถ่าง\nถาด\nถาน\nถ่าน\nถาบ\nถาม\nถามะ\nถ่าย\nถ่าว\nถาวร\nถาวรธิรา\nถ้ำ\nถิ่น\nถี่\nถีบ\nถึก\nถึง\nถือ\nถุง\nถุน\nถุย\nถู\nถูก\nเถกิง\nเถน\nเถร\nเถระ\nเถรานุเถระ\nเถรี\nเถลไถล\nเถลิง\nเถลือกถลน\nเถ่อ\nเถอะ\nเถา\nเถ้า\nเถาวัลย์\nเถาะ\nเถิก\nเถิง\nเถิด\nเถิดเทิง\nเถิน\nเถียง\nเถียร\nเถือ\nเถือก\nเถื่อน\nแถ\nแถก\nแถง\nแถน\nแถบ\nแถม\nแถลง\nแถลบ\nแถว\nโถ\nโถง\nโถงเถง\nโถบ\nโถม\nโถมนาการ\nไถ\nไถ่\nไถ้\nไถง\nไถล\nทกล้า\nทแกล้ว\nท่ง\nทด\nทน\nท้น\nทนต์\nทนโท่\nทนาย\nทบ\nทบวง\nทมอ\nทมะ\nทมิฬ\nทโมน\nทยอย\nทแยง\nทรกรรม\nทรชน\nทรชาติ\nทรพิษ\nทรยศ\nทรราช\nทรลักษณ์\nทรง\nทรพี\nทรมาทรกรรม\nทรมาน\nทรรทึง\nทรรป\nทรรปณ์\nทรรปณะ\nทรรศนะ\nทรรศนาการ\nทรรศนีย์\nทรวง\nทรวดทรง\nทรวาร\nทรหด\nทรหวล\nทรหึง\nทรอมโบน\nทระนง\nทรัพย์\nทรัพยากร\nทรัมเป็ต\nทรานซิสเตอร์\nทราบ\nทราม\nทราย\nทรุด\nทฤษฎี\nทลาย\nทลิท\nทลิททก\nทวง\nท้วง\nท่วงท่า\nท่วงทำนอง\nท่วงที\nทวด\nทวน\nท้วน\nท่วม\nท้วม\nทวย\nท่วย\nท้วย\nทวอย\nทวัตดึงส์\nทวัย\nทวา\nทวาบร\nทว่า\nทวาย\nทวาร\nทวิ\nทวิช\nทวิตีย์\nทวิตียา\nทวี\nทวีธาภิเษก\nทวีป\nทศ\nทศมี\nทศางค์\nทหระ\nทหาร\nทอ\nท่อ\nท้อ\nทอก\nทอง\nท่อง\nท้อง\nทองกวาว\nทองภู\nทองลิน\nทองหลาง\nทองโหลง\nทองอุไร\nทอด\nทอน\nท่อน\nทอนซิล\nทอฟฟี่\nท่อม\nทอย\nทอเรียม\nทะ\nทะงัน\nทะนง\nทะนน\nทะนาน\nทะนุ\nทะเบียน\nทะมัดทะแมง\nทะมึน\nทะมื่น\nทะแม่ง\nทะยาน\nทะเยอทะยาน\nทะแย\nทะร่อทะแร่\nทะลวง\nทะลอก\nทะลัก\nทะลาย\nทะลึ่ง\nทะลุ\nทะลุดทะลาด\nทะเล\nทะเล้น\nทะเล่อทะล่า\nทะเลาะ\nทะเลิ่กทะลั่ก\nทะวาย\nทัก\nทักข์\nทักขิญ\nทักขิณ\nทักขิณา\nทักขิณาวัฏ\nทักขิโณทก\nทักขิไณยบุคคล\nทักทิน\nทักษะ\nทักษา\nทักษิณ\nทักษิณา\nทักษิโณทก\nทัง\nทั่ง\nทั้ง\nทังวล\nทังวี้ทังวล\nทังสเตน\nทัณฑ์\nทัณฑกรรม\nทัณฑฆาต\nทัณฑสถาน\nทัณฑะ\nทัณฑิกา\nทัณฑิมา\nทัณฑีบท\nทัด\nทัดทา\nทัต\nทัน\nทันต์\nทันตชะ\nทันตแพทย์\nทันติน\nทันตี\nทันธ์\nทับ\nทับทิม\nทับสมิงคลา\nทัพ\nทัพพะ\nทัพพี\nทั่ว\nทัศ\nทัศน์\nทัศนะ\nทัศนา\nทัศนคติ\nทัศนวิสัย\nทัศนศาสตร์\nทัศนศิลป์\nทัศนศึกษา\nทัศนาการ\nทัศนาจร\nทัศนีย์\nทัศนียภาพ\nทัศนูปกรณ์\nทัศไนย\nทัสนานุตริยะ\nทัฬหะ\nทัฬหิ\nทัฬหี\nทา\nท่า\nท้า\nทาก\nทาง\nท้าง\nทาฐะ\nทาฐิกะ\nทาฒะ\nทาฒิกะ\nทาน\nท่าน\nทานต์\nทานพ\nทาบ\nทาม\nท่ามกลาง\nทาย\nท้าย\nทายก\nทายัช\nทายาด\nทายาท\nทายิกา\nทารก\nทารพี\nทาริกา\nทารุณ\nทาว\nท่าว\nท้าว\nทาส\nทาสี\nทำ\nทำนบ\nทำนอง\nทำนาย\nทำนุ\nทำนูล\nทำเนา\nทำเนียบ\nทำไม\nทำลาย\nทำเล\nทิคัมพร\nทิฆัมพร\nทิ้ง\nทิงเจอร์\nทิ้งถ่อน\nทิ้งทูด\nทิชะ\nทิชากร\nทิชาชาติ\nทิฏฐะ\nทิฏฐานุคติ\nทิฏฐุชุกรรม\nทิฐธรรม\nทิฐิ\nทิด\nทิต\nทิน\nทิพ\nทิพย์\nทิพา\nทิม\nทิ่ม\nทิมทอง\nทิว\nทิวงคต\nทิวทัศน์\nทิวา\nทิศ\nทิศา\nทิศานุทิศ\nที\nที่\nทีฆชาติ\nทีฆนิกาย\nทีฆสระ\nทีฆายุ\nทีป\nทีม\nทีเอ็นที\nทึก\nทึกทัก\nทึ่ง\nทึ้ง\nทึดทือ\nทึนทึก\nทึบ\nทึม\nทึ่ม\nทื่อ\nทุ\nทุก\nทุกข์\nทุกขลาภ\nทุกขเวทนา\nทุกขารมณ์\nทุกฏ\nทุกรกิริยา\nทุกะ\nทุกัง\nทุกูล\nทุคตะ\nทุคติ\nทุ่ง\nทุ้ง\nทุงงะ\nทุจริต\nทุด\nทุทรรศนนิยม\nทุนิยม\nทุน\nทุ่น\nทุนนิมิต\nทุบ\nทุบทู\nทุปปัญญา\nทุพพรรณ\nทุพพล\nทุพพลภาพ\nทุพภิกขภัย\nทุม\nทุ่ม\nทุ้ม\nทุย\nทุ้ย\nทุรกันดาร\nทุรชน\nทุรชาติ\nทุรพล\nทุรลักษณ์\nทุรน\nทุรนทุราย\nทุรัศ\nทุราคม\nทุราจาร\nทุเรศ\nทุเรียน\nทุลักทุเล\nทุเลา\nทุศีล\nทุสสะ\nทุสสีล\nทู\nทูโม่ง\nทู่\nทู้\nทูกัง\nทู่ซี้\nทูต\nทูตานุทูต\nทูน\nทูบ\nทูม\nทูล\nทูเลียม\nเท\nเท่\nเทคนิค\nเทคนีเชียม\nเทคโนโลยี\nเท้ง\nเท้งเต้ง\nเท็จ\nเทนนิส\nเทพ\nเทพา\nเทพารักษ์\nเทพยเจ้า\nเทพยดา\nเทพยุดา\nเทพิน\nเทพินทร์\nเทพี\nเทเพนทร์\nเทโพ\nเทริด\nเทลลูเรียม\nเทวทัณฑ์\nเทวดา\nเทวทูต\nเทวธรรม\nเทวนาครี\nเทวนิยม\nเทวรูป\nเทวโลก\nเทววิทยา\nเทวสถาน\nเทวศ\nเทวษ\nเทวัญ\nเทวัน\nเทวาลัย\nเทวินทร์\nเทวี\nเทเวศ\nเทเวศร์\nเทเวศวร์\nเทศ\nเทศะ\nเทศาภิบาล\nเทศน์\nเทศนา\nเทห์\nเท่ห์\nเทห์ฟากฟ้า\nเทหวัตถุ\nเท่อ\nเท้อ\nเทอญ\nเทอม\nเทอร์เบียม\nเทอร์โมมิเตอร์\nเทอะทะ\nเทา\nเท่า\nเท้า\nเท้ายายม่อม\nเท่ารึง\nเทิ่ง\nเทิด\nเทิน\nเทิบ\nเทิบทาบ\nเทิ้ม\nเที่ยง\nเทียด\nเทียน\nเที้ยน\nเทียบ\nเทียม\nเทียร\nเที้ยร\nเทียว\nเที่ยว\nเทือ\nเทื่อ\nเทื้อ\nเทือก\nแท้\nแท็กซี่\nแทง\nแท่ง\nแท้ง\nแท็งก์\nแทงทวย\nแทงวิสัย\nแทตย์\nแทน\nแท่น\nแทนเจนต์\nแทนทาลัม\nแทบ\nแทรก\nแทรกเตอร์\nแทลเลียม\nแทะ\nโท\nโท่\nโทกเทก\nโทง\nโทงเทง\nโทณะ\nโทน\nโทนโท่\nโทมนัส\nโทรคมนาคม\nโทรทรรศน์\nโทรทัศน์\nโทรพิมพ์\nโทรภาพ\nโทรเลข\nโทรศัพท์\nโทรสาร\nโทรม\nโทษ\nโทษา\nโทษานุโทษ\nโทสะ\nโทสาคติ\nโทโส\nโทหฬินี\nไท\nไท้\nไทเทเนียม\nไทเทรต\nไทย\nไทร\nไทวะ\nธง\nธงก์\nธชะ\nธชี\nธตรฐ\nธนบัตร\nธนสมบัติ\nธนสาร\nธนะ\nธนา\nธนาคม\nธนาคาร\nธนาณัติ\nธเนศ\nธโนปจัย\nธไนศวรรย์\nธนิต\nธนิษฐะ\nธนิษฐา\nธนุ\nธนุรวิทยา\nธนุรเวท\nธนู\nธม\nธมกรก\nธรณะ\nธรณิน\nธรณินทร์\nธรณิศ\nธรณิศร\nธรณิศวร์\nธรณี\nธรมาน\nธรรม\nธรรมนูญ\nธรรมยุต\nธรรมยุติกนิกาย\nธรรมะ\nธรรมาทิตย์\nธรรมาธรรม\nธรรมาธิปไตย\nธรรมาธิษฐาน\nธรรมานุสาร\nธรรมาภิมุข\nธรรมาภิสมัย\nธรรมายตนะ\nธรรมารมณ์\nธรรมาสน์\nธรรมิก\nธรา\nธราดล\nธราธร\nธราธาร\nธราธิบดี\nธราธิป\nธริษตรี\nธเรษตรี\nธเรศ\nธวัช\nธัช\nธัญ\nธัญญาหาร\nธันยา\nธันยาวาท\nธันวาคม\nธัมมะ\nธาดา\nธาตรี\nธาตวากร\nธาตุ\nธาตุโขภ\nธาตุมมิสสา\nธานิน\nธานินทร์\nธานี\nธาร\nธารกำนัล\nธารคำนัล\nธารณะ\nธารณา\nธารา\nธาษตรี\nธำมรงค์\nธำรง\nธิดา\nธิติ\nธีระ\nธุช\nธุดงค์\nธุดงควัตร\nธุต\nธุตตะ\nธุมเกตุ\nธุมา\nธุรการ\nธุรกิจ\nธุระ\nธุรำ\nธุลี\nธุวดารา\nธุวภาค\nธุวมณฑล\nธูป\nเธนุ\nเธอ\nเธียร\nโธ่\nโธวนะ\nนก\nนกุล\nนขลิขิต\nนขะ\nนขา\nนเคนทร์\nนโคทร\nนคร\nนครินทร์\nนคเรศ\nนง\nนงคุฐ\nนที\nนนตรา\nนนท์\nนันทน์\nนนทรี\nนนทลี\nนนทิ\nนบ\nนปุงสกลิงค์\nนปุงสกลึงค์\nนพ\nนพนิต\nนภจร\nนภดล\nนภศูล\nนภา\nนภาลัย\nนม\nนมตำเรีย\nนมตำเลีย\nนมะ\nนมัสการ\nนมาซ\nนยนะ\nนยนา\nนโยบาย\nนรชาติ\nนรเทพ\nนรนาถ\nนรบดี\nนรบาล\nนรสิงห์\nนรสีห์\nนรา\nนรากร\nนราธิป\nนรินทร์\nนริศ\nนริศร\nนริศวร\nนเรศ\nนเรศวร\nนเรศวร์\nนโรดม\nนรก\nนรกานต์\nนรการ\nนรี\nนฤเทพ\nนฤบดี\nนฤบาล\nนฤเบศ\nนฤปเวศม์\nนฤปัตนี\nนฤคหิต\nนฤนาท\nนฤมล\nนฤตย์\nนฤตยสถาน\nนฤพาน\nนฤมาณ\nนฤมิต\nนลาฏ\nนลิน\nนลินี\nนวกรรม\nนวการ\nนวกิจ\nนวนิยาย\nนวปฎล\nนวรัตน์\nนวโลหะ\nนวกะ\nนวโกวาท\nนวด\nนวม\nน่วม\nนวมี\nนวย\nนวล\nนวัตกรรม\nนวาระ\nนหารุ\nนหุต\nนฬการ\nนอ\nนอก\nนอง\nน่อง\nน้อง\nน่องแน่ง\nนอต\nนอน\nนอบ\nน้อม\nน้อย\nน้อยหน่า\nน้อยโหน่ง\nนะ\nนะแน่ง\nนัก\nนักขัต\nนักขัตฤกษ์\nนักษัตร\nนักสราช\nนัข\nนั่ง\nนังคัล\nนัจ\nนัฑ\nนัด\nนัดดา\nนัตถุ์\nนั่น\nนั้น\nนันททายี\nนันทนาการ\nนันทวัน\nนันทิ\nนับ\nนัย\nนัยน์\nนัยนา\nนัว\nนัวเนีย\nนา\nน่า\nน้า\nนาก\nนากบุด\nนากาสาหรี\nนาค\nนาคร\nนาคา\nนาคาวโลก\nนาคินทร์\nนาคี\nนาเคนทร์\nนาเคศวร\nนาง\nนางเกล็ด\nนางนวล\nนางนูน\nนางรม\nนางรำ\nนางล้อม\nนางเล็ด\nนางเลิ้ง\nนางหงส์\nนางอาย\nนางแอ่น\nนาฏ\nนาฏกะ\nนาด\nนาถ\nนาท\nนาที\nนาน\nน่าน\nนานัครส\nนานัปการ\nนานา\nนาเนก\nนาบ\nนาภี\nนาม\nนามานุกรม\nนามาภิไธย\nนาย\nน่าย\nนายก\nนายิกา\nนารา\nนารายณ์\nนารี\nนาเรศ\nนาลิวัน\nนาว\nน้าว\nนาวา\nนาวิก\nนาวิน\nนาวี\nนาเวศ\nนาศ\nนาสา\nนาสิก\nนาฬิกา\nนาฬิเก\nนาฬี\nนำ\nน้ำ\nน้ำละว้า\nน้ำว้า\nนิ\nนิกเกิล\nนิกขะ\nนิกร\nนิกรอยด์\nนิกาย\nนิคม\nนิครนถ์\nนิคหกรรม\nนิคหะ\nนิคหิต\nนิคาลัย\nนิเคราะห์\nนิโคติน\nนิโครธ\nนิโครม\nนิ่ง\nนิจ\nนิด\nนิตย์\nนิตยทาน\nนิตยภัต\nนิตยสาร\nนิติ\nนิทร\nนิทรรศการ\nนิทรา\nนิทรารมณ์\nนิทัศน์\nนิทาน\nนิเทศ\nนิธาน\nนิธิ\nนินทา\nนินนาท\nนินาท\nนิบาต\nนิปริยาย\nนิปัจการ\nนิพจน์\nนิพนธ์\nนิพพาน\nนิพพิทา\nนิพัทธ์\nนิพันธ์\nนิพิท\nนิเพท\nนิภา\nนิ่ม\nนิ้ม\nนิมนต์\nนิมมาน\nนิมมานรดี\nนิมิต\nนิยต\nนิยม\nนิยัตินิยม\nนิยาม\nนิยาย\nนิยุต\nนิรคุณ\nนิรชร\nนิรชรา\nนิรทุกข์\nนิรเทศ\nนิรโทษ\nนิรโทษกรรม\nนิรนัย\nนิรนาม\nนิรภัย\nนิรมล\nนิรมาน\nนิรัตศัย\nนิรันดร\nนิราพาธ\nนิรามัย\nนิรามิษ\nนิราศรัย\nนิรินธน์\nนิรมาณ\nนิรมิต\nนิรยบาล\nนิรัพพุท\nนิรา\nนิราศ\nนิรุกติ\nนิรุตติ\nนิรุทธ์\nนิโรธ\nนิล\nนิลุบล\nนิโลบล\nนิ่ว\nนิ้ว\nนิวคลิอิก\nนิวเคลียร์\nนิวเคลียส\nนิวตรอน\nนิวรณ์\nนิวัต\nนิวัตน์\nนิวาต\nนิวาส\nนิเวศ\nนิเวศน์\nนิศา\nนิษาท\nนิสัช\nนิสัชชาการ\nนิสัย\nนิสาท\nนิสิต\nนิสีทนสันถัต\nนิสีทนะ\nนิสีทนาการ\nนิเสธ\nนี่\nนี้\nนี่นัน\nนีรนาท\nนีออน\nนีโอดิเมียม\nนึก\nนึง\nนึ่ง\nนุง\nนุ่ง\nนุงนัง\nนุช\nนุต\nนุ่น\nนุ่ม\nนุ้ย\nนูน\nนู่น\nนู้น\nเนกขัม\nเนตบอล\nเนตร\nเนติ\nเน้น\nเนบิวลา\nเนปจูน\nเนปทูเนียม\nเนมิ\nเนย\nเนรกัณฐี\nเนรคุณ\nเนรเทศ\nเนรนาด\nเนรมิต\nเนระพูสี\nเนอ\nเน้อ\nเนา\nเน่า\nเนาวนิต\nเนาวรัตน์\nเนิน\nเนิ่น\nเนิบ\nเนียง\nเนียน\nเนียม\nเนียร\nเนียรทุกข์\nเนียรเทศ\nเนียรนาท\nเนื้อ\nเนือง\nเนื่อง\nเนือย\nแน่\nแน่ง\nแน่น\nแนบ\nแน่บ\nแนม\nแนว\nแน่ว\nแนะ\nแน่ะ\nแนะแหน\nโน\nโน้ต\nโนน\nโน่น\nโน้น\nโนเบเลียม\nโน้ม\nโนมพรรณ\nโนรา\nโนรี\nใน\nไน\nไนต์คลับ\nไนโตรเจน\nไนลอน\nไนโอเบียม\nบ่\nบก\nบง\nบ่ง\nบงก์\nบ๊งเบ๊ง\nบงสุ์\nบด\nบดินทร์\nบดี\nบถ\nบท\nบน\nบ่น\nบพิตร\nบพิธ\nบ่ม\nบรม\nบรมัตถ์\nบรรจง\nบรรจถรณ์\nบรรจบ\nบรรจวบ\nบรรจุ\nบรรเจิด\nบรรณ\nบรรดา\nบรรตานึก\nบรรถร\nบรรทม\nบรรทัด\nบรรทาน\nบรรทุก\nบรรเทา\nบรรเทือง\nบรรพ\nบรรพ์\nบรรพชา\nบรรพชิต\nบรรพต\nบรรยง\nบรรยงก์\nบรรยเวกษก์\nบรรยากาศ\nบรรยาย\nบรรลัย\nบรรลาย\nบรรลุ\nบรรเลง\nบรรโลม\nบรรษัท\nบรรสบ\nบรรสพ\nบรรสม\nบรรสาน\nบรรสาร\nบรรหาน\nบรรหาร\nบรอนซ์\nบรั่นดี\nบรัศว์\nบราลี\nบริกรรม\nบริการ\nบริขาร\nบริขารโจล\nบริคณห์\nบริจาค\nบริจาริกา\nบริเฉท\nบริชน\nบริดจ์\nบริบท\nบริบาล\nบริบูรณ์\nบริพนธ์\nบริพัตร\nบริพันธ์\nบริพาชก\nบริพาร\nบริภัณฑ์\nบริภาษ\nบริโภค\nบริมาส\nบริยาย\nบริรม\nบริรักษ์\nบริราช\nบริวรรต\nบริวาร\nบริวาส\nบริเวณ\nบริษัท\nบริสชน\nบริสุทธิ์\nบริหาร\nบล็อก\nบวก\nบวง\nบ่วง\nบวช\nบวน\nบ้วน\nบวบ\nบวม\nบ๊วย\nบวร\nบหลิ่ม\nบอ\nบ่อ\nบ้อ\nบอก\nบอง\nบ่อง\nบ้อง\nบ๊อง\nบ้องแบ๊ว\nบองหลา\nบอด\nบอน\nบ่อน\nบอบ\nบ้อม\nบ๋อม\nบ่อย\nบอระเพ็ด\nบอล\nบอลลูน\nบ้อหุ้น\nบ๊ะ\nบ๊ะจ่าง\nบะหมี่\nบัก\nบักโกรก\nบัคเตรี\nบัง\nบั้ง\nบังกะโล\nบังเกิด\nบังคน\nบังคม\nบังคล\nบังควร\nบังคับ\nบังคัล\nบังแทรก\nบังวาย\nบังเวียน\nบังสุกุล\nบังสุกูลิก\nบังสูรย์\nบังหวน\nบังเหตุ\nบังเหียน\nบังอร\nบังอวจ\nบังอาจ\nบังเอิญ\nบัญจก\nบัญชร\nบัญชา\nบัญชี\nบัญญัติ\nบัญหา\nบัฏ\nบัณฑร\nบัณฑิต\nบัณฑิตย์\nบัณฑุ\nบัณฑูร\nบัณเฑาะก์\nบัณเฑาะว์\nบัณณาส\nบัณรส\nบัณรสี\nบัด\nบัดกรี\nบัดซบ\nบัดสี\nบัตร\nบัทม์\nบัน\nบั่น\nบั้น\nบันจวบ\nบันดล\nบันดาล\nบันได\nบันทึก\nบันทึง\nบันเทิง\nบันยะบันยัง\nบันลือ\nบัปผาสะ\nบัพ\nบัพชา\nบัพพาชนียกรรม\nบัล\nบัลลพ\nบัลลังก์\nบัลลูน\nบัลเลต์\nบัว\nบา\nบ่า\nบ้า\nบาก\nบาง\nบ่าง\nบ้าง\nบาจรีย์\nบาซิลลัส\nบาด\nบาดทะจิต\nบาดทะพิษ\nบาดทะยัก\nบาดาล\nบาตร\nบาท\nบาทสกุณี\nบาทหลวง\nบาทาธึก\nบาทุกา\nบาน\nบ้าน\nบานชื่น\nบานเช้า\nบานบุรี\nบานไม่รู้โรย\nบานเย็น\nบ้าบ๋า\nบาป\nบาย\nบ่าย\nบ้าย\nบาร์\nบารนี\nบารมี\nบาร์เรล\nบาร์เลย์\nบารอมิเตอร์\nบ้าระบุ่น\nบาเรียน\nบาเรียม\nบาล\nบาลี\nบ่าว\nบ่าวขุน\nบาศ\nบาศก์\nบาสเกตบอล\nบาหลี\nบ๋ำ\nบำเทิง\nบำนาญ\nบำบวง\nบำบัด\nบำเพ็ญ\nบำราบ\nบำราศ\nบำรุง\nบำรู\nบำเรอ\nบำหยัด\nบำเหน็จ\nบิ\nบิฐ\nบิณฑบาต\nบิด\nบิดร\nบิดหล่า\nบิดา\nบิตุ\nบิตุจฉา\nบิตุรงค์\nบิตุเรศ\nบิตุลา\nบิน\nบิ่น\nบินยา\nบิลเลียด\nบิวเรตต์\nบิสมัท\nบี้\nบีฑา\nบีตา\nบีบ\nบีเยศ\nบึก\nบึกบึน\nบึง\nบึ่ง\nบึ้ง\nบุ\nบุก\nบุคคล\nบุคลากร\nบุคลาธิษฐาน\nบุคลิก\nบุง\nบุ่ง\nบุ้ง\nบุ้งกี๋\nบุญ\nบุญญาธิการ\nบุญญานุภาพ\nบุญญาภินิหาร\nบุญญาภิสังขาร\nบุณฑริก\nบุณมี\nบุณย์\nบุตร\nบุตรี\nบุถุชน\nบุทคล\nบุนนาค\nบุบ\nบุบบิบ\nบุปผชาติ\nบุพกรรม\nบุพการี\nบุพกิจ\nบุพชาติ\nบุพทักษิณ\nบุพนิมิต\nบุพบท\nบุพพาจารย์\nบุพเพสันนิวาส\nบุพโพ\nบุ๋ม\nบุ่มบ่าม\nบุ้ย\nบุรณะ\nบุรพทิศ\nบุรพบท\nบุรพาจารย์\nบูรพาจารย์\nบุระ\nบุราณ\nบุรินทร์\nบุริมทิศ\nบุริมพรรษา\nบุริมสิทธิ\nบุรี\nบุรุษ\nบุโรทั่ง\nบุษกร\nบุษบก\nบุษบง\nบุษบัน\nบุษบา\nบุษบามินตรา\nบุษปราค\nบุษปะ\nบุษย์\nบุษย์น้ำทอง\nบุษยมาส\nบุษยะ\nบุษราคัม\nบุหงัน\nบุหงา\nบุหรง\nบุหรี่\nบุหลัน\nบู่\nบู้\nบูชนียสถาน\nบูชา\nบูชิต\nบูด\nบูดู\nบูร\nบูรณ์\nบูรณภาพ\nบูรณมี\nบูรณะ\nบูรณาการ\nบูรพ์\nบูรพะ\nบูรพา\nเบ้\nเบ่ง\nเบ๊จี๋\nเบญกานี\nเบญจกัลยาณี\nเบญจกามคุณ\nเบญจขันธ์\nเบญจดุริยางค์\nเบญจธรรม\nเบญจบรรพต\nเบญจพรรณ\nเบญจเพส\nเบญจมาศ\nเบญจรงค์\nเบญจศก\nเบญจศีล\nเบญจะ\nเบญจา\nเบญจางค์\nเบญจางคประดิษฐ์\nเบญญา\nเบญพาด\nเบ็ด\nเบ็ดเตล็ด\nเบ็ดเสร็จ\nเบน\nเบนซิน\nเบรก\nเบริลเลียม\nเบส\nเบ้อ\nเบอร์\nเบอร์คีเลียม\nเบ้อเร่อ\nเบ้อเร่อเท่อ\nเบ้อเริ่ม\nเบ้อเริ่มเทิ่ม\nเบอะ\nเบอะบะ\nเบะ\nเบา\nเบ้า\nเบาราณ\nเบาะ\nเบิก\nเบิ่ง\nเบี้ย\nเบี่ยง\nเบียด\nเบียน\nเบียร์\nเบี้ยว\nเบือ\nเบื่อ\nเบื้อ\nเบื้อง\nเบือน\nแบ\nแบ้\nแบก\nแบคทีเรีย\nแบ่ง\nแบงก์\nแบดมินตัน\nแบตเตอรี่\nแบน\nแบนโจ\nแบบ\nแบ็บ\nแบเรียม\nแบหลา\nแบะ\nโบ\nโบ้\nโบ๋\nโบก\nโบกขรณี\nโบกขรพรรษ\nโบชุก\nโบต\nโบนัส\nโบ๊เบ๊\nโบย\nโบรมีน\nโบรอน\nโบราณ\nโบสถ์\nใบ\nใบ้\nไบ่\nปก\nปกติ\nปกรณ์\nปกรณัม\nปกิณกะ\nปกีรณัม\nปโกฏิ\nปง\nป่ง\nปงช้าง\nปฎล\nปฏัก\nปฏิกรณ์\nปฏิกรรม\nปฏิการะ\nปฏิกิริยา\nปฏิกูล\nปฏิคม\nปฏิคหิต\nปฏิคาหก\nปฏิฆะ\nปฏิชีวนะ\nปฏิญญา\nปฏิญาณ\nปฏิทิน\nปฏิบถ\nปฏิบัติ\nปฏิปทา\nปฏิปักษ์\nปฏิปัน\nปฏิปุจฉาพยากรณ์\nปฏิปุจฉาวาที\nปฏิพัทธ์\nปฏิพากย์\nปฏิภาค\nปฏิภาณ\nปฏิมา\nปฏิมากร\nปฏิยุทธ์\nปฏิรพ\nปฏิรูป\nปฏิโลม\nปฏิวัติ\nปฏิวาต\nปฏิวาท\nปฏิเวธ\nปฏิสนธิ\nปฏิสวะ\nปฏิสังขรณ์\nปฏิสันถาร\nปฏิสัมภิทา\nปฏิเสธ\nปฐพี\nปฐม\nปฐวี\nปณต\nปณาม\nปณิธาน\nปณิธิ\nปณีต\nปด\nปดิวรัดา\nปติ\nปถพี\nปถมัง\nปถวี\nปทัฏฐาน\nปทัสถาน\nปทานุกรม\nปทีป\nปทุม\nปน\nป่น\nปนัดดา\nปปัญจะ\nปม\nปรนัย\nปรปักษ์\nปรโลก\nปรวาที\nปรก\nปรกติ\nปรง\nปรตยักษ์\nปรน\nปรนนิบัติ\nปรนิมมิตวสวัตดี\nปรบ\nปรปักษ์\nปรมัตถ์\nปรมาจารย์\nปรมาณู\nปรมาภิไธย\nปรมาภิเษก\nปรมินทร์\nบรเมนทร์\nปรเมศวร์\nปรเมษฐ์\nปรวด\nปรวนแปร\nปรศุ\nปรสิต\nปร๋อ\nปรองดอง\nปรอด\nปรอท\nปรอย\nประ\nประกบ\nประกฤต\nประกฤติ\nประกล\nประกวด\nประกวดประขัน\nประกอบ\nประกัน\nประกับ\nประกาย\nประกายพรึก\nประการ\nประกาศ\nประกาศนียบัตร\nประกาศิต\nประกำ\nประกิด\nประกิต\nประคด\nประคนธรรพ\nประคนธรรพ์\nประคบ\nประคบประหงม\nประคอง\nประคับประคอง\nประคัลภ์\nประคำ\nประคิ่น\nประคุณ\nประเคน\nประเคราะห์\nประโคน\nประโคนธรรพ\nประโคนธรรพ์\nประโคม\nประจง\nประจญ\nประจบ\nประจบประแจง\nประจวบ\nประจ๋อประแจ๋\nประจักษ์\nประจักษนิยม\nประจัญ\nประจัน\nประจาก\nประจาค\nประจาน\nประจำ\nประจิม\nประจิ้มประเจ๋อ\nประจุ\nประจุคมน์\nประจุบัน\nประเจก\nประเจิด\nประเจิดประเจ้อ\nประเจียด\nประแจ\nประชด\nประชน\nประชวม\nประชวร\nประชัน\nประชา\nประชาธิปไตย\nประชิด\nประชี\nประชุม\nประเชิญ\nประณต\nประณม\nประณาม\nประณิธาน\nประณิธิ\nประณีต\nประณุท\nประดง\nประดน\nประดวน\nประดอน\nประดอย\nประดัก\nประดักประเดิด\nประดัง\nประดับ\nประดา\nประดาก\nประดาป\nประดาษ\nประดิชญา\nประดิดประดอย\nประดิทิน\nประดิษฐ์\nประดิษฐกรรม\nประดิษฐาน\nประดุง\nประดุจ\nประดู่\nประเด\nประเด็น\nประเดิม\nประเดียง\nประเดี๋ยว\nประเดี๋ยวประด๋าว\nประแดง\nประแดะ\nประโดง\nประโดย\nประตง\nประตัก\nประตาป\nประติชญา\nประติญาณ\nประติทิน\nประติมากร\nประติมากรรม\nประติรพ\nประตู\nประถม\nประถมจินดา\nประทม\nประท้วง\nประทวน\nประทักษ์\nประทักษิณ\nประทัง\nประทัด\nประทับ\nประทาน\nประทาย\nประทาศี\nประทิน\nประทิ่น\nประทีป\nประทุฐ\nประทุน\nประทุษ\nประทุษฐ์\nประเทศ\nประเทา\nประเทียด\nประเทียบ\nประเทือง\nประธาน\nประธานาธิบดี\nประนม\nประนอ\nประนอม\nประนัง\nประนัปดา\nประนีประนอม\nประปราน\nประปราย\nประปา\nประเปรี้ยง\nประเปรียว\nประพจน์\nประพนธ์\nประพรม\nประพฤติ\nประพฤทธิ์\nประพัด\nประพัทธ์\nประพันธ์\nประพาต\nประพาส\nประพาสมหรณพ\nประพาฬ\nประพิณ\nประพิมพ์ประพาย\nประพุทธ์\nประเพณี\nประโพธ\nประไพ\nประไพร\nประภพ\nประภัสสร\nประภา\nประภาคาร\nประภาพ\nประภาษ\nประภาส\nประเภท\nประมง\nประมวล\nประมาณ\nประมาท\nประมุข\nประมุท\nประมูล\nประเมิน\nประโมง\nประโมทย์\nประยงค์\nประยุกต์\nประยุทธ์\nประยุร\nประยูร\nประโยค\nประโยชน์\nประโรหิต\nประลมพ์\nประลอง\nประลัย\nประลาต\nประลาย\nประลุ\nประเล่ห์\nประเล้าประโลม\nประโลม\nประวรรต\nประวรรตน์\nประวัติ\nประวาล\nประวาลปัทม์\nประวาส\nประวิง\nประวิช\nประวิตร\nประวิน\nประวีณ\nประเวณี\nประเวศ\nประเวศน์\nประศม\nประศาสน์\nประศุ\nประสก\nประสงค์\nประสบ\nประสพ\nประสม\nประสะ\nประสัก\nประสันนาการ\nประสัยห์\nประสา\nประสาท\nประสาธน์\nประสาน\nประสาร\nประสิทธิ์\nประสิทธิผล\nประสิทธิภาพ\nประสีประสา\nประสูต\nประสูติ\nประเสบัน\nประเสบันอากง\nประเสริฐ\nประหนึ่ง\nประหม่า\nประหยัด\nประหลาด\nประหล่ำ\nประหวัด\nประหวั่น\nประหัตประหาร\nประหาณ\nประหาร\nประเหล\nประเหส\nประไหมสุหรี\nประอบ\nประอร\nปรัก\nปรักปรำ\nปรักมะ\nปรัง\nปรัชญา\nปรัตถจริยา\nปรัตยุบัน\nปรัน\nปรับ\nปรัมปรา\nปรัศจิม\nปรัศนา\nปรัศนี\nปรัศว์\nปรัสสบท\nปร่า\nปรากฏ\nปรากรม\nปรากฤต\nปราการ\nปราง\nปรางค์\nปราจีน\nปราชญ์\nปราชญา\nปราชัย\nปราณ\nปราณี\nปราด\nปราน\nปรานี\nปราบ\nปราบดาภิเษก\nปราปต์\nปราม\nปรามาส\nปราโมช\nปราโมทย์\nปราย\nปรารถนา\nปรารภ\nปรารมภ์\nปราศ\nปราศจาก\nปราศรัย\nปราษณี\nปราษาณ\nปราสัย\nปราสาท\nปรำ\nปริ\nปริก\nปริกขาร\nปริกรรม\nปริกัป\nปริคณห์\nปริจาค\nปริจาริกา\nปริเฉท\nปริชน\nปริซึม\nปริญญา\nปริณาม\nปริณายก\nปริต\nปริตตะ\nปริตโตทก\nปริตร\nปริทรรศน์\nปริทัยหัคคี\nปริทัศน์\nปริเทพ\nปริเทวะ\nปรินิพพาน\nปริบ\nปริบท\nปริปันถ์\nปริพนธ์\nปริพัตร\nปริพันธ์\nปริพาชก\nปริภัณฑ์\nปริภาษ\nปริภูมิ\nปริโภค\nปริ่ม\nปริมณฑล\nปริมาณ\nปริมาตร\nปริยัติ\nปริยานุช\nปริยาย\nปริเยศ\nปริโยสาน\nปริวรรต\nปริวัตร\nปริวาร\nปริวาส\nปริวิตก\nปริเวณ\nปริศนา\nปริษัท\nปริสัญญู\nปริสุทธิ\nปริหาน\nปริหาร\nปรี่\nปรีชญา\nปรีชา\nปรี๊ด\nปรีดา\nปรีดิ\nปรีดิ์\nปรีดี\nปรีติ\nปรียะ\nปรียา\nปรึก\nปรึกษา\nปรึง\nปรือ\nปรื๋อ\nปรุ\nปรุง\nปรู\nปรู๋\nปรูด\nปรู๊ด\nปรู๊ดปร๊าด\nปรู๊ฟ\nปฤงคพ\nปฤจฉา\nปฤษฎางค์\nปฤษฐ\nปลก\nปลกเปลี้ย\nปลง\nปล่ง\nปลด\nปล้น\nปลวก\nปลอก\nปล่อง\nปล้อง\nปลอด\nปล้อน\nปลอบ\nปลอม\nปล่อย\nปละ\nปลัก\nปลั๊ก\nปลัง\nปลั่ง\nปลัด\nปลัดขิก\nปลา\nปลาต\nปลาบ\nปลาย\nปลาสเตอร์\nปลาสนาการ\nปล้ำ\nปลิง\nปลิด\nปลิ้น\nปลิโพธ\nปลิม\nปลิ่ม\nปลิว\nปลี\nปลีก\nปลื้ม\nปลุก\nปลูก\nปวกเปียก\nปวง\nป่วง\nปวด\nป่วน\nป้วน\nป้วนเปี้ยน\nป่วย\nปวัตน์\nปวารณา\nปวาล\nปวาส\nปวาฬ\nปวิช\nปวิตร\nปวิธ\nปวิเวก\nปวีณ\nปวุติ\nปเวณี\nปเวส\nปเวสน์\nปศุ\nปสันนะ\nปสันนาการ\nปสาท\nปสาน\nปสาสน์\nปสุ\nปสุต\nปสูติ\nปหังสนะ\nปหาน\nปหาร\nปหาส\nปอ\nป้อ\nป๋อ\nปอก\nปอง\nป่อง\nป้อง\nปอด\nปอน\nป้อน\nปอนด์\nปอเนาะ\nปอบ\nป้อแป้\nปอม\nป้อม\nป๋อม\nปอย\nป้อย\nป้อยอ\nปะ\nปะกน\nปะกัง\nปะการัง\nปะกำ\nปะขาว\nปะงาบ\nปะตาปา\nปะตาระกาหลา\nปะติดปะต่อ\nปะติยาน\nปะทะ\nปะทะปะทัง\nปะทุ\nปะทุน\nปะปน\nปะมง\nปะราลี\nปะรำ\nปะไร\nปะลอม\nปะเลง\nปะแล่ม\nปะโลง\nปะวะหล่ำ\nปะหงับ\nปะหนัน\nปะหัง\nปะเหลาะ\nปัก\nปักข์\nปักเป้า\nปักษ์\nปักษา\nปักษิน\nปักษี\nปัง\nปั๋ง\nปังสุ์\nปังสุกุล\nปัจจัตตะ\nปัจจันต์\nปัจจันตคาม\nปัจจันตชนบท\nปัจจันตประเทศ\nปัจจัย\nปัจจามิตร\nปัจจุคมน์\nปัจจุทธรณ์\nปัจจุบัน\nปัจจุสมัย\nปัจเจก\nปัจโจปการกิจ\nปัจฉา\nปัจฉิม\nปัจถรณ์\nปัจนึก\nปัจยาการ\nปัจเวกขณ์\nปัชชุน\nปัญจนที\nปัญจวัคคีย์\nปัญจก\nปัญจกะ\nปัญจมี\nปัญจวีสติ\nปัญญัติ\nปัญญา\nปัญหา\nปัฏ\nปัฏนะ\nปัฐยาวัต\nปัณฑรหัตถี\nปัณณะ\nปัณณาส\nปัณณาสก์\nปัณรสี\nปัณหิ\nปัด\nปัตคาด\nปัตตะ\nปัตตานึก\nปัตตานุโมทนา\nปัตตาเวีย\nปัตติ\nปัตติก\nปัตถร\nปัตถะ\nปัตนิ\nปัตนี\nปัตหล่า\nปัถพี\nปัถวี\nปัทม์\nปัทมะ\nปัทมาสน์\nปัน\nปั่น\nปั้น\nปั้นจั่น\nปันจุเหร็จ\nปั้นลม\nปั้นหยา\nปั้นเหน่ง\nปับ\nปั๊บ\nปัปผาสะ\nปัพพาชนียกรรม\nปัพภาระ\nปั๊ม\nปัยกา\nปัยยิกา\nปัวเปีย\nปัศจิม\nปัศตัน\nปัสสาวะ\nปัสสาสะ\nปา\nป่า\nป้า\nปาก\nปาง\nป้าง\nปาจรีย์\nปาจิตตีย์\nปาจีน\nปาฏลิ\nปาฏิบท\nปาฏิบุคลิก\nปาฏิโภค\nปาฏิหาริย์\nปาฐก\nปาฐกถา\nปาฐะ\nปาณกชาติ\nปาณะ\nปาณาติบาต\nปาณิ\nปาณี\nปาด\nปาติโมกข์\nปาตี\nปาเต๊ะ\nปาท่องโก๋\nปาทังกา\nปาทาน\nปาทุกา\nปาน\nป่าน\nป้าน\nปานะ\nปานียะ\nป้าบ\nป๊าบ\nปาพจน์\nปาม\nปาโมกข์\nป่าย\nป้าย\nปายาส\nปาร์เกต์\nปารมี\nปารเมศ\nปาราชิก\nปาริฉัตร\nปาริชาต\nปารุสกวัน\nปาล\nปาล์ม\nปาลิไลยก์\nปาลี\nปาว\nป่าว\nป๊าว\nปาวาร\nปาษาณ\nปาส\nปาสาณ\nปาสาทิกะ\nปาหนัน\nปาหี่\nปำ\nป้ำ\nป้ำเป๋อ\nปิกนิก\nปิ้ง\nปิงคละ\nปิงปอง\nปิฎก\nปิฏฐะ\nปิฐิ\nปิณฑะ\nปิด\nปิตตะ\nปิตา\nปิตามหัยกา\nปิตามหัยยิกา\nปิตุ\nปิตุจฉา\nปิตุภูมิ\nปิตุลา\nปิโตรเลียม\nปิ่น\nปิ่นแก้ว\nปิ่นโต\nปิปผลี\nปิ่ม\nปิ้ม\nปิยะ\nปิยังคุ\nปิโยรส\nปิลันธน์\nปิ๋ว\nปิศาจ\nปิหกะ\nปี\nปี่\nปี้\nปี๋\nปีก\nปีฐะ\nปี๊ด\nปีติ\nปีน\nปีบ\nปี๊บ\nปีศาจ\nปีฬกะ\nปึก\nปึง\nปึ่ง\nปึ๋ง\nปึ้ด\nปึมปื้อ\nปืน\nปื้น\nปือ\nปื้อ\nปื๋อ\nปุ\nปุ๊\nปุก\nปุกปุย\nปุคละ\nปุ้งกี๋\nปุงควะ\nปุงลิงค์\nปุงลึงค์\nปุจฉา\nปุฏะ\nปุณฑริก\nปุด\nปุตตะ\nปุถุชน\nปุนนาค\nปุนภพ\nปุนัพสุ\nปุบ\nปุ๊บ\nปุปผะ\nปุปะ\nปุพพะ\nปุ่ม\nปุ่มป่ำ\nปุ้ม\nปุ๋ม\nปุย\nปุ้ย\nปุ๋ย\nปุรณะ\nปุระ\nปุราณ\nปุราณะ\nปุริมพรรษา\nปุเรจาริก\nปุโรหิต\nปุลลิงค์\nปุลลึงค์\nปุลินท์\nปุโลปุเล\nปุษยะ\nปุสสะ\nปู\nปู่\nปูชกะ\nปูชนียบุคคล\nปูชนียวัตถุ\nปูชนียะ\nปูชา\nปูชิต\nปูด\nปูน\nปูม\nปู้ยี่ปู้ยำ\nปูระ\nปูลู\nเป้\nเป๋\nเปก\nเป๊ก\nเป่ง\nเป้ง\nเป๋ง\nเป็ด\nเปตพลี\nเปตอง\nเป็น\nเปยยาล\nเปร็ง\nเปรต\nเปรม\nเปรย\nเปรอ\nเปรอะ\nเปราะ\nเปรียง\nเปรี้ยง\nเปรี้ยงปร้าง\nเปรียญ\nเปรียบ\nเปรี่ยม\nเปรียว\nเปรี้ยว\nเปรียะ\nเปรี๊ยะ\nเปรื่อง\nเปรื้อย\nเปล\nเปล่ง\nเปลว\nเปลา\nเปล่า\nเปล้า\nเปลาะ\nเปลี้ย\nเปลี่ยน\nเปลี่ยม\nเปลี่ยว\nเปลือก\nเปลือง\nเปลื้อง\nเปลือย\nเปศะ\nเปศัส\nเปสการ\nเปสละ\nเปสุญวาท\nเป๋อ\nเป้อเย้อ\nเปอร์\nเปอร์เซ็นต์\nเปะ\nเปา\nเป่า\nเป้า\nเป๊า\nเป๋า\nเป๋าฮื้อ\nเปาะ\nเป๊าะ\nเปาะเปี๊ยะ\nเปาะแปะ\nเปิก\nเปิง\nเปิงมาง\nเปิด\nเปิ่น\nเปิบ\nเปิ๊บ\nเปีย\nเปียก\nเปี๊ยก\nเปี๊ยบ\nเปี่ยม\nเปี้ยว\nเปี๊ยว\nเปียะ\nเปี๊ยะ\nเปือก\nเปื้อน\nเปื่อย\nแป\nแป้ง\nแป๋ง\nแปด\nแป๊ด\nแปทู\nแป้น\nแป๊น\nแปบ\nแป๊บ\nแปม\nแปร\nแปร๋\nแปรก\nแปรง\nแปร่ง\nแปร๊ด\nแปร้น\nแปร๋น\nแปรปรวน\nแประ\nแปล\nแปล้\nแปลก\nแปลง\nแปลน\nแปลบ\nแปล๊บ\nแป้ว\nแป๊ว\nแปะ\nแป๊ะ\nแป๊ะซะ\nโป\nโป่\nโป้\nโป๊\nโปก\nโป๊ก\nโป๊กเกอร์\nโปกขรณี\nโปกขรพรรษ\nโปเก\nโปง\nโป่ง\nโป้ง\nโป่งข่าม\nโปงลาง\nโป่งวิด\nโปฐบท\nโปฐปทมาส\nโปดก\nโปตถกะ\nโปน\nโป๊ป\nโป๊ยเซียน\nโปรแกรม\nโปรง\nโปร่ง\nโปรด\nโปรตอน\nโปรตีน\nโปรเตสแตนต์\nโปรแทรกเตอร์\nโปรย\nโปล่ง\nโปลิโอ\nโปโล\nโปสก\nโปสต์การ์ด\nโปะ\nโป๊ะ\nโป๊ะจ้าย\nไป\nไป่\nไป๋\nไปยาล\nไปรษณีย์\nไปรษณียบัตร\nไปรษณียภัณฑ์\nไปรษณียากร\nไปล่\nไปศาจ\nผก\nผกา\nผกาย\nผคม\nผง\nผงก\nผงม\nผงะ\nผงาด\nผง่าน\nผจง\nผจญ\nผจัญ\nผจาน\nผชุม\nผณิน\nผณินทร\nผณิศวร\nผด\nผดุง\nผเดิน\nผทม\nผนวก\nผนวช\nผนัง\nผนิด\nผนึก\nผม\nผยอง\nผรณาปีติ\nผรสุ\nผริต\nผรุสวาท\nผล\nผลคุน\nผลคุนี\nผล็อย\nผละ\nผลัก\nผลัด\nผลับ\nผลัวะ\nผลา\nผลาญ\nผลานิสงส์\nผลาผล\nผลาหาร\nผลิ\nผลิกะ\nผลิต\nผลิน\nผลี\nผลีผลาม\nผลึก\nผลึ่ง\nผลือ\nผลุ\nผลุง\nผลุด\nผลุน\nผลุนผลัน\nผลุบ\nผลุบผลับ\nผลุย\nผลู\nผวน\nผวย\nผวา\nผสม\nผสาน\nผอง\nผ่อง\nผ่อน\nผอบ\nผอม\nผ็อย\nผอูน\nผะ\nผะดา\nผะสา\nผัก\nผัคคุณ\nผัคคุณี\nผัง\nผัด\nผัน\nผับ\nผัว\nผัวะ\nผัสสะ\nผัสสาหาร\nผา\nผ่า\nผ้า\nผาก\nผาง\nผ่าง\nผาณิต\nผาด\nผาติ\nผ่าน\nผาม\nผาย\nผ่ายผอม\nผาล\nผาลคุน\nผาลา\nผ่าว\nผาสุก\nผ้าฮาด\nผำ\nผ้ำ\nผิ\nผิง\nผิด\nผิตะ\nผิน\nผิว\nผี\nผี้ว์\nผึง\nผึ่ง\nผึ้ง\nผึ้งรวง\nผืน\nผื่น\nผุ\nผุด\nผุยผง\nผุสราคา\nผู้\nผูก\nเผ\nเผง\nเผชิญ\nเผ็ด\nเผด็จ\nเผดิม\nเผดียง\nเผ่น\nเผนิก\nเผย\nเผยอ\nเผยิบ\nเผยิบผยาบ\nเผล\nเผล่\nเผล็ด\nเผลอ\nเผลอไผล\nเผละ\nเผลาะ\nเผลาะแผละ\nเผลียง\nเผอเรอ\nเผอิญ\nเผอิล\nเผะ\nเผา\nเผ่า\nเผ้า\nเผาะ\nเผิ้ง\nเผิน\nเผียน\nเผือ\nเผื่อ\nเผือก\nเผือด\nเผือน\nเผื่อน\nแผ่\nแผก\nแผง\nแผด\nแผน\nแผ่น\nแผนก\nแผล\nแผลง\nแผล็บ\nแผล็ว\nแผละ\nแผ่ว\nแผ้ว\nโผ\nโผง\nโผฏฐัพพะ\nโผน\nโผเผ\nโผย\nโผล่\nโผลกเผลก\nโผละ\nโผอน\nโผะ\nไผ\nไผ่\nไผท\nฝน\nฝรั่ง\nฝรั่งเศส\nฝ่อ\nฝอย\nฝัก\nฝัง\nฝั่ง\nฝัด\nฝัน\nฝา\nฝ่า\nฝ้า\nฝาก\nฝาง\nฝาด\nฝาน\nฝาย\nฝ่าย\nฝ้าย\nฝิ่น\nฝี\nฝี่\nฝีก\nฝึก\nฝืด\nฝืน\nฝุ่น\nฝูง\nเฝ้า\nเฝือ\nเฝือก\nเฝือง\nเฝื่อน\nแฝก\nแฝง\nแฝด\nใฝ่\nไฝ\nพก\nพกุล\nพง\nพงศ์\nพงศกร\nพงศธร\nพงศา\nพงศาวดาร\nพจน์\nพจนา\nพจนานุกรม\nพจนารถ\nพจนีย์\nพจมาน\nพจี\nพชระ\nพญา\nพญาลอ\nพณิช\nพณิชย์\nพดด้วง\nพธู\nพนันดร\nพนาดร\nพนาดอน\nพนาราม\nพนาลัย\nพนาลี\nพนาวาส\nพนาเวศ\nพนาศรม\nพนาสณฑ์\nพนาสัณฑ์\nพเนจร\nพ่น\nพ้น\nพนม\nพนอง\nพนอม\nพนัก\nพนักงาน\nพนัง\nพนัน\nพนัส\nพนา\nพนาย\nพนิดา\nพนิต\nพบ\nพม่า\nพยนต์\nพยศ\nพยัก\nพยักพเยิด\nพยัคฆ์\nพยัคฆา\nพยัคฆิน\nพยัคฆี\nพยัชน์\nพยัญชนะ\nพยัต\nพยับ\nพยากรณ์\nพยาฆร์\nพยางค์\nพยาธิ\nพยาน\nพยาบาท\nพยาบาล\nพยาม\nพยามะ\nพยายาม\nพยุ\nพยุง\nพยุหยาตรา\nพยุหโยธา\nพยุหเสนา\nพยุหะ\nพยู่ห์\nพเยีย\nพร\nพรต\nพรม\nพรรค\nพรรค์\nพรรคานต์\nพรรณ\nพรรณนา\nพรรดึก\nพรรลาย\nพรรษ\nพรรษา\nพรรเอิญ\nพรวด\nพรวน\nพรหม\nพรหมจรรย์\nพรหมจาริณี\nพรหมจารี\nพรหมา\nพรหมาสตร์\nพรหมินทร์\nพรอก\nพร่อง\nพร้อง\nพรอด\nพร้อม\nพร้อมพรัก\nพร่อย\nพร้อย\nพระ\nพระนอม\nพระนาด\nพระฮาม\nพรักพร้อม\nพรั่ง\nพรัด\nพรั่น\nพรับ\nพร่า\nพร้า\nพราก\nพราง\nพร่าง\nพราด\nพราน\nพราย\nพราว\nพราหมณ์\nพราหมณะ\nพราหมณี\nพราหมี\nพรำ\nพร่ำ\nพริก\nพริ้ง\nพริบ\nพริ้ม\nพรึง\nพรึน\nพรึบ\nพรึ่บ\nพรืด\nพรุ\nพรุ่ง\nพรุน\nพรู\nพรูด\nพฤกษ์\nพฤกษชาติ\nพฤกษเทวดา\nพฤกษราช\nพฤกษศาสตร์\nพฤกษา\nพฤฒ\nพฤฒา\nพฤฒาจารย์\nพฤฒิ\nพฤต\nพฤติ\nพฤทธ์\nพฤทธิ์\nพฤนต์\nพฤนท์\nพฤศจิก\nพฤศจิกายน\nพฤษภ\nพฤษภาคม\nพฤหัสบดี\nพล\nพละ\nพลากร\nพลาดิศัย\nพลาธิการ\nพลานามัย\nพลบ\nพลวก\nพลวง\nพลวัต\nพลศาสตร์\nพลอ\nพล้อ\nพลอง\nพลอด\nพลอน\nพลอมแพลม\nพลอย\nพล่อย\nพลั่ก\nพลัง\nพลั่ง\nพลั้ง\nพลัด\nพลัน\nพลับ\nพลับพลา\nพลับพลึง\nพลั่ว\nพล่า\nพลาง\nพลาญ\nพลาด\nพล่าน\nพลาม\nพล่าม\nพลาย\nพลาสติก\nพลาสมา\nพลาหก\nพลำ\nพล้ำ\nพลำภัง\nพลิก\nพลิพัท\nพลิ้ว\nพลี\nพลุ\nพลุก\nพลุ่ก\nพลุกพล่าน\nพลุ่ง\nพลุ้ย\nพลู\nพลูโต\nพลูโทเนียม\nพวก\nพวง\nพ่วง\nพวน\nพวย\nพสก\nพสุ\nพสุธา\nพสุสงกรานต์\nพหล\nพหุ\nพหุล\nพหู\nพอ\nพ่อ\nพ้อ\nพอก\nพอง\nพ้อง\nพอน\nพ้อม\nพอโลเนียม\nพะ\nพะงา\nพะงาบ\nพะจง\nพะทำมะรง\nพะนอ\nพะเน้าพะนอ\nพะเนิน\nพะเนียง\nพะแนง\nพะพาน\nพะพิง\nพะเพิง\nพะยอม\nพ่ะย่ะค่ะ\nพะยูง\nพะยูน\nพะเยิบ\nพะเยิบพะยาบ\nพะรุงพะรัง\nพะโล้\nพะไล\nพะวง\nพะวักพะวน\nพะวา\nพะว้าพะวัง\nพะอง\nพะอากพะอำ\nพะอืดพะอม\nพัก\nพักตร์\nพักตรา\nพักร\nพัง\nพังกา\nพังงา\nพังผืด\nพังพวย\nพังพอน\nพังพาน\nพังพาบ\nพังเพย\nพัช\nพัชนี\nพัชระ\nพัญจน์\nพัฒนะ\nพัฒนา\nพัฒนากร\nพัฒนาการ\nพัด\nพัดชา\nพัดดึงส์\nพัตร\nพัทธ์\nพัทธยา\nพัทธสีมา\nพัทร\nพัน\nพันตู\nพันทาง\nพันธ์\nพันธะ\nพันธกรณี\nพันธบัตร\nพันธมิตร\nพันธนะ\nพันธนาคาร\nพันธนาการ\nพันธุ์\nพันธุกรรม\nพันลึก\nพันลือ\nพันเลิศ\nพันเอิญ\nพับ\nพัลลภ\nพัลวัน\nพัว\nพัวะ\nพัศดี\nพัสดุ\nพัสตร์\nพัสถาน\nพา\nพาก\nพากเพียร\nพากย์\nพาง\nพ่าง\nพาชี\nพาณิช\nพาณิชย์\nพาณิชยกรรม\nพาณิชยการ\nพาณิชยศาสตร์\nพาณิชยศิลป์\nพาณินี\nพาณี\nพาณีนี\nพาด\nพาท\nพาทย์\nพาธ\nพาธา\nพาน\nพ่าน\nพานร\nพานรินทร์\nพาม\nพาย\nพ่าย\nพายม้า\nพายัพ\nพายุ\nพาร์เซก\nพารณ\nพารา\nพาราฟิน\nพาล\nพาลา\nพาลี\nพาลุก\nพาโล\nพาไล\nพาส\nพาสน์\nพาสนา\nพาสุกรี\nพ่าห์\nพาหนะ\nพาหะ\nพาหา\nพาหิรกะ\nพาหิระ\nพาหุ\nพาหุรัด\nพาหุสัจจะ\nพาเหียร\nพาฬ\nพำ\nพำนัก\nพำพึม\nพำลา\nพิกล\nพิกสิต\nพิกัด\nพิกัติ\nพิกัน\nพิการ\nพิกุล\nพิเคราะห์\nพิฆน์\nพิฆเนศ\nพิฆเนศวร\nพิฆาต\nพิง\nพิจัย\nพิจาร\nพิจารณ์\nพิจารณา\nพิจิก\nพิจิต\nพิจิตร\nพิชญ์\nพิชัย\nพิชาน\nพิชิต\nพิเชฐ\nพิเชียร\nพิฑูรย์\nพิณ\nพิดทูล\nพิดาน\nพิโดร\nพิตร\nพิถี\nพิถีพิถัน\nพิทย\nพิทย์\nพิทยา\nพิทยาคม\nพิทยาคาร\nพิทยาธร\nพิทยาลัย\nพิทักษ์\nพิทูร\nพิเทศ\nพิธาน\nพิธี\nพิธุ\nพินทุ\nพินอบพิเทา\nพินัย\nพินาศ\nพินิจ\nพินิต\nพินิศ\nพินิศจัย\nพิเนต\nพิบัติ\nพิบุล\nพิบูล\nพิปริต\nพิปลาส\nพิพรรธ\nพิพรรธน์\nพิพักพิพ่วน\nพิพัฒ\nพิพัฒน์\nพิพากษ์\nพิพากษา\nพิพาท\nพิพิธ\nพิพิธภัณฑ์\nพิพิธภัณฑสถาน\nพิภพ\nพิภัช\nพิภาค\nพิภูษณะ\nพิเภก\nพิมปะการัง\nพิมพ์\nพิมพการัง\nพิมพา\nพิมพาภรณ์\nพิมล\nพิมเสน\nพิมาน\nพิมุข\nพิโมกข์\nพิโมกษ์\nพิโยกพิเกน\nพิโยค\nพิรอด\nพิระ\nพิรากล\nพิราบ\nพิราม\nพิราลัย\nพิริยะ\nพิรี้พิไร\nพิรุณ\nพิรุธ\nพิรุฬห์\nพิเรนทร์\nพิเราะ\nพิโรธ\nพิไร\nพิลังกาสา\nพิลาป\nพิลาส\nพิลิปดา\nพิลึก\nพิลึกกึกกือ\nพิลึกพิลั่น\nพิโลน\nพิไล\nพิศ\nพิศวง\nพิศวาส\nพิศาล\nพิศุทธ์\nพิศุทธิ์\nพิเศษ\nพิษ\nพิษฐาน\nพิษนาศน์\nพิสดาร\nพิสมร\nพิสมัย\nพิสัง\nพิสัช\nพิสัย\nพิสิฐ\nพิสุทธิ์\nพิสูจน์\nพิหค\nพิหาร\nพิฬาร\nพี\nพี่\nพี้\nพีชคณิต\nพีระมิด\nพึง\nพึ่ง\nพึ่บ\nพึ่บพั่บ\nพึม\nพึมพำ\nพืช\nพืด\nพื้น\nพุ\nพุก\nพุกาม\nพุง\nพุ่ง\nพุงดอ\nพุฒ\nพุฒิ\nพุด\nพุดตาน\nพุทธ\nพุทธะ\nพุทธังกูร\nพุทธางกูร\nพุทธันดร\nพุทธาภิเษก\nพุทธาวาส\nพุทธิ\nพุทโธ่\nพุทรา\nพุธ\nพุ่ม\nพุมเรียง\nพุ้ย\nพู\nพูพอน\nพู่\nพูด\nพูน\nพู้น\nพู่ระหง\nเพ\nเพ็ก\nเพกา\nเพคะ\nเพ็ง\nเพ่ง\nเพ็จ\nเพชฉลูกรรม\nเพชฌฆาต\nเพชร\nเพชรดา\nเพชรปาณี\nเพชรฤกษ์\nเพชรายุธ\nเพชรกลับ\nเพชรสังฆาต\nเพชรหลีก\nเพชรหึง\nเพ็ญ\nเพฑูริย์\nเพณี\nเพ็ดทูล\nเพดาน\nเพท\nเพทนา\nเพทาย\nเพทุบาย\nเพโทบาย\nเพ่นพ่าน\nเพนียด\nเพไนย\nเพ้ย\nเพรง\nเพรซีโอดิเมียม\nเพรา\nเพราะ\nเพริด\nเพริศ\nเพรียก\nเพรียง\nเพรียบ\nเพรี้ยม\nเพรียว\nเพรื่อ\nเพรือง\nเพล\nเพลง\nเพล็ด\nเพล้โพล้\nเพลา\nเพลาะ\nเพลิง\nเพลิดเพลิน\nเพลิน\nเพลีย\nเพลี้ย\nเพลี่ยง\nเพศ\nเพส\nเพสลาด\nเพ่อ\nเพ้อ\nเพ้อเจ้อ\nเพอิญ\nเพะ\nเพา\nเพาะ\nเพิก\nเพิง\nเพิ่ง\nเพิดเพ้ย\nเพิ่ม\nเพี้ย\nเพียง\nเพี้ยง\nเพียงออ\nเพี้ยน\nเพียบ\nเพียร\nเพื่อ\nเพื่อน\nแพ\nแพ้\nแพง\nแพ่ง\nแพงพวย\nแพทย์\nแพทยศาสตร์\nแพน\nแพ่น\nแพนก\nแพนงเชิง\nแพร\nแพร่\nแพรก\nแพร่ง\nแพรว\nแพร้ว\nแพลง\nแพลทินัม\nแพล็บ\nแพลม\nแพลเลเดียม\nแพละ\nแพละโลม\nแพว\nแพ้ว\nแพศย์\nแพศยา\nแพะ\nโพ\nโพก\nโพกพาย\nโพง\nโพงพาง\nโพชฌงค์\nโพซิตรอน\nโพด\nโพทะเล\nโพแทสเซียม\nโพธ\nโพธิ\nโพธิ์\nโพน\nโพ้น\nโพนทะนา\nโพบาย\nโพย\nโพยก๊วน\nโพยม\nโพรก\nโพรง\nโพรโทแอกทิเนียม\nโพรมีเทียม\nโพระดก\nโพล่\nโพลง\nโพล่ง\nโพล้ง\nโพลน\nโพล้เพล้\nโพละ\nโพสพ\nไพ\nไพ่\nไพจิตร\nไพชน\nไพชยนต์\nไพฑูรย์\nไพที\nไพบูลย์\nไพพรรณ\nไพร\nไพร่\nไพรจิตร\nไพรชน\nไพรชยนต์\nไพรฑูรย์\nไพรที\nไพรบูลย์\nไพรเราะ\nไพรัช\nไพรำ\nไพริน\nไพรินทร์\nไพรี\nไพเราะ\nไพโรจน์\nไพล\nไพล่\nไพศาขะ\nไพศาล\nไพเศษ\nไพสพ\nไพสิฐ\nไพหาร\nฟก\nฟ้ง\nฟรักโทส\nฟรี\nฟลูออรีน\nฟ่อ\nฟ้อ\nฟอก\nฟอง\nฟ่อง\nฟ้อง\nฟอด\nฟอน\nฟ่อน\nฟ้อน\nฟ้อแฟ้\nฟอร์มาลดีไฮด์\nฟอร์มาลิน\nฟอสฟอรัส\nฟอสเฟต\nฟัก\nฟักฟุ้น\nฟัง\nฟังก์ชัน\nฟัด\nฟัน\nฟั่น\nฟั้น\nฟ้า\nฟาก\nฟาง\nฟ่าง\nฟาด\nฟาทอม\nฟาน\nฟ่าม\nฟาย\nฟาร์ม\nฟาสซิสต์\nฟิด\nฟิต\nฟิบ\nฟิล์ม\nฟิวส์\nฟิสิกส์\nฟี่\nฟี้\nฟืดฟาด\nฟืน\nฟื้น\nฟืม\nฟุ\nฟุ้ง\nฟุต\nฟุน\nฟุบ\nฟุ่บ\nฟุ่มเฟือย\nฟุลสแก๊ป\nฟู\nฟู่\nฟูก\nฟูด\nฟูม\nเฟ็ด\nเฟ้น\nเฟลด์สปาร์\nเฟ้อ\nเฟอร์เมียม\nเฟอะ\nเฟอะฟะ\nเฟะ\nเฟะฟะ\nเฟิน\nเฟี้ยม\nเฟี้ยว\nเฟือ\nเฟื้อ\nเฟือง\nเฟื่อง\nเฟื้อง\nเฟือน\nเฟือย\nเฟื้อย\nแฟ่\nแฟง\nแฟชั่น\nแฟน\nแฟบ\nแฟ้ม\nแฟรนเซียม\nแฟลกซ์\nแฟลต\nแฟะ\nโฟกัส\nไฟ\nภควดี\nภควัต\nภควันต์\nภควัม\nภควา\nภควาน\nภคะ\nภคันทลา\nภคินี\nภณะ\nภณิดา\nภพ\nภมร\nภมริน\nภมรี\nภมุกา\nภยันตราย\nภยาคติ\nภระ\nภรณี\nภรต\nภรรดร\nภรรดา\nภรรยา\nภระมร\nภระมรี\nภราดร\nภราดรภาพ\nภราดา\nภริยา\nภฤศ\nภวะ\nภวตัณหา\nภวนะ\nภวังค์\nภวังคจิต\nภักดี\nภักตะ\nภักติ\nภักษ์\nภักษา\nภักษาหาร\nภัค\nภัคน์\nภังคะ\nภังคี\nภัจ\nภัณฑ์\nภัณฑาคาร\nภัณฑาคาริก\nภัณฑารักษ์\nภัณฑนะ\nภัณฑู\nภัต\nภัตตาคาร\nภัตตาหาร\nภัตร\nภัทระ\nภัทรกัป\nภัพ\nภัย\nภัสดา\nภัสตรา\nภัสมะ\nภัสสร\nภา\nภาค\nภาคย์\nภาคยานุวัติ\nภาคินี\nภาคิไนย\nภาคี\nภาคียะ\nภาชนะ\nภาชี\nภาณ\nภาณวาร\nภาณกะ\nภาณี\nภาณุ\nภาดร\nภาดา\nภาตระ\nภาตา\nภาตุ\nภาติกะ\nภาติยะ\nภาพ\nภาพย์\nภาม\nภาย\nภาร\nภาระ\nภารดี\nภารต\nภารตี\nภารยทรัพย์\nภารยา\nภารา\nภาวนา\nภาวะ\nภาษ\nภาษณ์\nภาษา\nภาษิต\nภาษี\nภาส\nภาสน์\nภาสวร\nภาสา\nภาสุระ\nภิกขา\nภิกขาจาร\nภิกขุ\nภิกขุนี\nภิกษา\nภิกษาจาร\nภิกษาหาร\nภิกษุ\nภิกษุณี\nภิงคาร\nภิญโญ\nภิตติ\nภินท์\nภินทนาการ\nภิยโย\nภิรมย์\nภิรมย์สุรางค์\nภิษัช\nภิสัก\nภีตะ\nภีมะ\nภีรุ\nภุกต์\nภุขัน\nภุช\nภุชงค์\nภุต\nภุมมะ\nภุมรัตน์\nภุมวาร\nภุมรา\nภุมริน\nภุมรี\nภุมเรศ\nภู\nภู่\nภูต\nภูติ\nภูม\nภูมิ\nภูมี\nภูริ\nภูรี\nภูวดล\nภูวนาถ\nภูวเนตร\nภูวไนย\nภูษา\nภูษิต\nเภกะ\nเภตรา\nเภท\nเภทุบาย\nเภรี\nเภสัช\nโภค\nโภคะ\nโภคิน\nโภคี\nโภไคย\nโภไคศวรรย์\nโภช\nโภชย์\nโภชก\nโภชนะ\nโภชนา\nโภชนาหาร\nโภชนียะ\nไภริน\nไภรี\nไภษัชคุรุ\nไภษัชย์\nมกร\nมกราคม\nมกุฎ\nมคธ\nมฆวัน\nมฆะ\nมฆา\nม่ง\nมงกุฎ\nมงโกรย\nมงคล\nมงคลวาร\nมณฑ์\nมณฑก\nมณฑนะ\nมณฑป\nมณฑล\nมณฑา\nมณฑารพ\nมณฑิระ\nมณเฑียร\nมณี\nมด\nมตะ\nมตกภัต\nมติ\nมทนะ\nมทะ\nมธุ\nมธุกร\nมธุการี\nมธุลีห์\nมธุระ\nมธุรพจน์\nมน\nมนินทรีย์\nม่น\nมนต์\nมนตร์\nมนตรี\nมนท์\nมนทิราลัย\nมนเทียร\nมนสิการ\nมนัส\nมนัสวี\nมนินทรีย์\nมนิมนา\nมนิลา\nมนุญ\nมนุษย์\nมนุษยชาติ\nมนุษยธรรม\nมนุษย์มนา\nมนุษยโลก\nมนุษยศาสตร์\nมนุษยสัมพันธ์\nมนุสาร\nมนู\nมนูสาร\nมโน\nมโนช\nมโนชญ์\nมโนราห์\nมโนสาเร่\nมโนห์รา\nมมังการ\nมยุรฉัตร\nมยุระ\nมยุรา\nมยุรี\nมยุเรศ\nมยูร\nมรกต\nมรคา\nมรฑป\nมรณ์\nมรณะ\nมรณกรรม\nมรณบัตร\nมรณภัย\nมรณภาพ\nมรดก\nมรรค\nมรรคา\nมรรตัย\nมรรยาท\nมรรษ\nมรสุม\nมริจ\nมริยาท\nมรีจิ\nมรุต\nมฤค\nมฤคย์\nมฤคศิระ\nมฤคศิรมาส\nมฤคเศียร\nมฤคินทร์\nมฤเคนทร์\nมฤดก\nมฤต\nมฤตยู\nมฤทุ\nมล\nมละ\nมลัก\nมลังเมลือง\nมล้าง\nมลาย\nมลายู\nมวก\nม่วง\nมวน\nม่วน\nม้วน\nม้วนต้วน\nมวย\nม้วย\nมวล\nมหกรรม\nมหรณพ\nมหรรณพ\nมหรสพ\nมหัจฉริยะ\nมหัต\nมหัทธนะ\nมหันต์\nมหันตโทษ\nมหัพภาค\nมหัศจรรย์\nมหา\nมหากฐิน\nมหากาฬ\nมหาขันธกะ\nมหาจักร\nมหาชน\nมหาชัย\nมหาชาติ\nมหาโชตรัต\nมหาดไทย\nมหาดเล็ก\nมหาตมะ\nมหาไถ่\nมหาเทพ\nมหาเทพี\nมหาเทวี\nมหาธาตุ\nมหานิกาย\nมหานิล\nมหาบพิตร\nมหาบัณฑิต\nมหาพน\nมหาพรหม\nมหาภารตะ\nมหาภิเนษกรมณ์\nมหาภูต\nมหาเมฆ\nมหายาน\nมหายุค\nมหาราช\nมหาฤกษ์\nมหาละลวย\nมหาละลาย\nมหาวงศ์\nมหาวรรค\nมหาวิทยาลัย\nมหาศักราช\nมหาศาล\nมหาสงกรานต์\nมหาสดมภ์\nมหาสดำ\nมหาสมุทร\nมหาสาวก\nมหาหงส์\nมหาหิงคุ์\nมหาอำนาจ\nมหาอุจ\nมหาอุด\nมหาอุปรากร\nมหาอุปราช\nมหิ\nมหิดล\nมหิธร\nมหิป\nมหิงส์\nมหิทธิ\nมหินท์\nมหิมา\nมหิศร\nมหิศวร\nมหิษ\nมหิษี\nมหึมา\nมเหยงค์\nมเหศ\nมเหศวร\nมเหศักดิ์\nมเหสักข์\nมเหสิ\nมเหสี\nมเหาฬาร\nมโหรสพ\nมโหระทึก\nมโหรี\nมโหฬาร\nมไหศวรรย์\nมอ\nมอง\nมองโกลอยด์\nมองโกเลีย\nมองคร่อ\nมอญ\nมอด\nม่อต้อ\nมอเตอร์\nมอเตอร์ไซค์\nมอน\nม่อน\nมอบ\nมอม\nมอมแมม\nม่อย\nมอร์ฟีน\nมอระกู่\nมอลโทส\nม่อลอกม่อแลก\nม่อห้อม\nม่อฮ่อม\nมะ\nมะกรูด\nมะกล่ำ\nมะกอก\nมะก่อง\nมะกะโรนี\nมะกา\nมะเกลือ\nมะเกี๋ยง\nมะข่วง\nมะขวิด\nมะขาม\nมะเขือ\nมะแข่น\nมะคังแดง\nมะค่า\nมะคำไก่\nมะคำดีควาย\nมะงั่ว\nมะงุมมะงาหรา\nมะซัก\nมะซาง\nมะดัน\nมะดีหวี\nมะดูก\nมะเดหวี\nมะเดื่อ\nมะต้อง\nมะตะบะ\nมะตาด\nมะตาหะรี\nมะตึ่ง\nมะตื๋น\nมะตูม\nมะแตก\nมะโต\nมะนาว\nมะปราง\nมะปริง\nมะฝ่อ\nมะพร้าว\nมะพลับ\nมะพูด\nมะแพน\nมะแพร้ว\nมะเฟือง\nมะแฟน\nมะไฟ\nมะม่วง\nมะม่าว\nมะมี่\nมะมื่น\nมะมุด\nมะเมอ\nมะเมีย\nมะเมื่อย\nมะแม\nมะยง\nมะยม\nมะระ\nมะริด\nมะรืน\nมะรุม\nมะรุมมะตุ้ม\nมะเร็ง\nมะเรื่อง\nมะโรง\nมะลอกมะแลก\nมะละกอ\nมะลิ\nมะลื่น\nมะลืมดำ\nมะลุลี\nมะแว้ง\nมะสัง\nมะเส็ง\nมะหวด\nมะหะหมัด\nมะหาด\nมะหิ่ง\nมะเหงก\nมะอึก\nมะฮอกกานี\nมัก\nมักกะโรนี\nมักกะลีผล\nมักกะสัน\nมักขะ\nมั่กขั้ก\nมักขิกา\nมัค\nมัคคะ\nมัคคุเทศก์\nมัคนายก\nมัฆวาน\nมั่ง\nมังกง\nมังกร\nมังกุ\nมังคละ\nมังค่า\nมังคุด\nมังตาน\nมังสวิรัติ\nมังสะ\nมังสี\nมัจจะ\nมัจจุ\nมัจฉริยะ\nมัจฉรี\nมัจฉะ\nมัจฉา\nมัชชะ\nมัชวิรัติ\nมัชชาระ\nมัชฌันติกสมัย\nมัชฌิม\nมัชฌิมา\nมัญจา\nมัญชิษฐา\nมัญชุ\nมัญชุสา\nมัญชูสา\nมัญเชฏฐะ\nมัฏฐะ\nมัณฑนศิลป์\nมัณฑนา\nมัด\nมัตตะ\nมัตตัญญู\nมัตตา\nมัตติกา\nมัตถกะ\nมัตถลุงค์\nมัตสยะ\nมัตสยา\nมัตสระ\nมัตสริน\nมัททวะ\nมัทนะ\nมัทยะ\nมัธยฐาน\nมัธยม\nมัธยันห์\nมัธยัสถ์\nมัน\nมั่น\nมันตา\nมันถะ\nมันทิระ\nมันทิราลัย\nมับ\nมั้ม\nมัมมี่\nมัย\nมัลละ\nมัลลิกา\nมัว\nมัวซัว\nมั่ว\nมัศยา\nมัสตุ\nมัสตาร์ด\nมัสมั่น\nมัสยิด\nมัสรู่\nมัสลิน\nมัสสุ\nมา\nม้า\nมาก\nมาคสิระ\nมาฆบูชา\nมาฆะ\nม้าง\nมางสะ\nมาณพ\nมาณวิกา\nมาด\nมาดา\nมาตงค์\nมาตร\nมาตรา\nมาตฤ\nมาตังคะ\nมาตา\nมาตามหัยกะ\nมาตามหัยกา\nมาตามหัยยิกา\nมาติกะ\nมาติกา\nมาตุ\nมาตุจฉา\nมาตุรงค์\nมาตุเรศ\nมาตุละ\nมาตุลา\nมาตุลานี\nมาทะ\nมาธยมิก\nมาธยมิกะ\nมาธุระ\nมาธุสร\nมาธูระ\nมาน\nม่าน\nม้าน\nมานพ\nมานะ\nมานัต\nมานัส\nมานิต\nมานี\nมานุษ\nมานุษยวิทยา\nมาโนชญ์\nมาบ\nมาภา\nม้าม\nม่าย\nมายา\nมาร\nมาราธิราช\nมารค\nมารดร\nมารดา\nมารยา\nมารยาท\nมารศรี\nมารษา\nมาริต\nมารุต\nมาลย์\nมาลัย\nมาลา\nมาลาตี\nมาลาเรีย\nมาลินี\nมาลี\nมาลุต\nมาศ\nมาส\nมาสก\nมาห์\nม่าห์\nมาหิส\nม่าเหมี่ยว\nมาฬก\nมิ\nมิค\nมิคสัญญี\nมิ่ง\nมิจฉา\nมิด\nมิตร\nมิติ\nมิเตอร์\nมิถยา\nมิถุน\nมิถุนายน\nมิทธะ\nมินตรา\nมินตา\nมินหม้อ\nมิ่ม\nมิ้ม\nมิไย\nมิรันตี\nมิลลิกรัม\nมิลลิบาร์\nมิลลิเมตร\nมิลลิลิตร\nมิลักขะ\nมิลักขู\nมิส\nมิสกรี\nมิสกวัน\nมิสซา\nมี\nมี่\nมีด\nมีเทน\nมีน\nมีนาคม\nมี่สั้ว\nมึง\nมึน\nมืด\nมืน\nมื่น\nมือ\nมื้อ\nมุ\nมุก\nมุกดา\nมุกดาหาร\nมุกุระ\nมุข\nมุขเด็จ\nมุขยประโยค\nมุโขโลกนะ\nมุคคะ\nมุง\nมุ่ง\nมุ้ง\nมุจฉา\nมุจนะ\nมุจลินท์\nมุญจนะ\nมุญชะ\nมุฐิ\nมุณฑกะ\nมุณฑะ\nมุด\nมุตกิด\nมุตฆาต\nมุตตะ\nมุตตา\nมุตติ\nมุตะ\nมุติ\nมุททา\nมุทธชะ\nมุทธา\nมุทธาภิเษก\nมุทรา\nมุทริกา\nมุทะลุ\nมุทา\nมุทิกา\nมุทิงค์\nมุทิตา\nมุทุ\nมุทุตา\nมุ่น\nมุนิ\nมุนินทร์\nมุนี\nมุบ\nมุบมิบ\nมุม\nมุ้ม\nมุ่ย\nมุรธา\nมุรธาภิเษก\nมุสละ\nมุสลิม\nมุสา\nมุสิก\nมุหงิด\nมุหน่าย\nมุหุต\nมุฮัมมัด\nมูก\nมูเซอ\nมูตร\nมู่ทู่\nมูน\nมูมมาม\nมูรติ\nมูรธา\nมูรธาภิเษก\nมูล\nมูละ\nมูลา\nมูลิกากร\nมู่ลี่\nมู่เล่\nมูสัง\nมูสิก\nมูสิกะ\nมูสิกทันต์\nเม\nเม็ก\nเมกะเฮิรตซ์\nเมขลา\nเมฆ\nเมฆา\nเมฆินทร์\nเมฆี\nเม็ง\nเม็ด\nเมตตา\nเมตไตรย\nเมตร\nเมตริก\nเมตริกตัน\nเมถุน\nเมท\nเมโท\nเมทนี\nเมทินี\nเมทนีดล\nเมทานอล\nเมทิลแอลกอฮอล์\nเมธ\nเมธา\nเมธาวี\nเมธี\nเมน\nเม่น\nเม้น\nเมนเดลีเวียม\nเมนทอล\nเม้ม\nเมรัย\nเมริเดียน\nเมรุ\nเมล์\nเมล็ด\nเมลือง\nเมษ\nเมษายน\nเมห์\nเมหนะ\nเมหะ\nเมะ\nเมา\nเม่า\nเม้า\nเมารี\nเมาลี\nเมาฬี\nเมาะ\nเมิง\nเมิน\nเมิล\nเมีย\nเมียง\nเมี่ยง\nเมี้ยน\nเมือ\nเมื้อ\nเมื่อ\nเมือก\nเมือง\nเมือบ\nเมื่อย\nแม่\nแม้\nแมก\nแมกนีเซียม\nแมง\nแมงกะพรุน\nแมงกานิน\nแมงกานีส\nแมงคา\nแมงคาเรือง\nแมงช้าง\nแมงดา\nแมงลัก\nแม่ตะงาว\nแมน\nแม่น\nแม้น\nแมลง\nแมลบ\nแมว\nแม้ว\nแมะ\nโม\nโม่\nโม้\nโมก\nโมกข์\nโมกษะ\nโมฆกรรม\nโมฆสัญญา\nโมฆะ\nโมฆียกรรม\nโมฆียะ\nโมง\nโม่ง\nโมงครุ่ม\nโมทนา\nโมโนแซ็กคาไรด์\nโมไนย\nโมเม\nโมเมนต์\nโมเย\nโมรา\nโมรี\nโมเรส\nโมลิบดีนัม\nโมลี\nโมเลกุล\nโมเสก\nโมเสส\nโม่ห์\nโมหะ\nโมหันธ์\nโมหาคติ\nโมโห\nไม่\nไม้\nไมกา\nไมครอน\nไมโครกรัม\nไมโครฟิล์ม\nไมโครโฟน\nไมโครมิเตอร์\nไมโครเมตร\nไมโครลิตร\nไมโครเวฟ\nไมตรี\nไมยราบ\nไมล์\nยก\nยกกระบัตร\nยกนะ\nยง\nยงโย่\nยชุรเวท\nยติ\nยติภังค์\nยถากรรม\nยถาภูตญาณ\nย่น\nยนต์\nยนตร์\nยม\nยมก\nยมโดย\nยมนา\nยมล\nยมะ\nยรรยง\nยล\nยวง\nยวด\nยวน\nยวบ\nย้วย\nยวรยาตร\nยศ\nยโส\nยอ\nย่อ\nยอก\nย็อกแย็ก\nยอง\nย่อง\nย้อง\nยอด\nยอน\nย้อน\nยอบ\nยอม\nย่อม\nย้อม\nย่อย\nย้อย\nย้อแย้\nยะ\nย่ะ\nยะยอบ\nยะยับ\nยัก\nยักข์\nยักขินี\nยักษ์\nยักษา\nยักษิณี\nยักษี\nยัง\nยั้ง\nยั่งยืน\nยัชโญปวีต\nยัญ\nยัญญะ\nยัด\nยัติภังค์\nยัน\nยั่น\nยันต์\nยันตร\nยันตร์\nยันตรกรรม\nยั่นตะนี\nยับ\nยั่ว\nยั้ว\nยั้วเยี้ย\nยัวรยาตร\nยัวะ\nยัษฏิ\nยา\nย่า\nยาก\nยาคุ\nยาคู\nยาง\nย่าง\nยางพารา\nยาจก\nยาจนา\nยาไฉน\nยาด\nยาดา\nยาตร\nยาตรา\nยาน\nย่าน\nย่านพาโหม\nยานมาศ\nยานุมาศ\nยานี\nยาม\nย่าม\nยามะ\nยามักการ\nยามา\nยาย\nย้าย\nยายี\nยาว\nย้าว\nยาวกาลิก\nยาวชีวิก\nยาสูบ\nย่าหยา\nยาหยี\nยำ\nย่ำ\nย้ำ\nยำเยีย\nยิก\nยิง\nยิ่ง\nยิฏฐะ\nยิน\nยิบ\nยิบหยี\nยิปซัม\nยิปซี\nยิ้ม\nยิมนาสติก\nยิหวา\nยี\nยี่\nยี้\nยี่ก่า\nยี่เก\nยี่เข่ง\nยี่โถ\nยีน\nยี่โป้\nยี่ภู่\nยีราฟ\nยี่สก\nยี่สง\nยี่สน\nยี่สาน\nยี่สุ่น\nยี่หระ\nยี่หร่า\nยี่ห้อ\nยี่หุบ\nยึกยัก\nยึกยือ\nยึด\nยืด\nยืน\nยื่น\nยืม\nยื้อ\nยุ\nยุกกระบัตร\nยุกดิ\nยุกติ\nยุกติธรรม\nยุกต์\nยุค\nยุคนธร\nยุคล\nยุคันต์\nยุคันธร\nยุคุนธร\nยุง\nยุ่ง\nยุ้ง\nยุด\nยุต\nยุติ\nยุทธ\nยุทธ์\nยุทธนา\nยุทโธปกรณ์\nยุบ\nยุ่บ\nยุ่บยั่บ\nยุบล\nยุพดี\nยุพเรศ\nยุพา\nยุพาน\nยุพาพาล\nยุพาพิน\nยุ่มย่าม\nยุ่ย\nยุ้ย\nยุรยาตร\nยูรยาตร\nยุวชน\nยุวดี\nยุวราช\nยุวา\nยุวาน\nยู\nยู่\nยูง\nยูโด\nยูถะ\nยูถิกา\nยูริก\nยูเรนัส\nยูเรเนียม\nยูโรเพียม\nเย\nเย้\nเยง\nเยซู\nเย็ด\nเย็น\nเย็นตาโฟ\nเย็นเตาโฟ\nเย็บ\nเย้ย\nเยอ\nเย่อ\nเยอรมัน\nเยอว\nเย่อหยิ่ง\nเยอะ\nเยอะแยะ\nเยา\nเย้า\nเยาว์\nเยาวชน\nเยาวมาลย์\nเยาวยอด\nเยาวราช\nเยาวเรศ\nเยาวลักษณ์\nเยาวพา\nเยาวพาณี\nเยาวพาน\nเยาะ\nเยิง\nเยิน\nเยิ่น\nเยิ่นเย้อ\nเยินยอ\nเยิบ\nเยิบยาบ\nเยิ้ม\nเยีย\nเยี่ยง\nเยี่ยงอย่าง\nเยียงผา\nเยียดยัด\nเยียน\nเยียบ\nเยี่ยม\nเยียรบับ\nเยียรยง\nเยียว\nเยี่ยว\nเยียวยา\nเยือ\nเยื่อ\nเยื้อ\nเยือก\nเยือง\nเยื่อง\nเยื้อง\nเยือน\nเยื้อน\nแย่\nแย้\nแยก\nแยง\nแย่ง\nแย้ง\nแยงแย่\nแยงแย้\nแยบ\nแย็บ\nแยม\nแย้ม\nแยแส\nแยะ\nโย\nโย้\nโยก\nโยกเยก\nโยคาพจร\nโยคาวจร\nโยคเกณฑ์\nโยคยะ\nโยคะ\nโยคิน\nโยคี\nโยง\nโย่ง\nโย่งเย่ง\nโยงโย่\nโยชน์\nโยชนา\nโยถิกะ\nโยทะกา\nโยธวาทิต\nโยธา\nโยธิน\nโยน\nโยนก\nโยนิโส\nโยนี\nโยม\nโยโส\nใย\nไย\nไย่\nไยดี\nไยไพ\nรก\nรง\nรงค์\nรงควัตถุ\nรงรอง\nรจนา\nรจเรข\nรจเลข\nรจิต\nรชตะ\nรชนิ\nรชนี\nรชะ\nรณรงค์\nรด\nรดี\nรตนะ\nรตะ\nรติ\nรถ\nรน\nร่น\nรบ\nรบาญ\nรพี\nรม\nร่ม\nรมณี\nรมณีย์\nรมณียสถาน\nรมย์\nรมเยศ\nรยางค์\nรวก\nรวง\nร่วง\nรวด\nรวน\nรวนเร\nร่วน\nรวบ\nรวม\nร่วม\nรวย\nรวิ\nรวิวาร\nรวี\nรศนา\nรส\nรสนา\nรสสุคนธ์\nรสายนเวท\nรสิก\nรหัท\nรหัส\nรโห\nรโหฐาน\nรอ\nร่อ\nรอก\nรอง\nร่อง\nร้อง\nรองเง็ง\nร่องแร่ง\nรอด\nรอน\nร่อน\nร้อน\nรอบ\nรอบคอบ\nรอม\nรอมชอม\nรอมร่อ\nรอย\nร่อย\nร้อย\nร่อแร่\nระ\nระกะ\nระกา\nระกำ\nระเกะระกะ\nระคน\nระคาง\nระคาย\nระแคะ\nระฆัง\nระงม\nระงับ\nระแง้\nระโงกหิน\nระชวย\nระดม\nระดะ\nระดับ\nระดา\nระด่าว\nระดู\nระเด่น\nระเดียง\nระแด\nระตู\nระทก\nระทด\nระทม\nระทวย\nระทา\nระทึก\nระแทะ\nระนาด\nระนาบ\nระนาม\nระนาว\nระเนน\nระเนระนาด\nระเนียด\nระแนง\nระแนะ\nระบบ\nระบม\nระบอบ\nระบัด\nระบับ\nระบาด\nระบาย\nระบำ\nระบิล\nระบือ\nระบุ\nระเบง\nระเบ็ง\nระเบิด\nระเบียง\nระเบียน\nระเบียบ\nระแบบ\nระมัดระวัง\nระมาด\nระเมียร\nระย่อ\nระย่อม\nระยะ\nระยั้ง\nระยับ\nระย้า\nระยาบ\nระยำ\nระยิบระยับ\nระโยง\nระโยงระยาง\nระรวย\nระรอง\nระร่อน\nระรัว\nระราน\nระร่าย\nระริก\nระรี่\nระรึง\nระรื่น\nระรื้น\nระเร้ง\nระเริง\nระเรียง\nระเรื่อย\nระแรง\nระลวง\nระลอก\nระลึก\nระวัง\nระวาง\nระวาย\nระวิง\nระแวง\nระแวดระวัง\nระไว\nระส่ำระสาย\nระหกระเหิน\nระหง\nระหวย\nระหว่าง\nระหองระแหง\nระหัด\nระหาย\nระเห็จ\nระเหย\nระเหระหน\nระเหหน\nระเหิด\nระเหินระหก\nระแหง\nระโหย\nระอา\nระอิดระอา\nระอุ\nรัก\nรักข์\nรักขิต\nรักตะ\nรักบี้\nรักเร่\nรักแร้\nรักษ์\nรักษา\nรัง\nรั้ง\nรังเกียจ\nรังแก\nรังค์\nรังควาน\nรังแค\nรังรอง\nรังวัด\nรังสิ\nรังสี\nรังสิมันตุ์\nรังสิมา\nรัจฉา\nรัช\nรัชชูปการ\nรัชมังคลาภิเษก\nรัชชุ\nรัชฎาภิเษก\nรัชดาภิเษก\nรัชนะ\nรัชนี\nรัญจวน\nรัฏฐาภิปาลโนบาย\nรัฐ\nรัฐประศาสโนบาย\nรัฐประศาสนศาสตร์\nรัด\nรัต\nรัตกัมพล\nรัตมณี\nรัตคน\nรัตจันทน์\nรัตตัญญู\nรัตติ\nรัตน์\nรัตนะ\nรัตนโกสินทร์\nรัตนโกสินทรศก\nรัตนชาติ\nรัตนตรัย\nรัตนบัลลังก์\nรัตนวราภรณ์\nรัตนสิงหาสน์\nรัตนา\nรัตนากร\nรัตนาภรณ์\nรัตนาวลี\nรัตมา\nรัถ\nรัถยา\nรัทเทอร์ฟอร์เดียม\nรัน\nรั้น\nรันทด\nรันทวย\nรับ\nรัมณียสถาน\nรัมภา\nรัมมี่\nรัมย์\nรัย\nรัว\nรั่ว\nรั้ว\nรัศมิมัต\nรัศมิมาน\nรัศมี\nรัษฎากร\nรัสเซีย\nรัสสะ\nรัสสระ\nรา\nร่า\nร้า\nราก\nรากษส\nรากสาด\nราคะ\nราคจริต\nราคา\nราคิน\nราคี\nราง\nร่าง\nร้าง\nรางจืด\nรางชาง\nรางวัล\nราช\nราชกิจจานุเบกษา\nราชนิกุล\nราชวโรงการ\nราชญี\nราชดัด\nราชพฤกษ์\nราชมาณพ\nราชมาษ\nราชมาส\nราชย์\nราชสีห์\nราชะ\nราชัน\nราชันย์\nราชัย\nราชา\nราชาธิปไตย\nราชาธิราช\nราชาภิเษก\nราชายตนะ\nราชาวดี\nราชี\nราชินิกุล\nราชินีกุล\nราชินี\nราชินูปถัมภ์\nราชูปถัมภ์\nราชูปโภค\nราเชน\nราเชนทร์\nราเชนทรยาน\nราโชวาท\nราไชศวรรย์\nราญ\nราญรอน\nราด\nราต\nราตร\nราตรี\nราน\nร่าน\nร้าน\nราบ\nราพณ์\nราพณาสูร\nราม\nรามเกียรติ์\nรามสูร\nรามัญ\nรามา\nราย\nร่าย\nร้าย\nราว\nร้าว\nราวี\nราศี\nราษฎร\nราษฎร์\nราษตรี\nราษราตรี\nราหุ\nราหู\nรำ\nร่ำ\nรำคาญ\nรำงับ\nรำจวน\nรำบาญ\nรำพัน\nรำพาย\nรำพึง\nรำเพย\nรำไพ\nรำมะนา\nรำมะนาด\nรำมะร่อ\nร่ำรวย\nร่ำร่ำ\nรำไร\nรำลึก\nรำหัด\nรำหัส\nริ\nริก\nริดสีดวง\nริน\nริ้น\nริบ\nริบบิ้น\nริบรี่\nริบหรี่\nริปุ\nริปู\nริม\nริ้ว\nริษยา\nรี\nรี่\nรี้พล\nรีด\nรีดักชัน\nรีต\nรีเนียม\nรีบ\nรีม\nรีรอ\nรี้ริก\nรึง\nรึ้ง\nรื่น\nรื้น\nรื้อ\nรุ\nรุก\nรุกข์\nรุกขชาติ\nรุกขเทวดา\nรุกขมูล\nรุกขา\nรุกรุย\nรุ่ง\nรุ้ง\nรุงรัง\nรุ่งริ่ง\nรุจ\nรุจา\nรุจนะ\nรุจิ\nรุจี\nรุจิระ\nรุจิรา\nรุด\nรุต\nรุทธ์\nรุทระ\nรุธิร\nรุธิระ\nรุเธียร\nรุน\nรุ่น\nรุบรู่\nรุม\nรุ่ม\nรุ่มร่าม\nรุย\nรุ่ย\nรุรุ\nรุหะ\nรู\nรู่\nรู้\nรูจี\nรูด\nรูทีเนียม\nรูบิเดียม\nรูป\nรูปิยะ\nรูปี\nรูเล็ตต์\nเร่\nเรข\nเรขา\nเรขาคณิต\nเร็ง\nเร่ง\nเร้ง\nเรณุ\nเรณู\nเรดอน\nเรดาร์\nเรเดียม\nเร้น\nเรรวน\nเรไร\nเร็ว\nเร่ว\nเรวดี\nเรอ\nเร่อ\nเรา\nเร่า\nเร้า\nเราะ\nเริง\nเริด\nเริม\nเริ่ม\nเริ้ม\nเริศร้าง\nเรี่ย\nเรี้ย\nเรียก\nเรียง\nเรียด\nเรียน\nเรียบ\nเรียม\nเรี่ยม\nเรียว\nเรี่ยว\nเรี้ยวรก\nเรือ\nเรื่อ\nเรื้อ\nเรือก\nเรือง\nเรื่อง\nเรื้อง\nเรืองรอง\nเรือด\nเรือน\nเรื้อน\nเรื่อย\nแร\nแร่\nแรก\nแร็กเกต\nแรง\nแร่ง\nแร้ง\nแรด\nแร้นแค้น\nแรม\nแร้ว\nแระ\nโร\nโร่\nโรค\nโรคา\nโรคาพาธ\nโรง\nโรจ\nโรจน์\nโรเดียม\nโรตี\nโรท\nโรธ\nโรม\nโรมัน\nโรเมอร์\nโรย\nโรเร\nโรหิณี\nโรหิต\nไร\nไร่\nไร้\nไรย์\nฤกษ์\nฤกษณะ\nฤคเวท\nฤชา\nฤชุ\nฤณ\nฤดี\nฤดียา\nฤดู\nฤต\nฤติยา\nฤตุ\nฤทธา\nฤทธิ์\nฤทัย\nฤษภ\nฤษยา\nฤษี\nฤๅ\nฤๅดี\nฤๅทัย\nฤๅษี\nฤๅสาย\nลก\nล่ก\nลฆุ\nลง\nล่ง\nลงกา\nล้งเล้ง\nลด\nลดา\nลดาวัลย์\nลน\nล้น\nลบ\nลบอง\nลพ\nลพุช\nลม\nล่ม\nล้ม\nลมาด\nลรรลุง\nลลนา\nลลิต\nลวก\nลวง\nล่วง\nล้วง\nลวณะ\nลวด\nล้วน\nลวนลาม\nลวนะ\nล่วม\nลวะ\nลวิตร\nลหุ\nลหุกาบัติ\nล่อ\nล้อ\nลอก\nล็อก\nล็อกเกต\nลอกแลก\nลอการิทึม\nลอง\nล่อง\nลองกอง\nลองจิจูด\nลองไน\nลอด\nลอตเตอรี่\nลอน\nล่อน\nลอบ\nลอม\nล้อม\nลอมชอม\nลอมพอก\nลอย\nล่อย\nล่อแล่\nลอว์เรนเซียม\nลออ\nละ\nล่ะ\nละคร\nละติจูด\nละบม\nละบอง\nละบือ\nละเบ็ง\nละโบม\nละม่อม\nละมั่ง\nละมาน\nละม้าย\nละมุ\nละมุด\nละมุน\nละเมอ\nละเมาะ\nละเมิด\nละเมียด\nละแมะ\nละโมก\nละโมบ\nละไม\nละลวย\nละลอก\nละล้า\nละล้าละลัง\nละลาน\nละลาบละล้วง\nละลาย\nละล้าว\nละล่ำละลัก\nละลิบ\nละลุม\nละเลง\nละเล้า\nละเลาะ\nละเลิง\nละเลียด\nละเลียบ\nละไล้\nละว้า\nละวาด\nละเวง\nละแวก\nละโว้\nละหมาด\nละห้อย\nละหาน\nละหาร\nละหุ่ง\nละเหย\nละเหี่ย\nละอง\nละออง\nละอาย\nละเอียด\nละแอน\nลัก\nลักขณะ\nลักขณา\nลักขะ\nลักขี\nลักจั่น\nลักปิดลักเปิด\nลักษณ์\nลักษณนาม\nลักษณะ\nลักษณาการ\nลักษมณ์\nลักษมาณา\nลักษมี\nลักษะ\nลัคคะ\nลัคน์\nลัคนา\nลัง\nลั่ง\nลังกา\nลังคี\nลังถึง\nลังลอง\nลังเล\nลังสาด\nลัชชา\nลัชชี\nลัญจ์\nลัญจกร\nลัญฉกร\nลัญฉน์\nลัฐิ\nลัฐิกา\nลัด\nลัดา\nลัทธ์\nลัทธิ\nลัน\nลั่น\nลันเต\nลันเตา\nลันไต\nลั่นทม\nลันโทม\nลับ\nลัพธ์\nลัพธิ\nลัภ\nลัภนะ\nลัภย์\nลัมพ์\nลัย\nลา\nล่า\nล้า\nลาก\nลาง\nล่าง\nล้าง\nลางลิง\nลางสาด\nลาช\nลาชะ\nลาชา\nลาญ\nลาด\nลาดเลา\nล้าต้า\nล่าเตียง\nลาน\nล่าน\nล้าน\nลาบ\nลาพอน\nลาภ\nลาม\nล่าม\nลามก\nลาย\nล้าย\nลายสือ\nลาลา\nลาว\nลาวัณย์\nลาวา\nลำ\nล่ำ\nล้ำ\nลำเข็ญ\nลำแข\nลำเค็ญ\nลำเจียก\nลำดวน\nลำดับ\nลำเนา\nลำบอง\nลำบาก\nลำปำ\nลำพวน\nลำพอง\nลำพัง\nลำพู\nลำเพ็ญ\nลำเพา\nลำแพน\nลำโพง\nลำไพ่\nลำภุขัน\nลำมะลอก\nลำยอง\nลำไย\nลำลอง\nล่ำลา\nลำลาบ\nลำลึก\nลำเลาะ\nลำเลิก\nลำเลียง\nลำเวียง\nลำเอียก\nลำเอียง\nลิ\nลิกขา\nลิกไนต์\nลิกู\nลิเก\nลิขนะ\nลิขสิทธิ์\nลิขิต\nลิง\nลิงค์\nลิด\nลิต\nลิตมัส\nลิตร\nลิเทียม\nลิ่น\nลิ้น\nลินจง\nลิ้นจี่\nลินลา\nลินสีด\nลิ่นฮื้อ\nลินิน\nลิบ\nลิปดา\nลิปสติก\nลิปิ\nลิฟต์\nลิเภา\nลิ่ม\nลิ้ม\nลิมป์\nลิมปนะ\nลิลิต\nลิว\nลิ่ว\nลิสง\nลี\nลี่\nลี้\nลีซอ\nลีบ\nลีลา\nลีลาศ\nลีฬหา\nลึก\nลึงค์\nลืด\nลื่น\nลื้น\nลืบ\nลืม\nลือ\nลื่อ\nลื้อ\nลุ\nลุก\nลุง\nลุ้ง\nลุ่น\nลุ้น\nลุพธ์\nลุ่ม\nลุมพี\nลุมพู\nลุย\nลุ่ย\nลุ้ย\nลู่\nลูก\nลูกระมาศ\nลูกเอ็น\nลูขะ\nลูทีเชียม\nลูบ\nเลก\nเล็ก\nเลข\nเลขา\nเลขาธิการ\nเลขานุการ\nเล็ง\nเล้ง\nเล่งฮื้อ\nเลเซอร์\nเลฑฑุ\nเลณฑุ\nเลณะ\nเล็ด\nเลน\nเล็น\nเล่น\nเลนส์\nเล็บ\nเลบง\nเลปกร\nเลปน์\nเลเป\nเลเพ\nเล็ม\nเล่ม\nเลย\nเลว\nเลวง\nเลวูโลส\nเลศ\nเลษฏุ\nเล่ห์\nเล่ห์กระเท่ห์\nเลหลัง\nเลหะ\nเลอ\nเล่อ\nเลอะ\nเลอะเทอะ\nเละ\nเละเทะ\nเลา\nเล่า\nเล้า\nเลากัย\nเล้าโลม\nเลาะ\nเลิก\nเลิ่กลั่ก\nเลิง\nเลิ้ง\nเลินเล่อ\nเลิศ\nเลีย\nเลียง\nเลี่ยง\nเลี้ยง\nเลียงผา\nเลียงฝ้าย\nเลียงมัน\nเลียน\nเลี่ยน\nเลียนไฟ\nเลียบ\nเลี่ยม\nเลียว\nเลี้ยว\nเลือก\nเลือง\nเลื่อง\nเลือด\nเลือน\nเลื่อน\nเลื่อม\nเลื่อย\nเลื้อย\nเลื่อยล้า\nแล\nแล่\nแล้\nแลก\nแล็กเกอร์\nแล็กโทส\nแลง\nแล่ง\nแล้ง\nแลน\nแล่น\nแลนทานัม\nแลบ\nแล้ว\nและ\nโล่\nโล้\nโลก\nโลกเชษฐ์\nโลกธรรม\nโลกธาตุ\nโลกนาถ\nโลกบาล\nโลกย์\nโลกัย\nโลกวัชชะ\nโลกวิทู\nโลกัตถจริยา\nโลกันตร์\nโลกา\nโลกาธิบดี\nโลกาธิปไตย\nโลกานุวัตร\nโลกาภิวัตน์\nโลกามิส\nโลกายัต\nโลกาวินาศ\nโลกิยะ\nโลกีย์\nโลกียวัตร\nโลกียวิสัย\nโลกียสุข\nโลกุตระ\nโลกุตรธรรม\nโลกุตรภูมิ\nโลง\nโล่ง\nโล้ง\nโล่งโจ้ง\nโล่งโต้ง\nโล้งโต้ง\nโลจนะ\nโลณะ\nโลด\nโล่ติ๊น\nโลโต\nโลท\nโลน\nโล้น\nโลภ\nโลม\nโลมเล้า\nโลมะ\nโลมา\nโลลุป\nโลเล\nโลโล\nโลโล้\nโลหะ\nโลหกุมภี\nโลหัช\nโลหิต\nไล่\nไล้\nไลย\nไลลา\nไล่เลี่ย\nฦๅ\nฦๅชา\nฦๅสาย\nวก\nวง\nวงก์\nวงกต\nวงศ์\nวงศกร\nวงศา\nวงษ์\nวจนะ\nวจี\nวชิระ\nวชิรปาณี\nวชิรหัตถ์\nวชิราวุธ\nวฏะ\nวฏาการ\nวณิช\nวณิชชา\nวณิชย์\nวณิชยา\nวณิพก\nวดี\nวทนะ\nวทัญญุตา\nวทัญญู\nวธุกา\nวธู\nวน\nวนศาสตร์\nวนสณฑ์\nวนสัณฑ์\nวนอุทยาน\nวนัส\nวนัสบดี\nวนา\nวนาดร\nวนาดอน\nวนานต์\nวนาลัย\nวนาลี\nวนาวาส\nวนาศรม\nวนาสณฑ์\nวนาสัณฑ์\nวนิดา\nวนิพก\nวเนจร\nวโนทยาน\nวยัคฆ์\nวยากรณ์\nวรดนู\nวรทาน\nวรมหาวิหาร\nวรงค์\nวรณะ\nวรรค\nวรรคย์\nวรรช\nวรรชย์\nวรรณะ\nวรรณกรรม\nวรรณคดี\nวรรณยุกต์\nวรรณยุต\nวรรณศิลป์\nวรรณนา\nวรรณพฤติ\nวรรณึก\nวรรธกะ\nวรรธนะ\nวรรษ\nวรรษา\nวรวิหาร\nวรัญญู\nวรางคณา\nวรางคนา\nวราห์\nวราหะ\nวรุณ\nวโรดม\nวฤก\nวลัช\nวลัญช์\nวลัญชน์\nวลัย\nวลาหก\nวลี\nวศค\nวศะ\nวศิน\nวสนะ\nวสภะ\nวสละ\nวสวัดดี\nวสวัตตี\nวสะ\nวสันต์\nวสันตดิลก\nวสันตฤดู\nวสันตวิษุวัต\nวสา\nวสี\nวสุ\nวสุธา\nวสุนธรา\nวสุมดี\nวหะ\nวอ\nวอก\nวอกแวก\nว่องไว\nวอด\nวอน\nว่อน\nว็อบ\nวอมแวม\nวอลเลย์บอล\nวอแว\nวะ\nวัก\nวักกะ\nวัคคีย์\nวัคคุ\nวัคซีน\nวัง\nวังก์\nวังชา\nวังเวง\nวังศะ\nวังสะ\nวัจจะ\nวัจกุฎี\nวัจฉละ\nวัจน์\nวัช\nวัชชะ\nวัชพืช\nวัชฌ์\nวัชระ\nวัชรปาณี\nวัชรยาน\nวัชรอาสน์\nวัชราสน์\nวัชรินทร์\nวัชรี\nวัชเรนทร์\nวัฏ\nวัฏฏะ\nวัฏจักร\nวัฏทุกข์\nวัฏสงสาร\nวัฏกะ\nวัฏฏิ\nวัฒกะ\nวัฒกี\nวัฒนธรรม\nวัฒนะ\nวัฒนา\nวัณ\nวัณโรค\nวัณฏ์\nวัณณะ\nวัณนา\nวัด\nวัต\nวัตต์\nวัตตา\nวัตถ์\nวัตถาภรณ์\nวัตถาลังการ\nวัตถุ\nวัตนะ\nวัตร\nวัตสดร\nวัตสะ\nวัติ\nวัทน์\nวัน\nวันต์\nวันทนา\nวันทนาการ\nวันทนีย์\nวันทยหัตถ์\nวันทยาวุธ\nวันทา\nวันทิ\nวับ\nวับวาบ\nวับวาม\nวับแวบ\nวับแวม\nวัปปะ\nวัมมิกะ\nวัย\nวัลก์\nวัลคุ\nวัลย์\nวัลลภ\nวัลลี\nวัว\nวัสสะ\nวัสโสทก\nวัสดุ\nวัสตร์\nวัสน์\nวัสนะ\nวัสสานะ\nวัสสานฤดู\nวา\nว่า\nว้า\nว้าเหว่\nวาก\nว้าก\nวากยสัมพันธ์\nวากยะ\nวาง\nว่าง\nว้าง\nวาจก\nวาจา\nวาจาไปยะ\nวาจาล\nวาชเปยะ\nวาณิช\nวาณิชกะ\nวาณิชย์\nวาณี\nวาด\nวาต\nวาตะ\nวาตภัย\nวาท\nวาทศาสตร์\nวาทศิลป์\nวาทกะ\nวาทนะ\nวาทย์\nวาทยกร\nวาทิต\nวาทิน\nวาที\nวาน\nวานซืน\nว่าน\nวานร\nวานรินทร์\nวาเนเดียม\nวาบ\nวาปี\nวาม\nวามน\nวามนาวตาร\nวามะ\nวาย\nว่าย\nว้าย\nวายะ\nวาโย\nวายามะ\nวายุ\nวายุกูล\nวาร\nวาระ\nวารสาร\nวารสารศาสตร์\nวาริ\nวารี\nวาริช\nวารีช\nวาริท\nวาริธร\nวารุณ\nวารุณี\nวาล\nวาลวีชนี\nวาล์ว\nวาลิกา\nวาลุกา\nวาว\nว่าว\nว้าว่อน\nว้าวุ่น\nวาสนะ\nวาสนา\nวาสพ\nวาสะ\nวาสิน\nวาสี\nวาสุกรี\nวาสุกี\nวาสุเทพ\nวาหนะ\nวาหะ\nวาหินี\nวาฬ\nวิกขัมภ์\nวิกขัมภนะ\nวิกเขป\nวิกรม\nวิกรัย\nวิกรานต์\nวิกฤต\nวิกฤติ\nวิกล\nวิกสิต\nวิกัต\nวิกัติ\nวิกัติการก\nวิกัป\nวิกัย\nวิการ\nวิกาล\nวิกาลโภชน์\nวิคหะ\nวิเคราะห์\nวิฆเนศ\nวิฆเนศวร\nวิฆาต\nวิง\nวิ่ง\nวิ่งเปี้ยว\nวิงวอน\nวิจฉิกะ\nวิจล\nวิจักขณ์\nวิจักษ์\nวิจักษณ์\nวิจัย\nวิจาร\nวิจารณ์\nวิจารณญาณ\nวิจิ\nวิจิกิจฉา\nวิจิต\nวิจิตร\nวิจิน\nวิจุณ\nวิจุรณ\nวิชชา\nวิชชุ\nวิชชุดา\nวิชชุตา\nวิชชุลดา\nวิชญะ\nวิชน\nวิชนี\nวิชย\nวิชัย\nวิชา\nวิชานนะ\nวิชิต\nวิเชียร\nวิญญัตติ\nวิญญาณ\nวิญญาณกทรัพย์\nวิญญู\nวิฑูรย์\nวิด\nวิตก\nวิตถาร\nวิตามิน\nวิถี\nวิทธะ\nวิทยฐานะ\nวิทยา\nวิทยาคม\nวิทยาคาร\nวิทยาลัย\nวิทยุ\nวิทยุต\nวิทวัส\nวิทัตถิ\nวิทัศน์\nวิทารณ์\nวิทิต\nวิทู\nวิทูร\nวิเทศ\nวิเทโศบาย\nวิธ\nวิธวา\nวิธาน\nวิธี\nวิธุระ\nวิธู\nวิธูปนะ\nวิ่น\nวินตกะ\nวินัย\nวินาที\nวินายก\nวินาศ\nวินิจ\nวินิจฉัย\nวินิต\nวินิบาต\nวินิปาติก\nวิเนต\nวิบัติ\nวิบาก\nวิบุล\nวิบุลย์\nวิบูล\nวิบูลย์\nวิปการ\nวิปฏิสาร\nวิปโยค\nวิประโยค\nวิปริต\nวิปลาส\nวิปวาส\nวิปักษ์\nวิปัสสก\nวิปัสสนา\nวิปัสสนายานิก\nวิพากษ์\nวิพิธทัศนา\nวิพุธ\nวิภว\nวิภวตัณหา\nวิภังค์\nวิภัช\nวิภัตติ\nวิภา\nวิภาค\nวิภาช\nวิภาดา\nวิภาวี\nวิภาษ\nวิภาส\nวิภู\nวิภูษณะ\nวิภูษา\nวิภูษิต\nวิมน\nวิมล\nวิมลัก\nวิมังสา\nวิมัติ\nวิมาน\nวิมุข\nวิมุต\nวิมุตติ\nวิเมลือง\nวิโมกข์\nวิโยค\nวิระ\nวิรงรอง\nวิรังรอง\nวิรัช\nวิรัต\nวิรัติ\nวิราคะ\nวิราม\nวิริยภาพ\nวิริยะ\nวิรุธ\nวิรุฬห์\nวิรุฬหก\nวิรูป\nวิรูปักษ์\nวิเรนทร์\nวิโรจ\nวิโรจน์\nวิโรฒ\nวิโรธ\nวิลันดา\nวิลัย\nวิลาด\nวิลาศ\nวิลาป\nวิลาวัณย์\nวิลาส\nวิลาสินี\nวิลิปดา\nวิลิศมาหรา\nวิเลป\nวิเลปนะ\nวิโลกนะ\nวิโลม\nวิไล\nวิไลวรรณ\nวิวรณ์\nวิวรรธน์\nวิวัฏ\nวิวัฒน์\nวิวัฒนาการ\nวิวัน\nวิวาท\nวิวาห์\nวิวาหมงคล\nวิวาหะ\nวิวิต\nวิวิธ\nวิเวก\nวิศรุต\nวิศว\nวิศวกร\nวิศวกรรม\nวิศวกรรมศาสตร์\nวิศัลย์\nวิศาขบูชา\nวิศาขา\nวิศาล\nวิศิษฏ์\nวิศุทธ์\nวิศุทธิ์\nวิเศษ\nวิเศษณ์\nวิษณุ\nวิษณุกรรม\nวิษธร\nวิษัย\nวิษาณ\nวิษุวัต\nวิสกี้\nวิสรรชนีย์\nวิสฤต\nวิสสุกรรม\nวิสัชนา\nวิสัญญี\nวิสัย\nวิสัยทัศน์\nวิสาขบูชา\nวิสาขะ\nวิสาขา\nวิสามัญ\nวิสามานยนาม\nวิสาร\nวิสารทะ\nวิสาล\nวิสาสะ\nวิสาหกิจ\nวิสิฐ\nวิสุงคามสีมา\nวิสุทธ์\nวิสุทธิ์\nวิสูตร\nวิเสท\nวิหค\nวิหลั่น\nวิหาร\nวิหิงสา\nวิเหสา\nวิฬาร\nวิฬาร์\nวี\nวีจิ\nวีชนี\nวีณา\nวี้ด\nวีรกรรม\nวีรชน\nวีรบุรุษ\nวีรสตรี\nวี่วัน\nวี่แวว\nวีสะ\nวุ้ง\nวุฐิ\nวุฒ\nวุฒิ\nวุด\nวุ่น\nวุ้น\nวุบ\nวุ้ย\nวุลแฟรม\nวู้\nวูดวาด\nวูบ\nวู่วาม\nเว้\nเวค\nเวคิน\nเวคี\nเวจ\nเวช\nเวชยันต์\nเวฐน์\nเวณิ\nเวณิก\nเวณุ\nเวตน์\nเวตร\nเวตาล\nเวท\nเวทคู\nเวทนา\nเวทย์\nเวทัลละ\nเวทางค์\nเวทางคศาสตร์\nเวทานต์\nเวทานตะ\nเวทิ\nเวที\nเวธะ\nเวน\nเว้น\nเวนไตย\nเวไนย\nเวมัต\nเว้ย\nเวยยากรณะ\nเวร\nเวรมณี\nเวรี\nเวโรจน์\nเวลา\nเวเลนซี\nเวศม์\nเวศย์\nเวศยา\nเวสน์\nเวสภู\nเวสม์\nเวสวัณ\nเวสสะ\nเวสสันดร\nเวสสุกรรม\nเวสสุวัณ\nเวสารัช\nเวสิยา\nเวหน\nเวหะ\nเวหา\nเวหาส\nเวฬุ\nเวฬุริยะ\nเว่อ\nเว้า\nเวิก\nเวิ้ง\nเวี่ย\nเวียง\nเวียด\nเวียดนาม\nเวียน\nเวียร\nเวี่ยว\nแว้\nแวง\nแว้ง\nแวด\nแว้ด\nแวน\nแว่น\nแวนดา\nแวบ\nแว็บ\nแวม\nแว็ม\nแวว\nแว่ว\nแวะ\nโว\nโว่\nโวการ\nโว่ง\nโวทาน\nโวย\nโว้ย\nโว้เว้\nโวหาร\nไว\nไว้\nไวกูณฐ์\nไวฑูรย์\nไวทย์\nไวน์\nไวพจน์\nไวยากรณ์\nไวยาวัจกร\nไวยาวัจมัย\nไวรัส\nไววรรณ\nไวษณพ\nไวโอลิน\nศก\nศกุน\nศกุนต์\nศกุนิ\nศกุนี\nศจี\nศตะ\nศตภิษัช\nศตวรรษ\nศตพรรษ\nศตกะ\nศนิ\nศพ\nศมนะ\nศมะ\nศยาม\nศยามล\nศร\nศรายุธ\nศราวรณ์\nศรรกรา\nศรวณะ\nศรวณีย์\nศรวิษฐา\nศรัณย์\nศรัณยู\nศรัท\nศรัทธา\nศรัย\nศราทธ์\nศราทธพรต\nศราพก\nศราวก\nศราวณะ\nศรี\nศรีตรัง\nศรุติ\nศฤคาล\nศฤงค์\nศฤงคาร\nศฤงคาริน\nศฤงคารี\nศลิษฏ์\nศลิษา\nศวะ\nศวัส\nศวา\nศวาน\nศศะ\nศศธร\nศศพินทุ์\nศศลักษณ์\nศศิ\nศศิน\nศศี\nศศิขัณฑ์\nศศิธร\nศศิมณฑล\nศศิวิมล\nศอ\nศอก\nศักดา\nศักดิ\nศักดิ์\nศักดินา\nศักติ\nศักย\nศักยภาพ\nศักย์\nศักยะ\nศักร\nศักรินทร์\nศักเรนทร์\nศักราช\nศังกร\nศัตรู\nศันสนะ\nศันสนีย์\nศัพท์\nศัยยา\nศัล\nศัลย์\nศัลยกรรม\nศัลยแพทย์\nศัลยศาสตร์\nศัสดร\nศัสตร\nศัสตรศาสตร์\nศัสตรา\nศัสตราวุธ\nศากตะ\nศากย\nศากยะ\nศากยพุทธ\nศากยมุนี\nศาฎก\nศาณ\nศานต์\nศานติ\nศาป\nศารท\nศารทูล\nศาริกา\nศาล\nศาลา\nศาศวัต\nศาสดา\nศาสตร์\nศาสตรา\nศาสตราจารย์\nศาสนา\nศาสนกิจ\nศาสนจักร\nศาสนธรรม\nศาสนบุคคล\nศาสนพิธี\nศาสนวัตถุ\nศาสนศาสตร์\nศาสนสถาน\nศาสนสมบัติ\nศาสนิกชน\nศาสนีย์\nศาสนูปถัมภก\nศาสน์\nศิกษก\nศิการ\nศิขร\nศิขริน\nศิขรี\nศิขัณฑ์\nศิคาล\nศิงขร\nศิงขริน\nศิตะ\nศิถี\nศิพิระ\nศิระ\nศิรประภา\nศิราภรณ์\nศิโรรัตน์\nศิโรเวฐน์\nศิรา\nศิรามพุช\nศิโรราบ\nศิลป\nศิลป์\nศิลปะ\nศิลปกร\nศิลปกรรม\nศิลปกิจ\nศิลปวัตถุ\nศิลปวิทยา\nศิลปศาสตร์\nศิลปศึกษา\nศิลปหัตถกรรม\nศิลปิน\nศิลปี\nศิลา\nศิวะ\nศิวโมกข์\nศิวลึงค์\nศิวเวท\nศิวาลัย\nศิศีระ\nศิษฎิ\nศิษฏ์\nศิษย์\nศิษยานุศิษย์\nศีขร\nศีต\nศีตกาล\nศีรษะ\nศีล\nศึก\nศึกษา\nศึกษาธิการ\nศึกษานิเทศก์\nศุกร์\nศุกรวรรณ\nศุกรวาร\nศุกระ\nศุกล\nศุกลปักษ์\nศุจิ\nศุทธะ\nศุทธิ\nศุนะ\nศุนิ\nศุภกร\nศุภเคราะห์\nศุภนิมิต\nศุภมัสดุ\nศุภมาตรา\nศุภมาส\nศุภอักษร\nศุภางค์\nศูกร\nศุลกากร\nศุลการักษ์\nศุลี\nศุษิร\nศูทร\nศูนย์\nศูนยวาท\nศูละ\nศูลิน\nเศรณี\nเศรษฐ\nเศรษฐ์\nเศรษฐกิจ\nเศรษฐศาสตร์\nเศรษฐี\nเศร้า\nเศลษ\nเศวต\nเศวตร\nเศวตัมพร\nเศษ\nเศาจ\nเศาร์\nเศารยะ\nเศิก\nเศียร\nโศก\nโศกา\nโศกาดูร\nโศกาลัย\nโศกี\nโศจิ\nโศธนะ\nโศภน\nโศภะ\nโศภา\nโศภิต\nโศภิน\nโศภิษฐ์\nโศภี\nโศรดา\nโศรตร\nโศลก\nไศล\nไศวะ\nษมา\nษัฏ\nษัฑ\nษัณ\nษัษ\nษัษฐะ\nษัษฐี\nโษฑศัน\nสก\nสกวาที\nสกฏะ\nสกทาคามิผล\nสกิทาคามิผล\nสกทาคามิมรรค\nสกิทาคามิมรรค\nสกทาคามี\nสกิทาคามี\nสกนธ์\nสกปรก\nสกรณีย์\nสกรรจ์\nสกรรมกริยา\nสกล\nสกลมหาสังฆปริณายก\nสกัด\nสกา\nสกาว\nสกี\nสกุณ\nสกุณา\nสกุณี\nสกุน\nสกุนต์\nสกุล\nสเกต\nสแกนเดียม\nสขะ\nสง\nส่ง\nสงกร\nสงกรานต์\nสงกา\nสงค์\nสงคร\nสงคราม\nสงเคราะห์\nสงฆ์\nสงบ\nสงวน\nส่งสการ\nสงสัย\nสงสาร\nสงสารวัฏ\nสงัด\nสง่า\nสฐะ\nสณฑ์\nสด\nสดมภ์\nสดับ\nสดับปกรณ์\nสดำ\nสดุดี\nสตะ\nสตน\nสตภิสชะ\nสตรอนเชียม\nสตริกนิน\nสตรี\nสตัฟฟ์\nสตัมภ์\nสตางค์\nสติ\nสติปัฏฐาน\nสตี\nสตู\nสตูป\nสเต๊ก\nสถบดี\nสถล\nสถวีระ\nสถาน\nสถานะ\nสถานี\nสถาบัน\nสถาปนา\nสถาปนิก\nสถาปัตยกรรม\nสถาปัตยกรรมศาสตร์\nสถาปัตยเรขา\nสถาปัตยเวท\nสถาพร\nสถาวร\nสถิต\nสถิตยศาสตร์\nสถิติ\nสถิร\nสถีรวาท\nสถุล\nสถูป\nสทิง\nสทึง\nสทุม\nสธนะ\nสาธุสะ\nสน\nส้น\nสนทนา\nสนทรรศ\nสนทรรศน์\nสนเทศ\nสนเท่ห์\nสนธยา\nสนธิ\nสนน\nสนม\nสนวน\nสนอง\nสนอบ\nสนอม\nสนะ\nสนัด\nสนั่น\nสนับ\nสนับทึบ\nสนับสนุน\nสนาน\nสนาม\nสนายุ\nสนิกะ\nสนิท\nสนิธ\nสนิม\nสนุก\nสนุกเกอร์\nสนุข\nสนุต\nสนุ่น\nสบ\nสบง\nสบถ\nสบัน\nสบาย\nสบู่\nสไบ\nสปริง\nสปอร์\nสปาเกตตี\nสเปกตรัม\nสเปกโทรสโกป\nสไปริลลัม\nสพาบ\nสภา\nสภาพ\nสภาวการณ์\nสภาวะ\nสม\nสมการ\nสมจารี\nสมดุล\nสมมูล\nส้ม\nสมญา\nสมณะ\nสมณบริขาร\nสมณศักดิ์\nสมณสารูป\nสมเด็จ\nสมถะ\nสมถยานิก\nสมถวิปัสสนา\nสมนาคุณ\nสมบัติ\nสมบุกสมบัน\nสมบูรณ์\nสมบูรณาญาสิทธิราชย์\nสมประดี\nสมปฤดี\nสมปฤๅดี\nส้มป่อย\nสมปัก\nสมผุส\nสมพง\nสมพงศ์\nสมพล\nสมพัตสร\nสมพาส\nสมเพช\nสมโพธน์\nสมโพธิ\nสมภพ\nสมภาร\nสมโภค\nสมโภช\nสมมต\nสมมติ\nสมมุติ\nสมมาตร\nส้มมือ\nสมโมท\nสมโยค\nสมร\nสมรด\nสมรรถ\nสมรรถนะ\nสมรรถภาพ\nสมรส\nสมฤดี\nสมฤติ\nสมวายะ\nสมเสร็จ\nสมอ\nสมอง\nสมะ\nสมัคร\nสมังคี\nสมัช\nสมัชชา\nสมัญญา\nสมัต\nสมัน\nสมันต์\nสมัย\nสมา\nสมาคม\nสมาจาร\nสมาชิก\nสมาทาน\nสมาธิ\nสมาน\nสมานฉันท์\nสมาบัติ\nสมาพันธรัฐ\nสมาส\nสม่ำเสมอ\nสมิง\nสมิต\nสมิติ\nสมิทธ์\nสมิทธิ\nสมี\nสมุก\nสมุจจัย\nสมุจเฉท\nสมุฏฐาน\nสมุด\nสมุทร\nสมุทรโคดม\nสมุทัย\nสมุน\nสมุนไพร\nสมุลแว้ง\nสมุห\nสมุห์\nสมุหกลาโหม\nสมุหเทศาภิบาล\nสมุหนาม\nสมุหนายก\nสโมธาน\nสโมสร\nสยด\nสยนะ\nสยบ\nสยมพร\nสยมภู\nสยอง\nสยอน\nสยัมวรา\nสยาม\nสยามานุสติ\nสยามินทร์\nสยาย\nสยิว\nสยิ้ว\nสยุมพร\nสยุมภู\nสร\nสรง\nสร่ง\nสรณะ\nสรณคมน์\nสรณาคมน์\nสรณตรัย\nสรตะ\nสรทะ\nสรนุก\nสรเนาะ\nสรไน\nสรเพชญ\nสรภะ\nสรภัญญะ\nสรภู\nสรม\nสรร\nสรรค์\nสรรพ\nสรรพคุณ\nสรรพนาม\nสรรพสามิต\nสรรพัชญ\nสรรพากร\nสรรพางค์\nสรรเพชญ\nสรรเพชุดา\nสรรเสริญ\nสรลอน\nสรเลข\nสรวง\nสรวม\nสรวล\nสรเสริญ\nสร้อย\nสระ\nสระกอ\nสระท้อน\nสระพรั่ง\nสระอาด\nสรั่ง\nสรัสวดี\nสร่าง\nสร้าง\nสราญ\nสรี้\nสรีระ\nสรีรกิจ\nสรีรธาตุ\nสรีรวิทยา\nสรีรศาสตร์\nสรีรังคาร\nสรีรางคาร\nสรุป\nสโรช\nสโรชะ\nสฤก\nสฤต\nสฤษฎิ\nสฤษฎี\nสฤษฏ์\nสฤษดิ์\nสลด\nสลบ\nสลวน\nสลวย\nสลอด\nสลอน\nสลอย\nสละ\nสลัก\nสลัด\nสลัดได\nสลับ\nสลัว\nสลา\nสลาก\nสลาง\nสล้าง\nสลาด\nสลาตัน\nสลาบ\nสลาย\nสลิด\nสลิล\nสลึก\nสลึง\nสลุต\nสลุบ\nสลุมพร\nสแลง\nสวการย์\nสวภาพ\nสวราชย์\nสวก\nส้วง\nสวด\nสวน\nสวนะ\nสวนาการ\nส่วน\nสวนิต\nสวบ\nสวม\nส้วม\nสวย\nส่วย\nส้วย\nสวยม\nสวรรค\nสวรรค์\nสวรรคต\nสวรรคาลัย\nสวรรยา\nสวระ\nสวะ\nสวัสดิ\nสวัสดิ์\nสวัสดิการ\nสวัสดิภาพ\nสวัสดิมงคล\nสวัสดี\nสวัสติ\nสวาตี\nสวัสติกะ\nสวา\nสวาปาม\nสวาคตะ\nสวาง\nสว่าง\nสวาด\nสวาดิ\nสวาท\nสว่าน\nสว้าน\nสวาบ\nสวามิ\nสวามี\nสวามินี\nสวาย\nสวาสดิ์\nสวาหะ\nสวิง\nสวิญญาณกทรัพย์\nสวิตช์\nสสาร\nสสุระ\nสสุรี\nสหกรณ์\nสหการ\nสหจร\nสหชาต\nสหชาติ\nสหธรรม\nสหธรรมิก\nสหประชาชาติ\nสหพันธ์\nสหพันธรัฐ\nสหภาพ\nสหศึกษา\nสหัช\nสหัมบดี\nสหัส\nสหัสสะ\nสหัสธารา\nสหัสนัยน์\nสหัสเนตร\nสหัสรังสี\nสหัสา\nสหาย\nสอ\nส่อ\nสอง\nส่อง\nส้อง\nสอด\nสอน\nส่อน\nสอบ\nสอพลอ\nส้อม\nสอย\nสะ\nสะกด\nสะกอ\nสะกาง\nสะการะ\nสะกิด\nสะกิดสะเกา\nสะเก็ด\nสะแก\nสะคร้อ\nสะคราญ\nสะค้าน\nสะเงาะสะแงะ\nสะดม\nสะดวก\nสะดิ้ง\nสะดึง\nสะดือ\nสะดุ้ง\nสะดุด\nสะเด็ด\nสะเดา\nสะเดาะ\nสะตอ\nสะตาหมัน\nสะตึ\nสะตือ\nสะตุ\nสะเต๊ะ\nสะโตก\nสะทก\nสะท้อน\nสะท้าน\nสะทึก\nสะเทิน\nสะเทิ้น\nสะเทือน\nสะเทื้อน\nสะบะ\nสะบัก\nสะบักสะบอม\nสะบัด\nสะบัดสะบิ้ง\nสะบั้น\nสะบันงา\nสะบ้า\nสะบู\nสะแบง\nสะเปะสะปะ\nสะพรั่ง\nสะพรึงกลัว\nสะพรึบ\nสะพรึ่บ\nสะพัก\nสะพัง\nสะพัด\nสะพั้น\nสะพาน\nสะพาย\nสะเพร่า\nสะโพก\nสะเภา\nสะใภ้\nสะโมง\nสะระตะ\nสะระแหน่\nสะลาง\nสะลาบ\nสะลึมสะลือ\nสะวี้ดสะว้าด\nสะสม\nสะสวย\nสะสาง\nสะเหล่อ\nสะอาง\nสะอาด\nสะอ้าน\nสะอิ้ง\nสะอิดสะเอียน\nสะอึก\nสะอื้น\nสะเอ้ง\nสะเอว\nสะเออะ\nสะโอดสะอง\nสะไอ\nสัก\nสักกะ\nสักยะ\nสักกัจจะ\nสักกายทิฐิ\nสักการ\nสักการะ\nสักขี\nสักวา\nสักหลาด\nสัค\nสัคคะ\nสั่ง\nสังกร\nสังกรณี\nสังกรประโยค\nสังกะตัง\nสังกะวัง\nสังกะวาด\nสังกะสี\nสังกัด\nสังกัปปะ\nสังกา\nสังการ\nสังกาศ\nสังกิเลส\nสังเกต\nสังข์\nสังขกร\nสังขตธรรม\nสังขตะ\nสังขยา\nสังขลิก\nสังขลิกา\nสังขาร\nสังขารา\nสังเขป\nสังค์\nสังคญาติ\nสังคม\nสังคหะ\nสังคัง\nสังคายนา\nสังคายนาย\nสังคีต\nสังคีติ\nสังเค็ด\nสังเคราะห์\nสังฆกรรม\nสังฆการี\nสังฆเถระ\nสังฆทาน\nสังฆนายก\nสังฆปาโมกข์\nสังฆภัต\nสังฆเภท\nสังฆมณฑล\nสังฆมนตรี\nสังฆราช\nสังฆสภา\nสังฆาณัติ\nสังฆาฏิ\nสังฆาทิเสส\nสังฆาธิการ\nสังฆานุสติ\nสังฆาวาส\nสังยุตนิกาย\nสังโยค\nสังโยชน์\nสังวร\nสังวัจฉระ\nสังวัธยาย\nสังวาล\nสังวาส\nสังเวคะ\nสังเวช\nสังเวชนียสถาน\nสังเวย\nสังเวียน\nสังสกฤต\nสังสการ\nสังสนทนา\nสั่งสนทนา\nสังสรรค์\nสังสารวัฏ\nสังสิทธิ\nสังสุทธ์\nสังสุทธิ\nสังหร\nสังหรณ์\nสังหาร\nสังหาริมทรัพย์\nสังหาริมะ\nสังหิต\nสัจ\nสัจกิริยา\nสัจจะ\nสัจญาณ\nสัจธรรม\nสัจนิยม\nสัจพจน์\nสัชฌะ\nสัชฌุ\nสัญจร\nสัญเจตนา\nสัญชาตญาณ\nสัญชาติ\nสัญฌา\nสัญญา\nสัญญาณ\nสัญญี\nสัญโญชน์\nสัญนิยม\nสัญประกาศ\nสัญลักษณ์\nสัฐิ\nสัณฐาน\nสัณฐิติ\nสัณฑ์\nสัณห์\nสัด\nสัดจอง\nสัต\nสัตตะ\nสัตตาหกรณียะ\nสัตตาหกาลิก\nสัตมวาร\nสัตสดก\nสัตตบงกช\nสัตตบรรณ\nสัตตบุษย์\nสัตตู\nสัตถันดร\nสัตถา\nสัตถิ\nสัตถุ\nสัตถุศาสนา\nสัตบรรณ\nสัตย์\nสัตยพรต\nสัตยวาที\nสัตยาเคราะห์\nสัตยาธิษฐาน\nสัตยาบัน\nสัตว์\nสัตวชาติ\nสัตวบาล\nสัตวแพทย์\nสัตววิทยา\nสัตวา\nสัทธรรม\nสัทธา\nสัทธาจริต\nสัทธาธิกะ\nสัทธินทรีย์\nสัทธิงวิหาริก\nสัทธิวิหาริก\nสัทวิทยา\nสัทศาสตร์\nสัทอักษร\nสัน\nสั่น\nสั้น\nสันดาน\nสันดาป\nสันโดษ\nสันต์\nสันตติ\nสันตะปาปา\nสันตะวา\nสันติ\nสันตุฏฐี\nสันถวไมตรี\nสันถวะ\nสันถัต\nสันถาร\nสันทนะ\nสันทะ\nสันทัด\nสันทัสนะ\nสันทาน\nสันทิฐิก\nสันทิส\nสันเทหะ\nสันธาน\nสันนิธิ\nสันนิบาต\nสันนิวาส\nสันนิษฐาน\nสันสกฤต\nสับ\nสับปลับ\nสับปลี้\nสับปะรด\nสัปคับ\nสัปดาห์\nสัปดาหะ\nสัปดน\nสัปตศก\nสัปทน\nสัปปะ\nสัปปิ\nสัปปุริส\nสัปปุรุษ\nสัประยุทธ์\nสัปหงก\nสัปเหร่อ\nสัพ\nสัพพะ\nสัพพัญญู\nสัพเพเหระ\nสัพยอก\nสัมบูรณ์\nสัมปชัญญะ\nสัมปทา\nสัมปทาน\nสัมปยุต\nสัมปโยค\nสัมประสิทธิ์\nสัมประหาร\nสัมปรายภพ\nสัมปรายิกภพ\nสัมปัตติ\nสัมผัปลาป\nสัมผัปลาปะ\nสัมผัส\nสัมพล\nสัมพหุลา\nสัมพัจฉรฉินท์\nสัมพัตสร\nสัมพัทธ์\nสัมพันธ์\nสัมพันธน์\nสัมพันธภาพ\nสัมพันธมิตร\nสัมพันธไมตรี\nสัมพาหะ\nสัมพุทธ\nสัมพุทธะ\nสัมโพธิ\nสัมภวะ\nสัมภเวสี\nสัมภัต\nสัมภัตตะ\nสัมภาระ\nสัมภาษณ์\nสัมโภคกาย\nสัมมนา\nสัมมัปธาน\nสัมมา\nสัมโมทนียกถา\nสัมฤทธิ\nสัมฤทธิ์\nสัมฤทธิศก\nสัยน์\nสัลเลข\nสัสดี\nสัสตทิฐิ\nสัสสะ\nสัสสุ\nสัสสู\nสา\nส่า\nสาก\nสากรรจ์\nสากล\nสากัจฉา\nสากัลย์\nสากิยะ\nสาเก\nสาขา\nสาคร\nสาคเรศ\nสาคู\nสาง\nส้าง\nสาชล\nสาฎก\nสาฏิก\nสาณี\nสาด\nสาไถย\nสาทร\nสาทิส\nสาทุ\nสาโท\nสาธก\nสาธยะ\nสาธยาย\nสาธารณะ\nสาธารณชน\nสาธารณประโยชน์\nสาธารณภัย\nสาธารณรัฐ\nสาธารณสถาน\nสาธารณสมบัติ\nสาธารณสุข\nสาธารณูปการ\nสาธารณูปโภค\nสาธารณ์\nสาธิต\nสาธุ\nสาน\nส่าน\nสานุ\nสานู\nสานุศิษย์\nสาบ\nสาบสูญ\nสาบาน\nสาป\nสาปไตย\nสาม\nสามชุก\nสามเณร\nสามเณรี\nสามนต์\nสามนตราช\nสามยทรัพย์\nสามล\nสามหาว\nสามะ\nสามัคคี\nสามัญ\nสามัตถิยะ\nสามานย์\nสามานยนาม\nสามารถ\nสามิต\nสามินี\nสามิภักดิ์\nสามี\nสามีจิกรรม\nสาย\nส่าย\nส้าย\nสายชู\nสายัณห์\nสายาห์\nสาร\nสารคดี\nสารธรรม\nสารนิเทศ\nสารบบ\nสารบรรณ\nสารบัญ\nสารบาญ\nสารบาญชี\nสารประโยชน์\nสารสนเทศ\nสารทุกข์\nสารถี\nสารท\nสารพัด\nสารพัน\nสารพางค์\nสารภาพ\nสารภี\nสารวัตร\nสาระ\nสาระแน\nสาระพา\nสาระยำ\nสาระวารี\nสาระสะมา\nสารัตถประโยชน์\nสารัตถศึกษา\nสารัตถะ\nสารัทธ์\nสารัมภ์\nสาราณียกร\nสาราณียธรรม\nสาราณียะ\nสารานุกรม\nสารีริกธาตุ\nสารูป\nสาโรช\nสาละ\nสาละวน\nสาลิ\nสาลิกา\nสาลินี\nสาลี\nสาลี่\nสาลู\nสาโลหิต\nสาว\nสาวก\nสาวิกา\nสาวิตร\nสาวิตรี\nสาสน\nสาสน์\nสาส์น\nสาสนา\nสาสม\nสาหร่าย\nสาหรี\nส่าหรี\nสาหัส\nสาเหตุ\nสาแหรก\nสำ\nสำส่อน\nส่ำ\nสำคัญ\nสำซ่าง\nสำแดง\nสำทับ\nสำนวน\nสำนอง\nสำนัก\nสำนาน\nสำนึก\nสำนึง\nสำเนา\nสำเนียง\nสำบัด\nสำปะลอ\nสำปะหลัง\nสำปั้น\nสำปันนี\nสำเภา\nสำมะงา\nสำมะโน\nสำมะลอ\nสำมะเลเทเมา\nสำมะหา\nสำรด\nสำรวจ\nสำรวม\nสำรวย\nสำรวล\nสำรอก\nสำรอง\nสำรับ\nสำราก\nสำราญ\nสำริด\nสำเร็จ\nสำเรา\nสำเริง\nสำโรง\nสำลัก\nสำลาน\nสำลี\nสำแลง\nสำหรวด\nสำหรับ\nสำหา\nสำเหนียก\nสำเหร่\nสำออย\nสำอาง\nสิ\nสิกข์\nสิข\nสิกขมานา\nสิกขา\nสิขร\nสิขรี\nสิขเรศ\nสิขา\nสิขานล\nสิขี\nสิคาล\nสิง\nสิ่ง\nสิงขร\nสิงค์\nสิงคลิ้ง\nสิงคลี\nสิงคาร\nสิงคาล\nสิงคี\nสิงโต\nสิงห์\nสิงหนาท\nสิงหบัญชร\nสิงหรา\nสิงหราช\nสิงหาคม\nสิงหาสน์\nสิงหล\nสิญจน์\nสิตะ\nสิตางศุ์\nสิถิล\nสิทธ์\nสิทธัตถะ\nสิทธา\nสิทธาจารย์\nสิทธารถ\nสิทธิ\nสิทธิ์\nสิทธิการิยะ\nสิธยะ\nสิน\nสิ้น\nสินเทา\nสินธพ\nสินธุ\nสินธุ์\nสินธุระ\nสินธู\nสินเธาว์\nสินาด\nสินิทธ์\nสินี\nสิเนรุ\nสิเนหก\nสิเนหะ\nสิเนหา\nสิเน่หา\nสิบ\nสิปปะ\nสิมพลี\nสิระ\nสิโรดม\nสิโรตม์\nสิริ\nสิรี\nสิลา\nสิว\nสิ่ว\nสิวะ\nสิวาลัย\nสิวิกา\nสี\nสี่\nสี้\nสีกา\nสีกุน\nสีข้าง\nสีด\nสีดอ\nสีดา\nสีตลรัศมี\nสีตโลทก\nสีโตทก\nสีทันดร\nสีมันต์\nสีมา\nสีละมัน\nสีวิกา\nสีสอ\nสีสะ\nสีสา\nสีสุก\nสีเสียด\nสีห์\nสีหนาท\nสีหบัญชร\nสีหราช\nสีหไสยา\nสีหไสยาสน์\nสีหะ\nสึก\nสึง\nสืบ\nสื่อ\nสุ\nสุก\nสุกข์\nสุกร\nสุกรม\nสุกำศพ\nสุกียากี้\nสุข\nสุขา\nสุขาภิบาล\nสุขารมณ์\nสุขาวดี\nสุขิน\nสุขี\nสุขุม\nสุขุมาล\nสุโข\nสุคต\nสุคติ\nสุคนธ\nสุคนธ์\nสุคนธชาติ\nสุคนธรส\nสุคันธ์\nสุคันธรส\nสุงกะ\nสุงกากร\nสุงสิง\nสุงสุมาร\nสุจริต\nสุจหนี่\nสุจิ\nสุจิต\nสุจิตร\nสุชน\nสุชัมบดี\nสุชา\nสุชาดา\nสุญ\nสุญญากาศ\nสุญตา\nสุญนิยม\nสุณ\nสุณิสา\nสุด\nสุดา\nสุต\nสุตตนิบาต\nสุตตะ\nสุตตันตปิฎก\nสุตตันตะ\nสุติ\nสุทธ\nสุทธ์\nสุทธาวาส\nสุทธิ\nสุทรรศน์\nสุทัศน์\nสุธา\nสุธาโภชน์\nสุธารส\nสุธาสินี\nสุธาสี\nสุธี\nสุนทร\nสุนทรี\nสุนทรียภาพ\nสุนทรียศาสตร์\nสุนทรียะ\nสุนัข\nสุนันท์\nสุโนก\nสุบดี\nสุบรรณ\nสุบิน\nสุปรีดิ์\nสุปรีย์\nสุปาณี\nสุพพัต\nสุพรรณ\nสุพรรณบัฏ\nสุพรรณภาชน์\nสุพรรณราช\nสุพรรณศรี\nสุพรรณถัน\nสุพรรณิการ์\nสุภร\nสุภัค\nสุภา\nสุภาพ\nสุภาษิต\nสุม\nสุ่ม\nสุมทุม\nสุมน\nสุมนะ\nสุมนัส\nสุมนา\nสุ้มเสียง\nสุมะ\nสุมาลี\nสุเมธ\nสุเมรุ\nสุรคต\nสุรเชษฐ์\nสุรบดี\nสุรภาพ\nสุรโลก\nสุรสีหนาท\nสุรเสียง\nสุรงค์\nสุรังค์\nสุรภี\nสุรัติ\nสุรัสวดี\nสุรา\nสุรางค์จำเรียง\nสุรางคนา\nสุรางคนางค์\nสุรารักษ์\nสุราลัย\nสุรินทร์\nสุรินทราหู\nสุริยะ\nสุริยกันต์\nสุริยกานต์\nสุริยการ\nสุริยกาล\nสุริยคติ\nสุริยคราส\nสุริยมณฑล\nสุริยวงศ์\nสุริยง\nสุริยา\nสุริเยนทร์\nสุริเยศ\nสุริโย\nสุริยน\nสุริยัน\nสุริยุปราคา\nสุรีย์\nสุรุ่ยสุร่าย\nสุลต่าน\nสุวคนธ์\nสุวภาพ\nสุวรรณ\nสุวรรณภูมิ\nสุวะ\nสุวาน\nสุวินัย\nสุวิมล\nสุษิระ\nสุสาน\nสุหนัต\nสุหร่ง\nสุหร่าย\nสุหฤท\nสุหัท\nสุเหร่า\nสู\nสู่\nสู้\nสูง\nสูจิ\nสูจิบัตร\nสูญ\nสูด\nสูต\nสูตร\nสูติ\nสูติกรรม\nสูตินรีเวช\nสูติบัตร\nสูติแพทย์\nสูติศาสตร์\nสูท\nสูทกรรม\nสูทศาสตร์\nสูบ\nสูปะ\nสูร\nสูรย์\nสูรยกานต์\nสูริ\nสูสี\nเส\nเสก\nเสกขบุคคล\nเสกขะ\nเสขบุคคล\nเสขะ\nเส็ง\nเส้ง\nเส็งเคร็ง\nเสงี่ยม\nเสฏฐี\nเสณี\nเสด\nเสด็จ\nเสตุ\nเสถียร\nเสทะ\nเสโท\nเสน\nเส้น\nเสนง\nเสน่ง\nเสน่ห์\nเสนหา\nเสน่หา\nเสนอ\nเสนะ\nเสนา\nเสนาธิการ\nเสนาบดี\nเสน่า\nเสนากุฎ\nเสนางค์\nเสนางคนิกร\nเสนานี\nเสนาสนะ\nเสนาะ\nเสนี\nเสนีย์\nเสนียะ\nเสนียด\nเสบย\nเสบียง\nเสพ\nเสพย์\nเสเพล\nเสภา\nเสม็ด\nเสมหะ\nเสมอ\nเสมา\nเสมียน\nเสมือน\nเสย\nเสร็จ\nเสริด\nเสริม\nเสรี\nเสลด\nเสลบรรพต\nเสลา\nเสลี่ยง\nเสลือกสลน\nเสโล\nเสวก\nเสวกามาตย์\nเสวนะ\nเสวนา\nเสวย\nเสวียน\nเสสรวง\nเสสรวล\nเสา\nเส้า\nเสาร์\nเสารภย์\nเสารี\nเสาวคนธ์\nเสาวธาร\nเสาวภา\nเสาวภาคย์\nเสาวภาพ\nเสาวรภย์\nเสาวรส\nเสาวลักษณ์\nเสาวณิต\nเสาวนะ\nเสาวนา\nเสาวนีย์\nเสาหฤท\nเสาะ\nเสาะแสะ\nเสิร์จ\nเสิร์ฟ\nเสีย\nเสียง\nเสี่ยง\nเสียด\nเสี้ยน\nเสียบ\nเสียม\nเสี่ยม\nเสี้ยม\nเสียว\nเสี่ยว\nเสี้ยว\nเสือ\nเสื่อ\nเสื้อ\nเสือก\nเสื่อม\nแส\nแส่\nแส้\nแสก\nแสง\nแสด\nแสดง\nแสตมป์\nแสน\nแสนย์\nแสนยากร\nแสนยานุภาพ\nแสบ\nแสม\nแสยก\nแสยง\nแสยะ\nแสรก\nแสร้ง\nแสลง\nแสล้ม\nแสวง\nแสะ\nโสก\nโสกโดก\nโสกันต์\nโสโครก\nโสณฑ์\nโสณิ\nโสณี\nโสด\nโสดก\nโสดม\nโสดา\nโสดาบัน\nโสดาปัตติผล\nโสดาปัตติมรรค\nโสต\nโสตทัศนวัสดุ\nโสตทัศนอุปกรณ์\nโสตทัศนูปกรณ์\nโสตินทรีย์\nโสตถิ\nโสทก\nโสทร\nโสธก\nโสธนะ\nโสน\nโสภณ\nโสภา\nโสภี\nโสภิณี\nโสเภณี\nโสม\nโสมนัส\nโสมม\nโสมย์\nโสร่ง\nโสรจ\nโสรวาร\nโสโร\nโสวรรณ\nโสหุ้ย\nโสฬส\nใส\nใส่\nไส\nไส้\nไสย\nไสยา\nไสยาสน์\nไสร้\nไสว\nหก\nหกคะเมน\nหง\nหงก\nหงส์\nหงสบาท\nหงสรถ\nหงอ\nหงอก\nหง่อง\nหงองแหงง\nหงอด\nหงอน\nหง่อม\nหงอย\nหง่อย\nหงัก\nหงับ\nหง่าง\nหงาย\nหง่าว\nหงำ\nหงิก\nหงิง\nหงิม\nหงึก\nหงุงหงิง\nหงุดหงิด\nหงุบ\nหงุ่ย\nหญ้า\nหญ้าฝรั่น\nหญ้ายายเภา\nหญิง\nหญิบ\nหด\nหตะ\nหทัย\nหน\nหนวก\nหน่วง\nหนวด\nหน่วย\nหน่วยกิต\nหนอ\nหน่อ\nหนอก\nหนอง\nหนอน\nหนอนตายหยาก\nหน่อย\nหน็อยแน่\nหนัก\nหนัง\nหนังสติ๊ก\nหนังสือ\nหนั่น\nหนับ\nหนา\nหน้า\nหน่าง\nหนาด\nหนาน\nหนาม\nหน่าย\nหนาว\nหนำ\nหนำเลี้ยบ\nหนี\nหนี้\nหนีบ\nหนึก\nหนึ่ง\nหนึบ\nหนืด\nหนุ\nหนุน\nหนุบ\nหนุ่ม\nหนุ่ย\nหนู\nห่ม\nหมก\nหมด\nหม่น\nหมวก\nหมวด\nหมวน\nหมอ\nหม่อ\nหม้อ\nหมอก\nหมอง\nหม่อง\nหมอน\nหม่อน\nหมอบ\nหม่อม\nหมอย\nหม้อห้อม\nหมัก\nหมักหมม\nหมัด\nหมัน\nหมั่น\nหมั้น\nหมับ\nหมา\nหม่า\nหมาก\nหมากฮอส\nหมาง\nหมาด\nหมามุ่ย\nหมามุ้ย\nหมาย\nหม้าย\nหมาร่า\nหม่ำ\nหม้ำ\nหมิ่น\nหมี\nหมี่\nหมึก\nหมืน\nหมื่น\nหมุด\nหมุน\nหมุบ\nหมุบหมับ\nหมุบหมิบ\nหมุ่ย\nหมุยขาว\nหมู\nหมู่\nหมูหริ่ง\nหยก\nหย่ง\nหยด\nหยวก\nหยวบ\nหยอก\nหยอกเอิน\nหย็อกหย็อย\nหยอง\nหย็อง\nหย่อง\nหย็องกรอด\nหย็องแหย็ง\nหยอด\nหยอน\nหย่อน\nหย่อม\nหย็อมแหย็ม\nหย็อย\nหย่อย\nหยัก\nหยักไย่\nหยักเหยา\nหยัง\nหยั่ง\nหยังหยัง\nหยัด\nหยัน\nหยับ\nหยั่วเมือง\nหย่า\nหยากเยื่อ\nหยากไย่\nหยาด\nหยาบ\nหยาม\nหยาว\nหย้าว\nหยำเป\nหยำเหยอะ\nหยำแหยะ\nหยิก\nหยิ่ง\nหยิบ\nหยิม\nหยี\nหยี่\nหยุกหยิก\nหยุด\nหยุ่น\nหยุบ\nหยุมหยิม\nหยูกยา\nหโยดม\nหรคุณ\nหรณะ\nหรดาล\nหรดี\nหรรษ์\nหรรษา\nหรอ\nหรอก\nหร็อมแหร็ม\nหรอย\nหระ\nหรับ\nหรา\nหริ\nหริ่ง\nหริณะ\nหริต\nหริตกี\nหรีตกี\nหรี่\nหรีด\nหรือ\nหรุบ\nหรุบรู่\nหรุบหรู่\nหรุ่ม\nหรู\nหรูหรา\nหฤทัย\nหฤทย์\nหฤษฎ์\nหฤษฎี\nหฤหรรษ์\nหฤโหด\nหลง\nหลงใหล\nหลงจู๊\nหลด\nหลน\nหล่น\nหลบ\nหล่ม\nหลวง\nหลวม\nหลอ\nหล่อ\nหลอก\nหลอด\nหลอน\nหล็อน\nหล่อน\nหลอม\nหละ\nหละหลวม\nหลัก\nหลัง\nหลั่ง\nหลัด\nหลั่น\nหลับ\nหลัว\nหลา\nหล้า\nหลาก\nหลาน\nหลาบ\nหลาม\nหลาย\nหลาว\nหลิ่ง\nหลิท\nหลิน\nหลิม\nหลิว\nหลิ่ว\nหลี\nหลีก\nหลีโก\nหลีบ\nหลีฮื้อ\nหลืบ\nหลุกหลิก\nหลุด\nหลุน\nหลุบ\nหลุม\nหลุมพอ\nหลุมพี\nหลู่\nหวง\nห่วง\nห้วง\nหวด\nหวน\nห้วน\nหวย\nห้วย\nหวอ\nหวอด\nหวะ\nหวัง\nหวัด\nหวั่น\nหวันยิหวา\nหวัว\nหวัวร่อ\nหวัวเราะ\nหวา\nหว่า\nหว้า\nหวาก\nหว่าง\nหวาด\nหวาน\nหว่าน\nหวาม\nหวาย\nหวำ\nหวิด\nหวิว\nหวี\nหวี่\nหวีด\nหวือ\nหวุดหวิด\nหวูด\nหอ\nห่อ\nห้อ\nหอก\nหอง\nห้อง\nหอน\nห่อน\nหอบ\nหอม\nห้อม\nหอย\nห้อย\nหะ\nหะยี\nหะหาย\nหัก\nหัจญ์\nหัจญี\nหัช\nหัฏฐะ\nหัด\nหัต\nหัตถ์\nหัตถกรรม\nหัตถการ\nหัตถกิจ\nหัตถบาส\nหัตถพันธ์\nหัตถาภรณ์\nหัตถศาสตร์\nหัตถศิลป์\nหัตถศึกษา\nหัตถาจารย์\nหัตถินี\nหัตถี\nหัน\nหั่น\nหั้น\nหันตรา\nหับ\nหัย\nหัว\nหัวร่อ\nหัวเราะ\nหัส\nหัสดิน\nหัสดี\nหัสต์\nหัสตะ\nหา\nห่า\nห้า\nหาก\nหาง\nห่าง\nห้าง\nหาญ\nหาด\nห่าน\nหาบ\nหาม\nห่าม\nห้าม\nหาย\nหายใจ\nหายนะ\nหาร\nหารือ\nหาว\nห้าว\nหาสะ\nหำ\nห้ำ\nหิ้ง\nหิงคุ\nหิงสา\nหิงห้อย\nหิ่งห้อย\nหิ่งหาย\nหิด\nหิต\nหิตานุหิตประโยชน์\nหิน\nหิมพาน\nหิมพานต์\nหิมวัต\nหิมวันต์\nหิมวา\nหิมะ\nหิมาลัย\nหิรัญ\nหิรัญญิการ์\nหิรัญบัฏ\nหิรัณย์\nหิรัณยรัศมี\nหิริ\nหิว\nหิ้ว\nหี\nหีด\nหีนยาน\nหีบ\nหึ\nหึง\nหึ่ง\nหึงสา\nหืด\nหืน\nหื่น\nหือ\nหื้อ\nหุง\nหุน\nหุ่น\nหุ้น\nหุนหัน\nหุบ\nหุ้ม\nหุยฮา\nหู\nหู่\nหูก\nหูด\nเห\nเห่\nเหง\nเหง่ง\nเหงา\nเหง้า\nเหงื่อ\nเหงือก\nเห็จ\nเห็ด\nเหติ\nเหตุ\nเห็น\nเหน่ง\nเหนงนายพราน\nเหน็ดเหนื่อย\nเหน็บ\nเหน่อ\nเห็นอ้ม\nเหนอะ\nเหนอะหนะ\nเหน้า\nเหนาะ\nเหนียง\nเหนี่ยง\nเหนี่ยน\nเหนียม\nเหนียว\nเหนี่ยว\nเหนือ\nเหนื่อย\nเห็บ\nเหม\nเหม่\nเหม็ง\nเหม่ง\nเหม็น\nเหมวดี\nเหม่อ\nเหมันต์\nเหมันตฤดู\nเหมา\nเหมายัน\nเหมาะ\nเหมียว\nเหมี่ยว\nเหมือง\nเหมือด\nเหมือน\nเหมื่อย\nเหย\nเหยง\nเหย่อย\nเหยา\nเหย่า\nเหย้า\nเหยาะ\nเหยาะแหยะ\nเหยิง\nเหยิบ\nเหยียด\nเหยียบ\nเหยี่ยว\nเหยื่อ\nเหยือก\nเหรอ\nเหรอะ\nเหรัญญิก\nเหรา\nเหราะ\nเหรียญ\nเหล่\nเหล็ก\nเหลน\nเหลว\nเหลอ\nเหลา\nเหล่า\nเหล้า\nเหลาะแหละ\nเหลิง\nเหลิงเจิ้ง\nเหลียน\nเหลี่ยม\nเหลียว\nเหลือ\nเหลือก\nเหลือง\nเหลือบ\nเหลือม\nเหลื่อม\nเหว\nเหว่\nเหวง\nเหวย\nเหวอะ\nเหวอะหวะ\nเหวี่ยง\nเห่อ\nเหอะ\nเหะ\nเหะหะ\nเหา\nเห่า\nเหาะ\nเหิน\nเหิม\nเหี้ย\nเหียง\nเหียน\nเหี้ยน\nเหี้ยม\nเหี่ยว\nเหื่อ\nเหือด\nแห\nแห่\nแห้\nแหก\nแหง\nแหง่\nแห่ง\nแห้ง\nแหงแก๋\nแหง่ง\nแหงน\nแหน\nแห้น\nแหนง\nแหนบ\nแหนม\nแหบ\nแหม\nแหม่\nแหม่ม\nแหมะ\nแหย\nแหย่\nแหยง\nแหย่ง\nแหยม\nแหย็ม\nแหยะ\nแหล่\nแหลก\nแหล่ง\nแหลน\nแหลม\nแหละ\nแหว\nแห้ว\nแหวก\nแหว่ง\nแหวด\nแหวน\nแหวะ\nแหะ\nโห่\nโหง\nโหด\nโหน\nโหนก\nโหน่ง\nโหม\nโหม่ง\nโหมด\nโหย\nโหยกเหยก\nโหยง\nโหย่ง\nโหร\nโหรง\nโหรงเหรง\nโหรดาจารย์\nโหระพา\nโหรา\nโหราจารย์\nโหราศาสตร์\nโหล\nโหล่\nโหลงโจ้ง\nโหว\nโหว่\nโหว้\nโหวกเหวก\nโหวง\nโหวด\nโหวต\nให้\nใหญ่\nใหม่\nไห\nไห่\nไห้\nไหน\nไหม\nไหม้\nไหรณย์\nไหล\nไหล่\nไหว\nไหว้\nไหหลำ\nอก\nอกตเวทิตา\nอกตเวที\nอกตัญญุตา\nอกตัญญู\nอกนิษฐ์\nอกรณีย์\nอกรรมกริยา\nอกัปปิยวัตถุ\nอกัปปิยะ\nอกุศล\nอคติ\nอคาธ\nอโฆษะ\nองก์\nองค์\nองคชาต\nองคมนตรี\nองครักษ์\nองคาพยพ\nองคุลี\nองศ์\nองศา\nองอาจ\nองุ่น\nอจลา\nอจินตา\nอจินไตย\nอจิระ\nอเจลก\nอเจละ\nอชะ\nอชิน\nอชินี\nอชิระ\nอฏวี\nอณิ\nอณู\nอโณทัย\nอด\nอดิถี\nอดิเทพ\nอดิเรก\nอดิศร\nอดิศวร\nอดิศัย\nอดีต\nอดุล\nอดุลย์\nอติ\nอติชาต\nอติมานะ\nอติราช\nอติเรก\nอติสาร\nอถรรพเวท\nอาถรรพเวท\nอทระ\nอทินนาทาน\nอธรรม\nอธิ\nอธิกมาส\nอธิกรณ์\nอธิกวาร\nอธิกสุรทิน\nอธิการ\nอธิคม\nอธิฏฐาน\nอธิบดี\nอธิบาย\nอธิป\nอธิปไตย\nอธิมาตร\nอธิมุตติ\nอธิโมกข์\nอธิราช\nอธิวาส\nอธิวาสนะ\nอธิศีล\nอธิษฐาน\nอธึก\nอ้น\nอนงค์\nอนงคณะ\nอนงคเลขา\nอนธการ\nอนนต์\nอนยะ\nอนรรฆ\nอนรรถ\nอนล\nอนวัช\nอนัญ\nอนัตตา\nอนันต์\nอนันตริยกรรม\nอนัม\nอนาคต\nอนาคามิผล\nอนาคามิมรรค\nอนาคามี\nอนาจาร\nอนาถ\nอนาถา\nอนาทร\nอนาธิปไตย\nอนามัย\nอนามิกา\nอนารยชน\nอนารยธรรม\nอนารยะ\nอนาลัย\nอนำ\nอนิจ\nอนิจจัง\nอนิจจา\nอนิฏฐารมณ์\nอนิยต\nอนิยม\nอนิล\nอนิวรรต\nอนิวรรตน์\nอนีกะ\nอนีจะ\nอนึก\nอนึ่ง\nอนุ\nอนุกร\nอนุกรม\nอนุกรรมการ\nอนุกระเบียด\nอนุกาชาด\nอนุการ\nอนุกูล\nอนุคามิก\nอนุเคราะห์\nอนุจร\nอนุช\nอนุชน\nอนุชา\nอนุชาต\nอนุชิต\nอนุญาต\nอนุญาโตตุลาการ\nอนุตร\nอนุเถระ\nอนุทิน\nอนุบท\nอนุบาล\nอนุประโยค\nอนุปริญญา\nอนุปสัมบัน\nอนุปัสนา\nอนุพงศ์\nอนุพัทธ์\nอนุพันธ์\nอนุโพธ\nอนุภรรยา\nอนุภริยา\nอนุภาค\nอนุภาษ\nอนุมัติ\nอนุมาตรา\nอนุมาน\nอนุมูล\nอนุโมทนา\nอนุโยค\nอนุรักษ์\nอนุรักษนิยม\nอนุราช\nอนุราธ\nอนุราธะ\nอนุราธา\nอนุรูป\nอนุโลม\nอนุวงศ์\nอนุวรรตน์\nอนุวัต\nอนุวัตน์\nอนุวัตร\nอนุวัติ\nอนุวาต\nอนุศาสก\nอนุศาสน์\nอนุศาสนาจารย์\nอนุศิษฏ์\nอนุสติ\nอนุสนธิ\nอนุสร\nอนุสรณ์\nอนุสัญญา\nอนุสัย\nอนุสาวรีย์\nอนุสาสนี\nอเนก\nอเนกคุณ\nอเนกรรถประโยค\nอเนจอนาถ\nอโนชา\nอโนดาต\nอบ\nอบเชย\nอบาย\nอปจายนธรรม\nอปจายนมัย\nอปมงคล\nอปยศ\nอประไมย\nอปรัณณชาติ\nอปรา\nอปราชัย\nอปราชิต\nอปริมาณ\nอปลักษณ์\nอปโลกน์\nอปวาท\nอเปหิ\nอพพะ\nอพยพ\nอภัพ\nอภัย\nอภิ\nอภิฆาต\nอภิชฌา\nอภิชน\nอภิชนาธิปไตย\nอภิชัย\nอภิชาต\nอภิชิต\nอภิญญา\nอภิญญาณ\nอภิธรรม\nอภิธาน\nอภิไธย\nอภินันท์\nอภินันทนาการ\nอภินัย\nอภินิหาร\nอภิเนษกรมณ์\nอภิบาล\nอภิปรัชญา\nอภิปราย\nอภิมหาอำนาจ\nอภิมานะ\nอภิมุข\nอภิรดี\nอภิรติ\nอภิรมย์\nอภิรักษ์\nอภิราม\nอภิรุต\nอภิรุม\nอภิรูป\nอภิลักขิต\nอภิลักขิตสมัย\nอภิเลปน์\nอภิวันท์\nอภิวาท\nอภิวาทน์\nอภิเษก\nอภิสมโพธิ\nอภิสมัย\nอภิสมาจาร\nอภิสัมโพธิ\nอภิสัมโพธิญาณ\nอภิสิต\nอภิสิทธิ์\nอภูตะ\nอม\nอมพะนำ\nอ้ม\nอมตธรรม\nอมตบท\nอมตะ\nอมนุษย์\nอมร\nอมรา\nอมราวดี\nอมรินทร์\nอมเรนทร์\nอมเรศ\nอมฤต\nอมัตร\nอมาตย์\nอมาวสี\nอมาวสุ\nอมาวาสี\nอมิตร\nอเมริกัน\nอย่า\nอยาก\nอย่าง\nอยุทธ์\nอยู่\nอร\nอรชร\nอรชุน\nอรดี\nอรติ\nอรทัย\nอรไท\nอรนุช\nอรพินท์\nอรพิม\nอรรค\nอรรฆ\nอรรฆย์\nอรรจน์\nอรรณพ\nอรรถ\nอรรถกถา\nอรรถกถาจารย์\nอรรถาธิบาย\nอรรธ\nอรสุม\nอรหะ\nอรหัง\nอรหัต\nอรหัตผล\nอรหัตมรรค\nอรหัน\nอรหันต์\nอรหันตฆาต\nอร่อย\nอรัญ\nอรัญญิก\nอรัญวาส\nอรัญวาสี\nอรัณย์\nอราดี\nอร่าม\nอริ\nอรินทร์\nอริน\nอริยกะ\nอริยทรัพย์\nอริยบุคคล\nอริยผล\nอริยมรรค\nอริยสัจ\nอริยะ\nอรุณ\nอรุโณทัย\nอรุ่ม\nอรูป\nอลงกต\nอลงกรณ์\nอลงการ\nอลวน\nอลเวง\nอลหม่าน\nอล่องฉ่อง\nอลักเอลื่อ\nอลังการ\nอลัชชี\nอล่างฉ่าง\nอลิงค์\nอลึงค์\nอลึ่งฉึ่ง\nอโลหะ\nอ้วก\nอวกาศ\nอวจร\nอวชัย\nอวชาต\nอวด\nอวตาร\nอวน\nอ้วน\nอวบ\nอวมงคล\nอวย\nอวยวะ\nอวรรค\nอวรุทธ์\nอวรุทธก\nอวล\nอวสาน\nอวหาร\nอวัยวะ\nอวัสดา\nอวาจี\nอวิจี\nอวิชชา\nอวิญญาณกทรัพย์\nอวิญญู\nอวิรุทธ์\nอวิโรธน์\nอวิโรธนะ\nอวิหิงสา\nอวีจิ\nอเวจี\nอโศก\nอสงไขย\nอสนี\nอัสนี\nอสนีบาต\nอสภะ\nอสมการ\nอสมมาตร\nอสรพิษ\nอสังหาริมทรัพย์\nอสังหาริมะ\nอสัญกรรม\nอสัญญี\nอสัญแดหวา\nอสัตถพฤกษ์\nอัสสัตถพฤกษ์\nอสัตย์\nอสัมภิน\nอสัมภินพงศ์\nอสัมภินวงศ์\nอสิ\nอสิธารา\nอสิต\nอสิเลสะ\nอสีตยานุพยัญชนะ\nอสีติ\nอสุ\nอสุจิ\nอสุนีบาต\nอสุภ\nอสุรกาย\nอสุรา\nอสุรี\nอสุเรศ\nอสูร\nอเสกขบุคคล\nอเสกขะ\nอเสขบุคคล\nอเสขะ\nอหังการ\nอหิ\nอหิงสา\nอหิวาต์\nอหิวาตกโรค\nอหึงสา\nอเหตุกทิฐิ\nอโหสิ\nออ\nอ้อ\nอ๋อ\nออก\nออกซิเจน\nออกซิเดชัน\nออกไซด์\nออกญา\nอ่อง\nอ๋อง\nอ้องแอ้ง\nออเซาะ\nออด\nอ๊อด\nอ๊อดแอ๊ด\nอ่อน\nอ้อน\nออนซ์\nออนซอน\nอ้อนแอ้น\nออฟฟิศ\nออม\nอ่อม\nอ้อม\nออมชอม\nออมซอม\nอ้อมแอ้ม\nอ่อย\nอ้อย\nอ๋อย\nอ้อยส้อย\nอ้อยอิ่ง\nออสเมียม\nอ้อแอ้\nอ๊ะ\nอะคร้าว\nอะเคื้อ\nอะแจ\nอะเซทิลีน\nอะดรีนาลิน\nอะดุง\nอะตอม\nอะมีบา\nอะเมริเซียม\nอะร้าอร่าม\nอะไร\nอะลุ่มอล่วย\nอะลุ้มอล่วย\nอะลูมิเนียม\nอะหม\nอะไหล่\nอัก\nอั้ก\nอั๊ก\nอักกะ\nอักโกธะ\nอักขรวิธี\nอักขรวิบัติ\nอักขรสมัย\nอักขระ\nอักขรานุกรม\nอักขะ\nอักโข\nอักโขภิณี\nอักโขเภณี\nอักษร\nอักษะ\nอักเษาหิณี\nอักเสบ\nอักอ่วน\nอัคคะ\nอัคคิ\nอัคคี\nอัคนิ\nอัคนี\nอัคร\nอัครชายา\nอัครมเหสี\nอัครราชทูต\nอัครสมณทูต\nอัง\nอังก์\nอังกนะ\nอังกฤษ\nอังกะลุง\nอังกา\nอังกาบ\nอังกุระ\nอังกุศ\nอังกูร\nอังคณะ\nอังคณา\nอังคาร\nอังคาส\nอังคีรส\nอังคุฐ\nอังคุตรนิกาย\nอังฆาต\nอังแพลม\nอั้งยี่\nอั้งโล่\nอังศุ\nอังศุก\nอังศุธร\nอังศุมาลี\nอังสกุฏ\nอังสตรอม\nอังสนา\nอังสภาระ\nอังสะ\nอังสา\nอัจกลับ\nอัจจิ\nอัจจิมา\nอัจจุตะ\nอัจฉรา\nอัจฉริยบุคคล\nอัจฉริยภาพ\nอัจฉริยลักษณ์\nอัจฉริยลักษณะ\nอัจฉริยะ\nอัจนา\nอัชฌัตติก\nอัชฌา\nอัชฌาจาร\nอัชฌาศัย\nอัชฌาสัย\nอัญเดียรถีย์\nอัญมณี\nอัญขยม\nอัญชนะ\nอัญชลี\nอัญชัน\nอัญชุลี\nอัญเชิญ\nอัญญะ\nอัญดิตถีย์\nอัญเดียรถีย์\nอัญประกาศ\nอัญรูป\nอัฏ\nอัฏฐบาน\nอัฏฐะ\nอัฏฐังคิกมรรค\nอัฏนา\nอัฐ\nอัฐฬส\nอัฐเคราะห์\nอัฐทิศ\nอัฐบริขาร\nอัฐบาน\nอัฐม\nอัฐมี\nอัฐศก\nอัฐิ\nอัฒจันทร์\nอัฒภาค\nอัฒมาส\nอัฒรัตติ\nอัณฑโกส\nอัณฑชะ\nอัณฑะ\nอัณณพ\nอัด\nอัดแจ\nอัต\nอัตชีวประวัติ\nอัตนัย\nอัตภาพ\nอัตวินิบาตกรรม\nอัตคัด\nอัตตโนบท\nอัตตา\nอัตตาธิปไตย\nอัตถ์\nอัตถะ\nอัตโนมัติ\nอัตรชะ\nอัตรา\nอัตลัด\nอัททา\nอัทธ์\nอัทธา\nอัทธาน\nอัทธายุ\nอัธยาตมวิทยา\nอัธยาย\nอัธยาศัย\nอัน\nอั้น\nอั๋น\nอันดร\nอันดับ\nอันตกะ\nอันตกาล\nอันตะ\nอันตคุณ\nอันตรภาค\nอันตรวาสก\nอันตรธาน\nอันตรา\nอันตราย\nอันตรายิกธรรม\nอันติกะ\nอันติมสัจ\nอันติมะ\nอันเต\nอันโต\nอันเตปุริก\nอันเตวาสิก\nอันแถ้ง\nอันโทล\nอันธการ\nอันธพาล\nอันธิกา\nอันเวส\nอับ\nอับปาง\nอัปปะ\nอัปเปหิ\nอัปภาคย์\nอัปมงคล\nอัปยศ\nอัประมาณ\nอัประไมย\nอัปราชัย\nอัปรีย์\nอัปลักษณ์\nอัปสร\nอัพพุท\nอัพโพหาริก\nอัพภันดร\nอัพภาน\nอัพภาส\nอัพภูตธรรม\nอัพยากฤต\nอัมพฤกษ์\nอัมพาต\nอัมพวัน\nอัมพวา\nอัมพร\nอัมพา\nอัมพิละ\nอัมพุ\nอัมพุช\nอัมพุชินี\nอัมพุท\nอัยกา\nอัยการ\nอัยกี\nอัยยะ\nอัยยิกา\nอัลกุรอาน\nอัลตราไวโอเลต\nอั่ว\nอัศจรรย์\nอัศเจรีย์\nอัศว\nอัศวเมธ\nอัศวยุช\nอัศวานึก\nอัศวิน\nอัศวินี\nอัษฎมงคล\nอัษฏมงคล\nอัษฎางคิกมรรค\nอัษฎายุธ\nอัษฎาวุธ\nอัสสะ\nอัสดร\nอัสกัณ\nอัสดง\nอัสดงคต\nอัสมิมานะ\nอัสสนี\nอัสสานึก\nอัสสาสะ\nอัสสุ\nอา\nอ่า\nอ้า\nอ๋า\nอากร\nอากังขา\nอากัป\nอาการ\nอากาศ\nอากูล\nอาเกียรณ์\nอาขยาต\nอาขยาน\nอาคเนย์\nอาคม\nอาครหายณี\nอาคันตุกะ\nอาคันตุกภัต\nอาคันตุกวัตร\nอาคาร\nอาฆาต\nอ่าง\nอ้าง\nอางขนาง\nอ้างว้าง\nอาจ\nอาจม\nอาจริยวัตร\nอาจริยวาท\nอาจาด\nอาจาร\nอาจารย์\nอาจารี\nอาจิณ\nอาเจียน\nอาชญา\nอาชวะ\nอาชา\nอาชาไนย\nอาชีพ\nอาชีวศึกษา\nอาชีวะ\nอาชีวก\nอาญา\nอาฏานา\nอาณัติ\nอาณา\nอาด\nอาดูร\nอาดุลย์\nอาดูลย์\nอาเด๊ะ\nอาตมภาพ\nอาตมัน\nอาตมา\nอาถรรพ์\nอาถรรพณ์\nอาทร\nอาทิ\nอาทิจจวาร\nอาทิตย์\nอาทิตยมณฑล\nอาทิตยวาร\nอาทีนพ\nอาทีนวะ\nอาทึก\nอาเทศ\nอาเทสนา\nอาธรรม\nอาธรรม์\nอาธาน\nอาธาร\nอาน\nอ่าน\nอานน\nอานนท์\nอานันท์\nอานันทนะ\nอานัม\nอานาปานะ\nอานาปานัสสติ\nอานิสงส์\nอานุภาพ\nอานุภาวะ\nอาบ\nอาบัติ\nอาบัน\nอาปณกะ\nอาปณะ\nอาปะ\nอาโป\nอาปานะ\nอาพัทธ์\nอาพันธ์\nอาพันธนะ\nอาพาธ\nอาเพศ\nอาภรณ์\nอาภัพ\nอาภัสระ\nอาภา\nอาภาส\nอามลกะ\nอามัย\nอามิษ\nอามิส\nอาย\nอ้าย\nอายตนะ\nอายตะ\nอายน\nอายัด\nอายัต\nอายัน\nอายาจนะ\nอายานะ\nอายุ\nอายุตกะ\nอายุธ\nอายุรกรรม\nอายุรแพทย์\nอายุรเวช\nอายุรเวท\nอายุศาสตร์\nอายุษ\nอาร์กอน\nอารดี\nอารติ\nอาร์ต\nอารทรา\nอาร์ม\nอารมณ์\nอารยชน\nอารยชาติ\nอารยธรรม\nอารยประเทศ\nอารยะ\nอารยัน\nอาระ\nอารักขา\nอารักษ์\nอารัญ\nอารัณย์\nอารัญญิก\nอารัณยกะ\nอารัติ\nอารัมภ์\nอารัมภกถา\nอารัมภบท\nอารัมภะ\nอาราธน์\nอาราธนา\nอาราม\nอารามิก\nอารี\nอารุม\nอาลปนะ\nอาละวาด\nอาลักษณ์\nอาลัย\nอาลัว\nอาลี\nอาโลก\nอาว\nอ่าว\nอ้าว\nอาวรณ์\nอาวัชนาการ\nอาวัล\nอาวาส\nอาวาสิก\nอาวาหมงคล\nอาวาหะ\nอาวุต\nอาวุธ\nอาวุโส\nอาเวค\nอาศรม\nอาศรมบท\nอาศเลษา\nอาศัย\nอาศิรพจน์\nอาศิรพาท\nอาศิรวาท\nอาศุ\nอาเศียรพจน์\nอาเศียรพาท\nอาเศียรวาท\nอาษาฒ\nอาสน\nอาสน์\nอาสนะ\nอาสนศาลา\nอาสัญ\nอาสัตย์\nอาสา\nอาสาฬห์\nอาสาฬหบูชา\nอาสาฬหะ\nอาสิญจ์\nอาสิน\nอาหม\nอาหรับ\nอาหาร\nอาฬหก\nอำ\nอ่ำ\nอ้ำ\nอำแดง\nอำนนต์\nอำนรรฆ\nอำนวย\nอำนาจ\nอำนาถ\nอำนิฐ\nอำนิษฐ์\nอำปลัง\nอำพน\nอำพล\nอำพะนำ\nอำพัน\nอำไพ\nอำเภอ\nอำมร\nอำมฤคโชค\nอำมฤต\nอำมหิต\nอำมาตย์\nอำมาตยาธิปไตย\nอำยวน\nอำรุง\nอำลา\nอำอวม\nอ้ำอึ้ง\nอิก\nอิง\nอิงค์\nอิงอร\nอิจฉา\nอิฉัน\nอิชยา\nอิฏฐารมณ์\nอิฐ\nอิฐผล\nอิด\nอิตถี\nอิตเทรียม\nอิตเทอร์เบียม\nอิติวุตตกะ\nอิทธิ\nอิน\nอินซูลิน\nอินเดีย\nอินเดียนแดง\nอินเดียม\nอินท์\nอินทขีล\nอินทนิล\nอินทผลัม\nอินทร์\nอินทรธนู\nอินทรวงศ์\nอินทรวิเชียร\nอินทรศักดิ์\nอินทราณี\nอินทราภิเษก\nอินทรายุธ\nอินทรี\nอินทรีย์\nอินทรียสังวร\nอินทีวร\nอินทุ\nอินฟราเรด\nอินัง\nอิ่ม\nอิมัลชัน\nอิริเดียม\nอิริยา\nอิริยาบถ\nอิรุพเพท\nอิเล็กตรอน\nอิเล็กทรอนิกส์\nอิเล็กโทน\nอิศร\nอิศวร\nอิษฏ์\nอิษฏี\nอิส\nอิสตรี\nอิสัตรี\nอิสรภาพ\nอิสระ\nอิสริยยศ\nอิสริยะ\nอิสริยาภรณ์\nอิสลาม\nอิสสา\nอิสิ\nอิสี\nอิหม่าม\nอิหลักอิเหลื่อ\nอี\nอี่\nอี้\nอี๊\nอี๋\nอี๋อ๋อ\nอีก\nอีก้อ\nอีก๋อย\nอีโก้ง\nอีจู้\nอี๊ด\nอีเต้อ\nอีโต้\nอีทุบ\nอีเทอร์\nอีนุงตุงนัง\nอีนูน\nอีโน\nอีแปะ\nอีโปง\nอีเพา\nอีมู\nอีรม\nอีลุ้ม\nอีลุ่ยฉุยแฉก\nอีเลิ้ง\nอีศ\nอีศวร\nอีส\nอีสาน\nอีสุกอีใส\nอีหรอบ\nอีหลักอีเหลื่อ\nอีหลี\nอีหลุกขลุกขลัก\nอีหลุกขลุกขลุ่ย\nอีเห็น\nอีเหน็บ\nอีเหนียว\nอีเหละเขละขละ\nอีเหละเขะขะ\nอีโหน่อีเหน่\nอีโหลกโขลกเขลก\nอีแอ่น\nอึ\nอึก\nอึ้ก\nอึ๊ก\nอึกทึก\nอึกอัก\nอึง\nอึ่ง\nอึ้ง\nอึด\nอึดตะปือ\nอึ้ดทึ่ด\nอึน\nอืด\nอื่น\nอื้น\nอือ\nอื้อ\nอื้อฮือ\nอุ\nอุก\nอุกกา\nอุกกาบาต\nอุกฤษฏ์\nอุกลาบาต\nอุค\nอุคระ\nอุคหนิมิต\nอุโฆษ\nอุ้ง\nอุจ\nอุจจาระ\nอุจฉุ\nอุจเฉท\nอุจเฉททิฐิ\nอุจาด\nอุชุ\nอุฏฐาการ\nอุณหภูมิ\nอุณหะ\nอุณหาหาร\nอุณหิส\nอุณา\nอุณาโลม\nอุด\nอุดเตา\nอุดม\nอุดมการณ์\nอุดมคติ\nอุดมศึกษา\nอุดร\nอุดหนุน\nอุตดม\nอุตตมะ\nอุตมภาพ\nอุตมางค์\nอุตดร\nอุตรกุรุทวีป\nอุตตรายัน\nอุตรนิกาย\nอุตรผลคุนี\nอุตตรผลคุนี\nอุตรภัทรบท\nอุตตรภัทรบท\nอุตตรภัททะ\nอุตราภิมุข\nอุตราวรรต\nอุตราวัฏ\nอุตราษาฒ\nอุตตราสาฬหะ\nอุตราสงค์\nอุตตานภาพ\nอุตพิด\nอุตรา\nอุตริ\nอุตริมนุสธรรม\nอุตลุด\nอุตส่าห์\nอุตสาหกรรม\nอุตสาหะ\nอุตุ\nอุตุนิยม\nอุตุนิยมวิทยา\nอุทก\nอุทกธาร\nอุทกธารา\nอุทกภัย\nอุทกวิทยา\nอุทกศาสตร์\nอุทธรณ์\nอุทธัจ\nอุทยาน\nอุทร\nอุทริยะ\nอุทลุม\nอุทัช\nอุทัย\nอุทาน\nอุทาร\nอุทาหรณ์\nอุทิศ\nอุทุมพร\nอุเทศ\nอุเทสิกเจดีย์\nอุธัจ\nอุ่น\nอุบ\nอุบล\nอุบะ\nอุบ๊ะ\nอุบัติ\nอุบาท\nอุบาทว์\nอุบาย\nอุบาสก\nอุบาสิกา\nอุเบกขา\nอุโบสถ\nอุปกรณ์\nอุปกรม\nอุปการ\nอุปการะ\nอุปการี\nอุปกิเลส\nอุปจาร\nอุปถัมภ์\nอุปถัมภก\nอุปทม\nอุปทูต\nอุปเทศ\nอุปเท่ห์\nอุปธิ\nอุปนัย\nอุปนิกขิต\nอุปนิษัท\nอุปนิสัย\nอุปบัติ\nอุปปาติกะ\nอุปพัทธ์\nอุปพันธ์\nอุปโภค\nอุปมา\nอุปมาน\nอุปไมย\nอุปยุวราช\nอุปรากร\nอุปราคา\nอุปราช\nอุปริ\nอุปริมปริยาย\nอุปโลกน์\nอุปเวท\nอุปสมบท\nอุปสมบัน\nอุปสัมบัน\nอุปสรรค\nอุปสัมปทา\nอุปฮาด\nอุปัชฌาย์\nอุปัชฌายวัตร\nอุปัชฌายะ\nอุปัฏฐาก\nอุปัฏฐานะ\nอุปัทวะ\nอุปัทวันตราย\nอุปาทาน\nอุปาหนา\nอุภัย\nอุ้ม\nอุมงค์\nอุโมงค์\nอุย\nอุ่ย\nอุ้ย\nอุ๊ย\nอุยยาน\nอุยยาม\nอุรณะ\nอุรพี\nอุระ\nอุรังอุตัง\nอุรัจฉัท\nอุรัจฉทะ\nอุรา\nอุรุ\nอุไร\nอุลกมณี\nอุลโลจ\nอุลามก\nอุลิด\nอุโลก\nอุแว้\nอุษณกร\nอุษณกาล\nอุษณรัศมี\nอุษณรุจี\nอุษณาการ\nอุษณีษ์\nอุษมะ\nอุษมัน\nอุษา\nอุษาโยค\nอุสภ\nอุสส่าห์\nอุสสาหะ\nอุสา\nอุสุ\nอุสุภ\nอุสุภราช\nอุสุม\nอุหรับ\nอุหลบ\nอุเหม่\nอุฬาร\nอู\nอู่\nอู้\nอูฐ\nอูด\nอูม\nอูย\nอูรุ\nอู๋อี๋\nเอ\nเอ้\nเอ๊\nเอก\nเอกเขนก\nเอกซเรย์\nเอกรรถประโยค\nเอกัคตา\nเอกังสพยากรณ์\nเอกังสวาที\nเอกา\nเอ้กา\nเอกาธิปไตย\nเอเคอร์\nเอง\nเอ็ง\nเอ๋ง\nเอ็ด\nเอ็ดตะโร\nเอดส์\nเอตทัคคะ\nเอ้เต\nเอทิล\nเอน\nเอ็น\nเอนไซม์\nเอ็นดู\nเอ็นอ่อน\nเอม\nเอ็มบริโอ\nเอย\nเอ่ย\nเอ๊ย\nเอ๋ย\nเอร็ดอร่อย\nเอราวัณ\nเอว\nเอ๊ว\nเอวัง\nเอฬกะ\nเอฬา\nเออ\nเอ่อ\nเออร์เบียม\nเอ้อระเหย\nเอ้อเร้อ\nเอ้อเฮอ\nเอ๊ะ\nเอะใจ\nเอะอะ\nเอะอะมะเทิ่ง\nเอา\nเอาทาร\nเอาทารย์\nเอารส\nเอาฬาร\nเอาะลาย\nเอิก\nเอิกเกริก\nเอิ้น\nเอิบ\nเอียง\nเอี้ยง\nเอียด\nเอี๊ยด\nเอียน\nเอี่ยน\nเอี่ยม\nเอี๊ยม\nเอี้ยมจุ๊น\nเอี้ยมเฟี้ยม\nเอี่ยว\nเอี้ยว\nเอื้อ\nเอื๊อก\nเอื้อง\nเอือด\nเอือน\nเอื้อน\nเอือม\nเอื้อม\nเอื่อย\nเอื้อย\nแอ\nแอ้\nแอ๋\nแอก\nแอกทิเนียม\nแอ่ง\nแอ้งแม้ง\nแอด\nแอ้ด\nแอ๊ด\nแอ่น\nแอนติเจน\nแอนติบอดี\nแอนติอิเล็กตรอน\nแอโนด\nแอบ\nแอม\nแอ้ม\nแอมแปร์\nแอมมิเตอร์\nแอมโมเนีย\nแอร่ม\nแอลกอฮอล์\nแอลฟา\nแอว\nแอ่ว\nแอ้วแซ่ว\nแอสทาทีน\nแอสไพริน\nแอสฟัลต์\nแอหนัง\nแออัด\nโอ\nโอ่\nโอ้\nโอ๋\nโอก\nโอ้ก\nโอ้กอ้าก\nโอ๊ก\nโอกาส\nโอฆชล\nโอฆสงสาร\nโอฆะ\nโอ่ง\nโองการ\nโองโขดง\nโอชะ\nโอชา\nโอโซน\nโอฐ\nโอด\nโอ๊ต\nโอตตัปปะ\nโอทนะ\nโอน\nโอบ\nโอปปาติกะ\nโอภา\nโอภาส\nโอม\nโอย\nโอ๊ย\nโอรส\nโอละพ่อ\nโอลิมปิก\nโอวาท\nโอษฐ์\nโอษฐชะ\nโอษฐภัย\nโอสถ\nโอห์ม\nโอหัง\nโอฬาร\nโอฬาริก\nโอฬารึก\nโอ้เอ้\nโอเอซิส\nโอ้โฮ\nไอ\nไอ้\nไอโซโทป\nไอน์สไตเนียม\nไอยรา\nไอยเรศ\nไอราพต\nไอราวัณ\nไอราวัต\nไอศกรีม\nไอศวรรย์\nไอศุริยสมบัติ\nไอศูรย์\nไอออน\nไอโอดีน\nฮกเกี้ยน\nฮด\nฮวงซุ้ย\nฮวน\nฮ้วนหมู\nฮวบ\nฮ่อ\nฮ้อ\nฮอกกี้\nฮอด\nฮ่อม\nฮ่อยจ๊อ\nฮอร์โมน\nฮอลแลนด์\nฮอลันดา\nฮะ\nฮะเบส\nฮะเรีย\nฮัก\nฮังเล\nฮัจญ์\nฮัจญะฮ์\nฮัจญี\nฮั่น\nฮั้ว\nฮา\nฮ้า\nฮ่างหลวง\nฮาจญ์\nฮาม\nฮาเร็ม\nฮาห์เนียม\nฮิจเราะห์\nฮินดู\nฮิปโปโปเตมัส\nฮิสทีเรีย\nฮีเลียม\nฮึ\nฮึก\nฮึด\nฮึดฮัด\nฮึ่ม\nฮึย\nฮึ่ย\nฮืดฮาด\nฮือ\nฮื่อ\nฮื้อ\nฮื้อฉี่\nฮุด\nฮุบ\nฮุยเลฮุย\nฮู้\nฮูก\nฮูม\nเฮ\nเฮฮา\nเฮกตาร์\nเฮกโตกรัม\nเฮกโตเมตร\nเฮกโตลิตร\nเฮง\nเฮ็ด\nเฮโมโกลบิน\nเฮย\nเฮ่ย\nเฮ้ย\nเฮโรอีน\nเฮลิคอปเตอร์\nเฮโล\nเฮละโล\nเฮ้ว\nเฮอ\nเฮ่อ\nเฮ้อ\nเฮอริเคน\nเฮิรตซ์\nเฮี้ยน\nเฮี้ยบ\nเฮี้ยว\nเฮือก\nเฮือน\nแฮ\nแฮ่\nแฮก\nแฮ่กึ๊น\nแฮนด์บอล\nแฮฟเนียม\nแฮม\nแฮะ\nโฮ\nโฮก\nโฮ่ง\nโฮ้ง\nโฮเต็ล\nโฮลเมียม\nโฮะ\nไฮ้\nไฮโกรมิเตอร์\nไฮดรา\nไฮโดร\nไฮโดรคาร์บอน\nไฮโดรเจน\nไฮโดรมิเตอร์\nไฮไฟ\nไฮโล\nไฮฮี\n"
+              .split(/[\r\n]+/)
+              .filter(function (w) {
+                return w.length > 1;
+              })
+      this.addWords(words, false)
+    }
+    if(finalize){
+      this.finalizeDict();
+    }
+  },
+
+  dictSeek: function (l, r, ch, strOffset, pos) {
+    var ans = null;
+    while (l <= r) {
+      var m = Math.floor((l + r) / 2),
+        dict_item = this.dict[m],
+        len = dict_item.length;
+      if (len <= strOffset) {
+        l = m + 1;
+      } else {
+        var ch_ = dict_item[strOffset];
+        if (ch_ < ch) {
+          l = m + 1;
+        } else if (ch_ > ch) {
+          r = m - 1;
+        } else {
+          ans = m;
+          if (pos == LEFT) {
+            r = m - 1;
+          } else {
+            l = m + 1;
+          }
+        }
+      }
+    }
+    return ans;
+  },
+
+  isFinal: function (acceptor) {
+    return this.dict[acceptor.l].length == acceptor.strOffset;
+  },
+
+  createAcceptor: function () {
+    return {
+      l: 0,
+      r: this.dict.length - 1,
+      strOffset: 0,
+      isFinal: false,
+      dict: this,
+      transit: function (ch) {
+        return this.dict.transit(this, ch);
+      },
+      isError: false,
+      tag: "DICT",
+      w: 1,
+      type: "DICT"
+    };
+  },
+
+  transit: function (acceptor, ch) {
+    var l = this.dictSeek(acceptor.l,
+      acceptor.r,
+      ch,
+      acceptor.strOffset,
+      LEFT);
+    if (l !== null) {
+      var r = this.dictSeek(l,
+        acceptor.r,
+        ch,
+        acceptor.strOffset,
+        RIGHT);
+      acceptor.l = l;
+      acceptor.r = r;
+      acceptor.strOffset++;
+      acceptor.isFinal = this.isFinal(acceptor);
+    } else {
+      acceptor.isError = true;
+    }
+    return acceptor;
+  },
+
+  sortuniq: function(a){
+    return a.sort().filter(function(item, pos, arr){
+      return !pos || item != arr[pos - 1];
+    })
+  },
+
+  flatten: function(a){
+    //[[1,2],[3]] -> [1,2,3]
+    return [].concat.apply([], a);
+  }
+};
+module.exports = WordcutDict;
+
+}).call(this,"/dist/tmp")
+},{"glob":16,"path":22}],3:[function(require,module,exports){
+var WordRule = {
+  createAcceptor: function(tag) {
+    if (tag["WORD_RULE"])
+      return null;
+
+    return {strOffset: 0,
+            isFinal: false,
+            transit: function(ch) {
+              var lch = ch.toLowerCase();
+              if (lch >= "a" && lch <= "z") {
+                this.isFinal = true;
+                this.strOffset++;
+              } else {
+                this.isError = true;
+              }
+              return this;
+            },
+            isError: false,
+            tag: "WORD_RULE",
+            type: "WORD_RULE",
+            w: 1};
+  }
+};
+
+var NumberRule = {
+  createAcceptor: function(tag) {
+    if (tag["NUMBER_RULE"])
+      return null;
+
+    return {strOffset: 0,
+            isFinal: false,
+            transit: function(ch) {
+              if (ch >= "0" && ch <= "9") {
+                this.isFinal = true;
+                this.strOffset++;
+              } else {
+                this.isError = true;
+              }
+              return this;
+            },
+            isError: false,
+            tag: "NUMBER_RULE",
+            type: "NUMBER_RULE",
+            w: 1};
+  }
+};
+
+var SpaceRule = {
+  tag: "SPACE_RULE",
+  createAcceptor: function(tag) {
+
+    if (tag["SPACE_RULE"])
+      return null;
+
+    return {strOffset: 0,
+            isFinal: false,
+            transit: function(ch) {
+              if (ch == " " || ch == "\t" || ch == "\r" || ch == "\n" ||
+                  ch == "\u00A0" || ch=="\u2003"//nbsp and emsp
+                 ) {
+                this.isFinal = true;
+                this.strOffset++;
+              } else {
+                this.isError = true;
+              }
+              return this;
+            },
+            isError: false,
+            tag: SpaceRule.tag,
+            w: 1,
+            type: "SPACE_RULE"};
+  }
+}
+
+var SingleSymbolRule = {
+  tag: "SINSYM",
+  createAcceptor: function(tag) {
+    return {strOffset: 0,
+            isFinal: false,
+            transit: function(ch) {
+              if (this.strOffset == 0 && ch.match(/^[\@\(\)\/\,\-\."`]$/)) {
+                this.isFinal = true;
+                this.strOffset++;
+              } else {
+                this.isError = true;
+              }
+              return this;
+            },
+            isError: false,
+            tag: "SINSYM",
+            w: 1,
+            type: "SINSYM"};
+  }
+}
+
+
+var LatinRules = [WordRule, SpaceRule, SingleSymbolRule, NumberRule];
+
+module.exports = LatinRules;
+
+},{}],4:[function(require,module,exports){
+var _ = require("underscore")
+  , WordcutCore = require("./wordcut_core");
+var PathInfoBuilder = {
+
+  /*
+    buildByPartAcceptors: function(path, acceptors, i) {
+    var 
+    var genInfos = partAcceptors.reduce(function(genInfos, acceptor) {
+      
+    }, []);
+    
+    return genInfos;
+  } 
+  */
+
+  buildByAcceptors: function(path, finalAcceptors, i) {
+    var self = this;
+    var infos = finalAcceptors.map(function(acceptor) {
+      var p = i - acceptor.strOffset + 1
+        , _info = path[p];            
+      
+      var info = {p: p, 
+                  mw: _info.mw + (acceptor.mw === undefined ? 0 : acceptor.mw),
+                  w: acceptor.w + _info.w,
+                  unk: (acceptor.unk ? acceptor.unk : 0) + _info.unk, 
+                  type: acceptor.type};
+
+      if (acceptor.type == "PART") {
+        for(var j = p + 1; j <= i; j++) {
+          path[j].merge = p;
+        }
+        info.merge = p;
+      }
+
+      return info;
+    });
+    return infos.filter(function(info) { return info; });
+  },
+  
+  fallback: function(path, leftBoundary, text, i) {
+    var _info = path[leftBoundary];
+    if (text[i].match(/[\u0E48-\u0E4E]/)) {
+      if (leftBoundary != 0) 
+        leftBoundary = path[leftBoundary].p;
+      return {p: leftBoundary,
+              mw: 0,
+              w: 1 + _info.w,
+              unk: 1 + _info.unk,
+              type: "UNK"};      
+/*    } else if(leftBoundary > 0 && path[leftBoundary].type !== "UNK") {
+      leftBoundary = path[leftBoundary].p;
+      return {p: leftBoundary,
+              w: 1 + _info.w,
+              unk: 1 + _info.unk,
+              type: "UNK"};            */
+    } else {      
+      return {p: leftBoundary,
+              mw: _info.mw,
+              w: 1 + _info.w,
+              unk: 1 + _info.unk,
+              type: "UNK"};
+    }
+  },
+  
+  build: function(path, finalAcceptors, i, leftBoundary, text) {
+    var basicPathInfos = this.buildByAcceptors(path, finalAcceptors, i);
+    if (basicPathInfos.length > 0) {
+      return basicPathInfos;
+    } else {
+      return [this.fallback(path, leftBoundary, text, i)];
+    }
+  }
+};
+
+module.exports = function() {
+  return _.clone(PathInfoBuilder);
+}
+
+},{"./wordcut_core":8,"underscore":25}],5:[function(require,module,exports){
+var _ = require("underscore");
+
+
+var PathSelector = {
+  selectPath: function(paths) {
+    var path = paths.reduce(function(selectedPath, path) {
+      if (selectedPath == null) {        
+        return path;
+      } else {
+        if (path.unk < selectedPath.unk) 
+          return path;        
+        if (path.unk == selectedPath.unk) {
+          if (path.mw < selectedPath.mw)
+            return path
+          if (path.mw == selectedPath.mw) {
+            if (path.w < selectedPath.w) 
+              return path;
+          }
+        }
+        return selectedPath;
+      }
+    }, null);
+    return path;
+  },
+  
+  createPath: function() {
+    return [{p:null, w:0, unk:0, type: "INIT", mw:0}];
+  }
+};
+
+module.exports = function() {
+  return _.clone(PathSelector);
+};
+
+},{"underscore":25}],6:[function(require,module,exports){
+function isMatch(pat, offset, ch) {
+  if (pat.length <= offset)
+    return false;
+  var _ch = pat[offset];
+  return _ch == ch ||
+         (_ch.match(/[กข]/) && ch.match(/[ก-ฮ]/)) ||
+         (_ch.match(/[มบ]/) && ch.match(/[ก-ฮ]/)) ||
+         (_ch.match(/\u0E49/) && ch.match(/[\u0E48-\u0E4B]/));
+}
+
+var Rule0 = {
+  pat: "เหก็ม",
+  createAcceptor: function(tag) {
+    return {strOffset: 0,
+            isFinal: false,
+            transit: function(ch) {
+              if (isMatch(Rule0.pat, this.strOffset,ch)) {                 
+                this.isFinal = (this.strOffset + 1 == Rule0.pat.length);                
+                this.strOffset++;
+              } else {              
+                this.isError = true;             
+              }
+              return this;
+            },
+            isError: false,
+            tag: "THAI_RULE",
+            type: "THAI_RULE", 
+            w: 1};                        
+  }
+};
+
+var PartRule = {
+  createAcceptor: function(tag) {
+    return {strOffset: 0,
+            patterns: [
+              "แก", "เก", "ก้", "กก์", "กา", "กี", "กิ", "กืก"  
+            ],
+            isFinal: false,
+            transit: function(ch) {
+              var offset = this.strOffset;
+              this.patterns = this.patterns.filter(function(pat) {
+                return isMatch(pat, offset, ch);
+              });
+              
+              if (this.patterns.length > 0) {
+                var len = 1 + offset;
+                this.isFinal = this.patterns.some(function(pat) {
+                  return pat.length == len; 
+                });
+                this.strOffset++;
+              } else {              
+                this.isError = true;             
+              }
+              return this;
+            },
+            isError: false,
+            tag: "PART",
+            type: "PART", 
+            unk: 1,
+            w: 1};                        
+  }
+};
+
+var ThaiRules = [Rule0, PartRule];
+
+module.exports = ThaiRules;
+
+},{}],7:[function(require,module,exports){
+var sys = require("sys")
+  , WordcutDict = require("./dict")
+  , WordcutCore = require("./wordcut_core")
+  , PathInfoBuilder = require("./path_info_builder")
+  , PathSelector = require("./path_selector")
+  , Acceptors = require("./acceptors")
+  , latinRules = require("./latin_rules")
+  , thaiRules = require("./thai_rules")
+  , _ = require("underscore");
+
+
+var Wordcut = Object.create(WordcutCore);
+Wordcut.defaultPathInfoBuilder = PathInfoBuilder;
+Wordcut.defaultPathSelector = PathSelector;
+Wordcut.defaultAcceptors = Acceptors;
+Wordcut.defaultLatinRules = latinRules;
+Wordcut.defaultThaiRules = thaiRules;
+Wordcut.defaultDict = WordcutDict;
+
+
+Wordcut.initNoDict = function(dict_path) {
+  var self = this;
+  self.pathInfoBuilder = new self.defaultPathInfoBuilder;
+  self.pathSelector = new self.defaultPathSelector;
+  self.acceptors = new self.defaultAcceptors;
+  self.defaultLatinRules.forEach(function(rule) {
+    self.acceptors.creators.push(rule);
+  });
+  self.defaultThaiRules.forEach(function(rule) {
+    self.acceptors.creators.push(rule);
+  });
+};
+
+Wordcut.init = function(dict_path, withDefault, additionalWords) {
+  withDefault = withDefault || false;
+  this.initNoDict();
+  var dict = _.clone(this.defaultDict);
+  dict.init(dict_path, withDefault, additionalWords);
+  this.acceptors.creators.push(dict);
+};
+
+module.exports = Wordcut;
+
+},{"./acceptors":1,"./dict":2,"./latin_rules":3,"./path_info_builder":4,"./path_selector":5,"./thai_rules":6,"./wordcut_core":8,"sys":28,"underscore":25}],8:[function(require,module,exports){
+var WordcutCore = {
+
+  buildPath: function(text) {
+    var self = this
+      , path = self.pathSelector.createPath()
+      , leftBoundary = 0;
+    self.acceptors.reset();
+    for (var i = 0; i < text.length; i++) {
+      var ch = text[i];
+      self.acceptors.transit(ch);
+
+      var possiblePathInfos = self
+        .pathInfoBuilder
+        .build(path,
+               self.acceptors.getFinalAcceptors(),
+               i,
+               leftBoundary,
+               text);
+      var selectedPath = self.pathSelector.selectPath(possiblePathInfos)
+
+      path.push(selectedPath);
+      if (selectedPath.type !== "UNK") {
+        leftBoundary = i;
+      }
+    }
+    return path;
+  },
+
+  pathToRanges: function(path) {
+    var e = path.length - 1
+     , ranges = [];
+
+    while (e > 0) {
+      var info = path[e]
+       , s = info.p;
+
+      if (info.merge !== undefined && ranges.length > 0) {
+        var r = ranges[ranges.length - 1];
+        r.s = info.merge;
+        s = r.s;
+      } else {
+        ranges.push({s:s, e:e});
+      }
+      e = s;
+    }
+    return ranges.reverse();
+  },
+
+  rangesToText: function(text, ranges, delimiter) {
+    return ranges.map(function(r) {
+      return text.substring(r.s, r.e);
+    }).join(delimiter);
+  },
+
+  cut: function(text, delimiter) {
+    var path = this.buildPath(text)
+      , ranges = this.pathToRanges(path);
+    return this
+      .rangesToText(text, ranges,
+                    (delimiter === undefined ? "|" : delimiter));
+  },
+
+  cutIntoRanges: function(text, noText) {
+    var path = this.buildPath(text)
+      , ranges = this.pathToRanges(path);
+
+    if (!noText) {
+      ranges.forEach(function(r) {
+        r.text = text.substring(r.s, r.e);
+      });
+    }
+    return ranges;
+  },
+
+  cutIntoArray: function(text) {
+    var path = this.buildPath(text)
+      , ranges = this.pathToRanges(path);
+    
+    return ranges.map(function(r) {
+      return text.substring(r.s, r.e)
+    });
+  }
+};
+
+module.exports = WordcutCore;
+
+},{}],9:[function(require,module,exports){
+// http://wiki.commonjs.org/wiki/Unit_Testing/1.0
+//
+// THIS IS NOT TESTED NOR LIKELY TO WORK OUTSIDE V8!
+//
+// Originally from narwhal.js (http://narwhaljs.org)
+// Copyright (c) 2009 Thomas Robinson <280north.com>
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the 'Software'), to
+// deal in the Software without restriction, including without limitation the
+// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+// sell copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+// when used in node, this will actually load the util module we depend on
+// versus loading the builtin util module as happens otherwise
+// this is a bug in node module loading as far as I am concerned
+var util = require('util/');
+
+var pSlice = Array.prototype.slice;
+var hasOwn = Object.prototype.hasOwnProperty;
+
+// 1. The assert module provides functions that throw
+// AssertionError's when particular conditions are not met. The
+// assert module must conform to the following interface.
+
+var assert = module.exports = ok;
+
+// 2. The AssertionError is defined in assert.
+// new assert.AssertionError({ message: message,
+//                             actual: actual,
+//                             expected: expected })
+
+assert.AssertionError = function AssertionError(options) {
+  this.name = 'AssertionError';
+  this.actual = options.actual;
+  this.expected = options.expected;
+  this.operator = options.operator;
+  if (options.message) {
+    this.message = options.message;
+    this.generatedMessage = false;
+  } else {
+    this.message = getMessage(this);
+    this.generatedMessage = true;
+  }
+  var stackStartFunction = options.stackStartFunction || fail;
+
+  if (Error.captureStackTrace) {
+    Error.captureStackTrace(this, stackStartFunction);
+  }
+  else {
+    // non v8 browsers so we can have a stacktrace
+    var err = new Error();
+    if (err.stack) {
+      var out = err.stack;
+
+      // try to strip useless frames
+      var fn_name = stackStartFunction.name;
+      var idx = out.indexOf('\n' + fn_name);
+      if (idx >= 0) {
+        // once we have located the function frame
+        // we need to strip out everything before it (and its line)
+        var next_line = out.indexOf('\n', idx + 1);
+        out = out.substring(next_line + 1);
+      }
+
+      this.stack = out;
+    }
+  }
+};
+
+// assert.AssertionError instanceof Error
+util.inherits(assert.AssertionError, Error);
+
+function replacer(key, value) {
+  if (util.isUndefined(value)) {
+    return '' + value;
+  }
+  if (util.isNumber(value) && !isFinite(value)) {
+    return value.toString();
+  }
+  if (util.isFunction(value) || util.isRegExp(value)) {
+    return value.toString();
+  }
+  return value;
+}
+
+function truncate(s, n) {
+  if (util.isString(s)) {
+    return s.length < n ? s : s.slice(0, n);
+  } else {
+    return s;
+  }
+}
+
+function getMessage(self) {
+  return truncate(JSON.stringify(self.actual, replacer), 128) + ' ' +
+         self.operator + ' ' +
+         truncate(JSON.stringify(self.expected, replacer), 128);
+}
+
+// At present only the three keys mentioned above are used and
+// understood by the spec. Implementations or sub modules can pass
+// other keys to the AssertionError's constructor - they will be
+// ignored.
+
+// 3. All of the following functions must throw an AssertionError
+// when a corresponding condition is not met, with a message that
+// may be undefined if not provided.  All assertion methods provide
+// both the actual and expected values to the assertion error for
+// display purposes.
+
+function fail(actual, expected, message, operator, stackStartFunction) {
+  throw new assert.AssertionError({
+    message: message,
+    actual: actual,
+    expected: expected,
+    operator: operator,
+    stackStartFunction: stackStartFunction
+  });
+}
+
+// EXTENSION! allows for well behaved errors defined elsewhere.
+assert.fail = fail;
+
+// 4. Pure assertion tests whether a value is truthy, as determined
+// by !!guard.
+// assert.ok(guard, message_opt);
+// This statement is equivalent to assert.equal(true, !!guard,
+// message_opt);. To test strictly for the value true, use
+// assert.strictEqual(true, guard, message_opt);.
+
+function ok(value, message) {
+  if (!value) fail(value, true, message, '==', assert.ok);
+}
+assert.ok = ok;
+
+// 5. The equality assertion tests shallow, coercive equality with
+// ==.
+// assert.equal(actual, expected, message_opt);
+
+assert.equal = function equal(actual, expected, message) {
+  if (actual != expected) fail(actual, expected, message, '==', assert.equal);
+};
+
+// 6. The non-equality assertion tests for whether two objects are not equal
+// with != assert.notEqual(actual, expected, message_opt);
+
+assert.notEqual = function notEqual(actual, expected, message) {
+  if (actual == expected) {
+    fail(actual, expected, message, '!=', assert.notEqual);
+  }
+};
+
+// 7. The equivalence assertion tests a deep equality relation.
+// assert.deepEqual(actual, expected, message_opt);
+
+assert.deepEqual = function deepEqual(actual, expected, message) {
+  if (!_deepEqual(actual, expected)) {
+    fail(actual, expected, message, 'deepEqual', assert.deepEqual);
+  }
+};
+
+function _deepEqual(actual, expected) {
+  // 7.1. All identical values are equivalent, as determined by ===.
+  if (actual === expected) {
+    return true;
+
+  } else if (util.isBuffer(actual) && util.isBuffer(expected)) {
+    if (actual.length != expected.length) return false;
+
+    for (var i = 0; i < actual.length; i++) {
+      if (actual[i] !== expected[i]) return false;
+    }
+
+    return true;
+
+  // 7.2. If the expected value is a Date object, the actual value is
+  // equivalent if it is also a Date object that refers to the same time.
+  } else if (util.isDate(actual) && util.isDate(expected)) {
+    return actual.getTime() === expected.getTime();
+
+  // 7.3 If the expected value is a RegExp object, the actual value is
+  // equivalent if it is also a RegExp object with the same source and
+  // properties (`global`, `multiline`, `lastIndex`, `ignoreCase`).
+  } else if (util.isRegExp(actual) && util.isRegExp(expected)) {
+    return actual.source === expected.source &&
+           actual.global === expected.global &&
+           actual.multiline === expected.multiline &&
+           actual.lastIndex === expected.lastIndex &&
+           actual.ignoreCase === expected.ignoreCase;
+
+  // 7.4. Other pairs that do not both pass typeof value == 'object',
+  // equivalence is determined by ==.
+  } else if (!util.isObject(actual) && !util.isObject(expected)) {
+    return actual == expected;
+
+  // 7.5 For all other Object pairs, including Array objects, equivalence is
+  // determined by having the same number of owned properties (as verified
+  // with Object.prototype.hasOwnProperty.call), the same set of keys
+  // (although not necessarily the same order), equivalent values for every
+  // corresponding key, and an identical 'prototype' property. Note: this
+  // accounts for both named and indexed properties on Arrays.
+  } else {
+    return objEquiv(actual, expected);
+  }
+}
+
+function isArguments(object) {
+  return Object.prototype.toString.call(object) == '[object Arguments]';
+}
+
+function objEquiv(a, b) {
+  if (util.isNullOrUndefined(a) || util.isNullOrUndefined(b))
+    return false;
+  // an identical 'prototype' property.
+  if (a.prototype !== b.prototype) return false;
+  // if one is a primitive, the other must be same
+  if (util.isPrimitive(a) || util.isPrimitive(b)) {
+    return a === b;
+  }
+  var aIsArgs = isArguments(a),
+      bIsArgs = isArguments(b);
+  if ((aIsArgs && !bIsArgs) || (!aIsArgs && bIsArgs))
+    return false;
+  if (aIsArgs) {
+    a = pSlice.call(a);
+    b = pSlice.call(b);
+    return _deepEqual(a, b);
+  }
+  var ka = objectKeys(a),
+      kb = objectKeys(b),
+      key, i;
+  // having the same number of owned properties (keys incorporates
+  // hasOwnProperty)
+  if (ka.length != kb.length)
+    return false;
+  //the same set of keys (although not necessarily the same order),
+  ka.sort();
+  kb.sort();
+  //~~~cheap key test
+  for (i = ka.length - 1; i >= 0; i--) {
+    if (ka[i] != kb[i])
+      return false;
+  }
+  //equivalent values for every corresponding key, and
+  //~~~possibly expensive deep test
+  for (i = ka.length - 1; i >= 0; i--) {
+    key = ka[i];
+    if (!_deepEqual(a[key], b[key])) return false;
+  }
+  return true;
+}
+
+// 8. The non-equivalence assertion tests for any deep inequality.
+// assert.notDeepEqual(actual, expected, message_opt);
+
+assert.notDeepEqual = function notDeepEqual(actual, expected, message) {
+  if (_deepEqual(actual, expected)) {
+    fail(actual, expected, message, 'notDeepEqual', assert.notDeepEqual);
+  }
+};
+
+// 9. The strict equality assertion tests strict equality, as determined by ===.
+// assert.strictEqual(actual, expected, message_opt);
+
+assert.strictEqual = function strictEqual(actual, expected, message) {
+  if (actual !== expected) {
+    fail(actual, expected, message, '===', assert.strictEqual);
+  }
+};
+
+// 10. The strict non-equality assertion tests for strict inequality, as
+// determined by !==.  assert.notStrictEqual(actual, expected, message_opt);
+
+assert.notStrictEqual = function notStrictEqual(actual, expected, message) {
+  if (actual === expected) {
+    fail(actual, expected, message, '!==', assert.notStrictEqual);
+  }
+};
+
+function expectedException(actual, expected) {
+  if (!actual || !expected) {
+    return false;
+  }
+
+  if (Object.prototype.toString.call(expected) == '[object RegExp]') {
+    return expected.test(actual);
+  } else if (actual instanceof expected) {
+    return true;
+  } else if (expected.call({}, actual) === true) {
+    return true;
+  }
+
+  return false;
+}
+
+function _throws(shouldThrow, block, expected, message) {
+  var actual;
+
+  if (util.isString(expected)) {
+    message = expected;
+    expected = null;
+  }
+
+  try {
+    block();
+  } catch (e) {
+    actual = e;
+  }
+
+  message = (expected && expected.name ? ' (' + expected.name + ').' : '.') +
+            (message ? ' ' + message : '.');
+
+  if (shouldThrow && !actual) {
+    fail(actual, expected, 'Missing expected exception' + message);
+  }
+
+  if (!shouldThrow && expectedException(actual, expected)) {
+    fail(actual, expected, 'Got unwanted exception' + message);
+  }
+
+  if ((shouldThrow && actual && expected &&
+      !expectedException(actual, expected)) || (!shouldThrow && actual)) {
+    throw actual;
+  }
+}
+
+// 11. Expected to throw an error:
+// assert.throws(block, Error_opt, message_opt);
+
+assert.throws = function(block, /*optional*/error, /*optional*/message) {
+  _throws.apply(this, [true].concat(pSlice.call(arguments)));
+};
+
+// EXTENSION! This is annoying to write outside this module.
+assert.doesNotThrow = function(block, /*optional*/message) {
+  _throws.apply(this, [false].concat(pSlice.call(arguments)));
+};
+
+assert.ifError = function(err) { if (err) {throw err;}};
+
+var objectKeys = Object.keys || function (obj) {
+  var keys = [];
+  for (var key in obj) {
+    if (hasOwn.call(obj, key)) keys.push(key);
+  }
+  return keys;
+};
+
+},{"util/":28}],10:[function(require,module,exports){
+'use strict';
+module.exports = balanced;
+function balanced(a, b, str) {
+  if (a instanceof RegExp) a = maybeMatch(a, str);
+  if (b instanceof RegExp) b = maybeMatch(b, str);
+
+  var r = range(a, b, str);
+
+  return r && {
+    start: r[0],
+    end: r[1],
+    pre: str.slice(0, r[0]),
+    body: str.slice(r[0] + a.length, r[1]),
+    post: str.slice(r[1] + b.length)
+  };
+}
+
+function maybeMatch(reg, str) {
+  var m = str.match(reg);
+  return m ? m[0] : null;
+}
+
+balanced.range = range;
+function range(a, b, str) {
+  var begs, beg, left, right, result;
+  var ai = str.indexOf(a);
+  var bi = str.indexOf(b, ai + 1);
+  var i = ai;
+
+  if (ai >= 0 && bi > 0) {
+    begs = [];
+    left = str.length;
+
+    while (i >= 0 && !result) {
+      if (i == ai) {
+        begs.push(i);
+        ai = str.indexOf(a, i + 1);
+      } else if (begs.length == 1) {
+        result = [ begs.pop(), bi ];
+      } else {
+        beg = begs.pop();
+        if (beg < left) {
+          left = beg;
+          right = bi;
+        }
+
+        bi = str.indexOf(b, i + 1);
+      }
+
+      i = ai < bi && ai >= 0 ? ai : bi;
+    }
+
+    if (begs.length) {
+      result = [ left, right ];
+    }
+  }
+
+  return result;
+}
+
+},{}],11:[function(require,module,exports){
+var concatMap = require('concat-map');
+var balanced = require('balanced-match');
+
+module.exports = expandTop;
+
+var escSlash = '\0SLASH'+Math.random()+'\0';
+var escOpen = '\0OPEN'+Math.random()+'\0';
+var escClose = '\0CLOSE'+Math.random()+'\0';
+var escComma = '\0COMMA'+Math.random()+'\0';
+var escPeriod = '\0PERIOD'+Math.random()+'\0';
+
+function numeric(str) {
+  return parseInt(str, 10) == str
+    ? parseInt(str, 10)
+    : str.charCodeAt(0);
+}
+
+function escapeBraces(str) {
+  return str.split('\\\\').join(escSlash)
+            .split('\\{').join(escOpen)
+            .split('\\}').join(escClose)
+            .split('\\,').join(escComma)
+            .split('\\.').join(escPeriod);
+}
+
+function unescapeBraces(str) {
+  return str.split(escSlash).join('\\')
+            .split(escOpen).join('{')
+            .split(escClose).join('}')
+            .split(escComma).join(',')
+            .split(escPeriod).join('.');
+}
+
+
+// Basically just str.split(","), but handling cases
+// where we have nested braced sections, which should be
+// treated as individual members, like {a,{b,c},d}
+function parseCommaParts(str) {
+  if (!str)
+    return [''];
+
+  var parts = [];
+  var m = balanced('{', '}', str);
+
+  if (!m)
+    return str.split(',');
+
+  var pre = m.pre;
+  var body = m.body;
+  var post = m.post;
+  var p = pre.split(',');
+
+  p[p.length-1] += '{' + body + '}';
+  var postParts = parseCommaParts(post);
+  if (post.length) {
+    p[p.length-1] += postParts.shift();
+    p.push.apply(p, postParts);
+  }
+
+  parts.push.apply(parts, p);
+
+  return parts;
+}
+
+function expandTop(str) {
+  if (!str)
+    return [];
+
+  // I don't know why Bash 4.3 does this, but it does.
+  // Anything starting with {} will have the first two bytes preserved
+  // but *only* at the top level, so {},a}b will not expand to anything,
+  // but a{},b}c will be expanded to [a}c,abc].
+  // One could argue that this is a bug in Bash, but since the goal of
+  // this module is to match Bash's rules, we escape a leading {}
+  if (str.substr(0, 2) === '{}') {
+    str = '\\{\\}' + str.substr(2);
+  }
+
+  return expand(escapeBraces(str), true).map(unescapeBraces);
+}
+
+function identity(e) {
+  return e;
+}
+
+function embrace(str) {
+  return '{' + str + '}';
+}
+function isPadded(el) {
+  return /^-?0\d/.test(el);
+}
+
+function lte(i, y) {
+  return i <= y;
+}
+function gte(i, y) {
+  return i >= y;
+}
+
+function expand(str, isTop) {
+  var expansions = [];
+
+  var m = balanced('{', '}', str);
+  if (!m || /\$$/.test(m.pre)) return [str];
+
+  var isNumericSequence = /^-?\d+\.\.-?\d+(?:\.\.-?\d+)?$/.test(m.body);
+  var isAlphaSequence = /^[a-zA-Z]\.\.[a-zA-Z](?:\.\.-?\d+)?$/.test(m.body);
+  var isSequence = isNumericSequence || isAlphaSequence;
+  var isOptions = m.body.indexOf(',') >= 0;
+  if (!isSequence && !isOptions) {
+    // {a},b}
+    if (m.post.match(/,.*\}/)) {
+      str = m.pre + '{' + m.body + escClose + m.post;
+      return expand(str);
+    }
+    return [str];
+  }
+
+  var n;
+  if (isSequence) {
+    n = m.body.split(/\.\./);
+  } else {
+    n = parseCommaParts(m.body);
+    if (n.length === 1) {
+      // x{{a,b}}y ==> x{a}y x{b}y
+      n = expand(n[0], false).map(embrace);
+      if (n.length === 1) {
+        var post = m.post.length
+          ? expand(m.post, false)
+          : [''];
+        return post.map(function(p) {
+          return m.pre + n[0] + p;
+        });
+      }
+    }
+  }
+
+  // at this point, n is the parts, and we know it's not a comma set
+  // with a single entry.
+
+  // no need to expand pre, since it is guaranteed to be free of brace-sets
+  var pre = m.pre;
+  var post = m.post.length
+    ? expand(m.post, false)
+    : [''];
+
+  var N;
+
+  if (isSequence) {
+    var x = numeric(n[0]);
+    var y = numeric(n[1]);
+    var width = Math.max(n[0].length, n[1].length)
+    var incr = n.length == 3
+      ? Math.abs(numeric(n[2]))
+      : 1;
+    var test = lte;
+    var reverse = y < x;
+    if (reverse) {
+      incr *= -1;
+      test = gte;
+    }
+    var pad = n.some(isPadded);
+
+    N = [];
+
+    for (var i = x; test(i, y); i += incr) {
+      var c;
+      if (isAlphaSequence) {
+        c = String.fromCharCode(i);
+        if (c === '\\')
+          c = '';
+      } else {
+        c = String(i);
+        if (pad) {
+          var need = width - c.length;
+          if (need > 0) {
+            var z = new Array(need + 1).join('0');
+            if (i < 0)
+              c = '-' + z + c.slice(1);
+            else
+              c = z + c;
+          }
+        }
+      }
+      N.push(c);
+    }
+  } else {
+    N = concatMap(n, function(el) { return expand(el, false) });
+  }
+
+  for (var j = 0; j < N.length; j++) {
+    for (var k = 0; k < post.length; k++) {
+      var expansion = pre + N[j] + post[k];
+      if (!isTop || isSequence || expansion)
+        expansions.push(expansion);
+    }
+  }
+
+  return expansions;
+}
+
+
+},{"balanced-match":10,"concat-map":13}],12:[function(require,module,exports){
+
+},{}],13:[function(require,module,exports){
+module.exports = function (xs, fn) {
+    var res = [];
+    for (var i = 0; i < xs.length; i++) {
+        var x = fn(xs[i], i);
+        if (isArray(x)) res.push.apply(res, x);
+        else res.push(x);
+    }
+    return res;
+};
+
+var isArray = Array.isArray || function (xs) {
+    return Object.prototype.toString.call(xs) === '[object Array]';
+};
+
+},{}],14:[function(require,module,exports){
+// Copyright Joyent, Inc. and other Node contributors.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a
+// copy of this software and associated documentation files (the
+// "Software"), to deal in the Software without restriction, including
+// without limitation the rights to use, copy, modify, merge, publish,
+// distribute, sublicense, and/or sell copies of the Software, and to permit
+// persons to whom the Software is furnished to do so, subject to the
+// following conditions:
+//
+// The above copyright notice and this permission notice shall be included
+// in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+// USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+function EventEmitter() {
+  this._events = this._events || {};
+  this._maxListeners = this._maxListeners || undefined;
+}
+module.exports = EventEmitter;
+
+// Backwards-compat with node 0.10.x
+EventEmitter.EventEmitter = EventEmitter;
+
+EventEmitter.prototype._events = undefined;
+EventEmitter.prototype._maxListeners = undefined;
+
+// By default EventEmitters will print a warning if more than 10 listeners are
+// added to it. This is a useful default which helps finding memory leaks.
+EventEmitter.defaultMaxListeners = 10;
+
+// Obviously not all Emitters should be limited to 10. This function allows
+// that to be increased. Set to zero for unlimited.
+EventEmitter.prototype.setMaxListeners = function(n) {
+  if (!isNumber(n) || n < 0 || isNaN(n))
+    throw TypeError('n must be a positive number');
+  this._maxListeners = n;
+  return this;
+};
+
+EventEmitter.prototype.emit = function(type) {
+  var er, handler, len, args, i, listeners;
+
+  if (!this._events)
+    this._events = {};
+
+  // If there is no 'error' event listener then throw.
+  if (type === 'error') {
+    if (!this._events.error ||
+        (isObject(this._events.error) && !this._events.error.length)) {
+      er = arguments[1];
+      if (er instanceof Error) {
+        throw er; // Unhandled 'error' event
+      }
+      throw TypeError('Uncaught, unspecified "error" event.');
+    }
+  }
+
+  handler = this._events[type];
+
+  if (isUndefined(handler))
+    return false;
+
+  if (isFunction(handler)) {
+    switch (arguments.length) {
+      // fast cases
+      case 1:
+        handler.call(this);
+        break;
+      case 2:
+        handler.call(this, arguments[1]);
+        break;
+      case 3:
+        handler.call(this, arguments[1], arguments[2]);
+        break;
+      // slower
+      default:
+        len = arguments.length;
+        args = new Array(len - 1);
+        for (i = 1; i < len; i++)
+          args[i - 1] = arguments[i];
+        handler.apply(this, args);
+    }
+  } else if (isObject(handler)) {
+    len = arguments.length;
+    args = new Array(len - 1);
+    for (i = 1; i < len; i++)
+      args[i - 1] = arguments[i];
+
+    listeners = handler.slice();
+    len = listeners.length;
+    for (i = 0; i < len; i++)
+      listeners[i].apply(this, args);
+  }
+
+  return true;
+};
+
+EventEmitter.prototype.addListener = function(type, listener) {
+  var m;
+
+  if (!isFunction(listener))
+    throw TypeError('listener must be a function');
+
+  if (!this._events)
+    this._events = {};
+
+  // To avoid recursion in the case that type === "newListener"! Before
+  // adding it to the listeners, first emit "newListener".
+  if (this._events.newListener)
+    this.emit('newListener', type,
+              isFunction(listener.listener) ?
+              listener.listener : listener);
+
+  if (!this._events[type])
+    // Optimize the case of one listener. Don't need the extra array object.
+    this._events[type] = listener;
+  else if (isObject(this._events[type]))
+    // If we've already got an array, just append.
+    this._events[type].push(listener);
+  else
+    // Adding the second element, need to change to array.
+    this._events[type] = [this._events[type], listener];
+
+  // Check for listener leak
+  if (isObject(this._events[type]) && !this._events[type].warned) {
+    var m;
+    if (!isUndefined(this._maxListeners)) {
+      m = this._maxListeners;
+    } else {
+      m = EventEmitter.defaultMaxListeners;
+    }
+
+    if (m && m > 0 && this._events[type].length > m) {
+      this._events[type].warned = true;
+      console.error('(node) warning: possible EventEmitter memory ' +
+                    'leak detected. %d listeners added. ' +
+                    'Use emitter.setMaxListeners() to increase limit.',
+                    this._events[type].length);
+      if (typeof console.trace === 'function') {
+        // not supported in IE 10
+        console.trace();
+      }
+    }
+  }
+
+  return this;
+};
+
+EventEmitter.prototype.on = EventEmitter.prototype.addListener;
+
+EventEmitter.prototype.once = function(type, listener) {
+  if (!isFunction(listener))
+    throw TypeError('listener must be a function');
+
+  var fired = false;
+
+  function g() {
+    this.removeListener(type, g);
+
+    if (!fired) {
+      fired = true;
+      listener.apply(this, arguments);
+    }
+  }
+
+  g.listener = listener;
+  this.on(type, g);
+
+  return this;
+};
+
+// emits a 'removeListener' event iff the listener was removed
+EventEmitter.prototype.removeListener = function(type, listener) {
+  var list, position, length, i;
+
+  if (!isFunction(listener))
+    throw TypeError('listener must be a function');
+
+  if (!this._events || !this._events[type])
+    return this;
+
+  list = this._events[type];
+  length = list.length;
+  position = -1;
+
+  if (list === listener ||
+      (isFunction(list.listener) && list.listener === listener)) {
+    delete this._events[type];
+    if (this._events.removeListener)
+      this.emit('removeListener', type, listener);
+
+  } else if (isObject(list)) {
+    for (i = length; i-- > 0;) {
+      if (list[i] === listener ||
+          (list[i].listener && list[i].listener === listener)) {
+        position = i;
+        break;
+      }
+    }
+
+    if (position < 0)
+      return this;
+
+    if (list.length === 1) {
+      list.length = 0;
+      delete this._events[type];
+    } else {
+      list.splice(position, 1);
+    }
+
+    if (this._events.removeListener)
+      this.emit('removeListener', type, listener);
+  }
+
+  return this;
+};
+
+EventEmitter.prototype.removeAllListeners = function(type) {
+  var key, listeners;
+
+  if (!this._events)
+    return this;
+
+  // not listening for removeListener, no need to emit
+  if (!this._events.removeListener) {
+    if (arguments.length === 0)
+      this._events = {};
+    else if (this._events[type])
+      delete this._events[type];
+    return this;
+  }
+
+  // emit removeListener for all listeners on all events
+  if (arguments.length === 0) {
+    for (key in this._events) {
+      if (key === 'removeListener') continue;
+      this.removeAllListeners(key);
+    }
+    this.removeAllListeners('removeListener');
+    this._events = {};
+    return this;
+  }
+
+  listeners = this._events[type];
+
+  if (isFunction(listeners)) {
+    this.removeListener(type, listeners);
+  } else {
+    // LIFO order
+    while (listeners.length)
+      this.removeListener(type, listeners[listeners.length - 1]);
+  }
+  delete this._events[type];
+
+  return this;
+};
+
+EventEmitter.prototype.listeners = function(type) {
+  var ret;
+  if (!this._events || !this._events[type])
+    ret = [];
+  else if (isFunction(this._events[type]))
+    ret = [this._events[type]];
+  else
+    ret = this._events[type].slice();
+  return ret;
+};
+
+EventEmitter.listenerCount = function(emitter, type) {
+  var ret;
+  if (!emitter._events || !emitter._events[type])
+    ret = 0;
+  else if (isFunction(emitter._events[type]))
+    ret = 1;
+  else
+    ret = emitter._events[type].length;
+  return ret;
+};
+
+function isFunction(arg) {
+  return typeof arg === 'function';
+}
+
+function isNumber(arg) {
+  return typeof arg === 'number';
+}
+
+function isObject(arg) {
+  return typeof arg === 'object' && arg !== null;
+}
+
+function isUndefined(arg) {
+  return arg === void 0;
+}
+
+},{}],15:[function(require,module,exports){
+(function (process){
+exports.alphasort = alphasort
+exports.alphasorti = alphasorti
+exports.setopts = setopts
+exports.ownProp = ownProp
+exports.makeAbs = makeAbs
+exports.finish = finish
+exports.mark = mark
+exports.isIgnored = isIgnored
+exports.childrenIgnored = childrenIgnored
+
+function ownProp (obj, field) {
+  return Object.prototype.hasOwnProperty.call(obj, field)
+}
+
+var path = require("path")
+var minimatch = require("minimatch")
+var isAbsolute = require("path-is-absolute")
+var Minimatch = minimatch.Minimatch
+
+function alphasorti (a, b) {
+  return a.toLowerCase().localeCompare(b.toLowerCase())
+}
+
+function alphasort (a, b) {
+  return a.localeCompare(b)
+}
+
+function setupIgnores (self, options) {
+  self.ignore = options.ignore || []
+
+  if (!Array.isArray(self.ignore))
+    self.ignore = [self.ignore]
+
+  if (self.ignore.length) {
+    self.ignore = self.ignore.map(ignoreMap)
+  }
+}
+
+function ignoreMap (pattern) {
+  var gmatcher = null
+  if (pattern.slice(-3) === '/**') {
+    var gpattern = pattern.replace(/(\/\*\*)+$/, '')
+    gmatcher = new Minimatch(gpattern)
+  }
+
+  return {
+    matcher: new Minimatch(pattern),
+    gmatcher: gmatcher
+  }
+}
+
+function setopts (self, pattern, options) {
+  if (!options)
+    options = {}
+
+  // base-matching: just use globstar for that.
+  if (options.matchBase && -1 === pattern.indexOf("/")) {
+    if (options.noglobstar) {
+      throw new Error("base matching requires globstar")
+    }
+    pattern = "**/" + pattern
+  }
+
+  self.silent = !!options.silent
+  self.pattern = pattern
+  self.strict = options.strict !== false
+  self.realpath = !!options.realpath
+  self.realpathCache = options.realpathCache || Object.create(null)
+  self.follow = !!options.follow
+  self.dot = !!options.dot
+  self.mark = !!options.mark
+  self.nodir = !!options.nodir
+  if (self.nodir)
+    self.mark = true
+  self.sync = !!options.sync
+  self.nounique = !!options.nounique
+  self.nonull = !!options.nonull
+  self.nosort = !!options.nosort
+  self.nocase = !!options.nocase
+  self.stat = !!options.stat
+  self.noprocess = !!options.noprocess
+
+  self.maxLength = options.maxLength || Infinity
+  self.cache = options.cache || Object.create(null)
+  self.statCache = options.statCache || Object.create(null)
+  self.symlinks = options.symlinks || Object.create(null)
+
+  setupIgnores(self, options)
+
+  self.changedCwd = false
+  var cwd = process.cwd()
+  if (!ownProp(options, "cwd"))
+    self.cwd = cwd
+  else {
+    self.cwd = options.cwd
+    self.changedCwd = path.resolve(options.cwd) !== cwd
+  }
+
+  self.root = options.root || path.resolve(self.cwd, "/")
+  self.root = path.resolve(self.root)
+  if (process.platform === "win32")
+    self.root = self.root.replace(/\\/g, "/")
+
+  self.nomount = !!options.nomount
+
+  // disable comments and negation unless the user explicitly
+  // passes in false as the option.
+  options.nonegate = options.nonegate === false ? false : true
+  options.nocomment = options.nocomment === false ? false : true
+  deprecationWarning(options)
+
+  self.minimatch = new Minimatch(pattern, options)
+  self.options = self.minimatch.options
+}
+
+// TODO(isaacs): remove entirely in v6
+// exported to reset in tests
+exports.deprecationWarned
+function deprecationWarning(options) {
+  if (!options.nonegate || !options.nocomment) {
+    if (process.noDeprecation !== true && !exports.deprecationWarned) {
+      var msg = 'glob WARNING: comments and negation will be disabled in v6'
+      if (process.throwDeprecation)
+        throw new Error(msg)
+      else if (process.traceDeprecation)
+        console.trace(msg)
+      else
+        console.error(msg)
+
+      exports.deprecationWarned = true
+    }
+  }
+}
+
+function finish (self) {
+  var nou = self.nounique
+  var all = nou ? [] : Object.create(null)
+
+  for (var i = 0, l = self.matches.length; i < l; i ++) {
+    var matches = self.matches[i]
+    if (!matches || Object.keys(matches).length === 0) {
+      if (self.nonull) {
+        // do like the shell, and spit out the literal glob
+        var literal = self.minimatch.globSet[i]
+        if (nou)
+          all.push(literal)
+        else
+          all[literal] = true
+      }
+    } else {
+      // had matches
+      var m = Object.keys(matches)
+      if (nou)
+        all.push.apply(all, m)
+      else
+        m.forEach(function (m) {
+          all[m] = true
+        })
+    }
+  }
+
+  if (!nou)
+    all = Object.keys(all)
+
+  if (!self.nosort)
+    all = all.sort(self.nocase ? alphasorti : alphasort)
+
+  // at *some* point we statted all of these
+  if (self.mark) {
+    for (var i = 0; i < all.length; i++) {
+      all[i] = self._mark(all[i])
+    }
+    if (self.nodir) {
+      all = all.filter(function (e) {
+        return !(/\/$/.test(e))
+      })
+    }
+  }
+
+  if (self.ignore.length)
+    all = all.filter(function(m) {
+      return !isIgnored(self, m)
+    })
+
+  self.found = all
+}
+
+function mark (self, p) {
+  var abs = makeAbs(self, p)
+  var c = self.cache[abs]
+  var m = p
+  if (c) {
+    var isDir = c === 'DIR' || Array.isArray(c)
+    var slash = p.slice(-1) === '/'
+
+    if (isDir && !slash)
+      m += '/'
+    else if (!isDir && slash)
+      m = m.slice(0, -1)
+
+    if (m !== p) {
+      var mabs = makeAbs(self, m)
+      self.statCache[mabs] = self.statCache[abs]
+      self.cache[mabs] = self.cache[abs]
+    }
+  }
+
+  return m
+}
+
+// lotta situps...
+function makeAbs (self, f) {
+  var abs = f
+  if (f.charAt(0) === '/') {
+    abs = path.join(self.root, f)
+  } else if (isAbsolute(f) || f === '') {
+    abs = f
+  } else if (self.changedCwd) {
+    abs = path.resolve(self.cwd, f)
+  } else {
+    abs = path.resolve(f)
+  }
+  return abs
+}
+
+
+// Return true, if pattern ends with globstar '**', for the accompanying parent directory.
+// Ex:- If node_modules/** is the pattern, add 'node_modules' to ignore list along with it's contents
+function isIgnored (self, path) {
+  if (!self.ignore.length)
+    return false
+
+  return self.ignore.some(function(item) {
+    return item.matcher.match(path) || !!(item.gmatcher && item.gmatcher.match(path))
+  })
+}
+
+function childrenIgnored (self, path) {
+  if (!self.ignore.length)
+    return false
+
+  return self.ignore.some(function(item) {
+    return !!(item.gmatcher && item.gmatcher.match(path))
+  })
+}
+
+}).call(this,require('_process'))
+},{"_process":24,"minimatch":20,"path":22,"path-is-absolute":23}],16:[function(require,module,exports){
+(function (process){
+// Approach:
+//
+// 1. Get the minimatch set
+// 2. For each pattern in the set, PROCESS(pattern, false)
+// 3. Store matches per-set, then uniq them
+//
+// PROCESS(pattern, inGlobStar)
+// Get the first [n] items from pattern that are all strings
+// Join these together.  This is PREFIX.
+//   If there is no more remaining, then stat(PREFIX) and
+//   add to matches if it succeeds.  END.
+//
+// If inGlobStar and PREFIX is symlink and points to dir
+//   set ENTRIES = []
+// else readdir(PREFIX) as ENTRIES
+//   If fail, END
+//
+// with ENTRIES
+//   If pattern[n] is GLOBSTAR
+//     // handle the case where the globstar match is empty
+//     // by pruning it out, and testing the resulting pattern
+//     PROCESS(pattern[0..n] + pattern[n+1 .. $], false)
+//     // handle other cases.
+//     for ENTRY in ENTRIES (not dotfiles)
+//       // attach globstar + tail onto the entry
+//       // Mark that this entry is a globstar match
+//       PROCESS(pattern[0..n] + ENTRY + pattern[n .. $], true)
+//
+//   else // not globstar
+//     for ENTRY in ENTRIES (not dotfiles, unless pattern[n] is dot)
+//       Test ENTRY against pattern[n]
+//       If fails, continue
+//       If passes, PROCESS(pattern[0..n] + item + pattern[n+1 .. $])
+//
+// Caveat:
+//   Cache all stats and readdirs results to minimize syscall.  Since all
+//   we ever care about is existence and directory-ness, we can just keep
+//   `true` for files, and [children,...] for directories, or `false` for
+//   things that don't exist.
+
+module.exports = glob
+
+var fs = require('fs')
+var minimatch = require('minimatch')
+var Minimatch = minimatch.Minimatch
+var inherits = require('inherits')
+var EE = require('events').EventEmitter
+var path = require('path')
+var assert = require('assert')
+var isAbsolute = require('path-is-absolute')
+var globSync = require('./sync.js')
+var common = require('./common.js')
+var alphasort = common.alphasort
+var alphasorti = common.alphasorti
+var setopts = common.setopts
+var ownProp = common.ownProp
+var inflight = require('inflight')
+var util = require('util')
+var childrenIgnored = common.childrenIgnored
+var isIgnored = common.isIgnored
+
+var once = require('once')
+
+function glob (pattern, options, cb) {
+  if (typeof options === 'function') cb = options, options = {}
+  if (!options) options = {}
+
+  if (options.sync) {
+    if (cb)
+      throw new TypeError('callback provided to sync glob')
+    return globSync(pattern, options)
+  }
+
+  return new Glob(pattern, options, cb)
+}
+
+glob.sync = globSync
+var GlobSync = glob.GlobSync = globSync.GlobSync
+
+// old api surface
+glob.glob = glob
+
+glob.hasMagic = function (pattern, options_) {
+  var options = util._extend({}, options_)
+  options.noprocess = true
+
+  var g = new Glob(pattern, options)
+  var set = g.minimatch.set
+  if (set.length > 1)
+    return true
+
+  for (var j = 0; j < set[0].length; j++) {
+    if (typeof set[0][j] !== 'string')
+      return true
+  }
+
+  return false
+}
+
+glob.Glob = Glob
+inherits(Glob, EE)
+function Glob (pattern, options, cb) {
+  if (typeof options === 'function') {
+    cb = options
+    options = null
+  }
+
+  if (options && options.sync) {
+    if (cb)
+      throw new TypeError('callback provided to sync glob')
+    return new GlobSync(pattern, options)
+  }
+
+  if (!(this instanceof Glob))
+    return new Glob(pattern, options, cb)
+
+  setopts(this, pattern, options)
+  this._didRealPath = false
+
+  // process each pattern in the minimatch set
+  var n = this.minimatch.set.length
+
+  // The matches are stored as {<filename>: true,...} so that
+  // duplicates are automagically pruned.
+  // Later, we do an Object.keys() on these.
+  // Keep them as a list so we can fill in when nonull is set.
+  this.matches = new Array(n)
+
+  if (typeof cb === 'function') {
+    cb = once(cb)
+    this.on('error', cb)
+    this.on('end', function (matches) {
+      cb(null, matches)
+    })
+  }
+
+  var self = this
+  var n = this.minimatch.set.length
+  this._processing = 0
+  this.matches = new Array(n)
+
+  this._emitQueue = []
+  this._processQueue = []
+  this.paused = false
+
+  if (this.noprocess)
+    return this
+
+  if (n === 0)
+    return done()
+
+  for (var i = 0; i < n; i ++) {
+    this._process(this.minimatch.set[i], i, false, done)
+  }
+
+  function done () {
+    --self._processing
+    if (self._processing <= 0)
+      self._finish()
+  }
+}
+
+Glob.prototype._finish = function () {
+  assert(this instanceof Glob)
+  if (this.aborted)
+    return
+
+  if (this.realpath && !this._didRealpath)
+    return this._realpath()
+
+  common.finish(this)
+  this.emit('end', this.found)
+}
+
+Glob.prototype._realpath = function () {
+  if (this._didRealpath)
+    return
+
+  this._didRealpath = true
+
+  var n = this.matches.length
+  if (n === 0)
+    return this._finish()
+
+  var self = this
+  for (var i = 0; i < this.matches.length; i++)
+    this._realpathSet(i, next)
+
+  function next () {
+    if (--n === 0)
+      self._finish()
+  }
+}
+
+Glob.prototype._realpathSet = function (index, cb) {
+  var matchset = this.matches[index]
+  if (!matchset)
+    return cb()
+
+  var found = Object.keys(matchset)
+  var self = this
+  var n = found.length
+
+  if (n === 0)
+    return cb()
+
+  var set = this.matches[index] = Object.create(null)
+  found.forEach(function (p, i) {
+    // If there's a problem with the stat, then it means that
+    // one or more of the links in the realpath couldn't be
+    // resolved.  just return the abs value in that case.
+    p = self._makeAbs(p)
+    fs.realpath(p, self.realpathCache, function (er, real) {
+      if (!er)
+        set[real] = true
+      else if (er.syscall === 'stat')
+        set[p] = true
+      else
+        self.emit('error', er) // srsly wtf right here
+
+      if (--n === 0) {
+        self.matches[index] = set
+        cb()
+      }
+    })
+  })
+}
+
+Glob.prototype._mark = function (p) {
+  return common.mark(this, p)
+}
+
+Glob.prototype._makeAbs = function (f) {
+  return common.makeAbs(this, f)
+}
+
+Glob.prototype.abort = function () {
+  this.aborted = true
+  this.emit('abort')
+}
+
+Glob.prototype.pause = function () {
+  if (!this.paused) {
+    this.paused = true
+    this.emit('pause')
+  }
+}
+
+Glob.prototype.resume = function () {
+  if (this.paused) {
+    this.emit('resume')
+    this.paused = false
+    if (this._emitQueue.length) {
+      var eq = this._emitQueue.slice(0)
+      this._emitQueue.length = 0
+      for (var i = 0; i < eq.length; i ++) {
+        var e = eq[i]
+        this._emitMatch(e[0], e[1])
+      }
+    }
+    if (this._processQueue.length) {
+      var pq = this._processQueue.slice(0)
+      this._processQueue.length = 0
+      for (var i = 0; i < pq.length; i ++) {
+        var p = pq[i]
+        this._processing--
+        this._process(p[0], p[1], p[2], p[3])
+      }
+    }
+  }
+}
+
+Glob.prototype._process = function (pattern, index, inGlobStar, cb) {
+  assert(this instanceof Glob)
+  assert(typeof cb === 'function')
+
+  if (this.aborted)
+    return
+
+  this._processing++
+  if (this.paused) {
+    this._processQueue.push([pattern, index, inGlobStar, cb])
+    return
+  }
+
+  //console.error('PROCESS %d', this._processing, pattern)
+
+  // Get the first [n] parts of pattern that are all strings.
+  var n = 0
+  while (typeof pattern[n] === 'string') {
+    n ++
+  }
+  // now n is the index of the first one that is *not* a string.
+
+  // see if there's anything else
+  var prefix
+  switch (n) {
+    // if not, then this is rather simple
+    case pattern.length:
+      this._processSimple(pattern.join('/'), index, cb)
+      return
+
+    case 0:
+      // pattern *starts* with some non-trivial item.
+      // going to readdir(cwd), but not include the prefix in matches.
+      prefix = null
+      break
+
+    default:
+      // pattern has some string bits in the front.
+      // whatever it starts with, whether that's 'absolute' like /foo/bar,
+      // or 'relative' like '../baz'
+      prefix = pattern.slice(0, n).join('/')
+      break
+  }
+
+  var remain = pattern.slice(n)
+
+  // get the list of entries.
+  var read
+  if (prefix === null)
+    read = '.'
+  else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) {
+    if (!prefix || !isAbsolute(prefix))
+      prefix = '/' + prefix
+    read = prefix
+  } else
+    read = prefix
+
+  var abs = this._makeAbs(read)
+
+  //if ignored, skip _processing
+  if (childrenIgnored(this, read))
+    return cb()
+
+  var isGlobStar = remain[0] === minimatch.GLOBSTAR
+  if (isGlobStar)
+    this._processGlobStar(prefix, read, abs, remain, index, inGlobStar, cb)
+  else
+    this._processReaddir(prefix, read, abs, remain, index, inGlobStar, cb)
+}
+
+Glob.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar, cb) {
+  var self = this
+  this._readdir(abs, inGlobStar, function (er, entries) {
+    return self._processReaddir2(prefix, read, abs, remain, index, inGlobStar, entries, cb)
+  })
+}
+
+Glob.prototype._processReaddir2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) {
+
+  // if the abs isn't a dir, then nothing can match!
+  if (!entries)
+    return cb()
+
+  // It will only match dot entries if it starts with a dot, or if
+  // dot is set.  Stuff like @(.foo|.bar) isn't allowed.
+  var pn = remain[0]
+  var negate = !!this.minimatch.negate
+  var rawGlob = pn._glob
+  var dotOk = this.dot || rawGlob.charAt(0) === '.'
+
+  var matchedEntries = []
+  for (var i = 0; i < entries.length; i++) {
+    var e = entries[i]
+    if (e.charAt(0) !== '.' || dotOk) {
+      var m
+      if (negate && !prefix) {
+        m = !e.match(pn)
+      } else {
+        m = e.match(pn)
+      }
+      if (m)
+        matchedEntries.push(e)
+    }
+  }
+
+  //console.error('prd2', prefix, entries, remain[0]._glob, matchedEntries)
+
+  var len = matchedEntries.length
+  // If there are no matched entries, then nothing matches.
+  if (len === 0)
+    return cb()
+
+  // if this is the last remaining pattern bit, then no need for
+  // an additional stat *unless* the user has specified mark or
+  // stat explicitly.  We know they exist, since readdir returned
+  // them.
+
+  if (remain.length === 1 && !this.mark && !this.stat) {
+    if (!this.matches[index])
+      this.matches[index] = Object.create(null)
+
+    for (var i = 0; i < len; i ++) {
+      var e = matchedEntries[i]
+      if (prefix) {
+        if (prefix !== '/')
+          e = prefix + '/' + e
+        else
+          e = prefix + e
+      }
+
+      if (e.charAt(0) === '/' && !this.nomount) {
+        e = path.join(this.root, e)
+      }
+      this._emitMatch(index, e)
+    }
+    // This was the last one, and no stats were needed
+    return cb()
+  }
+
+  // now test all matched entries as stand-ins for that part
+  // of the pattern.
+  remain.shift()
+  for (var i = 0; i < len; i ++) {
+    var e = matchedEntries[i]
+    var newPattern
+    if (prefix) {
+      if (prefix !== '/')
+        e = prefix + '/' + e
+      else
+        e = prefix + e
+    }
+    this._process([e].concat(remain), index, inGlobStar, cb)
+  }
+  cb()
+}
+
+Glob.prototype._emitMatch = function (index, e) {
+  if (this.aborted)
+    return
+
+  if (this.matches[index][e])
+    return
+
+  if (isIgnored(this, e))
+    return
+
+  if (this.paused) {
+    this._emitQueue.push([index, e])
+    return
+  }
+
+  var abs = this._makeAbs(e)
+
+  if (this.nodir) {
+    var c = this.cache[abs]
+    if (c === 'DIR' || Array.isArray(c))
+      return
+  }
+
+  if (this.mark)
+    e = this._mark(e)
+
+  this.matches[index][e] = true
+
+  var st = this.statCache[abs]
+  if (st)
+    this.emit('stat', e, st)
+
+  this.emit('match', e)
+}
+
+Glob.prototype._readdirInGlobStar = function (abs, cb) {
+  if (this.aborted)
+    return
+
+  // follow all symlinked directories forever
+  // just proceed as if this is a non-globstar situation
+  if (this.follow)
+    return this._readdir(abs, false, cb)
+
+  var lstatkey = 'lstat\0' + abs
+  var self = this
+  var lstatcb = inflight(lstatkey, lstatcb_)
+
+  if (lstatcb)
+    fs.lstat(abs, lstatcb)
+
+  function lstatcb_ (er, lstat) {
+    if (er)
+      return cb()
+
+    var isSym = lstat.isSymbolicLink()
+    self.symlinks[abs] = isSym
+
+    // If it's not a symlink or a dir, then it's definitely a regular file.
+    // don't bother doing a readdir in that case.
+    if (!isSym && !lstat.isDirectory()) {
+      self.cache[abs] = 'FILE'
+      cb()
+    } else
+      self._readdir(abs, false, cb)
+  }
+}
+
+Glob.prototype._readdir = function (abs, inGlobStar, cb) {
+  if (this.aborted)
+    return
+
+  cb = inflight('readdir\0'+abs+'\0'+inGlobStar, cb)
+  if (!cb)
+    return
+
+  //console.error('RD %j %j', +inGlobStar, abs)
+  if (inGlobStar && !ownProp(this.symlinks, abs))
+    return this._readdirInGlobStar(abs, cb)
+
+  if (ownProp(this.cache, abs)) {
+    var c = this.cache[abs]
+    if (!c || c === 'FILE')
+      return cb()
+
+    if (Array.isArray(c))
+      return cb(null, c)
+  }
+
+  var self = this
+  fs.readdir(abs, readdirCb(this, abs, cb))
+}
+
+function readdirCb (self, abs, cb) {
+  return function (er, entries) {
+    if (er)
+      self._readdirError(abs, er, cb)
+    else
+      self._readdirEntries(abs, entries, cb)
+  }
+}
+
+Glob.prototype._readdirEntries = function (abs, entries, cb) {
+  if (this.aborted)
+    return
+
+  // if we haven't asked to stat everything, then just
+  // assume that everything in there exists, so we can avoid
+  // having to stat it a second time.
+  if (!this.mark && !this.stat) {
+    for (var i = 0; i < entries.length; i ++) {
+      var e = entries[i]
+      if (abs === '/')
+        e = abs + e
+      else
+        e = abs + '/' + e
+      this.cache[e] = true
+    }
+  }
+
+  this.cache[abs] = entries
+  return cb(null, entries)
+}
+
+Glob.prototype._readdirError = function (f, er, cb) {
+  if (this.aborted)
+    return
+
+  // handle errors, and cache the information
+  switch (er.code) {
+    case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205
+    case 'ENOTDIR': // totally normal. means it *does* exist.
+      this.cache[this._makeAbs(f)] = 'FILE'
+      break
+
+    case 'ENOENT': // not terribly unusual
+    case 'ELOOP':
+    case 'ENAMETOOLONG':
+    case 'UNKNOWN':
+      this.cache[this._makeAbs(f)] = false
+      break
+
+    default: // some unusual error.  Treat as failure.
+      this.cache[this._makeAbs(f)] = false
+      if (this.strict) {
+        this.emit('error', er)
+        // If the error is handled, then we abort
+        // if not, we threw out of here
+        this.abort()
+      }
+      if (!this.silent)
+        console.error('glob error', er)
+      break
+  }
+
+  return cb()
+}
+
+Glob.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar, cb) {
+  var self = this
+  this._readdir(abs, inGlobStar, function (er, entries) {
+    self._processGlobStar2(prefix, read, abs, remain, index, inGlobStar, entries, cb)
+  })
+}
+
+
+Glob.prototype._processGlobStar2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) {
+  //console.error('pgs2', prefix, remain[0], entries)
+
+  // no entries means not a dir, so it can never have matches
+  // foo.txt/** doesn't match foo.txt
+  if (!entries)
+    return cb()
+
+  // test without the globstar, and with every child both below
+  // and replacing the globstar.
+  var remainWithoutGlobStar = remain.slice(1)
+  var gspref = prefix ? [ prefix ] : []
+  var noGlobStar = gspref.concat(remainWithoutGlobStar)
+
+  // the noGlobStar pattern exits the inGlobStar state
+  this._process(noGlobStar, index, false, cb)
+
+  var isSym = this.symlinks[abs]
+  var len = entries.length
+
+  // If it's a symlink, and we're in a globstar, then stop
+  if (isSym && inGlobStar)
+    return cb()
+
+  for (var i = 0; i < len; i++) {
+    var e = entries[i]
+    if (e.charAt(0) === '.' && !this.dot)
+      continue
+
+    // these two cases enter the inGlobStar state
+    var instead = gspref.concat(entries[i], remainWithoutGlobStar)
+    this._process(instead, index, true, cb)
+
+    var below = gspref.concat(entries[i], remain)
+    this._process(below, index, true, cb)
+  }
+
+  cb()
+}
+
+Glob.prototype._processSimple = function (prefix, index, cb) {
+  // XXX review this.  Shouldn't it be doing the mounting etc
+  // before doing stat?  kinda weird?
+  var self = this
+  this._stat(prefix, function (er, exists) {
+    self._processSimple2(prefix, index, er, exists, cb)
+  })
+}
+Glob.prototype._processSimple2 = function (prefix, index, er, exists, cb) {
+
+  //console.error('ps2', prefix, exists)
+
+  if (!this.matches[index])
+    this.matches[index] = Object.create(null)
+
+  // If it doesn't exist, then just mark the lack of results
+  if (!exists)
+    return cb()
+
+  if (prefix && isAbsolute(prefix) && !this.nomount) {
+    var trail = /[\/\\]$/.test(prefix)
+    if (prefix.charAt(0) === '/') {
+      prefix = path.join(this.root, prefix)
+    } else {
+      prefix = path.resolve(this.root, prefix)
+      if (trail)
+        prefix += '/'
+    }
+  }
+
+  if (process.platform === 'win32')
+    prefix = prefix.replace(/\\/g, '/')
+
+  // Mark this as a match
+  this._emitMatch(index, prefix)
+  cb()
+}
+
+// Returns either 'DIR', 'FILE', or false
+Glob.prototype._stat = function (f, cb) {
+  var abs = this._makeAbs(f)
+  var needDir = f.slice(-1) === '/'
+
+  if (f.length > this.maxLength)
+    return cb()
+
+  if (!this.stat && ownProp(this.cache, abs)) {
+    var c = this.cache[abs]
+
+    if (Array.isArray(c))
+      c = 'DIR'
+
+    // It exists, but maybe not how we need it
+    if (!needDir || c === 'DIR')
+      return cb(null, c)
+
+    if (needDir && c === 'FILE')
+      return cb()
+
+    // otherwise we have to stat, because maybe c=true
+    // if we know it exists, but not what it is.
+  }
+
+  var exists
+  var stat = this.statCache[abs]
+  if (stat !== undefined) {
+    if (stat === false)
+      return cb(null, stat)
+    else {
+      var type = stat.isDirectory() ? 'DIR' : 'FILE'
+      if (needDir && type === 'FILE')
+        return cb()
+      else
+        return cb(null, type, stat)
+    }
+  }
+
+  var self = this
+  var statcb = inflight('stat\0' + abs, lstatcb_)
+  if (statcb)
+    fs.lstat(abs, statcb)
+
+  function lstatcb_ (er, lstat) {
+    if (lstat && lstat.isSymbolicLink()) {
+      // If it's a symlink, then treat it as the target, unless
+      // the target does not exist, then treat it as a file.
+      return fs.stat(abs, function (er, stat) {
+        if (er)
+          self._stat2(f, abs, null, lstat, cb)
+        else
+          self._stat2(f, abs, er, stat, cb)
+      })
+    } else {
+      self._stat2(f, abs, er, lstat, cb)
+    }
+  }
+}
+
+Glob.prototype._stat2 = function (f, abs, er, stat, cb) {
+  if (er) {
+    this.statCache[abs] = false
+    return cb()
+  }
+
+  var needDir = f.slice(-1) === '/'
+  this.statCache[abs] = stat
+
+  if (abs.slice(-1) === '/' && !stat.isDirectory())
+    return cb(null, false, stat)
+
+  var c = stat.isDirectory() ? 'DIR' : 'FILE'
+  this.cache[abs] = this.cache[abs] || c
+
+  if (needDir && c !== 'DIR')
+    return cb()
+
+  return cb(null, c, stat)
+}
+
+}).call(this,require('_process'))
+},{"./common.js":15,"./sync.js":17,"_process":24,"assert":9,"events":14,"fs":12,"inflight":18,"inherits":19,"minimatch":20,"once":21,"path":22,"path-is-absolute":23,"util":28}],17:[function(require,module,exports){
+(function (process){
+module.exports = globSync
+globSync.GlobSync = GlobSync
+
+var fs = require('fs')
+var minimatch = require('minimatch')
+var Minimatch = minimatch.Minimatch
+var Glob = require('./glob.js').Glob
+var util = require('util')
+var path = require('path')
+var assert = require('assert')
+var isAbsolute = require('path-is-absolute')
+var common = require('./common.js')
+var alphasort = common.alphasort
+var alphasorti = common.alphasorti
+var setopts = common.setopts
+var ownProp = common.ownProp
+var childrenIgnored = common.childrenIgnored
+
+function globSync (pattern, options) {
+  if (typeof options === 'function' || arguments.length === 3)
+    throw new TypeError('callback provided to sync glob\n'+
+                        'See: https://github.com/isaacs/node-glob/issues/167')
+
+  return new GlobSync(pattern, options).found
+}
+
+function GlobSync (pattern, options) {
+  if (!pattern)
+    throw new Error('must provide pattern')
+
+  if (typeof options === 'function' || arguments.length === 3)
+    throw new TypeError('callback provided to sync glob\n'+
+                        'See: https://github.com/isaacs/node-glob/issues/167')
+
+  if (!(this instanceof GlobSync))
+    return new GlobSync(pattern, options)
+
+  setopts(this, pattern, options)
+
+  if (this.noprocess)
+    return this
+
+  var n = this.minimatch.set.length
+  this.matches = new Array(n)
+  for (var i = 0; i < n; i ++) {
+    this._process(this.minimatch.set[i], i, false)
+  }
+  this._finish()
+}
+
+GlobSync.prototype._finish = function () {
+  assert(this instanceof GlobSync)
+  if (this.realpath) {
+    var self = this
+    this.matches.forEach(function (matchset, index) {
+      var set = self.matches[index] = Object.create(null)
+      for (var p in matchset) {
+        try {
+          p = self._makeAbs(p)
+          var real = fs.realpathSync(p, self.realpathCache)
+          set[real] = true
+        } catch (er) {
+          if (er.syscall === 'stat')
+            set[self._makeAbs(p)] = true
+          else
+            throw er
+        }
+      }
+    })
+  }
+  common.finish(this)
+}
+
+
+GlobSync.prototype._process = function (pattern, index, inGlobStar) {
+  assert(this instanceof GlobSync)
+
+  // Get the first [n] parts of pattern that are all strings.
+  var n = 0
+  while (typeof pattern[n] === 'string') {
+    n ++
+  }
+  // now n is the index of the first one that is *not* a string.
+
+  // See if there's anything else
+  var prefix
+  switch (n) {
+    // if not, then this is rather simple
+    case pattern.length:
+      this._processSimple(pattern.join('/'), index)
+      return
+
+    case 0:
+      // pattern *starts* with some non-trivial item.
+      // going to readdir(cwd), but not include the prefix in matches.
+      prefix = null
+      break
+
+    default:
+      // pattern has some string bits in the front.
+      // whatever it starts with, whether that's 'absolute' like /foo/bar,
+      // or 'relative' like '../baz'
+      prefix = pattern.slice(0, n).join('/')
+      break
+  }
+
+  var remain = pattern.slice(n)
+
+  // get the list of entries.
+  var read
+  if (prefix === null)
+    read = '.'
+  else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) {
+    if (!prefix || !isAbsolute(prefix))
+      prefix = '/' + prefix
+    read = prefix
+  } else
+    read = prefix
+
+  var abs = this._makeAbs(read)
+
+  //if ignored, skip processing
+  if (childrenIgnored(this, read))
+    return
+
+  var isGlobStar = remain[0] === minimatch.GLOBSTAR
+  if (isGlobStar)
+    this._processGlobStar(prefix, read, abs, remain, index, inGlobStar)
+  else
+    this._processReaddir(prefix, read, abs, remain, index, inGlobStar)
+}
+
+
+GlobSync.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar) {
+  var entries = this._readdir(abs, inGlobStar)
+
+  // if the abs isn't a dir, then nothing can match!
+  if (!entries)
+    return
+
+  // It will only match dot entries if it starts with a dot, or if
+  // dot is set.  Stuff like @(.foo|.bar) isn't allowed.
+  var pn = remain[0]
+  var negate = !!this.minimatch.negate
+  var rawGlob = pn._glob
+  var dotOk = this.dot || rawGlob.charAt(0) === '.'
+
+  var matchedEntries = []
+  for (var i = 0; i < entries.length; i++) {
+    var e = entries[i]
+    if (e.charAt(0) !== '.' || dotOk) {
+      var m
+      if (negate && !prefix) {
+        m = !e.match(pn)
+      } else {
+        m = e.match(pn)
+      }
+      if (m)
+        matchedEntries.push(e)
+    }
+  }
+
+  var len = matchedEntries.length
+  // If there are no matched entries, then nothing matches.
+  if (len === 0)
+    return
+
+  // if this is the last remaining pattern bit, then no need for
+  // an additional stat *unless* the user has specified mark or
+  // stat explicitly.  We know they exist, since readdir returned
+  // them.
+
+  if (remain.length === 1 && !this.mark && !this.stat) {
+    if (!this.matches[index])
+      this.matches[index] = Object.create(null)
+
+    for (var i = 0; i < len; i ++) {
+      var e = matchedEntries[i]
+      if (prefix) {
+        if (prefix.slice(-1) !== '/')
+          e = prefix + '/' + e
+        else
+          e = prefix + e
+      }
+
+      if (e.charAt(0) === '/' && !this.nomount) {
+        e = path.join(this.root, e)
+      }
+      this.matches[index][e] = true
+    }
+    // This was the last one, and no stats were needed
+    return
+  }
+
+  // now test all matched entries as stand-ins for that part
+  // of the pattern.
+  remain.shift()
+  for (var i = 0; i < len; i ++) {
+    var e = matchedEntries[i]
+    var newPattern
+    if (prefix)
+      newPattern = [prefix, e]
+    else
+      newPattern = [e]
+    this._process(newPattern.concat(remain), index, inGlobStar)
+  }
+}
+
+
+GlobSync.prototype._emitMatch = function (index, e) {
+  var abs = this._makeAbs(e)
+  if (this.mark)
+    e = this._mark(e)
+
+  if (this.matches[index][e])
+    return
+
+  if (this.nodir) {
+    var c = this.cache[this._makeAbs(e)]
+    if (c === 'DIR' || Array.isArray(c))
+      return
+  }
+
+  this.matches[index][e] = true
+  if (this.stat)
+    this._stat(e)
+}
+
+
+GlobSync.prototype._readdirInGlobStar = function (abs) {
+  // follow all symlinked directories forever
+  // just proceed as if this is a non-globstar situation
+  if (this.follow)
+    return this._readdir(abs, false)
+
+  var entries
+  var lstat
+  var stat
+  try {
+    lstat = fs.lstatSync(abs)
+  } catch (er) {
+    // lstat failed, doesn't exist
+    return null
+  }
+
+  var isSym = lstat.isSymbolicLink()
+  this.symlinks[abs] = isSym
+
+  // If it's not a symlink or a dir, then it's definitely a regular file.
+  // don't bother doing a readdir in that case.
+  if (!isSym && !lstat.isDirectory())
+    this.cache[abs] = 'FILE'
+  else
+    entries = this._readdir(abs, false)
+
+  return entries
+}
+
+GlobSync.prototype._readdir = function (abs, inGlobStar) {
+  var entries
+
+  if (inGlobStar && !ownProp(this.symlinks, abs))
+    return this._readdirInGlobStar(abs)
+
+  if (ownProp(this.cache, abs)) {
+    var c = this.cache[abs]
+    if (!c || c === 'FILE')
+      return null
+
+    if (Array.isArray(c))
+      return c
+  }
+
+  try {
+    return this._readdirEntries(abs, fs.readdirSync(abs))
+  } catch (er) {
+    this._readdirError(abs, er)
+    return null
+  }
+}
+
+GlobSync.prototype._readdirEntries = function (abs, entries) {
+  // if we haven't asked to stat everything, then just
+  // assume that everything in there exists, so we can avoid
+  // having to stat it a second time.
+  if (!this.mark && !this.stat) {
+    for (var i = 0; i < entries.length; i ++) {
+      var e = entries[i]
+      if (abs === '/')
+        e = abs + e
+      else
+        e = abs + '/' + e
+      this.cache[e] = true
+    }
+  }
+
+  this.cache[abs] = entries
+
+  // mark and cache dir-ness
+  return entries
+}
+
+GlobSync.prototype._readdirError = function (f, er) {
+  // handle errors, and cache the information
+  switch (er.code) {
+    case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205
+    case 'ENOTDIR': // totally normal. means it *does* exist.
+      this.cache[this._makeAbs(f)] = 'FILE'
+      break
+
+    case 'ENOENT': // not terribly unusual
+    case 'ELOOP':
+    case 'ENAMETOOLONG':
+    case 'UNKNOWN':
+      this.cache[this._makeAbs(f)] = false
+      break
+
+    default: // some unusual error.  Treat as failure.
+      this.cache[this._makeAbs(f)] = false
+      if (this.strict)
+        throw er
+      if (!this.silent)
+        console.error('glob error', er)
+      break
+  }
+}
+
+GlobSync.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar) {
+
+  var entries = this._readdir(abs, inGlobStar)
+
+  // no entries means not a dir, so it can never have matches
+  // foo.txt/** doesn't match foo.txt
+  if (!entries)
+    return
+
+  // test without the globstar, and with every child both below
+  // and replacing the globstar.
+  var remainWithoutGlobStar = remain.slice(1)
+  var gspref = prefix ? [ prefix ] : []
+  var noGlobStar = gspref.concat(remainWithoutGlobStar)
+
+  // the noGlobStar pattern exits the inGlobStar state
+  this._process(noGlobStar, index, false)
+
+  var len = entries.length
+  var isSym = this.symlinks[abs]
+
+  // If it's a symlink, and we're in a globstar, then stop
+  if (isSym && inGlobStar)
+    return
+
+  for (var i = 0; i < len; i++) {
+    var e = entries[i]
+    if (e.charAt(0) === '.' && !this.dot)
+      continue
+
+    // these two cases enter the inGlobStar state
+    var instead = gspref.concat(entries[i], remainWithoutGlobStar)
+    this._process(instead, index, true)
+
+    var below = gspref.concat(entries[i], remain)
+    this._process(below, index, true)
+  }
+}
+
+GlobSync.prototype._processSimple = function (prefix, index) {
+  // XXX review this.  Shouldn't it be doing the mounting etc
+  // before doing stat?  kinda weird?
+  var exists = this._stat(prefix)
+
+  if (!this.matches[index])
+    this.matches[index] = Object.create(null)
+
+  // If it doesn't exist, then just mark the lack of results
+  if (!exists)
+    return
+
+  if (prefix && isAbsolute(prefix) && !this.nomount) {
+    var trail = /[\/\\]$/.test(prefix)
+    if (prefix.charAt(0) === '/') {
+      prefix = path.join(this.root, prefix)
+    } else {
+      prefix = path.resolve(this.root, prefix)
+      if (trail)
+        prefix += '/'
+    }
+  }
+
+  if (process.platform === 'win32')
+    prefix = prefix.replace(/\\/g, '/')
+
+  // Mark this as a match
+  this.matches[index][prefix] = true
+}
+
+// Returns either 'DIR', 'FILE', or false
+GlobSync.prototype._stat = function (f) {
+  var abs = this._makeAbs(f)
+  var needDir = f.slice(-1) === '/'
+
+  if (f.length > this.maxLength)
+    return false
+
+  if (!this.stat && ownProp(this.cache, abs)) {
+    var c = this.cache[abs]
+
+    if (Array.isArray(c))
+      c = 'DIR'
+
+    // It exists, but maybe not how we need it
+    if (!needDir || c === 'DIR')
+      return c
+
+    if (needDir && c === 'FILE')
+      return false
+
+    // otherwise we have to stat, because maybe c=true
+    // if we know it exists, but not what it is.
+  }
+
+  var exists
+  var stat = this.statCache[abs]
+  if (!stat) {
+    var lstat
+    try {
+      lstat = fs.lstatSync(abs)
+    } catch (er) {
+      return false
+    }
+
+    if (lstat.isSymbolicLink()) {
+      try {
+        stat = fs.statSync(abs)
+      } catch (er) {
+        stat = lstat
+      }
+    } else {
+      stat = lstat
+    }
+  }
+
+  this.statCache[abs] = stat
+
+  var c = stat.isDirectory() ? 'DIR' : 'FILE'
+  this.cache[abs] = this.cache[abs] || c
+
+  if (needDir && c !== 'DIR')
+    return false
+
+  return c
+}
+
+GlobSync.prototype._mark = function (p) {
+  return common.mark(this, p)
+}
+
+GlobSync.prototype._makeAbs = function (f) {
+  return common.makeAbs(this, f)
+}
+
+}).call(this,require('_process'))
+},{"./common.js":15,"./glob.js":16,"_process":24,"assert":9,"fs":12,"minimatch":20,"path":22,"path-is-absolute":23,"util":28}],18:[function(require,module,exports){
+(function (process){
+var wrappy = require('wrappy')
+var reqs = Object.create(null)
+var once = require('once')
+
+module.exports = wrappy(inflight)
+
+function inflight (key, cb) {
+  if (reqs[key]) {
+    reqs[key].push(cb)
+    return null
+  } else {
+    reqs[key] = [cb]
+    return makeres(key)
+  }
+}
+
+function makeres (key) {
+  return once(function RES () {
+    var cbs = reqs[key]
+    var len = cbs.length
+    var args = slice(arguments)
+
+    // XXX It's somewhat ambiguous whether a new callback added in this
+    // pass should be queued for later execution if something in the
+    // list of callbacks throws, or if it should just be discarded.
+    // However, it's such an edge case that it hardly matters, and either
+    // choice is likely as surprising as the other.
+    // As it happens, we do go ahead and schedule it for later execution.
+    try {
+      for (var i = 0; i < len; i++) {
+        cbs[i].apply(null, args)
+      }
+    } finally {
+      if (cbs.length > len) {
+        // added more in the interim.
+        // de-zalgo, just in case, but don't call again.
+        cbs.splice(0, len)
+        process.nextTick(function () {
+          RES.apply(null, args)
+        })
+      } else {
+        delete reqs[key]
+      }
+    }
+  })
+}
+
+function slice (args) {
+  var length = args.length
+  var array = []
+
+  for (var i = 0; i < length; i++) array[i] = args[i]
+  return array
+}
+
+}).call(this,require('_process'))
+},{"_process":24,"once":21,"wrappy":29}],19:[function(require,module,exports){
+if (typeof Object.create === 'function') {
+  // implementation from standard node.js 'util' module
+  module.exports = function inherits(ctor, superCtor) {
+    ctor.super_ = superCtor
+    ctor.prototype = Object.create(superCtor.prototype, {
+      constructor: {
+        value: ctor,
+        enumerable: false,
+        writable: true,
+        configurable: true
+      }
+    });
+  };
+} else {
+  // old school shim for old browsers
+  module.exports = function inherits(ctor, superCtor) {
+    ctor.super_ = superCtor
+    var TempCtor = function () {}
+    TempCtor.prototype = superCtor.prototype
+    ctor.prototype = new TempCtor()
+    ctor.prototype.constructor = ctor
+  }
+}
+
+},{}],20:[function(require,module,exports){
+module.exports = minimatch
+minimatch.Minimatch = Minimatch
+
+var path = { sep: '/' }
+try {
+  path = require('path')
+} catch (er) {}
+
+var GLOBSTAR = minimatch.GLOBSTAR = Minimatch.GLOBSTAR = {}
+var expand = require('brace-expansion')
+
+var plTypes = {
+  '!': { open: '(?:(?!(?:', close: '))[^/]*?)'},
+  '?': { open: '(?:', close: ')?' },
+  '+': { open: '(?:', close: ')+' },
+  '*': { open: '(?:', close: ')*' },
+  '@': { open: '(?:', close: ')' }
+}
+
+// any single thing other than /
+// don't need to escape / when using new RegExp()
+var qmark = '[^/]'
+
+// * => any number of characters
+var star = qmark + '*?'
+
+// ** when dots are allowed.  Anything goes, except .. and .
+// not (^ or / followed by one or two dots followed by $ or /),
+// followed by anything, any number of times.
+var twoStarDot = '(?:(?!(?:\\\/|^)(?:\\.{1,2})($|\\\/)).)*?'
+
+// not a ^ or / followed by a dot,
+// followed by anything, any number of times.
+var twoStarNoDot = '(?:(?!(?:\\\/|^)\\.).)*?'
+
+// characters that need to be escaped in RegExp.
+var reSpecials = charSet('().*{}+?[]^$\\!')
+
+// "abc" -> { a:true, b:true, c:true }
+function charSet (s) {
+  return s.split('').reduce(function (set, c) {
+    set[c] = true
+    return set
+  }, {})
+}
+
+// normalizes slashes.
+var slashSplit = /\/+/
+
+minimatch.filter = filter
+function filter (pattern, options) {
+  options = options || {}
+  return function (p, i, list) {
+    return minimatch(p, pattern, options)
+  }
+}
+
+function ext (a, b) {
+  a = a || {}
+  b = b || {}
+  var t = {}
+  Object.keys(b).forEach(function (k) {
+    t[k] = b[k]
+  })
+  Object.keys(a).forEach(function (k) {
+    t[k] = a[k]
+  })
+  return t
+}
+
+minimatch.defaults = function (def) {
+  if (!def || !Object.keys(def).length) return minimatch
+
+  var orig = minimatch
+
+  var m = function minimatch (p, pattern, options) {
+    return orig.minimatch(p, pattern, ext(def, options))
+  }
+
+  m.Minimatch = function Minimatch (pattern, options) {
+    return new orig.Minimatch(pattern, ext(def, options))
+  }
+
+  return m
+}
+
+Minimatch.defaults = function (def) {
+  if (!def || !Object.keys(def).length) return Minimatch
+  return minimatch.defaults(def).Minimatch
+}
+
+function minimatch (p, pattern, options) {
+  if (typeof pattern !== 'string') {
+    throw new TypeError('glob pattern string required')
+  }
+
+  if (!options) options = {}
+
+  // shortcut: comments match nothing.
+  if (!options.nocomment && pattern.charAt(0) === '#') {
+    return false
+  }
+
+  // "" only matches ""
+  if (pattern.trim() === '') return p === ''
+
+  return new Minimatch(pattern, options).match(p)
+}
+
+function Minimatch (pattern, options) {
+  if (!(this instanceof Minimatch)) {
+    return new Minimatch(pattern, options)
+  }
+
+  if (typeof pattern !== 'string') {
+    throw new TypeError('glob pattern string required')
+  }
+
+  if (!options) options = {}
+  pattern = pattern.trim()
+
+  // windows support: need to use /, not \
+  if (path.sep !== '/') {
+    pattern = pattern.split(path.sep).join('/')
+  }
+
+  this.options = options
+  this.set = []
+  this.pattern = pattern
+  this.regexp = null
+  this.negate = false
+  this.comment = false
+  this.empty = false
+
+  // make the set of regexps etc.
+  this.make()
+}
+
+Minimatch.prototype.debug = function () {}
+
+Minimatch.prototype.make = make
+function make () {
+  // don't do it more than once.
+  if (this._made) return
+
+  var pattern = this.pattern
+  var options = this.options
+
+  // empty patterns and comments match nothing.
+  if (!options.nocomment && pattern.charAt(0) === '#') {
+    this.comment = true
+    return
+  }
+  if (!pattern) {
+    this.empty = true
+    return
+  }
+
+  // step 1: figure out negation, etc.
+  this.parseNegate()
+
+  // step 2: expand braces
+  var set = this.globSet = this.braceExpand()
+
+  if (options.debug) this.debug = console.error
+
+  this.debug(this.pattern, set)
+
+  // step 3: now we have a set, so turn each one into a series of path-portion
+  // matching patterns.
+  // These will be regexps, except in the case of "**", which is
+  // set to the GLOBSTAR object for globstar behavior,
+  // and will not contain any / characters
+  set = this.globParts = set.map(function (s) {
+    return s.split(slashSplit)
+  })
+
+  this.debug(this.pattern, set)
+
+  // glob --> regexps
+  set = set.map(function (s, si, set) {
+    return s.map(this.parse, this)
+  }, this)
+
+  this.debug(this.pattern, set)
+
+  // filter out everything that didn't compile properly.
+  set = set.filter(function (s) {
+    return s.indexOf(false) === -1
+  })
+
+  this.debug(this.pattern, set)
+
+  this.set = set
+}
+
+Minimatch.prototype.parseNegate = parseNegate
+function parseNegate () {
+  var pattern = this.pattern
+  var negate = false
+  var options = this.options
+  var negateOffset = 0
+
+  if (options.nonegate) return
+
+  for (var i = 0, l = pattern.length
+    ; i < l && pattern.charAt(i) === '!'
+    ; i++) {
+    negate = !negate
+    negateOffset++
+  }
+
+  if (negateOffset) this.pattern = pattern.substr(negateOffset)
+  this.negate = negate
+}
+
+// Brace expansion:
+// a{b,c}d -> abd acd
+// a{b,}c -> abc ac
+// a{0..3}d -> a0d a1d a2d a3d
+// a{b,c{d,e}f}g -> abg acdfg acefg
+// a{b,c}d{e,f}g -> abdeg acdeg abdeg abdfg
+//
+// Invalid sets are not expanded.
+// a{2..}b -> a{2..}b
+// a{b}c -> a{b}c
+minimatch.braceExpand = function (pattern, options) {
+  return braceExpand(pattern, options)
+}
+
+Minimatch.prototype.braceExpand = braceExpand
+
+function braceExpand (pattern, options) {
+  if (!options) {
+    if (this instanceof Minimatch) {
+      options = this.options
+    } else {
+      options = {}
+    }
+  }
+
+  pattern = typeof pattern === 'undefined'
+    ? this.pattern : pattern
+
+  if (typeof pattern === 'undefined') {
+    throw new TypeError('undefined pattern')
+  }
+
+  if (options.nobrace ||
+    !pattern.match(/\{.*\}/)) {
+    // shortcut. no need to expand.
+    return [pattern]
+  }
+
+  return expand(pattern)
+}
+
+// parse a component of the expanded set.
+// At this point, no pattern may contain "/" in it
+// so we're going to return a 2d array, where each entry is the full
+// pattern, split on '/', and then turned into a regular expression.
+// A regexp is made at the end which joins each array with an
+// escaped /, and another full one which joins each regexp with |.
+//
+// Following the lead of Bash 4.1, note that "**" only has special meaning
+// when it is the *only* thing in a path portion.  Otherwise, any series
+// of * is equivalent to a single *.  Globstar behavior is enabled by
+// default, and can be disabled by setting options.noglobstar.
+Minimatch.prototype.parse = parse
+var SUBPARSE = {}
+function parse (pattern, isSub) {
+  if (pattern.length > 1024 * 64) {
+    throw new TypeError('pattern is too long')
+  }
+
+  var options = this.options
+
+  // shortcuts
+  if (!options.noglobstar && pattern === '**') return GLOBSTAR
+  if (pattern === '') return ''
+
+  var re = ''
+  var hasMagic = !!options.nocase
+  var escaping = false
+  // ? => one single character
+  var patternListStack = []
+  var negativeLists = []
+  var stateChar
+  var inClass = false
+  var reClassStart = -1
+  var classStart = -1
+  // . and .. never match anything that doesn't start with .,
+  // even when options.dot is set.
+  var patternStart = pattern.charAt(0) === '.' ? '' // anything
+  // not (start or / followed by . or .. followed by / or end)
+  : options.dot ? '(?!(?:^|\\\/)\\.{1,2}(?:$|\\\/))'
+  : '(?!\\.)'
+  var self = this
+
+  function clearStateChar () {
+    if (stateChar) {
+      // we had some state-tracking character
+      // that wasn't consumed by this pass.
+      switch (stateChar) {
+        case '*':
+          re += star
+          hasMagic = true
+        break
+        case '?':
+          re += qmark
+          hasMagic = true
+        break
+        default:
+          re += '\\' + stateChar
+        break
+      }
+      self.debug('clearStateChar %j %j', stateChar, re)
+      stateChar = false
+    }
+  }
+
+  for (var i = 0, len = pattern.length, c
+    ; (i < len) && (c = pattern.charAt(i))
+    ; i++) {
+    this.debug('%s\t%s %s %j', pattern, i, re, c)
+
+    // skip over any that are escaped.
+    if (escaping && reSpecials[c]) {
+      re += '\\' + c
+      escaping = false
+      continue
+    }
+
+    switch (c) {
+      case '/':
+        // completely not allowed, even escaped.
+        // Should already be path-split by now.
+        return false
+
+      case '\\':
+        clearStateChar()
+        escaping = true
+      continue
+
+      // the various stateChar values
+      // for the "extglob" stuff.
+      case '?':
+      case '*':
+      case '+':
+      case '@':
+      case '!':
+        this.debug('%s\t%s %s %j <-- stateChar', pattern, i, re, c)
+
+        // all of those are literals inside a class, except that
+        // the glob [!a] means [^a] in regexp
+        if (inClass) {
+          this.debug('  in class')
+          if (c === '!' && i === classStart + 1) c = '^'
+          re += c
+          continue
+        }
+
+        // if we already have a stateChar, then it means
+        // that there was something like ** or +? in there.
+        // Handle the stateChar, then proceed with this one.
+        self.debug('call clearStateChar %j', stateChar)
+        clearStateChar()
+        stateChar = c
+        // if extglob is disabled, then +(asdf|foo) isn't a thing.
+        // just clear the statechar *now*, rather than even diving into
+        // the patternList stuff.
+        if (options.noext) clearStateChar()
+      continue
+
+      case '(':
+        if (inClass) {
+          re += '('
+          continue
+        }
+
+        if (!stateChar) {
+          re += '\\('
+          continue
+        }
+
+        patternListStack.push({
+          type: stateChar,
+          start: i - 1,
+          reStart: re.length,
+          open: plTypes[stateChar].open,
+          close: plTypes[stateChar].close
+        })
+        // negation is (?:(?!js)[^/]*)
+        re += stateChar === '!' ? '(?:(?!(?:' : '(?:'
+        this.debug('plType %j %j', stateChar, re)
+        stateChar = false
+      continue
+
+      case ')':
+        if (inClass || !patternListStack.length) {
+          re += '\\)'
+          continue
+        }
+
+        clearStateChar()
+        hasMagic = true
+        var pl = patternListStack.pop()
+        // negation is (?:(?!js)[^/]*)
+        // The others are (?:<pattern>)<type>
+        re += pl.close
+        if (pl.type === '!') {
+          negativeLists.push(pl)
+        }
+        pl.reEnd = re.length
+      continue
+
+      case '|':
+        if (inClass || !patternListStack.length || escaping) {
+          re += '\\|'
+          escaping = false
+          continue
+        }
+
+        clearStateChar()
+        re += '|'
+      continue
+
+      // these are mostly the same in regexp and glob
+      case '[':
+        // swallow any state-tracking char before the [
+        clearStateChar()
+
+        if (inClass) {
+          re += '\\' + c
+          continue
+        }
+
+        inClass = true
+        classStart = i
+        reClassStart = re.length
+        re += c
+      continue
+
+      case ']':
+        //  a right bracket shall lose its special
+        //  meaning and represent itself in
+        //  a bracket expression if it occurs
+        //  first in the list.  -- POSIX.2 2.8.3.2
+        if (i === classStart + 1 || !inClass) {
+          re += '\\' + c
+          escaping = false
+          continue
+        }
+
+        // handle the case where we left a class open.
+        // "[z-a]" is valid, equivalent to "\[z-a\]"
+        if (inClass) {
+          // split where the last [ was, make sure we don't have
+          // an invalid re. if so, re-walk the contents of the
+          // would-be class to re-translate any characters that
+          // were passed through as-is
+          // TODO: It would probably be faster to determine this
+          // without a try/catch and a new RegExp, but it's tricky
+          // to do safely.  For now, this is safe and works.
+          var cs = pattern.substring(classStart + 1, i)
+          try {
+            RegExp('[' + cs + ']')
+          } catch (er) {
+            // not a valid class!
+            var sp = this.parse(cs, SUBPARSE)
+            re = re.substr(0, reClassStart) + '\\[' + sp[0] + '\\]'
+            hasMagic = hasMagic || sp[1]
+            inClass = false
+            continue
+          }
+        }
+
+        // finish up the class.
+        hasMagic = true
+        inClass = false
+        re += c
+      continue
+
+      default:
+        // swallow any state char that wasn't consumed
+        clearStateChar()
+
+        if (escaping) {
+          // no need
+          escaping = false
+        } else if (reSpecials[c]
+          && !(c === '^' && inClass)) {
+          re += '\\'
+        }
+
+        re += c
+
+    } // switch
+  } // for
+
+  // handle the case where we left a class open.
+  // "[abc" is valid, equivalent to "\[abc"
+  if (inClass) {
+    // split where the last [ was, and escape it
+    // this is a huge pita.  We now have to re-walk
+    // the contents of the would-be class to re-translate
+    // any characters that were passed through as-is
+    cs = pattern.substr(classStart + 1)
+    sp = this.parse(cs, SUBPARSE)
+    re = re.substr(0, reClassStart) + '\\[' + sp[0]
+    hasMagic = hasMagic || sp[1]
+  }
+
+  // handle the case where we had a +( thing at the *end*
+  // of the pattern.
+  // each pattern list stack adds 3 chars, and we need to go through
+  // and escape any | chars that were passed through as-is for the regexp.
+  // Go through and escape them, taking care not to double-escape any
+  // | chars that were already escaped.
+  for (pl = patternListStack.pop(); pl; pl = patternListStack.pop()) {
+    var tail = re.slice(pl.reStart + pl.open.length)
+    this.debug('setting tail', re, pl)
+    // maybe some even number of \, then maybe 1 \, followed by a |
+    tail = tail.replace(/((?:\\{2}){0,64})(\\?)\|/g, function (_, $1, $2) {
+      if (!$2) {
+        // the | isn't already escaped, so escape it.
+        $2 = '\\'
+      }
+
+      // need to escape all those slashes *again*, without escaping the
+      // one that we need for escaping the | character.  As it works out,
+      // escaping an even number of slashes can be done by simply repeating
+      // it exactly after itself.  That's why this trick works.
+      //
+      // I am sorry that you have to see this.
+      return $1 + $1 + $2 + '|'
+    })
+
+    this.debug('tail=%j\n   %s', tail, tail, pl, re)
+    var t = pl.type === '*' ? star
+      : pl.type === '?' ? qmark
+      : '\\' + pl.type
+
+    hasMagic = true
+    re = re.slice(0, pl.reStart) + t + '\\(' + tail
+  }
+
+  // handle trailing things that only matter at the very end.
+  clearStateChar()
+  if (escaping) {
+    // trailing \\
+    re += '\\\\'
+  }
+
+  // only need to apply the nodot start if the re starts with
+  // something that could conceivably capture a dot
+  var addPatternStart = false
+  switch (re.charAt(0)) {
+    case '.':
+    case '[':
+    case '(': addPatternStart = true
+  }
+
+  // Hack to work around lack of negative lookbehind in JS
+  // A pattern like: *.!(x).!(y|z) needs to ensure that a name
+  // like 'a.xyz.yz' doesn't match.  So, the first negative
+  // lookahead, has to look ALL the way ahead, to the end of
+  // the pattern.
+  for (var n = negativeLists.length - 1; n > -1; n--) {
+    var nl = negativeLists[n]
+
+    var nlBefore = re.slice(0, nl.reStart)
+    var nlFirst = re.slice(nl.reStart, nl.reEnd - 8)
+    var nlLast = re.slice(nl.reEnd - 8, nl.reEnd)
+    var nlAfter = re.slice(nl.reEnd)
+
+    nlLast += nlAfter
+
+    // Handle nested stuff like *(*.js|!(*.json)), where open parens
+    // mean that we should *not* include the ) in the bit that is considered
+    // "after" the negated section.
+    var openParensBefore = nlBefore.split('(').length - 1
+    var cleanAfter = nlAfter
+    for (i = 0; i < openParensBefore; i++) {
+      cleanAfter = cleanAfter.replace(/\)[+*?]?/, '')
+    }
+    nlAfter = cleanAfter
+
+    var dollar = ''
+    if (nlAfter === '' && isSub !== SUBPARSE) {
+      dollar = '$'
+    }
+    var newRe = nlBefore + nlFirst + nlAfter + dollar + nlLast
+    re = newRe
+  }
+
+  // if the re is not "" at this point, then we need to make sure
+  // it doesn't match against an empty path part.
+  // Otherwise a/* will match a/, which it should not.
+  if (re !== '' && hasMagic) {
+    re = '(?=.)' + re
+  }
+
+  if (addPatternStart) {
+    re = patternStart + re
+  }
+
+  // parsing just a piece of a larger pattern.
+  if (isSub === SUBPARSE) {
+    return [re, hasMagic]
+  }
+
+  // skip the regexp for non-magical patterns
+  // unescape anything in it, though, so that it'll be
+  // an exact match against a file etc.
+  if (!hasMagic) {
+    return globUnescape(pattern)
+  }
+
+  var flags = options.nocase ? 'i' : ''
+  try {
+    var regExp = new RegExp('^' + re + '$', flags)
+  } catch (er) {
+    // If it was an invalid regular expression, then it can't match
+    // anything.  This trick looks for a character after the end of
+    // the string, which is of course impossible, except in multi-line
+    // mode, but it's not a /m regex.
+    return new RegExp('$.')
+  }
+
+  regExp._glob = pattern
+  regExp._src = re
+
+  return regExp
+}
+
+minimatch.makeRe = function (pattern, options) {
+  return new Minimatch(pattern, options || {}).makeRe()
+}
+
+Minimatch.prototype.makeRe = makeRe
+function makeRe () {
+  if (this.regexp || this.regexp === false) return this.regexp
+
+  // at this point, this.set is a 2d array of partial
+  // pattern strings, or "**".
+  //
+  // It's better to use .match().  This function shouldn't
+  // be used, really, but it's pretty convenient sometimes,
+  // when you just want to work with a regex.
+  var set = this.set
+
+  if (!set.length) {
+    this.regexp = false
+    return this.regexp
+  }
+  var options = this.options
+
+  var twoStar = options.noglobstar ? star
+    : options.dot ? twoStarDot
+    : twoStarNoDot
+  var flags = options.nocase ? 'i' : ''
+
+  var re = set.map(function (pattern) {
+    return pattern.map(function (p) {
+      return (p === GLOBSTAR) ? twoStar
+      : (typeof p === 'string') ? regExpEscape(p)
+      : p._src
+    }).join('\\\/')
+  }).join('|')
+
+  // must match entire pattern
+  // ending in a * or ** will make it less strict.
+  re = '^(?:' + re + ')$'
+
+  // can match anything, as long as it's not this.
+  if (this.negate) re = '^(?!' + re + ').*$'
+
+  try {
+    this.regexp = new RegExp(re, flags)
+  } catch (ex) {
+    this.regexp = false
+  }
+  return this.regexp
+}
+
+minimatch.match = function (list, pattern, options) {
+  options = options || {}
+  var mm = new Minimatch(pattern, options)
+  list = list.filter(function (f) {
+    return mm.match(f)
+  })
+  if (mm.options.nonull && !list.length) {
+    list.push(pattern)
+  }
+  return list
+}
+
+Minimatch.prototype.match = match
+function match (f, partial) {
+  this.debug('match', f, this.pattern)
+  // short-circuit in the case of busted things.
+  // comments, etc.
+  if (this.comment) return false
+  if (this.empty) return f === ''
+
+  if (f === '/' && partial) return true
+
+  var options = this.options
+
+  // windows: need to use /, not \
+  if (path.sep !== '/') {
+    f = f.split(path.sep).join('/')
+  }
+
+  // treat the test path as a set of pathparts.
+  f = f.split(slashSplit)
+  this.debug(this.pattern, 'split', f)
+
+  // just ONE of the pattern sets in this.set needs to match
+  // in order for it to be valid.  If negating, then just one
+  // match means that we have failed.
+  // Either way, return on the first hit.
+
+  var set = this.set
+  this.debug(this.pattern, 'set', set)
+
+  // Find the basename of the path by looking for the last non-empty segment
+  var filename
+  var i
+  for (i = f.length - 1; i >= 0; i--) {
+    filename = f[i]
+    if (filename) break
+  }
+
+  for (i = 0; i < set.length; i++) {
+    var pattern = set[i]
+    var file = f
+    if (options.matchBase && pattern.length === 1) {
+      file = [filename]
+    }
+    var hit = this.matchOne(file, pattern, partial)
+    if (hit) {
+      if (options.flipNegate) return true
+      return !this.negate
+    }
+  }
+
+  // didn't get any hits.  this is success if it's a negative
+  // pattern, failure otherwise.
+  if (options.flipNegate) return false
+  return this.negate
+}
+
+// set partial to true to test if, for example,
+// "/a/b" matches the start of "/*/b/*/d"
+// Partial means, if you run out of file before you run
+// out of pattern, then that's fine, as long as all
+// the parts match.
+Minimatch.prototype.matchOne = function (file, pattern, partial) {
+  var options = this.options
+
+  this.debug('matchOne',
+    { 'this': this, file: file, pattern: pattern })
+
+  this.debug('matchOne', file.length, pattern.length)
+
+  for (var fi = 0,
+      pi = 0,
+      fl = file.length,
+      pl = pattern.length
+      ; (fi < fl) && (pi < pl)
+      ; fi++, pi++) {
+    this.debug('matchOne loop')
+    var p = pattern[pi]
+    var f = file[fi]
+
+    this.debug(pattern, p, f)
+
+    // should be impossible.
+    // some invalid regexp stuff in the set.
+    if (p === false) return false
+
+    if (p === GLOBSTAR) {
+      this.debug('GLOBSTAR', [pattern, p, f])
+
+      // "**"
+      // a/**/b/**/c would match the following:
+      // a/b/x/y/z/c
+      // a/x/y/z/b/c
+      // a/b/x/b/x/c
+      // a/b/c
+      // To do this, take the rest of the pattern after
+      // the **, and see if it would match the file remainder.
+      // If so, return success.
+      // If not, the ** "swallows" a segment, and try again.
+      // This is recursively awful.
+      //
+      // a/**/b/**/c matching a/b/x/y/z/c
+      // - a matches a
+      // - doublestar
+      //   - matchOne(b/x/y/z/c, b/**/c)
+      //     - b matches b
+      //     - doublestar
+      //       - matchOne(x/y/z/c, c) -> no
+      //       - matchOne(y/z/c, c) -> no
+      //       - matchOne(z/c, c) -> no
+      //       - matchOne(c, c) yes, hit
+      var fr = fi
+      var pr = pi + 1
+      if (pr === pl) {
+        this.debug('** at the end')
+        // a ** at the end will just swallow the rest.
+        // We have found a match.
+        // however, it will not swallow /.x, unless
+        // options.dot is set.
+        // . and .. are *never* matched by **, for explosively
+        // exponential reasons.
+        for (; fi < fl; fi++) {
+          if (file[fi] === '.' || file[fi] === '..' ||
+            (!options.dot && file[fi].charAt(0) === '.')) return false
+        }
+        return true
+      }
+
+      // ok, let's see if we can swallow whatever we can.
+      while (fr < fl) {
+        var swallowee = file[fr]
+
+        this.debug('\nglobstar while', file, fr, pattern, pr, swallowee)
+
+        // XXX remove this slice.  Just pass the start index.
+        if (this.matchOne(file.slice(fr), pattern.slice(pr), partial)) {
+          this.debug('globstar found match!', fr, fl, swallowee)
+          // found a match.
+          return true
+        } else {
+          // can't swallow "." or ".." ever.
+          // can only swallow ".foo" when explicitly asked.
+          if (swallowee === '.' || swallowee === '..' ||
+            (!options.dot && swallowee.charAt(0) === '.')) {
+            this.debug('dot detected!', file, fr, pattern, pr)
+            break
+          }
+
+          // ** swallows a segment, and continue.
+          this.debug('globstar swallow a segment, and continue')
+          fr++
+        }
+      }
+
+      // no match was found.
+      // However, in partial mode, we can't say this is necessarily over.
+      // If there's more *pattern* left, then
+      if (partial) {
+        // ran out of file
+        this.debug('\n>>> no match, partial?', file, fr, pattern, pr)
+        if (fr === fl) return true
+      }
+      return false
+    }
+
+    // something other than **
+    // non-magic patterns just have to match exactly
+    // patterns with magic have been turned into regexps.
+    var hit
+    if (typeof p === 'string') {
+      if (options.nocase) {
+        hit = f.toLowerCase() === p.toLowerCase()
+      } else {
+        hit = f === p
+      }
+      this.debug('string match', p, f, hit)
+    } else {
+      hit = f.match(p)
+      this.debug('pattern match', p, f, hit)
+    }
+
+    if (!hit) return false
+  }
+
+  // Note: ending in / means that we'll get a final ""
+  // at the end of the pattern.  This can only match a
+  // corresponding "" at the end of the file.
+  // If the file ends in /, then it can only match a
+  // a pattern that ends in /, unless the pattern just
+  // doesn't have any more for it. But, a/b/ should *not*
+  // match "a/b/*", even though "" matches against the
+  // [^/]*? pattern, except in partial mode, where it might
+  // simply not be reached yet.
+  // However, a/b/ should still satisfy a/*
+
+  // now either we fell off the end of the pattern, or we're done.
+  if (fi === fl && pi === pl) {
+    // ran out of pattern and filename at the same time.
+    // an exact hit!
+    return true
+  } else if (fi === fl) {
+    // ran out of file, but still had pattern left.
+    // this is ok if we're doing the match as part of
+    // a glob fs traversal.
+    return partial
+  } else if (pi === pl) {
+    // ran out of pattern, still have file left.
+    // this is only acceptable if we're on the very last
+    // empty segment of a file with a trailing slash.
+    // a/* should match a/b/
+    var emptyFileEnd = (fi === fl - 1) && (file[fi] === '')
+    return emptyFileEnd
+  }
+
+  // should be unreachable.
+  throw new Error('wtf?')
+}
+
+// replace stuff like \* with *
+function globUnescape (s) {
+  return s.replace(/\\(.)/g, '$1')
+}
+
+function regExpEscape (s) {
+  return s.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&')
+}
+
+},{"brace-expansion":11,"path":22}],21:[function(require,module,exports){
+var wrappy = require('wrappy')
+module.exports = wrappy(once)
+module.exports.strict = wrappy(onceStrict)
+
+once.proto = once(function () {
+  Object.defineProperty(Function.prototype, 'once', {
+    value: function () {
+      return once(this)
+    },
+    configurable: true
+  })
+
+  Object.defineProperty(Function.prototype, 'onceStrict', {
+    value: function () {
+      return onceStrict(this)
+    },
+    configurable: true
+  })
+})
+
+function once (fn) {
+  var f = function () {
+    if (f.called) return f.value
+    f.called = true
+    return f.value = fn.apply(this, arguments)
+  }
+  f.called = false
+  return f
+}
+
+function onceStrict (fn) {
+  var f = function () {
+    if (f.called)
+      throw new Error(f.onceError)
+    f.called = true
+    return f.value = fn.apply(this, arguments)
+  }
+  var name = fn.name || 'Function wrapped with `once`'
+  f.onceError = name + " shouldn't be called more than once"
+  f.called = false
+  return f
+}
+
+},{"wrappy":29}],22:[function(require,module,exports){
+(function (process){
+// Copyright Joyent, Inc. and other Node contributors.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a
+// copy of this software and associated documentation files (the
+// "Software"), to deal in the Software without restriction, including
+// without limitation the rights to use, copy, modify, merge, publish,
+// distribute, sublicense, and/or sell copies of the Software, and to permit
+// persons to whom the Software is furnished to do so, subject to the
+// following conditions:
+//
+// The above copyright notice and this permission notice shall be included
+// in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+// USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+// resolves . and .. elements in a path array with directory names there
+// must be no slashes, empty elements, or device names (c:\) in the array
+// (so also no leading and trailing slashes - it does not distinguish
+// relative and absolute paths)
+function normalizeArray(parts, allowAboveRoot) {
+  // if the path tries to go above the root, `up` ends up > 0
+  var up = 0;
+  for (var i = parts.length - 1; i >= 0; i--) {
+    var last = parts[i];
+    if (last === '.') {
+      parts.splice(i, 1);
+    } else if (last === '..') {
+      parts.splice(i, 1);
+      up++;
+    } else if (up) {
+      parts.splice(i, 1);
+      up--;
+    }
+  }
+
+  // if the path is allowed to go above the root, restore leading ..s
+  if (allowAboveRoot) {
+    for (; up--; up) {
+      parts.unshift('..');
+    }
+  }
+
+  return parts;
+}
+
+// Split a filename into [root, dir, basename, ext], unix version
+// 'root' is just a slash, or nothing.
+var splitPathRe =
+    /^(\/?|)([\s\S]*?)((?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/;
+var splitPath = function(filename) {
+  return splitPathRe.exec(filename).slice(1);
+};
+
+// path.resolve([from ...], to)
+// posix version
+exports.resolve = function() {
+  var resolvedPath = '',
+      resolvedAbsolute = false;
+
+  for (var i = arguments.length - 1; i >= -1 && !resolvedAbsolute; i--) {
+    var path = (i >= 0) ? arguments[i] : process.cwd();
+
+    // Skip empty and invalid entries
+    if (typeof path !== 'string') {
+      throw new TypeError('Arguments to path.resolve must be strings');
+    } else if (!path) {
+      continue;
+    }
+
+    resolvedPath = path + '/' + resolvedPath;
+    resolvedAbsolute = path.charAt(0) === '/';
+  }
+
+  // At this point the path should be resolved to a full absolute path, but
+  // handle relative paths to be safe (might happen when process.cwd() fails)
+
+  // Normalize the path
+  resolvedPath = normalizeArray(filter(resolvedPath.split('/'), function(p) {
+    return !!p;
+  }), !resolvedAbsolute).join('/');
+
+  return ((resolvedAbsolute ? '/' : '') + resolvedPath) || '.';
+};
+
+// path.normalize(path)
+// posix version
+exports.normalize = function(path) {
+  var isAbsolute = exports.isAbsolute(path),
+      trailingSlash = substr(path, -1) === '/';
+
+  // Normalize the path
+  path = normalizeArray(filter(path.split('/'), function(p) {
+    return !!p;
+  }), !isAbsolute).join('/');
+
+  if (!path && !isAbsolute) {
+    path = '.';
+  }
+  if (path && trailingSlash) {
+    path += '/';
+  }
+
+  return (isAbsolute ? '/' : '') + path;
+};
+
+// posix version
+exports.isAbsolute = function(path) {
+  return path.charAt(0) === '/';
+};
+
+// posix version
+exports.join = function() {
+  var paths = Array.prototype.slice.call(arguments, 0);
+  return exports.normalize(filter(paths, function(p, index) {
+    if (typeof p !== 'string') {
+      throw new TypeError('Arguments to path.join must be strings');
+    }
+    return p;
+  }).join('/'));
+};
+
+
+// path.relative(from, to)
+// posix version
+exports.relative = function(from, to) {
+  from = exports.resolve(from).substr(1);
+  to = exports.resolve(to).substr(1);
+
+  function trim(arr) {
+    var start = 0;
+    for (; start < arr.length; start++) {
+      if (arr[start] !== '') break;
+    }
+
+    var end = arr.length - 1;
+    for (; end >= 0; end--) {
+      if (arr[end] !== '') break;
+    }
+
+    if (start > end) return [];
+    return arr.slice(start, end - start + 1);
+  }
+
+  var fromParts = trim(from.split('/'));
+  var toParts = trim(to.split('/'));
+
+  var length = Math.min(fromParts.length, toParts.length);
+  var samePartsLength = length;
+  for (var i = 0; i < length; i++) {
+    if (fromParts[i] !== toParts[i]) {
+      samePartsLength = i;
+      break;
+    }
+  }
+
+  var outputParts = [];
+  for (var i = samePartsLength; i < fromParts.length; i++) {
+    outputParts.push('..');
+  }
+
+  outputParts = outputParts.concat(toParts.slice(samePartsLength));
+
+  return outputParts.join('/');
+};
+
+exports.sep = '/';
+exports.delimiter = ':';
+
+exports.dirname = function(path) {
+  var result = splitPath(path),
+      root = result[0],
+      dir = result[1];
+
+  if (!root && !dir) {
+    // No dirname whatsoever
+    return '.';
+  }
+
+  if (dir) {
+    // It has a dirname, strip trailing slash
+    dir = dir.substr(0, dir.length - 1);
+  }
+
+  return root + dir;
+};
+
+
+exports.basename = function(path, ext) {
+  var f = splitPath(path)[2];
+  // TODO: make this comparison case-insensitive on windows?
+  if (ext && f.substr(-1 * ext.length) === ext) {
+    f = f.substr(0, f.length - ext.length);
+  }
+  return f;
+};
+
+
+exports.extname = function(path) {
+  return splitPath(path)[3];
+};
+
+function filter (xs, f) {
+    if (xs.filter) return xs.filter(f);
+    var res = [];
+    for (var i = 0; i < xs.length; i++) {
+        if (f(xs[i], i, xs)) res.push(xs[i]);
+    }
+    return res;
+}
+
+// String.prototype.substr - negative index don't work in IE8
+var substr = 'ab'.substr(-1) === 'b'
+    ? function (str, start, len) { return str.substr(start, len) }
+    : function (str, start, len) {
+        if (start < 0) start = str.length + start;
+        return str.substr(start, len);
+    }
+;
+
+}).call(this,require('_process'))
+},{"_process":24}],23:[function(require,module,exports){
+(function (process){
+'use strict';
+
+function posix(path) {
+	return path.charAt(0) === '/';
+}
+
+function win32(path) {
+	// https://github.com/nodejs/node/blob/b3fcc245fb25539909ef1d5eaa01dbf92e168633/lib/path.js#L56
+	var splitDeviceRe = /^([a-zA-Z]:|[\\\/]{2}[^\\\/]+[\\\/]+[^\\\/]+)?([\\\/])?([\s\S]*?)$/;
+	var result = splitDeviceRe.exec(path);
+	var device = result[1] || '';
+	var isUnc = Boolean(device && device.charAt(1) !== ':');
+
+	// UNC paths are always absolute
+	return Boolean(result[2] || isUnc);
+}
+
+module.exports = process.platform === 'win32' ? win32 : posix;
+module.exports.posix = posix;
+module.exports.win32 = win32;
+
+}).call(this,require('_process'))
+},{"_process":24}],24:[function(require,module,exports){
+// shim for using process in browser
+var process = module.exports = {};
+
+// cached from whatever global is present so that test runners that stub it
+// don't break things.  But we need to wrap it in a try catch in case it is
+// wrapped in strict mode code which doesn't define any globals.  It's inside a
+// function because try/catches deoptimize in certain engines.
+
+var cachedSetTimeout;
+var cachedClearTimeout;
+
+function defaultSetTimout() {
+    throw new Error('setTimeout has not been defined');
+}
+function defaultClearTimeout () {
+    throw new Error('clearTimeout has not been defined');
+}
+(function () {
+    try {
+        if (typeof setTimeout === 'function') {
+            cachedSetTimeout = setTimeout;
+        } else {
+            cachedSetTimeout = defaultSetTimout;
+        }
+    } catch (e) {
+        cachedSetTimeout = defaultSetTimout;
+    }
+    try {
+        if (typeof clearTimeout === 'function') {
+            cachedClearTimeout = clearTimeout;
+        } else {
+            cachedClearTimeout = defaultClearTimeout;
+        }
+    } catch (e) {
+        cachedClearTimeout = defaultClearTimeout;
+    }
+} ())
+function runTimeout(fun) {
+    if (cachedSetTimeout === setTimeout) {
+        //normal enviroments in sane situations
+        return setTimeout(fun, 0);
+    }
+    // if setTimeout wasn't available but was latter defined
+    if ((cachedSetTimeout === defaultSetTimout || !cachedSetTimeout) && setTimeout) {
+        cachedSetTimeout = setTimeout;
+        return setTimeout(fun, 0);
+    }
+    try {
+        // when when somebody has screwed with setTimeout but no I.E. maddness
+        return cachedSetTimeout(fun, 0);
+    } catch(e){
+        try {
+            // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally
+            return cachedSetTimeout.call(null, fun, 0);
+        } catch(e){
+            // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error
+            return cachedSetTimeout.call(this, fun, 0);
+        }
+    }
+
+
+}
+function runClearTimeout(marker) {
+    if (cachedClearTimeout === clearTimeout) {
+        //normal enviroments in sane situations
+        return clearTimeout(marker);
+    }
+    // if clearTimeout wasn't available but was latter defined
+    if ((cachedClearTimeout === defaultClearTimeout || !cachedClearTimeout) && clearTimeout) {
+        cachedClearTimeout = clearTimeout;
+        return clearTimeout(marker);
+    }
+    try {
+        // when when somebody has screwed with setTimeout but no I.E. maddness
+        return cachedClearTimeout(marker);
+    } catch (e){
+        try {
+            // When we are in I.E. but the script has been evaled so I.E. doesn't  trust the global object when called normally
+            return cachedClearTimeout.call(null, marker);
+        } catch (e){
+            // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error.
+            // Some versions of I.E. have different rules for clearTimeout vs setTimeout
+            return cachedClearTimeout.call(this, marker);
+        }
+    }
+
+
+
+}
+var queue = [];
+var draining = false;
+var currentQueue;
+var queueIndex = -1;
+
+function cleanUpNextTick() {
+    if (!draining || !currentQueue) {
+        return;
+    }
+    draining = false;
+    if (currentQueue.length) {
+        queue = currentQueue.concat(queue);
+    } else {
+        queueIndex = -1;
+    }
+    if (queue.length) {
+        drainQueue();
+    }
+}
+
+function drainQueue() {
+    if (draining) {
+        return;
+    }
+    var timeout = runTimeout(cleanUpNextTick);
+    draining = true;
+
+    var len = queue.length;
+    while(len) {
+        currentQueue = queue;
+        queue = [];
+        while (++queueIndex < len) {
+            if (currentQueue) {
+                currentQueue[queueIndex].run();
+            }
+        }
+        queueIndex = -1;
+        len = queue.length;
+    }
+    currentQueue = null;
+    draining = false;
+    runClearTimeout(timeout);
+}
+
+process.nextTick = function (fun) {
+    var args = new Array(arguments.length - 1);
+    if (arguments.length > 1) {
+        for (var i = 1; i < arguments.length; i++) {
+            args[i - 1] = arguments[i];
+        }
+    }
+    queue.push(new Item(fun, args));
+    if (queue.length === 1 && !draining) {
+        runTimeout(drainQueue);
+    }
+};
+
+// v8 likes predictible objects
+function Item(fun, array) {
+    this.fun = fun;
+    this.array = array;
+}
+Item.prototype.run = function () {
+    this.fun.apply(null, this.array);
+};
+process.title = 'browser';
+process.browser = true;
+process.env = {};
+process.argv = [];
+process.version = ''; // empty string to avoid regexp issues
+process.versions = {};
+
+function noop() {}
+
+process.on = noop;
+process.addListener = noop;
+process.once = noop;
+process.off = noop;
+process.removeListener = noop;
+process.removeAllListeners = noop;
+process.emit = noop;
+process.prependListener = noop;
+process.prependOnceListener = noop;
+
+process.listeners = function (name) { return [] }
+
+process.binding = function (name) {
+    throw new Error('process.binding is not supported');
+};
+
+process.cwd = function () { return '/' };
+process.chdir = function (dir) {
+    throw new Error('process.chdir is not supported');
+};
+process.umask = function() { return 0; };
+
+},{}],25:[function(require,module,exports){
+//     Underscore.js 1.8.3
+//     http://underscorejs.org
+//     (c) 2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors
+//     Underscore may be freely distributed under the MIT license.
+
+(function() {
+
+  // Baseline setup
+  // --------------
+
+  // Establish the root object, `window` in the browser, or `exports` on the server.
+  var root = this;
+
+  // Save the previous value of the `_` variable.
+  var previousUnderscore = root._;
+
+  // Save bytes in the minified (but not gzipped) version:
+  var ArrayProto = Array.prototype, ObjProto = Object.prototype, FuncProto = Function.prototype;
+
+  // Create quick reference variables for speed access to core prototypes.
+  var
+    push             = ArrayProto.push,
+    slice            = ArrayProto.slice,
+    toString         = ObjProto.toString,
+    hasOwnProperty   = ObjProto.hasOwnProperty;
+
+  // All **ECMAScript 5** native function implementations that we hope to use
+  // are declared here.
+  var
+    nativeIsArray      = Array.isArray,
+    nativeKeys         = Object.keys,
+    nativeBind         = FuncProto.bind,
+    nativeCreate       = Object.create;
+
+  // Naked function reference for surrogate-prototype-swapping.
+  var Ctor = function(){};
+
+  // Create a safe reference to the Underscore object for use below.
+  var _ = function(obj) {
+    if (obj instanceof _) return obj;
+    if (!(this instanceof _)) return new _(obj);
+    this._wrapped = obj;
+  };
+
+  // Export the Underscore object for **Node.js**, with
+  // backwards-compatibility for the old `require()` API. If we're in
+  // the browser, add `_` as a global object.
+  if (typeof exports !== 'undefined') {
+    if (typeof module !== 'undefined' && module.exports) {
+      exports = module.exports = _;
+    }
+    exports._ = _;
+  } else {
+    root._ = _;
+  }
+
+  // Current version.
+  _.VERSION = '1.8.3';
+
+  // Internal function that returns an efficient (for current engines) version
+  // of the passed-in callback, to be repeatedly applied in other Underscore
+  // functions.
+  var optimizeCb = function(func, context, argCount) {
+    if (context === void 0) return func;
+    switch (argCount == null ? 3 : argCount) {
+      case 1: return function(value) {
+        return func.call(context, value);
+      };
+      case 2: return function(value, other) {
+        return func.call(context, value, other);
+      };
+      case 3: return function(value, index, collection) {
+        return func.call(context, value, index, collection);
+      };
+      case 4: return function(accumulator, value, index, collection) {
+        return func.call(context, accumulator, value, index, collection);
+      };
+    }
+    return function() {
+      return func.apply(context, arguments);
+    };
+  };
+
+  // A mostly-internal function to generate callbacks that can be applied
+  // to each element in a collection, returning the desired result — either
+  // identity, an arbitrary callback, a property matcher, or a property accessor.
+  var cb = function(value, context, argCount) {
+    if (value == null) return _.identity;
+    if (_.isFunction(value)) return optimizeCb(value, context, argCount);
+    if (_.isObject(value)) return _.matcher(value);
+    return _.property(value);
+  };
+  _.iteratee = function(value, context) {
+    return cb(value, context, Infinity);
+  };
+
+  // An internal function for creating assigner functions.
+  var createAssigner = function(keysFunc, undefinedOnly) {
+    return function(obj) {
+      var length = arguments.length;
+      if (length < 2 || obj == null) return obj;
+      for (var index = 1; index < length; index++) {
+        var source = arguments[index],
+            keys = keysFunc(source),
+            l = keys.length;
+        for (var i = 0; i < l; i++) {
+          var key = keys[i];
+          if (!undefinedOnly || obj[key] === void 0) obj[key] = source[key];
+        }
+      }
+      return obj;
+    };
+  };
+
+  // An internal function for creating a new object that inherits from another.
+  var baseCreate = function(prototype) {
+    if (!_.isObject(prototype)) return {};
+    if (nativeCreate) return nativeCreate(prototype);
+    Ctor.prototype = prototype;
+    var result = new Ctor;
+    Ctor.prototype = null;
+    return result;
+  };
+
+  var property = function(key) {
+    return function(obj) {
+      return obj == null ? void 0 : obj[key];
+    };
+  };
+
+  // Helper for collection methods to determine whether a collection
+  // should be iterated as an array or as an object
+  // Related: http://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength
+  // Avoids a very nasty iOS 8 JIT bug on ARM-64. #2094
+  var MAX_ARRAY_INDEX = Math.pow(2, 53) - 1;
+  var getLength = property('length');
+  var isArrayLike = function(collection) {
+    var length = getLength(collection);
+    return typeof length == 'number' && length >= 0 && length <= MAX_ARRAY_INDEX;
+  };
+
+  // Collection Functions
+  // --------------------
+
+  // The cornerstone, an `each` implementation, aka `forEach`.
+  // Handles raw objects in addition to array-likes. Treats all
+  // sparse array-likes as if they were dense.
+  _.each = _.forEach = function(obj, iteratee, context) {
+    iteratee = optimizeCb(iteratee, context);
+    var i, length;
+    if (isArrayLike(obj)) {
+      for (i = 0, length = obj.length; i < length; i++) {
+        iteratee(obj[i], i, obj);
+      }
+    } else {
+      var keys = _.keys(obj);
+      for (i = 0, length = keys.length; i < length; i++) {
+        iteratee(obj[keys[i]], keys[i], obj);
+      }
+    }
+    return obj;
+  };
+
+  // Return the results of applying the iteratee to each element.
+  _.map = _.collect = function(obj, iteratee, context) {
+    iteratee = cb(iteratee, context);
+    var keys = !isArrayLike(obj) && _.keys(obj),
+        length = (keys || obj).length,
+        results = Array(length);
+    for (var index = 0; index < length; index++) {
+      var currentKey = keys ? keys[index] : index;
+      results[index] = iteratee(obj[currentKey], currentKey, obj);
+    }
+    return results;
+  };
+
+  // Create a reducing function iterating left or right.
+  function createReduce(dir) {
+    // Optimized iterator function as using arguments.length
+    // in the main function will deoptimize the, see #1991.
+    function iterator(obj, iteratee, memo, keys, index, length) {
+      for (; index >= 0 && index < length; index += dir) {
+        var currentKey = keys ? keys[index] : index;
+        memo = iteratee(memo, obj[currentKey], currentKey, obj);
+      }
+      return memo;
+    }
+
+    return function(obj, iteratee, memo, context) {
+      iteratee = optimizeCb(iteratee, context, 4);
+      var keys = !isArrayLike(obj) && _.keys(obj),
+          length = (keys || obj).length,
+          index = dir > 0 ? 0 : length - 1;
+      // Determine the initial value if none is provided.
+      if (arguments.length < 3) {
+        memo = obj[keys ? keys[index] : index];
+        index += dir;
+      }
+      return iterator(obj, iteratee, memo, keys, index, length);
+    };
+  }
+
+  // **Reduce** builds up a single result from a list of values, aka `inject`,
+  // or `foldl`.
+  _.reduce = _.foldl = _.inject = createReduce(1);
+
+  // The right-associative version of reduce, also known as `foldr`.
+  _.reduceRight = _.foldr = createReduce(-1);
+
+  // Return the first value which passes a truth test. Aliased as `detect`.
+  _.find = _.detect = function(obj, predicate, context) {
+    var key;
+    if (isArrayLike(obj)) {
+      key = _.findIndex(obj, predicate, context);
+    } else {
+      key = _.findKey(obj, predicate, context);
+    }
+    if (key !== void 0 && key !== -1) return obj[key];
+  };
+
+  // Return all the elements that pass a truth test.
+  // Aliased as `select`.
+  _.filter = _.select = function(obj, predicate, context) {
+    var results = [];
+    predicate = cb(predicate, context);
+    _.each(obj, function(value, index, list) {
+      if (predicate(value, index, list)) results.push(value);
+    });
+    return results;
+  };
+
+  // Return all the elements for which a truth test fails.
+  _.reject = function(obj, predicate, context) {
+    return _.filter(obj, _.negate(cb(predicate)), context);
+  };
+
+  // Determine whether all of the elements match a truth test.
+  // Aliased as `all`.
+  _.every = _.all = function(obj, predicate, context) {
+    predicate = cb(predicate, context);
+    var keys = !isArrayLike(obj) && _.keys(obj),
+        length = (keys || obj).length;
+    for (var index = 0; index < length; index++) {
+      var currentKey = keys ? keys[index] : index;
+      if (!predicate(obj[currentKey], currentKey, obj)) return false;
+    }
+    return true;
+  };
+
+  // Determine if at least one element in the object matches a truth test.
+  // Aliased as `any`.
+  _.some = _.any = function(obj, predicate, context) {
+    predicate = cb(predicate, context);
+    var keys = !isArrayLike(obj) && _.keys(obj),
+        length = (keys || obj).length;
+    for (var index = 0; index < length; index++) {
+      var currentKey = keys ? keys[index] : index;
+      if (predicate(obj[currentKey], currentKey, obj)) return true;
+    }
+    return false;
+  };
+
+  // Determine if the array or object contains a given item (using `===`).
+  // Aliased as `includes` and `include`.
+  _.contains = _.includes = _.include = function(obj, item, fromIndex, guard) {
+    if (!isArrayLike(obj)) obj = _.values(obj);
+    if (typeof fromIndex != 'number' || guard) fromIndex = 0;
+    return _.indexOf(obj, item, fromIndex) >= 0;
+  };
+
+  // Invoke a method (with arguments) on every item in a collection.
+  _.invoke = function(obj, method) {
+    var args = slice.call(arguments, 2);
+    var isFunc = _.isFunction(method);
+    return _.map(obj, function(value) {
+      var func = isFunc ? method : value[method];
+      return func == null ? func : func.apply(value, args);
+    });
+  };
+
+  // Convenience version of a common use case of `map`: fetching a property.
+  _.pluck = function(obj, key) {
+    return _.map(obj, _.property(key));
+  };
+
+  // Convenience version of a common use case of `filter`: selecting only objects
+  // containing specific `key:value` pairs.
+  _.where = function(obj, attrs) {
+    return _.filter(obj, _.matcher(attrs));
+  };
+
+  // Convenience version of a common use case of `find`: getting the first object
+  // containing specific `key:value` pairs.
+  _.findWhere = function(obj, attrs) {
+    return _.find(obj, _.matcher(attrs));
+  };
+
+  // Return the maximum element (or element-based computation).
+  _.max = function(obj, iteratee, context) {
+    var result = -Infinity, lastComputed = -Infinity,
+        value, computed;
+    if (iteratee == null && obj != null) {
+      obj = isArrayLike(obj) ? obj : _.values(obj);
+      for (var i = 0, length = obj.length; i < length; i++) {
+        value = obj[i];
+        if (value > result) {
+          result = value;
+        }
+      }
+    } else {
+      iteratee = cb(iteratee, context);
+      _.each(obj, function(value, index, list) {
+        computed = iteratee(value, index, list);
+        if (computed > lastComputed || computed === -Infinity && result === -Infinity) {
+          result = value;
+          lastComputed = computed;
+        }
+      });
+    }
+    return result;
+  };
+
+  // Return the minimum element (or element-based computation).
+  _.min = function(obj, iteratee, context) {
+    var result = Infinity, lastComputed = Infinity,
+        value, computed;
+    if (iteratee == null && obj != null) {
+      obj = isArrayLike(obj) ? obj : _.values(obj);
+      for (var i = 0, length = obj.length; i < length; i++) {
+        value = obj[i];
+        if (value < result) {
+          result = value;
+        }
+      }
+    } else {
+      iteratee = cb(iteratee, context);
+      _.each(obj, function(value, index, list) {
+        computed = iteratee(value, index, list);
+        if (computed < lastComputed || computed === Infinity && result === Infinity) {
+          result = value;
+          lastComputed = computed;
+        }
+      });
+    }
+    return result;
+  };
+
+  // Shuffle a collection, using the modern version of the
+  // [Fisher-Yates shuffle](http://en.wikipedia.org/wiki/Fisher–Yates_shuffle).
+  _.shuffle = function(obj) {
+    var set = isArrayLike(obj) ? obj : _.values(obj);
+    var length = set.length;
+    var shuffled = Array(length);
+    for (var index = 0, rand; index < length; index++) {
+      rand = _.random(0, index);
+      if (rand !== index) shuffled[index] = shuffled[rand];
+      shuffled[rand] = set[index];
+    }
+    return shuffled;
+  };
+
+  // Sample **n** random values from a collection.
+  // If **n** is not specified, returns a single random element.
+  // The internal `guard` argument allows it to work with `map`.
+  _.sample = function(obj, n, guard) {
+    if (n == null || guard) {
+      if (!isArrayLike(obj)) obj = _.values(obj);
+      return obj[_.random(obj.length - 1)];
+    }
+    return _.shuffle(obj).slice(0, Math.max(0, n));
+  };
+
+  // Sort the object's values by a criterion produced by an iteratee.
+  _.sortBy = function(obj, iteratee, context) {
+    iteratee = cb(iteratee, context);
+    return _.pluck(_.map(obj, function(value, index, list) {
+      return {
+        value: value,
+        index: index,
+        criteria: iteratee(value, index, list)
+      };
+    }).sort(function(left, right) {
+      var a = left.criteria;
+      var b = right.criteria;
+      if (a !== b) {
+        if (a > b || a === void 0) return 1;
+        if (a < b || b === void 0) return -1;
+      }
+      return left.index - right.index;
+    }), 'value');
+  };
+
+  // An internal function used for aggregate "group by" operations.
+  var group = function(behavior) {
+    return function(obj, iteratee, context) {
+      var result = {};
+      iteratee = cb(iteratee, context);
+      _.each(obj, function(value, index) {
+        var key = iteratee(value, index, obj);
+        behavior(result, value, key);
+      });
+      return result;
+    };
+  };
+
+  // Groups the object's values by a criterion. Pass either a string attribute
+  // to group by, or a function that returns the criterion.
+  _.groupBy = group(function(result, value, key) {
+    if (_.has(result, key)) result[key].push(value); else result[key] = [value];
+  });
+
+  // Indexes the object's values by a criterion, similar to `groupBy`, but for
+  // when you know that your index values will be unique.
+  _.indexBy = group(function(result, value, key) {
+    result[key] = value;
+  });
+
+  // Counts instances of an object that group by a certain criterion. Pass
+  // either a string attribute to count by, or a function that returns the
+  // criterion.
+  _.countBy = group(function(result, value, key) {
+    if (_.has(result, key)) result[key]++; else result[key] = 1;
+  });
+
+  // Safely create a real, live array from anything iterable.
+  _.toArray = function(obj) {
+    if (!obj) return [];
+    if (_.isArray(obj)) return slice.call(obj);
+    if (isArrayLike(obj)) return _.map(obj, _.identity);
+    return _.values(obj);
+  };
+
+  // Return the number of elements in an object.
+  _.size = function(obj) {
+    if (obj == null) return 0;
+    return isArrayLike(obj) ? obj.length : _.keys(obj).length;
+  };
+
+  // Split a collection into two arrays: one whose elements all satisfy the given
+  // predicate, and one whose elements all do not satisfy the predicate.
+  _.partition = function(obj, predicate, context) {
+    predicate = cb(predicate, context);
+    var pass = [], fail = [];
+    _.each(obj, function(value, key, obj) {
+      (predicate(value, key, obj) ? pass : fail).push(value);
+    });
+    return [pass, fail];
+  };
+
+  // Array Functions
+  // ---------------
+
+  // Get the first element of an array. Passing **n** will return the first N
+  // values in the array. Aliased as `head` and `take`. The **guard** check
+  // allows it to work with `_.map`.
+  _.first = _.head = _.take = function(array, n, guard) {
+    if (array == null) return void 0;
+    if (n == null || guard) return array[0];
+    return _.initial(array, array.length - n);
+  };
+
+  // Returns everything but the last entry of the array. Especially useful on
+  // the arguments object. Passing **n** will return all the values in
+  // the array, excluding the last N.
+  _.initial = function(array, n, guard) {
+    return slice.call(array, 0, Math.max(0, array.length - (n == null || guard ? 1 : n)));
+  };
+
+  // Get the last element of an array. Passing **n** will return the last N
+  // values in the array.
+  _.last = function(array, n, guard) {
+    if (array == null) return void 0;
+    if (n == null || guard) return array[array.length - 1];
+    return _.rest(array, Math.max(0, array.length - n));
+  };
+
+  // Returns everything but the first entry of the array. Aliased as `tail` and `drop`.
+  // Especially useful on the arguments object. Passing an **n** will return
+  // the rest N values in the array.
+  _.rest = _.tail = _.drop = function(array, n, guard) {
+    return slice.call(array, n == null || guard ? 1 : n);
+  };
+
+  // Trim out all falsy values from an array.
+  _.compact = function(array) {
+    return _.filter(array, _.identity);
+  };
+
+  // Internal implementation of a recursive `flatten` function.
+  var flatten = function(input, shallow, strict, startIndex) {
+    var output = [], idx = 0;
+    for (var i = startIndex || 0, length = getLength(input); i < length; i++) {
+      var value = input[i];
+      if (isArrayLike(value) && (_.isArray(value) || _.isArguments(value))) {
+        //flatten current level of array or arguments object
+        if (!shallow) value = flatten(value, shallow, strict);
+        var j = 0, len = value.length;
+        output.length += len;
+        while (j < len) {
+          output[idx++] = value[j++];
+        }
+      } else if (!strict) {
+        output[idx++] = value;
+      }
+    }
+    return output;
+  };
+
+  // Flatten out an array, either recursively (by default), or just one level.
+  _.flatten = function(array, shallow) {
+    return flatten(array, shallow, false);
+  };
+
+  // Return a version of the array that does not contain the specified value(s).
+  _.without = function(array) {
+    return _.difference(array, slice.call(arguments, 1));
+  };
+
+  // Produce a duplicate-free version of the array. If the array has already
+  // been sorted, you have the option of using a faster algorithm.
+  // Aliased as `unique`.
+  _.uniq = _.unique = function(array, isSorted, iteratee, context) {
+    if (!_.isBoolean(isSorted)) {
+      context = iteratee;
+      iteratee = isSorted;
+      isSorted = false;
+    }
+    if (iteratee != null) iteratee = cb(iteratee, context);
+    var result = [];
+    var seen = [];
+    for (var i = 0, length = getLength(array); i < length; i++) {
+      var value = array[i],
+          computed = iteratee ? iteratee(value, i, array) : value;
+      if (isSorted) {
+        if (!i || seen !== computed) result.push(value);
+        seen = computed;
+      } else if (iteratee) {
+        if (!_.contains(seen, computed)) {
+          seen.push(computed);
+          result.push(value);
+        }
+      } else if (!_.contains(result, value)) {
+        result.push(value);
+      }
+    }
+    return result;
+  };
+
+  // Produce an array that contains the union: each distinct element from all of
+  // the passed-in arrays.
+  _.union = function() {
+    return _.uniq(flatten(arguments, true, true));
+  };
+
+  // Produce an array that contains every item shared between all the
+  // passed-in arrays.
+  _.intersection = function(array) {
+    var result = [];
+    var argsLength = arguments.length;
+    for (var i = 0, length = getLength(array); i < length; i++) {
+      var item = array[i];
+      if (_.contains(result, item)) continue;
+      for (var j = 1; j < argsLength; j++) {
+        if (!_.contains(arguments[j], item)) break;
+      }
+      if (j === argsLength) result.push(item);
+    }
+    return result;
+  };
+
+  // Take the difference between one array and a number of other arrays.
+  // Only the elements present in just the first array will remain.
+  _.difference = function(array) {
+    var rest = flatten(arguments, true, true, 1);
+    return _.filter(array, function(value){
+      return !_.contains(rest, value);
+    });
+  };
+
+  // Zip together multiple lists into a single array -- elements that share
+  // an index go together.
+  _.zip = function() {
+    return _.unzip(arguments);
+  };
+
+  // Complement of _.zip. Unzip accepts an array of arrays and groups
+  // each array's elements on shared indices
+  _.unzip = function(array) {
+    var length = array && _.max(array, getLength).length || 0;
+    var result = Array(length);
+
+    for (var index = 0; index < length; index++) {
+      result[index] = _.pluck(array, index);
+    }
+    return result;
+  };
+
+  // Converts lists into objects. Pass either a single array of `[key, value]`
+  // pairs, or two parallel arrays of the same length -- one of keys, and one of
+  // the corresponding values.
+  _.object = function(list, values) {
+    var result = {};
+    for (var i = 0, length = getLength(list); i < length; i++) {
+      if (values) {
+        result[list[i]] = values[i];
+      } else {
+        result[list[i][0]] = list[i][1];
+      }
+    }
+    return result;
+  };
+
+  // Generator function to create the findIndex and findLastIndex functions
+  function createPredicateIndexFinder(dir) {
+    return function(array, predicate, context) {
+      predicate = cb(predicate, context);
+      var length = getLength(array);
+      var index = dir > 0 ? 0 : length - 1;
+      for (; index >= 0 && index < length; index += dir) {
+        if (predicate(array[index], index, array)) return index;
+      }
+      return -1;
+    };
+  }
+
+  // Returns the first index on an array-like that passes a predicate test
+  _.findIndex = createPredicateIndexFinder(1);
+  _.findLastIndex = createPredicateIndexFinder(-1);
+
+  // Use a comparator function to figure out the smallest index at which
+  // an object should be inserted so as to maintain order. Uses binary search.
+  _.sortedIndex = function(array, obj, iteratee, context) {
+    iteratee = cb(iteratee, context, 1);
+    var value = iteratee(obj);
+    var low = 0, high = getLength(array);
+    while (low < high) {
+      var mid = Math.floor((low + high) / 2);
+      if (iteratee(array[mid]) < value) low = mid + 1; else high = mid;
+    }
+    return low;
+  };
+
+  // Generator function to create the indexOf and lastIndexOf functions
+  function createIndexFinder(dir, predicateFind, sortedIndex) {
+    return function(array, item, idx) {
+      var i = 0, length = getLength(array);
+      if (typeof idx == 'number') {
+        if (dir > 0) {
+            i = idx >= 0 ? idx : Math.max(idx + length, i);
+        } else {
+            length = idx >= 0 ? Math.min(idx + 1, length) : idx + length + 1;
+        }
+      } else if (sortedIndex && idx && length) {
+        idx = sortedIndex(array, item);
+        return array[idx] === item ? idx : -1;
+      }
+      if (item !== item) {
+        idx = predicateFind(slice.call(array, i, length), _.isNaN);
+        return idx >= 0 ? idx + i : -1;
+      }
+      for (idx = dir > 0 ? i : length - 1; idx >= 0 && idx < length; idx += dir) {
+        if (array[idx] === item) return idx;
+      }
+      return -1;
+    };
+  }
+
+  // Return the position of the first occurrence of an item in an array,
+  // or -1 if the item is not included in the array.
+  // If the array is large and already in sort order, pass `true`
+  // for **isSorted** to use binary search.
+  _.indexOf = createIndexFinder(1, _.findIndex, _.sortedIndex);
+  _.lastIndexOf = createIndexFinder(-1, _.findLastIndex);
+
+  // Generate an integer Array containing an arithmetic progression. A port of
+  // the native Python `range()` function. See
+  // [the Python documentation](http://docs.python.org/library/functions.html#range).
+  _.range = function(start, stop, step) {
+    if (stop == null) {
+      stop = start || 0;
+      start = 0;
+    }
+    step = step || 1;
+
+    var length = Math.max(Math.ceil((stop - start) / step), 0);
+    var range = Array(length);
+
+    for (var idx = 0; idx < length; idx++, start += step) {
+      range[idx] = start;
+    }
+
+    return range;
+  };
+
+  // Function (ahem) Functions
+  // ------------------
+
+  // Determines whether to execute a function as a constructor
+  // or a normal function with the provided arguments
+  var executeBound = function(sourceFunc, boundFunc, context, callingContext, args) {
+    if (!(callingContext instanceof boundFunc)) return sourceFunc.apply(context, args);
+    var self = baseCreate(sourceFunc.prototype);
+    var result = sourceFunc.apply(self, args);
+    if (_.isObject(result)) return result;
+    return self;
+  };
+
+  // Create a function bound to a given object (assigning `this`, and arguments,
+  // optionally). Delegates to **ECMAScript 5**'s native `Function.bind` if
+  // available.
+  _.bind = function(func, context) {
+    if (nativeBind && func.bind === nativeBind) return nativeBind.apply(func, slice.call(arguments, 1));
+    if (!_.isFunction(func)) throw new TypeError('Bind must be called on a function');
+    var args = slice.call(arguments, 2);
+    var bound = function() {
+      return executeBound(func, bound, context, this, args.concat(slice.call(arguments)));
+    };
+    return bound;
+  };
+
+  // Partially apply a function by creating a version that has had some of its
+  // arguments pre-filled, without changing its dynamic `this` context. _ acts
+  // as a placeholder, allowing any combination of arguments to be pre-filled.
+  _.partial = function(func) {
+    var boundArgs = slice.call(arguments, 1);
+    var bound = function() {
+      var position = 0, length = boundArgs.length;
+      var args = Array(length);
+      for (var i = 0; i < length; i++) {
+        args[i] = boundArgs[i] === _ ? arguments[position++] : boundArgs[i];
+      }
+      while (position < arguments.length) args.push(arguments[position++]);
+      return executeBound(func, bound, this, this, args);
+    };
+    return bound;
+  };
+
+  // Bind a number of an object's methods to that object. Remaining arguments
+  // are the method names to be bound. Useful for ensuring that all callbacks
+  // defined on an object belong to it.
+  _.bindAll = function(obj) {
+    var i, length = arguments.length, key;
+    if (length <= 1) throw new Error('bindAll must be passed function names');
+    for (i = 1; i < length; i++) {
+      key = arguments[i];
+      obj[key] = _.bind(obj[key], obj);
+    }
+    return obj;
+  };
+
+  // Memoize an expensive function by storing its results.
+  _.memoize = function(func, hasher) {
+    var memoize = function(key) {
+      var cache = memoize.cache;
+      var address = '' + (hasher ? hasher.apply(this, arguments) : key);
+      if (!_.has(cache, address)) cache[address] = func.apply(this, arguments);
+      return cache[address];
+    };
+    memoize.cache = {};
+    return memoize;
+  };
+
+  // Delays a function for the given number of milliseconds, and then calls
+  // it with the arguments supplied.
+  _.delay = function(func, wait) {
+    var args = slice.call(arguments, 2);
+    return setTimeout(function(){
+      return func.apply(null, args);
+    }, wait);
+  };
+
+  // Defers a function, scheduling it to run after the current call stack has
+  // cleared.
+  _.defer = _.partial(_.delay, _, 1);
+
+  // Returns a function, that, when invoked, will only be triggered at most once
+  // during a given window of time. Normally, the throttled function will run
+  // as much as it can, without ever going more than once per `wait` duration;
+  // but if you'd like to disable the execution on the leading edge, pass
+  // `{leading: false}`. To disable execution on the trailing edge, ditto.
+  _.throttle = function(func, wait, options) {
+    var context, args, result;
+    var timeout = null;
+    var previous = 0;
+    if (!options) options = {};
+    var later = function() {
+      previous = options.leading === false ? 0 : _.now();
+      timeout = null;
+      result = func.apply(context, args);
+      if (!timeout) context = args = null;
+    };
+    return function() {
+      var now = _.now();
+      if (!previous && options.leading === false) previous = now;
+      var remaining = wait - (now - previous);
+      context = this;
+      args = arguments;
+      if (remaining <= 0 || remaining > wait) {
+        if (timeout) {
+          clearTimeout(timeout);
+          timeout = null;
+        }
+        previous = now;
+        result = func.apply(context, args);
+        if (!timeout) context = args = null;
+      } else if (!timeout && options.trailing !== false) {
+        timeout = setTimeout(later, remaining);
+      }
+      return result;
+    };
+  };
+
+  // Returns a function, that, as long as it continues to be invoked, will not
+  // be triggered. The function will be called after it stops being called for
+  // N milliseconds. If `immediate` is passed, trigger the function on the
+  // leading edge, instead of the trailing.
+  _.debounce = function(func, wait, immediate) {
+    var timeout, args, context, timestamp, result;
+
+    var later = function() {
+      var last = _.now() - timestamp;
+
+      if (last < wait && last >= 0) {
+        timeout = setTimeout(later, wait - last);
+      } else {
+        timeout = null;
+        if (!immediate) {
+          result = func.apply(context, args);
+          if (!timeout) context = args = null;
+        }
+      }
+    };
+
+    return function() {
+      context = this;
+      args = arguments;
+      timestamp = _.now();
+      var callNow = immediate && !timeout;
+      if (!timeout) timeout = setTimeout(later, wait);
+      if (callNow) {
+        result = func.apply(context, args);
+        context = args = null;
+      }
+
+      return result;
+    };
+  };
+
+  // Returns the first function passed as an argument to the second,
+  // allowing you to adjust arguments, run code before and after, and
+  // conditionally execute the original function.
+  _.wrap = function(func, wrapper) {
+    return _.partial(wrapper, func);
+  };
+
+  // Returns a negated version of the passed-in predicate.
+  _.negate = function(predicate) {
+    return function() {
+      return !predicate.apply(this, arguments);
+    };
+  };
+
+  // Returns a function that is the composition of a list of functions, each
+  // consuming the return value of the function that follows.
+  _.compose = function() {
+    var args = arguments;
+    var start = args.length - 1;
+    return function() {
+      var i = start;
+      var result = args[start].apply(this, arguments);
+      while (i--) result = args[i].call(this, result);
+      return result;
+    };
+  };
+
+  // Returns a function that will only be executed on and after the Nth call.
+  _.after = function(times, func) {
+    return function() {
+      if (--times < 1) {
+        return func.apply(this, arguments);
+      }
+    };
+  };
+
+  // Returns a function that will only be executed up to (but not including) the Nth call.
+  _.before = function(times, func) {
+    var memo;
+    return function() {
+      if (--times > 0) {
+        memo = func.apply(this, arguments);
+      }
+      if (times <= 1) func = null;
+      return memo;
+    };
+  };
+
+  // Returns a function that will be executed at most one time, no matter how
+  // often you call it. Useful for lazy initialization.
+  _.once = _.partial(_.before, 2);
+
+  // Object Functions
+  // ----------------
+
+  // Keys in IE < 9 that won't be iterated by `for key in ...` and thus missed.
+  var hasEnumBug = !{toString: null}.propertyIsEnumerable('toString');
+  var nonEnumerableProps = ['valueOf', 'isPrototypeOf', 'toString',
+                      'propertyIsEnumerable', 'hasOwnProperty', 'toLocaleString'];
+
+  function collectNonEnumProps(obj, keys) {
+    var nonEnumIdx = nonEnumerableProps.length;
+    var constructor = obj.constructor;
+    var proto = (_.isFunction(constructor) && constructor.prototype) || ObjProto;
+
+    // Constructor is a special case.
+    var prop = 'constructor';
+    if (_.has(obj, prop) && !_.contains(keys, prop)) keys.push(prop);
+
+    while (nonEnumIdx--) {
+      prop = nonEnumerableProps[nonEnumIdx];
+      if (prop in obj && obj[prop] !== proto[prop] && !_.contains(keys, prop)) {
+        keys.push(prop);
+      }
+    }
+  }
+
+  // Retrieve the names of an object's own properties.
+  // Delegates to **ECMAScript 5**'s native `Object.keys`
+  _.keys = function(obj) {
+    if (!_.isObject(obj)) return [];
+    if (nativeKeys) return nativeKeys(obj);
+    var keys = [];
+    for (var key in obj) if (_.has(obj, key)) keys.push(key);
+    // Ahem, IE < 9.
+    if (hasEnumBug) collectNonEnumProps(obj, keys);
+    return keys;
+  };
+
+  // Retrieve all the property names of an object.
+  _.allKeys = function(obj) {
+    if (!_.isObject(obj)) return [];
+    var keys = [];
+    for (var key in obj) keys.push(key);
+    // Ahem, IE < 9.
+    if (hasEnumBug) collectNonEnumProps(obj, keys);
+    return keys;
+  };
+
+  // Retrieve the values of an object's properties.
+  _.values = function(obj) {
+    var keys = _.keys(obj);
+    var length = keys.length;
+    var values = Array(length);
+    for (var i = 0; i < length; i++) {
+      values[i] = obj[keys[i]];
+    }
+    return values;
+  };
+
+  // Returns the results of applying the iteratee to each element of the object
+  // In contrast to _.map it returns an object
+  _.mapObject = function(obj, iteratee, context) {
+    iteratee = cb(iteratee, context);
+    var keys =  _.keys(obj),
+          length = keys.length,
+          results = {},
+          currentKey;
+      for (var index = 0; index < length; index++) {
+        currentKey = keys[index];
+        results[currentKey] = iteratee(obj[currentKey], currentKey, obj);
+      }
+      return results;
+  };
+
+  // Convert an object into a list of `[key, value]` pairs.
+  _.pairs = function(obj) {
+    var keys = _.keys(obj);
+    var length = keys.length;
+    var pairs = Array(length);
+    for (var i = 0; i < length; i++) {
+      pairs[i] = [keys[i], obj[keys[i]]];
+    }
+    return pairs;
+  };
+
+  // Invert the keys and values of an object. The values must be serializable.
+  _.invert = function(obj) {
+    var result = {};
+    var keys = _.keys(obj);
+    for (var i = 0, length = keys.length; i < length; i++) {
+      result[obj[keys[i]]] = keys[i];
+    }
+    return result;
+  };
+
+  // Return a sorted list of the function names available on the object.
+  // Aliased as `methods`
+  _.functions = _.methods = function(obj) {
+    var names = [];
+    for (var key in obj) {
+      if (_.isFunction(obj[key])) names.push(key);
+    }
+    return names.sort();
+  };
+
+  // Extend a given object with all the properties in passed-in object(s).
+  _.extend = createAssigner(_.allKeys);
+
+  // Assigns a given object with all the own properties in the passed-in object(s)
+  // (https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/assign)
+  _.extendOwn = _.assign = createAssigner(_.keys);
+
+  // Returns the first key on an object that passes a predicate test
+  _.findKey = function(obj, predicate, context) {
+    predicate = cb(predicate, context);
+    var keys = _.keys(obj), key;
+    for (var i = 0, length = keys.length; i < length; i++) {
+      key = keys[i];
+      if (predicate(obj[key], key, obj)) return key;
+    }
+  };
+
+  // Return a copy of the object only containing the whitelisted properties.
+  _.pick = function(object, oiteratee, context) {
+    var result = {}, obj = object, iteratee, keys;
+    if (obj == null) return result;
+    if (_.isFunction(oiteratee)) {
+      keys = _.allKeys(obj);
+      iteratee = optimizeCb(oiteratee, context);
+    } else {
+      keys = flatten(arguments, false, false, 1);
+      iteratee = function(value, key, obj) { return key in obj; };
+      obj = Object(obj);
+    }
+    for (var i = 0, length = keys.length; i < length; i++) {
+      var key = keys[i];
+      var value = obj[key];
+      if (iteratee(value, key, obj)) result[key] = value;
+    }
+    return result;
+  };
+
+   // Return a copy of the object without the blacklisted properties.
+  _.omit = function(obj, iteratee, context) {
+    if (_.isFunction(iteratee)) {
+      iteratee = _.negate(iteratee);
+    } else {
+      var keys = _.map(flatten(arguments, false, false, 1), String);
+      iteratee = function(value, key) {
+        return !_.contains(keys, key);
+      };
+    }
+    return _.pick(obj, iteratee, context);
+  };
+
+  // Fill in a given object with default properties.
+  _.defaults = createAssigner(_.allKeys, true);
+
+  // Creates an object that inherits from the given prototype object.
+  // If additional properties are provided then they will be added to the
+  // created object.
+  _.create = function(prototype, props) {
+    var result = baseCreate(prototype);
+    if (props) _.extendOwn(result, props);
+    return result;
+  };
+
+  // Create a (shallow-cloned) duplicate of an object.
+  _.clone = function(obj) {
+    if (!_.isObject(obj)) return obj;
+    return _.isArray(obj) ? obj.slice() : _.extend({}, obj);
+  };
+
+  // Invokes interceptor with the obj, and then returns obj.
+  // The primary purpose of this method is to "tap into" a method chain, in
+  // order to perform operations on intermediate results within the chain.
+  _.tap = function(obj, interceptor) {
+    interceptor(obj);
+    return obj;
+  };
+
+  // Returns whether an object has a given set of `key:value` pairs.
+  _.isMatch = function(object, attrs) {
+    var keys = _.keys(attrs), length = keys.length;
+    if (object == null) return !length;
+    var obj = Object(object);
+    for (var i = 0; i < length; i++) {
+      var key = keys[i];
+      if (attrs[key] !== obj[key] || !(key in obj)) return false;
+    }
+    return true;
+  };
+
+
+  // Internal recursive comparison function for `isEqual`.
+  var eq = function(a, b, aStack, bStack) {
+    // Identical objects are equal. `0 === -0`, but they aren't identical.
+    // See the [Harmony `egal` proposal](http://wiki.ecmascript.org/doku.php?id=harmony:egal).
+    if (a === b) return a !== 0 || 1 / a === 1 / b;
+    // A strict comparison is necessary because `null == undefined`.
+    if (a == null || b == null) return a === b;
+    // Unwrap any wrapped objects.
+    if (a instanceof _) a = a._wrapped;
+    if (b instanceof _) b = b._wrapped;
+    // Compare `[[Class]]` names.
+    var className = toString.call(a);
+    if (className !== toString.call(b)) return false;
+    switch (className) {
+      // Strings, numbers, regular expressions, dates, and booleans are compared by value.
+      case '[object RegExp]':
+      // RegExps are coerced to strings for comparison (Note: '' + /a/i === '/a/i')
+      case '[object String]':
+        // Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is
+        // equivalent to `new String("5")`.
+        return '' + a === '' + b;
+      case '[object Number]':
+        // `NaN`s are equivalent, but non-reflexive.
+        // Object(NaN) is equivalent to NaN
+        if (+a !== +a) return +b !== +b;
+        // An `egal` comparison is performed for other numeric values.
+        return +a === 0 ? 1 / +a === 1 / b : +a === +b;
+      case '[object Date]':
+      case '[object Boolean]':
+        // Coerce dates and booleans to numeric primitive values. Dates are compared by their
+        // millisecond representations. Note that invalid dates with millisecond representations
+        // of `NaN` are not equivalent.
+        return +a === +b;
+    }
+
+    var areArrays = className === '[object Array]';
+    if (!areArrays) {
+      if (typeof a != 'object' || typeof b != 'object') return false;
+
+      // Objects with different constructors are not equivalent, but `Object`s or `Array`s
+      // from different frames are.
+      var aCtor = a.constructor, bCtor = b.constructor;
+      if (aCtor !== bCtor && !(_.isFunction(aCtor) && aCtor instanceof aCtor &&
+                               _.isFunction(bCtor) && bCtor instanceof bCtor)
+                          && ('constructor' in a && 'constructor' in b)) {
+        return false;
+      }
+    }
+    // Assume equality for cyclic structures. The algorithm for detecting cyclic
+    // structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`.
+
+    // Initializing stack of traversed objects.
+    // It's done here since we only need them for objects and arrays comparison.
+    aStack = aStack || [];
+    bStack = bStack || [];
+    var length = aStack.length;
+    while (length--) {
+      // Linear search. Performance is inversely proportional to the number of
+      // unique nested structures.
+      if (aStack[length] === a) return bStack[length] === b;
+    }
+
+    // Add the first object to the stack of traversed objects.
+    aStack.push(a);
+    bStack.push(b);
+
+    // Recursively compare objects and arrays.
+    if (areArrays) {
+      // Compare array lengths to determine if a deep comparison is necessary.
+      length = a.length;
+      if (length !== b.length) return false;
+      // Deep compare the contents, ignoring non-numeric properties.
+      while (length--) {
+        if (!eq(a[length], b[length], aStack, bStack)) return false;
+      }
+    } else {
+      // Deep compare objects.
+      var keys = _.keys(a), key;
+      length = keys.length;
+      // Ensure that both objects contain the same number of properties before comparing deep equality.
+      if (_.keys(b).length !== length) return false;
+      while (length--) {
+        // Deep compare each member
+        key = keys[length];
+        if (!(_.has(b, key) && eq(a[key], b[key], aStack, bStack))) return false;
+      }
+    }
+    // Remove the first object from the stack of traversed objects.
+    aStack.pop();
+    bStack.pop();
+    return true;
+  };
+
+  // Perform a deep comparison to check if two objects are equal.
+  _.isEqual = function(a, b) {
+    return eq(a, b);
+  };
+
+  // Is a given array, string, or object empty?
+  // An "empty" object has no enumerable own-properties.
+  _.isEmpty = function(obj) {
+    if (obj == null) return true;
+    if (isArrayLike(obj) && (_.isArray(obj) || _.isString(obj) || _.isArguments(obj))) return obj.length === 0;
+    return _.keys(obj).length === 0;
+  };
+
+  // Is a given value a DOM element?
+  _.isElement = function(obj) {
+    return !!(obj && obj.nodeType === 1);
+  };
+
+  // Is a given value an array?
+  // Delegates to ECMA5's native Array.isArray
+  _.isArray = nativeIsArray || function(obj) {
+    return toString.call(obj) === '[object Array]';
+  };
+
+  // Is a given variable an object?
+  _.isObject = function(obj) {
+    var type = typeof obj;
+    return type === 'function' || type === 'object' && !!obj;
+  };
+
+  // Add some isType methods: isArguments, isFunction, isString, isNumber, isDate, isRegExp, isError.
+  _.each(['Arguments', 'Function', 'String', 'Number', 'Date', 'RegExp', 'Error'], function(name) {
+    _['is' + name] = function(obj) {
+      return toString.call(obj) === '[object ' + name + ']';
+    };
+  });
+
+  // Define a fallback version of the method in browsers (ahem, IE < 9), where
+  // there isn't any inspectable "Arguments" type.
+  if (!_.isArguments(arguments)) {
+    _.isArguments = function(obj) {
+      return _.has(obj, 'callee');
+    };
+  }
+
+  // Optimize `isFunction` if appropriate. Work around some typeof bugs in old v8,
+  // IE 11 (#1621), and in Safari 8 (#1929).
+  if (typeof /./ != 'function' && typeof Int8Array != 'object') {
+    _.isFunction = function(obj) {
+      return typeof obj == 'function' || false;
+    };
+  }
+
+  // Is a given object a finite number?
+  _.isFinite = function(obj) {
+    return isFinite(obj) && !isNaN(parseFloat(obj));
+  };
+
+  // Is the given value `NaN`? (NaN is the only number which does not equal itself).
+  _.isNaN = function(obj) {
+    return _.isNumber(obj) && obj !== +obj;
+  };
+
+  // Is a given value a boolean?
+  _.isBoolean = function(obj) {
+    return obj === true || obj === false || toString.call(obj) === '[object Boolean]';
+  };
+
+  // Is a given value equal to null?
+  _.isNull = function(obj) {
+    return obj === null;
+  };
+
+  // Is a given variable undefined?
+  _.isUndefined = function(obj) {
+    return obj === void 0;
+  };
+
+  // Shortcut function for checking if an object has a given property directly
+  // on itself (in other words, not on a prototype).
+  _.has = function(obj, key) {
+    return obj != null && hasOwnProperty.call(obj, key);
+  };
+
+  // Utility Functions
+  // -----------------
+
+  // Run Underscore.js in *noConflict* mode, returning the `_` variable to its
+  // previous owner. Returns a reference to the Underscore object.
+  _.noConflict = function() {
+    root._ = previousUnderscore;
+    return this;
+  };
+
+  // Keep the identity function around for default iteratees.
+  _.identity = function(value) {
+    return value;
+  };
+
+  // Predicate-generating functions. Often useful outside of Underscore.
+  _.constant = function(value) {
+    return function() {
+      return value;
+    };
+  };
+
+  _.noop = function(){};
+
+  _.property = property;
+
+  // Generates a function for a given object that returns a given property.
+  _.propertyOf = function(obj) {
+    return obj == null ? function(){} : function(key) {
+      return obj[key];
+    };
+  };
+
+  // Returns a predicate for checking whether an object has a given set of
+  // `key:value` pairs.
+  _.matcher = _.matches = function(attrs) {
+    attrs = _.extendOwn({}, attrs);
+    return function(obj) {
+      return _.isMatch(obj, attrs);
+    };
+  };
+
+  // Run a function **n** times.
+  _.times = function(n, iteratee, context) {
+    var accum = Array(Math.max(0, n));
+    iteratee = optimizeCb(iteratee, context, 1);
+    for (var i = 0; i < n; i++) accum[i] = iteratee(i);
+    return accum;
+  };
+
+  // Return a random integer between min and max (inclusive).
+  _.random = function(min, max) {
+    if (max == null) {
+      max = min;
+      min = 0;
+    }
+    return min + Math.floor(Math.random() * (max - min + 1));
+  };
+
+  // A (possibly faster) way to get the current timestamp as an integer.
+  _.now = Date.now || function() {
+    return new Date().getTime();
+  };
+
+   // List of HTML entities for escaping.
+  var escapeMap = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#x27;',
+    '`': '&#x60;'
+  };
+  var unescapeMap = _.invert(escapeMap);
+
+  // Functions for escaping and unescaping strings to/from HTML interpolation.
+  var createEscaper = function(map) {
+    var escaper = function(match) {
+      return map[match];
+    };
+    // Regexes for identifying a key that needs to be escaped
+    var source = '(?:' + _.keys(map).join('|') + ')';
+    var testRegexp = RegExp(source);
+    var replaceRegexp = RegExp(source, 'g');
+    return function(string) {
+      string = string == null ? '' : '' + string;
+      return testRegexp.test(string) ? string.replace(replaceRegexp, escaper) : string;
+    };
+  };
+  _.escape = createEscaper(escapeMap);
+  _.unescape = createEscaper(unescapeMap);
+
+  // If the value of the named `property` is a function then invoke it with the
+  // `object` as context; otherwise, return it.
+  _.result = function(object, property, fallback) {
+    var value = object == null ? void 0 : object[property];
+    if (value === void 0) {
+      value = fallback;
+    }
+    return _.isFunction(value) ? value.call(object) : value;
+  };
+
+  // Generate a unique integer id (unique within the entire client session).
+  // Useful for temporary DOM ids.
+  var idCounter = 0;
+  _.uniqueId = function(prefix) {
+    var id = ++idCounter + '';
+    return prefix ? prefix + id : id;
+  };
+
+  // By default, Underscore uses ERB-style template delimiters, change the
+  // following template settings to use alternative delimiters.
+  _.templateSettings = {
+    evaluate    : /<%([\s\S]+?)%>/g,
+    interpolate : /<%=([\s\S]+?)%>/g,
+    escape      : /<%-([\s\S]+?)%>/g
+  };
+
+  // When customizing `templateSettings`, if you don't want to define an
+  // interpolation, evaluation or escaping regex, we need one that is
+  // guaranteed not to match.
+  var noMatch = /(.)^/;
+
+  // Certain characters need to be escaped so that they can be put into a
+  // string literal.
+  var escapes = {
+    "'":      "'",
+    '\\':     '\\',
+    '\r':     'r',
+    '\n':     'n',
+    '\u2028': 'u2028',
+    '\u2029': 'u2029'
+  };
+
+  var escaper = /\\|'|\r|\n|\u2028|\u2029/g;
+
+  var escapeChar = function(match) {
+    return '\\' + escapes[match];
+  };
+
+  // JavaScript micro-templating, similar to John Resig's implementation.
+  // Underscore templating handles arbitrary delimiters, preserves whitespace,
+  // and correctly escapes quotes within interpolated code.
+  // NB: `oldSettings` only exists for backwards compatibility.
+  _.template = function(text, settings, oldSettings) {
+    if (!settings && oldSettings) settings = oldSettings;
+    settings = _.defaults({}, settings, _.templateSettings);
+
+    // Combine delimiters into one regular expression via alternation.
+    var matcher = RegExp([
+      (settings.escape || noMatch).source,
+      (settings.interpolate || noMatch).source,
+      (settings.evaluate || noMatch).source
+    ].join('|') + '|$', 'g');
+
+    // Compile the template source, escaping string literals appropriately.
+    var index = 0;
+    var source = "__p+='";
+    text.replace(matcher, function(match, escape, interpolate, evaluate, offset) {
+      source += text.slice(index, offset).replace(escaper, escapeChar);
+      index = offset + match.length;
+
+      if (escape) {
+        source += "'+\n((__t=(" + escape + "))==null?'':_.escape(__t))+\n'";
+      } else if (interpolate) {
+        source += "'+\n((__t=(" + interpolate + "))==null?'':__t)+\n'";
+      } else if (evaluate) {
+        source += "';\n" + evaluate + "\n__p+='";
+      }
+
+      // Adobe VMs need the match returned to produce the correct offest.
+      return match;
+    });
+    source += "';\n";
+
+    // If a variable is not specified, place data values in local scope.
+    if (!settings.variable) source = 'with(obj||{}){\n' + source + '}\n';
+
+    source = "var __t,__p='',__j=Array.prototype.join," +
+      "print=function(){__p+=__j.call(arguments,'');};\n" +
+      source + 'return __p;\n';
+
+    try {
+      var render = new Function(settings.variable || 'obj', '_', source);
+    } catch (e) {
+      e.source = source;
+      throw e;
+    }
+
+    var template = function(data) {
+      return render.call(this, data, _);
+    };
+
+    // Provide the compiled source as a convenience for precompilation.
+    var argument = settings.variable || 'obj';
+    template.source = 'function(' + argument + '){\n' + source + '}';
+
+    return template;
+  };
+
+  // Add a "chain" function. Start chaining a wrapped Underscore object.
+  _.chain = function(obj) {
+    var instance = _(obj);
+    instance._chain = true;
+    return instance;
+  };
+
+  // OOP
+  // ---------------
+  // If Underscore is called as a function, it returns a wrapped object that
+  // can be used OO-style. This wrapper holds altered versions of all the
+  // underscore functions. Wrapped objects may be chained.
+
+  // Helper function to continue chaining intermediate results.
+  var result = function(instance, obj) {
+    return instance._chain ? _(obj).chain() : obj;
+  };
+
+  // Add your own custom functions to the Underscore object.
+  _.mixin = function(obj) {
+    _.each(_.functions(obj), function(name) {
+      var func = _[name] = obj[name];
+      _.prototype[name] = function() {
+        var args = [this._wrapped];
+        push.apply(args, arguments);
+        return result(this, func.apply(_, args));
+      };
+    });
+  };
+
+  // Add all of the Underscore functions to the wrapper object.
+  _.mixin(_);
+
+  // Add all mutator Array functions to the wrapper.
+  _.each(['pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift'], function(name) {
+    var method = ArrayProto[name];
+    _.prototype[name] = function() {
+      var obj = this._wrapped;
+      method.apply(obj, arguments);
+      if ((name === 'shift' || name === 'splice') && obj.length === 0) delete obj[0];
+      return result(this, obj);
+    };
+  });
+
+  // Add all accessor Array functions to the wrapper.
+  _.each(['concat', 'join', 'slice'], function(name) {
+    var method = ArrayProto[name];
+    _.prototype[name] = function() {
+      return result(this, method.apply(this._wrapped, arguments));
+    };
+  });
+
+  // Extracts the result from a wrapped and chained object.
+  _.prototype.value = function() {
+    return this._wrapped;
+  };
+
+  // Provide unwrapping proxy for some methods used in engine operations
+  // such as arithmetic and JSON stringification.
+  _.prototype.valueOf = _.prototype.toJSON = _.prototype.value;
+
+  _.prototype.toString = function() {
+    return '' + this._wrapped;
+  };
+
+  // AMD registration happens at the end for compatibility with AMD loaders
+  // that may not enforce next-turn semantics on modules. Even though general
+  // practice for AMD registration is to be anonymous, underscore registers
+  // as a named module because, like jQuery, it is a base library that is
+  // popular enough to be bundled in a third party lib, but not be part of
+  // an AMD load request. Those cases could generate an error when an
+  // anonymous define() is called outside of a loader request.
+  if (typeof define === 'function' && define.amd) {
+    define('underscore', [], function() {
+      return _;
+    });
+  }
+}.call(this));
+
+},{}],26:[function(require,module,exports){
+arguments[4][19][0].apply(exports,arguments)
+},{"dup":19}],27:[function(require,module,exports){
+module.exports = function isBuffer(arg) {
+  return arg && typeof arg === 'object'
+    && typeof arg.copy === 'function'
+    && typeof arg.fill === 'function'
+    && typeof arg.readUInt8 === 'function';
+}
+},{}],28:[function(require,module,exports){
+(function (process,global){
+// Copyright Joyent, Inc. and other Node contributors.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a
+// copy of this software and associated documentation files (the
+// "Software"), to deal in the Software without restriction, including
+// without limitation the rights to use, copy, modify, merge, publish,
+// distribute, sublicense, and/or sell copies of the Software, and to permit
+// persons to whom the Software is furnished to do so, subject to the
+// following conditions:
+//
+// The above copyright notice and this permission notice shall be included
+// in all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+// USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+var formatRegExp = /%[sdj%]/g;
+exports.format = function(f) {
+  if (!isString(f)) {
+    var objects = [];
+    for (var i = 0; i < arguments.length; i++) {
+      objects.push(inspect(arguments[i]));
+    }
+    return objects.join(' ');
+  }
+
+  var i = 1;
+  var args = arguments;
+  var len = args.length;
+  var str = String(f).replace(formatRegExp, function(x) {
+    if (x === '%%') return '%';
+    if (i >= len) return x;
+    switch (x) {
+      case '%s': return String(args[i++]);
+      case '%d': return Number(args[i++]);
+      case '%j':
+        try {
+          return JSON.stringify(args[i++]);
+        } catch (_) {
+          return '[Circular]';
+        }
+      default:
+        return x;
+    }
+  });
+  for (var x = args[i]; i < len; x = args[++i]) {
+    if (isNull(x) || !isObject(x)) {
+      str += ' ' + x;
+    } else {
+      str += ' ' + inspect(x);
+    }
+  }
+  return str;
+};
+
+
+// Mark that a method should not be used.
+// Returns a modified function which warns once by default.
+// If --no-deprecation is set, then it is a no-op.
+exports.deprecate = function(fn, msg) {
+  // Allow for deprecating things in the process of starting up.
+  if (isUndefined(global.process)) {
+    return function() {
+      return exports.deprecate(fn, msg).apply(this, arguments);
+    };
+  }
+
+  if (process.noDeprecation === true) {
+    return fn;
+  }
+
+  var warned = false;
+  function deprecated() {
+    if (!warned) {
+      if (process.throwDeprecation) {
+        throw new Error(msg);
+      } else if (process.traceDeprecation) {
+        console.trace(msg);
+      } else {
+        console.error(msg);
+      }
+      warned = true;
+    }
+    return fn.apply(this, arguments);
+  }
+
+  return deprecated;
+};
+
+
+var debugs = {};
+var debugEnviron;
+exports.debuglog = function(set) {
+  if (isUndefined(debugEnviron))
+    debugEnviron = process.env.NODE_DEBUG || '';
+  set = set.toUpperCase();
+  if (!debugs[set]) {
+    if (new RegExp('\\b' + set + '\\b', 'i').test(debugEnviron)) {
+      var pid = process.pid;
+      debugs[set] = function() {
+        var msg = exports.format.apply(exports, arguments);
+        console.error('%s %d: %s', set, pid, msg);
+      };
+    } else {
+      debugs[set] = function() {};
+    }
+  }
+  return debugs[set];
+};
+
+
+/**
+ * Echos the value of a value. Trys to print the value out
+ * in the best way possible given the different types.
+ *
+ * @param {Object} obj The object to print out.
+ * @param {Object} opts Optional options object that alters the output.
+ */
+/* legacy: obj, showHidden, depth, colors*/
+function inspect(obj, opts) {
+  // default options
+  var ctx = {
+    seen: [],
+    stylize: stylizeNoColor
+  };
+  // legacy...
+  if (arguments.length >= 3) ctx.depth = arguments[2];
+  if (arguments.length >= 4) ctx.colors = arguments[3];
+  if (isBoolean(opts)) {
+    // legacy...
+    ctx.showHidden = opts;
+  } else if (opts) {
+    // got an "options" object
+    exports._extend(ctx, opts);
+  }
+  // set default options
+  if (isUndefined(ctx.showHidden)) ctx.showHidden = false;
+  if (isUndefined(ctx.depth)) ctx.depth = 2;
+  if (isUndefined(ctx.colors)) ctx.colors = false;
+  if (isUndefined(ctx.customInspect)) ctx.customInspect = true;
+  if (ctx.colors) ctx.stylize = stylizeWithColor;
+  return formatValue(ctx, obj, ctx.depth);
+}
+exports.inspect = inspect;
+
+
+// http://en.wikipedia.org/wiki/ANSI_escape_code#graphics
+inspect.colors = {
+  'bold' : [1, 22],
+  'italic' : [3, 23],
+  'underline' : [4, 24],
+  'inverse' : [7, 27],
+  'white' : [37, 39],
+  'grey' : [90, 39],
+  'black' : [30, 39],
+  'blue' : [34, 39],
+  'cyan' : [36, 39],
+  'green' : [32, 39],
+  'magenta' : [35, 39],
+  'red' : [31, 39],
+  'yellow' : [33, 39]
+};
+
+// Don't use 'blue' not visible on cmd.exe
+inspect.styles = {
+  'special': 'cyan',
+  'number': 'yellow',
+  'boolean': 'yellow',
+  'undefined': 'grey',
+  'null': 'bold',
+  'string': 'green',
+  'date': 'magenta',
+  // "name": intentionally not styling
+  'regexp': 'red'
+};
+
+
+function stylizeWithColor(str, styleType) {
+  var style = inspect.styles[styleType];
+
+  if (style) {
+    return '\u001b[' + inspect.colors[style][0] + 'm' + str +
+           '\u001b[' + inspect.colors[style][1] + 'm';
+  } else {
+    return str;
+  }
+}
+
+
+function stylizeNoColor(str, styleType) {
+  return str;
+}
+
+
+function arrayToHash(array) {
+  var hash = {};
+
+  array.forEach(function(val, idx) {
+    hash[val] = true;
+  });
+
+  return hash;
+}
+
+
+function formatValue(ctx, value, recurseTimes) {
+  // Provide a hook for user-specified inspect functions.
+  // Check that value is an object with an inspect function on it
+  if (ctx.customInspect &&
+      value &&
+      isFunction(value.inspect) &&
+      // Filter out the util module, it's inspect function is special
+      value.inspect !== exports.inspect &&
+      // Also filter out any prototype objects using the circular check.
+      !(value.constructor && value.constructor.prototype === value)) {
+    var ret = value.inspect(recurseTimes, ctx);
+    if (!isString(ret)) {
+      ret = formatValue(ctx, ret, recurseTimes);
+    }
+    return ret;
+  }
+
+  // Primitive types cannot have properties
+  var primitive = formatPrimitive(ctx, value);
+  if (primitive) {
+    return primitive;
+  }
+
+  // Look up the keys of the object.
+  var keys = Object.keys(value);
+  var visibleKeys = arrayToHash(keys);
+
+  if (ctx.showHidden) {
+    keys = Object.getOwnPropertyNames(value);
+  }
+
+  // IE doesn't make error fields non-enumerable
+  // http://msdn.microsoft.com/en-us/library/ie/dww52sbt(v=vs.94).aspx
+  if (isError(value)
+      && (keys.indexOf('message') >= 0 || keys.indexOf('description') >= 0)) {
+    return formatError(value);
+  }
+
+  // Some type of object without properties can be shortcutted.
+  if (keys.length === 0) {
+    if (isFunction(value)) {
+      var name = value.name ? ': ' + value.name : '';
+      return ctx.stylize('[Function' + name + ']', 'special');
+    }
+    if (isRegExp(value)) {
+      return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp');
+    }
+    if (isDate(value)) {
+      return ctx.stylize(Date.prototype.toString.call(value), 'date');
+    }
+    if (isError(value)) {
+      return formatError(value);
+    }
+  }
+
+  var base = '', array = false, braces = ['{', '}'];
+
+  // Make Array say that they are Array
+  if (isArray(value)) {
+    array = true;
+    braces = ['[', ']'];
+  }
+
+  // Make functions say that they are functions
+  if (isFunction(value)) {
+    var n = value.name ? ': ' + value.name : '';
+    base = ' [Function' + n + ']';
+  }
+
+  // Make RegExps say that they are RegExps
+  if (isRegExp(value)) {
+    base = ' ' + RegExp.prototype.toString.call(value);
+  }
+
+  // Make dates with properties first say the date
+  if (isDate(value)) {
+    base = ' ' + Date.prototype.toUTCString.call(value);
+  }
+
+  // Make error with message first say the error
+  if (isError(value)) {
+    base = ' ' + formatError(value);
+  }
+
+  if (keys.length === 0 && (!array || value.length == 0)) {
+    return braces[0] + base + braces[1];
+  }
+
+  if (recurseTimes < 0) {
+    if (isRegExp(value)) {
+      return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp');
+    } else {
+      return ctx.stylize('[Object]', 'special');
+    }
+  }
+
+  ctx.seen.push(value);
+
+  var output;
+  if (array) {
+    output = formatArray(ctx, value, recurseTimes, visibleKeys, keys);
+  } else {
+    output = keys.map(function(key) {
+      return formatProperty(ctx, value, recurseTimes, visibleKeys, key, array);
+    });
+  }
+
+  ctx.seen.pop();
+
+  return reduceToSingleString(output, base, braces);
+}
+
+
+function formatPrimitive(ctx, value) {
+  if (isUndefined(value))
+    return ctx.stylize('undefined', 'undefined');
+  if (isString(value)) {
+    var simple = '\'' + JSON.stringify(value).replace(/^"|"$/g, '')
+                                             .replace(/'/g, "\\'")
+                                             .replace(/\\"/g, '"') + '\'';
+    return ctx.stylize(simple, 'string');
+  }
+  if (isNumber(value))
+    return ctx.stylize('' + value, 'number');
+  if (isBoolean(value))
+    return ctx.stylize('' + value, 'boolean');
+  // For some reason typeof null is "object", so special case here.
+  if (isNull(value))
+    return ctx.stylize('null', 'null');
+}
+
+
+function formatError(value) {
+  return '[' + Error.prototype.toString.call(value) + ']';
+}
+
+
+function formatArray(ctx, value, recurseTimes, visibleKeys, keys) {
+  var output = [];
+  for (var i = 0, l = value.length; i < l; ++i) {
+    if (hasOwnProperty(value, String(i))) {
+      output.push(formatProperty(ctx, value, recurseTimes, visibleKeys,
+          String(i), true));
+    } else {
+      output.push('');
+    }
+  }
+  keys.forEach(function(key) {
+    if (!key.match(/^\d+$/)) {
+      output.push(formatProperty(ctx, value, recurseTimes, visibleKeys,
+          key, true));
+    }
+  });
+  return output;
+}
+
+
+function formatProperty(ctx, value, recurseTimes, visibleKeys, key, array) {
+  var name, str, desc;
+  desc = Object.getOwnPropertyDescriptor(value, key) || { value: value[key] };
+  if (desc.get) {
+    if (desc.set) {
+      str = ctx.stylize('[Getter/Setter]', 'special');
+    } else {
+      str = ctx.stylize('[Getter]', 'special');
+    }
+  } else {
+    if (desc.set) {
+      str = ctx.stylize('[Setter]', 'special');
+    }
+  }
+  if (!hasOwnProperty(visibleKeys, key)) {
+    name = '[' + key + ']';
+  }
+  if (!str) {
+    if (ctx.seen.indexOf(desc.value) < 0) {
+      if (isNull(recurseTimes)) {
+        str = formatValue(ctx, desc.value, null);
+      } else {
+        str = formatValue(ctx, desc.value, recurseTimes - 1);
+      }
+      if (str.indexOf('\n') > -1) {
+        if (array) {
+          str = str.split('\n').map(function(line) {
+            return '  ' + line;
+          }).join('\n').substr(2);
+        } else {
+          str = '\n' + str.split('\n').map(function(line) {
+            return '   ' + line;
+          }).join('\n');
+        }
+      }
+    } else {
+      str = ctx.stylize('[Circular]', 'special');
+    }
+  }
+  if (isUndefined(name)) {
+    if (array && key.match(/^\d+$/)) {
+      return str;
+    }
+    name = JSON.stringify('' + key);
+    if (name.match(/^"([a-zA-Z_][a-zA-Z_0-9]*)"$/)) {
+      name = name.substr(1, name.length - 2);
+      name = ctx.stylize(name, 'name');
+    } else {
+      name = name.replace(/'/g, "\\'")
+                 .replace(/\\"/g, '"')
+                 .replace(/(^"|"$)/g, "'");
+      name = ctx.stylize(name, 'string');
+    }
+  }
+
+  return name + ': ' + str;
+}
+
+
+function reduceToSingleString(output, base, braces) {
+  var numLinesEst = 0;
+  var length = output.reduce(function(prev, cur) {
+    numLinesEst++;
+    if (cur.indexOf('\n') >= 0) numLinesEst++;
+    return prev + cur.replace(/\u001b\[\d\d?m/g, '').length + 1;
+  }, 0);
+
+  if (length > 60) {
+    return braces[0] +
+           (base === '' ? '' : base + '\n ') +
+           ' ' +
+           output.join(',\n  ') +
+           ' ' +
+           braces[1];
+  }
+
+  return braces[0] + base + ' ' + output.join(', ') + ' ' + braces[1];
+}
+
+
+// NOTE: These type checking functions intentionally don't use `instanceof`
+// because it is fragile and can be easily faked with `Object.create()`.
+function isArray(ar) {
+  return Array.isArray(ar);
+}
+exports.isArray = isArray;
+
+function isBoolean(arg) {
+  return typeof arg === 'boolean';
+}
+exports.isBoolean = isBoolean;
+
+function isNull(arg) {
+  return arg === null;
+}
+exports.isNull = isNull;
+
+function isNullOrUndefined(arg) {
+  return arg == null;
+}
+exports.isNullOrUndefined = isNullOrUndefined;
+
+function isNumber(arg) {
+  return typeof arg === 'number';
+}
+exports.isNumber = isNumber;
+
+function isString(arg) {
+  return typeof arg === 'string';
+}
+exports.isString = isString;
+
+function isSymbol(arg) {
+  return typeof arg === 'symbol';
+}
+exports.isSymbol = isSymbol;
+
+function isUndefined(arg) {
+  return arg === void 0;
+}
+exports.isUndefined = isUndefined;
+
+function isRegExp(re) {
+  return isObject(re) && objectToString(re) === '[object RegExp]';
+}
+exports.isRegExp = isRegExp;
+
+function isObject(arg) {
+  return typeof arg === 'object' && arg !== null;
+}
+exports.isObject = isObject;
+
+function isDate(d) {
+  return isObject(d) && objectToString(d) === '[object Date]';
+}
+exports.isDate = isDate;
+
+function isError(e) {
+  return isObject(e) &&
+      (objectToString(e) === '[object Error]' || e instanceof Error);
+}
+exports.isError = isError;
+
+function isFunction(arg) {
+  return typeof arg === 'function';
+}
+exports.isFunction = isFunction;
+
+function isPrimitive(arg) {
+  return arg === null ||
+         typeof arg === 'boolean' ||
+         typeof arg === 'number' ||
+         typeof arg === 'string' ||
+         typeof arg === 'symbol' ||  // ES6 symbol
+         typeof arg === 'undefined';
+}
+exports.isPrimitive = isPrimitive;
+
+exports.isBuffer = require('./support/isBuffer');
+
+function objectToString(o) {
+  return Object.prototype.toString.call(o);
+}
+
+
+function pad(n) {
+  return n < 10 ? '0' + n.toString(10) : n.toString(10);
+}
+
+
+var months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep',
+              'Oct', 'Nov', 'Dec'];
+
+// 26 Feb 16:19:34
+function timestamp() {
+  var d = new Date();
+  var time = [pad(d.getHours()),
+              pad(d.getMinutes()),
+              pad(d.getSeconds())].join(':');
+  return [d.getDate(), months[d.getMonth()], time].join(' ');
+}
+
+
+// log is just a thin wrapper to console.log that prepends a timestamp
+exports.log = function() {
+  console.log('%s - %s', timestamp(), exports.format.apply(exports, arguments));
+};
+
+
+/**
+ * Inherit the prototype methods from one constructor into another.
+ *
+ * The Function.prototype.inherits from lang.js rewritten as a standalone
+ * function (not on Function.prototype). NOTE: If this file is to be loaded
+ * during bootstrapping this function needs to be rewritten using some native
+ * functions as prototype setup using normal JavaScript does not work as
+ * expected during bootstrapping (see mirror.js in r114903).
+ *
+ * @param {function} ctor Constructor function which needs to inherit the
+ *     prototype.
+ * @param {function} superCtor Constructor function to inherit prototype from.
+ */
+exports.inherits = require('inherits');
+
+exports._extend = function(origin, add) {
+  // Don't do anything if add isn't an object
+  if (!add || !isObject(add)) return origin;
+
+  var keys = Object.keys(add);
+  var i = keys.length;
+  while (i--) {
+    origin[keys[i]] = add[keys[i]];
+  }
+  return origin;
+};
+
+function hasOwnProperty(obj, prop) {
+  return Object.prototype.hasOwnProperty.call(obj, prop);
+}
+
+}).call(this,require('_process'),typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {})
+},{"./support/isBuffer":27,"_process":24,"inherits":26}],29:[function(require,module,exports){
+// Returns a wrapper function that returns a wrapped callback
+// The wrapper function should do some stuff, and return a
+// presumably different callback function.
+// This makes sure that own properties are retained, so that
+// decorations and such are not lost along the way.
+module.exports = wrappy
+function wrappy (fn, cb) {
+  if (fn && cb) return wrappy(fn)(cb)
+
+  if (typeof fn !== 'function')
+    throw new TypeError('need wrapper function')
+
+  Object.keys(fn).forEach(function (k) {
+    wrapper[k] = fn[k]
+  })
+
+  return wrapper
+
+  function wrapper() {
+    var args = new Array(arguments.length)
+    for (var i = 0; i < args.length; i++) {
+      args[i] = arguments[i]
+    }
+    var ret = fn.apply(this, args)
+    var cb = args[args.length-1]
+    if (typeof ret === 'function' && ret !== cb) {
+      Object.keys(cb).forEach(function (k) {
+        ret[k] = cb[k]
+      })
+    }
+    return ret
+  }
+}
+
+},{}]},{},[7])(7)
+});
\ No newline at end of file
diff --git a/latest/assets/javascripts/workers/search.6ce7567c.min.js b/latest/assets/javascripts/workers/search.6ce7567c.min.js
new file mode 100644
index 000000000..8e7e5500a
--- /dev/null
+++ b/latest/assets/javascripts/workers/search.6ce7567c.min.js
@@ -0,0 +1,42 @@
+"use strict";(()=>{var xe=Object.create;var U=Object.defineProperty,ve=Object.defineProperties,Se=Object.getOwnPropertyDescriptor,Te=Object.getOwnPropertyDescriptors,Qe=Object.getOwnPropertyNames,J=Object.getOwnPropertySymbols,Ee=Object.getPrototypeOf,Z=Object.prototype.hasOwnProperty,be=Object.prototype.propertyIsEnumerable;var K=Math.pow,X=(t,e,r)=>e in t?U(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r,A=(t,e)=>{for(var r in e||(e={}))Z.call(e,r)&&X(t,r,e[r]);if(J)for(var r of J(e))be.call(e,r)&&X(t,r,e[r]);return t},G=(t,e)=>ve(t,Te(e));var Le=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports);var we=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of Qe(e))!Z.call(t,i)&&i!==r&&U(t,i,{get:()=>e[i],enumerable:!(n=Se(e,i))||n.enumerable});return t};var Pe=(t,e,r)=>(r=t!=null?xe(Ee(t)):{},we(e||!t||!t.__esModule?U(r,"default",{value:t,enumerable:!0}):r,t));var B=(t,e,r)=>new Promise((n,i)=>{var s=u=>{try{a(r.next(u))}catch(c){i(c)}},o=u=>{try{a(r.throw(u))}catch(c){i(c)}},a=u=>u.done?n(u.value):Promise.resolve(u.value).then(s,o);a((r=r.apply(t,e)).next())});var re=Le((ee,te)=>{/**
+ * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9
+ * Copyright (C) 2020 Oliver Nightingale
+ * @license MIT
+ */(function(){var t=function(e){var r=new t.Builder;return r.pipeline.add(t.trimmer,t.stopWordFilter,t.stemmer),r.searchPipeline.add(t.stemmer),e.call(r,r),r.build()};t.version="2.3.9";/*!
+ * lunr.utils
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.utils={},t.utils.warn=function(e){return function(r){e.console&&console.warn&&console.warn(r)}}(this),t.utils.asString=function(e){return e==null?"":e.toString()},t.utils.clone=function(e){if(e==null)return e;for(var r=Object.create(null),n=Object.keys(e),i=0;i<n.length;i++){var s=n[i],o=e[s];if(Array.isArray(o)){r[s]=o.slice();continue}if(typeof o=="string"||typeof o=="number"||typeof o=="boolean"){r[s]=o;continue}throw new TypeError("clone is not deep and does not support nested objects")}return r},t.FieldRef=function(e,r,n){this.docRef=e,this.fieldName=r,this._stringValue=n},t.FieldRef.joiner="/",t.FieldRef.fromString=function(e){var r=e.indexOf(t.FieldRef.joiner);if(r===-1)throw"malformed field ref string";var n=e.slice(0,r),i=e.slice(r+1);return new t.FieldRef(i,n,e)},t.FieldRef.prototype.toString=function(){return this._stringValue==null&&(this._stringValue=this.fieldName+t.FieldRef.joiner+this.docRef),this._stringValue};/*!
+ * lunr.Set
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.Set=function(e){if(this.elements=Object.create(null),e){this.length=e.length;for(var r=0;r<this.length;r++)this.elements[e[r]]=!0}else this.length=0},t.Set.complete={intersect:function(e){return e},union:function(){return this},contains:function(){return!0}},t.Set.empty={intersect:function(){return this},union:function(e){return e},contains:function(){return!1}},t.Set.prototype.contains=function(e){return!!this.elements[e]},t.Set.prototype.intersect=function(e){var r,n,i,s=[];if(e===t.Set.complete)return this;if(e===t.Set.empty)return e;this.length<e.length?(r=this,n=e):(r=e,n=this),i=Object.keys(r.elements);for(var o=0;o<i.length;o++){var a=i[o];a in n.elements&&s.push(a)}return new t.Set(s)},t.Set.prototype.union=function(e){return e===t.Set.complete?t.Set.complete:e===t.Set.empty?this:new t.Set(Object.keys(this.elements).concat(Object.keys(e.elements)))},t.idf=function(e,r){var n=0;for(var i in e)i!="_index"&&(n+=Object.keys(e[i]).length);var s=(r-n+.5)/(n+.5);return Math.log(1+Math.abs(s))},t.Token=function(e,r){this.str=e||"",this.metadata=r||{}},t.Token.prototype.toString=function(){return this.str},t.Token.prototype.update=function(e){return this.str=e(this.str,this.metadata),this},t.Token.prototype.clone=function(e){return e=e||function(r){return r},new t.Token(e(this.str,this.metadata),this.metadata)};/*!
+ * lunr.tokenizer
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.tokenizer=function(e,r){if(e==null||e==null)return[];if(Array.isArray(e))return e.map(function(g){return new t.Token(t.utils.asString(g).toLowerCase(),t.utils.clone(r))});for(var n=e.toString().toLowerCase(),i=n.length,s=[],o=0,a=0;o<=i;o++){var u=n.charAt(o),c=o-a;if(u.match(t.tokenizer.separator)||o==i){if(c>0){var f=t.utils.clone(r)||{};f.position=[a,c],f.index=s.length,s.push(new t.Token(n.slice(a,o),f))}a=o+1}}return s},t.tokenizer.separator=/[\s\-]+/;/*!
+ * lunr.Pipeline
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.Pipeline=function(){this._stack=[]},t.Pipeline.registeredFunctions=Object.create(null),t.Pipeline.registerFunction=function(e,r){r in this.registeredFunctions&&t.utils.warn("Overwriting existing registered function: "+r),e.label=r,t.Pipeline.registeredFunctions[e.label]=e},t.Pipeline.warnIfFunctionNotRegistered=function(e){var r=e.label&&e.label in this.registeredFunctions;r||t.utils.warn(`Function is not registered with pipeline. This may cause problems when serialising the index.
+`,e)},t.Pipeline.load=function(e){var r=new t.Pipeline;return e.forEach(function(n){var i=t.Pipeline.registeredFunctions[n];if(i)r.add(i);else throw new Error("Cannot load unregistered function: "+n)}),r},t.Pipeline.prototype.add=function(){var e=Array.prototype.slice.call(arguments);e.forEach(function(r){t.Pipeline.warnIfFunctionNotRegistered(r),this._stack.push(r)},this)},t.Pipeline.prototype.after=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");n=n+1,this._stack.splice(n,0,r)},t.Pipeline.prototype.before=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");this._stack.splice(n,0,r)},t.Pipeline.prototype.remove=function(e){var r=this._stack.indexOf(e);r!=-1&&this._stack.splice(r,1)},t.Pipeline.prototype.run=function(e){for(var r=this._stack.length,n=0;n<r;n++){for(var i=this._stack[n],s=[],o=0;o<e.length;o++){var a=i(e[o],o,e);if(!(a==null||a===""))if(Array.isArray(a))for(var u=0;u<a.length;u++)s.push(a[u]);else s.push(a)}e=s}return e},t.Pipeline.prototype.runString=function(e,r){var n=new t.Token(e,r);return this.run([n]).map(function(i){return i.toString()})},t.Pipeline.prototype.reset=function(){this._stack=[]},t.Pipeline.prototype.toJSON=function(){return this._stack.map(function(e){return t.Pipeline.warnIfFunctionNotRegistered(e),e.label})};/*!
+ * lunr.Vector
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.Vector=function(e){this._magnitude=0,this.elements=e||[]},t.Vector.prototype.positionForIndex=function(e){if(this.elements.length==0)return 0;for(var r=0,n=this.elements.length/2,i=n-r,s=Math.floor(i/2),o=this.elements[s*2];i>1&&(o<e&&(r=s),o>e&&(n=s),o!=e);)i=n-r,s=r+Math.floor(i/2),o=this.elements[s*2];if(o==e||o>e)return s*2;if(o<e)return(s+1)*2},t.Vector.prototype.insert=function(e,r){this.upsert(e,r,function(){throw"duplicate index"})},t.Vector.prototype.upsert=function(e,r,n){this._magnitude=0;var i=this.positionForIndex(e);this.elements[i]==e?this.elements[i+1]=n(this.elements[i+1],r):this.elements.splice(i,0,e,r)},t.Vector.prototype.magnitude=function(){if(this._magnitude)return this._magnitude;for(var e=0,r=this.elements.length,n=1;n<r;n+=2){var i=this.elements[n];e+=i*i}return this._magnitude=Math.sqrt(e)},t.Vector.prototype.dot=function(e){for(var r=0,n=this.elements,i=e.elements,s=n.length,o=i.length,a=0,u=0,c=0,f=0;c<s&&f<o;)a=n[c],u=i[f],a<u?c+=2:a>u?f+=2:a==u&&(r+=n[c+1]*i[f+1],c+=2,f+=2);return r},t.Vector.prototype.similarity=function(e){return this.dot(e)/this.magnitude()||0},t.Vector.prototype.toArray=function(){for(var e=new Array(this.elements.length/2),r=1,n=0;r<this.elements.length;r+=2,n++)e[n]=this.elements[r];return e},t.Vector.prototype.toJSON=function(){return this.elements};/*!
+ * lunr.stemmer
+ * Copyright (C) 2020 Oliver Nightingale
+ * Includes code from - http://tartarus.org/~martin/PorterStemmer/js.txt
+ */t.stemmer=function(){var e={ational:"ate",tional:"tion",enci:"ence",anci:"ance",izer:"ize",bli:"ble",alli:"al",entli:"ent",eli:"e",ousli:"ous",ization:"ize",ation:"ate",ator:"ate",alism:"al",iveness:"ive",fulness:"ful",ousness:"ous",aliti:"al",iviti:"ive",biliti:"ble",logi:"log"},r={icate:"ic",ative:"",alize:"al",iciti:"ic",ical:"ic",ful:"",ness:""},n="[^aeiou]",i="[aeiouy]",s=n+"[^aeiouy]*",o=i+"[aeiou]*",a="^("+s+")?"+o+s,u="^("+s+")?"+o+s+"("+o+")?$",c="^("+s+")?"+o+s+o+s,f="^("+s+")?"+i,g=new RegExp(a),l=new RegExp(c),m=new RegExp(u),x=new RegExp(f),v=/^(.+?)(ss|i)es$/,d=/^(.+?)([^s])s$/,y=/^(.+?)eed$/,b=/^(.+?)(ed|ing)$/,E=/.$/,w=/(at|bl|iz)$/,R=new RegExp("([^aeiouylsz])\\1$"),j=new RegExp("^"+s+i+"[^aeiouwxy]$"),_=/^(.+?[^aeiou])y$/,D=/^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/,N=/^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/,C=/^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/,V=/^(.+?)(s|t)(ion)$/,P=/^(.+?)e$/,z=/ll$/,$=new RegExp("^"+s+i+"[^aeiouwxy]$"),M=function(h){var S,k,L,p,T,O,F;if(h.length<3)return h;if(L=h.substr(0,1),L=="y"&&(h=L.toUpperCase()+h.substr(1)),p=v,T=d,p.test(h)?h=h.replace(p,"$1$2"):T.test(h)&&(h=h.replace(T,"$1$2")),p=y,T=b,p.test(h)){var Q=p.exec(h);p=g,p.test(Q[1])&&(p=E,h=h.replace(p,""))}else if(T.test(h)){var Q=T.exec(h);S=Q[1],T=x,T.test(S)&&(h=S,T=w,O=R,F=j,T.test(h)?h=h+"e":O.test(h)?(p=E,h=h.replace(p,"")):F.test(h)&&(h=h+"e"))}if(p=_,p.test(h)){var Q=p.exec(h);S=Q[1],h=S+"i"}if(p=D,p.test(h)){var Q=p.exec(h);S=Q[1],k=Q[2],p=g,p.test(S)&&(h=S+e[k])}if(p=N,p.test(h)){var Q=p.exec(h);S=Q[1],k=Q[2],p=g,p.test(S)&&(h=S+r[k])}if(p=C,T=V,p.test(h)){var Q=p.exec(h);S=Q[1],p=l,p.test(S)&&(h=S)}else if(T.test(h)){var Q=T.exec(h);S=Q[1]+Q[2],T=l,T.test(S)&&(h=S)}if(p=P,p.test(h)){var Q=p.exec(h);S=Q[1],p=l,T=m,O=$,(p.test(S)||T.test(S)&&!O.test(S))&&(h=S)}return p=z,T=l,p.test(h)&&T.test(h)&&(p=E,h=h.replace(p,"")),L=="y"&&(h=L.toLowerCase()+h.substr(1)),h};return function(I){return I.update(M)}}(),t.Pipeline.registerFunction(t.stemmer,"stemmer");/*!
+ * lunr.stopWordFilter
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.generateStopWordFilter=function(e){var r=e.reduce(function(n,i){return n[i]=i,n},{});return function(n){if(n&&r[n.toString()]!==n.toString())return n}},t.stopWordFilter=t.generateStopWordFilter(["a","able","about","across","after","all","almost","also","am","among","an","and","any","are","as","at","be","because","been","but","by","can","cannot","could","dear","did","do","does","either","else","ever","every","for","from","get","got","had","has","have","he","her","hers","him","his","how","however","i","if","in","into","is","it","its","just","least","let","like","likely","may","me","might","most","must","my","neither","no","nor","not","of","off","often","on","only","or","other","our","own","rather","said","say","says","she","should","since","so","some","than","that","the","their","them","then","there","these","they","this","tis","to","too","twas","us","wants","was","we","were","what","when","where","which","while","who","whom","why","will","with","would","yet","you","your"]),t.Pipeline.registerFunction(t.stopWordFilter,"stopWordFilter");/*!
+ * lunr.trimmer
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.trimmer=function(e){return e.update(function(r){return r.replace(/^\W+/,"").replace(/\W+$/,"")})},t.Pipeline.registerFunction(t.trimmer,"trimmer");/*!
+ * lunr.TokenSet
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.TokenSet=function(){this.final=!1,this.edges={},this.id=t.TokenSet._nextId,t.TokenSet._nextId+=1},t.TokenSet._nextId=1,t.TokenSet.fromArray=function(e){for(var r=new t.TokenSet.Builder,n=0,i=e.length;n<i;n++)r.insert(e[n]);return r.finish(),r.root},t.TokenSet.fromClause=function(e){return"editDistance"in e?t.TokenSet.fromFuzzyString(e.term,e.editDistance):t.TokenSet.fromString(e.term)},t.TokenSet.fromFuzzyString=function(e,r){for(var n=new t.TokenSet,i=[{node:n,editsRemaining:r,str:e}];i.length;){var s=i.pop();if(s.str.length>0){var o=s.str.charAt(0),a;o in s.node.edges?a=s.node.edges[o]:(a=new t.TokenSet,s.node.edges[o]=a),s.str.length==1&&(a.final=!0),i.push({node:a,editsRemaining:s.editsRemaining,str:s.str.slice(1)})}if(s.editsRemaining!=0){if("*"in s.node.edges)var u=s.node.edges["*"];else{var u=new t.TokenSet;s.node.edges["*"]=u}if(s.str.length==0&&(u.final=!0),i.push({node:u,editsRemaining:s.editsRemaining-1,str:s.str}),s.str.length>1&&i.push({node:s.node,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)}),s.str.length==1&&(s.node.final=!0),s.str.length>=1){if("*"in s.node.edges)var c=s.node.edges["*"];else{var c=new t.TokenSet;s.node.edges["*"]=c}s.str.length==1&&(c.final=!0),i.push({node:c,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)})}if(s.str.length>1){var f=s.str.charAt(0),g=s.str.charAt(1),l;g in s.node.edges?l=s.node.edges[g]:(l=new t.TokenSet,s.node.edges[g]=l),s.str.length==1&&(l.final=!0),i.push({node:l,editsRemaining:s.editsRemaining-1,str:f+s.str.slice(2)})}}}return n},t.TokenSet.fromString=function(e){for(var r=new t.TokenSet,n=r,i=0,s=e.length;i<s;i++){var o=e[i],a=i==s-1;if(o=="*")r.edges[o]=r,r.final=a;else{var u=new t.TokenSet;u.final=a,r.edges[o]=u,r=u}}return n},t.TokenSet.prototype.toArray=function(){for(var e=[],r=[{prefix:"",node:this}];r.length;){var n=r.pop(),i=Object.keys(n.node.edges),s=i.length;n.node.final&&(n.prefix.charAt(0),e.push(n.prefix));for(var o=0;o<s;o++){var a=i[o];r.push({prefix:n.prefix.concat(a),node:n.node.edges[a]})}}return e},t.TokenSet.prototype.toString=function(){if(this._str)return this._str;for(var e=this.final?"1":"0",r=Object.keys(this.edges).sort(),n=r.length,i=0;i<n;i++){var s=r[i],o=this.edges[s];e=e+s+o.id}return e},t.TokenSet.prototype.intersect=function(e){for(var r=new t.TokenSet,n=void 0,i=[{qNode:e,output:r,node:this}];i.length;){n=i.pop();for(var s=Object.keys(n.qNode.edges),o=s.length,a=Object.keys(n.node.edges),u=a.length,c=0;c<o;c++)for(var f=s[c],g=0;g<u;g++){var l=a[g];if(l==f||f=="*"){var m=n.node.edges[l],x=n.qNode.edges[f],v=m.final&&x.final,d=void 0;l in n.output.edges?(d=n.output.edges[l],d.final=d.final||v):(d=new t.TokenSet,d.final=v,n.output.edges[l]=d),i.push({qNode:x,output:d,node:m})}}}return r},t.TokenSet.Builder=function(){this.previousWord="",this.root=new t.TokenSet,this.uncheckedNodes=[],this.minimizedNodes={}},t.TokenSet.Builder.prototype.insert=function(e){var r,n=0;if(e<this.previousWord)throw new Error("Out of order word insertion");for(var i=0;i<e.length&&i<this.previousWord.length&&e[i]==this.previousWord[i];i++)n++;this.minimize(n),this.uncheckedNodes.length==0?r=this.root:r=this.uncheckedNodes[this.uncheckedNodes.length-1].child;for(var i=n;i<e.length;i++){var s=new t.TokenSet,o=e[i];r.edges[o]=s,this.uncheckedNodes.push({parent:r,char:o,child:s}),r=s}r.final=!0,this.previousWord=e},t.TokenSet.Builder.prototype.finish=function(){this.minimize(0)},t.TokenSet.Builder.prototype.minimize=function(e){for(var r=this.uncheckedNodes.length-1;r>=e;r--){var n=this.uncheckedNodes[r],i=n.child.toString();i in this.minimizedNodes?n.parent.edges[n.char]=this.minimizedNodes[i]:(n.child._str=i,this.minimizedNodes[i]=n.child),this.uncheckedNodes.pop()}};/*!
+ * lunr.Index
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.Index=function(e){this.invertedIndex=e.invertedIndex,this.fieldVectors=e.fieldVectors,this.tokenSet=e.tokenSet,this.fields=e.fields,this.pipeline=e.pipeline},t.Index.prototype.search=function(e){return this.query(function(r){var n=new t.QueryParser(e,r);n.parse()})},t.Index.prototype.query=function(e){for(var r=new t.Query(this.fields),n=Object.create(null),i=Object.create(null),s=Object.create(null),o=Object.create(null),a=Object.create(null),u=0;u<this.fields.length;u++)i[this.fields[u]]=new t.Vector;e.call(r,r);for(var u=0;u<r.clauses.length;u++){var c=r.clauses[u],f=null,g=t.Set.empty;c.usePipeline?f=this.pipeline.runString(c.term,{fields:c.fields}):f=[c.term];for(var l=0;l<f.length;l++){var m=f[l];c.term=m;var x=t.TokenSet.fromClause(c),v=this.tokenSet.intersect(x).toArray();if(v.length===0&&c.presence===t.Query.presence.REQUIRED){for(var d=0;d<c.fields.length;d++){var y=c.fields[d];o[y]=t.Set.empty}break}for(var b=0;b<v.length;b++)for(var E=v[b],w=this.invertedIndex[E],R=w._index,d=0;d<c.fields.length;d++){var y=c.fields[d],j=w[y],_=Object.keys(j),D=E+"/"+y,N=new t.Set(_);if(c.presence==t.Query.presence.REQUIRED&&(g=g.union(N),o[y]===void 0&&(o[y]=t.Set.complete)),c.presence==t.Query.presence.PROHIBITED){a[y]===void 0&&(a[y]=t.Set.empty),a[y]=a[y].union(N);continue}if(i[y].upsert(R,c.boost,function(ye,me){return ye+me}),!s[D]){for(var C=0;C<_.length;C++){var V=_[C],P=new t.FieldRef(V,y),z=j[V],$;($=n[P])===void 0?n[P]=new t.MatchData(E,y,z):$.add(E,y,z)}s[D]=!0}}}if(c.presence===t.Query.presence.REQUIRED)for(var d=0;d<c.fields.length;d++){var y=c.fields[d];o[y]=o[y].intersect(g)}}for(var M=t.Set.complete,I=t.Set.empty,u=0;u<this.fields.length;u++){var y=this.fields[u];o[y]&&(M=M.intersect(o[y])),a[y]&&(I=I.union(a[y]))}var h=Object.keys(n),S=[],k=Object.create(null);if(r.isNegated()){h=Object.keys(this.fieldVectors);for(var u=0;u<h.length;u++){var P=h[u],L=t.FieldRef.fromString(P);n[P]=new t.MatchData}}for(var u=0;u<h.length;u++){var L=t.FieldRef.fromString(h[u]),p=L.docRef;if(M.contains(p)&&!I.contains(p)){var T=this.fieldVectors[L],O=i[L.fieldName].similarity(T),F;if((F=k[p])!==void 0)F.score+=O,F.matchData.combine(n[L]);else{var Q={ref:p,score:O,matchData:n[L]};k[p]=Q,S.push(Q)}}}return S.sort(function(pe,ge){return ge.score-pe.score})},t.Index.prototype.toJSON=function(){var e=Object.keys(this.invertedIndex).sort().map(function(n){return[n,this.invertedIndex[n]]},this),r=Object.keys(this.fieldVectors).map(function(n){return[n,this.fieldVectors[n].toJSON()]},this);return{version:t.version,fields:this.fields,fieldVectors:r,invertedIndex:e,pipeline:this.pipeline.toJSON()}},t.Index.load=function(e){var r={},n={},i=e.fieldVectors,s=Object.create(null),o=e.invertedIndex,a=new t.TokenSet.Builder,u=t.Pipeline.load(e.pipeline);e.version!=t.version&&t.utils.warn("Version mismatch when loading serialised index. Current version of lunr '"+t.version+"' does not match serialized index '"+e.version+"'");for(var c=0;c<i.length;c++){var f=i[c],g=f[0],l=f[1];n[g]=new t.Vector(l)}for(var c=0;c<o.length;c++){var f=o[c],m=f[0],x=f[1];a.insert(m),s[m]=x}return a.finish(),r.fields=e.fields,r.fieldVectors=n,r.invertedIndex=s,r.tokenSet=a.root,r.pipeline=u,new t.Index(r)};/*!
+ * lunr.Builder
+ * Copyright (C) 2020 Oliver Nightingale
+ */t.Builder=function(){this._ref="id",this._fields=Object.create(null),this._documents=Object.create(null),this.invertedIndex=Object.create(null),this.fieldTermFrequencies={},this.fieldLengths={},this.tokenizer=t.tokenizer,this.pipeline=new t.Pipeline,this.searchPipeline=new t.Pipeline,this.documentCount=0,this._b=.75,this._k1=1.2,this.termIndex=0,this.metadataWhitelist=[]},t.Builder.prototype.ref=function(e){this._ref=e},t.Builder.prototype.field=function(e,r){if(/\//.test(e))throw new RangeError("Field '"+e+"' contains illegal character '/'");this._fields[e]=r||{}},t.Builder.prototype.b=function(e){e<0?this._b=0:e>1?this._b=1:this._b=e},t.Builder.prototype.k1=function(e){this._k1=e},t.Builder.prototype.add=function(e,r){var n=e[this._ref],i=Object.keys(this._fields);this._documents[n]=r||{},this.documentCount+=1;for(var s=0;s<i.length;s++){var o=i[s],a=this._fields[o].extractor,u=a?a(e):e[o],c=this.tokenizer(u,{fields:[o]}),f=this.pipeline.run(c),g=new t.FieldRef(n,o),l=Object.create(null);this.fieldTermFrequencies[g]=l,this.fieldLengths[g]=0,this.fieldLengths[g]+=f.length;for(var m=0;m<f.length;m++){var x=f[m];if(l[x]==null&&(l[x]=0),l[x]+=1,this.invertedIndex[x]==null){var v=Object.create(null);v._index=this.termIndex,this.termIndex+=1;for(var d=0;d<i.length;d++)v[i[d]]=Object.create(null);this.invertedIndex[x]=v}this.invertedIndex[x][o][n]==null&&(this.invertedIndex[x][o][n]=Object.create(null));for(var y=0;y<this.metadataWhitelist.length;y++){var b=this.metadataWhitelist[y],E=x.metadata[b];this.invertedIndex[x][o][n][b]==null&&(this.invertedIndex[x][o][n][b]=[]),this.invertedIndex[x][o][n][b].push(E)}}}},t.Builder.prototype.calculateAverageFieldLengths=function(){for(var e=Object.keys(this.fieldLengths),r=e.length,n={},i={},s=0;s<r;s++){var o=t.FieldRef.fromString(e[s]),a=o.fieldName;i[a]||(i[a]=0),i[a]+=1,n[a]||(n[a]=0),n[a]+=this.fieldLengths[o]}for(var u=Object.keys(this._fields),s=0;s<u.length;s++){var c=u[s];n[c]=n[c]/i[c]}this.averageFieldLength=n},t.Builder.prototype.createFieldVectors=function(){for(var e={},r=Object.keys(this.fieldTermFrequencies),n=r.length,i=Object.create(null),s=0;s<n;s++){for(var o=t.FieldRef.fromString(r[s]),a=o.fieldName,u=this.fieldLengths[o],c=new t.Vector,f=this.fieldTermFrequencies[o],g=Object.keys(f),l=g.length,m=this._fields[a].boost||1,x=this._documents[o.docRef].boost||1,v=0;v<l;v++){var d=g[v],y=f[d],b=this.invertedIndex[d]._index,E,w,R;i[d]===void 0?(E=t.idf(this.invertedIndex[d],this.documentCount),i[d]=E):E=i[d],w=E*((this._k1+1)*y)/(this._k1*(1-this._b+this._b*(u/this.averageFieldLength[a]))+y),w*=m,w*=x,R=Math.round(w*1e3)/1e3,c.insert(b,R)}e[o]=c}this.fieldVectors=e},t.Builder.prototype.createTokenSet=function(){this.tokenSet=t.TokenSet.fromArray(Object.keys(this.invertedIndex).sort())},t.Builder.prototype.build=function(){return this.calculateAverageFieldLengths(),this.createFieldVectors(),this.createTokenSet(),new t.Index({invertedIndex:this.invertedIndex,fieldVectors:this.fieldVectors,tokenSet:this.tokenSet,fields:Object.keys(this._fields),pipeline:this.searchPipeline})},t.Builder.prototype.use=function(e){var r=Array.prototype.slice.call(arguments,1);r.unshift(this),e.apply(this,r)},t.MatchData=function(e,r,n){for(var i=Object.create(null),s=Object.keys(n||{}),o=0;o<s.length;o++){var a=s[o];i[a]=n[a].slice()}this.metadata=Object.create(null),e!==void 0&&(this.metadata[e]=Object.create(null),this.metadata[e][r]=i)},t.MatchData.prototype.combine=function(e){for(var r=Object.keys(e.metadata),n=0;n<r.length;n++){var i=r[n],s=Object.keys(e.metadata[i]);this.metadata[i]==null&&(this.metadata[i]=Object.create(null));for(var o=0;o<s.length;o++){var a=s[o],u=Object.keys(e.metadata[i][a]);this.metadata[i][a]==null&&(this.metadata[i][a]=Object.create(null));for(var c=0;c<u.length;c++){var f=u[c];this.metadata[i][a][f]==null?this.metadata[i][a][f]=e.metadata[i][a][f]:this.metadata[i][a][f]=this.metadata[i][a][f].concat(e.metadata[i][a][f])}}}},t.MatchData.prototype.add=function(e,r,n){if(!(e in this.metadata)){this.metadata[e]=Object.create(null),this.metadata[e][r]=n;return}if(!(r in this.metadata[e])){this.metadata[e][r]=n;return}for(var i=Object.keys(n),s=0;s<i.length;s++){var o=i[s];o in this.metadata[e][r]?this.metadata[e][r][o]=this.metadata[e][r][o].concat(n[o]):this.metadata[e][r][o]=n[o]}},t.Query=function(e){this.clauses=[],this.allFields=e},t.Query.wildcard=new String("*"),t.Query.wildcard.NONE=0,t.Query.wildcard.LEADING=1,t.Query.wildcard.TRAILING=2,t.Query.presence={OPTIONAL:1,REQUIRED:2,PROHIBITED:3},t.Query.prototype.clause=function(e){return"fields"in e||(e.fields=this.allFields),"boost"in e||(e.boost=1),"usePipeline"in e||(e.usePipeline=!0),"wildcard"in e||(e.wildcard=t.Query.wildcard.NONE),e.wildcard&t.Query.wildcard.LEADING&&e.term.charAt(0)!=t.Query.wildcard&&(e.term="*"+e.term),e.wildcard&t.Query.wildcard.TRAILING&&e.term.slice(-1)!=t.Query.wildcard&&(e.term=""+e.term+"*"),"presence"in e||(e.presence=t.Query.presence.OPTIONAL),this.clauses.push(e),this},t.Query.prototype.isNegated=function(){for(var e=0;e<this.clauses.length;e++)if(this.clauses[e].presence!=t.Query.presence.PROHIBITED)return!1;return!0},t.Query.prototype.term=function(e,r){if(Array.isArray(e))return e.forEach(function(i){this.term(i,t.utils.clone(r))},this),this;var n=r||{};return n.term=e.toString(),this.clause(n),this},t.QueryParseError=function(e,r,n){this.name="QueryParseError",this.message=e,this.start=r,this.end=n},t.QueryParseError.prototype=new Error,t.QueryLexer=function(e){this.lexemes=[],this.str=e,this.length=e.length,this.pos=0,this.start=0,this.escapeCharPositions=[]},t.QueryLexer.prototype.run=function(){for(var e=t.QueryLexer.lexText;e;)e=e(this)},t.QueryLexer.prototype.sliceString=function(){for(var e=[],r=this.start,n=this.pos,i=0;i<this.escapeCharPositions.length;i++)n=this.escapeCharPositions[i],e.push(this.str.slice(r,n)),r=n+1;return e.push(this.str.slice(r,this.pos)),this.escapeCharPositions.length=0,e.join("")},t.QueryLexer.prototype.emit=function(e){this.lexemes.push({type:e,str:this.sliceString(),start:this.start,end:this.pos}),this.start=this.pos},t.QueryLexer.prototype.escapeCharacter=function(){this.escapeCharPositions.push(this.pos-1),this.pos+=1},t.QueryLexer.prototype.next=function(){if(this.pos>=this.length)return t.QueryLexer.EOS;var e=this.str.charAt(this.pos);return this.pos+=1,e},t.QueryLexer.prototype.width=function(){return this.pos-this.start},t.QueryLexer.prototype.ignore=function(){this.start==this.pos&&(this.pos+=1),this.start=this.pos},t.QueryLexer.prototype.backup=function(){this.pos-=1},t.QueryLexer.prototype.acceptDigitRun=function(){var e,r;do e=this.next(),r=e.charCodeAt(0);while(r>47&&r<58);e!=t.QueryLexer.EOS&&this.backup()},t.QueryLexer.prototype.more=function(){return this.pos<this.length},t.QueryLexer.EOS="EOS",t.QueryLexer.FIELD="FIELD",t.QueryLexer.TERM="TERM",t.QueryLexer.EDIT_DISTANCE="EDIT_DISTANCE",t.QueryLexer.BOOST="BOOST",t.QueryLexer.PRESENCE="PRESENCE",t.QueryLexer.lexField=function(e){return e.backup(),e.emit(t.QueryLexer.FIELD),e.ignore(),t.QueryLexer.lexText},t.QueryLexer.lexTerm=function(e){if(e.width()>1&&(e.backup(),e.emit(t.QueryLexer.TERM)),e.ignore(),e.more())return t.QueryLexer.lexText},t.QueryLexer.lexEditDistance=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.EDIT_DISTANCE),t.QueryLexer.lexText},t.QueryLexer.lexBoost=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.BOOST),t.QueryLexer.lexText},t.QueryLexer.lexEOS=function(e){e.width()>0&&e.emit(t.QueryLexer.TERM)},t.QueryLexer.termSeparator=t.tokenizer.separator,t.QueryLexer.lexText=function(e){for(;;){var r=e.next();if(r==t.QueryLexer.EOS)return t.QueryLexer.lexEOS;if(r.charCodeAt(0)==92){e.escapeCharacter();continue}if(r==":")return t.QueryLexer.lexField;if(r=="~")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexEditDistance;if(r=="^")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexBoost;if(r=="+"&&e.width()===1||r=="-"&&e.width()===1)return e.emit(t.QueryLexer.PRESENCE),t.QueryLexer.lexText;if(r.match(t.QueryLexer.termSeparator))return t.QueryLexer.lexTerm}},t.QueryParser=function(e,r){this.lexer=new t.QueryLexer(e),this.query=r,this.currentClause={},this.lexemeIdx=0},t.QueryParser.prototype.parse=function(){this.lexer.run(),this.lexemes=this.lexer.lexemes;for(var e=t.QueryParser.parseClause;e;)e=e(this);return this.query},t.QueryParser.prototype.peekLexeme=function(){return this.lexemes[this.lexemeIdx]},t.QueryParser.prototype.consumeLexeme=function(){var e=this.peekLexeme();return this.lexemeIdx+=1,e},t.QueryParser.prototype.nextClause=function(){var e=this.currentClause;this.query.clause(e),this.currentClause={}},t.QueryParser.parseClause=function(e){var r=e.peekLexeme();if(r!=null)switch(r.type){case t.QueryLexer.PRESENCE:return t.QueryParser.parsePresence;case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expected either a field or a term, found "+r.type;throw r.str.length>=1&&(n+=" with value '"+r.str+"'"),new t.QueryParseError(n,r.start,r.end)}},t.QueryParser.parsePresence=function(e){var r=e.consumeLexeme();if(r!=null){switch(r.str){case"-":e.currentClause.presence=t.Query.presence.PROHIBITED;break;case"+":e.currentClause.presence=t.Query.presence.REQUIRED;break;default:var n="unrecognised presence operator'"+r.str+"'";throw new t.QueryParseError(n,r.start,r.end)}var i=e.peekLexeme();if(i==null){var n="expecting term or field, found nothing";throw new t.QueryParseError(n,r.start,r.end)}switch(i.type){case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expecting term or field, found '"+i.type+"'";throw new t.QueryParseError(n,i.start,i.end)}}},t.QueryParser.parseField=function(e){var r=e.consumeLexeme();if(r!=null){if(e.query.allFields.indexOf(r.str)==-1){var n=e.query.allFields.map(function(o){return"'"+o+"'"}).join(", "),i="unrecognised field '"+r.str+"', possible fields: "+n;throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.fields=[r.str];var s=e.peekLexeme();if(s==null){var i="expecting term, found nothing";throw new t.QueryParseError(i,r.start,r.end)}switch(s.type){case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var i="expecting term, found '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseTerm=function(e){var r=e.consumeLexeme();if(r!=null){e.currentClause.term=r.str.toLowerCase(),r.str.indexOf("*")!=-1&&(e.currentClause.usePipeline=!1);var n=e.peekLexeme();if(n==null){e.nextClause();return}switch(n.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+n.type+"'";throw new t.QueryParseError(i,n.start,n.end)}}},t.QueryParser.parseEditDistance=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="edit distance must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.editDistance=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseBoost=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="boost must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.boost=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},function(e,r){typeof define=="function"&&define.amd?define(r):typeof ee=="object"?te.exports=r():e.lunr=r()}(this,function(){return t})})()});var Y=Pe(re());function ne(t,e=document){let r=ke(t,e);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${t}" to be present`);return r}function ke(t,e=document){return e.querySelector(t)||void 0}Object.entries||(Object.entries=function(t){let e=[];for(let r of Object.keys(t))e.push([r,t[r]]);return e});Object.values||(Object.values=function(t){let e=[];for(let r of Object.keys(t))e.push(t[r]);return e});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(t,e){typeof t=="object"?(this.scrollLeft=t.left,this.scrollTop=t.top):(this.scrollLeft=t,this.scrollTop=e)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...t){let e=this.parentNode;if(e){t.length===0&&e.removeChild(this);for(let r=t.length-1;r>=0;r--){let n=t[r];typeof n=="string"?n=document.createTextNode(n):n.parentNode&&n.parentNode.removeChild(n),r?e.insertBefore(this.previousSibling,n):e.replaceChild(n,this)}}}));function ie(t){let e=new Map;for(let r of t){let[n]=r.location.split("#"),i=e.get(n);typeof i=="undefined"?e.set(n,r):(e.set(r.location,r),r.parent=i)}return e}function W(t,e,r){var s;e=new RegExp(e,"g");let n,i=0;do{n=e.exec(t);let o=(s=n==null?void 0:n.index)!=null?s:t.length;if(i<o&&r(i,o),n){let[a]=n;i=n.index+a.length,a.length===0&&(e.lastIndex=n.index+1)}}while(n)}function se(t,e){let r=0,n=0,i=0;for(let s=0;i<t.length;i++)t.charAt(i)==="<"&&i>n?e(r,1,n,n=i):t.charAt(i)===">"&&(t.charAt(n+1)==="/"?--s===0&&e(r++,2,n,i+1):t.charAt(i-1)!=="/"&&s++===0&&e(r,0,n,i+1),n=i+1);i>n&&e(r,1,n,i)}function oe(t,e,r,n=!1){return q([t],e,r,n).pop()}function q(t,e,r,n=!1){let i=[0];for(let s=1;s<e.length;s++){let o=e[s-1],a=e[s],u=o[o.length-1]>>>2&1023,c=a[0]>>>12;i.push(+(u>c)+i[i.length-1])}return t.map((s,o)=>{let a=0,u=new Map;for(let f of r.sort((g,l)=>g-l)){let g=f&1048575,l=f>>>20;if(i[l]!==o)continue;let m=u.get(l);typeof m=="undefined"&&u.set(l,m=[]),m.push(g)}if(u.size===0)return s;let c=[];for(let[f,g]of u){let l=e[f],m=l[0]>>>12,x=l[l.length-1]>>>12,v=l[l.length-1]>>>2&1023;n&&m>a&&c.push(s.slice(a,m));let d=s.slice(m,x+v);for(let y of g.sort((b,E)=>E-b)){let b=(l[y]>>>12)-m,E=(l[y]>>>2&1023)+b;d=[d.slice(0,b),"<mark>",d.slice(b,E),"</mark>",d.slice(E)].join("")}if(a=x+v,c.push(d)===2)break}return n&&a<s.length&&c.push(s.slice(a)),c.join("")})}function ae(t){let e=[];if(typeof t=="undefined")return e;let r=Array.isArray(t)?t:[t];for(let n=0;n<r.length;n++){let i=lunr.tokenizer.table,s=i.length;se(r[n],(o,a,u,c)=>{var f;switch(i[f=o+=s]||(i[f]=[]),a){case 0:case 2:i[o].push(u<<12|c-u<<2|a);break;case 1:let g=r[n].slice(u,c);W(g,lunr.tokenizer.separator,(l,m)=>{if(typeof lunr.segmenter!="undefined"){let x=g.slice(l,m);if(/^[MHIK]$/.test(lunr.segmenter.ctype_(x))){let v=lunr.segmenter.segment(x);for(let d=0,y=0;d<v.length;d++)i[o]||(i[o]=[]),i[o].push(u+l+y<<12|v[d].length<<2|a),e.push(new lunr.Token(v[d].toLowerCase(),{position:o<<20|i[o].length-1})),y+=v[d].length;return}}i[o].push(u+l<<12|m-l<<2|a),e.push(new lunr.Token(g.slice(l,m).toLowerCase(),{position:o<<20|i[o].length-1}))})}})}return e}function ue(t,e=r=>r){return t.trim().split(/"([^"]+)"/g).map((r,n)=>n&1?r.replace(/^\b|^(?![^\x00-\x7F]|$)|\s+/g," +"):r).join("").replace(/"|(?:^|\s+)[*+\-:^~]+(?=\s+|$)/g,"").split(/\s+/g).reduce((r,n)=>{let i=e(n);return[...r,...Array.isArray(i)?i:[i]]},[]).map(r=>/([~^]$)/.test(r)?`${r}1`:r).map(r=>/(^[+-]|[~^]\d+$)/.test(r)?r:`${r}*`).join(" ")}function ce(t){return ue(t,e=>{let r=[],n=new lunr.QueryLexer(e);n.run();for(let{type:i,str:s,start:o,end:a}of n.lexemes)switch(i){case"FIELD":["title","text","tags"].includes(s)||(e=[e.slice(0,a)," ",e.slice(a+1)].join(""));break;case"TERM":W(s,lunr.tokenizer.separator,(...u)=>{r.push([e.slice(0,o),s.slice(...u),e.slice(a)].join(""))})}return r})}function le(t){let e=new lunr.Query(["title","text","tags"]);new lunr.QueryParser(t,e).parse();for(let n of e.clauses)n.usePipeline=!0,n.term.startsWith("*")&&(n.wildcard=lunr.Query.wildcard.LEADING,n.term=n.term.slice(1)),n.term.endsWith("*")&&(n.wildcard=lunr.Query.wildcard.TRAILING,n.term=n.term.slice(0,-1));return e.clauses}function he(t,e){var i;let r=new Set(t),n={};for(let s=0;s<e.length;s++)for(let o of r)e[s].startsWith(o.term)&&(n[o.term]=!0,r.delete(o));for(let s of r)(i=lunr.stopWordFilter)!=null&&i.call(lunr,s.term)&&(n[s.term]=!1);return n}function fe(t,e){let r=new Set,n=new Uint16Array(t.length);for(let s=0;s<t.length;s++)for(let o=s+1;o<t.length;o++)t.slice(s,o)in e&&(n[s]=o-s);let i=[0];for(let s=i.length;s>0;){let o=i[--s];for(let u=1;u<n[o];u++)n[o+u]>n[o]-u&&(r.add(t.slice(o,o+u)),i[s++]=o+u);let a=o+n[o];n[a]&&a<t.length-1&&(i[s++]=a),r.add(t.slice(o,a))}return r.has("")?new Set([t]):r}function Oe(t){return e=>r=>{if(typeof r[e]=="undefined")return;let n=[r.location,e].join(":");return t.set(n,lunr.tokenizer.table=[]),r[e]}}function Re(t,e){let[r,n]=[new Set(t),new Set(e)];return[...new Set([...r].filter(i=>!n.has(i)))]}var H=class{constructor({config:e,docs:r,options:n}){let i=Oe(this.table=new Map);this.map=ie(r),this.options=n,this.index=lunr(function(){this.metadataWhitelist=["position"],this.b(0),e.lang.length===1&&e.lang[0]!=="en"?this.use(lunr[e.lang[0]]):e.lang.length>1&&this.use(lunr.multiLanguage(...e.lang)),this.tokenizer=ae,lunr.tokenizer.separator=new RegExp(e.separator),lunr.segmenter="TinySegmenter"in lunr?new lunr.TinySegmenter:void 0;let s=Re(["trimmer","stopWordFilter","stemmer"],e.pipeline);for(let o of e.lang.map(a=>a==="en"?lunr:lunr[a]))for(let a of s)this.pipeline.remove(o[a]),this.searchPipeline.remove(o[a]);this.ref("location"),this.field("title",{boost:1e3,extractor:i("title")}),this.field("text",{boost:1,extractor:i("text")}),this.field("tags",{boost:1e6,extractor:i("tags")});for(let o of r)this.add(o,{boost:o.boost})})}search(e){if(e=e.replace(new RegExp("\\p{sc=Han}+","gu"),s=>[...fe(s,this.index.invertedIndex)].join("* ")),e=ce(e),!e)return{items:[]};let r=le(e).filter(s=>s.presence!==lunr.Query.presence.PROHIBITED),n=this.index.search(e).reduce((s,{ref:o,score:a,matchData:u})=>{let c=this.map.get(o);if(typeof c!="undefined"){c=A({},c),c.tags&&(c.tags=[...c.tags]);let f=he(r,Object.keys(u.metadata));for(let l of this.index.fields){if(typeof c[l]=="undefined")continue;let m=[];for(let d of Object.values(u.metadata))typeof d[l]!="undefined"&&m.push(...d[l].position);if(!m.length)continue;let x=this.table.get([c.location,l].join(":")),v=Array.isArray(c[l])?q:oe;c[l]=v(c[l],x,m,l!=="text")}let g=+!c.parent+Object.values(f).filter(l=>l).length/Object.keys(f).length;s.push(G(A({},c),{score:a*(1+K(g,2)),terms:f}))}return s},[]).sort((s,o)=>o.score-s.score).reduce((s,o)=>{let a=this.map.get(o.location);if(typeof a!="undefined"){let u=a.parent?a.parent.location:a.location;s.set(u,[...s.get(u)||[],o])}return s},new Map);for(let[s,o]of n)if(!o.find(a=>a.location===s)){let a=this.map.get(s);o.push(G(A({},a),{score:0,terms:{}}))}let i;if(this.options.suggest){let s=this.index.query(o=>{for(let a of r)o.term(a.term,{fields:["title"],presence:lunr.Query.presence.REQUIRED,wildcard:lunr.Query.wildcard.TRAILING})});i=s.length?Object.keys(s[0].matchData.metadata):[]}return A({items:[...n.values()]},typeof i!="undefined"&&{suggest:i})}};var de;function Ie(t){return B(this,null,function*(){let e="../lunr";if(typeof parent!="undefined"&&"IFrameWorker"in parent){let n=ne("script[src]"),[i]=n.src.split("/worker");e=e.replace("..",i)}let r=[];for(let n of t.lang){switch(n){case"ja":r.push(`${e}/tinyseg.js`);break;case"hi":case"th":r.push(`${e}/wordcut.js`);break}n!=="en"&&r.push(`${e}/min/lunr.${n}.min.js`)}t.lang.length>1&&r.push(`${e}/min/lunr.multi.min.js`),r.length&&(yield importScripts(`${e}/min/lunr.stemmer.support.min.js`,...r))})}function Fe(t){return B(this,null,function*(){switch(t.type){case 0:return yield Ie(t.data.config),de=new H(t.data),{type:1};case 2:let e=t.data;try{return{type:3,data:de.search(e)}}catch(r){return console.warn(`Invalid query: ${e} \u2013 see https://bit.ly/2s3ChXG`),console.warn(r),{type:3,data:{items:[]}}}default:throw new TypeError("Invalid message type")}})}self.lunr=Y.default;Y.default.utils.warn=console.warn;addEventListener("message",t=>B(void 0,null,function*(){postMessage(yield Fe(t.data))}));})();
+//# sourceMappingURL=search.6ce7567c.min.js.map
+
diff --git a/latest/assets/javascripts/workers/search.6ce7567c.min.js.map b/latest/assets/javascripts/workers/search.6ce7567c.min.js.map
new file mode 100644
index 000000000..e7c69d215
--- /dev/null
+++ b/latest/assets/javascripts/workers/search.6ce7567c.min.js.map
@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["node_modules/lunr/lunr.js", "src/templates/assets/javascripts/integrations/search/worker/main/index.ts", "src/templates/assets/javascripts/browser/element/_/index.ts", "src/templates/assets/javascripts/polyfills/index.ts", "src/templates/assets/javascripts/integrations/search/config/index.ts", "src/templates/assets/javascripts/integrations/search/internal/_/index.ts", "src/templates/assets/javascripts/integrations/search/internal/extract/index.ts", "src/templates/assets/javascripts/integrations/search/internal/highlight/index.ts", "src/templates/assets/javascripts/integrations/search/internal/tokenize/index.ts", "src/templates/assets/javascripts/integrations/search/query/transform/index.ts", "src/templates/assets/javascripts/integrations/search/query/_/index.ts", "src/templates/assets/javascripts/integrations/search/query/segment/index.ts", "src/templates/assets/javascripts/integrations/search/_/index.ts"],
+  "sourcesContent": ["/**\n * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9\n * Copyright (C) 2020 Oliver Nightingale\n * @license MIT\n */\n\n;(function(){\n\n/**\n * A convenience function for configuring and constructing\n * a new lunr Index.\n *\n * A lunr.Builder instance is created and the pipeline setup\n * with a trimmer, stop word filter and stemmer.\n *\n * This builder object is yielded to the configuration function\n * that is passed as a parameter, allowing the list of fields\n * and other builder parameters to be customised.\n *\n * All documents _must_ be added within the passed config function.\n *\n * @example\n * var idx = lunr(function () {\n *   this.field('title')\n *   this.field('body')\n *   this.ref('id')\n *\n *   documents.forEach(function (doc) {\n *     this.add(doc)\n *   }, this)\n * })\n *\n * @see {@link lunr.Builder}\n * @see {@link lunr.Pipeline}\n * @see {@link lunr.trimmer}\n * @see {@link lunr.stopWordFilter}\n * @see {@link lunr.stemmer}\n * @namespace {function} lunr\n */\nvar lunr = function (config) {\n  var builder = new lunr.Builder\n\n  builder.pipeline.add(\n    lunr.trimmer,\n    lunr.stopWordFilter,\n    lunr.stemmer\n  )\n\n  builder.searchPipeline.add(\n    lunr.stemmer\n  )\n\n  config.call(builder, builder)\n  return builder.build()\n}\n\nlunr.version = \"2.3.9\"\n/*!\n * lunr.utils\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A namespace containing utils for the rest of the lunr library\n * @namespace lunr.utils\n */\nlunr.utils = {}\n\n/**\n * Print a warning message to the console.\n *\n * @param {String} message The message to be printed.\n * @memberOf lunr.utils\n * @function\n */\nlunr.utils.warn = (function (global) {\n  /* eslint-disable no-console */\n  return function (message) {\n    if (global.console && console.warn) {\n      console.warn(message)\n    }\n  }\n  /* eslint-enable no-console */\n})(this)\n\n/**\n * Convert an object to a string.\n *\n * In the case of `null` and `undefined` the function returns\n * the empty string, in all other cases the result of calling\n * `toString` on the passed object is returned.\n *\n * @param {Any} obj The object to convert to a string.\n * @return {String} string representation of the passed object.\n * @memberOf lunr.utils\n */\nlunr.utils.asString = function (obj) {\n  if (obj === void 0 || obj === null) {\n    return \"\"\n  } else {\n    return obj.toString()\n  }\n}\n\n/**\n * Clones an object.\n *\n * Will create a copy of an existing object such that any mutations\n * on the copy cannot affect the original.\n *\n * Only shallow objects are supported, passing a nested object to this\n * function will cause a TypeError.\n *\n * Objects with primitives, and arrays of primitives are supported.\n *\n * @param {Object} obj The object to clone.\n * @return {Object} a clone of the passed object.\n * @throws {TypeError} when a nested object is passed.\n * @memberOf Utils\n */\nlunr.utils.clone = function (obj) {\n  if (obj === null || obj === undefined) {\n    return obj\n  }\n\n  var clone = Object.create(null),\n      keys = Object.keys(obj)\n\n  for (var i = 0; i < keys.length; i++) {\n    var key = keys[i],\n        val = obj[key]\n\n    if (Array.isArray(val)) {\n      clone[key] = val.slice()\n      continue\n    }\n\n    if (typeof val === 'string' ||\n        typeof val === 'number' ||\n        typeof val === 'boolean') {\n      clone[key] = val\n      continue\n    }\n\n    throw new TypeError(\"clone is not deep and does not support nested objects\")\n  }\n\n  return clone\n}\nlunr.FieldRef = function (docRef, fieldName, stringValue) {\n  this.docRef = docRef\n  this.fieldName = fieldName\n  this._stringValue = stringValue\n}\n\nlunr.FieldRef.joiner = \"/\"\n\nlunr.FieldRef.fromString = function (s) {\n  var n = s.indexOf(lunr.FieldRef.joiner)\n\n  if (n === -1) {\n    throw \"malformed field ref string\"\n  }\n\n  var fieldRef = s.slice(0, n),\n      docRef = s.slice(n + 1)\n\n  return new lunr.FieldRef (docRef, fieldRef, s)\n}\n\nlunr.FieldRef.prototype.toString = function () {\n  if (this._stringValue == undefined) {\n    this._stringValue = this.fieldName + lunr.FieldRef.joiner + this.docRef\n  }\n\n  return this._stringValue\n}\n/*!\n * lunr.Set\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A lunr set.\n *\n * @constructor\n */\nlunr.Set = function (elements) {\n  this.elements = Object.create(null)\n\n  if (elements) {\n    this.length = elements.length\n\n    for (var i = 0; i < this.length; i++) {\n      this.elements[elements[i]] = true\n    }\n  } else {\n    this.length = 0\n  }\n}\n\n/**\n * A complete set that contains all elements.\n *\n * @static\n * @readonly\n * @type {lunr.Set}\n */\nlunr.Set.complete = {\n  intersect: function (other) {\n    return other\n  },\n\n  union: function () {\n    return this\n  },\n\n  contains: function () {\n    return true\n  }\n}\n\n/**\n * An empty set that contains no elements.\n *\n * @static\n * @readonly\n * @type {lunr.Set}\n */\nlunr.Set.empty = {\n  intersect: function () {\n    return this\n  },\n\n  union: function (other) {\n    return other\n  },\n\n  contains: function () {\n    return false\n  }\n}\n\n/**\n * Returns true if this set contains the specified object.\n *\n * @param {object} object - Object whose presence in this set is to be tested.\n * @returns {boolean} - True if this set contains the specified object.\n */\nlunr.Set.prototype.contains = function (object) {\n  return !!this.elements[object]\n}\n\n/**\n * Returns a new set containing only the elements that are present in both\n * this set and the specified set.\n *\n * @param {lunr.Set} other - set to intersect with this set.\n * @returns {lunr.Set} a new set that is the intersection of this and the specified set.\n */\n\nlunr.Set.prototype.intersect = function (other) {\n  var a, b, elements, intersection = []\n\n  if (other === lunr.Set.complete) {\n    return this\n  }\n\n  if (other === lunr.Set.empty) {\n    return other\n  }\n\n  if (this.length < other.length) {\n    a = this\n    b = other\n  } else {\n    a = other\n    b = this\n  }\n\n  elements = Object.keys(a.elements)\n\n  for (var i = 0; i < elements.length; i++) {\n    var element = elements[i]\n    if (element in b.elements) {\n      intersection.push(element)\n    }\n  }\n\n  return new lunr.Set (intersection)\n}\n\n/**\n * Returns a new set combining the elements of this and the specified set.\n *\n * @param {lunr.Set} other - set to union with this set.\n * @return {lunr.Set} a new set that is the union of this and the specified set.\n */\n\nlunr.Set.prototype.union = function (other) {\n  if (other === lunr.Set.complete) {\n    return lunr.Set.complete\n  }\n\n  if (other === lunr.Set.empty) {\n    return this\n  }\n\n  return new lunr.Set(Object.keys(this.elements).concat(Object.keys(other.elements)))\n}\n/**\n * A function to calculate the inverse document frequency for\n * a posting. This is shared between the builder and the index\n *\n * @private\n * @param {object} posting - The posting for a given term\n * @param {number} documentCount - The total number of documents.\n */\nlunr.idf = function (posting, documentCount) {\n  var documentsWithTerm = 0\n\n  for (var fieldName in posting) {\n    if (fieldName == '_index') continue // Ignore the term index, its not a field\n    documentsWithTerm += Object.keys(posting[fieldName]).length\n  }\n\n  var x = (documentCount - documentsWithTerm + 0.5) / (documentsWithTerm + 0.5)\n\n  return Math.log(1 + Math.abs(x))\n}\n\n/**\n * A token wraps a string representation of a token\n * as it is passed through the text processing pipeline.\n *\n * @constructor\n * @param {string} [str=''] - The string token being wrapped.\n * @param {object} [metadata={}] - Metadata associated with this token.\n */\nlunr.Token = function (str, metadata) {\n  this.str = str || \"\"\n  this.metadata = metadata || {}\n}\n\n/**\n * Returns the token string that is being wrapped by this object.\n *\n * @returns {string}\n */\nlunr.Token.prototype.toString = function () {\n  return this.str\n}\n\n/**\n * A token update function is used when updating or optionally\n * when cloning a token.\n *\n * @callback lunr.Token~updateFunction\n * @param {string} str - The string representation of the token.\n * @param {Object} metadata - All metadata associated with this token.\n */\n\n/**\n * Applies the given function to the wrapped string token.\n *\n * @example\n * token.update(function (str, metadata) {\n *   return str.toUpperCase()\n * })\n *\n * @param {lunr.Token~updateFunction} fn - A function to apply to the token string.\n * @returns {lunr.Token}\n */\nlunr.Token.prototype.update = function (fn) {\n  this.str = fn(this.str, this.metadata)\n  return this\n}\n\n/**\n * Creates a clone of this token. Optionally a function can be\n * applied to the cloned token.\n *\n * @param {lunr.Token~updateFunction} [fn] - An optional function to apply to the cloned token.\n * @returns {lunr.Token}\n */\nlunr.Token.prototype.clone = function (fn) {\n  fn = fn || function (s) { return s }\n  return new lunr.Token (fn(this.str, this.metadata), this.metadata)\n}\n/*!\n * lunr.tokenizer\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A function for splitting a string into tokens ready to be inserted into\n * the search index. Uses `lunr.tokenizer.separator` to split strings, change\n * the value of this property to change how strings are split into tokens.\n *\n * This tokenizer will convert its parameter to a string by calling `toString` and\n * then will split this string on the character in `lunr.tokenizer.separator`.\n * Arrays will have their elements converted to strings and wrapped in a lunr.Token.\n *\n * Optional metadata can be passed to the tokenizer, this metadata will be cloned and\n * added as metadata to every token that is created from the object to be tokenized.\n *\n * @static\n * @param {?(string|object|object[])} obj - The object to convert into tokens\n * @param {?object} metadata - Optional metadata to associate with every token\n * @returns {lunr.Token[]}\n * @see {@link lunr.Pipeline}\n */\nlunr.tokenizer = function (obj, metadata) {\n  if (obj == null || obj == undefined) {\n    return []\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map(function (t) {\n      return new lunr.Token(\n        lunr.utils.asString(t).toLowerCase(),\n        lunr.utils.clone(metadata)\n      )\n    })\n  }\n\n  var str = obj.toString().toLowerCase(),\n      len = str.length,\n      tokens = []\n\n  for (var sliceEnd = 0, sliceStart = 0; sliceEnd <= len; sliceEnd++) {\n    var char = str.charAt(sliceEnd),\n        sliceLength = sliceEnd - sliceStart\n\n    if ((char.match(lunr.tokenizer.separator) || sliceEnd == len)) {\n\n      if (sliceLength > 0) {\n        var tokenMetadata = lunr.utils.clone(metadata) || {}\n        tokenMetadata[\"position\"] = [sliceStart, sliceLength]\n        tokenMetadata[\"index\"] = tokens.length\n\n        tokens.push(\n          new lunr.Token (\n            str.slice(sliceStart, sliceEnd),\n            tokenMetadata\n          )\n        )\n      }\n\n      sliceStart = sliceEnd + 1\n    }\n\n  }\n\n  return tokens\n}\n\n/**\n * The separator used to split a string into tokens. Override this property to change the behaviour of\n * `lunr.tokenizer` behaviour when tokenizing strings. By default this splits on whitespace and hyphens.\n *\n * @static\n * @see lunr.tokenizer\n */\nlunr.tokenizer.separator = /[\\s\\-]+/\n/*!\n * lunr.Pipeline\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.Pipelines maintain an ordered list of functions to be applied to all\n * tokens in documents entering the search index and queries being ran against\n * the index.\n *\n * An instance of lunr.Index created with the lunr shortcut will contain a\n * pipeline with a stop word filter and an English language stemmer. Extra\n * functions can be added before or after either of these functions or these\n * default functions can be removed.\n *\n * When run the pipeline will call each function in turn, passing a token, the\n * index of that token in the original list of all tokens and finally a list of\n * all the original tokens.\n *\n * The output of functions in the pipeline will be passed to the next function\n * in the pipeline. To exclude a token from entering the index the function\n * should return undefined, the rest of the pipeline will not be called with\n * this token.\n *\n * For serialisation of pipelines to work, all functions used in an instance of\n * a pipeline should be registered with lunr.Pipeline. Registered functions can\n * then be loaded. If trying to load a serialised pipeline that uses functions\n * that are not registered an error will be thrown.\n *\n * If not planning on serialising the pipeline then registering pipeline functions\n * is not necessary.\n *\n * @constructor\n */\nlunr.Pipeline = function () {\n  this._stack = []\n}\n\nlunr.Pipeline.registeredFunctions = Object.create(null)\n\n/**\n * A pipeline function maps lunr.Token to lunr.Token. A lunr.Token contains the token\n * string as well as all known metadata. A pipeline function can mutate the token string\n * or mutate (or add) metadata for a given token.\n *\n * A pipeline function can indicate that the passed token should be discarded by returning\n * null, undefined or an empty string. This token will not be passed to any downstream pipeline\n * functions and will not be added to the index.\n *\n * Multiple tokens can be returned by returning an array of tokens. Each token will be passed\n * to any downstream pipeline functions and all will returned tokens will be added to the index.\n *\n * Any number of pipeline functions may be chained together using a lunr.Pipeline.\n *\n * @interface lunr.PipelineFunction\n * @param {lunr.Token} token - A token from the document being processed.\n * @param {number} i - The index of this token in the complete list of tokens for this document/field.\n * @param {lunr.Token[]} tokens - All tokens for this document/field.\n * @returns {(?lunr.Token|lunr.Token[])}\n */\n\n/**\n * Register a function with the pipeline.\n *\n * Functions that are used in the pipeline should be registered if the pipeline\n * needs to be serialised, or a serialised pipeline needs to be loaded.\n *\n * Registering a function does not add it to a pipeline, functions must still be\n * added to instances of the pipeline for them to be used when running a pipeline.\n *\n * @param {lunr.PipelineFunction} fn - The function to check for.\n * @param {String} label - The label to register this function with\n */\nlunr.Pipeline.registerFunction = function (fn, label) {\n  if (label in this.registeredFunctions) {\n    lunr.utils.warn('Overwriting existing registered function: ' + label)\n  }\n\n  fn.label = label\n  lunr.Pipeline.registeredFunctions[fn.label] = fn\n}\n\n/**\n * Warns if the function is not registered as a Pipeline function.\n *\n * @param {lunr.PipelineFunction} fn - The function to check for.\n * @private\n */\nlunr.Pipeline.warnIfFunctionNotRegistered = function (fn) {\n  var isRegistered = fn.label && (fn.label in this.registeredFunctions)\n\n  if (!isRegistered) {\n    lunr.utils.warn('Function is not registered with pipeline. This may cause problems when serialising the index.\\n', fn)\n  }\n}\n\n/**\n * Loads a previously serialised pipeline.\n *\n * All functions to be loaded must already be registered with lunr.Pipeline.\n * If any function from the serialised data has not been registered then an\n * error will be thrown.\n *\n * @param {Object} serialised - The serialised pipeline to load.\n * @returns {lunr.Pipeline}\n */\nlunr.Pipeline.load = function (serialised) {\n  var pipeline = new lunr.Pipeline\n\n  serialised.forEach(function (fnName) {\n    var fn = lunr.Pipeline.registeredFunctions[fnName]\n\n    if (fn) {\n      pipeline.add(fn)\n    } else {\n      throw new Error('Cannot load unregistered function: ' + fnName)\n    }\n  })\n\n  return pipeline\n}\n\n/**\n * Adds new functions to the end of the pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction[]} functions - Any number of functions to add to the pipeline.\n */\nlunr.Pipeline.prototype.add = function () {\n  var fns = Array.prototype.slice.call(arguments)\n\n  fns.forEach(function (fn) {\n    lunr.Pipeline.warnIfFunctionNotRegistered(fn)\n    this._stack.push(fn)\n  }, this)\n}\n\n/**\n * Adds a single function after a function that already exists in the\n * pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.\n * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.\n */\nlunr.Pipeline.prototype.after = function (existingFn, newFn) {\n  lunr.Pipeline.warnIfFunctionNotRegistered(newFn)\n\n  var pos = this._stack.indexOf(existingFn)\n  if (pos == -1) {\n    throw new Error('Cannot find existingFn')\n  }\n\n  pos = pos + 1\n  this._stack.splice(pos, 0, newFn)\n}\n\n/**\n * Adds a single function before a function that already exists in the\n * pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.\n * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.\n */\nlunr.Pipeline.prototype.before = function (existingFn, newFn) {\n  lunr.Pipeline.warnIfFunctionNotRegistered(newFn)\n\n  var pos = this._stack.indexOf(existingFn)\n  if (pos == -1) {\n    throw new Error('Cannot find existingFn')\n  }\n\n  this._stack.splice(pos, 0, newFn)\n}\n\n/**\n * Removes a function from the pipeline.\n *\n * @param {lunr.PipelineFunction} fn The function to remove from the pipeline.\n */\nlunr.Pipeline.prototype.remove = function (fn) {\n  var pos = this._stack.indexOf(fn)\n  if (pos == -1) {\n    return\n  }\n\n  this._stack.splice(pos, 1)\n}\n\n/**\n * Runs the current list of functions that make up the pipeline against the\n * passed tokens.\n *\n * @param {Array} tokens The tokens to run through the pipeline.\n * @returns {Array}\n */\nlunr.Pipeline.prototype.run = function (tokens) {\n  var stackLength = this._stack.length\n\n  for (var i = 0; i < stackLength; i++) {\n    var fn = this._stack[i]\n    var memo = []\n\n    for (var j = 0; j < tokens.length; j++) {\n      var result = fn(tokens[j], j, tokens)\n\n      if (result === null || result === void 0 || result === '') continue\n\n      if (Array.isArray(result)) {\n        for (var k = 0; k < result.length; k++) {\n          memo.push(result[k])\n        }\n      } else {\n        memo.push(result)\n      }\n    }\n\n    tokens = memo\n  }\n\n  return tokens\n}\n\n/**\n * Convenience method for passing a string through a pipeline and getting\n * strings out. This method takes care of wrapping the passed string in a\n * token and mapping the resulting tokens back to strings.\n *\n * @param {string} str - The string to pass through the pipeline.\n * @param {?object} metadata - Optional metadata to associate with the token\n * passed to the pipeline.\n * @returns {string[]}\n */\nlunr.Pipeline.prototype.runString = function (str, metadata) {\n  var token = new lunr.Token (str, metadata)\n\n  return this.run([token]).map(function (t) {\n    return t.toString()\n  })\n}\n\n/**\n * Resets the pipeline by removing any existing processors.\n *\n */\nlunr.Pipeline.prototype.reset = function () {\n  this._stack = []\n}\n\n/**\n * Returns a representation of the pipeline ready for serialisation.\n *\n * Logs a warning if the function has not been registered.\n *\n * @returns {Array}\n */\nlunr.Pipeline.prototype.toJSON = function () {\n  return this._stack.map(function (fn) {\n    lunr.Pipeline.warnIfFunctionNotRegistered(fn)\n\n    return fn.label\n  })\n}\n/*!\n * lunr.Vector\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A vector is used to construct the vector space of documents and queries. These\n * vectors support operations to determine the similarity between two documents or\n * a document and a query.\n *\n * Normally no parameters are required for initializing a vector, but in the case of\n * loading a previously dumped vector the raw elements can be provided to the constructor.\n *\n * For performance reasons vectors are implemented with a flat array, where an elements\n * index is immediately followed by its value. E.g. [index, value, index, value]. This\n * allows the underlying array to be as sparse as possible and still offer decent\n * performance when being used for vector calculations.\n *\n * @constructor\n * @param {Number[]} [elements] - The flat list of element index and element value pairs.\n */\nlunr.Vector = function (elements) {\n  this._magnitude = 0\n  this.elements = elements || []\n}\n\n\n/**\n * Calculates the position within the vector to insert a given index.\n *\n * This is used internally by insert and upsert. If there are duplicate indexes then\n * the position is returned as if the value for that index were to be updated, but it\n * is the callers responsibility to check whether there is a duplicate at that index\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @returns {Number}\n */\nlunr.Vector.prototype.positionForIndex = function (index) {\n  // For an empty vector the tuple can be inserted at the beginning\n  if (this.elements.length == 0) {\n    return 0\n  }\n\n  var start = 0,\n      end = this.elements.length / 2,\n      sliceLength = end - start,\n      pivotPoint = Math.floor(sliceLength / 2),\n      pivotIndex = this.elements[pivotPoint * 2]\n\n  while (sliceLength > 1) {\n    if (pivotIndex < index) {\n      start = pivotPoint\n    }\n\n    if (pivotIndex > index) {\n      end = pivotPoint\n    }\n\n    if (pivotIndex == index) {\n      break\n    }\n\n    sliceLength = end - start\n    pivotPoint = start + Math.floor(sliceLength / 2)\n    pivotIndex = this.elements[pivotPoint * 2]\n  }\n\n  if (pivotIndex == index) {\n    return pivotPoint * 2\n  }\n\n  if (pivotIndex > index) {\n    return pivotPoint * 2\n  }\n\n  if (pivotIndex < index) {\n    return (pivotPoint + 1) * 2\n  }\n}\n\n/**\n * Inserts an element at an index within the vector.\n *\n * Does not allow duplicates, will throw an error if there is already an entry\n * for this index.\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @param {Number} val - The value to be inserted into the vector.\n */\nlunr.Vector.prototype.insert = function (insertIdx, val) {\n  this.upsert(insertIdx, val, function () {\n    throw \"duplicate index\"\n  })\n}\n\n/**\n * Inserts or updates an existing index within the vector.\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @param {Number} val - The value to be inserted into the vector.\n * @param {function} fn - A function that is called for updates, the existing value and the\n * requested value are passed as arguments\n */\nlunr.Vector.prototype.upsert = function (insertIdx, val, fn) {\n  this._magnitude = 0\n  var position = this.positionForIndex(insertIdx)\n\n  if (this.elements[position] == insertIdx) {\n    this.elements[position + 1] = fn(this.elements[position + 1], val)\n  } else {\n    this.elements.splice(position, 0, insertIdx, val)\n  }\n}\n\n/**\n * Calculates the magnitude of this vector.\n *\n * @returns {Number}\n */\nlunr.Vector.prototype.magnitude = function () {\n  if (this._magnitude) return this._magnitude\n\n  var sumOfSquares = 0,\n      elementsLength = this.elements.length\n\n  for (var i = 1; i < elementsLength; i += 2) {\n    var val = this.elements[i]\n    sumOfSquares += val * val\n  }\n\n  return this._magnitude = Math.sqrt(sumOfSquares)\n}\n\n/**\n * Calculates the dot product of this vector and another vector.\n *\n * @param {lunr.Vector} otherVector - The vector to compute the dot product with.\n * @returns {Number}\n */\nlunr.Vector.prototype.dot = function (otherVector) {\n  var dotProduct = 0,\n      a = this.elements, b = otherVector.elements,\n      aLen = a.length, bLen = b.length,\n      aVal = 0, bVal = 0,\n      i = 0, j = 0\n\n  while (i < aLen && j < bLen) {\n    aVal = a[i], bVal = b[j]\n    if (aVal < bVal) {\n      i += 2\n    } else if (aVal > bVal) {\n      j += 2\n    } else if (aVal == bVal) {\n      dotProduct += a[i + 1] * b[j + 1]\n      i += 2\n      j += 2\n    }\n  }\n\n  return dotProduct\n}\n\n/**\n * Calculates the similarity between this vector and another vector.\n *\n * @param {lunr.Vector} otherVector - The other vector to calculate the\n * similarity with.\n * @returns {Number}\n */\nlunr.Vector.prototype.similarity = function (otherVector) {\n  return this.dot(otherVector) / this.magnitude() || 0\n}\n\n/**\n * Converts the vector to an array of the elements within the vector.\n *\n * @returns {Number[]}\n */\nlunr.Vector.prototype.toArray = function () {\n  var output = new Array (this.elements.length / 2)\n\n  for (var i = 1, j = 0; i < this.elements.length; i += 2, j++) {\n    output[j] = this.elements[i]\n  }\n\n  return output\n}\n\n/**\n * A JSON serializable representation of the vector.\n *\n * @returns {Number[]}\n */\nlunr.Vector.prototype.toJSON = function () {\n  return this.elements\n}\n/* eslint-disable */\n/*!\n * lunr.stemmer\n * Copyright (C) 2020 Oliver Nightingale\n * Includes code from - http://tartarus.org/~martin/PorterStemmer/js.txt\n */\n\n/**\n * lunr.stemmer is an english language stemmer, this is a JavaScript\n * implementation of the PorterStemmer taken from http://tartarus.org/~martin\n *\n * @static\n * @implements {lunr.PipelineFunction}\n * @param {lunr.Token} token - The string to stem\n * @returns {lunr.Token}\n * @see {@link lunr.Pipeline}\n * @function\n */\nlunr.stemmer = (function(){\n  var step2list = {\n      \"ational\" : \"ate\",\n      \"tional\" : \"tion\",\n      \"enci\" : \"ence\",\n      \"anci\" : \"ance\",\n      \"izer\" : \"ize\",\n      \"bli\" : \"ble\",\n      \"alli\" : \"al\",\n      \"entli\" : \"ent\",\n      \"eli\" : \"e\",\n      \"ousli\" : \"ous\",\n      \"ization\" : \"ize\",\n      \"ation\" : \"ate\",\n      \"ator\" : \"ate\",\n      \"alism\" : \"al\",\n      \"iveness\" : \"ive\",\n      \"fulness\" : \"ful\",\n      \"ousness\" : \"ous\",\n      \"aliti\" : \"al\",\n      \"iviti\" : \"ive\",\n      \"biliti\" : \"ble\",\n      \"logi\" : \"log\"\n    },\n\n    step3list = {\n      \"icate\" : \"ic\",\n      \"ative\" : \"\",\n      \"alize\" : \"al\",\n      \"iciti\" : \"ic\",\n      \"ical\" : \"ic\",\n      \"ful\" : \"\",\n      \"ness\" : \"\"\n    },\n\n    c = \"[^aeiou]\",          // consonant\n    v = \"[aeiouy]\",          // vowel\n    C = c + \"[^aeiouy]*\",    // consonant sequence\n    V = v + \"[aeiou]*\",      // vowel sequence\n\n    mgr0 = \"^(\" + C + \")?\" + V + C,               // [C]VC... is m>0\n    meq1 = \"^(\" + C + \")?\" + V + C + \"(\" + V + \")?$\",  // [C]VC[V] is m=1\n    mgr1 = \"^(\" + C + \")?\" + V + C + V + C,       // [C]VCVC... is m>1\n    s_v = \"^(\" + C + \")?\" + v;                   // vowel in stem\n\n  var re_mgr0 = new RegExp(mgr0);\n  var re_mgr1 = new RegExp(mgr1);\n  var re_meq1 = new RegExp(meq1);\n  var re_s_v = new RegExp(s_v);\n\n  var re_1a = /^(.+?)(ss|i)es$/;\n  var re2_1a = /^(.+?)([^s])s$/;\n  var re_1b = /^(.+?)eed$/;\n  var re2_1b = /^(.+?)(ed|ing)$/;\n  var re_1b_2 = /.$/;\n  var re2_1b_2 = /(at|bl|iz)$/;\n  var re3_1b_2 = new RegExp(\"([^aeiouylsz])\\\\1$\");\n  var re4_1b_2 = new RegExp(\"^\" + C + v + \"[^aeiouwxy]$\");\n\n  var re_1c = /^(.+?[^aeiou])y$/;\n  var re_2 = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;\n\n  var re_3 = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;\n\n  var re_4 = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;\n  var re2_4 = /^(.+?)(s|t)(ion)$/;\n\n  var re_5 = /^(.+?)e$/;\n  var re_5_1 = /ll$/;\n  var re3_5 = new RegExp(\"^\" + C + v + \"[^aeiouwxy]$\");\n\n  var porterStemmer = function porterStemmer(w) {\n    var stem,\n      suffix,\n      firstch,\n      re,\n      re2,\n      re3,\n      re4;\n\n    if (w.length < 3) { return w; }\n\n    firstch = w.substr(0,1);\n    if (firstch == \"y\") {\n      w = firstch.toUpperCase() + w.substr(1);\n    }\n\n    // Step 1a\n    re = re_1a\n    re2 = re2_1a;\n\n    if (re.test(w)) { w = w.replace(re,\"$1$2\"); }\n    else if (re2.test(w)) { w = w.replace(re2,\"$1$2\"); }\n\n    // Step 1b\n    re = re_1b;\n    re2 = re2_1b;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      re = re_mgr0;\n      if (re.test(fp[1])) {\n        re = re_1b_2;\n        w = w.replace(re,\"\");\n      }\n    } else if (re2.test(w)) {\n      var fp = re2.exec(w);\n      stem = fp[1];\n      re2 = re_s_v;\n      if (re2.test(stem)) {\n        w = stem;\n        re2 = re2_1b_2;\n        re3 = re3_1b_2;\n        re4 = re4_1b_2;\n        if (re2.test(w)) { w = w + \"e\"; }\n        else if (re3.test(w)) { re = re_1b_2; w = w.replace(re,\"\"); }\n        else if (re4.test(w)) { w = w + \"e\"; }\n      }\n    }\n\n    // Step 1c - replace suffix y or Y by i if preceded by a non-vowel which is not the first letter of the word (so cry -> cri, by -> by, say -> say)\n    re = re_1c;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      w = stem + \"i\";\n    }\n\n    // Step 2\n    re = re_2;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      suffix = fp[2];\n      re = re_mgr0;\n      if (re.test(stem)) {\n        w = stem + step2list[suffix];\n      }\n    }\n\n    // Step 3\n    re = re_3;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      suffix = fp[2];\n      re = re_mgr0;\n      if (re.test(stem)) {\n        w = stem + step3list[suffix];\n      }\n    }\n\n    // Step 4\n    re = re_4;\n    re2 = re2_4;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      re = re_mgr1;\n      if (re.test(stem)) {\n        w = stem;\n      }\n    } else if (re2.test(w)) {\n      var fp = re2.exec(w);\n      stem = fp[1] + fp[2];\n      re2 = re_mgr1;\n      if (re2.test(stem)) {\n        w = stem;\n      }\n    }\n\n    // Step 5\n    re = re_5;\n    if (re.test(w)) {\n      var fp = re.exec(w);\n      stem = fp[1];\n      re = re_mgr1;\n      re2 = re_meq1;\n      re3 = re3_5;\n      if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) {\n        w = stem;\n      }\n    }\n\n    re = re_5_1;\n    re2 = re_mgr1;\n    if (re.test(w) && re2.test(w)) {\n      re = re_1b_2;\n      w = w.replace(re,\"\");\n    }\n\n    // and turn initial Y back to y\n\n    if (firstch == \"y\") {\n      w = firstch.toLowerCase() + w.substr(1);\n    }\n\n    return w;\n  };\n\n  return function (token) {\n    return token.update(porterStemmer);\n  }\n})();\n\nlunr.Pipeline.registerFunction(lunr.stemmer, 'stemmer')\n/*!\n * lunr.stopWordFilter\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.generateStopWordFilter builds a stopWordFilter function from the provided\n * list of stop words.\n *\n * The built in lunr.stopWordFilter is built using this generator and can be used\n * to generate custom stopWordFilters for applications or non English languages.\n *\n * @function\n * @param {Array} token The token to pass through the filter\n * @returns {lunr.PipelineFunction}\n * @see lunr.Pipeline\n * @see lunr.stopWordFilter\n */\nlunr.generateStopWordFilter = function (stopWords) {\n  var words = stopWords.reduce(function (memo, stopWord) {\n    memo[stopWord] = stopWord\n    return memo\n  }, {})\n\n  return function (token) {\n    if (token && words[token.toString()] !== token.toString()) return token\n  }\n}\n\n/**\n * lunr.stopWordFilter is an English language stop word list filter, any words\n * contained in the list will not be passed through the filter.\n *\n * This is intended to be used in the Pipeline. If the token does not pass the\n * filter then undefined will be returned.\n *\n * @function\n * @implements {lunr.PipelineFunction}\n * @params {lunr.Token} token - A token to check for being a stop word.\n * @returns {lunr.Token}\n * @see {@link lunr.Pipeline}\n */\nlunr.stopWordFilter = lunr.generateStopWordFilter([\n  'a',\n  'able',\n  'about',\n  'across',\n  'after',\n  'all',\n  'almost',\n  'also',\n  'am',\n  'among',\n  'an',\n  'and',\n  'any',\n  'are',\n  'as',\n  'at',\n  'be',\n  'because',\n  'been',\n  'but',\n  'by',\n  'can',\n  'cannot',\n  'could',\n  'dear',\n  'did',\n  'do',\n  'does',\n  'either',\n  'else',\n  'ever',\n  'every',\n  'for',\n  'from',\n  'get',\n  'got',\n  'had',\n  'has',\n  'have',\n  'he',\n  'her',\n  'hers',\n  'him',\n  'his',\n  'how',\n  'however',\n  'i',\n  'if',\n  'in',\n  'into',\n  'is',\n  'it',\n  'its',\n  'just',\n  'least',\n  'let',\n  'like',\n  'likely',\n  'may',\n  'me',\n  'might',\n  'most',\n  'must',\n  'my',\n  'neither',\n  'no',\n  'nor',\n  'not',\n  'of',\n  'off',\n  'often',\n  'on',\n  'only',\n  'or',\n  'other',\n  'our',\n  'own',\n  'rather',\n  'said',\n  'say',\n  'says',\n  'she',\n  'should',\n  'since',\n  'so',\n  'some',\n  'than',\n  'that',\n  'the',\n  'their',\n  'them',\n  'then',\n  'there',\n  'these',\n  'they',\n  'this',\n  'tis',\n  'to',\n  'too',\n  'twas',\n  'us',\n  'wants',\n  'was',\n  'we',\n  'were',\n  'what',\n  'when',\n  'where',\n  'which',\n  'while',\n  'who',\n  'whom',\n  'why',\n  'will',\n  'with',\n  'would',\n  'yet',\n  'you',\n  'your'\n])\n\nlunr.Pipeline.registerFunction(lunr.stopWordFilter, 'stopWordFilter')\n/*!\n * lunr.trimmer\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.trimmer is a pipeline function for trimming non word\n * characters from the beginning and end of tokens before they\n * enter the index.\n *\n * This implementation may not work correctly for non latin\n * characters and should either be removed or adapted for use\n * with languages with non-latin characters.\n *\n * @static\n * @implements {lunr.PipelineFunction}\n * @param {lunr.Token} token The token to pass through the filter\n * @returns {lunr.Token}\n * @see lunr.Pipeline\n */\nlunr.trimmer = function (token) {\n  return token.update(function (s) {\n    return s.replace(/^\\W+/, '').replace(/\\W+$/, '')\n  })\n}\n\nlunr.Pipeline.registerFunction(lunr.trimmer, 'trimmer')\n/*!\n * lunr.TokenSet\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A token set is used to store the unique list of all tokens\n * within an index. Token sets are also used to represent an\n * incoming query to the index, this query token set and index\n * token set are then intersected to find which tokens to look\n * up in the inverted index.\n *\n * A token set can hold multiple tokens, as in the case of the\n * index token set, or it can hold a single token as in the\n * case of a simple query token set.\n *\n * Additionally token sets are used to perform wildcard matching.\n * Leading, contained and trailing wildcards are supported, and\n * from this edit distance matching can also be provided.\n *\n * Token sets are implemented as a minimal finite state automata,\n * where both common prefixes and suffixes are shared between tokens.\n * This helps to reduce the space used for storing the token set.\n *\n * @constructor\n */\nlunr.TokenSet = function () {\n  this.final = false\n  this.edges = {}\n  this.id = lunr.TokenSet._nextId\n  lunr.TokenSet._nextId += 1\n}\n\n/**\n * Keeps track of the next, auto increment, identifier to assign\n * to a new tokenSet.\n *\n * TokenSets require a unique identifier to be correctly minimised.\n *\n * @private\n */\nlunr.TokenSet._nextId = 1\n\n/**\n * Creates a TokenSet instance from the given sorted array of words.\n *\n * @param {String[]} arr - A sorted array of strings to create the set from.\n * @returns {lunr.TokenSet}\n * @throws Will throw an error if the input array is not sorted.\n */\nlunr.TokenSet.fromArray = function (arr) {\n  var builder = new lunr.TokenSet.Builder\n\n  for (var i = 0, len = arr.length; i < len; i++) {\n    builder.insert(arr[i])\n  }\n\n  builder.finish()\n  return builder.root\n}\n\n/**\n * Creates a token set from a query clause.\n *\n * @private\n * @param {Object} clause - A single clause from lunr.Query.\n * @param {string} clause.term - The query clause term.\n * @param {number} [clause.editDistance] - The optional edit distance for the term.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.fromClause = function (clause) {\n  if ('editDistance' in clause) {\n    return lunr.TokenSet.fromFuzzyString(clause.term, clause.editDistance)\n  } else {\n    return lunr.TokenSet.fromString(clause.term)\n  }\n}\n\n/**\n * Creates a token set representing a single string with a specified\n * edit distance.\n *\n * Insertions, deletions, substitutions and transpositions are each\n * treated as an edit distance of 1.\n *\n * Increasing the allowed edit distance will have a dramatic impact\n * on the performance of both creating and intersecting these TokenSets.\n * It is advised to keep the edit distance less than 3.\n *\n * @param {string} str - The string to create the token set from.\n * @param {number} editDistance - The allowed edit distance to match.\n * @returns {lunr.Vector}\n */\nlunr.TokenSet.fromFuzzyString = function (str, editDistance) {\n  var root = new lunr.TokenSet\n\n  var stack = [{\n    node: root,\n    editsRemaining: editDistance,\n    str: str\n  }]\n\n  while (stack.length) {\n    var frame = stack.pop()\n\n    // no edit\n    if (frame.str.length > 0) {\n      var char = frame.str.charAt(0),\n          noEditNode\n\n      if (char in frame.node.edges) {\n        noEditNode = frame.node.edges[char]\n      } else {\n        noEditNode = new lunr.TokenSet\n        frame.node.edges[char] = noEditNode\n      }\n\n      if (frame.str.length == 1) {\n        noEditNode.final = true\n      }\n\n      stack.push({\n        node: noEditNode,\n        editsRemaining: frame.editsRemaining,\n        str: frame.str.slice(1)\n      })\n    }\n\n    if (frame.editsRemaining == 0) {\n      continue\n    }\n\n    // insertion\n    if (\"*\" in frame.node.edges) {\n      var insertionNode = frame.node.edges[\"*\"]\n    } else {\n      var insertionNode = new lunr.TokenSet\n      frame.node.edges[\"*\"] = insertionNode\n    }\n\n    if (frame.str.length == 0) {\n      insertionNode.final = true\n    }\n\n    stack.push({\n      node: insertionNode,\n      editsRemaining: frame.editsRemaining - 1,\n      str: frame.str\n    })\n\n    // deletion\n    // can only do a deletion if we have enough edits remaining\n    // and if there are characters left to delete in the string\n    if (frame.str.length > 1) {\n      stack.push({\n        node: frame.node,\n        editsRemaining: frame.editsRemaining - 1,\n        str: frame.str.slice(1)\n      })\n    }\n\n    // deletion\n    // just removing the last character from the str\n    if (frame.str.length == 1) {\n      frame.node.final = true\n    }\n\n    // substitution\n    // can only do a substitution if we have enough edits remaining\n    // and if there are characters left to substitute\n    if (frame.str.length >= 1) {\n      if (\"*\" in frame.node.edges) {\n        var substitutionNode = frame.node.edges[\"*\"]\n      } else {\n        var substitutionNode = new lunr.TokenSet\n        frame.node.edges[\"*\"] = substitutionNode\n      }\n\n      if (frame.str.length == 1) {\n        substitutionNode.final = true\n      }\n\n      stack.push({\n        node: substitutionNode,\n        editsRemaining: frame.editsRemaining - 1,\n        str: frame.str.slice(1)\n      })\n    }\n\n    // transposition\n    // can only do a transposition if there are edits remaining\n    // and there are enough characters to transpose\n    if (frame.str.length > 1) {\n      var charA = frame.str.charAt(0),\n          charB = frame.str.charAt(1),\n          transposeNode\n\n      if (charB in frame.node.edges) {\n        transposeNode = frame.node.edges[charB]\n      } else {\n        transposeNode = new lunr.TokenSet\n        frame.node.edges[charB] = transposeNode\n      }\n\n      if (frame.str.length == 1) {\n        transposeNode.final = true\n      }\n\n      stack.push({\n        node: transposeNode,\n        editsRemaining: frame.editsRemaining - 1,\n        str: charA + frame.str.slice(2)\n      })\n    }\n  }\n\n  return root\n}\n\n/**\n * Creates a TokenSet from a string.\n *\n * The string may contain one or more wildcard characters (*)\n * that will allow wildcard matching when intersecting with\n * another TokenSet.\n *\n * @param {string} str - The string to create a TokenSet from.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.fromString = function (str) {\n  var node = new lunr.TokenSet,\n      root = node\n\n  /*\n   * Iterates through all characters within the passed string\n   * appending a node for each character.\n   *\n   * When a wildcard character is found then a self\n   * referencing edge is introduced to continually match\n   * any number of any characters.\n   */\n  for (var i = 0, len = str.length; i < len; i++) {\n    var char = str[i],\n        final = (i == len - 1)\n\n    if (char == \"*\") {\n      node.edges[char] = node\n      node.final = final\n\n    } else {\n      var next = new lunr.TokenSet\n      next.final = final\n\n      node.edges[char] = next\n      node = next\n    }\n  }\n\n  return root\n}\n\n/**\n * Converts this TokenSet into an array of strings\n * contained within the TokenSet.\n *\n * This is not intended to be used on a TokenSet that\n * contains wildcards, in these cases the results are\n * undefined and are likely to cause an infinite loop.\n *\n * @returns {string[]}\n */\nlunr.TokenSet.prototype.toArray = function () {\n  var words = []\n\n  var stack = [{\n    prefix: \"\",\n    node: this\n  }]\n\n  while (stack.length) {\n    var frame = stack.pop(),\n        edges = Object.keys(frame.node.edges),\n        len = edges.length\n\n    if (frame.node.final) {\n      /* In Safari, at this point the prefix is sometimes corrupted, see:\n       * https://github.com/olivernn/lunr.js/issues/279 Calling any\n       * String.prototype method forces Safari to \"cast\" this string to what\n       * it's supposed to be, fixing the bug. */\n      frame.prefix.charAt(0)\n      words.push(frame.prefix)\n    }\n\n    for (var i = 0; i < len; i++) {\n      var edge = edges[i]\n\n      stack.push({\n        prefix: frame.prefix.concat(edge),\n        node: frame.node.edges[edge]\n      })\n    }\n  }\n\n  return words\n}\n\n/**\n * Generates a string representation of a TokenSet.\n *\n * This is intended to allow TokenSets to be used as keys\n * in objects, largely to aid the construction and minimisation\n * of a TokenSet. As such it is not designed to be a human\n * friendly representation of the TokenSet.\n *\n * @returns {string}\n */\nlunr.TokenSet.prototype.toString = function () {\n  // NOTE: Using Object.keys here as this.edges is very likely\n  // to enter 'hash-mode' with many keys being added\n  //\n  // avoiding a for-in loop here as it leads to the function\n  // being de-optimised (at least in V8). From some simple\n  // benchmarks the performance is comparable, but allowing\n  // V8 to optimize may mean easy performance wins in the future.\n\n  if (this._str) {\n    return this._str\n  }\n\n  var str = this.final ? '1' : '0',\n      labels = Object.keys(this.edges).sort(),\n      len = labels.length\n\n  for (var i = 0; i < len; i++) {\n    var label = labels[i],\n        node = this.edges[label]\n\n    str = str + label + node.id\n  }\n\n  return str\n}\n\n/**\n * Returns a new TokenSet that is the intersection of\n * this TokenSet and the passed TokenSet.\n *\n * This intersection will take into account any wildcards\n * contained within the TokenSet.\n *\n * @param {lunr.TokenSet} b - An other TokenSet to intersect with.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.prototype.intersect = function (b) {\n  var output = new lunr.TokenSet,\n      frame = undefined\n\n  var stack = [{\n    qNode: b,\n    output: output,\n    node: this\n  }]\n\n  while (stack.length) {\n    frame = stack.pop()\n\n    // NOTE: As with the #toString method, we are using\n    // Object.keys and a for loop instead of a for-in loop\n    // as both of these objects enter 'hash' mode, causing\n    // the function to be de-optimised in V8\n    var qEdges = Object.keys(frame.qNode.edges),\n        qLen = qEdges.length,\n        nEdges = Object.keys(frame.node.edges),\n        nLen = nEdges.length\n\n    for (var q = 0; q < qLen; q++) {\n      var qEdge = qEdges[q]\n\n      for (var n = 0; n < nLen; n++) {\n        var nEdge = nEdges[n]\n\n        if (nEdge == qEdge || qEdge == '*') {\n          var node = frame.node.edges[nEdge],\n              qNode = frame.qNode.edges[qEdge],\n              final = node.final && qNode.final,\n              next = undefined\n\n          if (nEdge in frame.output.edges) {\n            // an edge already exists for this character\n            // no need to create a new node, just set the finality\n            // bit unless this node is already final\n            next = frame.output.edges[nEdge]\n            next.final = next.final || final\n\n          } else {\n            // no edge exists yet, must create one\n            // set the finality bit and insert it\n            // into the output\n            next = new lunr.TokenSet\n            next.final = final\n            frame.output.edges[nEdge] = next\n          }\n\n          stack.push({\n            qNode: qNode,\n            output: next,\n            node: node\n          })\n        }\n      }\n    }\n  }\n\n  return output\n}\nlunr.TokenSet.Builder = function () {\n  this.previousWord = \"\"\n  this.root = new lunr.TokenSet\n  this.uncheckedNodes = []\n  this.minimizedNodes = {}\n}\n\nlunr.TokenSet.Builder.prototype.insert = function (word) {\n  var node,\n      commonPrefix = 0\n\n  if (word < this.previousWord) {\n    throw new Error (\"Out of order word insertion\")\n  }\n\n  for (var i = 0; i < word.length && i < this.previousWord.length; i++) {\n    if (word[i] != this.previousWord[i]) break\n    commonPrefix++\n  }\n\n  this.minimize(commonPrefix)\n\n  if (this.uncheckedNodes.length == 0) {\n    node = this.root\n  } else {\n    node = this.uncheckedNodes[this.uncheckedNodes.length - 1].child\n  }\n\n  for (var i = commonPrefix; i < word.length; i++) {\n    var nextNode = new lunr.TokenSet,\n        char = word[i]\n\n    node.edges[char] = nextNode\n\n    this.uncheckedNodes.push({\n      parent: node,\n      char: char,\n      child: nextNode\n    })\n\n    node = nextNode\n  }\n\n  node.final = true\n  this.previousWord = word\n}\n\nlunr.TokenSet.Builder.prototype.finish = function () {\n  this.minimize(0)\n}\n\nlunr.TokenSet.Builder.prototype.minimize = function (downTo) {\n  for (var i = this.uncheckedNodes.length - 1; i >= downTo; i--) {\n    var node = this.uncheckedNodes[i],\n        childKey = node.child.toString()\n\n    if (childKey in this.minimizedNodes) {\n      node.parent.edges[node.char] = this.minimizedNodes[childKey]\n    } else {\n      // Cache the key for this node since\n      // we know it can't change anymore\n      node.child._str = childKey\n\n      this.minimizedNodes[childKey] = node.child\n    }\n\n    this.uncheckedNodes.pop()\n  }\n}\n/*!\n * lunr.Index\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * An index contains the built index of all documents and provides a query interface\n * to the index.\n *\n * Usually instances of lunr.Index will not be created using this constructor, instead\n * lunr.Builder should be used to construct new indexes, or lunr.Index.load should be\n * used to load previously built and serialized indexes.\n *\n * @constructor\n * @param {Object} attrs - The attributes of the built search index.\n * @param {Object} attrs.invertedIndex - An index of term/field to document reference.\n * @param {Object<string, lunr.Vector>} attrs.fieldVectors - Field vectors\n * @param {lunr.TokenSet} attrs.tokenSet - An set of all corpus tokens.\n * @param {string[]} attrs.fields - The names of indexed document fields.\n * @param {lunr.Pipeline} attrs.pipeline - The pipeline to use for search terms.\n */\nlunr.Index = function (attrs) {\n  this.invertedIndex = attrs.invertedIndex\n  this.fieldVectors = attrs.fieldVectors\n  this.tokenSet = attrs.tokenSet\n  this.fields = attrs.fields\n  this.pipeline = attrs.pipeline\n}\n\n/**\n * A result contains details of a document matching a search query.\n * @typedef {Object} lunr.Index~Result\n * @property {string} ref - The reference of the document this result represents.\n * @property {number} score - A number between 0 and 1 representing how similar this document is to the query.\n * @property {lunr.MatchData} matchData - Contains metadata about this match including which term(s) caused the match.\n */\n\n/**\n * Although lunr provides the ability to create queries using lunr.Query, it also provides a simple\n * query language which itself is parsed into an instance of lunr.Query.\n *\n * For programmatically building queries it is advised to directly use lunr.Query, the query language\n * is best used for human entered text rather than program generated text.\n *\n * At its simplest queries can just be a single term, e.g. `hello`, multiple terms are also supported\n * and will be combined with OR, e.g `hello world` will match documents that contain either 'hello'\n * or 'world', though those that contain both will rank higher in the results.\n *\n * Wildcards can be included in terms to match one or more unspecified characters, these wildcards can\n * be inserted anywhere within the term, and more than one wildcard can exist in a single term. Adding\n * wildcards will increase the number of documents that will be found but can also have a negative\n * impact on query performance, especially with wildcards at the beginning of a term.\n *\n * Terms can be restricted to specific fields, e.g. `title:hello`, only documents with the term\n * hello in the title field will match this query. Using a field not present in the index will lead\n * to an error being thrown.\n *\n * Modifiers can also be added to terms, lunr supports edit distance and boost modifiers on terms. A term\n * boost will make documents matching that term score higher, e.g. `foo^5`. Edit distance is also supported\n * to provide fuzzy matching, e.g. 'hello~2' will match documents with hello with an edit distance of 2.\n * Avoid large values for edit distance to improve query performance.\n *\n * Each term also supports a presence modifier. By default a term's presence in document is optional, however\n * this can be changed to either required or prohibited. For a term's presence to be required in a document the\n * term should be prefixed with a '+', e.g. `+foo bar` is a search for documents that must contain 'foo' and\n * optionally contain 'bar'. Conversely a leading '-' sets the terms presence to prohibited, i.e. it must not\n * appear in a document, e.g. `-foo bar` is a search for documents that do not contain 'foo' but may contain 'bar'.\n *\n * To escape special characters the backslash character '\\' can be used, this allows searches to include\n * characters that would normally be considered modifiers, e.g. `foo\\~2` will search for a term \"foo~2\" instead\n * of attempting to apply a boost of 2 to the search term \"foo\".\n *\n * @typedef {string} lunr.Index~QueryString\n * @example <caption>Simple single term query</caption>\n * hello\n * @example <caption>Multiple term query</caption>\n * hello world\n * @example <caption>term scoped to a field</caption>\n * title:hello\n * @example <caption>term with a boost of 10</caption>\n * hello^10\n * @example <caption>term with an edit distance of 2</caption>\n * hello~2\n * @example <caption>terms with presence modifiers</caption>\n * -foo +bar baz\n */\n\n/**\n * Performs a search against the index using lunr query syntax.\n *\n * Results will be returned sorted by their score, the most relevant results\n * will be returned first.  For details on how the score is calculated, please see\n * the {@link https://lunrjs.com/guides/searching.html#scoring|guide}.\n *\n * For more programmatic querying use lunr.Index#query.\n *\n * @param {lunr.Index~QueryString} queryString - A string containing a lunr query.\n * @throws {lunr.QueryParseError} If the passed query string cannot be parsed.\n * @returns {lunr.Index~Result[]}\n */\nlunr.Index.prototype.search = function (queryString) {\n  return this.query(function (query) {\n    var parser = new lunr.QueryParser(queryString, query)\n    parser.parse()\n  })\n}\n\n/**\n * A query builder callback provides a query object to be used to express\n * the query to perform on the index.\n *\n * @callback lunr.Index~queryBuilder\n * @param {lunr.Query} query - The query object to build up.\n * @this lunr.Query\n */\n\n/**\n * Performs a query against the index using the yielded lunr.Query object.\n *\n * If performing programmatic queries against the index, this method is preferred\n * over lunr.Index#search so as to avoid the additional query parsing overhead.\n *\n * A query object is yielded to the supplied function which should be used to\n * express the query to be run against the index.\n *\n * Note that although this function takes a callback parameter it is _not_ an\n * asynchronous operation, the callback is just yielded a query object to be\n * customized.\n *\n * @param {lunr.Index~queryBuilder} fn - A function that is used to build the query.\n * @returns {lunr.Index~Result[]}\n */\nlunr.Index.prototype.query = function (fn) {\n  // for each query clause\n  // * process terms\n  // * expand terms from token set\n  // * find matching documents and metadata\n  // * get document vectors\n  // * score documents\n\n  var query = new lunr.Query(this.fields),\n      matchingFields = Object.create(null),\n      queryVectors = Object.create(null),\n      termFieldCache = Object.create(null),\n      requiredMatches = Object.create(null),\n      prohibitedMatches = Object.create(null)\n\n  /*\n   * To support field level boosts a query vector is created per\n   * field. An empty vector is eagerly created to support negated\n   * queries.\n   */\n  for (var i = 0; i < this.fields.length; i++) {\n    queryVectors[this.fields[i]] = new lunr.Vector\n  }\n\n  fn.call(query, query)\n\n  for (var i = 0; i < query.clauses.length; i++) {\n    /*\n     * Unless the pipeline has been disabled for this term, which is\n     * the case for terms with wildcards, we need to pass the clause\n     * term through the search pipeline. A pipeline returns an array\n     * of processed terms. Pipeline functions may expand the passed\n     * term, which means we may end up performing multiple index lookups\n     * for a single query term.\n     */\n    var clause = query.clauses[i],\n        terms = null,\n        clauseMatches = lunr.Set.empty\n\n    if (clause.usePipeline) {\n      terms = this.pipeline.runString(clause.term, {\n        fields: clause.fields\n      })\n    } else {\n      terms = [clause.term]\n    }\n\n    for (var m = 0; m < terms.length; m++) {\n      var term = terms[m]\n\n      /*\n       * Each term returned from the pipeline needs to use the same query\n       * clause object, e.g. the same boost and or edit distance. The\n       * simplest way to do this is to re-use the clause object but mutate\n       * its term property.\n       */\n      clause.term = term\n\n      /*\n       * From the term in the clause we create a token set which will then\n       * be used to intersect the indexes token set to get a list of terms\n       * to lookup in the inverted index\n       */\n      var termTokenSet = lunr.TokenSet.fromClause(clause),\n          expandedTerms = this.tokenSet.intersect(termTokenSet).toArray()\n\n      /*\n       * If a term marked as required does not exist in the tokenSet it is\n       * impossible for the search to return any matches. We set all the field\n       * scoped required matches set to empty and stop examining any further\n       * clauses.\n       */\n      if (expandedTerms.length === 0 && clause.presence === lunr.Query.presence.REQUIRED) {\n        for (var k = 0; k < clause.fields.length; k++) {\n          var field = clause.fields[k]\n          requiredMatches[field] = lunr.Set.empty\n        }\n\n        break\n      }\n\n      for (var j = 0; j < expandedTerms.length; j++) {\n        /*\n         * For each term get the posting and termIndex, this is required for\n         * building the query vector.\n         */\n        var expandedTerm = expandedTerms[j],\n            posting = this.invertedIndex[expandedTerm],\n            termIndex = posting._index\n\n        for (var k = 0; k < clause.fields.length; k++) {\n          /*\n           * For each field that this query term is scoped by (by default\n           * all fields are in scope) we need to get all the document refs\n           * that have this term in that field.\n           *\n           * The posting is the entry in the invertedIndex for the matching\n           * term from above.\n           */\n          var field = clause.fields[k],\n              fieldPosting = posting[field],\n              matchingDocumentRefs = Object.keys(fieldPosting),\n              termField = expandedTerm + \"/\" + field,\n              matchingDocumentsSet = new lunr.Set(matchingDocumentRefs)\n\n          /*\n           * if the presence of this term is required ensure that the matching\n           * documents are added to the set of required matches for this clause.\n           *\n           */\n          if (clause.presence == lunr.Query.presence.REQUIRED) {\n            clauseMatches = clauseMatches.union(matchingDocumentsSet)\n\n            if (requiredMatches[field] === undefined) {\n              requiredMatches[field] = lunr.Set.complete\n            }\n          }\n\n          /*\n           * if the presence of this term is prohibited ensure that the matching\n           * documents are added to the set of prohibited matches for this field,\n           * creating that set if it does not yet exist.\n           */\n          if (clause.presence == lunr.Query.presence.PROHIBITED) {\n            if (prohibitedMatches[field] === undefined) {\n              prohibitedMatches[field] = lunr.Set.empty\n            }\n\n            prohibitedMatches[field] = prohibitedMatches[field].union(matchingDocumentsSet)\n\n            /*\n             * Prohibited matches should not be part of the query vector used for\n             * similarity scoring and no metadata should be extracted so we continue\n             * to the next field\n             */\n            continue\n          }\n\n          /*\n           * The query field vector is populated using the termIndex found for\n           * the term and a unit value with the appropriate boost applied.\n           * Using upsert because there could already be an entry in the vector\n           * for the term we are working with. In that case we just add the scores\n           * together.\n           */\n          queryVectors[field].upsert(termIndex, clause.boost, function (a, b) { return a + b })\n\n          /**\n           * If we've already seen this term, field combo then we've already collected\n           * the matching documents and metadata, no need to go through all that again\n           */\n          if (termFieldCache[termField]) {\n            continue\n          }\n\n          for (var l = 0; l < matchingDocumentRefs.length; l++) {\n            /*\n             * All metadata for this term/field/document triple\n             * are then extracted and collected into an instance\n             * of lunr.MatchData ready to be returned in the query\n             * results\n             */\n            var matchingDocumentRef = matchingDocumentRefs[l],\n                matchingFieldRef = new lunr.FieldRef (matchingDocumentRef, field),\n                metadata = fieldPosting[matchingDocumentRef],\n                fieldMatch\n\n            if ((fieldMatch = matchingFields[matchingFieldRef]) === undefined) {\n              matchingFields[matchingFieldRef] = new lunr.MatchData (expandedTerm, field, metadata)\n            } else {\n              fieldMatch.add(expandedTerm, field, metadata)\n            }\n\n          }\n\n          termFieldCache[termField] = true\n        }\n      }\n    }\n\n    /**\n     * If the presence was required we need to update the requiredMatches field sets.\n     * We do this after all fields for the term have collected their matches because\n     * the clause terms presence is required in _any_ of the fields not _all_ of the\n     * fields.\n     */\n    if (clause.presence === lunr.Query.presence.REQUIRED) {\n      for (var k = 0; k < clause.fields.length; k++) {\n        var field = clause.fields[k]\n        requiredMatches[field] = requiredMatches[field].intersect(clauseMatches)\n      }\n    }\n  }\n\n  /**\n   * Need to combine the field scoped required and prohibited\n   * matching documents into a global set of required and prohibited\n   * matches\n   */\n  var allRequiredMatches = lunr.Set.complete,\n      allProhibitedMatches = lunr.Set.empty\n\n  for (var i = 0; i < this.fields.length; i++) {\n    var field = this.fields[i]\n\n    if (requiredMatches[field]) {\n      allRequiredMatches = allRequiredMatches.intersect(requiredMatches[field])\n    }\n\n    if (prohibitedMatches[field]) {\n      allProhibitedMatches = allProhibitedMatches.union(prohibitedMatches[field])\n    }\n  }\n\n  var matchingFieldRefs = Object.keys(matchingFields),\n      results = [],\n      matches = Object.create(null)\n\n  /*\n   * If the query is negated (contains only prohibited terms)\n   * we need to get _all_ fieldRefs currently existing in the\n   * index. This is only done when we know that the query is\n   * entirely prohibited terms to avoid any cost of getting all\n   * fieldRefs unnecessarily.\n   *\n   * Additionally, blank MatchData must be created to correctly\n   * populate the results.\n   */\n  if (query.isNegated()) {\n    matchingFieldRefs = Object.keys(this.fieldVectors)\n\n    for (var i = 0; i < matchingFieldRefs.length; i++) {\n      var matchingFieldRef = matchingFieldRefs[i]\n      var fieldRef = lunr.FieldRef.fromString(matchingFieldRef)\n      matchingFields[matchingFieldRef] = new lunr.MatchData\n    }\n  }\n\n  for (var i = 0; i < matchingFieldRefs.length; i++) {\n    /*\n     * Currently we have document fields that match the query, but we\n     * need to return documents. The matchData and scores are combined\n     * from multiple fields belonging to the same document.\n     *\n     * Scores are calculated by field, using the query vectors created\n     * above, and combined into a final document score using addition.\n     */\n    var fieldRef = lunr.FieldRef.fromString(matchingFieldRefs[i]),\n        docRef = fieldRef.docRef\n\n    if (!allRequiredMatches.contains(docRef)) {\n      continue\n    }\n\n    if (allProhibitedMatches.contains(docRef)) {\n      continue\n    }\n\n    var fieldVector = this.fieldVectors[fieldRef],\n        score = queryVectors[fieldRef.fieldName].similarity(fieldVector),\n        docMatch\n\n    if ((docMatch = matches[docRef]) !== undefined) {\n      docMatch.score += score\n      docMatch.matchData.combine(matchingFields[fieldRef])\n    } else {\n      var match = {\n        ref: docRef,\n        score: score,\n        matchData: matchingFields[fieldRef]\n      }\n      matches[docRef] = match\n      results.push(match)\n    }\n  }\n\n  /*\n   * Sort the results objects by score, highest first.\n   */\n  return results.sort(function (a, b) {\n    return b.score - a.score\n  })\n}\n\n/**\n * Prepares the index for JSON serialization.\n *\n * The schema for this JSON blob will be described in a\n * separate JSON schema file.\n *\n * @returns {Object}\n */\nlunr.Index.prototype.toJSON = function () {\n  var invertedIndex = Object.keys(this.invertedIndex)\n    .sort()\n    .map(function (term) {\n      return [term, this.invertedIndex[term]]\n    }, this)\n\n  var fieldVectors = Object.keys(this.fieldVectors)\n    .map(function (ref) {\n      return [ref, this.fieldVectors[ref].toJSON()]\n    }, this)\n\n  return {\n    version: lunr.version,\n    fields: this.fields,\n    fieldVectors: fieldVectors,\n    invertedIndex: invertedIndex,\n    pipeline: this.pipeline.toJSON()\n  }\n}\n\n/**\n * Loads a previously serialized lunr.Index\n *\n * @param {Object} serializedIndex - A previously serialized lunr.Index\n * @returns {lunr.Index}\n */\nlunr.Index.load = function (serializedIndex) {\n  var attrs = {},\n      fieldVectors = {},\n      serializedVectors = serializedIndex.fieldVectors,\n      invertedIndex = Object.create(null),\n      serializedInvertedIndex = serializedIndex.invertedIndex,\n      tokenSetBuilder = new lunr.TokenSet.Builder,\n      pipeline = lunr.Pipeline.load(serializedIndex.pipeline)\n\n  if (serializedIndex.version != lunr.version) {\n    lunr.utils.warn(\"Version mismatch when loading serialised index. Current version of lunr '\" + lunr.version + \"' does not match serialized index '\" + serializedIndex.version + \"'\")\n  }\n\n  for (var i = 0; i < serializedVectors.length; i++) {\n    var tuple = serializedVectors[i],\n        ref = tuple[0],\n        elements = tuple[1]\n\n    fieldVectors[ref] = new lunr.Vector(elements)\n  }\n\n  for (var i = 0; i < serializedInvertedIndex.length; i++) {\n    var tuple = serializedInvertedIndex[i],\n        term = tuple[0],\n        posting = tuple[1]\n\n    tokenSetBuilder.insert(term)\n    invertedIndex[term] = posting\n  }\n\n  tokenSetBuilder.finish()\n\n  attrs.fields = serializedIndex.fields\n\n  attrs.fieldVectors = fieldVectors\n  attrs.invertedIndex = invertedIndex\n  attrs.tokenSet = tokenSetBuilder.root\n  attrs.pipeline = pipeline\n\n  return new lunr.Index(attrs)\n}\n/*!\n * lunr.Builder\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.Builder performs indexing on a set of documents and\n * returns instances of lunr.Index ready for querying.\n *\n * All configuration of the index is done via the builder, the\n * fields to index, the document reference, the text processing\n * pipeline and document scoring parameters are all set on the\n * builder before indexing.\n *\n * @constructor\n * @property {string} _ref - Internal reference to the document reference field.\n * @property {string[]} _fields - Internal reference to the document fields to index.\n * @property {object} invertedIndex - The inverted index maps terms to document fields.\n * @property {object} documentTermFrequencies - Keeps track of document term frequencies.\n * @property {object} documentLengths - Keeps track of the length of documents added to the index.\n * @property {lunr.tokenizer} tokenizer - Function for splitting strings into tokens for indexing.\n * @property {lunr.Pipeline} pipeline - The pipeline performs text processing on tokens before indexing.\n * @property {lunr.Pipeline} searchPipeline - A pipeline for processing search terms before querying the index.\n * @property {number} documentCount - Keeps track of the total number of documents indexed.\n * @property {number} _b - A parameter to control field length normalization, setting this to 0 disabled normalization, 1 fully normalizes field lengths, the default value is 0.75.\n * @property {number} _k1 - A parameter to control how quickly an increase in term frequency results in term frequency saturation, the default value is 1.2.\n * @property {number} termIndex - A counter incremented for each unique term, used to identify a terms position in the vector space.\n * @property {array} metadataWhitelist - A list of metadata keys that have been whitelisted for entry in the index.\n */\nlunr.Builder = function () {\n  this._ref = \"id\"\n  this._fields = Object.create(null)\n  this._documents = Object.create(null)\n  this.invertedIndex = Object.create(null)\n  this.fieldTermFrequencies = {}\n  this.fieldLengths = {}\n  this.tokenizer = lunr.tokenizer\n  this.pipeline = new lunr.Pipeline\n  this.searchPipeline = new lunr.Pipeline\n  this.documentCount = 0\n  this._b = 0.75\n  this._k1 = 1.2\n  this.termIndex = 0\n  this.metadataWhitelist = []\n}\n\n/**\n * Sets the document field used as the document reference. Every document must have this field.\n * The type of this field in the document should be a string, if it is not a string it will be\n * coerced into a string by calling toString.\n *\n * The default ref is 'id'.\n *\n * The ref should _not_ be changed during indexing, it should be set before any documents are\n * added to the index. Changing it during indexing can lead to inconsistent results.\n *\n * @param {string} ref - The name of the reference field in the document.\n */\nlunr.Builder.prototype.ref = function (ref) {\n  this._ref = ref\n}\n\n/**\n * A function that is used to extract a field from a document.\n *\n * Lunr expects a field to be at the top level of a document, if however the field\n * is deeply nested within a document an extractor function can be used to extract\n * the right field for indexing.\n *\n * @callback fieldExtractor\n * @param {object} doc - The document being added to the index.\n * @returns {?(string|object|object[])} obj - The object that will be indexed for this field.\n * @example <caption>Extracting a nested field</caption>\n * function (doc) { return doc.nested.field }\n */\n\n/**\n * Adds a field to the list of document fields that will be indexed. Every document being\n * indexed should have this field. Null values for this field in indexed documents will\n * not cause errors but will limit the chance of that document being retrieved by searches.\n *\n * All fields should be added before adding documents to the index. Adding fields after\n * a document has been indexed will have no effect on already indexed documents.\n *\n * Fields can be boosted at build time. This allows terms within that field to have more\n * importance when ranking search results. Use a field boost to specify that matches within\n * one field are more important than other fields.\n *\n * @param {string} fieldName - The name of a field to index in all documents.\n * @param {object} attributes - Optional attributes associated with this field.\n * @param {number} [attributes.boost=1] - Boost applied to all terms within this field.\n * @param {fieldExtractor} [attributes.extractor] - Function to extract a field from a document.\n * @throws {RangeError} fieldName cannot contain unsupported characters '/'\n */\nlunr.Builder.prototype.field = function (fieldName, attributes) {\n  if (/\\//.test(fieldName)) {\n    throw new RangeError (\"Field '\" + fieldName + \"' contains illegal character '/'\")\n  }\n\n  this._fields[fieldName] = attributes || {}\n}\n\n/**\n * A parameter to tune the amount of field length normalisation that is applied when\n * calculating relevance scores. A value of 0 will completely disable any normalisation\n * and a value of 1 will fully normalise field lengths. The default is 0.75. Values of b\n * will be clamped to the range 0 - 1.\n *\n * @param {number} number - The value to set for this tuning parameter.\n */\nlunr.Builder.prototype.b = function (number) {\n  if (number < 0) {\n    this._b = 0\n  } else if (number > 1) {\n    this._b = 1\n  } else {\n    this._b = number\n  }\n}\n\n/**\n * A parameter that controls the speed at which a rise in term frequency results in term\n * frequency saturation. The default value is 1.2. Setting this to a higher value will give\n * slower saturation levels, a lower value will result in quicker saturation.\n *\n * @param {number} number - The value to set for this tuning parameter.\n */\nlunr.Builder.prototype.k1 = function (number) {\n  this._k1 = number\n}\n\n/**\n * Adds a document to the index.\n *\n * Before adding fields to the index the index should have been fully setup, with the document\n * ref and all fields to index already having been specified.\n *\n * The document must have a field name as specified by the ref (by default this is 'id') and\n * it should have all fields defined for indexing, though null or undefined values will not\n * cause errors.\n *\n * Entire documents can be boosted at build time. Applying a boost to a document indicates that\n * this document should rank higher in search results than other documents.\n *\n * @param {object} doc - The document to add to the index.\n * @param {object} attributes - Optional attributes associated with this document.\n * @param {number} [attributes.boost=1] - Boost applied to all terms within this document.\n */\nlunr.Builder.prototype.add = function (doc, attributes) {\n  var docRef = doc[this._ref],\n      fields = Object.keys(this._fields)\n\n  this._documents[docRef] = attributes || {}\n  this.documentCount += 1\n\n  for (var i = 0; i < fields.length; i++) {\n    var fieldName = fields[i],\n        extractor = this._fields[fieldName].extractor,\n        field = extractor ? extractor(doc) : doc[fieldName],\n        tokens = this.tokenizer(field, {\n          fields: [fieldName]\n        }),\n        terms = this.pipeline.run(tokens),\n        fieldRef = new lunr.FieldRef (docRef, fieldName),\n        fieldTerms = Object.create(null)\n\n    this.fieldTermFrequencies[fieldRef] = fieldTerms\n    this.fieldLengths[fieldRef] = 0\n\n    // store the length of this field for this document\n    this.fieldLengths[fieldRef] += terms.length\n\n    // calculate term frequencies for this field\n    for (var j = 0; j < terms.length; j++) {\n      var term = terms[j]\n\n      if (fieldTerms[term] == undefined) {\n        fieldTerms[term] = 0\n      }\n\n      fieldTerms[term] += 1\n\n      // add to inverted index\n      // create an initial posting if one doesn't exist\n      if (this.invertedIndex[term] == undefined) {\n        var posting = Object.create(null)\n        posting[\"_index\"] = this.termIndex\n        this.termIndex += 1\n\n        for (var k = 0; k < fields.length; k++) {\n          posting[fields[k]] = Object.create(null)\n        }\n\n        this.invertedIndex[term] = posting\n      }\n\n      // add an entry for this term/fieldName/docRef to the invertedIndex\n      if (this.invertedIndex[term][fieldName][docRef] == undefined) {\n        this.invertedIndex[term][fieldName][docRef] = Object.create(null)\n      }\n\n      // store all whitelisted metadata about this token in the\n      // inverted index\n      for (var l = 0; l < this.metadataWhitelist.length; l++) {\n        var metadataKey = this.metadataWhitelist[l],\n            metadata = term.metadata[metadataKey]\n\n        if (this.invertedIndex[term][fieldName][docRef][metadataKey] == undefined) {\n          this.invertedIndex[term][fieldName][docRef][metadataKey] = []\n        }\n\n        this.invertedIndex[term][fieldName][docRef][metadataKey].push(metadata)\n      }\n    }\n\n  }\n}\n\n/**\n * Calculates the average document length for this index\n *\n * @private\n */\nlunr.Builder.prototype.calculateAverageFieldLengths = function () {\n\n  var fieldRefs = Object.keys(this.fieldLengths),\n      numberOfFields = fieldRefs.length,\n      accumulator = {},\n      documentsWithField = {}\n\n  for (var i = 0; i < numberOfFields; i++) {\n    var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),\n        field = fieldRef.fieldName\n\n    documentsWithField[field] || (documentsWithField[field] = 0)\n    documentsWithField[field] += 1\n\n    accumulator[field] || (accumulator[field] = 0)\n    accumulator[field] += this.fieldLengths[fieldRef]\n  }\n\n  var fields = Object.keys(this._fields)\n\n  for (var i = 0; i < fields.length; i++) {\n    var fieldName = fields[i]\n    accumulator[fieldName] = accumulator[fieldName] / documentsWithField[fieldName]\n  }\n\n  this.averageFieldLength = accumulator\n}\n\n/**\n * Builds a vector space model of every document using lunr.Vector\n *\n * @private\n */\nlunr.Builder.prototype.createFieldVectors = function () {\n  var fieldVectors = {},\n      fieldRefs = Object.keys(this.fieldTermFrequencies),\n      fieldRefsLength = fieldRefs.length,\n      termIdfCache = Object.create(null)\n\n  for (var i = 0; i < fieldRefsLength; i++) {\n    var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),\n        fieldName = fieldRef.fieldName,\n        fieldLength = this.fieldLengths[fieldRef],\n        fieldVector = new lunr.Vector,\n        termFrequencies = this.fieldTermFrequencies[fieldRef],\n        terms = Object.keys(termFrequencies),\n        termsLength = terms.length\n\n\n    var fieldBoost = this._fields[fieldName].boost || 1,\n        docBoost = this._documents[fieldRef.docRef].boost || 1\n\n    for (var j = 0; j < termsLength; j++) {\n      var term = terms[j],\n          tf = termFrequencies[term],\n          termIndex = this.invertedIndex[term]._index,\n          idf, score, scoreWithPrecision\n\n      if (termIdfCache[term] === undefined) {\n        idf = lunr.idf(this.invertedIndex[term], this.documentCount)\n        termIdfCache[term] = idf\n      } else {\n        idf = termIdfCache[term]\n      }\n\n      score = idf * ((this._k1 + 1) * tf) / (this._k1 * (1 - this._b + this._b * (fieldLength / this.averageFieldLength[fieldName])) + tf)\n      score *= fieldBoost\n      score *= docBoost\n      scoreWithPrecision = Math.round(score * 1000) / 1000\n      // Converts 1.23456789 to 1.234.\n      // Reducing the precision so that the vectors take up less\n      // space when serialised. Doing it now so that they behave\n      // the same before and after serialisation. Also, this is\n      // the fastest approach to reducing a number's precision in\n      // JavaScript.\n\n      fieldVector.insert(termIndex, scoreWithPrecision)\n    }\n\n    fieldVectors[fieldRef] = fieldVector\n  }\n\n  this.fieldVectors = fieldVectors\n}\n\n/**\n * Creates a token set of all tokens in the index using lunr.TokenSet\n *\n * @private\n */\nlunr.Builder.prototype.createTokenSet = function () {\n  this.tokenSet = lunr.TokenSet.fromArray(\n    Object.keys(this.invertedIndex).sort()\n  )\n}\n\n/**\n * Builds the index, creating an instance of lunr.Index.\n *\n * This completes the indexing process and should only be called\n * once all documents have been added to the index.\n *\n * @returns {lunr.Index}\n */\nlunr.Builder.prototype.build = function () {\n  this.calculateAverageFieldLengths()\n  this.createFieldVectors()\n  this.createTokenSet()\n\n  return new lunr.Index({\n    invertedIndex: this.invertedIndex,\n    fieldVectors: this.fieldVectors,\n    tokenSet: this.tokenSet,\n    fields: Object.keys(this._fields),\n    pipeline: this.searchPipeline\n  })\n}\n\n/**\n * Applies a plugin to the index builder.\n *\n * A plugin is a function that is called with the index builder as its context.\n * Plugins can be used to customise or extend the behaviour of the index\n * in some way. A plugin is just a function, that encapsulated the custom\n * behaviour that should be applied when building the index.\n *\n * The plugin function will be called with the index builder as its argument, additional\n * arguments can also be passed when calling use. The function will be called\n * with the index builder as its context.\n *\n * @param {Function} plugin The plugin to apply.\n */\nlunr.Builder.prototype.use = function (fn) {\n  var args = Array.prototype.slice.call(arguments, 1)\n  args.unshift(this)\n  fn.apply(this, args)\n}\n/**\n * Contains and collects metadata about a matching document.\n * A single instance of lunr.MatchData is returned as part of every\n * lunr.Index~Result.\n *\n * @constructor\n * @param {string} term - The term this match data is associated with\n * @param {string} field - The field in which the term was found\n * @param {object} metadata - The metadata recorded about this term in this field\n * @property {object} metadata - A cloned collection of metadata associated with this document.\n * @see {@link lunr.Index~Result}\n */\nlunr.MatchData = function (term, field, metadata) {\n  var clonedMetadata = Object.create(null),\n      metadataKeys = Object.keys(metadata || {})\n\n  // Cloning the metadata to prevent the original\n  // being mutated during match data combination.\n  // Metadata is kept in an array within the inverted\n  // index so cloning the data can be done with\n  // Array#slice\n  for (var i = 0; i < metadataKeys.length; i++) {\n    var key = metadataKeys[i]\n    clonedMetadata[key] = metadata[key].slice()\n  }\n\n  this.metadata = Object.create(null)\n\n  if (term !== undefined) {\n    this.metadata[term] = Object.create(null)\n    this.metadata[term][field] = clonedMetadata\n  }\n}\n\n/**\n * An instance of lunr.MatchData will be created for every term that matches a\n * document. However only one instance is required in a lunr.Index~Result. This\n * method combines metadata from another instance of lunr.MatchData with this\n * objects metadata.\n *\n * @param {lunr.MatchData} otherMatchData - Another instance of match data to merge with this one.\n * @see {@link lunr.Index~Result}\n */\nlunr.MatchData.prototype.combine = function (otherMatchData) {\n  var terms = Object.keys(otherMatchData.metadata)\n\n  for (var i = 0; i < terms.length; i++) {\n    var term = terms[i],\n        fields = Object.keys(otherMatchData.metadata[term])\n\n    if (this.metadata[term] == undefined) {\n      this.metadata[term] = Object.create(null)\n    }\n\n    for (var j = 0; j < fields.length; j++) {\n      var field = fields[j],\n          keys = Object.keys(otherMatchData.metadata[term][field])\n\n      if (this.metadata[term][field] == undefined) {\n        this.metadata[term][field] = Object.create(null)\n      }\n\n      for (var k = 0; k < keys.length; k++) {\n        var key = keys[k]\n\n        if (this.metadata[term][field][key] == undefined) {\n          this.metadata[term][field][key] = otherMatchData.metadata[term][field][key]\n        } else {\n          this.metadata[term][field][key] = this.metadata[term][field][key].concat(otherMatchData.metadata[term][field][key])\n        }\n\n      }\n    }\n  }\n}\n\n/**\n * Add metadata for a term/field pair to this instance of match data.\n *\n * @param {string} term - The term this match data is associated with\n * @param {string} field - The field in which the term was found\n * @param {object} metadata - The metadata recorded about this term in this field\n */\nlunr.MatchData.prototype.add = function (term, field, metadata) {\n  if (!(term in this.metadata)) {\n    this.metadata[term] = Object.create(null)\n    this.metadata[term][field] = metadata\n    return\n  }\n\n  if (!(field in this.metadata[term])) {\n    this.metadata[term][field] = metadata\n    return\n  }\n\n  var metadataKeys = Object.keys(metadata)\n\n  for (var i = 0; i < metadataKeys.length; i++) {\n    var key = metadataKeys[i]\n\n    if (key in this.metadata[term][field]) {\n      this.metadata[term][field][key] = this.metadata[term][field][key].concat(metadata[key])\n    } else {\n      this.metadata[term][field][key] = metadata[key]\n    }\n  }\n}\n/**\n * A lunr.Query provides a programmatic way of defining queries to be performed\n * against a {@link lunr.Index}.\n *\n * Prefer constructing a lunr.Query using the {@link lunr.Index#query} method\n * so the query object is pre-initialized with the right index fields.\n *\n * @constructor\n * @property {lunr.Query~Clause[]} clauses - An array of query clauses.\n * @property {string[]} allFields - An array of all available fields in a lunr.Index.\n */\nlunr.Query = function (allFields) {\n  this.clauses = []\n  this.allFields = allFields\n}\n\n/**\n * Constants for indicating what kind of automatic wildcard insertion will be used when constructing a query clause.\n *\n * This allows wildcards to be added to the beginning and end of a term without having to manually do any string\n * concatenation.\n *\n * The wildcard constants can be bitwise combined to select both leading and trailing wildcards.\n *\n * @constant\n * @default\n * @property {number} wildcard.NONE - The term will have no wildcards inserted, this is the default behaviour\n * @property {number} wildcard.LEADING - Prepend the term with a wildcard, unless a leading wildcard already exists\n * @property {number} wildcard.TRAILING - Append a wildcard to the term, unless a trailing wildcard already exists\n * @see lunr.Query~Clause\n * @see lunr.Query#clause\n * @see lunr.Query#term\n * @example <caption>query term with trailing wildcard</caption>\n * query.term('foo', { wildcard: lunr.Query.wildcard.TRAILING })\n * @example <caption>query term with leading and trailing wildcard</caption>\n * query.term('foo', {\n *   wildcard: lunr.Query.wildcard.LEADING | lunr.Query.wildcard.TRAILING\n * })\n */\n\nlunr.Query.wildcard = new String (\"*\")\nlunr.Query.wildcard.NONE = 0\nlunr.Query.wildcard.LEADING = 1\nlunr.Query.wildcard.TRAILING = 2\n\n/**\n * Constants for indicating what kind of presence a term must have in matching documents.\n *\n * @constant\n * @enum {number}\n * @see lunr.Query~Clause\n * @see lunr.Query#clause\n * @see lunr.Query#term\n * @example <caption>query term with required presence</caption>\n * query.term('foo', { presence: lunr.Query.presence.REQUIRED })\n */\nlunr.Query.presence = {\n  /**\n   * Term's presence in a document is optional, this is the default value.\n   */\n  OPTIONAL: 1,\n\n  /**\n   * Term's presence in a document is required, documents that do not contain\n   * this term will not be returned.\n   */\n  REQUIRED: 2,\n\n  /**\n   * Term's presence in a document is prohibited, documents that do contain\n   * this term will not be returned.\n   */\n  PROHIBITED: 3\n}\n\n/**\n * A single clause in a {@link lunr.Query} contains a term and details on how to\n * match that term against a {@link lunr.Index}.\n *\n * @typedef {Object} lunr.Query~Clause\n * @property {string[]} fields - The fields in an index this clause should be matched against.\n * @property {number} [boost=1] - Any boost that should be applied when matching this clause.\n * @property {number} [editDistance] - Whether the term should have fuzzy matching applied, and how fuzzy the match should be.\n * @property {boolean} [usePipeline] - Whether the term should be passed through the search pipeline.\n * @property {number} [wildcard=lunr.Query.wildcard.NONE] - Whether the term should have wildcards appended or prepended.\n * @property {number} [presence=lunr.Query.presence.OPTIONAL] - The terms presence in any matching documents.\n */\n\n/**\n * Adds a {@link lunr.Query~Clause} to this query.\n *\n * Unless the clause contains the fields to be matched all fields will be matched. In addition\n * a default boost of 1 is applied to the clause.\n *\n * @param {lunr.Query~Clause} clause - The clause to add to this query.\n * @see lunr.Query~Clause\n * @returns {lunr.Query}\n */\nlunr.Query.prototype.clause = function (clause) {\n  if (!('fields' in clause)) {\n    clause.fields = this.allFields\n  }\n\n  if (!('boost' in clause)) {\n    clause.boost = 1\n  }\n\n  if (!('usePipeline' in clause)) {\n    clause.usePipeline = true\n  }\n\n  if (!('wildcard' in clause)) {\n    clause.wildcard = lunr.Query.wildcard.NONE\n  }\n\n  if ((clause.wildcard & lunr.Query.wildcard.LEADING) && (clause.term.charAt(0) != lunr.Query.wildcard)) {\n    clause.term = \"*\" + clause.term\n  }\n\n  if ((clause.wildcard & lunr.Query.wildcard.TRAILING) && (clause.term.slice(-1) != lunr.Query.wildcard)) {\n    clause.term = \"\" + clause.term + \"*\"\n  }\n\n  if (!('presence' in clause)) {\n    clause.presence = lunr.Query.presence.OPTIONAL\n  }\n\n  this.clauses.push(clause)\n\n  return this\n}\n\n/**\n * A negated query is one in which every clause has a presence of\n * prohibited. These queries require some special processing to return\n * the expected results.\n *\n * @returns boolean\n */\nlunr.Query.prototype.isNegated = function () {\n  for (var i = 0; i < this.clauses.length; i++) {\n    if (this.clauses[i].presence != lunr.Query.presence.PROHIBITED) {\n      return false\n    }\n  }\n\n  return true\n}\n\n/**\n * Adds a term to the current query, under the covers this will create a {@link lunr.Query~Clause}\n * to the list of clauses that make up this query.\n *\n * The term is used as is, i.e. no tokenization will be performed by this method. Instead conversion\n * to a token or token-like string should be done before calling this method.\n *\n * The term will be converted to a string by calling `toString`. Multiple terms can be passed as an\n * array, each term in the array will share the same options.\n *\n * @param {object|object[]} term - The term(s) to add to the query.\n * @param {object} [options] - Any additional properties to add to the query clause.\n * @returns {lunr.Query}\n * @see lunr.Query#clause\n * @see lunr.Query~Clause\n * @example <caption>adding a single term to a query</caption>\n * query.term(\"foo\")\n * @example <caption>adding a single term to a query and specifying search fields, term boost and automatic trailing wildcard</caption>\n * query.term(\"foo\", {\n *   fields: [\"title\"],\n *   boost: 10,\n *   wildcard: lunr.Query.wildcard.TRAILING\n * })\n * @example <caption>using lunr.tokenizer to convert a string to tokens before using them as terms</caption>\n * query.term(lunr.tokenizer(\"foo bar\"))\n */\nlunr.Query.prototype.term = function (term, options) {\n  if (Array.isArray(term)) {\n    term.forEach(function (t) { this.term(t, lunr.utils.clone(options)) }, this)\n    return this\n  }\n\n  var clause = options || {}\n  clause.term = term.toString()\n\n  this.clause(clause)\n\n  return this\n}\nlunr.QueryParseError = function (message, start, end) {\n  this.name = \"QueryParseError\"\n  this.message = message\n  this.start = start\n  this.end = end\n}\n\nlunr.QueryParseError.prototype = new Error\nlunr.QueryLexer = function (str) {\n  this.lexemes = []\n  this.str = str\n  this.length = str.length\n  this.pos = 0\n  this.start = 0\n  this.escapeCharPositions = []\n}\n\nlunr.QueryLexer.prototype.run = function () {\n  var state = lunr.QueryLexer.lexText\n\n  while (state) {\n    state = state(this)\n  }\n}\n\nlunr.QueryLexer.prototype.sliceString = function () {\n  var subSlices = [],\n      sliceStart = this.start,\n      sliceEnd = this.pos\n\n  for (var i = 0; i < this.escapeCharPositions.length; i++) {\n    sliceEnd = this.escapeCharPositions[i]\n    subSlices.push(this.str.slice(sliceStart, sliceEnd))\n    sliceStart = sliceEnd + 1\n  }\n\n  subSlices.push(this.str.slice(sliceStart, this.pos))\n  this.escapeCharPositions.length = 0\n\n  return subSlices.join('')\n}\n\nlunr.QueryLexer.prototype.emit = function (type) {\n  this.lexemes.push({\n    type: type,\n    str: this.sliceString(),\n    start: this.start,\n    end: this.pos\n  })\n\n  this.start = this.pos\n}\n\nlunr.QueryLexer.prototype.escapeCharacter = function () {\n  this.escapeCharPositions.push(this.pos - 1)\n  this.pos += 1\n}\n\nlunr.QueryLexer.prototype.next = function () {\n  if (this.pos >= this.length) {\n    return lunr.QueryLexer.EOS\n  }\n\n  var char = this.str.charAt(this.pos)\n  this.pos += 1\n  return char\n}\n\nlunr.QueryLexer.prototype.width = function () {\n  return this.pos - this.start\n}\n\nlunr.QueryLexer.prototype.ignore = function () {\n  if (this.start == this.pos) {\n    this.pos += 1\n  }\n\n  this.start = this.pos\n}\n\nlunr.QueryLexer.prototype.backup = function () {\n  this.pos -= 1\n}\n\nlunr.QueryLexer.prototype.acceptDigitRun = function () {\n  var char, charCode\n\n  do {\n    char = this.next()\n    charCode = char.charCodeAt(0)\n  } while (charCode > 47 && charCode < 58)\n\n  if (char != lunr.QueryLexer.EOS) {\n    this.backup()\n  }\n}\n\nlunr.QueryLexer.prototype.more = function () {\n  return this.pos < this.length\n}\n\nlunr.QueryLexer.EOS = 'EOS'\nlunr.QueryLexer.FIELD = 'FIELD'\nlunr.QueryLexer.TERM = 'TERM'\nlunr.QueryLexer.EDIT_DISTANCE = 'EDIT_DISTANCE'\nlunr.QueryLexer.BOOST = 'BOOST'\nlunr.QueryLexer.PRESENCE = 'PRESENCE'\n\nlunr.QueryLexer.lexField = function (lexer) {\n  lexer.backup()\n  lexer.emit(lunr.QueryLexer.FIELD)\n  lexer.ignore()\n  return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexTerm = function (lexer) {\n  if (lexer.width() > 1) {\n    lexer.backup()\n    lexer.emit(lunr.QueryLexer.TERM)\n  }\n\n  lexer.ignore()\n\n  if (lexer.more()) {\n    return lunr.QueryLexer.lexText\n  }\n}\n\nlunr.QueryLexer.lexEditDistance = function (lexer) {\n  lexer.ignore()\n  lexer.acceptDigitRun()\n  lexer.emit(lunr.QueryLexer.EDIT_DISTANCE)\n  return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexBoost = function (lexer) {\n  lexer.ignore()\n  lexer.acceptDigitRun()\n  lexer.emit(lunr.QueryLexer.BOOST)\n  return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexEOS = function (lexer) {\n  if (lexer.width() > 0) {\n    lexer.emit(lunr.QueryLexer.TERM)\n  }\n}\n\n// This matches the separator used when tokenising fields\n// within a document. These should match otherwise it is\n// not possible to search for some tokens within a document.\n//\n// It is possible for the user to change the separator on the\n// tokenizer so it _might_ clash with any other of the special\n// characters already used within the search string, e.g. :.\n//\n// This means that it is possible to change the separator in\n// such a way that makes some words unsearchable using a search\n// string.\nlunr.QueryLexer.termSeparator = lunr.tokenizer.separator\n\nlunr.QueryLexer.lexText = function (lexer) {\n  while (true) {\n    var char = lexer.next()\n\n    if (char == lunr.QueryLexer.EOS) {\n      return lunr.QueryLexer.lexEOS\n    }\n\n    // Escape character is '\\'\n    if (char.charCodeAt(0) == 92) {\n      lexer.escapeCharacter()\n      continue\n    }\n\n    if (char == \":\") {\n      return lunr.QueryLexer.lexField\n    }\n\n    if (char == \"~\") {\n      lexer.backup()\n      if (lexer.width() > 0) {\n        lexer.emit(lunr.QueryLexer.TERM)\n      }\n      return lunr.QueryLexer.lexEditDistance\n    }\n\n    if (char == \"^\") {\n      lexer.backup()\n      if (lexer.width() > 0) {\n        lexer.emit(lunr.QueryLexer.TERM)\n      }\n      return lunr.QueryLexer.lexBoost\n    }\n\n    // \"+\" indicates term presence is required\n    // checking for length to ensure that only\n    // leading \"+\" are considered\n    if (char == \"+\" && lexer.width() === 1) {\n      lexer.emit(lunr.QueryLexer.PRESENCE)\n      return lunr.QueryLexer.lexText\n    }\n\n    // \"-\" indicates term presence is prohibited\n    // checking for length to ensure that only\n    // leading \"-\" are considered\n    if (char == \"-\" && lexer.width() === 1) {\n      lexer.emit(lunr.QueryLexer.PRESENCE)\n      return lunr.QueryLexer.lexText\n    }\n\n    if (char.match(lunr.QueryLexer.termSeparator)) {\n      return lunr.QueryLexer.lexTerm\n    }\n  }\n}\n\nlunr.QueryParser = function (str, query) {\n  this.lexer = new lunr.QueryLexer (str)\n  this.query = query\n  this.currentClause = {}\n  this.lexemeIdx = 0\n}\n\nlunr.QueryParser.prototype.parse = function () {\n  this.lexer.run()\n  this.lexemes = this.lexer.lexemes\n\n  var state = lunr.QueryParser.parseClause\n\n  while (state) {\n    state = state(this)\n  }\n\n  return this.query\n}\n\nlunr.QueryParser.prototype.peekLexeme = function () {\n  return this.lexemes[this.lexemeIdx]\n}\n\nlunr.QueryParser.prototype.consumeLexeme = function () {\n  var lexeme = this.peekLexeme()\n  this.lexemeIdx += 1\n  return lexeme\n}\n\nlunr.QueryParser.prototype.nextClause = function () {\n  var completedClause = this.currentClause\n  this.query.clause(completedClause)\n  this.currentClause = {}\n}\n\nlunr.QueryParser.parseClause = function (parser) {\n  var lexeme = parser.peekLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  switch (lexeme.type) {\n    case lunr.QueryLexer.PRESENCE:\n      return lunr.QueryParser.parsePresence\n    case lunr.QueryLexer.FIELD:\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.TERM:\n      return lunr.QueryParser.parseTerm\n    default:\n      var errorMessage = \"expected either a field or a term, found \" + lexeme.type\n\n      if (lexeme.str.length >= 1) {\n        errorMessage += \" with value '\" + lexeme.str + \"'\"\n      }\n\n      throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n}\n\nlunr.QueryParser.parsePresence = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  switch (lexeme.str) {\n    case \"-\":\n      parser.currentClause.presence = lunr.Query.presence.PROHIBITED\n      break\n    case \"+\":\n      parser.currentClause.presence = lunr.Query.presence.REQUIRED\n      break\n    default:\n      var errorMessage = \"unrecognised presence operator'\" + lexeme.str + \"'\"\n      throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    var errorMessage = \"expecting term or field, found nothing\"\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.FIELD:\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.TERM:\n      return lunr.QueryParser.parseTerm\n    default:\n      var errorMessage = \"expecting term or field, found '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\nlunr.QueryParser.parseField = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  if (parser.query.allFields.indexOf(lexeme.str) == -1) {\n    var possibleFields = parser.query.allFields.map(function (f) { return \"'\" + f + \"'\" }).join(', '),\n        errorMessage = \"unrecognised field '\" + lexeme.str + \"', possible fields: \" + possibleFields\n\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  parser.currentClause.fields = [lexeme.str]\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    var errorMessage = \"expecting term, found nothing\"\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.TERM:\n      return lunr.QueryParser.parseTerm\n    default:\n      var errorMessage = \"expecting term, found '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\nlunr.QueryParser.parseTerm = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  parser.currentClause.term = lexeme.str.toLowerCase()\n\n  if (lexeme.str.indexOf(\"*\") != -1) {\n    parser.currentClause.usePipeline = false\n  }\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    parser.nextClause()\n    return\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.TERM:\n      parser.nextClause()\n      return lunr.QueryParser.parseTerm\n    case lunr.QueryLexer.FIELD:\n      parser.nextClause()\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.EDIT_DISTANCE:\n      return lunr.QueryParser.parseEditDistance\n    case lunr.QueryLexer.BOOST:\n      return lunr.QueryParser.parseBoost\n    case lunr.QueryLexer.PRESENCE:\n      parser.nextClause()\n      return lunr.QueryParser.parsePresence\n    default:\n      var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\nlunr.QueryParser.parseEditDistance = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  var editDistance = parseInt(lexeme.str, 10)\n\n  if (isNaN(editDistance)) {\n    var errorMessage = \"edit distance must be numeric\"\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  parser.currentClause.editDistance = editDistance\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    parser.nextClause()\n    return\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.TERM:\n      parser.nextClause()\n      return lunr.QueryParser.parseTerm\n    case lunr.QueryLexer.FIELD:\n      parser.nextClause()\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.EDIT_DISTANCE:\n      return lunr.QueryParser.parseEditDistance\n    case lunr.QueryLexer.BOOST:\n      return lunr.QueryParser.parseBoost\n    case lunr.QueryLexer.PRESENCE:\n      parser.nextClause()\n      return lunr.QueryParser.parsePresence\n    default:\n      var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\nlunr.QueryParser.parseBoost = function (parser) {\n  var lexeme = parser.consumeLexeme()\n\n  if (lexeme == undefined) {\n    return\n  }\n\n  var boost = parseInt(lexeme.str, 10)\n\n  if (isNaN(boost)) {\n    var errorMessage = \"boost must be numeric\"\n    throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n  }\n\n  parser.currentClause.boost = boost\n\n  var nextLexeme = parser.peekLexeme()\n\n  if (nextLexeme == undefined) {\n    parser.nextClause()\n    return\n  }\n\n  switch (nextLexeme.type) {\n    case lunr.QueryLexer.TERM:\n      parser.nextClause()\n      return lunr.QueryParser.parseTerm\n    case lunr.QueryLexer.FIELD:\n      parser.nextClause()\n      return lunr.QueryParser.parseField\n    case lunr.QueryLexer.EDIT_DISTANCE:\n      return lunr.QueryParser.parseEditDistance\n    case lunr.QueryLexer.BOOST:\n      return lunr.QueryParser.parseBoost\n    case lunr.QueryLexer.PRESENCE:\n      parser.nextClause()\n      return lunr.QueryParser.parsePresence\n    default:\n      var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n      throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n  }\n}\n\n  /**\n   * export the module via AMD, CommonJS or as a browser global\n   * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js\n   */\n  ;(function (root, factory) {\n    if (typeof define === 'function' && define.amd) {\n      // AMD. Register as an anonymous module.\n      define(factory)\n    } else if (typeof exports === 'object') {\n      /**\n       * Node. Does not work with strict CommonJS, but\n       * only CommonJS-like enviroments that support module.exports,\n       * like Node.\n       */\n      module.exports = factory()\n    } else {\n      // Browser globals (root is window)\n      root.lunr = factory()\n    }\n  }(this, function () {\n    /**\n     * Just return a value to define the module export.\n     * This example returns an object, but the module\n     * can return a function as the exported value.\n     */\n    return lunr\n  }))\n})();\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport lunr from \"lunr\"\n\nimport { getElement } from \"~/browser/element/_\"\nimport \"~/polyfills\"\n\nimport { Search } from \"../../_\"\nimport { SearchConfig } from \"../../config\"\nimport {\n  SearchMessage,\n  SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Add support for `iframe-worker` shim\n *\n * While `importScripts` is synchronous when executed inside of a web worker,\n * it's not possible to provide a synchronous shim implementation. The cool\n * thing is that awaiting a non-Promise will convert it into a Promise, so\n * extending the type definition to return a `Promise` shouldn't break anything.\n *\n * @see https://bit.ly/2PjDnXi - GitHub comment\n *\n * @param urls - Scripts to load\n *\n * @returns Promise resolving with no result\n */\ndeclare global {\n  function importScripts(...urls: string[]): Promise<void> | void\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nlet index: Search\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch (= import) multi-language support through `lunr-languages`\n *\n * This function automatically imports the stemmers necessary to process the\n * languages which are defined as part of the search configuration.\n *\n * If the worker runs inside of an `iframe` (when using `iframe-worker` as\n * a shim), the base URL for the stemmers to be loaded must be determined by\n * searching for the first `script` element with a `src` attribute, which will\n * contain the contents of this script.\n *\n * @param config - Search configuration\n *\n * @returns Promise resolving with no result\n */\nasync function setupSearchLanguages(\n  config: SearchConfig\n): Promise<void> {\n  let base = \"../lunr\"\n\n  /* Detect `iframe-worker` and fix base URL */\n  if (typeof parent !== \"undefined\" && \"IFrameWorker\" in parent) {\n    const worker = getElement<HTMLScriptElement>(\"script[src]\")\n    const [path] = worker.src.split(\"/worker\")\n\n    /* Prefix base with path */\n    base = base.replace(\"..\", path)\n  }\n\n  /* Add scripts for languages */\n  const scripts = []\n  for (const lang of config.lang) {\n    switch (lang) {\n\n      /* Add segmenter for Japanese */\n      case \"ja\":\n        scripts.push(`${base}/tinyseg.js`)\n        break\n\n      /* Add segmenter for Hindi and Thai */\n      case \"hi\":\n      case \"th\":\n        scripts.push(`${base}/wordcut.js`)\n        break\n    }\n\n    /* Add language support */\n    if (lang !== \"en\")\n      scripts.push(`${base}/min/lunr.${lang}.min.js`)\n  }\n\n  /* Add multi-language support */\n  if (config.lang.length > 1)\n    scripts.push(`${base}/min/lunr.multi.min.js`)\n\n  /* Load scripts synchronously */\n  if (scripts.length)\n    await importScripts(\n      `${base}/min/lunr.stemmer.support.min.js`,\n      ...scripts\n    )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Message handler\n *\n * @param message - Source message\n *\n * @returns Target message\n */\nexport async function handler(\n  message: SearchMessage\n): Promise<SearchMessage> {\n  switch (message.type) {\n\n    /* Search setup message */\n    case SearchMessageType.SETUP:\n      await setupSearchLanguages(message.data.config)\n      index = new Search(message.data)\n      return {\n        type: SearchMessageType.READY\n      }\n\n    /* Search query message */\n    case SearchMessageType.QUERY:\n      const query = message.data\n      try {\n        return {\n          type: SearchMessageType.RESULT,\n          data: index.search(query)\n        }\n\n      /* Return empty result in case of error */\n      } catch (err) {\n        console.warn(`Invalid query: ${query} \u2013 see https://bit.ly/2s3ChXG`)\n        console.warn(err)\n        return {\n          type: SearchMessageType.RESULT,\n          data: { items: [] }\n        }\n      }\n\n    /* All other messages */\n    default:\n      throw new TypeError(\"Invalid message type\")\n  }\n}\n\n/* ----------------------------------------------------------------------------\n * Worker\n * ------------------------------------------------------------------------- */\n\n/* Expose Lunr.js in global scope, or stemmers won't work */\nself.lunr = lunr\n\n/* Monkey-patch Lunr.js to mitigate https://t.ly/68TLq */\nlunr.utils.warn = console.warn\n\n/* Handle messages */\naddEventListener(\"message\", async ev => {\n  postMessage(await handler(ev.data))\n})\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T[]\n\nexport function getElements<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T[] {\n  return Array.from(node.querySelectorAll<T>(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T\n\nexport function getElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T {\n  const el = getOptionalElement<T>(selector, node)\n  if (typeof el === \"undefined\")\n    throw new ReferenceError(\n      `Missing element: expected \"${selector}\" to be present`\n    )\n\n  /* Return element */\n  return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement<T extends keyof HTMLElementTagNameMap>(\n  selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement<T extends HTMLElement>(\n  selector: string, node: ParentNode = document\n): T | undefined {\n  return node.querySelector<T>(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n  return (\n    document.activeElement?.shadowRoot?.activeElement as HTMLElement ??\n    document.activeElement as HTMLElement ??\n    undefined\n  )\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n  Object.entries = function (obj: object) {\n    const data: [string, string][] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push([key, obj[key]])\n\n    /* Return entries */\n    return data\n  }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n  Object.values = function (obj: object) {\n    const data: string[] = []\n    for (const key of Object.keys(obj))\n      // @ts-expect-error - ignore property access warning\n      data.push(obj[key])\n\n    /* Return values */\n    return data\n  }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n  /* Polyfill `Element.scrollTo` */\n  if (!Element.prototype.scrollTo)\n    Element.prototype.scrollTo = function (\n      x?: ScrollToOptions | number, y?: number\n    ): void {\n      if (typeof x === \"object\") {\n        this.scrollLeft = x.left!\n        this.scrollTop = x.top!\n      } else {\n        this.scrollLeft = x!\n        this.scrollTop = y!\n      }\n    }\n\n  /* Polyfill `Element.replaceWith` */\n  if (!Element.prototype.replaceWith)\n    Element.prototype.replaceWith = function (\n      ...nodes: Array<string | Node>\n    ): void {\n      const parent = this.parentNode\n      if (parent) {\n        if (nodes.length === 0)\n          parent.removeChild(this)\n\n        /* Replace children and create text nodes */\n        for (let i = nodes.length - 1; i >= 0; i--) {\n          let node = nodes[i]\n          if (typeof node === \"string\")\n            node = document.createTextNode(node)\n          else if (node.parentNode)\n            node.parentNode.removeChild(node)\n\n          /* Replace child or insert before previous sibling */\n          if (!i)\n            parent.replaceChild(node, this)\n          else\n            parent.insertBefore(this.previousSibling!, node)\n        }\n      }\n    }\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search configuration\n */\nexport interface SearchConfig {\n  lang: string[]                       /* Search languages */\n  separator: string                    /* Search separator */\n  pipeline: SearchPipelineFn[]         /* Search pipeline */\n}\n\n/**\n * Search document\n */\nexport interface SearchDocument {\n  location: string                     /* Document location */\n  title: string                        /* Document title */\n  text: string                         /* Document text */\n  tags?: string[]                      /* Document tags */\n  boost?: number                       /* Document boost */\n  parent?: SearchDocument              /* Document parent */\n}\n\n/**\n * Search options\n */\nexport interface SearchOptions {\n  suggest: boolean                     /* Search suggestions */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nexport interface SearchIndex {\n  config: SearchConfig                 /* Search configuration */\n  docs: SearchDocument[]               /* Search documents */\n  options: SearchOptions               /* Search options */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search pipeline function\n */\ntype SearchPipelineFn =\n  | \"trimmer\"                          /* Trimmer */\n  | \"stopWordFilter\"                   /* Stop word filter */\n  | \"stemmer\"                          /* Stemmer */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search document map\n *\n * This function creates a mapping of URLs (including anchors) to the actual\n * articles and sections. It relies on the invariant that the search index is\n * ordered with the main article appearing before all sections with anchors.\n * If this is not the case, the logic music be changed.\n *\n * @param docs - Search documents\n *\n * @returns Search document map\n */\nexport function setupSearchDocumentMap(\n  docs: SearchDocument[]\n): Map<string, SearchDocument> {\n  const map = new Map<string, SearchDocument>()\n  for (const doc of docs) {\n    const [path] = doc.location.split(\"#\")\n\n    /* Add document article */\n    const article = map.get(path)\n    if (typeof article === \"undefined\") {\n      map.set(path, doc)\n\n      /* Add document section */\n    } else {\n      map.set(doc.location, doc)\n      doc.parent = article\n    }\n  }\n\n  /* Return search document map */\n  return map\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Visitor function\n *\n * @param start - Start offset\n * @param end - End offset\n */\ntype VisitorFn = (\n  start: number, end: number\n) => void\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Split a string using the given separator\n *\n * @param input - Input value\n * @param separator - Separator\n * @param fn - Visitor function\n */\nexport function split(\n  input: string, separator: RegExp, fn: VisitorFn\n): void {\n  separator = new RegExp(separator, \"g\")\n\n  /* Split string using separator */\n  let match: RegExpExecArray | null\n  let index = 0\n  do {\n    match = separator.exec(input)\n\n    /* Emit non-empty range */\n    const until = match?.index ?? input.length\n    if (index < until)\n      fn(index, until)\n\n    /* Update last index */\n    if (match) {\n      const [term] = match\n      index = match.index + term.length\n\n      /* Support zero-length lookaheads */\n      if (term.length === 0)\n        separator.lastIndex = match.index + 1\n    }\n  } while (match)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Extraction type\n *\n * This type defines the possible values that are encoded into the first two\n * bits of a section that is part of the blocks of a tokenization table. There\n * are three types of interest: HTML opening and closing tags, as well as the\n * actual text content we need to extract for indexing.\n */\nexport const enum Extract {\n  TAG_OPEN  = 0,                       /* HTML opening tag */\n  TEXT      = 1,                       /* Text content */\n  TAG_CLOSE = 2                        /* HTML closing tag */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Visitor function\n *\n * @param block - Block index\n * @param type - Extraction type\n * @param start - Start offset\n * @param end - End offset\n */\ntype VisitorFn = (\n  block: number, type: Extract, start: number, end: number\n) => void\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Split a string into markup and text sections\n *\n * This function scans a string and divides it up into sections of markup and\n * text. For each section, it invokes the given visitor function with the block\n * index, extraction type, as well as start and end offsets. Using a visitor\n * function (= streaming data) is ideal for minimizing pressure on the GC.\n *\n * @param input - Input value\n * @param fn - Visitor function\n */\nexport function extract(\n  input: string, fn: VisitorFn\n): void {\n\n  let block = 0                        /* Current block */\n  let start = 0                        /* Current start offset */\n  let end = 0                          /* Current end offset */\n\n  /* Split string into sections */\n  for (let stack = 0; end < input.length; end++) {\n\n    /* Opening tag after non-empty section */\n    if (input.charAt(end) === \"<\" && end > start) {\n      fn(block, Extract.TEXT, start, start = end)\n\n    /* Closing tag */\n    } else if (input.charAt(end) === \">\") {\n      if (input.charAt(start + 1) === \"/\") {\n        if (--stack === 0)\n          fn(block++, Extract.TAG_CLOSE, start, end + 1)\n\n      /* Tag is not self-closing */\n      } else if (input.charAt(end - 1) !== \"/\") {\n        if (stack++ === 0)\n          fn(block, Extract.TAG_OPEN, start, end + 1)\n      }\n\n      /* New section */\n      start = end + 1\n    }\n  }\n\n  /* Add trailing section */\n  if (end > start)\n    fn(block, Extract.TEXT, start, end)\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Position table\n */\nexport type PositionTable = number[][]\n\n/**\n * Position\n */\nexport type Position = number\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Highlight all occurrences in a string\n *\n * This function receives a field's value (e.g. like `title` or `text`), it's\n * position table that was generated during indexing, and the positions found\n * when executing the query. It then highlights all occurrences, and returns\n * their concatenation. In case of multiple blocks, two are returned.\n *\n * @param input - Input value\n * @param table - Table for indexing\n * @param positions - Occurrences\n * @param full - Full results\n *\n * @returns Highlighted string value\n */\nexport function highlight(\n  input: string, table: PositionTable, positions: Position[], full = false\n): string {\n  return highlightAll([input], table, positions, full).pop()!\n}\n\n/**\n * Highlight all occurrences in a set of strings\n *\n * @param inputs - Input values\n * @param table - Table for indexing\n * @param positions - Occurrences\n * @param full - Full results\n *\n * @returns Highlighted string values\n */\nexport function highlightAll(\n  inputs: string[], table: PositionTable, positions: Position[], full = false\n): string[] {\n\n  /* Map blocks to input values */\n  const mapping = [0]\n  for (let t = 1; t < table.length; t++) {\n    const prev = table[t - 1]\n    const next = table[t]\n\n    /* Check if table points to new block */\n    const p = prev[prev.length - 1] >>> 2 & 0x3FF\n    const q = next[0]               >>> 12\n\n    /* Add block to mapping */\n    mapping.push(+(p > q) + mapping[mapping.length - 1])\n  }\n\n  /* Highlight strings one after another */\n  return inputs.map((input, i) => {\n    let cursor = 0\n\n    /* Map occurrences to blocks */\n    const blocks = new Map<number, number[]>()\n    for (const p of positions.sort((a, b) => a - b)) {\n      const index = p & 0xFFFFF\n      const block = p >>> 20\n      if (mapping[block] !== i)\n        continue\n\n      /* Ensure presence of block group */\n      let group = blocks.get(block)\n      if (typeof group === \"undefined\")\n        blocks.set(block, group = [])\n\n      /* Add index to group */\n      group.push(index)\n    }\n\n    /* Just return string, if no occurrences */\n    if (blocks.size === 0)\n      return input\n\n    /* Compute slices */\n    const slices: string[] = []\n    for (const [block, indexes] of blocks) {\n      const t = table[block]\n\n      /* Extract positions and length */\n      const start  = t[0]            >>> 12\n      const end    = t[t.length - 1] >>> 12\n      const length = t[t.length - 1] >>> 2 & 0x3FF\n\n      /* Add prefix, if full results are desired */\n      if (full && start > cursor)\n        slices.push(input.slice(cursor, start))\n\n      /* Extract and highlight slice */\n      let slice = input.slice(start, end + length)\n      for (const j of indexes.sort((a, b) => b - a)) {\n\n        /* Retrieve offset and length of match */\n        const p = (t[j] >>> 12) - start\n        const q = (t[j] >>> 2 & 0x3FF) + p\n\n        /* Wrap occurrence */\n        slice = [\n          slice.slice(0, p),\n          \"<mark>\",\n          slice.slice(p, q),\n          \"</mark>\",\n          slice.slice(q)\n        ].join(\"\")\n      }\n\n      /* Update cursor */\n      cursor = end + length\n\n      /* Append slice and abort if we have two */\n      if (slices.push(slice) === 2)\n        break\n    }\n\n    /* Add suffix, if full results are desired */\n    if (full && cursor < input.length)\n      slices.push(input.slice(cursor))\n\n    /* Return highlighted slices */\n    return slices.join(\"\")\n  })\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { split } from \"../_\"\nimport {\n  Extract,\n  extract\n} from \"../extract\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Split a string or set of strings into tokens\n *\n * This tokenizer supersedes the default tokenizer that is provided by Lunr.js,\n * as it is aware of HTML tags and allows for multi-character splitting.\n *\n * It takes the given inputs, splits each of them into markup and text sections,\n * tokenizes and segments (if necessary) each of them, and then indexes them in\n * a table by using a compact bit representation. Bitwise techniques are used\n * to write and read from the table during indexing and querying.\n *\n * @see https://bit.ly/3W3Xw4J - Search: better, faster, smaller\n *\n * @param input - Input value(s)\n *\n * @returns Tokens\n */\nexport function tokenize(\n  input?: string | string[]\n): lunr.Token[] {\n  const tokens: lunr.Token[] = []\n  if (typeof input === \"undefined\")\n    return tokens\n\n  /* Tokenize strings one after another */\n  const inputs = Array.isArray(input) ? input : [input]\n  for (let i = 0; i < inputs.length; i++) {\n    const table = lunr.tokenizer.table\n    const total = table.length\n\n    /* Split string into sections and tokenize content blocks */\n    extract(inputs[i], (block, type, start, end) => {\n      table[block += total] ||= []\n      switch (type) {\n\n        /* Handle markup */\n        case Extract.TAG_OPEN:\n        case Extract.TAG_CLOSE:\n          table[block].push(\n            start       << 12 |\n            end - start <<  2 |\n            type\n          )\n          break\n\n        /* Handle text content */\n        case Extract.TEXT:\n          const section = inputs[i].slice(start, end)\n          split(section, lunr.tokenizer.separator, (index, until) => {\n\n            /**\n             * Apply segmenter after tokenization. Note that the segmenter will\n             * also split words at word boundaries, which is not what we want,\n             * so we need to check if we can somehow mitigate this behavior.\n             */\n            if (typeof lunr.segmenter !== \"undefined\") {\n              const subsection = section.slice(index, until)\n              if (/^[MHIK]$/.test(lunr.segmenter.ctype_(subsection))) {\n                const segments = lunr.segmenter.segment(subsection)\n                for (let s = 0, l = 0; s < segments.length; s++) {\n\n                  /* Add block to section */\n                  table[block] ||= []\n                  table[block].push(\n                    start + index + l  << 12 |\n                    segments[s].length <<  2 |\n                    type\n                  )\n\n                  /* Add token with position */\n                  tokens.push(new lunr.Token(\n                    segments[s].toLowerCase(), {\n                      position: block << 20 | table[block].length - 1\n                    }\n                  ))\n\n                  /* Keep track of length */\n                  l += segments[s].length\n                }\n                return\n              }\n            }\n\n            /* Add block to section */\n            table[block].push(\n              start + index << 12 |\n              until - index <<  2 |\n              type\n            )\n\n            /* Add token with position */\n            tokens.push(new lunr.Token(\n              section.slice(index, until).toLowerCase(), {\n                position: block << 20 | table[block].length - 1\n              }\n            ))\n          })\n      }\n    })\n  }\n\n  /* Return tokens */\n  return tokens\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Visitor function\n *\n * @param value - String value\n *\n * @returns String term(s)\n */\ntype VisitorFn = (\n  value: string\n) => string | string[]\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Default transformation function\n *\n * 1. Trim excess whitespace from left and right.\n *\n * 2. Search for parts in quotation marks and prepend a `+` modifier to denote\n *    that the resulting document must contain all parts, converting the query\n *    to an `AND` query (as opposed to the default `OR` behavior). While users\n *    may expect parts enclosed in quotation marks to map to span queries, i.e.\n *    for which order is important, Lunr.js doesn't support them, so the best\n *    we can do is to convert the parts to an `AND` query.\n *\n * 3. Replace control characters which are not located at the beginning of the\n *    query or preceded by white space, or are not followed by a non-whitespace\n *    character or are at the end of the query string. Furthermore, filter\n *    unmatched quotation marks.\n *\n * 4. Split the query string at whitespace, then pass each part to the visitor\n *    function for tokenization, and append a wildcard to every resulting term\n *    that is not explicitly marked with a `+`, `-`, `~` or `^` modifier, since\n *    it ensures consistent and stable ranking when multiple terms are entered.\n *    Also, if a fuzzy or boost modifier are given, but no numeric value has\n *    been entered, default to 1 to not induce a query error.\n *\n * @param query - Query value\n * @param fn - Visitor function\n *\n * @returns Transformed query value\n */\nexport function transform(\n  query: string, fn: VisitorFn = term => term\n): string {\n  return query\n\n    /* => 1 */\n    .trim()\n\n    /* => 2 */\n    .split(/\"([^\"]+)\"/g)\n      .map((parts, index) => index & 1\n        ? parts.replace(/^\\b|^(?![^\\x00-\\x7F]|$)|\\s+/g, \" +\")\n        : parts\n      )\n      .join(\"\")\n\n    /* => 3 */\n    .replace(/\"|(?:^|\\s+)[*+\\-:^~]+(?=\\s+|$)/g, \"\")\n\n    /* => 4 */\n    .split(/\\s+/g)\n      .reduce((prev, term) => {\n        const next = fn(term)\n        return [...prev, ...Array.isArray(next) ? next : [next]]\n      }, [] as string[])\n      .map(term => /([~^]$)/.test(term) ? `${term}1` : term)\n      .map(term => /(^[+-]|[~^]\\d+$)/.test(term) ? term : `${term}*`)\n      .join(\" \")\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { split } from \"../../internal\"\nimport { transform } from \"../transform\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query clause\n */\nexport interface SearchQueryClause {\n  presence: lunr.Query.presence        /* Clause presence */\n  term: string                         /* Clause term */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search query terms\n */\nexport type SearchQueryTerms = Record<string, boolean>\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Transform search query\n *\n * This function lexes the given search query and applies the transformation\n * function to each term, preserving markup like `+` and `-` modifiers.\n *\n * @param query - Search query\n *\n * @returns Search query\n */\nexport function transformSearchQuery(\n  query: string\n): string {\n\n  /* Split query terms with tokenizer */\n  return transform(query, part => {\n    const terms: string[] = []\n\n    /* Initialize lexer and analyze part */\n    const lexer = new lunr.QueryLexer(part)\n    lexer.run()\n\n    /* Extract and tokenize term from lexeme */\n    for (const { type, str: term, start, end } of lexer.lexemes)\n      switch (type) {\n\n        /* Hack: remove colon - see https://bit.ly/3wD3T3I */\n        case \"FIELD\":\n          if (![\"title\", \"text\", \"tags\"].includes(term))\n            part = [\n              part.slice(0, end),\n              \" \",\n              part.slice(end + 1)\n            ].join(\"\")\n          break\n\n        /* Tokenize term */\n        case \"TERM\":\n          split(term, lunr.tokenizer.separator, (...range) => {\n            terms.push([\n              part.slice(0, start),\n              term.slice(...range),\n              part.slice(end)\n            ].join(\"\"))\n          })\n      }\n\n    /* Return terms */\n    return terms\n  })\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Parse a search query for analysis\n *\n * Lunr.js itself has a bug where it doesn't detect or remove wildcards for\n * query clauses, so we must do this here.\n *\n * @see https://bit.ly/3DpTGtz - GitHub issue\n *\n * @param value - Query value\n *\n * @returns Search query clauses\n */\nexport function parseSearchQuery(\n  value: string\n): SearchQueryClause[] {\n  const query  = new lunr.Query([\"title\", \"text\", \"tags\"])\n  const parser = new lunr.QueryParser(value, query)\n\n  /* Parse Search query */\n  parser.parse()\n  for (const clause of query.clauses) {\n    clause.usePipeline = true\n\n    /* Handle leading wildcard */\n    if (clause.term.startsWith(\"*\")) {\n      clause.wildcard = lunr.Query.wildcard.LEADING\n      clause.term = clause.term.slice(1)\n    }\n\n    /* Handle trailing wildcard */\n    if (clause.term.endsWith(\"*\")) {\n      clause.wildcard = lunr.Query.wildcard.TRAILING\n      clause.term = clause.term.slice(0, -1)\n    }\n  }\n\n  /* Return query clauses */\n  return query.clauses\n}\n\n/**\n * Analyze the search query clauses in regard to the search terms found\n *\n * @param query - Search query clauses\n * @param terms - Search terms\n *\n * @returns Search query terms\n */\nexport function getSearchQueryTerms(\n  query: SearchQueryClause[], terms: string[]\n): SearchQueryTerms {\n  const clauses = new Set<SearchQueryClause>(query)\n\n  /* Match query clauses against terms */\n  const result: SearchQueryTerms = {}\n  for (let t = 0; t < terms.length; t++)\n    for (const clause of clauses)\n      if (terms[t].startsWith(clause.term)) {\n        result[clause.term] = true\n        clauses.delete(clause)\n      }\n\n  /* Annotate unmatched non-stopword query clauses */\n  for (const clause of clauses)\n    if (lunr.stopWordFilter?.(clause.term))\n      result[clause.term] = false\n\n  /* Return query terms */\n  return result\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Segment a search query using the inverted index\n *\n * This function implements a clever approach to text segmentation for Asian\n * languages, as it used the information already available in the search index.\n * The idea is to greedily segment the search query based on the tokens that are\n * already part of the index, as described in the linked issue.\n *\n * @see https://bit.ly/3lwjrk7 - GitHub issue\n *\n * @param query - Query value\n * @param index - Inverted index\n *\n * @returns Segmented query value\n */\nexport function segment(\n  query: string, index: object\n): Iterable<string> {\n  const segments = new Set<string>()\n\n  /* Segment search query */\n  const wordcuts = new Uint16Array(query.length)\n  for (let i = 0; i < query.length; i++)\n    for (let j = i + 1; j < query.length; j++) {\n      const value = query.slice(i, j)\n      if (value in index)\n        wordcuts[i] = j - i\n    }\n\n  /* Compute longest matches with minimum overlap */\n  const stack = [0]\n  for (let s = stack.length; s > 0;) {\n    const p = stack[--s]\n    for (let q = 1; q < wordcuts[p]; q++)\n      if (wordcuts[p + q] > wordcuts[p] - q) {\n        segments.add(query.slice(p, p + q))\n        stack[s++] = p + q\n      }\n\n    /* Continue at end of query string */\n    const q = p + wordcuts[p]\n    if (wordcuts[q] && q < query.length - 1)\n      stack[s++] = q\n\n    /* Add current segment */\n    segments.add(query.slice(p, q))\n  }\n\n  // @todo fix this case in the code block above, this is a hotfix\n  if (segments.has(\"\"))\n    return new Set([query])\n\n  /* Return segmented query value */\n  return segments\n}\n", "/*\n * Copyright (c) 2016-2024 Martin Donath <martin.donath@squidfunk.com>\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n  SearchDocument,\n  SearchIndex,\n  SearchOptions,\n  setupSearchDocumentMap\n} from \"../config\"\nimport {\n  Position,\n  PositionTable,\n  highlight,\n  highlightAll,\n  tokenize\n} from \"../internal\"\nimport {\n  SearchQueryTerms,\n  getSearchQueryTerms,\n  parseSearchQuery,\n  segment,\n  transformSearchQuery\n} from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search item\n */\nexport interface SearchItem\n  extends SearchDocument\n{\n  score: number                        /* Score (relevance) */\n  terms: SearchQueryTerms              /* Search query terms */\n}\n\n/**\n * Search result\n */\nexport interface SearchResult {\n  items: SearchItem[][]                /* Search items */\n  suggest?: string[]                   /* Search suggestions */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create field extractor factory\n *\n * @param table - Position table map\n *\n * @returns Extractor factory\n */\nfunction extractor(table: Map<string, PositionTable>) {\n  return (name: keyof SearchDocument) => {\n    return (doc: SearchDocument) => {\n      if (typeof doc[name] === \"undefined\")\n        return undefined\n\n      /* Compute identifier and initialize table */\n      const id = [doc.location, name].join(\":\")\n      table.set(id, lunr.tokenizer.table = [])\n\n      /* Return field value */\n      return doc[name]\n    }\n  }\n}\n\n/**\n * Compute the difference of two lists of strings\n *\n * @param a - 1st list of strings\n * @param b - 2nd list of strings\n *\n * @returns Difference\n */\nfunction difference(a: string[], b: string[]): string[] {\n  const [x, y] = [new Set(a), new Set(b)]\n  return [\n    ...new Set([...x].filter(value => !y.has(value)))\n  ]\n}\n\n/* ----------------------------------------------------------------------------\n * Class\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nexport class Search {\n\n  /**\n   * Search document map\n   */\n  protected map: Map<string, SearchDocument>\n\n  /**\n   * Search options\n   */\n  protected options: SearchOptions\n\n  /**\n   * The underlying Lunr.js search index\n   */\n  protected index: lunr.Index\n\n  /**\n   * Internal position table map\n   */\n  protected table: Map<string, PositionTable>\n\n  /**\n   * Create the search integration\n   *\n   * @param data - Search index\n   */\n  public constructor({ config, docs, options }: SearchIndex) {\n    const field = extractor(this.table = new Map())\n\n    /* Set up document map and options */\n    this.map = setupSearchDocumentMap(docs)\n    this.options = options\n\n    /* Set up document index */\n    this.index = lunr(function () {\n      this.metadataWhitelist = [\"position\"]\n      this.b(0)\n\n      /* Set up (multi-)language support */\n      if (config.lang.length === 1 && config.lang[0] !== \"en\") {\n        // @ts-expect-error - namespace indexing not supported\n        this.use(lunr[config.lang[0]])\n      } else if (config.lang.length > 1) {\n        this.use(lunr.multiLanguage(...config.lang))\n      }\n\n      /* Set up custom tokenizer (must be after language setup) */\n      this.tokenizer = tokenize as typeof lunr.tokenizer\n      lunr.tokenizer.separator = new RegExp(config.separator)\n\n      /* Set up custom segmenter, if loaded */\n      lunr.segmenter = \"TinySegmenter\" in lunr\n        ? new lunr.TinySegmenter()\n        : undefined\n\n      /* Compute functions to be removed from the pipeline */\n      const fns = difference([\n        \"trimmer\", \"stopWordFilter\", \"stemmer\"\n      ], config.pipeline)\n\n      /* Remove functions from the pipeline for registered languages */\n      for (const lang of config.lang.map(language => (\n        // @ts-expect-error - namespace indexing not supported\n        language === \"en\" ? lunr : lunr[language]\n      )))\n        for (const fn of fns) {\n          this.pipeline.remove(lang[fn])\n          this.searchPipeline.remove(lang[fn])\n        }\n\n      /* Set up index reference */\n      this.ref(\"location\")\n\n      /* Set up index fields */\n      this.field(\"title\", { boost: 1e3, extractor: field(\"title\") })\n      this.field(\"text\",  { boost: 1e0, extractor: field(\"text\") })\n      this.field(\"tags\",  { boost: 1e6, extractor: field(\"tags\") })\n\n      /* Add documents to index */\n      for (const doc of docs)\n        this.add(doc, { boost: doc.boost })\n    })\n  }\n\n  /**\n   * Search for matching documents\n   *\n   * @param query - Search query\n   *\n   * @returns Search result\n   */\n  public search(query: string): SearchResult {\n\n    // Experimental Chinese segmentation\n    query = query.replace(/\\p{sc=Han}+/gu, value => {\n      return [...segment(value, this.index.invertedIndex)]\n        .join(\"* \")\n    })\n\n    // @todo: move segmenter (above) into transformSearchQuery\n    query = transformSearchQuery(query)\n    if (!query)\n      return { items: [] }\n\n    /* Parse query to extract clauses for analysis */\n    const clauses = parseSearchQuery(query)\n      .filter(clause => (\n        clause.presence !== lunr.Query.presence.PROHIBITED\n      ))\n\n    /* Perform search and post-process results */\n    const groups = this.index.search(query)\n\n      /* Apply post-query boosts based on title and search query terms */\n      .reduce<SearchItem[]>((item, { ref, score, matchData }) => {\n        let doc = this.map.get(ref)\n        if (typeof doc !== \"undefined\") {\n\n          /* Shallow copy document */\n          doc = { ...doc }\n          if (doc.tags)\n            doc.tags = [...doc.tags]\n\n          /* Compute and analyze search query terms */\n          const terms = getSearchQueryTerms(\n            clauses,\n            Object.keys(matchData.metadata)\n          )\n\n          /* Highlight matches in fields */\n          for (const field of this.index.fields) {\n            if (typeof doc[field] === \"undefined\")\n              continue\n\n            /* Collect positions from matches */\n            const positions: Position[] = []\n            for (const match of Object.values(matchData.metadata))\n              if (typeof match[field] !== \"undefined\")\n                positions.push(...match[field].position)\n\n            /* Skip highlighting, if no positions were collected */\n            if (!positions.length)\n              continue\n\n            /* Load table and determine highlighting method */\n            const table = this.table.get([doc.location, field].join(\":\"))!\n            const fn = Array.isArray(doc[field])\n              ? highlightAll\n              : highlight\n\n            // @ts-expect-error - stop moaning, TypeScript!\n            doc[field] = fn(doc[field], table, positions, field !== \"text\")\n          }\n\n          /* Highlight title and text and apply post-query boosts */\n          const boost = +!doc.parent +\n            Object.values(terms)\n              .filter(t => t).length /\n            Object.keys(terms).length\n\n          /* Append item */\n          item.push({\n            ...doc,\n            score: score * (1 + boost ** 2),\n            terms\n          })\n        }\n        return item\n      }, [])\n\n      /* Sort search results again after applying boosts */\n      .sort((a, b) => b.score - a.score)\n\n      /* Group search results by article */\n      .reduce((items, result) => {\n        const doc = this.map.get(result.location)\n        if (typeof doc !== \"undefined\") {\n          const ref = doc.parent\n            ? doc.parent.location\n            : doc.location\n          items.set(ref, [...items.get(ref) || [], result])\n        }\n        return items\n      }, new Map<string, SearchItem[]>())\n\n    /* Ensure that every item set has an article */\n    for (const [ref, items] of groups)\n      if (!items.find(item => item.location === ref)) {\n        const doc = this.map.get(ref)!\n        items.push({ ...doc, score: 0, terms: {} })\n      }\n\n    /* Generate search suggestions, if desired */\n    let suggest: string[] | undefined\n    if (this.options.suggest) {\n      const titles = this.index.query(builder => {\n        for (const clause of clauses)\n          builder.term(clause.term, {\n            fields: [\"title\"],\n            presence: lunr.Query.presence.REQUIRED,\n            wildcard: lunr.Query.wildcard.TRAILING\n          })\n      })\n\n      /* Retrieve suggestions for best match */\n      suggest = titles.length\n        ? Object.keys(titles[0].matchData.metadata)\n        : []\n    }\n\n    /* Return search result */\n    return {\n      items: [...groups.values()],\n      ...typeof suggest !== \"undefined\" && { suggest }\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["require_lunr", "__commonJSMin", "exports", "module", "lunr", "config", "builder", "global", "message", "obj", "clone", "keys", "key", "val", "docRef", "fieldName", "stringValue", "s", "n", "fieldRef", "elements", "i", "other", "object", "a", "b", "intersection", "element", "posting", "documentCount", "documentsWithTerm", "x", "str", "metadata", "fn", "t", "len", "tokens", "sliceEnd", "sliceStart", "char", "sliceLength", "tokenMetadata", "label", "isRegistered", "serialised", "pipeline", "fnName", "fns", "existingFn", "newFn", "pos", "stackLength", "memo", "j", "result", "k", "token", "index", "start", "end", "pivotPoint", "pivotIndex", "insertIdx", "position", "sumOfSquares", "elementsLength", "otherVector", "dotProduct", "aLen", "bLen", "aVal", "bVal", "output", "step2list", "step3list", "c", "v", "C", "V", "mgr0", "meq1", "mgr1", "s_v", "re_mgr0", "re_mgr1", "re_meq1", "re_s_v", "re_1a", "re2_1a", "re_1b", "re2_1b", "re_1b_2", "re2_1b_2", "re3_1b_2", "re4_1b_2", "re_1c", "re_2", "re_3", "re_4", "re2_4", "re_5", "re_5_1", "re3_5", "porterStemmer", "w", "stem", "suffix", "firstch", "re", "re2", "re3", "re4", "fp", "stopWords", "words", "stopWord", "arr", "clause", "editDistance", "root", "stack", "frame", "noEditNode", "insertionNode", "substitutionNode", "charA", "charB", "transposeNode", "node", "final", "next", "edges", "edge", "labels", "qEdges", "qLen", "nEdges", "nLen", "q", "qEdge", "nEdge", "qNode", "word", "commonPrefix", "nextNode", "downTo", "childKey", "attrs", "queryString", "query", "parser", "matchingFields", "queryVectors", "termFieldCache", "requiredMatches", "prohibitedMatches", "terms", "clauseMatches", "m", "term", "termTokenSet", "expandedTerms", "field", "expandedTerm", "termIndex", "fieldPosting", "matchingDocumentRefs", "termField", "matchingDocumentsSet", "l", "matchingDocumentRef", "matchingFieldRef", "fieldMatch", "allRequiredMatches", "allProhibitedMatches", "matchingFieldRefs", "results", "matches", "fieldVector", "score", "docMatch", "match", "invertedIndex", "fieldVectors", "ref", "serializedIndex", "serializedVectors", "serializedInvertedIndex", "tokenSetBuilder", "tuple", "attributes", "number", "doc", "fields", "extractor", "fieldTerms", "metadataKey", "fieldRefs", "numberOfFields", "accumulator", "documentsWithField", "fieldRefsLength", "termIdfCache", "fieldLength", "termFrequencies", "termsLength", "fieldBoost", "docBoost", "tf", "idf", "scoreWithPrecision", "args", "clonedMetadata", "metadataKeys", "otherMatchData", "allFields", "options", "state", "subSlices", "type", "charCode", "lexer", "lexeme", "completedClause", "errorMessage", "nextLexeme", "possibleFields", "f", "boost", "factory", "import_lunr", "getElement", "selector", "node", "el", "getOptionalElement", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "setupSearchDocumentMap", "docs", "map", "doc", "path", "article", "split", "input", "separator", "fn", "_a", "match", "index", "until", "term", "extract", "input", "fn", "block", "start", "end", "stack", "highlight", "input", "table", "positions", "full", "highlightAll", "inputs", "mapping", "t", "prev", "next", "p", "q", "i", "cursor", "blocks", "a", "b", "index", "block", "group", "slices", "indexes", "start", "end", "length", "slice", "j", "tokenize", "input", "tokens", "inputs", "i", "table", "total", "extract", "block", "type", "start", "end", "_a", "section", "split", "index", "until", "subsection", "segments", "s", "l", "transform", "query", "fn", "term", "parts", "index", "prev", "next", "transformSearchQuery", "query", "transform", "part", "terms", "lexer", "type", "term", "start", "end", "split", "range", "parseSearchQuery", "value", "clause", "getSearchQueryTerms", "_a", "clauses", "result", "t", "segment", "query", "index", "segments", "wordcuts", "i", "j", "stack", "p", "q", "extractor", "table", "name", "doc", "id", "difference", "a", "b", "x", "y", "value", "Search", "config", "docs", "options", "field", "setupSearchDocumentMap", "tokenize", "fns", "lang", "language", "fn", "query", "segment", "transformSearchQuery", "clauses", "parseSearchQuery", "clause", "groups", "item", "ref", "score", "matchData", "__spreadValues", "terms", "getSearchQueryTerms", "positions", "match", "highlightAll", "highlight", "boost", "t", "__spreadProps", "__pow", "items", "result", "suggest", "titles", "builder", "index", "setupSearchLanguages", "config", "__async", "base", "worker", "getElement", "path", "scripts", "lang", "handler", "message", "Search", "query", "err", "lunr", "ev"]
+}
diff --git a/latest/assets/stylesheets/main.6f8fc17f.min.css b/latest/assets/stylesheets/main.6f8fc17f.min.css
new file mode 100644
index 000000000..a0d06b0eb
--- /dev/null
+++ b/latest/assets/stylesheets/main.6f8fc17f.min.css
@@ -0,0 +1 @@
+@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:#0000;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-scheme=default]{color-scheme:light}[data-md-color-scheme=default] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=default] img[src$="#only-dark"]{display:none}:root,[data-md-color-scheme=default]{--md-hue:225deg;--md-default-fg-color:#000000de;--md-default-fg-color--light:#0000008a;--md-default-fg-color--lighter:#00000052;--md-default-fg-color--lightest:#00000012;--md-default-bg-color:#fff;--md-default-bg-color--light:#ffffffb3;--md-default-bg-color--lighter:#ffffff4d;--md-default-bg-color--lightest:#ffffff1f;--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-hl-color:#4287ff;--md-code-hl-color--light:#4287ff1a;--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-del-color:#f5503d26;--md-typeset-ins-color:#0bd57026;--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-mark-color:#ffff0080;--md-typeset-table-color:#0000001f;--md-typeset-table-color--light:rgba(0,0,0,.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-warning-fg-color:#000000de;--md-warning-bg-color:#ff9;--md-footer-fg-color:#fff;--md-footer-fg-color--light:#ffffffb3;--md-footer-fg-color--lighter:#ffffff73;--md-footer-bg-color:#000000de;--md-footer-bg-color--dark:#00000052;--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #0000001a,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0003,0 0 0.05rem #00000059}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}aside,body,input{font-feature-settings:"kern","liga";color:var(--md-typeset-color);font-family:var(--md-text-font-family)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m18 21-4-4h3V7h-3l4-4 4 4h-3v10h3M2 19v-2h10v2M2 13v-2h7v2M2 7V5h4v2z"/></svg>');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 17h3l-4 4-4-4h3V3h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2z"/></svg>');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7h3l-4-4-4 4h3v14h2M2 17h10v2H2M6 5v2H2V5m0 6h7v2H2z"/></svg>')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset h5 code{text-transform:none}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent)}.md-typeset a code{color:currentcolor;transition:background-color 125ms}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}.md-typeset ul[type]{list-style-type:revert-layer}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}.md-typeset ol ol ol ol,.md-typeset ul ol ol ol{list-style-type:upper-alpha}.md-typeset ol ol ol ol ol,.md-typeset ul ol ol ol ol{list-style-type:upper-roman}.md-typeset ol[type],.md-typeset ul[type]{list-style-type:revert-layer}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}[dir=ltr] .md-typeset ol li ol,[dir=ltr] .md-typeset ol li ul,[dir=ltr] .md-typeset ul li ol,[dir=ltr] .md-typeset ul li ul{margin-left:.625em}[dir=rtl] .md-typeset ol li ol,[dir=rtl] .md-typeset ol li ul,[dir=rtl] .md-typeset ul li ol,[dir=rtl] .md-typeset ul li ul{margin-right:.625em}.md-typeset ol li ol,.md-typeset ol li ul,.md-typeset ul li ol,.md-typeset ul li ul{margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block;margin:0 auto}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) td>:first-child,.md-typeset table:not([class]) th>:first-child{margin-top:0}.md-typeset table:not([class]) td>:last-child,.md-typeset table:not([class]) th>:last-child{margin-bottom:0}.md-typeset table:not([class]) td:not([align]),.md-typeset table:not([class]) th:not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) td:not([align]),[dir=rtl] .md-typeset table:not([class]) th:not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:var(--md-typeset-table-color--light);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.984375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-typeset .md-author{border-radius:100%;display:block;flex-shrink:0;height:1.6rem;overflow:hidden;position:relative;transition:color 125ms,transform 125ms;width:1.6rem}.md-typeset .md-author img{display:block}.md-typeset .md-author--more{background:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--lighter);font-size:.6rem;font-weight:700;line-height:1.6rem;text-align:center}.md-typeset .md-author--long{height:2.4rem;width:2.4rem}.md-typeset a.md-author{transform:scale(1)}.md-typeset a.md-author img{border-radius:100%;filter:grayscale(100%) opacity(75%);transition:filter 125ms}.md-typeset a.md-author:focus,.md-typeset a.md-author:hover{transform:scale(1.1);z-index:1}.md-typeset a.md-author:focus img,.md-typeset a.md-author:hover img{filter:grayscale(0)}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background-color:var(--md-warning-bg-color);color:var(--md-warning-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.no-js .md-banner__button{display:none}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.984375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 21H8V7h11m0-2H8a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h11a2 2 0 0 0 2-2V7a2 2 0 0 0-2-2m-3-4H4a2 2 0 0 0-2 2v14h2V3h12z"/></svg>')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;position:absolute;right:.5em;top:.5em;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:focus,.md-clipboard:hover{color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:focus code,.md-clipboard--inline:hover code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .md-code__content{display:grid}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:#0000008a;height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.984375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{display:flex;flex-wrap:wrap;place-content:baseline center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}@media print{.md-feedback{display:none}}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{align-items:end;display:flex;flex-grow:0.01;margin-bottom:.4rem;margin-top:1rem;max-width:100%;outline-color:var(--md-accent-fg-color);overflow:hidden;transition:opacity .25s}.md-footer__link:focus,.md-footer__link:hover{opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.984375em){.md-footer__link--prev{flex-shrink:0}.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;margin-bottom:.7rem;max-width:calc(100% - 2.4rem);padding:0 1rem;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;opacity:.7}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:focus,html .md-footer-meta.md-typeset a:hover{color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{display:inline-flex;gap:.2rem;margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:focus,.md-typeset .md-button:hover{background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:focus,.md-typeset .md-input:hover{border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem #0000,0 .2rem .4rem #0000;color:var(--md-primary-bg-color);display:block;left:0;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem #0000001a,0 .2rem .4rem #0003;transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.234375em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo img,.md-header__button.md-logo svg{fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-left:1rem;margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem;margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__option>input{bottom:0}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}.md-meta{color:var(--md-default-fg-color--light);font-size:.7rem;line-height:1.3}.md-meta__list{display:inline-flex;flex-wrap:wrap;list-style:none;margin:0;padding:0}.md-meta__item:not(:last-child):after{content:"·";margin-left:.2rem;margin-right:.2rem}.md-meta__link{color:var(--md-typeset-a-color)}.md-meta__link:focus,.md-meta__link:hover{color:var(--md-accent-fg-color)}.md-draft{background-color:#ff1744;border-radius:.125em;color:#fff;display:inline-block;font-weight:700;padding-left:.5714285714em;padding-right:.5714285714em}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6z"/></svg>');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 9h14V7H3zm0 4h14v-2H3zm0 4h14v-2H3zm16 0h2v-2h-2zm0-10v2h2V7zm0 6h2v-2h-2z"/></svg>')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{color:var(--md-default-fg-color--light);display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo img,.md-nav__title .md-nav__button.md-logo svg{fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__link{align-items:flex-start;display:flex;gap:.4rem;margin-top:.625em;scroll-snap-align:start;transition:color 125ms}.md-nav__link--passed{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active,.md-nav__item .md-nav__link--active code{color:var(--md-typeset-a-color)}.md-nav__link .md-ellipsis{position:relative}[dir=ltr] .md-nav__link .md-icon:last-child{margin-left:auto}[dir=rtl] .md-nav__link .md-icon:last-child{margin-right:auto}.md-nav__link svg{fill:currentcolor;flex-shrink:0;height:1.3em;position:relative}.md-nav__link[for]:focus,.md-nav__link[for]:hover,.md-nav__link[href]:focus,.md-nav__link[href]:hover{color:var(--md-accent-fg-color);cursor:pointer}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__container>.md-nav__link{margin-top:0}.md-nav__container>.md-nav__link:first-child{flex-grow:1;min-width:0}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.234375em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary .md-nav__item,.md-nav--primary .md-nav__title{font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest)}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:focus,.md-nav--primary .md-nav__item--active>.md-nav__link:hover{color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}.md-nav--primary .md-nav__link svg{margin-top:.1em}.md-nav--primary .md-nav__link>.md-nav__link{padding:0}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.984375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav{margin-bottom:-.4rem}.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--secondary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--secondary .md-nav__list{padding-right:.6rem}.md-nav--secondary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--secondary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--secondary .md-nav__item>.md-nav__link{margin-left:.4rem}}@media screen and (min-width:76.25em){.md-nav{margin-bottom:-.4rem;transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon{display:none}[dir=ltr] .md-nav--primary .md-nav__list{padding-left:.6rem}[dir=rtl] .md-nav--primary .md-nav__list{padding-right:.6rem}.md-nav--primary .md-nav__list{padding-bottom:.4rem}[dir=ltr] .md-nav--primary .md-nav__item>.md-nav__link{margin-right:.4rem}[dir=rtl] .md-nav--primary .md-nav__item>.md-nav__link{margin-left:.4rem}.md-nav__toggle~.md-nav{display:grid;grid-template-rows:0fr;opacity:0;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .25s,visibility 0ms .25s;visibility:collapse}.md-nav__toggle~.md-nav>.md-nav__list{overflow:hidden}.md-nav__toggle.md-toggle--indeterminate~.md-nav,.md-nav__toggle:checked~.md-nav{grid-template-rows:1fr;opacity:1;transition:grid-template-rows .25s cubic-bezier(.86,0,.07,1),opacity .15s .1s,visibility 0ms;visibility:visible}.md-nav__toggle.md-toggle--indeterminate~.md-nav{transition:none}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700}.md-nav__item--section>.md-nav__link[for]{color:var(--md-default-fg-color--light)}.md-nav__item--section>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav__item--section>.md-nav__link .md-icon,.md-nav__item--section>.md-nav__link>[for]{display:none}[dir=ltr] .md-nav__item--section>.md-nav{margin-left:-.6rem}[dir=rtl] .md-nav__item--section>.md-nav{margin-right:-.6rem}.md-nav__item--section>.md-nav{display:block;opacity:1;visibility:visible}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s;width:.9rem}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;border-radius:100%;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:transform .25s;vertical-align:-.1rem;width:100%}[dir=rtl] .md-nav__icon:after{transform:rotate(180deg)}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon:after,.md-nav__item--nested .md-toggle--indeterminate~.md-nav__link .md-nav__icon:after{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);margin-top:0;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__container){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active.md-nav__item--section{margin:0}[dir=ltr] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-left:-.6rem}[dir=rtl] .md-nav--lifted>.md-nav__list>.md-nav__item>.md-nav:not(.md-nav--secondary){margin-right:-.6rem}.md-nav--lifted>.md-nav__list>.md-nav__item>[for]{color:var(--md-default-fg-color--light)}.md-nav--lifted .md-nav[data-md-level="1"]{grid-template-rows:1fr;opacity:1;visibility:visible}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em;opacity:1;visibility:visible}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__list{overflow:visible;padding-bottom:0}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}.md-pagination{font-size:.8rem;font-weight:700;gap:.4rem}.md-pagination,.md-pagination>*{align-items:center;display:flex;justify-content:center}.md-pagination>*{border-radius:.2rem;height:1.8rem;min-width:1.8rem;text-align:center}.md-pagination__current{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light)}.md-pagination__link{transition:color 125ms,background-color 125ms}.md-pagination__link:focus,.md-pagination__link:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-pagination__link:focus svg,.md-pagination__link:hover svg{color:var(--md-accent-fg-color)}.md-pagination__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-pagination__link svg{fill:currentcolor;color:var(--md-default-fg-color--lighter);display:block;max-height:100%;width:1.2rem}.md-post__back{border-bottom:.05rem solid var(--md-default-fg-color--lightest);margin-bottom:1.2rem;padding-bottom:1.2rem}@media screen and (max-width:76.234375em){.md-post__back{display:none}}[dir=rtl] .md-post__back svg{transform:scaleX(-1)}.md-post__authors{display:flex;flex-direction:column;gap:.6rem;margin:0 .6rem 1.2rem}.md-post .md-post__meta a{transition:color 125ms}.md-post .md-post__meta a:focus,.md-post .md-post__meta a:hover{color:var(--md-accent-fg-color)}.md-post__title{color:var(--md-default-fg-color--light);font-weight:700}.md-post--excerpt{margin-bottom:3.2rem}.md-post--excerpt .md-post__header{align-items:center;display:flex;gap:.6rem;min-height:1.6rem}.md-post--excerpt .md-post__authors{align-items:center;display:inline-flex;flex-direction:row;gap:.2rem;margin:0;min-height:2.4rem}[dir=ltr] .md-post--excerpt .md-post__meta .md-meta__list{margin-right:.4rem}[dir=rtl] .md-post--excerpt .md-post__meta .md-meta__list{margin-left:.4rem}.md-post--excerpt .md-post__content>:first-child{--md-scroll-margin:6rem;margin-top:0}.md-post>.md-nav--secondary{margin:1em 0}.md-profile{align-items:center;display:flex;font-size:.7rem;gap:.6rem;line-height:1.4;width:100%}.md-profile__description{flex-grow:1}.md-content--post{display:flex}@media screen and (max-width:76.234375em){.md-content--post{flex-flow:column-reverse}}.md-content--post>.md-content__inner{min-width:0}@media screen and (min-width:76.25em){[dir=ltr] .md-content--post>.md-content__inner{margin-left:1.2rem}[dir=rtl] .md-content--post>.md-content__inner{margin-right:1.2rem}}@media screen and (max-width:76.234375em){.md-sidebar.md-sidebar--post{padding:0;position:static;width:100%}.md-sidebar.md-sidebar--post .md-sidebar__scrollwrap{overflow:visible}.md-sidebar.md-sidebar--post .md-sidebar__inner{padding:0}.md-sidebar.md-sidebar--post .md-post__meta{margin-left:.6rem;margin-right:.6rem}.md-sidebar.md-sidebar--post .md-nav__item{border:none;display:inline}.md-sidebar.md-sidebar--post .md-nav__list{display:inline-flex;flex-wrap:wrap;gap:.6rem;padding-bottom:.6rem;padding-top:.6rem}.md-sidebar.md-sidebar--post .md-nav__link{padding:0}.md-sidebar.md-sidebar--post .md-nav{height:auto;margin-bottom:0;position:static}}:root{--md-progress-value:0;--md-progress-delay:400ms}.md-progress{background:var(--md-primary-bg-color);height:.075rem;opacity:min(clamp(0,var(--md-progress-value),1),clamp(0,100 - var(--md-progress-value),1));position:fixed;top:0;transform:scaleX(calc(var(--md-progress-value)*1%));transform-origin:left;transition:transform .5s cubic-bezier(.19,1,.22,1),opacity .25s var(--md-progress-delay);width:100%;z-index:4}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h7c-.41-.25-.8-.56-1.14-.9-.33-.33-.61-.7-.86-1.1H6V4h7v5h5v1.18c.71.16 1.39.43 2 .82V8zm6.31 16.9c1.33-2.11.69-4.9-1.4-6.22-2.11-1.33-4.91-.68-6.22 1.4-1.34 2.11-.69 4.89 1.4 6.22 1.46.93 3.32.93 4.79.02L22 23.39 23.39 22zm-3.81.1a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5"/></svg>')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:#0000008a;cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.984375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.234375em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem #0000;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:#00000042;border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:#ffffff1f}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem #00000012;color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:#0000;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::placeholder{transition:color .25s}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.984375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:#0000}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.984375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>.md-icon{margin-left:.2rem}[dir=rtl] .md-search__options>.md-icon{margin-right:.2rem}.md-search__options>.md-icon{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>.md-icon:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>.md-icon:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.984375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.234375em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:focus,.md-search-result__link:hover{background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more>summary{cursor:pointer;display:block;outline:none;position:sticky;scroll-snap-align:start;top:0;z-index:1}.md-search-result__more>summary::marker{display:none}.md-search-result__more>summary::-webkit-details-marker{display:none}.md-search-result__more>summary>div{color:var(--md-typeset-a-color);font-size:.64rem;padding:.75em .8rem;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more>summary>div{padding-left:2.2rem}[dir=rtl] .md-search-result__more>summary>div{padding-right:2.2rem}}.md-search-result__more>summary:focus>div,.md-search-result__more>summary:hover>div{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more[open]>summary{background-color:var(--md-default-bg-color)}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.984375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result .md-typeset{color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.6}.md-search-result .md-typeset h1{color:var(--md-default-fg-color);font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}.md-search-result .md-typeset h1 mark{text-decoration:none}.md-search-result .md-typeset h2{color:var(--md-default-fg-color);font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result .md-typeset h2 mark{text-decoration:none}.md-search-result__terms{color:var(--md-default-fg-color);display:block;font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color);text-decoration:underline}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:focus-within .md-select__inner,.md-select:hover .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid #0000;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid #0000;border-right:.2rem solid #0000;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:focus,.md-select__link:hover{color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.234375em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) #0000;scrollbar-width:thin}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap:focus-within,.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) #0000}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap:focus-within::-webkit-scrollbar-thumb:hover,.md-sidebar__scrollwrap:hover::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.234375em){.md-overlay{background-color:#0000008a;height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M5 5.372v.878c0 .414.336.75.75.75h4.5a.75.75 0 0 0 .75-.75v-.878a2.25 2.25 0 1 1 1.5 0v.878a2.25 2.25 0 0 1-2.25 2.25h-1.5v2.128a2.251 2.251 0 1 1-1.5 0V8.5h-1.5A2.25 2.25 0 0 1 3.5 6.25v-.878a2.25 2.25 0 1 1 1.5 0M5 3.25a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0m6.75.75a.75.75 0 1 0 0-1.5.75.75 0 0 0 0 1.5m-3 8.75a.75.75 0 1 0-1.5 0 .75.75 0 0 0 1.5 0"/></svg>');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M2 2.5A2.5 2.5 0 0 1 4.5 0h8.75a.75.75 0 0 1 .75.75v12.5a.75.75 0 0 1-.75.75h-2.5a.75.75 0 0 1 0-1.5h1.75v-2h-8a1 1 0 0 0-.714 1.7.75.75 0 1 1-1.072 1.05A2.5 2.5 0 0 1 2 11.5Zm10.5-1h-8a1 1 0 0 0-1 1v6.708A2.5 2.5 0 0 1 4.5 9h8ZM5 12.25a.25.25 0 0 1 .25-.25h3.5a.25.25 0 0 1 .25.25v3.25a.25.25 0 0 1-.4.2l-1.45-1.087a.25.25 0 0 0-.3 0L5.4 15.7a.25.25 0 0 1-.4-.2Z"/></svg>');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M8 .25a.75.75 0 0 1 .673.418l1.882 3.815 4.21.612a.75.75 0 0 1 .416 1.279l-3.046 2.97.719 4.192a.751.751 0 0 1-1.088.791L8 12.347l-3.766 1.98a.75.75 0 0 1-1.088-.79l.72-4.194L.818 6.374a.75.75 0 0 1 .416-1.28l4.21-.611L7.327.668A.75.75 0 0 1 8 .25m0 2.445L6.615 5.5a.75.75 0 0 1-.564.41l-3.097.45 2.24 2.184a.75.75 0 0 1 .216.664l-.528 3.084 2.769-1.456a.75.75 0 0 1 .698 0l2.77 1.456-.53-3.084a.75.75 0 0 1 .216-.664l2.24-2.183-3.096-.45a.75.75 0 0 1-.564-.41z"/></svg>');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><path d="M1 7.775V2.75C1 1.784 1.784 1 2.75 1h5.025c.464 0 .91.184 1.238.513l6.25 6.25a1.75 1.75 0 0 1 0 2.474l-5.026 5.026a1.75 1.75 0 0 1-2.474 0l-6.25-6.25A1.75 1.75 0 0 1 1 7.775m1.5 0c0 .066.026.13.073.177l6.25 6.25a.25.25 0 0 0 .354 0l5.025-5.025a.25.25 0 0 0 0-.354l-6.25-6.25a.25.25 0 0 0-.177-.073H2.75a.25.25 0 0 0-.25.25ZM6 5a1 1 0 1 1 0 2 1 1 0 0 1 0-2"/></svg>')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-source-file{margin:1em 0}[dir=ltr] .md-source-file__fact{margin-right:.6rem}[dir=rtl] .md-source-file__fact{margin-left:.6rem}.md-source-file__fact{align-items:center;color:var(--md-default-fg-color--light);display:inline-flex;font-size:.68rem;gap:.3rem}.md-source-file__fact .md-icon{flex-shrink:0;margin-bottom:.05rem}[dir=ltr] .md-source-file__fact .md-author{float:left}[dir=rtl] .md-source-file__fact .md-author{float:right}.md-source-file__fact .md-author{margin-right:.2rem}.md-source-file__fact svg{width:.9rem}:root{--md-status:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 9h2V7h-2m1 13c-4.41 0-8-3.59-8-8s3.59-8 8-8 8 3.59 8 8-3.59 8-8 8m0-18A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2m-1 15h2v-6h-2z"/></svg>');--md-status--new:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m23 12-2.44-2.78.34-3.68-3.61-.82-1.89-3.18L12 3 8.6 1.54 6.71 4.72l-3.61.81.34 3.68L1 12l2.44 2.78-.34 3.69 3.61.82 1.89 3.18L12 21l3.4 1.46 1.89-3.18 3.61-.82-.34-3.68zm-10 5h-2v-2h2zm0-4h-2V7h2z"/></svg>');--md-status--deprecated:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9 3v1H4v2h1v13a2 2 0 0 0 2 2h10a2 2 0 0 0 2-2V6h1V4h-5V3zm0 5h2v9H9zm4 0h2v9h-2z"/></svg>');--md-status--encrypted:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 1 3 5v6c0 5.55 3.84 10.74 9 12 5.16-1.26 9-6.45 9-12V5zm0 6c1.4 0 2.8 1.1 2.8 2.5V11c.6 0 1.2.6 1.2 1.3v3.5c0 .6-.6 1.2-1.3 1.2H9.2c-.6 0-1.2-.6-1.2-1.3v-3.5c0-.6.6-1.2 1.2-1.2V9.5C9.2 8.1 10.6 7 12 7m0 1.2c-.8 0-1.5.5-1.5 1.3V11h3V9.5c0-.8-.7-1.3-1.5-1.3"/></svg>')}.md-status:after{background-color:var(--md-default-fg-color--light);content:"";display:inline-block;height:1.125em;-webkit-mask-image:var(--md-status);mask-image:var(--md-status);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-bottom;width:1.125em}.md-status:hover:after{background-color:currentcolor}.md-status--new:after{-webkit-mask-image:var(--md-status--new);mask-image:var(--md-status--new)}.md-status--deprecated:after{-webkit-mask-image:var(--md-status--deprecated);mask-image:var(--md-status--deprecated)}.md-status--encrypted:after{-webkit-mask-image:var(--md-status--encrypted);mask-image:var(--md-status--encrypted)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.234375em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;display:flex;list-style:none;margin:0;overflow:auto;padding:0;scrollbar-width:none;white-space:nowrap}.md-tabs__list::-webkit-scrollbar{display:none}.md-tabs__item{height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__item--active .md-tabs__link{color:inherit;opacity:1}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:flex;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link:focus,.md-tabs__link:hover{color:inherit;opacity:1}[dir=ltr] .md-tabs__link svg{margin-right:.4rem}[dir=rtl] .md-tabs__link svg{margin-left:.4rem}.md-tabs__link svg{fill:currentcolor;height:1.3em}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m5.41 21 .71-4h-4l.35-2h4l1.06-6h-4l.35-2h4l.71-4h2l-.71 4h6l.71-4h2l-.71 4h4l-.35 2h-4l-1.06 6h4l-.35 2h-4l-.71 4h-2l.71-4h-6l-.71 4zM9.53 9l-1.06 6h6l1.06-6z"/></svg>')}.md-typeset .md-tags:not([hidden]){display:inline-flex;flex-wrap:wrap;gap:.5em;margin-bottom:.75em;margin-top:-.125em}.md-typeset .md-tag{align-items:center;background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-flex;font-size:.64rem;font-size:min(.8em,.64rem);font-weight:700;gap:.5em;letter-spacing:normal;line-height:1.6;padding:.3125em .78125em}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon[href]:focus:before,.md-typeset .md-tag-icon[href]:hover:before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{transform:scale(.95)}75%{transform:scale(1)}to{transform:scale(.95)}}:root{--md-annotation-bg-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2"/></svg>');--md-annotation-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 13h-4v4h-2v-4H7v-2h4V7h2v4h4m-5-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2"/></svg>')}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip--inline{font-weight:700;-webkit-user-select:none;user-select:none;width:auto}.md-tooltip--inline:not(.md-tooltip--active){transform:translateY(.2rem) scale(.9)}.md-tooltip--inline .md-tooltip__inner{font-size:.5rem;padding:.2rem .4rem}[hidden]+.md-tooltip--inline{display:none}.focus-visible>.md-tooltip,.md-tooltip:target{outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-style:normal;font-weight:400;outline:none;text-align:initial;vertical-align:text-bottom;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}code .md-annotation{font-family:var(--md-code-font-family);font-size:inherit}.md-annotation:not([hidden]){display:inline-block;line-height:1.25}.md-annotation__index{border-radius:.01px;cursor:pointer;display:inline-block;margin-left:.4ch;margin-right:.4ch;outline:none;overflow:hidden;position:relative;-webkit-user-select:none;user-select:none;vertical-align:text-top;z-index:0}.md-annotation .md-annotation__index{transition:z-index .25s}@media screen{.md-annotation__index{width:2.2ch}[data-md-visible]>.md-annotation__index{animation:pulse 2s infinite}.md-annotation__index:before{background:var(--md-default-bg-color);-webkit-mask-image:var(--md-annotation-bg-icon);mask-image:var(--md-annotation-bg-icon)}.md-annotation__index:after,.md-annotation__index:before{content:"";height:2.2ch;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:-.1ch;width:2.2ch;z-index:-1}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);-webkit-mask-image:var(--md-annotation-icon);mask-image:var(--md-annotation-icon);transform:scale(1.0001);transition:background-color .25s,transform .25s}.md-tooltip--active+.md-annotation__index:after{transform:rotate(45deg)}.md-tooltip--active+.md-annotation__index:after,:hover>.md-annotation__index:after{background-color:var(--md-accent-fg-color)}}.md-tooltip--active+.md-annotation__index{animation-play-state:paused;transition-duration:0ms;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block}@media print{.md-annotation__index [data-md-annotation-id]{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);font-weight:700;padding:0 .6ch;white-space:nowrap}.md-annotation__index [data-md-annotation-id]:after{content:attr(data-md-annotation-id)}}.md-typeset .md-annotation-list{counter-reset:xxx;list-style:none}.md-typeset .md-annotation-list li{position:relative}[dir=ltr] .md-typeset .md-annotation-list li:before{left:-2.125em}[dir=rtl] .md-typeset .md-annotation-list li:before{right:-2.125em}.md-typeset .md-annotation-list li:before{background:var(--md-default-fg-color--lighter);border-radius:2ch;color:var(--md-default-bg-color);content:counter(xxx);counter-increment:xxx;font-size:.8875em;font-weight:700;height:2ch;line-height:1.25;min-width:2ch;padding:0 .6ch;position:absolute;text-align:center;top:.25em}:root{--md-tooltip-width:20rem;--md-tooltip-tail:0.3rem}.md-tooltip2{-webkit-backface-visibility:hidden;backface-visibility:hidden;color:var(--md-default-fg-color);font-family:var(--md-text-font-family);opacity:0;pointer-events:none;position:absolute;top:calc(var(--md-tooltip-host-y) + var(--md-tooltip-y));transform:translateY(-.4rem);transform-origin:calc(var(--md-tooltip-host-x) + var(--md-tooltip-x)) 0;transition:transform 0ms .25s,opacity .25s,z-index .25s;width:100%;z-index:0}.md-tooltip2:before{border-left:var(--md-tooltip-tail) solid #0000;border-right:var(--md-tooltip-tail) solid #0000;content:"";display:block;left:clamp(1.5 * .8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-tail),100vw - 2 * var(--md-tooltip-tail) - 1.5 * .8rem);position:absolute;z-index:1}.md-tooltip2--top:before{border-top:var(--md-tooltip-tail) solid var(--md-default-bg-color);bottom:calc(var(--md-tooltip-tail)*-1 + .025rem);filter:drop-shadow(0 1px 0 hsla(0,0%,0%,.05))}.md-tooltip2--bottom:before{border-bottom:var(--md-tooltip-tail) solid var(--md-default-bg-color);filter:drop-shadow(0 -1px 0 hsla(0,0%,0%,.05));top:calc(var(--md-tooltip-tail)*-1 + .025rem)}.md-tooltip2--active{opacity:1;transform:translateY(0);transition:transform .4s cubic-bezier(0,1,.5,1),opacity .25s,z-index 0ms;z-index:2}.md-tooltip2__inner{scrollbar-gutter:stable;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);left:clamp(.8rem,var(--md-tooltip-host-x) - .8rem,100vw - var(--md-tooltip-width) - .8rem);max-height:40vh;max-width:calc(100vw - 1.6rem);position:relative;scrollbar-width:thin}.md-tooltip2__inner::-webkit-scrollbar{height:.2rem;width:.2rem}.md-tooltip2__inner::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-tooltip2__inner::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}[role=tooltip]>.md-tooltip2__inner{font-size:.5rem;font-weight:700;left:clamp(.8rem,var(--md-tooltip-host-x) + var(--md-tooltip-x) - var(--md-tooltip-width)/2,100vw - var(--md-tooltip-width) - .8rem);max-width:min(100vw - 2 * .8rem,400px);padding:.2rem .4rem;-webkit-user-select:none;user-select:none;width:-moz-fit-content;width:fit-content}.md-tooltip2__inner.md-typeset>:first-child{margin-top:0}.md-tooltip2__inner.md-typeset>:last-child{margin-bottom:0}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);cursor:pointer;display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:focus,.md-top:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512"><!--! Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M137.4 374.6c12.5 12.5 32.8 12.5 45.3 0l128-128c9.2-9.2 11.9-22.9 6.9-34.9S301 191.9 288 191.9L32 192c-12.9 0-24.6 7.8-29.6 19.8s-2.2 25.7 6.9 34.9l128 128z"/></svg>')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__alias{margin-left:.3rem;opacity:.7}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:focus-within .md-version__list,.md-version:hover .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (hover:none),(pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:focus,.md-version__link:hover{color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2C6.47 2 2 6.47 2 12s4.47 10 10 10 10-4.47 10-10S17.53 2 12 2m3.1 5.07c.14 0 .28.05.4.16l1.27 1.27c.23.22.23.57 0 .78l-1 1-2.05-2.05 1-1c.1-.11.24-.16.38-.16m-1.97 1.74 2.06 2.06-6.06 6.06H7.07v-2.06z"/></svg>');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 9H7V7h10m0 6H7v-2h10m-3 6H7v-2h7M12 3a1 1 0 0 1 1 1 1 1 0 0 1-1 1 1 1 0 0 1-1-1 1 1 0 0 1 1-1m7 0h-4.18C14.4 1.84 13.3 1 12 1s-2.4.84-2.82 2H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2V5a2 2 0 0 0-2-2"/></svg>');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 9h-2V7h2m0 10h-2v-6h2m-1-9A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10A10 10 0 0 0 12 2"/></svg>');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.66 11.2c-.23-.3-.51-.56-.77-.82-.67-.6-1.43-1.03-2.07-1.66C13.33 7.26 13 4.85 13.95 3c-.95.23-1.78.75-2.49 1.32-2.59 2.08-3.61 5.75-2.39 8.9.04.1.08.2.08.33 0 .22-.15.42-.35.5-.23.1-.47.04-.66-.12a.6.6 0 0 1-.14-.17c-1.13-1.43-1.31-3.48-.55-5.12C5.78 10 4.87 12.3 5 14.47c.06.5.12 1 .29 1.5.14.6.41 1.2.71 1.73 1.08 1.73 2.95 2.97 4.96 3.22 2.14.27 4.43-.12 6.07-1.6 1.83-1.66 2.47-4.32 1.53-6.6l-.13-.26c-.21-.46-.77-1.26-.77-1.26m-3.16 6.3c-.28.24-.74.5-1.1.6-1.12.4-2.24-.16-2.9-.82 1.19-.28 1.9-1.16 2.11-2.05.17-.8-.15-1.46-.28-2.23-.12-.74-.1-1.37.17-2.06.19.38.39.76.63 1.06.77 1 1.98 1.44 2.24 2.8.04.14.06.28.06.43.03.82-.33 1.72-.93 2.27"/></svg>');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 7 9 19l-5.5-5.5 1.41-1.41L9 16.17 19.59 5.59z"/></svg>');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m15.07 11.25-.9.92C13.45 12.89 13 13.5 13 15h-2v-.5c0-1.11.45-2.11 1.17-2.83l1.24-1.26c.37-.36.59-.86.59-1.41a2 2 0 0 0-2-2 2 2 0 0 0-2 2H8a4 4 0 0 1 4-4 4 4 0 0 1 4 4 3.2 3.2 0 0 1-.93 2.25M13 19h-2v-2h2M12 2A10 10 0 0 0 2 12a10 10 0 0 0 10 10 10 10 0 0 0 10-10c0-5.53-4.5-10-10-10"/></svg>');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 14h-2V9h2m0 9h-2v-2h2M1 21h22L12 2z"/></svg>');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m11.5 20 4.86-9.73H13V4l-5 9.73h3.5zM12 2c2.75 0 5.1 1 7.05 2.95S22 9.25 22 12s-1 5.1-2.95 7.05S14.75 22 12 22s-5.1-1-7.05-2.95S2 14.75 2 12s1-5.1 2.95-7.05S9.25 2 12 2"/></svg>');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M11 13h2v1h-2zm10-8v6c0 5.5-3.8 10.7-9 12-5.2-1.3-9-6.5-9-12V5l9-4zm-4 5h-2.2c-.2-.6-.6-1.1-1.1-1.5l1.2-1.2-.7-.7L12.8 8H12c-.2 0-.5 0-.7.1L9.9 6.6l-.8.8 1.2 1.2c-.5.3-.9.8-1.1 1.4H7v1h2v1H7v1h2v1H7v1h2.2c.4 1.2 1.5 2 2.8 2s2.4-.8 2.8-2H17v-1h-2v-1h2v-1h-2v-1h2zm-6 2h2v-1h-2z"/></svg>');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M7 2v2h1v14a4 4 0 0 0 4 4 4 4 0 0 0 4-4V4h1V2zm4 14c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m2-4c-.6 0-1-.4-1-1s.4-1 1-1 1 .4 1 1-.4 1-1 1m1-5h-4V4h4z"/></svg>');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M14 17h3l2-4V7h-6v6h3M6 17h3l2-4V7H5v6h3z"/></svg>')}.md-typeset .admonition,.md-typeset details{background-color:var(--md-admonition-bg-color);border:.075rem solid #448aff;border-radius:.2rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid;transition:box-shadow 125ms}@media print{.md-typeset .admonition,.md-typeset details{box-shadow:none}}.md-typeset .admonition:focus-within,.md-typeset details:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .admonition>*,.md-typeset details>*{box-sizing:border-box}.md-typeset .admonition .admonition,.md-typeset .admonition details,.md-typeset details .admonition,.md-typeset details details{margin-bottom:1em;margin-top:1em}.md-typeset .admonition .md-typeset__scrollwrap,.md-typeset details .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset .admonition .md-typeset__table,.md-typeset details .md-typeset__table{padding:0 .6rem}.md-typeset .admonition>.tabbed-set:only-child,.md-typeset details>.tabbed-set:only-child{margin-top:0}html .md-typeset .admonition>:last-child,html .md-typeset details>:last-child{margin-bottom:.6rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{padding-left:2rem;padding-right:.6rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{padding-left:.6rem;padding-right:2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-left-width:.2rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-right-width:.2rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .admonition-title,[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .admonition-title,[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset .admonition-title,.md-typeset summary{background-color:#448aff1a;border:none;font-weight:700;margin:0 -.6rem;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset .admonition-title:last-child,html .md-typeset summary:last-child{margin-bottom:0}[dir=ltr] .md-typeset .admonition-title:before,[dir=ltr] .md-typeset summary:before{left:.6rem}[dir=rtl] .md-typeset .admonition-title:before,[dir=rtl] .md-typeset summary:before{right:.6rem}.md-typeset .admonition-title:before,.md-typeset summary:before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset .admonition-title code,.md-typeset summary code{box-shadow:0 0 0 .05rem var(--md-default-fg-color--lightest)}.md-typeset .admonition.note,.md-typeset details.note{border-color:#448aff}.md-typeset .admonition.note:focus-within,.md-typeset details.note:focus-within{box-shadow:0 0 0 .2rem #448aff1a}.md-typeset .note>.admonition-title,.md-typeset .note>summary{background-color:#448aff1a}.md-typeset .note>.admonition-title:before,.md-typeset .note>summary:before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset .note>.admonition-title:after,.md-typeset .note>summary:after{color:#448aff}.md-typeset .admonition.abstract,.md-typeset details.abstract{border-color:#00b0ff}.md-typeset .admonition.abstract:focus-within,.md-typeset details.abstract:focus-within{box-shadow:0 0 0 .2rem #00b0ff1a}.md-typeset .abstract>.admonition-title,.md-typeset .abstract>summary{background-color:#00b0ff1a}.md-typeset .abstract>.admonition-title:before,.md-typeset .abstract>summary:before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset .abstract>.admonition-title:after,.md-typeset .abstract>summary:after{color:#00b0ff}.md-typeset .admonition.info,.md-typeset details.info{border-color:#00b8d4}.md-typeset .admonition.info:focus-within,.md-typeset details.info:focus-within{box-shadow:0 0 0 .2rem #00b8d41a}.md-typeset .info>.admonition-title,.md-typeset .info>summary{background-color:#00b8d41a}.md-typeset .info>.admonition-title:before,.md-typeset .info>summary:before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset .info>.admonition-title:after,.md-typeset .info>summary:after{color:#00b8d4}.md-typeset .admonition.tip,.md-typeset details.tip{border-color:#00bfa5}.md-typeset .admonition.tip:focus-within,.md-typeset details.tip:focus-within{box-shadow:0 0 0 .2rem #00bfa51a}.md-typeset .tip>.admonition-title,.md-typeset .tip>summary{background-color:#00bfa51a}.md-typeset .tip>.admonition-title:before,.md-typeset .tip>summary:before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset .tip>.admonition-title:after,.md-typeset .tip>summary:after{color:#00bfa5}.md-typeset .admonition.success,.md-typeset details.success{border-color:#00c853}.md-typeset .admonition.success:focus-within,.md-typeset details.success:focus-within{box-shadow:0 0 0 .2rem #00c8531a}.md-typeset .success>.admonition-title,.md-typeset .success>summary{background-color:#00c8531a}.md-typeset .success>.admonition-title:before,.md-typeset .success>summary:before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset .success>.admonition-title:after,.md-typeset .success>summary:after{color:#00c853}.md-typeset .admonition.question,.md-typeset details.question{border-color:#64dd17}.md-typeset .admonition.question:focus-within,.md-typeset details.question:focus-within{box-shadow:0 0 0 .2rem #64dd171a}.md-typeset .question>.admonition-title,.md-typeset .question>summary{background-color:#64dd171a}.md-typeset .question>.admonition-title:before,.md-typeset .question>summary:before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset .question>.admonition-title:after,.md-typeset .question>summary:after{color:#64dd17}.md-typeset .admonition.warning,.md-typeset details.warning{border-color:#ff9100}.md-typeset .admonition.warning:focus-within,.md-typeset details.warning:focus-within{box-shadow:0 0 0 .2rem #ff91001a}.md-typeset .warning>.admonition-title,.md-typeset .warning>summary{background-color:#ff91001a}.md-typeset .warning>.admonition-title:before,.md-typeset .warning>summary:before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset .warning>.admonition-title:after,.md-typeset .warning>summary:after{color:#ff9100}.md-typeset .admonition.failure,.md-typeset details.failure{border-color:#ff5252}.md-typeset .admonition.failure:focus-within,.md-typeset details.failure:focus-within{box-shadow:0 0 0 .2rem #ff52521a}.md-typeset .failure>.admonition-title,.md-typeset .failure>summary{background-color:#ff52521a}.md-typeset .failure>.admonition-title:before,.md-typeset .failure>summary:before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset .failure>.admonition-title:after,.md-typeset .failure>summary:after{color:#ff5252}.md-typeset .admonition.danger,.md-typeset details.danger{border-color:#ff1744}.md-typeset .admonition.danger:focus-within,.md-typeset details.danger:focus-within{box-shadow:0 0 0 .2rem #ff17441a}.md-typeset .danger>.admonition-title,.md-typeset .danger>summary{background-color:#ff17441a}.md-typeset .danger>.admonition-title:before,.md-typeset .danger>summary:before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset .danger>.admonition-title:after,.md-typeset .danger>summary:after{color:#ff1744}.md-typeset .admonition.bug,.md-typeset details.bug{border-color:#f50057}.md-typeset .admonition.bug:focus-within,.md-typeset details.bug:focus-within{box-shadow:0 0 0 .2rem #f500571a}.md-typeset .bug>.admonition-title,.md-typeset .bug>summary{background-color:#f500571a}.md-typeset .bug>.admonition-title:before,.md-typeset .bug>summary:before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset .bug>.admonition-title:after,.md-typeset .bug>summary:after{color:#f50057}.md-typeset .admonition.example,.md-typeset details.example{border-color:#7c4dff}.md-typeset .admonition.example:focus-within,.md-typeset details.example:focus-within{box-shadow:0 0 0 .2rem #7c4dff1a}.md-typeset .example>.admonition-title,.md-typeset .example>summary{background-color:#7c4dff1a}.md-typeset .example>.admonition-title:before,.md-typeset .example>summary:before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset .example>.admonition-title:after,.md-typeset .example>summary:after{color:#7c4dff}.md-typeset .admonition.quote,.md-typeset details.quote{border-color:#9e9e9e}.md-typeset .admonition.quote:focus-within,.md-typeset details.quote:focus-within{box-shadow:0 0 0 .2rem #9e9e9e1a}.md-typeset .quote>.admonition-title,.md-typeset .quote>summary{background-color:#9e9e9e1a}.md-typeset .quote>.admonition-title:before,.md-typeset .quote>summary:before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset .quote>.admonition-title:after,.md-typeset .quote>summary:after{color:#9e9e9e}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 7v4H5.83l3.58-3.59L8 6l-6 6 6 6 1.41-1.42L5.83 13H21V7z"/></svg>')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:hover .footnote-backref,.md-typeset .footnote>ol>li:target .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :hover>.headerlink,.md-typeset :target>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset .headerlink:hover,.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset h1:target,.md-typeset h2:target,.md-typeset h3:target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.984375em){.md-typeset div.arithmatex{margin:0 -.8rem}.md-typeset div.arithmatex>*{width:min-content}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset div.arithmatex mjx-assistive-mml{height:0}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset del.critic,.md-typeset ins.critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{-webkit-box-decoration-break:clone;box-decoration-break:clone;color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6z"/></svg>')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem;overflow:hidden}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset .emojione,.md-typeset .gemoji,.md-typeset .twemoji{--md-icon-size:1.125em;display:inline-flex;height:var(--md-icon-size);vertical-align:text-top}.md-typeset .emojione svg,.md-typeset .gemoji svg,.md-typeset .twemoji svg{fill:currentcolor;max-height:100%;width:var(--md-icon-size)}.md-typeset .lg,.md-typeset .xl,.md-typeset .xxl,.md-typeset .xxxl{vertical-align:text-bottom}.md-typeset .middle{vertical-align:middle}.md-typeset .lg{--md-icon-size:1.5em}.md-typeset .xl{--md-icon-size:2.25em}.md-typeset .xxl{--md-icon-size:3em}.md-typeset .xxxl{--md-icon-size:4em}.highlight .o,.highlight .ow{color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight .cpf,.highlight .l,.highlight .s,.highlight .s1,.highlight .s2,.highlight .sb,.highlight .sc,.highlight .si,.highlight .ss{color:var(--md-code-hl-string-color)}.highlight .cp,.highlight .se,.highlight .sh,.highlight .sr,.highlight .sx{color:var(--md-code-hl-special-color)}.highlight .il,.highlight .m,.highlight .mb,.highlight .mf,.highlight .mh,.highlight .mi,.highlight .mo{color:var(--md-code-hl-number-color)}.highlight .k,.highlight .kd,.highlight .kn,.highlight .kp,.highlight .kr,.highlight .kt{color:var(--md-code-hl-keyword-color)}.highlight .kc,.highlight .n{color:var(--md-code-hl-name-color)}.highlight .bp,.highlight .nb,.highlight .no{color:var(--md-code-hl-constant-color)}.highlight .nc,.highlight .ne,.highlight .nf,.highlight .nn{color:var(--md-code-hl-function-color)}.highlight .nd,.highlight .ni,.highlight .nl,.highlight .nt{color:var(--md-code-hl-keyword-color)}.highlight .c,.highlight .c1,.highlight .ch,.highlight .cm,.highlight .cs,.highlight .sd{color:var(--md-code-hl-comment-color)}.highlight .na,.highlight .nv,.highlight .vc,.highlight .vg,.highlight .vi{color:var(--md-code-hl-variable-color)}.highlight .ge,.highlight .gh,.highlight .go,.highlight .gp,.highlight .gr,.highlight .gs,.highlight .gt,.highlight .gu{color:var(--md-code-hl-generic-color)}.highlight .gd,.highlight .gi{border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color--light);box-shadow:2px 0 0 0 var(--md-code-hl-color) inset;display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:sticky;-webkit-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying]{display:initial}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable tbody,.highlighttable td{display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;padding-right:.5882352941em}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.984375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:after,.md-typeset .keys kbd:before{-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M15.41 16.58 10.83 12l4.58-4.59L14 6l-6 6 6 6z"/></svg>');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M8.59 16.58 13.17 12 8.59 7.41 10 6l6 6-6 6z"/></svg>')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-set>input.focus-visible~.tabbed-labels:before{background-color:var(--md-accent-fg-color)}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-default-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,background-color .25s,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid #0000;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-default-fg-color)}.md-typeset .tabbed-labels>label>[href]:first-child{color:inherit}.md-typeset .tabbed-labels--linked>label{padding:0}.md-typeset .tabbed-labels--linked>label>a{display:block;padding:.78125em 1.25em .625em}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,#0000);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,#0000);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.984375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-default-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-default-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12m16.28-2.72a.75.75 0 0 0-.018-1.042.75.75 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.75.75 0 0 0-1.042.018.75.75 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12m16.28-2.72a.75.75 0 0 0-.018-1.042.75.75 0 0 0-1.042-.018l-5.97 5.97-2.47-2.47a.75.75 0 0 0-1.042.018.75.75 0 0 0-.018 1.042l3 3a.75.75 0 0 0 1.06 0Z"/></svg>')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}@media print{.giscus,[id=__comments]{display:none}}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color);--md-mermaid-sequence-actor-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actor-fg-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-actor-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-actor-line-color:var(--md-default-fg-color--lighter);--md-mermaid-sequence-actorman-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-actorman-line-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-box-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-box-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-label-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-label-fg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-loop-bg-color:var(--md-mermaid-node-bg-color);--md-mermaid-sequence-loop-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-loop-border-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-message-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-message-line-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-bg-color:var(--md-mermaid-label-bg-color);--md-mermaid-sequence-note-fg-color:var(--md-mermaid-edge-color);--md-mermaid-sequence-note-border-color:var(--md-mermaid-label-fg-color);--md-mermaid-sequence-number-bg-color:var(--md-mermaid-node-fg-color);--md-mermaid-sequence-number-fg-color:var(--md-accent-bg-color)}.mermaid{line-height:normal;margin:1em 0}.md-typeset .grid{grid-gap:.4rem;display:grid;grid-template-columns:repeat(auto-fit,minmax(min(100%,16rem),1fr));margin:1em 0}.md-typeset .grid.cards>ol,.md-typeset .grid.cards>ul{display:contents}.md-typeset .grid.cards>ol>li,.md-typeset .grid.cards>ul>li,.md-typeset .grid>.card{border:.05rem solid var(--md-default-fg-color--lightest);border-radius:.1rem;display:block;margin:0;padding:.8rem;transition:border .25s,box-shadow .25s}.md-typeset .grid.cards>ol>li:focus-within,.md-typeset .grid.cards>ol>li:hover,.md-typeset .grid.cards>ul>li:focus-within,.md-typeset .grid.cards>ul>li:hover,.md-typeset .grid>.card:focus-within,.md-typeset .grid>.card:hover{border-color:#0000;box-shadow:var(--md-shadow-z2)}.md-typeset .grid.cards>ol>li>hr,.md-typeset .grid.cards>ul>li>hr,.md-typeset .grid>.card>hr{margin-bottom:1em;margin-top:1em}.md-typeset .grid.cards>ol>li>:first-child,.md-typeset .grid.cards>ul>li>:first-child,.md-typeset .grid>.card>:first-child{margin-top:0}.md-typeset .grid.cards>ol>li>:last-child,.md-typeset .grid.cards>ul>li>:last-child,.md-typeset .grid>.card>:last-child{margin-bottom:0}.md-typeset .grid>*,.md-typeset .grid>.admonition,.md-typeset .grid>.highlight>*,.md-typeset .grid>.highlighttable,.md-typeset .grid>.md-typeset details,.md-typeset .grid>details,.md-typeset .grid>pre{margin-bottom:0;margin-top:0}.md-typeset .grid>.highlight>pre:only-child,.md-typeset .grid>.highlight>pre>code,.md-typeset .grid>.highlighttable,.md-typeset .grid>.highlighttable>tbody,.md-typeset .grid>.highlighttable>tbody>tr,.md-typeset .grid>.highlighttable>tbody>tr>.code,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre,.md-typeset .grid>.highlighttable>tbody>tr>.code>.highlight>pre>code{height:100%}.md-typeset .grid>.tabbed-set{margin-bottom:0;margin-top:0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}}
\ No newline at end of file
diff --git a/latest/assets/stylesheets/main.6f8fc17f.min.css.map b/latest/assets/stylesheets/main.6f8fc17f.min.css.map
new file mode 100644
index 000000000..8ba5ce39e
--- /dev/null
+++ b/latest/assets/stylesheets/main.6f8fc17f.min.css.map
@@ -0,0 +1 @@
+{"version":3,"sources":["src/templates/assets/stylesheets/main/components/_meta.scss","../../../../src/templates/assets/stylesheets/main.scss","src/templates/assets/stylesheets/main/_resets.scss","src/templates/assets/stylesheets/main/_colors.scss","src/templates/assets/stylesheets/main/_icons.scss","src/templates/assets/stylesheets/main/_typeset.scss","src/templates/assets/stylesheets/utilities/_break.scss","src/templates/assets/stylesheets/main/components/_author.scss","src/templates/assets/stylesheets/main/components/_banner.scss","src/templates/assets/stylesheets/main/components/_base.scss","src/templates/assets/stylesheets/main/components/_clipboard.scss","src/templates/assets/stylesheets/main/components/_code.scss","src/templates/assets/stylesheets/main/components/_consent.scss","src/templates/assets/stylesheets/main/components/_content.scss","src/templates/assets/stylesheets/main/components/_dialog.scss","src/templates/assets/stylesheets/main/components/_feedback.scss","src/templates/assets/stylesheets/main/components/_footer.scss","src/templates/assets/stylesheets/main/components/_form.scss","src/templates/assets/stylesheets/main/components/_header.scss","node_modules/material-design-color/material-color.scss","src/templates/assets/stylesheets/main/components/_nav.scss","src/templates/assets/stylesheets/main/components/_pagination.scss","src/templates/assets/stylesheets/main/components/_post.scss","src/templates/assets/stylesheets/main/components/_progress.scss","src/templates/assets/stylesheets/main/components/_search.scss","src/templates/assets/stylesheets/main/components/_select.scss","src/templates/assets/stylesheets/main/components/_sidebar.scss","src/templates/assets/stylesheets/main/components/_source.scss","src/templates/assets/stylesheets/main/components/_status.scss","src/templates/assets/stylesheets/main/components/_tabs.scss","src/templates/assets/stylesheets/main/components/_tag.scss","src/templates/assets/stylesheets/main/components/_tooltip.scss","src/templates/assets/stylesheets/main/components/_tooltip2.scss","src/templates/assets/stylesheets/main/components/_top.scss","src/templates/assets/stylesheets/main/components/_version.scss","src/templates/assets/stylesheets/main/extensions/markdown/_admonition.scss","src/templates/assets/stylesheets/main/extensions/markdown/_footnotes.scss","src/templates/assets/stylesheets/main/extensions/markdown/_toc.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_arithmatex.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_critic.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_details.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_emoji.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_highlight.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_keys.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss","src/templates/assets/stylesheets/main/extensions/pymdownx/_tasklist.scss","src/templates/assets/stylesheets/main/integrations/_giscus.scss","src/templates/assets/stylesheets/main/integrations/_mermaid.scss","src/templates/assets/stylesheets/main/modifiers/_grid.scss","src/templates/assets/stylesheets/main/modifiers/_inline.scss"],"names":[],"mappings":"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FACE,alCq4GN,CkC15GE,4DACE,oBlC65GJ,CkC15GI,sFACE,gClC45GN,CkCv5GE,oEACE,0BlC05GJ,CkCv5GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ClCy5GN,CkCr5GI,gFACE,alCu5GN,CkC56GE,4DACE,oBlC+6GJ,CkC56GI,sFACE,gClC86GN,CkCz6GE,oEACE,0BlC46GJ,CkCz6GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ClC26GN,CkCv6GI,gFACE,alCy6GN,CkC97GE,0DACE,oBlCi8GJ,CkC97GI,oFACE,gClCg8GN,CkC37GE,kEACE,0BlC87GJ,CkC37GI,gFACE,wBAlBG,CAmBH,oDAAA,CAAA,4ClC67GN,CkCz7GI,8EACE,alC27GN,CkCh9GE,oDACE,oBlCm9GJ,CkCh9GI,8EACE,gClCk9GN,CkC78GE,4DACE,0BlCg9GJ,CkC78GI,0EACE,wBAlBG,CAmBH,iDAAA,CAAA,yClC+8GN,CkC38GI,wEACE,alC68GN,CkCl+GE,4DACE,oBlCq+GJ,CkCl+GI,sFACE,gClCo+GN,CkC/9GE,oEACE,0BlCk+GJ,CkC/9GI,kFACE,wBAlBG,CAmBH,qDAAA,CAAA,6ClCi+GN,CkC79GI,gFACE,alC+9GN,CkCp/GE,wDACE,oBlCu/GJ,CkCp/GI,kFACE,gClCs/GN,CkCj/GE,gEACE,0BlCo/GJ,CkCj/GI,8EACE,wBAlBG,CAmBH,mDAAA,CAAA,2ClCm/GN,CkC/+GI,4EACE,alCi/GN,CmCrpHA,MACE,qMnCwpHF,CmC/oHE,sBAEE,uCAAA,CADA,gBnCmpHJ,CmC/oHI,mCACE,anCipHN,CmClpHI,mCACE,cnCipHN,CmC7oHM,4BACE,sBnC+oHR,CmC5oHQ,mCACE,gCnC8oHV,CmC1oHQ,2DACE,SAAA,CAEA,uBAAA,CADA,enC6oHV,CmCxoHQ,yGACE,SAAA,CACA,uBnC0oHV,CmCtoHQ,yCACE,YnCwoHV,CmCjoHE,0BACE,eAAA,CACA,enCmoHJ,CmChoHI,+BACE,oBnCkoHN,CmC7nHE,gDACE,YnC+nHJ,CmC3nHE,8BAIE,+BAAA,CAHA,oBAAA,CAEA,WA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","file":"main.css"}
\ No newline at end of file
diff --git a/latest/assets/stylesheets/palette.06af60db.min.css b/latest/assets/stylesheets/palette.06af60db.min.css
new file mode 100644
index 000000000..a640d38ab
--- /dev/null
+++ b/latest/assets/stylesheets/palette.06af60db.min.css
@@ -0,0 +1 @@
+@media screen{[data-md-color-scheme=slate]{--md-default-fg-color:hsla(var(--md-hue),15%,90%,0.82);--md-default-fg-color--light:hsla(var(--md-hue),15%,90%,0.56);--md-default-fg-color--lighter:hsla(var(--md-hue),15%,90%,0.32);--md-default-fg-color--lightest:hsla(var(--md-hue),15%,90%,0.12);--md-default-bg-color:hsla(var(--md-hue),15%,14%,1);--md-default-bg-color--light:hsla(var(--md-hue),15%,14%,0.54);--md-default-bg-color--lighter:hsla(var(--md-hue),15%,14%,0.26);--md-default-bg-color--lightest:hsla(var(--md-hue),15%,14%,0.07);--md-code-fg-color:hsla(var(--md-hue),18%,86%,0.82);--md-code-bg-color:hsla(var(--md-hue),15%,18%,1);--md-code-hl-color:#2977ff;--md-code-hl-color--light:#2977ff1a;--md-code-hl-number-color:#e6695b;--md-code-hl-special-color:#f06090;--md-code-hl-function-color:#c973d9;--md-code-hl-constant-color:#9383e2;--md-code-hl-keyword-color:#6791e0;--md-code-hl-string-color:#2fb170;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-kbd-color:hsla(var(--md-hue),15%,90%,0.12);--md-typeset-kbd-accent-color:hsla(var(--md-hue),15%,90%,0.2);--md-typeset-kbd-border-color:hsla(var(--md-hue),15%,14%,1);--md-typeset-mark-color:#4287ff4d;--md-typeset-table-color:hsla(var(--md-hue),15%,95%,0.12);--md-typeset-table-color--light:hsla(var(--md-hue),15%,95%,0.035);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-footer-bg-color:hsla(var(--md-hue),15%,10%,0.87);--md-footer-bg-color--dark:hsla(var(--md-hue),15%,8%,1);--md-shadow-z1:0 0.2rem 0.5rem #0000000d,0 0 0.05rem #0000001a;--md-shadow-z2:0 0.2rem 0.5rem #00000040,0 0 0.05rem #00000040;--md-shadow-z3:0 0.2rem 0.5rem #0006,0 0 0.05rem #00000059;color-scheme:dark}[data-md-color-scheme=slate] img[src$="#gh-light-mode-only"],[data-md-color-scheme=slate] img[src$="#only-light"]{display:none}[data-md-color-scheme=slate][data-md-color-primary=pink]{--md-typeset-a-color:#ed5487}[data-md-color-scheme=slate][data-md-color-primary=purple]{--md-typeset-a-color:#c46fd3}[data-md-color-scheme=slate][data-md-color-primary=deep-purple]{--md-typeset-a-color:#a47bea}[data-md-color-scheme=slate][data-md-color-primary=indigo]{--md-typeset-a-color:#5488e8}[data-md-color-scheme=slate][data-md-color-primary=teal]{--md-typeset-a-color:#00ccb8}[data-md-color-scheme=slate][data-md-color-primary=green]{--md-typeset-a-color:#71c174}[data-md-color-scheme=slate][data-md-color-primary=deep-orange]{--md-typeset-a-color:#ff764d}[data-md-color-scheme=slate][data-md-color-primary=brown]{--md-typeset-a-color:#c1775c}[data-md-color-scheme=slate][data-md-color-primary=black],[data-md-color-scheme=slate][data-md-color-primary=blue-grey],[data-md-color-scheme=slate][data-md-color-primary=grey],[data-md-color-scheme=slate][data-md-color-primary=white]{--md-typeset-a-color:#5e8bde}[data-md-color-switching] *,[data-md-color-switching] :after,[data-md-color-switching] :before{transition-duration:0ms!important}}[data-md-color-accent=red]{--md-accent-fg-color:#ff1947;--md-accent-fg-color--transparent:#ff19471a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=pink]{--md-accent-fg-color:#f50056;--md-accent-fg-color--transparent:#f500561a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=purple]{--md-accent-fg-color:#df41fb;--md-accent-fg-color--transparent:#df41fb1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=deep-purple]{--md-accent-fg-color:#7c4dff;--md-accent-fg-color--transparent:#7c4dff1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=indigo]{--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:#526cfe1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=blue]{--md-accent-fg-color:#4287ff;--md-accent-fg-color--transparent:#4287ff1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=light-blue]{--md-accent-fg-color:#0091eb;--md-accent-fg-color--transparent:#0091eb1a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=cyan]{--md-accent-fg-color:#00bad6;--md-accent-fg-color--transparent:#00bad61a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=teal]{--md-accent-fg-color:#00bda4;--md-accent-fg-color--transparent:#00bda41a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=green]{--md-accent-fg-color:#00c753;--md-accent-fg-color--transparent:#00c7531a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=light-green]{--md-accent-fg-color:#63de17;--md-accent-fg-color--transparent:#63de171a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-accent=lime]{--md-accent-fg-color:#b0eb00;--md-accent-fg-color--transparent:#b0eb001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=yellow]{--md-accent-fg-color:#ffd500;--md-accent-fg-color--transparent:#ffd5001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=amber]{--md-accent-fg-color:#fa0;--md-accent-fg-color--transparent:#ffaa001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=orange]{--md-accent-fg-color:#ff9100;--md-accent-fg-color--transparent:#ff91001a;--md-accent-bg-color:#000000de;--md-accent-bg-color--light:#0000008a}[data-md-color-accent=deep-orange]{--md-accent-fg-color:#ff6e42;--md-accent-fg-color--transparent:#ff6e421a;--md-accent-bg-color:#fff;--md-accent-bg-color--light:#ffffffb3}[data-md-color-primary=red]{--md-primary-fg-color:#ef5552;--md-primary-fg-color--light:#e57171;--md-primary-fg-color--dark:#e53734;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=pink]{--md-primary-fg-color:#e92063;--md-primary-fg-color--light:#ec417a;--md-primary-fg-color--dark:#c3185d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=purple]{--md-primary-fg-color:#ab47bd;--md-primary-fg-color--light:#bb69c9;--md-primary-fg-color--dark:#8c24a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=deep-purple]{--md-primary-fg-color:#7e56c2;--md-primary-fg-color--light:#9574cd;--md-primary-fg-color--dark:#673ab6;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=indigo]{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=blue]{--md-primary-fg-color:#2094f3;--md-primary-fg-color--light:#42a5f5;--md-primary-fg-color--dark:#1975d2;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=light-blue]{--md-primary-fg-color:#02a6f2;--md-primary-fg-color--light:#28b5f6;--md-primary-fg-color--dark:#0287cf;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=cyan]{--md-primary-fg-color:#00bdd6;--md-primary-fg-color--light:#25c5da;--md-primary-fg-color--dark:#0097a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=teal]{--md-primary-fg-color:#009485;--md-primary-fg-color--light:#26a699;--md-primary-fg-color--dark:#007a6c;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=green]{--md-primary-fg-color:#4cae4f;--md-primary-fg-color--light:#68bb6c;--md-primary-fg-color--dark:#398e3d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=light-green]{--md-primary-fg-color:#8bc34b;--md-primary-fg-color--light:#9ccc66;--md-primary-fg-color--dark:#689f38;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=lime]{--md-primary-fg-color:#cbdc38;--md-primary-fg-color--light:#d3e156;--md-primary-fg-color--dark:#b0b52c;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=yellow]{--md-primary-fg-color:#ffec3d;--md-primary-fg-color--light:#ffee57;--md-primary-fg-color--dark:#fbc02d;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=amber]{--md-primary-fg-color:#ffc105;--md-primary-fg-color--light:#ffc929;--md-primary-fg-color--dark:#ffa200;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=orange]{--md-primary-fg-color:#ffa724;--md-primary-fg-color--light:#ffa724;--md-primary-fg-color--dark:#fa8900;--md-primary-bg-color:#000000de;--md-primary-bg-color--light:#0000008a}[data-md-color-primary=deep-orange]{--md-primary-fg-color:#ff6e42;--md-primary-fg-color--light:#ff8a66;--md-primary-fg-color--dark:#f4511f;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=brown]{--md-primary-fg-color:#795649;--md-primary-fg-color--light:#8d6e62;--md-primary-fg-color--dark:#5d4037;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3}[data-md-color-primary=grey]{--md-primary-fg-color:#757575;--md-primary-fg-color--light:#9e9e9e;--md-primary-fg-color--dark:#616161;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-typeset-a-color:#4051b5}[data-md-color-primary=blue-grey]{--md-primary-fg-color:#546d78;--md-primary-fg-color--light:#607c8a;--md-primary-fg-color--dark:#455a63;--md-primary-bg-color:#fff;--md-primary-bg-color--light:#ffffffb3;--md-typeset-a-color:#4051b5}[data-md-color-primary=light-green]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#72ad2e}[data-md-color-primary=lime]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#8b990a}[data-md-color-primary=yellow]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#b8a500}[data-md-color-primary=amber]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#d19d00}[data-md-color-primary=orange]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#e68a00}[data-md-color-primary=white]{--md-primary-fg-color:hsla(var(--md-hue),0%,100%,1);--md-primary-fg-color--light:hsla(var(--md-hue),0%,100%,0.7);--md-primary-fg-color--dark:hsla(var(--md-hue),0%,0%,0.07);--md-primary-bg-color:hsla(var(--md-hue),0%,0%,0.87);--md-primary-bg-color--light:hsla(var(--md-hue),0%,0%,0.54);--md-typeset-a-color:#4051b5}[data-md-color-primary=white] .md-button{color:var(--md-typeset-a-color)}[data-md-color-primary=white] .md-button--primary{background-color:var(--md-typeset-a-color);border-color:var(--md-typeset-a-color);color:hsla(var(--md-hue),0%,100%,1)}@media screen and (min-width:60em){[data-md-color-primary=white] .md-search__form{background-color:hsla(var(--md-hue),0%,0%,.07)}[data-md-color-primary=white] .md-search__form:hover{background-color:hsla(var(--md-hue),0%,0%,.32)}[data-md-color-primary=white] .md-search__input+.md-search__icon{color:hsla(var(--md-hue),0%,0%,.87)}}@media screen and (min-width:76.25em){[data-md-color-primary=white] .md-tabs{border-bottom:.05rem solid #00000012}}[data-md-color-primary=black]{--md-primary-fg-color:hsla(var(--md-hue),15%,9%,1);--md-primary-fg-color--light:hsla(var(--md-hue),15%,9%,0.54);--md-primary-fg-color--dark:hsla(var(--md-hue),15%,9%,1);--md-primary-bg-color:hsla(var(--md-hue),15%,100%,1);--md-primary-bg-color--light:hsla(var(--md-hue),15%,100%,0.7);--md-typeset-a-color:#4051b5}[data-md-color-primary=black] .md-button{color:var(--md-typeset-a-color)}[data-md-color-primary=black] .md-button--primary{background-color:var(--md-typeset-a-color);border-color:var(--md-typeset-a-color);color:hsla(var(--md-hue),0%,100%,1)}[data-md-color-primary=black] .md-header{background-color:hsla(var(--md-hue),15%,9%,1)}@media screen and (max-width:59.984375em){[data-md-color-primary=black] .md-nav__source{background-color:hsla(var(--md-hue),15%,11%,.87)}}@media screen and (max-width:76.234375em){html [data-md-color-primary=black] .md-nav--primary .md-nav__title[for=__drawer]{background-color:hsla(var(--md-hue),15%,9%,1)}}@media screen and (min-width:76.25em){[data-md-color-primary=black] .md-tabs{background-color:hsla(var(--md-hue),15%,9%,1)}}
\ No newline at end of file
diff --git a/latest/assets/stylesheets/palette.06af60db.min.css.map b/latest/assets/stylesheets/palette.06af60db.min.css.map
new file mode 100644
index 000000000..efb568c52
--- /dev/null
+++ b/latest/assets/stylesheets/palette.06af60db.min.css.map
@@ -0,0 +1 @@
+{"version":3,"sources":["src/templates/assets/stylesheets/palette/_scheme.scss","../../../../src/templates/assets/stylesheets/palette.scss","src/templates/assets/stylesheets/palette/_accent.scss","src/templates/assets/stylesheets/palette/_primary.scss","src/templates/assets/stylesheets/utilities/_break.scss"],"names":[],"mappings":"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","file":"palette.css"}
\ No newline at end of file
diff --git a/latest/contributing/DCO/index.html b/latest/contributing/DCO/index.html
new file mode 100644
index 000000000..02821d1d1
--- /dev/null
+++ b/latest/contributing/DCO/index.html
@@ -0,0 +1,37 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for compliance-trestle package."><link href=https://oscal-compass.github.io/compliance-trestle/latest/contributing/DCO/ rel=canonical><link href=../maintainers/ rel=prev><link href=../github_actions_setup/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Developer Certificate of Originality - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Developer Certificate of Originality - Compliance Trestle"><meta property=og:description content="Documentation for compliance-trestle package."><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/DCO.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/contributing/DCO/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Developer Certificate of Originality - Compliance Trestle"><meta name=twitter:description content="Documentation for compliance-trestle package."><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/DCO.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Developer Certificate of Originality </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6 checked> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=true> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>Developer Certificate of Originality</h1> <div class=highlight><pre><span></span><code>Developer Certificate of Origin
+Version 1.1
+
+Copyright (C) 2004, 2006 The Linux Foundation and its contributors.
+660 York Street, Suite 102,
+San Francisco, CA 94110 USA
+
+Everyone is permitted to copy and distribute verbatim copies of this
+license document, but changing it is not allowed.
+
+
+Developer&#39;s Certificate of Origin 1.1
+
+By making a contribution to this project, I certify that:
+
+(a) The contribution was created in whole or in part by me and I
+have the right to submit it under the open source license
+indicated in the file; or
+
+(b) The contribution is based upon previous work that, to the best
+of my knowledge, is covered under an appropriate open source
+license and I have the right under that license to submit that
+work with modifications, whether created in whole or in part
+by me, under the same open source license (unless I am
+permitted to submit under a different license), as indicated
+in the file; or
+
+(c) The contribution was provided directly to me by some other
+person who certified (a), (b) or (c) and I have not modified
+it.
+
+(d) I understand and agree that this project and the contribution
+are public and that a record of the contribution (including all
+personal information I submit with it, including my sign-off) is
+maintained indefinitely and may be redistributed consistent with
+this project or the open source license(s) involved.
+</code></pre></div> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">January 14, 2021</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/contributing/code_of_conduct/index.html b/latest/contributing/code_of_conduct/index.html
new file mode 100644
index 000000000..618b079a1
--- /dev/null
+++ b/latest/contributing/code_of_conduct/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Code of conduct for engaging with the compliance trestle community"><link href=https://oscal-compass.github.io/compliance-trestle/latest/contributing/code_of_conduct/ rel=canonical><link href=../ rel=prev><link href=../oscal_object_model/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Code of conduct - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Code of conduct - Compliance Trestle"><meta property=og:description content="Code of conduct for engaging with the compliance trestle community"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/code_of_conduct.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/contributing/code_of_conduct/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Code of conduct - Compliance Trestle"><meta name=twitter:description content="Code of conduct for engaging with the compliance trestle community"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/code_of_conduct.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#code-of-conduct class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Code of conduct </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6 checked> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=true> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=code-of-conduct>Code of Conduct<a class=headerlink href=#code-of-conduct title="Permanent link">¤</a></h1> <p>Please refer to our <a href=https://github.com/oscal-compass/community/blob/main/CODE_OF_CONDUCT.md>OSCAL Compass Community Code of Conduct</a>.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">July 30, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/contributing/github_actions_setup/index.html b/latest/contributing/github_actions_setup/index.html
new file mode 100644
index 000000000..28575484a
--- /dev/null
+++ b/latest/contributing/github_actions_setup/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Setting up github actions for a fork of compliance trestle for development"><link href=https://oscal-compass.github.io/compliance-trestle/latest/contributing/github_actions_setup/ rel=canonical><link href=../DCO/ rel=prev><link href=../../plugins/fedramp/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Setting up GitHub actions - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Setting up GitHub actions - Compliance Trestle"><meta property=og:description content="Setting up github actions for a fork of compliance trestle for development"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/github_actions_setup.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/contributing/github_actions_setup/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Setting up GitHub actions - Compliance Trestle"><meta name=twitter:description content="Setting up github actions for a fork of compliance trestle for development"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/github_actions_setup.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#github-actions-setup class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Setting up GitHub actions </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6 checked> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=true> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> GitHub actions </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> GitHub actions </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#secrets class=md-nav__link> <span class=md-ellipsis> Secrets </span> </a> </li> <li class=md-nav__item> <a href=#authorization-with-pypi class=md-nav__link> <span class=md-ellipsis> Authorization with pypi </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#secrets class=md-nav__link> <span class=md-ellipsis> Secrets </span> </a> </li> <li class=md-nav__item> <a href=#authorization-with-pypi class=md-nav__link> <span class=md-ellipsis> Authorization with pypi </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=github-actions-setup>Github actions setup<a class=headerlink href=#github-actions-setup title="Permanent link">¤</a></h1> <p>Github actions contains variables which have opaque values to a user. The variables are documented here such that trestle can be setup on a fork for independent development. This is not required to open a pull request against the compliance-trestle project. Project maintainers, after an initial review, will allow github actions workflows to run.</p> <h2 id=secrets>Secrets<a class=headerlink href=#secrets title="Permanent link">¤</a></h2> <ul> <li> <p><code>APP_ID</code> and <code>PRIVATE_KEY</code>: GitHub App information with sufficient write access to merge content into <code>develop</code> and commit to <code>gh-pages</code> and <code>main</code></p> </li> <li> <p><code>SONAR_TOKEN</code>: Token to sonarcloud with rights to the appropriate project.</p> </li> </ul> <h2 id=authorization-with-pypi>Authorization with pypi<a class=headerlink href=#authorization-with-pypi title="Permanent link">¤</a></h2> <p>Pypi authorization must be setup following the procedure in the following documents</p> <ul> <li><a href=https://docs.pypi.org/trusted-publishers/adding-a-publisher/ >https://docs.pypi.org/trusted-publishers/adding-a-publisher/</a></li> </ul> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/contributing/images/trestle-OSCAL-upgrade.png b/latest/contributing/images/trestle-OSCAL-upgrade.png
new file mode 100644
index 0000000000000000000000000000000000000000..63e73799fa048c764f36a6827412741115d9f7e3
GIT binary patch
literal 202666
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%0AFAjXReVgK|sd(jN`bCV#)OlOXOD+Od
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

literal 0
HcmV?d00001

diff --git a/latest/contributing/index.html b/latest/contributing/index.html
new file mode 100644
index 000000000..8461aca72
--- /dev/null
+++ b/latest/contributing/index.html
@@ -0,0 +1,27 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="An overview of tools and processes for contributing to compliance-trestle"><link href=https://oscal-compass.github.io/compliance-trestle/latest/contributing/ rel=canonical><link href=../license/ rel=prev><link href=code_of_conduct/ rel=next><link rel=icon href=../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Overview - Compliance Trestle</title><link rel=stylesheet href=../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../assets/_mkdocstrings.css><script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Overview - Compliance Trestle"><meta property=og:description content="An overview of tools and processes for contributing to compliance-trestle"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/index.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/contributing/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Overview - Compliance Trestle"><meta name=twitter:description content="An overview of tools and processes for contributing to compliance-trestle"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/index.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#contributing-in-general class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Overview </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../license/ class=md-tabs__link> License </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6 checked> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=true> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Overview </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Overview </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#contributing-in-general class=md-nav__link> <span class=md-ellipsis> Contributing In General </span> </a> <nav class=md-nav aria-label="Contributing In General"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#proposing-new-features class=md-nav__link> <span class=md-ellipsis> Proposing new features </span> </a> </li> <li class=md-nav__item> <a href=#fixing-bugs class=md-nav__link> <span class=md-ellipsis> Fixing bugs </span> </a> </li> <li class=md-nav__item> <a href=#merge-approval class=md-nav__link> <span class=md-ellipsis> Merge approval </span> </a> </li> <li class=md-nav__item> <a href=#trestle-updating-testing-and-release-logistics class=md-nav__link> <span class=md-ellipsis> Trestle updating, testing and release logistics </span> </a> </li> <li class=md-nav__item> <a href=#trestle-merging-and-release-workflow class=md-nav__link> <span class=md-ellipsis> Trestle merging and release workflow </span> </a> </li> <li class=md-nav__item> <a href=#merge-details-for-committers class=md-nav__link> <span class=md-ellipsis> Merge details for committers: </span> </a> </li> <li class=md-nav__item> <a href=#working-from-a-fork class=md-nav__link> <span class=md-ellipsis> Working from a fork </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#typing-docstrings-and-documentation class=md-nav__link> <span class=md-ellipsis> Typing, docstrings and documentation </span> </a> </li> <li class=md-nav__item> <a href=#legal class=md-nav__link> <span class=md-ellipsis> Legal </span> </a> </li> <li class=md-nav__item> <a href=#setup-developing-trestle class=md-nav__link> <span class=md-ellipsis> Setup - Developing trestle </span> </a> <nav class=md-nav aria-label="Setup - Developing trestle"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#does-trestle-run-correctly-on-my-platform class=md-nav__link> <span class=md-ellipsis> Does trestle run correctly on my platform </span> </a> </li> <li class=md-nav__item> <a href=#setting-up-vscode-for-python class=md-nav__link> <span class=md-ellipsis> Setting up vscode for python. </span> </a> </li> <li class=md-nav__item> <a href=#testing-python-in-vscode class=md-nav__link> <span class=md-ellipsis> Testing python in vscode </span> </a> <nav class=md-nav aria-label="Testing python in vscode"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#nist-reference-data-for-testing class=md-nav__link> <span class=md-ellipsis> NIST reference data for testing. </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#code-testing class=md-nav__link> <span class=md-ellipsis> Code testing </span> </a> </li> <li class=md-nav__item> <a href=#code-style-and-formating class=md-nav__link> <span class=md-ellipsis> Code style and formating </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#developers-guide-to-trestle-upgrade-commensurate-with-oscal-models-upgrade class=md-nav__link> <span class=md-ellipsis> Developers Guide to trestle upgrade commensurate with OSCAL models upgrade </span> </a> <nav class=md-nav aria-label="Developers Guide to trestle upgrade commensurate with OSCAL models upgrade"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#overview-of-process-to-take-oscal-models-and-upgrade-trestle-python-code class=md-nav__link> <span class=md-ellipsis> Overview of process to take OSCAL models and upgrade trestle Python code </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#contributing-in-general class=md-nav__link> <span class=md-ellipsis> Contributing In General </span> </a> <nav class=md-nav aria-label="Contributing In General"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#proposing-new-features class=md-nav__link> <span class=md-ellipsis> Proposing new features </span> </a> </li> <li class=md-nav__item> <a href=#fixing-bugs class=md-nav__link> <span class=md-ellipsis> Fixing bugs </span> </a> </li> <li class=md-nav__item> <a href=#merge-approval class=md-nav__link> <span class=md-ellipsis> Merge approval </span> </a> </li> <li class=md-nav__item> <a href=#trestle-updating-testing-and-release-logistics class=md-nav__link> <span class=md-ellipsis> Trestle updating, testing and release logistics </span> </a> </li> <li class=md-nav__item> <a href=#trestle-merging-and-release-workflow class=md-nav__link> <span class=md-ellipsis> Trestle merging and release workflow </span> </a> </li> <li class=md-nav__item> <a href=#merge-details-for-committers class=md-nav__link> <span class=md-ellipsis> Merge details for committers: </span> </a> </li> <li class=md-nav__item> <a href=#working-from-a-fork class=md-nav__link> <span class=md-ellipsis> Working from a fork </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#typing-docstrings-and-documentation class=md-nav__link> <span class=md-ellipsis> Typing, docstrings and documentation </span> </a> </li> <li class=md-nav__item> <a href=#legal class=md-nav__link> <span class=md-ellipsis> Legal </span> </a> </li> <li class=md-nav__item> <a href=#setup-developing-trestle class=md-nav__link> <span class=md-ellipsis> Setup - Developing trestle </span> </a> <nav class=md-nav aria-label="Setup - Developing trestle"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#does-trestle-run-correctly-on-my-platform class=md-nav__link> <span class=md-ellipsis> Does trestle run correctly on my platform </span> </a> </li> <li class=md-nav__item> <a href=#setting-up-vscode-for-python class=md-nav__link> <span class=md-ellipsis> Setting up vscode for python. </span> </a> </li> <li class=md-nav__item> <a href=#testing-python-in-vscode class=md-nav__link> <span class=md-ellipsis> Testing python in vscode </span> </a> <nav class=md-nav aria-label="Testing python in vscode"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#nist-reference-data-for-testing class=md-nav__link> <span class=md-ellipsis> NIST reference data for testing. </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#code-testing class=md-nav__link> <span class=md-ellipsis> Code testing </span> </a> </li> <li class=md-nav__item> <a href=#code-style-and-formating class=md-nav__link> <span class=md-ellipsis> Code style and formating </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#developers-guide-to-trestle-upgrade-commensurate-with-oscal-models-upgrade class=md-nav__link> <span class=md-ellipsis> Developers Guide to trestle upgrade commensurate with OSCAL models upgrade </span> </a> <nav class=md-nav aria-label="Developers Guide to trestle upgrade commensurate with OSCAL models upgrade"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#overview-of-process-to-take-oscal-models-and-upgrade-trestle-python-code class=md-nav__link> <span class=md-ellipsis> Overview of process to take OSCAL models and upgrade trestle Python code </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>Overview</h1> <h2 id=contributing-in-general>Contributing In General<a class=headerlink href=#contributing-in-general title="Permanent link">¤</a></h2> <p>Our project welcomes external contributions. If you have an itch, please feel free to scratch it.</p> <p>To contribute code or documentation, please submit a <a href=https://github.com/oscal-compass/compliance-trestle/pulls>pull request</a>.</p> <p>A good way to familiarize yourself with the codebase and contribution process is to look for and tackle low-hanging fruit in the <a href=https://github.com/oscal-compass/compliance-trestle/issues>issue tracker</a>. Before embarking on a more ambitious contribution, please quickly <a href=https://oscal-compass.github.io/compliance-trestle/maintainers/ >get in touch</a> with us.</p> <p><strong>Note: We appreciate your effort, and want to avoid a situation where a contribution requires extensive rework (by you or by us), sits in backlog for a long time, or cannot be accepted at all!</strong></p> <h3 id=proposing-new-features>Proposing new features<a class=headerlink href=#proposing-new-features title="Permanent link">¤</a></h3> <p>If you would like to implement a new feature, please <a href=https://github.com/oscal-compass/compliance-trestle/issues>raise an issue</a> labelled <code>enhancement</code> before sending a pull request so the feature can be discussed. This is to avoid you wasting your valuable time working on a feature that the project developers are not interested in accepting into the code base.</p> <h3 id=fixing-bugs>Fixing bugs<a class=headerlink href=#fixing-bugs title="Permanent link">¤</a></h3> <p>If you would like to fix a bug, please <a href=https://github.com/oscal-compass/compliance-trestle/issues>raise an issue</a> labelled <code>bug</code> before sending a pull request so it can be tracked.</p> <h3 id=merge-approval>Merge approval<a class=headerlink href=#merge-approval title="Permanent link">¤</a></h3> <p>The project maintainers use LGTM (Looks Good To Me) in comments on the code review to indicate acceptance.</p> <p>A change requires LGTMs from at least two reviewers. One of the reviewers must be a <a href=https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners><code>CODEOWNER</code></a>.</p> <p>For a list of the maintainers (also codeowners), see the <a href=https://oscal-compass.github.io/compliance-trestle/maintainers/ >maintainers</a> page.</p> <h3 id=trestle-updating-testing-and-release-logistics>Trestle updating, testing and release logistics<a class=headerlink href=#trestle-updating-testing-and-release-logistics title="Permanent link">¤</a></h3> <p>Contributors should make a working copy (branch or fork) from the develop branch of <code>trestle</code>. Contributors should update the working copy with changes, then create a pull request to merge into the develop branch. Contributors must include test cases to meet at least the minimum code coverage requirements. Upon approval from reviewer(s), the working copy is squashed and merged into the develop branch. Upon a cadence established by the maintainers, the develop branch is merged into the main branch and a new release is uniquely numbered and pushed to <a href=https://pypi.org/project/compliance-trestle/ >pypi</a>.</p> <p><code>trestle</code> employs <code>semantic release</code> to automatically control release numbering. Code deliveries should be tagged with prefix <code>fix:</code> for changes that are bug fixes or <code>feat:</code> for changes that are new features. See <a href=https://python-semantic-release.readthedocs.io/en/latest/commit_parsing.html#commit-parser-builtin-angular>allowed_tags</a> for a list of supported tags.</p> <h3 id=trestle-merging-and-release-workflow>Trestle merging and release workflow<a class=headerlink href=#trestle-merging-and-release-workflow title="Permanent link">¤</a></h3> <p><code>trestle</code> is operating on a simple, yet opinionated, method for continuous integration. It's designed to give developers a coherent understanding of the objectives of other past developers. The criteria for this are below. Trestle effectively uses a gitflow workflow with one modification: PR's merge into develop are squash merged as one commit.</p> <p>In trestle's CI environment this results in the following rules:</p> <ol> <li>All Commit's <em>MUST</em> be signed off with <code>git commit --signoff</code> irrespective of the author's affiliation. This ensures all code can be attributed.</li> <li>This is enforced by DCO bot and can be overrided by maintainers presuming at least one commit is signed-off.</li> <li>All commits <em>SHOULD</em> use <a href=https://www.conventionalcommits.org/en/v1.0.0-beta.2/ >conventional commits</a></li> <li>This is as github, when only one commit is in a PR, will use the native git commit message as the merge commit title.<ol> <li>When only a single commit is provided the commit MUST be an conventional commit and will be checked the <code>Lint PR</code> aciton.</li> </ol> </li> <li>All PR's title's MUST be formed as an <a href=https://www.conventionalcommits.org/en/v1.0.0-beta.2/ >convention commit</a></li> <li>This is checked by the <code>Lint PR</code> action</li> <li>All PR's to <code>develop</code> and hotfix PR's to <code>main</code> must close at least one issue by <a href=https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword>linking the PR to an issue</a>.</li> <li>Trestle will release on demand the default approach for a hot fix should be to merge into <code>develop</code>, followed by releasing to <code>main</code>, unless this will release functionality that is not ready.</li> <li>Each feature/fix/chore (PR into develop) be represented by a single commit into develop / main with a coherent title (in the PR).</li> <li>The trestle preference for doing this is to use squash merge functionality when merging a PR into develop.</li> <li>Developers <em>MUST</em> pass the required CI checks for each PR. The checks enforce code quality with a format checker (yapf) and linter (flake8).</li> <li>Developers are encouraged to use GitHub's automated merge process where possible to keep the number of active PR's low.</li> </ol> <h3 id=merge-details-for-committers>Merge details for committers:<a class=headerlink href=#merge-details-for-committers title="Permanent link">¤</a></h3> <ol> <li>All merges into develop MUST be conducted by a squash-merge</li> <li>All merges from develop into main MUST be done by a merge commit (e.g. preserving the history of commits into the develop branch).</li> <li>Hotfixes into main, not via develop, MUST be done via a squash merge.</li> <li>Merge's into any branch excluding main and develop are at the developers choice.</li> <li>Use of autocommit is encouraged to ensure commit messages and squash vs merge commit are completed properly.</li> </ol> <h3 id=working-from-a-fork>Working from a fork<a class=headerlink href=#working-from-a-fork title="Permanent link">¤</a></h3> <ol> <li>In order not to break Github Actions security model SonarCloud will not run on a fork.</li> <li>Given this a maintainer MAY determine that sonar needs to be run and ask you to first merge your branch to a staging branch, after reviewing for security risks in the CI pipeline.</li> <li>From this staging branch sonar would be run and then the code merged.</li> </ol> <h2 id=typing-docstrings-and-documentation>Typing, docstrings and documentation<a class=headerlink href=#typing-docstrings-and-documentation title="Permanent link">¤</a></h2> <p><code>trestle</code> has a goal of using <a href=https://www.python.org/dev/peps/pep-0484/ >PEP 484</a> type annotations where possible / practical. The devops process does not <em>strictly</em> enforce typing, however, the expectation is that type coverage is added for new commits with a focus on quality over quantity (e.g. don't add <code>Any</code> everywhere just to meet coverage requirements). Python typing of functions is an active work in progress.</p> <p><code>mkbuild</code> is used to generate the <a href=https://oscal-compass.github.io/compliance-trestle>trestle documenation site</a>. The <code>mkbuild</code> website includes an API reference section generated from the code. Docstrings within the code are expected to follow <a href=https://www.sphinx-doc.org/en/master/usage/extensions/example_google.html>google style docstrings</a>.</p> <h2 id=legal>Legal<a class=headerlink href=#legal title="Permanent link">¤</a></h2> <p>Each source file must include a license header for the Apache Software License 2.0. Using the SPDX format is the simplest approach. e.g.</p> <div class=highlight><pre><span></span><code># Copyright (c) 2024 The OSCAL Compass Authors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an &quot;AS IS&quot; BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+</code></pre></div> <p>We have tried to make it as easy as possible to make contributions. This applies to how we handle the legal aspects of contribution. We use the same approach - the <a href=https://oscal-compass.github.io/compliance-trestle/contributing/DCO/ >Developer's Certificate of Origin 1.1 (DCO)</a> - that the Linux® Kernel <a href=https://developercertificate.org/ >community</a> uses to manage code contributions.</p> <p>We simply ask that when submitting a patch for review, the developer must include a sign-off statement in the commit message.</p> <p>Here is an example Signed-off-by line, which indicates that the submitter accepts the DCO:</p> <div class=highlight><pre><span></span><code>Signed-off-by: John Doe &lt;john.doe@example.com&gt;
+</code></pre></div> <p>You can include this automatically when you commit a change to your local git repository using the following command:</p> <div class=highlight><pre><span></span><code>git<span class=w> </span>commit<span class=w> </span>--signoff
+</code></pre></div> <p>Note that DCO signoff is enforced by <a href=https://github.com/probot/dco>DCO bot</a>. Missing DCO's will be required to be rebased with a signed off commit before being accepted.</p> <h2 id=setup-developing-trestle>Setup - Developing <code>trestle</code><a class=headerlink href=#setup-developing-trestle title="Permanent link">¤</a></h2> <h3 id=does-trestle-run-correctly-on-my-platform>Does <code>trestle</code> run correctly on my platform<a class=headerlink href=#does-trestle-run-correctly-on-my-platform title="Permanent link">¤</a></h3> <ul> <li>(Optional) setup a venv for python</li> <li>Run <code>make develop</code></li> <li>This will install all python dependencies</li> <li>It will also checkout the submodules required for testing.</li> <li>Run <code>make test</code></li> <li>This <em>should</em> run on all platforms</li> </ul> <h3 id=setting-up-vscode-for-python>Setting up <code>vscode</code> for python.<a class=headerlink href=#setting-up-vscode-for-python title="Permanent link">¤</a></h3> <ul> <li>Use the following commands to setup python:</li> </ul> <div class=highlight><pre><span></span><code>python3<span class=w> </span>-m<span class=w> </span>venv<span class=w> </span>venv
+.<span class=w> </span>./venv/bin/activate
+<span class=c1># for zsh put .[dev] in quotes as below</span>
+pip<span class=w> </span>install<span class=w> </span>-q<span class=w> </span>-e<span class=w> </span><span class=s2>&quot;.[dev]&quot;</span><span class=w> </span>--upgrade<span class=w> </span>--upgrade-strategy<span class=w> </span>eager
+</code></pre></div> <ul> <li> <p>Install vscode plugin <code>Python extension for Visual Studio Code</code></p> </li> <li> <p>Enable <code>yapf</code> for code formatting</p> </li> <li> <p>Enable <code>flake8</code> for code linting</p> </li> </ul> <h3 id=testing-python-in-vscode>Testing python in <code>vscode</code><a class=headerlink href=#testing-python-in-vscode title="Permanent link">¤</a></h3> <p>Tests should be in the test subdirectory. Each file should be named test_*.py and each test function should be named *_test().</p> <p>Note that with Python3 there should be no need for <strong>init</strong>.py in directories.</p> <p>Test discovery should be automatic when you select a .py file for editing. After tests are discovered a flask icon will appear on the left and you can select it to see a panel listing of your tests. In addition your test functions will be annotated with Run/Debug so they can be launched directly from the editor. When everything is set up properly you should be able to step through your test code - which is important.</p> <p>Sometimes the discovery fails - and you may need to resort to uninstalling the python extension and reinstalling it - perhaps also shutting down code and restarting. This is a lightweight operation and seems to be safe and usually fixes any problems.</p> <p>Test discovery will fail or stop if any of the tests have errors in them - so be sure to monitor the Problems panel at the bottom for problems in the code.</p> <p>Note that there are many panels available in Output - so be sure to check <code>Python Test Log</code> for errors and output from the tests.</p> <p>pytest fixtures are available to allow provision of common functionality. See conftest.py and tmp_dir for an example.</p> <h4 id=nist-reference-data-for-testing>NIST reference data for testing.<a class=headerlink href=#nist-reference-data-for-testing title="Permanent link">¤</a></h4> <p>Trestle relies on reference data from two NIST repositories for testing:</p> <ul> <li><a href=https://github.com/usnistgov/OSCAL>https://github.com/usnistgov/OSCAL</a></li> <li><a href=https://github.com/usnistgov/oscal-content>https://github.com/usnistgov/oscal-content</a></li> </ul> <p>Both of these repositories are submodules in the trestle project. In order to develop / test trestle the submodules must be checked out with <code>git submodule update --init</code> or <code>make submodules</code>.</p> <h3 id=code-testing>Code testing<a class=headerlink href=#code-testing title="Permanent link">¤</a></h3> <p>Tests must exist for at least 96% of trestle Python code. To determine the code coverage locally during development:</p> <div class=highlight><pre><span></span><code>make<span class=w> </span>test-cov
+</code></pre></div> <p>A PR without sufficient test coverage will fail the trestle CI process and will not be approved or merged.</p> <p>Additional code scrutiny is applied in the trestle CI pipeline by <a href="https://sonarcloud.io/project/overview?id=compliance-trestle">SonarCloud</a>. Any failures must be addressed before code merging.</p> <h3 id=code-style-and-formating>Code style and formating<a class=headerlink href=#code-style-and-formating title="Permanent link">¤</a></h3> <p>Python code should generally follow <a href=https://peps.python.org/pep-0008/ >PEP 8</a>.</p> <p><code>trestle</code> uses <a href=https://github.com/google/yapf>yapf</a> for code formatting and <a href=https://flake8.pycqa.org/en/latest/ >flake8</a> for code styling. It also uses <a href=https://pre-commit.com/ >pre-commit</a> hooks that are integrated into the development process and the CI. When you run <code>make develop</code> you are ensuring that the pre-commit hooks are installed and updated to their latest versions for this repository. This ensures that all delivered code has been properly formatted and passes the linter rules. See the <a href=https://github.com/oscal-compass/compliance-trestle/blob/develop/.pre-commit-config.yaml>pre-commit configuration file</a> for details on <code>yapf</code> and <code>flake8</code> configurations.</p> <p>Since <code>yapf</code> and <code>flake8</code> are installed as part of the <code>pre-commit</code> hooks, running <code>yapf</code> and <code>flake8</code> manually must be done through <code>pre-commit</code>. See examples below:</p> <div class=highlight><pre><span></span><code>make<span class=w> </span>code-format
+make<span class=w> </span>code-lint
+</code></pre></div> <p>...will run <code>yapf</code> and <code>flake8</code> on the entire repo and is equivalent to:</p> <div class=highlight><pre><span></span><code>pre-commit<span class=w> </span>run<span class=w> </span>yapf<span class=w> </span>--all-files
+pre-commit<span class=w> </span>run<span class=w> </span>flake8<span class=w> </span>--all-files
+</code></pre></div> <p>...and when looking to limit execution to a subset of files do similar to:</p> <div class=highlight><pre><span></span><code>pre-commit<span class=w> </span>run<span class=w> </span>yapf<span class=w> </span>--files<span class=w> </span>trestle/*
+pre-commit<span class=w> </span>run<span class=w> </span>flake8<span class=w> </span>--files<span class=w> </span>trestle/*
+</code></pre></div> <p>Note that in both of these cases autogenerated files under <code>trestle/oscal</code> are excluded. Note that for IDE support <code>setup.cfg</code> maintains a cache of <code>flake8</code> configuration.</p> <h2 id=developers-guide-to-trestle-upgrade-commensurate-with-oscal-models-upgrade>Developers Guide to trestle upgrade commensurate with OSCAL models upgrade<a class=headerlink href=#developers-guide-to-trestle-upgrade-commensurate-with-oscal-models-upgrade title="Permanent link">¤</a></h2> <p>This is a general guide on how to go about upgrading compliance-trestle to support a new version of OSCAL models.</p> <p>The steps are as follows:</p> <ol> <li> Create in GitHub repo <i style=color:darkgrey;>(remote)</i> <li> Clone upgrade branch into <span style=color:darkgreen;>/trestle-upgrade</span> folder <i style=color:darkgrey;>(local <- remote)</i> <li> Download revised and new OSCAL models into folder <span style=color:darkgreen;>/trestle-upgrade/release-schemas</span> <i style=color:darkgrey;>(local <- remote)</i> <ul> <li> See <a href=https://github.com/usnistgov/OSCAL/releases>https://github.com/usnistgov/OSCAL/releases</a> </ul> <li> Create & source python virtual environment <span style=color:darkgreen;>venv.trestle-upgrade</span> <i style=color:darkgrey;>(local)</i> <li> Orient current folder to <span style=color:darkgreen;>/trestle-upgrade</span> <i style=color:darkgrey;>(local)</i> <li> Run <span style=color:blue;>make develop</span> <i style=color:darkgrey;>(local)</i> <li> Make necessary code changes: <ul> <li> Run <span style=color:blue;>python scripts/gen_oscal.py</span> <i style=color:darkgrey;>(local)</i> <li> Run <span style=color:blue;>make test-all</span> <i style=color:darkgrey;>(local)</i> <li> Fix errors and failures via modification of code generation modules and existing trestle modules, as appropriate case-by-case <i style=color:darkgrey;>(local)</i> <li> Repeat until all errors and failures are fixed <i style=color:darkgrey;>(local)</i> </ul> <li> Run <span style=color:blue;>make code-format</span> <i style=color:darkgrey;>(local)</i> <li> Run <span style=color:blue;>make code-lint</span> <i style=color:darkgrey;>(local)</i> <li> Push <span style=color:darkgreen;>/trestle-upgrade</span> folder changes back to GitHub repo <i style=color:darkgrey;>(local -> remote)</i> <li> Create PR for trestle-upgrade branch -> develop branch <i style=color:darkgrey;>(remote)</i> <li> Get PR approval <i style=color:darkgrey;>(remote)</i> <li> Merge PR into develop branch <i style=color:darkgrey;>(remote)</i> <li> Create PR for develop branch -> main branch <i style=color:darkgrey;>(remote)</i> <li> Create <span style=color:red;>breaking change</span> <i style=color:darkgrey;>(remote)</i> <li> Get PR approval <i style=color:darkgrey;>(remote)</i> <li> Merge develop branch into main branch <i style=color:darkgrey;>(remote)</i> </ol> <hr> <h5 id=overview-of-process-to-take-oscal-models-and-upgrade-trestle-python-code>Overview of process to take OSCAL models and upgrade trestle Python code<a class=headerlink href=#overview-of-process-to-take-oscal-models-and-upgrade-trestle-python-code title="Permanent link">¤</a></h5> <p><img alt src=images/trestle-OSCAL-upgrade.png></p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/contributing/maintainers/index.html b/latest/contributing/maintainers/index.html
new file mode 100644
index 000000000..9eba41dba
--- /dev/null
+++ b/latest/contributing/maintainers/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="The list of maintainers of compliance-trestle"><link href=https://oscal-compass.github.io/compliance-trestle/latest/contributing/maintainers/ rel=canonical><link href=../plugins/ rel=prev><link href=../DCO/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Maintainers - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Maintainers - Compliance Trestle"><meta property=og:description content="The list of maintainers of compliance-trestle"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/maintainers.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/contributing/maintainers/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Maintainers - Compliance Trestle"><meta name=twitter:description content="The list of maintainers of compliance-trestle"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/maintainers.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Maintainers </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6 checked> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=true> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>Maintainers</h1> <p>Trestle was designed and open sourced by a team based at <a href=https://www.research.ibm.com/ >IBM Research</a> and others around the world. The list includes:</p> <p>Alejandro Jose Leiva Palomo <a href=https://github.com/AleJo2995>AleJo2995</a></p> <p>Christopher Butler <a href=https://github.com/butler54>butler54</a></p> <p>Lou Degenaro <a href=https://github.com/degenaro>degenaro</a></p> <p>Jennifer Power <a href=https://github.com/jpower432>jpower432</a></p> <p>Manjiree Gadgil <a href=https://github.com/mrgadgil>mrgadgil</a></p> <p>Vikas Agarwal <a href=https://github.com/vikas-agarwal76>vikas-agarwal76</a></p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/contributing/oscal_object_model/index.html b/latest/contributing/oscal_object_model/index.html
new file mode 100644
index 000000000..d8acf3660
--- /dev/null
+++ b/latest/contributing/oscal_object_model/index.html
@@ -0,0 +1,5 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="How to use trestle as an object model for OSCAL"><link href=https://oscal-compass.github.io/compliance-trestle/latest/contributing/oscal_object_model/ rel=canonical><link href=../code_of_conduct/ rel=prev><link href=../website/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Trestle's oscal object model - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Trestle's oscal object model - Compliance Trestle"><meta property=og:description content="How to use trestle as an object model for OSCAL"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/oscal_object_model.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/contributing/oscal_object_model/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Trestle's oscal object model - Compliance Trestle"><meta name=twitter:description content="How to use trestle as an object model for OSCAL"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/oscal_object_model.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#using-trestle-as-an-object-model-for-oscal class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Trestle's oscal object model </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6 checked> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=true> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> OSCAL object model </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> OSCAL object model </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#mapping-and-variance-with-oscal-names class=md-nav__link> <span class=md-ellipsis> Mapping and variance with OSCAL names. </span> </a> <nav class=md-nav aria-label="Mapping and variance with OSCAL names."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#oscal-schema-mapping class=md-nav__link> <span class=md-ellipsis> OSCAL Schema mapping </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#mapping-and-variance-with-oscal-names class=md-nav__link> <span class=md-ellipsis> Mapping and variance with OSCAL names. </span> </a> <nav class=md-nav aria-label="Mapping and variance with OSCAL names."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#oscal-schema-mapping class=md-nav__link> <span class=md-ellipsis> OSCAL Schema mapping </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=using-trestle-as-an-object-model-for-oscal>Using trestle as an object model for OSCAL<a class=headerlink href=#using-trestle-as-an-object-model-for-oscal title="Permanent link">¤</a></h1> <p>Trestle provides an object model for OSCAL to ease the development and validation of OSCAL objects that reside in the <code>trestle.oscal</code> module. This functionality, which is built on <a href=https://pydantic-docs.helpmanual.io/ >pydantic</a> and <a href=https://docs.python.org/3/library/dataclasses.html>python data classes</a>, allows validation of the OSCAL schema and is leveraged to provide a variety of utility functions including:</p> <ul> <li>IO Support for yaml / json / python dict serialisation <a href=https://github.com/oscal-compass/compliance-trestle/blob/develop/trestle/core/base_model.py>see <code>OscalBaseModel</code> for trestle enhancements</a></li> <li>The ability to generate pro-forma objects using <a href=https://github.com/oscal-compass/compliance-trestle/blob/develop/trestle/core/generators.py><code>trestle.core.generate::generate_sample_model</code></a></li> <li>Integration into the flask api framework <a href=https://github.com/oscal-compass/compliance-trestle-demos/tree/develop/trestle_flask_api>(demo)</a></li> </ul> <h2 id=mapping-and-variance-with-oscal-names>Mapping and variance with OSCAL names.<a class=headerlink href=#mapping-and-variance-with-oscal-names title="Permanent link">¤</a></h2> <p>The underlying object model that trestle relies on is the json schema published by NIST <a href=https://github.com/usnistgov/OSCAL/releases/latest>here</a>. In understanding these models the <a href=https://pages.nist.gov/OSCAL-Reference/models/ >model reference page</a> is an indispensable source.</p> <p>When generating the python data class based models we have tried to be as faithful as we can to the naming convention provided by OSCAL. This is the hierarchy of rules that we have used:</p> <ol> <li>Do not include prepends from the json schema (e.g. <code>assembly_oscal-catalog_catalog</code> becomes the short name <code>catalog</code>), modules are used for scoping statements</li> <li>OSCAL modules use hyphen case (e.g. <code>system-security-plan</code>) and this is converted to CamelCase (e.g. <code>SystemSecurityPlan</code>)</li> <li>Name collisions with <a href=https://docs.python.org/3/reference/lexical_analysis.html#keywords>reserved words</a> in python are post-pended with an underscore (e.g. <code>class</code> becomes <code>class_</code>)</li> <li>If a model is used across multiple OSCAL schemas (e.g. <code>metadata</code>) it is put into the common module(<code>trestle.oscal.common</code>), otherwise it will be scoped to a model specifically for that schema.</li> <li>Any unresolved duplicates are resolved by adding an index e.g. <code>class State1</code></li> </ol> <h3 id=oscal-schema-mapping>OSCAL Schema mapping<a class=headerlink href=#oscal-schema-mapping title="Permanent link">¤</a></h3> <p>This maps between OSCAL values and the corresponding pydantic/python data class in trestle. For example, to get a catalog you would call:</p> <div class=highlight><pre><span></span><code><span class=kn>from</span> <span class=nn>pathlib</span> <span class=kn>import</span> <span class=n>Path</span>
+<span class=kn>from</span> <span class=nn>trestle.oscal.catalog</span> <span class=kn>import</span> <span class=n>Catalog</span>
+
+<span class=n>my_catalog</span> <span class=o>=</span> <span class=n>Catalog</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>Path</span><span class=p>(</span><span class=s1>&#39;path/to/file.json&#39;</span><span class=p>))</span>
+</code></pre></div> <table> <thead> <tr> <th>Oscal schema</th> <th>json schema name</th> <th>Trestle module</th> <th>Trestle class name</th> </tr> </thead> <tbody> <tr> <td>Catalog</td> <td><code>catalog</code></td> <td><code>catalog</code></td> <td><code>trestle.oscal.catalog</code></td> </tr> <tr> <td>Profile</td> <td><code>profile</code></td> <td><code>profile</code></td> <td><code>trestle.oscal.profile</code></td> </tr> <tr> <td>Component Definition</td> <td><code>component-definition</code></td> <td><code>trestle.oscal.component</code></td> <td><code>ComponentDefinition</code></td> </tr> <tr> <td>System Security Plan</td> <td><code>system-security-plan</code></td> <td><code>trestle.oscal.ssp</code></td> <td><code>SystemSecurityPlan</code></td> </tr> <tr> <td>Assessment Plan</td> <td><code>assessment-plan</code></td> <td><code>trestle.oscal.assessment_plan</code></td> <td><code>AssessmentPlan</code></td> </tr> <tr> <td>Assessment Results</td> <td><code>assessment-results</code></td> <td><code>trestle.oscal.assessment_results</code></td> <td><code>AssessmentResults</code></td> </tr> <tr> <td>Plan of action and milestones</td> <td><code>plan-of-action-and-milestones</code></td> <td><code>trestle.oscal.poam</code></td> <td><code>PlanOfActionAndMilestones</code></td> </tr> </tbody> </table> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">September 11, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/contributing/plugins/index.html b/latest/contributing/plugins/index.html
new file mode 100644
index 000000000..93b2f6fe8
--- /dev/null
+++ b/latest/contributing/plugins/index.html
@@ -0,0 +1,48 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Trestle provides a mechanism for 3rd party providers to extend its command interface via a plugin architecture. This describes to build a trestle plugin."><link href=https://oscal-compass.github.io/compliance-trestle/latest/contributing/plugins/ rel=canonical><link href=../website/ rel=prev><link href=../maintainers/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Developing trestle plugins - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Developing trestle plugins - Compliance Trestle"><meta property=og:description content="Trestle provides a mechanism for 3rd party providers to extend its command interface via a plugin architecture. This describes to build a trestle plugin."><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/plugins.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/contributing/plugins/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Developing trestle plugins - Compliance Trestle"><meta name=twitter:description content="Trestle provides a mechanism for 3rd party providers to extend its command interface via a plugin architecture. This describes to build a trestle plugin."><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/plugins.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#adding-plugins-to-trestle class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Developing trestle plugins </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6 checked> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=true> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Developing trestle plugins </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Developing trestle plugins </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#create-the-trestle-plugin-proejct class=md-nav__link> <span class=md-ellipsis> Create the trestle plugin proejct </span> </a> </li> <li class=md-nav__item> <a href=#project-organization class=md-nav__link> <span class=md-ellipsis> Project Organization </span> </a> </li> <li class=md-nav__item> <a href=#command-creation class=md-nav__link> <span class=md-ellipsis> Command Creation </span> </a> </li> <li class=md-nav__item> <a href=#jinja-extension-creation class=md-nav__link> <span class=md-ellipsis> Jinja Extension Creation </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#create-the-trestle-plugin-proejct class=md-nav__link> <span class=md-ellipsis> Create the trestle plugin proejct </span> </a> </li> <li class=md-nav__item> <a href=#project-organization class=md-nav__link> <span class=md-ellipsis> Project Organization </span> </a> </li> <li class=md-nav__item> <a href=#command-creation class=md-nav__link> <span class=md-ellipsis> Command Creation </span> </a> </li> <li class=md-nav__item> <a href=#jinja-extension-creation class=md-nav__link> <span class=md-ellipsis> Jinja Extension Creation </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=adding-plugins-to-trestle>Adding plugins to trestle<a class=headerlink href=#adding-plugins-to-trestle title="Permanent link">¤</a></h1> <p>Trestle provides a mechanism for 3rd party providers to extend its command interface via a plugin architecture. All trestle plugins that conforms to this specification will be automatically discovered by trestle if installed, and their command(s) will be added to trestle sub-commands list. Below we describe this plugin mechanism with the help of an example plugin <a href=https://github.com/oscal-compass/compliance-trestle-fedramp><code>compliance-trestle-fedramp</code></a> that we created as a separate python project that can be installed via <code>pip</code>.</p> <h2 id=create-the-trestle-plugin-proejct>Create the trestle plugin proejct<a class=headerlink href=#create-the-trestle-plugin-proejct title="Permanent link">¤</a></h2> <p>A separate plugin project needs to be created that will conatin the code for plugin and its commands. This plugin can be given any name and should be available for installation via <code>pip</code>. For example, we created a plugin project called <code>compliance-trestle-fedramp</code> which can be installed as <code>pip install compliance-trestle-fedramp</code>. The project name doesn't need to start with <code>compliance-trestle</code>.</p> <h2 id=project-organization>Project Organization<a class=headerlink href=#project-organization title="Permanent link">¤</a></h2> <p>The plugin project should be organized as shown below.</p> <div class=highlight><pre><span></span><code>compliance-trestle-fedramp
+├── trestle_fedramp
+│   ├── __init__.py
+│   ├── commands
+|   |   ├── __init__.py
+|   |   ├── validate.py
+|   ├── jinja_ext
+|   |   ├── __init__.py
+|   |   ├── filters.py
+│   ├── &lt;other source files or folder&gt;
+├── &lt;other files or folder&gt;
+</code></pre></div> <p>Trestle uses a naming convention to discover the top-level module of the plugin projects. It expects the top-level module to be named <code>trestle_{plugin_name}</code>. This covention must be followed by plugins to be discoverable by trestle. In the above example, the top-level module is named as <code>trestle_fedramp</code> so that it can be autmatically discovered by trestle. All the python source files should be created inside this module (folder).</p> <p>To add commands to the CLI interface, the top-level module should contain a <code>commands</code> directory where all the plugin command files should be stored. Each command should have its own python file. In the above example, <code>validate.py</code> file contains one command for this plugin. Other python files or folders should be created in the top-level module folder, outside the <code>commands</code> folder. This helps in keeping the commands separate and in their discovery by trestle.</p> <p>To add jinja extensions available during <code>trestle author jinja</code>, the top-level module should contain a <code>jinja_ext</code> directory where all extension files should be stored. Each extension should have its own python file. In the above example, <code>filters.py</code> file contains a single extension class, which may define many filters or custom tags. Supporting code should be created in the top-level module folder, outside the <code>jinja_ext</code> folder. This helps in keeping the extensions separate and in their discovery by trestle.</p> <h2 id=command-creation>Command Creation<a class=headerlink href=#command-creation title="Permanent link">¤</a></h2> <p>The plugin command should be created as shown in the below code snippet.</p> <div class=highlight><pre><span></span><code><span class=kn>from</span> <span class=nn>trestle.core.commands.command_docs</span> <span class=kn>import</span> <span class=n>CommandBase</span>
+<span class=kn>from</span> <span class=nn>trestle.core.commands.command_docs</span> <span class=kn>import</span> <span class=n>CommandPlusDocs</span>
+
+<span class=k>class</span> <span class=nc>ValidateCmd</span><span class=p>(</span><span class=n>CommandBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validate contents of an OSCAL model based on FedRAMP specifications.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;fedramp-validate&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Init arguments&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-f&#39;</span><span class=p>,</span> <span class=s1>&#39;--file&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;OSCAL file to validate.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output-dir&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Output directory for validation results.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=n>model_file</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>file</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+
+        <span class=n>output_dir</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>output_dir</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+        <span class=o>...</span>
+        <span class=o>...</span>
+        <span class=k>return</span> <span class=mi>0</span> <span class=k>if</span> <span class=n>valid</span> <span class=k>else</span> <span class=mi>1</span>
+</code></pre></div> <p>There should be a command class for example, <code>ValidateCmd</code> which should either extend from <code>CommandBase</code> or <code>CommandPlusDocs</code>. Trestle uses <code>ilcli</code> package to create commands. <code>CommandBase</code> extends from <code>ilcli.Command</code> that initializes the command including help messages and input parameters. <code>CommandPlusDocs</code> in turn extends from <code>CommandBase</code>. The difference between <code>CommandBase</code> and <code>CommandPLusDocs</code> is that <code>CommandBase</code> does not require command line parameter <code>trestle-root</code> to be set or the current directory to be a valid trestle root, whereas <code>CommandPlusDocs</code> requires a valid <code>trestle-root</code> and checks for it. Hence, depending upon the requirement of the plugin command it can extend from either of these classes.</p> <p>The docstring of the command class is used as the help message for the command. Input arguments to the command should be specified in <code>_init_arguments</code> method as shown above. The acutal code of the command is contained in<code>_run</code> method. This method is called by ilcli when the command is excuted on the commandline. The command arguments can be accessed from the <code>args</code> input parameter as shown above. The command should return <code>0</code> in case of successful execution, or any number greater than 0 in case of failure. Please see <code>trestle.core.commands.common.return_codes.CmdReturnCodes</code> class for specific return codes in case of failure.</p> <p>The command class should conatin the <code>name</code> field which should be set to the desired command name. In the above example, the command is called <code>fedramp-validate</code>. This name is automatically added to the list of sub-command names of trestle during the plugin discovery process. This command can then be invoked as <code>trestle {name}</code> from the commandline e.g., <code>trestle fedramp-validate</code>. Any input parameters to the command can also be passed on the commandline after the command name.</p> <h2 id=jinja-extension-creation>Jinja Extension Creation<a class=headerlink href=#jinja-extension-creation title="Permanent link">¤</a></h2> <p>The plugin extension should be created as shown in the below code snippet.</p> <div class=highlight><pre><span></span><code><span class=kn>from</span> <span class=nn>jinja2</span> <span class=kn>import</span> <span class=n>Environment</span>
+<span class=kn>from</span> <span class=nn>trestle.core.jinja.base</span> <span class=kn>import</span> <span class=n>TrestleJinjaExtension</span>
+
+<span class=k>def</span> <span class=nf>_mark_tktk</span><span class=p>(</span><span class=n>value</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Mark a value with TKTK to easily find it for future revision.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;TKTK </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1> TKTK&#39;</span>
+
+
+<span class=k>class</span> <span class=nc>Filters</span><span class=p>(</span><span class=n>TrestleJinjaExtension</span><span class=p>):</span>
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=nb>super</span><span class=p>(</span><span class=n>Filters</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+
+        <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;tktk&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>_mark_tktk</span>
+</code></pre></div> <p>There should be an extension class, for example <code>Filters</code> that must extend from <code>TrestleJinjaExtension</code> or <code>jinja2.ext.Extention</code>. The <code>__init__</code> method must call init for its superclass. Beyond that, any behavior for standard <a href=https://jinja.palletsprojects.com/en/3.1.x/extensions/#module-jinja2.ext>jinja2 custom extensions</a> is supported.</p> <p>Examples for implementing extensions can be found at <code>trestle/core/jinja/tags.py</code> and <code>trestle/core/jinja/filters.py</code></p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/contributing/website/index.html b/latest/contributing/website/index.html
new file mode 100644
index 000000000..86e117dbd
--- /dev/null
+++ b/latest/contributing/website/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Describes how to contribute to and build the documentation website for compliance trestle"><link href=https://oscal-compass.github.io/compliance-trestle/latest/contributing/website/ rel=canonical><link href=../oscal_object_model/ rel=prev><link href=../plugins/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Documentation website - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Documentation website - Compliance Trestle"><meta property=og:description content="Describes how to contribute to and build the documentation website for compliance trestle"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/website.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/contributing/website/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Documentation website - Compliance Trestle"><meta name=twitter:description content="Describes how to contribute to and build the documentation website for compliance trestle"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/contributing/website.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#developing-for-the-trestle-documentation-website class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Documentation website </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6 checked> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=true> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Website development </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Website development </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#documentation-for-use-within-the-github-project class=md-nav__link> <span class=md-ellipsis> Documentation for use within the github project. </span> </a> </li> <li class=md-nav__item> <a href=#build-system-and-local-testing-of-the-website class=md-nav__link> <span class=md-ellipsis> Build system and local testing of the website. </span> </a> <nav class=md-nav aria-label="Build system and local testing of the website."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle-custom-automation class=md-nav__link> <span class=md-ellipsis> trestle custom automation. </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#building-the-models-from-the-oscal-schemas class=md-nav__link> <span class=md-ellipsis> Building the models from the OSCAL schemas. </span> </a> <nav class=md-nav aria-label="Building the models from the OSCAL schemas."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#items-handled-by-fix_anypy class=md-nav__link> <span class=md-ellipsis> Items handled by fix_any.py. </span> </a> </li> <li class=md-nav__item> <a href=#seeing-the-changes-induced-by-fix_anypy-on-the-classes class=md-nav__link> <span class=md-ellipsis> Seeing the changes induced by fix_any.py on the classes. </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#documentation-for-use-within-the-github-project class=md-nav__link> <span class=md-ellipsis> Documentation for use within the github project. </span> </a> </li> <li class=md-nav__item> <a href=#build-system-and-local-testing-of-the-website class=md-nav__link> <span class=md-ellipsis> Build system and local testing of the website. </span> </a> <nav class=md-nav aria-label="Build system and local testing of the website."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle-custom-automation class=md-nav__link> <span class=md-ellipsis> trestle custom automation. </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#building-the-models-from-the-oscal-schemas class=md-nav__link> <span class=md-ellipsis> Building the models from the OSCAL schemas. </span> </a> <nav class=md-nav aria-label="Building the models from the OSCAL schemas."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#items-handled-by-fix_anypy class=md-nav__link> <span class=md-ellipsis> Items handled by fix_any.py. </span> </a> </li> <li class=md-nav__item> <a href=#seeing-the-changes-induced-by-fix_anypy-on-the-classes class=md-nav__link> <span class=md-ellipsis> Seeing the changes induced by fix_any.py on the classes. </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=developing-for-the-trestle-documentation-website>Developing for the trestle documentation website<a class=headerlink href=#developing-for-the-trestle-documentation-website title="Permanent link">¤</a></h1> <p>This page describes the developing for the trestle (website) which is deployed at <a href=https://oscal-compass.github.io/compliance-trestle>https://oscal-compass.github.io/compliance-trestle</a>.</p> <h2 id=documentation-for-use-within-the-github-project>Documentation for use within the github project.<a class=headerlink href=#documentation-for-use-within-the-github-project title="Permanent link">¤</a></h2> <p>Github uses certain files within a project such as <code>/README.md</code>, <code>/CONTRIBUTING.md</code>, <code>LICENSE</code> which are specifically indexed by github. The current documentation website build reuses some of these files, specifically:</p> <ul> <li>Contents of <code>README.md</code></li> <li>Entirety of <code>LICENSE</code></li> <li>Entirety of <code>CONTRIBUTING.md</code></li> <li>Entirety of <code>CHANGELOG.md</code></li> <li>Entirely of <code>MAINTAINERS.md</code></li> <li>Entirely of <code>DCO1.1.txt</code></li> </ul> <p>For this to work correctly no relative links within the github repository should exist. All links should be absolute to the documentation website.</p> <h2 id=build-system-and-local-testing-of-the-website>Build system and local testing of the website.<a class=headerlink href=#build-system-and-local-testing-of-the-website title="Permanent link">¤</a></h2> <p>Trestle has adopted the <code>mkdocs</code> system to generate this website using a small number of extensions to mkdocs. The website can be viewed locally from a clone of the <code>compliance-trestle</code> repo by running <code>make docs-serve</code> in the root directory bringing the website up at <code>https://localhost:8000</code>. If you experience issues run <code>make develop</code> to ensure the appropriate markdown extensions are in your python environment.</p> <p><code>make docs-serve</code> performs two actions:</p> <ul> <li>Runs the custom automation script <code>scripts/website_automation.py</code></li> <li>Serves the website on localhost.</li> </ul> <p>All documentation specific assets are stored within the <code>./docs</code> folder. The exception being <code>mkdocs.yml</code> which configures the documentation tree. Before opening a PR users should ensure:</p> <ul> <li>No warnings are generated by mkdocs</li> <li>All markdown documents within <code>./docs</code> are included in the website navigation defined in <code>mkdocs.yml</code></li> </ul> <h3 id=trestle-custom-automation><code>trestle</code> custom automation.<a class=headerlink href=#trestle-custom-automation title="Permanent link">¤</a></h3> <p>In order to streamline development, and ensure the website remains up to date, a small automation script has been built. This automation script principally ensures that:</p> <ul> <li>License is consistent with github.com</li> <li>All modules are in the reference documentation</li> </ul> <p>running <code>make docs-automation</code> will ensure that the website is ready to deploy.</p> <h2 id=building-the-models-from-the-oscal-schemas>Building the models from the OSCAL schemas.<a class=headerlink href=#building-the-models-from-the-oscal-schemas title="Permanent link">¤</a></h2> <p>The creation of the OSCAL models in <code>trestle/oscal</code> is a multi-step process:</p> <ul> <li>The oscal schemas are downloaded as modules from NIST into the <code>nist-source/json/schema</code> directory.</li> <li>The script <code>scripts/gen-oscal.py</code> loads each schema file and converts it to pydantic/python with <code>datamodel-codegen</code>.</li> <li>The generated python files may need some fixup, so a separate script <code>scripts/fix_any.py</code> is run on each file.</li> <li>Note that there is one schema specific to IBM needs and it is loaded from <code>3rd-party-schema-documents/IBM_target_schema_v1.0.0.json</code>.</li> </ul> <p>The whole process is handled in the Makefile by <code>make code-gen</code>. A normal user would never need to run this but developers may need to, particularly if there are changes to the OSCAL schemas.</p> <p>Also note that the depenedent tools, pydantic and datamodel-codegen, may get updated by doing a fresh <code>make install</code> or <code>make develop</code>, which may then result in a change to the model files.</p> <h3 id=items-handled-by-fix_anypy>Items handled by <code>fix_any.py</code>.<a class=headerlink href=#items-handled-by-fix_anypy title="Permanent link">¤</a></h3> <p>The original motivation for this script was to replace numerous situations where the type assigned to a given variable was simply <code>Any</code>, which meant no type enforcement would apply for that variable, defeating the purpose of the strict type enforcement provided by Pydantic. As of this writing the number of such cases has been reduced to just one - which is handled by the script.</p> <p>Other issues handled by the script are:</p> <ul> <li>The current OSCAL schemas have situations where objects are defined within different classes in a schema using the same name, but the contents of those classes may or may not be different. <code>datamodel-codegen</code> handles this by creating separate classes as needed and appending 1, 2 etc. to the names, keeping them distinct. The resulting high level classes that reference them behave as expected, but if components of those classes are added in a granular way by a user or developer, the correct index must be used.</li> <li>To reduce side-effects of the duplicate classes, classes are checked to see if they are identical or not. If they are identical the separate 1, 2 classes are culled and references to them are pointed to the non-indexed class.</li> <li>Currently there are 5 classes that require a separate '1' version: <code>Status, Type, Entry, LocalDefinitions, and Action</code>.</li> <li>In order to guarantee there are no induced forward references in the files, the classes are reordered to minimize the need for forwards, and any that can't be avoided are explicitly provided at the bottom of the file.</li> <li>The generated files have many classes that simply have a <code>__root__</code> element defined, along with a description. Such classes don't have particular value in such a simple form and could instead simply be defined in the parent class.</li> </ul> <h3 id=seeing-the-changes-induced-by-fix_anypy-on-the-classes>Seeing the changes induced by <code>fix_any.py</code> on the classes.<a class=headerlink href=#seeing-the-changes-induced-by-fix_anypy-on-the-classes title="Permanent link">¤</a></h3> <p>As a convenience for developers, a separate script, <code>scripts/order_classes.py</code> is available, which orders the classes in a given file alphabetically. This way, if you use the script on files before and after applying <code>fix_any.py</code> you can use a normal diff tool to see the changes made. This is strictly as a development tool for doing the comparison and the resulting files will not work since they will have forward references.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/css/mkdocstrings.min.css b/latest/css/mkdocstrings.min.css
new file mode 100644
index 000000000..c72bb8f3b
--- /dev/null
+++ b/latest/css/mkdocstrings.min.css
@@ -0,0 +1 @@
+div.doc-contents:not(.first){padding-left:25px;border-left:4px solid rgba(230,230,230);margin-bottom:80px}h5.doc-heading{text-transform:none !important}.hidden-toc::before{margin-top:0 !important;padding-top:0 !important}.hidden-toc a.headerlink{display:none}td code{word-break:normal !important}td p{margin-top:0 !important;margin-bottom:0 !important}
\ No newline at end of file
diff --git a/latest/demos/index.html b/latest/demos/index.html
new file mode 100644
index 000000000..e58bdd2ec
--- /dev/null
+++ b/latest/demos/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="List of different demonstrations of compliance trestle"><link href=https://oscal-compass.github.io/compliance-trestle/latest/demos/ rel=canonical><link rel=prev href=..><link href=../installation/ rel=next><link rel=icon href=../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Demos - Compliance Trestle</title><link rel=stylesheet href=../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../assets/_mkdocstrings.css><script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Demos - Compliance Trestle"><meta property=og:description content="List of different demonstrations of compliance trestle"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/demos.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/demos/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Demos - Compliance Trestle"><meta name=twitter:description content="List of different demonstrations of compliance trestle"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/demos.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle-demonstration-projects-and-content class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Demos </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=.. class=md-tabs__link> Overview </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Demos </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Demos </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#current-demonstrations class=md-nav__link> <span class=md-ellipsis> Current demonstrations </span> </a> </li> <li class=md-nav__item> <a href=#simple-sdk-examples class=md-nav__link> <span class=md-ellipsis> Simple sdk examples. </span> </a> </li> <li class=md-nav__item> <a href=#arc42-architectural-template-enforcement-using-trestle-author class=md-nav__link> <span class=md-ellipsis> arc42 architectural template enforcement using trestle author. </span> </a> </li> <li class=md-nav__item> <a href=#trestle-flask-microservice-demonstration class=md-nav__link> <span class=md-ellipsis> Trestle flask microservice demonstration. </span> </a> </li> <li class=md-nav__item> <a href=#creating-a-cis-controls-catalog-from-an-excel-spreadsheet class=md-nav__link> <span class=md-ellipsis> Creating a CIS controls catalog from an excel spreadsheet. </span> </a> </li> <li class=md-nav__item> <a href=#creating-an-ssp-using-trestle-author class=md-nav__link> <span class=md-ellipsis> Creating an SSP using trestle author. </span> </a> </li> <li class=md-nav__item> <a href=#trestle-repository-api-trestlecorerepository class=md-nav__link> <span class=md-ellipsis> Trestle Repository API (trestle.core.repository) </span> </a> </li> <li class=md-nav__item> <a href=#task-examples class=md-nav__link> <span class=md-ellipsis> Task examples </span> </a> <nav class=md-nav aria-label="Task examples"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#convert-a-spreadsheet-into-a-component-definition class=md-nav__link> <span class=md-ellipsis> Convert a spreadsheet into a component-definition </span> </a> </li> <li class=md-nav__item> <a href=#convert-a-xccdf-result-into-a-partial-assessment-results class=md-nav__link> <span class=md-ellipsis> Convert a xccdf result into a partial assessment-results </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#current-demonstrations class=md-nav__link> <span class=md-ellipsis> Current demonstrations </span> </a> </li> <li class=md-nav__item> <a href=#simple-sdk-examples class=md-nav__link> <span class=md-ellipsis> Simple sdk examples. </span> </a> </li> <li class=md-nav__item> <a href=#arc42-architectural-template-enforcement-using-trestle-author class=md-nav__link> <span class=md-ellipsis> arc42 architectural template enforcement using trestle author. </span> </a> </li> <li class=md-nav__item> <a href=#trestle-flask-microservice-demonstration class=md-nav__link> <span class=md-ellipsis> Trestle flask microservice demonstration. </span> </a> </li> <li class=md-nav__item> <a href=#creating-a-cis-controls-catalog-from-an-excel-spreadsheet class=md-nav__link> <span class=md-ellipsis> Creating a CIS controls catalog from an excel spreadsheet. </span> </a> </li> <li class=md-nav__item> <a href=#creating-an-ssp-using-trestle-author class=md-nav__link> <span class=md-ellipsis> Creating an SSP using trestle author. </span> </a> </li> <li class=md-nav__item> <a href=#trestle-repository-api-trestlecorerepository class=md-nav__link> <span class=md-ellipsis> Trestle Repository API (trestle.core.repository) </span> </a> </li> <li class=md-nav__item> <a href=#task-examples class=md-nav__link> <span class=md-ellipsis> Task examples </span> </a> <nav class=md-nav aria-label="Task examples"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#convert-a-spreadsheet-into-a-component-definition class=md-nav__link> <span class=md-ellipsis> Convert a spreadsheet into a component-definition </span> </a> </li> <li class=md-nav__item> <a href=#convert-a-xccdf-result-into-a-partial-assessment-results class=md-nav__link> <span class=md-ellipsis> Convert a xccdf result into a partial assessment-results </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=trestle-demonstration-projects-and-content>Trestle demonstration projects and content<a class=headerlink href=#trestle-demonstration-projects-and-content title="Permanent link">¤</a></h1> <p>Trestle has a number of demonstrations setup in the <a href=https://github.com/oscal-compass/compliance-trestle-demos>oscal-compass/compliance-trestle-demos</a> repository which is intended to be a single point of call for demonstrations and content.</p> <p>If you are interested in contributing a demonstration / content open a PR to the demonstration repo and a PR to <a href=https://github.com/oscal-compass/compliance-trestle/blob/develop/docs/demos.md>this page</a>.</p> <p>Demonstrations, where practical, should include instructions on how they were created.</p> <h2 id=current-demonstrations>Current demonstrations<a class=headerlink href=#current-demonstrations title="Permanent link">¤</a></h2> <h2 id=simple-sdk-examples>Simple sdk examples.<a class=headerlink href=#simple-sdk-examples title="Permanent link">¤</a></h2> <p><a href=https://github.com/oscal-compass/compliance-trestle-demos/tree/develop/trestle_sdk_examples>This folder</a> contains a number of small examples for using the trestle OSCAL sdks.</p> <h2 id=arc42-architectural-template-enforcement-using-trestle-author>arc42 architectural template enforcement using trestle author.<a class=headerlink href=#arc42-architectural-template-enforcement-using-trestle-author title="Permanent link">¤</a></h2> <p><a href=https://arc42.org/ >arc42</a> have created a set of open-source architecture documentation templates. This <a href=https://github.com/IBM/compliance-trestle-arc42-demo/tree/f1ed64cd65af3167a3b129585d758bf8a21a4a6c>demonstration</a> uses <code>trestle author</code> to enforce use of the (modified) arc42 templates.</p> <h2 id=trestle-flask-microservice-demonstration>Trestle flask microservice demonstration.<a class=headerlink href=#trestle-flask-microservice-demonstration title="Permanent link">¤</a></h2> <p><code>trestle</code> uses a python library called <a href=https://pydantic-docs.helpmanual.io/ >pydantic</a> to form the underlying OSCAL object models. <a href=https://github.com/bauerji/flask_pydantic>flask-pydantic</a> introduces a mechanism which integrates pydantic models into flask, providing automated user input validation in one line of code. This demo accepts a catalog as a POSTed object, throwing errors if the catalog does not meet the schema, and returns the catalog in the response. Find the demonstration <a href=https://github.com/oscal-compass/compliance-trestle-demos/tree/develop/trestle_flask_api>here</a>.</p> <h2 id=creating-a-cis-controls-catalog-from-an-excel-spreadsheet>Creating a CIS controls catalog from an excel spreadsheet.<a class=headerlink href=#creating-a-cis-controls-catalog-from-an-excel-spreadsheet title="Permanent link">¤</a></h2> <p>The Centre for Internet Security (CIS) produce a number of cross industry standards for IT security including their <a href=https://www.cisecurity.org/cis-benchmarks/ >platform specific benchmarks</a> and a suite of <a href=https://www.cisecurity.org/controls/ >controls</a>. <a href=https://github.com/oscal-compass/compliance-trestle-demos/tree/develop/CIS_controls>This demo</a> converts a spreadsheet of those controls into a a catalog and three profiles.</p> <h2 id=creating-an-ssp-using-trestle-author>Creating an SSP using trestle author.<a class=headerlink href=#creating-an-ssp-using-trestle-author title="Permanent link">¤</a></h2> <p><code>trestle author ssp-generate</code> and <code>trestle author ssp-assemble</code> allow users to generate first a set of markdown documents to allow easy editing of control responses and second to reassemble that information up into an OSCAL ssp document. <a href=https://github.com/oscal-compass/compliance-trestle-demos/tree/develop/ssp_author_demo>This is a 'baseline' demonstration</a> with more sophisticated updates expected in the near term.</p> <h2 id=trestle-repository-api-trestlecorerepository>Trestle Repository API (<code>trestle.core.repository</code>)<a class=headerlink href=#trestle-repository-api-trestlecorerepository title="Permanent link">¤</a></h2> <p><code>trestle.core.repository</code> is an API which abstracts users from the file system of a trestle repository. It provides a way for external developers to access a trestle repository without relying on presumptions (such as cwd being within the repository). Find the demo <a href=https://github.com/oscal-compass/compliance-trestle-demos/tree/develop/trestle_repo_api_examples>here</a>.</p> <h2 id=task-examples>Task examples<a class=headerlink href=#task-examples title="Permanent link">¤</a></h2> <h3 id=convert-a-spreadsheet-into-a-component-definition>Convert a spreadsheet into a <code>component-definition</code><a class=headerlink href=#convert-a-spreadsheet-into-a-component-definition title="Permanent link">¤</a></h3> <p>This <a href=https://github.com/oscal-compass/compliance-trestle-demos/tree/develop/trestle_task_spread_sheet_to_component_definition>demonstration</a> shows how to use the <code>trestle task xlsx-to-oscal-cd</code> functionality.</p> <h3 id=convert-a-xccdf-result-into-a-partial-assessment-results>Convert a <code>xccdf</code> result into a partial <code>assessment-results</code><a class=headerlink href=#convert-a-xccdf-result-into-a-partial-assessment-results title="Permanent link">¤</a></h3> <p>This <a href=https://github.com/oscal-compass/compliance-trestle-demos/tree/develop/trestle_task_xccdf_result_to_oscal_ar>demonstration</a> shows how to use the <code>trestle task xccdf_result_to_oscal_ar</code> functionality.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/index.html b/latest/index.html
new file mode 100644
index 000000000..1fcce469f
--- /dev/null
+++ b/latest/index.html
@@ -0,0 +1,14 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Trestle is an ensemble of tools that enable the creation, validation, and governance of documentation artifacts for compliance needs"><link href=https://oscal-compass.github.io/compliance-trestle/latest/ rel=canonical><link href=demos/ rel=next><link rel=icon href=assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Overview - Compliance Trestle</title><link rel=stylesheet href=assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=assets/_mkdocstrings.css><script>__md_scope=new URL(".",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Compliance Trestle"><meta property=og:description content="Trestle is an ensemble of tools that enable the creation, validation, and governance of documentation artifacts for compliance needs"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/index.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Compliance Trestle"><meta name=twitter:description content="Trestle is an ensemble of tools that enable the creation, validation, and governance of documentation artifacts for compliance needs"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/index.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#compliance-trestle-also-known-as-trestle class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Overview </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class="md-tabs__item md-tabs__item--active"> <a href=. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Overview </span> <span class="md-nav__icon md-icon"></span> </label> <a href=. class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Overview </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#important-note class=md-nav__link> <span class=md-ellipsis> Important Note: </span> </a> </li> <li class=md-nav__item> <a href=#why-trestle class=md-nav__link> <span class=md-ellipsis> Why Trestle </span> </a> </li> <li class=md-nav__item> <a href=#machine-readable-compliance-format class=md-nav__link> <span class=md-ellipsis> Machine readable compliance format </span> </a> </li> <li class=md-nav__item> <a href=#supported-oscal-elements-and-extensions class=md-nav__link> <span class=md-ellipsis> Supported OSCAL elements and extensions </span> </a> </li> <li class=md-nav__item> <a href=#supported-file-formats-for-oscal-objects class=md-nav__link> <span class=md-ellipsis> Supported file formats for OSCAL objects. </span> </a> </li> <li class=md-nav__item> <a href=#python-codebase-easy-installation-via-pip class=md-nav__link> <span class=md-ellipsis> Python codebase, easy installation via pip </span> </a> </li> <li class=md-nav__item> <a href=#development-status class=md-nav__link> <span class=md-ellipsis> Development status </span> </a> </li> <li class=md-nav__item> <a href=#contributing-to-trestle class=md-nav__link> <span class=md-ellipsis> Contributing to Trestle </span> </a> </li> <li class=md-nav__item> <a href=#license-authors class=md-nav__link> <span class=md-ellipsis> License &amp; Authors </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#important-note class=md-nav__link> <span class=md-ellipsis> Important Note: </span> </a> </li> <li class=md-nav__item> <a href=#why-trestle class=md-nav__link> <span class=md-ellipsis> Why Trestle </span> </a> </li> <li class=md-nav__item> <a href=#machine-readable-compliance-format class=md-nav__link> <span class=md-ellipsis> Machine readable compliance format </span> </a> </li> <li class=md-nav__item> <a href=#supported-oscal-elements-and-extensions class=md-nav__link> <span class=md-ellipsis> Supported OSCAL elements and extensions </span> </a> </li> <li class=md-nav__item> <a href=#supported-file-formats-for-oscal-objects class=md-nav__link> <span class=md-ellipsis> Supported file formats for OSCAL objects. </span> </a> </li> <li class=md-nav__item> <a href=#python-codebase-easy-installation-via-pip class=md-nav__link> <span class=md-ellipsis> Python codebase, easy installation via pip </span> </a> </li> <li class=md-nav__item> <a href=#development-status class=md-nav__link> <span class=md-ellipsis> Development status </span> </a> </li> <li class=md-nav__item> <a href=#contributing-to-trestle class=md-nav__link> <span class=md-ellipsis> Contributing to Trestle </span> </a> </li> <li class=md-nav__item> <a href=#license-authors class=md-nav__link> <span class=md-ellipsis> License &amp; Authors </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=compliance-trestle-also-known-as-trestle>Compliance-trestle (also known as <code>trestle</code>)<a class=headerlink href=#compliance-trestle-also-known-as-trestle title="Permanent link">¤</a></h1> <p><img alt="OS Compatibility" src=https://img.shields.io/badge/platform-osx%20%7C%20linux%20%7C%20windows-orange.svg> <img alt="PyPI - Python Version" src=https://img.shields.io/pypi/pyversions/compliance-trestle> <img alt=Pre-commit src="https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white"> <img alt="Code Coverage" src="https://sonarcloud.io/api/project_badges/measure?project=compliance-trestle&metric=coverage"> <img alt="Quality gate" src="https://sonarcloud.io/api/project_badges/measure?project=compliance-trestle&metric=alert_status"> <img alt=Pypi src=https://img.shields.io/pypi/dm/compliance-trestle> <img alt="GitHub Actions status" src="https://github.com/oscal-compass/compliance-trestle/actions/workflows/python-test.yml/badge.svg?branch=develop"> <img alt="OpenSSF Best Practices" src=https://www.bestpractices.dev/projects/9408/badge></p> <p>Trestle is an ensemble of tools that enable the creation, validation, and governance of documentation artifacts for compliance needs. It leverages NIST's <a href=https://pages.nist.gov/OSCAL/documentation/ >OSCAL</a> as a standard data format for interchange between tools and people, and provides an opinionated approach to OSCAL adoption.</p> <p>Trestle is designed to operate as a CICD pipeline running on top of compliance artifacts in <code>git</code>, to provide transparency for the state of compliance across multiple stakeholders in an environment friendly to developers. Trestle passes the generated artifacts on to tools that orchestrate the enforcement, measurement, and reporting of compliance.</p> <p>It also provides tooling to manage OSCAL documents in a more human-friendly manner. By splitting large OSCAL data structures into smaller and easier to edit sub-structures, creation and maintenance of these artifacts can follow normal <code>git</code> workflows including peer review via pull request, versioning, releases/tagging.</p> <p>Trestle provides three separate but related functions in the compliance space:</p> <ul> <li>Manage OSCAL documents to allow editing and manipulation while making sure the schemas are enforced</li> <li>Transform documents from other formats to OSCAL</li> <li>Provide support and governance to author compliance content as markdown and drawio.</li> </ul> <p>Trestle provides tooling to help orchestrate the compliance process across a number of dimensions:</p> <ul> <li>Help manage OSCAL documents in a more human-friendly manner by expanding the large OSCAL data structures into smaller and easier to edit sub-structures while making sure the schemas are enforced.</li> <li>Transform documents from other formats to OSCAL</li> <li>Provide governance for markdown documents and enforce consistency of format and content based on specified templates</li> <li>Tooling manage authoring and governance of markdown and drawio files withn a repository.</li> <li>Support within trestle to streamline management within a managed git environment.</li> <li>An underlying object model that supports developers interacting with OSCAL artefacts.</li> </ul> <h2 id=important-note>Important Note:<a class=headerlink href=#important-note title="Permanent link">¤</a></h2> <p>The current version of trestle supports NIST OSCAL 1.0.0-4. There was a breaking change in OSCAL moving from version 1.0.0 to 1.0.2 mainly due to <code>prop</code> becoming <code>props</code> in AssessmentResults. As a result, the current development path of trestle requires OSCAL 1.0.4, but for those who require OSCAL 1.0.0 please use trestle version 0.37.x. That version is stable but will not have any features added, and we encourage users to move to OSCAL 1.0.4.</p> <p>OSCAL version 1.0.0 files are still handled on import but any AssessmentResults must conform to the OSCAL 1.0.4 schema, with props instead of prop. And all files created by trestle will be output as OSCAL version 1.0.4.</p> <h2 id=why-trestle>Why Trestle<a class=headerlink href=#why-trestle title="Permanent link">¤</a></h2> <p>Compliance suffers from being a complex topic that is hard to articulate simply. It involves complete and accurate execution of multiple procedures across many disciplines (e.g. IT, HR, management) with periodic verification and audit of those procedures against controls.</p> <p>While it is possible to manage the description of controls and how an organisation implements them in ad hoc ways with general tools (spreadsheets, documents), this is hard to maintain for multiple accreditations and, in the IT domain at least, creates a barrier between the compliance efforts and the people doing daily work (DevOps staff).</p> <p>Trestle aims to reduce or remove this barrier by bringing the maintenance of control descriptions into the DevOps domain. The goal is to have changes to the system (for example, updates to configuration management) easily related to the controls impacted, and to enable modification of those controls as required in concert with the system changes.</p> <p>Trestle implicitly provides a core opinionated workflow driven by its pipeline to allow standardized interlocks with other compliance tooling platforms.</p> <h2 id=machine-readable-compliance-format>Machine readable compliance format<a class=headerlink href=#machine-readable-compliance-format title="Permanent link">¤</a></h2> <p>Compliance activities at scale, whether size of estate or number of accreditations, require automation to be successful and repeatable. OSCAL as a standard allows teams to bridge between the "Governance" layer and operational tools.</p> <p>By building human managed artifacts into OSCAL, Trestle is not only able to validate the integrity of the artifacts that people generate - it also enables reuse and sharing of artifacts, and furthermore can provide suitable input into tools that automate operational compliance.</p> <h2 id=supported-oscal-elements-and-extensions>Supported OSCAL elements and extensions<a class=headerlink href=#supported-oscal-elements-and-extensions title="Permanent link">¤</a></h2> <p><code>trestle</code> implicitly supports all OSCAL schemas for use within the object model. The development roadmap for <code>trestle</code> includes adding workflow around specific elements / objects that is opinionated.</p> <h2 id=supported-file-formats-for-oscal-objects>Supported file formats for OSCAL objects.<a class=headerlink href=#supported-file-formats-for-oscal-objects title="Permanent link">¤</a></h2> <p>OSCAL supports <code>xml</code>, <code>json</code> and <code>yaml</code> with their <a href=https://github.com/usnistgov/metaschema>metaschema</a> tooling. Trestle natively supports only <code>json</code> and <code>yaml</code> formats at this time.</p> <p>Future roadmap anticipates that support for xml <a href=https://github.com/oscal-compass/compliance-trestle/issues/177>import</a> and <a href=https://github.com/oscal-compass/compliance-trestle/issues/178>upstream references</a> will be enabled. However, it is expected that full support will remain only for <code>json</code> and <code>yaml</code>.</p> <p>Users needing to import XML OSCAL artifacts are recommended to look at NIST's OSCAL converters page <a href=https://github.com/usnistgov/OSCAL/blob/main/build/README.md#converters>here</a>.</p> <h2 id=python-codebase-easy-installation-via-pip>Python codebase, easy installation via pip<a class=headerlink href=#python-codebase-easy-installation-via-pip title="Permanent link">¤</a></h2> <p>Trestle runs on most all python platforms (e.g. Linux, Mac, Windows) and is available on PyPi so it is easily installed via pip. It is under active development and new releases are made available regularly.</p> <h2 id=development-status>Development status<a class=headerlink href=#development-status title="Permanent link">¤</a></h2> <p>Compliance trestle is currently stable and is based on NIST OSCAL version 1.0.4, with active development continuing.</p> <h2 id=contributing-to-trestle>Contributing to Trestle<a class=headerlink href=#contributing-to-trestle title="Permanent link">¤</a></h2> <p>Our project welcomes external contributions. Please consult <a href=contributing/ >contributing</a> to get started.</p> <h2 id=license-authors>License &amp; Authors<a class=headerlink href=#license-authors title="Permanent link">¤</a></h2> <p>If you would like to see the detailed LICENSE click <a href=license/ >here</a>. Consult <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors>contributors</a> for a list of authors and <a href=contributing/maintainers/ >maintainers</a> for the core team.</p> <div class=highlight><pre><span></span><code># Copyright (c) 2024 The OSCAL Compass Authors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an &quot;AS IS&quot; BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+</code></pre></div> <hr> <p>We are a Cloud Native Computing Foundation sandbox project.</p> <p><picture> <source media="(prefers-color-scheme: dark)" srcset=https://www.cncf.io/wp-content/uploads/2022/07/cncf-white-logo.svg> <img src=https://www.cncf.io/wp-content/uploads/2022/07/cncf-color-bg.svg width=300> </picture></p> <p>The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see <a href=https://www.linuxfoundation.org/legal/trademark-usage>Trademark Usage</a>".</p> <p><em>Trestle was originally created by IBM.</em></p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">November 26, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": ".", "features": ["content.code.annotate", "navigation.tabs"], "search": "assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/installation/index.html b/latest/installation/index.html
new file mode 100644
index 000000000..6ba698eca
--- /dev/null
+++ b/latest/installation/index.html
@@ -0,0 +1,47 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Instructions for installing compliance trestle with a python venv"><link href=https://oscal-compass.github.io/compliance-trestle/latest/installation/ rel=canonical><link href=../demos/ rel=prev><link href=../known_limitations/ rel=next><link rel=icon href=../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Installation - Compliance Trestle</title><link rel=stylesheet href=../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../assets/_mkdocstrings.css><script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Installation - Compliance Trestle"><meta property=og:description content="Instructions for installing compliance trestle with a python venv"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/installation.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/installation/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Installation - Compliance Trestle"><meta name=twitter:description content="Instructions for installing compliance trestle with a python venv"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/installation.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#install-trestle-in-a-python-virtual-environment class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Installation </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../demos/ class=md-tabs__link> Demos </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Installation </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Installation </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#confirm-you-have-python-installed class=md-nav__link> <span class=md-ellipsis> Confirm you have python installed </span> </a> </li> <li class=md-nav__item> <a href=#setup-a-virtual-environment class=md-nav__link> <span class=md-ellipsis> Setup a virtual environment </span> </a> </li> <li class=md-nav__item> <a href=#install-trestle class=md-nav__link> <span class=md-ellipsis> Install trestle </span> </a> </li> <li class=md-nav__item> <a href=#confirm-trestle-is-installed-properly class=md-nav__link> <span class=md-ellipsis> Confirm trestle is installed properly </span> </a> </li> <li class=md-nav__item> <a href=#create-a-trestle-workspace class=md-nav__link> <span class=md-ellipsis> Create a trestle workspace </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#confirm-you-have-python-installed class=md-nav__link> <span class=md-ellipsis> Confirm you have python installed </span> </a> </li> <li class=md-nav__item> <a href=#setup-a-virtual-environment class=md-nav__link> <span class=md-ellipsis> Setup a virtual environment </span> </a> </li> <li class=md-nav__item> <a href=#install-trestle class=md-nav__link> <span class=md-ellipsis> Install trestle </span> </a> </li> <li class=md-nav__item> <a href=#confirm-trestle-is-installed-properly class=md-nav__link> <span class=md-ellipsis> Confirm trestle is installed properly </span> </a> </li> <li class=md-nav__item> <a href=#create-a-trestle-workspace class=md-nav__link> <span class=md-ellipsis> Create a trestle workspace </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=install-trestle-in-a-python-virtual-environment>Install trestle in a python virtual environment<a class=headerlink href=#install-trestle-in-a-python-virtual-environment title="Permanent link">¤</a></h1> <p>There are a few things you need to to start using trestle:</p> <ul> <li>Make sure you have a working and recent Python environment</li> <li>Set up a Python virtual environment</li> <li>Download and install trestle</li> <li>Confirm it is working properly</li> <li>Create a trestle workspace</li> </ul> <h2 id=confirm-you-have-python-installed><em>Confirm you have python installed</em><a class=headerlink href=#confirm-you-have-python-installed title="Permanent link">¤</a></h2> <ul> <li>Ensure you have a modern <a href=https://www.python.org/downloads/ >Python</a> (3.9, 3.10, 3.11).</li> </ul> <div class=highlight><pre><span></span><code>$<span class=w> </span>python<span class=w> </span>-V
+Python<span class=w> </span><span class=m>3</span>.9.2
+</code></pre></div> <h2 id=setup-a-virtual-environment><em>Setup a virtual environment</em><a class=headerlink href=#setup-a-virtual-environment title="Permanent link">¤</a></h2> <p>There are many ways to do this on Windows, Mac and Linux and with different Python installations, so please consult the documentation associated with your platform. Below is how it works on a typical Linux platform.</p> <div class=highlight><pre><span></span><code>$<span class=w> </span><span class=nb>cd</span>
+$<span class=w> </span>python<span class=w> </span>-m<span class=w> </span>venv<span class=w> </span>venv.trestle
+$<span class=w> </span><span class=nb>source</span><span class=w> </span>venv.trestle/bin/activate
+<span class=o>(</span>venv.trestle<span class=o>)</span>$
+</code></pre></div> <ul> <li>Ensure you have a modern <a href=https://pip.pypa.io/en/stable/installing/ >pip</a> (19.x or greater).</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>python<span class=w> </span>-m<span class=w> </span>pip<span class=w> </span>--version
+pip<span class=w> </span><span class=m>19</span>.2.3<span class=w> </span>from<span class=w> </span>/home...
+</code></pre></div> <p>You should probably upgrade your pip to the latest version with:</p> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>python<span class=w> </span>-m<span class=w> </span>pip<span class=w> </span>install<span class=w> </span>--upgrade<span class=w> </span>pip
+</code></pre></div> <p>Details can be found at <a href=https://pip.pypa.io/en/stable/installing/#upgrading-pip>Installation - pip documentation</a></p> <h2 id=install-trestle><em>Install trestle</em><a class=headerlink href=#install-trestle title="Permanent link">¤</a></h2> <ul> <li>Install <a href=https://oscal-compass.github.io/compliance-trestle/ >compliance-trestle</a>.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>python<span class=w> </span>-m<span class=w> </span>pip<span class=w> </span>install<span class=w> </span>compliance-trestle
+Looking<span class=w> </span><span class=k>in</span><span class=w> </span>indexes:<span class=w> </span>https://pypi.org/simple,...
+</code></pre></div> <h2 id=confirm-trestle-is-installed-properly><em>Confirm trestle is installed properly</em><a class=headerlink href=#confirm-trestle-is-installed-properly title="Permanent link">¤</a></h2> <ul> <li>Check trestle viability (and view help).</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>trestle<span class=w> </span>-h
+usage:<span class=w> </span>trestle<span class=w> </span><span class=o>[</span>-h<span class=o>]</span>
+<span class=w>               </span><span class=o>{</span>assemble,author,create,describe,href,import,init,merge,partial-object-validate,remove,replicate,split,task,validate,version<span class=o>}</span>
+<span class=w>               </span>...
+</code></pre></div> <details> <summary>Full help text</summary> <div class=highlight><pre><span></span><code>Manage<span class=w> </span>OSCAL<span class=w> </span>files<span class=w> </span><span class=k>in</span><span class=w> </span>a<span class=w> </span>human<span class=w> </span>friendly<span class=w> </span>manner.
+
+positional<span class=w> </span>arguments:
+<span class=w>  </span><span class=o>{</span>assemble,author,create,describe,href,import,init,merge,partial-object-validate,remove,replicate,split,task,validate,version<span class=o>}</span>
+<span class=w>    </span>assemble<span class=w>            </span>Assemble<span class=w> </span>all<span class=w> </span>subcomponents<span class=w> </span>from<span class=w> </span>a<span class=w> </span>specified<span class=w> </span>trestle<span class=w> </span>model<span class=w> </span>into<span class=w> </span>a<span class=w> </span>single<span class=w> </span>JSON/YAML<span class=w> </span>file<span class=w> </span>under
+<span class=w>                        </span>dist.
+<span class=w>    </span>author<span class=w>              </span>trestle<span class=w> </span>author,<span class=w> </span>a<span class=w> </span>collection<span class=w> </span>of<span class=w> </span>commands<span class=w> </span><span class=k>for</span><span class=w> </span>authoring<span class=w> </span>compliance<span class=w> </span>content<span class=w> </span>outside<span class=w> </span>of<span class=w> </span>OSCAL.
+<span class=w>    </span>create<span class=w>              </span>Create<span class=w> </span>a<span class=w> </span>sample<span class=w> </span>OSCAL<span class=w> </span>model<span class=w> </span><span class=k>in</span><span class=w> </span>trestle<span class=w> </span>project<span class=w> </span>or<span class=w> </span>create<span class=w> </span>new<span class=w> </span>elements<span class=w> </span>within<span class=w> </span>a<span class=w> </span>given<span class=w> </span>model.
+<span class=w>    </span>describe<span class=w>            </span>Describe<span class=w> </span>contents<span class=w> </span>of<span class=w> </span>a<span class=w> </span>model<span class=w> </span>file<span class=w> </span>including<span class=w> </span>optional<span class=w> </span>element<span class=w> </span>path.
+<span class=w>    </span>href<span class=w>                </span>Change<span class=w> </span>href<span class=w> </span>of<span class=w> </span>import<span class=w> </span><span class=k>in</span><span class=w> </span>profile<span class=w> </span>to<span class=w> </span>point<span class=w> </span>to<span class=w> </span>catalog<span class=w> </span><span class=k>in</span><span class=w> </span>trestle<span class=w> </span>project.<span class=w> </span>This<span class=w> </span><span class=nb>command</span><span class=w> </span>is
+<span class=w>                        </span>needed<span class=w> </span>when<span class=w> </span>generating<span class=w> </span>an<span class=w> </span>SSP<span class=w> </span>with<span class=w> </span>a<span class=w> </span>profile<span class=w> </span>that<span class=w> </span>imports<span class=w> </span>a<span class=w> </span>catalog<span class=w> </span>from<span class=w> </span>a<span class=w> </span>temporary<span class=w> </span>location
+<span class=w>                        </span>different<span class=w> </span>from<span class=w> </span>the<span class=w> </span>final<span class=w> </span>intended<span class=w> </span>location<span class=w> </span>of<span class=w> </span>the<span class=w> </span>catalog.<span class=w> </span>Omit<span class=w> </span>the<span class=w> </span>href<span class=w> </span>argument<span class=w> </span>to<span class=w> </span>see<span class=w> </span>the
+<span class=w>                        </span>list<span class=w> </span>of<span class=w> </span>current<span class=w> </span>imports<span class=w> </span><span class=k>in</span><span class=w> </span>the<span class=w> </span>profile.
+<span class=w>    </span>import<span class=w>              </span>Import<span class=w> </span>an<span class=w> </span>existing<span class=w> </span>full<span class=w> </span>OSCAL<span class=w> </span>model<span class=w> </span>into<span class=w> </span>the<span class=w> </span>trestle<span class=w> </span>project.
+<span class=w>    </span>init<span class=w>                </span>Initialize<span class=w> </span>a<span class=w> </span>trestle<span class=w> </span>working<span class=w> </span>directory.
+<span class=w>    </span>merge<span class=w>               </span>Merge<span class=w> </span>subcomponents<span class=w> </span>on<span class=w> </span>a<span class=w> </span>trestle<span class=w> </span>model.
+<span class=w>    </span>partial-object-validate
+<span class=w>                        </span>Direct<span class=w> </span>validation<span class=w> </span>any<span class=w> </span>oscal<span class=w> </span>object<span class=w> </span><span class=k>in</span><span class=w> </span>a<span class=w> </span>file,<span class=w> </span>including<span class=w> </span>list<span class=w> </span>objects.
+<span class=w>    </span>remove<span class=w>              </span>Remove<span class=w> </span>a<span class=w> </span>subcomponent<span class=w> </span>to<span class=w> </span>an<span class=w> </span>existing<span class=w> </span>model.
+<span class=w>    </span>replicate<span class=w>           </span>Replicate<span class=w> </span>a<span class=w> </span>top<span class=w> </span>level<span class=w> </span>model<span class=w> </span>within<span class=w> </span>the<span class=w> </span>trestle<span class=w> </span>directory<span class=w> </span>structure.
+<span class=w>    </span>split<span class=w>               </span>Split<span class=w> </span>subcomponents<span class=w> </span>on<span class=w> </span>a<span class=w> </span>trestle<span class=w> </span>model.
+<span class=w>    </span>task<span class=w>                </span>Run<span class=w> </span>arbitrary<span class=w> </span>trestle<span class=w> </span>tasks<span class=w> </span><span class=k>in</span><span class=w> </span>a<span class=w> </span>simple<span class=w> </span>and<span class=w> </span>extensible<span class=w> </span>methodology.
+<span class=w>    </span>validate<span class=w>            </span>Validate<span class=w> </span>contents<span class=w> </span>of<span class=w> </span>a<span class=w> </span>trestle<span class=w> </span>model<span class=w> </span><span class=k>in</span><span class=w> </span>different<span class=w> </span>modes.
+<span class=w>    </span>version<span class=w>             </span>Output<span class=w> </span>version<span class=w> </span>info<span class=w> </span><span class=k>for</span><span class=w> </span>trestle<span class=w> </span>and<span class=w> </span>OSCAL.
+
+optional<span class=w> </span>arguments:
+<span class=w>  </span>-h,<span class=w> </span>--help<span class=w>            </span>show<span class=w> </span>this<span class=w> </span><span class=nb>help</span><span class=w> </span>message<span class=w> </span>and<span class=w> </span><span class=nb>exit</span>
+</code></pre></div> </details> <h2 id=create-a-trestle-workspace><em>Create a trestle workspace</em><a class=headerlink href=#create-a-trestle-workspace title="Permanent link">¤</a></h2> <ul> <li>Create trestle workspace.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>mkdir<span class=w> </span>trestle.workspace
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span><span class=nb>cd</span><span class=w> </span>trestle.workspace
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>trestle<span class=w> </span>init
+Initialized<span class=w> </span>trestle<span class=w> </span>project<span class=w> </span>successfully<span class=w> </span><span class=k>in</span><span class=w> </span>/home/&lt;user&gt;/trestle.workspace
+</code></pre></div> <p>Congratulations! You now have a working trestle workspace for safe manipulation of OSCAL documents!</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">June 14, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/known_limitations/index.html b/latest/known_limitations/index.html
new file mode 100644
index 000000000..29e968a73
--- /dev/null
+++ b/latest/known_limitations/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Known limitations of compliance trestle"><link href=https://oscal-compass.github.io/compliance-trestle/latest/known_limitations/ rel=canonical><link href=../installation/ rel=prev><link href=../license/ rel=next><link rel=icon href=../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Known Limitations - Compliance Trestle</title><link rel=stylesheet href=../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../assets/_mkdocstrings.css><script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Known Limitations - Compliance Trestle"><meta property=og:description content="Known limitations of compliance trestle"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/known_limitations.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/known_limitations/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Known Limitations - Compliance Trestle"><meta name=twitter:description content="Known limitations of compliance trestle"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/known_limitations.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#known-errors-and-limitations class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Known Limitations </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../installation/ class=md-tabs__link> Installation </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Known Limitations </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Known Limitations </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#utf-8-encoding-only class=md-nav__link> <span class=md-ellipsis> utf-8 encoding only </span> </a> </li> <li class=md-nav__item> <a href=#single-oscal-release-only class=md-nav__link> <span class=md-ellipsis> Single OSCAL release only </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#utf-8-encoding-only class=md-nav__link> <span class=md-ellipsis> utf-8 encoding only </span> </a> </li> <li class=md-nav__item> <a href=#single-oscal-release-only class=md-nav__link> <span class=md-ellipsis> Single OSCAL release only </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=known-errors-and-limitations>Known errors and limitations<a class=headerlink href=#known-errors-and-limitations title="Permanent link">¤</a></h1> <h2 id=utf-8-encoding-only>utf-8 encoding only<a class=headerlink href=#utf-8-encoding-only title="Permanent link">¤</a></h2> <p>Trestle supports only utf8 as a file text-encoding. If non-utf8 files are encountered, errors will be reported / thrown. Trestle provides a <a href=https://github.com/oscal-compass/compliance-trestle/blob/develop/scripts/utf8me.py>script</a> that may be used to convert files to utf8 in a destructive manner that may change the file contents.</p> <p>WARNING: This script is potentially destructive and may remove / damage content. Ensure you have a backup before use.</p> <h2 id=single-oscal-release-only>Single OSCAL release only<a class=headerlink href=#single-oscal-release-only title="Permanent link">¤</a></h2> <p>Each version of compliance trestle is designed to support only one version of the OSCAL schema.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">December 19, 2023</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/license/index.html b/latest/license/index.html
new file mode 100644
index 000000000..a36bd25f1
--- /dev/null
+++ b/latest/license/index.html
@@ -0,0 +1,202 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for compliance-trestle package."><link href=https://oscal-compass.github.io/compliance-trestle/latest/license/ rel=canonical><link href=../known_limitations/ rel=prev><link href=../contributing/ rel=next><link rel=icon href=../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>License - Compliance Trestle</title><link rel=stylesheet href=../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../assets/_mkdocstrings.css><script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="License - Compliance Trestle"><meta property=og:description content="Documentation for compliance-trestle package."><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/license.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/license/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="License - Compliance Trestle"><meta name=twitter:description content="Documentation for compliance-trestle package."><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/license.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> License </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>License</h1> <div class=highlight><pre><span></span><code>                                 Apache License
+                           Version 2.0, January 2004
+                        https://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      &quot;License&quot; shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      &quot;Licensor&quot; shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      &quot;Legal Entity&quot; shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      &quot;control&quot; means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      &quot;You&quot; (or &quot;Your&quot;) shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      &quot;Source&quot; form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      &quot;Object&quot; form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      &quot;Work&quot; shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      &quot;Derivative Works&quot; shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      &quot;Contribution&quot; shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, &quot;submitted&quot;
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as &quot;Not a Contribution.&quot;
+
+      &quot;Contributor&quot; shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a &quot;NOTICE&quot; text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an &quot;AS IS&quot; BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets &quot;[]&quot;
+      replaced with your own identifying information. (Don&#39;t include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same &quot;printed page&quot; as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the &quot;License&quot;);
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an &quot;AS IS&quot; BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+</code></pre></div> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 27, 2021</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/objects.inv b/latest/objects.inv
new file mode 100644
index 0000000000000000000000000000000000000000..6983d724894f1b781f91a7afcde937b4e57bcce3
GIT binary patch
literal 29133
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

literal 0
HcmV?d00001

diff --git a/latest/plugins/fedramp/index.html b/latest/plugins/fedramp/index.html
new file mode 100644
index 000000000..3d17e82d8
--- /dev/null
+++ b/latest/plugins/fedramp/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Description of the compliance-trestle FedRAMP plugin for validating an SSP against the extended requirements for FedRAMP"><link href=https://oscal-compass.github.io/compliance-trestle/latest/plugins/fedramp/ rel=canonical><link href=../../contributing/github_actions_setup/ rel=prev><link href=../../reference/third-party-result-schema-IBM-SCC/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>FedRAMP plugin - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="FedRAMP plugin - Compliance Trestle"><meta property=og:description content="Description of the compliance-trestle FedRAMP plugin for validating an SSP against the extended requirements for FedRAMP"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/plugins/fedramp.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/plugins/fedramp/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="FedRAMP plugin - Compliance Trestle"><meta name=twitter:description content="Description of the compliance-trestle FedRAMP plugin for validating an SSP against the extended requirements for FedRAMP"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/plugins/fedramp.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#compliance-trestle-fedramp-plugin class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> FedRAMP plugin </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7 checked> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=true> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> FedRAMP plugin </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> FedRAMP plugin </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle-fedramp-validate class=md-nav__link> <span class=md-ellipsis> trestle fedramp-validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle-fedramp-transform class=md-nav__link> <span class=md-ellipsis> trestle fedramp-transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle-fedramp-validate class=md-nav__link> <span class=md-ellipsis> trestle fedramp-validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle-fedramp-transform class=md-nav__link> <span class=md-ellipsis> trestle fedramp-transform </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=compliance-trestle-fedramp-plugin>compliance-trestle-fedramp plugin<a class=headerlink href=#compliance-trestle-fedramp-plugin title="Permanent link">¤</a></h1> <p>This plugin provides functionality for validating an SSP for FedRAMP compliance. It provides both an API interface and a trestle command for performing this validation.</p> <h2 id=trestle-fedramp-validate><code>trestle fedramp-validate</code><a class=headerlink href=#trestle-fedramp-validate title="Permanent link">¤</a></h2> <p>This command allows users to validate existing OSCAL SSP file (in JSON or YAML format) for FedRAMP compliance. For example, <code>trestle fedramp-validate -f /local_dir/ssp.json -o report/</code> will validate <code>ssp.json</code> file for fedramp compliance and store the validation reports in <code>report</code> folder.</p> <p>The following options are supported:</p> <ul> <li><code>-f or --file</code>: specifies the path of an existing OSCAL SSP file. It may be an absolute or relative path. The file must be in either JSON or YAML format. This is a required option.</li> <li><code>-o or --output</code>: specifies the name of the output directory where the validation reports will be stored. It may be an absolute or relative path. The output directory should already exist. This is also a required option.</li> </ul> <p>The validation reports are created in XML and HTML format and provide details on which part of the SSP are not complaint as per FedRAMP specification.</p> <h2 id=trestle-fedramp-transform><code>trestle fedramp-transform</code><a class=headerlink href=#trestle-fedramp-transform title="Permanent link">¤</a></h2> <p>This command allows users to extract information from an OSCAL SSP and transform it into a Word document based on the FedRAMP SSP Appendix A Template. The templates for the High, Moderate, and Low baseline security control requirements were retrieved from this <a href=https://www.fedramp.gov/documents-templates/ >location</a> and are bundled with the application. The <code>Control Summary Information</code> tables are populated for each control based on the OSCAL SSP.</p> <p>For example, <code>trestle fedramp-transform -n ssp-name -l 'high' -o my_ssp.docx</code> will transform the OSCAL SSP file <code>ssp-name</code> into a Word document <code>my_ssp.docx</code> based on the SSP Appendix A - High FedRAMP Security Controls template.</p> <p>The following options are supported:</p> <ul> <li><code>-n or --ssp-name</code>: The name of the OSCAL SSP imported into trestle workspace. This is a required option.</li> <li><code>-l or --level</code>: The baseline level corresponding to the template. This is high, moderate, low. This is a required option.</li> <li><code>-o or --output-file</code>: The output location for the populated Word document. This is also a required option.</li> </ul> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">September 25, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/cli/index.html b/latest/reference/API/trestle/cli/index.html
new file mode 100644
index 000000000..aaede3fc2
--- /dev/null
+++ b/latest/reference/API/trestle/cli/index.html
@@ -0,0 +1,81 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.cli module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/cli/ rel=canonical><link href=../../../third-party-result-schema-IBM-SCC/ rel=prev><link href=../common/common_types/ rel=next><link rel=icon href=../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.cli - Compliance Trestle</title><link rel=stylesheet href=../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.cli - Compliance Trestle"><meta property=og:description content="Documentation for trestle.cli module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/cli.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/cli/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.cli - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.cli module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/cli.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.cli class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.cli </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.cli </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.cli </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.cli class=md-nav__link> <span class=md-ellipsis> cli </span> </a> <nav class=md-nav aria-label=cli> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.cli-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.Trestle class=md-nav__link> <span class=md-ellipsis> Trestle </span> </a> <nav class=md-nav aria-label=Trestle> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.Trestle-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.Trestle.subcommands class=md-nav__link> <span class=md-ellipsis> subcommands </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.cli-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.run class=md-nav__link> <span class=md-ellipsis> run </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.cli class=md-nav__link> <span class=md-ellipsis> cli </span> </a> <nav class=md-nav aria-label=cli> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.cli-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.Trestle class=md-nav__link> <span class=md-ellipsis> Trestle </span> </a> <nav class=md-nav aria-label=Trestle> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.Trestle-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.Trestle.subcommands class=md-nav__link> <span class=md-ellipsis> subcommands </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.cli-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.cli.run class=md-nav__link> <span class=md-ellipsis> run </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.cli</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.cli class="doc doc-heading"> <code>trestle.cli</code> <a href=#trestle.cli class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Starting point for the Trestle CLI.</p> <div class="doc doc-children"> <h3 id=trestle.cli-attributes>Attributes<a href=#trestle.cli-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.cli.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=s1>&#39;trestle&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.cli.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.cli-classes>Classes<a href=#trestle.cli-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.cli.Trestle class="doc doc-heading"> <code>Trestle</code> <a href=#trestle.cli.Trestle class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandBase href=../core/commands/command_docs/#trestle.core.commands.command_docs.CommandBase>CommandBase</a></code></p> <p>Manage OSCAL files in a human friendly manner.</p> <details class=quote> <summary>Source code in <code>trestle/cli.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Trestle</span><span class=p>(</span><span class=n>CommandBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Manage OSCAL files in a human friendly manner.&quot;&quot;&quot;</span>
+
+    <span class=n>subcommands</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=n>AssembleCmd</span><span class=p>,</span>
+        <span class=n>AuthorCmd</span><span class=p>,</span>
+        <span class=n>CreateCmd</span><span class=p>,</span>
+        <span class=n>DescribeCmd</span><span class=p>,</span>
+        <span class=n>HrefCmd</span><span class=p>,</span>
+        <span class=n>ImportCmd</span><span class=p>,</span>
+        <span class=n>InitCmd</span><span class=p>,</span>
+        <span class=n>MergeCmd</span><span class=p>,</span>
+        <span class=n>PartialObjectValidate</span><span class=p>,</span>
+        <span class=n>RemoveCmd</span><span class=p>,</span>
+        <span class=n>ReplicateCmd</span><span class=p>,</span>
+        <span class=n>SplitCmd</span><span class=p>,</span>
+        <span class=n>TaskCmd</span><span class=p>,</span>
+        <span class=n>ValidateCmd</span><span class=p>,</span>
+        <span class=n>VersionCmd</span>
+    <span class=p>]</span>
+
+    <span class=c1># This block is uncovered as trestle cannot find plugins in it&#39;s unit tests - it is the base module.</span>
+    <span class=k>for</span> <span class=n>plugin</span><span class=p>,</span> <span class=n>cmd_cls</span> <span class=ow>in</span> <span class=n>discovered_plugins</span><span class=p>(</span><span class=s1>&#39;commands&#39;</span><span class=p>):</span>  <span class=c1># pragma: nocover</span>
+        <span class=c1># add commands (derived from CommandPlusDocs or CommandBase) to subcommands list</span>
+        <span class=k>if</span> <span class=nb>issubclass</span><span class=p>(</span><span class=n>cmd_cls</span><span class=p>,</span> <span class=n>CommandBase</span><span class=p>):</span>
+            <span class=c1># don&#39;t add CommandPlusDocs or CommandBase</span>
+            <span class=k>if</span> <span class=n>cmd_cls</span> <span class=ow>is</span> <span class=ow>not</span> <span class=n>CommandPlusDocs</span> <span class=ow>and</span> <span class=n>cmd_cls</span> <span class=ow>is</span> <span class=ow>not</span> <span class=n>CommandBase</span><span class=p>:</span>
+                <span class=n>subcommands</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>cmd_cls</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>cmd_cls</span><span class=si>}</span><span class=s1> added to subcommands from plugin </span><span class=si>{</span><span class=n>plugin</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-v&#39;</span><span class=p>,</span> <span class=s1>&#39;--verbose&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_VERBOSE_OUTPUT</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;count&#39;</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-tr&#39;</span><span class=p>,</span> <span class=s1>&#39;--trestle-root&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Path of trestle root dir&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>cwd</span><span class=p>()</span>
+        <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.cli.Trestle-attributes>Attributes<a href=#trestle.cli.Trestle-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.cli.Trestle.subcommands class="doc doc-heading"> <code class="highlight language-python"><span class=n>subcommands</span> <span class=o>=</span> <span class=p>[</span><span class=n>AssembleCmd</span><span class=p>,</span> <span class=n>AuthorCmd</span><span class=p>,</span> <span class=n>CreateCmd</span><span class=p>,</span> <span class=n>DescribeCmd</span><span class=p>,</span> <span class=n>HrefCmd</span><span class=p>,</span> <span class=n>ImportCmd</span><span class=p>,</span> <span class=n>InitCmd</span><span class=p>,</span> <span class=n>MergeCmd</span><span class=p>,</span> <span class=n>PartialObjectValidate</span><span class=p>,</span> <span class=n>RemoveCmd</span><span class=p>,</span> <span class=n>ReplicateCmd</span><span class=p>,</span> <span class=n>SplitCmd</span><span class=p>,</span> <span class=n>TaskCmd</span><span class=p>,</span> <span class=n>ValidateCmd</span><span class=p>,</span> <span class=n>VersionCmd</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.cli.Trestle.subcommands class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h3 id=trestle.cli-functions>Functions<a href=#trestle.cli-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.cli.run class="doc doc-heading"> <code class="highlight language-python"><span class=n>run</span><span class=p>()</span></code> <a href=#trestle.cli.run class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Run the trestle cli.</p> <details class=quote> <summary>Source code in <code>trestle/cli.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>run</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Run the trestle cli.&quot;&quot;&quot;</span>
+    <span class=n>log</span><span class=o>.</span><span class=n>set_global_logging_levels</span><span class=p>()</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Main entry point.&#39;</span><span class=p>)</span>
+
+    <span class=n>exit</span><span class=p>(</span><span class=n>Trestle</span><span class=p>()</span><span class=o>.</span><span class=n>run</span><span class=p>())</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/common_types/index.html b/latest/reference/API/trestle/common/common_types/index.html
new file mode 100644
index 000000000..5290b100e
--- /dev/null
+++ b/latest/reference/API/trestle/common/common_types/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.common_types module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/common_types/ rel=canonical><link href=../../cli/ rel=prev><link href=../const/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.common_types - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.common_types - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.common_types module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/common_types.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/common_types/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.common_types - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.common_types module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/common_types.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.common_types class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.common_types </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.common_types </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.common_types </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.common_types class=md-nav__link> <span class=md-ellipsis> common_types </span> </a> <nav class=md-nav aria-label=common_types> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.common_types-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.common_types.FixedUuidModel class=md-nav__link> <span class=md-ellipsis> FixedUuidModel </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.OBT class=md-nav__link> <span class=md-ellipsis> OBT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TG class=md-nav__link> <span class=md-ellipsis> TG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TG2 class=md-nav__link> <span class=md-ellipsis> TG2 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TopLevelOscalModel class=md-nav__link> <span class=md-ellipsis> TopLevelOscalModel </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithByComps class=md-nav__link> <span class=md-ellipsis> TypeWithByComps </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithParamId class=md-nav__link> <span class=md-ellipsis> TypeWithParamId </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithParts class=md-nav__link> <span class=md-ellipsis> TypeWithParts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithProps class=md-nav__link> <span class=md-ellipsis> TypeWithProps </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithSetParams class=md-nav__link> <span class=md-ellipsis> TypeWithSetParams </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.common_types-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.common_types class=md-nav__link> <span class=md-ellipsis> common_types </span> </a> <nav class=md-nav aria-label=common_types> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.common_types-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.common_types.FixedUuidModel class=md-nav__link> <span class=md-ellipsis> FixedUuidModel </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.OBT class=md-nav__link> <span class=md-ellipsis> OBT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TG class=md-nav__link> <span class=md-ellipsis> TG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TG2 class=md-nav__link> <span class=md-ellipsis> TG2 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TopLevelOscalModel class=md-nav__link> <span class=md-ellipsis> TopLevelOscalModel </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithByComps class=md-nav__link> <span class=md-ellipsis> TypeWithByComps </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithParamId class=md-nav__link> <span class=md-ellipsis> TypeWithParamId </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithParts class=md-nav__link> <span class=md-ellipsis> TypeWithParts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithProps class=md-nav__link> <span class=md-ellipsis> TypeWithProps </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.common_types.TypeWithSetParams class=md-nav__link> <span class=md-ellipsis> TypeWithSetParams </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.common_types-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.common_types</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.common_types class="doc doc-heading"> <code>trestle.common.common_types</code> <a href=#trestle.common.common_types class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Special types are defined here.</p> <div class="doc doc-children"> <h3 id=trestle.common.common_types-attributes>Attributes<a href=#trestle.common.common_types-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.FixedUuidModel class="doc doc-heading"> <code class="highlight language-python"><span class=n>FixedUuidModel</span> <span class=o>=</span> <span class=n>Resource</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.FixedUuidModel class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.OBT class="doc doc-heading"> <code class="highlight language-python"><span class=n>OBT</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;OBT&#39;</span><span class=p>,</span> <span class=n>bound</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.OBT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.TG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TG</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;TG&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.TG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.TG2 class="doc doc-heading"> <code class="highlight language-python"><span class=n>TG2</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;TG2&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.TG2 class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.TopLevelOscalModel class="doc doc-heading"> <code class="highlight language-python"><span class=n>TopLevelOscalModel</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;TopLevelOscalModel&#39;</span><span class=p>,</span> <span class=n>AssessmentPlan</span><span class=p>,</span> <span class=n>AssessmentResults</span><span class=p>,</span> <span class=n>Catalog</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>,</span> <span class=n>PlanOfActionAndMilestones</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.TopLevelOscalModel class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.TypeWithByComps class="doc doc-heading"> <code class="highlight language-python"><span class=n>TypeWithByComps</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;TypeWithByComps&#39;</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>Statement</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.TypeWithByComps class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.TypeWithParamId class="doc doc-heading"> <code class="highlight language-python"><span class=n>TypeWithParamId</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;TypeWithParamId&#39;</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.TypeWithParamId class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.TypeWithParts class="doc doc-heading"> <code class="highlight language-python"><span class=n>TypeWithParts</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;TypeWithParts&#39;</span><span class=p>,</span> <span class=n>Control</span><span class=p>,</span> <span class=n>Part</span><span class=p>,</span> <span class=n>Group</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Group</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.TypeWithParts class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.TypeWithProps class="doc doc-heading"> <code class="highlight language-python"><span class=n>TypeWithProps</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;TypeWithProps&#39;</span><span class=p>,</span> <span class=n>Control</span><span class=p>,</span> <span class=n>Part</span><span class=p>,</span> <span class=n>AssessmentPart</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>Statement</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.TypeWithProps class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.common_types.TypeWithSetParams class="doc doc-heading"> <code class="highlight language-python"><span class=n>TypeWithSetParams</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;TypeWithSetParams&#39;</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Modify</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.common_types.TypeWithSetParams class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.common.common_types-classes>Classes<a href=#trestle.common.common_types-classes class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/const/index.html b/latest/reference/API/trestle/common/const/index.html
new file mode 100644
index 000000000..33f35afec
--- /dev/null
+++ b/latest/reference/API/trestle/common/const/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.const module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/const/ rel=canonical><link href=../common_types/ rel=prev><link href=../err/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.const - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.const - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.const module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/const.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/const/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.const - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.const module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/const.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.const class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.const </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.const </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.const </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.const class=md-nav__link> <span class=md-ellipsis> const </span> </a> <nav class=md-nav aria-label=const> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.const-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.const.ADDED_BY_CONTROL_OWNER class=md-nav__link> <span class=md-ellipsis> ADDED_BY_CONTROL_OWNER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.AFTER_HASHES_REGEX class=md-nav__link> <span class=md-ellipsis> AFTER_HASHES_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.AGGREGATES class=md-nav__link> <span class=md-ellipsis> AGGREGATES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ALIAS_PATH_SEPARATOR class=md-nav__link> <span class=md-ellipsis> ALIAS_PATH_SEPARATOR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ALLOWED_EXTENSIONS_IN_DIRS class=md-nav__link> <span class=md-ellipsis> ALLOWED_EXTENSIONS_IN_DIRS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ALT_IDENTIFIER class=md-nav__link> <span class=md-ellipsis> ALT_IDENTIFIER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_DESC_ELEMENT class=md-nav__link> <span class=md-ellipsis> ARG_DESC_ELEMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_DESC_FILE class=md-nav__link> <span class=md-ellipsis> ARG_DESC_FILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_DESC_MODE class=md-nav__link> <span class=md-ellipsis> ARG_DESC_MODE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_ELEMENT class=md-nav__link> <span class=md-ellipsis> ARG_ELEMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_ELEMENT_SHORT class=md-nav__link> <span class=md-ellipsis> ARG_ELEMENT_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_FILE class=md-nav__link> <span class=md-ellipsis> ARG_FILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_FILE_SHORT class=md-nav__link> <span class=md-ellipsis> ARG_FILE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_MODE class=md-nav__link> <span class=md-ellipsis> ARG_MODE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_MODE_SHORT class=md-nav__link> <span class=md-ellipsis> ARG_MODE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_VALIDATE class=md-nav__link> <span class=md-ellipsis> ARG_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_VALIDATE_SHORT class=md-nav__link> <span class=md-ellipsis> ARG_VALIDATE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ASSESMENT_OBJECTIVE_PART class=md-nav__link> <span class=md-ellipsis> ASSESMENT_OBJECTIVE_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.BUG_REPORT class=md-nav__link> <span class=md-ellipsis> BUG_REPORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CACHE_ABS_DIR class=md-nav__link> <span class=md-ellipsis> CACHE_ABS_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CLOSE_COMMENT class=md-nav__link> <span class=md-ellipsis> CLOSE_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.COMPONENT_VALUES class=md-nav__link> <span class=md-ellipsis> COMPONENT_VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.COMP_DEF_RULES_PARAM_VALS_TAG class=md-nav__link> <span class=md-ellipsis> COMP_DEF_RULES_PARAM_VALS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.COMP_DEF_RULES_TAG class=md-nav__link> <span class=md-ellipsis> COMP_DEF_RULES_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_HEADER class=md-nav__link> <span class=md-ellipsis> CONTROL_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_IMPLEMENTATION class=md-nav__link> <span class=md-ellipsis> CONTROL_IMPLEMENTATION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_OBJECTIVE_HEADER class=md-nav__link> <span class=md-ellipsis> CONTROL_OBJECTIVE_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_ORIGINATION class=md-nav__link> <span class=md-ellipsis> CONTROL_ORIGINATION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_REGEX class=md-nav__link> <span class=md-ellipsis> CONTROL_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_STATEMENT_HEADER class=md-nav__link> <span class=md-ellipsis> CONTROL_STATEMENT_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.DAY_SECONDS class=md-nav__link> <span class=md-ellipsis> DAY_SECONDS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.DISPLAY_NAME class=md-nav__link> <span class=md-ellipsis> DISPLAY_NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.DISPLAY_VERBOSE_OUTPUT class=md-nav__link> <span class=md-ellipsis> DISPLAY_VERBOSE_OUTPUT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.DRAWIO_FILE_EXT class=md-nav__link> <span class=md-ellipsis> DRAWIO_FILE_EXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.EDITABLE_CONTENT class=md-nav__link> <span class=md-ellipsis> EDITABLE_CONTENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ELEMENT_WILDCARD class=md-nav__link> <span class=md-ellipsis> ELEMENT_WILDCARD </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FIELDS_SET class=md-nav__link> <span class=md-ellipsis> FIELDS_SET </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILE_DIGIT_PREFIX_LENGTH class=md-nav__link> <span class=md-ellipsis> FILE_DIGIT_PREFIX_LENGTH </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILE_ENCODING class=md-nav__link> <span class=md-ellipsis> FILE_ENCODING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILE_URI class=md-nav__link> <span class=md-ellipsis> FILE_URI </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILTER_BY_COMPONENTS class=md-nav__link> <span class=md-ellipsis> FILTER_BY_COMPONENTS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILTER_BY_PROFILE class=md-nav__link> <span class=md-ellipsis> FILTER_BY_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILTER_EXCLUDE_COMPONENTS class=md-nav__link> <span class=md-ellipsis> FILTER_EXCLUDE_COMPONENTS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.GENERATE_RESOLVED_CATALOG class=md-nav__link> <span class=md-ellipsis> GENERATE_RESOLVED_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.GUIDELINES class=md-nav__link> <span class=md-ellipsis> GUIDELINES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HEADER_RULE_ID class=md-nav__link> <span class=md-ellipsis> HEADER_RULE_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_ALLOWED_SECTIONS class=md-nav__link> <span class=md-ellipsis> HELP_ALLOWED_SECTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_COMPDEFS class=md-nav__link> <span class=md-ellipsis> HELP_COMPDEFS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_FO_OUTPUT class=md-nav__link> <span class=md-ellipsis> HELP_FO_OUTPUT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_INCLUDE_ALL_PARTS class=md-nav__link> <span class=md-ellipsis> HELP_INCLUDE_ALL_PARTS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_LEVERAGED class=md-nav__link> <span class=md-ellipsis> HELP_LEVERAGED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_MARKDOWN_NAME class=md-nav__link> <span class=md-ellipsis> HELP_MARKDOWN_NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_OVERWRITE_HEADER_VALUES class=md-nav__link> <span class=md-ellipsis> HELP_OVERWRITE_HEADER_VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_REGENERATE class=md-nav__link> <span class=md-ellipsis> HELP_REGENERATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_REQUIRED_SECTIONS class=md-nav__link> <span class=md-ellipsis> HELP_REQUIRED_SECTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_SECTIONS class=md-nav__link> <span class=md-ellipsis> HELP_SECTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_SET_PARAMS class=md-nav__link> <span class=md-ellipsis> HELP_SET_PARAMS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_VERSION class=md-nav__link> <span class=md-ellipsis> HELP_VERSION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_YAML_PATH class=md-nav__link> <span class=md-ellipsis> HELP_YAML_PATH </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HOUR_SECONDS class=md-nav__link> <span class=md-ellipsis> HOUR_SECONDS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HREF class=md-nav__link> <span class=md-ellipsis> HREF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HTTPS_URI class=md-nav__link> <span class=md-ellipsis> HTTPS_URI </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IDX_SEP class=md-nav__link> <span class=md-ellipsis> IDX_SEP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_POINT class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_POINT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_POINT_EXTERNAL class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_POINT_EXTERNAL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_STATUS class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_STATUS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_STATUS_HEADER class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_STATUS_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_STATUS_REMARKS_HEADER class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_STATUS_REMARKS_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTED_REQUIREMENT class=md-nav__link> <span class=md-ellipsis> IMPLEMENTED_REQUIREMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INHERITANCE_VIEW_DIR class=md-nav__link> <span class=md-ellipsis> INHERITANCE_VIEW_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INHERITED_UUID class=md-nav__link> <span class=md-ellipsis> INHERITED_UUID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_FULL_HELP class=md-nav__link> <span class=md-ellipsis> INIT_FULL_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_FULL_LONG class=md-nav__link> <span class=md-ellipsis> INIT_FULL_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_FULL_SHORT class=md-nav__link> <span class=md-ellipsis> INIT_FULL_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_GOVDOCS_HELP class=md-nav__link> <span class=md-ellipsis> INIT_GOVDOCS_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_GOVDOCS_LONG class=md-nav__link> <span class=md-ellipsis> INIT_GOVDOCS_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_GOVDOCS_SHORT class=md-nav__link> <span class=md-ellipsis> INIT_GOVDOCS_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_LOCAL_HELP class=md-nav__link> <span class=md-ellipsis> INIT_LOCAL_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_LOCAL_LONG class=md-nav__link> <span class=md-ellipsis> INIT_LOCAL_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_LOCAL_SHORT class=md-nav__link> <span class=md-ellipsis> INIT_LOCAL_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IOF_HELP class=md-nav__link> <span class=md-ellipsis> IOF_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IOF_LONG class=md-nav__link> <span class=md-ellipsis> IOF_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IOF_SHORT class=md-nav__link> <span class=md-ellipsis> IOF_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ITEM class=md-nav__link> <span class=md-ellipsis> ITEM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.LABEL class=md-nav__link> <span class=md-ellipsis> LABEL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.LEVERAGED_SSP class=md-nav__link> <span class=md-ellipsis> LEVERAGED_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.LEV_AUTH_UUID class=md-nav__link> <span class=md-ellipsis> LEV_AUTH_UUID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MARKDOWN_FILE_EXT class=md-nav__link> <span class=md-ellipsis> MARKDOWN_FILE_EXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MARKDOWN_URL_REGEX class=md-nav__link> <span class=md-ellipsis> MARKDOWN_URL_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX class=md-nav__link> <span class=md-ellipsis> MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_A_PLAN class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_A_PLAN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_A_RESULT class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_A_RESULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_CATALOG class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_COMPDEF class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_COMPDEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_LIST class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_LIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_POAM class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_POAM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_PROFILE class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_SSP class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_TO_MODEL_MODULE class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_TO_MODEL_MODULE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_A_PLAN class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_A_PLAN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_A_RESULT class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_A_RESULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_CATALOG class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_COMPDEF class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_COMPDEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_LIST class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_LIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_POAM class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_POAM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_PROFILE class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_SSP class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_TO_MODEL_TYPE class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_TO_MODEL_TYPE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_A_PLAN class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_A_PLAN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_A_RESULT class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_A_RESULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_CATALOG class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_COMPDEF class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_COMPDEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_LIST class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_LIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_POAM class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_POAM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_PROFILE class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_SSP class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_TO_MODEL_DIR class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_TO_MODEL_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_TO_MODEL_MODULE class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_TO_MODEL_MODULE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_A_PLAN class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_A_PLAN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_A_RESULT class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_A_RESULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_CATALOG class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_COMPDEF class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_COMPDEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_POAM class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_POAM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_PROFILE class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_SSP class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NAME class=md-nav__link> <span class=md-ellipsis> NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NAMESPACE_FEDRAMP class=md-nav__link> <span class=md-ellipsis> NAMESPACE_FEDRAMP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NAMESPACE_NIST class=md-nav__link> <span class=md-ellipsis> NAMESPACE_NIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NCNAME_REGEX class=md-nav__link> <span class=md-ellipsis> NCNAME_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NCNAME_UTF8_FIRST_CHAR_OPTIONS class=md-nav__link> <span class=md-ellipsis> NCNAME_UTF8_FIRST_CHAR_OPTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NCNAME_UTF8_OTHER_CHAR_OPTIONS class=md-nav__link> <span class=md-ellipsis> NCNAME_UTF8_OTHER_CHAR_OPTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.OBJECTIVE_PART class=md-nav__link> <span class=md-ellipsis> OBJECTIVE_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ONE class=md-nav__link> <span class=md-ellipsis> ONE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ONE_OR_MORE_HYPHENED class=md-nav__link> <span class=md-ellipsis> ONE_OR_MORE_HYPHENED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ONE_OR_MORE_SPACED class=md-nav__link> <span class=md-ellipsis> ONE_OR_MORE_SPACED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_CUSTOMER_CONFIGURED class=md-nav__link> <span class=md-ellipsis> ORIGINATION_CUSTOMER_CONFIGURED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_CUSTOMER_PROVIDED class=md-nav__link> <span class=md-ellipsis> ORIGINATION_CUSTOMER_PROVIDED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_INHERITED class=md-nav__link> <span class=md-ellipsis> ORIGINATION_INHERITED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_ORGANIZATION class=md-nav__link> <span class=md-ellipsis> ORIGINATION_ORGANIZATION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_SYSTEM_SPECIFIC class=md-nav__link> <span class=md-ellipsis> ORIGINATION_SYSTEM_SPECIFIC </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PACKAGE_OSCAL class=md-nav__link> <span class=md-ellipsis> PACKAGE_OSCAL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAMETER_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> PARAMETER_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAMETER_ID class=md-nav__link> <span class=md-ellipsis> PARAMETER_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAMETER_VALUE_ALTERNATIVES class=md-nav__link> <span class=md-ellipsis> PARAMETER_VALUE_ALTERNATIVES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAM_VALUES_TAG class=md-nav__link> <span class=md-ellipsis> PARAM_VALUES_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAM_VALUE_ORIGIN class=md-nav__link> <span class=md-ellipsis> PARAM_VALUE_ORIGIN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PART_REGEX class=md-nav__link> <span class=md-ellipsis> PART_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROFILE class=md-nav__link> <span class=md-ellipsis> PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT class=md-nav__link> <span class=md-ellipsis> PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROFILE_PARAM_VALUE_ORIGIN class=md-nav__link> <span class=md-ellipsis> PROFILE_PARAM_VALUE_ORIGIN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROFILE_VALUES class=md-nav__link> <span class=md-ellipsis> PROFILE_VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROPERTY_REGEX class=md-nav__link> <span class=md-ellipsis> PROPERTY_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROVIDED_STATEMENT_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> PROVIDED_STATEMENT_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROVIDED_UUID class=md-nav__link> <span class=md-ellipsis> PROVIDED_UUID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.REMARKS class=md-nav__link> <span class=md-ellipsis> REMARKS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.REPLACE_ME class=md-nav__link> <span class=md-ellipsis> REPLACE_ME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.REPLACE_ME_PLACEHOLDER class=md-nav__link> <span class=md-ellipsis> REPLACE_ME_PLACEHOLDER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESOLUTION_SOURCE class=md-nav__link> <span class=md-ellipsis> RESOLUTION_SOURCE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESPONSIBILITY_STATEMENT_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> RESPONSIBILITY_STATEMENT_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESPONSIBILITY_UUID class=md-nav__link> <span class=md-ellipsis> RESPONSIBILITY_UUID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESPONSIBLE_ROLE class=md-nav__link> <span class=md-ellipsis> RESPONSIBLE_ROLE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESPONSIBLE_ROLES class=md-nav__link> <span class=md-ellipsis> RESPONSIBLE_ROLES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ROOT class=md-nav__link> <span class=md-ellipsis> ROOT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RULES_PARAMS_TAG class=md-nav__link> <span class=md-ellipsis> RULES_PARAMS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RULES_WARNING class=md-nav__link> <span class=md-ellipsis> RULES_WARNING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RULE_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> RULE_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RULE_ID class=md-nav__link> <span class=md-ellipsis> RULE_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SAMPLE_UUID_STR class=md-nav__link> <span class=md-ellipsis> SAMPLE_UUID_STR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SATISFIED_STATEMENT_COMMENT class=md-nav__link> <span class=md-ellipsis> SATISFIED_STATEMENT_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SATISFIED_STATEMENT_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> SATISFIED_STATEMENT_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SECTIONS_TAG class=md-nav__link> <span class=md-ellipsis> SECTIONS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SET_PARAMS_TAG class=md-nav__link> <span class=md-ellipsis> SET_PARAMS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SFTP_URI class=md-nav__link> <span class=md-ellipsis> SFTP_URI </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SORT_ID class=md-nav__link> <span class=md-ellipsis> SORT_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_STATEMENT_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_ADD_IMPLEMENTATION_FOR_STATEMENT_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_PREFIX class=md-nav__link> <span class=md-ellipsis> SSP_ADD_IMPLEMENTATION_PREFIX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_FEDRAMP_TAG class=md-nav__link> <span class=md-ellipsis> SSP_FEDRAMP_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_MAIN_COMP_NAME class=md-nav__link> <span class=md-ellipsis> SSP_MAIN_COMP_NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_MD_HRULE_LINE class=md-nav__link> <span class=md-ellipsis> SSP_MD_HRULE_LINE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_MD_IMPLEMENTATION_QUESTION class=md-nav__link> <span class=md-ellipsis> SSP_MD_IMPLEMENTATION_QUESTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_MD_LEAVE_BLANK_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_MD_LEAVE_BLANK_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_VALUES class=md-nav__link> <span class=md-ellipsis> SSP_VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATEMENT class=md-nav__link> <span class=md-ellipsis> STATEMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_ALL class=md-nav__link> <span class=md-ellipsis> STATUS_ALL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_ALTERNATIVE class=md-nav__link> <span class=md-ellipsis> STATUS_ALTERNATIVE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_COMPLETION_DATE class=md-nav__link> <span class=md-ellipsis> STATUS_COMPLETION_DATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_DISPOSITION class=md-nav__link> <span class=md-ellipsis> STATUS_DISPOSITION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_IMPLEMENTED class=md-nav__link> <span class=md-ellipsis> STATUS_IMPLEMENTED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_INHERITED class=md-nav__link> <span class=md-ellipsis> STATUS_INHERITED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_NOT_APPLICABLE class=md-nav__link> <span class=md-ellipsis> STATUS_NOT_APPLICABLE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_OPERATIONAL class=md-nav__link> <span class=md-ellipsis> STATUS_OPERATIONAL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_OTHER class=md-nav__link> <span class=md-ellipsis> STATUS_OTHER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PARTIAL class=md-nav__link> <span class=md-ellipsis> STATUS_PARTIAL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PARTIALLY_IMPLEMENTED class=md-nav__link> <span class=md-ellipsis> STATUS_PARTIALLY_IMPLEMENTED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PLANNED class=md-nav__link> <span class=md-ellipsis> STATUS_PLANNED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PLANNED_COMPLETION_DATE class=md-nav__link> <span class=md-ellipsis> STATUS_PLANNED_COMPLETION_DATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PROMPT class=md-nav__link> <span class=md-ellipsis> STATUS_PROMPT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_REMARKS class=md-nav__link> <span class=md-ellipsis> STATUS_REMARKS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_UNDER_DEVELOPMENT class=md-nav__link> <span class=md-ellipsis> STATUS_UNDER_DEVELOPMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_UNDER_MAJOR_MODIFICATION class=md-nav__link> <span class=md-ellipsis> STATUS_UNDER_MAJOR_MODIFICATION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TABLE_OF_PARAMS_PART class=md-nav__link> <span class=md-ellipsis> TABLE_OF_PARAMS_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TEMPLATE_VERSION_REGEX class=md-nav__link> <span class=md-ellipsis> TEMPLATE_VERSION_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.THIS_SYSTEM_AS_KEY class=md-nav__link> <span class=md-ellipsis> THIS_SYSTEM_AS_KEY </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.THIS_SYSTEM_PROMPT class=md-nav__link> <span class=md-ellipsis> THIS_SYSTEM_PROMPT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TITLE class=md-nav__link> <span class=md-ellipsis> TITLE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRANSFORM_TYPES class=md-nav__link> <span class=md-ellipsis> TRANSFORM_TYPES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_ADD_PROPS_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_ADD_PROPS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_CACHE_DIR class=md-nav__link> <span class=md-ellipsis> TRESTLE_CACHE_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_CONFIG_DIR class=md-nav__link> <span class=md-ellipsis> TRESTLE_CONFIG_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_CONFIG_FILE class=md-nav__link> <span class=md-ellipsis> TRESTLE_CONFIG_FILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_DIST_DIR class=md-nav__link> <span class=md-ellipsis> TRESTLE_DIST_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_GENERIC_NS class=md-nav__link> <span class=md-ellipsis> TRESTLE_GENERIC_NS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_GLOBAL_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_GLOBAL_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_HREF_HEADING class=md-nav__link> <span class=md-ellipsis> TRESTLE_HREF_HEADING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_HREF_REGEX class=md-nav__link> <span class=md-ellipsis> TRESTLE_HREF_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_IMP_STATUS_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_IMP_STATUS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_INHERITED_PROPS_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_INHERITED_PROPS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_INHERITED_PROPS_TRACKER class=md-nav__link> <span class=md-ellipsis> TRESTLE_INHERITED_PROPS_TRACKER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_KEEP_FILE class=md-nav__link> <span class=md-ellipsis> TRESTLE_KEEP_FILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_LEVERAGING_COMP_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_LEVERAGING_COMP_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_PROPS_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_PROPS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_STATEMENT_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_STATEMENT_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.UNIX_CACHE_ROOT class=md-nav__link> <span class=md-ellipsis> UNIX_CACHE_ROOT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.UUID_REGEX class=md-nav__link> <span class=md-ellipsis> UUID_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VALUES class=md-nav__link> <span class=md-ellipsis> VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VALUE_ASSIGNED_PREFIX class=md-nav__link> <span class=md-ellipsis> VALUE_ASSIGNED_PREFIX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VALUE_NOT_ASSIGNED_PREFIX class=md-nav__link> <span class=md-ellipsis> VALUE_NOT_ASSIGNED_PREFIX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_ALL class=md-nav__link> <span class=md-ellipsis> VAL_MODE_ALL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_CATALOG class=md-nav__link> <span class=md-ellipsis> VAL_MODE_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_DUPLICATES class=md-nav__link> <span class=md-ellipsis> VAL_MODE_DUPLICATES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_LINKS class=md-nav__link> <span class=md-ellipsis> VAL_MODE_LINKS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_REFS class=md-nav__link> <span class=md-ellipsis> VAL_MODE_REFS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_RULES class=md-nav__link> <span class=md-ellipsis> VAL_MODE_RULES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.WEBSITE_ROOT class=md-nav__link> <span class=md-ellipsis> WEBSITE_ROOT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.WINDOWS_DRIVE_LETTER_REGEX class=md-nav__link> <span class=md-ellipsis> WINDOWS_DRIVE_LETTER_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.WINDOWS_DRIVE_URI_REGEX class=md-nav__link> <span class=md-ellipsis> WINDOWS_DRIVE_URI_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.WINDOWS_PLATFORM_STR class=md-nav__link> <span class=md-ellipsis> WINDOWS_PLATFORM_STR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_LEVERAGED_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_LEVERAGED_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_LEVERAGING_COMP_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_LEVERAGING_COMP_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_PROFILE_VALUES_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_PROFILE_VALUES_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_PROPS_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_PROPS_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_RULE_PARAM_VALUES_SSP_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_RULE_PARAM_VALUES_SSP_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_SSP_VALUES_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_SSP_VALUES_COMMENT </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.const class=md-nav__link> <span class=md-ellipsis> const </span> </a> <nav class=md-nav aria-label=const> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.const-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.const.ADDED_BY_CONTROL_OWNER class=md-nav__link> <span class=md-ellipsis> ADDED_BY_CONTROL_OWNER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.AFTER_HASHES_REGEX class=md-nav__link> <span class=md-ellipsis> AFTER_HASHES_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.AGGREGATES class=md-nav__link> <span class=md-ellipsis> AGGREGATES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ALIAS_PATH_SEPARATOR class=md-nav__link> <span class=md-ellipsis> ALIAS_PATH_SEPARATOR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ALLOWED_EXTENSIONS_IN_DIRS class=md-nav__link> <span class=md-ellipsis> ALLOWED_EXTENSIONS_IN_DIRS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ALT_IDENTIFIER class=md-nav__link> <span class=md-ellipsis> ALT_IDENTIFIER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_DESC_ELEMENT class=md-nav__link> <span class=md-ellipsis> ARG_DESC_ELEMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_DESC_FILE class=md-nav__link> <span class=md-ellipsis> ARG_DESC_FILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_DESC_MODE class=md-nav__link> <span class=md-ellipsis> ARG_DESC_MODE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_ELEMENT class=md-nav__link> <span class=md-ellipsis> ARG_ELEMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_ELEMENT_SHORT class=md-nav__link> <span class=md-ellipsis> ARG_ELEMENT_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_FILE class=md-nav__link> <span class=md-ellipsis> ARG_FILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_FILE_SHORT class=md-nav__link> <span class=md-ellipsis> ARG_FILE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_MODE class=md-nav__link> <span class=md-ellipsis> ARG_MODE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_MODE_SHORT class=md-nav__link> <span class=md-ellipsis> ARG_MODE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_VALIDATE class=md-nav__link> <span class=md-ellipsis> ARG_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ARG_VALIDATE_SHORT class=md-nav__link> <span class=md-ellipsis> ARG_VALIDATE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ASSESMENT_OBJECTIVE_PART class=md-nav__link> <span class=md-ellipsis> ASSESMENT_OBJECTIVE_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.BUG_REPORT class=md-nav__link> <span class=md-ellipsis> BUG_REPORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CACHE_ABS_DIR class=md-nav__link> <span class=md-ellipsis> CACHE_ABS_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CLOSE_COMMENT class=md-nav__link> <span class=md-ellipsis> CLOSE_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.COMPONENT_VALUES class=md-nav__link> <span class=md-ellipsis> COMPONENT_VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.COMP_DEF_RULES_PARAM_VALS_TAG class=md-nav__link> <span class=md-ellipsis> COMP_DEF_RULES_PARAM_VALS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.COMP_DEF_RULES_TAG class=md-nav__link> <span class=md-ellipsis> COMP_DEF_RULES_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_HEADER class=md-nav__link> <span class=md-ellipsis> CONTROL_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_IMPLEMENTATION class=md-nav__link> <span class=md-ellipsis> CONTROL_IMPLEMENTATION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_OBJECTIVE_HEADER class=md-nav__link> <span class=md-ellipsis> CONTROL_OBJECTIVE_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_ORIGINATION class=md-nav__link> <span class=md-ellipsis> CONTROL_ORIGINATION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_REGEX class=md-nav__link> <span class=md-ellipsis> CONTROL_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.CONTROL_STATEMENT_HEADER class=md-nav__link> <span class=md-ellipsis> CONTROL_STATEMENT_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.DAY_SECONDS class=md-nav__link> <span class=md-ellipsis> DAY_SECONDS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.DISPLAY_NAME class=md-nav__link> <span class=md-ellipsis> DISPLAY_NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.DISPLAY_VERBOSE_OUTPUT class=md-nav__link> <span class=md-ellipsis> DISPLAY_VERBOSE_OUTPUT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.DRAWIO_FILE_EXT class=md-nav__link> <span class=md-ellipsis> DRAWIO_FILE_EXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.EDITABLE_CONTENT class=md-nav__link> <span class=md-ellipsis> EDITABLE_CONTENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ELEMENT_WILDCARD class=md-nav__link> <span class=md-ellipsis> ELEMENT_WILDCARD </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FIELDS_SET class=md-nav__link> <span class=md-ellipsis> FIELDS_SET </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILE_DIGIT_PREFIX_LENGTH class=md-nav__link> <span class=md-ellipsis> FILE_DIGIT_PREFIX_LENGTH </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILE_ENCODING class=md-nav__link> <span class=md-ellipsis> FILE_ENCODING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILE_URI class=md-nav__link> <span class=md-ellipsis> FILE_URI </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILTER_BY_COMPONENTS class=md-nav__link> <span class=md-ellipsis> FILTER_BY_COMPONENTS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILTER_BY_PROFILE class=md-nav__link> <span class=md-ellipsis> FILTER_BY_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.FILTER_EXCLUDE_COMPONENTS class=md-nav__link> <span class=md-ellipsis> FILTER_EXCLUDE_COMPONENTS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.GENERATE_RESOLVED_CATALOG class=md-nav__link> <span class=md-ellipsis> GENERATE_RESOLVED_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.GUIDELINES class=md-nav__link> <span class=md-ellipsis> GUIDELINES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HEADER_RULE_ID class=md-nav__link> <span class=md-ellipsis> HEADER_RULE_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_ALLOWED_SECTIONS class=md-nav__link> <span class=md-ellipsis> HELP_ALLOWED_SECTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_COMPDEFS class=md-nav__link> <span class=md-ellipsis> HELP_COMPDEFS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_FO_OUTPUT class=md-nav__link> <span class=md-ellipsis> HELP_FO_OUTPUT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_INCLUDE_ALL_PARTS class=md-nav__link> <span class=md-ellipsis> HELP_INCLUDE_ALL_PARTS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_LEVERAGED class=md-nav__link> <span class=md-ellipsis> HELP_LEVERAGED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_MARKDOWN_NAME class=md-nav__link> <span class=md-ellipsis> HELP_MARKDOWN_NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_OVERWRITE_HEADER_VALUES class=md-nav__link> <span class=md-ellipsis> HELP_OVERWRITE_HEADER_VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_REGENERATE class=md-nav__link> <span class=md-ellipsis> HELP_REGENERATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_REQUIRED_SECTIONS class=md-nav__link> <span class=md-ellipsis> HELP_REQUIRED_SECTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_SECTIONS class=md-nav__link> <span class=md-ellipsis> HELP_SECTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_SET_PARAMS class=md-nav__link> <span class=md-ellipsis> HELP_SET_PARAMS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_VERSION class=md-nav__link> <span class=md-ellipsis> HELP_VERSION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HELP_YAML_PATH class=md-nav__link> <span class=md-ellipsis> HELP_YAML_PATH </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HOUR_SECONDS class=md-nav__link> <span class=md-ellipsis> HOUR_SECONDS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HREF class=md-nav__link> <span class=md-ellipsis> HREF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.HTTPS_URI class=md-nav__link> <span class=md-ellipsis> HTTPS_URI </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IDX_SEP class=md-nav__link> <span class=md-ellipsis> IDX_SEP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_POINT class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_POINT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_POINT_EXTERNAL class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_POINT_EXTERNAL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_STATUS class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_STATUS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_STATUS_HEADER class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_STATUS_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTATION_STATUS_REMARKS_HEADER class=md-nav__link> <span class=md-ellipsis> IMPLEMENTATION_STATUS_REMARKS_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IMPLEMENTED_REQUIREMENT class=md-nav__link> <span class=md-ellipsis> IMPLEMENTED_REQUIREMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INHERITANCE_VIEW_DIR class=md-nav__link> <span class=md-ellipsis> INHERITANCE_VIEW_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INHERITED_UUID class=md-nav__link> <span class=md-ellipsis> INHERITED_UUID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_FULL_HELP class=md-nav__link> <span class=md-ellipsis> INIT_FULL_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_FULL_LONG class=md-nav__link> <span class=md-ellipsis> INIT_FULL_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_FULL_SHORT class=md-nav__link> <span class=md-ellipsis> INIT_FULL_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_GOVDOCS_HELP class=md-nav__link> <span class=md-ellipsis> INIT_GOVDOCS_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_GOVDOCS_LONG class=md-nav__link> <span class=md-ellipsis> INIT_GOVDOCS_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_GOVDOCS_SHORT class=md-nav__link> <span class=md-ellipsis> INIT_GOVDOCS_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_LOCAL_HELP class=md-nav__link> <span class=md-ellipsis> INIT_LOCAL_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_LOCAL_LONG class=md-nav__link> <span class=md-ellipsis> INIT_LOCAL_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.INIT_LOCAL_SHORT class=md-nav__link> <span class=md-ellipsis> INIT_LOCAL_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IOF_HELP class=md-nav__link> <span class=md-ellipsis> IOF_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IOF_LONG class=md-nav__link> <span class=md-ellipsis> IOF_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.IOF_SHORT class=md-nav__link> <span class=md-ellipsis> IOF_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ITEM class=md-nav__link> <span class=md-ellipsis> ITEM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.LABEL class=md-nav__link> <span class=md-ellipsis> LABEL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.LEVERAGED_SSP class=md-nav__link> <span class=md-ellipsis> LEVERAGED_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.LEV_AUTH_UUID class=md-nav__link> <span class=md-ellipsis> LEV_AUTH_UUID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MARKDOWN_FILE_EXT class=md-nav__link> <span class=md-ellipsis> MARKDOWN_FILE_EXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MARKDOWN_URL_REGEX class=md-nav__link> <span class=md-ellipsis> MARKDOWN_URL_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX class=md-nav__link> <span class=md-ellipsis> MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_A_PLAN class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_A_PLAN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_A_RESULT class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_A_RESULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_CATALOG class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_COMPDEF class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_COMPDEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_LIST class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_LIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_POAM class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_POAM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_PROFILE class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_SSP class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_DIR_TO_MODEL_MODULE class=md-nav__link> <span class=md-ellipsis> MODEL_DIR_TO_MODEL_MODULE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_A_PLAN class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_A_PLAN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_A_RESULT class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_A_RESULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_CATALOG class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_COMPDEF class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_COMPDEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_LIST class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_LIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_POAM class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_POAM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_PROFILE class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_SSP class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_MODULE_TO_MODEL_TYPE class=md-nav__link> <span class=md-ellipsis> MODEL_MODULE_TO_MODEL_TYPE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_A_PLAN class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_A_PLAN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_A_RESULT class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_A_RESULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_CATALOG class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_COMPDEF class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_COMPDEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_LIST class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_LIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_POAM class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_POAM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_PROFILE class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_SSP class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_TO_MODEL_DIR class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_TO_MODEL_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODEL_TYPE_TO_MODEL_MODULE class=md-nav__link> <span class=md-ellipsis> MODEL_TYPE_TO_MODEL_MODULE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_A_PLAN class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_A_PLAN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_A_RESULT class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_A_RESULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_CATALOG class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_COMPDEF class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_COMPDEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_POAM class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_POAM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_PROFILE class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.MODULE_NAME_SSP class=md-nav__link> <span class=md-ellipsis> MODULE_NAME_SSP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NAME class=md-nav__link> <span class=md-ellipsis> NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NAMESPACE_FEDRAMP class=md-nav__link> <span class=md-ellipsis> NAMESPACE_FEDRAMP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NAMESPACE_NIST class=md-nav__link> <span class=md-ellipsis> NAMESPACE_NIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NCNAME_REGEX class=md-nav__link> <span class=md-ellipsis> NCNAME_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NCNAME_UTF8_FIRST_CHAR_OPTIONS class=md-nav__link> <span class=md-ellipsis> NCNAME_UTF8_FIRST_CHAR_OPTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.NCNAME_UTF8_OTHER_CHAR_OPTIONS class=md-nav__link> <span class=md-ellipsis> NCNAME_UTF8_OTHER_CHAR_OPTIONS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.OBJECTIVE_PART class=md-nav__link> <span class=md-ellipsis> OBJECTIVE_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ONE class=md-nav__link> <span class=md-ellipsis> ONE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ONE_OR_MORE_HYPHENED class=md-nav__link> <span class=md-ellipsis> ONE_OR_MORE_HYPHENED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ONE_OR_MORE_SPACED class=md-nav__link> <span class=md-ellipsis> ONE_OR_MORE_SPACED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_CUSTOMER_CONFIGURED class=md-nav__link> <span class=md-ellipsis> ORIGINATION_CUSTOMER_CONFIGURED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_CUSTOMER_PROVIDED class=md-nav__link> <span class=md-ellipsis> ORIGINATION_CUSTOMER_PROVIDED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_INHERITED class=md-nav__link> <span class=md-ellipsis> ORIGINATION_INHERITED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_ORGANIZATION class=md-nav__link> <span class=md-ellipsis> ORIGINATION_ORGANIZATION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ORIGINATION_SYSTEM_SPECIFIC class=md-nav__link> <span class=md-ellipsis> ORIGINATION_SYSTEM_SPECIFIC </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PACKAGE_OSCAL class=md-nav__link> <span class=md-ellipsis> PACKAGE_OSCAL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAMETER_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> PARAMETER_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAMETER_ID class=md-nav__link> <span class=md-ellipsis> PARAMETER_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAMETER_VALUE_ALTERNATIVES class=md-nav__link> <span class=md-ellipsis> PARAMETER_VALUE_ALTERNATIVES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAM_VALUES_TAG class=md-nav__link> <span class=md-ellipsis> PARAM_VALUES_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PARAM_VALUE_ORIGIN class=md-nav__link> <span class=md-ellipsis> PARAM_VALUE_ORIGIN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PART_REGEX class=md-nav__link> <span class=md-ellipsis> PART_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROFILE class=md-nav__link> <span class=md-ellipsis> PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT class=md-nav__link> <span class=md-ellipsis> PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROFILE_PARAM_VALUE_ORIGIN class=md-nav__link> <span class=md-ellipsis> PROFILE_PARAM_VALUE_ORIGIN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROFILE_VALUES class=md-nav__link> <span class=md-ellipsis> PROFILE_VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROPERTY_REGEX class=md-nav__link> <span class=md-ellipsis> PROPERTY_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROVIDED_STATEMENT_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> PROVIDED_STATEMENT_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.PROVIDED_UUID class=md-nav__link> <span class=md-ellipsis> PROVIDED_UUID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.REMARKS class=md-nav__link> <span class=md-ellipsis> REMARKS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.REPLACE_ME class=md-nav__link> <span class=md-ellipsis> REPLACE_ME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.REPLACE_ME_PLACEHOLDER class=md-nav__link> <span class=md-ellipsis> REPLACE_ME_PLACEHOLDER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESOLUTION_SOURCE class=md-nav__link> <span class=md-ellipsis> RESOLUTION_SOURCE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESPONSIBILITY_STATEMENT_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> RESPONSIBILITY_STATEMENT_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESPONSIBILITY_UUID class=md-nav__link> <span class=md-ellipsis> RESPONSIBILITY_UUID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESPONSIBLE_ROLE class=md-nav__link> <span class=md-ellipsis> RESPONSIBLE_ROLE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RESPONSIBLE_ROLES class=md-nav__link> <span class=md-ellipsis> RESPONSIBLE_ROLES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.ROOT class=md-nav__link> <span class=md-ellipsis> ROOT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RULES_PARAMS_TAG class=md-nav__link> <span class=md-ellipsis> RULES_PARAMS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RULES_WARNING class=md-nav__link> <span class=md-ellipsis> RULES_WARNING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RULE_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> RULE_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.RULE_ID class=md-nav__link> <span class=md-ellipsis> RULE_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SAMPLE_UUID_STR class=md-nav__link> <span class=md-ellipsis> SAMPLE_UUID_STR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SATISFIED_STATEMENT_COMMENT class=md-nav__link> <span class=md-ellipsis> SATISFIED_STATEMENT_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SATISFIED_STATEMENT_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> SATISFIED_STATEMENT_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SECTIONS_TAG class=md-nav__link> <span class=md-ellipsis> SECTIONS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SET_PARAMS_TAG class=md-nav__link> <span class=md-ellipsis> SET_PARAMS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SFTP_URI class=md-nav__link> <span class=md-ellipsis> SFTP_URI </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SORT_ID class=md-nav__link> <span class=md-ellipsis> SORT_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_STATEMENT_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_ADD_IMPLEMENTATION_FOR_STATEMENT_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_PREFIX class=md-nav__link> <span class=md-ellipsis> SSP_ADD_IMPLEMENTATION_PREFIX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_FEDRAMP_TAG class=md-nav__link> <span class=md-ellipsis> SSP_FEDRAMP_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_MAIN_COMP_NAME class=md-nav__link> <span class=md-ellipsis> SSP_MAIN_COMP_NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_MD_HRULE_LINE class=md-nav__link> <span class=md-ellipsis> SSP_MD_HRULE_LINE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_MD_IMPLEMENTATION_QUESTION class=md-nav__link> <span class=md-ellipsis> SSP_MD_IMPLEMENTATION_QUESTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_MD_LEAVE_BLANK_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_MD_LEAVE_BLANK_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT class=md-nav__link> <span class=md-ellipsis> SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.SSP_VALUES class=md-nav__link> <span class=md-ellipsis> SSP_VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATEMENT class=md-nav__link> <span class=md-ellipsis> STATEMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_ALL class=md-nav__link> <span class=md-ellipsis> STATUS_ALL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_ALTERNATIVE class=md-nav__link> <span class=md-ellipsis> STATUS_ALTERNATIVE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_COMPLETION_DATE class=md-nav__link> <span class=md-ellipsis> STATUS_COMPLETION_DATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_DISPOSITION class=md-nav__link> <span class=md-ellipsis> STATUS_DISPOSITION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_IMPLEMENTED class=md-nav__link> <span class=md-ellipsis> STATUS_IMPLEMENTED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_INHERITED class=md-nav__link> <span class=md-ellipsis> STATUS_INHERITED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_NOT_APPLICABLE class=md-nav__link> <span class=md-ellipsis> STATUS_NOT_APPLICABLE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_OPERATIONAL class=md-nav__link> <span class=md-ellipsis> STATUS_OPERATIONAL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_OTHER class=md-nav__link> <span class=md-ellipsis> STATUS_OTHER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PARTIAL class=md-nav__link> <span class=md-ellipsis> STATUS_PARTIAL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PARTIALLY_IMPLEMENTED class=md-nav__link> <span class=md-ellipsis> STATUS_PARTIALLY_IMPLEMENTED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PLANNED class=md-nav__link> <span class=md-ellipsis> STATUS_PLANNED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PLANNED_COMPLETION_DATE class=md-nav__link> <span class=md-ellipsis> STATUS_PLANNED_COMPLETION_DATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_PROMPT class=md-nav__link> <span class=md-ellipsis> STATUS_PROMPT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_REMARKS class=md-nav__link> <span class=md-ellipsis> STATUS_REMARKS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_UNDER_DEVELOPMENT class=md-nav__link> <span class=md-ellipsis> STATUS_UNDER_DEVELOPMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.STATUS_UNDER_MAJOR_MODIFICATION class=md-nav__link> <span class=md-ellipsis> STATUS_UNDER_MAJOR_MODIFICATION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TABLE_OF_PARAMS_PART class=md-nav__link> <span class=md-ellipsis> TABLE_OF_PARAMS_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TEMPLATE_VERSION_REGEX class=md-nav__link> <span class=md-ellipsis> TEMPLATE_VERSION_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.THIS_SYSTEM_AS_KEY class=md-nav__link> <span class=md-ellipsis> THIS_SYSTEM_AS_KEY </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.THIS_SYSTEM_PROMPT class=md-nav__link> <span class=md-ellipsis> THIS_SYSTEM_PROMPT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TITLE class=md-nav__link> <span class=md-ellipsis> TITLE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRANSFORM_TYPES class=md-nav__link> <span class=md-ellipsis> TRANSFORM_TYPES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_ADD_PROPS_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_ADD_PROPS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_CACHE_DIR class=md-nav__link> <span class=md-ellipsis> TRESTLE_CACHE_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_CONFIG_DIR class=md-nav__link> <span class=md-ellipsis> TRESTLE_CONFIG_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_CONFIG_FILE class=md-nav__link> <span class=md-ellipsis> TRESTLE_CONFIG_FILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_DIST_DIR class=md-nav__link> <span class=md-ellipsis> TRESTLE_DIST_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_GENERIC_NS class=md-nav__link> <span class=md-ellipsis> TRESTLE_GENERIC_NS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_GLOBAL_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_GLOBAL_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_HREF_HEADING class=md-nav__link> <span class=md-ellipsis> TRESTLE_HREF_HEADING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_HREF_REGEX class=md-nav__link> <span class=md-ellipsis> TRESTLE_HREF_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_IMP_STATUS_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_IMP_STATUS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_INHERITED_PROPS_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_INHERITED_PROPS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_INHERITED_PROPS_TRACKER class=md-nav__link> <span class=md-ellipsis> TRESTLE_INHERITED_PROPS_TRACKER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_KEEP_FILE class=md-nav__link> <span class=md-ellipsis> TRESTLE_KEEP_FILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_LEVERAGING_COMP_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_LEVERAGING_COMP_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_PROPS_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_PROPS_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_STATEMENT_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_STATEMENT_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.TRESTLE_TAG class=md-nav__link> <span class=md-ellipsis> TRESTLE_TAG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.UNIX_CACHE_ROOT class=md-nav__link> <span class=md-ellipsis> UNIX_CACHE_ROOT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.UUID_REGEX class=md-nav__link> <span class=md-ellipsis> UUID_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VALUES class=md-nav__link> <span class=md-ellipsis> VALUES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VALUE_ASSIGNED_PREFIX class=md-nav__link> <span class=md-ellipsis> VALUE_ASSIGNED_PREFIX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VALUE_NOT_ASSIGNED_PREFIX class=md-nav__link> <span class=md-ellipsis> VALUE_NOT_ASSIGNED_PREFIX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_ALL class=md-nav__link> <span class=md-ellipsis> VAL_MODE_ALL </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_CATALOG class=md-nav__link> <span class=md-ellipsis> VAL_MODE_CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_DUPLICATES class=md-nav__link> <span class=md-ellipsis> VAL_MODE_DUPLICATES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_LINKS class=md-nav__link> <span class=md-ellipsis> VAL_MODE_LINKS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_REFS class=md-nav__link> <span class=md-ellipsis> VAL_MODE_REFS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.VAL_MODE_RULES class=md-nav__link> <span class=md-ellipsis> VAL_MODE_RULES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.WEBSITE_ROOT class=md-nav__link> <span class=md-ellipsis> WEBSITE_ROOT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.WINDOWS_DRIVE_LETTER_REGEX class=md-nav__link> <span class=md-ellipsis> WINDOWS_DRIVE_LETTER_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.WINDOWS_DRIVE_URI_REGEX class=md-nav__link> <span class=md-ellipsis> WINDOWS_DRIVE_URI_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.WINDOWS_PLATFORM_STR class=md-nav__link> <span class=md-ellipsis> WINDOWS_PLATFORM_STR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_LEVERAGED_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_LEVERAGED_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_LEVERAGING_COMP_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_LEVERAGING_COMP_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_PROFILE_VALUES_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_PROFILE_VALUES_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_PROPS_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_PROPS_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_RULE_PARAM_VALUES_SSP_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_RULE_PARAM_VALUES_SSP_COMMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.const.YAML_SSP_VALUES_COMMENT class=md-nav__link> <span class=md-ellipsis> YAML_SSP_VALUES_COMMENT </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.const</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.const class="doc doc-heading"> <code>trestle.common.const</code> <a href=#trestle.common.const class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Core constants module containing all constants.</p> <div class="doc doc-children"> <h3 id=trestle.common.const-attributes>Attributes<a href=#trestle.common.const-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ADDED_BY_CONTROL_OWNER class="doc doc-heading"> <code class="highlight language-python"><span class=n>ADDED_BY_CONTROL_OWNER</span> <span class=o>=</span> <span class=s1>&#39;Added by control owner&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ADDED_BY_CONTROL_OWNER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.AFTER_HASHES_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>AFTER_HASHES_REGEX</span> <span class=o>=</span> <span class=s1>&#39;(?:##*</span><span class=se>\\</span><span class=s1>s+)(.*)&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.AFTER_HASHES_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.AGGREGATES class="doc doc-heading"> <code class="highlight language-python"><span class=n>AGGREGATES</span> <span class=o>=</span> <span class=s1>&#39;aggregates&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.AGGREGATES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ALIAS_PATH_SEPARATOR class="doc doc-heading"> <code class="highlight language-python"><span class=n>ALIAS_PATH_SEPARATOR</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ALIAS_PATH_SEPARATOR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ALLOWED_EXTENSIONS_IN_DIRS class="doc doc-heading"> <code class="highlight language-python"><span class=n>ALLOWED_EXTENSIONS_IN_DIRS</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;.json&#39;</span><span class=p>,</span> <span class=s1>&#39;.xml&#39;</span><span class=p>,</span> <span class=s1>&#39;.yaml&#39;</span><span class=p>,</span> <span class=s1>&#39;.yml&#39;</span><span class=p>,</span> <span class=s1>&#39;.md&#39;</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ALLOWED_EXTENSIONS_IN_DIRS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ALT_IDENTIFIER class="doc doc-heading"> <code class="highlight language-python"><span class=n>ALT_IDENTIFIER</span> <span class=o>=</span> <span class=s1>&#39;alt-identifier&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ALT_IDENTIFIER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_DESC_ELEMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_DESC_ELEMENT</span> <span class=o>=</span> <span class=s1>&#39;Path of the element in the OSCAL model&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_DESC_ELEMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_DESC_FILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_DESC_FILE</span> <span class=o>=</span> <span class=s1>&#39;Path of the file&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_DESC_FILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_DESC_MODE class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_DESC_MODE</span> <span class=o>=</span> <span class=s1>&#39;Mode of the operation&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_DESC_MODE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_ELEMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_ELEMENT</span> <span class=o>=</span> <span class=s1>&#39;element&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_ELEMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_ELEMENT_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_ELEMENT_SHORT</span> <span class=o>=</span> <span class=s1>&#39;e&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_ELEMENT_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_FILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_FILE</span> <span class=o>=</span> <span class=s1>&#39;file&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_FILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_FILE_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_FILE_SHORT</span> <span class=o>=</span> <span class=s1>&#39;f&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_FILE_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_MODE class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_MODE</span> <span class=o>=</span> <span class=s1>&#39;mode&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_MODE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_MODE_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_MODE_SHORT</span> <span class=o>=</span> <span class=s1>&#39;m&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_MODE_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_VALIDATE class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_VALIDATE</span> <span class=o>=</span> <span class=s1>&#39;validate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_VALIDATE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ARG_VALIDATE_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>ARG_VALIDATE_SHORT</span> <span class=o>=</span> <span class=s1>&#39;v&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ARG_VALIDATE_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ASSESMENT_OBJECTIVE_PART class="doc doc-heading"> <code class="highlight language-python"><span class=n>ASSESMENT_OBJECTIVE_PART</span> <span class=o>=</span> <span class=s1>&#39;assessment-objective&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ASSESMENT_OBJECTIVE_PART class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.BUG_REPORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>BUG_REPORT</span> <span class=o>=</span> <span class=s1>&#39;https://github.com/oscal-compass/compliance-trestle/issues/new/choose&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.BUG_REPORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.CACHE_ABS_DIR class="doc doc-heading"> <code class="highlight language-python"><span class=n>CACHE_ABS_DIR</span> <span class=o>=</span> <span class=s1>&#39;__abs__&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.CACHE_ABS_DIR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.CLOSE_COMMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>CLOSE_COMMENT</span> <span class=o>=</span> <span class=s1>&#39; --&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.CLOSE_COMMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.COMPONENT_VALUES class="doc doc-heading"> <code class="highlight language-python"><span class=n>COMPONENT_VALUES</span> <span class=o>=</span> <span class=s1>&#39;component-values&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.COMPONENT_VALUES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.COMP_DEF_RULES_PARAM_VALS_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;comp-def-rules-param-vals&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.COMP_DEF_RULES_PARAM_VALS_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.COMP_DEF_RULES_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>COMP_DEF_RULES_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;comp-def-rules&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.COMP_DEF_RULES_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.CONTROL_HEADER class="doc doc-heading"> <code class="highlight language-python"><span class=n>CONTROL_HEADER</span> <span class=o>=</span> <span class=s1>&#39;## Control&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.CONTROL_HEADER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.CONTROL_IMPLEMENTATION class="doc doc-heading"> <code class="highlight language-python"><span class=n>CONTROL_IMPLEMENTATION</span> <span class=o>=</span> <span class=s1>&#39;control-implementation&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.CONTROL_IMPLEMENTATION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.CONTROL_OBJECTIVE_HEADER class="doc doc-heading"> <code class="highlight language-python"><span class=n>CONTROL_OBJECTIVE_HEADER</span> <span class=o>=</span> <span class=s1>&#39;## Control Objective&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.CONTROL_OBJECTIVE_HEADER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.CONTROL_ORIGINATION class="doc doc-heading"> <code class="highlight language-python"><span class=n>CONTROL_ORIGINATION</span> <span class=o>=</span> <span class=s1>&#39;control-origination&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.CONTROL_ORIGINATION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.CONTROL_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>CONTROL_REGEX</span> <span class=o>=</span> <span class=s1>&#39;(?i)(?:##</span><span class=se>\\</span><span class=s1>s+Control</span><span class=se>\\</span><span class=s1>s+)(.*)&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.CONTROL_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.CONTROL_STATEMENT_HEADER class="doc doc-heading"> <code class="highlight language-python"><span class=n>CONTROL_STATEMENT_HEADER</span> <span class=o>=</span> <span class=s1>&#39;## Control Statement&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.CONTROL_STATEMENT_HEADER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.DAY_SECONDS class="doc doc-heading"> <code class="highlight language-python"><span class=n>DAY_SECONDS</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>24</span> <span class=o>*</span> <span class=n>HOUR_SECONDS</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.DAY_SECONDS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.DISPLAY_NAME class="doc doc-heading"> <code class="highlight language-python"><span class=n>DISPLAY_NAME</span> <span class=o>=</span> <span class=s1>&#39;display-name&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.DISPLAY_NAME class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.DISPLAY_VERBOSE_OUTPUT class="doc doc-heading"> <code class="highlight language-python"><span class=n>DISPLAY_VERBOSE_OUTPUT</span> <span class=o>=</span> <span class=s1>&#39;Display verbose output&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.DISPLAY_VERBOSE_OUTPUT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.DRAWIO_FILE_EXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>DRAWIO_FILE_EXT</span> <span class=o>=</span> <span class=s1>&#39;.drawio&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.DRAWIO_FILE_EXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.EDITABLE_CONTENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>EDITABLE_CONTENT</span> <span class=o>=</span> <span class=s1>&#39;Editable Content&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.EDITABLE_CONTENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ELEMENT_WILDCARD class="doc doc-heading"> <code class="highlight language-python"><span class=n>ELEMENT_WILDCARD</span> <span class=o>=</span> <span class=s1>&#39;*&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ELEMENT_WILDCARD class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.FIELDS_SET class="doc doc-heading"> <code class="highlight language-python"><span class=n>FIELDS_SET</span> <span class=o>=</span> <span class=s1>&#39;__fields_set__&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.FIELDS_SET class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.FILE_DIGIT_PREFIX_LENGTH class="doc doc-heading"> <code class="highlight language-python"><span class=n>FILE_DIGIT_PREFIX_LENGTH</span> <span class=o>=</span> <span class=mi>5</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.FILE_DIGIT_PREFIX_LENGTH class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.FILE_ENCODING class="doc doc-heading"> <code class="highlight language-python"><span class=n>FILE_ENCODING</span> <span class=o>=</span> <span class=s1>&#39;utf8&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.FILE_ENCODING class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.FILE_URI class="doc doc-heading"> <code class="highlight language-python"><span class=n>FILE_URI</span> <span class=o>=</span> <span class=s1>&#39;file:///&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.FILE_URI class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.FILTER_BY_COMPONENTS class="doc doc-heading"> <code class="highlight language-python"><span class=n>FILTER_BY_COMPONENTS</span> <span class=o>=</span> <span class=s1>&#39;filter-by-components&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.FILTER_BY_COMPONENTS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.FILTER_BY_PROFILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>FILTER_BY_PROFILE</span> <span class=o>=</span> <span class=s1>&#39;filter-by-profile&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.FILTER_BY_PROFILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.FILTER_EXCLUDE_COMPONENTS class="doc doc-heading"> <code class="highlight language-python"><span class=n>FILTER_EXCLUDE_COMPONENTS</span> <span class=o>=</span> <span class=s1>&#39;filter-exclude-components&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.FILTER_EXCLUDE_COMPONENTS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.GENERATE_RESOLVED_CATALOG class="doc doc-heading"> <code class="highlight language-python"><span class=n>GENERATE_RESOLVED_CATALOG</span> <span class=o>=</span> <span class=s1>&#39;generate-resolved-catalog&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.GENERATE_RESOLVED_CATALOG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.GUIDELINES class="doc doc-heading"> <code class="highlight language-python"><span class=n>GUIDELINES</span> <span class=o>=</span> <span class=s1>&#39;guidelines&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.GUIDELINES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HEADER_RULE_ID class="doc doc-heading"> <code class="highlight language-python"><span class=n>HEADER_RULE_ID</span> <span class=o>=</span> <span class=s1>&#39;rule-id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HEADER_RULE_ID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_ALLOWED_SECTIONS class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_ALLOWED_SECTIONS</span> <span class=o>=</span> <span class=s1>&#39;Short names of sections that are allowed to be in the assembled model, comma-separated&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_ALLOWED_SECTIONS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_COMPDEFS class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_COMPDEFS</span> <span class=o>=</span> <span class=s1>&#39;Comma-separated list of component-definitions for the ssp.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_COMPDEFS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_FO_OUTPUT class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_FO_OUTPUT</span> <span class=o>=</span> <span class=s1>&#39;Overwrites the content of all markdowns in the output folder.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_FO_OUTPUT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_INCLUDE_ALL_PARTS class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_INCLUDE_ALL_PARTS</span> <span class=o>=</span> <span class=s1>&#39;Include all control parts when generating SSP markdown.&#39;</span> <span class=o>+</span> <span class=s1>&#39; By default, only controls and parts with an attached rule will be written out.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_INCLUDE_ALL_PARTS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_LEVERAGED class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_LEVERAGED</span> <span class=o>=</span> <span class=s1>&#39;Name of the SSP to be leveraged.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_LEVERAGED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_MARKDOWN_NAME class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_MARKDOWN_NAME</span> <span class=o>=</span> <span class=s1>&#39;Name of the output generated profile markdown folder&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_MARKDOWN_NAME class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_OVERWRITE_HEADER_VALUES class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_OVERWRITE_HEADER_VALUES</span> <span class=o>=</span> <span class=s1>&#39;Flag to overwrite values in a markdown control header.&#39;</span> <span class=o>+</span> <span class=s1>&#39; If a separate yaml header is passed in with -y, any items in the markdown header that are common with the&#39;</span> <span class=o>+</span> <span class=s1>&#39; provided header will be overwritten by the new values. But new items passed in will always be added to the&#39;</span> <span class=o>+</span> <span class=s1>&#39; markdown header.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_OVERWRITE_HEADER_VALUES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_REGENERATE class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_REGENERATE</span> <span class=o>=</span> <span class=s1>&#39;Flag to force generation of new uuids in the model&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_REGENERATE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_REQUIRED_SECTIONS class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_REQUIRED_SECTIONS</span> <span class=o>=</span> <span class=s1>&#39;Short names of sections that must be in the assembled model, comma-separated&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_REQUIRED_SECTIONS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_SECTIONS class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_SECTIONS</span> <span class=o>=</span> <span class=s1>&#39;Comma-separated list of sections as short_name_no_spaces:long name with spaces&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_SECTIONS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_SET_PARAMS class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_SET_PARAMS</span> <span class=o>=</span> <span class=s1>&#39;set parameters and properties based on the yaml header in control markdown&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_SET_PARAMS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_VERSION class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_VERSION</span> <span class=o>=</span> <span class=s1>&#39;New version for the assembled model&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_VERSION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HELP_YAML_PATH class="doc doc-heading"> <code class="highlight language-python"><span class=n>HELP_YAML_PATH</span> <span class=o>=</span> <span class=s1>&#39;Path to the optional yaml header file&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HELP_YAML_PATH class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HOUR_SECONDS class="doc doc-heading"> <code class="highlight language-python"><span class=n>HOUR_SECONDS</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>3600</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HOUR_SECONDS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HREF class="doc doc-heading"> <code class="highlight language-python"><span class=n>HREF</span> <span class=o>=</span> <span class=s1>&#39;href&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HREF class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.HTTPS_URI class="doc doc-heading"> <code class="highlight language-python"><span class=n>HTTPS_URI</span> <span class=o>=</span> <span class=s1>&#39;https://&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.HTTPS_URI class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IDX_SEP class="doc doc-heading"> <code class="highlight language-python"><span class=n>IDX_SEP</span> <span class=o>=</span> <span class=s1>&#39;__&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IDX_SEP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IMPLEMENTATION_POINT class="doc doc-heading"> <code class="highlight language-python"><span class=n>IMPLEMENTATION_POINT</span> <span class=o>=</span> <span class=s1>&#39;implementation-point&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IMPLEMENTATION_POINT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IMPLEMENTATION_POINT_EXTERNAL class="doc doc-heading"> <code class="highlight language-python"><span class=n>IMPLEMENTATION_POINT_EXTERNAL</span> <span class=o>=</span> <span class=s1>&#39;external&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IMPLEMENTATION_POINT_EXTERNAL class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IMPLEMENTATION_STATUS class="doc doc-heading"> <code class="highlight language-python"><span class=n>IMPLEMENTATION_STATUS</span> <span class=o>=</span> <span class=s1>&#39;implementation-status&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IMPLEMENTATION_STATUS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IMPLEMENTATION_STATUS_HEADER class="doc doc-heading"> <code class="highlight language-python"><span class=n>IMPLEMENTATION_STATUS_HEADER</span> <span class=o>=</span> <span class=s1>&#39;Implementation Status&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IMPLEMENTATION_STATUS_HEADER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IMPLEMENTATION_STATUS_REMARKS_HEADER class="doc doc-heading"> <code class="highlight language-python"><span class=n>IMPLEMENTATION_STATUS_REMARKS_HEADER</span> <span class=o>=</span> <span class=s1>&#39;Implementation Status Remarks&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IMPLEMENTATION_STATUS_REMARKS_HEADER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IMPLEMENTED_REQUIREMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>IMPLEMENTED_REQUIREMENT</span> <span class=o>=</span> <span class=s1>&#39;implemented-requirement&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IMPLEMENTED_REQUIREMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INHERITANCE_VIEW_DIR class="doc doc-heading"> <code class="highlight language-python"><span class=n>INHERITANCE_VIEW_DIR</span> <span class=o>=</span> <span class=s1>&#39;inheritance&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INHERITANCE_VIEW_DIR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INHERITED_UUID class="doc doc-heading"> <code class="highlight language-python"><span class=n>INHERITED_UUID</span> <span class=o>=</span> <span class=s1>&#39;inherited-uuid&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INHERITED_UUID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INIT_FULL_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>INIT_FULL_HELP</span> <span class=o>=</span> <span class=s1>&#39;Initializes Trestle workspace for local, API and governed documents usage.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INIT_FULL_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INIT_FULL_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>INIT_FULL_LONG</span> <span class=o>=</span> <span class=s1>&#39;--full&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INIT_FULL_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INIT_FULL_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>INIT_FULL_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-fl&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INIT_FULL_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INIT_GOVDOCS_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>INIT_GOVDOCS_HELP</span> <span class=o>=</span> <span class=s1>&#39;Initializes Trestle workspace for governed documents usage only.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INIT_GOVDOCS_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INIT_GOVDOCS_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>INIT_GOVDOCS_LONG</span> <span class=o>=</span> <span class=s1>&#39;--govdocs&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INIT_GOVDOCS_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INIT_GOVDOCS_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>INIT_GOVDOCS_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-gd&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INIT_GOVDOCS_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INIT_LOCAL_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>INIT_LOCAL_HELP</span> <span class=o>=</span> <span class=s1>&#39;Initializes Trestle workspace for local management of OSCAL models.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INIT_LOCAL_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INIT_LOCAL_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>INIT_LOCAL_LONG</span> <span class=o>=</span> <span class=s1>&#39;--local&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INIT_LOCAL_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.INIT_LOCAL_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>INIT_LOCAL_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-loc&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.INIT_LOCAL_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IOF_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>IOF_HELP</span> <span class=o>=</span> <span class=s1>&#39;Include fields that are optional in the OSCAL model when generating the new object.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IOF_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IOF_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>IOF_LONG</span> <span class=o>=</span> <span class=s1>&#39;--include-optional-fields&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IOF_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.IOF_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>IOF_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-iof&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.IOF_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ITEM class="doc doc-heading"> <code class="highlight language-python"><span class=n>ITEM</span> <span class=o>=</span> <span class=s1>&#39;item&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ITEM class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.LABEL class="doc doc-heading"> <code class="highlight language-python"><span class=n>LABEL</span> <span class=o>=</span> <span class=s1>&#39;label&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.LABEL class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.LEVERAGED_SSP class="doc doc-heading"> <code class="highlight language-python"><span class=n>LEVERAGED_SSP</span> <span class=o>=</span> <span class=s1>&#39;leveraged-ssp&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.LEVERAGED_SSP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.LEV_AUTH_UUID class="doc doc-heading"> <code class="highlight language-python"><span class=n>LEV_AUTH_UUID</span> <span class=o>=</span> <span class=s1>&#39;leveraged-authorization-uuid&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.LEV_AUTH_UUID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MARKDOWN_FILE_EXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>MARKDOWN_FILE_EXT</span> <span class=o>=</span> <span class=s1>&#39;.md&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MARKDOWN_FILE_EXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MARKDOWN_URL_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>MARKDOWN_URL_REGEX</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\\</span><span class=s1>[([^</span><span class=se>\\</span><span class=s1>]]+)</span><span class=se>\\</span><span class=s1>]</span><span class=se>\\</span><span class=s1>(([^)]+)</span><span class=se>\\</span><span class=s1>)&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MARKDOWN_URL_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX</span> <span class=o>=</span> <span class=s1>&#39;[^a-zA-Z0-9-_ </span><span class=se>\n</span><span class=s1>]&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_DIR_A_PLAN class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_DIR_A_PLAN</span> <span class=o>=</span> <span class=s1>&#39;assessment-plans&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_DIR_A_PLAN class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_DIR_A_RESULT class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_DIR_A_RESULT</span> <span class=o>=</span> <span class=s1>&#39;assessment-results&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_DIR_A_RESULT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_DIR_CATALOG class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_DIR_CATALOG</span> <span class=o>=</span> <span class=s1>&#39;catalogs&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_DIR_CATALOG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_DIR_COMPDEF class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_DIR_COMPDEF</span> <span class=o>=</span> <span class=s1>&#39;component-definitions&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_DIR_COMPDEF class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_DIR_LIST class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_DIR_LIST</span> <span class=o>=</span> <span class=p>[</span><span class=n>MODEL_DIR_A_PLAN</span><span class=p>,</span> <span class=n>MODEL_DIR_A_RESULT</span><span class=p>,</span> <span class=n>MODEL_DIR_CATALOG</span><span class=p>,</span> <span class=n>MODEL_DIR_COMPDEF</span><span class=p>,</span> <span class=n>MODEL_DIR_POAM</span><span class=p>,</span> <span class=n>MODEL_DIR_PROFILE</span><span class=p>,</span> <span class=n>MODEL_DIR_SSP</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_DIR_LIST class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_DIR_POAM class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_DIR_POAM</span> <span class=o>=</span> <span class=s1>&#39;plan-of-action-and-milestones&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_DIR_POAM class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_DIR_PROFILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_DIR_PROFILE</span> <span class=o>=</span> <span class=s1>&#39;profiles&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_DIR_PROFILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_DIR_SSP class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_DIR_SSP</span> <span class=o>=</span> <span class=s1>&#39;system-security-plans&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_DIR_SSP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_DIR_TO_MODEL_MODULE class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_DIR_TO_MODEL_MODULE</span> <span class=o>=</span> <span class=p>{</span><span class=n>MODEL_DIR_A_PLAN</span><span class=p>:</span> <span class=n>MODEL_MODULE_A_PLAN</span><span class=p>,</span> <span class=n>MODEL_DIR_A_RESULT</span><span class=p>:</span> <span class=n>MODEL_MODULE_A_RESULT</span><span class=p>,</span> <span class=n>MODEL_DIR_CATALOG</span><span class=p>:</span> <span class=n>MODEL_MODULE_CATALOG</span><span class=p>,</span> <span class=n>MODEL_DIR_COMPDEF</span><span class=p>:</span> <span class=n>MODEL_MODULE_COMPDEF</span><span class=p>,</span> <span class=n>MODEL_DIR_POAM</span><span class=p>:</span> <span class=n>MODEL_MODULE_POAM</span><span class=p>,</span> <span class=n>MODEL_DIR_PROFILE</span><span class=p>:</span> <span class=n>MODEL_MODULE_PROFILE</span><span class=p>,</span> <span class=n>MODEL_DIR_SSP</span><span class=p>:</span> <span class=n>MODEL_MODULE_SSP</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_DIR_TO_MODEL_MODULE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Map of model type to oscal module.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_MODULE_A_PLAN class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_MODULE_A_PLAN</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PACKAGE_OSCAL</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>MODULE_NAME_A_PLAN</span><span class=si>}</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_MODULE_A_PLAN class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_MODULE_A_RESULT class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_MODULE_A_RESULT</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PACKAGE_OSCAL</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>MODULE_NAME_A_RESULT</span><span class=si>}</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_MODULE_A_RESULT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_MODULE_CATALOG class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_MODULE_CATALOG</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PACKAGE_OSCAL</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>MODULE_NAME_CATALOG</span><span class=si>}</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_MODULE_CATALOG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_MODULE_COMPDEF class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_MODULE_COMPDEF</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PACKAGE_OSCAL</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>MODULE_NAME_COMPDEF</span><span class=si>}</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_MODULE_COMPDEF class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_MODULE_LIST class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_MODULE_LIST</span> <span class=o>=</span> <span class=p>[</span><span class=n>MODEL_MODULE_A_PLAN</span><span class=p>,</span> <span class=n>MODEL_MODULE_A_RESULT</span><span class=p>,</span> <span class=n>MODEL_MODULE_CATALOG</span><span class=p>,</span> <span class=n>MODEL_MODULE_COMPDEF</span><span class=p>,</span> <span class=n>MODEL_MODULE_POAM</span><span class=p>,</span> <span class=n>MODEL_MODULE_PROFILE</span><span class=p>,</span> <span class=n>MODEL_MODULE_SSP</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_MODULE_LIST class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Map of plural form of a model type to the oscal module that contains the classes related to it.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_MODULE_POAM class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_MODULE_POAM</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PACKAGE_OSCAL</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>MODULE_NAME_POAM</span><span class=si>}</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_MODULE_POAM class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_MODULE_PROFILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_MODULE_PROFILE</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PACKAGE_OSCAL</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>MODULE_NAME_PROFILE</span><span class=si>}</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_MODULE_PROFILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_MODULE_SSP class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_MODULE_SSP</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PACKAGE_OSCAL</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>MODULE_NAME_SSP</span><span class=si>}</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_MODULE_SSP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_MODULE_TO_MODEL_TYPE class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_MODULE_TO_MODEL_TYPE</span> <span class=o>=</span> <span class=p>{</span><span class=n>MODEL_MODULE_A_PLAN</span><span class=p>:</span> <span class=n>MODEL_TYPE_A_PLAN</span><span class=p>,</span> <span class=n>MODEL_MODULE_A_RESULT</span><span class=p>:</span> <span class=n>MODEL_TYPE_A_RESULT</span><span class=p>,</span> <span class=n>MODEL_MODULE_CATALOG</span><span class=p>:</span> <span class=n>MODEL_TYPE_CATALOG</span><span class=p>,</span> <span class=n>MODEL_MODULE_COMPDEF</span><span class=p>:</span> <span class=n>MODEL_TYPE_COMPDEF</span><span class=p>,</span> <span class=n>MODEL_MODULE_POAM</span><span class=p>:</span> <span class=n>MODEL_TYPE_POAM</span><span class=p>,</span> <span class=n>MODEL_MODULE_PROFILE</span><span class=p>:</span> <span class=n>MODEL_TYPE_PROFILE</span><span class=p>,</span> <span class=n>MODEL_MODULE_SSP</span><span class=p>:</span> <span class=n>MODEL_TYPE_SSP</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_MODULE_TO_MODEL_TYPE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Map of model type to model directory.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_A_PLAN class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_A_PLAN</span> <span class=o>=</span> <span class=s1>&#39;assessment-plan&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_A_PLAN class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_A_RESULT class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_A_RESULT</span> <span class=o>=</span> <span class=s1>&#39;assessment-results&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_A_RESULT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_CATALOG class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_CATALOG</span> <span class=o>=</span> <span class=s1>&#39;catalog&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_CATALOG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_COMPDEF class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_COMPDEF</span> <span class=o>=</span> <span class=s1>&#39;component-definition&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_COMPDEF class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_LIST class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_LIST</span> <span class=o>=</span> <span class=p>[</span><span class=n>MODEL_TYPE_A_PLAN</span><span class=p>,</span> <span class=n>MODEL_TYPE_A_RESULT</span><span class=p>,</span> <span class=n>MODEL_TYPE_CATALOG</span><span class=p>,</span> <span class=n>MODEL_TYPE_COMPDEF</span><span class=p>,</span> <span class=n>MODEL_TYPE_POAM</span><span class=p>,</span> <span class=n>MODEL_TYPE_PROFILE</span><span class=p>,</span> <span class=n>MODEL_TYPE_SSP</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_LIST class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_POAM class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_POAM</span> <span class=o>=</span> <span class=s1>&#39;plan-of-action-and-milestones&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_POAM class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_PROFILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_PROFILE</span> <span class=o>=</span> <span class=s1>&#39;profile&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_PROFILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_SSP class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_SSP</span> <span class=o>=</span> <span class=s1>&#39;system-security-plan&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_SSP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_TO_MODEL_DIR class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_TO_MODEL_DIR</span> <span class=o>=</span> <span class=p>{</span><span class=n>MODEL_TYPE_A_PLAN</span><span class=p>:</span> <span class=n>MODEL_DIR_A_PLAN</span><span class=p>,</span> <span class=n>MODEL_TYPE_A_RESULT</span><span class=p>:</span> <span class=n>MODEL_DIR_A_RESULT</span><span class=p>,</span> <span class=n>MODEL_TYPE_CATALOG</span><span class=p>:</span> <span class=n>MODEL_DIR_CATALOG</span><span class=p>,</span> <span class=n>MODEL_TYPE_COMPDEF</span><span class=p>:</span> <span class=n>MODEL_DIR_COMPDEF</span><span class=p>,</span> <span class=n>MODEL_TYPE_POAM</span><span class=p>:</span> <span class=n>MODEL_DIR_POAM</span><span class=p>,</span> <span class=n>MODEL_TYPE_PROFILE</span><span class=p>:</span> <span class=n>MODEL_DIR_PROFILE</span><span class=p>,</span> <span class=n>MODEL_TYPE_SSP</span><span class=p>:</span> <span class=n>MODEL_DIR_SSP</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_TO_MODEL_DIR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Element path separator</p> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODEL_TYPE_TO_MODEL_MODULE class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODEL_TYPE_TO_MODEL_MODULE</span> <span class=o>=</span> <span class=p>{</span><span class=n>MODEL_TYPE_A_PLAN</span><span class=p>:</span> <span class=n>MODEL_MODULE_A_PLAN</span><span class=p>,</span> <span class=n>MODEL_TYPE_A_RESULT</span><span class=p>:</span> <span class=n>MODEL_MODULE_A_RESULT</span><span class=p>,</span> <span class=n>MODEL_TYPE_CATALOG</span><span class=p>:</span> <span class=n>MODEL_MODULE_CATALOG</span><span class=p>,</span> <span class=n>MODEL_TYPE_COMPDEF</span><span class=p>:</span> <span class=n>MODEL_MODULE_COMPDEF</span><span class=p>,</span> <span class=n>MODEL_TYPE_POAM</span><span class=p>:</span> <span class=n>MODEL_MODULE_POAM</span><span class=p>,</span> <span class=n>MODEL_TYPE_PROFILE</span><span class=p>:</span> <span class=n>MODEL_MODULE_PROFILE</span><span class=p>,</span> <span class=n>MODEL_TYPE_SSP</span><span class=p>:</span> <span class=n>MODEL_MODULE_SSP</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODEL_TYPE_TO_MODEL_MODULE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Map of model module to model type.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODULE_NAME_A_PLAN class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODULE_NAME_A_PLAN</span> <span class=o>=</span> <span class=s1>&#39;assessment_plan&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODULE_NAME_A_PLAN class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODULE_NAME_A_RESULT class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODULE_NAME_A_RESULT</span> <span class=o>=</span> <span class=s1>&#39;assessment_results&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODULE_NAME_A_RESULT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODULE_NAME_CATALOG class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODULE_NAME_CATALOG</span> <span class=o>=</span> <span class=s1>&#39;catalog&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODULE_NAME_CATALOG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODULE_NAME_COMPDEF class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODULE_NAME_COMPDEF</span> <span class=o>=</span> <span class=s1>&#39;component&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODULE_NAME_COMPDEF class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODULE_NAME_POAM class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODULE_NAME_POAM</span> <span class=o>=</span> <span class=s1>&#39;poam&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODULE_NAME_POAM class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODULE_NAME_PROFILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODULE_NAME_PROFILE</span> <span class=o>=</span> <span class=s1>&#39;profile&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODULE_NAME_PROFILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.MODULE_NAME_SSP class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODULE_NAME_SSP</span> <span class=o>=</span> <span class=s1>&#39;ssp&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.MODULE_NAME_SSP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.NAME class="doc doc-heading"> <code class="highlight language-python"><span class=n>NAME</span> <span class=o>=</span> <span class=s1>&#39;name&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.NAME class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.NAMESPACE_FEDRAMP class="doc doc-heading"> <code class="highlight language-python"><span class=n>NAMESPACE_FEDRAMP</span> <span class=o>=</span> <span class=s1>&#39;https://fedramp.gov/ns/oscal&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.NAMESPACE_FEDRAMP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.NAMESPACE_NIST class="doc doc-heading"> <code class="highlight language-python"><span class=n>NAMESPACE_NIST</span> <span class=o>=</span> <span class=s1>&#39;https://csrc.nist.gov/ns/oscal&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.NAMESPACE_NIST class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.NCNAME_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>NCNAME_REGEX</span> <span class=o>=</span> <span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.NCNAME_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.NCNAME_UTF8_FIRST_CHAR_OPTIONS class="doc doc-heading"> <code class="highlight language-python"><span class=n>NCNAME_UTF8_FIRST_CHAR_OPTIONS</span> <span class=o>=</span> <span class=n>string</span><span class=o>.</span><span class=n>ascii_letters</span> <span class=o>+</span> <span class=s1>&#39;_&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.NCNAME_UTF8_FIRST_CHAR_OPTIONS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.NCNAME_UTF8_OTHER_CHAR_OPTIONS class="doc doc-heading"> <code class="highlight language-python"><span class=n>NCNAME_UTF8_OTHER_CHAR_OPTIONS</span> <span class=o>=</span> <span class=n>string</span><span class=o>.</span><span class=n>ascii_letters</span> <span class=o>+</span> <span class=n>string</span><span class=o>.</span><span class=n>digits</span> <span class=o>+</span> <span class=s1>&#39;_.-&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.NCNAME_UTF8_OTHER_CHAR_OPTIONS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.OBJECTIVE_PART class="doc doc-heading"> <code class="highlight language-python"><span class=n>OBJECTIVE_PART</span> <span class=o>=</span> <span class=s1>&#39;objective&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.OBJECTIVE_PART class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ONE class="doc doc-heading"> <code class="highlight language-python"><span class=n>ONE</span> <span class=o>=</span> <span class=s1>&#39;one&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ONE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ONE_OR_MORE_HYPHENED class="doc doc-heading"> <code class="highlight language-python"><span class=n>ONE_OR_MORE_HYPHENED</span> <span class=o>=</span> <span class=s1>&#39;one-or-more&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ONE_OR_MORE_HYPHENED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ONE_OR_MORE_SPACED class="doc doc-heading"> <code class="highlight language-python"><span class=n>ONE_OR_MORE_SPACED</span> <span class=o>=</span> <span class=s1>&#39;one or more&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ONE_OR_MORE_SPACED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ORIGINATION_CUSTOMER_CONFIGURED class="doc doc-heading"> <code class="highlight language-python"><span class=n>ORIGINATION_CUSTOMER_CONFIGURED</span> <span class=o>=</span> <span class=s1>&#39;customer-configured&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ORIGINATION_CUSTOMER_CONFIGURED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ORIGINATION_CUSTOMER_PROVIDED class="doc doc-heading"> <code class="highlight language-python"><span class=n>ORIGINATION_CUSTOMER_PROVIDED</span> <span class=o>=</span> <span class=s1>&#39;customer-provided&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ORIGINATION_CUSTOMER_PROVIDED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ORIGINATION_INHERITED class="doc doc-heading"> <code class="highlight language-python"><span class=n>ORIGINATION_INHERITED</span> <span class=o>=</span> <span class=s1>&#39;inherited&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ORIGINATION_INHERITED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ORIGINATION_ORGANIZATION class="doc doc-heading"> <code class="highlight language-python"><span class=n>ORIGINATION_ORGANIZATION</span> <span class=o>=</span> <span class=s1>&#39;organization&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ORIGINATION_ORGANIZATION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ORIGINATION_SYSTEM_SPECIFIC class="doc doc-heading"> <code class="highlight language-python"><span class=n>ORIGINATION_SYSTEM_SPECIFIC</span> <span class=o>=</span> <span class=s1>&#39;system-specific&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ORIGINATION_SYSTEM_SPECIFIC class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PACKAGE_OSCAL class="doc doc-heading"> <code class="highlight language-python"><span class=n>PACKAGE_OSCAL</span> <span class=o>=</span> <span class=s1>&#39;trestle.oscal&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PACKAGE_OSCAL class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PARAMETER_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAMETER_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Parameter_Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PARAMETER_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PARAMETER_ID class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAMETER_ID</span> <span class=o>=</span> <span class=s1>&#39;Parameter_Id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PARAMETER_ID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PARAMETER_VALUE_ALTERNATIVES class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAMETER_VALUE_ALTERNATIVES</span> <span class=o>=</span> <span class=s1>&#39;Parameter_Value_Alternatives&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PARAMETER_VALUE_ALTERNATIVES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PARAM_VALUES_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAM_VALUES_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;param-values&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PARAM_VALUES_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PARAM_VALUE_ORIGIN class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAM_VALUE_ORIGIN</span> <span class=o>=</span> <span class=s1>&#39;param-value-origin&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PARAM_VALUE_ORIGIN class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PART_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>PART_REGEX</span> <span class=o>=</span> <span class=s1>&#39;(?i)(?:##</span><span class=se>\\</span><span class=s1>s+part</span><span class=se>\\</span><span class=s1>s+)(.*)&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PART_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PROFILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROFILE</span> <span class=o>=</span> <span class=s1>&#39;profile&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PROFILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT</span> <span class=o>=</span> <span class=s1>&#39;&lt;!-- Add prose here for required Section&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PROFILE_PARAM_VALUE_ORIGIN class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span> <span class=o>=</span> <span class=s1>&#39;profile-param-value-origin&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PROFILE_PARAM_VALUE_ORIGIN class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PROFILE_VALUES class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROFILE_VALUES</span> <span class=o>=</span> <span class=s1>&#39;profile-values&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PROFILE_VALUES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PROPERTY_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROPERTY_REGEX</span> <span class=o>=</span> <span class=s1>&#39;(?:###</span><span class=se>\\</span><span class=s1>s+Property</span><span class=se>\\</span><span class=s1>s+)([^</span><span class=se>\\</span><span class=s1>s]*)</span><span class=se>\\</span><span class=s1>s*:</span><span class=se>\\</span><span class=s1>s+(.*)&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PROPERTY_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PROVIDED_STATEMENT_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROVIDED_STATEMENT_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Provided Statement Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PROVIDED_STATEMENT_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.PROVIDED_UUID class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROVIDED_UUID</span> <span class=o>=</span> <span class=s1>&#39;provided-uuid&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.PROVIDED_UUID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.REMARKS class="doc doc-heading"> <code class="highlight language-python"><span class=n>REMARKS</span> <span class=o>=</span> <span class=s1>&#39;Remarks&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.REMARKS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.REPLACE_ME class="doc doc-heading"> <code class="highlight language-python"><span class=n>REPLACE_ME</span> <span class=o>=</span> <span class=s1>&#39;REPLACE_ME&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.REPLACE_ME class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.REPLACE_ME_PLACEHOLDER class="doc doc-heading"> <code class="highlight language-python"><span class=n>REPLACE_ME_PLACEHOLDER</span> <span class=o>=</span> <span class=s1>&#39;&lt;REPLACE_ME&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.REPLACE_ME_PLACEHOLDER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.RESOLUTION_SOURCE class="doc doc-heading"> <code class="highlight language-python"><span class=n>RESOLUTION_SOURCE</span> <span class=o>=</span> <span class=s1>&#39;resolution-source&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.RESOLUTION_SOURCE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.RESPONSIBILITY_STATEMENT_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>RESPONSIBILITY_STATEMENT_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Responsibility Statement Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.RESPONSIBILITY_STATEMENT_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.RESPONSIBILITY_UUID class="doc doc-heading"> <code class="highlight language-python"><span class=n>RESPONSIBILITY_UUID</span> <span class=o>=</span> <span class=s1>&#39;responsibility-uuid&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.RESPONSIBILITY_UUID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.RESPONSIBLE_ROLE class="doc doc-heading"> <code class="highlight language-python"><span class=n>RESPONSIBLE_ROLE</span> <span class=o>=</span> <span class=s1>&#39;responsible-role&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.RESPONSIBLE_ROLE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.RESPONSIBLE_ROLES class="doc doc-heading"> <code class="highlight language-python"><span class=n>RESPONSIBLE_ROLES</span> <span class=o>=</span> <span class=s1>&#39;responsible-roles&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.RESPONSIBLE_ROLES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.ROOT class="doc doc-heading"> <code class="highlight language-python"><span class=n>ROOT</span> <span class=o>=</span> <span class=s1>&#39;__root__&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.ROOT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.RULES_PARAMS_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>RULES_PARAMS_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;rules-params&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.RULES_PARAMS_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.RULES_WARNING class="doc doc-heading"> <code class="highlight language-python"><span class=n>RULES_WARNING</span> <span class=o>=</span> <span class=s1>&#39;&lt;!-- Note that the list of rules under ### Rules: is read-only and changes will not be captured after assembly to JSON --&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.RULES_WARNING class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.RULE_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>RULE_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Rule_Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.RULE_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.RULE_ID class="doc doc-heading"> <code class="highlight language-python"><span class=n>RULE_ID</span> <span class=o>=</span> <span class=s1>&#39;Rule_Id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.RULE_ID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SAMPLE_UUID_STR class="doc doc-heading"> <code class="highlight language-python"><span class=n>SAMPLE_UUID_STR</span> <span class=o>=</span> <span class=s1>&#39;A0000000-0000-4000-8000-000000000000&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SAMPLE_UUID_STR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SATISFIED_STATEMENT_COMMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>SATISFIED_STATEMENT_COMMENT</span> <span class=o>=</span> <span class=s1>&#39;&lt;!-- Use this section to explain how the inherited responsibility is being satisfied. --&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SATISFIED_STATEMENT_COMMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SATISFIED_STATEMENT_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>SATISFIED_STATEMENT_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Satisfied Statement Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SATISFIED_STATEMENT_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SECTIONS_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>SECTIONS_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;sections&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SECTIONS_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SET_PARAMS_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>SET_PARAMS_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;set-params&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SET_PARAMS_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SFTP_URI class="doc doc-heading"> <code class="highlight language-python"><span class=n>SFTP_URI</span> <span class=o>=</span> <span class=s1>&#39;sftp://&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SFTP_URI class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SORT_ID class="doc doc-heading"> <code class="highlight language-python"><span class=n>SORT_ID</span> <span class=o>=</span> <span class=s1>&#39;sort-id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SORT_ID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT</span> <span class=o>=</span> <span class=n>SSP_ADD_IMPLEMENTATION_PREFIX</span> <span class=o>+</span> <span class=s1>&#39;control&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT</span> <span class=o>=</span> <span class=n>SSP_ADD_IMPLEMENTATION_PREFIX</span> <span class=o>+</span> <span class=n>ITEM</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_STATEMENT_TEXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_ADD_IMPLEMENTATION_FOR_STATEMENT_TEXT</span> <span class=o>=</span> <span class=n>SSP_ADD_IMPLEMENTATION_PREFIX</span> <span class=o>+</span> <span class=n>STATEMENT</span> <span class=o>+</span> <span class=n>CLOSE_COMMENT</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_STATEMENT_TEXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_ADD_IMPLEMENTATION_PREFIX class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_ADD_IMPLEMENTATION_PREFIX</span> <span class=o>=</span> <span class=s1>&#39;&lt;!-- Add control implementation description here for &#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_ADD_IMPLEMENTATION_PREFIX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;&lt;!-- Add implementation prose for the main </span><span class=si>{</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=si>}</span><span class=s1> component for control&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_FEDRAMP_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_FEDRAMP_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;fedramp-props&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_FEDRAMP_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_MAIN_COMP_NAME class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_MAIN_COMP_NAME</span> <span class=o>=</span> <span class=s1>&#39;This System&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_MAIN_COMP_NAME class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_MD_HRULE_LINE class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_MD_HRULE_LINE</span> <span class=o>=</span> <span class=s1>&#39;______________________________________________________________________&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_MD_HRULE_LINE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_MD_IMPLEMENTATION_QUESTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_MD_IMPLEMENTATION_QUESTION</span> <span class=o>=</span> <span class=s1>&#39;What is the solution and how is it implemented?&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_MD_IMPLEMENTATION_QUESTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_MD_LEAVE_BLANK_TEXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_MD_LEAVE_BLANK_TEXT</span> <span class=o>=</span> <span class=s1>&#39;&lt;!-- Please leave this section blank and enter implementation details in the parts below. --&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_MD_LEAVE_BLANK_TEXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT</span> <span class=o>=</span> <span class=s1>&#39;This is the control implementation for the system.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.SSP_VALUES class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP_VALUES</span> <span class=o>=</span> <span class=s1>&#39;ssp-values&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.SSP_VALUES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATEMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATEMENT</span> <span class=o>=</span> <span class=s1>&#39;statement&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATEMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_ALL class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_ALL</span> <span class=o>=</span> <span class=p>[</span><span class=n>STATUS_IMPLEMENTED</span><span class=p>,</span> <span class=n>STATUS_PARTIAL</span><span class=p>,</span> <span class=n>STATUS_PARTIALLY_IMPLEMENTED</span><span class=p>,</span> <span class=n>STATUS_PLANNED</span><span class=p>,</span> <span class=n>STATUS_ALTERNATIVE</span><span class=p>,</span> <span class=n>STATUS_NOT_APPLICABLE</span><span class=p>,</span> <span class=n>STATUS_OPERATIONAL</span><span class=p>,</span> <span class=n>STATUS_UNDER_DEVELOPMENT</span><span class=p>,</span> <span class=n>STATUS_DISPOSITION</span><span class=p>,</span> <span class=n>STATUS_OTHER</span><span class=p>,</span> <span class=n>STATUS_UNDER_MAJOR_MODIFICATION</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_ALL class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_ALTERNATIVE class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_ALTERNATIVE</span> <span class=o>=</span> <span class=s1>&#39;alternative&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_ALTERNATIVE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_COMPLETION_DATE class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_COMPLETION_DATE</span> <span class=o>=</span> <span class=s1>&#39;completion-date&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_COMPLETION_DATE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_DISPOSITION class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_DISPOSITION</span> <span class=o>=</span> <span class=s1>&#39;disposition&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_DISPOSITION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_IMPLEMENTED class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_IMPLEMENTED</span> <span class=o>=</span> <span class=s1>&#39;implemented&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_IMPLEMENTED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_INHERITED class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_INHERITED</span> <span class=o>=</span> <span class=s1>&#39;inherited&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_INHERITED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_NOT_APPLICABLE class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_NOT_APPLICABLE</span> <span class=o>=</span> <span class=s1>&#39;not-applicable&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_NOT_APPLICABLE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_OPERATIONAL class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_OPERATIONAL</span> <span class=o>=</span> <span class=s1>&#39;operational&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_OPERATIONAL class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_OTHER class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_OTHER</span> <span class=o>=</span> <span class=s1>&#39;other&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_OTHER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_PARTIAL class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_PARTIAL</span> <span class=o>=</span> <span class=s1>&#39;partial&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_PARTIAL class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_PARTIALLY_IMPLEMENTED class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_PARTIALLY_IMPLEMENTED</span> <span class=o>=</span> <span class=s1>&#39;partially-implemented&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_PARTIALLY_IMPLEMENTED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_PLANNED class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_PLANNED</span> <span class=o>=</span> <span class=s1>&#39;planned&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_PLANNED class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_PLANNED_COMPLETION_DATE class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_PLANNED_COMPLETION_DATE</span> <span class=o>=</span> <span class=s1>&#39;planned-completion-date&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_PLANNED_COMPLETION_DATE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_PROMPT class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_PROMPT</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;&lt;!-- For implementation status enter one of: </span><span class=si>{</span><span class=n>STATUS_IMPLEMENTED</span><span class=si>}</span><span class=s1>, </span><span class=si>{</span><span class=n>STATUS_PARTIAL</span><span class=si>}</span><span class=s1>, </span><span class=si>{</span><span class=n>STATUS_PLANNED</span><span class=si>}</span><span class=s1>, </span><span class=si>{</span><span class=n>STATUS_ALTERNATIVE</span><span class=si>}</span><span class=s1>, </span><span class=si>{</span><span class=n>STATUS_NOT_APPLICABLE</span><span class=si>}</span><span class=s1> --&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_PROMPT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_REMARKS class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_REMARKS</span> <span class=o>=</span> <span class=s1>&#39;status-remarks&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_REMARKS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_UNDER_DEVELOPMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_UNDER_DEVELOPMENT</span> <span class=o>=</span> <span class=s1>&#39;under-development&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_UNDER_DEVELOPMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.STATUS_UNDER_MAJOR_MODIFICATION class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATUS_UNDER_MAJOR_MODIFICATION</span> <span class=o>=</span> <span class=s1>&#39;under-major-modification&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.STATUS_UNDER_MAJOR_MODIFICATION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TABLE_OF_PARAMS_PART class="doc doc-heading"> <code class="highlight language-python"><span class=n>TABLE_OF_PARAMS_PART</span> <span class=o>=</span> <span class=s1>&#39;table_of_parameters&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TABLE_OF_PARAMS_PART class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TEMPLATE_VERSION_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>TEMPLATE_VERSION_REGEX</span> <span class=o>=</span> <span class=s1>&#39;[0-9]+.[0-9]+.[0-9]+&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TEMPLATE_VERSION_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.THIS_SYSTEM_AS_KEY class="doc doc-heading"> <code class="highlight language-python"><span class=n>THIS_SYSTEM_AS_KEY</span> <span class=o>=</span> <span class=s1>&#39;this-system&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.THIS_SYSTEM_AS_KEY class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.THIS_SYSTEM_PROMPT class="doc doc-heading"> <code class="highlight language-python"><span class=n>THIS_SYSTEM_PROMPT</span> <span class=o>=</span> <span class=s1>&#39;### &#39;</span> <span class=o>+</span> <span class=n>SSP_MAIN_COMP_NAME</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.THIS_SYSTEM_PROMPT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TITLE class="doc doc-heading"> <code class="highlight language-python"><span class=n>TITLE</span> <span class=o>=</span> <span class=s1>&#39;title&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TITLE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRANSFORM_TYPES class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRANSFORM_TYPES</span> <span class=o>=</span> <span class=p>[</span><span class=n>FILTER_BY_PROFILE</span><span class=p>,</span> <span class=n>FILTER_BY_COMPONENTS</span><span class=p>,</span> <span class=n>FILTER_EXCLUDE_COMPONENTS</span><span class=p>,</span> <span class=n>GENERATE_RESOLVED_CATALOG</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRANSFORM_TYPES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_ADD_PROPS_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_ADD_PROPS_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;add-props&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_ADD_PROPS_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_CACHE_DIR class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_CACHE_DIR</span> <span class=o>=</span> <span class=n>TRESTLE_CONFIG_DIR</span> <span class=o>+</span> <span class=s1>&#39;/cache&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_CACHE_DIR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_CONFIG_DIR class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_CONFIG_DIR</span> <span class=o>=</span> <span class=s1>&#39;.trestle&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_CONFIG_DIR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_CONFIG_FILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_CONFIG_FILE</span> <span class=o>=</span> <span class=s1>&#39;config.ini&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_CONFIG_FILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_DIST_DIR class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_DIST_DIR</span> <span class=o>=</span> <span class=s1>&#39;dist&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_DIST_DIR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_GENERIC_NS class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_GENERIC_NS</span> <span class=o>=</span> <span class=s1>&#39;https://oscal-compass.github.io/compliance-trestle/schemas/oscal&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_GENERIC_NS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_GLOBAL_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_GLOBAL_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;global&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_GLOBAL_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_HREF_HEADING class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_HREF_HEADING</span> <span class=o>=</span> <span class=s1>&#39;trestle://&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_HREF_HEADING class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_HREF_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_HREF_REGEX</span> <span class=o>=</span> <span class=s1>&#39;^trestle://[^/]&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_HREF_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_IMP_STATUS_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_IMP_STATUS_TAG</span> <span class=o>=</span> <span class=s1>&#39;trestle-imp-status&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_IMP_STATUS_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_INHERITED_PROPS_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_INHERITED_PROPS_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;inherited-props&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_INHERITED_PROPS_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_INHERITED_PROPS_TRACKER class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_INHERITED_PROPS_TRACKER</span> <span class=o>=</span> <span class=s1>&#39;trestle_inherited_props_tracker&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_INHERITED_PROPS_TRACKER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_KEEP_FILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_KEEP_FILE</span> <span class=o>=</span> <span class=s1>&#39;.keep&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_KEEP_FILE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_LEVERAGING_COMP_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;leveraging-comp&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_LEVERAGING_COMP_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_PROPS_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_PROPS_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;props&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_PROPS_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_STATEMENT_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_STATEMENT_TAG</span> <span class=o>=</span> <span class=n>TRESTLE_TAG</span> <span class=o>+</span> <span class=s1>&#39;statement&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_STATEMENT_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.TRESTLE_TAG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_TAG</span> <span class=o>=</span> <span class=s1>&#39;x-trestle-&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.TRESTLE_TAG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.UNIX_CACHE_ROOT class="doc doc-heading"> <code class="highlight language-python"><span class=n>UNIX_CACHE_ROOT</span> <span class=o>=</span> <span class=s1>&#39;__root__&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.UNIX_CACHE_ROOT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.UUID_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>UUID_REGEX</span> <span class=o>=</span> <span class=s1>&#39;(?:^|[0-9A-Za-f])([0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>)(?:$|[^0-9A-Za-z])&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.UUID_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.VALUES class="doc doc-heading"> <code class="highlight language-python"><span class=n>VALUES</span> <span class=o>=</span> <span class=s1>&#39;values&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.VALUES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.VALUE_ASSIGNED_PREFIX class="doc doc-heading"> <code class="highlight language-python"><span class=n>VALUE_ASSIGNED_PREFIX</span> <span class=o>=</span> <span class=s1>&#39;value-assigned-prefix&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.VALUE_ASSIGNED_PREFIX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.VALUE_NOT_ASSIGNED_PREFIX class="doc doc-heading"> <code class="highlight language-python"><span class=n>VALUE_NOT_ASSIGNED_PREFIX</span> <span class=o>=</span> <span class=s1>&#39;value-not-assigned-prefix&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.VALUE_NOT_ASSIGNED_PREFIX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.VAL_MODE_ALL class="doc doc-heading"> <code class="highlight language-python"><span class=n>VAL_MODE_ALL</span> <span class=o>=</span> <span class=s1>&#39;all&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.VAL_MODE_ALL class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.VAL_MODE_CATALOG class="doc doc-heading"> <code class="highlight language-python"><span class=n>VAL_MODE_CATALOG</span> <span class=o>=</span> <span class=s1>&#39;catalog&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.VAL_MODE_CATALOG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.VAL_MODE_DUPLICATES class="doc doc-heading"> <code class="highlight language-python"><span class=n>VAL_MODE_DUPLICATES</span> <span class=o>=</span> <span class=s1>&#39;duplicates&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.VAL_MODE_DUPLICATES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.VAL_MODE_LINKS class="doc doc-heading"> <code class="highlight language-python"><span class=n>VAL_MODE_LINKS</span> <span class=o>=</span> <span class=s1>&#39;links&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.VAL_MODE_LINKS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.VAL_MODE_REFS class="doc doc-heading"> <code class="highlight language-python"><span class=n>VAL_MODE_REFS</span> <span class=o>=</span> <span class=s1>&#39;refs&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.VAL_MODE_REFS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.VAL_MODE_RULES class="doc doc-heading"> <code class="highlight language-python"><span class=n>VAL_MODE_RULES</span> <span class=o>=</span> <span class=s1>&#39;rules&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.VAL_MODE_RULES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.WEBSITE_ROOT class="doc doc-heading"> <code class="highlight language-python"><span class=n>WEBSITE_ROOT</span> <span class=o>=</span> <span class=s1>&#39;https://oscal-compass.github.io/compliance-trestle&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.WEBSITE_ROOT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.WINDOWS_DRIVE_LETTER_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>WINDOWS_DRIVE_LETTER_REGEX</span> <span class=o>=</span> <span class=s1>&#39;[A-Za-z]:&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.WINDOWS_DRIVE_LETTER_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.WINDOWS_DRIVE_URI_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>WINDOWS_DRIVE_URI_REGEX</span> <span class=o>=</span> <span class=s1>&#39;([A-Za-z]:[</span><span class=se>\\\\</span><span class=s1>/]?)[^</span><span class=se>\\\\</span><span class=s1>/]&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.WINDOWS_DRIVE_URI_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.WINDOWS_PLATFORM_STR class="doc doc-heading"> <code class="highlight language-python"><span class=n>WINDOWS_PLATFORM_STR</span> <span class=o>=</span> <span class=s1>&#39;Windows&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.WINDOWS_PLATFORM_STR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.YAML_LEVERAGED_COMMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>YAML_LEVERAGED_COMMENT</span> <span class=o>=</span> <span class=s1>&#39; # Add or modify leveraged SSP Statements here.</span><span class=se>\n</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.YAML_LEVERAGED_COMMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.YAML_LEVERAGING_COMP_COMMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>YAML_LEVERAGING_COMP_COMMENT</span> <span class=o>=</span> <span class=s1>&#39; # Leveraged statements can be optionally associated with components in this system.</span><span class=se>\n</span><span class=s1> # Associate leveraged statements to Components of this system here:</span><span class=se>\n</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.YAML_LEVERAGING_COMP_COMMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.YAML_PROFILE_VALUES_COMMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>YAML_PROFILE_VALUES_COMMENT</span> <span class=o>=</span> <span class=s1>&#39; # This section contains the parameters that are part of this control.</span><span class=se>\n</span><span class=s1> # Each parameter has properties. Only the profile-values and display-name properties are editable.</span><span class=se>\n</span><span class=s1> # The other properties are informational.</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # The values property for a parameter represents values inherited from the OSCAL catalog.</span><span class=se>\n</span><span class=s1> # To override the catalog settings, use bullets under profile-values as shown below:</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # profile-values:</span><span class=se>\n</span><span class=s1> # - value 1</span><span class=se>\n</span><span class=s1> # - value 2</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # If the &quot;- &lt;REPLACE_ME&gt;&quot; placeholder appears under profile-values, it is the same as if</span><span class=se>\n</span><span class=s1> # the profile-values property were left empty.</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # Some parameters may show an aggregates property which lists other parameters. This means</span><span class=se>\n</span><span class=s1> # the parameter value is made up of the values from the other parameters. For parameters</span><span class=se>\n</span><span class=s1> # that aggregate, profile-values is not applicable.</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # Property param-value-origin is meant for putting the origin from where that parameter comes from.</span><span class=se>\n</span><span class=s1> # In order to be changed in the current profile, profile-param-value-origin property will be displayed with</span><span class=se>\n</span><span class=s1> # the placeholder &quot;&lt;REPLACE_ME&gt;&quot; for you to be replaced. If a parameter already has a param-value-origin</span><span class=se>\n</span><span class=s1> # coming from an inherited profile, do no change this value, instead use profile-param-value-origin as follows:</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # param-value-origin: DO NOT REPLACE - this is the original value</span><span class=se>\n</span><span class=s1> # profile-param-value-origin: &lt;REPLACE_ME&gt; - replace the new value required HERE</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.YAML_PROFILE_VALUES_COMMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.YAML_PROPS_COMMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>YAML_PROPS_COMMENT</span> <span class=o>=</span> <span class=s1>&#39; # Add or modify control properties here</span><span class=se>\n</span><span class=s1> # Properties may be at the control or part level</span><span class=se>\n</span><span class=s1> # Add control level properties like this:</span><span class=se>\n</span><span class=s1> # - name: ac1_new_prop</span><span class=se>\n</span><span class=s1> # value: new property value</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # Add properties to a statement part like this, where &quot;b.&quot; is the label of the target statement part</span><span class=se>\n</span><span class=s1> # - name: ac1_new_prop</span><span class=se>\n</span><span class=s1> # value: new property value</span><span class=se>\n</span><span class=s1> # smt-part: b.</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.YAML_PROPS_COMMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT</span> <span class=o>=</span> <span class=s1>&#39; # You may set new values for rule parameters by adding</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # component-values:</span><span class=se>\n</span><span class=s1> # - value 1</span><span class=se>\n</span><span class=s1> # - value 2</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # below a section of values:</span><span class=se>\n</span><span class=s1> # The values list refers to the values as set by the components, and the component-values are the new values</span><span class=se>\n</span><span class=s1> # to be placed in SetParameters of the component definition.</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.YAML_RULE_PARAM_VALUES_SSP_COMMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>YAML_RULE_PARAM_VALUES_SSP_COMMENT</span> <span class=o>=</span> <span class=s1>&#39; # You may set new values for rule parameters by adding</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # ssp-values:</span><span class=se>\n</span><span class=s1> # - value 1</span><span class=se>\n</span><span class=s1> # - value 2</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # below a section of values:</span><span class=se>\n</span><span class=s1> # The values list refers to the values as set by the components, and the ssp-values are the new values</span><span class=se>\n</span><span class=s1> # to be placed in SetParameters of the SSP.</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.YAML_RULE_PARAM_VALUES_SSP_COMMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.const.YAML_SSP_VALUES_COMMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>YAML_SSP_VALUES_COMMENT</span> <span class=o>=</span> <span class=s1>&#39; # You may set values for parameters in the assembled SSP by adding</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # ssp-values:</span><span class=se>\n</span><span class=s1> # - value 1</span><span class=se>\n</span><span class=s1> # - value 2</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1> # below a section of values:</span><span class=se>\n</span><span class=s1> # The values list refers to the values in the resolved profile catalog, and the ssp-values represent new values</span><span class=se>\n</span><span class=s1> # to be placed in SetParameters of the SSP.</span><span class=se>\n</span><span class=s1> #</span><span class=se>\n</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.const.YAML_SSP_VALUES_COMMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/err/index.html b/latest/reference/API/trestle/common/err/index.html
new file mode 100644
index 000000000..bbfc548da
--- /dev/null
+++ b/latest/reference/API/trestle/common/err/index.html
@@ -0,0 +1,197 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.err module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/err/ rel=canonical><link href=../const/ rel=prev><link href=../file_utils/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.err - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.err - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.err module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/err.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/err/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.err - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.err module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/err.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.err class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.err </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.err </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.err </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.err class=md-nav__link> <span class=md-ellipsis> err </span> </a> <nav class=md-nav aria-label=err> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError class=md-nav__link> <span class=md-ellipsis> TrestleError </span> </a> <nav class=md-nav aria-label=TrestleError> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError.msg class=md-nav__link> <span class=md-ellipsis> msg </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleIncorrectArgsError class=md-nav__link> <span class=md-ellipsis> TrestleIncorrectArgsError </span> </a> <nav class=md-nav aria-label=TrestleIncorrectArgsError> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleIncorrectArgsError-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleIncorrectArgsError.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleNotFoundError class=md-nav__link> <span class=md-ellipsis> TrestleNotFoundError </span> </a> <nav class=md-nav aria-label=TrestleNotFoundError> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleNotFoundError-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleNotFoundError.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleRootError class=md-nav__link> <span class=md-ellipsis> TrestleRootError </span> </a> <nav class=md-nav aria-label=TrestleRootError> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleRootError-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleRootError.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.handle_generic_command_exception class=md-nav__link> <span class=md-ellipsis> handle_generic_command_exception </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.err class=md-nav__link> <span class=md-ellipsis> err </span> </a> <nav class=md-nav aria-label=err> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError class=md-nav__link> <span class=md-ellipsis> TrestleError </span> </a> <nav class=md-nav aria-label=TrestleError> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError.msg class=md-nav__link> <span class=md-ellipsis> msg </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleError.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleIncorrectArgsError class=md-nav__link> <span class=md-ellipsis> TrestleIncorrectArgsError </span> </a> <nav class=md-nav aria-label=TrestleIncorrectArgsError> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleIncorrectArgsError-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleIncorrectArgsError.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleNotFoundError class=md-nav__link> <span class=md-ellipsis> TrestleNotFoundError </span> </a> <nav class=md-nav aria-label=TrestleNotFoundError> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleNotFoundError-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleNotFoundError.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err.TrestleRootError class=md-nav__link> <span class=md-ellipsis> TrestleRootError </span> </a> <nav class=md-nav aria-label=TrestleRootError> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleRootError-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.TrestleRootError.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.err-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.err.handle_generic_command_exception class=md-nav__link> <span class=md-ellipsis> handle_generic_command_exception </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.err</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.err class="doc doc-heading"> <code>trestle.common.err</code> <a href=#trestle.common.err class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle core errors module.</p> <div class="doc doc-children"> <h3 id=trestle.common.err-classes>Classes<a href=#trestle.common.err-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.common.err.TrestleError class="doc doc-heading"> <code>TrestleError</code> <a href=#trestle.common.err.TrestleError class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code>RuntimeError</code></p> <p>General framework (non-application) related errors.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleError.msg href=#trestle.common.err.TrestleError.msg>msg</a></code></td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Human readable string describing the exception.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>23</span>
+<span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TrestleError</span><span class=p>(</span><span class=ne>RuntimeError</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    General framework (non-application) related errors.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        msg (str): Human readable string describing the exception.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Intialization for TresleError.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            msg (str): The error message</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=ne>RuntimeError</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>msg</span> <span class=o>=</span> <span class=n>msg</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return Trestle error message if asked for a string.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>msg</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.common.err.TrestleError-attributes>Attributes<a href=#trestle.common.err.TrestleError-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.common.err.TrestleError.msg class="doc doc-heading"> <code class="highlight language-python"><span class=n>msg</span> <span class=o>=</span> <span class=n>msg</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.common.err.TrestleError.msg class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.common.err.TrestleError-functions>Functions<a href=#trestle.common.err.TrestleError-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.common.err.TrestleError.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span></code> <a href=#trestle.common.err.TrestleError.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Intialization for TresleError.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>msg</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The error message</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Intialization for TresleError.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        msg (str): The error message</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=ne>RuntimeError</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>msg</span> <span class=o>=</span> <span class=n>msg</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.err.TrestleError.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.common.err.TrestleError.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return Trestle error message if asked for a string.</p> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return Trestle error message if asked for a string.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>msg</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.common.err.TrestleIncorrectArgsError class="doc doc-heading"> <code>TrestleIncorrectArgsError</code> <a href=#trestle.common.err.TrestleIncorrectArgsError class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleError href=#trestle.common.err.TrestleError>TrestleError</a></code></p> <p>General error for incorrect args passed to Trestle command.</p> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TrestleIncorrectArgsError</span><span class=p>(</span><span class=n>TrestleError</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;General error for incorrect args passed to Trestle command.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize TrestleIncorrectArgsError.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            msg (str): The error message</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.common.err.TrestleIncorrectArgsError-functions>Functions<a href=#trestle.common.err.TrestleIncorrectArgsError-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.common.err.TrestleIncorrectArgsError.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span></code> <a href=#trestle.common.err.TrestleIncorrectArgsError.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize TrestleIncorrectArgsError.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>msg</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The error message</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize TrestleIncorrectArgsError.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        msg (str): The error message</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.common.err.TrestleNotFoundError class="doc doc-heading"> <code>TrestleNotFoundError</code> <a href=#trestle.common.err.TrestleNotFoundError class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleError href=#trestle.common.err.TrestleError>TrestleError</a></code></p> <p>General framework related not found error.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleNotFoundError.msg href=#trestle.common.err.TrestleError.msg>msg</a></code></td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Human readable string describing the exception.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TrestleNotFoundError</span><span class=p>(</span><span class=n>TrestleError</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    General framework related not found error.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        msg (str): Human readable string describing the exception.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Intialize TresleNotFoundError.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            msg: The error message</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.common.err.TrestleNotFoundError-functions>Functions<a href=#trestle.common.err.TrestleNotFoundError-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.common.err.TrestleNotFoundError.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span></code> <a href=#trestle.common.err.TrestleNotFoundError.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Intialize TresleNotFoundError.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>msg</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The error message</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Intialize TresleNotFoundError.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        msg: The error message</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.common.err.TrestleRootError class="doc doc-heading"> <code>TrestleRootError</code> <a href=#trestle.common.err.TrestleRootError class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleError href=#trestle.common.err.TrestleError>TrestleError</a></code></p> <p>General error for trestle workspace root/setup errors.</p> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TrestleRootError</span><span class=p>(</span><span class=n>TrestleError</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;General error for trestle workspace root/setup errors.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize TrestleRootError.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            msg (str): The error message</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.common.err.TrestleRootError-functions>Functions<a href=#trestle.common.err.TrestleRootError-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.common.err.TrestleRootError.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span></code> <a href=#trestle.common.err.TrestleRootError.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize TrestleRootError.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>msg</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The error message</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize TrestleRootError.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        msg (str): The error message</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.common.err-functions>Functions<a href=#trestle.common.err-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.common.err.handle_generic_command_exception class="doc doc-heading"> <code class="highlight language-python"><span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>exception</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=n>msg</span><span class=o>=</span><span class=s1>&#39;Exception occured during execution&#39;</span><span class=p>)</span></code> <a href=#trestle.common.err.handle_generic_command_exception class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Print out error message based on the verbosity and return appropriate status code.</p> <details class=quote> <summary>Source code in <code>trestle/common/err.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span>
+<span class=normal>98</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>handle_generic_command_exception</span><span class=p>(</span>
+    <span class=n>exception</span><span class=p>:</span> <span class=ne>Exception</span><span class=p>,</span> <span class=n>logger</span><span class=p>:</span> <span class=n>Logger</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;Exception occured during execution&#39;</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print out error message based on the verbosity and return appropriate status code.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=n>msg</span> <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;: </span><span class=si>{</span><span class=n>exception</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>exception</span><span class=p>(</span><span class=n>msg</span> <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;: </span><span class=si>{</span><span class=n>exception</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>_exception_to_error_code</span><span class=p>(</span><span class=n>exception</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/file_utils/index.html b/latest/reference/API/trestle/common/file_utils/index.html
new file mode 100644
index 000000000..2f5e12f5a
--- /dev/null
+++ b/latest/reference/API/trestle/common/file_utils/index.html
@@ -0,0 +1,397 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.file_utils module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/file_utils/ rel=canonical><link href=../err/ rel=prev><link href=../list_utils/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.file_utils - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.file_utils - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.file_utils module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/file_utils.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/file_utils/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.file_utils - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.file_utils module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/file_utils.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.file_utils class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.file_utils </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.file_utils </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.file_utils </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.file_utils class=md-nav__link> <span class=md-ellipsis> file_utils </span> </a> <nav class=md-nav aria-label=file_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.file_utils-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.file_utils.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.file_utils.check_oscal_directories class=md-nav__link> <span class=md-ellipsis> check_oscal_directories </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.extract_project_model_path class=md-nav__link> <span class=md-ellipsis> extract_project_model_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.extract_trestle_project_root class=md-nav__link> <span class=md-ellipsis> extract_trestle_project_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.get_contextual_file_type class=md-nav__link> <span class=md-ellipsis> get_contextual_file_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.insert_text_in_file class=md-nav__link> <span class=md-ellipsis> insert_text_in_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_directory_name_allowed class=md-nav__link> <span class=md-ellipsis> is_directory_name_allowed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_hidden class=md-nav__link> <span class=md-ellipsis> is_hidden </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_local_and_visible class=md-nav__link> <span class=md-ellipsis> is_local_and_visible </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_symlink class=md-nav__link> <span class=md-ellipsis> is_symlink </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_valid_project_root class=md-nav__link> <span class=md-ellipsis> is_valid_project_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_windows class=md-nav__link> <span class=md-ellipsis> is_windows </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.iterdir_without_hidden_files class=md-nav__link> <span class=md-ellipsis> iterdir_without_hidden_files </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.load_file class=md-nav__link> <span class=md-ellipsis> load_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.make_hidden_file class=md-nav__link> <span class=md-ellipsis> make_hidden_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.prune_empty_dirs class=md-nav__link> <span class=md-ellipsis> prune_empty_dirs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.relative_resolve class=md-nav__link> <span class=md-ellipsis> relative_resolve </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.file_utils class=md-nav__link> <span class=md-ellipsis> file_utils </span> </a> <nav class=md-nav aria-label=file_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.file_utils-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.file_utils.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.file_utils.check_oscal_directories class=md-nav__link> <span class=md-ellipsis> check_oscal_directories </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.extract_project_model_path class=md-nav__link> <span class=md-ellipsis> extract_project_model_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.extract_trestle_project_root class=md-nav__link> <span class=md-ellipsis> extract_trestle_project_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.get_contextual_file_type class=md-nav__link> <span class=md-ellipsis> get_contextual_file_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.insert_text_in_file class=md-nav__link> <span class=md-ellipsis> insert_text_in_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_directory_name_allowed class=md-nav__link> <span class=md-ellipsis> is_directory_name_allowed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_hidden class=md-nav__link> <span class=md-ellipsis> is_hidden </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_local_and_visible class=md-nav__link> <span class=md-ellipsis> is_local_and_visible </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_symlink class=md-nav__link> <span class=md-ellipsis> is_symlink </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_valid_project_root class=md-nav__link> <span class=md-ellipsis> is_valid_project_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.is_windows class=md-nav__link> <span class=md-ellipsis> is_windows </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.iterdir_without_hidden_files class=md-nav__link> <span class=md-ellipsis> iterdir_without_hidden_files </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.load_file class=md-nav__link> <span class=md-ellipsis> load_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.make_hidden_file class=md-nav__link> <span class=md-ellipsis> make_hidden_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.prune_empty_dirs class=md-nav__link> <span class=md-ellipsis> prune_empty_dirs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.file_utils.relative_resolve class=md-nav__link> <span class=md-ellipsis> relative_resolve </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.file_utils</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.file_utils class="doc doc-heading"> <code>trestle.common.file_utils</code> <a href=#trestle.common.file_utils class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle file system utils.</p> <div class="doc doc-children"> <h3 id=trestle.common.file_utils-attributes>Attributes<a href=#trestle.common.file_utils-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.file_utils.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.file_utils.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.common.file_utils-classes>Classes<a href=#trestle.common.file_utils-classes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.common.file_utils-functions>Functions<a href=#trestle.common.file_utils-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.check_oscal_directories class="doc doc-heading"> <code class="highlight language-python"><span class=n>check_oscal_directories</span><span class=p>(</span><span class=n>root_path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.check_oscal_directories class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Identify the state of the trestle workspace.</p> <p>Traverses trestle workspace and looks for unexpected files or directories. Additional files are allowed in the Trestle root but not inside the model folders.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>check_oscal_directories</span><span class=p>(</span><span class=n>root_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identify the state of the trestle workspace.</span>
+
+<span class=sd>    Traverses trestle workspace and looks for unexpected files or directories.</span>
+<span class=sd>    Additional files are allowed in the Trestle root but not inside the model folders.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>trestle_dir_walk</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>walk</span><span class=p>(</span><span class=n>root_path</span><span class=p>)</span>
+    <span class=n>is_valid</span> <span class=o>=</span> <span class=kc>True</span>
+
+    <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>dirs</span><span class=p>,</span> <span class=n>_</span> <span class=ow>in</span> <span class=n>trestle_dir_walk</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>d</span> <span class=ow>in</span> <span class=n>dirs</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>d</span> <span class=ow>in</span> <span class=n>MODEL_DIR_LIST</span><span class=p>:</span>
+                <span class=n>is_valid</span> <span class=o>=</span> <span class=n>_verify_oscal_folder</span><span class=p>(</span><span class=n>root_path</span> <span class=o>/</span> <span class=n>d</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>is_valid</span><span class=p>:</span>
+                    <span class=k>break</span>
+    <span class=k>return</span> <span class=n>is_valid</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.extract_project_model_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>extract_project_model_path</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.extract_project_model_path class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get the base path of the trestle model project.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>extract_project_model_path</span><span class=p>(</span><span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the base path of the trestle model project.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>2</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>2</span><span class=p>,</span> <span class=nb>len</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>parts</span><span class=p>)):</span>
+            <span class=n>current</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=o>*</span><span class=n>path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=mi>1</span><span class=p>:</span><span class=n>i</span> <span class=o>+</span> <span class=mi>1</span><span class=p>])</span>
+            <span class=k>if</span> <span class=n>_is_valid_project_model_path</span><span class=p>(</span><span class=n>current</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>current</span>
+    <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.extract_trestle_project_root class="doc doc-heading"> <code class="highlight language-python"><span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.extract_trestle_project_root class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get the trestle workspace root folder in the path.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>extract_trestle_project_root</span><span class=p>(</span><span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the trestle workspace root folder in the path.&quot;&quot;&quot;</span>
+    <span class=k>while</span> <span class=nb>len</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>  <span class=c1># it must not be the system root directory</span>
+        <span class=k>if</span> <span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>path</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>path</span>
+        <span class=n>path</span> <span class=o>=</span> <span class=n>path</span><span class=o>.</span><span class=n>parent</span>
+    <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.get_contextual_file_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_contextual_file_type</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.get_contextual_file_type class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Return the file content type for files in the given directory, if it's a trestle workspace.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_contextual_file_type</span><span class=p>(</span><span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>FileContentType</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the file content type for files in the given directory, if it&#39;s a trestle workspace.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>_is_valid_project_model_path</span><span class=p>(</span><span class=n>path</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Trestle workspace not found at path </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>file_or_directory</span> <span class=ow>in</span> <span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>path</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>file_or_directory</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_or_directory</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>file_or_directory</span> <span class=ow>in</span> <span class=n>path</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>file_or_directory</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>get_contextual_file_type</span><span class=p>(</span><span class=n>file_or_directory</span><span class=p>)</span>
+
+    <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;No files found in the project.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.insert_text_in_file class="doc doc-heading"> <code class="highlight language-python"><span class=n>insert_text_in_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>tag</span><span class=p>,</span> <span class=n>text</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.insert_text_in_file class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Insert text lines after line containing tag.</p> <p>Return True on success, False tag not found. Text is a string with appropriate \n line endings. If tag is none just add at end of file. This will only open file once if tag is not found.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>insert_text_in_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>tag</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>text</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sa>r</span><span class=sd>&quot;&quot;&quot;Insert text lines after line containing tag.</span>
+
+<span class=sd>    Return True on success, False tag not found.</span>
+<span class=sd>    Text is a string with appropriate \n line endings.</span>
+<span class=sd>    If tag is none just add at end of file.</span>
+<span class=sd>    This will only open file once if tag is not found.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Test file </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> not found.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>tag</span><span class=p>:</span>
+        <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>with</span> <span class=n>file_path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>f</span><span class=p>:</span>
+            <span class=n>lines</span> <span class=o>=</span> <span class=n>f</span><span class=o>.</span><span class=n>readlines</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>ii</span><span class=p>,</span> <span class=n>line</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>lines</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=n>tag</span><span class=p>)</span> <span class=o>&gt;=</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>lines</span><span class=o>.</span><span class=n>insert</span><span class=p>(</span><span class=n>ii</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>text</span><span class=p>)</span>
+                <span class=k>with</span> <span class=n>file_path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>f</span><span class=p>:</span>
+                    <span class=n>f</span><span class=o>.</span><span class=n>writelines</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>with</span> <span class=n>file_path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;a&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>f</span><span class=p>:</span>
+            <span class=n>f</span><span class=o>.</span><span class=n>writelines</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.is_directory_name_allowed class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_directory_name_allowed</span><span class=p>(</span><span class=n>name</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.is_directory_name_allowed class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Determine whether a directory name, which is a 'non-core-OSCAL activity/directory is allowed.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>the name which is assumed may take the form of a relative path for task/subtasks.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether the name is allowed or not allowed (interferes with assumed project directories such as catalogs).</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_directory_name_allowed</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Determine whether a directory name, which is a &#39;non-core-OSCAL activity/directory is allowed.</span>
+
+<span class=sd>    args:</span>
+<span class=sd>        name: the name which is assumed may take the form of a relative path for task/subtasks.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Whether the name is allowed or not allowed (interferes with assumed project directories such as catalogs).</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># Task must not use an OSCAL directory</span>
+    <span class=c1># Task must not self-interfere with a project</span>
+    <span class=n>pathed_name</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+
+    <span class=n>root_path</span> <span class=o>=</span> <span class=n>pathed_name</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+    <span class=k>if</span> <span class=n>root_path</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_TO_MODEL_DIR</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Task name is the same as an OSCAL schema name.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=n>root_path</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;.&#39;</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Task name must not start with &quot;.&quot;&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=n>pathed_name</span><span class=o>.</span><span class=n>suffix</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+        <span class=c1># Does it look like a file</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Task name must not look like a file path (e.g. contain a suffix&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=s1>&#39;__global__&#39;</span> <span class=ow>in</span> <span class=n>pathed_name</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Task name cannot contain __global__&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.is_hidden class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_hidden</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.is_hidden class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Determine whether a file is hidden based on the appropriate os attributes.</p> <p>This function will only work for the current file path only (e.g. not if a parent is hidden).</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>file_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The file path for which we are testing whether the file / directory is hidden.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether or not the file is file/directory is hidden.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_hidden</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Determine whether a file is hidden based on the appropriate os attributes.</span>
+
+<span class=sd>    This function will only work for the current file path only (e.g. not if a parent is hidden).</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        file_path: The file path for which we are testing whether the file / directory is hidden.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Whether or not the file is file/directory is hidden.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># as far as trestle is concerned all .* files are hidden even on windows, regardless of attributes</span>
+    <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>stem</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=c1># Handle windows</span>
+    <span class=k>if</span> <span class=n>is_windows</span><span class=p>():</span>  <span class=c1># pragma: no cover</span>
+        <span class=n>attribute</span> <span class=o>=</span> <span class=n>win32api</span><span class=o>.</span><span class=n>GetFileAttributes</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>file_path</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>attribute</span> <span class=o>&amp;</span> <span class=p>(</span><span class=n>win32con</span><span class=o>.</span><span class=n>FILE_ATTRIBUTE_HIDDEN</span> <span class=o>|</span> <span class=n>win32con</span><span class=o>.</span><span class=n>FILE_ATTRIBUTE_SYSTEM</span><span class=p>)</span>
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.is_local_and_visible class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_local_and_visible</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.is_local_and_visible class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Is the file or dir local (not a symlink) and not hidden.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_local_and_visible</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Is the file or dir local (not a symlink) and not hidden.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=ow>not</span> <span class=p>(</span><span class=n>is_hidden</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span> <span class=ow>or</span> <span class=n>is_symlink</span><span class=p>(</span><span class=n>file_path</span><span class=p>))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.is_symlink class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_symlink</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.is_symlink class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Is the file path a symlink.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_symlink</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Is the file path a symlink.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>is_windows</span><span class=p>():</span>
+        <span class=k>return</span> <span class=n>file_path</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=s1>&#39;.lnk&#39;</span>
+    <span class=k>return</span> <span class=n>file_path</span><span class=o>.</span><span class=n>is_symlink</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.is_valid_project_root class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.is_valid_project_root class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Check if the path is a valid trestle workspace root.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_valid_project_root</span><span class=p>(</span><span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check if the path is a valid trestle workspace root.&quot;&quot;&quot;</span>
+    <span class=n>trestle_dir</span> <span class=o>=</span> <span class=n>path</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_CONFIG_DIR</span>
+    <span class=k>return</span> <span class=n>trestle_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>and</span> <span class=n>trestle_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.is_windows class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_windows</span><span class=p>()</span></code> <a href=#trestle.common.file_utils.is_windows class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Check if current operating system is Windows.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_windows</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check if current operating system is Windows.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>platform</span><span class=o>.</span><span class=n>system</span><span class=p>()</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>WINDOWS_PLATFORM_STR</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.iterdir_without_hidden_files class="doc doc-heading"> <code class="highlight language-python"><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>directory_path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.iterdir_without_hidden_files class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get iterator over all paths in the given directory_path excluding hidden files.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>directory_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The directory to iterate through.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Iterable>Iterable</span>[<span title=pathlib.Path>Path</span>]</code> </td> <td> <div class=doc-md-description> <p>Iterator over the files in the directory excluding hidden files.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>directory_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterable</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get iterator over all paths in the given directory_path excluding hidden files.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        directory_path: The directory to iterate through.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Iterator over the files in the directory excluding hidden files.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>filtered_paths</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=ow>not</span> <span class=n>is_hidden</span><span class=p>(</span><span class=n>p</span><span class=p>)</span> <span class=ow>or</span> <span class=n>p</span><span class=o>.</span><span class=n>is_dir</span><span class=p>(),</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>iterdir</span><span class=p>(</span><span class=n>directory_path</span><span class=p>)))</span>
+
+    <span class=k>return</span> <span class=n>filtered_paths</span><span class=o>.</span><span class=fm>__iter__</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.load_file class="doc doc-heading"> <code class="highlight language-python"><span class=n>load_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.load_file class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Load JSON or YAML file content into a dict.</p> <p>This is not intended to be the default load mechanism. It should only be used if a OSCAL object type is unknown but the context a user is in.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>load_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Load JSON or YAML file content into a dict.</span>
+
+<span class=sd>    This is not intended to be the default load mechanism. It should only be used</span>
+<span class=sd>    if a OSCAL object type is unknown but the context a user is in.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+    <span class=k>with</span> <span class=n>file_path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>f</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span><span class=p>:</span>
+            <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>f</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>json</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>f</span><span class=p>)</span>
+    <span class=k>return</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.make_hidden_file class="doc doc-heading"> <code class="highlight language-python"><span class=n>make_hidden_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.make_hidden_file class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Make hidden file.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>make_hidden_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Make hidden file.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>file_path</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>is_windows</span><span class=p>():</span>
+        <span class=n>file_path</span> <span class=o>=</span> <span class=n>file_path</span><span class=o>.</span><span class=n>parent</span> <span class=o>/</span> <span class=p>(</span><span class=s1>&#39;.&#39;</span> <span class=o>+</span> <span class=n>file_path</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+
+    <span class=n>file_path</span><span class=o>.</span><span class=n>touch</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>is_windows</span><span class=p>():</span>
+        <span class=n>atts</span> <span class=o>=</span> <span class=n>win32api</span><span class=o>.</span><span class=n>GetFileAttributes</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>file_path</span><span class=p>))</span>
+        <span class=n>win32api</span><span class=o>.</span><span class=n>SetFileAttributes</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>file_path</span><span class=p>),</span> <span class=n>win32con</span><span class=o>.</span><span class=n>FILE_ATTRIBUTE_HIDDEN</span> <span class=o>|</span> <span class=n>atts</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.prune_empty_dirs class="doc doc-heading"> <code class="highlight language-python"><span class=n>prune_empty_dirs</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>pattern</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.prune_empty_dirs class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Remove directories with no subdirs and with no files matching pattern.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>prune_empty_dirs</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>pattern</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove directories with no subdirs and with no files matching pattern.&quot;&quot;&quot;</span>
+    <span class=n>deleted</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+    <span class=c1># this traverses from leaf nodes upward so only needs one traversal</span>
+    <span class=k>for</span> <span class=n>current_dir</span><span class=p>,</span> <span class=n>subdirs</span><span class=p>,</span> <span class=n>_</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>walk</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>file_path</span><span class=p>),</span> <span class=n>topdown</span><span class=o>=</span><span class=kc>False</span><span class=p>):</span>
+        <span class=n>true_dirs</span> <span class=o>=</span> <span class=p>[</span><span class=n>subdir</span> <span class=k>for</span> <span class=n>subdir</span> <span class=ow>in</span> <span class=n>subdirs</span> <span class=k>if</span> <span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>current_dir</span><span class=p>,</span> <span class=n>subdir</span><span class=p>)</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>deleted</span><span class=p>]</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>true_dirs</span> <span class=ow>and</span> <span class=ow>not</span> <span class=nb>any</span><span class=p>(</span><span class=n>glob</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>current_dir</span><span class=si>}</span><span class=s1>/</span><span class=si>{</span><span class=n>pattern</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)):</span>
+            <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=n>current_dir</span><span class=p>)</span>
+            <span class=n>deleted</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>current_dir</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.file_utils.relative_resolve class="doc doc-heading"> <code class="highlight language-python"><span class=n>relative_resolve</span><span class=p>(</span><span class=n>candidate</span><span class=p>,</span> <span class=n>cwd</span><span class=p>)</span></code> <a href=#trestle.common.file_utils.relative_resolve class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Resolve a candidate file path relative to a provided cwd.</p> <p>This is to circumvent bad behaviour for resolve on windows platforms where the path must exist.</p> <p>If a relative dir is passed it presumes the directory is relative to the PROVIDED cwd. If relative expansions exist (e.g. ../) the final result must still be within the cwd.</p> <p>If an absolute path is provided it tests whether the path is within the cwd or not.</p> <details class=quote> <summary>Source code in <code>trestle/common/file_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>relative_resolve</span><span class=p>(</span><span class=n>candidate</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>cwd</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Resolve a candidate file path relative to a provided cwd.</span>
+
+<span class=sd>    This is to circumvent bad behaviour for resolve on windows platforms where the path must exist.</span>
+
+<span class=sd>    If a relative dir is passed it presumes the directory is relative to the PROVIDED cwd.</span>
+<span class=sd>    If relative expansions exist (e.g. ../) the final result must still be within the cwd.</span>
+
+<span class=sd>    If an absolute path is provided it tests whether the path is within the cwd or not.</span>
+
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># Expand user first if applicable.</span>
+    <span class=n>candidate</span> <span class=o>=</span> <span class=n>candidate</span><span class=o>.</span><span class=n>expanduser</span><span class=p>()</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>cwd</span><span class=o>.</span><span class=n>is_absolute</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Error handling current working directory. CWD is expected to be absolute.&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>candidate</span><span class=o>.</span><span class=n>is_absolute</span><span class=p>():</span>
+        <span class=n>new</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>cwd</span> <span class=o>/</span> <span class=n>candidate</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>new</span> <span class=o>=</span> <span class=n>candidate</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>new</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>cwd</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>ValueError</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided dir </span><span class=si>{</span><span class=n>candidate</span><span class=si>}</span><span class=s1> is not relative to </span><span class=si>{</span><span class=n>cwd</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>new</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/list_utils/index.html b/latest/reference/API/trestle/common/list_utils/index.html
new file mode 100644
index 000000000..69969f9da
--- /dev/null
+++ b/latest/reference/API/trestle/common/list_utils/index.html
@@ -0,0 +1,248 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.list_utils module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/list_utils/ rel=canonical><link href=../file_utils/ rel=prev><link href=../load_validate/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.list_utils - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.list_utils - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.list_utils module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/list_utils.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/list_utils/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.list_utils - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.list_utils module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/list_utils.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.list_utils class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.list_utils </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.list_utils </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.list_utils </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.list_utils class=md-nav__link> <span class=md-ellipsis> list_utils </span> </a> <nav class=md-nav aria-label=list_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.list_utils-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.list_utils.as_dict class=md-nav__link> <span class=md-ellipsis> as_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.as_filtered_list class=md-nav__link> <span class=md-ellipsis> as_filtered_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.as_list class=md-nav__link> <span class=md-ellipsis> as_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.comma_colon_sep_to_dict class=md-nav__link> <span class=md-ellipsis> comma_colon_sep_to_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.comma_sep_to_list class=md-nav__link> <span class=md-ellipsis> comma_sep_to_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.deep_append class=md-nav__link> <span class=md-ellipsis> deep_append </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.deep_get class=md-nav__link> <span class=md-ellipsis> deep_get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.deep_set class=md-nav__link> <span class=md-ellipsis> deep_set </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.deep_update class=md-nav__link> <span class=md-ellipsis> deep_update </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.delete_item_from_list class=md-nav__link> <span class=md-ellipsis> delete_item_from_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.delete_list_from_list class=md-nav__link> <span class=md-ellipsis> delete_list_from_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.get_default class=md-nav__link> <span class=md-ellipsis> get_default </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.get_item_from_list class=md-nav__link> <span class=md-ellipsis> get_item_from_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.is_ordered_sublist class=md-nav__link> <span class=md-ellipsis> is_ordered_sublist </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.join_key_to_list_dicts class=md-nav__link> <span class=md-ellipsis> join_key_to_list_dicts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.merge_dicts class=md-nav__link> <span class=md-ellipsis> merge_dicts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.none_if_empty class=md-nav__link> <span class=md-ellipsis> none_if_empty </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.pop_item_from_list class=md-nav__link> <span class=md-ellipsis> pop_item_from_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.set_or_pop class=md-nav__link> <span class=md-ellipsis> set_or_pop </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.list_utils class=md-nav__link> <span class=md-ellipsis> list_utils </span> </a> <nav class=md-nav aria-label=list_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.list_utils-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.list_utils.as_dict class=md-nav__link> <span class=md-ellipsis> as_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.as_filtered_list class=md-nav__link> <span class=md-ellipsis> as_filtered_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.as_list class=md-nav__link> <span class=md-ellipsis> as_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.comma_colon_sep_to_dict class=md-nav__link> <span class=md-ellipsis> comma_colon_sep_to_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.comma_sep_to_list class=md-nav__link> <span class=md-ellipsis> comma_sep_to_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.deep_append class=md-nav__link> <span class=md-ellipsis> deep_append </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.deep_get class=md-nav__link> <span class=md-ellipsis> deep_get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.deep_set class=md-nav__link> <span class=md-ellipsis> deep_set </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.deep_update class=md-nav__link> <span class=md-ellipsis> deep_update </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.delete_item_from_list class=md-nav__link> <span class=md-ellipsis> delete_item_from_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.delete_list_from_list class=md-nav__link> <span class=md-ellipsis> delete_list_from_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.get_default class=md-nav__link> <span class=md-ellipsis> get_default </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.get_item_from_list class=md-nav__link> <span class=md-ellipsis> get_item_from_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.is_ordered_sublist class=md-nav__link> <span class=md-ellipsis> is_ordered_sublist </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.join_key_to_list_dicts class=md-nav__link> <span class=md-ellipsis> join_key_to_list_dicts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.merge_dicts class=md-nav__link> <span class=md-ellipsis> merge_dicts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.none_if_empty class=md-nav__link> <span class=md-ellipsis> none_if_empty </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.pop_item_from_list class=md-nav__link> <span class=md-ellipsis> pop_item_from_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.list_utils.set_or_pop class=md-nav__link> <span class=md-ellipsis> set_or_pop </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.list_utils</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.list_utils class="doc doc-heading"> <code>trestle.common.list_utils</code> <a href=#trestle.common.list_utils class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle List Utils.</p> <div class="doc doc-children"> <h3 id=trestle.common.list_utils-attributes>Attributes<a href=#trestle.common.list_utils-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.common.list_utils-classes>Classes<a href=#trestle.common.list_utils-classes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.common.list_utils-functions>Functions<a href=#trestle.common.list_utils-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.as_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_dict</span><span class=p>(</span><span class=n>dict_or_none</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.as_dict class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert dict or None object to itself or an empty dict if none.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_dict</span><span class=p>(</span><span class=n>dict_or_none</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=n>TG</span><span class=p>,</span> <span class=n>TG2</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=n>TG</span><span class=p>,</span> <span class=n>TG2</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert dict or None object to itself or an empty dict if none.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>dict_or_none</span> <span class=k>if</span> <span class=n>dict_or_none</span> <span class=k>else</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.as_filtered_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_filtered_list</span><span class=p>(</span><span class=n>list_or_none</span><span class=p>,</span> <span class=n>filter_condition</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.as_filtered_list class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert to list and filter based on the condition.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_filtered_list</span><span class=p>(</span><span class=n>list_or_none</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>]],</span> <span class=n>filter_condition</span><span class=p>:</span> <span class=n>Callable</span><span class=p>[[</span><span class=n>TG</span><span class=p>],</span> <span class=nb>bool</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert to list and filter based on the condition.&quot;&quot;&quot;</span>
+    <span class=n>result_list</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>list_or_none</span><span class=p>)</span>
+    <span class=n>result_list</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=n>filter_condition</span><span class=p>,</span> <span class=n>result_list</span><span class=p>))</span>
+    <span class=k>return</span> <span class=n>result_list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.as_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_list</span><span class=p>(</span><span class=n>list_or_none</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.as_list class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert list or None object to itself or an empty list if none.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>23</span>
+<span class=normal>24</span>
+<span class=normal>25</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_list</span><span class=p>(</span><span class=n>list_or_none</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert list or None object to itself or an empty list if none.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>list_or_none</span> <span class=k>if</span> <span class=n>list_or_none</span> <span class=k>else</span> <span class=p>[]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.comma_colon_sep_to_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>comma_colon_sep_to_dict</span><span class=p>(</span><span class=n>string_or_none</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.comma_colon_sep_to_dict class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert optional comma and colon-sep list to dict.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>comma_colon_sep_to_dict</span><span class=p>(</span><span class=n>string_or_none</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert optional comma and colon-sep list to dict.&quot;&quot;&quot;</span>
+    <span class=n>entries</span> <span class=o>=</span> <span class=n>comma_sep_to_list</span><span class=p>(</span><span class=n>string_or_none</span><span class=p>)</span>
+    <span class=n>dic</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>entry</span> <span class=ow>in</span> <span class=n>entries</span><span class=p>:</span>
+        <span class=c1># if more than one colon include any colons in the value after the first one</span>
+        <span class=n>token</span> <span class=o>=</span> <span class=n>entry</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;:&#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>token</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>dic</span><span class=p>[</span><span class=n>token</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()]</span> <span class=o>=</span> <span class=n>token</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>dic</span><span class=p>[</span><span class=n>token</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()]</span> <span class=o>=</span> <span class=n>token</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>dic</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.comma_sep_to_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>comma_sep_to_list</span><span class=p>(</span><span class=n>string_or_none</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.comma_sep_to_list class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert optional comma-sep string to list of strings and strip.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>comma_sep_to_list</span><span class=p>(</span><span class=n>string_or_none</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert optional comma-sep string to list of strings and strip.&quot;&quot;&quot;</span>
+    <span class=n>string_or_none</span> <span class=o>=</span> <span class=n>string_or_none</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=k>if</span> <span class=n>string_or_none</span> <span class=k>else</span> <span class=kc>None</span>
+    <span class=k>return</span> <span class=nb>list</span><span class=p>(</span><span class=nb>map</span><span class=p>(</span><span class=nb>str</span><span class=o>.</span><span class=n>strip</span><span class=p>,</span> <span class=n>string_or_none</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)))</span> <span class=k>if</span> <span class=n>string_or_none</span> <span class=k>else</span> <span class=p>[]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.deep_append class="doc doc-heading"> <code class="highlight language-python"><span class=n>deep_append</span><span class=p>(</span><span class=n>dic</span><span class=p>,</span> <span class=n>path</span><span class=p>,</span> <span class=n>value</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.deep_append class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Append to list in dict.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>deep_append</span><span class=p>(</span><span class=n>dic</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>value</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Append to list in dict.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>path</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Error appending value in deep append with empty path.&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>path</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]:</span>
+        <span class=n>dic</span><span class=p>[</span><span class=n>node</span><span class=p>]</span> <span class=o>=</span> <span class=n>dic</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>node</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>dic</span> <span class=o>=</span> <span class=n>dic</span><span class=p>[</span><span class=n>node</span><span class=p>]</span>
+    <span class=k>if</span> <span class=n>path</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>dic</span><span class=p>:</span>
+        <span class=n>dic</span><span class=p>[</span><span class=n>path</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>dic</span><span class=p>[</span><span class=n>path</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>value</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.deep_get class="doc doc-heading"> <code class="highlight language-python"><span class=n>deep_get</span><span class=p>(</span><span class=n>dic</span><span class=p>,</span> <span class=n>path</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.deep_get class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get value from deep in dictionary.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>deep_get</span><span class=p>(</span><span class=n>dic</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>default</span><span class=p>:</span> <span class=n>Any</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get value from deep in dictionary.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>path</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Error getting value in deep get with empty path.&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>path</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]:</span>
+        <span class=k>if</span> <span class=n>node</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>dic</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>default</span>
+        <span class=n>dic</span> <span class=o>=</span> <span class=n>dic</span><span class=p>[</span><span class=n>node</span><span class=p>]</span>
+    <span class=k>return</span> <span class=n>dic</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>path</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>],</span> <span class=n>default</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.deep_set class="doc doc-heading"> <code class="highlight language-python"><span class=n>deep_set</span><span class=p>(</span><span class=n>dic</span><span class=p>,</span> <span class=n>path</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>pop_if_none</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.deep_set class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Set value deep in dictionary.</p> <p>pop_if_none will cause the key to be removed if value is None</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>deep_set</span><span class=p>(</span><span class=n>dic</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>value</span><span class=p>:</span> <span class=n>Any</span><span class=p>,</span> <span class=n>pop_if_none</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Set value deep in dictionary.</span>
+
+<span class=sd>    pop_if_none will cause the key to be removed if value is None</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>path</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Error setting value in deep set with empty path.&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>path</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]:</span>
+        <span class=n>dic</span><span class=p>[</span><span class=n>node</span><span class=p>]</span> <span class=o>=</span> <span class=n>dic</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>node</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>dic</span> <span class=o>=</span> <span class=n>dic</span><span class=p>[</span><span class=n>node</span><span class=p>]</span>
+    <span class=k>if</span> <span class=n>value</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>pop_if_none</span><span class=p>:</span>
+        <span class=n>dic</span><span class=p>[</span><span class=n>path</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]]</span> <span class=o>=</span> <span class=n>value</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>dic</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>path</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>],</span> <span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.deep_update class="doc doc-heading"> <code class="highlight language-python"><span class=n>deep_update</span><span class=p>(</span><span class=n>dic</span><span class=p>,</span> <span class=n>path</span><span class=p>,</span> <span class=n>dic_value</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.deep_update class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Update the dict based on path.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>deep_update</span><span class=p>(</span><span class=n>dic</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>dic_value</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Update the dict based on path.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>path</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Error updating value in deep update with empty path.&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>path</span><span class=p>:</span>
+        <span class=n>dic</span><span class=p>[</span><span class=n>node</span><span class=p>]</span> <span class=o>=</span> <span class=n>dic</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>node</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>dic</span> <span class=o>=</span> <span class=n>dic</span><span class=p>[</span><span class=n>node</span><span class=p>]</span>
+    <span class=n>dic</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>dic_value</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.delete_item_from_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>delete_item_from_list</span><span class=p>(</span><span class=n>item_list</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>key</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.delete_item_from_list class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Remove the first matching item if it is present in a list based on the callable key matching the query value.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>delete_item_from_list</span><span class=p>(</span><span class=n>item_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>],</span> <span class=n>value</span><span class=p>:</span> <span class=n>TG2</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=n>Callable</span><span class=p>[[</span><span class=n>TG</span><span class=p>],</span> <span class=n>TG2</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove the first matching item if it is present in a list based on the callable key matching the query value.&quot;&quot;&quot;</span>
+    <span class=n>keys</span> <span class=o>=</span> <span class=p>[</span><span class=n>key</span><span class=p>(</span><span class=n>item</span><span class=p>)</span> <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>item_list</span><span class=p>]</span>
+    <span class=k>if</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>keys</span><span class=p>:</span>
+        <span class=n>index</span> <span class=o>=</span> <span class=n>keys</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>value</span><span class=p>)</span>
+        <span class=k>del</span> <span class=n>item_list</span><span class=p>[</span><span class=n>index</span><span class=p>]</span>
+    <span class=k>return</span> <span class=n>item_list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.delete_list_from_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>delete_list_from_list</span><span class=p>(</span><span class=n>item_list</span><span class=p>,</span> <span class=n>indices</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.delete_list_from_list class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Delete a list of items from a list based on indices.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>delete_list_from_list</span><span class=p>(</span><span class=n>item_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>],</span> <span class=n>indices</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>int</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Delete a list of items from a list based on indices.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>index</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>indices</span><span class=p>,</span> <span class=n>reverse</span><span class=o>=</span><span class=kc>True</span><span class=p>):</span>
+        <span class=k>del</span> <span class=n>item_list</span><span class=p>[</span><span class=n>index</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.get_default class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_default</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>default</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.get_default class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Return the default value for the item if it is not set.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_default</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TG</span><span class=p>,</span> <span class=n>default</span><span class=p>:</span> <span class=n>TG</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TG</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the default value for the item if it is not set.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>item</span> <span class=k>if</span> <span class=n>item</span> <span class=k>else</span> <span class=n>default</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.get_item_from_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_item_from_list</span><span class=p>(</span><span class=n>item_list</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=n>remove</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.get_item_from_list class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get first item from list if present based on key matching value with option to remove it from the list.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_item_from_list</span><span class=p>(</span><span class=n>item_list</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>]],</span>
+                       <span class=n>value</span><span class=p>:</span> <span class=n>TG2</span><span class=p>,</span>
+                       <span class=n>key</span><span class=p>:</span> <span class=n>Callable</span><span class=p>[[</span><span class=n>TG</span><span class=p>],</span> <span class=n>TG2</span><span class=p>],</span>
+                       <span class=n>remove</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TG</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get first item from list if present based on key matching value with option to remove it from the list.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>item_list</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>None</span>
+    <span class=n>keys</span> <span class=o>=</span> <span class=p>[</span><span class=n>key</span><span class=p>(</span><span class=n>item</span><span class=p>)</span> <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>item_list</span><span class=p>]</span>
+    <span class=n>item</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>if</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>keys</span><span class=p>:</span>
+        <span class=n>index</span> <span class=o>=</span> <span class=n>keys</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>value</span><span class=p>)</span>
+        <span class=n>item</span> <span class=o>=</span> <span class=n>item_list</span><span class=p>[</span><span class=n>index</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>remove</span><span class=p>:</span>
+            <span class=k>del</span> <span class=n>item_list</span><span class=p>[</span><span class=n>index</span><span class=p>]</span>
+    <span class=k>return</span> <span class=n>item</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.is_ordered_sublist class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_ordered_sublist</span><span class=p>(</span><span class=n>needle</span><span class=p>,</span> <span class=n>haystack</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.is_ordered_sublist class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Determine if needle is exactly contained in haystack.</p> <p>The needle list comprises an ordered list of strings. The haystack list comprises an ordered list of strings that is to be searched. If the strings in the needle appear in the haystack in that exact order then return true, else false.</p> <p>Examples: needle=['a','b','c'], haystack=['x','y','a','b','c','z'], result = True needle=['a','b','c'], haystack=['x','y','a','b','z','c'], result = False</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_ordered_sublist</span><span class=p>(</span><span class=n>needle</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>haystack</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Determine if needle is exactly contained in haystack.</span>
+
+<span class=sd>    The needle list comprises an ordered list of strings.</span>
+<span class=sd>    The haystack list comprises an ordered list of strings that is to be searched.</span>
+<span class=sd>    If the strings in the needle appear in the haystack in that exact order then</span>
+<span class=sd>    return true, else false.</span>
+
+<span class=sd>    Examples:</span>
+<span class=sd>    needle=[&#39;a&#39;,&#39;b&#39;,&#39;c&#39;], haystack=[&#39;x&#39;,&#39;y&#39;,&#39;a&#39;,&#39;b&#39;,&#39;c&#39;,&#39;z&#39;], result = True</span>
+<span class=sd>    needle=[&#39;a&#39;,&#39;b&#39;,&#39;c&#39;], haystack=[&#39;x&#39;,&#39;y&#39;,&#39;a&#39;,&#39;b&#39;,&#39;z&#39;,&#39;c&#39;], result = False</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=s1>&#39; &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>needle</span><span class=p>)</span> <span class=ow>in</span> <span class=s1>&#39; &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>haystack</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.join_key_to_list_dicts class="doc doc-heading"> <code class="highlight language-python"><span class=n>join_key_to_list_dicts</span><span class=p>(</span><span class=n>dict1</span><span class=p>,</span> <span class=n>dict2</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.join_key_to_list_dicts class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Join two dicts of str to List.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>join_key_to_list_dicts</span><span class=p>(</span><span class=n>dict1</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>]],</span> <span class=n>dict2</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Join two dicts of str to List.&quot;&quot;&quot;</span>
+    <span class=c1># merge like keys</span>
+    <span class=n>dict3</span> <span class=o>=</span> <span class=p>{</span><span class=n>key</span><span class=p>:</span> <span class=n>dict1</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>+</span> <span class=n>dict2</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=p>[])</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>dict1</span><span class=p>}</span>
+    <span class=c1># merge unlike keys</span>
+    <span class=n>dict3</span><span class=o>.</span><span class=n>update</span><span class=p>({</span><span class=n>key</span><span class=p>:</span> <span class=n>dict2</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>dict2</span> <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>dict3</span><span class=p>})</span>
+    <span class=k>return</span> <span class=n>dict3</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.merge_dicts class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge_dicts</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.merge_dicts class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Merge the two dicts with priority to src.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>merge_dicts</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>src</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Merge the two dicts with priority to src.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=p>{</span><span class=o>**</span><span class=n>as_dict</span><span class=p>(</span><span class=n>dest</span><span class=p>),</span> <span class=o>**</span><span class=n>as_dict</span><span class=p>(</span><span class=n>src</span><span class=p>)}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.none_if_empty class="doc doc-heading"> <code class="highlight language-python"><span class=n>none_if_empty</span><span class=p>(</span><span class=n>list_</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.none_if_empty class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert to None if empty list.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>none_if_empty</span><span class=p>(</span><span class=n>list_</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert to None if empty list.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>list_</span> <span class=k>if</span> <span class=n>list_</span> <span class=k>else</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.pop_item_from_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>pop_item_from_list</span><span class=p>(</span><span class=n>item_list</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>key</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.pop_item_from_list class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Pop first matching item from a list if it is present based on the key matching the value.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>pop_item_from_list</span><span class=p>(</span><span class=n>item_list</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>]],</span> <span class=n>value</span><span class=p>:</span> <span class=n>TG2</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=n>Callable</span><span class=p>[[</span><span class=n>TG</span><span class=p>],</span> <span class=n>TG2</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TG</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Pop first matching item from a list if it is present based on the key matching the value.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>get_item_from_list</span><span class=p>(</span><span class=n>item_list</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.list_utils.set_or_pop class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_or_pop</span><span class=p>(</span><span class=n>dic</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span><span class=p>)</span></code> <a href=#trestle.common.list_utils.set_or_pop class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Set if value is non-empty list or not None otherwise remove.</p> <details class=quote> <summary>Source code in <code>trestle/common/list_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_or_pop</span><span class=p>(</span><span class=n>dic</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>value</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set if value is non-empty list or not None otherwise remove.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>value</span><span class=p>:</span>
+        <span class=n>dic</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>value</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>dic</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/load_validate/index.html b/latest/reference/API/trestle/common/load_validate/index.html
new file mode 100644
index 000000000..9830264a6
--- /dev/null
+++ b/latest/reference/API/trestle/common/load_validate/index.html
@@ -0,0 +1,35 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.load_validate module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/load_validate/ rel=canonical><link href=../list_utils/ rel=prev><link href=../log/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.load_validate - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.load_validate - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.load_validate module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/load_validate.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/load_validate/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.load_validate - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.load_validate module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/load_validate.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.load_validate class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.load_validate </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.load_validate </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.load_validate </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.load_validate class=md-nav__link> <span class=md-ellipsis> load_validate </span> </a> <nav class=md-nav aria-label=load_validate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.load_validate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.load_validate.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.load_validate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.load_validate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.load_validate.load_validate_model_name class=md-nav__link> <span class=md-ellipsis> load_validate_model_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.load_validate.load_validate_model_path class=md-nav__link> <span class=md-ellipsis> load_validate_model_path </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.load_validate class=md-nav__link> <span class=md-ellipsis> load_validate </span> </a> <nav class=md-nav aria-label=load_validate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.load_validate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.load_validate.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.load_validate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.load_validate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.load_validate.load_validate_model_name class=md-nav__link> <span class=md-ellipsis> load_validate_model_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.load_validate.load_validate_model_path class=md-nav__link> <span class=md-ellipsis> load_validate_model_path </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.load_validate</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.load_validate class="doc doc-heading"> <code>trestle.common.load_validate</code> <a href=#trestle.common.load_validate class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Function to load and validate files while avoiding circular imports.</p> <div class="doc doc-children"> <h3 id=trestle.common.load_validate-attributes>Attributes<a href=#trestle.common.load_validate-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.load_validate.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.load_validate.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.common.load_validate-classes>Classes<a href=#trestle.common.load_validate-classes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.common.load_validate-functions>Functions<a href=#trestle.common.load_validate-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.common.load_validate.load_validate_model_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span><span class=p>,</span> <span class=n>file_content_type</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.common.load_validate.load_validate_model_name class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Load a model by its name and type and validate it.</p> <details class=quote> <summary>Source code in <code>trestle/common/load_validate.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>load_validate_model_name</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span>
+    <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>model_class</span><span class=p>:</span> <span class=n>TG</span><span class=p>,</span>
+    <span class=n>file_content_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>FileContentType</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>TG</span><span class=p>,</span> <span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Load a model by its name and type and validate it.&quot;&quot;&quot;</span>
+    <span class=n>model_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span><span class=p>,</span> <span class=n>file_content_type</span><span class=p>)</span>
+    <span class=n>model</span> <span class=o>=</span> <span class=n>load_validate_model_path</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_path</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>model</span><span class=p>,</span> <span class=n>model_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.load_validate.load_validate_model_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>load_validate_model_path</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_path</span><span class=p>)</span></code> <a href=#trestle.common.load_validate.load_validate_model_path class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Load a model by its path and validate it.</p> <details class=quote> <summary>Source code in <code>trestle/common/load_validate.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>load_validate_model_path</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>model_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TopLevelOscalModel</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Load a model by its path and validate it.&quot;&quot;&quot;</span>
+    <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span><span class=n>mode</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>VAL_MODE_ALL</span><span class=p>,</span> <span class=n>quiet</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>validator</span><span class=p>:</span> <span class=n>Validator</span> <span class=o>=</span> <span class=n>validator_factory</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>validator</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model loaded at </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1> fails validation, but is being loaded anyway.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>model</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/log/index.html b/latest/reference/API/trestle/common/log/index.html
new file mode 100644
index 000000000..7a1e0e10e
--- /dev/null
+++ b/latest/reference/API/trestle/common/log/index.html
@@ -0,0 +1,174 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.log module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/log/ rel=canonical><link href=../load_validate/ rel=prev><link href=../model_utils/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.log - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.log - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.log module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/log.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/log/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.log - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.log module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/log.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.log class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.log </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.log </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.log </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.log class=md-nav__link> <span class=md-ellipsis> log </span> </a> <nav class=md-nav aria-label=log> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.SpecificLevelFilter class=md-nav__link> <span class=md-ellipsis> SpecificLevelFilter </span> </a> <nav class=md-nav aria-label=SpecificLevelFilter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.SpecificLevelFilter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.SpecificLevelFilter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.log.SpecificLevelFilter.filter class=md-nav__link> <span class=md-ellipsis> filter </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.log.Trace class=md-nav__link> <span class=md-ellipsis> Trace </span> </a> <nav class=md-nav aria-label=Trace> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.Trace-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.Trace.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.log.Trace.log class=md-nav__link> <span class=md-ellipsis> log </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.log-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.get_current_verbosity_level class=md-nav__link> <span class=md-ellipsis> get_current_verbosity_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.log.set_global_logging_levels class=md-nav__link> <span class=md-ellipsis> set_global_logging_levels </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.log.set_log_level_from_args class=md-nav__link> <span class=md-ellipsis> set_log_level_from_args </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.log class=md-nav__link> <span class=md-ellipsis> log </span> </a> <nav class=md-nav aria-label=log> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.SpecificLevelFilter class=md-nav__link> <span class=md-ellipsis> SpecificLevelFilter </span> </a> <nav class=md-nav aria-label=SpecificLevelFilter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.SpecificLevelFilter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.SpecificLevelFilter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.log.SpecificLevelFilter.filter class=md-nav__link> <span class=md-ellipsis> filter </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.log.Trace class=md-nav__link> <span class=md-ellipsis> Trace </span> </a> <nav class=md-nav aria-label=Trace> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.Trace-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.Trace.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.log.Trace.log class=md-nav__link> <span class=md-ellipsis> log </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.log-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.log.get_current_verbosity_level class=md-nav__link> <span class=md-ellipsis> get_current_verbosity_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.log.set_global_logging_levels class=md-nav__link> <span class=md-ellipsis> set_global_logging_levels </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.log.set_log_level_from_args class=md-nav__link> <span class=md-ellipsis> set_log_level_from_args </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.log</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.log class="doc doc-heading"> <code>trestle.common.log</code> <a href=#trestle.common.log class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Common logging utilities.</p> <div class="doc doc-children"> <h3 id=trestle.common.log-classes>Classes<a href=#trestle.common.log-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.common.log.SpecificLevelFilter class="doc doc-heading"> <code>SpecificLevelFilter</code> <a href=#trestle.common.log.SpecificLevelFilter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=logging.Filter>Filter</span></code></p> <p>Filter for the same level as provided by setLevel for a log handler.</p> <p>Python by default logs all levels above to a given destination. This makes it easy to split levels where you might log all levels to file and only errors to std.err, however, does not allow logging a specific level elsewhere.</p> <details class=quote> <summary>Source code in <code>trestle/common/log.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SpecificLevelFilter</span><span class=p>(</span><span class=n>logging</span><span class=o>.</span><span class=n>Filter</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Filter for the same level as provided by setLevel for a log handler.</span>
+
+<span class=sd>    Python by default logs all levels above to a given destination. This makes it easy to split levels where you might</span>
+<span class=sd>    log all levels to file and only errors to std.err, however, does not allow logging a specific level elsewhere.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize providing maximum level to be pushed through the filter.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_level</span> <span class=o>=</span> <span class=n>level</span>
+
+    <span class=k>def</span> <span class=nf>filter</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>log_record</span><span class=p>:</span> <span class=n>logging</span><span class=o>.</span><span class=n>LogRecord</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>  <span class=c1># noqa: A003</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Filter log messages.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>log_record</span><span class=o>.</span><span class=n>levelno</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>_level</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.common.log.SpecificLevelFilter-functions>Functions<a href=#trestle.common.log.SpecificLevelFilter-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.common.log.SpecificLevelFilter.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>level</span><span class=p>)</span></code> <a href=#trestle.common.log.SpecificLevelFilter.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize providing maximum level to be pushed through the filter.</p> <details class=quote> <summary>Source code in <code>trestle/common/log.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize providing maximum level to be pushed through the filter.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_level</span> <span class=o>=</span> <span class=n>level</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.log.SpecificLevelFilter.filter class="doc doc-heading"> <code class="highlight language-python"><span class=nb>filter</span><span class=p>(</span><span class=n>log_record</span><span class=p>)</span></code> <a href=#trestle.common.log.SpecificLevelFilter.filter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Filter log messages.</p> <details class=quote> <summary>Source code in <code>trestle/common/log.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>filter</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>log_record</span><span class=p>:</span> <span class=n>logging</span><span class=o>.</span><span class=n>LogRecord</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>  <span class=c1># noqa: A003</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Filter log messages.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>log_record</span><span class=o>.</span><span class=n>levelno</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>_level</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.common.log.Trace class="doc doc-heading"> <code>Trace</code> <a href=#trestle.common.log.Trace class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class allowing low priority trace message when verbose &gt; 1 and log level below DEBUG.</p> <details class=quote> <summary>Source code in <code>trestle/common/log.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Trace</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class allowing low priority trace message when verbose &gt; 1 and log level below DEBUG.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>logger</span><span class=p>:</span> <span class=n>logging</span><span class=o>.</span><span class=n>Logger</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Store the main logger with its module name.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_logger</span> <span class=o>=</span> <span class=n>logger</span>
+
+    <span class=k>def</span> <span class=nf>log</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Output the trace msg if log level is below DEBUG.&quot;&quot;&quot;</span>
+        <span class=n>level</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_logger</span><span class=o>.</span><span class=n>getEffectiveLevel</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>level</span> <span class=o>&lt;</span> <span class=n>logging</span><span class=o>.</span><span class=n>DEBUG</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.common.log.Trace-functions>Functions<a href=#trestle.common.log.Trace-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.common.log.Trace.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span></code> <a href=#trestle.common.log.Trace.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Store the main logger with its module name.</p> <details class=quote> <summary>Source code in <code>trestle/common/log.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>logger</span><span class=p>:</span> <span class=n>logging</span><span class=o>.</span><span class=n>Logger</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Store the main logger with its module name.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_logger</span> <span class=o>=</span> <span class=n>logger</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.log.Trace.log class="doc doc-heading"> <code class="highlight language-python"><span class=n>log</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span></code> <a href=#trestle.common.log.Trace.log class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Output the trace msg if log level is below DEBUG.</p> <details class=quote> <summary>Source code in <code>trestle/common/log.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>log</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>msg</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Output the trace msg if log level is below DEBUG.&quot;&quot;&quot;</span>
+    <span class=n>level</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_logger</span><span class=o>.</span><span class=n>getEffectiveLevel</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>level</span> <span class=o>&lt;</span> <span class=n>logging</span><span class=o>.</span><span class=n>DEBUG</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.common.log-functions>Functions<a href=#trestle.common.log-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.common.log.get_current_verbosity_level class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span></code> <a href=#trestle.common.log.get_current_verbosity_level class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get the current verbosity level based on logging level.</p> <details class=quote> <summary>Source code in <code>trestle/common/log.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>:</span> <span class=n>logging</span><span class=o>.</span><span class=n>Logger</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the current verbosity level based on logging level.&quot;&quot;&quot;</span>
+    <span class=n>level</span> <span class=o>=</span> <span class=n>logger</span><span class=o>.</span><span class=n>getEffectiveLevel</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>level</span> <span class=o>&lt;</span> <span class=n>logging</span><span class=o>.</span><span class=n>DEBUG</span><span class=p>:</span>
+        <span class=k>return</span> <span class=mi>2</span>
+    <span class=k>elif</span> <span class=n>level</span> <span class=o>==</span> <span class=n>logging</span><span class=o>.</span><span class=n>DEBUG</span><span class=p>:</span>
+        <span class=k>return</span> <span class=mi>1</span>
+    <span class=k>return</span> <span class=mi>0</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.log.set_global_logging_levels class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_global_logging_levels</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=n>logging</span><span class=o>.</span><span class=n>INFO</span><span class=p>)</span></code> <a href=#trestle.common.log.set_global_logging_levels class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Initialise logging.</p> <p>Should only be invoked by the CLI classes or similar.</p> <details class=quote> <summary>Source code in <code>trestle/common/log.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_global_logging_levels</span><span class=p>(</span><span class=n>level</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>INFO</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialise logging.</span>
+
+<span class=sd>    Should only be invoked by the CLI classes or similar.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># This line stops default root loggers setup for a python context from logging extra messages.</span>
+    <span class=c1># DO NOT USE THIS COMMAND directly from an SDK. Handle logs levels based on your own application</span>
+    <span class=n>_logger</span><span class=o>.</span><span class=n>propagate</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=c1># Remove handlers</span>
+    <span class=n>_logger</span><span class=o>.</span><span class=n>handlers</span><span class=o>.</span><span class=n>clear</span><span class=p>()</span>
+    <span class=c1># set global level</span>
+    <span class=n>_logger</span><span class=o>.</span><span class=n>setLevel</span><span class=p>(</span><span class=n>level</span><span class=p>)</span>
+    <span class=c1># Create standard out</span>
+    <span class=n>console_out_handler</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>StreamHandler</span><span class=p>(</span><span class=n>sys</span><span class=o>.</span><span class=n>stdout</span><span class=p>)</span>
+    <span class=n>console_out_handler</span><span class=o>.</span><span class=n>setLevel</span><span class=p>(</span><span class=n>logging</span><span class=o>.</span><span class=n>INFO</span><span class=p>)</span>
+    <span class=n>console_out_handler</span><span class=o>.</span><span class=n>addFilter</span><span class=p>(</span><span class=n>SpecificLevelFilter</span><span class=p>(</span><span class=n>logging</span><span class=o>.</span><span class=n>INFO</span><span class=p>))</span>
+
+    <span class=n>console_debug_handler</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>StreamHandler</span><span class=p>(</span><span class=n>sys</span><span class=o>.</span><span class=n>stdout</span><span class=p>)</span>
+    <span class=n>console_debug_handler</span><span class=o>.</span><span class=n>setLevel</span><span class=p>(</span><span class=n>logging</span><span class=o>.</span><span class=n>DEBUG</span><span class=p>)</span>
+    <span class=n>console_debug_handler</span><span class=o>.</span><span class=n>addFilter</span><span class=p>(</span><span class=n>SpecificLevelFilter</span><span class=p>(</span><span class=n>logging</span><span class=o>.</span><span class=n>DEBUG</span><span class=p>))</span>
+
+    <span class=n>console_error_handler</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>StreamHandler</span><span class=p>(</span><span class=n>sys</span><span class=o>.</span><span class=n>stderr</span><span class=p>)</span>
+    <span class=n>console_error_handler</span><span class=o>.</span><span class=n>setLevel</span><span class=p>(</span><span class=n>logging</span><span class=o>.</span><span class=n>WARNING</span><span class=p>)</span>
+    <span class=c1># create formatters</span>
+    <span class=n>error_formatter</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>Formatter</span><span class=p>(</span><span class=s1>&#39;</span><span class=si>%(name)s</span><span class=s1>:</span><span class=si>%(lineno)d</span><span class=s1> </span><span class=si>%(levelname)s</span><span class=s1>: </span><span class=si>%(message)s</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>debug_formatter</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>Formatter</span><span class=p>(</span><span class=s1>&#39;</span><span class=si>%(name)s</span><span class=s1>:</span><span class=si>%(lineno)d</span><span class=s1> </span><span class=si>%(levelname)s</span><span class=s1>: </span><span class=si>%(message)s</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>console_debug_handler</span><span class=o>.</span><span class=n>setFormatter</span><span class=p>(</span><span class=n>debug_formatter</span><span class=p>)</span>
+    <span class=n>console_error_handler</span><span class=o>.</span><span class=n>setFormatter</span><span class=p>(</span><span class=n>error_formatter</span><span class=p>)</span>
+    <span class=c1># add ch to logger</span>
+    <span class=n>_logger</span><span class=o>.</span><span class=n>addHandler</span><span class=p>(</span><span class=n>console_out_handler</span><span class=p>)</span>
+    <span class=n>_logger</span><span class=o>.</span><span class=n>addHandler</span><span class=p>(</span><span class=n>console_error_handler</span><span class=p>)</span>
+    <span class=n>_logger</span><span class=o>.</span><span class=n>addHandler</span><span class=p>(</span><span class=n>console_debug_handler</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.log.set_log_level_from_args class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span></code> <a href=#trestle.common.log.set_log_level_from_args class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Vanity function to automatically set log levels based on verbosity flags.</p> <details class=quote> <summary>Source code in <code>trestle/common/log.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Vanity function to automatically set log levels based on verbosity flags.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>verbose</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=c1># these msgs only output by trace calls</span>
+        <span class=n>set_global_logging_levels</span><span class=p>(</span><span class=n>_get_trace_level</span><span class=p>())</span>
+    <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>verbose</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=n>set_global_logging_levels</span><span class=p>(</span><span class=n>logging</span><span class=o>.</span><span class=n>DEBUG</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>set_global_logging_levels</span><span class=p>(</span><span class=n>logging</span><span class=o>.</span><span class=n>INFO</span><span class=p>)</span>
+        <span class=n>sys</span><span class=o>.</span><span class=n>excepthook</span> <span class=o>=</span> <span class=n>_exception_handler</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/model_utils/index.html b/latest/reference/API/trestle/common/model_utils/index.html
new file mode 100644
index 000000000..2b46ef4bc
--- /dev/null
+++ b/latest/reference/API/trestle/common/model_utils/index.html
@@ -0,0 +1,3056 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.model_utils module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/model_utils/ rel=canonical><link href=../log/ rel=prev><link href=../str_utils/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.model_utils - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.model_utils - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.model_utils module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/model_utils.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/model_utils/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.model_utils - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.model_utils module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/model_utils.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.model_utils class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.model_utils </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.model_utils </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.model_utils </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.model_utils class=md-nav__link> <span class=md-ellipsis> model_utils </span> </a> <nav class=md-nav aria-label=model_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils class=md-nav__link> <span class=md-ellipsis> ModelUtils </span> </a> <nav class=md-nav aria-label=ModelUtils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.dict_to_parameter class=md-nav__link> <span class=md-ellipsis> dict_to_parameter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.fields_set_non_none class=md-nav__link> <span class=md-ellipsis> fields_set_non_none </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.find_uuid_refs class=md-nav__link> <span class=md-ellipsis> find_uuid_refs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.find_values_by_name class=md-nav__link> <span class=md-ellipsis> find_values_by_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_all_models class=md-nav__link> <span class=md-ellipsis> get_all_models </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_model_path_for_name_and_class class=md-nav__link> <span class=md-ellipsis> get_model_path_for_name_and_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_models_of_type class=md-nav__link> <span class=md-ellipsis> get_models_of_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_relative_model_type class=md-nav__link> <span class=md-ellipsis> get_relative_model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_root_model class=md-nav__link> <span class=md-ellipsis> get_root_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_singular_alias class=md-nav__link> <span class=md-ellipsis> get_singular_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_stripped_model_type class=md-nav__link> <span class=md-ellipsis> get_stripped_model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_title_from_model_uri class=md-nav__link> <span class=md-ellipsis> get_title_from_model_uri </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.has_no_duplicate_values_by_name class=md-nav__link> <span class=md-ellipsis> has_no_duplicate_values_by_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.last_modified_at_time class=md-nav__link> <span class=md-ellipsis> last_modified_at_time </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.load_distributed class=md-nav__link> <span class=md-ellipsis> load_distributed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.load_model_for_class class=md-nav__link> <span class=md-ellipsis> load_model_for_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.load_model_for_type class=md-nav__link> <span class=md-ellipsis> load_model_for_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.model_age class=md-nav__link> <span class=md-ellipsis> model_age </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.model_type_to_model_dir class=md-nav__link> <span class=md-ellipsis> model_type_to_model_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.models_are_equivalent class=md-nav__link> <span class=md-ellipsis> models_are_equivalent </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.parameter_to_dict class=md-nav__link> <span class=md-ellipsis> parameter_to_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.regenerate_uuids class=md-nav__link> <span class=md-ellipsis> regenerate_uuids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.save_top_level_model class=md-nav__link> <span class=md-ellipsis> save_top_level_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.update_last_modified class=md-nav__link> <span class=md-ellipsis> update_last_modified </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.model_utils class=md-nav__link> <span class=md-ellipsis> model_utils </span> </a> <nav class=md-nav aria-label=model_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils class=md-nav__link> <span class=md-ellipsis> ModelUtils </span> </a> <nav class=md-nav aria-label=ModelUtils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.dict_to_parameter class=md-nav__link> <span class=md-ellipsis> dict_to_parameter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.fields_set_non_none class=md-nav__link> <span class=md-ellipsis> fields_set_non_none </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.find_uuid_refs class=md-nav__link> <span class=md-ellipsis> find_uuid_refs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.find_values_by_name class=md-nav__link> <span class=md-ellipsis> find_values_by_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_all_models class=md-nav__link> <span class=md-ellipsis> get_all_models </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_model_path_for_name_and_class class=md-nav__link> <span class=md-ellipsis> get_model_path_for_name_and_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_models_of_type class=md-nav__link> <span class=md-ellipsis> get_models_of_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_relative_model_type class=md-nav__link> <span class=md-ellipsis> get_relative_model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_root_model class=md-nav__link> <span class=md-ellipsis> get_root_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_singular_alias class=md-nav__link> <span class=md-ellipsis> get_singular_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_stripped_model_type class=md-nav__link> <span class=md-ellipsis> get_stripped_model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.get_title_from_model_uri class=md-nav__link> <span class=md-ellipsis> get_title_from_model_uri </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.has_no_duplicate_values_by_name class=md-nav__link> <span class=md-ellipsis> has_no_duplicate_values_by_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.last_modified_at_time class=md-nav__link> <span class=md-ellipsis> last_modified_at_time </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.load_distributed class=md-nav__link> <span class=md-ellipsis> load_distributed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.load_model_for_class class=md-nav__link> <span class=md-ellipsis> load_model_for_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.load_model_for_type class=md-nav__link> <span class=md-ellipsis> load_model_for_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.model_age class=md-nav__link> <span class=md-ellipsis> model_age </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.model_type_to_model_dir class=md-nav__link> <span class=md-ellipsis> model_type_to_model_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.models_are_equivalent class=md-nav__link> <span class=md-ellipsis> models_are_equivalent </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.parameter_to_dict class=md-nav__link> <span class=md-ellipsis> parameter_to_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.regenerate_uuids class=md-nav__link> <span class=md-ellipsis> regenerate_uuids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.save_top_level_model class=md-nav__link> <span class=md-ellipsis> save_top_level_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils.ModelUtils.update_last_modified class=md-nav__link> <span class=md-ellipsis> update_last_modified </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.model_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.model_utils</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.model_utils class="doc doc-heading"> <code>trestle.common.model_utils</code> <a href=#trestle.common.model_utils class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Common utilities for the OSCAL models and directories.</p> <div class="doc doc-children"> <h3 id=trestle.common.model_utils-attributes>Attributes<a href=#trestle.common.model_utils-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.model_utils.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.model_utils.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.common.model_utils-classes>Classes<a href=#trestle.common.model_utils-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.common.model_utils.ModelUtils class="doc doc-heading"> <code>ModelUtils</code> <a href=#trestle.common.model_utils.ModelUtils class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Utilities for the OSCAL models input and output.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span>
+<span class=normal>654</span>
+<span class=normal>655</span>
+<span class=normal>656</span>
+<span class=normal>657</span>
+<span class=normal>658</span>
+<span class=normal>659</span>
+<span class=normal>660</span>
+<span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span>
+<span class=normal>664</span>
+<span class=normal>665</span>
+<span class=normal>666</span>
+<span class=normal>667</span>
+<span class=normal>668</span>
+<span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span>
+<span class=normal>672</span>
+<span class=normal>673</span>
+<span class=normal>674</span>
+<span class=normal>675</span>
+<span class=normal>676</span>
+<span class=normal>677</span>
+<span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span>
+<span class=normal>685</span>
+<span class=normal>686</span>
+<span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span>
+<span class=normal>700</span>
+<span class=normal>701</span>
+<span class=normal>702</span>
+<span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span>
+<span class=normal>706</span>
+<span class=normal>707</span>
+<span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span>
+<span class=normal>714</span>
+<span class=normal>715</span>
+<span class=normal>716</span>
+<span class=normal>717</span>
+<span class=normal>718</span>
+<span class=normal>719</span>
+<span class=normal>720</span>
+<span class=normal>721</span>
+<span class=normal>722</span>
+<span class=normal>723</span>
+<span class=normal>724</span>
+<span class=normal>725</span>
+<span class=normal>726</span>
+<span class=normal>727</span>
+<span class=normal>728</span>
+<span class=normal>729</span>
+<span class=normal>730</span>
+<span class=normal>731</span>
+<span class=normal>732</span>
+<span class=normal>733</span>
+<span class=normal>734</span>
+<span class=normal>735</span>
+<span class=normal>736</span>
+<span class=normal>737</span>
+<span class=normal>738</span>
+<span class=normal>739</span>
+<span class=normal>740</span>
+<span class=normal>741</span>
+<span class=normal>742</span>
+<span class=normal>743</span>
+<span class=normal>744</span>
+<span class=normal>745</span>
+<span class=normal>746</span>
+<span class=normal>747</span>
+<span class=normal>748</span>
+<span class=normal>749</span>
+<span class=normal>750</span>
+<span class=normal>751</span>
+<span class=normal>752</span>
+<span class=normal>753</span>
+<span class=normal>754</span>
+<span class=normal>755</span>
+<span class=normal>756</span>
+<span class=normal>757</span>
+<span class=normal>758</span>
+<span class=normal>759</span>
+<span class=normal>760</span>
+<span class=normal>761</span>
+<span class=normal>762</span>
+<span class=normal>763</span>
+<span class=normal>764</span>
+<span class=normal>765</span>
+<span class=normal>766</span>
+<span class=normal>767</span>
+<span class=normal>768</span>
+<span class=normal>769</span>
+<span class=normal>770</span>
+<span class=normal>771</span>
+<span class=normal>772</span>
+<span class=normal>773</span>
+<span class=normal>774</span>
+<span class=normal>775</span>
+<span class=normal>776</span>
+<span class=normal>777</span>
+<span class=normal>778</span>
+<span class=normal>779</span>
+<span class=normal>780</span>
+<span class=normal>781</span>
+<span class=normal>782</span>
+<span class=normal>783</span>
+<span class=normal>784</span>
+<span class=normal>785</span>
+<span class=normal>786</span>
+<span class=normal>787</span>
+<span class=normal>788</span>
+<span class=normal>789</span>
+<span class=normal>790</span>
+<span class=normal>791</span>
+<span class=normal>792</span>
+<span class=normal>793</span>
+<span class=normal>794</span>
+<span class=normal>795</span>
+<span class=normal>796</span>
+<span class=normal>797</span>
+<span class=normal>798</span>
+<span class=normal>799</span>
+<span class=normal>800</span>
+<span class=normal>801</span>
+<span class=normal>802</span>
+<span class=normal>803</span>
+<span class=normal>804</span>
+<span class=normal>805</span>
+<span class=normal>806</span>
+<span class=normal>807</span>
+<span class=normal>808</span>
+<span class=normal>809</span>
+<span class=normal>810</span>
+<span class=normal>811</span>
+<span class=normal>812</span>
+<span class=normal>813</span>
+<span class=normal>814</span>
+<span class=normal>815</span>
+<span class=normal>816</span>
+<span class=normal>817</span>
+<span class=normal>818</span>
+<span class=normal>819</span>
+<span class=normal>820</span>
+<span class=normal>821</span>
+<span class=normal>822</span>
+<span class=normal>823</span>
+<span class=normal>824</span>
+<span class=normal>825</span>
+<span class=normal>826</span>
+<span class=normal>827</span>
+<span class=normal>828</span>
+<span class=normal>829</span>
+<span class=normal>830</span>
+<span class=normal>831</span>
+<span class=normal>832</span>
+<span class=normal>833</span>
+<span class=normal>834</span>
+<span class=normal>835</span>
+<span class=normal>836</span>
+<span class=normal>837</span>
+<span class=normal>838</span>
+<span class=normal>839</span>
+<span class=normal>840</span>
+<span class=normal>841</span>
+<span class=normal>842</span>
+<span class=normal>843</span>
+<span class=normal>844</span>
+<span class=normal>845</span>
+<span class=normal>846</span>
+<span class=normal>847</span>
+<span class=normal>848</span>
+<span class=normal>849</span>
+<span class=normal>850</span>
+<span class=normal>851</span>
+<span class=normal>852</span>
+<span class=normal>853</span>
+<span class=normal>854</span>
+<span class=normal>855</span>
+<span class=normal>856</span>
+<span class=normal>857</span>
+<span class=normal>858</span>
+<span class=normal>859</span>
+<span class=normal>860</span>
+<span class=normal>861</span>
+<span class=normal>862</span>
+<span class=normal>863</span>
+<span class=normal>864</span>
+<span class=normal>865</span>
+<span class=normal>866</span>
+<span class=normal>867</span>
+<span class=normal>868</span>
+<span class=normal>869</span>
+<span class=normal>870</span>
+<span class=normal>871</span>
+<span class=normal>872</span>
+<span class=normal>873</span>
+<span class=normal>874</span>
+<span class=normal>875</span>
+<span class=normal>876</span>
+<span class=normal>877</span>
+<span class=normal>878</span>
+<span class=normal>879</span>
+<span class=normal>880</span>
+<span class=normal>881</span>
+<span class=normal>882</span>
+<span class=normal>883</span>
+<span class=normal>884</span>
+<span class=normal>885</span>
+<span class=normal>886</span>
+<span class=normal>887</span>
+<span class=normal>888</span>
+<span class=normal>889</span>
+<span class=normal>890</span>
+<span class=normal>891</span>
+<span class=normal>892</span>
+<span class=normal>893</span>
+<span class=normal>894</span>
+<span class=normal>895</span>
+<span class=normal>896</span>
+<span class=normal>897</span>
+<span class=normal>898</span>
+<span class=normal>899</span>
+<span class=normal>900</span>
+<span class=normal>901</span>
+<span class=normal>902</span>
+<span class=normal>903</span>
+<span class=normal>904</span>
+<span class=normal>905</span>
+<span class=normal>906</span>
+<span class=normal>907</span>
+<span class=normal>908</span>
+<span class=normal>909</span>
+<span class=normal>910</span>
+<span class=normal>911</span>
+<span class=normal>912</span>
+<span class=normal>913</span>
+<span class=normal>914</span>
+<span class=normal>915</span>
+<span class=normal>916</span>
+<span class=normal>917</span>
+<span class=normal>918</span>
+<span class=normal>919</span>
+<span class=normal>920</span>
+<span class=normal>921</span>
+<span class=normal>922</span>
+<span class=normal>923</span>
+<span class=normal>924</span>
+<span class=normal>925</span>
+<span class=normal>926</span>
+<span class=normal>927</span>
+<span class=normal>928</span>
+<span class=normal>929</span>
+<span class=normal>930</span>
+<span class=normal>931</span>
+<span class=normal>932</span>
+<span class=normal>933</span>
+<span class=normal>934</span>
+<span class=normal>935</span>
+<span class=normal>936</span>
+<span class=normal>937</span>
+<span class=normal>938</span>
+<span class=normal>939</span>
+<span class=normal>940</span>
+<span class=normal>941</span>
+<span class=normal>942</span>
+<span class=normal>943</span>
+<span class=normal>944</span>
+<span class=normal>945</span>
+<span class=normal>946</span>
+<span class=normal>947</span>
+<span class=normal>948</span>
+<span class=normal>949</span>
+<span class=normal>950</span>
+<span class=normal>951</span>
+<span class=normal>952</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ModelUtils</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Utilities for the OSCAL models input and output.&quot;&quot;&quot;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>load_distributed</span><span class=p>(</span>
+        <span class=n>abs_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span>
+        <span class=n>abs_trestle_root</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span>
+        <span class=n>collection_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span>
+               <span class=nb>str</span><span class=p>,</span>
+               <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>]]]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Given path to a model, load the model.</span>
+
+<span class=sd>        If the model is decomposed/split/distributed,the decomposed models are loaded recursively.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            abs_path: The path to the file/directory to be loaded.</span>
+<span class=sd>            abs_trestle_root: The trestle workspace root directory.</span>
+<span class=sd>            collection_type: The type of collection model, if it is a collection model.</span>
+<span class=sd>                typing.List is the only collection type handled or expected.</span>
+<span class=sd>                Defaults to None.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Return a tuple of Model Type (e.g. class &#39;trestle.oscal.catalog.Catalog&#39;),</span>
+<span class=sd>            Model Alias (e.g. &#39;catalog.metadata&#39;) and Instance of the Model.</span>
+<span class=sd>            If the model is decomposed/split/distributed, the instance of the model contains</span>
+<span class=sd>                the decomposed models loaded recursively.</span>
+
+<span class=sd>        Note:</span>
+<span class=sd>            This does not validate the model.  You must either validate the model separately or use the load_validate</span>
+<span class=sd>            utilities.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># if trying to load file that does not exist, load path instead</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>abs_path</span> <span class=o>=</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>with_name</span><span class=p>(</span><span class=n>abs_path</span><span class=o>.</span><span class=n>stem</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleNotFoundError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File </span><span class=si>{</span><span class=n>abs_path</span><span class=si>}</span><span class=s1> not found for load.&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>collection_type</span><span class=p>:</span>
+            <span class=c1># If the path contains a list type model</span>
+            <span class=k>if</span> <span class=n>collection_type</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_load_list</span><span class=p>(</span><span class=n>abs_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+            <span class=c1># the only other collection type in OSCAL is dict, and it only applies to include_all,</span>
+            <span class=c1># which is too granular ever to be loaded by this routine</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Collection type </span><span class=si>{</span><span class=n>collection_type</span><span class=si>}</span><span class=s1> not recognized for distributed load.&#39;</span><span class=p>)</span>
+
+        <span class=c1># Get current model</span>
+        <span class=n>primary_model_type</span><span class=p>,</span> <span class=n>primary_model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>abs_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+        <span class=n>primary_model_instance</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span>
+
+        <span class=c1># is this an attempt to load an actual json or yaml file?</span>
+        <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>abs_path</span><span class=p>)</span>
+        <span class=c1># if file is sought but it doesn&#39;t exist, ignore and load as decomposed model</span>
+        <span class=k>if</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>is_readable_file</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span> <span class=ow>and</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>primary_model_instance</span> <span class=o>=</span> <span class=n>primary_model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>abs_path</span><span class=p>)</span>
+        <span class=c1># Is model decomposed?</span>
+        <span class=n>decomposed_dir</span> <span class=o>=</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>with_name</span><span class=p>(</span><span class=n>abs_path</span><span class=o>.</span><span class=n>stem</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>decomposed_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>aliases_not_to_be_stripped</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>instances_to_be_merged</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+            <span class=k>for</span> <span class=n>local_path</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>trestle</span><span class=o>.</span><span class=n>common</span><span class=o>.</span><span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>decomposed_dir</span><span class=p>)):</span>
+                <span class=k>if</span> <span class=n>local_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                    <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>,</span> <span class=n>model_instance</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>local_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+                    <span class=n>aliases_not_to_be_stripped</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+                    <span class=n>instances_to_be_merged</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_instance</span><span class=p>)</span>
+
+                <span class=k>elif</span> <span class=n>local_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                    <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>local_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+                    <span class=c1># Only load the directory if it is a collection model. Otherwise do nothing - it gets loaded when</span>
+                    <span class=c1># iterating over the model file</span>
+
+                    <span class=c1># If a model is just a container for a list e.g.</span>
+                    <span class=c1># class Foo(OscalBaseModel):  noqa: E800</span>
+                    <span class=c1>#      __root__: List[Bar]    noqa: E800</span>
+                    <span class=c1># You need to test whether first a root key exists</span>
+                    <span class=c1># then whether the outer_type of root is a collection.</span>
+                    <span class=c1># Alternative is to do a try except to avoid the error for an unknown key.</span>
+
+                    <span class=k>if</span> <span class=n>model_type</span><span class=o>.</span><span class=n>is_collection_container</span><span class=p>():</span>
+                        <span class=c1># This directory is a decomposed List or Dict</span>
+                        <span class=n>collection_type</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>get_collection_type</span><span class=p>()</span>
+                        <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>,</span> <span class=n>model_instance</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>local_path</span><span class=p>,</span>
+                                                                                              <span class=n>abs_trestle_root</span><span class=p>,</span>
+                                                                                              <span class=n>collection_type</span><span class=p>)</span>
+                        <span class=n>aliases_not_to_be_stripped</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+                        <span class=n>instances_to_be_merged</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_instance</span><span class=p>)</span>
+            <span class=n>primary_model_dict</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>if</span> <span class=n>primary_model_instance</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>primary_model_dict</span> <span class=o>=</span> <span class=n>primary_model_instance</span><span class=o>.</span><span class=vm>__dict__</span>
+
+            <span class=n>merged_model_type</span><span class=p>,</span> <span class=n>merged_model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>abs_path</span><span class=p>,</span>
+                                                                                       <span class=n>abs_trestle_root</span><span class=p>,</span>
+                                                                                       <span class=n>aliases_not_to_be_stripped</span><span class=p>)</span>
+
+            <span class=c1># The following use of top_level is to allow loading of a top level model by name only, e.g. MyCatalog</span>
+            <span class=c1># There may be a better overall way to approach this.</span>
+            <span class=n>top_level</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>merged_model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>))</span> <span class=o>==</span> <span class=mi>1</span>
+
+            <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=nb>len</span><span class=p>(</span><span class=n>aliases_not_to_be_stripped</span><span class=p>)):</span>
+                <span class=n>alias</span> <span class=o>=</span> <span class=n>aliases_not_to_be_stripped</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+                <span class=n>instance</span> <span class=o>=</span> <span class=n>instances_to_be_merged</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+                <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>instance</span><span class=p>,</span> <span class=s1>&#39;__dict__&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=n>instance</span><span class=o>.</span><span class=vm>__dict__</span> <span class=ow>and</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>instance</span><span class=p>,</span>
+                                                                                                    <span class=n>OscalBaseModel</span><span class=p>):</span>
+                    <span class=n>instance</span> <span class=o>=</span> <span class=n>instance</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span>
+                <span class=k>if</span> <span class=n>top_level</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>primary_model_dict</span><span class=p>:</span>
+                    <span class=n>primary_model_dict</span> <span class=o>=</span> <span class=n>instance</span><span class=o>.</span><span class=vm>__dict__</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>primary_model_dict</span><span class=p>[</span><span class=n>alias</span><span class=p>]</span> <span class=o>=</span> <span class=n>instance</span>
+
+            <span class=n>merged_model_instance</span> <span class=o>=</span> <span class=n>merged_model_type</span><span class=p>(</span><span class=o>**</span><span class=n>primary_model_dict</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>merged_model_type</span><span class=p>,</span> <span class=n>merged_model_alias</span><span class=p>,</span> <span class=n>merged_model_instance</span>
+        <span class=k>return</span> <span class=n>primary_model_type</span><span class=p>,</span> <span class=n>primary_model_alias</span><span class=p>,</span> <span class=n>primary_model_instance</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>load_model_for_class</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>model_class</span><span class=p>:</span> <span class=n>TG</span><span class=p>,</span>
+        <span class=n>file_content_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>FileContentType</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>TG</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Load a model by name and model class and infer file content type if not specified.</span>
+
+<span class=sd>        If you need to load an existing model but its content type may not be known, use this method.</span>
+<span class=sd>        But the file content type should be specified if it is somehow known.</span>
+
+<span class=sd>        Note:</span>
+<span class=sd>            This does not validate the model.  If you want to validate the model use the load_validate utilities.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>root_model_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_root_path_for_top_level_model</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span>
+        <span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=k>if</span> <span class=n>file_content_type</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>root_model_path</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>is_readable_file</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to load model </span><span class=si>{</span><span class=n>model_name</span><span class=si>}</span><span class=s1> without specifying json or yaml.&#39;</span><span class=p>)</span>
+        <span class=n>full_model_path</span> <span class=o>=</span> <span class=n>root_model_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>))</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>full_model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>model</span><span class=p>,</span> <span class=n>full_model_path</span>  <span class=c1># type: ignore</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>load_model_for_type</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                            <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Load model for the given type and name.&quot;&quot;&quot;</span>
+        <span class=n>dir_name</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+        <span class=n>model_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>dir_name</span> <span class=o>/</span> <span class=n>model_name</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No model is found at path: </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>oscal_object</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>oscal_object</span><span class=p>,</span> <span class=n>model_path</span>  <span class=c1># type: ignore</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>save_top_level_model</span><span class=p>(</span>
+        <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>file_content_type</span><span class=p>:</span> <span class=n>FileContentType</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Save a model by name and infer model type by inspection.</span>
+
+<span class=sd>        You don&#39;t need to specify the model type (catalog, profile, etc.) but you must specify the file content type.</span>
+<span class=sd>        If the model directory does not exist, it is created.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>root_model_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_root_path_for_top_level_model</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model</span><span class=p>)</span>
+        <span class=n>full_model_path</span> <span class=o>=</span> <span class=n>root_model_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>))</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>full_model_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>full_model_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>model</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>full_model_path</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_relative_model_type</span><span class=p>(</span><span class=n>relative_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Given the relative path of a file with respect to &#39;trestle_root&#39; return the oscal model type.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            relative_path: Relative path of the model with respect to the root directory of the trestle workspace.</span>
+<span class=sd>        Returns:</span>
+<span class=sd>            Type of Oscal Model for the provided model</span>
+<span class=sd>            Alias of that oscal model.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span> <span class=o>&lt;</span> <span class=mi>2</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=s1>&#39;Insufficient path length to be a valid relative path w.r.t trestle workspace root directory.&#39;</span>
+            <span class=p>)</span>
+        <span class=n>model_dir</span> <span class=o>=</span> <span class=n>relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>model_relative_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=o>*</span><span class=n>relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=mi>2</span><span class=p>:])</span>  <span class=c1># catalogs, profiles, etc</span>
+
+        <span class=k>if</span> <span class=n>model_dir</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_DIR_LIST</span><span class=p>:</span>
+            <span class=n>module_name</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_DIR_TO_MODEL_MODULE</span><span class=p>[</span><span class=n>model_dir</span><span class=p>]</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No valid trestle model type directory (e.g. catalogs) found for </span><span class=si>{</span><span class=n>model_dir</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_root_model</span><span class=p>(</span><span class=n>module_name</span><span class=p>)</span>
+        <span class=n>full_alias</span> <span class=o>=</span> <span class=n>model_alias</span>
+
+        <span class=k>for</span> <span class=n>index</span><span class=p>,</span> <span class=n>part</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>model_relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=n>alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_extract_alias</span><span class=p>(</span><span class=n>part</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>index</span> <span class=o>&gt;</span> <span class=mi>0</span> <span class=ow>or</span> <span class=n>model_alias</span> <span class=o>!=</span> <span class=n>alias</span><span class=p>:</span>
+                <span class=n>model_alias</span> <span class=o>=</span> <span class=n>alias</span>
+                <span class=n>full_alias</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>full_alias</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>):</span>
+                    <span class=n>model_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>model_type</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()[</span><span class=n>alias</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span>
+
+        <span class=k>return</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>full_alias</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_stripped_model_type</span><span class=p>(</span>
+        <span class=n>absolute_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>absolute_trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>aliases_not_to_be_stripped</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get the stripped contextual model class and alias based on the contextual path.</span>
+
+<span class=sd>        This function relies on the directory structure of the trestle model being edited to determine, based on the</span>
+<span class=sd>        existing files and folder, which fields should be stripped from the model type represented by the</span>
+<span class=sd>        path passed in as a parameter.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>aliases_not_to_be_stripped</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>aliases_not_to_be_stripped</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>singular_model_type</span><span class=p>,</span> <span class=n>model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_relative_model_type</span><span class=p>(</span>
+            <span class=n>absolute_path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>absolute_trestle_root</span><span class=p>))</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;singular model type </span><span class=si>{</span><span class=n>singular_model_type</span><span class=si>}</span><span class=s1> model alias </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># Stripped models do not apply to collection types such as List[] and Dict{}</span>
+        <span class=c1># if model type is a list or dict, generate a new wrapping model for it</span>
+        <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>singular_model_type</span><span class=p>):</span>
+            <span class=n>malias</span> <span class=o>=</span> <span class=n>model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>class_name</span> <span class=o>=</span> <span class=n>alias_to_classname</span><span class=p>(</span><span class=n>malias</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;collection field type class name </span><span class=si>{</span><span class=n>class_name</span><span class=si>}</span><span class=s1> and alias </span><span class=si>{</span><span class=n>malias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>model_type</span> <span class=o>=</span> <span class=n>create_model</span><span class=p>(</span><span class=n>class_name</span><span class=p>,</span> <span class=n>__base__</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>__root__</span><span class=o>=</span><span class=p>(</span><span class=n>singular_model_type</span><span class=p>,</span> <span class=o>...</span><span class=p>))</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;model_type created: </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span>
+
+        <span class=n>malias</span> <span class=o>=</span> <span class=n>model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;not collection field type, malias: </span><span class=si>{</span><span class=n>malias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>absolute_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()</span> <span class=ow>and</span> <span class=n>malias</span> <span class=o>!=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_extract_alias</span><span class=p>(</span><span class=n>absolute_path</span><span class=o>.</span><span class=n>name</span><span class=p>):</span>
+            <span class=n>split_subdir</span> <span class=o>=</span> <span class=n>absolute_path</span> <span class=o>/</span> <span class=n>malias</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>split_subdir</span> <span class=o>=</span> <span class=n>absolute_path</span><span class=o>.</span><span class=n>parent</span> <span class=o>/</span> <span class=n>absolute_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>name</span>
+
+        <span class=n>aliases_to_be_stripped</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>split_subdir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>f</span> <span class=ow>in</span> <span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>split_subdir</span><span class=p>):</span>
+                <span class=n>alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_extract_alias</span><span class=p>(</span><span class=n>f</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>alias</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>aliases_not_to_be_stripped</span><span class=p>:</span>
+                    <span class=n>aliases_to_be_stripped</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>alias</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;aliases to be stripped: </span><span class=si>{</span><span class=n>aliases_to_be_stripped</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>aliases_to_be_stripped</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>model_type</span> <span class=o>=</span> <span class=n>singular_model_type</span><span class=o>.</span><span class=n>create_stripped_model_type</span><span class=p>(</span>
+                <span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=nb>list</span><span class=p>(</span><span class=n>aliases_to_be_stripped</span><span class=p>)</span>
+            <span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;model_type: </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span>
+        <span class=k>return</span> <span class=n>singular_model_type</span><span class=p>,</span> <span class=n>model_alias</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get plural model directory from model type.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>model_type</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Not a valid model type: </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_TO_MODEL_DIR</span><span class=p>[</span><span class=n>model_type</span><span class=p>]</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_models_of_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get list of model names for requested type in trestle directory.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>model_type</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model type </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1> is not supported&#39;</span><span class=p>)</span>
+        <span class=c1># search relative to project root</span>
+        <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>root</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>trestle_root</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory </span><span class=si>{</span><span class=n>root</span><span class=si>}</span><span class=s1> is not within a trestle project.&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Given directory is not within a trestle project.&#39;</span><span class=p>)</span>
+
+        <span class=c1># contruct path to the model file name</span>
+        <span class=n>model_dir_name</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+        <span class=n>root_model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>model_dir_name</span>
+        <span class=n>model_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>f</span> <span class=ow>in</span> <span class=n>root_model_dir</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*/&#39;</span><span class=p>):</span>
+            <span class=c1># only look for proper json and yaml files</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_should_ignore</span><span class=p>(</span><span class=n>f</span><span class=o>.</span><span class=n>stem</span><span class=p>):</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>f</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;Ignoring validation of misplaced file </span><span class=si>{</span><span class=n>f</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> &#39;</span>
+                        <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;found in the model directory, </span><span class=si>{</span><span class=n>model_dir_name</span><span class=si>}</span><span class=s1>.&#39;</span>
+                    <span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>model_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>f</span><span class=o>.</span><span class=n>stem</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>model_list</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_all_models</span><span class=p>(</span><span class=n>root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get list of all models in trestle directory as tuples (model_type, model_name).&quot;&quot;&quot;</span>
+        <span class=n>full_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>model_type</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+            <span class=n>models</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_models_of_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>,</span> <span class=n>root</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>m</span> <span class=ow>in</span> <span class=n>models</span><span class=p>:</span>
+                <span class=n>full_list</span><span class=o>.</span><span class=n>append</span><span class=p>((</span><span class=n>model_type</span><span class=p>,</span> <span class=n>m</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>full_list</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_model_path_for_name_and_class</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>model_class</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>],</span>
+        <span class=n>file_content_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>FileContentType</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Find the full path of a model given its name, model type and file content type.</span>
+
+<span class=sd>        If file_content_type is given it will not inspect the file system or confirm the needed path and file exists.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>file_content_type</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>root_model_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_root_path_for_top_level_model</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span><span class=p>)</span>
+            <span class=n>file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>root_model_path</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>is_readable_file</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>):</span>
+                <span class=k>return</span> <span class=kc>None</span>
+
+            <span class=k>return</span> <span class=n>root_model_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>))</span>
+
+        <span class=n>root_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_root_path_for_top_level_model</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>root_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>))</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_singular_alias</span><span class=p>(</span><span class=n>alias_path</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>relative_path</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get the alias in the singular form from a jsonpath.</span>
+
+<span class=sd>        If contextual_mode is True and contextual_path is None, it assumes alias_path</span>
+<span class=sd>        is relative to the directory the user is running trestle from.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            alias_path: The current alias element path as a string</span>
+<span class=sd>            relative_path: Optional relative path (w.r.t. trestle_root) to cater for relative element paths.</span>
+<span class=sd>        Returns:</span>
+<span class=sd>            Alias as a string</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>alias_path</span><span class=o>.</span><span class=n>strip</span><span class=p>())</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid jsonpath </span><span class=si>{</span><span class=n>alias_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>singular_alias</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+
+        <span class=n>full_alias_path</span> <span class=o>=</span> <span class=n>alias_path</span>
+        <span class=k>if</span> <span class=n>relative_path</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get_singular_alias contextual mode: </span><span class=si>{</span><span class=nb>str</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>full_model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_relative_model_type</span><span class=p>(</span><span class=n>relative_path</span><span class=p>)</span>
+            <span class=n>first_alias_a</span> <span class=o>=</span> <span class=n>full_model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>first_alias_b</span> <span class=o>=</span> <span class=n>alias_path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>first_alias_a</span> <span class=o>==</span> <span class=n>first_alias_b</span><span class=p>:</span>
+                <span class=n>full_model_alias</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>full_model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[:</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+            <span class=n>full_alias_path</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=n>full_model_alias</span><span class=p>,</span> <span class=n>alias_path</span><span class=p>])</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+
+        <span class=n>path_parts</span> <span class=o>=</span> <span class=n>full_alias_path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>ALIAS_PATH_SEPARATOR</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;path parts: </span><span class=si>{</span><span class=n>path_parts</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>model_types</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=n>root_model_alias</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>found</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>for</span> <span class=n>module_name</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_TO_MODEL_MODULE</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_root_model</span><span class=p>(</span><span class=n>module_name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>root_model_alias</span> <span class=o>==</span> <span class=n>model_alias</span><span class=p>:</span>
+                <span class=n>found</span> <span class=o>=</span> <span class=kc>True</span>
+                <span class=n>model_types</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+                <span class=k>break</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>found</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>root_model_alias</span><span class=si>}</span><span class=s1> is an invalid root model alias.&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>root_model_alias</span>
+
+        <span class=n>model_type</span> <span class=o>=</span> <span class=n>model_types</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=c1># go through path parts skipping first one</span>
+        <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)):</span>
+            <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>):</span>
+                <span class=c1># if it is a collection type and last part is * then break</span>
+                <span class=k>if</span> <span class=n>i</span> <span class=o>==</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>-</span> <span class=mi>1</span> <span class=ow>and</span> <span class=n>path_parts</span><span class=p>[</span><span class=n>i</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+                    <span class=k>break</span>
+                <span class=c1># otherwise get the inner type of items in the collection</span>
+                <span class=n>model_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+                <span class=c1># and bump i</span>
+                <span class=n>i</span> <span class=o>=</span> <span class=n>i</span> <span class=o>+</span> <span class=mi>1</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>path_part</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+                <span class=n>field_map</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()</span>
+                <span class=k>if</span> <span class=n>path_part</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>field_map</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>field</span> <span class=o>=</span> <span class=n>field_map</span><span class=p>[</span><span class=n>path_part</span><span class=p>]</span>
+                <span class=n>model_type</span> <span class=o>=</span> <span class=n>field</span><span class=o>.</span><span class=n>outer_type_</span>
+            <span class=n>model_types</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+
+        <span class=n>last_alias</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>last_alias</span> <span class=o>==</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+            <span class=n>last_alias</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+
+        <span class=c1># generic model and not list, so return itself fixme doc</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>last_alias</span>
+
+        <span class=n>parent_model_type</span> <span class=o>=</span> <span class=n>model_types</span><span class=p>[</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>field_map</span> <span class=o>=</span> <span class=n>parent_model_type</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()</span>
+            <span class=n>field</span> <span class=o>=</span> <span class=n>field_map</span><span class=p>[</span><span class=n>last_alias</span><span class=p>]</span>
+            <span class=n>outer_type</span> <span class=o>=</span> <span class=n>field</span><span class=o>.</span><span class=n>outer_type_</span>
+            <span class=n>inner_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>outer_type</span><span class=p>)</span>
+            <span class=n>inner_type_name</span> <span class=o>=</span> <span class=n>inner_type</span><span class=o>.</span><span class=vm>__name__</span>
+            <span class=n>singular_alias</span> <span class=o>=</span> <span class=n>str_utils</span><span class=o>.</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>inner_type_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in json path </span><span class=si>{</span><span class=n>alias_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>singular_alias</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_root_model</span><span class=p>(</span><span class=n>module_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>],</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the root model class and alias based on the module.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>module</span> <span class=o>=</span> <span class=n>importlib</span><span class=o>.</span><span class=n>import_module</span><span class=p>(</span><span class=n>module_name</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>ModuleNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>))</span>
+
+        <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>module</span><span class=p>,</span> <span class=s1>&#39;Model&#39;</span><span class=p>):</span>
+            <span class=n>model_metadata</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=nb>iter</span><span class=p>(</span><span class=n>module</span><span class=o>.</span><span class=n>Model</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+            <span class=k>return</span> <span class=n>model_metadata</span><span class=o>.</span><span class=n>type_</span><span class=p>,</span> <span class=n>model_metadata</span><span class=o>.</span><span class=n>alias</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Invalid module&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_root_path_for_top_level_model</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>model_class</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>Type</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>]]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Find the root path to a model given its name and class - with no suffix.</span>
+
+<span class=sd>        This is a private method used only to construct the root filepath based on model name and type.</span>
+<span class=sd>        It does not check for existence or content type and it does not create the directory if it does not exist.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>model_class</span><span class=p>,</span> <span class=s1>&#39;__module__&#39;</span><span class=p>)</span> <span class=ow>or</span> <span class=n>model_class</span><span class=o>.</span><span class=vm>__module__</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_MODULE_LIST</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to determine model type for model </span><span class=si>{</span><span class=n>model_name</span><span class=si>}</span><span class=s1> with class </span><span class=si>{</span><span class=n>model_class</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>model_alias</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_MODULE_TO_MODEL_TYPE</span><span class=p>[</span><span class=n>model_class</span><span class=o>.</span><span class=vm>__module__</span><span class=p>]</span>
+        <span class=n>model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_TO_MODEL_DIR</span><span class=p>[</span><span class=n>model_alias</span><span class=p>]</span><span class=si>}</span><span class=s1>/</span><span class=si>{</span><span class=n>model_name</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>return</span> <span class=n>model_dir</span> <span class=o>/</span> <span class=n>model_alias</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_extract_alias</span><span class=p>(</span><span class=n>string_dir</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Extract alias from filename or directory name removing extensions and prefixes related to dict and list.</span>
+
+<span class=sd>        As we need to do this for multiple parts of a path operating on strings is easier.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>alias</span> <span class=o>=</span> <span class=n>string_dir</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>split</span><span class=p>(</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>IDX_SEP</span>
+        <span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>  <span class=c1># get suffix of file or directory name representing list or dict item</span>
+        <span class=k>return</span> <span class=n>alias</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_should_ignore</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if the file or directory should be ignored or not.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>name</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;.&#39;</span> <span class=ow>or</span> <span class=n>name</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;_&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_load_list</span><span class=p>(</span><span class=n>abs_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Given path to a directory of list(array) models, load the distributed models.&quot;&quot;&quot;</span>
+        <span class=n>aliases_not_to_be_stripped</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>instances_to_be_merged</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>collection_model_type</span><span class=p>,</span> <span class=n>collection_model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>abs_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>path</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>trestle</span><span class=o>.</span><span class=n>common</span><span class=o>.</span><span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>abs_path</span><span class=p>)):</span>
+
+            <span class=c1># ASSUMPTION HERE: if it is a directory, there&#39;s a file that can not be decomposed further.</span>
+            <span class=k>if</span> <span class=n>path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=k>continue</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>,</span> <span class=n>model_instance</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+
+            <span class=n>instances_to_be_merged</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_instance</span><span class=p>)</span>
+            <span class=n>aliases_not_to_be_stripped</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+
+        <span class=k>return</span> <span class=n>collection_model_type</span><span class=p>,</span> <span class=n>collection_model_alias</span><span class=p>,</span> <span class=n>instances_to_be_merged</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_parameter_to_dict_recurse</span><span class=p>(</span><span class=n>obj</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>partial</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Union</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Convert obj to dict containing only string values with recursion.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            obj: The parameter or its consituent parts in recursive calls</span>
+<span class=sd>            partial: Whether to convert the entire param or just the parts needed for markdown header</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The converted parameter as dictionary</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>main_fields</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;id&#39;</span><span class=p>,</span> <span class=s1>&#39;label&#39;</span><span class=p>,</span> <span class=s1>&#39;values&#39;</span><span class=p>,</span> <span class=s1>&#39;select&#39;</span><span class=p>,</span> <span class=s1>&#39;choice&#39;</span><span class=p>,</span> <span class=s1>&#39;how_many&#39;</span><span class=p>,</span> <span class=s1>&#39;guidelines&#39;</span><span class=p>,</span> <span class=s1>&#39;prose&#39;</span><span class=p>]</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>obj</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Remarks</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>obj</span><span class=o>.</span><span class=n>__root__</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>obj</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>HowMany</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>obj</span><span class=o>.</span><span class=n>value</span>
+        <span class=c1># it is either a string already or we cast it to string</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>obj</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>FIELDS_SET</span><span class=p>):</span>
+            <span class=k>return</span> <span class=nb>str</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span>
+        <span class=c1># it is an oscal object and we need to recurse within its attributes</span>
+        <span class=n>res</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>obj</span><span class=o>.</span><span class=n>__fields_set__</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>partial</span> <span class=ow>and</span> <span class=n>field</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>main_fields</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>attr</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>obj</span><span class=p>,</span> <span class=n>field</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>attr</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>attr</span><span class=p>,</span> <span class=nb>list</span><span class=p>):</span>
+                <span class=n>new_list</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>attr</span><span class=p>:</span>
+                    <span class=n>new_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ModelUtils</span><span class=o>.</span><span class=n>_parameter_to_dict_recurse</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>partial</span><span class=p>))</span>
+                <span class=n>res</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_list</span>
+            <span class=k>elif</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>attr</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+                <span class=n>res</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>attr</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>res</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_parameter_to_dict_recurse</span><span class=p>(</span><span class=n>attr</span><span class=p>,</span> <span class=n>partial</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>res</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>parameter_to_dict</span><span class=p>(</span><span class=n>obj</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>partial</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Union</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Convert obj to dict containing only string values, storing only the fields that have values set.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            obj: The parameter or its consituent parts in recursive calls</span>
+<span class=sd>            partial: Whether to convert the entire param or just the parts needed for markdown header</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The converted parameter as dictionary, with values as None if not present</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>res</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_parameter_to_dict_recurse</span><span class=p>(</span><span class=n>obj</span><span class=p>,</span> <span class=n>partial</span><span class=p>)</span>
+        <span class=k>if</span> <span class=s1>&#39;values&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>res</span><span class=p>:</span>
+            <span class=n>res</span><span class=p>[</span><span class=s1>&#39;values&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>  <span class=c1># type: ignore</span>
+        <span class=k>return</span> <span class=n>res</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_string_to_howmany</span><span class=p>(</span><span class=n>count_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+        <span class=n>clean_str</span> <span class=o>=</span> <span class=n>count_str</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39; &#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;_&#39;</span><span class=p>,</span> <span class=s1>&#39; &#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>clean_str</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ONE</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>common</span><span class=o>.</span><span class=n>HowMany</span><span class=o>.</span><span class=n>one</span>  <span class=c1># type: ignore</span>
+        <span class=k>if</span> <span class=n>clean_str</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ONE_OR_MORE_SPACED</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>common</span><span class=o>.</span><span class=n>HowMany</span><span class=o>.</span><span class=n>one_or_more</span>  <span class=c1># type: ignore</span>
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>dict_to_parameter</span><span class=p>(</span><span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Convert dict with only string values to Parameter with handling for HowMany and with validity checks.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            param_dict: Dictionary of pure string values representing Parameter contents</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            A valid OSCAL Parameter</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            This handles both partial and full parameter dictionaries</span>
+<span class=sd>            It checks for validity of the values if a select and HowMany is specified</span>
+<span class=sd>            There is special handling for values: If it is a single string it is converted to list of one ParameterValue</span>
+<span class=sd>            But if it is a list of strings is regarded as a list of values and is converted to a list of ParameterValues</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>values</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;values&#39;</span><span class=p>,</span> <span class=p>[])</span>
+        <span class=c1># special handling when only one value present - convert to list of 1</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>values</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+            <span class=n>values</span> <span class=o>=</span> <span class=p>[</span><span class=n>values</span><span class=p>]</span>
+            <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;values&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>values</span>
+        <span class=k>if</span> <span class=s1>&#39;select&#39;</span> <span class=ow>in</span> <span class=n>param_dict</span> <span class=ow>and</span> <span class=s1>&#39;how_many&#39;</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;select&#39;</span><span class=p>]:</span>
+            <span class=n>count_str</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;select&#39;</span><span class=p>][</span><span class=s1>&#39;how_many&#39;</span><span class=p>]</span>
+            <span class=n>how_many</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_string_to_howmany</span><span class=p>(</span><span class=n>count_str</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>how_many</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unrecognized HowMany value </span><span class=si>{</span><span class=n>how_many</span><span class=si>}</span><span class=s1> in Parameter: should be one-or-more or one.&#39;</span><span class=p>)</span>
+            <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;select&#39;</span><span class=p>][</span><span class=s1>&#39;how_many&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>how_many</span>
+            <span class=k>if</span> <span class=n>how_many</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ONE</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=n>values</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Parameter specifies HowMany=1 but has </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>values</span><span class=p>)</span><span class=si>}</span><span class=s1> values given.&#39;</span><span class=p>)</span>
+            <span class=n>choices</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;select&#39;</span><span class=p>]</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;choice&#39;</span><span class=p>,</span> <span class=p>[])</span>
+            <span class=k>if</span> <span class=n>choices</span> <span class=ow>and</span> <span class=n>values</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>values</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>value</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>choices</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s2>&quot;Parameter </span><span class=si>{</span><span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;id&#39;</span><span class=p>]</span><span class=si>}</span><span class=s2> has value </span><span class=se>\&quot;</span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=se>\&quot;</span><span class=s2> not in choices: </span><span class=si>{</span><span class=n>choices</span><span class=si>}</span><span class=s2>.&quot;</span><span class=p>)</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;props&#39;</span><span class=p>,</span> <span class=p>[])</span>
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+            <span class=n>display_name</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>)</span>
+            <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>display_name</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GENERIC_NS</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+            <span class=c1># removing aggregates as this is prop just informative in markdown</span>
+            <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span><span class=p>)</span>
+        <span class=n>param_value_origin</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+            <span class=n>param_value_origin</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>param_value_origin</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>param_value_origin</span><span class=p>))</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Parameter value origin property for parameter </span><span class=si>{</span><span class=n>param_dict</span><span class=p>[</span><span class=s2>&quot;id&quot;</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=s1>&#39;is None and it should have a value&#39;</span>
+                <span class=p>)</span>
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>ALT_IDENTIFIER</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+            <span class=c1># removing alt-identifier as this is prop just informative in markdown</span>
+            <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>ALT_IDENTIFIER</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=s1>&#39;ns&#39;</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+            <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;ns&#39;</span><span class=p>)</span>
+        <span class=n>param</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>(</span><span class=o>**</span><span class=n>param_dict</span><span class=p>)</span>
+        <span class=n>param</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>props</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>param</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>last_modified_at_time</span><span class=p>(</span><span class=n>timestamp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>datetime</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate a LastModified set to timestamp or now.&quot;&quot;&quot;</span>
+        <span class=n>timestamp</span> <span class=o>=</span> <span class=n>timestamp</span> <span class=k>if</span> <span class=n>timestamp</span> <span class=k>else</span> <span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span><span class=o>.</span><span class=n>astimezone</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>timestamp</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>update_last_modified</span><span class=p>(</span><span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update the LastModified timestamp in top level model to now.&quot;&quot;&quot;</span>
+        <span class=n>timestamp</span> <span class=o>=</span> <span class=n>timestamp</span> <span class=k>if</span> <span class=n>timestamp</span> <span class=k>else</span> <span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span><span class=o>.</span><span class=n>astimezone</span><span class=p>()</span>
+        <span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>last_modified</span> <span class=o>=</span> <span class=n>timestamp</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>model_age</span><span class=p>(</span><span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find time in seconds since LastModified timestamp.&quot;&quot;&quot;</span>
+        <span class=c1># default to one year if no last_modified</span>
+        <span class=n>age_seconds</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>DAY_SECONDS</span> <span class=o>*</span> <span class=mi>365</span>
+        <span class=k>if</span> <span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>last_modified</span><span class=p>:</span>
+            <span class=n>dt</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span><span class=o>.</span><span class=n>astimezone</span><span class=p>()</span> <span class=o>-</span> <span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>last_modified</span>
+            <span class=n>age_seconds</span> <span class=o>=</span> <span class=n>dt</span><span class=o>.</span><span class=n>seconds</span>
+        <span class=k>return</span> <span class=n>age_seconds</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>find_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>Any</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Traverse object and return list of values of specified name.&quot;&quot;&quot;</span>
+        <span class=n>loe</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>BaseModel</span><span class=p>):</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>loe</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>value</span><span class=p>)</span>
+            <span class=n>fields</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>FIELDS_SET</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>fields</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>fields</span><span class=p>:</span>
+                    <span class=n>loe</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span>
+                        <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=nb>getattr</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>field</span><span class=p>,</span> <span class=kc>None</span><span class=p>),</span> <span class=n>name_of_interest</span><span class=p>)</span>
+                    <span class=p>)</span>
+        <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=p>:</span>
+                <span class=n>loe</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>))</span>
+        <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>name_of_interest</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=p>:</span>
+                <span class=n>loe</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>[</span><span class=n>name_of_interest</span><span class=p>])</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+                <span class=n>loe</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>loe</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>has_no_duplicate_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>BaseModel</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Determine if duplicate values of type exist in object.&quot;&quot;&quot;</span>
+        <span class=n>loe</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>)</span>
+        <span class=n>set_loe</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>loe</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>loe</span><span class=p>)</span> <span class=o>==</span> <span class=nb>len</span><span class=p>(</span><span class=n>set_loe</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=n>items</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>loe</span><span class=p>:</span>
+            <span class=n>items</span><span class=p>[</span><span class=n>item</span><span class=p>]</span> <span class=o>=</span> <span class=n>items</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=mi>0</span><span class=p>)</span> <span class=o>+</span> <span class=mi>1</span>
+        <span class=c1># now print items</span>
+        <span class=k>for</span> <span class=n>item</span><span class=p>,</span> <span class=n>instances</span> <span class=ow>in</span> <span class=n>items</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>instances</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Duplicate detected of item </span><span class=si>{</span><span class=n>item</span><span class=si>}</span><span class=s1> with </span><span class=si>{</span><span class=n>instances</span><span class=si>}</span><span class=s1> instances.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>find_uuid_refs</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>BaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find uuid references made in prose and links.&quot;&quot;&quot;</span>
+        <span class=c1># hrefs have form #foo or #uuid</span>
+        <span class=n>uuid_strs</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=s1>&#39;href&#39;</span><span class=p>)</span>
+
+        <span class=c1># prose has uuid refs in markdown form: [foo](#bar) or [foo](#uuid)</span>
+        <span class=n>prose_list</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=s1>&#39;prose&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>prose</span> <span class=ow>in</span> <span class=n>prose_list</span><span class=p>:</span>
+            <span class=n>matches</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_URL_REGEX</span><span class=p>,</span> <span class=n>prose</span><span class=p>)</span>
+            <span class=c1># the [1] is to extract the inner of 3 capture patterns</span>
+            <span class=n>new_uuids</span> <span class=o>=</span> <span class=p>[</span><span class=n>match</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span> <span class=k>for</span> <span class=n>match</span> <span class=ow>in</span> <span class=n>matches</span><span class=p>]</span>
+            <span class=n>uuid_strs</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>new_uuids</span><span class=p>)</span>
+
+        <span class=c1># collect the strings that start with # and are potential uuids</span>
+        <span class=n>uuid_strs</span> <span class=o>=</span> <span class=p>[</span><span class=n>uuid_str</span> <span class=k>for</span> <span class=n>uuid_str</span> <span class=ow>in</span> <span class=n>uuid_strs</span> <span class=k>if</span> <span class=n>uuid_str</span> <span class=ow>and</span> <span class=n>uuid_str</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;#&#39;</span><span class=p>]</span>
+
+        <span class=c1># go through all matches and build set of those that are uuids</span>
+        <span class=n>uuid_set</span> <span class=o>=</span> <span class=p>{</span><span class=n>uuid_match</span> <span class=k>for</span> <span class=n>uuid_str</span> <span class=ow>in</span> <span class=n>uuid_strs</span> <span class=k>for</span> <span class=n>uuid_match</span> <span class=ow>in</span> <span class=n>re</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>UUID_REGEX</span><span class=p>,</span> <span class=n>uuid_str</span><span class=p>[</span><span class=mi>1</span><span class=p>:])}</span>
+        <span class=k>return</span> <span class=n>uuid_set</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_regenerate_uuids_in_place</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>Any</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update all uuids in model that require updating.</span>
+
+<span class=sd>        Go through the model and replace all dicts with key == &#39;uuid&#39; and replace the value with a new uuid4.</span>
+<span class=sd>        Build a lookup table of the updates that were made.</span>
+<span class=sd>        This function does not update the corresponding refs to those uuid&#39;s.  That is done by update_uuid_refs</span>
+<span class=sd>        Note that this function needs to be started off with uuid_lut == {}, i.e. an empty dict.</span>
+<span class=sd>        After that it recurses and grows the lut.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            object_of_interest: pydantic.BaseModel, list, dict or str will be updated</span>
+<span class=sd>            uuid_lut: dict of the growing lut of old:new uuid&#39;s.  First call must be made with value {}</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The updated object_of_interest with new uuid&#39;s (but refs to them are not updated)</span>
+<span class=sd>            The final lookup table of old:new uuid&#39;s</span>
+
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>uuid_str</span> <span class=o>=</span> <span class=s1>&#39;uuid&#39;</span>
+        <span class=c1># Certain types are known not to need updating and should not change</span>
+        <span class=c1># Resources are identified by uuid, and the corresponding href will have # in front of the uuid string</span>
+        <span class=c1># Neither of these should change</span>
+        <span class=c1># If other similar types are found they should be added to the FixedUuidModel typevar to prevent updating</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Resource</span><span class=p>):</span>
+            <span class=k>pass</span>
+        <span class=k>elif</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>BaseModel</span><span class=p>):</span>
+            <span class=c1># fields has names of all fields in model</span>
+            <span class=n>fields</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>FIELDS_SET</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>fields</span><span class=p>:</span>
+                <span class=n>new_object</span> <span class=o>=</span> <span class=kc>None</span>
+                <span class=k>if</span> <span class=n>field</span> <span class=o>==</span> <span class=n>uuid_str</span><span class=p>:</span>
+                    <span class=n>orig_uuid</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>field</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>orig_uuid</span><span class=p>:</span>
+                        <span class=n>new_object</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+                        <span class=n>uuid_lut</span><span class=p>[</span><span class=n>orig_uuid</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_object</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>new_object</span><span class=p>,</span> <span class=n>uuid_lut</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_regenerate_uuids_in_place</span><span class=p>(</span>
+                        <span class=n>object_of_interest</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>field</span><span class=p>],</span>
+                        <span class=n>uuid_lut</span>
+                    <span class=p>)</span>
+                <span class=n>object_of_interest</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_object</span>
+        <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+            <span class=n>new_list</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=p>:</span>
+                <span class=n>new_item</span><span class=p>,</span> <span class=n>uuid_lut</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_regenerate_uuids_in_place</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>)</span>
+                <span class=n>new_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_item</span><span class=p>)</span>
+            <span class=n>object_of_interest</span> <span class=o>=</span> <span class=n>new_list</span>
+        <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+            <span class=n>new_dict</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>key</span> <span class=o>==</span> <span class=n>uuid_str</span><span class=p>:</span>
+                    <span class=n>new_val</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+                    <span class=n>new_dict</span><span class=p>[</span><span class=n>uuid_str</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_val</span>
+                    <span class=n>uuid_lut</span><span class=p>[</span><span class=n>value</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_val</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>new_value</span><span class=p>,</span> <span class=n>uuid_lut</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_regenerate_uuids_in_place</span><span class=p>(</span><span class=n>value</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>)</span>
+                    <span class=n>new_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_value</span>
+            <span class=n>object_of_interest</span> <span class=o>=</span> <span class=n>new_dict</span>
+        <span class=k>return</span> <span class=n>object_of_interest</span><span class=p>,</span> <span class=n>uuid_lut</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_update_new_uuid_refs</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>Any</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update all refs to uuids that were changed.&quot;&quot;&quot;</span>
+        <span class=n>n_refs_updated</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>BaseModel</span><span class=p>):</span>
+            <span class=n>fields</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>FIELDS_SET</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>fields</span><span class=p>:</span>
+                <span class=n>new_object</span><span class=p>,</span> <span class=n>n_new_updates</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_update_new_uuid_refs</span><span class=p>(</span>
+                    <span class=n>object_of_interest</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>field</span><span class=p>],</span>
+                    <span class=n>uuid_lut</span>
+                <span class=p>)</span>
+                <span class=n>n_refs_updated</span> <span class=o>+=</span> <span class=n>n_new_updates</span>
+                <span class=n>object_of_interest</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_object</span>
+        <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+            <span class=n>new_list</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=p>:</span>
+                <span class=n>new_item</span><span class=p>,</span> <span class=n>n_new_updates</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_update_new_uuid_refs</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>)</span>
+                <span class=n>n_refs_updated</span> <span class=o>+=</span> <span class=n>n_new_updates</span>
+                <span class=n>new_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_item</span><span class=p>)</span>
+            <span class=n>object_of_interest</span> <span class=o>=</span> <span class=n>new_list</span>
+        <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+            <span class=n>new_dict</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>value</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>uuid_lut</span><span class=p>:</span>
+                        <span class=n>new_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>uuid_lut</span><span class=p>[</span><span class=n>value</span><span class=p>]</span>
+                        <span class=n>n_refs_updated</span> <span class=o>+=</span> <span class=mi>1</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>new_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>value</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>new_value</span><span class=p>,</span> <span class=n>n_new_updates</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_update_new_uuid_refs</span><span class=p>(</span><span class=n>value</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>)</span>
+                    <span class=n>n_refs_updated</span> <span class=o>+=</span> <span class=n>n_new_updates</span>
+                    <span class=n>new_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_value</span>
+            <span class=n>object_of_interest</span> <span class=o>=</span> <span class=n>new_dict</span>
+        <span class=k>elif</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>object_of_interest</span> <span class=ow>in</span> <span class=n>uuid_lut</span><span class=p>:</span>
+                <span class=n>n_refs_updated</span> <span class=o>+=</span> <span class=mi>1</span>
+                <span class=n>object_of_interest</span> <span class=o>=</span> <span class=n>uuid_lut</span><span class=p>[</span><span class=n>object_of_interest</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>object_of_interest</span><span class=p>,</span> <span class=n>n_refs_updated</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>regenerate_uuids</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Regenerate all uuids in object and update corresponding references.</span>
+
+<span class=sd>        Find all dicts with key == &#39;uuid&#39; and replace the value with a new uuid4.</span>
+<span class=sd>        Build a corresponding lookup table as you go, of old:new uuid values.</span>
+<span class=sd>        Then make a second pass through the object and replace all string values</span>
+<span class=sd>        present in the lookup table with the new value.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            object_of_interest: pydantic.BaseModel, list, dict or str will be updated</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The updated object with new uuid&#39;s and refs</span>
+<span class=sd>            The final lookup table of old:new uuid&#39;s</span>
+<span class=sd>            A count of the number of refs that were updated</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>new_object</span><span class=p>,</span> <span class=n>uuid_lut</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_regenerate_uuids_in_place</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>new_object</span><span class=p>,</span> <span class=n>n_refs_updated</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_update_new_uuid_refs</span><span class=p>(</span><span class=n>new_object</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>new_object</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>,</span> <span class=n>n_refs_updated</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>fields_set_non_none</span><span class=p>(</span><span class=n>obj</span><span class=p>:</span> <span class=n>BaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find the fields set with Nones and empty items removed.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>set</span><span class=p>(</span><span class=n>as_filtered_list</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>obj</span><span class=o>.</span><span class=n>__fields_set__</span><span class=p>),</span> <span class=k>lambda</span> <span class=n>f</span><span class=p>:</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>obj</span><span class=p>,</span> <span class=n>f</span><span class=p>)))</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_objects_differ</span><span class=p>(</span>
+        <span class=n>obj_a</span><span class=p>:</span> <span class=n>Any</span><span class=p>,</span> <span class=n>obj_b</span><span class=p>:</span> <span class=n>Any</span><span class=p>,</span> <span class=n>ignore_type_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>],</span> <span class=n>ignore_name_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>ignore_all_uuid</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Compare two objects with option to ignore given types.</span>
+
+<span class=sd>        This does not check for tuples or other structures that won&#39;t be found in JSON.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>obj_a_type</span> <span class=o>=</span> <span class=nb>type</span><span class=p>(</span><span class=n>obj_a</span><span class=p>)</span>
+        <span class=n>obj_b_type</span> <span class=o>=</span> <span class=nb>type</span><span class=p>(</span><span class=n>obj_b</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>bool</span><span class=p>(</span><span class=n>obj_a</span><span class=p>)</span> <span class=o>!=</span> <span class=nb>bool</span><span class=p>(</span><span class=n>obj_b</span><span class=p>)</span> <span class=ow>or</span> <span class=n>obj_a_type</span> <span class=o>!=</span> <span class=n>obj_b_type</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>bool</span><span class=p>(</span><span class=n>obj_a</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=n>obj_a_type</span> <span class=ow>in</span> <span class=n>ignore_type_list</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=n>obj_a_type</span> <span class=ow>is</span> <span class=nb>str</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>obj_a</span> <span class=o>!=</span> <span class=n>obj_b</span>
+        <span class=k>elif</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>obj_a</span><span class=p>,</span> <span class=n>BaseModel</span><span class=p>):</span>
+            <span class=n>fields_a</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>fields_set_non_none</span><span class=p>(</span><span class=n>obj_a</span><span class=p>)</span>
+            <span class=n>fields_b</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>fields_set_non_none</span><span class=p>(</span><span class=n>obj_b</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>fields_a</span> <span class=o>!=</span> <span class=n>fields_b</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>True</span>
+            <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>list_utils</span><span class=o>.</span><span class=n>as_filtered_list</span><span class=p>(</span><span class=n>fields_a</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>f</span><span class=p>:</span> <span class=n>f</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>ignore_name_list</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=k>if</span> <span class=n>ignore_all_uuid</span> <span class=ow>and</span> <span class=s1>&#39;uuid&#39;</span> <span class=ow>in</span> <span class=n>field</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_objects_differ</span><span class=p>(</span><span class=nb>getattr</span><span class=p>(</span><span class=n>obj_a</span><span class=p>,</span> <span class=n>field</span><span class=p>),</span>
+                                              <span class=nb>getattr</span><span class=p>(</span><span class=n>obj_b</span><span class=p>,</span> <span class=n>field</span><span class=p>),</span>
+                                              <span class=n>ignore_type_list</span><span class=p>,</span>
+                                              <span class=n>ignore_name_list</span><span class=p>,</span>
+                                              <span class=n>ignore_all_uuid</span><span class=p>):</span>
+                    <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>elif</span> <span class=n>obj_a_type</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>obj_a</span><span class=p>)</span> <span class=o>!=</span> <span class=nb>len</span><span class=p>(</span><span class=n>obj_b</span><span class=p>):</span>
+                <span class=k>return</span> <span class=kc>True</span>
+            <span class=k>for</span> <span class=n>item_a</span><span class=p>,</span> <span class=n>item_b</span> <span class=ow>in</span> <span class=nb>zip</span><span class=p>(</span><span class=n>obj_a</span><span class=p>,</span> <span class=n>obj_b</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_objects_differ</span><span class=p>(</span><span class=n>item_a</span><span class=p>,</span> <span class=n>item_b</span><span class=p>,</span> <span class=n>ignore_type_list</span><span class=p>,</span> <span class=n>ignore_name_list</span><span class=p>,</span> <span class=n>ignore_all_uuid</span><span class=p>):</span>
+                    <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>elif</span> <span class=n>obj_a_type</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>obj_a</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=o>!=</span> <span class=n>obj_b</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=k>return</span> <span class=kc>True</span>
+            <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>val</span> <span class=ow>in</span> <span class=n>obj_a</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>ignore_all_uuid</span> <span class=ow>and</span> <span class=s1>&#39;uuid&#39;</span> <span class=ow>in</span> <span class=n>key</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>ignore_name_list</span> <span class=ow>and</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_objects_differ</span><span class=p>(</span>
+                        <span class=n>val</span><span class=p>,</span> <span class=n>obj_b</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>ignore_type_list</span><span class=p>,</span> <span class=n>ignore_name_list</span><span class=p>,</span> <span class=n>ignore_all_uuid</span><span class=p>):</span>
+                    <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>elif</span> <span class=n>obj_a</span> <span class=o>!=</span> <span class=n>obj_b</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>models_are_equivalent</span><span class=p>(</span>
+        <span class=n>model_a</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>],</span>
+        <span class=n>model_b</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>],</span>
+        <span class=n>ignore_all_uuid</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Test if models are equivalent except for last modified and possibly uuid.</span>
+
+<span class=sd>        If a model has had uuids regenerated, then all uuids *and references to them* are updated.  This means that</span>
+<span class=sd>        special handling is required if a model has had uuids regenerated - when checking equivalence.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>uuid_type_list</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>common</span><span class=o>.</span><span class=n>LastModified</span><span class=p>,</span>
+            <span class=n>common</span><span class=o>.</span><span class=n>LocationUuid</span><span class=p>,</span>
+            <span class=n>common</span><span class=o>.</span><span class=n>PartyUuid</span><span class=p>,</span>
+            <span class=n>common</span><span class=o>.</span><span class=n>RelatedRisk</span><span class=p>,</span>
+            <span class=n>common</span><span class=o>.</span><span class=n>Source</span><span class=p>,</span>
+            <span class=n>assessment_plan</span><span class=o>.</span><span class=n>RelatedObservation</span><span class=p>,</span>
+            <span class=n>assessment_results</span><span class=o>.</span><span class=n>RelatedObservation</span><span class=p>,</span>
+            <span class=n>poam</span><span class=o>.</span><span class=n>RelatedObservation</span><span class=p>,</span>
+            <span class=n>poam</span><span class=o>.</span><span class=n>RelatedObservation1</span>
+        <span class=p>]</span>
+        <span class=n>type_list</span> <span class=o>=</span> <span class=n>uuid_type_list</span> <span class=k>if</span> <span class=n>ignore_all_uuid</span> <span class=k>else</span> <span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>LastModified</span><span class=p>]</span>
+        <span class=k>return</span> <span class=ow>not</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_objects_differ</span><span class=p>(</span><span class=n>model_a</span><span class=p>,</span> <span class=n>model_b</span><span class=p>,</span> <span class=n>type_list</span><span class=p>,</span> <span class=p>[</span><span class=s1>&#39;last_modified&#39;</span><span class=p>],</span> <span class=n>ignore_all_uuid</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_title_from_model_uri</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get title from model at uri.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>fetcher</span> <span class=o>=</span> <span class=n>cache</span><span class=o>.</span><span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_fetcher</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>
+            <span class=n>model</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>fetcher</span><span class=o>.</span><span class=n>get_oscal</span><span class=p>()</span>
+            <span class=k>return</span> <span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span>
+        <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error finding title for model at uri </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>raise</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.common.model_utils.ModelUtils-functions>Functions<a href=#trestle.common.model_utils.ModelUtils-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.dict_to_parameter class="doc doc-heading"> <code class="highlight language-python"><span class=n>dict_to_parameter</span><span class=p>(</span><span class=n>param_dict</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.dict_to_parameter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert dict with only string values to Parameter with handling for HowMany and with validity checks.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>param_dict</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, <span title=typing.Any>Any</span>]</code> </td> <td> <div class=doc-md-description> <p>Dictionary of pure string values representing Parameter contents</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.common.Parameter href=../../oscal/common/#trestle.oscal.common.Parameter>Parameter</a></code> </td> <td> <div class=doc-md-description> <p>A valid OSCAL Parameter</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>This handles both partial and full parameter dictionaries It checks for validity of the values if a select and HowMany is specified There is special handling for values: If it is a single string it is converted to list of one ParameterValue But if it is a list of strings is regarded as a list of values and is converted to a list of ParameterValues</p> </details> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>dict_to_parameter</span><span class=p>(</span><span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Convert dict with only string values to Parameter with handling for HowMany and with validity checks.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        param_dict: Dictionary of pure string values representing Parameter contents</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        A valid OSCAL Parameter</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        This handles both partial and full parameter dictionaries</span>
+<span class=sd>        It checks for validity of the values if a select and HowMany is specified</span>
+<span class=sd>        There is special handling for values: If it is a single string it is converted to list of one ParameterValue</span>
+<span class=sd>        But if it is a list of strings is regarded as a list of values and is converted to a list of ParameterValues</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>values</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;values&#39;</span><span class=p>,</span> <span class=p>[])</span>
+    <span class=c1># special handling when only one value present - convert to list of 1</span>
+    <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>values</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+        <span class=n>values</span> <span class=o>=</span> <span class=p>[</span><span class=n>values</span><span class=p>]</span>
+        <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;values&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>values</span>
+    <span class=k>if</span> <span class=s1>&#39;select&#39;</span> <span class=ow>in</span> <span class=n>param_dict</span> <span class=ow>and</span> <span class=s1>&#39;how_many&#39;</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;select&#39;</span><span class=p>]:</span>
+        <span class=n>count_str</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;select&#39;</span><span class=p>][</span><span class=s1>&#39;how_many&#39;</span><span class=p>]</span>
+        <span class=n>how_many</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_string_to_howmany</span><span class=p>(</span><span class=n>count_str</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>how_many</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unrecognized HowMany value </span><span class=si>{</span><span class=n>how_many</span><span class=si>}</span><span class=s1> in Parameter: should be one-or-more or one.&#39;</span><span class=p>)</span>
+        <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;select&#39;</span><span class=p>][</span><span class=s1>&#39;how_many&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>how_many</span>
+        <span class=k>if</span> <span class=n>how_many</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ONE</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=n>values</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Parameter specifies HowMany=1 but has </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>values</span><span class=p>)</span><span class=si>}</span><span class=s1> values given.&#39;</span><span class=p>)</span>
+        <span class=n>choices</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;select&#39;</span><span class=p>]</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;choice&#39;</span><span class=p>,</span> <span class=p>[])</span>
+        <span class=k>if</span> <span class=n>choices</span> <span class=ow>and</span> <span class=n>values</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>values</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>value</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>choices</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s2>&quot;Parameter </span><span class=si>{</span><span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;id&#39;</span><span class=p>]</span><span class=si>}</span><span class=s2> has value </span><span class=se>\&quot;</span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=se>\&quot;</span><span class=s2> not in choices: </span><span class=si>{</span><span class=n>choices</span><span class=si>}</span><span class=s2>.&quot;</span><span class=p>)</span>
+    <span class=n>props</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;props&#39;</span><span class=p>,</span> <span class=p>[])</span>
+    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+        <span class=n>display_name</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>)</span>
+        <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>display_name</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GENERIC_NS</span><span class=p>))</span>
+    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+        <span class=c1># removing aggregates as this is prop just informative in markdown</span>
+        <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span><span class=p>)</span>
+    <span class=n>param_value_origin</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+        <span class=n>param_value_origin</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>param_value_origin</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>param_value_origin</span><span class=p>))</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Parameter value origin property for parameter </span><span class=si>{</span><span class=n>param_dict</span><span class=p>[</span><span class=s2>&quot;id&quot;</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=s1>&#39;is None and it should have a value&#39;</span>
+            <span class=p>)</span>
+    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>ALT_IDENTIFIER</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+        <span class=c1># removing alt-identifier as this is prop just informative in markdown</span>
+        <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>ALT_IDENTIFIER</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=s1>&#39;ns&#39;</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+        <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;ns&#39;</span><span class=p>)</span>
+    <span class=n>param</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>(</span><span class=o>**</span><span class=n>param_dict</span><span class=p>)</span>
+    <span class=n>param</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>props</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>param</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.fields_set_non_none class="doc doc-heading"> <code class="highlight language-python"><span class=n>fields_set_non_none</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.fields_set_non_none class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find the fields set with Nones and empty items removed.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>860</span>
+<span class=normal>861</span>
+<span class=normal>862</span>
+<span class=normal>863</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>fields_set_non_none</span><span class=p>(</span><span class=n>obj</span><span class=p>:</span> <span class=n>BaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find the fields set with Nones and empty items removed.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>set</span><span class=p>(</span><span class=n>as_filtered_list</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>obj</span><span class=o>.</span><span class=n>__fields_set__</span><span class=p>),</span> <span class=k>lambda</span> <span class=n>f</span><span class=p>:</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>obj</span><span class=p>,</span> <span class=n>f</span><span class=p>)))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.find_uuid_refs class="doc doc-heading"> <code class="highlight language-python"><span class=n>find_uuid_refs</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.find_uuid_refs class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find uuid references made in prose and links.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>717</span>
+<span class=normal>718</span>
+<span class=normal>719</span>
+<span class=normal>720</span>
+<span class=normal>721</span>
+<span class=normal>722</span>
+<span class=normal>723</span>
+<span class=normal>724</span>
+<span class=normal>725</span>
+<span class=normal>726</span>
+<span class=normal>727</span>
+<span class=normal>728</span>
+<span class=normal>729</span>
+<span class=normal>730</span>
+<span class=normal>731</span>
+<span class=normal>732</span>
+<span class=normal>733</span>
+<span class=normal>734</span>
+<span class=normal>735</span>
+<span class=normal>736</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>find_uuid_refs</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>BaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find uuid references made in prose and links.&quot;&quot;&quot;</span>
+    <span class=c1># hrefs have form #foo or #uuid</span>
+    <span class=n>uuid_strs</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=s1>&#39;href&#39;</span><span class=p>)</span>
+
+    <span class=c1># prose has uuid refs in markdown form: [foo](#bar) or [foo](#uuid)</span>
+    <span class=n>prose_list</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=s1>&#39;prose&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>prose</span> <span class=ow>in</span> <span class=n>prose_list</span><span class=p>:</span>
+        <span class=n>matches</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_URL_REGEX</span><span class=p>,</span> <span class=n>prose</span><span class=p>)</span>
+        <span class=c1># the [1] is to extract the inner of 3 capture patterns</span>
+        <span class=n>new_uuids</span> <span class=o>=</span> <span class=p>[</span><span class=n>match</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span> <span class=k>for</span> <span class=n>match</span> <span class=ow>in</span> <span class=n>matches</span><span class=p>]</span>
+        <span class=n>uuid_strs</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>new_uuids</span><span class=p>)</span>
+
+    <span class=c1># collect the strings that start with # and are potential uuids</span>
+    <span class=n>uuid_strs</span> <span class=o>=</span> <span class=p>[</span><span class=n>uuid_str</span> <span class=k>for</span> <span class=n>uuid_str</span> <span class=ow>in</span> <span class=n>uuid_strs</span> <span class=k>if</span> <span class=n>uuid_str</span> <span class=ow>and</span> <span class=n>uuid_str</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;#&#39;</span><span class=p>]</span>
+
+    <span class=c1># go through all matches and build set of those that are uuids</span>
+    <span class=n>uuid_set</span> <span class=o>=</span> <span class=p>{</span><span class=n>uuid_match</span> <span class=k>for</span> <span class=n>uuid_str</span> <span class=ow>in</span> <span class=n>uuid_strs</span> <span class=k>for</span> <span class=n>uuid_match</span> <span class=ow>in</span> <span class=n>re</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>UUID_REGEX</span><span class=p>,</span> <span class=n>uuid_str</span><span class=p>[</span><span class=mi>1</span><span class=p>:])}</span>
+    <span class=k>return</span> <span class=n>uuid_set</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.find_values_by_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.find_values_by_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Traverse object and return list of values of specified name.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>677</span>
+<span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span>
+<span class=normal>685</span>
+<span class=normal>686</span>
+<span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>find_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>Any</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Traverse object and return list of values of specified name.&quot;&quot;&quot;</span>
+    <span class=n>loe</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>BaseModel</span><span class=p>):</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>loe</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>value</span><span class=p>)</span>
+        <span class=n>fields</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>FIELDS_SET</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>fields</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>fields</span><span class=p>:</span>
+                <span class=n>loe</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span>
+                    <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=nb>getattr</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>field</span><span class=p>,</span> <span class=kc>None</span><span class=p>),</span> <span class=n>name_of_interest</span><span class=p>)</span>
+                <span class=p>)</span>
+    <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=p>:</span>
+            <span class=n>loe</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>))</span>
+    <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>name_of_interest</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=p>:</span>
+            <span class=n>loe</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>[</span><span class=n>name_of_interest</span><span class=p>])</span>
+        <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>object_of_interest</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=n>loe</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>))</span>
+    <span class=k>return</span> <span class=n>loe</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.get_all_models class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all_models</span><span class=p>(</span><span class=n>root</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.get_all_models class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get list of all models in trestle directory as tuples (model_type, model_name).</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_all_models</span><span class=p>(</span><span class=n>root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get list of all models in trestle directory as tuples (model_type, model_name).&quot;&quot;&quot;</span>
+    <span class=n>full_list</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>model_type</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+        <span class=n>models</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_models_of_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>,</span> <span class=n>root</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>m</span> <span class=ow>in</span> <span class=n>models</span><span class=p>:</span>
+            <span class=n>full_list</span><span class=o>.</span><span class=n>append</span><span class=p>((</span><span class=n>model_type</span><span class=p>,</span> <span class=n>m</span><span class=p>))</span>
+    <span class=k>return</span> <span class=n>full_list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.get_model_path_for_name_and_class class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span><span class=p>,</span> <span class=n>file_content_type</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.get_model_path_for_name_and_class class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find the full path of a model given its name, model type and file content type.</p> <p>If file_content_type is given it will not inspect the file system or confirm the needed path and file exists.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_model_path_for_name_and_class</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>model_class</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>],</span>
+    <span class=n>file_content_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>FileContentType</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Find the full path of a model given its name, model type and file content type.</span>
+
+<span class=sd>    If file_content_type is given it will not inspect the file system or confirm the needed path and file exists.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>file_content_type</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>root_model_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_root_path_for_top_level_model</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span><span class=p>)</span>
+        <span class=n>file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>root_model_path</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>is_readable_file</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>None</span>
+
+        <span class=k>return</span> <span class=n>root_model_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>))</span>
+
+    <span class=n>root_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_root_path_for_top_level_model</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>root_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.get_models_of_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_models_of_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>,</span> <span class=n>root</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.get_models_of_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get list of model names for requested type in trestle directory.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_models_of_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get list of model names for requested type in trestle directory.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>model_type</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model type </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1> is not supported&#39;</span><span class=p>)</span>
+    <span class=c1># search relative to project root</span>
+    <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>root</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>trestle_root</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory </span><span class=si>{</span><span class=n>root</span><span class=si>}</span><span class=s1> is not within a trestle project.&#39;</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Given directory is not within a trestle project.&#39;</span><span class=p>)</span>
+
+    <span class=c1># contruct path to the model file name</span>
+    <span class=n>model_dir_name</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+    <span class=n>root_model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>model_dir_name</span>
+    <span class=n>model_list</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>f</span> <span class=ow>in</span> <span class=n>root_model_dir</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*/&#39;</span><span class=p>):</span>
+        <span class=c1># only look for proper json and yaml files</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_should_ignore</span><span class=p>(</span><span class=n>f</span><span class=o>.</span><span class=n>stem</span><span class=p>):</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>f</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Ignoring validation of misplaced file </span><span class=si>{</span><span class=n>f</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> &#39;</span>
+                    <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;found in the model directory, </span><span class=si>{</span><span class=n>model_dir_name</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>model_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>f</span><span class=o>.</span><span class=n>stem</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>model_list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.get_relative_model_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_relative_model_type</span><span class=p>(</span><span class=n>relative_path</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.get_relative_model_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Given the relative path of a file with respect to 'trestle_root' return the oscal model type.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>relative_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Relative path of the model with respect to the root directory of the trestle workspace.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p>Returns: Type of Oscal Model for the provided model Alias of that oscal model.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_relative_model_type</span><span class=p>(</span><span class=n>relative_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Given the relative path of a file with respect to &#39;trestle_root&#39; return the oscal model type.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        relative_path: Relative path of the model with respect to the root directory of the trestle workspace.</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        Type of Oscal Model for the provided model</span>
+<span class=sd>        Alias of that oscal model.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span> <span class=o>&lt;</span> <span class=mi>2</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=s1>&#39;Insufficient path length to be a valid relative path w.r.t trestle workspace root directory.&#39;</span>
+        <span class=p>)</span>
+    <span class=n>model_dir</span> <span class=o>=</span> <span class=n>relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+    <span class=n>model_relative_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=o>*</span><span class=n>relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=mi>2</span><span class=p>:])</span>  <span class=c1># catalogs, profiles, etc</span>
+
+    <span class=k>if</span> <span class=n>model_dir</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_DIR_LIST</span><span class=p>:</span>
+        <span class=n>module_name</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_DIR_TO_MODEL_MODULE</span><span class=p>[</span><span class=n>model_dir</span><span class=p>]</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No valid trestle model type directory (e.g. catalogs) found for </span><span class=si>{</span><span class=n>model_dir</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_root_model</span><span class=p>(</span><span class=n>module_name</span><span class=p>)</span>
+    <span class=n>full_alias</span> <span class=o>=</span> <span class=n>model_alias</span>
+
+    <span class=k>for</span> <span class=n>index</span><span class=p>,</span> <span class=n>part</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>model_relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+        <span class=n>alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_extract_alias</span><span class=p>(</span><span class=n>part</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>index</span> <span class=o>&gt;</span> <span class=mi>0</span> <span class=ow>or</span> <span class=n>model_alias</span> <span class=o>!=</span> <span class=n>alias</span><span class=p>:</span>
+            <span class=n>model_alias</span> <span class=o>=</span> <span class=n>alias</span>
+            <span class=n>full_alias</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>full_alias</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>):</span>
+                <span class=n>model_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>model_type</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()[</span><span class=n>alias</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span>
+
+    <span class=k>return</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>full_alias</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.get_root_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_root_model</span><span class=p>(</span><span class=n>module_name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.get_root_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the root model class and alias based on the module.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_root_model</span><span class=p>(</span><span class=n>module_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>],</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the root model class and alias based on the module.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>module</span> <span class=o>=</span> <span class=n>importlib</span><span class=o>.</span><span class=n>import_module</span><span class=p>(</span><span class=n>module_name</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>ModuleNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>))</span>
+
+    <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>module</span><span class=p>,</span> <span class=s1>&#39;Model&#39;</span><span class=p>):</span>
+        <span class=n>model_metadata</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=nb>iter</span><span class=p>(</span><span class=n>module</span><span class=o>.</span><span class=n>Model</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+        <span class=k>return</span> <span class=n>model_metadata</span><span class=o>.</span><span class=n>type_</span><span class=p>,</span> <span class=n>model_metadata</span><span class=o>.</span><span class=n>alias</span>
+    <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Invalid module&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.get_singular_alias class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_singular_alias</span><span class=p>(</span><span class=n>alias_path</span><span class=p>,</span> <span class=n>relative_path</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.get_singular_alias class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the alias in the singular form from a jsonpath.</p> <p>If contextual_mode is True and contextual_path is None, it assumes alias_path is relative to the directory the user is running trestle from.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>alias_path</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The current alias element path as a string</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>relative_path</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=pathlib.Path>Path</span>]</code> </td> <td> <div class=doc-md-description> <p>Optional relative path (w.r.t. trestle_root) to cater for relative element paths.</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p>Returns: Alias as a string</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_singular_alias</span><span class=p>(</span><span class=n>alias_path</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>relative_path</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get the alias in the singular form from a jsonpath.</span>
+
+<span class=sd>    If contextual_mode is True and contextual_path is None, it assumes alias_path</span>
+<span class=sd>    is relative to the directory the user is running trestle from.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        alias_path: The current alias element path as a string</span>
+<span class=sd>        relative_path: Optional relative path (w.r.t. trestle_root) to cater for relative element paths.</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        Alias as a string</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>alias_path</span><span class=o>.</span><span class=n>strip</span><span class=p>())</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid jsonpath </span><span class=si>{</span><span class=n>alias_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>singular_alias</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=n>full_alias_path</span> <span class=o>=</span> <span class=n>alias_path</span>
+    <span class=k>if</span> <span class=n>relative_path</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get_singular_alias contextual mode: </span><span class=si>{</span><span class=nb>str</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>full_model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_relative_model_type</span><span class=p>(</span><span class=n>relative_path</span><span class=p>)</span>
+        <span class=n>first_alias_a</span> <span class=o>=</span> <span class=n>full_model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>first_alias_b</span> <span class=o>=</span> <span class=n>alias_path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>first_alias_a</span> <span class=o>==</span> <span class=n>first_alias_b</span><span class=p>:</span>
+            <span class=n>full_model_alias</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>full_model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[:</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+        <span class=n>full_alias_path</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=n>full_model_alias</span><span class=p>,</span> <span class=n>alias_path</span><span class=p>])</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+
+    <span class=n>path_parts</span> <span class=o>=</span> <span class=n>full_alias_path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>ALIAS_PATH_SEPARATOR</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;path parts: </span><span class=si>{</span><span class=n>path_parts</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>model_types</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=n>root_model_alias</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+    <span class=n>found</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>for</span> <span class=n>module_name</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_TO_MODEL_MODULE</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_root_model</span><span class=p>(</span><span class=n>module_name</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>root_model_alias</span> <span class=o>==</span> <span class=n>model_alias</span><span class=p>:</span>
+            <span class=n>found</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=n>model_types</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+            <span class=k>break</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>found</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>root_model_alias</span><span class=si>}</span><span class=s1> is an invalid root model alias.&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>root_model_alias</span>
+
+    <span class=n>model_type</span> <span class=o>=</span> <span class=n>model_types</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+    <span class=c1># go through path parts skipping first one</span>
+    <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)):</span>
+        <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>):</span>
+            <span class=c1># if it is a collection type and last part is * then break</span>
+            <span class=k>if</span> <span class=n>i</span> <span class=o>==</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>-</span> <span class=mi>1</span> <span class=ow>and</span> <span class=n>path_parts</span><span class=p>[</span><span class=n>i</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+                <span class=k>break</span>
+            <span class=c1># otherwise get the inner type of items in the collection</span>
+            <span class=n>model_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+            <span class=c1># and bump i</span>
+            <span class=n>i</span> <span class=o>=</span> <span class=n>i</span> <span class=o>+</span> <span class=mi>1</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>path_part</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+            <span class=n>field_map</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>path_part</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>field_map</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>field</span> <span class=o>=</span> <span class=n>field_map</span><span class=p>[</span><span class=n>path_part</span><span class=p>]</span>
+            <span class=n>model_type</span> <span class=o>=</span> <span class=n>field</span><span class=o>.</span><span class=n>outer_type_</span>
+        <span class=n>model_types</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+
+    <span class=n>last_alias</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+    <span class=k>if</span> <span class=n>last_alias</span> <span class=o>==</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+        <span class=n>last_alias</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+
+    <span class=c1># generic model and not list, so return itself fixme doc</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>last_alias</span>
+
+    <span class=n>parent_model_type</span> <span class=o>=</span> <span class=n>model_types</span><span class=p>[</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>field_map</span> <span class=o>=</span> <span class=n>parent_model_type</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()</span>
+        <span class=n>field</span> <span class=o>=</span> <span class=n>field_map</span><span class=p>[</span><span class=n>last_alias</span><span class=p>]</span>
+        <span class=n>outer_type</span> <span class=o>=</span> <span class=n>field</span><span class=o>.</span><span class=n>outer_type_</span>
+        <span class=n>inner_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>outer_type</span><span class=p>)</span>
+        <span class=n>inner_type_name</span> <span class=o>=</span> <span class=n>inner_type</span><span class=o>.</span><span class=vm>__name__</span>
+        <span class=n>singular_alias</span> <span class=o>=</span> <span class=n>str_utils</span><span class=o>.</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>inner_type_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in json path </span><span class=si>{</span><span class=n>alias_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>singular_alias</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.get_stripped_model_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>absolute_path</span><span class=p>,</span> <span class=n>absolute_trestle_root</span><span class=p>,</span> <span class=n>aliases_not_to_be_stripped</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.get_stripped_model_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the stripped contextual model class and alias based on the contextual path.</p> <p>This function relies on the directory structure of the trestle model being edited to determine, based on the existing files and folder, which fields should be stripped from the model type represented by the path passed in as a parameter.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_stripped_model_type</span><span class=p>(</span>
+    <span class=n>absolute_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>absolute_trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>aliases_not_to_be_stripped</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get the stripped contextual model class and alias based on the contextual path.</span>
+
+<span class=sd>    This function relies on the directory structure of the trestle model being edited to determine, based on the</span>
+<span class=sd>    existing files and folder, which fields should be stripped from the model type represented by the</span>
+<span class=sd>    path passed in as a parameter.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>aliases_not_to_be_stripped</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>aliases_not_to_be_stripped</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>singular_model_type</span><span class=p>,</span> <span class=n>model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_relative_model_type</span><span class=p>(</span>
+        <span class=n>absolute_path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>absolute_trestle_root</span><span class=p>))</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;singular model type </span><span class=si>{</span><span class=n>singular_model_type</span><span class=si>}</span><span class=s1> model alias </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=c1># Stripped models do not apply to collection types such as List[] and Dict{}</span>
+    <span class=c1># if model type is a list or dict, generate a new wrapping model for it</span>
+    <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>singular_model_type</span><span class=p>):</span>
+        <span class=n>malias</span> <span class=o>=</span> <span class=n>model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>class_name</span> <span class=o>=</span> <span class=n>alias_to_classname</span><span class=p>(</span><span class=n>malias</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;collection field type class name </span><span class=si>{</span><span class=n>class_name</span><span class=si>}</span><span class=s1> and alias </span><span class=si>{</span><span class=n>malias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>model_type</span> <span class=o>=</span> <span class=n>create_model</span><span class=p>(</span><span class=n>class_name</span><span class=p>,</span> <span class=n>__base__</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>__root__</span><span class=o>=</span><span class=p>(</span><span class=n>singular_model_type</span><span class=p>,</span> <span class=o>...</span><span class=p>))</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;model_type created: </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span>
+
+    <span class=n>malias</span> <span class=o>=</span> <span class=n>model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;not collection field type, malias: </span><span class=si>{</span><span class=n>malias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>absolute_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()</span> <span class=ow>and</span> <span class=n>malias</span> <span class=o>!=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_extract_alias</span><span class=p>(</span><span class=n>absolute_path</span><span class=o>.</span><span class=n>name</span><span class=p>):</span>
+        <span class=n>split_subdir</span> <span class=o>=</span> <span class=n>absolute_path</span> <span class=o>/</span> <span class=n>malias</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>split_subdir</span> <span class=o>=</span> <span class=n>absolute_path</span><span class=o>.</span><span class=n>parent</span> <span class=o>/</span> <span class=n>absolute_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>name</span>
+
+    <span class=n>aliases_to_be_stripped</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>split_subdir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>for</span> <span class=n>f</span> <span class=ow>in</span> <span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>split_subdir</span><span class=p>):</span>
+            <span class=n>alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_extract_alias</span><span class=p>(</span><span class=n>f</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>alias</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>aliases_not_to_be_stripped</span><span class=p>:</span>
+                <span class=n>aliases_to_be_stripped</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>alias</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;aliases to be stripped: </span><span class=si>{</span><span class=n>aliases_to_be_stripped</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>aliases_to_be_stripped</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=n>model_type</span> <span class=o>=</span> <span class=n>singular_model_type</span><span class=o>.</span><span class=n>create_stripped_model_type</span><span class=p>(</span>
+            <span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=nb>list</span><span class=p>(</span><span class=n>aliases_to_be_stripped</span><span class=p>)</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;model_type: </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span>
+    <span class=k>return</span> <span class=n>singular_model_type</span><span class=p>,</span> <span class=n>model_alias</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.get_title_from_model_uri class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_title_from_model_uri</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.get_title_from_model_uri class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get title from model at uri.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>943</span>
+<span class=normal>944</span>
+<span class=normal>945</span>
+<span class=normal>946</span>
+<span class=normal>947</span>
+<span class=normal>948</span>
+<span class=normal>949</span>
+<span class=normal>950</span>
+<span class=normal>951</span>
+<span class=normal>952</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_title_from_model_uri</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get title from model at uri.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>fetcher</span> <span class=o>=</span> <span class=n>cache</span><span class=o>.</span><span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_fetcher</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>
+        <span class=n>model</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>fetcher</span><span class=o>.</span><span class=n>get_oscal</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span>
+    <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error finding title for model at uri </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>raise</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.has_no_duplicate_values_by_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>has_no_duplicate_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.has_no_duplicate_values_by_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Determine if duplicate values of type exist in object.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>701</span>
+<span class=normal>702</span>
+<span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span>
+<span class=normal>706</span>
+<span class=normal>707</span>
+<span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span>
+<span class=normal>714</span>
+<span class=normal>715</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>has_no_duplicate_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>BaseModel</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Determine if duplicate values of type exist in object.&quot;&quot;&quot;</span>
+    <span class=n>loe</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_values_by_name</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=n>name_of_interest</span><span class=p>)</span>
+    <span class=n>set_loe</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>loe</span><span class=p>)</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>loe</span><span class=p>)</span> <span class=o>==</span> <span class=nb>len</span><span class=p>(</span><span class=n>set_loe</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=n>items</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>loe</span><span class=p>:</span>
+        <span class=n>items</span><span class=p>[</span><span class=n>item</span><span class=p>]</span> <span class=o>=</span> <span class=n>items</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=mi>0</span><span class=p>)</span> <span class=o>+</span> <span class=mi>1</span>
+    <span class=c1># now print items</span>
+    <span class=k>for</span> <span class=n>item</span><span class=p>,</span> <span class=n>instances</span> <span class=ow>in</span> <span class=n>items</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>instances</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Duplicate detected of item </span><span class=si>{</span><span class=n>item</span><span class=si>}</span><span class=s1> with </span><span class=si>{</span><span class=n>instances</span><span class=si>}</span><span class=s1> instances.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.last_modified_at_time class="doc doc-heading"> <code class="highlight language-python"><span class=n>last_modified_at_time</span><span class=p>(</span><span class=n>timestamp</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.last_modified_at_time class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate a LastModified set to timestamp or now.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>655</span>
+<span class=normal>656</span>
+<span class=normal>657</span>
+<span class=normal>658</span>
+<span class=normal>659</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>last_modified_at_time</span><span class=p>(</span><span class=n>timestamp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>datetime</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate a LastModified set to timestamp or now.&quot;&quot;&quot;</span>
+    <span class=n>timestamp</span> <span class=o>=</span> <span class=n>timestamp</span> <span class=k>if</span> <span class=n>timestamp</span> <span class=k>else</span> <span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span><span class=o>.</span><span class=n>astimezone</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>timestamp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.load_distributed class="doc doc-heading"> <code class="highlight language-python"><span class=n>load_distributed</span><span class=p>(</span><span class=n>abs_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>,</span> <span class=n>collection_type</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.load_distributed class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Given path to a model, load the model.</p> <p>If the model is decomposed/split/distributed,the decomposed models are loaded recursively.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>abs_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The path to the file/directory to be loaded.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>abs_trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The trestle workspace root directory.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>collection_type</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.Type>Type</span>[<span title=typing.Any>Any</span>]]</code> </td> <td> <div class=doc-md-description> <p>The type of collection model, if it is a collection model. typing.List is the only collection type handled or expected. Defaults to None.</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Type>Type</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>]</code> </td> <td> <div class=doc-md-description> <p>Return a tuple of Model Type (e.g. class 'trestle.oscal.catalog.Catalog'),</p> </div> </td> </tr> <tr class=doc-section-item> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Model Alias (e.g. 'catalog.metadata') and Instance of the Model.</p> </div> </td> </tr> <tr class=doc-section-item> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.Union>Union</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>, <span title=typing.List>List</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>], <span title=typing.Dict>Dict</span>[str, <a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>]]]</code> </td> <td> <div class=doc-md-description> <p>If the model is decomposed/split/distributed, the instance of the model contains the decomposed models loaded recursively.</p> </div> </td> </tr> </tbody> </table> <details class=note open> <summary>Note</summary> <p>This does not validate the model. You must either validate the model separately or use the load_validate utilities.</p> </details> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>load_distributed</span><span class=p>(</span>
+    <span class=n>abs_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span>
+    <span class=n>abs_trestle_root</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span>
+    <span class=n>collection_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span>
+           <span class=nb>str</span><span class=p>,</span>
+           <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>]]]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Given path to a model, load the model.</span>
+
+<span class=sd>    If the model is decomposed/split/distributed,the decomposed models are loaded recursively.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        abs_path: The path to the file/directory to be loaded.</span>
+<span class=sd>        abs_trestle_root: The trestle workspace root directory.</span>
+<span class=sd>        collection_type: The type of collection model, if it is a collection model.</span>
+<span class=sd>            typing.List is the only collection type handled or expected.</span>
+<span class=sd>            Defaults to None.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Return a tuple of Model Type (e.g. class &#39;trestle.oscal.catalog.Catalog&#39;),</span>
+<span class=sd>        Model Alias (e.g. &#39;catalog.metadata&#39;) and Instance of the Model.</span>
+<span class=sd>        If the model is decomposed/split/distributed, the instance of the model contains</span>
+<span class=sd>            the decomposed models loaded recursively.</span>
+
+<span class=sd>    Note:</span>
+<span class=sd>        This does not validate the model.  You must either validate the model separately or use the load_validate</span>
+<span class=sd>        utilities.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># if trying to load file that does not exist, load path instead</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>abs_path</span> <span class=o>=</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>with_name</span><span class=p>(</span><span class=n>abs_path</span><span class=o>.</span><span class=n>stem</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleNotFoundError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File </span><span class=si>{</span><span class=n>abs_path</span><span class=si>}</span><span class=s1> not found for load.&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>collection_type</span><span class=p>:</span>
+        <span class=c1># If the path contains a list type model</span>
+        <span class=k>if</span> <span class=n>collection_type</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_load_list</span><span class=p>(</span><span class=n>abs_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+        <span class=c1># the only other collection type in OSCAL is dict, and it only applies to include_all,</span>
+        <span class=c1># which is too granular ever to be loaded by this routine</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Collection type </span><span class=si>{</span><span class=n>collection_type</span><span class=si>}</span><span class=s1> not recognized for distributed load.&#39;</span><span class=p>)</span>
+
+    <span class=c1># Get current model</span>
+    <span class=n>primary_model_type</span><span class=p>,</span> <span class=n>primary_model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>abs_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+    <span class=n>primary_model_instance</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=c1># is this an attempt to load an actual json or yaml file?</span>
+    <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>abs_path</span><span class=p>)</span>
+    <span class=c1># if file is sought but it doesn&#39;t exist, ignore and load as decomposed model</span>
+    <span class=k>if</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>is_readable_file</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span> <span class=ow>and</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>primary_model_instance</span> <span class=o>=</span> <span class=n>primary_model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>abs_path</span><span class=p>)</span>
+    <span class=c1># Is model decomposed?</span>
+    <span class=n>decomposed_dir</span> <span class=o>=</span> <span class=n>abs_path</span><span class=o>.</span><span class=n>with_name</span><span class=p>(</span><span class=n>abs_path</span><span class=o>.</span><span class=n>stem</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>decomposed_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>aliases_not_to_be_stripped</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>instances_to_be_merged</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=k>for</span> <span class=n>local_path</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>trestle</span><span class=o>.</span><span class=n>common</span><span class=o>.</span><span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>decomposed_dir</span><span class=p>)):</span>
+            <span class=k>if</span> <span class=n>local_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>,</span> <span class=n>model_instance</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>local_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+                <span class=n>aliases_not_to_be_stripped</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+                <span class=n>instances_to_be_merged</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_instance</span><span class=p>)</span>
+
+            <span class=k>elif</span> <span class=n>local_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>local_path</span><span class=p>,</span> <span class=n>abs_trestle_root</span><span class=p>)</span>
+                <span class=c1># Only load the directory if it is a collection model. Otherwise do nothing - it gets loaded when</span>
+                <span class=c1># iterating over the model file</span>
+
+                <span class=c1># If a model is just a container for a list e.g.</span>
+                <span class=c1># class Foo(OscalBaseModel):  noqa: E800</span>
+                <span class=c1>#      __root__: List[Bar]    noqa: E800</span>
+                <span class=c1># You need to test whether first a root key exists</span>
+                <span class=c1># then whether the outer_type of root is a collection.</span>
+                <span class=c1># Alternative is to do a try except to avoid the error for an unknown key.</span>
+
+                <span class=k>if</span> <span class=n>model_type</span><span class=o>.</span><span class=n>is_collection_container</span><span class=p>():</span>
+                    <span class=c1># This directory is a decomposed List or Dict</span>
+                    <span class=n>collection_type</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>get_collection_type</span><span class=p>()</span>
+                    <span class=n>model_type</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>,</span> <span class=n>model_instance</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>local_path</span><span class=p>,</span>
+                                                                                          <span class=n>abs_trestle_root</span><span class=p>,</span>
+                                                                                          <span class=n>collection_type</span><span class=p>)</span>
+                    <span class=n>aliases_not_to_be_stripped</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+                    <span class=n>instances_to_be_merged</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>model_instance</span><span class=p>)</span>
+        <span class=n>primary_model_dict</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>if</span> <span class=n>primary_model_instance</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>primary_model_dict</span> <span class=o>=</span> <span class=n>primary_model_instance</span><span class=o>.</span><span class=vm>__dict__</span>
+
+        <span class=n>merged_model_type</span><span class=p>,</span> <span class=n>merged_model_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>abs_path</span><span class=p>,</span>
+                                                                                   <span class=n>abs_trestle_root</span><span class=p>,</span>
+                                                                                   <span class=n>aliases_not_to_be_stripped</span><span class=p>)</span>
+
+        <span class=c1># The following use of top_level is to allow loading of a top level model by name only, e.g. MyCatalog</span>
+        <span class=c1># There may be a better overall way to approach this.</span>
+        <span class=n>top_level</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>merged_model_alias</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>))</span> <span class=o>==</span> <span class=mi>1</span>
+
+        <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=nb>len</span><span class=p>(</span><span class=n>aliases_not_to_be_stripped</span><span class=p>)):</span>
+            <span class=n>alias</span> <span class=o>=</span> <span class=n>aliases_not_to_be_stripped</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+            <span class=n>instance</span> <span class=o>=</span> <span class=n>instances_to_be_merged</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+            <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>instance</span><span class=p>,</span> <span class=s1>&#39;__dict__&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=n>instance</span><span class=o>.</span><span class=vm>__dict__</span> <span class=ow>and</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>instance</span><span class=p>,</span>
+                                                                                                <span class=n>OscalBaseModel</span><span class=p>):</span>
+                <span class=n>instance</span> <span class=o>=</span> <span class=n>instance</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>top_level</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>primary_model_dict</span><span class=p>:</span>
+                <span class=n>primary_model_dict</span> <span class=o>=</span> <span class=n>instance</span><span class=o>.</span><span class=vm>__dict__</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>primary_model_dict</span><span class=p>[</span><span class=n>alias</span><span class=p>]</span> <span class=o>=</span> <span class=n>instance</span>
+
+        <span class=n>merged_model_instance</span> <span class=o>=</span> <span class=n>merged_model_type</span><span class=p>(</span><span class=o>**</span><span class=n>primary_model_dict</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>merged_model_type</span><span class=p>,</span> <span class=n>merged_model_alias</span><span class=p>,</span> <span class=n>merged_model_instance</span>
+    <span class=k>return</span> <span class=n>primary_model_type</span><span class=p>,</span> <span class=n>primary_model_alias</span><span class=p>,</span> <span class=n>primary_model_instance</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.load_model_for_class class="doc doc-heading"> <code class="highlight language-python"><span class=n>load_model_for_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span><span class=p>,</span> <span class=n>file_content_type</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.load_model_for_class class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Load a model by name and model class and infer file content type if not specified.</p> <p>If you need to load an existing model but its content type may not be known, use this method. But the file content type should be specified if it is somehow known.</p> <details class=note open> <summary>Note</summary> <p>This does not validate the model. If you want to validate the model use the load_validate utilities.</p> </details> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>load_model_for_class</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>model_class</span><span class=p>:</span> <span class=n>TG</span><span class=p>,</span>
+    <span class=n>file_content_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>FileContentType</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>TG</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Load a model by name and model class and infer file content type if not specified.</span>
+
+<span class=sd>    If you need to load an existing model but its content type may not be known, use this method.</span>
+<span class=sd>    But the file content type should be specified if it is somehow known.</span>
+
+<span class=sd>    Note:</span>
+<span class=sd>        This does not validate the model.  If you want to validate the model use the load_validate utilities.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>root_model_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_root_path_for_top_level_model</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model_class</span>
+    <span class=p>)</span>  <span class=c1># type: ignore</span>
+    <span class=k>if</span> <span class=n>file_content_type</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>root_model_path</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>is_readable_file</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to load model </span><span class=si>{</span><span class=n>model_name</span><span class=si>}</span><span class=s1> without specifying json or yaml.&#39;</span><span class=p>)</span>
+    <span class=n>full_model_path</span> <span class=o>=</span> <span class=n>root_model_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>))</span>
+    <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>full_model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>model</span><span class=p>,</span> <span class=n>full_model_path</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.load_model_for_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>load_model_for_type</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>model_name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.load_model_for_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Load model for the given type and name.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>load_model_for_type</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                        <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Load model for the given type and name.&quot;&quot;&quot;</span>
+    <span class=n>dir_name</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span>
+    <span class=n>model_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>dir_name</span> <span class=o>/</span> <span class=n>model_name</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No model is found at path: </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>oscal_object</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>oscal_object</span><span class=p>,</span> <span class=n>model_path</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.model_age class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_age</span><span class=p>(</span><span class=n>model</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.model_age class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find time in seconds since LastModified timestamp.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>667</span>
+<span class=normal>668</span>
+<span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span>
+<span class=normal>672</span>
+<span class=normal>673</span>
+<span class=normal>674</span>
+<span class=normal>675</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>model_age</span><span class=p>(</span><span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find time in seconds since LastModified timestamp.&quot;&quot;&quot;</span>
+    <span class=c1># default to one year if no last_modified</span>
+    <span class=n>age_seconds</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>DAY_SECONDS</span> <span class=o>*</span> <span class=mi>365</span>
+    <span class=k>if</span> <span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>last_modified</span><span class=p>:</span>
+        <span class=n>dt</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span><span class=o>.</span><span class=n>astimezone</span><span class=p>()</span> <span class=o>-</span> <span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>last_modified</span>
+        <span class=n>age_seconds</span> <span class=o>=</span> <span class=n>dt</span><span class=o>.</span><span class=n>seconds</span>
+    <span class=k>return</span> <span class=n>age_seconds</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.model_type_to_model_dir class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.model_type_to_model_dir class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get plural model directory from model type.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get plural model directory from model type.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>model_type</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Not a valid model type: </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_TO_MODEL_DIR</span><span class=p>[</span><span class=n>model_type</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.models_are_equivalent class="doc doc-heading"> <code class="highlight language-python"><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>model_a</span><span class=p>,</span> <span class=n>model_b</span><span class=p>,</span> <span class=n>ignore_all_uuid</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.models_are_equivalent class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Test if models are equivalent except for last modified and possibly uuid.</p> <p>If a model has had uuids regenerated, then all uuids <em>and references to them</em> are updated. This means that special handling is required if a model has had uuids regenerated - when checking equivalence.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>917</span>
+<span class=normal>918</span>
+<span class=normal>919</span>
+<span class=normal>920</span>
+<span class=normal>921</span>
+<span class=normal>922</span>
+<span class=normal>923</span>
+<span class=normal>924</span>
+<span class=normal>925</span>
+<span class=normal>926</span>
+<span class=normal>927</span>
+<span class=normal>928</span>
+<span class=normal>929</span>
+<span class=normal>930</span>
+<span class=normal>931</span>
+<span class=normal>932</span>
+<span class=normal>933</span>
+<span class=normal>934</span>
+<span class=normal>935</span>
+<span class=normal>936</span>
+<span class=normal>937</span>
+<span class=normal>938</span>
+<span class=normal>939</span>
+<span class=normal>940</span>
+<span class=normal>941</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>models_are_equivalent</span><span class=p>(</span>
+    <span class=n>model_a</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>],</span>
+    <span class=n>model_b</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>],</span>
+    <span class=n>ignore_all_uuid</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Test if models are equivalent except for last modified and possibly uuid.</span>
+
+<span class=sd>    If a model has had uuids regenerated, then all uuids *and references to them* are updated.  This means that</span>
+<span class=sd>    special handling is required if a model has had uuids regenerated - when checking equivalence.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>uuid_type_list</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=n>common</span><span class=o>.</span><span class=n>LastModified</span><span class=p>,</span>
+        <span class=n>common</span><span class=o>.</span><span class=n>LocationUuid</span><span class=p>,</span>
+        <span class=n>common</span><span class=o>.</span><span class=n>PartyUuid</span><span class=p>,</span>
+        <span class=n>common</span><span class=o>.</span><span class=n>RelatedRisk</span><span class=p>,</span>
+        <span class=n>common</span><span class=o>.</span><span class=n>Source</span><span class=p>,</span>
+        <span class=n>assessment_plan</span><span class=o>.</span><span class=n>RelatedObservation</span><span class=p>,</span>
+        <span class=n>assessment_results</span><span class=o>.</span><span class=n>RelatedObservation</span><span class=p>,</span>
+        <span class=n>poam</span><span class=o>.</span><span class=n>RelatedObservation</span><span class=p>,</span>
+        <span class=n>poam</span><span class=o>.</span><span class=n>RelatedObservation1</span>
+    <span class=p>]</span>
+    <span class=n>type_list</span> <span class=o>=</span> <span class=n>uuid_type_list</span> <span class=k>if</span> <span class=n>ignore_all_uuid</span> <span class=k>else</span> <span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>LastModified</span><span class=p>]</span>
+    <span class=k>return</span> <span class=ow>not</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_objects_differ</span><span class=p>(</span><span class=n>model_a</span><span class=p>,</span> <span class=n>model_b</span><span class=p>,</span> <span class=n>type_list</span><span class=p>,</span> <span class=p>[</span><span class=s1>&#39;last_modified&#39;</span><span class=p>],</span> <span class=n>ignore_all_uuid</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.parameter_to_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>parameter_to_dict</span><span class=p>(</span><span class=n>obj</span><span class=p>,</span> <span class=n>partial</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.parameter_to_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert obj to dict containing only string values, storing only the fields that have values set.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>obj</code> </td> <td> <code><span title=typing.Union>Union</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>, str]</code> </td> <td> <div class=doc-md-description> <p>The parameter or its consituent parts in recursive calls</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>partial</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to convert the entire param or just the parts needed for markdown header</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Union>Union</span>[str, <span title=typing.Dict>Dict</span>[str, <span title=typing.Any>Any</span>]]</code> </td> <td> <div class=doc-md-description> <p>The converted parameter as dictionary, with values as None if not present</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>parameter_to_dict</span><span class=p>(</span><span class=n>obj</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>partial</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Union</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Convert obj to dict containing only string values, storing only the fields that have values set.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        obj: The parameter or its consituent parts in recursive calls</span>
+<span class=sd>        partial: Whether to convert the entire param or just the parts needed for markdown header</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The converted parameter as dictionary, with values as None if not present</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>res</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_parameter_to_dict_recurse</span><span class=p>(</span><span class=n>obj</span><span class=p>,</span> <span class=n>partial</span><span class=p>)</span>
+    <span class=k>if</span> <span class=s1>&#39;values&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>res</span><span class=p>:</span>
+        <span class=n>res</span><span class=p>[</span><span class=s1>&#39;values&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>  <span class=c1># type: ignore</span>
+    <span class=k>return</span> <span class=n>res</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.regenerate_uuids class="doc doc-heading"> <code class="highlight language-python"><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.regenerate_uuids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Regenerate all uuids in object and update corresponding references.</p> <p>Find all dicts with key == 'uuid' and replace the value with a new uuid4. Build a corresponding lookup table as you go, of old:new uuid values. Then make a second pass through the object and replace all string values present in the lookup table with the new value.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>object_of_interest</code> </td> <td> <code><span title=typing.Any>Any</span></code> </td> <td> <div class=doc-md-description> <p>pydantic.BaseModel, list, dict or str will be updated</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Any>Any</span></code> </td> <td> <div class=doc-md-description> <p>The updated object with new uuid's and refs</p> </div> </td> </tr> <tr class=doc-section-item> <td> <code><span title=typing.Dict>Dict</span>[str, str]</code> </td> <td> <div class=doc-md-description> <p>The final lookup table of old:new uuid's</p> </div> </td> </tr> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>A count of the number of refs that were updated</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>839</span>
+<span class=normal>840</span>
+<span class=normal>841</span>
+<span class=normal>842</span>
+<span class=normal>843</span>
+<span class=normal>844</span>
+<span class=normal>845</span>
+<span class=normal>846</span>
+<span class=normal>847</span>
+<span class=normal>848</span>
+<span class=normal>849</span>
+<span class=normal>850</span>
+<span class=normal>851</span>
+<span class=normal>852</span>
+<span class=normal>853</span>
+<span class=normal>854</span>
+<span class=normal>855</span>
+<span class=normal>856</span>
+<span class=normal>857</span>
+<span class=normal>858</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>regenerate_uuids</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Regenerate all uuids in object and update corresponding references.</span>
+
+<span class=sd>    Find all dicts with key == &#39;uuid&#39; and replace the value with a new uuid4.</span>
+<span class=sd>    Build a corresponding lookup table as you go, of old:new uuid values.</span>
+<span class=sd>    Then make a second pass through the object and replace all string values</span>
+<span class=sd>    present in the lookup table with the new value.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        object_of_interest: pydantic.BaseModel, list, dict or str will be updated</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The updated object with new uuid&#39;s and refs</span>
+<span class=sd>        The final lookup table of old:new uuid&#39;s</span>
+<span class=sd>        A count of the number of refs that were updated</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>new_object</span><span class=p>,</span> <span class=n>uuid_lut</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_regenerate_uuids_in_place</span><span class=p>(</span><span class=n>object_of_interest</span><span class=p>,</span> <span class=p>{})</span>
+    <span class=n>new_object</span><span class=p>,</span> <span class=n>n_refs_updated</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_update_new_uuid_refs</span><span class=p>(</span><span class=n>new_object</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>new_object</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>,</span> <span class=n>n_refs_updated</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.save_top_level_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>save_top_level_model</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>file_content_type</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.save_top_level_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Save a model by name and infer model type by inspection.</p> <p>You don't need to specify the model type (catalog, profile, etc.) but you must specify the file content type. If the model directory does not exist, it is created.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>save_top_level_model</span><span class=p>(</span>
+    <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>file_content_type</span><span class=p>:</span> <span class=n>FileContentType</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Save a model by name and infer model type by inspection.</span>
+
+<span class=sd>    You don&#39;t need to specify the model type (catalog, profile, etc.) but you must specify the file content type.</span>
+<span class=sd>    If the model directory does not exist, it is created.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>root_model_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>_root_path_for_top_level_model</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model_name</span><span class=p>,</span> <span class=n>model</span><span class=p>)</span>
+    <span class=n>full_model_path</span> <span class=o>=</span> <span class=n>root_model_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_content_type</span><span class=p>))</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>full_model_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>full_model_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>model</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>full_model_path</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.common.model_utils.ModelUtils.update_last_modified class="doc doc-heading"> <code class="highlight language-python"><span class=n>update_last_modified</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>timestamp</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.common.model_utils.ModelUtils.update_last_modified class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Update the LastModified timestamp in top level model to now.</p> <details class=quote> <summary>Source code in <code>trestle/common/model_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span>
+<span class=normal>664</span>
+<span class=normal>665</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>update_last_modified</span><span class=p>(</span><span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Update the LastModified timestamp in top level model to now.&quot;&quot;&quot;</span>
+    <span class=n>timestamp</span> <span class=o>=</span> <span class=n>timestamp</span> <span class=k>if</span> <span class=n>timestamp</span> <span class=k>else</span> <span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span><span class=o>.</span><span class=n>astimezone</span><span class=p>()</span>
+    <span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>last_modified</span> <span class=o>=</span> <span class=n>timestamp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.common.model_utils-functions>Functions<a href=#trestle.common.model_utils-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/str_utils/index.html b/latest/reference/API/trestle/common/str_utils/index.html
new file mode 100644
index 000000000..8c33ee739
--- /dev/null
+++ b/latest/reference/API/trestle/common/str_utils/index.html
@@ -0,0 +1,119 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.str_utils module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/str_utils/ rel=canonical><link href=../model_utils/ rel=prev><link href=../trash/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.str_utils - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.str_utils - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.str_utils module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/str_utils.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/str_utils/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.str_utils - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.str_utils module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/str_utils.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.str_utils class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.str_utils </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.str_utils </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.str_utils </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.str_utils class=md-nav__link> <span class=md-ellipsis> str_utils </span> </a> <nav class=md-nav aria-label=str_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils.AliasMode class=md-nav__link> <span class=md-ellipsis> AliasMode </span> </a> <nav class=md-nav aria-label=AliasMode> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils.AliasMode-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils.AliasMode.FIELD class=md-nav__link> <span class=md-ellipsis> FIELD </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.AliasMode.JSON class=md-nav__link> <span class=md-ellipsis> JSON </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils.alias_to_classname class=md-nav__link> <span class=md-ellipsis> alias_to_classname </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.as_string class=md-nav__link> <span class=md-ellipsis> as_string </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.classname_to_alias class=md-nav__link> <span class=md-ellipsis> classname_to_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.dash_to_underscore class=md-nav__link> <span class=md-ellipsis> dash_to_underscore </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.spaces_and_caps_to_lower_single_spaces class=md-nav__link> <span class=md-ellipsis> spaces_and_caps_to_lower_single_spaces </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.spaces_and_caps_to_snake class=md-nav__link> <span class=md-ellipsis> spaces_and_caps_to_snake </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.string_from_root class=md-nav__link> <span class=md-ellipsis> string_from_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.strip_lower_equals class=md-nav__link> <span class=md-ellipsis> strip_lower_equals </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.underscore_to_dash class=md-nav__link> <span class=md-ellipsis> underscore_to_dash </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.str_utils class=md-nav__link> <span class=md-ellipsis> str_utils </span> </a> <nav class=md-nav aria-label=str_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils.AliasMode class=md-nav__link> <span class=md-ellipsis> AliasMode </span> </a> <nav class=md-nav aria-label=AliasMode> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils.AliasMode-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils.AliasMode.FIELD class=md-nav__link> <span class=md-ellipsis> FIELD </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.AliasMode.JSON class=md-nav__link> <span class=md-ellipsis> JSON </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.str_utils.alias_to_classname class=md-nav__link> <span class=md-ellipsis> alias_to_classname </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.as_string class=md-nav__link> <span class=md-ellipsis> as_string </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.classname_to_alias class=md-nav__link> <span class=md-ellipsis> classname_to_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.dash_to_underscore class=md-nav__link> <span class=md-ellipsis> dash_to_underscore </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.spaces_and_caps_to_lower_single_spaces class=md-nav__link> <span class=md-ellipsis> spaces_and_caps_to_lower_single_spaces </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.spaces_and_caps_to_snake class=md-nav__link> <span class=md-ellipsis> spaces_and_caps_to_snake </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.string_from_root class=md-nav__link> <span class=md-ellipsis> string_from_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.strip_lower_equals class=md-nav__link> <span class=md-ellipsis> strip_lower_equals </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.str_utils.underscore_to_dash class=md-nav__link> <span class=md-ellipsis> underscore_to_dash </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.str_utils</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.str_utils class="doc doc-heading"> <code>trestle.common.str_utils</code> <a href=#trestle.common.str_utils class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle String Utils.</p> <div class="doc doc-children"> <h3 id=trestle.common.str_utils-classes>Classes<a href=#trestle.common.str_utils-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.common.str_utils.AliasMode class="doc doc-heading"> <code>AliasMode</code> <a href=#trestle.common.str_utils.AliasMode class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Allowed formats for classname alias.</p> <p>Currently there are only two. If others are added, check they get handled properly in the code.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>22</span>
+<span class=normal>23</span>
+<span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AliasMode</span><span class=p>(</span><span class=n>enum</span><span class=o>.</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Allowed formats for classname alias.</span>
+
+<span class=sd>    Currently there are only two.  If others are added, check they get handled properly in the code.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>JSON</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=n>FIELD</span> <span class=o>=</span> <span class=mi>2</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.common.str_utils.AliasMode-attributes>Attributes<a href=#trestle.common.str_utils.AliasMode-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.common.str_utils.AliasMode.FIELD class="doc doc-heading"> <code class="highlight language-python"><span class=n>FIELD</span> <span class=o>=</span> <span class=mi>2</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.common.str_utils.AliasMode.FIELD class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.common.str_utils.AliasMode.JSON class="doc doc-heading"> <code class="highlight language-python"><span class=n>JSON</span> <span class=o>=</span> <span class=mi>1</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.common.str_utils.AliasMode.JSON class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h3 id=trestle.common.str_utils-functions>Functions<a href=#trestle.common.str_utils-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.common.str_utils.alias_to_classname class="doc doc-heading"> <code class="highlight language-python"><span class=n>alias_to_classname</span><span class=p>(</span><span class=n>alias</span><span class=p>,</span> <span class=n>mode</span><span class=p>)</span></code> <a href=#trestle.common.str_utils.alias_to_classname class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Return class name based dashed or snake alias.</p> <p>This is applicable creating dynamic wrapper model for a list or dict field.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>alias_to_classname</span><span class=p>(</span><span class=n>alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>mode</span><span class=p>:</span> <span class=n>AliasMode</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Return class name based dashed or snake alias.</span>
+
+<span class=sd>    This is applicable creating dynamic wrapper model for a list or dict field.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>mode</span> <span class=o>==</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>_snake_to_upper_camel</span><span class=p>(</span><span class=n>alias</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>))</span>
+    <span class=k>return</span> <span class=n>_snake_to_upper_camel</span><span class=p>(</span><span class=n>alias</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.str_utils.as_string class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_string</span><span class=p>(</span><span class=n>string_or_none</span><span class=p>)</span></code> <a href=#trestle.common.str_utils.as_string class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert string or None to itself or empty string.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_string</span><span class=p>(</span><span class=n>string_or_none</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert string or None to itself or empty string.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>string_or_none</span> <span class=k>if</span> <span class=n>string_or_none</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.str_utils.classname_to_alias class="doc doc-heading"> <code class="highlight language-python"><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>classname</span><span class=p>,</span> <span class=n>mode</span><span class=p>)</span></code> <a href=#trestle.common.str_utils.classname_to_alias class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Return oscal key name or field element name based on class name.</p> <p>This is applicable when asking for a singular element.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>classname_to_alias</span><span class=p>(</span><span class=n>classname</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>mode</span><span class=p>:</span> <span class=n>AliasMode</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Return oscal key name or field element name based on class name.</span>
+
+<span class=sd>    This is applicable when asking for a singular element.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>suffix</span> <span class=o>=</span> <span class=n>classname</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+
+    <span class=c1># the alias mode is either json or field - yaml doesn&#39;t apply here</span>
+    <span class=k>if</span> <span class=n>mode</span> <span class=o>==</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+        <span class=c1># things like class_ should just be class</span>
+        <span class=k>if</span> <span class=n>suffix</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;_&#39;</span><span class=p>:</span>
+            <span class=n>suffix</span> <span class=o>=</span> <span class=n>suffix</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>_camel_to_dash</span><span class=p>(</span><span class=n>suffix</span><span class=p>)</span><span class=o>.</span><span class=n>rstrip</span><span class=p>(</span><span class=n>string</span><span class=o>.</span><span class=n>digits</span><span class=p>)</span>
+    <span class=c1># else alias mode is field</span>
+    <span class=k>return</span> <span class=n>_camel_to_snake</span><span class=p>(</span><span class=n>suffix</span><span class=p>)</span><span class=o>.</span><span class=n>rstrip</span><span class=p>(</span><span class=n>string</span><span class=o>.</span><span class=n>digits</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.str_utils.dash_to_underscore class="doc doc-heading"> <code class="highlight language-python"><span class=n>dash_to_underscore</span><span class=p>(</span><span class=n>name</span><span class=p>)</span></code> <a href=#trestle.common.str_utils.dash_to_underscore class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert dash to underscore.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>dash_to_underscore</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert dash to underscore.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.str_utils.spaces_and_caps_to_lower_single_spaces class="doc doc-heading"> <code class="highlight language-python"><span class=n>spaces_and_caps_to_lower_single_spaces</span><span class=p>(</span><span class=n>spaced_str</span><span class=p>)</span></code> <a href=#trestle.common.str_utils.spaces_and_caps_to_lower_single_spaces class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert caps and duplicate spaces to lower with single spaces.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>spaces_and_caps_to_lower_single_spaces</span><span class=p>(</span><span class=n>spaced_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert caps and duplicate spaces to lower with single spaces.&quot;&quot;&quot;</span>
+    <span class=n>single_space</span> <span class=o>=</span> <span class=s1>&#39; &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>spaced_str</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>split</span><span class=p>())</span>
+    <span class=k>return</span> <span class=n>single_space</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.str_utils.spaces_and_caps_to_snake class="doc doc-heading"> <code class="highlight language-python"><span class=n>spaces_and_caps_to_snake</span><span class=p>(</span><span class=n>spaced_str</span><span class=p>)</span></code> <a href=#trestle.common.str_utils.spaces_and_caps_to_snake class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert caps and spaces to snake.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>spaces_and_caps_to_snake</span><span class=p>(</span><span class=n>spaced_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert caps and spaces to snake.&quot;&quot;&quot;</span>
+    <span class=n>underscored</span> <span class=o>=</span> <span class=s1>&#39;_&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>spaced_str</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>split</span><span class=p>())</span>
+    <span class=k>return</span> <span class=n>underscored</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.str_utils.string_from_root class="doc doc-heading"> <code class="highlight language-python"><span class=n>string_from_root</span><span class=p>(</span><span class=n>item_with_root</span><span class=p>)</span></code> <a href=#trestle.common.str_utils.string_from_root class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert root to string if present.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>string_from_root</span><span class=p>(</span><span class=n>item_with_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert root to string if present.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>as_string</span><span class=p>(</span><span class=n>item_with_root</span><span class=o>.</span><span class=n>__root__</span><span class=p>)</span> <span class=k>if</span> <span class=n>item_with_root</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.str_utils.strip_lower_equals class="doc doc-heading"> <code class="highlight language-python"><span class=n>strip_lower_equals</span><span class=p>(</span><span class=n>str_a</span><span class=p>,</span> <span class=n>str_b</span><span class=p>)</span></code> <a href=#trestle.common.str_utils.strip_lower_equals class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Safe test of lower string equality allowing Nones.</p> <p>If either argument is None the result is False because the intent is to report if they are equal as actual strings.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>strip_lower_equals</span><span class=p>(</span><span class=n>str_a</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>str_b</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Safe test of lower string equality allowing Nones.</span>
+
+<span class=sd>    If either argument is None the result is False because the intent is to report if they are equal as actual strings.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>str_a</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>or</span> <span class=n>str_b</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=n>str_a</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>str_b</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.str_utils.underscore_to_dash class="doc doc-heading"> <code class="highlight language-python"><span class=n>underscore_to_dash</span><span class=p>(</span><span class=n>name</span><span class=p>)</span></code> <a href=#trestle.common.str_utils.underscore_to_dash class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert underscore to dash and drop final dash if present.</p> <details class=quote> <summary>Source code in <code>trestle/common/str_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>underscore_to_dash</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert underscore to dash and drop final dash if present.&quot;&quot;&quot;</span>
+    <span class=n>converted</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;_&#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>converted</span> <span class=k>if</span> <span class=n>converted</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=o>!=</span> <span class=s1>&#39;-&#39;</span> <span class=k>else</span> <span class=n>converted</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/trash/index.html b/latest/reference/API/trestle/common/trash/index.html
new file mode 100644
index 000000000..a1d5276e3
--- /dev/null
+++ b/latest/reference/API/trestle/common/trash/index.html
@@ -0,0 +1,335 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.trash module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/trash/ rel=canonical><link href=../str_utils/ rel=prev><link href=../type_utils/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.trash - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.trash - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.trash module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/trash.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/trash/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.trash - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.trash module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/trash.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.trash class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.trash </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.trash </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.trash </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.trash class=md-nav__link> <span class=md-ellipsis> trash </span> </a> <nav class=md-nav aria-label=trash> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.trash-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.trash.TRESTLE_TRASH_DIR class=md-nav__link> <span class=md-ellipsis> TRESTLE_TRASH_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.TRESTLE_TRASH_DIR_EXT class=md-nav__link> <span class=md-ellipsis> TRESTLE_TRASH_DIR_EXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.TRESTLE_TRASH_FILE_EXT class=md-nav__link> <span class=md-ellipsis> TRESTLE_TRASH_FILE_EXT </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.trash-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.trash.get_trash_root class=md-nav__link> <span class=md-ellipsis> get_trash_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.has_parent_path class=md-nav__link> <span class=md-ellipsis> has_parent_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.recover class=md-nav__link> <span class=md-ellipsis> recover </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.recover_dir class=md-nav__link> <span class=md-ellipsis> recover_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.recover_file class=md-nav__link> <span class=md-ellipsis> recover_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.store class=md-nav__link> <span class=md-ellipsis> store </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.store_dir class=md-nav__link> <span class=md-ellipsis> store_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.store_file class=md-nav__link> <span class=md-ellipsis> store_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_origin_dir_path class=md-nav__link> <span class=md-ellipsis> to_origin_dir_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_origin_file_path class=md-nav__link> <span class=md-ellipsis> to_origin_file_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_origin_path class=md-nav__link> <span class=md-ellipsis> to_origin_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_trash_dir_path class=md-nav__link> <span class=md-ellipsis> to_trash_dir_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_trash_file_path class=md-nav__link> <span class=md-ellipsis> to_trash_file_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_trash_path class=md-nav__link> <span class=md-ellipsis> to_trash_path </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.trash class=md-nav__link> <span class=md-ellipsis> trash </span> </a> <nav class=md-nav aria-label=trash> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.trash-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.trash.TRESTLE_TRASH_DIR class=md-nav__link> <span class=md-ellipsis> TRESTLE_TRASH_DIR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.TRESTLE_TRASH_DIR_EXT class=md-nav__link> <span class=md-ellipsis> TRESTLE_TRASH_DIR_EXT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.TRESTLE_TRASH_FILE_EXT class=md-nav__link> <span class=md-ellipsis> TRESTLE_TRASH_FILE_EXT </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.trash-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.trash.get_trash_root class=md-nav__link> <span class=md-ellipsis> get_trash_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.has_parent_path class=md-nav__link> <span class=md-ellipsis> has_parent_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.recover class=md-nav__link> <span class=md-ellipsis> recover </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.recover_dir class=md-nav__link> <span class=md-ellipsis> recover_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.recover_file class=md-nav__link> <span class=md-ellipsis> recover_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.store class=md-nav__link> <span class=md-ellipsis> store </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.store_dir class=md-nav__link> <span class=md-ellipsis> store_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.store_file class=md-nav__link> <span class=md-ellipsis> store_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_origin_dir_path class=md-nav__link> <span class=md-ellipsis> to_origin_dir_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_origin_file_path class=md-nav__link> <span class=md-ellipsis> to_origin_file_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_origin_path class=md-nav__link> <span class=md-ellipsis> to_origin_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_trash_dir_path class=md-nav__link> <span class=md-ellipsis> to_trash_dir_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_trash_file_path class=md-nav__link> <span class=md-ellipsis> to_trash_file_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.trash.to_trash_path class=md-nav__link> <span class=md-ellipsis> to_trash_path </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.trash</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.trash class="doc doc-heading"> <code>trestle.common.trash</code> <a href=#trestle.common.trash class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle trash module.</p> <div class="doc doc-children"> <h3 id=trestle.common.trash-attributes>Attributes<a href=#trestle.common.trash-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.trash.TRESTLE_TRASH_DIR class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_TRASH_DIR</span> <span class=o>=</span> <span class=s1>&#39;.trestle/_trash/&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.trash.TRESTLE_TRASH_DIR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.trash.TRESTLE_TRASH_DIR_EXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_TRASH_DIR_EXT</span> <span class=o>=</span> <span class=s1>&#39;__bk&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.trash.TRESTLE_TRASH_DIR_EXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.trash.TRESTLE_TRASH_FILE_EXT class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_TRASH_FILE_EXT</span> <span class=o>=</span> <span class=s1>&#39;.bk&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.trash.TRESTLE_TRASH_FILE_EXT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.common.trash-functions>Functions<a href=#trestle.common.trash-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.get_trash_root class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_trash_root</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.common.trash.get_trash_root class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Find the trestle trash root path.</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_trash_root</span><span class=p>(</span><span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find the trestle trash root path.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>path</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>or</span> <span class=nb>len</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span> <span class=o>&lt;=</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=n>current</span> <span class=o>=</span> <span class=n>path</span>
+    <span class=k>while</span> <span class=nb>len</span><span class=p>(</span><span class=n>current</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>  <span class=c1># it must not be the system root directory</span>
+        <span class=n>trash_dir</span> <span class=o>=</span> <span class=n>current</span> <span class=o>/</span> <span class=n>TRESTLE_TRASH_DIR</span>
+        <span class=k>if</span> <span class=n>trash_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>and</span> <span class=n>trash_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>trash_dir</span>
+        <span class=n>current</span> <span class=o>=</span> <span class=n>current</span><span class=o>.</span><span class=n>parent</span>
+
+    <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.has_parent_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>has_parent_path</span><span class=p>(</span><span class=n>sub_path</span><span class=p>,</span> <span class=n>parent_path</span><span class=p>)</span></code> <a href=#trestle.common.trash.has_parent_path class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Check if sub_path has the specified parent_dir path.</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>has_parent_path</span><span class=p>(</span><span class=n>sub_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>parent_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check if sub_path has the specified parent_dir path.&quot;&quot;&quot;</span>
+    <span class=c1># sub_path should be longer than parent path</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>sub_path</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>parent_path</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>for</span> <span class=n>i</span><span class=p>,</span> <span class=n>part</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>parent_path</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>part</span> <span class=o>!=</span> <span class=n>sub_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=n>i</span><span class=p>]:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.recover class="doc doc-heading"> <code class="highlight language-python"><span class=n>recover</span><span class=p>(</span><span class=n>dest_content_path</span><span class=p>,</span> <span class=n>delete_trash</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.common.trash.recover class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Recover the specified file or directory from the trash directory.</p> <p>dest_content_path: destination content path that needs to be recovered from trash It recovers the latest path content from trash if exists</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>recover</span><span class=p>(</span><span class=n>dest_content_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>delete_trash</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Recover the specified file or directory from the trash directory.</span>
+
+<span class=sd>    dest_content_path: destination content path that needs to be recovered from trash</span>
+<span class=sd>    It recovers the latest path content from trash if exists</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>dest_content_path</span><span class=o>.</span><span class=n>suffix</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>recover_file</span><span class=p>(</span><span class=n>dest_content_path</span><span class=p>,</span> <span class=n>delete_trash</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>recover_dir</span><span class=p>(</span><span class=n>dest_content_path</span><span class=p>,</span> <span class=n>delete_trash</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.recover_dir class="doc doc-heading"> <code class="highlight language-python"><span class=n>recover_dir</span><span class=p>(</span><span class=n>dest_dir_path</span><span class=p>,</span> <span class=n>delete_trash</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.common.trash.recover_dir class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Move the specified dir from the trash directory.</p> <p>dest_dir_path: destination path of the directory inside a trestle workspace</p> <p>It recovers the latest directory and contents from trash if exists</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>recover_dir</span><span class=p>(</span><span class=n>dest_dir_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>delete_trash</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Move the specified dir from the trash directory.</span>
+
+<span class=sd>    dest_dir_path: destination path of the directory inside a trestle workspace</span>
+
+<span class=sd>    It recovers the latest directory and contents from trash if exists</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>trash_dir_path</span> <span class=o>=</span> <span class=n>to_trash_dir_path</span><span class=p>(</span><span class=n>dest_dir_path</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=p>(</span><span class=n>trash_dir_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>and</span> <span class=n>trash_dir_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()):</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Specified path &quot;</span><span class=si>{</span><span class=n>dest_dir_path</span><span class=si>}</span><span class=s1>&quot; could not be found in trash&#39;</span><span class=p>)</span>
+
+    <span class=c1># move all files/directories under sub_path</span>
+    <span class=k>for</span> <span class=n>item_path</span> <span class=ow>in</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>iterdir</span><span class=p>(</span><span class=n>trash_dir_path</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>item_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=n>recover_file</span><span class=p>(</span><span class=n>to_origin_file_path</span><span class=p>(</span><span class=n>item_path</span><span class=p>),</span> <span class=n>delete_trash</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>item_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=n>recover_dir</span><span class=p>(</span><span class=n>to_origin_dir_path</span><span class=p>(</span><span class=n>item_path</span><span class=p>),</span> <span class=n>delete_trash</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>delete_trash</span><span class=p>:</span>
+        <span class=n>trash_dir_path</span><span class=o>.</span><span class=n>rmdir</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.recover_file class="doc doc-heading"> <code class="highlight language-python"><span class=n>recover_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>delete_trash</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.common.trash.recover_file class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Recover the specified file from the trash directory.</p> <p>It recovers the latest file from trash if exists</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>recover_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>delete_trash</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Recover the specified file from the trash directory.</span>
+
+<span class=sd>    It recovers the latest file from trash if exists</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>trash_file_path</span> <span class=o>=</span> <span class=n>to_trash_file_path</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>trash_file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Specified path &quot;</span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1>&quot; could not be found in trash&#39;</span><span class=p>)</span>
+
+    <span class=n>file_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>copyfile</span><span class=p>(</span><span class=n>trash_file_path</span><span class=p>,</span> <span class=n>file_path</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>delete_trash</span><span class=p>:</span>
+        <span class=n>trash_file_path</span><span class=o>.</span><span class=n>unlink</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.store class="doc doc-heading"> <code class="highlight language-python"><span class=n>store</span><span class=p>(</span><span class=n>content_path</span><span class=p>,</span> <span class=n>delete_content</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.common.trash.store class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Move the specified file or directory to the trash directory.</p> <p>It overwrites the previous file or directory if exists</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>store</span><span class=p>(</span><span class=n>content_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>delete_content</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Move the specified file or directory to the trash directory.</span>
+
+<span class=sd>    It overwrites the previous file or directory if exists</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>content_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>return</span> <span class=n>store_file</span><span class=p>(</span><span class=n>content_path</span><span class=p>,</span> <span class=n>delete_content</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>content_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+        <span class=k>return</span> <span class=n>store_dir</span><span class=p>(</span><span class=n>content_path</span><span class=p>,</span> <span class=n>delete_content</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.store_dir class="doc doc-heading"> <code class="highlight language-python"><span class=n>store_dir</span><span class=p>(</span><span class=n>dir_path</span><span class=p>,</span> <span class=n>delete_source</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.common.trash.store_dir class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Move the specified dir to the trash directory.</p> <p>It overwrites the previous directory and contents if exists</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>store_dir</span><span class=p>(</span><span class=n>dir_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>delete_source</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Move the specified dir to the trash directory.</span>
+
+<span class=sd>    It overwrites the previous directory and contents if exists</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>dir_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Specified path &quot;</span><span class=si>{</span><span class=n>dir_path</span><span class=si>}</span><span class=s1>&quot; is not a dir&#39;</span><span class=p>)</span>
+
+    <span class=c1># move all files/directories under sub_path</span>
+    <span class=k>for</span> <span class=n>item_path</span> <span class=ow>in</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>iterdir</span><span class=p>(</span><span class=n>dir_path</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>item_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=n>store_file</span><span class=p>(</span><span class=n>item_path</span><span class=p>,</span> <span class=n>delete_source</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>item_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=n>store_dir</span><span class=p>(</span><span class=n>item_path</span><span class=p>,</span> <span class=n>delete_source</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>delete_source</span><span class=p>:</span>
+        <span class=n>dir_path</span><span class=o>.</span><span class=n>rmdir</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.store_file class="doc doc-heading"> <code class="highlight language-python"><span class=n>store_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>delete_source</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.common.trash.store_file class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Move the specified file to the trash directory.</p> <p>It overwrites the previous file if exists</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>store_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>delete_source</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Move the specified file to the trash directory.</span>
+
+<span class=sd>    It overwrites the previous file if exists</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>file_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Specified path &quot;</span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1>&quot; is not a file&#39;</span><span class=p>)</span>
+
+    <span class=n>trash_file_path</span> <span class=o>=</span> <span class=n>to_trash_file_path</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+    <span class=n>trash_file_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>copyfile</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>trash_file_path</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>delete_source</span><span class=p>:</span>
+        <span class=n>file_path</span><span class=o>.</span><span class=n>unlink</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.to_origin_dir_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_origin_dir_path</span><span class=p>(</span><span class=n>trash_dir_path</span><span class=p>)</span></code> <a href=#trestle.common.trash.to_origin_dir_path class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert trash content path to origin path.</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_origin_dir_path</span><span class=p>(</span><span class=n>trash_dir_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert trash content path to origin path.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>trash_dir_path</span><span class=o>.</span><span class=n>suffix</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>trash_dir_path</span><span class=o>.</span><span class=n>suffix</span><span class=o>.</span><span class=n>endswith</span><span class=p>(</span><span class=n>TRESTLE_TRASH_FILE_EXT</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given path &quot;</span><span class=si>{</span><span class=n>trash_dir_path</span><span class=si>}</span><span class=s1>&quot; is a trash file, not a valid trash directory&#39;</span><span class=p>)</span>
+
+    <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>trash_dir_path</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>trestle_root</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Directory path &quot;</span><span class=si>{</span><span class=n>trash_dir_path</span><span class=si>}</span><span class=s1>&quot; is not in a valid trestle project path&#39;</span><span class=p>)</span>
+
+    <span class=n>trash_root</span> <span class=o>=</span> <span class=n>get_trash_root</span><span class=p>(</span><span class=n>trash_dir_path</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>trash_root</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Directory path &quot;</span><span class=si>{</span><span class=n>trash_dir_path</span><span class=si>}</span><span class=s1>&quot; is not in a valid trestle trash path&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>has_parent_path</span><span class=p>(</span><span class=n>trash_dir_path</span><span class=p>,</span> <span class=n>trash_root</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Directory path &quot;</span><span class=si>{</span><span class=n>trash_dir_path</span><span class=si>}</span><span class=s1>&quot; is not a valid trash dir path&#39;</span><span class=p>)</span>
+
+    <span class=n>relative_path</span> <span class=o>=</span> <span class=n>trash_dir_path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>trash_root</span><span class=p>))</span>
+
+    <span class=n>origin_path_parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+        <span class=n>parts</span> <span class=o>=</span> <span class=n>item</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=n>TRESTLE_TRASH_DIR_EXT</span><span class=p>)</span>
+        <span class=n>origin_path_parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+
+    <span class=n>origin_relative_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=s1>&#39;/&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>origin_path_parts</span><span class=p>))</span>
+    <span class=n>origin_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>origin_relative_path</span>
+    <span class=k>return</span> <span class=n>origin_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.to_origin_file_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_origin_file_path</span><span class=p>(</span><span class=n>trash_file_path</span><span class=p>)</span></code> <a href=#trestle.common.trash.to_origin_file_path class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert trash file path to origin file path.</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_origin_file_path</span><span class=p>(</span><span class=n>trash_file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert trash file path to origin file path.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>trash_file_path</span><span class=o>.</span><span class=n>suffix</span> <span class=o>!=</span> <span class=n>TRESTLE_TRASH_FILE_EXT</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File path &quot;</span><span class=si>{</span><span class=n>trash_file_path</span><span class=si>}</span><span class=s1>&quot; is not a valid trash file path&#39;</span><span class=p>)</span>
+
+    <span class=n>origin_dir</span> <span class=o>=</span> <span class=n>to_origin_dir_path</span><span class=p>(</span><span class=n>trash_file_path</span><span class=o>.</span><span class=n>parent</span><span class=p>)</span>
+    <span class=n>file_parts</span> <span class=o>=</span> <span class=n>trash_file_path</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=n>TRESTLE_TRASH_FILE_EXT</span><span class=p>)</span>
+    <span class=n>origin_file_path</span> <span class=o>=</span> <span class=n>origin_dir</span> <span class=o>/</span> <span class=n>file_parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+
+    <span class=k>return</span> <span class=n>origin_file_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.to_origin_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_origin_path</span><span class=p>(</span><span class=n>trash_content_path</span><span class=p>)</span></code> <a href=#trestle.common.trash.to_origin_path class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert the trash path to origin path.</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_origin_path</span><span class=p>(</span><span class=n>trash_content_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert the trash path to origin path.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>trash_content_path</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>TRESTLE_TRASH_FILE_EXT</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>to_origin_file_path</span><span class=p>(</span><span class=n>trash_content_path</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>to_origin_dir_path</span><span class=p>(</span><span class=n>trash_content_path</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.to_trash_dir_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_trash_dir_path</span><span class=p>(</span><span class=n>dir_path</span><span class=p>)</span></code> <a href=#trestle.common.trash.to_trash_dir_path class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Construct the path to the trashed file.</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_trash_dir_path</span><span class=p>(</span><span class=n>dir_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Construct the path to the trashed file.&quot;&quot;&quot;</span>
+    <span class=n>absolute_path</span> <span class=o>=</span> <span class=n>dir_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+    <span class=n>root_path</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>absolute_path</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>root_path</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=ne>AssertionError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Directory path &quot;</span><span class=si>{</span><span class=n>absolute_path</span><span class=si>}</span><span class=s1>&quot; is not in a valid trestle project&#39;</span><span class=p>)</span>
+
+    <span class=n>trestle_trash_path</span> <span class=o>=</span> <span class=n>root_path</span> <span class=o>/</span> <span class=n>TRESTLE_TRASH_DIR</span>
+
+    <span class=n>relative_path</span> <span class=o>=</span> <span class=n>absolute_path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>root_path</span><span class=p>))</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=n>trash_dir</span> <span class=o>=</span> <span class=n>trestle_trash_path</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>trash_dir</span> <span class=o>=</span> <span class=n>trestle_trash_path</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>relative_path</span><span class=si>}{</span><span class=n>TRESTLE_TRASH_DIR_EXT</span><span class=si>}</span><span class=s1>&#39;</span>
+
+    <span class=k>return</span> <span class=n>trash_dir</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.to_trash_file_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_trash_file_path</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span></code> <a href=#trestle.common.trash.to_trash_file_path class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Construct the path to the trashed file.</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_trash_file_path</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Construct the path to the trashed file.&quot;&quot;&quot;</span>
+    <span class=n>trash_file_dir</span> <span class=o>=</span> <span class=n>to_trash_dir_path</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>parent</span><span class=p>)</span>
+    <span class=n>trash_file_path</span> <span class=o>=</span> <span class=n>trash_file_dir</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>file_path</span><span class=o>.</span><span class=n>name</span><span class=si>}{</span><span class=n>TRESTLE_TRASH_FILE_EXT</span><span class=si>}</span><span class=s1>&#39;</span>
+
+    <span class=k>return</span> <span class=n>trash_file_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.trash.to_trash_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_trash_path</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.common.trash.to_trash_path class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert the dir or file path to apporpriate trash file or dir path.</p> <details class=quote> <summary>Source code in <code>trestle/common/trash.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_trash_path</span><span class=p>(</span><span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert the dir or file path to apporpriate trash file or dir path.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>path</span><span class=o>.</span><span class=n>suffix</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>to_trash_file_path</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>to_trash_dir_path</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/common/type_utils/index.html b/latest/reference/API/trestle/common/type_utils/index.html
new file mode 100644
index 000000000..6ca556640
--- /dev/null
+++ b/latest/reference/API/trestle/common/type_utils/index.html
@@ -0,0 +1,90 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.common.type_utils module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/type_utils/ rel=canonical><link href=../trash/ rel=prev><link href=../../core/all_validator/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.common.type_utils - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.common.type_utils - Compliance Trestle"><meta property=og:description content="Documentation for trestle.common.type_utils module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/type_utils.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/type_utils/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.common.type_utils - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.common.type_utils module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/common/type_utils.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.common.type_utils class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.common.type_utils </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2 checked> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.common.type_utils </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.common.type_utils </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.type_utils class=md-nav__link> <span class=md-ellipsis> type_utils </span> </a> <nav class=md-nav aria-label=type_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.type_utils-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.type_utils.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.type_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.type_utils.get_inner_type class=md-nav__link> <span class=md-ellipsis> get_inner_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.type_utils.get_origin class=md-nav__link> <span class=md-ellipsis> get_origin </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.type_utils.is_collection_field_type class=md-nav__link> <span class=md-ellipsis> is_collection_field_type </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.common.type_utils class=md-nav__link> <span class=md-ellipsis> type_utils </span> </a> <nav class=md-nav aria-label=type_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.type_utils-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.type_utils.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.common.type_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.common.type_utils.get_inner_type class=md-nav__link> <span class=md-ellipsis> get_inner_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.type_utils.get_origin class=md-nav__link> <span class=md-ellipsis> get_origin </span> </a> </li> <li class=md-nav__item> <a href=#trestle.common.type_utils.is_collection_field_type class=md-nav__link> <span class=md-ellipsis> is_collection_field_type </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.common.type_utils</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.common.type_utils class="doc doc-heading"> <code>trestle.common.type_utils</code> <a href=#trestle.common.type_utils class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Utilities for dealing with models.</p> <div class="doc doc-children"> <h3 id=trestle.common.type_utils-attributes>Attributes<a href=#trestle.common.type_utils-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.common.type_utils.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.common.type_utils.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.common.type_utils-functions>Functions<a href=#trestle.common.type_utils-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.common.type_utils.get_inner_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_inner_type</span><span class=p>(</span><span class=n>collection_field_type</span><span class=p>)</span></code> <a href=#trestle.common.type_utils.get_inner_type class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get the inner model in a generic collection model such as a List or a Dict.</p> <p>For a dict the return type is of the value and not the key.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>collection_field_type</code> </td> <td> <code><span title=typing.Union>Union</span>[<span title=typing.Type>Type</span>[<span title=typing.List>List</span>[<span title=typing.Any>Any</span>]], <span title=typing.Type>Type</span>[<span title=typing.Dict>Dict</span>[str, <span title=typing.Any>Any</span>]]]</code> </td> <td> <div class=doc-md-description> <p>Provided type annotation from a pydantic object</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Type>Type</span>[<span title=typing.Any>Any</span>]</code> </td> <td> <div class=doc-md-description> <p>The desired type.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/type_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_inner_type</span><span class=p>(</span><span class=n>collection_field_type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>]],</span> <span class=n>Type</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]])</span> <span class=o>-&gt;</span> <span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the inner model in a generic collection model such as a List or a Dict.</span>
+
+<span class=sd>    For a dict the return type is of the value and not the key.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        collection_field_type: Provided type annotation from a pydantic object</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The desired type.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=c1># Pydantic special cases must be dealt with here:</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>singular_type</span> <span class=o>=</span> <span class=n>_get_model_field_info</span><span class=p>(</span><span class=n>collection_field_type</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>singular_type</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>singular_type</span>
+        <span class=k>return</span> <span class=n>typing_extensions</span><span class=o>.</span><span class=n>get_args</span><span class=p>(</span><span class=n>collection_field_type</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>e</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Model type is not a Dict or List&#39;</span><span class=p>)</span> <span class=kn>from</span> <span class=nn>e</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.type_utils.get_origin class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_origin</span><span class=p>(</span><span class=n>field_type</span><span class=p>)</span></code> <a href=#trestle.common.type_utils.get_origin class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Generalized and robust get_origin function.</p> <p>This function is derived from work by pydantic, however, avoids complications from various python versions.</p> <details class=quote> <summary>Source code in <code>trestle/common/type_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_origin</span><span class=p>(</span><span class=n>field_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generalized and robust get_origin function.</span>
+
+<span class=sd>    This function is derived from work by pydantic, however, avoids complications</span>
+<span class=sd>    from various python versions.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># This executes a fallback that allows a list to be generated from a constrained list.</span>
+    <span class=k>return</span> <span class=n>typing_extensions</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>field_type</span><span class=p>)</span> <span class=ow>or</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>field_type</span><span class=p>,</span> <span class=s1>&#39;__origin__&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.common.type_utils.is_collection_field_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>field_type</span><span class=p>)</span></code> <a href=#trestle.common.type_utils.is_collection_field_type class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Check whether a type hint is a collection type as used by OSCAL.</p> <p>Specifically this is whether the type is a list or not.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>field_type</code> </td> <td> <code><span title=typing.Type>Type</span>[<span title=typing.Any>Any</span>]</code> </td> <td> <div class=doc-md-description> <p>A type or a type alias of a field typically as served via pydantic introspection</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>True if it is a collection type list.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/common/type_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_collection_field_type</span><span class=p>(</span><span class=n>field_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check whether a type hint is a collection type as used by OSCAL.</span>
+
+<span class=sd>    Specifically this is whether the type is a list or not.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        field_type: A type or a type alias of a field typically as served via pydantic introspection</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        True if it is a collection type list.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># first check if it is a pydantic __root__ object</span>
+    <span class=n>_</span><span class=p>,</span> <span class=n>root_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>_get_model_field_info</span><span class=p>(</span><span class=n>field_type</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>root_type</span> <span class=o>==</span> <span class=s1>&#39;List&#39;</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=c1># Retrieves type from a type annotation</span>
+    <span class=n>origin_type</span> <span class=o>=</span> <span class=n>get_origin</span><span class=p>(</span><span class=n>field_type</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>origin_type</span> <span class=o>==</span> <span class=nb>list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/all_validator/index.html b/latest/reference/API/trestle/core/all_validator/index.html
new file mode 100644
index 000000000..ce2f5a330
--- /dev/null
+++ b/latest/reference/API/trestle/core/all_validator/index.html
@@ -0,0 +1,90 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.all_validator module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/all_validator/ rel=canonical><link href=../../common/type_utils/ rel=prev><link href=../base_model/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.all_validator - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.all_validator - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.all_validator module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/all_validator.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/all_validator/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.all_validator - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.all_validator module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/all_validator.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.all_validator class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.all_validator </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.all_validator </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.all_validator </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.all_validator class=md-nav__link> <span class=md-ellipsis> all_validator </span> </a> <nav class=md-nav aria-label=all_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator class=md-nav__link> <span class=md-ellipsis> AllValidator </span> </a> <nav class=md-nav aria-label=AllValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator.last_failure_msg class=md-nav__link> <span class=md-ellipsis> last_failure_msg </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator.error_msg class=md-nav__link> <span class=md-ellipsis> error_msg </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.all_validator class=md-nav__link> <span class=md-ellipsis> all_validator </span> </a> <nav class=md-nav aria-label=all_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator class=md-nav__link> <span class=md-ellipsis> AllValidator </span> </a> <nav class=md-nav aria-label=AllValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator.last_failure_msg class=md-nav__link> <span class=md-ellipsis> last_failure_msg </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator.error_msg class=md-nav__link> <span class=md-ellipsis> error_msg </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.all_validator.AllValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.all_validator</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.all_validator class="doc doc-heading"> <code>trestle.core.all_validator</code> <a href=#trestle.core.all_validator class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Validate based on all registered validators.</p> <div class="doc doc-children"> <h3 id=trestle.core.all_validator-classes>Classes<a href=#trestle.core.all_validator-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.all_validator.AllValidator class="doc doc-heading"> <code>AllValidator</code> <a href=#trestle.core.all_validator.AllValidator class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.validator.Validator href=../validator/#trestle.core.validator.Validator>Validator</a></code></p> <p>Validator to confirm the model passes all registered validation tests.</p> <details class=quote> <summary>Source code in <code>trestle/core/all_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AllValidator</span><span class=p>(</span><span class=n>Validator</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validator to confirm the model passes all registered validation tests.&quot;&quot;&quot;</span>
+
+    <span class=n>last_failure_msg</span><span class=p>:</span> <span class=nb>str</span>
+
+    <span class=k>def</span> <span class=nf>error_msg</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return information on which validation failed.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>last_failure_msg</span>
+
+    <span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Validate an oscal model against all available validators in the trestle library.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            model: An Oscal model that can be passed to the validator.</span>
+<span class=sd>            quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>        returns:</span>
+<span class=sd>            True (valid) if the model passed all registered validators.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>last_failure_msg</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__doc__</span>
+        <span class=k>for</span> <span class=n>val</span> <span class=ow>in</span> <span class=n>vfact</span><span class=o>.</span><span class=n>validator_factory</span><span class=o>.</span><span class=n>get_all</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>val</span> <span class=o>!=</span> <span class=bp>self</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>val</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>last_failure_msg</span> <span class=o>=</span> <span class=n>val</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span>
+                <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.all_validator.AllValidator-attributes>Attributes<a href=#trestle.core.all_validator.AllValidator-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.all_validator.AllValidator.last_failure_msg class="doc doc-heading"> <code class="highlight language-python"><span class=n>last_failure_msg</span><span class=p>:</span> <span class=nb>str</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.all_validator.AllValidator.last_failure_msg class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.all_validator.AllValidator-functions>Functions<a href=#trestle.core.all_validator.AllValidator-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.all_validator.AllValidator.error_msg class="doc doc-heading"> <code class="highlight language-python"><span class=n>error_msg</span><span class=p>()</span></code> <a href=#trestle.core.all_validator.AllValidator.error_msg class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return information on which validation failed.</p> <details class=quote> <summary>Source code in <code>trestle/core/all_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>error_msg</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return information on which validation failed.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>last_failure_msg</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.all_validator.AllValidator.model_is_valid class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.all_validator.AllValidator.model_is_valid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate an oscal model against all available validators in the trestle library.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code> </td> <td> <div class=doc-md-description> <p>An Oscal model that can be passed to the validator.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>quiet</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Don't report msgs unless invalid.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>True (valid) if the model passed all registered validators.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/all_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Validate an oscal model against all available validators in the trestle library.</span>
+
+<span class=sd>    args:</span>
+<span class=sd>        model: An Oscal model that can be passed to the validator.</span>
+<span class=sd>        quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>    returns:</span>
+<span class=sd>        True (valid) if the model passed all registered validators.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>last_failure_msg</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__doc__</span>
+    <span class=k>for</span> <span class=n>val</span> <span class=ow>in</span> <span class=n>vfact</span><span class=o>.</span><span class=n>validator_factory</span><span class=o>.</span><span class=n>get_all</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>val</span> <span class=o>!=</span> <span class=bp>self</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>val</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>last_failure_msg</span> <span class=o>=</span> <span class=n>val</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span>
+            <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/base_model/index.html b/latest/reference/API/trestle/core/base_model/index.html
new file mode 100644
index 000000000..10f1545a1
--- /dev/null
+++ b/latest/reference/API/trestle/core/base_model/index.html
@@ -0,0 +1,1420 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.base_model module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/base_model/ rel=canonical><link href=../all_validator/ rel=prev><link href=../catalog_validator/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.base_model - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.base_model - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.base_model module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/base_model.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/base_model/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.base_model - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.base_model module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/base_model.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.base_model class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.base_model </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.base_model </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.base_model </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.base_model class=md-nav__link> <span class=md-ellipsis> base_model </span> </a> <nav class=md-nav aria-label=base_model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.base_model-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel class=md-nav__link> <span class=md-ellipsis> OscalBaseModel </span> </a> <nav class=md-nav aria-label=OscalBaseModel> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.alias_to_field_map class=md-nav__link> <span class=md-ellipsis> alias_to_field_map </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.copy_from class=md-nav__link> <span class=md-ellipsis> copy_from </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.copy_to class=md-nav__link> <span class=md-ellipsis> copy_to </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.create_stripped_model_type class=md-nav__link> <span class=md-ellipsis> create_stripped_model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.get_collection_type class=md-nav__link> <span class=md-ellipsis> get_collection_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.get_field_by_alias class=md-nav__link> <span class=md-ellipsis> get_field_by_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.get_field_value_by_alias class=md-nav__link> <span class=md-ellipsis> get_field_value_by_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.is_collection_container class=md-nav__link> <span class=md-ellipsis> is_collection_container </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_dict class=md-nav__link> <span class=md-ellipsis> oscal_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_read class=md-nav__link> <span class=md-ellipsis> oscal_read </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_serialize_json class=md-nav__link> <span class=md-ellipsis> oscal_serialize_json </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_serialize_json_bytes class=md-nav__link> <span class=md-ellipsis> oscal_serialize_json_bytes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_write class=md-nav__link> <span class=md-ellipsis> oscal_write </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.stripped_instance class=md-nav__link> <span class=md-ellipsis> stripped_instance </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.base_model-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.robust_datetime_serialization class=md-nav__link> <span class=md-ellipsis> robust_datetime_serialization </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.base_model class=md-nav__link> <span class=md-ellipsis> base_model </span> </a> <nav class=md-nav aria-label=base_model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.base_model-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel class=md-nav__link> <span class=md-ellipsis> OscalBaseModel </span> </a> <nav class=md-nav aria-label=OscalBaseModel> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.alias_to_field_map class=md-nav__link> <span class=md-ellipsis> alias_to_field_map </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.copy_from class=md-nav__link> <span class=md-ellipsis> copy_from </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.copy_to class=md-nav__link> <span class=md-ellipsis> copy_to </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.create_stripped_model_type class=md-nav__link> <span class=md-ellipsis> create_stripped_model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.get_collection_type class=md-nav__link> <span class=md-ellipsis> get_collection_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.get_field_by_alias class=md-nav__link> <span class=md-ellipsis> get_field_by_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.get_field_value_by_alias class=md-nav__link> <span class=md-ellipsis> get_field_value_by_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.is_collection_container class=md-nav__link> <span class=md-ellipsis> is_collection_container </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_dict class=md-nav__link> <span class=md-ellipsis> oscal_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_read class=md-nav__link> <span class=md-ellipsis> oscal_read </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_serialize_json class=md-nav__link> <span class=md-ellipsis> oscal_serialize_json </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_serialize_json_bytes class=md-nav__link> <span class=md-ellipsis> oscal_serialize_json_bytes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.oscal_write class=md-nav__link> <span class=md-ellipsis> oscal_write </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.base_model.OscalBaseModel.stripped_instance class=md-nav__link> <span class=md-ellipsis> stripped_instance </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.base_model-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.base_model.robust_datetime_serialization class=md-nav__link> <span class=md-ellipsis> robust_datetime_serialization </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.base_model</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.base_model class="doc doc-heading"> <code>trestle.core.base_model</code> <a href=#trestle.core.base_model class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Pydantic base model for use within a trestle workspace and associated configuration.</p> <p>The heart of the current OSCAL model within trestle is based on pydantic (<a href=https://pydantic-docs.helpmanual.io/ >https://pydantic-docs.helpmanual.io/</a>) which itself is a veneer on-top of python data classes.</p> <p>Functionality here defines a base-model which all trestle oscal data models inherit from. This allows additional functionality to be easily inserted.</p> <p>I can write a comment in here and you can even edit on the same line.</p> <div class="doc doc-children"> <h3 id=trestle.core.base_model-attributes>Attributes<a href=#trestle.core.base_model-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.base_model.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.base_model.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.base_model-classes>Classes<a href=#trestle.core.base_model-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.base_model.OscalBaseModel class="doc doc-heading"> <code>OscalBaseModel</code> <a href=#trestle.core.base_model.OscalBaseModel class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.trestle_base_model.TrestleBaseModel href=../trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel>TrestleBaseModel</a></code></p> <p>Trestle defined pydantic base model for use with OSCAL pydantic dataclasses.</p> <p>This BaseModel provides two types of functionality: 1. Overrides default configuation of the pydantic library with behaviours required for trestle 2. Provides utility functions for trestle which are specific to OSCAL and the naming schema associated with it.</p> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OscalBaseModel</span><span class=p>(</span><span class=n>TrestleBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Trestle defined pydantic base model for use with OSCAL pydantic dataclasses.</span>
+
+<span class=sd>    This BaseModel provides two types of functionality:</span>
+<span class=sd>    1. Overrides default configuation of the pydantic library with behaviours required for trestle</span>
+<span class=sd>    2. Provides utility functions for trestle which are specific to OSCAL and the naming schema associated with it.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Overriding configuration class for pydantic base model, for use with OSCAL data classes.&quot;&quot;&quot;</span>
+
+        <span class=n>json_loads</span> <span class=o>=</span> <span class=n>orjson</span><span class=o>.</span><span class=n>loads</span>
+        <span class=c1># TODO: json_dumps with orjson.dumps see #840</span>
+
+        <span class=n>json_encoders</span> <span class=o>=</span> <span class=p>{</span><span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=p>:</span> <span class=k>lambda</span> <span class=n>x</span><span class=p>:</span> <span class=n>robust_datetime_serialization</span><span class=p>(</span><span class=n>x</span><span class=p>)}</span>
+        <span class=n>allow_population_by_field_name</span> <span class=o>=</span> <span class=kc>True</span>
+
+        <span class=c1># Enforce strict schema</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+        <span class=c1># Validate on assignment of variables to ensure no escapes</span>
+        <span class=n>validate_assignment</span> <span class=o>=</span> <span class=kc>True</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>create_stripped_model_type</span><span class=p>(</span>
+        <span class=bp>cls</span><span class=p>,</span>
+        <span class=n>stripped_fields</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>stripped_fields_aliases</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Type</span><span class=p>[</span><span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create a pydantic model, which is derived from the current model, but missing certain fields.</span>
+
+<span class=sd>        OSCAL mandates a &#39;strict&#39; schema (e.g. unless otherwise stated no additional fields), and certain fields</span>
+<span class=sd>        are mandatory. Given this the corresponding dataclasses are also strict. Workflows with trestle require missing</span>
+<span class=sd>        mandatory fields. This allows creation of derivative models missing certain fields.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            stripped_fields: The fields to be removed from the current data class.</span>
+<span class=sd>            stripped_fields_aliases: The fields to be removed from the current data class provided by alias.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Pydantic data class thta can be used to instanciate a model.</span>
+
+<span class=sd>        Raises:</span>
+<span class=sd>            TrestleError: If user provided both stripped_fields and stripped_field_aliases or neither.</span>
+<span class=sd>            TrestleError: If incorrect aliases or field names are provided.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>stripped_fields</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>stripped_fields_aliases</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Either &quot;stripped_fields&quot; or &quot;stripped_fields_aliases&quot; need to be passed, not both.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>stripped_fields</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>stripped_fields_aliases</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Exactly one of &quot;stripped_fields&quot; or &quot;stripped_fields_aliases&quot; must be provided&#39;</span><span class=p>)</span>
+
+        <span class=c1># create alias to field_name mapping</span>
+        <span class=n>excluded_fields</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>stripped_fields</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>excluded_fields</span> <span class=o>=</span> <span class=n>stripped_fields</span>
+        <span class=k>elif</span> <span class=n>stripped_fields_aliases</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>alias_to_field</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>excluded_fields</span> <span class=o>=</span> <span class=p>[</span><span class=n>alias_to_field</span><span class=p>[</span><span class=n>key</span><span class=p>]</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>stripped_fields_aliases</span><span class=p>]</span>
+            <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Field </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist in the model&#39;</span><span class=p>)</span>
+
+        <span class=n>current_fields</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span>
+        <span class=n>new_fields_for_model</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># Build field list</span>
+        <span class=k>for</span> <span class=n>current_mfield</span> <span class=ow>in</span> <span class=n>current_fields</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>excluded_fields</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=c1># Validate name in the field</span>
+            <span class=c1># Cehcke behaviour with an alias</span>
+            <span class=k>if</span> <span class=n>current_mfield</span><span class=o>.</span><span class=n>required</span><span class=p>:</span>
+                <span class=n>new_fields_for_model</span><span class=p>[</span>
+                    <span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span>
+                <span class=p>]</span> <span class=o>=</span> <span class=p>(</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>outer_type_</span><span class=p>,</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>alias</span><span class=p>))</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>new_fields_for_model</span><span class=p>[</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=p>(</span>
+                    <span class=n>Optional</span><span class=p>[</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>outer_type_</span><span class=p>],</span>
+                    <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>alias</span><span class=p>)</span>
+                <span class=p>)</span>
+        <span class=n>new_model</span> <span class=o>=</span> <span class=n>create_model</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>__base__</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=o>**</span><span class=n>new_fields_for_model</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=c1># TODO: This typing cast should NOT be necessary. Potentially fixable with a fix to pydantic. Issue #175</span>
+        <span class=n>new_model</span> <span class=o>=</span> <span class=n>cast</span><span class=p>(</span><span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>new_model</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>new_model</span>
+
+    <span class=k>def</span> <span class=nf>get_field_by_alias</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>field_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert field alias to a field.&quot;&quot;&quot;</span>
+        <span class=n>attr_field</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>field_alias</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>attr_field</span>
+
+    <span class=k>def</span> <span class=nf>get_field_value_by_alias</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>attr_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get attribute value by field alias.&quot;&quot;&quot;</span>
+        <span class=c1># TODO: can this be restricted beyond Any easily.</span>
+        <span class=n>attr_field</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_field_by_alias</span><span class=p>(</span><span class=n>attr_alias</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>attr_field</span><span class=p>,</span> <span class=n>ModelField</span><span class=p>):</span>
+            <span class=k>return</span> <span class=nb>getattr</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>attr_field</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>stripped_instance</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>stripped_fields</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>stripped_fields_aliases</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return a new model instance with the specified fields being stripped.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            stripped_fields: The fields to be removed from the current data class.</span>
+<span class=sd>            stripped_fields_aliases: The fields to be removed from the current data class provided by alias.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The current datamodel with the fields provided removed in a derivate (run time created) data model.</span>
+
+<span class=sd>        Raises:</span>
+<span class=sd>            err.TrestleError: If user provided both stripped_fields and stripped_field_aliases or neither.</span>
+<span class=sd>            err.TrestleError: If incorrect aliases or field names are provided.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># stripped class type</span>
+        <span class=n>stripped_class</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>create_stripped_model_type</span><span class=p>(</span>
+            <span class=n>stripped_fields</span><span class=o>=</span><span class=n>stripped_fields</span><span class=p>,</span> <span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=n>stripped_fields_aliases</span>
+        <span class=p>)</span>
+
+        <span class=c1># remaining values</span>
+        <span class=n>remaining_values</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>field</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>stripped_class</span><span class=o>.</span><span class=n>__fields__</span><span class=p>:</span>
+                <span class=n>remaining_values</span><span class=p>[</span><span class=n>field</span><span class=o>.</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>field</span><span class=o>.</span><span class=n>name</span><span class=p>]</span>
+
+        <span class=c1># create stripped model instance</span>
+        <span class=c1># TODO: Not sure if we can avoid type escapes here</span>
+        <span class=n>stripped_instance</span> <span class=o>=</span> <span class=n>stripped_class</span><span class=p>(</span><span class=o>**</span><span class=n>remaining_values</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>stripped_instance</span>
+
+    <span class=k>def</span> <span class=nf>oscal_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return a dictionary including the root wrapping object key.&quot;&quot;&quot;</span>
+        <span class=n>class_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span>
+        <span class=n>result</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>raw_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>dict</span><span class=p>(</span><span class=n>by_alias</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exclude_none</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># Additional check to avoid root serialization</span>
+        <span class=k>if</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=n>raw_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>result</span><span class=p>[</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>class_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)]</span> <span class=o>=</span> <span class=n>raw_dict</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>result</span><span class=p>[</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>class_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)]</span> <span class=o>=</span> <span class=n>raw_dict</span>
+        <span class=k>return</span> <span class=n>result</span>
+
+    <span class=k>def</span> <span class=nf>oscal_serialize_json_bytes</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>pretty</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span> <span class=n>wrapped</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bytes</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Return an &#39;oscal wrapped&#39; json object serialized in a compressed form as bytes.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            pretty: Whether or not to pretty-print json output or have in compressed form.</span>
+<span class=sd>        Returns:</span>
+<span class=sd>            Oscal model serialized to a json object including packaging inside of a single top level key.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>wrapped</span><span class=p>:</span>
+            <span class=n>odict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>oscal_dict</span><span class=p>()</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>odict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>dict</span><span class=p>(</span><span class=n>by_alias</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exclude_none</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>pretty</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>orjson</span><span class=o>.</span><span class=n>dumps</span><span class=p>(</span><span class=n>odict</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>__json_encoder__</span><span class=p>,</span> <span class=n>option</span><span class=o>=</span><span class=n>orjson</span><span class=o>.</span><span class=n>OPT_INDENT_2</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=k>return</span> <span class=n>orjson</span><span class=o>.</span><span class=n>dumps</span><span class=p>(</span><span class=n>odict</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>__json_encoder__</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+
+    <span class=k>def</span> <span class=nf>oscal_serialize_json</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>pretty</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span> <span class=n>wrapped</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Return an &#39;oscal wrapped&#39; json object serialized in a compressed form as bytes.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            pretty: Whether or not to pretty-print json output or have in compressed form.</span>
+<span class=sd>        Returns:</span>
+<span class=sd>            Oscal model serialized to a json object including packaging inside of a single top level key.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># This function is provided for backwards compatibility</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>oscal_serialize_json_bytes</span><span class=p>(</span><span class=n>pretty</span><span class=p>,</span> <span class=n>wrapped</span><span class=p>)</span><span class=o>.</span><span class=n>decode</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>oscal_write</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Write out a pydantic data model in an oscal friendly way.</span>
+
+<span class=sd>        OSCAL schema mandates that top level elements are wrapped in a singular</span>
+<span class=sd>        json/yaml field. This function handles both json and yaml output as well</span>
+<span class=sd>        as formatting of the json.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            path: The output file location for the oscal object.</span>
+
+<span class=sd>        Raises:</span>
+<span class=sd>            err.TrestleError: If a unknown file extension is provided.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+        <span class=c1># The output will have \r\n newlines on windows and \n newlines elsewhere</span>
+
+        <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span><span class=p>:</span>
+            <span class=n>write_file</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+            <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+            <span class=n>yaml</span><span class=o>.</span><span class=n>dump</span><span class=p>(</span><span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>()),</span> <span class=n>write_file</span><span class=p>)</span>
+            <span class=n>write_file</span><span class=o>.</span><span class=n>flush</span><span class=p>()</span>
+            <span class=n>write_file</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+        <span class=k>elif</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+            <span class=n>write_file</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;wb&#39;</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+            <span class=n>write_file</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>oscal_serialize_json_bytes</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=kc>True</span><span class=p>))</span>  <span class=c1># type: ignore</span>
+            <span class=c1># Flush / close required (by experience) due to flushing issues in tests.</span>
+            <span class=n>write_file</span><span class=o>.</span><span class=n>flush</span><span class=p>()</span>
+            <span class=n>write_file</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>oscal_read</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Read OSCAL objects.</span>
+
+<span class=sd>        Handles the fact OSCAL wraps top level elements and also deals with both yaml and json.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            path: The path of the oscal object to read.</span>
+<span class=sd>        Returns:</span>
+<span class=sd>            The oscal object read into trestle oscal models.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># Create the wrapper model.</span>
+        <span class=n>alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+        <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;oscal_read content type </span><span class=si>{</span><span class=n>content_type</span><span class=si>}</span><span class=s1> and alias </span><span class=si>{</span><span class=n>alias</span><span class=si>}</span><span class=s1> from </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;path does not exist in oscal_read: </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>None</span>
+
+        <span class=n>obj</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span><span class=p>:</span>
+                <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+                <span class=n>fh</span> <span class=o>=</span> <span class=n>path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+                <span class=n>obj</span> <span class=o>=</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>fh</span><span class=p>)</span>
+                <span class=n>fh</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+            <span class=k>elif</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+                <span class=n>obj</span> <span class=o>=</span> <span class=n>load_file</span><span class=p>(</span>
+                    <span class=n>path</span><span class=p>,</span>
+                    <span class=n>json_loads</span><span class=o>=</span><span class=bp>cls</span><span class=o>.</span><span class=n>__config__</span><span class=o>.</span><span class=n>json_loads</span><span class=p>,</span>
+                <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error loading file </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=nb>len</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Invalid OSCAL file structure, oscal file &#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;does not have a single top level key wrapping it. It has </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span><span class=si>}</span><span class=s1> keys.&#39;</span>
+                <span class=p>)</span>
+            <span class=n>parsed</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>parse_obj</span><span class=p>(</span><span class=n>obj</span><span class=p>[</span><span class=n>alias</span><span class=p>])</span>
+        <span class=k>except</span> <span class=ne>KeyError</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided oscal file does not have top level key key: </span><span class=si>{</span><span class=n>alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error parsing file </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>parsed</span>
+
+    <span class=k>def</span> <span class=nf>copy_to</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>new_oscal_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Opportunistic copy operation between similar types of data classes.</span>
+
+<span class=sd>        Due to the way in which oscal is constructed we get a set of similar / the same definition across various</span>
+<span class=sd>        oscal models. Due to the lack of guarantees that they are the same we cannot easily &#39;collapse&#39; the mode.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            new_oscal_type: The desired type of oscal model</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Opportunistic copy of the data into the new model type.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Copy to started&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span> <span class=o>==</span> <span class=n>new_oscal_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Json based copy&#39;</span><span class=p>)</span>
+            <span class=c1># Note: Json based oppportunistic copy</span>
+            <span class=c1># Dev notes: Do not change this from json. Due to enums (in particular) json is the closest we can get.</span>
+            <span class=k>return</span> <span class=n>new_oscal_type</span><span class=o>.</span><span class=n>parse_raw</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>wrapped</span><span class=o>=</span><span class=kc>False</span><span class=p>))</span>
+
+        <span class=k>if</span> <span class=p>(</span><span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>__fields__</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>__fields__</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span> <span class=ow>and</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=n>new_oscal_type</span><span class=o>.</span><span class=n>__fields__</span>
+                <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=n>new_oscal_type</span><span class=o>.</span><span class=n>__fields__</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Root element based copy too&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>new_oscal_type</span><span class=o>.</span><span class=n>parse_obj</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>__root__</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+
+        <span class=c1># bad place here.</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Provided inconsistent classes to copy to methodology.&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>copy_from</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>existing_oscal_object</span><span class=p>:</span> <span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Copy operation that implicitly does type conversion.</span>
+
+<span class=sd>        Typically would</span>
+<span class=sd>        be used to set an attribute, however, does not need to be.</span>
+
+<span class=sd>        Deals with two scenarios:</span>
+<span class=sd>        1) Casting across oscal models of equivalent type. The purpose if this</span>
+<span class=sd>        is to cross class spaces.</span>
+
+<span class=sd>        2) The same as above where the item is an array style object which does</span>
+<span class=sd>        not correctly serialize to a dict.</span>
+
+<span class=sd>        3) if the from and &#39;to&#39; objects are root schema elements the copy operation</span>
+<span class=sd>        will copy the root element to the value.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            existing_oscal_object: The oscal object where fields are copied from.</span>
+
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>recast_object</span> <span class=o>=</span> <span class=n>existing_oscal_object</span><span class=o>.</span><span class=n>copy_to</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__class__</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>raw_field</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>raw_field</span><span class=p>]</span> <span class=o>=</span> <span class=n>recast_object</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>raw_field</span><span class=p>]</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>alias_to_field_map</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ModelField</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create a map from field alias to field.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            A dict which has key&#39;s of aliases and Fields as values.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>alias_to_field</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ModelField</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=n>alias_to_field</span><span class=p>[</span><span class=n>field</span><span class=o>.</span><span class=n>alias</span><span class=p>]</span> <span class=o>=</span> <span class=n>field</span>
+
+        <span class=k>return</span> <span class=n>alias_to_field</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>is_collection_container</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Determine whether a pydantic model has being created to wrap a collection primitive (e.g a list or dict).</span>
+
+<span class=sd>        In performing model decomposition it is possible using trestle framework to automatically generate a model</span>
+<span class=sd>        which looks like</span>
+
+<span class=sd>        class Foo(OscalBaseModel):</span>
+<span class=sd>            __root__: List[Bar]</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Boolean on if it meets the above criteria</span>
+
+<span class=sd>        When these cases exist we need special handling of the type information.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># Additional sanity check on field length</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span> <span class=ow>and</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=p>:</span>
+            <span class=c1># This is now a __root__ key only model</span>
+            <span class=k>if</span> <span class=n>is_collection_field_type</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span><span class=p>):</span>
+                <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>get_collection_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>type</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        If the type wraps an collection, return the collection type.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The collection type.</span>
+
+<span class=sd>        Raises:</span>
+<span class=sd>            err.TrestleError: if not a wrapper of the collection type.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>cls</span><span class=o>.</span><span class=n>is_collection_container</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;OscalBaseModel is not wrapping a collection type&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>get_origin</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.base_model.OscalBaseModel-classes>Classes<a href=#trestle.core.base_model.OscalBaseModel-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.core.base_model.OscalBaseModel.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.core.base_model.OscalBaseModel.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Overriding configuration class for pydantic base model, for use with OSCAL data classes.</p> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span>
+<span class=normal>98</span>
+<span class=normal>99</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Overriding configuration class for pydantic base model, for use with OSCAL data classes.&quot;&quot;&quot;</span>
+
+    <span class=n>json_loads</span> <span class=o>=</span> <span class=n>orjson</span><span class=o>.</span><span class=n>loads</span>
+    <span class=c1># TODO: json_dumps with orjson.dumps see #840</span>
+
+    <span class=n>json_encoders</span> <span class=o>=</span> <span class=p>{</span><span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=p>:</span> <span class=k>lambda</span> <span class=n>x</span><span class=p>:</span> <span class=n>robust_datetime_serialization</span><span class=p>(</span><span class=n>x</span><span class=p>)}</span>
+    <span class=n>allow_population_by_field_name</span> <span class=o>=</span> <span class=kc>True</span>
+
+    <span class=c1># Enforce strict schema</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=c1># Validate on assignment of variables to ensure no escapes</span>
+    <span class=n>validate_assignment</span> <span class=o>=</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.core.base_model.OscalBaseModel.Config-attributes>Attributes<a href=#trestle.core.base_model.OscalBaseModel.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.base_model.OscalBaseModel.Config.allow_population_by_field_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>allow_population_by_field_name</span> <span class=o>=</span> <span class=kc>True</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.Config.allow_population_by_field_name class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.base_model.OscalBaseModel.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.base_model.OscalBaseModel.Config.json_encoders class="doc doc-heading"> <code class="highlight language-python"><span class=n>json_encoders</span> <span class=o>=</span> <span class=p>{</span><span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=p>:</span> <span class=k>lambda</span> <span class=n>x</span><span class=p>:</span> <span class=n>robust_datetime_serialization</span><span class=p>(</span><span class=n>x</span><span class=p>)}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.Config.json_encoders class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.base_model.OscalBaseModel.Config.json_loads class="doc doc-heading"> <code class="highlight language-python"><span class=n>json_loads</span> <span class=o>=</span> <span class=n>orjson</span><span class=o>.</span><span class=n>loads</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.Config.json_loads class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.base_model.OscalBaseModel.Config.validate_assignment class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate_assignment</span> <span class=o>=</span> <span class=kc>True</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.Config.validate_assignment class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h5 id=trestle.core.base_model.OscalBaseModel-functions>Functions<a href=#trestle.core.base_model.OscalBaseModel-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.alias_to_field_map class="doc doc-heading"> <code class="highlight language-python"><span class=n>alias_to_field_map</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.alias_to_field_map class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create a map from field alias to field.</p> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Dict>Dict</span>[str, <span title=pydantic.v1.fields.ModelField>ModelField</span>]</code> </td> <td> <div class=doc-md-description> <p>A dict which has key's of aliases and Fields as values.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>alias_to_field_map</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ModelField</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create a map from field alias to field.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        A dict which has key&#39;s of aliases and Fields as values.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>alias_to_field</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ModelField</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=n>alias_to_field</span><span class=p>[</span><span class=n>field</span><span class=o>.</span><span class=n>alias</span><span class=p>]</span> <span class=o>=</span> <span class=n>field</span>
+
+    <span class=k>return</span> <span class=n>alias_to_field</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.copy_from class="doc doc-heading"> <code class="highlight language-python"><span class=n>copy_from</span><span class=p>(</span><span class=n>existing_oscal_object</span><span class=p>)</span></code> <a href=#trestle.core.base_model.OscalBaseModel.copy_from class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Copy operation that implicitly does type conversion.</p> <p>Typically would be used to set an attribute, however, does not need to be.</p> <p>Deals with two scenarios: 1) Casting across oscal models of equivalent type. The purpose if this is to cross class spaces.</p> <p>2) The same as above where the item is an array style object which does not correctly serialize to a dict.</p> <p>3) if the from and 'to' objects are root schema elements the copy operation will copy the root element to the value.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>existing_oscal_object</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code> </td> <td> <div class=doc-md-description> <p>The oscal object where fields are copied from.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>copy_from</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>existing_oscal_object</span><span class=p>:</span> <span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Copy operation that implicitly does type conversion.</span>
+
+<span class=sd>    Typically would</span>
+<span class=sd>    be used to set an attribute, however, does not need to be.</span>
+
+<span class=sd>    Deals with two scenarios:</span>
+<span class=sd>    1) Casting across oscal models of equivalent type. The purpose if this</span>
+<span class=sd>    is to cross class spaces.</span>
+
+<span class=sd>    2) The same as above where the item is an array style object which does</span>
+<span class=sd>    not correctly serialize to a dict.</span>
+
+<span class=sd>    3) if the from and &#39;to&#39; objects are root schema elements the copy operation</span>
+<span class=sd>    will copy the root element to the value.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        existing_oscal_object: The oscal object where fields are copied from.</span>
+
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>recast_object</span> <span class=o>=</span> <span class=n>existing_oscal_object</span><span class=o>.</span><span class=n>copy_to</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__class__</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>raw_field</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>raw_field</span><span class=p>]</span> <span class=o>=</span> <span class=n>recast_object</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>raw_field</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.copy_to class="doc doc-heading"> <code class="highlight language-python"><span class=n>copy_to</span><span class=p>(</span><span class=n>new_oscal_type</span><span class=p>)</span></code> <a href=#trestle.core.base_model.OscalBaseModel.copy_to class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Opportunistic copy operation between similar types of data classes.</p> <p>Due to the way in which oscal is constructed we get a set of similar / the same definition across various oscal models. Due to the lack of guarantees that they are the same we cannot easily 'collapse' the mode.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>new_oscal_type</code> </td> <td> <code><span title=typing.Type>Type</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>]</code> </td> <td> <div class=doc-md-description> <p>The desired type of oscal model</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code> </td> <td> <div class=doc-md-description> <p>Opportunistic copy of the data into the new model type.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>copy_to</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>new_oscal_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Opportunistic copy operation between similar types of data classes.</span>
+
+<span class=sd>    Due to the way in which oscal is constructed we get a set of similar / the same definition across various</span>
+<span class=sd>    oscal models. Due to the lack of guarantees that they are the same we cannot easily &#39;collapse&#39; the mode.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        new_oscal_type: The desired type of oscal model</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Opportunistic copy of the data into the new model type.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Copy to started&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span> <span class=o>==</span> <span class=n>new_oscal_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Json based copy&#39;</span><span class=p>)</span>
+        <span class=c1># Note: Json based oppportunistic copy</span>
+        <span class=c1># Dev notes: Do not change this from json. Due to enums (in particular) json is the closest we can get.</span>
+        <span class=k>return</span> <span class=n>new_oscal_type</span><span class=o>.</span><span class=n>parse_raw</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>wrapped</span><span class=o>=</span><span class=kc>False</span><span class=p>))</span>
+
+    <span class=k>if</span> <span class=p>(</span><span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>__fields__</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>__fields__</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span> <span class=ow>and</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=n>new_oscal_type</span><span class=o>.</span><span class=n>__fields__</span>
+            <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=n>new_oscal_type</span><span class=o>.</span><span class=n>__fields__</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>):</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Root element based copy too&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>new_oscal_type</span><span class=o>.</span><span class=n>parse_obj</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>__root__</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+
+    <span class=c1># bad place here.</span>
+    <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Provided inconsistent classes to copy to methodology.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.create_stripped_model_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>create_stripped_model_type</span><span class=p>(</span><span class=n>stripped_fields</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.create_stripped_model_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create a pydantic model, which is derived from the current model, but missing certain fields.</p> <p>OSCAL mandates a 'strict' schema (e.g. unless otherwise stated no additional fields), and certain fields are mandatory. Given this the corresponding dataclasses are also strict. Workflows with trestle require missing mandatory fields. This allows creation of derivative models missing certain fields.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>stripped_fields</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>The fields to be removed from the current data class.</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>stripped_fields_aliases</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>The fields to be removed from the current data class provided by alias.</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Type>Type</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>]</code> </td> <td> <div class=doc-md-description> <p>Pydantic data class thta can be used to instanciate a model.</p> </div> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Raises:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>TrestleError</code> </td> <td> <div class=doc-md-description> <p>If user provided both stripped_fields and stripped_field_aliases or neither.</p> </div> </td> </tr> <tr class=doc-section-item> <td> <code>TrestleError</code> </td> <td> <div class=doc-md-description> <p>If incorrect aliases or field names are provided.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>create_stripped_model_type</span><span class=p>(</span>
+    <span class=bp>cls</span><span class=p>,</span>
+    <span class=n>stripped_fields</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>stripped_fields_aliases</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Type</span><span class=p>[</span><span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create a pydantic model, which is derived from the current model, but missing certain fields.</span>
+
+<span class=sd>    OSCAL mandates a &#39;strict&#39; schema (e.g. unless otherwise stated no additional fields), and certain fields</span>
+<span class=sd>    are mandatory. Given this the corresponding dataclasses are also strict. Workflows with trestle require missing</span>
+<span class=sd>    mandatory fields. This allows creation of derivative models missing certain fields.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        stripped_fields: The fields to be removed from the current data class.</span>
+<span class=sd>        stripped_fields_aliases: The fields to be removed from the current data class provided by alias.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Pydantic data class thta can be used to instanciate a model.</span>
+
+<span class=sd>    Raises:</span>
+<span class=sd>        TrestleError: If user provided both stripped_fields and stripped_field_aliases or neither.</span>
+<span class=sd>        TrestleError: If incorrect aliases or field names are provided.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>stripped_fields</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>stripped_fields_aliases</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Either &quot;stripped_fields&quot; or &quot;stripped_fields_aliases&quot; need to be passed, not both.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>stripped_fields</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>stripped_fields_aliases</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Exactly one of &quot;stripped_fields&quot; or &quot;stripped_fields_aliases&quot; must be provided&#39;</span><span class=p>)</span>
+
+    <span class=c1># create alias to field_name mapping</span>
+    <span class=n>excluded_fields</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=n>stripped_fields</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>excluded_fields</span> <span class=o>=</span> <span class=n>stripped_fields</span>
+    <span class=k>elif</span> <span class=n>stripped_fields_aliases</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>alias_to_field</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>excluded_fields</span> <span class=o>=</span> <span class=p>[</span><span class=n>alias_to_field</span><span class=p>[</span><span class=n>key</span><span class=p>]</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>stripped_fields_aliases</span><span class=p>]</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Field </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist in the model&#39;</span><span class=p>)</span>
+
+    <span class=n>current_fields</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span>
+    <span class=n>new_fields_for_model</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=c1># Build field list</span>
+    <span class=k>for</span> <span class=n>current_mfield</span> <span class=ow>in</span> <span class=n>current_fields</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>excluded_fields</span><span class=p>:</span>
+            <span class=k>continue</span>
+        <span class=c1># Validate name in the field</span>
+        <span class=c1># Cehcke behaviour with an alias</span>
+        <span class=k>if</span> <span class=n>current_mfield</span><span class=o>.</span><span class=n>required</span><span class=p>:</span>
+            <span class=n>new_fields_for_model</span><span class=p>[</span>
+                <span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span>
+            <span class=p>]</span> <span class=o>=</span> <span class=p>(</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>outer_type_</span><span class=p>,</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>alias</span><span class=p>))</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>new_fields_for_model</span><span class=p>[</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=p>(</span>
+                <span class=n>Optional</span><span class=p>[</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>outer_type_</span><span class=p>],</span>
+                <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=n>current_mfield</span><span class=o>.</span><span class=n>alias</span><span class=p>)</span>
+            <span class=p>)</span>
+    <span class=n>new_model</span> <span class=o>=</span> <span class=n>create_model</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>__base__</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=o>**</span><span class=n>new_fields_for_model</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+    <span class=c1># TODO: This typing cast should NOT be necessary. Potentially fixable with a fix to pydantic. Issue #175</span>
+    <span class=n>new_model</span> <span class=o>=</span> <span class=n>cast</span><span class=p>(</span><span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>new_model</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>new_model</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.get_collection_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_collection_type</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.get_collection_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>If the type wraps an collection, return the collection type.</p> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Optional>Optional</span>[type]</code> </td> <td> <div class=doc-md-description> <p>The collection type.</p> </div> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Raises:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleError href=../../common/err/#trestle.common.err.TrestleError>TrestleError</a></code> </td> <td> <div class=doc-md-description> <p>if not a wrapper of the collection type.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>get_collection_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>type</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    If the type wraps an collection, return the collection type.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The collection type.</span>
+
+<span class=sd>    Raises:</span>
+<span class=sd>        err.TrestleError: if not a wrapper of the collection type.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>cls</span><span class=o>.</span><span class=n>is_collection_container</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;OscalBaseModel is not wrapping a collection type&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>get_origin</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.get_field_by_alias class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_field_by_alias</span><span class=p>(</span><span class=n>field_alias</span><span class=p>)</span></code> <a href=#trestle.core.base_model.OscalBaseModel.get_field_by_alias class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert field alias to a field.</p> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_field_by_alias</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>field_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert field alias to a field.&quot;&quot;&quot;</span>
+    <span class=n>attr_field</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>field_alias</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>attr_field</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.get_field_value_by_alias class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_field_value_by_alias</span><span class=p>(</span><span class=n>attr_alias</span><span class=p>)</span></code> <a href=#trestle.core.base_model.OscalBaseModel.get_field_value_by_alias class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get attribute value by field alias.</p> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_field_value_by_alias</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>attr_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get attribute value by field alias.&quot;&quot;&quot;</span>
+    <span class=c1># TODO: can this be restricted beyond Any easily.</span>
+    <span class=n>attr_field</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_field_by_alias</span><span class=p>(</span><span class=n>attr_alias</span><span class=p>)</span>
+    <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>attr_field</span><span class=p>,</span> <span class=n>ModelField</span><span class=p>):</span>
+        <span class=k>return</span> <span class=nb>getattr</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>attr_field</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.is_collection_container class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_collection_container</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.is_collection_container class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Determine whether a pydantic model has being created to wrap a collection primitive (e.g a list or dict).</p> <p>In performing model decomposition it is possible using trestle framework to automatically generate a model which looks like</p> <p>class Foo(OscalBaseModel): <strong>root</strong>: List[Bar]</p> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Boolean on if it meets the above criteria</p> </div> </td> </tr> </tbody> </table> <p>When these cases exist we need special handling of the type information.</p> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>is_collection_container</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Determine whether a pydantic model has being created to wrap a collection primitive (e.g a list or dict).</span>
+
+<span class=sd>    In performing model decomposition it is possible using trestle framework to automatically generate a model</span>
+<span class=sd>    which looks like</span>
+
+<span class=sd>    class Foo(OscalBaseModel):</span>
+<span class=sd>        __root__: List[Bar]</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Boolean on if it meets the above criteria</span>
+
+<span class=sd>    When these cases exist we need special handling of the type information.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># Additional sanity check on field length</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span> <span class=ow>and</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=p>:</span>
+        <span class=c1># This is now a __root__ key only model</span>
+        <span class=k>if</span> <span class=n>is_collection_field_type</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.oscal_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>oscal_dict</span><span class=p>()</span></code> <a href=#trestle.core.base_model.OscalBaseModel.oscal_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return a dictionary including the root wrapping object key.</p> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>oscal_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return a dictionary including the root wrapping object key.&quot;&quot;&quot;</span>
+    <span class=n>class_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span>
+    <span class=n>result</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>raw_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>dict</span><span class=p>(</span><span class=n>by_alias</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exclude_none</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=c1># Additional check to avoid root serialization</span>
+    <span class=k>if</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=n>raw_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=n>result</span><span class=p>[</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>class_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)]</span> <span class=o>=</span> <span class=n>raw_dict</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>result</span><span class=p>[</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>class_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)]</span> <span class=o>=</span> <span class=n>raw_dict</span>
+    <span class=k>return</span> <span class=n>result</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.oscal_read class="doc doc-heading"> <code class="highlight language-python"><span class=n>oscal_read</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.base_model.OscalBaseModel.oscal_read class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read OSCAL objects.</p> <p>Handles the fact OSCAL wraps top level elements and also deals with both yaml and json.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The path of the oscal object to read.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p>Returns: The oscal object read into trestle oscal models.</p> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>oscal_read</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Read OSCAL objects.</span>
+
+<span class=sd>    Handles the fact OSCAL wraps top level elements and also deals with both yaml and json.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        path: The path of the oscal object to read.</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        The oscal object read into trestle oscal models.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># Create the wrapper model.</span>
+    <span class=n>alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=bp>cls</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+    <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;oscal_read content type </span><span class=si>{</span><span class=n>content_type</span><span class=si>}</span><span class=s1> and alias </span><span class=si>{</span><span class=n>alias</span><span class=si>}</span><span class=s1> from </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;path does not exist in oscal_read: </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=n>obj</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span><span class=p>:</span>
+            <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+            <span class=n>fh</span> <span class=o>=</span> <span class=n>path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+            <span class=n>obj</span> <span class=o>=</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>fh</span><span class=p>)</span>
+            <span class=n>fh</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+        <span class=k>elif</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+            <span class=n>obj</span> <span class=o>=</span> <span class=n>load_file</span><span class=p>(</span>
+                <span class=n>path</span><span class=p>,</span>
+                <span class=n>json_loads</span><span class=o>=</span><span class=bp>cls</span><span class=o>.</span><span class=n>__config__</span><span class=o>.</span><span class=n>json_loads</span><span class=p>,</span>
+            <span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error loading file </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>len</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Invalid OSCAL file structure, oscal file &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;does not have a single top level key wrapping it. It has </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span><span class=si>}</span><span class=s1> keys.&#39;</span>
+            <span class=p>)</span>
+        <span class=n>parsed</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>parse_obj</span><span class=p>(</span><span class=n>obj</span><span class=p>[</span><span class=n>alias</span><span class=p>])</span>
+    <span class=k>except</span> <span class=ne>KeyError</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided oscal file does not have top level key key: </span><span class=si>{</span><span class=n>alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error parsing file </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>parsed</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.oscal_serialize_json class="doc doc-heading"> <code class="highlight language-python"><span class=n>oscal_serialize_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>wrapped</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.base_model.OscalBaseModel.oscal_serialize_json class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return an 'oscal wrapped' json object serialized in a compressed form as bytes.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>pretty</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether or not to pretty-print json output or have in compressed form.</p> </div> </td> <td> <code>False</code> </td> </tr> </tbody> </table> <p>Returns: Oscal model serialized to a json object including packaging inside of a single top level key.</p> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>oscal_serialize_json</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>pretty</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span> <span class=n>wrapped</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Return an &#39;oscal wrapped&#39; json object serialized in a compressed form as bytes.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        pretty: Whether or not to pretty-print json output or have in compressed form.</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        Oscal model serialized to a json object including packaging inside of a single top level key.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># This function is provided for backwards compatibility</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>oscal_serialize_json_bytes</span><span class=p>(</span><span class=n>pretty</span><span class=p>,</span> <span class=n>wrapped</span><span class=p>)</span><span class=o>.</span><span class=n>decode</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.oscal_serialize_json_bytes class="doc doc-heading"> <code class="highlight language-python"><span class=n>oscal_serialize_json_bytes</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>wrapped</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.base_model.OscalBaseModel.oscal_serialize_json_bytes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return an 'oscal wrapped' json object serialized in a compressed form as bytes.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>pretty</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether or not to pretty-print json output or have in compressed form.</p> </div> </td> <td> <code>False</code> </td> </tr> </tbody> </table> <p>Returns: Oscal model serialized to a json object including packaging inside of a single top level key.</p> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>oscal_serialize_json_bytes</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>pretty</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span> <span class=n>wrapped</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bytes</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Return an &#39;oscal wrapped&#39; json object serialized in a compressed form as bytes.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        pretty: Whether or not to pretty-print json output or have in compressed form.</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        Oscal model serialized to a json object including packaging inside of a single top level key.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>wrapped</span><span class=p>:</span>
+        <span class=n>odict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>oscal_dict</span><span class=p>()</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>odict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>dict</span><span class=p>(</span><span class=n>by_alias</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exclude_none</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>pretty</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>orjson</span><span class=o>.</span><span class=n>dumps</span><span class=p>(</span><span class=n>odict</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>__json_encoder__</span><span class=p>,</span> <span class=n>option</span><span class=o>=</span><span class=n>orjson</span><span class=o>.</span><span class=n>OPT_INDENT_2</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+    <span class=k>return</span> <span class=n>orjson</span><span class=o>.</span><span class=n>dumps</span><span class=p>(</span><span class=n>odict</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>__json_encoder__</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.oscal_write class="doc doc-heading"> <code class="highlight language-python"><span class=n>oscal_write</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.core.base_model.OscalBaseModel.oscal_write class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write out a pydantic data model in an oscal friendly way.</p> <p>OSCAL schema mandates that top level elements are wrapped in a singular json/yaml field. This function handles both json and yaml output as well as formatting of the json.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The output file location for the oscal object.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Raises:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleError href=../../common/err/#trestle.common.err.TrestleError>TrestleError</a></code> </td> <td> <div class=doc-md-description> <p>If a unknown file extension is provided.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>oscal_write</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Write out a pydantic data model in an oscal friendly way.</span>
+
+<span class=sd>    OSCAL schema mandates that top level elements are wrapped in a singular</span>
+<span class=sd>    json/yaml field. This function handles both json and yaml output as well</span>
+<span class=sd>    as formatting of the json.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        path: The output file location for the oscal object.</span>
+
+<span class=sd>    Raises:</span>
+<span class=sd>        err.TrestleError: If a unknown file extension is provided.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+    <span class=c1># The output will have \r\n newlines on windows and \n newlines elsewhere</span>
+
+    <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span><span class=p>:</span>
+        <span class=n>write_file</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+        <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+        <span class=n>yaml</span><span class=o>.</span><span class=n>dump</span><span class=p>(</span><span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>()),</span> <span class=n>write_file</span><span class=p>)</span>
+        <span class=n>write_file</span><span class=o>.</span><span class=n>flush</span><span class=p>()</span>
+        <span class=n>write_file</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+    <span class=k>elif</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+        <span class=n>write_file</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;wb&#39;</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=n>write_file</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>oscal_serialize_json_bytes</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=kc>True</span><span class=p>))</span>  <span class=c1># type: ignore</span>
+        <span class=c1># Flush / close required (by experience) due to flushing issues in tests.</span>
+        <span class=n>write_file</span><span class=o>.</span><span class=n>flush</span><span class=p>()</span>
+        <span class=n>write_file</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.base_model.OscalBaseModel.stripped_instance class="doc doc-heading"> <code class="highlight language-python"><span class=n>stripped_instance</span><span class=p>(</span><span class=n>stripped_fields</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.base_model.OscalBaseModel.stripped_instance class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return a new model instance with the specified fields being stripped.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>stripped_fields</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>The fields to be removed from the current data class.</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>stripped_fields_aliases</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>The fields to be removed from the current data class provided by alias.</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code> </td> <td> <div class=doc-md-description> <p>The current datamodel with the fields provided removed in a derivate (run time created) data model.</p> </div> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Raises:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleError href=../../common/err/#trestle.common.err.TrestleError>TrestleError</a></code> </td> <td> <div class=doc-md-description> <p>If user provided both stripped_fields and stripped_field_aliases or neither.</p> </div> </td> </tr> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleError href=../../common/err/#trestle.common.err.TrestleError>TrestleError</a></code> </td> <td> <div class=doc-md-description> <p>If incorrect aliases or field names are provided.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>stripped_instance</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>stripped_fields</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>stripped_fields_aliases</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return a new model instance with the specified fields being stripped.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        stripped_fields: The fields to be removed from the current data class.</span>
+<span class=sd>        stripped_fields_aliases: The fields to be removed from the current data class provided by alias.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The current datamodel with the fields provided removed in a derivate (run time created) data model.</span>
+
+<span class=sd>    Raises:</span>
+<span class=sd>        err.TrestleError: If user provided both stripped_fields and stripped_field_aliases or neither.</span>
+<span class=sd>        err.TrestleError: If incorrect aliases or field names are provided.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># stripped class type</span>
+    <span class=n>stripped_class</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>create_stripped_model_type</span><span class=p>(</span>
+        <span class=n>stripped_fields</span><span class=o>=</span><span class=n>stripped_fields</span><span class=p>,</span> <span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=n>stripped_fields_aliases</span>
+    <span class=p>)</span>
+
+    <span class=c1># remaining values</span>
+    <span class=n>remaining_values</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>field</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>stripped_class</span><span class=o>.</span><span class=n>__fields__</span><span class=p>:</span>
+            <span class=n>remaining_values</span><span class=p>[</span><span class=n>field</span><span class=o>.</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=n>field</span><span class=o>.</span><span class=n>name</span><span class=p>]</span>
+
+    <span class=c1># create stripped model instance</span>
+    <span class=c1># TODO: Not sure if we can avoid type escapes here</span>
+    <span class=n>stripped_instance</span> <span class=o>=</span> <span class=n>stripped_class</span><span class=p>(</span><span class=o>**</span><span class=n>remaining_values</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>stripped_instance</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.base_model-functions>Functions<a href=#trestle.core.base_model-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.core.base_model.robust_datetime_serialization class="doc doc-heading"> <code class="highlight language-python"><span class=n>robust_datetime_serialization</span><span class=p>(</span><span class=n>input_dt</span><span class=p>)</span></code> <a href=#trestle.core.base_model.robust_datetime_serialization class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Return a nicely formatted string for in a format compatible with OSCAL specifications.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>input_dt</code> </td> <td> <code><span title=datetime.datetime>datetime</span></code> </td> <td> <div class=doc-md-description> <p>Input datetime to convert to a string.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>String in isoformat to the millisecond enforcing that timezone offset is provided.</p> </div> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Raises:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>TrestleError</code> </td> <td> <div class=doc-md-description> <p>Error is raised if datetime object does not contain sufficient timezone information.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>robust_datetime_serialization</span><span class=p>(</span><span class=n>input_dt</span><span class=p>:</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return a nicely formatted string for in a format compatible with OSCAL specifications.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        input_dt: Input datetime to convert to a string.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        String in isoformat to the millisecond enforcing that timezone offset is provided.</span>
+
+<span class=sd>    Raises:</span>
+<span class=sd>        TrestleError: Error is raised if datetime object does not contain sufficient timezone information.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># fail if the input datetime is not aware - ie it has no associated timezone</span>
+    <span class=k>if</span> <span class=n>input_dt</span><span class=o>.</span><span class=n>tzinfo</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Missing timezone in datetime&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>input_dt</span><span class=o>.</span><span class=n>tzinfo</span><span class=o>.</span><span class=n>utcoffset</span><span class=p>(</span><span class=n>input_dt</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Missing utcoffset in datetime&#39;</span><span class=p>)</span>
+
+    <span class=c1># use this leave in original timezone rather than utc</span>
+    <span class=c1># return input_dt.astimezone().isoformat(timespec=&#39;milliseconds&#39;)  noqa: E800</span>
+
+    <span class=c1># force it to be utc</span>
+    <span class=k>return</span> <span class=n>input_dt</span><span class=o>.</span><span class=n>astimezone</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>(</span><span class=n>timespec</span><span class=o>=</span><span class=s1>&#39;milliseconds&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/catalog/catalog_api/index.html b/latest/reference/API/trestle/core/catalog/catalog_api/index.html
new file mode 100644
index 000000000..5a74249cf
--- /dev/null
+++ b/latest/reference/API/trestle/core/catalog/catalog_api/index.html
@@ -0,0 +1,300 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.catalog.catalog_api module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_api/ rel=canonical><link href=../../validator_factory/ rel=prev><link href=../catalog_interface/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.catalog.catalog_api - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.catalog.catalog_api - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.catalog.catalog_api module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_api.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_api/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.catalog.catalog_api - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.catalog.catalog_api module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_api.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.catalog.catalog_api class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26 checked> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api class=md-nav__link> <span class=md-ellipsis> catalog_api </span> </a> <nav class=md-nav aria-label=catalog_api> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI class=md-nav__link> <span class=md-ellipsis> CatalogAPI </span> </a> <nav class=md-nav aria-label=CatalogAPI> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.merge_catalog class=md-nav__link> <span class=md-ellipsis> merge_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.read_additional_content_from_md class=md-nav__link> <span class=md-ellipsis> read_additional_content_from_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.read_catalog_from_markdown class=md-nav__link> <span class=md-ellipsis> read_catalog_from_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.update_context class=md-nav__link> <span class=md-ellipsis> update_context </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.write_catalog_as_markdown class=md-nav__link> <span class=md-ellipsis> write_catalog_as_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api class=md-nav__link> <span class=md-ellipsis> catalog_api </span> </a> <nav class=md-nav aria-label=catalog_api> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI class=md-nav__link> <span class=md-ellipsis> CatalogAPI </span> </a> <nav class=md-nav aria-label=CatalogAPI> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.merge_catalog class=md-nav__link> <span class=md-ellipsis> merge_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.read_additional_content_from_md class=md-nav__link> <span class=md-ellipsis> read_additional_content_from_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.read_catalog_from_markdown class=md-nav__link> <span class=md-ellipsis> read_catalog_from_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.update_context class=md-nav__link> <span class=md-ellipsis> update_context </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.write_catalog_as_markdown class=md-nav__link> <span class=md-ellipsis> write_catalog_as_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_api-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.catalog.catalog_api</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.catalog.catalog_api class="doc doc-heading"> <code>trestle.core.catalog.catalog_api</code> <a href=#trestle.core.catalog.catalog_api class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Main entrypoint to interact with catalog in memory.</p> <div class="doc doc-children"> <h3 id=trestle.core.catalog.catalog_api-attributes>Attributes<a href=#trestle.core.catalog.catalog_api-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.catalog.catalog_api.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_api.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.catalog.catalog_api-classes>Classes<a href=#trestle.core.catalog.catalog_api-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.catalog.catalog_api.CatalogAPI class="doc doc-heading"> <code>CatalogAPI</code> <a href=#trestle.core.catalog.catalog_api.CatalogAPI class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Main entrypoint to interact with catalog in memory.</p> <p>Encapsulates all necessary functionality to manipulate, read and write the catalog and its markdown representation.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogAPI</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Main entrypoint to interact with catalog in memory.</span>
+
+<span class=sd>    Encapsulates all necessary functionality to manipulate, read</span>
+<span class=sd>    and write the catalog and its markdown representation.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>],</span> <span class=n>context</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ControlContext</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize catalog api.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>catalog</span><span class=p>:</span>
+            <span class=c1># catalog assemble initializes with no catalog but may merge into an existing one later</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;No catalog was provided in CatalogAPI init, generating a new one.&#39;</span><span class=p>)</span>
+            <span class=n>catalog</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span> <span class=o>=</span> <span class=n>catalog</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span> <span class=o>=</span> <span class=n>CatalogWriter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_reader</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_merger</span> <span class=o>=</span> <span class=n>CatalogMerger</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_context</span> <span class=o>=</span> <span class=n>context</span>
+
+    <span class=k>def</span> <span class=nf>update_context</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update current context.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>context</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;ControlContext cannot be empty.&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_context</span> <span class=o>=</span> <span class=n>context</span>
+
+    <span class=k>def</span> <span class=nf>write_catalog_as_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>label_as_key</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Write out the catalog controls from dict as markdown files to the specified directory.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            label_as_key: Whether to use label_as_key for part_id to label map</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            None</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># create the directory in which to write the control markdown files</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>md_root</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+        <span class=n>part_id_map</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_statement_part_id_map</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=n>label_as_key</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+            <span class=n>found_alters</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>read_additional_content_from_md</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write_catalog_as_profile_markdown</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>found_alters</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write_catalog_as_component_markdown</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write_catalog_as_ssp_markdown</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write_catalog_as_catalog</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>)</span>
+
+        <span class=c1># prune any directories that have no markdown files</span>
+        <span class=n>prune_empty_dirs</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span> <span class=s1>&#39;*.md&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>read_catalog_from_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>markdown_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>is_set_parameters</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read catalog from markdown.&quot;&quot;&quot;</span>
+        <span class=n>md_catalog</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_reader</span><span class=o>.</span><span class=n>read_catalog_from_markdown</span><span class=p>(</span><span class=n>markdown_dir</span><span class=p>,</span> <span class=n>is_set_parameters</span><span class=p>)</span>
+        <span class=n>md_catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>md_catalog</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>md_catalog_interface</span><span class=o>.</span><span class=n>get_count_of_controls_in_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No controls were loaded from markdown </span><span class=si>{</span><span class=n>markdown_dir</span><span class=si>}</span><span class=s1>.  No catalog created.&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>md_catalog</span>
+
+    <span class=k>def</span> <span class=nf>read_additional_content_from_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                                        <span class=n>label_as_key</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+                                        <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read additional content from markdown.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Reading content from the markdown requires context to be initialized!&#39;</span><span class=p>)</span>
+        <span class=n>label_map</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_statement_part_id_map</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=n>label_as_key</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_reader</span><span class=o>.</span><span class=n>read_additional_content</span><span class=p>(</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>required_sections</span><span class=p>,</span>
+            <span class=n>label_map</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>sections_dict</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>to_markdown</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>merge_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge one catalog into another.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_merger</span><span class=o>.</span><span class=n>merge_catalog</span><span class=p>(</span><span class=n>catalog</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.catalog.catalog_api.CatalogAPI-functions>Functions<a href=#trestle.core.catalog.catalog_api.CatalogAPI-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_api.CatalogAPI.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>catalog</span><span class=p>,</span> <span class=n>context</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize catalog api.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>],</span> <span class=n>context</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ControlContext</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize catalog api.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>catalog</span><span class=p>:</span>
+        <span class=c1># catalog assemble initializes with no catalog but may merge into an existing one later</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;No catalog was provided in CatalogAPI init, generating a new one.&#39;</span><span class=p>)</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span> <span class=o>=</span> <span class=n>catalog</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span> <span class=o>=</span> <span class=n>CatalogWriter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_reader</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_merger</span> <span class=o>=</span> <span class=n>CatalogMerger</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_context</span> <span class=o>=</span> <span class=n>context</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_api.CatalogAPI.merge_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge_catalog</span><span class=p>(</span><span class=n>catalog</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.merge_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge one catalog into another.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>merge_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Merge one catalog into another.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_merger</span><span class=o>.</span><span class=n>merge_catalog</span><span class=p>(</span><span class=n>catalog</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_api.CatalogAPI.read_additional_content_from_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_additional_content_from_md</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.read_additional_content_from_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read additional content from markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>read_additional_content_from_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                                    <span class=n>label_as_key</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+                                    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Read additional content from markdown.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Reading content from the markdown requires context to be initialized!&#39;</span><span class=p>)</span>
+    <span class=n>label_map</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_statement_part_id_map</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=n>label_as_key</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_reader</span><span class=o>.</span><span class=n>read_additional_content</span><span class=p>(</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>required_sections</span><span class=p>,</span>
+        <span class=n>label_map</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>sections_dict</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>to_markdown</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_api.CatalogAPI.read_catalog_from_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_catalog_from_markdown</span><span class=p>(</span><span class=n>markdown_dir</span><span class=p>,</span> <span class=n>is_set_parameters</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.read_catalog_from_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read catalog from markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>read_catalog_from_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>markdown_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>is_set_parameters</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Read catalog from markdown.&quot;&quot;&quot;</span>
+    <span class=n>md_catalog</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_reader</span><span class=o>.</span><span class=n>read_catalog_from_markdown</span><span class=p>(</span><span class=n>markdown_dir</span><span class=p>,</span> <span class=n>is_set_parameters</span><span class=p>)</span>
+    <span class=n>md_catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>md_catalog</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>md_catalog_interface</span><span class=o>.</span><span class=n>get_count_of_controls_in_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No controls were loaded from markdown </span><span class=si>{</span><span class=n>markdown_dir</span><span class=si>}</span><span class=s1>.  No catalog created.&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>md_catalog</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_api.CatalogAPI.update_context class="doc doc-heading"> <code class="highlight language-python"><span class=n>update_context</span><span class=p>(</span><span class=n>context</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.update_context class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Update current context.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>update_context</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Update current context.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>context</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;ControlContext cannot be empty.&#39;</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_context</span> <span class=o>=</span> <span class=n>context</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_api.CatalogAPI.write_catalog_as_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_catalog_as_markdown</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_api.CatalogAPI.write_catalog_as_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write out the catalog controls from dict as markdown files to the specified directory.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>label_as_key</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to use label_as_key for part_id to label map</p> </div> </td> <td> <code>False</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>None</code> </td> <td> <div class=doc-md-description> <p>None</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_catalog_as_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>label_as_key</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Write out the catalog controls from dict as markdown files to the specified directory.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        label_as_key: Whether to use label_as_key for part_id to label map</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        None</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># create the directory in which to write the control markdown files</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>md_root</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+    <span class=n>part_id_map</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_statement_part_id_map</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=n>label_as_key</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+        <span class=n>found_alters</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>read_additional_content_from_md</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write_catalog_as_profile_markdown</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>found_alters</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write_catalog_as_component_markdown</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write_catalog_as_ssp_markdown</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write_catalog_as_catalog</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>)</span>
+
+    <span class=c1># prune any directories that have no markdown files</span>
+    <span class=n>prune_empty_dirs</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span> <span class=s1>&#39;*.md&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.catalog.catalog_api-functions>Functions<a href=#trestle.core.catalog.catalog_api-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/catalog/catalog_interface/index.html b/latest/reference/API/trestle/core/catalog/catalog_interface/index.html
new file mode 100644
index 000000000..a6d04bd61
--- /dev/null
+++ b/latest/reference/API/trestle/core/catalog/catalog_interface/index.html
@@ -0,0 +1,2473 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.catalog.catalog_interface module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_interface/ rel=canonical><link href=../catalog_api/ rel=prev><link href=../catalog_merger/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.catalog.catalog_interface - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.catalog.catalog_interface - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.catalog.catalog_interface module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_interface.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_interface/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.catalog.catalog_interface - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.catalog.catalog_interface module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_interface.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.catalog.catalog_interface class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26 checked> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface class=md-nav__link> <span class=md-ellipsis> catalog_interface </span> </a> <nav class=md-nav aria-label=catalog_interface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface class=md-nav__link> <span class=md-ellipsis> CatalogInterface </span> </a> <nav class=md-nav aria-label=CatalogInterface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.loose_param_dict class=md-nav__link> <span class=md-ellipsis> loose_param_dict </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle class=md-nav__link> <span class=md-ellipsis> ControlHandle </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_info class=md-nav__link> <span class=md-ellipsis> add_comp_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_set_param class=md-nav__link> <span class=md-ellipsis> add_comp_set_param </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.clear_comp_dicts class=md-nav__link> <span class=md-ellipsis> clear_comp_dicts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.clear_set_params class=md-nav__link> <span class=md-ellipsis> clear_set_params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.delete_control class=md-nav__link> <span class=md-ellipsis> delete_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.delete_withdrawn_controls class=md-nav__link> <span class=md-ellipsis> delete_withdrawn_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.find_part_with_condition class=md-nav__link> <span class=md-ellipsis> find_part_with_condition </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.find_string_in_control class=md-nav__link> <span class=md-ellipsis> find_string_in_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.generate_control_rule_info class=md-nav__link> <span class=md-ellipsis> generate_control_rule_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_catalog class=md-nav__link> <span class=md-ellipsis> get_all_controls_from_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_dict class=md-nav__link> <span class=md-ellipsis> get_all_controls_from_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_groups_from_catalog class=md-nav__link> <span class=md-ellipsis> get_all_groups_from_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog class=md-nav__link> <span class=md-ellipsis> get_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog_title class=md-nav__link> <span class=md-ellipsis> get_catalog_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_comp_info class=md-nav__link> <span class=md-ellipsis> get_comp_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control class=md-nav__link> <span class=md-ellipsis> get_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_by_param_id class=md-nav__link> <span class=md-ellipsis> get_control_by_param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_comp_set_params class=md-nav__link> <span class=md-ellipsis> get_control_comp_set_params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_file_path class=md-nav__link> <span class=md-ellipsis> get_control_file_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_id_and_status class=md-nav__link> <span class=md-ellipsis> get_control_id_and_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids class=md-nav__link> <span class=md-ellipsis> get_control_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids_from_catalog class=md-nav__link> <span class=md-ellipsis> get_control_ids_from_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_part_prose class=md-nav__link> <span class=md-ellipsis> get_control_part_prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_path class=md-nav__link> <span class=md-ellipsis> get_control_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_catalog class=md-nav__link> <span class=md-ellipsis> get_count_of_controls_in_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_dict class=md-nav__link> <span class=md-ellipsis> get_count_of_controls_in_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_dependent_control_ids class=md-nav__link> <span class=md-ellipsis> get_dependent_control_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_full_control_path class=md-nav__link> <span class=md-ellipsis> get_full_control_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_group_ids class=md-nav__link> <span class=md-ellipsis> get_group_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_group_info_by_control class=md-nav__link> <span class=md-ellipsis> get_group_info_by_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_sections class=md-nav__link> <span class=md-ellipsis> get_sections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_sorted_controls_in_group class=md-nav__link> <span class=md-ellipsis> get_sorted_controls_in_group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_label_if_exists class=md-nav__link> <span class=md-ellipsis> get_statement_label_if_exists </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_part_id_map class=md-nav__link> <span class=md-ellipsis> get_statement_part_id_map </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_parts class=md-nav__link> <span class=md-ellipsis> get_statement_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.replace_control class=md-nav__link> <span class=md-ellipsis> replace_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.update_catalog_controls class=md-nav__link> <span class=md-ellipsis> update_catalog_controls </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface class=md-nav__link> <span class=md-ellipsis> catalog_interface </span> </a> <nav class=md-nav aria-label=catalog_interface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface class=md-nav__link> <span class=md-ellipsis> CatalogInterface </span> </a> <nav class=md-nav aria-label=CatalogInterface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.loose_param_dict class=md-nav__link> <span class=md-ellipsis> loose_param_dict </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle class=md-nav__link> <span class=md-ellipsis> ControlHandle </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_info class=md-nav__link> <span class=md-ellipsis> add_comp_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_set_param class=md-nav__link> <span class=md-ellipsis> add_comp_set_param </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.clear_comp_dicts class=md-nav__link> <span class=md-ellipsis> clear_comp_dicts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.clear_set_params class=md-nav__link> <span class=md-ellipsis> clear_set_params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.delete_control class=md-nav__link> <span class=md-ellipsis> delete_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.delete_withdrawn_controls class=md-nav__link> <span class=md-ellipsis> delete_withdrawn_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.find_part_with_condition class=md-nav__link> <span class=md-ellipsis> find_part_with_condition </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.find_string_in_control class=md-nav__link> <span class=md-ellipsis> find_string_in_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.generate_control_rule_info class=md-nav__link> <span class=md-ellipsis> generate_control_rule_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_catalog class=md-nav__link> <span class=md-ellipsis> get_all_controls_from_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_dict class=md-nav__link> <span class=md-ellipsis> get_all_controls_from_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_groups_from_catalog class=md-nav__link> <span class=md-ellipsis> get_all_groups_from_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog class=md-nav__link> <span class=md-ellipsis> get_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog_title class=md-nav__link> <span class=md-ellipsis> get_catalog_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_comp_info class=md-nav__link> <span class=md-ellipsis> get_comp_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control class=md-nav__link> <span class=md-ellipsis> get_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_by_param_id class=md-nav__link> <span class=md-ellipsis> get_control_by_param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_comp_set_params class=md-nav__link> <span class=md-ellipsis> get_control_comp_set_params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_file_path class=md-nav__link> <span class=md-ellipsis> get_control_file_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_id_and_status class=md-nav__link> <span class=md-ellipsis> get_control_id_and_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids class=md-nav__link> <span class=md-ellipsis> get_control_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids_from_catalog class=md-nav__link> <span class=md-ellipsis> get_control_ids_from_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_part_prose class=md-nav__link> <span class=md-ellipsis> get_control_part_prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_path class=md-nav__link> <span class=md-ellipsis> get_control_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_catalog class=md-nav__link> <span class=md-ellipsis> get_count_of_controls_in_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_dict class=md-nav__link> <span class=md-ellipsis> get_count_of_controls_in_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_dependent_control_ids class=md-nav__link> <span class=md-ellipsis> get_dependent_control_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_full_control_path class=md-nav__link> <span class=md-ellipsis> get_full_control_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_group_ids class=md-nav__link> <span class=md-ellipsis> get_group_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_group_info_by_control class=md-nav__link> <span class=md-ellipsis> get_group_info_by_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_sections class=md-nav__link> <span class=md-ellipsis> get_sections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_sorted_controls_in_group class=md-nav__link> <span class=md-ellipsis> get_sorted_controls_in_group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_label_if_exists class=md-nav__link> <span class=md-ellipsis> get_statement_label_if_exists </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_part_id_map class=md-nav__link> <span class=md-ellipsis> get_statement_part_id_map </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_parts class=md-nav__link> <span class=md-ellipsis> get_statement_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.replace_control class=md-nav__link> <span class=md-ellipsis> replace_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.update_catalog_controls class=md-nav__link> <span class=md-ellipsis> update_catalog_controls </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_interface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.catalog.catalog_interface</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.catalog.catalog_interface class="doc doc-heading"> <code>trestle.core.catalog.catalog_interface</code> <a href=#trestle.core.catalog.catalog_interface class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Provide interface to catalog allowing queries and operations at control level.</p> <div class="doc doc-children"> <h3 id=trestle.core.catalog.catalog_interface-attributes>Attributes<a href=#trestle.core.catalog.catalog_interface-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.catalog.catalog_interface.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.catalog.catalog_interface-classes>Classes<a href=#trestle.core.catalog.catalog_interface-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.catalog.catalog_interface.CatalogInterface class="doc doc-heading"> <code>CatalogInterface</code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Interface to query and modify catalog contents.</p> <p>The catalog is contained in two separate forms: As an actual OSCAL catalog, and as a separate dict providing direct lookup of a control by id.</p> <p>The two representations should be converted as needed using provided routines: dict -&gt; cat: update_catalog_controls cat -&gt; dict: _create_control_dict</p> <p>In normal use the dict is created by the CatalogInterface constructor, changes are then made to controls in the dict, then the catalog controls are updated by pulling from the dict back into the catalog.</p> <p>This class does no direct file i/o. i/o is performed via ControlIO.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span>
+<span class=normal>654</span>
+<span class=normal>655</span>
+<span class=normal>656</span>
+<span class=normal>657</span>
+<span class=normal>658</span>
+<span class=normal>659</span>
+<span class=normal>660</span>
+<span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span>
+<span class=normal>664</span>
+<span class=normal>665</span>
+<span class=normal>666</span>
+<span class=normal>667</span>
+<span class=normal>668</span>
+<span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span>
+<span class=normal>672</span>
+<span class=normal>673</span>
+<span class=normal>674</span>
+<span class=normal>675</span>
+<span class=normal>676</span>
+<span class=normal>677</span>
+<span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span>
+<span class=normal>685</span>
+<span class=normal>686</span>
+<span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span>
+<span class=normal>700</span>
+<span class=normal>701</span>
+<span class=normal>702</span>
+<span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span>
+<span class=normal>706</span>
+<span class=normal>707</span>
+<span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span>
+<span class=normal>714</span>
+<span class=normal>715</span>
+<span class=normal>716</span>
+<span class=normal>717</span>
+<span class=normal>718</span>
+<span class=normal>719</span>
+<span class=normal>720</span>
+<span class=normal>721</span>
+<span class=normal>722</span>
+<span class=normal>723</span>
+<span class=normal>724</span>
+<span class=normal>725</span>
+<span class=normal>726</span>
+<span class=normal>727</span>
+<span class=normal>728</span>
+<span class=normal>729</span>
+<span class=normal>730</span>
+<span class=normal>731</span>
+<span class=normal>732</span>
+<span class=normal>733</span>
+<span class=normal>734</span>
+<span class=normal>735</span>
+<span class=normal>736</span>
+<span class=normal>737</span>
+<span class=normal>738</span>
+<span class=normal>739</span>
+<span class=normal>740</span>
+<span class=normal>741</span>
+<span class=normal>742</span>
+<span class=normal>743</span>
+<span class=normal>744</span>
+<span class=normal>745</span>
+<span class=normal>746</span>
+<span class=normal>747</span>
+<span class=normal>748</span>
+<span class=normal>749</span>
+<span class=normal>750</span>
+<span class=normal>751</span>
+<span class=normal>752</span>
+<span class=normal>753</span>
+<span class=normal>754</span>
+<span class=normal>755</span>
+<span class=normal>756</span>
+<span class=normal>757</span>
+<span class=normal>758</span>
+<span class=normal>759</span>
+<span class=normal>760</span>
+<span class=normal>761</span>
+<span class=normal>762</span>
+<span class=normal>763</span>
+<span class=normal>764</span>
+<span class=normal>765</span>
+<span class=normal>766</span>
+<span class=normal>767</span>
+<span class=normal>768</span>
+<span class=normal>769</span>
+<span class=normal>770</span>
+<span class=normal>771</span>
+<span class=normal>772</span>
+<span class=normal>773</span>
+<span class=normal>774</span>
+<span class=normal>775</span>
+<span class=normal>776</span>
+<span class=normal>777</span>
+<span class=normal>778</span>
+<span class=normal>779</span>
+<span class=normal>780</span>
+<span class=normal>781</span>
+<span class=normal>782</span>
+<span class=normal>783</span>
+<span class=normal>784</span>
+<span class=normal>785</span>
+<span class=normal>786</span>
+<span class=normal>787</span>
+<span class=normal>788</span>
+<span class=normal>789</span>
+<span class=normal>790</span>
+<span class=normal>791</span>
+<span class=normal>792</span>
+<span class=normal>793</span>
+<span class=normal>794</span>
+<span class=normal>795</span>
+<span class=normal>796</span>
+<span class=normal>797</span>
+<span class=normal>798</span>
+<span class=normal>799</span>
+<span class=normal>800</span>
+<span class=normal>801</span>
+<span class=normal>802</span>
+<span class=normal>803</span>
+<span class=normal>804</span>
+<span class=normal>805</span>
+<span class=normal>806</span>
+<span class=normal>807</span>
+<span class=normal>808</span>
+<span class=normal>809</span>
+<span class=normal>810</span>
+<span class=normal>811</span>
+<span class=normal>812</span>
+<span class=normal>813</span>
+<span class=normal>814</span>
+<span class=normal>815</span>
+<span class=normal>816</span>
+<span class=normal>817</span>
+<span class=normal>818</span>
+<span class=normal>819</span>
+<span class=normal>820</span>
+<span class=normal>821</span>
+<span class=normal>822</span>
+<span class=normal>823</span>
+<span class=normal>824</span>
+<span class=normal>825</span>
+<span class=normal>826</span>
+<span class=normal>827</span>
+<span class=normal>828</span>
+<span class=normal>829</span>
+<span class=normal>830</span>
+<span class=normal>831</span>
+<span class=normal>832</span>
+<span class=normal>833</span>
+<span class=normal>834</span>
+<span class=normal>835</span>
+<span class=normal>836</span>
+<span class=normal>837</span>
+<span class=normal>838</span>
+<span class=normal>839</span>
+<span class=normal>840</span>
+<span class=normal>841</span>
+<span class=normal>842</span>
+<span class=normal>843</span>
+<span class=normal>844</span>
+<span class=normal>845</span>
+<span class=normal>846</span>
+<span class=normal>847</span>
+<span class=normal>848</span>
+<span class=normal>849</span>
+<span class=normal>850</span>
+<span class=normal>851</span>
+<span class=normal>852</span>
+<span class=normal>853</span>
+<span class=normal>854</span>
+<span class=normal>855</span>
+<span class=normal>856</span>
+<span class=normal>857</span>
+<span class=normal>858</span>
+<span class=normal>859</span>
+<span class=normal>860</span>
+<span class=normal>861</span>
+<span class=normal>862</span>
+<span class=normal>863</span>
+<span class=normal>864</span>
+<span class=normal>865</span>
+<span class=normal>866</span>
+<span class=normal>867</span>
+<span class=normal>868</span>
+<span class=normal>869</span>
+<span class=normal>870</span>
+<span class=normal>871</span>
+<span class=normal>872</span>
+<span class=normal>873</span>
+<span class=normal>874</span>
+<span class=normal>875</span>
+<span class=normal>876</span>
+<span class=normal>877</span>
+<span class=normal>878</span>
+<span class=normal>879</span>
+<span class=normal>880</span>
+<span class=normal>881</span>
+<span class=normal>882</span>
+<span class=normal>883</span>
+<span class=normal>884</span>
+<span class=normal>885</span>
+<span class=normal>886</span>
+<span class=normal>887</span>
+<span class=normal>888</span>
+<span class=normal>889</span>
+<span class=normal>890</span>
+<span class=normal>891</span>
+<span class=normal>892</span>
+<span class=normal>893</span>
+<span class=normal>894</span>
+<span class=normal>895</span>
+<span class=normal>896</span>
+<span class=normal>897</span>
+<span class=normal>898</span>
+<span class=normal>899</span>
+<span class=normal>900</span>
+<span class=normal>901</span>
+<span class=normal>902</span>
+<span class=normal>903</span>
+<span class=normal>904</span>
+<span class=normal>905</span>
+<span class=normal>906</span>
+<span class=normal>907</span>
+<span class=normal>908</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogInterface</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Interface to query and modify catalog contents.</span>
+
+<span class=sd>    The catalog is contained in two separate forms:  As an actual OSCAL catalog,</span>
+<span class=sd>    and as a separate dict providing direct lookup of a control by id.</span>
+
+<span class=sd>    The two representations should be converted as needed using provided routines:</span>
+<span class=sd>    dict -&gt; cat: update_catalog_controls</span>
+<span class=sd>    cat -&gt; dict: _create_control_dict</span>
+
+<span class=sd>    In normal use the dict is created by the CatalogInterface constructor,</span>
+<span class=sd>    changes are then made to controls in the dict,</span>
+<span class=sd>    then the catalog controls are updated by pulling from the dict back into the catalog.</span>
+
+<span class=sd>    This class does no direct file i/o.  i/o is performed via ControlIO.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=nd>@dataclass</span>
+    <span class=k>class</span> <span class=nc>ControlHandle</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convenience class for handling controls as members of a group.</span>
+
+<span class=sd>        group_id: id of parent group or &#39;&#39; if not in a group</span>
+<span class=sd>        group_title: title of the group</span>
+<span class=sd>        group_class: class of the group</span>
+<span class=sd>        path: path of parent groups leading to this control - without the final control_id, or [&#39;&#39;] if in cat list</span>
+<span class=sd>        important to remember that controls may not be in a group and are directly attached to cat</span>
+<span class=sd>        control: the control itself</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+
+        <span class=n>group_id</span><span class=p>:</span> <span class=nb>str</span>
+        <span class=n>group_title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+        <span class=n>group_class</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+        <span class=n>group_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+        <span class=n>control_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+        <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the interface with the catalog.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span> <span class=o>=</span> <span class=n>catalog</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_param_control_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_generate_group_index</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_control_dict</span><span class=p>()</span> <span class=k>if</span> <span class=n>catalog</span> <span class=k>else</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>loose_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>:</span> <span class=n>param</span>
+                                                              <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>params</span><span class=p>)}</span> <span class=k>if</span> <span class=n>catalog</span> <span class=k>else</span> <span class=p>{}</span>
+        <span class=c1># map control id to CompDict</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_dicts</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>CompDict</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># map control id to dict containing set parameters by component</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_set_params</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=k>def</span> <span class=nf>add_comp_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>label</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>:</span> <span class=n>ComponentImpInfo</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add comp_info for a control.&quot;&quot;&quot;</span>
+        <span class=n>deep_set</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_dicts</span><span class=p>,</span> <span class=p>[</span><span class=n>control_id</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>label</span><span class=p>],</span> <span class=n>comp_info</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_comp_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>CompDict</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get comp_dict for this control.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_dicts</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+
+    <span class=k>def</span> <span class=nf>clear_comp_dicts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Clear the control component dicts.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_dicts</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=k>def</span> <span class=nf>add_comp_set_param</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>set_param</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add component setparam for control with overwrite.&quot;&quot;&quot;</span>
+        <span class=n>deep_append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_set_params</span><span class=p>,</span> <span class=p>[</span><span class=n>control_id</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>],</span> <span class=n>set_param</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_control_comp_set_params</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get dict of setparams list per component.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_set_params</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+
+    <span class=k>def</span> <span class=nf>clear_set_params</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Clear the control set params.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_set_params</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=k>def</span> <span class=nf>_generate_group_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate sequential group ids.&quot;&quot;&quot;</span>
+        <span class=n>group_id</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;trestle_group_</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_generate_group_index</span><span class=si>:</span><span class=s1>04d</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_generate_group_index</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Group titled &quot;</span><span class=si>{</span><span class=n>group</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&quot; has no id and has been assigned id: </span><span class=si>{</span><span class=n>group_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>group_id</span>
+
+    <span class=k>def</span> <span class=nf>_add_params_to_map</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=c1># this does not need to recurse because it is called for each control in the catalog</span>
+        <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_param_control_map</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Duplicate param id </span><span class=si>{</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> in control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> and </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_param_control_map</span><span class=p>[</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>]</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_param_control_map</span><span class=p>[</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span>
+
+    <span class=k>def</span> <span class=nf>_add_sub_controls</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control_handle</span><span class=p>:</span> <span class=n>ControlHandle</span><span class=p>,</span> <span class=n>control_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ControlHandle</span><span class=p>],</span> <span class=n>path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get all controls contained in this control and add it to the growing control dict.</span>
+
+<span class=sd>        Add all its sub-controls to the dict recursively.</span>
+<span class=sd>        The path does not change because only groups are in the path, and controls cannot contain groups.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>:</span>
+            <span class=n>group_id</span> <span class=o>=</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>group_id</span>
+            <span class=n>group_title</span> <span class=o>=</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>group_title</span>
+            <span class=n>group_class</span> <span class=o>=</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>group_class</span>
+            <span class=n>group_path</span> <span class=o>=</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>group_path</span>
+            <span class=n>control_path</span> <span class=o>=</span> <span class=n>path</span><span class=p>[:]</span>
+            <span class=n>control_path</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_handle</span><span class=o>.</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>sub_control</span> <span class=ow>in</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>:</span>
+                <span class=n>control_handle</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>ControlHandle</span><span class=p>(</span>
+                    <span class=n>group_id</span><span class=o>=</span><span class=n>group_id</span><span class=p>,</span>
+                    <span class=n>group_title</span><span class=o>=</span><span class=n>group_title</span><span class=p>,</span>
+                    <span class=n>group_class</span><span class=o>=</span><span class=n>group_class</span><span class=p>,</span>
+                    <span class=n>group_path</span><span class=o>=</span><span class=n>group_path</span><span class=p>,</span>
+                    <span class=n>control_path</span><span class=o>=</span><span class=n>control_path</span><span class=p>,</span>
+                    <span class=n>control</span><span class=o>=</span><span class=n>sub_control</span>
+                <span class=p>)</span>
+                <span class=n>control_dict</span><span class=p>[</span><span class=n>sub_control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>control_handle</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_sub_controls</span><span class=p>(</span><span class=n>control_handle</span><span class=p>,</span> <span class=n>control_dict</span><span class=p>,</span> <span class=n>control_path</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_group_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>,</span> <span class=n>control_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ControlHandle</span><span class=p>],</span> <span class=n>path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add all controls in the group recursively, including sub groups and sub controls.&quot;&quot;&quot;</span>
+        <span class=n>group</span><span class=o>.</span><span class=n>id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_generate_group_id</span><span class=p>(</span><span class=n>group</span><span class=p>)</span> <span class=k>if</span> <span class=n>group</span><span class=o>.</span><span class=n>id</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=n>group</span><span class=o>.</span><span class=n>id</span>
+        <span class=k>if</span> <span class=n>group</span><span class=o>.</span><span class=n>controls</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>group_path</span> <span class=o>=</span> <span class=n>path</span><span class=p>[:]</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>group_path</span> <span class=ow>or</span> <span class=n>group_path</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=o>!=</span> <span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                <span class=n>group_path</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>group</span><span class=o>.</span><span class=n>controls</span><span class=p>:</span>
+                <span class=n>control_handle</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>ControlHandle</span><span class=p>(</span>
+                    <span class=n>group_id</span><span class=o>=</span><span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=p>,</span>
+                    <span class=n>group_title</span><span class=o>=</span><span class=n>group</span><span class=o>.</span><span class=n>title</span><span class=p>,</span>
+                    <span class=n>group_class</span><span class=o>=</span><span class=n>group</span><span class=o>.</span><span class=n>class_</span><span class=p>,</span>
+                    <span class=n>control</span><span class=o>=</span><span class=n>control</span><span class=p>,</span>
+                    <span class=n>group_path</span><span class=o>=</span><span class=n>group_path</span><span class=p>,</span>
+                    <span class=n>control_path</span><span class=o>=</span><span class=n>group_path</span>
+                <span class=p>)</span>
+                <span class=n>control_dict</span><span class=p>[</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>control_handle</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_sub_controls</span><span class=p>(</span><span class=n>control_handle</span><span class=p>,</span> <span class=n>control_dict</span><span class=p>,</span> <span class=n>group_path</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>group</span><span class=o>.</span><span class=n>groups</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>group_path</span> <span class=o>=</span> <span class=n>path</span><span class=p>[:]</span>
+            <span class=n>group_path</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>sub_group</span> <span class=ow>in</span> <span class=n>group</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+                <span class=n>new_path</span> <span class=o>=</span> <span class=n>group_path</span><span class=p>[:]</span>
+                <span class=n>sub_group</span><span class=o>.</span><span class=n>id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_generate_group_id</span><span class=p>(</span><span class=n>sub_group</span><span class=p>)</span> <span class=k>if</span> <span class=n>sub_group</span><span class=o>.</span><span class=n>id</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=n>sub_group</span><span class=o>.</span><span class=n>id</span>
+                <span class=n>new_path</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sub_group</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_group_controls</span><span class=p>(</span><span class=n>sub_group</span><span class=p>,</span> <span class=n>control_dict</span><span class=p>,</span> <span class=n>new_path</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_create_control_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ControlHandle</span><span class=p>]:</span>
+        <span class=n>control_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>ControlHandle</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># add controls by group</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_group_controls</span><span class=p>(</span><span class=n>group</span><span class=p>,</span> <span class=n>control_dict</span><span class=p>,</span> <span class=p>[])</span>
+        <span class=c1># now add controls not in a group, if any</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>group_path</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;&#39;</span><span class=p>]</span>
+            <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>:</span>
+                <span class=n>control_handle</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>ControlHandle</span><span class=p>(</span>
+                    <span class=n>group_id</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span>
+                    <span class=n>group_title</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span>
+                    <span class=n>group_class</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_CATALOG</span><span class=p>,</span>
+                    <span class=n>control</span><span class=o>=</span><span class=n>control</span><span class=p>,</span>
+                    <span class=n>group_path</span><span class=o>=</span><span class=n>group_path</span><span class=p>,</span>
+                    <span class=n>control_path</span><span class=o>=</span><span class=n>group_path</span>
+                <span class=p>)</span>
+                <span class=n>control_dict</span><span class=p>[</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>control_handle</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_sub_controls</span><span class=p>(</span><span class=n>control_handle</span><span class=p>,</span> <span class=n>control_dict</span><span class=p>,</span> <span class=n>group_path</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>handle</span> <span class=ow>in</span> <span class=n>control_dict</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_params_to_map</span><span class=p>(</span><span class=n>handle</span><span class=o>.</span><span class=n>control</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>control_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_all_controls_in_list</span><span class=p>(</span><span class=n>controls</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>],</span> <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all controls in a list with optional recursion for sub controls.&quot;&quot;&quot;</span>
+        <span class=n>new_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>controls</span><span class=p>:</span>
+            <span class=n>new_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>recurse</span> <span class=ow>and</span> <span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>:</span>
+                <span class=n>new_list</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_all_controls_in_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>,</span> <span class=n>recurse</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>new_list</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_all_controls_in_group</span><span class=p>(</span><span class=n>group</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>,</span> <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Create a list of all controls in this group.</span>
+
+<span class=sd>        recurse specifies to recurse within controls, but groups are always recursed</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>controls</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>group</span><span class=o>.</span><span class=n>controls</span><span class=p>:</span>
+            <span class=n>controls</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_all_controls_in_list</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>controls</span><span class=p>,</span> <span class=n>recurse</span><span class=p>))</span>
+        <span class=k>for</span> <span class=n>sub_group</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>groups</span><span class=p>):</span>
+            <span class=n>controls</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_all_controls_in_group</span><span class=p>(</span><span class=n>sub_group</span><span class=p>,</span> <span class=n>recurse</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>controls</span>
+
+    <span class=k>def</span> <span class=nf>get_sorted_controls_in_group</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the list of controls in a group sorted by the control sort-id.&quot;&quot;&quot;</span>
+        <span class=n>controls</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=n>grp_id</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>grp_id</span> <span class=o>==</span> <span class=n>group_id</span><span class=p>:</span>
+                <span class=n>controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+        <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>controls</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>control</span><span class=p>:</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>))</span>
+
+    <span class=k>def</span> <span class=nf>get_dependent_control_ids</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find all child ids of this control from the dict with recursion.&quot;&quot;&quot;</span>
+        <span class=n>children</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>control</span><span class=p>:</span>
+            <span class=n>new_controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_all_controls_in_list</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>),</span> <span class=kc>True</span><span class=p>)</span>
+            <span class=n>children</span><span class=o>.</span><span class=n>extend</span><span class=p>([</span><span class=n>con</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>con</span> <span class=ow>in</span> <span class=n>new_controls</span><span class=p>])</span>
+        <span class=k>return</span> <span class=n>children</span>
+
+    <span class=k>def</span> <span class=nf>get_control_ids</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all control ids from the control dict.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>get_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get control from the control dict with this id.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=kc>None</span> <span class=k>if</span> <span class=n>control_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>control</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_control_ids_from_catalog</span><span class=p>(</span><span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get all control ids from a catalog.</span>
+
+<span class=sd>        This is intended to provide a quick list of all controls in a catalog without the expense of building the</span>
+<span class=sd>        control dict.  So, if repeated queries are made into a catalog, it is worth instantiating a CatalogInterface</span>
+<span class=sd>        and associated control dict.  Otherwise just use this to get a list of all controls.</span>
+
+<span class=sd>        This function is needed within the CatalogInterface in order to determine if new controls have been added</span>
+<span class=sd>        to the dict and need to be inserted in the actual catalog during update.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>controls</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_all_controls_in_list</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>),</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>id_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>controls</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>):</span>
+            <span class=n>controls</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_all_controls_in_group</span><span class=p>(</span><span class=n>group</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+            <span class=n>id_list</span><span class=o>.</span><span class=n>extend</span><span class=p>([</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>controls</span><span class=p>)])</span>
+        <span class=k>return</span> <span class=n>id_list</span>
+
+    <span class=k>def</span> <span class=nf>get_control_by_param_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>param_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get control from catalog that has this param id using the dict.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>param_id</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_param_control_map</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_param_control_map</span><span class=p>[</span><span class=n>param_id</span><span class=p>])</span>
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>get_control_id_and_status</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get the control id and status using the control name.</span>
+
+<span class=sd>        Returns empty string if status not found.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>control</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>control_name</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>():</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_prop</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=s1>&#39;status&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>status</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=k>def</span> <span class=nf>get_catalog_title</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the title of the catalog.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span>
+
+    <span class=k>def</span> <span class=nf>get_statement_part_id_map</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>label_as_key</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create mapping of label to part_id for top level parts in statement of all controls.&quot;&quot;&quot;</span>
+        <span class=n>id_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>):</span>
+            <span class=n>statement_part</span> <span class=o>=</span> <span class=n>get_item_from_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>statement_part</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>id_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>for</span> <span class=n>sub_part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>statement_part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                <span class=n>label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>sub_part</span><span class=p>)</span>
+                <span class=c1># skip add to map for empty label</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>label</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=n>label_as_key</span><span class=p>:</span>
+                    <span class=n>id_dict</span><span class=p>[</span><span class=n>label</span><span class=p>]</span> <span class=o>=</span> <span class=n>sub_part</span><span class=o>.</span><span class=n>id</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>id_dict</span><span class=p>[</span><span class=n>sub_part</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>label</span>
+            <span class=k>if</span> <span class=n>id_dict</span><span class=p>:</span>
+                <span class=n>id_map</span><span class=p>[</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>id_dict</span>
+        <span class=k>return</span> <span class=n>id_map</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_statement_sub_parts</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>indent</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+        <span class=n>items</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># this may be &#39;&#39; if no label</span>
+        <span class=n>label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>part</span><span class=p>)</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span>
+        <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>({</span><span class=s1>&#39;indent&#39;</span><span class=p>:</span> <span class=n>indent</span><span class=p>,</span> <span class=s1>&#39;label&#39;</span><span class=p>:</span> <span class=n>label</span><span class=p>,</span> <span class=s1>&#39;prose&#39;</span><span class=p>:</span> <span class=n>prose</span><span class=p>})</span>
+        <span class=k>for</span> <span class=n>prt</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span><span class=p>):</span>
+            <span class=n>items</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_statement_sub_parts</span><span class=p>(</span><span class=n>prt</span><span class=p>,</span> <span class=n>indent</span> <span class=o>+</span> <span class=mi>1</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>items</span>
+
+    <span class=k>def</span> <span class=nf>get_statement_parts</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get list of statement parts as dicts with indentation, label and prose.&quot;&quot;&quot;</span>
+        <span class=n>items</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+
+        <span class=c1># control may have no statement or parts</span>
+        <span class=c1># but if statement present it is first part</span>
+        <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No control found for id </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>part</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;statement&#39;</span><span class=p>:</span>
+                <span class=n>items</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_statement_sub_parts</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=mi>0</span><span class=p>))</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> has parts but first part name is </span><span class=si>{</span><span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> - not statement&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>items</span>
+
+    <span class=k>def</span> <span class=nf>get_control_part_prose</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>part_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get the prose for a named part in the control.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            control_id: id of the control</span>
+<span class=sd>            part_name: name of the part</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Single string concatenating prose from all parts and sub-parts in control with that name.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_part_prose</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part_name</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_all_controls_from_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Yield all controls from the actual catalog by group including optional sub controls.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            recurse: Whether to recurse within controls, but groups are always recursed</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            iterator of the controls in the catalog</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            This follows the actual structure of the catalog and groups</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+                <span class=n>controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_all_controls_in_group</span><span class=p>(</span><span class=n>group</span><span class=p>,</span> <span class=n>recurse</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>controls</span><span class=p>:</span>
+                    <span class=k>yield</span> <span class=n>control</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>:</span>
+            <span class=n>cat_controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_all_controls_in_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>,</span> <span class=n>recurse</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>cat_controls</span><span class=p>:</span>
+                <span class=k>yield</span> <span class=n>control</span>
+
+    <span class=k>def</span> <span class=nf>get_all_controls_from_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Yield individual controls from the dict.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=p>[</span><span class=n>handle</span><span class=o>.</span><span class=n>control</span> <span class=k>for</span> <span class=n>handle</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()]</span>
+
+    <span class=k>def</span> <span class=nf>get_count_of_controls_in_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find number of controls in the dict.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+
+    <span class=k>def</span> <span class=nf>get_count_of_controls_in_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get count of controls from the actual catalog including optional sub controls.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>len</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=n>recurse</span><span class=p>)))</span>
+
+    <span class=k>def</span> <span class=nf>get_group_ids</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all the group id&#39;s as a list of sorted strings.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>id_</span><span class=p>:</span> <span class=n>id_</span><span class=p>,</span> <span class=nb>list</span><span class=p>({</span><span class=n>control</span><span class=o>.</span><span class=n>group_id</span> <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()})))</span>
+
+    <span class=k>def</span> <span class=nf>get_all_groups_from_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Retrieve all groups in the catalog sorted by group_id.</span>
+
+<span class=sd>        This ignores controls that are direct children of the catalog.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>groups</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>my_group</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>res</span> <span class=ow>in</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_groups_from_group</span><span class=p>(</span><span class=n>my_group</span><span class=p>):</span>
+                    <span class=n>groups</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>res</span><span class=p>)</span>
+        <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>groups</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>group</span><span class=p>:</span> <span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_statement_label_if_exists</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                                      <span class=n>statement_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get statement label if available.&quot;&quot;&quot;</span>
+
+        <span class=k>def</span> <span class=nf>does_part_exists</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+            <span class=n>does_match</span> <span class=o>=</span> <span class=kc>False</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=ow>and</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span><span class=p>}</span> <span class=ow>and</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span> <span class=o>==</span> <span class=n>statement_id</span><span class=p>:</span>
+                <span class=n>does_match</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=k>return</span> <span class=n>does_match</span>
+
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>control</span><span class=p>:</span>
+            <span class=k>return</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=kc>None</span>
+        <span class=n>label</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>found_part</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                <span class=c1># Performance OSCAL assumption, ids are nested so recurse only if prefix</span>
+                <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span> <span class=ow>and</span> <span class=n>statement_id</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>):</span>
+                    <span class=n>part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>find_part_with_condition</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>does_part_exists</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>part</span><span class=p>:</span>
+                        <span class=n>label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>part</span><span class=p>)</span>
+                        <span class=n>found_part</span> <span class=o>=</span> <span class=n>part</span>
+                        <span class=k>break</span>
+
+        <span class=k>return</span> <span class=n>label</span><span class=p>,</span> <span class=n>found_part</span>
+
+    <span class=k>def</span> <span class=nf>find_part_with_condition</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>condition</span><span class=p>:</span> <span class=n>Callable</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Traverse part and find subpart that satisfies given condition.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>condition</span><span class=p>(</span><span class=n>part</span><span class=p>):</span>
+            <span class=c1># Part that satisfies the condition is found.</span>
+            <span class=k>return</span> <span class=n>part</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                    <span class=n>found_part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>find_part_with_condition</span><span class=p>(</span><span class=n>subpart</span><span class=p>,</span> <span class=n>condition</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>found_part</span><span class=p>:</span>
+                        <span class=k>return</span> <span class=n>found_part</span>
+
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>delete_withdrawn_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete all withdrawn controls from the catalog.&quot;&quot;&quot;</span>
+        <span class=n>delete_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>is_withdrawn</span><span class=p>(</span><span class=n>control</span><span class=p>):</span>
+                <span class=n>delete_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>id_</span> <span class=ow>in</span> <span class=n>delete_list</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>delete_control</span><span class=p>(</span><span class=n>id_</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_groups_from_group</span><span class=p>(</span><span class=n>group</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]:</span>
+        <span class=k>yield</span> <span class=n>group</span>
+        <span class=k>if</span> <span class=n>group</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>new_group</span> <span class=ow>in</span> <span class=n>group</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>res</span> <span class=ow>in</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_groups_from_group</span><span class=p>(</span><span class=n>new_group</span><span class=p>):</span>
+                    <span class=k>yield</span> <span class=n>res</span>
+
+    <span class=k>def</span> <span class=nf>get_group_info_by_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the group_id, title, class for this control from the dict.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=p>(</span>
+            <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>group_id</span><span class=p>,</span>
+            <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>group_title</span><span class=p>,</span>
+            <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>group_class</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_control_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the path into the markdown directory for this control based only on the groups.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>group_path</span>
+
+    <span class=k>def</span> <span class=nf>get_control_file_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the path to the control from the given root.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>control_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+        <span class=n>path</span> <span class=o>=</span> <span class=n>md_root</span>
+        <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_path</span><span class=p>(</span><span class=n>control_id</span><span class=p>):</span>
+            <span class=n>path</span> <span class=o>=</span> <span class=n>path</span> <span class=o>/</span> <span class=n>item</span>
+        <span class=k>return</span> <span class=n>path</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>.md&#39;</span>
+
+    <span class=k>def</span> <span class=nf>get_full_control_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the path to the control including groups and sub-controls.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>control_path</span>
+
+    <span class=k>def</span> <span class=nf>replace_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Replace the control in the control_dict.</span>
+
+<span class=sd>        This only replaces the parent control and not its children.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span><span class=o>.</span><span class=n>control</span> <span class=o>=</span> <span class=n>control</span>
+
+    <span class=k>def</span> <span class=nf>delete_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Delete the control from the control_dict based on id.</span>
+
+<span class=sd>        Delete all its dependent children also.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>control</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>sub_control_id</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_dependent_control_ids</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>):</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>sub_control_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>update</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Safe method to get catalog after forced update from catalog dict.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>update</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>update_catalog_controls</span><span class=p>()</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span>
+
+    <span class=k>def</span> <span class=nf>_update_all_controls_in_list</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>controls</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Given a list of controls, create fresh list pulled from the control dict.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            controls: a list of controls in the original catalog</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The new list of updated controls, possibly with some missing if they have been removed from the dict.</span>
+<span class=sd>            Children are inserted as needed into parent controls.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>new_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>controls</span><span class=p>:</span>
+            <span class=c1># first update the control itself by getting it from the dict</span>
+            <span class=n>new_control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>new_control</span><span class=p>:</span>
+                <span class=c1># this overrides any sub controls in the control itself</span>
+                <span class=c1># any added sub-controls should add to the skipped list</span>
+                <span class=n>new_control</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_update_all_controls_in_list</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>))</span>
+                <span class=n>new_control</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_control</span><span class=o>.</span><span class=n>controls</span><span class=p>)</span>
+                <span class=n>new_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_control</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>new_list</span>
+
+    <span class=k>def</span> <span class=nf>_update_all_controls_in_group</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Given a group of controls, create fresh version pulled from the control dict.&quot;&quot;&quot;</span>
+        <span class=n>group</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_update_all_controls_in_list</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>controls</span><span class=p>))</span>
+        <span class=n>group</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>controls</span><span class=p>)</span>
+        <span class=n>new_groups</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>sub_group</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>groups</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_update_all_controls_in_group</span><span class=p>(</span><span class=n>sub_group</span><span class=p>)</span>
+            <span class=n>new_groups</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sub_group</span><span class=p>)</span>
+        <span class=n>group</span><span class=o>.</span><span class=n>groups</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_groups</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_insert_control_in_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_handle</span><span class=p>:</span> <span class=n>ControlHandle</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Insert the control into the catalog based on its path.&quot;&quot;&quot;</span>
+        <span class=n>path</span> <span class=o>=</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>group_path</span>
+        <span class=n>node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span>
+        <span class=k>if</span> <span class=n>path</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>group_id</span> <span class=ow>in</span> <span class=n>path</span><span class=p>:</span>
+                <span class=n>found_group</span> <span class=o>=</span> <span class=kc>None</span>
+                <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>groups</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>group</span><span class=o>.</span><span class=n>id</span> <span class=o>==</span> <span class=n>group_id</span><span class=p>:</span>
+                        <span class=n>found_group</span> <span class=o>=</span> <span class=n>group</span>
+                        <span class=k>break</span>
+                <span class=k>if</span> <span class=n>found_group</span><span class=p>:</span>
+                    <span class=n>node</span> <span class=o>=</span> <span class=n>found_group</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No controls found in catalog for group </span><span class=si>{</span><span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>node</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>group_title</span>
+            <span class=n>node</span><span class=o>.</span><span class=n>class_</span> <span class=o>=</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>group_class</span>
+        <span class=n>node</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>delete_item_from_list</span><span class=p>(</span>
+            <span class=n>as_list</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>controls</span><span class=p>),</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>control</span><span class=p>:</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span>
+        <span class=p>)</span>
+        <span class=n>node</span><span class=o>.</span><span class=n>controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_handle</span><span class=o>.</span><span class=n>control</span><span class=p>)</span>
+        <span class=n>node</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=nb>sorted</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>controls</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>control</span><span class=p>:</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>)))</span>
+
+    <span class=k>def</span> <span class=nf>update_catalog_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Update the actual catalog by pulling fresh controls from the dict.</span>
+
+<span class=sd>        During assembly, controls may be added, but not children of controls.</span>
+<span class=sd>        New groups may not be added.</span>
+<span class=sd>        A control containing controls cannot be added.  Controls containing controls are only available if</span>
+<span class=sd>        the parent catalog was loaded from json.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># first go through the catalog and pull existing controls from the dict</span>
+        <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_update_all_controls_in_group</span><span class=p>(</span><span class=n>group</span><span class=p>)</span>
+
+        <span class=n>new_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>):</span>
+            <span class=n>new_control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=n>new_control</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_update_all_controls_in_list</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>))</span>
+            <span class=n>new_control</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_control</span><span class=o>.</span><span class=n>controls</span><span class=p>)</span>
+            <span class=n>new_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_control</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_list</span><span class=p>)</span>
+
+        <span class=c1># now add any new controls that are discovered in the dict</span>
+        <span class=n>ids_in_catalog</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>get_control_ids_from_catalog</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>control_handle</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>ids_in_catalog</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_insert_control_in_catalog</span><span class=p>(</span><span class=n>control_handle</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>loose_param_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+
+    <span class=k>def</span> <span class=nf>_find_string_in_part</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>seek_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+        <span class=n>hits</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>and</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=n>seek_str</span><span class=p>)</span> <span class=o>&gt;=</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>hits</span><span class=o>.</span><span class=n>append</span><span class=p>((</span><span class=n>control_id</span><span class=p>,</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>sub_part</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>hits</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_find_string_in_part</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>sub_part</span><span class=p>,</span> <span class=n>seek_str</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>hits</span>
+
+    <span class=k>def</span> <span class=nf>find_string_in_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>seek_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find all instances of this string in prose of control.&quot;&quot;&quot;</span>
+        <span class=n>hits</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>hits</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_find_string_in_part</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>part</span><span class=p>,</span> <span class=n>seek_str</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>hits</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_full_profile_param_dict</span><span class=p>(</span><span class=n>profile</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the full mapping of param_id to modified value for this profiles set_params.&quot;&quot;&quot;</span>
+        <span class=n>set_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>if</span> <span class=n>profile</span> <span class=ow>and</span> <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                <span class=n>param</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>setparam_to_param</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=n>set_param</span><span class=p>)</span>
+                <span class=n>set_param_dict</span><span class=p>[</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>param</span>
+        <span class=k>return</span> <span class=n>set_param_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_profile_param_dict</span><span class=p>(</span>
+        <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>profile_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span> <span class=n>values_only</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get the dict of params for this control including possible overrides made by the profile modifications.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            control: The control being queried</span>
+<span class=sd>            profile_param_dict: The full dict of params and modified values made by the profile</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            mapping of param ids to their final parameter states after possible modify by the profile setparameters</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># get the mapping of param_id&#39;s to params for this control, excluding those with no value set</span>
+        <span class=n>param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>values_only</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>profile_param_dict</span><span class=p>:</span>
+                <span class=n>param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>profile_param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>param_dict</span>
+
+    <span class=k>def</span> <span class=nf>_get_full_param_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]:</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># build the full mapping of params to values from the catalog interface</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=n>param_dict</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>param_dict</span>
+
+    <span class=k>def</span> <span class=nf>_change_prose_with_param_values</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>param_format</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Go through all controls and change prose based on param values.&quot;&quot;&quot;</span>
+        <span class=n>param_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_full_param_dict</span><span class=p>()</span>
+        <span class=c1># insert param values into prose of all controls</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>replace_control_prose</span><span class=p>(</span>
+                <span class=n>control</span><span class=p>,</span>
+                <span class=n>param_dict</span><span class=p>,</span>
+                <span class=n>param_format</span><span class=p>,</span>
+                <span class=n>param_rep</span><span class=p>,</span>
+                <span class=n>show_value_warnings</span><span class=p>,</span>
+                <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                <span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_display_name_and_ns</span><span class=p>(</span><span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]]:</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>:</span>
+                <span class=n>ns</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>ns</span><span class=p>)</span> <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>ns</span> <span class=k>else</span> <span class=kc>None</span>
+                <span class=k>return</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=n>ns</span>
+        <span class=k>return</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_param_value_origin_and_ns</span><span class=p>(</span><span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]]:</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>:</span>
+                <span class=n>ns</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>ns</span><span class=p>)</span> <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>ns</span> <span class=k>else</span> <span class=kc>None</span>
+                <span class=k>return</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=n>ns</span>
+        <span class=k>return</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_prune_controls</span><span class=p>(</span><span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>written_controls</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Search directory and remove any controls that were not written out.&quot;&quot;&quot;</span>
+        <span class=n>deleted_controls</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>control_file</span> <span class=ow>in</span> <span class=n>md_path</span><span class=o>.</span><span class=n>rglob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>control_file</span><span class=o>.</span><span class=n>stem</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>written_controls</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Existing control markdown </span><span class=si>{</span><span class=n>control_file</span><span class=si>}</span><span class=s1> deleted since it was not written out during generate&#39;</span>
+                <span class=p>)</span>  <span class=c1># noqa E501</span>
+                <span class=n>control_file</span><span class=o>.</span><span class=n>unlink</span><span class=p>()</span>
+                <span class=n>deleted_controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_file</span><span class=o>.</span><span class=n>stem</span><span class=p>)</span>
+        <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>deleted_controls</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_extend_rules_param_list</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>param_id_rule_name_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Go through all set_params and put in rules param list if name matches.&quot;&quot;&quot;</span>
+        <span class=n>control_comp_set_params</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>rules_set_params</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>all_set_params</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_comp_set_params</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>param_list</span> <span class=ow>in</span> <span class=n>all_set_params</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>param_list</span><span class=p>:</span>
+                <span class=n>param_vals</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>values</span><span class=p>))</span>
+                <span class=n>rule_name</span> <span class=o>=</span> <span class=n>deep_get</span><span class=p>(</span><span class=n>param_id_rule_name_map</span><span class=p>,</span> <span class=p>[</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>param</span><span class=o>.</span><span class=n>param_id</span><span class=p>],</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>rule_name</span><span class=p>:</span>
+                    <span class=n>param_dict</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>param</span><span class=o>.</span><span class=n>param_id</span><span class=p>}</span>
+                    <span class=k>if</span> <span class=n>param_vals</span><span class=p>:</span>
+                        <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;values&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_vals</span>
+                    <span class=n>deep_append</span><span class=p>(</span><span class=n>rules_set_params</span><span class=p>,</span> <span class=p>[</span><span class=n>comp_name</span><span class=p>],</span> <span class=n>param_dict</span><span class=p>)</span>
+        <span class=n>set_or_pop</span><span class=p>(</span><span class=n>header</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>,</span> <span class=n>rules_set_params</span><span class=p>)</span>
+        <span class=n>set_or_pop</span><span class=p>(</span><span class=n>header</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>,</span> <span class=n>control_comp_set_params</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_control_memory_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>CompDict</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build the rule info for the control into the header.&quot;&quot;&quot;</span>
+        <span class=n>header</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>rule_names_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>comp_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_comp_info</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=c1># find the rule names that are needed by the control</span>
+        <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>comp_info</span> <span class=ow>in</span> <span class=n>value</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+                <span class=n>rule_names_list</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>comp_info</span><span class=o>.</span><span class=n>rules</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>rule_names_list</span><span class=p>:</span>
+            <span class=n>header_rules_dict</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=n>rule_ids</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=n>param_id_rule_name_map</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=n>rule_id_rule_name_map</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=c1># only include rules needed by control in the header</span>
+            <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>rules_dict</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>for</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>rule_dict</span> <span class=ow>in</span> <span class=n>rules_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>rule_dict</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=ow>in</span> <span class=n>rule_names_list</span><span class=p>:</span>
+                        <span class=n>deep_append</span><span class=p>(</span><span class=n>rule_ids</span><span class=p>,</span> <span class=p>[</span><span class=n>comp_name</span><span class=p>],</span> <span class=n>rule_id</span><span class=p>)</span>
+                        <span class=n>deep_append</span><span class=p>(</span><span class=n>header_rules_dict</span><span class=p>,</span> <span class=p>[</span><span class=n>comp_name</span><span class=p>],</span> <span class=n>rule_dict</span><span class=p>)</span>
+                        <span class=n>deep_set</span><span class=p>(</span><span class=n>rule_id_rule_name_map</span><span class=p>,</span> <span class=p>[</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>],</span> <span class=n>rule_dict</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>])</span>
+            <span class=n>set_or_pop</span><span class=p>(</span><span class=n>header</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_TAG</span><span class=p>,</span> <span class=n>header_rules_dict</span><span class=p>)</span>
+            <span class=n>rules_params</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=n>rules_param_names</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>rules_params_dict</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>)</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>for</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>rules_parameters</span> <span class=ow>in</span> <span class=n>rules_params_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>rule_id</span> <span class=ow>in</span> <span class=n>rule_ids</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=p>[]):</span>
+                        <span class=k>for</span> <span class=n>rule_parameter</span> <span class=ow>in</span> <span class=n>rules_parameters</span><span class=p>:</span>
+                            <span class=n>param_name</span> <span class=o>=</span> <span class=n>rule_parameter</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span>
+                            <span class=n>rules_param_names</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>param_name</span><span class=p>)</span>
+                            <span class=n>rule_parameter</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>HEADER_RULE_ID</span><span class=p>]</span> <span class=o>=</span> <span class=n>rule_id_rule_name_map</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>rule_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                            <span class=n>deep_append</span><span class=p>(</span><span class=n>rules_params</span><span class=p>,</span> <span class=p>[</span><span class=n>comp_name</span><span class=p>],</span> <span class=n>rule_parameter</span><span class=p>)</span>
+                            <span class=n>deep_set</span><span class=p>(</span>
+                                <span class=n>param_id_rule_name_map</span><span class=p>,</span> <span class=p>[</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>rule_parameter</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]],</span>
+                                <span class=n>rule_id_rule_name_map</span><span class=p>[</span><span class=n>comp_name</span><span class=p>][</span><span class=n>rule_id</span><span class=p>]</span>
+                            <span class=p>)</span>
+            <span class=n>set_or_pop</span><span class=p>(</span><span class=n>header</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>RULES_PARAMS_TAG</span><span class=p>,</span> <span class=n>rules_params</span><span class=p>)</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>_extend_rules_param_list</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>header</span><span class=p>,</span> <span class=n>param_id_rule_name_map</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>header</span><span class=p>,</span> <span class=n>comp_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_group_ids_and_dirs</span><span class=p>(</span><span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Create a sorted map of group id to group dir that is ordered by group id.</span>
+
+<span class=sd>        This includes &#39;&#39; as the root group id.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># manually insert the top dir as group &#39;&#39;</span>
+        <span class=n>id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;&#39;</span><span class=p>:</span> <span class=n>md_path</span><span class=p>}</span>
+        <span class=k>for</span> <span class=n>gdir</span> <span class=ow>in</span> <span class=n>md_path</span><span class=o>.</span><span class=n>rglob</span><span class=p>(</span><span class=s1>&#39;*&#39;</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>gdir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=n>dir_name</span> <span class=o>=</span> <span class=n>gdir</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+                <span class=n>id_map</span><span class=p>[</span><span class=n>dir_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>gdir</span>
+        <span class=c1># rebuild the dict by inserting items in manner sorted by key</span>
+        <span class=n>sorted_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>id_map</span><span class=p>):</span>
+            <span class=n>sorted_id_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>id_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>sorted_id_map</span>
+
+    <span class=k>def</span> <span class=nf>get_sections</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the available sections by a full index of all controls.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>list</span><span class=p>(</span>
+            <span class=p>{</span>
+                <span class=n>part</span><span class=o>.</span><span class=n>name</span>
+                <span class=k>for</span> <span class=n>control_handle</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()</span>
+                <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_handle</span><span class=o>.</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span>
+            <span class=p>}</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_find_control_in_group</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ControlHandle</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Find a representative control for this group and its control handle.</span>
+
+<span class=sd>        This is a simple way to get group info (title etc.) given only group id.</span>
+<span class=sd>        It is not intended for high performance loops.  Use only as needed.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>control_handle</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>group_id</span> <span class=o>==</span> <span class=n>group_id</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>control_handle</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No controls found for group </span><span class=si>{</span><span class=n>group_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_control_imp_comp_info</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>comp_rules_props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add component info to the impreqs of the control implementation based on applied rules.&quot;&quot;&quot;</span>
+        <span class=n>control_imp_rules_dict</span><span class=p>,</span> <span class=n>control_imp_rules_params_dict</span><span class=p>,</span> <span class=n>ci_rules_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span><span class=p>)</span>  <span class=c1># noqa E501</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>control_imp_rules_dict</span><span class=p>)</span>
+        <span class=n>comp_rules_params_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>comp_rules_params_dict</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>control_imp_rules_params_dict</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>comp_rules_params_dict</span>
+        <span class=n>ci_set_params</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_set_params_from_item</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span><span class=p>)</span>
+        <span class=n>catalog_control_ids</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_ids</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>catalog_control_ids</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Component </span><span class=si>{</span><span class=n>context</span><span class=o>.</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> references control </span><span class=si>{</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1> not in profile.&#39;</span>
+                <span class=p>)</span>
+            <span class=n>control_part_id_map</span> <span class=o>=</span> <span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+            <span class=c1># find if any rules apply to this control, including in statements</span>
+            <span class=n>control_rules</span><span class=p>,</span> <span class=n>statement_rules</span><span class=p>,</span> <span class=n>ir_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_imp_req</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+            <span class=n>rule_props</span> <span class=o>=</span> <span class=n>comp_rules_props</span><span class=p>[:]</span>
+            <span class=n>rule_props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ci_rules_props</span><span class=p>)</span>
+            <span class=n>rule_props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ir_props</span><span class=p>)</span>
+            <span class=n>rule_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>rule_props</span><span class=p>,</span> <span class=n>remove_imp_status</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control_rules</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+                <span class=n>final_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>cull_props_by_rules</span><span class=p>(</span><span class=n>rule_props</span><span class=p>,</span> <span class=n>control_rules</span><span class=p>)</span>
+                <span class=n>comp_info</span> <span class=o>=</span> <span class=n>ComponentImpInfo</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>description</span><span class=p>,</span> <span class=n>control_rules</span><span class=p>,</span> <span class=n>final_props</span><span class=p>,</span> <span class=n>status</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>add_comp_info</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>)</span>
+            <span class=n>set_params</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>ci_set_params</span><span class=p>)</span>
+            <span class=n>set_params</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_set_params_from_item</span><span class=p>(</span><span class=n>imp_req</span><span class=p>))</span>
+            <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>set_params</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+                <span class=c1># add to control_comp_set_params dict</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>add_comp_set_param</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>set_param</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=n>rule_list</span><span class=p>,</span> <span class=n>stat_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>rule_list</span><span class=p>:</span>
+                    <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>control_part_id_map</span><span class=p>:</span>
+                        <span class=n>label</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;No statement label found for statement id </span><span class=si>{</span><span class=n>label</span><span class=si>}</span><span class=s1>.  Defaulting to </span><span class=si>{</span><span class=n>label</span><span class=si>}</span><span class=s1>.&#39;</span>  <span class=c1># noqa E501</span>
+                        <span class=p>)</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>label</span> <span class=o>=</span> <span class=n>control_part_id_map</span><span class=p>[</span><span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span><span class=p>]</span>
+                    <span class=n>all_props</span> <span class=o>=</span> <span class=n>rule_props</span><span class=p>[:]</span>
+                    <span class=n>all_props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>stat_props</span><span class=p>)</span>
+                    <span class=n>final_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>cull_props_by_rules</span><span class=p>(</span><span class=n>all_props</span><span class=p>,</span> <span class=n>rule_list</span><span class=p>)</span>
+                    <span class=n>comp_info</span> <span class=o>=</span> <span class=n>ComponentImpInfo</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>description</span><span class=p>,</span> <span class=n>rule_list</span><span class=p>,</span> <span class=n>final_props</span><span class=p>,</span> <span class=n>status</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>add_comp_info</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>generate_control_rule_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Generate rule info for controls directly from the components.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            part_id_map: Mapping of label to part in the control</span>
+<span class=sd>            context: Control context for the current operation</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Returns nothing but places the rules_dict and rules_params_dict in the context for each component</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>comps_uuids</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>comp_def_name</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_def_name_list</span><span class=p>:</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>comp_def</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_model_for_class</span><span class=p>(</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>comp_def_name</span><span class=p>,</span>
+                <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span>
+            <span class=p>)</span>
+            <span class=n>component_uuids</span> <span class=o>=</span> <span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>uuid</span> <span class=k>for</span> <span class=n>comp</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_def</span><span class=o>.</span><span class=n>components</span><span class=p>]</span>
+            <span class=n>comps_uuids</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>component_uuids</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>comp_def</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>component</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span>
+                <span class=c1># get top level rule info applying to all controls from the component props</span>
+                <span class=n>comp_rules_dict</span><span class=p>,</span> <span class=n>comp_rules_params_dict</span><span class=p>,</span> <span class=n>comp_rules_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>component</span><span class=p>)</span>  <span class=c1># noqa E501</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>comp_rules_dict</span>
+                <span class=n>deep_update</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>,</span> <span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>],</span> <span class=n>comp_rules_params_dict</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>control_imp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>):</span>
+                    <span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span> <span class=o>=</span> <span class=n>control_imp</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_imp_comp_info</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>comp_rules_props</span><span class=p>)</span>
+                <span class=c1># add the rule_id to the param_dict</span>
+                <span class=k>for</span> <span class=n>param_comp_name</span><span class=p>,</span> <span class=n>rule_param_dict</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>for</span> <span class=n>rule_tag</span><span class=p>,</span> <span class=n>params_list</span> <span class=ow>in</span> <span class=n>rule_param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                        <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>params_list</span><span class=p>:</span>
+                            <span class=n>rule_dict</span> <span class=o>=</span> <span class=n>deep_get</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>,</span> <span class=p>[</span><span class=n>param_comp_name</span><span class=p>,</span> <span class=n>rule_tag</span><span class=p>],</span> <span class=p>{})</span>
+                            <span class=n>param</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>HEADER_RULE_ID</span><span class=p>]</span> <span class=o>=</span> <span class=n>rule_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>NAME</span><span class=p>,</span> <span class=s1>&#39;unknown_rule&#39;</span><span class=p>)</span>
+        <span class=c1># determine if there are duplicated uuids and throw an exception</span>
+        <span class=n>dup_comp_uuids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>({</span><span class=n>comp_uuid</span> <span class=k>for</span> <span class=n>comp_uuid</span> <span class=ow>in</span> <span class=n>comps_uuids</span> <span class=k>if</span> <span class=n>comps_uuids</span><span class=o>.</span><span class=n>count</span><span class=p>(</span><span class=n>comp_uuid</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>})</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>dup_comp_uuids</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=c1># throw an exception if there are repeated component uuids</span>
+            <span class=k>for</span> <span class=n>comp_uuid</span> <span class=ow>in</span> <span class=n>dup_comp_uuids</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Component uuid </span><span class=si>{</span><span class=n>comp_uuid</span><span class=si>}</span><span class=s1> is duplicated&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Component uuids cannot be duplicated between different component definitions&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.catalog.catalog_interface.CatalogInterface-attributes>Attributes<a href=#trestle.core.catalog.catalog_interface.CatalogInterface-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.loose_param_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>loose_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>:</span> <span class=n>paramfor</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>params</span><span class=p>)}</span> <span class=k>if</span> <span class=n>catalog</span> <span class=k>else</span> <span class=p>{}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.loose_param_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.catalog.catalog_interface.CatalogInterface-classes>Classes<a href=#trestle.core.catalog.catalog_interface.CatalogInterface-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle class="doc doc-heading"> <code>ControlHandle</code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convenience class for handling controls as members of a group.</p> <p>group_id: id of parent group or '' if not in a group group_title: title of the group group_class: class of the group path: path of parent groups leading to this control - without the final control_id, or [''] if in cat list important to remember that controls may not be in a group and are directly attached to cat control: the control itself</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@dataclass</span>
+<span class=k>class</span> <span class=nc>ControlHandle</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convenience class for handling controls as members of a group.</span>
+
+<span class=sd>    group_id: id of parent group or &#39;&#39; if not in a group</span>
+<span class=sd>    group_title: title of the group</span>
+<span class=sd>    group_class: class of the group</span>
+<span class=sd>    path: path of parent groups leading to this control - without the final control_id, or [&#39;&#39;] if in cat list</span>
+<span class=sd>    important to remember that controls may not be in a group and are directly attached to cat</span>
+<span class=sd>    control: the control itself</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>group_id</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=n>group_title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=n>group_class</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=n>group_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=n>control_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle-attributes>Attributes<a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.control class="doc doc-heading"> <code class="highlight language-python"><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.control class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.control_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.control_path class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.group_class class="doc doc-heading"> <code class="highlight language-python"><span class=n>group_class</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.group_class class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.group_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>group_id</span><span class=p>:</span> <span class=nb>str</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.group_id class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.group_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>group_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.group_path class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.group_title class="doc doc-heading"> <code class="highlight language-python"><span class=n>group_title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.group_title class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <h7 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle-functions>Functions<a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle-functions class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-function"> <h8 id=trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>group_id</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>group_class</span><span class=p>,</span> <span class=n>group_path</span><span class=p>,</span> <span class=n>control_path</span><span class=p>,</span> <span class=n>control</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle.__init__ class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h5 id=trestle.core.catalog.catalog_interface.CatalogInterface-functions>Functions<a href=#trestle.core.catalog.catalog_interface.CatalogInterface-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the interface with the catalog.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the interface with the catalog.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span> <span class=o>=</span> <span class=n>catalog</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_param_control_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_generate_group_index</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_control_dict</span><span class=p>()</span> <span class=k>if</span> <span class=n>catalog</span> <span class=k>else</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>loose_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>:</span> <span class=n>param</span>
+                                                          <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>params</span><span class=p>)}</span> <span class=k>if</span> <span class=n>catalog</span> <span class=k>else</span> <span class=p>{}</span>
+    <span class=c1># map control id to CompDict</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_dicts</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>CompDict</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=c1># map control id to dict containing set parameters by component</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_set_params</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_comp_info</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add comp_info for a control.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_comp_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>label</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>:</span> <span class=n>ComponentImpInfo</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add comp_info for a control.&quot;&quot;&quot;</span>
+    <span class=n>deep_set</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_dicts</span><span class=p>,</span> <span class=p>[</span><span class=n>control_id</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>label</span><span class=p>],</span> <span class=n>comp_info</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_set_param class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_comp_set_param</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>set_param</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_set_param class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add component setparam for control with overwrite.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_comp_set_param</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>set_param</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add component setparam for control with overwrite.&quot;&quot;&quot;</span>
+    <span class=n>deep_append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_set_params</span><span class=p>,</span> <span class=p>[</span><span class=n>control_id</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>],</span> <span class=n>set_param</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.clear_comp_dicts class="doc doc-heading"> <code class="highlight language-python"><span class=n>clear_comp_dicts</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.clear_comp_dicts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Clear the control component dicts.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>clear_comp_dicts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Clear the control component dicts.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_dicts</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.clear_set_params class="doc doc-heading"> <code class="highlight language-python"><span class=n>clear_set_params</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.clear_set_params class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Clear the control set params.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>clear_set_params</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Clear the control set params.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_set_params</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.delete_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>delete_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.delete_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Delete the control from the control_dict based on id.</p> <p>Delete all its dependent children also.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>delete_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Delete the control from the control_dict based on id.</span>
+
+<span class=sd>    Delete all its dependent children also.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>control</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>sub_control_id</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_dependent_control_ids</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>sub_control_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.delete_withdrawn_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>delete_withdrawn_controls</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.delete_withdrawn_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Delete all withdrawn controls from the catalog.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>delete_withdrawn_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Delete all withdrawn controls from the catalog.&quot;&quot;&quot;</span>
+    <span class=n>delete_list</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>is_withdrawn</span><span class=p>(</span><span class=n>control</span><span class=p>):</span>
+            <span class=n>delete_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>id_</span> <span class=ow>in</span> <span class=n>delete_list</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>delete_control</span><span class=p>(</span><span class=n>id_</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.find_part_with_condition class="doc doc-heading"> <code class="highlight language-python"><span class=n>find_part_with_condition</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>condition</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.find_part_with_condition class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Traverse part and find subpart that satisfies given condition.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>find_part_with_condition</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>condition</span><span class=p>:</span> <span class=n>Callable</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Traverse part and find subpart that satisfies given condition.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>condition</span><span class=p>(</span><span class=n>part</span><span class=p>):</span>
+        <span class=c1># Part that satisfies the condition is found.</span>
+        <span class=k>return</span> <span class=n>part</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>found_part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>find_part_with_condition</span><span class=p>(</span><span class=n>subpart</span><span class=p>,</span> <span class=n>condition</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>found_part</span><span class=p>:</span>
+                    <span class=k>return</span> <span class=n>found_part</span>
+
+    <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.find_string_in_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>find_string_in_control</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>seek_str</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.find_string_in_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find all instances of this string in prose of control.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>find_string_in_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>seek_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find all instances of this string in prose of control.&quot;&quot;&quot;</span>
+    <span class=n>hits</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>hits</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_find_string_in_part</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>part</span><span class=p>,</span> <span class=n>seek_str</span><span class=p>))</span>
+    <span class=k>return</span> <span class=n>hits</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.generate_control_rule_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate_control_rule_info</span><span class=p>(</span><span class=n>part_id_map</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.generate_control_rule_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate rule info for controls directly from the components.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>part_id_map</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, <span title=typing.Dict>Dict</span>[str, str]]</code> </td> <td> <div class=doc-md-description> <p>Mapping of label to part in the control</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>context</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_context.ControlContext href=../../control_context/#trestle.core.control_context.ControlContext>ControlContext</a></code> </td> <td> <div class=doc-md-description> <p>Control context for the current operation</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>None</code> </td> <td> <div class=doc-md-description> <p>Returns nothing but places the rules_dict and rules_params_dict in the context for each component</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>864</span>
+<span class=normal>865</span>
+<span class=normal>866</span>
+<span class=normal>867</span>
+<span class=normal>868</span>
+<span class=normal>869</span>
+<span class=normal>870</span>
+<span class=normal>871</span>
+<span class=normal>872</span>
+<span class=normal>873</span>
+<span class=normal>874</span>
+<span class=normal>875</span>
+<span class=normal>876</span>
+<span class=normal>877</span>
+<span class=normal>878</span>
+<span class=normal>879</span>
+<span class=normal>880</span>
+<span class=normal>881</span>
+<span class=normal>882</span>
+<span class=normal>883</span>
+<span class=normal>884</span>
+<span class=normal>885</span>
+<span class=normal>886</span>
+<span class=normal>887</span>
+<span class=normal>888</span>
+<span class=normal>889</span>
+<span class=normal>890</span>
+<span class=normal>891</span>
+<span class=normal>892</span>
+<span class=normal>893</span>
+<span class=normal>894</span>
+<span class=normal>895</span>
+<span class=normal>896</span>
+<span class=normal>897</span>
+<span class=normal>898</span>
+<span class=normal>899</span>
+<span class=normal>900</span>
+<span class=normal>901</span>
+<span class=normal>902</span>
+<span class=normal>903</span>
+<span class=normal>904</span>
+<span class=normal>905</span>
+<span class=normal>906</span>
+<span class=normal>907</span>
+<span class=normal>908</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>generate_control_rule_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Generate rule info for controls directly from the components.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        part_id_map: Mapping of label to part in the control</span>
+<span class=sd>        context: Control context for the current operation</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Returns nothing but places the rules_dict and rules_params_dict in the context for each component</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>comps_uuids</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>comp_def_name</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_def_name_list</span><span class=p>:</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>comp_def</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_model_for_class</span><span class=p>(</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>comp_def_name</span><span class=p>,</span>
+            <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span>
+        <span class=p>)</span>
+        <span class=n>component_uuids</span> <span class=o>=</span> <span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>uuid</span> <span class=k>for</span> <span class=n>comp</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_def</span><span class=o>.</span><span class=n>components</span><span class=p>]</span>
+        <span class=n>comps_uuids</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>component_uuids</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>comp_def</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>component</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span>
+            <span class=c1># get top level rule info applying to all controls from the component props</span>
+            <span class=n>comp_rules_dict</span><span class=p>,</span> <span class=n>comp_rules_params_dict</span><span class=p>,</span> <span class=n>comp_rules_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>component</span><span class=p>)</span>  <span class=c1># noqa E501</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>comp_rules_dict</span>
+            <span class=n>deep_update</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>,</span> <span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>],</span> <span class=n>comp_rules_params_dict</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>control_imp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>):</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span> <span class=o>=</span> <span class=n>control_imp</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_imp_comp_info</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>comp_rules_props</span><span class=p>)</span>
+            <span class=c1># add the rule_id to the param_dict</span>
+            <span class=k>for</span> <span class=n>param_comp_name</span><span class=p>,</span> <span class=n>rule_param_dict</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>for</span> <span class=n>rule_tag</span><span class=p>,</span> <span class=n>params_list</span> <span class=ow>in</span> <span class=n>rule_param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>params_list</span><span class=p>:</span>
+                        <span class=n>rule_dict</span> <span class=o>=</span> <span class=n>deep_get</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>,</span> <span class=p>[</span><span class=n>param_comp_name</span><span class=p>,</span> <span class=n>rule_tag</span><span class=p>],</span> <span class=p>{})</span>
+                        <span class=n>param</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>HEADER_RULE_ID</span><span class=p>]</span> <span class=o>=</span> <span class=n>rule_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>NAME</span><span class=p>,</span> <span class=s1>&#39;unknown_rule&#39;</span><span class=p>)</span>
+    <span class=c1># determine if there are duplicated uuids and throw an exception</span>
+    <span class=n>dup_comp_uuids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>({</span><span class=n>comp_uuid</span> <span class=k>for</span> <span class=n>comp_uuid</span> <span class=ow>in</span> <span class=n>comps_uuids</span> <span class=k>if</span> <span class=n>comps_uuids</span><span class=o>.</span><span class=n>count</span><span class=p>(</span><span class=n>comp_uuid</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>})</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>dup_comp_uuids</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=c1># throw an exception if there are repeated component uuids</span>
+        <span class=k>for</span> <span class=n>comp_uuid</span> <span class=ow>in</span> <span class=n>dup_comp_uuids</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Component uuid </span><span class=si>{</span><span class=n>comp_uuid</span><span class=si>}</span><span class=s1> is duplicated&#39;</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Component uuids cannot be duplicated between different component definitions&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=n>recurse</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Yield all controls from the actual catalog by group including optional sub controls.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>recurse</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to recurse within controls, but groups are always recursed</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Iterator>Iterator</span>[<a class="autorefs autorefs-internal" title=trestle.oscal.catalog.Control href=../../../oscal/catalog/#trestle.oscal.catalog.Control>Control</a>]</code> </td> <td> <div class=doc-md-description> <p>iterator of the controls in the catalog</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>This follows the actual structure of the catalog and groups</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_all_controls_from_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Yield all controls from the actual catalog by group including optional sub controls.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        recurse: Whether to recurse within controls, but groups are always recursed</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        iterator of the controls in the catalog</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        This follows the actual structure of the catalog and groups</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+            <span class=n>controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_all_controls_in_group</span><span class=p>(</span><span class=n>group</span><span class=p>,</span> <span class=n>recurse</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>controls</span><span class=p>:</span>
+                <span class=k>yield</span> <span class=n>control</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>:</span>
+        <span class=n>cat_controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_all_controls_in_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>,</span> <span class=n>recurse</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>cat_controls</span><span class=p>:</span>
+            <span class=k>yield</span> <span class=n>control</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all_controls_from_dict</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Yield individual controls from the dict.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_all_controls_from_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Yield individual controls from the dict.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=p>[</span><span class=n>handle</span><span class=o>.</span><span class=n>control</span> <span class=k>for</span> <span class=n>handle</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_all_groups_from_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all_groups_from_catalog</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_groups_from_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Retrieve all groups in the catalog sorted by group_id.</p> <p>This ignores controls that are direct children of the catalog.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_all_groups_from_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Retrieve all groups in the catalog sorted by group_id.</span>
+
+<span class=sd>    This ignores controls that are direct children of the catalog.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>groups</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>my_group</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>res</span> <span class=ow>in</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_groups_from_group</span><span class=p>(</span><span class=n>my_group</span><span class=p>):</span>
+                <span class=n>groups</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>res</span><span class=p>)</span>
+    <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>groups</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>group</span><span class=p>:</span> <span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_catalog</span><span class=p>(</span><span class=n>update</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Safe method to get catalog after forced update from catalog dict.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>update</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Safe method to get catalog after forced update from catalog dict.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>update</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>update_catalog_controls</span><span class=p>()</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog_title class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_catalog_title</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog_title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the title of the catalog.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_catalog_title</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the title of the catalog.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_comp_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_comp_info</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_comp_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get comp_dict for this control.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_comp_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>CompDict</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get comp_dict for this control.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_dicts</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get control from the control dict with this id.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get control from the control dict with this id.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=kc>None</span> <span class=k>if</span> <span class=n>control_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>control</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_control_by_param_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_by_param_id</span><span class=p>(</span><span class=n>param_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_by_param_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get control from catalog that has this param id using the dict.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_by_param_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>param_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get control from catalog that has this param id using the dict.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>param_id</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_param_control_map</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_param_control_map</span><span class=p>[</span><span class=n>param_id</span><span class=p>])</span>
+    <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_control_comp_set_params class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_comp_set_params</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_comp_set_params class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get dict of setparams list per component.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_comp_set_params</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get dict of setparams list per component.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_comp_set_params</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_control_file_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_file_path</span><span class=p>(</span><span class=n>md_root</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_file_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the path to the control from the given root.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_file_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the path to the control from the given root.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>control_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>None</span>
+    <span class=n>path</span> <span class=o>=</span> <span class=n>md_root</span>
+    <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_path</span><span class=p>(</span><span class=n>control_id</span><span class=p>):</span>
+        <span class=n>path</span> <span class=o>=</span> <span class=n>path</span> <span class=o>/</span> <span class=n>item</span>
+    <span class=k>return</span> <span class=n>path</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>.md&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_control_id_and_status class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_id_and_status</span><span class=p>(</span><span class=n>control_name</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_id_and_status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the control id and status using the control name.</p> <p>Returns empty string if status not found.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_id_and_status</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get the control id and status using the control name.</span>
+
+<span class=sd>    Returns empty string if status not found.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>control</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>control_name</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>():</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_prop</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=s1>&#39;status&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>status</span>
+    <span class=k>return</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_ids</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get all control ids from the control dict.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_ids</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get all control ids from the control dict.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids_from_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_ids_from_catalog</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids_from_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get all control ids from a catalog.</p> <p>This is intended to provide a quick list of all controls in a catalog without the expense of building the control dict. So, if repeated queries are made into a catalog, it is worth instantiating a CatalogInterface and associated control dict. Otherwise just use this to get a list of all controls.</p> <p>This function is needed within the CatalogInterface in order to determine if new controls have been added to the dict and need to be inserted in the actual catalog during update.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_control_ids_from_catalog</span><span class=p>(</span><span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get all control ids from a catalog.</span>
+
+<span class=sd>    This is intended to provide a quick list of all controls in a catalog without the expense of building the</span>
+<span class=sd>    control dict.  So, if repeated queries are made into a catalog, it is worth instantiating a CatalogInterface</span>
+<span class=sd>    and associated control dict.  Otherwise just use this to get a list of all controls.</span>
+
+<span class=sd>    This function is needed within the CatalogInterface in order to determine if new controls have been added</span>
+<span class=sd>    to the dict and need to be inserted in the actual catalog during update.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>controls</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_all_controls_in_list</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>),</span> <span class=kc>True</span><span class=p>)</span>
+    <span class=n>id_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>controls</span><span class=p>]</span>
+    <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>):</span>
+        <span class=n>controls</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_all_controls_in_group</span><span class=p>(</span><span class=n>group</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>id_list</span><span class=o>.</span><span class=n>extend</span><span class=p>([</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>controls</span><span class=p>)])</span>
+    <span class=k>return</span> <span class=n>id_list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_control_part_prose class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_part_prose</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>part_name</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_part_prose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the prose for a named part in the control.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>control_id</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>id of the control</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>part_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>name of the part</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Single string concatenating prose from all parts and sub-parts in control with that name.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_part_prose</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>part_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get the prose for a named part in the control.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        control_id: id of the control</span>
+<span class=sd>        part_name: name of the part</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Single string concatenating prose from all parts and sub-parts in control with that name.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_part_prose</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part_name</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_control_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_path</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the path into the markdown directory for this control based only on the groups.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the path into the markdown directory for this control based only on the groups.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>group_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_count_of_controls_in_catalog</span><span class=p>(</span><span class=n>recurse</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get count of controls from the actual catalog including optional sub controls.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_count_of_controls_in_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get count of controls from the actual catalog including optional sub controls.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>len</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=n>recurse</span><span class=p>)))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_count_of_controls_in_dict</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find number of controls in the dict.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_count_of_controls_in_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find number of controls in the dict.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_dependent_control_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_dependent_control_ids</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_dependent_control_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find all child ids of this control from the dict with recursion.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_dependent_control_ids</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find all child ids of this control from the dict with recursion.&quot;&quot;&quot;</span>
+    <span class=n>children</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>control</span><span class=p>:</span>
+        <span class=n>new_controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_all_controls_in_list</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>),</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>children</span><span class=o>.</span><span class=n>extend</span><span class=p>([</span><span class=n>con</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>con</span> <span class=ow>in</span> <span class=n>new_controls</span><span class=p>])</span>
+    <span class=k>return</span> <span class=n>children</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_full_control_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_full_control_path</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_full_control_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the path to the control including groups and sub-controls.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_full_control_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the path to the control including groups and sub-controls.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>control_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_group_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_group_ids</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_group_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get all the group id's as a list of sorted strings.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_group_ids</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get all the group id&#39;s as a list of sorted strings.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>id_</span><span class=p>:</span> <span class=n>id_</span><span class=p>,</span> <span class=nb>list</span><span class=p>({</span><span class=n>control</span><span class=o>.</span><span class=n>group_id</span> <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()})))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_group_info_by_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_group_info_by_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the group_id, title, class for this control from the dict.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_group_info_by_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the group_id, title, class for this control from the dict.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=p>(</span>
+        <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>group_id</span><span class=p>,</span>
+        <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>group_title</span><span class=p>,</span>
+        <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>group_class</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_sections class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_sections</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_sections class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the available sections by a full index of all controls.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>791</span>
+<span class=normal>792</span>
+<span class=normal>793</span>
+<span class=normal>794</span>
+<span class=normal>795</span>
+<span class=normal>796</span>
+<span class=normal>797</span>
+<span class=normal>798</span>
+<span class=normal>799</span>
+<span class=normal>800</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_sections</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the available sections by a full index of all controls.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>list</span><span class=p>(</span>
+        <span class=p>{</span>
+            <span class=n>part</span><span class=o>.</span><span class=n>name</span>
+            <span class=k>for</span> <span class=n>control_handle</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_handle</span><span class=o>.</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span>
+        <span class=p>}</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_sorted_controls_in_group class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_sorted_controls_in_group</span><span class=p>(</span><span class=n>group_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_sorted_controls_in_group class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the list of controls in a group sorted by the control sort-id.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_sorted_controls_in_group</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the list of controls in a group sorted by the control sort-id.&quot;&quot;&quot;</span>
+    <span class=n>controls</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+        <span class=n>grp_id</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>grp_id</span> <span class=o>==</span> <span class=n>group_id</span><span class=p>:</span>
+            <span class=n>controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+    <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>controls</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>control</span><span class=p>:</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_label_if_exists class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_statement_label_if_exists</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_label_if_exists class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get statement label if available.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_statement_label_if_exists</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                                  <span class=n>statement_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get statement label if available.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>does_part_exists</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+        <span class=n>does_match</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=ow>and</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span><span class=p>}</span> <span class=ow>and</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span> <span class=o>==</span> <span class=n>statement_id</span><span class=p>:</span>
+            <span class=n>does_match</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=n>does_match</span>
+
+    <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>control</span><span class=p>:</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=kc>None</span>
+    <span class=n>label</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>found_part</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=c1># Performance OSCAL assumption, ids are nested so recurse only if prefix</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span> <span class=ow>and</span> <span class=n>statement_id</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>):</span>
+                <span class=n>part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>find_part_with_condition</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>does_part_exists</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>part</span><span class=p>:</span>
+                    <span class=n>label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>part</span><span class=p>)</span>
+                    <span class=n>found_part</span> <span class=o>=</span> <span class=n>part</span>
+                    <span class=k>break</span>
+
+    <span class=k>return</span> <span class=n>label</span><span class=p>,</span> <span class=n>found_part</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_part_id_map class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_statement_part_id_map</span><span class=p>(</span><span class=n>label_as_key</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_part_id_map class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create mapping of label to part_id for top level parts in statement of all controls.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_statement_part_id_map</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>label_as_key</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create mapping of label to part_id for top level parts in statement of all controls.&quot;&quot;&quot;</span>
+    <span class=n>id_map</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>):</span>
+        <span class=n>statement_part</span> <span class=o>=</span> <span class=n>get_item_from_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>statement_part</span><span class=p>:</span>
+            <span class=k>continue</span>
+        <span class=n>id_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>sub_part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>statement_part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=n>label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>sub_part</span><span class=p>)</span>
+            <span class=c1># skip add to map for empty label</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>label</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>label_as_key</span><span class=p>:</span>
+                <span class=n>id_dict</span><span class=p>[</span><span class=n>label</span><span class=p>]</span> <span class=o>=</span> <span class=n>sub_part</span><span class=o>.</span><span class=n>id</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>id_dict</span><span class=p>[</span><span class=n>sub_part</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>label</span>
+        <span class=k>if</span> <span class=n>id_dict</span><span class=p>:</span>
+            <span class=n>id_map</span><span class=p>[</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>id_dict</span>
+    <span class=k>return</span> <span class=n>id_map</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_statement_parts</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get list of statement parts as dicts with indentation, label and prose.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_statement_parts</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get list of statement parts as dicts with indentation, label and prose.&quot;&quot;&quot;</span>
+    <span class=n>items</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+
+    <span class=c1># control may have no statement or parts</span>
+    <span class=c1># but if statement present it is first part</span>
+    <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No control found for id </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+        <span class=n>part</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;statement&#39;</span><span class=p>:</span>
+            <span class=n>items</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_statement_sub_parts</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=mi>0</span><span class=p>))</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> has parts but first part name is </span><span class=si>{</span><span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> - not statement&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>items</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.replace_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>replace_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.replace_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Replace the control in the control_dict.</p> <p>This only replaces the parent control and not its children.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>replace_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Replace the control in the control_dict.</span>
+
+<span class=sd>    This only replaces the parent control and not its children.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span><span class=o>.</span><span class=n>control</span> <span class=o>=</span> <span class=n>control</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_interface.CatalogInterface.update_catalog_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>update_catalog_controls</span><span class=p>()</span></code> <a href=#trestle.core.catalog.catalog_interface.CatalogInterface.update_catalog_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Update the actual catalog by pulling fresh controls from the dict.</p> <p>During assembly, controls may be added, but not children of controls. New groups may not be added. A control containing controls cannot be added. Controls containing controls are only available if the parent catalog was loaded from json.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>update_catalog_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Update the actual catalog by pulling fresh controls from the dict.</span>
+
+<span class=sd>    During assembly, controls may be added, but not children of controls.</span>
+<span class=sd>    New groups may not be added.</span>
+<span class=sd>    A control containing controls cannot be added.  Controls containing controls are only available if</span>
+<span class=sd>    the parent catalog was loaded from json.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># first go through the catalog and pull existing controls from the dict</span>
+    <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>):</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_update_all_controls_in_group</span><span class=p>(</span><span class=n>group</span><span class=p>)</span>
+
+    <span class=n>new_list</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>):</span>
+        <span class=n>new_control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=n>new_control</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_update_all_controls_in_list</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>))</span>
+        <span class=n>new_control</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_control</span><span class=o>.</span><span class=n>controls</span><span class=p>)</span>
+        <span class=n>new_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_control</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_list</span><span class=p>)</span>
+
+    <span class=c1># now add any new controls that are discovered in the dict</span>
+    <span class=n>ids_in_catalog</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>get_control_ids_from_catalog</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>control_handle</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>control_handle</span><span class=o>.</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>ids_in_catalog</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_insert_control_in_catalog</span><span class=p>(</span><span class=n>control_handle</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>loose_param_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.catalog.catalog_interface-functions>Functions<a href=#trestle.core.catalog.catalog_interface-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/catalog/catalog_merger/index.html b/latest/reference/API/trestle/core/catalog/catalog_merger/index.html
new file mode 100644
index 000000000..4e57be547
--- /dev/null
+++ b/latest/reference/API/trestle/core/catalog/catalog_merger/index.html
@@ -0,0 +1,387 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.catalog.catalog_merger module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_merger/ rel=canonical><link href=../catalog_interface/ rel=prev><link href=../catalog_reader/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.catalog.catalog_merger - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.catalog.catalog_merger - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.catalog.catalog_merger module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_merger.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_merger/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.catalog.catalog_merger - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.catalog.catalog_merger module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_merger.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.catalog.catalog_merger class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26 checked> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger class=md-nav__link> <span class=md-ellipsis> catalog_merger </span> </a> <nav class=md-nav aria-label=catalog_merger> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger class=md-nav__link> <span class=md-ellipsis> CatalogMerger </span> </a> <nav class=md-nav aria-label=CatalogMerger> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger.merge_catalog class=md-nav__link> <span class=md-ellipsis> merge_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger.merge_controls class=md-nav__link> <span class=md-ellipsis> merge_controls </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger class=md-nav__link> <span class=md-ellipsis> catalog_merger </span> </a> <nav class=md-nav aria-label=catalog_merger> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger class=md-nav__link> <span class=md-ellipsis> CatalogMerger </span> </a> <nav class=md-nav aria-label=CatalogMerger> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger.merge_catalog class=md-nav__link> <span class=md-ellipsis> merge_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger.merge_controls class=md-nav__link> <span class=md-ellipsis> merge_controls </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_merger-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.catalog.catalog_merger</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.catalog.catalog_merger class="doc doc-heading"> <code>trestle.core.catalog.catalog_merger</code> <a href=#trestle.core.catalog.catalog_merger class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Provide interface to merge one catalog to another.</p> <div class="doc doc-children"> <h3 id=trestle.core.catalog.catalog_merger-attributes>Attributes<a href=#trestle.core.catalog.catalog_merger-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.catalog.catalog_merger.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_merger.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.catalog.catalog_merger-classes>Classes<a href=#trestle.core.catalog.catalog_merger-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.catalog.catalog_merger.CatalogMerger class="doc doc-heading"> <code>CatalogMerger</code> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Catalog merger.</p> <p>Catalog merger handles all operations related to merging contents of one catalog to another.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_merger.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogMerger</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Catalog merger.</span>
+
+<span class=sd>    Catalog merger handles all operations related to</span>
+<span class=sd>    merging contents of one catalog to another.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>:</span> <span class=n>CatalogInterface</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize catalog merger.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>catalog_interface</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>merge_controls</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>src</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Merge the src control into dest.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            dest: destination control into which content will be added</span>
+<span class=sd>            src: source control with new content</span>
+<span class=sd>            replace_params: replace the control params with the new ones</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_parts</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>replace_params</span><span class=p>:</span>
+            <span class=n>dest</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>params</span>
+
+    <span class=k>def</span> <span class=nf>merge_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Merge the provided new catalog controls into the original catalog in this catalog interface.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            catalog: catalog containing controls that are merged into the current catalog of the interface</span>
+<span class=sd>            replace_params: replace all params in the control with the new ones</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            This is mainly to support the reading of a catalog from markdown.  It allows retention of content such as</span>
+<span class=sd>            metadata and backmatter, along with labels and other parameter attributes that aren&#39;t in markdown.</span>
+<span class=sd>            The list of controls and group structure is specified by the markdown structure - but this doesn&#39;t allow</span>
+<span class=sd>            controls to contain controls.  Group lists are specified per directory.</span>
+
+<span class=sd>            Reading the markdown tells you groups and controls in them - and groups in groups.</span>
+<span class=sd>            Controls cannot change groups.  If the control was in the original json, its parts are replaced,</span>
+<span class=sd>            including its parameters.  Only values may be specified.  If no value specified, the value is unset in json.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>cat_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>src</span> <span class=ow>in</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=n>group_id</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>src</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=n>dest</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>src</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>dest</span><span class=p>:</span>
+                <span class=n>dest_group</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>dest</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>dest_group</span> <span class=o>!=</span> <span class=n>group_id</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown for control </span><span class=si>{</span><span class=n>src</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> has different group id.&#39;</span><span class=p>)</span>
+                <span class=n>CatalogMerger</span><span class=o>.</span><span class=n>merge_controls</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>replace_control</span><span class=p>(</span><span class=n>dest</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># this is a new control that isn&#39;t already in the merge destination</span>
+                <span class=c1># need to add the control knowing its group must already exist</span>
+                <span class=c1># get group info from an arbitrary control already present in group</span>
+                <span class=n>_</span><span class=p>,</span> <span class=n>control_handle</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_find_control_in_group</span><span class=p>(</span><span class=n>group_id</span><span class=p>)</span>
+                <span class=n>new_control_handle</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>control_handle</span><span class=p>)</span>
+                <span class=n>new_control_handle</span><span class=o>.</span><span class=n>control</span> <span class=o>=</span> <span class=n>src</span>
+                <span class=c1># add the control and its handle to the param_dict</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>src</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_control_handle</span>  <span class=c1># type: ignore</span>
+
+        <span class=c1># now need to cull any controls that are not in the src catalog</span>
+        <span class=k>if</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>_control_dict</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>handled_ids</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>handled_ids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>cat_interface</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+        <span class=n>orig_ids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+        <span class=n>extra_ids</span> <span class=o>=</span> <span class=n>orig_ids</span><span class=o>.</span><span class=n>difference</span><span class=p>(</span><span class=n>handled_ids</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>extra_id</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>extra_ids</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>extra_id</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>update_catalog_controls</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_merge_header_and_comp_dict</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>control_file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Merge the header and the comp_dict.</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            now have all rules in context.rules_dict and all rules_params in context.rules_params_dict</span>
+<span class=sd>            all set-params per component for each control are in the cat interface</span>
+<span class=sd>            all comp-infos by control and part are in the cat interface</span>
+
+<span class=sd>            can now write out catalog and pull from the markdown:</span>
+<span class=sd>            header for param values to set during assem</span>
+<span class=sd>            prose and status for This System</span>
+<span class=sd>            status for all parts that still have rules</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>memory_header</span><span class=p>,</span> <span class=n>memory_comp_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_get_control_memory_info</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_dicts_deep</span><span class=p>(</span><span class=n>memory_header</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>md_header</span><span class=p>,</span> <span class=n>md_comp_dict</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_read_comp_info_from_md</span><span class=p>(</span><span class=n>control_file_path</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+        <span class=c1># md content replaces memory content but unless memory has no rules for it and the content is removed</span>
+        <span class=c1># but This System doesn&#39;t require rules, so its content is always kept</span>
+
+        <span class=c1># go through the just-read md_comp_dict and update the memory dict with contents in md</span>
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span> <span class=ow>in</span> <span class=n>md_comp_dict</span><span class=p>:</span>
+            <span class=n>memory_comp_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>]</span> <span class=o>=</span> <span class=n>md_comp_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>md_label_dict</span> <span class=ow>in</span> <span class=n>md_comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>memory_label_dict</span> <span class=o>=</span> <span class=n>memory_comp_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>comp_name</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>:</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>memory_label_dict</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=k>for</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_info</span> <span class=ow>in</span> <span class=n>md_label_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>label</span> <span class=ow>in</span> <span class=n>memory_label_dict</span><span class=p>:</span>
+                        <span class=n>memory_label_dict</span><span class=p>[</span><span class=n>label</span><span class=p>]</span> <span class=o>=</span> <span class=n>comp_info</span>
+
+        <span class=n>memory_rules_param_vals</span> <span class=o>=</span> <span class=n>memory_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>md_rules_param_vals</span> <span class=o>=</span> <span class=n>md_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>val_list</span> <span class=ow>in</span> <span class=n>md_rules_param_vals</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>val_dict</span> <span class=o>=</span> <span class=p>{</span><span class=n>val</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]:</span> <span class=n>val</span> <span class=k>for</span> <span class=n>val</span> <span class=ow>in</span> <span class=n>val_list</span><span class=p>}</span>
+            <span class=k>if</span> <span class=n>comp_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>memory_rules_param_vals</span><span class=p>:</span>
+                <span class=n>memory_rules_param_vals</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>val_list</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># merge the lists with priority to md</span>
+                <span class=n>new_list</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=n>mem_list</span> <span class=o>=</span> <span class=n>memory_rules_param_vals</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span>
+                <span class=n>mem_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>mem</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=k>for</span> <span class=n>mem</span> <span class=ow>in</span> <span class=n>mem_list</span><span class=p>]</span>
+                <span class=k>for</span> <span class=n>val</span> <span class=ow>in</span> <span class=n>mem_list</span><span class=p>:</span>
+                    <span class=n>new_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>val_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>val</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>],</span> <span class=n>val</span><span class=p>))</span>
+                <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>val</span> <span class=ow>in</span> <span class=n>val_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>mem_names</span><span class=p>:</span>
+                        <span class=n>new_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>val</span><span class=p>)</span>
+                <span class=n>memory_rules_param_vals</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_list</span>
+
+        <span class=n>set_or_pop</span><span class=p>(</span><span class=n>memory_header</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>,</span> <span class=n>memory_rules_param_vals</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span> <span class=o>=</span> <span class=n>memory_header</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.catalog.catalog_merger.CatalogMerger-functions>Functions<a href=#trestle.core.catalog.catalog_merger.CatalogMerger-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_merger.CatalogMerger.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>catalog_interface</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize catalog merger.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_merger.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>:</span> <span class=n>CatalogInterface</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize catalog merger.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>catalog_interface</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_merger.CatalogMerger.merge_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge_catalog</span><span class=p>(</span><span class=n>catalog</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger.merge_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge the provided new catalog controls into the original catalog in this catalog interface.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>catalog</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.catalog.Catalog href=../../../oscal/catalog/#trestle.oscal.catalog.Catalog>Catalog</a></code> </td> <td> <div class=doc-md-description> <p>catalog containing controls that are merged into the current catalog of the interface</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>replace_params</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>replace all params in the control with the new ones</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>This is mainly to support the reading of a catalog from markdown. It allows retention of content such as metadata and backmatter, along with labels and other parameter attributes that aren't in markdown. The list of controls and group structure is specified by the markdown structure - but this doesn't allow controls to contain controls. Group lists are specified per directory.</p> <p>Reading the markdown tells you groups and controls in them - and groups in groups. Controls cannot change groups. If the control was in the original json, its parts are replaced, including its parameters. Only values may be specified. If no value specified, the value is unset in json.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_merger.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>merge_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Merge the provided new catalog controls into the original catalog in this catalog interface.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        catalog: catalog containing controls that are merged into the current catalog of the interface</span>
+<span class=sd>        replace_params: replace all params in the control with the new ones</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        This is mainly to support the reading of a catalog from markdown.  It allows retention of content such as</span>
+<span class=sd>        metadata and backmatter, along with labels and other parameter attributes that aren&#39;t in markdown.</span>
+<span class=sd>        The list of controls and group structure is specified by the markdown structure - but this doesn&#39;t allow</span>
+<span class=sd>        controls to contain controls.  Group lists are specified per directory.</span>
+
+<span class=sd>        Reading the markdown tells you groups and controls in them - and groups in groups.</span>
+<span class=sd>        Controls cannot change groups.  If the control was in the original json, its parts are replaced,</span>
+<span class=sd>        including its parameters.  Only values may be specified.  If no value specified, the value is unset in json.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>cat_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>src</span> <span class=ow>in</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+        <span class=n>group_id</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>src</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=n>dest</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>src</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>dest</span><span class=p>:</span>
+            <span class=n>dest_group</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>dest</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>dest_group</span> <span class=o>!=</span> <span class=n>group_id</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown for control </span><span class=si>{</span><span class=n>src</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> has different group id.&#39;</span><span class=p>)</span>
+            <span class=n>CatalogMerger</span><span class=o>.</span><span class=n>merge_controls</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>replace_control</span><span class=p>(</span><span class=n>dest</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># this is a new control that isn&#39;t already in the merge destination</span>
+            <span class=c1># need to add the control knowing its group must already exist</span>
+            <span class=c1># get group info from an arbitrary control already present in group</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>control_handle</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_find_control_in_group</span><span class=p>(</span><span class=n>group_id</span><span class=p>)</span>
+            <span class=n>new_control_handle</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>control_handle</span><span class=p>)</span>
+            <span class=n>new_control_handle</span><span class=o>.</span><span class=n>control</span> <span class=o>=</span> <span class=n>src</span>
+            <span class=c1># add the control and its handle to the param_dict</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_control_dict</span><span class=p>[</span><span class=n>src</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_control_handle</span>  <span class=c1># type: ignore</span>
+
+    <span class=c1># now need to cull any controls that are not in the src catalog</span>
+    <span class=k>if</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>_control_dict</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>handled_ids</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>handled_ids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>cat_interface</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+    <span class=n>orig_ids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+    <span class=n>extra_ids</span> <span class=o>=</span> <span class=n>orig_ids</span><span class=o>.</span><span class=n>difference</span><span class=p>(</span><span class=n>handled_ids</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>extra_id</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>extra_ids</span><span class=p>):</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_control_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>extra_id</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>update_catalog_controls</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_merger.CatalogMerger.merge_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge_controls</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.catalog.catalog_merger.CatalogMerger.merge_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge the src control into dest.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>dest</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.catalog.Control href=../../../oscal/catalog/#trestle.oscal.catalog.Control>Control</a></code> </td> <td> <div class=doc-md-description> <p>destination control into which content will be added</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>src</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.catalog.Control href=../../../oscal/catalog/#trestle.oscal.catalog.Control>Control</a></code> </td> <td> <div class=doc-md-description> <p>source control with new content</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>replace_params</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>replace the control params with the new ones</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_merger.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>merge_controls</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>src</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>replace_params</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Merge the src control into dest.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        dest: destination control into which content will be added</span>
+<span class=sd>        src: source control with new content</span>
+<span class=sd>        replace_params: replace the control params with the new ones</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_parts</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>replace_params</span><span class=p>:</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>params</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.catalog.catalog_merger-functions>Functions<a href=#trestle.core.catalog.catalog_merger-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/catalog/catalog_reader/index.html b/latest/reference/API/trestle/core/catalog/catalog_reader/index.html
new file mode 100644
index 000000000..6cc9d6968
--- /dev/null
+++ b/latest/reference/API/trestle/core/catalog/catalog_reader/index.html
@@ -0,0 +1,1153 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.catalog.catalog_reader module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_reader/ rel=canonical><link href=../catalog_merger/ rel=prev><link href=../catalog_writer/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.catalog.catalog_reader - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.catalog.catalog_reader - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.catalog.catalog_reader module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_reader.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_reader/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.catalog.catalog_reader - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.catalog.catalog_reader module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_reader.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.catalog.catalog_reader class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26 checked> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader class=md-nav__link> <span class=md-ellipsis> catalog_reader </span> </a> <nav class=md-nav aria-label=catalog_reader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader class=md-nav__link> <span class=md-ellipsis> CatalogReader </span> </a> <nav class=md-nav aria-label=CatalogReader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_additional_content class=md-nav__link> <span class=md-ellipsis> read_additional_content </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_from_markdown class=md-nav__link> <span class=md-ellipsis> read_catalog_from_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_imp_reqs class=md-nav__link> <span class=md-ellipsis> read_catalog_imp_reqs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_ssp_md_content class=md-nav__link> <span class=md-ellipsis> read_ssp_md_content </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader class=md-nav__link> <span class=md-ellipsis> catalog_reader </span> </a> <nav class=md-nav aria-label=catalog_reader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader class=md-nav__link> <span class=md-ellipsis> CatalogReader </span> </a> <nav class=md-nav aria-label=CatalogReader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_additional_content class=md-nav__link> <span class=md-ellipsis> read_additional_content </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_from_markdown class=md-nav__link> <span class=md-ellipsis> read_catalog_from_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_imp_reqs class=md-nav__link> <span class=md-ellipsis> read_catalog_imp_reqs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_ssp_md_content class=md-nav__link> <span class=md-ellipsis> read_ssp_md_content </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_reader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.catalog.catalog_reader</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.catalog.catalog_reader class="doc doc-heading"> <code>trestle.core.catalog.catalog_reader</code> <a href=#trestle.core.catalog.catalog_reader class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Provide interface to read catalog from markdown back to OSCAL.</p> <div class="doc doc-children"> <h3 id=trestle.core.catalog.catalog_reader-attributes>Attributes<a href=#trestle.core.catalog.catalog_reader-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.catalog.catalog_reader.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_reader.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.catalog.catalog_reader-classes>Classes<a href=#trestle.core.catalog.catalog_reader-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.catalog.catalog_reader.CatalogReader class="doc doc-heading"> <code>CatalogReader</code> <a href=#trestle.core.catalog.catalog_reader.CatalogReader class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Catalog reader.</p> <p>Catalog reader handles all operations related to reading catalog from markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogReader</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Catalog reader.</span>
+
+<span class=sd>    Catalog reader handles all operations related to</span>
+<span class=sd>    reading catalog from markdown.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>:</span> <span class=n>CatalogInterface</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize catalog reader.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>catalog_interface</span>
+
+    <span class=k>def</span> <span class=nf>read_additional_content</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>required_sections_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>label_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+        <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+        <span class=n>write_mode</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read all markdown controls and return list of alters plus control param dict and param sort map.&quot;&quot;&quot;</span>
+        <span class=n>alters_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>final_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>param_sort_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>group_path</span> <span class=ow>in</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_group_ids_and_dirs</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>control_file</span> <span class=ow>in</span> <span class=n>group_path</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>):</span>
+                <span class=n>sort_id</span><span class=p>,</span> <span class=n>control_alters</span><span class=p>,</span> <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_editable_content</span><span class=p>(</span>
+                    <span class=n>control_file</span><span class=p>,</span>
+                    <span class=n>required_sections_list</span><span class=p>,</span>
+                    <span class=n>label_map</span><span class=p>,</span>
+                    <span class=n>sections_dict</span><span class=p>,</span>
+                    <span class=n>write_mode</span>
+                <span class=p>)</span>
+                <span class=n>alters_map</span><span class=p>[</span><span class=n>sort_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>control_alters</span>
+                <span class=k>for</span> <span class=n>param_id</span><span class=p>,</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=c1># if profile_values are present, overwrite values with them</span>
+                    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=o>!=</span> <span class=p>[]</span> <span class=ow>and</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                            <span class=k>if</span> <span class=ow>not</span> <span class=n>write_mode</span> <span class=ow>and</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME_PLACEHOLDER</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]:</span>
+                                <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME_PLACEHOLDER</span><span class=p>)</span>
+                            <span class=k>if</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=o>!=</span> <span class=p>[]</span> <span class=ow>and</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                                <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span>
+                        <span class=k>if</span> <span class=ow>not</span> <span class=n>write_mode</span><span class=p>:</span>
+                            <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>)</span>
+                    <span class=c1># verifies if at control profile edition the param value origin was modified</span>
+                    <span class=c1># through the profile-param-value-origin tag</span>
+                    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>]</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME_PLACEHOLDER</span><span class=p>:</span>
+                            <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>]</span>
+                            <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>)</span>
+                        <span class=k>else</span><span class=p>:</span>
+                            <span class=c1># removes replace me placeholder and profile-param-value-origin as it was not modified</span>
+                            <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>)</span>
+                            <span class=c1># validates param-value-origin is in dict to remove it</span>
+                            <span class=c1># because a value wasn´t provided and it shouldn´t be inheriting value from parent</span>
+                            <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                                <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>)</span>
+                    <span class=n>final_param_dict</span><span class=p>[</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_dict</span>
+                    <span class=n>param_sort_map</span><span class=p>[</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>sort_id</span>
+        <span class=n>new_alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># fill the alters according to the control sorting order</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>alters_map</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+            <span class=n>new_alters</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>alters_map</span><span class=p>[</span><span class=n>key</span><span class=p>])</span>
+        <span class=k>return</span> <span class=n>new_alters</span><span class=p>,</span> <span class=n>final_param_dict</span><span class=p>,</span> <span class=n>param_sort_map</span>
+
+    <span class=k>def</span> <span class=nf>read_catalog_from_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Read the groups and catalog controls from the given directory.</span>
+
+<span class=sd>        This will overwrite the existing groups and controls in the catalog.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>id_map</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_group_ids_and_dirs</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span>
+        <span class=n>groups</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># read each group dir</span>
+        <span class=k>for</span> <span class=n>group_id</span><span class=p>,</span> <span class=n>group_dir</span> <span class=ow>in</span> <span class=n>id_map</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>control_list_raw</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>group_title</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=c1># Need to get group title from at least one control in this directory</span>
+            <span class=c1># All controls in dir should have same group title</span>
+            <span class=c1># Set group title to the first one found and warn if different non-empty title appears</span>
+            <span class=c1># Controls with empty group titles are tolerated but at least one title must be present or warning given</span>
+            <span class=c1># The special group with no name that has the catalog as parent is just a list and has no title</span>
+            <span class=k>for</span> <span class=n>control_path</span> <span class=ow>in</span> <span class=n>group_dir</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>):</span>
+                <span class=n>control</span><span class=p>,</span> <span class=n>control_group_title</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_control</span><span class=p>(</span><span class=n>control_path</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>control_group_title</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>group_title</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>control_group_title</span> <span class=o>!=</span> <span class=n>group_title</span><span class=p>:</span>
+                            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                                <span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> group title </span><span class=si>{</span><span class=n>control_group_title</span><span class=si>}</span><span class=s1> differs from </span><span class=si>{</span><span class=n>group_title</span><span class=si>}</span><span class=s1>&#39;</span>
+                            <span class=p>)</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>group_title</span> <span class=o>=</span> <span class=n>control_group_title</span>
+                <span class=n>control_list_raw</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+            <span class=n>control_list</span> <span class=o>=</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>control_list_raw</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>control</span><span class=p>:</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>))</span>
+            <span class=k>if</span> <span class=n>group_id</span><span class=p>:</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>group_title</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;No group title found in controls for group </span><span class=si>{</span><span class=n>group_id</span><span class=si>}</span><span class=s1>.  The title will be recovered if assembling into an existing catalog with the group title defined.&#39;</span>  <span class=c1># noqa E501</span>
+                    <span class=p>)</span>
+                <span class=n>new_group</span> <span class=o>=</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=n>group_id</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>group_title</span><span class=p>)</span>
+                <span class=n>new_group</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>control_list</span><span class=p>)</span>
+                <span class=n>groups</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_group</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># if the list of controls has no group id it also has no title and is just the controls of the catalog</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>control_list</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>groups</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_create_control_dict</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>params</span><span class=p>)</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>read_catalog_imp_reqs</span><span class=p>(</span><span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read the full set of control implemented requirements from markdown.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            md_path: Path to the markdown control files, with directories for each group</span>
+<span class=sd>            context: Context for the operation</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            List of implemented requirements gathered from each control</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            As the controls are read into the catalog the needed components are added if not already available.</span>
+<span class=sd>            avail_comps provides the mapping of component name to the actual component.</span>
+<span class=sd>            This is only used during component assemble and only for updating one component</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>imp_req_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>group_path</span> <span class=ow>in</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_group_ids_and_dirs</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>control_file</span> <span class=ow>in</span> <span class=n>group_path</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>):</span>
+                <span class=n>sort_id</span><span class=p>,</span> <span class=n>imp_req</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_implemented_requirement</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+                <span class=n>imp_req_map</span><span class=p>[</span><span class=n>sort_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>imp_req</span>
+        <span class=k>return</span> <span class=p>[</span><span class=n>imp_req_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>imp_req_map</span><span class=o>.</span><span class=n>keys</span><span class=p>())]</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_imp_req_for_control</span><span class=p>(</span><span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>imp_req</span>
+        <span class=n>imp_req</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>)</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=n>control_id</span>
+        <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span>
+            <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span>
+        <span class=p>)</span>
+        <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>imp_req</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_imp_req_for_statement</span><span class=p>(</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>:</span>
+        <span class=n>control_imp_req</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+                <span class=n>control_imp_req</span> <span class=o>=</span> <span class=n>imp_req</span>
+                <span class=k>if</span> <span class=n>statement_id</span> <span class=ow>in</span> <span class=p>[</span><span class=n>stat</span><span class=o>.</span><span class=n>statement_id</span> <span class=k>for</span> <span class=n>stat</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>)]:</span>
+                    <span class=k>return</span> <span class=n>imp_req</span>
+        <span class=c1># we didn&#39;t find imp_req with statement so need to make statement and/or imp_req</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>control_imp_req</span><span class=p>:</span>
+            <span class=n>control_imp_req</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>)</span>
+            <span class=n>control_imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=n>control_id</span>
+            <span class=n>control_imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span>
+            <span class=p>)</span>
+            <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_imp_req</span><span class=p>)</span>
+        <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_add_statement_to_impl_requirement</span><span class=p>(</span><span class=n>control_imp_req</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>control_imp_req</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_statement_to_impl_requirement</span><span class=p>(</span><span class=n>impl_req</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update the implemented requirement with a new statement.&quot;&quot;&quot;</span>
+        <span class=n>statement</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>)</span>
+        <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=o>=</span> <span class=n>statement_id</span>
+        <span class=n>statement</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>impl_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>impl_req</span><span class=o>.</span><span class=n>statements</span><span class=p>)</span>
+        <span class=n>impl_req</span><span class=o>.</span><span class=n>statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>statement</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_by_comp_from_imp_req</span><span class=p>(</span>
+        <span class=n>imp_req</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_uuid</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>statement_id</span><span class=p>:</span>
+            <span class=n>found_statement</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=o>==</span> <span class=n>statement_id</span><span class=p>:</span>
+                    <span class=n>found_statement</span> <span class=o>=</span> <span class=n>statement</span>
+                    <span class=k>break</span>
+
+            <span class=c1># If the statement doesn&#39;t exist, create it</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>found_statement</span><span class=p>:</span>
+                <span class=n>found_statement</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_add_statement_to_impl_requirement</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>found_statement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=o>==</span> <span class=n>comp_uuid</span><span class=p>:</span>
+                        <span class=k>return</span> <span class=n>by_comp</span>
+
+            <span class=c1># didnt find bycomp or new statement so need to make one</span>
+            <span class=n>by_comp</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>)</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=o>=</span> <span class=n>comp_uuid</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span> <span class=o>=</span> <span class=n>com</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_PLANNED</span><span class=p>)</span>
+            <span class=n>found_statement</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>found_statement</span><span class=o>.</span><span class=n>by_components</span><span class=p>)</span>
+            <span class=n>found_statement</span><span class=o>.</span><span class=n>by_components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>by_comp</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=o>==</span> <span class=n>comp_uuid</span><span class=p>:</span>
+                    <span class=k>return</span> <span class=n>by_comp</span>
+            <span class=n>by_comp</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>)</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=o>=</span> <span class=n>comp_uuid</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span> <span class=o>=</span> <span class=n>com</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_PLANNED</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>by_comp</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_read_comp_info_from_md</span><span class=p>(</span><span class=n>control_file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+                                <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>CompDict</span><span class=p>]:</span>
+        <span class=n>md_header</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>comp_dict</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>if</span> <span class=n>control_file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>md_header</span><span class=p>,</span> <span class=n>comp_dict</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_control_info_from_md</span><span class=p>(</span><span class=n>control_file_path</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>md_header</span><span class=p>,</span> <span class=n>comp_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_update_ssp_with_comp_info</span><span class=p>(</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+        <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>gen_comp</span><span class=p>:</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>,</span>
+        <span class=n>comp_info_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ComponentImpInfo</span><span class=p>],</span>
+        <span class=n>part_id_map_by_label</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=c1># get imp req for control and find one with by_comp, creating if needed</span>
+        <span class=n>imp_req</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_get_imp_req_for_control</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+        <span class=c1># if control has no parts it will not have part id map and bycomps will go at control level</span>
+        <span class=n>control_part_id_map</span> <span class=o>=</span> <span class=n>part_id_map_by_label</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=k>for</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_info</span> <span class=ow>in</span> <span class=n>comp_info_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>part_id</span> <span class=o>=</span> <span class=n>control_part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>label</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+            <span class=n>by_comp</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_get_by_comp_from_imp_req</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>part_id</span><span class=p>,</span> <span class=n>gen_comp</span><span class=o>.</span><span class=n>uuid</span><span class=p>)</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span> <span class=o>=</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>status</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_insert_set_param_into_by_comps</span><span class=p>(</span>
+        <span class=n>item</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>],</span>
+        <span class=n>rule_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>param_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>param_values</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>comp_uuid</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=o>==</span> <span class=n>comp_uuid</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>by_comp</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>RULE_ID</span> <span class=ow>and</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=o>==</span> <span class=n>rule_id</span><span class=p>:</span>
+                        <span class=n>found</span> <span class=o>=</span> <span class=kc>False</span>
+                        <span class=k>for</span> <span class=n>sp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>by_comp</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                            <span class=k>if</span> <span class=n>sp</span><span class=o>.</span><span class=n>param_id</span> <span class=o>==</span> <span class=n>param_name</span><span class=p>:</span>
+                                <span class=n>sp</span><span class=o>.</span><span class=n>values</span> <span class=o>=</span> <span class=n>param_values</span>
+                                <span class=n>found</span> <span class=o>=</span> <span class=kc>True</span>
+                                <span class=k>break</span>
+                        <span class=k>if</span> <span class=ow>not</span> <span class=n>found</span><span class=p>:</span>
+                            <span class=n>sp</span> <span class=o>=</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=n>param_name</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>param_values</span><span class=p>)</span>
+                            <span class=n>by_comp</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>by_comp</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+                            <span class=n>by_comp</span><span class=o>.</span><span class=n>set_parameters</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sp</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_insert_param_dict_in_imp_req</span><span class=p>(</span>
+        <span class=n>imp_req</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+        <span class=n>comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>md_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+        <span class=n>comp_uuid</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Insert the param in the by_comps that are supported by the rule.&quot;&quot;&quot;</span>
+        <span class=c1># given param name find rule_id in comp name header entry</span>
+        <span class=c1># then find all statements with by_comp that have that rule id in props</span>
+        <span class=n>rules_dict</span> <span class=o>=</span> <span class=n>md_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>RULES_PARAMS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>comp_rules_params</span> <span class=o>=</span> <span class=n>rules_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=p>[])</span>
+        <span class=n>param_name</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span>
+        <span class=n>param_values</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;values&#39;</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>comp_rule_param</span> <span class=ow>in</span> <span class=n>comp_rules_params</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>comp_rule_param</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=n>param_name</span><span class=p>:</span>
+                <span class=n>rule_id</span> <span class=o>=</span> <span class=n>comp_rule_param</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>HEADER_RULE_ID</span><span class=p>]</span>
+                <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_insert_set_param_into_by_comps</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>param_name</span><span class=p>,</span> <span class=n>param_values</span><span class=p>,</span> <span class=n>comp_uuid</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                    <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_insert_set_param_into_by_comps</span><span class=p>(</span>
+                        <span class=n>statement</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>param_name</span><span class=p>,</span> <span class=n>param_values</span><span class=p>,</span> <span class=n>comp_uuid</span>
+                    <span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_set_params_to_item</span><span class=p>(</span><span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>item</span><span class=p>:</span> <span class=n>TypeWithSetParams</span><span class=p>,</span> <span class=n>param_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>value_list</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_VALUES</span><span class=p>]</span>
+        <span class=n>param_values</span> <span class=o>=</span> <span class=n>value_list</span>
+        <span class=n>new_sp_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>sp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>sp</span><span class=o>.</span><span class=n>param_id</span> <span class=o>!=</span> <span class=n>param_id</span><span class=p>:</span>
+                <span class=n>new_sp_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sp</span><span class=p>)</span>
+        <span class=n>item</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>new_sp_list</span>
+        <span class=n>item</span><span class=o>.</span><span class=n>set_parameters</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=n>param_id</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>param_values</span><span class=p>))</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_props_to_imp_req</span><span class=p>(</span>
+        <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>part_id_map_by_label</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+        <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>imp_req</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add the props from the yaml header to the imp_req.&quot;&quot;&quot;</span>
+        <span class=n>control_part_id_map</span> <span class=o>=</span> <span class=n>part_id_map_by_label</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>props</span><span class=p>,</span> <span class=n>props_by_id</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>get_props_list</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>control_part_id_map</span><span class=p>,</span> <span class=n>yaml_header</span><span class=p>)</span>
+        <span class=c1># add the props at control level</span>
+        <span class=k>if</span> <span class=n>props</span><span class=p>:</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>props</span><span class=p>)</span>
+
+        <span class=c1># add the props at the part level</span>
+        <span class=k>for</span> <span class=n>label</span><span class=p>,</span> <span class=n>part_id</span> <span class=ow>in</span> <span class=n>control_part_id_map</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>props</span> <span class=o>=</span> <span class=n>props_by_id</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>label</span><span class=p>,</span> <span class=p>[])</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>props</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=o>==</span> <span class=n>part_id</span><span class=p>:</span>
+                    <span class=n>statement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+                    <span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>props</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_update_ssp_with_md_header</span><span class=p>(</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+        <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>comp_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>],</span>
+        <span class=n>part_label_to_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+        <span class=n>md_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update the ssp with info from the header of an ssp control markdown file.&quot;&quot;&quot;</span>
+        <span class=c1># rules param vals go in bycomps of imp_req</span>
+        <span class=c1># param vals go directly in imp_req</span>
+        <span class=n>rules_param_vals_dict</span> <span class=o>=</span> <span class=n>md_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>imp_req</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_get_imp_req_for_control</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>param_dict_list</span> <span class=ow>in</span> <span class=n>rules_param_vals_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param_dict_list</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_VALUES</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                    <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;values&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;ssp-values&#39;</span><span class=p>]</span>
+                <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_insert_param_dict_in_imp_req</span><span class=p>(</span>
+                    <span class=n>imp_req</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>md_header</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span><span class=o>.</span><span class=n>uuid</span>
+                <span class=p>)</span>
+        <span class=n>param_vals_dict</span> <span class=o>=</span> <span class=n>md_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=k>for</span> <span class=n>param_id</span><span class=p>,</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>param_vals_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_VALUES</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_add_set_params_to_item</span><span class=p>(</span><span class=n>param_dict</span><span class=p>,</span> <span class=n>imp_req</span><span class=p>,</span> <span class=n>param_id</span><span class=p>)</span>
+
+        <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_add_props_to_imp_req</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>part_label_to_id_map</span><span class=p>,</span> <span class=n>md_header</span><span class=p>,</span> <span class=n>imp_req</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>read_ssp_md_content</span><span class=p>(</span>
+        <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+        <span class=n>comp_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>],</span>
+        <span class=n>part_id_map_by_label</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+        <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Read md content into the ssp.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            md_path: path to the catalog markdown</span>
+<span class=sd>            ssp: ssp in which to insert the md content</span>
+<span class=sd>            comp_dict: map of component name to component</span>
+<span class=sd>            part_id_map_by_label: map label to part_id of control</span>
+<span class=sd>            context: control context for the procedure</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            The ssp should already contain info from the comp defs and this fills in selected content from md.</span>
+<span class=sd>            The only content read from md is:</span>
+<span class=sd>                ssp values in the comp def rules param vals of the header</span>
+<span class=sd>                ssp values in the set-params of the header</span>
+<span class=sd>                all prose for implementaton responses</span>
+<span class=sd>                all status values</span>
+<span class=sd>            ssp has components but may not have all needed imp reqs and bycomps</span>
+<span class=sd>            know controlid and comp name in comp_dict</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>group_path</span> <span class=ow>in</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_group_ids_and_dirs</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>control_file</span> <span class=ow>in</span> <span class=n>group_path</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>):</span>
+                <span class=n>skip</span> <span class=o>=</span> <span class=kc>False</span>
+                <span class=k>for</span> <span class=n>file</span> <span class=ow>in</span> <span class=n>control_file</span><span class=o>.</span><span class=n>parents</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>file</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>INHERITANCE_VIEW_DIR</span><span class=p>:</span>
+                        <span class=n>skip</span> <span class=o>=</span> <span class=kc>True</span>
+                        <span class=k>break</span>
+                <span class=k>if</span> <span class=n>skip</span><span class=p>:</span>
+                    <span class=k>continue</span>
+
+                <span class=n>control_id</span> <span class=o>=</span> <span class=n>control_file</span><span class=o>.</span><span class=n>stem</span>
+
+                <span class=n>md_header</span><span class=p>,</span> <span class=n>control_comp_dict</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_read_comp_info_from_md</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+                <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>comp_info_dict</span> <span class=ow>in</span> <span class=n>control_comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>comp_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=p>:</span>
+                        <span class=n>err_msg</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> references component </span><span class=si>{</span><span class=n>comp_name</span><span class=si>}</span><span class=s1> not defined in a component-definition.&#39;</span>  <span class=c1># noqa E501</span>
+                        <span class=c1># give added guidance if no comp defs were specified at command line</span>
+                        <span class=k>if</span> <span class=ow>not</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_def_name_list</span><span class=p>:</span>
+                            <span class=n>err_msg</span> <span class=o>+=</span> <span class=s1>&#39;  Please specify the names of any component-definitions needed for assembly.&#39;</span>
+                        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=n>err_msg</span><span class=p>)</span>
+                    <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_update_ssp_with_comp_info</span><span class=p>(</span>
+                        <span class=n>ssp</span><span class=p>,</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>],</span> <span class=n>comp_info_dict</span><span class=p>,</span> <span class=n>part_id_map_by_label</span>
+                    <span class=p>)</span>
+                <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_update_ssp_with_md_header</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>part_id_map_by_label</span><span class=p>,</span> <span class=n>md_header</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.catalog.catalog_reader.CatalogReader-functions>Functions<a href=#trestle.core.catalog.catalog_reader.CatalogReader-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_reader.CatalogReader.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>catalog_interface</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize catalog reader.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>:</span> <span class=n>CatalogInterface</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize catalog reader.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>catalog_interface</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_reader.CatalogReader.read_additional_content class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_additional_content</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>required_sections_list</span><span class=p>,</span> <span class=n>label_map</span><span class=p>,</span> <span class=n>sections_dict</span><span class=p>,</span> <span class=n>write_mode</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_additional_content class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read all markdown controls and return list of alters plus control param dict and param sort map.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>read_additional_content</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>required_sections_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>label_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+    <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+    <span class=n>write_mode</span><span class=p>:</span> <span class=nb>bool</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Read all markdown controls and return list of alters plus control param dict and param sort map.&quot;&quot;&quot;</span>
+    <span class=n>alters_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>final_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>param_sort_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>group_path</span> <span class=ow>in</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_group_ids_and_dirs</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=k>for</span> <span class=n>control_file</span> <span class=ow>in</span> <span class=n>group_path</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>):</span>
+            <span class=n>sort_id</span><span class=p>,</span> <span class=n>control_alters</span><span class=p>,</span> <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_editable_content</span><span class=p>(</span>
+                <span class=n>control_file</span><span class=p>,</span>
+                <span class=n>required_sections_list</span><span class=p>,</span>
+                <span class=n>label_map</span><span class=p>,</span>
+                <span class=n>sections_dict</span><span class=p>,</span>
+                <span class=n>write_mode</span>
+            <span class=p>)</span>
+            <span class=n>alters_map</span><span class=p>[</span><span class=n>sort_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>control_alters</span>
+            <span class=k>for</span> <span class=n>param_id</span><span class=p>,</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=c1># if profile_values are present, overwrite values with them</span>
+                <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=o>!=</span> <span class=p>[]</span> <span class=ow>and</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=ow>not</span> <span class=n>write_mode</span> <span class=ow>and</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME_PLACEHOLDER</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]:</span>
+                            <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME_PLACEHOLDER</span><span class=p>)</span>
+                        <span class=k>if</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=o>!=</span> <span class=p>[]</span> <span class=ow>and</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                            <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>write_mode</span><span class=p>:</span>
+                        <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>)</span>
+                <span class=c1># verifies if at control profile edition the param value origin was modified</span>
+                <span class=c1># through the profile-param-value-origin tag</span>
+                <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>]</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME_PLACEHOLDER</span><span class=p>:</span>
+                        <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>]</span>
+                        <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>)</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=c1># removes replace me placeholder and profile-param-value-origin as it was not modified</span>
+                        <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>)</span>
+                        <span class=c1># validates param-value-origin is in dict to remove it</span>
+                        <span class=c1># because a value wasn´t provided and it shouldn´t be inheriting value from parent</span>
+                        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                            <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>)</span>
+                <span class=n>final_param_dict</span><span class=p>[</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_dict</span>
+                <span class=n>param_sort_map</span><span class=p>[</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>sort_id</span>
+    <span class=n>new_alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=c1># fill the alters according to the control sorting order</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>alters_map</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+        <span class=n>new_alters</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>alters_map</span><span class=p>[</span><span class=n>key</span><span class=p>])</span>
+    <span class=k>return</span> <span class=n>new_alters</span><span class=p>,</span> <span class=n>final_param_dict</span><span class=p>,</span> <span class=n>param_sort_map</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_from_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_catalog_from_markdown</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_from_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read the groups and catalog controls from the given directory.</p> <p>This will overwrite the existing groups and controls in the catalog.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>read_catalog_from_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Read the groups and catalog controls from the given directory.</span>
+
+<span class=sd>    This will overwrite the existing groups and controls in the catalog.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>id_map</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_group_ids_and_dirs</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span>
+    <span class=n>groups</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=c1># read each group dir</span>
+    <span class=k>for</span> <span class=n>group_id</span><span class=p>,</span> <span class=n>group_dir</span> <span class=ow>in</span> <span class=n>id_map</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+        <span class=n>control_list_raw</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>group_title</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=c1># Need to get group title from at least one control in this directory</span>
+        <span class=c1># All controls in dir should have same group title</span>
+        <span class=c1># Set group title to the first one found and warn if different non-empty title appears</span>
+        <span class=c1># Controls with empty group titles are tolerated but at least one title must be present or warning given</span>
+        <span class=c1># The special group with no name that has the catalog as parent is just a list and has no title</span>
+        <span class=k>for</span> <span class=n>control_path</span> <span class=ow>in</span> <span class=n>group_dir</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>):</span>
+            <span class=n>control</span><span class=p>,</span> <span class=n>control_group_title</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_control</span><span class=p>(</span><span class=n>control_path</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control_group_title</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>group_title</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>control_group_title</span> <span class=o>!=</span> <span class=n>group_title</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> group title </span><span class=si>{</span><span class=n>control_group_title</span><span class=si>}</span><span class=s1> differs from </span><span class=si>{</span><span class=n>group_title</span><span class=si>}</span><span class=s1>&#39;</span>
+                        <span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>group_title</span> <span class=o>=</span> <span class=n>control_group_title</span>
+            <span class=n>control_list_raw</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+        <span class=n>control_list</span> <span class=o>=</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>control_list_raw</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>control</span><span class=p>:</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>group_id</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>group_title</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;No group title found in controls for group </span><span class=si>{</span><span class=n>group_id</span><span class=si>}</span><span class=s1>.  The title will be recovered if assembling into an existing catalog with the group title defined.&#39;</span>  <span class=c1># noqa E501</span>
+                <span class=p>)</span>
+            <span class=n>new_group</span> <span class=o>=</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=n>group_id</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>group_title</span><span class=p>)</span>
+            <span class=n>new_group</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>control_list</span><span class=p>)</span>
+            <span class=n>groups</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_group</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># if the list of controls has no group id it also has no title and is just the controls of the catalog</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>control_list</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>groups</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>groups</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_create_control_dict</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>params</span><span class=p>)</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_catalog</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_imp_reqs class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_catalog_imp_reqs</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_imp_reqs class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read the full set of control implemented requirements from markdown.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>md_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path to the markdown control files, with directories for each group</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>context</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_context.ControlContext href=../../control_context/#trestle.core.control_context.ControlContext>ControlContext</a></code> </td> <td> <div class=doc-md-description> <p>Context for the operation</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.List>List</span>[<a class="autorefs autorefs-internal" title=trestle.oscal.component.ImplementedRequirement href=../../../oscal/component/#trestle.oscal.component.ImplementedRequirement>ImplementedRequirement</a>]</code> </td> <td> <div class=doc-md-description> <p>List of implemented requirements gathered from each control</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>As the controls are read into the catalog the needed components are added if not already available. avail_comps provides the mapping of component name to the actual component. This is only used during component assemble and only for updating one component</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>read_catalog_imp_reqs</span><span class=p>(</span><span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Read the full set of control implemented requirements from markdown.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        md_path: Path to the markdown control files, with directories for each group</span>
+<span class=sd>        context: Context for the operation</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        List of implemented requirements gathered from each control</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        As the controls are read into the catalog the needed components are added if not already available.</span>
+<span class=sd>        avail_comps provides the mapping of component name to the actual component.</span>
+<span class=sd>        This is only used during component assemble and only for updating one component</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>imp_req_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>group_path</span> <span class=ow>in</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_group_ids_and_dirs</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=k>for</span> <span class=n>control_file</span> <span class=ow>in</span> <span class=n>group_path</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>):</span>
+            <span class=n>sort_id</span><span class=p>,</span> <span class=n>imp_req</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_implemented_requirement</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+            <span class=n>imp_req_map</span><span class=p>[</span><span class=n>sort_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>imp_req</span>
+    <span class=k>return</span> <span class=p>[</span><span class=n>imp_req_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>imp_req_map</span><span class=o>.</span><span class=n>keys</span><span class=p>())]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_reader.CatalogReader.read_ssp_md_content class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_ssp_md_content</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>part_id_map_by_label</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.catalog.catalog_reader.CatalogReader.read_ssp_md_content class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read md content into the ssp.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>md_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>path to the catalog markdown</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>ssp</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.ssp.SystemSecurityPlan href=../../../oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan>SystemSecurityPlan</a></code> </td> <td> <div class=doc-md-description> <p>ssp in which to insert the md content</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>comp_dict</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, <a class="autorefs autorefs-internal" title=trestle.core.generic_oscal.GenericComponent href=../../generic_oscal/#trestle.core.generic_oscal.GenericComponent>GenericComponent</a>]</code> </td> <td> <div class=doc-md-description> <p>map of component name to component</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>part_id_map_by_label</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, <span title=typing.Dict>Dict</span>[str, str]]</code> </td> <td> <div class=doc-md-description> <p>map label to part_id of control</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>context</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_context.ControlContext href=../../control_context/#trestle.core.control_context.ControlContext>ControlContext</a></code> </td> <td> <div class=doc-md-description> <p>control context for the procedure</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>The ssp should already contain info from the comp defs and this fills in selected content from md. The only content read from md is: ssp values in the comp def rules param vals of the header ssp values in the set-params of the header all prose for implementaton responses all status values ssp has components but may not have all needed imp reqs and bycomps know controlid and comp name in comp_dict</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>read_ssp_md_content</span><span class=p>(</span>
+    <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+    <span class=n>comp_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>],</span>
+    <span class=n>part_id_map_by_label</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+    <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Read md content into the ssp.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        md_path: path to the catalog markdown</span>
+<span class=sd>        ssp: ssp in which to insert the md content</span>
+<span class=sd>        comp_dict: map of component name to component</span>
+<span class=sd>        part_id_map_by_label: map label to part_id of control</span>
+<span class=sd>        context: control context for the procedure</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        The ssp should already contain info from the comp defs and this fills in selected content from md.</span>
+<span class=sd>        The only content read from md is:</span>
+<span class=sd>            ssp values in the comp def rules param vals of the header</span>
+<span class=sd>            ssp values in the set-params of the header</span>
+<span class=sd>            all prose for implementaton responses</span>
+<span class=sd>            all status values</span>
+<span class=sd>        ssp has components but may not have all needed imp reqs and bycomps</span>
+<span class=sd>        know controlid and comp name in comp_dict</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>group_path</span> <span class=ow>in</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_group_ids_and_dirs</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=k>for</span> <span class=n>control_file</span> <span class=ow>in</span> <span class=n>group_path</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>):</span>
+            <span class=n>skip</span> <span class=o>=</span> <span class=kc>False</span>
+            <span class=k>for</span> <span class=n>file</span> <span class=ow>in</span> <span class=n>control_file</span><span class=o>.</span><span class=n>parents</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>file</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>INHERITANCE_VIEW_DIR</span><span class=p>:</span>
+                    <span class=n>skip</span> <span class=o>=</span> <span class=kc>True</span>
+                    <span class=k>break</span>
+            <span class=k>if</span> <span class=n>skip</span><span class=p>:</span>
+                <span class=k>continue</span>
+
+            <span class=n>control_id</span> <span class=o>=</span> <span class=n>control_file</span><span class=o>.</span><span class=n>stem</span>
+
+            <span class=n>md_header</span><span class=p>,</span> <span class=n>control_comp_dict</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_read_comp_info_from_md</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+            <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>comp_info_dict</span> <span class=ow>in</span> <span class=n>control_comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>comp_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=p>:</span>
+                    <span class=n>err_msg</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> references component </span><span class=si>{</span><span class=n>comp_name</span><span class=si>}</span><span class=s1> not defined in a component-definition.&#39;</span>  <span class=c1># noqa E501</span>
+                    <span class=c1># give added guidance if no comp defs were specified at command line</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_def_name_list</span><span class=p>:</span>
+                        <span class=n>err_msg</span> <span class=o>+=</span> <span class=s1>&#39;  Please specify the names of any component-definitions needed for assembly.&#39;</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=n>err_msg</span><span class=p>)</span>
+                <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_update_ssp_with_comp_info</span><span class=p>(</span>
+                    <span class=n>ssp</span><span class=p>,</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>],</span> <span class=n>comp_info_dict</span><span class=p>,</span> <span class=n>part_id_map_by_label</span>
+                <span class=p>)</span>
+            <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_update_ssp_with_md_header</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>part_id_map_by_label</span><span class=p>,</span> <span class=n>md_header</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.catalog.catalog_reader-functions>Functions<a href=#trestle.core.catalog.catalog_reader-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/catalog/catalog_writer/index.html b/latest/reference/API/trestle/core/catalog/catalog_writer/index.html
new file mode 100644
index 000000000..bf59bf76a
--- /dev/null
+++ b/latest/reference/API/trestle/core/catalog/catalog_writer/index.html
@@ -0,0 +1,1323 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.catalog.catalog_writer module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_writer/ rel=canonical><link href=../catalog_reader/ rel=prev><link href=../../commands/add/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.catalog.catalog_writer - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.catalog.catalog_writer - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.catalog.catalog_writer module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_writer.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_writer/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.catalog.catalog_writer - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.catalog.catalog_writer module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog/catalog_writer.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.catalog.catalog_writer class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26 checked> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer class=md-nav__link> <span class=md-ellipsis> catalog_writer </span> </a> <nav class=md-nav aria-label=catalog_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter class=md-nav__link> <span class=md-ellipsis> CatalogWriter </span> </a> <nav class=md-nav aria-label=CatalogWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_catalog class=md-nav__link> <span class=md-ellipsis> write_catalog_as_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_component_markdown class=md-nav__link> <span class=md-ellipsis> write_catalog_as_component_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_profile_markdown class=md-nav__link> <span class=md-ellipsis> write_catalog_as_profile_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_ssp_markdown class=md-nav__link> <span class=md-ellipsis> write_catalog_as_ssp_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer class=md-nav__link> <span class=md-ellipsis> catalog_writer </span> </a> <nav class=md-nav aria-label=catalog_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter class=md-nav__link> <span class=md-ellipsis> CatalogWriter </span> </a> <nav class=md-nav aria-label=CatalogWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_catalog class=md-nav__link> <span class=md-ellipsis> write_catalog_as_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_component_markdown class=md-nav__link> <span class=md-ellipsis> write_catalog_as_component_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_profile_markdown class=md-nav__link> <span class=md-ellipsis> write_catalog_as_profile_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_ssp_markdown class=md-nav__link> <span class=md-ellipsis> write_catalog_as_ssp_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog.catalog_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.catalog.catalog_writer</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.catalog.catalog_writer class="doc doc-heading"> <code>trestle.core.catalog.catalog_writer</code> <a href=#trestle.core.catalog.catalog_writer class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Provide interface to write OSCAL catalog to markdown.</p> <div class="doc doc-children"> <h3 id=trestle.core.catalog.catalog_writer-attributes>Attributes<a href=#trestle.core.catalog.catalog_writer-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.catalog.catalog_writer.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.catalog.catalog_writer.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.catalog.catalog_writer-classes>Classes<a href=#trestle.core.catalog.catalog_writer-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.catalog.catalog_writer.CatalogWriter class="doc doc-heading"> <code>CatalogWriter</code> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Catalog writer.</p> <p>Catalog writer handles all operation related to writing catalog to markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogWriter</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Catalog writer.</span>
+
+<span class=sd>    Catalog writer handles all operation related to writing</span>
+<span class=sd>    catalog to markdown.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>:</span> <span class=n>CatalogInterface</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize catalog writer.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>catalog_interface</span>
+
+    <span class=k>def</span> <span class=nf>write_catalog_as_profile_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>md_alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write out the catalog as profile markdown.&quot;&quot;&quot;</span>
+        <span class=c1># Get the list of params for this profile from its set_params</span>
+        <span class=c1># this is just from the set_params</span>
+        <span class=n>profile_set_param_dict</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_full_profile_param_dict</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>profile</span><span class=p>)</span>
+
+        <span class=c1># write out the controls</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>):</span>
+            <span class=c1># here we do special handling of how set-parameters merge with the yaml header</span>
+            <span class=n>new_context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>clone</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+            <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span> <span class=o>=</span> <span class=p>{}</span>
+
+            <span class=n>new_context</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_add_inherited_props_to_header</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+
+            <span class=c1># get all params and vals for this control from the resolved profile catalog with block adds in effect</span>
+            <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+            <span class=n>set_param_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_construct_set_parameters_dict</span><span class=p>(</span><span class=n>profile_set_param_dict</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>set_param_dict</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_set_params_from_cli_yaml_header_to_header</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>set_param_dict</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span>
+
+            <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>:</span>
+                <span class=c1># need to cull any params that are not in control</span>
+                <span class=n>pop_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                        <span class=n>pop_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>pop</span> <span class=ow>in</span> <span class=n>pop_list</span><span class=p>:</span>
+                    <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>pop</span><span class=p>)</span>
+
+            <span class=n>found_control_alters</span> <span class=o>=</span> <span class=p>[</span><span class=n>alter</span> <span class=k>for</span> <span class=n>alter</span> <span class=ow>in</span> <span class=n>md_alters</span> <span class=k>if</span> <span class=n>alter</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>_write_control_into_dir</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>found_control_alters</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_inherited_props_to_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ControlContext</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add inherited props to the merged header under inherited tag.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>inherited_props</span><span class=p>:</span>
+            <span class=n>inherited_props</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>inherited_props</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>inherited_props</span><span class=p>:</span>
+                <span class=c1># build set in order of list so that duplicates will have final value stick, then convert to list</span>
+                <span class=n>unique_props</span> <span class=o>=</span> <span class=nb>list</span><span class=p>({</span><span class=n>prop</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]:</span> <span class=n>prop</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>inherited_props</span><span class=p>}</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_INHERITED_PROPS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>unique_props</span>
+
+        <span class=k>return</span> <span class=n>context</span>
+
+    <span class=k>def</span> <span class=nf>_add_set_params_from_cli_yaml_header_to_header</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>set_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>control_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span>
+    <span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Add set parameters from the provided cli yaml header to the merged header.</span>
+
+<span class=sd>        If overwrite-header-value flag is given</span>
+<span class=sd>            - Set-parameters in set_param_dict will be overwritten with those in cli yaml header</span>
+<span class=sd>            - No new params from the cli yaml header will be added &lt;- TODO: Is this correct?</span>
+<span class=sd>        If ohv flag is NOT given :</span>
+<span class=sd>            - Set-parameters from the cli yaml header will be added</span>
+<span class=sd>            - Will not overwrite params that are already in set_param_dict</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>:</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>overwrite_header_values</span><span class=p>:</span>
+                <span class=c1># update the control params with new values</span>
+                <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                        <span class=n>set_param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>value</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># update the control params with any values in yaml header not set in control</span>
+                <span class=c1># need to maintain order in the set_param_dict</span>
+                <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>control_param_dict</span> <span class=ow>and</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>set_param_dict</span><span class=p>:</span>
+                        <span class=n>set_param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>value</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>set_param_dict</span>
+
+    <span class=k>def</span> <span class=nf>_construct_set_parameters_dict</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>profile_set_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span>
+        <span class=n>control_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]],</span>
+        <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Build set-parameters dictionary from the given profile.modify.set-parameters and control.params.</span>
+
+<span class=sd>        Resulting dictionary will have:</span>
+<span class=sd>        - All parameters from the control where:</span>
+<span class=sd>            - If control_param in profile.modify.set_params:</span>
+<span class=sd>                - Display name (if exists) - from profile</span>
+<span class=sd>                - Profile-values - from profile</span>
+<span class=sd>                - Values - from control</span>
+<span class=sd>            - If control_param is not in profile.modify.set_params:</span>
+<span class=sd>                - Values - from control</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>set_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>param_id</span><span class=p>,</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=c1># if the param is in the full_param_dict, load its contents first and mark as profile-values</span>
+            <span class=n>display_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=n>param_value_origin</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_param_value_origin_and_ns</span><span class=p>(</span><span class=n>param_dict</span><span class=p>)</span>
+            <span class=n>prof_param_value_origin</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=k>if</span> <span class=n>param_id</span> <span class=ow>in</span> <span class=n>profile_set_param_dict</span><span class=p>:</span>
+                <span class=c1># get the param from the profile set_param</span>
+                <span class=n>param</span> <span class=o>=</span> <span class=n>profile_set_param_dict</span><span class=p>[</span><span class=n>param_id</span><span class=p>]</span>
+                <span class=n>display_name</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_display_name_and_ns</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+                <span class=n>prof_param_value_origin</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_param_value_origin_and_ns</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+                <span class=c1># assign its contents to the dict</span>
+                <span class=n>new_dict</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>parameter_to_dict</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>VALUES</span> <span class=ow>in</span> <span class=n>new_dict</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+                        <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>]</span>
+                        <span class=n>new_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>)</span>
+                <span class=c1># validates if parent profile has param-value-origin field</span>
+                <span class=k>if</span> <span class=n>param_value_origin</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>param_value_origin</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+                        <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_value_origin</span>
+                <span class=c1># validates if current profile has param-value-origin field and</span>
+                <span class=c1># adds it to prof-param-value-origin</span>
+                <span class=k>if</span> <span class=n>prof_param_value_origin</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>prof_param_value_origin</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>)]:</span>
+                            <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>]</span> <span class=o>=</span> <span class=n>prof_param_value_origin</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>)]:</span>
+                        <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME_PLACEHOLDER</span>
+                <span class=c1># then insert the original, incoming values as values</span>
+                <span class=k>if</span> <span class=n>param_id</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                    <span class=n>orig_param</span> <span class=o>=</span> <span class=n>control_param_dict</span><span class=p>[</span><span class=n>param_id</span><span class=p>]</span>
+                    <span class=n>orig_dict</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>parameter_to_dict</span><span class=p>(</span><span class=n>orig_param</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+                    <span class=c1># pull only the values from the actual control dict</span>
+                    <span class=c1># all the other elements are from the profile set_param</span>
+                    <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>]</span> <span class=o>=</span> <span class=n>orig_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                    <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>GUIDELINES</span><span class=p>]</span> <span class=o>=</span> <span class=n>orig_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>GUIDELINES</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>]</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=n>new_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>GUIDELINES</span><span class=p>]</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=n>new_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>GUIDELINES</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span> <span class=ow>in</span> <span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>orig_param</span><span class=o>.</span><span class=n>props</span><span class=p>)]:</span>
+                        <span class=n>new_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># if the profile doesnt change this param at all, show it in the header with values</span>
+                <span class=n>tmp_dict</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>parameter_to_dict</span><span class=p>(</span><span class=n>param_dict</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+                <span class=n>values</span> <span class=o>=</span> <span class=n>tmp_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;values&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=c1># if values are None then don´t display them in the markdown</span>
+                <span class=k>if</span> <span class=n>values</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>new_dict</span> <span class=o>=</span> <span class=p>{</span>
+                        <span class=s1>&#39;id&#39;</span><span class=p>:</span> <span class=n>param_id</span><span class=p>,</span>
+                        <span class=s1>&#39;values&#39;</span><span class=p>:</span> <span class=n>values</span><span class=p>,</span>
+                    <span class=p>}</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>new_dict</span> <span class=o>=</span> <span class=p>{</span>
+                        <span class=s1>&#39;id&#39;</span><span class=p>:</span> <span class=n>param_id</span><span class=p>,</span>
+                    <span class=p>}</span>
+                <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>]</span> <span class=o>=</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME_PLACEHOLDER</span><span class=p>]</span>
+                <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span><span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME_PLACEHOLDER</span>
+            <span class=k>if</span> <span class=n>param_value_origin</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+                    <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>]</span> <span class=o>=</span> <span class=n>param_value_origin</span>
+            <span class=n>new_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;id&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=c1># validates if there are aggregated parameter values to the current parameter</span>
+            <span class=n>aggregated_props</span> <span class=o>=</span> <span class=p>[</span><span class=n>prop</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param_dict</span><span class=o>.</span><span class=n>props</span><span class=p>)</span> <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>aggregated_props</span> <span class=o>!=</span> <span class=p>[]:</span>
+                <span class=n>props_to_add</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>aggregated_props</span><span class=p>:</span>
+                    <span class=n>props_to_add</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+                <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span><span class=p>]</span> <span class=o>=</span> <span class=n>props_to_add</span>
+                <span class=n>new_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=n>alt_identifier</span> <span class=o>=</span> <span class=p>[</span><span class=n>prop</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param_dict</span><span class=o>.</span><span class=n>props</span><span class=p>)</span> <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ALT_IDENTIFIER</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>alt_identifier</span> <span class=o>!=</span> <span class=p>[]:</span>
+                <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>ALT_IDENTIFIER</span><span class=p>]</span> <span class=o>=</span> <span class=n>alt_identifier</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>value</span>
+            <span class=c1># adds display name, if no display name then do not add to dict</span>
+            <span class=k>if</span> <span class=n>display_name</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>display_name</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>new_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>]</span> <span class=o>=</span> <span class=n>display_name</span>
+            <span class=n>key_order</span> <span class=o>=</span> <span class=p>(</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>LABEL</span><span class=p>,</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>GUIDELINES</span><span class=p>,</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>,</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span><span class=p>,</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>ALT_IDENTIFIER</span><span class=p>,</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>,</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>PROFILE_VALUES</span><span class=p>,</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUE_ORIGIN</span><span class=p>,</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>PROFILE_PARAM_VALUE_ORIGIN</span>
+            <span class=p>)</span>
+            <span class=n>ordered_dict</span> <span class=o>=</span> <span class=p>{</span><span class=n>k</span><span class=p>:</span> <span class=n>new_dict</span><span class=p>[</span><span class=n>k</span><span class=p>]</span> <span class=k>for</span> <span class=n>k</span> <span class=ow>in</span> <span class=n>key_order</span> <span class=k>if</span> <span class=n>k</span> <span class=ow>in</span> <span class=n>new_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>()}</span>
+            <span class=n>set_param_dict</span><span class=p>[</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>ordered_dict</span>
+
+        <span class=k>return</span> <span class=n>set_param_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_fixup_param_dicts</span><span class=p>(</span><span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge info in the rules params dict and the rules param vals dict.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>comp_dict</span> <span class=ow>in</span> <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>rules_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=p>{})</span>
+            <span class=k>for</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>params_list</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>params_list</span><span class=p>:</span>
+                    <span class=n>rule_name</span> <span class=o>=</span> <span class=n>deep_get</span><span class=p>(</span><span class=n>rules_dict</span><span class=p>,</span> <span class=p>[</span><span class=n>rule_id</span><span class=p>,</span> <span class=s1>&#39;name&#39;</span><span class=p>],</span> <span class=s1>&#39;unknown_rule_name&#39;</span><span class=p>)</span>
+                    <span class=n>param</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>HEADER_RULE_ID</span><span class=p>]</span> <span class=o>=</span> <span class=n>rule_name</span>
+
+    <span class=k>def</span> <span class=nf>write_catalog_as_ssp_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Write out the catalog as component markdown.</span>
+
+<span class=sd>        Already have resolved profile catalog, but with no setparams from compdefs</span>
+<span class=sd>        Load all control level rules and param values based on compdefs and profile values</span>
+
+<span class=sd>        In memory:</span>
+<span class=sd>        for each compdef:</span>
+<span class=sd>            for each comp:</span>
+<span class=sd>                load top level rules</span>
+<span class=sd>                for each control_imp:</span>
+<span class=sd>                    load set-params</span>
+<span class=sd>                    for each imp_req (bound to 1 control):</span>
+<span class=sd>                        load set-params</span>
+<span class=sd>                        load control level rules and status</span>
+<span class=sd>                        load part level rules and status</span>
+<span class=sd>                        add as compinfo to control comp_dict</span>
+
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># generate rule and param info from the components</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>generate_control_rule_info</span><span class=p>(</span><span class=n>part_id_map</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+        <span class=c1># now have all rules in context.rules_dict and all rules_params in context.rules_params_dict</span>
+        <span class=c1># all set-params per component for each control are in the cat interface</span>
+        <span class=c1># all comp-infos by control and part are in the cat interface</span>
+        <span class=c1>#</span>
+        <span class=c1># can now write out catalog and pull from the markdown:</span>
+        <span class=c1># header for param values to set during assem</span>
+        <span class=c1># prose and status for This System</span>
+        <span class=c1># status for all parts that still have rules</span>
+
+        <span class=n>CatalogWriter</span><span class=o>.</span><span class=n>_fixup_param_dicts</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+
+        <span class=c1># remove items left after above loop</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=o>=</span> <span class=kc>None</span>
+
+        <span class=c1># get param_dict of set_params in profile</span>
+        <span class=n>profile_set_param_dict</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_full_profile_param_dict</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>profile</span><span class=p>)</span>
+        <span class=n>catalog_merger</span> <span class=o>=</span> <span class=n>CatalogMerger</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_control_comp_dicts</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+            <span class=n>control_file_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_file_path</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+            <span class=n>control_file_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+            <span class=c1># the catalog interface is from the resolved profile catalog</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+            <span class=n>set_param_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_construct_set_parameters_dict</span><span class=p>(</span><span class=n>profile_set_param_dict</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+            <span class=n>new_context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>clone</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>set_param_dict</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_set_params_from_cli_yaml_header_to_header</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>set_param_dict</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span>
+
+            <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>:</span>
+                <span class=c1># need to cull any params that are not in control</span>
+                <span class=n>pop_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                        <span class=n>pop_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>pop</span> <span class=ow>in</span> <span class=n>pop_list</span><span class=p>:</span>
+                    <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>pop</span><span class=p>)</span>
+
+            <span class=c1># merge the md_header and md_comp_dict with info in cat_interface for this control in new_context</span>
+            <span class=n>catalog_merger</span><span class=o>.</span><span class=n>_merge_header_and_comp_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>control_file_path</span><span class=p>,</span> <span class=n>new_context</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>param_list</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>for</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>param_list</span><span class=p>:</span>
+                        <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>HEADER_RULE_ID</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+
+            <span class=n>control_writer</span> <span class=o>=</span> <span class=n>ControlWriter</span><span class=p>()</span>
+            <span class=n>control_writer</span><span class=o>.</span><span class=n>write_control_for_editing</span><span class=p>(</span>
+                <span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>control_file_path</span><span class=o>.</span><span class=n>parent</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=p>[]</span>
+            <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>write_catalog_as_component_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write out the catalog as component markdown.&quot;&quot;&quot;</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span> <span class=o>=</span> <span class=p>{}</span>
+
+        <span class=k>def</span> <span class=nf>_update_values</span><span class=p>(</span><span class=n>set_param</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=c1># set the param values based on the control_param_dict if available</span>
+            <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                <span class=n>control_param_dict</span><span class=p>[</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>set_param</span>
+
+        <span class=n>control_ids_in_comp_imp</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>)</span>
+        <span class=p>]</span>
+
+        <span class=n>missing_controls</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>control_ids_in_comp_imp</span><span class=p>)</span><span class=o>.</span><span class=n>difference</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_ids</span><span class=p>())</span>
+        <span class=k>if</span> <span class=n>missing_controls</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Component </span><span class=si>{</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=si>}</span><span class=s1> references controls </span><span class=si>{</span><span class=n>missing_controls</span><span class=si>}</span><span class=s1> not in profile.&#39;</span><span class=p>)</span>
+
+        <span class=c1># get top level rule info applying to all controls</span>
+        <span class=n>comp_rules_dict</span><span class=p>,</span> <span class=n>comp_rules_params_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>component</span><span class=p>)</span>  <span class=c1># noqa E501</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>comp_rules_dict</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>comp_rules_params_dict</span>
+        <span class=k>for</span> <span class=n>control_imp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>):</span>
+            <span class=n>control_imp_rules_dict</span><span class=p>,</span> <span class=n>control_imp_rules_params_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>control_imp</span><span class=p>)</span>  <span class=c1># noqa E501</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>control_imp_rules_dict</span><span class=p>)</span>
+            <span class=n>comp_rules_params_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=p>{})</span>
+            <span class=n>comp_rules_params_dict</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>control_imp_rules_params_dict</span><span class=p>)</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>comp_rules_params_dict</span><span class=p>)</span>
+            <span class=n>ci_set_params</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_set_params_from_item</span><span class=p>(</span><span class=n>control_imp</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+                <span class=n>control_part_id_map</span> <span class=o>=</span> <span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+                <span class=n>control_rules</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+                <span class=n>comp_info</span> <span class=o>=</span> <span class=n>ComponentImpInfo</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>description</span><span class=p>,</span> <span class=n>control_rules</span><span class=p>,</span> <span class=p>[],</span> <span class=n>status</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>add_comp_info</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>)</span>
+                <span class=n>set_params</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>ci_set_params</span><span class=p>)</span>
+                <span class=n>set_params</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_set_params_from_item</span><span class=p>(</span><span class=n>imp_req</span><span class=p>))</span>
+                <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>set_params</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>add_comp_set_param</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>set_param</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                    <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>control_part_id_map</span><span class=p>:</span>
+                        <span class=n>label</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No statement label found for statement id </span><span class=si>{</span><span class=n>label</span><span class=si>}</span><span class=s1>.  Defaulting to </span><span class=si>{</span><span class=n>label</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>label</span> <span class=o>=</span> <span class=n>control_part_id_map</span><span class=p>[</span><span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span><span class=p>]</span>
+                    <span class=n>rule_list</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+                    <span class=n>comp_info</span> <span class=o>=</span> <span class=n>ComponentImpInfo</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>description</span><span class=p>,</span> <span class=n>rule_list</span><span class=p>,</span> <span class=p>[],</span> <span class=n>status</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>add_comp_info</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>)</span>
+
+        <span class=n>catalog_merger</span> <span class=o>=</span> <span class=n>CatalogMerger</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=ow>in</span> <span class=n>control_ids_in_comp_imp</span><span class=p>:</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_comp_info</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+                <span class=n>new_context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>clone</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+                <span class=c1># get the resolved catalog values for the control params</span>
+                <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+                <span class=c1># update them with values in the ci</span>
+                <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>new_context</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                    <span class=n>_update_values</span><span class=p>(</span><span class=n>set_param</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span>
+                <span class=c1># update them with values in the imp_req</span>
+                <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>new_context</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                        <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                            <span class=n>_update_values</span><span class=p>(</span><span class=n>set_param</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span>
+
+                <span class=c1># insert the param values into the header</span>
+                <span class=k>if</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                    <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUES_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+                    <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                        <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUES_TAG</span><span class=p>][</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span>
+                            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str_list</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+                        <span class=p>)</span>
+                <span class=c1># merge the md_header and md_comp_dict with info in cat_interface for this control</span>
+                <span class=n>control_file_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_file_path</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+                <span class=n>catalog_merger</span><span class=o>.</span><span class=n>_merge_header_and_comp_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>control_file_path</span><span class=p>,</span> <span class=n>new_context</span><span class=p>)</span>
+
+                <span class=bp>self</span><span class=o>.</span><span class=n>_write_control_into_dir</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=p>[])</span>
+
+    <span class=k>def</span> <span class=nf>write_catalog_as_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write the catalog as a simple catalog.&quot;&quot;&quot;</span>
+        <span class=c1># write out the controls</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>):</span>
+            <span class=c1># here we do special handling of how set-parameters merge with the yaml header</span>
+            <span class=n>new_context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>clone</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+
+            <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+            <span class=n>set_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>for</span> <span class=n>param_id</span><span class=p>,</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=n>tmp_dict</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>parameter_to_dict</span><span class=p>(</span><span class=n>param_dict</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+                <span class=n>values</span> <span class=o>=</span> <span class=n>tmp_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;values&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=n>new_dict</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;values&#39;</span><span class=p>:</span> <span class=n>values</span><span class=p>}</span>
+                <span class=n>set_param_dict</span><span class=p>[</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_dict</span>
+            <span class=k>if</span> <span class=n>set_param_dict</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>:</span>
+                    <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+                <span class=k>if</span> <span class=n>new_context</span><span class=o>.</span><span class=n>overwrite_header_values</span><span class=p>:</span>
+                    <span class=c1># update the control params with new values</span>
+                    <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                        <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                            <span class=n>set_param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>value</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=c1># update the control params with any values in yaml header not set in control</span>
+                    <span class=c1># need to maintain order in the set_param_dict</span>
+                    <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                        <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>control_param_dict</span> <span class=ow>and</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>set_param_dict</span><span class=p>:</span>
+                            <span class=n>set_param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>value</span>
+                <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>set_param_dict</span>
+            <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>:</span>
+                <span class=c1># need to cull any params that are not in control</span>
+                <span class=n>pop_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                        <span class=n>pop_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>pop</span> <span class=ow>in</span> <span class=n>pop_list</span><span class=p>:</span>
+                    <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>pop</span><span class=p>)</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>_write_control_into_dir</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=p>[])</span>
+
+    <span class=k>def</span> <span class=nf>_write_control_into_dir</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span>
+        <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+        <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+        <span class=n>found_control_alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span>
+    <span class=p>):</span>
+        <span class=c1># we need to create the dir structure on demand because we don&#39;t know a priori what groups are included</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=n>group_dir</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>md_root</span>
+        <span class=n>control_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_path</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>sub_dir</span> <span class=ow>in</span> <span class=n>control_path</span><span class=p>:</span>
+            <span class=n>group_dir</span> <span class=o>=</span> <span class=n>group_dir</span> <span class=o>/</span> <span class=n>sub_dir</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>group_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=n>group_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+        <span class=n>writer</span> <span class=o>=</span> <span class=n>ControlWriter</span><span class=p>()</span>
+        <span class=n>writer</span><span class=o>.</span><span class=n>write_control_for_editing</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>group_dir</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>found_control_alters</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.catalog.catalog_writer.CatalogWriter-functions>Functions<a href=#trestle.core.catalog.catalog_writer.CatalogWriter-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_writer.CatalogWriter.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>catalog_interface</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize catalog writer.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>:</span> <span class=n>CatalogInterface</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize catalog writer.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>catalog_interface</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_catalog_as_catalog</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write the catalog as a simple catalog.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_catalog_as_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write the catalog as a simple catalog.&quot;&quot;&quot;</span>
+    <span class=c1># write out the controls</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>):</span>
+        <span class=c1># here we do special handling of how set-parameters merge with the yaml header</span>
+        <span class=n>new_context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>clone</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+
+        <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>set_param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>param_id</span><span class=p>,</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>tmp_dict</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>parameter_to_dict</span><span class=p>(</span><span class=n>param_dict</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+            <span class=n>values</span> <span class=o>=</span> <span class=n>tmp_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;values&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=n>new_dict</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;values&#39;</span><span class=p>:</span> <span class=n>values</span><span class=p>}</span>
+            <span class=n>set_param_dict</span><span class=p>[</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_dict</span>
+        <span class=k>if</span> <span class=n>set_param_dict</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>:</span>
+                <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>if</span> <span class=n>new_context</span><span class=o>.</span><span class=n>overwrite_header_values</span><span class=p>:</span>
+                <span class=c1># update the control params with new values</span>
+                <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                        <span class=n>set_param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>value</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># update the control params with any values in yaml header not set in control</span>
+                <span class=c1># need to maintain order in the set_param_dict</span>
+                <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>control_param_dict</span> <span class=ow>and</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>set_param_dict</span><span class=p>:</span>
+                        <span class=n>set_param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>value</span>
+            <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>set_param_dict</span>
+        <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>:</span>
+            <span class=c1># need to cull any params that are not in control</span>
+            <span class=n>pop_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                    <span class=n>pop_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>pop</span> <span class=ow>in</span> <span class=n>pop_list</span><span class=p>:</span>
+                <span class=n>new_context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>pop</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_write_control_into_dir</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=p>[])</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_component_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_catalog_as_component_markdown</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_component_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write out the catalog as component markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_catalog_as_component_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write out the catalog as component markdown.&quot;&quot;&quot;</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=k>def</span> <span class=nf>_update_values</span><span class=p>(</span><span class=n>set_param</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=c1># set the param values based on the control_param_dict if available</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+            <span class=n>control_param_dict</span><span class=p>[</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>set_param</span>
+
+    <span class=n>control_ids_in_comp_imp</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>)</span>
+    <span class=p>]</span>
+
+    <span class=n>missing_controls</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>control_ids_in_comp_imp</span><span class=p>)</span><span class=o>.</span><span class=n>difference</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_ids</span><span class=p>())</span>
+    <span class=k>if</span> <span class=n>missing_controls</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Component </span><span class=si>{</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=si>}</span><span class=s1> references controls </span><span class=si>{</span><span class=n>missing_controls</span><span class=si>}</span><span class=s1> not in profile.&#39;</span><span class=p>)</span>
+
+    <span class=c1># get top level rule info applying to all controls</span>
+    <span class=n>comp_rules_dict</span><span class=p>,</span> <span class=n>comp_rules_params_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>component</span><span class=p>)</span>  <span class=c1># noqa E501</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>comp_rules_dict</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=n>comp_rules_params_dict</span>
+    <span class=k>for</span> <span class=n>control_imp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>):</span>
+        <span class=n>control_imp_rules_dict</span><span class=p>,</span> <span class=n>control_imp_rules_params_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>control_imp</span><span class=p>)</span>  <span class=c1># noqa E501</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>control_imp_rules_dict</span><span class=p>)</span>
+        <span class=n>comp_rules_params_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>comp_rules_params_dict</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>control_imp_rules_params_dict</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>[</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>]</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>comp_rules_params_dict</span><span class=p>)</span>
+        <span class=n>ci_set_params</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_set_params_from_item</span><span class=p>(</span><span class=n>control_imp</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=n>control_part_id_map</span> <span class=o>=</span> <span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+            <span class=n>control_rules</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+            <span class=n>comp_info</span> <span class=o>=</span> <span class=n>ComponentImpInfo</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>description</span><span class=p>,</span> <span class=n>control_rules</span><span class=p>,</span> <span class=p>[],</span> <span class=n>status</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>add_comp_info</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>)</span>
+            <span class=n>set_params</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>ci_set_params</span><span class=p>)</span>
+            <span class=n>set_params</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_set_params_from_item</span><span class=p>(</span><span class=n>imp_req</span><span class=p>))</span>
+            <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>set_params</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>add_comp_set_param</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>set_param</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>control_part_id_map</span><span class=p>:</span>
+                    <span class=n>label</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No statement label found for statement id </span><span class=si>{</span><span class=n>label</span><span class=si>}</span><span class=s1>.  Defaulting to </span><span class=si>{</span><span class=n>label</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>label</span> <span class=o>=</span> <span class=n>control_part_id_map</span><span class=p>[</span><span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span><span class=p>]</span>
+                <span class=n>rule_list</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+                <span class=n>comp_info</span> <span class=o>=</span> <span class=n>ComponentImpInfo</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>description</span><span class=p>,</span> <span class=n>rule_list</span><span class=p>,</span> <span class=p>[],</span> <span class=n>status</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>add_comp_info</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>)</span>
+
+    <span class=n>catalog_merger</span> <span class=o>=</span> <span class=n>CatalogMerger</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=ow>in</span> <span class=n>control_ids_in_comp_imp</span><span class=p>:</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_comp_info</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=n>new_context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>clone</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+            <span class=c1># get the resolved catalog values for the control params</span>
+            <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+            <span class=c1># update them with values in the ci</span>
+            <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>new_context</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                <span class=n>_update_values</span><span class=p>(</span><span class=n>set_param</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span>
+            <span class=c1># update them with values in the imp_req</span>
+            <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>new_context</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                        <span class=n>_update_values</span><span class=p>(</span><span class=n>set_param</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span>
+
+            <span class=c1># insert the param values into the header</span>
+            <span class=k>if</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUES_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+                <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PARAM_VALUES_TAG</span><span class=p>][</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span>
+                        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str_list</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+                    <span class=p>)</span>
+            <span class=c1># merge the md_header and md_comp_dict with info in cat_interface for this control</span>
+            <span class=n>control_file_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_file_path</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=n>catalog_merger</span><span class=o>.</span><span class=n>_merge_header_and_comp_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>control_file_path</span><span class=p>,</span> <span class=n>new_context</span><span class=p>)</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>_write_control_into_dir</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=p>[])</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_profile_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_catalog_as_profile_markdown</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>md_alters</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_profile_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write out the catalog as profile markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_catalog_as_profile_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>md_alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write out the catalog as profile markdown.&quot;&quot;&quot;</span>
+    <span class=c1># Get the list of params for this profile from its set_params</span>
+    <span class=c1># this is just from the set_params</span>
+    <span class=n>profile_set_param_dict</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_full_profile_param_dict</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>profile</span><span class=p>)</span>
+
+    <span class=c1># write out the controls</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=kc>True</span><span class=p>):</span>
+        <span class=c1># here we do special handling of how set-parameters merge with the yaml header</span>
+        <span class=n>new_context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>clone</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+        <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span> <span class=o>=</span> <span class=p>{}</span>
+
+        <span class=n>new_context</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_add_inherited_props_to_header</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+
+        <span class=c1># get all params and vals for this control from the resolved profile catalog with block adds in effect</span>
+        <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>set_param_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_construct_set_parameters_dict</span><span class=p>(</span><span class=n>profile_set_param_dict</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>set_param_dict</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_set_params_from_cli_yaml_header_to_header</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>set_param_dict</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span>
+
+        <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>:</span>
+            <span class=c1># need to cull any params that are not in control</span>
+            <span class=n>pop_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                    <span class=n>pop_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>pop</span> <span class=ow>in</span> <span class=n>pop_list</span><span class=p>:</span>
+                <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>pop</span><span class=p>)</span>
+
+        <span class=n>found_control_alters</span> <span class=o>=</span> <span class=p>[</span><span class=n>alter</span> <span class=k>for</span> <span class=n>alter</span> <span class=ow>in</span> <span class=n>md_alters</span> <span class=k>if</span> <span class=n>alter</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_write_control_into_dir</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>found_control_alters</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_ssp_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_catalog_as_ssp_markdown</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>)</span></code> <a href=#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_ssp_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write out the catalog as component markdown.</p> <p>Already have resolved profile catalog, but with no setparams from compdefs Load all control level rules and param values based on compdefs and profile values</p> <p>In memory: for each compdef: for each comp: load top level rules for each control_imp: load set-params for each imp_req (bound to 1 control): load set-params load control level rules and status load part level rules and status add as compinfo to control comp_dict</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog/catalog_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_catalog_as_ssp_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Write out the catalog as component markdown.</span>
+
+<span class=sd>    Already have resolved profile catalog, but with no setparams from compdefs</span>
+<span class=sd>    Load all control level rules and param values based on compdefs and profile values</span>
+
+<span class=sd>    In memory:</span>
+<span class=sd>    for each compdef:</span>
+<span class=sd>        for each comp:</span>
+<span class=sd>            load top level rules</span>
+<span class=sd>            for each control_imp:</span>
+<span class=sd>                load set-params</span>
+<span class=sd>                for each imp_req (bound to 1 control):</span>
+<span class=sd>                    load set-params</span>
+<span class=sd>                    load control level rules and status</span>
+<span class=sd>                    load part level rules and status</span>
+<span class=sd>                    add as compinfo to control comp_dict</span>
+
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># generate rule and param info from the components</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>generate_control_rule_info</span><span class=p>(</span><span class=n>part_id_map</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+    <span class=c1># now have all rules in context.rules_dict and all rules_params in context.rules_params_dict</span>
+    <span class=c1># all set-params per component for each control are in the cat interface</span>
+    <span class=c1># all comp-infos by control and part are in the cat interface</span>
+    <span class=c1>#</span>
+    <span class=c1># can now write out catalog and pull from the markdown:</span>
+    <span class=c1># header for param values to set during assem</span>
+    <span class=c1># prose and status for This System</span>
+    <span class=c1># status for all parts that still have rules</span>
+
+    <span class=n>CatalogWriter</span><span class=o>.</span><span class=n>_fixup_param_dicts</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+
+    <span class=c1># remove items left after above loop</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=c1># get param_dict of set_params in profile</span>
+    <span class=n>profile_set_param_dict</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=o>.</span><span class=n>_get_full_profile_param_dict</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>profile</span><span class=p>)</span>
+    <span class=n>catalog_merger</span> <span class=o>=</span> <span class=n>CatalogMerger</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_control_comp_dicts</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>control_file_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_file_path</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+        <span class=n>control_file_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># the catalog interface is from the resolved profile catalog</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=n>control_param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>set_param_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_construct_set_parameters_dict</span><span class=p>(</span><span class=n>profile_set_param_dict</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+        <span class=n>new_context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>clone</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>set_param_dict</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_set_params_from_cli_yaml_header_to_header</span><span class=p>(</span><span class=n>new_context</span><span class=p>,</span> <span class=n>set_param_dict</span><span class=p>,</span> <span class=n>control_param_dict</span><span class=p>)</span>
+
+        <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>:</span>
+            <span class=c1># need to cull any params that are not in control</span>
+            <span class=n>pop_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>control_param_dict</span><span class=p>:</span>
+                    <span class=n>pop_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>pop</span> <span class=ow>in</span> <span class=n>pop_list</span><span class=p>:</span>
+                <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>pop</span><span class=p>)</span>
+
+        <span class=c1># merge the md_header and md_comp_dict with info in cat_interface for this control in new_context</span>
+        <span class=n>catalog_merger</span><span class=o>.</span><span class=n>_merge_header_and_comp_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>control_file_path</span><span class=p>,</span> <span class=n>new_context</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>param_list</span> <span class=ow>in</span> <span class=n>new_context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>for</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>param_list</span><span class=p>:</span>
+                    <span class=n>param_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>HEADER_RULE_ID</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+
+        <span class=n>control_writer</span> <span class=o>=</span> <span class=n>ControlWriter</span><span class=p>()</span>
+        <span class=n>control_writer</span><span class=o>.</span><span class=n>write_control_for_editing</span><span class=p>(</span>
+            <span class=n>new_context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>control_file_path</span><span class=o>.</span><span class=n>parent</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=p>[]</span>
+        <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.catalog.catalog_writer-functions>Functions<a href=#trestle.core.catalog.catalog_writer-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/catalog_validator/index.html b/latest/reference/API/trestle/core/catalog_validator/index.html
new file mode 100644
index 000000000..716310906
--- /dev/null
+++ b/latest/reference/API/trestle/core/catalog_validator/index.html
@@ -0,0 +1,121 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.catalog_validator module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog_validator/ rel=canonical><link href=../base_model/ rel=prev><link href=../control_context/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.catalog_validator - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.catalog_validator - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.catalog_validator module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog_validator.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog_validator/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.catalog_validator - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.catalog_validator module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/catalog_validator.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.catalog_validator class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.catalog_validator </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.catalog_validator </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog_validator class=md-nav__link> <span class=md-ellipsis> catalog_validator </span> </a> <nav class=md-nav aria-label=catalog_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator.CatalogValidator class=md-nav__link> <span class=md-ellipsis> CatalogValidator </span> </a> <nav class=md-nav aria-label=CatalogValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator.CatalogValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator.CatalogValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog_validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.catalog_validator class=md-nav__link> <span class=md-ellipsis> catalog_validator </span> </a> <nav class=md-nav aria-label=catalog_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator.CatalogValidator class=md-nav__link> <span class=md-ellipsis> CatalogValidator </span> </a> <nav class=md-nav aria-label=CatalogValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator.CatalogValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.catalog_validator.CatalogValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.catalog_validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.catalog_validator</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.catalog_validator class="doc doc-heading"> <code>trestle.core.catalog_validator</code> <a href=#trestle.core.catalog_validator class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Validate catalog by confirming no duplicate param ids.</p> <div class="doc doc-children"> <h3 id=trestle.core.catalog_validator-attributes>Attributes<a href=#trestle.core.catalog_validator-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.catalog_validator.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.catalog_validator.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.catalog_validator-classes>Classes<a href=#trestle.core.catalog_validator-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.catalog_validator.CatalogValidator class="doc doc-heading"> <code>CatalogValidator</code> <a href=#trestle.core.catalog_validator.CatalogValidator class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.validator.Validator href=../validator/#trestle.core.validator.Validator>Validator</a></code></p> <p>Validator to confirm all param ids in catalog are unique.</p> <details class=quote> <summary>Source code in <code>trestle/core/catalog_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogValidator</span><span class=p>(</span><span class=n>Validator</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validator to confirm all param ids in catalog are unique.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Test if the model is valid.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            model: A top level OSCAL model.</span>
+<span class=sd>            quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>        returns:</span>
+<span class=sd>            True (valid) if it is not a catalog, or it is a catalog and its links are 1:1 with resources.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>Catalog</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=n>catalog</span><span class=p>:</span> <span class=n>Catalog</span> <span class=o>=</span> <span class=n>model</span>
+        <span class=n>cat_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+        <span class=n>param_ids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span> <span class=ow>in</span> <span class=n>param_ids</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Catalog has duplicated parameter id: </span><span class=si>{</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> in control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>return</span> <span class=kc>False</span>
+                <span class=n>param_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>param_id</span> <span class=ow>in</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>loose_param_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>param_id</span> <span class=ow>in</span> <span class=n>param_ids</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Catalog has duplicated parameter id: </span><span class=si>{</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> in control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.catalog_validator.CatalogValidator-functions>Functions<a href=#trestle.core.catalog_validator.CatalogValidator-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.catalog_validator.CatalogValidator.model_is_valid class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.catalog_validator.CatalogValidator.model_is_valid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Test if the model is valid.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.common_types.TopLevelOscalModel href=../../common/common_types/#trestle.common.common_types.TopLevelOscalModel>TopLevelOscalModel</a></code> </td> <td> <div class=doc-md-description> <p>A top level OSCAL model.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>quiet</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Don't report msgs unless invalid.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>True (valid) if it is not a catalog, or it is a catalog and its links are 1:1 with resources.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/catalog_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Test if the model is valid.</span>
+
+<span class=sd>    args:</span>
+<span class=sd>        model: A top level OSCAL model.</span>
+<span class=sd>        quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>    returns:</span>
+<span class=sd>        True (valid) if it is not a catalog, or it is a catalog and its links are 1:1 with resources.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>Catalog</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=n>catalog</span><span class=p>:</span> <span class=n>Catalog</span> <span class=o>=</span> <span class=n>model</span>
+    <span class=n>cat_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+    <span class=n>param_ids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+        <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span> <span class=ow>in</span> <span class=n>param_ids</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Catalog has duplicated parameter id: </span><span class=si>{</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> in control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+            <span class=n>param_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>param_id</span> <span class=ow>in</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>loose_param_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>param_id</span> <span class=ow>in</span> <span class=n>param_ids</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Catalog has duplicated parameter id: </span><span class=si>{</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> in control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.catalog_validator-functions>Functions<a href=#trestle.core.catalog_validator-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/add/index.html b/latest/reference/API/trestle/core/commands/add/index.html
new file mode 100644
index 000000000..15413ff70
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/add/index.html
@@ -0,0 +1,308 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.add module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/add/ rel=canonical><link href=../../catalog/catalog_writer/ rel=prev><link href=../assemble/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.add - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.add - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.add module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/add.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/add/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.add - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.add module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/add.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.add class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.add </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.add </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.add </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.add class=md-nav__link> <span class=md-ellipsis> add </span> </a> <nav class=md-nav aria-label=add> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.add-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add.Add class=md-nav__link> <span class=md-ellipsis> Add </span> </a> <nav class=md-nav aria-label=Add> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add.Add-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add.Add.add class=md-nav__link> <span class=md-ellipsis> add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.add.Add.add_from_args class=md-nav__link> <span class=md-ellipsis> add_from_args </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.add-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.add class=md-nav__link> <span class=md-ellipsis> add </span> </a> <nav class=md-nav aria-label=add> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.add-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add.Add class=md-nav__link> <span class=md-ellipsis> Add </span> </a> <nav class=md-nav aria-label=Add> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add.Add-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.add.Add.add class=md-nav__link> <span class=md-ellipsis> add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.add.Add.add_from_args class=md-nav__link> <span class=md-ellipsis> add_from_args </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.add-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.add</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.add class="doc doc-heading"> <code>trestle.core.commands.add</code> <a href=#trestle.core.commands.add class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Add Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.add-attributes>Attributes<a href=#trestle.core.commands.add-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.add.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.add.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.add-classes>Classes<a href=#trestle.core.commands.add-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.add.Add class="doc doc-heading"> <code>Add</code> <a href=#trestle.core.commands.add.Add class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class supporting Add of an OSCAL object to a provided file based on element path.</p> <details class=examples-of-element-paths open> <summary>Examples of element paths</summary> <p>catalog.metadata catalog.controls.control assessment-results.results.</p> </details> <p>The method first finds the parent model from the file and loads the file into the model. Then the method executes 'add' for each of the element paths specified. Add was originally its own command but has been incorporated into the Create command.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/add.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Add</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Class supporting Add of an OSCAL object to a provided file based on element path.</span>
+
+<span class=sd>    Examples of element paths:</span>
+<span class=sd>        catalog.metadata</span>
+<span class=sd>        catalog.controls.control</span>
+<span class=sd>        assessment-results.results.</span>
+
+<span class=sd>    The method first finds the parent model from the file and loads the file into the model.</span>
+<span class=sd>    Then the method executes &#39;add&#39; for each of the element paths specified.</span>
+<span class=sd>    Add was originally its own command but has been incorporated into the Create command.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>add_from_args</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Parse args for add element to file.&quot;&quot;&quot;</span>
+        <span class=n>file_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>file</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+
+        <span class=c1># Get parent model and then load json into parent model</span>
+        <span class=n>parent_model</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+        <span class=n>parent_object</span> <span class=o>=</span> <span class=n>parent_model</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+        <span class=n>parent_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>parent_object</span><span class=p>,</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>parent_model</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>))</span>
+
+        <span class=n>add_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=c1># Do _add for each element_path specified in args</span>
+        <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>element</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>elm_path_str</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+            <span class=n>element_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>elm_path_str</span><span class=p>)</span>
+            <span class=n>update_action</span><span class=p>,</span> <span class=n>parent_element</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>include_optional_fields</span><span class=p>)</span>
+            <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>update_action</span><span class=p>)</span>
+
+        <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=c1># this will output json or yaml based on type of input file</span>
+        <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>))</span>
+
+        <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+        <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+
+        <span class=n>add_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>add</span><span class=p>(</span><span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>include_optional</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>UpdateAction</span><span class=p>,</span> <span class=n>Element</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;For a element_path, add a child model to the parent_element of a given parent_model.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            element_path: element path of the item to create within the model</span>
+<span class=sd>            parent_element: the parent element that will host the created element</span>
+<span class=sd>            include_optional: whether to create optional attributes in the created element</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            First we find the child model at the specified element path and instantiate it with default values.</span>
+<span class=sd>            Then we check if there&#39;s already existing element at that path, in which case we append the child model</span>
+<span class=sd>            to the existing list of dict.</span>
+<span class=sd>            Then we set up an action plan to update the model (specified by file_path) in memory, create a file</span>
+<span class=sd>            at the same location and write the file.</span>
+<span class=sd>            We update the parent_element to prepare for next adds in the chain</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=s1>&#39;*&#39;</span> <span class=ow>in</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;trestle add does not support Wildcard element path.&#39;</span><span class=p>)</span>
+        <span class=c1># Get child model</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>child_model</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_type</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>parent_element</span><span class=o>.</span><span class=n>get</span><span class=p>()))</span>
+
+            <span class=c1># Create child element with sample values</span>
+            <span class=n>child_object</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>child_model</span><span class=p>,</span> <span class=n>include_optional</span><span class=o>=</span><span class=n>include_optional</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=c1># The element already exists</span>
+                <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>))</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+                    <span class=n>child_object</span> <span class=o>=</span> <span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span> <span class=o>+</span> <span class=n>child_object</span>
+                <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>))</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+                    <span class=n>child_object</span> <span class=o>=</span> <span class=p>{</span><span class=o>**</span><span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>),</span> <span class=o>**</span><span class=n>child_object</span><span class=p>}</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Already exists and is not a list or dictionary.&#39;</span><span class=p>)</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Bad element path. </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>update_action</span> <span class=o>=</span> <span class=n>UpdateAction</span><span class=p>(</span>
+            <span class=n>sub_element</span><span class=o>=</span><span class=n>child_object</span><span class=p>,</span> <span class=n>dest_element</span><span class=o>=</span><span class=n>parent_element</span><span class=p>,</span> <span class=n>sub_element_path</span><span class=o>=</span><span class=n>element_path</span>
+        <span class=p>)</span>
+        <span class=n>parent_element</span> <span class=o>=</span> <span class=n>parent_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>child_object</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>update_action</span><span class=p>,</span> <span class=n>parent_element</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.add.Add-functions>Functions<a href=#trestle.core.commands.add.Add-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.add.Add.add class="doc doc-heading"> <code class="highlight language-python"><span class=n>add</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>,</span> <span class=n>include_optional</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.add.Add.add class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>For a element_path, add a child model to the parent_element of a given parent_model.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>element_path</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.models.elements.ElementPath href=../../models/elements/#trestle.core.models.elements.ElementPath>ElementPath</a></code> </td> <td> <div class=doc-md-description> <p>element path of the item to create within the model</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>parent_element</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.models.elements.Element href=../../models/elements/#trestle.core.models.elements.Element>Element</a></code> </td> <td> <div class=doc-md-description> <p>the parent element that will host the created element</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>include_optional</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>whether to create optional attributes in the created element</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>First we find the child model at the specified element path and instantiate it with default values. Then we check if there's already existing element at that path, in which case we append the child model to the existing list of dict. Then we set up an action plan to update the model (specified by file_path) in memory, create a file at the same location and write the file. We update the parent_element to prepare for next adds in the chain</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/commands/add.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>add</span><span class=p>(</span><span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>include_optional</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>UpdateAction</span><span class=p>,</span> <span class=n>Element</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;For a element_path, add a child model to the parent_element of a given parent_model.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        element_path: element path of the item to create within the model</span>
+<span class=sd>        parent_element: the parent element that will host the created element</span>
+<span class=sd>        include_optional: whether to create optional attributes in the created element</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        First we find the child model at the specified element path and instantiate it with default values.</span>
+<span class=sd>        Then we check if there&#39;s already existing element at that path, in which case we append the child model</span>
+<span class=sd>        to the existing list of dict.</span>
+<span class=sd>        Then we set up an action plan to update the model (specified by file_path) in memory, create a file</span>
+<span class=sd>        at the same location and write the file.</span>
+<span class=sd>        We update the parent_element to prepare for next adds in the chain</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=s1>&#39;*&#39;</span> <span class=ow>in</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;trestle add does not support Wildcard element path.&#39;</span><span class=p>)</span>
+    <span class=c1># Get child model</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>child_model</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_type</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>parent_element</span><span class=o>.</span><span class=n>get</span><span class=p>()))</span>
+
+        <span class=c1># Create child element with sample values</span>
+        <span class=n>child_object</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>child_model</span><span class=p>,</span> <span class=n>include_optional</span><span class=o>=</span><span class=n>include_optional</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=c1># The element already exists</span>
+            <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>))</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+                <span class=n>child_object</span> <span class=o>=</span> <span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span> <span class=o>+</span> <span class=n>child_object</span>
+            <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>))</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+                <span class=n>child_object</span> <span class=o>=</span> <span class=p>{</span><span class=o>**</span><span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>),</span> <span class=o>**</span><span class=n>child_object</span><span class=p>}</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Already exists and is not a list or dictionary.&#39;</span><span class=p>)</span>
+
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Bad element path. </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>update_action</span> <span class=o>=</span> <span class=n>UpdateAction</span><span class=p>(</span>
+        <span class=n>sub_element</span><span class=o>=</span><span class=n>child_object</span><span class=p>,</span> <span class=n>dest_element</span><span class=o>=</span><span class=n>parent_element</span><span class=p>,</span> <span class=n>sub_element_path</span><span class=o>=</span><span class=n>element_path</span>
+    <span class=p>)</span>
+    <span class=n>parent_element</span> <span class=o>=</span> <span class=n>parent_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>child_object</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>update_action</span><span class=p>,</span> <span class=n>parent_element</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.add.Add.add_from_args class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span></code> <a href=#trestle.core.commands.add.Add.add_from_args class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Parse args for add element to file.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/add.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_from_args</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Parse args for add element to file.&quot;&quot;&quot;</span>
+    <span class=n>file_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>file</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+
+    <span class=c1># Get parent model and then load json into parent model</span>
+    <span class=n>parent_model</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+    <span class=n>parent_object</span> <span class=o>=</span> <span class=n>parent_model</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+    <span class=n>parent_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>parent_object</span><span class=p>,</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>parent_model</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>))</span>
+
+    <span class=n>add_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+    <span class=c1># Do _add for each element_path specified in args</span>
+    <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>element</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>elm_path_str</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+        <span class=n>element_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>elm_path_str</span><span class=p>)</span>
+        <span class=n>update_action</span><span class=p>,</span> <span class=n>parent_element</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>include_optional_fields</span><span class=p>)</span>
+        <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>update_action</span><span class=p>)</span>
+
+    <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+    <span class=c1># this will output json or yaml based on type of input file</span>
+    <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>))</span>
+
+    <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+    <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+
+    <span class=n>add_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.add-functions>Functions<a href=#trestle.core.commands.add-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/assemble/index.html b/latest/reference/API/trestle/core/commands/assemble/index.html
new file mode 100644
index 000000000..5e75313ce
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/assemble/index.html
@@ -0,0 +1,253 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.assemble module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/assemble/ rel=canonical><link href=../add/ rel=prev><link href=../command_docs/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.assemble - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.assemble - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.assemble module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/assemble.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/assemble/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.assemble - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.assemble module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/assemble.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.assemble class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.assemble </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.assemble </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.assemble class=md-nav__link> <span class=md-ellipsis> assemble </span> </a> <nav class=md-nav aria-label=assemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.assemble-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd class=md-nav__link> <span class=md-ellipsis> AssembleCmd </span> </a> <nav class=md-nav aria-label=AssembleCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd.assemble_model class=md-nav__link> <span class=md-ellipsis> assemble_model </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.assemble-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.assemble class=md-nav__link> <span class=md-ellipsis> assemble </span> </a> <nav class=md-nav aria-label=assemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.assemble-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd class=md-nav__link> <span class=md-ellipsis> AssembleCmd </span> </a> <nav class=md-nav aria-label=AssembleCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.assemble.AssembleCmd.assemble_model class=md-nav__link> <span class=md-ellipsis> assemble_model </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.assemble-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.assemble</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.assemble class="doc doc-heading"> <code>trestle.core.commands.assemble</code> <a href=#trestle.core.commands.assemble class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Assemble Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.assemble-attributes>Attributes<a href=#trestle.core.commands.assemble-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.assemble.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.assemble.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.assemble-classes>Classes<a href=#trestle.core.commands.assemble-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.assemble.AssembleCmd class="doc doc-heading"> <code>AssembleCmd</code> <a href=#trestle.core.commands.assemble.AssembleCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Assemble all subcomponents from a specified trestle model into a single JSON/YAML file under dist.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/assemble.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssembleCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble all subcomponents from a specified trestle model into a single JSON/YAML file under dist.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;assemble&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;model&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>choices</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of a single model to assemble.&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-t&#39;</span><span class=p>,</span> <span class=s1>&#39;--type&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Assemble all models of the given type.&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-x&#39;</span><span class=p>,</span> <span class=s1>&#39;--extension&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Type of file output.&#39;</span><span class=p>,</span> <span class=n>choices</span><span class=o>=</span><span class=p>[</span><span class=s1>&#39;json&#39;</span><span class=p>,</span> <span class=s1>&#39;yaml&#39;</span><span class=p>,</span> <span class=s1>&#39;yml&#39;</span><span class=p>],</span> <span class=n>default</span><span class=o>=</span><span class=s1>&#39;json&#39;</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>assemble_model</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>model</span><span class=p>,</span> <span class=n>args</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while assembling OSCAL model&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>assemble_model</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Assemble a top level OSCAL model within the trestle dist directory.&quot;&quot;&quot;</span>
+        <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling models of type </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>  <span class=c1># trestle root is set via command line in args. Default is cwd.</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>trestle_root</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleRootError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory </span><span class=si>{</span><span class=n>trestle_root</span><span class=si>}</span><span class=s1> is not a trestle project.&#39;</span><span class=p>)</span>
+
+        <span class=n>model_names</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+            <span class=n>model_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>]</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling single model of type </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>model_names</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_models_of_type</span><span class=p>(</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=n>nmodels</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>model_names</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling </span><span class=si>{</span><span class=n>nmodels</span><span class=si>}</span><span class=s1> found models of type </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>model_names</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No models found to assemble of type </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>for</span> <span class=n>model_name</span> <span class=ow>in</span> <span class=n>model_names</span><span class=p>:</span>
+            <span class=c1># contruct path to the model file name</span>
+            <span class=n>root_model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+            <span class=n>model_file_type</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>get_contextual_file_type</span><span class=p>(</span><span class=n>root_model_dir</span> <span class=o>/</span> <span class=n>model_name</span><span class=p>)</span>
+
+            <span class=n>model_file_name</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>model_alias</span><span class=si>}{</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>model_file_type</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>root_model_filepath</span> <span class=o>=</span> <span class=n>root_model_dir</span> <span class=o>/</span> <span class=n>model_name</span> <span class=o>/</span> <span class=n>model_file_name</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>root_model_filepath</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No top level model file at </span><span class=si>{</span><span class=n>root_model_dir</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>assembled_model</span> <span class=o>=</span> <span class=n>load_validate_model_path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>root_model_filepath</span><span class=p>)</span>
+            <span class=n>plural_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+            <span class=n>assembled_model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_DIST_DIR</span> <span class=o>/</span> <span class=n>plural_alias</span>
+
+            <span class=n>assembled_model_filepath</span> <span class=o>=</span> <span class=n>assembled_model_dir</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>model_name</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>extension</span><span class=si>}</span><span class=s1>&#39;</span>
+
+            <span class=n>plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+            <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>assembled_model_filepath</span><span class=p>,</span> <span class=kc>True</span><span class=p>))</span>
+            <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span>
+                <span class=n>WriteFileAction</span><span class=p>(</span>
+                    <span class=n>assembled_model_filepath</span><span class=p>,</span>
+                    <span class=n>Element</span><span class=p>(</span><span class=n>assembled_model</span><span class=p>),</span>
+                    <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;.</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>extension</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=p>)</span>
+            <span class=p>)</span>
+
+            <span class=n>plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.assemble.AssembleCmd-attributes>Attributes<a href=#trestle.core.commands.assemble.AssembleCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.assemble.AssembleCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;assemble&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.assemble.AssembleCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.assemble.AssembleCmd-functions>Functions<a href=#trestle.core.commands.assemble.AssembleCmd-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.assemble.AssembleCmd.assemble_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_model</span><span class=p>(</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>args</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.assemble.AssembleCmd.assemble_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble a top level OSCAL model within the trestle dist directory.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/assemble.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>assemble_model</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble a top level OSCAL model within the trestle dist directory.&quot;&quot;&quot;</span>
+    <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling models of type </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>  <span class=c1># trestle root is set via command line in args. Default is cwd.</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>trestle_root</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleRootError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory </span><span class=si>{</span><span class=n>trestle_root</span><span class=si>}</span><span class=s1> is not a trestle project.&#39;</span><span class=p>)</span>
+
+    <span class=n>model_names</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+        <span class=n>model_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>]</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling single model of type </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>model_names</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_models_of_type</span><span class=p>(</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=n>nmodels</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>model_names</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling </span><span class=si>{</span><span class=n>nmodels</span><span class=si>}</span><span class=s1> found models of type </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>model_names</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No models found to assemble of type </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>for</span> <span class=n>model_name</span> <span class=ow>in</span> <span class=n>model_names</span><span class=p>:</span>
+        <span class=c1># contruct path to the model file name</span>
+        <span class=n>root_model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+        <span class=n>model_file_type</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>get_contextual_file_type</span><span class=p>(</span><span class=n>root_model_dir</span> <span class=o>/</span> <span class=n>model_name</span><span class=p>)</span>
+
+        <span class=n>model_file_name</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>model_alias</span><span class=si>}{</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>model_file_type</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=n>root_model_filepath</span> <span class=o>=</span> <span class=n>root_model_dir</span> <span class=o>/</span> <span class=n>model_name</span> <span class=o>/</span> <span class=n>model_file_name</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>root_model_filepath</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No top level model file at </span><span class=si>{</span><span class=n>root_model_dir</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>assembled_model</span> <span class=o>=</span> <span class=n>load_validate_model_path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>root_model_filepath</span><span class=p>)</span>
+        <span class=n>plural_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+        <span class=n>assembled_model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_DIST_DIR</span> <span class=o>/</span> <span class=n>plural_alias</span>
+
+        <span class=n>assembled_model_filepath</span> <span class=o>=</span> <span class=n>assembled_model_dir</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>model_name</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>extension</span><span class=si>}</span><span class=s1>&#39;</span>
+
+        <span class=n>plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>assembled_model_filepath</span><span class=p>,</span> <span class=kc>True</span><span class=p>))</span>
+        <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span>
+            <span class=n>WriteFileAction</span><span class=p>(</span>
+                <span class=n>assembled_model_filepath</span><span class=p>,</span>
+                <span class=n>Element</span><span class=p>(</span><span class=n>assembled_model</span><span class=p>),</span>
+                <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;.</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>extension</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=p>)</span>
+        <span class=p>)</span>
+
+        <span class=n>plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.assemble-functions>Functions<a href=#trestle.core.commands.assemble-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/catalog/index.html b/latest/reference/API/trestle/core/commands/author/catalog/index.html
new file mode 100644
index 000000000..03306e387
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/catalog/index.html
@@ -0,0 +1,677 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.catalog module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/catalog/ rel=canonical><link href=../../version/ rel=prev><link href=../command/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.catalog - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.catalog - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.catalog module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/catalog.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/catalog/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.catalog - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.catalog module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/catalog.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.catalog class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog class=md-nav__link> <span class=md-ellipsis> catalog </span> </a> <nav class=md-nav aria-label=catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble class=md-nav__link> <span class=md-ellipsis> CatalogAssemble </span> </a> <nav class=md-nav aria-label=CatalogAssemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble.assemble_catalog class=md-nav__link> <span class=md-ellipsis> assemble_catalog </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate class=md-nav__link> <span class=md-ellipsis> CatalogGenerate </span> </a> <nav class=md-nav aria-label=CatalogGenerate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate.generate_markdown class=md-nav__link> <span class=md-ellipsis> generate_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog class=md-nav__link> <span class=md-ellipsis> catalog </span> </a> <nav class=md-nav aria-label=catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble class=md-nav__link> <span class=md-ellipsis> CatalogAssemble </span> </a> <nav class=md-nav aria-label=CatalogAssemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogAssemble.assemble_catalog class=md-nav__link> <span class=md-ellipsis> assemble_catalog </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate class=md-nav__link> <span class=md-ellipsis> CatalogGenerate </span> </a> <nav class=md-nav aria-label=CatalogGenerate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog.CatalogGenerate.generate_markdown class=md-nav__link> <span class=md-ellipsis> generate_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.catalog-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.catalog</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.catalog class="doc doc-heading"> <code>trestle.core.commands.author.catalog</code> <a href=#trestle.core.commands.author.catalog class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Author commands to generate catalog controls as markdown and assemble them back to json.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.catalog-attributes>Attributes<a href=#trestle.core.commands.author.catalog-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.catalog.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.catalog.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.catalog-classes>Classes<a href=#trestle.core.commands.author.catalog-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.catalog.CatalogAssemble class="doc doc-heading"> <code>CatalogAssemble</code> <a href=#trestle.core.commands.author.catalog.CatalogAssemble class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Assemble markdown files of controls into a Catalog json file.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogAssemble</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble markdown files of controls into a Catalog json file.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;catalog-assemble&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name_help_str</span> <span class=o>=</span> <span class=p>(</span>
+            <span class=s1>&#39;Optional name of the catalog model in the trestle workspace that is being modified.  &#39;</span>
+            <span class=s1>&#39;If not provided the output name is used.&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>name_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>file_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the input markdown file directory&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-m&#39;</span><span class=p>,</span> <span class=s1>&#39;--markdown&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>file_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>output_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the output generated json Catalog&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>output_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-sp&#39;</span><span class=p>,</span> <span class=s1>&#39;--set-parameters&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_SET_PARAMS</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-r&#39;</span><span class=p>,</span> <span class=s1>&#39;--regenerate&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_REGENERATE</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-vn&#39;</span><span class=p>,</span> <span class=s1>&#39;--version&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_VERSION</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CatalogAssemble</span><span class=o>.</span><span class=n>assemble_catalog</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=o>=</span><span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>md_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>markdown</span><span class=p>,</span>
+                <span class=n>assem_cat_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>,</span>
+                <span class=n>parent_cat_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>,</span>
+                <span class=n>set_parameters_flag</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span>
+                <span class=n>regenerate</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>regenerate</span><span class=p>,</span>
+                <span class=n>version</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>version</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error occurred while assembling catalog&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>assemble_catalog</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>md_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>assem_cat_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>parent_cat_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Assemble the markdown directory into a json catalog model file.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: The trestle root directory</span>
+<span class=sd>            md_name: The name of the directory containing the markdown control files for the ssp</span>
+<span class=sd>            assem_cat_name: The output name of the catalog model to be created from the assembly</span>
+<span class=sd>            parent_cat_name: Optional name of the parent catalog that the markdown controls will replace</span>
+<span class=sd>            set_parameters_flag: set the parameters and props in the control to the values in the markdown yaml header</span>
+<span class=sd>            regenerate: whether to regenerate the uuid&#39;s in the catalog</span>
+<span class=sd>            version: version for the assembled catalog</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            0 on success, 1 otherwise</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            If the destination catalog_name model already exists in the trestle workspace, it is overwritten.</span>
+<span class=sd>            If a parent catalog is not specified, the assembled catalog will be used as the parent if it exists.</span>
+<span class=sd>            If no parent catalog name is available, the catalog is created anew using only the markdown content.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>md_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>md_name</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>md_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown directory </span><span class=si>{</span><span class=n>md_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+        <span class=c1># assemble the markdown controls into fresh md_catalog</span>
+        <span class=n>catalog_api_from_md</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>md_catalog</span> <span class=o>=</span> <span class=n>catalog_api_from_md</span><span class=o>.</span><span class=n>read_catalog_from_markdown</span><span class=p>(</span><span class=n>md_dir</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error reading catalog from markdown </span><span class=si>{</span><span class=n>md_dir</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># this is None if it doesn&#39;t exist yet</span>
+        <span class=n>assem_cat_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_cat_name</span><span class=p>,</span> <span class=n>Catalog</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;assem_cat_path is </span><span class=si>{</span><span class=n>assem_cat_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># if original cat is not specified, use the assembled cat but only if it already exists</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>parent_cat_name</span> <span class=ow>and</span> <span class=n>assem_cat_path</span><span class=p>:</span>
+            <span class=n>parent_cat_name</span> <span class=o>=</span> <span class=n>assem_cat_name</span>
+
+        <span class=c1># default to JSON but allow override later if other file type found</span>
+        <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+
+        <span class=c1># if we have parent catalog then merge the markdown controls into it</span>
+        <span class=c1># the parent can be a separate catalog or the destination assembled catalog if it exists</span>
+        <span class=c1># but this is the catalog that the markdown is merged into in memory</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;parent_cat_name is </span><span class=si>{</span><span class=n>parent_cat_name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parent_cat_name</span><span class=p>:</span>
+            <span class=n>parent_cat</span><span class=p>,</span> <span class=n>parent_cat_path</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_cat_name</span><span class=p>,</span> <span class=n>Catalog</span><span class=p>)</span>
+            <span class=n>parent_cat_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>parent_cat</span><span class=p>)</span>
+            <span class=c1># merge the just-read md catalog into the original json</span>
+            <span class=n>parent_cat_api</span><span class=o>.</span><span class=n>merge_catalog</span><span class=p>(</span><span class=n>md_catalog</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>)</span>
+            <span class=n>md_catalog</span> <span class=o>=</span> <span class=n>parent_cat_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_catalog</span><span class=p>()</span>
+            <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>parent_cat_path</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+            <span class=n>md_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+        <span class=c1># now check the destination catalog to see if the in-memory catalog matches it</span>
+        <span class=k>if</span> <span class=n>assem_cat_path</span><span class=p>:</span>
+            <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>assem_cat_path</span><span class=p>)</span>
+            <span class=n>existing_cat</span> <span class=o>=</span> <span class=n>load_validate_model_path</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_cat_path</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_cat</span><span class=p>,</span> <span class=n>md_catalog</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Assembled catalog is not different from existing version, so no update.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;new assembled catalog is different from existing one&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>regenerate</span><span class=p>:</span>
+            <span class=n>md_catalog</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>md_catalog</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;regenerating uuids in catalog&#39;</span><span class=p>)</span>
+        <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>md_catalog</span><span class=p>)</span>
+
+        <span class=n>md_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>oscal_version</span> <span class=o>=</span> <span class=n>OSCAL_VERSION</span>
+
+        <span class=c1># we still may not know the assem_cat_path but can now create it with file content type</span>
+        <span class=n>assem_cat_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_cat_name</span><span class=p>,</span> <span class=n>Catalog</span><span class=p>,</span> <span class=n>new_content_type</span>
+        <span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>assem_cat_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Creating catalog from markdown and destination catalog exists, so updating.&#39;</span><span class=p>)</span>
+            <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>assem_cat_path</span><span class=o>.</span><span class=n>parent</span><span class=p>))</span>
+
+        <span class=n>assem_cat_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>md_catalog</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>assem_cat_path</span><span class=o>.</span><span class=n>parent</span> <span class=o>/</span> <span class=s1>&#39;catalog.json&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.catalog.CatalogAssemble-attributes>Attributes<a href=#trestle.core.commands.author.catalog.CatalogAssemble-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.catalog.CatalogAssemble.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;catalog-assemble&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.catalog.CatalogAssemble.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.catalog.CatalogAssemble-functions>Functions<a href=#trestle.core.commands.author.catalog.CatalogAssemble-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.catalog.CatalogAssemble.assemble_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_catalog</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_name</span><span class=p>,</span> <span class=n>assem_cat_name</span><span class=p>,</span> <span class=n>parent_cat_name</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>,</span> <span class=n>regenerate</span><span class=p>,</span> <span class=n>version</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.catalog.CatalogAssemble.assemble_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble the markdown directory into a json catalog model file.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The trestle root directory</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>md_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The name of the directory containing the markdown control files for the ssp</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>assem_cat_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The output name of the catalog model to be created from the assembly</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>parent_cat_name</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Optional name of the parent catalog that the markdown controls will replace</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>set_parameters_flag</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>set the parameters and props in the control to the values in the markdown yaml header</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>regenerate</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>whether to regenerate the uuid's in the catalog</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>version</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>version for the assembled catalog</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>0 on success, 1 otherwise</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>If the destination catalog_name model already exists in the trestle workspace, it is overwritten. If a parent catalog is not specified, the assembled catalog will be used as the parent if it exists. If no parent catalog name is available, the catalog is created anew using only the markdown content.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>assemble_catalog</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>md_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>assem_cat_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>parent_cat_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Assemble the markdown directory into a json catalog model file.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: The trestle root directory</span>
+<span class=sd>        md_name: The name of the directory containing the markdown control files for the ssp</span>
+<span class=sd>        assem_cat_name: The output name of the catalog model to be created from the assembly</span>
+<span class=sd>        parent_cat_name: Optional name of the parent catalog that the markdown controls will replace</span>
+<span class=sd>        set_parameters_flag: set the parameters and props in the control to the values in the markdown yaml header</span>
+<span class=sd>        regenerate: whether to regenerate the uuid&#39;s in the catalog</span>
+<span class=sd>        version: version for the assembled catalog</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        0 on success, 1 otherwise</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        If the destination catalog_name model already exists in the trestle workspace, it is overwritten.</span>
+<span class=sd>        If a parent catalog is not specified, the assembled catalog will be used as the parent if it exists.</span>
+<span class=sd>        If no parent catalog name is available, the catalog is created anew using only the markdown content.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>md_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>md_name</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>md_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown directory </span><span class=si>{</span><span class=n>md_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+    <span class=c1># assemble the markdown controls into fresh md_catalog</span>
+    <span class=n>catalog_api_from_md</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>md_catalog</span> <span class=o>=</span> <span class=n>catalog_api_from_md</span><span class=o>.</span><span class=n>read_catalog_from_markdown</span><span class=p>(</span><span class=n>md_dir</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error reading catalog from markdown </span><span class=si>{</span><span class=n>md_dir</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=c1># this is None if it doesn&#39;t exist yet</span>
+    <span class=n>assem_cat_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_cat_name</span><span class=p>,</span> <span class=n>Catalog</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;assem_cat_path is </span><span class=si>{</span><span class=n>assem_cat_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=c1># if original cat is not specified, use the assembled cat but only if it already exists</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>parent_cat_name</span> <span class=ow>and</span> <span class=n>assem_cat_path</span><span class=p>:</span>
+        <span class=n>parent_cat_name</span> <span class=o>=</span> <span class=n>assem_cat_name</span>
+
+    <span class=c1># default to JSON but allow override later if other file type found</span>
+    <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+
+    <span class=c1># if we have parent catalog then merge the markdown controls into it</span>
+    <span class=c1># the parent can be a separate catalog or the destination assembled catalog if it exists</span>
+    <span class=c1># but this is the catalog that the markdown is merged into in memory</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;parent_cat_name is </span><span class=si>{</span><span class=n>parent_cat_name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parent_cat_name</span><span class=p>:</span>
+        <span class=n>parent_cat</span><span class=p>,</span> <span class=n>parent_cat_path</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_cat_name</span><span class=p>,</span> <span class=n>Catalog</span><span class=p>)</span>
+        <span class=n>parent_cat_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>parent_cat</span><span class=p>)</span>
+        <span class=c1># merge the just-read md catalog into the original json</span>
+        <span class=n>parent_cat_api</span><span class=o>.</span><span class=n>merge_catalog</span><span class=p>(</span><span class=n>md_catalog</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>)</span>
+        <span class=n>md_catalog</span> <span class=o>=</span> <span class=n>parent_cat_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_catalog</span><span class=p>()</span>
+        <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>parent_cat_path</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+        <span class=n>md_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+    <span class=c1># now check the destination catalog to see if the in-memory catalog matches it</span>
+    <span class=k>if</span> <span class=n>assem_cat_path</span><span class=p>:</span>
+        <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>assem_cat_path</span><span class=p>)</span>
+        <span class=n>existing_cat</span> <span class=o>=</span> <span class=n>load_validate_model_path</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_cat_path</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_cat</span><span class=p>,</span> <span class=n>md_catalog</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Assembled catalog is not different from existing version, so no update.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;new assembled catalog is different from existing one&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>regenerate</span><span class=p>:</span>
+        <span class=n>md_catalog</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>md_catalog</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;regenerating uuids in catalog&#39;</span><span class=p>)</span>
+    <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>md_catalog</span><span class=p>)</span>
+
+    <span class=n>md_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>oscal_version</span> <span class=o>=</span> <span class=n>OSCAL_VERSION</span>
+
+    <span class=c1># we still may not know the assem_cat_path but can now create it with file content type</span>
+    <span class=n>assem_cat_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_cat_name</span><span class=p>,</span> <span class=n>Catalog</span><span class=p>,</span> <span class=n>new_content_type</span>
+    <span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>assem_cat_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Creating catalog from markdown and destination catalog exists, so updating.&#39;</span><span class=p>)</span>
+        <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>assem_cat_path</span><span class=o>.</span><span class=n>parent</span><span class=p>))</span>
+
+    <span class=n>assem_cat_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>md_catalog</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>assem_cat_path</span><span class=o>.</span><span class=n>parent</span> <span class=o>/</span> <span class=s1>&#39;catalog.json&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.catalog.CatalogGenerate class="doc doc-heading"> <code>CatalogGenerate</code> <a href=#trestle.core.commands.author.catalog.CatalogGenerate class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Generate Catalog controls in markdown form from a catalog in the trestle workspace.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogGenerate</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate Catalog controls in markdown form from a catalog in the trestle workspace.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;catalog-generate&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the catalog model in the trestle workspace&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>name_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of the output generated catalog markdown folder&#39;</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>  <span class=c1># noqa E501</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-fo&#39;</span><span class=p>,</span> <span class=s1>&#39;--force-overwrite&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_FO_OUTPUT</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-y&#39;</span><span class=p>,</span> <span class=s1>&#39;--yaml-header&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_YAML_PATH</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-ohv&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--overwrite-header-values&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_OVERWRITE_HEADER_VALUES</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_directory_name_allowed</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1> is not an allowed directory name&#39;</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>force_overwrite</span><span class=p>:</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Overwriting the content in </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1> folder.&#39;</span><span class=p>)</span>
+                    <span class=n>clear_folder</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>))</span>
+                <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to overwrite contents in </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1> folder: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=p>:</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>logging</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Loading yaml header file </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+                    <span class=n>yaml_header</span> <span class=o>=</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=p>)</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>))</span>
+                <span class=k>except</span> <span class=n>YAMLError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;YAML error loading yaml header </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=si>}</span><span class=s1> for ssp generation: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>catalog_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;catalogs/</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>/catalog.json&#39;</span>
+
+            <span class=n>markdown_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>generate_markdown</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>catalog_path</span><span class=p>,</span> <span class=n>markdown_path</span><span class=p>,</span> <span class=n>yaml_header</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>overwrite_header_values</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error occurred when generating markdown for catalog&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>generate_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>catalog_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>markdown_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate markdown for the controls in the catalog.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>catalog</span> <span class=o>=</span> <span class=n>load_validate_model_path</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>catalog_path</span><span class=p>)</span>
+            <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span>
+                <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>CATALOG</span><span class=p>,</span>
+                <span class=kc>True</span><span class=p>,</span>
+                <span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>markdown_path</span><span class=p>,</span>
+                <span class=n>cli_yaml_header</span><span class=o>=</span><span class=n>yaml_header</span><span class=p>,</span>
+                <span class=n>overwrite_header_values</span><span class=o>=</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+                <span class=n>set_parameters_flag</span><span class=o>=</span><span class=kc>True</span>
+            <span class=p>)</span>
+            <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>,</span> <span class=n>context</span><span class=o>=</span><span class=n>context</span><span class=p>)</span>
+            <span class=n>catalog_api</span><span class=o>.</span><span class=n>write_catalog_as_markdown</span><span class=p>()</span>
+
+        <span class=k>except</span> <span class=n>TrestleNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Catalog </span><span class=si>{</span><span class=n>catalog_path</span><span class=si>}</span><span class=s1> not found for load: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generating markdown for controls in </span><span class=si>{</span><span class=n>catalog_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.catalog.CatalogGenerate-attributes>Attributes<a href=#trestle.core.commands.author.catalog.CatalogGenerate-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.catalog.CatalogGenerate.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;catalog-generate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.catalog.CatalogGenerate.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.catalog.CatalogGenerate-functions>Functions<a href=#trestle.core.commands.author.catalog.CatalogGenerate-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.catalog.CatalogGenerate.generate_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate_markdown</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>catalog_path</span><span class=p>,</span> <span class=n>markdown_path</span><span class=p>,</span> <span class=n>yaml_header</span><span class=p>,</span> <span class=n>overwrite_header_values</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.catalog.CatalogGenerate.generate_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate markdown for the controls in the catalog.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>generate_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>catalog_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>markdown_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+    <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate markdown for the controls in the catalog.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=n>load_validate_model_path</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>catalog_path</span><span class=p>)</span>
+        <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span>
+            <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>CATALOG</span><span class=p>,</span>
+            <span class=kc>True</span><span class=p>,</span>
+            <span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>markdown_path</span><span class=p>,</span>
+            <span class=n>cli_yaml_header</span><span class=o>=</span><span class=n>yaml_header</span><span class=p>,</span>
+            <span class=n>overwrite_header_values</span><span class=o>=</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+            <span class=n>set_parameters_flag</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+        <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>,</span> <span class=n>context</span><span class=o>=</span><span class=n>context</span><span class=p>)</span>
+        <span class=n>catalog_api</span><span class=o>.</span><span class=n>write_catalog_as_markdown</span><span class=p>()</span>
+
+    <span class=k>except</span> <span class=n>TrestleNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Catalog </span><span class=si>{</span><span class=n>catalog_path</span><span class=si>}</span><span class=s1> not found for load: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generating markdown for controls in </span><span class=si>{</span><span class=n>catalog_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.author.catalog-functions>Functions<a href=#trestle.core.commands.author.catalog-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/command/index.html b/latest/reference/API/trestle/core/commands/author/command/index.html
new file mode 100644
index 000000000..dd20eaa75
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/command/index.html
@@ -0,0 +1,44 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.command module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/command/ rel=canonical><link href=../catalog/ rel=prev><link href=../common/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.command - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.command - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.command module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/command.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/command/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.command - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.command module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/command.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.command class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.command </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.command </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.command class=md-nav__link> <span class=md-ellipsis> command </span> </a> <nav class=md-nav aria-label=command> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.command-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.AuthorCmd class=md-nav__link> <span class=md-ellipsis> AuthorCmd </span> </a> <nav class=md-nav aria-label=AuthorCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.AuthorCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.AuthorCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.AuthorCmd.subcommands class=md-nav__link> <span class=md-ellipsis> subcommands </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.command class=md-nav__link> <span class=md-ellipsis> command </span> </a> <nav class=md-nav aria-label=command> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.command-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.AuthorCmd class=md-nav__link> <span class=md-ellipsis> AuthorCmd </span> </a> <nav class=md-nav aria-label=AuthorCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.AuthorCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.AuthorCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.command.AuthorCmd.subcommands class=md-nav__link> <span class=md-ellipsis> subcommands </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.command</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.command class="doc doc-heading"> <code>trestle.core.commands.author.command</code> <a href=#trestle.core.commands.author.command class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle author command.</p> <p>Umbrella command for all markdown related transformations</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.command-attributes>Attributes<a href=#trestle.core.commands.author.command-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.command.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.command.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.command-classes>Classes<a href=#trestle.core.commands.author.command-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.command.AuthorCmd class="doc doc-heading"> <code>AuthorCmd</code> <a href=#trestle.core.commands.author.command.AuthorCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>trestle author, a collection of commands for authoring compliance content outside of OSCAL.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/command.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AuthorCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;trestle author, a collection of commands for authoring compliance content outside of OSCAL.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;author&#39;</span>
+
+    <span class=n>subcommands</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=n>CatalogAssemble</span><span class=p>,</span>
+        <span class=n>CatalogGenerate</span><span class=p>,</span>
+        <span class=n>ComponentAssemble</span><span class=p>,</span>
+        <span class=n>ComponentGenerate</span><span class=p>,</span>
+        <span class=n>Docs</span><span class=p>,</span>
+        <span class=n>Folders</span><span class=p>,</span>
+        <span class=n>Headers</span><span class=p>,</span>
+        <span class=n>JinjaCmd</span><span class=p>,</span>
+        <span class=n>ProfileAssemble</span><span class=p>,</span>
+        <span class=n>ProfileGenerate</span><span class=p>,</span>
+        <span class=n>ProfileInherit</span><span class=p>,</span>
+        <span class=n>ProfileResolve</span><span class=p>,</span>
+        <span class=n>SSPAssemble</span><span class=p>,</span>
+        <span class=n>SSPFilter</span><span class=p>,</span>
+        <span class=n>SSPGenerate</span>
+    <span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.command.AuthorCmd-attributes>Attributes<a href=#trestle.core.commands.author.command.AuthorCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.command.AuthorCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;author&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.command.AuthorCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.command.AuthorCmd.subcommands class="doc doc-heading"> <code class="highlight language-python"><span class=n>subcommands</span> <span class=o>=</span> <span class=p>[</span><span class=n>CatalogAssemble</span><span class=p>,</span> <span class=n>CatalogGenerate</span><span class=p>,</span> <span class=n>ComponentAssemble</span><span class=p>,</span> <span class=n>ComponentGenerate</span><span class=p>,</span> <span class=n>Docs</span><span class=p>,</span> <span class=n>Folders</span><span class=p>,</span> <span class=n>Headers</span><span class=p>,</span> <span class=n>JinjaCmd</span><span class=p>,</span> <span class=n>ProfileAssemble</span><span class=p>,</span> <span class=n>ProfileGenerate</span><span class=p>,</span> <span class=n>ProfileInherit</span><span class=p>,</span> <span class=n>ProfileResolve</span><span class=p>,</span> <span class=n>SSPAssemble</span><span class=p>,</span> <span class=n>SSPFilter</span><span class=p>,</span> <span class=n>SSPGenerate</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.command.AuthorCmd.subcommands class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/common/index.html b/latest/reference/API/trestle/core/commands/author/common/index.html
new file mode 100644
index 000000000..fc57628fc
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/common/index.html
@@ -0,0 +1,145 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.common module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/common/ rel=canonical><link href=../command/ rel=prev><link href=../component/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.common - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.common - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.common module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/common.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/common/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.common - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.common module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/common.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.common class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.common </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.common </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.common class=md-nav__link> <span class=md-ellipsis> common </span> </a> <nav class=md-nav aria-label=common> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.common-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand class=md-nav__link> <span class=md-ellipsis> AuthorCommonCommand </span> </a> <nav class=md-nav aria-label=AuthorCommonCommand> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand.task_name class=md-nav__link> <span class=md-ellipsis> task_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand.trestle_root class=md-nav__link> <span class=md-ellipsis> trestle_root </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand.rel_dir class=md-nav__link> <span class=md-ellipsis> rel_dir </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.common class=md-nav__link> <span class=md-ellipsis> common </span> </a> <nav class=md-nav aria-label=common> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.common-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand class=md-nav__link> <span class=md-ellipsis> AuthorCommonCommand </span> </a> <nav class=md-nav aria-label=AuthorCommonCommand> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand.task_name class=md-nav__link> <span class=md-ellipsis> task_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand.trestle_root class=md-nav__link> <span class=md-ellipsis> trestle_root </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.common.AuthorCommonCommand.rel_dir class=md-nav__link> <span class=md-ellipsis> rel_dir </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.common</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.common class="doc doc-heading"> <code>trestle.core.commands.author.common</code> <a href=#trestle.core.commands.author.common class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>AuthorCommonCommands - reusable utilities to increase code base abstraction for author command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.common-attributes>Attributes<a href=#trestle.core.commands.author.common-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.common.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.common.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.common-classes>Classes<a href=#trestle.core.commands.author.common-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.common.AuthorCommonCommand class="doc doc-heading"> <code>AuthorCommonCommand</code> <a href=#trestle.core.commands.author.common.AuthorCommonCommand class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Extension for the subset of commands that operate using the common mode structure.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AuthorCommonCommand</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Extension for the subset of commands that operate using the common mode structure.&quot;&quot;&quot;</span>
+
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+
+    <span class=n>task_name</span><span class=p>:</span> <span class=nb>str</span>
+
+    <span class=k>def</span> <span class=nf>_initialize</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=c1># Externalize</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>task_name</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>global_</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=fm>__getattribute__</span><span class=p>(</span><span class=s1>&#39;global&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>AttributeError</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>global_</span> <span class=o>=</span> <span class=kc>None</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_directory_name_allowed</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Task name </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> is invalid as it interferes with OSCAL and trestle reserved names.&#39;</span>
+                <span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=n>rc</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_setup_template_dir</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>rc</span>
+
+    <span class=k>def</span> <span class=nf>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Stringify a directory relative to trestle root.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>str</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>))</span>
+
+    <span class=k>def</span> <span class=nf>_setup_template_dir</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set template directory and update to new format.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>global_</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=s1>&#39;At least a global flag or a task name should be provided.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>INCORRECT_ARGS</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>global_</span><span class=p>:</span>
+            <span class=n>old_template_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span> <span class=o>/</span> <span class=n>TRESTLE_CONFIG_DIR</span> <span class=o>/</span> <span class=s1>&#39;author&#39;</span> <span class=o>/</span> <span class=s1>&#39;__global__&#39;</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_set_template_version_to_latest</span><span class=p>(</span><span class=n>args</span><span class=p>,</span> <span class=n>old_template_dir</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>=</span> <span class=n>old_template_dir</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>template_version</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>global_</span><span class=p>:</span>
+            <span class=n>old_template_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span> <span class=o>/</span> <span class=n>TRESTLE_CONFIG_DIR</span> <span class=o>/</span> <span class=s1>&#39;author&#39;</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_set_template_version_to_latest</span><span class=p>(</span><span class=n>args</span><span class=p>,</span> <span class=n>old_template_dir</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>=</span> <span class=n>old_template_dir</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>template_version</span>
+
+        <span class=k>if</span> <span class=n>old_template_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>update_template_folder_structure</span><span class=p>(</span><span class=n>old_template_dir</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_set_template_version_to_latest</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>,</span> <span class=n>template_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set template version argument to the latest version if none was given.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>is_valid_version</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>template_version</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Version </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1> is invalid, version format should be: 0.0.1&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>template_version</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=n>ARG_VALIDATE</span><span class=p>:</span>
+            <span class=c1># in validate mode no version will validate instances based on header version</span>
+            <span class=n>args</span><span class=o>.</span><span class=n>template_version</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>template_version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>args</span><span class=o>.</span><span class=n>template_version</span> <span class=o>=</span> <span class=n>START_TEMPLATE_VERSION</span>
+            <span class=k>if</span> <span class=n>template_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=n>all_versions</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_all_versions_for_task</span><span class=p>(</span><span class=n>template_dir</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>all_versions</span><span class=p>:</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>template_version</span> <span class=o>=</span> <span class=nb>max</span><span class=p>(</span><span class=n>all_versions</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>template_version</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Instances will be validated against template version specified in their headers.&#39;</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Set template version to </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.common.AuthorCommonCommand-attributes>Attributes<a href=#trestle.core.commands.author.common.AuthorCommonCommand-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.common.AuthorCommonCommand.task_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>task_name</span><span class=p>:</span> <span class=nb>str</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.common.AuthorCommonCommand.task_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.common.AuthorCommonCommand.trestle_root class="doc doc-heading"> <code class="highlight language-python"><span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.common.AuthorCommonCommand.trestle_root class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.common.AuthorCommonCommand-functions>Functions<a href=#trestle.core.commands.author.common.AuthorCommonCommand-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.common.AuthorCommonCommand.rel_dir class="doc doc-heading"> <code class="highlight language-python"><span class=n>rel_dir</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.common.AuthorCommonCommand.rel_dir class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Stringify a directory relative to trestle root.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Stringify a directory relative to trestle root.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>str</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/component/index.html b/latest/reference/API/trestle/core/commands/author/component/index.html
new file mode 100644
index 000000000..e7fd9de7b
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/component/index.html
@@ -0,0 +1,881 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.component module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/component/ rel=canonical><link href=../common/ rel=prev><link href=../consts/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.component - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.component - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.component module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/component.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/component/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.component - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.component module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/component.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.component class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.component </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.component </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> <nav class=md-nav aria-label=component> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble class=md-nav__link> <span class=md-ellipsis> ComponentAssemble </span> </a> <nav class=md-nav aria-label=ComponentAssemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble.assemble_comp_def_into_parent class=md-nav__link> <span class=md-ellipsis> assemble_comp_def_into_parent </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble.assemble_component class=md-nav__link> <span class=md-ellipsis> assemble_component </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate class=md-nav__link> <span class=md-ellipsis> ComponentGenerate </span> </a> <nav class=md-nav aria-label=ComponentGenerate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate.component_generate_all class=md-nav__link> <span class=md-ellipsis> component_generate_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate.component_generate_by_name class=md-nav__link> <span class=md-ellipsis> component_generate_by_name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> <nav class=md-nav aria-label=component> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble class=md-nav__link> <span class=md-ellipsis> ComponentAssemble </span> </a> <nav class=md-nav aria-label=ComponentAssemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble.assemble_comp_def_into_parent class=md-nav__link> <span class=md-ellipsis> assemble_comp_def_into_parent </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentAssemble.assemble_component class=md-nav__link> <span class=md-ellipsis> assemble_component </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate class=md-nav__link> <span class=md-ellipsis> ComponentGenerate </span> </a> <nav class=md-nav aria-label=ComponentGenerate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate.component_generate_all class=md-nav__link> <span class=md-ellipsis> component_generate_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component.ComponentGenerate.component_generate_by_name class=md-nav__link> <span class=md-ellipsis> component_generate_by_name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.component-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.component</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.component class="doc doc-heading"> <code>trestle.core.commands.author.component</code> <a href=#trestle.core.commands.author.component class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Author commands to generate component definition as markdown and assemble to json after edit.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.component-attributes>Attributes<a href=#trestle.core.commands.author.component-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.component.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.component.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.component-classes>Classes<a href=#trestle.core.commands.author.component-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.component.ComponentAssemble class="doc doc-heading"> <code>ComponentAssemble</code> <a href=#trestle.core.commands.author.component.ComponentAssemble class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Assemble markdown files of controls into a Component json file.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ComponentAssemble</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble markdown files of controls into a Component json file.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;component-assemble&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name_help_str</span> <span class=o>=</span> <span class=p>(</span>
+            <span class=s1>&#39;Optional name of the component-definition model in the trestle workspace that is being modified.  &#39;</span>
+            <span class=s1>&#39;If not provided the output name is used.&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>name_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>file_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the source markdown directory&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-m&#39;</span><span class=p>,</span> <span class=s1>&#39;--markdown&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>file_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>output_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the output generated json component-definition (ok to overwrite original)&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>output_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-r&#39;</span><span class=p>,</span> <span class=s1>&#39;--regenerate&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_REGENERATE</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-vn&#39;</span><span class=p>,</span> <span class=s1>&#39;--version&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_VERSION</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>assemble_component</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>parent_comp_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>,</span>
+                <span class=n>md_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>markdown</span><span class=p>,</span>
+                <span class=n>assem_comp_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>,</span>
+                <span class=n>regenerate</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>regenerate</span><span class=p>,</span>
+                <span class=n>version</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>version</span><span class=p>,</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Assembly of markdown to component-definition failed&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>assemble_component</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>parent_comp_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>md_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>assem_comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Assemble the markdown directory into a json component-definition model file.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: The trestle root directory</span>
+<span class=sd>            parent_comp_name: Optional name of component-definition used to generate markdown, default = assem_comp_name</span>
+<span class=sd>            md_name: The name of the directory containing the markdown control files for the component</span>
+<span class=sd>            assem_comp_name: The name of the assembled component-definiton.  Can be same as the parent to overwrite</span>
+<span class=sd>            regenerate: Whether to regenerate the uuid&#39;s in the component</span>
+<span class=sd>            version: Optional version for the assembled component</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            0 on success, 1 otherwise</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            There must already be a component model and it will either be updated or a new json component created.</span>
+<span class=sd>            The generated markdown has the current values for parameters of controls being imported, as set by</span>
+<span class=sd>            the original catalog and any intermediate components.  It also shows the current SetParameters being applied</span>
+<span class=sd>            by this component.  That list of SetParameters can be edited by changing the assigned values and adding or</span>
+<span class=sd>            removing SetParameters from that list.  During assembly that list will be used to create the SetParameters</span>
+<span class=sd>            in the assembled component if the --set-parameters option is specified.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>md_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>md_name</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>md_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown directory </span><span class=si>{</span><span class=n>md_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>parent_comp_name</span><span class=p>:</span>
+            <span class=n>parent_comp_name</span> <span class=o>=</span> <span class=n>assem_comp_name</span>
+
+        <span class=c1># load the comp-def that will be updated</span>
+        <span class=n>parent_comp</span><span class=p>,</span> <span class=n>parent_comp_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_model_for_class</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>parent_comp_name</span><span class=p>,</span>
+            <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span>
+        <span class=p>)</span>
+        <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>parent_comp_path</span><span class=p>)</span>
+
+        <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>,</span> <span class=kc>False</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_dir</span><span class=p>)</span>
+
+        <span class=n>ComponentAssemble</span><span class=o>.</span><span class=n>assemble_comp_def_into_parent</span><span class=p>(</span><span class=n>parent_comp</span><span class=p>,</span> <span class=n>md_dir</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+            <span class=n>parent_comp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+        <span class=n>assem_comp_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_comp_name</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>,</span> <span class=n>new_content_type</span>
+        <span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>version</span> <span class=ow>and</span> <span class=n>assem_comp_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>existing_comp</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>assem_comp_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=c1># comp def will change statement uuids so need to ignore them in comparison</span>
+            <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_comp</span><span class=p>,</span> <span class=n>parent_comp</span><span class=p>,</span> <span class=kc>True</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Assembled component definition is no different from existing version, so no update.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>if</span> <span class=n>regenerate</span><span class=p>:</span>
+            <span class=n>parent_comp</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>parent_comp</span><span class=p>)</span>
+        <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>parent_comp</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+
+        <span class=k>if</span> <span class=n>assem_comp_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                <span class=s1>&#39;Creating component definition from markdown and destination component definition exists, so updating.&#39;</span>
+            <span class=p>)</span>  <span class=c1># noqa E501</span>
+            <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>assem_comp_path</span><span class=o>.</span><span class=n>parent</span><span class=p>))</span>
+
+        <span class=n>assem_comp_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>parent_comp</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>assem_comp_path</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>assemble_comp_def_into_parent</span><span class=p>(</span>
+        <span class=n>parent_comp</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>,</span> <span class=n>md_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Assemble markdown content into provided component-definition model.&quot;&quot;&quot;</span>
+        <span class=c1># find the needed list of comps</span>
+        <span class=n>sub_dirs</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>md_dir</span><span class=p>)</span>
+        <span class=n>comp_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>sub_dir</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>sub_dir</span> <span class=ow>in</span> <span class=n>sub_dirs</span> <span class=k>if</span> <span class=n>sub_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()]</span>
+
+        <span class=c1># make sure parent has list of comps to work with - possibly empty</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+            <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=p>[:]</span> <span class=o>=</span> <span class=p>[</span><span class=n>comp</span> <span class=k>for</span> <span class=n>comp</span> <span class=ow>in</span> <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span> <span class=k>if</span> <span class=n>comp</span><span class=o>.</span><span class=n>title</span> <span class=ow>in</span> <span class=n>comp_names</span><span class=p>]</span>
+
+        <span class=c1># create new comps if needed</span>
+        <span class=n>existing_comp_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>component</span><span class=o>.</span><span class=n>title</span> <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>comp_name</span> <span class=ow>in</span> <span class=n>comp_names</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>comp_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>existing_comp_names</span><span class=p>:</span>
+                <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                    <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>(</span>
+                        <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>()),</span> <span class=n>title</span><span class=o>=</span><span class=n>comp_name</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span>
+                    <span class=p>)</span>
+                <span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>comp_def</span> <span class=o>=</span> <span class=n>parent_comp</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>component</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling markdown for component </span><span class=si>{</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>ComponentAssemble</span><span class=o>.</span><span class=n>_update_component_with_markdown</span><span class=p>(</span><span class=n>md_dir</span><span class=p>,</span> <span class=n>component</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_profile_title_and_href_from_dir</span><span class=p>(</span><span class=n>md_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get profile title and href from yaml header of first md file found in dir that has info.&quot;&quot;&quot;</span>
+        <span class=n>md_files</span> <span class=o>=</span> <span class=n>md_dir</span><span class=o>.</span><span class=n>rglob</span><span class=p>(</span><span class=s1>&#39;*.md&#39;</span><span class=p>)</span>
+        <span class=n>markdown_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>md_file</span> <span class=ow>in</span> <span class=n>md_files</span><span class=p>:</span>
+            <span class=n>header</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>markdown_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>md_file</span><span class=p>)</span>
+            <span class=n>prof_title</span> <span class=o>=</span> <span class=n>deep_get</span><span class=p>(</span><span class=n>header</span><span class=p>,</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>TITLE</span><span class=p>])</span>
+            <span class=n>profile_href</span> <span class=o>=</span> <span class=n>deep_get</span><span class=p>(</span><span class=n>header</span><span class=p>,</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>HREF</span><span class=p>],</span> <span class=s1>&#39;unknown_href&#39;</span><span class=p>)</span>
+            <span class=c1># return first one found</span>
+            <span class=k>if</span> <span class=n>prof_title</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>prof_title</span><span class=p>,</span> <span class=n>profile_href</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cannot find profile title and href in markdown headers of directory </span><span class=si>{</span><span class=n>md_dir</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=s1>&#39;unknown_title&#39;</span><span class=p>,</span> <span class=s1>&#39;unknown_href&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_update_component_with_markdown</span><span class=p>(</span>
+        <span class=n>md_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>component</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>md_path</span> <span class=o>=</span> <span class=n>md_dir</span> <span class=o>/</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span>
+        <span class=n>sub_dirs</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span>
+        <span class=n>source_dirs</span> <span class=o>=</span> <span class=p>[</span><span class=n>sub_dir</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>sub_dir</span> <span class=ow>in</span> <span class=n>sub_dirs</span> <span class=k>if</span> <span class=n>sub_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()]</span>
+        <span class=k>for</span> <span class=n>source_dir</span> <span class=ow>in</span> <span class=n>source_dirs</span><span class=p>:</span>
+            <span class=n>profile_title</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ComponentAssemble</span><span class=o>.</span><span class=n>_get_profile_title_and_href_from_dir</span><span class=p>(</span><span class=n>md_path</span> <span class=o>/</span> <span class=n>source_dir</span><span class=p>)</span>
+            <span class=c1># context has defined component and comp_name</span>
+            <span class=n>imp_reqs</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>read_catalog_imp_reqs</span><span class=p>(</span><span class=n>md_path</span> <span class=o>/</span> <span class=n>source_dir</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+            <span class=c1># the imp_reqs need to be inserted into the correct control_implementation</span>
+            <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>imp_reqs</span><span class=p>:</span>
+                <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_imp_req_into_component</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>imp_req</span><span class=p>,</span> <span class=n>profile_title</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.component.ComponentAssemble-attributes>Attributes<a href=#trestle.core.commands.author.component.ComponentAssemble-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.component.ComponentAssemble.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;component-assemble&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.component.ComponentAssemble.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.component.ComponentAssemble-functions>Functions<a href=#trestle.core.commands.author.component.ComponentAssemble-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.component.ComponentAssemble.assemble_comp_def_into_parent class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_comp_def_into_parent</span><span class=p>(</span><span class=n>parent_comp</span><span class=p>,</span> <span class=n>md_dir</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.component.ComponentAssemble.assemble_comp_def_into_parent class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble markdown content into provided component-definition model.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>assemble_comp_def_into_parent</span><span class=p>(</span>
+    <span class=n>parent_comp</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>,</span> <span class=n>md_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble markdown content into provided component-definition model.&quot;&quot;&quot;</span>
+    <span class=c1># find the needed list of comps</span>
+    <span class=n>sub_dirs</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>md_dir</span><span class=p>)</span>
+    <span class=n>comp_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>sub_dir</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>sub_dir</span> <span class=ow>in</span> <span class=n>sub_dirs</span> <span class=k>if</span> <span class=n>sub_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()]</span>
+
+    <span class=c1># make sure parent has list of comps to work with - possibly empty</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+        <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=p>[:]</span> <span class=o>=</span> <span class=p>[</span><span class=n>comp</span> <span class=k>for</span> <span class=n>comp</span> <span class=ow>in</span> <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span> <span class=k>if</span> <span class=n>comp</span><span class=o>.</span><span class=n>title</span> <span class=ow>in</span> <span class=n>comp_names</span><span class=p>]</span>
+
+    <span class=c1># create new comps if needed</span>
+    <span class=n>existing_comp_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>component</span><span class=o>.</span><span class=n>title</span> <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=p>]</span>
+    <span class=k>for</span> <span class=n>comp_name</span> <span class=ow>in</span> <span class=n>comp_names</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>comp_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>existing_comp_names</span><span class=p>:</span>
+            <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>(</span>
+                    <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>()),</span> <span class=n>title</span><span class=o>=</span><span class=n>comp_name</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span>
+                <span class=p>)</span>
+            <span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>parent_comp</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>comp_def</span> <span class=o>=</span> <span class=n>parent_comp</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>component</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling markdown for component </span><span class=si>{</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>ComponentAssemble</span><span class=o>.</span><span class=n>_update_component_with_markdown</span><span class=p>(</span><span class=n>md_dir</span><span class=p>,</span> <span class=n>component</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.component.ComponentAssemble.assemble_component class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_component</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_comp_name</span><span class=p>,</span> <span class=n>md_name</span><span class=p>,</span> <span class=n>assem_comp_name</span><span class=p>,</span> <span class=n>regenerate</span><span class=p>,</span> <span class=n>version</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.component.ComponentAssemble.assemble_component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble the markdown directory into a json component-definition model file.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The trestle root directory</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>parent_comp_name</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Optional name of component-definition used to generate markdown, default = assem_comp_name</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>md_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The name of the directory containing the markdown control files for the component</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>assem_comp_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The name of the assembled component-definiton. Can be same as the parent to overwrite</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>regenerate</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to regenerate the uuid's in the component</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>version</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Optional version for the assembled component</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>0 on success, 1 otherwise</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>There must already be a component model and it will either be updated or a new json component created. The generated markdown has the current values for parameters of controls being imported, as set by the original catalog and any intermediate components. It also shows the current SetParameters being applied by this component. That list of SetParameters can be edited by changing the assigned values and adding or removing SetParameters from that list. During assembly that list will be used to create the SetParameters in the assembled component if the --set-parameters option is specified.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>assemble_component</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>parent_comp_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>md_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>assem_comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Assemble the markdown directory into a json component-definition model file.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: The trestle root directory</span>
+<span class=sd>        parent_comp_name: Optional name of component-definition used to generate markdown, default = assem_comp_name</span>
+<span class=sd>        md_name: The name of the directory containing the markdown control files for the component</span>
+<span class=sd>        assem_comp_name: The name of the assembled component-definiton.  Can be same as the parent to overwrite</span>
+<span class=sd>        regenerate: Whether to regenerate the uuid&#39;s in the component</span>
+<span class=sd>        version: Optional version for the assembled component</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        0 on success, 1 otherwise</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        There must already be a component model and it will either be updated or a new json component created.</span>
+<span class=sd>        The generated markdown has the current values for parameters of controls being imported, as set by</span>
+<span class=sd>        the original catalog and any intermediate components.  It also shows the current SetParameters being applied</span>
+<span class=sd>        by this component.  That list of SetParameters can be edited by changing the assigned values and adding or</span>
+<span class=sd>        removing SetParameters from that list.  During assembly that list will be used to create the SetParameters</span>
+<span class=sd>        in the assembled component if the --set-parameters option is specified.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>md_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>md_name</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>md_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown directory </span><span class=si>{</span><span class=n>md_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>parent_comp_name</span><span class=p>:</span>
+        <span class=n>parent_comp_name</span> <span class=o>=</span> <span class=n>assem_comp_name</span>
+
+    <span class=c1># load the comp-def that will be updated</span>
+    <span class=n>parent_comp</span><span class=p>,</span> <span class=n>parent_comp_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_model_for_class</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span>
+        <span class=n>parent_comp_name</span><span class=p>,</span>
+        <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span>
+    <span class=p>)</span>
+    <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>parent_comp_path</span><span class=p>)</span>
+
+    <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>,</span> <span class=kc>False</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_dir</span><span class=p>)</span>
+
+    <span class=n>ComponentAssemble</span><span class=o>.</span><span class=n>assemble_comp_def_into_parent</span><span class=p>(</span><span class=n>parent_comp</span><span class=p>,</span> <span class=n>md_dir</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+        <span class=n>parent_comp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+    <span class=n>assem_comp_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_comp_name</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>,</span> <span class=n>new_content_type</span>
+    <span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>version</span> <span class=ow>and</span> <span class=n>assem_comp_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>existing_comp</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>assem_comp_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=c1># comp def will change statement uuids so need to ignore them in comparison</span>
+        <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_comp</span><span class=p>,</span> <span class=n>parent_comp</span><span class=p>,</span> <span class=kc>True</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Assembled component definition is no different from existing version, so no update.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>if</span> <span class=n>regenerate</span><span class=p>:</span>
+        <span class=n>parent_comp</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>parent_comp</span><span class=p>)</span>
+    <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>parent_comp</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+
+    <span class=k>if</span> <span class=n>assem_comp_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;Creating component definition from markdown and destination component definition exists, so updating.&#39;</span>
+        <span class=p>)</span>  <span class=c1># noqa E501</span>
+        <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>assem_comp_path</span><span class=o>.</span><span class=n>parent</span><span class=p>))</span>
+
+    <span class=n>assem_comp_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>parent_comp</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>assem_comp_path</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.component.ComponentGenerate class="doc doc-heading"> <code>ComponentGenerate</code> <a href=#trestle.core.commands.author.component.ComponentGenerate class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Generate component in markdown form from a component in the trestle workspace.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ComponentGenerate</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate component in markdown form from a component in the trestle workspace.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;component-generate&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the source component model in the trestle workspace&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>name_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of the output generated component markdown folder&#39;</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>  <span class=c1># noqa E501</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-fo&#39;</span><span class=p>,</span> <span class=s1>&#39;--force-overwrite&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_FO_OUTPUT</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>force_overwrite</span><span class=p>:</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Overwriting the content in </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1> folder.&#39;</span><span class=p>)</span>
+                    <span class=n>clear_folder</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>))</span>
+                <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to overwrite contents in </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1> folder: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>component_generate_all</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>)</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Generation of the component markdown failed&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>component_generate_all</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>comp_def_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>markdown_dir_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate markdown for all components in comp def.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_directory_name_allowed</span><span class=p>(</span><span class=n>markdown_dir_name</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>markdown_dir_name</span><span class=si>}</span><span class=s1> is not an allowed directory name&#39;</span><span class=p>)</span>
+        <span class=n>md_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>markdown_dir_name</span>
+        <span class=n>md_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>component_def</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>comp_def_name</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>)</span>
+
+        <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_path</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>prompt_responses</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>comp_def</span> <span class=o>=</span> <span class=n>component_def</span>
+
+        <span class=n>rc</span> <span class=o>=</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component_def</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+            <span class=n>rc</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>component_generate_by_name</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>component</span><span class=p>,</span> <span class=n>md_path</span> <span class=o>/</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>rc</span> <span class=o>!=</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span><span class=p>:</span>
+                <span class=k>break</span>
+        <span class=k>return</span> <span class=n>rc</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_name_from_uri</span><span class=p>(</span><span class=n>source_uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the name from a source profile or catalog source uri.&quot;&quot;&quot;</span>
+        <span class=n>uri_type</span> <span class=o>=</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_uri_type</span><span class=p>(</span><span class=n>source_uri</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>uri_type</span> <span class=o>==</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>TRESTLE</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>source_uri</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;/&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=k>def</span> <span class=nf>component_generate_by_name</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>component</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>,</span> <span class=n>markdown_dir_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create markdown for the component using its source profiles.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for component </span><span class=si>{</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>component</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>uri_name_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>cat_api_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>CatalogAPI</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>name_index</span> <span class=o>=</span> <span class=mi>1</span>
+        <span class=k>for</span> <span class=n>control_imp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>):</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span> <span class=o>=</span> <span class=n>control_imp</span>
+            <span class=n>source_profile_uri</span> <span class=o>=</span> <span class=n>control_imp</span><span class=o>.</span><span class=n>source</span>
+            <span class=c1># get the resolved profile catalog for this source, generating it if not already created</span>
+            <span class=k>if</span> <span class=n>source_profile_uri</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>cat_api_dict</span><span class=p>:</span>
+                <span class=n>name</span> <span class=o>=</span> <span class=n>ComponentGenerate</span><span class=o>.</span><span class=n>_get_name_from_uri</span><span class=p>(</span><span class=n>source_profile_uri</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>name</span><span class=p>:</span>
+                    <span class=n>name</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;source_</span><span class=si>{</span><span class=n>name_index</span><span class=si>:</span><span class=s1>03d</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=n>name_index</span> <span class=o>+=</span> <span class=mi>1</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>uri_name_map</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span> <span class=o>=</span> <span class=n>name</span>
+                <span class=n>resolved_catalog</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+                    <span class=n>context</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>source_profile_uri</span><span class=p>,</span> <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span>
+                <span class=p>)</span>
+                <span class=n>local_catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>resolved_catalog</span><span class=p>)</span>
+                <span class=n>cat_api_dict</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span> <span class=o>=</span> <span class=n>local_catalog_api</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>local_catalog_api</span> <span class=o>=</span> <span class=n>cat_api_dict</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span>
+            <span class=c1># insert the profile title (from title of resolved catalog) into the yaml header so it appears in md</span>
+            <span class=c1># different controls in the final catalog may have different profile titles if from different control_imps</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+
+            <span class=n>profile_title</span> <span class=o>=</span> <span class=n>local_catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_catalog_title</span><span class=p>()</span>
+            <span class=n>profile_header</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;title&#39;</span><span class=p>:</span> <span class=n>profile_title</span><span class=p>,</span> <span class=s1>&#39;href&#39;</span><span class=p>:</span> <span class=n>source_profile_uri</span><span class=p>}</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>][</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>]</span> <span class=o>=</span> <span class=n>profile_header</span>
+
+            <span class=n>sub_dir_name</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>uri_name_map</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>md_root</span> <span class=o>=</span> <span class=n>markdown_dir_path</span> <span class=o>/</span> <span class=n>sub_dir_name</span>
+            <span class=c1># write controls corresponding to this source catalog</span>
+            <span class=c1># if two controlimps load the same control, the second one will merge into the first</span>
+            <span class=c1># otherwise the full catalog will be written in subsets by control_imp</span>
+            <span class=c1># if an imp_req has a set param also in the control_imp. the imp_req value is used for the control</span>
+            <span class=n>cat_api_dict</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span><span class=o>.</span><span class=n>update_context</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+            <span class=n>cat_api_dict</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span><span class=o>.</span><span class=n>write_catalog_as_markdown</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.component.ComponentGenerate-attributes>Attributes<a href=#trestle.core.commands.author.component.ComponentGenerate-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.component.ComponentGenerate.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;component-generate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.component.ComponentGenerate.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.component.ComponentGenerate-functions>Functions<a href=#trestle.core.commands.author.component.ComponentGenerate-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.component.ComponentGenerate.component_generate_all class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_generate_all</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>comp_def_name</span><span class=p>,</span> <span class=n>markdown_dir_name</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.component.ComponentGenerate.component_generate_all class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate markdown for all components in comp def.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>component_generate_all</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>comp_def_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>markdown_dir_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate markdown for all components in comp def.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_directory_name_allowed</span><span class=p>(</span><span class=n>markdown_dir_name</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>markdown_dir_name</span><span class=si>}</span><span class=s1> is not an allowed directory name&#39;</span><span class=p>)</span>
+    <span class=n>md_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>markdown_dir_name</span>
+    <span class=n>md_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>component_def</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>comp_def_name</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>)</span>
+
+    <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_path</span><span class=p>)</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>prompt_responses</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>comp_def</span> <span class=o>=</span> <span class=n>component_def</span>
+
+    <span class=n>rc</span> <span class=o>=</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+    <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component_def</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+        <span class=n>rc</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>component_generate_by_name</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>component</span><span class=p>,</span> <span class=n>md_path</span> <span class=o>/</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>rc</span> <span class=o>!=</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span><span class=p>:</span>
+            <span class=k>break</span>
+    <span class=k>return</span> <span class=n>rc</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.component.ComponentGenerate.component_generate_by_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_generate_by_name</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>component</span><span class=p>,</span> <span class=n>markdown_dir_path</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.component.ComponentGenerate.component_generate_by_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create markdown for the component using its source profiles.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>component_generate_by_name</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>component</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>,</span> <span class=n>markdown_dir_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create markdown for the component using its source profiles.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for component </span><span class=si>{</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>component</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>uri_name_map</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>cat_api_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>CatalogAPI</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>name_index</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=k>for</span> <span class=n>control_imp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>):</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span> <span class=o>=</span> <span class=n>control_imp</span>
+        <span class=n>source_profile_uri</span> <span class=o>=</span> <span class=n>control_imp</span><span class=o>.</span><span class=n>source</span>
+        <span class=c1># get the resolved profile catalog for this source, generating it if not already created</span>
+        <span class=k>if</span> <span class=n>source_profile_uri</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>cat_api_dict</span><span class=p>:</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>ComponentGenerate</span><span class=o>.</span><span class=n>_get_name_from_uri</span><span class=p>(</span><span class=n>source_profile_uri</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>name</span><span class=p>:</span>
+                <span class=n>name</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;source_</span><span class=si>{</span><span class=n>name_index</span><span class=si>:</span><span class=s1>03d</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=n>name_index</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>uri_name_map</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span> <span class=o>=</span> <span class=n>name</span>
+            <span class=n>resolved_catalog</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>source_profile_uri</span><span class=p>,</span> <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span>
+            <span class=p>)</span>
+            <span class=n>local_catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>resolved_catalog</span><span class=p>)</span>
+            <span class=n>cat_api_dict</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span> <span class=o>=</span> <span class=n>local_catalog_api</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>local_catalog_api</span> <span class=o>=</span> <span class=n>cat_api_dict</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span>
+        <span class=c1># insert the profile title (from title of resolved catalog) into the yaml header so it appears in md</span>
+        <span class=c1># different controls in the final catalog may have different profile titles if from different control_imps</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+
+        <span class=n>profile_title</span> <span class=o>=</span> <span class=n>local_catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_catalog_title</span><span class=p>()</span>
+        <span class=n>profile_header</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;title&#39;</span><span class=p>:</span> <span class=n>profile_title</span><span class=p>,</span> <span class=s1>&#39;href&#39;</span><span class=p>:</span> <span class=n>source_profile_uri</span><span class=p>}</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>][</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>]</span> <span class=o>=</span> <span class=n>profile_header</span>
+
+        <span class=n>sub_dir_name</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>uri_name_map</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>md_root</span> <span class=o>=</span> <span class=n>markdown_dir_path</span> <span class=o>/</span> <span class=n>sub_dir_name</span>
+        <span class=c1># write controls corresponding to this source catalog</span>
+        <span class=c1># if two controlimps load the same control, the second one will merge into the first</span>
+        <span class=c1># otherwise the full catalog will be written in subsets by control_imp</span>
+        <span class=c1># if an imp_req has a set param also in the control_imp. the imp_req value is used for the control</span>
+        <span class=n>cat_api_dict</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span><span class=o>.</span><span class=n>update_context</span><span class=p>(</span><span class=n>context</span><span class=p>)</span>
+        <span class=n>cat_api_dict</span><span class=p>[</span><span class=n>source_profile_uri</span><span class=p>]</span><span class=o>.</span><span class=n>write_catalog_as_markdown</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.author.component-functions>Functions<a href=#trestle.core.commands.author.component-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/consts/index.html b/latest/reference/API/trestle/core/commands/author/consts/index.html
new file mode 100644
index 000000000..9e7262a27
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/consts/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.consts module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/consts/ rel=canonical><link href=../component/ rel=prev><link href=../docs/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.consts - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.consts - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.consts module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/consts.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/consts/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.consts - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.consts module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/consts.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.consts class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.consts </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts class=md-nav__link> <span class=md-ellipsis> consts </span> </a> <nav class=md-nav aria-label=consts> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.EXCLUDE_HELP class=md-nav__link> <span class=md-ellipsis> EXCLUDE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.EXCLUDE_LONG class=md-nav__link> <span class=md-ellipsis> EXCLUDE_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.EXCLUDE_SHORT class=md-nav__link> <span class=md-ellipsis> EXCLUDE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GH_HELP class=md-nav__link> <span class=md-ellipsis> GH_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GH_LONG class=md-nav__link> <span class=md-ellipsis> GH_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GH_SHORT class=md-nav__link> <span class=md-ellipsis> GH_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GLOBAL_HELP class=md-nav__link> <span class=md-ellipsis> GLOBAL_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GLOBAL_LONG class=md-nav__link> <span class=md-ellipsis> GLOBAL_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GLOBAL_SHORT class=md-nav__link> <span class=md-ellipsis> GLOBAL_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.HEADER_VALIDATE_HELP class=md-nav__link> <span class=md-ellipsis> HEADER_VALIDATE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.HOV_HELP class=md-nav__link> <span class=md-ellipsis> HOV_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.HOV_LONG class=md-nav__link> <span class=md-ellipsis> HOV_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.HOV_SHORT class=md-nav__link> <span class=md-ellipsis> HOV_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.IGNORE_HELP class=md-nav__link> <span class=md-ellipsis> IGNORE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.LONG_HEADER_VALIDATE class=md-nav__link> <span class=md-ellipsis> LONG_HEADER_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.LONG_IGNORE class=md-nav__link> <span class=md-ellipsis> LONG_IGNORE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.LONG_README_VALIDATE class=md-nav__link> <span class=md-ellipsis> LONG_README_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.LONG_TEMPLATE_VERSION class=md-nav__link> <span class=md-ellipsis> LONG_TEMPLATE_VERSION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.MODE_ARG_NAME class=md-nav__link> <span class=md-ellipsis> MODE_ARG_NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.MODE_CHOICES class=md-nav__link> <span class=md-ellipsis> MODE_CHOICES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.README_VALIDATE_FOLDERS_HELP class=md-nav__link> <span class=md-ellipsis> README_VALIDATE_FOLDERS_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.README_VALIDATE_HELP class=md-nav__link> <span class=md-ellipsis> README_VALIDATE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.RECURSE_HELP class=md-nav__link> <span class=md-ellipsis> RECURSE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.RECURSE_LONG class=md-nav__link> <span class=md-ellipsis> RECURSE_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.RECURSE_SHORT class=md-nav__link> <span class=md-ellipsis> RECURSE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.REFERENCE_TEMPLATES class=md-nav__link> <span class=md-ellipsis> REFERENCE_TEMPLATES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.SHORT_HEADER_VALIDATE class=md-nav__link> <span class=md-ellipsis> SHORT_HEADER_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.SHORT_IGNORE class=md-nav__link> <span class=md-ellipsis> SHORT_IGNORE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.SHORT_README_VALIDATE class=md-nav__link> <span class=md-ellipsis> SHORT_README_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.SHORT_TEMPLATE_VERSION class=md-nav__link> <span class=md-ellipsis> SHORT_TEMPLATE_VERSION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.START_TEMPLATE_VERSION class=md-nav__link> <span class=md-ellipsis> START_TEMPLATE_VERSION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TASK_NAME_LONG class=md-nav__link> <span class=md-ellipsis> TASK_NAME_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TASK_NAME_SHORT class=md-nav__link> <span class=md-ellipsis> TASK_NAME_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_HEADER class=md-nav__link> <span class=md-ellipsis> TEMPLATE_TYPE_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_HELP class=md-nav__link> <span class=md-ellipsis> TEMPLATE_TYPE_VALIDATE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_LONG class=md-nav__link> <span class=md-ellipsis> TEMPLATE_TYPE_VALIDATE_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_SHORT class=md-nav__link> <span class=md-ellipsis> TEMPLATE_TYPE_VALIDATE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_VERSION_HEADER class=md-nav__link> <span class=md-ellipsis> TEMPLATE_VERSION_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_VERSION_HELP class=md-nav__link> <span class=md-ellipsis> TEMPLATE_VERSION_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TRESTLE_RESOURCES class=md-nav__link> <span class=md-ellipsis> TRESTLE_RESOURCES </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts class=md-nav__link> <span class=md-ellipsis> consts </span> </a> <nav class=md-nav aria-label=consts> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.EXCLUDE_HELP class=md-nav__link> <span class=md-ellipsis> EXCLUDE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.EXCLUDE_LONG class=md-nav__link> <span class=md-ellipsis> EXCLUDE_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.EXCLUDE_SHORT class=md-nav__link> <span class=md-ellipsis> EXCLUDE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GH_HELP class=md-nav__link> <span class=md-ellipsis> GH_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GH_LONG class=md-nav__link> <span class=md-ellipsis> GH_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GH_SHORT class=md-nav__link> <span class=md-ellipsis> GH_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GLOBAL_HELP class=md-nav__link> <span class=md-ellipsis> GLOBAL_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GLOBAL_LONG class=md-nav__link> <span class=md-ellipsis> GLOBAL_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.GLOBAL_SHORT class=md-nav__link> <span class=md-ellipsis> GLOBAL_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.HEADER_VALIDATE_HELP class=md-nav__link> <span class=md-ellipsis> HEADER_VALIDATE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.HOV_HELP class=md-nav__link> <span class=md-ellipsis> HOV_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.HOV_LONG class=md-nav__link> <span class=md-ellipsis> HOV_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.HOV_SHORT class=md-nav__link> <span class=md-ellipsis> HOV_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.IGNORE_HELP class=md-nav__link> <span class=md-ellipsis> IGNORE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.LONG_HEADER_VALIDATE class=md-nav__link> <span class=md-ellipsis> LONG_HEADER_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.LONG_IGNORE class=md-nav__link> <span class=md-ellipsis> LONG_IGNORE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.LONG_README_VALIDATE class=md-nav__link> <span class=md-ellipsis> LONG_README_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.LONG_TEMPLATE_VERSION class=md-nav__link> <span class=md-ellipsis> LONG_TEMPLATE_VERSION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.MODE_ARG_NAME class=md-nav__link> <span class=md-ellipsis> MODE_ARG_NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.MODE_CHOICES class=md-nav__link> <span class=md-ellipsis> MODE_CHOICES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.README_VALIDATE_FOLDERS_HELP class=md-nav__link> <span class=md-ellipsis> README_VALIDATE_FOLDERS_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.README_VALIDATE_HELP class=md-nav__link> <span class=md-ellipsis> README_VALIDATE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.RECURSE_HELP class=md-nav__link> <span class=md-ellipsis> RECURSE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.RECURSE_LONG class=md-nav__link> <span class=md-ellipsis> RECURSE_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.RECURSE_SHORT class=md-nav__link> <span class=md-ellipsis> RECURSE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.REFERENCE_TEMPLATES class=md-nav__link> <span class=md-ellipsis> REFERENCE_TEMPLATES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.SHORT_HEADER_VALIDATE class=md-nav__link> <span class=md-ellipsis> SHORT_HEADER_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.SHORT_IGNORE class=md-nav__link> <span class=md-ellipsis> SHORT_IGNORE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.SHORT_README_VALIDATE class=md-nav__link> <span class=md-ellipsis> SHORT_README_VALIDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.SHORT_TEMPLATE_VERSION class=md-nav__link> <span class=md-ellipsis> SHORT_TEMPLATE_VERSION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.START_TEMPLATE_VERSION class=md-nav__link> <span class=md-ellipsis> START_TEMPLATE_VERSION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TASK_NAME_LONG class=md-nav__link> <span class=md-ellipsis> TASK_NAME_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TASK_NAME_SHORT class=md-nav__link> <span class=md-ellipsis> TASK_NAME_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_HEADER class=md-nav__link> <span class=md-ellipsis> TEMPLATE_TYPE_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_HELP class=md-nav__link> <span class=md-ellipsis> TEMPLATE_TYPE_VALIDATE_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_LONG class=md-nav__link> <span class=md-ellipsis> TEMPLATE_TYPE_VALIDATE_LONG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_SHORT class=md-nav__link> <span class=md-ellipsis> TEMPLATE_TYPE_VALIDATE_SHORT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_VERSION_HEADER class=md-nav__link> <span class=md-ellipsis> TEMPLATE_VERSION_HEADER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TEMPLATE_VERSION_HELP class=md-nav__link> <span class=md-ellipsis> TEMPLATE_VERSION_HELP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.consts.TRESTLE_RESOURCES class=md-nav__link> <span class=md-ellipsis> TRESTLE_RESOURCES </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.consts</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.consts class="doc doc-heading"> <code>trestle.core.commands.author.consts</code> <a href=#trestle.core.commands.author.consts class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Constants associated with trestle author commands to decrease duplication.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.consts-attributes>Attributes<a href=#trestle.core.commands.author.consts-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.EXCLUDE_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>EXCLUDE_HELP</span> <span class=o>=</span> <span class=s1>&#39;[DEPRECATED: use --ignore instead] The name of a folder, relative to the root of the trestle project,&#39;</span> <span class=o>+</span> <span class=s1>&#39;e.g. architecture or architecture/infrastructure.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.EXCLUDE_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.EXCLUDE_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>EXCLUDE_LONG</span> <span class=o>=</span> <span class=s1>&#39;--exclude&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.EXCLUDE_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.EXCLUDE_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>EXCLUDE_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-ex&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.EXCLUDE_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.GH_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>GH_HELP</span> <span class=o>=</span> <span class=s2>&quot;Governed heading: Heading where for each line is a superset of the template&#39;s content&quot;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.GH_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.GH_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>GH_LONG</span> <span class=o>=</span> <span class=s1>&#39;--governed-heading&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.GH_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.GH_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>GH_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-gh&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.GH_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.GLOBAL_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>GLOBAL_HELP</span> <span class=o>=</span> <span class=s1>&#39;Use a consistent template defined in .trestle/author/__global__,&#39;</span> <span class=o>+</span> <span class=s1>&#39;if used without a task name applies to all files within the repository.&#39;</span> <span class=o>+</span> <span class=s1>&#39;</span><span class=se>\n\n</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.GLOBAL_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.GLOBAL_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>GLOBAL_LONG</span> <span class=o>=</span> <span class=s1>&#39;--global&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.GLOBAL_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.GLOBAL_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>GLOBAL_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-g&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.GLOBAL_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.HEADER_VALIDATE_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>HEADER_VALIDATE_HELP</span> <span class=o>=</span> <span class=s1>&#39;Validate the structure of a markdown yaml header and/or drawio metadata on the first tab.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.HEADER_VALIDATE_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.HOV_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>HOV_HELP</span> <span class=o>=</span> <span class=s1>&#39;Only validate the header / metadata for files. Includes project structure where appropriate.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.HOV_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.HOV_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>HOV_LONG</span> <span class=o>=</span> <span class=s1>&#39;--header-only-validate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.HOV_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.HOV_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>HOV_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-hov&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.HOV_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.IGNORE_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>IGNORE_HELP</span> <span class=o>=</span> <span class=s1>&#39;Provide a regex to ignore files and folders with matching name from validation (i.e. ^_.*).&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.IGNORE_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.LONG_HEADER_VALIDATE class="doc doc-heading"> <code class="highlight language-python"><span class=n>LONG_HEADER_VALIDATE</span> <span class=o>=</span> <span class=s1>&#39;--header-validate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.LONG_HEADER_VALIDATE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.LONG_IGNORE class="doc doc-heading"> <code class="highlight language-python"><span class=n>LONG_IGNORE</span> <span class=o>=</span> <span class=s1>&#39;--ignore&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.LONG_IGNORE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.LONG_README_VALIDATE class="doc doc-heading"> <code class="highlight language-python"><span class=n>LONG_README_VALIDATE</span> <span class=o>=</span> <span class=s1>&#39;--readme-validate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.LONG_README_VALIDATE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.LONG_TEMPLATE_VERSION class="doc doc-heading"> <code class="highlight language-python"><span class=n>LONG_TEMPLATE_VERSION</span> <span class=o>=</span> <span class=s1>&#39;--template-version&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.LONG_TEMPLATE_VERSION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.MODE_ARG_NAME class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODE_ARG_NAME</span> <span class=o>=</span> <span class=s1>&#39;mode&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.MODE_ARG_NAME class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.MODE_CHOICES class="doc doc-heading"> <code class="highlight language-python"><span class=n>MODE_CHOICES</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;validate&#39;</span><span class=p>,</span> <span class=s1>&#39;template-validate&#39;</span><span class=p>,</span> <span class=s1>&#39;setup&#39;</span><span class=p>,</span> <span class=s1>&#39;create-sample&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.MODE_CHOICES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.README_VALIDATE_FOLDERS_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>README_VALIDATE_FOLDERS_HELP</span> <span class=o>=</span> <span class=s1>&#39;Enable to validate README.md files. Required if readme files are included in the&#39;</span> <span class=o>+</span> <span class=s1>&#39;template.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.README_VALIDATE_FOLDERS_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.README_VALIDATE_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>README_VALIDATE_HELP</span> <span class=o>=</span> <span class=s1>&#39;Enable to validate README.md files otherwise README files are excluded.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.README_VALIDATE_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.RECURSE_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>RECURSE_HELP</span> <span class=o>=</span> <span class=s1>&#39;Recurse and validate any subdirectories.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.RECURSE_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.RECURSE_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>RECURSE_LONG</span> <span class=o>=</span> <span class=s1>&#39;--recurse&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.RECURSE_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.RECURSE_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>RECURSE_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-r&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.RECURSE_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.REFERENCE_TEMPLATES class="doc doc-heading"> <code class="highlight language-python"><span class=n>REFERENCE_TEMPLATES</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;md&#39;</span><span class=p>:</span> <span class=s1>&#39;template.md&#39;</span><span class=p>,</span> <span class=s1>&#39;drawio&#39;</span><span class=p>:</span> <span class=s1>&#39;template.drawio&#39;</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.REFERENCE_TEMPLATES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.SHORT_HEADER_VALIDATE class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHORT_HEADER_VALIDATE</span> <span class=o>=</span> <span class=s1>&#39;-hv&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.SHORT_HEADER_VALIDATE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.SHORT_IGNORE class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHORT_IGNORE</span> <span class=o>=</span> <span class=s1>&#39;-ig&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.SHORT_IGNORE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.SHORT_README_VALIDATE class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHORT_README_VALIDATE</span> <span class=o>=</span> <span class=s1>&#39;-rv&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.SHORT_README_VALIDATE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.SHORT_TEMPLATE_VERSION class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHORT_TEMPLATE_VERSION</span> <span class=o>=</span> <span class=s1>&#39;-tv&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.SHORT_TEMPLATE_VERSION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.START_TEMPLATE_VERSION class="doc doc-heading"> <code class="highlight language-python"><span class=n>START_TEMPLATE_VERSION</span> <span class=o>=</span> <span class=s1>&#39;0.0.1&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.START_TEMPLATE_VERSION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.TASK_NAME_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TASK_NAME_LONG</span> <span class=o>=</span> <span class=s1>&#39;--task-name&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.TASK_NAME_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.TASK_NAME_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>TASK_NAME_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-tn&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.TASK_NAME_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.TEMPLATE_TYPE_HEADER class="doc doc-heading"> <code class="highlight language-python"><span class=n>TEMPLATE_TYPE_HEADER</span> <span class=o>=</span> <span class=s1>&#39;x-trestle-template-type&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_HEADER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>TEMPLATE_TYPE_VALIDATE_HELP</span> <span class=o>=</span> <span class=s1>&#39;Validate that template and instance files match with x-trestle-template-type field&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_LONG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TEMPLATE_TYPE_VALIDATE_LONG</span> <span class=o>=</span> <span class=s1>&#39;--validate-template-type&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_LONG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_SHORT class="doc doc-heading"> <code class="highlight language-python"><span class=n>TEMPLATE_TYPE_VALIDATE_SHORT</span> <span class=o>=</span> <span class=s1>&#39;-vtt&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_SHORT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.TEMPLATE_VERSION_HEADER class="doc doc-heading"> <code class="highlight language-python"><span class=n>TEMPLATE_VERSION_HEADER</span> <span class=o>=</span> <span class=s1>&#39;x-trestle-template-version&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.TEMPLATE_VERSION_HEADER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.TEMPLATE_VERSION_HELP class="doc doc-heading"> <code class="highlight language-python"><span class=n>TEMPLATE_VERSION_HELP</span> <span class=o>=</span> <span class=s1>&#39;Specify a template version to use for the task, latest version will be used by default.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.TEMPLATE_VERSION_HELP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.consts.TRESTLE_RESOURCES class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_RESOURCES</span> <span class=o>=</span> <span class=s1>&#39;trestle.resources&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.consts.TRESTLE_RESOURCES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/docs/index.html b/latest/reference/API/trestle/core/commands/author/docs/index.html
new file mode 100644
index 000000000..92a468270
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/docs/index.html
@@ -0,0 +1,806 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.docs module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/docs/ rel=canonical><link href=../consts/ rel=prev><link href=../folders/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.docs - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.docs - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.docs module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/docs.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/docs/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.docs - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.docs module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/docs.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.docs class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.docs </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs class=md-nav__link> <span class=md-ellipsis> docs </span> </a> <nav class=md-nav aria-label=docs> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs class=md-nav__link> <span class=md-ellipsis> Docs </span> </a> <nav class=md-nav aria-label=Docs> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.template_name class=md-nav__link> <span class=md-ellipsis> template_name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.create_sample class=md-nav__link> <span class=md-ellipsis> create_sample </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.setup_template_governed_docs class=md-nav__link> <span class=md-ellipsis> setup_template_governed_docs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.template_validate class=md-nav__link> <span class=md-ellipsis> template_validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs class=md-nav__link> <span class=md-ellipsis> docs </span> </a> <nav class=md-nav aria-label=docs> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs class=md-nav__link> <span class=md-ellipsis> Docs </span> </a> <nav class=md-nav aria-label=Docs> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.template_name class=md-nav__link> <span class=md-ellipsis> template_name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.create_sample class=md-nav__link> <span class=md-ellipsis> create_sample </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.setup_template_governed_docs class=md-nav__link> <span class=md-ellipsis> setup_template_governed_docs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.template_validate class=md-nav__link> <span class=md-ellipsis> template_validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs.Docs.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.docs-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.docs</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.docs class="doc doc-heading"> <code>trestle.core.commands.author.docs</code> <a href=#trestle.core.commands.author.docs class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle author docs sub-command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.docs-attributes>Attributes<a href=#trestle.core.commands.author.docs-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.docs.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.docs.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.docs-classes>Classes<a href=#trestle.core.commands.author.docs-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.docs.Docs class="doc doc-heading"> <code>Docs</code> <a href=#trestle.core.commands.author.docs.Docs class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Markdown governed documents - enforcing consistent markdown across a set of files.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/docs.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Docs</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Markdown governed documents - enforcing consistent markdown across a set of files.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;docs&#39;</span>
+
+    <span class=n>template_name</span> <span class=o>=</span> <span class=s1>&#39;template.md&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>GH_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>GH_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>GH_HELP</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_HEADER_VALIDATE</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_HEADER_VALIDATE</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>HEADER_VALIDATE_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_TEMPLATE_VERSION</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_TEMPLATE_VERSION</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>HOV_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>HOV_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>HOV_HELP</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_IGNORE</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_IGNORE</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>IGNORE_HELP</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>RECURSE_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>RECURSE_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>RECURSE_HELP</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=n>author_const</span><span class=o>.</span><span class=n>MODE_ARG_NAME</span><span class=p>,</span> <span class=n>choices</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>MODE_CHOICES</span><span class=p>)</span>
+        <span class=n>tn_help_str</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span>
+            <span class=p>[</span>
+                <span class=s1>&#39;The name of the the task to be governed.&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;&#39;</span>
+                <span class=s1>&#39;The template file is at .trestle/author/[task-name]/template.md&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;Note that by default this will automatically enforce the task.&#39;</span>
+            <span class=p>]</span>
+        <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>TASK_NAME_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TASK_NAME_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>tn_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_README_VALIDATE</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_README_VALIDATE</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>README_VALIDATE_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_VALIDATE_SHORT</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_VALIDATE_LONG</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_VALIDATE_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=mi>1</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_initialize</span><span class=p>(</span><span class=n>args</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>status</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;create-sample&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>create_sample</span><span class=p>()</span>
+
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;template-validate&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_validate</span><span class=p>(</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>governed_heading</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>header_validate</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>header_only_validate</span><span class=p>,</span>
+                <span class=p>)</span>
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;setup&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>setup_template_governed_docs</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>template_version</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;validate&#39;</span><span class=p>:</span>
+                <span class=c1># mode is validate</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>validate</span><span class=p>(</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>governed_heading</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>header_validate</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>header_only_validate</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>recurse</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>readme_validate</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>template_version</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>ignore</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>validate_template_type</span>
+                <span class=p>)</span>
+
+            <span class=k>return</span> <span class=n>status</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error occurred when running trestle author docs&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>setup_template_governed_docs</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create structure to allow markdown template enforcement.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Unix return code.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_template_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Aborting setup&#39;</span><span class=p>)</span>
+        <span class=n>template_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_name</span>
+        <span class=k>if</span> <span class=n>template_file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+        <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span><span class=s1>&#39;template.md&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>template_file</span><span class=p>,</span> <span class=n>template_version</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template file setup for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task directory is </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>create_sample</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Presuming the template exists, copy into a sample markdown file with an index.&quot;&quot;&quot;</span>
+        <span class=n>template_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_name</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_template_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Aborting setup&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>template_file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;No template file ... exiting.&#39;</span><span class=p>)</span>
+
+        <span class=n>index</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=n>candidate_task</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>_</span><span class=si>{</span><span class=n>index</span><span class=si>:</span><span class=s1>03d</span><span class=si>}</span><span class=s1>.md&#39;</span>
+            <span class=k>if</span> <span class=n>candidate_task</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                <span class=n>index</span> <span class=o>=</span> <span class=n>index</span> <span class=o>+</span> <span class=mi>1</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>shutil</span><span class=o>.</span><span class=n>copy</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>template_file</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>candidate_task</span><span class=p>))</span>
+                <span class=k>break</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>template_validate</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>heading</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Validate that the template is acceptable markdown.&quot;&quot;&quot;</span>
+        <span class=n>template_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_name</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_template_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Aborting setup, template directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=si>}</span><span class=s1> is invalid.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>template_file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Required template file: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist. Exiting.&#39;</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+            <span class=n>validate_body</span> <span class=o>=</span> <span class=kc>False</span> <span class=k>if</span> <span class=n>validate_only_header</span> <span class=k>else</span> <span class=kc>True</span>
+            <span class=n>md_api</span><span class=o>.</span><span class=n>load_validator_with_template</span><span class=p>(</span>
+                <span class=n>template_file</span><span class=p>,</span> <span class=n>validate_header</span> <span class=ow>or</span> <span class=n>validate_only_header</span><span class=p>,</span> <span class=n>validate_body</span><span class=p>,</span> <span class=n>heading</span><span class=p>,</span> <span class=kc>True</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>ex</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> failed to validate due to </span><span class=si>{</span><span class=n>ex</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;TEMPLATES VALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_validate_template_dir</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Template directory should only have template file.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>child</span> <span class=ow>in</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>):</span>
+            <span class=c1># Only allowable template file in the directory is the template directory.</span>
+            <span class=k>if</span> <span class=n>child</span><span class=o>.</span><span class=n>name</span> <span class=o>!=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_name</span> <span class=ow>and</span> <span class=n>child</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>!=</span> <span class=s1>&#39;readme.md&#39;</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unknown file: </span><span class=si>{</span><span class=n>child</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> in template directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>_validate_dir</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>governed_heading</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>md_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>template_version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>ignore</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>validate_by_type_field</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Validate md files in a directory with option to recurse.</span>
+
+<span class=sd>        Template version will be fetched from the instance header.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># status is a linux returncode</span>
+        <span class=n>status</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>for</span> <span class=n>item_path</span> <span class=ow>in</span> <span class=n>md_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_local_and_visible</span><span class=p>(</span><span class=n>item_path</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>item_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>item_path</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;Unexpected file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>item_path</span><span class=p>)</span><span class=si>}</span><span class=s1> in folder </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>md_dir</span><span class=p>)</span><span class=si>}</span><span class=s1>, skipping.&#39;</span>
+                        <span class=p>)</span>
+                        <span class=k>continue</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>readme_validate</span> <span class=ow>and</span> <span class=n>item_path</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;readme.md&#39;</span><span class=p>:</span>
+                        <span class=k>continue</span>
+
+                    <span class=k>if</span> <span class=n>ignore</span><span class=p>:</span>
+                        <span class=n>p</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>ignore</span><span class=p>)</span>
+                        <span class=n>matched</span> <span class=o>=</span> <span class=n>p</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>item_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+                        <span class=k>if</span> <span class=n>matched</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Ignoring file </span><span class=si>{</span><span class=n>item_path</span><span class=si>}</span><span class=s1> from validation.&#39;</span><span class=p>)</span>
+                            <span class=k>continue</span>
+
+                    <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+                    <span class=k>if</span> <span class=n>template_version</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+                        <span class=n>template_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_name</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>instance_version</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>fetch_value_from_header</span><span class=p>(</span>
+                            <span class=n>item_path</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HEADER</span>
+                        <span class=p>)</span>
+                        <span class=k>if</span> <span class=n>instance_version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                            <span class=n>instance_version</span> <span class=o>=</span> <span class=s1>&#39;0.0.1&#39;</span>
+                        <span class=n>versione_template_dir</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_versioned_template_dir</span><span class=p>(</span>
+                            <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>instance_version</span>
+                        <span class=p>)</span>
+                        <span class=c1># checks on naming template name out of type header if needed</span>
+                        <span class=k>if</span> <span class=n>validate_by_type_field</span><span class=p>:</span>
+                            <span class=c1># get template name out of its type which essentially needs to be the same</span>
+                            <span class=n>template_name</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>fetch_value_from_header</span><span class=p>(</span>
+                                <span class=n>item_path</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_HEADER</span>
+                            <span class=p>)</span>
+                            <span class=c1># throw an error if template type is not present</span>
+                            <span class=k>if</span> <span class=n>template_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                                <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span>
+                                    <span class=sa>f</span><span class=s1>&#39;INVALID: Instance file </span><span class=si>{</span><span class=n>item_path</span><span class=si>}</span><span class=s1> does not have&#39;</span>
+                                    <span class=sa>f</span><span class=s1>&#39; </span><span class=si>{</span><span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_HEADER</span><span class=si>}</span><span class=s1>&#39;</span>
+                                    <span class=s1>&#39; field in its header and can not be validated using optional parameter validate&#39;</span>
+                                    <span class=s1>&#39; template type field&#39;</span>
+                                <span class=p>)</span>
+                                <span class=n>status</span> <span class=o>=</span> <span class=mi>1</span>
+                                <span class=k>return</span> <span class=n>status</span>
+                            <span class=n>template_name</span> <span class=o>=</span> <span class=n>template_name</span> <span class=o>+</span> <span class=s1>&#39;.md&#39;</span>
+                            <span class=n>template_file</span> <span class=o>=</span> <span class=n>versione_template_dir</span> <span class=o>/</span> <span class=n>template_name</span>
+                        <span class=k>else</span><span class=p>:</span>  <span class=c1># continues regular flow without template type</span>
+                            <span class=n>template_file</span> <span class=o>=</span> <span class=n>versione_template_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_name</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>template_file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;Required template file: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist. Exiting.&#39;</span>
+                        <span class=p>)</span>
+                    <span class=n>md_api</span><span class=o>.</span><span class=n>load_validator_with_template</span><span class=p>(</span>
+                        <span class=n>template_file</span><span class=p>,</span> <span class=n>validate_header</span><span class=p>,</span> <span class=ow>not</span> <span class=n>validate_only_header</span><span class=p>,</span> <span class=n>governed_heading</span>
+                    <span class=p>)</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>md_api</span><span class=o>.</span><span class=n>validate_instance</span><span class=p>(</span><span class=n>item_path</span><span class=p>):</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>item_path</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                        <span class=n>status</span> <span class=o>=</span> <span class=mi>1</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>item_path</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>elif</span> <span class=n>recurse</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>ignore</span><span class=p>:</span>
+                        <span class=n>p</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>ignore</span><span class=p>)</span>
+                        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>match</span><span class=p>,</span> <span class=nb>str</span><span class=p>(</span><span class=n>item_path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>md_dir</span><span class=p>))</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;/&#39;</span><span class=p>))))</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+                            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Ignoring directory </span><span class=si>{</span><span class=n>item_path</span><span class=si>}</span><span class=s1> from validation.&#39;</span><span class=p>)</span>
+                            <span class=k>continue</span>
+                    <span class=n>rc</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_dir</span><span class=p>(</span>
+                        <span class=n>governed_heading</span><span class=p>,</span>
+                        <span class=n>item_path</span><span class=p>,</span>
+                        <span class=n>validate_header</span><span class=p>,</span>
+                        <span class=n>validate_only_header</span><span class=p>,</span>
+                        <span class=n>recurse</span><span class=p>,</span>
+                        <span class=n>readme_validate</span><span class=p>,</span>
+                        <span class=n>template_version</span><span class=p>,</span>
+                        <span class=n>ignore</span><span class=p>,</span>
+                        <span class=n>validate_by_type_field</span>
+                    <span class=p>)</span>
+                    <span class=k>if</span> <span class=n>rc</span> <span class=o>!=</span> <span class=mi>0</span><span class=p>:</span>
+                        <span class=n>status</span> <span class=o>=</span> <span class=n>rc</span>
+
+        <span class=k>return</span> <span class=n>status</span>
+
+    <span class=k>def</span> <span class=nf>validate</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>governed_heading</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>ignore</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>validate_by_type_field</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Validate task.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            governed_heading: A heading for which structural enforcement (see online docs).</span>
+<span class=sd>            validate_header: Whether or not to validate the key structure of the yaml header to the markdown document.</span>
+<span class=sd>            validate_only_header: Whether to validate just the yaml header.</span>
+<span class=sd>            recurse: Whether to allow validated files to be in a directory tree.</span>
+<span class=sd>            readme_validate: Whether to validate readme files, otherwise they will be ignored.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Return code to be used for the command.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist. Exiting validate.&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_dir</span><span class=p>(</span>
+            <span class=n>governed_heading</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>,</span>
+            <span class=n>validate_header</span><span class=p>,</span>
+            <span class=n>validate_only_header</span><span class=p>,</span>
+            <span class=n>recurse</span><span class=p>,</span>
+            <span class=n>readme_validate</span><span class=p>,</span>
+            <span class=n>template_version</span><span class=p>,</span>
+            <span class=n>ignore</span><span class=p>,</span>
+            <span class=n>validate_by_type_field</span>
+        <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.docs.Docs-attributes>Attributes<a href=#trestle.core.commands.author.docs.Docs-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.docs.Docs.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;docs&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.docs.Docs.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.docs.Docs.template_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_name</span> <span class=o>=</span> <span class=s1>&#39;template.md&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.docs.Docs.template_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.docs.Docs-functions>Functions<a href=#trestle.core.commands.author.docs.Docs-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.docs.Docs.create_sample class="doc doc-heading"> <code class="highlight language-python"><span class=n>create_sample</span><span class=p>()</span></code> <a href=#trestle.core.commands.author.docs.Docs.create_sample class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Presuming the template exists, copy into a sample markdown file with an index.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/docs.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>create_sample</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Presuming the template exists, copy into a sample markdown file with an index.&quot;&quot;&quot;</span>
+    <span class=n>template_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_name</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_template_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Aborting setup&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>template_file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;No template file ... exiting.&#39;</span><span class=p>)</span>
+
+    <span class=n>index</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+        <span class=n>candidate_task</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>_</span><span class=si>{</span><span class=n>index</span><span class=si>:</span><span class=s1>03d</span><span class=si>}</span><span class=s1>.md&#39;</span>
+        <span class=k>if</span> <span class=n>candidate_task</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=n>index</span> <span class=o>=</span> <span class=n>index</span> <span class=o>+</span> <span class=mi>1</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>shutil</span><span class=o>.</span><span class=n>copy</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>template_file</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>candidate_task</span><span class=p>))</span>
+            <span class=k>break</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.docs.Docs.setup_template_governed_docs class="doc doc-heading"> <code class="highlight language-python"><span class=n>setup_template_governed_docs</span><span class=p>(</span><span class=n>template_version</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.docs.Docs.setup_template_governed_docs class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create structure to allow markdown template enforcement.</p> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>Unix return code.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/docs.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>setup_template_governed_docs</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create structure to allow markdown template enforcement.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Unix return code.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_template_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Aborting setup&#39;</span><span class=p>)</span>
+    <span class=n>template_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_name</span>
+    <span class=k>if</span> <span class=n>template_file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+    <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span><span class=s1>&#39;template.md&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>template_file</span><span class=p>,</span> <span class=n>template_version</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template file setup for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task directory is </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.docs.Docs.template_validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_validate</span><span class=p>(</span><span class=n>heading</span><span class=p>,</span> <span class=n>validate_header</span><span class=p>,</span> <span class=n>validate_only_header</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.docs.Docs.template_validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate that the template is acceptable markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/docs.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>template_validate</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>heading</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validate that the template is acceptable markdown.&quot;&quot;&quot;</span>
+    <span class=n>template_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_name</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_template_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Aborting setup, template directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=si>}</span><span class=s1> is invalid.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>template_file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Required template file: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist. Exiting.&#39;</span><span class=p>)</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+        <span class=n>validate_body</span> <span class=o>=</span> <span class=kc>False</span> <span class=k>if</span> <span class=n>validate_only_header</span> <span class=k>else</span> <span class=kc>True</span>
+        <span class=n>md_api</span><span class=o>.</span><span class=n>load_validator_with_template</span><span class=p>(</span>
+            <span class=n>template_file</span><span class=p>,</span> <span class=n>validate_header</span> <span class=ow>or</span> <span class=n>validate_only_header</span><span class=p>,</span> <span class=n>validate_body</span><span class=p>,</span> <span class=n>heading</span><span class=p>,</span> <span class=kc>True</span>
+        <span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>ex</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> failed to validate due to </span><span class=si>{</span><span class=n>ex</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;TEMPLATES VALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.docs.Docs.validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate</span><span class=p>(</span><span class=n>governed_heading</span><span class=p>,</span> <span class=n>validate_header</span><span class=p>,</span> <span class=n>validate_only_header</span><span class=p>,</span> <span class=n>recurse</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>,</span> <span class=n>template_version</span><span class=p>,</span> <span class=n>ignore</span><span class=p>,</span> <span class=n>validate_by_type_field</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.docs.Docs.validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate task.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>governed_heading</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>A heading for which structural enforcement (see online docs).</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>validate_header</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether or not to validate the key structure of the yaml header to the markdown document.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>validate_only_header</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to validate just the yaml header.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>recurse</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to allow validated files to be in a directory tree.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>readme_validate</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to validate readme files, otherwise they will be ignored.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>Return code to be used for the command.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/docs.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>validate</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>governed_heading</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>ignore</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>validate_by_type_field</span><span class=p>:</span> <span class=nb>bool</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Validate task.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        governed_heading: A heading for which structural enforcement (see online docs).</span>
+<span class=sd>        validate_header: Whether or not to validate the key structure of the yaml header to the markdown document.</span>
+<span class=sd>        validate_only_header: Whether to validate just the yaml header.</span>
+<span class=sd>        recurse: Whether to allow validated files to be in a directory tree.</span>
+<span class=sd>        readme_validate: Whether to validate readme files, otherwise they will be ignored.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Return code to be used for the command.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist. Exiting validate.&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_dir</span><span class=p>(</span>
+        <span class=n>governed_heading</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>,</span>
+        <span class=n>validate_header</span><span class=p>,</span>
+        <span class=n>validate_only_header</span><span class=p>,</span>
+        <span class=n>recurse</span><span class=p>,</span>
+        <span class=n>readme_validate</span><span class=p>,</span>
+        <span class=n>template_version</span><span class=p>,</span>
+        <span class=n>ignore</span><span class=p>,</span>
+        <span class=n>validate_by_type_field</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.author.docs-functions>Functions<a href=#trestle.core.commands.author.docs-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/folders/index.html b/latest/reference/API/trestle/core/commands/author/folders/index.html
new file mode 100644
index 000000000..9a767c6c0
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/folders/index.html
@@ -0,0 +1,1036 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.folders module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/folders/ rel=canonical><link href=../docs/ rel=prev><link href=../headers/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.folders - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.folders - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.folders module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/folders.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/folders/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.folders - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.folders module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/folders.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.folders class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.folders </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders class=md-nav__link> <span class=md-ellipsis> folders </span> </a> <nav class=md-nav aria-label=folders> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders class=md-nav__link> <span class=md-ellipsis> Folders </span> </a> <nav class=md-nav aria-label=Folders> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.create_sample class=md-nav__link> <span class=md-ellipsis> create_sample </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.setup_template class=md-nav__link> <span class=md-ellipsis> setup_template </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.template_validate class=md-nav__link> <span class=md-ellipsis> template_validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders class=md-nav__link> <span class=md-ellipsis> folders </span> </a> <nav class=md-nav aria-label=folders> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders class=md-nav__link> <span class=md-ellipsis> Folders </span> </a> <nav class=md-nav aria-label=Folders> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.create_sample class=md-nav__link> <span class=md-ellipsis> create_sample </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.setup_template class=md-nav__link> <span class=md-ellipsis> setup_template </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.template_validate class=md-nav__link> <span class=md-ellipsis> template_validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders.Folders.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.folders-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.folders</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.folders class="doc doc-heading"> <code>trestle.core.commands.author.folders</code> <a href=#trestle.core.commands.author.folders class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle author docs sub-command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.folders-attributes>Attributes<a href=#trestle.core.commands.author.folders-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.folders.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.folders.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.folders-classes>Classes<a href=#trestle.core.commands.author.folders-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.folders.Folders class="doc doc-heading"> <code>Folders</code> <a href=#trestle.core.commands.author.folders.Folders class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Markdown governed folders - enforcing consistent files and templates across directories.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/folders.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Folders</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Markdown governed folders - enforcing consistent files and templates across directories.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;folders&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>GH_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>GH_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>GH_HELP</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_HEADER_VALIDATE</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_HEADER_VALIDATE</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>HEADER_VALIDATE_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>HOV_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>HOV_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>HOV_HELP</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_TEMPLATE_VERSION</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_TEMPLATE_VERSION</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_IGNORE</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_IGNORE</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>IGNORE_HELP</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=n>author_const</span><span class=o>.</span><span class=n>MODE_ARG_NAME</span><span class=p>,</span> <span class=n>choices</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>MODE_CHOICES</span><span class=p>)</span>
+        <span class=n>tn_help_str</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span>
+            <span class=p>[</span>
+                <span class=s1>&#39;The name of the the task to be governed.&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;The template files are at .trestle/author/[task-name],&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;where the directory tree established and the markdown files within that directory&#39;</span>
+                <span class=o>+</span> <span class=s1>&#39;tree are enforced.&#39;</span>
+            <span class=p>]</span>
+        <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>TASK_NAME_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TASK_NAME_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>tn_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_README_VALIDATE</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_README_VALIDATE</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>README_VALIDATE_FOLDERS_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_VALIDATE_SHORT</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_VALIDATE_LONG</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_VALIDATE_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_initialize</span><span class=p>(</span><span class=n>args</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error when initializing trestle folders command with args: </span><span class=si>{</span><span class=n>args</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;create-sample&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>create_sample</span><span class=p>()</span>
+
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;template-validate&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_validate</span><span class=p>(</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>header_validate</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>header_only_validate</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>governed_heading</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>readme_validate</span>
+                <span class=p>)</span>
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;setup&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>setup_template</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>template_version</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;validate&#39;</span><span class=p>:</span>
+                <span class=c1># mode is validate</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>validate</span><span class=p>(</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>header_validate</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>header_only_validate</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>governed_heading</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>readme_validate</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>template_version</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>ignore</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>validate_template_type</span>
+                <span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleIncorrectArgsError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unsupported mode: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>mode</span><span class=si>}</span><span class=s1> for folders command.&#39;</span><span class=p>)</span>
+
+            <span class=k>return</span> <span class=n>status</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error occurred when running trestle author folders&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>setup_template</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create structure to allow markdown template enforcement.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+
+        <span class=n>template_file_a_md</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=s1>&#39;a_template.md&#39;</span>
+        <span class=n>template_file_another_md</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=s1>&#39;another_template.md&#39;</span>
+        <span class=n>template_file_drawio</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=s1>&#39;architecture.drawio&#39;</span>
+        <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span>
+            <span class=s1>&#39;template.md&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>template_file_a_md</span><span class=p>,</span> <span class=n>template_version</span>
+        <span class=p>)</span>
+        <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span>
+            <span class=s1>&#39;template.md&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>template_file_another_md</span><span class=p>,</span> <span class=n>template_version</span>
+        <span class=p>)</span>
+        <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span>
+            <span class=s1>&#39;template.drawio&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>template_file_drawio</span><span class=p>,</span> <span class=n>template_version</span>
+        <span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>template_validate</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>heading</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Validate that the template is acceptable markdown.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Template directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span><span class=si>}</span><span class=s1> for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span>
+            <span class=p>)</span>
+        <span class=c1># get list of files:</span>
+        <span class=n>template_files</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>rglob</span><span class=p>(</span><span class=s1>&#39;*&#39;</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>template_file</span> <span class=ow>in</span> <span class=n>template_files</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_local_and_visible</span><span class=p>(</span><span class=n>template_file</span><span class=p>):</span>
+                    <span class=k>continue</span>
+                <span class=k>elif</span> <span class=n>template_file</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                    <span class=k>continue</span>
+                <span class=k>elif</span> <span class=n>template_file</span><span class=o>.</span><span class=n>suffix</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>readme_validate</span> <span class=ow>and</span> <span class=n>template_file</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;readme.md&#39;</span><span class=p>:</span>
+                        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Template directory contains a readme.md file and readme validation is off.&#39;</span><span class=p>)</span>
+
+                    <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+                    <span class=n>md_api</span><span class=o>.</span><span class=n>load_validator_with_template</span><span class=p>(</span>
+                        <span class=n>template_file</span><span class=p>,</span> <span class=n>validate_header</span><span class=p>,</span> <span class=ow>not</span> <span class=n>validate_only_header</span><span class=p>,</span> <span class=n>heading</span>
+                    <span class=p>)</span>
+                <span class=k>elif</span> <span class=n>template_file</span><span class=o>.</span><span class=n>suffix</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span><span class=o>.</span><span class=n>lstrip</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span> <span class=o>==</span> <span class=s1>&#39;drawio&#39;</span><span class=p>:</span>
+                    <span class=n>_</span> <span class=o>=</span> <span class=n>draw_io</span><span class=o>.</span><span class=n>DrawIOMetadataValidator</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;File: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1> within the template directory was ignored&#39;</span>
+                        <span class=o>+</span> <span class=s1>&#39; as it is not markdown.&#39;</span>
+                    <span class=p>)</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>ex</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Template file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1> for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39; failed to validate due to </span><span class=si>{</span><span class=n>ex</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;TEMPLATES VALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_measure_template_folder</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>instance_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>governed_heading</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>ignore</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>validate_by_type_field</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Validate instances against templates.</span>
+
+<span class=sd>        Validation will succeed if:</span>
+<span class=sd>            1. All template files from the specified version are present in the task</span>
+<span class=sd>            2. All of the instances are valid</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>all_versioned_templates</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>instance_version</span> <span class=o>=</span> <span class=n>template_version</span>
+        <span class=n>instance_file_names</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># Fetch all instances versions and build dictionary of required template files</span>
+        <span class=k>for</span> <span class=n>instance_file</span> <span class=ow>in</span> <span class=n>instance_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_local_and_visible</span><span class=p>(</span><span class=n>instance_file</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;readme.md&#39;</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>readme_validate</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>ignore</span><span class=p>:</span>
+                <span class=n>p</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>ignore</span><span class=p>)</span>
+                <span class=n>matched</span> <span class=o>=</span> <span class=n>p</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>instance_file</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+                <span class=k>if</span> <span class=n>matched</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Ignoring file </span><span class=si>{</span><span class=n>instance_file</span><span class=si>}</span><span class=s1> from validation.&#39;</span><span class=p>)</span>
+                    <span class=k>continue</span>
+            <span class=n>instance_file_name</span> <span class=o>=</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>instance_dir</span><span class=p>)</span>
+            <span class=n>instance_file_names</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>instance_file_name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>:</span>
+                <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+                <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=kc>None</span>
+                <span class=c1># checks on naming template name out of type header if needed</span>
+                <span class=k>if</span> <span class=n>validate_by_type_field</span><span class=p>:</span>
+                    <span class=n>template_name</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>fetch_value_from_header</span><span class=p>(</span>
+                        <span class=n>instance_file</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_HEADER</span>
+                    <span class=p>)</span>
+                    <span class=k>if</span> <span class=n>template_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;INVALID: Instance file </span><span class=si>{</span><span class=n>instance_file_name</span><span class=si>}</span><span class=s1> does not have&#39;</span>
+                            <span class=sa>f</span><span class=s1>&#39; </span><span class=si>{</span><span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_HEADER</span><span class=si>}</span><span class=s1>&#39;</span>
+                            <span class=s1>&#39; field in its header and can not be validated using optional parameter validate&#39;</span>
+                            <span class=s1>&#39; template type field&#39;</span>
+                        <span class=p>)</span>
+                        <span class=k>return</span> <span class=kc>False</span>
+                    <span class=n>template_name</span> <span class=o>=</span> <span class=n>template_name</span> <span class=o>+</span> <span class=s1>&#39;.md&#39;</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>template_name</span> <span class=o>=</span> <span class=n>instance_file_name</span>
+                <span class=k>if</span> <span class=n>template_version</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+                    <span class=n>template_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=n>template_name</span>
+                    <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>instance_version</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>fetch_value_from_header</span><span class=p>(</span>
+                        <span class=n>instance_file</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HEADER</span>
+                    <span class=p>)</span>
+                    <span class=k>if</span> <span class=n>instance_version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=n>instance_version</span> <span class=o>=</span> <span class=s1>&#39;0.0.1&#39;</span>  <span class=c1># backward compatibility</span>
+                    <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_versioned_template_dir</span><span class=p>(</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>instance_version</span>
+                    <span class=p>)</span>
+                    <span class=n>template_file</span> <span class=o>=</span> <span class=n>versioned_template_dir</span> <span class=o>/</span> <span class=n>template_name</span>
+
+                <span class=c1># Check if instance is in the available templates,</span>
+                <span class=c1># additional files are allowed but should not be validated.</span>
+                <span class=n>templates</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_templates</span><span class=p>(</span><span class=n>versioned_template_dir</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>)</span>
+                <span class=n>is_template_present</span> <span class=o>=</span> <span class=kc>False</span>
+                <span class=n>template_type_is_valid</span> <span class=o>=</span> <span class=kc>False</span>
+                <span class=k>for</span> <span class=n>template</span> <span class=ow>in</span> <span class=n>templates</span><span class=p>:</span>
+                    <span class=c1># checks if valdation needs to check on x-trestle-template-type field on header</span>
+                    <span class=k>if</span> <span class=n>validate_by_type_field</span><span class=p>:</span>
+                        <span class=n>instance_template_type</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>fetch_value_from_header</span><span class=p>(</span>
+                            <span class=n>instance_file</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_TYPE_HEADER</span>
+                        <span class=p>)</span>
+                        <span class=k>if</span> <span class=n>template</span><span class=o>.</span><span class=n>stem</span> <span class=o>==</span> <span class=n>instance_template_type</span><span class=p>:</span>
+                            <span class=n>is_template_present</span> <span class=o>=</span> <span class=kc>True</span>
+                            <span class=n>template_type_is_valid</span> <span class=o>=</span> <span class=kc>True</span>
+                            <span class=k>break</span>
+                    <span class=c1># validation through template type field is not needed and performs validation</span>
+                    <span class=c1># through file name flow as usual</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>template</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=nb>str</span><span class=p>(</span><span class=n>instance_file_name</span><span class=p>):</span>
+                            <span class=n>is_template_present</span> <span class=o>=</span> <span class=kc>True</span>
+                            <span class=k>break</span>
+
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>is_template_present</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;INFO: File</span><span class=si>{</span><span class=n>instance_file</span><span class=si>}</span><span class=s1> will not be validated &#39;</span>
+                        <span class=sa>f</span><span class=s1>&#39;as its name does not match any template file.&#39;</span>
+                    <span class=p>)</span>
+                    <span class=k>continue</span>
+
+                <span class=k>if</span> <span class=n>instance_version</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>all_versioned_templates</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>]</span> <span class=o>=</span> <span class=nb>dict</span><span class=o>.</span><span class=n>fromkeys</span><span class=p>(</span>
+                        <span class=p>[</span><span class=n>t</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>versioned_template_dir</span><span class=p>)</span> <span class=k>for</span> <span class=n>t</span> <span class=ow>in</span> <span class=n>templates</span><span class=p>],</span> <span class=kc>False</span>
+                    <span class=p>)</span>
+
+                <span class=k>if</span> <span class=n>instance_file_name</span> <span class=ow>in</span> <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>]</span> <span class=ow>or</span> <span class=n>template_type_is_valid</span><span class=p>:</span>
+                    <span class=c1># validate</span>
+                    <span class=n>md_api</span><span class=o>.</span><span class=n>load_validator_with_template</span><span class=p>(</span>
+                        <span class=n>template_file</span><span class=p>,</span> <span class=n>validate_header</span><span class=p>,</span> <span class=ow>not</span> <span class=n>validate_only_header</span><span class=p>,</span> <span class=n>governed_heading</span>
+                    <span class=p>)</span>
+                    <span class=n>status</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>validate_instance</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>status</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;INVALID: Markdown file </span><span class=si>{</span><span class=n>instance_file</span><span class=si>}</span><span class=s1> failed validation against&#39;</span> <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39; </span><span class=si>{</span><span class=n>template_file</span><span class=si>}</span><span class=s1>&#39;</span>
+                        <span class=p>)</span>
+                        <span class=k>return</span> <span class=kc>False</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: </span><span class=si>{</span><span class=n>instance_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=c1># mark template as present</span>
+                    <span class=k>if</span> <span class=n>template_type_is_valid</span><span class=p>:</span>
+                        <span class=n>template_file_name</span> <span class=o>=</span> <span class=p>[</span>
+                            <span class=n>temp</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>versioned_template_dir</span><span class=p>)</span> <span class=k>for</span> <span class=n>temp</span> <span class=ow>in</span> <span class=n>templates</span> <span class=k>if</span> <span class=n>temp</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>template_name</span>
+                        <span class=p>]</span>
+                        <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>][</span><span class=n>template_file_name</span><span class=p>[</span><span class=mi>0</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>True</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>][</span><span class=n>instance_file_name</span><span class=p>]</span> <span class=o>=</span> <span class=kc>True</span>
+
+            <span class=k>elif</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DRAWIO_FILE_EXT</span><span class=p>:</span>
+                <span class=n>drawio</span> <span class=o>=</span> <span class=n>draw_io</span><span class=o>.</span><span class=n>DrawIO</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span>
+                <span class=n>metadata</span> <span class=o>=</span> <span class=n>drawio</span><span class=o>.</span><span class=n>get_metadata</span><span class=p>()[</span><span class=mi>0</span><span class=p>]</span>
+                <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=kc>None</span>
+                <span class=k>if</span> <span class=n>template_version</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+                    <span class=n>template_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=n>instance_file_name</span>
+                    <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HEADER</span> <span class=ow>in</span> <span class=n>metadata</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                        <span class=n>instance_version</span> <span class=o>=</span> <span class=n>metadata</span><span class=p>[</span><span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HEADER</span><span class=p>]</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>instance_version</span> <span class=o>=</span> <span class=s1>&#39;0.0.1&#39;</span>  <span class=c1># backward compatibility</span>
+
+                    <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_versioned_template_dir</span><span class=p>(</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>instance_version</span>
+                    <span class=p>)</span>
+                    <span class=n>template_file</span> <span class=o>=</span> <span class=n>versioned_template_dir</span> <span class=o>/</span> <span class=n>instance_file_name</span>
+
+                <span class=k>if</span> <span class=n>instance_version</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>all_versioned_templates</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=n>templates</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_templates</span><span class=p>(</span><span class=n>versioned_template_dir</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>)</span>
+
+                    <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>]</span> <span class=o>=</span> <span class=nb>dict</span><span class=o>.</span><span class=n>fromkeys</span><span class=p>(</span>
+                        <span class=p>[</span><span class=n>t</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>versioned_template_dir</span><span class=p>)</span> <span class=k>for</span> <span class=n>t</span> <span class=ow>in</span> <span class=n>templates</span><span class=p>],</span> <span class=kc>False</span>
+                    <span class=p>)</span>
+
+                <span class=k>if</span> <span class=n>instance_file_name</span> <span class=ow>in</span> <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>]:</span>
+                    <span class=c1># validate</span>
+                    <span class=n>drawio_validator</span> <span class=o>=</span> <span class=n>draw_io</span><span class=o>.</span><span class=n>DrawIOMetadataValidator</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span>
+                    <span class=n>status</span> <span class=o>=</span> <span class=n>drawio_validator</span><span class=o>.</span><span class=n>validate</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>status</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;INVALID: Drawio file </span><span class=si>{</span><span class=n>instance_file</span><span class=si>}</span><span class=s1> failed validation against&#39;</span> <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39; </span><span class=si>{</span><span class=n>template_file</span><span class=si>}</span><span class=s1>&#39;</span>
+                        <span class=p>)</span>
+                        <span class=k>return</span> <span class=kc>False</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: </span><span class=si>{</span><span class=n>instance_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=c1># mark template as present</span>
+                    <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>][</span><span class=n>instance_file_name</span><span class=p>]</span> <span class=o>=</span> <span class=kc>True</span>
+
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unsupported extension of the instance file: </span><span class=si>{</span><span class=n>instance_file</span><span class=si>}</span><span class=s1>, will not be validated.&#39;</span><span class=p>)</span>
+
+        <span class=c1># Check that all template files are present</span>
+        <span class=k>for</span> <span class=n>version</span> <span class=ow>in</span> <span class=n>all_versioned_templates</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>template</span> <span class=ow>in</span> <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>version</span><span class=p>]:</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>version</span><span class=p>][</span><span class=n>template</span><span class=p>]:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;Required template file </span><span class=si>{</span><span class=n>template</span><span class=si>}</span><span class=s1> does not exist in measured instance&#39;</span> <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>instance_dir</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=p>)</span>
+                    <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>_get_templates</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>versioned_template_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get templates for the given version.&quot;&quot;&quot;</span>
+        <span class=n>templates</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span>
+            <span class=nb>filter</span><span class=p>(</span>
+                <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_local_and_visible</span><span class=p>(</span><span class=n>p</span><span class=p>)</span> <span class=ow>and</span> <span class=n>p</span><span class=o>.</span><span class=n>is_file</span><span class=p>()</span>
+                <span class=ow>and</span>  <span class=c1># noqa: W504 - conflicting lint and formatting</span>
+                <span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span> <span class=ow>or</span> <span class=n>p</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DRAWIO_FILE_EXT</span><span class=p>),</span>
+                <span class=n>versioned_template_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>()</span>
+            <span class=p>)</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>readme_validate</span><span class=p>:</span>
+            <span class=n>templates</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>!=</span> <span class=s1>&#39;readme.md&#39;</span><span class=p>,</span> <span class=n>templates</span><span class=p>))</span>
+
+        <span class=k>return</span> <span class=n>templates</span>
+
+    <span class=k>def</span> <span class=nf>create_sample</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Create a sample folder within the task and populate with template content.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Unix return code for running sample as a command.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>ii</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=n>sample_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;sample_folder_</span><span class=si>{</span><span class=n>ii</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=k>if</span> <span class=n>sample_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=n>ii</span> <span class=o>=</span> <span class=n>ii</span> <span class=o>+</span> <span class=mi>1</span>
+                <span class=k>continue</span>
+            <span class=n>shutil</span><span class=o>.</span><span class=n>copytree</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>sample_path</span><span class=p>))</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>validate</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>governed_heading</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>ignore</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>validate_by_type_field</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Validate task.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=si>}</span><span class=s1> does not exist. Exiting validate.&#39;</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>task_instance</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>task_instance</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_symlink</span><span class=p>(</span><span class=n>task_instance</span><span class=p>):</span>
+                    <span class=k>continue</span>
+                <span class=n>result</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_measure_template_folder</span><span class=p>(</span>
+                    <span class=n>task_instance</span><span class=p>,</span>
+                    <span class=n>validate_header</span><span class=p>,</span>
+                    <span class=n>validate_only_header</span><span class=p>,</span>
+                    <span class=n>governed_heading</span><span class=p>,</span>
+                    <span class=n>readme_validate</span><span class=p>,</span>
+                    <span class=n>template_version</span><span class=p>,</span>
+                    <span class=n>ignore</span><span class=p>,</span>
+                    <span class=n>validate_by_type_field</span>
+                <span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>result</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                        <span class=s1>&#39;Governed-folder validation failed for task&#39;</span>
+                        <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> on directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>task_instance</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Unexpected file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>task_instance</span><span class=p>)</span><span class=si>}</span><span class=s1> identified in </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=o>+</span> <span class=s1>&#39; directory, ignoring.&#39;</span>
+                <span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.folders.Folders-attributes>Attributes<a href=#trestle.core.commands.author.folders.Folders-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.folders.Folders.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;folders&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.folders.Folders.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.folders.Folders-functions>Functions<a href=#trestle.core.commands.author.folders.Folders-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.folders.Folders.create_sample class="doc doc-heading"> <code class="highlight language-python"><span class=n>create_sample</span><span class=p>()</span></code> <a href=#trestle.core.commands.author.folders.Folders.create_sample class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create a sample folder within the task and populate with template content.</p> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>Unix return code for running sample as a command.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/folders.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>create_sample</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Create a sample folder within the task and populate with template content.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Unix return code for running sample as a command.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>ii</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+        <span class=n>sample_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;sample_folder_</span><span class=si>{</span><span class=n>ii</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>if</span> <span class=n>sample_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>ii</span> <span class=o>=</span> <span class=n>ii</span> <span class=o>+</span> <span class=mi>1</span>
+            <span class=k>continue</span>
+        <span class=n>shutil</span><span class=o>.</span><span class=n>copytree</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>sample_path</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.folders.Folders.setup_template class="doc doc-heading"> <code class="highlight language-python"><span class=n>setup_template</span><span class=p>(</span><span class=n>template_version</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.folders.Folders.setup_template class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create structure to allow markdown template enforcement.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/folders.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>setup_template</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create structure to allow markdown template enforcement.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+
+    <span class=n>template_file_a_md</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=s1>&#39;a_template.md&#39;</span>
+    <span class=n>template_file_another_md</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=s1>&#39;another_template.md&#39;</span>
+    <span class=n>template_file_drawio</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=s1>&#39;architecture.drawio&#39;</span>
+    <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span>
+        <span class=s1>&#39;template.md&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>template_file_a_md</span><span class=p>,</span> <span class=n>template_version</span>
+    <span class=p>)</span>
+    <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span>
+        <span class=s1>&#39;template.md&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>template_file_another_md</span><span class=p>,</span> <span class=n>template_version</span>
+    <span class=p>)</span>
+    <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span>
+        <span class=s1>&#39;template.drawio&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>template_file_drawio</span><span class=p>,</span> <span class=n>template_version</span>
+    <span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.folders.Folders.template_validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_validate</span><span class=p>(</span><span class=n>validate_header</span><span class=p>,</span> <span class=n>validate_only_header</span><span class=p>,</span> <span class=n>heading</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.folders.Folders.template_validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate that the template is acceptable markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/folders.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>template_validate</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>heading</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validate that the template is acceptable markdown.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Template directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span><span class=si>}</span><span class=s1> for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span>
+        <span class=p>)</span>
+    <span class=c1># get list of files:</span>
+    <span class=n>template_files</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>rglob</span><span class=p>(</span><span class=s1>&#39;*&#39;</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>template_file</span> <span class=ow>in</span> <span class=n>template_files</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_local_and_visible</span><span class=p>(</span><span class=n>template_file</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>elif</span> <span class=n>template_file</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=k>continue</span>
+            <span class=k>elif</span> <span class=n>template_file</span><span class=o>.</span><span class=n>suffix</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>:</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>readme_validate</span> <span class=ow>and</span> <span class=n>template_file</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;readme.md&#39;</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Template directory contains a readme.md file and readme validation is off.&#39;</span><span class=p>)</span>
+
+                <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+                <span class=n>md_api</span><span class=o>.</span><span class=n>load_validator_with_template</span><span class=p>(</span>
+                    <span class=n>template_file</span><span class=p>,</span> <span class=n>validate_header</span><span class=p>,</span> <span class=ow>not</span> <span class=n>validate_only_header</span><span class=p>,</span> <span class=n>heading</span>
+                <span class=p>)</span>
+            <span class=k>elif</span> <span class=n>template_file</span><span class=o>.</span><span class=n>suffix</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span><span class=o>.</span><span class=n>lstrip</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span> <span class=o>==</span> <span class=s1>&#39;drawio&#39;</span><span class=p>:</span>
+                <span class=n>_</span> <span class=o>=</span> <span class=n>draw_io</span><span class=o>.</span><span class=n>DrawIOMetadataValidator</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;File: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1> within the template directory was ignored&#39;</span>
+                    <span class=o>+</span> <span class=s1>&#39; as it is not markdown.&#39;</span>
+                <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>ex</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Template file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1> for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39; failed to validate due to </span><span class=si>{</span><span class=n>ex</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;TEMPLATES VALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.folders.Folders.validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate</span><span class=p>(</span><span class=n>validate_header</span><span class=p>,</span> <span class=n>validate_only_header</span><span class=p>,</span> <span class=n>governed_heading</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>,</span> <span class=n>template_version</span><span class=p>,</span> <span class=n>ignore</span><span class=p>,</span> <span class=n>validate_by_type_field</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.folders.Folders.validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate task.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/folders.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>validate</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>validate_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>validate_only_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>governed_heading</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>ignore</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>validate_by_type_field</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validate task.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=si>}</span><span class=s1> does not exist. Exiting validate.&#39;</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>task_instance</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>task_instance</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_symlink</span><span class=p>(</span><span class=n>task_instance</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=n>result</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_measure_template_folder</span><span class=p>(</span>
+                <span class=n>task_instance</span><span class=p>,</span>
+                <span class=n>validate_header</span><span class=p>,</span>
+                <span class=n>validate_only_header</span><span class=p>,</span>
+                <span class=n>governed_heading</span><span class=p>,</span>
+                <span class=n>readme_validate</span><span class=p>,</span>
+                <span class=n>template_version</span><span class=p>,</span>
+                <span class=n>ignore</span><span class=p>,</span>
+                <span class=n>validate_by_type_field</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>result</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=s1>&#39;Governed-folder validation failed for task&#39;</span>
+                    <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> on directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>task_instance</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Unexpected file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>task_instance</span><span class=p>)</span><span class=si>}</span><span class=s1> identified in </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=o>+</span> <span class=s1>&#39; directory, ignoring.&#39;</span>
+            <span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.author.folders-functions>Functions<a href=#trestle.core.commands.author.folders-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/headers/index.html b/latest/reference/API/trestle/core/commands/author/headers/index.html
new file mode 100644
index 000000000..1cd34afb0
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/headers/index.html
@@ -0,0 +1,766 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.headers module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/headers/ rel=canonical><link href=../folders/ rel=prev><link href=../jinja/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.headers - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.headers - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.headers module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/headers.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/headers/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.headers - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.headers module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/headers.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.headers class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.headers </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers class=md-nav__link> <span class=md-ellipsis> headers </span> </a> <nav class=md-nav aria-label=headers> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers class=md-nav__link> <span class=md-ellipsis> Headers </span> </a> <nav class=md-nav aria-label=Headers> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.create_sample class=md-nav__link> <span class=md-ellipsis> create_sample </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.setup class=md-nav__link> <span class=md-ellipsis> setup </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.template_validate class=md-nav__link> <span class=md-ellipsis> template_validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers class=md-nav__link> <span class=md-ellipsis> headers </span> </a> <nav class=md-nav aria-label=headers> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers class=md-nav__link> <span class=md-ellipsis> Headers </span> </a> <nav class=md-nav aria-label=Headers> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.create_sample class=md-nav__link> <span class=md-ellipsis> create_sample </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.setup class=md-nav__link> <span class=md-ellipsis> setup </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.template_validate class=md-nav__link> <span class=md-ellipsis> template_validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers.Headers.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.headers-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.headers</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.headers class="doc doc-heading"> <code>trestle.core.commands.author.headers</code> <a href=#trestle.core.commands.author.headers class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle author headers command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.headers-attributes>Attributes<a href=#trestle.core.commands.author.headers-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.headers.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.headers.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.headers-classes>Classes<a href=#trestle.core.commands.author.headers-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.headers.Headers class="doc doc-heading"> <code>Headers</code> <a href=#trestle.core.commands.author.headers.Headers class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Enforce header / metadata across file types supported by author (markdown and drawio).</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/headers.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Headers</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Enforce header / metadata across file types supported by author (markdown and drawio).&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;headers&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>RECURSE_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>RECURSE_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>RECURSE_HELP</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=n>author_const</span><span class=o>.</span><span class=n>MODE_ARG_NAME</span><span class=p>,</span> <span class=n>choices</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>MODE_CHOICES</span><span class=p>)</span>
+        <span class=n>tn_help_str</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span>
+            <span class=p>[</span>
+                <span class=s1>&#39;The name of the the task to be governed.&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;The template files for header metadata governance are located at .trestle/author/[task name]&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;Currently supported types are:&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;Markdown: .trestle/author/[task name]/template.md&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;Drawio: .trestle/author/[task name]/template.drawio&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;&#39;</span><span class=p>,</span>
+                <span class=s1>&#39;Note that by default this will automatically enforce the task.&#39;</span>
+            <span class=p>]</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>TASK_NAME_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TASK_NAME_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>tn_help_str</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_README_VALIDATE</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_README_VALIDATE</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>README_VALIDATE_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_TEMPLATE_VERSION</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_TEMPLATE_VERSION</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HELP</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>SHORT_IGNORE</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>LONG_IGNORE</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>IGNORE_HELP</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>GLOBAL_SHORT</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>GLOBAL_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>GLOBAL_HELP</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>EXCLUDE_SHORT</span><span class=p>,</span>
+            <span class=n>author_const</span><span class=o>.</span><span class=n>EXCLUDE_LONG</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>author_const</span><span class=o>.</span><span class=n>EXCLUDE_HELP</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+            <span class=n>nargs</span><span class=o>=</span><span class=s1>&#39;*&#39;</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=kc>None</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=mi>1</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_initialize</span><span class=p>(</span><span class=n>args</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>status</span>
+            <span class=c1># Handle conditional requirement of args.task_name</span>
+            <span class=c1># global is special so we need to use get attribute.</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>global_</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Task name (-tn) argument is required when global is not specified&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>status</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>exclude</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;--exclude or -e is deprecated, use --ignore instead.&#39;</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;create-sample&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>create_sample</span><span class=p>()</span>
+
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;template-validate&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_validate</span><span class=p>()</span>
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;setup&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>setup</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>template_version</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>mode</span> <span class=o>==</span> <span class=s1>&#39;validate&#39;</span><span class=p>:</span>
+                <span class=n>exclusions</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>exclude</span><span class=p>:</span>
+                    <span class=n>exclusions</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>exclude</span>
+                <span class=c1># mode is validate</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>validate</span><span class=p>(</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>recurse</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>readme_validate</span><span class=p>,</span> <span class=n>exclusions</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>template_version</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>ignore</span>
+                <span class=p>)</span>
+            <span class=k>return</span> <span class=n>status</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error occurred when running trestle author headers&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>create_sample</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create sample object, this always defaults to markdown.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Header only validation does not support sample creation.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Exiting&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>setup</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create template directory and templates.&quot;&quot;&quot;</span>
+        <span class=c1># Step 1 - validation</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Populating template files to </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>template</span> <span class=ow>in</span> <span class=n>author_const</span><span class=o>.</span><span class=n>REFERENCE_TEMPLATES</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=n>destination_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=n>template</span>
+            <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span><span class=n>template</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>destination_path</span><span class=p>,</span> <span class=n>template_version</span><span class=p>)</span>
+
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template directory populated </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>destination_path</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>template_validate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Validate the integrity of the template files.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Checking template file integrity&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>template_file</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+            <span class=k>if</span> <span class=p>(</span><span class=n>template_file</span><span class=o>.</span><span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>author_const</span><span class=o>.</span><span class=n>REFERENCE_TEMPLATES</span><span class=o>.</span><span class=n>values</span><span class=p>()</span>
+                    <span class=ow>and</span> <span class=n>template_file</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>!=</span> <span class=s1>&#39;readme.md&#39;</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unexpected template file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>template_file</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>:</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+                    <span class=n>md_api</span><span class=o>.</span><span class=n>load_validator_with_template</span><span class=p>(</span><span class=n>template_file</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+                <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>ex</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> failed to validate due to </span><span class=si>{</span><span class=n>ex</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=k>elif</span> <span class=n>template_file</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DRAWIO_FILE_EXT</span><span class=p>:</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>_</span> <span class=o>=</span> <span class=n>DrawIOMetadataValidator</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span>
+                <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>ex</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> failed to validate due to </span><span class=si>{</span><span class=n>ex</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Templates validated&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_validate_dir</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>candidate_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>relative_exclusions</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>],</span>
+        <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>ignore</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Validate a directory within the trestle workspace.&quot;&quot;&quot;</span>
+        <span class=n>all_versioned_templates</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>instance_version</span> <span class=o>=</span> <span class=n>template_version</span>
+        <span class=n>instance_file_names</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># Fetch all instances versions and build dictionary of required template files</span>
+        <span class=n>instances</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>candidate_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>())</span>
+        <span class=k>if</span> <span class=n>recurse</span><span class=p>:</span>
+            <span class=n>instances</span> <span class=o>=</span> <span class=n>candidate_dir</span><span class=o>.</span><span class=n>rglob</span><span class=p>(</span><span class=s1>&#39;*&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ignore</span><span class=p>:</span>
+                <span class=n>p</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>ignore</span><span class=p>)</span>
+                <span class=n>instances</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span>
+                    <span class=nb>filter</span><span class=p>(</span>
+                        <span class=k>lambda</span> <span class=n>f</span><span class=p>:</span> <span class=nb>len</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>match</span><span class=p>,</span> <span class=nb>str</span><span class=p>(</span><span class=n>f</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>candidate_dir</span><span class=p>))</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;/&#39;</span><span class=p>))))</span> <span class=o>==</span> <span class=mi>0</span><span class=p>,</span>
+                        <span class=n>instances</span>
+                    <span class=p>)</span>
+                <span class=p>)</span>
+        <span class=k>for</span> <span class=n>instance_file</span> <span class=ow>in</span> <span class=n>instances</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_local_and_visible</span><span class=p>(</span><span class=n>instance_file</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;readme.md&#39;</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>readme_validate</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>recurse</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=nb>any</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>ex</span><span class=p>)</span> <span class=ow>in</span> <span class=nb>str</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span> <span class=k>for</span> <span class=n>ex</span> <span class=ow>in</span> <span class=n>relative_exclusions</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>ignore</span><span class=p>:</span>
+                <span class=n>p</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>ignore</span><span class=p>)</span>
+                <span class=n>matched</span> <span class=o>=</span> <span class=n>p</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>instance_file</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+                <span class=k>if</span> <span class=n>matched</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Ignoring file </span><span class=si>{</span><span class=n>instance_file</span><span class=si>}</span><span class=s1> from validation.&#39;</span><span class=p>)</span>
+                    <span class=k>continue</span>
+            <span class=n>instance_file_name</span> <span class=o>=</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>candidate_dir</span><span class=p>)</span>
+            <span class=n>instance_file_names</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>instance_file_name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>:</span>
+                <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+                <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=kc>None</span>
+                <span class=k>if</span> <span class=n>template_version</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+                    <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>instance_version</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>fetch_value_from_header</span><span class=p>(</span>
+                        <span class=n>instance_file</span><span class=p>,</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HEADER</span>
+                    <span class=p>)</span>
+                    <span class=k>if</span> <span class=n>instance_version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=n>instance_version</span> <span class=o>=</span> <span class=s1>&#39;0.0.1&#39;</span>  <span class=c1># backward compatibility</span>
+                    <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_versioned_template_dir</span><span class=p>(</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>instance_version</span>
+                    <span class=p>)</span>
+
+                <span class=k>if</span> <span class=n>instance_version</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>all_versioned_templates</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=n>templates</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span>
+                        <span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_local_and_visible</span><span class=p>(</span><span class=n>p</span><span class=p>),</span> <span class=n>versioned_template_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>())</span>
+                    <span class=p>)</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>readme_validate</span><span class=p>:</span>
+                        <span class=n>templates</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>!=</span> <span class=s1>&#39;readme.md&#39;</span><span class=p>,</span> <span class=n>templates</span><span class=p>))</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_update_templates</span><span class=p>(</span><span class=n>all_versioned_templates</span><span class=p>,</span> <span class=n>templates</span><span class=p>,</span> <span class=n>instance_version</span><span class=p>)</span>
+
+                <span class=c1># validate</span>
+                <span class=n>md_api</span><span class=o>.</span><span class=n>load_validator_with_template</span><span class=p>(</span><span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>][</span><span class=s1>&#39;md&#39;</span><span class=p>],</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>validate_instance</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>status</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>return</span> <span class=kc>False</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=k>elif</span> <span class=n>instance_file</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DRAWIO_FILE_EXT</span><span class=p>:</span>
+                <span class=n>drawio</span> <span class=o>=</span> <span class=n>DrawIO</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span>
+                <span class=n>metadata</span> <span class=o>=</span> <span class=n>drawio</span><span class=o>.</span><span class=n>get_metadata</span><span class=p>()[</span><span class=mi>0</span><span class=p>]</span>
+
+                <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=kc>None</span>
+                <span class=k>if</span> <span class=n>template_version</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+                    <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HEADER</span> <span class=ow>in</span> <span class=n>metadata</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                        <span class=n>instance_version</span> <span class=o>=</span> <span class=n>metadata</span><span class=p>[</span><span class=n>author_const</span><span class=o>.</span><span class=n>TEMPLATE_VERSION_HEADER</span><span class=p>]</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>instance_version</span> <span class=o>=</span> <span class=s1>&#39;0.0.1&#39;</span>  <span class=c1># backward compatibility</span>
+
+                    <span class=n>versioned_template_dir</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_versioned_template_dir</span><span class=p>(</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>instance_version</span>
+                    <span class=p>)</span>
+
+                <span class=k>if</span> <span class=n>instance_version</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>all_versioned_templates</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=n>templates</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span>
+                        <span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_local_and_visible</span><span class=p>(</span><span class=n>p</span><span class=p>),</span> <span class=n>versioned_template_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>())</span>
+                    <span class=p>)</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>readme_validate</span><span class=p>:</span>
+                        <span class=n>templates</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>!=</span> <span class=s1>&#39;readme.md&#39;</span><span class=p>,</span> <span class=n>templates</span><span class=p>))</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_update_templates</span><span class=p>(</span><span class=n>all_versioned_templates</span><span class=p>,</span> <span class=n>templates</span><span class=p>,</span> <span class=n>instance_version</span><span class=p>)</span>
+
+                <span class=c1># validate</span>
+                <span class=n>drawio_validator</span> <span class=o>=</span> <span class=n>DrawIOMetadataValidator</span><span class=p>(</span><span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>][</span><span class=s1>&#39;drawio&#39;</span><span class=p>])</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>drawio_validator</span><span class=o>.</span><span class=n>validate</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>status</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>return</span> <span class=kc>False</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>instance_file</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unsupported extension of the instance file: </span><span class=si>{</span><span class=n>instance_file</span><span class=si>}</span><span class=s1>, will not be validated.&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>_update_templates</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>all_versioned_templates</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>templates</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>instance_version</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>all_drawio_templates</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DRAWIO_FILE_EXT</span><span class=p>,</span> <span class=n>templates</span><span class=p>))</span>
+        <span class=n>all_md_templates</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>,</span> <span class=n>templates</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>all_drawio_templates</span><span class=p>:</span>
+            <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>][</span><span class=s1>&#39;drawio&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>all_drawio_templates</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>all_md_templates</span><span class=p>:</span>
+            <span class=n>all_versioned_templates</span><span class=p>[</span><span class=n>instance_version</span><span class=p>][</span><span class=s1>&#39;md&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>all_md_templates</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+
+    <span class=k>def</span> <span class=nf>validate</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>relative_excludes</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>],</span>
+        <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>ignore</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Run validation based on available templates.&quot;&quot;&quot;</span>
+        <span class=n>paths</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist. Exiting validate.&#39;</span><span class=p>)</span>
+
+            <span class=n>paths</span> <span class=o>=</span> <span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>]</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>path</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+                <span class=n>relative_path</span> <span class=o>=</span> <span class=n>path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+                <span class=c1># Files in the root directory must be exclused</span>
+                <span class=k>if</span> <span class=n>path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_directory_name_allowed</span><span class=p>(</span><span class=n>path</span><span class=p>):</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=nb>str</span><span class=p>(</span><span class=n>relative_path</span><span class=p>)</span><span class=o>.</span><span class=n>rstrip</span><span class=p>(</span><span class=s1>&#39;/&#39;</span><span class=p>)</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_DIR_LIST</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=p>(</span><span class=n>relative_path</span> <span class=ow>in</span> <span class=n>relative_excludes</span><span class=p>):</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_hidden</span><span class=p>(</span><span class=n>path</span><span class=p>):</span>
+                    <span class=n>paths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>path</span> <span class=ow>in</span> <span class=n>paths</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>valid</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_dir</span><span class=p>(</span><span class=n>path</span><span class=p>,</span> <span class=n>recurse</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>,</span> <span class=n>relative_excludes</span><span class=p>,</span> <span class=n>template_version</span><span class=p>,</span> <span class=n>ignore</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>valid</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;validation failed on </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>DOCUMENTS_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error during header validation on </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.headers.Headers-attributes>Attributes<a href=#trestle.core.commands.author.headers.Headers-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.headers.Headers.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;headers&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.headers.Headers.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.headers.Headers-functions>Functions<a href=#trestle.core.commands.author.headers.Headers-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.headers.Headers.create_sample class="doc doc-heading"> <code class="highlight language-python"><span class=n>create_sample</span><span class=p>()</span></code> <a href=#trestle.core.commands.author.headers.Headers.create_sample class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create sample object, this always defaults to markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/headers.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>create_sample</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create sample object, this always defaults to markdown.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Header only validation does not support sample creation.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Exiting&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.headers.Headers.setup class="doc doc-heading"> <code class="highlight language-python"><span class=n>setup</span><span class=p>(</span><span class=n>template_version</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.headers.Headers.setup class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create template directory and templates.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/headers.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>setup</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create template directory and templates.&quot;&quot;&quot;</span>
+    <span class=c1># Step 1 - validation</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task path: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> is a file not a directory.&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Populating template files to </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>template</span> <span class=ow>in</span> <span class=n>author_const</span><span class=o>.</span><span class=n>REFERENCE_TEMPLATES</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=n>destination_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span> <span class=o>/</span> <span class=n>template</span>
+        <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>write_versioned_template</span><span class=p>(</span><span class=n>template</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=p>,</span> <span class=n>destination_path</span><span class=p>,</span> <span class=n>template_version</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template directory populated </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>destination_path</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.headers.Headers.template_validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_validate</span><span class=p>()</span></code> <a href=#trestle.core.commands.author.headers.Headers.template_validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate the integrity of the template files.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/headers.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>template_validate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validate the integrity of the template files.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Checking template file integrity&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>template_file</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+        <span class=k>if</span> <span class=p>(</span><span class=n>template_file</span><span class=o>.</span><span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>author_const</span><span class=o>.</span><span class=n>REFERENCE_TEMPLATES</span><span class=o>.</span><span class=n>values</span><span class=p>()</span>
+                <span class=ow>and</span> <span class=n>template_file</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>!=</span> <span class=s1>&#39;readme.md&#39;</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unexpected template file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>template_file</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+                <span class=n>md_api</span><span class=o>.</span><span class=n>load_validator_with_template</span><span class=p>(</span><span class=n>template_file</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>ex</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> failed to validate due to </span><span class=si>{</span><span class=n>ex</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>elif</span> <span class=n>template_file</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DRAWIO_FILE_EXT</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>_</span> <span class=o>=</span> <span class=n>DrawIOMetadataValidator</span><span class=p>(</span><span class=n>template_file</span><span class=p>)</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>ex</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Template for task </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=si>}</span><span class=s1> failed to validate due to </span><span class=si>{</span><span class=n>ex</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Templates validated&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.headers.Headers.validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate</span><span class=p>(</span><span class=n>recurse</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>,</span> <span class=n>relative_excludes</span><span class=p>,</span> <span class=n>template_version</span><span class=p>,</span> <span class=n>ignore</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.headers.Headers.validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Run validation based on available templates.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/headers.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>validate</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>recurse</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>readme_validate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>relative_excludes</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>],</span>
+    <span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>ignore</span><span class=p>:</span> <span class=nb>str</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Run validation based on available templates.&quot;&quot;&quot;</span>
+    <span class=n>paths</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_name</span><span class=p>:</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task directory </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rel_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist. Exiting validate.&#39;</span><span class=p>)</span>
+
+        <span class=n>paths</span> <span class=o>=</span> <span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>task_path</span><span class=p>]</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>path</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+            <span class=n>relative_path</span> <span class=o>=</span> <span class=n>path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+            <span class=c1># Files in the root directory must be exclused</span>
+            <span class=k>if</span> <span class=n>path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_directory_name_allowed</span><span class=p>(</span><span class=n>path</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=nb>str</span><span class=p>(</span><span class=n>relative_path</span><span class=p>)</span><span class=o>.</span><span class=n>rstrip</span><span class=p>(</span><span class=s1>&#39;/&#39;</span><span class=p>)</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_DIR_LIST</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=p>(</span><span class=n>relative_path</span> <span class=ow>in</span> <span class=n>relative_excludes</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_hidden</span><span class=p>(</span><span class=n>path</span><span class=p>):</span>
+                <span class=n>paths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>path</span> <span class=ow>in</span> <span class=n>paths</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>valid</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_dir</span><span class=p>(</span><span class=n>path</span><span class=p>,</span> <span class=n>recurse</span><span class=p>,</span> <span class=n>readme_validate</span><span class=p>,</span> <span class=n>relative_excludes</span><span class=p>,</span> <span class=n>template_version</span><span class=p>,</span> <span class=n>ignore</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>valid</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;validation failed on </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>DOCUMENTS_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error during header validation on </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.author.headers-functions>Functions<a href=#trestle.core.commands.author.headers-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/jinja/index.html b/latest/reference/API/trestle/core/commands/author/jinja/index.html
new file mode 100644
index 000000000..f3100398a
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/jinja/index.html
@@ -0,0 +1,858 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.jinja module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/jinja/ rel=canonical><link href=../headers/ rel=prev><link href=../prof/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.jinja - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.jinja - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.jinja module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/jinja.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/jinja/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.jinja - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.jinja module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/jinja.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.jinja class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja class=md-nav__link> <span class=md-ellipsis> jinja </span> </a> <nav class=md-nav aria-label=jinja> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd class=md-nav__link> <span class=md-ellipsis> JinjaCmd </span> </a> <nav class=md-nav aria-label=JinjaCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.max_recursion_depth class=md-nav__link> <span class=md-ellipsis> max_recursion_depth </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.jinja_ify class=md-nav__link> <span class=md-ellipsis> jinja_ify </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.jinja_multiple_md class=md-nav__link> <span class=md-ellipsis> jinja_multiple_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.load_LUT class=md-nav__link> <span class=md-ellipsis> load_LUT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.render_template class=md-nav__link> <span class=md-ellipsis> render_template </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja class=md-nav__link> <span class=md-ellipsis> jinja </span> </a> <nav class=md-nav aria-label=jinja> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd class=md-nav__link> <span class=md-ellipsis> JinjaCmd </span> </a> <nav class=md-nav aria-label=JinjaCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.max_recursion_depth class=md-nav__link> <span class=md-ellipsis> max_recursion_depth </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.jinja_ify class=md-nav__link> <span class=md-ellipsis> jinja_ify </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.jinja_multiple_md class=md-nav__link> <span class=md-ellipsis> jinja_multiple_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.load_LUT class=md-nav__link> <span class=md-ellipsis> load_LUT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja.JinjaCmd.render_template class=md-nav__link> <span class=md-ellipsis> render_template </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.jinja-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.jinja</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.jinja class="doc doc-heading"> <code>trestle.core.commands.author.jinja</code> <a href=#trestle.core.commands.author.jinja class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Commands.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.jinja-attributes>Attributes<a href=#trestle.core.commands.author.jinja-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.jinja.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.jinja.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.jinja-classes>Classes<a href=#trestle.core.commands.author.jinja-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.jinja.JinjaCmd class="doc doc-heading"> <code>JinjaCmd</code> <a href=#trestle.core.commands.author.jinja.JinjaCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Transform an input template to an output document using jinja templating.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/jinja.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>JinjaCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transform an input template to an output document using jinja templating.&quot;&quot;&quot;</span>
+
+    <span class=n>max_recursion_depth</span> <span class=o>=</span> <span class=mi>2</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;jinja&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-i&#39;</span><span class=p>,</span> <span class=s1>&#39;--input&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Input jinja template, relative to trestle root&#39;</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Output template, relative to trestle root.&#39;</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-lut&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--look-up-table&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Key-value pair table, stored as yaml, to be passed to jinja as variables&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-elp&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--external-lut-prefix&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Prefix paths for LUT, to maintain compatibility with other templating systems&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-nc&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--number-captions&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Add incremental numbering to table and image captions, in the form Table n - ... and Figure n - ...&#39;</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-bf&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--bracket-format&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;With -sv, allows brackets around value, e.g. [.] or ((.)), with the dot representing the value.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-vap&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--value-assigned-prefix&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Places a prefix in front of the parameter string if a value has been assigned.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=s1>&#39;&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-vnap&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--value-not-assigned-prefix&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Places a prefix in front of the parameter string if a value has *not* been assigned.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=s1>&#39;&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-ssp&#39;</span><span class=p>,</span> <span class=s1>&#39;--system-security-plan&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;An optional SSP to be passed&#39;</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-p&#39;</span><span class=p>,</span> <span class=s1>&#39;--profile&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;An optional profile to be passed&#39;</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-dp&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--docs-profile&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Output profile controls to separate markdown files&#39;</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Starting </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> command&#39;</span><span class=p>)</span>
+            <span class=n>input_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>input</span><span class=p>)</span>
+            <span class=n>output_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>)</span>
+
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input_path: </span><span class=si>{</span><span class=n>input_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output_path: </span><span class=si>{</span><span class=n>output_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;system_security_plan path: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>system_security_plan</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;profile: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>profile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;docs_profile: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>docs_profile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;lookup_table: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>look_up_table</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>system_security_plan</span> <span class=ow>and</span> <span class=n>args</span><span class=o>.</span><span class=n>docs_profile</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleIncorrectArgsError</span><span class=p>(</span><span class=s1>&#39;Output to multiple files is possible with profile only.&#39;</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>docs_profile</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>profile</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleIncorrectArgsError</span><span class=p>(</span><span class=s1>&#39;Profile must be provided to output to multiple files.&#39;</span><span class=p>)</span>
+
+            <span class=n>lut</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>look_up_table</span><span class=p>:</span>
+                <span class=n>lut_table</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>look_up_table</span><span class=p>)</span>
+                <span class=n>lookup_table_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>cwd</span><span class=p>()</span> <span class=o>/</span> <span class=n>lut_table</span>
+                <span class=n>lut</span> <span class=o>=</span> <span class=n>JinjaCmd</span><span class=o>.</span><span class=n>load_LUT</span><span class=p>(</span><span class=n>lookup_table_path</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>external_lut_prefix</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>profile</span> <span class=ow>and</span> <span class=n>args</span><span class=o>.</span><span class=n>docs_profile</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>JinjaCmd</span><span class=o>.</span><span class=n>jinja_multiple_md</span><span class=p>(</span>
+                    <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>),</span>
+                    <span class=n>input_path</span><span class=p>,</span>
+                    <span class=n>output_path</span><span class=p>,</span>
+                    <span class=n>args</span><span class=o>.</span><span class=n>profile</span><span class=p>,</span>
+                    <span class=n>lut</span><span class=p>,</span>
+                    <span class=n>parameters_formatting</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>bracket_format</span><span class=p>,</span>
+                    <span class=n>value_assigned_prefix</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>value_assigned_prefix</span><span class=p>,</span>
+                    <span class=n>value_not_assigned_prefix</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>value_not_assigned_prefix</span>
+                <span class=p>)</span>
+
+            <span class=k>return</span> <span class=n>JinjaCmd</span><span class=o>.</span><span class=n>jinja_ify</span><span class=p>(</span>
+                <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>),</span>
+                <span class=n>input_path</span><span class=p>,</span>
+                <span class=n>output_path</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>system_security_plan</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>profile</span><span class=p>,</span>
+                <span class=n>lut</span><span class=p>,</span>
+                <span class=n>number_captions</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>number_captions</span><span class=p>,</span>
+                <span class=n>parameters_formatting</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>bracket_format</span><span class=p>,</span>
+                <span class=n>value_assigned_prefix</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>value_assigned_prefix</span><span class=p>,</span>
+                <span class=n>value_not_assigned_prefix</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span>  <span class=c1># type: ignore</span>
+                <span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while generating markdown via Jinja template&#39;</span>
+            <span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>load_LUT</span><span class=p>(</span><span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>  <span class=c1># noqa: N802</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Load a Yaml lookup table from file.&quot;&quot;&quot;</span>
+        <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>()</span>
+        <span class=n>lut</span> <span class=o>=</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>prefix</span><span class=p>:</span>
+            <span class=n>prefixes</span> <span class=o>=</span> <span class=n>prefix</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+            <span class=k>while</span> <span class=n>prefixes</span><span class=p>:</span>
+                <span class=n>old_lut</span> <span class=o>=</span> <span class=n>lut</span>
+                <span class=n>lut</span><span class=p>[</span><span class=n>prefixes</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)]</span> <span class=o>=</span> <span class=n>old_lut</span>
+
+        <span class=k>return</span> <span class=n>lut</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>jinja_ify</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>r_input_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>r_output_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>profile</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>lut</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>number_captions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>bool</span><span class=p>]</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>parameters_formatting</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Run jinja over an input file with additional booleans.&quot;&quot;&quot;</span>
+        <span class=n>template_folder</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>cwd</span><span class=p>()</span>
+        <span class=n>jinja_env</span> <span class=o>=</span> <span class=n>Environment</span><span class=p>(</span>
+            <span class=n>loader</span><span class=o>=</span><span class=n>FileSystemLoader</span><span class=p>(</span><span class=n>template_folder</span><span class=p>),</span> <span class=n>extensions</span><span class=o>=</span><span class=n>extensions</span><span class=p>(),</span> <span class=n>trim_blocks</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>autoescape</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+        <span class=n>template</span> <span class=o>=</span> <span class=n>jinja_env</span><span class=o>.</span><span class=n>get_template</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>r_input_file</span><span class=p>))</span>
+        <span class=c1># create boolean dict</span>
+        <span class=k>if</span> <span class=n>operator</span><span class=o>.</span><span class=n>xor</span><span class=p>(</span><span class=nb>bool</span><span class=p>(</span><span class=n>ssp</span><span class=p>),</span> <span class=nb>bool</span><span class=p>(</span><span class=n>profile</span><span class=p>)):</span>
+            <span class=k>raise</span> <span class=n>TrestleIncorrectArgsError</span><span class=p>(</span><span class=s1>&#39;Both SSP and profile should be provided or not at all&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>ssp</span><span class=p>:</span>
+            <span class=c1># name lookup</span>
+            <span class=n>ssp_data</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>ssp</span><span class=p>,</span> <span class=n>SystemSecurityPlan</span><span class=p>)</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;ssp&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ssp_data</span>
+            <span class=n>profile_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile</span><span class=p>,</span> <span class=n>Profile</span><span class=p>)</span>
+            <span class=n>profile_resolver</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span>
+            <span class=n>resolved_catalog</span> <span class=o>=</span> <span class=n>profile_resolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>profile_path</span><span class=p>,</span>
+                <span class=kc>False</span><span class=p>,</span>
+                <span class=kc>False</span><span class=p>,</span>
+                <span class=n>parameters_formatting</span><span class=p>,</span>
+                <span class=n>ParameterRep</span><span class=o>.</span><span class=n>ASSIGNMENT_FORM</span><span class=p>,</span>
+                <span class=kc>False</span><span class=p>,</span>
+                <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                <span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+
+            <span class=n>ssp_writer</span> <span class=o>=</span> <span class=n>SSPMarkdownWriter</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>)</span>
+            <span class=n>ssp_writer</span><span class=o>.</span><span class=n>set_ssp</span><span class=p>(</span><span class=n>ssp_data</span><span class=p>)</span>
+            <span class=n>ssp_writer</span><span class=o>.</span><span class=n>set_catalog</span><span class=p>(</span><span class=n>resolved_catalog</span><span class=p>)</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;catalog&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>resolved_catalog</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;catalog_interface&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>resolved_catalog</span><span class=p>)</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control_interface&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=p>()</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control_writer&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>DocsControlWriter</span><span class=p>()</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;ssp_md_writer&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ssp_writer</span>
+
+        <span class=n>output</span> <span class=o>=</span> <span class=n>JinjaCmd</span><span class=o>.</span><span class=n>render_template</span><span class=p>(</span><span class=n>template</span><span class=p>,</span> <span class=n>lut</span><span class=p>,</span> <span class=n>template_folder</span><span class=p>)</span>
+
+        <span class=n>output_file</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>r_output_file</span>
+        <span class=k>if</span> <span class=n>number_captions</span><span class=p>:</span>
+            <span class=n>output_file</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>_number_captions</span><span class=p>(</span><span class=n>output</span><span class=p>))</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>output_file</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>output</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>jinja_multiple_md</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>r_input_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>r_output_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>profile_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>lut</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>parameters_formatting</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Output profile as multiple markdown files using Jinja.&quot;&quot;&quot;</span>
+        <span class=n>template_folder</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>cwd</span><span class=p>()</span>
+
+        <span class=c1># Output to multiple markdown files</span>
+        <span class=n>profile</span><span class=p>,</span> <span class=n>profile_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_model_for_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>Profile</span><span class=p>)</span>
+        <span class=n>profile_resolver</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span>
+        <span class=n>resolved_catalog</span> <span class=o>=</span> <span class=n>profile_resolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>profile_path</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=n>parameters_formatting</span><span class=p>,</span>
+            <span class=n>ParameterRep</span><span class=o>.</span><span class=n>ASSIGNMENT_FORM</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=n>value_assigned_prefix</span><span class=p>,</span>
+            <span class=n>value_not_assigned_prefix</span>
+        <span class=p>)</span>
+        <span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>resolved_catalog</span><span class=p>)</span>
+
+        <span class=c1># Generate a single markdown page for each control per each group</span>
+        <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_all_groups_from_catalog</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_sorted_controls_in_group</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=p>):</span>
+                <span class=n>_</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+                <span class=n>group_dir</span> <span class=o>=</span> <span class=n>r_output_file</span>
+                <span class=n>control_path</span> <span class=o>=</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_control_path</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>sub_dir</span> <span class=ow>in</span> <span class=n>control_path</span><span class=p>:</span>
+                    <span class=n>group_dir</span> <span class=o>=</span> <span class=n>group_dir</span> <span class=o>/</span> <span class=n>sub_dir</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>group_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                        <span class=n>group_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+                <span class=n>control_writer</span> <span class=o>=</span> <span class=n>DocsControlWriter</span><span class=p>()</span>
+
+                <span class=n>jinja_env</span> <span class=o>=</span> <span class=n>Environment</span><span class=p>(</span>
+                    <span class=n>loader</span><span class=o>=</span><span class=n>FileSystemLoader</span><span class=p>(</span><span class=n>template_folder</span><span class=p>),</span>
+                    <span class=n>extensions</span><span class=o>=</span><span class=n>extensions</span><span class=p>(),</span>
+                    <span class=n>trim_blocks</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span>
+                    <span class=n>autoescape</span><span class=o>=</span><span class=kc>True</span>
+                <span class=p>)</span>
+                <span class=n>template</span> <span class=o>=</span> <span class=n>jinja_env</span><span class=o>.</span><span class=n>get_template</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>r_input_file</span><span class=p>))</span>
+                <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;catalog_interface&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>catalog_interface</span>
+                <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control_interface&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=p>()</span>
+                <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control_writer&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>control_writer</span>
+                <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>control</span>
+                <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;profile&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>profile</span>
+                <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;group_title&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>group_title</span>
+                <span class=n>output</span> <span class=o>=</span> <span class=n>JinjaCmd</span><span class=o>.</span><span class=n>render_template</span><span class=p>(</span><span class=n>template</span><span class=p>,</span> <span class=n>lut</span><span class=p>,</span> <span class=n>template_folder</span><span class=p>)</span>
+
+                <span class=n>output_file</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>group_dir</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=o>+</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>)</span>
+                <span class=n>output_file</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>output</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>render_template</span><span class=p>(</span><span class=n>template</span><span class=p>:</span> <span class=n>Template</span><span class=p>,</span> <span class=n>lut</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>template_folder</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Render template.&quot;&quot;&quot;</span>
+        <span class=n>new_output</span> <span class=o>=</span> <span class=n>template</span><span class=o>.</span><span class=n>render</span><span class=p>(</span><span class=o>**</span><span class=n>lut</span><span class=p>)</span>
+        <span class=n>output</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=c1># This recursion allows nesting within expressions (e.g. an expression can contain jinja templates).</span>
+        <span class=n>error_countdown</span> <span class=o>=</span> <span class=n>JinjaCmd</span><span class=o>.</span><span class=n>max_recursion_depth</span>
+        <span class=k>while</span> <span class=n>new_output</span> <span class=o>!=</span> <span class=n>output</span> <span class=ow>and</span> <span class=n>error_countdown</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>error_countdown</span> <span class=o>=</span> <span class=n>error_countdown</span> <span class=o>-</span> <span class=mi>1</span>
+            <span class=n>output</span> <span class=o>=</span> <span class=n>new_output</span>
+            <span class=n>random_name</span> <span class=o>=</span> <span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()</span>  <span class=c1># Should be random and not used.</span>
+            <span class=n>dict_loader</span> <span class=o>=</span> <span class=n>DictLoader</span><span class=p>({</span><span class=nb>str</span><span class=p>(</span><span class=n>random_name</span><span class=p>):</span> <span class=n>new_output</span><span class=p>})</span>
+            <span class=n>jinja_env</span> <span class=o>=</span> <span class=n>Environment</span><span class=p>(</span>
+                <span class=n>loader</span><span class=o>=</span><span class=n>ChoiceLoader</span><span class=p>([</span><span class=n>dict_loader</span><span class=p>,</span> <span class=n>FileSystemLoader</span><span class=p>(</span><span class=n>template_folder</span><span class=p>)]),</span>
+                <span class=n>extensions</span><span class=o>=</span><span class=n>extensions</span><span class=p>(),</span>
+                <span class=n>autoescape</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span>
+                <span class=n>trim_blocks</span><span class=o>=</span><span class=kc>True</span>
+            <span class=p>)</span>
+            <span class=n>template</span> <span class=o>=</span> <span class=n>jinja_env</span><span class=o>.</span><span class=n>get_template</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>random_name</span><span class=p>))</span>
+            <span class=n>new_output</span> <span class=o>=</span> <span class=n>template</span><span class=o>.</span><span class=n>render</span><span class=p>(</span><span class=o>**</span><span class=n>lut</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>output</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.jinja.JinjaCmd-attributes>Attributes<a href=#trestle.core.commands.author.jinja.JinjaCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.jinja.JinjaCmd.max_recursion_depth class="doc doc-heading"> <code class="highlight language-python"><span class=n>max_recursion_depth</span> <span class=o>=</span> <span class=mi>2</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.jinja.JinjaCmd.max_recursion_depth class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.jinja.JinjaCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;jinja&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.jinja.JinjaCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.jinja.JinjaCmd-functions>Functions<a href=#trestle.core.commands.author.jinja.JinjaCmd-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.jinja.JinjaCmd.jinja_ify class="doc doc-heading"> <code class="highlight language-python"><span class=n>jinja_ify</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>r_input_file</span><span class=p>,</span> <span class=n>r_output_file</span><span class=p>,</span> <span class=n>ssp</span><span class=p>,</span> <span class=n>profile</span><span class=p>,</span> <span class=n>lut</span><span class=p>,</span> <span class=n>number_captions</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>parameters_formatting</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.jinja.JinjaCmd.jinja_ify class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Run jinja over an input file with additional booleans.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/jinja.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>jinja_ify</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>r_input_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>r_output_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>ssp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>profile</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>lut</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+    <span class=n>number_captions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>bool</span><span class=p>]</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>parameters_formatting</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Run jinja over an input file with additional booleans.&quot;&quot;&quot;</span>
+    <span class=n>template_folder</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>cwd</span><span class=p>()</span>
+    <span class=n>jinja_env</span> <span class=o>=</span> <span class=n>Environment</span><span class=p>(</span>
+        <span class=n>loader</span><span class=o>=</span><span class=n>FileSystemLoader</span><span class=p>(</span><span class=n>template_folder</span><span class=p>),</span> <span class=n>extensions</span><span class=o>=</span><span class=n>extensions</span><span class=p>(),</span> <span class=n>trim_blocks</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>autoescape</span><span class=o>=</span><span class=kc>True</span>
+    <span class=p>)</span>
+    <span class=n>template</span> <span class=o>=</span> <span class=n>jinja_env</span><span class=o>.</span><span class=n>get_template</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>r_input_file</span><span class=p>))</span>
+    <span class=c1># create boolean dict</span>
+    <span class=k>if</span> <span class=n>operator</span><span class=o>.</span><span class=n>xor</span><span class=p>(</span><span class=nb>bool</span><span class=p>(</span><span class=n>ssp</span><span class=p>),</span> <span class=nb>bool</span><span class=p>(</span><span class=n>profile</span><span class=p>)):</span>
+        <span class=k>raise</span> <span class=n>TrestleIncorrectArgsError</span><span class=p>(</span><span class=s1>&#39;Both SSP and profile should be provided or not at all&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>ssp</span><span class=p>:</span>
+        <span class=c1># name lookup</span>
+        <span class=n>ssp_data</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>ssp</span><span class=p>,</span> <span class=n>SystemSecurityPlan</span><span class=p>)</span>
+        <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;ssp&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ssp_data</span>
+        <span class=n>profile_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile</span><span class=p>,</span> <span class=n>Profile</span><span class=p>)</span>
+        <span class=n>profile_resolver</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span>
+        <span class=n>resolved_catalog</span> <span class=o>=</span> <span class=n>profile_resolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>profile_path</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=n>parameters_formatting</span><span class=p>,</span>
+            <span class=n>ParameterRep</span><span class=o>.</span><span class=n>ASSIGNMENT_FORM</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=n>value_assigned_prefix</span><span class=p>,</span>
+            <span class=n>value_not_assigned_prefix</span>
+        <span class=p>)</span>
+
+        <span class=n>ssp_writer</span> <span class=o>=</span> <span class=n>SSPMarkdownWriter</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>)</span>
+        <span class=n>ssp_writer</span><span class=o>.</span><span class=n>set_ssp</span><span class=p>(</span><span class=n>ssp_data</span><span class=p>)</span>
+        <span class=n>ssp_writer</span><span class=o>.</span><span class=n>set_catalog</span><span class=p>(</span><span class=n>resolved_catalog</span><span class=p>)</span>
+        <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;catalog&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>resolved_catalog</span>
+        <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;catalog_interface&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>resolved_catalog</span><span class=p>)</span>
+        <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control_interface&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=p>()</span>
+        <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control_writer&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>DocsControlWriter</span><span class=p>()</span>
+        <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;ssp_md_writer&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ssp_writer</span>
+
+    <span class=n>output</span> <span class=o>=</span> <span class=n>JinjaCmd</span><span class=o>.</span><span class=n>render_template</span><span class=p>(</span><span class=n>template</span><span class=p>,</span> <span class=n>lut</span><span class=p>,</span> <span class=n>template_folder</span><span class=p>)</span>
+
+    <span class=n>output_file</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>r_output_file</span>
+    <span class=k>if</span> <span class=n>number_captions</span><span class=p>:</span>
+        <span class=n>output_file</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>_number_captions</span><span class=p>(</span><span class=n>output</span><span class=p>))</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>output_file</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>output</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.jinja.JinjaCmd.jinja_multiple_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>jinja_multiple_md</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>r_input_file</span><span class=p>,</span> <span class=n>r_output_file</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>lut</span><span class=p>,</span> <span class=n>parameters_formatting</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.jinja.JinjaCmd.jinja_multiple_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Output profile as multiple markdown files using Jinja.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/jinja.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>jinja_multiple_md</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>r_input_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>r_output_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>profile_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>lut</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+    <span class=n>parameters_formatting</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Output profile as multiple markdown files using Jinja.&quot;&quot;&quot;</span>
+    <span class=n>template_folder</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>cwd</span><span class=p>()</span>
+
+    <span class=c1># Output to multiple markdown files</span>
+    <span class=n>profile</span><span class=p>,</span> <span class=n>profile_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_model_for_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>Profile</span><span class=p>)</span>
+    <span class=n>profile_resolver</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span>
+    <span class=n>resolved_catalog</span> <span class=o>=</span> <span class=n>profile_resolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span>
+        <span class=n>profile_path</span><span class=p>,</span>
+        <span class=kc>False</span><span class=p>,</span>
+        <span class=kc>False</span><span class=p>,</span>
+        <span class=n>parameters_formatting</span><span class=p>,</span>
+        <span class=n>ParameterRep</span><span class=o>.</span><span class=n>ASSIGNMENT_FORM</span><span class=p>,</span>
+        <span class=kc>False</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span>
+    <span class=p>)</span>
+    <span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>resolved_catalog</span><span class=p>)</span>
+
+    <span class=c1># Generate a single markdown page for each control per each group</span>
+    <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_all_groups_from_catalog</span><span class=p>():</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_sorted_controls_in_group</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=p>):</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=n>group_dir</span> <span class=o>=</span> <span class=n>r_output_file</span>
+            <span class=n>control_path</span> <span class=o>=</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_control_path</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>sub_dir</span> <span class=ow>in</span> <span class=n>control_path</span><span class=p>:</span>
+                <span class=n>group_dir</span> <span class=o>=</span> <span class=n>group_dir</span> <span class=o>/</span> <span class=n>sub_dir</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>group_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                    <span class=n>group_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+            <span class=n>control_writer</span> <span class=o>=</span> <span class=n>DocsControlWriter</span><span class=p>()</span>
+
+            <span class=n>jinja_env</span> <span class=o>=</span> <span class=n>Environment</span><span class=p>(</span>
+                <span class=n>loader</span><span class=o>=</span><span class=n>FileSystemLoader</span><span class=p>(</span><span class=n>template_folder</span><span class=p>),</span>
+                <span class=n>extensions</span><span class=o>=</span><span class=n>extensions</span><span class=p>(),</span>
+                <span class=n>trim_blocks</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span>
+                <span class=n>autoescape</span><span class=o>=</span><span class=kc>True</span>
+            <span class=p>)</span>
+            <span class=n>template</span> <span class=o>=</span> <span class=n>jinja_env</span><span class=o>.</span><span class=n>get_template</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>r_input_file</span><span class=p>))</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;catalog_interface&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>catalog_interface</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control_interface&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=p>()</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control_writer&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>control_writer</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;control&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>control</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;profile&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>profile</span>
+            <span class=n>lut</span><span class=p>[</span><span class=s1>&#39;group_title&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>group_title</span>
+            <span class=n>output</span> <span class=o>=</span> <span class=n>JinjaCmd</span><span class=o>.</span><span class=n>render_template</span><span class=p>(</span><span class=n>template</span><span class=p>,</span> <span class=n>lut</span><span class=p>,</span> <span class=n>template_folder</span><span class=p>)</span>
+
+            <span class=n>output_file</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>group_dir</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=o>+</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>)</span>
+            <span class=n>output_file</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>output</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.jinja.JinjaCmd.load_LUT class="doc doc-heading"> <code class="highlight language-python"><span class=n>load_LUT</span><span class=p>(</span><span class=n>path</span><span class=p>,</span> <span class=n>prefix</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.jinja.JinjaCmd.load_LUT class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Load a Yaml lookup table from file.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/jinja.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>load_LUT</span><span class=p>(</span><span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>  <span class=c1># noqa: N802</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Load a Yaml lookup table from file.&quot;&quot;&quot;</span>
+    <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>()</span>
+    <span class=n>lut</span> <span class=o>=</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>))</span>
+    <span class=k>if</span> <span class=n>prefix</span><span class=p>:</span>
+        <span class=n>prefixes</span> <span class=o>=</span> <span class=n>prefix</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+        <span class=k>while</span> <span class=n>prefixes</span><span class=p>:</span>
+            <span class=n>old_lut</span> <span class=o>=</span> <span class=n>lut</span>
+            <span class=n>lut</span><span class=p>[</span><span class=n>prefixes</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)]</span> <span class=o>=</span> <span class=n>old_lut</span>
+
+    <span class=k>return</span> <span class=n>lut</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.jinja.JinjaCmd.render_template class="doc doc-heading"> <code class="highlight language-python"><span class=n>render_template</span><span class=p>(</span><span class=n>template</span><span class=p>,</span> <span class=n>lut</span><span class=p>,</span> <span class=n>template_folder</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.jinja.JinjaCmd.render_template class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Render template.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/jinja.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>render_template</span><span class=p>(</span><span class=n>template</span><span class=p>:</span> <span class=n>Template</span><span class=p>,</span> <span class=n>lut</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>template_folder</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Render template.&quot;&quot;&quot;</span>
+    <span class=n>new_output</span> <span class=o>=</span> <span class=n>template</span><span class=o>.</span><span class=n>render</span><span class=p>(</span><span class=o>**</span><span class=n>lut</span><span class=p>)</span>
+    <span class=n>output</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=c1># This recursion allows nesting within expressions (e.g. an expression can contain jinja templates).</span>
+    <span class=n>error_countdown</span> <span class=o>=</span> <span class=n>JinjaCmd</span><span class=o>.</span><span class=n>max_recursion_depth</span>
+    <span class=k>while</span> <span class=n>new_output</span> <span class=o>!=</span> <span class=n>output</span> <span class=ow>and</span> <span class=n>error_countdown</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=n>error_countdown</span> <span class=o>=</span> <span class=n>error_countdown</span> <span class=o>-</span> <span class=mi>1</span>
+        <span class=n>output</span> <span class=o>=</span> <span class=n>new_output</span>
+        <span class=n>random_name</span> <span class=o>=</span> <span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()</span>  <span class=c1># Should be random and not used.</span>
+        <span class=n>dict_loader</span> <span class=o>=</span> <span class=n>DictLoader</span><span class=p>({</span><span class=nb>str</span><span class=p>(</span><span class=n>random_name</span><span class=p>):</span> <span class=n>new_output</span><span class=p>})</span>
+        <span class=n>jinja_env</span> <span class=o>=</span> <span class=n>Environment</span><span class=p>(</span>
+            <span class=n>loader</span><span class=o>=</span><span class=n>ChoiceLoader</span><span class=p>([</span><span class=n>dict_loader</span><span class=p>,</span> <span class=n>FileSystemLoader</span><span class=p>(</span><span class=n>template_folder</span><span class=p>)]),</span>
+            <span class=n>extensions</span><span class=o>=</span><span class=n>extensions</span><span class=p>(),</span>
+            <span class=n>autoescape</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span>
+            <span class=n>trim_blocks</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+        <span class=n>template</span> <span class=o>=</span> <span class=n>jinja_env</span><span class=o>.</span><span class=n>get_template</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>random_name</span><span class=p>))</span>
+        <span class=n>new_output</span> <span class=o>=</span> <span class=n>template</span><span class=o>.</span><span class=n>render</span><span class=p>(</span><span class=o>**</span><span class=n>lut</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>output</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.author.jinja-functions>Functions<a href=#trestle.core.commands.author.jinja-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/prof/index.html b/latest/reference/API/trestle/core/commands/author/prof/index.html
new file mode 100644
index 000000000..aa6b96717
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/prof/index.html
@@ -0,0 +1,2062 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.prof module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/prof/ rel=canonical><link href=../jinja/ rel=prev><link href=../ssp/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.prof - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.prof - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.prof module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/prof.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/prof/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.prof - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.prof module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/prof.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.prof class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.prof </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof class=md-nav__link> <span class=md-ellipsis> prof </span> </a> <nav class=md-nav aria-label=prof> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble class=md-nav__link> <span class=md-ellipsis> ProfileAssemble </span> </a> <nav class=md-nav aria-label=ProfileAssemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble.assemble_profile class=md-nav__link> <span class=md-ellipsis> assemble_profile </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate class=md-nav__link> <span class=md-ellipsis> ProfileGenerate </span> </a> <nav class=md-nav aria-label=ProfileGenerate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate.generate_markdown class=md-nav__link> <span class=md-ellipsis> generate_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit class=md-nav__link> <span class=md-ellipsis> ProfileInherit </span> </a> <nav class=md-nav aria-label=ProfileInherit> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit.initialize_profile class=md-nav__link> <span class=md-ellipsis> initialize_profile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit.update_profile_import class=md-nav__link> <span class=md-ellipsis> update_profile_import </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve class=md-nav__link> <span class=md-ellipsis> ProfileResolve </span> </a> <nav class=md-nav aria-label=ProfileResolve> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve.resolve_profile class=md-nav__link> <span class=md-ellipsis> resolve_profile </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof class=md-nav__link> <span class=md-ellipsis> prof </span> </a> <nav class=md-nav aria-label=prof> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble class=md-nav__link> <span class=md-ellipsis> ProfileAssemble </span> </a> <nav class=md-nav aria-label=ProfileAssemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileAssemble.assemble_profile class=md-nav__link> <span class=md-ellipsis> assemble_profile </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate class=md-nav__link> <span class=md-ellipsis> ProfileGenerate </span> </a> <nav class=md-nav aria-label=ProfileGenerate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileGenerate.generate_markdown class=md-nav__link> <span class=md-ellipsis> generate_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit class=md-nav__link> <span class=md-ellipsis> ProfileInherit </span> </a> <nav class=md-nav aria-label=ProfileInherit> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit.initialize_profile class=md-nav__link> <span class=md-ellipsis> initialize_profile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileInherit.update_profile_import class=md-nav__link> <span class=md-ellipsis> update_profile_import </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve class=md-nav__link> <span class=md-ellipsis> ProfileResolve </span> </a> <nav class=md-nav aria-label=ProfileResolve> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof.ProfileResolve.resolve_profile class=md-nav__link> <span class=md-ellipsis> resolve_profile </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.prof-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.prof</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.prof class="doc doc-heading"> <code>trestle.core.commands.author.prof</code> <a href=#trestle.core.commands.author.prof class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Author commands to generate profile as markdown and assemble to json after edit.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.prof-attributes>Attributes<a href=#trestle.core.commands.author.prof-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.prof.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.prof.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.prof-classes>Classes<a href=#trestle.core.commands.author.prof-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.prof.ProfileAssemble class="doc doc-heading"> <code>ProfileAssemble</code> <a href=#trestle.core.commands.author.prof.ProfileAssemble class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Assemble markdown files of controls into a Profile json file.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/prof.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ProfileAssemble</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble markdown files of controls into a Profile json file.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;profile-assemble&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name_help_str</span> <span class=o>=</span> <span class=p>(</span>
+            <span class=s1>&#39;Optional name of the profile model in the trestle workspace that is being modified.  &#39;</span>
+            <span class=s1>&#39;If not provided the output name is used.&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>name_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>file_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the source markdown file directory&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-m&#39;</span><span class=p>,</span> <span class=s1>&#39;--markdown&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>file_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>output_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the output generated json Profile (ok to overwrite original)&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>output_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-sp&#39;</span><span class=p>,</span> <span class=s1>&#39;--set-parameters&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_SET_PARAMS</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-r&#39;</span><span class=p>,</span> <span class=s1>&#39;--regenerate&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_REGENERATE</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-vn&#39;</span><span class=p>,</span> <span class=s1>&#39;--version&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_VERSION</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-s&#39;</span><span class=p>,</span> <span class=s1>&#39;--sections&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_SECTIONS</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-rs&#39;</span><span class=p>,</span> <span class=s1>&#39;--required-sections&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_REQUIRED_SECTIONS</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-as&#39;</span><span class=p>,</span> <span class=s1>&#39;--allowed-sections&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_ALLOWED_SECTIONS</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>assemble_profile</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=o>=</span><span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>parent_prof_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>,</span>
+                <span class=n>md_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>markdown</span><span class=p>,</span>
+                <span class=n>assem_prof_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>,</span>
+                <span class=n>set_parameters_flag</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span>
+                <span class=n>regenerate</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>regenerate</span><span class=p>,</span>
+                <span class=n>version</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>version</span><span class=p>,</span>
+                <span class=n>sections_dict</span><span class=o>=</span><span class=n>comma_colon_sep_to_dict</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>sections</span><span class=p>),</span>
+                <span class=n>required_sections</span><span class=o>=</span><span class=n>comma_sep_to_list</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>required_sections</span><span class=p>),</span>
+                <span class=n>allowed_sections</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>allowed_sections</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Assembly of markdown to profile failed&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_update_alter_adds</span><span class=p>(</span><span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>],</span> <span class=n>alter_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>new_alter</span> <span class=ow>in</span> <span class=n>alters</span><span class=p>:</span>
+            <span class=n>alter</span> <span class=o>=</span> <span class=n>alter_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>new_alter</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>alter</span><span class=p>:</span>
+                <span class=c1># the control did not have alters, so add</span>
+                <span class=n>alter</span> <span class=o>=</span> <span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>(</span><span class=n>control_id</span><span class=o>=</span><span class=n>new_alter</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=c1># even though we removed adds at start, we may have added one already</span>
+            <span class=k>if</span> <span class=n>alter</span><span class=o>.</span><span class=n>adds</span><span class=p>:</span>
+                <span class=n>alter</span><span class=o>.</span><span class=n>adds</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>new_alter</span><span class=o>.</span><span class=n>adds</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>alter</span><span class=o>.</span><span class=n>adds</span> <span class=o>=</span> <span class=n>new_alter</span><span class=o>.</span><span class=n>adds</span>
+            <span class=c1># update the dict with the new alter with its added adds</span>
+            <span class=n>alter_dict</span><span class=p>[</span><span class=n>new_alter</span><span class=o>.</span><span class=n>control_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>alter</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_replace_alter_adds</span><span class=p>(</span><span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Replace the alter adds in the orig_profile with the new ones and return True if changed.&quot;&quot;&quot;</span>
+        <span class=n>changed</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=p>:</span>
+            <span class=n>profile</span><span class=o>.</span><span class=n>modify</span> <span class=o>=</span> <span class=n>prof</span><span class=o>.</span><span class=n>Modify</span><span class=p>(</span><span class=n>alters</span><span class=o>=</span><span class=n>alters</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>alters</span><span class=p>:</span>
+                <span class=n>changed</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>elif</span> <span class=ow>not</span> <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>alters</span><span class=p>:</span>
+            <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>alters</span> <span class=o>=</span> <span class=n>alters</span>
+            <span class=k>if</span> <span class=n>alters</span><span class=p>:</span>
+                <span class=n>changed</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>alter_dict</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=c1># if an alter has adds - remove them up front and build dict of alters by control id</span>
+            <span class=k>for</span> <span class=n>alter</span> <span class=ow>in</span> <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>alters</span><span class=p>:</span>
+                <span class=n>alter</span><span class=o>.</span><span class=n>adds</span> <span class=o>=</span> <span class=kc>None</span>
+                <span class=n>alter_dict</span><span class=p>[</span><span class=n>alter</span><span class=o>.</span><span class=n>control_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>alter</span>
+            <span class=c1># now go through new alters and add them to each control in dict by control id</span>
+            <span class=n>ProfileAssemble</span><span class=o>.</span><span class=n>_update_alter_adds</span><span class=p>(</span><span class=n>profile</span><span class=p>,</span> <span class=n>alters</span><span class=p>,</span> <span class=n>alter_dict</span><span class=p>)</span>
+            <span class=c1># get the new list of alters from the dict and update profile</span>
+            <span class=n>new_alters</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>alter_dict</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+            <span class=c1># special case, if all adds were deleted remove such alters completely</span>
+            <span class=n>new_alters</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>alt</span><span class=p>:</span> <span class=n>alt</span><span class=o>.</span><span class=n>adds</span> <span class=ow>or</span> <span class=n>alt</span><span class=o>.</span><span class=n>removes</span><span class=p>,</span> <span class=n>new_alters</span><span class=p>))</span>
+            <span class=k>if</span> <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>alters</span> <span class=o>!=</span> <span class=n>new_alters</span><span class=p>:</span>
+                <span class=n>changed</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>alters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_alters</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>changed</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_replace_modify_set_params</span><span class=p>(</span>
+        <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>param_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Replace the set_params in the profile with list and values from markdown.</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            Returns whether or not change was made.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>changed</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=n>param_dict</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=p>:</span>
+                <span class=n>profile</span><span class=o>.</span><span class=n>modify</span> <span class=o>=</span> <span class=n>prof</span><span class=o>.</span><span class=n>Modify</span><span class=p>()</span>
+            <span class=n>new_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>sub_param_dict</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>sub_param_dict</span><span class=p>:</span>
+                    <span class=n>sub_param_dict</span><span class=p>[</span><span class=s1>&#39;id&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>key</span>
+                    <span class=n>param</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>dict_to_parameter</span><span class=p>(</span><span class=n>sub_param_dict</span><span class=p>)</span>
+                    <span class=n>new_set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                        <span class=n>prof</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span>
+                            <span class=n>param_id</span><span class=o>=</span><span class=n>key</span><span class=p>,</span>
+                            <span class=n>label</span><span class=o>=</span><span class=n>param</span><span class=o>.</span><span class=n>label</span><span class=p>,</span>
+                            <span class=n>values</span><span class=o>=</span><span class=n>param</span><span class=o>.</span><span class=n>values</span><span class=p>,</span>
+                            <span class=n>select</span><span class=o>=</span><span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=p>,</span>
+                            <span class=n>props</span><span class=o>=</span><span class=n>param</span><span class=o>.</span><span class=n>props</span>
+                        <span class=p>)</span>
+                    <span class=p>)</span>
+            <span class=k>if</span> <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>!=</span> <span class=n>new_set_params</span><span class=p>:</span>
+                <span class=n>changed</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=c1># sort the params first by control sorting then by param_id</span>
+            <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=nb>sorted</span><span class=p>(</span>
+                <span class=n>new_set_params</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>param</span><span class=p>:</span> <span class=p>(</span><span class=n>param_map</span><span class=p>[</span><span class=n>param</span><span class=o>.</span><span class=n>param_id</span><span class=p>],</span> <span class=n>param</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+            <span class=p>)</span>
+        <span class=k>if</span> <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=p>:</span>
+            <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>changed</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>assemble_profile</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>parent_prof_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>md_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>assem_prof_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+        <span class=n>required_sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>allowed_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Assemble the markdown directory into a json profile model file.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: The trestle root directory</span>
+<span class=sd>            parent_prof_name: Optional name of profile used to generate the markdown (default is assem_prof_name)</span>
+<span class=sd>            md_name: The name of the directory containing the markdown control files for the profile</span>
+<span class=sd>            assem_prof_name: The name of the assembled profile.  It can be the same as the parent to overwrite</span>
+<span class=sd>            set_parameters_flag: Use the params and props in yaml header to add or alter setparameters in the profile</span>
+<span class=sd>            regenerate: Whether to regenerate the uuid&#39;s in the profile</span>
+<span class=sd>            version: Optional version for the assembled profile</span>
+<span class=sd>            sections_dict: Optional map of short name to long name for sections</span>
+<span class=sd>            required_sections: List of required sections in assembled profile, as comma-separated short names</span>
+<span class=sd>            allowed_sections: Optional list of section short names that are allowed, as comma-separated short names</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            0 on success, 1 otherwise</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            There must already be a profile model and it will either be updated or a new json profile created.</span>
+<span class=sd>            The generated markdown has the current values for parameters of controls being imported, as set by</span>
+<span class=sd>            the original catalog and any intermediate profiles.  It also shows the current SetParameters being applied</span>
+<span class=sd>            by this profile.  That list of SetParameters can be edited by changing the assigned values and adding or</span>
+<span class=sd>            removing SetParameters from that list.  During assembly that list will be used to create the SetParameters</span>
+<span class=sd>            in the assembled profile if the --set-parameters option is specified.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>md_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>md_name</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>md_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown directory </span><span class=si>{</span><span class=n>md_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>parent_prof_name</span><span class=p>:</span>
+            <span class=n>parent_prof_name</span> <span class=o>=</span> <span class=n>assem_prof_name</span>
+
+        <span class=n>parent_prof_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parent_prof_path</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Profile </span><span class=si>{</span><span class=n>parent_prof_name</span><span class=si>}</span><span class=s1> does not exist.  An existing profile must be provided.&#39;</span><span class=p>)</span>
+
+        <span class=n>parent_prof</span><span class=p>,</span> <span class=n>parent_prof_path</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span>
+        <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>parent_prof_path</span><span class=p>)</span>
+
+        <span class=n>catalog</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_path</span><span class=p>,</span> <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span>
+        <span class=p>)</span>
+
+        <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span>
+            <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>,</span> <span class=n>to_markdown</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_root</span><span class=o>=</span><span class=n>md_dir</span>
+        <span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span> <span class=o>=</span> <span class=n>sections_dict</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>required_sections</span> <span class=o>=</span> <span class=n>required_sections</span>
+
+        <span class=c1># load the editable sections of the markdown and create Adds for them</span>
+        <span class=c1># then overwrite the Adds in the existing profile with the new ones</span>
+        <span class=c1># keep track if any changes were made</span>
+        <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>,</span> <span class=n>context</span><span class=o>=</span><span class=n>context</span><span class=p>)</span>
+        <span class=n>found_alters</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>,</span> <span class=n>param_map</span> <span class=o>=</span> <span class=n>catalog_api</span><span class=o>.</span><span class=n>read_additional_content_from_md</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>allowed_sections</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>bad_part</span> <span class=ow>in</span> <span class=p>[</span>
+                    <span class=n>part</span> <span class=k>for</span> <span class=n>alter</span> <span class=ow>in</span> <span class=n>found_alters</span> <span class=k>for</span> <span class=n>add</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>alter</span><span class=o>.</span><span class=n>adds</span><span class=p>)</span>
+                    <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>a</span><span class=p>:</span> <span class=n>a</span><span class=o>.</span><span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>allowed_sections</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+            <span class=p>]:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Profile has alter with name </span><span class=si>{</span><span class=n>bad_part</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> not in allowed sections.&#39;</span><span class=p>)</span>
+
+        <span class=n>ProfileAssemble</span><span class=o>.</span><span class=n>_replace_alter_adds</span><span class=p>(</span><span class=n>parent_prof</span><span class=p>,</span> <span class=n>found_alters</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>set_parameters_flag</span><span class=p>:</span>
+            <span class=n>ProfileAssemble</span><span class=o>.</span><span class=n>_replace_modify_set_params</span><span class=p>(</span><span class=n>parent_prof</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>,</span> <span class=n>param_map</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+            <span class=n>parent_prof</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+        <span class=n>parent_prof</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>oscal_version</span> <span class=o>=</span> <span class=n>OSCAL_VERSION</span>
+
+        <span class=n>assem_prof_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>new_content_type</span>
+        <span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>assem_prof_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>existing_prof</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>assem_prof_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_prof</span><span class=p>,</span> <span class=n>parent_prof</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Assembled profile is no different from existing version, so no update.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>if</span> <span class=n>regenerate</span><span class=p>:</span>
+            <span class=n>parent_prof</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>parent_prof</span><span class=p>)</span>
+        <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>parent_prof</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+
+        <span class=k>if</span> <span class=n>assem_prof_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Creating profile from markdown and destination profile exists, so updating.&#39;</span><span class=p>)</span>
+            <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>assem_prof_path</span><span class=o>.</span><span class=n>parent</span><span class=p>))</span>
+
+        <span class=n>assem_prof_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>parent_prof</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>assem_prof_path</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.prof.ProfileAssemble-attributes>Attributes<a href=#trestle.core.commands.author.prof.ProfileAssemble-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.prof.ProfileAssemble.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;profile-assemble&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.prof.ProfileAssemble.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.prof.ProfileAssemble-functions>Functions<a href=#trestle.core.commands.author.prof.ProfileAssemble-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.prof.ProfileAssemble.assemble_profile class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_profile</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_name</span><span class=p>,</span> <span class=n>md_name</span><span class=p>,</span> <span class=n>assem_prof_name</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>,</span> <span class=n>regenerate</span><span class=p>,</span> <span class=n>version</span><span class=p>,</span> <span class=n>sections_dict</span><span class=p>,</span> <span class=n>required_sections</span><span class=p>,</span> <span class=n>allowed_sections</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.prof.ProfileAssemble.assemble_profile class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble the markdown directory into a json profile model file.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The trestle root directory</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>parent_prof_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Optional name of profile used to generate the markdown (default is assem_prof_name)</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>md_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The name of the directory containing the markdown control files for the profile</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>assem_prof_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The name of the assembled profile. It can be the same as the parent to overwrite</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>set_parameters_flag</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Use the params and props in yaml header to add or alter setparameters in the profile</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>regenerate</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to regenerate the uuid's in the profile</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>version</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Optional version for the assembled profile</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>sections_dict</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, str]</code> </td> <td> <div class=doc-md-description> <p>Optional map of short name to long name for sections</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>required_sections</code> </td> <td> <code><span title=typing.List>List</span>[str]</code> </td> <td> <div class=doc-md-description> <p>List of required sections in assembled profile, as comma-separated short names</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>allowed_sections</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>Optional list of section short names that are allowed, as comma-separated short names</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>0 on success, 1 otherwise</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>There must already be a profile model and it will either be updated or a new json profile created. The generated markdown has the current values for parameters of controls being imported, as set by the original catalog and any intermediate profiles. It also shows the current SetParameters being applied by this profile. That list of SetParameters can be edited by changing the assigned values and adding or removing SetParameters from that list. During assembly that list will be used to create the SetParameters in the assembled profile if the --set-parameters option is specified.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/prof.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>assemble_profile</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>parent_prof_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>md_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>assem_prof_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+    <span class=n>required_sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>allowed_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Assemble the markdown directory into a json profile model file.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: The trestle root directory</span>
+<span class=sd>        parent_prof_name: Optional name of profile used to generate the markdown (default is assem_prof_name)</span>
+<span class=sd>        md_name: The name of the directory containing the markdown control files for the profile</span>
+<span class=sd>        assem_prof_name: The name of the assembled profile.  It can be the same as the parent to overwrite</span>
+<span class=sd>        set_parameters_flag: Use the params and props in yaml header to add or alter setparameters in the profile</span>
+<span class=sd>        regenerate: Whether to regenerate the uuid&#39;s in the profile</span>
+<span class=sd>        version: Optional version for the assembled profile</span>
+<span class=sd>        sections_dict: Optional map of short name to long name for sections</span>
+<span class=sd>        required_sections: List of required sections in assembled profile, as comma-separated short names</span>
+<span class=sd>        allowed_sections: Optional list of section short names that are allowed, as comma-separated short names</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        0 on success, 1 otherwise</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        There must already be a profile model and it will either be updated or a new json profile created.</span>
+<span class=sd>        The generated markdown has the current values for parameters of controls being imported, as set by</span>
+<span class=sd>        the original catalog and any intermediate profiles.  It also shows the current SetParameters being applied</span>
+<span class=sd>        by this profile.  That list of SetParameters can be edited by changing the assigned values and adding or</span>
+<span class=sd>        removing SetParameters from that list.  During assembly that list will be used to create the SetParameters</span>
+<span class=sd>        in the assembled profile if the --set-parameters option is specified.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>md_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>md_name</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>md_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown directory </span><span class=si>{</span><span class=n>md_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>parent_prof_name</span><span class=p>:</span>
+        <span class=n>parent_prof_name</span> <span class=o>=</span> <span class=n>assem_prof_name</span>
+
+    <span class=n>parent_prof_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parent_prof_path</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Profile </span><span class=si>{</span><span class=n>parent_prof_name</span><span class=si>}</span><span class=s1> does not exist.  An existing profile must be provided.&#39;</span><span class=p>)</span>
+
+    <span class=n>parent_prof</span><span class=p>,</span> <span class=n>parent_prof_path</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span>
+    <span class=n>new_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>parent_prof_path</span><span class=p>)</span>
+
+    <span class=n>catalog</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_path</span><span class=p>,</span> <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span>
+    <span class=p>)</span>
+
+    <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span>
+        <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>,</span> <span class=n>to_markdown</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_root</span><span class=o>=</span><span class=n>md_dir</span>
+    <span class=p>)</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span> <span class=o>=</span> <span class=n>sections_dict</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>required_sections</span> <span class=o>=</span> <span class=n>required_sections</span>
+
+    <span class=c1># load the editable sections of the markdown and create Adds for them</span>
+    <span class=c1># then overwrite the Adds in the existing profile with the new ones</span>
+    <span class=c1># keep track if any changes were made</span>
+    <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>,</span> <span class=n>context</span><span class=o>=</span><span class=n>context</span><span class=p>)</span>
+    <span class=n>found_alters</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>,</span> <span class=n>param_map</span> <span class=o>=</span> <span class=n>catalog_api</span><span class=o>.</span><span class=n>read_additional_content_from_md</span><span class=p>(</span><span class=n>label_as_key</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>allowed_sections</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>bad_part</span> <span class=ow>in</span> <span class=p>[</span>
+                <span class=n>part</span> <span class=k>for</span> <span class=n>alter</span> <span class=ow>in</span> <span class=n>found_alters</span> <span class=k>for</span> <span class=n>add</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>alter</span><span class=o>.</span><span class=n>adds</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>a</span><span class=p>:</span> <span class=n>a</span><span class=o>.</span><span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>allowed_sections</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=p>]:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Profile has alter with name </span><span class=si>{</span><span class=n>bad_part</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> not in allowed sections.&#39;</span><span class=p>)</span>
+
+    <span class=n>ProfileAssemble</span><span class=o>.</span><span class=n>_replace_alter_adds</span><span class=p>(</span><span class=n>parent_prof</span><span class=p>,</span> <span class=n>found_alters</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>set_parameters_flag</span><span class=p>:</span>
+        <span class=n>ProfileAssemble</span><span class=o>.</span><span class=n>_replace_modify_set_params</span><span class=p>(</span><span class=n>parent_prof</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>,</span> <span class=n>param_map</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+        <span class=n>parent_prof</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+    <span class=n>parent_prof</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>oscal_version</span> <span class=o>=</span> <span class=n>OSCAL_VERSION</span>
+
+    <span class=n>assem_prof_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span> <span class=n>assem_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>new_content_type</span>
+    <span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>assem_prof_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>existing_prof</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>assem_prof_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_prof</span><span class=p>,</span> <span class=n>parent_prof</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Assembled profile is no different from existing version, so no update.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>if</span> <span class=n>regenerate</span><span class=p>:</span>
+        <span class=n>parent_prof</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>parent_prof</span><span class=p>)</span>
+    <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>parent_prof</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+
+    <span class=k>if</span> <span class=n>assem_prof_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Creating profile from markdown and destination profile exists, so updating.&#39;</span><span class=p>)</span>
+        <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>assem_prof_path</span><span class=o>.</span><span class=n>parent</span><span class=p>))</span>
+
+    <span class=n>assem_prof_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>parent_prof</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>assem_prof_path</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.prof.ProfileGenerate class="doc doc-heading"> <code>ProfileGenerate</code> <a href=#trestle.core.commands.author.prof.ProfileGenerate class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Generate profile in markdown form from a profile in the trestle workspace.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/prof.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ProfileGenerate</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate profile in markdown form from a profile in the trestle workspace.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;profile-generate&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the source profile model in the trestle workspace&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>name_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_MARKDOWN_NAME</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-y&#39;</span><span class=p>,</span> <span class=s1>&#39;--yaml-header&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_YAML_PATH</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-fo&#39;</span><span class=p>,</span> <span class=s1>&#39;--force-overwrite&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_FO_OUTPUT</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-ohv&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--overwrite-header-values&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_OVERWRITE_HEADER_VALUES</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-s&#39;</span><span class=p>,</span> <span class=s1>&#39;--sections&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_SECTIONS</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-rs&#39;</span><span class=p>,</span> <span class=s1>&#39;--required-sections&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_REQUIRED_SECTIONS</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_directory_name_allowed</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1> is not an allowed directory name&#39;</span><span class=p>)</span>
+
+            <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=p>:</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>logging</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Loading yaml header file </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>()</span>
+                    <span class=n>yaml_header</span> <span class=o>=</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=p>)</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>))</span>
+                <span class=k>except</span> <span class=n>YAMLError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;YAML error loading yaml header for ssp generation: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>force_overwrite</span><span class=p>:</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Overwriting the content in </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+                    <span class=n>clear_folder</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>))</span>
+                <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to overwrite contents of </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=c1># combine command line sections with any in the yaml header, with priority to command line</span>
+            <span class=n>sections_dict</span> <span class=o>=</span> <span class=n>comma_colon_sep_to_dict</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>sections</span><span class=p>)</span>
+
+            <span class=n>profile_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;profiles/</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>/profile.json&#39;</span>
+
+            <span class=n>markdown_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>generate_markdown</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>profile_path</span><span class=p>,</span>
+                <span class=n>markdown_path</span><span class=p>,</span>
+                <span class=n>yaml_header</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+                <span class=n>sections_dict</span><span class=p>,</span>
+                <span class=n>comma_sep_to_list</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>required_sections</span><span class=p>)</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Generation of the profile markdown failed&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>generate_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>profile_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>markdown_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+        <span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate markdown for the controls in the profile.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: Root directory of the trestle workspace</span>
+<span class=sd>            profile_path: Path of the profile json file</span>
+<span class=sd>            markdown_path: Path to the directory into which the markdown will be written</span>
+<span class=sd>            yaml_header: Dict to merge into the yaml header of the control markdown</span>
+<span class=sd>            overwrite_header_values: Overwrite values in the markdown header but allow new items to be added</span>
+<span class=sd>            sections_dict: Optional dict mapping section short names to long</span>
+<span class=sd>            required_sections: Optional list of sections that get prompted for prose if not in the profile</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            0 on success, 1 on error</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>sections_dict</span> <span class=ow>and</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span> <span class=ow>in</span> <span class=n>sections_dict</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;statement is not allowed as a section name.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>profile</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>profile_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=n>catalog</span><span class=p>,</span> <span class=n>inherited_props</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span><span class=o>.</span><span class=n>get_resolved_profile_catalog_and_inherited_props</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>None</span><span class=p>,</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span>
+            <span class=p>)</span>
+
+            <span class=n>deep_set</span><span class=p>(</span><span class=n>yaml_header</span><span class=p>,</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>TITLE</span><span class=p>],</span> <span class=n>profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=p>)</span>
+
+            <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>markdown_path</span><span class=p>)</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span> <span class=o>=</span> <span class=n>yaml_header</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span> <span class=o>=</span> <span class=n>sections_dict</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>profile</span> <span class=o>=</span> <span class=n>profile</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>overwrite_header_values</span> <span class=o>=</span> <span class=n>overwrite_header_values</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>set_parameters_flag</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>required_sections</span> <span class=o>=</span> <span class=n>required_sections</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>inherited_props</span> <span class=o>=</span> <span class=n>inherited_props</span>
+            <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>,</span> <span class=n>context</span><span class=o>=</span><span class=n>context</span><span class=p>)</span>
+            <span class=n>catalog_api</span><span class=o>.</span><span class=n>write_catalog_as_markdown</span><span class=p>()</span>
+
+        <span class=k>except</span> <span class=n>TrestleNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Profile </span><span class=si>{</span><span class=n>profile_path</span><span class=si>}</span><span class=s1> not found, error </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generating the catalog as markdown: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.prof.ProfileGenerate-attributes>Attributes<a href=#trestle.core.commands.author.prof.ProfileGenerate-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.prof.ProfileGenerate.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;profile-generate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.prof.ProfileGenerate.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.prof.ProfileGenerate-functions>Functions<a href=#trestle.core.commands.author.prof.ProfileGenerate-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.prof.ProfileGenerate.generate_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate_markdown</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_path</span><span class=p>,</span> <span class=n>markdown_path</span><span class=p>,</span> <span class=n>yaml_header</span><span class=p>,</span> <span class=n>overwrite_header_values</span><span class=p>,</span> <span class=n>sections_dict</span><span class=p>,</span> <span class=n>required_sections</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.prof.ProfileGenerate.generate_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate markdown for the controls in the profile.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Root directory of the trestle workspace</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>profile_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path of the profile json file</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>markdown_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path to the directory into which the markdown will be written</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>yaml_header</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, <span title=typing.Any>Any</span>]</code> </td> <td> <div class=doc-md-description> <p>Dict to merge into the yaml header of the control markdown</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>overwrite_header_values</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Overwrite values in the markdown header but allow new items to be added</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>sections_dict</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.Dict>Dict</span>[str, str]]</code> </td> <td> <div class=doc-md-description> <p>Optional dict mapping section short names to long</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>required_sections</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>Optional list of sections that get prompted for prose if not in the profile</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>0 on success, 1 on error</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/prof.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>generate_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>profile_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>markdown_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+    <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+    <span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate markdown for the controls in the profile.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: Root directory of the trestle workspace</span>
+<span class=sd>        profile_path: Path of the profile json file</span>
+<span class=sd>        markdown_path: Path to the directory into which the markdown will be written</span>
+<span class=sd>        yaml_header: Dict to merge into the yaml header of the control markdown</span>
+<span class=sd>        overwrite_header_values: Overwrite values in the markdown header but allow new items to be added</span>
+<span class=sd>        sections_dict: Optional dict mapping section short names to long</span>
+<span class=sd>        required_sections: Optional list of sections that get prompted for prose if not in the profile</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        0 on success, 1 on error</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>sections_dict</span> <span class=ow>and</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span> <span class=ow>in</span> <span class=n>sections_dict</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;statement is not allowed as a section name.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>profile</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>profile_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=n>catalog</span><span class=p>,</span> <span class=n>inherited_props</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span><span class=o>.</span><span class=n>get_resolved_profile_catalog_and_inherited_props</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>None</span><span class=p>,</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span>
+        <span class=p>)</span>
+
+        <span class=n>deep_set</span><span class=p>(</span><span class=n>yaml_header</span><span class=p>,</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>TITLE</span><span class=p>],</span> <span class=n>profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=p>)</span>
+
+        <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>markdown_path</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span> <span class=o>=</span> <span class=n>yaml_header</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span> <span class=o>=</span> <span class=n>sections_dict</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>profile</span> <span class=o>=</span> <span class=n>profile</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>overwrite_header_values</span> <span class=o>=</span> <span class=n>overwrite_header_values</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>set_parameters_flag</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>required_sections</span> <span class=o>=</span> <span class=n>required_sections</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>inherited_props</span> <span class=o>=</span> <span class=n>inherited_props</span>
+        <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>,</span> <span class=n>context</span><span class=o>=</span><span class=n>context</span><span class=p>)</span>
+        <span class=n>catalog_api</span><span class=o>.</span><span class=n>write_catalog_as_markdown</span><span class=p>()</span>
+
+    <span class=k>except</span> <span class=n>TrestleNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Profile </span><span class=si>{</span><span class=n>profile_path</span><span class=si>}</span><span class=s1> not found, error </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generating the catalog as markdown: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.prof.ProfileInherit class="doc doc-heading"> <code>ProfileInherit</code> <a href=#trestle.core.commands.author.prof.ProfileInherit class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Generate and populate profile in JSON from a parent profile and leveraged ssp in the trestle workspace.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/prof.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span>
+<span class=normal>654</span>
+<span class=normal>655</span>
+<span class=normal>656</span>
+<span class=normal>657</span>
+<span class=normal>658</span>
+<span class=normal>659</span>
+<span class=normal>660</span>
+<span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span>
+<span class=normal>664</span>
+<span class=normal>665</span>
+<span class=normal>666</span>
+<span class=normal>667</span>
+<span class=normal>668</span>
+<span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span>
+<span class=normal>672</span>
+<span class=normal>673</span>
+<span class=normal>674</span>
+<span class=normal>675</span>
+<span class=normal>676</span>
+<span class=normal>677</span>
+<span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span>
+<span class=normal>685</span>
+<span class=normal>686</span>
+<span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span>
+<span class=normal>700</span>
+<span class=normal>701</span>
+<span class=normal>702</span>
+<span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span>
+<span class=normal>706</span>
+<span class=normal>707</span>
+<span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span>
+<span class=normal>714</span>
+<span class=normal>715</span>
+<span class=normal>716</span>
+<span class=normal>717</span>
+<span class=normal>718</span>
+<span class=normal>719</span>
+<span class=normal>720</span>
+<span class=normal>721</span>
+<span class=normal>722</span>
+<span class=normal>723</span>
+<span class=normal>724</span>
+<span class=normal>725</span>
+<span class=normal>726</span>
+<span class=normal>727</span>
+<span class=normal>728</span>
+<span class=normal>729</span>
+<span class=normal>730</span>
+<span class=normal>731</span>
+<span class=normal>732</span>
+<span class=normal>733</span>
+<span class=normal>734</span>
+<span class=normal>735</span>
+<span class=normal>736</span>
+<span class=normal>737</span>
+<span class=normal>738</span>
+<span class=normal>739</span>
+<span class=normal>740</span>
+<span class=normal>741</span>
+<span class=normal>742</span>
+<span class=normal>743</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ProfileInherit</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate and populate profile in JSON from a parent profile and leveraged ssp in the trestle workspace.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;profile-inherit&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>ssp_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the leveraged ssp model in the trestle workspace&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-s&#39;</span><span class=p>,</span> <span class=s1>&#39;--ssp&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>ssp_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>profile_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the parent profile model in the trestle workspace&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-p&#39;</span><span class=p>,</span> <span class=s1>&#39;--profile&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>profile_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>output_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the output generated json Profile&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>output_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-vn&#39;</span><span class=p>,</span> <span class=s1>&#39;--version&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_VERSION</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>profile</span> <span class=ow>and</span> <span class=n>args</span><span class=o>.</span><span class=n>profile</span> <span class=o>==</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Output profile </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1> cannot equal parent&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>INCORRECT_ARGS</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>initialize_profile</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=o>=</span><span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>parent_prof_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>profile</span><span class=p>,</span>
+                <span class=n>output_prof_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>,</span>
+                <span class=n>leveraged_ssp_name</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>ssp</span><span class=p>,</span>
+                <span class=n>version</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>version</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Profile generation failed&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_is_inherited</span><span class=p>(</span><span class=n>all_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+        <span class=c1># Fail fast by checking for any non-compliant components.</span>
+        <span class=c1># Must contain provided export statements, no responsibility</span>
+        <span class=c1># statements, and be implemented.</span>
+        <span class=k>for</span> <span class=n>comp</span> <span class=ow>in</span> <span class=n>all_comps</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>comp</span><span class=o>.</span><span class=n>export</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+            <span class=k>if</span> <span class=n>comp</span><span class=o>.</span><span class=n>export</span><span class=o>.</span><span class=n>responsibilities</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+            <span class=k>if</span> <span class=n>comp</span><span class=o>.</span><span class=n>export</span><span class=o>.</span><span class=n>provided</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+            <span class=k>if</span> <span class=n>comp</span><span class=o>.</span><span class=n>implementation_status</span><span class=o>.</span><span class=n>state</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>STATUS_IMPLEMENTED</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_create_components_by_id</span><span class=p>(</span><span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]]:</span>
+        <span class=n>components_by_id</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>implemented_requirement</span> <span class=ow>in</span> <span class=n>leveraged_ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+            <span class=n>by_components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>if</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>by_components</span><span class=p>:</span>
+                <span class=n>by_components</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>by_components</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>stm</span> <span class=ow>in</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>stm</span><span class=o>.</span><span class=n>by_components</span><span class=p>:</span>
+                        <span class=n>by_components</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>stm</span><span class=o>.</span><span class=n>by_components</span><span class=p>)</span>
+            <span class=n>components_by_id</span><span class=p>[</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>by_components</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>components_by_id</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>update_profile_import</span><span class=p>(</span>
+        <span class=n>orig_prof_import</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Import</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span> <span class=n>catalog_api</span><span class=p>:</span> <span class=n>CatalogAPI</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add controls to different sections of a profile import based on catalog and leveraged SSP.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            orig_prof_import: The original profile import that will have the control selection updated.</span>
+<span class=sd>            leveraged_ssp: SSP input for control filtering</span>
+<span class=sd>            catalog_api: Catalog API with access to controls that need to be filtered</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            None</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>exclude_with_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+
+        <span class=c1># Create dictionary containing all by-components by control for faster searching</span>
+        <span class=n>components_by_id</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>ProfileInherit</span><span class=o>.</span><span class=n>_create_components_by_id</span><span class=p>(</span><span class=n>leveraged_ssp</span><span class=p>)</span>
+
+        <span class=c1># Looping by controls in the catalog because the ids in the profile should</span>
+        <span class=c1># be a subset of the catalog and not the ssp controls.</span>
+        <span class=n>catalog_control_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_ids</span><span class=p>())</span>
+        <span class=k>for</span> <span class=n>control_id</span> <span class=ow>in</span> <span class=n>catalog_control_ids</span><span class=p>:</span>
+
+            <span class=k>if</span> <span class=n>control_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>components_by_id</span><span class=p>:</span>
+                <span class=k>continue</span>
+
+            <span class=n>by_comps</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>components_by_id</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>by_comps</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>ProfileInherit</span><span class=o>.</span><span class=n>_is_inherited</span><span class=p>(</span><span class=n>by_comps</span><span class=p>):</span>
+                <span class=n>exclude_with_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+
+        <span class=n>include_with_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>catalog_control_ids</span> <span class=o>-</span> <span class=n>exclude_with_ids</span>
+
+        <span class=n>orig_prof_import</span><span class=o>.</span><span class=n>include_controls</span> <span class=o>=</span> <span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>SelectControl</span><span class=p>(</span><span class=n>with_ids</span><span class=o>=</span><span class=nb>sorted</span><span class=p>(</span><span class=n>include_with_ids</span><span class=p>))]</span>
+        <span class=n>orig_prof_import</span><span class=o>.</span><span class=n>exclude_controls</span> <span class=o>=</span> <span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>SelectControl</span><span class=p>(</span><span class=n>with_ids</span><span class=o>=</span><span class=nb>sorted</span><span class=p>(</span><span class=n>exclude_with_ids</span><span class=p>))]</span>
+
+    <span class=k>def</span> <span class=nf>initialize_profile</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>parent_prof_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>output_prof_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>leveraged_ssp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize profile with controls from a parent profile, filtering by inherited controls.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: Root directory of the trestle workspace</span>
+<span class=sd>            parent_prof_name: Name of the parent profile in the trestle workspace</span>
+<span class=sd>            output_prof_name: Name of the output profile json file</span>
+<span class=sd>            leveraged_ssp_name: Name of the ssp in the trestle workspace for control filtering</span>
+<span class=sd>            version: Optional profile version</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            0 on success, 1 on error</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            The profile model will either be updated or a new json profile created. This will overwrite</span>
+<span class=sd>            any import information on an exiting profile, but will preserve control modifications and parameters.</span>
+<span class=sd>            Allowing profile updates ensure that SSP export updates can be incorporated into an existing profile. All</span>
+<span class=sd>            controls from the original profile will exists and will be grouped by included and excluded controls based</span>
+<span class=sd>            on inheritance information.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>result_profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span>
+            <span class=n>existing_profile</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+
+            <span class=n>existing_profile_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>output_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span>
+            <span class=p>)</span>
+
+            <span class=c1># If a profile exists at the output path, use that as a starting point for a new profile.</span>
+            <span class=c1># else create a new sample profile.</span>
+            <span class=k>if</span> <span class=n>existing_profile_path</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>existing_profile</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span>
+                                                               <span class=n>output_prof_name</span><span class=p>,</span>
+                                                               <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span>
+                                                               <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+                <span class=n>result_profile</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>existing_profile</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>result_profile</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span>
+
+            <span class=n>parent_prof_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=n>parent_prof_path</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleNotFoundError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Profile </span><span class=si>{</span><span class=n>parent_prof_name</span><span class=si>}</span><span class=s1> does not exist.  An existing profile must be provided.&#39;</span>
+                <span class=p>)</span>
+
+            <span class=n>local_path</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;profiles/</span><span class=si>{</span><span class=n>parent_prof_name</span><span class=si>}</span><span class=s1>/profile.json&#39;</span>
+            <span class=n>profile_import</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Import</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>prof</span><span class=o>.</span><span class=n>Import</span><span class=p>)</span>
+            <span class=n>profile_import</span><span class=o>.</span><span class=n>href</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span> <span class=o>+</span> <span class=n>local_path</span>
+
+            <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span>
+                    <span class=n>trestle_root</span><span class=p>,</span>
+                    <span class=n>leveraged_ssp_name</span><span class=p>,</span>
+                    <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+                    <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+                <span class=p>)</span>
+            <span class=k>except</span> <span class=n>TrestleNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;SSP </span><span class=si>{</span><span class=n>leveraged_ssp_name</span><span class=si>}</span><span class=s1> not found: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>prof_resolver</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span>
+            <span class=n>catalog</span> <span class=o>=</span> <span class=n>prof_resolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_path</span><span class=p>,</span> <span class=n>show_value_warnings</span><span class=o>=</span><span class=kc>True</span>
+            <span class=p>)</span>
+            <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>)</span>
+
+            <span class=c1># Sort controls based on what controls in the SSP have exported provided information with no</span>
+            <span class=c1># customer responsibility</span>
+            <span class=n>ProfileInherit</span><span class=o>.</span><span class=n>update_profile_import</span><span class=p>(</span><span class=n>profile_import</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>catalog_api</span><span class=p>)</span>
+
+            <span class=n>result_profile</span><span class=o>.</span><span class=n>imports</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>=</span> <span class=n>profile_import</span>
+
+            <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+                <span class=n>result_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+            <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_profile</span><span class=p>,</span> <span class=n>result_profile</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Profile is no different from existing version, so no update.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>result_profile</span><span class=p>)</span>
+            <span class=n>ModelUtils</span><span class=o>.</span><span class=n>save_top_level_model</span><span class=p>(</span><span class=n>result_profile</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>output_prof_name</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+        <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error initializing profile </span><span class=si>{</span><span class=n>output_prof_name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.prof.ProfileInherit-attributes>Attributes<a href=#trestle.core.commands.author.prof.ProfileInherit-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.prof.ProfileInherit.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;profile-inherit&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.prof.ProfileInherit.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.prof.ProfileInherit-functions>Functions<a href=#trestle.core.commands.author.prof.ProfileInherit-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.prof.ProfileInherit.initialize_profile class="doc doc-heading"> <code class="highlight language-python"><span class=n>initialize_profile</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_name</span><span class=p>,</span> <span class=n>output_prof_name</span><span class=p>,</span> <span class=n>leveraged_ssp_name</span><span class=p>,</span> <span class=n>version</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.prof.ProfileInherit.initialize_profile class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize profile with controls from a parent profile, filtering by inherited controls.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Root directory of the trestle workspace</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>parent_prof_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Name of the parent profile in the trestle workspace</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>output_prof_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Name of the output profile json file</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>leveraged_ssp_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Name of the ssp in the trestle workspace for control filtering</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>version</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Optional profile version</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>0 on success, 1 on error</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>The profile model will either be updated or a new json profile created. This will overwrite any import information on an exiting profile, but will preserve control modifications and parameters. Allowing profile updates ensure that SSP export updates can be incorporated into an existing profile. All controls from the original profile will exists and will be grouped by included and excluded controls based on inheritance information.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/prof.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span>
+<span class=normal>654</span>
+<span class=normal>655</span>
+<span class=normal>656</span>
+<span class=normal>657</span>
+<span class=normal>658</span>
+<span class=normal>659</span>
+<span class=normal>660</span>
+<span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span>
+<span class=normal>664</span>
+<span class=normal>665</span>
+<span class=normal>666</span>
+<span class=normal>667</span>
+<span class=normal>668</span>
+<span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span>
+<span class=normal>672</span>
+<span class=normal>673</span>
+<span class=normal>674</span>
+<span class=normal>675</span>
+<span class=normal>676</span>
+<span class=normal>677</span>
+<span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span>
+<span class=normal>685</span>
+<span class=normal>686</span>
+<span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span>
+<span class=normal>700</span>
+<span class=normal>701</span>
+<span class=normal>702</span>
+<span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span>
+<span class=normal>706</span>
+<span class=normal>707</span>
+<span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span>
+<span class=normal>714</span>
+<span class=normal>715</span>
+<span class=normal>716</span>
+<span class=normal>717</span>
+<span class=normal>718</span>
+<span class=normal>719</span>
+<span class=normal>720</span>
+<span class=normal>721</span>
+<span class=normal>722</span>
+<span class=normal>723</span>
+<span class=normal>724</span>
+<span class=normal>725</span>
+<span class=normal>726</span>
+<span class=normal>727</span>
+<span class=normal>728</span>
+<span class=normal>729</span>
+<span class=normal>730</span>
+<span class=normal>731</span>
+<span class=normal>732</span>
+<span class=normal>733</span>
+<span class=normal>734</span>
+<span class=normal>735</span>
+<span class=normal>736</span>
+<span class=normal>737</span>
+<span class=normal>738</span>
+<span class=normal>739</span>
+<span class=normal>740</span>
+<span class=normal>741</span>
+<span class=normal>742</span>
+<span class=normal>743</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>initialize_profile</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>parent_prof_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>output_prof_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>leveraged_ssp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize profile with controls from a parent profile, filtering by inherited controls.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: Root directory of the trestle workspace</span>
+<span class=sd>        parent_prof_name: Name of the parent profile in the trestle workspace</span>
+<span class=sd>        output_prof_name: Name of the output profile json file</span>
+<span class=sd>        leveraged_ssp_name: Name of the ssp in the trestle workspace for control filtering</span>
+<span class=sd>        version: Optional profile version</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        0 on success, 1 on error</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        The profile model will either be updated or a new json profile created. This will overwrite</span>
+<span class=sd>        any import information on an exiting profile, but will preserve control modifications and parameters.</span>
+<span class=sd>        Allowing profile updates ensure that SSP export updates can be incorporated into an existing profile. All</span>
+<span class=sd>        controls from the original profile will exists and will be grouped by included and excluded controls based</span>
+<span class=sd>        on inheritance information.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>result_profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span>
+        <span class=n>existing_profile</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+
+        <span class=n>existing_profile_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>output_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span>
+        <span class=p>)</span>
+
+        <span class=c1># If a profile exists at the output path, use that as a starting point for a new profile.</span>
+        <span class=c1># else create a new sample profile.</span>
+        <span class=k>if</span> <span class=n>existing_profile_path</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>existing_profile</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span>
+                                                           <span class=n>output_prof_name</span><span class=p>,</span>
+                                                           <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span>
+                                                           <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+            <span class=n>result_profile</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>existing_profile</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>result_profile</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span>
+
+        <span class=n>parent_prof_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=n>parent_prof_path</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleNotFoundError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Profile </span><span class=si>{</span><span class=n>parent_prof_name</span><span class=si>}</span><span class=s1> does not exist.  An existing profile must be provided.&#39;</span>
+            <span class=p>)</span>
+
+        <span class=n>local_path</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;profiles/</span><span class=si>{</span><span class=n>parent_prof_name</span><span class=si>}</span><span class=s1>/profile.json&#39;</span>
+        <span class=n>profile_import</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Import</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>prof</span><span class=o>.</span><span class=n>Import</span><span class=p>)</span>
+        <span class=n>profile_import</span><span class=o>.</span><span class=n>href</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span> <span class=o>+</span> <span class=n>local_path</span>
+
+        <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>leveraged_ssp_name</span><span class=p>,</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+                <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=n>TrestleNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;SSP </span><span class=si>{</span><span class=n>leveraged_ssp_name</span><span class=si>}</span><span class=s1> not found: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>prof_resolver</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=n>prof_resolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>parent_prof_path</span><span class=p>,</span> <span class=n>show_value_warnings</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+        <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>)</span>
+
+        <span class=c1># Sort controls based on what controls in the SSP have exported provided information with no</span>
+        <span class=c1># customer responsibility</span>
+        <span class=n>ProfileInherit</span><span class=o>.</span><span class=n>update_profile_import</span><span class=p>(</span><span class=n>profile_import</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>catalog_api</span><span class=p>)</span>
+
+        <span class=n>result_profile</span><span class=o>.</span><span class=n>imports</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>=</span> <span class=n>profile_import</span>
+
+        <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+            <span class=n>result_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+        <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_profile</span><span class=p>,</span> <span class=n>result_profile</span><span class=p>):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Profile is no different from existing version, so no update.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>result_profile</span><span class=p>)</span>
+        <span class=n>ModelUtils</span><span class=o>.</span><span class=n>save_top_level_model</span><span class=p>(</span><span class=n>result_profile</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>output_prof_name</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+    <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error initializing profile </span><span class=si>{</span><span class=n>output_prof_name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.prof.ProfileInherit.update_profile_import class="doc doc-heading"> <code class="highlight language-python"><span class=n>update_profile_import</span><span class=p>(</span><span class=n>orig_prof_import</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>catalog_api</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.prof.ProfileInherit.update_profile_import class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add controls to different sections of a profile import based on catalog and leveraged SSP.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>orig_prof_import</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.profile.Import href=../../../../oscal/profile/#trestle.oscal.profile.Import>Import</a></code> </td> <td> <div class=doc-md-description> <p>The original profile import that will have the control selection updated.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>leveraged_ssp</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.ssp.SystemSecurityPlan href=../../../../oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan>SystemSecurityPlan</a></code> </td> <td> <div class=doc-md-description> <p>SSP input for control filtering</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>catalog_api</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.catalog.catalog_api.CatalogAPI href=../../../catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI>CatalogAPI</a></code> </td> <td> <div class=doc-md-description> <p>Catalog API with access to controls that need to be filtered</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>None</code> </td> <td> <div class=doc-md-description> <p>None</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/prof.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>update_profile_import</span><span class=p>(</span>
+    <span class=n>orig_prof_import</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Import</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span> <span class=n>catalog_api</span><span class=p>:</span> <span class=n>CatalogAPI</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add controls to different sections of a profile import based on catalog and leveraged SSP.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        orig_prof_import: The original profile import that will have the control selection updated.</span>
+<span class=sd>        leveraged_ssp: SSP input for control filtering</span>
+<span class=sd>        catalog_api: Catalog API with access to controls that need to be filtered</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        None</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>exclude_with_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+
+    <span class=c1># Create dictionary containing all by-components by control for faster searching</span>
+    <span class=n>components_by_id</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>ProfileInherit</span><span class=o>.</span><span class=n>_create_components_by_id</span><span class=p>(</span><span class=n>leveraged_ssp</span><span class=p>)</span>
+
+    <span class=c1># Looping by controls in the catalog because the ids in the profile should</span>
+    <span class=c1># be a subset of the catalog and not the ssp controls.</span>
+    <span class=n>catalog_control_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_ids</span><span class=p>())</span>
+    <span class=k>for</span> <span class=n>control_id</span> <span class=ow>in</span> <span class=n>catalog_control_ids</span><span class=p>:</span>
+
+        <span class=k>if</span> <span class=n>control_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>components_by_id</span><span class=p>:</span>
+            <span class=k>continue</span>
+
+        <span class=n>by_comps</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>components_by_id</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>by_comps</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>ProfileInherit</span><span class=o>.</span><span class=n>_is_inherited</span><span class=p>(</span><span class=n>by_comps</span><span class=p>):</span>
+            <span class=n>exclude_with_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+
+    <span class=n>include_with_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>catalog_control_ids</span> <span class=o>-</span> <span class=n>exclude_with_ids</span>
+
+    <span class=n>orig_prof_import</span><span class=o>.</span><span class=n>include_controls</span> <span class=o>=</span> <span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>SelectControl</span><span class=p>(</span><span class=n>with_ids</span><span class=o>=</span><span class=nb>sorted</span><span class=p>(</span><span class=n>include_with_ids</span><span class=p>))]</span>
+    <span class=n>orig_prof_import</span><span class=o>.</span><span class=n>exclude_controls</span> <span class=o>=</span> <span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>SelectControl</span><span class=p>(</span><span class=n>with_ids</span><span class=o>=</span><span class=nb>sorted</span><span class=p>(</span><span class=n>exclude_with_ids</span><span class=p>))]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.prof.ProfileResolve class="doc doc-heading"> <code>ProfileResolve</code> <a href=#trestle.core.commands.author.prof.ProfileResolve class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Resolve profile to resolved profile catalog.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/prof.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ProfileResolve</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Resolve profile to resolved profile catalog.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;profile-resolve&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the source profile model in the trestle workspace&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>name_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of the output resolved profile catalog&#39;</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-sv&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--show-values&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Show values for parameters in prose&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-sl&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--show-labels&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Show labels for parameters in prose instead of values&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-bf&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--bracket-format&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;With -sv, allows brackets around value, e.g. [.] or ((.)), with the dot representing the value.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=s1>&#39;&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-vap&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--value-assigned-prefix&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;With -sv, places a prefix in front of the parameter string if a value has been assigned.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=s1>&#39;&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-vnap&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--value-not-assigned-prefix&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;With -sv, places a prefix in front of the parameter string if a value has *not* been assigned.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=s1>&#39;&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-lp&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--label-prefix&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;With -sl, places a prefix in front of the parameter label.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=s1>&#39;&#39;</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>
+            <span class=n>profile_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;profiles/</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>/profile.json&#39;</span>
+            <span class=n>catalog_name</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span>
+            <span class=n>show_values</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>show_values</span>
+            <span class=n>param_format</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>bracket_format</span>
+            <span class=n>value_assigned_prefix</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>value_assigned_prefix</span>
+            <span class=n>value_not_assigned_prefix</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>value_not_assigned_prefix</span>
+            <span class=n>label_prefix</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>label_prefix</span>
+            <span class=n>show_labels</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>show_labels</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>resolve_profile</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>profile_path</span><span class=p>,</span>
+                <span class=n>catalog_name</span><span class=p>,</span>
+                <span class=n>show_values</span><span class=p>,</span>
+                <span class=n>param_format</span><span class=p>,</span>
+                <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                <span class=n>value_not_assigned_prefix</span><span class=p>,</span>
+                <span class=n>show_labels</span><span class=p>,</span>
+                <span class=n>label_prefix</span>
+            <span class=p>)</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Generation of the resolved profile catalog failed&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>resolve_profile</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>profile_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>catalog_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>show_values</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>bracket_format</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>show_labels</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>label_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create resolved profile catalog from given profile.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: Root directory of the trestle workspace</span>
+<span class=sd>            profile_path: Path of the profile json file</span>
+<span class=sd>            catalog_name: Name of the resolved profile catalog</span>
+<span class=sd>            show_values: If true, show values of parameters in prose rather than original {{}} form</span>
+<span class=sd>            bracket_format: String representing brackets around value, e.g. [.] or ((.))</span>
+<span class=sd>            value_assigned_prefix: Prefix placed in front of param string if a value was assigned</span>
+<span class=sd>            value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned</span>
+<span class=sd>            show_labels: Show labels for parameters and not values</span>
+<span class=sd>            label_prefix: Prefix placed in front of param label</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            0 on success and raises exception on error</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>profile_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleNotFoundError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cannot resolve profile catalog: profile </span><span class=si>{</span><span class=n>profile_path</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+        <span class=n>param_rep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span>
+        <span class=k>if</span> <span class=n>show_values</span><span class=p>:</span>
+            <span class=n>param_rep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>ASSIGNMENT_FORM</span>
+            <span class=k>if</span> <span class=n>label_prefix</span> <span class=ow>or</span> <span class=n>show_labels</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Use of show-values is not compatible with show-labels or label-prefix&#39;</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>value_assigned_prefix</span> <span class=ow>or</span> <span class=n>value_not_assigned_prefix</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Use of value-assigned-prefix or value-not-assigned-prefix requires show-values&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>show_labels</span><span class=p>:</span>
+            <span class=n>param_rep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LABEL_FORM</span>
+            <span class=c1># overload value_not_assigned_prefix to use the label_prefix value</span>
+            <span class=n>value_not_assigned_prefix</span> <span class=o>=</span> <span class=n>label_prefix</span>
+        <span class=k>elif</span> <span class=n>label_prefix</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Use of label-prefix requires show-labels&#39;</span><span class=p>)</span>
+
+        <span class=n>bracket_format</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>bracket_format</span><span class=p>)</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>profile_path</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=n>bracket_format</span><span class=p>,</span>
+            <span class=n>param_rep</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=n>value_assigned_prefix</span><span class=p>,</span>
+            <span class=n>value_not_assigned_prefix</span>
+        <span class=p>)</span>
+        <span class=n>ModelUtils</span><span class=o>.</span><span class=n>save_top_level_model</span><span class=p>(</span><span class=n>catalog</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>catalog_name</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.prof.ProfileResolve-attributes>Attributes<a href=#trestle.core.commands.author.prof.ProfileResolve-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.prof.ProfileResolve.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;profile-resolve&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.prof.ProfileResolve.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.prof.ProfileResolve-functions>Functions<a href=#trestle.core.commands.author.prof.ProfileResolve-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.prof.ProfileResolve.resolve_profile class="doc doc-heading"> <code class="highlight language-python"><span class=n>resolve_profile</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_path</span><span class=p>,</span> <span class=n>catalog_name</span><span class=p>,</span> <span class=n>show_values</span><span class=p>,</span> <span class=n>bracket_format</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=p>,</span> <span class=n>show_labels</span><span class=p>,</span> <span class=n>label_prefix</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.prof.ProfileResolve.resolve_profile class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create resolved profile catalog from given profile.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Root directory of the trestle workspace</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>profile_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path of the profile json file</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>catalog_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Name of the resolved profile catalog</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>show_values</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>If true, show values of parameters in prose rather than original {{}} form</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>bracket_format</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>String representing brackets around value, e.g. [.] or ((.))</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>value_assigned_prefix</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Prefix placed in front of param string if a value was assigned</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>value_not_assigned_prefix</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Prefix placed in front of param string if a value was <em>not</em> assigned</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>show_labels</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Show labels for parameters and not values</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>label_prefix</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Prefix placed in front of param label</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>0 on success and raises exception on error</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/prof.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>resolve_profile</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>profile_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>catalog_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>show_values</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>bracket_format</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>show_labels</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>label_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create resolved profile catalog from given profile.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: Root directory of the trestle workspace</span>
+<span class=sd>        profile_path: Path of the profile json file</span>
+<span class=sd>        catalog_name: Name of the resolved profile catalog</span>
+<span class=sd>        show_values: If true, show values of parameters in prose rather than original {{}} form</span>
+<span class=sd>        bracket_format: String representing brackets around value, e.g. [.] or ((.))</span>
+<span class=sd>        value_assigned_prefix: Prefix placed in front of param string if a value was assigned</span>
+<span class=sd>        value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned</span>
+<span class=sd>        show_labels: Show labels for parameters and not values</span>
+<span class=sd>        label_prefix: Prefix placed in front of param label</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        0 on success and raises exception on error</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>profile_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleNotFoundError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cannot resolve profile catalog: profile </span><span class=si>{</span><span class=n>profile_path</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+    <span class=n>param_rep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span>
+    <span class=k>if</span> <span class=n>show_values</span><span class=p>:</span>
+        <span class=n>param_rep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>ASSIGNMENT_FORM</span>
+        <span class=k>if</span> <span class=n>label_prefix</span> <span class=ow>or</span> <span class=n>show_labels</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Use of show-values is not compatible with show-labels or label-prefix&#39;</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=n>value_assigned_prefix</span> <span class=ow>or</span> <span class=n>value_not_assigned_prefix</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Use of value-assigned-prefix or value-not-assigned-prefix requires show-values&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>show_labels</span><span class=p>:</span>
+        <span class=n>param_rep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LABEL_FORM</span>
+        <span class=c1># overload value_not_assigned_prefix to use the label_prefix value</span>
+        <span class=n>value_not_assigned_prefix</span> <span class=o>=</span> <span class=n>label_prefix</span>
+    <span class=k>elif</span> <span class=n>label_prefix</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Use of label-prefix requires show-labels&#39;</span><span class=p>)</span>
+
+    <span class=n>bracket_format</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>bracket_format</span><span class=p>)</span>
+    <span class=n>catalog</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span>
+        <span class=n>profile_path</span><span class=p>,</span>
+        <span class=kc>False</span><span class=p>,</span>
+        <span class=kc>False</span><span class=p>,</span>
+        <span class=n>bracket_format</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>,</span>
+        <span class=kc>False</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span>
+    <span class=p>)</span>
+    <span class=n>ModelUtils</span><span class=o>.</span><span class=n>save_top_level_model</span><span class=p>(</span><span class=n>catalog</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>catalog_name</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.author.prof-functions>Functions<a href=#trestle.core.commands.author.prof-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/ssp/index.html b/latest/reference/API/trestle/core/commands/author/ssp/index.html
new file mode 100644
index 000000000..64d92b81a
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/ssp/index.html
@@ -0,0 +1,2105 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.ssp module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/ssp/ rel=canonical><link href=../prof/ rel=prev><link href=../versioning/template_versioning/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.ssp - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.ssp - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.ssp module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/ssp.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/ssp/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.ssp - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.ssp module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/ssp.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.ssp class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp class=md-nav__link> <span class=md-ellipsis> ssp </span> </a> <nav class=md-nav aria-label=ssp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPAssemble class=md-nav__link> <span class=md-ellipsis> SSPAssemble </span> </a> <nav class=md-nav aria-label=SSPAssemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPAssemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPAssemble.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter class=md-nav__link> <span class=md-ellipsis> SSPFilter </span> </a> <nav class=md-nav aria-label=SSPFilter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter.filter_ssp class=md-nav__link> <span class=md-ellipsis> filter_ssp </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPGenerate class=md-nav__link> <span class=md-ellipsis> SSPGenerate </span> </a> <nav class=md-nav aria-label=SSPGenerate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPGenerate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPGenerate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp class=md-nav__link> <span class=md-ellipsis> ssp </span> </a> <nav class=md-nav aria-label=ssp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPAssemble class=md-nav__link> <span class=md-ellipsis> SSPAssemble </span> </a> <nav class=md-nav aria-label=SSPAssemble> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPAssemble-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPAssemble.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter class=md-nav__link> <span class=md-ellipsis> SSPFilter </span> </a> <nav class=md-nav aria-label=SSPFilter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPFilter.filter_ssp class=md-nav__link> <span class=md-ellipsis> filter_ssp </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPGenerate class=md-nav__link> <span class=md-ellipsis> SSPGenerate </span> </a> <nav class=md-nav aria-label=SSPGenerate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPGenerate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp.SSPGenerate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.ssp-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.ssp</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.ssp class="doc doc-heading"> <code>trestle.core.commands.author.ssp</code> <a href=#trestle.core.commands.author.ssp class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Create ssp from catalog and profile.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.ssp-attributes>Attributes<a href=#trestle.core.commands.author.ssp-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.ssp.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.ssp.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.ssp-classes>Classes<a href=#trestle.core.commands.author.ssp-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.ssp.SSPAssemble class="doc doc-heading"> <code>SSPAssemble</code> <a href=#trestle.core.commands.author.ssp.SSPAssemble class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Assemble markdown files of controls into an SSP json file.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span>
+<span class=normal>654</span>
+<span class=normal>655</span>
+<span class=normal>656</span>
+<span class=normal>657</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SSPAssemble</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble markdown files of controls into an SSP json file.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ssp-assemble&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name_help_str</span> <span class=o>=</span> <span class=p>(</span>
+            <span class=s1>&#39;Optional name of the ssp model in the trestle workspace that is being modified.  &#39;</span>
+            <span class=s1>&#39;If not provided the output name is used.&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>name_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>file_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the input markdown file directory&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-m&#39;</span><span class=p>,</span> <span class=s1>&#39;--markdown&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>file_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>output_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the output generated json SSP&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-cd&#39;</span><span class=p>,</span> <span class=s1>&#39;--compdefs&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_COMPDEFS</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>output_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-r&#39;</span><span class=p>,</span> <span class=s1>&#39;--regenerate&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_REGENERATE</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-vn&#39;</span><span class=p>,</span> <span class=s1>&#39;--version&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_VERSION</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_ssp_component</span><span class=p>(</span><span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span> <span class=n>gen_comp</span><span class=p>:</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span> <span class=o>==</span> <span class=n>gen_comp</span><span class=o>.</span><span class=n>title</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>component</span>
+        <span class=c1># if this is a new system component assign its status as operational by default</span>
+        <span class=c1># the status of the system components are not stored in the markdown</span>
+        <span class=n>gen_comp</span><span class=o>.</span><span class=n>status</span><span class=o>.</span><span class=n>state</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span>
+        <span class=n>new_component</span> <span class=o>=</span> <span class=n>gen_comp</span><span class=o>.</span><span class=n>as_system_component</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>new_component</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_merge_by_comps</span><span class=p>(</span><span class=n>stat</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>,</span> <span class=n>statement</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>,</span> <span class=n>set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+            <span class=n>found</span> <span class=o>=</span> <span class=kc>False</span>
+            <span class=k>for</span> <span class=n>dest_by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>stat</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>dest_by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=o>==</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span><span class=p>:</span>
+                    <span class=n>dest_by_comp</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>description</span>
+                    <span class=n>dest_by_comp</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>dest_by_comp</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+                    <span class=n>dest_by_comp</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+                    <span class=n>dest_by_comp</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>by_comp</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+                    <span class=n>dest_by_comp</span><span class=o>.</span><span class=n>implementation_status</span> <span class=o>=</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span>
+                    <span class=n>dest_by_comp</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>set_params</span><span class=p>)</span>
+                    <span class=n>found</span> <span class=o>=</span> <span class=kc>True</span>
+                    <span class=k>break</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>found</span><span class=p>:</span>
+                <span class=n>stat</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>stat</span><span class=o>.</span><span class=n>by_components</span><span class=p>)</span>
+                <span class=n>by_comp</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>set_params</span><span class=p>)</span>
+                <span class=n>stat</span><span class=o>.</span><span class=n>by_components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_merge_statement</span><span class=p>(</span>
+        <span class=n>imp_req</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span>
+        <span class=n>statement</span><span class=p>:</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericStatement</span><span class=p>,</span>
+        <span class=n>set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>],</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge the generic statement into the statements of the imp_req.&quot;&quot;&quot;</span>
+        <span class=c1># if the statement id is already in the imp_req, merge its by_comps into the existing statement</span>
+        <span class=k>for</span> <span class=n>stat</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>stat</span><span class=o>.</span><span class=n>statement_id</span> <span class=o>==</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span><span class=p>:</span>
+                <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_merge_by_comps</span><span class=p>(</span><span class=n>stat</span><span class=p>,</span> <span class=n>statement</span><span class=p>,</span> <span class=n>set_params</span><span class=p>)</span>
+                <span class=k>return</span>
+        <span class=c1># otherwise just ad the statement - but only if it has by_comps</span>
+        <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>by_components</span><span class=p>:</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_merge_imp_req_into_imp_req</span><span class=p>(</span>
+        <span class=n>imp_req</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span>
+        <span class=n>gen_imp_req</span><span class=p>:</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericImplementedRequirement</span><span class=p>,</span>
+        <span class=n>set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge comp def imp req into existing imp req.&quot;&quot;&quot;</span>
+        <span class=c1># convert generic imp req from comp defs into ssp form</span>
+        <span class=n>src_imp_req</span> <span class=o>=</span> <span class=n>gen_imp_req</span><span class=o>.</span><span class=n>as_ssp</span><span class=p>()</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>gen_imp_req</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>remove_imp_status</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>remove_all_rule_info</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=p>)</span>
+        <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>src_imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+            <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_merge_statement</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>statement</span><span class=p>,</span> <span class=n>set_params</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_params_for_rules</span><span class=p>(</span><span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>rules_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+                              <span class=n>set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all set_params needed by the rules along with non-rule set_params.&quot;&quot;&quot;</span>
+        <span class=n>needed_param_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+        <span class=n>rule_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=c1># find param_ids needed by rules</span>
+        <span class=k>for</span> <span class=n>rule_id</span> <span class=ow>in</span> <span class=n>rules_list</span><span class=p>:</span>
+            <span class=c1># get list of param_ids associated with this rule_id</span>
+            <span class=n>param_ids</span> <span class=o>=</span> <span class=p>[</span>
+                <span class=n>param</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=k>for</span> <span class=n>params</span> <span class=ow>in</span> <span class=n>rule_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()</span> <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>params</span> <span class=k>if</span> <span class=n>param</span><span class=p>[</span><span class=s1>&#39;rule-id&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=n>rule_id</span>
+            <span class=p>]</span>
+            <span class=n>needed_param_ids</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>param_ids</span><span class=p>)</span>
+        <span class=n>all_rule_param_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>param</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=k>for</span> <span class=n>params</span> <span class=ow>in</span> <span class=n>rule_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()</span> <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>params</span><span class=p>]</span>
+        <span class=c1># any set_param that isn&#39;t associated with a rule should be included as a normal control set param with no rule</span>
+        <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>set_params</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>all_rule_param_ids</span><span class=p>:</span>
+                <span class=n>needed_param_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+        <span class=n>param_ids_list</span> <span class=o>=</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>needed_param_ids</span><span class=p>)</span>
+        <span class=n>needed_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>param_id</span> <span class=ow>in</span> <span class=n>param_ids_list</span><span class=p>:</span>
+            <span class=n>set_param</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=k>for</span> <span class=n>sp</span> <span class=ow>in</span> <span class=n>set_params</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>sp</span><span class=o>.</span><span class=n>param_id</span> <span class=o>==</span> <span class=n>param_id</span><span class=p>:</span>
+                    <span class=n>set_param</span> <span class=o>=</span> <span class=n>sp</span>
+                    <span class=k>break</span>
+            <span class=k>if</span> <span class=n>set_param</span><span class=p>:</span>
+                <span class=n>needed_set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_param</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No set param found for param </span><span class=si>{</span><span class=n>param_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>needed_set_params</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_imp_req_to_ssp</span><span class=p>(</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+        <span class=n>gen_comp</span><span class=p>:</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>,</span>
+        <span class=n>gen_imp_req</span><span class=p>:</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericImplementedRequirement</span><span class=p>,</span>
+        <span class=n>set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>],</span>
+        <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add imp req from control implementation into new ssp being assembled.&quot;&quot;&quot;</span>
+        <span class=c1># the incoming gen_imp_req comes directly from the comp def</span>
+        <span class=c1># but the imp_req here is pulled from the ssp and created if not already there</span>
+        <span class=n>imp_req</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_get_imp_req_for_control</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>gen_imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=n>local_set_params</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>set_params</span><span class=p>)[:]</span>
+        <span class=n>local_set_params</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>))</span>
+        <span class=n>local_set_params</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>uniquify_set_params</span><span class=p>(</span><span class=n>local_set_params</span><span class=p>)</span>
+        <span class=c1># get any rules set at control level, if present</span>
+        <span class=n>rules_list</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>gen_imp_req</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=c1># There should be no rule content at top level of imp_req in ssp so strip them out</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>gen_imp_req</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>remove_imp_status</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>remove_all_rule_info</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=p>)</span>
+        <span class=c1># if we have rules applying or need to make set_params, we need to make a by_comp</span>
+        <span class=n>control_set_params</span> <span class=o>=</span> <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_get_params_for_rules</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>rules_list</span><span class=p>,</span> <span class=n>local_set_params</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>rules_list</span> <span class=ow>or</span> <span class=n>control_set_params</span><span class=p>:</span>
+            <span class=n>by_comp</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>)</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=o>=</span> <span class=n>gen_comp</span><span class=o>.</span><span class=n>uuid</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>gen_imp_req</span><span class=o>.</span><span class=n>description</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>control_set_params</span><span class=p>)</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>gen_imp_req</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>gen_imp_req</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+        <span class=c1># each statement in ci corresponds to by_comp in an ssp imp req</span>
+        <span class=c1># so insert the new by_comp directly into the ssp, generating parts as needed</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>gen_imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>item_has_rules</span><span class=p>(</span><span class=n>statement</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=n>imp_req</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_get_imp_req_for_statement</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>gen_imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span><span class=p>)</span>
+                <span class=n>by_comp</span> <span class=o>=</span> <span class=n>CatalogReader</span><span class=o>.</span><span class=n>_get_by_comp_from_imp_req</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span><span class=p>,</span> <span class=n>gen_comp</span><span class=o>.</span><span class=n>uuid</span><span class=p>)</span>
+                <span class=n>by_comp</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>description</span>
+                <span class=n>by_comp</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+                <span class=n>rules_list</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+                <span class=n>by_comp</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span>
+                    <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_get_params_for_rules</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>rules_list</span><span class=p>,</span> <span class=n>local_set_params</span><span class=p>)</span>
+                <span class=p>)</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>)</span>
+        <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span>
+            <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span>
+        <span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_merge_imp_req_into_ssp</span><span class=p>(</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+        <span class=n>gen_imp_req</span><span class=p>:</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericImplementedRequirement</span><span class=p>,</span>
+        <span class=n>set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>],</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge the new imp_reqs into the ssp.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>gen_imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>:</span>
+                <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_merge_imp_req_into_imp_req</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>gen_imp_req</span><span class=p>,</span> <span class=n>set_params</span><span class=p>)</span>
+                <span class=k>return</span>
+        <span class=n>new_imp_req</span> <span class=o>=</span> <span class=n>gen_imp_req</span><span class=o>.</span><span class=n>as_ssp</span><span class=p>()</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>gen_imp_req</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>remove_imp_status</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>remove_all_rule_info</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=p>)</span>
+        <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_imp_req</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_merge_comp_defs</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+        <span class=n>comp_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>],</span>
+        <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span>
+        <span class=n>catalog_interface</span><span class=p>:</span> <span class=n>CatalogInterface</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge the original generic comp defs into the ssp.&quot;&quot;&quot;</span>
+        <span class=n>all_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># determine if this is a new and empty ssp</span>
+        <span class=n>new_ssp</span> <span class=o>=</span> <span class=ow>not</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span>
+        <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>gen_comp</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=o>=</span> <span class=n>gen_comp</span><span class=o>.</span><span class=n>title</span>
+            <span class=n>all_ci_props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>com</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>ssp_comp</span> <span class=o>=</span> <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_get_ssp_component</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>gen_comp</span><span class=p>)</span>
+            <span class=n>set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>ci</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>gen_comp</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>):</span>
+                <span class=n>all_ci_props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>ci</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+                <span class=c1># get the list of set_params in the control implementation - for this component</span>
+                <span class=k>for</span> <span class=n>sp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ci</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                    <span class=n>set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sp</span><span class=o>.</span><span class=n>to_ssp</span><span class=p>())</span>
+                <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ci</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+                    <span class=c1># ignore any controls not in the ssp profile (resolved catalog)</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>):</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Ignoring imp_req for control </span><span class=si>{</span><span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1> not in ssp profile&#39;</span><span class=p>)</span>
+                        <span class=k>continue</span>
+                    <span class=k>if</span> <span class=n>new_ssp</span><span class=p>:</span>
+                        <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_add_imp_req_to_ssp</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>gen_comp</span><span class=p>,</span> <span class=n>imp_req</span><span class=p>,</span> <span class=n>set_params</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=c1># compile all new uuids for new component definitions</span>
+                        <span class=n>comp_uuids</span> <span class=o>=</span> <span class=p>[</span><span class=n>x</span><span class=o>.</span><span class=n>uuid</span> <span class=k>for</span> <span class=n>x</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()]</span>
+                        <span class=k>for</span> <span class=n>imp_requirement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+                            <span class=n>to_delete</span> <span class=o>=</span> <span class=p>[]</span>
+                            <span class=k>for</span> <span class=n>i</span><span class=p>,</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>imp_requirement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                                <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>comp_uuids</span><span class=p>:</span>
+                                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                                        <span class=sa>f</span><span class=s1>&#39;By_component </span><span class=si>{</span><span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span><span class=si>}</span><span class=s1> removed from implemented requirement &#39;</span>
+                                        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>imp_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1> because the corresponding component is not in &#39;</span>
+                                        <span class=s1>&#39;the specified compdefs &#39;</span>
+                                    <span class=p>)</span>
+                                    <span class=n>to_delete</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>i</span><span class=p>)</span>
+                            <span class=k>if</span> <span class=n>to_delete</span><span class=p>:</span>
+                                <span class=n>delete_list_from_list</span><span class=p>(</span><span class=n>imp_requirement</span><span class=o>.</span><span class=n>by_components</span><span class=p>,</span> <span class=n>to_delete</span><span class=p>)</span>
+                        <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_merge_imp_req_into_ssp</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>imp_req</span><span class=p>,</span> <span class=n>set_params</span><span class=p>)</span>
+            <span class=n>ssp_comp</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>gen_comp</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+            <span class=n>ssp_comp</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>all_ci_props</span><span class=p>)</span>
+            <span class=n>ssp_comp</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>ssp_comp</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+            <span class=n>all_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ssp_comp</span><span class=p>)</span>
+
+        <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>all_comps</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_generate_roles_in_metadata</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find all roles referenced by imp reqs and create role in metadata as needed.&quot;&quot;&quot;</span>
+        <span class=n>metadata</span> <span class=o>=</span> <span class=n>ssp</span><span class=o>.</span><span class=n>metadata</span>
+        <span class=n>metadata</span><span class=o>.</span><span class=n>roles</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>metadata</span><span class=o>.</span><span class=n>roles</span><span class=p>)</span>
+        <span class=n>known_role_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>role</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>role</span> <span class=ow>in</span> <span class=n>metadata</span><span class=o>.</span><span class=n>roles</span><span class=p>]</span>
+        <span class=n>changed</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+            <span class=n>role_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>resp_role</span><span class=o>.</span><span class=n>role_id</span> <span class=k>for</span> <span class=n>resp_role</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>responsible_roles</span><span class=p>)]</span>
+            <span class=k>for</span> <span class=n>role_id</span> <span class=ow>in</span> <span class=n>role_ids</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>role_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>known_role_ids</span><span class=p>:</span>
+                    <span class=n>role</span> <span class=o>=</span> <span class=n>com</span><span class=o>.</span><span class=n>Role</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=n>role_id</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>role_id</span><span class=p>)</span>
+                    <span class=n>metadata</span><span class=o>.</span><span class=n>roles</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>role</span><span class=p>)</span>
+                    <span class=n>known_role_ids</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>role_id</span><span class=p>)</span>
+                    <span class=n>changed</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=n>metadata</span><span class=o>.</span><span class=n>roles</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>metadata</span><span class=o>.</span><span class=n>roles</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>changed</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_build_comp_dict_from_comp_defs</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>comp_def_name_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>create_sys_comp</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>]:</span>
+        <span class=n>comp_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>comp_name</span> <span class=ow>in</span> <span class=n>comp_def_name_list</span><span class=p>:</span>
+            <span class=n>comp_def</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_model_for_class</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>def_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>comp_def</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+                <span class=n>gen_def_comp</span> <span class=o>=</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=o>.</span><span class=n>from_defined_component</span><span class=p>(</span><span class=n>def_comp</span><span class=p>)</span>
+                <span class=n>comp_dict</span><span class=p>[</span><span class=n>def_comp</span><span class=o>.</span><span class=n>title</span><span class=p>]</span> <span class=o>=</span> <span class=n>gen_def_comp</span>
+        <span class=k>if</span> <span class=n>create_sys_comp</span><span class=p>:</span>
+            <span class=n>sys_comp</span> <span class=o>=</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=o>.</span><span class=n>generate</span><span class=p>()</span>
+            <span class=n>sys_comp</span><span class=o>.</span><span class=n>type</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>THIS_SYSTEM_AS_KEY</span>
+            <span class=n>sys_comp</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span>
+            <span class=n>comp_dict</span><span class=p>[</span><span class=n>sys_comp</span><span class=o>.</span><span class=n>title</span><span class=p>]</span> <span class=o>=</span> <span class=n>sys_comp</span>
+        <span class=k>return</span> <span class=n>comp_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_this_system_as_gen_comp</span><span class=p>(</span><span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=p>]:</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericComponent</span><span class=o>.</span><span class=n>from_defined_component</span><span class=p>(</span><span class=n>component</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+
+            <span class=n>md_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>markdown</span>
+
+            <span class=c1># the original, reference ssp name defaults to same as output if name not specified</span>
+            <span class=c1># thus in cyclic editing you are reading and writing same json ssp</span>
+            <span class=n>orig_ssp_name</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+                <span class=n>orig_ssp_name</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span>
+            <span class=n>new_ssp_name</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span>
+
+            <span class=n>_</span><span class=p>,</span> <span class=n>profile_href</span> <span class=o>=</span> <span class=n>ComponentAssemble</span><span class=o>.</span><span class=n>_get_profile_title_and_href_from_dir</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span>
+            <span class=n>res_cat</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_href</span><span class=p>,</span> <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span>
+            <span class=p>)</span>
+            <span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>res_cat</span><span class=p>)</span>
+
+            <span class=n>new_file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+
+            <span class=c1># if output ssp already exists, load it to see if new one is different</span>
+            <span class=n>existing_ssp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=n>new_ssp_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>new_ssp_name</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=n>new_ssp_path</span><span class=p>:</span>
+                <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>existing_ssp</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>new_ssp_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+                <span class=n>new_file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>new_ssp_path</span><span class=p>)</span>
+
+            <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+
+            <span class=c1># if orig ssp exists - need to load it rather than instantiate new one</span>
+            <span class=n>orig_ssp_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>orig_ssp_name</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+            <span class=p>)</span>
+
+            <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_path</span><span class=p>)</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>comp_def_name_list</span> <span class=o>=</span> <span class=n>comma_sep_to_list</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>compdefs</span><span class=p>)</span>
+            <span class=n>part_id_map_by_id</span> <span class=o>=</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_statement_part_id_map</span><span class=p>(</span><span class=kc>False</span><span class=p>)</span>
+            <span class=n>catalog_interface</span><span class=o>.</span><span class=n>generate_control_rule_info</span><span class=p>(</span><span class=n>part_id_map_by_id</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+            <span class=c1># load all original comp defs</span>
+            <span class=c1># only additions from markdown will be imp_req prose and status</span>
+            <span class=c1># and param vals</span>
+            <span class=c1># if this is a new ssp then create system component in the comp_dict</span>
+            <span class=n>comp_dict</span> <span class=o>=</span> <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_build_comp_dict_from_comp_defs</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_def_name_list</span><span class=p>,</span> <span class=ow>not</span> <span class=n>orig_ssp_path</span>
+            <span class=p>)</span>
+
+            <span class=n>part_id_map_by_label</span> <span class=o>=</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_statement_part_id_map</span><span class=p>(</span><span class=kc>True</span><span class=p>)</span>
+
+            <span class=c1># if ssp already exists use it as container for new content</span>
+            <span class=k>if</span> <span class=n>orig_ssp_path</span><span class=p>:</span>
+                <span class=c1># load the existing json ssp</span>
+                <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>ssp</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>orig_ssp_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+                <span class=c1># add the This System comp to the comp dict so its uuid is known</span>
+                <span class=n>sys_comp</span> <span class=o>=</span> <span class=n>SSPAssemble</span><span class=o>.</span><span class=n>_get_this_system_as_gen_comp</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>sys_comp</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Original ssp has no system component.&#39;</span><span class=p>)</span>
+                <span class=n>comp_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>]</span> <span class=o>=</span> <span class=n>sys_comp</span>
+
+                <span class=n>ssp_sys_imp_comps</span> <span class=o>=</span> <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span>
+                <span class=c1># Gather the leveraged components to add back after the merge</span>
+                <span class=n>leveraged_comps</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+                <span class=k>for</span> <span class=n>sys_comp</span> <span class=ow>in</span> <span class=n>ssp_sys_imp_comps</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>sys_comp</span><span class=o>.</span><span class=n>props</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=n>prop_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>x</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>x</span> <span class=ow>in</span> <span class=n>sys_comp</span><span class=o>.</span><span class=n>props</span><span class=p>]</span>
+                        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>LEV_AUTH_UUID</span> <span class=ow>in</span> <span class=n>prop_names</span><span class=p>:</span>
+                            <span class=n>leveraged_comps</span><span class=p>[</span><span class=n>sys_comp</span><span class=o>.</span><span class=n>title</span><span class=p>]</span> <span class=o>=</span> <span class=n>sys_comp</span>
+
+                <span class=c1># Verifies older compdefs in an ssp no longer exist in newly provided ones</span>
+                <span class=n>comp_titles</span> <span class=o>=</span> <span class=p>[</span><span class=n>x</span><span class=o>.</span><span class=n>title</span> <span class=k>for</span> <span class=n>x</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()]</span>
+                <span class=n>diffs</span> <span class=o>=</span> <span class=p>[</span><span class=n>x</span> <span class=k>for</span> <span class=n>x</span> <span class=ow>in</span> <span class=n>ssp_sys_imp_comps</span> <span class=k>if</span> <span class=n>x</span><span class=o>.</span><span class=n>title</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>comp_titles</span> <span class=ow>and</span> <span class=n>x</span><span class=o>.</span><span class=n>title</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>leveraged_comps</span><span class=p>]</span>
+                <span class=k>if</span> <span class=n>diffs</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>diff</span> <span class=ow>in</span> <span class=n>diffs</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;Component named: </span><span class=si>{</span><span class=n>diff</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> was removed from system components from ssp &#39;</span>
+                            <span class=s1>&#39;because the corresponding component is not in &#39;</span>
+                            <span class=s1>&#39;the specified compdefs &#39;</span>
+                        <span class=p>)</span>
+                    <span class=n>index_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>ssp_sys_imp_comps</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>value</span><span class=p>)</span> <span class=k>for</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>diffs</span> <span class=k>if</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>ssp_sys_imp_comps</span><span class=p>]</span>
+                    <span class=n>delete_list_from_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>,</span> <span class=n>index_list</span><span class=p>)</span>
+
+                <span class=bp>self</span><span class=o>.</span><span class=n>_merge_comp_defs</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>context</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>)</span>
+                <span class=n>CatalogReader</span><span class=o>.</span><span class=n>read_ssp_md_content</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>part_id_map_by_label</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+                <span class=n>new_file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>orig_ssp_path</span><span class=p>)</span>
+
+                <span class=c1># Add the leveraged comps back to the final ssp</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>leveraged_comps</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># create a sample ssp to hold all the parts</span>
+                <span class=n>ssp</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_merge_comp_defs</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>context</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>)</span>
+                <span class=n>CatalogReader</span><span class=o>.</span><span class=n>read_ssp_md_content</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>part_id_map_by_label</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+                <span class=n>import_profile</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImportProfile</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImportProfile</span><span class=p>)</span>
+                <span class=n>import_profile</span><span class=o>.</span><span class=n>href</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>import_profile</span> <span class=o>=</span> <span class=n>import_profile</span>
+
+            <span class=c1># now that we know the complete list of needed components, add them to the sys_imp</span>
+            <span class=c1># TODO if the ssp already existed then components may need to be removed if not ref&#39;d by imp_reqs</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_generate_roles_in_metadata</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span>
+
+            <span class=c1># If this is a leveraging SSP, update it with the retrieved exports from the leveraged SSP</span>
+            <span class=n>inheritance_markdown_path</span> <span class=o>=</span> <span class=n>md_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>INHERITANCE_VIEW_DIR</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>exists</span><span class=p>(</span><span class=n>inheritance_markdown_path</span><span class=p>):</span>
+                <span class=n>SSPInheritanceAPI</span><span class=p>(</span><span class=n>inheritance_markdown_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span><span class=o>.</span><span class=n>update_ssp_inheritance</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span>
+
+            <span class=n>ssp</span><span class=o>.</span><span class=n>import_profile</span><span class=o>.</span><span class=n>href</span> <span class=o>=</span> <span class=n>profile_href</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>version</span><span class=p>:</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>version</span>
+
+            <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_ssp</span><span class=p>,</span> <span class=n>ssp</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;No changes to assembled ssp so ssp not written out.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>regenerate</span><span class=p>:</span>
+                <span class=n>ssp</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span>
+            <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span>
+            <span class=c1># validate model rules before saving</span>
+            <span class=n>args_validate</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span><span class=n>mode</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>VAL_MODE_RULES</span><span class=p>)</span>
+            <span class=n>validator</span><span class=p>:</span> <span class=n>Validator</span> <span class=o>=</span> <span class=n>validator_factory</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>args_validate</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>validator</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span>
+                    <span class=s1>&#39;Validation of file to be imported did not pass. Rule parameter values validation failed, &#39;</span>
+                    <span class=s1>&#39;please check values are correct for shared parameters in current model&#39;</span>
+                <span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+            <span class=c1># write out the ssp as json</span>
+            <span class=n>ModelUtils</span><span class=o>.</span><span class=n>save_top_level_model</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>new_ssp_name</span><span class=p>,</span> <span class=n>new_file_content_type</span><span class=p>)</span>
+
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while assembling SSP&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.ssp.SSPAssemble-attributes>Attributes<a href=#trestle.core.commands.author.ssp.SSPAssemble-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.ssp.SSPAssemble.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ssp-assemble&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.ssp.SSPAssemble.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.ssp.SSPFilter class="doc doc-heading"> <code>SSPFilter</code> <a href=#trestle.core.commands.author.ssp.SSPFilter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Filter the controls in an ssp.</p> <p>The filtered ssp is based on controls included by the following: profile, components, implementation status, and/or control origination.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>660</span>
+<span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span>
+<span class=normal>664</span>
+<span class=normal>665</span>
+<span class=normal>666</span>
+<span class=normal>667</span>
+<span class=normal>668</span>
+<span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span>
+<span class=normal>672</span>
+<span class=normal>673</span>
+<span class=normal>674</span>
+<span class=normal>675</span>
+<span class=normal>676</span>
+<span class=normal>677</span>
+<span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span>
+<span class=normal>685</span>
+<span class=normal>686</span>
+<span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span>
+<span class=normal>700</span>
+<span class=normal>701</span>
+<span class=normal>702</span>
+<span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span>
+<span class=normal>706</span>
+<span class=normal>707</span>
+<span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span>
+<span class=normal>714</span>
+<span class=normal>715</span>
+<span class=normal>716</span>
+<span class=normal>717</span>
+<span class=normal>718</span>
+<span class=normal>719</span>
+<span class=normal>720</span>
+<span class=normal>721</span>
+<span class=normal>722</span>
+<span class=normal>723</span>
+<span class=normal>724</span>
+<span class=normal>725</span>
+<span class=normal>726</span>
+<span class=normal>727</span>
+<span class=normal>728</span>
+<span class=normal>729</span>
+<span class=normal>730</span>
+<span class=normal>731</span>
+<span class=normal>732</span>
+<span class=normal>733</span>
+<span class=normal>734</span>
+<span class=normal>735</span>
+<span class=normal>736</span>
+<span class=normal>737</span>
+<span class=normal>738</span>
+<span class=normal>739</span>
+<span class=normal>740</span>
+<span class=normal>741</span>
+<span class=normal>742</span>
+<span class=normal>743</span>
+<span class=normal>744</span>
+<span class=normal>745</span>
+<span class=normal>746</span>
+<span class=normal>747</span>
+<span class=normal>748</span>
+<span class=normal>749</span>
+<span class=normal>750</span>
+<span class=normal>751</span>
+<span class=normal>752</span>
+<span class=normal>753</span>
+<span class=normal>754</span>
+<span class=normal>755</span>
+<span class=normal>756</span>
+<span class=normal>757</span>
+<span class=normal>758</span>
+<span class=normal>759</span>
+<span class=normal>760</span>
+<span class=normal>761</span>
+<span class=normal>762</span>
+<span class=normal>763</span>
+<span class=normal>764</span>
+<span class=normal>765</span>
+<span class=normal>766</span>
+<span class=normal>767</span>
+<span class=normal>768</span>
+<span class=normal>769</span>
+<span class=normal>770</span>
+<span class=normal>771</span>
+<span class=normal>772</span>
+<span class=normal>773</span>
+<span class=normal>774</span>
+<span class=normal>775</span>
+<span class=normal>776</span>
+<span class=normal>777</span>
+<span class=normal>778</span>
+<span class=normal>779</span>
+<span class=normal>780</span>
+<span class=normal>781</span>
+<span class=normal>782</span>
+<span class=normal>783</span>
+<span class=normal>784</span>
+<span class=normal>785</span>
+<span class=normal>786</span>
+<span class=normal>787</span>
+<span class=normal>788</span>
+<span class=normal>789</span>
+<span class=normal>790</span>
+<span class=normal>791</span>
+<span class=normal>792</span>
+<span class=normal>793</span>
+<span class=normal>794</span>
+<span class=normal>795</span>
+<span class=normal>796</span>
+<span class=normal>797</span>
+<span class=normal>798</span>
+<span class=normal>799</span>
+<span class=normal>800</span>
+<span class=normal>801</span>
+<span class=normal>802</span>
+<span class=normal>803</span>
+<span class=normal>804</span>
+<span class=normal>805</span>
+<span class=normal>806</span>
+<span class=normal>807</span>
+<span class=normal>808</span>
+<span class=normal>809</span>
+<span class=normal>810</span>
+<span class=normal>811</span>
+<span class=normal>812</span>
+<span class=normal>813</span>
+<span class=normal>814</span>
+<span class=normal>815</span>
+<span class=normal>816</span>
+<span class=normal>817</span>
+<span class=normal>818</span>
+<span class=normal>819</span>
+<span class=normal>820</span>
+<span class=normal>821</span>
+<span class=normal>822</span>
+<span class=normal>823</span>
+<span class=normal>824</span>
+<span class=normal>825</span>
+<span class=normal>826</span>
+<span class=normal>827</span>
+<span class=normal>828</span>
+<span class=normal>829</span>
+<span class=normal>830</span>
+<span class=normal>831</span>
+<span class=normal>832</span>
+<span class=normal>833</span>
+<span class=normal>834</span>
+<span class=normal>835</span>
+<span class=normal>836</span>
+<span class=normal>837</span>
+<span class=normal>838</span>
+<span class=normal>839</span>
+<span class=normal>840</span>
+<span class=normal>841</span>
+<span class=normal>842</span>
+<span class=normal>843</span>
+<span class=normal>844</span>
+<span class=normal>845</span>
+<span class=normal>846</span>
+<span class=normal>847</span>
+<span class=normal>848</span>
+<span class=normal>849</span>
+<span class=normal>850</span>
+<span class=normal>851</span>
+<span class=normal>852</span>
+<span class=normal>853</span>
+<span class=normal>854</span>
+<span class=normal>855</span>
+<span class=normal>856</span>
+<span class=normal>857</span>
+<span class=normal>858</span>
+<span class=normal>859</span>
+<span class=normal>860</span>
+<span class=normal>861</span>
+<span class=normal>862</span>
+<span class=normal>863</span>
+<span class=normal>864</span>
+<span class=normal>865</span>
+<span class=normal>866</span>
+<span class=normal>867</span>
+<span class=normal>868</span>
+<span class=normal>869</span>
+<span class=normal>870</span>
+<span class=normal>871</span>
+<span class=normal>872</span>
+<span class=normal>873</span>
+<span class=normal>874</span>
+<span class=normal>875</span>
+<span class=normal>876</span>
+<span class=normal>877</span>
+<span class=normal>878</span>
+<span class=normal>879</span>
+<span class=normal>880</span>
+<span class=normal>881</span>
+<span class=normal>882</span>
+<span class=normal>883</span>
+<span class=normal>884</span>
+<span class=normal>885</span>
+<span class=normal>886</span>
+<span class=normal>887</span>
+<span class=normal>888</span>
+<span class=normal>889</span>
+<span class=normal>890</span>
+<span class=normal>891</span>
+<span class=normal>892</span>
+<span class=normal>893</span>
+<span class=normal>894</span>
+<span class=normal>895</span>
+<span class=normal>896</span>
+<span class=normal>897</span>
+<span class=normal>898</span>
+<span class=normal>899</span>
+<span class=normal>900</span>
+<span class=normal>901</span>
+<span class=normal>902</span>
+<span class=normal>903</span>
+<span class=normal>904</span>
+<span class=normal>905</span>
+<span class=normal>906</span>
+<span class=normal>907</span>
+<span class=normal>908</span>
+<span class=normal>909</span>
+<span class=normal>910</span>
+<span class=normal>911</span>
+<span class=normal>912</span>
+<span class=normal>913</span>
+<span class=normal>914</span>
+<span class=normal>915</span>
+<span class=normal>916</span>
+<span class=normal>917</span>
+<span class=normal>918</span>
+<span class=normal>919</span>
+<span class=normal>920</span>
+<span class=normal>921</span>
+<span class=normal>922</span>
+<span class=normal>923</span>
+<span class=normal>924</span>
+<span class=normal>925</span>
+<span class=normal>926</span>
+<span class=normal>927</span>
+<span class=normal>928</span>
+<span class=normal>929</span>
+<span class=normal>930</span>
+<span class=normal>931</span>
+<span class=normal>932</span>
+<span class=normal>933</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SSPFilter</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Filter the controls in an ssp.</span>
+
+<span class=sd>    The filtered ssp is based on controls included by the following:</span>
+<span class=sd>    profile, components, implementation status, and/or control origination.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ssp-filter&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>file_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the input ssp&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>file_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>file_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the optional input profile that defines set of controls in filtered ssp&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-p&#39;</span><span class=p>,</span> <span class=s1>&#39;--profile&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>file_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>output_help_str</span> <span class=o>=</span> <span class=s1>&#39;Name of the output generated SSP&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>output_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-r&#39;</span><span class=p>,</span> <span class=s1>&#39;--regenerate&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_REGENERATE</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-vn&#39;</span><span class=p>,</span> <span class=s1>&#39;--version&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_VERSION</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>comp_help_str</span> <span class=o>=</span> <span class=s1>&#39;Colon-delimited list of component names to include in filtered ssp.&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-c&#39;</span><span class=p>,</span> <span class=s1>&#39;--components&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>comp_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>is_help_str</span> <span class=o>=</span> <span class=s1>&#39;Comma-delimited list of control implementation statuses to include in filtered ssp.&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-is&#39;</span><span class=p>,</span> <span class=s1>&#39;--implementation-status&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>is_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=n>co_help_str</span> <span class=o>=</span> <span class=s1>&#39;Comma-delimited list of control origination values to include in filtered ssp.&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-co&#39;</span><span class=p>,</span> <span class=s1>&#39;--control-origination&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>co_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+            <span class=n>comp_names</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=n>impl_status_values</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=n>co_values</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>components</span> <span class=ow>or</span> <span class=n>args</span><span class=o>.</span><span class=n>implementation_status</span> <span class=ow>or</span> <span class=n>args</span><span class=o>.</span><span class=n>profile</span> <span class=ow>or</span> <span class=n>args</span><span class=o>.</span><span class=n>control_origination</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=s1>&#39;You must specify at least one, or a combination of: profile, list of component names&#39;</span>
+                    <span class=s1>&#39;, list of implementation statuses, or list of control origination values for ssp-filter.&#39;</span>
+                <span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+                <span class=n>comp_names</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>components</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;:&#39;</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>implementation_status</span><span class=p>:</span>
+                <span class=n>impl_status_values</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>implementation_status</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+                <span class=n>allowed_is_values</span> <span class=o>=</span> <span class=p>{</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>STATUS_PLANNED</span><span class=p>,</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>STATUS_PARTIAL</span><span class=p>,</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>STATUS_IMPLEMENTED</span><span class=p>,</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>STATUS_ALTERNATIVE</span><span class=p>,</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>STATUS_NOT_APPLICABLE</span>
+                <span class=p>}</span>
+                <span class=n>allowed_is_string</span> <span class=o>=</span> <span class=s1>&#39;, &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>item</span><span class=p>)</span> <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>allowed_is_values</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>impl_status</span> <span class=ow>in</span> <span class=n>impl_status_values</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>impl_status</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>allowed_is_values</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;Provided implementation status &quot;</span><span class=si>{</span><span class=n>impl_status</span><span class=si>}</span><span class=s1>&quot; is invalid.</span><span class=se>\n</span><span class=s1>&#39;</span>
+                            <span class=sa>f</span><span class=s1>&#39;Please use the following for ssp-filter: </span><span class=si>{</span><span class=n>allowed_is_string</span><span class=si>}</span><span class=s1>&#39;</span>
+                        <span class=p>)</span>
+                        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>control_origination</span><span class=p>:</span>
+                <span class=n>co_values</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>control_origination</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+                <span class=n>allowed_co_values</span> <span class=o>=</span> <span class=p>{</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>ORIGINATION_ORGANIZATION</span><span class=p>,</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>ORIGINATION_SYSTEM_SPECIFIC</span><span class=p>,</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>ORIGINATION_INHERITED</span><span class=p>,</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>ORIGINATION_CUSTOMER_CONFIGURED</span><span class=p>,</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>ORIGINATION_CUSTOMER_PROVIDED</span>
+                <span class=p>}</span>
+                <span class=n>allowed_co_string</span> <span class=o>=</span> <span class=s1>&#39;, &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>item</span><span class=p>)</span> <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>allowed_co_values</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>co</span> <span class=ow>in</span> <span class=n>co_values</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>co</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>allowed_co_values</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;Provided control origination &quot;</span><span class=si>{</span><span class=n>co</span><span class=si>}</span><span class=s1>&quot; is invalid.</span><span class=se>\n</span><span class=s1>&#39;</span>
+                            <span class=sa>f</span><span class=s1>&#39;Please use the following for ssp-filter: </span><span class=si>{</span><span class=n>allowed_co_string</span><span class=si>}</span><span class=s1>&#39;</span>
+                        <span class=p>)</span>
+                        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>filter_ssp</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>profile</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>regenerate</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>version</span><span class=p>,</span>
+                <span class=n>comp_names</span><span class=p>,</span>
+                <span class=n>impl_status_values</span><span class=p>,</span>
+                <span class=n>co_values</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error generating the filtered ssp&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>filter_ssp</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>ssp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>profile_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>out_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>implementation_status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>control_origination</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Filter the ssp and output new ssp.</span>
+
+<span class=sd>        The filtered ssp is based on controls included by the following:</span>
+<span class=sd>        profile, components, implementation status, and/or control origination.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: root directory of the trestle workspace</span>
+<span class=sd>            ssp_name: name of the ssp model</span>
+<span class=sd>            profile_name: name of the optional profile model used for filtering</span>
+<span class=sd>            out_name: name of the output ssp model with filtered controls</span>
+<span class=sd>            regenerate: whether to regenerate the uuid&#39;s in the ssp</span>
+<span class=sd>            version: new version for the model</span>
+<span class=sd>            components: optional list of component names used for filtering</span>
+<span class=sd>            implementation_status: optional list of implementation statuses for filtering</span>
+<span class=sd>            control_origination: optional list of control origination values for filtering</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            0 on success, 1 otherwise</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># load the ssp</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+        <span class=n>ssp</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>ssp_name</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=n>profile_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+        <span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>components</span><span class=p>:</span>
+            <span class=n>raw_comp_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>ControlReader</span><span class=o>.</span><span class=n>simplify_name</span><span class=p>(</span><span class=n>name</span><span class=p>)</span> <span class=k>for</span> <span class=n>name</span> <span class=ow>in</span> <span class=n>components</span><span class=p>]</span>
+            <span class=n>comp_uuids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>simplify_name</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=p>)</span> <span class=ow>in</span> <span class=n>raw_comp_names</span><span class=p>:</span>
+                    <span class=n>comp_uuids</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>uuid</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>comp_uuids</span><span class=p>)</span> <span class=o>!=</span> <span class=nb>len</span><span class=p>(</span><span class=n>components</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Unable to filter the ssp because one of the components </span><span class=si>{</span><span class=n>components</span><span class=si>}</span><span class=s1> is not in the ssp.&#39;</span>
+                <span class=p>)</span>
+
+            <span class=c1># imp_reqs can be by comp</span>
+            <span class=c1># and imp_reqs can have statements that are by comp</span>
+            <span class=k>if</span> <span class=n>comp_uuids</span><span class=p>:</span>
+                <span class=n>new_imp_reqs</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=c1># these are all required to be present</span>
+                <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+                    <span class=n>new_by_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                    <span class=c1># by_comps is optional</span>
+                    <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                        <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=ow>in</span> <span class=n>comp_uuids</span><span class=p>:</span>
+                            <span class=n>new_by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+                    <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_by_comps</span><span class=p>)</span>
+                    <span class=n>new_imp_reqs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+                    <span class=n>new_statements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                    <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                        <span class=n>new_by_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                        <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                            <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=ow>in</span> <span class=n>comp_uuids</span><span class=p>:</span>
+                                <span class=n>new_by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+                        <span class=n>statement</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_by_comps</span><span class=p>)</span>
+                        <span class=n>new_statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+                    <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_statements</span><span class=p>)</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_reqs</span>
+                <span class=c1># now remove any unused components from the ssp</span>
+                <span class=n>new_comp_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>comp_</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>comp_</span><span class=o>.</span><span class=n>uuid</span> <span class=ow>in</span> <span class=n>comp_uuids</span><span class=p>:</span>
+                        <span class=n>new_comp_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>comp_</span><span class=p>)</span>
+                <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span> <span class=o>=</span> <span class=n>new_comp_list</span>
+
+        <span class=c1># filter by controls in profile</span>
+        <span class=k>if</span> <span class=n>profile_name</span><span class=p>:</span>
+            <span class=n>prof_resolver</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span>
+            <span class=n>catalog</span> <span class=o>=</span> <span class=n>prof_resolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_path</span><span class=p>,</span> <span class=n>show_value_warnings</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+            <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>)</span>
+
+            <span class=c1># The input ssp should reference a superset of the controls referenced by the profile</span>
+            <span class=c1># Need to cull references in the ssp to controls not in the profile</span>
+            <span class=c1># Also make sure the output ssp contains imp reqs for all controls in the profile</span>
+            <span class=n>control_imp</span> <span class=o>=</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span>
+            <span class=n>ssp_control_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+
+            <span class=n>new_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                <span class=n>control</span> <span class=o>=</span> <span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_by_param_id</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>new_set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_param</span><span class=p>)</span>
+                    <span class=n>ssp_control_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=n>control_imp</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_set_params</span><span class=p>)</span>
+
+            <span class=n>new_imp_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>imp_requirement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+                <span class=n>control</span> <span class=o>=</span> <span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>imp_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>new_imp_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_requirement</span><span class=p>)</span>
+                    <span class=n>ssp_control_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_requirements</span>
+
+            <span class=c1># make sure all controls in the profile have implemented reqs in the final ssp</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>ssp_control_ids</span><span class=o>.</span><span class=n>issuperset</span><span class=p>(</span><span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_ids</span><span class=p>()):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unable to filter the ssp because the profile references controls not in it.&#39;</span><span class=p>)</span>
+
+            <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span> <span class=o>=</span> <span class=n>control_imp</span>
+
+        <span class=c1># filter implemented requirements and statements by component implementation status</span>
+        <span class=c1># this will remove any implemented requirements without statements or by_component fields set</span>
+        <span class=k>if</span> <span class=n>implementation_status</span><span class=p>:</span>
+            <span class=n>new_imp_reqs</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=c1># these are all required to be present</span>
+            <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+                <span class=n>new_by_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=c1># by_comps is optional</span>
+                <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span><span class=o>.</span><span class=n>state</span> <span class=ow>in</span> <span class=n>implementation_status</span><span class=p>:</span>
+                        <span class=n>new_by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_by_comps</span><span class=p>)</span>
+
+                <span class=n>new_statements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                    <span class=n>new_by_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                    <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                        <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span><span class=o>.</span><span class=n>state</span> <span class=ow>in</span> <span class=n>implementation_status</span><span class=p>:</span>
+                            <span class=n>new_by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+                    <span class=n>statement</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_by_comps</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>by_components</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=n>new_statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_statements</span><span class=p>)</span>
+
+                <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>or</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>new_imp_reqs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+
+            <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_reqs</span>
+
+        <span class=c1># filter implemented requirements by control origination property.</span>
+        <span class=c1># this will remove any implemented requirements without the control origination</span>
+        <span class=c1># property set</span>
+        <span class=k>if</span> <span class=n>control_origination</span><span class=p>:</span>
+            <span class=n>new_imp_reqs</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+            <span class=k>for</span> <span class=n>imp_requirement</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>imp_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>imp_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>CONTROL_ORIGINATION</span> <span class=ow>and</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=ow>in</span> <span class=n>control_origination</span><span class=p>:</span>
+                            <span class=n>new_imp_reqs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_requirement</span><span class=p>)</span>
+                            <span class=c1># only add the imp requirement one time</span>
+                            <span class=k>break</span>
+
+            <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_reqs</span>
+
+        <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+            <span class=n>ssp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+        <span class=n>existing_ssp_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span> <span class=n>out_name</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=n>existing_ssp_path</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>existing_ssp</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>out_name</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_ssp</span><span class=p>,</span> <span class=n>ssp</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;No changes to filtered ssp so ssp not written out.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>if</span> <span class=n>regenerate</span><span class=p>:</span>
+            <span class=n>ssp</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span>
+
+        <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span>
+
+        <span class=n>ModelUtils</span><span class=o>.</span><span class=n>save_top_level_model</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>out_name</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.ssp.SSPFilter-attributes>Attributes<a href=#trestle.core.commands.author.ssp.SSPFilter-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.ssp.SSPFilter.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ssp-filter&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.ssp.SSPFilter.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.author.ssp.SSPFilter-functions>Functions<a href=#trestle.core.commands.author.ssp.SSPFilter-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.ssp.SSPFilter.filter_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>filter_ssp</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>ssp_name</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>out_name</span><span class=p>,</span> <span class=n>regenerate</span><span class=p>,</span> <span class=n>version</span><span class=p>,</span> <span class=n>components</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>implementation_status</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>control_origination</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.commands.author.ssp.SSPFilter.filter_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Filter the ssp and output new ssp.</p> <p>The filtered ssp is based on controls included by the following: profile, components, implementation status, and/or control origination.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>root directory of the trestle workspace</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>ssp_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>name of the ssp model</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>profile_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>name of the optional profile model used for filtering</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>out_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>name of the output ssp model with filtered controls</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>regenerate</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>whether to regenerate the uuid's in the ssp</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>version</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>new version for the model</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>components</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>optional list of component names used for filtering</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>implementation_status</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>optional list of implementation statuses for filtering</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>control_origination</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>optional list of control origination values for filtering</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>0 on success, 1 otherwise</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>754</span>
+<span class=normal>755</span>
+<span class=normal>756</span>
+<span class=normal>757</span>
+<span class=normal>758</span>
+<span class=normal>759</span>
+<span class=normal>760</span>
+<span class=normal>761</span>
+<span class=normal>762</span>
+<span class=normal>763</span>
+<span class=normal>764</span>
+<span class=normal>765</span>
+<span class=normal>766</span>
+<span class=normal>767</span>
+<span class=normal>768</span>
+<span class=normal>769</span>
+<span class=normal>770</span>
+<span class=normal>771</span>
+<span class=normal>772</span>
+<span class=normal>773</span>
+<span class=normal>774</span>
+<span class=normal>775</span>
+<span class=normal>776</span>
+<span class=normal>777</span>
+<span class=normal>778</span>
+<span class=normal>779</span>
+<span class=normal>780</span>
+<span class=normal>781</span>
+<span class=normal>782</span>
+<span class=normal>783</span>
+<span class=normal>784</span>
+<span class=normal>785</span>
+<span class=normal>786</span>
+<span class=normal>787</span>
+<span class=normal>788</span>
+<span class=normal>789</span>
+<span class=normal>790</span>
+<span class=normal>791</span>
+<span class=normal>792</span>
+<span class=normal>793</span>
+<span class=normal>794</span>
+<span class=normal>795</span>
+<span class=normal>796</span>
+<span class=normal>797</span>
+<span class=normal>798</span>
+<span class=normal>799</span>
+<span class=normal>800</span>
+<span class=normal>801</span>
+<span class=normal>802</span>
+<span class=normal>803</span>
+<span class=normal>804</span>
+<span class=normal>805</span>
+<span class=normal>806</span>
+<span class=normal>807</span>
+<span class=normal>808</span>
+<span class=normal>809</span>
+<span class=normal>810</span>
+<span class=normal>811</span>
+<span class=normal>812</span>
+<span class=normal>813</span>
+<span class=normal>814</span>
+<span class=normal>815</span>
+<span class=normal>816</span>
+<span class=normal>817</span>
+<span class=normal>818</span>
+<span class=normal>819</span>
+<span class=normal>820</span>
+<span class=normal>821</span>
+<span class=normal>822</span>
+<span class=normal>823</span>
+<span class=normal>824</span>
+<span class=normal>825</span>
+<span class=normal>826</span>
+<span class=normal>827</span>
+<span class=normal>828</span>
+<span class=normal>829</span>
+<span class=normal>830</span>
+<span class=normal>831</span>
+<span class=normal>832</span>
+<span class=normal>833</span>
+<span class=normal>834</span>
+<span class=normal>835</span>
+<span class=normal>836</span>
+<span class=normal>837</span>
+<span class=normal>838</span>
+<span class=normal>839</span>
+<span class=normal>840</span>
+<span class=normal>841</span>
+<span class=normal>842</span>
+<span class=normal>843</span>
+<span class=normal>844</span>
+<span class=normal>845</span>
+<span class=normal>846</span>
+<span class=normal>847</span>
+<span class=normal>848</span>
+<span class=normal>849</span>
+<span class=normal>850</span>
+<span class=normal>851</span>
+<span class=normal>852</span>
+<span class=normal>853</span>
+<span class=normal>854</span>
+<span class=normal>855</span>
+<span class=normal>856</span>
+<span class=normal>857</span>
+<span class=normal>858</span>
+<span class=normal>859</span>
+<span class=normal>860</span>
+<span class=normal>861</span>
+<span class=normal>862</span>
+<span class=normal>863</span>
+<span class=normal>864</span>
+<span class=normal>865</span>
+<span class=normal>866</span>
+<span class=normal>867</span>
+<span class=normal>868</span>
+<span class=normal>869</span>
+<span class=normal>870</span>
+<span class=normal>871</span>
+<span class=normal>872</span>
+<span class=normal>873</span>
+<span class=normal>874</span>
+<span class=normal>875</span>
+<span class=normal>876</span>
+<span class=normal>877</span>
+<span class=normal>878</span>
+<span class=normal>879</span>
+<span class=normal>880</span>
+<span class=normal>881</span>
+<span class=normal>882</span>
+<span class=normal>883</span>
+<span class=normal>884</span>
+<span class=normal>885</span>
+<span class=normal>886</span>
+<span class=normal>887</span>
+<span class=normal>888</span>
+<span class=normal>889</span>
+<span class=normal>890</span>
+<span class=normal>891</span>
+<span class=normal>892</span>
+<span class=normal>893</span>
+<span class=normal>894</span>
+<span class=normal>895</span>
+<span class=normal>896</span>
+<span class=normal>897</span>
+<span class=normal>898</span>
+<span class=normal>899</span>
+<span class=normal>900</span>
+<span class=normal>901</span>
+<span class=normal>902</span>
+<span class=normal>903</span>
+<span class=normal>904</span>
+<span class=normal>905</span>
+<span class=normal>906</span>
+<span class=normal>907</span>
+<span class=normal>908</span>
+<span class=normal>909</span>
+<span class=normal>910</span>
+<span class=normal>911</span>
+<span class=normal>912</span>
+<span class=normal>913</span>
+<span class=normal>914</span>
+<span class=normal>915</span>
+<span class=normal>916</span>
+<span class=normal>917</span>
+<span class=normal>918</span>
+<span class=normal>919</span>
+<span class=normal>920</span>
+<span class=normal>921</span>
+<span class=normal>922</span>
+<span class=normal>923</span>
+<span class=normal>924</span>
+<span class=normal>925</span>
+<span class=normal>926</span>
+<span class=normal>927</span>
+<span class=normal>928</span>
+<span class=normal>929</span>
+<span class=normal>930</span>
+<span class=normal>931</span>
+<span class=normal>932</span>
+<span class=normal>933</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>filter_ssp</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>ssp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>profile_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>out_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>implementation_status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>control_origination</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Filter the ssp and output new ssp.</span>
+
+<span class=sd>    The filtered ssp is based on controls included by the following:</span>
+<span class=sd>    profile, components, implementation status, and/or control origination.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: root directory of the trestle workspace</span>
+<span class=sd>        ssp_name: name of the ssp model</span>
+<span class=sd>        profile_name: name of the optional profile model used for filtering</span>
+<span class=sd>        out_name: name of the output ssp model with filtered controls</span>
+<span class=sd>        regenerate: whether to regenerate the uuid&#39;s in the ssp</span>
+<span class=sd>        version: new version for the model</span>
+<span class=sd>        components: optional list of component names used for filtering</span>
+<span class=sd>        implementation_status: optional list of implementation statuses for filtering</span>
+<span class=sd>        control_origination: optional list of control origination values for filtering</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        0 on success, 1 otherwise</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># load the ssp</span>
+    <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+    <span class=n>ssp</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>ssp_name</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=n>profile_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+    <span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>components</span><span class=p>:</span>
+        <span class=n>raw_comp_names</span> <span class=o>=</span> <span class=p>[</span><span class=n>ControlReader</span><span class=o>.</span><span class=n>simplify_name</span><span class=p>(</span><span class=n>name</span><span class=p>)</span> <span class=k>for</span> <span class=n>name</span> <span class=ow>in</span> <span class=n>components</span><span class=p>]</span>
+        <span class=n>comp_uuids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>simplify_name</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=p>)</span> <span class=ow>in</span> <span class=n>raw_comp_names</span><span class=p>:</span>
+                <span class=n>comp_uuids</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>uuid</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>comp_uuids</span><span class=p>)</span> <span class=o>!=</span> <span class=nb>len</span><span class=p>(</span><span class=n>components</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Unable to filter the ssp because one of the components </span><span class=si>{</span><span class=n>components</span><span class=si>}</span><span class=s1> is not in the ssp.&#39;</span>
+            <span class=p>)</span>
+
+        <span class=c1># imp_reqs can be by comp</span>
+        <span class=c1># and imp_reqs can have statements that are by comp</span>
+        <span class=k>if</span> <span class=n>comp_uuids</span><span class=p>:</span>
+            <span class=n>new_imp_reqs</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=c1># these are all required to be present</span>
+            <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+                <span class=n>new_by_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=c1># by_comps is optional</span>
+                <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=ow>in</span> <span class=n>comp_uuids</span><span class=p>:</span>
+                        <span class=n>new_by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_by_comps</span><span class=p>)</span>
+                <span class=n>new_imp_reqs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+                <span class=n>new_statements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                    <span class=n>new_by_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                    <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                        <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=ow>in</span> <span class=n>comp_uuids</span><span class=p>:</span>
+                            <span class=n>new_by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+                    <span class=n>statement</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_by_comps</span><span class=p>)</span>
+                    <span class=n>new_statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_statements</span><span class=p>)</span>
+            <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_reqs</span>
+            <span class=c1># now remove any unused components from the ssp</span>
+            <span class=n>new_comp_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>comp_</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>comp_</span><span class=o>.</span><span class=n>uuid</span> <span class=ow>in</span> <span class=n>comp_uuids</span><span class=p>:</span>
+                    <span class=n>new_comp_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>comp_</span><span class=p>)</span>
+            <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span> <span class=o>=</span> <span class=n>new_comp_list</span>
+
+    <span class=c1># filter by controls in profile</span>
+    <span class=k>if</span> <span class=n>profile_name</span><span class=p>:</span>
+        <span class=n>prof_resolver</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=n>prof_resolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_path</span><span class=p>,</span> <span class=n>show_value_warnings</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>catalog</span><span class=p>)</span>
+
+        <span class=c1># The input ssp should reference a superset of the controls referenced by the profile</span>
+        <span class=c1># Need to cull references in the ssp to controls not in the profile</span>
+        <span class=c1># Also make sure the output ssp contains imp reqs for all controls in the profile</span>
+        <span class=n>control_imp</span> <span class=o>=</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span>
+        <span class=n>ssp_control_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+
+        <span class=n>new_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_by_param_id</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>new_set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_param</span><span class=p>)</span>
+                <span class=n>ssp_control_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=n>control_imp</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_set_params</span><span class=p>)</span>
+
+        <span class=n>new_imp_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>imp_requirement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>imp_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>new_imp_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_requirement</span><span class=p>)</span>
+                <span class=n>ssp_control_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_requirements</span>
+
+        <span class=c1># make sure all controls in the profile have implemented reqs in the final ssp</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>ssp_control_ids</span><span class=o>.</span><span class=n>issuperset</span><span class=p>(</span><span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_ids</span><span class=p>()):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unable to filter the ssp because the profile references controls not in it.&#39;</span><span class=p>)</span>
+
+        <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span> <span class=o>=</span> <span class=n>control_imp</span>
+
+    <span class=c1># filter implemented requirements and statements by component implementation status</span>
+    <span class=c1># this will remove any implemented requirements without statements or by_component fields set</span>
+    <span class=k>if</span> <span class=n>implementation_status</span><span class=p>:</span>
+        <span class=n>new_imp_reqs</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># these are all required to be present</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+            <span class=n>new_by_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=c1># by_comps is optional</span>
+            <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span><span class=o>.</span><span class=n>state</span> <span class=ow>in</span> <span class=n>implementation_status</span><span class=p>:</span>
+                    <span class=n>new_by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_by_comps</span><span class=p>)</span>
+
+            <span class=n>new_statements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=n>new_by_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span><span class=o>.</span><span class=n>state</span> <span class=ow>in</span> <span class=n>implementation_status</span><span class=p>:</span>
+                        <span class=n>new_by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+                <span class=n>statement</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_by_comps</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>by_components</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>new_statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_statements</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>or</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>new_imp_reqs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+
+        <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_reqs</span>
+
+    <span class=c1># filter implemented requirements by control origination property.</span>
+    <span class=c1># this will remove any implemented requirements without the control origination</span>
+    <span class=c1># property set</span>
+    <span class=k>if</span> <span class=n>control_origination</span><span class=p>:</span>
+        <span class=n>new_imp_reqs</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=k>for</span> <span class=n>imp_requirement</span> <span class=ow>in</span> <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>imp_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>imp_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>CONTROL_ORIGINATION</span> <span class=ow>and</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=ow>in</span> <span class=n>control_origination</span><span class=p>:</span>
+                        <span class=n>new_imp_reqs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_requirement</span><span class=p>)</span>
+                        <span class=c1># only add the imp requirement one time</span>
+                        <span class=k>break</span>
+
+        <span class=n>ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_reqs</span>
+
+    <span class=k>if</span> <span class=n>version</span><span class=p>:</span>
+        <span class=n>ssp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>version</span>
+
+    <span class=n>existing_ssp_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_model_path_for_name_and_class</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span> <span class=n>out_name</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+    <span class=p>)</span>
+    <span class=k>if</span> <span class=n>existing_ssp_path</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>existing_ssp</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>out_name</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>models_are_equivalent</span><span class=p>(</span><span class=n>existing_ssp</span><span class=p>,</span> <span class=n>ssp</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;No changes to filtered ssp so ssp not written out.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>if</span> <span class=n>regenerate</span><span class=p>:</span>
+        <span class=n>ssp</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span>
+
+    <span class=n>ModelUtils</span><span class=o>.</span><span class=n>update_last_modified</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span>
+
+    <span class=n>ModelUtils</span><span class=o>.</span><span class=n>save_top_level_model</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>out_name</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.ssp.SSPGenerate class="doc doc-heading"> <code>SSPGenerate</code> <a href=#trestle.core.commands.author.ssp.SSPGenerate class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.author.common.AuthorCommonCommand href=../common/#trestle.core.commands.author.common.AuthorCommonCommand>AuthorCommonCommand</a></code></p> <p>Generate SSP in markdown form from a Profile.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SSPGenerate</span><span class=p>(</span><span class=n>AuthorCommonCommand</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate SSP in markdown form from a Profile.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ssp-generate&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>file_help_str</span> <span class=o>=</span> <span class=s1>&#39;Main profile href, or name of the profile model in the trestle workspace&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-p&#39;</span><span class=p>,</span> <span class=s1>&#39;--profile&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>file_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of the output generated ssp markdown folder&#39;</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>  <span class=c1># noqa E501</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-cd&#39;</span><span class=p>,</span> <span class=s1>&#39;--compdefs&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_COMPDEFS</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+
+        <span class=n>ls_help_str</span> <span class=o>=</span> <span class=s1>&#39;Leveraged ssp with inheritable controls href or name in the trestle_workspace&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-ls&#39;</span><span class=p>,</span> <span class=s1>&#39;--leveraged-ssp&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>ls_help_str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-y&#39;</span><span class=p>,</span> <span class=s1>&#39;--yaml-header&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_YAML_PATH</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-fo&#39;</span><span class=p>,</span> <span class=s1>&#39;--force-overwrite&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_FO_OUTPUT</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-ohv&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--overwrite-header-values&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_OVERWRITE_HEADER_VALUES</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-iap&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--include-all-parts&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_INCLUDE_ALL_PARTS</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_directory_name_allowed</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1> is not an allowed directory name&#39;</span><span class=p>)</span>
+
+            <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=p>:</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>logging</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Loading yaml header file </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>()</span>
+                    <span class=n>yaml_header</span> <span class=o>=</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=p>)</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>))</span>
+                <span class=k>except</span> <span class=n>YAMLError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;YAML error loading yaml header </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>yaml_header</span><span class=si>}</span><span class=s1> for ssp generation: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>compdef_name_list</span> <span class=o>=</span> <span class=n>comma_sep_to_list</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>compdefs</span><span class=p>)</span>
+
+            <span class=n>md_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_generate_ssp_markdown</span><span class=p>(</span>
+                <span class=n>trestle_root</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>profile</span><span class=p>,</span>
+                <span class=n>compdef_name_list</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>leveraged_ssp</span><span class=p>,</span>
+                <span class=n>md_path</span><span class=p>,</span>
+                <span class=n>yaml_header</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>force_overwrite</span><span class=p>,</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>include_all_parts</span>
+            <span class=p>)</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while writing markdown from catalog&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_generate_ssp_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>profile_name_or_href</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>compdef_name_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>leveraged_ssp_name_or_href</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>force_overwrite</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>include_all_parts</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Generate the ssp markdown from the profile and compdefs.</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>        Get RPC from profile.</span>
+<span class=sd>        For each compdef:</span>
+<span class=sd>            For each comp:</span>
+<span class=sd>                Load top level rules</span>
+<span class=sd>                for each control_imp:</span>
+<span class=sd>                    Load rules params values</span>
+<span class=sd>                    For each imp_req (bound to 1 control):</span>
+<span class=sd>                        Load control level rules and status</span>
+<span class=sd>                        Load part level rules</span>
+<span class=sd>                        If rules apply then write out control and add to list written out</span>
+<span class=sd>                        If control exists, read it and insert content</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>force_overwrite</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Overwriting the content in </span><span class=si>{</span><span class=n>md_path</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+                <span class=n>clear_folder</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>md_path</span><span class=p>))</span>
+            <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to overwrite contents of </span><span class=si>{</span><span class=n>md_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>context</span> <span class=o>=</span> <span class=n>ControlContext</span><span class=o>.</span><span class=n>generate</span><span class=p>(</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_path</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span> <span class=o>=</span> <span class=n>yaml_header</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>prompt_responses</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>overwrite_header_values</span> <span class=o>=</span> <span class=n>overwrite_header_values</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>allowed_sections</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>comp_def_name_list</span> <span class=o>=</span> <span class=n>compdef_name_list</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>include_all_parts</span> <span class=o>=</span> <span class=n>include_all_parts</span>
+
+        <span class=c1># if file not recognized as URI form, assume it represents name of file in trestle directory</span>
+        <span class=n>profile_in_trestle_dir</span> <span class=o>=</span> <span class=s1>&#39;://&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>profile_name_or_href</span>
+        <span class=n>profile_href</span> <span class=o>=</span> <span class=n>profile_name_or_href</span>
+        <span class=k>if</span> <span class=n>profile_in_trestle_dir</span><span class=p>:</span>
+            <span class=n>local_path</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;profiles/</span><span class=si>{</span><span class=n>profile_name_or_href</span><span class=si>}</span><span class=s1>/profile.json&#39;</span>
+            <span class=n>profile_href</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span> <span class=o>+</span> <span class=n>local_path</span>
+            <span class=n>profile_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>local_path</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>profile</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>profile_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>fetcher</span> <span class=o>=</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_fetcher</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_href</span><span class=p>)</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>profile</span> <span class=o>=</span> <span class=n>fetcher</span><span class=o>.</span><span class=n>get_oscal</span><span class=p>()</span>
+            <span class=n>profile_path</span> <span class=o>=</span> <span class=n>profile_href</span>
+
+        <span class=n>profile_resolver</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span>
+        <span class=c1># in ssp context we want to see missing value warnings</span>
+        <span class=n>resolved_catalog</span> <span class=o>=</span> <span class=n>profile_resolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>profile_path</span><span class=p>,</span>
+            <span class=n>block_params</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=n>params_format</span><span class=o>=</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span>
+            <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>ASSIGNMENT_FORM</span><span class=p>,</span>
+            <span class=n>show_value_warnings</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+
+        <span class=n>catalog_api</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>resolved_catalog</span><span class=p>,</span> <span class=n>context</span><span class=o>=</span><span class=n>context</span><span class=p>)</span>
+
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>profile_header</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;title&#39;</span><span class=p>:</span> <span class=n>context</span><span class=o>.</span><span class=n>profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=p>,</span> <span class=s1>&#39;href&#39;</span><span class=p>:</span> <span class=n>profile_href</span><span class=p>}</span>
+
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>][</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>]</span> <span class=o>=</span> <span class=n>profile_header</span>
+
+        <span class=n>catalog_api</span><span class=o>.</span><span class=n>write_catalog_as_markdown</span><span class=p>()</span>
+
+        <span class=c1># Generate inheritance view after controls view completes</span>
+        <span class=k>if</span> <span class=n>leveraged_ssp_name_or_href</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_generate_inheritance_markdown</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>leveraged_ssp_name_or_href</span><span class=p>,</span> <span class=n>resolved_catalog</span><span class=p>,</span> <span class=n>md_path</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_generate_inheritance_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>leveraged_ssp_name_or_href</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>resolved_catalog</span><span class=p>:</span> <span class=n>CatalogInterface</span><span class=p>,</span>
+        <span class=n>md_path</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Generate markdown for inheritance view.</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            This will create the inheritance view markdown files in the same directory as the ssp markdown files.</span>
+<span class=sd>            The information will be from the leveraged ssp, but filtered by the chosen profile to ensure only relevant</span>
+<span class=sd>            controls are present for mapping.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># if file not recognized as URI form, assume it represents name of file in trestle directory</span>
+        <span class=n>ssp_in_trestle_dir</span> <span class=o>=</span> <span class=s1>&#39;://&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>leveraged_ssp_name_or_href</span>
+        <span class=n>ssp_href</span> <span class=o>=</span> <span class=n>leveraged_ssp_name_or_href</span>
+        <span class=k>if</span> <span class=n>ssp_in_trestle_dir</span><span class=p>:</span>
+            <span class=n>local_path</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>MODEL_DIR_SSP</span><span class=si>}</span><span class=s1>/</span><span class=si>{</span><span class=n>leveraged_ssp_name_or_href</span><span class=si>}</span><span class=s1>/system-security-plan.json&#39;</span>
+            <span class=n>ssp_href</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span> <span class=o>+</span> <span class=n>local_path</span>
+
+        <span class=n>inheritance_view_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>md_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>INHERITANCE_VIEW_DIR</span><span class=p>)</span>
+        <span class=n>inheritance_view_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Creating content for inheritance view in </span><span class=si>{</span><span class=n>inheritance_view_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>ssp_inheritance_api</span> <span class=o>=</span> <span class=n>SSPInheritanceAPI</span><span class=p>(</span><span class=n>inheritance_view_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+
+        <span class=c1># Filter the ssp implemented requirements by the catalog specified</span>
+        <span class=n>catalog_api</span><span class=p>:</span> <span class=n>CatalogAPI</span> <span class=o>=</span> <span class=n>CatalogAPI</span><span class=p>(</span><span class=n>catalog</span><span class=o>=</span><span class=n>resolved_catalog</span><span class=p>)</span>
+        <span class=n>ssp_inheritance_api</span><span class=o>.</span><span class=n>write_inheritance_as_markdown</span><span class=p>(</span><span class=n>ssp_href</span><span class=p>,</span> <span class=n>catalog_api</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.ssp.SSPGenerate-attributes>Attributes<a href=#trestle.core.commands.author.ssp.SSPGenerate-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.author.ssp.SSPGenerate.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ssp-generate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.author.ssp.SSPGenerate.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.author.ssp-functions>Functions<a href=#trestle.core.commands.author.ssp-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/author/versioning/template_versioning/index.html b/latest/reference/API/trestle/core/commands/author/versioning/template_versioning/index.html
new file mode 100644
index 000000000..4fdfc05f1
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/author/versioning/template_versioning/index.html
@@ -0,0 +1,698 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.author.versioning.template_versioning module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/versioning/template_versioning/ rel=canonical><link href=../../ssp/ rel=prev><link href=../../../common/cmd_utils/ rel=next><link rel=icon href=../../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.author.versioning.template_versioning - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.author.versioning.template_versioning - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.author.versioning.template_versioning module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/versioning/template_versioning.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/versioning/template_versioning/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.author.versioning.template_versioning - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.author.versioning.template_versioning module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/author/versioning/template_versioning.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.author.versioning.template_versioning class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning class=md-nav__link> <span class=md-ellipsis> template_versioning </span> </a> <nav class=md-nav aria-label=template_versioning> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning class=md-nav__link> <span class=md-ellipsis> TemplateVersioning </span> </a> <nav class=md-nav aria-label=TemplateVersioning> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_all_versions_for_task class=md-nav__link> <span class=md-ellipsis> get_all_versions_for_task </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_latest_version_for_task class=md-nav__link> <span class=md-ellipsis> get_latest_version_for_task </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_versioned_template_dir class=md-nav__link> <span class=md-ellipsis> get_versioned_template_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.is_valid_version class=md-nav__link> <span class=md-ellipsis> is_valid_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.update_template_folder_structure class=md-nav__link> <span class=md-ellipsis> update_template_folder_structure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.write_versioned_template class=md-nav__link> <span class=md-ellipsis> write_versioned_template </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning class=md-nav__link> <span class=md-ellipsis> template_versioning </span> </a> <nav class=md-nav aria-label=template_versioning> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning class=md-nav__link> <span class=md-ellipsis> TemplateVersioning </span> </a> <nav class=md-nav aria-label=TemplateVersioning> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_all_versions_for_task class=md-nav__link> <span class=md-ellipsis> get_all_versions_for_task </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_latest_version_for_task class=md-nav__link> <span class=md-ellipsis> get_latest_version_for_task </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_versioned_template_dir class=md-nav__link> <span class=md-ellipsis> get_versioned_template_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.is_valid_version class=md-nav__link> <span class=md-ellipsis> is_valid_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.update_template_folder_structure class=md-nav__link> <span class=md-ellipsis> update_template_folder_structure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.write_versioned_template class=md-nav__link> <span class=md-ellipsis> write_versioned_template </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.author.versioning.template_versioning</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.author.versioning.template_versioning class="doc doc-heading"> <code>trestle.core.commands.author.versioning.template_versioning</code> <a href=#trestle.core.commands.author.versioning.template_versioning class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>A Template Versioning.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.author.versioning.template_versioning-attributes>Attributes<a href=#trestle.core.commands.author.versioning.template_versioning-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.author.versioning.template_versioning.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.author.versioning.template_versioning.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.author.versioning.template_versioning-classes>Classes<a href=#trestle.core.commands.author.versioning.template_versioning-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.author.versioning.template_versioning.TemplateVersioning class="doc doc-heading"> <code>TemplateVersioning</code> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Template versioning solution.</p> <ol> <li>Load template with a specified version.<ol> <li>Template version can be specified via -tv flag</li> <li>If no version specified the latest version will be used by default.</li> <li>Otherwise use the templates from the specified version.</li> </ol> </li> <li>Backward compatibility.<ol> <li>Version 0.0.1 will be reserved for the template versions prior to this change.</li> <li>If the old template path is detected (i.e. without the template version). then the filesystem will be updated to the new path with the version.</li> <li>Upon first run, old template versions prior to this change will be placed to the folder 0.0.1.</li> <li>If templates have no headers then 0.0.1 version will be used.</li> </ol> </li> <li>Versioning organization.<ol> <li>Template and instance version is added both: in the file system (via path) and in the headers or metadata.</li> </ol> </li> <li>Instance version validation.<ol> <li>Markdown:<ol> <li>When validating the instance the header will be used to validate the version.</li> </ol> </li> <li>Drawio:<ol> <li>When validating the instance the metadata will be used to validate the version.</li> </ol> </li> </ol> </li> </ol> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TemplateVersioning</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Template versioning solution.</span>
+
+<span class=sd>    1. Load template with a specified version.</span>
+<span class=sd>        1. Template version can be specified via -tv flag</span>
+<span class=sd>        2. If no version specified the latest version will be used by default.</span>
+<span class=sd>        3. Otherwise use the templates from the specified version.</span>
+<span class=sd>    2. Backward compatibility.</span>
+<span class=sd>        1. Version 0.0.1 will be reserved for the template versions prior to this change.</span>
+<span class=sd>        2. If the old template path is detected (i.e. without the template version).</span>
+<span class=sd>            then the filesystem will be updated to the new path with the version.</span>
+<span class=sd>        3. Upon first run, old template versions prior to this change will be placed to the folder 0.0.1.</span>
+<span class=sd>        4. If templates have no headers then 0.0.1 version will be used.</span>
+<span class=sd>    3. Versioning organization.</span>
+<span class=sd>        1. Template and instance version is added both: in the file system (via path) and in the headers or metadata.</span>
+<span class=sd>    4. Instance version validation.</span>
+<span class=sd>        1. Markdown:</span>
+<span class=sd>            1. When validating the instance the header will be used to validate the version.</span>
+<span class=sd>        2. Drawio:</span>
+<span class=sd>            1. When validating the instance the metadata will be used to validate the version.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>update_template_folder_structure</span><span class=p>(</span><span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Automatically detect whether the path is an old style and update it.</span>
+
+<span class=sd>        An old-style path is a path of the form:</span>
+<span class=sd>         root_folder/.trestle/author/{template_name}/{template_objects}</span>
+<span class=sd>        The new version path is a path of the form:</span>
+<span class=sd>         root_folder/.trestle/author/{template_name}/{version}/{template_objects}</span>
+<span class=sd>        By default all old-style templates will be updated to version 0.0.1</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>_check_if_exists_and_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>all_files_wo_version</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span>
+                <span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>is_file</span><span class=p>(),</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>task_path</span><span class=p>))</span>
+            <span class=p>)</span>
+
+            <span class=n>pattern</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>TEMPLATE_VERSION_REGEX</span><span class=p>)</span>
+            <span class=n>all_non_template_directories</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span>
+                <span class=nb>filter</span><span class=p>(</span>
+                    <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()</span> <span class=ow>and</span> <span class=n>pattern</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>,</span>
+                    <span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+                <span class=p>)</span>
+            <span class=p>)</span>
+
+            <span class=n>new_dir</span> <span class=o>=</span> <span class=n>Path</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1>/</span><span class=si>{</span><span class=n>START_TEMPLATE_VERSION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>new_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>all_files_wo_version</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;No templates outside of the version folders.&#39;</span><span class=p>)</span>
+                <span class=c1># if the base template folder is empty, delete it</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>new_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>()))</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                    <span class=n>new_dir</span><span class=o>.</span><span class=n>rmdir</span><span class=p>()</span>
+
+            <span class=k>for</span> <span class=n>f</span> <span class=ow>in</span> <span class=n>all_files_wo_version</span> <span class=o>+</span> <span class=n>all_non_template_directories</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>f</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                    <span class=n>shutil</span><span class=o>.</span><span class=n>copy</span><span class=p>(</span><span class=n>f</span><span class=p>,</span> <span class=n>new_dir</span><span class=p>)</span>
+                <span class=k>elif</span> <span class=n>f</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                    <span class=n>shutil</span><span class=o>.</span><span class=n>copytree</span><span class=p>(</span><span class=n>f</span><span class=p>,</span> <span class=n>new_dir</span> <span class=o>/</span> <span class=n>f</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+
+            <span class=k>for</span> <span class=n>p</span> <span class=ow>in</span> <span class=n>all_files_wo_version</span> <span class=o>+</span> <span class=n>all_non_template_directories</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>p</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                    <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=n>p</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>p</span><span class=o>.</span><span class=n>unlink</span><span class=p>()</span>
+
+        <span class=k>except</span> <span class=ne>OSError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while updating template folder: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unexpected error while updating template folder: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_versioned_template_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Path</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get a template folder of the specified version.</span>
+
+<span class=sd>        If no version is given, the latest version of template will be returned</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>_check_if_exists_and_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+        <span class=n>latest_path</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>if</span> <span class=n>version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>latest_path</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_latest_version_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>latest_path</span> <span class=o>=</span> <span class=n>Path</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1>/</span><span class=si>{</span><span class=n>version</span><span class=si>}</span><span class=s1>/&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>latest_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;The task: </span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1> with version: </span><span class=si>{</span><span class=n>version</span><span class=si>}</span><span class=s1> does not exists.&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>latest_path</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_latest_version_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Path</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get latest version of the template for the given task.&quot;&quot;&quot;</span>
+        <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>_check_if_exists_and_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+
+        <span class=n>all_versions</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_all_versions_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+        <span class=n>max_version</span> <span class=o>=</span> <span class=n>START_TEMPLATE_VERSION</span>
+
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>all_versions</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No template versions were found for task: </span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1>, defaulting to 0.0.1&#39;</span><span class=p>)</span>
+            <span class=n>max_version</span> <span class=o>=</span> <span class=n>START_TEMPLATE_VERSION</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>max_version</span> <span class=o>=</span> <span class=nb>max</span><span class=p>(</span><span class=n>all_versions</span><span class=p>)</span>
+
+        <span class=n>latest_path</span> <span class=o>=</span> <span class=n>Path</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1>/</span><span class=si>{</span><span class=n>max_version</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>latest_path</span><span class=p>,</span> <span class=n>max_version</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_all_versions_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all versions for the task.&quot;&quot;&quot;</span>
+        <span class=n>pattern</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>TEMPLATE_VERSION_REGEX</span><span class=p>)</span>
+        <span class=n>all_versions</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>max_version</span> <span class=o>=</span> <span class=n>START_TEMPLATE_VERSION</span>
+        <span class=k>for</span> <span class=n>p</span> <span class=ow>in</span> <span class=n>task_path</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>p</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()</span> <span class=ow>and</span> <span class=n>pattern</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>match</span> <span class=o>=</span> <span class=n>pattern</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span><span class=o>.</span><span class=n>string</span>
+                <span class=n>all_versions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>match</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>match</span> <span class=o>&gt;</span> <span class=n>max_version</span><span class=p>:</span>
+                    <span class=n>max_version</span> <span class=o>=</span> <span class=n>match</span>
+
+        <span class=k>return</span> <span class=n>all_versions</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>write_versioned_template</span><span class=p>(</span>
+        <span class=n>resource_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>target_file</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Write a template with the header or metadata of a specified version.</span>
+
+<span class=sd>        If no version was given the latest version for the task will be used.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            resource_name:  Template resource name</span>
+<span class=sd>            task_path: Task path</span>
+<span class=sd>            target_file: File path where template will be written</span>
+<span class=sd>            version: return a resource of a specific version</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            A dotted path of a versioned template, list of all available versions</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>_check_if_exists_and_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>templates_resource_path</span> <span class=o>=</span> <span class=n>TRESTLE_RESOURCES</span> <span class=o>+</span> <span class=s1>&#39;.templates&#39;</span>
+
+            <span class=n>ref</span> <span class=o>=</span> <span class=n>importlib_resources</span><span class=o>.</span><span class=n>files</span><span class=p>(</span><span class=n>templates_resource_path</span><span class=p>)</span> <span class=o>/</span> <span class=n>resource_name</span>
+            <span class=k>with</span> <span class=n>importlib_resources</span><span class=o>.</span><span class=n>as_file</span><span class=p>(</span><span class=n>ref</span><span class=p>)</span> <span class=k>as</span> <span class=n>generic_template</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>_</span><span class=p>,</span> <span class=n>version</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_latest_version_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+
+                <span class=c1># modify header/metadata in the template</span>
+                <span class=k>if</span> <span class=n>generic_template</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>MARKDOWN_FILE_EXT</span><span class=p>:</span>
+                    <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+                    <span class=n>header</span><span class=p>,</span> <span class=n>md_body</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>generic_template</span><span class=p>)</span>
+                    <span class=n>header</span><span class=p>[</span><span class=n>TEMPLATE_VERSION_HEADER</span><span class=p>]</span> <span class=o>=</span> <span class=n>version</span>
+                    <span class=n>md_api</span><span class=o>.</span><span class=n>write_markdown_with_header</span><span class=p>(</span><span class=n>target_file</span><span class=p>,</span> <span class=n>header</span><span class=p>,</span> <span class=n>md_body</span><span class=p>)</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Successfully written template markdown to </span><span class=si>{</span><span class=n>target_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>elif</span> <span class=n>generic_template</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>DRAWIO_FILE_EXT</span><span class=p>:</span>
+                    <span class=n>drawio</span> <span class=o>=</span> <span class=n>DrawIO</span><span class=p>(</span><span class=n>generic_template</span><span class=p>)</span>
+                    <span class=n>metadata</span> <span class=o>=</span> <span class=n>drawio</span><span class=o>.</span><span class=n>get_metadata</span><span class=p>()[</span><span class=mi>0</span><span class=p>]</span>
+                    <span class=n>metadata</span><span class=p>[</span><span class=n>TEMPLATE_VERSION_HEADER</span><span class=p>]</span> <span class=o>=</span> <span class=n>version</span>
+
+                    <span class=n>drawio</span><span class=o>.</span><span class=n>write_drawio_with_metadata</span><span class=p>(</span><span class=n>generic_template</span><span class=p>,</span> <span class=n>metadata</span><span class=p>,</span> <span class=mi>0</span><span class=p>,</span> <span class=n>target_file</span><span class=p>)</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Successfully written template drawio to </span><span class=si>{</span><span class=n>target_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unsupported template file extension </span><span class=si>{</span><span class=n>generic_template</span><span class=o>.</span><span class=n>suffix</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>OSError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while updating template folder: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>is_valid_version</span><span class=p>(</span><span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if the version format is correct.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>template_version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>  <span class=c1># we can have empty version</span>
+        <span class=k>if</span> <span class=n>template_version</span> <span class=o>==</span> <span class=s1>&#39;0.0.0&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=n>version_regex</span> <span class=o>=</span> <span class=sa>r</span><span class=s1>&#39;^[0-9]+\.[0-9]+\.[0-9]+$&#39;</span>
+        <span class=n>pattern</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>version_regex</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>pattern</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>template_version</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_check_if_exists_and_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>task_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Path: </span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1> does not exists.&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>task_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File </span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1> passed, however template directory is expected.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.author.versioning.template_versioning.TemplateVersioning-functions>Functions<a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_all_versions_for_task class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all_versions_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_all_versions_for_task class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get all versions for the task.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_all_versions_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get all versions for the task.&quot;&quot;&quot;</span>
+    <span class=n>pattern</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>TEMPLATE_VERSION_REGEX</span><span class=p>)</span>
+    <span class=n>all_versions</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>max_version</span> <span class=o>=</span> <span class=n>START_TEMPLATE_VERSION</span>
+    <span class=k>for</span> <span class=n>p</span> <span class=ow>in</span> <span class=n>task_path</span><span class=o>.</span><span class=n>iterdir</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>p</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()</span> <span class=ow>and</span> <span class=n>pattern</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>match</span> <span class=o>=</span> <span class=n>pattern</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span><span class=o>.</span><span class=n>string</span>
+            <span class=n>all_versions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>match</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>match</span> <span class=o>&gt;</span> <span class=n>max_version</span><span class=p>:</span>
+                <span class=n>max_version</span> <span class=o>=</span> <span class=n>match</span>
+
+    <span class=k>return</span> <span class=n>all_versions</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_latest_version_for_task class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_latest_version_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_latest_version_for_task class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get latest version of the template for the given task.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_latest_version_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Path</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get latest version of the template for the given task.&quot;&quot;&quot;</span>
+    <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>_check_if_exists_and_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+
+    <span class=n>all_versions</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_all_versions_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+    <span class=n>max_version</span> <span class=o>=</span> <span class=n>START_TEMPLATE_VERSION</span>
+
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>all_versions</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No template versions were found for task: </span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1>, defaulting to 0.0.1&#39;</span><span class=p>)</span>
+        <span class=n>max_version</span> <span class=o>=</span> <span class=n>START_TEMPLATE_VERSION</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>max_version</span> <span class=o>=</span> <span class=nb>max</span><span class=p>(</span><span class=n>all_versions</span><span class=p>)</span>
+
+    <span class=n>latest_path</span> <span class=o>=</span> <span class=n>Path</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1>/</span><span class=si>{</span><span class=n>max_version</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>latest_path</span><span class=p>,</span> <span class=n>max_version</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_versioned_template_dir class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_versioned_template_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>,</span> <span class=n>version</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_versioned_template_dir class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get a template folder of the specified version.</p> <p>If no version is given, the latest version of template will be returned</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_versioned_template_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get a template folder of the specified version.</span>
+
+<span class=sd>    If no version is given, the latest version of template will be returned</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>_check_if_exists_and_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+    <span class=n>latest_path</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>if</span> <span class=n>version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>latest_path</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_latest_version_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>latest_path</span> <span class=o>=</span> <span class=n>Path</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1>/</span><span class=si>{</span><span class=n>version</span><span class=si>}</span><span class=s1>/&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>latest_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;The task: </span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1> with version: </span><span class=si>{</span><span class=n>version</span><span class=si>}</span><span class=s1> does not exists.&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>latest_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.is_valid_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_valid_version</span><span class=p>(</span><span class=n>template_version</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.is_valid_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Check if the version format is correct.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>is_valid_version</span><span class=p>(</span><span class=n>template_version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check if the version format is correct.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>template_version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>True</span>  <span class=c1># we can have empty version</span>
+    <span class=k>if</span> <span class=n>template_version</span> <span class=o>==</span> <span class=s1>&#39;0.0.0&#39;</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=n>version_regex</span> <span class=o>=</span> <span class=sa>r</span><span class=s1>&#39;^[0-9]+\.[0-9]+\.[0-9]+$&#39;</span>
+    <span class=n>pattern</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>version_regex</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>pattern</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>template_version</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.update_template_folder_structure class="doc doc-heading"> <code class="highlight language-python"><span class=n>update_template_folder_structure</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.update_template_folder_structure class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Automatically detect whether the path is an old style and update it.</p> <details class=an-old-style-path-is-a-path-of-the-form open> <summary>An old-style path is a path of the form</summary> <p>root_folder/.trestle/author/{template_name}/{template_objects}</p> </details> <p>The new version path is a path of the form: root_folder/.trestle/author/{template_name}/{version}/{template_objects} By default all old-style templates will be updated to version 0.0.1</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>update_template_folder_structure</span><span class=p>(</span><span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Automatically detect whether the path is an old style and update it.</span>
+
+<span class=sd>    An old-style path is a path of the form:</span>
+<span class=sd>     root_folder/.trestle/author/{template_name}/{template_objects}</span>
+<span class=sd>    The new version path is a path of the form:</span>
+<span class=sd>     root_folder/.trestle/author/{template_name}/{version}/{template_objects}</span>
+<span class=sd>    By default all old-style templates will be updated to version 0.0.1</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>_check_if_exists_and_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>all_files_wo_version</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span>
+            <span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>is_file</span><span class=p>(),</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>task_path</span><span class=p>))</span>
+        <span class=p>)</span>
+
+        <span class=n>pattern</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>TEMPLATE_VERSION_REGEX</span><span class=p>)</span>
+        <span class=n>all_non_template_directories</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span>
+            <span class=nb>filter</span><span class=p>(</span>
+                <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>is_dir</span><span class=p>()</span> <span class=ow>and</span> <span class=n>pattern</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>,</span>
+                <span class=n>file_utils</span><span class=o>.</span><span class=n>iterdir_without_hidden_files</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+            <span class=p>)</span>
+        <span class=p>)</span>
+
+        <span class=n>new_dir</span> <span class=o>=</span> <span class=n>Path</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>task_path</span><span class=si>}</span><span class=s1>/</span><span class=si>{</span><span class=n>START_TEMPLATE_VERSION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>new_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>all_files_wo_version</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;No templates outside of the version folders.&#39;</span><span class=p>)</span>
+            <span class=c1># if the base template folder is empty, delete it</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>new_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>()))</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>new_dir</span><span class=o>.</span><span class=n>rmdir</span><span class=p>()</span>
+
+        <span class=k>for</span> <span class=n>f</span> <span class=ow>in</span> <span class=n>all_files_wo_version</span> <span class=o>+</span> <span class=n>all_non_template_directories</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>f</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                <span class=n>shutil</span><span class=o>.</span><span class=n>copy</span><span class=p>(</span><span class=n>f</span><span class=p>,</span> <span class=n>new_dir</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>f</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=n>shutil</span><span class=o>.</span><span class=n>copytree</span><span class=p>(</span><span class=n>f</span><span class=p>,</span> <span class=n>new_dir</span> <span class=o>/</span> <span class=n>f</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>p</span> <span class=ow>in</span> <span class=n>all_files_wo_version</span> <span class=o>+</span> <span class=n>all_non_template_directories</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>p</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=n>p</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>p</span><span class=o>.</span><span class=n>unlink</span><span class=p>()</span>
+
+    <span class=k>except</span> <span class=ne>OSError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while updating template folder: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unexpected error while updating template folder: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.write_versioned_template class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_versioned_template</span><span class=p>(</span><span class=n>resource_name</span><span class=p>,</span> <span class=n>task_path</span><span class=p>,</span> <span class=n>target_file</span><span class=p>,</span> <span class=n>version</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.write_versioned_template class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write a template with the header or metadata of a specified version.</p> <p>If no version was given the latest version for the task will be used.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>resource_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Template resource name</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>task_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Task path</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>target_file</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>File path where template will be written</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>version</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>return a resource of a specific version</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>None</code> </td> <td> <div class=doc-md-description> <p>A dotted path of a versioned template, list of all available versions</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>write_versioned_template</span><span class=p>(</span>
+    <span class=n>resource_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>task_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>target_file</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Write a template with the header or metadata of a specified version.</span>
+
+<span class=sd>    If no version was given the latest version for the task will be used.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        resource_name:  Template resource name</span>
+<span class=sd>        task_path: Task path</span>
+<span class=sd>        target_file: File path where template will be written</span>
+<span class=sd>        version: return a resource of a specific version</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        A dotted path of a versioned template, list of all available versions</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>_check_if_exists_and_dir</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>templates_resource_path</span> <span class=o>=</span> <span class=n>TRESTLE_RESOURCES</span> <span class=o>+</span> <span class=s1>&#39;.templates&#39;</span>
+
+        <span class=n>ref</span> <span class=o>=</span> <span class=n>importlib_resources</span><span class=o>.</span><span class=n>files</span><span class=p>(</span><span class=n>templates_resource_path</span><span class=p>)</span> <span class=o>/</span> <span class=n>resource_name</span>
+        <span class=k>with</span> <span class=n>importlib_resources</span><span class=o>.</span><span class=n>as_file</span><span class=p>(</span><span class=n>ref</span><span class=p>)</span> <span class=k>as</span> <span class=n>generic_template</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>_</span><span class=p>,</span> <span class=n>version</span> <span class=o>=</span> <span class=n>TemplateVersioning</span><span class=o>.</span><span class=n>get_latest_version_for_task</span><span class=p>(</span><span class=n>task_path</span><span class=p>)</span>
+
+            <span class=c1># modify header/metadata in the template</span>
+            <span class=k>if</span> <span class=n>generic_template</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>MARKDOWN_FILE_EXT</span><span class=p>:</span>
+                <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+                <span class=n>header</span><span class=p>,</span> <span class=n>md_body</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>generic_template</span><span class=p>)</span>
+                <span class=n>header</span><span class=p>[</span><span class=n>TEMPLATE_VERSION_HEADER</span><span class=p>]</span> <span class=o>=</span> <span class=n>version</span>
+                <span class=n>md_api</span><span class=o>.</span><span class=n>write_markdown_with_header</span><span class=p>(</span><span class=n>target_file</span><span class=p>,</span> <span class=n>header</span><span class=p>,</span> <span class=n>md_body</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Successfully written template markdown to </span><span class=si>{</span><span class=n>target_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>generic_template</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=n>DRAWIO_FILE_EXT</span><span class=p>:</span>
+                <span class=n>drawio</span> <span class=o>=</span> <span class=n>DrawIO</span><span class=p>(</span><span class=n>generic_template</span><span class=p>)</span>
+                <span class=n>metadata</span> <span class=o>=</span> <span class=n>drawio</span><span class=o>.</span><span class=n>get_metadata</span><span class=p>()[</span><span class=mi>0</span><span class=p>]</span>
+                <span class=n>metadata</span><span class=p>[</span><span class=n>TEMPLATE_VERSION_HEADER</span><span class=p>]</span> <span class=o>=</span> <span class=n>version</span>
+
+                <span class=n>drawio</span><span class=o>.</span><span class=n>write_drawio_with_metadata</span><span class=p>(</span><span class=n>generic_template</span><span class=p>,</span> <span class=n>metadata</span><span class=p>,</span> <span class=mi>0</span><span class=p>,</span> <span class=n>target_file</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Successfully written template drawio to </span><span class=si>{</span><span class=n>target_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unsupported template file extension </span><span class=si>{</span><span class=n>generic_template</span><span class=o>.</span><span class=n>suffix</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>OSError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while updating template folder: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/command_docs/index.html b/latest/reference/API/trestle/core/commands/command_docs/index.html
new file mode 100644
index 000000000..cc179c306
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/command_docs/index.html
@@ -0,0 +1,92 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.command_docs module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/command_docs/ rel=canonical><link href=../assemble/ rel=prev><link href=../create/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.command_docs - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.command_docs - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.command_docs module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/command_docs.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/command_docs/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.command_docs - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.command_docs module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/command_docs.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.command_docs class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.command_docs </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs class=md-nav__link> <span class=md-ellipsis> command_docs </span> </a> <nav class=md-nav aria-label=command_docs> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.CommandBase class=md-nav__link> <span class=md-ellipsis> CommandBase </span> </a> <nav class=md-nav aria-label=CommandBase> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.CommandBase-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.CommandBase.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.CommandPlusDocs class=md-nav__link> <span class=md-ellipsis> CommandPlusDocs </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs class=md-nav__link> <span class=md-ellipsis> command_docs </span> </a> <nav class=md-nav aria-label=command_docs> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.CommandBase class=md-nav__link> <span class=md-ellipsis> CommandBase </span> </a> <nav class=md-nav aria-label=CommandBase> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.CommandBase-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.CommandBase.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.command_docs.CommandPlusDocs class=md-nav__link> <span class=md-ellipsis> CommandPlusDocs </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.command_docs</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.command_docs class="doc doc-heading"> <code>trestle.core.commands.command_docs</code> <a href=#trestle.core.commands.command_docs class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle command abstraction.</p> <p>Improves parsing until such a point as ILCLI is fixed.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.command_docs-attributes>Attributes<a href=#trestle.core.commands.command_docs-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.command_docs.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.command_docs.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.command_docs-classes>Classes<a href=#trestle.core.commands.command_docs-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.command_docs.CommandBase class="doc doc-heading"> <code>CommandBase</code> <a href=#trestle.core.commands.command_docs.CommandBase class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=ilcli.Command>Command</span></code></p> <p>Linear extension to the ILCLI interface to use documentation string more.</p> <p>Trestle commands not requiring trestle-root should extend from this class.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/command_docs.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CommandBase</span><span class=p>(</span><span class=n>Command</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Linear extension to the ILCLI interface to use documentation string more.</span>
+
+<span class=sd>    Trestle commands not requiring trestle-root should extend from this class.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=c1># Example commands extedning from this class - init&#39;, &#39;trestle&#39;, &#39;version&#39;, &#39;partial-object-validate&#39;</span>
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>parser</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>argparse</span><span class=o>.</span><span class=n>ArgumentParser</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>parent</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Command</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>out</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TextIO</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>err</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TextIO</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Override default ILCLI behaviour to include class documentation in command help description.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>(</span><span class=n>CommandBase</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>parser</span><span class=p>,</span> <span class=n>parent</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>out</span><span class=p>,</span> <span class=n>err</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>parser</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__doc__</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.command_docs.CommandBase-functions>Functions<a href=#trestle.core.commands.command_docs.CommandBase-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.command_docs.CommandBase.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>parser</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>parent</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>out</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>err</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.commands.command_docs.CommandBase.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Override default ILCLI behaviour to include class documentation in command help description.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/command_docs.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>parser</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>argparse</span><span class=o>.</span><span class=n>ArgumentParser</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>parent</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Command</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>out</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TextIO</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>err</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TextIO</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Override default ILCLI behaviour to include class documentation in command help description.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>(</span><span class=n>CommandBase</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>parser</span><span class=p>,</span> <span class=n>parent</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>out</span><span class=p>,</span> <span class=n>err</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>parser</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__doc__</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.command_docs.CommandPlusDocs class="doc doc-heading"> <code>CommandPlusDocs</code> <a href=#trestle.core.commands.command_docs.CommandPlusDocs class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandBase href=#trestle.core.commands.command_docs.CommandBase>CommandBase</a></code></p> <p>This class validates trestle-root argument.</p> <p>Trestle commands requiring trestle-root should extend from this class. All commands that extend this class will validate the state of trestle workspace.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/command_docs.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CommandPlusDocs</span><span class=p>(</span><span class=n>CommandBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;This class validates trestle-root argument.</span>
+
+<span class=sd>    Trestle commands requiring trestle-root should extend from this class.</span>
+<span class=sd>    All commands that extend this class will validate the state of trestle workspace.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>_validate_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>ArgumentParser</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check trestle-root argument is a valid trestle root directory.&quot;&quot;&quot;</span>
+        <span class=n>root</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=k>if</span> <span class=n>root</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=si>}</span><span class=s1> is not in a valid trestle root directory&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>TRESTLE_ROOT_ERROR</span><span class=o>.</span><span class=n>value</span>
+        <span class=n>is_oscal_dir_valid</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>check_oscal_directories</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>is_oscal_dir_valid</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>TRESTLE_ROOT_ERROR</span><span class=o>.</span><span class=n>value</span>
+        <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span> <span class=o>=</span> <span class=n>root</span>  <span class=c1># type: ignore</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/common/cmd_utils/index.html b/latest/reference/API/trestle/core/commands/common/cmd_utils/index.html
new file mode 100644
index 000000000..0c9e9f775
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/common/cmd_utils/index.html
@@ -0,0 +1,386 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.common.cmd_utils module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/common/cmd_utils/ rel=canonical><link href=../../author/versioning/template_versioning/ rel=prev><link href=../return_codes/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.common.cmd_utils - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.common.cmd_utils - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.common.cmd_utils module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/common/cmd_utils.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/common/cmd_utils/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.common.cmd_utils - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.common.cmd_utils module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/common/cmd_utils.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.common.cmd_utils class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils class=md-nav__link> <span class=md-ellipsis> cmd_utils </span> </a> <nav class=md-nav aria-label=cmd_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.clear_folder class=md-nav__link> <span class=md-ellipsis> clear_folder </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.model_type_is_too_granular class=md-nav__link> <span class=md-ellipsis> model_type_is_too_granular </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.parse_chain class=md-nav__link> <span class=md-ellipsis> parse_chain </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.parse_element_arg class=md-nav__link> <span class=md-ellipsis> parse_element_arg </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.parse_element_args class=md-nav__link> <span class=md-ellipsis> parse_element_args </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.split_is_too_fine class=md-nav__link> <span class=md-ellipsis> split_is_too_fine </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.to_model_file_name class=md-nav__link> <span class=md-ellipsis> to_model_file_name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils class=md-nav__link> <span class=md-ellipsis> cmd_utils </span> </a> <nav class=md-nav aria-label=cmd_utils> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.clear_folder class=md-nav__link> <span class=md-ellipsis> clear_folder </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.model_type_is_too_granular class=md-nav__link> <span class=md-ellipsis> model_type_is_too_granular </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.parse_chain class=md-nav__link> <span class=md-ellipsis> parse_chain </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.parse_element_arg class=md-nav__link> <span class=md-ellipsis> parse_element_arg </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.parse_element_args class=md-nav__link> <span class=md-ellipsis> parse_element_args </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.split_is_too_fine class=md-nav__link> <span class=md-ellipsis> split_is_too_fine </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.cmd_utils.to_model_file_name class=md-nav__link> <span class=md-ellipsis> to_model_file_name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.common.cmd_utils</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.common.cmd_utils class="doc doc-heading"> <code>trestle.core.commands.common.cmd_utils</code> <a href=#trestle.core.commands.common.cmd_utils class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle command related utilities.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.common.cmd_utils-classes>Classes<a href=#trestle.core.commands.common.cmd_utils-classes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.core.commands.common.cmd_utils-functions>Functions<a href=#trestle.core.commands.common.cmd_utils-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.core.commands.common.cmd_utils.clear_folder class="doc doc-heading"> <code class="highlight language-python"><span class=n>clear_folder</span><span class=p>(</span><span class=n>folder_path</span><span class=p>)</span></code> <a href=#trestle.core.commands.common.cmd_utils.clear_folder class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Clear all contents of the specified folder.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/common/cmd_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>clear_folder</span><span class=p>(</span><span class=n>folder_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Clear all contents of the specified folder.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>folder_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>folder_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+        <span class=k>return</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=n>folder_path</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>OSError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error deleting contents of </span><span class=si>{</span><span class=n>folder_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.commands.common.cmd_utils.model_type_is_too_granular class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_type_is_too_granular</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span></code> <a href=#trestle.core.commands.common.cmd_utils.model_type_is_too_granular class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Is an model_type too fine to split.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/common/cmd_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>model_type_is_too_granular</span><span class=p>(</span><span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Is an model_type too fine to split.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>type_utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>model_type</span><span class=p>,</span> <span class=s1>&#39;__fields__&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=n>model_type</span><span class=o>.</span><span class=n>__fields__</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>if</span> <span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;str&#39;</span><span class=p>,</span> <span class=s1>&#39;ConstrainedStrValue&#39;</span><span class=p>,</span> <span class=s1>&#39;int&#39;</span><span class=p>,</span> <span class=s1>&#39;float&#39;</span><span class=p>,</span> <span class=s1>&#39;datetime&#39;</span><span class=p>]:</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.commands.common.cmd_utils.parse_chain class="doc doc-heading"> <code class="highlight language-python"><span class=n>parse_chain</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=n>path_parts</span><span class=p>,</span> <span class=n>relative_path</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.commands.common.cmd_utils.parse_chain class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Parse the model chain starting from the beginning.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model_obj</code> </td> <td> <code><span title=typing.Union>Union</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../../base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>, None]</code> </td> <td> <div class=doc-md-description> <p>Model to use for inspecting available elements, if available or none</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>path_parts</code> </td> <td> <code><span title=typing.List>List</span>[str]</code> </td> <td> <div class=doc-md-description> <p>list of string paths to parse including wildcards</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>relative_path</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=pathlib.Path>Path</span>]</code> </td> <td> <div class=doc-md-description> <p>Optional relative path (w.r.t trestle workspace root directory)</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.List>List</span>[<a class="autorefs autorefs-internal" title=trestle.core.models.elements.ElementPath href=../../../models/elements/#trestle.core.models.elements.ElementPath>ElementPath</a>]</code> </td> <td> <div class=doc-md-description> <p>List of ElementPath</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/common/cmd_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>parse_chain</span><span class=p>(</span>
+    <span class=n>model_obj</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=kc>None</span><span class=p>],</span>
+    <span class=n>path_parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>relative_path</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Parse the model chain starting from the beginning.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        model_obj: Model to use for inspecting available elements, if available or none</span>
+<span class=sd>        path_parts: list of string paths to parse including wildcards</span>
+<span class=sd>        relative_path: Optional relative path (w.r.t trestle workspace root directory)</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        List of ElementPath</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>sub_model</span> <span class=o>=</span> <span class=n>model_obj</span>
+    <span class=n>have_model_to_parse</span> <span class=o>=</span> <span class=n>model_obj</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span>
+
+    <span class=n>prev_element_path</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>latest_path</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>parent_model</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+    <span class=n>i</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=k>while</span> <span class=n>i</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>):</span>
+        <span class=n>p</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+
+        <span class=c1># if hit wildcard create element path up to this point</span>
+        <span class=k>if</span> <span class=n>p</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=c1># append wildcard to the latest element path</span>
+            <span class=n>latest_path</span> <span class=o>=</span> <span class=n>element_paths</span><span class=o>.</span><span class=n>pop</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>latest_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid element path with consecutive </span><span class=si>{</span><span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>latest_path_str</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=n>latest_path</span><span class=o>.</span><span class=n>to_string</span><span class=p>(),</span> <span class=n>p</span><span class=p>])</span>
+            <span class=n>element_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>latest_path_str</span><span class=p>,</span> <span class=n>latest_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>())</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># create and append element_path</span>
+            <span class=c1># at this point sub_model may be a list of items</span>
+            <span class=c1># new element path is needed only if any of the items contains the desired part</span>
+            <span class=k>if</span> <span class=n>p</span> <span class=o>!=</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+                <span class=n>new_attrib</span> <span class=o>=</span> <span class=n>str_utils</span><span class=o>.</span><span class=n>dash_to_underscore</span><span class=p>(</span><span class=n>p</span><span class=p>)</span>
+                <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>sub_model</span><span class=p>,</span> <span class=nb>list</span><span class=p>):</span>
+                    <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>sub_model</span><span class=p>:</span>
+                        <span class=c1># go into the list and find one with requested part</span>
+                        <span class=n>sub_item</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>new_attrib</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                        <span class=k>if</span> <span class=n>sub_item</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                            <span class=n>sub_model</span> <span class=o>=</span> <span class=n>sub_item</span>
+                            <span class=k>break</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>sub_model</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>sub_model</span><span class=p>,</span> <span class=n>new_attrib</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>have_model_to_parse</span> <span class=ow>and</span> <span class=n>sub_model</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>element_paths</span>
+            <span class=n>p</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=n>parent_model</span><span class=p>,</span> <span class=n>p</span><span class=p>])</span>
+            <span class=n>element_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>p</span><span class=p>,</span> <span class=n>parent_path</span><span class=o>=</span><span class=n>prev_element_path</span><span class=p>)</span>
+
+        <span class=c1># If the path has wildcard and there are more parts later,</span>
+        <span class=c1># get the parent model for the alias path</span>
+        <span class=c1># If path has wildcard and it does not refer to a list, then there can be nothing after *</span>
+        <span class=k>if</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=n>full_path_str</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>element_path</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()[:</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+            <span class=n>parent_model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_singular_alias</span><span class=p>(</span><span class=n>full_path_str</span><span class=p>,</span> <span class=n>relative_path</span><span class=p>)</span>
+            <span class=c1># Does wildcard mean we need to inspect the sub_model to determine what can be split off from it?</span>
+            <span class=c1># If it has __root__ it may mean it contains a list of objects and should be split as a list</span>
+            <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>sub_model</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>):</span>
+                <span class=n>root</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>sub_model</span><span class=p>,</span> <span class=s1>&#39;__root__&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>root</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>or</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>root</span><span class=p>,</span> <span class=nb>list</span><span class=p>):</span>
+                    <span class=c1># Cannot have parts beyond * if it isn&#39;t a list</span>
+                    <span class=k>if</span> <span class=n>i</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>-</span> <span class=mi>1</span><span class=p>:</span>
+                        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;Cannot split beyond * when the wildcard does not refer to a list.  Path: </span><span class=si>{</span><span class=n>path_parts</span><span class=si>}</span><span class=s1>&#39;</span>
+                        <span class=p>)</span>
+                    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>sub_model</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                        <span class=c1># only create element path is item is present in the sub_model</span>
+                        <span class=k>if</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>sub_model</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                            <span class=k>continue</span>
+                        <span class=n>new_alias</span> <span class=o>=</span> <span class=n>str_utils</span><span class=o>.</span><span class=n>underscore_to_dash</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                        <span class=n>new_path</span> <span class=o>=</span> <span class=n>full_path_str</span> <span class=o>+</span> <span class=s1>&#39;.&#39;</span> <span class=o>+</span> <span class=n>new_alias</span>
+                        <span class=k>if</span> <span class=ow>not</span> <span class=n>split_is_too_fine</span><span class=p>(</span><span class=n>new_path</span><span class=p>,</span> <span class=n>model_obj</span><span class=p>):</span>
+                            <span class=c1># to add parts of an element, need to add two links</span>
+                            <span class=c1># prev_element_path may be None, for example catalog.*</span>
+                            <span class=k>if</span> <span class=n>prev_element_path</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                                <span class=n>element_paths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prev_element_path</span><span class=p>)</span>
+                            <span class=n>element_paths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ElementPath</span><span class=p>(</span><span class=n>parent_model</span> <span class=o>+</span> <span class=s1>&#39;.&#39;</span> <span class=o>+</span> <span class=n>new_alias</span><span class=p>,</span> <span class=n>latest_path</span><span class=p>))</span>
+                    <span class=c1># Since wildcard is last in the chain when splitting an oscal model we are done</span>
+                    <span class=k>return</span> <span class=n>element_paths</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>parent_model</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_element_name</span><span class=p>()</span>
+
+        <span class=c1># store values for next cycle</span>
+        <span class=n>prev_element_path</span> <span class=o>=</span> <span class=n>element_path</span>
+        <span class=n>element_paths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+        <span class=n>i</span> <span class=o>+=</span> <span class=mi>1</span>
+    <span class=k>return</span> <span class=n>element_paths</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.commands.common.cmd_utils.parse_element_arg class="doc doc-heading"> <code class="highlight language-python"><span class=n>parse_element_arg</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=n>element_arg</span><span class=p>,</span> <span class=n>relative_path</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.commands.common.cmd_utils.parse_element_arg class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Parse an element arg string into a list of ElementPath.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model_obj</code> </td> <td> <code><span title=typing.Union>Union</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../../base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>, None]</code> </td> <td> <div class=doc-md-description> <p>The OscalBaseModel being inspected to determine available elements that can be split</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>element_arg</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Single element path, as a string.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>relative_path</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=pathlib.Path>Path</span>]</code> </td> <td> <div class=doc-md-description> <p>Optional relative path (from trestle root) used to validate element args are valid.</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p>Returns: The requested parsed list of ElementPath for use in split</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/common/cmd_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>parse_element_arg</span><span class=p>(</span>
+    <span class=n>model_obj</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=kc>None</span><span class=p>],</span>
+    <span class=n>element_arg</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>relative_path</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Parse an element arg string into a list of ElementPath.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        model_obj: The OscalBaseModel being inspected to determine available elements that can be split</span>
+<span class=sd>        element_arg: Single element path, as a string.</span>
+<span class=sd>        relative_path: Optional relative path (from trestle root) used to validate element args are valid.</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        The requested parsed list of ElementPath for use in split</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>element_arg</span> <span class=o>=</span> <span class=n>element_arg</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+
+    <span class=k>if</span> <span class=n>element_arg</span> <span class=o>==</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Invalid element path containing only a single wildcard.&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>element_arg</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Invalid element path is empty string.&#39;</span><span class=p>)</span>
+
+    <span class=c1># search for wildcards and create paths with its parent path</span>
+    <span class=n>path_parts</span> <span class=o>=</span> <span class=n>element_arg</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=n>ElementPath</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=p>)</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>&lt;=</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid element path &quot;</span><span class=si>{</span><span class=n>element_arg</span><span class=si>}</span><span class=s1>&quot; with only one element and no wildcard&#39;</span><span class=p>)</span>
+
+    <span class=n>element_paths</span> <span class=o>=</span> <span class=n>parse_chain</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=n>path_parts</span><span class=p>,</span> <span class=n>relative_path</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>)</span> <span class=o>&lt;=</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=c1># don&#39;t complain if nothing to split</span>
+        <span class=k>pass</span>
+
+    <span class=k>return</span> <span class=n>element_paths</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.commands.common.cmd_utils.parse_element_args class="doc doc-heading"> <code class="highlight language-python"><span class=n>parse_element_args</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>element_args</span><span class=p>,</span> <span class=n>relative_path</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.commands.common.cmd_utils.parse_element_args class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Parse element args into a list of ElementPath.</p> <p>The element paths are either simple links of two elements, or two elements followed by *. The * represents either a list of the items in that element, or a splitting of that element into its parts. The only parts split off are the non-trivial ones determined by the granularity check.</p> <p>contextual_mode specifies if the path is a valid project model path or not. For example, if we are processing a metadata.parties.*, we need to know which metadata we are processing. If we pass contextual_mode=true, we can infer the root model by inspecting the file directory</p> <p>If contextual_mode=False, then the path must include the full path, e.g. catalog.metadata.parties.<em> instead of just metadata.parties.</em></p> <p>When the * represents splitting a model rather than a list, the model is inspected for what parts are available, and for each new part two element paths are created, one for the parent to the current element, and another from the current element to the child.</p> <p>A path may have multiple *'s, but only the final one can represent splitting a model.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model</code> </td> <td> <code><span title=typing.Union>Union</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../../base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>, None]</code> </td> <td> <div class=doc-md-description> <p>The OscalBaseModel being inspected to determine available elements that can be split</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>element_args</code> </td> <td> <code><span title=typing.List>List</span>[str]</code> </td> <td> <div class=doc-md-description> <p>List of str representing links in the chain of element paths to be parsed</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>relative_path</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=pathlib.Path>Path</span>]</code> </td> <td> <div class=doc-md-description> <p>Optional relative path (from trestle root) used to validate element args are valid.</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p>Returns: The requested parsed list of ElementPath for use in split</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/common/cmd_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span>
+<span class=normal>98</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>parse_element_args</span><span class=p>(</span>
+    <span class=n>model</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=kc>None</span><span class=p>],</span>
+    <span class=n>element_args</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>relative_path</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Parse element args into a list of ElementPath.</span>
+
+<span class=sd>    The element paths are either simple links of two elements, or two elements followed by *.</span>
+<span class=sd>    The * represents either a list of the items in that element, or a splitting of that element into its parts.</span>
+<span class=sd>    The only parts split off are the non-trivial ones determined by the granularity check.</span>
+
+<span class=sd>    contextual_mode specifies if the path is a valid project model path or not. For example,</span>
+<span class=sd>    if we are processing a metadata.parties.*, we need to know which metadata we are processing. If we pass</span>
+<span class=sd>    contextual_mode=true, we can infer the root model by inspecting the file directory</span>
+
+<span class=sd>    If contextual_mode=False, then the path must include the full path, e.g. catalog.metadata.parties.* instead of just</span>
+<span class=sd>    metadata.parties.*</span>
+
+<span class=sd>    When the * represents splitting a model rather than a list, the model is inspected for what parts are available,</span>
+<span class=sd>    and for each new part two element paths are created, one for the parent to the current element, and another from</span>
+<span class=sd>    the current element to the child.</span>
+
+<span class=sd>    A path may have multiple *&#39;s, but only the final one can represent splitting a model.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        model: The OscalBaseModel being inspected to determine available elements that can be split</span>
+<span class=sd>        element_args: List of str representing links in the chain of element paths to be parsed</span>
+<span class=sd>        relative_path: Optional relative path (from trestle root) used to validate element args are valid.</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        The requested parsed list of ElementPath for use in split</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># collect all paths</span>
+    <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>element_arg</span> <span class=ow>in</span> <span class=n>element_args</span><span class=p>:</span>
+        <span class=n>paths</span> <span class=o>=</span> <span class=n>parse_element_arg</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>element_arg</span><span class=p>,</span> <span class=n>relative_path</span><span class=p>)</span>
+        <span class=n>element_paths</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>paths</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>element_paths</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.commands.common.cmd_utils.split_is_too_fine class="doc doc-heading"> <code class="highlight language-python"><span class=n>split_is_too_fine</span><span class=p>(</span><span class=n>split_paths</span><span class=p>,</span> <span class=n>model_obj</span><span class=p>)</span></code> <a href=#trestle.core.commands.common.cmd_utils.split_is_too_fine class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Determine if the element path list goes too fine, e.g. individual strings.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/common/cmd_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>split_is_too_fine</span><span class=p>(</span><span class=n>split_paths</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>model_obj</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Determine if the element path list goes too fine, e.g. individual strings.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>split_path</span> <span class=ow>in</span> <span class=n>split_paths</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>):</span>
+        <span class=c1># find model type one level above if finishing with &#39;.*&#39;</span>
+        <span class=n>model_type</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>split_path</span><span class=o>.</span><span class=n>rstrip</span><span class=p>(</span><span class=s1>&#39;.*&#39;</span><span class=p>))</span><span class=o>.</span><span class=n>get_type</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>model_obj</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>model_type_is_too_granular</span><span class=p>(</span><span class=n>model_type</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.commands.common.cmd_utils.to_model_file_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_model_file_name</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=n>file_prefix</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span></code> <a href=#trestle.core.commands.common.cmd_utils.to_model_file_name class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Return the file name for the item.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/common/cmd_utils.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_model_file_name</span><span class=p>(</span><span class=n>model_obj</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>file_prefix</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the file name for the item.&quot;&quot;&quot;</span>
+    <span class=n>file_ext</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+    <span class=n>model_type</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>model_obj</span><span class=p>)</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=n>file_name</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>file_prefix</span><span class=si>}{</span><span class=n>const</span><span class=o>.</span><span class=n>IDX_SEP</span><span class=si>}{</span><span class=n>model_type</span><span class=si>}{</span><span class=n>file_ext</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=k>return</span> <span class=n>file_name</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/common/return_codes/index.html b/latest/reference/API/trestle/core/commands/common/return_codes/index.html
new file mode 100644
index 000000000..025287529
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/common/return_codes/index.html
@@ -0,0 +1,50 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.common.return_codes module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/common/return_codes/ rel=canonical><link href=../cmd_utils/ rel=prev><link href=../../../crm/bycomp_interface/ rel=next><link rel=icon href=../../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.common.return_codes - Compliance Trestle</title><link rel=stylesheet href=../../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.common.return_codes - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.common.return_codes module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/common/return_codes.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/common/return_codes/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.common.return_codes - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.common.return_codes module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/common/return_codes.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.common.return_codes class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18 checked> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes class=md-nav__link> <span class=md-ellipsis> return_codes </span> </a> <nav class=md-nav aria-label=return_codes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes class=md-nav__link> <span class=md-ellipsis> CmdReturnCodes </span> </a> <nav class=md-nav aria-label=CmdReturnCodes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.AUTH_ERROR class=md-nav__link> <span class=md-ellipsis> AUTH_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.COMMAND_ERROR class=md-nav__link> <span class=md-ellipsis> COMMAND_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.DOCUMENTS_VALIDATION_ERROR class=md-nav__link> <span class=md-ellipsis> DOCUMENTS_VALIDATION_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.INCORRECT_ARGS class=md-nav__link> <span class=md-ellipsis> INCORRECT_ARGS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.IO_ERROR class=md-nav__link> <span class=md-ellipsis> IO_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.OSCAL_VALIDATION_ERROR class=md-nav__link> <span class=md-ellipsis> OSCAL_VALIDATION_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.SUCCESS class=md-nav__link> <span class=md-ellipsis> SUCCESS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.TRESTLE_ROOT_ERROR class=md-nav__link> <span class=md-ellipsis> TRESTLE_ROOT_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.UNKNOWN_ERROR class=md-nav__link> <span class=md-ellipsis> UNKNOWN_ERROR </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes class=md-nav__link> <span class=md-ellipsis> return_codes </span> </a> <nav class=md-nav aria-label=return_codes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes class=md-nav__link> <span class=md-ellipsis> CmdReturnCodes </span> </a> <nav class=md-nav aria-label=CmdReturnCodes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.AUTH_ERROR class=md-nav__link> <span class=md-ellipsis> AUTH_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.COMMAND_ERROR class=md-nav__link> <span class=md-ellipsis> COMMAND_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.DOCUMENTS_VALIDATION_ERROR class=md-nav__link> <span class=md-ellipsis> DOCUMENTS_VALIDATION_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.INCORRECT_ARGS class=md-nav__link> <span class=md-ellipsis> INCORRECT_ARGS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.IO_ERROR class=md-nav__link> <span class=md-ellipsis> IO_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.OSCAL_VALIDATION_ERROR class=md-nav__link> <span class=md-ellipsis> OSCAL_VALIDATION_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.SUCCESS class=md-nav__link> <span class=md-ellipsis> SUCCESS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.TRESTLE_ROOT_ERROR class=md-nav__link> <span class=md-ellipsis> TRESTLE_ROOT_ERROR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.UNKNOWN_ERROR class=md-nav__link> <span class=md-ellipsis> UNKNOWN_ERROR </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.common.return_codes</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.common.return_codes class="doc doc-heading"> <code>trestle.core.commands.common.return_codes</code> <a href=#trestle.core.commands.common.return_codes class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle command return codes.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.common.return_codes-classes>Classes<a href=#trestle.core.commands.common.return_codes-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.common.return_codes.CmdReturnCodes class="doc doc-heading"> <code>CmdReturnCodes</code> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Trestle CLI return codes.</p> <p>SUCCESS - Operation/validation completed successfully COMMAND_ERROR - Generic expected error while executing command (handled by command) INCORRECT_ARGS - Provided arguments were incorrect/incomplete DOCUMENTS_VALIDATION_ERROR - Validation of the markdown or drawio files failed MODEL_VALIDATION_ERROR - Validation of OSCAL model failed TRESTLE_ROOT_ERROR - Workspace setup has failed, the root is not trestle directory IO_ERROR - IO related errors, i.e. permission issue, non-existing file, etc AUTH_ERROR - Authenication error while accessing/storing cache UNKNOWN_ERROR - Unexpected error (unhandled by command) INVALID_MODEL - Loaded model is invalid</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/common/return_codes.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>20</span>
+<span class=normal>21</span>
+<span class=normal>22</span>
+<span class=normal>23</span>
+<span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CmdReturnCodes</span><span class=p>(</span><span class=n>enum</span><span class=o>.</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Trestle CLI return codes.</span>
+
+<span class=sd>    SUCCESS - Operation/validation completed successfully</span>
+<span class=sd>    COMMAND_ERROR - Generic expected error while executing command (handled by command)</span>
+<span class=sd>    INCORRECT_ARGS - Provided arguments were incorrect/incomplete</span>
+<span class=sd>    DOCUMENTS_VALIDATION_ERROR - Validation of the markdown or drawio files failed</span>
+<span class=sd>    MODEL_VALIDATION_ERROR - Validation of OSCAL model failed</span>
+<span class=sd>    TRESTLE_ROOT_ERROR - Workspace setup has failed, the root is not trestle directory</span>
+<span class=sd>    IO_ERROR - IO related errors, i.e. permission issue, non-existing file, etc</span>
+<span class=sd>    AUTH_ERROR - Authenication error while accessing/storing cache</span>
+<span class=sd>    UNKNOWN_ERROR - Unexpected error (unhandled by command)</span>
+<span class=sd>    INVALID_MODEL - Loaded model is invalid</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>SUCCESS</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=n>COMMAND_ERROR</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=n>INCORRECT_ARGS</span> <span class=o>=</span> <span class=mi>2</span>
+    <span class=n>DOCUMENTS_VALIDATION_ERROR</span> <span class=o>=</span> <span class=mi>3</span>
+    <span class=n>OSCAL_VALIDATION_ERROR</span> <span class=o>=</span> <span class=mi>4</span>
+    <span class=n>TRESTLE_ROOT_ERROR</span> <span class=o>=</span> <span class=mi>5</span>
+    <span class=n>IO_ERROR</span> <span class=o>=</span> <span class=mi>6</span>
+    <span class=n>AUTH_ERROR</span> <span class=o>=</span> <span class=mi>7</span>
+    <span class=n>UNKNOWN_ERROR</span> <span class=o>=</span> <span class=mi>8</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.common.return_codes.CmdReturnCodes-attributes>Attributes<a href=#trestle.core.commands.common.return_codes.CmdReturnCodes-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.common.return_codes.CmdReturnCodes.AUTH_ERROR class="doc doc-heading"> <code class="highlight language-python"><span class=n>AUTH_ERROR</span> <span class=o>=</span> <span class=mi>7</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.AUTH_ERROR class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.common.return_codes.CmdReturnCodes.COMMAND_ERROR class="doc doc-heading"> <code class="highlight language-python"><span class=n>COMMAND_ERROR</span> <span class=o>=</span> <span class=mi>1</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.COMMAND_ERROR class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.common.return_codes.CmdReturnCodes.DOCUMENTS_VALIDATION_ERROR class="doc doc-heading"> <code class="highlight language-python"><span class=n>DOCUMENTS_VALIDATION_ERROR</span> <span class=o>=</span> <span class=mi>3</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.DOCUMENTS_VALIDATION_ERROR class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.common.return_codes.CmdReturnCodes.INCORRECT_ARGS class="doc doc-heading"> <code class="highlight language-python"><span class=n>INCORRECT_ARGS</span> <span class=o>=</span> <span class=mi>2</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.INCORRECT_ARGS class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.common.return_codes.CmdReturnCodes.IO_ERROR class="doc doc-heading"> <code class="highlight language-python"><span class=n>IO_ERROR</span> <span class=o>=</span> <span class=mi>6</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.IO_ERROR class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.common.return_codes.CmdReturnCodes.OSCAL_VALIDATION_ERROR class="doc doc-heading"> <code class="highlight language-python"><span class=n>OSCAL_VALIDATION_ERROR</span> <span class=o>=</span> <span class=mi>4</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.OSCAL_VALIDATION_ERROR class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.common.return_codes.CmdReturnCodes.SUCCESS class="doc doc-heading"> <code class="highlight language-python"><span class=n>SUCCESS</span> <span class=o>=</span> <span class=mi>0</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.SUCCESS class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.common.return_codes.CmdReturnCodes.TRESTLE_ROOT_ERROR class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE_ROOT_ERROR</span> <span class=o>=</span> <span class=mi>5</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.TRESTLE_ROOT_ERROR class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.common.return_codes.CmdReturnCodes.UNKNOWN_ERROR class="doc doc-heading"> <code class="highlight language-python"><span class=n>UNKNOWN_ERROR</span> <span class=o>=</span> <span class=mi>8</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.common.return_codes.CmdReturnCodes.UNKNOWN_ERROR class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/create/index.html b/latest/reference/API/trestle/core/commands/create/index.html
new file mode 100644
index 000000000..0ef0711c4
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/create/index.html
@@ -0,0 +1,239 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.create module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/create/ rel=canonical><link href=../command_docs/ rel=prev><link href=../describe/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.create - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.create - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.create module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/create.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/create/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.create - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.create module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/create.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.create class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.create </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.create </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.create </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.create class=md-nav__link> <span class=md-ellipsis> create </span> </a> <nav class=md-nav aria-label=create> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.create-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd class=md-nav__link> <span class=md-ellipsis> CreateCmd </span> </a> <nav class=md-nav aria-label=CreateCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd.create_object class=md-nav__link> <span class=md-ellipsis> create_object </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.create class=md-nav__link> <span class=md-ellipsis> create </span> </a> <nav class=md-nav aria-label=create> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.create-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd class=md-nav__link> <span class=md-ellipsis> CreateCmd </span> </a> <nav class=md-nav aria-label=CreateCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.create.CreateCmd.create_object class=md-nav__link> <span class=md-ellipsis> create_object </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.create</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.create class="doc doc-heading"> <code>trestle.core.commands.create</code> <a href=#trestle.core.commands.create class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Create CommandPlusDocs.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.create-attributes>Attributes<a href=#trestle.core.commands.create-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.create.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.create.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.create-classes>Classes<a href=#trestle.core.commands.create-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.create.CreateCmd class="doc doc-heading"> <code>CreateCmd</code> <a href=#trestle.core.commands.create.CreateCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Create a sample OSCAL model in trestle workspace or create new elements within a given model.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/create.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CreateCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create a sample OSCAL model in trestle workspace or create new elements within a given model.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;create&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-t&#39;</span><span class=p>,</span> <span class=s1>&#39;--type&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Type of model if created anew.&#39;</span><span class=p>,</span> <span class=n>choices</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of the output created model.&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>IOF_SHORT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>IOF_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>IOF_HELP</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-x&#39;</span><span class=p>,</span> <span class=s1>&#39;--extension&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Type of file output.&#39;</span><span class=p>,</span> <span class=n>choices</span><span class=o>=</span><span class=p>[</span><span class=s1>&#39;json&#39;</span><span class=p>,</span> <span class=s1>&#39;yaml&#39;</span><span class=p>,</span> <span class=s1>&#39;yml&#39;</span><span class=p>],</span> <span class=n>default</span><span class=o>=</span><span class=s1>&#39;json&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-f&#39;</span><span class=p>,</span> <span class=s1>&#39;--file&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Optional existing OSCAL file that will have elements created within it.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-e&#39;</span><span class=p>,</span> <span class=s1>&#39;--element&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Optional path of element to be created whithin the specified file.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Execute the create command.</span>
+
+<span class=sd>        Notes</span>
+<span class=sd>            Either a new model will be created of the specified type,</span>
+<span class=sd>            or an existing file will have new elements added within it.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=c1># Normal create path</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>type</span> <span class=ow>and</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=p>:</span>
+                <span class=n>object_type</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>)</span><span class=o>.</span><span class=n>get_type</span><span class=p>()</span>
+                <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>create_object</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>,</span> <span class=n>object_type</span><span class=p>,</span> <span class=n>args</span><span class=p>)</span>
+            <span class=c1># Add path</span>
+            <span class=k>elif</span> <span class=n>args</span><span class=o>.</span><span class=n>file</span> <span class=ow>and</span> <span class=n>args</span><span class=o>.</span><span class=n>element</span><span class=p>:</span>
+                <span class=n>add</span> <span class=o>=</span> <span class=n>Add</span><span class=p>()</span>
+                <span class=k>return</span> <span class=n>add</span><span class=o>.</span><span class=n>add_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleIncorrectArgsError</span><span class=p>(</span>
+                <span class=s1>&#39;Create requires either a model type and output name, or a file and element path.&#39;</span>
+            <span class=p>)</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>err</span><span class=o>.</span><span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while creating a sample OSCAL model&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>create_object</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>object_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>],</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create a top level OSCAL object within the trestle directory, leveraging functionality in add.&quot;&quot;&quot;</span>
+        <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>  <span class=c1># trestle root is set via command line in args. Default is cwd.</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>trestle_root</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleRootError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory </span><span class=si>{</span><span class=n>trestle_root</span><span class=si>}</span><span class=s1> is not a trestle project.&#39;</span><span class=p>)</span>
+
+        <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+        <span class=n>desired_model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span>
+
+        <span class=n>desired_model_path</span> <span class=o>=</span> <span class=n>desired_model_dir</span> <span class=o>/</span> <span class=p>(</span><span class=n>model_alias</span> <span class=o>+</span> <span class=s1>&#39;.&#39;</span> <span class=o>+</span> <span class=n>args</span><span class=o>.</span><span class=n>extension</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>desired_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;OSCAL file to be created here: </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1> exists.&#39;</span><span class=p>)</span>
+
+        <span class=c1># Create sample model.</span>
+        <span class=n>sample_model</span> <span class=o>=</span> <span class=n>generators</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>object_type</span><span class=p>,</span> <span class=n>include_optional</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>include_optional_fields</span><span class=p>)</span>
+        <span class=c1># Presuming top level level model not sure how to do the typing for this.</span>
+        <span class=n>sample_model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Generic </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> created by trestle named </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1>.&#39;</span>
+        <span class=n>sample_model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>last_modified</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span><span class=o>.</span><span class=n>astimezone</span><span class=p>()</span>
+        <span class=n>sample_model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>oscal_version</span> <span class=o>=</span> <span class=n>trestle</span><span class=o>.</span><span class=n>oscal</span><span class=o>.</span><span class=n>OSCAL_VERSION</span>
+        <span class=n>sample_model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=s1>&#39;0.0.0&#39;</span>
+
+        <span class=n>top_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>sample_model</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>)</span>
+
+        <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>desired_model_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>(),</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span>
+            <span class=n>desired_model_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>(),</span> <span class=n>top_element</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>desired_model_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+        <span class=p>)</span>
+
+        <span class=c1># create a plan to write the directory and file.</span>
+        <span class=n>create_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=n>create_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+        <span class=n>create_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+        <span class=n>create_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.create.CreateCmd-attributes>Attributes<a href=#trestle.core.commands.create.CreateCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.create.CreateCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;create&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.create.CreateCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.create.CreateCmd-functions>Functions<a href=#trestle.core.commands.create.CreateCmd-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.create.CreateCmd.create_object class="doc doc-heading"> <code class="highlight language-python"><span class=n>create_object</span><span class=p>(</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>object_type</span><span class=p>,</span> <span class=n>args</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.create.CreateCmd.create_object class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create a top level OSCAL object within the trestle directory, leveraging functionality in add.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/create.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>create_object</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>object_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>TopLevelOscalModel</span><span class=p>],</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create a top level OSCAL object within the trestle directory, leveraging functionality in add.&quot;&quot;&quot;</span>
+    <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+    <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>  <span class=c1># trestle root is set via command line in args. Default is cwd.</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>trestle_root</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleRootError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory </span><span class=si>{</span><span class=n>trestle_root</span><span class=si>}</span><span class=s1> is not a trestle project.&#39;</span><span class=p>)</span>
+
+    <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+    <span class=n>desired_model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span>
+
+    <span class=n>desired_model_path</span> <span class=o>=</span> <span class=n>desired_model_dir</span> <span class=o>/</span> <span class=p>(</span><span class=n>model_alias</span> <span class=o>+</span> <span class=s1>&#39;.&#39;</span> <span class=o>+</span> <span class=n>args</span><span class=o>.</span><span class=n>extension</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>desired_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;OSCAL file to be created here: </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1> exists.&#39;</span><span class=p>)</span>
+
+    <span class=c1># Create sample model.</span>
+    <span class=n>sample_model</span> <span class=o>=</span> <span class=n>generators</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>object_type</span><span class=p>,</span> <span class=n>include_optional</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>include_optional_fields</span><span class=p>)</span>
+    <span class=c1># Presuming top level level model not sure how to do the typing for this.</span>
+    <span class=n>sample_model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Generic </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> created by trestle named </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>output</span><span class=si>}</span><span class=s1>.&#39;</span>
+    <span class=n>sample_model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>last_modified</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span><span class=o>.</span><span class=n>astimezone</span><span class=p>()</span>
+    <span class=n>sample_model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>oscal_version</span> <span class=o>=</span> <span class=n>trestle</span><span class=o>.</span><span class=n>oscal</span><span class=o>.</span><span class=n>OSCAL_VERSION</span>
+    <span class=n>sample_model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=s1>&#39;0.0.0&#39;</span>
+
+    <span class=n>top_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>sample_model</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>)</span>
+
+    <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>desired_model_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>(),</span> <span class=kc>True</span><span class=p>)</span>
+    <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span>
+        <span class=n>desired_model_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>(),</span> <span class=n>top_element</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>desired_model_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+    <span class=p>)</span>
+
+    <span class=c1># create a plan to write the directory and file.</span>
+    <span class=n>create_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+    <span class=n>create_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+    <span class=n>create_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+    <span class=n>create_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/describe/index.html b/latest/reference/API/trestle/core/commands/describe/index.html
new file mode 100644
index 000000000..1cd27bc77
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/describe/index.html
@@ -0,0 +1,363 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.describe module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/describe/ rel=canonical><link href=../create/ rel=prev><link href=../href/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.describe - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.describe - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.describe module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/describe.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/describe/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.describe - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.describe module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/describe.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.describe class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.describe </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.describe </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.describe class=md-nav__link> <span class=md-ellipsis> describe </span> </a> <nav class=md-nav aria-label=describe> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.describe-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd class=md-nav__link> <span class=md-ellipsis> DescribeCmd </span> </a> <nav class=md-nav aria-label=DescribeCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd.describe class=md-nav__link> <span class=md-ellipsis> describe </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.describe-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.describe class=md-nav__link> <span class=md-ellipsis> describe </span> </a> <nav class=md-nav aria-label=describe> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.describe-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd class=md-nav__link> <span class=md-ellipsis> DescribeCmd </span> </a> <nav class=md-nav aria-label=DescribeCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.describe.DescribeCmd.describe class=md-nav__link> <span class=md-ellipsis> describe </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.describe-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.describe</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.describe class="doc doc-heading"> <code>trestle.core.commands.describe</code> <a href=#trestle.core.commands.describe class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Describe Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.describe-attributes>Attributes<a href=#trestle.core.commands.describe-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.describe.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.describe.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.describe-classes>Classes<a href=#trestle.core.commands.describe-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.describe.DescribeCmd class="doc doc-heading"> <code>DescribeCmd</code> <a href=#trestle.core.commands.describe.DescribeCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Describe contents of a model file including optional element path.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/describe.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DescribeCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Describe contents of a model file including optional element path.&quot;&quot;&quot;</span>
+
+    <span class=c1># The only output is via log lines.  No other results or side-effects.</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;describe&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Init arguments&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-f&#39;</span><span class=p>,</span> <span class=s1>&#39;--file&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;OSCAL file to import.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-e&#39;</span><span class=p>,</span> <span class=s1>&#39;--element&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Optional name of element in file to describe.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Entering trestle describe.&#39;</span><span class=p>)</span>
+
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>file</span><span class=p>:</span>
+                <span class=n>model_file</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>file</span><span class=p>)</span>
+
+                <span class=n>element</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>element</span> <span class=k>else</span> <span class=n>args</span><span class=o>.</span><span class=n>element</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s2>&quot;&#39;&quot;</span><span class=p>)</span>
+                <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>describe</span><span class=p>(</span><span class=n>model_file</span><span class=o>.</span><span class=n>resolve</span><span class=p>(),</span> <span class=n>element</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span> <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>results</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span> <span class=k>else</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleIncorrectArgsError</span><span class=p>(</span><span class=s1>&#39;No file specified for command describe.&#39;</span><span class=p>)</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while describing contents of a model&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>_clean_type_string</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>text</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=n>text</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s2>&quot;&lt;class &#39;&quot;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s2>&quot;&#39;&gt;&quot;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=n>text</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;trestle.oscal.&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=n>text</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;pydantic.main.&#39;</span><span class=p>,</span> <span class=s1>&#39;stripped.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>text</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>_description_text</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>sub_model</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]]])</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=n>clip_string</span> <span class=o>=</span> <span class=mi>100</span>
+        <span class=k>if</span> <span class=n>sub_model</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=s1>&#39;None&#39;</span>
+        <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+            <span class=n>n_items</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)</span>
+            <span class=n>type_text</span> <span class=o>=</span> <span class=s1>&#39;Unknown&#39;</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>n_items</span> <span class=k>else</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>cls</span><span class=o>.</span><span class=n>_clean_type_string</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>sub_model</span><span class=p>[</span><span class=mi>0</span><span class=p>])))</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;list of </span><span class=si>{</span><span class=n>n_items</span><span class=si>}</span><span class=s1> items of type </span><span class=si>{</span><span class=n>type_text</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=k>return</span> <span class=n>text</span>
+        <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>str</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>sub_model</span> <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>sub_model</span>
+                                    <span class=p>)</span> <span class=o>&lt;</span> <span class=n>clip_string</span> <span class=k>else</span> <span class=n>sub_model</span><span class=p>[:</span><span class=n>clip_string</span><span class=p>]</span> <span class=o>+</span> <span class=s1>&#39;[truncated]&#39;</span>  <span class=c1># type: ignore</span>
+        <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>sub_model</span><span class=p>,</span> <span class=s1>&#39;type_&#39;</span><span class=p>):</span>
+            <span class=k>return</span> <span class=bp>cls</span><span class=o>.</span><span class=n>_clean_type_string</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>sub_model</span><span class=o>.</span><span class=n>type_</span><span class=p>))</span>
+        <span class=k>return</span> <span class=bp>cls</span><span class=o>.</span><span class=n>_clean_type_string</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)))</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>describe</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>element_path_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Describe the contents of the file.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            file_path: pathlib.Path Path for model file to describe.</span>
+<span class=sd>            element_path_str: Element path of element in model to describe.  Can be &#39;&#39;.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The list of lines of text in the description, or an empty list on failure</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># figure out the model type so we can read it</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>model_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+        <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error loading model </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> to describe: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=p>[]</span>
+
+        <span class=n>sub_model</span> <span class=o>=</span> <span class=n>model</span>
+
+        <span class=c1># if an element path was provided, follow the path chain to the desired sub_model</span>
+        <span class=k>if</span> <span class=n>element_path_str</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;*&#39;</span> <span class=ow>in</span> <span class=n>element_path_str</span> <span class=ow>or</span> <span class=s1>&#39;,&#39;</span> <span class=ow>in</span> <span class=n>element_path_str</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Wildcards and commas are not allowed in the element path for describe.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=p>[]</span>
+
+            <span class=k>if</span> <span class=s1>&#39;.&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>element_path_str</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;The element path for describe must either be omitted or contain at least 2 parts.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=p>[]</span>
+
+            <span class=n>element_paths</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>parse_element_arg</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>element_path_str</span><span class=p>)</span>
+
+            <span class=n>sub_model_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>
+
+            <span class=k>for</span> <span class=n>element_path</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+                <span class=n>sub_model</span> <span class=o>=</span> <span class=n>sub_model_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+                <span class=n>sub_model_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)</span>
+
+        <span class=c1># now that we have the desired sub_model we can describe it</span>
+
+        <span class=n>text_out</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=c1># create top level text depending on whether an element path was used</span>
+        <span class=n>element_text</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>element_path_str</span> <span class=k>else</span> <span class=sa>f</span><span class=s1>&#39; at element path </span><span class=si>{</span><span class=n>element_path_str</span><span class=si>}</span><span class=s1>&#39;</span>
+
+        <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Model file </span><span class=si>{</span><span class=n>file_path</span><span class=si>}{</span><span class=n>element_text</span><span class=si>}</span><span class=s1> is a </span><span class=si>{</span><span class=bp>cls</span><span class=o>.</span><span class=n>_description_text</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>text_out</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Model file </span><span class=si>{</span><span class=n>file_path</span><span class=si>}{</span><span class=n>element_text</span><span class=si>}</span><span class=s1> is of type &#39;</span>
+            <span class=n>text</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>cls</span><span class=o>.</span><span class=n>_clean_type_string</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)))</span><span class=si>}</span><span class=s1> and contains:&#39;</span>
+            <span class=n>text_out</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>sub_model</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=n>value</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>sub_model</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;    </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=bp>cls</span><span class=o>.</span><span class=n>_description_text</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=n>text_out</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>text_out</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.describe.DescribeCmd-attributes>Attributes<a href=#trestle.core.commands.describe.DescribeCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.describe.DescribeCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;describe&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.describe.DescribeCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.describe.DescribeCmd-functions>Functions<a href=#trestle.core.commands.describe.DescribeCmd-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.describe.DescribeCmd.describe class="doc doc-heading"> <code class="highlight language-python"><span class=n>describe</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>element_path_str</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.describe.DescribeCmd.describe class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Describe the contents of the file.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>file_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>pathlib.Path Path for model file to describe.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>element_path_str</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Element path of element in model to describe. Can be ''.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.List>List</span>[str]</code> </td> <td> <div class=doc-md-description> <p>The list of lines of text in the description, or an empty list on failure</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/describe.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>describe</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>element_path_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Describe the contents of the file.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        file_path: pathlib.Path Path for model file to describe.</span>
+<span class=sd>        element_path_str: Element path of element in model to describe.  Can be &#39;&#39;.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The list of lines of text in the description, or an empty list on failure</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># figure out the model type so we can read it</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>model_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+    <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error loading model </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> to describe: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=p>[]</span>
+
+    <span class=n>sub_model</span> <span class=o>=</span> <span class=n>model</span>
+
+    <span class=c1># if an element path was provided, follow the path chain to the desired sub_model</span>
+    <span class=k>if</span> <span class=n>element_path_str</span><span class=p>:</span>
+        <span class=k>if</span> <span class=s1>&#39;*&#39;</span> <span class=ow>in</span> <span class=n>element_path_str</span> <span class=ow>or</span> <span class=s1>&#39;,&#39;</span> <span class=ow>in</span> <span class=n>element_path_str</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Wildcards and commas are not allowed in the element path for describe.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=p>[]</span>
+
+        <span class=k>if</span> <span class=s1>&#39;.&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>element_path_str</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;The element path for describe must either be omitted or contain at least 2 parts.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=p>[]</span>
+
+        <span class=n>element_paths</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>parse_element_arg</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>element_path_str</span><span class=p>)</span>
+
+        <span class=n>sub_model_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>element_path</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+            <span class=n>sub_model</span> <span class=o>=</span> <span class=n>sub_model_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+            <span class=n>sub_model_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)</span>
+
+    <span class=c1># now that we have the desired sub_model we can describe it</span>
+
+    <span class=n>text_out</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=c1># create top level text depending on whether an element path was used</span>
+    <span class=n>element_text</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>element_path_str</span> <span class=k>else</span> <span class=sa>f</span><span class=s1>&#39; at element path </span><span class=si>{</span><span class=n>element_path_str</span><span class=si>}</span><span class=s1>&#39;</span>
+
+    <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Model file </span><span class=si>{</span><span class=n>file_path</span><span class=si>}{</span><span class=n>element_text</span><span class=si>}</span><span class=s1> is a </span><span class=si>{</span><span class=bp>cls</span><span class=o>.</span><span class=n>_description_text</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=n>text_out</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Model file </span><span class=si>{</span><span class=n>file_path</span><span class=si>}{</span><span class=n>element_text</span><span class=si>}</span><span class=s1> is of type &#39;</span>
+        <span class=n>text</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>cls</span><span class=o>.</span><span class=n>_clean_type_string</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>sub_model</span><span class=p>)))</span><span class=si>}</span><span class=s1> and contains:&#39;</span>
+        <span class=n>text_out</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>sub_model</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>sub_model</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;    </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=bp>cls</span><span class=o>.</span><span class=n>_description_text</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>text_out</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>text_out</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.describe-functions>Functions<a href=#trestle.core.commands.describe-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/href/index.html b/latest/reference/API/trestle/core/commands/href/index.html
new file mode 100644
index 000000000..9e7b38784
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/href/index.html
@@ -0,0 +1,323 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.href module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/href/ rel=canonical><link href=../describe/ rel=prev><link href=../import_/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.href - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.href - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.href module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/href.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/href/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.href - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.href module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/href.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.href class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.href </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.href </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.href </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> <nav class=md-nav aria-label=href> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.href-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd class=md-nav__link> <span class=md-ellipsis> HrefCmd </span> </a> <nav class=md-nav aria-label=HrefCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd.change_import_href class=md-nav__link> <span class=md-ellipsis> change_import_href </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.href-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> <nav class=md-nav aria-label=href> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.href-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd class=md-nav__link> <span class=md-ellipsis> HrefCmd </span> </a> <nav class=md-nav aria-label=HrefCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.href.HrefCmd.change_import_href class=md-nav__link> <span class=md-ellipsis> change_import_href </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.href-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.href</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.href class="doc doc-heading"> <code>trestle.core.commands.href</code> <a href=#trestle.core.commands.href class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Href Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.href-attributes>Attributes<a href=#trestle.core.commands.href-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.href.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.href.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.href-classes>Classes<a href=#trestle.core.commands.href-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.href.HrefCmd class="doc doc-heading"> <code>HrefCmd</code> <a href=#trestle.core.commands.href.HrefCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Change href of import in profile to point to catalog in trestle workspace.</p> <p>This command is needed when generating an SSP with a profile that imports a catalog from a temporary location different from the final intended location of the catalog. Omit the href argument to see the list of current imports in the profile.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/href.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>HrefCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Change href of import in profile to point to catalog in trestle workspace.</span>
+
+<span class=sd>    This command is needed when generating an SSP with a profile that imports a catalog from a temporary</span>
+<span class=sd>    location different from the final intended location of the catalog.  Omit the href argument to see</span>
+<span class=sd>    the list of current imports in the profile.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;href&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Init arguments&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of trestle profile to modify (just its name).&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-hr&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--href&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;New href of form trestle://catalogs/mycat/catalog.json.&#39;</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=s1>&#39;&#39;</span>
+        <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-i&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--item&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Item number of href to modify.  Get list by running href with just -n &lt;prof_name&gt; to list values.&#39;</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>int</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=mi>0</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Entering trestle href.&#39;</span><span class=p>)</span>
+
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+
+            <span class=n>profile_name</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span>
+
+            <span class=n>new_href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>href</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s2>&quot;&#39;&quot;</span><span class=p>)</span>
+
+            <span class=n>item_num</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>item</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>change_import_href</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>new_href</span><span class=p>,</span> <span class=n>item_num</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;Error while changing href or import in profile: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>change_import_href</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>new_href</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>import_num</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Change the href of the import in the profile to point to a catalog in a specific location.</span>
+
+<span class=sd>        A Profile has an Imports list containing at least one href of a catalog or profile to be imported.</span>
+<span class=sd>        If the item being referenced is currently in the same trestle workspace as the main profile, the original</span>
+<span class=sd>        href is likely different from the one needed to access the item from the profile.  Therefore,</span>
+<span class=sd>        in order for trestle to find the item directly from the profile, the href must be modified in a way that</span>
+<span class=sd>        trestle can load it.</span>
+
+<span class=sd>        If the item is already at the link referred to by the href as a valid URI or absolute file path then no</span>
+<span class=sd>        change is needed.  But if the item is being worked on in the same trestle directory as the profile,</span>
+<span class=sd>        the href should be modified to something like trestle://catalogs/my_catalog/catalog.json</span>
+
+<span class=sd>        This change only needs to be made once to the profile while the profile is being used to generate SSP&#39;s</span>
+<span class=sd>        from the local item, but if the final profile is released the href would need to be changed to the</span>
+<span class=sd>        intended final location of the referenced item.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: trestle_root for this call</span>
+<span class=sd>            profile_name: Name of profile already imported into trestle containing href&#39;s to be changed</span>
+<span class=sd>            new_href: New value for the href of the import.  If blank just list the hrefs</span>
+<span class=sd>            import_num: Item number of the href to change.</span>
+
+
+<span class=sd>        Returns:</span>
+<span class=sd>            0 on success, 1 on failure</span>
+
+<span class=sd>        Assumptions and requirements:</span>
+<span class=sd>            The profile must be a valid profile in the trestle workspace.</span>
+<span class=sd>            The import must either be a valid uri, including local file, or trestle://</span>
+<span class=sd>            The original href is not checked and will be overwritten.</span>
+<span class=sd>            If href is the empty string, just list all hrefs.</span>
+
+<span class=sd>        Future work:</span>
+<span class=sd>            Allow multiple imports with matching hrefs.</span>
+<span class=sd>            Allow href to point to profile in trestle rather than catalog, and by name.</span>
+<span class=sd>            Allow full chaining of linked catalogs and profiles.</span>
+
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>profile_data</span><span class=p>,</span> <span class=n>profile_path</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>Profile</span><span class=p>)</span>
+        <span class=n>n_imports</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>profile_data</span><span class=o>.</span><span class=n>imports</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>new_href</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;List of imports for profile </span><span class=si>{</span><span class=n>profile_name</span><span class=si>}</span><span class=s1>:&#39;</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>ii</span><span class=p>,</span> <span class=n>import_</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>profile_data</span><span class=o>.</span><span class=n>imports</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ii</span><span class=si>:</span><span class=s1>2</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>import_</span><span class=o>.</span><span class=n>href</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=n>n_imports</span> <span class=o>&lt;=</span> <span class=n>import_num</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Import number </span><span class=si>{</span><span class=n>import_num</span><span class=si>}</span><span class=s1> is too large.  This profile has only </span><span class=si>{</span><span class=n>n_imports</span><span class=si>}</span><span class=s1> imports.&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Changing import </span><span class=si>{</span><span class=n>import_num</span><span class=si>}</span><span class=s1> in profile </span><span class=si>{</span><span class=n>profile_name</span><span class=si>}</span><span class=s1> from, to:&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>profile_data</span><span class=o>.</span><span class=n>imports</span><span class=p>[</span><span class=n>import_num</span><span class=p>]</span><span class=o>.</span><span class=n>href</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>new_href</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>profile_data</span><span class=o>.</span><span class=n>imports</span><span class=p>[</span><span class=n>import_num</span><span class=p>]</span><span class=o>.</span><span class=n>href</span> <span class=o>=</span> <span class=n>new_href</span>
+        <span class=n>profile_data</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>profile_path</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.href.HrefCmd-attributes>Attributes<a href=#trestle.core.commands.href.HrefCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.href.HrefCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;href&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.href.HrefCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.href.HrefCmd-functions>Functions<a href=#trestle.core.commands.href.HrefCmd-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.href.HrefCmd.change_import_href class="doc doc-heading"> <code class="highlight language-python"><span class=n>change_import_href</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>new_href</span><span class=p>,</span> <span class=n>import_num</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.href.HrefCmd.change_import_href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Change the href of the import in the profile to point to a catalog in a specific location.</p> <p>A Profile has an Imports list containing at least one href of a catalog or profile to be imported. If the item being referenced is currently in the same trestle workspace as the main profile, the original href is likely different from the one needed to access the item from the profile. Therefore, in order for trestle to find the item directly from the profile, the href must be modified in a way that trestle can load it.</p> <p>If the item is already at the link referred to by the href as a valid URI or absolute file path then no change is needed. But if the item is being worked on in the same trestle directory as the profile, the href should be modified to something like trestle://catalogs/my_catalog/catalog.json</p> <p>This change only needs to be made once to the profile while the profile is being used to generate SSP's from the local item, but if the final profile is released the href would need to be changed to the intended final location of the referenced item.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>trestle_root for this call</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>profile_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Name of profile already imported into trestle containing href's to be changed</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>new_href</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>New value for the href of the import. If blank just list the hrefs</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>import_num</code> </td> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>Item number of the href to change.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>0 on success, 1 on failure</p> </div> </td> </tr> </tbody> </table> <details class=assumptions-and-requirements open> <summary>Assumptions and requirements</summary> <p>The profile must be a valid profile in the trestle workspace. The import must either be a valid uri, including local file, or trestle:// The original href is not checked and will be overwritten. If href is the empty string, just list all hrefs.</p> </details> <details class=future-work open> <summary>Future work</summary> <p>Allow multiple imports with matching hrefs. Allow href to point to profile in trestle rather than catalog, and by name. Allow full chaining of linked catalogs and profiles.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/commands/href.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>change_import_href</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>new_href</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>import_num</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Change the href of the import in the profile to point to a catalog in a specific location.</span>
+
+<span class=sd>    A Profile has an Imports list containing at least one href of a catalog or profile to be imported.</span>
+<span class=sd>    If the item being referenced is currently in the same trestle workspace as the main profile, the original</span>
+<span class=sd>    href is likely different from the one needed to access the item from the profile.  Therefore,</span>
+<span class=sd>    in order for trestle to find the item directly from the profile, the href must be modified in a way that</span>
+<span class=sd>    trestle can load it.</span>
+
+<span class=sd>    If the item is already at the link referred to by the href as a valid URI or absolute file path then no</span>
+<span class=sd>    change is needed.  But if the item is being worked on in the same trestle directory as the profile,</span>
+<span class=sd>    the href should be modified to something like trestle://catalogs/my_catalog/catalog.json</span>
+
+<span class=sd>    This change only needs to be made once to the profile while the profile is being used to generate SSP&#39;s</span>
+<span class=sd>    from the local item, but if the final profile is released the href would need to be changed to the</span>
+<span class=sd>    intended final location of the referenced item.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: trestle_root for this call</span>
+<span class=sd>        profile_name: Name of profile already imported into trestle containing href&#39;s to be changed</span>
+<span class=sd>        new_href: New value for the href of the import.  If blank just list the hrefs</span>
+<span class=sd>        import_num: Item number of the href to change.</span>
+
+
+<span class=sd>    Returns:</span>
+<span class=sd>        0 on success, 1 on failure</span>
+
+<span class=sd>    Assumptions and requirements:</span>
+<span class=sd>        The profile must be a valid profile in the trestle workspace.</span>
+<span class=sd>        The import must either be a valid uri, including local file, or trestle://</span>
+<span class=sd>        The original href is not checked and will be overwritten.</span>
+<span class=sd>        If href is the empty string, just list all hrefs.</span>
+
+<span class=sd>    Future work:</span>
+<span class=sd>        Allow multiple imports with matching hrefs.</span>
+<span class=sd>        Allow href to point to profile in trestle rather than catalog, and by name.</span>
+<span class=sd>        Allow full chaining of linked catalogs and profiles.</span>
+
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>profile_data</span><span class=p>,</span> <span class=n>profile_path</span> <span class=o>=</span> <span class=n>load_validate_model_name</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_name</span><span class=p>,</span> <span class=n>Profile</span><span class=p>)</span>
+    <span class=n>n_imports</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>profile_data</span><span class=o>.</span><span class=n>imports</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>new_href</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;List of imports for profile </span><span class=si>{</span><span class=n>profile_name</span><span class=si>}</span><span class=s1>:&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>ii</span><span class=p>,</span> <span class=n>import_</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>profile_data</span><span class=o>.</span><span class=n>imports</span><span class=p>):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ii</span><span class=si>:</span><span class=s1>2</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>import_</span><span class=o>.</span><span class=n>href</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+    <span class=k>if</span> <span class=n>n_imports</span> <span class=o>&lt;=</span> <span class=n>import_num</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Import number </span><span class=si>{</span><span class=n>import_num</span><span class=si>}</span><span class=s1> is too large.  This profile has only </span><span class=si>{</span><span class=n>n_imports</span><span class=si>}</span><span class=s1> imports.&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Changing import </span><span class=si>{</span><span class=n>import_num</span><span class=si>}</span><span class=s1> in profile </span><span class=si>{</span><span class=n>profile_name</span><span class=si>}</span><span class=s1> from, to:&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>profile_data</span><span class=o>.</span><span class=n>imports</span><span class=p>[</span><span class=n>import_num</span><span class=p>]</span><span class=o>.</span><span class=n>href</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>new_href</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>profile_data</span><span class=o>.</span><span class=n>imports</span><span class=p>[</span><span class=n>import_num</span><span class=p>]</span><span class=o>.</span><span class=n>href</span> <span class=o>=</span> <span class=n>new_href</span>
+    <span class=n>profile_data</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>profile_path</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.href-functions>Functions<a href=#trestle.core.commands.href-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/import_/index.html b/latest/reference/API/trestle/core/commands/import_/index.html
new file mode 100644
index 000000000..072ca0483
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/import_/index.html
@@ -0,0 +1,164 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.import_ module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/import_/ rel=canonical><link href=../href/ rel=prev><link href=../init/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.import_ - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.import_ - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.import_ module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/import_.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/import_/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.import_ - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.import_ module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/import_.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.import_ class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.import_ </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.import_ </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.import_ class=md-nav__link> <span class=md-ellipsis> import_ </span> </a> <nav class=md-nav aria-label=import_> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.import_-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_.ImportCmd class=md-nav__link> <span class=md-ellipsis> ImportCmd </span> </a> <nav class=md-nav aria-label=ImportCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_.ImportCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_.ImportCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.import_-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.import_ class=md-nav__link> <span class=md-ellipsis> import_ </span> </a> <nav class=md-nav aria-label=import_> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.import_-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_.ImportCmd class=md-nav__link> <span class=md-ellipsis> ImportCmd </span> </a> <nav class=md-nav aria-label=ImportCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_.ImportCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.import_.ImportCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.import_-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.import_</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.import_ class="doc doc-heading"> <code>trestle.core.commands.import_</code> <a href=#trestle.core.commands.import_ class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Import Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.import_-attributes>Attributes<a href=#trestle.core.commands.import_-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.import_.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.import_.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.import_-classes>Classes<a href=#trestle.core.commands.import_-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.import_.ImportCmd class="doc doc-heading"> <code>ImportCmd</code> <a href=#trestle.core.commands.import_.ImportCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Import an existing full OSCAL model into the trestle workspace.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/import_.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ImportCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Import an existing full OSCAL model into the trestle workspace.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;import&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Init arguments&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-f&#39;</span><span class=p>,</span> <span class=s1>&#39;--file&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;OSCAL file to import - either file path or url.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of output element.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-r&#39;</span><span class=p>,</span> <span class=s1>&#39;--regenerate&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_REGENERATE</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Top level import run command.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleRootError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Attempt to import from non-valid trestle project root </span><span class=si>{</span><span class=n>trestle_root</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>input_uri</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>file</span>
+            <span class=k>if</span> <span class=n>cache</span><span class=o>.</span><span class=n>FetcherFactory</span><span class=o>.</span><span class=n>in_trestle_directory</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>input_uri</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Imported file </span><span class=si>{</span><span class=n>input_uri</span><span class=si>}</span><span class=s1> cannot be from current trestle project. Use duplicate instead.&#39;</span>
+                <span class=p>)</span>
+
+            <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=s1>&#39;.&#39;</span> <span class=o>+</span> <span class=n>input_uri</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+
+            <span class=n>fetcher</span> <span class=o>=</span> <span class=n>cache</span><span class=o>.</span><span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_fetcher</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=nb>str</span><span class=p>(</span><span class=n>input_uri</span><span class=p>))</span>
+
+            <span class=n>model_read</span><span class=p>,</span> <span class=n>parent_alias</span> <span class=o>=</span> <span class=n>fetcher</span><span class=o>.</span><span class=n>get_oscal</span><span class=p>(</span><span class=kc>True</span><span class=p>)</span>
+
+            <span class=c1># validate the loaded model in memory before writing out</span>
+            <span class=c1># this will do any needed fixes to the file, such as assign missing catalog group ids</span>
+            <span class=n>args_validate</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span><span class=n>mode</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>VAL_MODE_ALL</span><span class=p>)</span>
+            <span class=n>validator</span><span class=p>:</span> <span class=n>Validator</span> <span class=o>=</span> <span class=n>validator_factory</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>args_validate</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>validator</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model_read</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Validation of file to be imported </span><span class=si>{</span><span class=n>input_uri</span><span class=si>}</span><span class=s1> did not pass.  Import failed.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>parent_alias</span><span class=p>)</span>
+
+            <span class=n>output_name</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span>
+
+            <span class=n>desired_model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>plural_path</span>
+            <span class=n>desired_model_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>desired_model_dir</span> <span class=o>/</span> <span class=n>output_name</span> <span class=o>/</span> <span class=n>parent_alias</span>
+            <span class=n>desired_model_path</span> <span class=o>=</span> <span class=n>desired_model_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+                                                                <span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+
+            <span class=k>if</span> <span class=n>desired_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cannot import because file to be imported here: </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1> already exists.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>regenerate</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;regenerating uuids in imported file </span><span class=si>{</span><span class=n>input_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>model_read</span><span class=p>,</span> <span class=n>lut</span><span class=p>,</span> <span class=n>nchanged</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>model_read</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;uuid lut has </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>lut</span><span class=o>.</span><span class=n>items</span><span class=p>())</span><span class=si>}</span><span class=s1> entries and </span><span class=si>{</span><span class=n>nchanged</span><span class=si>}</span><span class=s1> refs were updated&#39;</span><span class=p>)</span>
+
+            <span class=n>top_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model_read</span><span class=p>)</span>
+            <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>desired_model_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+            <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>desired_model_path</span><span class=p>,</span> <span class=n>top_element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+
+            <span class=c1># create a plan to create the directory and write the imported file.</span>
+            <span class=n>import_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+            <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+            <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+
+            <span class=n>import_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+            <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+                <span class=n>file</span><span class=o>=</span><span class=n>desired_model_path</span><span class=p>,</span>
+                <span class=n>verbose</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>verbose</span><span class=p>,</span>
+                <span class=n>trestle_root</span><span class=o>=</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span>
+                <span class=nb>type</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span>
+                <span class=nb>all</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span>
+                <span class=n>quiet</span><span class=o>=</span><span class=kc>True</span>
+            <span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while importing OSCAL file&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.import_.ImportCmd-attributes>Attributes<a href=#trestle.core.commands.import_.ImportCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.import_.ImportCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;import&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.import_.ImportCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.import_-functions>Functions<a href=#trestle.core.commands.import_-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/init/index.html b/latest/reference/API/trestle/core/commands/init/index.html
new file mode 100644
index 000000000..75ff6a140
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/init/index.html
@@ -0,0 +1,158 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.init module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/init/ rel=canonical><link href=../import_/ rel=prev><link href=../merge/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.init - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.init - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.init module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/init.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/init/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.init - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.init module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/init.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.init class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.init </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.init </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.init </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.init class=md-nav__link> <span class=md-ellipsis> init </span> </a> <nav class=md-nav aria-label=init> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.init-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init.InitCmd class=md-nav__link> <span class=md-ellipsis> InitCmd </span> </a> <nav class=md-nav aria-label=InitCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init.InitCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init.InitCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.init-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.init class=md-nav__link> <span class=md-ellipsis> init </span> </a> <nav class=md-nav aria-label=init> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.init-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init.InitCmd class=md-nav__link> <span class=md-ellipsis> InitCmd </span> </a> <nav class=md-nav aria-label=InitCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init.InitCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.init.InitCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.init-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.init</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.init class="doc doc-heading"> <code>trestle.core.commands.init</code> <a href=#trestle.core.commands.init class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Init Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.init-attributes>Attributes<a href=#trestle.core.commands.init-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.init.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.init.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.init-classes>Classes<a href=#trestle.core.commands.init-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.init.InitCmd class="doc doc-heading"> <code>InitCmd</code> <a href=#trestle.core.commands.init.InitCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandBase href=../command_docs/#trestle.core.commands.command_docs.CommandBase>CommandBase</a></code></p> <p>Initialize a trestle working directory.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/init.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>InitCmd</span><span class=p>(</span><span class=n>CommandBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize a trestle working directory.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;init&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>INIT_FULL_SHORT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>INIT_FULL_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>INIT_FULL_HELP</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>INIT_LOCAL_SHORT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>INIT_LOCAL_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>INIT_LOCAL_HELP</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>INIT_GOVDOCS_SHORT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>INIT_GOVDOCS_LONG</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>INIT_GOVDOCS_HELP</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create a trestle workspace in the current directory.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>dir_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>dir_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>dir_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                <span class=k>raise</span> <span class=n>TrestleRootError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Initialization failed. Given directory </span><span class=si>{</span><span class=n>dir_path</span><span class=si>}</span><span class=s1> does not exist or is not a directory.&#39;</span>
+                <span class=p>)</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>full</span> <span class=ow>or</span> <span class=n>args</span><span class=o>.</span><span class=n>local</span> <span class=ow>or</span> <span class=n>args</span><span class=o>.</span><span class=n>govdocs</span><span class=p>):</span>
+                <span class=c1># Running in full mode by default</span>
+                <span class=n>args</span><span class=o>.</span><span class=n>full</span> <span class=o>=</span> <span class=kc>True</span>
+
+            <span class=n>init_dist_folder</span> <span class=o>=</span> <span class=kc>True</span> <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>full</span> <span class=k>else</span> <span class=kc>False</span>
+            <span class=n>init_oscal_folders</span> <span class=o>=</span> <span class=kc>True</span> <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>local</span> <span class=ow>or</span> <span class=n>args</span><span class=o>.</span><span class=n>full</span> <span class=k>else</span> <span class=kc>False</span>
+            <span class=n>copy_config_file</span> <span class=o>=</span> <span class=kc>True</span> <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>full</span> <span class=ow>or</span> <span class=n>args</span><span class=o>.</span><span class=n>local</span> <span class=k>else</span> <span class=kc>False</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>_create_directories</span><span class=p>(</span><span class=n>dir_path</span><span class=p>,</span> <span class=n>init_oscal_folders</span><span class=p>,</span> <span class=n>init_dist_folder</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>copy_config_file</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_copy_config_file</span><span class=p>(</span><span class=n>dir_path</span><span class=p>)</span>
+
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Initialized trestle project successfully in </span><span class=si>{</span><span class=n>dir_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Failed to initialize Trestle working directory.&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_create_directories</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>create_model_folders</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>create_dist_folder</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create the directory tree if it does not exist.&quot;&quot;&quot;</span>
+        <span class=c1># Prepare directory list to be created</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>directory_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>root</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_CONFIG_DIR</span><span class=p>)]</span>
+
+            <span class=k>if</span> <span class=n>create_model_folders</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>model_dir</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_DIR_LIST</span><span class=p>:</span>
+                    <span class=n>directory_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>root</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>model_dir</span><span class=p>))</span>
+                    <span class=k>if</span> <span class=n>create_dist_folder</span><span class=p>:</span>
+                        <span class=n>directory_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>root</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_DIST_DIR</span><span class=p>)</span> <span class=o>/</span> <span class=n>model_dir</span><span class=p>)</span>
+
+            <span class=c1># Create directories</span>
+            <span class=k>for</span> <span class=n>directory</span> <span class=ow>in</span> <span class=n>directory_list</span><span class=p>:</span>
+                <span class=n>directory</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+                <span class=n>file_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>directory</span><span class=p>)</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_KEEP_FILE</span>
+                <span class=n>file_utils</span><span class=o>.</span><span class=n>make_hidden_file</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>OSError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while creating directories: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unexpected error while creating directories: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_copy_config_file</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Copy the initial config.ini file to .trestle directory.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ref</span> <span class=o>=</span> <span class=n>importlib_resources</span><span class=o>.</span><span class=n>files</span><span class=p>(</span><span class=s1>&#39;trestle.resources&#39;</span><span class=p>)</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_CONFIG_FILE</span>
+            <span class=k>with</span> <span class=n>importlib_resources</span><span class=o>.</span><span class=n>as_file</span><span class=p>(</span><span class=n>ref</span><span class=p>)</span> <span class=k>as</span> <span class=n>source_path</span><span class=p>:</span>
+                <span class=n>destination_path</span> <span class=o>=</span> <span class=p>(</span><span class=n>root</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_CONFIG_DIR</span><span class=p>)</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_CONFIG_FILE</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+                <span class=n>copyfile</span><span class=p>(</span><span class=n>source_path</span><span class=p>,</span> <span class=n>destination_path</span><span class=p>)</span>
+
+        <span class=k>except</span> <span class=p>(</span><span class=n>shutil</span><span class=o>.</span><span class=n>SameFileError</span><span class=p>,</span> <span class=ne>OSError</span><span class=p>)</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while copying config file: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unexpected error while copying config file: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.init.InitCmd-attributes>Attributes<a href=#trestle.core.commands.init.InitCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.init.InitCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;init&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.init.InitCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.init-functions>Functions<a href=#trestle.core.commands.init-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/merge/index.html b/latest/reference/API/trestle/core/commands/merge/index.html
new file mode 100644
index 000000000..c64085860
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/merge/index.html
@@ -0,0 +1,600 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.merge module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/merge/ rel=canonical><link href=../init/ rel=prev><link href=../partial_object_validate/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.merge - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.merge - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.merge module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/merge.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/merge/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.merge - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.merge module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/merge.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.merge class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.merge </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.merge </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> <nav class=md-nav aria-label=merge> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge.trace class=md-nav__link> <span class=md-ellipsis> trace </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd class=md-nav__link> <span class=md-ellipsis> MergeCmd </span> </a> <nav class=md-nav aria-label=MergeCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd.perform_all_merges class=md-nav__link> <span class=md-ellipsis> perform_all_merges </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> <nav class=md-nav aria-label=merge> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge.trace class=md-nav__link> <span class=md-ellipsis> trace </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd class=md-nav__link> <span class=md-ellipsis> MergeCmd </span> </a> <nav class=md-nav aria-label=MergeCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge.MergeCmd.perform_all_merges class=md-nav__link> <span class=md-ellipsis> perform_all_merges </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.merge-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.merge</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.merge class="doc doc-heading"> <code>trestle.core.commands.merge</code> <a href=#trestle.core.commands.merge class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Merge Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.merge-attributes>Attributes<a href=#trestle.core.commands.merge-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.merge.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.merge.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.merge.trace class="doc doc-heading"> <code class="highlight language-python"><span class=n>trace</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>Trace</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.merge.trace class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.merge-classes>Classes<a href=#trestle.core.commands.merge-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.merge.MergeCmd class="doc doc-heading"> <code>MergeCmd</code> <a href=#trestle.core.commands.merge.MergeCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Merge subcomponents on a trestle model.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/merge.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>MergeCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Merge subcomponents on a trestle model.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;merge&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;-</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT_SHORT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=sa>f</span><span class=s1>&#39;--</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_DESC_ELEMENT</span><span class=si>}</span><span class=s1>(s) to be merged. The last element is merged into the second last element.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge elements into the parent oscal model.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+
+            <span class=c1># remove any quotes passed in as on windows platforms</span>
+            <span class=n>elements_clean</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>element</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s2>&quot;&#39;&quot;</span><span class=p>)</span>
+            <span class=n>element_paths</span> <span class=o>=</span> <span class=n>elements_clean</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;merge _run element paths </span><span class=si>{</span><span class=n>element_paths</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>cwd</span> <span class=o>=</span> <span class=n>Path</span><span class=o>.</span><span class=n>cwd</span><span class=p>()</span>
+            <span class=n>rc</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>perform_all_merges</span><span class=p>(</span><span class=n>element_paths</span><span class=p>,</span> <span class=n>cwd</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>rc</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while merging subcomponents on a trestle model&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>perform_all_merges</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>effective_cwd</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Run all merges over a list of element paths.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>element_path</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;merge </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>plan</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>merge</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>,</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>element_path</span><span class=p>),</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=n>plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>merge</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>effective_cwd</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Plan</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge operations.</span>
+
+<span class=sd>        It returns a plan for the operation</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>element_path</span><span class=o>.</span><span class=n>is_multipart</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=s1>&#39;Multiple parts of an element path must be passed to merge e.g. catalog.* or catalog.groups&#39;</span>
+            <span class=p>)</span>
+
+        <span class=n>target_model_alias</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;merge element path list: </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1> target model alias </span><span class=si>{</span><span class=n>target_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># 1. Load desination model into a stripped model</span>
+        <span class=c1># Load destination model</span>
+        <span class=n>destination_path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_preceding_path</span><span class=p>()</span>
+        <span class=n>destination_model_alias</span> <span class=o>=</span> <span class=n>destination_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;merge destination model alias: </span><span class=si>{</span><span class=n>destination_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=s1>&#39;merge getting contextual file type effective working directory&#39;</span><span class=p>)</span>
+        <span class=c1># Destination model filetype</span>
+        <span class=n>file_type</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>get_contextual_file_type</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>)</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;contextual file type is </span><span class=si>{</span><span class=n>file_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>file_ext</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_type</span><span class=p>)</span>
+        <span class=c1># Destination model filename</span>
+        <span class=n>destination_model_path</span> <span class=o>=</span> <span class=p>(</span>
+            <span class=n>effective_cwd</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>destination_model_alias</span><span class=p>,</span><span class=w> </span><span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span><span class=si>}{</span><span class=n>file_ext</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=p>)</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;destination model filename is </span><span class=si>{</span><span class=n>destination_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>destination_model_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+
+        <span class=n>destination_model_object</span><span class=p>:</span> <span class=n>OscalBaseModel</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>if</span> <span class=n>destination_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=s1>&#39;dest filename exists so read it&#39;</span><span class=p>)</span>
+            <span class=n>destination_model_object</span> <span class=o>=</span> <span class=n>destination_model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>)</span>
+        <span class=c1># 2. If target is wildcard, load distributed destination model and replace destination model.</span>
+        <span class=c1># Handle WILDCARD &#39;*&#39; match. Return plan to load the destination model, with its distributed attributes</span>
+        <span class=k>if</span> <span class=n>target_model_alias</span> <span class=o>==</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=s1>&#39;handle target model alias wildcard&#39;</span><span class=p>)</span>
+            <span class=n>collection_type</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=k>if</span> <span class=n>destination_model_type</span><span class=o>.</span><span class=n>is_collection_container</span><span class=p>():</span>
+                <span class=n>collection_type</span> <span class=o>=</span> <span class=n>destination_model_type</span><span class=o>.</span><span class=n>get_collection_type</span><span class=p>()</span>
+
+            <span class=n>merged_model_type</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>merged_model_instance</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span>
+                <span class=n>destination_model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>collection_type</span><span class=p>)</span>
+            <span class=n>plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+            <span class=n>reset_destination_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>,</span> <span class=n>clear_content</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+            <span class=n>wrapper_alias</span> <span class=o>=</span> <span class=n>destination_model_alias</span>
+            <span class=n>write_destination_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span>
+                <span class=n>destination_model_path</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>merged_model_instance</span><span class=p>,</span> <span class=n>wrapper_alias</span><span class=p>),</span> <span class=n>content_type</span><span class=o>=</span><span class=n>file_type</span>
+            <span class=p>)</span>
+            <span class=n>remove_path_folder</span> <span class=o>=</span> <span class=n>effective_cwd</span> <span class=o>/</span> <span class=n>destination_model_alias</span>
+            <span class=n>delete_target_action</span> <span class=o>=</span> <span class=n>RemovePathAction</span><span class=p>(</span><span class=n>remove_path_folder</span><span class=p>)</span>
+            <span class=n>plan</span><span class=p>:</span> <span class=n>Plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+            <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>reset_destination_action</span><span class=p>)</span>
+            <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_destination_action</span><span class=p>)</span>
+            <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>delete_target_action</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>plan</span>
+
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get dest model with fields stripped: </span><span class=si>{</span><span class=n>target_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># Get destination model without the target field stripped</span>
+        <span class=n>merged_model_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span>
+                                                                  <span class=n>aliases_not_to_be_stripped</span><span class=o>=</span><span class=p>[</span><span class=n>target_model_alias</span><span class=p>])</span>
+        <span class=c1># 3. Load Target model. Target model could be stripped</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>target_model_type</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_type</span><span class=p>(</span><span class=n>merged_model_type</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model not found, element path list </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1> type </span><span class=si>{</span><span class=n>merged_model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Target model not found. Possibly merge of the elements not allowed at this point. </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+        <span class=n>target_model_path</span> <span class=o>=</span> <span class=n>effective_cwd</span> <span class=o>/</span> <span class=n>destination_model_alias</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;look for target model path </span><span class=si>{</span><span class=n>target_model_path</span><span class=si>}</span><span class=s1> at dest alias </span><span class=si>{</span><span class=n>destination_model_alias</span><span class=si>}</span><span class=s1> rel to cwd&#39;</span><span class=p>)</span>
+
+        <span class=c1># target_model filename - depends whether destination model is decomposed or not</span>
+        <span class=k>if</span> <span class=n>target_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model path does exist so target path is subdir with target alias </span><span class=si>{</span><span class=n>target_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>target_model_path</span> <span class=o>=</span> <span class=n>target_model_path</span> <span class=o>/</span> <span class=n>target_model_alias</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model filename does not exist so target path is target alias </span><span class=si>{</span><span class=n>target_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>target_model_path</span> <span class=o>=</span> <span class=n>target_model_path</span> <span class=o>/</span> <span class=n>target_model_alias</span>  <span class=c1># FIXME this is same as above</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;final target model path is </span><span class=si>{</span><span class=n>target_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># if target model is a file then handle file. If file doesn&#39;t exist, handle the directory,</span>
+        <span class=c1># but in this case it&#39;s a list or a dict collection type</span>
+        <span class=n>target_model_filename</span> <span class=o>=</span> <span class=n>target_model_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>file_ext</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>target_model_filename</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model path with extension does exist so load distrib </span><span class=si>{</span><span class=n>target_model_filename</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>target_model_object</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>target_model_filename</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>target_model_filename</span> <span class=o>=</span> <span class=n>Path</span><span class=p>(</span><span class=n>target_model_path</span><span class=p>)</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model path plus extension does not exist so load distrib </span><span class=si>{</span><span class=n>target_model_filename</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get collection type for model type </span><span class=si>{</span><span class=n>target_model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>collection_type</span> <span class=o>=</span> <span class=n>type_utils</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>target_model_type</span><span class=p>)</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;load </span><span class=si>{</span><span class=n>target_model_filename</span><span class=si>}</span><span class=s1> as collection type </span><span class=si>{</span><span class=n>collection_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>target_model_object</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>target_model_filename</span><span class=p>,</span>
+                                                                    <span class=n>trestle_root</span><span class=p>,</span> <span class=n>collection_type</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>target_model_object</span><span class=p>,</span> <span class=s1>&#39;__dict__&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=n>target_model_object</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>:</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=s1>&#39;loaded object has dict and root so set target model object to root contents&#39;</span><span class=p>)</span>
+            <span class=n>target_model_object</span> <span class=o>=</span> <span class=n>target_model_object</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span>
+        <span class=c1># 4. Insert target model into destination model.</span>
+        <span class=n>merged_dict</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>if</span> <span class=n>destination_model_object</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>merged_dict</span> <span class=o>=</span> <span class=n>destination_model_object</span><span class=o>.</span><span class=vm>__dict__</span>
+        <span class=n>merged_dict</span><span class=p>[</span><span class=n>target_model_alias</span><span class=p>]</span> <span class=o>=</span> <span class=n>target_model_object</span>
+        <span class=n>merged_model_object</span> <span class=o>=</span> <span class=n>merged_model_type</span><span class=p>(</span><span class=o>**</span><span class=n>merged_dict</span><span class=p>)</span>
+        <span class=n>merged_destination_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>merged_model_object</span><span class=p>)</span>
+        <span class=c1># 5. Create action  plan</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;create path action clear content: </span><span class=si>{</span><span class=n>destination_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>reset_destination_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>,</span> <span class=n>clear_content</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;write file action </span><span class=si>{</span><span class=n>destination_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>write_destination_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span>
+            <span class=n>destination_model_path</span><span class=p>,</span> <span class=n>merged_destination_element</span><span class=p>,</span> <span class=n>content_type</span><span class=o>=</span><span class=n>file_type</span>
+        <span class=p>)</span>
+        <span class=c1># FIXME this will delete metadata.json but it will leave metadata/roles/roles.*</span>
+        <span class=c1># need to clean up all lower dirs</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;remove path action </span><span class=si>{</span><span class=n>target_model_filename</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>delete_target_action</span> <span class=o>=</span> <span class=n>RemovePathAction</span><span class=p>(</span><span class=n>target_model_filename</span><span class=p>)</span>
+
+        <span class=n>plan</span><span class=p>:</span> <span class=n>Plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>reset_destination_action</span><span class=p>)</span>
+        <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_destination_action</span><span class=p>)</span>
+        <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>delete_target_action</span><span class=p>)</span>
+
+        <span class=c1># TODO: Destination model directory is empty or already merged? Then clean up.</span>
+
+        <span class=k>return</span> <span class=n>plan</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.merge.MergeCmd-attributes>Attributes<a href=#trestle.core.commands.merge.MergeCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.merge.MergeCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;merge&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.merge.MergeCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.merge.MergeCmd-functions>Functions<a href=#trestle.core.commands.merge.MergeCmd-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.merge.MergeCmd.merge class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>,</span> <span class=n>element_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.merge.MergeCmd.merge class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge operations.</p> <p>It returns a plan for the operation</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/merge.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>merge</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>effective_cwd</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Plan</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Merge operations.</span>
+
+<span class=sd>    It returns a plan for the operation</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>element_path</span><span class=o>.</span><span class=n>is_multipart</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=s1>&#39;Multiple parts of an element path must be passed to merge e.g. catalog.* or catalog.groups&#39;</span>
+        <span class=p>)</span>
+
+    <span class=n>target_model_alias</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;merge element path list: </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1> target model alias </span><span class=si>{</span><span class=n>target_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=c1># 1. Load desination model into a stripped model</span>
+    <span class=c1># Load destination model</span>
+    <span class=n>destination_path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_preceding_path</span><span class=p>()</span>
+    <span class=n>destination_model_alias</span> <span class=o>=</span> <span class=n>destination_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span>
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;merge destination model alias: </span><span class=si>{</span><span class=n>destination_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=s1>&#39;merge getting contextual file type effective working directory&#39;</span><span class=p>)</span>
+    <span class=c1># Destination model filetype</span>
+    <span class=n>file_type</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>get_contextual_file_type</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>)</span>
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;contextual file type is </span><span class=si>{</span><span class=n>file_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>file_ext</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>file_type</span><span class=p>)</span>
+    <span class=c1># Destination model filename</span>
+    <span class=n>destination_model_path</span> <span class=o>=</span> <span class=p>(</span>
+        <span class=n>effective_cwd</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>destination_model_alias</span><span class=p>,</span><span class=w> </span><span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span><span class=si>}{</span><span class=n>file_ext</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=p>)</span>
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;destination model filename is </span><span class=si>{</span><span class=n>destination_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>destination_model_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+
+    <span class=n>destination_model_object</span><span class=p>:</span> <span class=n>OscalBaseModel</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>if</span> <span class=n>destination_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=s1>&#39;dest filename exists so read it&#39;</span><span class=p>)</span>
+        <span class=n>destination_model_object</span> <span class=o>=</span> <span class=n>destination_model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>)</span>
+    <span class=c1># 2. If target is wildcard, load distributed destination model and replace destination model.</span>
+    <span class=c1># Handle WILDCARD &#39;*&#39; match. Return plan to load the destination model, with its distributed attributes</span>
+    <span class=k>if</span> <span class=n>target_model_alias</span> <span class=o>==</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=s1>&#39;handle target model alias wildcard&#39;</span><span class=p>)</span>
+        <span class=n>collection_type</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>if</span> <span class=n>destination_model_type</span><span class=o>.</span><span class=n>is_collection_container</span><span class=p>():</span>
+            <span class=n>collection_type</span> <span class=o>=</span> <span class=n>destination_model_type</span><span class=o>.</span><span class=n>get_collection_type</span><span class=p>()</span>
+
+        <span class=n>merged_model_type</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>merged_model_instance</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span>
+            <span class=n>destination_model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>collection_type</span><span class=p>)</span>
+        <span class=n>plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=n>reset_destination_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>,</span> <span class=n>clear_content</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>wrapper_alias</span> <span class=o>=</span> <span class=n>destination_model_alias</span>
+        <span class=n>write_destination_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span>
+            <span class=n>destination_model_path</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>merged_model_instance</span><span class=p>,</span> <span class=n>wrapper_alias</span><span class=p>),</span> <span class=n>content_type</span><span class=o>=</span><span class=n>file_type</span>
+        <span class=p>)</span>
+        <span class=n>remove_path_folder</span> <span class=o>=</span> <span class=n>effective_cwd</span> <span class=o>/</span> <span class=n>destination_model_alias</span>
+        <span class=n>delete_target_action</span> <span class=o>=</span> <span class=n>RemovePathAction</span><span class=p>(</span><span class=n>remove_path_folder</span><span class=p>)</span>
+        <span class=n>plan</span><span class=p>:</span> <span class=n>Plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>reset_destination_action</span><span class=p>)</span>
+        <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_destination_action</span><span class=p>)</span>
+        <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>delete_target_action</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>plan</span>
+
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get dest model with fields stripped: </span><span class=si>{</span><span class=n>target_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=c1># Get destination model without the target field stripped</span>
+    <span class=n>merged_model_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span>
+                                                              <span class=n>aliases_not_to_be_stripped</span><span class=o>=</span><span class=p>[</span><span class=n>target_model_alias</span><span class=p>])</span>
+    <span class=c1># 3. Load Target model. Target model could be stripped</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>target_model_type</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_type</span><span class=p>(</span><span class=n>merged_model_type</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model not found, element path list </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1> type </span><span class=si>{</span><span class=n>merged_model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Target model not found. Possibly merge of the elements not allowed at this point. </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>e</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=p>)</span>
+    <span class=n>target_model_path</span> <span class=o>=</span> <span class=n>effective_cwd</span> <span class=o>/</span> <span class=n>destination_model_alias</span>
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;look for target model path </span><span class=si>{</span><span class=n>target_model_path</span><span class=si>}</span><span class=s1> at dest alias </span><span class=si>{</span><span class=n>destination_model_alias</span><span class=si>}</span><span class=s1> rel to cwd&#39;</span><span class=p>)</span>
+
+    <span class=c1># target_model filename - depends whether destination model is decomposed or not</span>
+    <span class=k>if</span> <span class=n>target_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model path does exist so target path is subdir with target alias </span><span class=si>{</span><span class=n>target_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>target_model_path</span> <span class=o>=</span> <span class=n>target_model_path</span> <span class=o>/</span> <span class=n>target_model_alias</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model filename does not exist so target path is target alias </span><span class=si>{</span><span class=n>target_model_alias</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>target_model_path</span> <span class=o>=</span> <span class=n>target_model_path</span> <span class=o>/</span> <span class=n>target_model_alias</span>  <span class=c1># FIXME this is same as above</span>
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;final target model path is </span><span class=si>{</span><span class=n>target_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=c1># if target model is a file then handle file. If file doesn&#39;t exist, handle the directory,</span>
+    <span class=c1># but in this case it&#39;s a list or a dict collection type</span>
+    <span class=n>target_model_filename</span> <span class=o>=</span> <span class=n>target_model_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>file_ext</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>target_model_filename</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model path with extension does exist so load distrib </span><span class=si>{</span><span class=n>target_model_filename</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>target_model_object</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>target_model_filename</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>target_model_filename</span> <span class=o>=</span> <span class=n>Path</span><span class=p>(</span><span class=n>target_model_path</span><span class=p>)</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;target model path plus extension does not exist so load distrib </span><span class=si>{</span><span class=n>target_model_filename</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get collection type for model type </span><span class=si>{</span><span class=n>target_model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>collection_type</span> <span class=o>=</span> <span class=n>type_utils</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>target_model_type</span><span class=p>)</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;load </span><span class=si>{</span><span class=n>target_model_filename</span><span class=si>}</span><span class=s1> as collection type </span><span class=si>{</span><span class=n>collection_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>target_model_object</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>target_model_filename</span><span class=p>,</span>
+                                                                <span class=n>trestle_root</span><span class=p>,</span> <span class=n>collection_type</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>target_model_object</span><span class=p>,</span> <span class=s1>&#39;__dict__&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>in</span> <span class=n>target_model_object</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>:</span>
+        <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=s1>&#39;loaded object has dict and root so set target model object to root contents&#39;</span><span class=p>)</span>
+        <span class=n>target_model_object</span> <span class=o>=</span> <span class=n>target_model_object</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>[</span><span class=s1>&#39;__root__&#39;</span><span class=p>]</span>
+    <span class=c1># 4. Insert target model into destination model.</span>
+    <span class=n>merged_dict</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>if</span> <span class=n>destination_model_object</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>merged_dict</span> <span class=o>=</span> <span class=n>destination_model_object</span><span class=o>.</span><span class=vm>__dict__</span>
+    <span class=n>merged_dict</span><span class=p>[</span><span class=n>target_model_alias</span><span class=p>]</span> <span class=o>=</span> <span class=n>target_model_object</span>
+    <span class=n>merged_model_object</span> <span class=o>=</span> <span class=n>merged_model_type</span><span class=p>(</span><span class=o>**</span><span class=n>merged_dict</span><span class=p>)</span>
+    <span class=n>merged_destination_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>merged_model_object</span><span class=p>)</span>
+    <span class=c1># 5. Create action  plan</span>
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;create path action clear content: </span><span class=si>{</span><span class=n>destination_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>reset_destination_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>destination_model_path</span><span class=p>,</span> <span class=n>clear_content</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;write file action </span><span class=si>{</span><span class=n>destination_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>write_destination_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span>
+        <span class=n>destination_model_path</span><span class=p>,</span> <span class=n>merged_destination_element</span><span class=p>,</span> <span class=n>content_type</span><span class=o>=</span><span class=n>file_type</span>
+    <span class=p>)</span>
+    <span class=c1># FIXME this will delete metadata.json but it will leave metadata/roles/roles.*</span>
+    <span class=c1># need to clean up all lower dirs</span>
+    <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;remove path action </span><span class=si>{</span><span class=n>target_model_filename</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>delete_target_action</span> <span class=o>=</span> <span class=n>RemovePathAction</span><span class=p>(</span><span class=n>target_model_filename</span><span class=p>)</span>
+
+    <span class=n>plan</span><span class=p>:</span> <span class=n>Plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+    <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>reset_destination_action</span><span class=p>)</span>
+    <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_destination_action</span><span class=p>)</span>
+    <span class=n>plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>delete_target_action</span><span class=p>)</span>
+
+    <span class=c1># TODO: Destination model directory is empty or already merged? Then clean up.</span>
+
+    <span class=k>return</span> <span class=n>plan</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.merge.MergeCmd.perform_all_merges class="doc doc-heading"> <code class="highlight language-python"><span class=n>perform_all_merges</span><span class=p>(</span><span class=n>element_paths</span><span class=p>,</span> <span class=n>effective_cwd</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.merge.MergeCmd.perform_all_merges class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Run all merges over a list of element paths.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/merge.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>perform_all_merges</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>effective_cwd</span><span class=p>:</span> <span class=n>Path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Run all merges over a list of element paths.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>element_path</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;merge </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>plan</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>merge</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>,</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>element_path</span><span class=p>),</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=n>plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.merge-functions>Functions<a href=#trestle.core.commands.merge-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/partial_object_validate/index.html b/latest/reference/API/trestle/core/commands/partial_object_validate/index.html
new file mode 100644
index 000000000..0c84aa834
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/partial_object_validate/index.html
@@ -0,0 +1,127 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.partial_object_validate module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/partial_object_validate/ rel=canonical><link href=../merge/ rel=prev><link href=../remove/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.partial_object_validate - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.partial_object_validate - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.partial_object_validate module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/partial_object_validate.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/partial_object_validate/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.partial_object_validate - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.partial_object_validate module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/partial_object_validate.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.partial_object_validate class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate class=md-nav__link> <span class=md-ellipsis> partial_object_validate </span> </a> <nav class=md-nav aria-label=partial_object_validate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate class=md-nav__link> <span class=md-ellipsis> PartialObjectValidate </span> </a> <nav class=md-nav aria-label=PartialObjectValidate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate.partial_object_validate class=md-nav__link> <span class=md-ellipsis> partial_object_validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate class=md-nav__link> <span class=md-ellipsis> partial_object_validate </span> </a> <nav class=md-nav aria-label=partial_object_validate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate class=md-nav__link> <span class=md-ellipsis> PartialObjectValidate </span> </a> <nav class=md-nav aria-label=PartialObjectValidate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate.partial_object_validate class=md-nav__link> <span class=md-ellipsis> partial_object_validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.partial_object_validate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.partial_object_validate</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.partial_object_validate class="doc doc-heading"> <code>trestle.core.commands.partial_object_validate</code> <a href=#trestle.core.commands.partial_object_validate class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle schema-validate command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.partial_object_validate-attributes>Attributes<a href=#trestle.core.commands.partial_object_validate-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.partial_object_validate.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.partial_object_validate.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.partial_object_validate-classes>Classes<a href=#trestle.core.commands.partial_object_validate-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.partial_object_validate.PartialObjectValidate class="doc doc-heading"> <code>PartialObjectValidate</code> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandBase href=../command_docs/#trestle.core.commands.command_docs.CommandBase>CommandBase</a></code></p> <p>Direct validation any oscal object in a file, including list objects.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/partial_object_validate.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PartialObjectValidate</span><span class=p>(</span><span class=n>CommandBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Direct validation any oscal object in a file, including list objects.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;partial-object-validate&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;-</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_FILE_SHORT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=sa>f</span><span class=s1>&#39;--</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_FILE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_DESC_FILE</span> <span class=o>+</span> <span class=s1>&#39; to validate&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+        <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;-</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT_SHORT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=sa>f</span><span class=s1>&#39;--</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_DESC_ELEMENT</span> <span class=o>+</span> <span class=s1>&#39; to validate.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-nv&#39;</span><span class=p>,</span> <span class=s1>&#39;--no-validators&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Only perform the most basic validation of the file&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>file</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>file_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;File path provided does not exist or is a directory&#39;</span><span class=p>)</span>
+
+            <span class=n>element_str</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>element</span>
+            <span class=k>if</span> <span class=s1>&#39;,&#39;</span> <span class=ow>in</span> <span class=n>element_str</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Only a single element path is allowed.&#39;</span><span class=p>)</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>partial_object_validate</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>element_str</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while validating OSCAL file&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>partial_object_validate</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>element_string</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Run a schema validation on a file inferring file type based on element string.&quot;&quot;&quot;</span>
+        <span class=c1># get model type</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Validating </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>element_path</span> <span class=o>=</span> <span class=n>elements</span><span class=o>.</span><span class=n>ElementPath</span><span class=p>(</span><span class=n>element_string</span><span class=p>)</span>
+        <span class=c1># get a wrapped object</span>
+        <span class=n>obm_type</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_obm_wrapped_type</span><span class=p>()</span>
+        <span class=n>obm_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> for </span><span class=si>{</span><span class=n>element_string</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.partial_object_validate.PartialObjectValidate-attributes>Attributes<a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.partial_object_validate.PartialObjectValidate.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;partial-object-validate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.partial_object_validate.PartialObjectValidate-functions>Functions<a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.partial_object_validate.PartialObjectValidate.partial_object_validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>partial_object_validate</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>element_string</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.partial_object_validate.PartialObjectValidate.partial_object_validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Run a schema validation on a file inferring file type based on element string.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/partial_object_validate.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>partial_object_validate</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>element_string</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Run a schema validation on a file inferring file type based on element string.&quot;&quot;&quot;</span>
+    <span class=c1># get model type</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Validating </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>element_path</span> <span class=o>=</span> <span class=n>elements</span><span class=o>.</span><span class=n>ElementPath</span><span class=p>(</span><span class=n>element_string</span><span class=p>)</span>
+    <span class=c1># get a wrapped object</span>
+    <span class=n>obm_type</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_obm_wrapped_type</span><span class=p>()</span>
+    <span class=n>obm_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> for </span><span class=si>{</span><span class=n>element_string</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.partial_object_validate-functions>Functions<a href=#trestle.core.commands.partial_object_validate-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/remove/index.html b/latest/reference/API/trestle/core/commands/remove/index.html
new file mode 100644
index 000000000..4c1ff2d5b
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/remove/index.html
@@ -0,0 +1,275 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.remove module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/remove/ rel=canonical><link href=../partial_object_validate/ rel=prev><link href=../replicate/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.remove - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.remove - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.remove module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/remove.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/remove/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.remove - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.remove module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/remove.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.remove class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.remove </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.remove </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.remove class=md-nav__link> <span class=md-ellipsis> remove </span> </a> <nav class=md-nav aria-label=remove> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.remove-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd class=md-nav__link> <span class=md-ellipsis> RemoveCmd </span> </a> <nav class=md-nav aria-label=RemoveCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd.remove class=md-nav__link> <span class=md-ellipsis> remove </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.remove class=md-nav__link> <span class=md-ellipsis> remove </span> </a> <nav class=md-nav aria-label=remove> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.remove-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd class=md-nav__link> <span class=md-ellipsis> RemoveCmd </span> </a> <nav class=md-nav aria-label=RemoveCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.remove.RemoveCmd.remove class=md-nav__link> <span class=md-ellipsis> remove </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.remove</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.remove class="doc doc-heading"> <code>trestle.core.commands.remove</code> <a href=#trestle.core.commands.remove class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Remove Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.remove-attributes>Attributes<a href=#trestle.core.commands.remove-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.remove.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.remove.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.remove-classes>Classes<a href=#trestle.core.commands.remove-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.remove.RemoveCmd class="doc doc-heading"> <code>RemoveCmd</code> <a href=#trestle.core.commands.remove.RemoveCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Remove a subcomponent from an existing model.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/remove.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RemoveCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove a subcomponent from an existing model.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;remove&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;-</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_FILE_SHORT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=sa>f</span><span class=s1>&#39;--</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_FILE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_DESC_FILE</span> <span class=o>+</span> <span class=s1>&#39; to remove component/subcomponent to.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;-</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT_SHORT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=sa>f</span><span class=s1>&#39;--</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_DESC_ELEMENT</span> <span class=o>+</span> <span class=s1>&#39; to remove.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>True</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Remove an OSCAL component/subcomponent to the specified component.</span>
+
+<span class=sd>        This method takes input a filename and a list of comma-seperated element path. Element paths are field aliases.</span>
+<span class=sd>        The method first finds the parent model from the file and loads the file into the model.</span>
+<span class=sd>        Then the method executes &#39;remove&#39; for each of the element paths specified.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>args_dict</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=vm>__dict__</span>
+
+            <span class=n>file_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_FILE</span><span class=p>])</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+            <span class=n>relative_path</span> <span class=o>=</span> <span class=n>file_path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+            <span class=c1># Get parent model and then load json into parent model</span>
+            <span class=n>parent_model</span><span class=p>,</span> <span class=n>parent_alias</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_relative_model_type</span><span class=p>(</span><span class=n>relative_path</span><span class=p>)</span>
+
+            <span class=n>parent_object</span> <span class=o>=</span> <span class=n>parent_model</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+            <span class=n>parent_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>parent_object</span><span class=p>,</span> <span class=n>parent_alias</span><span class=p>)</span>
+
+            <span class=n>add_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+
+            <span class=c1># Do _remove for each element_path specified in args</span>
+            <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>args_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT</span><span class=p>])</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>elm_path_str</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+                <span class=n>element_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>elm_path_str</span><span class=p>)</span>
+                <span class=n>remove_action</span><span class=p>,</span> <span class=n>parent_element</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>)</span>
+                <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>remove_action</span><span class=p>)</span>
+
+            <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+            <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>,</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>))</span>
+            <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>remove_action</span><span class=p>)</span>
+            <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+            <span class=n>add_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+
+            <span class=n>add_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>err</span><span class=o>.</span><span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while removing OSCAL component&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>remove</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>:</span> <span class=n>Element</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>RemoveAction</span><span class=p>,</span> <span class=n>Element</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;For the element_path, remove a model from the parent_element of a given parent_model.</span>
+
+<span class=sd>        First we check if there is an existing element at that path</span>
+<span class=sd>        If not, we complain.</span>
+<span class=sd>        Then we set up an action plan to update the model (specified by file_path) in memory,</span>
+<span class=sd>        return the action and return the parent_element.</span>
+
+<span class=sd>        LIMITATIONS:</span>
+<span class=sd>        1. This does not remove elements of a list or dict. Instead, the entire list or dict is removed.</span>
+<span class=sd>        2. This cannot remove arbitrarily named elements that are not specified in the schema.</span>
+<span class=sd>        For example, &quot;responsible-parties&quot; contains named elements, e.g., &quot;organisation&quot;. The tool will not</span>
+<span class=sd>        remove the &quot;organisation&quot; as it is not in the schema, but one can remove its elements, e.g., &quot;party-uuids&quot;.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>element_path_list</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+        <span class=k>if</span> <span class=s1>&#39;*&#39;</span> <span class=ow>in</span> <span class=n>element_path_list</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;trestle remove does not support Wildcard element path.&#39;</span><span class=p>)</span>
+
+        <span class=n>deleting_element</span> <span class=o>=</span> <span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>deleting_element</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=c1># The element already exists</span>
+            <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>deleting_element</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=s1>&#39;Warning: trestle remove does not support removing elements of a list: &#39;</span>
+                    <span class=s1>&#39;this removes the entire list&#39;</span>
+                <span class=p>)</span>
+            <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>deleting_element</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=s1>&#39;Warning: trestle remove does not support removing dict elements: &#39;</span>
+                    <span class=s1>&#39;this removes the entire dict element&#39;</span>
+                <span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Bad element path: </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>remove_action</span> <span class=o>=</span> <span class=n>RemoveAction</span><span class=p>(</span><span class=n>parent_element</span><span class=p>,</span> <span class=n>element_path</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>remove_action</span><span class=p>,</span> <span class=n>parent_element</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.remove.RemoveCmd-attributes>Attributes<a href=#trestle.core.commands.remove.RemoveCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.remove.RemoveCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;remove&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.remove.RemoveCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.remove.RemoveCmd-functions>Functions<a href=#trestle.core.commands.remove.RemoveCmd-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.remove.RemoveCmd.remove class="doc doc-heading"> <code class="highlight language-python"><span class=n>remove</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.remove.RemoveCmd.remove class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>For the element_path, remove a model from the parent_element of a given parent_model.</p> <p>First we check if there is an existing element at that path If not, we complain. Then we set up an action plan to update the model (specified by file_path) in memory, return the action and return the parent_element.</p> <p>LIMITATIONS: 1. This does not remove elements of a list or dict. Instead, the entire list or dict is removed. 2. This cannot remove arbitrarily named elements that are not specified in the schema. For example, "responsible-parties" contains named elements, e.g., "organisation". The tool will not remove the "organisation" as it is not in the schema, but one can remove its elements, e.g., "party-uuids".</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/remove.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>remove</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>,</span> <span class=n>parent_element</span><span class=p>:</span> <span class=n>Element</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>RemoveAction</span><span class=p>,</span> <span class=n>Element</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;For the element_path, remove a model from the parent_element of a given parent_model.</span>
+
+<span class=sd>    First we check if there is an existing element at that path</span>
+<span class=sd>    If not, we complain.</span>
+<span class=sd>    Then we set up an action plan to update the model (specified by file_path) in memory,</span>
+<span class=sd>    return the action and return the parent_element.</span>
+
+<span class=sd>    LIMITATIONS:</span>
+<span class=sd>    1. This does not remove elements of a list or dict. Instead, the entire list or dict is removed.</span>
+<span class=sd>    2. This cannot remove arbitrarily named elements that are not specified in the schema.</span>
+<span class=sd>    For example, &quot;responsible-parties&quot; contains named elements, e.g., &quot;organisation&quot;. The tool will not</span>
+<span class=sd>    remove the &quot;organisation&quot; as it is not in the schema, but one can remove its elements, e.g., &quot;party-uuids&quot;.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>element_path_list</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+    <span class=k>if</span> <span class=s1>&#39;*&#39;</span> <span class=ow>in</span> <span class=n>element_path_list</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;trestle remove does not support Wildcard element path.&#39;</span><span class=p>)</span>
+
+    <span class=n>deleting_element</span> <span class=o>=</span> <span class=n>parent_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>deleting_element</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=c1># The element already exists</span>
+        <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>deleting_element</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                <span class=s1>&#39;Warning: trestle remove does not support removing elements of a list: &#39;</span>
+                <span class=s1>&#39;this removes the entire list&#39;</span>
+            <span class=p>)</span>
+        <span class=k>elif</span> <span class=nb>type</span><span class=p>(</span><span class=n>deleting_element</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                <span class=s1>&#39;Warning: trestle remove does not support removing dict elements: &#39;</span>
+                <span class=s1>&#39;this removes the entire dict element&#39;</span>
+            <span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Bad element path: </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>remove_action</span> <span class=o>=</span> <span class=n>RemoveAction</span><span class=p>(</span><span class=n>parent_element</span><span class=p>,</span> <span class=n>element_path</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>remove_action</span><span class=p>,</span> <span class=n>parent_element</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/replicate/index.html b/latest/reference/API/trestle/core/commands/replicate/index.html
new file mode 100644
index 000000000..6797ad60a
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/replicate/index.html
@@ -0,0 +1,277 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.replicate module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/replicate/ rel=canonical><link href=../remove/ rel=prev><link href=../split/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.replicate - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.replicate - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.replicate module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/replicate.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/replicate/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.replicate - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.replicate module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/replicate.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.replicate class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.replicate </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.replicate </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.replicate class=md-nav__link> <span class=md-ellipsis> replicate </span> </a> <nav class=md-nav aria-label=replicate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.replicate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd class=md-nav__link> <span class=md-ellipsis> ReplicateCmd </span> </a> <nav class=md-nav aria-label=ReplicateCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd.replicate_object class=md-nav__link> <span class=md-ellipsis> replicate_object </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.replicate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.replicate class=md-nav__link> <span class=md-ellipsis> replicate </span> </a> <nav class=md-nav aria-label=replicate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.replicate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd class=md-nav__link> <span class=md-ellipsis> ReplicateCmd </span> </a> <nav class=md-nav aria-label=ReplicateCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.replicate.ReplicateCmd.replicate_object class=md-nav__link> <span class=md-ellipsis> replicate_object </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.replicate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.replicate</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.replicate class="doc doc-heading"> <code>trestle.core.commands.replicate</code> <a href=#trestle.core.commands.replicate class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Replicate Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.replicate-attributes>Attributes<a href=#trestle.core.commands.replicate-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.replicate.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.replicate.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.replicate-classes>Classes<a href=#trestle.core.commands.replicate-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.replicate.ReplicateCmd class="doc doc-heading"> <code>ReplicateCmd</code> <a href=#trestle.core.commands.replicate.ReplicateCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Replicate a top level model within the trestle directory structure.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/replicate.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ReplicateCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Replicate a top level model within the trestle directory structure.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;replicate&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Init arguments&#39;</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;model&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Choose OSCAL model&#39;</span><span class=p>,</span> <span class=n>choices</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of model to replicate.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-o&#39;</span><span class=p>,</span> <span class=s1>&#39;--output&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of replicated model.&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-r&#39;</span><span class=p>,</span> <span class=s1>&#39;--regenerate&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>HELP_REGENERATE</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute and process the args.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>replicate_object</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>model</span><span class=p>,</span> <span class=n>args</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while replicating model&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>replicate_object</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Core replicate routine invoked by subcommands.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            model_alias: Name of the top level model in the trestle directory.</span>
+<span class=sd>            args: CLI arguments</span>
+<span class=sd>        Returns:</span>
+<span class=sd>            A return code that can be used as standard posix codes. 0 is success.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Entering replicate_object.&#39;</span><span class=p>)</span>
+
+        <span class=c1># 1 Bad working directory if not running from current working directory</span>
+        <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>  <span class=c1># trestle root is set via command line in args. Default is cwd.</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>trestle_root</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory: </span><span class=si>{</span><span class=n>trestle_root</span><span class=si>}</span><span class=s1> is not a trestle project.&#39;</span><span class=p>)</span>
+
+        <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+        <span class=c1># 2 Check that input file given exists.</span>
+
+        <span class=n>input_file_stem</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span> <span class=o>/</span> <span class=n>model_alias</span>
+        <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>input_file_stem</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Input file </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> has no json or yaml file at expected location </span><span class=si>{</span><span class=n>input_file_stem</span><span class=si>}</span><span class=s1>.&#39;</span>
+            <span class=p>)</span>
+
+        <span class=n>input_file</span> <span class=o>=</span> <span class=n>input_file_stem</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>))</span>
+
+        <span class=c1># 3 Distributed load from file</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>,</span> <span class=n>model_instance</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>input_file</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+
+        <span class=n>rep_model_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span> <span class=o>/</span> <span class=p>(</span>
+            <span class=n>model_alias</span> <span class=o>+</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+        <span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>rep_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;OSCAL file to be replicated here: </span><span class=si>{</span><span class=n>rep_model_path</span><span class=si>}</span><span class=s1> exists.&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>regenerate</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;regenerating uuids for model </span><span class=si>{</span><span class=n>input_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>model_instance</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>,</span> <span class=n>n_refs_updated</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>model_instance</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>uuid_lut</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids generated and </span><span class=si>{</span><span class=n>n_refs_updated</span><span class=si>}</span><span class=s1> references updated&#39;</span><span class=p>)</span>
+
+        <span class=c1># 4 Prepare actions and plan</span>
+        <span class=n>top_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model_instance</span><span class=p>)</span>
+        <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>rep_model_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>rep_model_path</span><span class=p>,</span> <span class=n>top_element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+
+        <span class=c1># create a plan to create the directory and imported file.</span>
+        <span class=n>replicate_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=n>replicate_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+        <span class=n>replicate_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+
+        <span class=n>replicate_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.replicate.ReplicateCmd-attributes>Attributes<a href=#trestle.core.commands.replicate.ReplicateCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.replicate.ReplicateCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;replicate&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.replicate.ReplicateCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.replicate.ReplicateCmd-functions>Functions<a href=#trestle.core.commands.replicate.ReplicateCmd-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.replicate.ReplicateCmd.replicate_object class="doc doc-heading"> <code class="highlight language-python"><span class=n>replicate_object</span><span class=p>(</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>args</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.replicate.ReplicateCmd.replicate_object class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Core replicate routine invoked by subcommands.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model_alias</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Name of the top level model in the trestle directory.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>args</code> </td> <td> <code><span title=argparse.Namespace>Namespace</span></code> </td> <td> <div class=doc-md-description> <p>CLI arguments</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p>Returns: A return code that can be used as standard posix codes. 0 is success.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/replicate.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>replicate_object</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Core replicate routine invoked by subcommands.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        model_alias: Name of the top level model in the trestle directory.</span>
+<span class=sd>        args: CLI arguments</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        A return code that can be used as standard posix codes. 0 is success.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Entering replicate_object.&#39;</span><span class=p>)</span>
+
+    <span class=c1># 1 Bad working directory if not running from current working directory</span>
+    <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>  <span class=c1># trestle root is set via command line in args. Default is cwd.</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>trestle_root</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory: </span><span class=si>{</span><span class=n>trestle_root</span><span class=si>}</span><span class=s1> is not a trestle project.&#39;</span><span class=p>)</span>
+
+    <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+    <span class=c1># 2 Check that input file given exists.</span>
+
+    <span class=n>input_file_stem</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span> <span class=o>/</span> <span class=n>model_alias</span>
+    <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>input_file_stem</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Input file </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> has no json or yaml file at expected location </span><span class=si>{</span><span class=n>input_file_stem</span><span class=si>}</span><span class=s1>.&#39;</span>
+        <span class=p>)</span>
+
+    <span class=n>input_file</span> <span class=o>=</span> <span class=n>input_file_stem</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>))</span>
+
+    <span class=c1># 3 Distributed load from file</span>
+    <span class=n>_</span><span class=p>,</span> <span class=n>model_alias</span><span class=p>,</span> <span class=n>model_instance</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>input_file</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+
+    <span class=n>rep_model_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>output</span> <span class=o>/</span> <span class=p>(</span>
+        <span class=n>model_alias</span> <span class=o>+</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+    <span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>rep_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;OSCAL file to be replicated here: </span><span class=si>{</span><span class=n>rep_model_path</span><span class=si>}</span><span class=s1> exists.&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>regenerate</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;regenerating uuids for model </span><span class=si>{</span><span class=n>input_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>model_instance</span><span class=p>,</span> <span class=n>uuid_lut</span><span class=p>,</span> <span class=n>n_refs_updated</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>regenerate_uuids</span><span class=p>(</span><span class=n>model_instance</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>uuid_lut</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids generated and </span><span class=si>{</span><span class=n>n_refs_updated</span><span class=si>}</span><span class=s1> references updated&#39;</span><span class=p>)</span>
+
+    <span class=c1># 4 Prepare actions and plan</span>
+    <span class=n>top_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model_instance</span><span class=p>)</span>
+    <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>rep_model_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+    <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>rep_model_path</span><span class=p>,</span> <span class=n>top_element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+
+    <span class=c1># create a plan to create the directory and imported file.</span>
+    <span class=n>replicate_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+    <span class=n>replicate_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+    <span class=n>replicate_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+
+    <span class=n>replicate_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.replicate-functions>Functions<a href=#trestle.core.commands.replicate-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/split/index.html b/latest/reference/API/trestle/core/commands/split/index.html
new file mode 100644
index 000000000..d88ea1749
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/split/index.html
@@ -0,0 +1,1670 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.split module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/split/ rel=canonical><link href=../replicate/ rel=prev><link href=../task/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.split - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.split - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.split module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/split.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/split/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.split - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.split module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/split.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.split class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.split </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.split </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.split </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.split class=md-nav__link> <span class=md-ellipsis> split </span> </a> <nav class=md-nav aria-label=split> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.trace class=md-nav__link> <span class=md-ellipsis> trace </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker class=md-nav__link> <span class=md-ellipsis> AliasTracker </span> </a> <nav class=md-nav aria-label=AliasTracker> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.aliases class=md-nav__link> <span class=md-ellipsis> aliases </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.written class=md-nav__link> <span class=md-ellipsis> written </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.add_alias class=md-nav__link> <span class=md-ellipsis> add_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.get_aliases class=md-nav__link> <span class=md-ellipsis> get_aliases </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.mark_written class=md-nav__link> <span class=md-ellipsis> mark_written </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.needs_writing class=md-nav__link> <span class=md-ellipsis> needs_writing </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd class=md-nav__link> <span class=md-ellipsis> SplitCmd </span> </a> <nav class=md-nav aria-label=SplitCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.find_aliases_to_strip class=md-nav__link> <span class=md-ellipsis> find_aliases_to_strip </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.perform_split class=md-nav__link> <span class=md-ellipsis> perform_split </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.prepare_sub_model_split_actions class=md-nav__link> <span class=md-ellipsis> prepare_sub_model_split_actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.split_model class=md-nav__link> <span class=md-ellipsis> split_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.split_model_at_path_chain class=md-nav__link> <span class=md-ellipsis> split_model_at_path_chain </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.split class=md-nav__link> <span class=md-ellipsis> split </span> </a> <nav class=md-nav aria-label=split> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.trace class=md-nav__link> <span class=md-ellipsis> trace </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker class=md-nav__link> <span class=md-ellipsis> AliasTracker </span> </a> <nav class=md-nav aria-label=AliasTracker> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.aliases class=md-nav__link> <span class=md-ellipsis> aliases </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.written class=md-nav__link> <span class=md-ellipsis> written </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.add_alias class=md-nav__link> <span class=md-ellipsis> add_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.get_aliases class=md-nav__link> <span class=md-ellipsis> get_aliases </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.mark_written class=md-nav__link> <span class=md-ellipsis> mark_written </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.AliasTracker.needs_writing class=md-nav__link> <span class=md-ellipsis> needs_writing </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd class=md-nav__link> <span class=md-ellipsis> SplitCmd </span> </a> <nav class=md-nav aria-label=SplitCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.find_aliases_to_strip class=md-nav__link> <span class=md-ellipsis> find_aliases_to_strip </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.perform_split class=md-nav__link> <span class=md-ellipsis> perform_split </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.prepare_sub_model_split_actions class=md-nav__link> <span class=md-ellipsis> prepare_sub_model_split_actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.split_model class=md-nav__link> <span class=md-ellipsis> split_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split.SplitCmd.split_model_at_path_chain class=md-nav__link> <span class=md-ellipsis> split_model_at_path_chain </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.split-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.split</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.split class="doc doc-heading"> <code>trestle.core.commands.split</code> <a href=#trestle.core.commands.split class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Split Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.split-attributes>Attributes<a href=#trestle.core.commands.split-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.split.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.split.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.split.trace class="doc doc-heading"> <code class="highlight language-python"><span class=n>trace</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>Trace</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.split.trace class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.split-classes>Classes<a href=#trestle.core.commands.split-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.split.AliasTracker class="doc doc-heading"> <code>AliasTracker</code> <a href=#trestle.core.commands.split.AliasTracker class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.trestle_base_model.TrestleBaseModel href=../../trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel>TrestleBaseModel</a></code></p> <p>Convenience class to track writing out of models.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AliasTracker</span><span class=p>(</span><span class=n>TrestleBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convenience class to track writing out of models.&quot;&quot;&quot;</span>
+
+    <span class=c1># This tracks the parts that need to be split from each element</span>
+    <span class=c1># and makes sure it is written out once</span>
+
+    <span class=n>aliases</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=n>written</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=k>def</span> <span class=nf>add_alias</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add alias.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>alias</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>aliases</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>aliases</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>alias</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_aliases</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the list of aliases.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>aliases</span>
+
+    <span class=k>def</span> <span class=nf>needs_writing</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Need to write the model.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>written</span>
+
+    <span class=k>def</span> <span class=nf>mark_written</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Mark this model as written.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>written</span> <span class=o>=</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.split.AliasTracker-attributes>Attributes<a href=#trestle.core.commands.split.AliasTracker-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.split.AliasTracker.aliases class="doc doc-heading"> <code class="highlight language-python"><span class=n>aliases</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.split.AliasTracker.aliases class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.split.AliasTracker.written class="doc doc-heading"> <code class="highlight language-python"><span class=n>written</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.split.AliasTracker.written class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.split.AliasTracker-functions>Functions<a href=#trestle.core.commands.split.AliasTracker-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.split.AliasTracker.add_alias class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_alias</span><span class=p>(</span><span class=n>alias</span><span class=p>)</span></code> <a href=#trestle.core.commands.split.AliasTracker.add_alias class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add alias.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_alias</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>alias</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add alias.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>alias</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>aliases</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>aliases</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>alias</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.split.AliasTracker.get_aliases class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_aliases</span><span class=p>()</span></code> <a href=#trestle.core.commands.split.AliasTracker.get_aliases class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the list of aliases.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_aliases</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the list of aliases.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>aliases</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.split.AliasTracker.mark_written class="doc doc-heading"> <code class="highlight language-python"><span class=n>mark_written</span><span class=p>()</span></code> <a href=#trestle.core.commands.split.AliasTracker.mark_written class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Mark this model as written.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>mark_written</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Mark this model as written.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>written</span> <span class=o>=</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.split.AliasTracker.needs_writing class="doc doc-heading"> <code class="highlight language-python"><span class=n>needs_writing</span><span class=p>()</span></code> <a href=#trestle.core.commands.split.AliasTracker.needs_writing class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Need to write the model.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>needs_writing</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Need to write the model.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>written</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.split.SplitCmd class="doc doc-heading"> <code>SplitCmd</code> <a href=#trestle.core.commands.split.SplitCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Split subcomponents on a trestle model.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SplitCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Split subcomponents on a trestle model.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;split&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;-</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_FILE_SHORT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;--</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_FILE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_DESC_FILE</span> <span class=o>+</span> <span class=s1>&#39; to split.&#39;</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;-</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT_SHORT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=sa>f</span><span class=s1>&#39;--</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_DESC_ELEMENT</span> <span class=o>+</span> <span class=s1>&#39; to split.&#39;</span><span class=p>,</span>
+            <span class=n>required</span><span class=o>=</span><span class=kc>False</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Split an OSCAL file into elements.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=n>trace</span><span class=o>.</span><span class=n>log</span><span class=p>(</span><span class=s1>&#39;Entering trestle split.&#39;</span><span class=p>)</span>
+            <span class=c1># get the Model</span>
+            <span class=n>args_raw</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=vm>__dict__</span>
+
+            <span class=c1># remove any quotes passed in as on windows platforms</span>
+            <span class=n>elements_clean</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>args_raw</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_ELEMENT</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s2>&quot;&#39;&quot;</span><span class=p>)</span>
+
+            <span class=n>file_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=n>file_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>args_raw</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_FILE</span><span class=p>]</span> <span class=k>else</span> <span class=n>args_raw</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>ARG_FILE</span><span class=p>]</span>
+            <span class=c1># cwd must be in the model directory if file to split is not specified</span>
+            <span class=n>effective_cwd</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=o>.</span><span class=n>cwd</span><span class=p>()</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>perform_split</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>,</span> <span class=n>file_name</span><span class=p>,</span> <span class=n>elements_clean</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while performing a split operation&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>perform_split</span><span class=p>(</span>
+        <span class=bp>cls</span><span class=p>,</span> <span class=n>effective_cwd</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>file_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>elements</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Perform the split operation.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            effective_cwd: effective directory in which the the split operation is performed</span>
+<span class=sd>            file_name: file name of model to split, or &#39;&#39; if deduced from elements and cwd</span>
+<span class=sd>            elements: comma separated list of paths to strip from the file, with quotes removed</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            0 on success and 1 on failure</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>file_path_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=k>if</span> <span class=n>file_name</span><span class=p>:</span>
+            <span class=n>file_path_list</span><span class=o>.</span><span class=n>append</span><span class=p>((</span><span class=n>file_name</span><span class=p>,</span> <span class=n>elements</span><span class=p>))</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># cwd must be in the model directory if file to split is not specified</span>
+            <span class=c1># find top directory for this model based on trestle root and cwd</span>
+            <span class=n>model_dir</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>extract_project_model_path</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>model_dir</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Current directory must be within a model directory if file is not specified&#39;</span><span class=p>)</span>
+
+            <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>dir_to_content_type</span><span class=p>(</span><span class=n>model_dir</span><span class=p>)</span>
+
+            <span class=c1># determine the file needed for each split path</span>
+            <span class=n>element_paths</span> <span class=o>=</span> <span class=n>elements</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>path</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+                <span class=n>element_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+                <span class=c1># if element path is relative use directory context to determine absolute path</span>
+                <span class=n>element_path</span><span class=o>.</span><span class=n>make_absolute</span><span class=p>(</span><span class=n>model_dir</span><span class=p>,</span> <span class=n>effective_cwd</span><span class=p>)</span>
+                <span class=n>file_path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>find_last_file_in_path</span><span class=p>(</span><span class=n>content_type</span><span class=p>,</span> <span class=n>model_dir</span><span class=p>)</span>
+                <span class=c1># now make the element path relative to the model file to be loaded</span>
+                <span class=k>if</span> <span class=n>file_path</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>or</span> <span class=n>element_path</span><span class=o>.</span><span class=n>make_relative</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>model_dir</span><span class=p>))</span> <span class=o>!=</span> <span class=mi>0</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to match element path with files in model directory </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+                <span class=n>file_path_list</span><span class=o>.</span><span class=n>append</span><span class=p>((</span><span class=n>file_path</span><span class=p>,</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_string</span><span class=p>()))</span>
+
+        <span class=c1># match paths to corresponding files since several paths may be split from the same file</span>
+        <span class=n>file_path_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>file_path</span> <span class=ow>in</span> <span class=n>file_path_list</span><span class=p>:</span>
+            <span class=n>key</span> <span class=o>=</span> <span class=n>file_path</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>  <span class=c1># type: ignore</span>
+            <span class=n>path</span> <span class=o>=</span> <span class=n>file_path</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>  <span class=c1># type: ignore</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>file_path_dict</span><span class=p>:</span>
+                <span class=n>file_path_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>path</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>current_path</span> <span class=o>=</span> <span class=n>file_path_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+                <span class=n>file_path_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>current_path</span><span class=si>}</span><span class=s1>,</span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1>&#39;</span>
+
+        <span class=k>for</span> <span class=n>raw_file_name</span><span class=p>,</span> <span class=n>element_path</span> <span class=ow>in</span> <span class=n>file_path_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>file_path</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>relative_resolve</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>raw_file_name</span><span class=p>),</span> <span class=n>effective_cwd</span><span class=p>)</span>
+            <span class=c1># this makes assumptions that the path is relative.</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+            <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+
+            <span class=c1># find the base directory of the file</span>
+            <span class=n>base_dir</span> <span class=o>=</span> <span class=n>file_path</span><span class=o>.</span><span class=n>parent</span>
+            <span class=n>model_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+
+            <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>cmd_utils</span><span class=o>.</span><span class=n>split_is_too_fine</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>model</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot split the model to the level of uuids, strings, etc.&#39;</span><span class=p>)</span>
+
+            <span class=c1># use the model itself to resolve any wildcards and create list of element paths</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;split calling parse_element_args on </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=c1># use contextual mode to parse</span>
+
+            <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>]</span> <span class=o>=</span> <span class=n>cmd_utils</span><span class=o>.</span><span class=n>parse_element_args</span><span class=p>(</span>
+                <span class=n>model</span><span class=p>,</span> <span class=n>element_path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>),</span> <span class=n>base_dir</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>)</span>
+            <span class=p>)</span>
+
+            <span class=c1># analyze the split tree and determine which aliases should be stripped from each file</span>
+            <span class=n>aliases_to_strip</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>find_aliases_to_strip</span><span class=p>(</span><span class=n>element_paths</span><span class=p>)</span>
+
+            <span class=c1># need the file name relative to the base directory</span>
+            <span class=n>file_name_no_path</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+
+            <span class=n>split_plan</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>split_model</span><span class=p>(</span>
+                <span class=n>model</span><span class=p>,</span> <span class=n>element_paths</span><span class=p>,</span> <span class=n>base_dir</span><span class=p>,</span> <span class=n>content_type</span><span class=p>,</span> <span class=n>file_name_no_path</span><span class=p>,</span> <span class=n>aliases_to_strip</span>
+            <span class=p>)</span>
+            <span class=n>trash</span><span class=o>.</span><span class=n>store</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>split_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                <span class=n>trash</span><span class=o>.</span><span class=n>recover</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Split has failed with error: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>prepare_sub_model_split_actions</span><span class=p>(</span>
+        <span class=bp>cls</span><span class=p>,</span>
+        <span class=n>sub_model_item</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span>
+        <span class=n>sub_model_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>file_prefix</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create split actions of sub model.&quot;&quot;&quot;</span>
+        <span class=n>actions</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>file_name</span> <span class=o>=</span> <span class=n>cmd_utils</span><span class=o>.</span><span class=n>to_model_file_name</span><span class=p>(</span><span class=n>sub_model_item</span><span class=p>,</span> <span class=n>file_prefix</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+        <span class=n>model_type</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>sub_model_item</span><span class=p>)</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=n>sub_model_file</span> <span class=o>=</span> <span class=n>sub_model_dir</span> <span class=o>/</span> <span class=n>file_name</span>
+        <span class=n>actions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>sub_model_file</span><span class=p>))</span>
+        <span class=n>actions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>WriteFileAction</span><span class=p>(</span><span class=n>sub_model_file</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>sub_model_item</span><span class=p>,</span> <span class=n>model_type</span><span class=p>),</span> <span class=n>content_type</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>actions</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>split_model_at_path_chain</span><span class=p>(</span>
+        <span class=bp>cls</span><span class=p>,</span>
+        <span class=n>model_obj</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span>
+        <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>],</span>
+        <span class=n>base_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>,</span>
+        <span class=n>cur_path_index</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+        <span class=n>split_plan</span><span class=p>:</span> <span class=n>Plan</span><span class=p>,</span>
+        <span class=n>strip_root</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>root_file_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>aliases_to_strip</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>AliasTracker</span><span class=p>],</span>
+        <span class=n>last_one</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Recursively split the model at the provided chain of element paths.</span>
+
+<span class=sd>        It assumes that a chain of element paths starts at the cur_path_index with the first path ending</span>
+<span class=sd>        with a wildcard (*)</span>
+
+<span class=sd>        If the wildcard follows an element that is inherently a list of items, the list of items is extracted.</span>
+<span class=sd>        But if the wildcard follows a generic model than members of that model class found in the model will be</span>
+<span class=sd>        split off.  But only the non-trivial elements are removed, i.e. not str, int, datetime, etc.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            model_obj: The OscalBaseModel to be split</span>
+<span class=sd>            element_paths: The List[ElementPath] of elements to split, including embedded wildcards</span>
+<span class=sd>            base_dir: pathlib.Path of the file being split</span>
+<span class=sd>            content_type: json or yaml files</span>
+<span class=sd>            cur_path_index: Index into the list of element paths for the current split operation</span>
+<span class=sd>            split_plan: The accumulated plan of actions needed to perform the split</span>
+<span class=sd>            strip_root: Whether to strip elements from the root object</span>
+<span class=sd>            root_file_name: Filename of root file that gets split into a list of items</span>
+<span class=sd>            aliases_to_strip: AliasTracker previously loaded with aliases that need to be split from each element</span>
+<span class=sd>            last_one: bool indicating last item in array has been split and stripped model can now be written</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            int representing the index where the chain of the path ends.</span>
+
+<span class=sd>        Examples:</span>
+<span class=sd>            For example, element paths could have a list of paths as below for a `ComponentDefinition` model where</span>
+<span class=sd>            the first path is the start of the chain.</span>
+
+<span class=sd>            For each of the sub model described by the first element path (e.g component-defintion.components.*) in the</span>
+<span class=sd>            chain, the subsequent paths (e.g component.control-implementations.*) will be applied recursively</span>
+<span class=sd>            to retrieve the sub-sub models:</span>
+<span class=sd>            [</span>
+<span class=sd>                &#39;component-definition.component.*&#39;,</span>
+<span class=sd>                &#39;component.control-implementations.*&#39;</span>
+<span class=sd>            ]</span>
+<span class=sd>            for a command like below:</span>
+<span class=sd>            trestle split -f component.yaml -e component-definition.components.*.control-implementations.*</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>split_plan</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Split plan must have been initialized&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>cur_path_index</span> <span class=o>&lt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Current index of the chain of paths cannot be less than 0&#39;</span><span class=p>)</span>
+
+        <span class=c1># if there are no more element_paths, return the current plan</span>
+        <span class=k>if</span> <span class=n>cur_path_index</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>cur_path_index</span>
+
+        <span class=c1># initialize local variables</span>
+        <span class=n>element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model_obj</span><span class=p>)</span>
+        <span class=n>stripped_field_alias</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=c1># get the sub_model specified by the element_path of this round</span>
+        <span class=n>element_path</span> <span class=o>=</span> <span class=n>element_paths</span><span class=p>[</span><span class=n>cur_path_index</span><span class=p>]</span>
+
+        <span class=c1># does the next element_path point back at me</span>
+        <span class=n>is_parent</span> <span class=o>=</span> <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>)</span> <span class=ow>and</span> <span class=n>element_paths</span><span class=p>[</span><span class=n>cur_path_index</span>
+                                                                              <span class=o>+</span> <span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span> <span class=o>==</span> <span class=n>element_path</span>
+
+        <span class=c1># root dir name for sub models dir</span>
+        <span class=c1># 00000__group.json will have the root_dir name as 00000__group for sub models of group</span>
+        <span class=c1># catalog.json will have the root_dir name as catalog</span>
+        <span class=n>root_dir</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>if</span> <span class=n>root_file_name</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+            <span class=n>root_dir</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>root_file_name</span><span class=p>)</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>))</span>
+
+        <span class=n>sub_models</span> <span class=o>=</span> <span class=n>element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>  <span class=c1># we call sub_models as in plural, but it can be just one</span>
+
+        <span class=c1># assume cur_path_index is the end of the chain</span>
+        <span class=c1># value of this variable may change during recursive split of the sub-models below</span>
+        <span class=n>path_chain_end</span> <span class=o>=</span> <span class=n>cur_path_index</span>
+
+        <span class=c1># if wildcard is present in the element_path and the next path in the chain has current path as the parent,</span>
+        <span class=c1># Then deal with case of list, or split of arbitrary oscalbasemodel</span>
+        <span class=k>if</span> <span class=n>is_parent</span> <span class=ow>and</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=ow>is</span> <span class=ow>not</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=c1># create dir for all sub model items</span>
+            <span class=n>sub_models_dir</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_root_path</span><span class=p>()</span>
+            <span class=n>sub_model_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+            <span class=n>path_chain_end</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>split_model_at_path_chain</span><span class=p>(</span>
+                <span class=n>sub_models</span><span class=p>,</span>
+                <span class=n>element_paths</span><span class=p>,</span>
+                <span class=n>sub_models_dir</span><span class=p>,</span>
+                <span class=n>content_type</span><span class=p>,</span>
+                <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span>
+                <span class=n>sub_model_plan</span><span class=p>,</span>
+                <span class=kc>True</span><span class=p>,</span>
+                <span class=s1>&#39;&#39;</span><span class=p>,</span>
+                <span class=n>aliases_to_strip</span>
+            <span class=p>)</span>
+            <span class=n>sub_model_actions</span> <span class=o>=</span> <span class=n>sub_model_plan</span><span class=o>.</span><span class=n>get_actions</span><span class=p>()</span>
+            <span class=n>split_plan</span><span class=o>.</span><span class=n>add_actions</span><span class=p>(</span><span class=n>sub_model_actions</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=c1># extract sub-models into a dict with appropriate prefix</span>
+            <span class=n>sub_model_items</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=n>sub_models_dir</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_file_path</span><span class=p>(</span><span class=n>root_dir</span><span class=o>=</span><span class=n>root_dir</span><span class=p>)</span>
+            <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>sub_models</span><span class=p>,</span> <span class=nb>list</span><span class=p>):</span>
+                <span class=k>for</span> <span class=n>i</span><span class=p>,</span> <span class=n>sub_model_item</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>sub_models</span><span class=p>):</span>
+                    <span class=c1># e.g. `groups/00000_groups/`</span>
+                    <span class=n>prefix</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>i</span><span class=p>)</span><span class=o>.</span><span class=n>zfill</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_DIGIT_PREFIX_LENGTH</span><span class=p>)</span>
+                    <span class=n>sub_model_items</span><span class=p>[</span><span class=n>prefix</span><span class=p>]</span> <span class=o>=</span> <span class=n>sub_model_item</span>
+
+            <span class=c1># process list sub model items</span>
+            <span class=n>count</span> <span class=o>=</span> <span class=mi>0</span>
+            <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>sub_model_item</span> <span class=ow>in</span> <span class=n>sub_model_items</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=n>count</span> <span class=o>+=</span> <span class=mi>1</span>
+                <span class=c1># recursively split the sub-model if there are more element paths to traverse</span>
+                <span class=c1># e.g. split component.control-implementations.*</span>
+                <span class=n>require_recursive_split</span> <span class=o>=</span> <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>)</span> <span class=ow>and</span> <span class=n>element_paths</span><span class=p>[</span>
+                    <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span> <span class=o>==</span> <span class=n>element_path</span>
+
+                <span class=k>if</span> <span class=n>require_recursive_split</span><span class=p>:</span>
+                    <span class=c1># prepare individual directory for each sub-model</span>
+                    <span class=n>sub_root_file_name</span> <span class=o>=</span> <span class=n>cmd_utils</span><span class=o>.</span><span class=n>to_model_file_name</span><span class=p>(</span><span class=n>sub_model_item</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+                    <span class=n>sub_model_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+
+                    <span class=n>last_one</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=n>count</span> <span class=o>==</span> <span class=nb>len</span><span class=p>(</span><span class=n>sub_model_items</span><span class=p>)</span>
+                    <span class=n>path_chain_end</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>split_model_at_path_chain</span><span class=p>(</span>
+                        <span class=n>sub_model_item</span><span class=p>,</span>
+                        <span class=n>element_paths</span><span class=p>,</span>
+                        <span class=n>sub_models_dir</span><span class=p>,</span>
+                        <span class=n>content_type</span><span class=p>,</span>
+                        <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span>
+                        <span class=n>sub_model_plan</span><span class=p>,</span>
+                        <span class=kc>True</span><span class=p>,</span>
+                        <span class=n>sub_root_file_name</span><span class=p>,</span>
+                        <span class=n>aliases_to_strip</span><span class=p>,</span>
+                        <span class=n>last_one</span>
+                    <span class=p>)</span>
+                    <span class=n>sub_model_actions</span> <span class=o>=</span> <span class=n>sub_model_plan</span><span class=o>.</span><span class=n>get_actions</span><span class=p>()</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>sub_model_actions</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>prepare_sub_model_split_actions</span><span class=p>(</span>
+                        <span class=n>sub_model_item</span><span class=p>,</span> <span class=n>sub_models_dir</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=n>content_type</span>
+                    <span class=p>)</span>
+
+                <span class=n>split_plan</span><span class=o>.</span><span class=n>add_actions</span><span class=p>(</span><span class=n>sub_model_actions</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># the chain of path ends at the current index.</span>
+            <span class=c1># so no recursive call. Let&#39;s just write the sub model to the file and get out</span>
+            <span class=k>if</span> <span class=n>sub_models</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>sub_model_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_file_path</span><span class=p>(</span><span class=n>content_type</span><span class=p>,</span> <span class=n>root_dir</span><span class=o>=</span><span class=n>root_dir</span><span class=p>)</span>
+                <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>sub_model_file</span><span class=p>))</span>
+                <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span>
+                    <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>sub_model_file</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>sub_models</span><span class=p>,</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_element_name</span><span class=p>()),</span> <span class=n>content_type</span><span class=p>)</span>
+                <span class=p>)</span>
+
+        <span class=c1># Strip the root model and add a WriteAction for the updated model object in the plan</span>
+        <span class=k>if</span> <span class=n>strip_root</span><span class=p>:</span>
+            <span class=n>full_path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_full</span><span class=p>()</span>
+            <span class=n>path</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>full_path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[:</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+            <span class=n>aliases</span> <span class=o>=</span> <span class=p>[</span><span class=n>element_path</span><span class=o>.</span><span class=n>get_element_name</span><span class=p>()]</span>
+            <span class=n>need_to_write</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=n>use_alias_dict</span> <span class=o>=</span> <span class=n>aliases_to_strip</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>path</span> <span class=ow>in</span> <span class=n>aliases_to_strip</span>
+            <span class=k>if</span> <span class=n>use_alias_dict</span><span class=p>:</span>
+                <span class=n>aliases</span> <span class=o>=</span> <span class=n>aliases_to_strip</span><span class=p>[</span><span class=n>path</span><span class=p>]</span><span class=o>.</span><span class=n>get_aliases</span><span class=p>()</span>
+                <span class=n>need_to_write</span> <span class=o>=</span> <span class=n>aliases_to_strip</span><span class=p>[</span><span class=n>path</span><span class=p>]</span><span class=o>.</span><span class=n>needs_writing</span><span class=p>()</span>
+
+            <span class=n>stripped_model</span> <span class=o>=</span> <span class=n>model_obj</span><span class=o>.</span><span class=n>stripped_instance</span><span class=p>(</span><span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=n>aliases</span><span class=p>)</span>
+            <span class=c1># can mark it written even if it doesn&#39;t need writing since it is empty</span>
+            <span class=c1># but if an array only mark it written if it&#39;s the last one</span>
+            <span class=k>if</span> <span class=n>last_one</span> <span class=ow>and</span> <span class=n>use_alias_dict</span><span class=p>:</span>
+                <span class=n>aliases_to_strip</span><span class=p>[</span><span class=n>path</span><span class=p>]</span><span class=o>.</span><span class=n>mark_written</span><span class=p>()</span>
+            <span class=c1># If it&#39;s an empty model after stripping the fields, don&#39;t create path and don&#39;t write</span>
+            <span class=n>field_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>x</span> <span class=k>for</span> <span class=n>x</span> <span class=ow>in</span> <span class=n>model_obj</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=k>if</span> <span class=n>model_obj</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=n>x</span><span class=p>]</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>]</span>
+            <span class=k>if</span> <span class=nb>set</span><span class=p>(</span><span class=n>field_list</span><span class=p>)</span> <span class=o>==</span> <span class=nb>set</span><span class=p>(</span><span class=n>stripped_field_alias</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>path_chain_end</span>
+
+            <span class=k>if</span> <span class=n>need_to_write</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>root_file_name</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+                    <span class=n>root_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>root_file_name</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>root_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_root_path</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+
+                <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>root_file</span><span class=p>))</span>
+                <span class=n>wrapper_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>stripped_model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+                <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>WriteFileAction</span><span class=p>(</span><span class=n>root_file</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>stripped_model</span><span class=p>,</span> <span class=n>wrapper_alias</span><span class=p>),</span> <span class=n>content_type</span><span class=p>))</span>
+
+        <span class=c1># return the end of the current path chain</span>
+        <span class=k>return</span> <span class=n>path_chain_end</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>split_model</span><span class=p>(</span>
+        <span class=bp>cls</span><span class=p>,</span>
+        <span class=n>model_obj</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span>
+        <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>],</span>
+        <span class=n>base_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>,</span>
+        <span class=n>root_file_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>aliases_to_strip</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>AliasTracker</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Plan</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Split the model at the provided element paths.</span>
+
+<span class=sd>        It returns a plan for the operation</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># initialize plan</span>
+        <span class=n>split_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+
+        <span class=c1># loop through the element path list and update the split_plan</span>
+        <span class=n>stripped_field_alias</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>cur_path_index</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>while</span> <span class=n>cur_path_index</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>):</span>
+            <span class=c1># extract the sub element name for each of the root path of the path chain</span>
+            <span class=n>element_path</span> <span class=o>=</span> <span class=n>element_paths</span><span class=p>[</span><span class=n>cur_path_index</span><span class=p>]</span>
+
+            <span class=k>if</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_path</span><span class=o>.</span><span class=n>get</span><span class=p>())</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=n>stripped_part</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get</span><span class=p>()[</span><span class=mi>1</span><span class=p>]</span>
+                <span class=k>if</span> <span class=n>stripped_part</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+                    <span class=n>stripped_field_alias</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=s1>&#39;__root__&#39;</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>stripped_part</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>stripped_field_alias</span><span class=p>:</span>
+                        <span class=n>stripped_field_alias</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>stripped_part</span><span class=p>)</span>
+
+            <span class=c1># split model at the path chain</span>
+            <span class=n>cur_path_index</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>split_model_at_path_chain</span><span class=p>(</span>
+                <span class=n>model_obj</span><span class=p>,</span>
+                <span class=n>element_paths</span><span class=p>,</span>
+                <span class=n>base_dir</span><span class=p>,</span>
+                <span class=n>content_type</span><span class=p>,</span>
+                <span class=n>cur_path_index</span><span class=p>,</span>
+                <span class=n>split_plan</span><span class=p>,</span>
+                <span class=kc>False</span><span class=p>,</span>
+                <span class=n>root_file_name</span><span class=p>,</span>
+                <span class=n>aliases_to_strip</span>
+            <span class=p>)</span>
+
+            <span class=n>cur_path_index</span> <span class=o>+=</span> <span class=mi>1</span>
+
+        <span class=c1># strip the root model object and add a WriteAction</span>
+        <span class=n>stripped_root</span> <span class=o>=</span> <span class=n>model_obj</span><span class=o>.</span><span class=n>stripped_instance</span><span class=p>(</span><span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=n>stripped_field_alias</span><span class=p>)</span>
+        <span class=c1># If it&#39;s an empty model after stripping the fields, don&#39;t create path and don&#39;t write</span>
+        <span class=k>if</span> <span class=nb>set</span><span class=p>(</span><span class=n>model_obj</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span> <span class=o>==</span> <span class=nb>set</span><span class=p>(</span><span class=n>stripped_field_alias</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>split_plan</span>
+        <span class=k>if</span> <span class=n>root_file_name</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+            <span class=n>root_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>root_file_name</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>root_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_paths</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>to_root_path</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+        <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>root_file</span><span class=p>,</span> <span class=kc>True</span><span class=p>))</span>
+        <span class=n>wrapper_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>stripped_root</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>WriteFileAction</span><span class=p>(</span><span class=n>root_file</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>stripped_root</span><span class=p>,</span> <span class=n>wrapper_alias</span><span class=p>),</span> <span class=n>content_type</span><span class=p>))</span>
+
+        <span class=k>return</span> <span class=n>split_plan</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>find_aliases_to_strip</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>AliasTracker</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find list of aliases that need to be stripped as each element written out.&quot;&quot;&quot;</span>
+        <span class=c1># A given path may be present in several split actions</span>
+        <span class=c1># Need to determine all parts stripped at each node in order to strip them all and</span>
+        <span class=c1># write the stripped model only once</span>
+        <span class=n>tracker_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>AliasTracker</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>element_path</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+            <span class=n>path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_full</span><span class=p>()</span>
+            <span class=n>path_parts</span> <span class=o>=</span> <span class=n>path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+            <span class=n>alias</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>2</span> <span class=ow>and</span> <span class=n>alias</span> <span class=o>!=</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+                <span class=n>root_path</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>path_parts</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+                <span class=k>if</span> <span class=n>root_path</span> <span class=ow>in</span> <span class=n>tracker_map</span><span class=p>:</span>
+                    <span class=n>tracker_map</span><span class=p>[</span><span class=n>root_path</span><span class=p>]</span><span class=o>.</span><span class=n>add_alias</span><span class=p>(</span><span class=n>alias</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>tracker_map</span><span class=p>[</span><span class=n>root_path</span><span class=p>]</span> <span class=o>=</span> <span class=n>AliasTracker</span><span class=p>(</span><span class=n>aliases</span><span class=o>=</span><span class=p>[</span><span class=n>alias</span><span class=p>])</span>
+        <span class=k>return</span> <span class=n>tracker_map</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.split.SplitCmd-attributes>Attributes<a href=#trestle.core.commands.split.SplitCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.split.SplitCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;split&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.split.SplitCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.commands.split.SplitCmd-functions>Functions<a href=#trestle.core.commands.split.SplitCmd-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.split.SplitCmd.find_aliases_to_strip class="doc doc-heading"> <code class="highlight language-python"><span class=n>find_aliases_to_strip</span><span class=p>(</span><span class=n>element_paths</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.split.SplitCmd.find_aliases_to_strip class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find list of aliases that need to be stripped as each element written out.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>find_aliases_to_strip</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>AliasTracker</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find list of aliases that need to be stripped as each element written out.&quot;&quot;&quot;</span>
+    <span class=c1># A given path may be present in several split actions</span>
+    <span class=c1># Need to determine all parts stripped at each node in order to strip them all and</span>
+    <span class=c1># write the stripped model only once</span>
+    <span class=n>tracker_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>AliasTracker</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>element_path</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+        <span class=n>path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_full</span><span class=p>()</span>
+        <span class=n>path_parts</span> <span class=o>=</span> <span class=n>path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+        <span class=n>alias</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>2</span> <span class=ow>and</span> <span class=n>alias</span> <span class=o>!=</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+            <span class=n>root_path</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>path_parts</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+            <span class=k>if</span> <span class=n>root_path</span> <span class=ow>in</span> <span class=n>tracker_map</span><span class=p>:</span>
+                <span class=n>tracker_map</span><span class=p>[</span><span class=n>root_path</span><span class=p>]</span><span class=o>.</span><span class=n>add_alias</span><span class=p>(</span><span class=n>alias</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>tracker_map</span><span class=p>[</span><span class=n>root_path</span><span class=p>]</span> <span class=o>=</span> <span class=n>AliasTracker</span><span class=p>(</span><span class=n>aliases</span><span class=o>=</span><span class=p>[</span><span class=n>alias</span><span class=p>])</span>
+    <span class=k>return</span> <span class=n>tracker_map</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.split.SplitCmd.perform_split class="doc doc-heading"> <code class="highlight language-python"><span class=n>perform_split</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>,</span> <span class=n>file_name</span><span class=p>,</span> <span class=n>elements</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.split.SplitCmd.perform_split class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Perform the split operation.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>effective_cwd</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>effective directory in which the the split operation is performed</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>file_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>file name of model to split, or '' if deduced from elements and cwd</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>elements</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>comma separated list of paths to strip from the file, with quotes removed</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>0 on success and 1 on failure</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>perform_split</span><span class=p>(</span>
+    <span class=bp>cls</span><span class=p>,</span> <span class=n>effective_cwd</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>file_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>elements</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Perform the split operation.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        effective_cwd: effective directory in which the the split operation is performed</span>
+<span class=sd>        file_name: file name of model to split, or &#39;&#39; if deduced from elements and cwd</span>
+<span class=sd>        elements: comma separated list of paths to strip from the file, with quotes removed</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        0 on success and 1 on failure</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>file_path_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=k>if</span> <span class=n>file_name</span><span class=p>:</span>
+        <span class=n>file_path_list</span><span class=o>.</span><span class=n>append</span><span class=p>((</span><span class=n>file_name</span><span class=p>,</span> <span class=n>elements</span><span class=p>))</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=c1># cwd must be in the model directory if file to split is not specified</span>
+        <span class=c1># find top directory for this model based on trestle root and cwd</span>
+        <span class=n>model_dir</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>extract_project_model_path</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>model_dir</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Current directory must be within a model directory if file is not specified&#39;</span><span class=p>)</span>
+
+        <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>dir_to_content_type</span><span class=p>(</span><span class=n>model_dir</span><span class=p>)</span>
+
+        <span class=c1># determine the file needed for each split path</span>
+        <span class=n>element_paths</span> <span class=o>=</span> <span class=n>elements</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>path</span> <span class=ow>in</span> <span class=n>element_paths</span><span class=p>:</span>
+            <span class=n>element_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+            <span class=c1># if element path is relative use directory context to determine absolute path</span>
+            <span class=n>element_path</span><span class=o>.</span><span class=n>make_absolute</span><span class=p>(</span><span class=n>model_dir</span><span class=p>,</span> <span class=n>effective_cwd</span><span class=p>)</span>
+            <span class=n>file_path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>find_last_file_in_path</span><span class=p>(</span><span class=n>content_type</span><span class=p>,</span> <span class=n>model_dir</span><span class=p>)</span>
+            <span class=c1># now make the element path relative to the model file to be loaded</span>
+            <span class=k>if</span> <span class=n>file_path</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>or</span> <span class=n>element_path</span><span class=o>.</span><span class=n>make_relative</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>model_dir</span><span class=p>))</span> <span class=o>!=</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to match element path with files in model directory </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>file_path_list</span><span class=o>.</span><span class=n>append</span><span class=p>((</span><span class=n>file_path</span><span class=p>,</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_string</span><span class=p>()))</span>
+
+    <span class=c1># match paths to corresponding files since several paths may be split from the same file</span>
+    <span class=n>file_path_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>file_path</span> <span class=ow>in</span> <span class=n>file_path_list</span><span class=p>:</span>
+        <span class=n>key</span> <span class=o>=</span> <span class=n>file_path</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>  <span class=c1># type: ignore</span>
+        <span class=n>path</span> <span class=o>=</span> <span class=n>file_path</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>  <span class=c1># type: ignore</span>
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>file_path_dict</span><span class=p>:</span>
+            <span class=n>file_path_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>path</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>current_path</span> <span class=o>=</span> <span class=n>file_path_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+            <span class=n>file_path_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>current_path</span><span class=si>}</span><span class=s1>,</span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1>&#39;</span>
+
+    <span class=k>for</span> <span class=n>raw_file_name</span><span class=p>,</span> <span class=n>element_path</span> <span class=ow>in</span> <span class=n>file_path_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+        <span class=n>file_path</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>relative_resolve</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>raw_file_name</span><span class=p>),</span> <span class=n>effective_cwd</span><span class=p>)</span>
+        <span class=c1># this makes assumptions that the path is relative.</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+        <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+
+        <span class=c1># find the base directory of the file</span>
+        <span class=n>base_dir</span> <span class=o>=</span> <span class=n>file_path</span><span class=o>.</span><span class=n>parent</span>
+        <span class=n>model_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_stripped_model_type</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+
+        <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span> <span class=o>=</span> <span class=n>model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>cmd_utils</span><span class=o>.</span><span class=n>split_is_too_fine</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>model</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot split the model to the level of uuids, strings, etc.&#39;</span><span class=p>)</span>
+
+        <span class=c1># use the model itself to resolve any wildcards and create list of element paths</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;split calling parse_element_args on </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># use contextual mode to parse</span>
+
+        <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>]</span> <span class=o>=</span> <span class=n>cmd_utils</span><span class=o>.</span><span class=n>parse_element_args</span><span class=p>(</span>
+            <span class=n>model</span><span class=p>,</span> <span class=n>element_path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>),</span> <span class=n>base_dir</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>)</span>
+        <span class=p>)</span>
+
+        <span class=c1># analyze the split tree and determine which aliases should be stripped from each file</span>
+        <span class=n>aliases_to_strip</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>find_aliases_to_strip</span><span class=p>(</span><span class=n>element_paths</span><span class=p>)</span>
+
+        <span class=c1># need the file name relative to the base directory</span>
+        <span class=n>file_name_no_path</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+
+        <span class=n>split_plan</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>split_model</span><span class=p>(</span>
+            <span class=n>model</span><span class=p>,</span> <span class=n>element_paths</span><span class=p>,</span> <span class=n>base_dir</span><span class=p>,</span> <span class=n>content_type</span><span class=p>,</span> <span class=n>file_name_no_path</span><span class=p>,</span> <span class=n>aliases_to_strip</span>
+        <span class=p>)</span>
+        <span class=n>trash</span><span class=o>.</span><span class=n>store</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>split_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>trash</span><span class=o>.</span><span class=n>recover</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Split has failed with error: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.split.SplitCmd.prepare_sub_model_split_actions class="doc doc-heading"> <code class="highlight language-python"><span class=n>prepare_sub_model_split_actions</span><span class=p>(</span><span class=n>sub_model_item</span><span class=p>,</span> <span class=n>sub_model_dir</span><span class=p>,</span> <span class=n>file_prefix</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.split.SplitCmd.prepare_sub_model_split_actions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create split actions of sub model.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>prepare_sub_model_split_actions</span><span class=p>(</span>
+    <span class=bp>cls</span><span class=p>,</span>
+    <span class=n>sub_model_item</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span>
+    <span class=n>sub_model_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>file_prefix</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create split actions of sub model.&quot;&quot;&quot;</span>
+    <span class=n>actions</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>file_name</span> <span class=o>=</span> <span class=n>cmd_utils</span><span class=o>.</span><span class=n>to_model_file_name</span><span class=p>(</span><span class=n>sub_model_item</span><span class=p>,</span> <span class=n>file_prefix</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+    <span class=n>model_type</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=nb>type</span><span class=p>(</span><span class=n>sub_model_item</span><span class=p>)</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=n>sub_model_file</span> <span class=o>=</span> <span class=n>sub_model_dir</span> <span class=o>/</span> <span class=n>file_name</span>
+    <span class=n>actions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>sub_model_file</span><span class=p>))</span>
+    <span class=n>actions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>WriteFileAction</span><span class=p>(</span><span class=n>sub_model_file</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>sub_model_item</span><span class=p>,</span> <span class=n>model_type</span><span class=p>),</span> <span class=n>content_type</span><span class=p>))</span>
+    <span class=k>return</span> <span class=n>actions</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.split.SplitCmd.split_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>split_model</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=n>element_paths</span><span class=p>,</span> <span class=n>base_dir</span><span class=p>,</span> <span class=n>content_type</span><span class=p>,</span> <span class=n>root_file_name</span><span class=p>,</span> <span class=n>aliases_to_strip</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.split.SplitCmd.split_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Split the model at the provided element paths.</p> <p>It returns a plan for the operation</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>split_model</span><span class=p>(</span>
+    <span class=bp>cls</span><span class=p>,</span>
+    <span class=n>model_obj</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span>
+    <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>],</span>
+    <span class=n>base_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>,</span>
+    <span class=n>root_file_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>aliases_to_strip</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>AliasTracker</span><span class=p>]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Plan</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Split the model at the provided element paths.</span>
+
+<span class=sd>    It returns a plan for the operation</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># initialize plan</span>
+    <span class=n>split_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+
+    <span class=c1># loop through the element path list and update the split_plan</span>
+    <span class=n>stripped_field_alias</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>cur_path_index</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=k>while</span> <span class=n>cur_path_index</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>):</span>
+        <span class=c1># extract the sub element name for each of the root path of the path chain</span>
+        <span class=n>element_path</span> <span class=o>=</span> <span class=n>element_paths</span><span class=p>[</span><span class=n>cur_path_index</span><span class=p>]</span>
+
+        <span class=k>if</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_path</span><span class=o>.</span><span class=n>get</span><span class=p>())</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>stripped_part</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get</span><span class=p>()[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>stripped_part</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+                <span class=n>stripped_field_alias</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=s1>&#39;__root__&#39;</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>stripped_part</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>stripped_field_alias</span><span class=p>:</span>
+                    <span class=n>stripped_field_alias</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>stripped_part</span><span class=p>)</span>
+
+        <span class=c1># split model at the path chain</span>
+        <span class=n>cur_path_index</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>split_model_at_path_chain</span><span class=p>(</span>
+            <span class=n>model_obj</span><span class=p>,</span>
+            <span class=n>element_paths</span><span class=p>,</span>
+            <span class=n>base_dir</span><span class=p>,</span>
+            <span class=n>content_type</span><span class=p>,</span>
+            <span class=n>cur_path_index</span><span class=p>,</span>
+            <span class=n>split_plan</span><span class=p>,</span>
+            <span class=kc>False</span><span class=p>,</span>
+            <span class=n>root_file_name</span><span class=p>,</span>
+            <span class=n>aliases_to_strip</span>
+        <span class=p>)</span>
+
+        <span class=n>cur_path_index</span> <span class=o>+=</span> <span class=mi>1</span>
+
+    <span class=c1># strip the root model object and add a WriteAction</span>
+    <span class=n>stripped_root</span> <span class=o>=</span> <span class=n>model_obj</span><span class=o>.</span><span class=n>stripped_instance</span><span class=p>(</span><span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=n>stripped_field_alias</span><span class=p>)</span>
+    <span class=c1># If it&#39;s an empty model after stripping the fields, don&#39;t create path and don&#39;t write</span>
+    <span class=k>if</span> <span class=nb>set</span><span class=p>(</span><span class=n>model_obj</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span> <span class=o>==</span> <span class=nb>set</span><span class=p>(</span><span class=n>stripped_field_alias</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>split_plan</span>
+    <span class=k>if</span> <span class=n>root_file_name</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+        <span class=n>root_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>root_file_name</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>root_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_paths</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>to_root_path</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+    <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>root_file</span><span class=p>,</span> <span class=kc>True</span><span class=p>))</span>
+    <span class=n>wrapper_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>stripped_root</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>WriteFileAction</span><span class=p>(</span><span class=n>root_file</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>stripped_root</span><span class=p>,</span> <span class=n>wrapper_alias</span><span class=p>),</span> <span class=n>content_type</span><span class=p>))</span>
+
+    <span class=k>return</span> <span class=n>split_plan</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.commands.split.SplitCmd.split_model_at_path_chain class="doc doc-heading"> <code class="highlight language-python"><span class=n>split_model_at_path_chain</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=n>element_paths</span><span class=p>,</span> <span class=n>base_dir</span><span class=p>,</span> <span class=n>content_type</span><span class=p>,</span> <span class=n>cur_path_index</span><span class=p>,</span> <span class=n>split_plan</span><span class=p>,</span> <span class=n>strip_root</span><span class=p>,</span> <span class=n>root_file_name</span><span class=p>,</span> <span class=n>aliases_to_strip</span><span class=p>,</span> <span class=n>last_one</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.commands.split.SplitCmd.split_model_at_path_chain class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Recursively split the model at the provided chain of element paths.</p> <p>It assumes that a chain of element paths starts at the cur_path_index with the first path ending with a wildcard (*)</p> <p>If the wildcard follows an element that is inherently a list of items, the list of items is extracted. But if the wildcard follows a generic model than members of that model class found in the model will be split off. But only the non-trivial elements are removed, i.e. not str, int, datetime, etc.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model_obj</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code> </td> <td> <div class=doc-md-description> <p>The OscalBaseModel to be split</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>element_paths</code> </td> <td> <code><span title=typing.List>List</span>[<a class="autorefs autorefs-internal" title=trestle.core.models.elements.ElementPath href=../../models/elements/#trestle.core.models.elements.ElementPath>ElementPath</a>]</code> </td> <td> <div class=doc-md-description> <p>The List[ElementPath] of elements to split, including embedded wildcards</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>base_dir</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>pathlib.Path of the file being split</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>content_type</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.models.file_content_type.FileContentType href=../../models/file_content_type/#trestle.core.models.file_content_type.FileContentType>FileContentType</a></code> </td> <td> <div class=doc-md-description> <p>json or yaml files</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>cur_path_index</code> </td> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>Index into the list of element paths for the current split operation</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>split_plan</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.models.plans.Plan href=../../models/plans/#trestle.core.models.plans.Plan>Plan</a></code> </td> <td> <div class=doc-md-description> <p>The accumulated plan of actions needed to perform the split</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>strip_root</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to strip elements from the root object</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>root_file_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Filename of root file that gets split into a list of items</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>aliases_to_strip</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, <a class="autorefs autorefs-internal" title=trestle.core.commands.split.AliasTracker href=#trestle.core.commands.split.AliasTracker>AliasTracker</a>]</code> </td> <td> <div class=doc-md-description> <p>AliasTracker previously loaded with aliases that need to be split from each element</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>last_one</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>bool indicating last item in array has been split and stripped model can now be written</p> </div> </td> <td> <code>True</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>int representing the index where the chain of the path ends.</p> </div> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Examples:</span></p> <p>For example, element paths could have a list of paths as below for a <code>ComponentDefinition</code> model where the first path is the start of the chain.</p> <p>For each of the sub model described by the first element path (e.g component-defintion.components.<em>) in the chain, the subsequent paths (e.g component.control-implementations.</em>) will be applied recursively to retrieve the sub-sub models: [ 'component-definition.component.<em>', 'component.control-implementations.</em>' ] for a command like below: trestle split -f component.yaml -e component-definition.components.<em>.control-implementations.</em></p> <details class=quote> <summary>Source code in <code>trestle/core/commands/split.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>split_model_at_path_chain</span><span class=p>(</span>
+    <span class=bp>cls</span><span class=p>,</span>
+    <span class=n>model_obj</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span>
+    <span class=n>element_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ElementPath</span><span class=p>],</span>
+    <span class=n>base_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>,</span>
+    <span class=n>cur_path_index</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+    <span class=n>split_plan</span><span class=p>:</span> <span class=n>Plan</span><span class=p>,</span>
+    <span class=n>strip_root</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>root_file_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>aliases_to_strip</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>AliasTracker</span><span class=p>],</span>
+    <span class=n>last_one</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Recursively split the model at the provided chain of element paths.</span>
+
+<span class=sd>    It assumes that a chain of element paths starts at the cur_path_index with the first path ending</span>
+<span class=sd>    with a wildcard (*)</span>
+
+<span class=sd>    If the wildcard follows an element that is inherently a list of items, the list of items is extracted.</span>
+<span class=sd>    But if the wildcard follows a generic model than members of that model class found in the model will be</span>
+<span class=sd>    split off.  But only the non-trivial elements are removed, i.e. not str, int, datetime, etc.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        model_obj: The OscalBaseModel to be split</span>
+<span class=sd>        element_paths: The List[ElementPath] of elements to split, including embedded wildcards</span>
+<span class=sd>        base_dir: pathlib.Path of the file being split</span>
+<span class=sd>        content_type: json or yaml files</span>
+<span class=sd>        cur_path_index: Index into the list of element paths for the current split operation</span>
+<span class=sd>        split_plan: The accumulated plan of actions needed to perform the split</span>
+<span class=sd>        strip_root: Whether to strip elements from the root object</span>
+<span class=sd>        root_file_name: Filename of root file that gets split into a list of items</span>
+<span class=sd>        aliases_to_strip: AliasTracker previously loaded with aliases that need to be split from each element</span>
+<span class=sd>        last_one: bool indicating last item in array has been split and stripped model can now be written</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        int representing the index where the chain of the path ends.</span>
+
+<span class=sd>    Examples:</span>
+<span class=sd>        For example, element paths could have a list of paths as below for a `ComponentDefinition` model where</span>
+<span class=sd>        the first path is the start of the chain.</span>
+
+<span class=sd>        For each of the sub model described by the first element path (e.g component-defintion.components.*) in the</span>
+<span class=sd>        chain, the subsequent paths (e.g component.control-implementations.*) will be applied recursively</span>
+<span class=sd>        to retrieve the sub-sub models:</span>
+<span class=sd>        [</span>
+<span class=sd>            &#39;component-definition.component.*&#39;,</span>
+<span class=sd>            &#39;component.control-implementations.*&#39;</span>
+<span class=sd>        ]</span>
+<span class=sd>        for a command like below:</span>
+<span class=sd>        trestle split -f component.yaml -e component-definition.components.*.control-implementations.*</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>split_plan</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Split plan must have been initialized&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>cur_path_index</span> <span class=o>&lt;</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Current index of the chain of paths cannot be less than 0&#39;</span><span class=p>)</span>
+
+    <span class=c1># if there are no more element_paths, return the current plan</span>
+    <span class=k>if</span> <span class=n>cur_path_index</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>cur_path_index</span>
+
+    <span class=c1># initialize local variables</span>
+    <span class=n>element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model_obj</span><span class=p>)</span>
+    <span class=n>stripped_field_alias</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=c1># get the sub_model specified by the element_path of this round</span>
+    <span class=n>element_path</span> <span class=o>=</span> <span class=n>element_paths</span><span class=p>[</span><span class=n>cur_path_index</span><span class=p>]</span>
+
+    <span class=c1># does the next element_path point back at me</span>
+    <span class=n>is_parent</span> <span class=o>=</span> <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>)</span> <span class=ow>and</span> <span class=n>element_paths</span><span class=p>[</span><span class=n>cur_path_index</span>
+                                                                          <span class=o>+</span> <span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span> <span class=o>==</span> <span class=n>element_path</span>
+
+    <span class=c1># root dir name for sub models dir</span>
+    <span class=c1># 00000__group.json will have the root_dir name as 00000__group for sub models of group</span>
+    <span class=c1># catalog.json will have the root_dir name as catalog</span>
+    <span class=n>root_dir</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>if</span> <span class=n>root_file_name</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+        <span class=n>root_dir</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>root_file_name</span><span class=p>)</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>))</span>
+
+    <span class=n>sub_models</span> <span class=o>=</span> <span class=n>element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>  <span class=c1># we call sub_models as in plural, but it can be just one</span>
+
+    <span class=c1># assume cur_path_index is the end of the chain</span>
+    <span class=c1># value of this variable may change during recursive split of the sub-models below</span>
+    <span class=n>path_chain_end</span> <span class=o>=</span> <span class=n>cur_path_index</span>
+
+    <span class=c1># if wildcard is present in the element_path and the next path in the chain has current path as the parent,</span>
+    <span class=c1># Then deal with case of list, or split of arbitrary oscalbasemodel</span>
+    <span class=k>if</span> <span class=n>is_parent</span> <span class=ow>and</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=ow>is</span> <span class=ow>not</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+        <span class=c1># create dir for all sub model items</span>
+        <span class=n>sub_models_dir</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_root_path</span><span class=p>()</span>
+        <span class=n>sub_model_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=n>path_chain_end</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>split_model_at_path_chain</span><span class=p>(</span>
+            <span class=n>sub_models</span><span class=p>,</span>
+            <span class=n>element_paths</span><span class=p>,</span>
+            <span class=n>sub_models_dir</span><span class=p>,</span>
+            <span class=n>content_type</span><span class=p>,</span>
+            <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span>
+            <span class=n>sub_model_plan</span><span class=p>,</span>
+            <span class=kc>True</span><span class=p>,</span>
+            <span class=s1>&#39;&#39;</span><span class=p>,</span>
+            <span class=n>aliases_to_strip</span>
+        <span class=p>)</span>
+        <span class=n>sub_model_actions</span> <span class=o>=</span> <span class=n>sub_model_plan</span><span class=o>.</span><span class=n>get_actions</span><span class=p>()</span>
+        <span class=n>split_plan</span><span class=o>.</span><span class=n>add_actions</span><span class=p>(</span><span class=n>sub_model_actions</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+        <span class=c1># extract sub-models into a dict with appropriate prefix</span>
+        <span class=n>sub_model_items</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>sub_models_dir</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_file_path</span><span class=p>(</span><span class=n>root_dir</span><span class=o>=</span><span class=n>root_dir</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>sub_models</span><span class=p>,</span> <span class=nb>list</span><span class=p>):</span>
+            <span class=k>for</span> <span class=n>i</span><span class=p>,</span> <span class=n>sub_model_item</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>sub_models</span><span class=p>):</span>
+                <span class=c1># e.g. `groups/00000_groups/`</span>
+                <span class=n>prefix</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>i</span><span class=p>)</span><span class=o>.</span><span class=n>zfill</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_DIGIT_PREFIX_LENGTH</span><span class=p>)</span>
+                <span class=n>sub_model_items</span><span class=p>[</span><span class=n>prefix</span><span class=p>]</span> <span class=o>=</span> <span class=n>sub_model_item</span>
+
+        <span class=c1># process list sub model items</span>
+        <span class=n>count</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>sub_model_item</span> <span class=ow>in</span> <span class=n>sub_model_items</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>count</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=c1># recursively split the sub-model if there are more element paths to traverse</span>
+            <span class=c1># e.g. split component.control-implementations.*</span>
+            <span class=n>require_recursive_split</span> <span class=o>=</span> <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>element_paths</span><span class=p>)</span> <span class=ow>and</span> <span class=n>element_paths</span><span class=p>[</span>
+                <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span> <span class=o>==</span> <span class=n>element_path</span>
+
+            <span class=k>if</span> <span class=n>require_recursive_split</span><span class=p>:</span>
+                <span class=c1># prepare individual directory for each sub-model</span>
+                <span class=n>sub_root_file_name</span> <span class=o>=</span> <span class=n>cmd_utils</span><span class=o>.</span><span class=n>to_model_file_name</span><span class=p>(</span><span class=n>sub_model_item</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+                <span class=n>sub_model_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+
+                <span class=n>last_one</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=n>count</span> <span class=o>==</span> <span class=nb>len</span><span class=p>(</span><span class=n>sub_model_items</span><span class=p>)</span>
+                <span class=n>path_chain_end</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>split_model_at_path_chain</span><span class=p>(</span>
+                    <span class=n>sub_model_item</span><span class=p>,</span>
+                    <span class=n>element_paths</span><span class=p>,</span>
+                    <span class=n>sub_models_dir</span><span class=p>,</span>
+                    <span class=n>content_type</span><span class=p>,</span>
+                    <span class=n>cur_path_index</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span>
+                    <span class=n>sub_model_plan</span><span class=p>,</span>
+                    <span class=kc>True</span><span class=p>,</span>
+                    <span class=n>sub_root_file_name</span><span class=p>,</span>
+                    <span class=n>aliases_to_strip</span><span class=p>,</span>
+                    <span class=n>last_one</span>
+                <span class=p>)</span>
+                <span class=n>sub_model_actions</span> <span class=o>=</span> <span class=n>sub_model_plan</span><span class=o>.</span><span class=n>get_actions</span><span class=p>()</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>sub_model_actions</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>prepare_sub_model_split_actions</span><span class=p>(</span>
+                    <span class=n>sub_model_item</span><span class=p>,</span> <span class=n>sub_models_dir</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=n>content_type</span>
+                <span class=p>)</span>
+
+            <span class=n>split_plan</span><span class=o>.</span><span class=n>add_actions</span><span class=p>(</span><span class=n>sub_model_actions</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=c1># the chain of path ends at the current index.</span>
+        <span class=c1># so no recursive call. Let&#39;s just write the sub model to the file and get out</span>
+        <span class=k>if</span> <span class=n>sub_models</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>sub_model_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_file_path</span><span class=p>(</span><span class=n>content_type</span><span class=p>,</span> <span class=n>root_dir</span><span class=o>=</span><span class=n>root_dir</span><span class=p>)</span>
+            <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>sub_model_file</span><span class=p>))</span>
+            <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span>
+                <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>sub_model_file</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>sub_models</span><span class=p>,</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_element_name</span><span class=p>()),</span> <span class=n>content_type</span><span class=p>)</span>
+            <span class=p>)</span>
+
+    <span class=c1># Strip the root model and add a WriteAction for the updated model object in the plan</span>
+    <span class=k>if</span> <span class=n>strip_root</span><span class=p>:</span>
+        <span class=n>full_path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_full</span><span class=p>()</span>
+        <span class=n>path</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>full_path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[:</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+        <span class=n>aliases</span> <span class=o>=</span> <span class=p>[</span><span class=n>element_path</span><span class=o>.</span><span class=n>get_element_name</span><span class=p>()]</span>
+        <span class=n>need_to_write</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=n>use_alias_dict</span> <span class=o>=</span> <span class=n>aliases_to_strip</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>path</span> <span class=ow>in</span> <span class=n>aliases_to_strip</span>
+        <span class=k>if</span> <span class=n>use_alias_dict</span><span class=p>:</span>
+            <span class=n>aliases</span> <span class=o>=</span> <span class=n>aliases_to_strip</span><span class=p>[</span><span class=n>path</span><span class=p>]</span><span class=o>.</span><span class=n>get_aliases</span><span class=p>()</span>
+            <span class=n>need_to_write</span> <span class=o>=</span> <span class=n>aliases_to_strip</span><span class=p>[</span><span class=n>path</span><span class=p>]</span><span class=o>.</span><span class=n>needs_writing</span><span class=p>()</span>
+
+        <span class=n>stripped_model</span> <span class=o>=</span> <span class=n>model_obj</span><span class=o>.</span><span class=n>stripped_instance</span><span class=p>(</span><span class=n>stripped_fields_aliases</span><span class=o>=</span><span class=n>aliases</span><span class=p>)</span>
+        <span class=c1># can mark it written even if it doesn&#39;t need writing since it is empty</span>
+        <span class=c1># but if an array only mark it written if it&#39;s the last one</span>
+        <span class=k>if</span> <span class=n>last_one</span> <span class=ow>and</span> <span class=n>use_alias_dict</span><span class=p>:</span>
+            <span class=n>aliases_to_strip</span><span class=p>[</span><span class=n>path</span><span class=p>]</span><span class=o>.</span><span class=n>mark_written</span><span class=p>()</span>
+        <span class=c1># If it&#39;s an empty model after stripping the fields, don&#39;t create path and don&#39;t write</span>
+        <span class=n>field_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>x</span> <span class=k>for</span> <span class=n>x</span> <span class=ow>in</span> <span class=n>model_obj</span><span class=o>.</span><span class=n>__fields__</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=k>if</span> <span class=n>model_obj</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=n>x</span><span class=p>]</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>]</span>
+        <span class=k>if</span> <span class=nb>set</span><span class=p>(</span><span class=n>field_list</span><span class=p>)</span> <span class=o>==</span> <span class=nb>set</span><span class=p>(</span><span class=n>stripped_field_alias</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>path_chain_end</span>
+
+        <span class=k>if</span> <span class=n>need_to_write</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>root_file_name</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+                <span class=n>root_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>root_file_name</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>root_file</span> <span class=o>=</span> <span class=n>base_dir</span> <span class=o>/</span> <span class=n>element_path</span><span class=o>.</span><span class=n>to_root_path</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+
+            <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>CreatePathAction</span><span class=p>(</span><span class=n>root_file</span><span class=p>))</span>
+            <span class=n>wrapper_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>stripped_model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+            <span class=n>split_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>WriteFileAction</span><span class=p>(</span><span class=n>root_file</span><span class=p>,</span> <span class=n>Element</span><span class=p>(</span><span class=n>stripped_model</span><span class=p>,</span> <span class=n>wrapper_alias</span><span class=p>),</span> <span class=n>content_type</span><span class=p>))</span>
+
+    <span class=c1># return the end of the current path chain</span>
+    <span class=k>return</span> <span class=n>path_chain_end</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.split-functions>Functions<a href=#trestle.core.commands.split-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/task/index.html b/latest/reference/API/trestle/core/commands/task/index.html
new file mode 100644
index 000000000..7fba24ea8
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/task/index.html
@@ -0,0 +1,204 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.task module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/task/ rel=canonical><link href=../split/ rel=prev><link href=../validate/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.task - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.task - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.task module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/task.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/task/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.task - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.task module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/task.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.task class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.task </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.task </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.task </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.task class=md-nav__link> <span class=md-ellipsis> task </span> </a> <nav class=md-nav aria-label=task> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.task-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task.TaskCmd class=md-nav__link> <span class=md-ellipsis> TaskCmd </span> </a> <nav class=md-nav aria-label=TaskCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task.TaskCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task.TaskCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.task-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.task class=md-nav__link> <span class=md-ellipsis> task </span> </a> <nav class=md-nav aria-label=task> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.task-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task.TaskCmd class=md-nav__link> <span class=md-ellipsis> TaskCmd </span> </a> <nav class=md-nav aria-label=TaskCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task.TaskCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.task.TaskCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.task-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.task</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.task class="doc doc-heading"> <code>trestle.core.commands.task</code> <a href=#trestle.core.commands.task class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle task command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.task-attributes>Attributes<a href=#trestle.core.commands.task-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.task.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.task.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.task-classes>Classes<a href=#trestle.core.commands.task-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.task.TaskCmd class="doc doc-heading"> <code>TaskCmd</code> <a href=#trestle.core.commands.task.TaskCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Run arbitrary trestle tasks in a simple and extensible methodology.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TaskCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Run arbitrary trestle tasks in a simple and extensible methodology.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;task&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;task&#39;</span><span class=p>,</span>
+            <span class=n>nargs</span><span class=o>=</span><span class=s1>&#39;?&#39;</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;The name of the task to be run, trestle task -l will list available tasks.&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-l&#39;</span><span class=p>,</span> <span class=s1>&#39;--list&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;List the available tasks&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-c&#39;</span><span class=p>,</span> <span class=s1>&#39;--config&#39;</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Pass a customized configuration file specifically for a task&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-i&#39;</span><span class=p>,</span> <span class=s1>&#39;--info&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Print information about a particular task.&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Entering trestle task.&#39;</span><span class=p>)</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=c1># Initial logic for conflicting args</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>task</span> <span class=ow>and</span> <span class=n>args</span><span class=o>.</span><span class=n>list</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleIncorrectArgsError</span><span class=p>(</span><span class=s1>&#39;Task name or -l can be provided not both.&#39;</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>task</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>list</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleIncorrectArgsError</span><span class=p>(</span>
+                    <span class=s1>&#39;Either a trestle task or &quot;-l/--list&quot; shoudl be passed as input arguments.&#39;</span>
+                <span class=p>)</span>
+
+            <span class=c1># Ensure trestle directory (must be true)</span>
+            <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>  <span class=c1># trestle root is set via command line in args. Default is cwd.</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>trestle_root</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given directory: </span><span class=si>{</span><span class=n>trestle_root</span><span class=si>}</span><span class=s1> is not a trestle project.&#39;</span><span class=p>)</span>
+
+            <span class=n>config_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_CONFIG_DIR</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_CONFIG_FILE</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>config</span><span class=p>:</span>
+                <span class=n>config_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>config</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>config_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Config file at </span><span class=si>{</span><span class=n>config_path</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+            <span class=c1># permit ${name} in config definitions</span>
+            <span class=n>global_config</span> <span class=o>=</span> <span class=n>configparser</span><span class=o>.</span><span class=n>ConfigParser</span><span class=p>(</span><span class=n>interpolation</span><span class=o>=</span><span class=n>configparser</span><span class=o>.</span><span class=n>ExtendedInterpolation</span><span class=p>())</span>
+            <span class=n>global_config</span><span class=o>.</span><span class=n>read_file</span><span class=p>(</span><span class=n>config_path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>))</span>
+            <span class=c1># run setup</span>
+            <span class=n>task_index</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_task_index</span><span class=p>()</span>
+
+            <span class=c1># Clean to run</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>list</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_list_tasks</span><span class=p>(</span><span class=n>task_index</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+            <span class=c1># run the task</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>task</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>task_index</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=k>raise</span> <span class=n>TrestleIncorrectArgsError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unknown trestle task: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>task</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Loading task: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>task</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>section_label</span> <span class=o>=</span> <span class=s1>&#39;task.&#39;</span> <span class=o>+</span> <span class=n>args</span><span class=o>.</span><span class=n>task</span>
+            <span class=n>config_section</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=k>if</span> <span class=n>section_label</span> <span class=ow>in</span> <span class=n>global_config</span><span class=o>.</span><span class=n>sections</span><span class=p>():</span>
+                <span class=n>config_section</span> <span class=o>=</span> <span class=n>global_config</span><span class=p>[</span><span class=n>section_label</span><span class=p>]</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Config file was not configured with the appropriate section for the task: &quot;[</span><span class=si>{</span><span class=n>section_label</span><span class=si>}</span><span class=s1>]&quot;&#39;</span>
+                <span class=p>)</span>
+
+            <span class=n>task</span> <span class=o>=</span> <span class=n>task_index</span><span class=p>[</span><span class=n>args</span><span class=o>.</span><span class=n>task</span><span class=p>](</span><span class=n>config_section</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>info</span><span class=p>:</span>
+                <span class=n>task</span><span class=o>.</span><span class=n>print_info</span><span class=p>()</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=n>simulate_result</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>simulate</span><span class=p>()</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=p>(</span><span class=n>simulate_result</span> <span class=o>==</span> <span class=n>TaskOutcome</span><span class=o>.</span><span class=n>SIM_SUCCESS</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>task</span><span class=si>}</span><span class=s1> reported a </span><span class=si>{</span><span class=n>simulate_result</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>actual_result</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=p>(</span><span class=n>actual_result</span> <span class=o>==</span> <span class=n>TaskOutcome</span><span class=o>.</span><span class=n>SUCCESS</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>task</span><span class=si>}</span><span class=s1> reported a </span><span class=si>{</span><span class=n>actual_result</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Task: </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>task</span><span class=si>}</span><span class=s1> executed successfully.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while executing Trestle task&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_build_task_index</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Type</span><span class=p>[</span><span class=n>TaskBase</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build an index of all classes in which are tasks and present as a dictionary.&quot;&quot;&quot;</span>
+        <span class=n>task_index</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Type</span><span class=p>[</span><span class=n>TaskBase</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>pkgpath</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>trestle</span><span class=o>.</span><span class=n>tasks</span><span class=o>.</span><span class=vm>__file__</span><span class=p>)</span><span class=o>.</span><span class=n>parent</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>_</span> <span class=ow>in</span> <span class=n>pkgutil</span><span class=o>.</span><span class=n>iter_modules</span><span class=p>([</span><span class=n>pkgpath</span><span class=p>]):</span>
+            <span class=nb>__import__</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;trestle.tasks.</span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>clsmembers</span> <span class=o>=</span> <span class=n>inspect</span><span class=o>.</span><span class=n>getmembers</span><span class=p>(</span><span class=n>sys</span><span class=o>.</span><span class=n>modules</span><span class=p>[</span><span class=sa>f</span><span class=s1>&#39;trestle.tasks.</span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>],</span> <span class=n>inspect</span><span class=o>.</span><span class=n>isclass</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>candidate</span> <span class=ow>in</span> <span class=n>clsmembers</span><span class=p>:</span>
+                <span class=k>if</span> <span class=nb>issubclass</span><span class=p>(</span><span class=n>candidate</span><span class=p>[</span><span class=mi>1</span><span class=p>],</span> <span class=n>TaskBase</span><span class=p>):</span>
+                    <span class=n>task_index</span><span class=p>[</span><span class=n>candidate</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=n>candidate</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>task_index</span>
+
+    <span class=k>def</span> <span class=nf>_list_tasks</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>task_index</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Type</span><span class=p>[</span><span class=n>TaskBase</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Available tasks:&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>task_index</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;    </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.task.TaskCmd-attributes>Attributes<a href=#trestle.core.commands.task.TaskCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.task.TaskCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;task&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.task.TaskCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.task-functions>Functions<a href=#trestle.core.commands.task-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/validate/index.html b/latest/reference/API/trestle/core/commands/validate/index.html
new file mode 100644
index 000000000..424570d1a
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/validate/index.html
@@ -0,0 +1,36 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.validate module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/validate/ rel=canonical><link href=../task/ rel=prev><link href=../version/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.validate - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.validate - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.validate module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/validate.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/validate/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.validate - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.validate module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/validate.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.validate class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.validate </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.validate </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> <nav class=md-nav aria-label=validate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.validate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate.ValidateCmd class=md-nav__link> <span class=md-ellipsis> ValidateCmd </span> </a> <nav class=md-nav aria-label=ValidateCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate.ValidateCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate.ValidateCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.validate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> <nav class=md-nav aria-label=validate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.validate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate.ValidateCmd class=md-nav__link> <span class=md-ellipsis> ValidateCmd </span> </a> <nav class=md-nav aria-label=ValidateCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate.ValidateCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.validate.ValidateCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.validate-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.validate</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.validate class="doc doc-heading"> <code>trestle.core.commands.validate</code> <a href=#trestle.core.commands.validate class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Validate Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.validate-attributes>Attributes<a href=#trestle.core.commands.validate-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.validate.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.validate.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.validate-classes>Classes<a href=#trestle.core.commands.validate-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.validate.ValidateCmd class="doc doc-heading"> <code>ValidateCmd</code> <a href=#trestle.core.commands.validate.ValidateCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandPlusDocs href=../command_docs/#trestle.core.commands.command_docs.CommandPlusDocs>CommandPlusDocs</a></code></p> <p>Validate contents of a trestle model in different modes.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/validate.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ValidateCmd</span><span class=p>(</span><span class=n>CommandPlusDocs</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validate contents of a trestle model in different modes.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=n>ARG_VALIDATE</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>vfact</span><span class=o>.</span><span class=n>init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>log</span><span class=o>.</span><span class=n>set_log_level_from_args</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+
+            <span class=n>mode_args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span><span class=n>mode</span><span class=o>=</span><span class=n>VAL_MODE_ALL</span><span class=p>)</span>
+            <span class=n>validator</span> <span class=o>=</span> <span class=n>vfact</span><span class=o>.</span><span class=n>validator_factory</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>mode_args</span><span class=p>)</span>
+
+            <span class=k>return</span> <span class=n>validator</span><span class=o>.</span><span class=n>validate</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error while validating contents of a trestle model&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.validate.ValidateCmd-attributes>Attributes<a href=#trestle.core.commands.validate.ValidateCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.validate.ValidateCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=n>ARG_VALIDATE</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.validate.ValidateCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.validate-functions>Functions<a href=#trestle.core.commands.validate-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/commands/version/index.html b/latest/reference/API/trestle/core/commands/version/index.html
new file mode 100644
index 000000000..49ff02909
--- /dev/null
+++ b/latest/reference/API/trestle/core/commands/version/index.html
@@ -0,0 +1,92 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.commands.version module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/version/ rel=canonical><link href=../validate/ rel=prev><link href=../author/catalog/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.commands.version - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.commands.version - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.commands.version module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/version.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/version/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.commands.version - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.commands.version module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/commands/version.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.commands.version class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.commands.version </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27 checked> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.commands.version </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.commands.version </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> <nav class=md-nav aria-label=version> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.version-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version.VersionCmd class=md-nav__link> <span class=md-ellipsis> VersionCmd </span> </a> <nav class=md-nav aria-label=VersionCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version.VersionCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version.VersionCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.version-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.commands.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> <nav class=md-nav aria-label=version> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.version-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version.VersionCmd class=md-nav__link> <span class=md-ellipsis> VersionCmd </span> </a> <nav class=md-nav aria-label=VersionCmd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version.VersionCmd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.commands.version.VersionCmd.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.commands.version-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.commands.version</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.commands.version class="doc doc-heading"> <code>trestle.core.commands.version</code> <a href=#trestle.core.commands.version class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Validate Command.</p> <div class="doc doc-children"> <h3 id=trestle.core.commands.version-attributes>Attributes<a href=#trestle.core.commands.version-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.commands.version.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.commands.version.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.commands.version-classes>Classes<a href=#trestle.core.commands.version-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.commands.version.VersionCmd class="doc doc-heading"> <code>VersionCmd</code> <a href=#trestle.core.commands.version.VersionCmd class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.commands.command_docs.CommandBase href=../command_docs/#trestle.core.commands.command_docs.CommandBase>CommandBase</a></code></p> <p>Output version info for trestle and OSCAL.</p> <details class=quote> <summary>Source code in <code>trestle/core/commands/version.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>VersionCmd</span><span class=p>(</span><span class=n>CommandBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Output version info for trestle and OSCAL.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;version&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_init_arguments</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of the OSCAL model&#39;</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=nb>str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span>
+            <span class=s1>&#39;-t&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;--type&#39;</span><span class=p>,</span>
+            <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Type of the model being queried: (catalog, profile, component-definition, ...)&#39;</span><span class=p>,</span>
+            <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=nb>str</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_version</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>type_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>obj_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Fetch the version of the OSCAL object from its metadata.&quot;&quot;&quot;</span>
+        <span class=n>oscal_object</span><span class=p>,</span> <span class=n>obj_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_model_for_type</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>type_name</span><span class=p>,</span> <span class=n>obj_name</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=p>(</span><span class=n>oscal_object</span><span class=o>.</span><span class=n>metadata</span> <span class=ow>or</span> <span class=n>oscal_object</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to determine the version. Metadata version is missing in model: </span><span class=si>{</span><span class=n>obj_path</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>oscal_object</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>version</span>
+
+    <span class=k>def</span> <span class=nf>_run</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>COMMAND_ERROR</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>:</span>
+                <span class=n>version_string</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Trestle version v</span><span class=si>{</span><span class=n>__version__</span><span class=si>}</span><span class=s1> based on OSCAL version </span><span class=si>{</span><span class=n>OSCAL_VERSION</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>out</span><span class=p>(</span><span class=n>version_string</span><span class=p>)</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>name</span> <span class=ow>and</span> <span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>)</span> <span class=ow>and</span> <span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>name</span> <span class=ow>or</span> <span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Either both arguments --name and --type should be provided or none.&#39;</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span> <span class=ow>and</span> <span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>:</span>
+                <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>)</span>
+                <span class=n>version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_version</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+                <span class=n>version_string</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Version of OSCAL object of </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=si>}</span><span class=s1> is: </span><span class=si>{</span><span class=n>version</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>out</span><span class=p>(</span><span class=n>version_string</span><span class=p>)</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+            <span class=k>return</span> <span class=n>status</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>return</span> <span class=n>handle_generic_command_exception</span><span class=p>(</span><span class=n>e</span><span class=p>,</span> <span class=n>logger</span><span class=p>,</span> <span class=s1>&#39;Error occurred when running trestle version&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.commands.version.VersionCmd-attributes>Attributes<a href=#trestle.core.commands.version.VersionCmd-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.commands.version.VersionCmd.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;version&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.commands.version.VersionCmd.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h3 id=trestle.core.commands.version-functions>Functions<a href=#trestle.core.commands.version-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/control_context/index.html b/latest/reference/API/trestle/core/control_context/index.html
new file mode 100644
index 000000000..a84ac6a0a
--- /dev/null
+++ b/latest/reference/API/trestle/core/control_context/index.html
@@ -0,0 +1,435 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.control_context module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_context/ rel=canonical><link href=../catalog_validator/ rel=prev><link href=../control_interface/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.control_context - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.control_context - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.control_context module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/control_context.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_context/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.control_context - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.control_context module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/control_context.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.control_context class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.control_context </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.control_context </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.control_context </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.control_context class=md-nav__link> <span class=md-ellipsis> control_context </span> </a> <nav class=md-nav aria-label=control_context> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose class=md-nav__link> <span class=md-ellipsis> ContextPurpose </span> </a> <nav class=md-nav aria-label=ContextPurpose> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose.CATALOG class=md-nav__link> <span class=md-ellipsis> CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose.COMPONENT class=md-nav__link> <span class=md-ellipsis> COMPONENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose.PROFILE class=md-nav__link> <span class=md-ellipsis> PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose.SSP class=md-nav__link> <span class=md-ellipsis> SSP </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext class=md-nav__link> <span class=md-ellipsis> ControlContext </span> </a> <nav class=md-nav aria-label=ControlContext> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.allowed_sections class=md-nav__link> <span class=md-ellipsis> allowed_sections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.cli_yaml_header class=md-nav__link> <span class=md-ellipsis> cli_yaml_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.comp_def class=md-nav__link> <span class=md-ellipsis> comp_def </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.comp_def_name_list class=md-nav__link> <span class=md-ellipsis> comp_def_name_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.comp_dict class=md-nav__link> <span class=md-ellipsis> comp_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.comp_name class=md-nav__link> <span class=md-ellipsis> comp_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.control_implementation class=md-nav__link> <span class=md-ellipsis> control_implementation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.include_all_parts class=md-nav__link> <span class=md-ellipsis> include_all_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.inherited_props class=md-nav__link> <span class=md-ellipsis> inherited_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.md_root class=md-nav__link> <span class=md-ellipsis> md_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.merged_header class=md-nav__link> <span class=md-ellipsis> merged_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.overwrite_header_values class=md-nav__link> <span class=md-ellipsis> overwrite_header_values </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.profile class=md-nav__link> <span class=md-ellipsis> profile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.prompt_responses class=md-nav__link> <span class=md-ellipsis> prompt_responses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.purpose class=md-nav__link> <span class=md-ellipsis> purpose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.required_sections class=md-nav__link> <span class=md-ellipsis> required_sections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.rules_dict class=md-nav__link> <span class=md-ellipsis> rules_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.rules_params_dict class=md-nav__link> <span class=md-ellipsis> rules_params_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.sections_dict class=md-nav__link> <span class=md-ellipsis> sections_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.set_parameters_flag class=md-nav__link> <span class=md-ellipsis> set_parameters_flag </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.to_markdown class=md-nav__link> <span class=md-ellipsis> to_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.trestle_root class=md-nav__link> <span class=md-ellipsis> trestle_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.uri_name_map class=md-nav__link> <span class=md-ellipsis> uri_name_map </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.clone class=md-nav__link> <span class=md-ellipsis> clone </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_context-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.control_context class=md-nav__link> <span class=md-ellipsis> control_context </span> </a> <nav class=md-nav aria-label=control_context> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose class=md-nav__link> <span class=md-ellipsis> ContextPurpose </span> </a> <nav class=md-nav aria-label=ContextPurpose> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose.CATALOG class=md-nav__link> <span class=md-ellipsis> CATALOG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose.COMPONENT class=md-nav__link> <span class=md-ellipsis> COMPONENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose.PROFILE class=md-nav__link> <span class=md-ellipsis> PROFILE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ContextPurpose.SSP class=md-nav__link> <span class=md-ellipsis> SSP </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext class=md-nav__link> <span class=md-ellipsis> ControlContext </span> </a> <nav class=md-nav aria-label=ControlContext> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.allowed_sections class=md-nav__link> <span class=md-ellipsis> allowed_sections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.cli_yaml_header class=md-nav__link> <span class=md-ellipsis> cli_yaml_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.comp_def class=md-nav__link> <span class=md-ellipsis> comp_def </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.comp_def_name_list class=md-nav__link> <span class=md-ellipsis> comp_def_name_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.comp_dict class=md-nav__link> <span class=md-ellipsis> comp_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.comp_name class=md-nav__link> <span class=md-ellipsis> comp_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.control_implementation class=md-nav__link> <span class=md-ellipsis> control_implementation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.include_all_parts class=md-nav__link> <span class=md-ellipsis> include_all_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.inherited_props class=md-nav__link> <span class=md-ellipsis> inherited_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.md_root class=md-nav__link> <span class=md-ellipsis> md_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.merged_header class=md-nav__link> <span class=md-ellipsis> merged_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.overwrite_header_values class=md-nav__link> <span class=md-ellipsis> overwrite_header_values </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.profile class=md-nav__link> <span class=md-ellipsis> profile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.prompt_responses class=md-nav__link> <span class=md-ellipsis> prompt_responses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.purpose class=md-nav__link> <span class=md-ellipsis> purpose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.required_sections class=md-nav__link> <span class=md-ellipsis> required_sections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.rules_dict class=md-nav__link> <span class=md-ellipsis> rules_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.rules_params_dict class=md-nav__link> <span class=md-ellipsis> rules_params_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.sections_dict class=md-nav__link> <span class=md-ellipsis> sections_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.set_parameters_flag class=md-nav__link> <span class=md-ellipsis> set_parameters_flag </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.to_markdown class=md-nav__link> <span class=md-ellipsis> to_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.trestle_root class=md-nav__link> <span class=md-ellipsis> trestle_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.uri_name_map class=md-nav__link> <span class=md-ellipsis> uri_name_map </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.clone class=md-nav__link> <span class=md-ellipsis> clone </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_context.ControlContext.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_context-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.control_context</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.control_context class="doc doc-heading"> <code>trestle.core.control_context</code> <a href=#trestle.core.control_context class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Provide a context for control operations.</p> <div class="doc doc-children"> <h3 id=trestle.core.control_context-attributes>Attributes<a href=#trestle.core.control_context-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.core.control_context-classes>Classes<a href=#trestle.core.control_context-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.control_context.ContextPurpose class="doc doc-heading"> <code>ContextPurpose</code> <a href=#trestle.core.control_context.ContextPurpose class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Specify the modality of the control markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_context.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ContextPurpose</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Specify the modality of the control markdown.&quot;&quot;&quot;</span>
+
+    <span class=n>CATALOG</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=n>COMPONENT</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=n>PROFILE</span> <span class=o>=</span> <span class=mi>2</span>
+    <span class=n>SSP</span> <span class=o>=</span> <span class=mi>3</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.control_context.ContextPurpose-attributes>Attributes<a href=#trestle.core.control_context.ContextPurpose-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ContextPurpose.CATALOG class="doc doc-heading"> <code class="highlight language-python"><span class=n>CATALOG</span> <span class=o>=</span> <span class=mi>0</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ContextPurpose.CATALOG class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ContextPurpose.COMPONENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>COMPONENT</span> <span class=o>=</span> <span class=mi>1</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ContextPurpose.COMPONENT class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ContextPurpose.PROFILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROFILE</span> <span class=o>=</span> <span class=mi>2</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ContextPurpose.PROFILE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ContextPurpose.SSP class="doc doc-heading"> <code class="highlight language-python"><span class=n>SSP</span> <span class=o>=</span> <span class=mi>3</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ContextPurpose.SSP class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.control_context.ControlContext class="doc doc-heading"> <code>ControlContext</code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> </span> <a href=#trestle.core.control_context.ControlContext class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class encapsulating control markdown usage.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_context.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@dataclass</span>
+<span class=k>class</span> <span class=nc>ControlContext</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class encapsulating control markdown usage.&quot;&quot;&quot;</span>
+
+    <span class=n>purpose</span><span class=p>:</span> <span class=n>ContextPurpose</span>
+    <span class=n>to_markdown</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+    <span class=n>md_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+    <span class=n>prompt_responses</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=n>include_all_parts</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=n>cli_yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>profile</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>allowed_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>comp_def</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>comp_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>component</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>comp_def_name_list</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>inherited_props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>rules_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>rules_params_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>control_implementation</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>uri_name_map</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>comp_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CompDict</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>merged_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>generate</span><span class=p>(</span>
+        <span class=bp>cls</span><span class=p>,</span>
+        <span class=n>purpose</span><span class=p>:</span> <span class=n>ContextPurpose</span><span class=p>,</span>
+        <span class=n>to_markdown</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>md_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>prompt_responses</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>include_all_parts</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>cli_yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>profile</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>allowed_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>comp_def</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>comp_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>component</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>comp_def_name_list</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>inherited_props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>rules_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>rules_params_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>control_implementation</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>uri_name_map</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>comp_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CompDict</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>merged_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ControlContext</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate control context of the needed type.&quot;&quot;&quot;</span>
+        <span class=n>context</span> <span class=o>=</span> <span class=bp>cls</span><span class=p>(</span>
+            <span class=n>purpose</span><span class=p>,</span>
+            <span class=n>to_markdown</span><span class=p>,</span>
+            <span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>md_root</span><span class=p>,</span>
+            <span class=n>prompt_responses</span><span class=p>,</span>
+            <span class=n>include_all_parts</span><span class=p>,</span>
+            <span class=n>overwrite_header_values</span><span class=p>,</span>
+            <span class=n>set_parameters_flag</span><span class=p>,</span>
+            <span class=n>cli_yaml_header</span><span class=o>=</span><span class=n>cli_yaml_header</span><span class=p>,</span>
+            <span class=n>sections_dict</span><span class=o>=</span><span class=n>sections_dict</span><span class=p>,</span>
+            <span class=n>profile</span><span class=o>=</span><span class=n>profile</span><span class=p>,</span>
+            <span class=n>required_sections</span><span class=o>=</span><span class=n>required_sections</span><span class=p>,</span>
+            <span class=n>allowed_sections</span><span class=o>=</span><span class=n>allowed_sections</span><span class=p>,</span>
+            <span class=n>comp_def</span><span class=o>=</span><span class=n>comp_def</span><span class=p>,</span>
+            <span class=n>comp_name</span><span class=o>=</span><span class=n>comp_name</span><span class=p>,</span>
+            <span class=n>component</span><span class=o>=</span><span class=n>component</span><span class=p>,</span>
+            <span class=n>comp_def_name_list</span><span class=o>=</span><span class=n>comp_def_name_list</span><span class=p>,</span>
+            <span class=n>inherited_props</span><span class=o>=</span><span class=n>inherited_props</span><span class=p>,</span>
+            <span class=n>rules_dict</span><span class=o>=</span><span class=n>rules_dict</span><span class=p>,</span>
+            <span class=n>rules_params_dict</span><span class=o>=</span><span class=n>rules_params_dict</span><span class=p>,</span>
+            <span class=n>control_implementation</span><span class=o>=</span><span class=n>control_implementation</span><span class=p>,</span>
+            <span class=n>uri_name_map</span><span class=o>=</span><span class=n>uri_name_map</span><span class=p>,</span>
+            <span class=n>comp_dict</span><span class=o>=</span><span class=n>comp_dict</span>
+        <span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span> <span class=o>=</span> <span class=n>as_dict</span><span class=p>(</span><span class=n>cli_yaml_header</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span> <span class=o>=</span> <span class=n>as_dict</span><span class=p>(</span><span class=n>sections_dict</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span> <span class=o>=</span> <span class=n>as_dict</span><span class=p>(</span><span class=n>merged_header</span><span class=p>)</span>
+        <span class=c1># catalog generate always sets params</span>
+        <span class=k>if</span> <span class=n>to_markdown</span><span class=p>:</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=n>context</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>clone</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ControlContext</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create a deep clone of the context without duplicating large objects.&quot;&quot;&quot;</span>
+        <span class=n>new_context</span> <span class=o>=</span> <span class=bp>cls</span><span class=p>(</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>purpose</span><span class=p>,</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>to_markdown</span><span class=p>,</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>prompt_responses</span><span class=p>,</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>include_all_parts</span><span class=p>,</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>set_parameters_flag</span><span class=p>,</span>
+            <span class=n>cli_yaml_header</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>),</span>
+            <span class=n>sections_dict</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span><span class=p>),</span>
+            <span class=n>profile</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>profile</span><span class=p>,</span>
+            <span class=n>required_sections</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>required_sections</span><span class=p>,</span>
+            <span class=n>allowed_sections</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>allowed_sections</span><span class=p>,</span>
+            <span class=n>comp_def</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>comp_def</span><span class=p>,</span>
+            <span class=n>comp_name</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span>
+            <span class=n>component</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>component</span><span class=p>,</span>
+            <span class=n>comp_def_name_list</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>comp_def_name_list</span><span class=p>,</span>
+            <span class=n>inherited_props</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>inherited_props</span><span class=p>),</span>
+            <span class=n>rules_dict</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>),</span>
+            <span class=n>rules_params_dict</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>),</span>
+            <span class=n>control_implementation</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span><span class=p>),</span>
+            <span class=n>uri_name_map</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>uri_name_map</span><span class=p>,</span>
+            <span class=n>comp_dict</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span><span class=p>),</span>
+            <span class=n>merged_header</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>)</span>
+        <span class=p>)</span>
+        <span class=k>return</span> <span class=n>new_context</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.control_context.ControlContext-attributes>Attributes<a href=#trestle.core.control_context.ControlContext-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.allowed_sections class="doc doc-heading"> <code class="highlight language-python"><span class=n>allowed_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.allowed_sections class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.cli_yaml_header class="doc doc-heading"> <code class="highlight language-python"><span class=n>cli_yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.cli_yaml_header class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.comp_def class="doc doc-heading"> <code class="highlight language-python"><span class=n>comp_def</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.comp_def class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.comp_def_name_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>comp_def_name_list</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.comp_def_name_list class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.comp_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>comp_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CompDict</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.comp_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.comp_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>comp_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.comp_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.component class="doc doc-heading"> <code class="highlight language-python"><span class=n>component</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.control_implementation class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_implementation</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.control_implementation class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.include_all_parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_all_parts</span><span class=p>:</span> <span class=nb>bool</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.include_all_parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.inherited_props class="doc doc-heading"> <code class="highlight language-python"><span class=n>inherited_props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.inherited_props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.md_root class="doc doc-heading"> <code class="highlight language-python"><span class=n>md_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.md_root class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.merged_header class="doc doc-heading"> <code class="highlight language-python"><span class=n>merged_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.merged_header class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.overwrite_header_values class="doc doc-heading"> <code class="highlight language-python"><span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.overwrite_header_values class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.profile class="doc doc-heading"> <code class="highlight language-python"><span class=n>profile</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.profile class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.prompt_responses class="doc doc-heading"> <code class="highlight language-python"><span class=n>prompt_responses</span><span class=p>:</span> <span class=nb>bool</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.prompt_responses class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.purpose class="doc doc-heading"> <code class="highlight language-python"><span class=n>purpose</span><span class=p>:</span> <span class=n>ContextPurpose</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.purpose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.required_sections class="doc doc-heading"> <code class="highlight language-python"><span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.required_sections class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.rules_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>rules_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.rules_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.rules_params_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>rules_params_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.rules_params_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.sections_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>sections_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.sections_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.set_parameters_flag class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.set_parameters_flag class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.to_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_markdown</span><span class=p>:</span> <span class=nb>bool</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.to_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.trestle_root class="doc doc-heading"> <code class="highlight language-python"><span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.trestle_root class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_context.ControlContext.uri_name_map class="doc doc-heading"> <code class="highlight language-python"><span class=n>uri_name_map</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_context.ControlContext.uri_name_map class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.control_context.ControlContext-functions>Functions<a href=#trestle.core.control_context.ControlContext-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_context.ControlContext.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>purpose</span><span class=p>,</span> <span class=n>to_markdown</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_root</span><span class=p>,</span> <span class=n>prompt_responses</span><span class=p>,</span> <span class=n>include_all_parts</span><span class=p>,</span> <span class=n>overwrite_header_values</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>,</span> <span class=n>cli_yaml_header</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>sections_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>profile</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>required_sections</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>allowed_sections</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>comp_def</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>comp_name</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>component</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>comp_def_name_list</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>inherited_props</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>rules_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>rules_params_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>control_implementation</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>uri_name_map</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>comp_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>merged_header</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.control_context.ControlContext.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_context.ControlContext.clone class="doc doc-heading"> <code class="highlight language-python"><span class=n>clone</span><span class=p>(</span><span class=n>context</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.control_context.ControlContext.clone class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create a deep clone of the context without duplicating large objects.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_context.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>clone</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ControlContext</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create a deep clone of the context without duplicating large objects.&quot;&quot;&quot;</span>
+    <span class=n>new_context</span> <span class=o>=</span> <span class=bp>cls</span><span class=p>(</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>purpose</span><span class=p>,</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>to_markdown</span><span class=p>,</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>trestle_root</span><span class=p>,</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>md_root</span><span class=p>,</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>prompt_responses</span><span class=p>,</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>include_all_parts</span><span class=p>,</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>set_parameters_flag</span><span class=p>,</span>
+        <span class=n>cli_yaml_header</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>),</span>
+        <span class=n>sections_dict</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span><span class=p>),</span>
+        <span class=n>profile</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>profile</span><span class=p>,</span>
+        <span class=n>required_sections</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>required_sections</span><span class=p>,</span>
+        <span class=n>allowed_sections</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>allowed_sections</span><span class=p>,</span>
+        <span class=n>comp_def</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>comp_def</span><span class=p>,</span>
+        <span class=n>comp_name</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>comp_name</span><span class=p>,</span>
+        <span class=n>component</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>component</span><span class=p>,</span>
+        <span class=n>comp_def_name_list</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>comp_def_name_list</span><span class=p>,</span>
+        <span class=n>inherited_props</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>inherited_props</span><span class=p>),</span>
+        <span class=n>rules_dict</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>rules_dict</span><span class=p>),</span>
+        <span class=n>rules_params_dict</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>rules_params_dict</span><span class=p>),</span>
+        <span class=n>control_implementation</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>control_implementation</span><span class=p>),</span>
+        <span class=n>uri_name_map</span><span class=o>=</span><span class=n>context</span><span class=o>.</span><span class=n>uri_name_map</span><span class=p>,</span>
+        <span class=n>comp_dict</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span><span class=p>),</span>
+        <span class=n>merged_header</span><span class=o>=</span><span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>)</span>
+    <span class=p>)</span>
+    <span class=k>return</span> <span class=n>new_context</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_context.ControlContext.generate class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate</span><span class=p>(</span><span class=n>purpose</span><span class=p>,</span> <span class=n>to_markdown</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>,</span> <span class=n>md_root</span><span class=p>,</span> <span class=n>prompt_responses</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>include_all_parts</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>overwrite_header_values</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>cli_yaml_header</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>sections_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>profile</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>required_sections</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>allowed_sections</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>comp_def</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>comp_name</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>component</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>comp_def_name_list</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>inherited_props</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>rules_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>rules_params_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>control_implementation</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>uri_name_map</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>comp_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>merged_header</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.control_context.ControlContext.generate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate control context of the needed type.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_context.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>generate</span><span class=p>(</span>
+    <span class=bp>cls</span><span class=p>,</span>
+    <span class=n>purpose</span><span class=p>:</span> <span class=n>ContextPurpose</span><span class=p>,</span>
+    <span class=n>to_markdown</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>md_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>prompt_responses</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>include_all_parts</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>cli_yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>profile</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>allowed_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>comp_def</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>comp_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>component</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>comp_def_name_list</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>inherited_props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>rules_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>rules_params_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>control_implementation</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>uri_name_map</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>comp_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CompDict</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>merged_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ControlContext</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate control context of the needed type.&quot;&quot;&quot;</span>
+    <span class=n>context</span> <span class=o>=</span> <span class=bp>cls</span><span class=p>(</span>
+        <span class=n>purpose</span><span class=p>,</span>
+        <span class=n>to_markdown</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>,</span>
+        <span class=n>md_root</span><span class=p>,</span>
+        <span class=n>prompt_responses</span><span class=p>,</span>
+        <span class=n>include_all_parts</span><span class=p>,</span>
+        <span class=n>overwrite_header_values</span><span class=p>,</span>
+        <span class=n>set_parameters_flag</span><span class=p>,</span>
+        <span class=n>cli_yaml_header</span><span class=o>=</span><span class=n>cli_yaml_header</span><span class=p>,</span>
+        <span class=n>sections_dict</span><span class=o>=</span><span class=n>sections_dict</span><span class=p>,</span>
+        <span class=n>profile</span><span class=o>=</span><span class=n>profile</span><span class=p>,</span>
+        <span class=n>required_sections</span><span class=o>=</span><span class=n>required_sections</span><span class=p>,</span>
+        <span class=n>allowed_sections</span><span class=o>=</span><span class=n>allowed_sections</span><span class=p>,</span>
+        <span class=n>comp_def</span><span class=o>=</span><span class=n>comp_def</span><span class=p>,</span>
+        <span class=n>comp_name</span><span class=o>=</span><span class=n>comp_name</span><span class=p>,</span>
+        <span class=n>component</span><span class=o>=</span><span class=n>component</span><span class=p>,</span>
+        <span class=n>comp_def_name_list</span><span class=o>=</span><span class=n>comp_def_name_list</span><span class=p>,</span>
+        <span class=n>inherited_props</span><span class=o>=</span><span class=n>inherited_props</span><span class=p>,</span>
+        <span class=n>rules_dict</span><span class=o>=</span><span class=n>rules_dict</span><span class=p>,</span>
+        <span class=n>rules_params_dict</span><span class=o>=</span><span class=n>rules_params_dict</span><span class=p>,</span>
+        <span class=n>control_implementation</span><span class=o>=</span><span class=n>control_implementation</span><span class=p>,</span>
+        <span class=n>uri_name_map</span><span class=o>=</span><span class=n>uri_name_map</span><span class=p>,</span>
+        <span class=n>comp_dict</span><span class=o>=</span><span class=n>comp_dict</span>
+    <span class=p>)</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span> <span class=o>=</span> <span class=n>as_dict</span><span class=p>(</span><span class=n>cli_yaml_header</span><span class=p>)</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span> <span class=o>=</span> <span class=n>as_dict</span><span class=p>(</span><span class=n>sections_dict</span><span class=p>)</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span> <span class=o>=</span> <span class=n>as_dict</span><span class=p>(</span><span class=n>merged_header</span><span class=p>)</span>
+    <span class=c1># catalog generate always sets params</span>
+    <span class=k>if</span> <span class=n>to_markdown</span><span class=p>:</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=n>context</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.control_context-functions>Functions<a href=#trestle.core.control_context-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/control_interface/index.html b/latest/reference/API/trestle/core/control_interface/index.html
new file mode 100644
index 000000000..a993159f9
--- /dev/null
+++ b/latest/reference/API/trestle/core/control_interface/index.html
@@ -0,0 +1,3638 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.control_interface module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_interface/ rel=canonical><link href=../control_context/ rel=prev><link href=../control_reader/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.control_interface - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.control_interface - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.control_interface module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/control_interface.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_interface/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.control_interface - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.control_interface module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/control_interface.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.control_interface class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.control_interface </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.control_interface </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.control_interface </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.control_interface class=md-nav__link> <span class=md-ellipsis> control_interface </span> </a> <nav class=md-nav aria-label=control_interface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.CompDict class=md-nav__link> <span class=md-ellipsis> CompDict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo class=md-nav__link> <span class=md-ellipsis> ComponentImpInfo </span> </a> <nav class=md-nav aria-label=ComponentImpInfo> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.rules class=md-nav__link> <span class=md-ellipsis> rules </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface class=md-nav__link> <span class=md-ellipsis> ControlInterface </span> </a> <nav class=md-nav aria-label=ControlInterface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.bad_header class=md-nav__link> <span class=md-ellipsis> bad_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.clean_props class=md-nav__link> <span class=md-ellipsis> clean_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.create_statement_id class=md-nav__link> <span class=md-ellipsis> create_statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.cull_props_by_rules class=md-nav__link> <span class=md-ellipsis> cull_props_by_rules </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_all_add_info class=md-nav__link> <span class=md-ellipsis> get_all_add_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_component_by_name class=md-nav__link> <span class=md-ellipsis> get_component_by_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_control_param_dict class=md-nav__link> <span class=md-ellipsis> get_control_param_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_control_section_prose class=md-nav__link> <span class=md-ellipsis> get_control_section_prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_label class=md-nav__link> <span class=md-ellipsis> get_label </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_params_dict_from_item class=md-nav__link> <span class=md-ellipsis> get_params_dict_from_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_part class=md-nav__link> <span class=md-ellipsis> get_part </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_part_by_id class=md-nav__link> <span class=md-ellipsis> get_part_by_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_part_prose class=md-nav__link> <span class=md-ellipsis> get_part_prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_prop class=md-nav__link> <span class=md-ellipsis> get_prop </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_rule_list_for_imp_req class=md-nav__link> <span class=md-ellipsis> get_rule_list_for_imp_req </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_rule_list_for_item class=md-nav__link> <span class=md-ellipsis> get_rule_list_for_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_rules_and_params_dict_from_item class=md-nav__link> <span class=md-ellipsis> get_rules_and_params_dict_from_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_rules_dict_from_item class=md-nav__link> <span class=md-ellipsis> get_rules_dict_from_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_section class=md-nav__link> <span class=md-ellipsis> get_section </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_set_params_from_item class=md-nav__link> <span class=md-ellipsis> get_set_params_from_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_sort_id class=md-nav__link> <span class=md-ellipsis> get_sort_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_statement_id class=md-nav__link> <span class=md-ellipsis> get_statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_status_from_props class=md-nav__link> <span class=md-ellipsis> get_status_from_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.insert_imp_req_into_component class=md-nav__link> <span class=md-ellipsis> insert_imp_req_into_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.insert_status_in_props class=md-nav__link> <span class=md-ellipsis> insert_status_in_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.is_withdrawn class=md-nav__link> <span class=md-ellipsis> is_withdrawn </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.item_has_rules class=md-nav__link> <span class=md-ellipsis> item_has_rules </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.merge_dicts_deep class=md-nav__link> <span class=md-ellipsis> merge_dicts_deep </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.merge_part class=md-nav__link> <span class=md-ellipsis> merge_part </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.merge_parts class=md-nav__link> <span class=md-ellipsis> merge_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.merge_props class=md-nav__link> <span class=md-ellipsis> merge_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.param_to_str class=md-nav__link> <span class=md-ellipsis> param_to_str </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.replace_control_prose class=md-nav__link> <span class=md-ellipsis> replace_control_prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.setparam_to_param class=md-nav__link> <span class=md-ellipsis> setparam_to_param </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.strip_to_make_ncname class=md-nav__link> <span class=md-ellipsis> strip_to_make_ncname </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.uniquify_set_params class=md-nav__link> <span class=md-ellipsis> uniquify_set_params </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep class=md-nav__link> <span class=md-ellipsis> ParameterRep </span> </a> <nav class=md-nav aria-label=ParameterRep> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.ASSIGNMENT_FORM class=md-nav__link> <span class=md-ellipsis> ASSIGNMENT_FORM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.LABEL_FORM class=md-nav__link> <span class=md-ellipsis> LABEL_FORM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.LABEL_OR_CHOICES class=md-nav__link> <span class=md-ellipsis> LABEL_OR_CHOICES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.LEAVE_MOUSTACHE class=md-nav__link> <span class=md-ellipsis> LEAVE_MOUSTACHE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.VALUE_OR_EMPTY_STRING class=md-nav__link> <span class=md-ellipsis> VALUE_OR_EMPTY_STRING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.VALUE_OR_LABEL_OR_CHOICES class=md-nav__link> <span class=md-ellipsis> VALUE_OR_LABEL_OR_CHOICES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.VALUE_OR_STRING_NONE class=md-nav__link> <span class=md-ellipsis> VALUE_OR_STRING_NONE </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo class=md-nav__link> <span class=md-ellipsis> PartInfo </span> </a> <nav class=md-nav aria-label=PartInfo> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.smt_part class=md-nav__link> <span class=md-ellipsis> smt_part </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.to_dicts class=md-nav__link> <span class=md-ellipsis> to_dicts </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.control_interface class=md-nav__link> <span class=md-ellipsis> control_interface </span> </a> <nav class=md-nav aria-label=control_interface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.CompDict class=md-nav__link> <span class=md-ellipsis> CompDict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo class=md-nav__link> <span class=md-ellipsis> ComponentImpInfo </span> </a> <nav class=md-nav aria-label=ComponentImpInfo> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.rules class=md-nav__link> <span class=md-ellipsis> rules </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ComponentImpInfo.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface class=md-nav__link> <span class=md-ellipsis> ControlInterface </span> </a> <nav class=md-nav aria-label=ControlInterface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.bad_header class=md-nav__link> <span class=md-ellipsis> bad_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.clean_props class=md-nav__link> <span class=md-ellipsis> clean_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.create_statement_id class=md-nav__link> <span class=md-ellipsis> create_statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.cull_props_by_rules class=md-nav__link> <span class=md-ellipsis> cull_props_by_rules </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_all_add_info class=md-nav__link> <span class=md-ellipsis> get_all_add_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_component_by_name class=md-nav__link> <span class=md-ellipsis> get_component_by_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_control_param_dict class=md-nav__link> <span class=md-ellipsis> get_control_param_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_control_section_prose class=md-nav__link> <span class=md-ellipsis> get_control_section_prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_label class=md-nav__link> <span class=md-ellipsis> get_label </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_params_dict_from_item class=md-nav__link> <span class=md-ellipsis> get_params_dict_from_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_part class=md-nav__link> <span class=md-ellipsis> get_part </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_part_by_id class=md-nav__link> <span class=md-ellipsis> get_part_by_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_part_prose class=md-nav__link> <span class=md-ellipsis> get_part_prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_prop class=md-nav__link> <span class=md-ellipsis> get_prop </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_rule_list_for_imp_req class=md-nav__link> <span class=md-ellipsis> get_rule_list_for_imp_req </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_rule_list_for_item class=md-nav__link> <span class=md-ellipsis> get_rule_list_for_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_rules_and_params_dict_from_item class=md-nav__link> <span class=md-ellipsis> get_rules_and_params_dict_from_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_rules_dict_from_item class=md-nav__link> <span class=md-ellipsis> get_rules_dict_from_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_section class=md-nav__link> <span class=md-ellipsis> get_section </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_set_params_from_item class=md-nav__link> <span class=md-ellipsis> get_set_params_from_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_sort_id class=md-nav__link> <span class=md-ellipsis> get_sort_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_statement_id class=md-nav__link> <span class=md-ellipsis> get_statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.get_status_from_props class=md-nav__link> <span class=md-ellipsis> get_status_from_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.insert_imp_req_into_component class=md-nav__link> <span class=md-ellipsis> insert_imp_req_into_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.insert_status_in_props class=md-nav__link> <span class=md-ellipsis> insert_status_in_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.is_withdrawn class=md-nav__link> <span class=md-ellipsis> is_withdrawn </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.item_has_rules class=md-nav__link> <span class=md-ellipsis> item_has_rules </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.merge_dicts_deep class=md-nav__link> <span class=md-ellipsis> merge_dicts_deep </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.merge_part class=md-nav__link> <span class=md-ellipsis> merge_part </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.merge_parts class=md-nav__link> <span class=md-ellipsis> merge_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.merge_props class=md-nav__link> <span class=md-ellipsis> merge_props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.param_to_str class=md-nav__link> <span class=md-ellipsis> param_to_str </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.replace_control_prose class=md-nav__link> <span class=md-ellipsis> replace_control_prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.setparam_to_param class=md-nav__link> <span class=md-ellipsis> setparam_to_param </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.strip_to_make_ncname class=md-nav__link> <span class=md-ellipsis> strip_to_make_ncname </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ControlInterface.uniquify_set_params class=md-nav__link> <span class=md-ellipsis> uniquify_set_params </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep class=md-nav__link> <span class=md-ellipsis> ParameterRep </span> </a> <nav class=md-nav aria-label=ParameterRep> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.ASSIGNMENT_FORM class=md-nav__link> <span class=md-ellipsis> ASSIGNMENT_FORM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.LABEL_FORM class=md-nav__link> <span class=md-ellipsis> LABEL_FORM </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.LABEL_OR_CHOICES class=md-nav__link> <span class=md-ellipsis> LABEL_OR_CHOICES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.LEAVE_MOUSTACHE class=md-nav__link> <span class=md-ellipsis> LEAVE_MOUSTACHE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.VALUE_OR_EMPTY_STRING class=md-nav__link> <span class=md-ellipsis> VALUE_OR_EMPTY_STRING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.VALUE_OR_LABEL_OR_CHOICES class=md-nav__link> <span class=md-ellipsis> VALUE_OR_LABEL_OR_CHOICES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.ParameterRep.VALUE_OR_STRING_NONE class=md-nav__link> <span class=md-ellipsis> VALUE_OR_STRING_NONE </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo class=md-nav__link> <span class=md-ellipsis> PartInfo </span> </a> <nav class=md-nav aria-label=PartInfo> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.smt_part class=md-nav__link> <span class=md-ellipsis> smt_part </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface.PartInfo.to_dicts class=md-nav__link> <span class=md-ellipsis> to_dicts </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_interface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.control_interface</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.control_interface class="doc doc-heading"> <code>trestle.core.control_interface</code> <a href=#trestle.core.control_interface class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Handle queries and utility operations on controls in memory.</p> <div class="doc doc-children"> <h3 id=trestle.core.control_interface-attributes>Attributes<a href=#trestle.core.control_interface-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.control_interface.CompDict class="doc doc-heading"> <code class="highlight language-python"><span class=n>CompDict</span> <span class=o>=</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ComponentImpInfo</span><span class=p>]]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.control_interface.CompDict class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.control_interface.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.control_interface.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.control_interface-classes>Classes<a href=#trestle.core.control_interface-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.control_interface.ComponentImpInfo class="doc doc-heading"> <code>ComponentImpInfo</code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> </span> <a href=#trestle.core.control_interface.ComponentImpInfo class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class to capture component prose and status.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@dataclass</span>
+<span class=k>class</span> <span class=nc>ComponentImpInfo</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to capture component prose and status.&quot;&quot;&quot;</span>
+
+    <span class=n>prose</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=n>rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span>
+    <span class=c1># the lambda is needed to prevent a mutable from being used as a default</span>
+    <span class=c1># without the lambda it would break python 3.11 and is a bug either way</span>
+    <span class=n>status</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span> <span class=o>=</span> <span class=n>field</span><span class=p>(</span>
+        <span class=n>default_factory</span><span class=o>=</span><span class=k>lambda</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span><span class=p>)</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.control_interface.ComponentImpInfo-attributes>Attributes<a href=#trestle.core.control_interface.ComponentImpInfo-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ComponentImpInfo.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ComponentImpInfo.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ComponentImpInfo.prose class="doc doc-heading"> <code class="highlight language-python"><span class=n>prose</span><span class=p>:</span> <span class=nb>str</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ComponentImpInfo.prose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ComponentImpInfo.rules class="doc doc-heading"> <code class="highlight language-python"><span class=n>rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ComponentImpInfo.rules class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ComponentImpInfo.status class="doc doc-heading"> <code class="highlight language-python"><span class=n>status</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span> <span class=o>=</span> <span class=n>field</span><span class=p>(</span><span class=n>default_factory</span><span class=o>=</span><span class=k>lambda</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span><span class=p>))</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ComponentImpInfo.status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.control_interface.ComponentImpInfo-functions>Functions<a href=#trestle.core.control_interface.ComponentImpInfo-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ComponentImpInfo.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>prose</span><span class=p>,</span> <span class=n>rules</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>status</span><span class=o>=</span><span class=k>lambda</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span><span class=p>)())</span></code> <a href=#trestle.core.control_interface.ComponentImpInfo.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.control_interface.ControlInterface class="doc doc-heading"> <code>ControlInterface</code> <a href=#trestle.core.control_interface.ControlInterface class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class to interact with controls in memory.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 107</span>
+<span class=normal> 108</span>
+<span class=normal> 109</span>
+<span class=normal> 110</span>
+<span class=normal> 111</span>
+<span class=normal> 112</span>
+<span class=normal> 113</span>
+<span class=normal> 114</span>
+<span class=normal> 115</span>
+<span class=normal> 116</span>
+<span class=normal> 117</span>
+<span class=normal> 118</span>
+<span class=normal> 119</span>
+<span class=normal> 120</span>
+<span class=normal> 121</span>
+<span class=normal> 122</span>
+<span class=normal> 123</span>
+<span class=normal> 124</span>
+<span class=normal> 125</span>
+<span class=normal> 126</span>
+<span class=normal> 127</span>
+<span class=normal> 128</span>
+<span class=normal> 129</span>
+<span class=normal> 130</span>
+<span class=normal> 131</span>
+<span class=normal> 132</span>
+<span class=normal> 133</span>
+<span class=normal> 134</span>
+<span class=normal> 135</span>
+<span class=normal> 136</span>
+<span class=normal> 137</span>
+<span class=normal> 138</span>
+<span class=normal> 139</span>
+<span class=normal> 140</span>
+<span class=normal> 141</span>
+<span class=normal> 142</span>
+<span class=normal> 143</span>
+<span class=normal> 144</span>
+<span class=normal> 145</span>
+<span class=normal> 146</span>
+<span class=normal> 147</span>
+<span class=normal> 148</span>
+<span class=normal> 149</span>
+<span class=normal> 150</span>
+<span class=normal> 151</span>
+<span class=normal> 152</span>
+<span class=normal> 153</span>
+<span class=normal> 154</span>
+<span class=normal> 155</span>
+<span class=normal> 156</span>
+<span class=normal> 157</span>
+<span class=normal> 158</span>
+<span class=normal> 159</span>
+<span class=normal> 160</span>
+<span class=normal> 161</span>
+<span class=normal> 162</span>
+<span class=normal> 163</span>
+<span class=normal> 164</span>
+<span class=normal> 165</span>
+<span class=normal> 166</span>
+<span class=normal> 167</span>
+<span class=normal> 168</span>
+<span class=normal> 169</span>
+<span class=normal> 170</span>
+<span class=normal> 171</span>
+<span class=normal> 172</span>
+<span class=normal> 173</span>
+<span class=normal> 174</span>
+<span class=normal> 175</span>
+<span class=normal> 176</span>
+<span class=normal> 177</span>
+<span class=normal> 178</span>
+<span class=normal> 179</span>
+<span class=normal> 180</span>
+<span class=normal> 181</span>
+<span class=normal> 182</span>
+<span class=normal> 183</span>
+<span class=normal> 184</span>
+<span class=normal> 185</span>
+<span class=normal> 186</span>
+<span class=normal> 187</span>
+<span class=normal> 188</span>
+<span class=normal> 189</span>
+<span class=normal> 190</span>
+<span class=normal> 191</span>
+<span class=normal> 192</span>
+<span class=normal> 193</span>
+<span class=normal> 194</span>
+<span class=normal> 195</span>
+<span class=normal> 196</span>
+<span class=normal> 197</span>
+<span class=normal> 198</span>
+<span class=normal> 199</span>
+<span class=normal> 200</span>
+<span class=normal> 201</span>
+<span class=normal> 202</span>
+<span class=normal> 203</span>
+<span class=normal> 204</span>
+<span class=normal> 205</span>
+<span class=normal> 206</span>
+<span class=normal> 207</span>
+<span class=normal> 208</span>
+<span class=normal> 209</span>
+<span class=normal> 210</span>
+<span class=normal> 211</span>
+<span class=normal> 212</span>
+<span class=normal> 213</span>
+<span class=normal> 214</span>
+<span class=normal> 215</span>
+<span class=normal> 216</span>
+<span class=normal> 217</span>
+<span class=normal> 218</span>
+<span class=normal> 219</span>
+<span class=normal> 220</span>
+<span class=normal> 221</span>
+<span class=normal> 222</span>
+<span class=normal> 223</span>
+<span class=normal> 224</span>
+<span class=normal> 225</span>
+<span class=normal> 226</span>
+<span class=normal> 227</span>
+<span class=normal> 228</span>
+<span class=normal> 229</span>
+<span class=normal> 230</span>
+<span class=normal> 231</span>
+<span class=normal> 232</span>
+<span class=normal> 233</span>
+<span class=normal> 234</span>
+<span class=normal> 235</span>
+<span class=normal> 236</span>
+<span class=normal> 237</span>
+<span class=normal> 238</span>
+<span class=normal> 239</span>
+<span class=normal> 240</span>
+<span class=normal> 241</span>
+<span class=normal> 242</span>
+<span class=normal> 243</span>
+<span class=normal> 244</span>
+<span class=normal> 245</span>
+<span class=normal> 246</span>
+<span class=normal> 247</span>
+<span class=normal> 248</span>
+<span class=normal> 249</span>
+<span class=normal> 250</span>
+<span class=normal> 251</span>
+<span class=normal> 252</span>
+<span class=normal> 253</span>
+<span class=normal> 254</span>
+<span class=normal> 255</span>
+<span class=normal> 256</span>
+<span class=normal> 257</span>
+<span class=normal> 258</span>
+<span class=normal> 259</span>
+<span class=normal> 260</span>
+<span class=normal> 261</span>
+<span class=normal> 262</span>
+<span class=normal> 263</span>
+<span class=normal> 264</span>
+<span class=normal> 265</span>
+<span class=normal> 266</span>
+<span class=normal> 267</span>
+<span class=normal> 268</span>
+<span class=normal> 269</span>
+<span class=normal> 270</span>
+<span class=normal> 271</span>
+<span class=normal> 272</span>
+<span class=normal> 273</span>
+<span class=normal> 274</span>
+<span class=normal> 275</span>
+<span class=normal> 276</span>
+<span class=normal> 277</span>
+<span class=normal> 278</span>
+<span class=normal> 279</span>
+<span class=normal> 280</span>
+<span class=normal> 281</span>
+<span class=normal> 282</span>
+<span class=normal> 283</span>
+<span class=normal> 284</span>
+<span class=normal> 285</span>
+<span class=normal> 286</span>
+<span class=normal> 287</span>
+<span class=normal> 288</span>
+<span class=normal> 289</span>
+<span class=normal> 290</span>
+<span class=normal> 291</span>
+<span class=normal> 292</span>
+<span class=normal> 293</span>
+<span class=normal> 294</span>
+<span class=normal> 295</span>
+<span class=normal> 296</span>
+<span class=normal> 297</span>
+<span class=normal> 298</span>
+<span class=normal> 299</span>
+<span class=normal> 300</span>
+<span class=normal> 301</span>
+<span class=normal> 302</span>
+<span class=normal> 303</span>
+<span class=normal> 304</span>
+<span class=normal> 305</span>
+<span class=normal> 306</span>
+<span class=normal> 307</span>
+<span class=normal> 308</span>
+<span class=normal> 309</span>
+<span class=normal> 310</span>
+<span class=normal> 311</span>
+<span class=normal> 312</span>
+<span class=normal> 313</span>
+<span class=normal> 314</span>
+<span class=normal> 315</span>
+<span class=normal> 316</span>
+<span class=normal> 317</span>
+<span class=normal> 318</span>
+<span class=normal> 319</span>
+<span class=normal> 320</span>
+<span class=normal> 321</span>
+<span class=normal> 322</span>
+<span class=normal> 323</span>
+<span class=normal> 324</span>
+<span class=normal> 325</span>
+<span class=normal> 326</span>
+<span class=normal> 327</span>
+<span class=normal> 328</span>
+<span class=normal> 329</span>
+<span class=normal> 330</span>
+<span class=normal> 331</span>
+<span class=normal> 332</span>
+<span class=normal> 333</span>
+<span class=normal> 334</span>
+<span class=normal> 335</span>
+<span class=normal> 336</span>
+<span class=normal> 337</span>
+<span class=normal> 338</span>
+<span class=normal> 339</span>
+<span class=normal> 340</span>
+<span class=normal> 341</span>
+<span class=normal> 342</span>
+<span class=normal> 343</span>
+<span class=normal> 344</span>
+<span class=normal> 345</span>
+<span class=normal> 346</span>
+<span class=normal> 347</span>
+<span class=normal> 348</span>
+<span class=normal> 349</span>
+<span class=normal> 350</span>
+<span class=normal> 351</span>
+<span class=normal> 352</span>
+<span class=normal> 353</span>
+<span class=normal> 354</span>
+<span class=normal> 355</span>
+<span class=normal> 356</span>
+<span class=normal> 357</span>
+<span class=normal> 358</span>
+<span class=normal> 359</span>
+<span class=normal> 360</span>
+<span class=normal> 361</span>
+<span class=normal> 362</span>
+<span class=normal> 363</span>
+<span class=normal> 364</span>
+<span class=normal> 365</span>
+<span class=normal> 366</span>
+<span class=normal> 367</span>
+<span class=normal> 368</span>
+<span class=normal> 369</span>
+<span class=normal> 370</span>
+<span class=normal> 371</span>
+<span class=normal> 372</span>
+<span class=normal> 373</span>
+<span class=normal> 374</span>
+<span class=normal> 375</span>
+<span class=normal> 376</span>
+<span class=normal> 377</span>
+<span class=normal> 378</span>
+<span class=normal> 379</span>
+<span class=normal> 380</span>
+<span class=normal> 381</span>
+<span class=normal> 382</span>
+<span class=normal> 383</span>
+<span class=normal> 384</span>
+<span class=normal> 385</span>
+<span class=normal> 386</span>
+<span class=normal> 387</span>
+<span class=normal> 388</span>
+<span class=normal> 389</span>
+<span class=normal> 390</span>
+<span class=normal> 391</span>
+<span class=normal> 392</span>
+<span class=normal> 393</span>
+<span class=normal> 394</span>
+<span class=normal> 395</span>
+<span class=normal> 396</span>
+<span class=normal> 397</span>
+<span class=normal> 398</span>
+<span class=normal> 399</span>
+<span class=normal> 400</span>
+<span class=normal> 401</span>
+<span class=normal> 402</span>
+<span class=normal> 403</span>
+<span class=normal> 404</span>
+<span class=normal> 405</span>
+<span class=normal> 406</span>
+<span class=normal> 407</span>
+<span class=normal> 408</span>
+<span class=normal> 409</span>
+<span class=normal> 410</span>
+<span class=normal> 411</span>
+<span class=normal> 412</span>
+<span class=normal> 413</span>
+<span class=normal> 414</span>
+<span class=normal> 415</span>
+<span class=normal> 416</span>
+<span class=normal> 417</span>
+<span class=normal> 418</span>
+<span class=normal> 419</span>
+<span class=normal> 420</span>
+<span class=normal> 421</span>
+<span class=normal> 422</span>
+<span class=normal> 423</span>
+<span class=normal> 424</span>
+<span class=normal> 425</span>
+<span class=normal> 426</span>
+<span class=normal> 427</span>
+<span class=normal> 428</span>
+<span class=normal> 429</span>
+<span class=normal> 430</span>
+<span class=normal> 431</span>
+<span class=normal> 432</span>
+<span class=normal> 433</span>
+<span class=normal> 434</span>
+<span class=normal> 435</span>
+<span class=normal> 436</span>
+<span class=normal> 437</span>
+<span class=normal> 438</span>
+<span class=normal> 439</span>
+<span class=normal> 440</span>
+<span class=normal> 441</span>
+<span class=normal> 442</span>
+<span class=normal> 443</span>
+<span class=normal> 444</span>
+<span class=normal> 445</span>
+<span class=normal> 446</span>
+<span class=normal> 447</span>
+<span class=normal> 448</span>
+<span class=normal> 449</span>
+<span class=normal> 450</span>
+<span class=normal> 451</span>
+<span class=normal> 452</span>
+<span class=normal> 453</span>
+<span class=normal> 454</span>
+<span class=normal> 455</span>
+<span class=normal> 456</span>
+<span class=normal> 457</span>
+<span class=normal> 458</span>
+<span class=normal> 459</span>
+<span class=normal> 460</span>
+<span class=normal> 461</span>
+<span class=normal> 462</span>
+<span class=normal> 463</span>
+<span class=normal> 464</span>
+<span class=normal> 465</span>
+<span class=normal> 466</span>
+<span class=normal> 467</span>
+<span class=normal> 468</span>
+<span class=normal> 469</span>
+<span class=normal> 470</span>
+<span class=normal> 471</span>
+<span class=normal> 472</span>
+<span class=normal> 473</span>
+<span class=normal> 474</span>
+<span class=normal> 475</span>
+<span class=normal> 476</span>
+<span class=normal> 477</span>
+<span class=normal> 478</span>
+<span class=normal> 479</span>
+<span class=normal> 480</span>
+<span class=normal> 481</span>
+<span class=normal> 482</span>
+<span class=normal> 483</span>
+<span class=normal> 484</span>
+<span class=normal> 485</span>
+<span class=normal> 486</span>
+<span class=normal> 487</span>
+<span class=normal> 488</span>
+<span class=normal> 489</span>
+<span class=normal> 490</span>
+<span class=normal> 491</span>
+<span class=normal> 492</span>
+<span class=normal> 493</span>
+<span class=normal> 494</span>
+<span class=normal> 495</span>
+<span class=normal> 496</span>
+<span class=normal> 497</span>
+<span class=normal> 498</span>
+<span class=normal> 499</span>
+<span class=normal> 500</span>
+<span class=normal> 501</span>
+<span class=normal> 502</span>
+<span class=normal> 503</span>
+<span class=normal> 504</span>
+<span class=normal> 505</span>
+<span class=normal> 506</span>
+<span class=normal> 507</span>
+<span class=normal> 508</span>
+<span class=normal> 509</span>
+<span class=normal> 510</span>
+<span class=normal> 511</span>
+<span class=normal> 512</span>
+<span class=normal> 513</span>
+<span class=normal> 514</span>
+<span class=normal> 515</span>
+<span class=normal> 516</span>
+<span class=normal> 517</span>
+<span class=normal> 518</span>
+<span class=normal> 519</span>
+<span class=normal> 520</span>
+<span class=normal> 521</span>
+<span class=normal> 522</span>
+<span class=normal> 523</span>
+<span class=normal> 524</span>
+<span class=normal> 525</span>
+<span class=normal> 526</span>
+<span class=normal> 527</span>
+<span class=normal> 528</span>
+<span class=normal> 529</span>
+<span class=normal> 530</span>
+<span class=normal> 531</span>
+<span class=normal> 532</span>
+<span class=normal> 533</span>
+<span class=normal> 534</span>
+<span class=normal> 535</span>
+<span class=normal> 536</span>
+<span class=normal> 537</span>
+<span class=normal> 538</span>
+<span class=normal> 539</span>
+<span class=normal> 540</span>
+<span class=normal> 541</span>
+<span class=normal> 542</span>
+<span class=normal> 543</span>
+<span class=normal> 544</span>
+<span class=normal> 545</span>
+<span class=normal> 546</span>
+<span class=normal> 547</span>
+<span class=normal> 548</span>
+<span class=normal> 549</span>
+<span class=normal> 550</span>
+<span class=normal> 551</span>
+<span class=normal> 552</span>
+<span class=normal> 553</span>
+<span class=normal> 554</span>
+<span class=normal> 555</span>
+<span class=normal> 556</span>
+<span class=normal> 557</span>
+<span class=normal> 558</span>
+<span class=normal> 559</span>
+<span class=normal> 560</span>
+<span class=normal> 561</span>
+<span class=normal> 562</span>
+<span class=normal> 563</span>
+<span class=normal> 564</span>
+<span class=normal> 565</span>
+<span class=normal> 566</span>
+<span class=normal> 567</span>
+<span class=normal> 568</span>
+<span class=normal> 569</span>
+<span class=normal> 570</span>
+<span class=normal> 571</span>
+<span class=normal> 572</span>
+<span class=normal> 573</span>
+<span class=normal> 574</span>
+<span class=normal> 575</span>
+<span class=normal> 576</span>
+<span class=normal> 577</span>
+<span class=normal> 578</span>
+<span class=normal> 579</span>
+<span class=normal> 580</span>
+<span class=normal> 581</span>
+<span class=normal> 582</span>
+<span class=normal> 583</span>
+<span class=normal> 584</span>
+<span class=normal> 585</span>
+<span class=normal> 586</span>
+<span class=normal> 587</span>
+<span class=normal> 588</span>
+<span class=normal> 589</span>
+<span class=normal> 590</span>
+<span class=normal> 591</span>
+<span class=normal> 592</span>
+<span class=normal> 593</span>
+<span class=normal> 594</span>
+<span class=normal> 595</span>
+<span class=normal> 596</span>
+<span class=normal> 597</span>
+<span class=normal> 598</span>
+<span class=normal> 599</span>
+<span class=normal> 600</span>
+<span class=normal> 601</span>
+<span class=normal> 602</span>
+<span class=normal> 603</span>
+<span class=normal> 604</span>
+<span class=normal> 605</span>
+<span class=normal> 606</span>
+<span class=normal> 607</span>
+<span class=normal> 608</span>
+<span class=normal> 609</span>
+<span class=normal> 610</span>
+<span class=normal> 611</span>
+<span class=normal> 612</span>
+<span class=normal> 613</span>
+<span class=normal> 614</span>
+<span class=normal> 615</span>
+<span class=normal> 616</span>
+<span class=normal> 617</span>
+<span class=normal> 618</span>
+<span class=normal> 619</span>
+<span class=normal> 620</span>
+<span class=normal> 621</span>
+<span class=normal> 622</span>
+<span class=normal> 623</span>
+<span class=normal> 624</span>
+<span class=normal> 625</span>
+<span class=normal> 626</span>
+<span class=normal> 627</span>
+<span class=normal> 628</span>
+<span class=normal> 629</span>
+<span class=normal> 630</span>
+<span class=normal> 631</span>
+<span class=normal> 632</span>
+<span class=normal> 633</span>
+<span class=normal> 634</span>
+<span class=normal> 635</span>
+<span class=normal> 636</span>
+<span class=normal> 637</span>
+<span class=normal> 638</span>
+<span class=normal> 639</span>
+<span class=normal> 640</span>
+<span class=normal> 641</span>
+<span class=normal> 642</span>
+<span class=normal> 643</span>
+<span class=normal> 644</span>
+<span class=normal> 645</span>
+<span class=normal> 646</span>
+<span class=normal> 647</span>
+<span class=normal> 648</span>
+<span class=normal> 649</span>
+<span class=normal> 650</span>
+<span class=normal> 651</span>
+<span class=normal> 652</span>
+<span class=normal> 653</span>
+<span class=normal> 654</span>
+<span class=normal> 655</span>
+<span class=normal> 656</span>
+<span class=normal> 657</span>
+<span class=normal> 658</span>
+<span class=normal> 659</span>
+<span class=normal> 660</span>
+<span class=normal> 661</span>
+<span class=normal> 662</span>
+<span class=normal> 663</span>
+<span class=normal> 664</span>
+<span class=normal> 665</span>
+<span class=normal> 666</span>
+<span class=normal> 667</span>
+<span class=normal> 668</span>
+<span class=normal> 669</span>
+<span class=normal> 670</span>
+<span class=normal> 671</span>
+<span class=normal> 672</span>
+<span class=normal> 673</span>
+<span class=normal> 674</span>
+<span class=normal> 675</span>
+<span class=normal> 676</span>
+<span class=normal> 677</span>
+<span class=normal> 678</span>
+<span class=normal> 679</span>
+<span class=normal> 680</span>
+<span class=normal> 681</span>
+<span class=normal> 682</span>
+<span class=normal> 683</span>
+<span class=normal> 684</span>
+<span class=normal> 685</span>
+<span class=normal> 686</span>
+<span class=normal> 687</span>
+<span class=normal> 688</span>
+<span class=normal> 689</span>
+<span class=normal> 690</span>
+<span class=normal> 691</span>
+<span class=normal> 692</span>
+<span class=normal> 693</span>
+<span class=normal> 694</span>
+<span class=normal> 695</span>
+<span class=normal> 696</span>
+<span class=normal> 697</span>
+<span class=normal> 698</span>
+<span class=normal> 699</span>
+<span class=normal> 700</span>
+<span class=normal> 701</span>
+<span class=normal> 702</span>
+<span class=normal> 703</span>
+<span class=normal> 704</span>
+<span class=normal> 705</span>
+<span class=normal> 706</span>
+<span class=normal> 707</span>
+<span class=normal> 708</span>
+<span class=normal> 709</span>
+<span class=normal> 710</span>
+<span class=normal> 711</span>
+<span class=normal> 712</span>
+<span class=normal> 713</span>
+<span class=normal> 714</span>
+<span class=normal> 715</span>
+<span class=normal> 716</span>
+<span class=normal> 717</span>
+<span class=normal> 718</span>
+<span class=normal> 719</span>
+<span class=normal> 720</span>
+<span class=normal> 721</span>
+<span class=normal> 722</span>
+<span class=normal> 723</span>
+<span class=normal> 724</span>
+<span class=normal> 725</span>
+<span class=normal> 726</span>
+<span class=normal> 727</span>
+<span class=normal> 728</span>
+<span class=normal> 729</span>
+<span class=normal> 730</span>
+<span class=normal> 731</span>
+<span class=normal> 732</span>
+<span class=normal> 733</span>
+<span class=normal> 734</span>
+<span class=normal> 735</span>
+<span class=normal> 736</span>
+<span class=normal> 737</span>
+<span class=normal> 738</span>
+<span class=normal> 739</span>
+<span class=normal> 740</span>
+<span class=normal> 741</span>
+<span class=normal> 742</span>
+<span class=normal> 743</span>
+<span class=normal> 744</span>
+<span class=normal> 745</span>
+<span class=normal> 746</span>
+<span class=normal> 747</span>
+<span class=normal> 748</span>
+<span class=normal> 749</span>
+<span class=normal> 750</span>
+<span class=normal> 751</span>
+<span class=normal> 752</span>
+<span class=normal> 753</span>
+<span class=normal> 754</span>
+<span class=normal> 755</span>
+<span class=normal> 756</span>
+<span class=normal> 757</span>
+<span class=normal> 758</span>
+<span class=normal> 759</span>
+<span class=normal> 760</span>
+<span class=normal> 761</span>
+<span class=normal> 762</span>
+<span class=normal> 763</span>
+<span class=normal> 764</span>
+<span class=normal> 765</span>
+<span class=normal> 766</span>
+<span class=normal> 767</span>
+<span class=normal> 768</span>
+<span class=normal> 769</span>
+<span class=normal> 770</span>
+<span class=normal> 771</span>
+<span class=normal> 772</span>
+<span class=normal> 773</span>
+<span class=normal> 774</span>
+<span class=normal> 775</span>
+<span class=normal> 776</span>
+<span class=normal> 777</span>
+<span class=normal> 778</span>
+<span class=normal> 779</span>
+<span class=normal> 780</span>
+<span class=normal> 781</span>
+<span class=normal> 782</span>
+<span class=normal> 783</span>
+<span class=normal> 784</span>
+<span class=normal> 785</span>
+<span class=normal> 786</span>
+<span class=normal> 787</span>
+<span class=normal> 788</span>
+<span class=normal> 789</span>
+<span class=normal> 790</span>
+<span class=normal> 791</span>
+<span class=normal> 792</span>
+<span class=normal> 793</span>
+<span class=normal> 794</span>
+<span class=normal> 795</span>
+<span class=normal> 796</span>
+<span class=normal> 797</span>
+<span class=normal> 798</span>
+<span class=normal> 799</span>
+<span class=normal> 800</span>
+<span class=normal> 801</span>
+<span class=normal> 802</span>
+<span class=normal> 803</span>
+<span class=normal> 804</span>
+<span class=normal> 805</span>
+<span class=normal> 806</span>
+<span class=normal> 807</span>
+<span class=normal> 808</span>
+<span class=normal> 809</span>
+<span class=normal> 810</span>
+<span class=normal> 811</span>
+<span class=normal> 812</span>
+<span class=normal> 813</span>
+<span class=normal> 814</span>
+<span class=normal> 815</span>
+<span class=normal> 816</span>
+<span class=normal> 817</span>
+<span class=normal> 818</span>
+<span class=normal> 819</span>
+<span class=normal> 820</span>
+<span class=normal> 821</span>
+<span class=normal> 822</span>
+<span class=normal> 823</span>
+<span class=normal> 824</span>
+<span class=normal> 825</span>
+<span class=normal> 826</span>
+<span class=normal> 827</span>
+<span class=normal> 828</span>
+<span class=normal> 829</span>
+<span class=normal> 830</span>
+<span class=normal> 831</span>
+<span class=normal> 832</span>
+<span class=normal> 833</span>
+<span class=normal> 834</span>
+<span class=normal> 835</span>
+<span class=normal> 836</span>
+<span class=normal> 837</span>
+<span class=normal> 838</span>
+<span class=normal> 839</span>
+<span class=normal> 840</span>
+<span class=normal> 841</span>
+<span class=normal> 842</span>
+<span class=normal> 843</span>
+<span class=normal> 844</span>
+<span class=normal> 845</span>
+<span class=normal> 846</span>
+<span class=normal> 847</span>
+<span class=normal> 848</span>
+<span class=normal> 849</span>
+<span class=normal> 850</span>
+<span class=normal> 851</span>
+<span class=normal> 852</span>
+<span class=normal> 853</span>
+<span class=normal> 854</span>
+<span class=normal> 855</span>
+<span class=normal> 856</span>
+<span class=normal> 857</span>
+<span class=normal> 858</span>
+<span class=normal> 859</span>
+<span class=normal> 860</span>
+<span class=normal> 861</span>
+<span class=normal> 862</span>
+<span class=normal> 863</span>
+<span class=normal> 864</span>
+<span class=normal> 865</span>
+<span class=normal> 866</span>
+<span class=normal> 867</span>
+<span class=normal> 868</span>
+<span class=normal> 869</span>
+<span class=normal> 870</span>
+<span class=normal> 871</span>
+<span class=normal> 872</span>
+<span class=normal> 873</span>
+<span class=normal> 874</span>
+<span class=normal> 875</span>
+<span class=normal> 876</span>
+<span class=normal> 877</span>
+<span class=normal> 878</span>
+<span class=normal> 879</span>
+<span class=normal> 880</span>
+<span class=normal> 881</span>
+<span class=normal> 882</span>
+<span class=normal> 883</span>
+<span class=normal> 884</span>
+<span class=normal> 885</span>
+<span class=normal> 886</span>
+<span class=normal> 887</span>
+<span class=normal> 888</span>
+<span class=normal> 889</span>
+<span class=normal> 890</span>
+<span class=normal> 891</span>
+<span class=normal> 892</span>
+<span class=normal> 893</span>
+<span class=normal> 894</span>
+<span class=normal> 895</span>
+<span class=normal> 896</span>
+<span class=normal> 897</span>
+<span class=normal> 898</span>
+<span class=normal> 899</span>
+<span class=normal> 900</span>
+<span class=normal> 901</span>
+<span class=normal> 902</span>
+<span class=normal> 903</span>
+<span class=normal> 904</span>
+<span class=normal> 905</span>
+<span class=normal> 906</span>
+<span class=normal> 907</span>
+<span class=normal> 908</span>
+<span class=normal> 909</span>
+<span class=normal> 910</span>
+<span class=normal> 911</span>
+<span class=normal> 912</span>
+<span class=normal> 913</span>
+<span class=normal> 914</span>
+<span class=normal> 915</span>
+<span class=normal> 916</span>
+<span class=normal> 917</span>
+<span class=normal> 918</span>
+<span class=normal> 919</span>
+<span class=normal> 920</span>
+<span class=normal> 921</span>
+<span class=normal> 922</span>
+<span class=normal> 923</span>
+<span class=normal> 924</span>
+<span class=normal> 925</span>
+<span class=normal> 926</span>
+<span class=normal> 927</span>
+<span class=normal> 928</span>
+<span class=normal> 929</span>
+<span class=normal> 930</span>
+<span class=normal> 931</span>
+<span class=normal> 932</span>
+<span class=normal> 933</span>
+<span class=normal> 934</span>
+<span class=normal> 935</span>
+<span class=normal> 936</span>
+<span class=normal> 937</span>
+<span class=normal> 938</span>
+<span class=normal> 939</span>
+<span class=normal> 940</span>
+<span class=normal> 941</span>
+<span class=normal> 942</span>
+<span class=normal> 943</span>
+<span class=normal> 944</span>
+<span class=normal> 945</span>
+<span class=normal> 946</span>
+<span class=normal> 947</span>
+<span class=normal> 948</span>
+<span class=normal> 949</span>
+<span class=normal> 950</span>
+<span class=normal> 951</span>
+<span class=normal> 952</span>
+<span class=normal> 953</span>
+<span class=normal> 954</span>
+<span class=normal> 955</span>
+<span class=normal> 956</span>
+<span class=normal> 957</span>
+<span class=normal> 958</span>
+<span class=normal> 959</span>
+<span class=normal> 960</span>
+<span class=normal> 961</span>
+<span class=normal> 962</span>
+<span class=normal> 963</span>
+<span class=normal> 964</span>
+<span class=normal> 965</span>
+<span class=normal> 966</span>
+<span class=normal> 967</span>
+<span class=normal> 968</span>
+<span class=normal> 969</span>
+<span class=normal> 970</span>
+<span class=normal> 971</span>
+<span class=normal> 972</span>
+<span class=normal> 973</span>
+<span class=normal> 974</span>
+<span class=normal> 975</span>
+<span class=normal> 976</span>
+<span class=normal> 977</span>
+<span class=normal> 978</span>
+<span class=normal> 979</span>
+<span class=normal> 980</span>
+<span class=normal> 981</span>
+<span class=normal> 982</span>
+<span class=normal> 983</span>
+<span class=normal> 984</span>
+<span class=normal> 985</span>
+<span class=normal> 986</span>
+<span class=normal> 987</span>
+<span class=normal> 988</span>
+<span class=normal> 989</span>
+<span class=normal> 990</span>
+<span class=normal> 991</span>
+<span class=normal> 992</span>
+<span class=normal> 993</span>
+<span class=normal> 994</span>
+<span class=normal> 995</span>
+<span class=normal> 996</span>
+<span class=normal> 997</span>
+<span class=normal> 998</span>
+<span class=normal> 999</span>
+<span class=normal>1000</span>
+<span class=normal>1001</span>
+<span class=normal>1002</span>
+<span class=normal>1003</span>
+<span class=normal>1004</span>
+<span class=normal>1005</span>
+<span class=normal>1006</span>
+<span class=normal>1007</span>
+<span class=normal>1008</span>
+<span class=normal>1009</span>
+<span class=normal>1010</span>
+<span class=normal>1011</span>
+<span class=normal>1012</span>
+<span class=normal>1013</span>
+<span class=normal>1014</span>
+<span class=normal>1015</span>
+<span class=normal>1016</span>
+<span class=normal>1017</span>
+<span class=normal>1018</span>
+<span class=normal>1019</span>
+<span class=normal>1020</span>
+<span class=normal>1021</span>
+<span class=normal>1022</span>
+<span class=normal>1023</span>
+<span class=normal>1024</span>
+<span class=normal>1025</span>
+<span class=normal>1026</span>
+<span class=normal>1027</span>
+<span class=normal>1028</span>
+<span class=normal>1029</span>
+<span class=normal>1030</span>
+<span class=normal>1031</span>
+<span class=normal>1032</span>
+<span class=normal>1033</span>
+<span class=normal>1034</span>
+<span class=normal>1035</span>
+<span class=normal>1036</span>
+<span class=normal>1037</span>
+<span class=normal>1038</span>
+<span class=normal>1039</span>
+<span class=normal>1040</span>
+<span class=normal>1041</span>
+<span class=normal>1042</span>
+<span class=normal>1043</span>
+<span class=normal>1044</span>
+<span class=normal>1045</span>
+<span class=normal>1046</span>
+<span class=normal>1047</span>
+<span class=normal>1048</span>
+<span class=normal>1049</span>
+<span class=normal>1050</span>
+<span class=normal>1051</span>
+<span class=normal>1052</span>
+<span class=normal>1053</span>
+<span class=normal>1054</span>
+<span class=normal>1055</span>
+<span class=normal>1056</span>
+<span class=normal>1057</span>
+<span class=normal>1058</span>
+<span class=normal>1059</span>
+<span class=normal>1060</span>
+<span class=normal>1061</span>
+<span class=normal>1062</span>
+<span class=normal>1063</span>
+<span class=normal>1064</span>
+<span class=normal>1065</span>
+<span class=normal>1066</span>
+<span class=normal>1067</span>
+<span class=normal>1068</span>
+<span class=normal>1069</span>
+<span class=normal>1070</span>
+<span class=normal>1071</span>
+<span class=normal>1072</span>
+<span class=normal>1073</span>
+<span class=normal>1074</span>
+<span class=normal>1075</span>
+<span class=normal>1076</span>
+<span class=normal>1077</span>
+<span class=normal>1078</span>
+<span class=normal>1079</span>
+<span class=normal>1080</span>
+<span class=normal>1081</span>
+<span class=normal>1082</span>
+<span class=normal>1083</span>
+<span class=normal>1084</span>
+<span class=normal>1085</span>
+<span class=normal>1086</span>
+<span class=normal>1087</span>
+<span class=normal>1088</span>
+<span class=normal>1089</span>
+<span class=normal>1090</span>
+<span class=normal>1091</span>
+<span class=normal>1092</span>
+<span class=normal>1093</span>
+<span class=normal>1094</span>
+<span class=normal>1095</span>
+<span class=normal>1096</span>
+<span class=normal>1097</span>
+<span class=normal>1098</span>
+<span class=normal>1099</span>
+<span class=normal>1100</span>
+<span class=normal>1101</span>
+<span class=normal>1102</span>
+<span class=normal>1103</span>
+<span class=normal>1104</span>
+<span class=normal>1105</span>
+<span class=normal>1106</span>
+<span class=normal>1107</span>
+<span class=normal>1108</span>
+<span class=normal>1109</span>
+<span class=normal>1110</span>
+<span class=normal>1111</span>
+<span class=normal>1112</span>
+<span class=normal>1113</span>
+<span class=normal>1114</span>
+<span class=normal>1115</span>
+<span class=normal>1116</span>
+<span class=normal>1117</span>
+<span class=normal>1118</span>
+<span class=normal>1119</span>
+<span class=normal>1120</span>
+<span class=normal>1121</span>
+<span class=normal>1122</span>
+<span class=normal>1123</span>
+<span class=normal>1124</span>
+<span class=normal>1125</span>
+<span class=normal>1126</span>
+<span class=normal>1127</span>
+<span class=normal>1128</span>
+<span class=normal>1129</span>
+<span class=normal>1130</span>
+<span class=normal>1131</span>
+<span class=normal>1132</span>
+<span class=normal>1133</span>
+<span class=normal>1134</span>
+<span class=normal>1135</span>
+<span class=normal>1136</span>
+<span class=normal>1137</span>
+<span class=normal>1138</span>
+<span class=normal>1139</span>
+<span class=normal>1140</span>
+<span class=normal>1141</span>
+<span class=normal>1142</span>
+<span class=normal>1143</span>
+<span class=normal>1144</span>
+<span class=normal>1145</span>
+<span class=normal>1146</span>
+<span class=normal>1147</span>
+<span class=normal>1148</span>
+<span class=normal>1149</span>
+<span class=normal>1150</span>
+<span class=normal>1151</span>
+<span class=normal>1152</span>
+<span class=normal>1153</span>
+<span class=normal>1154</span>
+<span class=normal>1155</span>
+<span class=normal>1156</span>
+<span class=normal>1157</span>
+<span class=normal>1158</span>
+<span class=normal>1159</span>
+<span class=normal>1160</span>
+<span class=normal>1161</span>
+<span class=normal>1162</span>
+<span class=normal>1163</span>
+<span class=normal>1164</span>
+<span class=normal>1165</span>
+<span class=normal>1166</span>
+<span class=normal>1167</span>
+<span class=normal>1168</span>
+<span class=normal>1169</span>
+<span class=normal>1170</span>
+<span class=normal>1171</span>
+<span class=normal>1172</span>
+<span class=normal>1173</span>
+<span class=normal>1174</span>
+<span class=normal>1175</span>
+<span class=normal>1176</span>
+<span class=normal>1177</span>
+<span class=normal>1178</span>
+<span class=normal>1179</span>
+<span class=normal>1180</span>
+<span class=normal>1181</span>
+<span class=normal>1182</span>
+<span class=normal>1183</span>
+<span class=normal>1184</span>
+<span class=normal>1185</span>
+<span class=normal>1186</span>
+<span class=normal>1187</span>
+<span class=normal>1188</span>
+<span class=normal>1189</span>
+<span class=normal>1190</span>
+<span class=normal>1191</span>
+<span class=normal>1192</span>
+<span class=normal>1193</span>
+<span class=normal>1194</span>
+<span class=normal>1195</span>
+<span class=normal>1196</span>
+<span class=normal>1197</span>
+<span class=normal>1198</span>
+<span class=normal>1199</span>
+<span class=normal>1200</span>
+<span class=normal>1201</span>
+<span class=normal>1202</span>
+<span class=normal>1203</span>
+<span class=normal>1204</span>
+<span class=normal>1205</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlInterface</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to interact with controls in memory.&quot;&quot;&quot;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_wrap_label</span><span class=p>(</span><span class=n>label</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+        <span class=n>l_side</span> <span class=o>=</span> <span class=sa>r</span><span class=s1>&#39;\[&#39;</span>
+        <span class=n>r_side</span> <span class=o>=</span> <span class=sa>r</span><span class=s1>&#39;\]&#39;</span>
+        <span class=n>wrapped</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=n>label</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span> <span class=k>else</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>l_side</span><span class=si>}{</span><span class=n>label</span><span class=si>}{</span><span class=n>r_side</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>return</span> <span class=n>wrapped</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_gap_join</span><span class=p>(</span><span class=n>a_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>b_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=n>a_clean</span> <span class=o>=</span> <span class=n>a_str</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=n>b_clean</span> <span class=o>=</span> <span class=n>b_str</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>b_clean</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>a_clean</span>
+        <span class=n>gap</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n\n</span><span class=s1>&#39;</span> <span class=k>if</span> <span class=n>a_clean</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>return</span> <span class=n>a_clean</span> <span class=o>+</span> <span class=n>gap</span> <span class=o>+</span> <span class=n>b_clean</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_control_section_part</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>section_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the prose for a named section in the control.&quot;&quot;&quot;</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>section_name</span> <span class=ow>and</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>prose</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_gap_join</span><span class=p>(</span><span class=n>prose</span><span class=p>,</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>sub_part</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>prose</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_gap_join</span><span class=p>(</span>
+                    <span class=n>prose</span><span class=p>,</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_control_section_part</span><span class=p>(</span><span class=n>sub_part</span><span class=p>,</span> <span class=n>section_name</span><span class=p>)</span>
+                <span class=p>)</span>
+        <span class=k>return</span> <span class=n>prose</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_control_section_prose</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>section_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the prose for the control section.&quot;&quot;&quot;</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>prose</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_gap_join</span><span class=p>(</span>
+                    <span class=n>prose</span><span class=p>,</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_control_section_part</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>section_name</span><span class=p>)</span>
+                <span class=p>)</span>
+        <span class=k>return</span> <span class=n>prose</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_find_section_info</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find section not in list.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>and</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>skip_section_list</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>part</span><span class=o>.</span><span class=n>title</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>sub_part</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>id_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>title</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_find_section_info</span><span class=p>(</span><span class=n>sub_part</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>id_</span><span class=p>:</span>
+                    <span class=k>return</span> <span class=n>id_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>title</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_find_section</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find next section not in list.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>id_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>title</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_find_section_info</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>id_</span><span class=p>:</span>
+                    <span class=k>return</span> <span class=n>id_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>title</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>strip_to_make_ncname</span><span class=p>(</span><span class=n>label</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Strip chars to conform with NCNAME regex.&quot;&quot;&quot;</span>
+        <span class=n>orig_label</span> <span class=o>=</span> <span class=n>label</span>
+        <span class=c1># make sure first char is allowed</span>
+        <span class=k>while</span> <span class=n>label</span> <span class=ow>and</span> <span class=n>label</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>NCNAME_UTF8_FIRST_CHAR_OPTIONS</span><span class=p>:</span>
+            <span class=n>label</span> <span class=o>=</span> <span class=n>label</span><span class=p>[</span><span class=mi>1</span><span class=p>:]</span>
+        <span class=n>new_label</span> <span class=o>=</span> <span class=n>label</span><span class=p>[:</span><span class=mi>1</span><span class=p>]</span>
+        <span class=c1># now check remaining chars</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>label</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>ii</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=nb>len</span><span class=p>(</span><span class=n>label</span><span class=p>)):</span>
+                <span class=k>if</span> <span class=n>label</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>NCNAME_UTF8_OTHER_CHAR_OPTIONS</span><span class=p>:</span>
+                    <span class=n>new_label</span> <span class=o>+=</span> <span class=n>label</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span>
+        <span class=c1># do final check to confirm it is NCNAME</span>
+        <span class=n>match</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>NCNAME_REGEX</span><span class=p>,</span> <span class=n>new_label</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>match</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to convert label </span><span class=si>{</span><span class=n>orig_label</span><span class=si>}</span><span class=s1> to NCNAME format.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>new_label</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_prop</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>,</span> <span class=n>prop_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>default</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the property with that name or return empty string.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>prop_name</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>():</span>
+                <span class=k>return</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>default</span> <span class=k>if</span> <span class=n>default</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_delete_prop</span><span class=p>(</span><span class=n>part_control</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>,</span> <span class=n>prop_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete property with that name.&quot;&quot;&quot;</span>
+        <span class=c1># assumes at most one instance</span>
+        <span class=n>names</span> <span class=o>=</span> <span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part_control</span><span class=o>.</span><span class=n>props</span><span class=p>)]</span>
+        <span class=k>if</span> <span class=n>prop_name</span> <span class=ow>in</span> <span class=n>names</span><span class=p>:</span>
+            <span class=n>index</span> <span class=o>=</span> <span class=n>names</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>prop_name</span><span class=p>)</span>
+            <span class=k>del</span> <span class=n>part_control</span><span class=o>.</span><span class=n>props</span><span class=p>[</span><span class=n>index</span><span class=p>]</span>
+        <span class=n>part_control</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>part_control</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_replace_prop</span><span class=p>(</span><span class=n>part_control</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>,</span> <span class=n>new_prop</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete property with that name if present and insert new one.&quot;&quot;&quot;</span>
+        <span class=c1># assumes at most one instance</span>
+        <span class=n>names</span> <span class=o>=</span> <span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part_control</span><span class=o>.</span><span class=n>props</span><span class=p>)]</span>
+        <span class=k>if</span> <span class=n>new_prop</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>names</span><span class=p>:</span>
+            <span class=n>index</span> <span class=o>=</span> <span class=n>names</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>new_prop</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+            <span class=k>del</span> <span class=n>part_control</span><span class=o>.</span><span class=n>props</span><span class=p>[</span><span class=n>index</span><span class=p>]</span>
+        <span class=n>part_control</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part_control</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+        <span class=n>part_control</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_prop</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_apply_params_format</span><span class=p>(</span><span class=n>param_str</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+        <span class=k>if</span> <span class=n>param_str</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>params_format</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>params_format</span><span class=o>.</span><span class=n>count</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Additional text </span><span class=si>{</span><span class=n>params_format</span><span class=si>}</span><span class=s1> &#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;for the parameter format cannot contain multiple dots (.)&#39;</span>
+                <span class=p>)</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>params_format</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>,</span> <span class=n>param_str</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>param_str</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>create_statement_id</span><span class=p>(</span><span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>lower</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create the control statement id from the control id.&quot;&quot;&quot;</span>
+        <span class=n>id_</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>_smt&#39;</span>
+        <span class=k>return</span> <span class=n>id_</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=k>if</span> <span class=n>lower</span> <span class=k>else</span> <span class=n>id_</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_statement_id</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find the statement id in the control.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span>
+        <span class=k>return</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>create_statement_id</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>allow_none</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the sort-id for the control.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>return</span> <span class=kc>None</span> <span class=k>if</span> <span class=n>allow_none</span> <span class=k>else</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_label</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the label from the props of a part or control.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_prop</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=s1>&#39;label&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_part_by_id</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithParts</span><span class=p>,</span> <span class=n>id_</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find the part within this item&#39;s list of parts that matches id.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span> <span class=o>==</span> <span class=n>id_</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>part</span>
+            <span class=n>deep_part</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_part_by_id</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>id_</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>deep_part</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>deep_part</span>
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_part</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>item_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>skip_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Find parts with the specified item type, within the given part.</span>
+
+<span class=sd>        For a part in a control find the parts in it that match the item_type</span>
+<span class=sd>        Return list of string formatted labels and associated descriptive prose</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>items</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>item_type</span><span class=p>]:</span>
+            <span class=c1># the options here are to force the label to be the part.id or the part.label</span>
+            <span class=c1># the label may be of the form (a) while the part.id is ac-1_smt.a.1.a</span>
+            <span class=c1># here we choose the latter and extract the final element</span>
+            <span class=n>label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>part</span><span class=p>)</span>
+            <span class=n>label</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>label</span> <span class=k>else</span> <span class=n>label</span>
+            <span class=n>wrapped_label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_wrap_label</span><span class=p>(</span><span class=n>label</span><span class=p>)</span>
+            <span class=n>pad</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=n>wrapped_label</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=k>else</span> <span class=s1>&#39; &#39;</span>
+            <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span>
+            <span class=c1># top level prose has already been written out, if present</span>
+            <span class=c1># use presence of . in id to tell if this is top level prose</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span> <span class=o>!=</span> <span class=n>skip_id</span><span class=p>:</span>
+                <span class=k>if</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>*&#39;</span> <span class=ow>in</span> <span class=n>prose</span><span class=p>:</span>
+                    <span class=c1># it is multiline prose</span>
+                    <span class=n>sub_items</span> <span class=o>=</span> <span class=p>[]</span>
+                    <span class=n>multi_prose</span> <span class=o>=</span> <span class=n>prose</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>*&#39;</span><span class=p>)</span>
+                    <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>wrapped_label</span><span class=si>}{</span><span class=n>pad</span><span class=si>}{</span><span class=n>multi_prose</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=n>multi_prose</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>multi_prose</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+                    <span class=k>for</span> <span class=n>prose</span> <span class=ow>in</span> <span class=n>multi_prose</span><span class=p>:</span>
+                        <span class=n>sub_items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>prose</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sub_items</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>wrapped_label</span><span class=si>}{</span><span class=n>pad</span><span class=si>}{</span><span class=n>prose</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>sub_list</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>prt</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                    <span class=n>sub_list</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_part</span><span class=p>(</span><span class=n>prt</span><span class=p>,</span> <span class=n>item_type</span><span class=p>,</span> <span class=n>skip_id</span><span class=p>))</span>
+                <span class=n>sub_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+                <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sub_list</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>items</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_adds_for_control</span><span class=p>(</span><span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the adds for a given control id from a profile.&quot;&quot;&quot;</span>
+        <span class=n>adds</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>alter</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>alters</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>alter</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+                    <span class=n>adds</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>alter</span><span class=o>.</span><span class=n>adds</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>adds</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_all_add_info</span><span class=p>(</span><span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>PartInfo</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the adds for a control from a profile by control id.&quot;&quot;&quot;</span>
+        <span class=n>part_infos</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>add</span> <span class=ow>in</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_adds_for_control</span><span class=p>(</span><span class=n>profile</span><span class=p>,</span> <span class=n>control_id</span><span class=p>):</span>
+            <span class=c1># add control level props with no name</span>
+            <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                <span class=n>smt_part</span> <span class=o>=</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span> <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+                <span class=n>part_infos</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>PartInfo</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>prose</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>smt_part</span><span class=o>=</span><span class=n>smt_part</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>add</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+            <span class=c1># add part level props with part name</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                <span class=n>subpart_info</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_part_and_subpart_info</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>)</span>
+                <span class=n>part_infos</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                    <span class=n>PartInfo</span><span class=p>(</span>
+                        <span class=n>name</span><span class=o>=</span><span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>prose</span><span class=o>=</span><span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>,</span> <span class=n>smt_part</span><span class=o>=</span><span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>part</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>parts</span><span class=o>=</span><span class=n>subpart_info</span>
+                    <span class=p>)</span>
+                <span class=p>)</span>
+        <span class=k>return</span> <span class=n>part_infos</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_part_and_subpart_info</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>add_by_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>PartInfo</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get part and its subparts info needed for markdown purposes.&quot;&quot;&quot;</span>
+        <span class=n>part_infos</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=n>subpart_info</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=k>if</span> <span class=n>subpart</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=c1># Recursively add subparts info</span>
+                <span class=n>subpart_info</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_part_and_subpart_info</span><span class=p>(</span><span class=n>subpart</span><span class=p>,</span> <span class=n>add_by_id</span><span class=p>)</span>
+            <span class=n>part_infos</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                <span class=n>PartInfo</span><span class=p>(</span>
+                    <span class=n>name</span><span class=o>=</span><span class=n>subpart</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>prose</span><span class=o>=</span><span class=n>subpart</span><span class=o>.</span><span class=n>prose</span><span class=p>,</span> <span class=n>smt_part</span><span class=o>=</span><span class=n>add_by_id</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>subpart</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>parts</span><span class=o>=</span><span class=n>subpart_info</span>
+                <span class=p>)</span>
+            <span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>part_infos</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_section</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get sections that are not in the list.&quot;&quot;&quot;</span>
+        <span class=n>id_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>title</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_find_section</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>id_</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>id_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_section_prose</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_part_prose</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>part_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the prose for a named part.&quot;&quot;&quot;</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=n>prose</span> <span class=o>+=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_control_section_part</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>part_name</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>prose</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>setparam_to_param</span><span class=p>(</span><span class=n>param_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>set_param</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Convert setparameter to parameter.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            param_id: the id of the parameter</span>
+<span class=sd>            set_param: the set_parameter from a profile</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            a Parameter with param_id and content from the SetParameter</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>(</span>
+            <span class=nb>id</span><span class=o>=</span><span class=n>param_id</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>,</span> <span class=n>select</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>select</span><span class=p>,</span> <span class=n>label</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>label</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>props</span>
+        <span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>uniquify_set_params</span><span class=p>(</span><span class=n>set_params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TypeWithParamId</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>TypeWithParamId</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Remove items with same param_id with priority to later items.&quot;&quot;&quot;</span>
+        <span class=n>found_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+        <span class=n>unique_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>TypeWithParamId</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=nb>reversed</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>set_params</span><span class=p>)):</span>
+            <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>found_ids</span><span class=p>:</span>
+                <span class=n>unique_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_param</span><span class=p>)</span>
+                <span class=n>found_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=nb>list</span><span class=p>(</span><span class=nb>reversed</span><span class=p>(</span><span class=n>unique_list</span><span class=p>))</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_rules_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all rules found in this items props.&quot;&quot;&quot;</span>
+        <span class=c1># rules is dict containing rule_id and description</span>
+        <span class=n>rules_dict</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>desc</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>id_</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>rules_props</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>RULE_ID</span><span class=p>:</span>
+                <span class=n>name</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+                <span class=n>id_</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span>
+                <span class=n>rules_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>RULE_DESCRIPTION</span><span class=p>:</span>
+                <span class=n>desc</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+                <span class=n>rules_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=c1># grab each pair in case there are multiple pairs</span>
+            <span class=c1># then clear and look for new pair</span>
+            <span class=k>if</span> <span class=n>name</span> <span class=ow>and</span> <span class=n>desc</span><span class=p>:</span>
+                <span class=n>rules_dict</span><span class=p>[</span><span class=n>id_</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>name</span><span class=p>,</span> <span class=s1>&#39;description&#39;</span><span class=p>:</span> <span class=n>desc</span><span class=p>}</span>
+                <span class=n>name</span> <span class=o>=</span> <span class=n>desc</span> <span class=o>=</span> <span class=n>id_</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>return</span> <span class=n>rules_dict</span><span class=p>,</span> <span class=n>rules_props</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>item_has_rules</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Determine if the item has rules in its props.&quot;&quot;&quot;</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>rules_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+        <span class=k>return</span> <span class=nb>bool</span><span class=p>(</span><span class=n>rules_props</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_rule_list_for_item</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the list of rules applying to this item from its top level props.&quot;&quot;&quot;</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>rule_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>RULE_ID</span><span class=p>:</span>
+                <span class=n>rule_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rule_list</span><span class=p>,</span> <span class=n>props</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_rule_list_for_imp_req</span><span class=p>(</span>
+        <span class=n>imp_req</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the list of rules applying to an imp_req as two lists.&quot;&quot;&quot;</span>
+        <span class=n>comp_rules</span><span class=p>,</span> <span class=n>rule_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+        <span class=n>statement_rules</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+            <span class=n>stat_rules</span><span class=p>,</span> <span class=n>statement_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+            <span class=n>statement_rules</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>stat_rules</span><span class=p>)</span>
+            <span class=n>rule_props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>statement_props</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>comp_rules</span><span class=p>,</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>statement_rules</span><span class=p>),</span> <span class=n>rule_props</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_params_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all params found in this item with rule_id as key.&quot;&quot;&quot;</span>
+        <span class=c1># id, description, options - where options is a string containing comma-sep list of items</span>
+        <span class=c1># params is dict with rule_id as key and value contains: param_name, description and choices</span>
+        <span class=n>params</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_ID</span> <span class=ow>in</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+                <span class=n>rule_id</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span>
+                <span class=n>param_name</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+                <span class=c1># rule already exists in parameters dict</span>
+                <span class=k>if</span> <span class=n>rule_id</span> <span class=ow>in</span> <span class=n>params</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=n>existing_param</span> <span class=o>=</span> <span class=nb>next</span><span class=p>((</span><span class=n>prm</span> <span class=k>for</span> <span class=n>prm</span> <span class=ow>in</span> <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=k>if</span> <span class=n>prm</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=n>param_name</span><span class=p>),</span> <span class=kc>None</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>existing_param</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Param id for rule </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=c1># append a new parameter for the current rule</span>
+                        <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>({</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>param_name</span><span class=p>})</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=c1># create new param for this rule for the first parameter</span>
+                    <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=o>=</span> <span class=p>[{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>param_name</span><span class=p>}]</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_DESCRIPTION</span> <span class=ow>in</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+                <span class=n>rule_id</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span>
+                <span class=k>if</span> <span class=n>rule_id</span> <span class=ow>in</span> <span class=n>params</span><span class=p>:</span>
+                    <span class=n>param</span> <span class=o>=</span> <span class=nb>next</span><span class=p>((</span><span class=n>prm</span> <span class=k>for</span> <span class=n>prm</span> <span class=ow>in</span> <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=k>if</span> <span class=n>prm</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=n>param_name</span><span class=p>),</span> <span class=kc>None</span><span class=p>)</span>
+                    <span class=n>param</span><span class=p>[</span><span class=s1>&#39;description&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+                    <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Param description for rule </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> found with no param_id&#39;</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_VALUE_ALTERNATIVES</span> <span class=ow>in</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+                <span class=n>rule_id</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span>
+                <span class=k>if</span> <span class=n>rule_id</span> <span class=ow>in</span> <span class=n>params</span><span class=p>:</span>
+                    <span class=n>param</span> <span class=o>=</span> <span class=nb>next</span><span class=p>((</span><span class=n>prm</span> <span class=k>for</span> <span class=n>prm</span> <span class=ow>in</span> <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=k>if</span> <span class=n>prm</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=n>param_name</span><span class=p>),</span> <span class=kc>None</span><span class=p>)</span>
+                    <span class=n>param</span><span class=p>[</span><span class=s1>&#39;options&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+                    <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Param options for rule </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> found with no param_id&#39;</span><span class=p>)</span>
+        <span class=n>new_params</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>rule_params</span> <span class=ow>in</span> <span class=n>params</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>new_params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>rule_params</span><span class=p>:</span>
+                <span class=k>if</span> <span class=s1>&#39;name&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>param</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Parameter for rule_id </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> has no matching name.  Ignoring the param.&#39;</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>param</span><span class=p>[</span><span class=s1>&#39;description&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>param</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;description&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+                    <span class=n>param</span><span class=p>[</span><span class=s1>&#39;options&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>param</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;options&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+                    <span class=n>new_params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>new_params</span><span class=p>,</span> <span class=n>props</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_rules_and_params_dict_from_item</span><span class=p>(</span>
+        <span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the rule dict and params dict from item with props.&quot;&quot;&quot;</span>
+        <span class=n>rules_dict</span><span class=p>,</span> <span class=n>rules_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+        <span class=n>params_dict</span><span class=p>,</span> <span class=n>params_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_params_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+        <span class=n>rules_props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>params_props</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rules_dict</span><span class=p>,</span> <span class=n>params_dict</span><span class=p>,</span> <span class=n>rules_props</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_set_params_from_item</span><span class=p>(</span>
+        <span class=n>item</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get set params that have values from control implementation or imp req.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=p>{</span>
+            <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>:</span> <span class=n>set_param</span>
+            <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>i</span><span class=p>:</span> <span class=n>i</span><span class=o>.</span><span class=n>values</span><span class=p>)</span>
+        <span class=p>}</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>merge_props</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]],</span>
+                    <span class=n>src</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge a source list of properties into a destination list.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>src</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>dest</span>
+        <span class=n>new_props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>src_map</span> <span class=o>=</span> <span class=p>{</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span> <span class=n>prop</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>src</span><span class=p>}</span>
+        <span class=n>dest_map</span> <span class=o>=</span> <span class=p>{</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span> <span class=n>prop</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>dest</span><span class=p>}</span>
+        <span class=n>all_names</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>src_map</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>dest_map</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+        <span class=k>for</span> <span class=n>name</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>all_names</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>name</span> <span class=ow>in</span> <span class=n>src_map</span> <span class=ow>and</span> <span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>dest_map</span><span class=p>:</span>
+                <span class=n>new_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>src_map</span><span class=p>[</span><span class=n>name</span><span class=p>])</span>
+            <span class=k>elif</span> <span class=n>name</span> <span class=ow>in</span> <span class=n>dest_map</span> <span class=ow>and</span> <span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>src_map</span><span class=p>:</span>
+                <span class=n>new_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>dest_map</span><span class=p>[</span><span class=n>name</span><span class=p>])</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>new_prop</span> <span class=o>=</span> <span class=n>dest_map</span><span class=p>[</span><span class=n>name</span><span class=p>]</span>
+                <span class=n>src_prop</span> <span class=o>=</span> <span class=n>src_map</span><span class=p>[</span><span class=n>name</span><span class=p>]</span>
+                <span class=n>new_prop</span><span class=o>.</span><span class=n>class_</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>class_</span> <span class=k>if</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>class_</span> <span class=k>else</span> <span class=n>new_prop</span><span class=o>.</span><span class=n>class_</span>
+                <span class=n>new_prop</span><span class=o>.</span><span class=n>ns</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>ns</span> <span class=k>if</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>ns</span> <span class=k>else</span> <span class=n>new_prop</span><span class=o>.</span><span class=n>ns</span>
+                <span class=n>new_prop</span><span class=o>.</span><span class=n>remarks</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>remarks</span> <span class=k>if</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>remarks</span> <span class=k>else</span> <span class=n>new_prop</span><span class=o>.</span><span class=n>remarks</span>
+                <span class=n>new_prop</span><span class=o>.</span><span class=n>uuid</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>uuid</span> <span class=k>if</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>uuid</span> <span class=k>else</span> <span class=n>new_prop</span><span class=o>.</span><span class=n>uuid</span>
+                <span class=n>new_prop</span><span class=o>.</span><span class=n>value</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>value</span>
+                <span class=n>new_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_prop</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>new_props</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>merge_part</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>src</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge a source part into the destination part.&quot;&quot;&quot;</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>name</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>name</span> <span class=k>if</span> <span class=n>src</span><span class=o>.</span><span class=n>name</span> <span class=k>else</span> <span class=n>dest</span><span class=o>.</span><span class=n>name</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>ns</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>ns</span> <span class=k>if</span> <span class=n>src</span><span class=o>.</span><span class=n>ns</span> <span class=k>else</span> <span class=n>dest</span><span class=o>.</span><span class=n>ns</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_props</span><span class=p>(</span><span class=n>dest</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>src</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>prose</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>prose</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>title</span> <span class=k>if</span> <span class=n>src</span><span class=o>.</span><span class=n>title</span> <span class=k>else</span> <span class=n>dest</span><span class=o>.</span><span class=n>title</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_parts</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>dest</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>merge_parts</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>TypeWithParts</span><span class=p>,</span> <span class=n>src</span><span class=p>:</span> <span class=n>TypeWithParts</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge the parts from the source into the destination.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>dest</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>dest</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>parts</span>
+        <span class=k>elif</span> <span class=ow>not</span> <span class=n>src</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>dest</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>new_parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>dest_map</span> <span class=o>=</span> <span class=p>{</span><span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>:</span> <span class=n>part</span> <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>dest</span><span class=o>.</span><span class=n>parts</span><span class=p>}</span>
+            <span class=k>for</span> <span class=n>src_part</span> <span class=ow>in</span> <span class=n>src</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>dest_part</span> <span class=o>=</span> <span class=n>dest_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>src_part</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>dest_part</span><span class=p>:</span>
+                    <span class=n>new_parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>src_part</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>new_part</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_part</span><span class=p>(</span><span class=n>dest_part</span><span class=p>,</span> <span class=n>src_part</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>new_part</span><span class=p>:</span>
+                        <span class=n>new_parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_part</span><span class=p>)</span>
+            <span class=n>dest</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>new_parts</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>merge_dicts_deep</span><span class=p>(</span>
+        <span class=n>dest</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>src</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>depth</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>0</span><span class=p>,</span>
+        <span class=n>level</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Merge dict src into dest.</span>
+
+<span class=sd>        New items are always added from src to dest.</span>
+<span class=sd>        Items present in both will be overriden dest if overwrite_header_values is True.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>src</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>src</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>dest</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>depth</span> <span class=ow>and</span> <span class=n>level</span> <span class=o>==</span> <span class=n>depth</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>overwrite_header_values</span><span class=p>:</span>
+                        <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+                    <span class=k>continue</span>
+                <span class=c1># if they are both dicts, recurse</span>
+                <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>dict</span><span class=p>)</span> <span class=ow>and</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>dict</span><span class=p>):</span>
+                    <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_dicts_deep</span><span class=p>(</span><span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>overwrite_header_values</span><span class=p>,</span> <span class=n>depth</span><span class=p>,</span> <span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)</span>
+                <span class=c1># if they are both lists, add any item that is not already in the list</span>
+                <span class=k>elif</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>list</span><span class=p>)</span> <span class=ow>and</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>list</span><span class=p>):</span>
+                    <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>]:</span>
+                        <span class=k>if</span> <span class=n>item</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]:</span>
+                            <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+                <span class=c1># otherwise override dest if needed</span>
+                <span class=k>elif</span> <span class=n>overwrite_header_values</span><span class=p>:</span>
+                    <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># if the item was not already in dest, add it from src</span>
+                <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>is_withdrawn</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Determine if control is marked Withdrawn.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            control: The control that may be marked withdrawn.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            True if marked withdrawn, false otherwise.</span>
+
+<span class=sd>        This is determined by property with name &#39;status&#39; with value &#39;Withdrawn&#39;.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>_</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=p>,</span>
+                <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>strip_lower_equals</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;status&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=n>strip_lower_equals</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=s1>&#39;withdrawn&#39;</span><span class=p>)):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_setparam_values_as_str</span><span class=p>(</span><span class=n>set_param</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert values to string.&quot;&quot;&quot;</span>
+        <span class=n>out_str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>for</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>):</span>
+            <span class=n>value_str</span> <span class=o>=</span> <span class=n>string_from_root</span><span class=p>(</span><span class=n>value</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>value_str</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>out_str</span><span class=p>:</span>
+                    <span class=n>out_str</span> <span class=o>+=</span> <span class=s1>&#39;, &#39;</span>
+                <span class=n>out_str</span> <span class=o>+=</span> <span class=n>value_str</span>
+        <span class=k>return</span> <span class=n>out_str</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_param_values_as_str_list</span><span class=p>(</span><span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert param values to list of strings.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>values</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_param_values_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span> <span class=n>brackets</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert param values to string with optional brackets.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param</span><span class=o>.</span><span class=n>values</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+        <span class=n>values_str</span> <span class=o>=</span> <span class=s1>&#39;, &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str_list</span><span class=p>(</span><span class=n>param</span><span class=p>))</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>values_str</span><span class=si>}</span><span class=s1>]&#39;</span> <span class=k>if</span> <span class=n>brackets</span> <span class=k>else</span> <span class=n>values_str</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_param_selection_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span> <span class=n>verbose</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span> <span class=n>brackets</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert parameter selection to str.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>select</span> <span class=ow>and</span> <span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=o>.</span><span class=n>choice</span><span class=p>:</span>
+            <span class=n>how_many_str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=c1># if all values are specified there is no how_many string and parens are dropped.  See ac-2.2</span>
+            <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=o>.</span><span class=n>how_many</span><span class=p>:</span>
+                <span class=n>how_many_str</span> <span class=o>=</span> <span class=s1>&#39; (one)&#39;</span> <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=o>.</span><span class=n>how_many</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ONE</span> <span class=k>else</span> <span class=s1>&#39; (one or more)&#39;</span>
+            <span class=n>choices_str</span> <span class=o>=</span> <span class=s1>&#39;; &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=o>.</span><span class=n>choice</span><span class=p>))</span>
+            <span class=n>choices_str</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>choices_str</span><span class=si>}</span><span class=s1>]&#39;</span> <span class=k>if</span> <span class=n>brackets</span> <span class=k>else</span> <span class=n>choices_str</span>
+            <span class=n>choices_str</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Selection</span><span class=si>{</span><span class=n>how_many_str</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>choices_str</span><span class=si>}</span><span class=s1>&#39;</span> <span class=k>if</span> <span class=n>verbose</span> <span class=k>else</span> <span class=n>choices_str</span>
+            <span class=k>return</span> <span class=n>choices_str</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_param_as_aggregated_value</span><span class=p>(</span>
+        <span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span>
+        <span class=n>verbose</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>brackets</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert parameter aggregation to str.&quot;&quot;&quot;</span>
+        <span class=c1># review is an aggregated parameter</span>
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span> <span class=ow>in</span> <span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>)]:</span>
+            <span class=n>aggregated_values</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>aggregated_values</span> <span class=o>+=</span> <span class=s1>&#39;, &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>param_dict</span><span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>]</span><span class=o>.</span><span class=n>values</span><span class=p>))</span> <span class=o>+</span> <span class=s1>&#39;, &#39;</span>
+            <span class=k>return</span> <span class=n>aggregated_values</span><span class=p>[:</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_param_label_choices_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span> <span class=n>verbose</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span> <span class=n>brackets</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert param label or choices to string, using choices if present.&quot;&quot;&quot;</span>
+        <span class=n>choices</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_selection_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>verbose</span><span class=p>,</span> <span class=n>brackets</span><span class=p>)</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=n>choices</span> <span class=k>if</span> <span class=n>choices</span> <span class=k>else</span> <span class=n>param</span><span class=o>.</span><span class=n>label</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=n>text</span> <span class=k>if</span> <span class=n>text</span> <span class=k>else</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span>
+        <span class=k>return</span> <span class=n>text</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_param_values_assignment_str</span><span class=p>(</span>
+        <span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert param values, label or choices to string.&quot;&quot;&quot;</span>
+        <span class=c1># use values if present</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>param_str</span> <span class=ow>and</span> <span class=n>value_assigned_prefix</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>value_assigned_prefix</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>param_str</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=c1># otherwise use param selection if present</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_selection_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=c1># otherwise use param aggregated values if present</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+            <span class=k>if</span> <span class=nb>any</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>param_dict</span><span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>]</span><span class=o>.</span><span class=n>values</span><span class=p>)</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>)</span> <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>):</span>
+                <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_as_aggregated_value</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=c1># finally use label and param_id as fallbacks</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>param</span><span class=o>.</span><span class=n>label</span> <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>label</span> <span class=k>else</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span>
+            <span class=k>if</span> <span class=n>value_not_assigned_prefix</span><span class=p>:</span>
+                <span class=n>param_str</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>value_not_assigned_prefix</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>param_str</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>param_str</span><span class=si>}</span><span class=s1>&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_param_labels_assignment_str</span><span class=p>(</span>
+        <span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span>
+        <span class=n>label_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert param label or choices to string.&quot;&quot;&quot;</span>
+        <span class=c1># use values if present</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_selection_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=kc>True</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=c1># finally use label and param_id as fallbacks</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>param</span><span class=o>.</span><span class=n>label</span> <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>label</span> <span class=k>else</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span>
+            <span class=k>if</span> <span class=n>label_prefix</span><span class=p>:</span>
+                <span class=n>param_str</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>label_prefix</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>param_str</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>param_str</span><span class=si>}</span><span class=s1>&#39;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>param_to_str</span><span class=p>(</span>
+        <span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span><span class=p>,</span>
+        <span class=n>verbose</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>brackets</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Convert parameter to string based on best available representation.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            param: the parameter to convert</span>
+<span class=sd>            param_rep: how to represent the parameter</span>
+<span class=sd>            verbose: provide verbose text for selection choices</span>
+<span class=sd>            brackets: add brackets around the lists of items</span>
+<span class=sd>            params_format: a string containing a single dot that represents a form of highlighting around the param</span>
+<span class=sd>            value_assigned_prefix: string to place before the parameter string if a value was assigned</span>
+<span class=sd>            value_not_assigned_prefix: string to place before the parameter string if value not assigned</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            formatted string or None</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>if</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_STRING_NONE</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>param_str</span> <span class=k>if</span> <span class=n>param_str</span> <span class=k>else</span> <span class=s1>&#39;None&#39;</span>
+        <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LABEL_OR_CHOICES</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_label_choices_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>verbose</span><span class=p>,</span> <span class=n>brackets</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_LABEL_OR_CHOICES</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+                <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_label_choices_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>verbose</span><span class=p>,</span> <span class=n>brackets</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_EMPTY_STRING</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>brackets</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+                <span class=n>param_str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>ASSIGNMENT_FORM</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_assignment_str</span><span class=p>(</span>
+                <span class=n>param</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+                <span class=n>param_str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LABEL_FORM</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_labels_assignment_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+                <span class=n>param_str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>return</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_apply_params_format</span><span class=p>(</span><span class=n>param_str</span><span class=p>,</span> <span class=n>params_format</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>values_only</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Create mapping of param id&#39;s to params for params in the control.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            control: the control containing params of interest</span>
+<span class=sd>            values_only: only add params to the dict that have actual values</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Dictionary of param_id mapped to param</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            Warning is given if there is a parameter with no ID</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>):</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> has parameter with no id.  Ignoring.&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>values</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>values_only</span><span class=p>:</span>
+                <span class=n>param_dict</span><span class=p>[</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>param</span>
+        <span class=k>return</span> <span class=n>param_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_replace_ids_with_text</span><span class=p>(</span>
+        <span class=n>prose</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span><span class=p>,</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span>
+        <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find all instances of param_ids in prose and replace each with corresponding parameter representation.</span>
+
+<span class=sd>        Need to check all values in dict for a match</span>
+<span class=sd>        Reject matches where the string has an adjacent alphanumeric char: param_1 and param_10 or aparam_1</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>prose</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=c1># create the replacement text for the param_id</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>param_to_str</span><span class=p>(</span>
+                <span class=n>param</span><span class=p>,</span> <span class=n>param_rep</span><span class=p>,</span> <span class=kc>False</span><span class=p>,</span> <span class=kc>False</span><span class=p>,</span> <span class=n>params_format</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+            <span class=c1># non-capturing groups are odd in re.sub so capture all 3 groups and replace the middle one</span>
+            <span class=n>pattern</span> <span class=o>=</span> <span class=sa>r</span><span class=s1>&#39;(^|[^a-zA-Z0-9_])&#39;</span> <span class=o>+</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span> <span class=o>+</span> <span class=sa>r</span><span class=s1>&#39;($|[^a-zA-Z0-9_])&#39;</span>
+            <span class=n>prose</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>sub</span><span class=p>(</span><span class=n>pattern</span><span class=p>,</span> <span class=sa>r</span><span class=s1>&#39;\1&#39;</span> <span class=o>+</span> <span class=n>param_str</span> <span class=o>+</span> <span class=sa>r</span><span class=s1>&#39;\2&#39;</span><span class=p>,</span> <span class=n>prose</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>prose</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_replace_params</span><span class=p>(</span>
+        <span class=n>text</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span>
+        <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_LABEL_OR_CHOICES</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Replace params found in moustaches with values from the param_dict.</span>
+
+<span class=sd>        A single line of prose may contain multiple moustaches.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># first check if there are any moustache patterns in the text</span>
+        <span class=k>if</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>text</span>
+        <span class=n>orig_text</span> <span class=o>=</span> <span class=n>text</span>
+        <span class=n>staches</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=sa>r</span><span class=s1>&#39;{{.*?}}&#39;</span><span class=p>,</span> <span class=n>text</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>staches</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>text</span>
+        <span class=c1># now have list of all staches including braces, e.g. [&#39;{{foo}}&#39;, &#39;{{bar}}&#39;]</span>
+        <span class=c1># clean the staches so they just have the param ids</span>
+        <span class=n>param_ids</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>stache</span> <span class=ow>in</span> <span class=n>staches</span><span class=p>:</span>
+            <span class=c1># remove braces so these are just param_ids but may have extra chars</span>
+            <span class=n>stache_contents</span> <span class=o>=</span> <span class=n>stache</span><span class=p>[</span><span class=mi>2</span><span class=p>:(</span><span class=o>-</span><span class=mi>2</span><span class=p>)]</span>
+            <span class=n>param_id</span> <span class=o>=</span> <span class=n>stache_contents</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;insert: param,&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>param_ids</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>param_id</span><span class=p>)</span>
+
+        <span class=c1># now replace original stache text with param values</span>
+        <span class=k>for</span> <span class=n>i</span><span class=p>,</span> <span class=n>_</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>staches</span><span class=p>):</span>
+            <span class=c1># A moustache may refer to a param_id not listed in the control&#39;s params</span>
+            <span class=k>if</span> <span class=n>param_ids</span><span class=p>[</span><span class=n>i</span><span class=p>]</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>show_value_warnings</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control prose references param </span><span class=si>{</span><span class=n>param_ids</span><span class=p>[</span><span class=n>i</span><span class=p>]</span><span class=si>}</span><span class=s1> not set in the control: </span><span class=si>{</span><span class=n>staches</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>param_ids</span><span class=p>[</span><span class=n>i</span><span class=p>]]</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>param</span> <span class=o>=</span> <span class=n>param_dict</span><span class=p>[</span><span class=n>param_ids</span><span class=p>[</span><span class=n>i</span><span class=p>]]</span>
+                <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>param_to_str</span><span class=p>(</span>
+                    <span class=n>param</span><span class=p>,</span>
+                    <span class=n>param_rep</span><span class=p>,</span>
+                    <span class=kc>False</span><span class=p>,</span>
+                    <span class=kc>False</span><span class=p>,</span>
+                    <span class=n>params_format</span><span class=p>,</span>
+                    <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                    <span class=n>value_not_assigned_prefix</span><span class=p>,</span>
+                    <span class=n>param_dict</span>
+                <span class=p>)</span>
+                <span class=n>text</span> <span class=o>=</span> <span class=n>text</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>staches</span><span class=p>[</span><span class=n>i</span><span class=p>],</span> <span class=n>param_str</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=k>if</span> <span class=n>show_value_warnings</span> <span class=ow>and</span> <span class=n>param_rep</span> <span class=o>!=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LABEL_OR_CHOICES</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>param</span><span class=o>.</span><span class=n>values</span><span class=p>:</span>
+                    <span class=c1># verifies the current parameter is not an aggregated parameter to throw a warning</span>
+                    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>AGGREGATES</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>)]:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Parameter </span><span class=si>{</span><span class=n>param_id</span><span class=si>}</span><span class=s1> has no values and was referenced by prose.&#39;</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>show_value_warnings</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control prose references param </span><span class=si>{</span><span class=n>param_ids</span><span class=p>[</span><span class=n>i</span><span class=p>]</span><span class=si>}</span><span class=s1> with no specified value.&#39;</span><span class=p>)</span>
+        <span class=c1># there may be staches remaining that we can&#39;t replace if not in param_dict</span>
+        <span class=k>if</span> <span class=n>text</span> <span class=o>!=</span> <span class=n>orig_text</span><span class=p>:</span>
+            <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+                <span class=n>new_text</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_params</span><span class=p>(</span>
+                    <span class=n>text</span><span class=p>,</span>
+                    <span class=n>param_dict</span><span class=p>,</span>
+                    <span class=n>params_format</span><span class=p>,</span>
+                    <span class=n>param_rep</span><span class=p>,</span>
+                    <span class=n>show_value_warnings</span><span class=p>,</span>
+                    <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                    <span class=n>value_not_assigned_prefix</span>
+                <span class=p>)</span>
+                <span class=k>if</span> <span class=n>new_text</span> <span class=o>==</span> <span class=n>text</span><span class=p>:</span>
+                    <span class=k>break</span>
+                <span class=n>text</span> <span class=o>=</span> <span class=n>new_text</span>
+        <span class=k>return</span> <span class=n>text</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_replace_part_prose</span><span class=p>(</span>
+        <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+        <span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span>
+        <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_LABEL_OR_CHOICES</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Replace the part prose according to set_param.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>fixed_prose</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_params</span><span class=p>(</span>
+                <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>,</span>
+                <span class=n>param_dict</span><span class=p>,</span>
+                <span class=n>params_format</span><span class=p>,</span>
+                <span class=n>param_rep</span><span class=p>,</span>
+                <span class=n>show_value_warnings</span><span class=p>,</span>
+                <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                <span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+            <span class=c1># change the prose in the control itself</span>
+            <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=o>=</span> <span class=n>fixed_prose</span>
+        <span class=k>for</span> <span class=n>prt</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_part_prose</span><span class=p>(</span>
+                <span class=n>control</span><span class=p>,</span>
+                <span class=n>prt</span><span class=p>,</span>
+                <span class=n>param_dict</span><span class=p>,</span>
+                <span class=n>params_format</span><span class=p>,</span>
+                <span class=n>param_rep</span><span class=p>,</span>
+                <span class=n>show_value_warnings</span><span class=p>,</span>
+                <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                <span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+        <span class=k>for</span> <span class=n>sub_control</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>):</span>
+            <span class=k>for</span> <span class=n>prt</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>sub_control</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_part_prose</span><span class=p>(</span>
+                    <span class=n>sub_control</span><span class=p>,</span>
+                    <span class=n>prt</span><span class=p>,</span>
+                    <span class=n>param_dict</span><span class=p>,</span>
+                    <span class=n>params_format</span><span class=p>,</span>
+                    <span class=n>param_rep</span><span class=p>,</span>
+                    <span class=n>show_value_warnings</span><span class=p>,</span>
+                    <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                    <span class=n>value_not_assigned_prefix</span>
+                <span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_replace_param_choices</span><span class=p>(</span>
+        <span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span>
+        <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set values for all choices param that refer to params with values.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=p>:</span>
+            <span class=n>new_choices</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>choice</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=o>.</span><span class=n>choice</span><span class=p>):</span>
+                <span class=n>new_choice</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_params</span><span class=p>(</span>
+                    <span class=n>choice</span><span class=p>,</span>
+                    <span class=n>param_dict</span><span class=p>,</span>
+                    <span class=n>params_format</span><span class=p>,</span>
+                    <span class=n>param_rep</span><span class=p>,</span>
+                    <span class=n>show_value_warnings</span><span class=p>,</span>
+                    <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                    <span class=n>value_not_assigned_prefix</span>
+                <span class=p>)</span>
+                <span class=n>new_choices</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_choice</span><span class=p>)</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=o>.</span><span class=n>choice</span> <span class=o>=</span> <span class=n>new_choices</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>replace_control_prose</span><span class=p>(</span>
+        <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span>
+        <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_LABEL_OR_CHOICES</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Replace the control prose according to set_param.&quot;&quot;&quot;</span>
+        <span class=c1># first replace all choices that reference parameters</span>
+        <span class=c1># note that in ASSIGNMENT_FORM each choice with a parameter will end up as [Assignment: value]</span>
+        <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>):</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_param_choices</span><span class=p>(</span>
+                <span class=n>param</span><span class=p>,</span>
+                <span class=n>param_dict</span><span class=p>,</span>
+                <span class=n>params_format</span><span class=p>,</span>
+                <span class=n>param_rep</span><span class=p>,</span>
+                <span class=n>show_value_warnings</span><span class=p>,</span>
+                <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                <span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>fixed_prose</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_params</span><span class=p>(</span>
+                    <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>,</span>
+                    <span class=n>param_dict</span><span class=p>,</span>
+                    <span class=n>params_format</span><span class=p>,</span>
+                    <span class=n>param_rep</span><span class=p>,</span>
+                    <span class=n>show_value_warnings</span><span class=p>,</span>
+                    <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                    <span class=n>value_not_assigned_prefix</span>
+                <span class=p>)</span>
+                <span class=c1># change the prose in the control itself</span>
+                <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=o>=</span> <span class=n>fixed_prose</span>
+            <span class=k>for</span> <span class=n>prt</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_part_prose</span><span class=p>(</span>
+                    <span class=n>control</span><span class=p>,</span>
+                    <span class=n>prt</span><span class=p>,</span>
+                    <span class=n>param_dict</span><span class=p>,</span>
+                    <span class=n>params_format</span><span class=p>,</span>
+                    <span class=n>param_rep</span><span class=p>,</span>
+                    <span class=n>show_value_warnings</span><span class=p>,</span>
+                    <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                    <span class=n>value_not_assigned_prefix</span>
+                <span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>bad_header</span><span class=p>(</span><span class=n>header</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return true if header format is bad.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>header</span> <span class=ow>or</span> <span class=n>header</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>!=</span> <span class=s1>&#39;#&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=n>n</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>header</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>n</span> <span class=o>&lt;</span> <span class=mi>2</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>for</span> <span class=n>ii</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=n>n</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>header</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39; &#39;</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>False</span>
+            <span class=k>if</span> <span class=n>header</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=o>!=</span> <span class=s1>&#39;#&#39;</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_component_by_name</span><span class=p>(</span><span class=n>comp_def</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the component with this name from the comp_def.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>sub_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>comp_def</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>sub_comp</span><span class=o>.</span><span class=n>title</span> <span class=o>==</span> <span class=n>comp_name</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>sub_comp</span>
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_status_from_props</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the status of an item from its props.&quot;&quot;&quot;</span>
+        <span class=n>status</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_PLANNED</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_STATUS</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_prop_as_status</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+                <span class=k>break</span>
+        <span class=k>return</span> <span class=n>status</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>clean_props</span><span class=p>(</span>
+        <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]],</span>
+        <span class=n>remove_imp_status</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+        <span class=n>remove_all_rule_info</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Remove duplicate props and implementation status.&quot;&quot;&quot;</span>
+        <span class=n>new_props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>found_props</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+        <span class=n>rule_tag_list</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>RULE_DESCRIPTION</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>RULE_ID</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_DESCRIPTION</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_VALUE_ALTERNATIVES</span>
+        <span class=p>]</span>
+        <span class=c1># reverse the list so the latest items are kept</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=nb>reversed</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>props</span><span class=p>)):</span>
+            <span class=n>prop_tuple</span> <span class=o>=</span> <span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>as_string</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>),</span> <span class=n>as_string</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>ns</span><span class=p>),</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>prop_tuple</span> <span class=ow>in</span> <span class=n>found_props</span> <span class=ow>or</span> <span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_STATUS</span> <span class=ow>and</span> <span class=n>remove_imp_status</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>remove_all_rule_info</span> <span class=ow>and</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>rule_tag_list</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>found_props</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>prop_tuple</span><span class=p>)</span>
+            <span class=n>new_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=n>new_props</span><span class=o>.</span><span class=n>reverse</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>new_props</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>cull_props_by_rules</span><span class=p>(</span><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]],</span> <span class=n>rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Cull properties to the ones needed by rules.&quot;&quot;&quot;</span>
+        <span class=n>needed_rule_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+        <span class=n>culled_props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=ow>in</span> <span class=n>rules</span> <span class=ow>and</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span><span class=p>:</span>
+                <span class=n>needed_rule_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>remarks</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=ow>in</span> <span class=n>rules</span> <span class=ow>or</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span> <span class=ow>in</span> <span class=n>needed_rule_ids</span><span class=p>:</span>
+                <span class=n>culled_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>culled_props</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_status_as_prop</span><span class=p>(</span><span class=n>status</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert status to property.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_STATUS</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>status</span><span class=o>.</span><span class=n>state</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=n>status</span><span class=o>.</span><span class=n>remarks</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_prop_as_status</span><span class=p>(</span><span class=n>prop</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert property to status.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=n>prop</span><span class=o>.</span><span class=n>remarks</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>insert_status_in_props</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>,</span> <span class=n>status</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Insert status content into props of the item.&quot;&quot;&quot;</span>
+        <span class=n>prop</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_status_as_prop</span><span class=p>(</span><span class=n>status</span><span class=p>)</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_prop</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>prop</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_copy_status_in_props</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>,</span> <span class=n>src</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Copy status in props from one object to another.&quot;&quot;&quot;</span>
+        <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>src</span><span class=p>)</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>status</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>insert_imp_req_into_component</span><span class=p>(</span>
+        <span class=n>component</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>,</span>
+        <span class=n>new_imp_req</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span>
+        <span class=n>profile_title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Insert imp req into component by matching source title and control id to existing imp req.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            component: The defined component receiving the imp_req</span>
+<span class=sd>            new_imp_req: The new imp_req being added</span>
+<span class=sd>            profile_title: The title of the source profile for the control implementation containing the imp_req</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            Inserts the imp_req on the first match found.  Note it is possible two control implementations could</span>
+<span class=sd>            have the same source and specify the same control</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>control_imp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>):</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>control_imp_param_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>control_imp</span><span class=p>)</span>
+            <span class=n>control_imp_rule_param_ids</span> <span class=o>=</span> <span class=p>[</span>
+                <span class=n>param</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=k>for</span> <span class=n>params</span> <span class=ow>in</span> <span class=n>control_imp_param_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()</span> <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>params</span>
+            <span class=p>]</span>
+            <span class=k>if</span> <span class=n>profile_title</span> <span class=o>!=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_title_from_model_uri</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>control_imp</span><span class=o>.</span><span class=n>source</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>!=</span> <span class=n>new_imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>_</span><span class=p>,</span> <span class=n>imp_req_param_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+                <span class=n>imp_req_rule_param_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>param</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=k>for</span> <span class=n>params</span> <span class=ow>in</span> <span class=n>imp_req_param_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()</span> <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>params</span><span class=p>]</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>new_imp_req</span><span class=p>)</span>
+                <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>status</span><span class=p>)</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>new_imp_req</span><span class=o>.</span><span class=n>description</span>
+                <span class=n>statement_dict</span> <span class=o>=</span> <span class=p>{</span><span class=n>stat</span><span class=o>.</span><span class=n>statement_id</span><span class=p>:</span> <span class=n>stat</span> <span class=k>for</span> <span class=n>stat</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>)}</span>
+                <span class=c1># update set parameter values with values from markdown - but only for rule param vals</span>
+                <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>new_imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>(</span><span class=n>control_imp_rule_param_ids</span> <span class=o>+</span> <span class=n>imp_req_rule_param_ids</span><span class=p>):</span>
+                        <span class=k>continue</span>
+                    <span class=n>found</span> <span class=o>=</span> <span class=kc>False</span>
+                    <span class=k>for</span> <span class=n>dest_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                        <span class=k>if</span> <span class=n>dest_param</span><span class=o>.</span><span class=n>param_id</span> <span class=o>!=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>:</span>
+                            <span class=k>continue</span>
+                        <span class=n>dest_param</span><span class=o>.</span><span class=n>values</span> <span class=o>=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>values</span>
+                        <span class=n>found</span> <span class=o>=</span> <span class=kc>True</span>
+                        <span class=k>break</span>
+                    <span class=c1># if rule parameter val was not already set by a set_param, make new set_param for it</span>
+                    <span class=k>if</span> <span class=n>found</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=c1># but first check if the parameter was already set with the same value in the control_imp</span>
+                    <span class=c1># if so we don&#39;t need to insert a new set_param in imp_req</span>
+                    <span class=k>for</span> <span class=n>dest_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                        <span class=k>if</span> <span class=n>dest_param</span><span class=o>.</span><span class=n>param_id</span> <span class=o>!=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>:</span>
+                            <span class=k>continue</span>
+                        <span class=k>if</span> <span class=n>dest_param</span><span class=o>.</span><span class=n>values</span> <span class=o>==</span> <span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>:</span>
+                            <span class=n>found</span> <span class=o>=</span> <span class=kc>True</span>
+                            <span class=k>break</span>
+                    <span class=k>if</span> <span class=n>found</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+                    <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                        <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>)</span>
+                    <span class=p>)</span>
+                <span class=n>new_statements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>new_imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                    <span class=c1># get the original version of the statement if available, or use new one</span>
+                    <span class=n>stat</span> <span class=o>=</span> <span class=n>statement_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span><span class=p>,</span> <span class=n>statement</span><span class=p>)</span>
+                    <span class=c1># update the description and status from markdown</span>
+                    <span class=n>stat</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>description</span>
+                    <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_copy_status_in_props</span><span class=p>(</span><span class=n>stat</span><span class=p>,</span> <span class=n>statement</span><span class=p>)</span>
+                    <span class=n>new_statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>stat</span><span class=p>)</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_statements</span><span class=p>)</span>
+                <span class=k>return</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Unable to add imp req for component </span><span class=si>{</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> control </span><span class=si>{</span><span class=n>new_imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1> and source: </span><span class=si>{</span><span class=n>profile_title</span><span class=si>}</span><span class=s1>&#39;</span>  <span class=c1># noqa E501</span>
+        <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.control_interface.ControlInterface-functions>Functions<a href=#trestle.core.control_interface.ControlInterface-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.bad_header class="doc doc-heading"> <code class="highlight language-python"><span class=n>bad_header</span><span class=p>(</span><span class=n>header</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.bad_header class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return true if header format is bad.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1038</span>
+<span class=normal>1039</span>
+<span class=normal>1040</span>
+<span class=normal>1041</span>
+<span class=normal>1042</span>
+<span class=normal>1043</span>
+<span class=normal>1044</span>
+<span class=normal>1045</span>
+<span class=normal>1046</span>
+<span class=normal>1047</span>
+<span class=normal>1048</span>
+<span class=normal>1049</span>
+<span class=normal>1050</span>
+<span class=normal>1051</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>bad_header</span><span class=p>(</span><span class=n>header</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return true if header format is bad.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>header</span> <span class=ow>or</span> <span class=n>header</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>!=</span> <span class=s1>&#39;#&#39;</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=n>n</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>header</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>n</span> <span class=o>&lt;</span> <span class=mi>2</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>for</span> <span class=n>ii</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=n>n</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>header</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39; &#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=n>header</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=o>!=</span> <span class=s1>&#39;#&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.clean_props class="doc doc-heading"> <code class="highlight language-python"><span class=n>clean_props</span><span class=p>(</span><span class=n>props</span><span class=p>,</span> <span class=n>remove_imp_status</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>remove_all_rule_info</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.clean_props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Remove duplicate props and implementation status.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1071</span>
+<span class=normal>1072</span>
+<span class=normal>1073</span>
+<span class=normal>1074</span>
+<span class=normal>1075</span>
+<span class=normal>1076</span>
+<span class=normal>1077</span>
+<span class=normal>1078</span>
+<span class=normal>1079</span>
+<span class=normal>1080</span>
+<span class=normal>1081</span>
+<span class=normal>1082</span>
+<span class=normal>1083</span>
+<span class=normal>1084</span>
+<span class=normal>1085</span>
+<span class=normal>1086</span>
+<span class=normal>1087</span>
+<span class=normal>1088</span>
+<span class=normal>1089</span>
+<span class=normal>1090</span>
+<span class=normal>1091</span>
+<span class=normal>1092</span>
+<span class=normal>1093</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>clean_props</span><span class=p>(</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]],</span>
+    <span class=n>remove_imp_status</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+    <span class=n>remove_all_rule_info</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove duplicate props and implementation status.&quot;&quot;&quot;</span>
+    <span class=n>new_props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>found_props</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+    <span class=n>rule_tag_list</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=n>const</span><span class=o>.</span><span class=n>RULE_DESCRIPTION</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>RULE_ID</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_DESCRIPTION</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_VALUE_ALTERNATIVES</span>
+    <span class=p>]</span>
+    <span class=c1># reverse the list so the latest items are kept</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=nb>reversed</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>props</span><span class=p>)):</span>
+        <span class=n>prop_tuple</span> <span class=o>=</span> <span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>as_string</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>),</span> <span class=n>as_string</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>ns</span><span class=p>),</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>prop_tuple</span> <span class=ow>in</span> <span class=n>found_props</span> <span class=ow>or</span> <span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_STATUS</span> <span class=ow>and</span> <span class=n>remove_imp_status</span><span class=p>):</span>
+            <span class=k>continue</span>
+        <span class=k>if</span> <span class=n>remove_all_rule_info</span> <span class=ow>and</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>rule_tag_list</span><span class=p>:</span>
+            <span class=k>continue</span>
+        <span class=n>found_props</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>prop_tuple</span><span class=p>)</span>
+        <span class=n>new_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+    <span class=n>new_props</span><span class=o>.</span><span class=n>reverse</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>new_props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.create_statement_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>create_statement_id</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>lower</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.create_statement_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create the control statement id from the control id.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>create_statement_id</span><span class=p>(</span><span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>lower</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create the control statement id from the control id.&quot;&quot;&quot;</span>
+    <span class=n>id_</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>_smt&#39;</span>
+    <span class=k>return</span> <span class=n>id_</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=k>if</span> <span class=n>lower</span> <span class=k>else</span> <span class=n>id_</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.cull_props_by_rules class="doc doc-heading"> <code class="highlight language-python"><span class=n>cull_props_by_rules</span><span class=p>(</span><span class=n>props</span><span class=p>,</span> <span class=n>rules</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.cull_props_by_rules class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Cull properties to the ones needed by rules.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1095</span>
+<span class=normal>1096</span>
+<span class=normal>1097</span>
+<span class=normal>1098</span>
+<span class=normal>1099</span>
+<span class=normal>1100</span>
+<span class=normal>1101</span>
+<span class=normal>1102</span>
+<span class=normal>1103</span>
+<span class=normal>1104</span>
+<span class=normal>1105</span>
+<span class=normal>1106</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>cull_props_by_rules</span><span class=p>(</span><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]],</span> <span class=n>rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Cull properties to the ones needed by rules.&quot;&quot;&quot;</span>
+    <span class=n>needed_rule_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+    <span class=n>culled_props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>props</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=ow>in</span> <span class=n>rules</span> <span class=ow>and</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span><span class=p>:</span>
+            <span class=n>needed_rule_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>remarks</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>props</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=ow>in</span> <span class=n>rules</span> <span class=ow>or</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span> <span class=ow>in</span> <span class=n>needed_rule_ids</span><span class=p>:</span>
+            <span class=n>culled_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>culled_props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_all_add_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all_add_info</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>profile</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_all_add_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the adds for a control from a profile by control id.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_all_add_info</span><span class=p>(</span><span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>PartInfo</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the adds for a control from a profile by control id.&quot;&quot;&quot;</span>
+    <span class=n>part_infos</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>add</span> <span class=ow>in</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_adds_for_control</span><span class=p>(</span><span class=n>profile</span><span class=p>,</span> <span class=n>control_id</span><span class=p>):</span>
+        <span class=c1># add control level props with no name</span>
+        <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=n>smt_part</span> <span class=o>=</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span> <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+            <span class=n>part_infos</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>PartInfo</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>prose</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>smt_part</span><span class=o>=</span><span class=n>smt_part</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>add</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+        <span class=c1># add part level props with part name</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=n>subpart_info</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_part_and_subpart_info</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>)</span>
+            <span class=n>part_infos</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                <span class=n>PartInfo</span><span class=p>(</span>
+                    <span class=n>name</span><span class=o>=</span><span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>prose</span><span class=o>=</span><span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>,</span> <span class=n>smt_part</span><span class=o>=</span><span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>part</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>parts</span><span class=o>=</span><span class=n>subpart_info</span>
+                <span class=p>)</span>
+            <span class=p>)</span>
+    <span class=k>return</span> <span class=n>part_infos</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_component_by_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_component_by_name</span><span class=p>(</span><span class=n>comp_def</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_component_by_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the component with this name from the comp_def.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1053</span>
+<span class=normal>1054</span>
+<span class=normal>1055</span>
+<span class=normal>1056</span>
+<span class=normal>1057</span>
+<span class=normal>1058</span>
+<span class=normal>1059</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_component_by_name</span><span class=p>(</span><span class=n>comp_def</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the component with this name from the comp_def.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>sub_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>comp_def</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>sub_comp</span><span class=o>.</span><span class=n>title</span> <span class=o>==</span> <span class=n>comp_name</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>sub_comp</span>
+    <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_control_param_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>values_only</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_control_param_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create mapping of param id's to params for params in the control.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>control</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.catalog.Control href=../../oscal/catalog/#trestle.oscal.catalog.Control>Control</a></code> </td> <td> <div class=doc-md-description> <p>the control containing params of interest</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>values_only</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>only add params to the dict that have actual values</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Dict>Dict</span>[str, <a class="autorefs autorefs-internal" title=trestle.oscal.common.Parameter href=../../oscal/common/#trestle.oscal.common.Parameter>Parameter</a>]</code> </td> <td> <div class=doc-md-description> <p>Dictionary of param_id mapped to param</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>Warning is given if there is a parameter with no ID</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>794</span>
+<span class=normal>795</span>
+<span class=normal>796</span>
+<span class=normal>797</span>
+<span class=normal>798</span>
+<span class=normal>799</span>
+<span class=normal>800</span>
+<span class=normal>801</span>
+<span class=normal>802</span>
+<span class=normal>803</span>
+<span class=normal>804</span>
+<span class=normal>805</span>
+<span class=normal>806</span>
+<span class=normal>807</span>
+<span class=normal>808</span>
+<span class=normal>809</span>
+<span class=normal>810</span>
+<span class=normal>811</span>
+<span class=normal>812</span>
+<span class=normal>813</span>
+<span class=normal>814</span>
+<span class=normal>815</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>values_only</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Create mapping of param id&#39;s to params for params in the control.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        control: the control containing params of interest</span>
+<span class=sd>        values_only: only add params to the dict that have actual values</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Dictionary of param_id mapped to param</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        Warning is given if there is a parameter with no ID</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>):</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> has parameter with no id.  Ignoring.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>values</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>values_only</span><span class=p>:</span>
+            <span class=n>param_dict</span><span class=p>[</span><span class=n>param</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>param</span>
+    <span class=k>return</span> <span class=n>param_dict</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_control_section_prose class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_section_prose</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>section_name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_control_section_prose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the prose for the control section.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_control_section_prose</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>section_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the prose for the control section.&quot;&quot;&quot;</span>
+    <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>prose</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_gap_join</span><span class=p>(</span>
+                <span class=n>prose</span><span class=p>,</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_control_section_part</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>section_name</span><span class=p>)</span>
+            <span class=p>)</span>
+    <span class=k>return</span> <span class=n>prose</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_label class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_label</span><span class=p>(</span><span class=n>item</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_label class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the label from the props of a part or control.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_label</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the label from the props of a part or control.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_prop</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=s1>&#39;label&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_params_dict_from_item class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_params_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_params_dict_from_item class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get all params found in this item with rule_id as key.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_params_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get all params found in this item with rule_id as key.&quot;&quot;&quot;</span>
+    <span class=c1># id, description, options - where options is a string containing comma-sep list of items</span>
+    <span class=c1># params is dict with rule_id as key and value contains: param_name, description and choices</span>
+    <span class=n>params</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_ID</span> <span class=ow>in</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+            <span class=n>rule_id</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span>
+            <span class=n>param_name</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+            <span class=c1># rule already exists in parameters dict</span>
+            <span class=k>if</span> <span class=n>rule_id</span> <span class=ow>in</span> <span class=n>params</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=n>existing_param</span> <span class=o>=</span> <span class=nb>next</span><span class=p>((</span><span class=n>prm</span> <span class=k>for</span> <span class=n>prm</span> <span class=ow>in</span> <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=k>if</span> <span class=n>prm</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=n>param_name</span><span class=p>),</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>existing_param</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Param id for rule </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=c1># append a new parameter for the current rule</span>
+                    <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>({</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>param_name</span><span class=p>})</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># create new param for this rule for the first parameter</span>
+                <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=o>=</span> <span class=p>[{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>param_name</span><span class=p>}]</span>
+            <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_DESCRIPTION</span> <span class=ow>in</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+            <span class=n>rule_id</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span>
+            <span class=k>if</span> <span class=n>rule_id</span> <span class=ow>in</span> <span class=n>params</span><span class=p>:</span>
+                <span class=n>param</span> <span class=o>=</span> <span class=nb>next</span><span class=p>((</span><span class=n>prm</span> <span class=k>for</span> <span class=n>prm</span> <span class=ow>in</span> <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=k>if</span> <span class=n>prm</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=n>param_name</span><span class=p>),</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=n>param</span><span class=p>[</span><span class=s1>&#39;description&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Param description for rule </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> found with no param_id&#39;</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>PARAMETER_VALUE_ALTERNATIVES</span> <span class=ow>in</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+            <span class=n>rule_id</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span>
+            <span class=k>if</span> <span class=n>rule_id</span> <span class=ow>in</span> <span class=n>params</span><span class=p>:</span>
+                <span class=n>param</span> <span class=o>=</span> <span class=nb>next</span><span class=p>((</span><span class=n>prm</span> <span class=k>for</span> <span class=n>prm</span> <span class=ow>in</span> <span class=n>params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=k>if</span> <span class=n>prm</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=n>param_name</span><span class=p>),</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=n>param</span><span class=p>[</span><span class=s1>&#39;options&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Param options for rule </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> found with no param_id&#39;</span><span class=p>)</span>
+    <span class=n>new_params</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>rule_params</span> <span class=ow>in</span> <span class=n>params</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+        <span class=n>new_params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>rule_params</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;name&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>param</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Parameter for rule_id </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> has no matching name.  Ignoring the param.&#39;</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>param</span><span class=p>[</span><span class=s1>&#39;description&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>param</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;description&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+                <span class=n>param</span><span class=p>[</span><span class=s1>&#39;options&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>param</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;options&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+                <span class=n>new_params</span><span class=p>[</span><span class=n>rule_id</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>new_params</span><span class=p>,</span> <span class=n>props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_part class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_part</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>item_type</span><span class=p>,</span> <span class=n>skip_id</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_part class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find parts with the specified item type, within the given part.</p> <p>For a part in a control find the parts in it that match the item_type Return list of string formatted labels and associated descriptive prose</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_part</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>item_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>skip_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Find parts with the specified item type, within the given part.</span>
+
+<span class=sd>    For a part in a control find the parts in it that match the item_type</span>
+<span class=sd>    Return list of string formatted labels and associated descriptive prose</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>items</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>item_type</span><span class=p>]:</span>
+        <span class=c1># the options here are to force the label to be the part.id or the part.label</span>
+        <span class=c1># the label may be of the form (a) while the part.id is ac-1_smt.a.1.a</span>
+        <span class=c1># here we choose the latter and extract the final element</span>
+        <span class=n>label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>part</span><span class=p>)</span>
+        <span class=n>label</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>label</span> <span class=k>else</span> <span class=n>label</span>
+        <span class=n>wrapped_label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_wrap_label</span><span class=p>(</span><span class=n>label</span><span class=p>)</span>
+        <span class=n>pad</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=n>wrapped_label</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=k>else</span> <span class=s1>&#39; &#39;</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span>
+        <span class=c1># top level prose has already been written out, if present</span>
+        <span class=c1># use presence of . in id to tell if this is top level prose</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span> <span class=o>!=</span> <span class=n>skip_id</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>*&#39;</span> <span class=ow>in</span> <span class=n>prose</span><span class=p>:</span>
+                <span class=c1># it is multiline prose</span>
+                <span class=n>sub_items</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=n>multi_prose</span> <span class=o>=</span> <span class=n>prose</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>*&#39;</span><span class=p>)</span>
+                <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>wrapped_label</span><span class=si>}{</span><span class=n>pad</span><span class=si>}{</span><span class=n>multi_prose</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>multi_prose</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>multi_prose</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+                <span class=k>for</span> <span class=n>prose</span> <span class=ow>in</span> <span class=n>multi_prose</span><span class=p>:</span>
+                    <span class=n>sub_items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>prose</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sub_items</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>wrapped_label</span><span class=si>}{</span><span class=n>pad</span><span class=si>}{</span><span class=n>prose</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>sub_list</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>prt</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>sub_list</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_part</span><span class=p>(</span><span class=n>prt</span><span class=p>,</span> <span class=n>item_type</span><span class=p>,</span> <span class=n>skip_id</span><span class=p>))</span>
+            <span class=n>sub_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+            <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sub_list</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>items</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_part_by_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_part_by_id</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>id_</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_part_by_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find the part within this item's list of parts that matches id.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_part_by_id</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithParts</span><span class=p>,</span> <span class=n>id_</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find the part within this item&#39;s list of parts that matches id.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span> <span class=o>==</span> <span class=n>id_</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>part</span>
+        <span class=n>deep_part</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_part_by_id</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>id_</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>deep_part</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>deep_part</span>
+    <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_part_prose class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_part_prose</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part_name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_part_prose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the prose for a named part.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_part_prose</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>part_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the prose for a named part.&quot;&quot;&quot;</span>
+    <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+        <span class=n>prose</span> <span class=o>+=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_get_control_section_part</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>part_name</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>prose</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_prop class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_prop</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>prop_name</span><span class=p>,</span> <span class=n>default</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_prop class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the property with that name or return empty string.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_prop</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>,</span> <span class=n>prop_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>default</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the property with that name or return empty string.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>prop_name</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>lower</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>default</span> <span class=k>if</span> <span class=n>default</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_rule_list_for_imp_req class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_rule_list_for_imp_req</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_rule_list_for_imp_req class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the list of rules applying to an imp_req as two lists.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_rule_list_for_imp_req</span><span class=p>(</span>
+    <span class=n>imp_req</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the list of rules applying to an imp_req as two lists.&quot;&quot;&quot;</span>
+    <span class=n>comp_rules</span><span class=p>,</span> <span class=n>rule_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+    <span class=n>statement_rules</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+    <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+        <span class=n>stat_rules</span><span class=p>,</span> <span class=n>statement_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+        <span class=n>statement_rules</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>stat_rules</span><span class=p>)</span>
+        <span class=n>rule_props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>statement_props</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>comp_rules</span><span class=p>,</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>statement_rules</span><span class=p>),</span> <span class=n>rule_props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_rule_list_for_item class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_rule_list_for_item class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the list of rules applying to this item from its top level props.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_rule_list_for_item</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the list of rules applying to this item from its top level props.&quot;&quot;&quot;</span>
+    <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>rule_list</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>RULE_ID</span><span class=p>:</span>
+            <span class=n>rule_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+            <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>rule_list</span><span class=p>,</span> <span class=n>props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_rules_and_params_dict_from_item class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_rules_and_params_dict_from_item class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the rule dict and params dict from item with props.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_rules_and_params_dict_from_item</span><span class=p>(</span>
+    <span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the rule dict and params dict from item with props.&quot;&quot;&quot;</span>
+    <span class=n>rules_dict</span><span class=p>,</span> <span class=n>rules_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+    <span class=n>params_dict</span><span class=p>,</span> <span class=n>params_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_params_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+    <span class=n>rules_props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>params_props</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>rules_dict</span><span class=p>,</span> <span class=n>params_dict</span><span class=p>,</span> <span class=n>rules_props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_rules_dict_from_item class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_rules_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_rules_dict_from_item class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get all rules found in this items props.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_rules_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get all rules found in this items props.&quot;&quot;&quot;</span>
+    <span class=c1># rules is dict containing rule_id and description</span>
+    <span class=n>rules_dict</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>desc</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>id_</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>rules_props</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>RULE_ID</span><span class=p>:</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+            <span class=n>id_</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span>
+            <span class=n>rules_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>RULE_DESCRIPTION</span><span class=p>:</span>
+            <span class=n>desc</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+            <span class=n>rules_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=c1># grab each pair in case there are multiple pairs</span>
+        <span class=c1># then clear and look for new pair</span>
+        <span class=k>if</span> <span class=n>name</span> <span class=ow>and</span> <span class=n>desc</span><span class=p>:</span>
+            <span class=n>rules_dict</span><span class=p>[</span><span class=n>id_</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>name</span><span class=p>,</span> <span class=s1>&#39;description&#39;</span><span class=p>:</span> <span class=n>desc</span><span class=p>}</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>desc</span> <span class=o>=</span> <span class=n>id_</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>return</span> <span class=n>rules_dict</span><span class=p>,</span> <span class=n>rules_props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_section class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_section</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_section class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get sections that are not in the list.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_section</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get sections that are not in the list.&quot;&quot;&quot;</span>
+    <span class=n>id_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>title</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_find_section</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>id_</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>id_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_section_prose</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span>
+    <span class=k>return</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_set_params_from_item class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_set_params_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_set_params_from_item class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get set params that have values from control implementation or imp req.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_set_params_from_item</span><span class=p>(</span>
+    <span class=n>item</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get set params that have values from control implementation or imp req.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=p>{</span>
+        <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>:</span> <span class=n>set_param</span>
+        <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>i</span><span class=p>:</span> <span class=n>i</span><span class=o>.</span><span class=n>values</span><span class=p>)</span>
+    <span class=p>}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_sort_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>allow_none</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_sort_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the sort-id for the control.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>allow_none</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the sort-id for the control.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+    <span class=k>return</span> <span class=kc>None</span> <span class=k>if</span> <span class=n>allow_none</span> <span class=k>else</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_statement_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_statement_id</span><span class=p>(</span><span class=n>control</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_statement_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find the statement id in the control.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_statement_id</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find the statement id in the control.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span>
+    <span class=k>return</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>create_statement_id</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.get_status_from_props class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>item</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.get_status_from_props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the status of an item from its props.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1061</span>
+<span class=normal>1062</span>
+<span class=normal>1063</span>
+<span class=normal>1064</span>
+<span class=normal>1065</span>
+<span class=normal>1066</span>
+<span class=normal>1067</span>
+<span class=normal>1068</span>
+<span class=normal>1069</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_status_from_props</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the status of an item from its props.&quot;&quot;&quot;</span>
+    <span class=n>status</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_PLANNED</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_STATUS</span><span class=p>:</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_prop_as_status</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=k>break</span>
+    <span class=k>return</span> <span class=n>status</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.insert_imp_req_into_component class="doc doc-heading"> <code class="highlight language-python"><span class=n>insert_imp_req_into_component</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>new_imp_req</span><span class=p>,</span> <span class=n>profile_title</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.insert_imp_req_into_component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Insert imp req into component by matching source title and control id to existing imp req.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>component</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.component.DefinedComponent href=../../oscal/component/#trestle.oscal.component.DefinedComponent>DefinedComponent</a></code> </td> <td> <div class=doc-md-description> <p>The defined component receiving the imp_req</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>new_imp_req</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.component.ImplementedRequirement href=../../oscal/component/#trestle.oscal.component.ImplementedRequirement>ImplementedRequirement</a></code> </td> <td> <div class=doc-md-description> <p>The new imp_req being added</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>profile_title</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The title of the source profile for the control implementation containing the imp_req</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>Inserts the imp_req on the first match found. Note it is possible two control implementations could have the same source and specify the same control</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1130</span>
+<span class=normal>1131</span>
+<span class=normal>1132</span>
+<span class=normal>1133</span>
+<span class=normal>1134</span>
+<span class=normal>1135</span>
+<span class=normal>1136</span>
+<span class=normal>1137</span>
+<span class=normal>1138</span>
+<span class=normal>1139</span>
+<span class=normal>1140</span>
+<span class=normal>1141</span>
+<span class=normal>1142</span>
+<span class=normal>1143</span>
+<span class=normal>1144</span>
+<span class=normal>1145</span>
+<span class=normal>1146</span>
+<span class=normal>1147</span>
+<span class=normal>1148</span>
+<span class=normal>1149</span>
+<span class=normal>1150</span>
+<span class=normal>1151</span>
+<span class=normal>1152</span>
+<span class=normal>1153</span>
+<span class=normal>1154</span>
+<span class=normal>1155</span>
+<span class=normal>1156</span>
+<span class=normal>1157</span>
+<span class=normal>1158</span>
+<span class=normal>1159</span>
+<span class=normal>1160</span>
+<span class=normal>1161</span>
+<span class=normal>1162</span>
+<span class=normal>1163</span>
+<span class=normal>1164</span>
+<span class=normal>1165</span>
+<span class=normal>1166</span>
+<span class=normal>1167</span>
+<span class=normal>1168</span>
+<span class=normal>1169</span>
+<span class=normal>1170</span>
+<span class=normal>1171</span>
+<span class=normal>1172</span>
+<span class=normal>1173</span>
+<span class=normal>1174</span>
+<span class=normal>1175</span>
+<span class=normal>1176</span>
+<span class=normal>1177</span>
+<span class=normal>1178</span>
+<span class=normal>1179</span>
+<span class=normal>1180</span>
+<span class=normal>1181</span>
+<span class=normal>1182</span>
+<span class=normal>1183</span>
+<span class=normal>1184</span>
+<span class=normal>1185</span>
+<span class=normal>1186</span>
+<span class=normal>1187</span>
+<span class=normal>1188</span>
+<span class=normal>1189</span>
+<span class=normal>1190</span>
+<span class=normal>1191</span>
+<span class=normal>1192</span>
+<span class=normal>1193</span>
+<span class=normal>1194</span>
+<span class=normal>1195</span>
+<span class=normal>1196</span>
+<span class=normal>1197</span>
+<span class=normal>1198</span>
+<span class=normal>1199</span>
+<span class=normal>1200</span>
+<span class=normal>1201</span>
+<span class=normal>1202</span>
+<span class=normal>1203</span>
+<span class=normal>1204</span>
+<span class=normal>1205</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>insert_imp_req_into_component</span><span class=p>(</span>
+    <span class=n>component</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>,</span>
+    <span class=n>new_imp_req</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>,</span>
+    <span class=n>profile_title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Insert imp req into component by matching source title and control id to existing imp req.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        component: The defined component receiving the imp_req</span>
+<span class=sd>        new_imp_req: The new imp_req being added</span>
+<span class=sd>        profile_title: The title of the source profile for the control implementation containing the imp_req</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        Inserts the imp_req on the first match found.  Note it is possible two control implementations could</span>
+<span class=sd>        have the same source and specify the same control</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>control_imp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>):</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>control_imp_param_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>control_imp</span><span class=p>)</span>
+        <span class=n>control_imp_rule_param_ids</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>param</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=k>for</span> <span class=n>params</span> <span class=ow>in</span> <span class=n>control_imp_param_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()</span> <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>params</span>
+        <span class=p>]</span>
+        <span class=k>if</span> <span class=n>profile_title</span> <span class=o>!=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_title_from_model_uri</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>control_imp</span><span class=o>.</span><span class=n>source</span><span class=p>):</span>
+            <span class=k>continue</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>!=</span> <span class=n>new_imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>imp_req_param_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_and_params_dict_from_item</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span>
+            <span class=n>imp_req_rule_param_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>param</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=k>for</span> <span class=n>params</span> <span class=ow>in</span> <span class=n>imp_req_param_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()</span> <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>params</span><span class=p>]</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>new_imp_req</span><span class=p>)</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>status</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>new_imp_req</span><span class=o>.</span><span class=n>description</span>
+            <span class=n>statement_dict</span> <span class=o>=</span> <span class=p>{</span><span class=n>stat</span><span class=o>.</span><span class=n>statement_id</span><span class=p>:</span> <span class=n>stat</span> <span class=k>for</span> <span class=n>stat</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>)}</span>
+            <span class=c1># update set parameter values with values from markdown - but only for rule param vals</span>
+            <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>new_imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>(</span><span class=n>control_imp_rule_param_ids</span> <span class=o>+</span> <span class=n>imp_req_rule_param_ids</span><span class=p>):</span>
+                    <span class=k>continue</span>
+                <span class=n>found</span> <span class=o>=</span> <span class=kc>False</span>
+                <span class=k>for</span> <span class=n>dest_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>dest_param</span><span class=o>.</span><span class=n>param_id</span> <span class=o>!=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=n>dest_param</span><span class=o>.</span><span class=n>values</span> <span class=o>=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>values</span>
+                    <span class=n>found</span> <span class=o>=</span> <span class=kc>True</span>
+                    <span class=k>break</span>
+                <span class=c1># if rule parameter val was not already set by a set_param, make new set_param for it</span>
+                <span class=k>if</span> <span class=n>found</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=c1># but first check if the parameter was already set with the same value in the control_imp</span>
+                <span class=c1># if so we don&#39;t need to insert a new set_param in imp_req</span>
+                <span class=k>for</span> <span class=n>dest_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>dest_param</span><span class=o>.</span><span class=n>param_id</span> <span class=o>!=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=k>if</span> <span class=n>dest_param</span><span class=o>.</span><span class=n>values</span> <span class=o>==</span> <span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>:</span>
+                        <span class=n>found</span> <span class=o>=</span> <span class=kc>True</span>
+                        <span class=k>break</span>
+                <span class=k>if</span> <span class=n>found</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                    <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>)</span>
+                <span class=p>)</span>
+            <span class=n>new_statements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>comp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>new_imp_req</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=c1># get the original version of the statement if available, or use new one</span>
+                <span class=n>stat</span> <span class=o>=</span> <span class=n>statement_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span><span class=p>,</span> <span class=n>statement</span><span class=p>)</span>
+                <span class=c1># update the description and status from markdown</span>
+                <span class=n>stat</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>description</span>
+                <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_copy_status_in_props</span><span class=p>(</span><span class=n>stat</span><span class=p>,</span> <span class=n>statement</span><span class=p>)</span>
+                <span class=n>new_statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>stat</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_statements</span><span class=p>)</span>
+            <span class=k>return</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+        <span class=sa>f</span><span class=s1>&#39;Unable to add imp req for component </span><span class=si>{</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> control </span><span class=si>{</span><span class=n>new_imp_req</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1> and source: </span><span class=si>{</span><span class=n>profile_title</span><span class=si>}</span><span class=s1>&#39;</span>  <span class=c1># noqa E501</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.insert_status_in_props class="doc doc-heading"> <code class="highlight language-python"><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>status</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.insert_status_in_props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Insert status content into props of the item.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1118</span>
+<span class=normal>1119</span>
+<span class=normal>1120</span>
+<span class=normal>1121</span>
+<span class=normal>1122</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>insert_status_in_props</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>,</span> <span class=n>status</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Insert status content into props of the item.&quot;&quot;&quot;</span>
+    <span class=n>prop</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_status_as_prop</span><span class=p>(</span><span class=n>status</span><span class=p>)</span>
+    <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_prop</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>prop</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.is_withdrawn class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_withdrawn</span><span class=p>(</span><span class=n>control</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.is_withdrawn class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Determine if control is marked Withdrawn.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>control</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.catalog.Control href=../../oscal/catalog/#trestle.oscal.catalog.Control>Control</a></code> </td> <td> <div class=doc-md-description> <p>The control that may be marked withdrawn.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>True if marked withdrawn, false otherwise.</p> </div> </td> </tr> </tbody> </table> <p>This is determined by property with name 'status' with value 'Withdrawn'.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>is_withdrawn</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Determine if control is marked Withdrawn.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        control: The control that may be marked withdrawn.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        True if marked withdrawn, false otherwise.</span>
+
+<span class=sd>    This is determined by property with name &#39;status&#39; with value &#39;Withdrawn&#39;.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>_</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=p>,</span>
+            <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>strip_lower_equals</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;status&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=n>strip_lower_equals</span><span class=p>(</span><span class=n>p</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=s1>&#39;withdrawn&#39;</span><span class=p>)):</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.item_has_rules class="doc doc-heading"> <code class="highlight language-python"><span class=n>item_has_rules</span><span class=p>(</span><span class=n>item</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.item_has_rules class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Determine if the item has rules in its props.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>item_has_rules</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Determine if the item has rules in its props.&quot;&quot;&quot;</span>
+    <span class=n>_</span><span class=p>,</span> <span class=n>rules_props</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rules_dict_from_item</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+    <span class=k>return</span> <span class=nb>bool</span><span class=p>(</span><span class=n>rules_props</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.merge_dicts_deep class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge_dicts_deep</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>,</span> <span class=n>overwrite_header_values</span><span class=p>,</span> <span class=n>depth</span><span class=o>=</span><span class=mi>0</span><span class=p>,</span> <span class=n>level</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.merge_dicts_deep class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge dict src into dest.</p> <p>New items are always added from src to dest. Items present in both will be overriden dest if overwrite_header_values is True.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>merge_dicts_deep</span><span class=p>(</span>
+    <span class=n>dest</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+    <span class=n>src</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=n>Any</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+    <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>depth</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>0</span><span class=p>,</span>
+    <span class=n>level</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>0</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Merge dict src into dest.</span>
+
+<span class=sd>    New items are always added from src to dest.</span>
+<span class=sd>    Items present in both will be overriden dest if overwrite_header_values is True.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>src</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>return</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>src</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>dest</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>depth</span> <span class=ow>and</span> <span class=n>level</span> <span class=o>==</span> <span class=n>depth</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>overwrite_header_values</span><span class=p>:</span>
+                    <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+                <span class=k>continue</span>
+            <span class=c1># if they are both dicts, recurse</span>
+            <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>dict</span><span class=p>)</span> <span class=ow>and</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>dict</span><span class=p>):</span>
+                <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_dicts_deep</span><span class=p>(</span><span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>overwrite_header_values</span><span class=p>,</span> <span class=n>depth</span><span class=p>,</span> <span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=c1># if they are both lists, add any item that is not already in the list</span>
+            <span class=k>elif</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>list</span><span class=p>)</span> <span class=ow>and</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>list</span><span class=p>):</span>
+                <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>]:</span>
+                    <span class=k>if</span> <span class=n>item</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]:</span>
+                        <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+            <span class=c1># otherwise override dest if needed</span>
+            <span class=k>elif</span> <span class=n>overwrite_header_values</span><span class=p>:</span>
+                <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># if the item was not already in dest, add it from src</span>
+            <span class=n>dest</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>src</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.merge_part class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge_part</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.merge_part class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge a source part into the destination part.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>merge_part</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>src</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Merge a source part into the destination part.&quot;&quot;&quot;</span>
+    <span class=n>dest</span><span class=o>.</span><span class=n>name</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>name</span> <span class=k>if</span> <span class=n>src</span><span class=o>.</span><span class=n>name</span> <span class=k>else</span> <span class=n>dest</span><span class=o>.</span><span class=n>name</span>
+    <span class=n>dest</span><span class=o>.</span><span class=n>ns</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>ns</span> <span class=k>if</span> <span class=n>src</span><span class=o>.</span><span class=n>ns</span> <span class=k>else</span> <span class=n>dest</span><span class=o>.</span><span class=n>ns</span>
+    <span class=n>dest</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_props</span><span class=p>(</span><span class=n>dest</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>src</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+    <span class=n>dest</span><span class=o>.</span><span class=n>prose</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>prose</span>
+    <span class=n>dest</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>title</span> <span class=k>if</span> <span class=n>src</span><span class=o>.</span><span class=n>title</span> <span class=k>else</span> <span class=n>dest</span><span class=o>.</span><span class=n>title</span>
+    <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_parts</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>dest</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.merge_parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge_parts</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.merge_parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge the parts from the source into the destination.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>merge_parts</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>TypeWithParts</span><span class=p>,</span> <span class=n>src</span><span class=p>:</span> <span class=n>TypeWithParts</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Merge the parts from the source into the destination.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>dest</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>src</span><span class=o>.</span><span class=n>parts</span>
+    <span class=k>elif</span> <span class=ow>not</span> <span class=n>src</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>new_parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>dest_map</span> <span class=o>=</span> <span class=p>{</span><span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>:</span> <span class=n>part</span> <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>dest</span><span class=o>.</span><span class=n>parts</span><span class=p>}</span>
+        <span class=k>for</span> <span class=n>src_part</span> <span class=ow>in</span> <span class=n>src</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>dest_part</span> <span class=o>=</span> <span class=n>dest_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>src_part</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>dest_part</span><span class=p>:</span>
+                <span class=n>new_parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>src_part</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>new_part</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_part</span><span class=p>(</span><span class=n>dest_part</span><span class=p>,</span> <span class=n>src_part</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>new_part</span><span class=p>:</span>
+                    <span class=n>new_parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_part</span><span class=p>)</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>new_parts</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.merge_props class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge_props</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.merge_props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge a source list of properties into a destination list.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>merge_props</span><span class=p>(</span><span class=n>dest</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]],</span>
+                <span class=n>src</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Merge a source list of properties into a destination list.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>src</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>dest</span>
+    <span class=n>new_props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>src_map</span> <span class=o>=</span> <span class=p>{</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span> <span class=n>prop</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>src</span><span class=p>}</span>
+    <span class=n>dest_map</span> <span class=o>=</span> <span class=p>{</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span> <span class=n>prop</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>dest</span><span class=p>}</span>
+    <span class=n>all_names</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>src_map</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>dest_map</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+    <span class=k>for</span> <span class=n>name</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>all_names</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>name</span> <span class=ow>in</span> <span class=n>src_map</span> <span class=ow>and</span> <span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>dest_map</span><span class=p>:</span>
+            <span class=n>new_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>src_map</span><span class=p>[</span><span class=n>name</span><span class=p>])</span>
+        <span class=k>elif</span> <span class=n>name</span> <span class=ow>in</span> <span class=n>dest_map</span> <span class=ow>and</span> <span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>src_map</span><span class=p>:</span>
+            <span class=n>new_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>dest_map</span><span class=p>[</span><span class=n>name</span><span class=p>])</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>new_prop</span> <span class=o>=</span> <span class=n>dest_map</span><span class=p>[</span><span class=n>name</span><span class=p>]</span>
+            <span class=n>src_prop</span> <span class=o>=</span> <span class=n>src_map</span><span class=p>[</span><span class=n>name</span><span class=p>]</span>
+            <span class=n>new_prop</span><span class=o>.</span><span class=n>class_</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>class_</span> <span class=k>if</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>class_</span> <span class=k>else</span> <span class=n>new_prop</span><span class=o>.</span><span class=n>class_</span>
+            <span class=n>new_prop</span><span class=o>.</span><span class=n>ns</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>ns</span> <span class=k>if</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>ns</span> <span class=k>else</span> <span class=n>new_prop</span><span class=o>.</span><span class=n>ns</span>
+            <span class=n>new_prop</span><span class=o>.</span><span class=n>remarks</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>remarks</span> <span class=k>if</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>remarks</span> <span class=k>else</span> <span class=n>new_prop</span><span class=o>.</span><span class=n>remarks</span>
+            <span class=n>new_prop</span><span class=o>.</span><span class=n>uuid</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>uuid</span> <span class=k>if</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>uuid</span> <span class=k>else</span> <span class=n>new_prop</span><span class=o>.</span><span class=n>uuid</span>
+            <span class=n>new_prop</span><span class=o>.</span><span class=n>value</span> <span class=o>=</span> <span class=n>src_prop</span><span class=o>.</span><span class=n>value</span>
+            <span class=n>new_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_prop</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>new_props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.param_to_str class="doc doc-heading"> <code class="highlight language-python"><span class=n>param_to_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>param_rep</span><span class=p>,</span> <span class=n>verbose</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>brackets</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>params_format</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>param_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.param_to_str class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert parameter to string based on best available representation.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>param</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.common.Parameter href=../../oscal/common/#trestle.oscal.common.Parameter>Parameter</a></code> </td> <td> <div class=doc-md-description> <p>the parameter to convert</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>param_rep</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_interface.ParameterRep href=#trestle.core.control_interface.ParameterRep>ParameterRep</a></code> </td> <td> <div class=doc-md-description> <p>how to represent the parameter</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>verbose</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>provide verbose text for selection choices</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>brackets</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>add brackets around the lists of items</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>params_format</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>a string containing a single dot that represents a form of highlighting around the param</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>value_assigned_prefix</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>string to place before the parameter string if a value was assigned</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>value_not_assigned_prefix</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>string to place before the parameter string if value not assigned</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>formatted string or None</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>742</span>
+<span class=normal>743</span>
+<span class=normal>744</span>
+<span class=normal>745</span>
+<span class=normal>746</span>
+<span class=normal>747</span>
+<span class=normal>748</span>
+<span class=normal>749</span>
+<span class=normal>750</span>
+<span class=normal>751</span>
+<span class=normal>752</span>
+<span class=normal>753</span>
+<span class=normal>754</span>
+<span class=normal>755</span>
+<span class=normal>756</span>
+<span class=normal>757</span>
+<span class=normal>758</span>
+<span class=normal>759</span>
+<span class=normal>760</span>
+<span class=normal>761</span>
+<span class=normal>762</span>
+<span class=normal>763</span>
+<span class=normal>764</span>
+<span class=normal>765</span>
+<span class=normal>766</span>
+<span class=normal>767</span>
+<span class=normal>768</span>
+<span class=normal>769</span>
+<span class=normal>770</span>
+<span class=normal>771</span>
+<span class=normal>772</span>
+<span class=normal>773</span>
+<span class=normal>774</span>
+<span class=normal>775</span>
+<span class=normal>776</span>
+<span class=normal>777</span>
+<span class=normal>778</span>
+<span class=normal>779</span>
+<span class=normal>780</span>
+<span class=normal>781</span>
+<span class=normal>782</span>
+<span class=normal>783</span>
+<span class=normal>784</span>
+<span class=normal>785</span>
+<span class=normal>786</span>
+<span class=normal>787</span>
+<span class=normal>788</span>
+<span class=normal>789</span>
+<span class=normal>790</span>
+<span class=normal>791</span>
+<span class=normal>792</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>param_to_str</span><span class=p>(</span>
+    <span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span>
+    <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span><span class=p>,</span>
+    <span class=n>verbose</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>brackets</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Convert parameter to string based on best available representation.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        param: the parameter to convert</span>
+<span class=sd>        param_rep: how to represent the parameter</span>
+<span class=sd>        verbose: provide verbose text for selection choices</span>
+<span class=sd>        brackets: add brackets around the lists of items</span>
+<span class=sd>        params_format: a string containing a single dot that represents a form of highlighting around the param</span>
+<span class=sd>        value_assigned_prefix: string to place before the parameter string if a value was assigned</span>
+<span class=sd>        value_not_assigned_prefix: string to place before the parameter string if value not assigned</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        formatted string or None</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>param_str</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>if</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_STRING_NONE</span><span class=p>:</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=n>param_str</span> <span class=k>if</span> <span class=n>param_str</span> <span class=k>else</span> <span class=s1>&#39;None&#39;</span>
+    <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LABEL_OR_CHOICES</span><span class=p>:</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_label_choices_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>verbose</span><span class=p>,</span> <span class=n>brackets</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_LABEL_OR_CHOICES</span><span class=p>:</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_label_choices_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>verbose</span><span class=p>,</span> <span class=n>brackets</span><span class=p>)</span>
+    <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_EMPTY_STRING</span><span class=p>:</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_as_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>brackets</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>ASSIGNMENT_FORM</span><span class=p>:</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_values_assignment_str</span><span class=p>(</span>
+            <span class=n>param</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>elif</span> <span class=n>param_rep</span> <span class=o>==</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LABEL_FORM</span><span class=p>:</span>
+        <span class=n>param_str</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_param_labels_assignment_str</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>param_str</span><span class=p>:</span>
+            <span class=n>param_str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>return</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_apply_params_format</span><span class=p>(</span><span class=n>param_str</span><span class=p>,</span> <span class=n>params_format</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.replace_control_prose class="doc doc-heading"> <code class="highlight language-python"><span class=n>replace_control_prose</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>param_dict</span><span class=p>,</span> <span class=n>params_format</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_LABEL_OR_CHOICES</span><span class=p>,</span> <span class=n>show_value_warnings</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.replace_control_prose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Replace the control prose according to set_param.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 990</span>
+<span class=normal> 991</span>
+<span class=normal> 992</span>
+<span class=normal> 993</span>
+<span class=normal> 994</span>
+<span class=normal> 995</span>
+<span class=normal> 996</span>
+<span class=normal> 997</span>
+<span class=normal> 998</span>
+<span class=normal> 999</span>
+<span class=normal>1000</span>
+<span class=normal>1001</span>
+<span class=normal>1002</span>
+<span class=normal>1003</span>
+<span class=normal>1004</span>
+<span class=normal>1005</span>
+<span class=normal>1006</span>
+<span class=normal>1007</span>
+<span class=normal>1008</span>
+<span class=normal>1009</span>
+<span class=normal>1010</span>
+<span class=normal>1011</span>
+<span class=normal>1012</span>
+<span class=normal>1013</span>
+<span class=normal>1014</span>
+<span class=normal>1015</span>
+<span class=normal>1016</span>
+<span class=normal>1017</span>
+<span class=normal>1018</span>
+<span class=normal>1019</span>
+<span class=normal>1020</span>
+<span class=normal>1021</span>
+<span class=normal>1022</span>
+<span class=normal>1023</span>
+<span class=normal>1024</span>
+<span class=normal>1025</span>
+<span class=normal>1026</span>
+<span class=normal>1027</span>
+<span class=normal>1028</span>
+<span class=normal>1029</span>
+<span class=normal>1030</span>
+<span class=normal>1031</span>
+<span class=normal>1032</span>
+<span class=normal>1033</span>
+<span class=normal>1034</span>
+<span class=normal>1035</span>
+<span class=normal>1036</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>replace_control_prose</span><span class=p>(</span>
+    <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+    <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>],</span>
+    <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_LABEL_OR_CHOICES</span><span class=p>,</span>
+    <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Replace the control prose according to set_param.&quot;&quot;&quot;</span>
+    <span class=c1># first replace all choices that reference parameters</span>
+    <span class=c1># note that in ASSIGNMENT_FORM each choice with a parameter will end up as [Assignment: value]</span>
+    <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>):</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_param_choices</span><span class=p>(</span>
+            <span class=n>param</span><span class=p>,</span>
+            <span class=n>param_dict</span><span class=p>,</span>
+            <span class=n>params_format</span><span class=p>,</span>
+            <span class=n>param_rep</span><span class=p>,</span>
+            <span class=n>show_value_warnings</span><span class=p>,</span>
+            <span class=n>value_assigned_prefix</span><span class=p>,</span>
+            <span class=n>value_not_assigned_prefix</span>
+        <span class=p>)</span>
+    <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>fixed_prose</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_params</span><span class=p>(</span>
+                <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>,</span>
+                <span class=n>param_dict</span><span class=p>,</span>
+                <span class=n>params_format</span><span class=p>,</span>
+                <span class=n>param_rep</span><span class=p>,</span>
+                <span class=n>show_value_warnings</span><span class=p>,</span>
+                <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                <span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+            <span class=c1># change the prose in the control itself</span>
+            <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=o>=</span> <span class=n>fixed_prose</span>
+        <span class=k>for</span> <span class=n>prt</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>_replace_part_prose</span><span class=p>(</span>
+                <span class=n>control</span><span class=p>,</span>
+                <span class=n>prt</span><span class=p>,</span>
+                <span class=n>param_dict</span><span class=p>,</span>
+                <span class=n>params_format</span><span class=p>,</span>
+                <span class=n>param_rep</span><span class=p>,</span>
+                <span class=n>show_value_warnings</span><span class=p>,</span>
+                <span class=n>value_assigned_prefix</span><span class=p>,</span>
+                <span class=n>value_not_assigned_prefix</span>
+            <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.setparam_to_param class="doc doc-heading"> <code class="highlight language-python"><span class=n>setparam_to_param</span><span class=p>(</span><span class=n>param_id</span><span class=p>,</span> <span class=n>set_param</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.setparam_to_param class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert setparameter to parameter.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>param_id</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>the id of the parameter</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>set_param</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.profile.SetParameter href=../../oscal/profile/#trestle.oscal.profile.SetParameter>SetParameter</a></code> </td> <td> <div class=doc-md-description> <p>the set_parameter from a profile</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.common.Parameter href=../../oscal/common/#trestle.oscal.common.Parameter>Parameter</a></code> </td> <td> <div class=doc-md-description> <p>a Parameter with param_id and content from the SetParameter</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>setparam_to_param</span><span class=p>(</span><span class=n>param_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>set_param</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Convert setparameter to parameter.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        param_id: the id of the parameter</span>
+<span class=sd>        set_param: the set_parameter from a profile</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        a Parameter with param_id and content from the SetParameter</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>(</span>
+        <span class=nb>id</span><span class=o>=</span><span class=n>param_id</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>,</span> <span class=n>select</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>select</span><span class=p>,</span> <span class=n>label</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>label</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>props</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.strip_to_make_ncname class="doc doc-heading"> <code class="highlight language-python"><span class=n>strip_to_make_ncname</span><span class=p>(</span><span class=n>label</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.strip_to_make_ncname class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Strip chars to conform with NCNAME regex.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>strip_to_make_ncname</span><span class=p>(</span><span class=n>label</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Strip chars to conform with NCNAME regex.&quot;&quot;&quot;</span>
+    <span class=n>orig_label</span> <span class=o>=</span> <span class=n>label</span>
+    <span class=c1># make sure first char is allowed</span>
+    <span class=k>while</span> <span class=n>label</span> <span class=ow>and</span> <span class=n>label</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>NCNAME_UTF8_FIRST_CHAR_OPTIONS</span><span class=p>:</span>
+        <span class=n>label</span> <span class=o>=</span> <span class=n>label</span><span class=p>[</span><span class=mi>1</span><span class=p>:]</span>
+    <span class=n>new_label</span> <span class=o>=</span> <span class=n>label</span><span class=p>[:</span><span class=mi>1</span><span class=p>]</span>
+    <span class=c1># now check remaining chars</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>label</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>ii</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=nb>len</span><span class=p>(</span><span class=n>label</span><span class=p>)):</span>
+            <span class=k>if</span> <span class=n>label</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>NCNAME_UTF8_OTHER_CHAR_OPTIONS</span><span class=p>:</span>
+                <span class=n>new_label</span> <span class=o>+=</span> <span class=n>label</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span>
+    <span class=c1># do final check to confirm it is NCNAME</span>
+    <span class=n>match</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>NCNAME_REGEX</span><span class=p>,</span> <span class=n>new_label</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>match</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to convert label </span><span class=si>{</span><span class=n>orig_label</span><span class=si>}</span><span class=s1> to NCNAME format.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>new_label</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.ControlInterface.uniquify_set_params class="doc doc-heading"> <code class="highlight language-python"><span class=n>uniquify_set_params</span><span class=p>(</span><span class=n>set_params</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_interface.ControlInterface.uniquify_set_params class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Remove items with same param_id with priority to later items.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>uniquify_set_params</span><span class=p>(</span><span class=n>set_params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TypeWithParamId</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>TypeWithParamId</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove items with same param_id with priority to later items.&quot;&quot;&quot;</span>
+    <span class=n>found_ids</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+    <span class=n>unique_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>TypeWithParamId</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=nb>reversed</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>set_params</span><span class=p>)):</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>found_ids</span><span class=p>:</span>
+            <span class=n>unique_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_param</span><span class=p>)</span>
+            <span class=n>found_ids</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+    <span class=k>return</span> <span class=nb>list</span><span class=p>(</span><span class=nb>reversed</span><span class=p>(</span><span class=n>unique_list</span><span class=p>))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.control_interface.ParameterRep class="doc doc-heading"> <code>ParameterRep</code> <a href=#trestle.core.control_interface.ParameterRep class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Enum for ways to represent a parameter.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ParameterRep</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Enum for ways to represent a parameter.&quot;&quot;&quot;</span>
+
+    <span class=n>LEAVE_MOUSTACHE</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=n>VALUE_OR_STRING_NONE</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=n>LABEL_OR_CHOICES</span> <span class=o>=</span> <span class=mi>2</span>
+    <span class=n>VALUE_OR_LABEL_OR_CHOICES</span> <span class=o>=</span> <span class=mi>3</span>
+    <span class=n>VALUE_OR_EMPTY_STRING</span> <span class=o>=</span> <span class=mi>4</span>
+    <span class=n>ASSIGNMENT_FORM</span> <span class=o>=</span> <span class=mi>5</span>
+    <span class=n>LABEL_FORM</span> <span class=o>=</span> <span class=mi>6</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.control_interface.ParameterRep-attributes>Attributes<a href=#trestle.core.control_interface.ParameterRep-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ParameterRep.ASSIGNMENT_FORM class="doc doc-heading"> <code class="highlight language-python"><span class=n>ASSIGNMENT_FORM</span> <span class=o>=</span> <span class=mi>5</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ParameterRep.ASSIGNMENT_FORM class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ParameterRep.LABEL_FORM class="doc doc-heading"> <code class="highlight language-python"><span class=n>LABEL_FORM</span> <span class=o>=</span> <span class=mi>6</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ParameterRep.LABEL_FORM class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ParameterRep.LABEL_OR_CHOICES class="doc doc-heading"> <code class="highlight language-python"><span class=n>LABEL_OR_CHOICES</span> <span class=o>=</span> <span class=mi>2</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ParameterRep.LABEL_OR_CHOICES class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ParameterRep.LEAVE_MOUSTACHE class="doc doc-heading"> <code class="highlight language-python"><span class=n>LEAVE_MOUSTACHE</span> <span class=o>=</span> <span class=mi>0</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ParameterRep.LEAVE_MOUSTACHE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ParameterRep.VALUE_OR_EMPTY_STRING class="doc doc-heading"> <code class="highlight language-python"><span class=n>VALUE_OR_EMPTY_STRING</span> <span class=o>=</span> <span class=mi>4</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ParameterRep.VALUE_OR_EMPTY_STRING class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ParameterRep.VALUE_OR_LABEL_OR_CHOICES class="doc doc-heading"> <code class="highlight language-python"><span class=n>VALUE_OR_LABEL_OR_CHOICES</span> <span class=o>=</span> <span class=mi>3</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ParameterRep.VALUE_OR_LABEL_OR_CHOICES class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.ParameterRep.VALUE_OR_STRING_NONE class="doc doc-heading"> <code class="highlight language-python"><span class=n>VALUE_OR_STRING_NONE</span> <span class=o>=</span> <span class=mi>1</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.ParameterRep.VALUE_OR_STRING_NONE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.control_interface.PartInfo class="doc doc-heading"> <code>PartInfo</code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> </span> <a href=#trestle.core.control_interface.PartInfo class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class to capture control part info needed in markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@dataclass</span>
+<span class=k>class</span> <span class=nc>PartInfo</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to capture control part info needed in markdown.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=n>prose</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=n>smt_part</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>PartInfo</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>to_dicts</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert the part info to a dict or list of props.&quot;&quot;&quot;</span>
+        <span class=n>prop_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>part</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># if it has a part name then it is a part with prose</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+            <span class=n>part</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+                <span class=n>part</span><span class=p>[</span><span class=s1>&#39;prose&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>prose</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>all_subparts</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                    <span class=n>subpart_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>subpart</span><span class=o>.</span><span class=n>to_dicts</span><span class=p>(</span><span class=n>part_id_map</span><span class=p>)</span>
+                    <span class=n>all_subparts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>subpart_dict</span><span class=p>)</span>
+                <span class=n>part</span><span class=p>[</span><span class=s1>&#39;parts&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>all_subparts</span>
+
+        <span class=c1># otherwise it is a list of props</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+                <span class=n>prop_d</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;value&#39;</span><span class=p>:</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>}</span>
+                <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>ns</span><span class=p>:</span>
+                    <span class=n>prop_d</span><span class=p>[</span><span class=s1>&#39;ns&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>ns</span><span class=p>)</span>
+                <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>smt_part</span><span class=p>:</span>
+                    <span class=n>prop_d</span><span class=p>[</span><span class=s1>&#39;smt-part&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>smt_part</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>smt_part</span><span class=p>)</span>
+                <span class=n>prop_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop_d</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>part</span><span class=p>,</span> <span class=n>prop_list</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.control_interface.PartInfo-attributes>Attributes<a href=#trestle.core.control_interface.PartInfo-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.PartInfo.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=nb>str</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.PartInfo.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.PartInfo.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>PartInfo</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.PartInfo.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.PartInfo.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.PartInfo.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.PartInfo.prose class="doc doc-heading"> <code class="highlight language-python"><span class=n>prose</span><span class=p>:</span> <span class=nb>str</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.PartInfo.prose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.control_interface.PartInfo.smt_part class="doc doc-heading"> <code class="highlight language-python"><span class=n>smt_part</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.control_interface.PartInfo.smt_part class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.control_interface.PartInfo-functions>Functions<a href=#trestle.core.control_interface.PartInfo-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.PartInfo.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>prose</span><span class=p>,</span> <span class=n>smt_part</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>parts</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.control_interface.PartInfo.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_interface.PartInfo.to_dicts class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_dicts</span><span class=p>(</span><span class=n>part_id_map</span><span class=p>)</span></code> <a href=#trestle.core.control_interface.PartInfo.to_dicts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert the part info to a dict or list of props.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_dicts</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert the part info to a dict or list of props.&quot;&quot;&quot;</span>
+    <span class=n>prop_list</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>part</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=c1># if it has a part name then it is a part with prose</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+        <span class=n>part</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+            <span class=n>part</span><span class=p>[</span><span class=s1>&#39;prose&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>prose</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>all_subparts</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>subpart_dict</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>subpart</span><span class=o>.</span><span class=n>to_dicts</span><span class=p>(</span><span class=n>part_id_map</span><span class=p>)</span>
+                <span class=n>all_subparts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>subpart_dict</span><span class=p>)</span>
+            <span class=n>part</span><span class=p>[</span><span class=s1>&#39;parts&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>all_subparts</span>
+
+    <span class=c1># otherwise it is a list of props</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=n>prop_d</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;value&#39;</span><span class=p>:</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>}</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>ns</span><span class=p>:</span>
+                <span class=n>prop_d</span><span class=p>[</span><span class=s1>&#39;ns&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>ns</span><span class=p>)</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>smt_part</span><span class=p>:</span>
+                <span class=n>prop_d</span><span class=p>[</span><span class=s1>&#39;smt-part&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>smt_part</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>smt_part</span><span class=p>)</span>
+            <span class=n>prop_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop_d</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>part</span><span class=p>,</span> <span class=n>prop_list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.control_interface-functions>Functions<a href=#trestle.core.control_interface-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/control_reader/index.html b/latest/reference/API/trestle/core/control_reader/index.html
new file mode 100644
index 000000000..647f4acd2
--- /dev/null
+++ b/latest/reference/API/trestle/core/control_reader/index.html
@@ -0,0 +1,1466 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.control_reader module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_reader/ rel=canonical><link href=../control_interface/ rel=prev><link href=../control_writer/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.control_reader - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.control_reader - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.control_reader module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/control_reader.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_reader/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.control_reader - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.control_reader module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/control_reader.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.control_reader class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.control_reader </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.control_reader </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.control_reader </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.control_reader class=md-nav__link> <span class=md-ellipsis> control_reader </span> </a> <nav class=md-nav aria-label=control_reader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader class=md-nav__link> <span class=md-ellipsis> ControlReader </span> </a> <nav class=md-nav aria-label=ControlReader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.get_props_list class=md-nav__link> <span class=md-ellipsis> get_props_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.read_control class=md-nav__link> <span class=md-ellipsis> read_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.read_control_info_from_md class=md-nav__link> <span class=md-ellipsis> read_control_info_from_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.read_editable_content class=md-nav__link> <span class=md-ellipsis> read_editable_content </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.read_implemented_requirement class=md-nav__link> <span class=md-ellipsis> read_implemented_requirement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.simplify_name class=md-nav__link> <span class=md-ellipsis> simplify_name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.control_reader class=md-nav__link> <span class=md-ellipsis> control_reader </span> </a> <nav class=md-nav aria-label=control_reader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader class=md-nav__link> <span class=md-ellipsis> ControlReader </span> </a> <nav class=md-nav aria-label=ControlReader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.get_props_list class=md-nav__link> <span class=md-ellipsis> get_props_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.read_control class=md-nav__link> <span class=md-ellipsis> read_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.read_control_info_from_md class=md-nav__link> <span class=md-ellipsis> read_control_info_from_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.read_editable_content class=md-nav__link> <span class=md-ellipsis> read_editable_content </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.read_implemented_requirement class=md-nav__link> <span class=md-ellipsis> read_implemented_requirement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader.ControlReader.simplify_name class=md-nav__link> <span class=md-ellipsis> simplify_name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_reader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.control_reader</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.control_reader class="doc doc-heading"> <code>trestle.core.control_reader</code> <a href=#trestle.core.control_reader class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Handle reading of writing controls from markdown.</p> <div class="doc doc-children"> <h3 id=trestle.core.control_reader-attributes>Attributes<a href=#trestle.core.control_reader-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.control_reader.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.control_reader.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.control_reader-classes>Classes<a href=#trestle.core.control_reader-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.control_reader.ControlReader class="doc doc-heading"> <code>ControlReader</code> <a href=#trestle.core.control_reader.ControlReader class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class to read controls from markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlReader</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to read controls from markdown.&quot;&quot;&quot;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_clean_prose</span><span class=p>(</span><span class=n>prose</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+        <span class=c1># remove empty and horizontal rule lines at start and end of list of prose lines</span>
+        <span class=n>forward_index</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>prose</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;____&#39;</span><span class=p>):</span>
+                <span class=k>break</span>
+            <span class=n>forward_index</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=n>new_prose</span> <span class=o>=</span> <span class=n>prose</span><span class=p>[</span><span class=n>forward_index</span><span class=p>:]</span>
+        <span class=n>reverse_index</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=nb>reversed</span><span class=p>(</span><span class=n>new_prose</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;____&#39;</span><span class=p>):</span>
+                <span class=k>break</span>
+            <span class=n>reverse_index</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=n>clean_prose</span> <span class=o>=</span> <span class=n>new_prose</span><span class=p>[:</span><span class=nb>len</span><span class=p>(</span><span class=n>new_prose</span><span class=p>)</span> <span class=o>-</span> <span class=n>reverse_index</span><span class=p>]</span>
+        <span class=n>clean_prose</span> <span class=o>=</span> <span class=n>clean_prose</span> <span class=k>if</span> <span class=n>clean_prose</span> <span class=k>else</span> <span class=p>[</span><span class=s1>&#39;&#39;</span><span class=p>]</span>
+        <span class=c1># if there is no useful prose this will return [&#39;&#39;] and allow generation of a statement with empty prose</span>
+        <span class=k>return</span> <span class=n>clean_prose</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_comp_name_in_dict</span><span class=p>(</span><span class=n>comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>:</span> <span class=n>CompDict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;If the name is already in the dict in a similar form, stick to that form.&quot;&quot;&quot;</span>
+        <span class=n>simple_name</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>simplify_name</span><span class=p>(</span><span class=n>comp_name</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>name</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>simple_name</span> <span class=o>==</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>simplify_name</span><span class=p>(</span><span class=n>name</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>name</span>
+        <span class=k>return</span> <span class=n>comp_name</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_node_to_dict</span><span class=p>(</span>
+        <span class=n>comp_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>label</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>comp_dict</span><span class=p>:</span> <span class=n>CompDict</span><span class=p>,</span>
+        <span class=n>node</span><span class=p>:</span> <span class=n>ControlMarkdownNode</span><span class=p>,</span>
+        <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>comp_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Extract the label, prose, possible component name - along with implementation status.</span>
+
+<span class=sd>        In component mode there is only one component and its name is not in markdown.</span>
+<span class=sd>        In ssp mode there are many components in each md file.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>component_mode</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span>
+        <span class=c1># for ssp, ### marks component name but for component it is ##</span>
+        <span class=c1># if it is a header, make sure it has correct format</span>
+        <span class=k>if</span> <span class=n>node</span><span class=o>.</span><span class=n>key</span> <span class=ow>and</span> <span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;#&#39;</span> <span class=ow>and</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>bad_header</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Improper header format for control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>component_mode</span><span class=p>:</span>
+            <span class=c1># look for component name heading if present</span>
+            <span class=n>prefix</span> <span class=o>=</span> <span class=s1>&#39;### &#39;</span>
+            <span class=k>if</span> <span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>prefix</span><span class=p>):</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>split</span><span class=p>())</span> <span class=o>&lt;=</span> <span class=mi>1</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;Header line in control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> markdown starts with </span><span class=si>{</span><span class=n>prefix</span><span class=si>}</span><span class=s1> but has no content.&#39;</span>
+                    <span class=p>)</span>
+                <span class=n>comp_name</span> <span class=o>=</span> <span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>)[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>simp_comp_name</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>simplify_name</span><span class=p>(</span><span class=n>comp_name</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>simp_comp_name</span> <span class=ow>in</span> <span class=n>comp_list</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> has a section with two component headings for </span><span class=si>{</span><span class=n>comp_name</span><span class=si>}</span><span class=s1>.  &#39;</span>
+                        <span class=s1>&#39;Please combine the sections so there is only one heading for each component in a &#39;</span>
+                        <span class=s1>&#39;statement.&#39;</span>
+                    <span class=p>)</span>
+                <span class=n>comp_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>simp_comp_name</span><span class=p>)</span>
+                <span class=n>comp_name</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>_comp_name_in_dict</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>)</span>
+
+        <span class=c1># prose may be empty in md and we want to capture that so put it in the comp_dict</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>ControlReader</span><span class=o>.</span><span class=n>_clean_prose</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>text</span><span class=p>))</span>
+        <span class=c1># add the prose to the comp_dict, creating new entry as needed</span>
+        <span class=k>if</span> <span class=n>comp_name</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>label</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]:</span>
+                <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>][</span><span class=n>label</span><span class=p>]</span><span class=o>.</span><span class=n>prose</span> <span class=o>=</span> <span class=n>prose</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># create new entry with prose</span>
+                <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>][</span><span class=n>label</span><span class=p>]</span> <span class=o>=</span> <span class=n>ComponentImpInfo</span><span class=p>(</span><span class=n>prose</span><span class=o>=</span><span class=n>prose</span><span class=p>,</span> <span class=n>rules</span><span class=o>=</span><span class=p>[],</span> <span class=n>props</span><span class=o>=</span><span class=p>[])</span>
+        <span class=k>elif</span> <span class=n>comp_name</span><span class=p>:</span>
+            <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=n>label</span><span class=p>:</span> <span class=n>ComponentImpInfo</span><span class=p>(</span><span class=n>prose</span><span class=o>=</span><span class=n>prose</span><span class=p>,</span> <span class=n>rules</span><span class=o>=</span><span class=p>[],</span> <span class=n>props</span><span class=o>=</span><span class=p>[])}</span>
+
+        <span class=c1># build list of subnodes that get handled specially so they aren&#39;t processed here</span>
+        <span class=n>subnode_kill</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>int</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>status_str</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>remarks_str</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>rules_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>ii</span><span class=p>,</span> <span class=n>subnode</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>subnodes</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>subnode</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_STATUS_REMARKS_HEADER</span><span class=p>)</span> <span class=o>&gt;=</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>remarks_str</span> <span class=o>=</span> <span class=n>subnode</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=n>maxsplit</span><span class=o>=</span><span class=mi>4</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+                <span class=n>subnode_kill</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ii</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>subnode</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_STATUS_HEADER</span><span class=p>)</span> <span class=o>&gt;=</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>status_str</span> <span class=o>=</span> <span class=n>subnode</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=n>maxsplit</span><span class=o>=</span><span class=mi>3</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+                <span class=n>subnode_kill</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ii</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>subnode</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=s1>&#39;Rules:&#39;</span><span class=p>)</span> <span class=o>&gt;=</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>rules_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>text</span><span class=p>[</span><span class=mi>2</span><span class=p>:]</span> <span class=k>for</span> <span class=n>text</span> <span class=ow>in</span> <span class=n>subnode</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>text</span> <span class=k>if</span> <span class=n>text</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;- &#39;</span><span class=p>)]</span>
+                <span class=n>subnode_kill</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ii</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>status_str</span><span class=p>:</span>
+            <span class=n>new_status</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>status_str</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=n>remarks_str</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>comp_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=p>:</span>
+                <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>if</span> <span class=n>label</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]:</span>
+                <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>][</span><span class=n>label</span><span class=p>]</span> <span class=o>=</span> <span class=n>ComponentImpInfo</span><span class=p>(</span><span class=n>prose</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>rules</span><span class=o>=</span><span class=p>[],</span> <span class=n>props</span><span class=o>=</span><span class=p>[])</span>
+            <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>][</span><span class=n>label</span><span class=p>]</span><span class=o>.</span><span class=n>status</span> <span class=o>=</span> <span class=n>new_status</span>
+        <span class=k>if</span> <span class=n>rules_list</span><span class=p>:</span>
+            <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>][</span><span class=n>label</span><span class=p>]</span><span class=o>.</span><span class=n>rules</span> <span class=o>=</span> <span class=n>rules_list</span>
+        <span class=n>delete_list_from_list</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>subnodes</span><span class=p>,</span> <span class=n>subnode_kill</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>subnode</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>subnodes</span><span class=p>):</span>
+            <span class=n>ControlReader</span><span class=o>.</span><span class=n>_add_node_to_dict</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>subnode</span><span class=p>,</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>comp_list</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_insert_header_content</span><span class=p>(</span>
+        <span class=n>imp_req</span><span class=p>:</span> <span class=n>generic</span><span class=o>.</span><span class=n>GenericImplementedRequirement</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Insert yaml header content into the imp_req and its by_comps as props.&quot;&quot;&quot;</span>
+        <span class=n>dict_</span> <span class=o>=</span> <span class=n>header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_PROPS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>roles</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>dict_</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>RESPONSIBLE_ROLES</span><span class=p>,</span> <span class=p>[]))</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>responsible_roles</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>role</span> <span class=ow>in</span> <span class=n>roles</span><span class=p>:</span>
+            <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>role</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+                <span class=c1># role_id must conform to NCNAME regex</span>
+                <span class=n>role</span> <span class=o>=</span> <span class=n>role</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>role</span><span class=p>:</span>
+                    <span class=n>responsible_roles</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=n>role</span><span class=p>))</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Role in header for control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> not recognized: </span><span class=si>{</span><span class=n>role</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>props</span><span class=p>:</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>props</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>responsible_roles</span><span class=p>:</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>responsible_roles</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>responsible_roles</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>responsible_roles</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>responsible_roles</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>responsible_roles</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>responsible_roles</span><span class=p>)</span>
+            <span class=c1># enforce single list of resp. roles for control and each by_comp</span>
+            <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                <span class=n>by_comp</span><span class=o>.</span><span class=n>responsible_roles</span> <span class=o>=</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>responsible_roles</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>simplify_name</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Simplify the name to ignore variations in case, space, hyphen, underscore, slash.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;_&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;/&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_label_from_implementation_header</span><span class=p>(</span><span class=n>imp_header</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+        <span class=c1># assumed to be of form: Implementation for part a.</span>
+        <span class=n>split_header</span> <span class=o>=</span> <span class=n>imp_header</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=mi>4</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>split_header</span><span class=p>)</span> <span class=o>!=</span> <span class=mi>5</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Implementation header cannot be parsed for statement part: </span><span class=si>{</span><span class=n>imp_header</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>split_header</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>read_control_info_from_md</span><span class=p>(</span><span class=n>control_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+                                  <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]],</span> <span class=n>CompDict</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Find all labels and associated implementation prose in the markdown for this control.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            control_file: path to the control markdown file</span>
+<span class=sd>            context: context of the control usage</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The yaml header as dict in second part of tuple.</span>
+<span class=sd>            Adds to the passed in comp_dict.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>yaml_header</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>comp_dict</span> <span class=o>=</span> <span class=p>{}</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>control_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>yaml_header</span><span class=p>,</span> <span class=n>comp_dict</span>
+        <span class=c1># if the file exists, load the contents but do not use prose from comp_dict</span>
+        <span class=c1># for non ssp or component mode just use empty string for comp</span>
+        <span class=n>comp_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=n>control_file</span><span class=o>.</span><span class=n>stem</span>
+            <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>:</span>
+                <span class=n>comp_name</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=k>else</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span>
+
+            <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+            <span class=n>yaml_header</span><span class=p>,</span> <span class=n>control_md</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>control_file</span><span class=p>)</span>
+
+            <span class=c1># first get the header strings, including statement labels, for statement imp reqs</span>
+            <span class=n>imp_string</span> <span class=o>=</span> <span class=s1>&#39;## Implementation &#39;</span>
+            <span class=n>headers</span> <span class=o>=</span> <span class=n>control_md</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>2</span><span class=p>)</span>
+            <span class=c1># get e.g. ## Implementation a.  ## Implementation b. etc</span>
+            <span class=n>imp_header_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>header</span> <span class=k>for</span> <span class=n>header</span> <span class=ow>in</span> <span class=n>headers</span> <span class=k>if</span> <span class=n>header</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>imp_string</span><span class=p>)]</span>
+
+            <span class=c1># now get the (one) header for the main solution</span>
+            <span class=n>main_headers</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>control_md</span><span class=o>.</span><span class=n>get_all_headers_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MD_IMPLEMENTATION_QUESTION</span><span class=p>,</span> <span class=kc>False</span><span class=p>))</span>
+            <span class=c1># should be only one header, so warn if others found</span>
+            <span class=k>if</span> <span class=n>main_headers</span><span class=p>:</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>main_headers</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> has </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>main_headers</span><span class=p>)</span><span class=si>}</span><span class=s1> main header responses.  Will use first one only.&#39;</span>
+                    <span class=p>)</span>
+                <span class=n>main_header</span> <span class=o>=</span> <span class=n>main_headers</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+                <span class=n>node</span> <span class=o>=</span> <span class=n>control_md</span><span class=o>.</span><span class=n>get_all_nodes_for_keys</span><span class=p>([</span><span class=n>main_header</span><span class=p>],</span> <span class=kc>False</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+                <span class=c1># this node is top level so it will have empty label</span>
+                <span class=c1># it may have subnodes of Rules, Implementation Status, Implementaton Remarks</span>
+                <span class=n>ControlReader</span><span class=o>.</span><span class=n>_add_node_to_dict</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>node</span><span class=p>,</span> <span class=n>control_id</span><span class=p>,</span> <span class=p>[],</span> <span class=n>context</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>imp_header</span> <span class=ow>in</span> <span class=n>imp_header_list</span><span class=p>:</span>
+                <span class=n>label</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>_get_label_from_implementation_header</span><span class=p>(</span><span class=n>imp_header</span><span class=p>)</span>
+                <span class=n>node</span> <span class=o>=</span> <span class=n>control_md</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>imp_header</span><span class=p>)</span>
+                <span class=n>ControlReader</span><span class=o>.</span><span class=n>_add_node_to_dict</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>node</span><span class=p>,</span> <span class=n>control_id</span><span class=p>,</span> <span class=p>[],</span> <span class=n>context</span><span class=p>)</span>
+
+        <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error occurred reading </span><span class=si>{</span><span class=n>control_file</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>yaml_header</span><span class=p>,</span> <span class=n>comp_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_handle_empty_prose</span><span class=p>(</span><span class=n>prose</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>id_</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Regard prompt text or id_ as no prose and return blank string.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>prose</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_ADD_IMPLEMENTATION_PREFIX</span><span class=p>)</span> <span class=ow>or</span> <span class=n>prose</span> <span class=o>==</span> <span class=n>id_</span><span class=p>:</span>
+            <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>return</span> <span class=n>prose</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>read_implemented_requirement</span><span class=p>(</span><span class=n>control_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+                                     <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get the implementated requirement associated with given control and link to existing components or new ones.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            control_file: path of the control markdown file</span>
+<span class=sd>            context: context of the control usage</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Tuple: The control sort-id and the one implemented requirement for this control.</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            Each statement may have several responses, with each response in a by_component for a specific component.</span>
+<span class=sd>            statement_map keeps track of statements that may have several by_component responses.</span>
+<span class=sd>            This is only used during component assemble and only for updating one component.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>control_file</span><span class=o>.</span><span class=n>stem</span>
+        <span class=n>md_header</span><span class=p>,</span> <span class=n>md_comp_dict</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_control_info_from_md</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+        <span class=n>comp_name</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>component</span><span class=o>.</span><span class=n>title</span>
+
+        <span class=n>statement_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># create a new implemented requirement linked to the control id to hold the statements</span>
+        <span class=n>imp_req</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>)</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=n>control_id</span>
+
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>comp_dict</span> <span class=o>=</span> <span class=n>md_comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_info</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=c1># if no label it applies to the imp_req itself rather than a statement</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>label</span><span class=p>:</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>_handle_empty_prose</span><span class=p>(</span><span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+                <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>status</span><span class=p>)</span>
+                <span class=k>continue</span>
+            <span class=n>statement_id</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>create_statement_id</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>label</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>]:</span>
+                <span class=n>statement_part_id</span> <span class=o>=</span> <span class=n>statement_id</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>clean_label</span> <span class=o>=</span> <span class=n>label</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+                <span class=n>statement_part_id</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>strip_to_make_ncname</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>statement_id</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>clean_label</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>statement_part_id</span> <span class=ow>in</span> <span class=n>statement_map</span><span class=p>:</span>
+                <span class=n>statement</span> <span class=o>=</span> <span class=n>statement_map</span><span class=p>[</span><span class=n>statement_part_id</span><span class=p>]</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>statement</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>comp</span><span class=o>.</span><span class=n>Statement</span><span class=p>)</span>
+                <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=o>=</span> <span class=n>statement_part_id</span>
+                <span class=n>statement_map</span><span class=p>[</span><span class=n>statement_part_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>statement</span>
+            <span class=n>statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span>
+            <span class=n>statement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>comp_info</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>statement</span><span class=p>,</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>status</span><span class=p>)</span>
+
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>statement_map</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>param_dict_list</span> <span class=ow>in</span> <span class=n>md_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>,</span> <span class=p>{})</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>param_dict_list</span><span class=p>:</span>
+                <span class=n>values</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>,</span> <span class=p>[])</span>
+                <span class=n>comp_values</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>COMPONENT_VALUES</span><span class=p>,</span> <span class=p>[])</span>
+                <span class=n>values</span> <span class=o>=</span> <span class=n>comp_values</span> <span class=k>if</span> <span class=n>comp_values</span> <span class=k>else</span> <span class=n>values</span>
+                <span class=n>set_param</span> <span class=o>=</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>],</span> <span class=n>values</span><span class=o>=</span><span class=n>values</span><span class=p>)</span>
+                <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_param</span><span class=p>)</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>statement_map</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+        <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+
+        <span class=n>ControlReader</span><span class=o>.</span><span class=n>_insert_header_content</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>md_header</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+        <span class=n>sort_id</span> <span class=o>=</span> <span class=n>md_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>sort_id</span><span class=p>,</span> <span class=n>imp_req</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_props_list</span><span class=p>(</span><span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>label_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+                       <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the list of props in the yaml header of this control as separate lists with and without by_id.&quot;&quot;&quot;</span>
+        <span class=n>prop_list</span> <span class=o>=</span> <span class=n>yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>,</span> <span class=p>[])</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>props_by_id</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>prop_d</span> <span class=ow>in</span> <span class=n>prop_list</span><span class=p>:</span>
+            <span class=n>by_id</span> <span class=o>=</span> <span class=n>prop_d</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;smt-part&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>by_id</span> <span class=ow>and</span> <span class=n>control_id</span> <span class=ow>in</span> <span class=n>label_map</span><span class=p>:</span>
+                <span class=n>by_id</span> <span class=o>=</span> <span class=n>label_map</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>by_id</span><span class=p>,</span> <span class=n>by_id</span><span class=p>)</span>
+            <span class=n>prop</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>prop_d</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>],</span> <span class=n>value</span><span class=o>=</span><span class=n>prop_d</span><span class=p>[</span><span class=s1>&#39;value&#39;</span><span class=p>],</span> <span class=n>ns</span><span class=o>=</span><span class=n>prop_d</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;ns&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>))</span>
+            <span class=k>if</span> <span class=n>by_id</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>by_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>props_by_id</span><span class=p>:</span>
+                    <span class=n>props_by_id</span><span class=p>[</span><span class=n>by_id</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=n>props_by_id</span><span class=p>[</span><span class=n>by_id</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>props</span><span class=p>,</span> <span class=n>props_by_id</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>read_editable_content</span><span class=p>(</span>
+        <span class=n>control_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>required_sections_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>part_label_to_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+        <span class=n>cli_section_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+        <span class=n>write_mode</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parts for the markdown control corresponding to Editable Content - along with the set-parameter dict.&quot;&quot;&quot;</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>control_path</span><span class=o>.</span><span class=n>stem</span>
+
+        <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+        <span class=n>yaml_header</span><span class=p>,</span> <span class=n>control_tree</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_control_markdown</span><span class=p>(</span><span class=n>control_path</span><span class=p>,</span> <span class=n>cli_section_dict</span><span class=p>,</span> <span class=n>part_label_to_id_map</span><span class=p>)</span>  <span class=c1># noqa: E501</span>
+        <span class=c1># extract the sort_id if present in header</span>
+        <span class=n>sort_id</span> <span class=o>=</span> <span class=n>yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+
+        <span class=n>editable_node</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>header</span> <span class=ow>in</span> <span class=nb>list</span><span class=p>(</span><span class=n>control_tree</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>1</span><span class=p>)):</span>
+            <span class=k>if</span> <span class=n>header</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;# Editable&#39;</span><span class=p>):</span>
+                <span class=n>editable_node</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>header</span><span class=p>)</span>
+                <span class=k>break</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>editable_node</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>sort_id</span><span class=p>,</span> <span class=p>[],</span> <span class=p>{}</span>
+
+        <span class=n>editable_parts</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_editable_parts_and_subparts</span><span class=p>()</span>
+        <span class=n>by_id_parts</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_by_id_parts</span><span class=p>()</span>
+        <span class=n>found_sections</span> <span class=o>=</span> <span class=p>[</span><span class=n>p</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>p</span> <span class=ow>in</span> <span class=n>editable_parts</span><span class=p>]</span>
+
+        <span class=c1># Validate that all required sections have a prose</span>
+        <span class=k>for</span> <span class=n>editable_part</span> <span class=ow>in</span> <span class=n>editable_parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>write_mode</span> <span class=ow>and</span> <span class=n>editable_part</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>required_sections_list</span> <span class=ow>and</span> <span class=n>editable_part</span><span class=o>.</span><span class=n>prose</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> is missing prose for required section </span><span class=si>{</span><span class=n>editable_part</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># Validate that all required sections are present</span>
+        <span class=n>missing_sections</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>required_sections_list</span><span class=p>)</span> <span class=o>-</span> <span class=nb>set</span><span class=p>(</span><span class=n>found_sections</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>missing_sections</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> is missing required sections </span><span class=si>{</span><span class=n>missing_sections</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># get set_params from the header and add to parm_dict</span>
+        <span class=n>header_params</span> <span class=o>=</span> <span class=n>yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=k>if</span> <span class=n>header_params</span><span class=p>:</span>
+            <span class=n>param_dict</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>header_params</span><span class=p>)</span>
+
+        <span class=n>props</span><span class=p>,</span> <span class=n>props_by_id</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>get_props_list</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>part_label_to_id_map</span><span class=p>,</span> <span class=n>yaml_header</span><span class=p>)</span>
+
+        <span class=c1># When adding props without by_id it can either be starting or ending and we default to ending</span>
+        <span class=c1># This is the default behavior as described for implicit binding in</span>
+        <span class=c1># https://pages.nist.gov/OSCAL/concepts/processing/profile-resolution/</span>
+        <span class=c1># When adding props to a part using by_id, it is the same situation because it cannot be before or after since</span>
+        <span class=c1># props are not in the same list as parts</span>
+
+        <span class=n>adds</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=c1># add the parts and props at control level</span>
+        <span class=k>if</span> <span class=n>editable_parts</span> <span class=ow>or</span> <span class=n>props</span><span class=p>:</span>
+            <span class=n>adds</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                <span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>(</span>
+                    <span class=n>parts</span><span class=o>=</span><span class=n>none_if_empty</span><span class=p>(</span><span class=n>editable_parts</span><span class=p>),</span>
+                    <span class=n>props</span><span class=o>=</span><span class=n>none_if_empty</span><span class=p>(</span><span class=n>props</span><span class=p>),</span>
+                    <span class=n>position</span><span class=o>=</span><span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>ending</span><span class=o>.</span><span class=n>value</span>
+                <span class=p>)</span>
+            <span class=p>)</span>
+
+        <span class=c1># add the parts and props at the part level, by-id</span>
+        <span class=n>by_ids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>by_id_parts</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>props_by_id</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+        <span class=k>for</span> <span class=n>by_id</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>by_ids</span><span class=p>):</span>
+            <span class=n>parts</span> <span class=o>=</span> <span class=n>by_id_parts</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>by_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=n>props</span> <span class=o>=</span> <span class=n>props_by_id</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>by_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=n>adds</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>(</span><span class=n>parts</span><span class=o>=</span><span class=n>parts</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span> <span class=n>position</span><span class=o>=</span><span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>ending</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=n>by_id</span><span class=o>=</span><span class=n>by_id</span><span class=p>))</span>
+
+        <span class=n>new_alters</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>adds</span><span class=p>:</span>
+            <span class=n>new_alters</span> <span class=o>=</span> <span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>(</span><span class=n>control_id</span><span class=o>=</span><span class=n>control_id</span><span class=p>,</span> <span class=n>adds</span><span class=o>=</span><span class=n>adds</span><span class=p>)]</span>
+        <span class=k>return</span> <span class=n>sort_id</span><span class=p>,</span> <span class=n>new_alters</span><span class=p>,</span> <span class=n>param_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_update_display_prop_namespace</span><span class=p>(</span><span class=n>item</span><span class=p>:</span> <span class=n>TypeWithProps</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set namespace for special property display_name.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>:</span>
+                <span class=n>prop</span><span class=o>.</span><span class=n>ns</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GENERIC_NS</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>read_control</span><span class=p>(</span><span class=n>control_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read the control and group title from the markdown file.&quot;&quot;&quot;</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span>
+        <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+        <span class=n>yaml_header</span><span class=p>,</span> <span class=n>control_tree</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_control_markdown</span><span class=p>(</span><span class=n>control_path</span><span class=p>)</span>
+        <span class=n>control_titles</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>control_tree</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>1</span><span class=p>))</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control_titles</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control markdown: </span><span class=si>{</span><span class=n>control_path</span><span class=si>}</span><span class=s1> contains no control title.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control_titles</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control markdown: </span><span class=si>{</span><span class=n>control_path</span><span class=si>}</span><span class=s1> contains multiple control titles </span><span class=si>{</span><span class=n>control_titles</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>subnodes</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>control_id</span>
+        <span class=n>group_title</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>subnodes</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>control_group</span>
+        <span class=n>control</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>subnodes</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>control_title</span>
+
+        <span class=n>control_statement</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_control_statement</span><span class=p>()</span>
+        <span class=n>statement_part</span> <span class=o>=</span> <span class=n>control_statement</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span>
+
+        <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=p>[</span><span class=n>statement_part</span><span class=p>]</span> <span class=k>if</span> <span class=n>statement_part</span> <span class=k>else</span> <span class=kc>None</span>
+        <span class=n>control_objective</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_control_objective</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>control_objective</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>objective_part</span> <span class=o>=</span> <span class=n>control_objective</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span>
+            <span class=k>if</span> <span class=n>objective_part</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                    <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>objective_part</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=p>[</span><span class=n>objective_part</span><span class=p>]</span>
+
+        <span class=n>control_guidance</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_control_guidance</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>control_guidance</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>guidance_part</span> <span class=o>=</span> <span class=n>control_guidance</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span>
+            <span class=k>if</span> <span class=n>guidance_part</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                    <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>guidance_part</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=p>[</span><span class=n>guidance_part</span><span class=p>]</span>
+
+        <span class=n>all_other_parts</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>section_node</span> <span class=ow>in</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_other_control_parts</span><span class=p>():</span>
+            <span class=n>parts</span> <span class=o>=</span> <span class=n>section_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span>
+            <span class=n>all_other_parts</span><span class=o>.</span><span class=n>extend</span><span class=p>([</span><span class=n>parts</span><span class=p>])</span>
+        <span class=k>if</span> <span class=n>all_other_parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>all_other_parts</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>all_other_parts</span>
+
+        <span class=k>if</span> <span class=n>set_parameters_flag</span><span class=p>:</span>
+            <span class=n>params</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>,</span> <span class=p>[])</span>
+            <span class=k>if</span> <span class=n>params</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>id_</span><span class=p>,</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>params</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;id&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>id_</span>
+                    <span class=n>param</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>dict_to_parameter</span><span class=p>(</span><span class=n>param_dict</span><span class=p>)</span>
+                    <span class=c1># if display_name is in list of properties, set its namespace</span>
+                    <span class=n>ControlReader</span><span class=o>.</span><span class=n>_update_display_prop_namespace</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+                    <span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+        <span class=n>sort_id</span> <span class=o>=</span> <span class=n>deep_get</span><span class=p>(</span><span class=n>yaml_header</span><span class=p>,</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>],</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>sort_id</span><span class=p>:</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>props</span> <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>props</span> <span class=k>else</span> <span class=p>[]</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>sort_id</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>control</span><span class=p>,</span> <span class=n>group_title</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.control_reader.ControlReader-functions>Functions<a href=#trestle.core.control_reader.ControlReader-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_reader.ControlReader.get_props_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_props_list</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>label_map</span><span class=p>,</span> <span class=n>yaml_header</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_reader.ControlReader.get_props_list class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the list of props in the yaml header of this control as separate lists with and without by_id.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_props_list</span><span class=p>(</span><span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>label_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+                   <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the list of props in the yaml header of this control as separate lists with and without by_id.&quot;&quot;&quot;</span>
+    <span class=n>prop_list</span> <span class=o>=</span> <span class=n>yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>,</span> <span class=p>[])</span>
+    <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>props_by_id</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>prop_d</span> <span class=ow>in</span> <span class=n>prop_list</span><span class=p>:</span>
+        <span class=n>by_id</span> <span class=o>=</span> <span class=n>prop_d</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;smt-part&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>by_id</span> <span class=ow>and</span> <span class=n>control_id</span> <span class=ow>in</span> <span class=n>label_map</span><span class=p>:</span>
+            <span class=n>by_id</span> <span class=o>=</span> <span class=n>label_map</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>by_id</span><span class=p>,</span> <span class=n>by_id</span><span class=p>)</span>
+        <span class=n>prop</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>prop_d</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>],</span> <span class=n>value</span><span class=o>=</span><span class=n>prop_d</span><span class=p>[</span><span class=s1>&#39;value&#39;</span><span class=p>],</span> <span class=n>ns</span><span class=o>=</span><span class=n>prop_d</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;ns&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>by_id</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>by_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>props_by_id</span><span class=p>:</span>
+                <span class=n>props_by_id</span><span class=p>[</span><span class=n>by_id</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>props_by_id</span><span class=p>[</span><span class=n>by_id</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>props</span><span class=p>,</span> <span class=n>props_by_id</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_reader.ControlReader.read_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_control</span><span class=p>(</span><span class=n>control_path</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_reader.ControlReader.read_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read the control and group title from the markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>read_control</span><span class=p>(</span><span class=n>control_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>set_parameters_flag</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Read the control and group title from the markdown file.&quot;&quot;&quot;</span>
+    <span class=n>control</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span>
+    <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+    <span class=n>yaml_header</span><span class=p>,</span> <span class=n>control_tree</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_control_markdown</span><span class=p>(</span><span class=n>control_path</span><span class=p>)</span>
+    <span class=n>control_titles</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>control_tree</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>1</span><span class=p>))</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control_titles</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control markdown: </span><span class=si>{</span><span class=n>control_path</span><span class=si>}</span><span class=s1> contains no control title.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control_titles</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control markdown: </span><span class=si>{</span><span class=n>control_path</span><span class=si>}</span><span class=s1> contains multiple control titles </span><span class=si>{</span><span class=n>control_titles</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>subnodes</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>control_id</span>
+    <span class=n>group_title</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>subnodes</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>control_group</span>
+    <span class=n>control</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>subnodes</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>control_title</span>
+
+    <span class=n>control_statement</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_control_statement</span><span class=p>()</span>
+    <span class=n>statement_part</span> <span class=o>=</span> <span class=n>control_statement</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span>
+
+    <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=p>[</span><span class=n>statement_part</span><span class=p>]</span> <span class=k>if</span> <span class=n>statement_part</span> <span class=k>else</span> <span class=kc>None</span>
+    <span class=n>control_objective</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_control_objective</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>control_objective</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>objective_part</span> <span class=o>=</span> <span class=n>control_objective</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span>
+        <span class=k>if</span> <span class=n>objective_part</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>objective_part</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=p>[</span><span class=n>objective_part</span><span class=p>]</span>
+
+    <span class=n>control_guidance</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_control_guidance</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>control_guidance</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>guidance_part</span> <span class=o>=</span> <span class=n>control_guidance</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span>
+        <span class=k>if</span> <span class=n>guidance_part</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>guidance_part</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=p>[</span><span class=n>guidance_part</span><span class=p>]</span>
+
+    <span class=n>all_other_parts</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>section_node</span> <span class=ow>in</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_other_control_parts</span><span class=p>():</span>
+        <span class=n>parts</span> <span class=o>=</span> <span class=n>section_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span>
+        <span class=n>all_other_parts</span><span class=o>.</span><span class=n>extend</span><span class=p>([</span><span class=n>parts</span><span class=p>])</span>
+    <span class=k>if</span> <span class=n>all_other_parts</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>all_other_parts</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>all_other_parts</span>
+
+    <span class=k>if</span> <span class=n>set_parameters_flag</span><span class=p>:</span>
+        <span class=n>params</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>,</span> <span class=p>[])</span>
+        <span class=k>if</span> <span class=n>params</span><span class=p>:</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>id_</span><span class=p>,</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>params</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;id&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>id_</span>
+                <span class=n>param</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>dict_to_parameter</span><span class=p>(</span><span class=n>param_dict</span><span class=p>)</span>
+                <span class=c1># if display_name is in list of properties, set its namespace</span>
+                <span class=n>ControlReader</span><span class=o>.</span><span class=n>_update_display_prop_namespace</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>param</span><span class=p>)</span>
+    <span class=n>sort_id</span> <span class=o>=</span> <span class=n>deep_get</span><span class=p>(</span><span class=n>yaml_header</span><span class=p>,</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>],</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>sort_id</span><span class=p>:</span>
+        <span class=n>control</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>props</span> <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>props</span> <span class=k>else</span> <span class=p>[]</span>
+        <span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>sort_id</span><span class=p>))</span>
+    <span class=k>return</span> <span class=n>control</span><span class=p>,</span> <span class=n>group_title</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_reader.ControlReader.read_control_info_from_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_control_info_from_md</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_reader.ControlReader.read_control_info_from_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find all labels and associated implementation prose in the markdown for this control.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>control_file</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>path to the control markdown file</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>context</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_context.ControlContext href=../control_context/#trestle.core.control_context.ControlContext>ControlContext</a></code> </td> <td> <div class=doc-md-description> <p>context of the control usage</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Dict>Dict</span>[str, <span title=typing.List>List</span>[str]]</code> </td> <td> <div class=doc-md-description> <p>The yaml header as dict in second part of tuple.</p> </div> </td> </tr> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_interface.CompDict href=../control_interface/#trestle.core.control_interface.CompDict>CompDict</a></code> </td> <td> <div class=doc-md-description> <p>Adds to the passed in comp_dict.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/control_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>read_control_info_from_md</span><span class=p>(</span><span class=n>control_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+                              <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]],</span> <span class=n>CompDict</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Find all labels and associated implementation prose in the markdown for this control.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        control_file: path to the control markdown file</span>
+<span class=sd>        context: context of the control usage</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The yaml header as dict in second part of tuple.</span>
+<span class=sd>        Adds to the passed in comp_dict.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>yaml_header</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>comp_dict</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>control_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=n>yaml_header</span><span class=p>,</span> <span class=n>comp_dict</span>
+    <span class=c1># if the file exists, load the contents but do not use prose from comp_dict</span>
+    <span class=c1># for non ssp or component mode just use empty string for comp</span>
+    <span class=n>comp_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>control_file</span><span class=o>.</span><span class=n>stem</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>:</span>
+            <span class=n>comp_name</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_name</span> <span class=k>else</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span>
+
+        <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+        <span class=n>yaml_header</span><span class=p>,</span> <span class=n>control_md</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>control_file</span><span class=p>)</span>
+
+        <span class=c1># first get the header strings, including statement labels, for statement imp reqs</span>
+        <span class=n>imp_string</span> <span class=o>=</span> <span class=s1>&#39;## Implementation &#39;</span>
+        <span class=n>headers</span> <span class=o>=</span> <span class=n>control_md</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>2</span><span class=p>)</span>
+        <span class=c1># get e.g. ## Implementation a.  ## Implementation b. etc</span>
+        <span class=n>imp_header_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>header</span> <span class=k>for</span> <span class=n>header</span> <span class=ow>in</span> <span class=n>headers</span> <span class=k>if</span> <span class=n>header</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>imp_string</span><span class=p>)]</span>
+
+        <span class=c1># now get the (one) header for the main solution</span>
+        <span class=n>main_headers</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>control_md</span><span class=o>.</span><span class=n>get_all_headers_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MD_IMPLEMENTATION_QUESTION</span><span class=p>,</span> <span class=kc>False</span><span class=p>))</span>
+        <span class=c1># should be only one header, so warn if others found</span>
+        <span class=k>if</span> <span class=n>main_headers</span><span class=p>:</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>main_headers</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> has </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>main_headers</span><span class=p>)</span><span class=si>}</span><span class=s1> main header responses.  Will use first one only.&#39;</span>
+                <span class=p>)</span>
+            <span class=n>main_header</span> <span class=o>=</span> <span class=n>main_headers</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>node</span> <span class=o>=</span> <span class=n>control_md</span><span class=o>.</span><span class=n>get_all_nodes_for_keys</span><span class=p>([</span><span class=n>main_header</span><span class=p>],</span> <span class=kc>False</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=c1># this node is top level so it will have empty label</span>
+            <span class=c1># it may have subnodes of Rules, Implementation Status, Implementaton Remarks</span>
+            <span class=n>ControlReader</span><span class=o>.</span><span class=n>_add_node_to_dict</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>node</span><span class=p>,</span> <span class=n>control_id</span><span class=p>,</span> <span class=p>[],</span> <span class=n>context</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>imp_header</span> <span class=ow>in</span> <span class=n>imp_header_list</span><span class=p>:</span>
+            <span class=n>label</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>_get_label_from_implementation_header</span><span class=p>(</span><span class=n>imp_header</span><span class=p>)</span>
+            <span class=n>node</span> <span class=o>=</span> <span class=n>control_md</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>imp_header</span><span class=p>)</span>
+            <span class=n>ControlReader</span><span class=o>.</span><span class=n>_add_node_to_dict</span><span class=p>(</span><span class=n>comp_name</span><span class=p>,</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>node</span><span class=p>,</span> <span class=n>control_id</span><span class=p>,</span> <span class=p>[],</span> <span class=n>context</span><span class=p>)</span>
+
+    <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error occurred reading </span><span class=si>{</span><span class=n>control_file</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>yaml_header</span><span class=p>,</span> <span class=n>comp_dict</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_reader.ControlReader.read_editable_content class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_editable_content</span><span class=p>(</span><span class=n>control_path</span><span class=p>,</span> <span class=n>required_sections_list</span><span class=p>,</span> <span class=n>part_label_to_id_map</span><span class=p>,</span> <span class=n>cli_section_dict</span><span class=p>,</span> <span class=n>write_mode</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_reader.ControlReader.read_editable_content class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get parts for the markdown control corresponding to Editable Content - along with the set-parameter dict.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>read_editable_content</span><span class=p>(</span>
+    <span class=n>control_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>required_sections_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>part_label_to_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]],</span>
+    <span class=n>cli_section_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+    <span class=n>write_mode</span><span class=p>:</span> <span class=nb>bool</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get parts for the markdown control corresponding to Editable Content - along with the set-parameter dict.&quot;&quot;&quot;</span>
+    <span class=n>control_id</span> <span class=o>=</span> <span class=n>control_path</span><span class=o>.</span><span class=n>stem</span>
+
+    <span class=n>md_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+    <span class=n>yaml_header</span><span class=p>,</span> <span class=n>control_tree</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_control_markdown</span><span class=p>(</span><span class=n>control_path</span><span class=p>,</span> <span class=n>cli_section_dict</span><span class=p>,</span> <span class=n>part_label_to_id_map</span><span class=p>)</span>  <span class=c1># noqa: E501</span>
+    <span class=c1># extract the sort_id if present in header</span>
+    <span class=n>sort_id</span> <span class=o>=</span> <span class=n>yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+
+    <span class=n>editable_node</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>for</span> <span class=n>header</span> <span class=ow>in</span> <span class=nb>list</span><span class=p>(</span><span class=n>control_tree</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>1</span><span class=p>)):</span>
+        <span class=k>if</span> <span class=n>header</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;# Editable&#39;</span><span class=p>):</span>
+            <span class=n>editable_node</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>header</span><span class=p>)</span>
+            <span class=k>break</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>editable_node</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>sort_id</span><span class=p>,</span> <span class=p>[],</span> <span class=p>{}</span>
+
+    <span class=n>editable_parts</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_editable_parts_and_subparts</span><span class=p>()</span>
+    <span class=n>by_id_parts</span> <span class=o>=</span> <span class=n>control_tree</span><span class=o>.</span><span class=n>get_by_id_parts</span><span class=p>()</span>
+    <span class=n>found_sections</span> <span class=o>=</span> <span class=p>[</span><span class=n>p</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>p</span> <span class=ow>in</span> <span class=n>editable_parts</span><span class=p>]</span>
+
+    <span class=c1># Validate that all required sections have a prose</span>
+    <span class=k>for</span> <span class=n>editable_part</span> <span class=ow>in</span> <span class=n>editable_parts</span><span class=p>:</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>write_mode</span> <span class=ow>and</span> <span class=n>editable_part</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>required_sections_list</span> <span class=ow>and</span> <span class=n>editable_part</span><span class=o>.</span><span class=n>prose</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> is missing prose for required section </span><span class=si>{</span><span class=n>editable_part</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=c1># Validate that all required sections are present</span>
+    <span class=n>missing_sections</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>required_sections_list</span><span class=p>)</span> <span class=o>-</span> <span class=nb>set</span><span class=p>(</span><span class=n>found_sections</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>missing_sections</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> is missing required sections </span><span class=si>{</span><span class=n>missing_sections</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>param_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=c1># get set_params from the header and add to parm_dict</span>
+    <span class=n>header_params</span> <span class=o>=</span> <span class=n>yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+    <span class=k>if</span> <span class=n>header_params</span><span class=p>:</span>
+        <span class=n>param_dict</span><span class=o>.</span><span class=n>update</span><span class=p>(</span><span class=n>header_params</span><span class=p>)</span>
+
+    <span class=n>props</span><span class=p>,</span> <span class=n>props_by_id</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>get_props_list</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>part_label_to_id_map</span><span class=p>,</span> <span class=n>yaml_header</span><span class=p>)</span>
+
+    <span class=c1># When adding props without by_id it can either be starting or ending and we default to ending</span>
+    <span class=c1># This is the default behavior as described for implicit binding in</span>
+    <span class=c1># https://pages.nist.gov/OSCAL/concepts/processing/profile-resolution/</span>
+    <span class=c1># When adding props to a part using by_id, it is the same situation because it cannot be before or after since</span>
+    <span class=c1># props are not in the same list as parts</span>
+
+    <span class=n>adds</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=c1># add the parts and props at control level</span>
+    <span class=k>if</span> <span class=n>editable_parts</span> <span class=ow>or</span> <span class=n>props</span><span class=p>:</span>
+        <span class=n>adds</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+            <span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>(</span>
+                <span class=n>parts</span><span class=o>=</span><span class=n>none_if_empty</span><span class=p>(</span><span class=n>editable_parts</span><span class=p>),</span>
+                <span class=n>props</span><span class=o>=</span><span class=n>none_if_empty</span><span class=p>(</span><span class=n>props</span><span class=p>),</span>
+                <span class=n>position</span><span class=o>=</span><span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>ending</span><span class=o>.</span><span class=n>value</span>
+            <span class=p>)</span>
+        <span class=p>)</span>
+
+    <span class=c1># add the parts and props at the part level, by-id</span>
+    <span class=n>by_ids</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>by_id_parts</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>props_by_id</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+    <span class=k>for</span> <span class=n>by_id</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>by_ids</span><span class=p>):</span>
+        <span class=n>parts</span> <span class=o>=</span> <span class=n>by_id_parts</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>by_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=n>props_by_id</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>by_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>adds</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>(</span><span class=n>parts</span><span class=o>=</span><span class=n>parts</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span> <span class=n>position</span><span class=o>=</span><span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>ending</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=n>by_id</span><span class=o>=</span><span class=n>by_id</span><span class=p>))</span>
+
+    <span class=n>new_alters</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=n>adds</span><span class=p>:</span>
+        <span class=n>new_alters</span> <span class=o>=</span> <span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>(</span><span class=n>control_id</span><span class=o>=</span><span class=n>control_id</span><span class=p>,</span> <span class=n>adds</span><span class=o>=</span><span class=n>adds</span><span class=p>)]</span>
+    <span class=k>return</span> <span class=n>sort_id</span><span class=p>,</span> <span class=n>new_alters</span><span class=p>,</span> <span class=n>param_dict</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_reader.ControlReader.read_implemented_requirement class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_implemented_requirement</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_reader.ControlReader.read_implemented_requirement class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the implementated requirement associated with given control and link to existing components or new ones.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>control_file</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>path of the control markdown file</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>context</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_context.ControlContext href=../control_context/#trestle.core.control_context.ControlContext>ControlContext</a></code> </td> <td> <div class=doc-md-description> <p>context of the control usage</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code>Tuple</code></td> <td> <code><span title=typing.Tuple>Tuple</span>[str, <a class="autorefs autorefs-internal" title=trestle.oscal.component.ImplementedRequirement href=../../oscal/component/#trestle.oscal.component.ImplementedRequirement>ImplementedRequirement</a>]</code> </td> <td> <div class=doc-md-description> <p>The control sort-id and the one implemented requirement for this control.</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>Each statement may have several responses, with each response in a by_component for a specific component. statement_map keeps track of statements that may have several by_component responses. This is only used during component assemble and only for updating one component.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/control_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>read_implemented_requirement</span><span class=p>(</span><span class=n>control_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+                                 <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get the implementated requirement associated with given control and link to existing components or new ones.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        control_file: path of the control markdown file</span>
+<span class=sd>        context: context of the control usage</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Tuple: The control sort-id and the one implemented requirement for this control.</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        Each statement may have several responses, with each response in a by_component for a specific component.</span>
+<span class=sd>        statement_map keeps track of statements that may have several by_component responses.</span>
+<span class=sd>        This is only used during component assemble and only for updating one component.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>control_id</span> <span class=o>=</span> <span class=n>control_file</span><span class=o>.</span><span class=n>stem</span>
+    <span class=n>md_header</span><span class=p>,</span> <span class=n>md_comp_dict</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_control_info_from_md</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+    <span class=n>comp_name</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>component</span><span class=o>.</span><span class=n>title</span>
+
+    <span class=n>statement_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>comp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=c1># create a new implemented requirement linked to the control id to hold the statements</span>
+    <span class=n>imp_req</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>)</span>
+    <span class=n>imp_req</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=n>control_id</span>
+
+    <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>comp_dict</span> <span class=o>=</span> <span class=n>md_comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span>
+    <span class=k>for</span> <span class=n>label</span><span class=p>,</span> <span class=n>comp_info</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+        <span class=c1># if no label it applies to the imp_req itself rather than a statement</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>label</span><span class=p>:</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>_handle_empty_prose</span><span class=p>(</span><span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>status</span><span class=p>)</span>
+            <span class=k>continue</span>
+        <span class=n>statement_id</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>create_statement_id</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>label</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>]:</span>
+            <span class=n>statement_part_id</span> <span class=o>=</span> <span class=n>statement_id</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>clean_label</span> <span class=o>=</span> <span class=n>label</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+            <span class=n>statement_part_id</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>strip_to_make_ncname</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>statement_id</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>clean_label</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>statement_part_id</span> <span class=ow>in</span> <span class=n>statement_map</span><span class=p>:</span>
+            <span class=n>statement</span> <span class=o>=</span> <span class=n>statement_map</span><span class=p>[</span><span class=n>statement_part_id</span><span class=p>]</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>statement</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>comp</span><span class=o>.</span><span class=n>Statement</span><span class=p>)</span>
+            <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=o>=</span> <span class=n>statement_part_id</span>
+            <span class=n>statement_map</span><span class=p>[</span><span class=n>statement_part_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>statement</span>
+        <span class=n>statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span>
+        <span class=n>statement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>clean_props</span><span class=p>(</span><span class=n>comp_info</span><span class=o>.</span><span class=n>props</span><span class=p>))</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>statement</span><span class=p>,</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>status</span><span class=p>)</span>
+
+    <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>statement_map</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+    <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>param_dict_list</span> <span class=ow>in</span> <span class=n>md_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>,</span> <span class=p>{})</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+        <span class=k>for</span> <span class=n>param_dict</span> <span class=ow>in</span> <span class=n>param_dict_list</span><span class=p>:</span>
+            <span class=n>values</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>VALUES</span><span class=p>,</span> <span class=p>[])</span>
+            <span class=n>comp_values</span> <span class=o>=</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>COMPONENT_VALUES</span><span class=p>,</span> <span class=p>[])</span>
+            <span class=n>values</span> <span class=o>=</span> <span class=n>comp_values</span> <span class=k>if</span> <span class=n>comp_values</span> <span class=k>else</span> <span class=n>values</span>
+            <span class=n>set_param</span> <span class=o>=</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=n>param_dict</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>],</span> <span class=n>values</span><span class=o>=</span><span class=n>values</span><span class=p>)</span>
+            <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_param</span><span class=p>)</span>
+    <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>statement_map</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+    <span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+
+    <span class=n>ControlReader</span><span class=o>.</span><span class=n>_insert_header_content</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>md_header</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+    <span class=n>sort_id</span> <span class=o>=</span> <span class=n>md_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>sort_id</span><span class=p>,</span> <span class=n>imp_req</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_reader.ControlReader.simplify_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>simplify_name</span><span class=p>(</span><span class=n>name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.control_reader.ControlReader.simplify_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Simplify the name to ignore variations in case, space, hyphen, underscore, slash.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>simplify_name</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Simplify the name to ignore variations in case, space, hyphen, underscore, slash.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;_&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;/&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.control_reader-functions>Functions<a href=#trestle.core.control_reader-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/control_writer/index.html b/latest/reference/API/trestle/core/control_writer/index.html
new file mode 100644
index 000000000..de1667283
--- /dev/null
+++ b/latest/reference/API/trestle/core/control_writer/index.html
@@ -0,0 +1,1348 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.control_writer module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_writer/ rel=canonical><link href=../control_reader/ rel=prev><link href=../docs_control_writer/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.control_writer - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.control_writer - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.control_writer module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/control_writer.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_writer/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.control_writer - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.control_writer module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/control_writer.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.control_writer class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.control_writer </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.control_writer </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.control_writer </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.control_writer class=md-nav__link> <span class=md-ellipsis> control_writer </span> </a> <nav class=md-nav aria-label=control_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer.ControlWriter class=md-nav__link> <span class=md-ellipsis> ControlWriter </span> </a> <nav class=md-nav aria-label=ControlWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer.ControlWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer.ControlWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_writer.ControlWriter.write_control_for_editing class=md-nav__link> <span class=md-ellipsis> write_control_for_editing </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.control_writer class=md-nav__link> <span class=md-ellipsis> control_writer </span> </a> <nav class=md-nav aria-label=control_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer.ControlWriter class=md-nav__link> <span class=md-ellipsis> ControlWriter </span> </a> <nav class=md-nav aria-label=ControlWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer.ControlWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.control_writer.ControlWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.control_writer.ControlWriter.write_control_for_editing class=md-nav__link> <span class=md-ellipsis> write_control_for_editing </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.control_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.control_writer</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.control_writer class="doc doc-heading"> <code>trestle.core.control_writer</code> <a href=#trestle.core.control_writer class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Handle writing of controls to markdown.</p> <div class="doc doc-children"> <h3 id=trestle.core.control_writer-attributes>Attributes<a href=#trestle.core.control_writer-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.control_writer.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.control_writer.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.control_writer-classes>Classes<a href=#trestle.core.control_writer-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.control_writer.ControlWriter class="doc doc-heading"> <code>ControlWriter</code> <a href=#trestle.core.control_writer.ControlWriter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class to write controls as markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlWriter</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to write controls as markdown.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>MDWriter</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_add_part_and_its_items</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>item_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;For a given control add its one statement and its items to the md file after replacing params.&quot;&quot;&quot;</span>
+        <span class=n>items</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>name</span><span class=p>:</span>
+                    <span class=c1># If the part has prose write it as a raw line and not list element</span>
+                    <span class=n>skip_id</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span>
+                    <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>)</span>
+                    <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_part</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>item_type</span><span class=p>,</span> <span class=n>skip_id</span><span class=p>))</span>
+            <span class=c1># unwrap the list if it is many levels deep</span>
+            <span class=k>while</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>items</span><span class=p>,</span> <span class=nb>str</span><span class=p>)</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=n>items</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=n>items</span> <span class=o>=</span> <span class=n>items</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_list</span><span class=p>(</span><span class=n>items</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_yaml_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>yaml_header</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>add_yaml_header</span><span class=p>(</span><span class=n>yaml_header</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_control_statement</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>group_title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>print_group_title</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add the control statement and items to the md file.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span>
+        <span class=n>group_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>control_title</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>title</span>
+
+        <span class=k>if</span> <span class=n>print_group_title</span><span class=p>:</span>
+            <span class=n>group_name</span> <span class=o>=</span> <span class=sa>r</span><span class=s1>&#39; \[&#39;</span> <span class=o>+</span> <span class=n>group_title</span> <span class=o>+</span> <span class=sa>r</span><span class=s1>&#39;\]&#39;</span>
+
+        <span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> -</span><span class=si>{</span><span class=n>group_name</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>control_title</span><span class=si>}</span><span class=s1>&#39;</span>
+
+        <span class=n>header_title</span> <span class=o>=</span> <span class=s1>&#39;Control Statement&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>header_title</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_part_and_its_items</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_control_objective</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>OBJECTIVE_PART</span> <span class=ow>or</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ASSESMENT_OBJECTIVE_PART</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+                    <span class=n>heading_title</span> <span class=o>=</span> <span class=s1>&#39;Control Objective&#39;</span>
+                    <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ASSESMENT_OBJECTIVE_PART</span><span class=p>:</span>
+                        <span class=n>heading_title</span> <span class=o>=</span> <span class=s1>&#39;Control Assessment Objective&#39;</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>heading_title</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_add_part_and_its_items</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+                    <span class=k>return</span>
+
+    <span class=k>def</span> <span class=nf>_add_sections</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>allowed_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add the extra control sections after the main ones.&quot;&quot;&quot;</span>
+        <span class=n>skip_section_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>OBJECTIVE_PART</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>ASSESMENT_OBJECTIVE_PART</span><span class=p>]</span>
+        <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>prose</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_section</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>skip_section_list</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>name</span><span class=p>:</span>
+                <span class=k>return</span>
+            <span class=k>if</span> <span class=n>allowed_sections</span> <span class=ow>and</span> <span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>allowed_sections</span><span class=p>:</span>
+                <span class=n>skip_section_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>prose</span><span class=p>:</span>
+                <span class=c1># section title will be from the section_dict, the part title, or the part name in that order</span>
+                <span class=c1># this way the user-provided section title can override the part title</span>
+                <span class=n>section_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>title</span><span class=p>)</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=k>else</span> <span class=n>title</span>
+                <span class=n>section_title</span> <span class=o>=</span> <span class=n>section_title</span> <span class=k>if</span> <span class=n>section_title</span> <span class=k>else</span> <span class=n>name</span>
+                <span class=n>skip_section_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>section_title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>prose</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_insert_status</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>status</span><span class=p>:</span> <span class=n>ImplementationStatus</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=n>level</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_STATUS_HEADER</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>status</span><span class=o>.</span><span class=n>state</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># this used to output remarks also</span>
+
+    <span class=k>def</span> <span class=nf>_insert_rules</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>rules</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=n>level</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Rules:&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=mi>0</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_list</span><span class=p>(</span><span class=n>rules</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_insert_comp_info</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>part_label</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ComponentImpInfo</span><span class=p>],</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Insert prose and status from the component info.&quot;&quot;&quot;</span>
+        <span class=n>level</span> <span class=o>=</span> <span class=mi>3</span> <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span> <span class=k>else</span> <span class=mi>4</span>
+        <span class=k>if</span> <span class=n>part_label</span> <span class=ow>in</span> <span class=n>comp_info</span><span class=p>:</span>
+            <span class=n>info</span> <span class=o>=</span> <span class=n>comp_info</span><span class=p>[</span><span class=n>part_label</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=ow>in</span> <span class=p>[</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>,</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>]</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_include_component</span><span class=p>(</span><span class=n>info</span><span class=p>):</span>
+                <span class=k>return</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>info</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>info</span><span class=o>.</span><span class=n>prose</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>part_label</span><span class=si>}</span><span class=s1> --&gt;&#39;</span><span class=p>)</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>_insert_rules</span><span class=p>(</span><span class=n>info</span><span class=o>.</span><span class=n>rules</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_insert_status</span><span class=p>(</span><span class=n>info</span><span class=o>.</span><span class=n>status</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_insert_status</span><span class=p>(</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_PLANNED</span><span class=p>),</span> <span class=n>level</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_process_main_component</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>part_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>part_label</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>:</span> <span class=n>CompDict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Handle prompts for This System component.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=mi>3</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>part_id</span><span class=si>}</span><span class=s1> --&gt;&#39;</span>
+        <span class=n>status</span> <span class=o>=</span> <span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_PLANNED</span><span class=p>)</span>
+        <span class=n>sys_comp_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ComponentImpInfo</span><span class=p>]</span> <span class=o>=</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=k>if</span> <span class=n>sys_comp_dict</span> <span class=ow>and</span> <span class=n>part_label</span> <span class=ow>in</span> <span class=n>sys_comp_dict</span><span class=p>:</span>
+            <span class=n>comp_info</span> <span class=o>=</span> <span class=n>sys_comp_dict</span><span class=p>[</span><span class=n>part_label</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+                <span class=n>prose</span> <span class=o>=</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>status</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paraline</span><span class=p>(</span><span class=n>prose</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_insert_status</span><span class=p>(</span><span class=n>status</span><span class=p>,</span> <span class=mi>4</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_component_control_prompts</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>:</span> <span class=n>CompDict</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add prompts to the markdown for the control itself, per component.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>,</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>]:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paraline</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_PROMPT</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paraline</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>RULES_WARNING</span><span class=p>)</span>
+        <span class=n>did_write</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=c1># do special handling for This System</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>:</span>
+            <span class=c1># Passing in the control id and the empty key (&#39;&#39;) for the label</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_process_main_component</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>)</span>
+            <span class=n>did_write</span> <span class=o>=</span> <span class=kc>True</span>
+
+        <span class=n>sorted_comp_names</span> <span class=o>=</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>comp_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+        <span class=k>for</span> <span class=n>comp_name</span> <span class=ow>in</span> <span class=n>sorted_comp_names</span><span class=p>:</span>
+            <span class=n>dic</span> <span class=o>=</span> <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span>
+            <span class=c1># This System already handled</span>
+            <span class=k>if</span> <span class=n>comp_name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>for</span> <span class=n>comp_info</span> <span class=ow>in</span> <span class=p>[</span><span class=n>val</span> <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>val</span> <span class=ow>in</span> <span class=n>dic</span><span class=o>.</span><span class=n>items</span><span class=p>()</span> <span class=k>if</span> <span class=n>key</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span><span class=p>]:</span>
+                <span class=c1># don&#39;t output component name for component markdown since only one component</span>
+                <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>!=</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=mi>3</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>)</span>
+                <span class=n>prose</span> <span class=o>=</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span> <span class=k>if</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span> <span class=o>!=</span> <span class=n>control_id</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>prose</span><span class=p>:</span>
+                    <span class=n>prose</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> --&gt;&#39;</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paraline</span><span class=p>(</span><span class=n>prose</span><span class=p>)</span>
+                <span class=n>level</span> <span class=o>=</span> <span class=mi>3</span> <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span> <span class=k>else</span> <span class=mi>4</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_insert_rules</span><span class=p>(</span><span class=n>comp_info</span><span class=o>.</span><span class=n>rules</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_insert_status</span><span class=p>(</span><span class=n>comp_info</span><span class=o>.</span><span class=n>status</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+                <span class=n>did_write</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=n>did_write</span>
+
+    <span class=k>def</span> <span class=nf>_add_implementation_response_prompts</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>:</span> <span class=n>CompDict</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add the response request text for all parts to the markdown along with the header.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_hr</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=c1># top level request for implementation details</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MD_IMPLEMENTATION_QUESTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># write out control level prose and status</span>
+        <span class=n>did_write_part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_add_component_control_prompts</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+        <span class=c1># if the control has no parts written out then enter implementation in the top level entry</span>
+        <span class=c1># but if it does have parts written out, leave top level blank and provide details in the parts</span>
+        <span class=c1># Note that parts corresponding to sections don&#39;t get written out here so a check is needed</span>
+        <span class=c1># If we have responses per component then enter them in separate ### sections</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span> <span class=ow>and</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>prt</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>prt</span><span class=o>.</span><span class=n>name</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span><span class=p>:</span>
+                            <span class=k>continue</span>
+                        <span class=c1># if no label guess the label from the sub-part id</span>
+                        <span class=n>part_label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>prt</span><span class=p>)</span>
+                        <span class=n>part_label</span> <span class=o>=</span> <span class=n>prt</span><span class=o>.</span><span class=n>id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>part_label</span> <span class=k>else</span> <span class=n>part_label</span>
+
+                        <span class=c1># Determine if this part should be written out</span>
+                        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_skip_part</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>part_label</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>):</span>
+                            <span class=k>continue</span>
+
+                        <span class=k>if</span> <span class=ow>not</span> <span class=n>did_write_part</span><span class=p>:</span>
+                            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MD_LEAVE_BLANK_TEXT</span><span class=p>)</span>
+                            <span class=c1># insert extra line to make mdformat happy</span>
+                            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>_add_line_raw</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_hr</span><span class=p>()</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;Implementation for part </span><span class=si>{</span><span class=n>part_label</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                        <span class=n>wrote_label_content</span> <span class=o>=</span> <span class=kc>False</span>
+                        <span class=c1># To reduce verbosity by default, the main component</span>
+                        <span class=c1># is conditionally written for each part dependant on the control context.</span>
+                        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span> <span class=ow>and</span> <span class=n>context</span><span class=o>.</span><span class=n>include_all_parts</span><span class=p>:</span>
+                            <span class=bp>self</span><span class=o>.</span><span class=n>_process_main_component</span><span class=p>(</span><span class=n>prt</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>part_label</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>)</span>
+                            <span class=n>wrote_label_content</span> <span class=o>=</span> <span class=kc>True</span>
+                        <span class=n>sorted_comp_names</span> <span class=o>=</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>comp_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+                        <span class=k>for</span> <span class=n>comp_name</span> <span class=ow>in</span> <span class=n>sorted_comp_names</span><span class=p>:</span>
+                            <span class=c1># This System already handled</span>
+                            <span class=k>if</span> <span class=n>comp_name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>:</span>
+                                <span class=k>continue</span>
+                            <span class=n>dic</span> <span class=o>=</span> <span class=n>comp_dict</span><span class=p>[</span><span class=n>comp_name</span><span class=p>]</span>
+                            <span class=k>if</span> <span class=n>part_label</span> <span class=ow>in</span> <span class=n>dic</span><span class=p>:</span>
+                                <span class=c1># insert the component name for ssp but not for comp_def</span>
+                                <span class=c1># because there should only be one component in generated comp_def markdown</span>
+                                <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>!=</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>:</span>
+                                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>3</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>comp_name</span><span class=p>)</span>
+                                <span class=bp>self</span><span class=o>.</span><span class=n>_insert_comp_info</span><span class=p>(</span><span class=n>part_label</span><span class=p>,</span> <span class=n>dic</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+                                <span class=n>wrote_label_content</span> <span class=o>=</span> <span class=kc>True</span>
+                        <span class=k>if</span> <span class=ow>not</span> <span class=n>wrote_label_content</span><span class=p>:</span>
+                            <span class=n>level</span> <span class=o>=</span> <span class=mi>3</span> <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span> <span class=k>else</span> <span class=mi>4</span>
+                            <span class=bp>self</span><span class=o>.</span><span class=n>_insert_status</span><span class=p>(</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_PLANNED</span><span class=p>),</span> <span class=n>level</span><span class=p>)</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+                        <span class=n>did_write_part</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=c1># if we loaded nothing for this control yet then it must need a fresh prompt for the control statement</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>comp_dict</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>did_write_part</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> --&gt;&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=ow>in</span> <span class=p>[</span><span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>,</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>]:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_insert_status</span><span class=p>(</span><span class=n>status</span><span class=p>,</span> <span class=mi>3</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>did_write_part</span><span class=p>:</span>
+            <span class=n>part_label</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>dic</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>part_label</span> <span class=ow>in</span> <span class=n>dic</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>comp_name</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>:</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>3</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>comp_name</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_insert_comp_info</span><span class=p>(</span><span class=n>part_label</span><span class=p>,</span> <span class=n>dic</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_hr</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_include_component</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>comp_info</span><span class=p>:</span> <span class=n>ComponentImpInfo</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Check if a component has the required Markdown fields.</span>
+
+<span class=sd>        Notes: This is a simple function to centralize logic to check</span>
+<span class=sd>        when a component meets the requirement to get written to Markdown.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>rules</span> <span class=ow>or</span> <span class=n>comp_info</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>def</span> <span class=nf>_skip_part</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span> <span class=n>part_label</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>comp_dict</span><span class=p>:</span> <span class=n>CompDict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Check if a part should be skipped based on rules and context.</span>
+
+<span class=sd>        Notes: The default logic is to conditionally add control parts based</span>
+<span class=sd>        on whether the component has rules or existing prose associated with that part. This can be</span>
+<span class=sd>        changed using the control context for SSP markdown.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span> <span class=ow>and</span> <span class=n>context</span><span class=o>.</span><span class=n>include_all_parts</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>skip_item</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>dic</span> <span class=ow>in</span> <span class=n>comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>part_label</span> <span class=ow>in</span> <span class=n>dic</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_include_component</span><span class=p>(</span><span class=n>dic</span><span class=p>[</span><span class=n>part_label</span><span class=p>]):</span>
+                        <span class=n>skip_item</span> <span class=o>=</span> <span class=kc>False</span>
+                        <span class=k>break</span>
+        <span class=k>return</span> <span class=n>skip_item</span>
+
+    <span class=k>def</span> <span class=nf>_dump_subpart_infos</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=n>part</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=k>else</span> <span class=n>name</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=n>level</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+        <span class=k>if</span> <span class=s1>&#39;prose&#39;</span> <span class=ow>in</span> <span class=n>part</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paraline</span><span class=p>(</span><span class=n>part</span><span class=p>[</span><span class=s1>&#39;prose&#39;</span><span class=p>])</span>
+        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;parts&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_dump_subpart_infos</span><span class=p>(</span><span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>subpart</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_dump_subparts</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>Part</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=k>else</span> <span class=n>name</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=n>level</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paraline</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_dump_subparts</span><span class=p>(</span><span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>subpart</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_dump_section</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>Part</span><span class=p>,</span> <span class=n>added_sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>prefix</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=p>)</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=k>else</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>prefix</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span> <span class=k>if</span> <span class=n>prefix</span> <span class=k>else</span> <span class=n>title</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=n>level</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paraline</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_dump_subparts</span><span class=p>(</span><span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>subpart</span><span class=p>)</span>
+        <span class=n>added_sections</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_dump_section_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>added_sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>prefix</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>part_prose</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;prose&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>part_subparts</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;parts&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=n>part</span><span class=p>[</span><span class=s1>&#39;name&#39;</span><span class=p>]</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=k>else</span> <span class=n>name</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>prefix</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span> <span class=k>if</span> <span class=n>prefix</span> <span class=k>else</span> <span class=n>title</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=n>level</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>part_prose</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paraline</span><span class=p>(</span><span class=n>part_prose</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part_subparts</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_dump_subpart_infos</span><span class=p>(</span><span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>subpart</span><span class=p>)</span>
+        <span class=n>added_sections</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_additional_content</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+        <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span>
+        <span class=n>header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+        <span class=n>found_alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+        <span class=c1># get part and subpart info from adds of the profile</span>
+        <span class=n>part_infos</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_all_add_info</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>profile</span><span class=p>)</span>
+        <span class=n>has_content</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>part_infos</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>EDITABLE_CONTENT</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;&lt;!-- Make additions and edits below --&gt;&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+            <span class=s1>&#39;&lt;!-- The above represents the contents of the control as received by the profile, prior to additions. --&gt;&#39;</span>  <span class=c1># noqa E501</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+            <span class=s1>&#39;&lt;!-- If the profile makes additions to the control, they will appear below. --&gt;&#39;</span>  <span class=c1># noqa E501</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+            <span class=s1>&#39;&lt;!-- The above markdown may not be edited but you may edit the content below, and/or introduce new additions to be made by the profile. --&gt;&#39;</span>  <span class=c1># noqa E501</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+            <span class=s1>&#39;&lt;!-- If there is a yaml header at the top, parameter values may be edited. Use --set-parameters to incorporate the changes during assembly. --&gt;&#39;</span>  <span class=c1># noqa E501</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+            <span class=s1>&#39;&lt;!-- The content here will then replace what is in the profile for this control, after running profile-assemble. --&gt;&#39;</span>  <span class=c1># noqa E501</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=n>has_content</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+                <span class=s1>&#39;&lt;!-- The added parts in the profile for this control are below.  You may edit them and/or add new ones. --&gt;&#39;</span>  <span class=c1># noqa E501</span>
+            <span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+                <span class=s1>&#39;&lt;!-- The current profile has no added parts for this control, but you may add new ones here. --&gt;&#39;</span>
+            <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+            <span class=s1>&#39;&lt;!-- Each addition must have a heading either of the form ## Control my_addition_name --&gt;&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;&lt;!-- or ## Part a. (where the a. refers to one of the control statement labels.) --&gt;&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;&lt;!-- &quot;## Control&quot; parts are new parts added after the statement part. --&gt;&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+            <span class=s1>&#39;&lt;!-- &quot;## Part&quot; parts are new parts added into the top-level statement part with that label. --&gt;&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;&lt;!-- Subparts may be added with nested hash levels of the form ### My Subpart Name --&gt;&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;&lt;!-- underneath the parent ## Control or ## Part being added --&gt;&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span>
+            <span class=s1>&#39;&lt;!-- See https://oscal-compass.github.io/compliance-trestle/tutorials/ssp_profile_catalog_authoring/ssp_profile_catalog_authoring for guidance. --&gt;&#39;</span>  <span class=c1># noqa E501</span>
+        <span class=p>)</span>
+        <span class=c1># next is to make mdformat happy</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>_add_line_raw</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+
+        <span class=n>added_sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=n>control_part_id_map</span> <span class=o>=</span> <span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>statement_id</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_statement_id</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+        <span class=c1># if the file already has markdown content, read its alters</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span> <span class=ow>in</span> <span class=n>header</span><span class=p>:</span>
+                <span class=n>header</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>alter</span> <span class=ow>in</span> <span class=n>found_alters</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>add</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>alter</span><span class=o>.</span><span class=n>adds</span><span class=p>):</span>
+                    <span class=c1># by_id could refer to statement (Control) or part (Part)</span>
+                    <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>:</span>
+                        <span class=c1># is this a part that goes after the control statement</span>
+                        <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span> <span class=o>==</span> <span class=n>statement_id</span><span class=p>:</span>
+                            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                                <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>or</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                                    <span class=bp>self</span><span class=o>.</span><span class=n>_dump_section</span><span class=p>(</span><span class=mi>2</span><span class=p>,</span> <span class=n>part</span><span class=p>,</span> <span class=n>added_sections</span><span class=p>,</span> <span class=s1>&#39;Control&#39;</span><span class=p>)</span>
+                        <span class=k>else</span><span class=p>:</span>
+                            <span class=c1># or is it a sub-part of a statement part</span>
+                            <span class=n>part_label</span> <span class=o>=</span> <span class=n>control_part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>,</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>)</span>
+                            <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;Part </span><span class=si>{</span><span class=n>part_label</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                                <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                                    <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>or</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                                        <span class=n>name</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span>
+                                        <span class=c1># need special handling for statement parts because their name is &#39;item&#39;</span>
+                                        <span class=c1># get the short name as last piece of the part id after the &#39;.&#39;</span>
+                                        <span class=k>if</span> <span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span><span class=p>:</span>
+                                            <span class=n>name</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+                                        <span class=n>title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=k>else</span> <span class=n>name</span>
+                                        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>3</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+                                        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+                                            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paraline</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>)</span>
+                                        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                                            <span class=bp>self</span><span class=o>.</span><span class=n>_dump_subparts</span><span class=p>(</span><span class=mi>3</span><span class=p>,</span> <span class=n>subpart</span><span class=p>)</span>
+                                        <span class=n>added_sections</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=c1># if not by_id just add at end of control&#39;s parts</span>
+                        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=ow>or</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                                <span class=bp>self</span><span class=o>.</span><span class=n>_dump_section</span><span class=p>(</span><span class=mi>2</span><span class=p>,</span> <span class=n>part</span><span class=p>,</span> <span class=n>added_sections</span><span class=p>,</span> <span class=s1>&#39;Control&#39;</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>header</span><span class=p>:</span>
+                            <span class=n>header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                        <span class=n>by_id</span> <span class=o>=</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span>
+                        <span class=n>part_info</span> <span class=o>=</span> <span class=n>PartInfo</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>prose</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=n>add</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>smt_part</span><span class=o>=</span><span class=n>by_id</span><span class=p>)</span>
+                        <span class=n>_</span><span class=p>,</span> <span class=n>prop_list</span> <span class=o>=</span> <span class=n>part_info</span><span class=o>.</span><span class=n>to_dicts</span><span class=p>(</span><span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=p>{}))</span>
+                        <span class=n>header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>prop_list</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># md does not already exist so fill in directly</span>
+            <span class=n>in_part</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=k>for</span> <span class=n>part_info</span> <span class=ow>in</span> <span class=n>part_infos</span><span class=p>:</span>
+                <span class=n>part</span><span class=p>,</span> <span class=n>prop_list</span> <span class=o>=</span> <span class=n>part_info</span><span class=o>.</span><span class=n>to_dicts</span><span class=p>(</span><span class=n>part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=p>{}))</span>
+                <span class=c1># is this part of a statement part</span>
+                <span class=k>if</span> <span class=n>part_info</span><span class=o>.</span><span class=n>smt_part</span> <span class=ow>and</span> <span class=n>part_info</span><span class=o>.</span><span class=n>prose</span> <span class=ow>and</span> <span class=n>part_info</span><span class=o>.</span><span class=n>smt_part</span> <span class=ow>in</span> <span class=n>control_part_id_map</span><span class=p>:</span>
+                    <span class=c1># avoid outputting ## Part again if in same part</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>part_info</span><span class=o>.</span><span class=n>smt_part</span> <span class=o>==</span> <span class=n>in_part</span><span class=p>:</span>
+                        <span class=n>in_part</span> <span class=o>=</span> <span class=n>part_info</span><span class=o>.</span><span class=n>smt_part</span>
+                        <span class=n>part_label</span> <span class=o>=</span> <span class=n>control_part_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>part_info</span><span class=o>.</span><span class=n>smt_part</span><span class=p>,</span> <span class=n>part_info</span><span class=o>.</span><span class=n>smt_part</span><span class=p>)</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;Part </span><span class=si>{</span><span class=n>part_label</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_dump_section_info</span><span class=p>(</span><span class=mi>3</span><span class=p>,</span> <span class=n>part</span><span class=p>,</span> <span class=n>added_sections</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+                <span class=c1># is it a control part</span>
+                <span class=k>elif</span> <span class=n>part_info</span><span class=o>.</span><span class=n>prose</span> <span class=ow>or</span> <span class=n>part_info</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                    <span class=n>in_part</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_dump_section_info</span><span class=p>(</span><span class=mi>2</span><span class=p>,</span> <span class=n>part</span><span class=p>,</span> <span class=n>added_sections</span><span class=p>,</span> <span class=s1>&#39;Control&#39;</span><span class=p>)</span>
+                <span class=k>elif</span> <span class=n>prop_list</span><span class=p>:</span>
+                    <span class=n>in_part</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+                    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>header</span><span class=p>:</span>
+                        <span class=n>header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+                    <span class=n>header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>]</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>prop_list</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>added_sections</span>
+
+    <span class=k>def</span> <span class=nf>_prompt_required_sections</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>required_sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>added_sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add prompts for any required sections that haven&#39;t already been written out.&quot;&quot;&quot;</span>
+        <span class=n>missing_sections</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>required_sections</span><span class=p>)</span><span class=o>.</span><span class=n>difference</span><span class=p>(</span><span class=n>added_sections</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>section</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>missing_sections</span><span class=p>):</span>
+            <span class=n>section_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>section</span><span class=p>,</span> <span class=n>section</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=mi>2</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;Control </span><span class=si>{</span><span class=n>section_title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>section_title</span><span class=si>}</span><span class=s1> --&gt;&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_merge_headers</span><span class=p>(</span><span class=n>memory_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>md_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+                       <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>
+        <span class=n>merged_header</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>md_header</span><span class=p>)</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_dicts_deep</span><span class=p>(</span><span class=n>merged_header</span><span class=p>,</span> <span class=n>memory_header</span><span class=p>,</span> <span class=kc>False</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>merged_header</span>
+
+    <span class=k>def</span> <span class=nf>write_control_for_editing</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span>
+        <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+        <span class=n>dest_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>group_title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+        <span class=n>found_alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Write out the control in markdown format into the specified directory.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            context: The context of the control usage</span>
+<span class=sd>            control: The control to write as markdown</span>
+<span class=sd>            dest_path: Path to the directory where the control will be written</span>
+<span class=sd>            group_title: Title of the group containing the control</span>
+<span class=sd>            part_id_map: Mapping of part_id to label</span>
+<span class=sd>            found_alters: List of alters read from the markdown file - if it exists</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            None</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            The filename is constructed from the control&#39;s id and created in the dest_path.</span>
+<span class=sd>            If a yaml header is present in the file, new values in provided header will not replace those in the</span>
+<span class=sd>            markdown header unless overwrite_header_values is true.  If it is true then overwrite any existing values,</span>
+<span class=sd>            but in all cases new items from the provided header will be added to the markdown header.</span>
+<span class=sd>            If the markdown file already exists, its current header and prose are read.</span>
+<span class=sd>            Controls are checked if they are marked withdrawn, and if so they are not written out.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>is_withdrawn</span><span class=p>(</span><span class=n>control</span><span class=p>):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Not writing out control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> since it is marked Withdrawn.&#39;</span><span class=p>)</span>
+            <span class=k>return</span>
+
+        <span class=n>control_file</span> <span class=o>=</span> <span class=n>dest_path</span> <span class=o>/</span> <span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=o>+</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>)</span>
+        <span class=c1># read the existing markdown header and content if it exists</span>
+        <span class=n>md_header</span><span class=p>,</span> <span class=n>comp_dict</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_control_info_from_md</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+        <span class=c1># Merge the memory comp_dict with the md one if control exists</span>
+        <span class=k>if</span> <span class=n>comp_dict</span><span class=p>:</span>
+            <span class=n>template_comp_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_dicts_deep</span><span class=p>(</span><span class=n>comp_dict</span><span class=p>,</span> <span class=n>template_comp_dict</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span> <span class=o>=</span> <span class=n>comp_dict</span>
+
+        <span class=n>header_comment_dict</span> <span class=o>=</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_PROPS_COMMENT</span><span class=p>}</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>to_markdown</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+                <span class=n>header_comment_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_PROFILE_VALUES_COMMENT</span>
+            <span class=k>elif</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>:</span>
+                <span class=n>header_comment_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_SSP_VALUES_COMMENT</span>
+                <span class=n>header_comment_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_RULE_PARAM_VALUES_SSP_COMMENT</span>
+                <span class=c1># The add props information to SSP only. It is added to the profile later.</span>
+                <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>md_header</span><span class=p>:</span>
+                    <span class=n>md_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>elif</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>:</span>
+                <span class=n>header_comment_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span>
+                                    <span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT</span>
+
+        <span class=c1># begin adding info to the md file</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>header_comment_dict</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span>
+
+        <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span> <span class=o>=</span> <span class=n>ControlWriter</span><span class=o>.</span><span class=n>_merge_headers</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=n>md_header</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+        <span class=c1># if the control has an explicitly defined sort-id and there is none in the yaml_header, then insert it</span>
+        <span class=c1># in the yaml header and allow overwrite_header_values to control whether it overwrites an existing one</span>
+        <span class=c1># in the markdown header</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span> <span class=o>=</span> <span class=n>as_dict</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>!=</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_dicts_deep</span><span class=p>(</span>
+                <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>overwrite_header_values</span>
+            <span class=p>)</span>
+        <span class=c1># the global contents are special and get overwritten on generate</span>
+        <span class=n>set_or_pop</span><span class=p>(</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=p>)</span>
+        <span class=n>sort_id</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>sort_id</span><span class=p>:</span>
+            <span class=n>deep_set</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>],</span> <span class=n>sort_id</span><span class=p>)</span>
+
+        <span class=c1># merge any provided sections with sections in the header, with priority to the one from context (e.g. CLI)</span>
+        <span class=n>header_sections_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SECTIONS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+        <span class=n>merged_sections_dict</span> <span class=o>=</span> <span class=n>merge_dicts</span><span class=p>(</span><span class=n>header_sections_dict</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span><span class=p>)</span>
+        <span class=n>set_or_pop</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>SECTIONS_TAG</span><span class=p>,</span> <span class=n>merged_sections_dict</span><span class=p>)</span>
+
+        <span class=c1># now begin filling in content from the control in memory</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_statement</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>group_title</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_objective</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+        <span class=c1># add allowed sections to the markdown</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_sections</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>allowed_sections</span><span class=p>)</span>
+
+        <span class=c1># prompt responses for imp reqs using special format if comp_def mode</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>prompt_responses</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_implementation_response_prompts</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+        <span class=c1># for profile generate</span>
+        <span class=c1># add sections corresponding to added parts in the profile</span>
+        <span class=n>added_sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+            <span class=n>added_sections</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_add_additional_content</span><span class=p>(</span>
+                <span class=n>control</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>profile</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>found_alters</span>
+            <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_yaml_header</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>required_sections</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_prompt_required_sections</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>required_sections</span><span class=p>,</span> <span class=n>added_sections</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.control_writer.ControlWriter-functions>Functions<a href=#trestle.core.control_writer.ControlWriter-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_writer.ControlWriter.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.control_writer.ControlWriter.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class.</p> <details class=quote> <summary>Source code in <code>trestle/core/control_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>MDWriter</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.control_writer.ControlWriter.write_control_for_editing class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_control_for_editing</span><span class=p>(</span><span class=n>context</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>dest_path</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>found_alters</span><span class=p>)</span></code> <a href=#trestle.core.control_writer.ControlWriter.write_control_for_editing class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write out the control in markdown format into the specified directory.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>context</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_context.ControlContext href=../control_context/#trestle.core.control_context.ControlContext>ControlContext</a></code> </td> <td> <div class=doc-md-description> <p>The context of the control usage</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>control</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.catalog.Control href=../../oscal/catalog/#trestle.oscal.catalog.Control>Control</a></code> </td> <td> <div class=doc-md-description> <p>The control to write as markdown</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>dest_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path to the directory where the control will be written</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>group_title</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Title of the group containing the control</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>part_id_map</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, str]</code> </td> <td> <div class=doc-md-description> <p>Mapping of part_id to label</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>found_alters</code> </td> <td> <code><span title=typing.List>List</span>[<a class="autorefs autorefs-internal" title=trestle.oscal.profile.Alter href=../../oscal/profile/#trestle.oscal.profile.Alter>Alter</a>]</code> </td> <td> <div class=doc-md-description> <p>List of alters read from the markdown file - if it exists</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>None</code> </td> <td> <div class=doc-md-description> <p>None</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>The filename is constructed from the control's id and created in the dest_path. If a yaml header is present in the file, new values in provided header will not replace those in the markdown header unless overwrite_header_values is true. If it is true then overwrite any existing values, but in all cases new items from the provided header will be added to the markdown header. If the markdown file already exists, its current header and prose are read. Controls are checked if they are marked withdrawn, and if so they are not written out.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/control_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_control_for_editing</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>context</span><span class=p>:</span> <span class=n>ControlContext</span><span class=p>,</span>
+    <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+    <span class=n>dest_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>group_title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>part_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+    <span class=n>found_alters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Write out the control in markdown format into the specified directory.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        context: The context of the control usage</span>
+<span class=sd>        control: The control to write as markdown</span>
+<span class=sd>        dest_path: Path to the directory where the control will be written</span>
+<span class=sd>        group_title: Title of the group containing the control</span>
+<span class=sd>        part_id_map: Mapping of part_id to label</span>
+<span class=sd>        found_alters: List of alters read from the markdown file - if it exists</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        None</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        The filename is constructed from the control&#39;s id and created in the dest_path.</span>
+<span class=sd>        If a yaml header is present in the file, new values in provided header will not replace those in the</span>
+<span class=sd>        markdown header unless overwrite_header_values is true.  If it is true then overwrite any existing values,</span>
+<span class=sd>        but in all cases new items from the provided header will be added to the markdown header.</span>
+<span class=sd>        If the markdown file already exists, its current header and prose are read.</span>
+<span class=sd>        Controls are checked if they are marked withdrawn, and if so they are not written out.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>is_withdrawn</span><span class=p>(</span><span class=n>control</span><span class=p>):</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Not writing out control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> since it is marked Withdrawn.&#39;</span><span class=p>)</span>
+        <span class=k>return</span>
+
+    <span class=n>control_file</span> <span class=o>=</span> <span class=n>dest_path</span> <span class=o>/</span> <span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span> <span class=o>+</span> <span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=p>)</span>
+    <span class=c1># read the existing markdown header and content if it exists</span>
+    <span class=n>md_header</span><span class=p>,</span> <span class=n>comp_dict</span> <span class=o>=</span> <span class=n>ControlReader</span><span class=o>.</span><span class=n>read_control_info_from_md</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+    <span class=c1># Merge the memory comp_dict with the md one if control exists</span>
+    <span class=k>if</span> <span class=n>comp_dict</span><span class=p>:</span>
+        <span class=n>template_comp_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_dicts_deep</span><span class=p>(</span><span class=n>comp_dict</span><span class=p>,</span> <span class=n>template_comp_dict</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span> <span class=o>=</span> <span class=n>comp_dict</span>
+
+    <span class=n>header_comment_dict</span> <span class=o>=</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_PROPS_COMMENT</span><span class=p>}</span>
+    <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>to_markdown</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+            <span class=n>header_comment_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_PROFILE_VALUES_COMMENT</span>
+        <span class=k>elif</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>SSP</span><span class=p>:</span>
+            <span class=n>header_comment_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>SET_PARAMS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_SSP_VALUES_COMMENT</span>
+            <span class=n>header_comment_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_RULE_PARAM_VALUES_SSP_COMMENT</span>
+            <span class=c1># The add props information to SSP only. It is added to the profile later.</span>
+            <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>md_header</span><span class=p>:</span>
+                <span class=n>md_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_ADD_PROPS_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>elif</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>COMPONENT</span><span class=p>:</span>
+            <span class=n>header_comment_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>COMP_DEF_RULES_PARAM_VALS_TAG</span>
+                                <span class=p>]</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT</span>
+
+    <span class=c1># begin adding info to the md file</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=n>control_file</span><span class=p>,</span> <span class=n>header_comment_dict</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span>
+
+    <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span> <span class=o>=</span> <span class=n>ControlWriter</span><span class=o>.</span><span class=n>_merge_headers</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=n>md_header</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+    <span class=c1># if the control has an explicitly defined sort-id and there is none in the yaml_header, then insert it</span>
+    <span class=c1># in the yaml header and allow overwrite_header_values to control whether it overwrites an existing one</span>
+    <span class=c1># in the markdown header</span>
+    <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span> <span class=o>=</span> <span class=n>as_dict</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>!=</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>merge_dicts_deep</span><span class=p>(</span>
+            <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>overwrite_header_values</span>
+        <span class=p>)</span>
+    <span class=c1># the global contents are special and get overwritten on generate</span>
+    <span class=n>set_or_pop</span><span class=p>(</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span>
+        <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span>
+        <span class=n>context</span><span class=o>.</span><span class=n>cli_yaml_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=p>)</span>
+    <span class=n>sort_id</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_sort_id</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>sort_id</span><span class=p>:</span>
+        <span class=n>deep_set</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>SORT_ID</span><span class=p>],</span> <span class=n>sort_id</span><span class=p>)</span>
+
+    <span class=c1># merge any provided sections with sections in the header, with priority to the one from context (e.g. CLI)</span>
+    <span class=n>header_sections_dict</span> <span class=o>=</span> <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SECTIONS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+    <span class=n>merged_sections_dict</span> <span class=o>=</span> <span class=n>merge_dicts</span><span class=p>(</span><span class=n>header_sections_dict</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>sections_dict</span><span class=p>)</span>
+    <span class=n>set_or_pop</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>SECTIONS_TAG</span><span class=p>,</span> <span class=n>merged_sections_dict</span><span class=p>)</span>
+
+    <span class=c1># now begin filling in content from the control in memory</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_statement</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>group_title</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_objective</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+    <span class=c1># add allowed sections to the markdown</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_sections</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>allowed_sections</span><span class=p>)</span>
+
+    <span class=c1># prompt responses for imp reqs using special format if comp_def mode</span>
+    <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>prompt_responses</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_implementation_response_prompts</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>comp_dict</span><span class=p>,</span> <span class=n>context</span><span class=p>)</span>
+
+    <span class=c1># for profile generate</span>
+    <span class=c1># add sections corresponding to added parts in the profile</span>
+    <span class=n>added_sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>purpose</span> <span class=o>==</span> <span class=n>ContextPurpose</span><span class=o>.</span><span class=n>PROFILE</span><span class=p>:</span>
+        <span class=n>added_sections</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_add_additional_content</span><span class=p>(</span>
+            <span class=n>control</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>profile</span><span class=p>,</span> <span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>,</span> <span class=n>part_id_map</span><span class=p>,</span> <span class=n>found_alters</span>
+        <span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_yaml_header</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>merged_header</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>context</span><span class=o>.</span><span class=n>required_sections</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_prompt_required_sections</span><span class=p>(</span><span class=n>context</span><span class=o>.</span><span class=n>required_sections</span><span class=p>,</span> <span class=n>added_sections</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.control_writer-functions>Functions<a href=#trestle.core.control_writer-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/crm/bycomp_interface/index.html b/latest/reference/API/trestle/core/crm/bycomp_interface/index.html
new file mode 100644
index 000000000..7d972d3dd
--- /dev/null
+++ b/latest/reference/API/trestle/core/crm/bycomp_interface/index.html
@@ -0,0 +1,455 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.crm.bycomp_interface module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/bycomp_interface/ rel=canonical><link href=../../commands/common/return_codes/ rel=prev><link href=../export_reader/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.crm.bycomp_interface - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.crm.bycomp_interface - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.crm.bycomp_interface module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/bycomp_interface.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/bycomp_interface/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.crm.bycomp_interface - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.crm.bycomp_interface module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/bycomp_interface.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.crm.bycomp_interface class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28 checked> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface class=md-nav__link> <span class=md-ellipsis> bycomp_interface </span> </a> <nav class=md-nav aria-label=bycomp_interface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface class=md-nav__link> <span class=md-ellipsis> ByComponentInterface </span> </a> <nav class=md-nav aria-label=ByComponentInterface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.get_export_sets class=md-nav__link> <span class=md-ellipsis> get_export_sets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_provided class=md-nav__link> <span class=md-ellipsis> get_isolated_provided </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_responsibilities class=md-nav__link> <span class=md-ellipsis> get_isolated_responsibilities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.reconcile_inheritance_by_component class=md-nav__link> <span class=md-ellipsis> reconcile_inheritance_by_component </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface class=md-nav__link> <span class=md-ellipsis> bycomp_interface </span> </a> <nav class=md-nav aria-label=bycomp_interface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface class=md-nav__link> <span class=md-ellipsis> ByComponentInterface </span> </a> <nav class=md-nav aria-label=ByComponentInterface> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.get_export_sets class=md-nav__link> <span class=md-ellipsis> get_export_sets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_provided class=md-nav__link> <span class=md-ellipsis> get_isolated_provided </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_responsibilities class=md-nav__link> <span class=md-ellipsis> get_isolated_responsibilities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.reconcile_inheritance_by_component class=md-nav__link> <span class=md-ellipsis> reconcile_inheritance_by_component </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.bycomp_interface-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.crm.bycomp_interface</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.crm.bycomp_interface class="doc doc-heading"> <code>trestle.core.crm.bycomp_interface</code> <a href=#trestle.core.crm.bycomp_interface class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Provide interface to by-component allowing queries and operations for exports/inheritance statements.</p> <div class="doc doc-children"> <h3 id=trestle.core.crm.bycomp_interface-attributes>Attributes<a href=#trestle.core.crm.bycomp_interface-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.crm.bycomp_interface.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.crm.bycomp_interface.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.crm.bycomp_interface-classes>Classes<a href=#trestle.core.crm.bycomp_interface-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.bycomp_interface.ByComponentInterface class="doc doc-heading"> <code>ByComponentInterface</code> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Interface to query and modify by-component assembly inheritance contents.</p> <p>The by-component is contained in two separate forms: As an actual OSCAL by-component assembly, and multiple dicts providing direct lookup of inheritance statement by uuid.</p> <p>The dicts are created by the ByComponentInterface constructor, parsed and the responsibility and provided statements are separated into three catagories:</p> <p>isolated responsibilities - A responsibility with no provided statement isolated provided - A provided statement with no referring responsibility statements export set - A set with a single responsibility and referred provided statement</p> <p>For updating ByComponent inheritance and satisfied statements, the interface provides a method to reconcile the the by-component assembly and merge input inherited and satisfied statements.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/bycomp_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 27</span>
+<span class=normal> 28</span>
+<span class=normal> 29</span>
+<span class=normal> 30</span>
+<span class=normal> 31</span>
+<span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ByComponentInterface</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Interface to query and modify by-component assembly inheritance contents.</span>
+
+<span class=sd>    The by-component is contained in two separate forms:  As an actual OSCAL by-component assembly,</span>
+<span class=sd>    and multiple dicts providing direct lookup of inheritance statement by uuid.</span>
+
+<span class=sd>    The dicts are created by the ByComponentInterface constructor, parsed and the responsibility and provided statements</span>
+<span class=sd>    are separated into three catagories:</span>
+
+<span class=sd>    isolated responsibilities - A responsibility with no provided statement</span>
+<span class=sd>    isolated provided - A provided statement with no referring responsibility statements</span>
+<span class=sd>    export set - A set with a single responsibility and referred provided statement</span>
+
+<span class=sd>    For updating ByComponent inheritance and satisfied statements, the interface provides a method to reconcile the</span>
+<span class=sd>    the by-component assembly and merge input inherited and satisfied statements.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>by_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize export writer for a single by-component assembly.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_by_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span> <span class=o>=</span> <span class=n>by_comp</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_by_provided</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_inherited_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_inherited_dict</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_satisfied_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_satisfied_dict</span><span class=p>()</span>
+
+        <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>export</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_provided_dict</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_responsibility_dict</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_by_provided</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_responsibility_by_provided_dict</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_create_provided_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]:</span>
+        <span class=n>provided_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>provided</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_by_comp</span><span class=o>.</span><span class=n>export</span><span class=o>.</span><span class=n>provided</span><span class=p>):</span>
+            <span class=n>provided_dict</span><span class=p>[</span><span class=n>provided</span><span class=o>.</span><span class=n>uuid</span><span class=p>]</span> <span class=o>=</span> <span class=n>provided</span>
+        <span class=k>return</span> <span class=n>provided_dict</span>
+
+    <span class=k>def</span> <span class=nf>_create_responsibility_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]:</span>
+        <span class=n>responsibility_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>responsibility</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_by_comp</span><span class=o>.</span><span class=n>export</span><span class=o>.</span><span class=n>responsibilities</span><span class=p>):</span>
+            <span class=n>responsibility_dict</span><span class=p>[</span><span class=n>responsibility</span><span class=o>.</span><span class=n>uuid</span><span class=p>]</span> <span class=o>=</span> <span class=n>responsibility</span>
+        <span class=k>return</span> <span class=n>responsibility_dict</span>
+
+    <span class=k>def</span> <span class=nf>_create_responsibility_by_provided_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]]:</span>
+        <span class=n>responsibility_by_provided</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>responsibility</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_by_comp</span><span class=o>.</span><span class=n>export</span><span class=o>.</span><span class=n>responsibilities</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>responsibility</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>responsibility</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>responsibility_by_provided</span><span class=p>:</span>
+                <span class=n>responsibility_by_provided</span><span class=p>[</span><span class=n>responsibility</span><span class=o>.</span><span class=n>provided_uuid</span><span class=p>]</span> <span class=o>=</span> <span class=p>[</span><span class=n>responsibility</span><span class=p>]</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>existing_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]</span> <span class=o>=</span> <span class=n>responsibility_by_provided</span><span class=p>[</span><span class=n>responsibility</span><span class=o>.</span><span class=n>provided_uuid</span><span class=p>]</span>
+                <span class=n>existing_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>responsibility</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>responsibility_by_provided</span>
+
+    <span class=k>def</span> <span class=nf>_create_inherited_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]:</span>
+        <span class=n>inherited_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>inherited</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_by_comp</span><span class=o>.</span><span class=n>inherited</span><span class=p>):</span>
+            <span class=n>inherited_dict</span><span class=p>[</span><span class=nb>str</span><span class=p>(</span><span class=n>inherited</span><span class=o>.</span><span class=n>provided_uuid</span><span class=p>)]</span> <span class=o>=</span> <span class=n>inherited</span>
+        <span class=k>return</span> <span class=n>inherited_dict</span>
+
+    <span class=k>def</span> <span class=nf>_create_satisfied_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]:</span>
+        <span class=n>satisfied_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>satisfied</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_by_comp</span><span class=o>.</span><span class=n>satisfied</span><span class=p>):</span>
+            <span class=n>satisfied_dict</span><span class=p>[</span><span class=nb>str</span><span class=p>(</span><span class=n>satisfied</span><span class=o>.</span><span class=n>responsibility_uuid</span><span class=p>)]</span> <span class=o>=</span> <span class=n>satisfied</span>
+        <span class=k>return</span> <span class=n>satisfied_dict</span>
+
+    <span class=k>def</span> <span class=nf>get_isolated_responsibilities</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return all isolated exported responsibilities.&quot;&quot;&quot;</span>
+        <span class=n>all_responsibilities</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>resp</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_dict</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>resp</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>all_responsibilities</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>resp</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>all_responsibilities</span>
+
+    <span class=k>def</span> <span class=nf>get_isolated_provided</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return all isolated exported provided capabilities.&quot;&quot;&quot;</span>
+        <span class=n>all_provided</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>provided</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_provided_has_responsibilities</span><span class=p>(</span><span class=n>provided</span><span class=o>.</span><span class=n>uuid</span><span class=p>):</span>
+                <span class=n>all_provided</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>provided</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>all_provided</span>
+
+    <span class=k>def</span> <span class=nf>get_export_sets</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return a dictionary of every responsibility relationship with provided.&quot;&quot;&quot;</span>
+        <span class=n>all_export_sets</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>provided_uuid</span><span class=p>,</span> <span class=n>responsibilities</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_by_provided</span><span class=p>)</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+
+            <span class=c1># Ensure the provided object exists in the dictionary.</span>
+            <span class=c1># If it doesn&#39;t this is a bug.</span>
+            <span class=k>if</span> <span class=n>provided_uuid</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided capability </span><span class=si>{</span><span class=n>provided_uuid</span><span class=si>}</span><span class=s1> not found&#39;</span><span class=p>)</span>
+            <span class=n>provided</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span><span class=p>[</span><span class=n>provided_uuid</span><span class=p>]</span>
+
+            <span class=k>for</span> <span class=n>responsibility</span> <span class=ow>in</span> <span class=n>responsibilities</span><span class=p>:</span>
+                <span class=n>shared_responsibility</span><span class=p>:</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]</span> <span class=o>=</span> <span class=p>(</span><span class=n>responsibility</span><span class=p>,</span> <span class=n>provided</span><span class=p>)</span>
+                <span class=n>all_export_sets</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>shared_responsibility</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>all_export_sets</span>
+
+    <span class=k>def</span> <span class=nf>reconcile_inheritance_by_component</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>incoming_inherited</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>],</span> <span class=n>incoming_satisfied</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Reconcile the inherited and satisfied statements in the by-component assembly with changes from the export.</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            A statement is determined as existing if the provided uuid or responsibility uuid is in the existing</span>
+<span class=sd>            by-component assembly. If existing, the description will be updated if it has changed.</span>
+
+<span class=sd>            Any existing inherited or satisfied statements that are not in the incoming export will be removed.</span>
+<span class=sd>            If a statement is in the incoming export, but not in the existing by-component assembly, it will be added.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>new_inherited</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>new_satisfied</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=c1># Create a copy of the input by-component assembly to reconcile and return</span>
+        <span class=n>new_by_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_by_comp</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>incoming_inherited</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inherited_dict</span><span class=p>:</span>
+                <span class=n>existing_statement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inherited_dict</span><span class=p>[</span><span class=nb>str</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>provided_uuid</span><span class=p>)]</span>
+                <span class=c1># Update the description if it has changed</span>
+                <span class=n>existing_statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>description</span>
+                <span class=n>statement</span> <span class=o>=</span> <span class=n>existing_statement</span>
+            <span class=n>new_inherited</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+
+        <span class=n>new_by_comp</span><span class=o>.</span><span class=n>inherited</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_inherited</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>incoming_satisfied</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>responsibility_uuid</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_satisfied_dict</span><span class=p>:</span>
+                <span class=n>existing_statement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_satisfied_dict</span><span class=p>[</span><span class=nb>str</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>responsibility_uuid</span><span class=p>)]</span>
+                <span class=c1># Update the description if it has changed</span>
+                <span class=n>existing_statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>description</span>
+                <span class=n>statement</span> <span class=o>=</span> <span class=n>existing_statement</span>
+            <span class=n>new_satisfied</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+
+        <span class=n>new_by_comp</span><span class=o>.</span><span class=n>satisfied</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_satisfied</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>new_by_comp</span>
+
+    <span class=k>def</span> <span class=nf>_provided_has_responsibilities</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>provided_uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return whether a provided UUID has responsibilities.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>provided_uuid</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_by_provided</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.bycomp_interface.ByComponentInterface-functions>Functions<a href=#trestle.core.crm.bycomp_interface.ByComponentInterface-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.bycomp_interface.ByComponentInterface.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span></code> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize export writer for a single by-component assembly.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/bycomp_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>by_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize export writer for a single by-component assembly.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_by_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span> <span class=o>=</span> <span class=n>by_comp</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_by_provided</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_inherited_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_inherited_dict</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_satisfied_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_satisfied_dict</span><span class=p>()</span>
+
+    <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>export</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_provided_dict</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_responsibility_dict</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_by_provided</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_responsibility_by_provided_dict</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.bycomp_interface.ByComponentInterface.get_export_sets class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_export_sets</span><span class=p>()</span></code> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.get_export_sets class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return a dictionary of every responsibility relationship with provided.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/bycomp_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_export_sets</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return a dictionary of every responsibility relationship with provided.&quot;&quot;&quot;</span>
+    <span class=n>all_export_sets</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>provided_uuid</span><span class=p>,</span> <span class=n>responsibilities</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_by_provided</span><span class=p>)</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+
+        <span class=c1># Ensure the provided object exists in the dictionary.</span>
+        <span class=c1># If it doesn&#39;t this is a bug.</span>
+        <span class=k>if</span> <span class=n>provided_uuid</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided capability </span><span class=si>{</span><span class=n>provided_uuid</span><span class=si>}</span><span class=s1> not found&#39;</span><span class=p>)</span>
+        <span class=n>provided</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span><span class=p>[</span><span class=n>provided_uuid</span><span class=p>]</span>
+
+        <span class=k>for</span> <span class=n>responsibility</span> <span class=ow>in</span> <span class=n>responsibilities</span><span class=p>:</span>
+            <span class=n>shared_responsibility</span><span class=p>:</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]</span> <span class=o>=</span> <span class=p>(</span><span class=n>responsibility</span><span class=p>,</span> <span class=n>provided</span><span class=p>)</span>
+            <span class=n>all_export_sets</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>shared_responsibility</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>all_export_sets</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_provided class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_isolated_provided</span><span class=p>()</span></code> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_provided class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return all isolated exported provided capabilities.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/bycomp_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_isolated_provided</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return all isolated exported provided capabilities.&quot;&quot;&quot;</span>
+    <span class=n>all_provided</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Provided</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>provided</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_provided_dict</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_provided_has_responsibilities</span><span class=p>(</span><span class=n>provided</span><span class=o>.</span><span class=n>uuid</span><span class=p>):</span>
+            <span class=n>all_provided</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>provided</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>all_provided</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_responsibilities class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_isolated_responsibilities</span><span class=p>()</span></code> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_responsibilities class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return all isolated exported responsibilities.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/bycomp_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_isolated_responsibilities</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return all isolated exported responsibilities.&quot;&quot;&quot;</span>
+    <span class=n>all_responsibilities</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Responsibility</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>resp</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_responsibility_dict</span><span class=p>)</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>resp</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>all_responsibilities</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>resp</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>all_responsibilities</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.bycomp_interface.ByComponentInterface.reconcile_inheritance_by_component class="doc doc-heading"> <code class="highlight language-python"><span class=n>reconcile_inheritance_by_component</span><span class=p>(</span><span class=n>incoming_inherited</span><span class=p>,</span> <span class=n>incoming_satisfied</span><span class=p>)</span></code> <a href=#trestle.core.crm.bycomp_interface.ByComponentInterface.reconcile_inheritance_by_component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Reconcile the inherited and satisfied statements in the by-component assembly with changes from the export.</p> <details class=notes open> <summary>Notes</summary> <p>A statement is determined as existing if the provided uuid or responsibility uuid is in the existing by-component assembly. If existing, the description will be updated if it has changed.</p> <p>Any existing inherited or satisfied statements that are not in the incoming export will be removed. If a statement is in the incoming export, but not in the existing by-component assembly, it will be added.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/crm/bycomp_interface.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>reconcile_inheritance_by_component</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>incoming_inherited</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>],</span> <span class=n>incoming_satisfied</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Reconcile the inherited and satisfied statements in the by-component assembly with changes from the export.</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        A statement is determined as existing if the provided uuid or responsibility uuid is in the existing</span>
+<span class=sd>        by-component assembly. If existing, the description will be updated if it has changed.</span>
+
+<span class=sd>        Any existing inherited or satisfied statements that are not in the incoming export will be removed.</span>
+<span class=sd>        If a statement is in the incoming export, but not in the existing by-component assembly, it will be added.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>new_inherited</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>new_satisfied</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=c1># Create a copy of the input by-component assembly to reconcile and return</span>
+    <span class=n>new_by_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_by_comp</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>incoming_inherited</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inherited_dict</span><span class=p>:</span>
+            <span class=n>existing_statement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inherited_dict</span><span class=p>[</span><span class=nb>str</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>provided_uuid</span><span class=p>)]</span>
+            <span class=c1># Update the description if it has changed</span>
+            <span class=n>existing_statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>description</span>
+            <span class=n>statement</span> <span class=o>=</span> <span class=n>existing_statement</span>
+        <span class=n>new_inherited</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+
+    <span class=n>new_by_comp</span><span class=o>.</span><span class=n>inherited</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_inherited</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>incoming_satisfied</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>responsibility_uuid</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_satisfied_dict</span><span class=p>:</span>
+            <span class=n>existing_statement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_satisfied_dict</span><span class=p>[</span><span class=nb>str</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>responsibility_uuid</span><span class=p>)]</span>
+            <span class=c1># Update the description if it has changed</span>
+            <span class=n>existing_statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>statement</span><span class=o>.</span><span class=n>description</span>
+            <span class=n>statement</span> <span class=o>=</span> <span class=n>existing_statement</span>
+        <span class=n>new_satisfied</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+
+    <span class=n>new_by_comp</span><span class=o>.</span><span class=n>satisfied</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_satisfied</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>new_by_comp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.crm.bycomp_interface-functions>Functions<a href=#trestle.core.crm.bycomp_interface-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/crm/export_reader/index.html b/latest/reference/API/trestle/core/crm/export_reader/index.html
new file mode 100644
index 000000000..8a37bbeee
--- /dev/null
+++ b/latest/reference/API/trestle/core/crm/export_reader/index.html
@@ -0,0 +1,572 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.crm.export_reader module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/export_reader/ rel=canonical><link href=../bycomp_interface/ rel=prev><link href=../export_writer/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.crm.export_reader - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.crm.export_reader - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.crm.export_reader module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/export_reader.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/export_reader/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.crm.export_reader - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.crm.export_reader module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/export_reader.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.crm.export_reader class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28 checked> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.crm.export_reader </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader class=md-nav__link> <span class=md-ellipsis> export_reader </span> </a> <nav class=md-nav aria-label=export_reader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ByComponentDict class=md-nav__link> <span class=md-ellipsis> ByComponentDict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.InheritanceViewDict class=md-nav__link> <span class=md-ellipsis> InheritanceViewDict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader class=md-nav__link> <span class=md-ellipsis> ExportReader </span> </a> <nav class=md-nav aria-label=ExportReader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader.get_leveraged_components class=md-nav__link> <span class=md-ellipsis> get_leveraged_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader.get_leveraged_ssp_href class=md-nav__link> <span class=md-ellipsis> get_leveraged_ssp_href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader.read_exports_from_markdown class=md-nav__link> <span class=md-ellipsis> read_exports_from_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader class=md-nav__link> <span class=md-ellipsis> export_reader </span> </a> <nav class=md-nav aria-label=export_reader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ByComponentDict class=md-nav__link> <span class=md-ellipsis> ByComponentDict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.InheritanceViewDict class=md-nav__link> <span class=md-ellipsis> InheritanceViewDict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader class=md-nav__link> <span class=md-ellipsis> ExportReader </span> </a> <nav class=md-nav aria-label=ExportReader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader.get_leveraged_components class=md-nav__link> <span class=md-ellipsis> get_leveraged_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader.get_leveraged_ssp_href class=md-nav__link> <span class=md-ellipsis> get_leveraged_ssp_href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader.ExportReader.read_exports_from_markdown class=md-nav__link> <span class=md-ellipsis> read_exports_from_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_reader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.crm.export_reader</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.crm.export_reader class="doc doc-heading"> <code>trestle.core.crm.export_reader</code> <a href=#trestle.core.crm.export_reader class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Provided interface to read inheritance statements from Markdown.</p> <div class="doc doc-children"> <h3 id=trestle.core.crm.export_reader-attributes>Attributes<a href=#trestle.core.crm.export_reader-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.crm.export_reader.ByComponentDict class="doc doc-heading"> <code class="highlight language-python"><span class=n>ByComponentDict</span> <span class=o>=</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]]]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.crm.export_reader.ByComponentDict class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.crm.export_reader.InheritanceViewDict class="doc doc-heading"> <code class="highlight language-python"><span class=n>InheritanceViewDict</span> <span class=o>=</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ByComponentDict</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.crm.export_reader.InheritanceViewDict class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.crm.export_reader.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.crm.export_reader.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.crm.export_reader-classes>Classes<a href=#trestle.core.crm.export_reader-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.export_reader.ExportReader class="doc doc-heading"> <code>ExportReader</code> <a href=#trestle.core.crm.export_reader.ExportReader class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>By-Component Assembly Exports Markdown reader.</p> <p>Export reader handles all operations related to reading authored inherited and satisfied statements from exports in Markdown. The reader will read all the markdown files in the exports directory and update the SSP with the inheritance.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/export_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ExportReader</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    By-Component Assembly Exports Markdown reader.</span>
+
+<span class=sd>    Export reader handles all operations related to reading authored inherited and satisfied statements from exports</span>
+<span class=sd>    in Markdown. The reader will read all the markdown files in the exports directory and update the SSP with the</span>
+<span class=sd>    inheritance.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize export reader.</span>
+
+<span class=sd>        Arguments:</span>
+<span class=sd>            root_path: A root path object where an SSP&#39;s inheritance markdown is located.</span>
+<span class=sd>            ssp: A system security plan object that will be updated with the inheritance information.</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            The mapped components list is used to track which components have been mapped to controls in the markdown.</span>
+<span class=sd>            It can be retrieved with the get_leveraged_components method. This will be empty until the</span>
+<span class=sd>            read_exports_from_markdown method is called.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=n>ssp</span>
+
+        <span class=c1># Create a dictionary of implemented requirements keyed by control id for merging operations</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirements</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_impl_req_dict</span><span class=p>()</span>
+
+        <span class=c1># List of component titles that have been mapped to controls in the Markdown</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mapped_components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>root_path</span>
+
+    <span class=k>def</span> <span class=nf>_create_impl_req_dict</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create a dictionary of implemented requirements keyed by control id.&quot;&quot;&quot;</span>
+        <span class=n>impl_req_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>impl_req</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=n>impl_req_dict</span><span class=p>[</span><span class=n>impl_req</span><span class=o>.</span><span class=n>control_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>impl_req</span>
+        <span class=k>return</span> <span class=n>impl_req_dict</span>
+
+    <span class=k>def</span> <span class=nf>read_exports_from_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read inheritance markdown and update the SSP with the inheritance information.&quot;&quot;&quot;</span>
+        <span class=c1># Read the information from the markdown files into a dictionary for quick lookup</span>
+        <span class=n>markdown_dict</span><span class=p>:</span> <span class=n>InheritanceViewDict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_inheritance_markdown_directory</span><span class=p>()</span>
+
+        <span class=c1># Merge the markdown information into existing the implemented requirements</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_merge_exports_implemented_requirements</span><span class=p>(</span><span class=n>markdown_dict</span><span class=p>)</span>
+
+        <span class=c1># Process remaining markdown information that was not in the implemented requirements</span>
+        <span class=k>for</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>by_comp_dict</span> <span class=ow>in</span> <span class=n>markdown_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>by_comp_dict</span><span class=p>:</span>
+                <span class=n>logging</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Adding control mapping </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> to implemented requirements&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_mappings_to_implemented_requirements</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>by_comp_dict</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirements</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span>
+
+    <span class=k>def</span> <span class=nf>get_leveraged_ssp_href</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the href of the leveraged SSP from a markdown file.&quot;&quot;&quot;</span>
+        <span class=n>comp_dirs</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>listdir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>comp_dirs</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;No components were found in the markdown.&#39;</span><span class=p>)</span>
+
+        <span class=n>control_dirs</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>listdir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>comp_dirs</span><span class=p>[</span><span class=mi>0</span><span class=p>]))</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control_dirs</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;No controls were found in the markdown for component </span><span class=si>{comp_dirs[0]}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=n>control_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>comp_dirs</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>control_dirs</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+
+        <span class=n>files</span> <span class=o>=</span> <span class=p>[</span><span class=n>f</span> <span class=k>for</span> <span class=n>f</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>listdir</span><span class=p>(</span><span class=n>control_dir</span><span class=p>)</span> <span class=k>if</span> <span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>isfile</span><span class=p>(</span><span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>control_dir</span><span class=p>,</span> <span class=n>f</span><span class=p>))]</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>files</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No files were found in the markdown for control </span><span class=si>{</span><span class=n>control_dirs</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=n>markdown_file_path</span> <span class=o>=</span> <span class=n>control_dir</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>files</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+        <span class=n>reader</span> <span class=o>=</span> <span class=n>InheritanceMarkdownReader</span><span class=p>(</span><span class=n>markdown_file_path</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>reader</span><span class=o>.</span><span class=n>get_leveraged_ssp_reference</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>get_leveraged_components</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get a list of component titles that have been mapped to controls in the Markdown.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_mapped_components</span>
+
+    <span class=k>def</span> <span class=nf>_merge_exports_implemented_requirements</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>markdown_dict</span><span class=p>:</span> <span class=n>InheritanceViewDict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge all exported inheritance info from the markdown into the implemented requirement dict.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>implemented_requirement</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirements</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+
+            <span class=c1># If the control id existing in the markdown, then update the by_components</span>
+            <span class=k>if</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span> <span class=ow>in</span> <span class=n>markdown_dict</span><span class=p>:</span>
+
+                <span class=c1># Delete the entry from the markdown_dict once processed to avoid duplicates</span>
+                <span class=n>by_comp_dict</span><span class=p>:</span> <span class=n>ByComponentDict</span> <span class=o>=</span> <span class=n>markdown_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+
+                <span class=bp>self</span><span class=o>.</span><span class=n>_update_type_with_by_comp</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>,</span> <span class=n>by_comp_dict</span><span class=p>)</span>
+
+            <span class=c1># Update any implemented requirements statements assemblies</span>
+            <span class=n>new_statements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+            <span class=k>for</span> <span class=n>stm</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=n>statement_id</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>stm</span><span class=p>,</span> <span class=s1>&#39;statement_id&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>_smt&#39;</span><span class=p>)</span>
+
+                <span class=c1># If the statement id existing in the markdown, then update the by_components</span>
+                <span class=k>if</span> <span class=n>statement_id</span> <span class=ow>in</span> <span class=n>markdown_dict</span><span class=p>:</span>
+
+                    <span class=c1># Delete the entry from the markdown_dict once processed to avoid duplicates</span>
+                    <span class=n>by_comp_dict</span><span class=p>:</span> <span class=n>ByComponentDict</span> <span class=o>=</span> <span class=n>markdown_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>statement_id</span><span class=p>)</span>
+
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_update_type_with_by_comp</span><span class=p>(</span><span class=n>stm</span><span class=p>,</span> <span class=n>by_comp_dict</span><span class=p>)</span>
+
+                <span class=n>new_statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>stm</span><span class=p>)</span>
+
+            <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_statements</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_update_type_with_by_comp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>with_bycomp</span><span class=p>:</span> <span class=n>TypeWithByComps</span><span class=p>,</span> <span class=n>by_comp_dict</span><span class=p>:</span> <span class=n>ByComponentDict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update the by_components for a type with by_components.&quot;&quot;&quot;</span>
+        <span class=n>new_by_comp</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=n>by_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span>
+        <span class=n>comp_inheritance_info</span><span class=p>:</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]]</span>
+        <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>with_bycomp</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+
+            <span class=c1># If the by_component uuid exists in the by_comp_dict, then update it</span>
+            <span class=c1># If not, clear the by_component inheritance information</span>
+            <span class=n>comp_inheritance_info</span> <span class=o>=</span> <span class=n>by_comp_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span><span class=p>,</span> <span class=p>([],</span> <span class=p>[]))</span>
+
+            <span class=n>bycomp_interface</span> <span class=o>=</span> <span class=n>ByComponentInterface</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+            <span class=n>by_comp</span> <span class=o>=</span> <span class=n>bycomp_interface</span><span class=o>.</span><span class=n>reconcile_inheritance_by_component</span><span class=p>(</span>
+                <span class=n>comp_inheritance_info</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>comp_inheritance_info</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=p>)</span>
+
+            <span class=n>new_by_comp</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+
+        <span class=c1># Add any new by_components that were not in the original statement</span>
+        <span class=n>new_by_comp</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ExportReader</span><span class=o>.</span><span class=n>_add_new_by_comps</span><span class=p>(</span><span class=n>by_comp_dict</span><span class=p>))</span>
+        <span class=n>with_bycomp</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_by_comp</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_control_mappings_to_implemented_requirements</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control_mapping</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>by_comps</span><span class=p>:</span> <span class=n>ByComponentDict</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add control mappings to implemented requirements.&quot;&quot;&quot;</span>
+        <span class=c1># Determine if the control id is actually a statement id</span>
+        <span class=k>if</span> <span class=s1>&#39;_smt.&#39;</span> <span class=ow>in</span> <span class=n>control_mapping</span><span class=p>:</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=n>control_mapping</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;_smt&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>implemented_req</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_add_or_get_implemented_requirement</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=n>statement</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>)</span>
+            <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=o>=</span> <span class=n>control_mapping</span>
+            <span class=n>statement</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>ExportReader</span><span class=o>.</span><span class=n>_add_new_by_comps</span><span class=p>(</span><span class=n>by_comps</span><span class=p>)</span>
+            <span class=n>implemented_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_req</span><span class=o>.</span><span class=n>statements</span><span class=p>)</span>
+            <span class=n>implemented_req</span><span class=o>.</span><span class=n>statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+            <span class=n>implemented_req</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>implemented_req</span><span class=o>.</span><span class=n>statements</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>x</span><span class=p>:</span> <span class=n>x</span><span class=o>.</span><span class=n>statement_id</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>implemented_req</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_add_or_get_implemented_requirement</span><span class=p>(</span><span class=n>control_mapping</span><span class=p>)</span>
+            <span class=n>implemented_req</span><span class=o>.</span><span class=n>by_components</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_req</span><span class=o>.</span><span class=n>by_components</span><span class=p>)</span>
+            <span class=n>implemented_req</span><span class=o>.</span><span class=n>by_components</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>ExportReader</span><span class=o>.</span><span class=n>_add_new_by_comps</span><span class=p>(</span><span class=n>by_comps</span><span class=p>))</span>
+
+    <span class=k>def</span> <span class=nf>_add_or_get_implemented_requirement</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add or get implemented requirement from implemented requirements dictionary.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>control_id</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirements</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirements</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span>
+
+        <span class=n>implemented_requirement</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>)</span>
+        <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=n>control_id</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirements</span><span class=p>[</span><span class=n>control_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>implemented_requirement</span>
+        <span class=k>return</span> <span class=n>implemented_requirement</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_new_by_comps</span><span class=p>(</span><span class=n>by_comp_dict</span><span class=p>:</span> <span class=n>ByComponentDict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add new by_components to the implemented requirement.&quot;&quot;&quot;</span>
+        <span class=n>new_by_comp</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>comp_uuid</span><span class=p>,</span> <span class=n>inheritance_info</span> <span class=ow>in</span> <span class=n>by_comp_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>by_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>)</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=o>=</span> <span class=n>comp_uuid</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>inherited</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>inheritance_info</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+            <span class=n>by_comp</span><span class=o>.</span><span class=n>satisfied</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>inheritance_info</span><span class=p>[</span><span class=mi>1</span><span class=p>])</span>
+            <span class=n>new_by_comp</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>new_by_comp</span>
+
+    <span class=k>def</span> <span class=nf>_read_inheritance_markdown_directory</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>InheritanceViewDict</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read all inheritance markdown files and return a dictionary of all the information.&quot;&quot;&quot;</span>
+        <span class=n>markdown_dict</span><span class=p>:</span> <span class=n>InheritanceViewDict</span> <span class=o>=</span> <span class=p>{}</span>
+
+        <span class=c1># Creating a dictionary to find the component uuid by title for faster lookup</span>
+        <span class=n>uuid_by_title</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+            <span class=n>uuid_by_title</span><span class=p>[</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=p>]</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>uuid</span>
+
+        <span class=k>for</span> <span class=n>comp_dir</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>listdir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=p>):</span>
+            <span class=n>is_comp_leveraged</span> <span class=o>=</span> <span class=kc>False</span>
+            <span class=k>for</span> <span class=n>control_dir</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>listdir</span><span class=p>(</span><span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=p>,</span> <span class=n>comp_dir</span><span class=p>)):</span>
+                <span class=n>control_dir_path</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=p>,</span> <span class=n>comp_dir</span><span class=p>,</span> <span class=n>control_dir</span><span class=p>)</span>
+
+                <span class=c1># Initialize the by_component dictionary for the control directory</span>
+                <span class=c1># If it exists in the markdown dictionary, then update it with the new information</span>
+                <span class=n>by_comp_dict</span> <span class=o>=</span> <span class=n>markdown_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>control_dir</span><span class=p>,</span> <span class=p>{})</span>
+
+                <span class=k>for</span> <span class=n>file</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>listdir</span><span class=p>(</span><span class=n>control_dir_path</span><span class=p>):</span>
+                    <span class=n>file_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>control_dir_path</span><span class=p>)</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>file</span><span class=p>)</span>
+                    <span class=n>reader</span> <span class=o>=</span> <span class=n>InheritanceMarkdownReader</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+                    <span class=n>leveraged_info</span> <span class=o>=</span> <span class=n>reader</span><span class=o>.</span><span class=n>process_leveraged_statement_markdown</span><span class=p>()</span>
+
+                    <span class=c1># If there is no leveraged information, then skip this file</span>
+                    <span class=k>if</span> <span class=n>leveraged_info</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                        <span class=k>continue</span>
+
+                    <span class=c1># If a file has leveraged information, then set the flag to indicate the component is leveraged</span>
+                    <span class=n>is_comp_leveraged</span> <span class=o>=</span> <span class=kc>True</span>
+
+                    <span class=k>for</span> <span class=n>comp</span> <span class=ow>in</span> <span class=n>leveraged_info</span><span class=o>.</span><span class=n>leveraging_comp_titles</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>comp</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>uuid_by_title</span><span class=p>:</span>
+                            <span class=n>keys_as_string</span> <span class=o>=</span> <span class=s1>&#39;, &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>uuid_by_title</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+                            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                                <span class=sa>f</span><span class=s1>&#39;Component &quot;</span><span class=si>{</span><span class=n>comp</span><span class=si>}</span><span class=s1>&quot; does not exist in the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> SSP. &#39;</span>
+                                <span class=sa>f</span><span class=s1>&#39;Please use options: </span><span class=si>{</span><span class=n>keys_as_string</span><span class=si>}</span><span class=s1>.&#39;</span>
+                            <span class=p>)</span>
+
+                        <span class=n>comp_uuid</span> <span class=o>=</span> <span class=n>uuid_by_title</span><span class=p>[</span><span class=n>comp</span><span class=p>]</span>
+                        <span class=n>inherited</span><span class=p>,</span> <span class=n>satisfied</span> <span class=o>=</span> <span class=n>by_comp_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>comp_uuid</span><span class=p>,</span> <span class=p>([],</span> <span class=p>[]))</span>
+
+                        <span class=k>if</span> <span class=n>leveraged_info</span><span class=o>.</span><span class=n>inherited</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                            <span class=n>inherited</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>leveraged_info</span><span class=o>.</span><span class=n>inherited</span><span class=p>)</span>
+                        <span class=k>if</span> <span class=n>leveraged_info</span><span class=o>.</span><span class=n>satisfied</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                            <span class=n>satisfied</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>leveraged_info</span><span class=o>.</span><span class=n>satisfied</span><span class=p>)</span>
+
+                        <span class=n>by_comp_dict</span><span class=p>[</span><span class=n>comp_uuid</span><span class=p>]</span> <span class=o>=</span> <span class=p>(</span><span class=n>inherited</span><span class=p>,</span> <span class=n>satisfied</span><span class=p>)</span>
+
+                <span class=n>markdown_dict</span><span class=p>[</span><span class=n>control_dir</span><span class=p>]</span> <span class=o>=</span> <span class=n>by_comp_dict</span>
+
+            <span class=k>if</span> <span class=n>is_comp_leveraged</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_mapped_components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>comp_dir</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>markdown_dict</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.export_reader.ExportReader-functions>Functions<a href=#trestle.core.crm.export_reader.ExportReader-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.export_reader.ExportReader.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>root_path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>)</span></code> <a href=#trestle.core.crm.export_reader.ExportReader.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize export reader.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>root_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>A root path object where an SSP's inheritance markdown is located.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>ssp</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.ssp.SystemSecurityPlan href=../../../oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan>SystemSecurityPlan</a></code> </td> <td> <div class=doc-md-description> <p>A system security plan object that will be updated with the inheritance information.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>The mapped components list is used to track which components have been mapped to controls in the markdown. It can be retrieved with the get_leveraged_components method. This will be empty until the read_exports_from_markdown method is called.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/crm/export_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize export reader.</span>
+
+<span class=sd>    Arguments:</span>
+<span class=sd>        root_path: A root path object where an SSP&#39;s inheritance markdown is located.</span>
+<span class=sd>        ssp: A system security plan object that will be updated with the inheritance information.</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        The mapped components list is used to track which components have been mapped to controls in the markdown.</span>
+<span class=sd>        It can be retrieved with the get_leveraged_components method. This will be empty until the</span>
+<span class=sd>        read_exports_from_markdown method is called.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=n>ssp</span>
+
+    <span class=c1># Create a dictionary of implemented requirements keyed by control id for merging operations</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirements</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_impl_req_dict</span><span class=p>()</span>
+
+    <span class=c1># List of component titles that have been mapped to controls in the Markdown</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mapped_components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>root_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.export_reader.ExportReader.get_leveraged_components class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_leveraged_components</span><span class=p>()</span></code> <a href=#trestle.core.crm.export_reader.ExportReader.get_leveraged_components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get a list of component titles that have been mapped to controls in the Markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/export_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_leveraged_components</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get a list of component titles that have been mapped to controls in the Markdown.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_mapped_components</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.export_reader.ExportReader.get_leveraged_ssp_href class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_leveraged_ssp_href</span><span class=p>()</span></code> <a href=#trestle.core.crm.export_reader.ExportReader.get_leveraged_ssp_href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the href of the leveraged SSP from a markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/export_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_leveraged_ssp_href</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the href of the leveraged SSP from a markdown file.&quot;&quot;&quot;</span>
+    <span class=n>comp_dirs</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>listdir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=p>)</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>comp_dirs</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;No components were found in the markdown.&#39;</span><span class=p>)</span>
+
+    <span class=n>control_dirs</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>listdir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>comp_dirs</span><span class=p>[</span><span class=mi>0</span><span class=p>]))</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control_dirs</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;No controls were found in the markdown for component </span><span class=si>{comp_dirs[0]}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=n>control_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>comp_dirs</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>control_dirs</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+
+    <span class=n>files</span> <span class=o>=</span> <span class=p>[</span><span class=n>f</span> <span class=k>for</span> <span class=n>f</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>listdir</span><span class=p>(</span><span class=n>control_dir</span><span class=p>)</span> <span class=k>if</span> <span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>isfile</span><span class=p>(</span><span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>control_dir</span><span class=p>,</span> <span class=n>f</span><span class=p>))]</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>files</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No files were found in the markdown for control </span><span class=si>{</span><span class=n>control_dirs</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=n>markdown_file_path</span> <span class=o>=</span> <span class=n>control_dir</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>files</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+    <span class=n>reader</span> <span class=o>=</span> <span class=n>InheritanceMarkdownReader</span><span class=p>(</span><span class=n>markdown_file_path</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>reader</span><span class=o>.</span><span class=n>get_leveraged_ssp_reference</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.export_reader.ExportReader.read_exports_from_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_exports_from_markdown</span><span class=p>()</span></code> <a href=#trestle.core.crm.export_reader.ExportReader.read_exports_from_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read inheritance markdown and update the SSP with the inheritance information.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/export_reader.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>read_exports_from_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Read inheritance markdown and update the SSP with the inheritance information.&quot;&quot;&quot;</span>
+    <span class=c1># Read the information from the markdown files into a dictionary for quick lookup</span>
+    <span class=n>markdown_dict</span><span class=p>:</span> <span class=n>InheritanceViewDict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_inheritance_markdown_directory</span><span class=p>()</span>
+
+    <span class=c1># Merge the markdown information into existing the implemented requirements</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_merge_exports_implemented_requirements</span><span class=p>(</span><span class=n>markdown_dict</span><span class=p>)</span>
+
+    <span class=c1># Process remaining markdown information that was not in the implemented requirements</span>
+    <span class=k>for</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>by_comp_dict</span> <span class=ow>in</span> <span class=n>markdown_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>by_comp_dict</span><span class=p>:</span>
+            <span class=n>logging</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Adding control mapping </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> to implemented requirements&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_mappings_to_implemented_requirements</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>by_comp_dict</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirements</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.crm.export_reader-functions>Functions<a href=#trestle.core.crm.export_reader-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/crm/export_writer/index.html b/latest/reference/API/trestle/core/crm/export_writer/index.html
new file mode 100644
index 000000000..9a249992f
--- /dev/null
+++ b/latest/reference/API/trestle/core/crm/export_writer/index.html
@@ -0,0 +1,218 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.crm.export_writer module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/export_writer/ rel=canonical><link href=../export_reader/ rel=prev><link href=../leveraged_statements/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.crm.export_writer - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.crm.export_writer - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.crm.export_writer module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/export_writer.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/export_writer/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.crm.export_writer - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.crm.export_writer module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/export_writer.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.crm.export_writer class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28 checked> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.crm.export_writer </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer class=md-nav__link> <span class=md-ellipsis> export_writer </span> </a> <nav class=md-nav aria-label=export_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.ExportWriter class=md-nav__link> <span class=md-ellipsis> ExportWriter </span> </a> <nav class=md-nav aria-label=ExportWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.ExportWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.ExportWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.ExportWriter.write_exports_as_markdown class=md-nav__link> <span class=md-ellipsis> write_exports_as_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer class=md-nav__link> <span class=md-ellipsis> export_writer </span> </a> <nav class=md-nav aria-label=export_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.ExportWriter class=md-nav__link> <span class=md-ellipsis> ExportWriter </span> </a> <nav class=md-nav aria-label=ExportWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.ExportWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.ExportWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer.ExportWriter.write_exports_as_markdown class=md-nav__link> <span class=md-ellipsis> write_exports_as_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.export_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.crm.export_writer</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.crm.export_writer class="doc doc-heading"> <code>trestle.core.crm.export_writer</code> <a href=#trestle.core.crm.export_writer class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Provided interface to write provided and responsibility exports statements to Markdown.</p> <div class="doc doc-children"> <h3 id=trestle.core.crm.export_writer-attributes>Attributes<a href=#trestle.core.crm.export_writer-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.crm.export_writer.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.crm.export_writer.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.crm.export_writer-classes>Classes<a href=#trestle.core.crm.export_writer-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.export_writer.ExportWriter class="doc doc-heading"> <code>ExportWriter</code> <a href=#trestle.core.crm.export_writer.ExportWriter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>By-Component Assembly Exports writer.</p> <p>Export writer handles all operations related to writing provided and responsibility exported statements to Markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/export_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ExportWriter</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    By-Component Assembly Exports writer.</span>
+
+<span class=sd>    Export writer handles all operations related to writing provided and responsibility exported statements</span>
+<span class=sd>    to Markdown.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span> <span class=n>leveraged_ssp_href</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize export writer.</span>
+
+<span class=sd>        Arguments:</span>
+<span class=sd>            root_path: A root path object where all markdown files and directories should be written.</span>
+<span class=sd>            ssp: A system security plan with exports</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=n>ssp</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>root_path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_ssp_href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>leveraged_ssp_href</span>
+
+        <span class=c1># Find all the components and create paths for name</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_paths_by_comp</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_paths_by_comp</span><span class=p>[</span><span class=n>component</span><span class=o>.</span><span class=n>uuid</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>write_exports_as_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write export statement for leveraged SSP as the inheritance Markdown view.&quot;&quot;&quot;</span>
+        <span class=c1># Process all information under exports in control implementation</span>
+        <span class=k>for</span> <span class=n>implemented_requirement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_process_by_component</span><span class=p>(</span><span class=n>by_comp</span><span class=p>,</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+
+            <span class=k>for</span> <span class=n>stm</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=n>statement_id</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>stm</span><span class=p>,</span> <span class=s1>&#39;statement_id&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>_smt&#39;</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>stm</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_process_by_component</span><span class=p>(</span><span class=n>by_comp</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_process_by_component</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>by_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Complete the Markdown writing operations for each by-component assembly.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_paths_by_comp</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Component id </span><span class=si>{</span><span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span><span class=si>}</span><span class=s1> is not in the system implementation&#39;</span><span class=p>)</span>
+
+        <span class=n>comp_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_paths_by_comp</span><span class=p>[</span><span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span><span class=p>]</span>
+
+        <span class=n>export_interface</span><span class=p>:</span> <span class=n>ByComponentInterface</span> <span class=o>=</span> <span class=n>ByComponentInterface</span><span class=p>(</span><span class=n>by_comp</span><span class=o>=</span><span class=n>by_comp</span><span class=p>)</span>
+        <span class=n>leveraged_statements</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>LeveragedStatements</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_statement_types_from_exports</span><span class=p>(</span><span class=n>export_interface</span><span class=p>)</span>
+
+        <span class=c1># Only create the directory if leveraged statements exist. If not return.</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>leveraged_statements</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Component </span><span class=si>{</span><span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span><span class=si>}</span><span class=s1> has no exports for control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span>
+
+        <span class=n>control_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>comp_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=n>control_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>statement_file_path</span><span class=p>,</span> <span class=n>leveraged_stm</span> <span class=ow>in</span> <span class=n>leveraged_statements</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>statement_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>control_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>statement_file_path</span><span class=si>}{</span><span class=n>const</span><span class=o>.</span><span class=n>MARKDOWN_FILE_EXT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>leveraged_stm</span><span class=o>.</span><span class=n>write_statement_md</span><span class=p>(</span><span class=n>statement_path</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_statement_types_from_exports</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>export_interface</span><span class=p>:</span> <span class=n>ByComponentInterface</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>LeveragedStatements</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Process all exports and return a file basename and LeveragedStatement object for each.&quot;&quot;&quot;</span>
+        <span class=n>all_statements</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>LeveragedStatements</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+
+        <span class=k>for</span> <span class=n>responsibility</span> <span class=ow>in</span> <span class=n>export_interface</span><span class=o>.</span><span class=n>get_isolated_responsibilities</span><span class=p>():</span>
+            <span class=n>all_statements</span><span class=p>[</span><span class=n>responsibility</span><span class=o>.</span><span class=n>uuid</span><span class=p>]</span> <span class=o>=</span> <span class=n>StatementResponsibility</span><span class=p>(</span>
+                <span class=n>responsibility</span><span class=o>.</span><span class=n>uuid</span><span class=p>,</span> <span class=n>responsibility</span><span class=o>.</span><span class=n>description</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_ssp_href</span>
+            <span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>provided</span> <span class=ow>in</span> <span class=n>export_interface</span><span class=o>.</span><span class=n>get_isolated_provided</span><span class=p>():</span>
+            <span class=n>all_statements</span><span class=p>[</span><span class=n>provided</span><span class=o>.</span><span class=n>uuid</span>
+                           <span class=p>]</span> <span class=o>=</span> <span class=n>StatementProvided</span><span class=p>(</span><span class=n>provided</span><span class=o>.</span><span class=n>uuid</span><span class=p>,</span> <span class=n>provided</span><span class=o>.</span><span class=n>description</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_ssp_href</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>responsibility</span><span class=p>,</span> <span class=n>provided</span> <span class=ow>in</span> <span class=n>export_interface</span><span class=o>.</span><span class=n>get_export_sets</span><span class=p>():</span>
+            <span class=n>path</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>provided</span><span class=o>.</span><span class=n>uuid</span><span class=si>}</span><span class=s1>_</span><span class=si>{</span><span class=n>responsibility</span><span class=o>.</span><span class=n>uuid</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>all_statements</span><span class=p>[</span><span class=n>path</span><span class=p>]</span> <span class=o>=</span> <span class=n>StatementTree</span><span class=p>(</span>
+                <span class=n>provided</span><span class=o>.</span><span class=n>uuid</span><span class=p>,</span>
+                <span class=n>provided</span><span class=o>.</span><span class=n>description</span><span class=p>,</span>
+                <span class=n>responsibility</span><span class=o>.</span><span class=n>uuid</span><span class=p>,</span>
+                <span class=n>responsibility</span><span class=o>.</span><span class=n>description</span><span class=p>,</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_ssp_href</span>
+            <span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>all_statements</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.export_writer.ExportWriter-functions>Functions<a href=#trestle.core.crm.export_writer.ExportWriter-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.export_writer.ExportWriter.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>root_path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>,</span> <span class=n>leveraged_ssp_href</span><span class=p>)</span></code> <a href=#trestle.core.crm.export_writer.ExportWriter.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize export writer.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>root_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>A root path object where all markdown files and directories should be written.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>ssp</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.ssp.SystemSecurityPlan href=../../../oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan>SystemSecurityPlan</a></code> </td> <td> <div class=doc-md-description> <p>A system security plan with exports</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/crm/export_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span> <span class=n>leveraged_ssp_href</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize export writer.</span>
+
+<span class=sd>    Arguments:</span>
+<span class=sd>        root_path: A root path object where all markdown files and directories should be written.</span>
+<span class=sd>        ssp: A system security plan with exports</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=n>ssp</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>root_path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_ssp_href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>leveraged_ssp_href</span>
+
+    <span class=c1># Find all the components and create paths for name</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_paths_by_comp</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_paths_by_comp</span><span class=p>[</span><span class=n>component</span><span class=o>.</span><span class=n>uuid</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_root_path</span><span class=o>.</span><span class=n>joinpath</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>title</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.export_writer.ExportWriter.write_exports_as_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_exports_as_markdown</span><span class=p>()</span></code> <a href=#trestle.core.crm.export_writer.ExportWriter.write_exports_as_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write export statement for leveraged SSP as the inheritance Markdown view.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/export_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_exports_as_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write export statement for leveraged SSP as the inheritance Markdown view.&quot;&quot;&quot;</span>
+    <span class=c1># Process all information under exports in control implementation</span>
+    <span class=k>for</span> <span class=n>implemented_requirement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+        <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_process_by_component</span><span class=p>(</span><span class=n>by_comp</span><span class=p>,</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>stm</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+            <span class=n>statement_id</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>stm</span><span class=p>,</span> <span class=s1>&#39;statement_id&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>_smt&#39;</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>stm</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_process_by_component</span><span class=p>(</span><span class=n>by_comp</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.crm.export_writer-functions>Functions<a href=#trestle.core.crm.export_writer-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/crm/leveraged_statements/index.html b/latest/reference/API/trestle/core/crm/leveraged_statements/index.html
new file mode 100644
index 000000000..c17267c2b
--- /dev/null
+++ b/latest/reference/API/trestle/core/crm/leveraged_statements/index.html
@@ -0,0 +1,1009 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.crm.leveraged_statements module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/leveraged_statements/ rel=canonical><link href=../export_writer/ rel=prev><link href=../ssp_inheritance_api/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.crm.leveraged_statements - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.crm.leveraged_statements - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.crm.leveraged_statements module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/leveraged_statements.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/leveraged_statements/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.crm.leveraged_statements - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.crm.leveraged_statements module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/leveraged_statements.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.crm.leveraged_statements class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28 checked> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements class=md-nav__link> <span class=md-ellipsis> leveraged_statements </span> </a> <nav class=md-nav aria-label=leveraged_statements> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.component_mapping_default class=md-nav__link> <span class=md-ellipsis> component_mapping_default </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo class=md-nav__link> <span class=md-ellipsis> InheritanceInfo </span> </a> <nav class=md-nav aria-label=InheritanceInfo> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.inherited class=md-nav__link> <span class=md-ellipsis> inherited </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.leveraging_comp_titles class=md-nav__link> <span class=md-ellipsis> leveraging_comp_titles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.satisfied class=md-nav__link> <span class=md-ellipsis> satisfied </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader class=md-nav__link> <span class=md-ellipsis> InheritanceMarkdownReader </span> </a> <nav class=md-nav aria-label=InheritanceMarkdownReader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_component_header_value class=md-nav__link> <span class=md-ellipsis> get_leveraged_component_header_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_ssp_reference class=md-nav__link> <span class=md-ellipsis> get_leveraged_ssp_reference </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_provided_description class=md-nav__link> <span class=md-ellipsis> get_provided_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_satisfied_description class=md-nav__link> <span class=md-ellipsis> get_satisfied_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.process_leveraged_statement_markdown class=md-nav__link> <span class=md-ellipsis> process_leveraged_statement_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.strip_heading_and_comments class=md-nav__link> <span class=md-ellipsis> strip_heading_and_comments </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements class=md-nav__link> <span class=md-ellipsis> LeveragedStatements </span> </a> <nav class=md-nav aria-label=LeveragedStatements> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.header_comment_dict class=md-nav__link> <span class=md-ellipsis> header_comment_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.merged_header_dict class=md-nav__link> <span class=md-ellipsis> merged_header_dict </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.write_statement_md class=md-nav__link> <span class=md-ellipsis> write_statement_md </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided class=md-nav__link> <span class=md-ellipsis> StatementProvided </span> </a> <nav class=md-nav aria-label=StatementProvided> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.provided_description class=md-nav__link> <span class=md-ellipsis> provided_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.provided_uuid class=md-nav__link> <span class=md-ellipsis> provided_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.update_statement_md class=md-nav__link> <span class=md-ellipsis> update_statement_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.write_statement_md class=md-nav__link> <span class=md-ellipsis> write_statement_md </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility class=md-nav__link> <span class=md-ellipsis> StatementResponsibility </span> </a> <nav class=md-nav aria-label=StatementResponsibility> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_description class=md-nav__link> <span class=md-ellipsis> responsibility_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_uuid class=md-nav__link> <span class=md-ellipsis> responsibility_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.satisfied_description class=md-nav__link> <span class=md-ellipsis> satisfied_description </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.update_statement_md class=md-nav__link> <span class=md-ellipsis> update_statement_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.write_statement_md class=md-nav__link> <span class=md-ellipsis> write_statement_md </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree class=md-nav__link> <span class=md-ellipsis> StatementTree </span> </a> <nav class=md-nav aria-label=StatementTree> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.provided_description class=md-nav__link> <span class=md-ellipsis> provided_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.provided_uuid class=md-nav__link> <span class=md-ellipsis> provided_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.responsibility_description class=md-nav__link> <span class=md-ellipsis> responsibility_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.responsibility_uuid class=md-nav__link> <span class=md-ellipsis> responsibility_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.satisfied_description class=md-nav__link> <span class=md-ellipsis> satisfied_description </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.update_statement_md class=md-nav__link> <span class=md-ellipsis> update_statement_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.write_statement_md class=md-nav__link> <span class=md-ellipsis> write_statement_md </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements class=md-nav__link> <span class=md-ellipsis> leveraged_statements </span> </a> <nav class=md-nav aria-label=leveraged_statements> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.component_mapping_default class=md-nav__link> <span class=md-ellipsis> component_mapping_default </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo class=md-nav__link> <span class=md-ellipsis> InheritanceInfo </span> </a> <nav class=md-nav aria-label=InheritanceInfo> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.inherited class=md-nav__link> <span class=md-ellipsis> inherited </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.leveraging_comp_titles class=md-nav__link> <span class=md-ellipsis> leveraging_comp_titles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.satisfied class=md-nav__link> <span class=md-ellipsis> satisfied </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader class=md-nav__link> <span class=md-ellipsis> InheritanceMarkdownReader </span> </a> <nav class=md-nav aria-label=InheritanceMarkdownReader> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_component_header_value class=md-nav__link> <span class=md-ellipsis> get_leveraged_component_header_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_ssp_reference class=md-nav__link> <span class=md-ellipsis> get_leveraged_ssp_reference </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_provided_description class=md-nav__link> <span class=md-ellipsis> get_provided_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_satisfied_description class=md-nav__link> <span class=md-ellipsis> get_satisfied_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.process_leveraged_statement_markdown class=md-nav__link> <span class=md-ellipsis> process_leveraged_statement_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.strip_heading_and_comments class=md-nav__link> <span class=md-ellipsis> strip_heading_and_comments </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements class=md-nav__link> <span class=md-ellipsis> LeveragedStatements </span> </a> <nav class=md-nav aria-label=LeveragedStatements> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.header_comment_dict class=md-nav__link> <span class=md-ellipsis> header_comment_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.merged_header_dict class=md-nav__link> <span class=md-ellipsis> merged_header_dict </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.write_statement_md class=md-nav__link> <span class=md-ellipsis> write_statement_md </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided class=md-nav__link> <span class=md-ellipsis> StatementProvided </span> </a> <nav class=md-nav aria-label=StatementProvided> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.provided_description class=md-nav__link> <span class=md-ellipsis> provided_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.provided_uuid class=md-nav__link> <span class=md-ellipsis> provided_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.update_statement_md class=md-nav__link> <span class=md-ellipsis> update_statement_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.write_statement_md class=md-nav__link> <span class=md-ellipsis> write_statement_md </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility class=md-nav__link> <span class=md-ellipsis> StatementResponsibility </span> </a> <nav class=md-nav aria-label=StatementResponsibility> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_description class=md-nav__link> <span class=md-ellipsis> responsibility_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_uuid class=md-nav__link> <span class=md-ellipsis> responsibility_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.satisfied_description class=md-nav__link> <span class=md-ellipsis> satisfied_description </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.update_statement_md class=md-nav__link> <span class=md-ellipsis> update_statement_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.write_statement_md class=md-nav__link> <span class=md-ellipsis> write_statement_md </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree class=md-nav__link> <span class=md-ellipsis> StatementTree </span> </a> <nav class=md-nav aria-label=StatementTree> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.provided_description class=md-nav__link> <span class=md-ellipsis> provided_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.provided_uuid class=md-nav__link> <span class=md-ellipsis> provided_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.responsibility_description class=md-nav__link> <span class=md-ellipsis> responsibility_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.responsibility_uuid class=md-nav__link> <span class=md-ellipsis> responsibility_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.satisfied_description class=md-nav__link> <span class=md-ellipsis> satisfied_description </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.update_statement_md class=md-nav__link> <span class=md-ellipsis> update_statement_md </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.leveraged_statements.StatementTree.write_statement_md class=md-nav__link> <span class=md-ellipsis> write_statement_md </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.crm.leveraged_statements</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.crm.leveraged_statements class="doc doc-heading"> <code>trestle.core.crm.leveraged_statements</code> <a href=#trestle.core.crm.leveraged_statements class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Handle writing of inherited statements to markdown.</p> <div class="doc doc-children"> <h3 id=trestle.core.crm.leveraged_statements-attributes>Attributes<a href=#trestle.core.crm.leveraged_statements-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.crm.leveraged_statements.component_mapping_default class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_mapping_default</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>}]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.component_mapping_default class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.crm.leveraged_statements.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.crm.leveraged_statements-classes>Classes<a href=#trestle.core.crm.leveraged_statements-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.leveraged_statements.InheritanceInfo class="doc doc-heading"> <code>InheritanceInfo</code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-dataclass"><code>dataclass</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class to capture component inheritance information.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@dataclass</span>
+<span class=k>class</span> <span class=nc>InheritanceInfo</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to capture component inheritance information.&quot;&quot;&quot;</span>
+
+    <span class=n>leveraging_comp_titles</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=n>inherited</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]</span>
+    <span class=n>satisfied</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.leveraged_statements.InheritanceInfo-attributes>Attributes<a href=#trestle.core.crm.leveraged_statements.InheritanceInfo-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceInfo.inherited class="doc doc-heading"> <code class="highlight language-python"><span class=n>inherited</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.inherited class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceInfo.leveraging_comp_titles class="doc doc-heading"> <code class="highlight language-python"><span class=n>leveraging_comp_titles</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.leveraging_comp_titles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceInfo.satisfied class="doc doc-heading"> <code class="highlight language-python"><span class=n>satisfied</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.satisfied class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.crm.leveraged_statements.InheritanceInfo-functions>Functions<a href=#trestle.core.crm.leveraged_statements.InheritanceInfo-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceInfo.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>leveraging_comp_titles</span><span class=p>,</span> <span class=n>inherited</span><span class=p>,</span> <span class=n>satisfied</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.InheritanceInfo.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.leveraged_statements.InheritanceMarkdownReader class="doc doc-heading"> <code>InheritanceMarkdownReader</code> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class to read leveraged statement information from Markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>InheritanceMarkdownReader</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to read leveraged statement information from Markdown.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+        <span class=c1># Save the file name for logging</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_statement_file</span> <span class=o>=</span> <span class=n>leveraged_statement_file</span>
+
+        <span class=n>md_api</span><span class=p>:</span> <span class=n>MarkdownAPI</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+
+        <span class=n>yaml_header</span><span class=p>,</span> <span class=n>inheritance_md</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=n>yaml_header</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_md</span><span class=p>:</span> <span class=n>DocsMarkdownNode</span> <span class=o>=</span> <span class=n>inheritance_md</span>
+
+    <span class=k>def</span> <span class=nf>process_leveraged_statement_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>InheritanceInfo</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Read inheritance information from Markdown.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Optional InheritanceInfo - A list of mapped component titles, an optional satisfied statement and an</span>
+<span class=sd>            optional inherited statement</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            Returns inheritance information in the context of the leveraging SSP. If no leveraging component titles are</span>
+<span class=sd>            mapped in the yaml header None will be returned. The satisfied and inherited fields are</span>
+<span class=sd>            generated and returned to added information to by-component assemblies for</span>
+<span class=sd>            the mapped leveraging components.</span>
+
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>leveraging_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>inherited_statement</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>satisfied_statement</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+
+        <span class=n>leveraging_comp_header_value</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span>
+
+        <span class=c1># If there are no mapped components, return early</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>leveraging_comp_header_value</span> <span class=ow>or</span> <span class=n>leveraging_comp_header_value</span> <span class=o>==</span> <span class=n>component_mapping_default</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>comp_dicts</span> <span class=ow>in</span> <span class=n>leveraging_comp_header_value</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>comp_title</span> <span class=ow>in</span> <span class=n>comp_dicts</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+                    <span class=n>leveraging_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>comp_title</span><span class=p>)</span>
+
+        <span class=n>statement_info</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>]</span>
+
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_UUID</span> <span class=ow>in</span> <span class=n>statement_info</span><span class=p>:</span>
+            <span class=c1># Set inherited</span>
+
+            <span class=n>provided_description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_provided_description</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>provided_description</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided statement cannot be empty in </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_statement_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>inherited_statement</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>)</span>
+
+            <span class=n>inherited_statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>provided_description</span>
+            <span class=n>inherited_statement</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=o>=</span> <span class=n>statement_info</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_UUID</span><span class=p>]</span>
+
+        <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>RESPONSIBILITY_UUID</span> <span class=ow>in</span> <span class=n>statement_info</span><span class=p>:</span>
+            <span class=c1># Set satisfied</span>
+            <span class=n>satisfied_description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_satisfied_description</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>satisfied_description</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Satisfied statement cannot be empty in </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_statement_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>satisfied_statement</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>)</span>
+
+            <span class=n>satisfied_statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>satisfied_description</span>
+            <span class=n>satisfied_statement</span><span class=o>.</span><span class=n>responsibility_uuid</span> <span class=o>=</span> <span class=n>statement_info</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>RESPONSIBILITY_UUID</span><span class=p>]</span>
+
+        <span class=k>return</span> <span class=n>InheritanceInfo</span><span class=p>(</span><span class=n>leveraging_comps</span><span class=p>,</span> <span class=n>inherited_statement</span><span class=p>,</span> <span class=n>satisfied_statement</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_leveraged_ssp_reference</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the leveraged SSP reference in the yaml header.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>][</span><span class=n>const</span><span class=o>.</span><span class=n>LEVERAGED_SSP</span><span class=p>][</span><span class=n>const</span><span class=o>.</span><span class=n>HREF</span><span class=p>]</span>
+
+    <span class=k>def</span> <span class=nf>get_satisfied_description</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the satisfied description in the Markdown.&quot;&quot;&quot;</span>
+        <span class=n>node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_md</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SATISFIED_STATEMENT_DESCRIPTION</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>node</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>strip_heading_and_comments</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>get_provided_description</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the provided description in the Markdown.&quot;&quot;&quot;</span>
+        <span class=n>node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_md</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_STATEMENT_DESCRIPTION</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>node</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>strip_heading_and_comments</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>get_leveraged_component_header_value</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide the leveraged component value in the yaml header.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>strip_heading_and_comments</span><span class=p>(</span><span class=n>markdown_text</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Remove the heading and comments from lines to get the multi-line paragraph.&quot;&quot;&quot;</span>
+        <span class=n>lines</span> <span class=o>=</span> <span class=n>markdown_text</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>non_heading_comment_lines</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>inside_heading</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=n>inside_comment</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>lines</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;#&#39;</span><span class=p>):</span>
+                <span class=n>inside_heading</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=k>elif</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;&lt;!--&#39;</span><span class=p>):</span>
+                <span class=n>inside_comment</span> <span class=o>=</span> <span class=kc>True</span>
+                <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>rstrip</span><span class=p>()</span><span class=o>.</span><span class=n>endswith</span><span class=p>(</span><span class=s1>&#39;--&gt;&#39;</span><span class=p>):</span>
+                    <span class=n>inside_comment</span> <span class=o>=</span> <span class=kc>False</span>
+                <span class=k>continue</span>
+            <span class=k>elif</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+                <span class=n>inside_heading</span> <span class=o>=</span> <span class=kc>False</span>
+                <span class=n>inside_comment</span> <span class=o>=</span> <span class=kc>False</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>inside_heading</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>inside_comment</span><span class=p>:</span>
+                <span class=n>non_heading_comment_lines</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+
+        <span class=n>stripped_markdown</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>non_heading_comment_lines</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>stripped_markdown</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.leveraged_statements.InheritanceMarkdownReader-functions>Functions<a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+    <span class=c1># Save the file name for logging</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_statement_file</span> <span class=o>=</span> <span class=n>leveraged_statement_file</span>
+
+    <span class=n>md_api</span><span class=p>:</span> <span class=n>MarkdownAPI</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+
+    <span class=n>yaml_header</span><span class=p>,</span> <span class=n>inheritance_md</span> <span class=o>=</span> <span class=n>md_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=n>yaml_header</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_md</span><span class=p>:</span> <span class=n>DocsMarkdownNode</span> <span class=o>=</span> <span class=n>inheritance_md</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_component_header_value class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_leveraged_component_header_value</span><span class=p>()</span></code> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_component_header_value class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide the leveraged component value in the yaml header.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_leveraged_component_header_value</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide the leveraged component value in the yaml header.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_ssp_reference class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_leveraged_ssp_reference</span><span class=p>()</span></code> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_ssp_reference class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the leveraged SSP reference in the yaml header.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_leveraged_ssp_reference</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the leveraged SSP reference in the yaml header.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>][</span><span class=n>const</span><span class=o>.</span><span class=n>LEVERAGED_SSP</span><span class=p>][</span><span class=n>const</span><span class=o>.</span><span class=n>HREF</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_provided_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_provided_description</span><span class=p>()</span></code> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_provided_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the provided description in the Markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_provided_description</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the provided description in the Markdown.&quot;&quot;&quot;</span>
+    <span class=n>node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_md</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_STATEMENT_DESCRIPTION</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>node</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>strip_heading_and_comments</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_satisfied_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_satisfied_description</span><span class=p>()</span></code> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_satisfied_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the satisfied description in the Markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_satisfied_description</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the satisfied description in the Markdown.&quot;&quot;&quot;</span>
+    <span class=n>node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_md</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SATISFIED_STATEMENT_DESCRIPTION</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>node</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>strip_heading_and_comments</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.process_leveraged_statement_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>process_leveraged_statement_markdown</span><span class=p>()</span></code> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.process_leveraged_statement_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read inheritance information from Markdown.</p> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Optional>Optional</span>[<a class="autorefs autorefs-internal" title=trestle.core.crm.leveraged_statements.InheritanceInfo href=#trestle.core.crm.leveraged_statements.InheritanceInfo>InheritanceInfo</a>]</code> </td> <td> <div class=doc-md-description> <p>Optional InheritanceInfo - A list of mapped component titles, an optional satisfied statement and an</p> </div> </td> </tr> <tr class=doc-section-item> <td> <code><span title=typing.Optional>Optional</span>[<a class="autorefs autorefs-internal" title=trestle.core.crm.leveraged_statements.InheritanceInfo href=#trestle.core.crm.leveraged_statements.InheritanceInfo>InheritanceInfo</a>]</code> </td> <td> <div class=doc-md-description> <p>optional inherited statement</p> </div> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>Returns inheritance information in the context of the leveraging SSP. If no leveraging component titles are mapped in the yaml header None will be returned. The satisfied and inherited fields are generated and returned to added information to by-component assemblies for the mapped leveraging components.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>process_leveraged_statement_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>InheritanceInfo</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Read inheritance information from Markdown.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Optional InheritanceInfo - A list of mapped component titles, an optional satisfied statement and an</span>
+<span class=sd>        optional inherited statement</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        Returns inheritance information in the context of the leveraging SSP. If no leveraging component titles are</span>
+<span class=sd>        mapped in the yaml header None will be returned. The satisfied and inherited fields are</span>
+<span class=sd>        generated and returned to added information to by-component assemblies for</span>
+<span class=sd>        the mapped leveraging components.</span>
+
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>leveraging_comps</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>inherited_statement</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>satisfied_statement</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=n>leveraging_comp_header_value</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span>
+
+    <span class=c1># If there are no mapped components, return early</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>leveraging_comp_header_value</span> <span class=ow>or</span> <span class=n>leveraging_comp_header_value</span> <span class=o>==</span> <span class=n>component_mapping_default</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>None</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>comp_dicts</span> <span class=ow>in</span> <span class=n>leveraging_comp_header_value</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>comp_title</span> <span class=ow>in</span> <span class=n>comp_dicts</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+                <span class=n>leveraging_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>comp_title</span><span class=p>)</span>
+
+    <span class=n>statement_info</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>]</span>
+
+    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_UUID</span> <span class=ow>in</span> <span class=n>statement_info</span><span class=p>:</span>
+        <span class=c1># Set inherited</span>
+
+        <span class=n>provided_description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_provided_description</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>provided_description</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided statement cannot be empty in </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_statement_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>inherited_statement</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>Inherited</span><span class=p>)</span>
+
+        <span class=n>inherited_statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>provided_description</span>
+        <span class=n>inherited_statement</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=o>=</span> <span class=n>statement_info</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_UUID</span><span class=p>]</span>
+
+    <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>RESPONSIBILITY_UUID</span> <span class=ow>in</span> <span class=n>statement_info</span><span class=p>:</span>
+        <span class=c1># Set satisfied</span>
+        <span class=n>satisfied_description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_satisfied_description</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>satisfied_description</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Satisfied statement cannot be empty in </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_statement_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>satisfied_statement</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>Satisfied</span><span class=p>)</span>
+
+        <span class=n>satisfied_statement</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>satisfied_description</span>
+        <span class=n>satisfied_statement</span><span class=o>.</span><span class=n>responsibility_uuid</span> <span class=o>=</span> <span class=n>statement_info</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>RESPONSIBILITY_UUID</span><span class=p>]</span>
+
+    <span class=k>return</span> <span class=n>InheritanceInfo</span><span class=p>(</span><span class=n>leveraging_comps</span><span class=p>,</span> <span class=n>inherited_statement</span><span class=p>,</span> <span class=n>satisfied_statement</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.strip_heading_and_comments class="doc doc-heading"> <code class="highlight language-python"><span class=n>strip_heading_and_comments</span><span class=p>(</span><span class=n>markdown_text</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.strip_heading_and_comments class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Remove the heading and comments from lines to get the multi-line paragraph.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>strip_heading_and_comments</span><span class=p>(</span><span class=n>markdown_text</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove the heading and comments from lines to get the multi-line paragraph.&quot;&quot;&quot;</span>
+    <span class=n>lines</span> <span class=o>=</span> <span class=n>markdown_text</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>non_heading_comment_lines</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>inside_heading</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=n>inside_comment</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>lines</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;#&#39;</span><span class=p>):</span>
+            <span class=n>inside_heading</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>elif</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;&lt;!--&#39;</span><span class=p>):</span>
+            <span class=n>inside_comment</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>rstrip</span><span class=p>()</span><span class=o>.</span><span class=n>endswith</span><span class=p>(</span><span class=s1>&#39;--&gt;&#39;</span><span class=p>):</span>
+                <span class=n>inside_comment</span> <span class=o>=</span> <span class=kc>False</span>
+            <span class=k>continue</span>
+        <span class=k>elif</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+            <span class=n>inside_heading</span> <span class=o>=</span> <span class=kc>False</span>
+            <span class=n>inside_comment</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>inside_heading</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>inside_comment</span><span class=p>:</span>
+            <span class=n>non_heading_comment_lines</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+
+    <span class=n>stripped_markdown</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>non_heading_comment_lines</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>stripped_markdown</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.leveraged_statements.LeveragedStatements class="doc doc-heading"> <code>LeveragedStatements</code> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=abc.ABC>ABC</span></code></p> <p>Abstract class for managing leveraged statements.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LeveragedStatements</span><span class=p>(</span><span class=n>ABC</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Abstract class for managing leveraged statements.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>MDWriter</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>header_comment_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_LEVERAGING_COMP_COMMENT</span><span class=p>,</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_LEVERAGED_COMMENT</span>
+        <span class=p>}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>:</span> <span class=s1>&#39;&#39;</span><span class=p>,</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>:</span> <span class=n>component_mapping_default</span><span class=p>,</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>:</span> <span class=p>{</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>LEVERAGED_SSP</span><span class=p>:</span> <span class=p>{</span>
+                    <span class=n>const</span><span class=o>.</span><span class=n>HREF</span><span class=p>:</span> <span class=n>leveraged_ssp_reference</span>
+                <span class=p>}</span>
+            <span class=p>}</span>
+        <span class=p>}</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>write_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write inheritance information to a single markdown file.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.leveraged_statements.LeveragedStatements-attributes>Attributes<a href=#trestle.core.crm.leveraged_statements.LeveragedStatements-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.LeveragedStatements.header_comment_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>header_comment_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_LEVERAGING_COMP_COMMENT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_LEVERAGED_COMMENT</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.header_comment_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.LeveragedStatements.merged_header_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>merged_header_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>:</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>:</span> <span class=n>component_mapping_default</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>:</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>LEVERAGED_SSP</span><span class=p>:</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>HREF</span><span class=p>:</span> <span class=n>leveraged_ssp_reference</span><span class=p>}}}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.merged_header_dict class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.crm.leveraged_statements.LeveragedStatements-functions>Functions<a href=#trestle.core.crm.leveraged_statements.LeveragedStatements-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.LeveragedStatements.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>MDWriter</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>header_comment_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span>
+        <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_LEVERAGING_COMP_COMMENT</span><span class=p>,</span>
+        <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>YAML_LEVERAGED_COMMENT</span>
+    <span class=p>}</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span>
+        <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>:</span> <span class=s1>&#39;&#39;</span><span class=p>,</span>
+        <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>:</span> <span class=n>component_mapping_default</span><span class=p>,</span>
+        <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_GLOBAL_TAG</span><span class=p>:</span> <span class=p>{</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>LEVERAGED_SSP</span><span class=p>:</span> <span class=p>{</span>
+                <span class=n>const</span><span class=o>.</span><span class=n>HREF</span><span class=p>:</span> <span class=n>leveraged_ssp_reference</span>
+            <span class=p>}</span>
+        <span class=p>}</span>
+    <span class=p>}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.LeveragedStatements.write_statement_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.LeveragedStatements.write_statement_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write inheritance information to a single markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>write_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write inheritance information to a single markdown file.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.leveraged_statements.StatementProvided class="doc doc-heading"> <code>StatementProvided</code> <a href=#trestle.core.crm.leveraged_statements.StatementProvided class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.crm.leveraged_statements.LeveragedStatements href=#trestle.core.crm.leveraged_statements.LeveragedStatements>LeveragedStatements</a></code></p> <p>Concrete class for managing provided statements.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>StatementProvided</span><span class=p>(</span><span class=n>LeveragedStatements</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Concrete class for managing provided statements.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>provided_uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>provided_description</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=o>=</span> <span class=n>provided_uuid</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>provided_description</span> <span class=o>=</span> <span class=n>provided_description</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>write_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write provided statements to a markdown file.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>header_comment_dict</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>update_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>update_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update provided statements in a markdown file.&quot;&quot;&quot;</span>
+        <span class=n>md_reader</span> <span class=o>=</span> <span class=n>InheritanceMarkdownReader</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_leveraged_component_header_value</span><span class=p>()</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_add_generated_content</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_UUID</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>provided_uuid</span><span class=p>}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>add_yaml_header</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_STATEMENT_DESCRIPTION</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>provided_description</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.leveraged_statements.StatementProvided-attributes>Attributes<a href=#trestle.core.crm.leveraged_statements.StatementProvided-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementProvided.provided_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>provided_description</span> <span class=o>=</span> <span class=n>provided_description</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.provided_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementProvided.provided_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>provided_uuid</span> <span class=o>=</span> <span class=n>provided_uuid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.provided_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.crm.leveraged_statements.StatementProvided-functions>Functions<a href=#trestle.core.crm.leveraged_statements.StatementProvided-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.StatementProvided.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>provided_uuid</span><span class=p>,</span> <span class=n>provided_description</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>provided_uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>provided_description</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=o>=</span> <span class=n>provided_uuid</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>provided_description</span> <span class=o>=</span> <span class=n>provided_description</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.StatementProvided.update_statement_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>update_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.update_statement_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Update provided statements in a markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>update_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Update provided statements in a markdown file.&quot;&quot;&quot;</span>
+    <span class=n>md_reader</span> <span class=o>=</span> <span class=n>InheritanceMarkdownReader</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_leveraged_component_header_value</span><span class=p>()</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.StatementProvided.write_statement_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.StatementProvided.write_statement_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write provided statements to a markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write provided statements to a markdown file.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>header_comment_dict</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>update_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.leveraged_statements.StatementResponsibility class="doc doc-heading"> <code>StatementResponsibility</code> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.crm.leveraged_statements.LeveragedStatements href=#trestle.core.crm.leveraged_statements.LeveragedStatements>LeveragedStatements</a></code></p> <p>Concrete class for managing responsibility statements.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>StatementResponsibility</span><span class=p>(</span><span class=n>LeveragedStatements</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Concrete class for managing responsibility statements.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>responsibility_uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>responsibility_description</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_uuid</span> <span class=o>=</span> <span class=n>responsibility_uuid</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_description</span> <span class=o>=</span> <span class=n>responsibility_description</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>write_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write responsibility statements to a markdown file.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>header_comment_dict</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>update_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>update_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update responsibility statements in a markdown file.&quot;&quot;&quot;</span>
+        <span class=n>md_reader</span> <span class=o>=</span> <span class=n>InheritanceMarkdownReader</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_leveraged_component_header_value</span><span class=p>()</span>
+
+        <span class=n>satisfied_description</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_satisfied_description</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>satisfied_description</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span> <span class=o>=</span> <span class=n>satisfied_description</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_add_generated_content</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>RESPONSIBILITY_UUID</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_uuid</span><span class=p>}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>add_yaml_header</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>RESPONSIBILITY_STATEMENT_DESCRIPTION</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>responsibility_description</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>SATISFIED_STATEMENT_DESCRIPTION</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SATISFIED_STATEMENT_COMMENT</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.leveraged_statements.StatementResponsibility-attributes>Attributes<a href=#trestle.core.crm.leveraged_statements.StatementResponsibility-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsibility_description</span> <span class=o>=</span> <span class=n>responsibility_description</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsibility_uuid</span> <span class=o>=</span> <span class=n>responsibility_uuid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementResponsibility.satisfied_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>satisfied_description</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.satisfied_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.crm.leveraged_statements.StatementResponsibility-functions>Functions<a href=#trestle.core.crm.leveraged_statements.StatementResponsibility-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.StatementResponsibility.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>responsibility_uuid</span><span class=p>,</span> <span class=n>responsibility_description</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>responsibility_uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>responsibility_description</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_uuid</span> <span class=o>=</span> <span class=n>responsibility_uuid</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_description</span> <span class=o>=</span> <span class=n>responsibility_description</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.StatementResponsibility.update_statement_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>update_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.update_statement_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Update responsibility statements in a markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>update_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Update responsibility statements in a markdown file.&quot;&quot;&quot;</span>
+    <span class=n>md_reader</span> <span class=o>=</span> <span class=n>InheritanceMarkdownReader</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_leveraged_component_header_value</span><span class=p>()</span>
+
+    <span class=n>satisfied_description</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_satisfied_description</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>satisfied_description</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span> <span class=o>=</span> <span class=n>satisfied_description</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.StatementResponsibility.write_statement_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.StatementResponsibility.write_statement_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write responsibility statements to a markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write responsibility statements to a markdown file.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>header_comment_dict</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>update_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.leveraged_statements.StatementTree class="doc doc-heading"> <code>StatementTree</code> <a href=#trestle.core.crm.leveraged_statements.StatementTree class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.crm.leveraged_statements.LeveragedStatements href=#trestle.core.crm.leveraged_statements.LeveragedStatements>LeveragedStatements</a></code></p> <p>Concrete class for managing provided and responsibility statements.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>StatementTree</span><span class=p>(</span><span class=n>LeveragedStatements</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Concrete class for managing provided and responsibility statements.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>provided_uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>provided_description</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>responsibility_uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>responsibility_description</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=o>=</span> <span class=n>provided_uuid</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>provided_description</span> <span class=o>=</span> <span class=n>provided_description</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_uuid</span> <span class=o>=</span> <span class=n>responsibility_uuid</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_description</span> <span class=o>=</span> <span class=n>responsibility_description</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>write_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write a provided and responsibility statements to a markdown file.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>header_comment_dict</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>update_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>update_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update provided and responsibility statements in a markdown file.&quot;&quot;&quot;</span>
+        <span class=n>md_reader</span> <span class=o>=</span> <span class=n>InheritanceMarkdownReader</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_leveraged_component_header_value</span><span class=p>()</span>
+
+        <span class=n>satisfied_description</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_satisfied_description</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>satisfied_description</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span> <span class=o>=</span> <span class=n>satisfied_description</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_add_generated_content</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>statement_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_UUID</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>provided_uuid</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>RESPONSIBILITY_UUID</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_uuid</span>
+        <span class=p>}</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_STATEMENT_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>statement_dict</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>add_yaml_header</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>PROVIDED_STATEMENT_DESCRIPTION</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>provided_description</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>RESPONSIBILITY_STATEMENT_DESCRIPTION</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>responsibility_description</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>SATISFIED_STATEMENT_DESCRIPTION</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SATISFIED_STATEMENT_COMMENT</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.leveraged_statements.StatementTree-attributes>Attributes<a href=#trestle.core.crm.leveraged_statements.StatementTree-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementTree.provided_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>provided_description</span> <span class=o>=</span> <span class=n>provided_description</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementTree.provided_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementTree.provided_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>provided_uuid</span> <span class=o>=</span> <span class=n>provided_uuid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementTree.provided_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementTree.responsibility_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsibility_description</span> <span class=o>=</span> <span class=n>responsibility_description</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementTree.responsibility_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementTree.responsibility_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsibility_uuid</span> <span class=o>=</span> <span class=n>responsibility_uuid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementTree.responsibility_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.crm.leveraged_statements.StatementTree.satisfied_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>satisfied_description</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.crm.leveraged_statements.StatementTree.satisfied_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.crm.leveraged_statements.StatementTree-functions>Functions<a href=#trestle.core.crm.leveraged_statements.StatementTree-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.StatementTree.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>provided_uuid</span><span class=p>,</span> <span class=n>provided_description</span><span class=p>,</span> <span class=n>responsibility_uuid</span><span class=p>,</span> <span class=n>responsibility_description</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.StatementTree.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>provided_uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>provided_description</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>responsibility_uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>responsibility_description</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>provided_uuid</span> <span class=o>=</span> <span class=n>provided_uuid</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>provided_description</span> <span class=o>=</span> <span class=n>provided_description</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_uuid</span> <span class=o>=</span> <span class=n>responsibility_uuid</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>responsibility_description</span> <span class=o>=</span> <span class=n>responsibility_description</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.StatementTree.update_statement_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>update_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.StatementTree.update_statement_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Update provided and responsibility statements in a markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span>
+<span class=normal>98</span>
+<span class=normal>99</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>update_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Update provided and responsibility statements in a markdown file.&quot;&quot;&quot;</span>
+    <span class=n>md_reader</span> <span class=o>=</span> <span class=n>InheritanceMarkdownReader</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>merged_header_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_LEVERAGING_COMP_TAG</span><span class=p>]</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_leveraged_component_header_value</span><span class=p>()</span>
+
+    <span class=n>satisfied_description</span> <span class=o>=</span> <span class=n>md_reader</span><span class=o>.</span><span class=n>get_satisfied_description</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>satisfied_description</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>satisfied_description</span> <span class=o>=</span> <span class=n>satisfied_description</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.leveraged_statements.StatementTree.write_statement_md class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span></code> <a href=#trestle.core.crm.leveraged_statements.StatementTree.write_statement_md class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write a provided and responsibility statements to a markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/leveraged_statements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_statement_md</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_statement_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write a provided and responsibility statements to a markdown file.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>header_comment_dict</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>update_statement_md</span><span class=p>(</span><span class=n>leveraged_statement_file</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_generated_content</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/crm/ssp_inheritance_api/index.html b/latest/reference/API/trestle/core/crm/ssp_inheritance_api/index.html
new file mode 100644
index 000000000..b95fe18d2
--- /dev/null
+++ b/latest/reference/API/trestle/core/crm/ssp_inheritance_api/index.html
@@ -0,0 +1,467 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.crm.ssp_inheritance_api module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/ssp_inheritance_api/ rel=canonical><link href=../leveraged_statements/ rel=prev><link href=../../jinja/base/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.crm.ssp_inheritance_api - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.crm.ssp_inheritance_api - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.crm.ssp_inheritance_api module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/ssp_inheritance_api.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/ssp_inheritance_api/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.crm.ssp_inheritance_api - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.crm.ssp_inheritance_api module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/crm/ssp_inheritance_api.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.crm.ssp_inheritance_api class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28 checked> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api class=md-nav__link> <span class=md-ellipsis> ssp_inheritance_api </span> </a> <nav class=md-nav aria-label=ssp_inheritance_api> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI class=md-nav__link> <span class=md-ellipsis> SSPInheritanceAPI </span> </a> <nav class=md-nav aria-label=SSPInheritanceAPI> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.update_ssp_inheritance class=md-nav__link> <span class=md-ellipsis> update_ssp_inheritance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.write_inheritance_as_markdown class=md-nav__link> <span class=md-ellipsis> write_inheritance_as_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api class=md-nav__link> <span class=md-ellipsis> ssp_inheritance_api </span> </a> <nav class=md-nav aria-label=ssp_inheritance_api> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI class=md-nav__link> <span class=md-ellipsis> SSPInheritanceAPI </span> </a> <nav class=md-nav aria-label=SSPInheritanceAPI> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.update_ssp_inheritance class=md-nav__link> <span class=md-ellipsis> update_ssp_inheritance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.write_inheritance_as_markdown class=md-nav__link> <span class=md-ellipsis> write_inheritance_as_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.crm.ssp_inheritance_api-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.crm.ssp_inheritance_api</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.crm.ssp_inheritance_api class="doc doc-heading"> <code>trestle.core.crm.ssp_inheritance_api</code> <a href=#trestle.core.crm.ssp_inheritance_api class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>API for updating inheritance information in SSPs.</p> <div class="doc doc-children"> <h3 id=trestle.core.crm.ssp_inheritance_api-attributes>Attributes<a href=#trestle.core.crm.ssp_inheritance_api-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.crm.ssp_inheritance_api.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.crm.ssp_inheritance_api.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.crm.ssp_inheritance_api-classes>Classes<a href=#trestle.core.crm.ssp_inheritance_api-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI class="doc doc-heading"> <code>SSPInheritanceAPI</code> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>API for updating inheritance information in SSPs through inheritance markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/ssp_inheritance_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SSPInheritanceAPI</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;API for updating inheritance information in SSPs through inheritance markdown.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>inheritance_md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the SSP Inheritance API class.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_markdown_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>inheritance_md_path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>trestle_root</span>
+
+    <span class=k>def</span> <span class=nf>write_inheritance_as_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>catalog_api</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CatalogAPI</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Write inheritance information to markdown.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            leveraged_ssp_reference: Location of the SSP to write inheritance information from.</span>
+<span class=sd>            catalog_api: Catalog API to filter inheritance information by catalog.</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            If a catalog API is provided, the written controls in the markdown will be filtered by the catalog.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_fetch_leveraged_ssp</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>catalog_api</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>control_imp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ControlImplementation</span> <span class=o>=</span> <span class=n>leveraged_ssp</span><span class=o>.</span><span class=n>control_implementation</span>
+
+            <span class=n>new_imp_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>imp_requirement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+                <span class=n>control</span> <span class=o>=</span> <span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>imp_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>new_imp_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_requirement</span><span class=p>)</span>
+            <span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_requirements</span>
+
+            <span class=n>leveraged_ssp</span><span class=o>.</span><span class=n>control_implementation</span> <span class=o>=</span> <span class=n>control_imp</span>
+
+        <span class=n>export_writer</span><span class=p>:</span> <span class=n>ExportWriter</span> <span class=o>=</span> <span class=n>ExportWriter</span><span class=p>(</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_markdown_path</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span>
+        <span class=p>)</span>
+        <span class=n>export_writer</span><span class=o>.</span><span class=n>write_exports_as_markdown</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>update_ssp_inheritance</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Update inheritance information in SSP.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            ssp: SSP to update with inheritance information.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Reading inheritance information from markdown.&#39;</span><span class=p>)</span>
+        <span class=n>reader</span> <span class=o>=</span> <span class=n>ExportReader</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_markdown_path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>)</span>
+        <span class=n>ssp</span> <span class=o>=</span> <span class=n>reader</span><span class=o>.</span><span class=n>read_exports_from_markdown</span><span class=p>()</span>
+
+        <span class=n>leveraged_ssp_reference</span> <span class=o>=</span> <span class=n>reader</span><span class=o>.</span><span class=n>get_leveraged_ssp_href</span><span class=p>()</span>
+
+        <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_fetch_leveraged_ssp</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+
+        <span class=n>link</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Link</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>(</span><span class=n>href</span><span class=o>=</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+        <span class=n>leveraged_auths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>leveraged_auth</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span><span class=p>)</span>
+        <span class=n>leveraged_components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>reader</span><span class=o>.</span><span class=n>get_leveraged_components</span><span class=p>()</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>leveraged_components</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                <span class=s1>&#39;No leveraged components mapped to the SSP. &#39;</span>
+                <span class=s1>&#39;Please edit the inheritance markdown to include the leveraged authorization.&#39;</span>
+            <span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>existing_leveraged_auth</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_auth_from_existing</span><span class=p>(</span>
+                <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>leveraged_authorizations</span><span class=p>),</span> <span class=n>link</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=n>existing_leveraged_auth</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>leveraged_auth</span> <span class=o>=</span> <span class=n>existing_leveraged_auth</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>links</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>leveraged_auth</span><span class=o>.</span><span class=n>links</span><span class=p>)</span>
+                <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>links</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>link</span><span class=p>)</span>
+
+            <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Leveraged Authorization for </span><span class=si>{</span><span class=n>leveraged_ssp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>leveraged_auths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>leveraged_auth</span><span class=p>)</span>
+
+        <span class=c1># Overwrite the leveraged authorization in the SSP. The only leveraged authorization should be the one</span>
+        <span class=c1># coming from inheritance view</span>
+        <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>leveraged_authorizations</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>leveraged_auths</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_reconcile_components</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>leveraged_components</span><span class=p>,</span> <span class=n>leveraged_auth</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_fetch_leveraged_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Fetch the leveraged SSP.&quot;&quot;&quot;</span>
+        <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span>
+        <span class=n>fetcher</span> <span class=o>=</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_fetcher</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_trestle_root</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>fetcher</span><span class=o>.</span><span class=n>get_oscal</span><span class=p>()</span>
+        <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to fetch ssp from </span><span class=si>{</span><span class=n>leveraged_ssp_reference</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>leveraged_ssp</span>
+
+    <span class=k>def</span> <span class=nf>_reconcile_components</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+        <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>,</span>
+        <span class=n>leveraged_components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>leveraged_auth</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Reconcile components in the leveraging SSP with those in the leveraged SSP.&quot;&quot;&quot;</span>
+        <span class=n>mapped_components</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>leveraged_ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span> <span class=ow>in</span> <span class=n>leveraged_components</span><span class=p>:</span>
+                <span class=n>mapped_components</span><span class=p>[</span><span class=n>component</span><span class=o>.</span><span class=n>uuid</span><span class=p>]</span> <span class=o>=</span> <span class=n>component</span>
+
+        <span class=n>new_components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>):</span>
+            <span class=n>props_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>props</span><span class=p>)}</span>
+
+            <span class=c1># If this component is part of the original SSP components, add</span>
+            <span class=c1># and continue</span>
+            <span class=k>if</span> <span class=n>const</span><span class=o>.</span><span class=n>LEV_AUTH_UUID</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>props_dict</span><span class=p>:</span>
+                <span class=n>new_components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>component</span><span class=p>)</span>
+                <span class=k>continue</span>
+
+            <span class=c1># If the leveraged component already exists, update the title, description, type, and status</span>
+            <span class=n>original_comp_uuid</span> <span class=o>=</span> <span class=n>props_dict</span><span class=p>[</span><span class=n>const</span><span class=o>.</span><span class=n>INHERITED_UUID</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>original_comp_uuid</span> <span class=ow>in</span> <span class=n>mapped_components</span><span class=p>:</span>
+                <span class=n>original_component</span> <span class=o>=</span> <span class=n>mapped_components</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>original_comp_uuid</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_update_leveraged_system_component</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>original_component</span><span class=p>,</span> <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>uuid</span><span class=p>)</span>
+                <span class=n>new_components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>component</span><span class=p>)</span>
+
+        <span class=c1># Add any remaining components to the new components</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=n>mapped_components</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=n>new_component</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_update_leveraged_system_component</span><span class=p>(</span><span class=n>new_component</span><span class=p>,</span> <span class=n>component</span><span class=p>,</span> <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>uuid</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Adding component </span><span class=si>{</span><span class=n>new_component</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> to components.&#39;</span><span class=p>)</span>
+            <span class=n>new_components</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_component</span><span class=p>)</span>
+
+        <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span> <span class=o>=</span> <span class=n>new_components</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_update_leveraged_system_component</span><span class=p>(</span>
+        <span class=n>new_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>,</span> <span class=n>original_comp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>,</span> <span class=n>leveraged_auth_id</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create a leveraged system component in the context of a leveraging system component.&quot;&quot;&quot;</span>
+        <span class=n>new_comp</span><span class=o>.</span><span class=n>type</span> <span class=o>=</span> <span class=n>original_comp</span><span class=o>.</span><span class=n>type</span>
+        <span class=n>new_comp</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=n>original_comp</span><span class=o>.</span><span class=n>title</span>
+        <span class=n>new_comp</span><span class=o>.</span><span class=n>description</span> <span class=o>=</span> <span class=n>original_comp</span><span class=o>.</span><span class=n>description</span>
+        <span class=n>new_comp</span><span class=o>.</span><span class=n>status</span> <span class=o>=</span> <span class=n>original_comp</span><span class=o>.</span><span class=n>status</span>
+
+        <span class=n>new_comp</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_POINT</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>IMPLEMENTATION_POINT_EXTERNAL</span><span class=p>),</span>
+            <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>LEV_AUTH_UUID</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>leveraged_auth_id</span><span class=p>),</span>
+            <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>INHERITED_UUID</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>original_comp</span><span class=o>.</span><span class=n>uuid</span><span class=p>)</span>
+        <span class=p>]</span>
+
+    <span class=k>def</span> <span class=nf>_leveraged_auth_from_existing</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_authorizations</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span><span class=p>],</span> <span class=n>criteria_link</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Link</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the leveraged authorization if it is present in the ssp.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>leveraged_auth</span> <span class=ow>in</span> <span class=n>leveraged_authorizations</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>links</span> <span class=ow>and</span> <span class=nb>any</span><span class=p>(</span><span class=n>link</span><span class=o>.</span><span class=n>href</span> <span class=o>==</span> <span class=n>criteria_link</span><span class=o>.</span><span class=n>href</span> <span class=k>for</span> <span class=n>link</span> <span class=ow>in</span> <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>links</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>leveraged_auth</span>
+        <span class=k>return</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI-functions>Functions<a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>inheritance_md_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span></code> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the SSP Inheritance API class.</p> <details class=quote> <summary>Source code in <code>trestle/core/crm/ssp_inheritance_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>inheritance_md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the SSP Inheritance API class.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_markdown_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>inheritance_md_path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>trestle_root</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.update_ssp_inheritance class="doc doc-heading"> <code class="highlight language-python"><span class=n>update_ssp_inheritance</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span></code> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.update_ssp_inheritance class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Update inheritance information in SSP.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>ssp</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.ssp.SystemSecurityPlan href=../../../oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan>SystemSecurityPlan</a></code> </td> <td> <div class=doc-md-description> <p>SSP to update with inheritance information.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/crm/ssp_inheritance_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>update_ssp_inheritance</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Update inheritance information in SSP.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        ssp: SSP to update with inheritance information.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Reading inheritance information from markdown.&#39;</span><span class=p>)</span>
+    <span class=n>reader</span> <span class=o>=</span> <span class=n>ExportReader</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_markdown_path</span><span class=p>,</span> <span class=n>ssp</span><span class=p>)</span>
+    <span class=n>ssp</span> <span class=o>=</span> <span class=n>reader</span><span class=o>.</span><span class=n>read_exports_from_markdown</span><span class=p>()</span>
+
+    <span class=n>leveraged_ssp_reference</span> <span class=o>=</span> <span class=n>reader</span><span class=o>.</span><span class=n>get_leveraged_ssp_href</span><span class=p>()</span>
+
+    <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_fetch_leveraged_ssp</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+
+    <span class=n>link</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Link</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>(</span><span class=n>href</span><span class=o>=</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+    <span class=n>leveraged_auths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>leveraged_auth</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span> <span class=o>=</span> <span class=n>gens</span><span class=o>.</span><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span><span class=p>)</span>
+    <span class=n>leveraged_components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>reader</span><span class=o>.</span><span class=n>get_leveraged_components</span><span class=p>()</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>leveraged_components</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+            <span class=s1>&#39;No leveraged components mapped to the SSP. &#39;</span>
+            <span class=s1>&#39;Please edit the inheritance markdown to include the leveraged authorization.&#39;</span>
+        <span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>existing_leveraged_auth</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>LeveragedAuthorization</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_leveraged_auth_from_existing</span><span class=p>(</span>
+            <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>leveraged_authorizations</span><span class=p>),</span> <span class=n>link</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=n>existing_leveraged_auth</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>leveraged_auth</span> <span class=o>=</span> <span class=n>existing_leveraged_auth</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>links</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>leveraged_auth</span><span class=o>.</span><span class=n>links</span><span class=p>)</span>
+            <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>links</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>link</span><span class=p>)</span>
+
+        <span class=n>leveraged_auth</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Leveraged Authorization for </span><span class=si>{</span><span class=n>leveraged_ssp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=n>leveraged_auths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>leveraged_auth</span><span class=p>)</span>
+
+    <span class=c1># Overwrite the leveraged authorization in the SSP. The only leveraged authorization should be the one</span>
+    <span class=c1># coming from inheritance view</span>
+    <span class=n>ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>leveraged_authorizations</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>leveraged_auths</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_reconcile_components</span><span class=p>(</span><span class=n>ssp</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>leveraged_components</span><span class=p>,</span> <span class=n>leveraged_auth</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.write_inheritance_as_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_inheritance_as_markdown</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>,</span> <span class=n>catalog_api</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.write_inheritance_as_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write inheritance information to markdown.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>leveraged_ssp_reference</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Location of the SSP to write inheritance information from.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>catalog_api</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<a class="autorefs autorefs-internal" title=trestle.core.catalog.catalog_api.CatalogAPI href=../../catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI>CatalogAPI</a>]</code> </td> <td> <div class=doc-md-description> <p>Catalog API to filter inheritance information by catalog.</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>If a catalog API is provided, the written controls in the markdown will be filtered by the catalog.</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/crm/ssp_inheritance_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_inheritance_as_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>catalog_api</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CatalogAPI</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Write inheritance information to markdown.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        leveraged_ssp_reference: Location of the SSP to write inheritance information from.</span>
+<span class=sd>        catalog_api: Catalog API to filter inheritance information by catalog.</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        If a catalog API is provided, the written controls in the markdown will be filtered by the catalog.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_fetch_leveraged_ssp</span><span class=p>(</span><span class=n>leveraged_ssp_reference</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>catalog_api</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>control_imp</span><span class=p>:</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ControlImplementation</span> <span class=o>=</span> <span class=n>leveraged_ssp</span><span class=o>.</span><span class=n>control_implementation</span>
+
+        <span class=n>new_imp_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>imp_requirement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=n>catalog_api</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>imp_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>new_imp_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_requirement</span><span class=p>)</span>
+        <span class=n>control_imp</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>new_imp_requirements</span>
+
+        <span class=n>leveraged_ssp</span><span class=o>.</span><span class=n>control_implementation</span> <span class=o>=</span> <span class=n>control_imp</span>
+
+    <span class=n>export_writer</span><span class=p>:</span> <span class=n>ExportWriter</span> <span class=o>=</span> <span class=n>ExportWriter</span><span class=p>(</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_inheritance_markdown_path</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=p>,</span> <span class=n>leveraged_ssp_reference</span>
+    <span class=p>)</span>
+    <span class=n>export_writer</span><span class=o>.</span><span class=n>write_exports_as_markdown</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.crm.ssp_inheritance_api-functions>Functions<a href=#trestle.core.crm.ssp_inheritance_api-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/docs_control_writer/index.html b/latest/reference/API/trestle/core/docs_control_writer/index.html
new file mode 100644
index 000000000..7f5b1e3f6
--- /dev/null
+++ b/latest/reference/API/trestle/core/docs_control_writer/index.html
@@ -0,0 +1,629 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.docs_control_writer module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/docs_control_writer/ rel=canonical><link href=../control_writer/ rel=prev><link href=../draw_io/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.docs_control_writer - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.docs_control_writer - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.docs_control_writer module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/docs_control_writer.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/docs_control_writer/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.docs_control_writer - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.docs_control_writer module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/docs_control_writer.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.docs_control_writer class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.docs_control_writer </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer class=md-nav__link> <span class=md-ellipsis> docs_control_writer </span> </a> <nav class=md-nav aria-label=docs_control_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter class=md-nav__link> <span class=md-ellipsis> DocsControlWriter </span> </a> <nav class=md-nav aria-label=DocsControlWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter.get_control_statement_ssp class=md-nav__link> <span class=md-ellipsis> get_control_statement_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter.get_param_table class=md-nav__link> <span class=md-ellipsis> get_param_table </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter.write_control_with_sections class=md-nav__link> <span class=md-ellipsis> write_control_with_sections </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer class=md-nav__link> <span class=md-ellipsis> docs_control_writer </span> </a> <nav class=md-nav aria-label=docs_control_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter class=md-nav__link> <span class=md-ellipsis> DocsControlWriter </span> </a> <nav class=md-nav aria-label=DocsControlWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter.get_control_statement_ssp class=md-nav__link> <span class=md-ellipsis> get_control_statement_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter.get_param_table class=md-nav__link> <span class=md-ellipsis> get_param_table </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer.DocsControlWriter.write_control_with_sections class=md-nav__link> <span class=md-ellipsis> write_control_with_sections </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.docs_control_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.docs_control_writer</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.docs_control_writer class="doc doc-heading"> <code>trestle.core.docs_control_writer</code> <a href=#trestle.core.docs_control_writer class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Handle writing of controls to markdown for docs purposes.</p> <div class="doc doc-children"> <h3 id=trestle.core.docs_control_writer-attributes>Attributes<a href=#trestle.core.docs_control_writer-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.docs_control_writer.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.docs_control_writer.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.docs_control_writer-classes>Classes<a href=#trestle.core.docs_control_writer-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.docs_control_writer.DocsControlWriter class="doc doc-heading"> <code>DocsControlWriter</code> <a href=#trestle.core.docs_control_writer.DocsControlWriter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.control_writer.ControlWriter href=../control_writer/#trestle.core.control_writer.ControlWriter>ControlWriter</a></code></p> <p>Class to write controls as markdown for docs purposes.</p> <details class=quote> <summary>Source code in <code>trestle/core/docs_control_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 31</span>
+<span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DocsControlWriter</span><span class=p>(</span><span class=n>ControlWriter</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to write controls as markdown for docs purposes.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>write_control_with_sections</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+        <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span>
+        <span class=n>group_title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>label_column</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+        <span class=n>add_group_to_title</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write the control into markdown file with specified sections.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=o>=</span> <span class=n>sections_dict</span> <span class=k>if</span> <span class=n>sections_dict</span> <span class=k>else</span> <span class=p>{}</span>
+        <span class=n>tag_pattern</span> <span class=o>=</span> <span class=s1>&#39;{: #[.]}&#39;</span>  <span class=c1># noqa: FS003 - not f string but tag</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>group_title</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Group title must be provided and be a string, instead received: </span><span class=si>{</span><span class=n>group_title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>section</span> <span class=ow>in</span> <span class=n>sections</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;statement&#39;</span> <span class=o>==</span> <span class=n>section</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_statement</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>add_group_to_title</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=o>=</span><span class=n>tag_pattern</span><span class=p>)</span>
+
+            <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>OBJECTIVE_PART</span> <span class=o>==</span> <span class=n>section</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_objective</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=o>=</span><span class=n>tag_pattern</span><span class=p>)</span>
+
+            <span class=k>elif</span> <span class=s1>&#39;table_of_parameters&#39;</span> <span class=o>==</span> <span class=n>section</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>get_param_table</span><span class=p>(</span>
+                    <span class=n>control</span><span class=p>,</span> <span class=n>label_column</span><span class=p>,</span> <span class=n>section_dict</span><span class=o>=</span><span class=n>sections_dict</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=o>=</span><span class=n>tag_pattern</span><span class=p>,</span> <span class=n>md_file</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span>
+                <span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_one_section</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>profile</span><span class=p>,</span> <span class=n>section</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=o>=</span><span class=n>tag_pattern</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>_lines</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_control_statement_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the control statement as formatted markdown from a control formatted for SSP.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_statement_ssp</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>get_lines</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>get_param_table</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+        <span class=n>label_column</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>section_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>tag_pattern</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>md_file</span><span class=p>:</span> <span class=n>MDWriter</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parameters of a control as a markdown table for ssp_io, with optional third label column.&quot;&quot;&quot;</span>
+
+        <span class=k>def</span> <span class=nf>_get_displayname_if_exists</span><span class=p>(</span><span class=n>param_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>id</span> <span class=o>==</span> <span class=n>param_id</span><span class=p>):</span>
+                <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>):</span>
+                    <span class=k>return</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>return</span> <span class=n>param_id</span>
+
+        <span class=n>param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>param_dict</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>md_file</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>md_file</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+            <span class=n>header_title</span> <span class=o>=</span> <span class=s1>&#39;Table of Parameters&#39;</span>
+            <span class=k>if</span> <span class=n>section_dict</span><span class=p>:</span>
+                <span class=n>header_title</span> <span class=o>=</span> <span class=n>section_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TABLE_OF_PARAMS_PART</span><span class=p>,</span> <span class=s1>&#39;Table of Parameters&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>header_title</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=o>=</span><span class=ow>not</span> <span class=n>tag_pattern</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>tag_pattern</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>tag_pattern</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span> <span class=n>header_title</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>lower</span><span class=p>()))</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>label_column</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_table</span><span class=p>(</span>
+                    <span class=p>[</span>
+                        <span class=p>[</span>
+                            <span class=n>_get_displayname_if_exists</span><span class=p>(</span><span class=n>key</span><span class=p>),</span>
+                            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>param_to_str</span><span class=p>(</span><span class=n>param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_EMPTY_STRING</span><span class=p>),</span>
+                            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>param_to_str</span><span class=p>(</span><span class=n>param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LABEL_OR_CHOICES</span><span class=p>,</span> <span class=kc>True</span><span class=p>),</span>
+                        <span class=p>]</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span>
+                    <span class=p>],</span> <span class=p>[</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>,</span> <span class=s1>&#39;Values&#39;</span><span class=p>,</span> <span class=s1>&#39;Label or Choices&#39;</span><span class=p>]</span>
+                <span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_table</span><span class=p>(</span>
+                    <span class=p>[</span>
+                        <span class=p>[</span>
+                            <span class=n>_get_displayname_if_exists</span><span class=p>(</span><span class=n>key</span><span class=p>),</span>
+                            <span class=n>ControlInterface</span><span class=o>.</span><span class=n>param_to_str</span><span class=p>(</span><span class=n>param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_LABEL_OR_CHOICES</span><span class=p>)</span>
+                        <span class=p>]</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span>
+                    <span class=p>],</span> <span class=p>[</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>,</span> <span class=s1>&#39;Values&#39;</span><span class=p>]</span>
+                <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>tag_pattern</span><span class=p>:</span>
+                <span class=n>bottom_tag_pattern</span> <span class=o>=</span> <span class=s1>&#39;{: #</span><span class=se>\&quot;</span><span class=s1>Parameters for [.]</span><span class=se>\&quot;</span><span class=s1> caption-side=</span><span class=se>\&quot;</span><span class=s1>top</span><span class=se>\&quot;</span><span class=s1>}&#39;</span>  <span class=c1># noqa: FS003 - not f string</span>
+                <span class=n>control_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_pretty_control_id_if_exists</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>bottom_tag_pattern</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span> <span class=n>control_id</span><span class=p>))</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>get_lines</span><span class=p>()</span>
+
+        <span class=k>return</span> <span class=p>[]</span>
+
+    <span class=k>def</span> <span class=nf>_add_control_statement</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>group_title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>print_group_title</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add the control statement and items to the md file.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+
+        <span class=n>group_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>control_title</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>title</span>
+
+        <span class=k>if</span> <span class=n>print_group_title</span><span class=p>:</span>
+            <span class=n>group_name</span> <span class=o>=</span> <span class=s1>&#39; \[&#39;</span> <span class=o>+</span> <span class=n>group_title</span> <span class=o>+</span> <span class=s1>&#39;\]&#39;</span>
+
+        <span class=n>control_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_pretty_control_id_if_exists</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+        <span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> -</span><span class=si>{</span><span class=n>group_name</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>control_title</span><span class=si>}</span><span class=s1>&#39;</span>
+
+        <span class=n>header_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=s1>&#39;Control Statement&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=o>=</span><span class=ow>not</span> <span class=n>tag_pattern</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>tag_pattern</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>tag_pattern</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>))</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>header_title</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=o>=</span><span class=ow>not</span> <span class=n>tag_pattern</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>tag_pattern</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>tag_pattern</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span> <span class=n>header_title</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>lower</span><span class=p>()))</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_part_and_its_items</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_control_objective</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>OBJECTIVE_PART</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+                    <span class=n>heading_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>OBJECTIVE_PART</span><span class=p>,</span> <span class=s1>&#39;Control Objective&#39;</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>heading_title</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=o>=</span><span class=ow>not</span> <span class=n>tag_pattern</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>tag_pattern</span><span class=p>:</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>tag_pattern</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span> <span class=n>heading_title</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>lower</span><span class=p>()))</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_add_part_and_its_items</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>OBJECTIVE_PART</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>OBJECTIVE_PART</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+                    <span class=k>return</span>
+
+    <span class=k>def</span> <span class=nf>_add_one_section</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span> <span class=n>section</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add specific control section.&quot;&quot;&quot;</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_section_prose</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>section</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>prose</span><span class=p>:</span>
+            <span class=n>section_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>section</span><span class=p>,</span> <span class=n>section</span><span class=p>)</span>
+            <span class=n>heading_title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>section_title</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>heading_title</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=o>=</span><span class=ow>not</span> <span class=n>tag_pattern</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>tag_pattern</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>tag_pattern</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span> <span class=n>heading_title</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>lower</span><span class=p>()))</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>prose</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># write parts and subparts if exist</span>
+            <span class=n>part_infos</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_all_add_info</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=n>profile</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>part_info</span> <span class=ow>in</span> <span class=n>part_infos</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>part_info</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>section</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_write_part_info</span><span class=p>(</span><span class=n>part_info</span><span class=p>,</span> <span class=n>section</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=p>)</span>
+                    <span class=k>break</span>
+
+    <span class=k>def</span> <span class=nf>_write_part_info</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>part_info</span><span class=p>:</span> <span class=n>PartInfo</span><span class=p>,</span>
+        <span class=n>section_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>tag_pattern</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>section_prefix</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=p>,</span>
+        <span class=n>heading_level</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>2</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>section_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>section_name</span><span class=p>,</span> <span class=n>part_info</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+
+        <span class=n>heading_title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>section_title</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=n>tag_section_name</span> <span class=o>=</span> <span class=n>section_prefix</span> <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>section_title</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=n>tag_section_name</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>sub</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>tag_section_name</span><span class=p>)</span>
+        <span class=n>tag_section_name</span> <span class=o>=</span> <span class=n>tag_section_name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;_&#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=n>heading_level</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>heading_title</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=o>=</span><span class=ow>not</span> <span class=n>tag_pattern</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>tag_pattern</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>tag_pattern</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span> <span class=n>tag_section_name</span><span class=p>))</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=n>part_info</span><span class=o>.</span><span class=n>prose</span> <span class=ow>is</span> <span class=kc>None</span> <span class=k>else</span> <span class=n>part_info</span><span class=o>.</span><span class=n>prose</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>prose</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+
+        <span class=k>for</span> <span class=n>subpart_info</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part_info</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_write_part_info</span><span class=p>(</span>
+                <span class=n>subpart_info</span><span class=p>,</span> <span class=n>subpart_info</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=p>,</span> <span class=n>tag_section_name</span> <span class=o>+</span> <span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=n>heading_level</span> <span class=o>+</span> <span class=mi>1</span>
+            <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_pretty_control_id_if_exists</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=o>.</span><span class=n>upper</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=c1># Take control id from the properties</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;label&#39;</span><span class=p>:</span>
+                    <span class=n>control_id</span> <span class=o>=</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+                    <span class=k>break</span>
+        <span class=k>return</span> <span class=n>control_id</span>
+
+    <span class=k>def</span> <span class=nf>_add_control_statement_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add the control statement and items to the markdown SSP.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=n>label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+        <span class=n>label</span> <span class=o>=</span> <span class=n>label</span> <span class=k>if</span> <span class=n>label</span> <span class=k>else</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=o>.</span><span class=n>upper</span><span class=p>()</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>label</span><span class=si>}</span><span class=s1> - </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_part_and_its_items</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.docs_control_writer.DocsControlWriter-functions>Functions<a href=#trestle.core.docs_control_writer.DocsControlWriter-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.docs_control_writer.DocsControlWriter.get_control_statement_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_statement_ssp</span><span class=p>(</span><span class=n>control</span><span class=p>)</span></code> <a href=#trestle.core.docs_control_writer.DocsControlWriter.get_control_statement_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the control statement as formatted markdown from a control formatted for SSP.</p> <details class=quote> <summary>Source code in <code>trestle/core/docs_control_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_statement_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the control statement as formatted markdown from a control formatted for SSP.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_statement_ssp</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>get_lines</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.docs_control_writer.DocsControlWriter.get_param_table class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_param_table</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>label_column</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>section_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>md_file</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.docs_control_writer.DocsControlWriter.get_param_table class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get parameters of a control as a markdown table for ssp_io, with optional third label column.</p> <details class=quote> <summary>Source code in <code>trestle/core/docs_control_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_param_table</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+    <span class=n>label_column</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>section_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>tag_pattern</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>md_file</span><span class=p>:</span> <span class=n>MDWriter</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get parameters of a control as a markdown table for ssp_io, with optional third label column.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>_get_displayname_if_exists</span><span class=p>(</span><span class=n>param_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>id</span> <span class=o>==</span> <span class=n>param_id</span><span class=p>):</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>const</span><span class=o>.</span><span class=n>DISPLAY_NAME</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>return</span> <span class=n>param_id</span>
+
+    <span class=n>param_dict</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_control_param_dict</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>param_dict</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>md_file</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>md_file</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+        <span class=n>header_title</span> <span class=o>=</span> <span class=s1>&#39;Table of Parameters&#39;</span>
+        <span class=k>if</span> <span class=n>section_dict</span><span class=p>:</span>
+            <span class=n>header_title</span> <span class=o>=</span> <span class=n>section_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TABLE_OF_PARAMS_PART</span><span class=p>,</span> <span class=s1>&#39;Table of Parameters&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>header_title</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=o>=</span><span class=ow>not</span> <span class=n>tag_pattern</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>tag_pattern</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>tag_pattern</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span> <span class=n>header_title</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>lower</span><span class=p>()))</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>label_column</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_table</span><span class=p>(</span>
+                <span class=p>[</span>
+                    <span class=p>[</span>
+                        <span class=n>_get_displayname_if_exists</span><span class=p>(</span><span class=n>key</span><span class=p>),</span>
+                        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>param_to_str</span><span class=p>(</span><span class=n>param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_EMPTY_STRING</span><span class=p>),</span>
+                        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>param_to_str</span><span class=p>(</span><span class=n>param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LABEL_OR_CHOICES</span><span class=p>,</span> <span class=kc>True</span><span class=p>),</span>
+                    <span class=p>]</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span>
+                <span class=p>],</span> <span class=p>[</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>,</span> <span class=s1>&#39;Values&#39;</span><span class=p>,</span> <span class=s1>&#39;Label or Choices&#39;</span><span class=p>]</span>
+            <span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_table</span><span class=p>(</span>
+                <span class=p>[</span>
+                    <span class=p>[</span>
+                        <span class=n>_get_displayname_if_exists</span><span class=p>(</span><span class=n>key</span><span class=p>),</span>
+                        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>param_to_str</span><span class=p>(</span><span class=n>param_dict</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>VALUE_OR_LABEL_OR_CHOICES</span><span class=p>)</span>
+                    <span class=p>]</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>param_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span>
+                <span class=p>],</span> <span class=p>[</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>,</span> <span class=s1>&#39;Values&#39;</span><span class=p>]</span>
+            <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>tag_pattern</span><span class=p>:</span>
+            <span class=n>bottom_tag_pattern</span> <span class=o>=</span> <span class=s1>&#39;{: #</span><span class=se>\&quot;</span><span class=s1>Parameters for [.]</span><span class=se>\&quot;</span><span class=s1> caption-side=</span><span class=se>\&quot;</span><span class=s1>top</span><span class=se>\&quot;</span><span class=s1>}&#39;</span>  <span class=c1># noqa: FS003 - not f string</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_pretty_control_id_if_exists</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>bottom_tag_pattern</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[.]&#39;</span><span class=p>,</span> <span class=n>control_id</span><span class=p>))</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>get_lines</span><span class=p>()</span>
+
+    <span class=k>return</span> <span class=p>[]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.docs_control_writer.DocsControlWriter.write_control_with_sections class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_control_with_sections</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>profile</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>sections</span><span class=p>,</span> <span class=n>sections_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>label_column</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>add_group_to_title</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.docs_control_writer.DocsControlWriter.write_control_with_sections class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write the control into markdown file with specified sections.</p> <details class=quote> <summary>Source code in <code>trestle/core/docs_control_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_control_with_sections</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span>
+    <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span>
+    <span class=n>group_title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>sections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>sections_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>label_column</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+    <span class=n>add_group_to_title</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write the control into markdown file with specified sections.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_sections_dict</span> <span class=o>=</span> <span class=n>sections_dict</span> <span class=k>if</span> <span class=n>sections_dict</span> <span class=k>else</span> <span class=p>{}</span>
+    <span class=n>tag_pattern</span> <span class=o>=</span> <span class=s1>&#39;{: #[.]}&#39;</span>  <span class=c1># noqa: FS003 - not f string but tag</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>group_title</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Group title must be provided and be a string, instead received: </span><span class=si>{</span><span class=n>group_title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>section</span> <span class=ow>in</span> <span class=n>sections</span><span class=p>:</span>
+        <span class=k>if</span> <span class=s1>&#39;statement&#39;</span> <span class=o>==</span> <span class=n>section</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_statement</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>add_group_to_title</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=o>=</span><span class=n>tag_pattern</span><span class=p>)</span>
+
+        <span class=k>elif</span> <span class=n>const</span><span class=o>.</span><span class=n>OBJECTIVE_PART</span> <span class=o>==</span> <span class=n>section</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_control_objective</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=o>=</span><span class=n>tag_pattern</span><span class=p>)</span>
+
+        <span class=k>elif</span> <span class=s1>&#39;table_of_parameters&#39;</span> <span class=o>==</span> <span class=n>section</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>get_param_table</span><span class=p>(</span>
+                <span class=n>control</span><span class=p>,</span> <span class=n>label_column</span><span class=p>,</span> <span class=n>section_dict</span><span class=o>=</span><span class=n>sections_dict</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=o>=</span><span class=n>tag_pattern</span><span class=p>,</span> <span class=n>md_file</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span>
+            <span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_one_section</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>profile</span><span class=p>,</span> <span class=n>section</span><span class=p>,</span> <span class=n>tag_pattern</span><span class=o>=</span><span class=n>tag_pattern</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_md_file</span><span class=o>.</span><span class=n>_lines</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.docs_control_writer-functions>Functions<a href=#trestle.core.docs_control_writer-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/draw_io/index.html b/latest/reference/API/trestle/core/draw_io/index.html
new file mode 100644
index 000000000..cde7cc531
--- /dev/null
+++ b/latest/reference/API/trestle/core/draw_io/index.html
@@ -0,0 +1,707 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.draw_io module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/draw_io/ rel=canonical><link href=../docs_control_writer/ rel=prev><link href=../duplicates_validator/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.draw_io - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.draw_io - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.draw_io module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/draw_io.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/draw_io/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.draw_io - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.draw_io module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/draw_io.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.draw_io class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.draw_io </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.draw_io </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.draw_io </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.draw_io class=md-nav__link> <span class=md-ellipsis> draw_io </span> </a> <nav class=md-nav aria-label=draw_io> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO class=md-nav__link> <span class=md-ellipsis> DrawIO </span> </a> <nav class=md-nav aria-label=DrawIO> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.banned_keys class=md-nav__link> <span class=md-ellipsis> banned_keys </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.file_path class=md-nav__link> <span class=md-ellipsis> file_path </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.get_metadata class=md-nav__link> <span class=md-ellipsis> get_metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.restructure_metadata class=md-nav__link> <span class=md-ellipsis> restructure_metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.write_drawio_with_metadata class=md-nav__link> <span class=md-ellipsis> write_drawio_with_metadata </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator class=md-nav__link> <span class=md-ellipsis> DrawIOMetadataValidator </span> </a> <nav class=md-nav aria-label=DrawIOMetadataValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.must_be_first_tab class=md-nav__link> <span class=md-ellipsis> must_be_first_tab </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.template_metadata class=md-nav__link> <span class=md-ellipsis> template_metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.template_path class=md-nav__link> <span class=md-ellipsis> template_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.template_version class=md-nav__link> <span class=md-ellipsis> template_version </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.draw_io class=md-nav__link> <span class=md-ellipsis> draw_io </span> </a> <nav class=md-nav aria-label=draw_io> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO class=md-nav__link> <span class=md-ellipsis> DrawIO </span> </a> <nav class=md-nav aria-label=DrawIO> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.banned_keys class=md-nav__link> <span class=md-ellipsis> banned_keys </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.file_path class=md-nav__link> <span class=md-ellipsis> file_path </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.get_metadata class=md-nav__link> <span class=md-ellipsis> get_metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.restructure_metadata class=md-nav__link> <span class=md-ellipsis> restructure_metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIO.write_drawio_with_metadata class=md-nav__link> <span class=md-ellipsis> write_drawio_with_metadata </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator class=md-nav__link> <span class=md-ellipsis> DrawIOMetadataValidator </span> </a> <nav class=md-nav aria-label=DrawIOMetadataValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.must_be_first_tab class=md-nav__link> <span class=md-ellipsis> must_be_first_tab </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.template_metadata class=md-nav__link> <span class=md-ellipsis> template_metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.template_path class=md-nav__link> <span class=md-ellipsis> template_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.template_version class=md-nav__link> <span class=md-ellipsis> template_version </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.draw_io</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.draw_io class="doc doc-heading"> <code>trestle.core.draw_io</code> <a href=#trestle.core.draw_io class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Functionality for reading information from a drawio file.</p> <div class="doc doc-children"> <h3 id=trestle.core.draw_io-attributes>Attributes<a href=#trestle.core.draw_io-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.draw_io.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.draw_io.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.draw_io-classes>Classes<a href=#trestle.core.draw_io-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.draw_io.DrawIO class="doc doc-heading"> <code>DrawIO</code> <a href=#trestle.core.draw_io.DrawIO class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Access and process drawio data / metadata.</p> <details class=quote> <summary>Source code in <code>trestle/core/draw_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DrawIO</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Access and process drawio data / metadata.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Load drawio object into memory.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            file_path: Path to the drawio object.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>file_path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_load</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;id&#39;</span><span class=p>,</span> <span class=s1>&#39;label&#39;</span><span class=p>]</span>
+
+    <span class=k>def</span> <span class=nf>_load</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Load the file.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=bp>self</span><span class=o>.</span><span class=n>file_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Candidate drawio file </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>file_path</span><span class=p>)</span><span class=si>}</span><span class=s1> does not exist or is a directory&#39;</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>raw_xml</span> <span class=o>=</span> <span class=n>defusedxml</span><span class=o>.</span><span class=n>ElementTree</span><span class=o>.</span><span class=n>parse</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>file_path</span><span class=p>,</span> <span class=n>forbid_dtd</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Exception loading Element tree from file: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>mx_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>raw_xml</span><span class=o>.</span><span class=n>getroot</span><span class=p>()</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>mx_file</span><span class=o>.</span><span class=n>tag</span> <span class=o>==</span> <span class=s1>&#39;mxfile&#39;</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;DrawIO file is not a draw io file (mxfile)&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>diagrams</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>diagram</span> <span class=ow>in</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>mx_file</span><span class=p>):</span>
+            <span class=c1># Determine if compressed or not</span>
+            <span class=c1># Assumption 1 mxGraphModel</span>
+            <span class=n>n_children</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>diagram</span><span class=p>))</span>
+            <span class=k>if</span> <span class=n>n_children</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=c1># Compressed object</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>diagrams</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_uncompress</span><span class=p>(</span><span class=n>diagram</span><span class=o>.</span><span class=n>text</span><span class=p>))</span>
+            <span class=k>elif</span> <span class=n>n_children</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>diagrams</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>diagram</span><span class=p>)[</span><span class=mi>0</span><span class=p>])</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unhandled behaviour in drawio read.&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_uncompress</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>compressed_text</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Element</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Given a compressed object from a drawio file return an xml element for the mxGraphModel.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            compressed_text: A compressed mxGraphModel from inside an mxfile</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            An element containing the mxGraphModel</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># Assume b64 encode</span>
+        <span class=n>decoded</span> <span class=o>=</span> <span class=n>base64</span><span class=o>.</span><span class=n>b64decode</span><span class=p>(</span><span class=n>compressed_text</span><span class=p>)</span>
+        <span class=n>clean_text</span> <span class=o>=</span> <span class=n>unquote</span><span class=p>(</span><span class=n>zlib</span><span class=o>.</span><span class=n>decompress</span><span class=p>(</span><span class=n>decoded</span><span class=p>,</span> <span class=o>-</span><span class=mi>15</span><span class=p>)</span><span class=o>.</span><span class=n>decode</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>))</span>
+        <span class=n>element</span> <span class=o>=</span> <span class=n>defusedxml</span><span class=o>.</span><span class=n>ElementTree</span><span class=o>.</span><span class=n>fromstring</span><span class=p>(</span><span class=n>clean_text</span><span class=p>,</span> <span class=n>forbid_dtd</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>element</span><span class=o>.</span><span class=n>tag</span> <span class=o>==</span> <span class=s1>&#39;mxGraphModel&#39;</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unknown data structure within a compressed drawio file.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>element</span>
+
+    <span class=k>def</span> <span class=nf>get_metadata</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get metadata from each tab if it exists or provide an empty dict.&quot;&quot;&quot;</span>
+        <span class=c1># Note that id and label are special for drawio.</span>
+        <span class=n>md_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>diagram</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>diagrams</span><span class=p>:</span>
+            <span class=n>md_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=c1># Drawio creates data within a root and then an object element type</span>
+            <span class=n>children</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>diagram</span><span class=p>)</span>
+            <span class=n>root_obj</span> <span class=o>=</span> <span class=n>children</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>md_objects</span> <span class=o>=</span> <span class=n>root_obj</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=s1>&#39;object&#39;</span><span class=p>)</span>
+            <span class=c1># Should always be true - to test presumptions.</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>md_objects</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>md_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>md_dict</span><span class=p>)</span>
+                <span class=k>continue</span>
+            <span class=n>items</span> <span class=o>=</span> <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>()</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>items</span><span class=p>:</span>
+                <span class=n>key</span> <span class=o>=</span> <span class=n>item</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+                <span class=n>val</span> <span class=o>=</span> <span class=n>item</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+                <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>md_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>val</span>
+            <span class=n>md_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>md_dict</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>md_list</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>restructure_metadata</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>input_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Restructure metadata into a hierarchial dict assuming a period separator.&quot;&quot;&quot;</span>
+        <span class=c1># get the list of duplicate keys</span>
+        <span class=c1># Get a count of keys</span>
+        <span class=n>result</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>key_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>keys</span> <span class=ow>in</span> <span class=n>input_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>stub</span> <span class=o>=</span> <span class=n>keys</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>tmp</span> <span class=o>=</span> <span class=n>key_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>stub</span><span class=p>,</span> <span class=p>[])</span>
+            <span class=n>tmp</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>keys</span><span class=p>)</span>
+            <span class=n>key_map</span><span class=p>[</span><span class=n>stub</span><span class=p>]</span> <span class=o>=</span> <span class=n>tmp</span>
+
+        <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>values</span> <span class=ow>in</span> <span class=n>key_map</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>holding</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>values</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span> <span class=ow>and</span> <span class=n>key</span> <span class=o>==</span> <span class=n>values</span><span class=p>[</span><span class=mi>0</span><span class=p>]:</span>
+                <span class=n>result</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>input_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>values</span><span class=p>:</span>
+                    <span class=n>holding</span><span class=p>[</span><span class=n>value</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]]</span> <span class=o>=</span> <span class=n>input_dict</span><span class=p>[</span><span class=n>value</span><span class=p>]</span>
+                <span class=n>result</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>restructure_metadata</span><span class=p>(</span><span class=n>holding</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>result</span>
+
+    <span class=k>def</span> <span class=nf>write_drawio_with_metadata</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>metadata</span><span class=p>:</span> <span class=n>Dict</span><span class=p>,</span> <span class=n>diagram_metadata_idx</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>target_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Write modified metadata to drawio file.</span>
+
+<span class=sd>        Writes given metadata to &#39;object&#39; element attributes inside of the selected drawio diagram element.</span>
+<span class=sd>        Currently supports writing only uncompressed elements.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            path: path to write modified drawio file to</span>
+<span class=sd>            metadata: dictionary of modified metadata to insert to drawio</span>
+<span class=sd>            diagram_metadata_idx: index of diagram which metadata was modified</span>
+<span class=sd>            target_path: if not provided the changes will be written to path</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>flattened_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_flatten_dictionary</span><span class=p>(</span><span class=n>metadata</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>diagram_metadata_idx</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>diagrams</span><span class=p>)):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Drawio file </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> does not contain a diagram for index </span><span class=si>{</span><span class=n>diagram_metadata_idx</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>diagram</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>diagrams</span><span class=p>)[</span><span class=n>diagram_metadata_idx</span><span class=p>]</span>
+        <span class=n>children</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>diagram</span><span class=p>)</span>
+        <span class=n>root_obj</span> <span class=o>=</span> <span class=n>children</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>md_objects</span> <span class=o>=</span> <span class=n>root_obj</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=s1>&#39;object&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>md_objects</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to write metadata, diagram in drawio file </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> does not have objects.&#39;</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>attrib</span><span class=o>.</span><span class=n>copy</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>flattened_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=ow>and</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span><span class=p>:</span>
+                <span class=c1># outdated key delete</span>
+                <span class=k>del</span> <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>attrib</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>attrib</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>flattened_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>flattened_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>attrib</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>flattened_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+        <span class=n>parent_diagram</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>mx_file</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=s1>&#39;diagram&#39;</span><span class=p>)[</span><span class=n>diagram_metadata_idx</span><span class=p>]</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>parent_diagram</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=s1>&#39;mxGraphModel&#39;</span><span class=p>))</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>parent_diagram</span><span class=o>.</span><span class=n>insert</span><span class=p>(</span><span class=mi>0</span><span class=p>,</span> <span class=n>diagram</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>target_path</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>raw_xml</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>target_path</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>raw_xml</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_flatten_dictionary</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>metadata</span><span class=p>:</span> <span class=n>Dict</span><span class=p>,</span> <span class=n>parent_key</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>separator</span><span class=o>=</span><span class=s1>&#39;.&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Flatten hierarchial dict back to xml attributes.&quot;&quot;&quot;</span>
+        <span class=n>items</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>metadata</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=n>new_key</span> <span class=o>=</span> <span class=n>parent_key</span> <span class=o>+</span> <span class=n>separator</span> <span class=o>+</span> <span class=n>key</span> <span class=k>if</span> <span class=n>parent_key</span> <span class=k>else</span> <span class=n>key</span>
+            <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>value</span><span class=p>,</span> <span class=n>Dict</span><span class=p>):</span>
+                <span class=n>items</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_flatten_dictionary</span><span class=p>(</span><span class=n>value</span><span class=p>,</span> <span class=n>new_key</span><span class=p>,</span> <span class=n>separator</span><span class=p>)</span><span class=o>.</span><span class=n>items</span><span class=p>())</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>items</span><span class=o>.</span><span class=n>append</span><span class=p>((</span><span class=n>new_key</span><span class=p>,</span> <span class=n>value</span><span class=p>))</span>
+        <span class=k>return</span> <span class=nb>dict</span><span class=p>(</span><span class=n>items</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.draw_io.DrawIO-attributes>Attributes<a href=#trestle.core.draw_io.DrawIO-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.draw_io.DrawIO.banned_keys class="doc doc-heading"> <code class="highlight language-python"><span class=n>banned_keys</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;id&#39;</span><span class=p>,</span> <span class=s1>&#39;label&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.draw_io.DrawIO.banned_keys class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.draw_io.DrawIO.file_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>file_path</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.draw_io.DrawIO.file_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.draw_io.DrawIO-functions>Functions<a href=#trestle.core.draw_io.DrawIO-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.draw_io.DrawIO.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span></code> <a href=#trestle.core.draw_io.DrawIO.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Load drawio object into memory.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>file_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path to the drawio object.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/draw_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Load drawio object into memory.</span>
+
+<span class=sd>    args:</span>
+<span class=sd>        file_path: Path to the drawio object.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>file_path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_load</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;id&#39;</span><span class=p>,</span> <span class=s1>&#39;label&#39;</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.draw_io.DrawIO.get_metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_metadata</span><span class=p>()</span></code> <a href=#trestle.core.draw_io.DrawIO.get_metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get metadata from each tab if it exists or provide an empty dict.</p> <details class=quote> <summary>Source code in <code>trestle/core/draw_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_metadata</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get metadata from each tab if it exists or provide an empty dict.&quot;&quot;&quot;</span>
+    <span class=c1># Note that id and label are special for drawio.</span>
+    <span class=n>md_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>diagram</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>diagrams</span><span class=p>:</span>
+        <span class=n>md_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># Drawio creates data within a root and then an object element type</span>
+        <span class=n>children</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>diagram</span><span class=p>)</span>
+        <span class=n>root_obj</span> <span class=o>=</span> <span class=n>children</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>md_objects</span> <span class=o>=</span> <span class=n>root_obj</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=s1>&#39;object&#39;</span><span class=p>)</span>
+        <span class=c1># Should always be true - to test presumptions.</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>md_objects</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>md_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>md_dict</span><span class=p>)</span>
+            <span class=k>continue</span>
+        <span class=n>items</span> <span class=o>=</span> <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>items</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>items</span><span class=p>:</span>
+            <span class=n>key</span> <span class=o>=</span> <span class=n>item</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>val</span> <span class=o>=</span> <span class=n>item</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>md_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>val</span>
+        <span class=n>md_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>md_dict</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>md_list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.draw_io.DrawIO.restructure_metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>restructure_metadata</span><span class=p>(</span><span class=n>input_dict</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.draw_io.DrawIO.restructure_metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Restructure metadata into a hierarchial dict assuming a period separator.</p> <details class=quote> <summary>Source code in <code>trestle/core/draw_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>restructure_metadata</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>input_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Restructure metadata into a hierarchial dict assuming a period separator.&quot;&quot;&quot;</span>
+    <span class=c1># get the list of duplicate keys</span>
+    <span class=c1># Get a count of keys</span>
+    <span class=n>result</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>key_map</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>keys</span> <span class=ow>in</span> <span class=n>input_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=n>stub</span> <span class=o>=</span> <span class=n>keys</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>tmp</span> <span class=o>=</span> <span class=n>key_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>stub</span><span class=p>,</span> <span class=p>[])</span>
+        <span class=n>tmp</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>keys</span><span class=p>)</span>
+        <span class=n>key_map</span><span class=p>[</span><span class=n>stub</span><span class=p>]</span> <span class=o>=</span> <span class=n>tmp</span>
+
+    <span class=k>for</span> <span class=n>key</span><span class=p>,</span> <span class=n>values</span> <span class=ow>in</span> <span class=n>key_map</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+        <span class=n>holding</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>values</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span> <span class=ow>and</span> <span class=n>key</span> <span class=o>==</span> <span class=n>values</span><span class=p>[</span><span class=mi>0</span><span class=p>]:</span>
+            <span class=n>result</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>input_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>values</span><span class=p>:</span>
+                <span class=n>holding</span><span class=p>[</span><span class=n>value</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>)[</span><span class=o>-</span><span class=mi>1</span><span class=p>]]</span> <span class=o>=</span> <span class=n>input_dict</span><span class=p>[</span><span class=n>value</span><span class=p>]</span>
+            <span class=n>result</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>restructure_metadata</span><span class=p>(</span><span class=n>holding</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>result</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.draw_io.DrawIO.write_drawio_with_metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_drawio_with_metadata</span><span class=p>(</span><span class=n>path</span><span class=p>,</span> <span class=n>metadata</span><span class=p>,</span> <span class=n>diagram_metadata_idx</span><span class=p>,</span> <span class=n>target_path</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.draw_io.DrawIO.write_drawio_with_metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write modified metadata to drawio file.</p> <p>Writes given metadata to 'object' element attributes inside of the selected drawio diagram element. Currently supports writing only uncompressed elements.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>path to write modified drawio file to</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>metadata</code> </td> <td> <code><span title=typing.Dict>Dict</span></code> </td> <td> <div class=doc-md-description> <p>dictionary of modified metadata to insert to drawio</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>diagram_metadata_idx</code> </td> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>index of diagram which metadata was modified</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>target_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>if not provided the changes will be written to path</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/draw_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_drawio_with_metadata</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>metadata</span><span class=p>:</span> <span class=n>Dict</span><span class=p>,</span> <span class=n>diagram_metadata_idx</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>target_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Write modified metadata to drawio file.</span>
+
+<span class=sd>    Writes given metadata to &#39;object&#39; element attributes inside of the selected drawio diagram element.</span>
+<span class=sd>    Currently supports writing only uncompressed elements.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        path: path to write modified drawio file to</span>
+<span class=sd>        metadata: dictionary of modified metadata to insert to drawio</span>
+<span class=sd>        diagram_metadata_idx: index of diagram which metadata was modified</span>
+<span class=sd>        target_path: if not provided the changes will be written to path</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>flattened_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_flatten_dictionary</span><span class=p>(</span><span class=n>metadata</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>diagram_metadata_idx</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>diagrams</span><span class=p>)):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Drawio file </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> does not contain a diagram for index </span><span class=si>{</span><span class=n>diagram_metadata_idx</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>diagram</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>diagrams</span><span class=p>)[</span><span class=n>diagram_metadata_idx</span><span class=p>]</span>
+    <span class=n>children</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>diagram</span><span class=p>)</span>
+    <span class=n>root_obj</span> <span class=o>=</span> <span class=n>children</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+    <span class=n>md_objects</span> <span class=o>=</span> <span class=n>root_obj</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=s1>&#39;object&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>md_objects</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to write metadata, diagram in drawio file </span><span class=si>{</span><span class=n>path</span><span class=si>}</span><span class=s1> does not have objects.&#39;</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>attrib</span><span class=o>.</span><span class=n>copy</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>flattened_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=ow>and</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span><span class=p>:</span>
+            <span class=c1># outdated key delete</span>
+            <span class=k>del</span> <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>attrib</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+            <span class=k>continue</span>
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span><span class=p>:</span>
+            <span class=k>continue</span>
+        <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>attrib</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>flattened_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>flattened_dict</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>banned_keys</span><span class=p>:</span>
+            <span class=k>continue</span>
+        <span class=n>md_objects</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>attrib</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>flattened_dict</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+    <span class=n>parent_diagram</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>mx_file</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=s1>&#39;diagram&#39;</span><span class=p>)[</span><span class=n>diagram_metadata_idx</span><span class=p>]</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>parent_diagram</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=s1>&#39;mxGraphModel&#39;</span><span class=p>))</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=n>parent_diagram</span><span class=o>.</span><span class=n>insert</span><span class=p>(</span><span class=mi>0</span><span class=p>,</span> <span class=n>diagram</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>target_path</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>raw_xml</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>target_path</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>raw_xml</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.draw_io.DrawIOMetadataValidator class="doc doc-heading"> <code>DrawIOMetadataValidator</code> <a href=#trestle.core.draw_io.DrawIOMetadataValidator class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Validator to check whether drawio metadata meets validation expectations.</p> <details class=quote> <summary>Source code in <code>trestle/core/draw_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DrawIOMetadataValidator</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validator to check whether drawio metadata meets validation expectations.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>template_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>must_be_first_tab</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize drawio validator.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            template_path: Path to a templated drawio file where metadata will be looked up on the first tab only.</span>
+<span class=sd>            must_be_first_tab: Whether to search the candidate file for a metadata across multiple tabs.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_path</span> <span class=o>=</span> <span class=n>template_path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>must_be_first_tab</span> <span class=o>=</span> <span class=n>must_be_first_tab</span>
+        <span class=c1># Load metadat from template</span>
+        <span class=n>template_drawio</span> <span class=o>=</span> <span class=n>DrawIO</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=p>)</span>
+        <span class=c1># Zero index as must be first tab</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span> <span class=o>=</span> <span class=n>template_drawio</span><span class=o>.</span><span class=n>get_metadata</span><span class=p>()[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span> <span class=o>=</span> <span class=n>MarkdownValidator</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span> <span class=ow>not</span> <span class=ow>in</span> <span class=nb>str</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Version of the template </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1> does not match the path </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;Move the template to the folder </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+        <span class=k>if</span> <span class=s1>&#39;Version&#39;</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=p>[</span><span class=s1>&#39;Version&#39;</span><span class=p>]</span> <span class=o>!=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Version does not match template-version in template: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>validate</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>candidate</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Run drawio validation against a candidate file.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            candidate: The path to a candidate markdown file to be validated.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Whether or not the validation passes.</span>
+
+<span class=sd>        Raises:</span>
+<span class=sd>            err.TrestleError: If a file IO / formatting error occurs.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logging</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Validating drawio file </span><span class=si>{</span><span class=n>candidate</span><span class=si>}</span><span class=s1> against template file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>candidate_drawio</span> <span class=o>=</span> <span class=n>DrawIO</span><span class=p>(</span><span class=n>candidate</span><span class=p>)</span>
+        <span class=n>drawio_metadata</span> <span class=o>=</span> <span class=n>candidate_drawio</span><span class=o>.</span><span class=n>get_metadata</span><span class=p>()</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>must_be_first_tab</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>MarkdownValidator</span><span class=o>.</span><span class=n>compare_keys</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=p>,</span> <span class=n>drawio_metadata</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+        <span class=k>for</span> <span class=n>md_tab</span> <span class=ow>in</span> <span class=n>drawio_metadata</span><span class=p>:</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=n>MarkdownValidator</span><span class=o>.</span><span class=n>compare_keys</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=p>,</span> <span class=n>md_tab</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>status</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>status</span>
+        <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.draw_io.DrawIOMetadataValidator-attributes>Attributes<a href=#trestle.core.draw_io.DrawIOMetadataValidator-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.draw_io.DrawIOMetadataValidator.must_be_first_tab class="doc doc-heading"> <code class="highlight language-python"><span class=n>must_be_first_tab</span> <span class=o>=</span> <span class=n>must_be_first_tab</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.must_be_first_tab class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.draw_io.DrawIOMetadataValidator.template_metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_metadata</span> <span class=o>=</span> <span class=n>template_drawio</span><span class=o>.</span><span class=n>get_metadata</span><span class=p>()[</span><span class=mi>0</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.template_metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.draw_io.DrawIOMetadataValidator.template_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_path</span> <span class=o>=</span> <span class=n>template_path</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.template_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.draw_io.DrawIOMetadataValidator.template_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_version</span> <span class=o>=</span> <span class=n>MarkdownValidator</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.template_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.draw_io.DrawIOMetadataValidator-functions>Functions<a href=#trestle.core.draw_io.DrawIOMetadataValidator-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.draw_io.DrawIOMetadataValidator.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>template_path</span><span class=p>,</span> <span class=n>must_be_first_tab</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize drawio validator.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>template_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path to a templated drawio file where metadata will be looked up on the first tab only.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>must_be_first_tab</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether to search the candidate file for a metadata across multiple tabs.</p> </div> </td> <td> <code>True</code> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/draw_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>template_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>must_be_first_tab</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize drawio validator.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        template_path: Path to a templated drawio file where metadata will be looked up on the first tab only.</span>
+<span class=sd>        must_be_first_tab: Whether to search the candidate file for a metadata across multiple tabs.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>template_path</span> <span class=o>=</span> <span class=n>template_path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>must_be_first_tab</span> <span class=o>=</span> <span class=n>must_be_first_tab</span>
+    <span class=c1># Load metadat from template</span>
+    <span class=n>template_drawio</span> <span class=o>=</span> <span class=n>DrawIO</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=p>)</span>
+    <span class=c1># Zero index as must be first tab</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span> <span class=o>=</span> <span class=n>template_drawio</span><span class=o>.</span><span class=n>get_metadata</span><span class=p>()[</span><span class=mi>0</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span> <span class=o>=</span> <span class=n>MarkdownValidator</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span> <span class=ow>not</span> <span class=ow>in</span> <span class=nb>str</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Version of the template </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1> does not match the path </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>.&#39;</span>
+            <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;Move the template to the folder </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=p>)</span>
+    <span class=k>if</span> <span class=s1>&#39;Version&#39;</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=p>[</span><span class=s1>&#39;Version&#39;</span><span class=p>]</span> <span class=o>!=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Version does not match template-version in template: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.draw_io.DrawIOMetadataValidator.validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate</span><span class=p>(</span><span class=n>candidate</span><span class=p>)</span></code> <a href=#trestle.core.draw_io.DrawIOMetadataValidator.validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Run drawio validation against a candidate file.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>candidate</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>The path to a candidate markdown file to be validated.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether or not the validation passes.</p> </div> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Raises:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=err.TrestleError>TrestleError</span></code> </td> <td> <div class=doc-md-description> <p>If a file IO / formatting error occurs.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/draw_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>validate</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>candidate</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Run drawio validation against a candidate file.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        candidate: The path to a candidate markdown file to be validated.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        Whether or not the validation passes.</span>
+
+<span class=sd>    Raises:</span>
+<span class=sd>        err.TrestleError: If a file IO / formatting error occurs.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logging</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Validating drawio file </span><span class=si>{</span><span class=n>candidate</span><span class=si>}</span><span class=s1> against template file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>candidate_drawio</span> <span class=o>=</span> <span class=n>DrawIO</span><span class=p>(</span><span class=n>candidate</span><span class=p>)</span>
+    <span class=n>drawio_metadata</span> <span class=o>=</span> <span class=n>candidate_drawio</span><span class=o>.</span><span class=n>get_metadata</span><span class=p>()</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>must_be_first_tab</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>MarkdownValidator</span><span class=o>.</span><span class=n>compare_keys</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=p>,</span> <span class=n>drawio_metadata</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+    <span class=k>for</span> <span class=n>md_tab</span> <span class=ow>in</span> <span class=n>drawio_metadata</span><span class=p>:</span>
+        <span class=n>status</span> <span class=o>=</span> <span class=n>MarkdownValidator</span><span class=o>.</span><span class=n>compare_keys</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_metadata</span><span class=p>,</span> <span class=n>md_tab</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>status</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>status</span>
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/duplicates_validator/index.html b/latest/reference/API/trestle/core/duplicates_validator/index.html
new file mode 100644
index 000000000..60309cf61
--- /dev/null
+++ b/latest/reference/API/trestle/core/duplicates_validator/index.html
@@ -0,0 +1,77 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.duplicates_validator module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/duplicates_validator/ rel=canonical><link href=../draw_io/ rel=prev><link href=../generators/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.duplicates_validator - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.duplicates_validator - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.duplicates_validator module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/duplicates_validator.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/duplicates_validator/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.duplicates_validator - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.duplicates_validator module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/duplicates_validator.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.duplicates_validator class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.duplicates_validator </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator class=md-nav__link> <span class=md-ellipsis> duplicates_validator </span> </a> <nav class=md-nav aria-label=duplicates_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator.DuplicatesValidator class=md-nav__link> <span class=md-ellipsis> DuplicatesValidator </span> </a> <nav class=md-nav aria-label=DuplicatesValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator.DuplicatesValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator.DuplicatesValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator class=md-nav__link> <span class=md-ellipsis> duplicates_validator </span> </a> <nav class=md-nav aria-label=duplicates_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator.DuplicatesValidator class=md-nav__link> <span class=md-ellipsis> DuplicatesValidator </span> </a> <nav class=md-nav aria-label=DuplicatesValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator.DuplicatesValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.duplicates_validator.DuplicatesValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.duplicates_validator</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.duplicates_validator class="doc doc-heading"> <code>trestle.core.duplicates_validator</code> <a href=#trestle.core.duplicates_validator class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Validate by confirming no duplicate uuids.</p> <div class="doc doc-children"> <h3 id=trestle.core.duplicates_validator-classes>Classes<a href=#trestle.core.duplicates_validator-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.duplicates_validator.DuplicatesValidator class="doc doc-heading"> <code>DuplicatesValidator</code> <a href=#trestle.core.duplicates_validator.DuplicatesValidator class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.validator.Validator href=../validator/#trestle.core.validator.Validator>Validator</a></code></p> <p>Validator to check for duplicate uuids and param_ids in the model.</p> <details class=quote> <summary>Source code in <code>trestle/core/duplicates_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DuplicatesValidator</span><span class=p>(</span><span class=n>Validator</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validator to check for duplicate uuids and param_ids in the model.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Test if the model is valid and contains no duplicate uuids or param_ids.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            model: An Oscal model that can be passed to the validator.</span>
+<span class=sd>            quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>        returns:</span>
+<span class=sd>            True (valid) if the model does not contain duplicate uuid&#39;s.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>has_no_duplicate_values_by_name</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=s1>&#39;uuid&#39;</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=c1># only profile, comp-def and ssp have set-params and only set-params have param_id</span>
+        <span class=c1># param_id is required to be unique in profiles but not in other models</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>Profile</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>has_no_duplicate_values_by_name</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=s1>&#39;param_id&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.duplicates_validator.DuplicatesValidator-functions>Functions<a href=#trestle.core.duplicates_validator.DuplicatesValidator-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.duplicates_validator.DuplicatesValidator.model_is_valid class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.duplicates_validator.DuplicatesValidator.model_is_valid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Test if the model is valid and contains no duplicate uuids or param_ids.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code> </td> <td> <div class=doc-md-description> <p>An Oscal model that can be passed to the validator.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>quiet</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Don't report msgs unless invalid.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>True (valid) if the model does not contain duplicate uuid's.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/duplicates_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Test if the model is valid and contains no duplicate uuids or param_ids.</span>
+
+<span class=sd>    args:</span>
+<span class=sd>        model: An Oscal model that can be passed to the validator.</span>
+<span class=sd>        quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>    returns:</span>
+<span class=sd>        True (valid) if the model does not contain duplicate uuid&#39;s.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>has_no_duplicate_values_by_name</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=s1>&#39;uuid&#39;</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=c1># only profile, comp-def and ssp have set-params and only set-params have param_id</span>
+    <span class=c1># param_id is required to be unique in profiles but not in other models</span>
+    <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>Profile</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>has_no_duplicate_values_by_name</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=s1>&#39;param_id&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/generators/index.html b/latest/reference/API/trestle/core/generators/index.html
new file mode 100644
index 000000000..4e9b8822f
--- /dev/null
+++ b/latest/reference/API/trestle/core/generators/index.html
@@ -0,0 +1,396 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.generators module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/generators/ rel=canonical><link href=../duplicates_validator/ rel=prev><link href=../generic_oscal/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.generators - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.generators - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.generators module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/generators.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/generators/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.generators - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.generators module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/generators.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.generators class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.generators </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.generators </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.generators </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.generators class=md-nav__link> <span class=md-ellipsis> generators </span> </a> <nav class=md-nav aria-label=generators> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generators-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generators.TG class=md-nav__link> <span class=md-ellipsis> TG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_base64 class=md-nav__link> <span class=md-ellipsis> sample_base64 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_base64_value class=md-nav__link> <span class=md-ellipsis> sample_base64_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_date_value class=md-nav__link> <span class=md-ellipsis> sample_date_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_method class=md-nav__link> <span class=md-ellipsis> sample_method </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_observation_type_valid_value class=md-nav__link> <span class=md-ellipsis> sample_observation_type_valid_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_task_valid_value class=md-nav__link> <span class=md-ellipsis> sample_task_valid_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.type_base64 class=md-nav__link> <span class=md-ellipsis> type_base64 </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generators-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generators.generate_sample_model class=md-nav__link> <span class=md-ellipsis> generate_sample_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.generate_sample_value_by_type class=md-nav__link> <span class=md-ellipsis> generate_sample_value_by_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.is_by_type class=md-nav__link> <span class=md-ellipsis> is_by_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.is_enum_method class=md-nav__link> <span class=md-ellipsis> is_enum_method </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.is_enum_observation_type_valid_value class=md-nav__link> <span class=md-ellipsis> is_enum_observation_type_valid_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.is_enum_task_valid_value class=md-nav__link> <span class=md-ellipsis> is_enum_task_valid_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.safe_is_sub class=md-nav__link> <span class=md-ellipsis> safe_is_sub </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.generators class=md-nav__link> <span class=md-ellipsis> generators </span> </a> <nav class=md-nav aria-label=generators> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generators-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generators.TG class=md-nav__link> <span class=md-ellipsis> TG </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_base64 class=md-nav__link> <span class=md-ellipsis> sample_base64 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_base64_value class=md-nav__link> <span class=md-ellipsis> sample_base64_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_date_value class=md-nav__link> <span class=md-ellipsis> sample_date_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_method class=md-nav__link> <span class=md-ellipsis> sample_method </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_observation_type_valid_value class=md-nav__link> <span class=md-ellipsis> sample_observation_type_valid_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.sample_task_valid_value class=md-nav__link> <span class=md-ellipsis> sample_task_valid_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.type_base64 class=md-nav__link> <span class=md-ellipsis> type_base64 </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generators-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generators.generate_sample_model class=md-nav__link> <span class=md-ellipsis> generate_sample_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.generate_sample_value_by_type class=md-nav__link> <span class=md-ellipsis> generate_sample_value_by_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.is_by_type class=md-nav__link> <span class=md-ellipsis> is_by_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.is_enum_method class=md-nav__link> <span class=md-ellipsis> is_enum_method </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.is_enum_observation_type_valid_value class=md-nav__link> <span class=md-ellipsis> is_enum_observation_type_valid_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.is_enum_task_valid_value class=md-nav__link> <span class=md-ellipsis> is_enum_task_valid_value </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generators.safe_is_sub class=md-nav__link> <span class=md-ellipsis> safe_is_sub </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.generators</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.generators class="doc doc-heading"> <code>trestle.core.generators</code> <a href=#trestle.core.generators class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Capabilities to allow the generation of various oscal objects.</p> <div class="doc doc-children"> <h3 id=trestle.core.generators-attributes>Attributes<a href=#trestle.core.generators-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generators.TG class="doc doc-heading"> <code class="highlight language-python"><span class=n>TG</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;TG&#39;</span><span class=p>,</span> <span class=n>bound</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generators.TG class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generators.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generators.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generators.sample_base64 class="doc doc-heading"> <code class="highlight language-python"><span class=n>sample_base64</span> <span class=o>=</span> <span class=n>Base64</span><span class=p>(</span><span class=n>filename</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span> <span class=n>media_type</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>sample_base64_value</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generators.sample_base64 class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generators.sample_base64_value class="doc doc-heading"> <code class="highlight language-python"><span class=n>sample_base64_value</span> <span class=o>=</span> <span class=mi>0</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generators.sample_base64_value class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generators.sample_date_value class="doc doc-heading"> <code class="highlight language-python"><span class=n>sample_date_value</span> <span class=o>=</span> <span class=s1>&#39;2400-02-29&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generators.sample_date_value class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generators.sample_method class="doc doc-heading"> <code class="highlight language-python"><span class=n>sample_method</span> <span class=o>=</span> <span class=n>Methods</span><span class=o>.</span><span class=n>EXAMINE</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generators.sample_method class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generators.sample_observation_type_valid_value class="doc doc-heading"> <code class="highlight language-python"><span class=n>sample_observation_type_valid_value</span> <span class=o>=</span> <span class=n>ObservationTypeValidValues</span><span class=o>.</span><span class=n>historic</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generators.sample_observation_type_valid_value class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generators.sample_task_valid_value class="doc doc-heading"> <code class="highlight language-python"><span class=n>sample_task_valid_value</span> <span class=o>=</span> <span class=n>TaskValidValues</span><span class=o>.</span><span class=n>milestone</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generators.sample_task_valid_value class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generators.type_base64 class="doc doc-heading"> <code class="highlight language-python"><span class=n>type_base64</span> <span class=o>=</span> <span class=nb>type</span><span class=p>(</span><span class=n>sample_base64</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generators.type_base64 class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.generators-classes>Classes<a href=#trestle.core.generators-classes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.core.generators-functions>Functions<a href=#trestle.core.generators-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.core.generators.generate_sample_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate_sample_model</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>include_optional</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>depth</span><span class=o>=-</span><span class=mi>1</span><span class=p>)</span></code> <a href=#trestle.core.generators.generate_sample_model class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Given a model class, generate an object of that class with sample values.</p> <p>Can generate optional variables with an enabled flag. Any array objects will have a single entry injected into it.</p> <p>Note: Trestle generate will not activate recursive loops irrespective of the depth flag.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model</code> </td> <td> <code><span title=typing.Union>Union</span>[<span title=typing.Type>Type</span>[<a class="autorefs autorefs-internal" title=trestle.core.generators.TG href=#trestle.core.generators.TG>TG</a>], <span title=typing.List>List</span>[<a class="autorefs autorefs-internal" title=trestle.core.generators.TG href=#trestle.core.generators.TG>TG</a>], <span title=typing.Dict>Dict</span>[str, <a class="autorefs autorefs-internal" title=trestle.core.generators.TG href=#trestle.core.generators.TG>TG</a>]]</code> </td> <td> <div class=doc-md-description> <p>The model type provided. Typically for a user as an OscalBaseModel Subclass.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>include_optional</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether or not to generate optional fields.</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>depth</code> </td> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>Depth of the tree at which optional fields are generated. Negative values (default) removes the limit.</p> </div> </td> <td> <code>-1</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.generators.TG href=#trestle.core.generators.TG>TG</a></code> </td> <td> <div class=doc-md-description> <p>The generated instance with a pro-forma values filled out as best as possible.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/generators.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>generate_sample_model</span><span class=p>(</span>
+    <span class=n>model</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>TG</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>TG</span><span class=p>]],</span> <span class=n>include_optional</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span> <span class=n>depth</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=o>-</span><span class=mi>1</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TG</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Given a model class, generate an object of that class with sample values.</span>
+
+<span class=sd>    Can generate optional variables with an enabled flag. Any array objects will have a single entry injected into it.</span>
+
+<span class=sd>    Note: Trestle generate will not activate recursive loops irrespective of the depth flag.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        model: The model type provided. Typically for a user as an OscalBaseModel Subclass.</span>
+<span class=sd>        include_optional: Whether or not to generate optional fields.</span>
+<span class=sd>        depth: Depth of the tree at which optional fields are generated. Negative values (default) removes the limit.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The generated instance with a pro-forma values filled out as best as possible.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>effective_optional</span> <span class=o>=</span> <span class=n>include_optional</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>depth</span> <span class=o>==</span> <span class=mi>0</span>
+
+    <span class=n>model_type</span> <span class=o>=</span> <span class=n>model</span>
+    <span class=c1># This block normalizes model type down to</span>
+    <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>model</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+        <span class=n>model_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=n>model</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+    <span class=n>model</span> <span class=o>=</span> <span class=n>cast</span><span class=p>(</span><span class=n>TG</span><span class=p>,</span> <span class=n>model</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+
+    <span class=n>model_dict</span> <span class=o>=</span> <span class=p>{}</span>  <span class=c1># type: ignore</span>
+    <span class=c1># this block is needed to avoid situations where an inbuilt is inside a list / dict.</span>
+    <span class=c1># the only time dict ever appears is with include_all, which is handled specially</span>
+    <span class=c1># the only type of collection possible after OSCAL 1.0.0 is list</span>
+    <span class=k>if</span> <span class=n>safe_is_sub</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>):</span>
+        <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>model</span><span class=o>.</span><span class=n>__fields__</span><span class=p>:</span>  <span class=c1># type: ignore</span>
+            <span class=k>if</span> <span class=n>model_type</span> <span class=ow>in</span> <span class=p>[</span><span class=n>OscalVersion</span><span class=p>]:</span>
+                <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>OSCAL_VERSION</span>
+                <span class=k>break</span>
+            <span class=k>if</span> <span class=n>field</span> <span class=o>==</span> <span class=s1>&#39;include_all&#39;</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>include_optional</span><span class=p>:</span>
+                    <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+                <span class=k>continue</span>
+            <span class=n>outer_type</span> <span class=o>=</span> <span class=n>model</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=n>field</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span>  <span class=c1># type: ignore</span>
+            <span class=c1># next appears to be needed for python 3.7</span>
+            <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>outer_type</span><span class=p>)</span> <span class=o>==</span> <span class=n>Union</span><span class=p>:</span>
+                <span class=n>outer_type</span> <span class=o>=</span> <span class=n>outer_type</span><span class=o>.</span><span class=n>__args__</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>model</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=n>field</span><span class=p>]</span><span class=o>.</span><span class=n>required</span> <span class=ow>or</span> <span class=n>effective_optional</span><span class=p>:</span>  <span class=c1># type: ignore</span>
+                <span class=c1># FIXME could be ForwardRef(&#39;SystemComponentStatus&#39;)</span>
+                <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>outer_type</span><span class=p>):</span>
+                    <span class=n>inner_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>outer_type</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>inner_type</span> <span class=o>==</span> <span class=n>model</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>generate_sample_model</span><span class=p>(</span>
+                        <span class=n>outer_type</span><span class=p>,</span> <span class=n>include_optional</span><span class=o>=</span><span class=n>include_optional</span><span class=p>,</span> <span class=n>depth</span><span class=o>=</span><span class=n>depth</span> <span class=o>-</span> <span class=mi>1</span>
+                    <span class=p>)</span>
+                <span class=k>elif</span> <span class=n>is_by_type</span><span class=p>(</span><span class=n>outer_type</span><span class=p>):</span>
+                    <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>generate_sample_value_by_type</span><span class=p>(</span><span class=n>outer_type</span><span class=p>,</span> <span class=n>field</span><span class=p>)</span>
+                <span class=k>elif</span> <span class=n>safe_is_sub</span><span class=p>(</span><span class=n>outer_type</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>):</span>
+                    <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>generate_sample_model</span><span class=p>(</span>
+                        <span class=n>outer_type</span><span class=p>,</span> <span class=n>include_optional</span><span class=o>=</span><span class=n>include_optional</span><span class=p>,</span> <span class=n>depth</span><span class=o>=</span><span class=n>depth</span> <span class=o>-</span> <span class=mi>1</span>
+                    <span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=c1># Handle special cases (hacking)</span>
+                    <span class=k>if</span> <span class=n>model_type</span> <span class=ow>in</span> <span class=p>[</span><span class=n>Base64Datatype</span><span class=p>]:</span>
+                        <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>sample_base64_value</span>
+                    <span class=k>elif</span> <span class=n>model_type</span> <span class=ow>in</span> <span class=p>[</span><span class=n>Base64</span><span class=p>]:</span>
+                        <span class=k>if</span> <span class=n>field</span> <span class=o>==</span> <span class=s1>&#39;filename&#39;</span><span class=p>:</span>
+                            <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>sample_base64</span><span class=o>.</span><span class=n>filename</span>
+                        <span class=k>elif</span> <span class=n>field</span> <span class=o>==</span> <span class=s1>&#39;media_type&#39;</span><span class=p>:</span>
+                            <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>sample_base64</span><span class=o>.</span><span class=n>media_type</span>
+                        <span class=k>elif</span> <span class=n>field</span> <span class=o>==</span> <span class=s1>&#39;value&#39;</span><span class=p>:</span>
+                            <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>sample_base64</span><span class=o>.</span><span class=n>value</span>
+                    <span class=k>elif</span> <span class=n>model_type</span> <span class=ow>in</span> <span class=p>[</span><span class=n>DateDatatype</span><span class=p>]:</span>
+                        <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>sample_date_value</span>
+                    <span class=c1># Hacking here:</span>
+                    <span class=c1># Root models should ideally not exist, however, sometimes we are stuck with them.</span>
+                    <span class=c1># If that is the case we need sufficient information on the type in order to generate a model.</span>
+                    <span class=c1># E.g. we need the type of the container.</span>
+                    <span class=k>elif</span> <span class=n>field</span> <span class=o>==</span> <span class=s1>&#39;__root__&#39;</span> <span class=ow>and</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=s1>&#39;__name__&#39;</span><span class=p>):</span>
+                        <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>generate_sample_value_by_type</span><span class=p>(</span>
+                            <span class=n>outer_type</span><span class=p>,</span> <span class=n>str_utils</span><span class=o>.</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>FIELD</span><span class=p>)</span>
+                        <span class=p>)</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>model_dict</span><span class=p>[</span><span class=n>field</span><span class=p>]</span> <span class=o>=</span> <span class=n>generate_sample_value_by_type</span><span class=p>(</span><span class=n>outer_type</span><span class=p>,</span> <span class=n>field</span><span class=p>)</span>
+        <span class=c1># Note: this assumes list constrains in oscal are always 1 as a minimum size. if two this may still fail.</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>model_type</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+            <span class=k>return</span> <span class=p>[</span><span class=n>generate_sample_value_by_type</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)]</span>  <span class=c1># type: ignore</span>
+        <span class=k>if</span> <span class=n>model_type</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+            <span class=k>return</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>:</span> <span class=n>generate_sample_value_by_type</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)}</span>  <span class=c1># type: ignore</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unhandled collection type.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>model_type</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+        <span class=k>return</span> <span class=p>[</span><span class=n>model</span><span class=p>(</span><span class=o>**</span><span class=n>model_dict</span><span class=p>)]</span>  <span class=c1># type: ignore</span>
+    <span class=k>if</span> <span class=n>model_type</span> <span class=ow>is</span> <span class=nb>dict</span><span class=p>:</span>
+        <span class=k>return</span> <span class=p>{</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>:</span> <span class=n>model</span><span class=p>(</span><span class=o>**</span><span class=n>model_dict</span><span class=p>)}</span>  <span class=c1># type: ignore</span>
+    <span class=k>return</span> <span class=n>model</span><span class=p>(</span><span class=o>**</span><span class=n>model_dict</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.generators.generate_sample_value_by_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate_sample_value_by_type</span><span class=p>(</span><span class=n>type_</span><span class=p>,</span> <span class=n>field_name</span><span class=p>)</span></code> <a href=#trestle.core.generators.generate_sample_value_by_type class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Given a type, return sample value.</p> <p>Includes the Optional use of passing down a parent_model</p> <details class=quote> <summary>Source code in <code>trestle/core/generators.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>generate_sample_value_by_type</span><span class=p>(</span>
+    <span class=n>type_</span><span class=p>:</span> <span class=nb>type</span><span class=p>,</span>
+    <span class=n>field_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Union</span><span class=p>[</span><span class=n>datetime</span><span class=p>,</span> <span class=nb>bool</span><span class=p>,</span> <span class=nb>int</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>float</span><span class=p>,</span> <span class=n>Enum</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Given a type, return sample value.</span>
+
+<span class=sd>    Includes the Optional use of passing down a parent_model</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># FIXME: Should be in separate generator module as it inherits EVERYTHING</span>
+    <span class=k>if</span> <span class=n>is_enum_method</span><span class=p>(</span><span class=n>type_</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>sample_method</span>
+    <span class=k>if</span> <span class=n>is_enum_task_valid_value</span><span class=p>(</span><span class=n>type_</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>sample_task_valid_value</span>
+    <span class=k>if</span> <span class=n>is_enum_observation_type_valid_value</span><span class=p>(</span><span class=n>type_</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>sample_observation_type_valid_value</span>
+    <span class=k>if</span> <span class=n>type_</span> <span class=ow>is</span> <span class=n>Base64</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>sample_base64</span>
+    <span class=k>if</span> <span class=n>type_</span> <span class=ow>is</span> <span class=n>datetime</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span><span class=o>.</span><span class=n>astimezone</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>type_</span> <span class=ow>is</span> <span class=nb>bool</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=n>type_</span> <span class=ow>is</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>return</span> <span class=mi>0</span>
+    <span class=k>if</span> <span class=n>type_</span> <span class=ow>is</span> <span class=nb>float</span><span class=p>:</span>
+        <span class=k>return</span> <span class=mf>0.00</span>
+    <span class=k>if</span> <span class=n>safe_is_sub</span><span class=p>(</span><span class=n>type_</span><span class=p>,</span> <span class=n>ConstrainedStr</span><span class=p>)</span> <span class=ow>or</span> <span class=p>(</span><span class=nb>hasattr</span><span class=p>(</span><span class=n>type_</span><span class=p>,</span> <span class=s1>&#39;__name__&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=s1>&#39;ConstrainedStr&#39;</span> <span class=ow>in</span> <span class=n>type_</span><span class=o>.</span><span class=vm>__name__</span><span class=p>):</span>
+        <span class=c1># This code here is messy. we need to meet a set of constraints. If we do</span>
+        <span class=c1># TODO: handle regex directly</span>
+        <span class=k>if</span> <span class=s1>&#39;uuid&#39;</span> <span class=o>==</span> <span class=n>field_name</span><span class=p>:</span>
+            <span class=k>return</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=c1># some things like location_uuid in lists arrive here with field_name=&#39;&#39;</span>
+        <span class=k>if</span> <span class=n>type_</span><span class=o>.</span><span class=n>regex</span> <span class=ow>and</span> <span class=n>type_</span><span class=o>.</span><span class=n>regex</span><span class=o>.</span><span class=n>pattern</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>&#39;</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+            <span class=k>return</span> <span class=n>const</span><span class=o>.</span><span class=n>SAMPLE_UUID_STR</span>
+        <span class=k>if</span> <span class=n>field_name</span> <span class=o>==</span> <span class=s1>&#39;date_authorized&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=nb>str</span><span class=p>(</span><span class=n>date</span><span class=o>.</span><span class=n>today</span><span class=p>()</span><span class=o>.</span><span class=n>isoformat</span><span class=p>())</span>
+        <span class=k>if</span> <span class=n>field_name</span> <span class=o>==</span> <span class=s1>&#39;oscal_version&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>OSCAL_VERSION</span>
+        <span class=k>if</span> <span class=s1>&#39;uuid&#39;</span> <span class=ow>in</span> <span class=n>field_name</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>const</span><span class=o>.</span><span class=n>SAMPLE_UUID_STR</span>
+        <span class=c1># Only case where are UUID is required but not in name.</span>
+        <span class=k>if</span> <span class=n>field_name</span><span class=o>.</span><span class=n>rstrip</span><span class=p>(</span><span class=s1>&#39;s&#39;</span><span class=p>)</span> <span class=o>==</span> <span class=s1>&#39;member_of_organization&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>const</span><span class=o>.</span><span class=n>SAMPLE_UUID_STR</span>
+        <span class=k>return</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span>
+    <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>type_</span><span class=p>,</span> <span class=s1>&#39;__name__&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=s1>&#39;ConstrainedIntValue&#39;</span> <span class=ow>in</span> <span class=n>type_</span><span class=o>.</span><span class=vm>__name__</span><span class=p>:</span>
+        <span class=c1># create an int value as close to the floor as possible does not test upper bound</span>
+        <span class=n>multiple</span> <span class=o>=</span> <span class=n>type_</span><span class=o>.</span><span class=n>multiple_of</span> <span class=k>if</span> <span class=n>type_</span><span class=o>.</span><span class=n>multiple_of</span> <span class=k>else</span> <span class=mi>1</span>  <span class=c1># type: ignore # default to every integer</span>
+        <span class=c1># this command is a bit of a problem</span>
+        <span class=n>floor</span> <span class=o>=</span> <span class=n>type_</span><span class=o>.</span><span class=n>ge</span> <span class=k>if</span> <span class=n>type_</span><span class=o>.</span><span class=n>ge</span> <span class=k>else</span> <span class=mi>0</span>  <span class=c1># type: ignore</span>
+        <span class=n>floor</span> <span class=o>=</span> <span class=n>type_</span><span class=o>.</span><span class=n>gt</span> <span class=o>+</span> <span class=mi>1</span> <span class=k>if</span> <span class=n>type_</span><span class=o>.</span><span class=n>gt</span> <span class=k>else</span> <span class=n>floor</span>  <span class=c1># type: ignore</span>
+        <span class=k>if</span> <span class=n>math</span><span class=o>.</span><span class=n>remainder</span><span class=p>(</span><span class=n>floor</span><span class=p>,</span> <span class=n>multiple</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>floor</span>
+        <span class=k>return</span> <span class=p>(</span><span class=n>floor</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)</span> <span class=o>*</span> <span class=n>multiple</span>
+    <span class=k>if</span> <span class=n>safe_is_sub</span><span class=p>(</span><span class=n>type_</span><span class=p>,</span> <span class=n>Enum</span><span class=p>):</span>
+        <span class=c1># keys and values diverge due to hypens in oscal names</span>
+        <span class=k>return</span> <span class=n>type_</span><span class=p>(</span><span class=nb>list</span><span class=p>(</span><span class=n>type_</span><span class=o>.</span><span class=n>__members__</span><span class=o>.</span><span class=n>values</span><span class=p>())[</span><span class=mi>0</span><span class=p>])</span>  <span class=c1># type: ignore</span>
+    <span class=k>if</span> <span class=n>type_</span> <span class=ow>is</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>field_name</span> <span class=o>==</span> <span class=s1>&#39;oscal_version&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>OSCAL_VERSION</span>
+        <span class=k>return</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span>
+    <span class=k>if</span> <span class=n>type_</span> <span class=ow>is</span> <span class=n>pydantic</span><span class=o>.</span><span class=n>v1</span><span class=o>.</span><span class=n>networks</span><span class=o>.</span><span class=n>EmailStr</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>pydantic</span><span class=o>.</span><span class=n>v1</span><span class=o>.</span><span class=n>networks</span><span class=o>.</span><span class=n>EmailStr</span><span class=p>(</span><span class=s1>&#39;dummy@sample.com&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>type_</span> <span class=ow>is</span> <span class=n>pydantic</span><span class=o>.</span><span class=n>v1</span><span class=o>.</span><span class=n>networks</span><span class=o>.</span><span class=n>AnyUrl</span><span class=p>:</span>
+        <span class=c1># TODO: Cleanup: this should be usable from a url.. but it&#39;s not inuitive.</span>
+        <span class=k>return</span> <span class=n>pydantic</span><span class=o>.</span><span class=n>v1</span><span class=o>.</span><span class=n>networks</span><span class=o>.</span><span class=n>AnyUrl</span><span class=p>(</span><span class=s1>&#39;https://sample.com/replaceme.html&#39;</span><span class=p>,</span> <span class=n>scheme</span><span class=o>=</span><span class=s1>&#39;http&#39;</span><span class=p>,</span> <span class=n>host</span><span class=o>=</span><span class=s1>&#39;sample.com&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>type_</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to generate sample for type </span><span class=si>{</span><span class=n>type_</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=c1># default to empty dict for anything else</span>
+    <span class=k>return</span> <span class=p>{}</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.generators.is_by_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_by_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span></code> <a href=#trestle.core.generators.is_by_type class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Check for by type.</p> <details class=quote> <summary>Source code in <code>trestle/core/generators.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_by_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>TG</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>TG</span><span class=p>],</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>TG</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check for by type.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=n>model_type</span> <span class=o>==</span> <span class=n>type_base64</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.generators.is_enum_method class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_enum_method</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span></code> <a href=#trestle.core.generators.is_enum_method class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Test for method.</p> <details class=quote> <summary>Source code in <code>trestle/core/generators.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_enum_method</span><span class=p>(</span><span class=n>type_</span><span class=p>:</span> <span class=nb>type</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Test for method.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span> <span class=o>==</span> <span class=n>Union</span><span class=p>:</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>typing</span><span class=o>.</span><span class=n>get_args</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>arg</span> <span class=ow>in</span> <span class=n>args</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s2>&quot;&lt;enum &#39;Methods&#39;&gt;&quot;</span> <span class=o>==</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>arg</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>:</span>
+                <span class=n>rval</span> <span class=o>=</span> <span class=kc>True</span>
+                <span class=k>break</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.generators.is_enum_observation_type_valid_value class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_enum_observation_type_valid_value</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span></code> <a href=#trestle.core.generators.is_enum_observation_type_valid_value class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Test for observation type valid value.</p> <details class=quote> <summary>Source code in <code>trestle/core/generators.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span>
+<span class=normal>98</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_enum_observation_type_valid_value</span><span class=p>(</span><span class=n>type_</span><span class=p>:</span> <span class=nb>type</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Test for observation type valid value.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span> <span class=o>==</span> <span class=n>Union</span><span class=p>:</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>typing</span><span class=o>.</span><span class=n>get_args</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>arg</span> <span class=ow>in</span> <span class=n>args</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s2>&quot;&lt;enum &#39;ObservationTypeValidValues&#39;&gt;&quot;</span> <span class=o>==</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>arg</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>:</span>
+                <span class=n>rval</span> <span class=o>=</span> <span class=kc>True</span>
+                <span class=k>break</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.generators.is_enum_task_valid_value class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_enum_task_valid_value</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span></code> <a href=#trestle.core.generators.is_enum_task_valid_value class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Test for task valid value.</p> <details class=quote> <summary>Source code in <code>trestle/core/generators.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_enum_task_valid_value</span><span class=p>(</span><span class=n>type_</span><span class=p>:</span> <span class=nb>type</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Test for task valid value.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span> <span class=o>==</span> <span class=n>Union</span><span class=p>:</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>typing</span><span class=o>.</span><span class=n>get_args</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>arg</span> <span class=ow>in</span> <span class=n>args</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s2>&quot;&lt;enum &#39;TaskValidValues&#39;&gt;&quot;</span> <span class=o>==</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>arg</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>:</span>
+                <span class=n>rval</span> <span class=o>=</span> <span class=kc>True</span>
+                <span class=k>break</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.generators.safe_is_sub class="doc doc-heading"> <code class="highlight language-python"><span class=n>safe_is_sub</span><span class=p>(</span><span class=n>sub</span><span class=p>,</span> <span class=n>parent</span><span class=p>)</span></code> <a href=#trestle.core.generators.safe_is_sub class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Is this a subclass of parent.</p> <details class=quote> <summary>Source code in <code>trestle/core/generators.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>safe_is_sub</span><span class=p>(</span><span class=n>sub</span><span class=p>:</span> <span class=n>Any</span><span class=p>,</span> <span class=n>parent</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Is this a subclass of parent.&quot;&quot;&quot;</span>
+    <span class=n>is_class</span> <span class=o>=</span> <span class=n>inspect</span><span class=o>.</span><span class=n>isclass</span><span class=p>(</span><span class=n>sub</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>is_class</span> <span class=ow>and</span> <span class=nb>issubclass</span><span class=p>(</span><span class=n>sub</span><span class=p>,</span> <span class=n>parent</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/generic_oscal/index.html b/latest/reference/API/trestle/core/generic_oscal/index.html
new file mode 100644
index 000000000..0c2778837
--- /dev/null
+++ b/latest/reference/API/trestle/core/generic_oscal/index.html
@@ -0,0 +1,1008 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.generic_oscal module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/generic_oscal/ rel=canonical><link href=../generators/ rel=prev><link href=../links_validator/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.generic_oscal - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.generic_oscal - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.generic_oscal module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/generic_oscal.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/generic_oscal/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.generic_oscal - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.generic_oscal module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/generic_oscal.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.generic_oscal class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.generic_oscal </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.generic_oscal </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.generic_oscal class=md-nav__link> <span class=md-ellipsis> generic_oscal </span> </a> <nav class=md-nav aria-label=generic_oscal> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.IMPLEMENTED_REQUIREMENTS class=md-nav__link> <span class=md-ellipsis> IMPLEMENTED_REQUIREMENTS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent class=md-nav__link> <span class=md-ellipsis> GenericByComponent </span> </a> <nav class=md-nav aria-label=GenericByComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.implementation_status class=md-nav__link> <span class=md-ellipsis> implementation_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.as_ssp class=md-nav__link> <span class=md-ellipsis> as_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent class=md-nav__link> <span class=md-ellipsis> GenericComponent </span> </a> <nav class=md-nav aria-label=GenericComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.control_implementations class=md-nav__link> <span class=md-ellipsis> control_implementations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.protocols class=md-nav__link> <span class=md-ellipsis> protocols </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.purpose class=md-nav__link> <span class=md-ellipsis> purpose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.as_defined_component class=md-nav__link> <span class=md-ellipsis> as_defined_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.as_system_component class=md-nav__link> <span class=md-ellipsis> as_system_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.from_defined_component class=md-nav__link> <span class=md-ellipsis> from_defined_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation class=md-nav__link> <span class=md-ellipsis> GenericControlImplementation </span> </a> <nav class=md-nav aria-label=GenericControlImplementation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.implemented_requirements class=md-nav__link> <span class=md-ellipsis> implemented_requirements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.source class=md-nav__link> <span class=md-ellipsis> source </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.as_ssp class=md-nav__link> <span class=md-ellipsis> as_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.from_component_ci class=md-nav__link> <span class=md-ellipsis> from_component_ci </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement class=md-nav__link> <span class=md-ellipsis> GenericImplementedRequirement </span> </a> <nav class=md-nav aria-label=GenericImplementedRequirement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.by_components class=md-nav__link> <span class=md-ellipsis> by_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.statements class=md-nav__link> <span class=md-ellipsis> statements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.as_ssp class=md-nav__link> <span class=md-ellipsis> as_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.from_comp_def class=md-nav__link> <span class=md-ellipsis> from_comp_def </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter class=md-nav__link> <span class=md-ellipsis> GenericSetParameter </span> </a> <nav class=md-nav aria-label=GenericSetParameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.param_id class=md-nav__link> <span class=md-ellipsis> param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.from_defined_component class=md-nav__link> <span class=md-ellipsis> from_defined_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.to_ssp class=md-nav__link> <span class=md-ellipsis> to_ssp </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement class=md-nav__link> <span class=md-ellipsis> GenericStatement </span> </a> <nav class=md-nav aria-label=GenericStatement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.by_components class=md-nav__link> <span class=md-ellipsis> by_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.statement_id class=md-nav__link> <span class=md-ellipsis> statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.as_ssp class=md-nav__link> <span class=md-ellipsis> as_ssp </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.generic_oscal class=md-nav__link> <span class=md-ellipsis> generic_oscal </span> </a> <nav class=md-nav aria-label=generic_oscal> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.IMPLEMENTED_REQUIREMENTS class=md-nav__link> <span class=md-ellipsis> IMPLEMENTED_REQUIREMENTS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent class=md-nav__link> <span class=md-ellipsis> GenericByComponent </span> </a> <nav class=md-nav aria-label=GenericByComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.implementation_status class=md-nav__link> <span class=md-ellipsis> implementation_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.as_ssp class=md-nav__link> <span class=md-ellipsis> as_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericByComponent.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent class=md-nav__link> <span class=md-ellipsis> GenericComponent </span> </a> <nav class=md-nav aria-label=GenericComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.control_implementations class=md-nav__link> <span class=md-ellipsis> control_implementations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.protocols class=md-nav__link> <span class=md-ellipsis> protocols </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.purpose class=md-nav__link> <span class=md-ellipsis> purpose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.as_defined_component class=md-nav__link> <span class=md-ellipsis> as_defined_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.as_system_component class=md-nav__link> <span class=md-ellipsis> as_system_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.from_defined_component class=md-nav__link> <span class=md-ellipsis> from_defined_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericComponent.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation class=md-nav__link> <span class=md-ellipsis> GenericControlImplementation </span> </a> <nav class=md-nav aria-label=GenericControlImplementation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.implemented_requirements class=md-nav__link> <span class=md-ellipsis> implemented_requirements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.source class=md-nav__link> <span class=md-ellipsis> source </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.as_ssp class=md-nav__link> <span class=md-ellipsis> as_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.from_component_ci class=md-nav__link> <span class=md-ellipsis> from_component_ci </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericControlImplementation.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement class=md-nav__link> <span class=md-ellipsis> GenericImplementedRequirement </span> </a> <nav class=md-nav aria-label=GenericImplementedRequirement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.by_components class=md-nav__link> <span class=md-ellipsis> by_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.statements class=md-nav__link> <span class=md-ellipsis> statements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.as_ssp class=md-nav__link> <span class=md-ellipsis> as_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.from_comp_def class=md-nav__link> <span class=md-ellipsis> from_comp_def </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.generate class=md-nav__link> <span class=md-ellipsis> generate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter class=md-nav__link> <span class=md-ellipsis> GenericSetParameter </span> </a> <nav class=md-nav aria-label=GenericSetParameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.param_id class=md-nav__link> <span class=md-ellipsis> param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.from_defined_component class=md-nav__link> <span class=md-ellipsis> from_defined_component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericSetParameter.to_ssp class=md-nav__link> <span class=md-ellipsis> to_ssp </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement class=md-nav__link> <span class=md-ellipsis> GenericStatement </span> </a> <nav class=md-nav aria-label=GenericStatement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.by_components class=md-nav__link> <span class=md-ellipsis> by_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.statement_id class=md-nav__link> <span class=md-ellipsis> statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.generic_oscal.GenericStatement.as_ssp class=md-nav__link> <span class=md-ellipsis> as_ssp </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.generic_oscal-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.generic_oscal</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.generic_oscal class="doc doc-heading"> <code>trestle.core.generic_oscal</code> <a href=#trestle.core.generic_oscal class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Generic classes to support both SSP and DefinedComponents.</p> <div class="doc doc-children"> <h3 id=trestle.core.generic_oscal-attributes>Attributes<a href=#trestle.core.generic_oscal-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generic_oscal.IMPLEMENTED_REQUIREMENTS class="doc doc-heading"> <code class="highlight language-python"><span class=n>IMPLEMENTED_REQUIREMENTS</span> <span class=o>=</span> <span class=s1>&#39;implemented_requirements&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.IMPLEMENTED_REQUIREMENTS class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.generic_oscal.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.generic_oscal-classes>Classes<a href=#trestle.core.generic_oscal-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.generic_oscal.GenericByComponent class="doc doc-heading"> <code>GenericByComponent</code> <a href=#trestle.core.generic_oscal.GenericByComponent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.trestle_base_model.TrestleBaseModel href=../trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel>TrestleBaseModel</a></code></p> <p>Generic ByComponent for SSP and DefinedComponent.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>GenericByComponent</span><span class=p>(</span><span class=n>TrestleBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generic ByComponent for SSP and DefinedComponent.&quot;&quot;&quot;</span>
+
+    <span class=c1># only in SSP</span>
+    <span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>  <span class=c1># noqa FS003</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component_uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the component that is implemeting a given control.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Universally Unique Identifier Reference&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>  <span class=c1># noqa FS003</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this by-component entry elsewhere in this or other OSCAL instances. The locally defined UUID of the by-component entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;By-Component Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;An implementation statement that describes how a control or a control statement is implemented within the referenced system component.&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericSetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span>
+    <span class=n>implementation_status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-status&#39;</span><span class=p>)</span>
+    <span class=c1># removed export, inherited, satisfied</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>generate</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>GenericByComponent</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate instance of generic ByComponent.&quot;&quot;&quot;</span>
+        <span class=n>uuid</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>GenericByComponent</span><span class=p>(</span><span class=n>component_uuid</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>SAMPLE_UUID_STR</span><span class=p>,</span> <span class=n>uuid</span><span class=o>=</span><span class=n>uuid</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>as_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert to ssp format.&quot;&quot;&quot;</span>
+        <span class=n>set_params</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+            <span class=n>new_set_param</span> <span class=o>=</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span>
+                <span class=n>param_id</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>remarks</span>
+            <span class=p>)</span>
+            <span class=n>set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_set_param</span><span class=p>)</span>
+        <span class=n>set_params</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>set_params</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>(</span>
+            <span class=n>component_uuid</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>component_uuid</span><span class=p>,</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>uuid</span><span class=p>,</span>
+            <span class=n>description</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>description</span><span class=p>,</span>
+            <span class=n>props</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>props</span><span class=p>,</span>
+            <span class=n>links</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>links</span><span class=p>,</span>
+            <span class=n>set_parameters</span><span class=o>=</span><span class=n>set_params</span><span class=p>,</span>
+            <span class=n>implementation_status</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>implementation_status</span><span class=p>,</span>
+            <span class=n>responsible_roles</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>responsible_roles</span>
+        <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.generic_oscal.GenericByComponent-attributes>Attributes<a href=#trestle.core.generic_oscal.GenericByComponent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericByComponent.component_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component_uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the component that is implemeting a given control.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.component_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericByComponent.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An implementation statement that describes how a control or a control statement is implemented within the referenced system component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericByComponent.implementation_status class="doc doc-heading"> <code class="highlight language-python"><span class=n>implementation_status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-status&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.implementation_status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericByComponent.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericByComponent.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericByComponent.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericByComponent.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericByComponent.set_parameters class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericSetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.set_parameters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericByComponent.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this by-component entry elsewhere in this or other OSCAL instances. The locally defined UUID of the by-component entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;By-Component Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.generic_oscal.GenericByComponent-functions>Functions<a href=#trestle.core.generic_oscal.GenericByComponent-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericByComponent.as_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_ssp</span><span class=p>()</span></code> <a href=#trestle.core.generic_oscal.GenericByComponent.as_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert to ssp format.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert to ssp format.&quot;&quot;&quot;</span>
+    <span class=n>set_params</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+        <span class=n>new_set_param</span> <span class=o>=</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span>
+            <span class=n>param_id</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=n>set_param</span><span class=o>.</span><span class=n>remarks</span>
+        <span class=p>)</span>
+        <span class=n>set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_set_param</span><span class=p>)</span>
+    <span class=n>set_params</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>set_params</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ByComponent</span><span class=p>(</span>
+        <span class=n>component_uuid</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>component_uuid</span><span class=p>,</span>
+        <span class=n>uuid</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>uuid</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>description</span><span class=p>,</span>
+        <span class=n>props</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>props</span><span class=p>,</span>
+        <span class=n>links</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>links</span><span class=p>,</span>
+        <span class=n>set_parameters</span><span class=o>=</span><span class=n>set_params</span><span class=p>,</span>
+        <span class=n>implementation_status</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>implementation_status</span><span class=p>,</span>
+        <span class=n>responsible_roles</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>responsible_roles</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericByComponent.generate class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.generic_oscal.GenericByComponent.generate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate instance of generic ByComponent.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>generate</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>GenericByComponent</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate instance of generic ByComponent.&quot;&quot;&quot;</span>
+    <span class=n>uuid</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>())</span>
+    <span class=k>return</span> <span class=n>GenericByComponent</span><span class=p>(</span><span class=n>component_uuid</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>SAMPLE_UUID_STR</span><span class=p>,</span> <span class=n>uuid</span><span class=o>=</span><span class=n>uuid</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.generic_oscal.GenericComponent class="doc doc-heading"> <code>GenericComponent</code> <a href=#trestle.core.generic_oscal.GenericComponent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.trestle_base_model.TrestleBaseModel href=../trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel>TrestleBaseModel</a></code></p> <p>Generic component for SSP SystemComponent and DefinedComponent.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>GenericComponent</span><span class=p>(</span><span class=n>TrestleBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generic component for SSP SystemComponent and DefinedComponent.&quot;&quot;&quot;</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>  <span class=c1># noqa FS003 F722</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this component elsewhere in this or other OSCAL instances. The locally defined UUID of the component can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=nb>type</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>  <span class=c1># noqa A003 F722</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A category describing the purpose of the component.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Type&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the component.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Title&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of the component, including information about its function.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Description&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>purpose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the technological or business purpose of the component.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Purpose&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>protocols</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Protocol</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=c1># ssp does not have a list of ci&#39;s but it does have one ci</span>
+    <span class=n>control_implementations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericControlImplementation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-implementations&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=c1># ssp has</span>
+    <span class=n>status</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span>
+
+    <span class=k>def</span> <span class=nf>as_defined_component</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert to DefinedComponent.&quot;&quot;&quot;</span>
+        <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>status</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+        <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;status&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>def_comp</span> <span class=o>=</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+        <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>def_comp</span><span class=p>,</span> <span class=n>status</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>def_comp</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>from_defined_component</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>def_comp</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>GenericComponent</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert defined component to generic.&quot;&quot;&quot;</span>
+        <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>def_comp</span><span class=p>)</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>def_comp</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+        <span class=k>if</span> <span class=s1>&#39;control_implementations&#39;</span> <span class=ow>in</span> <span class=n>class_dict</span><span class=p>:</span>
+            <span class=n>new_cis</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>ci</span> <span class=ow>in</span> <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;control_implementations&#39;</span><span class=p>]:</span>
+                <span class=n>new_cis</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>GenericControlImplementation</span><span class=o>.</span><span class=n>from_component_ci</span><span class=p>(</span><span class=n>ci</span><span class=p>))</span>
+            <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;control-implementations&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_cis</span>
+            <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;control_implementations&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;status&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>status</span>
+        <span class=k>return</span> <span class=bp>cls</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>as_system_component</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>status_override</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert to SystemComponent.&quot;&quot;&quot;</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+        <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;control_implementations&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>status_str</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>status</span><span class=o>.</span><span class=n>state</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>status</span> <span class=k>else</span> <span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span>
+        <span class=n>status_str</span> <span class=o>=</span> <span class=n>status_override</span> <span class=k>if</span> <span class=n>status_override</span> <span class=k>else</span> <span class=n>status_str</span>
+        <span class=k>if</span> <span class=n>status_str</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;under-development&#39;</span><span class=p>,</span> <span class=s1>&#39;operational&#39;</span><span class=p>,</span> <span class=s1>&#39;disposition&#39;</span><span class=p>,</span> <span class=s1>&#39;other&#39;</span><span class=p>]:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;SystemComponent status </span><span class=si>{</span><span class=n>status_str</span><span class=si>}</span><span class=s1> not recognized.  Setting to </span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+            <span class=n>status_str</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span>
+        <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;status&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Status</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>status_str</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>status</span><span class=o>.</span><span class=n>remarks</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>generate</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>GenericComponent</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate instance of GenericComponent.&quot;&quot;&quot;</span>
+        <span class=n>uuid</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>status</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>GenericComponent</span><span class=p>(</span><span class=n>uuid</span><span class=o>=</span><span class=n>uuid</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>status</span><span class=o>=</span><span class=n>status</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.generic_oscal.GenericComponent-attributes>Attributes<a href=#trestle.core.generic_oscal.GenericComponent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.control_implementations class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_implementations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericControlImplementation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-implementations&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.control_implementations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of the component, including information about its function.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.protocols class="doc doc-heading"> <code class="highlight language-python"><span class=n>protocols</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Protocol</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.protocols class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.purpose class="doc doc-heading"> <code class="highlight language-python"><span class=n>purpose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the technological or business purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Purpose&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.purpose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.status class="doc doc-heading"> <code class="highlight language-python"><span class=n>status</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A category describing the purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericComponent.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this component elsewhere in this or other OSCAL instances. The locally defined UUID of the component can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.generic_oscal.GenericComponent-functions>Functions<a href=#trestle.core.generic_oscal.GenericComponent-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericComponent.as_defined_component class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_defined_component</span><span class=p>()</span></code> <a href=#trestle.core.generic_oscal.GenericComponent.as_defined_component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert to DefinedComponent.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_defined_component</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert to DefinedComponent.&quot;&quot;&quot;</span>
+    <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>status</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+    <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;status&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=n>def_comp</span> <span class=o>=</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+    <span class=n>ControlInterface</span><span class=o>.</span><span class=n>insert_status_in_props</span><span class=p>(</span><span class=n>def_comp</span><span class=p>,</span> <span class=n>status</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>def_comp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericComponent.as_system_component class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_system_component</span><span class=p>(</span><span class=n>status_override</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>)</span></code> <a href=#trestle.core.generic_oscal.GenericComponent.as_system_component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert to SystemComponent.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_system_component</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>status_override</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert to SystemComponent.&quot;&quot;&quot;</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+    <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;control_implementations&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=n>status_str</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>status</span><span class=o>.</span><span class=n>state</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>status</span> <span class=k>else</span> <span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span>
+    <span class=n>status_str</span> <span class=o>=</span> <span class=n>status_override</span> <span class=k>if</span> <span class=n>status_override</span> <span class=k>else</span> <span class=n>status_str</span>
+    <span class=k>if</span> <span class=n>status_str</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;under-development&#39;</span><span class=p>,</span> <span class=s1>&#39;operational&#39;</span><span class=p>,</span> <span class=s1>&#39;disposition&#39;</span><span class=p>,</span> <span class=s1>&#39;other&#39;</span><span class=p>]:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;SystemComponent status </span><span class=si>{</span><span class=n>status_str</span><span class=si>}</span><span class=s1> not recognized.  Setting to </span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=p>)</span>
+        <span class=n>status_str</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span>
+    <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;status&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Status</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>status_str</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>status</span><span class=o>.</span><span class=n>remarks</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericComponent.from_defined_component class="doc doc-heading"> <code class="highlight language-python"><span class=n>from_defined_component</span><span class=p>(</span><span class=n>def_comp</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.from_defined_component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert defined component to generic.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>from_defined_component</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>def_comp</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>DefinedComponent</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>GenericComponent</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert defined component to generic.&quot;&quot;&quot;</span>
+    <span class=n>status</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_status_from_props</span><span class=p>(</span><span class=n>def_comp</span><span class=p>)</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>def_comp</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+    <span class=k>if</span> <span class=s1>&#39;control_implementations&#39;</span> <span class=ow>in</span> <span class=n>class_dict</span><span class=p>:</span>
+        <span class=n>new_cis</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>ci</span> <span class=ow>in</span> <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;control_implementations&#39;</span><span class=p>]:</span>
+            <span class=n>new_cis</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>GenericControlImplementation</span><span class=o>.</span><span class=n>from_component_ci</span><span class=p>(</span><span class=n>ci</span><span class=p>))</span>
+        <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;control-implementations&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_cis</span>
+        <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;control_implementations&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;status&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>status</span>
+    <span class=k>return</span> <span class=bp>cls</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericComponent.generate class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.generic_oscal.GenericComponent.generate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate instance of GenericComponent.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>generate</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>GenericComponent</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate instance of GenericComponent.&quot;&quot;&quot;</span>
+    <span class=n>uuid</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>())</span>
+    <span class=n>status</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>STATUS_OPERATIONAL</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>GenericComponent</span><span class=p>(</span><span class=n>uuid</span><span class=o>=</span><span class=n>uuid</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>status</span><span class=o>=</span><span class=n>status</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.generic_oscal.GenericControlImplementation class="doc doc-heading"> <code>GenericControlImplementation</code> <a href=#trestle.core.generic_oscal.GenericControlImplementation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.trestle_base_model.TrestleBaseModel href=../trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel>TrestleBaseModel</a></code></p> <p>Generic control implementation for SSP and CompDef.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>GenericControlImplementation</span><span class=p>(</span><span class=n>TrestleBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generic control implementation for SSP and CompDef.&quot;&quot;&quot;</span>
+
+    <span class=c1># not in ssp</span>
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>  <span class=c1># noqa FS003 F722</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference a set of implemented controls elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation set can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Set Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=c1># not in ssp</span>
+    <span class=n>source</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;A reference to an OSCAL catalog or profile providing the referenced control or subcontrol definition.&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Source Resource Reference&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;A description of how the specified set of controls are implemented for the containing component or capability.&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=c1># not in ssp</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=c1># not in ssp</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericSetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span>
+    <span class=n>implemented_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>GenericImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>generate</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>GenericControlImplementation</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate instance of this class.&quot;&quot;&quot;</span>
+        <span class=n>uuid</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>imp_reqs</span> <span class=o>=</span> <span class=p>[</span><span class=n>GenericImplementedRequirement</span><span class=o>.</span><span class=n>generate</span><span class=p>()]</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=s1>&#39;uuid&#39;</span><span class=p>:</span> <span class=n>uuid</span><span class=p>,</span>
+            <span class=s1>&#39;control-id&#39;</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span>
+            <span class=s1>&#39;source&#39;</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span>
+            <span class=s1>&#39;description&#39;</span><span class=p>:</span> <span class=s1>&#39;&#39;</span><span class=p>,</span>
+            <span class=s1>&#39;implemented-requirements&#39;</span><span class=p>:</span> <span class=n>imp_reqs</span>
+        <span class=p>}</span>
+        <span class=k>return</span> <span class=n>GenericControlImplementation</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>from_component_ci</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>control_imp</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>GenericControlImplementation</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert component control imp to generic.&quot;&quot;&quot;</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>IMPLEMENTED_REQUIREMENTS</span> <span class=ow>in</span> <span class=n>class_dict</span><span class=p>:</span>
+            <span class=n>new_irs</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>ir_list</span> <span class=o>=</span> <span class=n>class_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>IMPLEMENTED_REQUIREMENTS</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>ir</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ir_list</span><span class=p>):</span>
+                <span class=n>new_ir</span> <span class=o>=</span> <span class=n>GenericImplementedRequirement</span><span class=o>.</span><span class=n>from_comp_def</span><span class=p>(</span><span class=n>ir</span><span class=p>)</span>
+                <span class=n>new_irs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_ir</span><span class=p>)</span>
+            <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_irs</span><span class=p>)</span>
+            <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>IMPLEMENTED_REQUIREMENTS</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=n>new_sps</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>sp_list</span> <span class=o>=</span> <span class=n>class_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;set_parameters&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>sp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>sp_list</span><span class=p>):</span>
+                <span class=n>new_sps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>GenericSetParameter</span><span class=o>.</span><span class=n>from_defined_component</span><span class=p>(</span><span class=n>sp</span><span class=p>))</span>
+            <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_sps</span><span class=p>)</span>
+            <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;set_parameters&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=bp>cls</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>as_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Represent in ssp form.&quot;&quot;&quot;</span>
+        <span class=n>imp_reqs</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+            <span class=n>imp_reqs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>as_ssp</span><span class=p>())</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;uuid&#39;</span><span class=p>,</span> <span class=s1>&#39;source&#39;</span><span class=p>,</span> <span class=s1>&#39;props&#39;</span><span class=p>,</span> <span class=s1>&#39;links&#39;</span><span class=p>,</span> <span class=n>IMPLEMENTED_REQUIREMENTS</span><span class=p>]:</span>
+            <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>prop</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>imp_reqs</span><span class=p>:</span>
+            <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>imp_reqs</span>
+            <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>IMPLEMENTED_REQUIREMENTS</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.generic_oscal.GenericControlImplementation-attributes>Attributes<a href=#trestle.core.generic_oscal.GenericControlImplementation-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of how the specified set of controls are implemented for the containing component or capability.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericControlImplementation.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.implemented_requirements class="doc doc-heading"> <code class="highlight language-python"><span class=n>implemented_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>GenericImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericControlImplementation.implemented_requirements class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericControlImplementation.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericControlImplementation.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.set_parameters class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericSetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericControlImplementation.set_parameters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.source class="doc doc-heading"> <code class="highlight language-python"><span class=n>source</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A reference to an OSCAL catalog or profile providing the referenced control or subcontrol definition.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Source Resource Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericControlImplementation.source class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference a set of implemented controls elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation set can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Set Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericControlImplementation.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.generic_oscal.GenericControlImplementation-functions>Functions<a href=#trestle.core.generic_oscal.GenericControlImplementation-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.as_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_ssp</span><span class=p>()</span></code> <a href=#trestle.core.generic_oscal.GenericControlImplementation.as_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Represent in ssp form.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Represent in ssp form.&quot;&quot;&quot;</span>
+    <span class=n>imp_reqs</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+        <span class=n>imp_reqs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=n>as_ssp</span><span class=p>())</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span>
+    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;uuid&#39;</span><span class=p>,</span> <span class=s1>&#39;source&#39;</span><span class=p>,</span> <span class=s1>&#39;props&#39;</span><span class=p>,</span> <span class=s1>&#39;links&#39;</span><span class=p>,</span> <span class=n>IMPLEMENTED_REQUIREMENTS</span><span class=p>]:</span>
+        <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>prop</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>imp_reqs</span><span class=p>:</span>
+        <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>imp_reqs</span>
+        <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>IMPLEMENTED_REQUIREMENTS</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.from_component_ci class="doc doc-heading"> <code class="highlight language-python"><span class=n>from_component_ci</span><span class=p>(</span><span class=n>control_imp</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.generic_oscal.GenericControlImplementation.from_component_ci class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert component control imp to generic.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>from_component_ci</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>control_imp</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ControlImplementation</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>GenericControlImplementation</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert component control imp to generic.&quot;&quot;&quot;</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>control_imp</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>IMPLEMENTED_REQUIREMENTS</span> <span class=ow>in</span> <span class=n>class_dict</span><span class=p>:</span>
+        <span class=n>new_irs</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>ir_list</span> <span class=o>=</span> <span class=n>class_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>IMPLEMENTED_REQUIREMENTS</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>ir</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ir_list</span><span class=p>):</span>
+            <span class=n>new_ir</span> <span class=o>=</span> <span class=n>GenericImplementedRequirement</span><span class=o>.</span><span class=n>from_comp_def</span><span class=p>(</span><span class=n>ir</span><span class=p>)</span>
+            <span class=n>new_irs</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_ir</span><span class=p>)</span>
+        <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_irs</span><span class=p>)</span>
+        <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>IMPLEMENTED_REQUIREMENTS</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>new_sps</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>sp_list</span> <span class=o>=</span> <span class=n>class_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;set_parameters&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>sp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>sp_list</span><span class=p>):</span>
+            <span class=n>new_sps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>GenericSetParameter</span><span class=o>.</span><span class=n>from_defined_component</span><span class=p>(</span><span class=n>sp</span><span class=p>))</span>
+        <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_sps</span><span class=p>)</span>
+        <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;set_parameters&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=bp>cls</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericControlImplementation.generate class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.generic_oscal.GenericControlImplementation.generate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate instance of this class.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>generate</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>GenericControlImplementation</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate instance of this class.&quot;&quot;&quot;</span>
+    <span class=n>uuid</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>())</span>
+    <span class=n>imp_reqs</span> <span class=o>=</span> <span class=p>[</span><span class=n>GenericImplementedRequirement</span><span class=o>.</span><span class=n>generate</span><span class=p>()]</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=p>{</span>
+        <span class=s1>&#39;uuid&#39;</span><span class=p>:</span> <span class=n>uuid</span><span class=p>,</span>
+        <span class=s1>&#39;control-id&#39;</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span>
+        <span class=s1>&#39;source&#39;</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span>
+        <span class=s1>&#39;description&#39;</span><span class=p>:</span> <span class=s1>&#39;&#39;</span><span class=p>,</span>
+        <span class=s1>&#39;implemented-requirements&#39;</span><span class=p>:</span> <span class=n>imp_reqs</span>
+    <span class=p>}</span>
+    <span class=k>return</span> <span class=n>GenericControlImplementation</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.generic_oscal.GenericImplementedRequirement class="doc doc-heading"> <code>GenericImplementedRequirement</code> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.trestle_base_model.TrestleBaseModel href=../trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel>TrestleBaseModel</a></code></p> <p>Generic ImplementedRequirement for SSP and DefinedComponent.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>GenericImplementedRequirement</span><span class=p>(</span><span class=n>TrestleBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generic ImplementedRequirement for SSP and DefinedComponent.&quot;&quot;&quot;</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>  <span class=c1># noqa FS003 F722</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference a specific control implementation elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance).This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>  <span class=c1># noqa E501</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;A human-oriented identifier reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=c1># only compdef has description</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;A description of how the specified control is implemented for the containing component or capability.&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericSetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>statements</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericStatement</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=c1># ssp has following</span>
+    <span class=n>by_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-components&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>generate</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>GenericImplementedRequirement</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate instance of this class.&quot;&quot;&quot;</span>
+        <span class=n>uuid</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;uuid&#39;</span><span class=p>:</span> <span class=n>uuid</span><span class=p>,</span> <span class=s1>&#39;control-id&#39;</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span> <span class=s1>&#39;description&#39;</span><span class=p>:</span> <span class=s1>&#39;&#39;</span><span class=p>}</span>
+        <span class=k>return</span> <span class=n>GenericImplementedRequirement</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>from_comp_def</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>imp_req</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>GenericImplementedRequirement</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert component form of imp req to generic.&quot;&quot;&quot;</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+        <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;control-id&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;control_id&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>return</span> <span class=bp>cls</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>as_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert to ssp form.&quot;&quot;&quot;</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+        <span class=k>del</span> <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;description&#39;</span><span class=p>]</span>
+        <span class=n>new_stat_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+            <span class=n>new_stat_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>as_ssp</span><span class=p>())</span>
+        <span class=k>if</span> <span class=n>new_stat_list</span><span class=p>:</span>
+            <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;statements&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_stat_list</span>
+        <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.generic_oscal.GenericImplementedRequirement-attributes>Attributes<a href=#trestle.core.generic_oscal.GenericImplementedRequirement-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.by_components class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-components&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.by_components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-oriented identifier reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.control_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of how the specified control is implemented for the containing component or capability.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.set_parameters class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericSetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.set_parameters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.statements class="doc doc-heading"> <code class="highlight language-python"><span class=n>statements</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericStatement</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.statements class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference a specific control implementation elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance).This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.generic_oscal.GenericImplementedRequirement-functions>Functions<a href=#trestle.core.generic_oscal.GenericImplementedRequirement-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.as_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_ssp</span><span class=p>()</span></code> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.as_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert to ssp form.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert to ssp form.&quot;&quot;&quot;</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+    <span class=k>del</span> <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;description&#39;</span><span class=p>]</span>
+    <span class=n>new_stat_list</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+        <span class=n>new_stat_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>as_ssp</span><span class=p>())</span>
+    <span class=k>if</span> <span class=n>new_stat_list</span><span class=p>:</span>
+        <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;statements&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_stat_list</span>
+    <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.from_comp_def class="doc doc-heading"> <code class="highlight language-python"><span class=n>from_comp_def</span><span class=p>(</span><span class=n>imp_req</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.from_comp_def class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert component form of imp req to generic.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>from_comp_def</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>imp_req</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>GenericImplementedRequirement</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert component form of imp req to generic.&quot;&quot;&quot;</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=n>imp_req</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+    <span class=n>class_dict</span><span class=p>[</span><span class=s1>&#39;control-id&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;control_id&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=k>return</span> <span class=bp>cls</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericImplementedRequirement.generate class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.generic_oscal.GenericImplementedRequirement.generate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate instance of this class.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>generate</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>GenericImplementedRequirement</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate instance of this class.&quot;&quot;&quot;</span>
+    <span class=n>uuid</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>())</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;uuid&#39;</span><span class=p>:</span> <span class=n>uuid</span><span class=p>,</span> <span class=s1>&#39;control-id&#39;</span><span class=p>:</span> <span class=n>const</span><span class=o>.</span><span class=n>REPLACE_ME</span><span class=p>,</span> <span class=s1>&#39;description&#39;</span><span class=p>:</span> <span class=s1>&#39;&#39;</span><span class=p>}</span>
+    <span class=k>return</span> <span class=n>GenericImplementedRequirement</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.generic_oscal.GenericSetParameter class="doc doc-heading"> <code>GenericSetParameter</code> <a href=#trestle.core.generic_oscal.GenericSetParameter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.trestle_base_model.TrestleBaseModel href=../trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel>TrestleBaseModel</a></code></p> <p>Generic SetParameter for SSP and DefinedComponent.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>GenericSetParameter</span><span class=p>(</span><span class=n>TrestleBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generic SetParameter for SSP and DefinedComponent.&quot;&quot;&quot;</span>
+
+    <span class=n>param_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>  <span class=c1># noqa E501</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;param-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s2>&quot;A human-oriented reference to a parameter within a control, who&#39;s catalog has been imported into the current implementation context.&quot;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>values</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>from_defined_component</span><span class=p>(</span><span class=n>sp</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate generic set parameter from comp_def version.&quot;&quot;&quot;</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;param-id&#39;</span><span class=p>:</span> <span class=n>sp</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=s1>&#39;values&#39;</span><span class=p>:</span> <span class=n>sp</span><span class=o>.</span><span class=n>values</span><span class=p>,</span> <span class=s1>&#39;remarks&#39;</span><span class=p>:</span> <span class=n>sp</span><span class=o>.</span><span class=n>remarks</span><span class=p>}</span>
+        <span class=k>return</span> <span class=n>GenericSetParameter</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>to_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert to ssp format.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>values</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>remarks</span><span class=p>))</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.generic_oscal.GenericSetParameter-attributes>Attributes<a href=#trestle.core.generic_oscal.GenericSetParameter-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericSetParameter.param_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>param_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;param-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A human-oriented reference to a parameter within a control, who&#39;s catalog has been imported into the current implementation context.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericSetParameter.param_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericSetParameter.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericSetParameter.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericSetParameter.values class="doc doc-heading"> <code class="highlight language-python"><span class=n>values</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericSetParameter.values class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.generic_oscal.GenericSetParameter-functions>Functions<a href=#trestle.core.generic_oscal.GenericSetParameter-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericSetParameter.from_defined_component class="doc doc-heading"> <code class="highlight language-python"><span class=n>from_defined_component</span><span class=p>(</span><span class=n>sp</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.generic_oscal.GenericSetParameter.from_defined_component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate generic set parameter from comp_def version.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>from_defined_component</span><span class=p>(</span><span class=n>sp</span><span class=p>:</span> <span class=n>comp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate generic set parameter from comp_def version.&quot;&quot;&quot;</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;param-id&#39;</span><span class=p>:</span> <span class=n>sp</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=s1>&#39;values&#39;</span><span class=p>:</span> <span class=n>sp</span><span class=o>.</span><span class=n>values</span><span class=p>,</span> <span class=s1>&#39;remarks&#39;</span><span class=p>:</span> <span class=n>sp</span><span class=o>.</span><span class=n>remarks</span><span class=p>}</span>
+    <span class=k>return</span> <span class=n>GenericSetParameter</span><span class=p>(</span><span class=o>**</span><span class=n>class_dict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericSetParameter.to_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_ssp</span><span class=p>()</span></code> <a href=#trestle.core.generic_oscal.GenericSetParameter.to_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert to ssp format.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert to ssp format.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=p>(</span><span class=n>ossp</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>values</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>remarks</span><span class=p>))</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.generic_oscal.GenericStatement class="doc doc-heading"> <code>GenericStatement</code> <a href=#trestle.core.generic_oscal.GenericStatement class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.trestle_base_model.TrestleBaseModel href=../trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel>TrestleBaseModel</a></code></p> <p>Generic statement for SSP and DefinedComp.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>GenericStatement</span><span class=p>(</span><span class=n>TrestleBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generic statement for SSP and DefinedComp.&quot;&quot;&quot;</span>
+
+    <span class=n>statement_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>  <span class=c1># noqa FS003 E501</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;statement_id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-oriented identifier reference to a control statement.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>  <span class=c1># noqa FS003 F722</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>  <span class=c1># noqa E251</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).&#39;</span><span class=p>,</span>  <span class=c1># noqa E501</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=c1># this is not in ssp statement</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of how the containing control statement is implemented by the component or capability.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Statement Implementation Description&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=c1># ssp has following</span>
+    <span class=n>by_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-components&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>as_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Represent in ssp form.&quot;&quot;&quot;</span>
+        <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+        <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;description&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>by_comps</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+            <span class=n>new_by_comp</span> <span class=o>=</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>as_ssp</span><span class=p>()</span>
+            <span class=n>by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_by_comp</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>(</span>
+            <span class=n>statement_id</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>statement_id</span><span class=p>,</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>uuid</span><span class=p>,</span>
+            <span class=n>props</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>props</span><span class=p>,</span>
+            <span class=n>links</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>links</span><span class=p>,</span>
+            <span class=n>responsible_roles</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>responsible_roles</span><span class=p>,</span>
+            <span class=n>by_components</span><span class=o>=</span><span class=n>by_comps</span><span class=p>,</span>
+            <span class=n>remarks</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>remarks</span>
+        <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.generic_oscal.GenericStatement-attributes>Attributes<a href=#trestle.core.generic_oscal.GenericStatement-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericStatement.by_components class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>GenericByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-components&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericStatement.by_components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericStatement.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of how the containing control statement is implemented by the component or capability.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Statement Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericStatement.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericStatement.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericStatement.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericStatement.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericStatement.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericStatement.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericStatement.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericStatement.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericStatement.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericStatement.statement_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>statement_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;statement_id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-oriented identifier reference to a control statement.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericStatement.statement_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.generic_oscal.GenericStatement.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-4[0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.generic_oscal.GenericStatement.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.generic_oscal.GenericStatement-functions>Functions<a href=#trestle.core.generic_oscal.GenericStatement-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.generic_oscal.GenericStatement.as_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_ssp</span><span class=p>()</span></code> <a href=#trestle.core.generic_oscal.GenericStatement.as_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Represent in ssp form.</p> <details class=quote> <summary>Source code in <code>trestle/core/generic_oscal.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>as_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Represent in ssp form.&quot;&quot;&quot;</span>
+    <span class=n>class_dict</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>deepcopy</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span><span class=p>)</span>
+    <span class=n>class_dict</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=s1>&#39;description&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=n>by_comps</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+        <span class=n>new_by_comp</span> <span class=o>=</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>as_ssp</span><span class=p>()</span>
+        <span class=n>by_comps</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_by_comp</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>ossp</span><span class=o>.</span><span class=n>Statement</span><span class=p>(</span>
+        <span class=n>statement_id</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>statement_id</span><span class=p>,</span>
+        <span class=n>uuid</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>uuid</span><span class=p>,</span>
+        <span class=n>props</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>props</span><span class=p>,</span>
+        <span class=n>links</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>links</span><span class=p>,</span>
+        <span class=n>responsible_roles</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>responsible_roles</span><span class=p>,</span>
+        <span class=n>by_components</span><span class=o>=</span><span class=n>by_comps</span><span class=p>,</span>
+        <span class=n>remarks</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>remarks</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.generic_oscal-functions>Functions<a href=#trestle.core.generic_oscal-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/jinja/base/index.html b/latest/reference/API/trestle/core/jinja/base/index.html
new file mode 100644
index 000000000..d3301aa05
--- /dev/null
+++ b/latest/reference/API/trestle/core/jinja/base/index.html
@@ -0,0 +1,94 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.jinja.base module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/base/ rel=canonical><link href=../../crm/ssp_inheritance_api/ rel=prev><link href=../ext/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.jinja.base - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.jinja.base - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.jinja.base module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/jinja/base.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/base/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.jinja.base - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.jinja.base module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/jinja/base.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.jinja.base class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.jinja.base </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29 checked> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.jinja.base </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.jinja.base class=md-nav__link> <span class=md-ellipsis> base </span> </a> <nav class=md-nav aria-label=base> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension class=md-nav__link> <span class=md-ellipsis> TrestleJinjaExtension </span> </a> <nav class=md-nav aria-label=TrestleJinjaExtension> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension.max_tag_parse class=md-nav__link> <span class=md-ellipsis> max_tag_parse </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension.parse_expression class=md-nav__link> <span class=md-ellipsis> parse_expression </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.jinja.base class=md-nav__link> <span class=md-ellipsis> base </span> </a> <nav class=md-nav aria-label=base> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension class=md-nav__link> <span class=md-ellipsis> TrestleJinjaExtension </span> </a> <nav class=md-nav aria-label=TrestleJinjaExtension> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension.max_tag_parse class=md-nav__link> <span class=md-ellipsis> max_tag_parse </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.base.TrestleJinjaExtension.parse_expression class=md-nav__link> <span class=md-ellipsis> parse_expression </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.jinja.base</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.jinja.base class="doc doc-heading"> <code>trestle.core.jinja.base</code> <a href=#trestle.core.jinja.base class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle core.jinja base class.</p> <div class="doc doc-children"> <h3 id=trestle.core.jinja.base-classes>Classes<a href=#trestle.core.jinja.base-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.jinja.base.TrestleJinjaExtension class="doc doc-heading"> <code>TrestleJinjaExtension</code> <a href=#trestle.core.jinja.base.TrestleJinjaExtension class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=jinja2.ext.Extension>Extension</span></code></p> <p>Class to define common methods to be inherited from for use in trestle.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/base.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>22</span>
+<span class=normal>23</span>
+<span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TrestleJinjaExtension</span><span class=p>(</span><span class=n>Extension</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to define common methods to be inherited from for use in trestle.&quot;&quot;&quot;</span>
+
+    <span class=n>max_tag_parse</span> <span class=o>=</span> <span class=mi>20</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ensure enviroment is set and carried into class vars.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>parse_expression</span><span class=p>(</span><span class=n>parser</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Safely parse jinja expression.&quot;&quot;&quot;</span>
+        <span class=c1># Licensed under MIT from:</span>
+        <span class=c1># https://github.com/MoritzS/jinja2-django-tags/blob/master/jdj_tags/extensions.py#L424</span>
+        <span class=c1># Due to how the jinja2 parser works, it treats &quot;foo&quot; &quot;bar&quot; as a single</span>
+        <span class=c1># string literal as it is the case in python.</span>
+        <span class=c1># But the url tag in django supports multiple string arguments, e.g.</span>
+        <span class=c1># &quot;{% url &#39;my_view&#39; &#39;arg1&#39; &#39;arg2&#39; %}&quot;.</span>
+        <span class=c1># That&#39;s why we have to check if it&#39;s a string literal first.</span>
+        <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+        <span class=k>if</span> <span class=n>token</span><span class=o>.</span><span class=n>test</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>):</span>
+            <span class=n>expr</span> <span class=o>=</span> <span class=n>nodes</span><span class=o>.</span><span class=n>Const</span><span class=p>(</span><span class=n>token</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=n>lineno</span><span class=o>=</span><span class=n>token</span><span class=o>.</span><span class=n>lineno</span><span class=p>)</span>
+            <span class=nb>next</span><span class=p>(</span><span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>expr</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>parse_expression</span><span class=p>(</span><span class=kc>False</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>expr</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.jinja.base.TrestleJinjaExtension-attributes>Attributes<a href=#trestle.core.jinja.base.TrestleJinjaExtension-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.jinja.base.TrestleJinjaExtension.max_tag_parse class="doc doc-heading"> <code class="highlight language-python"><span class=n>max_tag_parse</span> <span class=o>=</span> <span class=mi>20</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.jinja.base.TrestleJinjaExtension.max_tag_parse class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.jinja.base.TrestleJinjaExtension-functions>Functions<a href=#trestle.core.jinja.base.TrestleJinjaExtension-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.jinja.base.TrestleJinjaExtension.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span></code> <a href=#trestle.core.jinja.base.TrestleJinjaExtension.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Ensure enviroment is set and carried into class vars.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/base.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Ensure enviroment is set and carried into class vars.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.jinja.base.TrestleJinjaExtension.parse_expression class="doc doc-heading"> <code class="highlight language-python"><span class=n>parse_expression</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.jinja.base.TrestleJinjaExtension.parse_expression class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Safely parse jinja expression.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/base.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>parse_expression</span><span class=p>(</span><span class=n>parser</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Safely parse jinja expression.&quot;&quot;&quot;</span>
+    <span class=c1># Licensed under MIT from:</span>
+    <span class=c1># https://github.com/MoritzS/jinja2-django-tags/blob/master/jdj_tags/extensions.py#L424</span>
+    <span class=c1># Due to how the jinja2 parser works, it treats &quot;foo&quot; &quot;bar&quot; as a single</span>
+    <span class=c1># string literal as it is the case in python.</span>
+    <span class=c1># But the url tag in django supports multiple string arguments, e.g.</span>
+    <span class=c1># &quot;{% url &#39;my_view&#39; &#39;arg1&#39; &#39;arg2&#39; %}&quot;.</span>
+    <span class=c1># That&#39;s why we have to check if it&#39;s a string literal first.</span>
+    <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+    <span class=k>if</span> <span class=n>token</span><span class=o>.</span><span class=n>test</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>):</span>
+        <span class=n>expr</span> <span class=o>=</span> <span class=n>nodes</span><span class=o>.</span><span class=n>Const</span><span class=p>(</span><span class=n>token</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=n>lineno</span><span class=o>=</span><span class=n>token</span><span class=o>.</span><span class=n>lineno</span><span class=p>)</span>
+        <span class=nb>next</span><span class=p>(</span><span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>expr</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>parse_expression</span><span class=p>(</span><span class=kc>False</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>expr</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/jinja/ext/index.html b/latest/reference/API/trestle/core/jinja/ext/index.html
new file mode 100644
index 000000000..ecb82e20b
--- /dev/null
+++ b/latest/reference/API/trestle/core/jinja/ext/index.html
@@ -0,0 +1,26 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.jinja.ext module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/ext/ rel=canonical><link href=../base/ rel=prev><link href=../filters/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.jinja.ext - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.jinja.ext - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.jinja.ext module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/jinja/ext.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/ext/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.jinja.ext - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.jinja.ext module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/jinja/ext.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.jinja.ext class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.jinja.ext </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29 checked> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.jinja.ext </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.jinja.ext class=md-nav__link> <span class=md-ellipsis> ext </span> </a> <nav class=md-nav aria-label=ext> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.ext-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.ext.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.ext-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.ext-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.ext.extensions class=md-nav__link> <span class=md-ellipsis> extensions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.jinja.ext class=md-nav__link> <span class=md-ellipsis> ext </span> </a> <nav class=md-nav aria-label=ext> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.ext-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.ext.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.ext-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.ext-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.ext.extensions class=md-nav__link> <span class=md-ellipsis> extensions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.jinja.ext</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.jinja.ext class="doc doc-heading"> <code>trestle.core.jinja.ext</code> <a href=#trestle.core.jinja.ext class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle core.jinja extension loading functionality.</p> <div class="doc doc-children"> <h3 id=trestle.core.jinja.ext-attributes>Attributes<a href=#trestle.core.jinja.ext-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.jinja.ext.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.jinja.ext.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.jinja.ext-classes>Classes<a href=#trestle.core.jinja.ext-classes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.core.jinja.ext-functions>Functions<a href=#trestle.core.jinja.ext-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.core.jinja.ext.extensions class="doc doc-heading"> <code class="highlight language-python"><span class=n>extensions</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-cached"><code>cached</code></small> </span> <a href=#trestle.core.jinja.ext.extensions class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Return list of Jinja extensions packaged with compliance-trestle and included from plugins.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/ext.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@functools</span><span class=o>.</span><span class=n>cache</span>
+<span class=k>def</span> <span class=nf>extensions</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Extension</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return list of Jinja extensions packaged with compliance-trestle and included from plugins.&quot;&quot;&quot;</span>
+    <span class=n>extensions</span> <span class=o>=</span> <span class=p>[</span><span class=n>tags</span><span class=o>.</span><span class=n>MDSectionInclude</span><span class=p>,</span> <span class=n>tags</span><span class=o>.</span><span class=n>MDCleanInclude</span><span class=p>,</span> <span class=n>tags</span><span class=o>.</span><span class=n>MDDatestamp</span><span class=p>,</span> <span class=n>filters</span><span class=o>.</span><span class=n>JinjaSSPFilters</span><span class=p>]</span>
+    <span class=c1># This block is uncovered as trestle cannot find plugins in it&#39;s unit tests - it is the base module.</span>
+    <span class=k>for</span> <span class=n>plugin</span><span class=p>,</span> <span class=n>ext_cls</span> <span class=ow>in</span> <span class=n>discovered_plugins</span><span class=p>(</span><span class=s1>&#39;jinja_ext&#39;</span><span class=p>):</span>  <span class=c1># pragma: nocover</span>
+        <span class=c1># add extensions (derived from TrestleJinjaExtension) to extensions list</span>
+        <span class=k>if</span> <span class=nb>issubclass</span><span class=p>(</span><span class=n>ext_cls</span><span class=p>,</span> <span class=n>Extension</span><span class=p>):</span>
+            <span class=c1># don&#39;t add Extension or TrestleJinjaExtension</span>
+            <span class=k>if</span> <span class=n>ext_cls</span> <span class=ow>is</span> <span class=ow>not</span> <span class=n>TrestleJinjaExtension</span> <span class=ow>and</span> <span class=n>ext_cls</span> <span class=ow>is</span> <span class=ow>not</span> <span class=n>Extension</span><span class=p>:</span>
+                <span class=n>extensions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ext_cls</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ext_cls</span><span class=si>}</span><span class=s1> added to jinja extensions from plugin </span><span class=si>{</span><span class=n>plugin</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>extensions</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/jinja/filters/index.html b/latest/reference/API/trestle/core/jinja/filters/index.html
new file mode 100644
index 000000000..7c7c651a6
--- /dev/null
+++ b/latest/reference/API/trestle/core/jinja/filters/index.html
@@ -0,0 +1,93 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.jinja.filters module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/filters/ rel=canonical><link href=../ext/ rel=prev><link href=../tags/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.jinja.filters - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.jinja.filters - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.jinja.filters module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/jinja/filters.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/filters/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.jinja.filters - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.jinja.filters module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/jinja/filters.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.jinja.filters class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.jinja.filters </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29 checked> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.jinja.filters </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.jinja.filters class=md-nav__link> <span class=md-ellipsis> filters </span> </a> <nav class=md-nav aria-label=filters> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.JinjaSSPFilters class=md-nav__link> <span class=md-ellipsis> JinjaSSPFilters </span> </a> <nav class=md-nav aria-label=JinjaSSPFilters> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.JinjaSSPFilters-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.JinjaSSPFilters.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.diagram_href class=md-nav__link> <span class=md-ellipsis> diagram_href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.first_or_none class=md-nav__link> <span class=md-ellipsis> first_or_none </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.get_party class=md-nav__link> <span class=md-ellipsis> get_party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.parties_for_role class=md-nav__link> <span class=md-ellipsis> parties_for_role </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.jinja.filters class=md-nav__link> <span class=md-ellipsis> filters </span> </a> <nav class=md-nav aria-label=filters> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.JinjaSSPFilters class=md-nav__link> <span class=md-ellipsis> JinjaSSPFilters </span> </a> <nav class=md-nav aria-label=JinjaSSPFilters> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.JinjaSSPFilters-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.JinjaSSPFilters.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.diagram_href class=md-nav__link> <span class=md-ellipsis> diagram_href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.first_or_none class=md-nav__link> <span class=md-ellipsis> first_or_none </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.get_party class=md-nav__link> <span class=md-ellipsis> get_party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.filters.parties_for_role class=md-nav__link> <span class=md-ellipsis> parties_for_role </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.jinja.filters</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.jinja.filters class="doc doc-heading"> <code>trestle.core.jinja.filters</code> <a href=#trestle.core.jinja.filters class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle utilities to customize jinja filters.</p> <div class="doc doc-children"> <h3 id=trestle.core.jinja.filters-attributes>Attributes<a href=#trestle.core.jinja.filters-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.jinja.filters.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.jinja.filters.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.jinja.filters-classes>Classes<a href=#trestle.core.jinja.filters-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.jinja.filters.JinjaSSPFilters class="doc doc-heading"> <code>JinjaSSPFilters</code> <a href=#trestle.core.jinja.filters.JinjaSSPFilters class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.jinja.base.TrestleJinjaExtension href=../base/#trestle.core.jinja.base.TrestleJinjaExtension>TrestleJinjaExtension</a></code></p> <p>Collection of useful OSCAL-specific filters.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/filters.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>JinjaSSPFilters</span><span class=p>(</span><span class=n>TrestleJinjaExtension</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Collection of useful OSCAL-specific filters.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize class and add filters.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>(</span><span class=n>JinjaSSPFilters</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+
+        <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;as_list&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>as_list</span>
+        <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;get_default&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>get_default</span>
+        <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;first_or_none&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>first_or_none</span>
+        <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;get_party&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>get_party</span>
+        <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;parties_for_role&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>parties_for_role</span>
+        <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;diagram_href&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>diagram_href</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.jinja.filters.JinjaSSPFilters-functions>Functions<a href=#trestle.core.jinja.filters.JinjaSSPFilters-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.jinja.filters.JinjaSSPFilters.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span></code> <a href=#trestle.core.jinja.filters.JinjaSSPFilters.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize class and add filters.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/filters.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize class and add filters.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>(</span><span class=n>JinjaSSPFilters</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+
+    <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;as_list&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>as_list</span>
+    <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;get_default&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>get_default</span>
+    <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;first_or_none&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>first_or_none</span>
+    <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;get_party&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>get_party</span>
+    <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;parties_for_role&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>parties_for_role</span>
+    <span class=n>environment</span><span class=o>.</span><span class=n>filters</span><span class=p>[</span><span class=s1>&#39;diagram_href&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>diagram_href</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.jinja.filters-functions>Functions<a href=#trestle.core.jinja.filters-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.core.jinja.filters.diagram_href class="doc doc-heading"> <code class="highlight language-python"><span class=n>diagram_href</span><span class=p>(</span><span class=n>diagram</span><span class=p>)</span></code> <a href=#trestle.core.jinja.filters.diagram_href class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Retrieve the diagrams's link href.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/filters.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>diagram_href</span><span class=p>(</span><span class=n>diagram</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Diagram</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Retrieve the diagrams&#39;s link href.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>diagram</span><span class=p>:</span>
+        <span class=k>return</span> <span class=nb>next</span><span class=p>((</span><span class=n>link</span><span class=o>.</span><span class=n>href</span> <span class=k>for</span> <span class=n>link</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>diagram</span><span class=o>.</span><span class=n>links</span><span class=p>)</span> <span class=k>if</span> <span class=n>link</span><span class=o>.</span><span class=n>rel</span> <span class=o>==</span> <span class=s1>&#39;diagram&#39;</span><span class=p>),</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.jinja.filters.first_or_none class="doc doc-heading"> <code class="highlight language-python"><span class=n>first_or_none</span><span class=p>(</span><span class=n>value</span><span class=p>)</span></code> <a href=#trestle.core.jinja.filters.first_or_none class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Retrieve the first array entry, or None for lists that are None or empty.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/filters.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>first_or_none</span><span class=p>(</span><span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Retrieve the first array entry, or None for lists that are None or empty.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>next</span><span class=p>(</span><span class=nb>iter</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>value</span><span class=p>)),</span> <span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.jinja.filters.get_party class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_party</span><span class=p>(</span><span class=n>uuid</span><span class=p>,</span> <span class=n>ssp</span><span class=p>)</span></code> <a href=#trestle.core.jinja.filters.get_party class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get the metadata.parties entry for this UUID.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/filters.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_party</span><span class=p>(</span><span class=n>uuid</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>SystemSecurityPlan</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Party</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the metadata.parties entry for this UUID.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>next</span><span class=p>((</span><span class=n>x</span> <span class=k>for</span> <span class=n>x</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>ssp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>parties</span><span class=p>)</span> <span class=k>if</span> <span class=n>x</span><span class=o>.</span><span class=n>uuid</span> <span class=o>==</span> <span class=n>uuid</span><span class=p>),</span> <span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.jinja.filters.parties_for_role class="doc doc-heading"> <code class="highlight language-python"><span class=n>parties_for_role</span><span class=p>(</span><span class=n>responsible_parties</span><span class=p>,</span> <span class=n>role_id</span><span class=p>,</span> <span class=n>ssp</span><span class=p>)</span></code> <a href=#trestle.core.jinja.filters.parties_for_role class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get a list of parties from a list of responsible_parties and a given role_id.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/filters.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>parties_for_role</span><span class=p>(</span><span class=n>responsible_parties</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>],</span> <span class=n>role_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                     <span class=n>ssp</span><span class=p>:</span> <span class=n>SystemSecurityPlan</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>Party</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get a list of parties from a list of responsible_parties and a given role_id.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Finding parties for role: </span><span class=si>{</span><span class=n>role_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>responsible_party</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>responsible_parties</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>responsible_party</span><span class=o>.</span><span class=n>role_id</span> <span class=o>==</span> <span class=n>role_id</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Found responsible party for role_id: </span><span class=si>{</span><span class=n>role_id</span><span class=si>}</span><span class=s1> with </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>responsible_party</span><span class=o>.</span><span class=n>party_uuids</span><span class=p>)</span><span class=si>}</span><span class=s1> parties&#39;</span>
+            <span class=p>)</span>
+            <span class=k>for</span> <span class=n>uuid</span> <span class=ow>in</span> <span class=n>responsible_party</span><span class=o>.</span><span class=n>party_uuids</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Looking for parties with uuid: </span><span class=si>{</span><span class=n>uuid</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>party</span> <span class=o>=</span> <span class=n>get_party</span><span class=p>(</span><span class=n>uuid</span><span class=p>,</span> <span class=n>ssp</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>party</span><span class=p>:</span>
+                    <span class=k>yield</span> <span class=n>party</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/jinja/tags/index.html b/latest/reference/API/trestle/core/jinja/tags/index.html
new file mode 100644
index 000000000..b50f1d6f8
--- /dev/null
+++ b/latest/reference/API/trestle/core/jinja/tags/index.html
@@ -0,0 +1,581 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.jinja.tags module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/tags/ rel=canonical><link href=../filters/ rel=prev><link href=../../markdown/base_markdown_node/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.jinja.tags - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.jinja.tags - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.jinja.tags module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/jinja/tags.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/tags/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.jinja.tags - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.jinja.tags module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/jinja/tags.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.jinja.tags class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.jinja.tags </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29 checked> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.jinja.tags </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.jinja.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> <nav class=md-nav aria-label=tags> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude class=md-nav__link> <span class=md-ellipsis> MDCleanInclude </span> </a> <nav class=md-nav aria-label=MDCleanInclude> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude.parse class=md-nav__link> <span class=md-ellipsis> parse </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp class=md-nav__link> <span class=md-ellipsis> MDDatestamp </span> </a> <nav class=md-nav aria-label=MDDatestamp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp.parse class=md-nav__link> <span class=md-ellipsis> parse </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude class=md-nav__link> <span class=md-ellipsis> MDSectionInclude </span> </a> <nav class=md-nav aria-label=MDSectionInclude> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude.parse class=md-nav__link> <span class=md-ellipsis> parse </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.adjust_heading_level class=md-nav__link> <span class=md-ellipsis> adjust_heading_level </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.jinja.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> <nav class=md-nav aria-label=tags> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude class=md-nav__link> <span class=md-ellipsis> MDCleanInclude </span> </a> <nav class=md-nav aria-label=MDCleanInclude> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDCleanInclude.parse class=md-nav__link> <span class=md-ellipsis> parse </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp class=md-nav__link> <span class=md-ellipsis> MDDatestamp </span> </a> <nav class=md-nav aria-label=MDDatestamp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDDatestamp.parse class=md-nav__link> <span class=md-ellipsis> parse </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude class=md-nav__link> <span class=md-ellipsis> MDSectionInclude </span> </a> <nav class=md-nav aria-label=MDSectionInclude> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.MDSectionInclude.parse class=md-nav__link> <span class=md-ellipsis> parse </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.jinja.tags-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.jinja.tags.adjust_heading_level class=md-nav__link> <span class=md-ellipsis> adjust_heading_level </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.jinja.tags</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.jinja.tags class="doc doc-heading"> <code>trestle.core.jinja.tags</code> <a href=#trestle.core.jinja.tags class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle utilities to customize jinja tags.</p> <div class="doc doc-children"> <h3 id=trestle.core.jinja.tags-attributes>Attributes<a href=#trestle.core.jinja.tags-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.jinja.tags.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.jinja.tags.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.jinja.tags-classes>Classes<a href=#trestle.core.jinja.tags-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.jinja.tags.MDCleanInclude class="doc doc-heading"> <code>MDCleanInclude</code> <a href=#trestle.core.jinja.tags.MDCleanInclude class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.jinja.base.TrestleJinjaExtension href=../base/#trestle.core.jinja.base.TrestleJinjaExtension>TrestleJinjaExtension</a></code></p> <p>Inject the parameter of the tag as the resulting content.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>MDCleanInclude</span><span class=p>(</span><span class=n>TrestleJinjaExtension</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Inject the parameter of the tag as the resulting content.&quot;&quot;&quot;</span>
+
+    <span class=n>tags</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;md_clean_include&#39;</span><span class=p>}</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ensure enviroment is set and carried into class vars.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>parse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>parser</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute parsing of md token and return nodes.&quot;&quot;&quot;</span>
+        <span class=n>kwargs</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>expected_heading_level</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>count</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>while</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span><span class=o>.</span><span class=n>type</span> <span class=o>!=</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_BLOCK_END</span><span class=p>:</span>
+            <span class=n>count</span> <span class=o>=</span> <span class=n>count</span> <span class=o>+</span> <span class=mi>1</span>
+            <span class=k>if</span> <span class=n>count</span> <span class=o>&gt;</span> <span class=bp>self</span><span class=o>.</span><span class=n>max_tag_parse</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unexpected Jinja tag structure provided, please review docs.&#39;</span><span class=p>)</span>
+            <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+            <span class=k>if</span> <span class=n>token</span><span class=o>.</span><span class=n>test</span><span class=p>(</span><span class=s1>&#39;name:md_clean_include&#39;</span><span class=p>):</span>
+                <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_NAME</span><span class=p>)</span>
+                <span class=n>markdown_source</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>arg</span> <span class=o>=</span> <span class=n>token</span><span class=o>.</span><span class=n>value</span>
+                <span class=nb>next</span><span class=p>(</span><span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=p>)</span>
+                <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>)</span>
+                <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+                <span class=n>exp</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>parse_expression</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span>
+                <span class=n>kwargs</span><span class=p>[</span><span class=n>arg</span><span class=p>]</span> <span class=o>=</span> <span class=n>exp</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>look</span><span class=p>()</span><span class=o>.</span><span class=n>type</span> <span class=o>==</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>:</span>
+                    <span class=n>kwargs</span> <span class=o>=</span> <span class=p>{}</span>
+                <span class=k>continue</span>
+        <span class=n>md_content</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=o>.</span><span class=n>loader</span><span class=o>.</span><span class=n>get_source</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>markdown_source</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+        <span class=n>fm</span> <span class=o>=</span> <span class=n>frontmatter</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>md_content</span><span class=p>)</span>
+        <span class=n>content</span> <span class=o>=</span> <span class=n>fm</span><span class=o>.</span><span class=n>content</span>
+        <span class=n>content</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n\n</span><span class=s1>&#39;</span>
+        <span class=k>if</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>expected_heading_level</span> <span class=o>=</span> <span class=n>kwargs</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;heading_level&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>expected_heading_level</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>content</span> <span class=o>=</span> <span class=n>adjust_heading_level</span><span class=p>(</span><span class=n>content</span><span class=p>,</span> <span class=n>expected_heading_level</span><span class=p>)</span>
+
+        <span class=n>local_parser</span> <span class=o>=</span> <span class=n>Parser</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>content</span><span class=p>)</span>
+        <span class=n>top_level_output</span> <span class=o>=</span> <span class=n>local_parser</span><span class=o>.</span><span class=n>parse</span><span class=p>()</span>
+
+        <span class=k>return</span> <span class=n>top_level_output</span><span class=o>.</span><span class=n>body</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.jinja.tags.MDCleanInclude-attributes>Attributes<a href=#trestle.core.jinja.tags.MDCleanInclude-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.jinja.tags.MDCleanInclude.tags class="doc doc-heading"> <code class="highlight language-python"><span class=n>tags</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;md_clean_include&#39;</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.jinja.tags.MDCleanInclude.tags class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.jinja.tags.MDCleanInclude-functions>Functions<a href=#trestle.core.jinja.tags.MDCleanInclude-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.jinja.tags.MDCleanInclude.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span></code> <a href=#trestle.core.jinja.tags.MDCleanInclude.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Ensure enviroment is set and carried into class vars.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Ensure enviroment is set and carried into class vars.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.jinja.tags.MDCleanInclude.parse class="doc doc-heading"> <code class="highlight language-python"><span class=n>parse</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span></code> <a href=#trestle.core.jinja.tags.MDCleanInclude.parse class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute parsing of md token and return nodes.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>parse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>parser</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute parsing of md token and return nodes.&quot;&quot;&quot;</span>
+    <span class=n>kwargs</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>expected_heading_level</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>count</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=k>while</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span><span class=o>.</span><span class=n>type</span> <span class=o>!=</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_BLOCK_END</span><span class=p>:</span>
+        <span class=n>count</span> <span class=o>=</span> <span class=n>count</span> <span class=o>+</span> <span class=mi>1</span>
+        <span class=k>if</span> <span class=n>count</span> <span class=o>&gt;</span> <span class=bp>self</span><span class=o>.</span><span class=n>max_tag_parse</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unexpected Jinja tag structure provided, please review docs.&#39;</span><span class=p>)</span>
+        <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+        <span class=k>if</span> <span class=n>token</span><span class=o>.</span><span class=n>test</span><span class=p>(</span><span class=s1>&#39;name:md_clean_include&#39;</span><span class=p>):</span>
+            <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_NAME</span><span class=p>)</span>
+            <span class=n>markdown_source</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>arg</span> <span class=o>=</span> <span class=n>token</span><span class=o>.</span><span class=n>value</span>
+            <span class=nb>next</span><span class=p>(</span><span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=p>)</span>
+            <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>)</span>
+            <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+            <span class=n>exp</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>parse_expression</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span>
+            <span class=n>kwargs</span><span class=p>[</span><span class=n>arg</span><span class=p>]</span> <span class=o>=</span> <span class=n>exp</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>look</span><span class=p>()</span><span class=o>.</span><span class=n>type</span> <span class=o>==</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>:</span>
+                <span class=n>kwargs</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>continue</span>
+    <span class=n>md_content</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=o>.</span><span class=n>loader</span><span class=o>.</span><span class=n>get_source</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>markdown_source</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+    <span class=n>fm</span> <span class=o>=</span> <span class=n>frontmatter</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>md_content</span><span class=p>)</span>
+    <span class=n>content</span> <span class=o>=</span> <span class=n>fm</span><span class=o>.</span><span class=n>content</span>
+    <span class=n>content</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n\n</span><span class=s1>&#39;</span>
+    <span class=k>if</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>expected_heading_level</span> <span class=o>=</span> <span class=n>kwargs</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;heading_level&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>expected_heading_level</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>content</span> <span class=o>=</span> <span class=n>adjust_heading_level</span><span class=p>(</span><span class=n>content</span><span class=p>,</span> <span class=n>expected_heading_level</span><span class=p>)</span>
+
+    <span class=n>local_parser</span> <span class=o>=</span> <span class=n>Parser</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>content</span><span class=p>)</span>
+    <span class=n>top_level_output</span> <span class=o>=</span> <span class=n>local_parser</span><span class=o>.</span><span class=n>parse</span><span class=p>()</span>
+
+    <span class=k>return</span> <span class=n>top_level_output</span><span class=o>.</span><span class=n>body</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.jinja.tags.MDDatestamp class="doc doc-heading"> <code>MDDatestamp</code> <a href=#trestle.core.jinja.tags.MDDatestamp class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.jinja.base.TrestleJinjaExtension href=../base/#trestle.core.jinja.base.TrestleJinjaExtension>TrestleJinjaExtension</a></code></p> <p>Inject the parameter of the tag as the resulting content.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>MDDatestamp</span><span class=p>(</span><span class=n>TrestleJinjaExtension</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Inject the parameter of the tag as the resulting content.&quot;&quot;&quot;</span>
+
+    <span class=n>tags</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;md_datestamp&#39;</span><span class=p>}</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ensure enviroment is set and carried into class vars.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>parse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>parser</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute parsing of md token and return nodes.&quot;&quot;&quot;</span>
+        <span class=n>kwargs</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>count</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>while</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span><span class=o>.</span><span class=n>type</span> <span class=o>!=</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_BLOCK_END</span><span class=p>:</span>
+            <span class=n>count</span> <span class=o>=</span> <span class=n>count</span> <span class=o>+</span> <span class=mi>1</span>
+            <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+            <span class=k>if</span> <span class=n>count</span> <span class=o>&gt;</span> <span class=bp>self</span><span class=o>.</span><span class=n>max_tag_parse</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unexpected Jinja tag structure provided at token </span><span class=si>{</span><span class=n>token</span><span class=o>.</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>token</span><span class=o>.</span><span class=n>test</span><span class=p>(</span><span class=s1>&#39;name:md_datestamp&#39;</span><span class=p>):</span>
+                <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_NAME</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>arg</span> <span class=o>=</span> <span class=n>token</span><span class=o>.</span><span class=n>value</span>
+                <span class=nb>next</span><span class=p>(</span><span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=p>)</span>
+                <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>)</span>
+                <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+                <span class=n>exp</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>parse_expression</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span>
+                <span class=n>kwargs</span><span class=p>[</span><span class=n>arg</span><span class=p>]</span> <span class=o>=</span> <span class=n>exp</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>look</span><span class=p>()</span><span class=o>.</span><span class=n>type</span> <span class=o>==</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span> <span class=ow>or</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>look</span><span class=p>()</span><span class=o>.</span><span class=n>type</span> <span class=o>==</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>:</span>
+                    <span class=n>kwargs</span> <span class=o>=</span> <span class=p>{}</span>
+                <span class=k>continue</span>
+
+        <span class=k>if</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;format&#39;</span> <span class=ow>in</span> <span class=n>kwargs</span> <span class=ow>and</span> <span class=nb>type</span><span class=p>(</span><span class=n>kwargs</span><span class=p>[</span><span class=s1>&#39;format&#39;</span><span class=p>]</span> <span class=ow>is</span> <span class=nb>str</span><span class=p>):</span>
+                <span class=n>date_string</span> <span class=o>=</span> <span class=n>date</span><span class=o>.</span><span class=n>today</span><span class=p>()</span><span class=o>.</span><span class=n>strftime</span><span class=p>(</span><span class=n>kwargs</span><span class=p>[</span><span class=s1>&#39;format&#39;</span><span class=p>])</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>date_string</span> <span class=o>=</span> <span class=n>date</span><span class=o>.</span><span class=n>today</span><span class=p>()</span><span class=o>.</span><span class=n>strftime</span><span class=p>(</span><span class=n>markdown_const</span><span class=o>.</span><span class=n>JINJA_DATESTAMP_FORMAT</span><span class=p>)</span>
+            <span class=k>if</span> <span class=s1>&#39;newline&#39;</span> <span class=ow>in</span> <span class=n>kwargs</span> <span class=ow>and</span> <span class=n>kwargs</span><span class=p>[</span><span class=s1>&#39;newline&#39;</span><span class=p>]</span> <span class=ow>is</span> <span class=kc>False</span><span class=p>:</span>
+                <span class=k>pass</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>date_string</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n\n</span><span class=s1>&#39;</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>date_string</span> <span class=o>=</span> <span class=n>date</span><span class=o>.</span><span class=n>today</span><span class=p>()</span><span class=o>.</span><span class=n>strftime</span><span class=p>(</span><span class=n>markdown_const</span><span class=o>.</span><span class=n>JINJA_DATESTAMP_FORMAT</span><span class=p>)</span> <span class=o>+</span> <span class=s1>&#39;</span><span class=se>\n\n</span><span class=s1>&#39;</span>
+
+        <span class=n>local_parser</span> <span class=o>=</span> <span class=n>Parser</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>date_string</span><span class=p>)</span>
+        <span class=n>datestamp_output</span> <span class=o>=</span> <span class=n>local_parser</span><span class=o>.</span><span class=n>parse</span><span class=p>()</span>
+
+        <span class=k>return</span> <span class=n>datestamp_output</span><span class=o>.</span><span class=n>body</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.jinja.tags.MDDatestamp-attributes>Attributes<a href=#trestle.core.jinja.tags.MDDatestamp-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.jinja.tags.MDDatestamp.tags class="doc doc-heading"> <code class="highlight language-python"><span class=n>tags</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;md_datestamp&#39;</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.jinja.tags.MDDatestamp.tags class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.jinja.tags.MDDatestamp-functions>Functions<a href=#trestle.core.jinja.tags.MDDatestamp-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.jinja.tags.MDDatestamp.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span></code> <a href=#trestle.core.jinja.tags.MDDatestamp.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Ensure enviroment is set and carried into class vars.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Ensure enviroment is set and carried into class vars.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.jinja.tags.MDDatestamp.parse class="doc doc-heading"> <code class="highlight language-python"><span class=n>parse</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span></code> <a href=#trestle.core.jinja.tags.MDDatestamp.parse class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute parsing of md token and return nodes.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>parse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>parser</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute parsing of md token and return nodes.&quot;&quot;&quot;</span>
+    <span class=n>kwargs</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>count</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=k>while</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span><span class=o>.</span><span class=n>type</span> <span class=o>!=</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_BLOCK_END</span><span class=p>:</span>
+        <span class=n>count</span> <span class=o>=</span> <span class=n>count</span> <span class=o>+</span> <span class=mi>1</span>
+        <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+        <span class=k>if</span> <span class=n>count</span> <span class=o>&gt;</span> <span class=bp>self</span><span class=o>.</span><span class=n>max_tag_parse</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unexpected Jinja tag structure provided at token </span><span class=si>{</span><span class=n>token</span><span class=o>.</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>token</span><span class=o>.</span><span class=n>test</span><span class=p>(</span><span class=s1>&#39;name:md_datestamp&#39;</span><span class=p>):</span>
+            <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_NAME</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>arg</span> <span class=o>=</span> <span class=n>token</span><span class=o>.</span><span class=n>value</span>
+            <span class=nb>next</span><span class=p>(</span><span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=p>)</span>
+            <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>)</span>
+            <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+            <span class=n>exp</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>parse_expression</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span>
+            <span class=n>kwargs</span><span class=p>[</span><span class=n>arg</span><span class=p>]</span> <span class=o>=</span> <span class=n>exp</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>look</span><span class=p>()</span><span class=o>.</span><span class=n>type</span> <span class=o>==</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span> <span class=ow>or</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>look</span><span class=p>()</span><span class=o>.</span><span class=n>type</span> <span class=o>==</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>:</span>
+                <span class=n>kwargs</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>continue</span>
+
+    <span class=k>if</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>if</span> <span class=s1>&#39;format&#39;</span> <span class=ow>in</span> <span class=n>kwargs</span> <span class=ow>and</span> <span class=nb>type</span><span class=p>(</span><span class=n>kwargs</span><span class=p>[</span><span class=s1>&#39;format&#39;</span><span class=p>]</span> <span class=ow>is</span> <span class=nb>str</span><span class=p>):</span>
+            <span class=n>date_string</span> <span class=o>=</span> <span class=n>date</span><span class=o>.</span><span class=n>today</span><span class=p>()</span><span class=o>.</span><span class=n>strftime</span><span class=p>(</span><span class=n>kwargs</span><span class=p>[</span><span class=s1>&#39;format&#39;</span><span class=p>])</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>date_string</span> <span class=o>=</span> <span class=n>date</span><span class=o>.</span><span class=n>today</span><span class=p>()</span><span class=o>.</span><span class=n>strftime</span><span class=p>(</span><span class=n>markdown_const</span><span class=o>.</span><span class=n>JINJA_DATESTAMP_FORMAT</span><span class=p>)</span>
+        <span class=k>if</span> <span class=s1>&#39;newline&#39;</span> <span class=ow>in</span> <span class=n>kwargs</span> <span class=ow>and</span> <span class=n>kwargs</span><span class=p>[</span><span class=s1>&#39;newline&#39;</span><span class=p>]</span> <span class=ow>is</span> <span class=kc>False</span><span class=p>:</span>
+            <span class=k>pass</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>date_string</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n\n</span><span class=s1>&#39;</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>date_string</span> <span class=o>=</span> <span class=n>date</span><span class=o>.</span><span class=n>today</span><span class=p>()</span><span class=o>.</span><span class=n>strftime</span><span class=p>(</span><span class=n>markdown_const</span><span class=o>.</span><span class=n>JINJA_DATESTAMP_FORMAT</span><span class=p>)</span> <span class=o>+</span> <span class=s1>&#39;</span><span class=se>\n\n</span><span class=s1>&#39;</span>
+
+    <span class=n>local_parser</span> <span class=o>=</span> <span class=n>Parser</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>date_string</span><span class=p>)</span>
+    <span class=n>datestamp_output</span> <span class=o>=</span> <span class=n>local_parser</span><span class=o>.</span><span class=n>parse</span><span class=p>()</span>
+
+    <span class=k>return</span> <span class=n>datestamp_output</span><span class=o>.</span><span class=n>body</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.jinja.tags.MDSectionInclude class="doc doc-heading"> <code>MDSectionInclude</code> <a href=#trestle.core.jinja.tags.MDSectionInclude class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.jinja.base.TrestleJinjaExtension href=../base/#trestle.core.jinja.base.TrestleJinjaExtension>TrestleJinjaExtension</a></code></p> <p>Inject the parameter of the tag as the resulting content.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>MDSectionInclude</span><span class=p>(</span><span class=n>TrestleJinjaExtension</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Inject the parameter of the tag as the resulting content.&quot;&quot;&quot;</span>
+
+    <span class=n>tags</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;mdsection_include&#39;</span><span class=p>}</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ensure enviroment is set and carried into class vars.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>parse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>parser</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute parsing of md token and return nodes.&quot;&quot;&quot;</span>
+        <span class=n>kwargs</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>expected_heading_level</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>count</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>while</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span><span class=o>.</span><span class=n>type</span> <span class=o>!=</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_BLOCK_END</span><span class=p>:</span>
+            <span class=n>count</span> <span class=o>=</span> <span class=n>count</span> <span class=o>+</span> <span class=mi>1</span>
+            <span class=k>if</span> <span class=n>count</span> <span class=o>&gt;</span> <span class=bp>self</span><span class=o>.</span><span class=n>max_tag_parse</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unexpected Jinja tag structure provided, please review docs.&#39;</span><span class=p>)</span>
+            <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+            <span class=k>if</span> <span class=n>token</span><span class=o>.</span><span class=n>test</span><span class=p>(</span><span class=s1>&#39;name:mdsection_include&#39;</span><span class=p>):</span>
+                <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_NAME</span><span class=p>)</span>
+                <span class=n>markdown_source</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>)</span>
+                <span class=n>section_title</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>arg</span> <span class=o>=</span> <span class=n>token</span><span class=o>.</span><span class=n>value</span>
+                <span class=nb>next</span><span class=p>(</span><span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=p>)</span>
+                <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>)</span>
+                <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+                <span class=n>exp</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>parse_expression</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span>
+                <span class=n>kwargs</span><span class=p>[</span><span class=n>arg</span><span class=p>]</span> <span class=o>=</span> <span class=n>exp</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>look</span><span class=p>()</span><span class=o>.</span><span class=n>type</span> <span class=o>==</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>:</span>
+                    <span class=n>kwargs</span> <span class=o>=</span> <span class=p>{}</span>
+                <span class=k>continue</span>
+        <span class=c1># Use the established environment to source the file</span>
+        <span class=n>md_content</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=o>.</span><span class=n>loader</span><span class=o>.</span><span class=n>get_source</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>markdown_source</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+        <span class=n>fm</span> <span class=o>=</span> <span class=n>frontmatter</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>md_content</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>fm</span><span class=o>.</span><span class=n>metadata</span> <span class=o>==</span> <span class=p>{}:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Non zero metadata on MD section include - ignoring&#39;</span><span class=p>)</span>
+        <span class=n>full_md</span> <span class=o>=</span> <span class=n>docs_markdown_node</span><span class=o>.</span><span class=n>DocsMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>fm</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>))</span>
+        <span class=n>md_section</span> <span class=o>=</span> <span class=n>full_md</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>section_title</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=n>strict_matching</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># adjust</span>
+        <span class=k>if</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>expected_heading_level</span> <span class=o>=</span> <span class=n>kwargs</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;heading_level&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>expected_heading_level</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>level</span> <span class=o>=</span> <span class=n>md_section</span><span class=o>.</span><span class=n>get_node_header_lvl</span><span class=p>()</span>
+            <span class=n>delta</span> <span class=o>=</span> <span class=nb>int</span><span class=p>(</span><span class=n>expected_heading_level</span><span class=p>)</span> <span class=o>-</span> <span class=n>level</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>delta</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>md_section</span><span class=o>.</span><span class=n>change_header_level_by</span><span class=p>(</span><span class=n>delta</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>md_section</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Unable to retrieve section &quot;</span><span class=si>{</span><span class=n>section_title</span><span class=o>.</span><span class=n>value</span><span class=si>}</span><span class=s1>&quot;&quot; from </span><span class=si>{</span><span class=n>markdown_source</span><span class=o>.</span><span class=n>value</span><span class=si>}</span><span class=s1> jinja template.&#39;</span>
+            <span class=p>)</span>
+        <span class=n>local_parser</span> <span class=o>=</span> <span class=n>Parser</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>md_section</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=p>)</span>
+        <span class=n>top_level_output</span> <span class=o>=</span> <span class=n>local_parser</span><span class=o>.</span><span class=n>parse</span><span class=p>()</span>
+
+        <span class=k>return</span> <span class=n>top_level_output</span><span class=o>.</span><span class=n>body</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.jinja.tags.MDSectionInclude-attributes>Attributes<a href=#trestle.core.jinja.tags.MDSectionInclude-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.jinja.tags.MDSectionInclude.tags class="doc doc-heading"> <code class="highlight language-python"><span class=n>tags</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;mdsection_include&#39;</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.jinja.tags.MDSectionInclude.tags class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.jinja.tags.MDSectionInclude-functions>Functions<a href=#trestle.core.jinja.tags.MDSectionInclude-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.jinja.tags.MDSectionInclude.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span></code> <a href=#trestle.core.jinja.tags.MDSectionInclude.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Ensure enviroment is set and carried into class vars.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>environment</span><span class=p>:</span> <span class=n>Environment</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Ensure enviroment is set and carried into class vars.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>environment</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.jinja.tags.MDSectionInclude.parse class="doc doc-heading"> <code class="highlight language-python"><span class=n>parse</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span></code> <a href=#trestle.core.jinja.tags.MDSectionInclude.parse class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute parsing of md token and return nodes.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>parse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>parser</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute parsing of md token and return nodes.&quot;&quot;&quot;</span>
+    <span class=n>kwargs</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>expected_heading_level</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>count</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=k>while</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span><span class=o>.</span><span class=n>type</span> <span class=o>!=</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_BLOCK_END</span><span class=p>:</span>
+        <span class=n>count</span> <span class=o>=</span> <span class=n>count</span> <span class=o>+</span> <span class=mi>1</span>
+        <span class=k>if</span> <span class=n>count</span> <span class=o>&gt;</span> <span class=bp>self</span><span class=o>.</span><span class=n>max_tag_parse</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unexpected Jinja tag structure provided, please review docs.&#39;</span><span class=p>)</span>
+        <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+        <span class=k>if</span> <span class=n>token</span><span class=o>.</span><span class=n>test</span><span class=p>(</span><span class=s1>&#39;name:mdsection_include&#39;</span><span class=p>):</span>
+            <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_NAME</span><span class=p>)</span>
+            <span class=n>markdown_source</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>)</span>
+            <span class=n>section_title</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_STRING</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>arg</span> <span class=o>=</span> <span class=n>token</span><span class=o>.</span><span class=n>value</span>
+            <span class=nb>next</span><span class=p>(</span><span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=p>)</span>
+            <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>expect</span><span class=p>(</span><span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>)</span>
+            <span class=n>token</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>current</span>
+            <span class=n>exp</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>parse_expression</span><span class=p>(</span><span class=n>parser</span><span class=p>)</span>
+            <span class=n>kwargs</span><span class=p>[</span><span class=n>arg</span><span class=p>]</span> <span class=o>=</span> <span class=n>exp</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>stream</span><span class=o>.</span><span class=n>look</span><span class=p>()</span><span class=o>.</span><span class=n>type</span> <span class=o>==</span> <span class=n>lexer</span><span class=o>.</span><span class=n>TOKEN_ASSIGN</span><span class=p>:</span>
+                <span class=n>kwargs</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>continue</span>
+    <span class=c1># Use the established environment to source the file</span>
+    <span class=n>md_content</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=o>.</span><span class=n>loader</span><span class=o>.</span><span class=n>get_source</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>markdown_source</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+    <span class=n>fm</span> <span class=o>=</span> <span class=n>frontmatter</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>md_content</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>fm</span><span class=o>.</span><span class=n>metadata</span> <span class=o>==</span> <span class=p>{}:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Non zero metadata on MD section include - ignoring&#39;</span><span class=p>)</span>
+    <span class=n>full_md</span> <span class=o>=</span> <span class=n>docs_markdown_node</span><span class=o>.</span><span class=n>DocsMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>fm</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>))</span>
+    <span class=n>md_section</span> <span class=o>=</span> <span class=n>full_md</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>section_title</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=n>strict_matching</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=c1># adjust</span>
+    <span class=k>if</span> <span class=n>kwargs</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>expected_heading_level</span> <span class=o>=</span> <span class=n>kwargs</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;heading_level&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>expected_heading_level</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>level</span> <span class=o>=</span> <span class=n>md_section</span><span class=o>.</span><span class=n>get_node_header_lvl</span><span class=p>()</span>
+        <span class=n>delta</span> <span class=o>=</span> <span class=nb>int</span><span class=p>(</span><span class=n>expected_heading_level</span><span class=p>)</span> <span class=o>-</span> <span class=n>level</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>delta</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>md_section</span><span class=o>.</span><span class=n>change_header_level_by</span><span class=p>(</span><span class=n>delta</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>md_section</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>err</span><span class=o>.</span><span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Unable to retrieve section &quot;</span><span class=si>{</span><span class=n>section_title</span><span class=o>.</span><span class=n>value</span><span class=si>}</span><span class=s1>&quot;&quot; from </span><span class=si>{</span><span class=n>markdown_source</span><span class=o>.</span><span class=n>value</span><span class=si>}</span><span class=s1> jinja template.&#39;</span>
+        <span class=p>)</span>
+    <span class=n>local_parser</span> <span class=o>=</span> <span class=n>Parser</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>environment</span><span class=p>,</span> <span class=n>md_section</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=p>)</span>
+    <span class=n>top_level_output</span> <span class=o>=</span> <span class=n>local_parser</span><span class=o>.</span><span class=n>parse</span><span class=p>()</span>
+
+    <span class=k>return</span> <span class=n>top_level_output</span><span class=o>.</span><span class=n>body</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.jinja.tags-functions>Functions<a href=#trestle.core.jinja.tags-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.core.jinja.tags.adjust_heading_level class="doc doc-heading"> <code class="highlight language-python"><span class=n>adjust_heading_level</span><span class=p>(</span><span class=n>input_md</span><span class=p>,</span> <span class=n>expected</span><span class=p>)</span></code> <a href=#trestle.core.jinja.tags.adjust_heading_level class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Adjust the header level of a markdown string such that the most significant header matches the expected #'s.</p> <details class=quote> <summary>Source code in <code>trestle/core/jinja/tags.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>adjust_heading_level</span><span class=p>(</span><span class=n>input_md</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>expected</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Adjust the header level of a markdown string such that the most significant header matches the expected #&#39;s.&quot;&quot;&quot;</span>
+    <span class=n>output_md</span> <span class=o>=</span> <span class=n>input_md</span>
+    <span class=n>mdn</span> <span class=o>=</span> <span class=n>docs_markdown_node</span><span class=o>.</span><span class=n>DocsMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>input_md</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>))</span>
+    <span class=k>if</span> <span class=n>mdn</span><span class=o>.</span><span class=n>subnodes</span><span class=p>:</span>
+        <span class=n>mdn_top_heading</span> <span class=o>=</span> <span class=n>mdn</span><span class=o>.</span><span class=n>subnodes</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>get_node_header_lvl</span><span class=p>()</span>
+        <span class=n>delta</span> <span class=o>=</span> <span class=nb>int</span><span class=p>(</span><span class=n>expected</span><span class=p>)</span> <span class=o>-</span> <span class=n>mdn_top_heading</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>delta</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>mdn</span><span class=o>.</span><span class=n>change_header_level_by</span><span class=p>(</span><span class=n>delta</span><span class=p>)</span>
+            <span class=n>output_md</span> <span class=o>=</span> <span class=n>mdn</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span>
+    <span class=k>return</span> <span class=n>output_md</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/links_validator/index.html b/latest/reference/API/trestle/core/links_validator/index.html
new file mode 100644
index 000000000..2c10f244b
--- /dev/null
+++ b/latest/reference/API/trestle/core/links_validator/index.html
@@ -0,0 +1,189 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.links_validator module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/links_validator/ rel=canonical><link href=../generic_oscal/ rel=prev><link href=../object_factory/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.links_validator - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.links_validator - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.links_validator module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/links_validator.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/links_validator/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.links_validator - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.links_validator module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/links_validator.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.links_validator class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.links_validator </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.links_validator </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.links_validator </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.links_validator class=md-nav__link> <span class=md-ellipsis> links_validator </span> </a> <nav class=md-nav aria-label=links_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.links_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator.LinksValidator class=md-nav__link> <span class=md-ellipsis> LinksValidator </span> </a> <nav class=md-nav aria-label=LinksValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator.LinksValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator.LinksValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.links_validator class=md-nav__link> <span class=md-ellipsis> links_validator </span> </a> <nav class=md-nav aria-label=links_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.links_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator.LinksValidator class=md-nav__link> <span class=md-ellipsis> LinksValidator </span> </a> <nav class=md-nav aria-label=LinksValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator.LinksValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.links_validator.LinksValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.links_validator</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.links_validator class="doc doc-heading"> <code>trestle.core.links_validator</code> <a href=#trestle.core.links_validator class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Validate catalog by confirming control links match resources in backmatter.</p> <div class="doc doc-children"> <h3 id=trestle.core.links_validator-attributes>Attributes<a href=#trestle.core.links_validator-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.links_validator.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.links_validator.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.links_validator-classes>Classes<a href=#trestle.core.links_validator-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.links_validator.LinksValidator class="doc doc-heading"> <code>LinksValidator</code> <a href=#trestle.core.links_validator.LinksValidator class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.validator.Validator href=../validator/#trestle.core.validator.Validator>Validator</a></code></p> <p>Validator to confirm all uuids in links and prose match resources in backmatter.</p> <details class=quote> <summary>Source code in <code>trestle/core/links_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LinksValidator</span><span class=p>(</span><span class=n>Validator</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validator to confirm all uuids in links and prose match resources in backmatter.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Test if the model is valid.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            model: A top level OSCAL model.</span>
+<span class=sd>            quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>        returns:</span>
+<span class=sd>            Always returns True, but gives warning if links and resources are not one-to-one.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>refs</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_uuid_refs</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>
+
+        <span class=c1># find uuids in backmatter</span>
+        <span class=n>links</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>model</span><span class=o>.</span><span class=n>back_matter</span> <span class=ow>and</span> <span class=n>model</span><span class=o>.</span><span class=n>back_matter</span><span class=o>.</span><span class=n>resources</span><span class=p>:</span>
+            <span class=n>links</span> <span class=o>=</span> <span class=p>[</span><span class=n>res</span><span class=o>.</span><span class=n>uuid</span> <span class=k>for</span> <span class=n>res</span> <span class=ow>in</span> <span class=n>model</span><span class=o>.</span><span class=n>back_matter</span><span class=o>.</span><span class=n>resources</span><span class=p>]</span>
+            <span class=n>seen</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+            <span class=n>dupes</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>uuid</span> <span class=ow>in</span> <span class=n>links</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>uuid</span> <span class=ow>in</span> <span class=n>seen</span><span class=p>:</span>
+                    <span class=n>dupes</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>uuid</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>seen</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>uuid</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>dupes</span><span class=p>:</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>quiet</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Backmatter has  </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>dupes</span><span class=p>)</span><span class=si>}</span><span class=s1> duplicate link uuids.&#39;</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Backmatter has </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>dupes</span><span class=p>)</span><span class=si>}</span><span class=s1> duplicate link uuids: </span><span class=si>{</span><span class=n>dupes</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>links</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>links</span><span class=p>)</span>
+        <span class=n>in_refs</span> <span class=o>=</span> <span class=n>refs</span><span class=o>.</span><span class=n>difference</span><span class=p>(</span><span class=n>links</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>in_refs</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>quiet</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model references </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>refs</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids and </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>in_refs</span><span class=p>)</span><span class=si>}</span><span class=s1> of them are not in resources.&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model references </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>in_refs</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids not in resources: </span><span class=si>{</span><span class=n>in_refs</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>in_links</span> <span class=o>=</span> <span class=n>links</span><span class=o>.</span><span class=n>difference</span><span class=p>(</span><span class=n>refs</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>in_links</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>quiet</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Resources have </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>links</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids and </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>in_links</span><span class=p>)</span><span class=si>}</span><span class=s1> are not referenced by model.&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Resources have </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>in_links</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids not referenced by model: </span><span class=si>{</span><span class=n>in_links</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># This validator is intended just to give warnings, so it always returns True</span>
+        <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.links_validator.LinksValidator-functions>Functions<a href=#trestle.core.links_validator.LinksValidator-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.links_validator.LinksValidator.model_is_valid class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.links_validator.LinksValidator.model_is_valid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Test if the model is valid.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.common_types.TopLevelOscalModel href=../../common/common_types/#trestle.common.common_types.TopLevelOscalModel>TopLevelOscalModel</a></code> </td> <td> <div class=doc-md-description> <p>A top level OSCAL model.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>quiet</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Don't report msgs unless invalid.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Always returns True, but gives warning if links and resources are not one-to-one.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/links_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Test if the model is valid.</span>
+
+<span class=sd>    args:</span>
+<span class=sd>        model: A top level OSCAL model.</span>
+<span class=sd>        quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>    returns:</span>
+<span class=sd>        Always returns True, but gives warning if links and resources are not one-to-one.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>refs</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_uuid_refs</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>
+
+    <span class=c1># find uuids in backmatter</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=n>model</span><span class=o>.</span><span class=n>back_matter</span> <span class=ow>and</span> <span class=n>model</span><span class=o>.</span><span class=n>back_matter</span><span class=o>.</span><span class=n>resources</span><span class=p>:</span>
+        <span class=n>links</span> <span class=o>=</span> <span class=p>[</span><span class=n>res</span><span class=o>.</span><span class=n>uuid</span> <span class=k>for</span> <span class=n>res</span> <span class=ow>in</span> <span class=n>model</span><span class=o>.</span><span class=n>back_matter</span><span class=o>.</span><span class=n>resources</span><span class=p>]</span>
+        <span class=n>seen</span><span class=p>:</span> <span class=n>Set</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=nb>set</span><span class=p>()</span>
+        <span class=n>dupes</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>uuid</span> <span class=ow>in</span> <span class=n>links</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>uuid</span> <span class=ow>in</span> <span class=n>seen</span><span class=p>:</span>
+                <span class=n>dupes</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>uuid</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>seen</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>uuid</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>dupes</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>quiet</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Backmatter has  </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>dupes</span><span class=p>)</span><span class=si>}</span><span class=s1> duplicate link uuids.&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Backmatter has </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>dupes</span><span class=p>)</span><span class=si>}</span><span class=s1> duplicate link uuids: </span><span class=si>{</span><span class=n>dupes</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>links</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>links</span><span class=p>)</span>
+    <span class=n>in_refs</span> <span class=o>=</span> <span class=n>refs</span><span class=o>.</span><span class=n>difference</span><span class=p>(</span><span class=n>links</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>in_refs</span><span class=p>:</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>quiet</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model references </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>refs</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids and </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>in_refs</span><span class=p>)</span><span class=si>}</span><span class=s1> of them are not in resources.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model references </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>in_refs</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids not in resources: </span><span class=si>{</span><span class=n>in_refs</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>in_links</span> <span class=o>=</span> <span class=n>links</span><span class=o>.</span><span class=n>difference</span><span class=p>(</span><span class=n>refs</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>in_links</span><span class=p>:</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>quiet</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Resources have </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>links</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids and </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>in_links</span><span class=p>)</span><span class=si>}</span><span class=s1> are not referenced by model.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Resources have </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>in_links</span><span class=p>)</span><span class=si>}</span><span class=s1> uuids not referenced by model: </span><span class=si>{</span><span class=n>in_links</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=c1># This validator is intended just to give warnings, so it always returns True</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/markdown/base_markdown_node/index.html b/latest/reference/API/trestle/core/markdown/base_markdown_node/index.html
new file mode 100644
index 000000000..6e440616c
--- /dev/null
+++ b/latest/reference/API/trestle/core/markdown/base_markdown_node/index.html
@@ -0,0 +1,792 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.markdown.base_markdown_node module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/base_markdown_node/ rel=canonical><link href=../../jinja/tags/ rel=prev><link href=../control_markdown_node/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.markdown.base_markdown_node - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.markdown.base_markdown_node - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.markdown.base_markdown_node module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/base_markdown_node.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/base_markdown_node/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.markdown.base_markdown_node - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.markdown.base_markdown_node module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/base_markdown_node.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.markdown.base_markdown_node class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30 checked> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node class=md-nav__link> <span class=md-ellipsis> base_markdown_node </span> </a> <nav class=md-nav aria-label=base_markdown_node> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode class=md-nav__link> <span class=md-ellipsis> BaseMarkdownNode </span> </a> <nav class=md-nav aria-label=BaseMarkdownNode> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.content class=md-nav__link> <span class=md-ellipsis> content </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.key class=md-nav__link> <span class=md-ellipsis> key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.starting_line class=md-nav__link> <span class=md-ellipsis> starting_line </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.subnodes class=md-nav__link> <span class=md-ellipsis> subnodes </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.build_tree_from_markdown class=md-nav__link> <span class=md-ellipsis> build_tree_from_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.change_header_level_by class=md-nav__link> <span class=md-ellipsis> change_header_level_by </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.delete_nodes_text class=md-nav__link> <span class=md-ellipsis> delete_nodes_text </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_key class=md-nav__link> <span class=md-ellipsis> get_all_headers_for_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_level class=md-nav__link> <span class=md-ellipsis> get_all_headers_for_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_nodes_for_keys class=md-nav__link> <span class=md-ellipsis> get_all_nodes_for_keys </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_for_key class=md-nav__link> <span class=md-ellipsis> get_node_for_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_header_lvl class=md-nav__link> <span class=md-ellipsis> get_node_header_lvl </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent class=md-nav__link> <span class=md-ellipsis> BaseSectionContent </span> </a> <nav class=md-nav aria-label=BaseSectionContent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.raw_text class=md-nav__link> <span class=md-ellipsis> raw_text </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.subnodes_keys class=md-nav__link> <span class=md-ellipsis> subnodes_keys </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.union class=md-nav__link> <span class=md-ellipsis> union </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node class=md-nav__link> <span class=md-ellipsis> base_markdown_node </span> </a> <nav class=md-nav aria-label=base_markdown_node> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode class=md-nav__link> <span class=md-ellipsis> BaseMarkdownNode </span> </a> <nav class=md-nav aria-label=BaseMarkdownNode> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.content class=md-nav__link> <span class=md-ellipsis> content </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.key class=md-nav__link> <span class=md-ellipsis> key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.starting_line class=md-nav__link> <span class=md-ellipsis> starting_line </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.subnodes class=md-nav__link> <span class=md-ellipsis> subnodes </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.build_tree_from_markdown class=md-nav__link> <span class=md-ellipsis> build_tree_from_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.change_header_level_by class=md-nav__link> <span class=md-ellipsis> change_header_level_by </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.delete_nodes_text class=md-nav__link> <span class=md-ellipsis> delete_nodes_text </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_key class=md-nav__link> <span class=md-ellipsis> get_all_headers_for_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_level class=md-nav__link> <span class=md-ellipsis> get_all_headers_for_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_nodes_for_keys class=md-nav__link> <span class=md-ellipsis> get_all_nodes_for_keys </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_for_key class=md-nav__link> <span class=md-ellipsis> get_node_for_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_header_lvl class=md-nav__link> <span class=md-ellipsis> get_node_header_lvl </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent class=md-nav__link> <span class=md-ellipsis> BaseSectionContent </span> </a> <nav class=md-nav aria-label=BaseSectionContent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.raw_text class=md-nav__link> <span class=md-ellipsis> raw_text </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.subnodes_keys class=md-nav__link> <span class=md-ellipsis> subnodes_keys </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.union class=md-nav__link> <span class=md-ellipsis> union </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.base_markdown_node-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.markdown.base_markdown_node</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.markdown.base_markdown_node class="doc doc-heading"> <code>trestle.core.markdown.base_markdown_node</code> <a href=#trestle.core.markdown.base_markdown_node class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>A base markdown node.</p> <div class="doc doc-children"> <h3 id=trestle.core.markdown.base_markdown_node-attributes>Attributes<a href=#trestle.core.markdown.base_markdown_node-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.base_markdown_node.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.base_markdown_node.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.markdown.base_markdown_node-classes>Classes<a href=#trestle.core.markdown.base_markdown_node-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode class="doc doc-heading"> <code>BaseMarkdownNode</code> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Markdown will be read to the tree.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>BaseMarkdownNode</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Markdown will be read to the tree.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>content</span><span class=p>:</span> <span class=n>BaseSectionContent</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>:</span> <span class=nb>int</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize markdown node.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>subnodes</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>key</span> <span class=o>=</span> <span class=n>key</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>content</span> <span class=o>=</span> <span class=n>content</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>starting_line</span> <span class=o>=</span> <span class=n>starting_line</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>build_tree_from_markdown</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>BaseMarkdownNode</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Construct a tree out of the given markdown.&quot;&quot;&quot;</span>
+        <span class=n>ob</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=fm>__new__</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span>
+        <span class=n>start_level</span> <span class=o>=</span> <span class=n>ob</span><span class=o>.</span><span class=n>_get_max_header_lvl</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+        <span class=n>ob</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ob</span><span class=o>.</span><span class=n>_build_tree</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=s1>&#39;root&#39;</span><span class=p>,</span> <span class=mi>0</span><span class=p>,</span> <span class=n>start_level</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>ob</span>
+
+    <span class=k>def</span> <span class=nf>get_all_headers_for_level</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterable</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return all headers per specified level of hierarchy.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>list</span><span class=p>(</span>
+            <span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>header</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_header_level_if_valid</span><span class=p>(</span><span class=n>header</span><span class=p>)</span> <span class=o>==</span> <span class=n>level</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>)</span>
+        <span class=p>)</span><span class=o>.</span><span class=fm>__iter__</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>get_node_for_key</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return a first node for the given key, substring matching is supported. The method is case insensitive.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>strict_matching</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=nb>any</span><span class=p>(</span><span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=k>for</span> <span class=n>el</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>):</span>
+                <span class=k>return</span> <span class=kc>None</span>
+            <span class=k>elif</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_filtered_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>el</span><span class=p>:</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()))</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Multiple nodes for </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> were found, only the first one will be returned.&#39;</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=k>for</span> <span class=n>el</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>]:</span>
+                <span class=k>return</span> <span class=kc>None</span>
+            <span class=k>elif</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_filtered_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>el</span><span class=p>:</span> <span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()))</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Multiple nodes for </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> were found, only the first one will be returned.&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rec_traverse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_all_nodes_for_keys</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+        <span class=n>stop_recurse_on_first_match</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Return all nodes for the given keys, substring matching is supported.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            keys: List of strings for the headers being collected</span>
+<span class=sd>            strict_matching: Force exact match of key with header vs. simple substring match</span>
+<span class=sd>            stop_recurse_on_first_match: Return first match of any of the keys and don&#39;t search subnodes</span>
+
+<span class=sd>        Returns: List of found markdown nodes</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>strict_matching</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=nb>any</span><span class=p>(</span><span class=n>key</span> <span class=ow>in</span> <span class=n>el</span> <span class=k>for</span> <span class=n>el</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>keys</span><span class=p>):</span>
+                <span class=k>return</span> <span class=p>[]</span>
+        <span class=k>elif</span> <span class=ow>not</span> <span class=nb>set</span><span class=p>(</span><span class=n>keys</span><span class=p>)</span><span class=o>.</span><span class=n>intersection</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>):</span>
+            <span class=k>return</span> <span class=p>[]</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rec_traverse_all</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>keys</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>,</span> <span class=n>stop_recurse_on_first_match</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_all_headers_for_key</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterable</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return all headers contained in the node with a given key.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>strict_matching</span><span class=p>:</span>
+            <span class=k>return</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>header</span><span class=p>:</span> <span class=n>key</span> <span class=o>==</span> <span class=n>header</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>))</span><span class=o>.</span><span class=fm>__iter__</span><span class=p>()</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>return</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>header</span><span class=p>:</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>header</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>))</span><span class=o>.</span><span class=fm>__iter__</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>get_node_header_lvl</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return current node header level.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_header_level_if_valid</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>key</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>change_header_level_by</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>delta_level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Change all headers in the tree by specified level up or down.</span>
+
+<span class=sd>        All children nodes will be modified by specified level as well.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            delta_level: each header will be modified by this number, can be negative.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># construct a map</span>
+        <span class=n>header_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>key</span> <span class=o>!=</span> <span class=s1>&#39;root&#39;</span><span class=p>:</span>
+            <span class=n>new_key</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modify_header_level</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>key</span><span class=p>,</span> <span class=n>delta_level</span><span class=p>)</span>
+            <span class=n>header_map</span><span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_key</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>:</span>
+            <span class=n>new_key</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modify_header_level</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>delta_level</span><span class=p>)</span>
+            <span class=n>header_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_key</span>
+
+        <span class=c1># go through all contents and modify headers</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_rec_traverse_header_update</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>header_map</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>delete_nodes_text</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Remove text from this node that is found in matching subnodes.&quot;&quot;&quot;</span>
+        <span class=n>text_lines</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>matching_nodes</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_nodes_for_keys</span><span class=p>(</span><span class=n>keys</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=c1># need to delete from end and proceed backwards</span>
+        <span class=n>sorted_nodes</span> <span class=o>=</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>matching_nodes</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>node</span><span class=p>:</span> <span class=n>node</span><span class=o>.</span><span class=n>starting_line</span><span class=p>,</span> <span class=n>reverse</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>sorted_nodes</span><span class=p>:</span>
+            <span class=n>last_line</span> <span class=o>=</span> <span class=n>node</span><span class=o>.</span><span class=n>starting_line</span> <span class=o>+</span> <span class=nb>len</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>))</span>
+            <span class=n>delete_list_from_list</span><span class=p>(</span><span class=n>text_lines</span><span class=p>,</span> <span class=nb>list</span><span class=p>(</span><span class=nb>range</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>starting_line</span><span class=p>,</span> <span class=n>last_line</span><span class=p>)))</span>
+        <span class=k>return</span> <span class=n>text_lines</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>_build_tree</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>root_key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+                    <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>,</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build a tree from the markdown recursively.&quot;&quot;&quot;</span>
+        <span class=k>pass</span>
+
+    <span class=k>def</span> <span class=nf>_modify_header_level</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>delta_level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Modify header level by specified level.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>delta_level</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Nothing to modify in header, level 0 is given.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>header</span>
+
+        <span class=n>current_level</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_header_level_if_valid</span><span class=p>(</span><span class=n>header</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>current_level</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>current_level</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>if</span> <span class=n>current_level</span> <span class=o>+</span> <span class=n>delta_level</span> <span class=o>&lt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Cannot substract </span><span class=si>{</span><span class=n>delta_level</span><span class=si>}</span><span class=s1> as level of </span><span class=si>{</span><span class=n>header</span><span class=si>}</span><span class=s1> is </span><span class=si>{</span><span class=n>current_level</span><span class=si>}</span><span class=s1>. All `#` will be removed.&#39;</span>
+            <span class=p>)</span>
+            <span class=n>delta_level</span> <span class=o>=</span> <span class=n>current_level</span> <span class=o>*</span> <span class=o>-</span><span class=mi>1</span>
+
+        <span class=k>if</span> <span class=n>current_level</span> <span class=o>+</span> <span class=n>delta_level</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>replacement</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>replacement</span> <span class=o>=</span> <span class=s1>&#39;#&#39;</span> <span class=o>*</span> <span class=p>(</span><span class=n>current_level</span> <span class=o>+</span> <span class=n>delta_level</span><span class=p>)</span>
+        <span class=n>header</span> <span class=o>=</span> <span class=n>header</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;#&#39;</span> <span class=o>*</span> <span class=n>current_level</span><span class=p>,</span> <span class=n>replacement</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>header</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_header_level_if_valid</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Return a level of the header if the given line is indeed a header.</span>
+
+<span class=sd>        Level of the header is determined by the number of # symbols.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>header_symbols</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>md_const</span><span class=o>.</span><span class=n>HEADER_REGEX</span><span class=p>,</span> <span class=n>line</span><span class=p>)</span>
+        <span class=c1># Header is valid only if it line starts with header</span>
+        <span class=k>if</span> <span class=n>header_symbols</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>header_symbols</span><span class=o>.</span><span class=n>regs</span><span class=p>[</span><span class=mi>0</span><span class=p>][</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>header_symbols</span><span class=o>.</span><span class=n>regs</span><span class=p>[</span><span class=mi>0</span><span class=p>][</span><span class=mi>1</span><span class=p>]</span>
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_does_start_with</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>start_chars</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Determine whether the line starts with given characters.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>start_chars</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_does_contain</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>reg</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Determine if the line matches regex.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>line</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span> <span class=ow>and</span> <span class=n>reg</span> <span class=o>!=</span> <span class=sa>r</span><span class=s1>&#39;&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=n>regexp</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>reg</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>regexp</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>line</span><span class=p>)</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_read_code_lines</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>i</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>tuple</span><span class=p>[</span><span class=nb>list</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read code block.&quot;&quot;&quot;</span>
+        <span class=n>code_lines</span> <span class=o>=</span> <span class=p>[</span><span class=n>line</span><span class=p>]</span>
+        <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>i</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>lines</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Code block is not closed: </span><span class=si>{</span><span class=n>code_lines</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>line</span> <span class=o>=</span> <span class=n>lines</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+            <span class=n>code_lines</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+            <span class=n>i</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>CODEBLOCK_DEF</span><span class=p>):</span>
+                <span class=k>break</span>
+        <span class=k>return</span> <span class=n>code_lines</span><span class=p>,</span> <span class=n>i</span>
+
+    <span class=k>def</span> <span class=nf>_read_html_block</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>i</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>ending_regex</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>tuple</span><span class=p>[</span><span class=nb>list</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read html block.&quot;&quot;&quot;</span>
+        <span class=n>html_block</span> <span class=o>=</span> <span class=p>[</span><span class=n>line</span><span class=p>]</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=sa>r</span><span class=s1>&#39;&lt;br[ /]*&gt;&#39;</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>html_block</span><span class=p>,</span> <span class=n>i</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>ending_regex</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>html_block</span><span class=p>,</span> <span class=n>i</span>
+        <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>i</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>lines</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;HTML block is not closed: </span><span class=si>{</span><span class=n>html_block</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>line</span> <span class=o>=</span> <span class=n>lines</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+            <span class=n>html_block</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+            <span class=n>i</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>ending_regex</span><span class=p>):</span>
+                <span class=k>break</span>
+        <span class=k>return</span> <span class=n>html_block</span><span class=p>,</span> <span class=n>i</span>
+
+    <span class=k>def</span> <span class=nf>_read_table_block</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>i</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>tuple</span><span class=p>[</span><span class=nb>list</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read table.&quot;&quot;&quot;</span>
+        <span class=n>table_block</span> <span class=o>=</span> <span class=p>[</span><span class=n>line</span><span class=p>]</span>
+        <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>i</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>lines</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>table_block</span><span class=p>,</span> <span class=n>i</span>
+
+            <span class=n>line</span> <span class=o>=</span> <span class=n>lines</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>TABLE_REGEX</span><span class=p>):</span>
+                <span class=n>table_block</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+                <span class=k>break</span>
+            <span class=n>table_block</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+            <span class=n>i</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=k>return</span> <span class=n>table_block</span><span class=p>,</span> <span class=n>i</span>
+
+    <span class=k>def</span> <span class=nf>_rec_traverse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>node</span><span class=p>:</span> <span class=n>BaseMarkdownNode</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Recursevely traverses the tree and searches for the given key.</span>
+
+<span class=sd>        If strict matching is turned off, node will be matched if key is a substring of the node&#39;s header.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>or</span> <span class=p>(</span><span class=ow>not</span> <span class=n>strict_matching</span> <span class=ow>and</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()):</span>
+            <span class=k>return</span> <span class=n>node</span>
+        <span class=k>if</span> <span class=p>(</span><span class=ow>not</span> <span class=n>strict_matching</span> <span class=ow>and</span> <span class=nb>any</span><span class=p>(</span><span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span>
+                                        <span class=k>for</span> <span class=n>el</span> <span class=ow>in</span> <span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>))</span> <span class=ow>or</span> <span class=p>(</span><span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=p>[</span>
+                                            <span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=k>for</span> <span class=n>el</span> <span class=ow>in</span> <span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span>
+                                        <span class=p>]):</span>
+            <span class=k>for</span> <span class=n>subnode</span> <span class=ow>in</span> <span class=n>node</span><span class=o>.</span><span class=n>subnodes</span><span class=p>:</span>
+                <span class=n>matched_node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rec_traverse</span><span class=p>(</span><span class=n>subnode</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>matched_node</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=k>return</span> <span class=n>matched_node</span>
+
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_rec_traverse_all</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>node</span><span class=p>:</span> <span class=n>BaseMarkdownNode</span><span class=p>,</span> <span class=n>keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>stop_recurse_on_first_match</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Recursevely traverse the tree and find all nodes matching the keys.</span>
+
+<span class=sd>        If strict matching is turned off, nodes will be matched if key is a substring of the node&#39;s header.</span>
+<span class=sd>        stop_recurse_on_first_match will return only the highest level key match and not any subnodes</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>found_nodes</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>keys</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=o>==</span> <span class=n>node</span><span class=o>.</span><span class=n>key</span> <span class=ow>or</span> <span class=p>(</span><span class=ow>not</span> <span class=n>strict_matching</span> <span class=ow>and</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=p>):</span>
+                <span class=n>found_nodes</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>node</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>stop_recurse_on_first_match</span><span class=p>:</span>
+                    <span class=k>return</span> <span class=n>found_nodes</span>
+        <span class=k>for</span> <span class=n>subnode</span> <span class=ow>in</span> <span class=n>node</span><span class=o>.</span><span class=n>subnodes</span><span class=p>:</span>
+            <span class=n>matched_nodes</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rec_traverse_all</span><span class=p>(</span><span class=n>subnode</span><span class=p>,</span> <span class=n>keys</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>,</span> <span class=n>stop_recurse_on_first_match</span><span class=p>)</span>
+            <span class=n>found_nodes</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>matched_nodes</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>found_nodes</span>
+
+    <span class=k>def</span> <span class=nf>_rec_traverse_header_update</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>node</span><span class=p>:</span> <span class=n>BaseMarkdownNode</span><span class=p>,</span> <span class=n>header_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Recursively traverse tree and update the contents.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>node</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>node</span><span class=o>.</span><span class=n>key</span> <span class=o>!=</span> <span class=s1>&#39;root&#39;</span><span class=p>:</span>
+                <span class=n>new_key</span> <span class=o>=</span> <span class=n>header_map</span><span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=p>]</span>
+                <span class=n>node</span><span class=o>.</span><span class=n>key</span> <span class=o>=</span> <span class=n>new_key</span>
+
+            <span class=c1># update text</span>
+            <span class=n>lines</span> <span class=o>=</span> <span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>lines</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>0</span><span class=p>,</span> <span class=nb>len</span><span class=p>(</span><span class=n>lines</span><span class=p>)):</span>
+                    <span class=n>line</span> <span class=o>=</span> <span class=n>lines</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+                    <span class=k>if</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>header_map</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                        <span class=n>new_key</span> <span class=o>=</span> <span class=n>header_map</span><span class=p>[</span><span class=n>line</span><span class=p>]</span>
+                        <span class=n>lines</span><span class=p>[</span><span class=n>i</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_key</span>
+                    <span class=k>elif</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>)</span> <span class=ow>in</span> <span class=n>header_map</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                        <span class=c1># keep spaces if any</span>
+                        <span class=n>new_key</span> <span class=o>=</span> <span class=n>header_map</span><span class=p>[</span><span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>)]</span>
+                        <span class=n>lines</span><span class=p>[</span><span class=n>i</span><span class=p>]</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>),</span> <span class=n>new_key</span><span class=p>)</span>
+
+                <span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+
+            <span class=c1># update subnodes</span>
+            <span class=k>if</span> <span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>0</span><span class=p>,</span> <span class=nb>len</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>)):</span>
+                    <span class=n>subnode_key</span> <span class=o>=</span> <span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+                    <span class=k>if</span> <span class=n>subnode_key</span> <span class=ow>in</span> <span class=n>header_map</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                        <span class=n>new_key</span> <span class=o>=</span> <span class=n>header_map</span><span class=p>[</span><span class=n>subnode_key</span><span class=p>]</span>
+                        <span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>[</span><span class=n>i</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_key</span>
+
+        <span class=k>for</span> <span class=n>subnode</span> <span class=ow>in</span> <span class=n>node</span><span class=o>.</span><span class=n>subnodes</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_rec_traverse_header_update</span><span class=p>(</span><span class=n>subnode</span><span class=p>,</span> <span class=n>header_map</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_max_header_lvl</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Go through all lines to determine highest header level. Less # means higher.&quot;&quot;&quot;</span>
+        <span class=n>min_lvl</span> <span class=o>=</span> <span class=n>math</span><span class=o>.</span><span class=n>inf</span>
+        <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>lines</span><span class=p>:</span>
+            <span class=n>line</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>)</span>
+            <span class=n>header_lvl</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_header_level_if_valid</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>header_lvl</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>header_lvl</span> <span class=o>&lt;</span> <span class=n>min_lvl</span><span class=p>:</span>
+                <span class=n>min_lvl</span> <span class=o>=</span> <span class=n>header_lvl</span>
+
+        <span class=k>return</span> <span class=n>min_lvl</span> <span class=o>-</span> <span class=mi>1</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode-attributes>Attributes<a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.content class="doc doc-heading"> <code class="highlight language-python"><span class=n>content</span> <span class=o>=</span> <span class=n>content</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.content class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.key class="doc doc-heading"> <code class="highlight language-python"><span class=n>key</span> <span class=o>=</span> <span class=n>key</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.key class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.starting_line class="doc doc-heading"> <code class="highlight language-python"><span class=n>starting_line</span> <span class=o>=</span> <span class=n>starting_line</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.starting_line class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.subnodes class="doc doc-heading"> <code class="highlight language-python"><span class=n>subnodes</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.subnodes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode-functions>Functions<a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>content</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>)</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize markdown node.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>content</span><span class=p>:</span> <span class=n>BaseSectionContent</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>:</span> <span class=nb>int</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize markdown node.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>subnodes</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>key</span> <span class=o>=</span> <span class=n>key</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>content</span> <span class=o>=</span> <span class=n>content</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>starting_line</span> <span class=o>=</span> <span class=n>starting_line</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.build_tree_from_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.build_tree_from_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Construct a tree out of the given markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>build_tree_from_markdown</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>BaseMarkdownNode</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Construct a tree out of the given markdown.&quot;&quot;&quot;</span>
+    <span class=n>ob</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=fm>__new__</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span>
+    <span class=n>start_level</span> <span class=o>=</span> <span class=n>ob</span><span class=o>.</span><span class=n>_get_max_header_lvl</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+    <span class=n>ob</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ob</span><span class=o>.</span><span class=n>_build_tree</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=s1>&#39;root&#39;</span><span class=p>,</span> <span class=mi>0</span><span class=p>,</span> <span class=n>start_level</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>ob</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.change_header_level_by class="doc doc-heading"> <code class="highlight language-python"><span class=n>change_header_level_by</span><span class=p>(</span><span class=n>delta_level</span><span class=p>)</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.change_header_level_by class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Change all headers in the tree by specified level up or down.</p> <p>All children nodes will be modified by specified level as well.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>delta_level</code> </td> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>each header will be modified by this number, can be negative.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>change_header_level_by</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>delta_level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Change all headers in the tree by specified level up or down.</span>
+
+<span class=sd>    All children nodes will be modified by specified level as well.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        delta_level: each header will be modified by this number, can be negative.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># construct a map</span>
+    <span class=n>header_map</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>key</span> <span class=o>!=</span> <span class=s1>&#39;root&#39;</span><span class=p>:</span>
+        <span class=n>new_key</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modify_header_level</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>key</span><span class=p>,</span> <span class=n>delta_level</span><span class=p>)</span>
+        <span class=n>header_map</span><span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_key</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>:</span>
+        <span class=n>new_key</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modify_header_level</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>delta_level</span><span class=p>)</span>
+        <span class=n>header_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>new_key</span>
+
+    <span class=c1># go through all contents and modify headers</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_rec_traverse_header_update</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>header_map</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.delete_nodes_text class="doc doc-heading"> <code class="highlight language-python"><span class=n>delete_nodes_text</span><span class=p>(</span><span class=n>keys</span><span class=p>,</span> <span class=n>strict_matching</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.delete_nodes_text class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Remove text from this node that is found in matching subnodes.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>delete_nodes_text</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove text from this node that is found in matching subnodes.&quot;&quot;&quot;</span>
+    <span class=n>text_lines</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>matching_nodes</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_nodes_for_keys</span><span class=p>(</span><span class=n>keys</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+    <span class=c1># need to delete from end and proceed backwards</span>
+    <span class=n>sorted_nodes</span> <span class=o>=</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>matching_nodes</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=k>lambda</span> <span class=n>node</span><span class=p>:</span> <span class=n>node</span><span class=o>.</span><span class=n>starting_line</span><span class=p>,</span> <span class=n>reverse</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>sorted_nodes</span><span class=p>:</span>
+        <span class=n>last_line</span> <span class=o>=</span> <span class=n>node</span><span class=o>.</span><span class=n>starting_line</span> <span class=o>+</span> <span class=nb>len</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>))</span>
+        <span class=n>delete_list_from_list</span><span class=p>(</span><span class=n>text_lines</span><span class=p>,</span> <span class=nb>list</span><span class=p>(</span><span class=nb>range</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>starting_line</span><span class=p>,</span> <span class=n>last_line</span><span class=p>)))</span>
+    <span class=k>return</span> <span class=n>text_lines</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_key class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all_headers_for_key</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>strict_matching</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_key class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return all headers contained in the node with a given key.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_all_headers_for_key</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterable</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return all headers contained in the node with a given key.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>strict_matching</span><span class=p>:</span>
+        <span class=k>return</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>header</span><span class=p>:</span> <span class=n>key</span> <span class=o>==</span> <span class=n>header</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>))</span><span class=o>.</span><span class=fm>__iter__</span><span class=p>()</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>return</span> <span class=nb>list</span><span class=p>(</span><span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>header</span><span class=p>:</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>header</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>))</span><span class=o>.</span><span class=fm>__iter__</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_level class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=n>level</span><span class=p>)</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_level class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return all headers per specified level of hierarchy.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_all_headers_for_level</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterable</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return all headers per specified level of hierarchy.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>list</span><span class=p>(</span>
+        <span class=nb>filter</span><span class=p>(</span><span class=k>lambda</span> <span class=n>header</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_header_level_if_valid</span><span class=p>(</span><span class=n>header</span><span class=p>)</span> <span class=o>==</span> <span class=n>level</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>)</span>
+    <span class=p>)</span><span class=o>.</span><span class=fm>__iter__</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_nodes_for_keys class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all_nodes_for_keys</span><span class=p>(</span><span class=n>keys</span><span class=p>,</span> <span class=n>strict_matching</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>stop_recurse_on_first_match</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_nodes_for_keys class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return all nodes for the given keys, substring matching is supported.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>keys</code> </td> <td> <code><span title=typing.List>List</span>[str]</code> </td> <td> <div class=doc-md-description> <p>List of strings for the headers being collected</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>strict_matching</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Force exact match of key with header vs. simple substring match</p> </div> </td> <td> <code>True</code> </td> </tr> <tr class=doc-section-item> <td> <code>stop_recurse_on_first_match</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Return first match of any of the keys and don't search subnodes</p> </div> </td> <td> <code>False</code> </td> </tr> </tbody> </table> <p>Returns: List of found markdown nodes</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_all_nodes_for_keys</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+    <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+    <span class=n>stop_recurse_on_first_match</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Return all nodes for the given keys, substring matching is supported.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        keys: List of strings for the headers being collected</span>
+<span class=sd>        strict_matching: Force exact match of key with header vs. simple substring match</span>
+<span class=sd>        stop_recurse_on_first_match: Return first match of any of the keys and don&#39;t search subnodes</span>
+
+<span class=sd>    Returns: List of found markdown nodes</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>strict_matching</span><span class=p>:</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>any</span><span class=p>(</span><span class=n>key</span> <span class=ow>in</span> <span class=n>el</span> <span class=k>for</span> <span class=n>el</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>keys</span><span class=p>):</span>
+            <span class=k>return</span> <span class=p>[]</span>
+    <span class=k>elif</span> <span class=ow>not</span> <span class=nb>set</span><span class=p>(</span><span class=n>keys</span><span class=p>)</span><span class=o>.</span><span class=n>intersection</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>):</span>
+        <span class=k>return</span> <span class=p>[]</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rec_traverse_all</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>keys</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>,</span> <span class=n>stop_recurse_on_first_match</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_for_key class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>strict_matching</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_for_key class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return a first node for the given key, substring matching is supported. The method is case insensitive.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_node_for_key</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>BaseMarkdownNode</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return a first node for the given key, substring matching is supported. The method is case insensitive.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>strict_matching</span><span class=p>:</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>any</span><span class=p>(</span><span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=k>for</span> <span class=n>el</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>None</span>
+        <span class=k>elif</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_filtered_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>el</span><span class=p>:</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()))</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Multiple nodes for </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> were found, only the first one will be returned.&#39;</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=k>for</span> <span class=n>el</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>]:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+        <span class=k>elif</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_filtered_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>el</span><span class=p>:</span> <span class=n>el</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()))</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Multiple nodes for </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> were found, only the first one will be returned.&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rec_traverse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>,</span> <span class=n>strict_matching</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_header_lvl class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_node_header_lvl</span><span class=p>()</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_header_lvl class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return current node header level.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_node_header_lvl</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>int</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return current node header level.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_header_level_if_valid</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>key</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.base_markdown_node.BaseSectionContent class="doc doc-heading"> <code>BaseSectionContent</code> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>A content of the node.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>BaseSectionContent</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;A content of the node.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize section content.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>raw_text</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=k>def</span> <span class=nf>union</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>node</span><span class=p>:</span> <span class=n>BaseMarkdownNode</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Unites contents together.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.base_markdown_node.BaseSectionContent-attributes>Attributes<a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.base_markdown_node.BaseSectionContent.raw_text class="doc doc-heading"> <code class="highlight language-python"><span class=n>raw_text</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.raw_text class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.base_markdown_node.BaseSectionContent.subnodes_keys class="doc doc-heading"> <code class="highlight language-python"><span class=n>subnodes_keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.subnodes_keys class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.base_markdown_node.BaseSectionContent-functions>Functions<a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseSectionContent.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize section content.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize section content.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>raw_text</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.base_markdown_node.BaseSectionContent.union class="doc doc-heading"> <code class="highlight language-python"><span class=n>union</span><span class=p>(</span><span class=n>node</span><span class=p>)</span></code> <a href=#trestle.core.markdown.base_markdown_node.BaseSectionContent.union class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Unites contents together.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/base_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>union</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>node</span><span class=p>:</span> <span class=n>BaseMarkdownNode</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Unites contents together.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.markdown.base_markdown_node-functions>Functions<a href=#trestle.core.markdown.base_markdown_node-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/markdown/control_markdown_node/index.html b/latest/reference/API/trestle/core/markdown/control_markdown_node/index.html
new file mode 100644
index 000000000..8b937580b
--- /dev/null
+++ b/latest/reference/API/trestle/core/markdown/control_markdown_node/index.html
@@ -0,0 +1,1296 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.markdown.control_markdown_node module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/control_markdown_node/ rel=canonical><link href=../base_markdown_node/ rel=prev><link href=../docs_markdown_node/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.markdown.control_markdown_node - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.markdown.control_markdown_node - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.markdown.control_markdown_node module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/control_markdown_node.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/control_markdown_node/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.markdown.control_markdown_node - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.markdown.control_markdown_node module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/control_markdown_node.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.markdown.control_markdown_node class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30 checked> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node class=md-nav__link> <span class=md-ellipsis> control_markdown_node </span> </a> <nav class=md-nav aria-label=control_markdown_node> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.tree_context class=md-nav__link> <span class=md-ellipsis> tree_context </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode class=md-nav__link> <span class=md-ellipsis> ControlMarkdownNode </span> </a> <nav class=md-nav aria-label=ControlMarkdownNode> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.content class=md-nav__link> <span class=md-ellipsis> content </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_by_id_parts class=md-nav__link> <span class=md-ellipsis> get_by_id_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_guidance class=md-nav__link> <span class=md-ellipsis> get_control_guidance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_objective class=md-nav__link> <span class=md-ellipsis> get_control_objective </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_statement class=md-nav__link> <span class=md-ellipsis> get_control_statement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_editable_parts_and_subparts class=md-nav__link> <span class=md-ellipsis> get_editable_parts_and_subparts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_other_control_parts class=md-nav__link> <span class=md-ellipsis> get_other_control_parts </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent class=md-nav__link> <span class=md-ellipsis> ControlSectionContent </span> </a> <nav class=md-nav aria-label=ControlSectionContent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.by_id_name class=md-nav__link> <span class=md-ellipsis> by_id_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.part class=md-nav__link> <span class=md-ellipsis> part </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.union class=md-nav__link> <span class=md-ellipsis> union </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType class=md-nav__link> <span class=md-ellipsis> ControlSectionType </span> </a> <nav class=md-nav aria-label=ControlSectionType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_BY_ID_PART class=md-nav__link> <span class=md-ellipsis> EDITABLE_BY_ID_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_CONTENT class=md-nav__link> <span class=md-ellipsis> EDITABLE_CONTENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_CONTROL_PART class=md-nav__link> <span class=md-ellipsis> GENERIC_CONTROL_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_SUBPART class=md-nav__link> <span class=md-ellipsis> GENERIC_SUBPART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.GUIDANCE class=md-nav__link> <span class=md-ellipsis> GUIDANCE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.OBJECTIVE class=md-nav__link> <span class=md-ellipsis> OBJECTIVE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.STATEMENT class=md-nav__link> <span class=md-ellipsis> STATEMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.UNDEFINED class=md-nav__link> <span class=md-ellipsis> UNDEFINED </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext class=md-nav__link> <span class=md-ellipsis> TreeContext </span> </a> <nav class=md-nav aria-label=TreeContext> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.control_group class=md-nav__link> <span class=md-ellipsis> control_group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.control_title class=md-nav__link> <span class=md-ellipsis> control_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.part_label_to_id_map class=md-nav__link> <span class=md-ellipsis> part_label_to_id_map </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.section_to_part_name_map class=md-nav__link> <span class=md-ellipsis> section_to_part_name_map </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.reset class=md-nav__link> <span class=md-ellipsis> reset </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node class=md-nav__link> <span class=md-ellipsis> control_markdown_node </span> </a> <nav class=md-nav aria-label=control_markdown_node> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.tree_context class=md-nav__link> <span class=md-ellipsis> tree_context </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode class=md-nav__link> <span class=md-ellipsis> ControlMarkdownNode </span> </a> <nav class=md-nav aria-label=ControlMarkdownNode> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.content class=md-nav__link> <span class=md-ellipsis> content </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_by_id_parts class=md-nav__link> <span class=md-ellipsis> get_by_id_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_guidance class=md-nav__link> <span class=md-ellipsis> get_control_guidance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_objective class=md-nav__link> <span class=md-ellipsis> get_control_objective </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_statement class=md-nav__link> <span class=md-ellipsis> get_control_statement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_editable_parts_and_subparts class=md-nav__link> <span class=md-ellipsis> get_editable_parts_and_subparts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_other_control_parts class=md-nav__link> <span class=md-ellipsis> get_other_control_parts </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent class=md-nav__link> <span class=md-ellipsis> ControlSectionContent </span> </a> <nav class=md-nav aria-label=ControlSectionContent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.by_id_name class=md-nav__link> <span class=md-ellipsis> by_id_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.part class=md-nav__link> <span class=md-ellipsis> part </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.union class=md-nav__link> <span class=md-ellipsis> union </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType class=md-nav__link> <span class=md-ellipsis> ControlSectionType </span> </a> <nav class=md-nav aria-label=ControlSectionType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_BY_ID_PART class=md-nav__link> <span class=md-ellipsis> EDITABLE_BY_ID_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_CONTENT class=md-nav__link> <span class=md-ellipsis> EDITABLE_CONTENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_CONTROL_PART class=md-nav__link> <span class=md-ellipsis> GENERIC_CONTROL_PART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_SUBPART class=md-nav__link> <span class=md-ellipsis> GENERIC_SUBPART </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.GUIDANCE class=md-nav__link> <span class=md-ellipsis> GUIDANCE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.OBJECTIVE class=md-nav__link> <span class=md-ellipsis> OBJECTIVE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.STATEMENT class=md-nav__link> <span class=md-ellipsis> STATEMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.UNDEFINED class=md-nav__link> <span class=md-ellipsis> UNDEFINED </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext class=md-nav__link> <span class=md-ellipsis> TreeContext </span> </a> <nav class=md-nav aria-label=TreeContext> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.control_group class=md-nav__link> <span class=md-ellipsis> control_group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.control_title class=md-nav__link> <span class=md-ellipsis> control_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.part_label_to_id_map class=md-nav__link> <span class=md-ellipsis> part_label_to_id_map </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.section_to_part_name_map class=md-nav__link> <span class=md-ellipsis> section_to_part_name_map </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.reset class=md-nav__link> <span class=md-ellipsis> reset </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.control_markdown_node-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.markdown.control_markdown_node</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.markdown.control_markdown_node class="doc doc-heading"> <code>trestle.core.markdown.control_markdown_node</code> <a href=#trestle.core.markdown.control_markdown_node class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>A control markdown node.</p> <div class="doc doc-children"> <h3 id=trestle.core.markdown.control_markdown_node-attributes>Attributes<a href=#trestle.core.markdown.control_markdown_node-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.control_markdown_node.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.control_markdown_node.tree_context class="doc doc-heading"> <code class="highlight language-python"><span class=n>tree_context</span> <span class=o>=</span> <span class=n>TreeContext</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.tree_context class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.markdown.control_markdown_node-classes>Classes<a href=#trestle.core.markdown.control_markdown_node-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode class="doc doc-heading"> <code>ControlMarkdownNode</code> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.markdown.base_markdown_node.BaseMarkdownNode href=../base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode>BaseMarkdownNode</a></code></p> <p>Markdown will be read to the tree.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlMarkdownNode</span><span class=p>(</span><span class=n>BaseMarkdownNode</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Markdown will be read to the tree.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>content</span><span class=p>:</span> <span class=n>ControlSectionContent</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>:</span> <span class=nb>int</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize markdown node.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>(</span><span class=n>ControlMarkdownNode</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>content</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=p>:</span> <span class=n>ControlSectionContent</span> <span class=o>=</span> <span class=n>content</span>
+
+    <span class=k>def</span> <span class=nf>_build_tree</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                    <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+                    <span class=n>root_key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                    <span class=n>starting_line</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+                    <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+                    <span class=n>parent_part_id</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>ControlMarkdownNode</span><span class=p>,</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Build a tree from the markdown recursively.</span>
+
+<span class=sd>        The tree is contructed with valid headers as node&#39;s keys</span>
+<span class=sd>        and node&#39;s content contains everything that is under that header.</span>
+<span class=sd>        The subsections are placed into node&#39;s children with the same structure.</span>
+
+<span class=sd>        A header is valid iff the line starts with # and it is not:</span>
+<span class=sd>          1. Inside of the html blocks</span>
+<span class=sd>          2. Inside single lined in the &lt;&gt; tags</span>
+<span class=sd>          3. Inside the html comment</span>
+<span class=sd>          4. Inside any table, code block or blockquotes</span>
+
+<span class=sd>        Specific Control Rules:</span>
+<span class=sd>          1. If we are in control statement or objective, no subsections are allowed.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>content</span> <span class=o>=</span> <span class=n>ControlSectionContent</span><span class=p>()</span>
+        <span class=n>node_children</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>i</span> <span class=o>=</span> <span class=n>starting_line</span>
+
+        <span class=n>section_heading_type</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_section_heading_type</span><span class=p>(</span><span class=n>root_key</span><span class=p>)</span>
+
+        <span class=n>part_id</span><span class=p>,</span> <span class=n>part_name</span><span class=p>,</span> <span class=n>part_title</span><span class=p>,</span> <span class=n>by_id_part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_part_info_from_section_name</span><span class=p>(</span><span class=n>root_key</span><span class=p>,</span> <span class=n>parent_part_id</span><span class=p>,</span>
+                                                                                           <span class=n>section_heading_type</span><span class=p>)</span>
+
+        <span class=n>current_key_lvl</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_header_level_if_valid</span><span class=p>(</span><span class=n>root_key</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>section_heading_type</span> <span class=o>==</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>UNDEFINED</span> <span class=ow>and</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Undefined section </span><span class=si>{</span><span class=n>root_key</span><span class=si>}</span><span class=s1> is found in the markdown for control </span><span class=si>{</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>. &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;This section will be ignored. Please make sure the spelling is correct.&#39;</span>
+            <span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>current_key_lvl</span> <span class=ow>and</span> <span class=n>current_key_lvl</span> <span class=o>==</span> <span class=mi>1</span> <span class=ow>and</span> <span class=n>section_heading_type</span> <span class=o>!=</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>EDITABLE_CONTENT</span><span class=p>:</span>
+            <span class=c1># Parse control title</span>
+            <span class=k>if</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Duplicate control_id is found for the markdown </span><span class=si>{</span><span class=n>root_key</span><span class=si>}</span><span class=s1>, &#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;make sure you have reset tree context before reading another markdown.&#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;Use markdown processor to avoid this error.&#39;</span>
+                <span class=p>)</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Multiple top-level headers are found but only one header is allowed. See line </span><span class=si>{</span><span class=n>root_key</span><span class=si>}</span><span class=s1> &#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;for control </span><span class=si>{</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=p>)</span>
+            <span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>control_group</span><span class=p>,</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>control_title</span> <span class=o>=</span> <span class=n>ControlMarkdownNode</span><span class=o>.</span><span class=n>_parse_control_title_line</span><span class=p>(</span><span class=n>root_key</span><span class=p>)</span>  <span class=c1># noqa: E501</span>
+            <span class=n>content</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span>
+            <span class=n>content</span><span class=o>.</span><span class=n>control_group</span> <span class=o>=</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>control_group</span>
+            <span class=n>content</span><span class=o>.</span><span class=n>control_title</span> <span class=o>=</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>control_title</span>
+
+        <span class=k>def</span> <span class=nf>_strip_prose_or_none</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]):</span>
+            <span class=k>if</span> <span class=n>part</span> <span class=ow>and</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+                <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=k>else</span> <span class=kc>None</span>
+
+        <span class=k>def</span> <span class=nf>_add_child_prose_if_need</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>text</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>should_add</span><span class=p>:</span> <span class=nb>bool</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>should_add</span><span class=p>:</span>
+                <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=o>+=</span> <span class=n>text</span>
+
+        <span class=k>while</span> <span class=n>i</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>lines</span><span class=p>):</span>
+            <span class=n>line</span> <span class=o>=</span> <span class=n>lines</span><span class=p>[</span><span class=n>i</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>)</span>
+            <span class=n>header_lvl</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_header_level_if_valid</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>header_lvl</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>header_lvl</span> <span class=o>&gt;=</span> <span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>section_heading_type</span> <span class=ow>in</span> <span class=p>[</span><span class=n>ControlSectionType</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>OBJECTIVE</span><span class=p>]:</span>
+                        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;Control Statement or Objective sections cannot contain subsections but found: </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1>.&#39;</span>
+                            <span class=sa>f</span><span class=s1>&#39;Please delete this subsection and refer to docs on the required format.&#39;</span>
+                        <span class=p>)</span>
+                    <span class=c1># build subtree</span>
+                    <span class=n>subtree</span><span class=p>,</span> <span class=n>i</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_tree</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=n>line</span><span class=p>,</span> <span class=n>i</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>part_id</span><span class=p>)</span>
+                    <span class=n>node_children</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>subtree</span><span class=p>)</span>
+                    <span class=n>content</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>subtree</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>content</span><span class=o>.</span><span class=n>part</span> <span class=ow>and</span> <span class=n>subtree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span> <span class=ow>and</span> <span class=n>section_heading_type</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span>
+                            <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>OBJECTIVE</span><span class=p>,</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GUIDANCE</span>
+                    <span class=p>]:</span>
+                        <span class=c1># Control statement, objective and guidance have special treatment</span>
+                        <span class=c1># in those sections any subsections go to the prose rather than subparts.</span>
+                        <span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+                        <span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>subtree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>)</span>
+                    <span class=c1># Control parts can have general markdown in the prose, if we are in the control part</span>
+                    <span class=c1># add its contents under the prose of a parent</span>
+                    <span class=n>_add_child_prose_if_need</span><span class=p>(</span>
+                        <span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>,</span>
+                        <span class=n>subtree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span><span class=p>,</span>
+                        <span class=n>section_heading_type</span>
+                        <span class=ow>in</span> <span class=p>[</span><span class=n>ControlSectionType</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>OBJECTIVE</span><span class=p>,</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GUIDANCE</span><span class=p>]</span>
+                    <span class=p>)</span>
+                    <span class=k>continue</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>i</span> <span class=o>-=</span> <span class=mi>1</span>  <span class=c1># need to revert back one line to properly handle next heading</span>
+                    <span class=k>break</span>  <span class=c1># level of the header is above or equal to the current level, subtree is over</span>
+
+            <span class=k>if</span> <span class=n>section_heading_type</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=n>ControlSectionType</span><span class=o>.</span><span class=n>UNDEFINED</span><span class=p>,</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>EDITABLE_CONTENT</span><span class=p>]:</span>
+                <span class=c1># Read part</span>
+                <span class=n>content</span><span class=o>.</span><span class=n>part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_part_if_needed</span><span class=p>(</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>,</span> <span class=n>part_name</span><span class=p>,</span> <span class=n>part_id</span><span class=p>)</span>
+                <span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=n>part_title</span>
+                <span class=n>read_parts</span> <span class=o>=</span> <span class=n>section_heading_type</span> <span class=ow>in</span> <span class=p>[</span><span class=n>ControlSectionType</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>,</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>OBJECTIVE</span><span class=p>]</span>
+                <span class=k>if</span> <span class=n>by_id_part</span> <span class=ow>and</span> <span class=n>section_heading_type</span> <span class=o>==</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>EDITABLE_BY_ID_PART</span><span class=p>:</span>
+                    <span class=n>content</span><span class=o>.</span><span class=n>by_id_name</span> <span class=o>=</span> <span class=n>by_id_part</span>
+                <span class=n>i</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_process_part_line</span><span class=p>(</span><span class=n>i</span><span class=p>,</span> <span class=n>line</span><span class=p>,</span> <span class=n>lines</span><span class=p>,</span> <span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>,</span> <span class=n>read_parts</span><span class=o>=</span><span class=n>read_parts</span><span class=p>)</span>
+                <span class=k>continue</span>
+
+            <span class=c1># Nothing to do, simply increment</span>
+            <span class=n>i</span> <span class=o>+=</span> <span class=mi>1</span>
+
+        <span class=n>first_line_to_grab</span> <span class=o>=</span> <span class=n>starting_line</span> <span class=o>-</span> <span class=mi>1</span> <span class=k>if</span> <span class=n>starting_line</span> <span class=k>else</span> <span class=mi>0</span>
+        <span class=n>content</span><span class=o>.</span><span class=n>raw_text</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>lines</span><span class=p>[</span><span class=n>first_line_to_grab</span><span class=p>:</span><span class=n>i</span><span class=p>])</span>
+
+        <span class=n>_strip_prose_or_none</span><span class=p>(</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>)</span>
+
+        <span class=n>md_node</span> <span class=o>=</span> <span class=n>ControlMarkdownNode</span><span class=p>(</span><span class=n>key</span><span class=o>=</span><span class=n>root_key</span><span class=p>,</span> <span class=n>content</span><span class=o>=</span><span class=n>content</span><span class=p>,</span> <span class=n>starting_line</span><span class=o>=</span><span class=n>first_line_to_grab</span><span class=p>)</span>
+        <span class=n>md_node</span><span class=o>.</span><span class=n>subnodes</span> <span class=o>=</span> <span class=n>node_children</span>
+        <span class=k>return</span> <span class=n>md_node</span><span class=p>,</span> <span class=n>i</span>
+
+    <span class=k>def</span> <span class=nf>get_control_statement</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ControlMarkdownNode</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get control statement node.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=s1>&#39;## Control Statement&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_control_objective</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ControlMarkdownNode</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get control objective node.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>CONTROL_OBJECTIVE_HEADER</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_control_guidance</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ControlMarkdownNode</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get control guidance node.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=s1>&#39;## Control Guidance&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_by_id_parts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get by id editable parts.&quot;&quot;&quot;</span>
+        <span class=n>part_id_to_parts_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>node_key</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>k</span><span class=p>:</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PART_REGEX</span><span class=p>,</span> <span class=n>k</span><span class=p>)):</span>
+            <span class=c1># A by id part section</span>
+            <span class=n>part_node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>node_key</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>part_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error no part was found in section </span><span class=si>{</span><span class=n>part_node</span><span class=o>.</span><span class=n>key</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>part_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>by_id_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>part_id_to_parts_map</span><span class=p>:</span>
+                <span class=n>part_id_to_parts_map</span><span class=p>[</span><span class=n>part_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>by_id_name</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>part_node</span><span class=o>.</span><span class=n>subnodes</span><span class=p>:</span>
+                <span class=c1># We only care about subsections of ## Part section</span>
+                <span class=k>if</span> <span class=n>subpart</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>:</span>
+                    <span class=n>part_id_to_parts_map</span><span class=p>[</span><span class=n>part_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>by_id_name</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>subpart</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>part_id_to_parts_map</span>
+
+    <span class=k>def</span> <span class=nf>get_editable_parts_and_subparts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get editable parts and subparts if exist.&quot;&quot;&quot;</span>
+        <span class=n>by_id_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_by_id_parts</span><span class=p>()</span>
+        <span class=n>exclude_parts_id</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>by_id_parts</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+        <span class=n>editable_node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;# </span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>EDITABLE_CONTENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_subparts</span><span class=p>(</span><span class=n>editable_node</span><span class=p>,</span> <span class=n>exclude_parts_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>parts</span>
+
+    <span class=k>def</span> <span class=nf>_get_subparts</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                      <span class=n>control_node</span><span class=p>:</span> <span class=n>ControlMarkdownNode</span><span class=p>,</span>
+                      <span class=n>exclude_ids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get subparts of the control part node if exists.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>control_node</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=s1>&#39;No control node was provided to extract subparts. &#39;</span>
+                <span class=s1>&#39;Please make sure your markdown contains # Editable Content section.&#39;</span>
+            <span class=p>)</span>
+        <span class=n>parts</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>editable_part</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=n>control_node</span><span class=o>.</span><span class=n>subnodes</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>editable_part</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=o>.</span><span class=n>id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>exclude_ids</span><span class=p>:</span>
+                <span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>editable_part</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>parts</span>
+
+    <span class=k>def</span> <span class=nf>_get_section_heading_type</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ControlSectionType</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Determine the section type based on the heading.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>root_key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;## control statement&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>STATEMENT</span>
+        <span class=k>elif</span> <span class=n>root_key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;## control objective&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>OBJECTIVE</span>
+        <span class=k>elif</span> <span class=n>root_key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;## control guidance&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GUIDANCE</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span><span class=n>root_key</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>PART_REGEX</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>EDITABLE_BY_ID_PART</span>
+        <span class=k>elif</span> <span class=sa>f</span><span class=s1>&#39;# </span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>EDITABLE_CONTENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>root_key</span><span class=o>.</span><span class=n>lower</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>EDITABLE_CONTENT</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span><span class=n>root_key</span><span class=p>,</span> <span class=n>const</span><span class=o>.</span><span class=n>CONTROL_REGEX</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GENERIC_CONTROL_PART</span>
+        <span class=k>elif</span> <span class=s1>&#39;### &#39;</span> <span class=ow>in</span> <span class=n>root_key</span><span class=o>.</span><span class=n>lower</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GENERIC_SUBPART</span>
+
+        <span class=k>return</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>UNDEFINED</span>
+
+    <span class=k>def</span> <span class=nf>_get_part_info_from_section_name</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>parent_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                                         <span class=n>section_heading_type</span><span class=p>:</span> <span class=n>ControlSectionType</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get part information such as id, name and title based on the section heading.&quot;&quot;&quot;</span>
+        <span class=n>part_id</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>part_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>part_title</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>by_part_id</span> <span class=o>=</span> <span class=kc>None</span>  <span class=c1># special case used for ## Part</span>
+
+        <span class=k>if</span> <span class=n>section_heading_type</span> <span class=ow>in</span> <span class=p>[</span><span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GUIDANCE</span><span class=p>,</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GENERIC_CONTROL_PART</span><span class=p>]:</span>
+            <span class=n>prefix</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>CONTROL_HEADER</span> <span class=o>+</span> <span class=s1>&#39; &#39;</span>
+            <span class=n>control_md_heading_label</span> <span class=o>=</span> <span class=n>root_key</span><span class=p>[</span><span class=nb>len</span><span class=p>(</span><span class=n>prefix</span><span class=p>):]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>control_md_heading_label_ncname</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>strip_to_make_ncname</span><span class=p>(</span><span class=n>control_md_heading_label</span><span class=p>)</span>
+            <span class=n>control_md_heading_label_snakename</span> <span class=o>=</span> <span class=n>spaces_and_caps_to_snake</span><span class=p>(</span><span class=n>control_md_heading_label</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>section_heading_type</span> <span class=o>==</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>STATEMENT</span><span class=p>:</span>
+            <span class=n>part_id</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>create_statement_id</span><span class=p>(</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=n>part_name</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>STATEMENT</span>
+
+        <span class=k>if</span> <span class=n>section_heading_type</span> <span class=o>==</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>OBJECTIVE</span><span class=p>:</span>
+            <span class=n>part_id</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>_obj&#39;</span>
+            <span class=n>part_name</span> <span class=o>=</span> <span class=s1>&#39;objective&#39;</span>
+
+        <span class=k>if</span> <span class=n>section_heading_type</span> <span class=o>==</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GUIDANCE</span><span class=p>:</span>
+            <span class=c1># Read control guidance to a part object</span>
+            <span class=n>part_id</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>strip_to_make_ncname</span><span class=p>(</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span> <span class=o>+</span> <span class=s1>&#39;_gdn&#39;</span><span class=p>)</span>
+            <span class=n>part_name</span> <span class=o>=</span> <span class=n>control_md_heading_label_ncname</span>
+
+        <span class=k>if</span> <span class=n>section_heading_type</span> <span class=o>==</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>EDITABLE_BY_ID_PART</span><span class=p>:</span>
+            <span class=c1># Read editable part</span>
+            <span class=n>by_part_label</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PART_REGEX</span><span class=p>,</span> <span class=n>root_key</span><span class=o>.</span><span class=n>lower</span><span class=p>())</span><span class=o>.</span><span class=n>groups</span><span class=p>(</span><span class=mi>0</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>control_label_map</span> <span class=o>=</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>part_label_to_id_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control_label_map</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No label map found for control </span><span class=si>{</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>by_part_id</span> <span class=o>=</span> <span class=n>control_label_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>by_part_label</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>by_part_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No part id found for label </span><span class=si>{</span><span class=n>by_part_label</span><span class=si>}</span><span class=s1> in control </span><span class=si>{</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>part_name</span> <span class=o>=</span> <span class=n>spaces_and_caps_to_snake</span><span class=p>(</span><span class=n>root_key</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;#&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>())</span>
+            <span class=n>part_id</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>by_part_id</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>part_title</span> <span class=o>=</span> <span class=n>root_key</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;#&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+
+        <span class=k>if</span> <span class=n>section_heading_type</span> <span class=o>==</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GENERIC_CONTROL_PART</span><span class=p>:</span>
+            <span class=c1># Read other control parts to a part objects</span>
+            <span class=n>part_name</span> <span class=o>=</span> <span class=n>control_md_heading_label_snakename</span>
+            <span class=k>if</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>section_to_part_name_map</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>control_md_heading_label</span> <span class=ow>in</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>section_to_part_name_map</span><span class=p>:</span>
+                    <span class=n>part_name</span> <span class=o>=</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>section_to_part_name_map</span><span class=p>[</span><span class=n>control_md_heading_label</span><span class=p>]</span>
+
+                <span class=n>part_id</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>_</span><span class=si>{</span><span class=n>part_name</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=n>part_title</span> <span class=o>=</span> <span class=n>control_md_heading_label</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>part_id</span> <span class=o>=</span> <span class=n>spaces_and_caps_to_snake</span><span class=p>(</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span> <span class=o>+</span> <span class=s1>&#39;_&#39;</span> <span class=o>+</span> <span class=n>control_md_heading_label</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>section_heading_type</span> <span class=o>==</span> <span class=n>ControlSectionType</span><span class=o>.</span><span class=n>GENERIC_SUBPART</span><span class=p>:</span>
+            <span class=c1># Read other control parts to a part objects</span>
+            <span class=n>match</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>AFTER_HASHES_REGEX</span><span class=p>,</span> <span class=n>root_key</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>match</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unexpected editable header </span><span class=si>{</span><span class=n>root_key</span><span class=si>}</span><span class=s1> found in part </span><span class=si>{</span><span class=n>part_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>part_name_raw</span> <span class=o>=</span> <span class=n>match</span><span class=o>.</span><span class=n>groups</span><span class=p>(</span><span class=mi>0</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>part_name</span> <span class=o>=</span> <span class=n>spaces_and_caps_to_snake</span><span class=p>(</span><span class=n>part_name_raw</span><span class=p>)</span>
+            <span class=n>parent_suffix</span> <span class=o>=</span> <span class=n>parent_id</span> <span class=o>+</span> <span class=s1>&#39;.&#39;</span> <span class=k>if</span> <span class=n>parent_id</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+            <span class=n>part_id</span> <span class=o>=</span> <span class=n>parent_suffix</span> <span class=o>+</span> <span class=n>part_name</span>
+
+        <span class=k>return</span> <span class=n>part_id</span><span class=p>,</span> <span class=n>part_name</span><span class=p>,</span> <span class=n>part_title</span><span class=p>,</span> <span class=n>by_part_id</span>
+
+    <span class=k>def</span> <span class=nf>get_other_control_parts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Optional</span><span class=p>[</span><span class=n>ControlMarkdownNode</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all other control parts that are not statement, guidance or objective.&quot;&quot;&quot;</span>
+        <span class=n>all_other_nodes</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>all_control_sections</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_headers_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>CONTROL_HEADER</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>control_statement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_statement</span><span class=p>()</span>
+        <span class=n>control_objective</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_objective</span><span class=p>()</span>
+        <span class=n>control_guidance</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_guidance</span><span class=p>()</span>
+        <span class=n>control_statement_heading</span> <span class=o>=</span> <span class=n>control_statement</span><span class=o>.</span><span class=n>key</span> <span class=k>if</span> <span class=n>control_statement</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>control_objective_heading</span> <span class=o>=</span> <span class=n>control_objective</span><span class=o>.</span><span class=n>key</span> <span class=k>if</span> <span class=n>control_objective</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>control_guidance_heading</span> <span class=o>=</span> <span class=n>control_guidance</span><span class=o>.</span><span class=n>key</span> <span class=k>if</span> <span class=n>control_guidance</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>for</span> <span class=n>heading_key</span> <span class=ow>in</span> <span class=n>all_control_sections</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>heading_key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>{</span><span class=n>control_statement_heading</span><span class=p>,</span> <span class=n>control_objective_heading</span><span class=p>,</span> <span class=n>control_guidance_heading</span><span class=p>}:</span>
+                <span class=n>section_node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>heading_key</span><span class=p>)</span>
+                <span class=n>all_other_nodes</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>section_node</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>all_other_nodes</span>
+
+    <span class=k>def</span> <span class=nf>_create_part_if_needed</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>content_part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>part_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>part_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>prose</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create a new part if does not exist or return existing part.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>content_part</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Unexpected error, control id, group and title should be before ## Control </span><span class=si>{</span><span class=n>part_name</span><span class=si>}</span><span class=s1>.&#39;</span>
+                    <span class=s1>&#39;However, none was found.&#39;</span>
+                <span class=p>)</span>
+
+            <span class=n>content_part</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>part_name</span><span class=p>,</span> <span class=nb>id</span><span class=o>=</span><span class=n>part_id</span><span class=p>,</span> <span class=n>prose</span><span class=o>=</span><span class=n>prose</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>content_part</span>
+
+    <span class=k>def</span> <span class=nf>_process_part_line</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>line_idx</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>read_parts</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Process line for the part.</span>
+
+<span class=sd>        If the read_parts is given and the line starts with &#39;-&#39; then</span>
+<span class=sd>        the markdown list will be read to the subparts of the given part.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_start_with</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>HTML_COMMENT_START</span><span class=p>):</span>
+            <span class=n>comment_lines</span><span class=p>,</span> <span class=n>line_idx</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_html_block</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=n>line</span><span class=p>,</span> <span class=n>line_idx</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>HTML_COMMENT_END_REGEX</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>line_idx</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>lines</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>line_idx</span>
+            <span class=n>line</span> <span class=o>=</span> <span class=n>lines</span><span class=p>[</span><span class=n>line_idx</span><span class=p>]</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_start_with</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>CODEBLOCK_DEF</span><span class=p>):</span>
+            <span class=n>code_lines</span><span class=p>,</span> <span class=n>line_idx</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_code_lines</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=n>line</span><span class=p>,</span> <span class=n>line_idx</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>line_idx</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>lines</span><span class=p>):</span>
+                <span class=k>return</span> <span class=n>line_idx</span>
+            <span class=n>line</span> <span class=o>=</span> <span class=n>lines</span><span class=p>[</span><span class=n>line_idx</span><span class=p>]</span>
+            <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>code_lines</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>line</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>line</span><span class=o>.</span><span class=n>lstrip</span><span class=p>():</span>
+            <span class=c1># Empty line</span>
+            <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span>
+            <span class=n>line_idx</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=k>return</span> <span class=n>line_idx</span>
+
+        <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>lstrip</span><span class=p>()[</span><span class=mi>0</span><span class=p>]</span> <span class=o>!=</span> <span class=s1>&#39;-&#39;</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>read_parts</span><span class=p>:</span>
+            <span class=c1># Line of text in prose</span>
+            <span class=n>part</span><span class=o>.</span><span class=n>prose</span> <span class=o>+=</span> <span class=n>line</span> <span class=o>+</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span>
+            <span class=n>line_idx</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># A part of inside of statement part</span>
+            <span class=k>if</span> <span class=n>read_parts</span><span class=p>:</span>
+                <span class=n>end_idx</span><span class=p>,</span> <span class=n>parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_parts</span><span class=p>(</span><span class=mi>0</span><span class=p>,</span> <span class=n>line_idx</span><span class=p>,</span> <span class=n>lines</span><span class=p>,</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=p>[])</span>
+                <span class=n>part</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>parts</span><span class=p>)</span>
+                <span class=n>line_idx</span> <span class=o>=</span> <span class=n>end_idx</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>part</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> does not support subparts, ignoring </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1> in control </span><span class=si>{</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=p>)</span>
+                <span class=n>line_idx</span> <span class=o>+=</span> <span class=mi>1</span>
+
+        <span class=k>return</span> <span class=n>line_idx</span>
+
+    <span class=k>def</span> <span class=nf>_read_parts</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>indent</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>ii</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>parent_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                    <span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>int</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;If indentation level goes up or down, create new list or close current one.&quot;&quot;&quot;</span>
+        <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=n>ii</span><span class=p>,</span> <span class=n>new_indent</span><span class=p>,</span> <span class=n>line</span> <span class=o>=</span> <span class=n>ControlMarkdownNode</span><span class=o>.</span><span class=n>_get_next_indent</span><span class=p>(</span><span class=n>ii</span><span class=p>,</span> <span class=n>lines</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>new_indent</span> <span class=o>&lt;</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=c1># we are done reading control statement</span>
+                <span class=k>return</span> <span class=n>ii</span><span class=p>,</span> <span class=n>parts</span>
+            <span class=k>if</span> <span class=n>new_indent</span> <span class=o>==</span> <span class=n>indent</span><span class=p>:</span>
+                <span class=c1># create new item part and add to current list of parts</span>
+                <span class=n>id_text</span><span class=p>,</span> <span class=n>prose</span> <span class=o>=</span> <span class=n>ControlMarkdownNode</span><span class=o>.</span><span class=n>_read_part_id_prose</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+                <span class=c1># id_text is the part id and needs to be as a label property value</span>
+                <span class=c1># if none is there then create one from previous part, or use default</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>id_text</span><span class=p>:</span>
+                    <span class=n>prev_label</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_label</span><span class=p>(</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span> <span class=k>if</span> <span class=n>parts</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+                    <span class=n>id_text</span> <span class=o>=</span> <span class=n>ControlMarkdownNode</span><span class=o>.</span><span class=n>_create_next_label</span><span class=p>(</span><span class=n>prev_label</span><span class=p>,</span> <span class=n>indent</span><span class=p>)</span>
+                <span class=n>id_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>strip_to_make_ncname</span><span class=p>(</span><span class=n>parent_id</span><span class=o>.</span><span class=n>rstrip</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span> <span class=o>+</span> <span class=s1>&#39;.&#39;</span> <span class=o>+</span> <span class=n>id_text</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>))</span>
+                <span class=n>name</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>OBJECTIVE_PART</span> <span class=k>if</span> <span class=n>id_</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=s1>&#39;_obj&#39;</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span> <span class=k>else</span> <span class=n>const</span><span class=o>.</span><span class=n>ITEM</span>
+                <span class=n>prop</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=s1>&#39;label&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>id_text</span><span class=p>)</span>
+                <span class=n>part</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=nb>id</span><span class=o>=</span><span class=n>id_</span><span class=p>,</span> <span class=n>prose</span><span class=o>=</span><span class=n>prose</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=p>[</span><span class=n>prop</span><span class=p>])</span>
+                <span class=k>if</span> <span class=n>id_</span> <span class=ow>in</span> <span class=p>[</span><span class=n>p</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>p</span> <span class=ow>in</span> <span class=n>parts</span><span class=p>]:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;Duplicate part id </span><span class=si>{</span><span class=n>id_</span><span class=si>}</span><span class=s1> is found in markdown &#39;</span>
+                        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>tree_context</span><span class=o>.</span><span class=n>control_id</span><span class=si>}</span><span class=s1>. Please correct the part label in line </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1>.&#39;</span>
+                    <span class=p>)</span>
+                <span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>part</span><span class=p>)</span>
+                <span class=n>ii</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=k>elif</span> <span class=n>new_indent</span> <span class=o>&gt;</span> <span class=n>indent</span><span class=p>:</span>
+                <span class=c1># add new list of parts to last part and continue</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Improper indentation structure: </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>ii</span><span class=p>,</span> <span class=n>new_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_parts</span><span class=p>(</span><span class=n>new_indent</span><span class=p>,</span> <span class=n>ii</span><span class=p>,</span> <span class=n>lines</span><span class=p>,</span> <span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>id</span><span class=p>,</span> <span class=p>[])</span>
+                <span class=k>if</span> <span class=n>new_parts</span><span class=p>:</span>
+                    <span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>new_parts</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># return list of sub-parts</span>
+                <span class=k>return</span> <span class=n>ii</span><span class=p>,</span> <span class=n>parts</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_indent</span><span class=p>(</span><span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Measure indent of non-empty line.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>line</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Empty line queried for indent.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>line</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39;</span><span class=se>\t</span><span class=s1>&#39;</span><span class=p>]:</span>
+            <span class=k>return</span> <span class=o>-</span><span class=mi>1</span>
+
+        <span class=n>indent</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>for</span> <span class=n>ii</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=nb>len</span><span class=p>(</span><span class=n>line</span><span class=p>)):</span>
+            <span class=k>if</span> <span class=n>line</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;-&#39;</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>indent</span>
+            <span class=c1># if line is indented it must start with -</span>
+            <span class=k>if</span> <span class=n>line</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;</span><span class=se>\t</span><span class=s1>&#39;</span><span class=p>:</span>
+                <span class=c1># treat tab as two spaces</span>
+                <span class=n>indent</span> <span class=o>+=</span> <span class=mi>2</span>
+            <span class=k>elif</span> <span class=n>line</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=o>!=</span> <span class=s1>&#39; &#39;</span><span class=p>:</span>
+                <span class=k>break</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>indent</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;List elements must start with -: </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_parse_control_title_line</span><span class=p>(</span><span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Process the title line and extract the control id, group title (in brackets) and control title.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>count</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown control title format error, missing - after control id: </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>split_line</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>split</span><span class=p>()</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>split_line</span><span class=p>)</span> <span class=o>&lt;</span> <span class=mi>3</span> <span class=ow>or</span> <span class=n>split_line</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span> <span class=o>!=</span> <span class=s1>&#39;-&#39;</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cannot parse control markdown title for control_id group and title: </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># first token after the #</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>split_line</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>group_title_start</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=s1>&#39;\[&#39;</span><span class=p>)</span>
+        <span class=n>group_title_end</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=s1>&#39;\]&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>group_title_start</span> <span class=o>&lt;</span> <span class=mi>0</span> <span class=ow>or</span> <span class=n>group_title_end</span> <span class=o>&lt;</span> <span class=mi>0</span> <span class=ow>or</span> <span class=n>group_title_start</span> <span class=o>&gt;</span> <span class=n>group_title_end</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;unable to read group title for control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>group_title</span> <span class=o>=</span> <span class=n>line</span><span class=p>[</span><span class=n>group_title_start</span> <span class=o>+</span> <span class=mi>2</span><span class=p>:</span><span class=n>group_title_end</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=n>control_title</span> <span class=o>=</span> <span class=n>line</span><span class=p>[</span><span class=n>group_title_end</span> <span class=o>+</span> <span class=mi>2</span><span class=p>:]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>control_id</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>control_title</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_read_part_id_prose</span><span class=p>(</span><span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Extract the part id letter or number and prose from line.&quot;&quot;&quot;</span>
+        <span class=n>start</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\\</span><span class=s1>[&#39;</span><span class=p>)</span>
+        <span class=n>end</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>find</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\\</span><span class=s1>]&#39;</span><span class=p>)</span>
+        <span class=n>prose</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=k>if</span> <span class=n>start</span> <span class=o>&lt;</span> <span class=mi>0</span> <span class=k>else</span> <span class=n>line</span><span class=p>[</span><span class=n>end</span> <span class=o>+</span> <span class=mi>2</span><span class=p>:]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=n>id_</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=n>start</span> <span class=o>&lt;</span> <span class=mi>0</span> <span class=ow>or</span> <span class=n>end</span> <span class=o>&lt;</span> <span class=mi>0</span> <span class=k>else</span> <span class=n>line</span><span class=p>[</span><span class=n>start</span> <span class=o>+</span> <span class=mi>2</span><span class=p>:</span><span class=n>end</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>id_</span><span class=p>,</span> <span class=n>prose</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_create_next_label</span><span class=p>(</span><span class=n>prev_label</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>indent</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Create new label at indent level based on previous label if available.</span>
+
+<span class=sd>        If previous label is available, make this the next one in the sequence.</span>
+<span class=sd>        Otherwise start with a or 1 on alternate levels of indentation.</span>
+<span class=sd>        If alphabetic label reaches z, next one is aa.</span>
+<span class=sd>        Numeric ranges from 1 to 9, then 10 etc.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>prev_label</span><span class=p>:</span>
+            <span class=c1># assume indent goes in steps of 2</span>
+            <span class=k>return</span> <span class=p>[</span><span class=s1>&#39;a&#39;</span><span class=p>,</span> <span class=s1>&#39;1&#39;</span><span class=p>][(</span><span class=n>indent</span> <span class=o>//</span> <span class=mi>2</span><span class=p>)</span> <span class=o>%</span> <span class=mi>2</span><span class=p>]</span>
+        <span class=n>label_prefix</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>label_suffix</span> <span class=o>=</span> <span class=n>prev_label</span>
+        <span class=n>is_char</span> <span class=o>=</span> <span class=n>prev_label</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=ow>in</span> <span class=n>string</span><span class=o>.</span><span class=n>ascii_letters</span>
+        <span class=c1># if it isn&#39;t ending in letter or digit just append &#39;a&#39; to end</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>is_char</span> <span class=ow>and</span> <span class=n>prev_label</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>string</span><span class=o>.</span><span class=n>digits</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>prev_label</span> <span class=o>+</span> <span class=s1>&#39;a&#39;</span>
+        <span class=c1># break in middle of string if mixed types</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>prev_label</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>ii</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>prev_label</span><span class=p>)</span> <span class=o>-</span> <span class=mi>1</span>
+            <span class=k>while</span> <span class=n>ii</span> <span class=o>&gt;=</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>prev_label</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>string</span><span class=o>.</span><span class=n>ascii_letters</span> <span class=o>+</span> <span class=n>string</span><span class=o>.</span><span class=n>digits</span><span class=p>:</span>
+                    <span class=k>break</span>
+                <span class=k>if</span> <span class=p>(</span><span class=n>prev_label</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=ow>in</span> <span class=n>string</span><span class=o>.</span><span class=n>ascii_letters</span><span class=p>)</span> <span class=o>!=</span> <span class=n>is_char</span><span class=p>:</span>
+                    <span class=k>break</span>
+                <span class=n>ii</span> <span class=o>-=</span> <span class=mi>1</span>
+            <span class=k>if</span> <span class=n>ii</span> <span class=o>&gt;=</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>label_prefix</span> <span class=o>=</span> <span class=n>prev_label</span><span class=p>[:(</span><span class=n>ii</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)]</span>
+                <span class=n>label_suffix</span> <span class=o>=</span> <span class=n>prev_label</span><span class=p>[(</span><span class=n>ii</span> <span class=o>+</span> <span class=mi>1</span><span class=p>):]</span>
+
+        <span class=k>return</span> <span class=n>label_prefix</span> <span class=o>+</span> <span class=n>ControlMarkdownNode</span><span class=o>.</span><span class=n>_bump_label</span><span class=p>(</span><span class=n>label_suffix</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_bump_label</span><span class=p>(</span><span class=n>label</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Find next label given a string of 1 or more pure letters or digits.</span>
+
+<span class=sd>        The input must be either a string of digits or a string of ascii letters - or empty string.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>label</span><span class=p>:</span>
+            <span class=k>return</span> <span class=s1>&#39;a&#39;</span>
+        <span class=k>if</span> <span class=n>label</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=ow>in</span> <span class=n>string</span><span class=o>.</span><span class=n>digits</span><span class=p>:</span>
+            <span class=k>return</span> <span class=nb>str</span><span class=p>(</span><span class=nb>int</span><span class=p>(</span><span class=n>label</span><span class=p>)</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>label</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span> <span class=ow>and</span> <span class=n>label</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>&lt;</span> <span class=s1>&#39;z&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=nb>chr</span><span class=p>(</span><span class=nb>ord</span><span class=p>(</span><span class=n>label</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)</span>
+        <span class=c1># if this happens to be a string of letters, force it lowercase and bump</span>
+        <span class=n>label</span> <span class=o>=</span> <span class=n>label</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span>
+        <span class=n>factor</span> <span class=o>=</span> <span class=mi>1</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=c1># delta is needed because a counts as 0 when first value on right, but 1 for all others</span>
+        <span class=n>delta</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>for</span> <span class=n>letter</span> <span class=ow>in</span> <span class=n>label</span><span class=p>[::</span><span class=o>-</span><span class=mi>1</span><span class=p>]:</span>
+            <span class=n>value</span> <span class=o>+=</span> <span class=p>(</span><span class=nb>ord</span><span class=p>(</span><span class=n>letter</span><span class=p>)</span> <span class=o>-</span> <span class=nb>ord</span><span class=p>(</span><span class=s1>&#39;a&#39;</span><span class=p>)</span> <span class=o>+</span> <span class=n>delta</span><span class=p>)</span> <span class=o>*</span> <span class=n>factor</span>
+            <span class=n>factor</span> <span class=o>*=</span> <span class=mi>26</span>
+            <span class=n>delta</span> <span class=o>=</span> <span class=mi>1</span>
+
+        <span class=n>value</span> <span class=o>+=</span> <span class=mi>1</span>
+
+        <span class=n>new_label</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>delta</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>while</span> <span class=n>value</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>new_label</span> <span class=o>+=</span> <span class=nb>chr</span><span class=p>(</span><span class=nb>ord</span><span class=p>(</span><span class=s1>&#39;a&#39;</span><span class=p>)</span> <span class=o>+</span> <span class=n>value</span> <span class=o>%</span> <span class=mi>26</span> <span class=o>-</span> <span class=n>delta</span><span class=p>)</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=n>value</span> <span class=o>//</span> <span class=mi>26</span>
+            <span class=n>delta</span> <span class=o>=</span> <span class=mi>1</span>
+        <span class=k>return</span> <span class=n>new_label</span><span class=p>[::</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_get_next_indent</span><span class=p>(</span><span class=n>ii</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>skip_empty_lines</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>int</span><span class=p>,</span> <span class=nb>int</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Seek to next content line.  ii remains at line read.&quot;&quot;&quot;</span>
+        <span class=k>while</span> <span class=mi>0</span> <span class=o>&lt;=</span> <span class=n>ii</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>lines</span><span class=p>):</span>
+            <span class=n>line</span> <span class=o>=</span> <span class=n>lines</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>line</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>line</span><span class=o>.</span><span class=n>isspace</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>line</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;#&#39;</span><span class=p>:</span>
+                    <span class=k>return</span> <span class=n>ii</span><span class=p>,</span> <span class=o>-</span><span class=mi>1</span><span class=p>,</span> <span class=n>line</span>
+                <span class=n>indent</span> <span class=o>=</span> <span class=n>ControlMarkdownNode</span><span class=o>.</span><span class=n>_indent</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>indent</span> <span class=o>&gt;=</span> <span class=mi>0</span><span class=p>:</span>
+                    <span class=c1># extract text after -</span>
+                    <span class=n>start</span> <span class=o>=</span> <span class=n>indent</span> <span class=o>+</span> <span class=mi>1</span>
+                    <span class=k>while</span> <span class=n>start</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>line</span><span class=p>)</span> <span class=ow>and</span> <span class=n>line</span><span class=p>[</span><span class=n>start</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39; &#39;</span><span class=p>:</span>
+                        <span class=n>start</span> <span class=o>+=</span> <span class=mi>1</span>
+                    <span class=k>if</span> <span class=n>start</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>line</span><span class=p>):</span>
+                        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid line </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>return</span> <span class=n>ii</span><span class=p>,</span> <span class=n>indent</span><span class=p>,</span> <span class=n>line</span><span class=p>[</span><span class=n>start</span><span class=p>:]</span>
+                <span class=k>return</span> <span class=n>ii</span><span class=p>,</span> <span class=n>indent</span><span class=p>,</span> <span class=n>line</span>
+            <span class=k>elif</span> <span class=ow>not</span> <span class=n>skip_empty_lines</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>ii</span><span class=p>,</span> <span class=o>-</span><span class=mi>1</span><span class=p>,</span> <span class=n>line</span>
+            <span class=n>ii</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=k>return</span> <span class=n>ii</span><span class=p>,</span> <span class=o>-</span><span class=mi>1</span><span class=p>,</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode-attributes>Attributes<a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode.content class="doc doc-heading"> <code class="highlight language-python"><span class=n>content</span><span class=p>:</span> <span class=n>ControlSectionContent</span> <span class=o>=</span> <span class=n>content</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.content class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode-functions>Functions<a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>content</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>)</span></code> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize markdown node.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>content</span><span class=p>:</span> <span class=n>ControlSectionContent</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>:</span> <span class=nb>int</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize markdown node.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>(</span><span class=n>ControlMarkdownNode</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>content</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=p>:</span> <span class=n>ControlSectionContent</span> <span class=o>=</span> <span class=n>content</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_by_id_parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_by_id_parts</span><span class=p>()</span></code> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_by_id_parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get by id editable parts.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_by_id_parts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get by id editable parts.&quot;&quot;&quot;</span>
+    <span class=n>part_id_to_parts_map</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>node_key</span> <span class=ow>in</span> <span class=n>as_filtered_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>k</span><span class=p>:</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>PART_REGEX</span><span class=p>,</span> <span class=n>k</span><span class=p>)):</span>
+        <span class=c1># A by id part section</span>
+        <span class=n>part_node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>node_key</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>part_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error no part was found in section </span><span class=si>{</span><span class=n>part_node</span><span class=o>.</span><span class=n>key</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>part_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>by_id_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>part_id_to_parts_map</span><span class=p>:</span>
+            <span class=n>part_id_to_parts_map</span><span class=p>[</span><span class=n>part_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>by_id_name</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>part_node</span><span class=o>.</span><span class=n>subnodes</span><span class=p>:</span>
+            <span class=c1># We only care about subsections of ## Part section</span>
+            <span class=k>if</span> <span class=n>subpart</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>:</span>
+                <span class=n>part_id_to_parts_map</span><span class=p>[</span><span class=n>part_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>by_id_name</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>subpart</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>part</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>part_id_to_parts_map</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_guidance class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_guidance</span><span class=p>()</span></code> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_guidance class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get control guidance node.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_guidance</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ControlMarkdownNode</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get control guidance node.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=s1>&#39;## Control Guidance&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_objective class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_objective</span><span class=p>()</span></code> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_objective class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get control objective node.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_objective</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ControlMarkdownNode</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get control objective node.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>CONTROL_OBJECTIVE_HEADER</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_statement class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_statement</span><span class=p>()</span></code> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_statement class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get control statement node.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_statement</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ControlMarkdownNode</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get control statement node.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=s1>&#39;## Control Statement&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_editable_parts_and_subparts class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_editable_parts_and_subparts</span><span class=p>()</span></code> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_editable_parts_and_subparts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get editable parts and subparts if exist.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_editable_parts_and_subparts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get editable parts and subparts if exist.&quot;&quot;&quot;</span>
+    <span class=n>by_id_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_by_id_parts</span><span class=p>()</span>
+    <span class=n>exclude_parts_id</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>by_id_parts</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span>
+    <span class=n>editable_node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;# </span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>EDITABLE_CONTENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_subparts</span><span class=p>(</span><span class=n>editable_node</span><span class=p>,</span> <span class=n>exclude_parts_id</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>parts</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_other_control_parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_other_control_parts</span><span class=p>()</span></code> <a href=#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_other_control_parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get all other control parts that are not statement, guidance or objective.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_other_control_parts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Optional</span><span class=p>[</span><span class=n>ControlMarkdownNode</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get all other control parts that are not statement, guidance or objective.&quot;&quot;&quot;</span>
+    <span class=n>all_other_nodes</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>all_control_sections</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_all_headers_for_key</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>CONTROL_HEADER</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+    <span class=n>control_statement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_statement</span><span class=p>()</span>
+    <span class=n>control_objective</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_objective</span><span class=p>()</span>
+    <span class=n>control_guidance</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_control_guidance</span><span class=p>()</span>
+    <span class=n>control_statement_heading</span> <span class=o>=</span> <span class=n>control_statement</span><span class=o>.</span><span class=n>key</span> <span class=k>if</span> <span class=n>control_statement</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>control_objective_heading</span> <span class=o>=</span> <span class=n>control_objective</span><span class=o>.</span><span class=n>key</span> <span class=k>if</span> <span class=n>control_objective</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>control_guidance_heading</span> <span class=o>=</span> <span class=n>control_guidance</span><span class=o>.</span><span class=n>key</span> <span class=k>if</span> <span class=n>control_guidance</span> <span class=k>else</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>for</span> <span class=n>heading_key</span> <span class=ow>in</span> <span class=n>all_control_sections</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>heading_key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>{</span><span class=n>control_statement_heading</span><span class=p>,</span> <span class=n>control_objective_heading</span><span class=p>,</span> <span class=n>control_guidance_heading</span><span class=p>}:</span>
+            <span class=n>section_node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_node_for_key</span><span class=p>(</span><span class=n>heading_key</span><span class=p>)</span>
+            <span class=n>all_other_nodes</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>section_node</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>all_other_nodes</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.control_markdown_node.ControlSectionContent class="doc doc-heading"> <code>ControlSectionContent</code> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.markdown.base_markdown_node.BaseSectionContent href=../base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseSectionContent>BaseSectionContent</a></code></p> <p>A content of the node.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlSectionContent</span><span class=p>(</span><span class=n>BaseSectionContent</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;A content of the node.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize section content.</span>
+
+<span class=sd>        Attributes:</span>
+<span class=sd>            part: A part that is found in markdown. A part is defined in markdown by two or more # symbols</span>
+<span class=sd>            by_id_name: Required for parts defined as ## Part a in a markdown</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>(</span><span class=n>ControlSectionContent</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>part</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>by_id_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=k>def</span> <span class=nf>union</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>node</span><span class=p>:</span> <span class=n>ControlMarkdownNode</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Unites contents together.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>node</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.control_markdown_node.ControlSectionContent-attributes>Attributes<a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionContent.by_id_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_id_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.by_id_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionContent.part class="doc doc-heading"> <code class="highlight language-python"><span class=n>part</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.part class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.control_markdown_node.ControlSectionContent-functions>Functions<a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionContent.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize section content.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><span title=trestle.core.markdown.control_markdown_node.ControlSectionContent.__init__.part>part</span></code></td> <td> </td> <td> <div class=doc-md-description> <p>A part that is found in markdown. A part is defined in markdown by two or more # symbols</p> </div> </td> </tr> <tr class=doc-section-item> <td><code><span title=trestle.core.markdown.control_markdown_node.ControlSectionContent.__init__.by_id_name>by_id_name</span></code></td> <td> </td> <td> <div class=doc-md-description> <p>Required for parts defined as ## Part a in a markdown</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize section content.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        part: A part that is found in markdown. A part is defined in markdown by two or more # symbols</span>
+<span class=sd>        by_id_name: Required for parts defined as ## Part a in a markdown</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>(</span><span class=n>ControlSectionContent</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>part</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>by_id_name</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionContent.union class="doc doc-heading"> <code class="highlight language-python"><span class=n>union</span><span class=p>(</span><span class=n>node</span><span class=p>)</span></code> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionContent.union class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Unites contents together.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>union</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>node</span><span class=p>:</span> <span class=n>ControlMarkdownNode</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Unites contents together.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>node</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.control_markdown_node.ControlSectionType class="doc doc-heading"> <code>ControlSectionType</code> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>A type of the section in the markdown.</p> <p>Supported types: 1 - Control Statement 2 - Control Objective 3 - Control Guidance 4 - ## Part foo 5 - Control foo 6 - ### foo 7 - # Editable content</p> <p>Matching is case-insensitive.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlSectionType</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;A type of the section in the markdown.</span>
+
+<span class=sd>    Supported types:</span>
+<span class=sd>    1 - Control Statement</span>
+<span class=sd>    2 - Control Objective</span>
+<span class=sd>    3 - Control Guidance</span>
+<span class=sd>    4 - ## Part foo</span>
+<span class=sd>    5 - Control foo</span>
+<span class=sd>    6 - ### foo</span>
+<span class=sd>    7 - # Editable content</span>
+
+<span class=sd>    Matching is case-insensitive.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>STATEMENT</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=n>OBJECTIVE</span> <span class=o>=</span> <span class=mi>2</span>
+    <span class=n>GUIDANCE</span> <span class=o>=</span> <span class=mi>3</span>
+    <span class=n>EDITABLE_BY_ID_PART</span> <span class=o>=</span> <span class=mi>4</span>
+    <span class=n>GENERIC_CONTROL_PART</span> <span class=o>=</span> <span class=mi>5</span>
+    <span class=n>GENERIC_SUBPART</span> <span class=o>=</span> <span class=mi>6</span>
+    <span class=n>EDITABLE_CONTENT</span> <span class=o>=</span> <span class=mi>7</span>
+    <span class=n>UNDEFINED</span> <span class=o>=</span> <span class=mi>8</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.control_markdown_node.ControlSectionType-attributes>Attributes<a href=#trestle.core.markdown.control_markdown_node.ControlSectionType-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_BY_ID_PART class="doc doc-heading"> <code class="highlight language-python"><span class=n>EDITABLE_BY_ID_PART</span> <span class=o>=</span> <span class=mi>4</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_BY_ID_PART class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_CONTENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>EDITABLE_CONTENT</span> <span class=o>=</span> <span class=mi>7</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_CONTENT class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_CONTROL_PART class="doc doc-heading"> <code class="highlight language-python"><span class=n>GENERIC_CONTROL_PART</span> <span class=o>=</span> <span class=mi>5</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_CONTROL_PART class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_SUBPART class="doc doc-heading"> <code class="highlight language-python"><span class=n>GENERIC_SUBPART</span> <span class=o>=</span> <span class=mi>6</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_SUBPART class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionType.GUIDANCE class="doc doc-heading"> <code class="highlight language-python"><span class=n>GUIDANCE</span> <span class=o>=</span> <span class=mi>3</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.GUIDANCE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionType.OBJECTIVE class="doc doc-heading"> <code class="highlight language-python"><span class=n>OBJECTIVE</span> <span class=o>=</span> <span class=mi>2</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.OBJECTIVE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionType.STATEMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>STATEMENT</span> <span class=o>=</span> <span class=mi>1</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.STATEMENT class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.ControlSectionType.UNDEFINED class="doc doc-heading"> <code class="highlight language-python"><span class=n>UNDEFINED</span> <span class=o>=</span> <span class=mi>8</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.ControlSectionType.UNDEFINED class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.control_markdown_node.TreeContext class="doc doc-heading"> <code>TreeContext</code> <a href=#trestle.core.markdown.control_markdown_node.TreeContext class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>A shared singleton tree context.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TreeContext</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;A shared singleton tree context.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize tree context.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>control_group</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>control_title</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>part_label_to_id_map</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>reset</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Reset global control tree context.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>control_group</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>control_title</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>part_label_to_id_map</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.control_markdown_node.TreeContext-attributes>Attributes<a href=#trestle.core.markdown.control_markdown_node.TreeContext-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.TreeContext.control_group class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_group</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.control_group class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.TreeContext.control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_id</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.control_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.TreeContext.control_title class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_title</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.control_title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.TreeContext.part_label_to_id_map class="doc doc-heading"> <code class="highlight language-python"><span class=n>part_label_to_id_map</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.part_label_to_id_map class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.control_markdown_node.TreeContext.section_to_part_name_map class="doc doc-heading"> <code class="highlight language-python"><span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.section_to_part_name_map class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.control_markdown_node.TreeContext-functions>Functions<a href=#trestle.core.markdown.control_markdown_node.TreeContext-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.TreeContext.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize tree context.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize tree context.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>control_group</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>control_title</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>part_label_to_id_map</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.control_markdown_node.TreeContext.reset class="doc doc-heading"> <code class="highlight language-python"><span class=n>reset</span><span class=p>()</span></code> <a href=#trestle.core.markdown.control_markdown_node.TreeContext.reset class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Reset global control tree context.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/control_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>reset</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Reset global control tree context.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>control_id</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>control_group</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>control_title</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>part_label_to_id_map</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.markdown.control_markdown_node-functions>Functions<a href=#trestle.core.markdown.control_markdown_node-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/markdown/docs_markdown_node/index.html b/latest/reference/API/trestle/core/markdown/docs_markdown_node/index.html
new file mode 100644
index 000000000..7bd00ca6c
--- /dev/null
+++ b/latest/reference/API/trestle/core/markdown/docs_markdown_node/index.html
@@ -0,0 +1,261 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.markdown.docs_markdown_node module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/docs_markdown_node/ rel=canonical><link href=../control_markdown_node/ rel=prev><link href=../markdown_api/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.markdown.docs_markdown_node - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.markdown.docs_markdown_node - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.markdown.docs_markdown_node module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/docs_markdown_node.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/docs_markdown_node/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.markdown.docs_markdown_node - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.markdown.docs_markdown_node module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/docs_markdown_node.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.markdown.docs_markdown_node class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30 checked> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node class=md-nav__link> <span class=md-ellipsis> docs_markdown_node </span> </a> <nav class=md-nav aria-label=docs_markdown_node> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode class=md-nav__link> <span class=md-ellipsis> DocsMarkdownNode </span> </a> <nav class=md-nav aria-label=DocsMarkdownNode> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.content class=md-nav__link> <span class=md-ellipsis> content </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.build_tree_from_markdown class=md-nav__link> <span class=md-ellipsis> build_tree_from_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent class=md-nav__link> <span class=md-ellipsis> DocsSectionContent </span> </a> <nav class=md-nav aria-label=DocsSectionContent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.blockquotes class=md-nav__link> <span class=md-ellipsis> blockquotes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.code_lines class=md-nav__link> <span class=md-ellipsis> code_lines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.governed_document class=md-nav__link> <span class=md-ellipsis> governed_document </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.html_lines class=md-nav__link> <span class=md-ellipsis> html_lines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.tables class=md-nav__link> <span class=md-ellipsis> tables </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.text class=md-nav__link> <span class=md-ellipsis> text </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.union class=md-nav__link> <span class=md-ellipsis> union </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node class=md-nav__link> <span class=md-ellipsis> docs_markdown_node </span> </a> <nav class=md-nav aria-label=docs_markdown_node> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode class=md-nav__link> <span class=md-ellipsis> DocsMarkdownNode </span> </a> <nav class=md-nav aria-label=DocsMarkdownNode> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.content class=md-nav__link> <span class=md-ellipsis> content </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.build_tree_from_markdown class=md-nav__link> <span class=md-ellipsis> build_tree_from_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent class=md-nav__link> <span class=md-ellipsis> DocsSectionContent </span> </a> <nav class=md-nav aria-label=DocsSectionContent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.blockquotes class=md-nav__link> <span class=md-ellipsis> blockquotes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.code_lines class=md-nav__link> <span class=md-ellipsis> code_lines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.governed_document class=md-nav__link> <span class=md-ellipsis> governed_document </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.html_lines class=md-nav__link> <span class=md-ellipsis> html_lines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.tables class=md-nav__link> <span class=md-ellipsis> tables </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.text class=md-nav__link> <span class=md-ellipsis> text </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.union class=md-nav__link> <span class=md-ellipsis> union </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.markdown.docs_markdown_node</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.markdown.docs_markdown_node class="doc doc-heading"> <code>trestle.core.markdown.docs_markdown_node</code> <a href=#trestle.core.markdown.docs_markdown_node class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>A docs markdown node.</p> <div class="doc doc-children"> <h3 id=trestle.core.markdown.docs_markdown_node-attributes>Attributes<a href=#trestle.core.markdown.docs_markdown_node-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.docs_markdown_node.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.docs_markdown_node.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.markdown.docs_markdown_node-classes>Classes<a href=#trestle.core.markdown.docs_markdown_node-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.docs_markdown_node.DocsMarkdownNode class="doc doc-heading"> <code>DocsMarkdownNode</code> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.markdown.base_markdown_node.BaseMarkdownNode href=../base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode>BaseMarkdownNode</a></code></p> <p>Markdown will be read to the tree.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/docs_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DocsMarkdownNode</span><span class=p>(</span><span class=n>BaseMarkdownNode</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Markdown will be read to the tree.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>content</span><span class=p>:</span> <span class=n>DocsSectionContent</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>:</span> <span class=nb>int</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize markdown node.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>(</span><span class=n>DocsMarkdownNode</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>content</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=p>:</span> <span class=n>DocsSectionContent</span> <span class=o>=</span> <span class=n>content</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>build_tree_from_markdown</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>governed_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Construct a tree out of the given markdown.&quot;&quot;&quot;</span>
+        <span class=n>ob</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=fm>__new__</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span>
+        <span class=n>start_level</span> <span class=o>=</span> <span class=n>ob</span><span class=o>.</span><span class=n>_get_max_header_lvl</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+        <span class=n>ob</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ob</span><span class=o>.</span><span class=n>_build_tree</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=s1>&#39;root&#39;</span><span class=p>,</span> <span class=mi>0</span><span class=p>,</span> <span class=n>start_level</span><span class=p>,</span> <span class=n>governed_header</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>ob</span>
+
+    <span class=k>def</span> <span class=nf>_build_tree</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>root_key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>starting_line</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+        <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+        <span class=n>governed_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>DocsMarkdownNode</span><span class=p>,</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Build a tree from the markdown recursively.</span>
+
+<span class=sd>        The tree is contructed with valid headers as node&#39;s keys</span>
+<span class=sd>        and node&#39;s content contains everything that is under that header.</span>
+<span class=sd>        The subsections are placed into node&#39;s children with the same structure.</span>
+
+<span class=sd>        A header is valid iff the line starts with # and it is not:</span>
+<span class=sd>          1. Inside of the html blocks</span>
+<span class=sd>          2. Inside single lined in the &lt;&gt; tags</span>
+<span class=sd>          3. Inside the html comment</span>
+<span class=sd>          4. Inside any table, code block or blockquotes</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>content</span> <span class=o>=</span> <span class=n>DocsSectionContent</span><span class=p>()</span>
+        <span class=n>node_children</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>i</span> <span class=o>=</span> <span class=n>starting_line</span>
+
+        <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>i</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>lines</span><span class=p>):</span>
+                <span class=k>break</span>
+            <span class=n>line</span> <span class=o>=</span> <span class=n>lines</span><span class=p>[</span><span class=n>i</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>)</span>
+            <span class=n>header_lvl</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_header_level_if_valid</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>header_lvl</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>header_lvl</span> <span class=o>&gt;=</span> <span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>:</span>
+                    <span class=c1># build subtree</span>
+                    <span class=n>subtree</span><span class=p>,</span> <span class=n>i</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_tree</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=n>line</span><span class=p>,</span> <span class=n>i</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>level</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>governed_header</span><span class=p>)</span>
+                    <span class=n>node_children</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>subtree</span><span class=p>)</span>
+                    <span class=n>content</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>subtree</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>break</span>  <span class=c1># level of the header is above or equal to the current level, subtree is over</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_start_with</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>CODEBLOCK_DEF</span><span class=p>):</span>
+                <span class=n>code_lines</span><span class=p>,</span> <span class=n>i</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_code_lines</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=n>line</span><span class=p>,</span> <span class=n>i</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)</span>
+                <span class=n>content</span><span class=o>.</span><span class=n>code_lines</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>code_lines</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_start_with</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>HTML_COMMENT_START</span><span class=p>):</span>
+                <span class=n>html_lines</span><span class=p>,</span> <span class=n>i</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_html_block</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=n>line</span><span class=p>,</span> <span class=n>i</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>HTML_COMMENT_END_REGEX</span><span class=p>)</span>
+                <span class=n>content</span><span class=o>.</span><span class=n>html_lines</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>html_lines</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>HTML_TAG_REGEX_START</span><span class=p>):</span>
+                <span class=n>html_lines</span><span class=p>,</span> <span class=n>i</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_html_block</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=n>line</span><span class=p>,</span> <span class=n>i</span> <span class=o>+</span> <span class=mi>1</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>HTML_TAG_REGEX_END</span><span class=p>)</span>
+                <span class=n>content</span><span class=o>.</span><span class=n>html_lines</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>html_lines</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_start_with</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>TABLE_SYMBOL</span><span class=p>):</span>
+                <span class=n>table_block</span><span class=p>,</span> <span class=n>i</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_table_block</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=n>line</span><span class=p>,</span> <span class=n>i</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)</span>
+                <span class=n>content</span><span class=o>.</span><span class=n>tables</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>table_block</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_start_with</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>BLOCKQUOTE_CHAR</span><span class=p>):</span>
+                <span class=n>content</span><span class=o>.</span><span class=n>blockquotes</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+                <span class=n>i</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=k>elif</span> <span class=n>governed_header</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span>
+                    <span class=n>root_key</span><span class=p>,</span> <span class=sa>fr</span><span class=s1>&#39;^[#]+ </span><span class=si>{</span><span class=n>governed_header</span><span class=si>}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_does_contain</span><span class=p>(</span><span class=n>line</span><span class=p>,</span> <span class=n>md_const</span><span class=o>.</span><span class=n>GOVERNED_DOC_REGEX</span><span class=p>):</span>
+                <span class=n>regexp</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>md_const</span><span class=o>.</span><span class=n>GOVERNED_DOC_REGEX</span><span class=p>)</span>
+                <span class=n>match</span> <span class=o>=</span> <span class=n>regexp</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+                <span class=n>header</span> <span class=o>=</span> <span class=n>match</span><span class=o>.</span><span class=n>group</span><span class=p>(</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39;*&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39;:&#39;</span><span class=p>)</span>
+                <span class=n>content</span><span class=o>.</span><span class=n>governed_document</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>header</span><span class=p>)</span>
+                <span class=n>i</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>content</span><span class=o>.</span><span class=n>text</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+                <span class=n>i</span> <span class=o>+=</span> <span class=mi>1</span>
+
+        <span class=n>first_line_to_grab</span> <span class=o>=</span> <span class=n>starting_line</span> <span class=o>-</span> <span class=mi>1</span> <span class=k>if</span> <span class=n>starting_line</span> <span class=k>else</span> <span class=mi>0</span>
+        <span class=n>content</span><span class=o>.</span><span class=n>raw_text</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>lines</span><span class=p>[</span><span class=n>first_line_to_grab</span><span class=p>:</span><span class=n>i</span><span class=p>])</span>
+        <span class=n>md_node</span> <span class=o>=</span> <span class=n>DocsMarkdownNode</span><span class=p>(</span><span class=n>key</span><span class=o>=</span><span class=n>root_key</span><span class=p>,</span> <span class=n>content</span><span class=o>=</span><span class=n>content</span><span class=p>,</span> <span class=n>starting_line</span><span class=o>=</span><span class=n>first_line_to_grab</span><span class=p>)</span>
+        <span class=n>md_node</span><span class=o>.</span><span class=n>subnodes</span> <span class=o>=</span> <span class=n>node_children</span>
+        <span class=k>return</span> <span class=n>md_node</span><span class=p>,</span> <span class=n>i</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-attributes>Attributes<a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.content class="doc doc-heading"> <code class="highlight language-python"><span class=n>content</span><span class=p>:</span> <span class=n>DocsSectionContent</span> <span class=o>=</span> <span class=n>content</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.content class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-functions>Functions<a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>content</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>)</span></code> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize markdown node.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/docs_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>content</span><span class=p>:</span> <span class=n>DocsSectionContent</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>:</span> <span class=nb>int</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize markdown node.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>(</span><span class=n>DocsMarkdownNode</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>key</span><span class=p>,</span> <span class=n>content</span><span class=p>,</span> <span class=n>starting_line</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>content</span><span class=p>:</span> <span class=n>DocsSectionContent</span> <span class=o>=</span> <span class=n>content</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.build_tree_from_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=n>governed_header</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.build_tree_from_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Construct a tree out of the given markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/docs_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>build_tree_from_markdown</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>governed_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Construct a tree out of the given markdown.&quot;&quot;&quot;</span>
+    <span class=n>ob</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=fm>__new__</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span>
+    <span class=n>start_level</span> <span class=o>=</span> <span class=n>ob</span><span class=o>.</span><span class=n>_get_max_header_lvl</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+    <span class=n>ob</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ob</span><span class=o>.</span><span class=n>_build_tree</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=s1>&#39;root&#39;</span><span class=p>,</span> <span class=mi>0</span><span class=p>,</span> <span class=n>start_level</span><span class=p>,</span> <span class=n>governed_header</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>ob</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent class="doc doc-heading"> <code>DocsSectionContent</code> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.markdown.base_markdown_node.BaseSectionContent href=../base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseSectionContent>BaseSectionContent</a></code></p> <p>A content of the node.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/docs_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DocsSectionContent</span><span class=p>(</span><span class=n>BaseSectionContent</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;A content of the node.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize section content.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>(</span><span class=n>DocsSectionContent</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>tables</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>text</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>code_lines</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>html_lines</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>blockquotes</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>governed_document</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=k>def</span> <span class=nf>union</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>node</span><span class=p>:</span> <span class=n>DocsMarkdownNode</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Unites contents together.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>node</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>code_lines</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>code_lines</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>html_lines</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>html_lines</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>tables</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>tables</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>blockquotes</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>blockquotes</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent-attributes>Attributes<a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent.blockquotes class="doc doc-heading"> <code class="highlight language-python"><span class=n>blockquotes</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.blockquotes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent.code_lines class="doc doc-heading"> <code class="highlight language-python"><span class=n>code_lines</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.code_lines class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent.governed_document class="doc doc-heading"> <code class="highlight language-python"><span class=n>governed_document</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.governed_document class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent.html_lines class="doc doc-heading"> <code class="highlight language-python"><span class=n>html_lines</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.html_lines class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent.tables class="doc doc-heading"> <code class="highlight language-python"><span class=n>tables</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.tables class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent.text class="doc doc-heading"> <code class="highlight language-python"><span class=n>text</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.text class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent-functions>Functions<a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize section content.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/docs_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize section content.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>(</span><span class=n>DocsSectionContent</span><span class=p>,</span> <span class=bp>self</span><span class=p>)</span><span class=o>.</span><span class=fm>__init__</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>tables</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>text</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>code_lines</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>html_lines</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>blockquotes</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>governed_document</span> <span class=o>=</span> <span class=p>[]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.docs_markdown_node.DocsSectionContent.union class="doc doc-heading"> <code class="highlight language-python"><span class=n>union</span><span class=p>(</span><span class=n>node</span><span class=p>)</span></code> <a href=#trestle.core.markdown.docs_markdown_node.DocsSectionContent.union class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Unites contents together.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/docs_markdown_node.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>union</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>node</span><span class=p>:</span> <span class=n>DocsMarkdownNode</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Unites contents together.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>union</span><span class=p>(</span><span class=n>node</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>code_lines</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>code_lines</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>html_lines</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>html_lines</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>tables</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>tables</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>blockquotes</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>blockquotes</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/markdown/markdown_api/index.html b/latest/reference/API/trestle/core/markdown/markdown_api/index.html
new file mode 100644
index 000000000..c05caabbd
--- /dev/null
+++ b/latest/reference/API/trestle/core/markdown/markdown_api/index.html
@@ -0,0 +1,216 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.markdown.markdown_api module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_api/ rel=canonical><link href=../docs_markdown_node/ rel=prev><link href=../markdown_const/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.markdown.markdown_api - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.markdown.markdown_api - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.markdown.markdown_api module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_api.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_api/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.markdown.markdown_api - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.markdown.markdown_api module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_api.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.markdown.markdown_api class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30 checked> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api class=md-nav__link> <span class=md-ellipsis> markdown_api </span> </a> <nav class=md-nav aria-label=markdown_api> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI class=md-nav__link> <span class=md-ellipsis> MarkdownAPI </span> </a> <nav class=md-nav aria-label=MarkdownAPI> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.processor class=md-nav__link> <span class=md-ellipsis> processor </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.validator class=md-nav__link> <span class=md-ellipsis> validator </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.load_validator_with_template class=md-nav__link> <span class=md-ellipsis> load_validator_with_template </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.validate_instance class=md-nav__link> <span class=md-ellipsis> validate_instance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.write_markdown_with_header class=md-nav__link> <span class=md-ellipsis> write_markdown_with_header </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api class=md-nav__link> <span class=md-ellipsis> markdown_api </span> </a> <nav class=md-nav aria-label=markdown_api> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI class=md-nav__link> <span class=md-ellipsis> MarkdownAPI </span> </a> <nav class=md-nav aria-label=MarkdownAPI> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.processor class=md-nav__link> <span class=md-ellipsis> processor </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.validator class=md-nav__link> <span class=md-ellipsis> validator </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.load_validator_with_template class=md-nav__link> <span class=md-ellipsis> load_validator_with_template </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.validate_instance class=md-nav__link> <span class=md-ellipsis> validate_instance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.write_markdown_with_header class=md-nav__link> <span class=md-ellipsis> write_markdown_with_header </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.markdown.markdown_api</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.markdown.markdown_api class="doc doc-heading"> <code>trestle.core.markdown.markdown_api</code> <a href=#trestle.core.markdown.markdown_api class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>A markdown API.</p> <div class="doc doc-children"> <h3 id=trestle.core.markdown.markdown_api-attributes>Attributes<a href=#trestle.core.markdown.markdown_api-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_api.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_api.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.markdown.markdown_api-classes>Classes<a href=#trestle.core.markdown.markdown_api-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.markdown_api.MarkdownAPI class="doc doc-heading"> <code>MarkdownAPI</code> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>A common API that wraps around the existing markdown functionality.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>MarkdownAPI</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;A common API that wraps around the existing markdown functionality.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize markdown API.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>processor</span> <span class=o>=</span> <span class=n>MarkdownProcessor</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>validator</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>load_validator_with_template</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>md_template_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>validate_yaml_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>validate_md_body</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>governed_section</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>validate_template</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Load and initialize markdown validator.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>governed_header</span> <span class=o>=</span> <span class=n>governed_section</span>
+            <span class=k>if</span> <span class=n>validate_template</span><span class=p>:</span>
+                <span class=n>template_header</span><span class=p>,</span> <span class=n>template_tree</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>md_template_path</span><span class=p>,</span> <span class=n>validate_yaml_header</span><span class=p>,</span>
+                                                                                 <span class=n>validate_md_body</span> <span class=ow>or</span> <span class=n>governed_section</span> <span class=ow>is</span>
+                                                                                 <span class=ow>not</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>template_header</span><span class=p>,</span> <span class=n>template_tree</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>md_template_path</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>template_header</span> <span class=ow>and</span> <span class=n>validate_yaml_header</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Expected yaml header for markdown template where none exists </span><span class=si>{</span><span class=n>md_template_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>validator</span> <span class=o>=</span> <span class=n>MarkdownValidator</span><span class=p>(</span>
+                <span class=n>md_template_path</span><span class=p>,</span>
+                <span class=n>template_header</span><span class=p>,</span>
+                <span class=n>template_tree</span><span class=p>,</span>
+                <span class=n>validate_yaml_header</span><span class=p>,</span>
+                <span class=n>validate_md_body</span><span class=p>,</span>
+                <span class=n>governed_section</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while loading markdown template </span><span class=si>{</span><span class=n>md_template_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>validate_instance</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_instance_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Validate a given markdown instance against a template.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>validator</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Markdown validator is not initialized, load template first.&#39;</span><span class=p>)</span>
+        <span class=n>instance_header</span><span class=p>,</span> <span class=n>instance_tree</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>md_instance_path</span><span class=p>)</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>validator</span><span class=o>.</span><span class=n>is_valid_against_template</span><span class=p>(</span><span class=n>md_instance_path</span><span class=p>,</span> <span class=n>instance_header</span><span class=p>,</span> <span class=n>instance_tree</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>write_markdown_with_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>md_body</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write markdown with the YAML header.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=c1># use encoding to handle character sets as well as possible</span>
+            <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=n>path</span><span class=p>,</span> <span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>,</span> <span class=n>errors</span><span class=o>=</span><span class=s1>&#39;replace&#39;</span><span class=p>)</span> <span class=k>as</span> <span class=n>md_file</span><span class=p>:</span>
+                <span class=n>md_file</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;---</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>yaml</span><span class=o>.</span><span class=n>safe_dump</span><span class=p>(</span><span class=n>header</span><span class=p>,</span> <span class=n>md_file</span><span class=p>,</span> <span class=n>sort_keys</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+                <span class=n>md_file</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;---</span><span class=se>\n\n</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>md_file</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>md_body</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>IOError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while writing markdown file: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.markdown_api.MarkdownAPI-attributes>Attributes<a href=#trestle.core.markdown.markdown_api.MarkdownAPI-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.markdown_api.MarkdownAPI.processor class="doc doc-heading"> <code class="highlight language-python"><span class=n>processor</span> <span class=o>=</span> <span class=n>MarkdownProcessor</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.processor class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.markdown_api.MarkdownAPI.validator class="doc doc-heading"> <code class="highlight language-python"><span class=n>validator</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.validator class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.markdown_api.MarkdownAPI-functions>Functions<a href=#trestle.core.markdown.markdown_api.MarkdownAPI-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_api.MarkdownAPI.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize markdown API.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize markdown API.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>processor</span> <span class=o>=</span> <span class=n>MarkdownProcessor</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>validator</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_api.MarkdownAPI.load_validator_with_template class="doc doc-heading"> <code class="highlight language-python"><span class=n>load_validator_with_template</span><span class=p>(</span><span class=n>md_template_path</span><span class=p>,</span> <span class=n>validate_yaml_header</span><span class=p>,</span> <span class=n>validate_md_body</span><span class=p>,</span> <span class=n>governed_section</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>validate_template</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.load_validator_with_template class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Load and initialize markdown validator.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>load_validator_with_template</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>md_template_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>validate_yaml_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>validate_md_body</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>governed_section</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>validate_template</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Load and initialize markdown validator.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>governed_header</span> <span class=o>=</span> <span class=n>governed_section</span>
+        <span class=k>if</span> <span class=n>validate_template</span><span class=p>:</span>
+            <span class=n>template_header</span><span class=p>,</span> <span class=n>template_tree</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>md_template_path</span><span class=p>,</span> <span class=n>validate_yaml_header</span><span class=p>,</span>
+                                                                             <span class=n>validate_md_body</span> <span class=ow>or</span> <span class=n>governed_section</span> <span class=ow>is</span>
+                                                                             <span class=ow>not</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>template_header</span><span class=p>,</span> <span class=n>template_tree</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>md_template_path</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>template_header</span> <span class=ow>and</span> <span class=n>validate_yaml_header</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Expected yaml header for markdown template where none exists </span><span class=si>{</span><span class=n>md_template_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>validator</span> <span class=o>=</span> <span class=n>MarkdownValidator</span><span class=p>(</span>
+            <span class=n>md_template_path</span><span class=p>,</span>
+            <span class=n>template_header</span><span class=p>,</span>
+            <span class=n>template_tree</span><span class=p>,</span>
+            <span class=n>validate_yaml_header</span><span class=p>,</span>
+            <span class=n>validate_md_body</span><span class=p>,</span>
+            <span class=n>governed_section</span>
+        <span class=p>)</span>
+    <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while loading markdown template </span><span class=si>{</span><span class=n>md_template_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_api.MarkdownAPI.validate_instance class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate_instance</span><span class=p>(</span><span class=n>md_instance_path</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.validate_instance class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate a given markdown instance against a template.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>validate_instance</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_instance_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validate a given markdown instance against a template.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>validator</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Markdown validator is not initialized, load template first.&#39;</span><span class=p>)</span>
+    <span class=n>instance_header</span><span class=p>,</span> <span class=n>instance_tree</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>md_instance_path</span><span class=p>)</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>validator</span><span class=o>.</span><span class=n>is_valid_against_template</span><span class=p>(</span><span class=n>md_instance_path</span><span class=p>,</span> <span class=n>instance_header</span><span class=p>,</span> <span class=n>instance_tree</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_api.MarkdownAPI.write_markdown_with_header class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_markdown_with_header</span><span class=p>(</span><span class=n>path</span><span class=p>,</span> <span class=n>header</span><span class=p>,</span> <span class=n>md_body</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_api.MarkdownAPI.write_markdown_with_header class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write markdown with the YAML header.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_api.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_markdown_with_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>md_body</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write markdown with the YAML header.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=c1># use encoding to handle character sets as well as possible</span>
+        <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=n>path</span><span class=p>,</span> <span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>,</span> <span class=n>errors</span><span class=o>=</span><span class=s1>&#39;replace&#39;</span><span class=p>)</span> <span class=k>as</span> <span class=n>md_file</span><span class=p>:</span>
+            <span class=n>md_file</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;---</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>yaml</span><span class=o>.</span><span class=n>safe_dump</span><span class=p>(</span><span class=n>header</span><span class=p>,</span> <span class=n>md_file</span><span class=p>,</span> <span class=n>sort_keys</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+            <span class=n>md_file</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;---</span><span class=se>\n\n</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>md_file</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>md_body</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>IOError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while writing markdown file: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/markdown/markdown_const/index.html b/latest/reference/API/trestle/core/markdown/markdown_const/index.html
new file mode 100644
index 000000000..631263e2d
--- /dev/null
+++ b/latest/reference/API/trestle/core/markdown/markdown_const/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.markdown.markdown_const module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_const/ rel=canonical><link href=../markdown_api/ rel=prev><link href=../markdown_processor/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.markdown.markdown_const - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.markdown.markdown_const - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.markdown.markdown_const module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_const.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_const/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.markdown.markdown_const - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.markdown.markdown_const module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_const.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.markdown.markdown_const class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30 checked> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const class=md-nav__link> <span class=md-ellipsis> markdown_const </span> </a> <nav class=md-nav aria-label=markdown_const> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.BLOCKQUOTE_CHAR class=md-nav__link> <span class=md-ellipsis> BLOCKQUOTE_CHAR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.CODEBLOCK_DEF class=md-nav__link> <span class=md-ellipsis> CODEBLOCK_DEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.GOVERNED_DOC_REGEX class=md-nav__link> <span class=md-ellipsis> GOVERNED_DOC_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HEADER_REGEX class=md-nav__link> <span class=md-ellipsis> HEADER_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HTML_COMMENT_END_REGEX class=md-nav__link> <span class=md-ellipsis> HTML_COMMENT_END_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HTML_COMMENT_START class=md-nav__link> <span class=md-ellipsis> HTML_COMMENT_START </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HTML_TAG_REGEX_END class=md-nav__link> <span class=md-ellipsis> HTML_TAG_REGEX_END </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HTML_TAG_REGEX_START class=md-nav__link> <span class=md-ellipsis> HTML_TAG_REGEX_START </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.INLINE_CODE_CHAR class=md-nav__link> <span class=md-ellipsis> INLINE_CODE_CHAR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.JINJA_DATESTAMP_FORMAT class=md-nav__link> <span class=md-ellipsis> JINJA_DATESTAMP_FORMAT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.LIST_CHAR class=md-nav__link> <span class=md-ellipsis> LIST_CHAR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.SUBSTITUTION_REGEX class=md-nav__link> <span class=md-ellipsis> SUBSTITUTION_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.TABLE_REGEX class=md-nav__link> <span class=md-ellipsis> TABLE_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.TABLE_SYMBOL class=md-nav__link> <span class=md-ellipsis> TABLE_SYMBOL </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const class=md-nav__link> <span class=md-ellipsis> markdown_const </span> </a> <nav class=md-nav aria-label=markdown_const> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.BLOCKQUOTE_CHAR class=md-nav__link> <span class=md-ellipsis> BLOCKQUOTE_CHAR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.CODEBLOCK_DEF class=md-nav__link> <span class=md-ellipsis> CODEBLOCK_DEF </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.GOVERNED_DOC_REGEX class=md-nav__link> <span class=md-ellipsis> GOVERNED_DOC_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HEADER_REGEX class=md-nav__link> <span class=md-ellipsis> HEADER_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HTML_COMMENT_END_REGEX class=md-nav__link> <span class=md-ellipsis> HTML_COMMENT_END_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HTML_COMMENT_START class=md-nav__link> <span class=md-ellipsis> HTML_COMMENT_START </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HTML_TAG_REGEX_END class=md-nav__link> <span class=md-ellipsis> HTML_TAG_REGEX_END </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.HTML_TAG_REGEX_START class=md-nav__link> <span class=md-ellipsis> HTML_TAG_REGEX_START </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.INLINE_CODE_CHAR class=md-nav__link> <span class=md-ellipsis> INLINE_CODE_CHAR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.JINJA_DATESTAMP_FORMAT class=md-nav__link> <span class=md-ellipsis> JINJA_DATESTAMP_FORMAT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.LIST_CHAR class=md-nav__link> <span class=md-ellipsis> LIST_CHAR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.SUBSTITUTION_REGEX class=md-nav__link> <span class=md-ellipsis> SUBSTITUTION_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.TABLE_REGEX class=md-nav__link> <span class=md-ellipsis> TABLE_REGEX </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_const.TABLE_SYMBOL class=md-nav__link> <span class=md-ellipsis> TABLE_SYMBOL </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.markdown.markdown_const</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.markdown.markdown_const class="doc doc-heading"> <code>trestle.core.markdown.markdown_const</code> <a href=#trestle.core.markdown.markdown_const class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Markdown specific constants.</p> <div class="doc doc-children"> <h3 id=trestle.core.markdown.markdown_const-attributes>Attributes<a href=#trestle.core.markdown.markdown_const-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.BLOCKQUOTE_CHAR class="doc doc-heading"> <code class="highlight language-python"><span class=n>BLOCKQUOTE_CHAR</span> <span class=o>=</span> <span class=s1>&#39;&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.BLOCKQUOTE_CHAR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.CODEBLOCK_DEF class="doc doc-heading"> <code class="highlight language-python"><span class=n>CODEBLOCK_DEF</span> <span class=o>=</span> <span class=s1>&#39;```&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.CODEBLOCK_DEF class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.GOVERNED_DOC_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>GOVERNED_DOC_REGEX</span> <span class=o>=</span> <span class=s1>&#39;.*:&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.GOVERNED_DOC_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.HEADER_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>HEADER_REGEX</span> <span class=o>=</span> <span class=s1>&#39;^[#]+&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.HEADER_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.HTML_COMMENT_END_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>HTML_COMMENT_END_REGEX</span> <span class=o>=</span> <span class=s1>&#39;.*--&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.HTML_COMMENT_END_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.HTML_COMMENT_START class="doc doc-heading"> <code class="highlight language-python"><span class=n>HTML_COMMENT_START</span> <span class=o>=</span> <span class=s1>&#39;&lt;!--&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.HTML_COMMENT_START class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.HTML_TAG_REGEX_END class="doc doc-heading"> <code class="highlight language-python"><span class=n>HTML_TAG_REGEX_END</span> <span class=o>=</span> <span class=s1>&#39;&lt;</span><span class=se>\\</span><span class=s1>/.*&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.HTML_TAG_REGEX_END class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.HTML_TAG_REGEX_START class="doc doc-heading"> <code class="highlight language-python"><span class=n>HTML_TAG_REGEX_START</span> <span class=o>=</span> <span class=s1>&#39;^[ </span><span class=se>\\</span><span class=s1>t]*&lt;.*&gt;&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.HTML_TAG_REGEX_START class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.INLINE_CODE_CHAR class="doc doc-heading"> <code class="highlight language-python"><span class=n>INLINE_CODE_CHAR</span> <span class=o>=</span> <span class=s1>&#39;^`&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.INLINE_CODE_CHAR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.JINJA_DATESTAMP_FORMAT class="doc doc-heading"> <code class="highlight language-python"><span class=n>JINJA_DATESTAMP_FORMAT</span> <span class=o>=</span> <span class=s1>&#39;%Y-%m-</span><span class=si>%d</span><span class=s1>&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.JINJA_DATESTAMP_FORMAT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.LIST_CHAR class="doc doc-heading"> <code class="highlight language-python"><span class=n>LIST_CHAR</span> <span class=o>=</span> <span class=s1>&#39;-&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.LIST_CHAR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.SUBSTITUTION_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>SUBSTITUTION_REGEX</span> <span class=o>=</span> <span class=s1>&#39;{(.*?)}&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.SUBSTITUTION_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.TABLE_REGEX class="doc doc-heading"> <code class="highlight language-python"><span class=n>TABLE_REGEX</span> <span class=o>=</span> <span class=s1>&#39;|&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.TABLE_REGEX class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_const.TABLE_SYMBOL class="doc doc-heading"> <code class="highlight language-python"><span class=n>TABLE_SYMBOL</span> <span class=o>=</span> <span class=s1>&#39;|&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_const.TABLE_SYMBOL class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/markdown/markdown_processor/index.html b/latest/reference/API/trestle/core/markdown/markdown_processor/index.html
new file mode 100644
index 000000000..3b040fee9
--- /dev/null
+++ b/latest/reference/API/trestle/core/markdown/markdown_processor/index.html
@@ -0,0 +1,342 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.markdown.markdown_processor module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_processor/ rel=canonical><link href=../markdown_const/ rel=prev><link href=../markdown_validator/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.markdown.markdown_processor - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.markdown.markdown_processor - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.markdown.markdown_processor module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_processor.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_processor/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.markdown.markdown_processor - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.markdown.markdown_processor module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_processor.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.markdown.markdown_processor class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30 checked> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor class=md-nav__link> <span class=md-ellipsis> markdown_processor </span> </a> <nav class=md-nav aria-label=markdown_processor> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor class=md-nav__link> <span class=md-ellipsis> MarkdownProcessor </span> </a> <nav class=md-nav aria-label=MarkdownProcessor> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.governed_header class=md-nav__link> <span class=md-ellipsis> governed_header </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.fetch_value_from_header class=md-nav__link> <span class=md-ellipsis> fetch_value_from_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.process_control_markdown class=md-nav__link> <span class=md-ellipsis> process_control_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.process_markdown class=md-nav__link> <span class=md-ellipsis> process_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.read_markdown_wo_processing class=md-nav__link> <span class=md-ellipsis> read_markdown_wo_processing </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.render_gfm_to_html class=md-nav__link> <span class=md-ellipsis> render_gfm_to_html </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor class=md-nav__link> <span class=md-ellipsis> markdown_processor </span> </a> <nav class=md-nav aria-label=markdown_processor> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor class=md-nav__link> <span class=md-ellipsis> MarkdownProcessor </span> </a> <nav class=md-nav aria-label=MarkdownProcessor> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.governed_header class=md-nav__link> <span class=md-ellipsis> governed_header </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.fetch_value_from_header class=md-nav__link> <span class=md-ellipsis> fetch_value_from_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.process_control_markdown class=md-nav__link> <span class=md-ellipsis> process_control_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.process_markdown class=md-nav__link> <span class=md-ellipsis> process_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.read_markdown_wo_processing class=md-nav__link> <span class=md-ellipsis> read_markdown_wo_processing </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.render_gfm_to_html class=md-nav__link> <span class=md-ellipsis> render_gfm_to_html </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_processor-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.markdown.markdown_processor</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.markdown.markdown_processor class="doc doc-heading"> <code>trestle.core.markdown.markdown_processor</code> <a href=#trestle.core.markdown.markdown_processor class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>A markdown processor.</p> <div class="doc doc-children"> <h3 id=trestle.core.markdown.markdown_processor-attributes>Attributes<a href=#trestle.core.markdown.markdown_processor-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_processor.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_processor.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.markdown.markdown_processor-classes>Classes<a href=#trestle.core.markdown.markdown_processor-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.markdown_processor.MarkdownProcessor class="doc doc-heading"> <code>MarkdownProcessor</code> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>A markdown processor.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_processor.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>MarkdownProcessor</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;A markdown processor.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize markdown processor.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>governed_header</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>render_gfm_to_html</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>markdown_text</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Render given Github Flavored Markdown to HTML.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>html</span> <span class=o>=</span> <span class=n>cmarkgfm</span><span class=o>.</span><span class=n>github_flavored_markdown_to_html</span><span class=p>(</span><span class=n>markdown_text</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>html</span>
+        <span class=k>except</span> <span class=ne>ValueError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Not a valid Github Flavored markdown: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>process_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                         <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+                         <span class=n>read_header</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+                         <span class=n>read_body</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>,</span> <span class=n>DocsMarkdownNode</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Parse the markdown and builds the tree to operate over it.&quot;&quot;&quot;</span>
+        <span class=n>header</span><span class=p>,</span> <span class=n>markdown_wo_header</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>read_header</span><span class=p>,</span> <span class=n>read_body</span><span class=p>)</span>
+
+        <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>render_gfm_to_html</span><span class=p>(</span><span class=n>markdown_wo_header</span><span class=p>)</span>
+
+        <span class=n>lines</span> <span class=o>=</span> <span class=n>markdown_wo_header</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>tree</span> <span class=o>=</span> <span class=n>DocsMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>governed_header</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>header</span><span class=p>,</span> <span class=n>tree</span>
+
+    <span class=k>def</span> <span class=nf>process_control_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>cli_section_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>part_label_to_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>,</span> <span class=n>ControlMarkdownNode</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Parse control markdown and build tree with identified OSCAL components.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>header</span><span class=p>,</span> <span class=n>markdown_wo_header</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>read_header</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>read_body</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+            <span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=k>if</span> <span class=n>cli_section_dict</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=c1># Read x-trestle-sections to the dictionary and merge it with CLI provided dictionary</span>
+                <span class=n>yaml_header_sections_dict</span> <span class=o>=</span> <span class=n>header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SECTIONS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+                <span class=n>merged_dict</span> <span class=o>=</span> <span class=n>merge_dicts</span><span class=p>(</span><span class=n>yaml_header_sections_dict</span><span class=p>,</span> <span class=n>cli_section_dict</span><span class=p>)</span>
+                <span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=p>{</span><span class=n>v</span><span class=p>:</span> <span class=n>k</span> <span class=k>for</span> <span class=n>k</span><span class=p>,</span> <span class=n>v</span> <span class=ow>in</span> <span class=n>merged_dict</span><span class=o>.</span><span class=n>items</span><span class=p>()}</span>
+            <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>render_gfm_to_html</span><span class=p>(</span><span class=n>markdown_wo_header</span><span class=p>)</span>
+
+            <span class=n>lines</span> <span class=o>=</span> <span class=n>markdown_wo_header</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>tree_context</span><span class=o>.</span><span class=n>reset</span><span class=p>()</span>
+            <span class=n>tree_context</span><span class=o>.</span><span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=n>section_to_part_name_map</span>
+            <span class=n>tree_context</span><span class=o>.</span><span class=n>part_label_to_id_map</span> <span class=o>=</span> <span class=n>part_label_to_id_map</span>
+            <span class=n>tree</span> <span class=o>=</span> <span class=n>ControlMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+            <span class=n>tree_context</span><span class=o>.</span><span class=n>reset</span><span class=p>()</span>
+            <span class=k>return</span> <span class=n>header</span><span class=p>,</span> <span class=n>tree</span>
+        <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while reading control markdown: </span><span class=si>{</span><span class=n>md_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>e</span>
+
+    <span class=k>def</span> <span class=nf>read_markdown_wo_processing</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                                    <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+                                    <span class=n>read_header</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+                                    <span class=n>read_body</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read markdown header to dictionary and body to string.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>contents</span> <span class=o>=</span> <span class=n>frontmatter</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>md_path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span><span class=o>.</span><span class=n>read</span><span class=p>())</span>
+            <span class=n>header</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=n>markdown_wo_header</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=k>if</span> <span class=n>read_header</span><span class=p>:</span>
+                <span class=n>header</span> <span class=o>=</span> <span class=n>contents</span><span class=o>.</span><span class=n>metadata</span>
+            <span class=k>if</span> <span class=n>read_body</span><span class=p>:</span>
+                <span class=n>markdown_wo_header</span> <span class=o>=</span> <span class=n>contents</span><span class=o>.</span><span class=n>content</span>
+
+            <span class=k>return</span> <span class=n>header</span><span class=p>,</span> <span class=n>markdown_wo_header</span>
+        <span class=k>except</span> <span class=ne>UnicodeDecodeError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown cannot be decoded into </span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=si>}</span><span class=s1>, error: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=n>ScannerError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Header is not in a valid YAML format: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>FileNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown with path </span><span class=si>{</span><span class=n>md_path</span><span class=si>}</span><span class=s1>, not found: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>fetch_value_from_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Fetch value for the given key from the markdown header if exists.&quot;&quot;&quot;</span>
+        <span class=n>header</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=kc>None</span>
+
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>header</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=n>header</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+
+        <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.markdown_processor.MarkdownProcessor-attributes>Attributes<a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.markdown_processor.MarkdownProcessor.governed_header class="doc doc-heading"> <code class="highlight language-python"><span class=n>governed_header</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.governed_header class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.markdown_processor.MarkdownProcessor-functions>Functions<a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_processor.MarkdownProcessor.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize markdown processor.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_processor.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize markdown processor.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>governed_header</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_processor.MarkdownProcessor.fetch_value_from_header class="doc doc-heading"> <code class="highlight language-python"><span class=n>fetch_value_from_header</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>key</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.fetch_value_from_header class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Fetch value for the given key from the markdown header if exists.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_processor.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>fetch_value_from_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Fetch value for the given key from the markdown header if exists.&quot;&quot;&quot;</span>
+    <span class=n>header</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>md_path</span><span class=p>)</span>
+    <span class=n>value</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>header</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=n>header</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+
+    <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_processor.MarkdownProcessor.process_control_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>process_control_markdown</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>cli_section_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>part_label_to_id_map</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.process_control_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Parse control markdown and build tree with identified OSCAL components.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_processor.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>process_control_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>cli_section_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>part_label_to_id_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>,</span> <span class=n>ControlMarkdownNode</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Parse control markdown and build tree with identified OSCAL components.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>header</span><span class=p>,</span> <span class=n>markdown_wo_header</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>read_header</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>read_body</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+
+        <span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>if</span> <span class=n>cli_section_dict</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=c1># Read x-trestle-sections to the dictionary and merge it with CLI provided dictionary</span>
+            <span class=n>yaml_header_sections_dict</span> <span class=o>=</span> <span class=n>header</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SECTIONS_TAG</span><span class=p>,</span> <span class=p>{})</span>
+            <span class=n>merged_dict</span> <span class=o>=</span> <span class=n>merge_dicts</span><span class=p>(</span><span class=n>yaml_header_sections_dict</span><span class=p>,</span> <span class=n>cli_section_dict</span><span class=p>)</span>
+            <span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=p>{</span><span class=n>v</span><span class=p>:</span> <span class=n>k</span> <span class=k>for</span> <span class=n>k</span><span class=p>,</span> <span class=n>v</span> <span class=ow>in</span> <span class=n>merged_dict</span><span class=o>.</span><span class=n>items</span><span class=p>()}</span>
+        <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>render_gfm_to_html</span><span class=p>(</span><span class=n>markdown_wo_header</span><span class=p>)</span>
+
+        <span class=n>lines</span> <span class=o>=</span> <span class=n>markdown_wo_header</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>tree_context</span><span class=o>.</span><span class=n>reset</span><span class=p>()</span>
+        <span class=n>tree_context</span><span class=o>.</span><span class=n>section_to_part_name_map</span> <span class=o>=</span> <span class=n>section_to_part_name_map</span>
+        <span class=n>tree_context</span><span class=o>.</span><span class=n>part_label_to_id_map</span> <span class=o>=</span> <span class=n>part_label_to_id_map</span>
+        <span class=n>tree</span> <span class=o>=</span> <span class=n>ControlMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+        <span class=n>tree_context</span><span class=o>.</span><span class=n>reset</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>header</span><span class=p>,</span> <span class=n>tree</span>
+    <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error while reading control markdown: </span><span class=si>{</span><span class=n>md_path</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>e</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_processor.MarkdownProcessor.process_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>process_markdown</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>read_header</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>read_body</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.process_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Parse the markdown and builds the tree to operate over it.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_processor.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>process_markdown</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                     <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+                     <span class=n>read_header</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+                     <span class=n>read_body</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>,</span> <span class=n>DocsMarkdownNode</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Parse the markdown and builds the tree to operate over it.&quot;&quot;&quot;</span>
+    <span class=n>header</span><span class=p>,</span> <span class=n>markdown_wo_header</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>read_header</span><span class=p>,</span> <span class=n>read_body</span><span class=p>)</span>
+
+    <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>render_gfm_to_html</span><span class=p>(</span><span class=n>markdown_wo_header</span><span class=p>)</span>
+
+    <span class=n>lines</span> <span class=o>=</span> <span class=n>markdown_wo_header</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>tree</span> <span class=o>=</span> <span class=n>DocsMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>lines</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>governed_header</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>header</span><span class=p>,</span> <span class=n>tree</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_processor.MarkdownProcessor.read_markdown_wo_processing class="doc doc-heading"> <code class="highlight language-python"><span class=n>read_markdown_wo_processing</span><span class=p>(</span><span class=n>md_path</span><span class=p>,</span> <span class=n>read_header</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>read_body</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.read_markdown_wo_processing class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read markdown header to dictionary and body to string.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_processor.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>read_markdown_wo_processing</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                                <span class=n>md_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+                                <span class=n>read_header</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+                                <span class=n>read_body</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>Dict</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Read markdown header to dictionary and body to string.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>contents</span> <span class=o>=</span> <span class=n>frontmatter</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>md_path</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span><span class=o>.</span><span class=n>read</span><span class=p>())</span>
+        <span class=n>header</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>markdown_wo_header</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>if</span> <span class=n>read_header</span><span class=p>:</span>
+            <span class=n>header</span> <span class=o>=</span> <span class=n>contents</span><span class=o>.</span><span class=n>metadata</span>
+        <span class=k>if</span> <span class=n>read_body</span><span class=p>:</span>
+            <span class=n>markdown_wo_header</span> <span class=o>=</span> <span class=n>contents</span><span class=o>.</span><span class=n>content</span>
+
+        <span class=k>return</span> <span class=n>header</span><span class=p>,</span> <span class=n>markdown_wo_header</span>
+    <span class=k>except</span> <span class=ne>UnicodeDecodeError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown cannot be decoded into </span><span class=si>{</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=si>}</span><span class=s1>, error: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>except</span> <span class=n>ScannerError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Header is not in a valid YAML format: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>FileNotFoundError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Markdown with path </span><span class=si>{</span><span class=n>md_path</span><span class=si>}</span><span class=s1>, not found: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_processor.MarkdownProcessor.render_gfm_to_html class="doc doc-heading"> <code class="highlight language-python"><span class=n>render_gfm_to_html</span><span class=p>(</span><span class=n>markdown_text</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_processor.MarkdownProcessor.render_gfm_to_html class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Render given Github Flavored Markdown to HTML.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_processor.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>render_gfm_to_html</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>markdown_text</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Render given Github Flavored Markdown to HTML.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>html</span> <span class=o>=</span> <span class=n>cmarkgfm</span><span class=o>.</span><span class=n>github_flavored_markdown_to_html</span><span class=p>(</span><span class=n>markdown_text</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>html</span>
+    <span class=k>except</span> <span class=ne>ValueError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Not a valid Github Flavored markdown: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.markdown.markdown_processor-functions>Functions<a href=#trestle.core.markdown.markdown_processor-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/markdown/markdown_validator/index.html b/latest/reference/API/trestle/core/markdown/markdown_validator/index.html
new file mode 100644
index 000000000..6eedf7bb7
--- /dev/null
+++ b/latest/reference/API/trestle/core/markdown/markdown_validator/index.html
@@ -0,0 +1,752 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.markdown.markdown_validator module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_validator/ rel=canonical><link href=../markdown_processor/ rel=prev><link href=../md_writer/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.markdown.markdown_validator - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.markdown.markdown_validator - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.markdown.markdown_validator module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_validator.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_validator/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.markdown.markdown_validator - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.markdown.markdown_validator module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/markdown_validator.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.markdown.markdown_validator class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30 checked> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator class=md-nav__link> <span class=md-ellipsis> markdown_validator </span> </a> <nav class=md-nav aria-label=markdown_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator class=md-nav__link> <span class=md-ellipsis> MarkdownValidator </span> </a> <nav class=md-nav aria-label=MarkdownValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.governed_section class=md-nav__link> <span class=md-ellipsis> governed_section </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_header class=md-nav__link> <span class=md-ellipsis> template_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_path class=md-nav__link> <span class=md-ellipsis> template_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_tree class=md-nav__link> <span class=md-ellipsis> template_tree </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_version class=md-nav__link> <span class=md-ellipsis> template_version </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.compare_keys class=md-nav__link> <span class=md-ellipsis> compare_keys </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.extract_template_version class=md-nav__link> <span class=md-ellipsis> extract_template_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.is_valid_against_template class=md-nav__link> <span class=md-ellipsis> is_valid_against_template </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator class=md-nav__link> <span class=md-ellipsis> markdown_validator </span> </a> <nav class=md-nav aria-label=markdown_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator class=md-nav__link> <span class=md-ellipsis> MarkdownValidator </span> </a> <nav class=md-nav aria-label=MarkdownValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.governed_section class=md-nav__link> <span class=md-ellipsis> governed_section </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_header class=md-nav__link> <span class=md-ellipsis> template_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_path class=md-nav__link> <span class=md-ellipsis> template_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_tree class=md-nav__link> <span class=md-ellipsis> template_tree </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_version class=md-nav__link> <span class=md-ellipsis> template_version </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.compare_keys class=md-nav__link> <span class=md-ellipsis> compare_keys </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.extract_template_version class=md-nav__link> <span class=md-ellipsis> extract_template_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.is_valid_against_template class=md-nav__link> <span class=md-ellipsis> is_valid_against_template </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.markdown_validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.markdown.markdown_validator</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.markdown.markdown_validator class="doc doc-heading"> <code>trestle.core.markdown.markdown_validator</code> <a href=#trestle.core.markdown.markdown_validator class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Markdown Validator.</p> <div class="doc doc-children"> <h3 id=trestle.core.markdown.markdown_validator-attributes>Attributes<a href=#trestle.core.markdown.markdown_validator-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.markdown_validator.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_validator.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.markdown.markdown_validator-classes>Classes<a href=#trestle.core.markdown.markdown_validator-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.markdown_validator.MarkdownValidator class="doc doc-heading"> <code>MarkdownValidator</code> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>A markdown validator. Validates markdown instance against given template.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 31</span>
+<span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>MarkdownValidator</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;A markdown validator. Validates markdown instance against given template.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>tmp_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>template_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>,</span>
+        <span class=n>template_tree</span><span class=p>:</span> <span class=n>DocsMarkdownNode</span><span class=p>,</span>
+        <span class=n>validate_yaml_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>validate_md_body</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>governed_section</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize markdown validator.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_validate_yaml_header</span> <span class=o>=</span> <span class=n>validate_yaml_header</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_validate_md_body</span> <span class=o>=</span> <span class=n>validate_md_body</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span> <span class=o>=</span> <span class=n>governed_section</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>)</span> <span class=k>if</span> <span class=n>governed_section</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=k>else</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_header</span> <span class=o>=</span> <span class=n>template_header</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_tree</span> <span class=o>=</span> <span class=n>template_tree</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_path</span> <span class=o>=</span> <span class=n>tmp_path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span> <span class=ow>not</span> <span class=ow>in</span> <span class=nb>str</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Version of the template </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1> does not match the path </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;Move the template to the folder </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+        <span class=k>if</span> <span class=s1>&#39;Version&#39;</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=p>[</span><span class=s1>&#39;Version&#39;</span><span class=p>]</span> <span class=o>!=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Version does not match template-version in template: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_ignore_headers</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;x-trestle-&#39;</span><span class=p>):</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_ignore_headers</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>())</span>
+                <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;x-trestle-ignore&#39;</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>key2</span> <span class=ow>in</span> <span class=n>template_header</span><span class=p>[</span><span class=s1>&#39;x-trestle-ignore&#39;</span><span class=p>]:</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_ignore_headers</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key2</span><span class=o>.</span><span class=n>lower</span><span class=p>())</span>
+
+    <span class=k>def</span> <span class=nf>is_valid_against_template</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>instance</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>instance_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>,</span> <span class=n>instance_tree</span><span class=p>:</span> <span class=n>DocsMarkdownNode</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Validate instance markdown against template.</span>
+
+<span class=sd>        Instance is correct against a template iff:</span>
+<span class=sd>            1. For YAML header keys:</span>
+<span class=sd>                a. All keys from the template are present and not modified</span>
+<span class=sd>                b. Template version in the template and instance match</span>
+<span class=sd>            2. On the Markdown w/o YAML header:</span>
+<span class=sd>                a. No additional headers of the level 1 were added</span>
+<span class=sd>                b. Headers were not reordered</span>
+<span class=sd>                c. Headers in the instance should be a superset of the template headers</span>
+<span class=sd>                d. Headers must be in heirarchical order (i.e. # then ### then ## is not allowed)</span>
+<span class=sd>            3. If Governed Header is given then:</span>
+<span class=sd>                a. Governed Header is not modified</span>
+<span class=sd>                b. All keys (i.e. key: something) inside the section are present</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            instance: a path to the markdown instance that should be validated</span>
+<span class=sd>            instance_header: a YAML header extracted from the markdown</span>
+<span class=sd>            instance_tree: a tree structure representing markdown contents</span>
+<span class=sd>        Returns:</span>
+<span class=sd>            Whether or not the the candidate is valid against the template.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_yaml_header</span><span class=p>:</span>
+            <span class=n>headers_match</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>compare_keys</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=p>,</span> <span class=n>instance_header</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ignore_headers</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>headers_match</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;YAML header mismatch between template </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1> and instance </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+            <span class=k>elif</span> <span class=n>headers_match</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_md_body</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>True</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>instance_gov_nodes</span> <span class=o>=</span> <span class=n>instance_tree</span><span class=o>.</span><span class=n>get_all_nodes_for_keys</span><span class=p>([</span><span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span><span class=p>],</span> <span class=kc>False</span><span class=p>)</span>
+            <span class=n>template_gov_nodes</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_tree</span><span class=o>.</span><span class=n>get_all_nodes_for_keys</span><span class=p>([</span><span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span><span class=p>],</span> <span class=kc>False</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>instance_gov_nodes</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Governed section </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span><span class=si>}</span><span class=s1> not found in instance: </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>template_gov_nodes</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Governed section </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span><span class=si>}</span><span class=s1> not found in template: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+            <span class=k>if</span> <span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>key</span> <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>instance_gov_nodes</span><span class=p>]</span> <span class=o>!=</span> <span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>key</span> <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>template_gov_nodes</span><span class=p>]:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Governed sections were changed, &#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;template expects: </span><span class=si>{</span><span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=w> </span><span class=k>for</span><span class=w> </span><span class=n>node</span><span class=w> </span><span class=ow>in</span><span class=w> </span><span class=n>template_gov_nodes</span><span class=p>]</span><span class=si>}</span><span class=s1>,&#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;but found </span><span class=si>{</span><span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=w> </span><span class=k>for</span><span class=w> </span><span class=n>node</span><span class=w> </span><span class=ow>in</span><span class=w> </span><span class=n>instance_gov_nodes</span><span class=p>]</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+            <span class=k>for</span> <span class=n>instance_gov_node</span><span class=p>,</span> <span class=n>template_gov_node</span> <span class=ow>in</span> <span class=nb>zip</span><span class=p>(</span><span class=n>instance_gov_nodes</span><span class=p>,</span> <span class=n>template_gov_nodes</span><span class=p>):</span>
+                <span class=n>instance_keys</span> <span class=o>=</span> <span class=n>instance_gov_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>governed_document</span>
+                <span class=n>template_keys</span> <span class=o>=</span> <span class=n>template_gov_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>governed_document</span>
+
+                <span class=n>is_valid</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_headings</span><span class=p>(</span><span class=n>instance</span><span class=p>,</span> <span class=n>template_keys</span><span class=p>,</span> <span class=n>instance_keys</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>is_valid</span><span class=p>:</span>
+                    <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_md_body</span><span class=p>:</span>
+            <span class=n>instance_keys</span> <span class=o>=</span> <span class=n>instance_tree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span>
+            <span class=n>template_keys</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_tree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>template_keys</span><span class=p>)</span> <span class=o>&gt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>instance_keys</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Headings in the instance: </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1> were removed.&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+            <span class=n>instance_lvl1_keys</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>instance_tree</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>1</span><span class=p>))</span>
+            <span class=n>template_lvl1_keys</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_tree</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>1</span><span class=p>))</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>template_lvl1_keys</span><span class=p>)</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>instance_lvl1_keys</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;New headers of level 1 were added to the markdown instance: </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1>. &#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+            <span class=n>is_valid</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_headings</span><span class=p>(</span><span class=n>instance</span><span class=p>,</span> <span class=n>template_keys</span><span class=p>,</span> <span class=n>instance_keys</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>is_valid</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>compare_keys</span><span class=p>(</span>
+        <span class=bp>cls</span><span class=p>,</span>
+        <span class=n>template</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>candidate</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+        <span class=n>ignore_fields</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Compare a template dictionary against a candidate as to whether key structure is maintained.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            template: Template dict which is used as a model of key-value pairs</span>
+<span class=sd>            candidate: Candidate dictionary to be measured</span>
+<span class=sd>        Returns:</span>
+<span class=sd>            Whether or not the the candidate matches the template keys.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>ignore_fields</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>ignore_fields</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>list</span><span class=p>(</span><span class=n>candidate</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+            <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>ignore_fields</span><span class=p>:</span>
+                <span class=n>candidate</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>list</span><span class=p>(</span><span class=n>template</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+            <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>ignore_fields</span><span class=p>:</span>
+                <span class=n>template</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+        <span class=n>template_version</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=n>template</span><span class=p>)</span>
+        <span class=n>candidate_version</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=n>candidate</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>template_version</span> <span class=o>!=</span> <span class=n>candidate_version</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Versions of the template </span><span class=si>{</span><span class=n>template_version</span><span class=si>}</span><span class=s1> and instance </span><span class=si>{</span><span class=n>candidate_version</span><span class=si>}</span><span class=s1> are different&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>template</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span> <span class=o>!=</span> <span class=nb>len</span><span class=p>(</span><span class=n>candidate</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Number of keys does not match in template </span><span class=si>{</span><span class=n>template</span><span class=si>}</span><span class=s1> and instance </span><span class=si>{</span><span class=n>candidate</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>template</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>candidate</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>template</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>dict</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>candidate</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>dict</span><span class=p>):</span>
+                        <span class=n>status</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>compare_keys</span><span class=p>(</span><span class=n>template</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>candidate</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>ignore_fields</span><span class=p>)</span>
+                        <span class=k>if</span> <span class=ow>not</span> <span class=n>status</span><span class=p>:</span>
+                            <span class=k>return</span> <span class=n>status</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Value under </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> must be dictionary in candidate </span><span class=si>{</span><span class=n>candidate</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                        <span class=k>return</span> <span class=kc>False</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Key </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> is not in candidate </span><span class=si>{</span><span class=n>candidate</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>_validate_headings</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>instance</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>template_keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>instance_keys</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Validate instance headings against template.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>template_keys</span><span class=p>)</span> <span class=o>&gt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>instance_keys</span><span class=p>):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Headings in the instance: </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1> were removed.&#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;Expected </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>template_keys</span><span class=p>)</span><span class=si>}</span><span class=s1> headings, but found only </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>instance_keys</span><span class=p>)</span><span class=si>}</span><span class=s1>.&#39;</span>
+            <span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=n>template_header_pointer</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=n>present_keys</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>instance_keys</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>template_header_pointer</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=n>template_keys</span><span class=p>):</span>
+                <span class=k>break</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>template_keys</span> <span class=ow>and</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>present_keys</span><span class=p>:</span>
+                <span class=n>present_keys</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>template_keys</span><span class=p>[</span><span class=n>template_keys</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>key</span><span class=p>)])</span>
+                <span class=n>template_header_pointer</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=k>elif</span> <span class=n>re</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=n>md_const</span><span class=o>.</span><span class=n>SUBSTITUTION_REGEX</span><span class=p>,</span> <span class=n>template_keys</span><span class=p>[</span><span class=n>template_header_pointer</span><span class=p>])</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>present_keys</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>template_keys</span><span class=p>[</span><span class=n>template_header_pointer</span><span class=p>])</span>
+                <span class=n>template_header_pointer</span> <span class=o>+=</span> <span class=mi>1</span>  <span class=c1># skip headers with substitutions</span>
+        <span class=n>diff_keys</span> <span class=o>=</span> <span class=nb>set</span><span class=p>(</span><span class=n>template_keys</span><span class=p>)</span> <span class=o>-</span> <span class=nb>set</span><span class=p>(</span><span class=n>present_keys</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>template_header_pointer</span> <span class=o>!=</span> <span class=nb>len</span><span class=p>(</span><span class=n>template_keys</span><span class=p>)</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=n>diff_keys</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Headings in the instance: </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1> were removed. &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;Expected </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>template_keys</span><span class=p>)</span><span class=si>}</span><span class=s1> headings, but found only </span><span class=si>{</span><span class=n>template_header_pointer</span><span class=si>}</span><span class=s1>.&#39;</span>
+            <span class=p>)</span>
+            <span class=k>for</span> <span class=n>result</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>diff_keys</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Heading </span><span class=si>{</span><span class=n>result</span><span class=si>}</span><span class=s1> in the instance: </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1> was removed or not present &#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>extract_template_version</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Extract the template version from the header.</span>
+
+<span class=sd>        If no header is found then starting version(0.0.1) will be used by default</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>TEMPLATE_VERSION_HEADER</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>header</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>START_TEMPLATE_VERSION</span>
+
+        <span class=k>return</span> <span class=n>header</span><span class=p>[</span><span class=n>TEMPLATE_VERSION_HEADER</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.markdown_validator.MarkdownValidator-attributes>Attributes<a href=#trestle.core.markdown.markdown_validator.MarkdownValidator-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.markdown_validator.MarkdownValidator.governed_section class="doc doc-heading"> <code class="highlight language-python"><span class=n>governed_section</span> <span class=o>=</span> <span class=n>governed_section</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>)</span> <span class=k>if</span> <span class=n>governed_section</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=k>else</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.governed_section class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.markdown_validator.MarkdownValidator.template_header class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_header</span> <span class=o>=</span> <span class=n>template_header</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_header class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.markdown_validator.MarkdownValidator.template_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_path</span> <span class=o>=</span> <span class=n>tmp_path</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.markdown_validator.MarkdownValidator.template_tree class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_tree</span> <span class=o>=</span> <span class=n>template_tree</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_tree class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.markdown.markdown_validator.MarkdownValidator.template_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>template_version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.template_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.markdown.markdown_validator.MarkdownValidator-functions>Functions<a href=#trestle.core.markdown.markdown_validator.MarkdownValidator-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_validator.MarkdownValidator.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>tmp_path</span><span class=p>,</span> <span class=n>template_header</span><span class=p>,</span> <span class=n>template_tree</span><span class=p>,</span> <span class=n>validate_yaml_header</span><span class=p>,</span> <span class=n>validate_md_body</span><span class=p>,</span> <span class=n>governed_section</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize markdown validator.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>tmp_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>template_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>,</span>
+    <span class=n>template_tree</span><span class=p>:</span> <span class=n>DocsMarkdownNode</span><span class=p>,</span>
+    <span class=n>validate_yaml_header</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>validate_md_body</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+    <span class=n>governed_section</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize markdown validator.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_validate_yaml_header</span> <span class=o>=</span> <span class=n>validate_yaml_header</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_validate_md_body</span> <span class=o>=</span> <span class=n>validate_md_body</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span> <span class=o>=</span> <span class=n>governed_section</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>)</span> <span class=k>if</span> <span class=n>governed_section</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=k>else</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>template_header</span> <span class=o>=</span> <span class=n>template_header</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>template_tree</span> <span class=o>=</span> <span class=n>template_tree</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>template_path</span> <span class=o>=</span> <span class=n>tmp_path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span> <span class=ow>not</span> <span class=ow>in</span> <span class=nb>str</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Version of the template </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1> does not match the path </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>.&#39;</span>
+            <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;Move the template to the folder </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=p>)</span>
+    <span class=k>if</span> <span class=s1>&#39;Version&#39;</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=p>[</span><span class=s1>&#39;Version&#39;</span><span class=p>]</span> <span class=o>!=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_version</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Version does not match template-version in template: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_ignore_headers</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;x-trestle-&#39;</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_ignore_headers</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>())</span>
+            <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;x-trestle-ignore&#39;</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>key2</span> <span class=ow>in</span> <span class=n>template_header</span><span class=p>[</span><span class=s1>&#39;x-trestle-ignore&#39;</span><span class=p>]:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_ignore_headers</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key2</span><span class=o>.</span><span class=n>lower</span><span class=p>())</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_validator.MarkdownValidator.compare_keys class="doc doc-heading"> <code class="highlight language-python"><span class=n>compare_keys</span><span class=p>(</span><span class=n>template</span><span class=p>,</span> <span class=n>candidate</span><span class=p>,</span> <span class=n>ignore_fields</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.compare_keys class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Compare a template dictionary against a candidate as to whether key structure is maintained.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>template</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, <span title=typing.Any>Any</span>]</code> </td> <td> <div class=doc-md-description> <p>Template dict which is used as a model of key-value pairs</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>candidate</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, <span title=typing.Any>Any</span>]</code> </td> <td> <div class=doc-md-description> <p>Candidate dictionary to be measured</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p>Returns: Whether or not the the candidate matches the template keys.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>compare_keys</span><span class=p>(</span>
+    <span class=bp>cls</span><span class=p>,</span>
+    <span class=n>template</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+    <span class=n>candidate</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span>
+    <span class=n>ignore_fields</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Compare a template dictionary against a candidate as to whether key structure is maintained.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        template: Template dict which is used as a model of key-value pairs</span>
+<span class=sd>        candidate: Candidate dictionary to be measured</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        Whether or not the the candidate matches the template keys.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>ignore_fields</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>ignore_fields</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>list</span><span class=p>(</span><span class=n>candidate</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+        <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>ignore_fields</span><span class=p>:</span>
+            <span class=n>candidate</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>list</span><span class=p>(</span><span class=n>template</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+        <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=ow>in</span> <span class=n>ignore_fields</span><span class=p>:</span>
+            <span class=n>template</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+    <span class=n>template_version</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=n>template</span><span class=p>)</span>
+    <span class=n>candidate_version</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>extract_template_version</span><span class=p>(</span><span class=n>candidate</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>template_version</span> <span class=o>!=</span> <span class=n>candidate_version</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Versions of the template </span><span class=si>{</span><span class=n>template_version</span><span class=si>}</span><span class=s1> and instance </span><span class=si>{</span><span class=n>candidate_version</span><span class=si>}</span><span class=s1> are different&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>template</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span> <span class=o>!=</span> <span class=nb>len</span><span class=p>(</span><span class=n>candidate</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Number of keys does not match in template </span><span class=si>{</span><span class=n>template</span><span class=si>}</span><span class=s1> and instance </span><span class=si>{</span><span class=n>candidate</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>template</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>candidate</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>template</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>dict</span><span class=p>):</span>
+                <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>candidate</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=nb>dict</span><span class=p>):</span>
+                    <span class=n>status</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>compare_keys</span><span class=p>(</span><span class=n>template</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>candidate</span><span class=p>[</span><span class=n>key</span><span class=p>],</span> <span class=n>ignore_fields</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=n>status</span><span class=p>:</span>
+                        <span class=k>return</span> <span class=n>status</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Value under </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> must be dictionary in candidate </span><span class=si>{</span><span class=n>candidate</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Key </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> is not in candidate </span><span class=si>{</span><span class=n>candidate</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_validator.MarkdownValidator.extract_template_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>extract_template_version</span><span class=p>(</span><span class=n>header</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.extract_template_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Extract the template version from the header.</p> <p>If no header is found then starting version(0.0.1) will be used by default</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>extract_template_version</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Extract the template version from the header.</span>
+
+<span class=sd>    If no header is found then starting version(0.0.1) will be used by default</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>TEMPLATE_VERSION_HEADER</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>header</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=k>return</span> <span class=n>START_TEMPLATE_VERSION</span>
+
+    <span class=k>return</span> <span class=n>header</span><span class=p>[</span><span class=n>TEMPLATE_VERSION_HEADER</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.markdown_validator.MarkdownValidator.is_valid_against_template class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_valid_against_template</span><span class=p>(</span><span class=n>instance</span><span class=p>,</span> <span class=n>instance_header</span><span class=p>,</span> <span class=n>instance_tree</span><span class=p>)</span></code> <a href=#trestle.core.markdown.markdown_validator.MarkdownValidator.is_valid_against_template class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate instance markdown against template.</p> <details class=instance-is-correct-against-a-template-iff open> <summary>Instance is correct against a template iff</summary> <ol> <li>For YAML header keys: a. All keys from the template are present and not modified b. Template version in the template and instance match</li> <li>On the Markdown w/o YAML header: a. No additional headers of the level 1 were added b. Headers were not reordered c. Headers in the instance should be a superset of the template headers d. Headers must be in heirarchical order (i.e. # then ### then ## is not allowed)</li> <li>If Governed Header is given then: a. Governed Header is not modified b. All keys (i.e. key: something) inside the section are present</li> </ol> </details> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>instance</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>a path to the markdown instance that should be validated</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>instance_header</code> </td> <td> <code><span title=typing.Dict>Dict</span></code> </td> <td> <div class=doc-md-description> <p>a YAML header extracted from the markdown</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>instance_tree</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.markdown.docs_markdown_node.DocsMarkdownNode href=../docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode>DocsMarkdownNode</a></code> </td> <td> <div class=doc-md-description> <p>a tree structure representing markdown contents</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p>Returns: Whether or not the the candidate is valid against the template.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/markdown_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_valid_against_template</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>instance</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>instance_header</span><span class=p>:</span> <span class=n>Dict</span><span class=p>,</span> <span class=n>instance_tree</span><span class=p>:</span> <span class=n>DocsMarkdownNode</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Validate instance markdown against template.</span>
+
+<span class=sd>    Instance is correct against a template iff:</span>
+<span class=sd>        1. For YAML header keys:</span>
+<span class=sd>            a. All keys from the template are present and not modified</span>
+<span class=sd>            b. Template version in the template and instance match</span>
+<span class=sd>        2. On the Markdown w/o YAML header:</span>
+<span class=sd>            a. No additional headers of the level 1 were added</span>
+<span class=sd>            b. Headers were not reordered</span>
+<span class=sd>            c. Headers in the instance should be a superset of the template headers</span>
+<span class=sd>            d. Headers must be in heirarchical order (i.e. # then ### then ## is not allowed)</span>
+<span class=sd>        3. If Governed Header is given then:</span>
+<span class=sd>            a. Governed Header is not modified</span>
+<span class=sd>            b. All keys (i.e. key: something) inside the section are present</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        instance: a path to the markdown instance that should be validated</span>
+<span class=sd>        instance_header: a YAML header extracted from the markdown</span>
+<span class=sd>        instance_tree: a tree structure representing markdown contents</span>
+<span class=sd>    Returns:</span>
+<span class=sd>        Whether or not the the candidate is valid against the template.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_yaml_header</span><span class=p>:</span>
+        <span class=n>headers_match</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>compare_keys</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_header</span><span class=p>,</span> <span class=n>instance_header</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ignore_headers</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>headers_match</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;YAML header mismatch between template </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1> and instance </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>elif</span> <span class=n>headers_match</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_md_body</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>instance_gov_nodes</span> <span class=o>=</span> <span class=n>instance_tree</span><span class=o>.</span><span class=n>get_all_nodes_for_keys</span><span class=p>([</span><span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span><span class=p>],</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>template_gov_nodes</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_tree</span><span class=o>.</span><span class=n>get_all_nodes_for_keys</span><span class=p>([</span><span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span><span class=p>],</span> <span class=kc>False</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>instance_gov_nodes</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Governed section </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span><span class=si>}</span><span class=s1> not found in instance: </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>template_gov_nodes</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Governed section </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>governed_section</span><span class=si>}</span><span class=s1> not found in template: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>template_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>if</span> <span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>key</span> <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>instance_gov_nodes</span><span class=p>]</span> <span class=o>!=</span> <span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>key</span> <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>template_gov_nodes</span><span class=p>]:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Governed sections were changed, &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;template expects: </span><span class=si>{</span><span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=w> </span><span class=k>for</span><span class=w> </span><span class=n>node</span><span class=w> </span><span class=ow>in</span><span class=w> </span><span class=n>template_gov_nodes</span><span class=p>]</span><span class=si>}</span><span class=s1>,&#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;but found </span><span class=si>{</span><span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>key</span><span class=w> </span><span class=k>for</span><span class=w> </span><span class=n>node</span><span class=w> </span><span class=ow>in</span><span class=w> </span><span class=n>instance_gov_nodes</span><span class=p>]</span><span class=si>}</span><span class=s1>.&#39;</span>
+            <span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>for</span> <span class=n>instance_gov_node</span><span class=p>,</span> <span class=n>template_gov_node</span> <span class=ow>in</span> <span class=nb>zip</span><span class=p>(</span><span class=n>instance_gov_nodes</span><span class=p>,</span> <span class=n>template_gov_nodes</span><span class=p>):</span>
+            <span class=n>instance_keys</span> <span class=o>=</span> <span class=n>instance_gov_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>governed_document</span>
+            <span class=n>template_keys</span> <span class=o>=</span> <span class=n>template_gov_node</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>governed_document</span>
+
+            <span class=n>is_valid</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_headings</span><span class=p>(</span><span class=n>instance</span><span class=p>,</span> <span class=n>template_keys</span><span class=p>,</span> <span class=n>instance_keys</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>is_valid</span><span class=p>:</span>
+                <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_md_body</span><span class=p>:</span>
+        <span class=n>instance_keys</span> <span class=o>=</span> <span class=n>instance_tree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span>
+        <span class=n>template_keys</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>template_tree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>subnodes_keys</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>template_keys</span><span class=p>)</span> <span class=o>&gt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>instance_keys</span><span class=p>):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Headings in the instance: </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1> were removed.&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=n>instance_lvl1_keys</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>instance_tree</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>1</span><span class=p>))</span>
+        <span class=n>template_lvl1_keys</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>template_tree</span><span class=o>.</span><span class=n>get_all_headers_for_level</span><span class=p>(</span><span class=mi>1</span><span class=p>))</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>template_lvl1_keys</span><span class=p>)</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=n>instance_lvl1_keys</span><span class=p>):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;New headers of level 1 were added to the markdown instance: </span><span class=si>{</span><span class=n>instance</span><span class=si>}</span><span class=s1>. &#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=n>is_valid</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_headings</span><span class=p>(</span><span class=n>instance</span><span class=p>,</span> <span class=n>template_keys</span><span class=p>,</span> <span class=n>instance_keys</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>is_valid</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.markdown.markdown_validator-functions>Functions<a href=#trestle.core.markdown.markdown_validator-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/markdown/md_writer/index.html b/latest/reference/API/trestle/core/markdown/md_writer/index.html
new file mode 100644
index 000000000..d41453b6d
--- /dev/null
+++ b/latest/reference/API/trestle/core/markdown/md_writer/index.html
@@ -0,0 +1,548 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.markdown.md_writer module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/md_writer/ rel=canonical><link href=../markdown_validator/ rel=prev><link href=../../models/actions/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.markdown.md_writer - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.markdown.md_writer - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.markdown.md_writer module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/md_writer.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/md_writer/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.markdown.md_writer - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.markdown.md_writer module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/markdown/md_writer.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.markdown.md_writer class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30 checked> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer class=md-nav__link> <span class=md-ellipsis> md_writer </span> </a> <nav class=md-nav aria-label=md_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter class=md-nav__link> <span class=md-ellipsis> MDWriter </span> </a> <nav class=md-nav aria-label=MDWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.add_yaml_header class=md-nav__link> <span class=md-ellipsis> add_yaml_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.cull_headings class=md-nav__link> <span class=md-ellipsis> cull_headings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.exists class=md-nav__link> <span class=md-ellipsis> exists </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.get_lines class=md-nav__link> <span class=md-ellipsis> get_lines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.get_text class=md-nav__link> <span class=md-ellipsis> get_text </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_header class=md-nav__link> <span class=md-ellipsis> new_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_hr class=md-nav__link> <span class=md-ellipsis> new_hr </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_line class=md-nav__link> <span class=md-ellipsis> new_line </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_list class=md-nav__link> <span class=md-ellipsis> new_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_paragraph class=md-nav__link> <span class=md-ellipsis> new_paragraph </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_paraline class=md-nav__link> <span class=md-ellipsis> new_paraline </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_table class=md-nav__link> <span class=md-ellipsis> new_table </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.set_indent_level class=md-nav__link> <span class=md-ellipsis> set_indent_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.set_indent_step_size class=md-nav__link> <span class=md-ellipsis> set_indent_step_size </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.write_out class=md-nav__link> <span class=md-ellipsis> write_out </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer class=md-nav__link> <span class=md-ellipsis> md_writer </span> </a> <nav class=md-nav aria-label=md_writer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter class=md-nav__link> <span class=md-ellipsis> MDWriter </span> </a> <nav class=md-nav aria-label=MDWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.add_yaml_header class=md-nav__link> <span class=md-ellipsis> add_yaml_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.cull_headings class=md-nav__link> <span class=md-ellipsis> cull_headings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.exists class=md-nav__link> <span class=md-ellipsis> exists </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.get_lines class=md-nav__link> <span class=md-ellipsis> get_lines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.get_text class=md-nav__link> <span class=md-ellipsis> get_text </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_header class=md-nav__link> <span class=md-ellipsis> new_header </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_hr class=md-nav__link> <span class=md-ellipsis> new_hr </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_line class=md-nav__link> <span class=md-ellipsis> new_line </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_list class=md-nav__link> <span class=md-ellipsis> new_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_paragraph class=md-nav__link> <span class=md-ellipsis> new_paragraph </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_paraline class=md-nav__link> <span class=md-ellipsis> new_paraline </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.new_table class=md-nav__link> <span class=md-ellipsis> new_table </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.set_indent_level class=md-nav__link> <span class=md-ellipsis> set_indent_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.set_indent_step_size class=md-nav__link> <span class=md-ellipsis> set_indent_step_size </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer.MDWriter.write_out class=md-nav__link> <span class=md-ellipsis> write_out </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.markdown.md_writer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.markdown.md_writer</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.markdown.md_writer class="doc doc-heading"> <code>trestle.core.markdown.md_writer</code> <a href=#trestle.core.markdown.md_writer class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Create formatted markdown files with optional yaml header.</p> <div class="doc doc-children"> <h3 id=trestle.core.markdown.md_writer-attributes>Attributes<a href=#trestle.core.markdown.md_writer-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.markdown.md_writer.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.markdown.md_writer.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.markdown.md_writer-classes>Classes<a href=#trestle.core.markdown.md_writer-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.markdown.md_writer.MDWriter class="doc doc-heading"> <code>MDWriter</code> <a href=#trestle.core.markdown.md_writer.MDWriter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Simple class to create markdown files.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 31</span>
+<span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>MDWriter</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Simple class to create markdown files.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>header_comments_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span> <span class=o>=</span> <span class=n>file_path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_indent_level</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_indent_size</span> <span class=o>=</span> <span class=mi>2</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_header_comments_dict</span> <span class=o>=</span> <span class=n>header_comments_dict</span>
+
+    <span class=k>def</span> <span class=nf>_current_indent_space</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_indent_level</span> <span class=o>&lt;=</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>return</span> <span class=s1>&#39; &#39;</span> <span class=o>*</span> <span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_indent_level</span> <span class=o>*</span> <span class=bp>self</span><span class=o>.</span><span class=n>_indent_size</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_line_raw</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>out_line</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_blank</span><span class=p>(</span><span class=n>line</span><span class=p>)</span> <span class=k>else</span> <span class=n>line</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>out_line</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_indent_level</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>delta</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_indent_level</span> <span class=o>+=</span> <span class=n>delta</span>
+
+    <span class=k>def</span> <span class=nf>exists</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if the file already exists.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>add_yaml_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=nb>dict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add the yaml header.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span> <span class=o>=</span> <span class=n>header</span>
+
+    <span class=k>def</span> <span class=nf>set_indent_level</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set the current indent level.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_indent_level</span> <span class=o>=</span> <span class=n>level</span>
+
+    <span class=k>def</span> <span class=nf>set_indent_step_size</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>size</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set the indent step size in spaces.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_indent_size</span> <span class=o>=</span> <span class=n>size</span>
+
+    <span class=k>def</span> <span class=nf>_is_blank</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_prev_blank_line</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+        <span class=k>return</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_blank</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+
+    <span class=k>def</span> <span class=nf>new_line</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add a line of text to the output.&quot;&quot;&quot;</span>
+        <span class=c1># prevent double empty lines</span>
+        <span class=n>out_line</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_blank</span><span class=p>(</span><span class=n>line</span><span class=p>)</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_current_indent_space</span><span class=p>()</span> <span class=o>+</span> <span class=n>line</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prev_blank_line</span><span class=p>()</span> <span class=ow>and</span> <span class=n>out_line</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+            <span class=k>return</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_line_raw</span><span class=p>(</span><span class=n>out_line</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>new_paraline</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add a paragraph and a line to output.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>new_paragraph</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Start a new paragraph.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>new_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add new header.&quot;&quot;&quot;</span>
+        <span class=c1># headers might be separated by blank lines</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;#&#39;</span> <span class=o>*</span> <span class=n>level</span> <span class=o>+</span> <span class=s1>&#39; &#39;</span> <span class=o>+</span> <span class=n>title</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>add_new_line_after_header</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>new_hr</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add horizontal rule.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MD_HRULE_LINE</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>new_list</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>list_</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add a list to the markdown.&quot;&quot;&quot;</span>
+        <span class=c1># in general this is a list of lists</span>
+        <span class=c1># if string just write it out</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>list_</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_blank</span><span class=p>(</span><span class=n>list_</span><span class=p>):</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;- &#39;</span> <span class=o>+</span> <span class=n>list_</span><span class=p>)</span>
+        <span class=c1># else it is a sublist so indent</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_indent_level</span><span class=p>(</span><span class=mi>1</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>list_</span><span class=p>:</span>
+                <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_indent_level</span> <span class=o>&lt;=</span> <span class=mi>0</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>new_list</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>new_table</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>table_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]],</span> <span class=n>header</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add table to the markdown. All rows must be of equal length.&quot;&quot;&quot;</span>
+        <span class=n>header_str</span> <span class=o>=</span> <span class=s1>&#39;| &#39;</span> <span class=o>+</span> <span class=s1>&#39; | &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>header</span><span class=p>)</span> <span class=o>+</span> <span class=s1>&#39; |&#39;</span>
+        <span class=n>sep_str</span> <span class=o>=</span> <span class=s1>&#39;|---&#39;</span> <span class=o>*</span> <span class=nb>len</span><span class=p>(</span><span class=n>header</span><span class=p>)</span> <span class=o>+</span> <span class=s1>&#39;|&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>header_str</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>sep_str</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=n>table_list</span><span class=p>:</span>
+            <span class=n>row_str</span> <span class=o>=</span> <span class=s1>&#39;| &#39;</span> <span class=o>+</span> <span class=s1>&#39; | &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>row</span><span class=p>)</span> <span class=o>+</span> <span class=s1>&#39; |&#39;</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>row_str</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_check_header</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>while</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>[</span><span class=mi>1</span><span class=p>:]</span>
+
+    <span class=k>def</span> <span class=nf>write_out</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write out the markdown file.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_check_header</span><span class=p>()</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+            <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=p>,</span> <span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>f</span><span class=p>:</span>
+                <span class=c1># Make sure yaml header is written first</span>
+                <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>:</span>
+                    <span class=n>f</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;---</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>()</span>
+                    <span class=n>yaml</span><span class=o>.</span><span class=n>indent</span><span class=p>(</span><span class=n>mapping</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>sequence</span><span class=o>=</span><span class=mi>4</span><span class=p>,</span> <span class=n>offset</span><span class=o>=</span><span class=mi>2</span><span class=p>)</span>
+                    <span class=n>yaml</span><span class=o>.</span><span class=n>dump</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>,</span> <span class=n>f</span><span class=p>)</span>
+                    <span class=n>f</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;---</span><span class=se>\n\n</span><span class=s1>&#39;</span><span class=p>)</span>
+
+                <span class=n>f</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>))</span>
+                <span class=c1># if last line has text it will need an extra \n at end</span>
+                <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]:</span>
+                    <span class=n>f</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=c1># insert helpful comments into the header happens after header is written out</span>
+            <span class=k>for</span> <span class=n>tag</span><span class=p>,</span> <span class=n>comment</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_header_comments_dict</span><span class=p>)</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>tag</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>):</span>
+                    <span class=n>file_utils</span><span class=o>.</span><span class=n>insert_text_in_file</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=p>,</span> <span class=n>tag</span><span class=p>,</span> <span class=n>comment</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>IOError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;md_writer error attempting to write out md file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error attempting to write out md file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_lines</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the current lines in the file.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span>
+
+    <span class=k>def</span> <span class=nf>get_text</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the text as currently written.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>cull_headings</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_in</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>cull_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>strict_match</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Cull headers from the lines of input markdown file with optional strict string match.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            md_in: the path of the markdown file being edited</span>
+<span class=sd>            cull_list: the list of strings in headers that are to be culled</span>
+<span class=sd>            strict_match: whether to require an exact string match on header key or just a substring</span>
+
+<span class=sd>        Returns None and creates new markdown at the path specified during MDWriter construction</span>
+<span class=sd>        It is allowed to overwrite the original file</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>markdown_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+        <span class=n>header</span><span class=p>,</span> <span class=n>content</span> <span class=o>=</span> <span class=n>markdown_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>md_in</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span> <span class=o>=</span> <span class=n>header</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span> <span class=o>=</span> <span class=n>content</span><span class=o>.</span><span class=n>delete_nodes_text</span><span class=p>(</span><span class=n>cull_list</span><span class=p>,</span> <span class=n>strict_match</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.markdown.md_writer.MDWriter-functions>Functions<a href=#trestle.core.markdown.md_writer.MDWriter-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>header_comments_dict</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>header_comments_dict</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span> <span class=o>=</span> <span class=n>file_path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_indent_level</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_indent_size</span> <span class=o>=</span> <span class=mi>2</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_header_comments_dict</span> <span class=o>=</span> <span class=n>header_comments_dict</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.add_yaml_header class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_yaml_header</span><span class=p>(</span><span class=n>header</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.add_yaml_header class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add the yaml header.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_yaml_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=nb>dict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add the yaml header.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span> <span class=o>=</span> <span class=n>header</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.cull_headings class="doc doc-heading"> <code class="highlight language-python"><span class=n>cull_headings</span><span class=p>(</span><span class=n>md_in</span><span class=p>,</span> <span class=n>cull_list</span><span class=p>,</span> <span class=n>strict_match</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.cull_headings class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Cull headers from the lines of input markdown file with optional strict string match.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>md_in</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>the path of the markdown file being edited</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>cull_list</code> </td> <td> <code><span title=typing.List>List</span>[str]</code> </td> <td> <div class=doc-md-description> <p>the list of strings in headers that are to be culled</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>strict_match</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>whether to require an exact string match on header key or just a substring</p> </div> </td> <td> <code>False</code> </td> </tr> </tbody> </table> <p>Returns None and creates new markdown at the path specified during MDWriter construction It is allowed to overwrite the original file</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>cull_headings</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>md_in</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>cull_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>strict_match</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Cull headers from the lines of input markdown file with optional strict string match.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        md_in: the path of the markdown file being edited</span>
+<span class=sd>        cull_list: the list of strings in headers that are to be culled</span>
+<span class=sd>        strict_match: whether to require an exact string match on header key or just a substring</span>
+
+<span class=sd>    Returns None and creates new markdown at the path specified during MDWriter construction</span>
+<span class=sd>    It is allowed to overwrite the original file</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>markdown_api</span> <span class=o>=</span> <span class=n>MarkdownAPI</span><span class=p>()</span>
+    <span class=n>header</span><span class=p>,</span> <span class=n>content</span> <span class=o>=</span> <span class=n>markdown_api</span><span class=o>.</span><span class=n>processor</span><span class=o>.</span><span class=n>process_markdown</span><span class=p>(</span><span class=n>md_in</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span> <span class=o>=</span> <span class=n>header</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span> <span class=o>=</span> <span class=n>content</span><span class=o>.</span><span class=n>delete_nodes_text</span><span class=p>(</span><span class=n>cull_list</span><span class=p>,</span> <span class=n>strict_match</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>write_out</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.exists class="doc doc-heading"> <code class="highlight language-python"><span class=n>exists</span><span class=p>()</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.exists class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Check if the file already exists.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>exists</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check if the file already exists.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.get_lines class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_lines</span><span class=p>()</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.get_lines class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the current lines in the file.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_lines</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the current lines in the file.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.get_text class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_text</span><span class=p>()</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.get_text class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the text as currently written.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_text</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the text as currently written.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.new_header class="doc doc-heading"> <code class="highlight language-python"><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.new_header class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add new header.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>new_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>add_new_line_after_header</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add new header.&quot;&quot;&quot;</span>
+    <span class=c1># headers might be separated by blank lines</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;#&#39;</span> <span class=o>*</span> <span class=n>level</span> <span class=o>+</span> <span class=s1>&#39; &#39;</span> <span class=o>+</span> <span class=n>title</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>add_new_line_after_header</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.new_hr class="doc doc-heading"> <code class="highlight language-python"><span class=n>new_hr</span><span class=p>()</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.new_hr class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add horizontal rule.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>new_hr</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add horizontal rule.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SSP_MD_HRULE_LINE</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.new_line class="doc doc-heading"> <code class="highlight language-python"><span class=n>new_line</span><span class=p>(</span><span class=n>line</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.new_line class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add a line of text to the output.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>new_line</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add a line of text to the output.&quot;&quot;&quot;</span>
+    <span class=c1># prevent double empty lines</span>
+    <span class=n>out_line</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span> <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_blank</span><span class=p>(</span><span class=n>line</span><span class=p>)</span> <span class=k>else</span> <span class=bp>self</span><span class=o>.</span><span class=n>_current_indent_space</span><span class=p>()</span> <span class=o>+</span> <span class=n>line</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prev_blank_line</span><span class=p>()</span> <span class=ow>and</span> <span class=n>out_line</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+        <span class=k>return</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_add_line_raw</span><span class=p>(</span><span class=n>out_line</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.new_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>new_list</span><span class=p>(</span><span class=n>list_</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.new_list class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add a list to the markdown.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>new_list</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>list_</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add a list to the markdown.&quot;&quot;&quot;</span>
+    <span class=c1># in general this is a list of lists</span>
+    <span class=c1># if string just write it out</span>
+    <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>list_</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_blank</span><span class=p>(</span><span class=n>list_</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;- &#39;</span> <span class=o>+</span> <span class=n>list_</span><span class=p>)</span>
+    <span class=c1># else it is a sublist so indent</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_indent_level</span><span class=p>(</span><span class=mi>1</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>list_</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_indent_level</span> <span class=o>&lt;=</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>new_list</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.new_paragraph class="doc doc-heading"> <code class="highlight language-python"><span class=n>new_paragraph</span><span class=p>()</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.new_paragraph class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Start a new paragraph.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>new_paragraph</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Start a new paragraph.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.new_paraline class="doc doc-heading"> <code class="highlight language-python"><span class=n>new_paraline</span><span class=p>(</span><span class=n>line</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.new_paraline class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add a paragraph and a line to output.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>new_paraline</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>line</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add a paragraph and a line to output.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.new_table class="doc doc-heading"> <code class="highlight language-python"><span class=n>new_table</span><span class=p>(</span><span class=n>table_list</span><span class=p>,</span> <span class=n>header</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.new_table class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add table to the markdown. All rows must be of equal length.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>new_table</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>table_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]],</span> <span class=n>header</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add table to the markdown. All rows must be of equal length.&quot;&quot;&quot;</span>
+    <span class=n>header_str</span> <span class=o>=</span> <span class=s1>&#39;| &#39;</span> <span class=o>+</span> <span class=s1>&#39; | &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>header</span><span class=p>)</span> <span class=o>+</span> <span class=s1>&#39; |&#39;</span>
+    <span class=n>sep_str</span> <span class=o>=</span> <span class=s1>&#39;|---&#39;</span> <span class=o>*</span> <span class=nb>len</span><span class=p>(</span><span class=n>header</span><span class=p>)</span> <span class=o>+</span> <span class=s1>&#39;|&#39;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>header_str</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>sep_str</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=n>table_list</span><span class=p>:</span>
+        <span class=n>row_str</span> <span class=o>=</span> <span class=s1>&#39;| &#39;</span> <span class=o>+</span> <span class=s1>&#39; | &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>row</span><span class=p>)</span> <span class=o>+</span> <span class=s1>&#39; |&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>row_str</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.set_indent_level class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_indent_level</span><span class=p>(</span><span class=n>level</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.set_indent_level class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set the current indent level.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_indent_level</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set the current indent level.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_indent_level</span> <span class=o>=</span> <span class=n>level</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.set_indent_step_size class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_indent_step_size</span><span class=p>(</span><span class=n>size</span><span class=p>)</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.set_indent_step_size class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set the indent step size in spaces.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_indent_step_size</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>size</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set the indent step size in spaces.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_indent_size</span> <span class=o>=</span> <span class=n>size</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.markdown.md_writer.MDWriter.write_out class="doc doc-heading"> <code class="highlight language-python"><span class=n>write_out</span><span class=p>()</span></code> <a href=#trestle.core.markdown.md_writer.MDWriter.write_out class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write out the markdown file.</p> <details class=quote> <summary>Source code in <code>trestle/core/markdown/md_writer.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write_out</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write out the markdown file.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_check_header</span><span class=p>()</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=o>.</span><span class=n>parent</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=p>,</span> <span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>f</span><span class=p>:</span>
+            <span class=c1># Make sure yaml header is written first</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>:</span>
+                <span class=n>f</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;---</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>()</span>
+                <span class=n>yaml</span><span class=o>.</span><span class=n>indent</span><span class=p>(</span><span class=n>mapping</span><span class=o>=</span><span class=mi>2</span><span class=p>,</span> <span class=n>sequence</span><span class=o>=</span><span class=mi>4</span><span class=p>,</span> <span class=n>offset</span><span class=o>=</span><span class=mi>2</span><span class=p>)</span>
+                <span class=n>yaml</span><span class=o>.</span><span class=n>dump</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>,</span> <span class=n>f</span><span class=p>)</span>
+                <span class=n>f</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;---</span><span class=se>\n\n</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=n>f</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>))</span>
+            <span class=c1># if last line has text it will need an extra \n at end</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lines</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]:</span>
+                <span class=n>f</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># insert helpful comments into the header happens after header is written out</span>
+        <span class=k>for</span> <span class=n>tag</span><span class=p>,</span> <span class=n>comment</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_header_comments_dict</span><span class=p>)</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>tag</span> <span class=ow>in</span> <span class=n>as_dict</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_yaml_header</span><span class=p>):</span>
+                <span class=n>file_utils</span><span class=o>.</span><span class=n>insert_text_in_file</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=p>,</span> <span class=n>tag</span><span class=p>,</span> <span class=n>comment</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>IOError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;md_writer error attempting to write out md file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error attempting to write out md file </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.markdown.md_writer-functions>Functions<a href=#trestle.core.markdown.md_writer-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/models/actions/index.html b/latest/reference/API/trestle/core/models/actions/index.html
new file mode 100644
index 000000000..49a9246d6
--- /dev/null
+++ b/latest/reference/API/trestle/core/models/actions/index.html
@@ -0,0 +1,1372 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.models.actions module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/actions/ rel=canonical><link href=../../markdown/md_writer/ rel=prev><link href=../elements/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.models.actions - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.models.actions - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.models.actions module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/actions.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/actions/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.models.actions - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.models.actions module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/actions.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.models.actions class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.models.actions </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31 checked> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.models.actions </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.models.actions </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.actions class=md-nav__link> <span class=md-ellipsis> actions </span> </a> <nav class=md-nav aria-label=actions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action class=md-nav__link> <span class=md-ellipsis> Action </span> </a> <nav class=md-nav aria-label=Action> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.__eq__ class=md-nav__link> <span class=md-ellipsis> __eq__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.get_type class=md-nav__link> <span class=md-ellipsis> get_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.has_executed class=md-nav__link> <span class=md-ellipsis> has_executed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.has_rollback class=md-nav__link> <span class=md-ellipsis> has_rollback </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.to_string class=md-nav__link> <span class=md-ellipsis> to_string </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType class=md-nav__link> <span class=md-ellipsis> ActionType </span> </a> <nav class=md-nav aria-label=ActionType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.CREATE_PATH class=md-nav__link> <span class=md-ellipsis> CREATE_PATH </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.REMOVE class=md-nav__link> <span class=md-ellipsis> REMOVE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.REMOVE_PATH class=md-nav__link> <span class=md-ellipsis> REMOVE_PATH </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.UPDATE class=md-nav__link> <span class=md-ellipsis> UPDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.WRITE class=md-nav__link> <span class=md-ellipsis> WRITE </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction class=md-nav__link> <span class=md-ellipsis> CreatePathAction </span> </a> <nav class=md-nav aria-label=CreatePathAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.get_created_paths class=md-nav__link> <span class=md-ellipsis> get_created_paths </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.get_trestle_project_root class=md-nav__link> <span class=md-ellipsis> get_trestle_project_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction class=md-nav__link> <span class=md-ellipsis> RemoveAction </span> </a> <nav class=md-nav aria-label=RemoveAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction class=md-nav__link> <span class=md-ellipsis> RemovePathAction </span> </a> <nav class=md-nav aria-label=RemovePathAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.get_trestle_project_root class=md-nav__link> <span class=md-ellipsis> get_trestle_project_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction class=md-nav__link> <span class=md-ellipsis> UpdateAction </span> </a> <nav class=md-nav aria-label=UpdateAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction class=md-nav__link> <span class=md-ellipsis> WriteAction </span> </a> <nav class=md-nav aria-label=WriteAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction class=md-nav__link> <span class=md-ellipsis> WriteFileAction </span> </a> <nav class=md-nav aria-label=WriteFileAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.actions class=md-nav__link> <span class=md-ellipsis> actions </span> </a> <nav class=md-nav aria-label=actions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action class=md-nav__link> <span class=md-ellipsis> Action </span> </a> <nav class=md-nav aria-label=Action> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.__eq__ class=md-nav__link> <span class=md-ellipsis> __eq__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.get_type class=md-nav__link> <span class=md-ellipsis> get_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.has_executed class=md-nav__link> <span class=md-ellipsis> has_executed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.has_rollback class=md-nav__link> <span class=md-ellipsis> has_rollback </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.Action.to_string class=md-nav__link> <span class=md-ellipsis> to_string </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType class=md-nav__link> <span class=md-ellipsis> ActionType </span> </a> <nav class=md-nav aria-label=ActionType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.CREATE_PATH class=md-nav__link> <span class=md-ellipsis> CREATE_PATH </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.REMOVE class=md-nav__link> <span class=md-ellipsis> REMOVE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.REMOVE_PATH class=md-nav__link> <span class=md-ellipsis> REMOVE_PATH </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.UPDATE class=md-nav__link> <span class=md-ellipsis> UPDATE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.ActionType.WRITE class=md-nav__link> <span class=md-ellipsis> WRITE </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction class=md-nav__link> <span class=md-ellipsis> CreatePathAction </span> </a> <nav class=md-nav aria-label=CreatePathAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.get_created_paths class=md-nav__link> <span class=md-ellipsis> get_created_paths </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.get_trestle_project_root class=md-nav__link> <span class=md-ellipsis> get_trestle_project_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.CreatePathAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction class=md-nav__link> <span class=md-ellipsis> RemoveAction </span> </a> <nav class=md-nav aria-label=RemoveAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemoveAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction class=md-nav__link> <span class=md-ellipsis> RemovePathAction </span> </a> <nav class=md-nav aria-label=RemovePathAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.get_trestle_project_root class=md-nav__link> <span class=md-ellipsis> get_trestle_project_root </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.RemovePathAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction class=md-nav__link> <span class=md-ellipsis> UpdateAction </span> </a> <nav class=md-nav aria-label=UpdateAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.UpdateAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction class=md-nav__link> <span class=md-ellipsis> WriteAction </span> </a> <nav class=md-nav aria-label=WriteAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction class=md-nav__link> <span class=md-ellipsis> WriteFileAction </span> </a> <nav class=md-nav aria-label=WriteFileAction> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.actions.WriteFileAction.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.models.actions</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.models.actions class="doc doc-heading"> <code>trestle.core.models.actions</code> <a href=#trestle.core.models.actions class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Action wrapper of a command.</p> <div class="doc doc-children"> <h3 id=trestle.core.models.actions-attributes>Attributes<a href=#trestle.core.models.actions-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.models.actions.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.models.actions.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.models.actions-classes>Classes<a href=#trestle.core.models.actions-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.actions.Action class="doc doc-heading"> <code>Action</code> <a href=#trestle.core.models.actions.Action class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=abc.ABC>ABC</span></code></p> <p>Action wrapper of a command.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Action</span><span class=p>(</span><span class=n>ABC</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Action wrapper of a command.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>action_type</span><span class=p>:</span> <span class=n>ActionType</span><span class=p>,</span> <span class=n>has_rollback</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize an base action.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=p>:</span> <span class=n>ActionType</span> <span class=o>=</span> <span class=n>action_type</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_has_rollback</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=n>has_rollback</span>
+
+        <span class=c1># child class must set this flag once it executes</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_has_executed</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=k>def</span> <span class=nf>to_string</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return a string representation.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=fm>__str__</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>get_type</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ActionType</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the action type.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_type</span>
+
+    <span class=k>def</span> <span class=nf>_mark_executed</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set flag that the action has been executed.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_has_executed</span> <span class=o>=</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>has_executed</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return if the action has been executed.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_has_executed</span>
+
+    <span class=k>def</span> <span class=nf>_mark_rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set flag that the action has been rollbacked.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_has_executed</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=k>def</span> <span class=nf>has_rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return if rollback of the action is possible.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_has_rollback</span>
+
+    <span class=k>def</span> <span class=fm>__eq__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>other</span><span class=p>:</span> <span class=nb>object</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check that two actions are equal.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>other</span><span class=p>,</span> <span class=n>Action</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_type</span><span class=p>()</span> <span class=ow>is</span> <span class=ow>not</span> <span class=n>other</span><span class=o>.</span><span class=n>get_type</span><span class=p>():</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=n>is_eq</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span> <span class=o>==</span> <span class=n>other</span><span class=o>.</span><span class=vm>__dict__</span>
+        <span class=k>return</span> <span class=n>is_eq</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.actions.Action-functions>Functions<a href=#trestle.core.models.actions.Action-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.Action.__eq__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__eq__</span><span class=p>(</span><span class=n>other</span><span class=p>)</span></code> <a href=#trestle.core.models.actions.Action.__eq__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Check that two actions are equal.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span>
+<span class=normal>98</span>
+<span class=normal>99</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__eq__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>other</span><span class=p>:</span> <span class=nb>object</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check that two actions are equal.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>other</span><span class=p>,</span> <span class=n>Action</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_type</span><span class=p>()</span> <span class=ow>is</span> <span class=ow>not</span> <span class=n>other</span><span class=o>.</span><span class=n>get_type</span><span class=p>():</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=n>is_eq</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__dict__</span> <span class=o>==</span> <span class=n>other</span><span class=o>.</span><span class=vm>__dict__</span>
+    <span class=k>return</span> <span class=n>is_eq</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.Action.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>action_type</span><span class=p>,</span> <span class=n>has_rollback</span><span class=p>)</span></code> <a href=#trestle.core.models.actions.Action.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize an base action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>action_type</span><span class=p>:</span> <span class=n>ActionType</span><span class=p>,</span> <span class=n>has_rollback</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize an base action.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=p>:</span> <span class=n>ActionType</span> <span class=o>=</span> <span class=n>action_type</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_has_rollback</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=n>has_rollback</span>
+
+    <span class=c1># child class must set this flag once it executes</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_has_executed</span> <span class=o>=</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.Action.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.core.models.actions.Action.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.Action.get_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_type</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.Action.get_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the action type.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_type</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ActionType</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the action type.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_type</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.Action.has_executed class="doc doc-heading"> <code class="highlight language-python"><span class=n>has_executed</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.Action.has_executed class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return if the action has been executed.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>has_executed</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return if the action has been executed.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_has_executed</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.Action.has_rollback class="doc doc-heading"> <code class="highlight language-python"><span class=n>has_rollback</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.Action.has_rollback class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return if rollback of the action is possible.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>has_rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return if rollback of the action is possible.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_has_rollback</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.Action.rollback class="doc doc-heading"> <code class="highlight language-python"><span class=n>rollback</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.core.models.actions.Action.rollback class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Rollback the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.Action.to_string class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_string</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.Action.to_string class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return a string representation.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_string</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return a string representation.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=fm>__str__</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.actions.ActionType class="doc doc-heading"> <code>ActionType</code> <a href=#trestle.core.models.actions.ActionType class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Action type enum for different action type.</p> <p>File system related actions have code like 1<em> Model processing related actions have code like 2</em></p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ActionType</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Action type enum for different action type.</span>
+
+<span class=sd>    File system related actions have code like 1*</span>
+<span class=sd>    Model processing related actions have code like 2*</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=c1># create a file or directory path</span>
+    <span class=n>CREATE_PATH</span> <span class=o>=</span> <span class=mi>10</span>
+
+    <span class=c1># remove a file or directory path</span>
+    <span class=n>REMOVE_PATH</span> <span class=o>=</span> <span class=mi>12</span>
+
+    <span class=c1># write element to a destination file or stream</span>
+    <span class=n>WRITE</span> <span class=o>=</span> <span class=mi>11</span>
+
+    <span class=c1># update or add the element at the path</span>
+    <span class=n>UPDATE</span> <span class=o>=</span> <span class=mi>20</span>
+
+    <span class=c1># remove the element at the path</span>
+    <span class=n>REMOVE</span> <span class=o>=</span> <span class=mi>21</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.actions.ActionType-attributes>Attributes<a href=#trestle.core.models.actions.ActionType-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.actions.ActionType.CREATE_PATH class="doc doc-heading"> <code class="highlight language-python"><span class=n>CREATE_PATH</span> <span class=o>=</span> <span class=mi>10</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.actions.ActionType.CREATE_PATH class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.actions.ActionType.REMOVE class="doc doc-heading"> <code class="highlight language-python"><span class=n>REMOVE</span> <span class=o>=</span> <span class=mi>21</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.actions.ActionType.REMOVE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.actions.ActionType.REMOVE_PATH class="doc doc-heading"> <code class="highlight language-python"><span class=n>REMOVE_PATH</span> <span class=o>=</span> <span class=mi>12</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.actions.ActionType.REMOVE_PATH class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.actions.ActionType.UPDATE class="doc doc-heading"> <code class="highlight language-python"><span class=n>UPDATE</span> <span class=o>=</span> <span class=mi>20</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.actions.ActionType.UPDATE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.actions.ActionType.WRITE class="doc doc-heading"> <code class="highlight language-python"><span class=n>WRITE</span> <span class=o>=</span> <span class=mi>11</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.actions.ActionType.WRITE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.actions.CreatePathAction class="doc doc-heading"> <code>CreatePathAction</code> <a href=#trestle.core.models.actions.CreatePathAction class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.models.actions.Action href=#trestle.core.models.actions.Action>Action</a></code></p> <p>Create a file or directory path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CreatePathAction</span><span class=p>(</span><span class=n>Action</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create a file or directory path.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>sub_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>clear_content</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize a create path action.</span>
+
+<span class=sd>        It creates all the missing directories in the path.</span>
+<span class=sd>        If it is a file, then it also creates an empty file with the name provided</span>
+
+<span class=sd>        Arguments:</span>
+<span class=sd>            sub_path: this is the desired file or directory path that needs to be created under the project root</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>sub_path</span> <span class=o>=</span> <span class=n>sub_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>sub_path</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Sub path &quot;</span><span class=si>{</span><span class=n>sub_path</span><span class=si>}</span><span class=s1>&quot; should be child of a valid trestle project&#39;</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span> <span class=o>=</span> <span class=n>sub_path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=c1># variables for handling with file content</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_clear_content</span> <span class=o>=</span> <span class=n>clear_content</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_old_file_content</span> <span class=o>=</span> <span class=kc>None</span>
+
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>CREATE_PATH</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_trestle_project_root</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the trestle workspace root path.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span>
+
+    <span class=k>def</span> <span class=nf>get_created_paths</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the list of paths that were created after being executed.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+        <span class=c1># find the start of the sub_path relative to trestle project root</span>
+        <span class=n>cur_index</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+
+        <span class=c1># loop through the sub_path parts and create as necessary</span>
+        <span class=n>cur_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span>
+        <span class=k>while</span> <span class=n>cur_index</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+            <span class=n>part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=n>cur_index</span><span class=p>]</span>
+
+            <span class=c1># create a path relative to the current</span>
+            <span class=c1># it starts with the project root, so we shall always create</span>
+            <span class=c1># sub directories or files relative to the project root</span>
+            <span class=n>cur_path</span> <span class=o>=</span> <span class=n>cur_path</span> <span class=o>/</span> <span class=n>part</span>  <span class=c1># type: ignore</span>
+
+            <span class=c1># create the sub_path file or directory if it does not exists already</span>
+            <span class=k>if</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>suffix</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>  <span class=c1># suffix will denote a file</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                    <span class=c1># create file</span>
+                    <span class=n>cur_path</span><span class=o>.</span><span class=n>touch</span><span class=p>()</span>
+
+                    <span class=c1># add in the list for rollback</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>cur_path</span><span class=p>)</span>
+                <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_clear_content</span><span class=p>:</span>
+                    <span class=c1># read file content for rollback</span>
+                    <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=n>cur_path</span><span class=p>,</span> <span class=s1>&#39;r+&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>fp</span><span class=p>:</span>
+                        <span class=c1># read all content</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>_old_file_content</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>read</span><span class=p>()</span>
+
+                        <span class=c1># clear file content</span>
+                        <span class=n>fp</span><span class=o>.</span><span class=n>truncate</span><span class=p>(</span><span class=mi>0</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                    <span class=c1># create directory</span>
+                    <span class=n>cur_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>()</span>
+
+                    <span class=c1># add in the list for rollback</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>cur_path</span><span class=p>)</span>
+
+            <span class=c1># move to the next part of the sub_path parts</span>
+            <span class=n>cur_index</span> <span class=o>=</span> <span class=n>cur_index</span> <span class=o>+</span> <span class=mi>1</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>cur_path</span> <span class=ow>in</span> <span class=nb>reversed</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                        <span class=k>if</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                            <span class=n>cur_path</span><span class=o>.</span><span class=n>unlink</span><span class=p>()</span>
+                        <span class=k>elif</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                            <span class=n>cur_path</span><span class=o>.</span><span class=n>rmdir</span><span class=p>()</span>
+
+                <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=o>.</span><span class=n>clear</span><span class=p>()</span>
+
+            <span class=c1># rollback the content of a file if required</span>
+            <span class=c1># we should be here only if there were no path created and the sub_part already existed</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>()</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_clear_content</span> <span class=ow>is</span> <span class=kc>True</span><span class=p>:</span>
+                <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_old_file_content</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>,</span> <span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>fp</span><span class=p>:</span>
+                        <span class=n>fp</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_old_file_content</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.actions.CreatePathAction-functions>Functions<a href=#trestle.core.models.actions.CreatePathAction-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.CreatePathAction.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>sub_path</span><span class=p>,</span> <span class=n>clear_content</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.models.actions.CreatePathAction.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize a create path action.</p> <p>It creates all the missing directories in the path. If it is a file, then it also creates an empty file with the name provided</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>sub_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>this is the desired file or directory path that needs to be created under the project root</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>sub_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>clear_content</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize a create path action.</span>
+
+<span class=sd>    It creates all the missing directories in the path.</span>
+<span class=sd>    If it is a file, then it also creates an empty file with the name provided</span>
+
+<span class=sd>    Arguments:</span>
+<span class=sd>        sub_path: this is the desired file or directory path that needs to be created under the project root</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>sub_path</span> <span class=o>=</span> <span class=n>sub_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>sub_path</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Sub path &quot;</span><span class=si>{</span><span class=n>sub_path</span><span class=si>}</span><span class=s1>&quot; should be child of a valid trestle project&#39;</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span> <span class=o>=</span> <span class=n>sub_path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=c1># variables for handling with file content</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_clear_content</span> <span class=o>=</span> <span class=n>clear_content</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_old_file_content</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>CREATE_PATH</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.CreatePathAction.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.CreatePathAction.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return string representation.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.CreatePathAction.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.CreatePathAction.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+    <span class=c1># find the start of the sub_path relative to trestle project root</span>
+    <span class=n>cur_index</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+
+    <span class=c1># loop through the sub_path parts and create as necessary</span>
+    <span class=n>cur_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span>
+    <span class=k>while</span> <span class=n>cur_index</span> <span class=o>&lt;</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+        <span class=n>part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=n>cur_index</span><span class=p>]</span>
+
+        <span class=c1># create a path relative to the current</span>
+        <span class=c1># it starts with the project root, so we shall always create</span>
+        <span class=c1># sub directories or files relative to the project root</span>
+        <span class=n>cur_path</span> <span class=o>=</span> <span class=n>cur_path</span> <span class=o>/</span> <span class=n>part</span>  <span class=c1># type: ignore</span>
+
+        <span class=c1># create the sub_path file or directory if it does not exists already</span>
+        <span class=k>if</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>suffix</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>  <span class=c1># suffix will denote a file</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=c1># create file</span>
+                <span class=n>cur_path</span><span class=o>.</span><span class=n>touch</span><span class=p>()</span>
+
+                <span class=c1># add in the list for rollback</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>cur_path</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_clear_content</span><span class=p>:</span>
+                <span class=c1># read file content for rollback</span>
+                <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=n>cur_path</span><span class=p>,</span> <span class=s1>&#39;r+&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>fp</span><span class=p>:</span>
+                    <span class=c1># read all content</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_old_file_content</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>read</span><span class=p>()</span>
+
+                    <span class=c1># clear file content</span>
+                    <span class=n>fp</span><span class=o>.</span><span class=n>truncate</span><span class=p>(</span><span class=mi>0</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=c1># create directory</span>
+                <span class=n>cur_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>()</span>
+
+                <span class=c1># add in the list for rollback</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>cur_path</span><span class=p>)</span>
+
+        <span class=c1># move to the next part of the sub_path parts</span>
+        <span class=n>cur_index</span> <span class=o>=</span> <span class=n>cur_index</span> <span class=o>+</span> <span class=mi>1</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.CreatePathAction.get_created_paths class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_created_paths</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.CreatePathAction.get_created_paths class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the list of paths that were created after being executed.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_created_paths</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the list of paths that were created after being executed.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.CreatePathAction.get_trestle_project_root class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_trestle_project_root</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.CreatePathAction.get_trestle_project_root class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the trestle workspace root path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_trestle_project_root</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the trestle workspace root path.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.CreatePathAction.rollback class="doc doc-heading"> <code class="highlight language-python"><span class=n>rollback</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.CreatePathAction.rollback class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Rollback the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>cur_path</span> <span class=ow>in</span> <span class=nb>reversed</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                        <span class=n>cur_path</span><span class=o>.</span><span class=n>unlink</span><span class=p>()</span>
+                    <span class=k>elif</span> <span class=n>cur_path</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+                        <span class=n>cur_path</span><span class=o>.</span><span class=n>rmdir</span><span class=p>()</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>_created_paths</span><span class=o>.</span><span class=n>clear</span><span class=p>()</span>
+
+        <span class=c1># rollback the content of a file if required</span>
+        <span class=c1># we should be here only if there were no path created and the sub_part already existed</span>
+        <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>is_file</span><span class=p>()</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_clear_content</span> <span class=ow>is</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_old_file_content</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>,</span> <span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>fp</span><span class=p>:</span>
+                    <span class=n>fp</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_old_file_content</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.actions.RemoveAction class="doc doc-heading"> <code>RemoveAction</code> <a href=#trestle.core.models.actions.RemoveAction class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.models.actions.Action href=#trestle.core.models.actions.Action>Action</a></code></p> <p>Remove sub element at the element path in the source element.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RemoveAction</span><span class=p>(</span><span class=n>Action</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove sub element at the element path in the source element.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>src_element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>sub_element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize a remove element action.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>REMOVE</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=p>:</span> <span class=n>Element</span> <span class=o>=</span> <span class=n>src_element</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>:</span> <span class=n>ElementPath</span> <span class=o>=</span> <span class=n>sub_element_path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> element at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=si>}</span><span class=s1> from </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.actions.RemoveAction-functions>Functions<a href=#trestle.core.models.actions.RemoveAction-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.RemoveAction.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>src_element</span><span class=p>,</span> <span class=n>sub_element_path</span><span class=p>)</span></code> <a href=#trestle.core.models.actions.RemoveAction.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize a remove element action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>src_element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>sub_element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize a remove element action.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>REMOVE</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=p>:</span> <span class=n>Element</span> <span class=o>=</span> <span class=n>src_element</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>:</span> <span class=n>ElementPath</span> <span class=o>=</span> <span class=n>sub_element_path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.RemoveAction.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.RemoveAction.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return string representation.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> element at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=si>}</span><span class=s1> from </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.RemoveAction.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.RemoveAction.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.RemoveAction.rollback class="doc doc-heading"> <code class="highlight language-python"><span class=n>rollback</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.RemoveAction.rollback class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Rollback the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_src_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.actions.RemovePathAction class="doc doc-heading"> <code>RemovePathAction</code> <a href=#trestle.core.models.actions.RemovePathAction class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.models.actions.Action href=#trestle.core.models.actions.Action>Action</a></code></p> <p>Remove a file or directory path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RemovePathAction</span><span class=p>(</span><span class=n>Action</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove a file or directory path.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>sub_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize a remove path action.</span>
+
+<span class=sd>        It removes the file or directory recursively into trash.</span>
+
+<span class=sd>        Arguments:</span>
+<span class=sd>            sub_path: this is the desired file or directory path that needs to be removed under the project root</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>sub_path</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Sub path must be of type pathlib.Path&#39;</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>sub_path</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Sub path &quot;</span><span class=si>{</span><span class=n>sub_path</span><span class=si>}</span><span class=s1>&quot; should be child of a valid trestle project.&#39;</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span> <span class=o>=</span> <span class=n>sub_path</span>
+
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>REMOVE_PATH</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_trestle_project_root</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the trestle workspace root path.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;path </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=si>}</span><span class=s1> does not exist in remove path action - ignoring.&#39;</span><span class=p>)</span>
+
+        <span class=n>trash</span><span class=o>.</span><span class=n>store</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+        <span class=c1># check if parent folder is empty and if so delete</span>
+        <span class=n>parent_dir</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>dirname</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>))</span>
+        <span class=n>files</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>parent_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>())</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>files</span><span class=p>:</span>
+            <span class=n>trash</span><span class=o>.</span><span class=n>store</span><span class=p>(</span><span class=n>parent_dir</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+            <span class=n>trash_path</span> <span class=o>=</span> <span class=n>trash</span><span class=o>.</span><span class=n>to_trash_path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>trash_path</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>or</span> <span class=n>trash_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>is</span> <span class=kc>False</span><span class=p>:</span>
+                <span class=c1># FIXME suppress file contents not found message til trash/rollback behavior is fixed.  # issue 412</span>
+                <span class=k>return</span>
+            <span class=n>trash</span><span class=o>.</span><span class=n>recover</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.actions.RemovePathAction-functions>Functions<a href=#trestle.core.models.actions.RemovePathAction-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.RemovePathAction.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>sub_path</span><span class=p>)</span></code> <a href=#trestle.core.models.actions.RemovePathAction.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize a remove path action.</p> <p>It removes the file or directory recursively into trash.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>sub_path</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>this is the desired file or directory path that needs to be removed under the project root</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>sub_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize a remove path action.</span>
+
+<span class=sd>    It removes the file or directory recursively into trash.</span>
+
+<span class=sd>    Arguments:</span>
+<span class=sd>        sub_path: this is the desired file or directory path that needs to be removed under the project root</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>sub_path</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Sub path must be of type pathlib.Path&#39;</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>extract_trestle_project_root</span><span class=p>(</span><span class=n>sub_path</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Sub path &quot;</span><span class=si>{</span><span class=n>sub_path</span><span class=si>}</span><span class=s1>&quot; should be child of a valid trestle project.&#39;</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span> <span class=o>=</span> <span class=n>sub_path</span>
+
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>REMOVE_PATH</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.RemovePathAction.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.RemovePathAction.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return string representation.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.RemovePathAction.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.RemovePathAction.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;path </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=si>}</span><span class=s1> does not exist in remove path action - ignoring.&#39;</span><span class=p>)</span>
+
+    <span class=n>trash</span><span class=o>.</span><span class=n>store</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+    <span class=c1># check if parent folder is empty and if so delete</span>
+    <span class=n>parent_dir</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>dirname</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>))</span>
+    <span class=n>files</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>parent_dir</span><span class=o>.</span><span class=n>iterdir</span><span class=p>())</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>files</span><span class=p>:</span>
+        <span class=n>trash</span><span class=o>.</span><span class=n>store</span><span class=p>(</span><span class=n>parent_dir</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.RemovePathAction.get_trestle_project_root class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_trestle_project_root</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.RemovePathAction.get_trestle_project_root class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the trestle workspace root path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_trestle_project_root</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the trestle workspace root path.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_project_root</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.RemovePathAction.rollback class="doc doc-heading"> <code class="highlight language-python"><span class=n>rollback</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.RemovePathAction.rollback class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Rollback the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+        <span class=n>trash_path</span> <span class=o>=</span> <span class=n>trash</span><span class=o>.</span><span class=n>to_trash_path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>trash_path</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>or</span> <span class=n>trash_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>is</span> <span class=kc>False</span><span class=p>:</span>
+            <span class=c1># FIXME suppress file contents not found message til trash/rollback behavior is fixed.  # issue 412</span>
+            <span class=k>return</span>
+        <span class=n>trash</span><span class=o>.</span><span class=n>recover</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.actions.UpdateAction class="doc doc-heading"> <code>UpdateAction</code> <a href=#trestle.core.models.actions.UpdateAction class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.models.actions.Action href=#trestle.core.models.actions.Action>Action</a></code></p> <p>Update element at the element path in the destination element with the source element.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>UpdateAction</span><span class=p>(</span><span class=n>Action</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Update element at the element path in the destination element with the source element.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>sub_element</span><span class=p>,</span> <span class=n>dest_element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>sub_element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize an add element action.</span>
+
+<span class=sd>        Sub element can be OscalBaseModel, Element, list or None</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>UPDATE</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>Element</span><span class=o>.</span><span class=n>is_allowed_sub_element_type</span><span class=p>(</span><span class=n>sub_element</span><span class=p>):</span>
+            <span class=n>allowed_types</span> <span class=o>=</span> <span class=n>Element</span><span class=o>.</span><span class=n>get_allowed_sub_element_types</span><span class=p>()</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Sub element &quot;</span><span class=si>{</span><span class=n>sub_element</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1> is not a allowed sub element types in &quot;</span><span class=si>{</span><span class=n>allowed_types</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+            <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_sub_element</span> <span class=o>=</span> <span class=n>sub_element</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=p>:</span> <span class=n>Element</span> <span class=o>=</span> <span class=n>dest_element</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>:</span> <span class=n>ElementPath</span> <span class=o>=</span> <span class=n>sub_element_path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_element</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_model_obj</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1> to </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=si>}</span><span class=s1> at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.actions.UpdateAction-functions>Functions<a href=#trestle.core.models.actions.UpdateAction-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.UpdateAction.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>sub_element</span><span class=p>,</span> <span class=n>dest_element</span><span class=p>,</span> <span class=n>sub_element_path</span><span class=p>)</span></code> <a href=#trestle.core.models.actions.UpdateAction.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize an add element action.</p> <p>Sub element can be OscalBaseModel, Element, list or None</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>sub_element</span><span class=p>,</span> <span class=n>dest_element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>sub_element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize an add element action.</span>
+
+<span class=sd>    Sub element can be OscalBaseModel, Element, list or None</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>UPDATE</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>Element</span><span class=o>.</span><span class=n>is_allowed_sub_element_type</span><span class=p>(</span><span class=n>sub_element</span><span class=p>):</span>
+        <span class=n>allowed_types</span> <span class=o>=</span> <span class=n>Element</span><span class=o>.</span><span class=n>get_allowed_sub_element_types</span><span class=p>()</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Sub element &quot;</span><span class=si>{</span><span class=n>sub_element</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1> is not a allowed sub element types in &quot;</span><span class=si>{</span><span class=n>allowed_types</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+        <span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_sub_element</span> <span class=o>=</span> <span class=n>sub_element</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=p>:</span> <span class=n>Element</span> <span class=o>=</span> <span class=n>dest_element</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>:</span> <span class=n>ElementPath</span> <span class=o>=</span> <span class=n>sub_element_path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.UpdateAction.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.UpdateAction.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return string representation.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_model_obj</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1> to </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=si>}</span><span class=s1> at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.UpdateAction.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.UpdateAction.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sub_element</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.UpdateAction.rollback class="doc doc-heading"> <code class="highlight language-python"><span class=n>rollback</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.UpdateAction.rollback class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Rollback the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_dest_element</span><span class=o>.</span><span class=n>set_at</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_sub_element_path</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prev_sub_element</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.actions.WriteAction class="doc doc-heading"> <code>WriteAction</code> <a href=#trestle.core.models.actions.WriteAction class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.models.actions.Action href=#trestle.core.models.actions.Action>Action</a></code></p> <p>Write the element to a destination stream.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>WriteAction</span><span class=p>(</span><span class=n>Action</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write the element to a destination stream.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>writer</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>io</span><span class=o>.</span><span class=n>TextIOWrapper</span><span class=p>],</span> <span class=n>element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize an write file action.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>WRITE</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>writer</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=ow>not</span> <span class=nb>issubclass</span><span class=p>(</span><span class=n>io</span><span class=o>.</span><span class=n>TextIOWrapper</span><span class=p>,</span> <span class=n>writer</span><span class=o>.</span><span class=vm>__class__</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Writer must be of io.TextIOWrapper, given f</span><span class=si>{</span><span class=n>writer</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>io</span><span class=o>.</span><span class=n>TextIOWrapper</span><span class=p>]</span> <span class=o>=</span> <span class=n>writer</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_element</span><span class=p>:</span> <span class=n>Element</span> <span class=o>=</span> <span class=n>element</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=n>content_type</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>=</span> <span class=o>-</span><span class=mi>1</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>tell</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_is_writer_valid</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=nb>isinstance</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=p>,</span> <span class=n>io</span><span class=o>.</span><span class=n>TextIOWrapper</span><span class=p>)</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>closed</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>def</span> <span class=nf>_encode</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Encode the element to appropriate content type.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_element</span><span class=o>.</span><span class=n>to_yaml</span><span class=p>()</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_element</span><span class=o>.</span><span class=n>to_json</span><span class=p>()</span>
+
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid content type </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_content_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_element</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Element is empty and cannot write&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_writer_valid</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Writer is not provided or closed&#39;</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_encode</span><span class=p>())</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>flush</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_writer_valid</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Writer is not provided or closed&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>&lt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Last stream position is not available to rollback to&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>seek</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>truncate</span><span class=p>()</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>get_type</span><span class=p>()</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_element</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.actions.WriteAction-functions>Functions<a href=#trestle.core.models.actions.WriteAction-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.WriteAction.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>writer</span><span class=p>,</span> <span class=n>element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span></code> <a href=#trestle.core.models.actions.WriteAction.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize an write file action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>writer</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>io</span><span class=o>.</span><span class=n>TextIOWrapper</span><span class=p>],</span> <span class=n>element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize an write file action.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>ActionType</span><span class=o>.</span><span class=n>WRITE</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>writer</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=ow>not</span> <span class=nb>issubclass</span><span class=p>(</span><span class=n>io</span><span class=o>.</span><span class=n>TextIOWrapper</span><span class=p>,</span> <span class=n>writer</span><span class=o>.</span><span class=vm>__class__</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Writer must be of io.TextIOWrapper, given f</span><span class=si>{</span><span class=n>writer</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>io</span><span class=o>.</span><span class=n>TextIOWrapper</span><span class=p>]</span> <span class=o>=</span> <span class=n>writer</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_element</span><span class=p>:</span> <span class=n>Element</span> <span class=o>=</span> <span class=n>element</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=n>content_type</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>=</span> <span class=o>-</span><span class=mi>1</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>tell</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.WriteAction.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.WriteAction.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return string representation.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>get_type</span><span class=p>()</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_element</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.WriteAction.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.WriteAction.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_element</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Element is empty and cannot write&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_writer_valid</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Writer is not provided or closed&#39;</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_encode</span><span class=p>())</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>flush</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_executed</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.WriteAction.rollback class="doc doc-heading"> <code class="highlight language-python"><span class=n>rollback</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.WriteAction.rollback class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Rollback the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Rollback the action.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_writer_valid</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Writer is not provided or closed&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>&lt;</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Last stream position is not available to rollback to&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>has_executed</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>seek</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span><span class=o>.</span><span class=n>truncate</span><span class=p>()</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mark_rollback</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.actions.WriteFileAction class="doc doc-heading"> <code>WriteFileAction</code> <a href=#trestle.core.models.actions.WriteFileAction class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.models.actions.WriteAction href=#trestle.core.models.actions.WriteAction>WriteAction</a></code></p> <p>Write the element to a destination file.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>WriteFileAction</span><span class=p>(</span><span class=n>WriteAction</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write the element to a destination file.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize a write file action.</span>
+
+<span class=sd>        It opens the file in append mode. Therefore the file needs to exist even if it is a new file.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;file_path should be of type pathlib.Path&#39;</span><span class=p>)</span>
+
+        <span class=n>inferred_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>inferred_content_type</span> <span class=o>!=</span> <span class=n>content_type</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Mismatch between stated content type </span><span class=si>{</span><span class=n>content_type</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> and file path </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span> <span class=o>=</span> <span class=n>file_path</span>
+
+        <span class=c1># initialize super without writer for now</span>
+        <span class=c1># Note, execute and rollback sets the writer as appropriate</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1> does not exist&#39;</span><span class=p>)</span>
+
+        <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=p>,</span> <span class=s1>&#39;a+&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>writer</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>&lt;</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>=</span> <span class=n>writer</span><span class=o>.</span><span class=n>tell</span><span class=p>()</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>writer</span><span class=o>.</span><span class=n>seek</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span><span class=p>)</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span> <span class=o>=</span> <span class=n>writer</span>
+            <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the rollback action.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1> does not exist&#39;</span><span class=p>)</span>
+
+        <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=p>,</span> <span class=s1>&#39;a+&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>writer</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span> <span class=o>=</span> <span class=n>writer</span>
+            <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>rollback</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_element</span><span class=si>}</span><span class=s1> to &quot;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.actions.WriteFileAction-functions>Functions<a href=#trestle.core.models.actions.WriteFileAction-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.WriteFileAction.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span></code> <a href=#trestle.core.models.actions.WriteFileAction.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize a write file action.</p> <p>It opens the file in append mode. Therefore the file needs to exist even if it is a new file.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>element</span><span class=p>:</span> <span class=n>Element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize a write file action.</span>
+
+<span class=sd>    It opens the file in append mode. Therefore the file needs to exist even if it is a new file.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;file_path should be of type pathlib.Path&#39;</span><span class=p>)</span>
+
+    <span class=n>inferred_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>inferred_content_type</span> <span class=o>!=</span> <span class=n>content_type</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Mismatch between stated content type </span><span class=si>{</span><span class=n>content_type</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> and file path </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span> <span class=o>=</span> <span class=n>file_path</span>
+
+    <span class=c1># initialize super without writer for now</span>
+    <span class=c1># Note, execute and rollback sets the writer as appropriate</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.WriteFileAction.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.WriteFileAction.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return string representation.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return string representation.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_element</span><span class=si>}</span><span class=s1> to &quot;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.WriteFileAction.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.WriteFileAction.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the action.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1> does not exist&#39;</span><span class=p>)</span>
+
+    <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=p>,</span> <span class=s1>&#39;a+&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>writer</span><span class=p>:</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>&lt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span> <span class=o>=</span> <span class=n>writer</span><span class=o>.</span><span class=n>tell</span><span class=p>()</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>writer</span><span class=o>.</span><span class=n>seek</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_lastStreamPos</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span> <span class=o>=</span> <span class=n>writer</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.actions.WriteFileAction.rollback class="doc doc-heading"> <code class="highlight language-python"><span class=n>rollback</span><span class=p>()</span></code> <a href=#trestle.core.models.actions.WriteFileAction.rollback class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the rollback action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/actions.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the rollback action.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File at </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=si>}</span><span class=s1> does not exist&#39;</span><span class=p>)</span>
+
+    <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_file_path</span><span class=p>,</span> <span class=s1>&#39;a+&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>writer</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_writer</span> <span class=o>=</span> <span class=n>writer</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>rollback</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/models/elements/index.html b/latest/reference/API/trestle/core/models/elements/index.html
new file mode 100644
index 000000000..261bcbe20
--- /dev/null
+++ b/latest/reference/API/trestle/core/models/elements/index.html
@@ -0,0 +1,2045 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.models.elements module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/elements/ rel=canonical><link href=../actions/ rel=prev><link href=../file_content_type/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.models.elements - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.models.elements - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.models.elements module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/elements.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/elements/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.models.elements - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.models.elements module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/elements.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.models.elements class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.models.elements </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31 checked> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.models.elements </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.models.elements </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.elements class=md-nav__link> <span class=md-ellipsis> elements </span> </a> <nav class=md-nav aria-label=elements> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element class=md-nav__link> <span class=md-ellipsis> Element </span> </a> <nav class=md-nav aria-label=Element> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.IGNORE_WRAPPER_ALIAS class=md-nav__link> <span class=md-ellipsis> IGNORE_WRAPPER_ALIAS </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.__eq__ class=md-nav__link> <span class=md-ellipsis> __eq__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get_allowed_sub_element_types class=md-nav__link> <span class=md-ellipsis> get_allowed_sub_element_types </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get_at class=md-nav__link> <span class=md-ellipsis> get_at </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get_preceding_element class=md-nav__link> <span class=md-ellipsis> get_preceding_element </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get_sub_element_class class=md-nav__link> <span class=md-ellipsis> get_sub_element_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.is_allowed_sub_element_type class=md-nav__link> <span class=md-ellipsis> is_allowed_sub_element_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.set_at class=md-nav__link> <span class=md-ellipsis> set_at </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.to_json class=md-nav__link> <span class=md-ellipsis> to_json </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.to_yaml class=md-nav__link> <span class=md-ellipsis> to_yaml </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath class=md-nav__link> <span class=md-ellipsis> ElementPath </span> </a> <nav class=md-nav aria-label=ElementPath> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.PATH_SEPARATOR class=md-nav__link> <span class=md-ellipsis> PATH_SEPARATOR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.WILDCARD class=md-nav__link> <span class=md-ellipsis> WILDCARD </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.__eq__ class=md-nav__link> <span class=md-ellipsis> __eq__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.find_last_file_in_path class=md-nav__link> <span class=md-ellipsis> find_last_file_in_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_element_name class=md-nav__link> <span class=md-ellipsis> get_element_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_first class=md-nav__link> <span class=md-ellipsis> get_first </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_full class=md-nav__link> <span class=md-ellipsis> get_full </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_full_path_parts class=md-nav__link> <span class=md-ellipsis> get_full_path_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_last class=md-nav__link> <span class=md-ellipsis> get_last </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_obm_wrapped_type class=md-nav__link> <span class=md-ellipsis> get_obm_wrapped_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_parent class=md-nav__link> <span class=md-ellipsis> get_parent </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_preceding_path class=md-nav__link> <span class=md-ellipsis> get_preceding_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_type class=md-nav__link> <span class=md-ellipsis> get_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.is_multipart class=md-nav__link> <span class=md-ellipsis> is_multipart </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.make_absolute class=md-nav__link> <span class=md-ellipsis> make_absolute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.make_relative class=md-nav__link> <span class=md-ellipsis> make_relative </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.to_file_path class=md-nav__link> <span class=md-ellipsis> to_file_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.to_root_path class=md-nav__link> <span class=md-ellipsis> to_root_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.to_string class=md-nav__link> <span class=md-ellipsis> to_string </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.elements class=md-nav__link> <span class=md-ellipsis> elements </span> </a> <nav class=md-nav aria-label=elements> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element class=md-nav__link> <span class=md-ellipsis> Element </span> </a> <nav class=md-nav aria-label=Element> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.IGNORE_WRAPPER_ALIAS class=md-nav__link> <span class=md-ellipsis> IGNORE_WRAPPER_ALIAS </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.__eq__ class=md-nav__link> <span class=md-ellipsis> __eq__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get_allowed_sub_element_types class=md-nav__link> <span class=md-ellipsis> get_allowed_sub_element_types </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get_at class=md-nav__link> <span class=md-ellipsis> get_at </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get_preceding_element class=md-nav__link> <span class=md-ellipsis> get_preceding_element </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.get_sub_element_class class=md-nav__link> <span class=md-ellipsis> get_sub_element_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.is_allowed_sub_element_type class=md-nav__link> <span class=md-ellipsis> is_allowed_sub_element_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.set_at class=md-nav__link> <span class=md-ellipsis> set_at </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.to_json class=md-nav__link> <span class=md-ellipsis> to_json </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.Element.to_yaml class=md-nav__link> <span class=md-ellipsis> to_yaml </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath class=md-nav__link> <span class=md-ellipsis> ElementPath </span> </a> <nav class=md-nav aria-label=ElementPath> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.PATH_SEPARATOR class=md-nav__link> <span class=md-ellipsis> PATH_SEPARATOR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.WILDCARD class=md-nav__link> <span class=md-ellipsis> WILDCARD </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.__eq__ class=md-nav__link> <span class=md-ellipsis> __eq__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.find_last_file_in_path class=md-nav__link> <span class=md-ellipsis> find_last_file_in_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_element_name class=md-nav__link> <span class=md-ellipsis> get_element_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_first class=md-nav__link> <span class=md-ellipsis> get_first </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_full class=md-nav__link> <span class=md-ellipsis> get_full </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_full_path_parts class=md-nav__link> <span class=md-ellipsis> get_full_path_parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_last class=md-nav__link> <span class=md-ellipsis> get_last </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_obm_wrapped_type class=md-nav__link> <span class=md-ellipsis> get_obm_wrapped_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_parent class=md-nav__link> <span class=md-ellipsis> get_parent </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_preceding_path class=md-nav__link> <span class=md-ellipsis> get_preceding_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.get_type class=md-nav__link> <span class=md-ellipsis> get_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.is_multipart class=md-nav__link> <span class=md-ellipsis> is_multipart </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.make_absolute class=md-nav__link> <span class=md-ellipsis> make_absolute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.make_relative class=md-nav__link> <span class=md-ellipsis> make_relative </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.to_file_path class=md-nav__link> <span class=md-ellipsis> to_file_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.to_root_path class=md-nav__link> <span class=md-ellipsis> to_root_path </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements.ElementPath.to_string class=md-nav__link> <span class=md-ellipsis> to_string </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.elements-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.models.elements</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.models.elements class="doc doc-heading"> <code>trestle.core.models.elements</code> <a href=#trestle.core.models.elements class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Element wrapper of an OSCAL model element.</p> <div class="doc doc-children"> <h3 id=trestle.core.models.elements-attributes>Attributes<a href=#trestle.core.models.elements-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.models.elements.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.models.elements.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.models.elements-classes>Classes<a href=#trestle.core.models.elements-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.elements.Element class="doc doc-heading"> <code>Element</code> <a href=#trestle.core.models.elements.Element class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Element wrapper of an OSCAL model.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Element</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Element wrapper of an OSCAL model.&quot;&quot;&quot;</span>
+
+    <span class=n>IGNORE_WRAPPER_ALIAS</span> <span class=o>=</span> <span class=s1>&#39;__&#39;</span>
+
+    <span class=n>_allowed_sub_element_types</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;Element&#39;</span><span class=p>,</span> <span class=s1>&#39;OscalBaseModel&#39;</span><span class=p>,</span> <span class=s1>&#39;list&#39;</span><span class=p>,</span> <span class=s1>&#39;None&#39;</span><span class=p>,</span> <span class=s1>&#39;dict&#39;</span><span class=p>]</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>elem</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>wrapper_alias</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize an element wrapper.</span>
+
+<span class=sd>        wrapper_alias is the OSCAL alias for the given elem object and used for seriazation in to_json() method.</span>
+
+<span class=sd>        For example,</span>
+<span class=sd>         - List[Catalog.Group] element should have wrapper alias &#39;groups&#39;</span>
+<span class=sd>         - Catalog element should have wrapper alias &#39;catalog&#39;</span>
+
+<span class=sd>        wrapper_alias is deduced for collection type object</span>
+
+<span class=sd>        if wrapper_alias = IGNORE_WRAPPER_ALIAS, then it is ignored and assumed to be json-serializable during to_json()</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># FIXME: There are instances where elem is a list.</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=p>:</span> <span class=n>OscalBaseModel</span> <span class=o>=</span> <span class=n>elem</span>
+
+        <span class=k>if</span> <span class=n>wrapper_alias</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>wrapper_alias</span> <span class=o>!=</span> <span class=bp>self</span><span class=o>.</span><span class=n>IGNORE_WRAPPER_ALIAS</span><span class=p>:</span>
+            <span class=n>class_name</span> <span class=o>=</span> <span class=n>elem</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span>
+            <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>elem</span><span class=p>):</span>
+                <span class=n>class_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_singular_classname</span><span class=p>()</span>
+                <span class=k>if</span> <span class=n>class_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;wrapper_alias not found for a collection type object: </span><span class=si>{</span><span class=n>elem</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=p>)</span>
+            <span class=n>wrapper_alias</span> <span class=o>=</span> <span class=n>str_utils</span><span class=o>.</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>class_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_wrapper_alias</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>wrapper_alias</span>
+
+    <span class=k>def</span> <span class=nf>_get_singular_classname</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the inner class name for list or dict objects.&quot;&quot;&quot;</span>
+        <span class=c1># this assumes all items in list and all values in dict are same type</span>
+        <span class=n>class_name</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>root</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=p>,</span> <span class=s1>&#39;__root__&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>root</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>type_str</span> <span class=o>=</span> <span class=n>root</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span>
+            <span class=k>if</span> <span class=n>type_str</span> <span class=o>==</span> <span class=s1>&#39;list&#39;</span><span class=p>:</span>
+                <span class=n>class_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=o>.</span><span class=n>__root__</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span>
+            <span class=k>elif</span> <span class=n>type_str</span> <span class=o>==</span> <span class=s1>&#39;dict&#39;</span><span class=p>:</span>
+                <span class=n>class_name</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=o>.</span><span class=n>__root__</span><span class=o>.</span><span class=n>values</span><span class=p>())[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span>
+        <span class=k>return</span> <span class=n>class_name</span>
+
+    <span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>OscalBaseModel</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the model object.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span>
+
+    <span class=k>def</span> <span class=nf>_split_element_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Split the element path into root_model and remaing attr names.&quot;&quot;&quot;</span>
+        <span class=n>path_parts</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get</span><span class=p>()</span>
+        <span class=n>root_model</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>path_parts</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[</span><span class=mi>1</span><span class=p>:]</span>
+
+        <span class=k>return</span> <span class=n>root_model</span><span class=p>,</span> <span class=n>path_parts</span>
+
+    <span class=k>def</span> <span class=nf>get_at</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+               <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+               <span class=n>check_parent</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the element at the specified element path.</span>
+
+<span class=sd>        it will return the sub-model object at the path. Sub-model object</span>
+<span class=sd>        can be of type OscalBaseModel or List</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>element_path</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span>
+
+        <span class=c1># find the root-model and element path parts</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_split_element_path</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+        <span class=c1># TODO validate that self._elem is of same type as root_model</span>
+
+        <span class=c1># initialize the starting element for search</span>
+        <span class=n>elm</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span>
+        <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=s1>&#39;__root__&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=p>(</span><span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=o>.</span><span class=n>__root__</span><span class=p>,</span> <span class=nb>dict</span><span class=p>)</span> <span class=ow>or</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=o>.</span><span class=n>__root__</span><span class=p>,</span> <span class=nb>list</span><span class=p>)):</span>
+            <span class=n>elm</span> <span class=o>=</span> <span class=n>elm</span><span class=o>.</span><span class=n>__root__</span>
+
+        <span class=c1># if parent exists and does not end with wildcard, use the parent as the starting element for search</span>
+        <span class=k>if</span> <span class=n>check_parent</span> <span class=ow>and</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>(</span>
+        <span class=p>)</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=o>!=</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=n>elm_at</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>())</span>
+            <span class=k>if</span> <span class=n>elm_at</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleNotFoundError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid parent path </span><span class=si>{</span><span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>elm</span> <span class=o>=</span> <span class=n>elm_at</span>
+
+        <span class=c1># return the sub-element at the specified path</span>
+        <span class=k>for</span> <span class=n>attr</span> <span class=ow>in</span> <span class=n>path_parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>elm</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>break</span>
+
+            <span class=c1># process for wildcard and array indexes</span>
+
+            <span class=k>if</span> <span class=n>attr</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+                <span class=k>break</span>
+            <span class=k>elif</span> <span class=n>attr</span><span class=o>.</span><span class=n>isnumeric</span><span class=p>():</span>
+                <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=nb>list</span><span class=p>):</span>
+                    <span class=n>elm</span> <span class=o>=</span> <span class=n>elm</span><span class=p>[</span><span class=nb>int</span><span class=p>(</span><span class=n>attr</span><span class=p>)]</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=c1># index to a non list type should return None</span>
+                    <span class=k>return</span> <span class=kc>None</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>elm</span> <span class=o>=</span> <span class=n>elm</span><span class=o>.</span><span class=n>get_field_value_by_alias</span><span class=p>(</span><span class=n>attr</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>elm</span>
+
+    <span class=k>def</span> <span class=nf>get_preceding_element</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the preceding element in the path.&quot;&quot;&quot;</span>
+        <span class=n>preceding_path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_preceding_path</span><span class=p>()</span>
+        <span class=n>preceding_elm</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>preceding_path</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>preceding_elm</span>
+
+    <span class=k>def</span> <span class=nf>_get_sub_element_obj</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>sub_element</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert sub element into allowed model obj.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>is_allowed_sub_element_type</span><span class=p>(</span><span class=n>sub_element</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Sub element must be one of &quot;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>get_allowed_sub_element_types</span><span class=p>()</span><span class=si>}</span><span class=s1>&quot;, found &quot;</span><span class=si>{</span><span class=n>sub_element</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+            <span class=p>)</span>
+
+        <span class=n>model_obj</span> <span class=o>=</span> <span class=n>sub_element</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>sub_element</span><span class=p>,</span> <span class=n>Element</span><span class=p>):</span>
+            <span class=n>model_obj</span> <span class=o>=</span> <span class=n>sub_element</span><span class=o>.</span><span class=n>get</span><span class=p>()</span>
+
+        <span class=k>return</span> <span class=n>model_obj</span>
+
+    <span class=k>def</span> <span class=nf>set_at</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>,</span> <span class=n>sub_element</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;Element&#39;</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set a sub_element at the path in the current element.</span>
+
+<span class=sd>        Sub element can be Element, OscalBaseModel, list or None type</span>
+<span class=sd>        It returns the element itself so that chaining operation can be done such as</span>
+<span class=sd>            `element.set_at(path, sub-element).get()`.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># convert the element_path to ElementPath if needed</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+            <span class=n>element_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+        <span class=c1># convert sub-element to OscalBaseModel if needed</span>
+        <span class=n>model_obj</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_sub_element_obj</span><span class=p>(</span><span class=n>sub_element</span><span class=p>)</span>
+
+        <span class=c1># find the root-model and element path parts</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_split_element_path</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+        <span class=c1># TODO validate that self._elem is of same type as root_model</span>
+
+        <span class=c1># If wildcard is present, check the input type and determine the preceding element</span>
+        <span class=k>if</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=c1># validate the type is either list or OscalBaseModel</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=nb>list</span><span class=p>)</span> <span class=ow>and</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>):</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;The model object needs to be a List or OscalBaseModel for path with &quot;</span><span class=si>{</span><span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+                <span class=p>)</span>
+
+            <span class=c1># since wildcard * is there, we need to go one level up for preceding element in the path</span>
+            <span class=n>preceding_elm</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_preceding_element</span><span class=p>(</span><span class=n>element_path</span><span class=o>.</span><span class=n>get_preceding_path</span><span class=p>())</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># get the preceding element in the path</span>
+            <span class=n>preceding_elm</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_preceding_element</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>preceding_elm</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid sub element path </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1> with no valid preceding element&#39;</span><span class=p>)</span>
+
+        <span class=c1># check if it can be a valid sub_element of the parent</span>
+        <span class=n>sub_element_name</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_element_name</span><span class=p>()</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>preceding_elm</span><span class=p>,</span> <span class=n>sub_element_name</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>False</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Element &quot;</span><span class=si>{</span><span class=n>preceding_elm</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1>&quot; does not have the attribute &quot;</span><span class=si>{</span><span class=n>sub_element_name</span><span class=si>}</span><span class=s1>&quot; &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;of type &quot;</span><span class=si>{</span><span class=n>model_obj</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+            <span class=p>)</span>
+
+        <span class=c1># set the sub-element</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=nb>setattr</span><span class=p>(</span><span class=n>preceding_elm</span><span class=p>,</span> <span class=n>sub_element_name</span><span class=p>,</span> <span class=n>model_obj</span><span class=p>)</span>
+        <span class=k>except</span> <span class=n>ValidationError</span><span class=p>:</span>
+            <span class=n>sub_element_class</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_sub_element_class</span><span class=p>(</span><span class=n>preceding_elm</span><span class=p>,</span> <span class=n>sub_element_name</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Validation error: </span><span class=si>{</span><span class=n>sub_element_name</span><span class=si>}</span><span class=s1> is expected to be &quot;</span><span class=si>{</span><span class=n>sub_element_class</span><span class=si>}</span><span class=s1>&quot;, &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;but found &quot;</span><span class=si>{</span><span class=n>model_obj</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+            <span class=p>)</span>
+
+        <span class=c1># returning self will allow to do &#39;chaining&#39; of commands after set</span>
+        <span class=k>return</span> <span class=bp>self</span>
+
+    <span class=k>def</span> <span class=nf>to_yaml</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert into YAML string.&quot;&quot;&quot;</span>
+        <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+        <span class=n>yaml</span><span class=o>.</span><span class=n>default_flow_style</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=kn>from</span> <span class=nn>io</span> <span class=kn>import</span> <span class=n>StringIO</span>
+        <span class=n>string_stream</span> <span class=o>=</span> <span class=n>StringIO</span><span class=p>()</span>
+        <span class=n>yaml</span><span class=o>.</span><span class=n>dump</span><span class=p>(</span><span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>to_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=kc>False</span><span class=p>)),</span> <span class=n>string_stream</span><span class=p>)</span>
+        <span class=n>yaml_data</span> <span class=o>=</span> <span class=n>string_stream</span><span class=o>.</span><span class=n>getvalue</span><span class=p>()</span>
+        <span class=n>string_stream</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+
+        <span class=k>return</span> <span class=n>yaml_data</span>
+
+    <span class=k>def</span> <span class=nf>to_json</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>pretty</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert into JSON string.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_wrapper_alias</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>IGNORE_WRAPPER_ALIAS</span><span class=p>:</span>
+            <span class=n>json_data</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=n>pretty</span><span class=p>,</span> <span class=n>wrapped</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># Note before trying to edit this</span>
+            <span class=c1># This transient model allows self._elem not be an OscalBaseModel (e.g. a DICT or LIST)</span>
+            <span class=c1># typing need to be clarified.</span>
+            <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>):</span>
+                <span class=n>json_data</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=n>pretty</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>dynamic_passer</span> <span class=o>=</span> <span class=p>{}</span>
+                <span class=n>dynamic_passer</span><span class=p>[</span><span class=s1>&#39;TransientField&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=o>.</span><span class=vm>__class__</span><span class=p>,</span> <span class=n>Field</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_wrapper_alias</span><span class=p>))</span>
+                <span class=n>wrapper_model</span> <span class=o>=</span> <span class=n>create_model</span><span class=p>(</span><span class=s1>&#39;TransientModel&#39;</span><span class=p>,</span> <span class=n>__base__</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=o>**</span><span class=n>dynamic_passer</span><span class=p>)</span>
+                <span class=n>wrapped_model</span> <span class=o>=</span> <span class=n>wrapper_model</span><span class=o>.</span><span class=n>construct</span><span class=p>(</span><span class=o>**</span><span class=p>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_wrapper_alias</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=p>})</span>
+                <span class=n>json_data</span> <span class=o>=</span> <span class=n>wrapped_model</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=n>pretty</span><span class=p>,</span> <span class=n>wrapped</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>json_data</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>get_sub_element_class</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>parent_elm</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>sub_element_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the class of the sub-element.&quot;&quot;&quot;</span>
+        <span class=n>sub_element_class</span> <span class=o>=</span> <span class=n>parent_elm</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=n>sub_element_name</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span>
+        <span class=k>return</span> <span class=n>sub_element_class</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>get_allowed_sub_element_types</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the list of allowed sub element types.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>cls</span><span class=o>.</span><span class=n>_allowed_sub_element_types</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>is_allowed_sub_element_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>elm</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if is of allowed sub element type.&quot;&quot;&quot;</span>
+        <span class=c1># FIXME: The following logic does not use the _allowed_sub_element_types being defined for the class</span>
+        <span class=k>if</span> <span class=p>(</span><span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=n>Element</span><span class=p>)</span> <span class=ow>or</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>)</span> <span class=ow>or</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=nb>list</span><span class=p>)</span>
+                <span class=ow>or</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=nb>dict</span><span class=p>)</span> <span class=ow>or</span> <span class=n>elm</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return string representation of element.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>type</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=p>)</span><span class=o>.</span><span class=vm>__name__</span>
+
+    <span class=k>def</span> <span class=fm>__eq__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>other</span><span class=p>:</span> <span class=nb>object</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check that two elements are equal.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>other</span><span class=p>,</span> <span class=n>Element</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>()</span> <span class=o>==</span> <span class=n>other</span><span class=o>.</span><span class=n>get</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.elements.Element-attributes>Attributes<a href=#trestle.core.models.elements.Element-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.elements.Element.IGNORE_WRAPPER_ALIAS class="doc doc-heading"> <code class="highlight language-python"><span class=n>IGNORE_WRAPPER_ALIAS</span> <span class=o>=</span> <span class=s1>&#39;__&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.elements.Element.IGNORE_WRAPPER_ALIAS class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.models.elements.Element-functions>Functions<a href=#trestle.core.models.elements.Element-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.__eq__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__eq__</span><span class=p>(</span><span class=n>other</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.Element.__eq__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Check that two elements are equal.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__eq__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>other</span><span class=p>:</span> <span class=nb>object</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check that two elements are equal.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>other</span><span class=p>,</span> <span class=n>Element</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>()</span> <span class=o>==</span> <span class=n>other</span><span class=o>.</span><span class=n>get</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>elem</span><span class=p>,</span> <span class=n>wrapper_alias</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.Element.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize an element wrapper.</p> <p>wrapper_alias is the OSCAL alias for the given elem object and used for seriazation in to_json() method.</p> <p>For example, - List[Catalog.Group] element should have wrapper alias 'groups' - Catalog element should have wrapper alias 'catalog'</p> <p>wrapper_alias is deduced for collection type object</p> <p>if wrapper_alias = IGNORE_WRAPPER_ALIAS, then it is ignored and assumed to be json-serializable during to_json()</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>elem</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>wrapper_alias</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize an element wrapper.</span>
+
+<span class=sd>    wrapper_alias is the OSCAL alias for the given elem object and used for seriazation in to_json() method.</span>
+
+<span class=sd>    For example,</span>
+<span class=sd>     - List[Catalog.Group] element should have wrapper alias &#39;groups&#39;</span>
+<span class=sd>     - Catalog element should have wrapper alias &#39;catalog&#39;</span>
+
+<span class=sd>    wrapper_alias is deduced for collection type object</span>
+
+<span class=sd>    if wrapper_alias = IGNORE_WRAPPER_ALIAS, then it is ignored and assumed to be json-serializable during to_json()</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># FIXME: There are instances where elem is a list.</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=p>:</span> <span class=n>OscalBaseModel</span> <span class=o>=</span> <span class=n>elem</span>
+
+    <span class=k>if</span> <span class=n>wrapper_alias</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>wrapper_alias</span> <span class=o>!=</span> <span class=bp>self</span><span class=o>.</span><span class=n>IGNORE_WRAPPER_ALIAS</span><span class=p>:</span>
+        <span class=n>class_name</span> <span class=o>=</span> <span class=n>elem</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span>
+        <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>elem</span><span class=p>):</span>
+            <span class=n>class_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_singular_classname</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>class_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;wrapper_alias not found for a collection type object: </span><span class=si>{</span><span class=n>elem</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=p>)</span>
+        <span class=n>wrapper_alias</span> <span class=o>=</span> <span class=n>str_utils</span><span class=o>.</span><span class=n>classname_to_alias</span><span class=p>(</span><span class=n>class_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_wrapper_alias</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>wrapper_alias</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.Element.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return string representation of element.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return string representation of element.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>type</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=p>)</span><span class=o>.</span><span class=vm>__name__</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.get class="doc doc-heading"> <code class="highlight language-python"><span class=n>get</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.Element.get class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the model object.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>OscalBaseModel</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the model object.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.get_allowed_sub_element_types class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_allowed_sub_element_types</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.models.elements.Element.get_allowed_sub_element_types class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the list of allowed sub element types.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>get_allowed_sub_element_types</span><span class=p>(</span><span class=bp>cls</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the list of allowed sub element types.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>cls</span><span class=o>.</span><span class=n>_allowed_sub_element_types</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.get_at class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>check_parent</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.Element.get_at class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the element at the specified element path.</p> <p>it will return the sub-model object at the path. Sub-model object can be of type OscalBaseModel or List</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_at</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+           <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+           <span class=n>check_parent</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Union</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the element at the specified element path.</span>
+
+<span class=sd>    it will return the sub-model object at the path. Sub-model object</span>
+<span class=sd>    can be of type OscalBaseModel or List</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>element_path</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span>
+
+    <span class=c1># find the root-model and element path parts</span>
+    <span class=n>_</span><span class=p>,</span> <span class=n>path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_split_element_path</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+    <span class=c1># TODO validate that self._elem is of same type as root_model</span>
+
+    <span class=c1># initialize the starting element for search</span>
+    <span class=n>elm</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span>
+    <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=s1>&#39;__root__&#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=p>(</span><span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=o>.</span><span class=n>__root__</span><span class=p>,</span> <span class=nb>dict</span><span class=p>)</span> <span class=ow>or</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=o>.</span><span class=n>__root__</span><span class=p>,</span> <span class=nb>list</span><span class=p>)):</span>
+        <span class=n>elm</span> <span class=o>=</span> <span class=n>elm</span><span class=o>.</span><span class=n>__root__</span>
+
+    <span class=c1># if parent exists and does not end with wildcard, use the parent as the starting element for search</span>
+    <span class=k>if</span> <span class=n>check_parent</span> <span class=ow>and</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>(</span>
+    <span class=p>)</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=o>!=</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+        <span class=n>elm_at</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>())</span>
+        <span class=k>if</span> <span class=n>elm_at</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleNotFoundError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid parent path </span><span class=si>{</span><span class=n>element_path</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>elm</span> <span class=o>=</span> <span class=n>elm_at</span>
+
+    <span class=c1># return the sub-element at the specified path</span>
+    <span class=k>for</span> <span class=n>attr</span> <span class=ow>in</span> <span class=n>path_parts</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>elm</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>break</span>
+
+        <span class=c1># process for wildcard and array indexes</span>
+
+        <span class=k>if</span> <span class=n>attr</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=k>break</span>
+        <span class=k>elif</span> <span class=n>attr</span><span class=o>.</span><span class=n>isnumeric</span><span class=p>():</span>
+            <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=nb>list</span><span class=p>):</span>
+                <span class=n>elm</span> <span class=o>=</span> <span class=n>elm</span><span class=p>[</span><span class=nb>int</span><span class=p>(</span><span class=n>attr</span><span class=p>)]</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># index to a non list type should return None</span>
+                <span class=k>return</span> <span class=kc>None</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>elm</span> <span class=o>=</span> <span class=n>elm</span><span class=o>.</span><span class=n>get_field_value_by_alias</span><span class=p>(</span><span class=n>attr</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>elm</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.get_preceding_element class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_preceding_element</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.Element.get_preceding_element class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the preceding element in the path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_preceding_element</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the preceding element in the path.&quot;&quot;&quot;</span>
+    <span class=n>preceding_path</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_preceding_path</span><span class=p>()</span>
+    <span class=n>preceding_elm</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_at</span><span class=p>(</span><span class=n>preceding_path</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>preceding_elm</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.get_sub_element_class class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_sub_element_class</span><span class=p>(</span><span class=n>parent_elm</span><span class=p>,</span> <span class=n>sub_element_name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.models.elements.Element.get_sub_element_class class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the class of the sub-element.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>get_sub_element_class</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>parent_elm</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>sub_element_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the class of the sub-element.&quot;&quot;&quot;</span>
+    <span class=n>sub_element_class</span> <span class=o>=</span> <span class=n>parent_elm</span><span class=o>.</span><span class=n>__fields__</span><span class=p>[</span><span class=n>sub_element_name</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span>
+    <span class=k>return</span> <span class=n>sub_element_class</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.is_allowed_sub_element_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_allowed_sub_element_type</span><span class=p>(</span><span class=n>elm</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.models.elements.Element.is_allowed_sub_element_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Check if is of allowed sub element type.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>is_allowed_sub_element_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>elm</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check if is of allowed sub element type.&quot;&quot;&quot;</span>
+    <span class=c1># FIXME: The following logic does not use the _allowed_sub_element_types being defined for the class</span>
+    <span class=k>if</span> <span class=p>(</span><span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=n>Element</span><span class=p>)</span> <span class=ow>or</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>)</span> <span class=ow>or</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=nb>list</span><span class=p>)</span>
+            <span class=ow>or</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>elm</span><span class=p>,</span> <span class=nb>dict</span><span class=p>)</span> <span class=ow>or</span> <span class=n>elm</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.set_at class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_at</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>sub_element</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.Element.set_at class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set a sub_element at the path in the current element.</p> <p>Sub element can be Element, OscalBaseModel, list or None type It returns the element itself so that chaining operation can be done such as <code>element.set_at(path, sub-element).get()</code>.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_at</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=n>ElementPath</span><span class=p>,</span> <span class=n>sub_element</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;Element&#39;</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set a sub_element at the path in the current element.</span>
+
+<span class=sd>    Sub element can be Element, OscalBaseModel, list or None type</span>
+<span class=sd>    It returns the element itself so that chaining operation can be done such as</span>
+<span class=sd>        `element.set_at(path, sub-element).get()`.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># convert the element_path to ElementPath if needed</span>
+    <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=nb>str</span><span class=p>):</span>
+        <span class=n>element_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+    <span class=c1># convert sub-element to OscalBaseModel if needed</span>
+    <span class=n>model_obj</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_sub_element_obj</span><span class=p>(</span><span class=n>sub_element</span><span class=p>)</span>
+
+    <span class=c1># find the root-model and element path parts</span>
+    <span class=n>_</span><span class=p>,</span> <span class=n>path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_split_element_path</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+    <span class=c1># TODO validate that self._elem is of same type as root_model</span>
+
+    <span class=c1># If wildcard is present, check the input type and determine the preceding element</span>
+    <span class=k>if</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+        <span class=c1># validate the type is either list or OscalBaseModel</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=nb>list</span><span class=p>)</span> <span class=ow>and</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model_obj</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;The model object needs to be a List or OscalBaseModel for path with &quot;</span><span class=si>{</span><span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+            <span class=p>)</span>
+
+        <span class=c1># since wildcard * is there, we need to go one level up for preceding element in the path</span>
+        <span class=n>preceding_elm</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_preceding_element</span><span class=p>(</span><span class=n>element_path</span><span class=o>.</span><span class=n>get_preceding_path</span><span class=p>())</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=c1># get the preceding element in the path</span>
+        <span class=n>preceding_elm</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_preceding_element</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>preceding_elm</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid sub element path </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1> with no valid preceding element&#39;</span><span class=p>)</span>
+
+    <span class=c1># check if it can be a valid sub_element of the parent</span>
+    <span class=n>sub_element_name</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>get_element_name</span><span class=p>()</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=nb>hasattr</span><span class=p>(</span><span class=n>preceding_elm</span><span class=p>,</span> <span class=n>sub_element_name</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>False</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Element &quot;</span><span class=si>{</span><span class=n>preceding_elm</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1>&quot; does not have the attribute &quot;</span><span class=si>{</span><span class=n>sub_element_name</span><span class=si>}</span><span class=s1>&quot; &#39;</span>
+            <span class=sa>f</span><span class=s1>&#39;of type &quot;</span><span class=si>{</span><span class=n>model_obj</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+        <span class=p>)</span>
+
+    <span class=c1># set the sub-element</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=nb>setattr</span><span class=p>(</span><span class=n>preceding_elm</span><span class=p>,</span> <span class=n>sub_element_name</span><span class=p>,</span> <span class=n>model_obj</span><span class=p>)</span>
+    <span class=k>except</span> <span class=n>ValidationError</span><span class=p>:</span>
+        <span class=n>sub_element_class</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_sub_element_class</span><span class=p>(</span><span class=n>preceding_elm</span><span class=p>,</span> <span class=n>sub_element_name</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Validation error: </span><span class=si>{</span><span class=n>sub_element_name</span><span class=si>}</span><span class=s1> is expected to be &quot;</span><span class=si>{</span><span class=n>sub_element_class</span><span class=si>}</span><span class=s1>&quot;, &#39;</span>
+            <span class=sa>f</span><span class=s1>&#39;but found &quot;</span><span class=si>{</span><span class=n>model_obj</span><span class=o>.</span><span class=vm>__class__</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+        <span class=p>)</span>
+
+    <span class=c1># returning self will allow to do &#39;chaining&#39; of commands after set</span>
+    <span class=k>return</span> <span class=bp>self</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.to_json class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.Element.to_json class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert into JSON string.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_json</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>pretty</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert into JSON string.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_wrapper_alias</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>IGNORE_WRAPPER_ALIAS</span><span class=p>:</span>
+        <span class=n>json_data</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=n>pretty</span><span class=p>,</span> <span class=n>wrapped</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+
+    <span class=k>else</span><span class=p>:</span>
+        <span class=c1># Note before trying to edit this</span>
+        <span class=c1># This transient model allows self._elem not be an OscalBaseModel (e.g. a DICT or LIST)</span>
+        <span class=c1># typing need to be clarified.</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=p>,</span> <span class=n>OscalBaseModel</span><span class=p>):</span>
+            <span class=n>json_data</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=n>pretty</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>dynamic_passer</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=n>dynamic_passer</span><span class=p>[</span><span class=s1>&#39;TransientField&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=o>.</span><span class=vm>__class__</span><span class=p>,</span> <span class=n>Field</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_wrapper_alias</span><span class=p>))</span>
+            <span class=n>wrapper_model</span> <span class=o>=</span> <span class=n>create_model</span><span class=p>(</span><span class=s1>&#39;TransientModel&#39;</span><span class=p>,</span> <span class=n>__base__</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=o>**</span><span class=n>dynamic_passer</span><span class=p>)</span>
+            <span class=n>wrapped_model</span> <span class=o>=</span> <span class=n>wrapper_model</span><span class=o>.</span><span class=n>construct</span><span class=p>(</span><span class=o>**</span><span class=p>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_wrapper_alias</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_elem</span><span class=p>})</span>
+            <span class=n>json_data</span> <span class=o>=</span> <span class=n>wrapped_model</span><span class=o>.</span><span class=n>oscal_serialize_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=n>pretty</span><span class=p>,</span> <span class=n>wrapped</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>json_data</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.Element.to_yaml class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_yaml</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.Element.to_yaml class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert into YAML string.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_yaml</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert into YAML string.&quot;&quot;&quot;</span>
+    <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+    <span class=n>yaml</span><span class=o>.</span><span class=n>default_flow_style</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=kn>from</span> <span class=nn>io</span> <span class=kn>import</span> <span class=n>StringIO</span>
+    <span class=n>string_stream</span> <span class=o>=</span> <span class=n>StringIO</span><span class=p>()</span>
+    <span class=n>yaml</span><span class=o>.</span><span class=n>dump</span><span class=p>(</span><span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>to_json</span><span class=p>(</span><span class=n>pretty</span><span class=o>=</span><span class=kc>False</span><span class=p>)),</span> <span class=n>string_stream</span><span class=p>)</span>
+    <span class=n>yaml_data</span> <span class=o>=</span> <span class=n>string_stream</span><span class=o>.</span><span class=n>getvalue</span><span class=p>()</span>
+    <span class=n>string_stream</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+
+    <span class=k>return</span> <span class=n>yaml_data</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.elements.ElementPath class="doc doc-heading"> <code>ElementPath</code> <a href=#trestle.core.models.elements.ElementPath class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Element path wrapper of an element.</p> <p>This only allows a single wildcard '*' at the end to denote elements of an array or dict</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ElementPath</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Element path wrapper of an element.</span>
+
+<span class=sd>    This only allows a single wildcard &#39;*&#39; at the end to denote elements of an array or dict</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>PATH_SEPARATOR</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>ALIAS_PATH_SEPARATOR</span>
+
+    <span class=n>WILDCARD</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;*&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>parent_path</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=s1>&#39;ElementPath&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize an element wrapper.</span>
+
+<span class=sd>        It assumes the element path contains oscal field alias with hyphens only</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_parent_path</span> <span class=o>=</span> <span class=n>parent_path</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_parse</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+        <span class=c1># Initialize private variables for lazy processing and caching</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_element_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_preceding_path</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=s1>&#39;ElementPath&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_parse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Parse the element path and validate.&quot;&quot;&quot;</span>
+        <span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>element_path</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>part</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Invalid path &quot;</span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1>&quot; because there are empty path parts between &quot;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=si>}</span><span class=s1>&quot; &#39;</span>
+                    <span class=s1>&#39;or in the beginning&#39;</span>
+                <span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid path </span><span class=si>{</span><span class=n>element_path</span><span class=si>}</span><span class=s1> with wildcard.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>parts</span>
+
+    <span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the path parts as a list.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span>
+
+    <span class=k>def</span> <span class=nf>get_type</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_model</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span> <span class=n>use_parent</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the type of an element.</span>
+
+<span class=sd>        If possible the model type will be derived from one of the top level models,</span>
+<span class=sd>        otherwise a &#39;root model&#39; can be passed for situations where this is not possible.</span>
+
+<span class=sd>        This type path should *NOT* have wild cards in it. It *may* have* indices.</span>
+<span class=sd>        Valid Examples:</span>
+<span class=sd>            catalog.metadata</span>
+<span class=sd>            catalog.groups</span>
+<span class=sd>            catalog.groups.group</span>
+<span class=sd>            catalog</span>
+<span class=sd>            catalog.groups.0</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            root_model: An OscalBaseModel Type from which to base the approach on.</span>
+<span class=sd>            use_parent: Whether or not to normalise the full path across parent ElementPaths, default to not.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The type of the model whether or not it is an OscalBaseModel or not.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>effective_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>use_parent</span><span class=p>:</span>
+            <span class=n>effective_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>effective_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>root_model</span><span class=p>:</span>
+            <span class=c1># lookup root model from top level oscal models or fail</span>
+            <span class=n>prev_model</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_top_level_type_lookup</span><span class=p>(</span><span class=n>effective_path</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>prev_model</span> <span class=o>=</span> <span class=n>root_model</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>effective_path</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>prev_model</span>
+        <span class=c1># variables</span>
+        <span class=c1># for current_element_str in effective_path[1:]:</span>
+        <span class=k>for</span> <span class=n>current_element_str</span> <span class=ow>in</span> <span class=n>effective_path</span><span class=p>[</span><span class=mi>1</span><span class=p>:]:</span>
+            <span class=c1># Determine if the parent model is a collection.</span>
+            <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>prev_model</span><span class=p>):</span>
+                <span class=n>inner_model</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>prev_model</span><span class=p>)</span>
+                <span class=n>inner_class_name</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>inner_model</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+                <span class=c1># Assert that the current name fits an expected form.</span>
+                <span class=c1># Valid choices here are *, integer (for arrays) and the inner model alias</span>
+                <span class=k>if</span> <span class=p>(</span><span class=n>inner_class_name</span> <span class=o>==</span> <span class=n>current_element_str</span> <span class=ow>or</span> <span class=n>current_element_str</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>WILDCARD</span>
+                        <span class=ow>or</span> <span class=n>current_element_str</span><span class=o>.</span><span class=n>isnumeric</span><span class=p>()):</span>
+                    <span class=n>prev_model</span> <span class=o>=</span> <span class=n>inner_model</span>
+
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unexpected key in element path when finding type.&#39;</span><span class=p>)</span>
+
+            <span class=k>else</span><span class=p>:</span>
+                <span class=c1># Indices, * are not allowed on non-collection types</span>
+                <span class=k>if</span> <span class=n>current_element_str</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                        <span class=s1>&#39;Wild card in unexpected position when trying to find class type.&#39;</span>
+                        <span class=o>+</span> <span class=s1>&#39; Element path type lookup can only occur where a single type can be identified.&#39;</span>
+                    <span class=p>)</span>
+                <span class=n>prev_model</span> <span class=o>=</span> <span class=n>prev_model</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()[</span><span class=n>current_element_str</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span>
+        <span class=k>return</span> <span class=n>prev_model</span>
+
+    <span class=k>def</span> <span class=nf>get_obm_wrapped_type</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                             <span class=n>root_model</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+                             <span class=n>use_parent</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the type of the element. Wraps the collection type in an OscalBaseModel as a __root__ element.</span>
+
+<span class=sd>        This should principally be used for validating content.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            root_model: An OscalBaseModel Type from which to base the approach on.</span>
+<span class=sd>            use_parent: Whether or not to normalise the full path across parent ElementPaths, default to not.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The type of the model whether wrapped or not as an OscalBaseModel.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>base_type</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_type</span><span class=p>(</span><span class=n>root_model</span><span class=p>,</span> <span class=n>use_parent</span><span class=p>)</span>
+        <span class=c1># Get an outer model type.</span>
+        <span class=n>origin_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>base_type</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>origin_type</span> <span class=ow>in</span> <span class=p>[</span><span class=nb>list</span><span class=p>,</span> <span class=nb>dict</span><span class=p>]:</span>
+            <span class=c1># OSCAL does not support collections of collections directly. We should not hit this scenario</span>
+            <span class=n>collection_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>collection_name</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>critical</span><span class=p>(</span><span class=s1>&#39;Unexpected error in type system when inferring type from element path.&#39;</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>critical</span><span class=p>(</span><span class=s1>&#39;Please report this issue.&#39;</span><span class=p>)</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unknown error inferring type from element path.&#39;</span><span class=p>)</span>
+            <span class=c1># Final path must be the alias</span>
+
+            <span class=n>new_base_type</span> <span class=o>=</span> <span class=n>create_model</span><span class=p>(</span>
+                <span class=n>str_utils</span><span class=o>.</span><span class=n>alias_to_classname</span><span class=p>(</span><span class=n>collection_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>),</span>
+                <span class=n>__base__</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>,</span>
+                <span class=n>__root__</span><span class=o>=</span><span class=p>(</span><span class=n>base_type</span><span class=p>,</span> <span class=o>...</span><span class=p>)</span>
+            <span class=p>)</span>
+            <span class=k>return</span> <span class=n>new_base_type</span>
+        <span class=k>return</span> <span class=n>base_type</span>
+
+    <span class=k>def</span> <span class=nf>_top_level_type_lookup</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>element_str</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Type</span><span class=p>[</span><span class=n>common_types</span><span class=o>.</span><span class=n>TopLevelOscalModel</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;From an individual element tag, induce the type of the model.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            element_str: individual element as text such as &#39;catalog&#39; or &#39;profile&#39;</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            Top level object model such as catalog, profile etc.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># Even though awkward use chain of models.</span>
+        <span class=k>if</span> <span class=n>element_str</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>element_str</span><span class=si>}</span><span class=s1> is not a top level model (e.g. catalog, profile)&#39;</span><span class=p>)</span>
+        <span class=n>model_package</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_TO_MODEL_MODULE</span><span class=p>[</span><span class=n>element_str</span><span class=p>]</span>
+        <span class=n>object_type</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_root_model</span><span class=p>(</span><span class=n>model_package</span><span class=p>)</span>
+        <span class=n>object_type</span> <span class=o>=</span> <span class=n>cast</span><span class=p>(</span><span class=n>Type</span><span class=p>[</span><span class=n>common_types</span><span class=o>.</span><span class=n>TopLevelOscalModel</span><span class=p>],</span> <span class=n>object_type</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>object_type</span>
+
+    <span class=k>def</span> <span class=nf>is_multipart</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Assert whether or not an element path is multiple parts.</span>
+
+<span class=sd>        Originally element paths had to have multiple paths.</span>
+<span class=sd>        This provides a check for higher level code that still has that requirement.</span>
+
+<span class=sd>        Single part:</span>
+<span class=sd>            catalog</span>
+<span class=sd>            control</span>
+<span class=sd>            assessment-results</span>
+
+<span class=sd>        Multipart:</span>
+<span class=sd>            catalog.metadata</span>
+<span class=sd>            catalog.controls.control</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span>
+
+    <span class=k>def</span> <span class=nf>to_string</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the path parts as a dot-separated string.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>())</span>
+
+    <span class=k>def</span> <span class=nf>get_parent</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;ElementPath&#39;</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the parent path.</span>
+
+<span class=sd>        It can be None or a valid ElementPath</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_parent_path</span>
+
+    <span class=k>def</span> <span class=nf>get_first</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the first part of the path.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+
+    <span class=k>def</span> <span class=nf>get_last</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the last part of the path.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+
+    <span class=k>def</span> <span class=nf>get_full</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the full path including parent path parts as a dot separated str.&quot;&quot;&quot;</span>
+        <span class=n>all_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>all_parts</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_element_name</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the element alias name from the path.</span>
+
+<span class=sd>        Essentailly this the last part of the element path</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># if it is available then return otherwise compute</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_element_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>element_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>element_name</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+                <span class=n>element_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+
+            <span class=bp>self</span><span class=o>.</span><span class=n>_element_name</span> <span class=o>=</span> <span class=n>element_name</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_element_name</span>
+
+    <span class=k>def</span> <span class=nf>get_full_path_parts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get full path parts to the element including parent path parts as a list.&quot;&quot;&quot;</span>
+        <span class=n>path_parts</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>parent_path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+            <span class=n>path_parts</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>parent_path_parts</span><span class=p>)</span>
+            <span class=n>path_parts</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>()[</span><span class=mi>1</span><span class=p>:])</span>  <span class=c1># don&#39;t use the first part</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>path_parts</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>())</span>
+
+        <span class=k>return</span> <span class=n>path_parts</span>
+
+    <span class=k>def</span> <span class=nf>get_preceding_path</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;ElementPath&#39;</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return the element path to the preceding element in the path.&quot;&quot;&quot;</span>
+        <span class=c1># if it is available then return otherwise compute</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_preceding_path</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=n>prec_path_parts</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_preceding_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>prec_path_parts</span><span class=p>))</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_preceding_path</span>
+
+    <span class=k>def</span> <span class=nf>find_last_file_in_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>,</span> <span class=n>model_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find the last (nearest) existing file in the element path leading to this element.&quot;&quot;&quot;</span>
+        <span class=c1># model dir is the top level dir for this model, e.g. catalogs/mycat</span>
+        <span class=n>path</span> <span class=o>=</span> <span class=n>model_dir</span>
+        <span class=n>extension</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+        <span class=n>good_model</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>element</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>element</span> <span class=o>==</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+                <span class=k>break</span>
+            <span class=n>model_file</span> <span class=o>=</span> <span class=p>(</span><span class=n>path</span> <span class=o>/</span> <span class=n>element</span><span class=p>)</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>extension</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>model_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=k>break</span>
+            <span class=n>path</span> <span class=o>=</span> <span class=n>path</span> <span class=o>/</span> <span class=n>element</span>
+            <span class=n>good_model</span> <span class=o>=</span> <span class=n>model_file</span>
+        <span class=k>return</span> <span class=n>good_model</span>
+
+    <span class=k>def</span> <span class=nf>make_absolute</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>reference_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Make the parts absolute from the top model dir.&quot;&quot;&quot;</span>
+        <span class=c1># Match the current relative element path to the model directory and reference directory</span>
+        <span class=c1># If the element path is partial and doesn&#39;t connect to the top of the model,</span>
+        <span class=c1># need to deduce absolute element path from the model_dir and the reference directory</span>
+        <span class=c1># that corresponds to the root of the element path</span>
+
+        <span class=c1># if first element is a model type it is already absolute</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+            <span class=n>rel_path</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>reference_dir</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>model_dir</span><span class=p>)</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+            <span class=n>rel_path</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_path</span> <span class=o>=</span> <span class=n>rel_path</span>
+
+    <span class=k>def</span> <span class=nf>make_relative</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_relative_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Make the parts relative to the model path.&quot;&quot;&quot;</span>
+        <span class=c1># The element path should currently be absolute</span>
+        <span class=c1># The model relative path should be relative to the top leve of the model</span>
+        <span class=c1># Change the element path to be relative to the model being loaded</span>
+        <span class=c1># Returns 0 on success and 1 on failur</span>
+        <span class=n>rel_path_parts</span> <span class=o>=</span> <span class=n>model_relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>n_rel_parts</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>rel_path_parts</span><span class=p>)</span>
+        <span class=c1># the element path can&#39;t start above the model path</span>
+        <span class=k>if</span> <span class=n>n_rel_parts</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>):</span>
+            <span class=k>return</span> <span class=mi>1</span>
+        <span class=c1># confirm the leading parts match</span>
+        <span class=k>for</span> <span class=n>ii</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=n>n_rel_parts</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>rel_path_parts</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=o>!=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=n>ii</span><span class=p>]:</span>
+                <span class=k>return</span> <span class=mi>1</span>
+        <span class=c1># chop off the leading parts of the absolute element path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=n>n_rel_parts</span><span class=p>:]</span>
+        <span class=k>return</span> <span class=mi>0</span>
+
+    <span class=k>def</span> <span class=nf>to_file_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span> <span class=n>root_dir</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert to a file or directory path for the element path.</span>
+
+<span class=sd>        if content_type is not passed, it will return a path for directory</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>()</span>
+
+        <span class=c1># skip wildcard</span>
+        <span class=k>if</span> <span class=n>path_parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=n>path_parts</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+
+        <span class=k>if</span> <span class=n>root_dir</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+            <span class=n>path_parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>=</span> <span class=n>root_dir</span>
+
+        <span class=n>path_str</span> <span class=o>=</span> <span class=s1>&#39;/&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span>
+
+        <span class=c1># add file extension if required</span>
+        <span class=c1># this will be omitted if it is a dir path</span>
+        <span class=k>if</span> <span class=n>content_type</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>file_extension</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+            <span class=n>path_str</span> <span class=o>=</span> <span class=n>path_str</span> <span class=o>+</span> <span class=n>file_extension</span>
+
+        <span class=c1># prepare the path</span>
+        <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;./</span><span class=si>{</span><span class=n>path_str</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>file_path</span>
+
+    <span class=k>def</span> <span class=nf>to_root_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert to a file path for the element root.&quot;&quot;&quot;</span>
+        <span class=n>path_str</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;./</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>get_first</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>if</span> <span class=n>content_type</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>file_extension</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+            <span class=n>path_str</span> <span class=o>=</span> <span class=n>path_str</span> <span class=o>+</span> <span class=n>file_extension</span>
+
+        <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>path_str</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>file_path</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return string representation of element path.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>to_string</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=fm>__eq__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>other</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Override equality method.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>other</span><span class=p>,</span> <span class=n>ElementPath</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>()</span> <span class=o>==</span> <span class=n>other</span><span class=o>.</span><span class=n>get</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.elements.ElementPath-attributes>Attributes<a href=#trestle.core.models.elements.ElementPath-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.elements.ElementPath.PATH_SEPARATOR class="doc doc-heading"> <code class="highlight language-python"><span class=n>PATH_SEPARATOR</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>ALIAS_PATH_SEPARATOR</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.elements.ElementPath.PATH_SEPARATOR class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.elements.ElementPath.WILDCARD class="doc doc-heading"> <code class="highlight language-python"><span class=n>WILDCARD</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;*&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.elements.ElementPath.WILDCARD class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.models.elements.ElementPath-functions>Functions<a href=#trestle.core.models.elements.ElementPath-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.__eq__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__eq__</span><span class=p>(</span><span class=n>other</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.ElementPath.__eq__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Override equality method.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__eq__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>other</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Override equality method.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>other</span><span class=p>,</span> <span class=n>ElementPath</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>()</span> <span class=o>==</span> <span class=n>other</span><span class=o>.</span><span class=n>get</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>element_path</span><span class=p>,</span> <span class=n>parent_path</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.ElementPath.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize an element wrapper.</p> <p>It assumes the element path contains oscal field alias with hyphens only</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>element_path</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>parent_path</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=s1>&#39;ElementPath&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize an element wrapper.</span>
+
+<span class=sd>    It assumes the element path contains oscal field alias with hyphens only</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_parent_path</span> <span class=o>=</span> <span class=n>parent_path</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_parse</span><span class=p>(</span><span class=n>element_path</span><span class=p>)</span>
+
+    <span class=c1># Initialize private variables for lazy processing and caching</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_element_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_preceding_path</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=s1>&#39;ElementPath&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return string representation of element path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return string representation of element path.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>to_string</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.find_last_file_in_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>find_last_file_in_path</span><span class=p>(</span><span class=n>content_type</span><span class=p>,</span> <span class=n>model_dir</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.ElementPath.find_last_file_in_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Find the last (nearest) existing file in the element path leading to this element.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>find_last_file_in_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span><span class=p>,</span> <span class=n>model_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find the last (nearest) existing file in the element path leading to this element.&quot;&quot;&quot;</span>
+    <span class=c1># model dir is the top level dir for this model, e.g. catalogs/mycat</span>
+    <span class=n>path</span> <span class=o>=</span> <span class=n>model_dir</span>
+    <span class=n>extension</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+    <span class=n>good_model</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>for</span> <span class=n>element</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>element</span> <span class=o>==</span> <span class=s1>&#39;*&#39;</span><span class=p>:</span>
+            <span class=k>break</span>
+        <span class=n>model_file</span> <span class=o>=</span> <span class=p>(</span><span class=n>path</span> <span class=o>/</span> <span class=n>element</span><span class=p>)</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=n>extension</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>model_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>break</span>
+        <span class=n>path</span> <span class=o>=</span> <span class=n>path</span> <span class=o>/</span> <span class=n>element</span>
+        <span class=n>good_model</span> <span class=o>=</span> <span class=n>model_file</span>
+    <span class=k>return</span> <span class=n>good_model</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get class="doc doc-heading"> <code class="highlight language-python"><span class=n>get</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.get class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the path parts as a list.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the path parts as a list.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get_element_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_element_name</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.get_element_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the element alias name from the path.</p> <p>Essentailly this the last part of the element path</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_element_name</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the element alias name from the path.</span>
+
+<span class=sd>    Essentailly this the last part of the element path</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># if it is available then return otherwise compute</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_element_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>element_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>element_name</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=n>element_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_element_name</span> <span class=o>=</span> <span class=n>element_name</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_element_name</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get_first class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_first</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.get_first class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the first part of the path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_first</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the first part of the path.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get_full class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_full</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.get_full class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the full path including parent path parts as a dot separated str.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_full</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the full path including parent path parts as a dot separated str.&quot;&quot;&quot;</span>
+    <span class=n>all_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>all_parts</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get_full_path_parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_full_path_parts</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.get_full_path_parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get full path parts to the element including parent path parts as a list.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_full_path_parts</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get full path parts to the element including parent path parts as a list.&quot;&quot;&quot;</span>
+    <span class=n>path_parts</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>parent_path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parent</span><span class=p>()</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+        <span class=n>path_parts</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>parent_path_parts</span><span class=p>)</span>
+        <span class=n>path_parts</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>()[</span><span class=mi>1</span><span class=p>:])</span>  <span class=c1># don&#39;t use the first part</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>path_parts</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>())</span>
+
+    <span class=k>return</span> <span class=n>path_parts</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get_last class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_last</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.get_last class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the last part of the path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_last</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the last part of the path.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get_obm_wrapped_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_obm_wrapped_type</span><span class=p>(</span><span class=n>root_model</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>use_parent</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.ElementPath.get_obm_wrapped_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the type of the element. Wraps the collection type in an OscalBaseModel as a <strong>root</strong> element.</p> <p>This should principally be used for validating content.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>root_model</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.Type>Type</span>[<span title=typing.Any>Any</span>]]</code> </td> <td> <div class=doc-md-description> <p>An OscalBaseModel Type from which to base the approach on.</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>use_parent</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether or not to normalise the full path across parent ElementPaths, default to not.</p> </div> </td> <td> <code>False</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Type>Type</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>]</code> </td> <td> <div class=doc-md-description> <p>The type of the model whether wrapped or not as an OscalBaseModel.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_obm_wrapped_type</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                         <span class=n>root_model</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+                         <span class=n>use_parent</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the type of the element. Wraps the collection type in an OscalBaseModel as a __root__ element.</span>
+
+<span class=sd>    This should principally be used for validating content.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        root_model: An OscalBaseModel Type from which to base the approach on.</span>
+<span class=sd>        use_parent: Whether or not to normalise the full path across parent ElementPaths, default to not.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The type of the model whether wrapped or not as an OscalBaseModel.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>base_type</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_type</span><span class=p>(</span><span class=n>root_model</span><span class=p>,</span> <span class=n>use_parent</span><span class=p>)</span>
+    <span class=c1># Get an outer model type.</span>
+    <span class=n>origin_type</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_origin</span><span class=p>(</span><span class=n>base_type</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>origin_type</span> <span class=ow>in</span> <span class=p>[</span><span class=nb>list</span><span class=p>,</span> <span class=nb>dict</span><span class=p>]:</span>
+        <span class=c1># OSCAL does not support collections of collections directly. We should not hit this scenario</span>
+        <span class=n>collection_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_last</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>collection_name</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>critical</span><span class=p>(</span><span class=s1>&#39;Unexpected error in type system when inferring type from element path.&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>critical</span><span class=p>(</span><span class=s1>&#39;Please report this issue.&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unknown error inferring type from element path.&#39;</span><span class=p>)</span>
+        <span class=c1># Final path must be the alias</span>
+
+        <span class=n>new_base_type</span> <span class=o>=</span> <span class=n>create_model</span><span class=p>(</span>
+            <span class=n>str_utils</span><span class=o>.</span><span class=n>alias_to_classname</span><span class=p>(</span><span class=n>collection_name</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>),</span>
+            <span class=n>__base__</span><span class=o>=</span><span class=n>OscalBaseModel</span><span class=p>,</span>
+            <span class=n>__root__</span><span class=o>=</span><span class=p>(</span><span class=n>base_type</span><span class=p>,</span> <span class=o>...</span><span class=p>)</span>
+        <span class=p>)</span>
+        <span class=k>return</span> <span class=n>new_base_type</span>
+    <span class=k>return</span> <span class=n>base_type</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get_parent class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_parent</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.get_parent class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the parent path.</p> <p>It can be None or a valid ElementPath</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_parent</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;ElementPath&#39;</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the parent path.</span>
+
+<span class=sd>    It can be None or a valid ElementPath</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_parent_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get_preceding_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_preceding_path</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.get_preceding_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the element path to the preceding element in the path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_preceding_path</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;ElementPath&#39;</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the element path to the preceding element in the path.&quot;&quot;&quot;</span>
+    <span class=c1># if it is available then return otherwise compute</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_preceding_path</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>prec_path_parts</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_preceding_path</span> <span class=o>=</span> <span class=n>ElementPath</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>prec_path_parts</span><span class=p>))</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_preceding_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.get_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_type</span><span class=p>(</span><span class=n>root_model</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>use_parent</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.ElementPath.get_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the type of an element.</p> <p>If possible the model type will be derived from one of the top level models, otherwise a 'root model' can be passed for situations where this is not possible.</p> <p>This type path should <em>NOT</em> have wild cards in it. It <em>may</em> have* indices. Valid Examples: catalog.metadata catalog.groups catalog.groups.group catalog catalog.groups.0</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>root_model</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=typing.Type>Type</span>[<span title=typing.Any>Any</span>]]</code> </td> <td> <div class=doc-md-description> <p>An OscalBaseModel Type from which to base the approach on.</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>use_parent</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether or not to normalise the full path across parent ElementPaths, default to not.</p> </div> </td> <td> <code>False</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Type>Type</span>[<span title=typing.Any>Any</span>]</code> </td> <td> <div class=doc-md-description> <p>The type of the model whether or not it is an OscalBaseModel or not.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_type</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_model</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span> <span class=n>use_parent</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Type</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the type of an element.</span>
+
+<span class=sd>    If possible the model type will be derived from one of the top level models,</span>
+<span class=sd>    otherwise a &#39;root model&#39; can be passed for situations where this is not possible.</span>
+
+<span class=sd>    This type path should *NOT* have wild cards in it. It *may* have* indices.</span>
+<span class=sd>    Valid Examples:</span>
+<span class=sd>        catalog.metadata</span>
+<span class=sd>        catalog.groups</span>
+<span class=sd>        catalog.groups.group</span>
+<span class=sd>        catalog</span>
+<span class=sd>        catalog.groups.0</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        root_model: An OscalBaseModel Type from which to base the approach on.</span>
+<span class=sd>        use_parent: Whether or not to normalise the full path across parent ElementPaths, default to not.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The type of the model whether or not it is an OscalBaseModel or not.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>effective_path</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=k>if</span> <span class=n>use_parent</span><span class=p>:</span>
+        <span class=n>effective_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_full_path_parts</span><span class=p>()</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>effective_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>root_model</span><span class=p>:</span>
+        <span class=c1># lookup root model from top level oscal models or fail</span>
+        <span class=n>prev_model</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_top_level_type_lookup</span><span class=p>(</span><span class=n>effective_path</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>prev_model</span> <span class=o>=</span> <span class=n>root_model</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>effective_path</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>prev_model</span>
+    <span class=c1># variables</span>
+    <span class=c1># for current_element_str in effective_path[1:]:</span>
+    <span class=k>for</span> <span class=n>current_element_str</span> <span class=ow>in</span> <span class=n>effective_path</span><span class=p>[</span><span class=mi>1</span><span class=p>:]:</span>
+        <span class=c1># Determine if the parent model is a collection.</span>
+        <span class=k>if</span> <span class=n>utils</span><span class=o>.</span><span class=n>is_collection_field_type</span><span class=p>(</span><span class=n>prev_model</span><span class=p>):</span>
+            <span class=n>inner_model</span> <span class=o>=</span> <span class=n>utils</span><span class=o>.</span><span class=n>get_inner_type</span><span class=p>(</span><span class=n>prev_model</span><span class=p>)</span>
+            <span class=n>inner_class_name</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>inner_model</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+            <span class=c1># Assert that the current name fits an expected form.</span>
+            <span class=c1># Valid choices here are *, integer (for arrays) and the inner model alias</span>
+            <span class=k>if</span> <span class=p>(</span><span class=n>inner_class_name</span> <span class=o>==</span> <span class=n>current_element_str</span> <span class=ow>or</span> <span class=n>current_element_str</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>WILDCARD</span>
+                    <span class=ow>or</span> <span class=n>current_element_str</span><span class=o>.</span><span class=n>isnumeric</span><span class=p>()):</span>
+                <span class=n>prev_model</span> <span class=o>=</span> <span class=n>inner_model</span>
+
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Unexpected key in element path when finding type.&#39;</span><span class=p>)</span>
+
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># Indices, * are not allowed on non-collection types</span>
+            <span class=k>if</span> <span class=n>current_element_str</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=s1>&#39;Wild card in unexpected position when trying to find class type.&#39;</span>
+                    <span class=o>+</span> <span class=s1>&#39; Element path type lookup can only occur where a single type can be identified.&#39;</span>
+                <span class=p>)</span>
+            <span class=n>prev_model</span> <span class=o>=</span> <span class=n>prev_model</span><span class=o>.</span><span class=n>alias_to_field_map</span><span class=p>()[</span><span class=n>current_element_str</span><span class=p>]</span><span class=o>.</span><span class=n>outer_type_</span>
+    <span class=k>return</span> <span class=n>prev_model</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.is_multipart class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_multipart</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.is_multipart class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assert whether or not an element path is multiple parts.</p> <p>Originally element paths had to have multiple paths. This provides a check for higher level code that still has that requirement.</p> <details class=single-part open> <summary>Single part</summary> <p>catalog control assessment-results</p> </details> <details class=multipart open> <summary>Multipart</summary> <p>catalog.metadata catalog.controls.control</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_multipart</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assert whether or not an element path is multiple parts.</span>
+
+<span class=sd>    Originally element paths had to have multiple paths.</span>
+<span class=sd>    This provides a check for higher level code that still has that requirement.</span>
+
+<span class=sd>    Single part:</span>
+<span class=sd>        catalog</span>
+<span class=sd>        control</span>
+<span class=sd>        assessment-results</span>
+
+<span class=sd>    Multipart:</span>
+<span class=sd>        catalog.metadata</span>
+<span class=sd>        catalog.controls.control</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.make_absolute class="doc doc-heading"> <code class="highlight language-python"><span class=n>make_absolute</span><span class=p>(</span><span class=n>model_dir</span><span class=p>,</span> <span class=n>reference_dir</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.ElementPath.make_absolute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Make the parts absolute from the top model dir.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>make_absolute</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>reference_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Make the parts absolute from the top model dir.&quot;&quot;&quot;</span>
+    <span class=c1># Match the current relative element path to the model directory and reference directory</span>
+    <span class=c1># If the element path is partial and doesn&#39;t connect to the top of the model,</span>
+    <span class=c1># need to deduce absolute element path from the model_dir and the reference directory</span>
+    <span class=c1># that corresponds to the root of the element path</span>
+
+    <span class=c1># if first element is a model type it is already absolute</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+        <span class=n>rel_path</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>reference_dir</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=n>model_dir</span><span class=p>)</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+        <span class=n>rel_path</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_path</span> <span class=o>=</span> <span class=n>rel_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.make_relative class="doc doc-heading"> <code class="highlight language-python"><span class=n>make_relative</span><span class=p>(</span><span class=n>model_relative_path</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.ElementPath.make_relative class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Make the parts relative to the model path.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>make_relative</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_relative_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Make the parts relative to the model path.&quot;&quot;&quot;</span>
+    <span class=c1># The element path should currently be absolute</span>
+    <span class=c1># The model relative path should be relative to the top leve of the model</span>
+    <span class=c1># Change the element path to be relative to the model being loaded</span>
+    <span class=c1># Returns 0 on success and 1 on failur</span>
+    <span class=n>rel_path_parts</span> <span class=o>=</span> <span class=n>model_relative_path</span><span class=o>.</span><span class=n>parts</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+    <span class=n>n_rel_parts</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>rel_path_parts</span><span class=p>)</span>
+    <span class=c1># the element path can&#39;t start above the model path</span>
+    <span class=k>if</span> <span class=n>n_rel_parts</span> <span class=o>&gt;=</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>):</span>
+        <span class=k>return</span> <span class=mi>1</span>
+    <span class=c1># confirm the leading parts match</span>
+    <span class=k>for</span> <span class=n>ii</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=n>n_rel_parts</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>rel_path_parts</span><span class=p>[</span><span class=n>ii</span><span class=p>]</span> <span class=o>!=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=n>ii</span><span class=p>]:</span>
+            <span class=k>return</span> <span class=mi>1</span>
+    <span class=c1># chop off the leading parts of the absolute element path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_path</span><span class=p>[</span><span class=n>n_rel_parts</span><span class=p>:]</span>
+    <span class=k>return</span> <span class=mi>0</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.to_file_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_file_path</span><span class=p>(</span><span class=n>content_type</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>root_dir</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.ElementPath.to_file_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert to a file or directory path for the element path.</p> <p>if content_type is not passed, it will return a path for directory</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_file_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span> <span class=n>root_dir</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert to a file or directory path for the element path.</span>
+
+<span class=sd>    if content_type is not passed, it will return a path for directory</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>path_parts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>()</span>
+
+    <span class=c1># skip wildcard</span>
+    <span class=k>if</span> <span class=n>path_parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span> <span class=o>==</span> <span class=n>ElementPath</span><span class=o>.</span><span class=n>WILDCARD</span><span class=p>:</span>
+        <span class=n>path_parts</span> <span class=o>=</span> <span class=n>path_parts</span><span class=p>[:</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+
+    <span class=k>if</span> <span class=n>root_dir</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span><span class=p>:</span>
+        <span class=n>path_parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>=</span> <span class=n>root_dir</span>
+
+    <span class=n>path_str</span> <span class=o>=</span> <span class=s1>&#39;/&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>path_parts</span><span class=p>)</span>
+
+    <span class=c1># add file extension if required</span>
+    <span class=c1># this will be omitted if it is a dir path</span>
+    <span class=k>if</span> <span class=n>content_type</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>file_extension</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+        <span class=n>path_str</span> <span class=o>=</span> <span class=n>path_str</span> <span class=o>+</span> <span class=n>file_extension</span>
+
+    <span class=c1># prepare the path</span>
+    <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;./</span><span class=si>{</span><span class=n>path_str</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>file_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.to_root_path class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_root_path</span><span class=p>(</span><span class=n>content_type</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.models.elements.ElementPath.to_root_path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Convert to a file path for the element root.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_root_path</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert to a file path for the element root.&quot;&quot;&quot;</span>
+    <span class=n>path_str</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;./</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>get_first</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=k>if</span> <span class=n>content_type</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>file_extension</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span>
+        <span class=n>path_str</span> <span class=o>=</span> <span class=n>path_str</span> <span class=o>+</span> <span class=n>file_extension</span>
+
+    <span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>path_str</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>file_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.elements.ElementPath.to_string class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_string</span><span class=p>()</span></code> <a href=#trestle.core.models.elements.ElementPath.to_string class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return the path parts as a dot-separated string.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/elements.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_string</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return the path parts as a dot-separated string.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>PATH_SEPARATOR</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get</span><span class=p>())</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.models.elements-functions>Functions<a href=#trestle.core.models.elements-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/models/file_content_type/index.html b/latest/reference/API/trestle/core/models/file_content_type/index.html
new file mode 100644
index 000000000..647e9810d
--- /dev/null
+++ b/latest/reference/API/trestle/core/models/file_content_type/index.html
@@ -0,0 +1,254 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.models.file_content_type module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/file_content_type/ rel=canonical><link href=../elements/ rel=prev><link href=../interfaces/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.models.file_content_type - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.models.file_content_type - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.models.file_content_type module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/file_content_type.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/file_content_type/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.models.file_content_type - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.models.file_content_type module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/file_content_type.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.models.file_content_type class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31 checked> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.models.file_content_type </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type class=md-nav__link> <span class=md-ellipsis> file_content_type </span> </a> <nav class=md-nav aria-label=file_content_type> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType class=md-nav__link> <span class=md-ellipsis> FileContentType </span> </a> <nav class=md-nav aria-label=FileContentType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.DIRLIKE class=md-nav__link> <span class=md-ellipsis> DIRLIKE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.JSON class=md-nav__link> <span class=md-ellipsis> JSON </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.UNKNOWN class=md-nav__link> <span class=md-ellipsis> UNKNOWN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.YAML class=md-nav__link> <span class=md-ellipsis> YAML </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.dir_to_content_type class=md-nav__link> <span class=md-ellipsis> dir_to_content_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.is_readable_file class=md-nav__link> <span class=md-ellipsis> is_readable_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.path_to_content_type class=md-nav__link> <span class=md-ellipsis> path_to_content_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.path_to_file_extension class=md-nav__link> <span class=md-ellipsis> path_to_file_extension </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.to_content_type class=md-nav__link> <span class=md-ellipsis> to_content_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.to_file_extension class=md-nav__link> <span class=md-ellipsis> to_file_extension </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type class=md-nav__link> <span class=md-ellipsis> file_content_type </span> </a> <nav class=md-nav aria-label=file_content_type> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType class=md-nav__link> <span class=md-ellipsis> FileContentType </span> </a> <nav class=md-nav aria-label=FileContentType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.DIRLIKE class=md-nav__link> <span class=md-ellipsis> DIRLIKE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.JSON class=md-nav__link> <span class=md-ellipsis> JSON </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.UNKNOWN class=md-nav__link> <span class=md-ellipsis> UNKNOWN </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.YAML class=md-nav__link> <span class=md-ellipsis> YAML </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.dir_to_content_type class=md-nav__link> <span class=md-ellipsis> dir_to_content_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.is_readable_file class=md-nav__link> <span class=md-ellipsis> is_readable_file </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.path_to_content_type class=md-nav__link> <span class=md-ellipsis> path_to_content_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.path_to_file_extension class=md-nav__link> <span class=md-ellipsis> path_to_file_extension </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.to_content_type class=md-nav__link> <span class=md-ellipsis> to_content_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.file_content_type.FileContentType.to_file_extension class=md-nav__link> <span class=md-ellipsis> to_file_extension </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.models.file_content_type</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.models.file_content_type class="doc doc-heading"> <code>trestle.core.models.file_content_type</code> <a href=#trestle.core.models.file_content_type class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Action wrapper of a command.</p> <div class="doc doc-children"> <h3 id=trestle.core.models.file_content_type-classes>Classes<a href=#trestle.core.models.file_content_type-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.file_content_type.FileContentType class="doc doc-heading"> <code>FileContentType</code> <a href=#trestle.core.models.file_content_type.FileContentType class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>File Content type for read/write.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/file_content_type.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>21</span>
+<span class=normal>22</span>
+<span class=normal>23</span>
+<span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>FileContentType</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;File Content type for read/write.&quot;&quot;&quot;</span>
+
+    <span class=c1># JSON formatted content</span>
+    <span class=n>JSON</span> <span class=o>=</span> <span class=mi>1</span>
+
+    <span class=c1># YAML formatted content</span>
+    <span class=n>YAML</span> <span class=o>=</span> <span class=mi>2</span>
+
+    <span class=c1># No extension and possibly a DIR</span>
+    <span class=n>DIRLIKE</span> <span class=o>=</span> <span class=mi>3</span>
+
+    <span class=c1># Type could not be determined</span>
+    <span class=n>UNKNOWN</span> <span class=o>=</span> <span class=mi>4</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>to_file_extension</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get file extension for the type, including the dot.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span><span class=p>:</span>
+            <span class=k>return</span> <span class=s1>&#39;.yaml&#39;</span>
+        <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+            <span class=k>return</span> <span class=s1>&#39;.json&#39;</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid file content type </span><span class=si>{</span><span class=n>content_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>to_content_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_extension</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get content type form file extension, including the dot.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>file_extension</span> <span class=o>==</span> <span class=s1>&#39;.json&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+        <span class=k>if</span> <span class=n>file_extension</span> <span class=o>==</span> <span class=s1>&#39;.yaml&#39;</span> <span class=ow>or</span> <span class=n>file_extension</span> <span class=o>==</span> <span class=s1>&#39;.yml&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>file_extension</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>DIRLIKE</span>
+
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unsupported file extension </span><span class=si>{</span><span class=n>file_extension</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>path_to_content_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get content type from file path looking for extension.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.json&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+        <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.yaml&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+        <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.yml&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+        <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>dir_to_content_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>dir_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get content type by looking for json or yaml files in dir.&quot;&quot;&quot;</span>
+        <span class=n>files</span> <span class=o>=</span> <span class=n>dir_path</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>file</span> <span class=ow>in</span> <span class=n>files</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+                <span class=n>suffix</span> <span class=o>=</span> <span class=n>file</span><span class=o>.</span><span class=n>suffix</span>
+                <span class=k>if</span> <span class=n>suffix</span> <span class=o>==</span> <span class=s1>&#39;.json&#39;</span><span class=p>:</span>
+                    <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+                <span class=k>if</span> <span class=n>suffix</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;.yaml&#39;</span><span class=p>,</span> <span class=s1>&#39;.yml&#39;</span><span class=p>]:</span>
+                    <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+        <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>path_to_file_extension</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get extension from file path looking for extension.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.json&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=s1>&#39;.json&#39;</span>
+        <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.yaml&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=s1>&#39;.yaml&#39;</span>
+        <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.yml&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>return</span> <span class=s1>&#39;.yml&#39;</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>is_readable_file</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Is the file a type that can be read directly.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span> <span class=ow>or</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.file_content_type.FileContentType-attributes>Attributes<a href=#trestle.core.models.file_content_type.FileContentType-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.file_content_type.FileContentType.DIRLIKE class="doc doc-heading"> <code class="highlight language-python"><span class=n>DIRLIKE</span> <span class=o>=</span> <span class=mi>3</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.DIRLIKE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.file_content_type.FileContentType.JSON class="doc doc-heading"> <code class="highlight language-python"><span class=n>JSON</span> <span class=o>=</span> <span class=mi>1</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.JSON class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.file_content_type.FileContentType.UNKNOWN class="doc doc-heading"> <code class="highlight language-python"><span class=n>UNKNOWN</span> <span class=o>=</span> <span class=mi>4</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.UNKNOWN class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.file_content_type.FileContentType.YAML class="doc doc-heading"> <code class="highlight language-python"><span class=n>YAML</span> <span class=o>=</span> <span class=mi>2</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.YAML class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.models.file_content_type.FileContentType-functions>Functions<a href=#trestle.core.models.file_content_type.FileContentType-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.file_content_type.FileContentType.dir_to_content_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>dir_to_content_type</span><span class=p>(</span><span class=n>dir_path</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.dir_to_content_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get content type by looking for json or yaml files in dir.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/file_content_type.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>dir_to_content_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>dir_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get content type by looking for json or yaml files in dir.&quot;&quot;&quot;</span>
+    <span class=n>files</span> <span class=o>=</span> <span class=n>dir_path</span><span class=o>.</span><span class=n>glob</span><span class=p>(</span><span class=s1>&#39;*&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>file</span> <span class=ow>in</span> <span class=n>files</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>file</span><span class=o>.</span><span class=n>is_file</span><span class=p>():</span>
+            <span class=n>suffix</span> <span class=o>=</span> <span class=n>file</span><span class=o>.</span><span class=n>suffix</span>
+            <span class=k>if</span> <span class=n>suffix</span> <span class=o>==</span> <span class=s1>&#39;.json&#39;</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+            <span class=k>if</span> <span class=n>suffix</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;.yaml&#39;</span><span class=p>,</span> <span class=s1>&#39;.yml&#39;</span><span class=p>]:</span>
+                <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+    <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.file_content_type.FileContentType.is_readable_file class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_readable_file</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.is_readable_file class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Is the file a type that can be read directly.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/file_content_type.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>is_readable_file</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Is the file a type that can be read directly.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span> <span class=ow>or</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.file_content_type.FileContentType.path_to_content_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.path_to_content_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get content type from file path looking for extension.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/file_content_type.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>path_to_content_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get content type from file path looking for extension.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.json&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+    <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.yaml&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+    <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.yml&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+    <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.file_content_type.FileContentType.path_to_file_extension class="doc doc-heading"> <code class="highlight language-python"><span class=n>path_to_file_extension</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.path_to_file_extension class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get extension from file path looking for extension.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/file_content_type.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>path_to_file_extension</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_path</span><span class=p>:</span> <span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get extension from file path looking for extension.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.json&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=s1>&#39;.json&#39;</span>
+    <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.yaml&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=s1>&#39;.yaml&#39;</span>
+    <span class=k>if</span> <span class=n>file_path</span><span class=o>.</span><span class=n>with_suffix</span><span class=p>(</span><span class=s1>&#39;.yml&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>return</span> <span class=s1>&#39;.yml&#39;</span>
+    <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.file_content_type.FileContentType.to_content_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_content_type</span><span class=p>(</span><span class=n>file_extension</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.to_content_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get content type form file extension, including the dot.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/file_content_type.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>to_content_type</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>file_extension</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get content type form file extension, including the dot.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>file_extension</span> <span class=o>==</span> <span class=s1>&#39;.json&#39;</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+    <span class=k>if</span> <span class=n>file_extension</span> <span class=o>==</span> <span class=s1>&#39;.yaml&#39;</span> <span class=ow>or</span> <span class=n>file_extension</span> <span class=o>==</span> <span class=s1>&#39;.yml&#39;</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>file_extension</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>DIRLIKE</span>
+
+    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unsupported file extension </span><span class=si>{</span><span class=n>file_extension</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.file_content_type.FileContentType.to_file_extension class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.models.file_content_type.FileContentType.to_file_extension class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get file extension for the type, including the dot.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/file_content_type.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>to_file_extension</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=s1>&#39;FileContentType&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get file extension for the type, including the dot.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>YAML</span><span class=p>:</span>
+        <span class=k>return</span> <span class=s1>&#39;.yaml&#39;</span>
+    <span class=k>if</span> <span class=n>content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>:</span>
+        <span class=k>return</span> <span class=s1>&#39;.json&#39;</span>
+    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid file content type </span><span class=si>{</span><span class=n>content_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/models/interfaces/index.html b/latest/reference/API/trestle/core/models/interfaces/index.html
new file mode 100644
index 000000000..2c8aaec70
--- /dev/null
+++ b/latest/reference/API/trestle/core/models/interfaces/index.html
@@ -0,0 +1,61 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.models.interfaces module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/interfaces/ rel=canonical><link href=../file_content_type/ rel=prev><link href=../plans/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.models.interfaces - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.models.interfaces - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.models.interfaces module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/interfaces.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/interfaces/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.models.interfaces - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.models.interfaces module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/interfaces.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.models.interfaces class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.models.interfaces </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31 checked> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.models.interfaces </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.interfaces class=md-nav__link> <span class=md-ellipsis> interfaces </span> </a> <nav class=md-nav aria-label=interfaces> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly class=md-nav__link> <span class=md-ellipsis> OSCALAssembly </span> </a> <nav class=md-nav aria-label=OSCALAssembly> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.catalogs class=md-nav__link> <span class=md-ellipsis> catalogs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.poam class=md-nav__link> <span class=md-ellipsis> poam </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.profiles class=md-nav__link> <span class=md-ellipsis> profiles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.sap class=md-nav__link> <span class=md-ellipsis> sap </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.sar class=md-nav__link> <span class=md-ellipsis> sar </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.ssp class=md-nav__link> <span class=md-ellipsis> ssp </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.interfaces class=md-nav__link> <span class=md-ellipsis> interfaces </span> </a> <nav class=md-nav aria-label=interfaces> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly class=md-nav__link> <span class=md-ellipsis> OSCALAssembly </span> </a> <nav class=md-nav aria-label=OSCALAssembly> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.catalogs class=md-nav__link> <span class=md-ellipsis> catalogs </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.poam class=md-nav__link> <span class=md-ellipsis> poam </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.profiles class=md-nav__link> <span class=md-ellipsis> profiles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.sap class=md-nav__link> <span class=md-ellipsis> sap </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.sar class=md-nav__link> <span class=md-ellipsis> sar </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.ssp class=md-nav__link> <span class=md-ellipsis> ssp </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.interfaces.OSCALAssembly.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.models.interfaces</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.models.interfaces class="doc doc-heading"> <code>trestle.core.models.interfaces</code> <a href=#trestle.core.models.interfaces class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Interfaces for use within other trestle functions defined as pydantic data models.</p> <div class="doc doc-children"> <h3 id=trestle.core.models.interfaces-classes>Classes<a href=#trestle.core.models.interfaces-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.interfaces.OSCALAssembly class="doc doc-heading"> <code>OSCALAssembly</code> <a href=#trestle.core.models.interfaces.OSCALAssembly class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.trestle_base_model.TrestleBaseModel href=../../trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel>TrestleBaseModel</a></code></p> <p>Data model to represent an assembled set of OSCAL objects.</p> <p>Here the assembly represents the constraints as expected by the current OSCAL schema. At this point in time a 'flat' model has been chosen rather than an tree.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/interfaces.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OSCALAssembly</span><span class=p>(</span><span class=n>TrestleBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Data model to represent an assembled set of OSCAL objects.</span>
+
+<span class=sd>    Here the assembly represents the constraints as expected by the current OSCAL</span>
+<span class=sd>    schema. At this point in time a &#39;flat&#39; model has been chosen rather than an tree.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>poam</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>o_poam</span><span class=o>.</span><span class=n>PlanOfActionAndMilestones</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>sar</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>o_ar</span><span class=o>.</span><span class=n>AssessmentResults</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>sap</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>o_ap</span><span class=o>.</span><span class=n>AssessmentPlan</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>ssp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>o_ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>profiles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>o_profile</span><span class=o>.</span><span class=n>Profile</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>catalogs</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>o_catalog</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>o_component</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Pydantic config overrides.&quot;&quot;&quot;</span>
+
+        <span class=n>allow_population_by_field_name</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=c1># Enforce strict schema</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+        <span class=c1># Validate on assignment of variables to ensure no escapes</span>
+        <span class=n>validate_assignment</span> <span class=o>=</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.interfaces.OSCALAssembly-attributes>Attributes<a href=#trestle.core.models.interfaces.OSCALAssembly-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.interfaces.OSCALAssembly.catalogs class="doc doc-heading"> <code class="highlight language-python"><span class=n>catalogs</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>o_catalog</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.catalogs class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.interfaces.OSCALAssembly.components class="doc doc-heading"> <code class="highlight language-python"><span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>o_component</span><span class=o>.</span><span class=n>ComponentDefinition</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.interfaces.OSCALAssembly.poam class="doc doc-heading"> <code class="highlight language-python"><span class=n>poam</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>o_poam</span><span class=o>.</span><span class=n>PlanOfActionAndMilestones</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.poam class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.interfaces.OSCALAssembly.profiles class="doc doc-heading"> <code class="highlight language-python"><span class=n>profiles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>o_profile</span><span class=o>.</span><span class=n>Profile</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.profiles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.interfaces.OSCALAssembly.sap class="doc doc-heading"> <code class="highlight language-python"><span class=n>sap</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>o_ap</span><span class=o>.</span><span class=n>AssessmentPlan</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.sap class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.interfaces.OSCALAssembly.sar class="doc doc-heading"> <code class="highlight language-python"><span class=n>sar</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>o_ar</span><span class=o>.</span><span class=n>AssessmentResults</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.sar class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.models.interfaces.OSCALAssembly.ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>ssp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>o_ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.models.interfaces.OSCALAssembly-classes>Classes<a href=#trestle.core.models.interfaces.OSCALAssembly-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.core.models.interfaces.OSCALAssembly.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.core.models.interfaces.OSCALAssembly.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Pydantic config overrides.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/interfaces.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Pydantic config overrides.&quot;&quot;&quot;</span>
+
+    <span class=n>allow_population_by_field_name</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=c1># Enforce strict schema</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+    <span class=c1># Validate on assignment of variables to ensure no escapes</span>
+    <span class=n>validate_assignment</span> <span class=o>=</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.core.models.interfaces.OSCALAssembly.Config-attributes>Attributes<a href=#trestle.core.models.interfaces.OSCALAssembly.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.models.interfaces.OSCALAssembly.Config.allow_population_by_field_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>allow_population_by_field_name</span> <span class=o>=</span> <span class=kc>True</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.Config.allow_population_by_field_name class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.models.interfaces.OSCALAssembly.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.models.interfaces.OSCALAssembly.Config.validate_assignment class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate_assignment</span> <span class=o>=</span> <span class=kc>True</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.models.interfaces.OSCALAssembly.Config.validate_assignment class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/models/plans/index.html b/latest/reference/API/trestle/core/models/plans/index.html
new file mode 100644
index 000000000..c77df1945
--- /dev/null
+++ b/latest/reference/API/trestle/core/models/plans/index.html
@@ -0,0 +1,207 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.models.plans module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/plans/ rel=canonical><link href=../interfaces/ rel=prev><link href=../../remote/cache/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.models.plans - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.models.plans - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.models.plans module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/plans.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/plans/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.models.plans - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.models.plans module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/models/plans.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.models.plans class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.models.plans </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31 checked> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.models.plans </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.models.plans </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.plans class=md-nav__link> <span class=md-ellipsis> plans </span> </a> <nav class=md-nav aria-label=plans> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan class=md-nav__link> <span class=md-ellipsis> Plan </span> </a> <nav class=md-nav aria-label=Plan> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.__eq__ class=md-nav__link> <span class=md-ellipsis> __eq__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.add_action class=md-nav__link> <span class=md-ellipsis> add_action </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.add_actions class=md-nav__link> <span class=md-ellipsis> add_actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.clear_actions class=md-nav__link> <span class=md-ellipsis> clear_actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.get_actions class=md-nav__link> <span class=md-ellipsis> get_actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.models.plans class=md-nav__link> <span class=md-ellipsis> plans </span> </a> <nav class=md-nav aria-label=plans> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan class=md-nav__link> <span class=md-ellipsis> Plan </span> </a> <nav class=md-nav aria-label=Plan> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.__eq__ class=md-nav__link> <span class=md-ellipsis> __eq__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.__str__ class=md-nav__link> <span class=md-ellipsis> __str__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.add_action class=md-nav__link> <span class=md-ellipsis> add_action </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.add_actions class=md-nav__link> <span class=md-ellipsis> add_actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.clear_actions class=md-nav__link> <span class=md-ellipsis> clear_actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.get_actions class=md-nav__link> <span class=md-ellipsis> get_actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.models.plans.Plan.rollback class=md-nav__link> <span class=md-ellipsis> rollback </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.models.plans</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.models.plans class="doc doc-heading"> <code>trestle.core.models.plans</code> <a href=#trestle.core.models.plans class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Plan of action of a command.</p> <div class="doc doc-children"> <h3 id=trestle.core.models.plans-attributes>Attributes<a href=#trestle.core.models.plans-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.models.plans.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.models.plans.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.models.plans-classes>Classes<a href=#trestle.core.models.plans-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.models.plans.Plan class="doc doc-heading"> <code>Plan</code> <a href=#trestle.core.models.plans.Plan class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Plan of action of a command.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Plan</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Plan of action of a command.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize a plan.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=k>def</span> <span class=nf>_action_key</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>action</span><span class=p>:</span> <span class=n>Action</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+        <span class=k>return</span> <span class=nb>hash</span><span class=p>(</span><span class=n>action</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the plan.&quot;&quot;&quot;</span>
+        <span class=n>list_actions</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>index</span> <span class=o>=</span> <span class=mi>1</span>
+        <span class=k>for</span> <span class=n>action</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=p>:</span>
+            <span class=n>list_actions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>index</span><span class=si>}</span><span class=s1>. </span><span class=si>{</span><span class=n>action</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>index</span> <span class=o>=</span> <span class=n>index</span> <span class=o>+</span> <span class=mi>1</span>
+
+        <span class=n>list_str</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>list_actions</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>list_str</span>
+
+    <span class=k>def</span> <span class=nf>get_actions</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all actions.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span>
+
+    <span class=k>def</span> <span class=nf>add_action</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>action</span><span class=p>:</span> <span class=n>Action</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add a new action.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>action</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>add_actions</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>actions</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add actions in order.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>actions</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>clear_actions</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Clear all actions.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the actions in the plan.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>action</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>action</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Failed to execute action </span><span class=si>{</span><span class=n>action</span><span class=si>}</span><span class=s1> for the plan: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>. Rolling back.&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>rollback</span><span class=p>()</span>
+                <span class=k>raise</span> <span class=n>e</span>
+
+    <span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rollback the actions in the plan.&quot;&quot;&quot;</span>
+        <span class=c1># execute in reverse order</span>
+        <span class=k>for</span> <span class=n>action</span> <span class=ow>in</span> <span class=nb>reversed</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>action</span><span class=o>.</span><span class=n>has_rollback</span><span class=p>()</span> <span class=ow>is</span> <span class=kc>False</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>UnsupportedOperation</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>action</span><span class=o>.</span><span class=n>get_type</span><span class=p>()</span><span class=si>}</span><span class=s1> does not support rollback&#39;</span><span class=p>)</span>
+            <span class=n>action</span><span class=o>.</span><span class=n>rollback</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=fm>__eq__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>other</span><span class=p>:</span> <span class=nb>object</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check that two plans are equal.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>other</span><span class=p>,</span> <span class=n>Plan</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>False</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_actions</span><span class=p>()</span> <span class=o>==</span> <span class=n>other</span><span class=o>.</span><span class=n>get_actions</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.models.plans.Plan-functions>Functions<a href=#trestle.core.models.plans.Plan-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.plans.Plan.__eq__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__eq__</span><span class=p>(</span><span class=n>other</span><span class=p>)</span></code> <a href=#trestle.core.models.plans.Plan.__eq__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Check that two plans are equal.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__eq__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>other</span><span class=p>:</span> <span class=nb>object</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check that two plans are equal.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>other</span><span class=p>,</span> <span class=n>Plan</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_actions</span><span class=p>()</span> <span class=o>==</span> <span class=n>other</span><span class=o>.</span><span class=n>get_actions</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.plans.Plan.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.models.plans.Plan.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize a plan.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize a plan.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.plans.Plan.__str__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__str__</span><span class=p>()</span></code> <a href=#trestle.core.models.plans.Plan.__str__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the plan.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__str__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the plan.&quot;&quot;&quot;</span>
+    <span class=n>list_actions</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>index</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=k>for</span> <span class=n>action</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=p>:</span>
+        <span class=n>list_actions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>index</span><span class=si>}</span><span class=s1>. </span><span class=si>{</span><span class=n>action</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>index</span> <span class=o>=</span> <span class=n>index</span> <span class=o>+</span> <span class=mi>1</span>
+
+    <span class=n>list_str</span> <span class=o>=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>list_actions</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>list_str</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.plans.Plan.add_action class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_action</span><span class=p>(</span><span class=n>action</span><span class=p>)</span></code> <a href=#trestle.core.models.plans.Plan.add_action class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add a new action.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_action</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>action</span><span class=p>:</span> <span class=n>Action</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add a new action.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>action</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.plans.Plan.add_actions class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_actions</span><span class=p>(</span><span class=n>actions</span><span class=p>)</span></code> <a href=#trestle.core.models.plans.Plan.add_actions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add actions in order.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_actions</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>actions</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add actions in order.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>actions</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.plans.Plan.clear_actions class="doc doc-heading"> <code class="highlight language-python"><span class=n>clear_actions</span><span class=p>()</span></code> <a href=#trestle.core.models.plans.Plan.clear_actions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Clear all actions.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>clear_actions</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Clear all actions.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span> <span class=o>=</span> <span class=p>[]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.plans.Plan.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.core.models.plans.Plan.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the actions in the plan.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the actions in the plan.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>action</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>action</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Failed to execute action </span><span class=si>{</span><span class=n>action</span><span class=si>}</span><span class=s1> for the plan: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>. Rolling back.&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>rollback</span><span class=p>()</span>
+            <span class=k>raise</span> <span class=n>e</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.plans.Plan.get_actions class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_actions</span><span class=p>()</span></code> <a href=#trestle.core.models.plans.Plan.get_actions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get all actions.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_actions</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get all actions.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_actions</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.models.plans.Plan.rollback class="doc doc-heading"> <code class="highlight language-python"><span class=n>rollback</span><span class=p>()</span></code> <a href=#trestle.core.models.plans.Plan.rollback class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Rollback the actions in the plan.</p> <details class=quote> <summary>Source code in <code>trestle/core/models/plans.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rollback</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Rollback the actions in the plan.&quot;&quot;&quot;</span>
+    <span class=c1># execute in reverse order</span>
+    <span class=k>for</span> <span class=n>action</span> <span class=ow>in</span> <span class=nb>reversed</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_actions</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>action</span><span class=o>.</span><span class=n>has_rollback</span><span class=p>()</span> <span class=ow>is</span> <span class=kc>False</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>UnsupportedOperation</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>action</span><span class=o>.</span><span class=n>get_type</span><span class=p>()</span><span class=si>}</span><span class=s1> does not support rollback&#39;</span><span class=p>)</span>
+        <span class=n>action</span><span class=o>.</span><span class=n>rollback</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/object_factory/index.html b/latest/reference/API/trestle/core/object_factory/index.html
new file mode 100644
index 000000000..6ec4cd0b4
--- /dev/null
+++ b/latest/reference/API/trestle/core/object_factory/index.html
@@ -0,0 +1,76 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.object_factory module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/object_factory/ rel=canonical><link href=../links_validator/ rel=prev><link href=../parser/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.object_factory - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.object_factory - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.object_factory module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/object_factory.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/object_factory/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.object_factory - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.object_factory module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/object_factory.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.object_factory class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.object_factory </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.object_factory </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.object_factory </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.object_factory class=md-nav__link> <span class=md-ellipsis> object_factory </span> </a> <nav class=md-nav aria-label=object_factory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.object_factory-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory class=md-nav__link> <span class=md-ellipsis> ObjectFactory </span> </a> <nav class=md-nav aria-label=ObjectFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory.get_all class=md-nav__link> <span class=md-ellipsis> get_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory.register_object class=md-nav__link> <span class=md-ellipsis> register_object </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.object_factory class=md-nav__link> <span class=md-ellipsis> object_factory </span> </a> <nav class=md-nav aria-label=object_factory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.object_factory-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory class=md-nav__link> <span class=md-ellipsis> ObjectFactory </span> </a> <nav class=md-nav aria-label=ObjectFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory.get_all class=md-nav__link> <span class=md-ellipsis> get_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.object_factory.ObjectFactory.register_object class=md-nav__link> <span class=md-ellipsis> register_object </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.object_factory</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.object_factory class="doc doc-heading"> <code>trestle.core.object_factory</code> <a href=#trestle.core.object_factory class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Generic object factory.</p> <div class="doc doc-children"> <h3 id=trestle.core.object_factory-classes>Classes<a href=#trestle.core.object_factory-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.object_factory.ObjectFactory class="doc doc-heading"> <code>ObjectFactory</code> <a href=#trestle.core.object_factory.ObjectFactory class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Allow registration and creation of factory objects.</p> <details class=quote> <summary>Source code in <code>trestle/core/object_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>22</span>
+<span class=normal>23</span>
+<span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ObjectFactory</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Allow registration and creation of factory objects.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the objects dictionary as empty.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_objects</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=k>def</span> <span class=nf>register_object</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>mode</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>obj</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Register an object to the object factory.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            mode: Descriptive key for the mode / type of object to be retrieved.</span>
+<span class=sd>            obj: The object type to be registered.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_objects</span><span class=p>[</span><span class=n>mode</span><span class=p>]</span> <span class=o>=</span> <span class=n>obj</span>
+
+    <span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create the object from the args.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_objects</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>mode</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_all</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ValuesView</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get all registered objects.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_objects</span><span class=o>.</span><span class=n>values</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.object_factory.ObjectFactory-functions>Functions<a href=#trestle.core.object_factory.ObjectFactory-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.object_factory.ObjectFactory.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.object_factory.ObjectFactory.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the objects dictionary as empty.</p> <details class=quote> <summary>Source code in <code>trestle/core/object_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the objects dictionary as empty.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_objects</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.object_factory.ObjectFactory.get class="doc doc-heading"> <code class="highlight language-python"><span class=n>get</span><span class=p>(</span><span class=n>args</span><span class=p>)</span></code> <a href=#trestle.core.object_factory.ObjectFactory.get class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create the object from the args.</p> <details class=quote> <summary>Source code in <code>trestle/core/object_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Create the object from the args.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_objects</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>mode</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.object_factory.ObjectFactory.get_all class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_all</span><span class=p>()</span></code> <a href=#trestle.core.object_factory.ObjectFactory.get_all class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get all registered objects.</p> <details class=quote> <summary>Source code in <code>trestle/core/object_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_all</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ValuesView</span><span class=p>[</span><span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get all registered objects.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_objects</span><span class=o>.</span><span class=n>values</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.object_factory.ObjectFactory.register_object class="doc doc-heading"> <code class="highlight language-python"><span class=n>register_object</span><span class=p>(</span><span class=n>mode</span><span class=p>,</span> <span class=n>obj</span><span class=p>)</span></code> <a href=#trestle.core.object_factory.ObjectFactory.register_object class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Register an object to the object factory.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>mode</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Descriptive key for the mode / type of object to be retrieved.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>obj</code> </td> <td> <code><span title=typing.Any>Any</span></code> </td> <td> <div class=doc-md-description> <p>The object type to be registered.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/object_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>register_object</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>mode</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>obj</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Register an object to the object factory.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        mode: Descriptive key for the mode / type of object to be retrieved.</span>
+<span class=sd>        obj: The object type to be registered.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_objects</span><span class=p>[</span><span class=n>mode</span><span class=p>]</span> <span class=o>=</span> <span class=n>obj</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/parser/index.html b/latest/reference/API/trestle/core/parser/index.html
new file mode 100644
index 000000000..6dc4cc119
--- /dev/null
+++ b/latest/reference/API/trestle/core/parser/index.html
@@ -0,0 +1,98 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.parser module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/parser/ rel=canonical><link href=../object_factory/ rel=prev><link href=../pipeline/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.parser - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.parser - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.parser module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/parser.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/parser/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.parser - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.parser module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/parser.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.parser class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.parser </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.parser </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.parser </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.parser class=md-nav__link> <span class=md-ellipsis> parser </span> </a> <nav class=md-nav aria-label=parser> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.parser-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.parser.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.parser-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.parser-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.parser.parse_dict class=md-nav__link> <span class=md-ellipsis> parse_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.parser.root_key class=md-nav__link> <span class=md-ellipsis> root_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.parser.to_full_model_name class=md-nav__link> <span class=md-ellipsis> to_full_model_name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.parser class=md-nav__link> <span class=md-ellipsis> parser </span> </a> <nav class=md-nav aria-label=parser> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.parser-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.parser.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.parser-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.parser-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.parser.parse_dict class=md-nav__link> <span class=md-ellipsis> parse_dict </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.parser.root_key class=md-nav__link> <span class=md-ellipsis> root_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.parser.to_full_model_name class=md-nav__link> <span class=md-ellipsis> to_full_model_name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.parser</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.parser class="doc doc-heading"> <code>trestle.core.parser</code> <a href=#trestle.core.parser class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Model parsing for use when models themselves must be inferred and are not known.</p> <p>Under most use cases trestle.core.base_model.OscalBaseModel provides functionality for loading Oscal models from files. However, under some circumstances the model internals are unknown. Use of this module should be avoided unless the BaseModel functionality is inadequate.</p> <div class="doc doc-children"> <h3 id=trestle.core.parser-attributes>Attributes<a href=#trestle.core.parser-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.parser.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.parser.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.parser-classes>Classes<a href=#trestle.core.parser-classes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.core.parser-functions>Functions<a href=#trestle.core.parser-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.core.parser.parse_dict class="doc doc-heading"> <code class="highlight language-python"><span class=n>parse_dict</span><span class=p>(</span><span class=n>data</span><span class=p>,</span> <span class=n>model_name</span><span class=p>)</span></code> <a href=#trestle.core.parser.parse_dict class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Load a model from the data dict.</p> <p>This functionality is provided for situations when the OSCAL data type is not known ahead of time. Here the model has been loaded into memory using json loads or similar and passed as a dict.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>data</code> </td> <td> <code><span title=typing.Dict>Dict</span>[str, <span title=typing.Any>Any</span>]</code> </td> <td> <div class=doc-md-description> <p>Oscal data loaded into memory as a dictionary with the <code>root key</code> removed.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>model_name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>should be of the form 'module.class' from trestle.oscal.* modules</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code> </td> <td> <div class=doc-md-description> <p>The oscal model of the desired model.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/parser.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>parse_dict</span><span class=p>(</span><span class=n>data</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>model_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>OscalBaseModel</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Load a model from the data dict.</span>
+
+<span class=sd>    This functionality is provided for situations when the OSCAL data type is not known ahead of time. Here the model</span>
+<span class=sd>    has been loaded into memory using json loads or similar and passed as a dict.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        data: Oscal data loaded into memory as a dictionary with the `root key` removed.</span>
+<span class=sd>        model_name: should be of the form &#39;module.class&#39; from trestle.oscal.* modules</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The oscal model of the desired model.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>data</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;data name is required&#39;</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>model_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;model_name is required&#39;</span><span class=p>)</span>
+
+    <span class=n>parts</span> <span class=o>=</span> <span class=n>model_name</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+    <span class=n>class_name</span> <span class=o>=</span> <span class=n>parts</span><span class=o>.</span><span class=n>pop</span><span class=p>()</span>
+    <span class=n>module_name</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>parts</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Loading class &quot;</span><span class=si>{</span><span class=n>class_name</span><span class=si>}</span><span class=s1>&quot; from &quot;</span><span class=si>{</span><span class=n>module_name</span><span class=si>}</span><span class=s1>&quot;&#39;</span><span class=p>)</span>
+    <span class=n>module</span> <span class=o>=</span> <span class=n>importlib</span><span class=o>.</span><span class=n>import_module</span><span class=p>(</span><span class=n>module_name</span><span class=p>)</span>
+    <span class=n>mclass</span><span class=p>:</span> <span class=n>OscalBaseModel</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>module</span><span class=p>,</span> <span class=n>class_name</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>mclass</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;class &quot;</span><span class=si>{</span><span class=n>class_name</span><span class=si>}</span><span class=s1>&quot; could not be found in &quot;</span><span class=si>{</span><span class=n>module_name</span><span class=si>}</span><span class=s1>&quot;&#39;</span><span class=p>)</span>
+
+    <span class=n>instance</span> <span class=o>=</span> <span class=n>mclass</span><span class=o>.</span><span class=n>parse_obj</span><span class=p>(</span><span class=n>data</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>instance</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.parser.root_key class="doc doc-heading"> <code class="highlight language-python"><span class=n>root_key</span><span class=p>(</span><span class=n>data</span><span class=p>)</span></code> <a href=#trestle.core.parser.root_key class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Find root model name in the data.</p> <details class=quote> <summary>Source code in <code>trestle/core/parser.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>root_key</span><span class=p>(</span><span class=n>data</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Find root model name in the data.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>data</span><span class=o>.</span><span class=n>items</span><span class=p>())</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=k>return</span> <span class=nb>next</span><span class=p>(</span><span class=nb>iter</span><span class=p>(</span><span class=n>data</span><span class=p>))</span>
+
+    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;data does not contain a root key&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.core.parser.to_full_model_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>root_key</span><span class=p>)</span></code> <a href=#trestle.core.parser.to_full_model_name class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Find model name from the root_key in the file.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>root_key</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>root key such as 'system-security-plan' from a top level OSCAL model.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/parser.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>to_full_model_name</span><span class=p>(</span><span class=n>root_key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Find model name from the root_key in the file.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        root_key: root key such as &#39;system-security-plan&#39; from a top level OSCAL model.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>root_key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>root_key</span><span class=si>}</span><span class=s1> is not a top level model name.&#39;</span><span class=p>)</span>
+
+    <span class=n>module</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_TO_MODEL_MODULE</span><span class=p>[</span><span class=n>root_key</span><span class=p>]</span>
+    <span class=n>class_name</span> <span class=o>=</span> <span class=n>alias_to_classname</span><span class=p>(</span><span class=n>root_key</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>module</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>class_name</span><span class=si>}</span><span class=s1>&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/pipeline/index.html b/latest/reference/API/trestle/core/pipeline/index.html
new file mode 100644
index 000000000..4d7826927
--- /dev/null
+++ b/latest/reference/API/trestle/core/pipeline/index.html
@@ -0,0 +1,74 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.pipeline module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/pipeline/ rel=canonical><link href=../parser/ rel=prev><link href=../plugins/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.pipeline - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.pipeline - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.pipeline module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/pipeline.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/pipeline/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.pipeline - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.pipeline module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/pipeline.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.pipeline class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.pipeline </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.pipeline </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.pipeline </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.pipeline class=md-nav__link> <span class=md-ellipsis> pipeline </span> </a> <nav class=md-nav aria-label=pipeline> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline class=md-nav__link> <span class=md-ellipsis> Pipeline </span> </a> <nav class=md-nav aria-label=Pipeline> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline.Filter class=md-nav__link> <span class=md-ellipsis> Filter </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline.process class=md-nav__link> <span class=md-ellipsis> process </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.pipeline class=md-nav__link> <span class=md-ellipsis> pipeline </span> </a> <nav class=md-nav aria-label=pipeline> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline class=md-nav__link> <span class=md-ellipsis> Pipeline </span> </a> <nav class=md-nav aria-label=Pipeline> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline.Filter class=md-nav__link> <span class=md-ellipsis> Filter </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.pipeline.Pipeline.process class=md-nav__link> <span class=md-ellipsis> process </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.pipeline</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.pipeline class="doc doc-heading"> <code>trestle.core.pipeline</code> <a href=#trestle.core.pipeline class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Abstract base class for pipelines and filters.</p> <div class="doc doc-children"> <h3 id=trestle.core.pipeline-classes>Classes<a href=#trestle.core.pipeline-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.pipeline.Pipeline class="doc doc-heading"> <code>Pipeline</code> <a href=#trestle.core.pipeline.Pipeline class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Pipeline base class.</p> <details class=quote> <summary>Source code in <code>trestle/core/pipeline.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>20</span>
+<span class=normal>21</span>
+<span class=normal>22</span>
+<span class=normal>23</span>
+<span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Pipeline</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Pipeline base class.&quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Filter</span><span class=p>(</span><span class=n>ABC</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Filter class used by pipeline.&quot;&quot;&quot;</span>
+
+        <span class=nd>@abstractclassmethod</span>
+        <span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>input_</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>            </span><span class=sd>&quot;&quot;&quot;Process the input to output.&quot;&quot;&quot;</span>
+            <span class=k>return</span> <span class=n>input_</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>filters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Filter</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_filters</span> <span class=o>=</span> <span class=n>filters</span>
+
+    <span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>input_</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Process the filter pipeline.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>filter_</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_filters</span><span class=p>:</span>
+            <span class=n>input_</span> <span class=o>=</span> <span class=n>filter_</span><span class=o>.</span><span class=n>process</span><span class=p>(</span><span class=n>input_</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>input_</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.pipeline.Pipeline-classes>Classes<a href=#trestle.core.pipeline.Pipeline-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.core.pipeline.Pipeline.Filter class="doc doc-heading"> <code>Filter</code> <a href=#trestle.core.pipeline.Pipeline.Filter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=abc.ABC>ABC</span></code></p> <p>Filter class used by pipeline.</p> <details class=quote> <summary>Source code in <code>trestle/core/pipeline.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>23</span>
+<span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Filter</span><span class=p>(</span><span class=n>ABC</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Filter class used by pipeline.&quot;&quot;&quot;</span>
+
+    <span class=nd>@abstractclassmethod</span>
+    <span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>input_</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Process the input to output.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>input_</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.core.pipeline.Pipeline.Filter-functions>Functions<a href=#trestle.core.pipeline.Pipeline.Filter-functions class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-function"> <h8 id=trestle.core.pipeline.Pipeline.Filter.process class="doc doc-heading"> <code class="highlight language-python"><span class=n>process</span><span class=p>(</span><span class=n>input_</span><span class=p>)</span></code> <a href=#trestle.core.pipeline.Pipeline.Filter.process class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> <p>Process the input to output.</p> <details class=quote> <summary>Source code in <code>trestle/core/pipeline.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractclassmethod</span>
+<span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>input_</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Process the input to output.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>input_</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h5 id=trestle.core.pipeline.Pipeline-functions>Functions<a href=#trestle.core.pipeline.Pipeline-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.pipeline.Pipeline.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>filters</span><span class=p>)</span></code> <a href=#trestle.core.pipeline.Pipeline.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class.</p> <details class=quote> <summary>Source code in <code>trestle/core/pipeline.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>filters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Filter</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_filters</span> <span class=o>=</span> <span class=n>filters</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.pipeline.Pipeline.process class="doc doc-heading"> <code class="highlight language-python"><span class=n>process</span><span class=p>(</span><span class=n>input_</span><span class=p>)</span></code> <a href=#trestle.core.pipeline.Pipeline.process class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Process the filter pipeline.</p> <details class=quote> <summary>Source code in <code>trestle/core/pipeline.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>input_</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Process the filter pipeline.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>filter_</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_filters</span><span class=p>:</span>
+        <span class=n>input_</span> <span class=o>=</span> <span class=n>filter_</span><span class=o>.</span><span class=n>process</span><span class=p>(</span><span class=n>input_</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>input_</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/plugins/index.html b/latest/reference/API/trestle/core/plugins/index.html
new file mode 100644
index 000000000..4c3f60564
--- /dev/null
+++ b/latest/reference/API/trestle/core/plugins/index.html
@@ -0,0 +1,24 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.plugins module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/plugins/ rel=canonical><link href=../pipeline/ rel=prev><link href=../profile_resolver/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.plugins - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.plugins - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.plugins module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/plugins.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/plugins/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.plugins - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.plugins module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/plugins.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.plugins class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.plugins </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.plugins </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.plugins </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.plugins class=md-nav__link> <span class=md-ellipsis> plugins </span> </a> <nav class=md-nav aria-label=plugins> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.plugins-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.plugins.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.plugins-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.plugins.discovered_plugins class=md-nav__link> <span class=md-ellipsis> discovered_plugins </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.plugins class=md-nav__link> <span class=md-ellipsis> plugins </span> </a> <nav class=md-nav aria-label=plugins> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.plugins-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.plugins.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.plugins-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.plugins.discovered_plugins class=md-nav__link> <span class=md-ellipsis> discovered_plugins </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.plugins</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.plugins class="doc doc-heading"> <code>trestle.core.plugins</code> <a href=#trestle.core.plugins class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Plugin discovery code.</p> <div class="doc doc-children"> <h3 id=trestle.core.plugins-attributes>Attributes<a href=#trestle.core.plugins-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.plugins.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.plugins.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.plugins-functions>Functions<a href=#trestle.core.plugins-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.core.plugins.discovered_plugins class="doc doc-heading"> <code class="highlight language-python"><span class=n>discovered_plugins</span><span class=p>(</span><span class=n>search_module</span><span class=p>)</span></code> <a href=#trestle.core.plugins.discovered_plugins class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Yield discovered plugin classes within a given module name.</p> <details class=quote> <summary>Source code in <code>trestle/core/plugins.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>discovered_plugins</span><span class=p>(</span><span class=n>search_module</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Yield discovered plugin classes within a given module name.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>_discovered_plugins</span><span class=p>)</span>
+    <span class=c1># This block is uncovered as trestle cannot find plugins in it&#39;s unit tests - it is the base module.</span>
+    <span class=k>for</span> <span class=n>plugin</span><span class=p>,</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>_discovered_plugins</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>  <span class=c1># pragma: nocover</span>
+        <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>module</span><span class=p>,</span> <span class=n>_</span> <span class=ow>in</span> <span class=n>pkgutil</span><span class=o>.</span><span class=n>iter_modules</span><span class=p>([</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>value</span><span class=o>.</span><span class=n>__path__</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>search_module</span><span class=p>)]):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>module</span><span class=p>)</span>
+            <span class=n>plugin_module</span> <span class=o>=</span> <span class=n>importlib</span><span class=o>.</span><span class=n>import_module</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>plugin</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>search_module</span><span class=si>}</span><span class=s1>.</span><span class=si>{</span><span class=n>module</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>clsmembers</span> <span class=o>=</span> <span class=n>inspect</span><span class=o>.</span><span class=n>getmembers</span><span class=p>(</span><span class=n>plugin_module</span><span class=p>,</span> <span class=n>inspect</span><span class=o>.</span><span class=n>isclass</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>clsmembers</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>_</span><span class=p>,</span> <span class=n>plugin_cls</span> <span class=ow>in</span> <span class=n>clsmembers</span><span class=p>:</span>
+                <span class=k>yield</span> <span class=p>(</span><span class=n>plugin</span><span class=p>,</span> <span class=n>plugin_cls</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/profile_resolver/index.html b/latest/reference/API/trestle/core/profile_resolver/index.html
new file mode 100644
index 000000000..6e8906b75
--- /dev/null
+++ b/latest/reference/API/trestle/core/profile_resolver/index.html
@@ -0,0 +1,434 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.profile_resolver module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/profile_resolver/ rel=canonical><link href=../plugins/ rel=prev><link href=../refs_validator/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.profile_resolver - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.profile_resolver - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.profile_resolver module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/profile_resolver.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/profile_resolver/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.profile_resolver - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.profile_resolver module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/profile_resolver.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.profile_resolver class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.profile_resolver </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.profile_resolver </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.profile_resolver class=md-nav__link> <span class=md-ellipsis> profile_resolver </span> </a> <nav class=md-nav aria-label=profile_resolver> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.profile_resolver-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.ProfileResolver class=md-nav__link> <span class=md-ellipsis> ProfileResolver </span> </a> <nav class=md-nav aria-label=ProfileResolver> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.ProfileResolver-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog class=md-nav__link> <span class=md-ellipsis> get_resolved_profile_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog_and_inherited_props class=md-nav__link> <span class=md-ellipsis> get_resolved_profile_catalog_and_inherited_props </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.profile_resolver-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.profile_resolver class=md-nav__link> <span class=md-ellipsis> profile_resolver </span> </a> <nav class=md-nav aria-label=profile_resolver> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.profile_resolver-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.ProfileResolver class=md-nav__link> <span class=md-ellipsis> ProfileResolver </span> </a> <nav class=md-nav aria-label=ProfileResolver> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.ProfileResolver-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog class=md-nav__link> <span class=md-ellipsis> get_resolved_profile_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog_and_inherited_props class=md-nav__link> <span class=md-ellipsis> get_resolved_profile_catalog_and_inherited_props </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.profile_resolver-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.profile_resolver</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.profile_resolver class="doc doc-heading"> <code>trestle.core.profile_resolver</code> <a href=#trestle.core.profile_resolver class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Create resolved catalog from profile.</p> <div class="doc doc-children"> <h3 id=trestle.core.profile_resolver-attributes>Attributes<a href=#trestle.core.profile_resolver-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.profile_resolver.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.profile_resolver.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.profile_resolver-classes>Classes<a href=#trestle.core.profile_resolver-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.profile_resolver.ProfileResolver class="doc doc-heading"> <code>ProfileResolver</code> <a href=#trestle.core.profile_resolver.ProfileResolver class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class to resolve a catalog given a profile.</p> <details class=quote> <summary>Source code in <code>trestle/core/profile_resolver.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ProfileResolver</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Class to resolve a catalog given a profile.&quot;&quot;&quot;</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_extract_inherited_props</span><span class=p>(</span><span class=n>res_cat</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Build the control dict of inherited props.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            The resolved profile catalog with a possible temporary part in each control</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The temporary parts are removed from each control and a Dict of added props per control_id is returned</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>        If an upstream profile adds props to the control they are tracked in a special temporary part in the control</span>
+<span class=sd>        called const.TRESTLE_INHERITED_PROPS_TRACKER.  If that part is present in a control its contents should be added</span>
+<span class=sd>        to the dict entry for that control, and the part removed from the control.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>prop_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>cat_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>res_cat</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=n>part</span><span class=p>:</span> <span class=n>com</span><span class=o>.</span><span class=n>Part</span> <span class=o>=</span> <span class=n>pop_item_from_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=n>TRESTLE_INHERITED_PROPS_TRACKER</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>part</span><span class=p>:</span>
+                <span class=n>props_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+                    <span class=n>props_list</span><span class=o>.</span><span class=n>append</span><span class=p>({</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;value&#39;</span><span class=p>:</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>})</span>
+                <span class=k>for</span> <span class=n>sub_part</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>):</span>
+                    <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>sub_part</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+                        <span class=n>props_list</span><span class=o>.</span><span class=n>append</span><span class=p>({</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;value&#39;</span><span class=p>:</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>,</span> <span class=s1>&#39;part_name&#39;</span><span class=p>:</span> <span class=n>sub_part</span><span class=o>.</span><span class=n>title</span><span class=p>})</span>
+                <span class=n>prop_dict</span><span class=p>[</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>props_list</span>
+        <span class=n>cat_interface</span><span class=o>.</span><span class=n>update_catalog_controls</span><span class=p>()</span>
+        <span class=n>clean_res_cat</span> <span class=o>=</span> <span class=n>cat_interface</span><span class=o>.</span><span class=n>get_catalog</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>clean_res_cat</span><span class=p>,</span> <span class=n>prop_dict</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_resolved_profile_catalog_and_inherited_props</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>profile_path</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>block_adds</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>block_params</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Create the resolved profile catalog given a profile path along with inherited props.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: root directory of the trestle workspace</span>
+<span class=sd>            profile_path: string path or uri of the profile being resolved</span>
+<span class=sd>            block_adds: prevent the application of adds in the final profile</span>
+<span class=sd>            block_params: prevent the application of setparams in the final profile</span>
+<span class=sd>            params_format: optional pattern with dot to wrap the param string, where dot represents the param string</span>
+<span class=sd>            param_rep: desired way to convert params to strings</span>
+<span class=sd>            show_value_warnings: warn if prose references a value that has not been set</span>
+<span class=sd>            value_assigned_prefix: Prefix placed in front of param string if a value was assigned</span>
+<span class=sd>            value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The resolved profile catalog and a control dict of inherited props</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get resolved profile catalog and inherited props for </span><span class=si>{</span><span class=n>profile_path</span><span class=si>}</span><span class=s1> via generated Import.&#39;</span><span class=p>)</span>
+        <span class=n>import_</span> <span class=o>=</span> <span class=n>prof</span><span class=o>.</span><span class=n>Import</span><span class=p>(</span><span class=n>href</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>profile_path</span><span class=p>),</span> <span class=n>include_all</span><span class=o>=</span><span class=p>{})</span>
+        <span class=c1># The final Import has change_prose=True to force parameter substitution in the prose only at the last stage.</span>
+        <span class=n>import_filter</span> <span class=o>=</span> <span class=n>Import</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>import_</span><span class=p>,</span> <span class=p>[],</span>
+            <span class=kc>True</span><span class=p>,</span>
+            <span class=n>block_adds</span><span class=p>,</span>
+            <span class=n>block_params</span><span class=p>,</span>
+            <span class=n>params_format</span><span class=p>,</span>
+            <span class=n>param_rep</span><span class=p>,</span>
+            <span class=kc>None</span><span class=p>,</span>
+            <span class=n>show_value_warnings</span><span class=p>,</span>
+            <span class=n>value_assigned_prefix</span><span class=p>,</span>
+            <span class=n>value_not_assigned_prefix</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;launch pipeline&#39;</span><span class=p>)</span>
+        <span class=n>resolved_profile_catalog</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=n>import_filter</span><span class=o>.</span><span class=n>process</span><span class=p>())</span>
+        <span class=n>resolved_profile_catalog</span><span class=p>,</span> <span class=n>inherited_props</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=o>.</span><span class=n>_extract_inherited_props</span><span class=p>(</span><span class=n>resolved_profile_catalog</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>resolved_profile_catalog</span><span class=p>,</span> <span class=n>inherited_props</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_resolved_profile_catalog</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>profile_path</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>block_adds</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>block_params</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Create the resolved profile catalog given a profile path.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: root directory of the trestle workspace</span>
+<span class=sd>            profile_path: string path or uri of the profile being resolved</span>
+<span class=sd>            block_adds: prevent the application of adds in the final profile</span>
+<span class=sd>            block_params: prevent the application of setparams in the final profile</span>
+<span class=sd>            params_format: optional pattern with dot to wrap the param string, where dot represents the param string</span>
+<span class=sd>            param_rep: desired way to convert params to strings</span>
+<span class=sd>            show_value_warnings: warn if prose references a value that has not been set</span>
+<span class=sd>            value_assigned_prefix: Prefix placed in front of param string if a value was assigned</span>
+<span class=sd>            value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            The resolved profile catalog</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get resolved profile catalog for </span><span class=si>{</span><span class=n>profile_path</span><span class=si>}</span><span class=s1> via generated Import.&#39;</span><span class=p>)</span>
+        <span class=n>resolved_profile_catalog</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog_and_inherited_props</span><span class=p>(</span>
+            <span class=n>trestle_root</span><span class=p>,</span>
+            <span class=n>profile_path</span><span class=p>,</span>
+            <span class=n>block_adds</span><span class=p>,</span>
+            <span class=n>block_params</span><span class=p>,</span>
+            <span class=n>params_format</span><span class=p>,</span>
+            <span class=n>param_rep</span><span class=p>,</span>
+            <span class=n>show_value_warnings</span><span class=p>,</span>
+            <span class=n>value_assigned_prefix</span><span class=p>,</span>
+            <span class=n>value_not_assigned_prefix</span>
+        <span class=p>)</span>
+        <span class=k>return</span> <span class=n>resolved_profile_catalog</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.profile_resolver.ProfileResolver-functions>Functions<a href=#trestle.core.profile_resolver.ProfileResolver-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_resolved_profile_catalog</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_path</span><span class=p>,</span> <span class=n>block_adds</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>block_params</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>params_format</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>,</span> <span class=n>show_value_warnings</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create the resolved profile catalog given a profile path.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>root directory of the trestle workspace</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>profile_path</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>string path or uri of the profile being resolved</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>block_adds</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>prevent the application of adds in the final profile</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>block_params</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>prevent the application of setparams in the final profile</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>params_format</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>optional pattern with dot to wrap the param string, where dot represents the param string</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>param_rep</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_interface.ParameterRep href=../control_interface/#trestle.core.control_interface.ParameterRep>ParameterRep</a></code> </td> <td> <div class=doc-md-description> <p>desired way to convert params to strings</p> </div> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_interface.ParameterRep.LEAVE_MOUSTACHE href=../control_interface/#trestle.core.control_interface.ParameterRep.LEAVE_MOUSTACHE>LEAVE_MOUSTACHE</a></code> </td> </tr> <tr class=doc-section-item> <td> <code>show_value_warnings</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>warn if prose references a value that has not been set</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>value_assigned_prefix</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Prefix placed in front of param string if a value was assigned</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>value_not_assigned_prefix</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Prefix placed in front of param string if a value was <em>not</em> assigned</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.oscal.catalog.Catalog href=../../oscal/catalog/#trestle.oscal.catalog.Catalog>Catalog</a></code> </td> <td> <div class=doc-md-description> <p>The resolved profile catalog</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/profile_resolver.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_resolved_profile_catalog</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>profile_path</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>block_adds</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>block_params</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>,</span>
+    <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Create the resolved profile catalog given a profile path.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: root directory of the trestle workspace</span>
+<span class=sd>        profile_path: string path or uri of the profile being resolved</span>
+<span class=sd>        block_adds: prevent the application of adds in the final profile</span>
+<span class=sd>        block_params: prevent the application of setparams in the final profile</span>
+<span class=sd>        params_format: optional pattern with dot to wrap the param string, where dot represents the param string</span>
+<span class=sd>        param_rep: desired way to convert params to strings</span>
+<span class=sd>        show_value_warnings: warn if prose references a value that has not been set</span>
+<span class=sd>        value_assigned_prefix: Prefix placed in front of param string if a value was assigned</span>
+<span class=sd>        value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The resolved profile catalog</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get resolved profile catalog for </span><span class=si>{</span><span class=n>profile_path</span><span class=si>}</span><span class=s1> via generated Import.&#39;</span><span class=p>)</span>
+    <span class=n>resolved_profile_catalog</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=o>.</span><span class=n>get_resolved_profile_catalog_and_inherited_props</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span>
+        <span class=n>profile_path</span><span class=p>,</span>
+        <span class=n>block_adds</span><span class=p>,</span>
+        <span class=n>block_params</span><span class=p>,</span>
+        <span class=n>params_format</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span>
+    <span class=p>)</span>
+    <span class=k>return</span> <span class=n>resolved_profile_catalog</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog_and_inherited_props class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_resolved_profile_catalog_and_inherited_props</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>profile_path</span><span class=p>,</span> <span class=n>block_adds</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>block_params</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>params_format</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>,</span> <span class=n>show_value_warnings</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog_and_inherited_props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create the resolved profile catalog given a profile path along with inherited props.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>root directory of the trestle workspace</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>profile_path</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>string path or uri of the profile being resolved</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>block_adds</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>prevent the application of adds in the final profile</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>block_params</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>prevent the application of setparams in the final profile</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>params_format</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>optional pattern with dot to wrap the param string, where dot represents the param string</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>param_rep</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_interface.ParameterRep href=../control_interface/#trestle.core.control_interface.ParameterRep>ParameterRep</a></code> </td> <td> <div class=doc-md-description> <p>desired way to convert params to strings</p> </div> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.core.control_interface.ParameterRep.LEAVE_MOUSTACHE href=../control_interface/#trestle.core.control_interface.ParameterRep.LEAVE_MOUSTACHE>LEAVE_MOUSTACHE</a></code> </td> </tr> <tr class=doc-section-item> <td> <code>show_value_warnings</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>warn if prose references a value that has not been set</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>value_assigned_prefix</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Prefix placed in front of param string if a value was assigned</p> </div> </td> <td> <code>None</code> </td> </tr> <tr class=doc-section-item> <td> <code>value_not_assigned_prefix</code> </td> <td> <code><span title=typing.Optional>Optional</span>[str]</code> </td> <td> <div class=doc-md-description> <p>Prefix placed in front of param string if a value was <em>not</em> assigned</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Tuple>Tuple</span>[<a class="autorefs autorefs-internal" title=trestle.oscal.catalog.Catalog href=../../oscal/catalog/#trestle.oscal.catalog.Catalog>Catalog</a>, <span title=typing.Optional>Optional</span>[<span title=typing.Dict>Dict</span>[str, <span title=typing.Any>Any</span>]]]</code> </td> <td> <div class=doc-md-description> <p>The resolved profile catalog and a control dict of inherited props</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/profile_resolver.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_resolved_profile_catalog_and_inherited_props</span><span class=p>(</span>
+    <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>profile_path</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>block_adds</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>block_params</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>params_format</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>,</span>
+    <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Create the resolved profile catalog given a profile path along with inherited props.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: root directory of the trestle workspace</span>
+<span class=sd>        profile_path: string path or uri of the profile being resolved</span>
+<span class=sd>        block_adds: prevent the application of adds in the final profile</span>
+<span class=sd>        block_params: prevent the application of setparams in the final profile</span>
+<span class=sd>        params_format: optional pattern with dot to wrap the param string, where dot represents the param string</span>
+<span class=sd>        param_rep: desired way to convert params to strings</span>
+<span class=sd>        show_value_warnings: warn if prose references a value that has not been set</span>
+<span class=sd>        value_assigned_prefix: Prefix placed in front of param string if a value was assigned</span>
+<span class=sd>        value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        The resolved profile catalog and a control dict of inherited props</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get resolved profile catalog and inherited props for </span><span class=si>{</span><span class=n>profile_path</span><span class=si>}</span><span class=s1> via generated Import.&#39;</span><span class=p>)</span>
+    <span class=n>import_</span> <span class=o>=</span> <span class=n>prof</span><span class=o>.</span><span class=n>Import</span><span class=p>(</span><span class=n>href</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>profile_path</span><span class=p>),</span> <span class=n>include_all</span><span class=o>=</span><span class=p>{})</span>
+    <span class=c1># The final Import has change_prose=True to force parameter substitution in the prose only at the last stage.</span>
+    <span class=n>import_filter</span> <span class=o>=</span> <span class=n>Import</span><span class=p>(</span>
+        <span class=n>trestle_root</span><span class=p>,</span>
+        <span class=n>import_</span><span class=p>,</span> <span class=p>[],</span>
+        <span class=kc>True</span><span class=p>,</span>
+        <span class=n>block_adds</span><span class=p>,</span>
+        <span class=n>block_params</span><span class=p>,</span>
+        <span class=n>params_format</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>,</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;launch pipeline&#39;</span><span class=p>)</span>
+    <span class=n>resolved_profile_catalog</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=n>import_filter</span><span class=o>.</span><span class=n>process</span><span class=p>())</span>
+    <span class=n>resolved_profile_catalog</span><span class=p>,</span> <span class=n>inherited_props</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=o>.</span><span class=n>_extract_inherited_props</span><span class=p>(</span><span class=n>resolved_profile_catalog</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>resolved_profile_catalog</span><span class=p>,</span> <span class=n>inherited_props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.profile_resolver-functions>Functions<a href=#trestle.core.profile_resolver-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/refs_validator/index.html b/latest/reference/API/trestle/core/refs_validator/index.html
new file mode 100644
index 000000000..7ed9cf833
--- /dev/null
+++ b/latest/reference/API/trestle/core/refs_validator/index.html
@@ -0,0 +1,89 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.refs_validator module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/refs_validator/ rel=canonical><link href=../profile_resolver/ rel=prev><link href=../repository/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.refs_validator - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.refs_validator - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.refs_validator module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/refs_validator.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/refs_validator/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.refs_validator - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.refs_validator module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/refs_validator.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.refs_validator class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.refs_validator </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.refs_validator </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.refs_validator class=md-nav__link> <span class=md-ellipsis> refs_validator </span> </a> <nav class=md-nav aria-label=refs_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.refs_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.refs_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.refs_validator.RefsValidator class=md-nav__link> <span class=md-ellipsis> RefsValidator </span> </a> <nav class=md-nav aria-label=RefsValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.refs_validator.RefsValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.refs_validator.RefsValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.refs_validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.refs_validator class=md-nav__link> <span class=md-ellipsis> refs_validator </span> </a> <nav class=md-nav aria-label=refs_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.refs_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.refs_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.refs_validator.RefsValidator class=md-nav__link> <span class=md-ellipsis> RefsValidator </span> </a> <nav class=md-nav aria-label=RefsValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.refs_validator.RefsValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.refs_validator.RefsValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.refs_validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.refs_validator</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.refs_validator class="doc doc-heading"> <code>trestle.core.refs_validator</code> <a href=#trestle.core.refs_validator class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Validate by confirming all refs have corresponding id.</p> <div class="doc doc-children"> <h3 id=trestle.core.refs_validator-attributes>Attributes<a href=#trestle.core.refs_validator-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.core.refs_validator-classes>Classes<a href=#trestle.core.refs_validator-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.refs_validator.RefsValidator class="doc doc-heading"> <code>RefsValidator</code> <a href=#trestle.core.refs_validator.RefsValidator class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.validator.Validator href=../validator/#trestle.core.validator.Validator>Validator</a></code></p> <p>Validator to confirm all references in responsible parties are found in roles.</p> <details class=quote> <summary>Source code in <code>trestle/core/refs_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RefsValidator</span><span class=p>(</span><span class=n>Validator</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validator to confirm all references in responsible parties are found in roles.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Test if the model is valid.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            model: A top level OSCAL model.</span>
+<span class=sd>            quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>        returns:</span>
+<span class=sd>            True (valid) if the model&#39;s responsible parties match those found in roles.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>roles</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>roles</span><span class=p>)</span>
+        <span class=n>role_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>role</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>role</span> <span class=ow>in</span> <span class=n>roles</span><span class=p>]</span>
+        <span class=n>responsible_parties</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>responsible_parties</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>responsible_parties</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=n>party_roles</span> <span class=o>=</span> <span class=p>[</span><span class=n>party</span><span class=o>.</span><span class=n>role_id</span> <span class=k>for</span> <span class=n>party</span> <span class=ow>in</span> <span class=n>responsible_parties</span><span class=p>]</span>
+        <span class=c1># return true if all party roles are in the roles list</span>
+        <span class=k>return</span> <span class=nb>all</span><span class=p>(</span><span class=n>item</span> <span class=ow>in</span> <span class=n>role_ids</span> <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>party_roles</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.refs_validator.RefsValidator-functions>Functions<a href=#trestle.core.refs_validator.RefsValidator-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.refs_validator.RefsValidator.model_is_valid class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.refs_validator.RefsValidator.model_is_valid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Test if the model is valid.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.common_types.TopLevelOscalModel href=../../common/common_types/#trestle.common.common_types.TopLevelOscalModel>TopLevelOscalModel</a></code> </td> <td> <div class=doc-md-description> <p>A top level OSCAL model.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>quiet</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Don't report msgs unless invalid.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>True (valid) if the model's responsible parties match those found in roles.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/refs_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Test if the model is valid.</span>
+
+<span class=sd>    args:</span>
+<span class=sd>        model: A top level OSCAL model.</span>
+<span class=sd>        quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>    returns:</span>
+<span class=sd>        True (valid) if the model&#39;s responsible parties match those found in roles.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>roles</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>roles</span><span class=p>)</span>
+    <span class=n>role_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>role</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>role</span> <span class=ow>in</span> <span class=n>roles</span><span class=p>]</span>
+    <span class=n>responsible_parties</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>responsible_parties</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>responsible_parties</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=n>party_roles</span> <span class=o>=</span> <span class=p>[</span><span class=n>party</span><span class=o>.</span><span class=n>role_id</span> <span class=k>for</span> <span class=n>party</span> <span class=ow>in</span> <span class=n>responsible_parties</span><span class=p>]</span>
+    <span class=c1># return true if all party roles are in the roles list</span>
+    <span class=k>return</span> <span class=nb>all</span><span class=p>(</span><span class=n>item</span> <span class=ow>in</span> <span class=n>role_ids</span> <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>party_roles</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.refs_validator-functions>Functions<a href=#trestle.core.refs_validator-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/remote/cache/index.html b/latest/reference/API/trestle/core/remote/cache/index.html
new file mode 100644
index 000000000..8949e5d70
--- /dev/null
+++ b/latest/reference/API/trestle/core/remote/cache/index.html
@@ -0,0 +1,1278 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.remote.cache module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/remote/cache/ rel=canonical><link href=../../models/plans/ rel=prev><link href=../../resolver/merge/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.remote.cache - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.remote.cache - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.remote.cache module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/remote/cache.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/remote/cache/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.remote.cache - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.remote.cache module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/remote/cache.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.remote.cache class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.remote.cache </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32 checked> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.remote.cache </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.remote.cache class=md-nav__link> <span class=md-ellipsis> cache </span> </a> <nav class=md-nav aria-label=cache> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase class=md-nav__link> <span class=md-ellipsis> FetcherBase </span> </a> <nav class=md-nav aria-label=FetcherBase> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase.get_oscal class=md-nav__link> <span class=md-ellipsis> get_oscal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase.get_oscal_with_model_type class=md-nav__link> <span class=md-ellipsis> get_oscal_with_model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase.get_raw class=md-nav__link> <span class=md-ellipsis> get_raw </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory class=md-nav__link> <span class=md-ellipsis> FetcherFactory </span> </a> <nav class=md-nav aria-label=FetcherFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.UriType class=md-nav__link> <span class=md-ellipsis> UriType </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.get_fetcher class=md-nav__link> <span class=md-ellipsis> get_fetcher </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.get_uri_type class=md-nav__link> <span class=md-ellipsis> get_uri_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.in_trestle_directory class=md-nav__link> <span class=md-ellipsis> in_trestle_directory </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.uri_type_is_not_local class=md-nav__link> <span class=md-ellipsis> uri_type_is_not_local </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.HTTPSFetcher class=md-nav__link> <span class=md-ellipsis> HTTPSFetcher </span> </a> <nav class=md-nav aria-label=HTTPSFetcher> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.HTTPSFetcher-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.HTTPSFetcher.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.LocalFetcher class=md-nav__link> <span class=md-ellipsis> LocalFetcher </span> </a> <nav class=md-nav aria-label=LocalFetcher> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.LocalFetcher-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.LocalFetcher.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.SFTPFetcher class=md-nav__link> <span class=md-ellipsis> SFTPFetcher </span> </a> <nav class=md-nav aria-label=SFTPFetcher> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.SFTPFetcher-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.SFTPFetcher.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.remote.cache class=md-nav__link> <span class=md-ellipsis> cache </span> </a> <nav class=md-nav aria-label=cache> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase class=md-nav__link> <span class=md-ellipsis> FetcherBase </span> </a> <nav class=md-nav aria-label=FetcherBase> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase.get_oscal class=md-nav__link> <span class=md-ellipsis> get_oscal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase.get_oscal_with_model_type class=md-nav__link> <span class=md-ellipsis> get_oscal_with_model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherBase.get_raw class=md-nav__link> <span class=md-ellipsis> get_raw </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory class=md-nav__link> <span class=md-ellipsis> FetcherFactory </span> </a> <nav class=md-nav aria-label=FetcherFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.UriType class=md-nav__link> <span class=md-ellipsis> UriType </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.get_fetcher class=md-nav__link> <span class=md-ellipsis> get_fetcher </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.get_uri_type class=md-nav__link> <span class=md-ellipsis> get_uri_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.in_trestle_directory class=md-nav__link> <span class=md-ellipsis> in_trestle_directory </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.FetcherFactory.uri_type_is_not_local class=md-nav__link> <span class=md-ellipsis> uri_type_is_not_local </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.HTTPSFetcher class=md-nav__link> <span class=md-ellipsis> HTTPSFetcher </span> </a> <nav class=md-nav aria-label=HTTPSFetcher> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.HTTPSFetcher-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.HTTPSFetcher.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.LocalFetcher class=md-nav__link> <span class=md-ellipsis> LocalFetcher </span> </a> <nav class=md-nav aria-label=LocalFetcher> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.LocalFetcher-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.LocalFetcher.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.remote.cache.SFTPFetcher class=md-nav__link> <span class=md-ellipsis> SFTPFetcher </span> </a> <nav class=md-nav aria-label=SFTPFetcher> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.SFTPFetcher-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.remote.cache.SFTPFetcher.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.remote.cache</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.remote.cache class="doc doc-heading"> <code>trestle.core.remote.cache</code> <a href=#trestle.core.remote.cache class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle cache operations library.</p> <p>Allows for using URI's to reference external directories and then expand.</p> <div class="doc doc-children"> <h3 id=trestle.core.remote.cache-attributes>Attributes<a href=#trestle.core.remote.cache-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.remote.cache.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.remote.cache.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.remote.cache-classes>Classes<a href=#trestle.core.remote.cache-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.remote.cache.FetcherBase class="doc doc-heading"> <code>FetcherBase</code> <a href=#trestle.core.remote.cache.FetcherBase class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=abc.ABC>ABC</span></code></p> <p>FetcherBase - base class for caching and fetching remote oscal objects.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>FetcherBase</span><span class=p>(</span><span class=n>ABC</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;FetcherBase - base class for caching and fetching remote oscal objects.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Intialize fetcher base.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.</span>
+<span class=sd>            uri: Reference to the source object to cache.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Initializing FetcherBase&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_uri</span> <span class=o>=</span> <span class=n>uri</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_root</span> <span class=o>=</span> <span class=n>trestle_root</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_cache_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_root</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_CACHE_DIR</span>
+        <span class=c1># ensure trestle cache directory exists.</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_cache_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_expiration_seconds</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>DAY_SECONDS</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_time_since_modification</span><span class=p>(</span><span class=n>file_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>datetime</span><span class=o>.</span><span class=n>timedelta</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get time since last modification.&quot;&quot;&quot;</span>
+        <span class=n>last_modification</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>fromtimestamp</span><span class=p>(</span><span class=n>file_path</span><span class=o>.</span><span class=n>stat</span><span class=p>()</span><span class=o>.</span><span class=n>st_mtime</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span> <span class=o>-</span> <span class=n>last_modification</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>_do_fetch</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Fetch the object from a remote source.&quot;&quot;&quot;</span>
+        <span class=k>pass</span>
+
+    <span class=k>def</span> <span class=nf>_in_cache</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return whether object is present in the cache or not.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_is_stale</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+        <span class=c1># Either cache empty or cached item is too old</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_in_cache</span><span class=p>():</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=n>FetcherBase</span><span class=o>.</span><span class=n>_time_since_modification</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span>
+                                                    <span class=p>)</span> <span class=o>&gt;</span> <span class=n>datetime</span><span class=o>.</span><span class=n>timedelta</span><span class=p>(</span><span class=n>seconds</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_expiration_seconds</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_update_cache</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>force_update</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Update the cache by fetching the target remote object, if stale or forced.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            force_update: force the fetch regardless of staleness.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            True if update occurred</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_stale</span><span class=p>()</span> <span class=ow>or</span> <span class=n>force_update</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_do_fetch</span><span class=p>()</span>
+                <span class=k>return</span> <span class=kc>True</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Cache update failure for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>.  Please confirm the file is json and not html: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=p>)</span> <span class=kn>from</span> <span class=nn>e</span>  <span class=c1># noqa E501</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=k>def</span> <span class=nf>get_raw</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>force_update</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Retrieve the raw dictionary representing the underlying object.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_update_cache</span><span class=p>(</span><span class=n>force_update</span><span class=p>)</span>
+        <span class=c1># Return results in the cache, whether yaml or json, or whatever is supported by fs.load_file().</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>raw_data</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>load_file</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>raw_data</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>load_file</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span><span class=p>)</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache get failure for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span> <span class=kn>from</span> <span class=nn>e</span>
+        <span class=k>return</span> <span class=n>raw_data</span>
+
+    <span class=k>def</span> <span class=nf>get_oscal_with_model_type</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                                  <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span>
+                                  <span class=n>force_update</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Retrieve the cached file as a particular OSCAL model.</span>
+
+<span class=sd>        Arguments:</span>
+<span class=sd>            model_type: Type[OscalBaseModel] Specifies the OSCAL model type of the fetched object.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_update_cache</span><span class=p>(</span><span class=n>force_update</span><span class=p>)</span>
+        <span class=n>cache_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>cache_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get_oscal failure for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>cache_file</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get_oscal failed, error loading cache file for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1> as </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get_oscal failure for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span> <span class=kn>from</span> <span class=nn>e</span>
+
+    <span class=k>def</span> <span class=nf>get_oscal</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>force_update</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Retrieve the cached file and model name without knowing its model type.&quot;&quot;&quot;</span>
+        <span class=n>model_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_raw</span><span class=p>(</span><span class=n>force_update</span><span class=p>)</span>
+        <span class=n>root_key</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>root_key</span><span class=p>(</span><span class=n>model_dict</span><span class=p>)</span>
+        <span class=n>model_name</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>root_key</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>model_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Failed cache read of non top level model with root_key </span><span class=si>{</span><span class=n>root_key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>parser</span><span class=o>.</span><span class=n>parse_dict</span><span class=p>(</span><span class=n>model_dict</span><span class=p>[</span><span class=n>root_key</span><span class=p>],</span> <span class=n>model_name</span><span class=p>),</span> <span class=n>root_key</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.remote.cache.FetcherBase-functions>Functions<a href=#trestle.core.remote.cache.FetcherBase-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.FetcherBase.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span></code> <a href=#trestle.core.remote.cache.FetcherBase.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Intialize fetcher base.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path of the trestle workspace, i.e., within which .trestle is to be found.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>uri</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Reference to the source object to cache.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Intialize fetcher base.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.</span>
+<span class=sd>        uri: Reference to the source object to cache.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Initializing FetcherBase&#39;</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_uri</span> <span class=o>=</span> <span class=n>uri</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_root</span> <span class=o>=</span> <span class=n>trestle_root</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_cache_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_root</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_CACHE_DIR</span>
+    <span class=c1># ensure trestle cache directory exists.</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_cache_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_expiration_seconds</span> <span class=o>=</span> <span class=n>const</span><span class=o>.</span><span class=n>DAY_SECONDS</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.FetcherBase.get_oscal class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_oscal</span><span class=p>(</span><span class=n>force_update</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.remote.cache.FetcherBase.get_oscal class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Retrieve the cached file and model name without knowing its model type.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_oscal</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>force_update</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Retrieve the cached file and model name without knowing its model type.&quot;&quot;&quot;</span>
+    <span class=n>model_dict</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_raw</span><span class=p>(</span><span class=n>force_update</span><span class=p>)</span>
+    <span class=n>root_key</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>root_key</span><span class=p>(</span><span class=n>model_dict</span><span class=p>)</span>
+    <span class=n>model_name</span> <span class=o>=</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>root_key</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>model_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Failed cache read of non top level model with root_key </span><span class=si>{</span><span class=n>root_key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>parser</span><span class=o>.</span><span class=n>parse_dict</span><span class=p>(</span><span class=n>model_dict</span><span class=p>[</span><span class=n>root_key</span><span class=p>],</span> <span class=n>model_name</span><span class=p>),</span> <span class=n>root_key</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.FetcherBase.get_oscal_with_model_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_oscal_with_model_type</span><span class=p>(</span><span class=n>model_type</span><span class=p>,</span> <span class=n>force_update</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.remote.cache.FetcherBase.get_oscal_with_model_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Retrieve the cached file as a particular OSCAL model.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model_type</code> </td> <td> <code><span title=typing.Type>Type</span>[<a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a>]</code> </td> <td> <div class=doc-md-description> <p>Type[OscalBaseModel] Specifies the OSCAL model type of the fetched object.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_oscal_with_model_type</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span>
+                              <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span>
+                              <span class=n>force_update</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Retrieve the cached file as a particular OSCAL model.</span>
+
+<span class=sd>    Arguments:</span>
+<span class=sd>        model_type: Type[OscalBaseModel] Specifies the OSCAL model type of the fetched object.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_update_cache</span><span class=p>(</span><span class=n>force_update</span><span class=p>)</span>
+    <span class=n>cache_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>cache_file</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get_oscal failure for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>model_type</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>cache_file</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get_oscal failed, error loading cache file for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1> as </span><span class=si>{</span><span class=n>model_type</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;get_oscal failure for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span> <span class=kn>from</span> <span class=nn>e</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.FetcherBase.get_raw class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_raw</span><span class=p>(</span><span class=n>force_update</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.remote.cache.FetcherBase.get_raw class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Retrieve the raw dictionary representing the underlying object.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_raw</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>force_update</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Retrieve the raw dictionary representing the underlying object.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_update_cache</span><span class=p>(</span><span class=n>force_update</span><span class=p>)</span>
+    <span class=c1># Return results in the cache, whether yaml or json, or whatever is supported by fs.load_file().</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>raw_data</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>load_file</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>raw_data</span> <span class=o>=</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>load_file</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache get failure for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span> <span class=kn>from</span> <span class=nn>e</span>
+    <span class=k>return</span> <span class=n>raw_data</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.remote.cache.FetcherFactory class="doc doc-heading"> <code>FetcherFactory</code> <a href=#trestle.core.remote.cache.FetcherFactory class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Factory method for creating a fetcher.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>FetcherFactory</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Factory method for creating a fetcher.&quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>UriType</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Specify types of URI.&quot;&quot;&quot;</span>
+
+        <span class=n>LOCAL_FILE</span> <span class=o>=</span> <span class=mi>1</span>
+
+        <span class=n>SFTP</span> <span class=o>=</span> <span class=mi>2</span>
+
+        <span class=n>HTTPS</span> <span class=o>=</span> <span class=mi>3</span>
+
+        <span class=n>TRESTLE</span> <span class=o>=</span> <span class=mi>4</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>uri_type_is_not_local</span><span class=p>(</span><span class=n>uri_type</span><span class=p>:</span> <span class=n>UriType</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Determine if the uri type is not local.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>uri_type</span> <span class=ow>in</span> <span class=p>[</span><span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>SFTP</span><span class=p>,</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>HTTPS</span><span class=p>]</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_uri_type</span><span class=p>(</span><span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>UriType</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Determine the type of uri.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SFTP_URI</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>SFTP</span>
+        <span class=k>if</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>HTTPS_URI</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>HTTPS</span>
+        <span class=k>if</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>TRESTLE</span>
+        <span class=c1># if we land here, assume it is a local file and may have relative path</span>
+        <span class=c1># but it at least needs a filename with suffix</span>
+        <span class=c1># the most minimal allowed uri is of the form a.yml</span>
+        <span class=n>uri_clean</span> <span class=o>=</span> <span class=n>uri</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>uri_clean</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;ftp:&#39;</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid uri </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>  ftp is not supported.  Use sftp instead.&#39;</span><span class=p>)</span>
+        <span class=n>uri_len</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>uri_clean</span><span class=p>)</span>
+        <span class=c1># at least 5 chars and ending with dot followed by at least 3 chars</span>
+        <span class=k>if</span> <span class=n>uri_len</span> <span class=o>&gt;</span> <span class=mi>4</span> <span class=ow>and</span> <span class=mi>0</span> <span class=o>&lt;</span> <span class=n>uri_clean</span><span class=o>.</span><span class=n>rfind</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span> <span class=o>&lt;</span> <span class=n>uri_len</span> <span class=o>-</span> <span class=mi>3</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>LOCAL_FILE</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid uri not recognized as a readable file path with extension: </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>in_trestle_directory</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if in trestle directory when uri may not be a file path.&quot;&quot;&quot;</span>
+        <span class=n>uri_type</span> <span class=o>=</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_uri_type</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>uri_type</span> <span class=o>==</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>TRESTLE</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>if</span> <span class=n>uri_type</span> <span class=o>!=</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>LOCAL_FILE</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>trestle_root</span><span class=o>.</span><span class=n>resolve</span><span class=p>()))</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>get_fetcher</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Union</span><span class=p>[</span><span class=n>LocalFetcher</span><span class=p>,</span> <span class=n>SFTPFetcher</span><span class=p>,</span> <span class=n>HTTPSFetcher</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return an instantiated fetcher object based on the type of URI.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.</span>
+<span class=sd>            uri: Reference to the remote object to cache.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            fetcher object for the given URI.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>fetcher_dict</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>LOCAL_FILE</span><span class=p>:</span> <span class=n>LocalFetcher</span><span class=p>,</span>
+            <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>SFTP</span><span class=p>:</span> <span class=n>SFTPFetcher</span><span class=p>,</span>
+            <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>HTTPS</span><span class=p>:</span> <span class=n>HTTPSFetcher</span><span class=p>,</span>
+            <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>TRESTLE</span><span class=p>:</span> <span class=n>LocalFetcher</span><span class=p>,</span>
+        <span class=p>}</span>
+        <span class=n>uri_type</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>get_uri_type</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>fetcher_dict</span><span class=p>[</span><span class=n>uri_type</span><span class=p>](</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.remote.cache.FetcherFactory-classes>Classes<a href=#trestle.core.remote.cache.FetcherFactory-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.core.remote.cache.FetcherFactory.UriType class="doc doc-heading"> <code>UriType</code> <a href=#trestle.core.remote.cache.FetcherFactory.UriType class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Specify types of URI.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>UriType</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Specify types of URI.&quot;&quot;&quot;</span>
+
+    <span class=n>LOCAL_FILE</span> <span class=o>=</span> <span class=mi>1</span>
+
+    <span class=n>SFTP</span> <span class=o>=</span> <span class=mi>2</span>
+
+    <span class=n>HTTPS</span> <span class=o>=</span> <span class=mi>3</span>
+
+    <span class=n>TRESTLE</span> <span class=o>=</span> <span class=mi>4</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.core.remote.cache.FetcherFactory.UriType-attributes>Attributes<a href=#trestle.core.remote.cache.FetcherFactory.UriType-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.remote.cache.FetcherFactory.UriType.HTTPS class="doc doc-heading"> <code class="highlight language-python"><span class=n>HTTPS</span> <span class=o>=</span> <span class=mi>3</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.remote.cache.FetcherFactory.UriType.HTTPS class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.remote.cache.FetcherFactory.UriType.LOCAL_FILE class="doc doc-heading"> <code class="highlight language-python"><span class=n>LOCAL_FILE</span> <span class=o>=</span> <span class=mi>1</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.remote.cache.FetcherFactory.UriType.LOCAL_FILE class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.remote.cache.FetcherFactory.UriType.SFTP class="doc doc-heading"> <code class="highlight language-python"><span class=n>SFTP</span> <span class=o>=</span> <span class=mi>2</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.remote.cache.FetcherFactory.UriType.SFTP class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h8 id=trestle.core.remote.cache.FetcherFactory.UriType.TRESTLE class="doc doc-heading"> <code class="highlight language-python"><span class=n>TRESTLE</span> <span class=o>=</span> <span class=mi>4</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.remote.cache.FetcherFactory.UriType.TRESTLE class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <h5 id=trestle.core.remote.cache.FetcherFactory-functions>Functions<a href=#trestle.core.remote.cache.FetcherFactory-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.FetcherFactory.get_fetcher class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_fetcher</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.remote.cache.FetcherFactory.get_fetcher class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return an instantiated fetcher object based on the type of URI.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path of the trestle workspace, i.e., within which .trestle is to be found.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>uri</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Reference to the remote object to cache.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><span title=typing.Union>Union</span>[<a class="autorefs autorefs-internal" title=trestle.core.remote.cache.LocalFetcher href=#trestle.core.remote.cache.LocalFetcher>LocalFetcher</a>, <a class="autorefs autorefs-internal" title=trestle.core.remote.cache.SFTPFetcher href=#trestle.core.remote.cache.SFTPFetcher>SFTPFetcher</a>, <a class="autorefs autorefs-internal" title=trestle.core.remote.cache.HTTPSFetcher href=#trestle.core.remote.cache.HTTPSFetcher>HTTPSFetcher</a>]</code> </td> <td> <div class=doc-md-description> <p>fetcher object for the given URI.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>get_fetcher</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Union</span><span class=p>[</span><span class=n>LocalFetcher</span><span class=p>,</span> <span class=n>SFTPFetcher</span><span class=p>,</span> <span class=n>HTTPSFetcher</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return an instantiated fetcher object based on the type of URI.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.</span>
+<span class=sd>        uri: Reference to the remote object to cache.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        fetcher object for the given URI.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>fetcher_dict</span> <span class=o>=</span> <span class=p>{</span>
+        <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>LOCAL_FILE</span><span class=p>:</span> <span class=n>LocalFetcher</span><span class=p>,</span>
+        <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>SFTP</span><span class=p>:</span> <span class=n>SFTPFetcher</span><span class=p>,</span>
+        <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>HTTPS</span><span class=p>:</span> <span class=n>HTTPSFetcher</span><span class=p>,</span>
+        <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>TRESTLE</span><span class=p>:</span> <span class=n>LocalFetcher</span><span class=p>,</span>
+    <span class=p>}</span>
+    <span class=n>uri_type</span> <span class=o>=</span> <span class=bp>cls</span><span class=o>.</span><span class=n>get_uri_type</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>fetcher_dict</span><span class=p>[</span><span class=n>uri_type</span><span class=p>](</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.FetcherFactory.get_uri_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_uri_type</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.remote.cache.FetcherFactory.get_uri_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Determine the type of uri.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_uri_type</span><span class=p>(</span><span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>UriType</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Determine the type of uri.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>SFTP_URI</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>SFTP</span>
+    <span class=k>if</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>HTTPS_URI</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>HTTPS</span>
+    <span class=k>if</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span><span class=p>):</span>
+        <span class=k>return</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>TRESTLE</span>
+    <span class=c1># if we land here, assume it is a local file and may have relative path</span>
+    <span class=c1># but it at least needs a filename with suffix</span>
+    <span class=c1># the most minimal allowed uri is of the form a.yml</span>
+    <span class=n>uri_clean</span> <span class=o>=</span> <span class=n>uri</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>uri_clean</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;ftp:&#39;</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid uri </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>  ftp is not supported.  Use sftp instead.&#39;</span><span class=p>)</span>
+    <span class=n>uri_len</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>uri_clean</span><span class=p>)</span>
+    <span class=c1># at least 5 chars and ending with dot followed by at least 3 chars</span>
+    <span class=k>if</span> <span class=n>uri_len</span> <span class=o>&gt;</span> <span class=mi>4</span> <span class=ow>and</span> <span class=mi>0</span> <span class=o>&lt;</span> <span class=n>uri_clean</span><span class=o>.</span><span class=n>rfind</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span> <span class=o>&lt;</span> <span class=n>uri_len</span> <span class=o>-</span> <span class=mi>3</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>LOCAL_FILE</span>
+    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Invalid uri not recognized as a readable file path with extension: </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.FetcherFactory.in_trestle_directory class="doc doc-heading"> <code class="highlight language-python"><span class=n>in_trestle_directory</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.remote.cache.FetcherFactory.in_trestle_directory class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Check if in trestle directory when uri may not be a file path.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>in_trestle_directory</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check if in trestle directory when uri may not be a file path.&quot;&quot;&quot;</span>
+    <span class=n>uri_type</span> <span class=o>=</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_uri_type</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>uri_type</span> <span class=o>==</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>TRESTLE</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>if</span> <span class=n>uri_type</span> <span class=o>!=</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>LOCAL_FILE</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span><span class=o>.</span><span class=n>relative_to</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>trestle_root</span><span class=o>.</span><span class=n>resolve</span><span class=p>()))</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.FetcherFactory.uri_type_is_not_local class="doc doc-heading"> <code class="highlight language-python"><span class=n>uri_type_is_not_local</span><span class=p>(</span><span class=n>uri_type</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.core.remote.cache.FetcherFactory.uri_type_is_not_local class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Determine if the uri type is not local.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>uri_type_is_not_local</span><span class=p>(</span><span class=n>uri_type</span><span class=p>:</span> <span class=n>UriType</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Determine if the uri type is not local.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>uri_type</span> <span class=ow>in</span> <span class=p>[</span><span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>SFTP</span><span class=p>,</span> <span class=n>FetcherFactory</span><span class=o>.</span><span class=n>UriType</span><span class=o>.</span><span class=n>HTTPS</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.remote.cache.HTTPSFetcher class="doc doc-heading"> <code>HTTPSFetcher</code> <a href=#trestle.core.remote.cache.HTTPSFetcher class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.remote.cache.FetcherBase href=#trestle.core.remote.cache.FetcherBase>FetcherBase</a></code></p> <p>Fetcher for https content.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>HTTPSFetcher</span><span class=p>(</span><span class=n>FetcherBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Fetcher for https content.&quot;&quot;&quot;</span>
+
+    <span class=c1># Use request: https://requests.readthedocs.io/en/master/</span>
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize HTTPS fetcher.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Initializing HTTPSFetcher&#39;</span><span class=p>)</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_username</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>u</span> <span class=o>=</span> <span class=n>parse</span><span class=o>.</span><span class=n>urlparse</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_url</span> <span class=o>=</span> <span class=n>uri</span>
+        <span class=c1># If the either the username or password is omitted in the URI, then the other becomes &#39;&#39;</span>
+        <span class=c1># so we test for either None or &#39;&#39;.</span>
+        <span class=k>if</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=c1># This also checks for invalid environment variable name (IEEE 1003.1)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=s1>&#39;{{[a-zA-Z_][a-zA-Z0-9_]*}}&#39;</span><span class=p>,</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span><span class=p>)</span> <span class=ow>or</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span> <span class=o>==</span> <span class=s1>&#39;{{_}}&#39;</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=s1>&#39;Cache request for invalid input URI: &#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;username must refer to an environment variable using moustache </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=p>)</span>
+            <span class=n>username_var</span> <span class=o>=</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span><span class=p>[</span><span class=mi>2</span><span class=p>:</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>username_var</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: username not found in the environment </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_username</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>[</span><span class=n>username_var</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>  <span class=c1># noqa S105</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=s1>&#39;{{[a-zA-Z_][a-zA-Z0-9_]*}}&#39;</span><span class=p>,</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span><span class=p>)</span> <span class=ow>or</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span> <span class=o>==</span> <span class=s1>&#39;{{_}}&#39;</span><span class=p>:</span>  <span class=c1># noqa S105</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=s1>&#39;Cache request for invalid input URI: &#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;password must refer to an environment variable using moustache </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=p>)</span>
+            <span class=n>password_var</span> <span class=o>=</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span><span class=p>[</span><span class=mi>2</span><span class=p>:</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>password_var</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                    <span class=s1>&#39;Cache request for invalid input URI: &#39;</span>
+                    <span class=sa>f</span><span class=s1>&#39;password not found in the environment </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>[</span><span class=n>password_var</span><span class=p>]</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_username</span> <span class=ow>and</span> <span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span> <span class=ow>or</span> <span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>):</span>  <span class=c1># noqa S105</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: username found &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;but password not found via environment variable </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_username</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: password found &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;but username not found via environment variable </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+        <span class=k>if</span> <span class=n>u</span><span class=o>.</span><span class=n>hostname</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache request for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1> requires hostname&#39;</span><span class=p>)</span>
+        <span class=n>https_cached_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_cache_path</span> <span class=o>/</span> <span class=n>u</span><span class=o>.</span><span class=n>hostname</span>
+        <span class=c1># Skip any number of back- or forward slashes preceding the URI path (u.path)</span>
+        <span class=n>path_parent</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>[</span><span class=n>re</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=s1>&#39;[^/</span><span class=se>\\\\</span><span class=s1>]&#39;</span><span class=p>,</span> <span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>span</span><span class=p>()[</span><span class=mi>0</span><span class=p>]:])</span><span class=o>.</span><span class=n>parent</span>
+        <span class=n>https_cached_dir</span> <span class=o>=</span> <span class=n>https_cached_dir</span> <span class=o>/</span> <span class=n>path_parent</span>
+        <span class=n>https_cached_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span> <span class=o>=</span> <span class=n>https_cached_dir</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_do_fetch</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>auth</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>verify</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=c1># This order reflects requests library behavior: REQUESTS_CA_BUNDLE comes first.</span>
+        <span class=k>for</span> <span class=n>env_var_name</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;REQUESTS_CA_BUNDLE&#39;</span><span class=p>,</span> <span class=s1>&#39;CURL_CA_BUNDLE&#39;</span><span class=p>]:</span>
+            <span class=k>if</span> <span class=n>env_var_name</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>[</span><span class=n>env_var_name</span><span class=p>])</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                    <span class=n>verify</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>[</span><span class=n>env_var_name</span><span class=p>]</span>
+                    <span class=k>break</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>err_str</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Env var $</span><span class=si>{</span><span class=n>env_var_name</span><span class=si>}</span><span class=s1> found but path does not exist: </span><span class=si>{</span><span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>[</span><span class=n>env_var_name</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=n>err_str</span><span class=p>)</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache update failure with bad inputenv var: </span><span class=si>{</span><span class=n>err_str</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_username</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>auth</span> <span class=o>=</span> <span class=n>HTTPBasicAuth</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_username</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_password</span><span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>response</span> <span class=o>=</span> <span class=n>requests</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_url</span><span class=p>,</span> <span class=n>auth</span><span class=o>=</span><span class=n>auth</span><span class=p>,</span> <span class=n>verify</span><span class=o>=</span><span class=n>verify</span><span class=p>,</span> <span class=n>timeout</span><span class=o>=</span><span class=mi>30</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache update failure to connect via HTTPS: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_url</span><span class=si>}</span><span class=s1> (</span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>)&#39;</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>response</span><span class=o>.</span><span class=n>status_code</span> <span class=o>==</span> <span class=mi>200</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>result</span> <span class=o>=</span> <span class=n>response</span><span class=o>.</span><span class=n>text</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>err</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache update failure reading response via HTTPS: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_url</span><span class=si>}</span><span class=s1> (</span><span class=si>{</span><span class=n>err</span><span class=si>}</span><span class=s1>)&#39;</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span><span class=o>.</span><span class=n>write_text</span><span class=p>(</span><span class=n>result</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;GET returned code </span><span class=si>{</span><span class=n>response</span><span class=o>.</span><span class=n>status_code</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.remote.cache.HTTPSFetcher-functions>Functions<a href=#trestle.core.remote.cache.HTTPSFetcher-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.HTTPSFetcher.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span></code> <a href=#trestle.core.remote.cache.HTTPSFetcher.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize HTTPS fetcher.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize HTTPS fetcher.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Initializing HTTPSFetcher&#39;</span><span class=p>)</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_username</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>u</span> <span class=o>=</span> <span class=n>parse</span><span class=o>.</span><span class=n>urlparse</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_url</span> <span class=o>=</span> <span class=n>uri</span>
+    <span class=c1># If the either the username or password is omitted in the URI, then the other becomes &#39;&#39;</span>
+    <span class=c1># so we test for either None or &#39;&#39;.</span>
+    <span class=k>if</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=c1># This also checks for invalid environment variable name (IEEE 1003.1)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=s1>&#39;{{[a-zA-Z_][a-zA-Z0-9_]*}}&#39;</span><span class=p>,</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span><span class=p>)</span> <span class=ow>or</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span> <span class=o>==</span> <span class=s1>&#39;{{_}}&#39;</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=s1>&#39;Cache request for invalid input URI: &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;username must refer to an environment variable using moustache </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+        <span class=n>username_var</span> <span class=o>=</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span><span class=p>[</span><span class=mi>2</span><span class=p>:</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>username_var</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: username not found in the environment </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_username</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>[</span><span class=n>username_var</span><span class=p>]</span>
+    <span class=k>if</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span> <span class=o>!=</span> <span class=s1>&#39;&#39;</span> <span class=ow>and</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>  <span class=c1># noqa S105</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=s1>&#39;{{[a-zA-Z_][a-zA-Z0-9_]*}}&#39;</span><span class=p>,</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span><span class=p>)</span> <span class=ow>or</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span> <span class=o>==</span> <span class=s1>&#39;{{_}}&#39;</span><span class=p>:</span>  <span class=c1># noqa S105</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=s1>&#39;Cache request for invalid input URI: &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;password must refer to an environment variable using moustache </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+        <span class=n>password_var</span> <span class=o>=</span> <span class=n>u</span><span class=o>.</span><span class=n>password</span><span class=p>[</span><span class=mi>2</span><span class=p>:</span><span class=o>-</span><span class=mi>2</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>password_var</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+                <span class=s1>&#39;Cache request for invalid input URI: &#39;</span>
+                <span class=sa>f</span><span class=s1>&#39;password not found in the environment </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>[</span><span class=n>password_var</span><span class=p>]</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_username</span> <span class=ow>and</span> <span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=o>==</span> <span class=s1>&#39;&#39;</span> <span class=ow>or</span> <span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>):</span>  <span class=c1># noqa S105</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: username found &#39;</span>
+            <span class=sa>f</span><span class=s1>&#39;but password not found via environment variable </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_password</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_username</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: password found &#39;</span>
+            <span class=sa>f</span><span class=s1>&#39;but username not found via environment variable </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=p>)</span>
+    <span class=k>if</span> <span class=n>u</span><span class=o>.</span><span class=n>hostname</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache request for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1> requires hostname&#39;</span><span class=p>)</span>
+    <span class=n>https_cached_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_cache_path</span> <span class=o>/</span> <span class=n>u</span><span class=o>.</span><span class=n>hostname</span>
+    <span class=c1># Skip any number of back- or forward slashes preceding the URI path (u.path)</span>
+    <span class=n>path_parent</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>[</span><span class=n>re</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=s1>&#39;[^/</span><span class=se>\\\\</span><span class=s1>]&#39;</span><span class=p>,</span> <span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>span</span><span class=p>()[</span><span class=mi>0</span><span class=p>]:])</span><span class=o>.</span><span class=n>parent</span>
+    <span class=n>https_cached_dir</span> <span class=o>=</span> <span class=n>https_cached_dir</span> <span class=o>/</span> <span class=n>path_parent</span>
+    <span class=n>https_cached_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span> <span class=o>=</span> <span class=n>https_cached_dir</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.remote.cache.LocalFetcher class="doc doc-heading"> <code>LocalFetcher</code> <a href=#trestle.core.remote.cache.LocalFetcher class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.remote.cache.FetcherBase href=#trestle.core.remote.cache.FetcherBase>FetcherBase</a></code></p> <p>Fetcher for local content.</p> <p>Used for both file:/// and C:\ or C:/ type paths, but the path must be absolute. Also used for trestle:// files present in the current trestle root.</p> <p>If file:/// is used on a Windows system, it must be followed by C:/ or other drive letter to be sure it is an absolute path, e.g. file:///C:/Users/Default/Documents/profile.json. The drive letter may be lowercase. LocalFetcher does not do any caching and assumes the file is quickly accessible.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LocalFetcher</span><span class=p>(</span><span class=n>FetcherBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sa>r</span><span class=sd>&quot;&quot;&quot;Fetcher for local content.</span>
+
+<span class=sd>    Used for both file:/// and C:\\ or C:/ type paths, but the path must be absolute.</span>
+<span class=sd>    Also used for trestle:// files present in the current trestle root.</span>
+
+<span class=sd>    If file:/// is used on a Windows system, it must be followed by C:/ or other drive letter</span>
+<span class=sd>    to be sure it is an absolute path, e.g. file:///C:/Users/Default/Documents/profile.json.</span>
+<span class=sd>    The drive letter may be lowercase.</span>
+<span class=sd>    LocalFetcher does not do any caching and assumes the file is quickly accessible.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize local fetcher.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: trestle root path</span>
+<span class=sd>            uri: Reference to the file in the local filesystem to cache, which must be outside trestle_root.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>
+
+        <span class=c1># Handle as file:/// form</span>
+        <span class=k>if</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_URI</span><span class=p>):</span>
+            <span class=c1># strip off entire header including /</span>
+            <span class=n>uri</span> <span class=o>=</span> <span class=n>uri</span><span class=p>[</span><span class=nb>len</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_URI</span><span class=p>):]</span>
+
+            <span class=c1># if it has a drive letter don&#39;t add / to front</span>
+            <span class=n>uri</span> <span class=o>=</span> <span class=n>uri</span> <span class=k>if</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>WINDOWS_DRIVE_LETTER_REGEX</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span> <span class=k>else</span> <span class=s1>&#39;/&#39;</span> <span class=o>+</span> <span class=n>uri</span>
+        <span class=k>elif</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span><span class=p>):</span>
+            <span class=n>uri</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>trestle_root</span> <span class=o>/</span> <span class=n>uri</span><span class=p>[</span><span class=nb>len</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span><span class=p>):])</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_abs_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_abs_path</span>
+            <span class=k>return</span>
+
+        <span class=c1># now the URI should be either unix / style or windows C:/ style.  It may be relative.</span>
+
+        <span class=k>if</span> <span class=s1>&#39;:&#39;</span> <span class=ow>in</span> <span class=n>uri</span> <span class=ow>and</span> <span class=n>platform</span><span class=o>.</span><span class=n>system</span><span class=p>()</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>WINDOWS_PLATFORM_STR</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cannot have : in uri on non-Windows system unless ftps, https or trestle: </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># if it has a drive letter but no / after it, it is not absolute</span>
+        <span class=k>if</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>WINDOWS_DRIVE_LETTER_REGEX</span><span class=p>,</span> <span class=n>uri</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>platform</span><span class=o>.</span><span class=n>system</span><span class=p>()</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>WINDOWS_PLATFORM_STR</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cannot cache Windows paths on non-Windows system. </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># store the abs path to the file for fetching</span>
+        <span class=c1># if this is a windows file it will have a drive letter at start after resolve</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_abs_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;The uri provided is invalid or unresolvable as a file path: </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># set the cached path to be the actual file path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_abs_path</span>
+
+    <span class=k>def</span> <span class=nf>_is_stale</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+        <span class=c1># Local file is always stale.</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>_do_fetch</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;No need to fetch since using actual file path.&quot;&quot;&quot;</span>
+        <span class=k>pass</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.remote.cache.LocalFetcher-functions>Functions<a href=#trestle.core.remote.cache.LocalFetcher-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.LocalFetcher.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span></code> <a href=#trestle.core.remote.cache.LocalFetcher.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize local fetcher.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>trestle root path</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>uri</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Reference to the file in the local filesystem to cache, which must be outside trestle_root.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize local fetcher.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: trestle root path</span>
+<span class=sd>        uri: Reference to the file in the local filesystem to cache, which must be outside trestle_root.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>
+
+    <span class=c1># Handle as file:/// form</span>
+    <span class=k>if</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_URI</span><span class=p>):</span>
+        <span class=c1># strip off entire header including /</span>
+        <span class=n>uri</span> <span class=o>=</span> <span class=n>uri</span><span class=p>[</span><span class=nb>len</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_URI</span><span class=p>):]</span>
+
+        <span class=c1># if it has a drive letter don&#39;t add / to front</span>
+        <span class=n>uri</span> <span class=o>=</span> <span class=n>uri</span> <span class=k>if</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>WINDOWS_DRIVE_LETTER_REGEX</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span> <span class=k>else</span> <span class=s1>&#39;/&#39;</span> <span class=o>+</span> <span class=n>uri</span>
+    <span class=k>elif</span> <span class=n>uri</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span><span class=p>):</span>
+        <span class=n>uri</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>trestle_root</span> <span class=o>/</span> <span class=n>uri</span><span class=p>[</span><span class=nb>len</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_HREF_HEADING</span><span class=p>):])</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_abs_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_abs_path</span>
+        <span class=k>return</span>
+
+    <span class=c1># now the URI should be either unix / style or windows C:/ style.  It may be relative.</span>
+
+    <span class=k>if</span> <span class=s1>&#39;:&#39;</span> <span class=ow>in</span> <span class=n>uri</span> <span class=ow>and</span> <span class=n>platform</span><span class=o>.</span><span class=n>system</span><span class=p>()</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>WINDOWS_PLATFORM_STR</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cannot have : in uri on non-Windows system unless ftps, https or trestle: </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=c1># if it has a drive letter but no / after it, it is not absolute</span>
+    <span class=k>if</span> <span class=n>re</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>const</span><span class=o>.</span><span class=n>WINDOWS_DRIVE_LETTER_REGEX</span><span class=p>,</span> <span class=n>uri</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>platform</span><span class=o>.</span><span class=n>system</span><span class=p>()</span> <span class=o>!=</span> <span class=n>const</span><span class=o>.</span><span class=n>WINDOWS_PLATFORM_STR</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cannot cache Windows paths on non-Windows system. </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=c1># store the abs path to the file for fetching</span>
+    <span class=c1># if this is a windows file it will have a drive letter at start after resolve</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_abs_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>uri</span><span class=p>)</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;The uri provided is invalid or unresolvable as a file path: </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=c1># set the cached path to be the actual file path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_abs_path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.remote.cache.SFTPFetcher class="doc doc-heading"> <code>SFTPFetcher</code> <a href=#trestle.core.remote.cache.SFTPFetcher class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.remote.cache.FetcherBase href=#trestle.core.remote.cache.FetcherBase>FetcherBase</a></code></p> <p>Fetcher for SFTP content.</p> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SFTPFetcher</span><span class=p>(</span><span class=n>FetcherBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Fetcher for SFTP content.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize SFTP fetcher. Update the expected cache path as per caching specs.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.</span>
+<span class=sd>            uri: Reference to the remote file to cache that can be fetched using the sftp:// scheme.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;initialize SFTPFetcher for uri </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>
+        <span class=c1># Is this a valid URI, however? Username and password are optional, of course.</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>u</span> <span class=o>=</span> <span class=n>parse</span><span class=o>.</span><span class=n>urlparse</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;SFTP fetcher unable to parse uri </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1> error </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to parse malformed url </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1> error </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;SFTP fetcher with parsed uri </span><span class=si>{</span><span class=n>u</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>u</span><span class=o>.</span><span class=n>hostname</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;SFTP fetcher uri missing hostname&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Malformed URI, cannot parse hostname in URL </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: missing hostname </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;SFTP fetcher uri missing path&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Malformed URI, cannot parse path in URL </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: missing file path </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>sftp_cached_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_cache_path</span> <span class=o>/</span> <span class=n>u</span><span class=o>.</span><span class=n>hostname</span>
+        <span class=c1># Skip any number of back- or forward slashes preceding the URL path (u.path)</span>
+        <span class=n>path_parent</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>[</span><span class=n>re</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=s1>&#39;[^/</span><span class=se>\\\\</span><span class=s1>]&#39;</span><span class=p>,</span> <span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>span</span><span class=p>()[</span><span class=mi>0</span><span class=p>]:])</span><span class=o>.</span><span class=n>parent</span>
+        <span class=n>sftp_cached_dir</span> <span class=o>=</span> <span class=n>sftp_cached_dir</span> <span class=o>/</span> <span class=n>path_parent</span>
+        <span class=n>sftp_cached_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span> <span class=o>=</span> <span class=n>sftp_cached_dir</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_do_fetch</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Fetch remote object and update the cache if appropriate and possible to do so.</span>
+
+<span class=sd>        Authentication relies on the user&#39;s private key being either active via ssh-agent or</span>
+<span class=sd>        supplied via environment variable SSH_KEY. In the latter case, it must not require a passphrase prompt.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>u</span> <span class=o>=</span> <span class=n>parse</span><span class=o>.</span><span class=n>urlparse</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=p>)</span>
+        <span class=n>client</span> <span class=o>=</span> <span class=n>paramiko</span><span class=o>.</span><span class=n>SSHClient</span><span class=p>()</span>
+        <span class=c1># Must pick up host keys from the default known_hosts on this environment:</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>client</span><span class=o>.</span><span class=n>load_system_host_keys</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache update failure for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=c1># Use the supplied private key file if given, or look for keys in default path.</span>
+        <span class=k>if</span> <span class=s1>&#39;SSH_KEY&#39;</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>:</span>
+            <span class=n>pkey</span> <span class=o>=</span> <span class=n>paramiko</span><span class=o>.</span><span class=n>RSAKey</span><span class=o>.</span><span class=n>from_private_key</span><span class=p>(</span><span class=n>StringIO</span><span class=p>(</span><span class=n>os</span><span class=o>.</span><span class=n>environ</span><span class=p>[</span><span class=s1>&#39;SSH_KEY&#39;</span><span class=p>]))</span>
+            <span class=n>look_for_keys</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>pkey</span> <span class=o>=</span> <span class=kc>None</span>
+            <span class=n>look_for_keys</span> <span class=o>=</span> <span class=kc>True</span>
+
+        <span class=n>username</span> <span class=o>=</span> <span class=n>getpass</span><span class=o>.</span><span class=n>getuser</span><span class=p>()</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span> <span class=k>else</span> <span class=n>u</span><span class=o>.</span><span class=n>username</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>client</span><span class=o>.</span><span class=n>connect</span><span class=p>(</span>
+                <span class=n>u</span><span class=o>.</span><span class=n>hostname</span><span class=p>,</span>
+                <span class=n>username</span><span class=o>=</span><span class=n>username</span><span class=p>,</span>
+                <span class=n>password</span><span class=o>=</span><span class=n>u</span><span class=o>.</span><span class=n>password</span><span class=p>,</span>
+                <span class=n>pkey</span><span class=o>=</span><span class=n>pkey</span><span class=p>,</span>
+                <span class=n>look_for_keys</span><span class=o>=</span><span class=n>look_for_keys</span><span class=p>,</span>
+                <span class=n>port</span><span class=o>=</span><span class=mi>22</span> <span class=k>if</span> <span class=ow>not</span> <span class=n>u</span><span class=o>.</span><span class=n>port</span> <span class=k>else</span> <span class=n>u</span><span class=o>.</span><span class=n>port</span><span class=p>,</span>
+            <span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache update failure to connect via SSH: </span><span class=si>{</span><span class=n>u</span><span class=o>.</span><span class=n>hostname</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>sftp_client</span> <span class=o>=</span> <span class=n>client</span><span class=o>.</span><span class=n>open_sftp</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache update failure to open sftp for </span><span class=si>{</span><span class=n>u</span><span class=o>.</span><span class=n>hostname</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+
+        <span class=n>localpath</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>sftp_client</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>remotepath</span><span class=o>=</span><span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>[</span><span class=mi>1</span><span class=p>:],</span> <span class=n>localpath</span><span class=o>=</span><span class=p>(</span><span class=n>localpath</span><span class=o>.</span><span class=fm>__str__</span><span class=p>()))</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error getting remote resource </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1> into cache </span><span class=si>{</span><span class=n>localpath</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.remote.cache.SFTPFetcher-functions>Functions<a href=#trestle.core.remote.cache.SFTPFetcher-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.remote.cache.SFTPFetcher.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span></code> <a href=#trestle.core.remote.cache.SFTPFetcher.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize SFTP fetcher. Update the expected cache path as per caching specs.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=pathlib.Path>Path</span></code> </td> <td> <div class=doc-md-description> <p>Path of the trestle workspace, i.e., within which .trestle is to be found.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>uri</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Reference to the remote file to cache that can be fetched using the sftp:// scheme.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/remote/cache.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>uri</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize SFTP fetcher. Update the expected cache path as per caching specs.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.</span>
+<span class=sd>        uri: Reference to the remote file to cache that can be fetched using the sftp:// scheme.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;initialize SFTPFetcher for uri </span><span class=si>{</span><span class=n>uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>uri</span><span class=p>)</span>
+    <span class=c1># Is this a valid URI, however? Username and password are optional, of course.</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>u</span> <span class=o>=</span> <span class=n>parse</span><span class=o>.</span><span class=n>urlparse</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;SFTP fetcher unable to parse uri </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1> error </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Unable to parse malformed url </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1> error </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;SFTP fetcher with parsed uri </span><span class=si>{</span><span class=n>u</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>u</span><span class=o>.</span><span class=n>hostname</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;SFTP fetcher uri missing hostname&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Malformed URI, cannot parse hostname in URL </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: missing hostname </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;SFTP fetcher uri missing path&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Malformed URI, cannot parse path in URL </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Cache request for invalid input URI: missing file path </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_uri</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>sftp_cached_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_cache_path</span> <span class=o>/</span> <span class=n>u</span><span class=o>.</span><span class=n>hostname</span>
+    <span class=c1># Skip any number of back- or forward slashes preceding the URL path (u.path)</span>
+    <span class=n>path_parent</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>[</span><span class=n>re</span><span class=o>.</span><span class=n>search</span><span class=p>(</span><span class=s1>&#39;[^/</span><span class=se>\\\\</span><span class=s1>]&#39;</span><span class=p>,</span> <span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>span</span><span class=p>()[</span><span class=mi>0</span><span class=p>]:])</span><span class=o>.</span><span class=n>parent</span>
+    <span class=n>sftp_cached_dir</span> <span class=o>=</span> <span class=n>sftp_cached_dir</span> <span class=o>/</span> <span class=n>path_parent</span>
+    <span class=n>sftp_cached_dir</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_cached_object_path</span> <span class=o>=</span> <span class=n>sftp_cached_dir</span> <span class=o>/</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>u</span><span class=o>.</span><span class=n>path</span><span class=p>)</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/repository/index.html b/latest/reference/API/trestle/core/repository/index.html
new file mode 100644
index 000000000..cb55e248d
--- /dev/null
+++ b/latest/reference/API/trestle/core/repository/index.html
@@ -0,0 +1,2299 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.repository module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/repository/ rel=canonical><link href=../refs_validator/ rel=prev><link href=../rule_parameters_validator/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.repository - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.repository - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.repository module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/repository.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/repository/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.repository - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.repository module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/repository.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.repository class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.repository </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.repository </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.repository </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.repository class=md-nav__link> <span class=md-ellipsis> repository </span> </a> <nav class=md-nav aria-label=repository> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring class=md-nav__link> <span class=md-ellipsis> AgileAuthoring </span> </a> <nav class=md-nav aria-label=AgileAuthoring> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.assemble_catalog_markdown class=md-nav__link> <span class=md-ellipsis> assemble_catalog_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.assemble_component_definition_markdown class=md-nav__link> <span class=md-ellipsis> assemble_component_definition_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.assemble_profile_markdown class=md-nav__link> <span class=md-ellipsis> assemble_profile_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.assemble_ssp_markdown class=md-nav__link> <span class=md-ellipsis> assemble_ssp_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.generate_catalog_markdown class=md-nav__link> <span class=md-ellipsis> generate_catalog_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.generate_component_definition_markdown class=md-nav__link> <span class=md-ellipsis> generate_component_definition_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.generate_profile_markdown class=md-nav__link> <span class=md-ellipsis> generate_profile_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.generate_ssp_markdown class=md-nav__link> <span class=md-ellipsis> generate_ssp_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL class=md-nav__link> <span class=md-ellipsis> ManagedOSCAL </span> </a> <nav class=md-nav aria-label=ManagedOSCAL> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.file_content_type class=md-nav__link> <span class=md-ellipsis> file_content_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.filepath class=md-nav__link> <span class=md-ellipsis> filepath </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.model_alias class=md-nav__link> <span class=md-ellipsis> model_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.model_dir class=md-nav__link> <span class=md-ellipsis> model_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.model_name class=md-nav__link> <span class=md-ellipsis> model_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.model_type class=md-nav__link> <span class=md-ellipsis> model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.root_dir class=md-nav__link> <span class=md-ellipsis> root_dir </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.read class=md-nav__link> <span class=md-ellipsis> read </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.split class=md-nav__link> <span class=md-ellipsis> split </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.write class=md-nav__link> <span class=md-ellipsis> write </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository class=md-nav__link> <span class=md-ellipsis> Repository </span> </a> <nav class=md-nav aria-label=Repository> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.Repository-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.root_dir class=md-nav__link> <span class=md-ellipsis> root_dir </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.assemble_model class=md-nav__link> <span class=md-ellipsis> assemble_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.delete_model class=md-nav__link> <span class=md-ellipsis> delete_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.get_model class=md-nav__link> <span class=md-ellipsis> get_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.import_model class=md-nav__link> <span class=md-ellipsis> import_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.list_models class=md-nav__link> <span class=md-ellipsis> list_models </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.load_and_import_model class=md-nav__link> <span class=md-ellipsis> load_and_import_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.validate_model class=md-nav__link> <span class=md-ellipsis> validate_model </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.repository class=md-nav__link> <span class=md-ellipsis> repository </span> </a> <nav class=md-nav aria-label=repository> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring class=md-nav__link> <span class=md-ellipsis> AgileAuthoring </span> </a> <nav class=md-nav aria-label=AgileAuthoring> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.assemble_catalog_markdown class=md-nav__link> <span class=md-ellipsis> assemble_catalog_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.assemble_component_definition_markdown class=md-nav__link> <span class=md-ellipsis> assemble_component_definition_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.assemble_profile_markdown class=md-nav__link> <span class=md-ellipsis> assemble_profile_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.assemble_ssp_markdown class=md-nav__link> <span class=md-ellipsis> assemble_ssp_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.generate_catalog_markdown class=md-nav__link> <span class=md-ellipsis> generate_catalog_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.generate_component_definition_markdown class=md-nav__link> <span class=md-ellipsis> generate_component_definition_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.generate_profile_markdown class=md-nav__link> <span class=md-ellipsis> generate_profile_markdown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.AgileAuthoring.generate_ssp_markdown class=md-nav__link> <span class=md-ellipsis> generate_ssp_markdown </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL class=md-nav__link> <span class=md-ellipsis> ManagedOSCAL </span> </a> <nav class=md-nav aria-label=ManagedOSCAL> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.file_content_type class=md-nav__link> <span class=md-ellipsis> file_content_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.filepath class=md-nav__link> <span class=md-ellipsis> filepath </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.model_alias class=md-nav__link> <span class=md-ellipsis> model_alias </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.model_dir class=md-nav__link> <span class=md-ellipsis> model_dir </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.model_name class=md-nav__link> <span class=md-ellipsis> model_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.model_type class=md-nav__link> <span class=md-ellipsis> model_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.root_dir class=md-nav__link> <span class=md-ellipsis> root_dir </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.read class=md-nav__link> <span class=md-ellipsis> read </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.split class=md-nav__link> <span class=md-ellipsis> split </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.ManagedOSCAL.write class=md-nav__link> <span class=md-ellipsis> write </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository class=md-nav__link> <span class=md-ellipsis> Repository </span> </a> <nav class=md-nav aria-label=Repository> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.Repository-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.root_dir class=md-nav__link> <span class=md-ellipsis> root_dir </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.assemble_model class=md-nav__link> <span class=md-ellipsis> assemble_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.delete_model class=md-nav__link> <span class=md-ellipsis> delete_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.get_model class=md-nav__link> <span class=md-ellipsis> get_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.import_model class=md-nav__link> <span class=md-ellipsis> import_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.list_models class=md-nav__link> <span class=md-ellipsis> list_models </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.load_and_import_model class=md-nav__link> <span class=md-ellipsis> load_and_import_model </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.repository.Repository.validate_model class=md-nav__link> <span class=md-ellipsis> validate_model </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.repository-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.repository</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.repository class="doc doc-heading"> <code>trestle.core.repository</code> <a href=#trestle.core.repository class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Repository APIs.</p> <div class="doc doc-children"> <h3 id=trestle.core.repository-attributes>Attributes<a href=#trestle.core.repository-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.repository.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.repository.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.repository-classes>Classes<a href=#trestle.core.repository-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.repository.AgileAuthoring class="doc doc-heading"> <code>AgileAuthoring</code> <a href=#trestle.core.repository.AgileAuthoring class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.repository.Repository href=#trestle.core.repository.Repository>Repository</a></code></p> <p>AgileAuthoring extends the Repository class for performing authoring specific operations on Trestle repository.</p> <p>This class provides a set of APIs to perform generate and assemble authoring operations in the trestle repository rather than using the command line.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span>
+<span class=normal>654</span>
+<span class=normal>655</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AgileAuthoring</span><span class=p>(</span><span class=n>Repository</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    AgileAuthoring extends the Repository class for performing authoring specific operations on Trestle repository.</span>
+
+<span class=sd>    This class provides a set of APIs to perform generate and assemble authoring operations in the trestle repository</span>
+<span class=sd>    rather than using the command line.</span>
+
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize trestle repository object.&quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>root_dir</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>assemble_catalog_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>markdown_dir</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>set_parameters</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Assemble catalog markdown into OSCAL Catalog in JSON.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type catalog.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+            <span class=n>markdown</span><span class=o>=</span><span class=n>markdown_dir</span><span class=p>,</span>
+            <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+            <span class=n>set_parameters</span><span class=o>=</span><span class=n>set_parameters</span><span class=p>,</span>
+            <span class=n>regenerate</span><span class=o>=</span><span class=n>regenerate</span><span class=p>,</span>
+            <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>,</span>
+            <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+        <span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>catalogauthorcmd</span><span class=o>.</span><span class=n>CatalogAssemble</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error assembling catalog </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>assemble_profile_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>markdown_dir</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>set_parameters</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>allowed_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Assemble profile markdown into OSCAL Profile in JSON.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type profile.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+            <span class=n>markdown</span><span class=o>=</span><span class=n>markdown_dir</span><span class=p>,</span>
+            <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+            <span class=n>set_parameters</span><span class=o>=</span><span class=n>set_parameters</span><span class=p>,</span>
+            <span class=n>regenerate</span><span class=o>=</span><span class=n>regenerate</span><span class=p>,</span>
+            <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>,</span>
+            <span class=n>sections</span><span class=o>=</span><span class=n>sections</span><span class=p>,</span>
+            <span class=n>required_sections</span><span class=o>=</span><span class=n>required_sections</span><span class=p>,</span>
+            <span class=n>allowed_sections</span><span class=o>=</span><span class=n>allowed_sections</span><span class=p>,</span>
+            <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+        <span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>profileauthorcmd</span><span class=o>.</span><span class=n>ProfileAssemble</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error assembling profile </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>assemble_component_definition_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>markdown_dir</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span> <span class=n>version</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Assemble component definition markdown into OSCAL Component Definition in JSON.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type component definition.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+            <span class=n>markdown</span><span class=o>=</span><span class=n>markdown_dir</span><span class=p>,</span>
+            <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+            <span class=n>regenerate</span><span class=o>=</span><span class=n>regenerate</span><span class=p>,</span>
+            <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>,</span>
+            <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+        <span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>componentauthorcmd</span><span class=o>.</span><span class=n>ComponentAssemble</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error assembling component definition </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>assemble_ssp_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>markdown_dir</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>compdefs</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Assemble ssp markdown into OSCAL SSP in JSON.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type ssp.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+            <span class=n>markdown</span><span class=o>=</span><span class=n>markdown_dir</span><span class=p>,</span>
+            <span class=n>compdefs</span><span class=o>=</span><span class=n>compdefs</span><span class=p>,</span>
+            <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+            <span class=n>regenerate</span><span class=o>=</span><span class=n>regenerate</span><span class=p>,</span>
+            <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>,</span>
+            <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+        <span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>sspauthorcmd</span><span class=o>.</span><span class=n>SSPAssemble</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error assembling ssp </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>generate_catalog_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>force_overwrite</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate catalog markdown from OSCAL Catalog in JSON.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type catalog.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+            <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+            <span class=n>force_overwrite</span><span class=o>=</span><span class=n>force_overwrite</span><span class=p>,</span>
+            <span class=n>yaml_header</span><span class=o>=</span><span class=n>yaml_header</span><span class=p>,</span>
+            <span class=n>overwrite_header_values</span><span class=o>=</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+            <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+        <span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>catalogauthorcmd</span><span class=o>.</span><span class=n>CatalogGenerate</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generate markdown for catalog </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> markdown generated successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>generate_profile_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>force_overwrite</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate profile markdown from OSCAL Profile in JSON.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type profile.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+            <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+            <span class=n>force_overwrite</span><span class=o>=</span><span class=n>force_overwrite</span><span class=p>,</span>
+            <span class=n>yaml_header</span><span class=o>=</span><span class=n>yaml_header</span><span class=p>,</span>
+            <span class=n>overwrite_header_values</span><span class=o>=</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+            <span class=n>sections</span><span class=o>=</span><span class=n>sections</span><span class=p>,</span>
+            <span class=n>required_sections</span><span class=o>=</span><span class=n>required_sections</span><span class=p>,</span>
+            <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+        <span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>profileauthorcmd</span><span class=o>.</span><span class=n>ProfileGenerate</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generate markdown for profile </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> markdown generated successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>generate_component_definition_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>force_overwrite</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate component definition markdown from OSCAL Component Definition in JSON.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type component definition.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>force_overwrite</span><span class=o>=</span><span class=n>force_overwrite</span><span class=p>,</span> <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+        <span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>componentauthorcmd</span><span class=o>.</span><span class=n>ComponentGenerate</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generating markdown for component definition </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> markdown generated successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>generate_ssp_markdown</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>profile</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>compdefs</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>force_overwrite</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>include_all_parts</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate ssp markdown from OSCAL Profile and Component Definitions.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for </span><span class=si>{</span><span class=n>output</span><span class=si>}</span><span class=s1> of type ssp.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+            <span class=n>profile</span><span class=o>=</span><span class=n>profile</span><span class=p>,</span>
+            <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+            <span class=n>compdefs</span><span class=o>=</span><span class=n>compdefs</span><span class=p>,</span>
+            <span class=n>leveraged_ssp</span><span class=o>=</span><span class=n>leveraged_ssp</span><span class=p>,</span>
+            <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+            <span class=n>force_overwrite</span><span class=o>=</span><span class=n>force_overwrite</span><span class=p>,</span>
+            <span class=n>include_all_parts</span><span class=o>=</span><span class=n>include_all_parts</span><span class=p>,</span>
+            <span class=n>yaml_header</span><span class=o>=</span><span class=n>yaml_header</span><span class=p>,</span>
+            <span class=n>overwrite_header_values</span><span class=o>=</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+            <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+        <span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>sspauthorcmd</span><span class=o>.</span><span class=n>SSPGenerate</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in generating markdown for ssp </span><span class=si>{</span><span class=n>output</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>output</span><span class=si>}</span><span class=s1> markdown generated successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.repository.AgileAuthoring-functions>Functions<a href=#trestle.core.repository.AgileAuthoring-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.AgileAuthoring.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>root_dir</span><span class=p>)</span></code> <a href=#trestle.core.repository.AgileAuthoring.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle repository object.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize trestle repository object.&quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>root_dir</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.AgileAuthoring.assemble_catalog_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_catalog_markdown</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>output</span><span class=p>,</span> <span class=n>markdown_dir</span><span class=p>,</span> <span class=n>set_parameters</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>regenerate</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>version</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.repository.AgileAuthoring.assemble_catalog_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble catalog markdown into OSCAL Catalog in JSON.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>assemble_catalog_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>markdown_dir</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble catalog markdown into OSCAL Catalog in JSON.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type catalog.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+        <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+        <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+        <span class=n>markdown</span><span class=o>=</span><span class=n>markdown_dir</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+        <span class=n>set_parameters</span><span class=o>=</span><span class=n>set_parameters</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=o>=</span><span class=n>regenerate</span><span class=p>,</span>
+        <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>,</span>
+        <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+    <span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>catalogauthorcmd</span><span class=o>.</span><span class=n>CatalogAssemble</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error assembling catalog </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.AgileAuthoring.assemble_component_definition_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_component_definition_markdown</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>output</span><span class=p>,</span> <span class=n>markdown_dir</span><span class=p>,</span> <span class=n>regenerate</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>version</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>)</span></code> <a href=#trestle.core.repository.AgileAuthoring.assemble_component_definition_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble component definition markdown into OSCAL Component Definition in JSON.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>assemble_component_definition_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>markdown_dir</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span> <span class=n>version</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble component definition markdown into OSCAL Component Definition in JSON.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type component definition.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+        <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+        <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+        <span class=n>markdown</span><span class=o>=</span><span class=n>markdown_dir</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=o>=</span><span class=n>regenerate</span><span class=p>,</span>
+        <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>,</span>
+        <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+    <span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>componentauthorcmd</span><span class=o>.</span><span class=n>ComponentAssemble</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error assembling component definition </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.AgileAuthoring.assemble_profile_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_profile_markdown</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>output</span><span class=p>,</span> <span class=n>markdown_dir</span><span class=p>,</span> <span class=n>set_parameters</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>regenerate</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>version</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>sections</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>required_sections</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>allowed_sections</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.repository.AgileAuthoring.assemble_profile_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble profile markdown into OSCAL Profile in JSON.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>assemble_profile_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>markdown_dir</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>allowed_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble profile markdown into OSCAL Profile in JSON.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type profile.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+        <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+        <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+        <span class=n>markdown</span><span class=o>=</span><span class=n>markdown_dir</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+        <span class=n>set_parameters</span><span class=o>=</span><span class=n>set_parameters</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=o>=</span><span class=n>regenerate</span><span class=p>,</span>
+        <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>,</span>
+        <span class=n>sections</span><span class=o>=</span><span class=n>sections</span><span class=p>,</span>
+        <span class=n>required_sections</span><span class=o>=</span><span class=n>required_sections</span><span class=p>,</span>
+        <span class=n>allowed_sections</span><span class=o>=</span><span class=n>allowed_sections</span><span class=p>,</span>
+        <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+    <span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>profileauthorcmd</span><span class=o>.</span><span class=n>ProfileAssemble</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error assembling profile </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.AgileAuthoring.assemble_ssp_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_ssp_markdown</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>output</span><span class=p>,</span> <span class=n>markdown_dir</span><span class=p>,</span> <span class=n>compdefs</span><span class=p>,</span> <span class=n>regenerate</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>version</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.repository.AgileAuthoring.assemble_ssp_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble ssp markdown into OSCAL SSP in JSON.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>assemble_ssp_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>markdown_dir</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>compdefs</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>regenerate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble ssp markdown into OSCAL SSP in JSON.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type ssp.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+        <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+        <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+        <span class=n>markdown</span><span class=o>=</span><span class=n>markdown_dir</span><span class=p>,</span>
+        <span class=n>compdefs</span><span class=o>=</span><span class=n>compdefs</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+        <span class=n>regenerate</span><span class=o>=</span><span class=n>regenerate</span><span class=p>,</span>
+        <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>,</span>
+        <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+    <span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>sspauthorcmd</span><span class=o>.</span><span class=n>SSPAssemble</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error assembling ssp </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.AgileAuthoring.generate_catalog_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate_catalog_markdown</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>output</span><span class=p>,</span> <span class=n>force_overwrite</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>yaml_header</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>overwrite_header_values</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.repository.AgileAuthoring.generate_catalog_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate catalog markdown from OSCAL Catalog in JSON.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>generate_catalog_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>force_overwrite</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate catalog markdown from OSCAL Catalog in JSON.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type catalog.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+        <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+        <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+        <span class=n>force_overwrite</span><span class=o>=</span><span class=n>force_overwrite</span><span class=p>,</span>
+        <span class=n>yaml_header</span><span class=o>=</span><span class=n>yaml_header</span><span class=p>,</span>
+        <span class=n>overwrite_header_values</span><span class=o>=</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+        <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+    <span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>catalogauthorcmd</span><span class=o>.</span><span class=n>CatalogGenerate</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generate markdown for catalog </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> markdown generated successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.AgileAuthoring.generate_component_definition_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate_component_definition_markdown</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>output</span><span class=p>,</span> <span class=n>force_overwrite</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.repository.AgileAuthoring.generate_component_definition_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate component definition markdown from OSCAL Component Definition in JSON.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>generate_component_definition_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>force_overwrite</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate component definition markdown from OSCAL Component Definition in JSON.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type component definition.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+        <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>force_overwrite</span><span class=o>=</span><span class=n>force_overwrite</span><span class=p>,</span> <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+    <span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>componentauthorcmd</span><span class=o>.</span><span class=n>ComponentGenerate</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generating markdown for component definition </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> markdown generated successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.AgileAuthoring.generate_profile_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate_profile_markdown</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>output</span><span class=p>,</span> <span class=n>force_overwrite</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>yaml_header</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>overwrite_header_values</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>sections</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>required_sections</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.repository.AgileAuthoring.generate_profile_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate profile markdown from OSCAL Profile in JSON.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>generate_profile_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>force_overwrite</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>required_sections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate profile markdown from OSCAL Profile in JSON.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type profile.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+        <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+        <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+        <span class=n>force_overwrite</span><span class=o>=</span><span class=n>force_overwrite</span><span class=p>,</span>
+        <span class=n>yaml_header</span><span class=o>=</span><span class=n>yaml_header</span><span class=p>,</span>
+        <span class=n>overwrite_header_values</span><span class=o>=</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+        <span class=n>sections</span><span class=o>=</span><span class=n>sections</span><span class=p>,</span>
+        <span class=n>required_sections</span><span class=o>=</span><span class=n>required_sections</span><span class=p>,</span>
+        <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+    <span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>profileauthorcmd</span><span class=o>.</span><span class=n>ProfileGenerate</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error generate markdown for profile </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> markdown generated successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.AgileAuthoring.generate_ssp_markdown class="doc doc-heading"> <code class="highlight language-python"><span class=n>generate_ssp_markdown</span><span class=p>(</span><span class=n>profile</span><span class=p>,</span> <span class=n>output</span><span class=p>,</span> <span class=n>compdefs</span><span class=p>,</span> <span class=n>leveraged_ssp</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>force_overwrite</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>include_all_parts</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>yaml_header</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>overwrite_header_values</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.repository.AgileAuthoring.generate_ssp_markdown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate ssp markdown from OSCAL Profile and Component Definitions.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span>
+<span class=normal>654</span>
+<span class=normal>655</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>generate_ssp_markdown</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>profile</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>output</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>compdefs</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>leveraged_ssp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>force_overwrite</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>include_all_parts</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>yaml_header</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>overwrite_header_values</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate ssp markdown from OSCAL Profile and Component Definitions.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Generating markdown for </span><span class=si>{</span><span class=n>output</span><span class=si>}</span><span class=s1> of type ssp.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+        <span class=n>profile</span><span class=o>=</span><span class=n>profile</span><span class=p>,</span>
+        <span class=n>output</span><span class=o>=</span><span class=n>output</span><span class=p>,</span>
+        <span class=n>compdefs</span><span class=o>=</span><span class=n>compdefs</span><span class=p>,</span>
+        <span class=n>leveraged_ssp</span><span class=o>=</span><span class=n>leveraged_ssp</span><span class=p>,</span>
+        <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span>
+        <span class=n>force_overwrite</span><span class=o>=</span><span class=n>force_overwrite</span><span class=p>,</span>
+        <span class=n>include_all_parts</span><span class=o>=</span><span class=n>include_all_parts</span><span class=p>,</span>
+        <span class=n>yaml_header</span><span class=o>=</span><span class=n>yaml_header</span><span class=p>,</span>
+        <span class=n>overwrite_header_values</span><span class=o>=</span><span class=n>overwrite_header_values</span><span class=p>,</span>
+        <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+    <span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>sspauthorcmd</span><span class=o>.</span><span class=n>SSPGenerate</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in generating markdown for ssp </span><span class=si>{</span><span class=n>output</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>output</span><span class=si>}</span><span class=s1> markdown generated successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.repository.ManagedOSCAL class="doc doc-heading"> <code>ManagedOSCAL</code> <a href=#trestle.core.repository.ManagedOSCAL class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Object representing OSCAL models in repository for programmatic manipulation.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ManagedOSCAL</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Object representing OSCAL models in repository for programmatic manipulation.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize repository OSCAL model object.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>root_dir</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided root directory </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>root_dir</span><span class=p>)</span><span class=si>}</span><span class=s1> is not a valid Trestle root directory.&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>=</span> <span class=n>root_dir</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>model_type</span> <span class=o>=</span> <span class=n>model_type</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>model_name</span> <span class=o>=</span> <span class=n>name</span>
+
+        <span class=c1># set model alais and dir</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+        <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_name</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model dir </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+        <span class=n>file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>file_content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model file for model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>file_content_type</span> <span class=o>=</span> <span class=n>file_content_type</span>
+
+        <span class=n>filepath</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span> <span class=o>+</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_file_extension</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span>
+        <span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>filepath</span> <span class=o>=</span> <span class=n>filepath</span>
+
+    <span class=k>def</span> <span class=nf>read</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>OscalBaseModel</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read OSCAL model from repository.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Reading model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=n>model</span> <span class=o>=</span> <span class=n>load_validate_model_path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>filepath</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>model</span>
+
+    <span class=k>def</span> <span class=nf>write</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write OSCAL model to repository.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Writing model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+        <span class=c1># split directory if the model was split</span>
+        <span class=n>split_dir</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span>
+
+        <span class=c1># Prepare actions; delete split model dir if any, recreate model file, and write to filepath</span>
+        <span class=n>top_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>
+        <span class=n>remove_action</span> <span class=o>=</span> <span class=n>RemovePathAction</span><span class=p>(</span><span class=n>split_dir</span><span class=p>)</span>
+        <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>filepath</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>filepath</span><span class=p>,</span> <span class=n>top_element</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>file_content_type</span><span class=p>)</span>
+
+        <span class=c1># create a plan to create the directory and imported file.</span>
+        <span class=n>import_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>remove_action</span><span class=p>)</span>
+        <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+        <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+
+        <span class=n>import_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1> written to repository&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>split</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>elements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Split the given OSCAL model file in repository.</span>
+
+<span class=sd>        Model file path should be relative to the main model directory, e.g., model dir is $TRESTLE_ROOT/catalogs/NIST</span>
+<span class=sd>        then model file path can be &#39;catalog/metadata.json&#39; if metadata is to be split.</span>
+
+<span class=sd>        Elements should be specified relative to model file, e.g., &#39;metadata.props.*&#39;</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Splitting model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>, file </span><span class=si>{</span><span class=n>model_file</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=c1># input model_file should be relative to the model dir</span>
+        <span class=n>model_file_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>/</span> <span class=n>model_file</span>
+        <span class=n>model_file_path</span> <span class=o>=</span> <span class=n>model_file_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+        <span class=n>file_parent</span> <span class=o>=</span> <span class=n>model_file_path</span><span class=o>.</span><span class=n>parent</span>
+        <span class=n>filename</span> <span class=o>=</span> <span class=n>model_file_path</span><span class=o>.</span><span class=n>name</span>
+
+        <span class=n>elems</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>first</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>for</span> <span class=n>elem</span> <span class=ow>in</span> <span class=n>elements</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>first</span><span class=p>:</span>
+                <span class=n>elems</span> <span class=o>=</span> <span class=n>elem</span>
+                <span class=n>first</span> <span class=o>=</span> <span class=kc>False</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>elems</span> <span class=o>=</span> <span class=n>elems</span> <span class=o>+</span> <span class=s1>&#39;,&#39;</span> <span class=o>+</span> <span class=n>elem</span>
+
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>splitcmd</span><span class=o>.</span><span class=n>SplitCmd</span><span class=p>()</span><span class=o>.</span><span class=n>perform_split</span><span class=p>(</span><span class=n>file_parent</span><span class=p>,</span> <span class=n>filename</span><span class=p>,</span> <span class=n>elems</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in splitting model: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>, file </span><span class=si>{</span><span class=n>model_file</span><span class=si>}</span><span class=s1> splitted successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>merge</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>elements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>parent_model_dir</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge OSCAL elements in repository.</span>
+
+<span class=sd>        The parent_model_dir specifies the parent model direcotry in which to merge relative to main model dir.</span>
+<span class=sd>        For example, if we have to merge &#39;metadata.*&#39; into &#39;metadata&#39; then parent_model_dir should be the &#39;catalog&#39;</span>
+<span class=sd>        dir that contains the &#39;metadata.json&#39; file or the &#39;metadata&#39; directory</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Merging model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>, parent dir </span><span class=si>{</span><span class=n>parent_model_dir</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parent_model_dir</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>effective_cwd</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>effective_cwd</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>/</span> <span class=n>parent_model_dir</span>
+
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>elem</span> <span class=ow>in</span> <span class=n>elements</span><span class=p>:</span>
+                <span class=n>plan</span> <span class=o>=</span> <span class=n>mergecmd</span><span class=o>.</span><span class=n>MergeCmd</span><span class=o>.</span><span class=n>merge</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>,</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>elem</span><span class=p>),</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>)</span>
+                <span class=n>plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in merging model: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1> merged successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>validate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Validate OSCAL model in repository.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Validating model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=n>repo</span> <span class=o>=</span> <span class=n>Repository</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=n>repo</span><span class=o>.</span><span class=n>validate_model</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_type</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.repository.ManagedOSCAL-attributes>Attributes<a href=#trestle.core.repository.ManagedOSCAL-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.repository.ManagedOSCAL.file_content_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>file_content_type</span> <span class=o>=</span> <span class=n>file_content_type</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.repository.ManagedOSCAL.file_content_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.repository.ManagedOSCAL.filepath class="doc doc-heading"> <code class="highlight language-python"><span class=n>filepath</span> <span class=o>=</span> <span class=n>filepath</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.repository.ManagedOSCAL.filepath class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.repository.ManagedOSCAL.model_alias class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.repository.ManagedOSCAL.model_alias class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.repository.ManagedOSCAL.model_dir class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_name</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.repository.ManagedOSCAL.model_dir class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.repository.ManagedOSCAL.model_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_name</span> <span class=o>=</span> <span class=n>name</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.repository.ManagedOSCAL.model_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.repository.ManagedOSCAL.model_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_type</span> <span class=o>=</span> <span class=n>model_type</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.repository.ManagedOSCAL.model_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.repository.ManagedOSCAL.root_dir class="doc doc-heading"> <code class="highlight language-python"><span class=n>root_dir</span> <span class=o>=</span> <span class=n>root_dir</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.repository.ManagedOSCAL.root_dir class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.repository.ManagedOSCAL-functions>Functions<a href=#trestle.core.repository.ManagedOSCAL-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.ManagedOSCAL.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span></code> <a href=#trestle.core.repository.ManagedOSCAL.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize repository OSCAL model object.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize repository OSCAL model object.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>root_dir</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided root directory </span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>root_dir</span><span class=p>)</span><span class=si>}</span><span class=s1> is not a valid Trestle root directory.&#39;</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>=</span> <span class=n>root_dir</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>model_type</span> <span class=o>=</span> <span class=n>model_type</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>model_name</span> <span class=o>=</span> <span class=n>name</span>
+
+    <span class=c1># set model alais and dir</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+    <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_name</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model dir </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+    <span class=n>file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>file_content_type</span> <span class=o>==</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model file for model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>file_content_type</span> <span class=o>=</span> <span class=n>file_content_type</span>
+
+    <span class=n>filepath</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span> <span class=o>+</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_file_extension</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>/</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span>
+    <span class=p>)</span>
+
+    <span class=bp>self</span><span class=o>.</span><span class=n>filepath</span> <span class=o>=</span> <span class=n>filepath</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.ManagedOSCAL.merge class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge</span><span class=p>(</span><span class=n>elements</span><span class=p>,</span> <span class=n>parent_model_dir</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.repository.ManagedOSCAL.merge class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge OSCAL elements in repository.</p> <p>The parent_model_dir specifies the parent model direcotry in which to merge relative to main model dir. For example, if we have to merge 'metadata.*' into 'metadata' then parent_model_dir should be the 'catalog' dir that contains the 'metadata.json' file or the 'metadata' directory</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>merge</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>elements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>parent_model_dir</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Merge OSCAL elements in repository.</span>
+
+<span class=sd>    The parent_model_dir specifies the parent model direcotry in which to merge relative to main model dir.</span>
+<span class=sd>    For example, if we have to merge &#39;metadata.*&#39; into &#39;metadata&#39; then parent_model_dir should be the &#39;catalog&#39;</span>
+<span class=sd>    dir that contains the &#39;metadata.json&#39; file or the &#39;metadata&#39; directory</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Merging model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>, parent dir </span><span class=si>{</span><span class=n>parent_model_dir</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parent_model_dir</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>effective_cwd</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>effective_cwd</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>/</span> <span class=n>parent_model_dir</span>
+
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>elem</span> <span class=ow>in</span> <span class=n>elements</span><span class=p>:</span>
+            <span class=n>plan</span> <span class=o>=</span> <span class=n>mergecmd</span><span class=o>.</span><span class=n>MergeCmd</span><span class=o>.</span><span class=n>merge</span><span class=p>(</span><span class=n>effective_cwd</span><span class=p>,</span> <span class=n>ElementPath</span><span class=p>(</span><span class=n>elem</span><span class=p>),</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>)</span>
+            <span class=n>plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in merging model: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1> merged successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.ManagedOSCAL.read class="doc doc-heading"> <code class="highlight language-python"><span class=n>read</span><span class=p>()</span></code> <a href=#trestle.core.repository.ManagedOSCAL.read class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Read OSCAL model from repository.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>read</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>OscalBaseModel</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Read OSCAL model from repository.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Reading model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=n>model</span> <span class=o>=</span> <span class=n>load_validate_model_path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>filepath</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>model</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.ManagedOSCAL.split class="doc doc-heading"> <code class="highlight language-python"><span class=n>split</span><span class=p>(</span><span class=n>model_file</span><span class=p>,</span> <span class=n>elements</span><span class=p>)</span></code> <a href=#trestle.core.repository.ManagedOSCAL.split class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Split the given OSCAL model file in repository.</p> <p>Model file path should be relative to the main model directory, e.g., model dir is $TRESTLE_ROOT/catalogs/NIST then model file path can be 'catalog/metadata.json' if metadata is to be split.</p> <p>Elements should be specified relative to model file, e.g., 'metadata.props.*'</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>split</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_file</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span> <span class=n>elements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Split the given OSCAL model file in repository.</span>
+
+<span class=sd>    Model file path should be relative to the main model directory, e.g., model dir is $TRESTLE_ROOT/catalogs/NIST</span>
+<span class=sd>    then model file path can be &#39;catalog/metadata.json&#39; if metadata is to be split.</span>
+
+<span class=sd>    Elements should be specified relative to model file, e.g., &#39;metadata.props.*&#39;</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Splitting model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>, file </span><span class=si>{</span><span class=n>model_file</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=c1># input model_file should be relative to the model dir</span>
+    <span class=n>model_file_path</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span> <span class=o>/</span> <span class=n>model_file</span>
+    <span class=n>model_file_path</span> <span class=o>=</span> <span class=n>model_file_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+    <span class=n>file_parent</span> <span class=o>=</span> <span class=n>model_file_path</span><span class=o>.</span><span class=n>parent</span>
+    <span class=n>filename</span> <span class=o>=</span> <span class=n>model_file_path</span><span class=o>.</span><span class=n>name</span>
+
+    <span class=n>elems</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>first</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>for</span> <span class=n>elem</span> <span class=ow>in</span> <span class=n>elements</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>first</span><span class=p>:</span>
+            <span class=n>elems</span> <span class=o>=</span> <span class=n>elem</span>
+            <span class=n>first</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>elems</span> <span class=o>=</span> <span class=n>elems</span> <span class=o>+</span> <span class=s1>&#39;,&#39;</span> <span class=o>+</span> <span class=n>elem</span>
+
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>splitcmd</span><span class=o>.</span><span class=n>SplitCmd</span><span class=p>()</span><span class=o>.</span><span class=n>perform_split</span><span class=p>(</span><span class=n>file_parent</span><span class=p>,</span> <span class=n>filename</span><span class=p>,</span> <span class=n>elems</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in splitting model: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>, file </span><span class=si>{</span><span class=n>model_file</span><span class=si>}</span><span class=s1> splitted successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.ManagedOSCAL.validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate</span><span class=p>()</span></code> <a href=#trestle.core.repository.ManagedOSCAL.validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate OSCAL model in repository.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>validate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validate OSCAL model in repository.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Validating model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=n>repo</span> <span class=o>=</span> <span class=n>Repository</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=n>repo</span><span class=o>.</span><span class=n>validate_model</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_type</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.ManagedOSCAL.write class="doc doc-heading"> <code class="highlight language-python"><span class=n>write</span><span class=p>(</span><span class=n>model</span><span class=p>)</span></code> <a href=#trestle.core.repository.ManagedOSCAL.write class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write OSCAL model to repository.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write OSCAL model to repository.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Writing model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+    <span class=c1># split directory if the model was split</span>
+    <span class=n>split_dir</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>model_dir</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_alias</span><span class=p>)</span>
+
+    <span class=c1># Prepare actions; delete split model dir if any, recreate model file, and write to filepath</span>
+    <span class=n>top_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>
+    <span class=n>remove_action</span> <span class=o>=</span> <span class=n>RemovePathAction</span><span class=p>(</span><span class=n>split_dir</span><span class=p>)</span>
+    <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>filepath</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+    <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>filepath</span><span class=p>,</span> <span class=n>top_element</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>file_content_type</span><span class=p>)</span>
+
+    <span class=c1># create a plan to create the directory and imported file.</span>
+    <span class=n>import_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+    <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>remove_action</span><span class=p>)</span>
+    <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+    <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+
+    <span class=n>import_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>model_name</span><span class=si>}</span><span class=s1> written to repository&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.core.repository.Repository class="doc doc-heading"> <code>Repository</code> <a href=#trestle.core.repository.Repository class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Repository class for performing operations on Trestle repository.</p> <p>This class provides a set of APIs to perform operations on trestle repository programmatically rather than using the command line. It takes the trestle root directory as input while creating an instance of this object. Operations such as import and get model return a ManagedOSCAL object representing the specific model that can be used to perform operations on the specific models.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Repository</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Repository class for performing operations on Trestle repository.</span>
+
+<span class=sd>    This class provides a set of APIs to perform operations on trestle repository programmatically</span>
+<span class=sd>    rather than using the command line. It takes the trestle root directory as input while creating</span>
+<span class=sd>    an instance of this object. Operations such as import and get model return a ManagedOSCAL object</span>
+<span class=sd>    representing the specific model that can be used to perform operations on the specific models.</span>
+
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize trestle repository object.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>root_dir</span><span class=p>):</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided root directory </span><span class=si>{</span><span class=n>root_dir</span><span class=si>}</span><span class=s1> is not a valid Trestle root directory.&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>=</span> <span class=n>root_dir</span>
+
+    <span class=k>def</span> <span class=nf>import_model</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ManagedOSCAL</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Import OSCAL object into trestle repository.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Importing model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+        <span class=c1># Work out output directory and file</span>
+        <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+        <span class=n>desired_model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>plural_path</span>
+        <span class=n>desired_model_path</span> <span class=o>=</span> <span class=n>desired_model_dir</span> <span class=o>/</span> <span class=n>name</span> <span class=o>/</span> <span class=p>(</span><span class=n>model_alias</span> <span class=o>+</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>))</span>
+        <span class=n>desired_model_path</span> <span class=o>=</span> <span class=n>desired_model_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+
+        <span class=k>if</span> <span class=n>desired_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;OSCAL file to be created here: </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1> exists.&#39;</span><span class=p>)</span>
+
+        <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>desired_model_path</span><span class=p>)</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+
+        <span class=c1># Prepare actions</span>
+        <span class=n>top_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>
+        <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>desired_model_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>desired_model_path</span><span class=p>,</span> <span class=n>top_element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+
+        <span class=c1># create a plan to create the directory and imported file.</span>
+        <span class=n>import_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+        <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+        <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+        <span class=n>import_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+        <span class=c1># Validate the imported file, rollback if unsuccessful</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=n>errmsg</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>validate_model</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>success</span><span class=p>:</span>
+                <span class=n>errmsg</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Validation of model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> did not pass&#39;</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=n>errmsg</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>err</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=n>errmsg</span><span class=p>)</span>
+            <span class=n>errmsg</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Import of model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> failed. Validation failed with error: </span><span class=si>{</span><span class=n>err</span><span class=si>}</span><span class=s1>&#39;</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>success</span><span class=p>:</span>
+            <span class=c1># rollback in case of validation error or failure</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Rolling back import of model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> to </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>import_plan</span><span class=o>.</span><span class=n>rollback</span><span class=p>()</span>
+            <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>err</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Failed to rollback: </span><span class=si>{</span><span class=n>err</span><span class=si>}</span><span class=s1>. Remove </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1> to resolve state.&#39;</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Successful rollback of import to </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+            <span class=c1># raise trestle error</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=n>errmsg</span><span class=p>)</span>
+
+        <span class=c1># all well; model was imported and validated successfully</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1> imported successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>ManagedOSCAL</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>load_and_import_model</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>model_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ManagedOSCAL</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Load the model at the specified path into trestle with the specified name.&quot;&quot;&quot;</span>
+        <span class=n>fetcher</span> <span class=o>=</span> <span class=n>cache</span><span class=o>.</span><span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_fetcher</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=nb>str</span><span class=p>(</span><span class=n>model_path</span><span class=p>))</span>
+        <span class=n>model</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>fetcher</span><span class=o>.</span><span class=n>get_oscal</span><span class=p>(</span><span class=kc>True</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>import_model</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>list_models</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;List models of a given type in trestle repository.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Listing models of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+        <span class=n>models</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_models_of_type</span><span class=p>(</span><span class=n>model_alias</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>models</span>
+
+    <span class=k>def</span> <span class=nf>get_model</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ManagedOSCAL</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get a specific OSCAL model from repository.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Getting model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+        <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+        <span class=n>desired_model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>name</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>desired_model_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>desired_model_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>ManagedOSCAL</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>delete_model</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete an OSCAL model from repository.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Deleting model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+        <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+        <span class=n>desired_model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>name</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>desired_model_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>desired_model_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+        <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=n>desired_model_dir</span><span class=p>)</span>
+
+        <span class=c1># remove model from dist directory if it exists</span>
+        <span class=n>dist_model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_DIST_DIR</span> <span class=o>/</span> <span class=n>plural_path</span>
+        <span class=n>file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>dist_model_dir</span> <span class=o>/</span> <span class=n>name</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>file_content_type</span> <span class=o>!=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span><span class=p>:</span>
+            <span class=n>file_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span>
+                <span class=n>dist_model_dir</span><span class=p>,</span> <span class=n>name</span> <span class=o>+</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_file_extension</span><span class=p>(</span><span class=n>dist_model_dir</span> <span class=o>/</span> <span class=n>name</span><span class=p>)</span>
+            <span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Deleting model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> from dist directory.&#39;</span><span class=p>)</span>
+            <span class=n>os</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> deleted successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>assemble_model</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>extension</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;json&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Assemble an OSCAL model in repository and publish it to &#39;dist&#39; directory.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+            <span class=nb>type</span><span class=o>=</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>extension</span><span class=o>=</span><span class=n>extension</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+        <span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>assemblecmd</span><span class=o>.</span><span class=n>AssembleCmd</span><span class=p>()</span><span class=o>.</span><span class=n>assemble_model</span><span class=p>(</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in assembling model: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+
+    <span class=k>def</span> <span class=nf>validate_model</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Validate an OSCAL model in repository.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Validating model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+        <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+        <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+        <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span><span class=nb>type</span><span class=o>=</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span><span class=p>,</span> <span class=n>quiet</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ret</span> <span class=o>=</span> <span class=n>validatecmd</span><span class=o>.</span><span class=n>ValidateCmd</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in validating model: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> validated successfully.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.repository.Repository-attributes>Attributes<a href=#trestle.core.repository.Repository-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.repository.Repository.root_dir class="doc doc-heading"> <code class="highlight language-python"><span class=n>root_dir</span> <span class=o>=</span> <span class=n>root_dir</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.repository.Repository.root_dir class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.repository.Repository-functions>Functions<a href=#trestle.core.repository.Repository-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.Repository.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>root_dir</span><span class=p>)</span></code> <a href=#trestle.core.repository.Repository.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle repository object.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>root_dir</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize trestle repository object.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>file_utils</span><span class=o>.</span><span class=n>is_valid_project_root</span><span class=p>(</span><span class=n>root_dir</span><span class=p>):</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Provided root directory </span><span class=si>{</span><span class=n>root_dir</span><span class=si>}</span><span class=s1> is not a valid Trestle root directory.&#39;</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>=</span> <span class=n>root_dir</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.Repository.assemble_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>assemble_model</span><span class=p>(</span><span class=n>model_type</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>extension</span><span class=o>=</span><span class=s1>&#39;json&#39;</span><span class=p>)</span></code> <a href=#trestle.core.repository.Repository.assemble_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Assemble an OSCAL model in repository and publish it to 'dist' directory.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>assemble_model</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>extension</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;json&#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Assemble an OSCAL model in repository and publish it to &#39;dist&#39; directory.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Assembling model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span>
+        <span class=nb>type</span><span class=o>=</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>extension</span><span class=o>=</span><span class=n>extension</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span>
+    <span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>assemblecmd</span><span class=o>.</span><span class=n>AssembleCmd</span><span class=p>()</span><span class=o>.</span><span class=n>assemble_model</span><span class=p>(</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in assembling model: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> assembled successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.Repository.delete_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>delete_model</span><span class=p>(</span><span class=n>model_type</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span></code> <a href=#trestle.core.repository.Repository.delete_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Delete an OSCAL model from repository.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>delete_model</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Delete an OSCAL model from repository.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Deleting model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+    <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+    <span class=n>desired_model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>name</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>desired_model_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>desired_model_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+    <span class=n>shutil</span><span class=o>.</span><span class=n>rmtree</span><span class=p>(</span><span class=n>desired_model_dir</span><span class=p>)</span>
+
+    <span class=c1># remove model from dist directory if it exists</span>
+    <span class=n>dist_model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>const</span><span class=o>.</span><span class=n>TRESTLE_DIST_DIR</span> <span class=o>/</span> <span class=n>plural_path</span>
+    <span class=n>file_content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_content_type</span><span class=p>(</span><span class=n>dist_model_dir</span> <span class=o>/</span> <span class=n>name</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>file_content_type</span> <span class=o>!=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>UNKNOWN</span><span class=p>:</span>
+        <span class=n>file_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span>
+            <span class=n>dist_model_dir</span><span class=p>,</span> <span class=n>name</span> <span class=o>+</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>path_to_file_extension</span><span class=p>(</span><span class=n>dist_model_dir</span> <span class=o>/</span> <span class=n>name</span><span class=p>)</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Deleting model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> from dist directory.&#39;</span><span class=p>)</span>
+        <span class=n>os</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>file_path</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> deleted successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.Repository.get_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_model</span><span class=p>(</span><span class=n>model_type</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span></code> <a href=#trestle.core.repository.Repository.get_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get a specific OSCAL model from repository.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_model</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ManagedOSCAL</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get a specific OSCAL model from repository.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Getting model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+    <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+    <span class=n>desired_model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>plural_path</span> <span class=o>/</span> <span class=n>name</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>desired_model_dir</span><span class=o>.</span><span class=n>exists</span><span class=p>()</span> <span class=ow>or</span> <span class=ow>not</span> <span class=n>desired_model_dir</span><span class=o>.</span><span class=n>is_dir</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> does not exist.&#39;</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>ManagedOSCAL</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>model_type</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.Repository.import_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>import_model</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>content_type</span><span class=o>=</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span></code> <a href=#trestle.core.repository.Repository.import_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Import OSCAL object into trestle repository.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>import_model</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ManagedOSCAL</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Import OSCAL object into trestle repository.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Importing model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+    <span class=c1># Work out output directory and file</span>
+    <span class=n>plural_path</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span>
+
+    <span class=n>desired_model_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span> <span class=o>/</span> <span class=n>plural_path</span>
+    <span class=n>desired_model_path</span> <span class=o>=</span> <span class=n>desired_model_dir</span> <span class=o>/</span> <span class=n>name</span> <span class=o>/</span> <span class=p>(</span><span class=n>model_alias</span> <span class=o>+</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>content_type</span><span class=p>))</span>
+    <span class=n>desired_model_path</span> <span class=o>=</span> <span class=n>desired_model_path</span><span class=o>.</span><span class=n>resolve</span><span class=p>()</span>
+
+    <span class=k>if</span> <span class=n>desired_model_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;OSCAL file to be created here: </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1> exists.&#39;</span><span class=p>)</span>
+
+    <span class=n>content_type</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>to_content_type</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>desired_model_path</span><span class=p>)</span><span class=o>.</span><span class=n>suffix</span><span class=p>)</span>
+
+    <span class=c1># Prepare actions</span>
+    <span class=n>top_element</span> <span class=o>=</span> <span class=n>Element</span><span class=p>(</span><span class=n>model</span><span class=p>)</span>
+    <span class=n>create_action</span> <span class=o>=</span> <span class=n>CreatePathAction</span><span class=p>(</span><span class=n>desired_model_path</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+    <span class=n>write_action</span> <span class=o>=</span> <span class=n>WriteFileAction</span><span class=p>(</span><span class=n>desired_model_path</span><span class=p>,</span> <span class=n>top_element</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+
+    <span class=c1># create a plan to create the directory and imported file.</span>
+    <span class=n>import_plan</span> <span class=o>=</span> <span class=n>Plan</span><span class=p>()</span>
+    <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>create_action</span><span class=p>)</span>
+    <span class=n>import_plan</span><span class=o>.</span><span class=n>add_action</span><span class=p>(</span><span class=n>write_action</span><span class=p>)</span>
+    <span class=n>import_plan</span><span class=o>.</span><span class=n>execute</span><span class=p>()</span>
+
+    <span class=c1># Validate the imported file, rollback if unsuccessful</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=n>errmsg</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>success</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>validate_model</span><span class=p>(</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>success</span><span class=p>:</span>
+            <span class=n>errmsg</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Validation of model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> did not pass&#39;</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=n>errmsg</span><span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>err</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=n>errmsg</span><span class=p>)</span>
+        <span class=n>errmsg</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Import of model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> failed. Validation failed with error: </span><span class=si>{</span><span class=n>err</span><span class=si>}</span><span class=s1>&#39;</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>success</span><span class=p>:</span>
+        <span class=c1># rollback in case of validation error or failure</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Rolling back import of model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> to </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>import_plan</span><span class=o>.</span><span class=n>rollback</span><span class=p>()</span>
+        <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>err</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Failed to rollback: </span><span class=si>{</span><span class=n>err</span><span class=si>}</span><span class=s1>. Remove </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1> to resolve state.&#39;</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Successful rollback of import to </span><span class=si>{</span><span class=n>desired_model_path</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+        <span class=c1># raise trestle error</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=n>errmsg</span><span class=p>)</span>
+
+    <span class=c1># all well; model was imported and validated successfully</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1> imported successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>ManagedOSCAL</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>model</span><span class=o>.</span><span class=vm>__class__</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.Repository.list_models class="doc doc-heading"> <code class="highlight language-python"><span class=n>list_models</span><span class=p>(</span><span class=n>model_type</span><span class=p>)</span></code> <a href=#trestle.core.repository.Repository.list_models class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>List models of a given type in trestle repository.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>list_models</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;List models of a given type in trestle repository.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Listing models of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+    <span class=n>models</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_models_of_type</span><span class=p>(</span><span class=n>model_alias</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>models</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.Repository.load_and_import_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>load_and_import_model</span><span class=p>(</span><span class=n>model_path</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>content_type</span><span class=o>=</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span></code> <a href=#trestle.core.repository.Repository.load_and_import_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Load the model at the specified path into trestle with the specified name.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>load_and_import_model</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>model_path</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>content_type</span><span class=p>:</span> <span class=n>FileContentType</span> <span class=o>=</span> <span class=n>FileContentType</span><span class=o>.</span><span class=n>JSON</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ManagedOSCAL</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Load the model at the specified path into trestle with the specified name.&quot;&quot;&quot;</span>
+    <span class=n>fetcher</span> <span class=o>=</span> <span class=n>cache</span><span class=o>.</span><span class=n>FetcherFactory</span><span class=o>.</span><span class=n>get_fetcher</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=nb>str</span><span class=p>(</span><span class=n>model_path</span><span class=p>))</span>
+    <span class=n>model</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>fetcher</span><span class=o>.</span><span class=n>get_oscal</span><span class=p>(</span><span class=kc>True</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>import_model</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>content_type</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.repository.Repository.validate_model class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate_model</span><span class=p>(</span><span class=n>model_type</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span></code> <a href=#trestle.core.repository.Repository.validate_model class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate an OSCAL model in repository.</p> <details class=quote> <summary>Source code in <code>trestle/core/repository.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>validate_model</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>model_type</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>OscalBaseModel</span><span class=p>],</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validate an OSCAL model in repository.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Validating model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> of type </span><span class=si>{</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+    <span class=n>success</span> <span class=o>=</span> <span class=kc>False</span>
+
+    <span class=n>model_alias</span> <span class=o>=</span> <span class=n>classname_to_alias</span><span class=p>(</span><span class=n>model_type</span><span class=o>.</span><span class=vm>__name__</span><span class=p>,</span> <span class=n>AliasMode</span><span class=o>.</span><span class=n>JSON</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>parser</span><span class=o>.</span><span class=n>to_full_model_name</span><span class=p>(</span><span class=n>model_alias</span><span class=p>)</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Given model </span><span class=si>{</span><span class=n>model_alias</span><span class=si>}</span><span class=s1> is not a top level model.&#39;</span><span class=p>)</span>
+
+    <span class=n>verbose</span> <span class=o>=</span> <span class=n>log</span><span class=o>.</span><span class=n>get_current_verbosity_level</span><span class=p>(</span><span class=n>logger</span><span class=p>)</span>
+    <span class=n>args</span> <span class=o>=</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>(</span><span class=nb>type</span><span class=o>=</span><span class=n>model_alias</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>root_dir</span><span class=p>,</span> <span class=n>verbose</span><span class=o>=</span><span class=n>verbose</span><span class=p>,</span> <span class=n>quiet</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>ret</span> <span class=o>=</span> <span class=n>validatecmd</span><span class=o>.</span><span class=n>ValidateCmd</span><span class=p>()</span><span class=o>.</span><span class=n>_run</span><span class=p>(</span><span class=n>args</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>ret</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>success</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error in validating model: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Model </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> validated successfully.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>success</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.repository-functions>Functions<a href=#trestle.core.repository-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/resolver/merge/index.html b/latest/reference/API/trestle/core/resolver/merge/index.html
new file mode 100644
index 000000000..a6772db59
--- /dev/null
+++ b/latest/reference/API/trestle/core/resolver/merge/index.html
@@ -0,0 +1,384 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.resolver.merge module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/resolver/merge/ rel=canonical><link href=../../remote/cache/ rel=prev><link href=../modify/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.resolver.merge - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.resolver.merge - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.resolver.merge module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/resolver/merge.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/resolver/merge/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.resolver.merge - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.resolver.merge module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/resolver/merge.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.resolver.merge class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.resolver.merge </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33 checked> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.resolver.merge </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.resolver.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> <nav class=md-nav aria-label=merge> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.CATALOG_EXCLUDE class=md-nav__link> <span class=md-ellipsis> CATALOG_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.CONTROL_EXCLUDE class=md-nav__link> <span class=md-ellipsis> CONTROL_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.ID class=md-nav__link> <span class=md-ellipsis> ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.ITEM_EXCLUDE_MAP class=md-nav__link> <span class=md-ellipsis> ITEM_EXCLUDE_MAP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.NAME class=md-nav__link> <span class=md-ellipsis> NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.PARAMETER_EXCLUDE class=md-nav__link> <span class=md-ellipsis> PARAMETER_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.PART_EXCLUDE class=md-nav__link> <span class=md-ellipsis> PART_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.PROPERTY_EXCLUDE class=md-nav__link> <span class=md-ellipsis> PROPERTY_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.Merge class=md-nav__link> <span class=md-ellipsis> Merge </span> </a> <nav class=md-nav aria-label=Merge> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.Merge-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.Merge.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.Merge.process class=md-nav__link> <span class=md-ellipsis> process </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.resolver.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> <nav class=md-nav aria-label=merge> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.CATALOG_EXCLUDE class=md-nav__link> <span class=md-ellipsis> CATALOG_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.CONTROL_EXCLUDE class=md-nav__link> <span class=md-ellipsis> CONTROL_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.ID class=md-nav__link> <span class=md-ellipsis> ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.ITEM_EXCLUDE_MAP class=md-nav__link> <span class=md-ellipsis> ITEM_EXCLUDE_MAP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.NAME class=md-nav__link> <span class=md-ellipsis> NAME </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.PARAMETER_EXCLUDE class=md-nav__link> <span class=md-ellipsis> PARAMETER_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.PART_EXCLUDE class=md-nav__link> <span class=md-ellipsis> PART_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.PROPERTY_EXCLUDE class=md-nav__link> <span class=md-ellipsis> PROPERTY_EXCLUDE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.Merge class=md-nav__link> <span class=md-ellipsis> Merge </span> </a> <nav class=md-nav aria-label=Merge> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.Merge-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.Merge.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge.Merge.process class=md-nav__link> <span class=md-ellipsis> process </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.merge-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.resolver.merge</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.resolver.merge class="doc doc-heading"> <code>trestle.core.resolver.merge</code> <a href=#trestle.core.resolver.merge class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Create resolved catalog from profile.</p> <div class="doc doc-children"> <h3 id=trestle.core.resolver.merge-attributes>Attributes<a href=#trestle.core.resolver.merge-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.merge.CATALOG_EXCLUDE class="doc doc-heading"> <code class="highlight language-python"><span class=n>CATALOG_EXCLUDE</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;uuid&#39;</span><span class=p>,</span> <span class=s1>&#39;metadata&#39;</span><span class=p>,</span> <span class=s1>&#39;back_matter&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.merge.CATALOG_EXCLUDE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.merge.CONTROL_EXCLUDE class="doc doc-heading"> <code class="highlight language-python"><span class=n>CONTROL_EXCLUDE</span> <span class=o>=</span> <span class=p>[</span><span class=n>ID</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.merge.CONTROL_EXCLUDE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.merge.ID class="doc doc-heading"> <code class="highlight language-python"><span class=n>ID</span> <span class=o>=</span> <span class=s1>&#39;id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.merge.ID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.merge.ITEM_EXCLUDE_MAP class="doc doc-heading"> <code class="highlight language-python"><span class=n>ITEM_EXCLUDE_MAP</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;Part&#39;</span><span class=p>:</span> <span class=n>PART_EXCLUDE</span><span class=p>,</span> <span class=s1>&#39;Property&#39;</span><span class=p>:</span> <span class=n>PROPERTY_EXCLUDE</span><span class=p>,</span> <span class=s1>&#39;Parameter&#39;</span><span class=p>:</span> <span class=n>PARAMETER_EXCLUDE</span><span class=p>,</span> <span class=s1>&#39;Control&#39;</span><span class=p>:</span> <span class=n>CONTROL_EXCLUDE</span><span class=p>,</span> <span class=s1>&#39;Catalog&#39;</span><span class=p>:</span> <span class=n>CATALOG_EXCLUDE</span><span class=p>}</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.merge.ITEM_EXCLUDE_MAP class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.merge.NAME class="doc doc-heading"> <code class="highlight language-python"><span class=n>NAME</span> <span class=o>=</span> <span class=s1>&#39;name&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.merge.NAME class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.merge.PARAMETER_EXCLUDE class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAMETER_EXCLUDE</span> <span class=o>=</span> <span class=p>[</span><span class=n>ID</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.merge.PARAMETER_EXCLUDE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.merge.PART_EXCLUDE class="doc doc-heading"> <code class="highlight language-python"><span class=n>PART_EXCLUDE</span> <span class=o>=</span> <span class=p>[</span><span class=n>NAME</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.merge.PART_EXCLUDE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.merge.PROPERTY_EXCLUDE class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROPERTY_EXCLUDE</span> <span class=o>=</span> <span class=p>[</span><span class=n>NAME</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.merge.PROPERTY_EXCLUDE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.merge.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.merge.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.resolver.merge-classes>Classes<a href=#trestle.core.resolver.merge-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.resolver.merge.Merge class="doc doc-heading"> <code>Merge</code> <a href=#trestle.core.resolver.merge.Merge class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.pipeline.Pipeline.Filter href=../../pipeline/#trestle.core.pipeline.Pipeline.Filter>Filter</a></code></p> <p>Merge the incoming catalogs according to rules in the profile.</p> <p>The incoming catalogs have already been pruned based on the import. Now the controls must be gathered, merged, and grouped based on the merge settings.</p> <details class=quote> <summary>Source code in <code>trestle/core/resolver/merge.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Merge</span><span class=p>(</span><span class=n>Pipeline</span><span class=o>.</span><span class=n>Filter</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Merge the incoming catalogs according to rules in the profile.</span>
+
+<span class=sd>    The incoming catalogs have already been pruned based on the import.</span>
+<span class=sd>    Now the controls must be gathered, merged, and grouped based on the merge settings.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class with the profile.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;merge filter initialize&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span> <span class=o>=</span> <span class=n>profile</span>
+
+    <span class=k>def</span> <span class=nf>_get_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>item</span><span class=p>:</span> <span class=n>OBT</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+        <span class=n>id_</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>ID</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>id_</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>id_</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>NAME</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>id_</span>
+
+    <span class=k>def</span> <span class=nf>_item_genertor</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>dest</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OBT</span><span class=p>],</span> <span class=n>src</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OBT</span><span class=p>],</span> <span class=n>merge_method</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>OBT</span><span class=p>]:</span>
+        <span class=k>if</span> <span class=n>merge_method</span> <span class=o>==</span> <span class=n>prof</span><span class=o>.</span><span class=n>CombinationMethodValidValues</span><span class=o>.</span><span class=n>keep</span><span class=o>.</span><span class=n>value</span><span class=p>:</span>
+            <span class=n>dest</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>src</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>src</span><span class=p>:</span>
+                <span class=c1># if there is an exact copy of this in dest then ignore it</span>
+                <span class=k>if</span> <span class=n>item</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>dest</span><span class=p>:</span>
+                    <span class=k>yield</span> <span class=n>item</span>
+
+    <span class=k>def</span> <span class=nf>_merge_item</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>item</span><span class=p>:</span> <span class=n>OBT</span><span class=p>,</span> <span class=n>dest</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OBT</span><span class=p>],</span> <span class=n>merge_method</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+        <span class=n>merged</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=n>item_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_id</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>item_id</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>other</span> <span class=ow>in</span> <span class=n>dest</span><span class=p>:</span>
+                <span class=n>other_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_id</span><span class=p>(</span><span class=n>other</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>other_id</span> <span class=o>!=</span> <span class=n>item_id</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=n>merge_method</span> <span class=o>==</span> <span class=n>prof</span><span class=o>.</span><span class=n>CombinationMethodValidValues</span><span class=o>.</span><span class=n>merge</span><span class=o>.</span><span class=n>value</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_merge_items</span><span class=p>(</span><span class=n>other</span><span class=p>,</span> <span class=n>item</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>)</span>
+                <span class=n>merged</span> <span class=o>=</span> <span class=kc>True</span>
+                <span class=k>break</span>
+        <span class=k>return</span> <span class=n>merged</span>
+
+    <span class=k>def</span> <span class=nf>_merge_lists</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>dest</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OBT</span><span class=p>],</span> <span class=n>src</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OBT</span><span class=p>],</span> <span class=n>merge_method</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>added_items</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>merge_method</span> <span class=o>==</span> <span class=n>prof</span><span class=o>.</span><span class=n>CombinationMethodValidValues</span><span class=o>.</span><span class=n>keep</span><span class=o>.</span><span class=n>value</span><span class=p>:</span>
+            <span class=n>dest</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>src</span><span class=p>)</span>
+            <span class=k>return</span>
+        <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_item_genertor</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>):</span>
+            <span class=n>merged</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_merge_item</span><span class=p>(</span><span class=n>item</span><span class=p>,</span> <span class=n>dest</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>)</span>
+            <span class=c1># it isn&#39;t already in dest and no match was found for merge, so append</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>merged</span><span class=p>:</span>
+                <span class=n>added_items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+        <span class=n>dest</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>added_items</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_merge_attrs</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>dest</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>OBT</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OBT</span><span class=p>]],</span> <span class=n>src</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>OBT</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>OBT</span><span class=p>]],</span> <span class=n>attr</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge this attr of src into the attr of dest.&quot;&quot;&quot;</span>
+        <span class=n>src_attr</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>src</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>src_attr</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span>
+        <span class=n>item_type</span> <span class=o>=</span> <span class=nb>type</span><span class=p>(</span><span class=n>src</span><span class=p>)</span><span class=o>.</span><span class=vm>__name__</span>
+        <span class=k>if</span> <span class=n>attr</span> <span class=ow>in</span> <span class=n>ITEM_EXCLUDE_MAP</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>item_type</span><span class=p>,</span> <span class=p>[]):</span>
+            <span class=k>return</span>
+        <span class=n>dest_attr</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>dest_attr</span> <span class=ow>and</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>dest_attr</span><span class=p>,</span> <span class=nb>list</span><span class=p>):</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_merge_lists</span><span class=p>(</span><span class=n>dest_attr</span><span class=p>,</span> <span class=n>src_attr</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>)</span>
+            <span class=nb>setattr</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=n>dest_attr</span><span class=p>)</span>
+            <span class=k>return</span>
+        <span class=k>if</span> <span class=n>dest_attr</span> <span class=ow>and</span> <span class=n>merge_method</span> <span class=o>==</span> <span class=n>prof</span><span class=o>.</span><span class=n>CombinationMethodValidValues</span><span class=o>.</span><span class=n>use_first</span><span class=o>.</span><span class=n>value</span><span class=p>:</span>
+            <span class=k>return</span>
+        <span class=k>if</span> <span class=n>dest_attr</span> <span class=o>==</span> <span class=n>src_attr</span> <span class=ow>and</span> <span class=n>merge_method</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=kc>None</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>CombinationMethodValidValues</span><span class=o>.</span><span class=n>keep</span><span class=o>.</span><span class=n>value</span><span class=p>]:</span>
+            <span class=k>return</span>
+        <span class=nb>setattr</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=n>src_attr</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_merge_items</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>dest</span><span class=p>:</span> <span class=n>OBT</span><span class=p>,</span> <span class=n>src</span><span class=p>:</span> <span class=n>OBT</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge two items recursively.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>src</span><span class=o>.</span><span class=n>__fields_set__</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_merge_attrs</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>,</span> <span class=n>field</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_group_contents</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>],</span> <span class=n>List</span><span class=p>[</span><span class=n>com</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get flattened content of group and its groups recursively.&quot;&quot;&quot;</span>
+        <span class=n>controls</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>params</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>controls</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>controls</span><span class=p>))</span>
+        <span class=n>params</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>group</span><span class=o>.</span><span class=n>params</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>group</span><span class=o>.</span><span class=n>groups</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>sub_group</span> <span class=ow>in</span> <span class=n>group</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+                <span class=n>new_controls</span><span class=p>,</span> <span class=n>new_params</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_group_contents</span><span class=p>(</span><span class=n>sub_group</span><span class=p>)</span>
+                <span class=n>controls</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>new_controls</span><span class=p>)</span>
+                <span class=n>params</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>new_params</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>controls</span><span class=p>,</span> <span class=n>params</span>
+
+    <span class=k>def</span> <span class=nf>_flatten_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>as_is</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Flatten the groups of the catalog if as_is is False.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>as_is</span> <span class=ow>or</span> <span class=n>catalog</span><span class=o>.</span><span class=n>groups</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>catalog</span>
+
+        <span class=c1># as_is is False so flatten the controls into a single list</span>
+        <span class=n>catalog</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>)</span>
+        <span class=n>catalog</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>params</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>:</span>
+            <span class=n>new_controls</span><span class=p>,</span> <span class=n>new_params</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_group_contents</span><span class=p>(</span><span class=n>group</span><span class=p>)</span>
+            <span class=n>catalog</span><span class=o>.</span><span class=n>controls</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>new_controls</span><span class=p>)</span>
+            <span class=n>catalog</span><span class=o>.</span><span class=n>params</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>new_params</span><span class=p>)</span>
+        <span class=n>catalog</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>controls</span><span class=p>)</span>
+        <span class=n>catalog</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>params</span><span class=p>)</span>
+        <span class=n>catalog</span><span class=o>.</span><span class=n>groups</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>return</span> <span class=n>catalog</span>
+
+    <span class=k>def</span> <span class=nf>_merge_two_catalogs</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>dest</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>src</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>as_is</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+        <span class=c1># merge_method is use_first, merge, keep</span>
+        <span class=c1># no combine or merge_method equates to merge_method=keep</span>
+        <span class=c1># if as_is is false, the result is flattened</span>
+
+        <span class=n>dest</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_flatten_catalog</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>as_is</span><span class=p>)</span>
+        <span class=n>src</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_flatten_catalog</span><span class=p>(</span><span class=n>src</span><span class=p>,</span> <span class=n>as_is</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_merge_items</span><span class=p>(</span><span class=n>dest</span><span class=p>,</span> <span class=n>src</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>dest</span>
+
+    <span class=k>def</span> <span class=nf>_merge_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>merged</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>],</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Merge the controls in the catalog into merged catalog.&quot;&quot;&quot;</span>
+        <span class=c1># no merge means keep, including dups</span>
+        <span class=c1># same for merge with no combine</span>
+        <span class=c1># groups are merged only if separate directive such as as-is is given</span>
+        <span class=c1># use-first is a merge combination rule</span>
+        <span class=c1># merge is a merge combination rule for controls.  groups are not merged by this rule</span>
+        <span class=c1># merge/as-is and merge/custom are used for merging groups</span>
+        <span class=c1># if neither as-is nor custom is specified - just get single list of controls</span>
+        <span class=c1># unstructured controls should appear after any loose params</span>
+
+        <span class=c1># make copies to avoid changing input objects</span>
+        <span class=n>local_cat</span> <span class=o>=</span> <span class=n>catalog</span><span class=o>.</span><span class=n>copy</span><span class=p>(</span><span class=n>deep</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>local_merged</span> <span class=o>=</span> <span class=n>merged</span><span class=o>.</span><span class=n>copy</span><span class=p>(</span><span class=n>deep</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span> <span class=k>if</span> <span class=n>merged</span> <span class=k>else</span> <span class=kc>None</span>
+
+        <span class=n>merge_method</span> <span class=o>=</span> <span class=n>prof</span><span class=o>.</span><span class=n>CombinationMethodValidValues</span><span class=o>.</span><span class=n>keep</span><span class=o>.</span><span class=n>value</span>
+        <span class=n>as_is</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>merge</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>merge</span><span class=o>.</span><span class=n>custom</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Profile with custom merge is not supported.&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>merge</span><span class=o>.</span><span class=n>as_is</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>as_is</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>merge</span><span class=o>.</span><span class=n>as_is</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>merge</span><span class=o>.</span><span class=n>combine</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Profile has merge but no combine so defaulting to combine/merge.&#39;</span><span class=p>)</span>
+                <span class=n>merge_method</span> <span class=o>=</span> <span class=n>prof</span><span class=o>.</span><span class=n>CombinationMethodValidValues</span><span class=o>.</span><span class=n>merge</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>merge_combine</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>merge</span><span class=o>.</span><span class=n>combine</span>
+                <span class=k>if</span> <span class=n>merge_combine</span><span class=o>.</span><span class=n>method</span><span class=o>.</span><span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;Profile has merge combine but no method.  Defaulting to merge.&#39;</span><span class=p>)</span>
+                    <span class=n>merge_method</span> <span class=o>=</span> <span class=n>prof</span><span class=o>.</span><span class=n>CombinationMethodValidValues</span><span class=o>.</span><span class=n>merge</span><span class=o>.</span><span class=n>value</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>merge_method</span> <span class=o>=</span> <span class=n>merge_combine</span><span class=o>.</span><span class=n>method</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=k>if</span> <span class=n>local_merged</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_flatten_catalog</span><span class=p>(</span><span class=n>local_cat</span><span class=p>,</span> <span class=n>as_is</span><span class=p>)</span>
+
+        <span class=c1># merge the incoming catalog with merged based on merge_method and as_is</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_merge_two_catalogs</span><span class=p>(</span><span class=n>local_merged</span><span class=p>,</span> <span class=n>local_cat</span><span class=p>,</span> <span class=n>merge_method</span><span class=p>,</span> <span class=n>as_is</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>pipelines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Pipeline</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]:</span>  <span class=c1># type: ignore</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Merge the incoming catalogs.</span>
+
+<span class=sd>        This pulls from import and iterates over the incoming catalogs.</span>
+<span class=sd>        The way groups, lists of controls, and controls themselves get merged is specified by the profile.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>merged</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;merge entering process with </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>pipelines</span><span class=p>)</span><span class=si>}</span><span class=s1> pipelines&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>pipeline</span> <span class=ow>in</span> <span class=n>pipelines</span><span class=p>:</span>
+            <span class=n>catalog</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=n>pipeline</span><span class=o>.</span><span class=n>process</span><span class=p>(</span><span class=kc>None</span><span class=p>))</span>
+            <span class=n>merged</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_merge_catalog</span><span class=p>(</span><span class=n>merged</span><span class=p>,</span> <span class=n>catalog</span><span class=p>)</span>
+        <span class=k>yield</span> <span class=n>merged</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.resolver.merge.Merge-functions>Functions<a href=#trestle.core.resolver.merge.Merge-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.resolver.merge.Merge.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>profile</span><span class=p>)</span></code> <a href=#trestle.core.resolver.merge.Merge.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class with the profile.</p> <details class=quote> <summary>Source code in <code>trestle/core/resolver/merge.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class with the profile.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=s1>&#39;merge filter initialize&#39;</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span> <span class=o>=</span> <span class=n>profile</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.resolver.merge.Merge.process class="doc doc-heading"> <code class="highlight language-python"><span class=n>process</span><span class=p>(</span><span class=n>pipelines</span><span class=p>)</span></code> <a href=#trestle.core.resolver.merge.Merge.process class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Merge the incoming catalogs.</p> <p>This pulls from import and iterates over the incoming catalogs. The way groups, lists of controls, and controls themselves get merged is specified by the profile.</p> <details class=quote> <summary>Source code in <code>trestle/core/resolver/merge.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>pipelines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Pipeline</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]:</span>  <span class=c1># type: ignore</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Merge the incoming catalogs.</span>
+
+<span class=sd>    This pulls from import and iterates over the incoming catalogs.</span>
+<span class=sd>    The way groups, lists of controls, and controls themselves get merged is specified by the profile.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>merged</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;merge entering process with </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>pipelines</span><span class=p>)</span><span class=si>}</span><span class=s1> pipelines&#39;</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>pipeline</span> <span class=ow>in</span> <span class=n>pipelines</span><span class=p>:</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=n>pipeline</span><span class=o>.</span><span class=n>process</span><span class=p>(</span><span class=kc>None</span><span class=p>))</span>
+        <span class=n>merged</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_merge_catalog</span><span class=p>(</span><span class=n>merged</span><span class=p>,</span> <span class=n>catalog</span><span class=p>)</span>
+    <span class=k>yield</span> <span class=n>merged</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.resolver.merge-functions>Functions<a href=#trestle.core.resolver.merge-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/resolver/modify/index.html b/latest/reference/API/trestle/core/resolver/modify/index.html
new file mode 100644
index 000000000..dd422f66d
--- /dev/null
+++ b/latest/reference/API/trestle/core/resolver/modify/index.html
@@ -0,0 +1,698 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.resolver.modify module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/resolver/modify/ rel=canonical><link href=../merge/ rel=prev><link href=../prune/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.resolver.modify - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.resolver.modify - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.resolver.modify module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/resolver/modify.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/resolver/modify/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.resolver.modify - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.resolver.modify module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/resolver/modify.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.resolver.modify class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.resolver.modify </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33 checked> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.resolver.modify </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.resolver.modify class=md-nav__link> <span class=md-ellipsis> modify </span> </a> <nav class=md-nav aria-label=modify> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.modify-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify class=md-nav__link> <span class=md-ellipsis> Modify </span> </a> <nav class=md-nav aria-label=Modify> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify.show_value_warnings class=md-nav__link> <span class=md-ellipsis> show_value_warnings </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify.process class=md-nav__link> <span class=md-ellipsis> process </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.modify-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.resolver.modify class=md-nav__link> <span class=md-ellipsis> modify </span> </a> <nav class=md-nav aria-label=modify> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.modify-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify class=md-nav__link> <span class=md-ellipsis> Modify </span> </a> <nav class=md-nav aria-label=Modify> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify.show_value_warnings class=md-nav__link> <span class=md-ellipsis> show_value_warnings </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.modify.Modify.process class=md-nav__link> <span class=md-ellipsis> process </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.modify-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.resolver.modify</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.resolver.modify class="doc doc-heading"> <code>trestle.core.resolver.modify</code> <a href=#trestle.core.resolver.modify class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Create resolved catalog from profile.</p> <div class="doc doc-children"> <h3 id=trestle.core.resolver.modify-attributes>Attributes<a href=#trestle.core.resolver.modify-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.modify.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.modify.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.resolver.modify-classes>Classes<a href=#trestle.core.resolver.modify-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.resolver.modify.Modify class="doc doc-heading"> <code>Modify</code> <a href=#trestle.core.resolver.modify.Modify class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.pipeline.Pipeline.Filter href=../../pipeline/#trestle.core.pipeline.Pipeline.Filter>Filter</a></code></p> <p>Modify the controls based on the profile.</p> <details class=quote> <summary>Source code in <code>trestle/core/resolver/modify.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Modify</span><span class=p>(</span><span class=n>Pipeline</span><span class=o>.</span><span class=n>Filter</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Modify the controls based on the profile.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span>
+        <span class=n>change_prose</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>block_adds</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>block_params</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>params_format</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>,</span>
+        <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the filter.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span> <span class=o>=</span> <span class=n>profile</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CatalogInterface</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_block_adds</span> <span class=o>=</span> <span class=n>block_adds</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_block_params</span> <span class=o>=</span> <span class=n>block_params</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_change_prose</span> <span class=o>=</span> <span class=n>change_prose</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_params_format</span> <span class=o>=</span> <span class=n>params_format</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_param_rep</span> <span class=o>=</span> <span class=n>param_rep</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>show_value_warnings</span> <span class=o>=</span> <span class=n>show_value_warnings</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_value_assigned_prefix</span> <span class=o>=</span> <span class=n>value_assigned_prefix</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_value_not_assigned_prefix</span> <span class=o>=</span> <span class=n>value_not_assigned_prefix</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;modify initialize filter with profile </span><span class=si>{</span><span class=n>profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_adds_to_part</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>add</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>,</span> <span class=n>added_parts</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>attr</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;params&#39;</span><span class=p>,</span> <span class=s1>&#39;props&#39;</span><span class=p>,</span> <span class=s1>&#39;parts&#39;</span><span class=p>,</span> <span class=s1>&#39;links&#39;</span><span class=p>]:</span>
+            <span class=c1># don&#39;t add parts if already added earlier</span>
+            <span class=k>if</span> <span class=n>added_parts</span> <span class=ow>and</span> <span class=n>attr</span> <span class=o>==</span> <span class=s1>&#39;parts&#39;</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>add_list</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>add</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>add_list</span><span class=p>:</span>
+                <span class=n>Modify</span><span class=o>.</span><span class=n>_add_attr_to_part</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>add_list</span><span class=p>[:],</span> <span class=n>attr</span><span class=p>,</span> <span class=n>add</span><span class=o>.</span><span class=n>position</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_to_list</span><span class=p>(</span><span class=n>parts_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>],</span> <span class=n>add</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add the contents of the add according to its by_id and position.</span>
+
+<span class=sd>        Return True on success or False if id needed and not found.</span>
+
+<span class=sd>        This is only called when by_id is not None.</span>
+<span class=sd>        The add will be inserted if the id is found, or return False if not.</span>
+<span class=sd>        This allows a separate recursive routine to search sub-lists for the id.</span>
+<span class=sd>        Position before/after will put the item adjacent to the target in the same list as target</span>
+<span class=sd>        Position starting/ending will put the item within the target itself</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># Test here for matched by_id attribute.</span>
+        <span class=n>added_parts</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>for</span> <span class=n>index</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=nb>len</span><span class=p>(</span><span class=n>parts_list</span><span class=p>)):</span>
+            <span class=c1># find the matching part</span>
+            <span class=k>if</span> <span class=n>parts_list</span><span class=p>[</span><span class=n>index</span><span class=p>]</span><span class=o>.</span><span class=n>id</span> <span class=o>==</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>position</span> <span class=o>==</span> <span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>after</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>offset</span><span class=p>,</span> <span class=n>new_item</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>)):</span>
+                        <span class=n>parts_list</span><span class=o>.</span><span class=n>insert</span><span class=p>(</span><span class=n>index</span> <span class=o>+</span> <span class=mi>1</span> <span class=o>+</span> <span class=n>offset</span><span class=p>,</span> <span class=n>new_item</span><span class=p>)</span>
+                    <span class=n>added_parts</span> <span class=o>=</span> <span class=kc>True</span>
+                <span class=k>elif</span> <span class=n>add</span><span class=o>.</span><span class=n>position</span> <span class=o>==</span> <span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>before</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>offset</span><span class=p>,</span> <span class=n>new_item</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>parts</span><span class=p>)):</span>
+                        <span class=n>parts_list</span><span class=o>.</span><span class=n>insert</span><span class=p>(</span><span class=n>index</span> <span class=o>+</span> <span class=n>offset</span><span class=p>,</span> <span class=n>new_item</span><span class=p>)</span>
+                    <span class=n>added_parts</span> <span class=o>=</span> <span class=kc>True</span>
+                <span class=c1># if starting or ending or None, the adds go directly into this part according to type</span>
+                <span class=n>Modify</span><span class=o>.</span><span class=n>_add_adds_to_part</span><span class=p>(</span><span class=n>parts_list</span><span class=p>[</span><span class=n>index</span><span class=p>],</span> <span class=n>add</span><span class=p>,</span> <span class=n>added_parts</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_to_parts</span><span class=p>(</span><span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>],</span> <span class=n>add</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Add the add to the parts.</span>
+
+<span class=sd>        This is only called if add.by_id is not None.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>Modify</span><span class=o>.</span><span class=n>_add_to_list</span><span class=p>(</span><span class=n>parts</span><span class=p>,</span> <span class=n>add</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>Modify</span><span class=o>.</span><span class=n>_add_to_parts</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=n>add</span><span class=p>):</span>
+                <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_attr_to_part</span><span class=p>(</span><span class=n>part</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>,</span> <span class=n>items</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OBT</span><span class=p>],</span> <span class=n>attr</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>position</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>attr_list</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=nb>getattr</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=kc>None</span><span class=p>))</span>
+        <span class=c1># position may be None and if so will go at end</span>
+        <span class=k>if</span> <span class=n>position</span> <span class=ow>in</span> <span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>starting</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>before</span><span class=p>]:</span>
+            <span class=n>items</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>attr_list</span><span class=p>)</span>
+            <span class=n>attr_list</span> <span class=o>=</span> <span class=n>items</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>attr_list</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>items</span><span class=p>)</span>
+        <span class=nb>setattr</span><span class=p>(</span><span class=n>part</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=n>attr_list</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_attr_to_control</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>items</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OBT</span><span class=p>],</span> <span class=n>attr</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>position</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>attr_list</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=nb>getattr</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=kc>None</span><span class=p>))</span>
+        <span class=k>if</span> <span class=n>position</span> <span class=ow>in</span> <span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>starting</span><span class=p>,</span> <span class=n>prof</span><span class=o>.</span><span class=n>PositionValidValues</span><span class=o>.</span><span class=n>before</span><span class=p>]:</span>
+            <span class=n>items</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>attr_list</span><span class=p>)</span>
+            <span class=n>attr_list</span> <span class=o>=</span> <span class=n>items</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>attr_list</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>items</span><span class=p>)</span>
+        <span class=nb>setattr</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=n>attr_list</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_to_trestle_props</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>add</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add props to special trestle part that keeps track of inherited props.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=n>trestle_part</span> <span class=o>=</span> <span class=n>get_item_from_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=n>TRESTLE_INHERITED_PROPS_TRACKER</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>trestle_part</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>trestle_part</span> <span class=o>=</span> <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>(</span>
+                    <span class=nb>id</span><span class=o>=</span><span class=n>TRESTLE_INHERITED_PROPS_TRACKER</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=n>TRESTLE_INHERITED_PROPS_TRACKER</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=p>[],</span> <span class=n>parts</span><span class=o>=</span><span class=p>[]</span>
+                <span class=p>)</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>trestle_part</span><span class=p>)</span>
+                <span class=n>trestle_part</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>or</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span> <span class=o>==</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                <span class=n>trestle_part</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>by_id_part</span> <span class=o>=</span> <span class=n>get_item_from_list</span><span class=p>(</span><span class=n>trestle_part</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>,</span> <span class=k>lambda</span> <span class=n>p</span><span class=p>:</span> <span class=n>p</span><span class=o>.</span><span class=n>title</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>by_id_part</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>trestle_part</span><span class=o>.</span><span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span>
+                        <span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>TRESTLE_INHERITED_PROPS_TRACKER</span> <span class=o>+</span> <span class=s1>&#39;_&#39;</span> <span class=o>+</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=p>,</span> <span class=n>props</span><span class=o>=</span><span class=p>[])</span>
+                    <span class=p>)</span>
+                    <span class=n>by_id_part</span> <span class=o>=</span> <span class=n>trestle_part</span><span class=o>.</span><span class=n>parts</span><span class=p>[</span><span class=o>-</span><span class=mi>1</span><span class=p>]</span>
+                <span class=n>by_id_part</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>add</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_add_to_control</span><span class=p>(</span><span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>add</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Add</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;First step in applying Add to control.&quot;&quot;&quot;</span>
+        <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>or</span> <span class=n>add</span><span class=o>.</span><span class=n>by_id</span> <span class=o>==</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+            <span class=c1># add contents will be added to the control directly and with no recursion</span>
+            <span class=k>for</span> <span class=n>attr</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;params&#39;</span><span class=p>,</span> <span class=s1>&#39;props&#39;</span><span class=p>,</span> <span class=s1>&#39;parts&#39;</span><span class=p>,</span> <span class=s1>&#39;links&#39;</span><span class=p>]:</span>
+                <span class=n>add_list</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>add</span><span class=p>,</span> <span class=n>attr</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>add_list</span><span class=p>:</span>
+                    <span class=n>Modify</span><span class=o>.</span><span class=n>_add_attr_to_control</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>add_list</span><span class=p>[:],</span> <span class=n>attr</span><span class=p>,</span> <span class=n>add</span><span class=o>.</span><span class=n>position</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># this is only called if by_id is not None</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>Modify</span><span class=o>.</span><span class=n>_add_to_parts</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>,</span> <span class=n>add</span><span class=p>):</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Could not find id for add in control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>add</span><span class=o>.</span><span class=n>by_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>Modify</span><span class=o>.</span><span class=n>_add_to_trestle_props</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>add</span><span class=p>)</span>
+        <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_set_overwrite_items</span><span class=p>(</span><span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span> <span class=n>set_param</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=c1># these overwrite</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>class_</span><span class=p>:</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>class_</span> <span class=o>=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>class_</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>depends_on</span><span class=p>:</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>depends_on</span> <span class=o>=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>depends_on</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>label</span><span class=p>:</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>label</span> <span class=o>=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>label</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>usage</span><span class=p>:</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>usage</span> <span class=o>=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>usage</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>:</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>values</span> <span class=o>=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>values</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>select</span><span class=p>:</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>select</span> <span class=o>=</span> <span class=n>set_param</span><span class=o>.</span><span class=n>select</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_set_appended_items</span><span class=p>(</span><span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span> <span class=n>set_param</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=c1># these append</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>constraints</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>param</span><span class=o>.</span><span class=n>constraints</span><span class=p>:</span>
+                <span class=n>param</span><span class=o>.</span><span class=n>constraints</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>constraints</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>constraints</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>guidelines</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>param</span><span class=o>.</span><span class=n>guidelines</span><span class=p>:</span>
+                <span class=n>param</span><span class=o>.</span><span class=n>guidelines</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>guidelines</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>guidelines</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_set_replaced_or_appended_items</span><span class=p>(</span><span class=n>param</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>,</span> <span class=n>set_param</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=c1># these replace or append</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=n>new_props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+            <span class=n>names</span> <span class=o>=</span> <span class=p>[</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>new_props</span><span class=p>]</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>set_param</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=n>names</span><span class=p>:</span>
+                    <span class=n>new_props</span><span class=p>[</span><span class=n>names</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>)]</span> <span class=o>=</span> <span class=n>prop</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>new_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>new_props</span>
+        <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>links</span><span class=p>:</span>
+            <span class=n>new_links</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>param</span><span class=o>.</span><span class=n>links</span><span class=p>)</span>
+            <span class=n>hrefs</span> <span class=o>=</span> <span class=p>[</span><span class=n>link</span><span class=o>.</span><span class=n>href</span> <span class=k>for</span> <span class=n>link</span> <span class=ow>in</span> <span class=n>new_links</span><span class=p>]</span>
+            <span class=k>for</span> <span class=n>link</span> <span class=ow>in</span> <span class=n>set_param</span><span class=o>.</span><span class=n>links</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>link</span><span class=o>.</span><span class=n>href</span> <span class=ow>in</span> <span class=n>hrefs</span><span class=p>:</span>
+                    <span class=n>new_links</span><span class=p>[</span><span class=n>hrefs</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>link</span><span class=o>.</span><span class=n>href</span><span class=p>)]</span> <span class=o>=</span> <span class=n>link</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>new_links</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>link</span><span class=p>)</span>
+            <span class=n>param</span><span class=o>.</span><span class=n>links</span> <span class=o>=</span> <span class=n>new_links</span>
+
+    <span class=k>def</span> <span class=nf>_set_parameter_in_control_or_loose</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>set_param</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>SetParameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Find the control with the param_id in it and set the parameter contents.</span>
+
+<span class=sd>        It modifies controls in the control_dict not the catalog.</span>
+<span class=sd>        Parameters are either bound to a control or are &#39;loose&#39; and bound to the catalog itself.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># find the target param in control or the catalog&#39;s loose ones, i.e. catalog.params</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_by_param_id</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+        <span class=n>loose_param</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=n>control</span><span class=p>:</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>params</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>)</span>
+            <span class=n>param_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>param</span><span class=o>.</span><span class=n>id</span> <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>param_ids</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleNotFoundError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Param id </span><span class=si>{</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=si>}</span><span class=s1> not found in control </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>index</span> <span class=o>=</span> <span class=n>param_ids</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+            <span class=n>param</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>[</span><span class=n>index</span><span class=p>]</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>param</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>loose_param_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>param</span><span class=p>:</span>
+                <span class=n>loose_param</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;SetParameter for param_id </span><span class=si>{</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=si>}</span><span class=s1> not found in catalog&#39;</span><span class=p>)</span>
+                <span class=k>return</span>
+
+        <span class=c1># rules here follow https://pages.nist.gov/OSCAL/concepts/processing/profile-resolution/</span>
+        <span class=c1># see &#39;Modify Phase&#39; and Setting Parameters</span>
+
+        <span class=n>Modify</span><span class=o>.</span><span class=n>_set_overwrite_items</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>set_param</span><span class=p>)</span>
+        <span class=n>Modify</span><span class=o>.</span><span class=n>_set_appended_items</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>set_param</span><span class=p>)</span>
+        <span class=n>Modify</span><span class=o>.</span><span class=n>_set_replaced_or_appended_items</span><span class=p>(</span><span class=n>param</span><span class=p>,</span> <span class=n>set_param</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>loose_param</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>loose_param_dict</span><span class=p>[</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>param</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>[</span><span class=n>index</span><span class=p>]</span> <span class=o>=</span> <span class=n>param</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>replace_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_modify_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Modify the controls based on the profile.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;modify specify catalog </span><span class=si>{</span><span class=n>catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> for profile </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+        <span class=n>alters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>Alter</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=c1># find the modify and alters</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>modify</span><span class=p>:</span>
+            <span class=c1># change all parameter values</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>set_parameters</span> <span class=ow>and</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_block_params</span><span class=p>:</span>
+                <span class=n>set_param_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>set_parameters</span>
+                <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>set_param_list</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_set_parameter_in_control_or_loose</span><span class=p>(</span><span class=n>set_param</span><span class=p>)</span>
+            <span class=n>alters</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>alters</span>
+
+        <span class=c1># an add with no by-id applies to the control</span>
+        <span class=c1># if position is starting it should appear immediately after title</span>
+        <span class=c1># if position is ending it should appear at end</span>
+        <span class=c1># if not specified it defaults to ending</span>
+        <span class=c1># if no by-id then before is treated as starting and after is treated as ending</span>
+        <span class=k>if</span> <span class=n>alters</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span>
+            <span class=k>for</span> <span class=n>alter</span> <span class=ow>in</span> <span class=n>alters</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>alter</span><span class=o>.</span><span class=n>control_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Alter must have control id specified in profile </span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>)</span>
+                    <span class=k>continue</span>
+                <span class=n>id_</span> <span class=o>=</span> <span class=n>alter</span><span class=o>.</span><span class=n>control_id</span>
+                <span class=k>if</span> <span class=n>alter</span><span class=o>.</span><span class=n>removes</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Alter not supported for removes in profile </span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1> control </span><span class=si>{</span><span class=n>id_</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>continue</span>
+                <span class=c1># we want a warning about adds even if adds are blocked, as in profile generate</span>
+                <span class=k>if</span> <span class=n>alter</span><span class=o>.</span><span class=n>adds</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Alter has no adds in profile </span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1> control </span><span class=si>{</span><span class=n>id_</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_block_adds</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>add</span> <span class=ow>in</span> <span class=n>alter</span><span class=o>.</span><span class=n>adds</span><span class=p>:</span>
+                        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>id_</span><span class=p>)</span>
+                        <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                                <span class=sa>f</span><span class=s1>&#39;Alter/Add refers to control </span><span class=si>{</span><span class=n>id_</span><span class=si>}</span><span class=s1> but it is not found in the import &#39;</span>
+                                <span class=o>+</span> <span class=sa>f</span><span class=s1>&#39;for profile </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span>
+                            <span class=p>)</span>
+                        <span class=k>else</span><span class=p>:</span>
+                            <span class=bp>self</span><span class=o>.</span><span class=n>_add_to_control</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>add</span><span class=p>)</span>
+                            <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>replace_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_change_prose</span><span class=p>:</span>
+            <span class=c1># go through all controls and fix the prose based on param values</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>_change_prose_with_param_values</span><span class=p>(</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_params_format</span><span class=p>,</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_param_rep</span><span class=p>,</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>show_value_warnings</span><span class=p>,</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_value_assigned_prefix</span><span class=p>,</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_value_not_assigned_prefix</span>
+            <span class=p>)</span>
+
+        <span class=n>catalog</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_catalog</span><span class=p>()</span>
+
+        <span class=c1># update the original profile metadata with new contents</span>
+        <span class=c1># roles and responsible-parties will be pulled in with new uuid&#39;s</span>
+        <span class=c1># the title simply becomes the title of the current profile - and will get overwritten</span>
+        <span class=c1># by any other profiles downstream so that only the final profile title is used</span>
+        <span class=n>new_metadata</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span>
+        <span class=n>new_metadata</span><span class=o>.</span><span class=n>title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span>
+        <span class=n>new_metadata</span><span class=o>.</span><span class=n>oscal_version</span> <span class=o>=</span> <span class=n>OSCAL_VERSION</span>
+
+        <span class=n>links</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>import_</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>imports</span><span class=p>:</span>
+            <span class=n>links</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>(</span><span class=o>**</span><span class=p>{</span><span class=s1>&#39;href&#39;</span><span class=p>:</span> <span class=n>import_</span><span class=o>.</span><span class=n>href</span><span class=p>,</span> <span class=s1>&#39;rel&#39;</span><span class=p>:</span> <span class=n>RESOLUTION_SOURCE</span><span class=p>}))</span>
+        <span class=n>new_metadata</span><span class=o>.</span><span class=n>links</span> <span class=o>=</span> <span class=n>links</span>
+
+        <span class=c1># move catalog controls from dummy group &#39;&#39; into the catalog</span>
+        <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>catalog</span><span class=o>.</span><span class=n>groups</span><span class=p>):</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>group</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                <span class=n>catalog</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>group</span><span class=o>.</span><span class=n>controls</span>
+                <span class=n>catalog</span><span class=o>.</span><span class=n>groups</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>group</span><span class=p>)</span>
+                <span class=k>break</span>
+
+        <span class=n>catalog</span><span class=o>.</span><span class=n>metadata</span> <span class=o>=</span> <span class=n>new_metadata</span>
+
+        <span class=k>return</span> <span class=n>catalog</span>
+
+    <span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_iter</span><span class=p>:</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Make the modifications to the controls based on the profile.&quot;&quot;&quot;</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=n>catalog_iter</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;modify process with catalog </span><span class=si>{</span><span class=n>catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> using profile </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=p>)</span>
+        <span class=k>yield</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modify_controls</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.resolver.modify.Modify-attributes>Attributes<a href=#trestle.core.resolver.modify.Modify-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.core.resolver.modify.Modify.show_value_warnings class="doc doc-heading"> <code class="highlight language-python"><span class=n>show_value_warnings</span> <span class=o>=</span> <span class=n>show_value_warnings</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.core.resolver.modify.Modify.show_value_warnings class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.core.resolver.modify.Modify-functions>Functions<a href=#trestle.core.resolver.modify.Modify-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.resolver.modify.Modify.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>profile</span><span class=p>,</span> <span class=n>change_prose</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>block_adds</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>block_params</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>params_format</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>param_rep</span><span class=o>=</span><span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>,</span> <span class=n>show_value_warnings</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>value_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value_not_assigned_prefix</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.resolver.modify.Modify.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the filter.</p> <details class=quote> <summary>Source code in <code>trestle/core/resolver/modify.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>,</span>
+    <span class=n>change_prose</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>block_adds</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>block_params</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>params_format</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>param_rep</span><span class=p>:</span> <span class=n>ParameterRep</span> <span class=o>=</span> <span class=n>ParameterRep</span><span class=o>.</span><span class=n>LEAVE_MOUSTACHE</span><span class=p>,</span>
+    <span class=n>show_value_warnings</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>value_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value_not_assigned_prefix</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the filter.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span> <span class=o>=</span> <span class=n>profile</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CatalogInterface</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_block_adds</span> <span class=o>=</span> <span class=n>block_adds</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_block_params</span> <span class=o>=</span> <span class=n>block_params</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_change_prose</span> <span class=o>=</span> <span class=n>change_prose</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_params_format</span> <span class=o>=</span> <span class=n>params_format</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_param_rep</span> <span class=o>=</span> <span class=n>param_rep</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>show_value_warnings</span> <span class=o>=</span> <span class=n>show_value_warnings</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_value_assigned_prefix</span> <span class=o>=</span> <span class=n>value_assigned_prefix</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_value_not_assigned_prefix</span> <span class=o>=</span> <span class=n>value_not_assigned_prefix</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;modify initialize filter with profile </span><span class=si>{</span><span class=n>profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.resolver.modify.Modify.process class="doc doc-heading"> <code class="highlight language-python"><span class=n>process</span><span class=p>(</span><span class=n>catalog_iter</span><span class=p>)</span></code> <a href=#trestle.core.resolver.modify.Modify.process class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Make the modifications to the controls based on the profile.</p> <details class=quote> <summary>Source code in <code>trestle/core/resolver/modify.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_iter</span><span class=p>:</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Make the modifications to the controls based on the profile.&quot;&quot;&quot;</span>
+    <span class=n>catalog</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=n>catalog_iter</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span>
+        <span class=sa>f</span><span class=s1>&#39;modify process with catalog </span><span class=si>{</span><span class=n>catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> using profile </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=p>)</span>
+    <span class=k>yield</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modify_controls</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.resolver.modify-functions>Functions<a href=#trestle.core.resolver.modify-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/resolver/prune/index.html b/latest/reference/API/trestle/core/resolver/prune/index.html
new file mode 100644
index 000000000..6d4475eb3
--- /dev/null
+++ b/latest/reference/API/trestle/core/resolver/prune/index.html
@@ -0,0 +1,380 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.resolver.prune module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/resolver/prune/ rel=canonical><link href=../modify/ rel=prev><link href=../../../oscal/assessment_plan/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.resolver.prune - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.resolver.prune - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.resolver.prune module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/resolver/prune.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/resolver/prune/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.resolver.prune - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.resolver.prune module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/resolver/prune.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.resolver.prune class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.resolver.prune </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33 checked> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.resolver.prune </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.resolver.prune class=md-nav__link> <span class=md-ellipsis> prune </span> </a> <nav class=md-nav aria-label=prune> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.prune-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.Prune class=md-nav__link> <span class=md-ellipsis> Prune </span> </a> <nav class=md-nav aria-label=Prune> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.Prune-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.Prune.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.Prune.process class=md-nav__link> <span class=md-ellipsis> process </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.prune-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.resolver.prune class=md-nav__link> <span class=md-ellipsis> prune </span> </a> <nav class=md-nav aria-label=prune> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.prune-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.Prune class=md-nav__link> <span class=md-ellipsis> Prune </span> </a> <nav class=md-nav aria-label=Prune> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.Prune-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.Prune.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.prune.Prune.process class=md-nav__link> <span class=md-ellipsis> process </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.resolver.prune-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.resolver.prune</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.resolver.prune class="doc doc-heading"> <code>trestle.core.resolver.prune</code> <a href=#trestle.core.resolver.prune class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Create resolved catalog from profile.</p> <div class="doc doc-children"> <h3 id=trestle.core.resolver.prune-attributes>Attributes<a href=#trestle.core.resolver.prune-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.resolver.prune.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.resolver.prune.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.resolver.prune-classes>Classes<a href=#trestle.core.resolver.prune-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.resolver.prune.Prune class="doc doc-heading"> <code>Prune</code> <a href=#trestle.core.resolver.prune.Prune class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.pipeline.Pipeline.Filter href=../../pipeline/#trestle.core.pipeline.Pipeline.Filter>Filter</a></code></p> <p>Prune the catalog based on the import include rule.</p> <details class=quote> <summary>Source code in <code>trestle/core/resolver/prune.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Prune</span><span class=p>(</span><span class=n>Pipeline</span><span class=o>.</span><span class=n>Filter</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Prune the catalog based on the import include rule.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>import_</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Import</span><span class=p>,</span> <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Inject the import.</span>
+
+<span class=sd>        This needs to be created prior to knowing the catalog.</span>
+<span class=sd>        The profile itself is only needed for debug messages.</span>
+<span class=sd>        The import is one possibly several imports in that profile.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_import</span> <span class=o>=</span> <span class=n>import_</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span> <span class=o>=</span> <span class=n>profile</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CatalogInterface</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_set_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set the catalog used by the catalog interface.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span> <span class=o>=</span> <span class=n>catalog</span>
+
+    <span class=k>def</span> <span class=nf>_controls_selected</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>select_list</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>prof</span><span class=o>.</span><span class=n>SelectControl</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+        <span class=n>control_ids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>select_list</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>select_control</span> <span class=ow>in</span> <span class=n>select_list</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>select_control</span><span class=o>.</span><span class=n>matching</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Profiles with SelectControl based on matching are not supported.&#39;</span><span class=p>)</span>
+                <span class=n>include_children</span> <span class=o>=</span> <span class=n>select_control</span><span class=o>.</span><span class=n>with_child_controls</span> <span class=o>==</span> <span class=s1>&#39;yes&#39;</span>
+                <span class=k>if</span> <span class=n>select_control</span><span class=o>.</span><span class=n>with_ids</span><span class=p>:</span>
+                    <span class=n>new_ids</span> <span class=o>=</span> <span class=n>select_control</span><span class=o>.</span><span class=n>with_ids</span>
+                    <span class=k>for</span> <span class=n>withid_</span> <span class=ow>in</span> <span class=n>new_ids</span><span class=p>:</span>
+                        <span class=n>id_</span> <span class=o>=</span> <span class=n>withid_</span><span class=o>.</span><span class=n>__root__</span>
+                        <span class=n>control_ids</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>id_</span><span class=p>)</span>
+                        <span class=k>if</span> <span class=n>include_children</span><span class=p>:</span>
+                            <span class=n>control_ids</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_dependent_control_ids</span><span class=p>(</span><span class=n>id_</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>control_ids</span>
+
+    <span class=k>def</span> <span class=nf>_find_needed_control_ids</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get list of control_ids needed by profile and corresponding groups.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_import</span><span class=o>.</span><span class=n>include_controls</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>include_ids</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_controls_selected</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_import</span><span class=o>.</span><span class=n>include_controls</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_import</span><span class=o>.</span><span class=n>include_all</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Profile does not specify include-controls, so including all.&#39;</span><span class=p>)</span>
+            <span class=n>include_ids</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_ids</span><span class=p>()</span>
+
+        <span class=n>exclude_ids</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_controls_selected</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_import</span><span class=o>.</span><span class=n>exclude_controls</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>set</span><span class=p>(</span><span class=n>include_ids</span><span class=p>)</span><span class=o>.</span><span class=n>issuperset</span><span class=p>(</span><span class=nb>set</span><span class=p>(</span><span class=n>exclude_ids</span><span class=p>)):</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;include_ids is not a superset of exclude_ids in import </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_import</span><span class=o>.</span><span class=n>href</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=nb>sorted</span><span class=p>([</span><span class=n>id_</span> <span class=k>for</span> <span class=n>id_</span> <span class=ow>in</span> <span class=n>include_ids</span> <span class=k>if</span> <span class=n>id_</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>exclude_ids</span><span class=p>])</span>
+
+    <span class=k>def</span> <span class=nf>_prune_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>needed_ids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>,</span> <span class=n>exclude_ids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Prune the control based on the Import requirements.</span>
+
+<span class=sd>        This is only called if the control is needed</span>
+<span class=sd>        Some or all of its sub_controls may not be needed</span>
+<span class=sd>        This always returns the original control, possibly with fewer subcontrols</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>controls</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>control</span>
+        <span class=n>controls</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>sub_control</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>sub_control</span><span class=o>.</span><span class=n>id</span> <span class=ow>in</span> <span class=n>needed_ids</span> <span class=ow>and</span> <span class=n>sub_control</span><span class=o>.</span><span class=n>id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>exclude_ids</span><span class=p>:</span>
+                <span class=n>controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_prune_control</span><span class=p>(</span><span class=n>needed_ids</span><span class=p>,</span> <span class=n>sub_control</span><span class=p>,</span> <span class=n>exclude_ids</span><span class=p>))</span>
+                <span class=n>exclude_ids</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sub_control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=n>control</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>controls</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>control</span>
+
+    <span class=k>def</span> <span class=nf>_prune_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>needed_ids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+        <span class=n>loaded_ids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>final_ids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>control_id</span> <span class=ow>in</span> <span class=n>needed_ids</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>control_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>loaded_ids</span><span class=p>:</span>
+                <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>msg</span> <span class=o>=</span> <span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;Profile titled &quot;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&quot; references control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> &#39;</span>
+                        <span class=sa>f</span><span class=s1>&#39;but it is not in catalog titled &quot;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+                    <span class=p>)</span>
+                    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+                <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prune_control</span><span class=p>(</span><span class=n>needed_ids</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>loaded_ids</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>replace_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+                <span class=n>loaded_ids</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+                <span class=n>final_ids</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>final_ids</span>
+
+    <span class=k>def</span> <span class=nf>_re_insert_child_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Control</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Re insert this control and its children recursively.&quot;&quot;&quot;</span>
+        <span class=n>new_controls</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>sub_control</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>controls</span><span class=p>):</span>
+            <span class=n>new_control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_re_insert_child_controls</span><span class=p>(</span><span class=n>sub_control</span><span class=p>)</span>
+            <span class=n>new_controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>new_control</span><span class=p>)</span>
+        <span class=n>control</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_controls</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>control</span>
+
+    <span class=k>def</span> <span class=nf>_re_insert_children</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Go through all controls in control dict and load child controls from control dict.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_dict</span><span class=p>():</span>
+            <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_re_insert_child_controls</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_prune_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Prune the controls in the current catalog.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_import</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span>
+
+        <span class=n>needed_ids</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_find_needed_control_ids</span><span class=p>()</span>
+
+        <span class=c1># if a control includes controls - only include those that we know are needed</span>
+        <span class=n>final_control_ids</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prune_controls</span><span class=p>(</span><span class=n>needed_ids</span><span class=p>)</span>
+
+        <span class=bp>self</span><span class=o>.</span><span class=n>_re_insert_children</span><span class=p>()</span>
+
+        <span class=n>cat_controls</span> <span class=o>=</span> <span class=p>[]</span>
+
+        <span class=c1># build the needed groups of controls</span>
+        <span class=n>group_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>control_id</span> <span class=ow>in</span> <span class=n>final_control_ids</span><span class=p>:</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=n>group_id</span><span class=p>,</span> <span class=n>group_title</span><span class=p>,</span> <span class=n>group_class</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_group_info_by_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>group_id</span><span class=p>:</span>
+                <span class=n>cat_controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+                <span class=k>continue</span>
+            <span class=n>group</span> <span class=o>=</span> <span class=n>group_dict</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>group_id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>group</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>group</span> <span class=o>=</span> <span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=n>group_id</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>group_title</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=n>group_class</span><span class=p>,</span> <span class=n>controls</span><span class=o>=</span><span class=p>[</span><span class=n>control</span><span class=p>])</span>
+                <span class=n>group_dict</span><span class=p>[</span><span class=n>group_id</span><span class=p>]</span> <span class=o>=</span> <span class=n>group</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>group_dict</span><span class=p>[</span><span class=n>group_id</span><span class=p>]</span><span class=o>.</span><span class=n>controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+        <span class=n>new_groups</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Group</span><span class=p>]]</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=n>group_dict</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+
+        <span class=c1># should avoid empty lists so set to None if empty</span>
+        <span class=n>new_groups</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_groups</span><span class=p>)</span>
+        <span class=n>cat_controls</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>cat_controls</span><span class=p>)</span>
+        <span class=n>new_params</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>params</span>
+
+        <span class=n>new_cat</span> <span class=o>=</span> <span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>(</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid4</span><span class=p>()),</span>
+            <span class=n>metadata</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=p>,</span>
+            <span class=n>back_matter</span><span class=o>=</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>(),</span>
+            <span class=n>controls</span><span class=o>=</span><span class=n>cat_controls</span><span class=p>,</span>
+            <span class=n>groups</span><span class=o>=</span><span class=n>new_groups</span><span class=p>,</span>
+            <span class=n>params</span><span class=o>=</span><span class=n>new_params</span>
+        <span class=p>)</span>
+
+        <span class=c1># find all referenced uuids - they should be 1:1 with those in backmatter</span>
+        <span class=n>needed_uuid_refs</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>find_uuid_refs</span><span class=p>(</span><span class=n>new_cat</span><span class=p>)</span>
+
+        <span class=c1># prune the list of resources to only those that are needed</span>
+        <span class=n>new_resources</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Resource</span><span class=p>]]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>back_matter</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>back_matter</span><span class=o>.</span><span class=n>resources</span><span class=p>:</span>
+            <span class=n>new_resources</span> <span class=o>=</span> <span class=p>[</span><span class=n>res</span> <span class=k>for</span> <span class=n>res</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>back_matter</span><span class=o>.</span><span class=n>resources</span> <span class=k>if</span> <span class=n>res</span><span class=o>.</span><span class=n>uuid</span> <span class=ow>in</span> <span class=n>needed_uuid_refs</span><span class=p>]</span>
+        <span class=n>new_resources</span> <span class=o>=</span> <span class=n>none_if_empty</span><span class=p>(</span><span class=n>new_resources</span><span class=p>)</span>
+        <span class=n>new_cat</span><span class=o>.</span><span class=n>back_matter</span><span class=o>.</span><span class=n>resources</span> <span class=o>=</span> <span class=n>new_resources</span>
+
+        <span class=k>return</span> <span class=n>new_cat</span>
+
+    <span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_iter</span><span class=p>:</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]:</span>  <span class=c1># type: ignore</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Prune the catalog based on the include rule in the import_.</span>
+
+<span class=sd>        This only processes the one catalog yielded by the one import in this pipeline.</span>
+<span class=sd>        It must yield in order to have the merge filter loop over available imported catalogs.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_set_catalog</span><span class=p>(</span><span class=nb>next</span><span class=p>(</span><span class=n>catalog_iter</span><span class=p>))</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;prune yielding catalog </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> with import </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_import</span><span class=o>.</span><span class=n>href</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>yield</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prune_catalog</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.resolver.prune.Prune-functions>Functions<a href=#trestle.core.resolver.prune.Prune-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.resolver.prune.Prune.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>import_</span><span class=p>,</span> <span class=n>profile</span><span class=p>)</span></code> <a href=#trestle.core.resolver.prune.Prune.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Inject the import.</p> <p>This needs to be created prior to knowing the catalog. The profile itself is only needed for debug messages. The import is one possibly several imports in that profile.</p> <details class=quote> <summary>Source code in <code>trestle/core/resolver/prune.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>import_</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Import</span><span class=p>,</span> <span class=n>profile</span><span class=p>:</span> <span class=n>prof</span><span class=o>.</span><span class=n>Profile</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Inject the import.</span>
+
+<span class=sd>    This needs to be created prior to knowing the catalog.</span>
+<span class=sd>    The profile itself is only needed for debug messages.</span>
+<span class=sd>    The import is one possibly several imports in that profile.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_import</span> <span class=o>=</span> <span class=n>import_</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span> <span class=o>=</span> <span class=n>profile</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CatalogInterface</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.resolver.prune.Prune.process class="doc doc-heading"> <code class="highlight language-python"><span class=n>process</span><span class=p>(</span><span class=n>catalog_iter</span><span class=p>)</span></code> <a href=#trestle.core.resolver.prune.Prune.process class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Prune the catalog based on the include rule in the import_.</p> <p>This only processes the one catalog yielded by the one import in this pipeline. It must yield in order to have the merge filter loop over available imported catalogs.</p> <details class=quote> <summary>Source code in <code>trestle/core/resolver/prune.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>process</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_iter</span><span class=p>:</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>cat</span><span class=o>.</span><span class=n>Catalog</span><span class=p>]:</span>  <span class=c1># type: ignore</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Prune the catalog based on the include rule in the import_.</span>
+
+<span class=sd>    This only processes the one catalog yielded by the one import in this pipeline.</span>
+<span class=sd>    It must yield in order to have the merge filter loop over available imported catalogs.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_set_catalog</span><span class=p>(</span><span class=nb>next</span><span class=p>(</span><span class=n>catalog_iter</span><span class=p>))</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;prune yielding catalog </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_catalog</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> with import </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_import</span><span class=o>.</span><span class=n>href</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>yield</span> <span class=bp>self</span><span class=o>.</span><span class=n>_prune_catalog</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.resolver.prune-functions>Functions<a href=#trestle.core.resolver.prune-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/rule_parameters_validator/index.html b/latest/reference/API/trestle/core/rule_parameters_validator/index.html
new file mode 100644
index 000000000..f454b3366
--- /dev/null
+++ b/latest/reference/API/trestle/core/rule_parameters_validator/index.html
@@ -0,0 +1,264 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.rule_parameters_validator module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/rule_parameters_validator/ rel=canonical><link href=../repository/ rel=prev><link href=../ssp_io/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.rule_parameters_validator - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.rule_parameters_validator - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.rule_parameters_validator module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/rule_parameters_validator.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/rule_parameters_validator/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.rule_parameters_validator - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.rule_parameters_validator module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/rule_parameters_validator.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.rule_parameters_validator class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator class=md-nav__link> <span class=md-ellipsis> rule_parameters_validator </span> </a> <nav class=md-nav aria-label=rule_parameters_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator class=md-nav__link> <span class=md-ellipsis> RuleParametersValidator </span> </a> <nav class=md-nav aria-label=RuleParametersValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator class=md-nav__link> <span class=md-ellipsis> rule_parameters_validator </span> </a> <nav class=md-nav aria-label=rule_parameters_validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator class=md-nav__link> <span class=md-ellipsis> RuleParametersValidator </span> </a> <nav class=md-nav aria-label=RuleParametersValidator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.rule_parameters_validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.rule_parameters_validator</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.rule_parameters_validator class="doc doc-heading"> <code>trestle.core.rule_parameters_validator</code> <a href=#trestle.core.rule_parameters_validator class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Validate by confirming rule parameter values are consistent.</p> <div class="doc doc-children"> <h3 id=trestle.core.rule_parameters_validator-attributes>Attributes<a href=#trestle.core.rule_parameters_validator-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.rule_parameters_validator.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.rule_parameters_validator.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.rule_parameters_validator-classes>Classes<a href=#trestle.core.rule_parameters_validator-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.rule_parameters_validator.RuleParametersValidator class="doc doc-heading"> <code>RuleParametersValidator</code> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.validator.Validator href=../validator/#trestle.core.validator.Validator>Validator</a></code></p> <p>Validator to confirm all rule parameter values are consistent.</p> <details class=quote> <summary>Source code in <code>trestle/core/rule_parameters_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RuleParametersValidator</span><span class=p>(</span><span class=n>Validator</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validator to confirm all rule parameter values are consistent.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize rule param values dictionary.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_rule_param_values_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=k>def</span> <span class=nf>_add_imp_req_rule_params_to_dict</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>imp_requirement</span><span class=p>:</span> <span class=n>ImplementedRequirement</span><span class=p>,</span>
+        <span class=n>cat_int</span><span class=p>:</span> <span class=n>CatalogInterface</span><span class=p>,</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Iterate all by components in an object and add the rule shared parameter values to list.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            imp_requirement: Current implemented requirement.</span>
+<span class=sd>            cat_int: Instance of catalog interface with controls catalog loaded.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>by_component</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_requirement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+            <span class=c1># adds rule param values present in set parameters for current imp req</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_rule_params</span><span class=p>(</span><span class=n>imp_requirement</span><span class=p>,</span> <span class=n>imp_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>cat_int</span><span class=p>,</span> <span class=n>by_component</span><span class=o>.</span><span class=n>component_uuid</span><span class=p>)</span>
+            <span class=c1># adds rule param values present in set parameters for current by_component in by_components list</span>
+            <span class=c1># in the current implemented requirement</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_rule_params</span><span class=p>(</span><span class=n>by_component</span><span class=p>,</span> <span class=n>imp_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>cat_int</span><span class=p>,</span> <span class=n>by_component</span><span class=o>.</span><span class=n>component_uuid</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>imp_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=c1># iterates by each by component inclded at each statemtent set for current imp req</span>
+                <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>
+                    <span class=c1># adds rule param values present in set parameters for current by_component in by_components list</span>
+                    <span class=c1># of current statement in current implemented requirement</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_add_rule_params</span><span class=p>(</span><span class=n>by_comp</span><span class=p>,</span> <span class=n>imp_requirement</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>cat_int</span><span class=p>,</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_rule_params</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>item</span><span class=p>:</span> <span class=n>TypeWithSetParams</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>cat_int</span><span class=p>:</span> <span class=n>CatalogInterface</span><span class=p>,</span> <span class=n>comp_uuid</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Add a rule shared parameter to the rule shared parameters list.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            item: Generic item to iterate over parameters.</span>
+<span class=sd>            control_id: Current control id.</span>
+<span class=sd>            cat_int: Instance of catalog interface with controls catalog loaded.</span>
+<span class=sd>            comp_uuid: Component uuid to save.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>set_param</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>item</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+            <span class=c1># validates if current param_id is or not associated with a control so we can assume it´s a rule param</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=n>cat_int</span><span class=o>.</span><span class=n>get_control_by_param_id</span><span class=p>(</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>control</span><span class=p>:</span>
+                <span class=n>deep_set</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_rule_param_values_dict</span><span class=p>,</span> <span class=p>[</span><span class=n>set_param</span><span class=o>.</span><span class=n>param_id</span><span class=p>,</span> <span class=n>comp_uuid</span><span class=p>,</span> <span class=n>control_id</span><span class=p>],</span> <span class=n>set_param</span><span class=o>.</span><span class=n>values</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Test if the model is valid.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            model: A top level OSCAL model.</span>
+<span class=sd>            quiet: Don&#39;t report msgs unless invalid.</span>
+<span class=sd>            trestle_root: Trestle root path.</span>
+
+<span class=sd>        returns:</span>
+<span class=sd>            True (valid) if the model&#39;s rule parameter values are the same across controls.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=c1># verify if model type is either an SSP of a Component Definition</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>SystemSecurityPlan</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>model</span><span class=o>.</span><span class=n>import_profile</span><span class=o>.</span><span class=n>href</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: Model </span><span class=si>{</span><span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> has no referenced profile&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=n>profile_catalog</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model</span><span class=o>.</span><span class=n>import_profile</span><span class=o>.</span><span class=n>href</span><span class=p>)</span>
+        <span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>profile_catalog</span><span class=p>)</span>
+        <span class=c1># iterate by each implemented requirement defined</span>
+        <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>model</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+            <span class=c1># adds rule param values to dict by implemented requirement basis</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_imp_req_rule_params_to_dict</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_param_values_dict</span><span class=p>:</span>
+            <span class=c1># compare all values in shared paramerets by component basis</span>
+            <span class=k>for</span> <span class=n>shared_param</span><span class=p>,</span> <span class=n>values_dict</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_param_values_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>value_dict</span> <span class=ow>in</span> <span class=n>values_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=n>expected_value</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=nb>iter</span><span class=p>(</span><span class=n>value_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+                    <span class=k>if</span> <span class=ow>not</span> <span class=nb>all</span><span class=p>(</span><span class=n>value</span> <span class=o>==</span> <span class=n>expected_value</span> <span class=k>for</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>value_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()):</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span>
+                            <span class=sa>f</span><span class=s1>&#39;Rule parameter values for param: </span><span class=si>{</span><span class=n>shared_param</span><span class=si>}</span><span class=s1> in &#39;</span>
+                            <span class=sa>f</span><span class=s1>&#39; </span><span class=si>{</span><span class=n>comp_name</span><span class=si>}</span><span class=s1> are not consistent with &#39;</span>
+                            <span class=s1>&#39;other values provided across controls. Invalid model&#39;</span>
+                        <span class=p>)</span>
+                        <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.rule_parameters_validator.RuleParametersValidator-functions>Functions<a href=#trestle.core.rule_parameters_validator.RuleParametersValidator-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.rule_parameters_validator.RuleParametersValidator.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize rule param values dictionary.</p> <details class=quote> <summary>Source code in <code>trestle/core/rule_parameters_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize rule param values dictionary.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_rule_param_values_dict</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.rule_parameters_validator.RuleParametersValidator.model_is_valid class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.core.rule_parameters_validator.RuleParametersValidator.model_is_valid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Test if the model is valid.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.common_types.TopLevelOscalModel href=../../common/common_types/#trestle.common.common_types.TopLevelOscalModel>TopLevelOscalModel</a></code> </td> <td> <div class=doc-md-description> <p>A top level OSCAL model.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>quiet</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Don't report msgs unless invalid.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>trestle_root</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=pathlib.Path>Path</span>]</code> </td> <td> <div class=doc-md-description> <p>Trestle root path.</p> </div> </td> <td> <code>None</code> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>True (valid) if the model's rule parameter values are the same across controls.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/rule_parameters_validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Test if the model is valid.</span>
+
+<span class=sd>    args:</span>
+<span class=sd>        model: A top level OSCAL model.</span>
+<span class=sd>        quiet: Don&#39;t report msgs unless invalid.</span>
+<span class=sd>        trestle_root: Trestle root path.</span>
+
+<span class=sd>    returns:</span>
+<span class=sd>        True (valid) if the model&#39;s rule parameter values are the same across controls.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=c1># verify if model type is either an SSP of a Component Definition</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>SystemSecurityPlan</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>model</span><span class=o>.</span><span class=n>import_profile</span><span class=o>.</span><span class=n>href</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: Model </span><span class=si>{</span><span class=n>model</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=si>}</span><span class=s1> has no referenced profile&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=n>profile_catalog</span> <span class=o>=</span> <span class=n>ProfileResolver</span><span class=p>()</span><span class=o>.</span><span class=n>get_resolved_profile_catalog</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>,</span> <span class=n>model</span><span class=o>.</span><span class=n>import_profile</span><span class=o>.</span><span class=n>href</span><span class=p>)</span>
+    <span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>profile_catalog</span><span class=p>)</span>
+    <span class=c1># iterate by each implemented requirement defined</span>
+    <span class=k>for</span> <span class=n>imp_req</span> <span class=ow>in</span> <span class=n>model</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+        <span class=c1># adds rule param values to dict by implemented requirement basis</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_imp_req_rule_params_to_dict</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>catalog_interface</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_param_values_dict</span><span class=p>:</span>
+        <span class=c1># compare all values in shared paramerets by component basis</span>
+        <span class=k>for</span> <span class=n>shared_param</span><span class=p>,</span> <span class=n>values_dict</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_param_values_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>value_dict</span> <span class=ow>in</span> <span class=n>values_dict</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=n>expected_value</span> <span class=o>=</span> <span class=nb>next</span><span class=p>(</span><span class=nb>iter</span><span class=p>(</span><span class=n>value_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=nb>all</span><span class=p>(</span><span class=n>value</span> <span class=o>==</span> <span class=n>expected_value</span> <span class=k>for</span> <span class=n>value</span> <span class=ow>in</span> <span class=n>value_dict</span><span class=o>.</span><span class=n>values</span><span class=p>()):</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;Rule parameter values for param: </span><span class=si>{</span><span class=n>shared_param</span><span class=si>}</span><span class=s1> in &#39;</span>
+                        <span class=sa>f</span><span class=s1>&#39; </span><span class=si>{</span><span class=n>comp_name</span><span class=si>}</span><span class=s1> are not consistent with &#39;</span>
+                        <span class=s1>&#39;other values provided across controls. Invalid model&#39;</span>
+                    <span class=p>)</span>
+                    <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.rule_parameters_validator-functions>Functions<a href=#trestle.core.rule_parameters_validator-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/ssp_io/index.html b/latest/reference/API/trestle/core/ssp_io/index.html
new file mode 100644
index 000000000..52625bee5
--- /dev/null
+++ b/latest/reference/API/trestle/core/ssp_io/index.html
@@ -0,0 +1,1170 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.ssp_io module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/ssp_io/ rel=canonical><link href=../rule_parameters_validator/ rel=prev><link href=../trestle_base_model/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.ssp_io - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.ssp_io - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.ssp_io module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/ssp_io.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/ssp_io/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.ssp_io - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.ssp_io module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/ssp_io.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.ssp_io class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.ssp_io </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.ssp_io </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.ssp_io class=md-nav__link> <span class=md-ellipsis> ssp_io </span> </a> <nav class=md-nav aria-label=ssp_io> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter class=md-nav__link> <span class=md-ellipsis> SSPMarkdownWriter </span> </a> <nav class=md-nav aria-label=SSPMarkdownWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_control_part class=md-nav__link> <span class=md-ellipsis> get_control_part </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_control_response class=md-nav__link> <span class=md-ellipsis> get_control_response </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_control_statement class=md-nav__link> <span class=md-ellipsis> get_control_statement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_origination class=md-nav__link> <span class=md-ellipsis> get_fedramp_control_origination </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_tables class=md-nav__link> <span class=md-ellipsis> get_fedramp_control_tables </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_implementation_status class=md-nav__link> <span class=md-ellipsis> get_fedramp_implementation_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_responsible_roles_table class=md-nav__link> <span class=md-ellipsis> get_responsible_roles_table </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.set_catalog class=md-nav__link> <span class=md-ellipsis> set_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.set_ssp class=md-nav__link> <span class=md-ellipsis> set_ssp </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.ssp_io class=md-nav__link> <span class=md-ellipsis> ssp_io </span> </a> <nav class=md-nav aria-label=ssp_io> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter class=md-nav__link> <span class=md-ellipsis> SSPMarkdownWriter </span> </a> <nav class=md-nav aria-label=SSPMarkdownWriter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_control_part class=md-nav__link> <span class=md-ellipsis> get_control_part </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_control_response class=md-nav__link> <span class=md-ellipsis> get_control_response </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_control_statement class=md-nav__link> <span class=md-ellipsis> get_control_statement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_origination class=md-nav__link> <span class=md-ellipsis> get_fedramp_control_origination </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_tables class=md-nav__link> <span class=md-ellipsis> get_fedramp_control_tables </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_implementation_status class=md-nav__link> <span class=md-ellipsis> get_fedramp_implementation_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_responsible_roles_table class=md-nav__link> <span class=md-ellipsis> get_responsible_roles_table </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.set_catalog class=md-nav__link> <span class=md-ellipsis> set_catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.set_ssp class=md-nav__link> <span class=md-ellipsis> set_ssp </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.ssp_io-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.ssp_io</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.ssp_io class="doc doc-heading"> <code>trestle.core.ssp_io</code> <a href=#trestle.core.ssp_io class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Handle direct IO for writing SSP responses as markdown.</p> <div class="doc doc-children"> <h3 id=trestle.core.ssp_io-attributes>Attributes<a href=#trestle.core.ssp_io-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.ssp_io.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.ssp_io.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.ssp_io-classes>Classes<a href=#trestle.core.ssp_io-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.ssp_io.SSPMarkdownWriter class="doc doc-heading"> <code>SSPMarkdownWriter</code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Class to write control responses as markdown.</p> <p>Functions in this class are mainly used by jinja and not by the trestle code itself.</p> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SSPMarkdownWriter</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Class to write control responses as markdown.</span>
+
+<span class=sd>    Functions in this class are mainly used by jinja and not by the trestle code itself.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_root</span> <span class=o>=</span> <span class=n>trestle_root</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span> <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span><span class=p>:</span> <span class=n>Catalog</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>:</span> <span class=n>CatalogInterface</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>set_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set ssp.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span> <span class=o>=</span> <span class=n>ssp</span>
+
+    <span class=k>def</span> <span class=nf>set_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>resolved_catalog</span><span class=p>:</span> <span class=n>Catalog</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set catalog.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span> <span class=o>=</span> <span class=n>resolved_catalog</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>CatalogInterface</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_control_statement</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get the control statement for an ssp - to be printed in markdown as a structured list.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            control_id: The control_id to use.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            A markdown blob as a string.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get control statement, set resolved catalog first.&#39;</span><span class=p>)</span>
+
+        <span class=n>writer</span> <span class=o>=</span> <span class=n>DocsControlWriter</span><span class=p>()</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>control</span><span class=p>:</span>
+            <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+        <span class=n>control_lines</span> <span class=o>=</span> <span class=n>writer</span><span class=o>.</span><span class=n>get_control_statement_ssp</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_tree_and_adjust</span><span class=p>(</span><span class=n>control_lines</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_control_part</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>part_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get control part with given name.&quot;&quot;&quot;</span>
+        <span class=n>control_part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_part_prose</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>part_name</span><span class=p>)</span>
+
+        <span class=n>md_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_write_str_with_header</span><span class=p>(</span>
+            <span class=sa>f</span><span class=s1>&#39;Control Part: </span><span class=si>{</span><span class=n>part_name</span><span class=si>}</span><span class=s1> for control: </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=n>control_part</span><span class=p>,</span> <span class=n>level</span>
+        <span class=p>)</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_tree_and_adjust</span><span class=p>(</span><span class=n>md_list</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>),</span> <span class=n>level</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_fedramp_control_tables</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>label_column</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the fedramp metadata as markdown tables, with optional third label column for params.</span>
+
+<span class=sd>        The fedramp metadata has the following elements:</span>
+<span class=sd>        - Responsible roles field</span>
+<span class=sd>        - Parameter values table</span>
+<span class=sd>        - Implementation status field</span>
+<span class=sd>        - Control origination field</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            tables as one coherent markdown blob.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>resp_roles_table</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_responsible_roles_table</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+        <span class=n>params_values</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_parameter_table</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>,</span> <span class=n>label_column</span><span class=p>)</span>
+        <span class=n>impl_status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_fedramp_implementation_status</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+        <span class=n>control_orig</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_fedramp_control_origination</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+
+        <span class=n>final_output</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>if</span> <span class=n>resp_roles_table</span><span class=p>:</span>
+            <span class=n>final_output</span> <span class=o>+=</span> <span class=n>resp_roles_table</span>
+        <span class=k>if</span> <span class=n>params_values</span><span class=p>:</span>
+            <span class=n>final_output</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span> <span class=o>+</span> <span class=n>params_values</span>
+        <span class=k>if</span> <span class=n>impl_status</span><span class=p>:</span>
+            <span class=n>final_output</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span> <span class=o>+</span> <span class=n>impl_status</span>
+        <span class=k>if</span> <span class=n>control_orig</span><span class=p>:</span>
+            <span class=n>final_output</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span> <span class=o>+</span> <span class=n>control_orig</span>
+        <span class=k>return</span> <span class=n>final_output</span>
+
+    <span class=k>def</span> <span class=nf>get_responsible_roles_table</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        For each role id - if the role exists in metadata use the title as what gets printed in the roles table.</span>
+
+<span class=sd>        If not (for now) warn and use the role-id as the printed text.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get responsible roles, SSP is not set.&#39;</span><span class=p>)</span>
+
+        <span class=k>for</span> <span class=n>impl_requirement</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>impl_requirement</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>impl_requirement</span><span class=o>.</span><span class=n>responsible_roles</span><span class=p>:</span>
+                    <span class=n>resp_roles</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>impl_requirement</span><span class=o>.</span><span class=n>responsible_roles</span><span class=p>)</span>
+                    <span class=n>role_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>role</span><span class=o>.</span><span class=n>role_id</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;_&#39;</span><span class=p>,</span> <span class=s1>&#39; &#39;</span><span class=p>)</span> <span class=k>for</span> <span class=n>role</span> <span class=ow>in</span> <span class=n>resp_roles</span><span class=p>]</span>
+
+                    <span class=c1># now check if this role exists in the metadata</span>
+                    <span class=n>role_titles</span> <span class=o>=</span> <span class=nb>dict</span><span class=p>(</span><span class=nb>zip</span><span class=p>(</span><span class=n>role_ids</span><span class=p>,</span> <span class=n>role_ids</span><span class=p>))</span>
+                    <span class=n>roles</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>roles</span><span class=p>)</span>
+                    <span class=k>for</span> <span class=n>role</span> <span class=ow>in</span> <span class=n>roles</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>role</span><span class=o>.</span><span class=n>id</span> <span class=ow>in</span> <span class=n>role_ids</span><span class=p>:</span>
+                            <span class=n>role_titles</span><span class=p>[</span><span class=n>role</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>role</span><span class=o>.</span><span class=n>title</span>
+
+                    <span class=c1># dictionary to md table</span>
+                    <span class=n>md_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_write_table_with_header</span><span class=p>(</span>
+                        <span class=s1>&#39;Responsible Roles.&#39;</span><span class=p>,</span> <span class=p>[[</span><span class=n>key</span><span class=p>,</span> <span class=n>role_titles</span><span class=p>[</span><span class=n>key</span><span class=p>]]</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>role_titles</span><span class=o>.</span><span class=n>keys</span><span class=p>()],</span>
+                        <span class=p>[</span><span class=s1>&#39;Role ID&#39;</span><span class=p>,</span> <span class=s1>&#39;Title&#39;</span><span class=p>],</span>
+                        <span class=n>level</span>
+                    <span class=p>)</span>
+                    <span class=k>return</span> <span class=n>md_list</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;No responsible roles were found for the control with id: </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> in given SSP.&#39;</span>
+                    <span class=p>)</span>
+                    <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_parameter_table</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>label_column</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print Param_id | ValueOrLabelOrChoices | Optional Label Column.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get parameter table, set SSP first.&#39;</span><span class=p>)</span>
+
+        <span class=n>writer</span> <span class=o>=</span> <span class=n>DocsControlWriter</span><span class=p>()</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>control</span><span class=p>:</span>
+            <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>params_lines</span> <span class=o>=</span> <span class=n>writer</span><span class=o>.</span><span class=n>get_param_table</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>label_column</span><span class=p>)</span>
+        <span class=c1># need to make sure no params still have moustaches.  convert to brackets to avoid jinja complaints</span>
+        <span class=n>clean_lines</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>params_lines</span><span class=p>:</span>
+            <span class=n>clean_lines</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>line</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;{{&#39;</span><span class=p>,</span> <span class=s1>&#39;[[&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;}}&#39;</span><span class=p>,</span> <span class=s1>&#39;]]&#39;</span><span class=p>))</span>
+
+        <span class=n>tree</span> <span class=o>=</span> <span class=n>DocsMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>clean_lines</span><span class=p>)</span>
+        <span class=n>tree</span><span class=o>.</span><span class=n>change_header_level_by</span><span class=p>(</span><span class=n>level</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>tree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span>
+
+    <span class=k>def</span> <span class=nf>get_fedramp_implementation_status</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Print implementation status as a list of items, only showing those that are applicable for the control.</span>
+
+<span class=sd>        This is unlike the word document FedRAMP which uses checkboxes on standard set of options.</span>
+<span class=sd>        Using a LUT to map between structured data fields, defined by FedRAMP and historical text.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get Fedramp implementation status, set SSP first.&#39;</span><span class=p>)</span>
+
+        <span class=n>implementation_statuses</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>control_impl_req</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_implemented_req</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>control_impl_req</span> <span class=ow>and</span> <span class=n>control_impl_req</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>control_impl_req</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>IMPLEMENTATION_STATUS</span><span class=p>:</span>
+                    <span class=n>implementation_statuses</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+
+        <span class=n>md_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_write_list_with_header</span><span class=p>(</span><span class=s1>&#39;FedRamp Implementation Status.&#39;</span><span class=p>,</span> <span class=n>implementation_statuses</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>md_list</span>
+
+    <span class=k>def</span> <span class=nf>get_fedramp_control_origination</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Print control origination, as a list of items, only showing those that are applicable for the control.</span>
+
+<span class=sd>        Using a LUT to map between structured data fields, defined by FedRAMP and historical text.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get FedRamp control origination, set SSP first.&#39;</span><span class=p>)</span>
+
+        <span class=n>control_origination</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>control_impl_req</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_implemented_req</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>control_impl_req</span> <span class=ow>and</span> <span class=n>control_impl_req</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>control_impl_req</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>CONTROL_ORIGINATION</span><span class=p>:</span>
+                    <span class=n>control_origination</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+
+        <span class=n>md_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_write_list_with_header</span><span class=p>(</span><span class=s1>&#39;FedRamp Control Origination.&#39;</span><span class=p>,</span> <span class=n>control_origination</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>md_list</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>_write_component_prompt</span><span class=p>(</span>
+        <span class=n>md_writer</span><span class=p>:</span> <span class=n>MDWriter</span><span class=p>,</span>
+        <span class=n>comp_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>prose</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span>
+        <span class=n>status</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>show_rules</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span>
+        <span class=n>show_status</span><span class=p>:</span> <span class=nb>bool</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>header</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Component: </span><span class=si>{</span><span class=n>comp_name</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=n>md_writer</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=n>header</span><span class=p>)</span>
+        <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+        <span class=n>md_writer</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>prose</span><span class=p>)</span>
+        <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>rules</span> <span class=ow>and</span> <span class=n>show_rules</span><span class=p>:</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Rules:&#39;</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_list</span><span class=p>(</span><span class=n>rules</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>status</span> <span class=ow>and</span> <span class=n>show_status</span><span class=p>:</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=mi>2</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;Implementation Status: </span><span class=si>{</span><span class=n>status</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_control_response</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+        <span class=n>write_empty_responses</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>show_comp</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+        <span class=n>show_rules</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>show_status</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Get the full control implemented requirements, broken down based on the available control responses.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            control_id: id of the control</span>
+<span class=sd>            level: level of indentation</span>
+<span class=sd>            write_empty_responses: write response even if empty</span>
+<span class=sd>            show_comp: show the component name in the response</span>
+
+<span class=sd>        Notes:</span>
+<span class=sd>            This is intended to be invoked from a jinja template that has already written out the prompt for</span>
+<span class=sd>            control response</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get control response, set resolved catalog first.&#39;</span><span class=p>)</span>
+
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=n>imp_req</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_implemented_req</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>imp_req</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No implemented requirements found for the control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+        <span class=n>md_writer</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+
+        <span class=n>system_prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>system_rules</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>system_status</span> <span class=o>=</span> <span class=n>STATUS_OPERATIONAL</span>
+        <span class=n>imp_req_responses</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_responses_by_components</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>write_empty_responses</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>SSP_MAIN_COMP_NAME</span> <span class=ow>in</span> <span class=n>imp_req_responses</span><span class=p>:</span>
+            <span class=n>system_prose</span><span class=p>,</span> <span class=n>system_rules</span><span class=p>,</span> <span class=n>system_status</span> <span class=o>=</span> <span class=n>imp_req_responses</span><span class=p>[</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>]</span>
+
+        <span class=n>SSPMarkdownWriter</span><span class=o>.</span><span class=n>_write_component_prompt</span><span class=p>(</span>
+            <span class=n>md_writer</span><span class=p>,</span> <span class=n>SSP_MAIN_COMP_NAME</span><span class=p>,</span> <span class=n>system_prose</span><span class=p>,</span> <span class=n>system_rules</span><span class=p>,</span> <span class=n>system_status</span><span class=p>,</span> <span class=n>show_rules</span><span class=p>,</span> <span class=n>show_status</span>
+        <span class=p>)</span>
+
+        <span class=c1># if a control has no statement sub-parts then get the response bycomps from the imp_req itself</span>
+        <span class=c1># otherwise get them from the statements in the imp_req</span>
+        <span class=c1># an imp_req and a statement are both things that can have bycomps</span>
+        <span class=n>has_bycomps</span> <span class=o>=</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=k>else</span> <span class=p>[</span><span class=n>imp_req</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>has_bycomp</span> <span class=ow>in</span> <span class=n>has_bycomps</span><span class=p>:</span>
+            <span class=n>statement_id</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>has_bycomp</span><span class=p>,</span> <span class=s1>&#39;statement_id&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>_smt&#39;</span><span class=p>)</span>
+            <span class=n>label</span> <span class=o>=</span> <span class=n>statement_id</span>
+            <span class=n>part_name</span> <span class=o>=</span> <span class=kc>None</span>
+
+            <span class=c1># look up label for this statement</span>
+            <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=n>found_label</span><span class=p>,</span> <span class=n>part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_statement_label_if_exists</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>found_label</span><span class=p>:</span>
+                    <span class=n>label</span> <span class=o>=</span> <span class=n>found_label</span>
+                    <span class=n>part_name</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span>
+
+            <span class=n>response_per_component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_responses_by_components</span><span class=p>(</span><span class=n>has_bycomp</span><span class=p>,</span> <span class=n>write_empty_responses</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>response_per_component</span> <span class=ow>or</span> <span class=n>write_empty_responses</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>part_name</span> <span class=ow>and</span> <span class=n>part_name</span> <span class=o>==</span> <span class=n>ITEM</span><span class=p>:</span>
+                    <span class=c1># print part header only if subitem</span>
+                    <span class=n>header</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Implementation for part </span><span class=si>{</span><span class=n>label</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=n>md_writer</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>header</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>comp_response</span> <span class=ow>in</span> <span class=n>response_per_component</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                    <span class=k>if</span> <span class=n>comp_name</span> <span class=o>==</span> <span class=n>SSP_MAIN_COMP_NAME</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=n>prose</span><span class=p>,</span> <span class=n>rules</span><span class=p>,</span> <span class=n>status</span> <span class=o>=</span> <span class=n>comp_response</span>
+                    <span class=k>if</span> <span class=n>show_comp</span><span class=p>:</span>
+                        <span class=n>SSPMarkdownWriter</span><span class=o>.</span><span class=n>_write_component_prompt</span><span class=p>(</span>
+                            <span class=n>md_writer</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>prose</span><span class=p>,</span> <span class=n>rules</span><span class=p>,</span> <span class=n>status</span><span class=p>,</span> <span class=n>show_rules</span><span class=p>,</span> <span class=n>show_status</span>
+                        <span class=p>)</span>
+
+        <span class=n>lines</span> <span class=o>=</span> <span class=n>md_writer</span><span class=o>.</span><span class=n>get_lines</span><span class=p>()</span>
+
+        <span class=n>tree</span> <span class=o>=</span> <span class=n>DocsMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+        <span class=n>tree</span><span class=o>.</span><span class=n>change_header_level_by</span><span class=p>(</span><span class=n>level</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>tree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span>
+
+    <span class=k>def</span> <span class=nf>_get_responses_by_components</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>has_bycomps</span><span class=p>:</span> <span class=n>TypeWithByComps</span><span class=p>,</span>
+                                     <span class=n>write_empty_responses</span><span class=p>:</span> <span class=nb>bool</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get response per component, substitute component id with title if possible.&quot;&quot;&quot;</span>
+        <span class=n>response_per_component</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>by_comp</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>has_bycomps</span><span class=o>.</span><span class=n>by_components</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+            <span class=c1># look up component title</span>
+            <span class=n>subheader</span> <span class=o>=</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span>
+            <span class=n>prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=n>rules</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>comp</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>system_implementation</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>comp</span><span class=o>.</span><span class=n>uuid</span> <span class=o>==</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>component_uuid</span><span class=p>:</span>
+                        <span class=n>title</span> <span class=o>=</span> <span class=n>comp</span><span class=o>.</span><span class=n>title</span>
+                        <span class=k>if</span> <span class=n>title</span><span class=p>:</span>
+                            <span class=n>subheader</span> <span class=o>=</span> <span class=n>title</span>
+            <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>description</span><span class=p>:</span>
+                <span class=n>prose</span> <span class=o>=</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>description</span>
+            <span class=k>if</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=n>by_comp</span><span class=o>.</span><span class=n>implementation_status</span><span class=o>.</span><span class=n>state</span>
+            <span class=n>rules</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=n>ControlInterface</span><span class=o>.</span><span class=n>get_rule_list_for_item</span><span class=p>(</span><span class=n>by_comp</span><span class=p>)</span>
+
+            <span class=k>if</span> <span class=n>prose</span> <span class=ow>or</span> <span class=p>(</span><span class=ow>not</span> <span class=n>prose</span> <span class=ow>and</span> <span class=n>write_empty_responses</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>subheader</span><span class=p>:</span>
+                    <span class=n>response_per_component</span><span class=p>[</span><span class=n>subheader</span><span class=p>]</span> <span class=o>=</span> <span class=p>(</span><span class=n>prose</span><span class=p>,</span> <span class=n>rules</span><span class=p>,</span> <span class=n>status</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>response_per_component</span>
+
+    <span class=k>def</span> <span class=nf>_control_implemented_req</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ssp</span><span class=o>.</span><span class=n>ImplementedRequirement</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Retrieve control implemented requirement by control-id.&quot;&quot;&quot;</span>
+        <span class=n>requirements</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span>
+        <span class=k>for</span> <span class=n>requirement</span> <span class=ow>in</span> <span class=n>requirements</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>requirement</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>requirement</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No implemented requirement found for control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_write_list_with_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>lines</span><span class=p>:</span>
+            <span class=n>md_writer</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>header</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_list</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_tree_and_adjust</span><span class=p>(</span><span class=n>md_writer</span><span class=o>.</span><span class=n>get_lines</span><span class=p>(),</span> <span class=n>level</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_write_table_with_header</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>values</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]],</span> <span class=n>table_header</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>values</span> <span class=ow>and</span> <span class=n>values</span><span class=p>[</span><span class=mi>0</span><span class=p>]:</span>
+            <span class=n>md_writer</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>header</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_table</span><span class=p>(</span><span class=n>values</span><span class=p>,</span> <span class=n>table_header</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_tree_and_adjust</span><span class=p>(</span><span class=n>md_writer</span><span class=o>.</span><span class=n>get_lines</span><span class=p>(),</span> <span class=n>level</span><span class=p>)</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_write_str_with_header</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>header</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>text</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>text</span><span class=p>:</span>
+            <span class=n>md_writer</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_paragraph</span><span class=p>()</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=n>level</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>header</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>new_line</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+            <span class=n>md_writer</span><span class=o>.</span><span class=n>set_indent_level</span><span class=p>(</span><span class=o>-</span><span class=mi>1</span><span class=p>)</span>
+
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_tree_and_adjust</span><span class=p>(</span><span class=n>md_writer</span><span class=o>.</span><span class=n>get_lines</span><span class=p>(),</span> <span class=n>level</span><span class=p>)</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_build_tree_and_adjust</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+        <span class=n>tree</span> <span class=o>=</span> <span class=n>DocsMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+        <span class=n>tree</span><span class=o>.</span><span class=n>change_header_level_by</span><span class=p>(</span><span class=n>level</span><span class=p>)</span>
+
+        <span class=k>return</span> <span class=n>tree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.ssp_io.SSPMarkdownWriter-functions>Functions<a href=#trestle.core.ssp_io.SSPMarkdownWriter-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the class.</p> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the class.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_trestle_root</span> <span class=o>=</span> <span class=n>trestle_root</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span> <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span><span class=p>:</span> <span class=n>Catalog</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=p>:</span> <span class=n>CatalogInterface</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.get_control_part class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_part</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>part_name</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_control_part class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get control part with given name.</p> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_part</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>part_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get control part with given name.&quot;&quot;&quot;</span>
+    <span class=n>control_part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control_part_prose</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>part_name</span><span class=p>)</span>
+
+    <span class=n>md_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_write_str_with_header</span><span class=p>(</span>
+        <span class=sa>f</span><span class=s1>&#39;Control Part: </span><span class=si>{</span><span class=n>part_name</span><span class=si>}</span><span class=s1> for control: </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=n>control_part</span><span class=p>,</span> <span class=n>level</span>
+    <span class=p>)</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_tree_and_adjust</span><span class=p>(</span><span class=n>md_list</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>),</span> <span class=n>level</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.get_control_response class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_response</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>,</span> <span class=n>write_empty_responses</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>show_comp</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>show_rules</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>show_status</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_control_response class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the full control implemented requirements, broken down based on the available control responses.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>control_id</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>id of the control</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>level</code> </td> <td> <code>int</code> </td> <td> <div class=doc-md-description> <p>level of indentation</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>write_empty_responses</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>write response even if empty</p> </div> </td> <td> <code>False</code> </td> </tr> <tr class=doc-section-item> <td> <code>show_comp</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>show the component name in the response</p> </div> </td> <td> <code>True</code> </td> </tr> </tbody> </table> <details class=notes open> <summary>Notes</summary> <p>This is intended to be invoked from a jinja template that has already written out the prompt for control response</p> </details> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_response</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+    <span class=n>write_empty_responses</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>show_comp</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+    <span class=n>show_rules</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>show_status</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get the full control implemented requirements, broken down based on the available control responses.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        control_id: id of the control</span>
+<span class=sd>        level: level of indentation</span>
+<span class=sd>        write_empty_responses: write response even if empty</span>
+<span class=sd>        show_comp: show the component name in the response</span>
+
+<span class=sd>    Notes:</span>
+<span class=sd>        This is intended to be invoked from a jinja template that has already written out the prompt for</span>
+<span class=sd>        control response</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get control response, set resolved catalog first.&#39;</span><span class=p>)</span>
+
+    <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+    <span class=n>imp_req</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_implemented_req</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>imp_req</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;No implemented requirements found for the control </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=n>md_writer</span> <span class=o>=</span> <span class=n>MDWriter</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+
+    <span class=n>system_prose</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>system_rules</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>system_status</span> <span class=o>=</span> <span class=n>STATUS_OPERATIONAL</span>
+    <span class=n>imp_req_responses</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_responses_by_components</span><span class=p>(</span><span class=n>imp_req</span><span class=p>,</span> <span class=n>write_empty_responses</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>SSP_MAIN_COMP_NAME</span> <span class=ow>in</span> <span class=n>imp_req_responses</span><span class=p>:</span>
+        <span class=n>system_prose</span><span class=p>,</span> <span class=n>system_rules</span><span class=p>,</span> <span class=n>system_status</span> <span class=o>=</span> <span class=n>imp_req_responses</span><span class=p>[</span><span class=n>SSP_MAIN_COMP_NAME</span><span class=p>]</span>
+
+    <span class=n>SSPMarkdownWriter</span><span class=o>.</span><span class=n>_write_component_prompt</span><span class=p>(</span>
+        <span class=n>md_writer</span><span class=p>,</span> <span class=n>SSP_MAIN_COMP_NAME</span><span class=p>,</span> <span class=n>system_prose</span><span class=p>,</span> <span class=n>system_rules</span><span class=p>,</span> <span class=n>system_status</span><span class=p>,</span> <span class=n>show_rules</span><span class=p>,</span> <span class=n>show_status</span>
+    <span class=p>)</span>
+
+    <span class=c1># if a control has no statement sub-parts then get the response bycomps from the imp_req itself</span>
+    <span class=c1># otherwise get them from the statements in the imp_req</span>
+    <span class=c1># an imp_req and a statement are both things that can have bycomps</span>
+    <span class=n>has_bycomps</span> <span class=o>=</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=k>if</span> <span class=n>imp_req</span><span class=o>.</span><span class=n>statements</span> <span class=k>else</span> <span class=p>[</span><span class=n>imp_req</span><span class=p>]</span>
+    <span class=k>for</span> <span class=n>has_bycomp</span> <span class=ow>in</span> <span class=n>has_bycomps</span><span class=p>:</span>
+        <span class=n>statement_id</span> <span class=o>=</span> <span class=nb>getattr</span><span class=p>(</span><span class=n>has_bycomp</span><span class=p>,</span> <span class=s1>&#39;statement_id&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>_smt&#39;</span><span class=p>)</span>
+        <span class=n>label</span> <span class=o>=</span> <span class=n>statement_id</span>
+        <span class=n>part_name</span> <span class=o>=</span> <span class=kc>None</span>
+
+        <span class=c1># look up label for this statement</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=n>found_label</span><span class=p>,</span> <span class=n>part</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_statement_label_if_exists</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>statement_id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>found_label</span><span class=p>:</span>
+                <span class=n>label</span> <span class=o>=</span> <span class=n>found_label</span>
+                <span class=n>part_name</span> <span class=o>=</span> <span class=n>part</span><span class=o>.</span><span class=n>name</span>
+
+        <span class=n>response_per_component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_responses_by_components</span><span class=p>(</span><span class=n>has_bycomp</span><span class=p>,</span> <span class=n>write_empty_responses</span><span class=p>)</span>
+
+        <span class=k>if</span> <span class=n>response_per_component</span> <span class=ow>or</span> <span class=n>write_empty_responses</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>part_name</span> <span class=ow>and</span> <span class=n>part_name</span> <span class=o>==</span> <span class=n>ITEM</span><span class=p>:</span>
+                <span class=c1># print part header only if subitem</span>
+                <span class=n>header</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Implementation for part </span><span class=si>{</span><span class=n>label</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=n>md_writer</span><span class=o>.</span><span class=n>new_header</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>header</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>comp_response</span> <span class=ow>in</span> <span class=n>response_per_component</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+                <span class=k>if</span> <span class=n>comp_name</span> <span class=o>==</span> <span class=n>SSP_MAIN_COMP_NAME</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>prose</span><span class=p>,</span> <span class=n>rules</span><span class=p>,</span> <span class=n>status</span> <span class=o>=</span> <span class=n>comp_response</span>
+                <span class=k>if</span> <span class=n>show_comp</span><span class=p>:</span>
+                    <span class=n>SSPMarkdownWriter</span><span class=o>.</span><span class=n>_write_component_prompt</span><span class=p>(</span>
+                        <span class=n>md_writer</span><span class=p>,</span> <span class=n>comp_name</span><span class=p>,</span> <span class=n>prose</span><span class=p>,</span> <span class=n>rules</span><span class=p>,</span> <span class=n>status</span><span class=p>,</span> <span class=n>show_rules</span><span class=p>,</span> <span class=n>show_status</span>
+                    <span class=p>)</span>
+
+    <span class=n>lines</span> <span class=o>=</span> <span class=n>md_writer</span><span class=o>.</span><span class=n>get_lines</span><span class=p>()</span>
+
+    <span class=n>tree</span> <span class=o>=</span> <span class=n>DocsMarkdownNode</span><span class=o>.</span><span class=n>build_tree_from_markdown</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+    <span class=n>tree</span><span class=o>.</span><span class=n>change_header_level_by</span><span class=p>(</span><span class=n>level</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=n>tree</span><span class=o>.</span><span class=n>content</span><span class=o>.</span><span class=n>raw_text</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.get_control_statement class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_control_statement</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_control_statement class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the control statement for an ssp - to be printed in markdown as a structured list.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>control_id</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The control_id to use.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>A markdown blob as a string.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_control_statement</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Get the control statement for an ssp - to be printed in markdown as a structured list.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        control_id: The control_id to use.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        A markdown blob as a string.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get control statement, set resolved catalog first.&#39;</span><span class=p>)</span>
+
+    <span class=n>writer</span> <span class=o>=</span> <span class=n>DocsControlWriter</span><span class=p>()</span>
+    <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span><span class=o>.</span><span class=n>get_control</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>control</span><span class=p>:</span>
+        <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=n>control_lines</span> <span class=o>=</span> <span class=n>writer</span><span class=o>.</span><span class=n>get_control_statement_ssp</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_tree_and_adjust</span><span class=p>(</span><span class=n>control_lines</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_origination class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_fedramp_control_origination</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_origination class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print control origination, as a list of items, only showing those that are applicable for the control.</p> <p>Using a LUT to map between structured data fields, defined by FedRAMP and historical text.</p> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_fedramp_control_origination</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Print control origination, as a list of items, only showing those that are applicable for the control.</span>
+
+<span class=sd>    Using a LUT to map between structured data fields, defined by FedRAMP and historical text.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get FedRamp control origination, set SSP first.&#39;</span><span class=p>)</span>
+
+    <span class=n>control_origination</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>control_impl_req</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_implemented_req</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+
+    <span class=k>if</span> <span class=n>control_impl_req</span> <span class=ow>and</span> <span class=n>control_impl_req</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>control_impl_req</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>CONTROL_ORIGINATION</span><span class=p>:</span>
+                <span class=n>control_origination</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+
+    <span class=n>md_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_write_list_with_header</span><span class=p>(</span><span class=s1>&#39;FedRamp Control Origination.&#39;</span><span class=p>,</span> <span class=n>control_origination</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>md_list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_tables class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_fedramp_control_tables</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>,</span> <span class=n>label_column</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_tables class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the fedramp metadata as markdown tables, with optional third label column for params.</p> <p>The fedramp metadata has the following elements: - Responsible roles field - Parameter values table - Implementation status field - Control origination field</p> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>tables as one coherent markdown blob.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_fedramp_control_tables</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>label_column</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the fedramp metadata as markdown tables, with optional third label column for params.</span>
+
+<span class=sd>    The fedramp metadata has the following elements:</span>
+<span class=sd>    - Responsible roles field</span>
+<span class=sd>    - Parameter values table</span>
+<span class=sd>    - Implementation status field</span>
+<span class=sd>    - Control origination field</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        tables as one coherent markdown blob.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>resp_roles_table</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_responsible_roles_table</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+    <span class=n>params_values</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_parameter_table</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>,</span> <span class=n>label_column</span><span class=p>)</span>
+    <span class=n>impl_status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_fedramp_implementation_status</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+    <span class=n>control_orig</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_fedramp_control_origination</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+
+    <span class=n>final_output</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>if</span> <span class=n>resp_roles_table</span><span class=p>:</span>
+        <span class=n>final_output</span> <span class=o>+=</span> <span class=n>resp_roles_table</span>
+    <span class=k>if</span> <span class=n>params_values</span><span class=p>:</span>
+        <span class=n>final_output</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span> <span class=o>+</span> <span class=n>params_values</span>
+    <span class=k>if</span> <span class=n>impl_status</span><span class=p>:</span>
+        <span class=n>final_output</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span> <span class=o>+</span> <span class=n>impl_status</span>
+    <span class=k>if</span> <span class=n>control_orig</span><span class=p>:</span>
+        <span class=n>final_output</span> <span class=o>+=</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span> <span class=o>+</span> <span class=n>control_orig</span>
+    <span class=k>return</span> <span class=n>final_output</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_implementation_status class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_fedramp_implementation_status</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_implementation_status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print implementation status as a list of items, only showing those that are applicable for the control.</p> <p>This is unlike the word document FedRAMP which uses checkboxes on standard set of options. Using a LUT to map between structured data fields, defined by FedRAMP and historical text.</p> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_fedramp_implementation_status</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Print implementation status as a list of items, only showing those that are applicable for the control.</span>
+
+<span class=sd>    This is unlike the word document FedRAMP which uses checkboxes on standard set of options.</span>
+<span class=sd>    Using a LUT to map between structured data fields, defined by FedRAMP and historical text.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get Fedramp implementation status, set SSP first.&#39;</span><span class=p>)</span>
+
+    <span class=n>implementation_statuses</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>control_impl_req</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_implemented_req</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>control_impl_req</span> <span class=ow>and</span> <span class=n>control_impl_req</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>control_impl_req</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>IMPLEMENTATION_STATUS</span><span class=p>:</span>
+                <span class=n>implementation_statuses</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+
+    <span class=n>md_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_write_list_with_header</span><span class=p>(</span><span class=s1>&#39;FedRamp Implementation Status.&#39;</span><span class=p>,</span> <span class=n>implementation_statuses</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>md_list</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.get_responsible_roles_table class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_responsible_roles_table</span><span class=p>(</span><span class=n>control_id</span><span class=p>,</span> <span class=n>level</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.get_responsible_roles_table class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>For each role id - if the role exists in metadata use the title as what gets printed in the roles table.</p> <p>If not (for now) warn and use the role-id as the printed text.</p> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_responsible_roles_table</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    For each role id - if the role exists in metadata use the title as what gets printed in the roles table.</span>
+
+<span class=sd>    If not (for now) warn and use the role-id as the printed text.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;Cannot get responsible roles, SSP is not set.&#39;</span><span class=p>)</span>
+
+    <span class=k>for</span> <span class=n>impl_requirement</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>impl_requirement</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>impl_requirement</span><span class=o>.</span><span class=n>responsible_roles</span><span class=p>:</span>
+                <span class=n>resp_roles</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>impl_requirement</span><span class=o>.</span><span class=n>responsible_roles</span><span class=p>)</span>
+                <span class=n>role_ids</span> <span class=o>=</span> <span class=p>[</span><span class=n>role</span><span class=o>.</span><span class=n>role_id</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;_&#39;</span><span class=p>,</span> <span class=s1>&#39; &#39;</span><span class=p>)</span> <span class=k>for</span> <span class=n>role</span> <span class=ow>in</span> <span class=n>resp_roles</span><span class=p>]</span>
+
+                <span class=c1># now check if this role exists in the metadata</span>
+                <span class=n>role_titles</span> <span class=o>=</span> <span class=nb>dict</span><span class=p>(</span><span class=nb>zip</span><span class=p>(</span><span class=n>role_ids</span><span class=p>,</span> <span class=n>role_ids</span><span class=p>))</span>
+                <span class=n>roles</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>roles</span><span class=p>)</span>
+                <span class=k>for</span> <span class=n>role</span> <span class=ow>in</span> <span class=n>roles</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>role</span><span class=o>.</span><span class=n>id</span> <span class=ow>in</span> <span class=n>role_ids</span><span class=p>:</span>
+                        <span class=n>role_titles</span><span class=p>[</span><span class=n>role</span><span class=o>.</span><span class=n>id</span><span class=p>]</span> <span class=o>=</span> <span class=n>role</span><span class=o>.</span><span class=n>title</span>
+
+                <span class=c1># dictionary to md table</span>
+                <span class=n>md_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_write_table_with_header</span><span class=p>(</span>
+                    <span class=s1>&#39;Responsible Roles.&#39;</span><span class=p>,</span> <span class=p>[[</span><span class=n>key</span><span class=p>,</span> <span class=n>role_titles</span><span class=p>[</span><span class=n>key</span><span class=p>]]</span> <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>role_titles</span><span class=o>.</span><span class=n>keys</span><span class=p>()],</span>
+                    <span class=p>[</span><span class=s1>&#39;Role ID&#39;</span><span class=p>,</span> <span class=s1>&#39;Title&#39;</span><span class=p>],</span>
+                    <span class=n>level</span>
+                <span class=p>)</span>
+                <span class=k>return</span> <span class=n>md_list</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span>
+                    <span class=sa>f</span><span class=s1>&#39;No responsible roles were found for the control with id: </span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1> in given SSP.&#39;</span>
+                <span class=p>)</span>
+                <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+
+    <span class=k>return</span> <span class=s1>&#39;&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.set_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_catalog</span><span class=p>(</span><span class=n>resolved_catalog</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.set_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set catalog.</p> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>resolved_catalog</span><span class=p>:</span> <span class=n>Catalog</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set catalog.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span> <span class=o>=</span> <span class=n>resolved_catalog</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_catalog_interface</span> <span class=o>=</span> <span class=n>catalog_interface</span><span class=o>.</span><span class=n>CatalogInterface</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_resolved_catalog</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.ssp_io.SSPMarkdownWriter.set_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_ssp</span><span class=p>(</span><span class=n>ssp</span><span class=p>)</span></code> <a href=#trestle.core.ssp_io.SSPMarkdownWriter.set_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set ssp.</p> <details class=quote> <summary>Source code in <code>trestle/core/ssp_io.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_ssp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ssp</span><span class=p>:</span> <span class=n>ssp</span><span class=o>.</span><span class=n>SystemSecurityPlan</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set ssp.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_ssp</span> <span class=o>=</span> <span class=n>ssp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.core.ssp_io-functions>Functions<a href=#trestle.core.ssp_io-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/trestle_base_model/index.html b/latest/reference/API/trestle/core/trestle_base_model/index.html
new file mode 100644
index 000000000..a3ebc3683
--- /dev/null
+++ b/latest/reference/API/trestle/core/trestle_base_model/index.html
@@ -0,0 +1,77 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.trestle_base_model module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/trestle_base_model/ rel=canonical><link href=../ssp_io/ rel=prev><link href=../validator/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.trestle_base_model - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.trestle_base_model - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.trestle_base_model module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/trestle_base_model.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/trestle_base_model/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.trestle_base_model - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.trestle_base_model module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/trestle_base_model.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.trestle_base_model class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.trestle_base_model </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model class=md-nav__link> <span class=md-ellipsis> trestle_base_model </span> </a> <nav class=md-nav aria-label=trestle_base_model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model.TrestleBaseModel class=md-nav__link> <span class=md-ellipsis> TrestleBaseModel </span> </a> <nav class=md-nav aria-label=TrestleBaseModel> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model.TrestleBaseModel-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model.TrestleBaseModel.parse_obj class=md-nav__link> <span class=md-ellipsis> parse_obj </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model class=md-nav__link> <span class=md-ellipsis> trestle_base_model </span> </a> <nav class=md-nav aria-label=trestle_base_model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model.TrestleBaseModel class=md-nav__link> <span class=md-ellipsis> TrestleBaseModel </span> </a> <nav class=md-nav aria-label=TrestleBaseModel> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model.TrestleBaseModel-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.trestle_base_model.TrestleBaseModel.parse_obj class=md-nav__link> <span class=md-ellipsis> parse_obj </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.trestle_base_model</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.trestle_base_model class="doc doc-heading"> <code>trestle.core.trestle_base_model</code> <a href=#trestle.core.trestle_base_model class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle Base Model.</p> <div class="doc doc-children"> <h3 id=trestle.core.trestle_base_model-attributes>Attributes<a href=#trestle.core.trestle_base_model-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.trestle_base_model.Model class="doc doc-heading"> <code class="highlight language-python"><span class=n>Model</span> <span class=o>=</span> <span class=n>TypeVar</span><span class=p>(</span><span class=s1>&#39;Model&#39;</span><span class=p>,</span> <span class=n>bound</span><span class=o>=</span><span class=s1>&#39;BaseModel&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.trestle_base_model.Model class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.trestle_base_model-classes>Classes<a href=#trestle.core.trestle_base_model-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.trestle_base_model.TrestleBaseModel class="doc doc-heading"> <code>TrestleBaseModel</code> <a href=#trestle.core.trestle_base_model.TrestleBaseModel class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=pydantic.v1.BaseModel>BaseModel</span></code></p> <p>Trestle Base Model. Serves as wrapper around BaseModel for overriding methods.</p> <details class=quote> <summary>Source code in <code>trestle/core/trestle_base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TrestleBaseModel</span><span class=p>(</span><span class=n>BaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Trestle Base Model. Serves as wrapper around BaseModel for overriding methods.&quot;&quot;&quot;</span>
+
+    <span class=nd>@classmethod</span>
+    <span class=k>def</span> <span class=nf>parse_obj</span><span class=p>(</span><span class=bp>cls</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=s1>&#39;Model&#39;</span><span class=p>],</span> <span class=n>obj</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;Model&#39;</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Parse object to the given class.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>parse_obj</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span>
+        <span class=k>except</span> <span class=n>ValidationError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=c1># check if failed due to the wrong OSCAL version:</span>
+            <span class=n>oscal_version_error</span> <span class=o>=</span> <span class=kc>False</span>
+            <span class=k>for</span> <span class=n>err</span> <span class=ow>in</span> <span class=n>e</span><span class=o>.</span><span class=n>errors</span><span class=p>():</span>
+                <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>err</span><span class=p>[</span><span class=s1>&#39;loc&#39;</span><span class=p>]:</span>
+                    <span class=k>if</span> <span class=n>field</span> <span class=o>==</span> <span class=s1>&#39;oscal-version&#39;</span><span class=p>:</span>
+                        <span class=n>message</span> <span class=o>=</span> <span class=n>err</span><span class=p>[</span><span class=s1>&#39;msg&#39;</span><span class=p>]</span>
+                        <span class=n>oscal_version_error</span> <span class=o>=</span> <span class=kc>True</span>
+                        <span class=k>break</span>
+            <span class=k>if</span> <span class=n>oscal_version_error</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>message</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>raise</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.trestle_base_model.TrestleBaseModel-functions>Functions<a href=#trestle.core.trestle_base_model.TrestleBaseModel-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.trestle_base_model.TrestleBaseModel.parse_obj class="doc doc-heading"> <code class="highlight language-python"><span class=n>parse_obj</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small> </span> <a href=#trestle.core.trestle_base_model.TrestleBaseModel.parse_obj class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Parse object to the given class.</p> <details class=quote> <summary>Source code in <code>trestle/core/trestle_base_model.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@classmethod</span>
+<span class=k>def</span> <span class=nf>parse_obj</span><span class=p>(</span><span class=bp>cls</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=s1>&#39;Model&#39;</span><span class=p>],</span> <span class=n>obj</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=s1>&#39;Model&#39;</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Parse object to the given class.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=n>parse_obj</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span>
+    <span class=k>except</span> <span class=n>ValidationError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=c1># check if failed due to the wrong OSCAL version:</span>
+        <span class=n>oscal_version_error</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>for</span> <span class=n>err</span> <span class=ow>in</span> <span class=n>e</span><span class=o>.</span><span class=n>errors</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>field</span> <span class=ow>in</span> <span class=n>err</span><span class=p>[</span><span class=s1>&#39;loc&#39;</span><span class=p>]:</span>
+                <span class=k>if</span> <span class=n>field</span> <span class=o>==</span> <span class=s1>&#39;oscal-version&#39;</span><span class=p>:</span>
+                    <span class=n>message</span> <span class=o>=</span> <span class=n>err</span><span class=p>[</span><span class=s1>&#39;msg&#39;</span><span class=p>]</span>
+                    <span class=n>oscal_version_error</span> <span class=o>=</span> <span class=kc>True</span>
+                    <span class=k>break</span>
+        <span class=k>if</span> <span class=n>oscal_version_error</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>message</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>raise</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/validator/index.html b/latest/reference/API/trestle/core/validator/index.html
new file mode 100644
index 000000000..c03155ade
--- /dev/null
+++ b/latest/reference/API/trestle/core/validator/index.html
@@ -0,0 +1,287 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.validator module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/validator/ rel=canonical><link href=../trestle_base_model/ rel=prev><link href=../validator_factory/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.validator - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.validator - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.validator module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/validator.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/validator/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.validator - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.validator module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/validator.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.validator class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.validator </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.validator </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.validator </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.validator class=md-nav__link> <span class=md-ellipsis> validator </span> </a> <nav class=md-nav aria-label=validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator.Validator class=md-nav__link> <span class=md-ellipsis> Validator </span> </a> <nav class=md-nav aria-label=Validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator.Validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator.Validator.error_msg class=md-nav__link> <span class=md-ellipsis> error_msg </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.validator.Validator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.validator.Validator.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.validator class=md-nav__link> <span class=md-ellipsis> validator </span> </a> <nav class=md-nav aria-label=validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.validator-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator.Validator class=md-nav__link> <span class=md-ellipsis> Validator </span> </a> <nav class=md-nav aria-label=Validator> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator.Validator-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator.Validator.error_msg class=md-nav__link> <span class=md-ellipsis> error_msg </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.validator.Validator.model_is_valid class=md-nav__link> <span class=md-ellipsis> model_is_valid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.validator.Validator.validate class=md-nav__link> <span class=md-ellipsis> validate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.validator</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.validator class="doc doc-heading"> <code>trestle.core.validator</code> <a href=#trestle.core.validator class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Base class for all validators.</p> <div class="doc doc-children"> <h3 id=trestle.core.validator-attributes>Attributes<a href=#trestle.core.validator-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.validator.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.validator.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.validator-classes>Classes<a href=#trestle.core.validator-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.core.validator.Validator class="doc doc-heading"> <code>Validator</code> <a href=#trestle.core.validator.Validator class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=abc.ABC>ABC</span></code></p> <p>Validator base class.</p> <details class=quote> <summary>Source code in <code>trestle/core/validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Validator</span><span class=p>(</span><span class=n>ABC</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Validator base class.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>error_msg</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Error message used to describe this validator.&quot;&quot;&quot;</span>
+        <span class=c1># subclasses can override as needed</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__doc__</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Validate the model.</span>
+
+<span class=sd>        args:</span>
+<span class=sd>            model: An Oscal model that can be passed to the validator.</span>
+<span class=sd>            quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>        returns:</span>
+<span class=sd>            Whether or not the model passed this validation test.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>validate</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Perform the validation according to user options.&quot;&quot;&quot;</span>
+        <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>  <span class=c1># trestle root is set via command line in args. Default is cwd.</span>
+
+        <span class=c1># validate by type - all of type or just specified by name</span>
+        <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>:</span>
+            <span class=n>models</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+                <span class=n>models</span> <span class=o>=</span> <span class=p>[</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>]</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>models</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_models_of_type</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=n>models_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>m</span> <span class=ow>in</span> <span class=n>models</span><span class=p>:</span>
+                <span class=n>model_path</span> <span class=o>=</span> <span class=n>models_path</span> <span class=o>/</span> <span class=n>m</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+                <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File load error </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>OSCAL_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: Model </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1> did not pass the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>OSCAL_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: Model </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1> passed the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=c1># validate all</span>
+        <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>all</span><span class=p>:</span>
+            <span class=n>model_tups</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_all_models</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>mt</span> <span class=ow>in</span> <span class=n>model_tups</span><span class=p>:</span>
+
+                <span class=n>model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>mt</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span> <span class=o>/</span> <span class=n>mt</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+                <span class=n>extension_type</span> <span class=o>=</span> <span class=n>trestle</span><span class=o>.</span><span class=n>common</span><span class=o>.</span><span class=n>file_utils</span><span class=o>.</span><span class=n>get_contextual_file_type</span><span class=p>(</span><span class=n>model_dir</span><span class=p>)</span>
+                <span class=n>model_path</span> <span class=o>=</span> <span class=n>model_dir</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>mt</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}{</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>extension_type</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: Model </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1> did not pass the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>OSCAL_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: Model </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1> passed the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+        <span class=c1># validate file</span>
+        <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>file</span><span class=p>:</span>
+            <span class=n>file_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>file</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: Model </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> did not pass the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>OSCAL_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: Model </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> passed the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.core.validator.Validator-functions>Functions<a href=#trestle.core.validator.Validator-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.core.validator.Validator.error_msg class="doc doc-heading"> <code class="highlight language-python"><span class=n>error_msg</span><span class=p>()</span></code> <a href=#trestle.core.validator.Validator.error_msg class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Error message used to describe this validator.</p> <details class=quote> <summary>Source code in <code>trestle/core/validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>error_msg</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Error message used to describe this validator.&quot;&quot;&quot;</span>
+    <span class=c1># subclasses can override as needed</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=vm>__doc__</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.validator.Validator.model_is_valid class="doc doc-heading"> <code class="highlight language-python"><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.core.validator.Validator.model_is_valid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Validate the model.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>model</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.common_types.TopLevelOscalModel href=../../common/common_types/#trestle.common.common_types.TopLevelOscalModel>TopLevelOscalModel</a></code> </td> <td> <div class=doc-md-description> <p>An Oscal model that can be passed to the validator.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>quiet</code> </td> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Don't report msgs unless invalid.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>bool</code> </td> <td> <div class=doc-md-description> <p>Whether or not the model passed this validation test.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/core/validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>model_is_valid</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span> <span class=n>model</span><span class=p>:</span> <span class=n>TopLevelOscalModel</span><span class=p>,</span> <span class=n>quiet</span><span class=p>:</span> <span class=nb>bool</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Validate the model.</span>
+
+<span class=sd>    args:</span>
+<span class=sd>        model: An Oscal model that can be passed to the validator.</span>
+<span class=sd>        quiet: Don&#39;t report msgs unless invalid.</span>
+
+<span class=sd>    returns:</span>
+<span class=sd>        Whether or not the model passed this validation test.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.core.validator.Validator.validate class="doc doc-heading"> <code class="highlight language-python"><span class=n>validate</span><span class=p>(</span><span class=n>args</span><span class=p>)</span></code> <a href=#trestle.core.validator.Validator.validate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Perform the validation according to user options.</p> <details class=quote> <summary>Source code in <code>trestle/core/validator.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>validate</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>argparse</span><span class=o>.</span><span class=n>Namespace</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Perform the validation according to user options.&quot;&quot;&quot;</span>
+    <span class=n>trestle_root</span> <span class=o>=</span> <span class=n>args</span><span class=o>.</span><span class=n>trestle_root</span>  <span class=c1># trestle root is set via command line in args. Default is cwd.</span>
+
+    <span class=c1># validate by type - all of type or just specified by name</span>
+    <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>:</span>
+        <span class=n>models</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+            <span class=n>models</span> <span class=o>=</span> <span class=p>[</span><span class=n>args</span><span class=o>.</span><span class=n>name</span><span class=p>]</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>models</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_models_of_type</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=n>models_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>args</span><span class=o>.</span><span class=n>type</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>m</span> <span class=ow>in</span> <span class=n>models</span><span class=p>:</span>
+            <span class=n>model_path</span> <span class=o>=</span> <span class=n>models_path</span> <span class=o>/</span> <span class=n>m</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=k>except</span> <span class=n>TrestleError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;File load error </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>OSCAL_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: Model </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1> did not pass the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>OSCAL_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: Model </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1> passed the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=c1># validate all</span>
+    <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>all</span><span class=p>:</span>
+        <span class=n>model_tups</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>get_all_models</span><span class=p>(</span><span class=n>trestle_root</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>mt</span> <span class=ow>in</span> <span class=n>model_tups</span><span class=p>:</span>
+
+            <span class=n>model_dir</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>model_type_to_model_dir</span><span class=p>(</span><span class=n>mt</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span> <span class=o>/</span> <span class=n>mt</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>extension_type</span> <span class=o>=</span> <span class=n>trestle</span><span class=o>.</span><span class=n>common</span><span class=o>.</span><span class=n>file_utils</span><span class=o>.</span><span class=n>get_contextual_file_type</span><span class=p>(</span><span class=n>model_dir</span><span class=p>)</span>
+            <span class=n>model_path</span> <span class=o>=</span> <span class=n>model_dir</span> <span class=o>/</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>mt</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}{</span><span class=n>FileContentType</span><span class=o>.</span><span class=n>to_file_extension</span><span class=p>(</span><span class=n>extension_type</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>model_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: Model </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1> did not pass the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>OSCAL_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: Model </span><span class=si>{</span><span class=n>model_path</span><span class=si>}</span><span class=s1> passed the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+
+    <span class=c1># validate file</span>
+    <span class=k>if</span> <span class=n>args</span><span class=o>.</span><span class=n>file</span><span class=p>:</span>
+        <span class=n>file_path</span> <span class=o>=</span> <span class=n>trestle_root</span> <span class=o>/</span> <span class=n>args</span><span class=o>.</span><span class=n>file</span>
+        <span class=n>_</span><span class=p>,</span> <span class=n>_</span><span class=p>,</span> <span class=n>model</span> <span class=o>=</span> <span class=n>ModelUtils</span><span class=o>.</span><span class=n>load_distributed</span><span class=p>(</span><span class=n>file_path</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>model_is_valid</span><span class=p>(</span><span class=n>model</span><span class=p>,</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>,</span> <span class=n>trestle_root</span><span class=p>):</span>  <span class=c1># type: ignore</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;INVALID: Model </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> did not pass the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>OSCAL_VALIDATION_ERROR</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>args</span><span class=o>.</span><span class=n>quiet</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;VALID: Model </span><span class=si>{</span><span class=n>file_path</span><span class=si>}</span><span class=s1> passed the </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>error_msg</span><span class=p>()</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>CmdReturnCodes</span><span class=o>.</span><span class=n>SUCCESS</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/core/validator_factory/index.html b/latest/reference/API/trestle/core/validator_factory/index.html
new file mode 100644
index 000000000..08646c5b3
--- /dev/null
+++ b/latest/reference/API/trestle/core/validator_factory/index.html
@@ -0,0 +1,18 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.core.validator_factory module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/validator_factory/ rel=canonical><link href=../validator/ rel=prev><link href=../catalog/catalog_api/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.core.validator_factory - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.core.validator_factory - Compliance Trestle"><meta property=og:description content="Documentation for trestle.core.validator_factory module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/validator_factory.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/validator_factory/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.core.validator_factory - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.core.validator_factory module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/core/validator_factory.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.core.validator_factory class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.core.validator_factory </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3 checked> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.core.validator_factory </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.validator_factory class=md-nav__link> <span class=md-ellipsis> validator_factory </span> </a> <nav class=md-nav aria-label=validator_factory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator_factory-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator_factory.validator_factory class=md-nav__link> <span class=md-ellipsis> validator_factory </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.validator_factory-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.validator_factory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator_factory.init_arguments class=md-nav__link> <span class=md-ellipsis> init_arguments </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.core.validator_factory class=md-nav__link> <span class=md-ellipsis> validator_factory </span> </a> <nav class=md-nav aria-label=validator_factory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator_factory-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator_factory.validator_factory class=md-nav__link> <span class=md-ellipsis> validator_factory </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.core.validator_factory-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.core.validator_factory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.core.validator_factory.init_arguments class=md-nav__link> <span class=md-ellipsis> init_arguments </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.core.validator_factory</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.core.validator_factory class="doc doc-heading"> <code>trestle.core.validator_factory</code> <a href=#trestle.core.validator_factory class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Register all validators here in the validator_factory.</p> <div class="doc doc-children"> <h3 id=trestle.core.validator_factory-attributes>Attributes<a href=#trestle.core.validator_factory-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.core.validator_factory.validator_factory class="doc doc-heading"> <code class="highlight language-python"><span class=n>validator_factory</span><span class=p>:</span> <span class=n>ObjectFactory</span> <span class=o>=</span> <span class=n>ObjectFactory</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.core.validator_factory.validator_factory class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.core.validator_factory-classes>Classes<a href=#trestle.core.validator_factory-classes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.core.validator_factory-functions>Functions<a href=#trestle.core.validator_factory-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.core.validator_factory.init_arguments class="doc doc-heading"> <code class="highlight language-python"><span class=n>init_arguments</span><span class=p>(</span><span class=n>cmd</span><span class=p>)</span></code> <a href=#trestle.core.validator_factory.init_arguments class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Feed the arguments to the argument parser.</p> <details class=quote> <summary>Source code in <code>trestle/core/validator_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>init_arguments</span><span class=p>(</span><span class=n>cmd</span><span class=p>:</span> <span class=n>Command</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Feed the arguments to the argument parser.&quot;&quot;&quot;</span>
+    <span class=n>group</span> <span class=o>=</span> <span class=n>cmd</span><span class=o>.</span><span class=n>parser</span><span class=o>.</span><span class=n>add_mutually_exclusive_group</span><span class=p>(</span><span class=n>required</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+    <span class=n>group</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-f&#39;</span><span class=p>,</span> <span class=s1>&#39;--file&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Path of file in trestle directory to validate.&#39;</span><span class=p>)</span>
+    <span class=n>group</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-t&#39;</span><span class=p>,</span> <span class=s1>&#39;--type&#39;</span><span class=p>,</span> <span class=n>choices</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>MODEL_TYPE_LIST</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Validate one or all models of this type.&#39;</span><span class=p>)</span>
+    <span class=n>group</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-a&#39;</span><span class=p>,</span> <span class=s1>&#39;--all&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Validate all models in trestle directory.&#39;</span><span class=p>)</span>
+    <span class=n>cmd</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-n&#39;</span><span class=p>,</span> <span class=s1>&#39;--name&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=s1>&#39;Name of single model to validate (with --type specified).&#39;</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+    <span class=n>quiet_help</span> <span class=o>=</span> <span class=s1>&#39;Do not report messages unless validation fails.&#39;</span>
+    <span class=n>cmd</span><span class=o>.</span><span class=n>add_argument</span><span class=p>(</span><span class=s1>&#39;-q&#39;</span><span class=p>,</span> <span class=s1>&#39;--quiet&#39;</span><span class=p>,</span> <span class=n>action</span><span class=o>=</span><span class=s1>&#39;store_true&#39;</span><span class=p>,</span> <span class=n>help</span><span class=o>=</span><span class=n>quiet_help</span><span class=p>,</span> <span class=n>required</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/oscal/assessment_plan/index.html b/latest/reference/API/trestle/oscal/assessment_plan/index.html
new file mode 100644
index 000000000..41d0d05a3
--- /dev/null
+++ b/latest/reference/API/trestle/oscal/assessment_plan/index.html
@@ -0,0 +1,130 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.oscal.assessment_plan module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/assessment_plan/ rel=canonical><link href=../../core/resolver/prune/ rel=prev><link href=../assessment_results/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.oscal.assessment_plan - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.oscal.assessment_plan - Compliance Trestle"><meta property=og:description content="Documentation for trestle.oscal.assessment_plan module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/assessment_plan.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/assessment_plan/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.oscal.assessment_plan - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.oscal.assessment_plan module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/assessment_plan.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.oscal.assessment_plan class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4 checked> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan class=md-nav__link> <span class=md-ellipsis> assessment_plan </span> </a> <nav class=md-nav aria-label=assessment_plan> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan class=md-nav__link> <span class=md-ellipsis> AssessmentPlan </span> </a> <nav class=md-nav aria-label=AssessmentPlan> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.assessment_assets class=md-nav__link> <span class=md-ellipsis> assessment_assets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.assessment_subjects class=md-nav__link> <span class=md-ellipsis> assessment_subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.import_ssp class=md-nav__link> <span class=md-ellipsis> import_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.local_definitions class=md-nav__link> <span class=md-ellipsis> local_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.reviewed_controls class=md-nav__link> <span class=md-ellipsis> reviewed_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.tasks class=md-nav__link> <span class=md-ellipsis> tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.terms_and_conditions class=md-nav__link> <span class=md-ellipsis> terms_and_conditions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions class=md-nav__link> <span class=md-ellipsis> LocalDefinitions </span> </a> <nav class=md-nav aria-label=LocalDefinitions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.activities class=md-nav__link> <span class=md-ellipsis> activities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.inventory_items class=md-nav__link> <span class=md-ellipsis> inventory_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.objectives_and_methods class=md-nav__link> <span class=md-ellipsis> objectives_and_methods </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.users class=md-nav__link> <span class=md-ellipsis> users </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.Model.assessment_plan class=md-nav__link> <span class=md-ellipsis> assessment_plan </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions class=md-nav__link> <span class=md-ellipsis> TermsAndConditions </span> </a> <nav class=md-nav aria-label=TermsAndConditions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan class=md-nav__link> <span class=md-ellipsis> assessment_plan </span> </a> <nav class=md-nav aria-label=assessment_plan> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan class=md-nav__link> <span class=md-ellipsis> AssessmentPlan </span> </a> <nav class=md-nav aria-label=AssessmentPlan> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.assessment_assets class=md-nav__link> <span class=md-ellipsis> assessment_assets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.assessment_subjects class=md-nav__link> <span class=md-ellipsis> assessment_subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.import_ssp class=md-nav__link> <span class=md-ellipsis> import_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.local_definitions class=md-nav__link> <span class=md-ellipsis> local_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.reviewed_controls class=md-nav__link> <span class=md-ellipsis> reviewed_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.tasks class=md-nav__link> <span class=md-ellipsis> tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.terms_and_conditions class=md-nav__link> <span class=md-ellipsis> terms_and_conditions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions class=md-nav__link> <span class=md-ellipsis> LocalDefinitions </span> </a> <nav class=md-nav aria-label=LocalDefinitions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.activities class=md-nav__link> <span class=md-ellipsis> activities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.inventory_items class=md-nav__link> <span class=md-ellipsis> inventory_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.objectives_and_methods class=md-nav__link> <span class=md-ellipsis> objectives_and_methods </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.users class=md-nav__link> <span class=md-ellipsis> users </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.Model.assessment_plan class=md-nav__link> <span class=md-ellipsis> assessment_plan </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions class=md-nav__link> <span class=md-ellipsis> TermsAndConditions </span> </a> <nav class=md-nav aria-label=TermsAndConditions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_plan.TermsAndConditions.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.oscal.assessment_plan</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.oscal.assessment_plan class="doc doc-heading"> <code>trestle.oscal.assessment_plan</code> <a href=#trestle.oscal.assessment_plan class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <div class="doc doc-children"> <h3 id=trestle.oscal.assessment_plan-attributes>Attributes<a href=#trestle.oscal.assessment_plan-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.oscal.assessment_plan-classes>Classes<a href=#trestle.oscal.assessment_plan-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_plan.AssessmentPlan class="doc doc-heading"> <code>AssessmentPlan</code> <a href=#trestle.oscal.assessment_plan.AssessmentPlan class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An assessment plan, such as those provided by a FedRAMP assessor.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_plan.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssessmentPlan</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An assessment plan, such as those provided by a FedRAMP assessor.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment plan in this or other OSCAL instances. The locally defined UUID of the assessment plan can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Plan Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span>
+    <span class=n>import_ssp</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImportSsp</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-ssp&#39;</span><span class=p>)</span>
+    <span class=n>local_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>LocalDefinitions</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;local-definitions&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Local Definitions&#39;</span>
+    <span class=p>)</span>
+    <span class=n>terms_and_conditions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TermsAndConditions</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;terms-and-conditions&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Used to define various terms and conditions under which an assessment, described by the plan, can be performed. Each child part defines a different type of term or condition.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Plan Terms and Conditions&#39;</span>
+    <span class=p>)</span>
+    <span class=n>reviewed_controls</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ReviewedControls</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;reviewed-controls&#39;</span><span class=p>)</span>
+    <span class=n>assessment_subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentSubject</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-subjects&#39;</span><span class=p>)</span>
+    <span class=n>assessment_assets</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentAssets</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-assets&#39;</span><span class=p>)</span>
+    <span class=n>tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Task</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_plan.AssessmentPlan-attributes>Attributes<a href=#trestle.oscal.assessment_plan.AssessmentPlan-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.assessment_assets class="doc doc-heading"> <code class="highlight language-python"><span class=n>assessment_assets</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentAssets</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-assets&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.assessment_assets class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.assessment_subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>assessment_subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentSubject</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-subjects&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.assessment_subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.back_matter class="doc doc-heading"> <code class="highlight language-python"><span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.back_matter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.import_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>import_ssp</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ImportSsp</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-ssp&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.import_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.local_definitions class="doc doc-heading"> <code class="highlight language-python"><span class=n>local_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>LocalDefinitions</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;local-definitions&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Local Definitions&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.local_definitions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.reviewed_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>reviewed_controls</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ReviewedControls</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;reviewed-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.reviewed_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.tasks class="doc doc-heading"> <code class="highlight language-python"><span class=n>tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Task</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.tasks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.terms_and_conditions class="doc doc-heading"> <code class="highlight language-python"><span class=n>terms_and_conditions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>TermsAndConditions</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;terms-and-conditions&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to define various terms and conditions under which an assessment, described by the plan, can be performed. Each child part defines a different type of term or condition.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Plan Terms and Conditions&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.terms_and_conditions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment plan in this or other OSCAL instances. The locally defined UUID of the assessment plan can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Plan Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_plan.AssessmentPlan-classes>Classes<a href=#trestle.oscal.assessment_plan.AssessmentPlan-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_plan.AssessmentPlan.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_plan.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_plan.AssessmentPlan.Config-attributes>Attributes<a href=#trestle.oscal.assessment_plan.AssessmentPlan.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_plan.AssessmentPlan.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.AssessmentPlan.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_plan.LocalDefinitions class="doc doc-heading"> <code>LocalDefinitions</code> <a href=#trestle.oscal.assessment_plan.LocalDefinitions class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_plan.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LocalDefinitions</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>inventory_items</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>InventoryItem</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;inventory-items&#39;</span><span class=p>)</span>
+    <span class=n>users</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemUser</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>objectives_and_methods</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>LocalObjective</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;objectives-and-methods&#39;</span><span class=p>)</span>
+    <span class=n>activities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Activity</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_plan.LocalDefinitions-attributes>Attributes<a href=#trestle.oscal.assessment_plan.LocalDefinitions-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.LocalDefinitions.activities class="doc doc-heading"> <code class="highlight language-python"><span class=n>activities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Activity</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.activities class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.LocalDefinitions.components class="doc doc-heading"> <code class="highlight language-python"><span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.LocalDefinitions.inventory_items class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory_items</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>InventoryItem</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;inventory-items&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.inventory_items class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.LocalDefinitions.objectives_and_methods class="doc doc-heading"> <code class="highlight language-python"><span class=n>objectives_and_methods</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>LocalObjective</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;objectives-and-methods&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.objectives_and_methods class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.LocalDefinitions.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.LocalDefinitions.users class="doc doc-heading"> <code class="highlight language-python"><span class=n>users</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemUser</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.users class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_plan.LocalDefinitions-classes>Classes<a href=#trestle.oscal.assessment_plan.LocalDefinitions-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_plan.LocalDefinitions.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_plan.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>59</span>
+<span class=normal>60</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_plan.LocalDefinitions.Config-attributes>Attributes<a href=#trestle.oscal.assessment_plan.LocalDefinitions.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_plan.LocalDefinitions.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.LocalDefinitions.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_plan.Model class="doc doc-heading"> <code>Model</code> <a href=#trestle.oscal.assessment_plan.Model class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_plan.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>109</span>
+<span class=normal>110</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Model</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>assessment_plan</span><span class=p>:</span> <span class=n>AssessmentPlan</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-plan&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_plan.Model-attributes>Attributes<a href=#trestle.oscal.assessment_plan.Model-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.Model.assessment_plan class="doc doc-heading"> <code class="highlight language-python"><span class=n>assessment_plan</span><span class=p>:</span> <span class=n>AssessmentPlan</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-plan&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.Model.assessment_plan class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_plan.TermsAndConditions class="doc doc-heading"> <code>TermsAndConditions</code> <a href=#trestle.oscal.assessment_plan.TermsAndConditions class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to define various terms and conditions under which an assessment, described by the plan, can be performed. Each child part defines a different type of term or condition.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_plan.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TermsAndConditions</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to define various terms and conditions under which an assessment, described by the plan, can be performed. Each child part defines a different type of term or condition.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentPart</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_plan.TermsAndConditions-attributes>Attributes<a href=#trestle.oscal.assessment_plan.TermsAndConditions-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_plan.TermsAndConditions.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentPart</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.TermsAndConditions.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_plan.TermsAndConditions-classes>Classes<a href=#trestle.oscal.assessment_plan.TermsAndConditions-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_plan.TermsAndConditions.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_plan.TermsAndConditions.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_plan.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>48</span>
+<span class=normal>49</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_plan.TermsAndConditions.Config-attributes>Attributes<a href=#trestle.oscal.assessment_plan.TermsAndConditions.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_plan.TermsAndConditions.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_plan.TermsAndConditions.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/oscal/assessment_results/index.html b/latest/reference/API/trestle/oscal/assessment_results/index.html
new file mode 100644
index 000000000..0fed9b7c4
--- /dev/null
+++ b/latest/reference/API/trestle/oscal/assessment_results/index.html
@@ -0,0 +1,356 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.oscal.assessment_results module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/assessment_results/ rel=canonical><link href=../assessment_plan/ rel=prev><link href=../catalog/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.oscal.assessment_results - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.oscal.assessment_results - Compliance Trestle"><meta property=og:description content="Documentation for trestle.oscal.assessment_results module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/assessment_results.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/assessment_results/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.oscal.assessment_results - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.oscal.assessment_results module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/assessment_results.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.oscal.assessment_results class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4 checked> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.oscal.assessment_results </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results class=md-nav__link> <span class=md-ellipsis> assessment_results </span> </a> <nav class=md-nav aria-label=assessment_results> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog class=md-nav__link> <span class=md-ellipsis> AssessmentLog </span> </a> <nav class=md-nav aria-label=AssessmentLog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog.entries class=md-nav__link> <span class=md-ellipsis> entries </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults class=md-nav__link> <span class=md-ellipsis> AssessmentResults </span> </a> <nav class=md-nav aria-label=AssessmentResults> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.import_ap class=md-nav__link> <span class=md-ellipsis> import_ap </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.local_definitions class=md-nav__link> <span class=md-ellipsis> local_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.results class=md-nav__link> <span class=md-ellipsis> results </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation class=md-nav__link> <span class=md-ellipsis> Attestation </span> </a> <nav class=md-nav aria-label=Attestation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1 class=md-nav__link> <span class=md-ellipsis> Entry1 </span> </a> <nav class=md-nav aria-label=Entry1> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.logged_by class=md-nav__link> <span class=md-ellipsis> logged_by </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.related_tasks class=md-nav__link> <span class=md-ellipsis> related_tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp class=md-nav__link> <span class=md-ellipsis> ImportAp </span> </a> <nav class=md-nav aria-label=ImportAp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions class=md-nav__link> <span class=md-ellipsis> LocalDefinitions </span> </a> <nav class=md-nav aria-label=LocalDefinitions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions.activities class=md-nav__link> <span class=md-ellipsis> activities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions.objectives_and_methods class=md-nav__link> <span class=md-ellipsis> objectives_and_methods </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1 class=md-nav__link> <span class=md-ellipsis> LocalDefinitions1 </span> </a> <nav class=md-nav aria-label=LocalDefinitions1> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.assessment_assets class=md-nav__link> <span class=md-ellipsis> assessment_assets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.inventory_items class=md-nav__link> <span class=md-ellipsis> inventory_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.tasks class=md-nav__link> <span class=md-ellipsis> tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.users class=md-nav__link> <span class=md-ellipsis> users </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Model.assessment_results class=md-nav__link> <span class=md-ellipsis> assessment_results </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result class=md-nav__link> <span class=md-ellipsis> Result </span> </a> <nav class=md-nav aria-label=Result> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.assessment_log class=md-nav__link> <span class=md-ellipsis> assessment_log </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.attestations class=md-nav__link> <span class=md-ellipsis> attestations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.findings class=md-nav__link> <span class=md-ellipsis> findings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.local_definitions class=md-nav__link> <span class=md-ellipsis> local_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.observations class=md-nav__link> <span class=md-ellipsis> observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.reviewed_controls class=md-nav__link> <span class=md-ellipsis> reviewed_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.risks class=md-nav__link> <span class=md-ellipsis> risks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results class=md-nav__link> <span class=md-ellipsis> assessment_results </span> </a> <nav class=md-nav aria-label=assessment_results> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog class=md-nav__link> <span class=md-ellipsis> AssessmentLog </span> </a> <nav class=md-nav aria-label=AssessmentLog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog.entries class=md-nav__link> <span class=md-ellipsis> entries </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentLog.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults class=md-nav__link> <span class=md-ellipsis> AssessmentResults </span> </a> <nav class=md-nav aria-label=AssessmentResults> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.import_ap class=md-nav__link> <span class=md-ellipsis> import_ap </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.local_definitions class=md-nav__link> <span class=md-ellipsis> local_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.results class=md-nav__link> <span class=md-ellipsis> results </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.AssessmentResults.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation class=md-nav__link> <span class=md-ellipsis> Attestation </span> </a> <nav class=md-nav aria-label=Attestation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Attestation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1 class=md-nav__link> <span class=md-ellipsis> Entry1 </span> </a> <nav class=md-nav aria-label=Entry1> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.logged_by class=md-nav__link> <span class=md-ellipsis> logged_by </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.related_tasks class=md-nav__link> <span class=md-ellipsis> related_tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Entry1.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp class=md-nav__link> <span class=md-ellipsis> ImportAp </span> </a> <nav class=md-nav aria-label=ImportAp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.ImportAp.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions class=md-nav__link> <span class=md-ellipsis> LocalDefinitions </span> </a> <nav class=md-nav aria-label=LocalDefinitions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions.activities class=md-nav__link> <span class=md-ellipsis> activities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions.objectives_and_methods class=md-nav__link> <span class=md-ellipsis> objectives_and_methods </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1 class=md-nav__link> <span class=md-ellipsis> LocalDefinitions1 </span> </a> <nav class=md-nav aria-label=LocalDefinitions1> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.assessment_assets class=md-nav__link> <span class=md-ellipsis> assessment_assets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.inventory_items class=md-nav__link> <span class=md-ellipsis> inventory_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.tasks class=md-nav__link> <span class=md-ellipsis> tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.users class=md-nav__link> <span class=md-ellipsis> users </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Model.assessment_results class=md-nav__link> <span class=md-ellipsis> assessment_results </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result class=md-nav__link> <span class=md-ellipsis> Result </span> </a> <nav class=md-nav aria-label=Result> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.assessment_log class=md-nav__link> <span class=md-ellipsis> assessment_log </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.attestations class=md-nav__link> <span class=md-ellipsis> attestations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.findings class=md-nav__link> <span class=md-ellipsis> findings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.local_definitions class=md-nav__link> <span class=md-ellipsis> local_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.observations class=md-nav__link> <span class=md-ellipsis> observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.reviewed_controls class=md-nav__link> <span class=md-ellipsis> reviewed_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.risks class=md-nav__link> <span class=md-ellipsis> risks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.assessment_results.Result.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.oscal.assessment_results</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.oscal.assessment_results class="doc doc-heading"> <code>trestle.oscal.assessment_results</code> <a href=#trestle.oscal.assessment_results class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <div class="doc doc-children"> <h3 id=trestle.oscal.assessment_results-attributes>Attributes<a href=#trestle.oscal.assessment_results-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.oscal.assessment_results-classes>Classes<a href=#trestle.oscal.assessment_results-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_results.AssessmentLog class="doc doc-heading"> <code>AssessmentLog</code> <a href=#trestle.oscal.assessment_results.AssessmentLog class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A log of all assessment-related actions taken.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssessmentLog</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A log of all assessment-related actions taken.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>entries</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Entry1</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_results.AssessmentLog-attributes>Attributes<a href=#trestle.oscal.assessment_results.AssessmentLog-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.AssessmentLog.entries class="doc doc-heading"> <code class="highlight language-python"><span class=n>entries</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Entry1</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.AssessmentLog.entries class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_results.AssessmentLog-classes>Classes<a href=#trestle.oscal.assessment_results.AssessmentLog-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_results.AssessmentLog.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_results.AssessmentLog.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>140</span>
+<span class=normal>141</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_results.AssessmentLog.Config-attributes>Attributes<a href=#trestle.oscal.assessment_results.AssessmentLog.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_results.AssessmentLog.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.AssessmentLog.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_results.AssessmentResults class="doc doc-heading"> <code>AssessmentResults</code> <a href=#trestle.oscal.assessment_results.AssessmentResults class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Security assessment results, such as those provided by a FedRAMP assessor in the FedRAMP Security Assessment Report.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssessmentResults</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Security assessment results, such as those provided by a FedRAMP assessor in the FedRAMP Security Assessment Report.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment results instance in this or other OSCAL instances. The locally defined UUID of the assessment result can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Results Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span>
+    <span class=n>import_ap</span><span class=p>:</span> <span class=n>ImportAp</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-ap&#39;</span><span class=p>)</span>
+    <span class=n>local_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>LocalDefinitions</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;local-definitions&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Local Definitions&#39;</span>
+    <span class=p>)</span>
+    <span class=n>results</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Result</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_results.AssessmentResults-attributes>Attributes<a href=#trestle.oscal.assessment_results.AssessmentResults-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.AssessmentResults.back_matter class="doc doc-heading"> <code class="highlight language-python"><span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.AssessmentResults.back_matter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.AssessmentResults.import_ap class="doc doc-heading"> <code class="highlight language-python"><span class=n>import_ap</span><span class=p>:</span> <span class=n>ImportAp</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-ap&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.AssessmentResults.import_ap class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.AssessmentResults.local_definitions class="doc doc-heading"> <code class="highlight language-python"><span class=n>local_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>LocalDefinitions</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;local-definitions&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Local Definitions&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.AssessmentResults.local_definitions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.AssessmentResults.metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.AssessmentResults.metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.AssessmentResults.results class="doc doc-heading"> <code class="highlight language-python"><span class=n>results</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Result</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.AssessmentResults.results class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.AssessmentResults.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment results instance in this or other OSCAL instances. The locally defined UUID of the assessment result can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Results Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.AssessmentResults.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_results.AssessmentResults-classes>Classes<a href=#trestle.oscal.assessment_results.AssessmentResults-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_results.AssessmentResults.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_results.AssessmentResults.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>205</span>
+<span class=normal>206</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_results.AssessmentResults.Config-attributes>Attributes<a href=#trestle.oscal.assessment_results.AssessmentResults.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_results.AssessmentResults.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.AssessmentResults.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_results.Attestation class="doc doc-heading"> <code>Attestation</code> <a href=#trestle.oscal.assessment_results.Attestation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A set of textual statements, typically written by the assessor.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Attestation</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A set of textual statements, typically written by the assessor.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentPart</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_results.Attestation-attributes>Attributes<a href=#trestle.oscal.assessment_results.Attestation-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Attestation.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentPart</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Attestation.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Attestation.responsible_parties class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Attestation.responsible_parties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_results.Attestation-classes>Classes<a href=#trestle.oscal.assessment_results.Attestation-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_results.Attestation.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_results.Attestation.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>128</span>
+<span class=normal>129</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_results.Attestation.Config-attributes>Attributes<a href=#trestle.oscal.assessment_results.Attestation.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_results.Attestation.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Attestation.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_results.Entry1 class="doc doc-heading"> <code>Entry1</code> <a href=#trestle.oscal.assessment_results.Entry1 class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies the result of an action and/or task that occurred as part of executing an assessment plan or an assessment event that occurred in producing the assessment results.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Entry1</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the result of an action and/or task that occurred as part of executing an assessment plan or an assessment event that occurred in producing the assessment results.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference an assessment event in this or other OSCAL instances. The locally defined UUID of the assessment log entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Log Entry Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this event.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this event.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>start</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the start date and time of an event.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Start&#39;</span><span class=p>)</span>
+    <span class=n>end</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Identifies the end date and time of an event. If the event is a point in time, the start and end will be the same date and time.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;End&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>logged_by</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>LoggedBy</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;logged-by&#39;</span><span class=p>)</span>
+    <span class=n>related_tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>RelatedTask</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-tasks&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_results.Entry1-attributes>Attributes<a href=#trestle.oscal.assessment_results.Entry1-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this event.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.end class="doc doc-heading"> <code class="highlight language-python"><span class=n>end</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the end date and time of an event. If the event is a point in time, the start and end will be the same date and time.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;End&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.end class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.logged_by class="doc doc-heading"> <code class="highlight language-python"><span class=n>logged_by</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>LoggedBy</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;logged-by&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.logged_by class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.related_tasks class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>RelatedTask</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-tasks&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.related_tasks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.start class="doc doc-heading"> <code class="highlight language-python"><span class=n>start</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the start date and time of an event.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Start&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.start class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this event.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Entry1.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference an assessment event in this or other OSCAL instances. The locally defined UUID of the assessment log entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Log Entry Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_results.Entry1-classes>Classes<a href=#trestle.oscal.assessment_results.Entry1-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_results.Entry1.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_results.Entry1.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_results.Entry1.Config-attributes>Attributes<a href=#trestle.oscal.assessment_results.Entry1.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_results.Entry1.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Entry1.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_results.ImportAp class="doc doc-heading"> <code>ImportAp</code> <a href=#trestle.oscal.assessment_results.ImportAp class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used by assessment-results to import information about the original plan for assessing the system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ImportAp</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used by assessment-results to import information about the original plan for assessing the system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to the assessment plan governing the assessment activities.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Plan Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_results.ImportAp-attributes>Attributes<a href=#trestle.oscal.assessment_results.ImportAp-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.ImportAp.href class="doc doc-heading"> <code class="highlight language-python"><span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to the assessment plan governing the assessment activities.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Plan Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.ImportAp.href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.ImportAp.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.ImportAp.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_results.ImportAp-classes>Classes<a href=#trestle.oscal.assessment_results.ImportAp-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_results.ImportAp.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_results.ImportAp.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>78</span>
+<span class=normal>79</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_results.ImportAp.Config-attributes>Attributes<a href=#trestle.oscal.assessment_results.ImportAp.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_results.ImportAp.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.ImportAp.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_results.LocalDefinitions class="doc doc-heading"> <code>LocalDefinitions</code> <a href=#trestle.oscal.assessment_results.LocalDefinitions class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LocalDefinitions</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>objectives_and_methods</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>LocalObjective</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;objectives-and-methods&#39;</span><span class=p>)</span>
+    <span class=n>activities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Activity</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_results.LocalDefinitions-attributes>Attributes<a href=#trestle.oscal.assessment_results.LocalDefinitions-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions.activities class="doc doc-heading"> <code class="highlight language-python"><span class=n>activities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Activity</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions.activities class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions.objectives_and_methods class="doc doc-heading"> <code class="highlight language-python"><span class=n>objectives_and_methods</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>LocalObjective</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;objectives-and-methods&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions.objectives_and_methods class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_results.LocalDefinitions-classes>Classes<a href=#trestle.oscal.assessment_results.LocalDefinitions-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_results.LocalDefinitions.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>65</span>
+<span class=normal>66</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_results.LocalDefinitions.Config-attributes>Attributes<a href=#trestle.oscal.assessment_results.LocalDefinitions.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_results.LocalDefinitions.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_results.LocalDefinitions1 class="doc doc-heading"> <code>LocalDefinitions1</code> <a href=#trestle.oscal.assessment_results.LocalDefinitions1 class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LocalDefinitions1</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>inventory_items</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>InventoryItem</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;inventory-items&#39;</span><span class=p>)</span>
+    <span class=n>users</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemUser</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>assessment_assets</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentAssets</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-assets&#39;</span><span class=p>)</span>
+    <span class=n>tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Task</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_results.LocalDefinitions1-attributes>Attributes<a href=#trestle.oscal.assessment_results.LocalDefinitions1-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions1.assessment_assets class="doc doc-heading"> <code class="highlight language-python"><span class=n>assessment_assets</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentAssets</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-assets&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.assessment_assets class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions1.components class="doc doc-heading"> <code class="highlight language-python"><span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions1.inventory_items class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory_items</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>InventoryItem</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;inventory-items&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.inventory_items class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions1.tasks class="doc doc-heading"> <code class="highlight language-python"><span class=n>tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Task</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.tasks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions1.users class="doc doc-heading"> <code class="highlight language-python"><span class=n>users</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemUser</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.users class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_results.LocalDefinitions1-classes>Classes<a href=#trestle.oscal.assessment_results.LocalDefinitions1-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_results.LocalDefinitions1.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>50</span>
+<span class=normal>51</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_results.LocalDefinitions1.Config-attributes>Attributes<a href=#trestle.oscal.assessment_results.LocalDefinitions1.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_results.LocalDefinitions1.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.LocalDefinitions1.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_results.Model class="doc doc-heading"> <code>Model</code> <a href=#trestle.oscal.assessment_results.Model class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>229</span>
+<span class=normal>230</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Model</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>assessment_results</span><span class=p>:</span> <span class=n>AssessmentResults</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-results&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_results.Model-attributes>Attributes<a href=#trestle.oscal.assessment_results.Model-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Model.assessment_results class="doc doc-heading"> <code class="highlight language-python"><span class=n>assessment_results</span><span class=p>:</span> <span class=n>AssessmentResults</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-results&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Model.assessment_results class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.assessment_results.Result class="doc doc-heading"> <code>Result</code> <a href=#trestle.oscal.assessment_results.Result class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used by the assessment results and POA&amp;M. In the assessment results, this identifies all of the assessment observations and findings, initial and residual risks, deviations, and disposition. In the POA&amp;M, this identifies initial and residual risks, deviations, and disposition.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Result</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used by the assessment results and POA&amp;M. In the assessment results, this identifies all of the assessment observations and findings, initial and residual risks, deviations, and disposition. In the POA&amp;M, this identifies initial and residual risks, deviations, and disposition.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this set of results in this or other OSCAL instances. The locally defined UUID of the assessment result can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Results Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this set of results.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Results Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this set of test results.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Results Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>start</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Date/time stamp identifying the start of the evidence collection reflected in these results.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;start field&#39;</span>
+    <span class=p>)</span>
+    <span class=n>end</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Date/time stamp identifying the end of the evidence collection reflected in these results. In a continuous motoring scenario, this may contain the same value as start if appropriate.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;end field&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>local_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>LocalDefinitions1</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;local-definitions&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Local Definitions&#39;</span>
+    <span class=p>)</span>
+    <span class=n>reviewed_controls</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ReviewedControls</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;reviewed-controls&#39;</span><span class=p>)</span>
+    <span class=n>attestations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Attestation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>assessment_log</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AssessmentLog</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-log&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A log of all assessment-related actions taken.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Log&#39;</span>
+    <span class=p>)</span>
+    <span class=n>observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Observation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>risks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Risk</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>findings</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Finding</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.assessment_results.Result-attributes>Attributes<a href=#trestle.oscal.assessment_results.Result-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.assessment_log class="doc doc-heading"> <code class="highlight language-python"><span class=n>assessment_log</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AssessmentLog</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-log&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A log of all assessment-related actions taken.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Log&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.assessment_log class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.attestations class="doc doc-heading"> <code class="highlight language-python"><span class=n>attestations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Attestation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.attestations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this set of test results.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Results Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.end class="doc doc-heading"> <code class="highlight language-python"><span class=n>end</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Date/time stamp identifying the end of the evidence collection reflected in these results. In a continuous motoring scenario, this may contain the same value as start if appropriate.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;end field&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.end class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.findings class="doc doc-heading"> <code class="highlight language-python"><span class=n>findings</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Finding</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.findings class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.local_definitions class="doc doc-heading"> <code class="highlight language-python"><span class=n>local_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>LocalDefinitions1</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;local-definitions&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Local Definitions&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.local_definitions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.observations class="doc doc-heading"> <code class="highlight language-python"><span class=n>observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Observation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.observations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.reviewed_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>reviewed_controls</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>ReviewedControls</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;reviewed-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.reviewed_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.risks class="doc doc-heading"> <code class="highlight language-python"><span class=n>risks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Risk</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.risks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.start class="doc doc-heading"> <code class="highlight language-python"><span class=n>start</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Date/time stamp identifying the start of the evidence collection reflected in these results.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;start field&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.start class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this set of results.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Results Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.assessment_results.Result.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this set of results in this or other OSCAL instances. The locally defined UUID of the assessment result can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Results Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.assessment_results.Result-classes>Classes<a href=#trestle.oscal.assessment_results.Result-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.assessment_results.Result.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.assessment_results.Result.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/assessment_results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>151</span>
+<span class=normal>152</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.assessment_results.Result.Config-attributes>Attributes<a href=#trestle.oscal.assessment_results.Result.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.assessment_results.Result.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.assessment_results.Result.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/oscal/catalog/index.html b/latest/reference/API/trestle/oscal/catalog/index.html
new file mode 100644
index 000000000..6568fd7ff
--- /dev/null
+++ b/latest/reference/API/trestle/oscal/catalog/index.html
@@ -0,0 +1,194 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.oscal.catalog module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/catalog/ rel=canonical><link href=../assessment_results/ rel=prev><link href=../common/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.oscal.catalog - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.oscal.catalog - Compliance Trestle"><meta property=og:description content="Documentation for trestle.oscal.catalog module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/catalog.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/catalog/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.oscal.catalog - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.oscal.catalog module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/catalog.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.oscal.catalog class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.oscal.catalog </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4 checked> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.oscal.catalog </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.catalog class=md-nav__link> <span class=md-ellipsis> catalog </span> </a> <nav class=md-nav aria-label=catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog class=md-nav__link> <span class=md-ellipsis> Catalog </span> </a> <nav class=md-nav aria-label=Catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.controls class=md-nav__link> <span class=md-ellipsis> controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.groups class=md-nav__link> <span class=md-ellipsis> groups </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control class=md-nav__link> <span class=md-ellipsis> Control </span> </a> <nav class=md-nav aria-label=Control> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.controls class=md-nav__link> <span class=md-ellipsis> controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group class=md-nav__link> <span class=md-ellipsis> Group </span> </a> <nav class=md-nav aria-label=Group> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.controls class=md-nav__link> <span class=md-ellipsis> controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.groups class=md-nav__link> <span class=md-ellipsis> groups </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Model.catalog class=md-nav__link> <span class=md-ellipsis> catalog </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.catalog class=md-nav__link> <span class=md-ellipsis> catalog </span> </a> <nav class=md-nav aria-label=catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog class=md-nav__link> <span class=md-ellipsis> Catalog </span> </a> <nav class=md-nav aria-label=Catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.controls class=md-nav__link> <span class=md-ellipsis> controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.groups class=md-nav__link> <span class=md-ellipsis> groups </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Catalog.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control class=md-nav__link> <span class=md-ellipsis> Control </span> </a> <nav class=md-nav aria-label=Control> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.controls class=md-nav__link> <span class=md-ellipsis> controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Control.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group class=md-nav__link> <span class=md-ellipsis> Group </span> </a> <nav class=md-nav aria-label=Group> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.controls class=md-nav__link> <span class=md-ellipsis> controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.groups class=md-nav__link> <span class=md-ellipsis> groups </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Group.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.catalog.Model.catalog class=md-nav__link> <span class=md-ellipsis> catalog </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.oscal.catalog</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.oscal.catalog class="doc doc-heading"> <code>trestle.oscal.catalog</code> <a href=#trestle.oscal.catalog class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <div class="doc doc-children"> <h3 id=trestle.oscal.catalog-attributes>Attributes<a href=#trestle.oscal.catalog-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.oscal.catalog-classes>Classes<a href=#trestle.oscal.catalog-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.catalog.Catalog class="doc doc-heading"> <code>Catalog</code> <a href=#trestle.oscal.catalog.Catalog class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A structured, organized collection of control information.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Catalog</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A structured, organized collection of control information.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+                 <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+                     <span class=o>...</span><span class=p>,</span>
+                     <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given catalog instance.&#39;</span><span class=p>,</span>
+                     <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Catalog Universally Unique Identifier&#39;</span>
+                 <span class=p>)</span>
+    <span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span>
+    <span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Control</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>groups</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Group</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.catalog.Catalog-attributes>Attributes<a href=#trestle.oscal.catalog.Catalog-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Catalog.back_matter class="doc doc-heading"> <code class="highlight language-python"><span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Catalog.back_matter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Catalog.controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Control</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Catalog.controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Catalog.groups class="doc doc-heading"> <code class="highlight language-python"><span class=n>groups</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Group</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Catalog.groups class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Catalog.metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Catalog.metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Catalog.params class="doc doc-heading"> <code class="highlight language-python"><span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Catalog.params class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Catalog.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given catalog instance.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Catalog Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Catalog.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.catalog.Catalog-classes>Classes<a href=#trestle.oscal.catalog.Catalog-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.catalog.Catalog.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.catalog.Catalog.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.catalog.Catalog.Config-attributes>Attributes<a href=#trestle.oscal.catalog.Catalog.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.catalog.Catalog.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Catalog.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.catalog.Control class="doc doc-heading"> <code>Control</code> <a href=#trestle.oscal.catalog.Control class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A structured object representing a requirement or guideline, which when implemented will reduce an aspect of risk related to an information system and its information.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Control</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A structured object representing a requirement or guideline, which when implemented will reduce an aspect of risk related to an information system and its information.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Identifies a control such that it can be referenced in the defining catalog and other OSCAL instances (e.g., profiles).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label that provides a sub-type or characterization of the control.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Class&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the control, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Control</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.catalog.Control-attributes>Attributes<a href=#trestle.oscal.catalog.Control-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Control.class_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label that provides a sub-type or characterization of the control.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Class&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Control.class_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Control.controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Control</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Control.controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Control.id class="doc doc-heading"> <code class="highlight language-python"><span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies a control such that it can be referenced in the defining catalog and other OSCAL instances (e.g., profiles).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Control.id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Control.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Control.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Control.params class="doc doc-heading"> <code class="highlight language-python"><span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Control.params class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Control.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Control.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Control.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Control.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Control.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the control, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Control.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.catalog.Control-classes>Classes<a href=#trestle.oscal.catalog.Control-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.catalog.Control.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.catalog.Control.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>44</span>
+<span class=normal>45</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.catalog.Control.Config-attributes>Attributes<a href=#trestle.oscal.catalog.Control.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.catalog.Control.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Control.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.catalog.Group class="doc doc-heading"> <code>Group</code> <a href=#trestle.oscal.catalog.Group class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A group of controls, or of groups of controls.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Group</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A group of controls, or of groups of controls.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Identifies the group for the purpose of cross-linking within the defining instance or from other instances that reference the catalog.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label that provides a sub-type or characterization of the group.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Class&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the group, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>groups</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Group</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Control</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.catalog.Group-attributes>Attributes<a href=#trestle.oscal.catalog.Group-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Group.class_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label that provides a sub-type or characterization of the group.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Class&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.class_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Group.controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Control</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Group.groups class="doc doc-heading"> <code class="highlight language-python"><span class=n>groups</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Group</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.groups class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Group.id class="doc doc-heading"> <code class="highlight language-python"><span class=nb>id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the group for the purpose of cross-linking within the defining instance or from other instances that reference the catalog.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Group.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Group.params class="doc doc-heading"> <code class="highlight language-python"><span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.params class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Group.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Group.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Group.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the group, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.catalog.Group-classes>Classes<a href=#trestle.oscal.catalog.Group-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.catalog.Group.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.catalog.Group.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>82</span>
+<span class=normal>83</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.catalog.Group.Config-attributes>Attributes<a href=#trestle.oscal.catalog.Group.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.catalog.Group.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Group.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.catalog.Model class="doc doc-heading"> <code>Model</code> <a href=#trestle.oscal.catalog.Model class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>137</span>
+<span class=normal>138</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Model</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>catalog</span><span class=p>:</span> <span class=n>Catalog</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.catalog.Model-attributes>Attributes<a href=#trestle.oscal.catalog.Model-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.catalog.Model.catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>catalog</span><span class=p>:</span> <span class=n>Catalog</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.catalog.Model.catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/oscal/common/index.html b/latest/reference/API/trestle/oscal/common/index.html
new file mode 100644
index 000000000..5f397d1ea
--- /dev/null
+++ b/latest/reference/API/trestle/oscal/common/index.html
@@ -0,0 +1,4598 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.oscal.common module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/common/ rel=canonical><link href=../catalog/ rel=prev><link href=../component/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.oscal.common - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.oscal.common - Compliance Trestle"><meta property=og:description content="Documentation for trestle.oscal.common module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/common.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/common/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.oscal.common - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.oscal.common module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/common.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.oscal.common class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.oscal.common </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4 checked> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.oscal.common </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.oscal.common </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.common class=md-nav__link> <span class=md-ellipsis> common </span> </a> <nav class=md-nav aria-label=common> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.HowMany class=md-nav__link> <span class=md-ellipsis> HowMany </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Action class=md-nav__link> <span class=md-ellipsis> Action </span> </a> <nav class=md-nav aria-label=Action> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Action-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.date class=md-nav__link> <span class=md-ellipsis> date </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity class=md-nav__link> <span class=md-ellipsis> Activity </span> </a> <nav class=md-nav aria-label=Activity> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.related_controls class=md-nav__link> <span class=md-ellipsis> related_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.steps class=md-nav__link> <span class=md-ellipsis> steps </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AddrLine class=md-nav__link> <span class=md-ellipsis> AddrLine </span> </a> <nav class=md-nav aria-label=AddrLine> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AddrLine-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AddrLine.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address class=md-nav__link> <span class=md-ellipsis> Address </span> </a> <nav class=md-nav aria-label=Address> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Address-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.addr_lines class=md-nav__link> <span class=md-ellipsis> addr_lines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.city class=md-nav__link> <span class=md-ellipsis> city </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.country class=md-nav__link> <span class=md-ellipsis> country </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.postal_code class=md-nav__link> <span class=md-ellipsis> postal_code </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AddressTypeValidValues class=md-nav__link> <span class=md-ellipsis> AddressTypeValidValues </span> </a> <nav class=md-nav aria-label=AddressTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AddressTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AddressTypeValidValues.home class=md-nav__link> <span class=md-ellipsis> home </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AddressTypeValidValues.work class=md-nav__link> <span class=md-ellipsis> work </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm class=md-nav__link> <span class=md-ellipsis> Algorithm </span> </a> <nav class=md-nav aria-label=Algorithm> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA3_224 class=md-nav__link> <span class=md-ellipsis> SHA3_224 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA3_256 class=md-nav__link> <span class=md-ellipsis> SHA3_256 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA3_384 class=md-nav__link> <span class=md-ellipsis> SHA3_384 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA3_512 class=md-nav__link> <span class=md-ellipsis> SHA3_512 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA_224 class=md-nav__link> <span class=md-ellipsis> SHA_224 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA_256 class=md-nav__link> <span class=md-ellipsis> SHA_256 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA_384 class=md-nav__link> <span class=md-ellipsis> SHA_384 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA_512 class=md-nav__link> <span class=md-ellipsis> SHA_512 </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets class=md-nav__link> <span class=md-ellipsis> AssessmentAssets </span> </a> <nav class=md-nav aria-label=AssessmentAssets> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets.assessment_platforms class=md-nav__link> <span class=md-ellipsis> assessment_platforms </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart class=md-nav__link> <span class=md-ellipsis> AssessmentPart </span> </a> <nav class=md-nav aria-label=AssessmentPart> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform class=md-nav__link> <span class=md-ellipsis> AssessmentPlatform </span> </a> <nav class=md-nav aria-label=AssessmentPlatform> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.uses_components class=md-nav__link> <span class=md-ellipsis> uses_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject class=md-nav__link> <span class=md-ellipsis> AssessmentSubject </span> </a> <nav class=md-nav aria-label=AssessmentSubject> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.exclude_subjects class=md-nav__link> <span class=md-ellipsis> exclude_subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.include_subjects class=md-nav__link> <span class=md-ellipsis> include_subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder class=md-nav__link> <span class=md-ellipsis> AssessmentSubjectPlaceholder </span> </a> <nav class=md-nav aria-label=AssessmentSubjectPlaceholder> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.sources class=md-nav__link> <span class=md-ellipsis> sources </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues class=md-nav__link> <span class=md-ellipsis> AssessmentSubjectValidValues </span> </a> <nav class=md-nav aria-label=AssessmentSubjectValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.inventory_item class=md-nav__link> <span class=md-ellipsis> inventory_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.location class=md-nav__link> <span class=md-ellipsis> location </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.party class=md-nav__link> <span class=md-ellipsis> party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.user class=md-nav__link> <span class=md-ellipsis> user </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity class=md-nav__link> <span class=md-ellipsis> AssociatedActivity </span> </a> <nav class=md-nav aria-label=AssociatedActivity> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.activity_uuid class=md-nav__link> <span class=md-ellipsis> activity_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency class=md-nav__link> <span class=md-ellipsis> AtFrequency </span> </a> <nav class=md-nav aria-label=AtFrequency> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency.period class=md-nav__link> <span class=md-ellipsis> period </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency.unit class=md-nav__link> <span class=md-ellipsis> unit </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege class=md-nav__link> <span class=md-ellipsis> AuthorizedPrivilege </span> </a> <nav class=md-nav aria-label=AuthorizedPrivilege> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege.functions_performed class=md-nav__link> <span class=md-ellipsis> functions_performed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter class=md-nav__link> <span class=md-ellipsis> BackMatter </span> </a> <nav class=md-nav aria-label=BackMatter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter.resources class=md-nav__link> <span class=md-ellipsis> resources </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64 class=md-nav__link> <span class=md-ellipsis> Base64 </span> </a> <nav class=md-nav aria-label=Base64> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64.filename class=md-nav__link> <span class=md-ellipsis> filename </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64.media_type class=md-nav__link> <span class=md-ellipsis> media_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64.value class=md-nav__link> <span class=md-ellipsis> value </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64Datatype class=md-nav__link> <span class=md-ellipsis> Base64Datatype </span> </a> <nav class=md-nav aria-label=Base64Datatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64Datatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64Datatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization class=md-nav__link> <span class=md-ellipsis> Characterization </span> </a> <nav class=md-nav aria-label=Characterization> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.facets class=md-nav__link> <span class=md-ellipsis> facets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.origin class=md-nav__link> <span class=md-ellipsis> origin </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation class=md-nav__link> <span class=md-ellipsis> Citation </span> </a> <nav class=md-nav aria-label=Citation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation.text class=md-nav__link> <span class=md-ellipsis> text </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection class=md-nav__link> <span class=md-ellipsis> ControlObjectiveSelection </span> </a> <nav class=md-nav aria-label=ControlObjectiveSelection> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.exclude_objectives class=md-nav__link> <span class=md-ellipsis> exclude_objectives </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.include_objectives class=md-nav__link> <span class=md-ellipsis> include_objectives </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection class=md-nav__link> <span class=md-ellipsis> ControlSelection </span> </a> <nav class=md-nav aria-label=ControlSelection> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.exclude_controls class=md-nav__link> <span class=md-ellipsis> exclude_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.include_controls class=md-nav__link> <span class=md-ellipsis> include_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DateTimeWithTimezoneDatatype class=md-nav__link> <span class=md-ellipsis> DateTimeWithTimezoneDatatype </span> </a> <nav class=md-nav aria-label=DateTimeWithTimezoneDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DateTimeWithTimezoneDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DateTimeWithTimezoneDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency class=md-nav__link> <span class=md-ellipsis> Dependency </span> </a> <nav class=md-nav aria-label=Dependency> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency.task_uuid class=md-nav__link> <span class=md-ellipsis> task_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId class=md-nav__link> <span class=md-ellipsis> DocumentId </span> </a> <nav class=md-nav aria-label=DocumentId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId.identifier class=md-nav__link> <span class=md-ellipsis> identifier </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId.scheme class=md-nav__link> <span class=md-ellipsis> scheme </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentSchemeValidValues class=md-nav__link> <span class=md-ellipsis> DocumentSchemeValidValues </span> </a> <nav class=md-nav aria-label=DocumentSchemeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentSchemeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentSchemeValidValues.http___www_doi_org_ class=md-nav__link> <span class=md-ellipsis> http___www_doi_org_ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.EmailAddress class=md-nav__link> <span class=md-ellipsis> EmailAddress </span> </a> <nav class=md-nav aria-label=EmailAddress> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.EmailAddress-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.EmailAddress.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.EmailAddressDatatype class=md-nav__link> <span class=md-ellipsis> EmailAddressDatatype </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry class=md-nav__link> <span class=md-ellipsis> Entry </span> </a> <nav class=md-nav aria-label=Entry> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.logged_by class=md-nav__link> <span class=md-ellipsis> logged_by </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.related_responses class=md-nav__link> <span class=md-ellipsis> related_responses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.status_change class=md-nav__link> <span class=md-ellipsis> status_change </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId class=md-nav__link> <span class=md-ellipsis> ExternalId </span> </a> <nav class=md-nav aria-label=ExternalId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId.scheme class=md-nav__link> <span class=md-ellipsis> scheme </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalSchemeValidValues class=md-nav__link> <span class=md-ellipsis> ExternalSchemeValidValues </span> </a> <nav class=md-nav aria-label=ExternalSchemeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalSchemeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalSchemeValidValues.http___orcid_org_ class=md-nav__link> <span class=md-ellipsis> http___orcid_org_ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet class=md-nav__link> <span class=md-ellipsis> Facet </span> </a> <nav class=md-nav aria-label=Facet> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.value class=md-nav__link> <span class=md-ellipsis> value </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding class=md-nav__link> <span class=md-ellipsis> Finding </span> </a> <nav class=md-nav aria-label=Finding> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.implementation_statement_uuid class=md-nav__link> <span class=md-ellipsis> implementation_statement_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.related_observations class=md-nav__link> <span class=md-ellipsis> related_observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.related_risks class=md-nav__link> <span class=md-ellipsis> related_risks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.target class=md-nav__link> <span class=md-ellipsis> target </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget class=md-nav__link> <span class=md-ellipsis> FindingTarget </span> </a> <nav class=md-nav aria-label=FindingTarget> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.implementation_status class=md-nav__link> <span class=md-ellipsis> implementation_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.target_id class=md-nav__link> <span class=md-ellipsis> target_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTargetTypeValidValues class=md-nav__link> <span class=md-ellipsis> FindingTargetTypeValidValues </span> </a> <nav class=md-nav aria-label=FindingTargetTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTargetTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTargetTypeValidValues.objective_id class=md-nav__link> <span class=md-ellipsis> objective_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTargetTypeValidValues.statement_id class=md-nav__link> <span class=md-ellipsis> statement_id </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FunctionPerformed class=md-nav__link> <span class=md-ellipsis> FunctionPerformed </span> </a> <nav class=md-nav aria-label=FunctionPerformed> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FunctionPerformed-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FunctionPerformed.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash class=md-nav__link> <span class=md-ellipsis> Hash </span> </a> <nav class=md-nav aria-label=Hash> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash.algorithm class=md-nav__link> <span class=md-ellipsis> algorithm </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash.value class=md-nav__link> <span class=md-ellipsis> value </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.HowManyValidValues class=md-nav__link> <span class=md-ellipsis> HowManyValidValues </span> </a> <nav class=md-nav aria-label=HowManyValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.HowManyValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.HowManyValidValues.one class=md-nav__link> <span class=md-ellipsis> one </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.HowManyValidValues.one_or_more class=md-nav__link> <span class=md-ellipsis> one_or_more </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject class=md-nav__link> <span class=md-ellipsis> IdentifiedSubject </span> </a> <nav class=md-nav aria-label=IdentifiedSubject> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject.subject_placeholder_uuid class=md-nav__link> <span class=md-ellipsis> subject_placeholder_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType class=md-nav__link> <span class=md-ellipsis> IdentifierType </span> </a> <nav class=md-nav aria-label=IdentifierType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType.http___fedramp_gov_ns_oscal class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov_ns_oscal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType.http___ietf_org_rfc_rfc4122 class=md-nav__link> <span class=md-ellipsis> http___ietf_org_rfc_rfc4122 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType.https___fedramp_gov class=md-nav__link> <span class=md-ellipsis> https___fedramp_gov </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType.https___ietf_org_rfc_rfc4122 class=md-nav__link> <span class=md-ellipsis> https___ietf_org_rfc_rfc4122 </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus class=md-nav__link> <span class=md-ellipsis> ImplementationStatus </span> </a> <nav class=md-nav aria-label=ImplementationStatus> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent class=md-nav__link> <span class=md-ellipsis> ImplementedComponent </span> </a> <nav class=md-nav aria-label=ImplementedComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp class=md-nav__link> <span class=md-ellipsis> ImportSsp </span> </a> <nav class=md-nav aria-label=ImportSsp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IncludeAll class=md-nav__link> <span class=md-ellipsis> IncludeAll </span> </a> <nav class=md-nav aria-label=IncludeAll> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IncludeAll-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IncludeAll.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IntegerDatatype class=md-nav__link> <span class=md-ellipsis> IntegerDatatype </span> </a> <nav class=md-nav aria-label=IntegerDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IntegerDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IntegerDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem class=md-nav__link> <span class=md-ellipsis> InventoryItem </span> </a> <nav class=md-nav aria-label=InventoryItem> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.implemented_components class=md-nav__link> <span class=md-ellipsis> implemented_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.JsonSchemaDirective class=md-nav__link> <span class=md-ellipsis> JsonSchemaDirective </span> </a> <nav class=md-nav aria-label=JsonSchemaDirective> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.JsonSchemaDirective-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.JsonSchemaDirective.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LastModified class=md-nav__link> <span class=md-ellipsis> LastModified </span> </a> <nav class=md-nav aria-label=LastModified> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LastModified-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LastModified.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle class=md-nav__link> <span class=md-ellipsis> Lifecycle </span> </a> <nav class=md-nav aria-label=Lifecycle> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle.completed class=md-nav__link> <span class=md-ellipsis> completed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle.planned class=md-nav__link> <span class=md-ellipsis> planned </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle.recommendation class=md-nav__link> <span class=md-ellipsis> recommendation </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link class=md-nav__link> <span class=md-ellipsis> Link </span> </a> <nav class=md-nav aria-label=Link> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Link-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.media_type class=md-nav__link> <span class=md-ellipsis> media_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.rel class=md-nav__link> <span class=md-ellipsis> rel </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.resource_fragment class=md-nav__link> <span class=md-ellipsis> resource_fragment </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.text class=md-nav__link> <span class=md-ellipsis> text </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective class=md-nav__link> <span class=md-ellipsis> LocalObjective </span> </a> <nav class=md-nav aria-label=LocalObjective> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location class=md-nav__link> <span class=md-ellipsis> Location </span> </a> <nav class=md-nav aria-label=Location> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Location-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.address class=md-nav__link> <span class=md-ellipsis> address </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.email_addresses class=md-nav__link> <span class=md-ellipsis> email_addresses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.telephone_numbers class=md-nav__link> <span class=md-ellipsis> telephone_numbers </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.urls class=md-nav__link> <span class=md-ellipsis> urls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocationUuid class=md-nav__link> <span class=md-ellipsis> LocationUuid </span> </a> <nav class=md-nav aria-label=LocationUuid> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocationUuid-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocationUuid.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy class=md-nav__link> <span class=md-ellipsis> LoggedBy </span> </a> <nav class=md-nav aria-label=LoggedBy> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy.party_uuid class=md-nav__link> <span class=md-ellipsis> party_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy.role_id class=md-nav__link> <span class=md-ellipsis> role_id </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata class=md-nav__link> <span class=md-ellipsis> Metadata </span> </a> <nav class=md-nav aria-label=Metadata> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.actions class=md-nav__link> <span class=md-ellipsis> actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.document_ids class=md-nav__link> <span class=md-ellipsis> document_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.last_modified class=md-nav__link> <span class=md-ellipsis> last_modified </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.locations class=md-nav__link> <span class=md-ellipsis> locations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.oscal_version class=md-nav__link> <span class=md-ellipsis> oscal_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.parties class=md-nav__link> <span class=md-ellipsis> parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.published class=md-nav__link> <span class=md-ellipsis> published </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.revisions class=md-nav__link> <span class=md-ellipsis> revisions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.roles class=md-nav__link> <span class=md-ellipsis> roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods class=md-nav__link> <span class=md-ellipsis> Methods </span> </a> <nav class=md-nav aria-label=Methods> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods.EXAMINE class=md-nav__link> <span class=md-ellipsis> EXAMINE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods.INTERVIEW class=md-nav__link> <span class=md-ellipsis> INTERVIEW </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods.TEST class=md-nav__link> <span class=md-ellipsis> TEST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods.UNKNOWN class=md-nav__link> <span class=md-ellipsis> UNKNOWN </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor class=md-nav__link> <span class=md-ellipsis> MitigatingFactor </span> </a> <nav class=md-nav aria-label=MitigatingFactor> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.implementation_uuid class=md-nav__link> <span class=md-ellipsis> implementation_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Name class=md-nav__link> <span class=md-ellipsis> Name </span> </a> <nav class=md-nav aria-label=Name> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Name-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Name.asset class=md-nav__link> <span class=md-ellipsis> asset </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Name.method class=md-nav__link> <span class=md-ellipsis> method </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Name.objective class=md-nav__link> <span class=md-ellipsis> objective </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues class=md-nav__link> <span class=md-ellipsis> NamingSystemValidValues </span> </a> <nav class=md-nav aria-label=NamingSystemValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal class=md-nav__link> <span class=md-ellipsis> http___csrc_nist_gov_ns_oscal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal_unknown class=md-nav__link> <span class=md-ellipsis> http___csrc_nist_gov_ns_oscal_unknown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___cve_mitre_org class=md-nav__link> <span class=md-ellipsis> http___cve_mitre_org </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov_ns_oscal class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov_ns_oscal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v2_0 class=md-nav__link> <span class=md-ellipsis> http___www_first_org_cvss_v2_0 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_0 class=md-nav__link> <span class=md-ellipsis> http___www_first_org_cvss_v3_0 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_1 class=md-nav__link> <span class=md-ellipsis> http___www_first_org_cvss_v3_1 </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NonNegativeIntegerDatatype class=md-nav__link> <span class=md-ellipsis> NonNegativeIntegerDatatype </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus class=md-nav__link> <span class=md-ellipsis> ObjectiveStatus </span> </a> <nav class=md-nav aria-label=ObjectiveStatus> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus.reason class=md-nav__link> <span class=md-ellipsis> reason </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues class=md-nav__link> <span class=md-ellipsis> ObjectiveStatusStateValidValues </span> </a> <nav class=md-nav aria-label=ObjectiveStatusStateValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues.not_satisfied class=md-nav__link> <span class=md-ellipsis> not_satisfied </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues.satisfied class=md-nav__link> <span class=md-ellipsis> satisfied </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation class=md-nav__link> <span class=md-ellipsis> Observation </span> </a> <nav class=md-nav aria-label=Observation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.collected class=md-nav__link> <span class=md-ellipsis> collected </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.expires class=md-nav__link> <span class=md-ellipsis> expires </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.methods class=md-nav__link> <span class=md-ellipsis> methods </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.relevant_evidence class=md-nav__link> <span class=md-ellipsis> relevant_evidence </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.types class=md-nav__link> <span class=md-ellipsis> types </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues class=md-nav__link> <span class=md-ellipsis> ObservationTypeValidValues </span> </a> <nav class=md-nav aria-label=ObservationTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.control_objective class=md-nav__link> <span class=md-ellipsis> control_objective </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.finding class=md-nav__link> <span class=md-ellipsis> finding </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.historic class=md-nav__link> <span class=md-ellipsis> historic </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.mitigation class=md-nav__link> <span class=md-ellipsis> mitigation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.ssp_statement_issue class=md-nav__link> <span class=md-ellipsis> ssp_statement_issue </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate class=md-nav__link> <span class=md-ellipsis> OnDate </span> </a> <nav class=md-nav aria-label=OnDate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate.date class=md-nav__link> <span class=md-ellipsis> date </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin class=md-nav__link> <span class=md-ellipsis> Origin </span> </a> <nav class=md-nav aria-label=Origin> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin.actors class=md-nav__link> <span class=md-ellipsis> actors </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin.related_tasks class=md-nav__link> <span class=md-ellipsis> related_tasks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor class=md-nav__link> <span class=md-ellipsis> OriginActor </span> </a> <nav class=md-nav aria-label=OriginActor> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.actor_uuid class=md-nav__link> <span class=md-ellipsis> actor_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.role_id class=md-nav__link> <span class=md-ellipsis> role_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues class=md-nav__link> <span class=md-ellipsis> OriginActorValidValues </span> </a> <nav class=md-nav aria-label=OriginActorValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues.assessment_platform class=md-nav__link> <span class=md-ellipsis> assessment_platform </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues.party class=md-nav__link> <span class=md-ellipsis> party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues.tool class=md-nav__link> <span class=md-ellipsis> tool </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion class=md-nav__link> <span class=md-ellipsis> OscalVersion </span> </a> <nav class=md-nav aria-label=OscalVersion> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion.oscal_version_is_valid class=md-nav__link> <span class=md-ellipsis> oscal_version_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter class=md-nav__link> <span class=md-ellipsis> Parameter </span> </a> <nav class=md-nav aria-label=Parameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.constraints class=md-nav__link> <span class=md-ellipsis> constraints </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.depends_on class=md-nav__link> <span class=md-ellipsis> depends_on </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.guidelines class=md-nav__link> <span class=md-ellipsis> guidelines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.label class=md-nav__link> <span class=md-ellipsis> label </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.select class=md-nav__link> <span class=md-ellipsis> select </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.usage class=md-nav__link> <span class=md-ellipsis> usage </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint class=md-nav__link> <span class=md-ellipsis> ParameterConstraint </span> </a> <nav class=md-nav aria-label=ParameterConstraint> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint.tests class=md-nav__link> <span class=md-ellipsis> tests </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline class=md-nav__link> <span class=md-ellipsis> ParameterGuideline </span> </a> <nav class=md-nav aria-label=ParameterGuideline> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection class=md-nav__link> <span class=md-ellipsis> ParameterSelection </span> </a> <nav class=md-nav aria-label=ParameterSelection> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection.choice class=md-nav__link> <span class=md-ellipsis> choice </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection.how_many class=md-nav__link> <span class=md-ellipsis> how_many </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterValue class=md-nav__link> <span class=md-ellipsis> ParameterValue </span> </a> <nav class=md-nav aria-label=ParameterValue> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterValue-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterValue.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part class=md-nav__link> <span class=md-ellipsis> Part </span> </a> <nav class=md-nav aria-label=Part> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Part-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party class=md-nav__link> <span class=md-ellipsis> Party </span> </a> <nav class=md-nav aria-label=Party> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Party-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.addresses class=md-nav__link> <span class=md-ellipsis> addresses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.email_addresses class=md-nav__link> <span class=md-ellipsis> email_addresses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.external_ids class=md-nav__link> <span class=md-ellipsis> external_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.location_uuids class=md-nav__link> <span class=md-ellipsis> location_uuids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.member_of_organizations class=md-nav__link> <span class=md-ellipsis> member_of_organizations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.short_name class=md-nav__link> <span class=md-ellipsis> short_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.telephone_numbers class=md-nav__link> <span class=md-ellipsis> telephone_numbers </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyTypeValidValues class=md-nav__link> <span class=md-ellipsis> PartyTypeValidValues </span> </a> <nav class=md-nav aria-label=PartyTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyTypeValidValues.organization class=md-nav__link> <span class=md-ellipsis> organization </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyTypeValidValues.person class=md-nav__link> <span class=md-ellipsis> person </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyUuid class=md-nav__link> <span class=md-ellipsis> PartyUuid </span> </a> <nav class=md-nav aria-label=PartyUuid> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyUuid-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyUuid.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange class=md-nav__link> <span class=md-ellipsis> PortRange </span> </a> <nav class=md-nav aria-label=PortRange> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange.transport class=md-nav__link> <span class=md-ellipsis> transport </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRangeValidValues class=md-nav__link> <span class=md-ellipsis> PortRangeValidValues </span> </a> <nav class=md-nav aria-label=PortRangeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRangeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRangeValidValues.TCP class=md-nav__link> <span class=md-ellipsis> TCP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRangeValidValues.UDP class=md-nav__link> <span class=md-ellipsis> UDP </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PositiveIntegerDatatype class=md-nav__link> <span class=md-ellipsis> PositiveIntegerDatatype </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property class=md-nav__link> <span class=md-ellipsis> Property </span> </a> <nav class=md-nav aria-label=Property> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Property-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.group class=md-nav__link> <span class=md-ellipsis> group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.value class=md-nav__link> <span class=md-ellipsis> value </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol class=md-nav__link> <span class=md-ellipsis> Protocol </span> </a> <nav class=md-nav aria-label=Protocol> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.port_ranges class=md-nav__link> <span class=md-ellipsis> port_ranges </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Published class=md-nav__link> <span class=md-ellipsis> Published </span> </a> <nav class=md-nav aria-label=Published> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Published-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Published.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason class=md-nav__link> <span class=md-ellipsis> Reason </span> </a> <nav class=md-nav aria-label=Reason> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason.fail class=md-nav__link> <span class=md-ellipsis> fail </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason.other class=md-nav__link> <span class=md-ellipsis> other </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason.pass_ class=md-nav__link> <span class=md-ellipsis> pass_ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rel class=md-nav__link> <span class=md-ellipsis> Rel </span> </a> <nav class=md-nav aria-label=Rel> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rel-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rel.reference class=md-nav__link> <span class=md-ellipsis> reference </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation class=md-nav__link> <span class=md-ellipsis> RelatedObservation </span> </a> <nav class=md-nav aria-label=RelatedObservation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation.observation_uuid class=md-nav__link> <span class=md-ellipsis> observation_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse class=md-nav__link> <span class=md-ellipsis> RelatedResponse </span> </a> <nav class=md-nav aria-label=RelatedResponse> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.related_tasks class=md-nav__link> <span class=md-ellipsis> related_tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.response_uuid class=md-nav__link> <span class=md-ellipsis> response_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk class=md-nav__link> <span class=md-ellipsis> RelatedRisk </span> </a> <nav class=md-nav aria-label=RelatedRisk> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk.risk_uuid class=md-nav__link> <span class=md-ellipsis> risk_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask class=md-nav__link> <span class=md-ellipsis> RelatedTask </span> </a> <nav class=md-nav aria-label=RelatedTask> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.identified_subject class=md-nav__link> <span class=md-ellipsis> identified_subject </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.task_uuid class=md-nav__link> <span class=md-ellipsis> task_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence class=md-nav__link> <span class=md-ellipsis> RelevantEvidence </span> </a> <nav class=md-nav aria-label=RelevantEvidence> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Remarks class=md-nav__link> <span class=md-ellipsis> Remarks </span> </a> <nav class=md-nav aria-label=Remarks> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Remarks-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Remarks.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset class=md-nav__link> <span class=md-ellipsis> RequiredAsset </span> </a> <nav class=md-nav aria-label=RequiredAsset> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource class=md-nav__link> <span class=md-ellipsis> Resource </span> </a> <nav class=md-nav aria-label=Resource> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.base64 class=md-nav__link> <span class=md-ellipsis> base64 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.citation class=md-nav__link> <span class=md-ellipsis> citation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.document_ids class=md-nav__link> <span class=md-ellipsis> document_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.rlinks class=md-nav__link> <span class=md-ellipsis> rlinks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response class=md-nav__link> <span class=md-ellipsis> Response </span> </a> <nav class=md-nav aria-label=Response> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Response-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.lifecycle class=md-nav__link> <span class=md-ellipsis> lifecycle </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.required_assets class=md-nav__link> <span class=md-ellipsis> required_assets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.tasks class=md-nav__link> <span class=md-ellipsis> tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty class=md-nav__link> <span class=md-ellipsis> ResponsibleParty </span> </a> <nav class=md-nav aria-label=ResponsibleParty> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.party_uuids class=md-nav__link> <span class=md-ellipsis> party_uuids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.role_id class=md-nav__link> <span class=md-ellipsis> role_id </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole class=md-nav__link> <span class=md-ellipsis> ResponsibleRole </span> </a> <nav class=md-nav aria-label=ResponsibleRole> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.party_uuids class=md-nav__link> <span class=md-ellipsis> party_uuids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.role_id class=md-nav__link> <span class=md-ellipsis> role_id </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls class=md-nav__link> <span class=md-ellipsis> ReviewedControls </span> </a> <nav class=md-nav aria-label=ReviewedControls> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.control_objective_selections class=md-nav__link> <span class=md-ellipsis> control_objective_selections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.control_selections class=md-nav__link> <span class=md-ellipsis> control_selections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision class=md-nav__link> <span class=md-ellipsis> Revision </span> </a> <nav class=md-nav aria-label=Revision> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.last_modified class=md-nav__link> <span class=md-ellipsis> last_modified </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.oscal_version class=md-nav__link> <span class=md-ellipsis> oscal_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.published class=md-nav__link> <span class=md-ellipsis> published </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk class=md-nav__link> <span class=md-ellipsis> Risk </span> </a> <nav class=md-nav aria-label=Risk> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.characterizations class=md-nav__link> <span class=md-ellipsis> characterizations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.deadline class=md-nav__link> <span class=md-ellipsis> deadline </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.mitigating_factors class=md-nav__link> <span class=md-ellipsis> mitigating_factors </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.related_observations class=md-nav__link> <span class=md-ellipsis> related_observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.remediations class=md-nav__link> <span class=md-ellipsis> remediations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.risk_log class=md-nav__link> <span class=md-ellipsis> risk_log </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.statement class=md-nav__link> <span class=md-ellipsis> statement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.threat_ids class=md-nav__link> <span class=md-ellipsis> threat_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog class=md-nav__link> <span class=md-ellipsis> RiskLog </span> </a> <nav class=md-nav aria-label=RiskLog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog.entries class=md-nav__link> <span class=md-ellipsis> entries </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatus class=md-nav__link> <span class=md-ellipsis> RiskStatus </span> </a> <nav class=md-nav aria-label=RiskStatus> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatus-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatus.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues class=md-nav__link> <span class=md-ellipsis> RiskStatusValidValues </span> </a> <nav class=md-nav aria-label=RiskStatusValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.closed class=md-nav__link> <span class=md-ellipsis> closed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.deviation_approved class=md-nav__link> <span class=md-ellipsis> deviation_approved </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.deviation_requested class=md-nav__link> <span class=md-ellipsis> deviation_requested </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.investigating class=md-nav__link> <span class=md-ellipsis> investigating </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.open class=md-nav__link> <span class=md-ellipsis> open </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.remediating class=md-nav__link> <span class=md-ellipsis> remediating </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink class=md-nav__link> <span class=md-ellipsis> Rlink </span> </a> <nav class=md-nav aria-label=Rlink> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink.hashes class=md-nav__link> <span class=md-ellipsis> hashes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink.media_type class=md-nav__link> <span class=md-ellipsis> media_type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role class=md-nav__link> <span class=md-ellipsis> Role </span> </a> <nav class=md-nav aria-label=Role> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Role-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.short_name class=md-nav__link> <span class=md-ellipsis> short_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RoleId class=md-nav__link> <span class=md-ellipsis> RoleId </span> </a> <nav class=md-nav aria-label=RoleId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RoleId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RoleId.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById class=md-nav__link> <span class=md-ellipsis> SelectControlById </span> </a> <nav class=md-nav aria-label=SelectControlById> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById.statement_ids class=md-nav__link> <span class=md-ellipsis> statement_ids </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById class=md-nav__link> <span class=md-ellipsis> SelectObjectiveById </span> </a> <nav class=md-nav aria-label=SelectObjectiveById> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById.objective_id class=md-nav__link> <span class=md-ellipsis> objective_id </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById class=md-nav__link> <span class=md-ellipsis> SelectSubjectById </span> </a> <nav class=md-nav aria-label=SelectSubjectById> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.subject_uuid class=md-nav__link> <span class=md-ellipsis> subject_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues class=md-nav__link> <span class=md-ellipsis> SelectSubjectByIdValidValues </span> </a> <nav class=md-nav aria-label=SelectSubjectByIdValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.inventory_item class=md-nav__link> <span class=md-ellipsis> inventory_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.location class=md-nav__link> <span class=md-ellipsis> location </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.party class=md-nav__link> <span class=md-ellipsis> party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.resource class=md-nav__link> <span class=md-ellipsis> resource </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.user class=md-nav__link> <span class=md-ellipsis> user </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Source class=md-nav__link> <span class=md-ellipsis> Source </span> </a> <nav class=md-nav aria-label=Source> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Source-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Source.task_uuid class=md-nav__link> <span class=md-ellipsis> task_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Source-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Source.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State class=md-nav__link> <span class=md-ellipsis> State </span> </a> <nav class=md-nav aria-label=State> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.State-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.State.alternative class=md-nav__link> <span class=md-ellipsis> alternative </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State.implemented class=md-nav__link> <span class=md-ellipsis> implemented </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State.not_applicable class=md-nav__link> <span class=md-ellipsis> not_applicable </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State.partial class=md-nav__link> <span class=md-ellipsis> partial </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State.planned class=md-nav__link> <span class=md-ellipsis> planned </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Status class=md-nav__link> <span class=md-ellipsis> Status </span> </a> <nav class=md-nav aria-label=Status> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Status-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Status.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Status.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Status-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Status.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step class=md-nav__link> <span class=md-ellipsis> Step </span> </a> <nav class=md-nav aria-label=Step> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Step-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.reviewed_controls class=md-nav__link> <span class=md-ellipsis> reviewed_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.StringDatatype class=md-nav__link> <span class=md-ellipsis> StringDatatype </span> </a> <nav class=md-nav aria-label=StringDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.StringDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.StringDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference class=md-nav__link> <span class=md-ellipsis> SubjectReference </span> </a> <nav class=md-nav aria-label=SubjectReference> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.subject_uuid class=md-nav__link> <span class=md-ellipsis> subject_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues class=md-nav__link> <span class=md-ellipsis> SubjectReferenceValidValues </span> </a> <nav class=md-nav aria-label=SubjectReferenceValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.inventory_item class=md-nav__link> <span class=md-ellipsis> inventory_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.location class=md-nav__link> <span class=md-ellipsis> location </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.party class=md-nav__link> <span class=md-ellipsis> party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.resource class=md-nav__link> <span class=md-ellipsis> resource </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.user class=md-nav__link> <span class=md-ellipsis> user </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent class=md-nav__link> <span class=md-ellipsis> SystemComponent </span> </a> <nav class=md-nav aria-label=SystemComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.protocols class=md-nav__link> <span class=md-ellipsis> protocols </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.purpose class=md-nav__link> <span class=md-ellipsis> purpose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues class=md-nav__link> <span class=md-ellipsis> SystemComponentOperationalStateValidValues </span> </a> <nav class=md-nav aria-label=SystemComponentOperationalStateValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.disposition class=md-nav__link> <span class=md-ellipsis> disposition </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.operational class=md-nav__link> <span class=md-ellipsis> operational </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.other class=md-nav__link> <span class=md-ellipsis> other </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.under_development class=md-nav__link> <span class=md-ellipsis> under_development </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues class=md-nav__link> <span class=md-ellipsis> SystemComponentTypeValidValues </span> </a> <nav class=md-nav aria-label=SystemComponentTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.guidance class=md-nav__link> <span class=md-ellipsis> guidance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.hardware class=md-nav__link> <span class=md-ellipsis> hardware </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.interconnection class=md-nav__link> <span class=md-ellipsis> interconnection </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.network class=md-nav__link> <span class=md-ellipsis> network </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.physical class=md-nav__link> <span class=md-ellipsis> physical </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.plan class=md-nav__link> <span class=md-ellipsis> plan </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.policy class=md-nav__link> <span class=md-ellipsis> policy </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.process_procedure class=md-nav__link> <span class=md-ellipsis> process_procedure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.service class=md-nav__link> <span class=md-ellipsis> service </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.software class=md-nav__link> <span class=md-ellipsis> software </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.standard class=md-nav__link> <span class=md-ellipsis> standard </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.this_system class=md-nav__link> <span class=md-ellipsis> this_system </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.validation class=md-nav__link> <span class=md-ellipsis> validation </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId class=md-nav__link> <span class=md-ellipsis> SystemId </span> </a> <nav class=md-nav aria-label=SystemId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId.identifier_type class=md-nav__link> <span class=md-ellipsis> identifier_type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser class=md-nav__link> <span class=md-ellipsis> SystemUser </span> </a> <nav class=md-nav aria-label=SystemUser> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.authorized_privileges class=md-nav__link> <span class=md-ellipsis> authorized_privileges </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.role_ids class=md-nav__link> <span class=md-ellipsis> role_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.short_name class=md-nav__link> <span class=md-ellipsis> short_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task class=md-nav__link> <span class=md-ellipsis> Task </span> </a> <nav class=md-nav aria-label=Task> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Task-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.associated_activities class=md-nav__link> <span class=md-ellipsis> associated_activities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.dependencies class=md-nav__link> <span class=md-ellipsis> dependencies </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.tasks class=md-nav__link> <span class=md-ellipsis> tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.timing class=md-nav__link> <span class=md-ellipsis> timing </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TaskValidValues class=md-nav__link> <span class=md-ellipsis> TaskValidValues </span> </a> <nav class=md-nav aria-label=TaskValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TaskValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TaskValidValues.action class=md-nav__link> <span class=md-ellipsis> action </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TaskValidValues.milestone class=md-nav__link> <span class=md-ellipsis> milestone </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber class=md-nav__link> <span class=md-ellipsis> TelephoneNumber </span> </a> <nav class=md-nav aria-label=TelephoneNumber> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber.number class=md-nav__link> <span class=md-ellipsis> number </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues class=md-nav__link> <span class=md-ellipsis> TelephoneTypeValidValues </span> </a> <nav class=md-nav aria-label=TelephoneTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues.home class=md-nav__link> <span class=md-ellipsis> home </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues.mobile class=md-nav__link> <span class=md-ellipsis> mobile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues.office class=md-nav__link> <span class=md-ellipsis> office </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Test class=md-nav__link> <span class=md-ellipsis> Test </span> </a> <nav class=md-nav aria-label=Test> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Test-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Test.expression class=md-nav__link> <span class=md-ellipsis> expression </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Test.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Test-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Test.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId class=md-nav__link> <span class=md-ellipsis> ThreatId </span> </a> <nav class=md-nav aria-label=ThreatId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatIdValidValues class=md-nav__link> <span class=md-ellipsis> ThreatIdValidValues </span> </a> <nav class=md-nav aria-label=ThreatIdValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatIdValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov_ns_oscal class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov_ns_oscal </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues class=md-nav__link> <span class=md-ellipsis> TimeUnitValidValues </span> </a> <nav class=md-nav aria-label=TimeUnitValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.days class=md-nav__link> <span class=md-ellipsis> days </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.hours class=md-nav__link> <span class=md-ellipsis> hours </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.minutes class=md-nav__link> <span class=md-ellipsis> minutes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.months class=md-nav__link> <span class=md-ellipsis> months </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.seconds class=md-nav__link> <span class=md-ellipsis> seconds </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.years class=md-nav__link> <span class=md-ellipsis> years </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing class=md-nav__link> <span class=md-ellipsis> Timing </span> </a> <nav class=md-nav aria-label=Timing> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing.at_frequency class=md-nav__link> <span class=md-ellipsis> at_frequency </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing.on_date class=md-nav__link> <span class=md-ellipsis> on_date </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing.within_date_range class=md-nav__link> <span class=md-ellipsis> within_date_range </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TokenDatatype class=md-nav__link> <span class=md-ellipsis> TokenDatatype </span> </a> <nav class=md-nav aria-label=TokenDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TokenDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TokenDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.URIDatatype class=md-nav__link> <span class=md-ellipsis> URIDatatype </span> </a> <nav class=md-nav aria-label=URIDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.URIDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.URIDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.URIReferenceDatatype class=md-nav__link> <span class=md-ellipsis> URIReferenceDatatype </span> </a> <nav class=md-nav aria-label=URIReferenceDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.URIReferenceDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.URIReferenceDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UUIDDatatype class=md-nav__link> <span class=md-ellipsis> UUIDDatatype </span> </a> <nav class=md-nav aria-label=UUIDDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UUIDDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UUIDDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent class=md-nav__link> <span class=md-ellipsis> UsesComponent </span> </a> <nav class=md-nav aria-label=UsesComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Version class=md-nav__link> <span class=md-ellipsis> Version </span> </a> <nav class=md-nav aria-label=Version> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Version-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Version.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange class=md-nav__link> <span class=md-ellipsis> WithinDateRange </span> </a> <nav class=md-nav aria-label=WithinDateRange> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.common class=md-nav__link> <span class=md-ellipsis> common </span> </a> <nav class=md-nav aria-label=common> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.HowMany class=md-nav__link> <span class=md-ellipsis> HowMany </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Action class=md-nav__link> <span class=md-ellipsis> Action </span> </a> <nav class=md-nav aria-label=Action> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Action-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.date class=md-nav__link> <span class=md-ellipsis> date </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Action-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Action.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity class=md-nav__link> <span class=md-ellipsis> Activity </span> </a> <nav class=md-nav aria-label=Activity> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.related_controls class=md-nav__link> <span class=md-ellipsis> related_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.steps class=md-nav__link> <span class=md-ellipsis> steps </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Activity.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AddrLine class=md-nav__link> <span class=md-ellipsis> AddrLine </span> </a> <nav class=md-nav aria-label=AddrLine> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AddrLine-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AddrLine.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address class=md-nav__link> <span class=md-ellipsis> Address </span> </a> <nav class=md-nav aria-label=Address> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Address-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.addr_lines class=md-nav__link> <span class=md-ellipsis> addr_lines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.city class=md-nav__link> <span class=md-ellipsis> city </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.country class=md-nav__link> <span class=md-ellipsis> country </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.postal_code class=md-nav__link> <span class=md-ellipsis> postal_code </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Address-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Address.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AddressTypeValidValues class=md-nav__link> <span class=md-ellipsis> AddressTypeValidValues </span> </a> <nav class=md-nav aria-label=AddressTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AddressTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AddressTypeValidValues.home class=md-nav__link> <span class=md-ellipsis> home </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AddressTypeValidValues.work class=md-nav__link> <span class=md-ellipsis> work </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm class=md-nav__link> <span class=md-ellipsis> Algorithm </span> </a> <nav class=md-nav aria-label=Algorithm> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA3_224 class=md-nav__link> <span class=md-ellipsis> SHA3_224 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA3_256 class=md-nav__link> <span class=md-ellipsis> SHA3_256 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA3_384 class=md-nav__link> <span class=md-ellipsis> SHA3_384 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA3_512 class=md-nav__link> <span class=md-ellipsis> SHA3_512 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA_224 class=md-nav__link> <span class=md-ellipsis> SHA_224 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA_256 class=md-nav__link> <span class=md-ellipsis> SHA_256 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA_384 class=md-nav__link> <span class=md-ellipsis> SHA_384 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Algorithm.SHA_512 class=md-nav__link> <span class=md-ellipsis> SHA_512 </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets class=md-nav__link> <span class=md-ellipsis> AssessmentAssets </span> </a> <nav class=md-nav aria-label=AssessmentAssets> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets.assessment_platforms class=md-nav__link> <span class=md-ellipsis> assessment_platforms </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentAssets.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart class=md-nav__link> <span class=md-ellipsis> AssessmentPart </span> </a> <nav class=md-nav aria-label=AssessmentPart> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPart.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform class=md-nav__link> <span class=md-ellipsis> AssessmentPlatform </span> </a> <nav class=md-nav aria-label=AssessmentPlatform> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.uses_components class=md-nav__link> <span class=md-ellipsis> uses_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentPlatform.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject class=md-nav__link> <span class=md-ellipsis> AssessmentSubject </span> </a> <nav class=md-nav aria-label=AssessmentSubject> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.exclude_subjects class=md-nav__link> <span class=md-ellipsis> exclude_subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.include_subjects class=md-nav__link> <span class=md-ellipsis> include_subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubject.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder class=md-nav__link> <span class=md-ellipsis> AssessmentSubjectPlaceholder </span> </a> <nav class=md-nav aria-label=AssessmentSubjectPlaceholder> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.sources class=md-nav__link> <span class=md-ellipsis> sources </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues class=md-nav__link> <span class=md-ellipsis> AssessmentSubjectValidValues </span> </a> <nav class=md-nav aria-label=AssessmentSubjectValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.inventory_item class=md-nav__link> <span class=md-ellipsis> inventory_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.location class=md-nav__link> <span class=md-ellipsis> location </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.party class=md-nav__link> <span class=md-ellipsis> party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.user class=md-nav__link> <span class=md-ellipsis> user </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity class=md-nav__link> <span class=md-ellipsis> AssociatedActivity </span> </a> <nav class=md-nav aria-label=AssociatedActivity> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.activity_uuid class=md-nav__link> <span class=md-ellipsis> activity_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AssociatedActivity.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency class=md-nav__link> <span class=md-ellipsis> AtFrequency </span> </a> <nav class=md-nav aria-label=AtFrequency> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency.period class=md-nav__link> <span class=md-ellipsis> period </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency.unit class=md-nav__link> <span class=md-ellipsis> unit </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AtFrequency.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege class=md-nav__link> <span class=md-ellipsis> AuthorizedPrivilege </span> </a> <nav class=md-nav aria-label=AuthorizedPrivilege> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege.functions_performed class=md-nav__link> <span class=md-ellipsis> functions_performed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.AuthorizedPrivilege.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter class=md-nav__link> <span class=md-ellipsis> BackMatter </span> </a> <nav class=md-nav aria-label=BackMatter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter.resources class=md-nav__link> <span class=md-ellipsis> resources </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.BackMatter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64 class=md-nav__link> <span class=md-ellipsis> Base64 </span> </a> <nav class=md-nav aria-label=Base64> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64.filename class=md-nav__link> <span class=md-ellipsis> filename </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64.media_type class=md-nav__link> <span class=md-ellipsis> media_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64.value class=md-nav__link> <span class=md-ellipsis> value </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64Datatype class=md-nav__link> <span class=md-ellipsis> Base64Datatype </span> </a> <nav class=md-nav aria-label=Base64Datatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64Datatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Base64Datatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization class=md-nav__link> <span class=md-ellipsis> Characterization </span> </a> <nav class=md-nav aria-label=Characterization> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.facets class=md-nav__link> <span class=md-ellipsis> facets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.origin class=md-nav__link> <span class=md-ellipsis> origin </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Characterization.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation class=md-nav__link> <span class=md-ellipsis> Citation </span> </a> <nav class=md-nav aria-label=Citation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation.text class=md-nav__link> <span class=md-ellipsis> text </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Citation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection class=md-nav__link> <span class=md-ellipsis> ControlObjectiveSelection </span> </a> <nav class=md-nav aria-label=ControlObjectiveSelection> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.exclude_objectives class=md-nav__link> <span class=md-ellipsis> exclude_objectives </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.include_objectives class=md-nav__link> <span class=md-ellipsis> include_objectives </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlObjectiveSelection.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection class=md-nav__link> <span class=md-ellipsis> ControlSelection </span> </a> <nav class=md-nav aria-label=ControlSelection> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.exclude_controls class=md-nav__link> <span class=md-ellipsis> exclude_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.include_controls class=md-nav__link> <span class=md-ellipsis> include_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ControlSelection.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DateTimeWithTimezoneDatatype class=md-nav__link> <span class=md-ellipsis> DateTimeWithTimezoneDatatype </span> </a> <nav class=md-nav aria-label=DateTimeWithTimezoneDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DateTimeWithTimezoneDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DateTimeWithTimezoneDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency class=md-nav__link> <span class=md-ellipsis> Dependency </span> </a> <nav class=md-nav aria-label=Dependency> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency.task_uuid class=md-nav__link> <span class=md-ellipsis> task_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Dependency.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId class=md-nav__link> <span class=md-ellipsis> DocumentId </span> </a> <nav class=md-nav aria-label=DocumentId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId.identifier class=md-nav__link> <span class=md-ellipsis> identifier </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId.scheme class=md-nav__link> <span class=md-ellipsis> scheme </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentId.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentSchemeValidValues class=md-nav__link> <span class=md-ellipsis> DocumentSchemeValidValues </span> </a> <nav class=md-nav aria-label=DocumentSchemeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentSchemeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.DocumentSchemeValidValues.http___www_doi_org_ class=md-nav__link> <span class=md-ellipsis> http___www_doi_org_ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.EmailAddress class=md-nav__link> <span class=md-ellipsis> EmailAddress </span> </a> <nav class=md-nav aria-label=EmailAddress> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.EmailAddress-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.EmailAddress.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.EmailAddressDatatype class=md-nav__link> <span class=md-ellipsis> EmailAddressDatatype </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry class=md-nav__link> <span class=md-ellipsis> Entry </span> </a> <nav class=md-nav aria-label=Entry> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.logged_by class=md-nav__link> <span class=md-ellipsis> logged_by </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.related_responses class=md-nav__link> <span class=md-ellipsis> related_responses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.status_change class=md-nav__link> <span class=md-ellipsis> status_change </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Entry.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId class=md-nav__link> <span class=md-ellipsis> ExternalId </span> </a> <nav class=md-nav aria-label=ExternalId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId.scheme class=md-nav__link> <span class=md-ellipsis> scheme </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalId.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalSchemeValidValues class=md-nav__link> <span class=md-ellipsis> ExternalSchemeValidValues </span> </a> <nav class=md-nav aria-label=ExternalSchemeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalSchemeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ExternalSchemeValidValues.http___orcid_org_ class=md-nav__link> <span class=md-ellipsis> http___orcid_org_ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet class=md-nav__link> <span class=md-ellipsis> Facet </span> </a> <nav class=md-nav aria-label=Facet> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.value class=md-nav__link> <span class=md-ellipsis> value </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Facet.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding class=md-nav__link> <span class=md-ellipsis> Finding </span> </a> <nav class=md-nav aria-label=Finding> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.implementation_statement_uuid class=md-nav__link> <span class=md-ellipsis> implementation_statement_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.related_observations class=md-nav__link> <span class=md-ellipsis> related_observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.related_risks class=md-nav__link> <span class=md-ellipsis> related_risks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.target class=md-nav__link> <span class=md-ellipsis> target </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Finding.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget class=md-nav__link> <span class=md-ellipsis> FindingTarget </span> </a> <nav class=md-nav aria-label=FindingTarget> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.implementation_status class=md-nav__link> <span class=md-ellipsis> implementation_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.target_id class=md-nav__link> <span class=md-ellipsis> target_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTarget.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTargetTypeValidValues class=md-nav__link> <span class=md-ellipsis> FindingTargetTypeValidValues </span> </a> <nav class=md-nav aria-label=FindingTargetTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTargetTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTargetTypeValidValues.objective_id class=md-nav__link> <span class=md-ellipsis> objective_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FindingTargetTypeValidValues.statement_id class=md-nav__link> <span class=md-ellipsis> statement_id </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.FunctionPerformed class=md-nav__link> <span class=md-ellipsis> FunctionPerformed </span> </a> <nav class=md-nav aria-label=FunctionPerformed> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FunctionPerformed-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.FunctionPerformed.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash class=md-nav__link> <span class=md-ellipsis> Hash </span> </a> <nav class=md-nav aria-label=Hash> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash.algorithm class=md-nav__link> <span class=md-ellipsis> algorithm </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash.value class=md-nav__link> <span class=md-ellipsis> value </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Hash.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.HowManyValidValues class=md-nav__link> <span class=md-ellipsis> HowManyValidValues </span> </a> <nav class=md-nav aria-label=HowManyValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.HowManyValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.HowManyValidValues.one class=md-nav__link> <span class=md-ellipsis> one </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.HowManyValidValues.one_or_more class=md-nav__link> <span class=md-ellipsis> one_or_more </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject class=md-nav__link> <span class=md-ellipsis> IdentifiedSubject </span> </a> <nav class=md-nav aria-label=IdentifiedSubject> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject.subject_placeholder_uuid class=md-nav__link> <span class=md-ellipsis> subject_placeholder_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifiedSubject.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType class=md-nav__link> <span class=md-ellipsis> IdentifierType </span> </a> <nav class=md-nav aria-label=IdentifierType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType.http___fedramp_gov_ns_oscal class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov_ns_oscal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType.http___ietf_org_rfc_rfc4122 class=md-nav__link> <span class=md-ellipsis> http___ietf_org_rfc_rfc4122 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType.https___fedramp_gov class=md-nav__link> <span class=md-ellipsis> https___fedramp_gov </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IdentifierType.https___ietf_org_rfc_rfc4122 class=md-nav__link> <span class=md-ellipsis> https___ietf_org_rfc_rfc4122 </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus class=md-nav__link> <span class=md-ellipsis> ImplementationStatus </span> </a> <nav class=md-nav aria-label=ImplementationStatus> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementationStatus.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent class=md-nav__link> <span class=md-ellipsis> ImplementedComponent </span> </a> <nav class=md-nav aria-label=ImplementedComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImplementedComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp class=md-nav__link> <span class=md-ellipsis> ImportSsp </span> </a> <nav class=md-nav aria-label=ImportSsp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ImportSsp.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IncludeAll class=md-nav__link> <span class=md-ellipsis> IncludeAll </span> </a> <nav class=md-nav aria-label=IncludeAll> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IncludeAll-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IncludeAll.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.IntegerDatatype class=md-nav__link> <span class=md-ellipsis> IntegerDatatype </span> </a> <nav class=md-nav aria-label=IntegerDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IntegerDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.IntegerDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem class=md-nav__link> <span class=md-ellipsis> InventoryItem </span> </a> <nav class=md-nav aria-label=InventoryItem> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.implemented_components class=md-nav__link> <span class=md-ellipsis> implemented_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.InventoryItem.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.JsonSchemaDirective class=md-nav__link> <span class=md-ellipsis> JsonSchemaDirective </span> </a> <nav class=md-nav aria-label=JsonSchemaDirective> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.JsonSchemaDirective-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.JsonSchemaDirective.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LastModified class=md-nav__link> <span class=md-ellipsis> LastModified </span> </a> <nav class=md-nav aria-label=LastModified> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LastModified-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LastModified.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle class=md-nav__link> <span class=md-ellipsis> Lifecycle </span> </a> <nav class=md-nav aria-label=Lifecycle> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle.completed class=md-nav__link> <span class=md-ellipsis> completed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle.planned class=md-nav__link> <span class=md-ellipsis> planned </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Lifecycle.recommendation class=md-nav__link> <span class=md-ellipsis> recommendation </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link class=md-nav__link> <span class=md-ellipsis> Link </span> </a> <nav class=md-nav aria-label=Link> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Link-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.media_type class=md-nav__link> <span class=md-ellipsis> media_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.rel class=md-nav__link> <span class=md-ellipsis> rel </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.resource_fragment class=md-nav__link> <span class=md-ellipsis> resource_fragment </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.text class=md-nav__link> <span class=md-ellipsis> text </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Link-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Link.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective class=md-nav__link> <span class=md-ellipsis> LocalObjective </span> </a> <nav class=md-nav aria-label=LocalObjective> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocalObjective.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location class=md-nav__link> <span class=md-ellipsis> Location </span> </a> <nav class=md-nav aria-label=Location> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Location-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.address class=md-nav__link> <span class=md-ellipsis> address </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.email_addresses class=md-nav__link> <span class=md-ellipsis> email_addresses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.telephone_numbers class=md-nav__link> <span class=md-ellipsis> telephone_numbers </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.urls class=md-nav__link> <span class=md-ellipsis> urls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Location-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Location.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LocationUuid class=md-nav__link> <span class=md-ellipsis> LocationUuid </span> </a> <nav class=md-nav aria-label=LocationUuid> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocationUuid-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LocationUuid.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy class=md-nav__link> <span class=md-ellipsis> LoggedBy </span> </a> <nav class=md-nav aria-label=LoggedBy> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy.party_uuid class=md-nav__link> <span class=md-ellipsis> party_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy.role_id class=md-nav__link> <span class=md-ellipsis> role_id </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.LoggedBy.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata class=md-nav__link> <span class=md-ellipsis> Metadata </span> </a> <nav class=md-nav aria-label=Metadata> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.actions class=md-nav__link> <span class=md-ellipsis> actions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.document_ids class=md-nav__link> <span class=md-ellipsis> document_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.last_modified class=md-nav__link> <span class=md-ellipsis> last_modified </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.locations class=md-nav__link> <span class=md-ellipsis> locations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.oscal_version class=md-nav__link> <span class=md-ellipsis> oscal_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.parties class=md-nav__link> <span class=md-ellipsis> parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.published class=md-nav__link> <span class=md-ellipsis> published </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.revisions class=md-nav__link> <span class=md-ellipsis> revisions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.roles class=md-nav__link> <span class=md-ellipsis> roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Metadata.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods class=md-nav__link> <span class=md-ellipsis> Methods </span> </a> <nav class=md-nav aria-label=Methods> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods.EXAMINE class=md-nav__link> <span class=md-ellipsis> EXAMINE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods.INTERVIEW class=md-nav__link> <span class=md-ellipsis> INTERVIEW </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods.TEST class=md-nav__link> <span class=md-ellipsis> TEST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Methods.UNKNOWN class=md-nav__link> <span class=md-ellipsis> UNKNOWN </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor class=md-nav__link> <span class=md-ellipsis> MitigatingFactor </span> </a> <nav class=md-nav aria-label=MitigatingFactor> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.implementation_uuid class=md-nav__link> <span class=md-ellipsis> implementation_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.MitigatingFactor.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Name class=md-nav__link> <span class=md-ellipsis> Name </span> </a> <nav class=md-nav aria-label=Name> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Name-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Name.asset class=md-nav__link> <span class=md-ellipsis> asset </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Name.method class=md-nav__link> <span class=md-ellipsis> method </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Name.objective class=md-nav__link> <span class=md-ellipsis> objective </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues class=md-nav__link> <span class=md-ellipsis> NamingSystemValidValues </span> </a> <nav class=md-nav aria-label=NamingSystemValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal class=md-nav__link> <span class=md-ellipsis> http___csrc_nist_gov_ns_oscal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal_unknown class=md-nav__link> <span class=md-ellipsis> http___csrc_nist_gov_ns_oscal_unknown </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___cve_mitre_org class=md-nav__link> <span class=md-ellipsis> http___cve_mitre_org </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov_ns_oscal class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov_ns_oscal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v2_0 class=md-nav__link> <span class=md-ellipsis> http___www_first_org_cvss_v2_0 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_0 class=md-nav__link> <span class=md-ellipsis> http___www_first_org_cvss_v3_0 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_1 class=md-nav__link> <span class=md-ellipsis> http___www_first_org_cvss_v3_1 </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.NonNegativeIntegerDatatype class=md-nav__link> <span class=md-ellipsis> NonNegativeIntegerDatatype </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus class=md-nav__link> <span class=md-ellipsis> ObjectiveStatus </span> </a> <nav class=md-nav aria-label=ObjectiveStatus> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus.reason class=md-nav__link> <span class=md-ellipsis> reason </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatus.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues class=md-nav__link> <span class=md-ellipsis> ObjectiveStatusStateValidValues </span> </a> <nav class=md-nav aria-label=ObjectiveStatusStateValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues.not_satisfied class=md-nav__link> <span class=md-ellipsis> not_satisfied </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues.satisfied class=md-nav__link> <span class=md-ellipsis> satisfied </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation class=md-nav__link> <span class=md-ellipsis> Observation </span> </a> <nav class=md-nav aria-label=Observation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.collected class=md-nav__link> <span class=md-ellipsis> collected </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.expires class=md-nav__link> <span class=md-ellipsis> expires </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.methods class=md-nav__link> <span class=md-ellipsis> methods </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.relevant_evidence class=md-nav__link> <span class=md-ellipsis> relevant_evidence </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.types class=md-nav__link> <span class=md-ellipsis> types </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Observation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues class=md-nav__link> <span class=md-ellipsis> ObservationTypeValidValues </span> </a> <nav class=md-nav aria-label=ObservationTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.control_objective class=md-nav__link> <span class=md-ellipsis> control_objective </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.finding class=md-nav__link> <span class=md-ellipsis> finding </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.historic class=md-nav__link> <span class=md-ellipsis> historic </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.mitigation class=md-nav__link> <span class=md-ellipsis> mitigation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ObservationTypeValidValues.ssp_statement_issue class=md-nav__link> <span class=md-ellipsis> ssp_statement_issue </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate class=md-nav__link> <span class=md-ellipsis> OnDate </span> </a> <nav class=md-nav aria-label=OnDate> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate.date class=md-nav__link> <span class=md-ellipsis> date </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OnDate.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin class=md-nav__link> <span class=md-ellipsis> Origin </span> </a> <nav class=md-nav aria-label=Origin> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin.actors class=md-nav__link> <span class=md-ellipsis> actors </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin.related_tasks class=md-nav__link> <span class=md-ellipsis> related_tasks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Origin.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor class=md-nav__link> <span class=md-ellipsis> OriginActor </span> </a> <nav class=md-nav aria-label=OriginActor> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.actor_uuid class=md-nav__link> <span class=md-ellipsis> actor_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.role_id class=md-nav__link> <span class=md-ellipsis> role_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActor.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues class=md-nav__link> <span class=md-ellipsis> OriginActorValidValues </span> </a> <nav class=md-nav aria-label=OriginActorValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues.assessment_platform class=md-nav__link> <span class=md-ellipsis> assessment_platform </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues.party class=md-nav__link> <span class=md-ellipsis> party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OriginActorValidValues.tool class=md-nav__link> <span class=md-ellipsis> tool </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion class=md-nav__link> <span class=md-ellipsis> OscalVersion </span> </a> <nav class=md-nav aria-label=OscalVersion> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.OscalVersion.oscal_version_is_valid class=md-nav__link> <span class=md-ellipsis> oscal_version_is_valid </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter class=md-nav__link> <span class=md-ellipsis> Parameter </span> </a> <nav class=md-nav aria-label=Parameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.constraints class=md-nav__link> <span class=md-ellipsis> constraints </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.depends_on class=md-nav__link> <span class=md-ellipsis> depends_on </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.guidelines class=md-nav__link> <span class=md-ellipsis> guidelines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.label class=md-nav__link> <span class=md-ellipsis> label </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.select class=md-nav__link> <span class=md-ellipsis> select </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.usage class=md-nav__link> <span class=md-ellipsis> usage </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Parameter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint class=md-nav__link> <span class=md-ellipsis> ParameterConstraint </span> </a> <nav class=md-nav aria-label=ParameterConstraint> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint.tests class=md-nav__link> <span class=md-ellipsis> tests </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterConstraint.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline class=md-nav__link> <span class=md-ellipsis> ParameterGuideline </span> </a> <nav class=md-nav aria-label=ParameterGuideline> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterGuideline.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection class=md-nav__link> <span class=md-ellipsis> ParameterSelection </span> </a> <nav class=md-nav aria-label=ParameterSelection> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection.choice class=md-nav__link> <span class=md-ellipsis> choice </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection.how_many class=md-nav__link> <span class=md-ellipsis> how_many </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterSelection.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterValue class=md-nav__link> <span class=md-ellipsis> ParameterValue </span> </a> <nav class=md-nav aria-label=ParameterValue> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterValue-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ParameterValue.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part class=md-nav__link> <span class=md-ellipsis> Part </span> </a> <nav class=md-nav aria-label=Part> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Part-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.prose class=md-nav__link> <span class=md-ellipsis> prose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Part-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Part.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party class=md-nav__link> <span class=md-ellipsis> Party </span> </a> <nav class=md-nav aria-label=Party> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Party-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.addresses class=md-nav__link> <span class=md-ellipsis> addresses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.email_addresses class=md-nav__link> <span class=md-ellipsis> email_addresses </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.external_ids class=md-nav__link> <span class=md-ellipsis> external_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.location_uuids class=md-nav__link> <span class=md-ellipsis> location_uuids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.member_of_organizations class=md-nav__link> <span class=md-ellipsis> member_of_organizations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.short_name class=md-nav__link> <span class=md-ellipsis> short_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.telephone_numbers class=md-nav__link> <span class=md-ellipsis> telephone_numbers </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Party-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Party.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyTypeValidValues class=md-nav__link> <span class=md-ellipsis> PartyTypeValidValues </span> </a> <nav class=md-nav aria-label=PartyTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyTypeValidValues.organization class=md-nav__link> <span class=md-ellipsis> organization </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyTypeValidValues.person class=md-nav__link> <span class=md-ellipsis> person </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyUuid class=md-nav__link> <span class=md-ellipsis> PartyUuid </span> </a> <nav class=md-nav aria-label=PartyUuid> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyUuid-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PartyUuid.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange class=md-nav__link> <span class=md-ellipsis> PortRange </span> </a> <nav class=md-nav aria-label=PortRange> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange.transport class=md-nav__link> <span class=md-ellipsis> transport </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRange.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRangeValidValues class=md-nav__link> <span class=md-ellipsis> PortRangeValidValues </span> </a> <nav class=md-nav aria-label=PortRangeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRangeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRangeValidValues.TCP class=md-nav__link> <span class=md-ellipsis> TCP </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PortRangeValidValues.UDP class=md-nav__link> <span class=md-ellipsis> UDP </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.PositiveIntegerDatatype class=md-nav__link> <span class=md-ellipsis> PositiveIntegerDatatype </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property class=md-nav__link> <span class=md-ellipsis> Property </span> </a> <nav class=md-nav aria-label=Property> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Property-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.group class=md-nav__link> <span class=md-ellipsis> group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.value class=md-nav__link> <span class=md-ellipsis> value </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Property-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Property.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol class=md-nav__link> <span class=md-ellipsis> Protocol </span> </a> <nav class=md-nav aria-label=Protocol> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.port_ranges class=md-nav__link> <span class=md-ellipsis> port_ranges </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Protocol.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Published class=md-nav__link> <span class=md-ellipsis> Published </span> </a> <nav class=md-nav aria-label=Published> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Published-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Published.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason class=md-nav__link> <span class=md-ellipsis> Reason </span> </a> <nav class=md-nav aria-label=Reason> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason.fail class=md-nav__link> <span class=md-ellipsis> fail </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason.other class=md-nav__link> <span class=md-ellipsis> other </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Reason.pass_ class=md-nav__link> <span class=md-ellipsis> pass_ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rel class=md-nav__link> <span class=md-ellipsis> Rel </span> </a> <nav class=md-nav aria-label=Rel> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rel-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rel.reference class=md-nav__link> <span class=md-ellipsis> reference </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation class=md-nav__link> <span class=md-ellipsis> RelatedObservation </span> </a> <nav class=md-nav aria-label=RelatedObservation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation.observation_uuid class=md-nav__link> <span class=md-ellipsis> observation_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedObservation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse class=md-nav__link> <span class=md-ellipsis> RelatedResponse </span> </a> <nav class=md-nav aria-label=RelatedResponse> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.related_tasks class=md-nav__link> <span class=md-ellipsis> related_tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.response_uuid class=md-nav__link> <span class=md-ellipsis> response_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedResponse.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk class=md-nav__link> <span class=md-ellipsis> RelatedRisk </span> </a> <nav class=md-nav aria-label=RelatedRisk> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk.risk_uuid class=md-nav__link> <span class=md-ellipsis> risk_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedRisk.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask class=md-nav__link> <span class=md-ellipsis> RelatedTask </span> </a> <nav class=md-nav aria-label=RelatedTask> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.identified_subject class=md-nav__link> <span class=md-ellipsis> identified_subject </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.task_uuid class=md-nav__link> <span class=md-ellipsis> task_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelatedTask.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence class=md-nav__link> <span class=md-ellipsis> RelevantEvidence </span> </a> <nav class=md-nav aria-label=RelevantEvidence> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RelevantEvidence.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Remarks class=md-nav__link> <span class=md-ellipsis> Remarks </span> </a> <nav class=md-nav aria-label=Remarks> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Remarks-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Remarks.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset class=md-nav__link> <span class=md-ellipsis> RequiredAsset </span> </a> <nav class=md-nav aria-label=RequiredAsset> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RequiredAsset.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource class=md-nav__link> <span class=md-ellipsis> Resource </span> </a> <nav class=md-nav aria-label=Resource> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.base64 class=md-nav__link> <span class=md-ellipsis> base64 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.citation class=md-nav__link> <span class=md-ellipsis> citation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.document_ids class=md-nav__link> <span class=md-ellipsis> document_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.rlinks class=md-nav__link> <span class=md-ellipsis> rlinks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Resource.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response class=md-nav__link> <span class=md-ellipsis> Response </span> </a> <nav class=md-nav aria-label=Response> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Response-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.lifecycle class=md-nav__link> <span class=md-ellipsis> lifecycle </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.required_assets class=md-nav__link> <span class=md-ellipsis> required_assets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.tasks class=md-nav__link> <span class=md-ellipsis> tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Response-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Response.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty class=md-nav__link> <span class=md-ellipsis> ResponsibleParty </span> </a> <nav class=md-nav aria-label=ResponsibleParty> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.party_uuids class=md-nav__link> <span class=md-ellipsis> party_uuids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.role_id class=md-nav__link> <span class=md-ellipsis> role_id </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleParty.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole class=md-nav__link> <span class=md-ellipsis> ResponsibleRole </span> </a> <nav class=md-nav aria-label=ResponsibleRole> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.party_uuids class=md-nav__link> <span class=md-ellipsis> party_uuids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.role_id class=md-nav__link> <span class=md-ellipsis> role_id </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ResponsibleRole.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls class=md-nav__link> <span class=md-ellipsis> ReviewedControls </span> </a> <nav class=md-nav aria-label=ReviewedControls> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.control_objective_selections class=md-nav__link> <span class=md-ellipsis> control_objective_selections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.control_selections class=md-nav__link> <span class=md-ellipsis> control_selections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ReviewedControls.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision class=md-nav__link> <span class=md-ellipsis> Revision </span> </a> <nav class=md-nav aria-label=Revision> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.last_modified class=md-nav__link> <span class=md-ellipsis> last_modified </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.oscal_version class=md-nav__link> <span class=md-ellipsis> oscal_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.published class=md-nav__link> <span class=md-ellipsis> published </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Revision.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk class=md-nav__link> <span class=md-ellipsis> Risk </span> </a> <nav class=md-nav aria-label=Risk> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.characterizations class=md-nav__link> <span class=md-ellipsis> characterizations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.deadline class=md-nav__link> <span class=md-ellipsis> deadline </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.mitigating_factors class=md-nav__link> <span class=md-ellipsis> mitigating_factors </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.related_observations class=md-nav__link> <span class=md-ellipsis> related_observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.remediations class=md-nav__link> <span class=md-ellipsis> remediations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.risk_log class=md-nav__link> <span class=md-ellipsis> risk_log </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.statement class=md-nav__link> <span class=md-ellipsis> statement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.threat_ids class=md-nav__link> <span class=md-ellipsis> threat_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Risk.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog class=md-nav__link> <span class=md-ellipsis> RiskLog </span> </a> <nav class=md-nav aria-label=RiskLog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog.entries class=md-nav__link> <span class=md-ellipsis> entries </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskLog.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatus class=md-nav__link> <span class=md-ellipsis> RiskStatus </span> </a> <nav class=md-nav aria-label=RiskStatus> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatus-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatus.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues class=md-nav__link> <span class=md-ellipsis> RiskStatusValidValues </span> </a> <nav class=md-nav aria-label=RiskStatusValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.closed class=md-nav__link> <span class=md-ellipsis> closed </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.deviation_approved class=md-nav__link> <span class=md-ellipsis> deviation_approved </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.deviation_requested class=md-nav__link> <span class=md-ellipsis> deviation_requested </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.investigating class=md-nav__link> <span class=md-ellipsis> investigating </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.open class=md-nav__link> <span class=md-ellipsis> open </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RiskStatusValidValues.remediating class=md-nav__link> <span class=md-ellipsis> remediating </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink class=md-nav__link> <span class=md-ellipsis> Rlink </span> </a> <nav class=md-nav aria-label=Rlink> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink.hashes class=md-nav__link> <span class=md-ellipsis> hashes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink.media_type class=md-nav__link> <span class=md-ellipsis> media_type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Rlink.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role class=md-nav__link> <span class=md-ellipsis> Role </span> </a> <nav class=md-nav aria-label=Role> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Role-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.short_name class=md-nav__link> <span class=md-ellipsis> short_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Role-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Role.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.RoleId class=md-nav__link> <span class=md-ellipsis> RoleId </span> </a> <nav class=md-nav aria-label=RoleId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RoleId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.RoleId.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById class=md-nav__link> <span class=md-ellipsis> SelectControlById </span> </a> <nav class=md-nav aria-label=SelectControlById> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById.statement_ids class=md-nav__link> <span class=md-ellipsis> statement_ids </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectControlById.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById class=md-nav__link> <span class=md-ellipsis> SelectObjectiveById </span> </a> <nav class=md-nav aria-label=SelectObjectiveById> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById.objective_id class=md-nav__link> <span class=md-ellipsis> objective_id </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectObjectiveById.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById class=md-nav__link> <span class=md-ellipsis> SelectSubjectById </span> </a> <nav class=md-nav aria-label=SelectSubjectById> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.subject_uuid class=md-nav__link> <span class=md-ellipsis> subject_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectById.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues class=md-nav__link> <span class=md-ellipsis> SelectSubjectByIdValidValues </span> </a> <nav class=md-nav aria-label=SelectSubjectByIdValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.inventory_item class=md-nav__link> <span class=md-ellipsis> inventory_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.location class=md-nav__link> <span class=md-ellipsis> location </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.party class=md-nav__link> <span class=md-ellipsis> party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.resource class=md-nav__link> <span class=md-ellipsis> resource </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.user class=md-nav__link> <span class=md-ellipsis> user </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Source class=md-nav__link> <span class=md-ellipsis> Source </span> </a> <nav class=md-nav aria-label=Source> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Source-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Source.task_uuid class=md-nav__link> <span class=md-ellipsis> task_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Source-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Source.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State class=md-nav__link> <span class=md-ellipsis> State </span> </a> <nav class=md-nav aria-label=State> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.State-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.State.alternative class=md-nav__link> <span class=md-ellipsis> alternative </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State.implemented class=md-nav__link> <span class=md-ellipsis> implemented </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State.not_applicable class=md-nav__link> <span class=md-ellipsis> not_applicable </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State.partial class=md-nav__link> <span class=md-ellipsis> partial </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.State.planned class=md-nav__link> <span class=md-ellipsis> planned </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Status class=md-nav__link> <span class=md-ellipsis> Status </span> </a> <nav class=md-nav aria-label=Status> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Status-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Status.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Status.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Status-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Status.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step class=md-nav__link> <span class=md-ellipsis> Step </span> </a> <nav class=md-nav aria-label=Step> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Step-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.reviewed_controls class=md-nav__link> <span class=md-ellipsis> reviewed_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Step-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Step.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.StringDatatype class=md-nav__link> <span class=md-ellipsis> StringDatatype </span> </a> <nav class=md-nav aria-label=StringDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.StringDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.StringDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference class=md-nav__link> <span class=md-ellipsis> SubjectReference </span> </a> <nav class=md-nav aria-label=SubjectReference> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.subject_uuid class=md-nav__link> <span class=md-ellipsis> subject_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReference.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues class=md-nav__link> <span class=md-ellipsis> SubjectReferenceValidValues </span> </a> <nav class=md-nav aria-label=SubjectReferenceValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.inventory_item class=md-nav__link> <span class=md-ellipsis> inventory_item </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.location class=md-nav__link> <span class=md-ellipsis> location </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.party class=md-nav__link> <span class=md-ellipsis> party </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.resource class=md-nav__link> <span class=md-ellipsis> resource </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SubjectReferenceValidValues.user class=md-nav__link> <span class=md-ellipsis> user </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent class=md-nav__link> <span class=md-ellipsis> SystemComponent </span> </a> <nav class=md-nav aria-label=SystemComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.protocols class=md-nav__link> <span class=md-ellipsis> protocols </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.purpose class=md-nav__link> <span class=md-ellipsis> purpose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues class=md-nav__link> <span class=md-ellipsis> SystemComponentOperationalStateValidValues </span> </a> <nav class=md-nav aria-label=SystemComponentOperationalStateValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.disposition class=md-nav__link> <span class=md-ellipsis> disposition </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.operational class=md-nav__link> <span class=md-ellipsis> operational </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.other class=md-nav__link> <span class=md-ellipsis> other </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.under_development class=md-nav__link> <span class=md-ellipsis> under_development </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues class=md-nav__link> <span class=md-ellipsis> SystemComponentTypeValidValues </span> </a> <nav class=md-nav aria-label=SystemComponentTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.guidance class=md-nav__link> <span class=md-ellipsis> guidance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.hardware class=md-nav__link> <span class=md-ellipsis> hardware </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.interconnection class=md-nav__link> <span class=md-ellipsis> interconnection </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.network class=md-nav__link> <span class=md-ellipsis> network </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.physical class=md-nav__link> <span class=md-ellipsis> physical </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.plan class=md-nav__link> <span class=md-ellipsis> plan </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.policy class=md-nav__link> <span class=md-ellipsis> policy </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.process_procedure class=md-nav__link> <span class=md-ellipsis> process_procedure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.service class=md-nav__link> <span class=md-ellipsis> service </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.software class=md-nav__link> <span class=md-ellipsis> software </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.standard class=md-nav__link> <span class=md-ellipsis> standard </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.this_system class=md-nav__link> <span class=md-ellipsis> this_system </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.validation class=md-nav__link> <span class=md-ellipsis> validation </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId class=md-nav__link> <span class=md-ellipsis> SystemId </span> </a> <nav class=md-nav aria-label=SystemId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId.identifier_type class=md-nav__link> <span class=md-ellipsis> identifier_type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemId.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser class=md-nav__link> <span class=md-ellipsis> SystemUser </span> </a> <nav class=md-nav aria-label=SystemUser> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.authorized_privileges class=md-nav__link> <span class=md-ellipsis> authorized_privileges </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.role_ids class=md-nav__link> <span class=md-ellipsis> role_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.short_name class=md-nav__link> <span class=md-ellipsis> short_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.SystemUser.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task class=md-nav__link> <span class=md-ellipsis> Task </span> </a> <nav class=md-nav aria-label=Task> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Task-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.associated_activities class=md-nav__link> <span class=md-ellipsis> associated_activities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.dependencies class=md-nav__link> <span class=md-ellipsis> dependencies </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.subjects class=md-nav__link> <span class=md-ellipsis> subjects </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.tasks class=md-nav__link> <span class=md-ellipsis> tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.timing class=md-nav__link> <span class=md-ellipsis> timing </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Task-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Task.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TaskValidValues class=md-nav__link> <span class=md-ellipsis> TaskValidValues </span> </a> <nav class=md-nav aria-label=TaskValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TaskValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TaskValidValues.action class=md-nav__link> <span class=md-ellipsis> action </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TaskValidValues.milestone class=md-nav__link> <span class=md-ellipsis> milestone </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber class=md-nav__link> <span class=md-ellipsis> TelephoneNumber </span> </a> <nav class=md-nav aria-label=TelephoneNumber> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber.number class=md-nav__link> <span class=md-ellipsis> number </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneNumber.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues class=md-nav__link> <span class=md-ellipsis> TelephoneTypeValidValues </span> </a> <nav class=md-nav aria-label=TelephoneTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues.home class=md-nav__link> <span class=md-ellipsis> home </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues.mobile class=md-nav__link> <span class=md-ellipsis> mobile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TelephoneTypeValidValues.office class=md-nav__link> <span class=md-ellipsis> office </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Test class=md-nav__link> <span class=md-ellipsis> Test </span> </a> <nav class=md-nav aria-label=Test> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Test-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Test.expression class=md-nav__link> <span class=md-ellipsis> expression </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Test.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Test-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Test.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId class=md-nav__link> <span class=md-ellipsis> ThreatId </span> </a> <nav class=md-nav aria-label=ThreatId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatId.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatIdValidValues class=md-nav__link> <span class=md-ellipsis> ThreatIdValidValues </span> </a> <nav class=md-nav aria-label=ThreatIdValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatIdValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov_ns_oscal class=md-nav__link> <span class=md-ellipsis> http___fedramp_gov_ns_oscal </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues class=md-nav__link> <span class=md-ellipsis> TimeUnitValidValues </span> </a> <nav class=md-nav aria-label=TimeUnitValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.days class=md-nav__link> <span class=md-ellipsis> days </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.hours class=md-nav__link> <span class=md-ellipsis> hours </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.minutes class=md-nav__link> <span class=md-ellipsis> minutes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.months class=md-nav__link> <span class=md-ellipsis> months </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.seconds class=md-nav__link> <span class=md-ellipsis> seconds </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TimeUnitValidValues.years class=md-nav__link> <span class=md-ellipsis> years </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing class=md-nav__link> <span class=md-ellipsis> Timing </span> </a> <nav class=md-nav aria-label=Timing> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing.at_frequency class=md-nav__link> <span class=md-ellipsis> at_frequency </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing.on_date class=md-nav__link> <span class=md-ellipsis> on_date </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing.within_date_range class=md-nav__link> <span class=md-ellipsis> within_date_range </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Timing.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.TokenDatatype class=md-nav__link> <span class=md-ellipsis> TokenDatatype </span> </a> <nav class=md-nav aria-label=TokenDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TokenDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.TokenDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.URIDatatype class=md-nav__link> <span class=md-ellipsis> URIDatatype </span> </a> <nav class=md-nav aria-label=URIDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.URIDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.URIDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.URIReferenceDatatype class=md-nav__link> <span class=md-ellipsis> URIReferenceDatatype </span> </a> <nav class=md-nav aria-label=URIReferenceDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.URIReferenceDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.URIReferenceDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UUIDDatatype class=md-nav__link> <span class=md-ellipsis> UUIDDatatype </span> </a> <nav class=md-nav aria-label=UUIDDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UUIDDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UUIDDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent class=md-nav__link> <span class=md-ellipsis> UsesComponent </span> </a> <nav class=md-nav aria-label=UsesComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.UsesComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.Version class=md-nav__link> <span class=md-ellipsis> Version </span> </a> <nav class=md-nav aria-label=Version> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Version-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.Version.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange class=md-nav__link> <span class=md-ellipsis> WithinDateRange </span> </a> <nav class=md-nav aria-label=WithinDateRange> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange.end class=md-nav__link> <span class=md-ellipsis> end </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange.start class=md-nav__link> <span class=md-ellipsis> start </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.common.WithinDateRange.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.oscal.common</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.oscal.common class="doc doc-heading"> <code>trestle.oscal.common</code> <a href=#trestle.oscal.common class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <div class="doc doc-children"> <h3 id=trestle.oscal.common-attributes>Attributes<a href=#trestle.oscal.common-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.oscal.common.HowMany class="doc doc-heading"> <code class="highlight language-python"><span class=n>HowMany</span> <span class=o>=</span> <span class=n>HowManyValidValues</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.oscal.common.HowMany class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.oscal.common-classes>Classes<a href=#trestle.oscal.common-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Action class="doc doc-heading"> <code>Action</code> <a href=#trestle.oscal.common.Action class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An action applied by a role within a given party to the content.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2211</span>
+<span class=normal>2212</span>
+<span class=normal>2213</span>
+<span class=normal>2214</span>
+<span class=normal>2215</span>
+<span class=normal>2216</span>
+<span class=normal>2217</span>
+<span class=normal>2218</span>
+<span class=normal>2219</span>
+<span class=normal>2220</span>
+<span class=normal>2221</span>
+<span class=normal>2222</span>
+<span class=normal>2223</span>
+<span class=normal>2224</span>
+<span class=normal>2225</span>
+<span class=normal>2226</span>
+<span class=normal>2227</span>
+<span class=normal>2228</span>
+<span class=normal>2229</span>
+<span class=normal>2230</span>
+<span class=normal>2231</span>
+<span class=normal>2232</span>
+<span class=normal>2233</span>
+<span class=normal>2234</span>
+<span class=normal>2235</span>
+<span class=normal>2236</span>
+<span class=normal>2237</span>
+<span class=normal>2238</span>
+<span class=normal>2239</span>
+<span class=normal>2240</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Action</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An action applied by a role within a given party to the content.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A unique identifier that can be used to reference this defined action elsewhere in an OSCAL document. A UUID should be consistently used for a given location across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Universally Unique Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>date</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date and time when the action occurred.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Occurrence Date&#39;</span>
+    <span class=p>)</span>
+    <span class=nb>type</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The type of action documented by the assembly, such as an approval.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>system</span><span class=p>:</span> <span class=n>AnyUrl</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Specifies the action type system used.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Type System&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Action-attributes>Attributes<a href=#trestle.oscal.common.Action-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Action.date class="doc doc-heading"> <code class="highlight language-python"><span class=n>date</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date and time when the action occurred.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Occurrence Date&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Action.date class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Action.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Action.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Action.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Action.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Action.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Action.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Action.responsible_parties class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Action.responsible_parties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Action.system class="doc doc-heading"> <code class="highlight language-python"><span class=n>system</span><span class=p>:</span> <span class=n>AnyUrl</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Specifies the action type system used.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Type System&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Action.system class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Action.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The type of action documented by the assembly, such as an approval.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Action.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Action.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier that can be used to reference this defined action elsewhere in an OSCAL document. A UUID should be consistently used for a given location across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Action Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Action.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Action-classes>Classes<a href=#trestle.oscal.common.Action-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Action.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Action.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2216</span>
+<span class=normal>2217</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Action.Config-attributes>Attributes<a href=#trestle.oscal.common.Action.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Action.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Action.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Activity class="doc doc-heading"> <code>Activity</code> <a href=#trestle.oscal.common.Activity class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies an assessment or related process that can be performed. In the assessment plan, this is an intended activity which may be associated with an assessment task. In the assessment results, this an activity that was actually performed as part of an assessment.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2357</span>
+<span class=normal>2358</span>
+<span class=normal>2359</span>
+<span class=normal>2360</span>
+<span class=normal>2361</span>
+<span class=normal>2362</span>
+<span class=normal>2363</span>
+<span class=normal>2364</span>
+<span class=normal>2365</span>
+<span class=normal>2366</span>
+<span class=normal>2367</span>
+<span class=normal>2368</span>
+<span class=normal>2369</span>
+<span class=normal>2370</span>
+<span class=normal>2371</span>
+<span class=normal>2372</span>
+<span class=normal>2373</span>
+<span class=normal>2374</span>
+<span class=normal>2375</span>
+<span class=normal>2376</span>
+<span class=normal>2377</span>
+<span class=normal>2378</span>
+<span class=normal>2379</span>
+<span class=normal>2380</span>
+<span class=normal>2381</span>
+<span class=normal>2382</span>
+<span class=normal>2383</span>
+<span class=normal>2384</span>
+<span class=normal>2385</span>
+<span class=normal>2386</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Activity</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies an assessment or related process that can be performed. In the assessment plan, this is an intended activity which may be associated with an assessment task. In the assessment results, this an activity that was actually performed as part of an assessment.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment activity elsewhere in this or other OSCAL instances. The locally defined UUID of the activity can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Activity Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this included activity.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Included Activity Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this included activity.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Included Activity Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>steps</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Step</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>related_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ReviewedControls</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-controls&#39;</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Activity-attributes>Attributes<a href=#trestle.oscal.common.Activity-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Activity.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this included activity.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Included Activity Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Activity.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Activity.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Activity.related_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ReviewedControls</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.related_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Activity.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Activity.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Activity.steps class="doc doc-heading"> <code class="highlight language-python"><span class=n>steps</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Step</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.steps class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Activity.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this included activity.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Included Activity Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Activity.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment activity elsewhere in this or other OSCAL instances. The locally defined UUID of the activity can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Activity Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Activity-classes>Classes<a href=#trestle.oscal.common.Activity-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Activity.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Activity.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2362</span>
+<span class=normal>2363</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Activity.Config-attributes>Attributes<a href=#trestle.oscal.common.Activity.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Activity.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Activity.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AddrLine class="doc doc-heading"> <code>AddrLine</code> <a href=#trestle.oscal.common.AddrLine class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1143</span>
+<span class=normal>1144</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AddrLine</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>StringDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A single line of an address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Address line&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AddrLine-attributes>Attributes<a href=#trestle.oscal.common.AddrLine-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AddrLine.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>StringDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A single line of an address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Address line&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AddrLine.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Address class="doc doc-heading"> <code>Address</code> <a href=#trestle.oscal.common.Address class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A postal address for the location.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1117</span>
+<span class=normal>1118</span>
+<span class=normal>1119</span>
+<span class=normal>1120</span>
+<span class=normal>1121</span>
+<span class=normal>1122</span>
+<span class=normal>1123</span>
+<span class=normal>1124</span>
+<span class=normal>1125</span>
+<span class=normal>1126</span>
+<span class=normal>1127</span>
+<span class=normal>1128</span>
+<span class=normal>1129</span>
+<span class=normal>1130</span>
+<span class=normal>1131</span>
+<span class=normal>1132</span>
+<span class=normal>1133</span>
+<span class=normal>1134</span>
+<span class=normal>1135</span>
+<span class=normal>1136</span>
+<span class=normal>1137</span>
+<span class=normal>1138</span>
+<span class=normal>1139</span>
+<span class=normal>1140</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Address</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A postal address for the location.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>AddressTypeValidValues</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the type of address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Address Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>addr_lines</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;addr-lines&#39;</span><span class=p>)</span>
+    <span class=n>city</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;City, town or geographical region for the mailing address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;City&#39;</span>
+    <span class=p>)</span>
+    <span class=n>state</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;State, province or analogous geographical region for a mailing address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;State&#39;</span>
+    <span class=p>)</span>
+    <span class=n>postal_code</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;postal-code&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Postal or ZIP code for mailing address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Postal Code&#39;</span>
+    <span class=p>)</span>
+    <span class=n>country</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The ISO 3166-1 alpha-2 country code for the mailing address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Country Code&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Address-attributes>Attributes<a href=#trestle.oscal.common.Address-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Address.addr_lines class="doc doc-heading"> <code class="highlight language-python"><span class=n>addr_lines</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;addr-lines&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Address.addr_lines class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Address.city class="doc doc-heading"> <code class="highlight language-python"><span class=n>city</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;City, town or geographical region for the mailing address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;City&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Address.city class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Address.country class="doc doc-heading"> <code class="highlight language-python"><span class=n>country</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The ISO 3166-1 alpha-2 country code for the mailing address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Country Code&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Address.country class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Address.postal_code class="doc doc-heading"> <code class="highlight language-python"><span class=n>postal_code</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;postal-code&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Postal or ZIP code for mailing address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Postal Code&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Address.postal_code class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Address.state class="doc doc-heading"> <code class="highlight language-python"><span class=n>state</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;State, province or analogous geographical region for a mailing address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;State&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Address.state class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Address.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>AddressTypeValidValues</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the type of address.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Address Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Address.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Address-classes>Classes<a href=#trestle.oscal.common.Address-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Address.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Address.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1122</span>
+<span class=normal>1123</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Address.Config-attributes>Attributes<a href=#trestle.oscal.common.Address.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Address.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Address.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AddressTypeValidValues class="doc doc-heading"> <code>AddressTypeValidValues</code> <a href=#trestle.oscal.common.AddressTypeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1112</span>
+<span class=normal>1113</span>
+<span class=normal>1114</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AddressTypeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>home</span> <span class=o>=</span> <span class=s1>&#39;home&#39;</span>
+    <span class=n>work</span> <span class=o>=</span> <span class=s1>&#39;work&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AddressTypeValidValues-attributes>Attributes<a href=#trestle.oscal.common.AddressTypeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AddressTypeValidValues.home class="doc doc-heading"> <code class="highlight language-python"><span class=n>home</span> <span class=o>=</span> <span class=s1>&#39;home&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AddressTypeValidValues.home class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AddressTypeValidValues.work class="doc doc-heading"> <code class="highlight language-python"><span class=n>work</span> <span class=o>=</span> <span class=s1>&#39;work&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AddressTypeValidValues.work class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Algorithm class="doc doc-heading"> <code>Algorithm</code> <a href=#trestle.oscal.common.Algorithm class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>The digest method by which a hash is derived.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1097</span>
+<span class=normal>1098</span>
+<span class=normal>1099</span>
+<span class=normal>1100</span>
+<span class=normal>1101</span>
+<span class=normal>1102</span>
+<span class=normal>1103</span>
+<span class=normal>1104</span>
+<span class=normal>1105</span>
+<span class=normal>1106</span>
+<span class=normal>1107</span>
+<span class=normal>1108</span>
+<span class=normal>1109</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Algorithm</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The digest method by which a hash is derived.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>SHA_224</span> <span class=o>=</span> <span class=s1>&#39;SHA-224&#39;</span>
+    <span class=n>SHA_256</span> <span class=o>=</span> <span class=s1>&#39;SHA-256&#39;</span>
+    <span class=n>SHA_384</span> <span class=o>=</span> <span class=s1>&#39;SHA-384&#39;</span>
+    <span class=n>SHA_512</span> <span class=o>=</span> <span class=s1>&#39;SHA-512&#39;</span>
+    <span class=n>SHA3_224</span> <span class=o>=</span> <span class=s1>&#39;SHA3-224&#39;</span>
+    <span class=n>SHA3_256</span> <span class=o>=</span> <span class=s1>&#39;SHA3-256&#39;</span>
+    <span class=n>SHA3_384</span> <span class=o>=</span> <span class=s1>&#39;SHA3-384&#39;</span>
+    <span class=n>SHA3_512</span> <span class=o>=</span> <span class=s1>&#39;SHA3-512&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Algorithm-attributes>Attributes<a href=#trestle.oscal.common.Algorithm-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Algorithm.SHA3_224 class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHA3_224</span> <span class=o>=</span> <span class=s1>&#39;SHA3-224&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Algorithm.SHA3_224 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Algorithm.SHA3_256 class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHA3_256</span> <span class=o>=</span> <span class=s1>&#39;SHA3-256&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Algorithm.SHA3_256 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Algorithm.SHA3_384 class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHA3_384</span> <span class=o>=</span> <span class=s1>&#39;SHA3-384&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Algorithm.SHA3_384 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Algorithm.SHA3_512 class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHA3_512</span> <span class=o>=</span> <span class=s1>&#39;SHA3-512&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Algorithm.SHA3_512 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Algorithm.SHA_224 class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHA_224</span> <span class=o>=</span> <span class=s1>&#39;SHA-224&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Algorithm.SHA_224 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Algorithm.SHA_256 class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHA_256</span> <span class=o>=</span> <span class=s1>&#39;SHA-256&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Algorithm.SHA_256 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Algorithm.SHA_384 class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHA_384</span> <span class=o>=</span> <span class=s1>&#39;SHA-384&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Algorithm.SHA_384 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Algorithm.SHA_512 class="doc doc-heading"> <code class="highlight language-python"><span class=n>SHA_512</span> <span class=o>=</span> <span class=s1>&#39;SHA-512&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Algorithm.SHA_512 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AssessmentAssets class="doc doc-heading"> <code>AssessmentAssets</code> <a href=#trestle.oscal.common.AssessmentAssets class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies the assets used to perform this assessment, such as the assessment team, scanning tools, and assumptions.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2320</span>
+<span class=normal>2321</span>
+<span class=normal>2322</span>
+<span class=normal>2323</span>
+<span class=normal>2324</span>
+<span class=normal>2325</span>
+<span class=normal>2326</span>
+<span class=normal>2327</span>
+<span class=normal>2328</span>
+<span class=normal>2329</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssessmentAssets</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the assets used to perform this assessment, such as the assessment team, scanning tools, and assumptions.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SystemComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>assessment_platforms</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>AssessmentPlatform</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-platforms&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AssessmentAssets-attributes>Attributes<a href=#trestle.oscal.common.AssessmentAssets-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentAssets.assessment_platforms class="doc doc-heading"> <code class="highlight language-python"><span class=n>assessment_platforms</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>AssessmentPlatform</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-platforms&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentAssets.assessment_platforms class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentAssets.components class="doc doc-heading"> <code class="highlight language-python"><span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SystemComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentAssets.components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.AssessmentAssets-classes>Classes<a href=#trestle.oscal.common.AssessmentAssets-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.AssessmentAssets.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.AssessmentAssets.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2325</span>
+<span class=normal>2326</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.AssessmentAssets.Config-attributes>Attributes<a href=#trestle.oscal.common.AssessmentAssets.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.AssessmentAssets.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentAssets.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AssessmentPart class="doc doc-heading"> <code>AssessmentPart</code> <a href=#trestle.oscal.common.AssessmentPart class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A partition of an assessment plan or results or a child of another part.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1045</span>
+<span class=normal>1046</span>
+<span class=normal>1047</span>
+<span class=normal>1048</span>
+<span class=normal>1049</span>
+<span class=normal>1050</span>
+<span class=normal>1051</span>
+<span class=normal>1052</span>
+<span class=normal>1053</span>
+<span class=normal>1054</span>
+<span class=normal>1055</span>
+<span class=normal>1056</span>
+<span class=normal>1057</span>
+<span class=normal>1058</span>
+<span class=normal>1059</span>
+<span class=normal>1060</span>
+<span class=normal>1061</span>
+<span class=normal>1062</span>
+<span class=normal>1063</span>
+<span class=normal>1064</span>
+<span class=normal>1065</span>
+<span class=normal>1066</span>
+<span class=normal>1067</span>
+<span class=normal>1068</span>
+<span class=normal>1069</span>
+<span class=normal>1070</span>
+<span class=normal>1071</span>
+<span class=normal>1072</span>
+<span class=normal>1073</span>
+<span class=normal>1074</span>
+<span class=normal>1075</span>
+<span class=normal>1076</span>
+<span class=normal>1077</span>
+<span class=normal>1078</span>
+<span class=normal>1079</span>
+<span class=normal>1080</span>
+<span class=normal>1081</span>
+<span class=normal>1082</span>
+<span class=normal>1083</span>
+<span class=normal>1084</span>
+<span class=normal>1085</span>
+<span class=normal>1086</span>
+<span class=normal>1087</span>
+<span class=normal>1088</span>
+<span class=normal>1089</span>
+<span class=normal>1090</span>
+<span class=normal>1091</span>
+<span class=normal>1092</span>
+<span class=normal>1093</span>
+<span class=normal>1094</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssessmentPart</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A partition of an assessment plan or results or a child of another part.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this part elsewhere in this or other OSCAL instances. The locally defined UUID of the part can be used to reference the data item locally or globally (e.g., in an ported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>),</span>
+                <span class=n>Name</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+                    <span class=o>...</span><span class=p>,</span>
+                    <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A textual label that uniquely identifies the part&#39;s semantic type.&quot;</span><span class=p>,</span>
+                    <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Name&#39;</span>
+                <span class=p>)</span>
+    <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A namespace qualifying the part&#39;s name. This allows different organizations to associate distinct semantics with the same name.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Namespace&#39;</span>
+    <span class=p>)</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A textual label that provides a sub-type or characterization of the part&#39;s name. This can be used to further distinguish or discriminate between the semantics of multiple parts of the same control with the same name and ns.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Class&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the part, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>prose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Permits multiple paragraphs, lists, tables etc.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Text&#39;</span><span class=p>)</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AssessmentPart</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AssessmentPart-attributes>Attributes<a href=#trestle.oscal.common.AssessmentPart-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPart.class_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A textual label that provides a sub-type or characterization of the part&#39;s name. This can be used to further distinguish or discriminate between the semantics of multiple parts of the same control with the same name and ns.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Class&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.class_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPart.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPart.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>),</span> <span class=n>Name</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A textual label that uniquely identifies the part&#39;s semantic type.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPart.ns class="doc doc-heading"> <code class="highlight language-python"><span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A namespace qualifying the part&#39;s name. This allows different organizations to associate distinct semantics with the same name.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Namespace&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.ns class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPart.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AssessmentPart</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPart.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPart.prose class="doc doc-heading"> <code class="highlight language-python"><span class=n>prose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Permits multiple paragraphs, lists, tables etc.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Text&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.prose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPart.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the part, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPart.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this part elsewhere in this or other OSCAL instances. The locally defined UUID of the part can be used to reference the data item locally or globally (e.g., in an ported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.AssessmentPart-classes>Classes<a href=#trestle.oscal.common.AssessmentPart-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.AssessmentPart.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.AssessmentPart.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1050</span>
+<span class=normal>1051</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.AssessmentPart.Config-attributes>Attributes<a href=#trestle.oscal.common.AssessmentPart.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.AssessmentPart.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPart.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AssessmentPlatform class="doc doc-heading"> <code>AssessmentPlatform</code> <a href=#trestle.oscal.common.AssessmentPlatform class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to represent the toolset used to perform aspects of the assessment.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2295</span>
+<span class=normal>2296</span>
+<span class=normal>2297</span>
+<span class=normal>2298</span>
+<span class=normal>2299</span>
+<span class=normal>2300</span>
+<span class=normal>2301</span>
+<span class=normal>2302</span>
+<span class=normal>2303</span>
+<span class=normal>2304</span>
+<span class=normal>2305</span>
+<span class=normal>2306</span>
+<span class=normal>2307</span>
+<span class=normal>2308</span>
+<span class=normal>2309</span>
+<span class=normal>2310</span>
+<span class=normal>2311</span>
+<span class=normal>2312</span>
+<span class=normal>2313</span>
+<span class=normal>2314</span>
+<span class=normal>2315</span>
+<span class=normal>2316</span>
+<span class=normal>2317</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssessmentPlatform</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to represent the toolset used to perform aspects of the assessment.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment platform elsewhere in this or other OSCAL instances. The locally defined UUID of the assessment platform can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Platform Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title or name for the assessment platform.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Platform Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>uses_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>UsesComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;uses-components&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AssessmentPlatform-attributes>Attributes<a href=#trestle.oscal.common.AssessmentPlatform-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPlatform.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPlatform.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPlatform.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPlatform.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPlatform.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPlatform.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPlatform.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title or name for the assessment platform.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Platform Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPlatform.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPlatform.uses_components class="doc doc-heading"> <code class="highlight language-python"><span class=n>uses_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>UsesComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;uses-components&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPlatform.uses_components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentPlatform.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment platform elsewhere in this or other OSCAL instances. The locally defined UUID of the assessment platform can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Platform Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPlatform.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.AssessmentPlatform-classes>Classes<a href=#trestle.oscal.common.AssessmentPlatform-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.AssessmentPlatform.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.AssessmentPlatform.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2300</span>
+<span class=normal>2301</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.AssessmentPlatform.Config-attributes>Attributes<a href=#trestle.oscal.common.AssessmentPlatform.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.AssessmentPlatform.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentPlatform.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AssessmentSubject class="doc doc-heading"> <code>AssessmentSubject</code> <a href=#trestle.oscal.common.AssessmentSubject class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies system elements being assessed, such as components, inventory items, and locations. In the assessment plan, this identifies a planned assessment subject. In the assessment results this is an actual assessment subject, and reflects any changes from the plan. exactly what will be the focus of this assessment. Any subjects not identified in this way are out-of-scope.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1377</span>
+<span class=normal>1378</span>
+<span class=normal>1379</span>
+<span class=normal>1380</span>
+<span class=normal>1381</span>
+<span class=normal>1382</span>
+<span class=normal>1383</span>
+<span class=normal>1384</span>
+<span class=normal>1385</span>
+<span class=normal>1386</span>
+<span class=normal>1387</span>
+<span class=normal>1388</span>
+<span class=normal>1389</span>
+<span class=normal>1390</span>
+<span class=normal>1391</span>
+<span class=normal>1392</span>
+<span class=normal>1393</span>
+<span class=normal>1394</span>
+<span class=normal>1395</span>
+<span class=normal>1396</span>
+<span class=normal>1397</span>
+<span class=normal>1398</span>
+<span class=normal>1399</span>
+<span class=normal>1400</span>
+<span class=normal>1401</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssessmentSubject</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies system elements being assessed, such as components, inventory items, and locations. In the assessment plan, this identifies a planned assessment subject. In the assessment results this is an actual assessment subject, and reflects any changes from the plan. exactly what will be the focus of this assessment. Any subjects not identified in this way are out-of-scope.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>AssessmentSubjectValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Indicates the type of assessment subject, such as a component, inventory, item, location, or party represented by this selection statement.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of the collection of subjects being included in this assessment.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Include Subjects Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span>
+    <span class=n>include_subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectSubjectById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-subjects&#39;</span><span class=p>)</span>
+    <span class=n>exclude_subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectSubjectById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-subjects&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AssessmentSubject-attributes>Attributes<a href=#trestle.oscal.common.AssessmentSubject-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubject.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of the collection of subjects being included in this assessment.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Include Subjects Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubject.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubject.exclude_subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>exclude_subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectSubjectById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-subjects&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubject.exclude_subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubject.include_all class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubject.include_all class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubject.include_subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectSubjectById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-subjects&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubject.include_subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubject.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubject.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubject.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubject.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubject.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubject.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubject.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>AssessmentSubjectValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the type of assessment subject, such as a component, inventory, item, location, or party represented by this selection statement.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubject.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.AssessmentSubject-classes>Classes<a href=#trestle.oscal.common.AssessmentSubject-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.AssessmentSubject.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.AssessmentSubject.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1382</span>
+<span class=normal>1383</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.AssessmentSubject.Config-attributes>Attributes<a href=#trestle.oscal.common.AssessmentSubject.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.AssessmentSubject.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubject.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AssessmentSubjectPlaceholder class="doc doc-heading"> <code>AssessmentSubjectPlaceholder</code> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used when the assessment subjects will be determined as part of one or more other assessment activities. These assessment subjects will be recorded in the assessment results in the assessment log.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1018</span>
+<span class=normal>1019</span>
+<span class=normal>1020</span>
+<span class=normal>1021</span>
+<span class=normal>1022</span>
+<span class=normal>1023</span>
+<span class=normal>1024</span>
+<span class=normal>1025</span>
+<span class=normal>1026</span>
+<span class=normal>1027</span>
+<span class=normal>1028</span>
+<span class=normal>1029</span>
+<span class=normal>1030</span>
+<span class=normal>1031</span>
+<span class=normal>1032</span>
+<span class=normal>1033</span>
+<span class=normal>1034</span>
+<span class=normal>1035</span>
+<span class=normal>1036</span>
+<span class=normal>1037</span>
+<span class=normal>1038</span>
+<span class=normal>1039</span>
+<span class=normal>1040</span>
+<span class=normal>1041</span>
+<span class=normal>1042</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssessmentSubjectPlaceholder</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used when the assessment subjects will be determined as part of one or more other assessment activities. These assessment subjects will be recorded in the assessment results in the assessment log.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier for a set of assessment subjects that will be identified by a task or an activity that is part of a task. The locally defined UUID of the assessment subject placeholder can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Subject Placeholder Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of intent of this assessment subject placeholder.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Subject Placeholder Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>sources</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Source</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AssessmentSubjectPlaceholder-attributes>Attributes<a href=#trestle.oscal.common.AssessmentSubjectPlaceholder-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectPlaceholder.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of intent of this assessment subject placeholder.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Subject Placeholder Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectPlaceholder.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectPlaceholder.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectPlaceholder.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectPlaceholder.sources class="doc doc-heading"> <code class="highlight language-python"><span class=n>sources</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Source</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.sources class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectPlaceholder.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier for a set of assessment subjects that will be identified by a task or an activity that is part of a task. The locally defined UUID of the assessment subject placeholder can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Subject Placeholder Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.AssessmentSubjectPlaceholder-classes>Classes<a href=#trestle.oscal.common.AssessmentSubjectPlaceholder-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.AssessmentSubjectPlaceholder.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1023</span>
+<span class=normal>1024</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.AssessmentSubjectPlaceholder.Config-attributes>Attributes<a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.AssessmentSubjectPlaceholder.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectPlaceholder.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AssessmentSubjectValidValues class="doc doc-heading"> <code>AssessmentSubjectValidValues</code> <a href=#trestle.oscal.common.AssessmentSubjectValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1010</span>
+<span class=normal>1011</span>
+<span class=normal>1012</span>
+<span class=normal>1013</span>
+<span class=normal>1014</span>
+<span class=normal>1015</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssessmentSubjectValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>component</span> <span class=o>=</span> <span class=s1>&#39;component&#39;</span>
+    <span class=n>inventory_item</span> <span class=o>=</span> <span class=s1>&#39;inventory-item&#39;</span>
+    <span class=n>location</span> <span class=o>=</span> <span class=s1>&#39;location&#39;</span>
+    <span class=n>party</span> <span class=o>=</span> <span class=s1>&#39;party&#39;</span>
+    <span class=n>user</span> <span class=o>=</span> <span class=s1>&#39;user&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AssessmentSubjectValidValues-attributes>Attributes<a href=#trestle.oscal.common.AssessmentSubjectValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectValidValues.component class="doc doc-heading"> <code class="highlight language-python"><span class=n>component</span> <span class=o>=</span> <span class=s1>&#39;component&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectValidValues.inventory_item class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory_item</span> <span class=o>=</span> <span class=s1>&#39;inventory-item&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.inventory_item class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectValidValues.location class="doc doc-heading"> <code class="highlight language-python"><span class=n>location</span> <span class=o>=</span> <span class=s1>&#39;location&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.location class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectValidValues.party class="doc doc-heading"> <code class="highlight language-python"><span class=n>party</span> <span class=o>=</span> <span class=s1>&#39;party&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.party class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssessmentSubjectValidValues.user class="doc doc-heading"> <code class="highlight language-python"><span class=n>user</span> <span class=o>=</span> <span class=s1>&#39;user&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssessmentSubjectValidValues.user class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AssociatedActivity class="doc doc-heading"> <code>AssociatedActivity</code> <a href=#trestle.oscal.common.AssociatedActivity class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies an individual activity to be performed as part of a task.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2114</span>
+<span class=normal>2115</span>
+<span class=normal>2116</span>
+<span class=normal>2117</span>
+<span class=normal>2118</span>
+<span class=normal>2119</span>
+<span class=normal>2120</span>
+<span class=normal>2121</span>
+<span class=normal>2122</span>
+<span class=normal>2123</span>
+<span class=normal>2124</span>
+<span class=normal>2125</span>
+<span class=normal>2126</span>
+<span class=normal>2127</span>
+<span class=normal>2128</span>
+<span class=normal>2129</span>
+<span class=normal>2130</span>
+<span class=normal>2131</span>
+<span class=normal>2132</span>
+<span class=normal>2133</span>
+<span class=normal>2134</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AssociatedActivity</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies an individual activity to be performed as part of a task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>activity_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;activity-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to an activity defined in the list of activities.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Activity Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>subjects</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>AssessmentSubject</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AssociatedActivity-attributes>Attributes<a href=#trestle.oscal.common.AssociatedActivity-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssociatedActivity.activity_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>activity_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;activity-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to an activity defined in the list of activities.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Activity Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssociatedActivity.activity_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssociatedActivity.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssociatedActivity.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssociatedActivity.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssociatedActivity.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssociatedActivity.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssociatedActivity.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssociatedActivity.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssociatedActivity.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AssociatedActivity.subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>subjects</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>AssessmentSubject</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssociatedActivity.subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.AssociatedActivity-classes>Classes<a href=#trestle.oscal.common.AssociatedActivity-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.AssociatedActivity.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.AssociatedActivity.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2119</span>
+<span class=normal>2120</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.AssociatedActivity.Config-attributes>Attributes<a href=#trestle.oscal.common.AssociatedActivity.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.AssociatedActivity.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AssociatedActivity.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AtFrequency class="doc doc-heading"> <code>AtFrequency</code> <a href=#trestle.oscal.common.AtFrequency class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The task is intended to occur at the specified frequency.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 996</span>
+<span class=normal> 997</span>
+<span class=normal> 998</span>
+<span class=normal> 999</span>
+<span class=normal>1000</span>
+<span class=normal>1001</span>
+<span class=normal>1002</span>
+<span class=normal>1003</span>
+<span class=normal>1004</span>
+<span class=normal>1005</span>
+<span class=normal>1006</span>
+<span class=normal>1007</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AtFrequency</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The task is intended to occur at the specified frequency.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>period</span><span class=p>:</span> <span class=n>conint</span><span class=p>(</span>
+        <span class=n>ge</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>multiple_of</span><span class=o>=</span><span class=mi>1</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task must occur after the specified period has elapsed.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Period&#39;</span><span class=p>)</span>
+    <span class=n>unit</span><span class=p>:</span> <span class=n>TimeUnitValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The unit of time for the period.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Time Unit&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AtFrequency-attributes>Attributes<a href=#trestle.oscal.common.AtFrequency-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AtFrequency.period class="doc doc-heading"> <code class="highlight language-python"><span class=n>period</span><span class=p>:</span> <span class=n>conint</span><span class=p>(</span><span class=n>ge</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>multiple_of</span><span class=o>=</span><span class=mi>1</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task must occur after the specified period has elapsed.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Period&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AtFrequency.period class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AtFrequency.unit class="doc doc-heading"> <code class="highlight language-python"><span class=n>unit</span><span class=p>:</span> <span class=n>TimeUnitValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The unit of time for the period.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Time Unit&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AtFrequency.unit class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.AtFrequency-classes>Classes<a href=#trestle.oscal.common.AtFrequency-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.AtFrequency.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.AtFrequency.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1001</span>
+<span class=normal>1002</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.AtFrequency.Config-attributes>Attributes<a href=#trestle.oscal.common.AtFrequency.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.AtFrequency.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AtFrequency.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.AuthorizedPrivilege class="doc doc-heading"> <code>AuthorizedPrivilege</code> <a href=#trestle.oscal.common.AuthorizedPrivilege class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies a specific system privilege held by the user, along with an associated description and/or rationale for the privilege.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>981</span>
+<span class=normal>982</span>
+<span class=normal>983</span>
+<span class=normal>984</span>
+<span class=normal>985</span>
+<span class=normal>986</span>
+<span class=normal>987</span>
+<span class=normal>988</span>
+<span class=normal>989</span>
+<span class=normal>990</span>
+<span class=normal>991</span>
+<span class=normal>992</span>
+<span class=normal>993</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AuthorizedPrivilege</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies a specific system privilege held by the user, along with an associated description and/or rationale for the privilege.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the privilege.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Privilege Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the privilege&#39;s purpose within the system.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Privilege Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>functions_performed</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;functions-performed&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.AuthorizedPrivilege-attributes>Attributes<a href=#trestle.oscal.common.AuthorizedPrivilege-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AuthorizedPrivilege.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the privilege&#39;s purpose within the system.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Privilege Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AuthorizedPrivilege.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AuthorizedPrivilege.functions_performed class="doc doc-heading"> <code class="highlight language-python"><span class=n>functions_performed</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;functions-performed&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AuthorizedPrivilege.functions_performed class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.AuthorizedPrivilege.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the privilege.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Privilege Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AuthorizedPrivilege.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.AuthorizedPrivilege-classes>Classes<a href=#trestle.oscal.common.AuthorizedPrivilege-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.AuthorizedPrivilege.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.AuthorizedPrivilege.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>986</span>
+<span class=normal>987</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.AuthorizedPrivilege.Config-attributes>Attributes<a href=#trestle.oscal.common.AuthorizedPrivilege.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.AuthorizedPrivilege.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.AuthorizedPrivilege.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.BackMatter class="doc doc-heading"> <code>BackMatter</code> <a href=#trestle.oscal.common.BackMatter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A collection of resources that may be referenced from within the OSCAL document instance.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2051</span>
+<span class=normal>2052</span>
+<span class=normal>2053</span>
+<span class=normal>2054</span>
+<span class=normal>2055</span>
+<span class=normal>2056</span>
+<span class=normal>2057</span>
+<span class=normal>2058</span>
+<span class=normal>2059</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>BackMatter</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A collection of resources that may be referenced from within the OSCAL document instance.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>resources</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Resource</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.BackMatter-attributes>Attributes<a href=#trestle.oscal.common.BackMatter-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.BackMatter.resources class="doc doc-heading"> <code class="highlight language-python"><span class=n>resources</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Resource</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.BackMatter.resources class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.BackMatter-classes>Classes<a href=#trestle.oscal.common.BackMatter-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.BackMatter.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.BackMatter.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2056</span>
+<span class=normal>2057</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.BackMatter.Config-attributes>Attributes<a href=#trestle.oscal.common.BackMatter.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.BackMatter.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.BackMatter.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Base64 class="doc doc-heading"> <code>Base64</code> <a href=#trestle.oscal.common.Base64 class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A resource encoded using the Base64 alphabet defined by RFC 2045.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>955</span>
+<span class=normal>956</span>
+<span class=normal>957</span>
+<span class=normal>958</span>
+<span class=normal>959</span>
+<span class=normal>960</span>
+<span class=normal>961</span>
+<span class=normal>962</span>
+<span class=normal>963</span>
+<span class=normal>964</span>
+<span class=normal>965</span>
+<span class=normal>966</span>
+<span class=normal>967</span>
+<span class=normal>968</span>
+<span class=normal>969</span>
+<span class=normal>970</span>
+<span class=normal>971</span>
+<span class=normal>972</span>
+<span class=normal>973</span>
+<span class=normal>974</span>
+<span class=normal>975</span>
+<span class=normal>976</span>
+<span class=normal>977</span>
+<span class=normal>978</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Base64</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A resource encoded using the Base64 alphabet defined by RFC 2045.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>filename</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Name of the file before it was encoded as Base64 to be embedded in a resource. This is the name that will be assigned to the file when the file is decoded.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;File Name&#39;</span>
+    <span class=p>)</span>
+    <span class=n>media_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;media-type&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A label that indicates the nature of a resource, as a data serialization or format.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Media Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>value</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Za-z+/]+={0,2}$&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Base64-attributes>Attributes<a href=#trestle.oscal.common.Base64-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Base64.filename class="doc doc-heading"> <code class="highlight language-python"><span class=n>filename</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Name of the file before it was encoded as Base64 to be embedded in a resource. This is the name that will be assigned to the file when the file is decoded.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;File Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Base64.filename class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Base64.media_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>media_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;media-type&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A label that indicates the nature of a resource, as a data serialization or format.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Media Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Base64.media_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Base64.value class="doc doc-heading"> <code class="highlight language-python"><span class=n>value</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Za-z+/]+={0,2}$&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Base64.value class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Base64-classes>Classes<a href=#trestle.oscal.common.Base64-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Base64.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Base64.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>960</span>
+<span class=normal>961</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Base64.Config-attributes>Attributes<a href=#trestle.oscal.common.Base64.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Base64.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Base64.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Base64Datatype class="doc doc-heading"> <code>Base64Datatype</code> <a href=#trestle.oscal.common.Base64Datatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>949</span>
+<span class=normal>950</span>
+<span class=normal>951</span>
+<span class=normal>952</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Base64Datatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Za-z+/]+={0,2}$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Binary data encoded using the Base 64 encoding algorithm as defined by RFC4648.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Base64Datatype-attributes>Attributes<a href=#trestle.oscal.common.Base64Datatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Base64Datatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Za-z+/]+={0,2}$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Binary data encoded using the Base 64 encoding algorithm as defined by RFC4648.&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Base64Datatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Characterization class="doc doc-heading"> <code>Characterization</code> <a href=#trestle.oscal.common.Characterization class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A collection of descriptive data about the containing object from a specific origin.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2100</span>
+<span class=normal>2101</span>
+<span class=normal>2102</span>
+<span class=normal>2103</span>
+<span class=normal>2104</span>
+<span class=normal>2105</span>
+<span class=normal>2106</span>
+<span class=normal>2107</span>
+<span class=normal>2108</span>
+<span class=normal>2109</span>
+<span class=normal>2110</span>
+<span class=normal>2111</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Characterization</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A collection of descriptive data about the containing object from a specific origin.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>origin</span><span class=p>:</span> <span class=n>Origin</span>
+    <span class=n>facets</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Facet</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Characterization-attributes>Attributes<a href=#trestle.oscal.common.Characterization-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Characterization.facets class="doc doc-heading"> <code class="highlight language-python"><span class=n>facets</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Facet</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Characterization.facets class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Characterization.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Characterization.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Characterization.origin class="doc doc-heading"> <code class="highlight language-python"><span class=n>origin</span><span class=p>:</span> <span class=n>Origin</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Characterization.origin class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Characterization.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Characterization.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Characterization-classes>Classes<a href=#trestle.oscal.common.Characterization-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Characterization.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Characterization.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2105</span>
+<span class=normal>2106</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Characterization.Config-attributes>Attributes<a href=#trestle.oscal.common.Characterization.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Characterization.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Characterization.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Citation class="doc doc-heading"> <code>Citation</code> <a href=#trestle.oscal.common.Citation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An optional citation consisting of end note text using structured markup.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>936</span>
+<span class=normal>937</span>
+<span class=normal>938</span>
+<span class=normal>939</span>
+<span class=normal>940</span>
+<span class=normal>941</span>
+<span class=normal>942</span>
+<span class=normal>943</span>
+<span class=normal>944</span>
+<span class=normal>945</span>
+<span class=normal>946</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Citation</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An optional citation consisting of end note text using structured markup.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>text</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A line of citation text.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Citation Text&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Citation-attributes>Attributes<a href=#trestle.oscal.common.Citation-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Citation.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Citation.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Citation.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Citation.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Citation.text class="doc doc-heading"> <code class="highlight language-python"><span class=n>text</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A line of citation text.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Citation Text&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Citation.text class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Citation-classes>Classes<a href=#trestle.oscal.common.Citation-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Citation.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Citation.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>941</span>
+<span class=normal>942</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Citation.Config-attributes>Attributes<a href=#trestle.oscal.common.Citation.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Citation.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Citation.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ControlObjectiveSelection class="doc doc-heading"> <code>ControlObjectiveSelection</code> <a href=#trestle.oscal.common.ControlObjectiveSelection class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies the control objectives of the assessment. In the assessment plan, these are the planned objectives. In the assessment results, these are the assessed objectives, and reflects any changes from the plan.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>915</span>
+<span class=normal>916</span>
+<span class=normal>917</span>
+<span class=normal>918</span>
+<span class=normal>919</span>
+<span class=normal>920</span>
+<span class=normal>921</span>
+<span class=normal>922</span>
+<span class=normal>923</span>
+<span class=normal>924</span>
+<span class=normal>925</span>
+<span class=normal>926</span>
+<span class=normal>927</span>
+<span class=normal>928</span>
+<span class=normal>929</span>
+<span class=normal>930</span>
+<span class=normal>931</span>
+<span class=normal>932</span>
+<span class=normal>933</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlObjectiveSelection</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the control objectives of the assessment. In the assessment plan, these are the planned objectives. In the assessment results, these are the assessed objectives, and reflects any changes from the plan.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this collection of control objectives.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Objectives Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span>
+    <span class=n>include_objectives</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectObjectiveById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-objectives&#39;</span><span class=p>)</span>
+    <span class=n>exclude_objectives</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectObjectiveById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-objectives&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ControlObjectiveSelection-attributes>Attributes<a href=#trestle.oscal.common.ControlObjectiveSelection-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlObjectiveSelection.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this collection of control objectives.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Objectives Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlObjectiveSelection.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlObjectiveSelection.exclude_objectives class="doc doc-heading"> <code class="highlight language-python"><span class=n>exclude_objectives</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectObjectiveById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-objectives&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlObjectiveSelection.exclude_objectives class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlObjectiveSelection.include_all class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlObjectiveSelection.include_all class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlObjectiveSelection.include_objectives class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_objectives</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectObjectiveById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-objectives&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlObjectiveSelection.include_objectives class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlObjectiveSelection.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlObjectiveSelection.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlObjectiveSelection.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlObjectiveSelection.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlObjectiveSelection.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlObjectiveSelection.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ControlObjectiveSelection-classes>Classes<a href=#trestle.oscal.common.ControlObjectiveSelection-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ControlObjectiveSelection.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ControlObjectiveSelection.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>920</span>
+<span class=normal>921</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ControlObjectiveSelection.Config-attributes>Attributes<a href=#trestle.oscal.common.ControlObjectiveSelection.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ControlObjectiveSelection.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlObjectiveSelection.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ControlSelection class="doc doc-heading"> <code>ControlSelection</code> <a href=#trestle.oscal.common.ControlSelection class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies the controls being assessed. In the assessment plan, these are the planned controls. In the assessment results, these are the actual controls, and reflects any changes from the plan.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>894</span>
+<span class=normal>895</span>
+<span class=normal>896</span>
+<span class=normal>897</span>
+<span class=normal>898</span>
+<span class=normal>899</span>
+<span class=normal>900</span>
+<span class=normal>901</span>
+<span class=normal>902</span>
+<span class=normal>903</span>
+<span class=normal>904</span>
+<span class=normal>905</span>
+<span class=normal>906</span>
+<span class=normal>907</span>
+<span class=normal>908</span>
+<span class=normal>909</span>
+<span class=normal>910</span>
+<span class=normal>911</span>
+<span class=normal>912</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlSelection</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the controls being assessed. In the assessment plan, these are the planned controls. In the assessment results, these are the actual controls, and reflects any changes from the plan.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of in-scope controls specified for assessment.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessed Controls Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span>
+    <span class=n>include_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControlById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-controls&#39;</span><span class=p>)</span>
+    <span class=n>exclude_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControlById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-controls&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ControlSelection-attributes>Attributes<a href=#trestle.oscal.common.ControlSelection-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlSelection.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of in-scope controls specified for assessment.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessed Controls Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlSelection.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlSelection.exclude_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>exclude_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControlById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlSelection.exclude_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlSelection.include_all class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlSelection.include_all class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlSelection.include_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControlById</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlSelection.include_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlSelection.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlSelection.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlSelection.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlSelection.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ControlSelection.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlSelection.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ControlSelection-classes>Classes<a href=#trestle.oscal.common.ControlSelection-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ControlSelection.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ControlSelection.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>899</span>
+<span class=normal>900</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ControlSelection.Config-attributes>Attributes<a href=#trestle.oscal.common.ControlSelection.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ControlSelection.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ControlSelection.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.DateTimeWithTimezoneDatatype class="doc doc-heading"> <code>DateTimeWithTimezoneDatatype</code> <a href=#trestle.oscal.common.DateTimeWithTimezoneDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>890</span>
+<span class=normal>891</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DateTimeWithTimezoneDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A string representing a point in time with a required timezone.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.DateTimeWithTimezoneDatatype-attributes>Attributes<a href=#trestle.oscal.common.DateTimeWithTimezoneDatatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.DateTimeWithTimezoneDatatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A string representing a point in time with a required timezone.&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.DateTimeWithTimezoneDatatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Dependency class="doc doc-heading"> <code>Dependency</code> <a href=#trestle.oscal.common.Dependency class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to indicate that a task is dependent on another task.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>871</span>
+<span class=normal>872</span>
+<span class=normal>873</span>
+<span class=normal>874</span>
+<span class=normal>875</span>
+<span class=normal>876</span>
+<span class=normal>877</span>
+<span class=normal>878</span>
+<span class=normal>879</span>
+<span class=normal>880</span>
+<span class=normal>881</span>
+<span class=normal>882</span>
+<span class=normal>883</span>
+<span class=normal>884</span>
+<span class=normal>885</span>
+<span class=normal>886</span>
+<span class=normal>887</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Dependency</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to indicate that a task is dependent on another task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>task_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;task-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a unique task.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Dependency-attributes>Attributes<a href=#trestle.oscal.common.Dependency-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Dependency.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Dependency.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Dependency.task_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>task_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;task-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a unique task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Dependency.task_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Dependency-classes>Classes<a href=#trestle.oscal.common.Dependency-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Dependency.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Dependency.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>876</span>
+<span class=normal>877</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Dependency.Config-attributes>Attributes<a href=#trestle.oscal.common.Dependency.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Dependency.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Dependency.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.DocumentId class="doc doc-heading"> <code>DocumentId</code> <a href=#trestle.oscal.common.DocumentId class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A document identifier qualified by an identifier scheme.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>854</span>
+<span class=normal>855</span>
+<span class=normal>856</span>
+<span class=normal>857</span>
+<span class=normal>858</span>
+<span class=normal>859</span>
+<span class=normal>860</span>
+<span class=normal>861</span>
+<span class=normal>862</span>
+<span class=normal>863</span>
+<span class=normal>864</span>
+<span class=normal>865</span>
+<span class=normal>866</span>
+<span class=normal>867</span>
+<span class=normal>868</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DocumentId</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A document identifier qualified by an identifier scheme.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>scheme</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>URIDatatype</span><span class=p>,</span> <span class=n>DocumentSchemeValidValues</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Qualifies the kind of document identifier using a URI. If the scheme is not provided the value of the element will be interpreted as a string of characters.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Document Identification Scheme&#39;</span>
+    <span class=p>)</span>
+    <span class=n>identifier</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.DocumentId-attributes>Attributes<a href=#trestle.oscal.common.DocumentId-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.DocumentId.identifier class="doc doc-heading"> <code class="highlight language-python"><span class=n>identifier</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.DocumentId.identifier class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.DocumentId.scheme class="doc doc-heading"> <code class="highlight language-python"><span class=n>scheme</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>URIDatatype</span><span class=p>,</span> <span class=n>DocumentSchemeValidValues</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Qualifies the kind of document identifier using a URI. If the scheme is not provided the value of the element will be interpreted as a string of characters.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Document Identification Scheme&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.DocumentId.scheme class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.DocumentId-classes>Classes<a href=#trestle.oscal.common.DocumentId-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.DocumentId.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.DocumentId.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>859</span>
+<span class=normal>860</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.DocumentId.Config-attributes>Attributes<a href=#trestle.oscal.common.DocumentId.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.DocumentId.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.DocumentId.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.DocumentSchemeValidValues class="doc doc-heading"> <code>DocumentSchemeValidValues</code> <a href=#trestle.oscal.common.DocumentSchemeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>850</span>
+<span class=normal>851</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DocumentSchemeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>http___www_doi_org_</span> <span class=o>=</span> <span class=s1>&#39;http://www.doi.org/&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.DocumentSchemeValidValues-attributes>Attributes<a href=#trestle.oscal.common.DocumentSchemeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.DocumentSchemeValidValues.http___www_doi_org_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___www_doi_org_</span> <span class=o>=</span> <span class=s1>&#39;http://www.doi.org/&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.DocumentSchemeValidValues.http___www_doi_org_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.EmailAddress class="doc doc-heading"> <code>EmailAddress</code> <a href=#trestle.oscal.common.EmailAddress class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>844</span>
+<span class=normal>845</span>
+<span class=normal>846</span>
+<span class=normal>847</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>EmailAddress</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>EmailStr</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An email address as defined by RFC 5322 Section 3.4.1.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Email Address&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.EmailAddress-attributes>Attributes<a href=#trestle.oscal.common.EmailAddress-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.EmailAddress.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>EmailStr</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An email address as defined by RFC 5322 Section 3.4.1.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Email Address&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.EmailAddress.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.EmailAddressDatatype class="doc doc-heading"> <code>EmailAddressDatatype</code> <a href=#trestle.oscal.common.EmailAddressDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An email address string formatted according to RFC 6531.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>838</span>
+<span class=normal>839</span>
+<span class=normal>840</span>
+<span class=normal>841</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>EmailAddressDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An email address string formatted according to RFC 6531.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Entry class="doc doc-heading"> <code>Entry</code> <a href=#trestle.oscal.common.Entry class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies an individual risk response that occurred as part of managing an identified risk.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2458</span>
+<span class=normal>2459</span>
+<span class=normal>2460</span>
+<span class=normal>2461</span>
+<span class=normal>2462</span>
+<span class=normal>2463</span>
+<span class=normal>2464</span>
+<span class=normal>2465</span>
+<span class=normal>2466</span>
+<span class=normal>2467</span>
+<span class=normal>2468</span>
+<span class=normal>2469</span>
+<span class=normal>2470</span>
+<span class=normal>2471</span>
+<span class=normal>2472</span>
+<span class=normal>2473</span>
+<span class=normal>2474</span>
+<span class=normal>2475</span>
+<span class=normal>2476</span>
+<span class=normal>2477</span>
+<span class=normal>2478</span>
+<span class=normal>2479</span>
+<span class=normal>2480</span>
+<span class=normal>2481</span>
+<span class=normal>2482</span>
+<span class=normal>2483</span>
+<span class=normal>2484</span>
+<span class=normal>2485</span>
+<span class=normal>2486</span>
+<span class=normal>2487</span>
+<span class=normal>2488</span>
+<span class=normal>2489</span>
+<span class=normal>2490</span>
+<span class=normal>2491</span>
+<span class=normal>2492</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Entry</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies an individual risk response that occurred as part of managing an identified risk.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this risk log entry elsewhere in this or other OSCAL instances. The locally defined UUID of the risk log entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Log Entry Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this risk log entry.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of what was done regarding the risk.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Task Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>start</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the start date and time of the event.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Start&#39;</span><span class=p>)</span>
+    <span class=n>end</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Identifies the end date and time of the event. If the event is a point in time, the start and end will be the same date and time.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;End&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>logged_by</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>LoggedBy</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;logged-by&#39;</span><span class=p>)</span>
+    <span class=n>status_change</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>RiskStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;status-change&#39;</span><span class=p>)</span>
+    <span class=n>related_responses</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedResponse</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-responses&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Entry-attributes>Attributes<a href=#trestle.oscal.common.Entry-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of what was done regarding the risk.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Task Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.end class="doc doc-heading"> <code class="highlight language-python"><span class=n>end</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the end date and time of the event. If the event is a point in time, the start and end will be the same date and time.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;End&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.end class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.logged_by class="doc doc-heading"> <code class="highlight language-python"><span class=n>logged_by</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>LoggedBy</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;logged-by&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.logged_by class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.related_responses class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_responses</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedResponse</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-responses&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.related_responses class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.start class="doc doc-heading"> <code class="highlight language-python"><span class=n>start</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the start date and time of the event.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Start&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.start class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.status_change class="doc doc-heading"> <code class="highlight language-python"><span class=n>status_change</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>RiskStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;status-change&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.status_change class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this risk log entry.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Entry.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this risk log entry elsewhere in this or other OSCAL instances. The locally defined UUID of the risk log entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Log Entry Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Entry-classes>Classes<a href=#trestle.oscal.common.Entry-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Entry.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Entry.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2463</span>
+<span class=normal>2464</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Entry.Config-attributes>Attributes<a href=#trestle.oscal.common.Entry.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Entry.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Entry.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ExternalId class="doc doc-heading"> <code>ExternalId</code> <a href=#trestle.oscal.common.ExternalId class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An identifier for a person or organization using a designated scheme. e.g. an Open Researcher and Contributor ID (ORCID).</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>824</span>
+<span class=normal>825</span>
+<span class=normal>826</span>
+<span class=normal>827</span>
+<span class=normal>828</span>
+<span class=normal>829</span>
+<span class=normal>830</span>
+<span class=normal>831</span>
+<span class=normal>832</span>
+<span class=normal>833</span>
+<span class=normal>834</span>
+<span class=normal>835</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ExternalId</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An identifier for a person or organization using a designated scheme. e.g. an Open Researcher and Contributor ID (ORCID).</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>scheme</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>URIDatatype</span><span class=p>,</span> <span class=n>ExternalSchemeValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the type of external identifier.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;External Identifier Schema&#39;</span>
+    <span class=p>)</span>
+    <span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ExternalId-attributes>Attributes<a href=#trestle.oscal.common.ExternalId-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ExternalId.id class="doc doc-heading"> <code class="highlight language-python"><span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ExternalId.id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ExternalId.scheme class="doc doc-heading"> <code class="highlight language-python"><span class=n>scheme</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>URIDatatype</span><span class=p>,</span> <span class=n>ExternalSchemeValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the type of external identifier.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;External Identifier Schema&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ExternalId.scheme class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ExternalId-classes>Classes<a href=#trestle.oscal.common.ExternalId-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ExternalId.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ExternalId.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>829</span>
+<span class=normal>830</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ExternalId.Config-attributes>Attributes<a href=#trestle.oscal.common.ExternalId.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ExternalId.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ExternalId.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ExternalSchemeValidValues class="doc doc-heading"> <code>ExternalSchemeValidValues</code> <a href=#trestle.oscal.common.ExternalSchemeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>820</span>
+<span class=normal>821</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ExternalSchemeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>http___orcid_org_</span> <span class=o>=</span> <span class=s1>&#39;http://orcid.org/&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ExternalSchemeValidValues-attributes>Attributes<a href=#trestle.oscal.common.ExternalSchemeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ExternalSchemeValidValues.http___orcid_org_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___orcid_org_</span> <span class=o>=</span> <span class=s1>&#39;http://orcid.org/&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ExternalSchemeValidValues.http___orcid_org_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Facet class="doc doc-heading"> <code>Facet</code> <a href=#trestle.oscal.common.Facet class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An individual characteristic that is part of a larger set produced by the same actor.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>795</span>
+<span class=normal>796</span>
+<span class=normal>797</span>
+<span class=normal>798</span>
+<span class=normal>799</span>
+<span class=normal>800</span>
+<span class=normal>801</span>
+<span class=normal>802</span>
+<span class=normal>803</span>
+<span class=normal>804</span>
+<span class=normal>805</span>
+<span class=normal>806</span>
+<span class=normal>807</span>
+<span class=normal>808</span>
+<span class=normal>809</span>
+<span class=normal>810</span>
+<span class=normal>811</span>
+<span class=normal>812</span>
+<span class=normal>813</span>
+<span class=normal>814</span>
+<span class=normal>815</span>
+<span class=normal>816</span>
+<span class=normal>817</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Facet</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An individual characteristic that is part of a larger set produced by the same actor.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The name of the risk metric within the specified system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Facet Name&#39;</span><span class=p>)</span>
+    <span class=n>system</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>URIDatatype</span><span class=p>,</span> <span class=n>NamingSystemValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Specifies the naming system under which this risk metric is organized, which allows for the same names to be used in different systems controlled by different parties. This avoids the potential of a name clash.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Naming System&#39;</span>
+    <span class=p>)</span>
+    <span class=n>value</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span>
+                  <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the value of the facet.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Facet Value&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Facet-attributes>Attributes<a href=#trestle.oscal.common.Facet-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Facet.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Facet.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Facet.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The name of the risk metric within the specified system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Facet Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Facet.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Facet.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Facet.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Facet.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Facet.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Facet.system class="doc doc-heading"> <code class="highlight language-python"><span class=n>system</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>URIDatatype</span><span class=p>,</span> <span class=n>NamingSystemValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Specifies the naming system under which this risk metric is organized, which allows for the same names to be used in different systems controlled by different parties. This avoids the potential of a name clash.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Naming System&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Facet.system class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Facet.value class="doc doc-heading"> <code class="highlight language-python"><span class=n>value</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the value of the facet.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Facet Value&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Facet.value class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Facet-classes>Classes<a href=#trestle.oscal.common.Facet-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Facet.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Facet.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>800</span>
+<span class=normal>801</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Facet.Config-attributes>Attributes<a href=#trestle.oscal.common.Facet.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Facet.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Facet.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Finding class="doc doc-heading"> <code>Finding</code> <a href=#trestle.oscal.common.Finding class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes an individual finding.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2062</span>
+<span class=normal>2063</span>
+<span class=normal>2064</span>
+<span class=normal>2065</span>
+<span class=normal>2066</span>
+<span class=normal>2067</span>
+<span class=normal>2068</span>
+<span class=normal>2069</span>
+<span class=normal>2070</span>
+<span class=normal>2071</span>
+<span class=normal>2072</span>
+<span class=normal>2073</span>
+<span class=normal>2074</span>
+<span class=normal>2075</span>
+<span class=normal>2076</span>
+<span class=normal>2077</span>
+<span class=normal>2078</span>
+<span class=normal>2079</span>
+<span class=normal>2080</span>
+<span class=normal>2081</span>
+<span class=normal>2082</span>
+<span class=normal>2083</span>
+<span class=normal>2084</span>
+<span class=normal>2085</span>
+<span class=normal>2086</span>
+<span class=normal>2087</span>
+<span class=normal>2088</span>
+<span class=normal>2089</span>
+<span class=normal>2090</span>
+<span class=normal>2091</span>
+<span class=normal>2092</span>
+<span class=normal>2093</span>
+<span class=normal>2094</span>
+<span class=normal>2095</span>
+<span class=normal>2096</span>
+<span class=normal>2097</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Finding</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes an individual finding.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this finding in this or other OSCAL instances. The locally defined UUID of the finding can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this finding.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this finding.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origin</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>target</span><span class=p>:</span> <span class=n>FindingTarget</span>
+    <span class=n>implementation_statement_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-statement-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented identifier reference to the implementation statement in the SSP to which this finding is related.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Implementation Statement UUID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>related_observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedObservation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-observations&#39;</span><span class=p>)</span>
+    <span class=n>related_risks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedRisk</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-risks&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Finding-attributes>Attributes<a href=#trestle.oscal.common.Finding-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this finding.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.implementation_statement_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>implementation_statement_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-statement-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the implementation statement in the SSP to which this finding is related.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Implementation Statement UUID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.implementation_statement_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.origins class="doc doc-heading"> <code class="highlight language-python"><span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origin</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.origins class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.related_observations class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedObservation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-observations&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.related_observations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.related_risks class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_risks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedRisk</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-risks&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.related_risks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.target class="doc doc-heading"> <code class="highlight language-python"><span class=n>target</span><span class=p>:</span> <span class=n>FindingTarget</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.target class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this finding.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Finding.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this finding in this or other OSCAL instances. The locally defined UUID of the finding can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Finding-classes>Classes<a href=#trestle.oscal.common.Finding-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Finding.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Finding.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2067</span>
+<span class=normal>2068</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Finding.Config-attributes>Attributes<a href=#trestle.oscal.common.Finding.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Finding.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Finding.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.FindingTarget class="doc doc-heading"> <code>FindingTarget</code> <a href=#trestle.oscal.common.FindingTarget class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Captures an assessor's conclusions regarding the degree to which an objective is satisfied.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>755</span>
+<span class=normal>756</span>
+<span class=normal>757</span>
+<span class=normal>758</span>
+<span class=normal>759</span>
+<span class=normal>760</span>
+<span class=normal>761</span>
+<span class=normal>762</span>
+<span class=normal>763</span>
+<span class=normal>764</span>
+<span class=normal>765</span>
+<span class=normal>766</span>
+<span class=normal>767</span>
+<span class=normal>768</span>
+<span class=normal>769</span>
+<span class=normal>770</span>
+<span class=normal>771</span>
+<span class=normal>772</span>
+<span class=normal>773</span>
+<span class=normal>774</span>
+<span class=normal>775</span>
+<span class=normal>776</span>
+<span class=normal>777</span>
+<span class=normal>778</span>
+<span class=normal>779</span>
+<span class=normal>780</span>
+<span class=normal>781</span>
+<span class=normal>782</span>
+<span class=normal>783</span>
+<span class=normal>784</span>
+<span class=normal>785</span>
+<span class=normal>786</span>
+<span class=normal>787</span>
+<span class=normal>788</span>
+<span class=normal>789</span>
+<span class=normal>790</span>
+<span class=normal>791</span>
+<span class=normal>792</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>FindingTarget</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Captures an assessor&#39;s conclusions regarding the degree to which an objective is satisfied.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>type</span><span class=p>:</span> <span class=n>FindingTargetTypeValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the type of the target.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Target Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>target_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;target-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference for a specific target qualified by the type.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Target Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this objective status.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A human-readable description of the assessor&#39;s conclusions regarding the degree to which an objective is satisfied.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>implementation_status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ImplementationStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-status&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ObjectiveStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A determination of if the objective is satisfied or not within a given system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.FindingTarget-attributes>Attributes<a href=#trestle.oscal.common.FindingTarget-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTarget.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A human-readable description of the assessor&#39;s conclusions regarding the degree to which an objective is satisfied.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTarget.implementation_status class="doc doc-heading"> <code class="highlight language-python"><span class=n>implementation_status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ImplementationStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-status&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.implementation_status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTarget.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTarget.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTarget.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTarget.status class="doc doc-heading"> <code class="highlight language-python"><span class=n>status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ObjectiveStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A determination of if the objective is satisfied or not within a given system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTarget.target_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>target_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;target-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference for a specific target qualified by the type.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Target Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.target_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTarget.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this objective status.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTarget.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>FindingTargetTypeValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the type of the target.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Target Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.FindingTarget-classes>Classes<a href=#trestle.oscal.common.FindingTarget-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.FindingTarget.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.FindingTarget.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>760</span>
+<span class=normal>761</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.FindingTarget.Config-attributes>Attributes<a href=#trestle.oscal.common.FindingTarget.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.FindingTarget.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTarget.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.FindingTargetTypeValidValues class="doc doc-heading"> <code>FindingTargetTypeValidValues</code> <a href=#trestle.oscal.common.FindingTargetTypeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>750</span>
+<span class=normal>751</span>
+<span class=normal>752</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>FindingTargetTypeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>statement_id</span> <span class=o>=</span> <span class=s1>&#39;statement-id&#39;</span>
+    <span class=n>objective_id</span> <span class=o>=</span> <span class=s1>&#39;objective-id&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.FindingTargetTypeValidValues-attributes>Attributes<a href=#trestle.oscal.common.FindingTargetTypeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTargetTypeValidValues.objective_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>objective_id</span> <span class=o>=</span> <span class=s1>&#39;objective-id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTargetTypeValidValues.objective_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FindingTargetTypeValidValues.statement_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>statement_id</span> <span class=o>=</span> <span class=s1>&#39;statement-id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FindingTargetTypeValidValues.statement_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.FunctionPerformed class="doc doc-heading"> <code>FunctionPerformed</code> <a href=#trestle.oscal.common.FunctionPerformed class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>742</span>
+<span class=normal>743</span>
+<span class=normal>744</span>
+<span class=normal>745</span>
+<span class=normal>746</span>
+<span class=normal>747</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>FunctionPerformed</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>StringDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes a function performed for a given authorized privilege by this user class.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Functions Performed&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.FunctionPerformed-attributes>Attributes<a href=#trestle.oscal.common.FunctionPerformed-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.FunctionPerformed.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>StringDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes a function performed for a given authorized privilege by this user class.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Functions Performed&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.FunctionPerformed.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Hash class="doc doc-heading"> <code>Hash</code> <a href=#trestle.oscal.common.Hash class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A representation of a cryptographic digest generated over a resource using a specified hash algorithm.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1984</span>
+<span class=normal>1985</span>
+<span class=normal>1986</span>
+<span class=normal>1987</span>
+<span class=normal>1988</span>
+<span class=normal>1989</span>
+<span class=normal>1990</span>
+<span class=normal>1991</span>
+<span class=normal>1992</span>
+<span class=normal>1993</span>
+<span class=normal>1994</span>
+<span class=normal>1995</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Hash</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A representation of a cryptographic digest generated over a resource using a specified hash algorithm.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>algorithm</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>),</span> <span class=n>Algorithm</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The digest method by which a hash is derived.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Hash algorithm&#39;</span>
+    <span class=p>)</span>
+    <span class=n>value</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Hash-attributes>Attributes<a href=#trestle.oscal.common.Hash-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Hash.algorithm class="doc doc-heading"> <code class="highlight language-python"><span class=n>algorithm</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>),</span> <span class=n>Algorithm</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The digest method by which a hash is derived.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Hash algorithm&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Hash.algorithm class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Hash.value class="doc doc-heading"> <code class="highlight language-python"><span class=n>value</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Hash.value class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Hash-classes>Classes<a href=#trestle.oscal.common.Hash-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Hash.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Hash.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1989</span>
+<span class=normal>1990</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Hash.Config-attributes>Attributes<a href=#trestle.oscal.common.Hash.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Hash.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Hash.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.HowManyValidValues class="doc doc-heading"> <code>HowManyValidValues</code> <a href=#trestle.oscal.common.HowManyValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>734</span>
+<span class=normal>735</span>
+<span class=normal>736</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>HowManyValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>one</span> <span class=o>=</span> <span class=s1>&#39;one&#39;</span>
+    <span class=n>one_or_more</span> <span class=o>=</span> <span class=s1>&#39;one-or-more&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.HowManyValidValues-attributes>Attributes<a href=#trestle.oscal.common.HowManyValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.HowManyValidValues.one class="doc doc-heading"> <code class="highlight language-python"><span class=n>one</span> <span class=o>=</span> <span class=s1>&#39;one&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.HowManyValidValues.one class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.HowManyValidValues.one_or_more class="doc doc-heading"> <code class="highlight language-python"><span class=n>one_or_more</span> <span class=o>=</span> <span class=s1>&#39;one-or-more&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.HowManyValidValues.one_or_more class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.IdentifiedSubject class="doc doc-heading"> <code>IdentifiedSubject</code> <a href=#trestle.oscal.common.IdentifiedSubject class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to detail assessment subjects that were identfied by this task.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1923</span>
+<span class=normal>1924</span>
+<span class=normal>1925</span>
+<span class=normal>1926</span>
+<span class=normal>1927</span>
+<span class=normal>1928</span>
+<span class=normal>1929</span>
+<span class=normal>1930</span>
+<span class=normal>1931</span>
+<span class=normal>1932</span>
+<span class=normal>1933</span>
+<span class=normal>1934</span>
+<span class=normal>1935</span>
+<span class=normal>1936</span>
+<span class=normal>1937</span>
+<span class=normal>1938</span>
+<span class=normal>1939</span>
+<span class=normal>1940</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>IdentifiedSubject</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to detail assessment subjects that were identfied by this task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>subject_placeholder_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;subject-placeholder-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented identifier reference to a unique assessment subject placeholder defined by this task.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Subject Placeholder Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>subjects</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>AssessmentSubject</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.IdentifiedSubject-attributes>Attributes<a href=#trestle.oscal.common.IdentifiedSubject-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.IdentifiedSubject.subject_placeholder_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>subject_placeholder_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;subject-placeholder-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a unique assessment subject placeholder defined by this task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Assessment Subject Placeholder Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.IdentifiedSubject.subject_placeholder_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.IdentifiedSubject.subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>subjects</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>AssessmentSubject</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.IdentifiedSubject.subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.IdentifiedSubject-classes>Classes<a href=#trestle.oscal.common.IdentifiedSubject-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.IdentifiedSubject.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.IdentifiedSubject.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1928</span>
+<span class=normal>1929</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.IdentifiedSubject.Config-attributes>Attributes<a href=#trestle.oscal.common.IdentifiedSubject.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.IdentifiedSubject.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.IdentifiedSubject.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.IdentifierType class="doc doc-heading"> <code>IdentifierType</code> <a href=#trestle.oscal.common.IdentifierType class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Identifies the identification system from which the provided identifier was assigned.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>723</span>
+<span class=normal>724</span>
+<span class=normal>725</span>
+<span class=normal>726</span>
+<span class=normal>727</span>
+<span class=normal>728</span>
+<span class=normal>729</span>
+<span class=normal>730</span>
+<span class=normal>731</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>IdentifierType</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the identification system from which the provided identifier was assigned.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>https___fedramp_gov</span> <span class=o>=</span> <span class=s1>&#39;https://fedramp.gov&#39;</span>
+    <span class=n>http___fedramp_gov_ns_oscal</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov/ns/oscal&#39;</span>
+    <span class=n>https___ietf_org_rfc_rfc4122</span> <span class=o>=</span> <span class=s1>&#39;https://ietf.org/rfc/rfc4122&#39;</span>
+    <span class=n>http___ietf_org_rfc_rfc4122</span> <span class=o>=</span> <span class=s1>&#39;http://ietf.org/rfc/rfc4122&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.IdentifierType-attributes>Attributes<a href=#trestle.oscal.common.IdentifierType-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.IdentifierType.http___fedramp_gov_ns_oscal class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___fedramp_gov_ns_oscal</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov/ns/oscal&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.IdentifierType.http___fedramp_gov_ns_oscal class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.IdentifierType.http___ietf_org_rfc_rfc4122 class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___ietf_org_rfc_rfc4122</span> <span class=o>=</span> <span class=s1>&#39;http://ietf.org/rfc/rfc4122&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.IdentifierType.http___ietf_org_rfc_rfc4122 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.IdentifierType.https___fedramp_gov class="doc doc-heading"> <code class="highlight language-python"><span class=n>https___fedramp_gov</span> <span class=o>=</span> <span class=s1>&#39;https://fedramp.gov&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.IdentifierType.https___fedramp_gov class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.IdentifierType.https___ietf_org_rfc_rfc4122 class="doc doc-heading"> <code class="highlight language-python"><span class=n>https___ietf_org_rfc_rfc4122</span> <span class=o>=</span> <span class=s1>&#39;https://ietf.org/rfc/rfc4122&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.IdentifierType.https___ietf_org_rfc_rfc4122 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ImplementationStatus class="doc doc-heading"> <code>ImplementationStatus</code> <a href=#trestle.oscal.common.ImplementationStatus class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Indicates the degree to which the a given control is implemented.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span>
+<span class=normal>706</span>
+<span class=normal>707</span>
+<span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span>
+<span class=normal>714</span>
+<span class=normal>715</span>
+<span class=normal>716</span>
+<span class=normal>717</span>
+<span class=normal>718</span>
+<span class=normal>719</span>
+<span class=normal>720</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ImplementationStatus</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Indicates the degree to which the a given control is implemented.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>state</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>),</span>
+                 <span class=n>State</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+                     <span class=o>...</span><span class=p>,</span>
+                     <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the implementation status of the control or control objective.&#39;</span><span class=p>,</span>
+                     <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Implementation State&#39;</span>
+                 <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ImplementationStatus-attributes>Attributes<a href=#trestle.oscal.common.ImplementationStatus-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ImplementationStatus.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImplementationStatus.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ImplementationStatus.state class="doc doc-heading"> <code class="highlight language-python"><span class=n>state</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>),</span> <span class=n>State</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the implementation status of the control or control objective.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Implementation State&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImplementationStatus.state class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ImplementationStatus-classes>Classes<a href=#trestle.oscal.common.ImplementationStatus-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ImplementationStatus.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ImplementationStatus.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>708</span>
+<span class=normal>709</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ImplementationStatus.Config-attributes>Attributes<a href=#trestle.oscal.common.ImplementationStatus.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ImplementationStatus.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImplementationStatus.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ImplementedComponent class="doc doc-heading"> <code>ImplementedComponent</code> <a href=#trestle.oscal.common.ImplementedComponent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The set of components that are implemented in a given system inventory item.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1872</span>
+<span class=normal>1873</span>
+<span class=normal>1874</span>
+<span class=normal>1875</span>
+<span class=normal>1876</span>
+<span class=normal>1877</span>
+<span class=normal>1878</span>
+<span class=normal>1879</span>
+<span class=normal>1880</span>
+<span class=normal>1881</span>
+<span class=normal>1882</span>
+<span class=normal>1883</span>
+<span class=normal>1884</span>
+<span class=normal>1885</span>
+<span class=normal>1886</span>
+<span class=normal>1887</span>
+<span class=normal>1888</span>
+<span class=normal>1889</span>
+<span class=normal>1890</span>
+<span class=normal>1891</span>
+<span class=normal>1892</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ImplementedComponent</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The set of components that are implemented in a given system inventory item.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented identifier reference to a component that is implemented as part of an inventory item.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ImplementedComponent-attributes>Attributes<a href=#trestle.oscal.common.ImplementedComponent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ImplementedComponent.component_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a component that is implemented as part of an inventory item.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImplementedComponent.component_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ImplementedComponent.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImplementedComponent.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ImplementedComponent.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImplementedComponent.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ImplementedComponent.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImplementedComponent.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ImplementedComponent.responsible_parties class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImplementedComponent.responsible_parties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ImplementedComponent-classes>Classes<a href=#trestle.oscal.common.ImplementedComponent-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ImplementedComponent.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ImplementedComponent.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1877</span>
+<span class=normal>1878</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ImplementedComponent.Config-attributes>Attributes<a href=#trestle.oscal.common.ImplementedComponent.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ImplementedComponent.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImplementedComponent.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ImportSsp class="doc doc-heading"> <code>ImportSsp</code> <a href=#trestle.oscal.common.ImportSsp class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used by the assessment plan and POA&amp;M to import information about the system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span>
+<span class=normal>700</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ImportSsp</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used by the assessment plan and POA&amp;M to import information about the system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to the system security plan for the system being assessed.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Security Plan Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ImportSsp-attributes>Attributes<a href=#trestle.oscal.common.ImportSsp-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ImportSsp.href class="doc doc-heading"> <code class="highlight language-python"><span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to the system security plan for the system being assessed.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Security Plan Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImportSsp.href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ImportSsp.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImportSsp.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ImportSsp-classes>Classes<a href=#trestle.oscal.common.ImportSsp-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ImportSsp.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ImportSsp.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>692</span>
+<span class=normal>693</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ImportSsp.Config-attributes>Attributes<a href=#trestle.oscal.common.ImportSsp.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ImportSsp.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ImportSsp.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.IncludeAll class="doc doc-heading"> <code>IncludeAll</code> <a href=#trestle.oscal.common.IncludeAll class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Include all controls from the imported catalog or profile resources.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>IncludeAll</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Include all controls from the imported catalog or profile resources.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.IncludeAll-classes>Classes<a href=#trestle.oscal.common.IncludeAll-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.IncludeAll.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.IncludeAll.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>683</span>
+<span class=normal>684</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.IncludeAll.Config-attributes>Attributes<a href=#trestle.oscal.common.IncludeAll.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.IncludeAll.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.IncludeAll.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.IntegerDatatype class="doc doc-heading"> <code>IntegerDatatype</code> <a href=#trestle.oscal.common.IntegerDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>674</span>
+<span class=normal>675</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>IntegerDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A whole number value.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.IntegerDatatype-attributes>Attributes<a href=#trestle.oscal.common.IntegerDatatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.IntegerDatatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A whole number value.&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.IntegerDatatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.InventoryItem class="doc doc-heading"> <code>InventoryItem</code> <a href=#trestle.oscal.common.InventoryItem class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A single managed inventory item within the system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1895</span>
+<span class=normal>1896</span>
+<span class=normal>1897</span>
+<span class=normal>1898</span>
+<span class=normal>1899</span>
+<span class=normal>1900</span>
+<span class=normal>1901</span>
+<span class=normal>1902</span>
+<span class=normal>1903</span>
+<span class=normal>1904</span>
+<span class=normal>1905</span>
+<span class=normal>1906</span>
+<span class=normal>1907</span>
+<span class=normal>1908</span>
+<span class=normal>1909</span>
+<span class=normal>1910</span>
+<span class=normal>1911</span>
+<span class=normal>1912</span>
+<span class=normal>1913</span>
+<span class=normal>1914</span>
+<span class=normal>1915</span>
+<span class=normal>1916</span>
+<span class=normal>1917</span>
+<span class=normal>1918</span>
+<span class=normal>1919</span>
+<span class=normal>1920</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>InventoryItem</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A single managed inventory item within the system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this inventory item elsewhere in this or other OSCAL instances. The locally defined UUID of the inventory item can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Inventory Item Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the inventory item stating its purpose within the system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Inventory Item Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span>
+    <span class=n>implemented_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ImplementedComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implemented-components&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.InventoryItem-attributes>Attributes<a href=#trestle.oscal.common.InventoryItem-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.InventoryItem.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the inventory item stating its purpose within the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Inventory Item Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.InventoryItem.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.InventoryItem.implemented_components class="doc doc-heading"> <code class="highlight language-python"><span class=n>implemented_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ImplementedComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implemented-components&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.InventoryItem.implemented_components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.InventoryItem.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.InventoryItem.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.InventoryItem.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.InventoryItem.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.InventoryItem.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.InventoryItem.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.InventoryItem.responsible_parties class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.InventoryItem.responsible_parties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.InventoryItem.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this inventory item elsewhere in this or other OSCAL instances. The locally defined UUID of the inventory item can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Inventory Item Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.InventoryItem.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.InventoryItem-classes>Classes<a href=#trestle.oscal.common.InventoryItem-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.InventoryItem.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.InventoryItem.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1900</span>
+<span class=normal>1901</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.InventoryItem.Config-attributes>Attributes<a href=#trestle.oscal.common.InventoryItem.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.InventoryItem.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.InventoryItem.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.JsonSchemaDirective class="doc doc-heading"> <code>JsonSchemaDirective</code> <a href=#trestle.oscal.common.JsonSchemaDirective class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>666</span>
+<span class=normal>667</span>
+<span class=normal>668</span>
+<span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>JsonSchemaDirective</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>URIReferenceDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A JSON Schema directive to bind a specific schema to its document instance.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Schema Directive&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.JsonSchemaDirective-attributes>Attributes<a href=#trestle.oscal.common.JsonSchemaDirective-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.JsonSchemaDirective.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>URIReferenceDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A JSON Schema directive to bind a specific schema to its document instance.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Schema Directive&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.JsonSchemaDirective.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.LastModified class="doc doc-heading"> <code>LastModified</code> <a href=#trestle.oscal.common.LastModified class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1864</span>
+<span class=normal>1865</span>
+<span class=normal>1866</span>
+<span class=normal>1867</span>
+<span class=normal>1868</span>
+<span class=normal>1869</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LastModified</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>DateTimeWithTimezoneDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date and time the document was last stored for later retrieval.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Last Modified Timestamp&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.LastModified-attributes>Attributes<a href=#trestle.oscal.common.LastModified-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LastModified.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>DateTimeWithTimezoneDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date and time the document was last stored for later retrieval.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Last Modified Timestamp&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LastModified.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Lifecycle class="doc doc-heading"> <code>Lifecycle</code> <a href=#trestle.oscal.common.Lifecycle class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Identifies whether this is a recommendation, such as from an assessor or tool, or an actual plan accepted by the system owner.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>656</span>
+<span class=normal>657</span>
+<span class=normal>658</span>
+<span class=normal>659</span>
+<span class=normal>660</span>
+<span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Lifecycle</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies whether this is a recommendation, such as from an assessor or tool, or an actual plan accepted by the system owner.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>recommendation</span> <span class=o>=</span> <span class=s1>&#39;recommendation&#39;</span>
+    <span class=n>planned</span> <span class=o>=</span> <span class=s1>&#39;planned&#39;</span>
+    <span class=n>completed</span> <span class=o>=</span> <span class=s1>&#39;completed&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Lifecycle-attributes>Attributes<a href=#trestle.oscal.common.Lifecycle-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Lifecycle.completed class="doc doc-heading"> <code class="highlight language-python"><span class=n>completed</span> <span class=o>=</span> <span class=s1>&#39;completed&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Lifecycle.completed class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Lifecycle.planned class="doc doc-heading"> <code class="highlight language-python"><span class=n>planned</span> <span class=o>=</span> <span class=s1>&#39;planned&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Lifecycle.planned class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Lifecycle.recommendation class="doc doc-heading"> <code class="highlight language-python"><span class=n>recommendation</span> <span class=o>=</span> <span class=s1>&#39;recommendation&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Lifecycle.recommendation class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Link class="doc doc-heading"> <code>Link</code> <a href=#trestle.oscal.common.Link class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A reference to a local or remote resource, that has a specific relation to the containing object.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Link</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A reference to a local or remote resource, that has a specific relation to the containing object.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to a resource.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Hypertext Reference&#39;</span><span class=p>)</span>
+    <span class=n>rel</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span>
+        <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+            <span class=n>regex</span><span class=o>=</span>
+            <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+        <span class=p>),</span>
+              <span class=n>Rel</span><span class=p>]</span>
+    <span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;Describes the type of relationship provided by the link&#39;s hypertext reference. This can be an indicator of the link&#39;s purpose.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Link Relation Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>media_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;media-type&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A label that indicates the nature of a resource, as a data serialization or format.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Media Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>resource_fragment</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;resource-fragment&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;In case where the href points to a back-matter/resource, this value will indicate the URI fragment to append to any rlink associated with the resource. This value MUST be URI encoded.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Resource Fragment&#39;</span>
+    <span class=p>)</span>
+    <span class=n>text</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label to associate with the link, which may be used for presentation in a tool.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Link Text&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Link-attributes>Attributes<a href=#trestle.oscal.common.Link-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Link.href class="doc doc-heading"> <code class="highlight language-python"><span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to a resource.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Hypertext Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Link.href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Link.media_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>media_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;media-type&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A label that indicates the nature of a resource, as a data serialization or format.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Media Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Link.media_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Link.rel class="doc doc-heading"> <code class="highlight language-python"><span class=n>rel</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>),</span> <span class=n>Rel</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;Describes the type of relationship provided by the link&#39;s hypertext reference. This can be an indicator of the link&#39;s purpose.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Link Relation Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Link.rel class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Link.resource_fragment class="doc doc-heading"> <code class="highlight language-python"><span class=n>resource_fragment</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;resource-fragment&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;In case where the href points to a back-matter/resource, this value will indicate the URI fragment to append to any rlink associated with the resource. This value MUST be URI encoded.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Resource Fragment&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Link.resource_fragment class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Link.text class="doc doc-heading"> <code class="highlight language-python"><span class=n>text</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label to associate with the link, which may be used for presentation in a tool.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Link Text&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Link.text class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Link-classes>Classes<a href=#trestle.oscal.common.Link-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Link.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Link.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>620</span>
+<span class=normal>621</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Link.Config-attributes>Attributes<a href=#trestle.oscal.common.Link.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Link.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Link.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.LocalObjective class="doc doc-heading"> <code>LocalObjective</code> <a href=#trestle.oscal.common.LocalObjective class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A local definition of a control objective for this assessment. Uses catalog syntax for control objective and assessment actions.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1739</span>
+<span class=normal>1740</span>
+<span class=normal>1741</span>
+<span class=normal>1742</span>
+<span class=normal>1743</span>
+<span class=normal>1744</span>
+<span class=normal>1745</span>
+<span class=normal>1746</span>
+<span class=normal>1747</span>
+<span class=normal>1748</span>
+<span class=normal>1749</span>
+<span class=normal>1750</span>
+<span class=normal>1751</span>
+<span class=normal>1752</span>
+<span class=normal>1753</span>
+<span class=normal>1754</span>
+<span class=normal>1755</span>
+<span class=normal>1756</span>
+<span class=normal>1757</span>
+<span class=normal>1758</span>
+<span class=normal>1759</span>
+<span class=normal>1760</span>
+<span class=normal>1761</span>
+<span class=normal>1762</span>
+<span class=normal>1763</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LocalObjective</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A local definition of a control objective for this assessment. Uses catalog syntax for control objective and assessment actions.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this control objective.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Part</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.LocalObjective-attributes>Attributes<a href=#trestle.oscal.common.LocalObjective-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LocalObjective.control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LocalObjective.control_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LocalObjective.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this control objective.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LocalObjective.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LocalObjective.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LocalObjective.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LocalObjective.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Part</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LocalObjective.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LocalObjective.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LocalObjective.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LocalObjective.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LocalObjective.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.LocalObjective-classes>Classes<a href=#trestle.oscal.common.LocalObjective-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.LocalObjective.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.LocalObjective.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1744</span>
+<span class=normal>1745</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.LocalObjective.Config-attributes>Attributes<a href=#trestle.oscal.common.LocalObjective.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.LocalObjective.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LocalObjective.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Location class="doc doc-heading"> <code>Location</code> <a href=#trestle.oscal.common.Location class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A physical point of presence, which may be associated with people, organizations, or other concepts within the current or linked OSCAL document.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1198</span>
+<span class=normal>1199</span>
+<span class=normal>1200</span>
+<span class=normal>1201</span>
+<span class=normal>1202</span>
+<span class=normal>1203</span>
+<span class=normal>1204</span>
+<span class=normal>1205</span>
+<span class=normal>1206</span>
+<span class=normal>1207</span>
+<span class=normal>1208</span>
+<span class=normal>1209</span>
+<span class=normal>1210</span>
+<span class=normal>1211</span>
+<span class=normal>1212</span>
+<span class=normal>1213</span>
+<span class=normal>1214</span>
+<span class=normal>1215</span>
+<span class=normal>1216</span>
+<span class=normal>1217</span>
+<span class=normal>1218</span>
+<span class=normal>1219</span>
+<span class=normal>1220</span>
+<span class=normal>1221</span>
+<span class=normal>1222</span>
+<span class=normal>1223</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Location</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A physical point of presence, which may be associated with people, organizations, or other concepts within the current or linked OSCAL document.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+                 <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+                     <span class=o>...</span><span class=p>,</span>
+                     <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique ID for the location, for reference.&#39;</span><span class=p>,</span>
+                     <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Location Universally Unique Identifier&#39;</span>
+                 <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the location, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Location Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>address</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Address</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>email_addresses</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>EmailAddress</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;email-addresses&#39;</span><span class=p>)</span>
+    <span class=n>telephone_numbers</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TelephoneNumber</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;telephone-numbers&#39;</span><span class=p>)</span>
+    <span class=n>urls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Location-attributes>Attributes<a href=#trestle.oscal.common.Location-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Location.address class="doc doc-heading"> <code class="highlight language-python"><span class=n>address</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Address</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.address class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Location.email_addresses class="doc doc-heading"> <code class="highlight language-python"><span class=n>email_addresses</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>EmailAddress</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;email-addresses&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.email_addresses class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Location.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Location.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Location.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Location.telephone_numbers class="doc doc-heading"> <code class="highlight language-python"><span class=n>telephone_numbers</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TelephoneNumber</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;telephone-numbers&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.telephone_numbers class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Location.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the location, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Location Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Location.urls class="doc doc-heading"> <code class="highlight language-python"><span class=n>urls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.urls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Location.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique ID for the location, for reference.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Location Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Location-classes>Classes<a href=#trestle.oscal.common.Location-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Location.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Location.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1203</span>
+<span class=normal>1204</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Location.Config-attributes>Attributes<a href=#trestle.oscal.common.Location.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Location.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Location.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.LocationUuid class="doc doc-heading"> <code>LocationUuid</code> <a href=#trestle.oscal.common.LocationUuid class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LocationUuid</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>UUIDDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Reference to a location by UUID.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Location Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.LocationUuid-attributes>Attributes<a href=#trestle.oscal.common.LocationUuid-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LocationUuid.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>UUIDDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Reference to a location by UUID.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Location Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LocationUuid.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.LoggedBy class="doc doc-heading"> <code>LoggedBy</code> <a href=#trestle.oscal.common.LoggedBy class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to indicate who created a log entry in what role.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LoggedBy</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to indicate who created a log entry in what role.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>party_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;party-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the party who is making the log entry.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party UUID Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>role_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A point to the role-id of the role in which the party is making the log entry.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Actor Role&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.LoggedBy-attributes>Attributes<a href=#trestle.oscal.common.LoggedBy-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LoggedBy.party_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>party_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;party-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the party who is making the log entry.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party UUID Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LoggedBy.party_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.LoggedBy.role_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>role_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A point to the role-id of the role in which the party is making the log entry.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Actor Role&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LoggedBy.role_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.LoggedBy-classes>Classes<a href=#trestle.oscal.common.LoggedBy-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.LoggedBy.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.LoggedBy.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>587</span>
+<span class=normal>588</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.LoggedBy.Config-attributes>Attributes<a href=#trestle.oscal.common.LoggedBy.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.LoggedBy.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.LoggedBy.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Metadata class="doc doc-heading"> <code>Metadata</code> <a href=#trestle.oscal.common.Metadata class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Provides information about the containing document, and defines concepts that are shared across the document.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2243</span>
+<span class=normal>2244</span>
+<span class=normal>2245</span>
+<span class=normal>2246</span>
+<span class=normal>2247</span>
+<span class=normal>2248</span>
+<span class=normal>2249</span>
+<span class=normal>2250</span>
+<span class=normal>2251</span>
+<span class=normal>2252</span>
+<span class=normal>2253</span>
+<span class=normal>2254</span>
+<span class=normal>2255</span>
+<span class=normal>2256</span>
+<span class=normal>2257</span>
+<span class=normal>2258</span>
+<span class=normal>2259</span>
+<span class=normal>2260</span>
+<span class=normal>2261</span>
+<span class=normal>2262</span>
+<span class=normal>2263</span>
+<span class=normal>2264</span>
+<span class=normal>2265</span>
+<span class=normal>2266</span>
+<span class=normal>2267</span>
+<span class=normal>2268</span>
+<span class=normal>2269</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Metadata</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Provides information about the containing document, and defines concepts that are shared across the document.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the document, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Document Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>published</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>last_modified</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;last-modified&#39;</span><span class=p>)</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span>
+    <span class=n>oscal_version</span><span class=p>:</span> <span class=n>OscalVersion</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;oscal-version&#39;</span><span class=p>)</span>
+    <span class=n>revisions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Revision</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>document_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>DocumentId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;document-ids&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Role</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>locations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Location</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Party</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span>
+    <span class=n>actions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Metadata-attributes>Attributes<a href=#trestle.oscal.common.Metadata-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.actions class="doc doc-heading"> <code class="highlight language-python"><span class=n>actions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Action</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.actions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.document_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>document_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>DocumentId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;document-ids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.document_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.last_modified class="doc doc-heading"> <code class="highlight language-python"><span class=n>last_modified</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;last-modified&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.last_modified class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.locations class="doc doc-heading"> <code class="highlight language-python"><span class=n>locations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Location</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.locations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.oscal_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>oscal_version</span><span class=p>:</span> <span class=n>OscalVersion</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;oscal-version&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.oscal_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.parties class="doc doc-heading"> <code class="highlight language-python"><span class=n>parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Party</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.parties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.published class="doc doc-heading"> <code class="highlight language-python"><span class=n>published</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.published class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.responsible_parties class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.responsible_parties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.revisions class="doc doc-heading"> <code class="highlight language-python"><span class=n>revisions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Revision</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.revisions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Role</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the document, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Document Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Metadata.version class="doc doc-heading"> <code class="highlight language-python"><span class=n>version</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Metadata-classes>Classes<a href=#trestle.oscal.common.Metadata-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Metadata.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Metadata.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2248</span>
+<span class=normal>2249</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Metadata.Config-attributes>Attributes<a href=#trestle.oscal.common.Metadata.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Metadata.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Metadata.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Methods class="doc doc-heading"> <code>Methods</code> <a href=#trestle.oscal.common.Methods class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Identifies how the observation was made.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Methods</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies how the observation was made.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>EXAMINE</span> <span class=o>=</span> <span class=s1>&#39;EXAMINE&#39;</span>
+    <span class=n>INTERVIEW</span> <span class=o>=</span> <span class=s1>&#39;INTERVIEW&#39;</span>
+    <span class=n>TEST</span> <span class=o>=</span> <span class=s1>&#39;TEST&#39;</span>
+    <span class=n>UNKNOWN</span> <span class=o>=</span> <span class=s1>&#39;UNKNOWN&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Methods-attributes>Attributes<a href=#trestle.oscal.common.Methods-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Methods.EXAMINE class="doc doc-heading"> <code class="highlight language-python"><span class=n>EXAMINE</span> <span class=o>=</span> <span class=s1>&#39;EXAMINE&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Methods.EXAMINE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Methods.INTERVIEW class="doc doc-heading"> <code class="highlight language-python"><span class=n>INTERVIEW</span> <span class=o>=</span> <span class=s1>&#39;INTERVIEW&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Methods.INTERVIEW class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Methods.TEST class="doc doc-heading"> <code class="highlight language-python"><span class=n>TEST</span> <span class=o>=</span> <span class=s1>&#39;TEST&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Methods.TEST class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Methods.UNKNOWN class="doc doc-heading"> <code class="highlight language-python"><span class=n>UNKNOWN</span> <span class=o>=</span> <span class=s1>&#39;UNKNOWN&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Methods.UNKNOWN class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.MitigatingFactor class="doc doc-heading"> <code>MitigatingFactor</code> <a href=#trestle.oscal.common.MitigatingFactor class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes an existing mitigating factor that may affect the overall determination of the risk, with an optional link to an implementation statement in the SSP.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1315</span>
+<span class=normal>1316</span>
+<span class=normal>1317</span>
+<span class=normal>1318</span>
+<span class=normal>1319</span>
+<span class=normal>1320</span>
+<span class=normal>1321</span>
+<span class=normal>1322</span>
+<span class=normal>1323</span>
+<span class=normal>1324</span>
+<span class=normal>1325</span>
+<span class=normal>1326</span>
+<span class=normal>1327</span>
+<span class=normal>1328</span>
+<span class=normal>1329</span>
+<span class=normal>1330</span>
+<span class=normal>1331</span>
+<span class=normal>1332</span>
+<span class=normal>1333</span>
+<span class=normal>1334</span>
+<span class=normal>1335</span>
+<span class=normal>1336</span>
+<span class=normal>1337</span>
+<span class=normal>1338</span>
+<span class=normal>1339</span>
+<span class=normal>1340</span>
+<span class=normal>1341</span>
+<span class=normal>1342</span>
+<span class=normal>1343</span>
+<span class=normal>1344</span>
+<span class=normal>1345</span>
+<span class=normal>1346</span>
+<span class=normal>1347</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>MitigatingFactor</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes an existing mitigating factor that may affect the overall determination of the risk, with an optional link to an implementation statement in the SSP.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this mitigating factor elsewhere in this or other OSCAL instances. The locally defined UUID of the mitigating factor can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Mitigating Factor Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>implementation_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this implementation statement elsewhere in this or other OSCAL instancess. The locally defined UUID of the implementation statement can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Implementation UUID&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this mitigating factor.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Mitigating Factor Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SubjectReference</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.MitigatingFactor-attributes>Attributes<a href=#trestle.oscal.common.MitigatingFactor-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.MitigatingFactor.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this mitigating factor.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Mitigating Factor Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.MitigatingFactor.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.MitigatingFactor.implementation_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>implementation_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this implementation statement elsewhere in this or other OSCAL instancess. The locally defined UUID of the implementation statement can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Implementation UUID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.MitigatingFactor.implementation_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.MitigatingFactor.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.MitigatingFactor.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.MitigatingFactor.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.MitigatingFactor.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.MitigatingFactor.subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SubjectReference</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.MitigatingFactor.subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.MitigatingFactor.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this mitigating factor elsewhere in this or other OSCAL instances. The locally defined UUID of the mitigating factor can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Mitigating Factor Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.MitigatingFactor.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.MitigatingFactor-classes>Classes<a href=#trestle.oscal.common.MitigatingFactor-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.MitigatingFactor.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.MitigatingFactor.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1320</span>
+<span class=normal>1321</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.MitigatingFactor.Config-attributes>Attributes<a href=#trestle.oscal.common.MitigatingFactor.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.MitigatingFactor.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.MitigatingFactor.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Name class="doc doc-heading"> <code>Name</code> <a href=#trestle.oscal.common.Name class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>A textual label that uniquely identifies the part's semantic type.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Name</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A textual label that uniquely identifies the part&#39;s semantic type.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>asset</span> <span class=o>=</span> <span class=s1>&#39;asset&#39;</span>
+    <span class=n>method</span> <span class=o>=</span> <span class=s1>&#39;method&#39;</span>
+    <span class=n>objective</span> <span class=o>=</span> <span class=s1>&#39;objective&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Name-attributes>Attributes<a href=#trestle.oscal.common.Name-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Name.asset class="doc doc-heading"> <code class="highlight language-python"><span class=n>asset</span> <span class=o>=</span> <span class=s1>&#39;asset&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Name.asset class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Name.method class="doc doc-heading"> <code class="highlight language-python"><span class=n>method</span> <span class=o>=</span> <span class=s1>&#39;method&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Name.method class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Name.objective class="doc doc-heading"> <code class="highlight language-python"><span class=n>objective</span> <span class=o>=</span> <span class=s1>&#39;objective&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Name.objective class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.NamingSystemValidValues class="doc doc-heading"> <code>NamingSystemValidValues</code> <a href=#trestle.oscal.common.NamingSystemValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>NamingSystemValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>http___fedramp_gov</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov&#39;</span>
+    <span class=n>http___fedramp_gov_ns_oscal</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov/ns/oscal&#39;</span>
+    <span class=n>http___csrc_nist_gov_ns_oscal</span> <span class=o>=</span> <span class=s1>&#39;http://csrc.nist.gov/ns/oscal&#39;</span>
+    <span class=n>http___csrc_nist_gov_ns_oscal_unknown</span> <span class=o>=</span> <span class=s1>&#39;http://csrc.nist.gov/ns/oscal/unknown&#39;</span>
+    <span class=n>http___cve_mitre_org</span> <span class=o>=</span> <span class=s1>&#39;http://cve.mitre.org&#39;</span>
+    <span class=n>http___www_first_org_cvss_v2_0</span> <span class=o>=</span> <span class=s1>&#39;http://www.first.org/cvss/v2.0&#39;</span>
+    <span class=n>http___www_first_org_cvss_v3_0</span> <span class=o>=</span> <span class=s1>&#39;http://www.first.org/cvss/v3.0&#39;</span>
+    <span class=n>http___www_first_org_cvss_v3_1</span> <span class=o>=</span> <span class=s1>&#39;http://www.first.org/cvss/v3.1&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.NamingSystemValidValues-attributes>Attributes<a href=#trestle.oscal.common.NamingSystemValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___csrc_nist_gov_ns_oscal</span> <span class=o>=</span> <span class=s1>&#39;http://csrc.nist.gov/ns/oscal&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal_unknown class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___csrc_nist_gov_ns_oscal_unknown</span> <span class=o>=</span> <span class=s1>&#39;http://csrc.nist.gov/ns/oscal/unknown&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal_unknown class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.NamingSystemValidValues.http___cve_mitre_org class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___cve_mitre_org</span> <span class=o>=</span> <span class=s1>&#39;http://cve.mitre.org&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.NamingSystemValidValues.http___cve_mitre_org class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___fedramp_gov</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov_ns_oscal class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___fedramp_gov_ns_oscal</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov/ns/oscal&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov_ns_oscal class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v2_0 class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___www_first_org_cvss_v2_0</span> <span class=o>=</span> <span class=s1>&#39;http://www.first.org/cvss/v2.0&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v2_0 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_0 class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___www_first_org_cvss_v3_0</span> <span class=o>=</span> <span class=s1>&#39;http://www.first.org/cvss/v3.0&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_0 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_1 class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___www_first_org_cvss_v3_1</span> <span class=o>=</span> <span class=s1>&#39;http://www.first.org/cvss/v3.1&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_1 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.NonNegativeIntegerDatatype class="doc doc-heading"> <code>NonNegativeIntegerDatatype</code> <a href=#trestle.oscal.common.NonNegativeIntegerDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An integer value that is equal to or greater than 0.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>NonNegativeIntegerDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An integer value that is equal to or greater than 0.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ObjectiveStatus class="doc doc-heading"> <code>ObjectiveStatus</code> <a href=#trestle.oscal.common.ObjectiveStatus class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A determination of if the objective is satisfied or not within a given system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ObjectiveStatus</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A determination of if the objective is satisfied or not within a given system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>state</span><span class=p>:</span> <span class=n>ObjectiveStatusStateValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An indication as to whether the objective is satisfied or not.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status State&#39;</span>
+    <span class=p>)</span>
+    <span class=n>reason</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>),</span>
+                           <span class=n>Reason</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+                               <span class=kc>None</span><span class=p>,</span>
+                               <span class=n>description</span><span class=o>=</span><span class=s2>&quot;The reason the objective was given it&#39;s status.&quot;</span><span class=p>,</span>
+                               <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status Reason&#39;</span>
+                           <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ObjectiveStatus-attributes>Attributes<a href=#trestle.oscal.common.ObjectiveStatus-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObjectiveStatus.reason class="doc doc-heading"> <code class="highlight language-python"><span class=n>reason</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>),</span> <span class=n>Reason</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;The reason the objective was given it&#39;s status.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status Reason&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObjectiveStatus.reason class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObjectiveStatus.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObjectiveStatus.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObjectiveStatus.state class="doc doc-heading"> <code class="highlight language-python"><span class=n>state</span><span class=p>:</span> <span class=n>ObjectiveStatusStateValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An indication as to whether the objective is satisfied or not.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective Status State&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObjectiveStatus.state class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ObjectiveStatus-classes>Classes<a href=#trestle.oscal.common.ObjectiveStatus-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ObjectiveStatus.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ObjectiveStatus.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>524</span>
+<span class=normal>525</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ObjectiveStatus.Config-attributes>Attributes<a href=#trestle.oscal.common.ObjectiveStatus.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ObjectiveStatus.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObjectiveStatus.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ObjectiveStatusStateValidValues class="doc doc-heading"> <code>ObjectiveStatusStateValidValues</code> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ObjectiveStatusStateValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>satisfied</span> <span class=o>=</span> <span class=s1>&#39;satisfied&#39;</span>
+    <span class=n>not_satisfied</span> <span class=o>=</span> <span class=s1>&#39;not-satisfied&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ObjectiveStatusStateValidValues-attributes>Attributes<a href=#trestle.oscal.common.ObjectiveStatusStateValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObjectiveStatusStateValidValues.not_satisfied class="doc doc-heading"> <code class="highlight language-python"><span class=n>not_satisfied</span> <span class=o>=</span> <span class=s1>&#39;not-satisfied&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues.not_satisfied class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObjectiveStatusStateValidValues.satisfied class="doc doc-heading"> <code class="highlight language-python"><span class=n>satisfied</span> <span class=o>=</span> <span class=s1>&#39;satisfied&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObjectiveStatusStateValidValues.satisfied class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Observation class="doc doc-heading"> <code>Observation</code> <a href=#trestle.oscal.common.Observation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes an individual observation.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2389</span>
+<span class=normal>2390</span>
+<span class=normal>2391</span>
+<span class=normal>2392</span>
+<span class=normal>2393</span>
+<span class=normal>2394</span>
+<span class=normal>2395</span>
+<span class=normal>2396</span>
+<span class=normal>2397</span>
+<span class=normal>2398</span>
+<span class=normal>2399</span>
+<span class=normal>2400</span>
+<span class=normal>2401</span>
+<span class=normal>2402</span>
+<span class=normal>2403</span>
+<span class=normal>2404</span>
+<span class=normal>2405</span>
+<span class=normal>2406</span>
+<span class=normal>2407</span>
+<span class=normal>2408</span>
+<span class=normal>2409</span>
+<span class=normal>2410</span>
+<span class=normal>2411</span>
+<span class=normal>2412</span>
+<span class=normal>2413</span>
+<span class=normal>2414</span>
+<span class=normal>2415</span>
+<span class=normal>2416</span>
+<span class=normal>2417</span>
+<span class=normal>2418</span>
+<span class=normal>2419</span>
+<span class=normal>2420</span>
+<span class=normal>2421</span>
+<span class=normal>2422</span>
+<span class=normal>2423</span>
+<span class=normal>2424</span>
+<span class=normal>2425</span>
+<span class=normal>2426</span>
+<span class=normal>2427</span>
+<span class=normal>2428</span>
+<span class=normal>2429</span>
+<span class=normal>2430</span>
+<span class=normal>2431</span>
+<span class=normal>2432</span>
+<span class=normal>2433</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Observation</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes an individual observation.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this observation elsewhere in this or other OSCAL instances. The locally defined UUID of the observation can be used to reference the data item locally or globally (e.g., in an imorted OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Observation Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this observation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Observation Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this assessment observation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Observation Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>methods</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>),</span> <span class=n>Methods</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>types</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>),</span>
+                               <span class=n>ObservationTypeValidValues</span><span class=p>]]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origin</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SubjectReference</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>relevant_evidence</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelevantEvidence</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;relevant-evidence&#39;</span><span class=p>)</span>
+    <span class=n>collected</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Date/time stamp identifying when the finding information was collected.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Collected Field&#39;</span>
+    <span class=p>)</span>
+    <span class=n>expires</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Date/time identifying when the finding information is out-of-date and no longer valid. Typically used with continuous assessment scenarios.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Expires Field&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Observation-attributes>Attributes<a href=#trestle.oscal.common.Observation-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.collected class="doc doc-heading"> <code class="highlight language-python"><span class=n>collected</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Date/time stamp identifying when the finding information was collected.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Collected Field&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.collected class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this assessment observation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Observation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.expires class="doc doc-heading"> <code class="highlight language-python"><span class=n>expires</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Date/time identifying when the finding information is out-of-date and no longer valid. Typically used with continuous assessment scenarios.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Expires Field&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.expires class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.methods class="doc doc-heading"> <code class="highlight language-python"><span class=n>methods</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>),</span> <span class=n>Methods</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.methods class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.origins class="doc doc-heading"> <code class="highlight language-python"><span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origin</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.origins class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.relevant_evidence class="doc doc-heading"> <code class="highlight language-python"><span class=n>relevant_evidence</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelevantEvidence</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;relevant-evidence&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.relevant_evidence class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SubjectReference</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this observation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Observation Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.types class="doc doc-heading"> <code class="highlight language-python"><span class=n>types</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>),</span> <span class=n>ObservationTypeValidValues</span><span class=p>]]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.types class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Observation.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this observation elsewhere in this or other OSCAL instances. The locally defined UUID of the observation can be used to reference the data item locally or globally (e.g., in an imorted OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Observation Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Observation-classes>Classes<a href=#trestle.oscal.common.Observation-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Observation.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Observation.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2394</span>
+<span class=normal>2395</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Observation.Config-attributes>Attributes<a href=#trestle.oscal.common.Observation.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Observation.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Observation.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ObservationTypeValidValues class="doc doc-heading"> <code>ObservationTypeValidValues</code> <a href=#trestle.oscal.common.ObservationTypeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ObservationTypeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>ssp_statement_issue</span> <span class=o>=</span> <span class=s1>&#39;ssp-statement-issue&#39;</span>
+    <span class=n>control_objective</span> <span class=o>=</span> <span class=s1>&#39;control-objective&#39;</span>
+    <span class=n>mitigation</span> <span class=o>=</span> <span class=s1>&#39;mitigation&#39;</span>
+    <span class=n>finding</span> <span class=o>=</span> <span class=s1>&#39;finding&#39;</span>
+    <span class=n>historic</span> <span class=o>=</span> <span class=s1>&#39;historic&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ObservationTypeValidValues-attributes>Attributes<a href=#trestle.oscal.common.ObservationTypeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObservationTypeValidValues.control_objective class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_objective</span> <span class=o>=</span> <span class=s1>&#39;control-objective&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObservationTypeValidValues.control_objective class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObservationTypeValidValues.finding class="doc doc-heading"> <code class="highlight language-python"><span class=n>finding</span> <span class=o>=</span> <span class=s1>&#39;finding&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObservationTypeValidValues.finding class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObservationTypeValidValues.historic class="doc doc-heading"> <code class="highlight language-python"><span class=n>historic</span> <span class=o>=</span> <span class=s1>&#39;historic&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObservationTypeValidValues.historic class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObservationTypeValidValues.mitigation class="doc doc-heading"> <code class="highlight language-python"><span class=n>mitigation</span> <span class=o>=</span> <span class=s1>&#39;mitigation&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObservationTypeValidValues.mitigation class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ObservationTypeValidValues.ssp_statement_issue class="doc doc-heading"> <code class="highlight language-python"><span class=n>ssp_statement_issue</span> <span class=o>=</span> <span class=s1>&#39;ssp-statement-issue&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ObservationTypeValidValues.ssp_statement_issue class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.OnDate class="doc doc-heading"> <code>OnDate</code> <a href=#trestle.oscal.common.OnDate class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The task is intended to occur on the specified date.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OnDate</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The task is intended to occur on the specified date.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>date</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task must occur on the specified date.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;On Date Condition&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.OnDate-attributes>Attributes<a href=#trestle.oscal.common.OnDate-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OnDate.date class="doc doc-heading"> <code class="highlight language-python"><span class=n>date</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task must occur on the specified date.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;On Date Condition&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OnDate.date class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.OnDate-classes>Classes<a href=#trestle.oscal.common.OnDate-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.OnDate.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.OnDate.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>500</span>
+<span class=normal>501</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.OnDate.Config-attributes>Attributes<a href=#trestle.oscal.common.OnDate.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.OnDate.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OnDate.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Origin class="doc doc-heading"> <code>Origin</code> <a href=#trestle.oscal.common.Origin class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies the source of the finding, such as a tool, interviewed person, or activity.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1972</span>
+<span class=normal>1973</span>
+<span class=normal>1974</span>
+<span class=normal>1975</span>
+<span class=normal>1976</span>
+<span class=normal>1977</span>
+<span class=normal>1978</span>
+<span class=normal>1979</span>
+<span class=normal>1980</span>
+<span class=normal>1981</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Origin</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the source of the finding, such as a tool, interviewed person, or activity.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>actors</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OriginActor</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>related_tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedTask</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-tasks&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Origin-attributes>Attributes<a href=#trestle.oscal.common.Origin-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Origin.actors class="doc doc-heading"> <code class="highlight language-python"><span class=n>actors</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>OriginActor</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Origin.actors class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Origin.related_tasks class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedTask</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-tasks&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Origin.related_tasks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Origin-classes>Classes<a href=#trestle.oscal.common.Origin-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Origin.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Origin.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1977</span>
+<span class=normal>1978</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Origin.Config-attributes>Attributes<a href=#trestle.oscal.common.Origin.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Origin.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Origin.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.OriginActor class="doc doc-heading"> <code>OriginActor</code> <a href=#trestle.oscal.common.OriginActor class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The actor that produces an observation, a finding, or a risk. One or more actor type can be used to specify a person that is using a tool.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1834</span>
+<span class=normal>1835</span>
+<span class=normal>1836</span>
+<span class=normal>1837</span>
+<span class=normal>1838</span>
+<span class=normal>1839</span>
+<span class=normal>1840</span>
+<span class=normal>1841</span>
+<span class=normal>1842</span>
+<span class=normal>1843</span>
+<span class=normal>1844</span>
+<span class=normal>1845</span>
+<span class=normal>1846</span>
+<span class=normal>1847</span>
+<span class=normal>1848</span>
+<span class=normal>1849</span>
+<span class=normal>1850</span>
+<span class=normal>1851</span>
+<span class=normal>1852</span>
+<span class=normal>1853</span>
+<span class=normal>1854</span>
+<span class=normal>1855</span>
+<span class=normal>1856</span>
+<span class=normal>1857</span>
+<span class=normal>1858</span>
+<span class=normal>1859</span>
+<span class=normal>1860</span>
+<span class=normal>1861</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OriginActor</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The actor that produces an observation, a finding, or a risk. One or more actor type can be used to specify a person that is using a tool.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>type</span><span class=p>:</span> <span class=n>OriginActorValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The kind of actor.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Actor Type&#39;</span><span class=p>)</span>
+    <span class=n>actor_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;actor-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the tool or person based on the associated type.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Actor Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>role_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;For a party, this can optionally be used to specify the role the actor was performing.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Actor Role&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.OriginActor-attributes>Attributes<a href=#trestle.oscal.common.OriginActor-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OriginActor.actor_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>actor_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;actor-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the tool or person based on the associated type.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Actor Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OriginActor.actor_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OriginActor.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OriginActor.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OriginActor.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OriginActor.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OriginActor.role_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>role_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;For a party, this can optionally be used to specify the role the actor was performing.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Actor Role&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OriginActor.role_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OriginActor.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>OriginActorValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The kind of actor.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Actor Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OriginActor.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.OriginActor-classes>Classes<a href=#trestle.oscal.common.OriginActor-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.OriginActor.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.OriginActor.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1839</span>
+<span class=normal>1840</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.OriginActor.Config-attributes>Attributes<a href=#trestle.oscal.common.OriginActor.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.OriginActor.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OriginActor.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.OriginActorValidValues class="doc doc-heading"> <code>OriginActorValidValues</code> <a href=#trestle.oscal.common.OriginActorValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OriginActorValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>tool</span> <span class=o>=</span> <span class=s1>&#39;tool&#39;</span>
+    <span class=n>assessment_platform</span> <span class=o>=</span> <span class=s1>&#39;assessment-platform&#39;</span>
+    <span class=n>party</span> <span class=o>=</span> <span class=s1>&#39;party&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.OriginActorValidValues-attributes>Attributes<a href=#trestle.oscal.common.OriginActorValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OriginActorValidValues.assessment_platform class="doc doc-heading"> <code class="highlight language-python"><span class=n>assessment_platform</span> <span class=o>=</span> <span class=s1>&#39;assessment-platform&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OriginActorValidValues.assessment_platform class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OriginActorValidValues.party class="doc doc-heading"> <code class="highlight language-python"><span class=n>party</span> <span class=o>=</span> <span class=s1>&#39;party&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OriginActorValidValues.party class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OriginActorValidValues.tool class="doc doc-heading"> <code class="highlight language-python"><span class=n>tool</span> <span class=o>=</span> <span class=s1>&#39;tool&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OriginActorValidValues.tool class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.OscalVersion class="doc doc-heading"> <code>OscalVersion</code> <a href=#trestle.oscal.common.OscalVersion class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OscalVersion</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The OSCAL model version the document was authored against and will conform to as valid.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;OSCAL Version&#39;</span>
+    <span class=p>)</span>
+
+    <span class=nd>@validator</span><span class=p>(</span><span class=s1>&#39;__root__&#39;</span><span class=p>)</span>
+    <span class=k>def</span> <span class=nf>oscal_version_is_valid</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>v</span><span class=p>):</span>
+        <span class=n>strict_version</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>strict_version</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>v</span>
+        <span class=n>p</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>OSCAL_VERSION_REGEX</span><span class=p>)</span>
+        <span class=n>matched</span> <span class=o>=</span> <span class=n>p</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>v</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>matched</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=ne>ValueError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;OSCAL version: </span><span class=si>{</span><span class=n>v</span><span class=si>}</span><span class=s1> is not supported, use </span><span class=si>{</span><span class=n>OSCAL_VERSION</span><span class=si>}</span><span class=s1> instead.&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>v</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.OscalVersion-attributes>Attributes<a href=#trestle.oscal.common.OscalVersion-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.OscalVersion.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The OSCAL model version the document was authored against and will conform to as valid.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;OSCAL Version&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.OscalVersion.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.OscalVersion-functions>Functions<a href=#trestle.oscal.common.OscalVersion-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.oscal.common.OscalVersion.oscal_version_is_valid class="doc doc-heading"> <code class="highlight language-python"><span class=n>oscal_version_is_valid</span><span class=p>(</span><span class=n>v</span><span class=p>)</span></code> <a href=#trestle.oscal.common.OscalVersion.oscal_version_is_valid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@validator</span><span class=p>(</span><span class=s1>&#39;__root__&#39;</span><span class=p>)</span>
+<span class=k>def</span> <span class=nf>oscal_version_is_valid</span><span class=p>(</span><span class=bp>cls</span><span class=p>,</span> <span class=n>v</span><span class=p>):</span>
+    <span class=n>strict_version</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>strict_version</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>v</span>
+    <span class=n>p</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>compile</span><span class=p>(</span><span class=n>OSCAL_VERSION_REGEX</span><span class=p>)</span>
+    <span class=n>matched</span> <span class=o>=</span> <span class=n>p</span><span class=o>.</span><span class=n>match</span><span class=p>(</span><span class=n>v</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>matched</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=ne>ValueError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;OSCAL version: </span><span class=si>{</span><span class=n>v</span><span class=si>}</span><span class=s1> is not supported, use </span><span class=si>{</span><span class=n>OSCAL_VERSION</span><span class=si>}</span><span class=s1> instead.&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>v</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Parameter class="doc doc-heading"> <code>Parameter</code> <a href=#trestle.oscal.common.Parameter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Parameters provide a mechanism for the dynamic assignment of value(s) in a control.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1784</span>
+<span class=normal>1785</span>
+<span class=normal>1786</span>
+<span class=normal>1787</span>
+<span class=normal>1788</span>
+<span class=normal>1789</span>
+<span class=normal>1790</span>
+<span class=normal>1791</span>
+<span class=normal>1792</span>
+<span class=normal>1793</span>
+<span class=normal>1794</span>
+<span class=normal>1795</span>
+<span class=normal>1796</span>
+<span class=normal>1797</span>
+<span class=normal>1798</span>
+<span class=normal>1799</span>
+<span class=normal>1800</span>
+<span class=normal>1801</span>
+<span class=normal>1802</span>
+<span class=normal>1803</span>
+<span class=normal>1804</span>
+<span class=normal>1805</span>
+<span class=normal>1806</span>
+<span class=normal>1807</span>
+<span class=normal>1808</span>
+<span class=normal>1809</span>
+<span class=normal>1810</span>
+<span class=normal>1811</span>
+<span class=normal>1812</span>
+<span class=normal>1813</span>
+<span class=normal>1814</span>
+<span class=normal>1815</span>
+<span class=normal>1816</span>
+<span class=normal>1817</span>
+<span class=normal>1818</span>
+<span class=normal>1819</span>
+<span class=normal>1820</span>
+<span class=normal>1821</span>
+<span class=normal>1822</span>
+<span class=normal>1823</span>
+<span class=normal>1824</span>
+<span class=normal>1825</span>
+<span class=normal>1826</span>
+<span class=normal>1827</span>
+<span class=normal>1828</span>
+<span class=normal>1829</span>
+<span class=normal>1830</span>
+<span class=normal>1831</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Parameter</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Parameters provide a mechanism for the dynamic assignment of value(s) in a control.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for the parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Identifier&#39;</span><span class=p>)</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A textual label that provides a characterization of the type, purpose, use or scope of the parameter.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Class&#39;</span>
+    <span class=p>)</span>
+    <span class=n>depends_on</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;depends-on&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;(deprecated) Another parameter invoking this one. This construct has been deprecated and should not be used.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Depends on&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>label</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A short, placeholder name for the parameter, which can be used as a substitute for a value if no value is assigned.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Label&#39;</span>
+    <span class=p>)</span>
+    <span class=n>usage</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes the purpose and use of a parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Usage Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>constraints</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ParameterConstraint</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>guidelines</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ParameterGuideline</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>values</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>select</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ParameterSelection</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Parameter-attributes>Attributes<a href=#trestle.oscal.common.Parameter-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.class_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label that provides a characterization of the type, purpose, use or scope of the parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Class&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.class_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.constraints class="doc doc-heading"> <code class="highlight language-python"><span class=n>constraints</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ParameterConstraint</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.constraints class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.depends_on class="doc doc-heading"> <code class="highlight language-python"><span class=n>depends_on</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;depends-on&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;(deprecated) Another parameter invoking this one. This construct has been deprecated and should not be used.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Depends on&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.depends_on class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.guidelines class="doc doc-heading"> <code class="highlight language-python"><span class=n>guidelines</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ParameterGuideline</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.guidelines class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.id class="doc doc-heading"> <code class="highlight language-python"><span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for the parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.label class="doc doc-heading"> <code class="highlight language-python"><span class=n>label</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A short, placeholder name for the parameter, which can be used as a substitute for a value if no value is assigned.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Label&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.label class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.select class="doc doc-heading"> <code class="highlight language-python"><span class=n>select</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ParameterSelection</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.select class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.usage class="doc doc-heading"> <code class="highlight language-python"><span class=n>usage</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes the purpose and use of a parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Usage Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.usage class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Parameter.values class="doc doc-heading"> <code class="highlight language-python"><span class=n>values</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.values class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Parameter-classes>Classes<a href=#trestle.oscal.common.Parameter-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Parameter.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Parameter.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1789</span>
+<span class=normal>1790</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Parameter.Config-attributes>Attributes<a href=#trestle.oscal.common.Parameter.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Parameter.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Parameter.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ParameterConstraint class="doc doc-heading"> <code>ParameterConstraint</code> <a href=#trestle.oscal.common.ParameterConstraint class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A formal or informal expression of a constraint or test.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ParameterConstraint</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A formal or informal expression of a constraint or test.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual summary of the constraint to be applied.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Constraint Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>tests</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Test</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ParameterConstraint-attributes>Attributes<a href=#trestle.oscal.common.ParameterConstraint-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ParameterConstraint.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual summary of the constraint to be applied.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Constraint Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ParameterConstraint.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ParameterConstraint.tests class="doc doc-heading"> <code class="highlight language-python"><span class=n>tests</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Test</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ParameterConstraint.tests class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ParameterConstraint-classes>Classes<a href=#trestle.oscal.common.ParameterConstraint-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ParameterConstraint.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ParameterConstraint.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>461</span>
+<span class=normal>462</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ParameterConstraint.Config-attributes>Attributes<a href=#trestle.oscal.common.ParameterConstraint.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ParameterConstraint.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ParameterConstraint.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ParameterGuideline class="doc doc-heading"> <code>ParameterGuideline</code> <a href=#trestle.oscal.common.ParameterGuideline class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A prose statement that provides a recommendation for the use of a parameter.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ParameterGuideline</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A prose statement that provides a recommendation for the use of a parameter.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>prose</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Prose permits multiple paragraphs, lists, tables etc.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Guideline Text&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ParameterGuideline-attributes>Attributes<a href=#trestle.oscal.common.ParameterGuideline-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ParameterGuideline.prose class="doc doc-heading"> <code class="highlight language-python"><span class=n>prose</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Prose permits multiple paragraphs, lists, tables etc.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Guideline Text&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ParameterGuideline.prose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ParameterGuideline-classes>Classes<a href=#trestle.oscal.common.ParameterGuideline-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ParameterGuideline.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ParameterGuideline.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>450</span>
+<span class=normal>451</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ParameterGuideline.Config-attributes>Attributes<a href=#trestle.oscal.common.ParameterGuideline.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ParameterGuideline.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ParameterGuideline.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ParameterSelection class="doc doc-heading"> <code>ParameterSelection</code> <a href=#trestle.oscal.common.ParameterSelection class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Presenting a choice among alternatives.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1766</span>
+<span class=normal>1767</span>
+<span class=normal>1768</span>
+<span class=normal>1769</span>
+<span class=normal>1770</span>
+<span class=normal>1771</span>
+<span class=normal>1772</span>
+<span class=normal>1773</span>
+<span class=normal>1774</span>
+<span class=normal>1775</span>
+<span class=normal>1776</span>
+<span class=normal>1777</span>
+<span class=normal>1778</span>
+<span class=normal>1779</span>
+<span class=normal>1780</span>
+<span class=normal>1781</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ParameterSelection</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Presenting a choice among alternatives.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>how_many</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>HowManyValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;how-many&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Describes the number of selections that must occur. Without this setting, only one value should be assumed to be permitted.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Cardinality&#39;</span>
+    <span class=p>)</span>
+    <span class=n>choice</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ParameterSelection-attributes>Attributes<a href=#trestle.oscal.common.ParameterSelection-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ParameterSelection.choice class="doc doc-heading"> <code class="highlight language-python"><span class=n>choice</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ParameterSelection.choice class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ParameterSelection.how_many class="doc doc-heading"> <code class="highlight language-python"><span class=n>how_many</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>HowManyValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;how-many&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes the number of selections that must occur. Without this setting, only one value should be assumed to be permitted.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Cardinality&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ParameterSelection.how_many class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ParameterSelection-classes>Classes<a href=#trestle.oscal.common.ParameterSelection-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ParameterSelection.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ParameterSelection.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1771</span>
+<span class=normal>1772</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ParameterSelection.Config-attributes>Attributes<a href=#trestle.oscal.common.ParameterSelection.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ParameterSelection.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ParameterSelection.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ParameterValue class="doc doc-heading"> <code>ParameterValue</code> <a href=#trestle.oscal.common.ParameterValue class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>441</span>
+<span class=normal>442</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ParameterValue</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>StringDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A parameter value or set of values.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Value&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ParameterValue-attributes>Attributes<a href=#trestle.oscal.common.ParameterValue-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ParameterValue.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>StringDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A parameter value or set of values.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Value&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ParameterValue.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Part class="doc doc-heading"> <code>Part</code> <a href=#trestle.oscal.common.Part class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An annotated, markup-based textual element of a control's or catalog group's definition, or a child of another part.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1689</span>
+<span class=normal>1690</span>
+<span class=normal>1691</span>
+<span class=normal>1692</span>
+<span class=normal>1693</span>
+<span class=normal>1694</span>
+<span class=normal>1695</span>
+<span class=normal>1696</span>
+<span class=normal>1697</span>
+<span class=normal>1698</span>
+<span class=normal>1699</span>
+<span class=normal>1700</span>
+<span class=normal>1701</span>
+<span class=normal>1702</span>
+<span class=normal>1703</span>
+<span class=normal>1704</span>
+<span class=normal>1705</span>
+<span class=normal>1706</span>
+<span class=normal>1707</span>
+<span class=normal>1708</span>
+<span class=normal>1709</span>
+<span class=normal>1710</span>
+<span class=normal>1711</span>
+<span class=normal>1712</span>
+<span class=normal>1713</span>
+<span class=normal>1714</span>
+<span class=normal>1715</span>
+<span class=normal>1716</span>
+<span class=normal>1717</span>
+<span class=normal>1718</span>
+<span class=normal>1719</span>
+<span class=normal>1720</span>
+<span class=normal>1721</span>
+<span class=normal>1722</span>
+<span class=normal>1723</span>
+<span class=normal>1724</span>
+<span class=normal>1725</span>
+<span class=normal>1726</span>
+<span class=normal>1727</span>
+<span class=normal>1728</span>
+<span class=normal>1729</span>
+<span class=normal>1730</span>
+<span class=normal>1731</span>
+<span class=normal>1732</span>
+<span class=normal>1733</span>
+<span class=normal>1734</span>
+<span class=normal>1735</span>
+<span class=normal>1736</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Part</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An annotated, markup-based textual element of a control&#39;s or catalog group&#39;s definition, or a child of another part.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for the part.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A textual label that uniquely identifies the part&#39;s semantic type, which exists in a value space qualified by the ns.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Name&#39;</span>
+    <span class=p>)</span>
+    <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;An optional namespace qualifying the part&#39;s name. This allows different organizations to associate distinct semantics with the same name.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Namespace&#39;</span>
+    <span class=p>)</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;An optional textual providing a sub-type or characterization of the part&#39;s name, or a category to which the part belongs.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Class&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional name given to the part, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>prose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Permits multiple paragraphs, lists, tables etc.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Text&#39;</span><span class=p>)</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Part-attributes>Attributes<a href=#trestle.oscal.common.Part-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Part.class_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;An optional textual providing a sub-type or characterization of the part&#39;s name, or a category to which the part belongs.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Class&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.class_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Part.id class="doc doc-heading"> <code class="highlight language-python"><span class=nb>id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for the part.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Part.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Part.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A textual label that uniquely identifies the part&#39;s semantic type, which exists in a value space qualified by the ns.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Part.ns class="doc doc-heading"> <code class="highlight language-python"><span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;An optional namespace qualifying the part&#39;s name. This allows different organizations to associate distinct semantics with the same name.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Namespace&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.ns class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Part.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Part.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Part.prose class="doc doc-heading"> <code class="highlight language-python"><span class=n>prose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Permits multiple paragraphs, lists, tables etc.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Text&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.prose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Part.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional name given to the part, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Part Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Part-classes>Classes<a href=#trestle.oscal.common.Part-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Part.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Part.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1694</span>
+<span class=normal>1695</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Part.Config-attributes>Attributes<a href=#trestle.oscal.common.Part.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Part.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Part.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Party class="doc doc-heading"> <code>Party</code> <a href=#trestle.oscal.common.Party class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An organization or person, which may be associated with roles or other concepts within the current or linked OSCAL document.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1645</span>
+<span class=normal>1646</span>
+<span class=normal>1647</span>
+<span class=normal>1648</span>
+<span class=normal>1649</span>
+<span class=normal>1650</span>
+<span class=normal>1651</span>
+<span class=normal>1652</span>
+<span class=normal>1653</span>
+<span class=normal>1654</span>
+<span class=normal>1655</span>
+<span class=normal>1656</span>
+<span class=normal>1657</span>
+<span class=normal>1658</span>
+<span class=normal>1659</span>
+<span class=normal>1660</span>
+<span class=normal>1661</span>
+<span class=normal>1662</span>
+<span class=normal>1663</span>
+<span class=normal>1664</span>
+<span class=normal>1665</span>
+<span class=normal>1666</span>
+<span class=normal>1667</span>
+<span class=normal>1668</span>
+<span class=normal>1669</span>
+<span class=normal>1670</span>
+<span class=normal>1671</span>
+<span class=normal>1672</span>
+<span class=normal>1673</span>
+<span class=normal>1674</span>
+<span class=normal>1675</span>
+<span class=normal>1676</span>
+<span class=normal>1677</span>
+<span class=normal>1678</span>
+<span class=normal>1679</span>
+<span class=normal>1680</span>
+<span class=normal>1681</span>
+<span class=normal>1682</span>
+<span class=normal>1683</span>
+<span class=normal>1684</span>
+<span class=normal>1685</span>
+<span class=normal>1686</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Party</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An organization or person, which may be associated with roles or other concepts within the current or linked OSCAL document.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for the party.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Universally Unique Identifier&#39;</span><span class=p>)</span>
+    <span class=nb>type</span><span class=p>:</span> <span class=n>PartyTypeValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A category describing the kind of party the object describes.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The full name of the party. This is typically the legal name associated with the party.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Name&#39;</span>
+    <span class=p>)</span>
+    <span class=n>short_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;short-name&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A short common name, abbreviation, or acronym for the party.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Short Name&#39;</span>
+    <span class=p>)</span>
+    <span class=n>external_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ExternalId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;external-ids&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>email_addresses</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>EmailAddress</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;email-addresses&#39;</span><span class=p>)</span>
+    <span class=n>telephone_numbers</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TelephoneNumber</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;telephone-numbers&#39;</span><span class=p>)</span>
+    <span class=n>addresses</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Address</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>location_uuids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;location-uuids&#39;</span>
+    <span class=p>)</span>
+    <span class=n>member_of_organizations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;member-of-organizations&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Party-attributes>Attributes<a href=#trestle.oscal.common.Party-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.addresses class="doc doc-heading"> <code class="highlight language-python"><span class=n>addresses</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Address</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.addresses class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.email_addresses class="doc doc-heading"> <code class="highlight language-python"><span class=n>email_addresses</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>EmailAddress</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;email-addresses&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.email_addresses class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.external_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>external_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ExternalId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;external-ids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.external_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.location_uuids class="doc doc-heading"> <code class="highlight language-python"><span class=n>location_uuids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;location-uuids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.location_uuids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.member_of_organizations class="doc doc-heading"> <code class="highlight language-python"><span class=n>member_of_organizations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;member-of-organizations&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.member_of_organizations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The full name of the party. This is typically the legal name associated with the party.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.short_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>short_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;short-name&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A short common name, abbreviation, or acronym for the party.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Short Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.short_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.telephone_numbers class="doc doc-heading"> <code class="highlight language-python"><span class=n>telephone_numbers</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>TelephoneNumber</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;telephone-numbers&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.telephone_numbers class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>PartyTypeValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A category describing the kind of party the object describes.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Party.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for the party.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Party-classes>Classes<a href=#trestle.oscal.common.Party-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Party.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Party.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1650</span>
+<span class=normal>1651</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Party.Config-attributes>Attributes<a href=#trestle.oscal.common.Party.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Party.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Party.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.PartyTypeValidValues class="doc doc-heading"> <code>PartyTypeValidValues</code> <a href=#trestle.oscal.common.PartyTypeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PartyTypeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>person</span> <span class=o>=</span> <span class=s1>&#39;person&#39;</span>
+    <span class=n>organization</span> <span class=o>=</span> <span class=s1>&#39;organization&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.PartyTypeValidValues-attributes>Attributes<a href=#trestle.oscal.common.PartyTypeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.PartyTypeValidValues.organization class="doc doc-heading"> <code class="highlight language-python"><span class=n>organization</span> <span class=o>=</span> <span class=s1>&#39;organization&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.PartyTypeValidValues.organization class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.PartyTypeValidValues.person class="doc doc-heading"> <code class="highlight language-python"><span class=n>person</span> <span class=o>=</span> <span class=s1>&#39;person&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.PartyTypeValidValues.person class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.PartyUuid class="doc doc-heading"> <code>PartyUuid</code> <a href=#trestle.oscal.common.PartyUuid class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PartyUuid</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>UUIDDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Reference to a party by UUID.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.PartyUuid-attributes>Attributes<a href=#trestle.oscal.common.PartyUuid-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.PartyUuid.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>UUIDDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Reference to a party by UUID.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Party Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.PartyUuid.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.PortRange class="doc doc-heading"> <code>PortRange</code> <a href=#trestle.oscal.common.PortRange class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Where applicable this is the IPv4 port range on which the service operates.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PortRange</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Where applicable this is the IPv4 port range on which the service operates.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>start</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>conint</span><span class=p>(</span><span class=n>ge</span><span class=o>=</span><span class=mi>0</span><span class=p>,</span> <span class=n>multiple_of</span><span class=o>=</span><span class=mi>1</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the starting port number in a port range&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Start&#39;</span>
+    <span class=p>)</span>
+    <span class=n>end</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>conint</span><span class=p>(</span><span class=n>ge</span><span class=o>=</span><span class=mi>0</span><span class=p>,</span> <span class=n>multiple_of</span><span class=o>=</span><span class=mi>1</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the ending port number in a port range&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;End&#39;</span>
+    <span class=p>)</span>
+    <span class=n>transport</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>PortRangeValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the transport type.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Transport&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.PortRange-attributes>Attributes<a href=#trestle.oscal.common.PortRange-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.PortRange.end class="doc doc-heading"> <code class="highlight language-python"><span class=n>end</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>conint</span><span class=p>(</span><span class=n>ge</span><span class=o>=</span><span class=mi>0</span><span class=p>,</span> <span class=n>multiple_of</span><span class=o>=</span><span class=mi>1</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the ending port number in a port range&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;End&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.PortRange.end class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.PortRange.start class="doc doc-heading"> <code class="highlight language-python"><span class=n>start</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>conint</span><span class=p>(</span><span class=n>ge</span><span class=o>=</span><span class=mi>0</span><span class=p>,</span> <span class=n>multiple_of</span><span class=o>=</span><span class=mi>1</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the starting port number in a port range&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Start&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.PortRange.start class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.PortRange.transport class="doc doc-heading"> <code class="highlight language-python"><span class=n>transport</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>PortRangeValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the transport type.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Transport&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.PortRange.transport class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.PortRange-classes>Classes<a href=#trestle.oscal.common.PortRange-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.PortRange.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.PortRange.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>416</span>
+<span class=normal>417</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.PortRange.Config-attributes>Attributes<a href=#trestle.oscal.common.PortRange.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.PortRange.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.PortRange.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.PortRangeValidValues class="doc doc-heading"> <code>PortRangeValidValues</code> <a href=#trestle.oscal.common.PortRangeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PortRangeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>TCP</span> <span class=o>=</span> <span class=s1>&#39;TCP&#39;</span>
+    <span class=n>UDP</span> <span class=o>=</span> <span class=s1>&#39;UDP&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.PortRangeValidValues-attributes>Attributes<a href=#trestle.oscal.common.PortRangeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.PortRangeValidValues.TCP class="doc doc-heading"> <code class="highlight language-python"><span class=n>TCP</span> <span class=o>=</span> <span class=s1>&#39;TCP&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.PortRangeValidValues.TCP class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.PortRangeValidValues.UDP class="doc doc-heading"> <code class="highlight language-python"><span class=n>UDP</span> <span class=o>=</span> <span class=s1>&#39;UDP&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.PortRangeValidValues.UDP class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.PositiveIntegerDatatype class="doc doc-heading"> <code>PositiveIntegerDatatype</code> <a href=#trestle.oscal.common.PositiveIntegerDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An integer value that is greater than 0.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PositiveIntegerDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An integer value that is greater than 0.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Property class="doc doc-heading"> <code>Property</code> <a href=#trestle.oscal.common.Property class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An attribute, characteristic, or quality of the containing object expressed as a namespace qualified name/value pair.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Property</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An attribute, characteristic, or quality of the containing object expressed as a namespace qualified name/value pair.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A textual label, within a namespace, that uniquely identifies a specific attribute, characteristic, or quality of the property&#39;s containing object.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Name&#39;</span>
+    <span class=p>)</span>
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for a property.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Universally Unique Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A namespace qualifying the property&#39;s name. This allows different organizations to associate distinct semantics with the same name.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Namespace&#39;</span>
+    <span class=p>)</span>
+    <span class=n>value</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the value of the attribute, characteristic, or quality.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Value&#39;</span>
+    <span class=p>)</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A textual label that provides a sub-type or characterization of the property&#39;s name.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Class&#39;</span>
+    <span class=p>)</span>
+    <span class=n>group</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An identifier for relating distinct sets of properties.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Group&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Property-attributes>Attributes<a href=#trestle.oscal.common.Property-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Property.class_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A textual label that provides a sub-type or characterization of the property&#39;s name.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Class&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Property.class_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Property.group class="doc doc-heading"> <code class="highlight language-python"><span class=n>group</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An identifier for relating distinct sets of properties.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Group&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Property.group class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Property.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A textual label, within a namespace, that uniquely identifies a specific attribute, characteristic, or quality of the property&#39;s containing object.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Property.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Property.ns class="doc doc-heading"> <code class="highlight language-python"><span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A namespace qualifying the property&#39;s name. This allows different organizations to associate distinct semantics with the same name.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Namespace&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Property.ns class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Property.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Property.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Property.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for a property.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Property.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Property.value class="doc doc-heading"> <code class="highlight language-python"><span class=n>value</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the value of the attribute, characteristic, or quality.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Property Value&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Property.value class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Property-classes>Classes<a href=#trestle.oscal.common.Property-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Property.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Property.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>356</span>
+<span class=normal>357</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Property.Config-attributes>Attributes<a href=#trestle.oscal.common.Property.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Property.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Property.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Protocol class="doc doc-heading"> <code>Protocol</code> <a href=#trestle.oscal.common.Protocol class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Information about the protocol used to provide a service.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1579</span>
+<span class=normal>1580</span>
+<span class=normal>1581</span>
+<span class=normal>1582</span>
+<span class=normal>1583</span>
+<span class=normal>1584</span>
+<span class=normal>1585</span>
+<span class=normal>1586</span>
+<span class=normal>1587</span>
+<span class=normal>1588</span>
+<span class=normal>1589</span>
+<span class=normal>1590</span>
+<span class=normal>1591</span>
+<span class=normal>1592</span>
+<span class=normal>1593</span>
+<span class=normal>1594</span>
+<span class=normal>1595</span>
+<span class=normal>1596</span>
+<span class=normal>1597</span>
+<span class=normal>1598</span>
+<span class=normal>1599</span>
+<span class=normal>1600</span>
+<span class=normal>1601</span>
+<span class=normal>1602</span>
+<span class=normal>1603</span>
+<span class=normal>1604</span>
+<span class=normal>1605</span>
+<span class=normal>1606</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Protocol</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Information about the protocol used to provide a service.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this service protocol information elsewhere in this or other OSCAL instances. The locally defined UUID of the service protocol can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Service Protocol Information Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;The common name of the protocol, which should be the appropriate &quot;service name&quot; from the IANA Service Name and Transport Protocol Port Number Registry.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Protocol Name&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the protocol (e.g., Transport Layer Security).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Protocol Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>port_ranges</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>PortRange</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;port-ranges&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Protocol-attributes>Attributes<a href=#trestle.oscal.common.Protocol-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Protocol.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The common name of the protocol, which should be the appropriate &quot;service name&quot; from the IANA Service Name and Transport Protocol Port Number Registry.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Protocol Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Protocol.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Protocol.port_ranges class="doc doc-heading"> <code class="highlight language-python"><span class=n>port_ranges</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>PortRange</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;port-ranges&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Protocol.port_ranges class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Protocol.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the protocol (e.g., Transport Layer Security).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Protocol Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Protocol.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Protocol.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this service protocol information elsewhere in this or other OSCAL instances. The locally defined UUID of the service protocol can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Service Protocol Information Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Protocol.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Protocol-classes>Classes<a href=#trestle.oscal.common.Protocol-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Protocol.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Protocol.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1584</span>
+<span class=normal>1585</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Protocol.Config-attributes>Attributes<a href=#trestle.oscal.common.Protocol.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Protocol.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Protocol.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Published class="doc doc-heading"> <code>Published</code> <a href=#trestle.oscal.common.Published class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1573</span>
+<span class=normal>1574</span>
+<span class=normal>1575</span>
+<span class=normal>1576</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Published</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>DateTimeWithTimezoneDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date and time the document was last made available.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Publication Timestamp&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Published-attributes>Attributes<a href=#trestle.oscal.common.Published-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Published.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>DateTimeWithTimezoneDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date and time the document was last made available.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Publication Timestamp&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Published.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Reason class="doc doc-heading"> <code>Reason</code> <a href=#trestle.oscal.common.Reason class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>The reason the objective was given it's status.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Reason</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The reason the objective was given it&#39;s status.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>pass_</span> <span class=o>=</span> <span class=s1>&#39;pass&#39;</span>
+    <span class=n>fail</span> <span class=o>=</span> <span class=s1>&#39;fail&#39;</span>
+    <span class=n>other</span> <span class=o>=</span> <span class=s1>&#39;other&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Reason-attributes>Attributes<a href=#trestle.oscal.common.Reason-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Reason.fail class="doc doc-heading"> <code class="highlight language-python"><span class=n>fail</span> <span class=o>=</span> <span class=s1>&#39;fail&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Reason.fail class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Reason.other class="doc doc-heading"> <code class="highlight language-python"><span class=n>other</span> <span class=o>=</span> <span class=s1>&#39;other&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Reason.other class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Reason.pass_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>pass_</span> <span class=o>=</span> <span class=s1>&#39;pass&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Reason.pass_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Rel class="doc doc-heading"> <code>Rel</code> <a href=#trestle.oscal.common.Rel class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Describes the type of relationship provided by the link's hypertext reference. This can be an indicator of the link's purpose.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Rel</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes the type of relationship provided by the link&#39;s hypertext reference. This can be an indicator of the link&#39;s purpose.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>reference</span> <span class=o>=</span> <span class=s1>&#39;reference&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Rel-attributes>Attributes<a href=#trestle.oscal.common.Rel-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Rel.reference class="doc doc-heading"> <code class="highlight language-python"><span class=n>reference</span> <span class=o>=</span> <span class=s1>&#39;reference&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Rel.reference class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RelatedObservation class="doc doc-heading"> <code>RelatedObservation</code> <a href=#trestle.oscal.common.RelatedObservation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Relates the finding to a set of referenced observations that were used to determine the finding.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RelatedObservation</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Relates the finding to a set of referenced observations that were used to determine the finding.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>observation_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;observation-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to an observation defined in the list of observations.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Observation Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RelatedObservation-attributes>Attributes<a href=#trestle.oscal.common.RelatedObservation-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedObservation.observation_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>observation_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;observation-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to an observation defined in the list of observations.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Observation Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedObservation.observation_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.RelatedObservation-classes>Classes<a href=#trestle.oscal.common.RelatedObservation-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.RelatedObservation.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.RelatedObservation.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>320</span>
+<span class=normal>321</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.RelatedObservation.Config-attributes>Attributes<a href=#trestle.oscal.common.RelatedObservation.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.RelatedObservation.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedObservation.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RelatedResponse class="doc doc-heading"> <code>RelatedResponse</code> <a href=#trestle.oscal.common.RelatedResponse class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies an individual risk response that this log entry is for.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2436</span>
+<span class=normal>2437</span>
+<span class=normal>2438</span>
+<span class=normal>2439</span>
+<span class=normal>2440</span>
+<span class=normal>2441</span>
+<span class=normal>2442</span>
+<span class=normal>2443</span>
+<span class=normal>2444</span>
+<span class=normal>2445</span>
+<span class=normal>2446</span>
+<span class=normal>2447</span>
+<span class=normal>2448</span>
+<span class=normal>2449</span>
+<span class=normal>2450</span>
+<span class=normal>2451</span>
+<span class=normal>2452</span>
+<span class=normal>2453</span>
+<span class=normal>2454</span>
+<span class=normal>2455</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RelatedResponse</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies an individual risk response that this log entry is for.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>response_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;response-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a unique risk response.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Response Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>related_tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedTask</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-tasks&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RelatedResponse-attributes>Attributes<a href=#trestle.oscal.common.RelatedResponse-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedResponse.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedResponse.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedResponse.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedResponse.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedResponse.related_tasks class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedTask</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-tasks&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedResponse.related_tasks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedResponse.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedResponse.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedResponse.response_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>response_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;response-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a unique risk response.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Response Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedResponse.response_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.RelatedResponse-classes>Classes<a href=#trestle.oscal.common.RelatedResponse-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.RelatedResponse.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.RelatedResponse.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2441</span>
+<span class=normal>2442</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.RelatedResponse.Config-attributes>Attributes<a href=#trestle.oscal.common.RelatedResponse.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.RelatedResponse.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedResponse.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RelatedRisk class="doc doc-heading"> <code>RelatedRisk</code> <a href=#trestle.oscal.common.RelatedRisk class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Relates the finding to a set of referenced risks that were used to determine the finding.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RelatedRisk</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Relates the finding to a set of referenced risks that were used to determine the finding.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>risk_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;risk-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a risk defined in the list of risks.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RelatedRisk-attributes>Attributes<a href=#trestle.oscal.common.RelatedRisk-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedRisk.risk_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>risk_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;risk-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a risk defined in the list of risks.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedRisk.risk_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.RelatedRisk-classes>Classes<a href=#trestle.oscal.common.RelatedRisk-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.RelatedRisk.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.RelatedRisk.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>302</span>
+<span class=normal>303</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.RelatedRisk.Config-attributes>Attributes<a href=#trestle.oscal.common.RelatedRisk.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.RelatedRisk.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedRisk.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RelatedTask class="doc doc-heading"> <code>RelatedTask</code> <a href=#trestle.oscal.common.RelatedTask class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies an individual task for which the containing object is a consequence of.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1943</span>
+<span class=normal>1944</span>
+<span class=normal>1945</span>
+<span class=normal>1946</span>
+<span class=normal>1947</span>
+<span class=normal>1948</span>
+<span class=normal>1949</span>
+<span class=normal>1950</span>
+<span class=normal>1951</span>
+<span class=normal>1952</span>
+<span class=normal>1953</span>
+<span class=normal>1954</span>
+<span class=normal>1955</span>
+<span class=normal>1956</span>
+<span class=normal>1957</span>
+<span class=normal>1958</span>
+<span class=normal>1959</span>
+<span class=normal>1960</span>
+<span class=normal>1961</span>
+<span class=normal>1962</span>
+<span class=normal>1963</span>
+<span class=normal>1964</span>
+<span class=normal>1965</span>
+<span class=normal>1966</span>
+<span class=normal>1967</span>
+<span class=normal>1968</span>
+<span class=normal>1969</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RelatedTask</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies an individual task for which the containing object is a consequence of.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>task_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;task-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a unique task.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span>
+    <span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AssessmentSubject</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>identified_subject</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>IdentifiedSubject</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;identified-subject&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to detail assessment subjects that were identfied by this task.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Identified Subject&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RelatedTask-attributes>Attributes<a href=#trestle.oscal.common.RelatedTask-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedTask.identified_subject class="doc doc-heading"> <code class="highlight language-python"><span class=n>identified_subject</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>IdentifiedSubject</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;identified-subject&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to detail assessment subjects that were identfied by this task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Identified Subject&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedTask.identified_subject class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedTask.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedTask.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedTask.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedTask.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedTask.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedTask.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedTask.responsible_parties class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedTask.responsible_parties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedTask.subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AssessmentSubject</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedTask.subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelatedTask.task_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>task_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;task-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a unique task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedTask.task_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.RelatedTask-classes>Classes<a href=#trestle.oscal.common.RelatedTask-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.RelatedTask.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.RelatedTask.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1948</span>
+<span class=normal>1949</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.RelatedTask.Config-attributes>Attributes<a href=#trestle.oscal.common.RelatedTask.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.RelatedTask.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelatedTask.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RelevantEvidence class="doc doc-heading"> <code>RelevantEvidence</code> <a href=#trestle.oscal.common.RelevantEvidence class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Links this observation to relevant evidence.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1554</span>
+<span class=normal>1555</span>
+<span class=normal>1556</span>
+<span class=normal>1557</span>
+<span class=normal>1558</span>
+<span class=normal>1559</span>
+<span class=normal>1560</span>
+<span class=normal>1561</span>
+<span class=normal>1562</span>
+<span class=normal>1563</span>
+<span class=normal>1564</span>
+<span class=normal>1565</span>
+<span class=normal>1566</span>
+<span class=normal>1567</span>
+<span class=normal>1568</span>
+<span class=normal>1569</span>
+<span class=normal>1570</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RelevantEvidence</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Links this observation to relevant evidence.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>href</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to relevant evidence.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Relevant Evidence Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this evidence.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Relevant Evidence Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RelevantEvidence-attributes>Attributes<a href=#trestle.oscal.common.RelevantEvidence-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelevantEvidence.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this evidence.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Relevant Evidence Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelevantEvidence.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelevantEvidence.href class="doc doc-heading"> <code class="highlight language-python"><span class=n>href</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to relevant evidence.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Relevant Evidence Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelevantEvidence.href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelevantEvidence.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelevantEvidence.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelevantEvidence.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelevantEvidence.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RelevantEvidence.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelevantEvidence.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.RelevantEvidence-classes>Classes<a href=#trestle.oscal.common.RelevantEvidence-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.RelevantEvidence.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.RelevantEvidence.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1559</span>
+<span class=normal>1560</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.RelevantEvidence.Config-attributes>Attributes<a href=#trestle.oscal.common.RelevantEvidence.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.RelevantEvidence.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RelevantEvidence.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Remarks class="doc doc-heading"> <code>Remarks</code> <a href=#trestle.oscal.common.Remarks class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>293</span>
+<span class=normal>294</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Remarks</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Additional commentary about the containing object.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Remarks&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Remarks-attributes>Attributes<a href=#trestle.oscal.common.Remarks-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Remarks.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Additional commentary about the containing object.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Remarks&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Remarks.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RequiredAsset class="doc doc-heading"> <code>RequiredAsset</code> <a href=#trestle.oscal.common.RequiredAsset class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies an asset required to achieve remediation.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1526</span>
+<span class=normal>1527</span>
+<span class=normal>1528</span>
+<span class=normal>1529</span>
+<span class=normal>1530</span>
+<span class=normal>1531</span>
+<span class=normal>1532</span>
+<span class=normal>1533</span>
+<span class=normal>1534</span>
+<span class=normal>1535</span>
+<span class=normal>1536</span>
+<span class=normal>1537</span>
+<span class=normal>1538</span>
+<span class=normal>1539</span>
+<span class=normal>1540</span>
+<span class=normal>1541</span>
+<span class=normal>1542</span>
+<span class=normal>1543</span>
+<span class=normal>1544</span>
+<span class=normal>1545</span>
+<span class=normal>1546</span>
+<span class=normal>1547</span>
+<span class=normal>1548</span>
+<span class=normal>1549</span>
+<span class=normal>1550</span>
+<span class=normal>1551</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RequiredAsset</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies an asset required to achieve remediation.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this required asset elsewhere in this or other OSCAL instances. The locally defined UUID of the asset can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Required Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SubjectReference</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this required asset.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Title for Required Asset&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this required asset.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Description of Required Asset&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RequiredAsset-attributes>Attributes<a href=#trestle.oscal.common.RequiredAsset-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RequiredAsset.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this required asset.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Description of Required Asset&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RequiredAsset.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RequiredAsset.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RequiredAsset.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RequiredAsset.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RequiredAsset.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RequiredAsset.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RequiredAsset.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RequiredAsset.subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SubjectReference</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RequiredAsset.subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RequiredAsset.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this required asset.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Title for Required Asset&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RequiredAsset.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RequiredAsset.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this required asset elsewhere in this or other OSCAL instances. The locally defined UUID of the asset can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Required Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RequiredAsset.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.RequiredAsset-classes>Classes<a href=#trestle.oscal.common.RequiredAsset-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.RequiredAsset.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.RequiredAsset.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1531</span>
+<span class=normal>1532</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.RequiredAsset.Config-attributes>Attributes<a href=#trestle.oscal.common.RequiredAsset.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.RequiredAsset.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RequiredAsset.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Resource class="doc doc-heading"> <code>Resource</code> <a href=#trestle.oscal.common.Resource class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A resource associated with content in the containing document instance. A resource may be directly included in the document using base64 encoding or may point to one or more equivalent internet resources.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2018</span>
+<span class=normal>2019</span>
+<span class=normal>2020</span>
+<span class=normal>2021</span>
+<span class=normal>2022</span>
+<span class=normal>2023</span>
+<span class=normal>2024</span>
+<span class=normal>2025</span>
+<span class=normal>2026</span>
+<span class=normal>2027</span>
+<span class=normal>2028</span>
+<span class=normal>2029</span>
+<span class=normal>2030</span>
+<span class=normal>2031</span>
+<span class=normal>2032</span>
+<span class=normal>2033</span>
+<span class=normal>2034</span>
+<span class=normal>2035</span>
+<span class=normal>2036</span>
+<span class=normal>2037</span>
+<span class=normal>2038</span>
+<span class=normal>2039</span>
+<span class=normal>2040</span>
+<span class=normal>2041</span>
+<span class=normal>2042</span>
+<span class=normal>2043</span>
+<span class=normal>2044</span>
+<span class=normal>2045</span>
+<span class=normal>2046</span>
+<span class=normal>2047</span>
+<span class=normal>2048</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Resource</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A resource associated with content in the containing document instance. A resource may be directly included in the document using base64 encoding or may point to one or more equivalent internet resources.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for a resource.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Resource Universally Unique Identifier&#39;</span><span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional name given to the resource, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Resource Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional short summary of the resource used to indicate the purpose of the resource.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Resource Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>document_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>DocumentId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;document-ids&#39;</span><span class=p>)</span>
+    <span class=n>citation</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Citation</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional citation consisting of end note text using structured markup.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Citation&#39;</span>
+    <span class=p>)</span>
+    <span class=n>rlinks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Rlink</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>base64</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Base64</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resource encoded using the Base64 alphabet defined by RFC 2045.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Base64&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Resource-attributes>Attributes<a href=#trestle.oscal.common.Resource-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Resource.base64 class="doc doc-heading"> <code class="highlight language-python"><span class=n>base64</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Base64</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resource encoded using the Base64 alphabet defined by RFC 2045.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Base64&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.base64 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Resource.citation class="doc doc-heading"> <code class="highlight language-python"><span class=n>citation</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Citation</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional citation consisting of end note text using structured markup.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Citation&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.citation class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Resource.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional short summary of the resource used to indicate the purpose of the resource.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Resource Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Resource.document_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>document_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>DocumentId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;document-ids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.document_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Resource.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Resource.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Resource.rlinks class="doc doc-heading"> <code class="highlight language-python"><span class=n>rlinks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Rlink</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.rlinks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Resource.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional name given to the resource, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Resource Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Resource.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for a resource.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Resource Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Resource-classes>Classes<a href=#trestle.oscal.common.Resource-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Resource.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Resource.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2023</span>
+<span class=normal>2024</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Resource.Config-attributes>Attributes<a href=#trestle.oscal.common.Resource.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Resource.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Resource.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Response class="doc doc-heading"> <code>Response</code> <a href=#trestle.oscal.common.Response class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes either recommended or an actual plan for addressing the risk.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2171</span>
+<span class=normal>2172</span>
+<span class=normal>2173</span>
+<span class=normal>2174</span>
+<span class=normal>2175</span>
+<span class=normal>2176</span>
+<span class=normal>2177</span>
+<span class=normal>2178</span>
+<span class=normal>2179</span>
+<span class=normal>2180</span>
+<span class=normal>2181</span>
+<span class=normal>2182</span>
+<span class=normal>2183</span>
+<span class=normal>2184</span>
+<span class=normal>2185</span>
+<span class=normal>2186</span>
+<span class=normal>2187</span>
+<span class=normal>2188</span>
+<span class=normal>2189</span>
+<span class=normal>2190</span>
+<span class=normal>2191</span>
+<span class=normal>2192</span>
+<span class=normal>2193</span>
+<span class=normal>2194</span>
+<span class=normal>2195</span>
+<span class=normal>2196</span>
+<span class=normal>2197</span>
+<span class=normal>2198</span>
+<span class=normal>2199</span>
+<span class=normal>2200</span>
+<span class=normal>2201</span>
+<span class=normal>2202</span>
+<span class=normal>2203</span>
+<span class=normal>2204</span>
+<span class=normal>2205</span>
+<span class=normal>2206</span>
+<span class=normal>2207</span>
+<span class=normal>2208</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Response</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes either recommended or an actual plan for addressing the risk.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this remediation elsewhere in this or other OSCAL instances. The locally defined UUID of the risk response can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Remediation Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>lifecycle</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span>
+        <span class=n>constr</span><span class=p>(</span>
+            <span class=n>regex</span><span class=o>=</span>
+            <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+        <span class=p>),</span>
+        <span class=n>Lifecycle</span>
+    <span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Identifies whether this is a recommendation, such as from an assessor or tool, or an actual plan accepted by the system owner.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Remediation Intent&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this response activity.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Response Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this response plan.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Response Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origin</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>required_assets</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RequiredAsset</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;required-assets&#39;</span><span class=p>)</span>
+    <span class=n>tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Task</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Response-attributes>Attributes<a href=#trestle.oscal.common.Response-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this response plan.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Response Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.lifecycle class="doc doc-heading"> <code class="highlight language-python"><span class=n>lifecycle</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>),</span> <span class=n>Lifecycle</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies whether this is a recommendation, such as from an assessor or tool, or an actual plan accepted by the system owner.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Remediation Intent&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.lifecycle class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.origins class="doc doc-heading"> <code class="highlight language-python"><span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origin</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.origins class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.required_assets class="doc doc-heading"> <code class="highlight language-python"><span class=n>required_assets</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RequiredAsset</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;required-assets&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.required_assets class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.tasks class="doc doc-heading"> <code class="highlight language-python"><span class=n>tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Task</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.tasks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this response activity.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Response Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Response.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this remediation elsewhere in this or other OSCAL instances. The locally defined UUID of the risk response can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Remediation Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Response-classes>Classes<a href=#trestle.oscal.common.Response-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Response.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Response.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2176</span>
+<span class=normal>2177</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Response.Config-attributes>Attributes<a href=#trestle.oscal.common.Response.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Response.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Response.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ResponsibleParty class="doc doc-heading"> <code>ResponsibleParty</code> <a href=#trestle.oscal.common.ResponsibleParty class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A reference to a set of persons and/or organizations that have responsibility for performing the referenced role in the context of the containing object.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1504</span>
+<span class=normal>1505</span>
+<span class=normal>1506</span>
+<span class=normal>1507</span>
+<span class=normal>1508</span>
+<span class=normal>1509</span>
+<span class=normal>1510</span>
+<span class=normal>1511</span>
+<span class=normal>1512</span>
+<span class=normal>1513</span>
+<span class=normal>1514</span>
+<span class=normal>1515</span>
+<span class=normal>1516</span>
+<span class=normal>1517</span>
+<span class=normal>1518</span>
+<span class=normal>1519</span>
+<span class=normal>1520</span>
+<span class=normal>1521</span>
+<span class=normal>1522</span>
+<span class=normal>1523</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ResponsibleParty</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A reference to a set of persons and/or organizations that have responsibility for performing the referenced role in the context of the containing object.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>role_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A reference to a role performed by a party.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Responsible Role&#39;</span>
+    <span class=p>)</span>
+    <span class=n>party_uuids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;party-uuids&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ResponsibleParty-attributes>Attributes<a href=#trestle.oscal.common.ResponsibleParty-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleParty.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleParty.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleParty.party_uuids class="doc doc-heading"> <code class="highlight language-python"><span class=n>party_uuids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;party-uuids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleParty.party_uuids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleParty.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleParty.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleParty.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleParty.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleParty.role_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>role_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A reference to a role performed by a party.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Responsible Role&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleParty.role_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ResponsibleParty-classes>Classes<a href=#trestle.oscal.common.ResponsibleParty-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ResponsibleParty.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ResponsibleParty.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1509</span>
+<span class=normal>1510</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ResponsibleParty.Config-attributes>Attributes<a href=#trestle.oscal.common.ResponsibleParty.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ResponsibleParty.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleParty.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ResponsibleRole class="doc doc-heading"> <code>ResponsibleRole</code> <a href=#trestle.oscal.common.ResponsibleRole class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A reference to a role with responsibility for performing a function relative to the containing object, optionally associated with a set of persons and/or organizations that perform that role.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1477</span>
+<span class=normal>1478</span>
+<span class=normal>1479</span>
+<span class=normal>1480</span>
+<span class=normal>1481</span>
+<span class=normal>1482</span>
+<span class=normal>1483</span>
+<span class=normal>1484</span>
+<span class=normal>1485</span>
+<span class=normal>1486</span>
+<span class=normal>1487</span>
+<span class=normal>1488</span>
+<span class=normal>1489</span>
+<span class=normal>1490</span>
+<span class=normal>1491</span>
+<span class=normal>1492</span>
+<span class=normal>1493</span>
+<span class=normal>1494</span>
+<span class=normal>1495</span>
+<span class=normal>1496</span>
+<span class=normal>1497</span>
+<span class=normal>1498</span>
+<span class=normal>1499</span>
+<span class=normal>1500</span>
+<span class=normal>1501</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ResponsibleRole</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A reference to a role with responsibility for performing a function relative to the containing object, optionally associated with a set of persons and/or organizations that perform that role.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>role_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-oriented identifier reference to a role performed.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Responsible Role ID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>party_uuids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;party-uuids&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ResponsibleRole-attributes>Attributes<a href=#trestle.oscal.common.ResponsibleRole-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleRole.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleRole.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleRole.party_uuids class="doc doc-heading"> <code class="highlight language-python"><span class=n>party_uuids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;party-uuids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleRole.party_uuids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleRole.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleRole.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleRole.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleRole.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ResponsibleRole.role_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>role_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-oriented identifier reference to a role performed.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Responsible Role ID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleRole.role_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ResponsibleRole-classes>Classes<a href=#trestle.oscal.common.ResponsibleRole-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ResponsibleRole.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ResponsibleRole.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1482</span>
+<span class=normal>1483</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ResponsibleRole.Config-attributes>Attributes<a href=#trestle.oscal.common.ResponsibleRole.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ResponsibleRole.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ResponsibleRole.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ReviewedControls class="doc doc-heading"> <code>ReviewedControls</code> <a href=#trestle.oscal.common.ReviewedControls class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies the controls being assessed and their control objectives.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1457</span>
+<span class=normal>1458</span>
+<span class=normal>1459</span>
+<span class=normal>1460</span>
+<span class=normal>1461</span>
+<span class=normal>1462</span>
+<span class=normal>1463</span>
+<span class=normal>1464</span>
+<span class=normal>1465</span>
+<span class=normal>1466</span>
+<span class=normal>1467</span>
+<span class=normal>1468</span>
+<span class=normal>1469</span>
+<span class=normal>1470</span>
+<span class=normal>1471</span>
+<span class=normal>1472</span>
+<span class=normal>1473</span>
+<span class=normal>1474</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ReviewedControls</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the controls being assessed and their control objectives.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of control objectives.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Objective Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>control_selections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ControlSelection</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-selections&#39;</span><span class=p>)</span>
+    <span class=n>control_objective_selections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ControlObjectiveSelection</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-objective-selections&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ReviewedControls-attributes>Attributes<a href=#trestle.oscal.common.ReviewedControls-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ReviewedControls.control_objective_selections class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_objective_selections</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ControlObjectiveSelection</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-objective-selections&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ReviewedControls.control_objective_selections class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ReviewedControls.control_selections class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_selections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ControlSelection</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-selections&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ReviewedControls.control_selections class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ReviewedControls.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of control objectives.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Objective Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ReviewedControls.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ReviewedControls.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ReviewedControls.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ReviewedControls.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ReviewedControls.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ReviewedControls.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ReviewedControls.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ReviewedControls-classes>Classes<a href=#trestle.oscal.common.ReviewedControls-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ReviewedControls.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ReviewedControls.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1462</span>
+<span class=normal>1463</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ReviewedControls.Config-attributes>Attributes<a href=#trestle.oscal.common.ReviewedControls.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ReviewedControls.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ReviewedControls.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Revision class="doc doc-heading"> <code>Revision</code> <a href=#trestle.oscal.common.Revision class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An entry in a sequential list of revisions to the containing document, expected to be in reverse chronological order (i.e. latest first).</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1435</span>
+<span class=normal>1436</span>
+<span class=normal>1437</span>
+<span class=normal>1438</span>
+<span class=normal>1439</span>
+<span class=normal>1440</span>
+<span class=normal>1441</span>
+<span class=normal>1442</span>
+<span class=normal>1443</span>
+<span class=normal>1444</span>
+<span class=normal>1445</span>
+<span class=normal>1446</span>
+<span class=normal>1447</span>
+<span class=normal>1448</span>
+<span class=normal>1449</span>
+<span class=normal>1450</span>
+<span class=normal>1451</span>
+<span class=normal>1452</span>
+<span class=normal>1453</span>
+<span class=normal>1454</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Revision</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An entry in a sequential list of revisions to the containing document, expected to be in reverse chronological order (i.e. latest first).</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the document revision, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Document Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>published</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>last_modified</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;last-modified&#39;</span><span class=p>)</span>
+    <span class=n>version</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span>
+    <span class=n>oscal_version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OscalVersion</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;oscal-version&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Revision-attributes>Attributes<a href=#trestle.oscal.common.Revision-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Revision.last_modified class="doc doc-heading"> <code class="highlight language-python"><span class=n>last_modified</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;last-modified&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Revision.last_modified class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Revision.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Revision.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Revision.oscal_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>oscal_version</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OscalVersion</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;oscal-version&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Revision.oscal_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Revision.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Revision.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Revision.published class="doc doc-heading"> <code class="highlight language-python"><span class=n>published</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Revision.published class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Revision.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Revision.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Revision.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the document revision, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Document Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Revision.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Revision.version class="doc doc-heading"> <code class="highlight language-python"><span class=n>version</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Revision.version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Revision-classes>Classes<a href=#trestle.oscal.common.Revision-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Revision.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Revision.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1440</span>
+<span class=normal>1441</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Revision.Config-attributes>Attributes<a href=#trestle.oscal.common.Revision.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Revision.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Revision.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Risk class="doc doc-heading"> <code>Risk</code> <a href=#trestle.oscal.common.Risk class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>An identified risk.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2506</span>
+<span class=normal>2507</span>
+<span class=normal>2508</span>
+<span class=normal>2509</span>
+<span class=normal>2510</span>
+<span class=normal>2511</span>
+<span class=normal>2512</span>
+<span class=normal>2513</span>
+<span class=normal>2514</span>
+<span class=normal>2515</span>
+<span class=normal>2516</span>
+<span class=normal>2517</span>
+<span class=normal>2518</span>
+<span class=normal>2519</span>
+<span class=normal>2520</span>
+<span class=normal>2521</span>
+<span class=normal>2522</span>
+<span class=normal>2523</span>
+<span class=normal>2524</span>
+<span class=normal>2525</span>
+<span class=normal>2526</span>
+<span class=normal>2527</span>
+<span class=normal>2528</span>
+<span class=normal>2529</span>
+<span class=normal>2530</span>
+<span class=normal>2531</span>
+<span class=normal>2532</span>
+<span class=normal>2533</span>
+<span class=normal>2534</span>
+<span class=normal>2535</span>
+<span class=normal>2536</span>
+<span class=normal>2537</span>
+<span class=normal>2538</span>
+<span class=normal>2539</span>
+<span class=normal>2540</span>
+<span class=normal>2541</span>
+<span class=normal>2542</span>
+<span class=normal>2543</span>
+<span class=normal>2544</span>
+<span class=normal>2545</span>
+<span class=normal>2546</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Risk</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    An identified risk.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this risk elsewhere in this or other OSCAL instances. The locally defined UUID of the risk can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this risk.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A human-readable summary of the identified risk, to include a statement of how the risk impacts the system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>statement</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An summary of impact for how the risk affects the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Statement&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>status</span><span class=p>:</span> <span class=n>RiskStatus</span>
+    <span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origin</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>threat_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ThreatId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;threat-ids&#39;</span><span class=p>)</span>
+    <span class=n>characterizations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Characterization</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>mitigating_factors</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>MitigatingFactor</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;mitigating-factors&#39;</span><span class=p>)</span>
+    <span class=n>deadline</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date/time by which the risk must be resolved.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Resolution Deadline&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remediations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Response</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>risk_log</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>RiskLog</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;risk-log&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A log of all risk-related tasks taken.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Log&#39;</span>
+    <span class=p>)</span>
+    <span class=n>related_observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedObservation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-observations&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Risk-attributes>Attributes<a href=#trestle.oscal.common.Risk-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.characterizations class="doc doc-heading"> <code class="highlight language-python"><span class=n>characterizations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Characterization</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.characterizations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.deadline class="doc doc-heading"> <code class="highlight language-python"><span class=n>deadline</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>datetime</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date/time by which the risk must be resolved.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Resolution Deadline&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.deadline class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable summary of the identified risk, to include a statement of how the risk impacts the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.mitigating_factors class="doc doc-heading"> <code class="highlight language-python"><span class=n>mitigating_factors</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>MitigatingFactor</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;mitigating-factors&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.mitigating_factors class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.origins class="doc doc-heading"> <code class="highlight language-python"><span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origin</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.origins class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.related_observations class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedObservation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-observations&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.related_observations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.remediations class="doc doc-heading"> <code class="highlight language-python"><span class=n>remediations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Response</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.remediations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.risk_log class="doc doc-heading"> <code class="highlight language-python"><span class=n>risk_log</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>RiskLog</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;risk-log&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A log of all risk-related tasks taken.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Log&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.risk_log class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.statement class="doc doc-heading"> <code class="highlight language-python"><span class=n>statement</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An summary of impact for how the risk affects the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Statement&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.statement class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.status class="doc doc-heading"> <code class="highlight language-python"><span class=n>status</span><span class=p>:</span> <span class=n>RiskStatus</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.threat_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>threat_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ThreatId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;threat-ids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.threat_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this risk.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Risk.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this risk elsewhere in this or other OSCAL instances. The locally defined UUID of the risk can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Risk-classes>Classes<a href=#trestle.oscal.common.Risk-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Risk.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Risk.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2511</span>
+<span class=normal>2512</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Risk.Config-attributes>Attributes<a href=#trestle.oscal.common.Risk.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Risk.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Risk.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RiskLog class="doc doc-heading"> <code>RiskLog</code> <a href=#trestle.oscal.common.RiskLog class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A log of all risk-related tasks taken.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2495</span>
+<span class=normal>2496</span>
+<span class=normal>2497</span>
+<span class=normal>2498</span>
+<span class=normal>2499</span>
+<span class=normal>2500</span>
+<span class=normal>2501</span>
+<span class=normal>2502</span>
+<span class=normal>2503</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RiskLog</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A log of all risk-related tasks taken.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>entries</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Entry</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RiskLog-attributes>Attributes<a href=#trestle.oscal.common.RiskLog-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RiskLog.entries class="doc doc-heading"> <code class="highlight language-python"><span class=n>entries</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Entry</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RiskLog.entries class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.RiskLog-classes>Classes<a href=#trestle.oscal.common.RiskLog-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.RiskLog.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.RiskLog.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2500</span>
+<span class=normal>2501</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.RiskLog.Config-attributes>Attributes<a href=#trestle.oscal.common.RiskLog.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.RiskLog.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RiskLog.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RiskStatus class="doc doc-heading"> <code>RiskStatus</code> <a href=#trestle.oscal.common.RiskStatus class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RiskStatus</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>RiskStatusValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes the status of the associated risk.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Status&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RiskStatus-attributes>Attributes<a href=#trestle.oscal.common.RiskStatus-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RiskStatus.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>RiskStatusValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes the status of the associated risk.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Risk Status&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RiskStatus.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RiskStatusValidValues class="doc doc-heading"> <code>RiskStatusValidValues</code> <a href=#trestle.oscal.common.RiskStatusValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RiskStatusValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=nb>open</span> <span class=o>=</span> <span class=s1>&#39;open&#39;</span>
+    <span class=n>investigating</span> <span class=o>=</span> <span class=s1>&#39;investigating&#39;</span>
+    <span class=n>remediating</span> <span class=o>=</span> <span class=s1>&#39;remediating&#39;</span>
+    <span class=n>deviation_requested</span> <span class=o>=</span> <span class=s1>&#39;deviation-requested&#39;</span>
+    <span class=n>deviation_approved</span> <span class=o>=</span> <span class=s1>&#39;deviation-approved&#39;</span>
+    <span class=n>closed</span> <span class=o>=</span> <span class=s1>&#39;closed&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RiskStatusValidValues-attributes>Attributes<a href=#trestle.oscal.common.RiskStatusValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RiskStatusValidValues.closed class="doc doc-heading"> <code class="highlight language-python"><span class=n>closed</span> <span class=o>=</span> <span class=s1>&#39;closed&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RiskStatusValidValues.closed class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RiskStatusValidValues.deviation_approved class="doc doc-heading"> <code class="highlight language-python"><span class=n>deviation_approved</span> <span class=o>=</span> <span class=s1>&#39;deviation-approved&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RiskStatusValidValues.deviation_approved class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RiskStatusValidValues.deviation_requested class="doc doc-heading"> <code class="highlight language-python"><span class=n>deviation_requested</span> <span class=o>=</span> <span class=s1>&#39;deviation-requested&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RiskStatusValidValues.deviation_requested class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RiskStatusValidValues.investigating class="doc doc-heading"> <code class="highlight language-python"><span class=n>investigating</span> <span class=o>=</span> <span class=s1>&#39;investigating&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RiskStatusValidValues.investigating class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RiskStatusValidValues.open class="doc doc-heading"> <code class="highlight language-python"><span class=nb>open</span> <span class=o>=</span> <span class=s1>&#39;open&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RiskStatusValidValues.open class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RiskStatusValidValues.remediating class="doc doc-heading"> <code class="highlight language-python"><span class=n>remediating</span> <span class=o>=</span> <span class=s1>&#39;remediating&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RiskStatusValidValues.remediating class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Rlink class="doc doc-heading"> <code>Rlink</code> <a href=#trestle.oscal.common.Rlink class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A URL-based pointer to an external resource with an optional hash for verification and change detection.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1998</span>
+<span class=normal>1999</span>
+<span class=normal>2000</span>
+<span class=normal>2001</span>
+<span class=normal>2002</span>
+<span class=normal>2003</span>
+<span class=normal>2004</span>
+<span class=normal>2005</span>
+<span class=normal>2006</span>
+<span class=normal>2007</span>
+<span class=normal>2008</span>
+<span class=normal>2009</span>
+<span class=normal>2010</span>
+<span class=normal>2011</span>
+<span class=normal>2012</span>
+<span class=normal>2013</span>
+<span class=normal>2014</span>
+<span class=normal>2015</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Rlink</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A URL-based pointer to an external resource with an optional hash for verification and change detection.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL pointing to the referenced resource.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Hypertext Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>media_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;media-type&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A label that indicates the nature of a resource, as a data serialization or format.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Media Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>hashes</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Hash</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Rlink-attributes>Attributes<a href=#trestle.oscal.common.Rlink-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Rlink.hashes class="doc doc-heading"> <code class="highlight language-python"><span class=n>hashes</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Hash</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Rlink.hashes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Rlink.href class="doc doc-heading"> <code class="highlight language-python"><span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL pointing to the referenced resource.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Hypertext Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Rlink.href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Rlink.media_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>media_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;media-type&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A label that indicates the nature of a resource, as a data serialization or format.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Media Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Rlink.media_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Rlink-classes>Classes<a href=#trestle.oscal.common.Rlink-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Rlink.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Rlink.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2003</span>
+<span class=normal>2004</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Rlink.Config-attributes>Attributes<a href=#trestle.oscal.common.Rlink.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Rlink.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Rlink.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Role class="doc doc-heading"> <code>Role</code> <a href=#trestle.oscal.common.Role class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Defines a function, which might be assigned to a party in a specific situation.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1404</span>
+<span class=normal>1405</span>
+<span class=normal>1406</span>
+<span class=normal>1407</span>
+<span class=normal>1408</span>
+<span class=normal>1409</span>
+<span class=normal>1410</span>
+<span class=normal>1411</span>
+<span class=normal>1412</span>
+<span class=normal>1413</span>
+<span class=normal>1414</span>
+<span class=normal>1415</span>
+<span class=normal>1416</span>
+<span class=normal>1417</span>
+<span class=normal>1418</span>
+<span class=normal>1419</span>
+<span class=normal>1420</span>
+<span class=normal>1421</span>
+<span class=normal>1422</span>
+<span class=normal>1423</span>
+<span class=normal>1424</span>
+<span class=normal>1425</span>
+<span class=normal>1426</span>
+<span class=normal>1427</span>
+<span class=normal>1428</span>
+<span class=normal>1429</span>
+<span class=normal>1430</span>
+<span class=normal>1431</span>
+<span class=normal>1432</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Role</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Defines a function, which might be assigned to a party in a specific situation.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for the role.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Identifier&#39;</span><span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the role, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>short_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;short-name&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A short common name, abbreviation, or acronym for the role.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Short Name&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the role&#39;s purpose and associated responsibilities.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Role-attributes>Attributes<a href=#trestle.oscal.common.Role-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Role.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the role&#39;s purpose and associated responsibilities.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Role.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Role.id class="doc doc-heading"> <code class="highlight language-python"><span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A unique identifier for the role.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Role.id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Role.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Role.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Role.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Role.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Role.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Role.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Role.short_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>short_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;short-name&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A short common name, abbreviation, or acronym for the role.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Short Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Role.short_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Role.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the role, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Role.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Role-classes>Classes<a href=#trestle.oscal.common.Role-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Role.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Role.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1409</span>
+<span class=normal>1410</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Role.Config-attributes>Attributes<a href=#trestle.oscal.common.Role.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Role.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Role.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.RoleId class="doc doc-heading"> <code>RoleId</code> <a href=#trestle.oscal.common.RoleId class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>274</span>
+<span class=normal>275</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RoleId</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>TokenDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Reference to a role by UUID.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Identifier Reference&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.RoleId-attributes>Attributes<a href=#trestle.oscal.common.RoleId-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.RoleId.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>TokenDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Reference to a role by UUID.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Role Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.RoleId.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SelectControlById class="doc doc-heading"> <code>SelectControlById</code> <a href=#trestle.oscal.common.SelectControlById class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to select a control for inclusion/exclusion based on one or more control identifiers. A set of statement identifiers can be used to target the inclusion/exclusion to only specific control statements providing more granularity over the specific statements that are within the asessment scope.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SelectControlById</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to select a control for inclusion/exclusion based on one or more control identifiers. A set of statement identifiers can be used to target the inclusion/exclusion to only specific control statements providing more granularity over the specific statements that are within the asessment scope.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>statement_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;statement-ids&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SelectControlById-attributes>Attributes<a href=#trestle.oscal.common.SelectControlById-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectControlById.control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectControlById.control_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectControlById.statement_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>statement_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;statement-ids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectControlById.statement_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.SelectControlById-classes>Classes<a href=#trestle.oscal.common.SelectControlById-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.SelectControlById.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.SelectControlById.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>253</span>
+<span class=normal>254</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.SelectControlById.Config-attributes>Attributes<a href=#trestle.oscal.common.SelectControlById.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.SelectControlById.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectControlById.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SelectObjectiveById class="doc doc-heading"> <code>SelectObjectiveById</code> <a href=#trestle.oscal.common.SelectObjectiveById class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to select a control objective for inclusion/exclusion based on the control objective's identifier.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SelectObjectiveById</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to select a control objective for inclusion/exclusion based on the control objective&#39;s identifier.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>objective_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;objective-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Points to an assessment objective.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective ID&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SelectObjectiveById-attributes>Attributes<a href=#trestle.oscal.common.SelectObjectiveById-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectObjectiveById.objective_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>objective_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;objective-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Points to an assessment objective.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Objective ID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectObjectiveById.objective_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.SelectObjectiveById-classes>Classes<a href=#trestle.oscal.common.SelectObjectiveById-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.SelectObjectiveById.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.SelectObjectiveById.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>239</span>
+<span class=normal>240</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.SelectObjectiveById.Config-attributes>Attributes<a href=#trestle.oscal.common.SelectObjectiveById.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.SelectObjectiveById.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectObjectiveById.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SelectSubjectById class="doc doc-heading"> <code>SelectSubjectById</code> <a href=#trestle.oscal.common.SelectSubjectById class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies a set of assessment subjects to include/exclude by UUID.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1350</span>
+<span class=normal>1351</span>
+<span class=normal>1352</span>
+<span class=normal>1353</span>
+<span class=normal>1354</span>
+<span class=normal>1355</span>
+<span class=normal>1356</span>
+<span class=normal>1357</span>
+<span class=normal>1358</span>
+<span class=normal>1359</span>
+<span class=normal>1360</span>
+<span class=normal>1361</span>
+<span class=normal>1362</span>
+<span class=normal>1363</span>
+<span class=normal>1364</span>
+<span class=normal>1365</span>
+<span class=normal>1366</span>
+<span class=normal>1367</span>
+<span class=normal>1368</span>
+<span class=normal>1369</span>
+<span class=normal>1370</span>
+<span class=normal>1371</span>
+<span class=normal>1372</span>
+<span class=normal>1373</span>
+<span class=normal>1374</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SelectSubjectById</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies a set of assessment subjects to include/exclude by UUID.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>subject_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;subject-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A machine-oriented identifier reference to a component, inventory-item, location, party, user, or resource using it&#39;s UUID.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>SelectSubjectByIdValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to indicate the type of object pointed to by the uuid-ref within a subject.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Universally Unique Identifier Reference Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SelectSubjectById-attributes>Attributes<a href=#trestle.oscal.common.SelectSubjectById-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectById.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectById.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectById.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectById.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectById.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectById.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectById.subject_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>subject_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;subject-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A machine-oriented identifier reference to a component, inventory-item, location, party, user, or resource using it&#39;s UUID.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectById.subject_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectById.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>SelectSubjectByIdValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to indicate the type of object pointed to by the uuid-ref within a subject.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Universally Unique Identifier Reference Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectById.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.SelectSubjectById-classes>Classes<a href=#trestle.oscal.common.SelectSubjectById-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.SelectSubjectById.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.SelectSubjectById.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1355</span>
+<span class=normal>1356</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.SelectSubjectById.Config-attributes>Attributes<a href=#trestle.oscal.common.SelectSubjectById.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.SelectSubjectById.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectById.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SelectSubjectByIdValidValues class="doc doc-heading"> <code>SelectSubjectByIdValidValues</code> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SelectSubjectByIdValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>component</span> <span class=o>=</span> <span class=s1>&#39;component&#39;</span>
+    <span class=n>inventory_item</span> <span class=o>=</span> <span class=s1>&#39;inventory-item&#39;</span>
+    <span class=n>location</span> <span class=o>=</span> <span class=s1>&#39;location&#39;</span>
+    <span class=n>party</span> <span class=o>=</span> <span class=s1>&#39;party&#39;</span>
+    <span class=n>user</span> <span class=o>=</span> <span class=s1>&#39;user&#39;</span>
+    <span class=n>resource</span> <span class=o>=</span> <span class=s1>&#39;resource&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SelectSubjectByIdValidValues-attributes>Attributes<a href=#trestle.oscal.common.SelectSubjectByIdValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectByIdValidValues.component class="doc doc-heading"> <code class="highlight language-python"><span class=n>component</span> <span class=o>=</span> <span class=s1>&#39;component&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectByIdValidValues.inventory_item class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory_item</span> <span class=o>=</span> <span class=s1>&#39;inventory-item&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.inventory_item class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectByIdValidValues.location class="doc doc-heading"> <code class="highlight language-python"><span class=n>location</span> <span class=o>=</span> <span class=s1>&#39;location&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.location class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectByIdValidValues.party class="doc doc-heading"> <code class="highlight language-python"><span class=n>party</span> <span class=o>=</span> <span class=s1>&#39;party&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.party class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectByIdValidValues.resource class="doc doc-heading"> <code class="highlight language-python"><span class=n>resource</span> <span class=o>=</span> <span class=s1>&#39;resource&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.resource class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SelectSubjectByIdValidValues.user class="doc doc-heading"> <code class="highlight language-python"><span class=n>user</span> <span class=o>=</span> <span class=s1>&#39;user&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SelectSubjectByIdValidValues.user class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Source class="doc doc-heading"> <code>Source</code> <a href=#trestle.oscal.common.Source class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Assessment subjects will be identified while conducting the referenced activity-instance.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Source</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Assessment subjects will be identified while conducting the referenced activity-instance.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>task_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;task-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference (in this or other OSCAL instances) an assessment activity to be performed as part of the event. The locally defined UUID of the task can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Source-attributes>Attributes<a href=#trestle.oscal.common.Source-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Source.task_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>task_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;task-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference (in this or other OSCAL instances) an assessment activity to be performed as part of the event. The locally defined UUID of the task can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Source.task_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Source-classes>Classes<a href=#trestle.oscal.common.Source-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Source.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Source.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>211</span>
+<span class=normal>212</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Source.Config-attributes>Attributes<a href=#trestle.oscal.common.Source.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Source.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Source.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.State class="doc doc-heading"> <code>State</code> <a href=#trestle.oscal.common.State class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Identifies the implementation status of the control or control objective.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>State</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the implementation status of the control or control objective.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>implemented</span> <span class=o>=</span> <span class=s1>&#39;implemented&#39;</span>
+    <span class=n>partial</span> <span class=o>=</span> <span class=s1>&#39;partial&#39;</span>
+    <span class=n>planned</span> <span class=o>=</span> <span class=s1>&#39;planned&#39;</span>
+    <span class=n>alternative</span> <span class=o>=</span> <span class=s1>&#39;alternative&#39;</span>
+    <span class=n>not_applicable</span> <span class=o>=</span> <span class=s1>&#39;not-applicable&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.State-attributes>Attributes<a href=#trestle.oscal.common.State-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.State.alternative class="doc doc-heading"> <code class="highlight language-python"><span class=n>alternative</span> <span class=o>=</span> <span class=s1>&#39;alternative&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.State.alternative class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.State.implemented class="doc doc-heading"> <code class="highlight language-python"><span class=n>implemented</span> <span class=o>=</span> <span class=s1>&#39;implemented&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.State.implemented class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.State.not_applicable class="doc doc-heading"> <code class="highlight language-python"><span class=n>not_applicable</span> <span class=o>=</span> <span class=s1>&#39;not-applicable&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.State.not_applicable class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.State.partial class="doc doc-heading"> <code class="highlight language-python"><span class=n>partial</span> <span class=o>=</span> <span class=s1>&#39;partial&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.State.partial class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.State.planned class="doc doc-heading"> <code class="highlight language-python"><span class=n>planned</span> <span class=o>=</span> <span class=s1>&#39;planned&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.State.planned class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Status class="doc doc-heading"> <code>Status</code> <a href=#trestle.oscal.common.Status class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes the operational status of the system component.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Status</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes the operational status of the system component.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>state</span><span class=p>:</span> <span class=n>SystemComponentOperationalStateValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The operational status.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;State&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Status-attributes>Attributes<a href=#trestle.oscal.common.Status-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Status.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Status.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Status.state class="doc doc-heading"> <code class="highlight language-python"><span class=n>state</span><span class=p>:</span> <span class=n>SystemComponentOperationalStateValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The operational status.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;State&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Status.state class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Status-classes>Classes<a href=#trestle.oscal.common.Status-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Status.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Status.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>187</span>
+<span class=normal>188</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Status.Config-attributes>Attributes<a href=#trestle.oscal.common.Status.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Status.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Status.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Step class="doc doc-heading"> <code>Step</code> <a href=#trestle.oscal.common.Step class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies an individual step in a series of steps related to an activity, such as an assessment test or examination procedure.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2332</span>
+<span class=normal>2333</span>
+<span class=normal>2334</span>
+<span class=normal>2335</span>
+<span class=normal>2336</span>
+<span class=normal>2337</span>
+<span class=normal>2338</span>
+<span class=normal>2339</span>
+<span class=normal>2340</span>
+<span class=normal>2341</span>
+<span class=normal>2342</span>
+<span class=normal>2343</span>
+<span class=normal>2344</span>
+<span class=normal>2345</span>
+<span class=normal>2346</span>
+<span class=normal>2347</span>
+<span class=normal>2348</span>
+<span class=normal>2349</span>
+<span class=normal>2350</span>
+<span class=normal>2351</span>
+<span class=normal>2352</span>
+<span class=normal>2353</span>
+<span class=normal>2354</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Step</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies an individual step in a series of steps related to an activity, such as an assessment test or examination procedure.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this step elsewhere in this or other OSCAL instances. The locally defined UUID of the step (in a series of steps) can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Step Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this step.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Step Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this step.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Step Description&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>reviewed_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ReviewedControls</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;reviewed-controls&#39;</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Step-attributes>Attributes<a href=#trestle.oscal.common.Step-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Step.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this step.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Step Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Step.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Step.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Step.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Step.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Step.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Step.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Step.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Step.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Step.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Step.reviewed_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>reviewed_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ReviewedControls</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;reviewed-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Step.reviewed_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Step.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this step.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Step Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Step.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Step.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this step elsewhere in this or other OSCAL instances. The locally defined UUID of the step (in a series of steps) can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Step Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Step.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Step-classes>Classes<a href=#trestle.oscal.common.Step-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Step.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Step.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2337</span>
+<span class=normal>2338</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Step.Config-attributes>Attributes<a href=#trestle.oscal.common.Step.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Step.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Step.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.StringDatatype class="doc doc-heading"> <code>StringDatatype</code> <a href=#trestle.oscal.common.StringDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>StringDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A non-empty string with leading and trailing whitespace disallowed. Whitespace is: U+9, U+10, U+32 or [ </span><span class=se>\n\t</span><span class=s1>]+&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.StringDatatype-attributes>Attributes<a href=#trestle.oscal.common.StringDatatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.StringDatatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A non-empty string with leading and trailing whitespace disallowed. Whitespace is: U+9, U+10, U+32 or [ </span><span class=se>\n\t</span><span class=s1>]+&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.StringDatatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SubjectReference class="doc doc-heading"> <code>SubjectReference</code> <a href=#trestle.oscal.common.SubjectReference class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A human-oriented identifier reference to a resource. Use type to indicate whether the identified resource is a component, inventory item, location, user, or something else.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1285</span>
+<span class=normal>1286</span>
+<span class=normal>1287</span>
+<span class=normal>1288</span>
+<span class=normal>1289</span>
+<span class=normal>1290</span>
+<span class=normal>1291</span>
+<span class=normal>1292</span>
+<span class=normal>1293</span>
+<span class=normal>1294</span>
+<span class=normal>1295</span>
+<span class=normal>1296</span>
+<span class=normal>1297</span>
+<span class=normal>1298</span>
+<span class=normal>1299</span>
+<span class=normal>1300</span>
+<span class=normal>1301</span>
+<span class=normal>1302</span>
+<span class=normal>1303</span>
+<span class=normal>1304</span>
+<span class=normal>1305</span>
+<span class=normal>1306</span>
+<span class=normal>1307</span>
+<span class=normal>1308</span>
+<span class=normal>1309</span>
+<span class=normal>1310</span>
+<span class=normal>1311</span>
+<span class=normal>1312</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SubjectReference</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A human-oriented identifier reference to a resource. Use type to indicate whether the identified resource is a component, inventory item, location, user, or something else.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>subject_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;subject-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A machine-oriented identifier reference to a component, inventory-item, location, party, user, or resource using it&#39;s UUID.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>SubjectReferenceValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to indicate the type of object pointed to by the uuid-ref within a subject.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Universally Unique Identifier Reference Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title or name for the referenced subject.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Reference Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SubjectReference-attributes>Attributes<a href=#trestle.oscal.common.SubjectReference-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReference.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReference.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReference.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReference.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReference.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReference.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReference.subject_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>subject_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;subject-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A machine-oriented identifier reference to a component, inventory-item, location, party, user, or resource using it&#39;s UUID.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReference.subject_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReference.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title or name for the referenced subject.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Reference Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReference.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReference.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>SubjectReferenceValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to indicate the type of object pointed to by the uuid-ref within a subject.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Subject Universally Unique Identifier Reference Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReference.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.SubjectReference-classes>Classes<a href=#trestle.oscal.common.SubjectReference-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.SubjectReference.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.SubjectReference.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1290</span>
+<span class=normal>1291</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.SubjectReference.Config-attributes>Attributes<a href=#trestle.oscal.common.SubjectReference.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.SubjectReference.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReference.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SubjectReferenceValidValues class="doc doc-heading"> <code>SubjectReferenceValidValues</code> <a href=#trestle.oscal.common.SubjectReferenceValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SubjectReferenceValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>component</span> <span class=o>=</span> <span class=s1>&#39;component&#39;</span>
+    <span class=n>inventory_item</span> <span class=o>=</span> <span class=s1>&#39;inventory-item&#39;</span>
+    <span class=n>location</span> <span class=o>=</span> <span class=s1>&#39;location&#39;</span>
+    <span class=n>party</span> <span class=o>=</span> <span class=s1>&#39;party&#39;</span>
+    <span class=n>user</span> <span class=o>=</span> <span class=s1>&#39;user&#39;</span>
+    <span class=n>resource</span> <span class=o>=</span> <span class=s1>&#39;resource&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SubjectReferenceValidValues-attributes>Attributes<a href=#trestle.oscal.common.SubjectReferenceValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReferenceValidValues.component class="doc doc-heading"> <code class="highlight language-python"><span class=n>component</span> <span class=o>=</span> <span class=s1>&#39;component&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReferenceValidValues.component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReferenceValidValues.inventory_item class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory_item</span> <span class=o>=</span> <span class=s1>&#39;inventory-item&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReferenceValidValues.inventory_item class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReferenceValidValues.location class="doc doc-heading"> <code class="highlight language-python"><span class=n>location</span> <span class=o>=</span> <span class=s1>&#39;location&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReferenceValidValues.location class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReferenceValidValues.party class="doc doc-heading"> <code class="highlight language-python"><span class=n>party</span> <span class=o>=</span> <span class=s1>&#39;party&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReferenceValidValues.party class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReferenceValidValues.resource class="doc doc-heading"> <code class="highlight language-python"><span class=n>resource</span> <span class=o>=</span> <span class=s1>&#39;resource&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReferenceValidValues.resource class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SubjectReferenceValidValues.user class="doc doc-heading"> <code class="highlight language-python"><span class=n>user</span> <span class=o>=</span> <span class=s1>&#39;user&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SubjectReferenceValidValues.user class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SystemComponent class="doc doc-heading"> <code>SystemComponent</code> <a href=#trestle.oscal.common.SystemComponent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A defined component that can be part of an implemented system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1609</span>
+<span class=normal>1610</span>
+<span class=normal>1611</span>
+<span class=normal>1612</span>
+<span class=normal>1613</span>
+<span class=normal>1614</span>
+<span class=normal>1615</span>
+<span class=normal>1616</span>
+<span class=normal>1617</span>
+<span class=normal>1618</span>
+<span class=normal>1619</span>
+<span class=normal>1620</span>
+<span class=normal>1621</span>
+<span class=normal>1622</span>
+<span class=normal>1623</span>
+<span class=normal>1624</span>
+<span class=normal>1625</span>
+<span class=normal>1626</span>
+<span class=normal>1627</span>
+<span class=normal>1628</span>
+<span class=normal>1629</span>
+<span class=normal>1630</span>
+<span class=normal>1631</span>
+<span class=normal>1632</span>
+<span class=normal>1633</span>
+<span class=normal>1634</span>
+<span class=normal>1635</span>
+<span class=normal>1636</span>
+<span class=normal>1637</span>
+<span class=normal>1638</span>
+<span class=normal>1639</span>
+<span class=normal>1640</span>
+<span class=normal>1641</span>
+<span class=normal>1642</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SystemComponent</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A defined component that can be part of an implemented system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this component elsewhere in this or other OSCAL instances. The locally defined UUID of the component can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>),</span> <span class=n>SystemComponentTypeValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A category describing the purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the system component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of the component, including information about its function.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>purpose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the technological or business purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Purpose&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>status</span><span class=p>:</span> <span class=n>Status</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes the operational status of the system component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Status&#39;</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>protocols</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Protocol</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SystemComponent-attributes>Attributes<a href=#trestle.oscal.common.SystemComponent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of the component, including information about its function.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.protocols class="doc doc-heading"> <code class="highlight language-python"><span class=n>protocols</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Protocol</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.protocols class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.purpose class="doc doc-heading"> <code class="highlight language-python"><span class=n>purpose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the technological or business purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Purpose&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.purpose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.status class="doc doc-heading"> <code class="highlight language-python"><span class=n>status</span><span class=p>:</span> <span class=n>Status</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes the operational status of the system component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Status&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the system component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>),</span> <span class=n>SystemComponentTypeValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A category describing the purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponent.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this component elsewhere in this or other OSCAL instances. The locally defined UUID of the component can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.SystemComponent-classes>Classes<a href=#trestle.oscal.common.SystemComponent-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.SystemComponent.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.SystemComponent.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1614</span>
+<span class=normal>1615</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.SystemComponent.Config-attributes>Attributes<a href=#trestle.oscal.common.SystemComponent.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.SystemComponent.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponent.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SystemComponentOperationalStateValidValues class="doc doc-heading"> <code>SystemComponentOperationalStateValidValues</code> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SystemComponentOperationalStateValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>under_development</span> <span class=o>=</span> <span class=s1>&#39;under-development&#39;</span>
+    <span class=n>operational</span> <span class=o>=</span> <span class=s1>&#39;operational&#39;</span>
+    <span class=n>disposition</span> <span class=o>=</span> <span class=s1>&#39;disposition&#39;</span>
+    <span class=n>other</span> <span class=o>=</span> <span class=s1>&#39;other&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SystemComponentOperationalStateValidValues-attributes>Attributes<a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentOperationalStateValidValues.disposition class="doc doc-heading"> <code class="highlight language-python"><span class=n>disposition</span> <span class=o>=</span> <span class=s1>&#39;disposition&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.disposition class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentOperationalStateValidValues.operational class="doc doc-heading"> <code class="highlight language-python"><span class=n>operational</span> <span class=o>=</span> <span class=s1>&#39;operational&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.operational class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentOperationalStateValidValues.other class="doc doc-heading"> <code class="highlight language-python"><span class=n>other</span> <span class=o>=</span> <span class=s1>&#39;other&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.other class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentOperationalStateValidValues.under_development class="doc doc-heading"> <code class="highlight language-python"><span class=n>under_development</span> <span class=o>=</span> <span class=s1>&#39;under-development&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentOperationalStateValidValues.under_development class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SystemComponentTypeValidValues class="doc doc-heading"> <code>SystemComponentTypeValidValues</code> <a href=#trestle.oscal.common.SystemComponentTypeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SystemComponentTypeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>this_system</span> <span class=o>=</span> <span class=s1>&#39;this-system&#39;</span>
+    <span class=n>system</span> <span class=o>=</span> <span class=s1>&#39;system&#39;</span>
+    <span class=n>interconnection</span> <span class=o>=</span> <span class=s1>&#39;interconnection&#39;</span>
+    <span class=n>software</span> <span class=o>=</span> <span class=s1>&#39;software&#39;</span>
+    <span class=n>hardware</span> <span class=o>=</span> <span class=s1>&#39;hardware&#39;</span>
+    <span class=n>service</span> <span class=o>=</span> <span class=s1>&#39;service&#39;</span>
+    <span class=n>policy</span> <span class=o>=</span> <span class=s1>&#39;policy&#39;</span>
+    <span class=n>physical</span> <span class=o>=</span> <span class=s1>&#39;physical&#39;</span>
+    <span class=n>process_procedure</span> <span class=o>=</span> <span class=s1>&#39;process-procedure&#39;</span>
+    <span class=n>plan</span> <span class=o>=</span> <span class=s1>&#39;plan&#39;</span>
+    <span class=n>guidance</span> <span class=o>=</span> <span class=s1>&#39;guidance&#39;</span>
+    <span class=n>standard</span> <span class=o>=</span> <span class=s1>&#39;standard&#39;</span>
+    <span class=n>validation</span> <span class=o>=</span> <span class=s1>&#39;validation&#39;</span>
+    <span class=n>network</span> <span class=o>=</span> <span class=s1>&#39;network&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SystemComponentTypeValidValues-attributes>Attributes<a href=#trestle.oscal.common.SystemComponentTypeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.guidance class="doc doc-heading"> <code class="highlight language-python"><span class=n>guidance</span> <span class=o>=</span> <span class=s1>&#39;guidance&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.guidance class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.hardware class="doc doc-heading"> <code class="highlight language-python"><span class=n>hardware</span> <span class=o>=</span> <span class=s1>&#39;hardware&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.hardware class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.interconnection class="doc doc-heading"> <code class="highlight language-python"><span class=n>interconnection</span> <span class=o>=</span> <span class=s1>&#39;interconnection&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.interconnection class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.network class="doc doc-heading"> <code class="highlight language-python"><span class=n>network</span> <span class=o>=</span> <span class=s1>&#39;network&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.network class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.physical class="doc doc-heading"> <code class="highlight language-python"><span class=n>physical</span> <span class=o>=</span> <span class=s1>&#39;physical&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.physical class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.plan class="doc doc-heading"> <code class="highlight language-python"><span class=n>plan</span> <span class=o>=</span> <span class=s1>&#39;plan&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.plan class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.policy class="doc doc-heading"> <code class="highlight language-python"><span class=n>policy</span> <span class=o>=</span> <span class=s1>&#39;policy&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.policy class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.process_procedure class="doc doc-heading"> <code class="highlight language-python"><span class=n>process_procedure</span> <span class=o>=</span> <span class=s1>&#39;process-procedure&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.process_procedure class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.service class="doc doc-heading"> <code class="highlight language-python"><span class=n>service</span> <span class=o>=</span> <span class=s1>&#39;service&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.service class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.software class="doc doc-heading"> <code class="highlight language-python"><span class=n>software</span> <span class=o>=</span> <span class=s1>&#39;software&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.software class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.standard class="doc doc-heading"> <code class="highlight language-python"><span class=n>standard</span> <span class=o>=</span> <span class=s1>&#39;standard&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.standard class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.system class="doc doc-heading"> <code class="highlight language-python"><span class=n>system</span> <span class=o>=</span> <span class=s1>&#39;system&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.system class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.this_system class="doc doc-heading"> <code class="highlight language-python"><span class=n>this_system</span> <span class=o>=</span> <span class=s1>&#39;this-system&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.this_system class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemComponentTypeValidValues.validation class="doc doc-heading"> <code class="highlight language-python"><span class=n>validation</span> <span class=o>=</span> <span class=s1>&#39;validation&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemComponentTypeValidValues.validation class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SystemId class="doc doc-heading"> <code>SystemId</code> <a href=#trestle.oscal.common.SystemId class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A human-oriented, globally unique identifier with cross-instance scope that can be used to reference this system identification property elsewhere in this or other OSCAL instances. When referencing an externally defined system identification, the system identification must be used in the context of the external / imported OSCAL instance (e.g., uri-reference). This string should be assigned per-subject, which means it should be consistently used to identify the same system across revisions of the document.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1268</span>
+<span class=normal>1269</span>
+<span class=normal>1270</span>
+<span class=normal>1271</span>
+<span class=normal>1272</span>
+<span class=normal>1273</span>
+<span class=normal>1274</span>
+<span class=normal>1275</span>
+<span class=normal>1276</span>
+<span class=normal>1277</span>
+<span class=normal>1278</span>
+<span class=normal>1279</span>
+<span class=normal>1280</span>
+<span class=normal>1281</span>
+<span class=normal>1282</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SystemId</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A human-oriented, globally unique identifier with cross-instance scope that can be used to reference this system identification property elsewhere in this or other OSCAL instances. When referencing an externally defined system identification, the system identification must be used in the context of the external / imported OSCAL instance (e.g., uri-reference). This string should be assigned per-subject, which means it should be consistently used to identify the same system across revisions of the document.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>identifier_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>,</span> <span class=n>IdentifierType</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;identifier-type&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the identification system from which the provided identifier was assigned.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Identification System Type&#39;</span>
+    <span class=p>)</span>
+    <span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SystemId-attributes>Attributes<a href=#trestle.oscal.common.SystemId-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemId.id class="doc doc-heading"> <code class="highlight language-python"><span class=nb>id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemId.id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemId.identifier_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>identifier_type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>,</span> <span class=n>IdentifierType</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;identifier-type&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the identification system from which the provided identifier was assigned.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Identification System Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemId.identifier_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.SystemId-classes>Classes<a href=#trestle.oscal.common.SystemId-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.SystemId.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.SystemId.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1273</span>
+<span class=normal>1274</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.SystemId.Config-attributes>Attributes<a href=#trestle.oscal.common.SystemId.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.SystemId.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemId.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.SystemUser class="doc doc-heading"> <code>SystemUser</code> <a href=#trestle.oscal.common.SystemUser class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A type of user that interacts with the system based on an associated role.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1226</span>
+<span class=normal>1227</span>
+<span class=normal>1228</span>
+<span class=normal>1229</span>
+<span class=normal>1230</span>
+<span class=normal>1231</span>
+<span class=normal>1232</span>
+<span class=normal>1233</span>
+<span class=normal>1234</span>
+<span class=normal>1235</span>
+<span class=normal>1236</span>
+<span class=normal>1237</span>
+<span class=normal>1238</span>
+<span class=normal>1239</span>
+<span class=normal>1240</span>
+<span class=normal>1241</span>
+<span class=normal>1242</span>
+<span class=normal>1243</span>
+<span class=normal>1244</span>
+<span class=normal>1245</span>
+<span class=normal>1246</span>
+<span class=normal>1247</span>
+<span class=normal>1248</span>
+<span class=normal>1249</span>
+<span class=normal>1250</span>
+<span class=normal>1251</span>
+<span class=normal>1252</span>
+<span class=normal>1253</span>
+<span class=normal>1254</span>
+<span class=normal>1255</span>
+<span class=normal>1256</span>
+<span class=normal>1257</span>
+<span class=normal>1258</span>
+<span class=normal>1259</span>
+<span class=normal>1260</span>
+<span class=normal>1261</span>
+<span class=normal>1262</span>
+<span class=normal>1263</span>
+<span class=normal>1264</span>
+<span class=normal>1265</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SystemUser</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A type of user that interacts with the system based on an associated role.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this user class elsewhere in this or other OSCAL instances. The locally defined UUID of the system user can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;User Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the user, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;User Title&#39;</span>
+    <span class=p>)</span>
+    <span class=n>short_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;short-name&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A short common name, abbreviation, or acronym for the user.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;User Short Name&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the user&#39;s purpose within the system.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;User Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>role_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-ids&#39;</span>
+    <span class=p>)</span>
+    <span class=n>authorized_privileges</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AuthorizedPrivilege</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;authorized-privileges&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.SystemUser-attributes>Attributes<a href=#trestle.oscal.common.SystemUser-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemUser.authorized_privileges class="doc doc-heading"> <code class="highlight language-python"><span class=n>authorized_privileges</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AuthorizedPrivilege</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;authorized-privileges&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.authorized_privileges class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemUser.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the user&#39;s purpose within the system.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;User Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemUser.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemUser.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemUser.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemUser.role_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>role_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;role-ids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.role_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemUser.short_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>short_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;short-name&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A short common name, abbreviation, or acronym for the user.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;User Short Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.short_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemUser.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the user, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;User Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.SystemUser.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this user class elsewhere in this or other OSCAL instances. The locally defined UUID of the system user can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;User Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.SystemUser-classes>Classes<a href=#trestle.oscal.common.SystemUser-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.SystemUser.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.SystemUser.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1231</span>
+<span class=normal>1232</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.SystemUser.Config-attributes>Attributes<a href=#trestle.oscal.common.SystemUser.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.SystemUser.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.SystemUser.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Task class="doc doc-heading"> <code>Task</code> <a href=#trestle.oscal.common.Task class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Represents a scheduled event or milestone, which may be associated with a series of assessment actions.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2137</span>
+<span class=normal>2138</span>
+<span class=normal>2139</span>
+<span class=normal>2140</span>
+<span class=normal>2141</span>
+<span class=normal>2142</span>
+<span class=normal>2143</span>
+<span class=normal>2144</span>
+<span class=normal>2145</span>
+<span class=normal>2146</span>
+<span class=normal>2147</span>
+<span class=normal>2148</span>
+<span class=normal>2149</span>
+<span class=normal>2150</span>
+<span class=normal>2151</span>
+<span class=normal>2152</span>
+<span class=normal>2153</span>
+<span class=normal>2154</span>
+<span class=normal>2155</span>
+<span class=normal>2156</span>
+<span class=normal>2157</span>
+<span class=normal>2158</span>
+<span class=normal>2159</span>
+<span class=normal>2160</span>
+<span class=normal>2161</span>
+<span class=normal>2162</span>
+<span class=normal>2163</span>
+<span class=normal>2164</span>
+<span class=normal>2165</span>
+<span class=normal>2166</span>
+<span class=normal>2167</span>
+<span class=normal>2168</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Task</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Represents a scheduled event or milestone, which may be associated with a series of assessment actions.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this task elsewhere in this or other OSCAL instances. The locally defined UUID of the task can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>TaskValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The type of task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Type&#39;</span><span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>timing</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Timing</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The timing under which the task is intended to occur.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Event Timing&#39;</span>
+    <span class=p>)</span>
+    <span class=n>dependencies</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Dependency</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Task</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>associated_activities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AssociatedActivity</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;associated-activities&#39;</span><span class=p>)</span>
+    <span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AssessmentSubject</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Task-attributes>Attributes<a href=#trestle.oscal.common.Task-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.associated_activities class="doc doc-heading"> <code class="highlight language-python"><span class=n>associated_activities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AssociatedActivity</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;associated-activities&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.associated_activities class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.dependencies class="doc doc-heading"> <code class="highlight language-python"><span class=n>dependencies</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Dependency</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.dependencies class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of this task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.subjects class="doc doc-heading"> <code class="highlight language-python"><span class=n>subjects</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>AssessmentSubject</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.subjects class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.tasks class="doc doc-heading"> <code class="highlight language-python"><span class=n>tasks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Task</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.tasks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.timing class="doc doc-heading"> <code class="highlight language-python"><span class=n>timing</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Timing</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The timing under which the task is intended to occur.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Event Timing&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.timing class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title for this task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>TokenDatatype</span><span class=p>,</span> <span class=n>TaskValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The type of task.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Task.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this task elsewhere in this or other OSCAL instances. The locally defined UUID of the task can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Task Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Task-classes>Classes<a href=#trestle.oscal.common.Task-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Task.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Task.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2142</span>
+<span class=normal>2143</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Task.Config-attributes>Attributes<a href=#trestle.oscal.common.Task.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Task.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Task.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.TaskValidValues class="doc doc-heading"> <code>TaskValidValues</code> <a href=#trestle.oscal.common.TaskValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TaskValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>milestone</span> <span class=o>=</span> <span class=s1>&#39;milestone&#39;</span>
+    <span class=n>action</span> <span class=o>=</span> <span class=s1>&#39;action&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.TaskValidValues-attributes>Attributes<a href=#trestle.oscal.common.TaskValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TaskValidValues.action class="doc doc-heading"> <code class="highlight language-python"><span class=n>action</span> <span class=o>=</span> <span class=s1>&#39;action&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TaskValidValues.action class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TaskValidValues.milestone class="doc doc-heading"> <code class="highlight language-python"><span class=n>milestone</span> <span class=o>=</span> <span class=s1>&#39;milestone&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TaskValidValues.milestone class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.TelephoneNumber class="doc doc-heading"> <code>TelephoneNumber</code> <a href=#trestle.oscal.common.TelephoneNumber class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A telephone service number as defined by ITU-T E.164.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1184</span>
+<span class=normal>1185</span>
+<span class=normal>1186</span>
+<span class=normal>1187</span>
+<span class=normal>1188</span>
+<span class=normal>1189</span>
+<span class=normal>1190</span>
+<span class=normal>1191</span>
+<span class=normal>1192</span>
+<span class=normal>1193</span>
+<span class=normal>1194</span>
+<span class=normal>1195</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TelephoneNumber</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A telephone service number as defined by ITU-T E.164.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>StringDatatype</span><span class=p>,</span> <span class=n>TelephoneTypeValidValues</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the type of phone number.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;type flag&#39;</span>
+    <span class=p>)</span>
+    <span class=n>number</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.TelephoneNumber-attributes>Attributes<a href=#trestle.oscal.common.TelephoneNumber-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TelephoneNumber.number class="doc doc-heading"> <code class="highlight language-python"><span class=n>number</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TelephoneNumber.number class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TelephoneNumber.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Union</span><span class=p>[</span><span class=n>StringDatatype</span><span class=p>,</span> <span class=n>TelephoneTypeValidValues</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates the type of phone number.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;type flag&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TelephoneNumber.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.TelephoneNumber-classes>Classes<a href=#trestle.oscal.common.TelephoneNumber-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.TelephoneNumber.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.TelephoneNumber.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1189</span>
+<span class=normal>1190</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.TelephoneNumber.Config-attributes>Attributes<a href=#trestle.oscal.common.TelephoneNumber.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.TelephoneNumber.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TelephoneNumber.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.TelephoneTypeValidValues class="doc doc-heading"> <code>TelephoneTypeValidValues</code> <a href=#trestle.oscal.common.TelephoneTypeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TelephoneTypeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>home</span> <span class=o>=</span> <span class=s1>&#39;home&#39;</span>
+    <span class=n>office</span> <span class=o>=</span> <span class=s1>&#39;office&#39;</span>
+    <span class=n>mobile</span> <span class=o>=</span> <span class=s1>&#39;mobile&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.TelephoneTypeValidValues-attributes>Attributes<a href=#trestle.oscal.common.TelephoneTypeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TelephoneTypeValidValues.home class="doc doc-heading"> <code class="highlight language-python"><span class=n>home</span> <span class=o>=</span> <span class=s1>&#39;home&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TelephoneTypeValidValues.home class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TelephoneTypeValidValues.mobile class="doc doc-heading"> <code class="highlight language-python"><span class=n>mobile</span> <span class=o>=</span> <span class=s1>&#39;mobile&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TelephoneTypeValidValues.mobile class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TelephoneTypeValidValues.office class="doc doc-heading"> <code class="highlight language-python"><span class=n>office</span> <span class=o>=</span> <span class=s1>&#39;office&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TelephoneTypeValidValues.office class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Test class="doc doc-heading"> <code>Test</code> <a href=#trestle.oscal.common.Test class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A test expression which is expected to be evaluated by a tool.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Test</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A test expression which is expected to be evaluated by a tool.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>expression</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A formal (executable) expression of a constraint.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Constraint test&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Test-attributes>Attributes<a href=#trestle.oscal.common.Test-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Test.expression class="doc doc-heading"> <code class="highlight language-python"><span class=n>expression</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A formal (executable) expression of a constraint.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Constraint test&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Test.expression class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Test.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Test.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Test-classes>Classes<a href=#trestle.oscal.common.Test-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Test.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Test.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Test.Config-attributes>Attributes<a href=#trestle.oscal.common.Test.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Test.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Test.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ThreatId class="doc doc-heading"> <code>ThreatId</code> <a href=#trestle.oscal.common.ThreatId class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A pointer, by ID, to an externally-defined threat.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ThreatId</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A pointer, by ID, to an externally-defined threat.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>system</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>URIDatatype</span><span class=p>,</span> <span class=n>ThreatIdValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Specifies the source of the threat information.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Threat Type Identification System&#39;</span>
+    <span class=p>)</span>
+    <span class=n>href</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional location for the threat data, from which this ID originates.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Threat Information Resource Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=nb>id</span><span class=p>:</span> <span class=n>AnyUrl</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ThreatId-attributes>Attributes<a href=#trestle.oscal.common.ThreatId-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ThreatId.href class="doc doc-heading"> <code class="highlight language-python"><span class=n>href</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An optional location for the threat data, from which this ID originates.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Threat Information Resource Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ThreatId.href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ThreatId.id class="doc doc-heading"> <code class="highlight language-python"><span class=nb>id</span><span class=p>:</span> <span class=n>AnyUrl</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ThreatId.id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ThreatId.system class="doc doc-heading"> <code class="highlight language-python"><span class=n>system</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>URIDatatype</span><span class=p>,</span> <span class=n>ThreatIdValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Specifies the source of the threat information.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Threat Type Identification System&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ThreatId.system class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.ThreatId-classes>Classes<a href=#trestle.oscal.common.ThreatId-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.ThreatId.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.ThreatId.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>102</span>
+<span class=normal>103</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.ThreatId.Config-attributes>Attributes<a href=#trestle.oscal.common.ThreatId.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.ThreatId.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ThreatId.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.ThreatIdValidValues class="doc doc-heading"> <code>ThreatIdValidValues</code> <a href=#trestle.oscal.common.ThreatIdValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ThreatIdValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>http___fedramp_gov</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov&#39;</span>
+    <span class=n>http___fedramp_gov_ns_oscal</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov/ns/oscal&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.ThreatIdValidValues-attributes>Attributes<a href=#trestle.oscal.common.ThreatIdValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___fedramp_gov</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov_ns_oscal class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___fedramp_gov_ns_oscal</span> <span class=o>=</span> <span class=s1>&#39;http://fedramp.gov/ns/oscal&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov_ns_oscal class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.TimeUnitValidValues class="doc doc-heading"> <code>TimeUnitValidValues</code> <a href=#trestle.oscal.common.TimeUnitValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TimeUnitValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>seconds</span> <span class=o>=</span> <span class=s1>&#39;seconds&#39;</span>
+    <span class=n>minutes</span> <span class=o>=</span> <span class=s1>&#39;minutes&#39;</span>
+    <span class=n>hours</span> <span class=o>=</span> <span class=s1>&#39;hours&#39;</span>
+    <span class=n>days</span> <span class=o>=</span> <span class=s1>&#39;days&#39;</span>
+    <span class=n>months</span> <span class=o>=</span> <span class=s1>&#39;months&#39;</span>
+    <span class=n>years</span> <span class=o>=</span> <span class=s1>&#39;years&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.TimeUnitValidValues-attributes>Attributes<a href=#trestle.oscal.common.TimeUnitValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TimeUnitValidValues.days class="doc doc-heading"> <code class="highlight language-python"><span class=n>days</span> <span class=o>=</span> <span class=s1>&#39;days&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TimeUnitValidValues.days class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TimeUnitValidValues.hours class="doc doc-heading"> <code class="highlight language-python"><span class=n>hours</span> <span class=o>=</span> <span class=s1>&#39;hours&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TimeUnitValidValues.hours class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TimeUnitValidValues.minutes class="doc doc-heading"> <code class="highlight language-python"><span class=n>minutes</span> <span class=o>=</span> <span class=s1>&#39;minutes&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TimeUnitValidValues.minutes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TimeUnitValidValues.months class="doc doc-heading"> <code class="highlight language-python"><span class=n>months</span> <span class=o>=</span> <span class=s1>&#39;months&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TimeUnitValidValues.months class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TimeUnitValidValues.seconds class="doc doc-heading"> <code class="highlight language-python"><span class=n>seconds</span> <span class=o>=</span> <span class=s1>&#39;seconds&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TimeUnitValidValues.seconds class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TimeUnitValidValues.years class="doc doc-heading"> <code class="highlight language-python"><span class=n>years</span> <span class=o>=</span> <span class=s1>&#39;years&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TimeUnitValidValues.years class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Timing class="doc doc-heading"> <code>Timing</code> <a href=#trestle.oscal.common.Timing class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The timing under which the task is intended to occur.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1156</span>
+<span class=normal>1157</span>
+<span class=normal>1158</span>
+<span class=normal>1159</span>
+<span class=normal>1160</span>
+<span class=normal>1161</span>
+<span class=normal>1162</span>
+<span class=normal>1163</span>
+<span class=normal>1164</span>
+<span class=normal>1165</span>
+<span class=normal>1166</span>
+<span class=normal>1167</span>
+<span class=normal>1168</span>
+<span class=normal>1169</span>
+<span class=normal>1170</span>
+<span class=normal>1171</span>
+<span class=normal>1172</span>
+<span class=normal>1173</span>
+<span class=normal>1174</span>
+<span class=normal>1175</span>
+<span class=normal>1176</span>
+<span class=normal>1177</span>
+<span class=normal>1178</span>
+<span class=normal>1179</span>
+<span class=normal>1180</span>
+<span class=normal>1181</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Timing</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The timing under which the task is intended to occur.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>on_date</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OnDate</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;on-date&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task is intended to occur on the specified date.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;On Date Condition&#39;</span>
+    <span class=p>)</span>
+    <span class=n>within_date_range</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>WithinDateRange</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;within-date-range&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task is intended to occur within the specified date range.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;On Date Range Condition&#39;</span>
+    <span class=p>)</span>
+    <span class=n>at_frequency</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AtFrequency</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;at-frequency&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task is intended to occur at the specified frequency.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Frequency Condition&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Timing-attributes>Attributes<a href=#trestle.oscal.common.Timing-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Timing.at_frequency class="doc doc-heading"> <code class="highlight language-python"><span class=n>at_frequency</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AtFrequency</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;at-frequency&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task is intended to occur at the specified frequency.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Frequency Condition&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Timing.at_frequency class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Timing.on_date class="doc doc-heading"> <code class="highlight language-python"><span class=n>on_date</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OnDate</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;on-date&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task is intended to occur on the specified date.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;On Date Condition&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Timing.on_date class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Timing.within_date_range class="doc doc-heading"> <code class="highlight language-python"><span class=n>within_date_range</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>WithinDateRange</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;within-date-range&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task is intended to occur within the specified date range.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;On Date Range Condition&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Timing.within_date_range class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.Timing-classes>Classes<a href=#trestle.oscal.common.Timing-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.Timing.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.Timing.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1161</span>
+<span class=normal>1162</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.Timing.Config-attributes>Attributes<a href=#trestle.oscal.common.Timing.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.Timing.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Timing.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.TokenDatatype class="doc doc-heading"> <code>TokenDatatype</code> <a href=#trestle.oscal.common.TokenDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TokenDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A non-colonized name as defined by XML Schema Part 2: Datatypes Second Edition. https://www.w3.org/TR/xmlschema11-2/#NCName.&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.TokenDatatype-attributes>Attributes<a href=#trestle.oscal.common.TokenDatatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.TokenDatatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A non-colonized name as defined by XML Schema Part 2: Datatypes Second Edition. https://www.w3.org/TR/xmlschema11-2/#NCName.&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.TokenDatatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.URIDatatype class="doc doc-heading"> <code>URIDatatype</code> <a href=#trestle.oscal.common.URIDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>68</span>
+<span class=normal>69</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>URIDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>AnyUrl</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A universal resource identifier (URI) formatted according to RFC3986.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.URIDatatype-attributes>Attributes<a href=#trestle.oscal.common.URIDatatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.URIDatatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>AnyUrl</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A universal resource identifier (URI) formatted according to RFC3986.&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.URIDatatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.URIReferenceDatatype class="doc doc-heading"> <code>URIReferenceDatatype</code> <a href=#trestle.oscal.common.URIReferenceDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>URIReferenceDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A URI Reference, either a URI or a relative-reference, formatted according to section 4.1 of RFC3986.&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.URIReferenceDatatype-attributes>Attributes<a href=#trestle.oscal.common.URIReferenceDatatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.URIReferenceDatatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A URI Reference, either a URI or a relative-reference, formatted according to section 4.1 of RFC3986.&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.URIReferenceDatatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.UUIDDatatype class="doc doc-heading"> <code>UUIDDatatype</code> <a href=#trestle.oscal.common.UUIDDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>UUIDDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A type 4 (&#39;random&#39; or &#39;pseudorandom&#39;) or type 5 UUID per RFC 4122.&quot;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.UUIDDatatype-attributes>Attributes<a href=#trestle.oscal.common.UUIDDatatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.UUIDDatatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A type 4 (&#39;random&#39; or &#39;pseudorandom&#39;) or type 5 UUID per RFC 4122.&quot;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.UUIDDatatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.UsesComponent class="doc doc-heading"> <code>UsesComponent</code> <a href=#trestle.oscal.common.UsesComponent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The set of components that are used by the assessment platform.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2272</span>
+<span class=normal>2273</span>
+<span class=normal>2274</span>
+<span class=normal>2275</span>
+<span class=normal>2276</span>
+<span class=normal>2277</span>
+<span class=normal>2278</span>
+<span class=normal>2279</span>
+<span class=normal>2280</span>
+<span class=normal>2281</span>
+<span class=normal>2282</span>
+<span class=normal>2283</span>
+<span class=normal>2284</span>
+<span class=normal>2285</span>
+<span class=normal>2286</span>
+<span class=normal>2287</span>
+<span class=normal>2288</span>
+<span class=normal>2289</span>
+<span class=normal>2290</span>
+<span class=normal>2291</span>
+<span class=normal>2292</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>UsesComponent</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The set of components that are used by the assessment platform.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented identifier reference to a component that is implemented as part of an inventory item.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.UsesComponent-attributes>Attributes<a href=#trestle.oscal.common.UsesComponent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.UsesComponent.component_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a component that is implemented as part of an inventory item.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.UsesComponent.component_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.UsesComponent.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.UsesComponent.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.UsesComponent.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.UsesComponent.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.UsesComponent.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.UsesComponent.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.UsesComponent.responsible_parties class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.UsesComponent.responsible_parties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.UsesComponent-classes>Classes<a href=#trestle.oscal.common.UsesComponent-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.UsesComponent.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.UsesComponent.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>2277</span>
+<span class=normal>2278</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.UsesComponent.Config-attributes>Attributes<a href=#trestle.oscal.common.UsesComponent.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.UsesComponent.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.UsesComponent.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.Version class="doc doc-heading"> <code>Version</code> <a href=#trestle.oscal.common.Version class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1147</span>
+<span class=normal>1148</span>
+<span class=normal>1149</span>
+<span class=normal>1150</span>
+<span class=normal>1151</span>
+<span class=normal>1152</span>
+<span class=normal>1153</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Version</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>StringDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Used to distinguish a specific revision of an OSCAL document from other previous and future versions.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Document Version&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.Version-attributes>Attributes<a href=#trestle.oscal.common.Version-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.Version.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>StringDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Used to distinguish a specific revision of an OSCAL document from other previous and future versions.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Document Version&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.Version.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.common.WithinDateRange class="doc doc-heading"> <code>WithinDateRange</code> <a href=#trestle.oscal.common.WithinDateRange class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The task is intended to occur within the specified date range.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>WithinDateRange</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The task is intended to occur within the specified date range.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>start</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task must occur on or after the specified date.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Start Date Condition&#39;</span>
+    <span class=p>)</span>
+    <span class=n>end</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task must occur on or before the specified date.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;End Date Condition&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.common.WithinDateRange-attributes>Attributes<a href=#trestle.oscal.common.WithinDateRange-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.WithinDateRange.end class="doc doc-heading"> <code class="highlight language-python"><span class=n>end</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task must occur on or before the specified date.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;End Date Condition&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.WithinDateRange.end class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.common.WithinDateRange.start class="doc doc-heading"> <code class="highlight language-python"><span class=n>start</span><span class=p>:</span> <span class=n>datetime</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The task must occur on or after the specified date.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Start Date Condition&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.WithinDateRange.start class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.common.WithinDateRange-classes>Classes<a href=#trestle.oscal.common.WithinDateRange-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.common.WithinDateRange.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.common.WithinDateRange.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/common.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>43</span>
+<span class=normal>44</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.common.WithinDateRange.Config-attributes>Attributes<a href=#trestle.oscal.common.WithinDateRange.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.common.WithinDateRange.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.common.WithinDateRange.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/oscal/component/index.html b/latest/reference/API/trestle/oscal/component/index.html
new file mode 100644
index 000000000..a141a5534
--- /dev/null
+++ b/latest/reference/API/trestle/oscal/component/index.html
@@ -0,0 +1,511 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.oscal.component module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/component/ rel=canonical><link href=../common/ rel=prev><link href=../poam/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.oscal.component - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.oscal.component - Compliance Trestle"><meta property=og:description content="Documentation for trestle.oscal.component module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/component.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/component/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.oscal.component - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.oscal.component module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/component.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.oscal.component class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.oscal.component </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4 checked> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.oscal.component </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.oscal.component </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> <nav class=md-nav aria-label=component> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability class=md-nav__link> <span class=md-ellipsis> Capability </span> </a> <nav class=md-nav aria-label=Capability> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.control_implementations class=md-nav__link> <span class=md-ellipsis> control_implementations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.incorporates_components class=md-nav__link> <span class=md-ellipsis> incorporates_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition class=md-nav__link> <span class=md-ellipsis> ComponentDefinition </span> </a> <nav class=md-nav aria-label=ComponentDefinition> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.capabilities class=md-nav__link> <span class=md-ellipsis> capabilities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.import_component_definitions class=md-nav__link> <span class=md-ellipsis> import_component_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation class=md-nav__link> <span class=md-ellipsis> ControlImplementation </span> </a> <nav class=md-nav aria-label=ControlImplementation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.implemented_requirements class=md-nav__link> <span class=md-ellipsis> implemented_requirements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.source class=md-nav__link> <span class=md-ellipsis> source </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent class=md-nav__link> <span class=md-ellipsis> DefinedComponent </span> </a> <nav class=md-nav aria-label=DefinedComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.control_implementations class=md-nav__link> <span class=md-ellipsis> control_implementations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.protocols class=md-nav__link> <span class=md-ellipsis> protocols </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.purpose class=md-nav__link> <span class=md-ellipsis> purpose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues class=md-nav__link> <span class=md-ellipsis> DefinedComponentTypeValidValues </span> </a> <nav class=md-nav aria-label=DefinedComponentTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.guidance class=md-nav__link> <span class=md-ellipsis> guidance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.hardware class=md-nav__link> <span class=md-ellipsis> hardware </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.interconnection class=md-nav__link> <span class=md-ellipsis> interconnection </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.physical class=md-nav__link> <span class=md-ellipsis> physical </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.plan class=md-nav__link> <span class=md-ellipsis> plan </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.policy class=md-nav__link> <span class=md-ellipsis> policy </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.process_procedure class=md-nav__link> <span class=md-ellipsis> process_procedure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.service class=md-nav__link> <span class=md-ellipsis> service </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.software class=md-nav__link> <span class=md-ellipsis> software </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.standard class=md-nav__link> <span class=md-ellipsis> standard </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.validation class=md-nav__link> <span class=md-ellipsis> validation </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement class=md-nav__link> <span class=md-ellipsis> ImplementedRequirement </span> </a> <nav class=md-nav aria-label=ImplementedRequirement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.statements class=md-nav__link> <span class=md-ellipsis> statements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition class=md-nav__link> <span class=md-ellipsis> ImportComponentDefinition </span> </a> <nav class=md-nav aria-label=ImportComponentDefinition> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent class=md-nav__link> <span class=md-ellipsis> IncorporatesComponent </span> </a> <nav class=md-nav aria-label=IncorporatesComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Model.component_definition class=md-nav__link> <span class=md-ellipsis> component_definition </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter class=md-nav__link> <span class=md-ellipsis> SetParameter </span> </a> <nav class=md-nav aria-label=SetParameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter.param_id class=md-nav__link> <span class=md-ellipsis> param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement class=md-nav__link> <span class=md-ellipsis> Statement </span> </a> <nav class=md-nav aria-label=Statement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.statement_id class=md-nav__link> <span class=md-ellipsis> statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> <nav class=md-nav aria-label=component> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability class=md-nav__link> <span class=md-ellipsis> Capability </span> </a> <nav class=md-nav aria-label=Capability> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.control_implementations class=md-nav__link> <span class=md-ellipsis> control_implementations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.incorporates_components class=md-nav__link> <span class=md-ellipsis> incorporates_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Capability.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition class=md-nav__link> <span class=md-ellipsis> ComponentDefinition </span> </a> <nav class=md-nav aria-label=ComponentDefinition> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.capabilities class=md-nav__link> <span class=md-ellipsis> capabilities </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.import_component_definitions class=md-nav__link> <span class=md-ellipsis> import_component_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ComponentDefinition.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation class=md-nav__link> <span class=md-ellipsis> ControlImplementation </span> </a> <nav class=md-nav aria-label=ControlImplementation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.implemented_requirements class=md-nav__link> <span class=md-ellipsis> implemented_requirements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.source class=md-nav__link> <span class=md-ellipsis> source </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ControlImplementation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent class=md-nav__link> <span class=md-ellipsis> DefinedComponent </span> </a> <nav class=md-nav aria-label=DefinedComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.control_implementations class=md-nav__link> <span class=md-ellipsis> control_implementations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.protocols class=md-nav__link> <span class=md-ellipsis> protocols </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.purpose class=md-nav__link> <span class=md-ellipsis> purpose </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.type class=md-nav__link> <span class=md-ellipsis> type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues class=md-nav__link> <span class=md-ellipsis> DefinedComponentTypeValidValues </span> </a> <nav class=md-nav aria-label=DefinedComponentTypeValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.guidance class=md-nav__link> <span class=md-ellipsis> guidance </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.hardware class=md-nav__link> <span class=md-ellipsis> hardware </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.interconnection class=md-nav__link> <span class=md-ellipsis> interconnection </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.physical class=md-nav__link> <span class=md-ellipsis> physical </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.plan class=md-nav__link> <span class=md-ellipsis> plan </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.policy class=md-nav__link> <span class=md-ellipsis> policy </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.process_procedure class=md-nav__link> <span class=md-ellipsis> process_procedure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.service class=md-nav__link> <span class=md-ellipsis> service </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.software class=md-nav__link> <span class=md-ellipsis> software </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.standard class=md-nav__link> <span class=md-ellipsis> standard </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.validation class=md-nav__link> <span class=md-ellipsis> validation </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement class=md-nav__link> <span class=md-ellipsis> ImplementedRequirement </span> </a> <nav class=md-nav aria-label=ImplementedRequirement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.statements class=md-nav__link> <span class=md-ellipsis> statements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImplementedRequirement.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition class=md-nav__link> <span class=md-ellipsis> ImportComponentDefinition </span> </a> <nav class=md-nav aria-label=ImportComponentDefinition> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.ImportComponentDefinition.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent class=md-nav__link> <span class=md-ellipsis> IncorporatesComponent </span> </a> <nav class=md-nav aria-label=IncorporatesComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.IncorporatesComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Model.component_definition class=md-nav__link> <span class=md-ellipsis> component_definition </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter class=md-nav__link> <span class=md-ellipsis> SetParameter </span> </a> <nav class=md-nav aria-label=SetParameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter.param_id class=md-nav__link> <span class=md-ellipsis> param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.SetParameter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement class=md-nav__link> <span class=md-ellipsis> Statement </span> </a> <nav class=md-nav aria-label=Statement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.statement_id class=md-nav__link> <span class=md-ellipsis> statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.component.Statement.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.oscal.component</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.oscal.component class="doc doc-heading"> <code>trestle.oscal.component</code> <a href=#trestle.oscal.component class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <div class="doc doc-children"> <h3 id=trestle.oscal.component-attributes>Attributes<a href=#trestle.oscal.component-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.oscal.component-classes>Classes<a href=#trestle.oscal.component-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.Capability class="doc doc-heading"> <code>Capability</code> <a href=#trestle.oscal.component.Capability class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A grouping of other components and/or capabilities.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Capability</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A grouping of other components and/or capabilities.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+                 <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+                     <span class=o>...</span><span class=p>,</span>
+                     <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given capability.&#39;</span><span class=p>,</span>
+                     <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Capability Identifier&#39;</span>
+                 <span class=p>)</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span>
+                 <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;The capability&#39;s human-readable name.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Capability Name&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the capability.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Capability Description&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>incorporates_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>IncorporatesComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;incorporates-components&#39;</span><span class=p>)</span>
+    <span class=n>control_implementations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ControlImplementation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-implementations&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.Capability-attributes>Attributes<a href=#trestle.oscal.component.Capability-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Capability.control_implementations class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_implementations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ControlImplementation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-implementations&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Capability.control_implementations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Capability.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the capability.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Capability Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Capability.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Capability.incorporates_components class="doc doc-heading"> <code class="highlight language-python"><span class=n>incorporates_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>IncorporatesComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;incorporates-components&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Capability.incorporates_components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Capability.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Capability.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Capability.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;The capability&#39;s human-readable name.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Capability Name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Capability.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Capability.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Capability.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Capability.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Capability.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Capability.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given capability.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Capability Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Capability.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.component.Capability-classes>Classes<a href=#trestle.oscal.component.Capability-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.component.Capability.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.component.Capability.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>229</span>
+<span class=normal>230</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.component.Capability.Config-attributes>Attributes<a href=#trestle.oscal.component.Capability.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.component.Capability.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Capability.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.ComponentDefinition class="doc doc-heading"> <code>ComponentDefinition</code> <a href=#trestle.oscal.component.ComponentDefinition class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A collection of component descriptions, which may optionally be grouped by capability.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ComponentDefinition</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A collection of component descriptions, which may optionally be grouped by capability.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+                 <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+                     <span class=o>...</span><span class=p>,</span>
+                     <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given component definition instance.&#39;</span><span class=p>,</span>
+                     <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Definition Universally Unique Identifier&#39;</span>
+                 <span class=p>)</span>
+    <span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span>
+    <span class=n>import_component_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ImportComponentDefinition</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-component-definitions&#39;</span>
+    <span class=p>)</span>
+    <span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>DefinedComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>capabilities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Capability</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.ComponentDefinition-attributes>Attributes<a href=#trestle.oscal.component.ComponentDefinition-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ComponentDefinition.back_matter class="doc doc-heading"> <code class="highlight language-python"><span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ComponentDefinition.back_matter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ComponentDefinition.capabilities class="doc doc-heading"> <code class="highlight language-python"><span class=n>capabilities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Capability</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ComponentDefinition.capabilities class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ComponentDefinition.components class="doc doc-heading"> <code class="highlight language-python"><span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>DefinedComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ComponentDefinition.components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ComponentDefinition.import_component_definitions class="doc doc-heading"> <code class="highlight language-python"><span class=n>import_component_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ImportComponentDefinition</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-component-definitions&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ComponentDefinition.import_component_definitions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ComponentDefinition.metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ComponentDefinition.metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ComponentDefinition.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given component definition instance.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Definition Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ComponentDefinition.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.component.ComponentDefinition-classes>Classes<a href=#trestle.oscal.component.ComponentDefinition-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.component.ComponentDefinition.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.component.ComponentDefinition.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>287</span>
+<span class=normal>288</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.component.ComponentDefinition.Config-attributes>Attributes<a href=#trestle.oscal.component.ComponentDefinition.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.component.ComponentDefinition.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ComponentDefinition.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.ControlImplementation class="doc doc-heading"> <code>ControlImplementation</code> <a href=#trestle.oscal.component.ControlImplementation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Defines how the component or capability supports a set of controls.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlImplementation</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Defines how the component or capability supports a set of controls.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Provides a means to identify a set of control implementations that are supported by a given component or capability.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Set Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>source</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A reference to an OSCAL catalog or profile providing the referenced control or subcontrol definition.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Source Resource Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A description of how the specified set of controls are implemented for the containing component or capability.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span>
+    <span class=n>implemented_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.ControlImplementation-attributes>Attributes<a href=#trestle.oscal.component.ControlImplementation-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ControlImplementation.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of how the specified set of controls are implemented for the containing component or capability.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ControlImplementation.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ControlImplementation.implemented_requirements class="doc doc-heading"> <code class="highlight language-python"><span class=n>implemented_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ControlImplementation.implemented_requirements class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ControlImplementation.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ControlImplementation.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ControlImplementation.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ControlImplementation.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ControlImplementation.set_parameters class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ControlImplementation.set_parameters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ControlImplementation.source class="doc doc-heading"> <code class="highlight language-python"><span class=n>source</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A reference to an OSCAL catalog or profile providing the referenced control or subcontrol definition.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Source Resource Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ControlImplementation.source class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ControlImplementation.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a means to identify a set of control implementations that are supported by a given component or capability.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Set Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ControlImplementation.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.component.ControlImplementation-classes>Classes<a href=#trestle.oscal.component.ControlImplementation-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.component.ControlImplementation.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.component.ControlImplementation.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>195</span>
+<span class=normal>196</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.component.ControlImplementation.Config-attributes>Attributes<a href=#trestle.oscal.component.ControlImplementation.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.component.ControlImplementation.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ControlImplementation.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.DefinedComponent class="doc doc-heading"> <code>DefinedComponent</code> <a href=#trestle.oscal.component.DefinedComponent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A defined component that can be part of an implemented system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DefinedComponent</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A defined component that can be part of an implemented system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+                 <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+                     <span class=o>...</span><span class=p>,</span>
+                     <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given component.&#39;</span><span class=p>,</span>
+                     <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Identifier&#39;</span>
+                 <span class=p>)</span>
+    <span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>),</span> <span class=n>DefinedComponentTypeValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A category describing the purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Type&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of the component, including information about its function.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>purpose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the technological or business purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Purpose&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>protocols</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Protocol</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>control_implementations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ControlImplementation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-implementations&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.DefinedComponent-attributes>Attributes<a href=#trestle.oscal.component.DefinedComponent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.control_implementations class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_implementations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ControlImplementation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-implementations&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.control_implementations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of the component, including information about its function.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.protocols class="doc doc-heading"> <code class="highlight language-python"><span class=n>protocols</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Protocol</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.protocols class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.purpose class="doc doc-heading"> <code class="highlight language-python"><span class=n>purpose</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the technological or business purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Purpose&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.purpose class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.type class="doc doc-heading"> <code class="highlight language-python"><span class=nb>type</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>),</span> <span class=n>DefinedComponentTypeValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A category describing the purpose of the component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Type&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponent.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.component.DefinedComponent-classes>Classes<a href=#trestle.oscal.component.DefinedComponent-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.component.DefinedComponent.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.component.DefinedComponent.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>253</span>
+<span class=normal>254</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.component.DefinedComponent.Config-attributes>Attributes<a href=#trestle.oscal.component.DefinedComponent.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.component.DefinedComponent.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponent.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.DefinedComponentTypeValidValues class="doc doc-heading"> <code>DefinedComponentTypeValidValues</code> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DefinedComponentTypeValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>interconnection</span> <span class=o>=</span> <span class=s1>&#39;interconnection&#39;</span>
+    <span class=n>software</span> <span class=o>=</span> <span class=s1>&#39;software&#39;</span>
+    <span class=n>hardware</span> <span class=o>=</span> <span class=s1>&#39;hardware&#39;</span>
+    <span class=n>service</span> <span class=o>=</span> <span class=s1>&#39;service&#39;</span>
+    <span class=n>policy</span> <span class=o>=</span> <span class=s1>&#39;policy&#39;</span>
+    <span class=n>physical</span> <span class=o>=</span> <span class=s1>&#39;physical&#39;</span>
+    <span class=n>process_procedure</span> <span class=o>=</span> <span class=s1>&#39;process-procedure&#39;</span>
+    <span class=n>plan</span> <span class=o>=</span> <span class=s1>&#39;plan&#39;</span>
+    <span class=n>guidance</span> <span class=o>=</span> <span class=s1>&#39;guidance&#39;</span>
+    <span class=n>standard</span> <span class=o>=</span> <span class=s1>&#39;standard&#39;</span>
+    <span class=n>validation</span> <span class=o>=</span> <span class=s1>&#39;validation&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.DefinedComponentTypeValidValues-attributes>Attributes<a href=#trestle.oscal.component.DefinedComponentTypeValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.guidance class="doc doc-heading"> <code class="highlight language-python"><span class=n>guidance</span> <span class=o>=</span> <span class=s1>&#39;guidance&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.guidance class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.hardware class="doc doc-heading"> <code class="highlight language-python"><span class=n>hardware</span> <span class=o>=</span> <span class=s1>&#39;hardware&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.hardware class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.interconnection class="doc doc-heading"> <code class="highlight language-python"><span class=n>interconnection</span> <span class=o>=</span> <span class=s1>&#39;interconnection&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.interconnection class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.physical class="doc doc-heading"> <code class="highlight language-python"><span class=n>physical</span> <span class=o>=</span> <span class=s1>&#39;physical&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.physical class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.plan class="doc doc-heading"> <code class="highlight language-python"><span class=n>plan</span> <span class=o>=</span> <span class=s1>&#39;plan&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.plan class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.policy class="doc doc-heading"> <code class="highlight language-python"><span class=n>policy</span> <span class=o>=</span> <span class=s1>&#39;policy&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.policy class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.process_procedure class="doc doc-heading"> <code class="highlight language-python"><span class=n>process_procedure</span> <span class=o>=</span> <span class=s1>&#39;process-procedure&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.process_procedure class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.service class="doc doc-heading"> <code class="highlight language-python"><span class=n>service</span> <span class=o>=</span> <span class=s1>&#39;service&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.service class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.software class="doc doc-heading"> <code class="highlight language-python"><span class=n>software</span> <span class=o>=</span> <span class=s1>&#39;software&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.software class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.standard class="doc doc-heading"> <code class="highlight language-python"><span class=n>standard</span> <span class=o>=</span> <span class=s1>&#39;standard&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.standard class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.DefinedComponentTypeValidValues.validation class="doc doc-heading"> <code class="highlight language-python"><span class=n>validation</span> <span class=o>=</span> <span class=s1>&#39;validation&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.DefinedComponentTypeValidValues.validation class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.ImplementedRequirement class="doc doc-heading"> <code>ImplementedRequirement</code> <a href=#trestle.oscal.component.ImplementedRequirement class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes how the containing component or capability implements an individual control.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ImplementedRequirement</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes how the containing component or capability implements an individual control.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given control implementation by a component.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A suggestion from the supplier (e.g., component vendor or author) for how the specified control may be implemented if the containing component or capability is instantiated in a system security plan.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>statements</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Statement</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.ImplementedRequirement-attributes>Attributes<a href=#trestle.oscal.component.ImplementedRequirement-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImplementedRequirement.control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.control_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImplementedRequirement.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A suggestion from the supplier (e.g., component vendor or author) for how the specified control may be implemented if the containing component or capability is instantiated in a system security plan.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImplementedRequirement.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImplementedRequirement.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImplementedRequirement.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImplementedRequirement.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImplementedRequirement.set_parameters class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.set_parameters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImplementedRequirement.statements class="doc doc-heading"> <code class="highlight language-python"><span class=n>statements</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Statement</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.statements class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImplementedRequirement.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given control implementation by a component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.component.ImplementedRequirement-classes>Classes<a href=#trestle.oscal.component.ImplementedRequirement-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.component.ImplementedRequirement.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.component.ImplementedRequirement.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>142</span>
+<span class=normal>143</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.component.ImplementedRequirement.Config-attributes>Attributes<a href=#trestle.oscal.component.ImplementedRequirement.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.component.ImplementedRequirement.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImplementedRequirement.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.ImportComponentDefinition class="doc doc-heading"> <code>ImportComponentDefinition</code> <a href=#trestle.oscal.component.ImportComponentDefinition class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Loads a component definition from another resource.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ImportComponentDefinition</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Loads a component definition from another resource.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A link to a resource that defines a set of components and/or capabilities to import into this collection.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Hyperlink Reference&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.ImportComponentDefinition-attributes>Attributes<a href=#trestle.oscal.component.ImportComponentDefinition-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.ImportComponentDefinition.href class="doc doc-heading"> <code class="highlight language-python"><span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A link to a resource that defines a set of components and/or capabilities to import into this collection.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Hyperlink Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImportComponentDefinition.href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.component.ImportComponentDefinition-classes>Classes<a href=#trestle.oscal.component.ImportComponentDefinition-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.component.ImportComponentDefinition.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.component.ImportComponentDefinition.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>126</span>
+<span class=normal>127</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.component.ImportComponentDefinition.Config-attributes>Attributes<a href=#trestle.oscal.component.ImportComponentDefinition.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.component.ImportComponentDefinition.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.ImportComponentDefinition.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.IncorporatesComponent class="doc doc-heading"> <code>IncorporatesComponent</code> <a href=#trestle.oscal.component.IncorporatesComponent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The collection of components comprising this capability.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>IncorporatesComponent</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The collection of components comprising this capability.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a component.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of the component, including information about its function.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Description&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.IncorporatesComponent-attributes>Attributes<a href=#trestle.oscal.component.IncorporatesComponent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.IncorporatesComponent.component_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.IncorporatesComponent.component_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.IncorporatesComponent.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A description of the component, including information about its function.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.IncorporatesComponent.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.component.IncorporatesComponent-classes>Classes<a href=#trestle.oscal.component.IncorporatesComponent-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.component.IncorporatesComponent.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.component.IncorporatesComponent.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>103</span>
+<span class=normal>104</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.component.IncorporatesComponent.Config-attributes>Attributes<a href=#trestle.oscal.component.IncorporatesComponent.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.component.IncorporatesComponent.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.IncorporatesComponent.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.Model class="doc doc-heading"> <code>Model</code> <a href=#trestle.oscal.component.Model class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>305</span>
+<span class=normal>306</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Model</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>component_definition</span><span class=p>:</span> <span class=n>ComponentDefinition</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-definition&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.Model-attributes>Attributes<a href=#trestle.oscal.component.Model-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Model.component_definition class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_definition</span><span class=p>:</span> <span class=n>ComponentDefinition</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-definition&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Model.component_definition class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.SetParameter class="doc doc-heading"> <code>SetParameter</code> <a href=#trestle.oscal.component.SetParameter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies the parameter that will be set by the enclosed value.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SetParameter</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the parameter that will be set by the enclosed value.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>param_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;param-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A human-oriented reference to a parameter within a control, who&#39;s catalog has been imported into the current implementation context.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter ID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>values</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.SetParameter-attributes>Attributes<a href=#trestle.oscal.component.SetParameter-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.SetParameter.param_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>param_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;param-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A human-oriented reference to a parameter within a control, who&#39;s catalog has been imported into the current implementation context.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.SetParameter.param_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.SetParameter.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.SetParameter.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.SetParameter.values class="doc doc-heading"> <code class="highlight language-python"><span class=n>values</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.SetParameter.values class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.component.SetParameter-classes>Classes<a href=#trestle.oscal.component.SetParameter-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.component.SetParameter.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.component.SetParameter.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>81</span>
+<span class=normal>82</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.component.SetParameter.Config-attributes>Attributes<a href=#trestle.oscal.component.SetParameter.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.component.SetParameter.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.SetParameter.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.component.Statement class="doc doc-heading"> <code>Statement</code> <a href=#trestle.oscal.component.Statement class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies which statements within a control are addressed.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Statement</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies which statements within a control are addressed.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>statement_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;statement-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-oriented identifier reference to a control statement.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference Universally Unique Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of how the containing control statement is implemented by the component or capability.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Statement Implementation Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.component.Statement-attributes>Attributes<a href=#trestle.oscal.component.Statement-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Statement.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of how the containing control statement is implemented by the component or capability.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Statement Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Statement.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Statement.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Statement.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Statement.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Statement.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Statement.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Statement.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Statement.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Statement.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Statement.statement_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>statement_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;statement-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-oriented identifier reference to a control statement.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Statement.statement_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.component.Statement.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Statement.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.component.Statement-classes>Classes<a href=#trestle.oscal.component.Statement-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.component.Statement.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.component.Statement.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/component.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.component.Statement.Config-attributes>Attributes<a href=#trestle.oscal.component.Statement.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.component.Statement.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.component.Statement.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/oscal/poam/index.html b/latest/reference/API/trestle/oscal/poam/index.html
new file mode 100644
index 000000000..4ca46e2a3
--- /dev/null
+++ b/latest/reference/API/trestle/oscal/poam/index.html
@@ -0,0 +1,192 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.oscal.poam module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/poam/ rel=canonical><link href=../component/ rel=prev><link href=../profile/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.oscal.poam - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.oscal.poam - Compliance Trestle"><meta property=og:description content="Documentation for trestle.oscal.poam module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/poam.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/poam/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.oscal.poam - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.oscal.poam module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/poam.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.oscal.poam class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.oscal.poam </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4 checked> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.oscal.poam </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.oscal.poam </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.poam class=md-nav__link> <span class=md-ellipsis> poam </span> </a> <nav class=md-nav aria-label=poam> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions class=md-nav__link> <span class=md-ellipsis> LocalDefinitions </span> </a> <nav class=md-nav aria-label=LocalDefinitions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.assessment_assets class=md-nav__link> <span class=md-ellipsis> assessment_assets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.inventory_items class=md-nav__link> <span class=md-ellipsis> inventory_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Model.plan_of_action_and_milestones class=md-nav__link> <span class=md-ellipsis> plan_of_action_and_milestones </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination class=md-nav__link> <span class=md-ellipsis> Origination </span> </a> <nav class=md-nav aria-label=Origination> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination.actors class=md-nav__link> <span class=md-ellipsis> actors </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones class=md-nav__link> <span class=md-ellipsis> PlanOfActionAndMilestones </span> </a> <nav class=md-nav aria-label=PlanOfActionAndMilestones> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.findings class=md-nav__link> <span class=md-ellipsis> findings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.import_ssp class=md-nav__link> <span class=md-ellipsis> import_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.local_definitions class=md-nav__link> <span class=md-ellipsis> local_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.observations class=md-nav__link> <span class=md-ellipsis> observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.poam_items class=md-nav__link> <span class=md-ellipsis> poam_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.risks class=md-nav__link> <span class=md-ellipsis> risks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.system_id class=md-nav__link> <span class=md-ellipsis> system_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem class=md-nav__link> <span class=md-ellipsis> PoamItem </span> </a> <nav class=md-nav aria-label=PoamItem> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.related_findings class=md-nav__link> <span class=md-ellipsis> related_findings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.related_observations class=md-nav__link> <span class=md-ellipsis> related_observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.related_risks class=md-nav__link> <span class=md-ellipsis> related_risks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding class=md-nav__link> <span class=md-ellipsis> RelatedFinding </span> </a> <nav class=md-nav aria-label=RelatedFinding> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding.finding_uuid class=md-nav__link> <span class=md-ellipsis> finding_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.poam class=md-nav__link> <span class=md-ellipsis> poam </span> </a> <nav class=md-nav aria-label=poam> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions class=md-nav__link> <span class=md-ellipsis> LocalDefinitions </span> </a> <nav class=md-nav aria-label=LocalDefinitions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.assessment_assets class=md-nav__link> <span class=md-ellipsis> assessment_assets </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.inventory_items class=md-nav__link> <span class=md-ellipsis> inventory_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.LocalDefinitions.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Model.plan_of_action_and_milestones class=md-nav__link> <span class=md-ellipsis> plan_of_action_and_milestones </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination class=md-nav__link> <span class=md-ellipsis> Origination </span> </a> <nav class=md-nav aria-label=Origination> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination.actors class=md-nav__link> <span class=md-ellipsis> actors </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.Origination.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones class=md-nav__link> <span class=md-ellipsis> PlanOfActionAndMilestones </span> </a> <nav class=md-nav aria-label=PlanOfActionAndMilestones> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.findings class=md-nav__link> <span class=md-ellipsis> findings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.import_ssp class=md-nav__link> <span class=md-ellipsis> import_ssp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.local_definitions class=md-nav__link> <span class=md-ellipsis> local_definitions </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.observations class=md-nav__link> <span class=md-ellipsis> observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.poam_items class=md-nav__link> <span class=md-ellipsis> poam_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.risks class=md-nav__link> <span class=md-ellipsis> risks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.system_id class=md-nav__link> <span class=md-ellipsis> system_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem class=md-nav__link> <span class=md-ellipsis> PoamItem </span> </a> <nav class=md-nav aria-label=PoamItem> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.origins class=md-nav__link> <span class=md-ellipsis> origins </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.related_findings class=md-nav__link> <span class=md-ellipsis> related_findings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.related_observations class=md-nav__link> <span class=md-ellipsis> related_observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.related_risks class=md-nav__link> <span class=md-ellipsis> related_risks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.PoamItem.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding class=md-nav__link> <span class=md-ellipsis> RelatedFinding </span> </a> <nav class=md-nav aria-label=RelatedFinding> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding.finding_uuid class=md-nav__link> <span class=md-ellipsis> finding_uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.poam.RelatedFinding.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.oscal.poam</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.oscal.poam class="doc doc-heading"> <code>trestle.oscal.poam</code> <a href=#trestle.oscal.poam class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <div class="doc doc-children"> <h3 id=trestle.oscal.poam-attributes>Attributes<a href=#trestle.oscal.poam-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.oscal.poam-classes>Classes<a href=#trestle.oscal.poam-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.poam.LocalDefinitions class="doc doc-heading"> <code>LocalDefinitions</code> <a href=#trestle.oscal.poam.LocalDefinitions class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Allows components, and inventory-items to be defined within the POA&amp;M for circumstances where no OSCAL-based SSP exists, or is not delivered with the POA&amp;M.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LocalDefinitions</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Allows components, and inventory-items to be defined within the POA&amp;M for circumstances where no OSCAL-based SSP exists, or is not delivered with the POA&amp;M.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>inventory_items</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>InventoryItem</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;inventory-items&#39;</span><span class=p>)</span>
+    <span class=n>assessment_assets</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentAssets</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-assets&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.poam.LocalDefinitions-attributes>Attributes<a href=#trestle.oscal.poam.LocalDefinitions-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.LocalDefinitions.assessment_assets class="doc doc-heading"> <code class="highlight language-python"><span class=n>assessment_assets</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>AssessmentAssets</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;assessment-assets&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.LocalDefinitions.assessment_assets class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.LocalDefinitions.components class="doc doc-heading"> <code class="highlight language-python"><span class=n>components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.LocalDefinitions.components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.LocalDefinitions.inventory_items class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory_items</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>InventoryItem</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;inventory-items&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.LocalDefinitions.inventory_items class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.LocalDefinitions.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.LocalDefinitions.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.poam.LocalDefinitions-classes>Classes<a href=#trestle.oscal.poam.LocalDefinitions-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.poam.LocalDefinitions.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.poam.LocalDefinitions.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>48</span>
+<span class=normal>49</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.poam.LocalDefinitions.Config-attributes>Attributes<a href=#trestle.oscal.poam.LocalDefinitions.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.poam.LocalDefinitions.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.LocalDefinitions.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.poam.Model class="doc doc-heading"> <code>Model</code> <a href=#trestle.oscal.poam.Model class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>142</span>
+<span class=normal>143</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Model</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>plan_of_action_and_milestones</span><span class=p>:</span> <span class=n>PlanOfActionAndMilestones</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;plan-of-action-and-milestones&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.poam.Model-attributes>Attributes<a href=#trestle.oscal.poam.Model-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.Model.plan_of_action_and_milestones class="doc doc-heading"> <code class="highlight language-python"><span class=n>plan_of_action_and_milestones</span><span class=p>:</span> <span class=n>PlanOfActionAndMilestones</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;plan-of-action-and-milestones&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.Model.plan_of_action_and_milestones class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.poam.Origination class="doc doc-heading"> <code>Origination</code> <a href=#trestle.oscal.poam.Origination class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies the source of the finding, such as a tool or person.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Origination</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the source of the finding, such as a tool or person.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>actors</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>OriginActor</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.poam.Origination-attributes>Attributes<a href=#trestle.oscal.poam.Origination-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.Origination.actors class="doc doc-heading"> <code class="highlight language-python"><span class=n>actors</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>OriginActor</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.Origination.actors class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.poam.Origination-classes>Classes<a href=#trestle.oscal.poam.Origination-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.poam.Origination.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.poam.Origination.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>62</span>
+<span class=normal>63</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.poam.Origination.Config-attributes>Attributes<a href=#trestle.oscal.poam.Origination.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.poam.Origination.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.Origination.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.poam.PlanOfActionAndMilestones class="doc doc-heading"> <code>PlanOfActionAndMilestones</code> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A plan of action and milestones which identifies initial and residual risks, deviations, and disposition, such as those required by FedRAMP.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PlanOfActionAndMilestones</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A plan of action and milestones which identifies initial and residual risks, deviations, and disposition, such as those required by FedRAMP.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with instancescope that can be used to reference this POA&amp;M instance in this OSCAL instance. This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;POA&amp;M Universally Unique Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span>
+    <span class=n>import_ssp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ImportSsp</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-ssp&#39;</span><span class=p>)</span>
+    <span class=n>system_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemId</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-id&#39;</span><span class=p>)</span>
+    <span class=n>local_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>LocalDefinitions</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;local-definitions&#39;</span><span class=p>)</span>
+    <span class=n>observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Observation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>risks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Risk</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>findings</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Finding</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>poam_items</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>PoamItem</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;poam-items&#39;</span><span class=p>)</span>
+    <span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.poam.PlanOfActionAndMilestones-attributes>Attributes<a href=#trestle.oscal.poam.PlanOfActionAndMilestones-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.back_matter class="doc doc-heading"> <code class="highlight language-python"><span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.back_matter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.findings class="doc doc-heading"> <code class="highlight language-python"><span class=n>findings</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Finding</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.findings class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.import_ssp class="doc doc-heading"> <code class="highlight language-python"><span class=n>import_ssp</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ImportSsp</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-ssp&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.import_ssp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.local_definitions class="doc doc-heading"> <code class="highlight language-python"><span class=n>local_definitions</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>LocalDefinitions</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;local-definitions&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.local_definitions class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.observations class="doc doc-heading"> <code class="highlight language-python"><span class=n>observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Observation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.observations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.poam_items class="doc doc-heading"> <code class="highlight language-python"><span class=n>poam_items</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>PoamItem</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;poam-items&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.poam_items class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.risks class="doc doc-heading"> <code class="highlight language-python"><span class=n>risks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Risk</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.risks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.system_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>system_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemId</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-id&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.system_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with instancescope that can be used to reference this POA&amp;M instance in this OSCAL instance. This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;POA&amp;M Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.poam.PlanOfActionAndMilestones-classes>Classes<a href=#trestle.oscal.poam.PlanOfActionAndMilestones-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.poam.PlanOfActionAndMilestones.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>120</span>
+<span class=normal>121</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.poam.PlanOfActionAndMilestones.Config-attributes>Attributes<a href=#trestle.oscal.poam.PlanOfActionAndMilestones.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.poam.PlanOfActionAndMilestones.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PlanOfActionAndMilestones.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.poam.PoamItem class="doc doc-heading"> <code>PoamItem</code> <a href=#trestle.oscal.poam.PoamItem class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes an individual POA&amp;M item.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PoamItem</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes an individual POA&amp;M item.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with instance scope that can be used to reference this POA&amp;M item entry in this OSCAL instance. This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;POA&amp;M Item Universally Unique Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title or name for this POA&amp;M item .&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;POA&amp;M Item Title&#39;</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of POA&amp;M item.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;POA&amp;M Item Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>related_findings</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedFinding</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-findings&#39;</span><span class=p>)</span>
+    <span class=n>related_observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>RelatedObservation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-observations&#39;</span><span class=p>)</span>
+    <span class=n>related_risks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>RelatedRisk</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-risks&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origination</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.poam.PoamItem-attributes>Attributes<a href=#trestle.oscal.poam.PoamItem-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-readable description of POA&amp;M item.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;POA&amp;M Item Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.origins class="doc doc-heading"> <code class="highlight language-python"><span class=n>origins</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Origination</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.origins class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.related_findings class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_findings</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>RelatedFinding</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-findings&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.related_findings class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.related_observations class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_observations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>RelatedObservation</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-observations&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.related_observations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.related_risks class="doc doc-heading"> <code class="highlight language-python"><span class=n>related_risks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>RelatedRisk</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;related-risks&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.related_risks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The title or name for this POA&amp;M item .&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;POA&amp;M Item Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.PoamItem.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with instance scope that can be used to reference this POA&amp;M item entry in this OSCAL instance. This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;POA&amp;M Item Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.poam.PoamItem-classes>Classes<a href=#trestle.oscal.poam.PoamItem-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.poam.PoamItem.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.poam.PoamItem.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>91</span>
+<span class=normal>92</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.poam.PoamItem.Config-attributes>Attributes<a href=#trestle.oscal.poam.PoamItem.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.poam.PoamItem.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.PoamItem.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.poam.RelatedFinding class="doc doc-heading"> <code>RelatedFinding</code> <a href=#trestle.oscal.poam.RelatedFinding class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Relates the finding to referenced finding(s).</p> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RelatedFinding</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Relates the finding to referenced finding(s).</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>finding_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;finding-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a finding defined in the list of findings.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.poam.RelatedFinding-attributes>Attributes<a href=#trestle.oscal.poam.RelatedFinding-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.poam.RelatedFinding.finding_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>finding_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;finding-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a finding defined in the list of findings.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Finding Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.RelatedFinding.finding_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.poam.RelatedFinding-classes>Classes<a href=#trestle.oscal.poam.RelatedFinding-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.poam.RelatedFinding.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.poam.RelatedFinding.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/poam.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>73</span>
+<span class=normal>74</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.poam.RelatedFinding.Config-attributes>Attributes<a href=#trestle.oscal.poam.RelatedFinding.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.poam.RelatedFinding.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.poam.RelatedFinding.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/oscal/profile/index.html b/latest/reference/API/trestle/oscal/profile/index.html
new file mode 100644
index 000000000..f7575d98f
--- /dev/null
+++ b/latest/reference/API/trestle/oscal/profile/index.html
@@ -0,0 +1,703 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.oscal.profile module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/profile/ rel=canonical><link href=../poam/ rel=prev><link href=../ssp/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.oscal.profile - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.oscal.profile - Compliance Trestle"><meta property=og:description content="Documentation for trestle.oscal.profile module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/profile.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/profile/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.oscal.profile - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.oscal.profile module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/profile.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.oscal.profile class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.oscal.profile </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4 checked> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.oscal.profile </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.oscal.profile </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.profile class=md-nav__link> <span class=md-ellipsis> profile </span> </a> <nav class=md-nav aria-label=profile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add class=md-nav__link> <span class=md-ellipsis> Add </span> </a> <nav class=md-nav aria-label=Add> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.by_id class=md-nav__link> <span class=md-ellipsis> by_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.position class=md-nav__link> <span class=md-ellipsis> position </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter class=md-nav__link> <span class=md-ellipsis> Alter </span> </a> <nav class=md-nav aria-label=Alter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter.adds class=md-nav__link> <span class=md-ellipsis> adds </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter.removes class=md-nav__link> <span class=md-ellipsis> removes </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.BooleanDatatype class=md-nav__link> <span class=md-ellipsis> BooleanDatatype </span> </a> <nav class=md-nav aria-label=BooleanDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.BooleanDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.BooleanDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues class=md-nav__link> <span class=md-ellipsis> CombinationMethodValidValues </span> </a> <nav class=md-nav aria-label=CombinationMethodValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues.keep class=md-nav__link> <span class=md-ellipsis> keep </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues.use_first class=md-nav__link> <span class=md-ellipsis> use_first </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine class=md-nav__link> <span class=md-ellipsis> Combine </span> </a> <nav class=md-nav aria-label=Combine> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine.method class=md-nav__link> <span class=md-ellipsis> method </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom class=md-nav__link> <span class=md-ellipsis> Custom </span> </a> <nav class=md-nav aria-label=Custom> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom.groups class=md-nav__link> <span class=md-ellipsis> groups </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom.insert_controls class=md-nav__link> <span class=md-ellipsis> insert_controls </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group class=md-nav__link> <span class=md-ellipsis> Group </span> </a> <nav class=md-nav aria-label=Group> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.groups class=md-nav__link> <span class=md-ellipsis> groups </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.insert_controls class=md-nav__link> <span class=md-ellipsis> insert_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import class=md-nav__link> <span class=md-ellipsis> Import </span> </a> <nav class=md-nav aria-label=Import> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.exclude_controls class=md-nav__link> <span class=md-ellipsis> exclude_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.include_controls class=md-nav__link> <span class=md-ellipsis> include_controls </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls class=md-nav__link> <span class=md-ellipsis> InsertControls </span> </a> <nav class=md-nav aria-label=InsertControls> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.exclude_controls class=md-nav__link> <span class=md-ellipsis> exclude_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.include_controls class=md-nav__link> <span class=md-ellipsis> include_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.order class=md-nav__link> <span class=md-ellipsis> order </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues class=md-nav__link> <span class=md-ellipsis> ItemNameValidValues </span> </a> <nav class=md-nav aria-label=ItemNameValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.link class=md-nav__link> <span class=md-ellipsis> link </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.map class=md-nav__link> <span class=md-ellipsis> map </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.mapping class=md-nav__link> <span class=md-ellipsis> mapping </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.param class=md-nav__link> <span class=md-ellipsis> param </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.part class=md-nav__link> <span class=md-ellipsis> part </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.prop class=md-nav__link> <span class=md-ellipsis> prop </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching class=md-nav__link> <span class=md-ellipsis> Matching </span> </a> <nav class=md-nav aria-label=Matching> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching.pattern class=md-nav__link> <span class=md-ellipsis> pattern </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge class=md-nav__link> <span class=md-ellipsis> Merge </span> </a> <nav class=md-nav aria-label=Merge> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.as_is class=md-nav__link> <span class=md-ellipsis> as_is </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.combine class=md-nav__link> <span class=md-ellipsis> combine </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.custom class=md-nav__link> <span class=md-ellipsis> custom </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.flat class=md-nav__link> <span class=md-ellipsis> flat </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Model.profile class=md-nav__link> <span class=md-ellipsis> profile </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify class=md-nav__link> <span class=md-ellipsis> Modify </span> </a> <nav class=md-nav aria-label=Modify> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify.alters class=md-nav__link> <span class=md-ellipsis> alters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues class=md-nav__link> <span class=md-ellipsis> OrderValidValues </span> </a> <nav class=md-nav aria-label=OrderValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues.ascending class=md-nav__link> <span class=md-ellipsis> ascending </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues.descending class=md-nav__link> <span class=md-ellipsis> descending </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues.keep class=md-nav__link> <span class=md-ellipsis> keep </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues class=md-nav__link> <span class=md-ellipsis> PositionValidValues </span> </a> <nav class=md-nav aria-label=PositionValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues.after class=md-nav__link> <span class=md-ellipsis> after </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues.before class=md-nav__link> <span class=md-ellipsis> before </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues.ending class=md-nav__link> <span class=md-ellipsis> ending </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues.starting class=md-nav__link> <span class=md-ellipsis> starting </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile class=md-nav__link> <span class=md-ellipsis> Profile </span> </a> <nav class=md-nav aria-label=Profile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.imports class=md-nav__link> <span class=md-ellipsis> imports </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.modify class=md-nav__link> <span class=md-ellipsis> modify </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove class=md-nav__link> <span class=md-ellipsis> Remove </span> </a> <nav class=md-nav aria-label=Remove> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_class class=md-nav__link> <span class=md-ellipsis> by_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_id class=md-nav__link> <span class=md-ellipsis> by_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_item_name class=md-nav__link> <span class=md-ellipsis> by_item_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_name class=md-nav__link> <span class=md-ellipsis> by_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_ns class=md-nav__link> <span class=md-ellipsis> by_ns </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl class=md-nav__link> <span class=md-ellipsis> SelectControl </span> </a> <nav class=md-nav aria-label=SelectControl> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl.matching class=md-nav__link> <span class=md-ellipsis> matching </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl.with_child_controls class=md-nav__link> <span class=md-ellipsis> with_child_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl.with_ids class=md-nav__link> <span class=md-ellipsis> with_ids </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter class=md-nav__link> <span class=md-ellipsis> SetParameter </span> </a> <nav class=md-nav aria-label=SetParameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.constraints class=md-nav__link> <span class=md-ellipsis> constraints </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.depends_on class=md-nav__link> <span class=md-ellipsis> depends_on </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.guidelines class=md-nav__link> <span class=md-ellipsis> guidelines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.label class=md-nav__link> <span class=md-ellipsis> label </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.param_id class=md-nav__link> <span class=md-ellipsis> param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.select class=md-nav__link> <span class=md-ellipsis> select </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.usage class=md-nav__link> <span class=md-ellipsis> usage </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithChildControlsValidValues class=md-nav__link> <span class=md-ellipsis> WithChildControlsValidValues </span> </a> <nav class=md-nav aria-label=WithChildControlsValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithChildControlsValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithChildControlsValidValues.no class=md-nav__link> <span class=md-ellipsis> no </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithChildControlsValidValues.yes class=md-nav__link> <span class=md-ellipsis> yes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithId class=md-nav__link> <span class=md-ellipsis> WithId </span> </a> <nav class=md-nav aria-label=WithId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithId.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.profile class=md-nav__link> <span class=md-ellipsis> profile </span> </a> <nav class=md-nav aria-label=profile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add class=md-nav__link> <span class=md-ellipsis> Add </span> </a> <nav class=md-nav aria-label=Add> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.by_id class=md-nav__link> <span class=md-ellipsis> by_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.position class=md-nav__link> <span class=md-ellipsis> position </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Add.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter class=md-nav__link> <span class=md-ellipsis> Alter </span> </a> <nav class=md-nav aria-label=Alter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter.adds class=md-nav__link> <span class=md-ellipsis> adds </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter.removes class=md-nav__link> <span class=md-ellipsis> removes </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Alter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.BooleanDatatype class=md-nav__link> <span class=md-ellipsis> BooleanDatatype </span> </a> <nav class=md-nav aria-label=BooleanDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.BooleanDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.BooleanDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues class=md-nav__link> <span class=md-ellipsis> CombinationMethodValidValues </span> </a> <nav class=md-nav aria-label=CombinationMethodValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues.keep class=md-nav__link> <span class=md-ellipsis> keep </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.CombinationMethodValidValues.use_first class=md-nav__link> <span class=md-ellipsis> use_first </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine class=md-nav__link> <span class=md-ellipsis> Combine </span> </a> <nav class=md-nav aria-label=Combine> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine.method class=md-nav__link> <span class=md-ellipsis> method </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Combine.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom class=md-nav__link> <span class=md-ellipsis> Custom </span> </a> <nav class=md-nav aria-label=Custom> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom.groups class=md-nav__link> <span class=md-ellipsis> groups </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom.insert_controls class=md-nav__link> <span class=md-ellipsis> insert_controls </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Custom.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group class=md-nav__link> <span class=md-ellipsis> Group </span> </a> <nav class=md-nav aria-label=Group> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.groups class=md-nav__link> <span class=md-ellipsis> groups </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.id class=md-nav__link> <span class=md-ellipsis> id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.insert_controls class=md-nav__link> <span class=md-ellipsis> insert_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.params class=md-nav__link> <span class=md-ellipsis> params </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.parts class=md-nav__link> <span class=md-ellipsis> parts </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Group.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import class=md-nav__link> <span class=md-ellipsis> Import </span> </a> <nav class=md-nav aria-label=Import> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.exclude_controls class=md-nav__link> <span class=md-ellipsis> exclude_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.include_controls class=md-nav__link> <span class=md-ellipsis> include_controls </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Import.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls class=md-nav__link> <span class=md-ellipsis> InsertControls </span> </a> <nav class=md-nav aria-label=InsertControls> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.exclude_controls class=md-nav__link> <span class=md-ellipsis> exclude_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.include_all class=md-nav__link> <span class=md-ellipsis> include_all </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.include_controls class=md-nav__link> <span class=md-ellipsis> include_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.order class=md-nav__link> <span class=md-ellipsis> order </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.InsertControls.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues class=md-nav__link> <span class=md-ellipsis> ItemNameValidValues </span> </a> <nav class=md-nav aria-label=ItemNameValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.link class=md-nav__link> <span class=md-ellipsis> link </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.map class=md-nav__link> <span class=md-ellipsis> map </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.mapping class=md-nav__link> <span class=md-ellipsis> mapping </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.param class=md-nav__link> <span class=md-ellipsis> param </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.part class=md-nav__link> <span class=md-ellipsis> part </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.ItemNameValidValues.prop class=md-nav__link> <span class=md-ellipsis> prop </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching class=md-nav__link> <span class=md-ellipsis> Matching </span> </a> <nav class=md-nav aria-label=Matching> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching.pattern class=md-nav__link> <span class=md-ellipsis> pattern </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Matching.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge class=md-nav__link> <span class=md-ellipsis> Merge </span> </a> <nav class=md-nav aria-label=Merge> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.as_is class=md-nav__link> <span class=md-ellipsis> as_is </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.combine class=md-nav__link> <span class=md-ellipsis> combine </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.custom class=md-nav__link> <span class=md-ellipsis> custom </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.flat class=md-nav__link> <span class=md-ellipsis> flat </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Merge.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Model.profile class=md-nav__link> <span class=md-ellipsis> profile </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify class=md-nav__link> <span class=md-ellipsis> Modify </span> </a> <nav class=md-nav aria-label=Modify> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify.alters class=md-nav__link> <span class=md-ellipsis> alters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Modify.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues class=md-nav__link> <span class=md-ellipsis> OrderValidValues </span> </a> <nav class=md-nav aria-label=OrderValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues.ascending class=md-nav__link> <span class=md-ellipsis> ascending </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues.descending class=md-nav__link> <span class=md-ellipsis> descending </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.OrderValidValues.keep class=md-nav__link> <span class=md-ellipsis> keep </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues class=md-nav__link> <span class=md-ellipsis> PositionValidValues </span> </a> <nav class=md-nav aria-label=PositionValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues.after class=md-nav__link> <span class=md-ellipsis> after </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues.before class=md-nav__link> <span class=md-ellipsis> before </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues.ending class=md-nav__link> <span class=md-ellipsis> ending </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.PositionValidValues.starting class=md-nav__link> <span class=md-ellipsis> starting </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile class=md-nav__link> <span class=md-ellipsis> Profile </span> </a> <nav class=md-nav aria-label=Profile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.imports class=md-nav__link> <span class=md-ellipsis> imports </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.merge class=md-nav__link> <span class=md-ellipsis> merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.modify class=md-nav__link> <span class=md-ellipsis> modify </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Profile.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove class=md-nav__link> <span class=md-ellipsis> Remove </span> </a> <nav class=md-nav aria-label=Remove> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_class class=md-nav__link> <span class=md-ellipsis> by_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_id class=md-nav__link> <span class=md-ellipsis> by_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_item_name class=md-nav__link> <span class=md-ellipsis> by_item_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_name class=md-nav__link> <span class=md-ellipsis> by_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.by_ns class=md-nav__link> <span class=md-ellipsis> by_ns </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.Remove.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl class=md-nav__link> <span class=md-ellipsis> SelectControl </span> </a> <nav class=md-nav aria-label=SelectControl> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl.matching class=md-nav__link> <span class=md-ellipsis> matching </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl.with_child_controls class=md-nav__link> <span class=md-ellipsis> with_child_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl.with_ids class=md-nav__link> <span class=md-ellipsis> with_ids </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SelectControl.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter class=md-nav__link> <span class=md-ellipsis> SetParameter </span> </a> <nav class=md-nav aria-label=SetParameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.class_ class=md-nav__link> <span class=md-ellipsis> class_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.constraints class=md-nav__link> <span class=md-ellipsis> constraints </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.depends_on class=md-nav__link> <span class=md-ellipsis> depends_on </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.guidelines class=md-nav__link> <span class=md-ellipsis> guidelines </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.label class=md-nav__link> <span class=md-ellipsis> label </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.param_id class=md-nav__link> <span class=md-ellipsis> param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.select class=md-nav__link> <span class=md-ellipsis> select </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.usage class=md-nav__link> <span class=md-ellipsis> usage </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.SetParameter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithChildControlsValidValues class=md-nav__link> <span class=md-ellipsis> WithChildControlsValidValues </span> </a> <nav class=md-nav aria-label=WithChildControlsValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithChildControlsValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithChildControlsValidValues.no class=md-nav__link> <span class=md-ellipsis> no </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithChildControlsValidValues.yes class=md-nav__link> <span class=md-ellipsis> yes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithId class=md-nav__link> <span class=md-ellipsis> WithId </span> </a> <nav class=md-nav aria-label=WithId> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithId-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.profile.WithId.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.oscal.profile</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.oscal.profile class="doc doc-heading"> <code>trestle.oscal.profile</code> <a href=#trestle.oscal.profile class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <div class="doc doc-children"> <h3 id=trestle.oscal.profile-attributes>Attributes<a href=#trestle.oscal.profile-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.oscal.profile-classes>Classes<a href=#trestle.oscal.profile-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Add class="doc doc-heading"> <code>Add</code> <a href=#trestle.oscal.profile.Add class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Specifies contents to be added into controls, in resolution.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Add</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Specifies contents to be added into controls, in resolution.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>position</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>PositionValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Where to add the new content with respect to the targeted element (beside it or inside it).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Position&#39;</span>
+    <span class=p>)</span>
+    <span class=n>by_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Target location of the addition.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Reference by ID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the control, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Title Change&#39;</span>
+    <span class=p>)</span>
+    <span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Add-attributes>Attributes<a href=#trestle.oscal.profile.Add-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Add.by_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Target location of the addition.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Reference by ID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Add.by_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Add.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Add.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Add.params class="doc doc-heading"> <code class="highlight language-python"><span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Add.params class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Add.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Add.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Add.position class="doc doc-heading"> <code class="highlight language-python"><span class=n>position</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>PositionValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Where to add the new content with respect to the targeted element (beside it or inside it).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Position&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Add.position class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Add.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Add.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Add.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name given to the control, which may be used by a tool for display and navigation.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Title Change&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Add.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Add-classes>Classes<a href=#trestle.oscal.profile.Add-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Add.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Add.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>151</span>
+<span class=normal>152</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Add.Config-attributes>Attributes<a href=#trestle.oscal.profile.Add.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Add.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Add.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Alter class="doc doc-heading"> <code>Alter</code> <a href=#trestle.oscal.profile.Alter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Specifies changes to be made to an included control when a profile is resolved.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Alter</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Specifies changes to be made to an included control when a profile is resolved.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>removes</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Remove</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>adds</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Add</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Alter-attributes>Attributes<a href=#trestle.oscal.profile.Alter-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Alter.adds class="doc doc-heading"> <code class="highlight language-python"><span class=n>adds</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Add</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Alter.adds class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Alter.control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Alter.control_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Alter.removes class="doc doc-heading"> <code class="highlight language-python"><span class=n>removes</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Remove</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Alter.removes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Alter-classes>Classes<a href=#trestle.oscal.profile.Alter-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Alter.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Alter.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>266</span>
+<span class=normal>267</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Alter.Config-attributes>Attributes<a href=#trestle.oscal.profile.Alter.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Alter.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Alter.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.BooleanDatatype class="doc doc-heading"> <code>BooleanDatatype</code> <a href=#trestle.oscal.profile.BooleanDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>142</span>
+<span class=normal>143</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>BooleanDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A binary value that is either: true or false.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.BooleanDatatype-attributes>Attributes<a href=#trestle.oscal.profile.BooleanDatatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.BooleanDatatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A binary value that is either: true or false.&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.BooleanDatatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.CombinationMethodValidValues class="doc doc-heading"> <code>CombinationMethodValidValues</code> <a href=#trestle.oscal.profile.CombinationMethodValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CombinationMethodValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>use_first</span> <span class=o>=</span> <span class=s1>&#39;use-first&#39;</span>
+    <span class=n>merge</span> <span class=o>=</span> <span class=s1>&#39;merge&#39;</span>
+    <span class=n>keep</span> <span class=o>=</span> <span class=s1>&#39;keep&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.CombinationMethodValidValues-attributes>Attributes<a href=#trestle.oscal.profile.CombinationMethodValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.CombinationMethodValidValues.keep class="doc doc-heading"> <code class="highlight language-python"><span class=n>keep</span> <span class=o>=</span> <span class=s1>&#39;keep&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.CombinationMethodValidValues.keep class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.CombinationMethodValidValues.merge class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge</span> <span class=o>=</span> <span class=s1>&#39;merge&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.CombinationMethodValidValues.merge class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.CombinationMethodValidValues.use_first class="doc doc-heading"> <code class="highlight language-python"><span class=n>use_first</span> <span class=o>=</span> <span class=s1>&#39;use-first&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.CombinationMethodValidValues.use_first class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Combine class="doc doc-heading"> <code>Combine</code> <a href=#trestle.oscal.profile.Combine class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A Combine element defines how to resolve duplicate instances of the same control (e.g., controls with the same ID).</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Combine</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A Combine element defines how to resolve duplicate instances of the same control (e.g., controls with the same ID).</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>method</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CombinationMethodValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Declare how clashing controls should be handled.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Combination Method&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Combine-attributes>Attributes<a href=#trestle.oscal.profile.Combine-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Combine.method class="doc doc-heading"> <code class="highlight language-python"><span class=n>method</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>CombinationMethodValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Declare how clashing controls should be handled.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Combination Method&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Combine.method class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Combine-classes>Classes<a href=#trestle.oscal.profile.Combine-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Combine.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Combine.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>360</span>
+<span class=normal>361</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Combine.Config-attributes>Attributes<a href=#trestle.oscal.profile.Combine.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Combine.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Combine.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Custom class="doc doc-heading"> <code>Custom</code> <a href=#trestle.oscal.profile.Custom class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Provides an alternate grouping structure that selected controls will be placed in.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Custom</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Provides an alternate grouping structure that selected controls will be placed in.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>groups</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Group</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>insert_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>InsertControls</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;insert-controls&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Custom-attributes>Attributes<a href=#trestle.oscal.profile.Custom-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Custom.groups class="doc doc-heading"> <code class="highlight language-python"><span class=n>groups</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Group</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Custom.groups class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Custom.insert_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>insert_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>InsertControls</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;insert-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Custom.insert_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Custom-classes>Classes<a href=#trestle.oscal.profile.Custom-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Custom.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Custom.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>348</span>
+<span class=normal>349</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Custom.Config-attributes>Attributes<a href=#trestle.oscal.profile.Custom.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Custom.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Custom.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Group class="doc doc-heading"> <code>Group</code> <a href=#trestle.oscal.profile.Group class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A group of (selected) controls or of groups of controls.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Group</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A group of (selected) controls or of groups of controls.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=nb>id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the group.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label that provides a sub-type or characterization of the group.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Class&#39;</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name to be given to the group for use in display.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Title&#39;</span><span class=p>)</span>
+    <span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>groups</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Group</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>insert_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>InsertControls</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;insert-controls&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Group-attributes>Attributes<a href=#trestle.oscal.profile.Group-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Group.class_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label that provides a sub-type or characterization of the group.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Class&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.class_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Group.groups class="doc doc-heading"> <code class="highlight language-python"><span class=n>groups</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Group</span><span class=p>]]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.groups class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Group.id class="doc doc-heading"> <code class="highlight language-python"><span class=nb>id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies the group.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Group.insert_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>insert_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>InsertControls</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;insert-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.insert_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Group.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Group.params class="doc doc-heading"> <code class="highlight language-python"><span class=n>params</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Parameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.params class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Group.parts class="doc doc-heading"> <code class="highlight language-python"><span class=n>parts</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Part</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.parts class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Group.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Group.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A name to be given to the group for use in display.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group Title&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Group-classes>Classes<a href=#trestle.oscal.profile.Group-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Group.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Group.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>316</span>
+<span class=normal>317</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Group.Config-attributes>Attributes<a href=#trestle.oscal.profile.Group.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Group.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Group.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Import class="doc doc-heading"> <code>Import</code> <a href=#trestle.oscal.profile.Import class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Designates a referenced source catalog or profile that provides a source of control information for use in creating a new overlay or baseline.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Import</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Designates a referenced source catalog or profile that provides a source of control information for use in creating a new overlay or baseline.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to the base catalog or profile that this profile is tailoring.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Catalog or Profile Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span>
+    <span class=n>include_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-controls&#39;</span><span class=p>)</span>
+    <span class=n>exclude_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-controls&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Import-attributes>Attributes<a href=#trestle.oscal.profile.Import-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Import.exclude_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>exclude_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Import.exclude_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Import.href class="doc doc-heading"> <code class="highlight language-python"><span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A resolvable URL reference to the base catalog or profile that this profile is tailoring.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Catalog or Profile Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Import.href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Import.include_all class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Import.include_all class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Import.include_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Import.include_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Import-classes>Classes<a href=#trestle.oscal.profile.Import-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Import.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Import.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>199</span>
+<span class=normal>200</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Import.Config-attributes>Attributes<a href=#trestle.oscal.profile.Import.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Import.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Import.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.InsertControls class="doc doc-heading"> <code>InsertControls</code> <a href=#trestle.oscal.profile.InsertControls class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Specifies which controls to use in the containing context.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>InsertControls</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Specifies which controls to use in the containing context.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>order</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OrderValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A designation of how a selection of controls in a profile is to be ordered.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Order&#39;</span>
+    <span class=p>)</span>
+    <span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span>
+    <span class=n>include_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-controls&#39;</span><span class=p>)</span>
+    <span class=n>exclude_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-controls&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.InsertControls-attributes>Attributes<a href=#trestle.oscal.profile.InsertControls-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.InsertControls.exclude_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>exclude_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;exclude-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.InsertControls.exclude_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.InsertControls.include_all class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_all</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>IncludeAll</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-all&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.InsertControls.include_all class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.InsertControls.include_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>include_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SelectControl</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;include-controls&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.InsertControls.include_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.InsertControls.order class="doc doc-heading"> <code class="highlight language-python"><span class=n>order</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>OrderValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A designation of how a selection of controls in a profile is to be ordered.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Order&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.InsertControls.order class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.InsertControls-classes>Classes<a href=#trestle.oscal.profile.InsertControls-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.InsertControls.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.InsertControls.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>300</span>
+<span class=normal>301</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.InsertControls.Config-attributes>Attributes<a href=#trestle.oscal.profile.InsertControls.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.InsertControls.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.InsertControls.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.ItemNameValidValues class="doc doc-heading"> <code>ItemNameValidValues</code> <a href=#trestle.oscal.profile.ItemNameValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ItemNameValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>param</span> <span class=o>=</span> <span class=s1>&#39;param&#39;</span>
+    <span class=n>prop</span> <span class=o>=</span> <span class=s1>&#39;prop&#39;</span>
+    <span class=n>link</span> <span class=o>=</span> <span class=s1>&#39;link&#39;</span>
+    <span class=n>part</span> <span class=o>=</span> <span class=s1>&#39;part&#39;</span>
+    <span class=n>mapping</span> <span class=o>=</span> <span class=s1>&#39;mapping&#39;</span>
+    <span class=nb>map</span> <span class=o>=</span> <span class=s1>&#39;map&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.ItemNameValidValues-attributes>Attributes<a href=#trestle.oscal.profile.ItemNameValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.ItemNameValidValues.link class="doc doc-heading"> <code class="highlight language-python"><span class=n>link</span> <span class=o>=</span> <span class=s1>&#39;link&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.ItemNameValidValues.link class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.ItemNameValidValues.map class="doc doc-heading"> <code class="highlight language-python"><span class=nb>map</span> <span class=o>=</span> <span class=s1>&#39;map&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.ItemNameValidValues.map class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.ItemNameValidValues.mapping class="doc doc-heading"> <code class="highlight language-python"><span class=n>mapping</span> <span class=o>=</span> <span class=s1>&#39;mapping&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.ItemNameValidValues.mapping class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.ItemNameValidValues.param class="doc doc-heading"> <code class="highlight language-python"><span class=n>param</span> <span class=o>=</span> <span class=s1>&#39;param&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.ItemNameValidValues.param class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.ItemNameValidValues.part class="doc doc-heading"> <code class="highlight language-python"><span class=n>part</span> <span class=o>=</span> <span class=s1>&#39;part&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.ItemNameValidValues.part class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.ItemNameValidValues.prop class="doc doc-heading"> <code class="highlight language-python"><span class=n>prop</span> <span class=o>=</span> <span class=s1>&#39;prop&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.ItemNameValidValues.prop class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Matching class="doc doc-heading"> <code>Matching</code> <a href=#trestle.oscal.profile.Matching class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Selecting a set of controls by matching their IDs with a wildcard pattern.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Matching</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Selecting a set of controls by matching their IDs with a wildcard pattern.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>pattern</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A glob expression matching the IDs of one or more controls to be selected.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Pattern&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Matching-attributes>Attributes<a href=#trestle.oscal.profile.Matching-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Matching.pattern class="doc doc-heading"> <code class="highlight language-python"><span class=n>pattern</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A glob expression matching the IDs of one or more controls to be selected.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Pattern&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Matching.pattern class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Matching-classes>Classes<a href=#trestle.oscal.profile.Matching-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Matching.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Matching.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>119</span>
+<span class=normal>120</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Matching.Config-attributes>Attributes<a href=#trestle.oscal.profile.Matching.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Matching.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Matching.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Merge class="doc doc-heading"> <code>Merge</code> <a href=#trestle.oscal.profile.Merge class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Provides structuring directives that instruct how controls are organized after profile resolution.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Merge</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Provides structuring directives that instruct how controls are organized after profile resolution.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>combine</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Combine</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A Combine element defines how to resolve duplicate instances of the same control (e.g., controls with the same ID).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Combination Rule&#39;</span>
+    <span class=p>)</span>
+    <span class=n>flat</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Directs that controls appear without any grouping structure.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Flat Without Grouping&#39;</span>
+    <span class=p>)</span>
+    <span class=n>as_is</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>BooleanDatatype</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;as-is&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;Indicates that the controls selected should retain their original grouping as defined in the import source.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group As-Is&#39;</span>
+    <span class=p>)</span>
+    <span class=n>custom</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Custom</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides an alternate grouping structure that selected controls will be placed in.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Custom Grouping&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Merge-attributes>Attributes<a href=#trestle.oscal.profile.Merge-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Merge.as_is class="doc doc-heading"> <code class="highlight language-python"><span class=n>as_is</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>BooleanDatatype</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;as-is&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Indicates that the controls selected should retain their original grouping as defined in the import source.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Group As-Is&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Merge.as_is class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Merge.combine class="doc doc-heading"> <code class="highlight language-python"><span class=n>combine</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Combine</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A Combine element defines how to resolve duplicate instances of the same control (e.g., controls with the same ID).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Combination Rule&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Merge.combine class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Merge.custom class="doc doc-heading"> <code class="highlight language-python"><span class=n>custom</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Custom</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides an alternate grouping structure that selected controls will be placed in.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Custom Grouping&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Merge.custom class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Merge.flat class="doc doc-heading"> <code class="highlight language-python"><span class=n>flat</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Directs that controls appear without any grouping structure.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Flat Without Grouping&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Merge.flat class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Merge-classes>Classes<a href=#trestle.oscal.profile.Merge-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Merge.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Merge.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>373</span>
+<span class=normal>374</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Merge.Config-attributes>Attributes<a href=#trestle.oscal.profile.Merge.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Merge.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Merge.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Model class="doc doc-heading"> <code>Model</code> <a href=#trestle.oscal.profile.Model class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>420</span>
+<span class=normal>421</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Model</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>profile</span><span class=p>:</span> <span class=n>Profile</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Model-attributes>Attributes<a href=#trestle.oscal.profile.Model-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Model.profile class="doc doc-heading"> <code class="highlight language-python"><span class=n>profile</span><span class=p>:</span> <span class=n>Profile</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Model.profile class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Modify class="doc doc-heading"> <code>Modify</code> <a href=#trestle.oscal.profile.Modify class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Set parameters or amend controls in resolution.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Modify</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Set parameters or amend controls in resolution.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span>
+    <span class=n>alters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Alter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Modify-attributes>Attributes<a href=#trestle.oscal.profile.Modify-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Modify.alters class="doc doc-heading"> <code class="highlight language-python"><span class=n>alters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Alter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Modify.alters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Modify.set_parameters class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Modify.set_parameters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Modify-classes>Classes<a href=#trestle.oscal.profile.Modify-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Modify.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Modify.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>288</span>
+<span class=normal>289</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Modify.Config-attributes>Attributes<a href=#trestle.oscal.profile.Modify.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Modify.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Modify.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.OrderValidValues class="doc doc-heading"> <code>OrderValidValues</code> <a href=#trestle.oscal.profile.OrderValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OrderValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>keep</span> <span class=o>=</span> <span class=s1>&#39;keep&#39;</span>
+    <span class=n>ascending</span> <span class=o>=</span> <span class=s1>&#39;ascending&#39;</span>
+    <span class=n>descending</span> <span class=o>=</span> <span class=s1>&#39;descending&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.OrderValidValues-attributes>Attributes<a href=#trestle.oscal.profile.OrderValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.OrderValidValues.ascending class="doc doc-heading"> <code class="highlight language-python"><span class=n>ascending</span> <span class=o>=</span> <span class=s1>&#39;ascending&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.OrderValidValues.ascending class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.OrderValidValues.descending class="doc doc-heading"> <code class="highlight language-python"><span class=n>descending</span> <span class=o>=</span> <span class=s1>&#39;descending&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.OrderValidValues.descending class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.OrderValidValues.keep class="doc doc-heading"> <code class="highlight language-python"><span class=n>keep</span> <span class=o>=</span> <span class=s1>&#39;keep&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.OrderValidValues.keep class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.PositionValidValues class="doc doc-heading"> <code>PositionValidValues</code> <a href=#trestle.oscal.profile.PositionValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PositionValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>before</span> <span class=o>=</span> <span class=s1>&#39;before&#39;</span>
+    <span class=n>after</span> <span class=o>=</span> <span class=s1>&#39;after&#39;</span>
+    <span class=n>starting</span> <span class=o>=</span> <span class=s1>&#39;starting&#39;</span>
+    <span class=n>ending</span> <span class=o>=</span> <span class=s1>&#39;ending&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.PositionValidValues-attributes>Attributes<a href=#trestle.oscal.profile.PositionValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.PositionValidValues.after class="doc doc-heading"> <code class="highlight language-python"><span class=n>after</span> <span class=o>=</span> <span class=s1>&#39;after&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.PositionValidValues.after class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.PositionValidValues.before class="doc doc-heading"> <code class="highlight language-python"><span class=n>before</span> <span class=o>=</span> <span class=s1>&#39;before&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.PositionValidValues.before class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.PositionValidValues.ending class="doc doc-heading"> <code class="highlight language-python"><span class=n>ending</span> <span class=o>=</span> <span class=s1>&#39;ending&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.PositionValidValues.ending class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.PositionValidValues.starting class="doc doc-heading"> <code class="highlight language-python"><span class=n>starting</span> <span class=o>=</span> <span class=s1>&#39;starting&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.PositionValidValues.starting class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Profile class="doc doc-heading"> <code>Profile</code> <a href=#trestle.oscal.profile.Profile class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Each OSCAL profile is defined by a profile element.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Profile</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Each OSCAL profile is defined by a profile element.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+                 <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+                     <span class=o>...</span><span class=p>,</span>
+                     <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given profile instance.&#39;</span><span class=p>,</span>
+                     <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Profile Universally Unique Identifier&#39;</span>
+                 <span class=p>)</span>
+    <span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span>
+    <span class=n>imports</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Import</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>merge</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Merge</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>modify</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Modify</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Profile-attributes>Attributes<a href=#trestle.oscal.profile.Profile-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Profile.back_matter class="doc doc-heading"> <code class="highlight language-python"><span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Profile.back_matter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Profile.imports class="doc doc-heading"> <code class="highlight language-python"><span class=n>imports</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Import</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Profile.imports class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Profile.merge class="doc doc-heading"> <code class="highlight language-python"><span class=n>merge</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Merge</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Profile.merge class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Profile.metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Profile.metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Profile.modify class="doc doc-heading"> <code class="highlight language-python"><span class=n>modify</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Modify</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Profile.modify class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Profile.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Provides a globally unique means to identify a given profile instance.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Profile Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Profile.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Profile-classes>Classes<a href=#trestle.oscal.profile.Profile-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Profile.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Profile.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>404</span>
+<span class=normal>405</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Profile.Config-attributes>Attributes<a href=#trestle.oscal.profile.Profile.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Profile.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Profile.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.Remove class="doc doc-heading"> <code>Remove</code> <a href=#trestle.oscal.profile.Remove class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Specifies objects to be removed from a control based on specific aspects of the object that must all match.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Remove</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Specifies objects to be removed from a control based on specific aspects of the object that must all match.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>by_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-name&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identify items remove by matching their assigned name.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Reference by (assigned) name&#39;</span>
+    <span class=p>)</span>
+    <span class=n>by_class</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-class&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identify items to remove by matching their class.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Reference by class&#39;</span>
+    <span class=p>)</span>
+    <span class=n>by_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identify items to remove indicated by their id.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Reference by ID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>by_item_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ItemNameValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-item-name&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s2>&quot;Identify items to remove by the name of the item&#39;s information object name, e.g. title or prop.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Item Name Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>by_ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-ns&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s2>&quot;Identify items to remove by the item&#39;s ns, which is the namespace associated with a part, or prop.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Item Namespace Reference&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.Remove-attributes>Attributes<a href=#trestle.oscal.profile.Remove-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Remove.by_class class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_class</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-class&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identify items to remove by matching their class.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Reference by class&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Remove.by_class class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Remove.by_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_id</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identify items to remove indicated by their id.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Reference by ID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Remove.by_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Remove.by_item_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_item_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>ItemNameValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-item-name&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;Identify items to remove by the name of the item&#39;s information object name, e.g. title or prop.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Item Name Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Remove.by_item_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Remove.by_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-name&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identify items remove by matching their assigned name.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Reference by (assigned) name&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Remove.by_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.Remove.by_ns class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-ns&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;Identify items to remove by the item&#39;s ns, which is the namespace associated with a part, or prop.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Item Namespace Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Remove.by_ns class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.Remove-classes>Classes<a href=#trestle.oscal.profile.Remove-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.Remove.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.Remove.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>217</span>
+<span class=normal>218</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.Remove.Config-attributes>Attributes<a href=#trestle.oscal.profile.Remove.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.Remove.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.Remove.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.SelectControl class="doc doc-heading"> <code>SelectControl</code> <a href=#trestle.oscal.profile.SelectControl class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Select a control or controls from an imported control set.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SelectControl</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Select a control or controls from an imported control set.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>with_child_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>WithChildControlsValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;with-child-controls&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;When a control is included, whether its child (dependent) controls are also included.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Include Contained Controls with Control&#39;</span>
+    <span class=p>)</span>
+    <span class=n>with_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>WithId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;with-ids&#39;</span><span class=p>)</span>
+    <span class=n>matching</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Matching</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.SelectControl-attributes>Attributes<a href=#trestle.oscal.profile.SelectControl-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SelectControl.matching class="doc doc-heading"> <code class="highlight language-python"><span class=n>matching</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Matching</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SelectControl.matching class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SelectControl.with_child_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>with_child_controls</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>WithChildControlsValidValues</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;with-child-controls&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;When a control is included, whether its child (dependent) controls are also included.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Include Contained Controls with Control&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SelectControl.with_child_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SelectControl.with_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>with_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>WithId</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;with-ids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SelectControl.with_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.SelectControl-classes>Classes<a href=#trestle.oscal.profile.SelectControl-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.SelectControl.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.SelectControl.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>181</span>
+<span class=normal>182</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.SelectControl.Config-attributes>Attributes<a href=#trestle.oscal.profile.SelectControl.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.SelectControl.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SelectControl.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.SetParameter class="doc doc-heading"> <code>SetParameter</code> <a href=#trestle.oscal.profile.SetParameter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A parameter setting, to be propagated to points of insertion.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span>
+<span class=normal>98</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SetParameter</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A parameter setting, to be propagated to points of insertion.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>param_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;param-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An identifier for the parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>)</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label that provides a characterization of the parameter.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Class&#39;</span>
+    <span class=p>)</span>
+    <span class=n>depends_on</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;depends-on&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;**(deprecated)** Another parameter invoking this one. This construct has been deprecated and should not be used.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Depends On&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>label</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A short, placeholder name for the parameter, which can be used as a substitute for a value if no value is assigned.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Label&#39;</span>
+    <span class=p>)</span>
+    <span class=n>usage</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes the purpose and use of a parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Usage Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>constraints</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ParameterConstraint</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>guidelines</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ParameterGuideline</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>values</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>select</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ParameterSelection</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.SetParameter-attributes>Attributes<a href=#trestle.oscal.profile.SetParameter-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.class_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;class&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A textual label that provides a characterization of the parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Class&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.class_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.constraints class="doc doc-heading"> <code class="highlight language-python"><span class=n>constraints</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ParameterConstraint</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.constraints class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.depends_on class="doc doc-heading"> <code class="highlight language-python"><span class=n>depends_on</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;depends-on&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;**(deprecated)** Another parameter invoking this one. This construct has been deprecated and should not be used.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Depends On&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.depends_on class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.guidelines class="doc doc-heading"> <code class="highlight language-python"><span class=n>guidelines</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ParameterGuideline</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.guidelines class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.label class="doc doc-heading"> <code class="highlight language-python"><span class=n>label</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A short, placeholder name for the parameter, which can be used as a substitute for a value if no value is assigned.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Label&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.label class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.param_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>param_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;param-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An identifier for the parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.param_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.select class="doc doc-heading"> <code class="highlight language-python"><span class=n>select</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ParameterSelection</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.select class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.usage class="doc doc-heading"> <code class="highlight language-python"><span class=n>usage</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Describes the purpose and use of a parameter.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter Usage Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.usage class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.SetParameter.values class="doc doc-heading"> <code class="highlight language-python"><span class=n>values</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.values class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.profile.SetParameter-classes>Classes<a href=#trestle.oscal.profile.SetParameter-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.profile.SetParameter.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.profile.SetParameter.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>58</span>
+<span class=normal>59</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.profile.SetParameter.Config-attributes>Attributes<a href=#trestle.oscal.profile.SetParameter.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.profile.SetParameter.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.SetParameter.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.WithChildControlsValidValues class="doc doc-heading"> <code>WithChildControlsValidValues</code> <a href=#trestle.oscal.profile.WithChildControlsValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>WithChildControlsValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>yes</span> <span class=o>=</span> <span class=s1>&#39;yes&#39;</span>
+    <span class=n>no</span> <span class=o>=</span> <span class=s1>&#39;no&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.WithChildControlsValidValues-attributes>Attributes<a href=#trestle.oscal.profile.WithChildControlsValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.WithChildControlsValidValues.no class="doc doc-heading"> <code class="highlight language-python"><span class=n>no</span> <span class=o>=</span> <span class=s1>&#39;no&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.WithChildControlsValidValues.no class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.WithChildControlsValidValues.yes class="doc doc-heading"> <code class="highlight language-python"><span class=n>yes</span> <span class=o>=</span> <span class=s1>&#39;yes&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.WithChildControlsValidValues.yes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.profile.WithId class="doc doc-heading"> <code>WithId</code> <a href=#trestle.oscal.profile.WithId class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>WithId</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Selecting a control by its ID given as a literal.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Match Controls by Identifier&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.profile.WithId-attributes>Attributes<a href=#trestle.oscal.profile.WithId-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.profile.WithId.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Selecting a control by its ID given as a literal.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Match Controls by Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.profile.WithId.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/oscal/ssp/index.html b/latest/reference/API/trestle/oscal/ssp/index.html
new file mode 100644
index 000000000..8415540ee
--- /dev/null
+++ b/latest/reference/API/trestle/oscal/ssp/index.html
@@ -0,0 +1,1303 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.oscal.ssp module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/ssp/ rel=canonical><link href=../profile/ rel=prev><link href=../../tasks/base_task/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.oscal.ssp - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.oscal.ssp - Compliance Trestle"><meta property=og:description content="Documentation for trestle.oscal.ssp module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/ssp.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/ssp/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.oscal.ssp - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.oscal.ssp module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/oscal/ssp.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.oscal.ssp class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.oscal.ssp </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4 checked> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.oscal.ssp </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.ssp class=md-nav__link> <span class=md-ellipsis> ssp </span> </a> <nav class=md-nav aria-label=ssp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AdjustmentJustification class=md-nav__link> <span class=md-ellipsis> AdjustmentJustification </span> </a> <nav class=md-nav aria-label=AdjustmentJustification> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AdjustmentJustification-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AdjustmentJustification.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary class=md-nav__link> <span class=md-ellipsis> AuthorizationBoundary </span> </a> <nav class=md-nav aria-label=AuthorizationBoundary> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.diagrams class=md-nav__link> <span class=md-ellipsis> diagrams </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Base class=md-nav__link> <span class=md-ellipsis> Base </span> </a> <nav class=md-nav aria-label=Base> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Base-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Base.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent class=md-nav__link> <span class=md-ellipsis> ByComponent </span> </a> <nav class=md-nav aria-label=ByComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.export class=md-nav__link> <span class=md-ellipsis> export </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.implementation_status class=md-nav__link> <span class=md-ellipsis> implementation_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.inherited class=md-nav__link> <span class=md-ellipsis> inherited </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.satisfied class=md-nav__link> <span class=md-ellipsis> satisfied </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization class=md-nav__link> <span class=md-ellipsis> Categorization </span> </a> <nav class=md-nav aria-label=Categorization> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization.information_type_ids class=md-nav__link> <span class=md-ellipsis> information_type_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation class=md-nav__link> <span class=md-ellipsis> ControlImplementation </span> </a> <nav class=md-nav aria-label=ControlImplementation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation.implemented_requirements class=md-nav__link> <span class=md-ellipsis> implemented_requirements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow class=md-nav__link> <span class=md-ellipsis> DataFlow </span> </a> <nav class=md-nav aria-label=DataFlow> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.diagrams class=md-nav__link> <span class=md-ellipsis> diagrams </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateAuthorized class=md-nav__link> <span class=md-ellipsis> DateAuthorized </span> </a> <nav class=md-nav aria-label=DateAuthorized> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateAuthorized-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateAuthorized.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateDatatype class=md-nav__link> <span class=md-ellipsis> DateDatatype </span> </a> <nav class=md-nav aria-label=DateDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram class=md-nav__link> <span class=md-ellipsis> Diagram </span> </a> <nav class=md-nav aria-label=Diagram> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.caption class=md-nav__link> <span class=md-ellipsis> caption </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export class=md-nav__link> <span class=md-ellipsis> Export </span> </a> <nav class=md-nav aria-label=Export> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.provided class=md-nav__link> <span class=md-ellipsis> provided </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.responsibilities class=md-nav__link> <span class=md-ellipsis> responsibilities </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact class=md-nav__link> <span class=md-ellipsis> Impact </span> </a> <nav class=md-nav aria-label=Impact> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.adjustment_justification class=md-nav__link> <span class=md-ellipsis> adjustment_justification </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.base class=md-nav__link> <span class=md-ellipsis> base </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.selected class=md-nav__link> <span class=md-ellipsis> selected </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement class=md-nav__link> <span class=md-ellipsis> ImplementedRequirement </span> </a> <nav class=md-nav aria-label=ImplementedRequirement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.by_components class=md-nav__link> <span class=md-ellipsis> by_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.statements class=md-nav__link> <span class=md-ellipsis> statements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile class=md-nav__link> <span class=md-ellipsis> ImportProfile </span> </a> <nav class=md-nav aria-label=ImportProfile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType class=md-nav__link> <span class=md-ellipsis> InformationType </span> </a> <nav class=md-nav aria-label=InformationType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.availability_impact class=md-nav__link> <span class=md-ellipsis> availability_impact </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.categorizations class=md-nav__link> <span class=md-ellipsis> categorizations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.confidentiality_impact class=md-nav__link> <span class=md-ellipsis> confidentiality_impact </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.integrity_impact class=md-nav__link> <span class=md-ellipsis> integrity_impact </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited class=md-nav__link> <span class=md-ellipsis> Inherited </span> </a> <nav class=md-nav aria-label=Inherited> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.provided_uuid class=md-nav__link> <span class=md-ellipsis> provided_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization class=md-nav__link> <span class=md-ellipsis> LeveragedAuthorization </span> </a> <nav class=md-nav aria-label=LeveragedAuthorization> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.date_authorized class=md-nav__link> <span class=md-ellipsis> date_authorized </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.party_uuid class=md-nav__link> <span class=md-ellipsis> party_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Model.system_security_plan class=md-nav__link> <span class=md-ellipsis> system_security_plan </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture class=md-nav__link> <span class=md-ellipsis> NetworkArchitecture </span> </a> <nav class=md-nav aria-label=NetworkArchitecture> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.diagrams class=md-nav__link> <span class=md-ellipsis> diagrams </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues class=md-nav__link> <span class=md-ellipsis> OperationalStateValidValues </span> </a> <nav class=md-nav aria-label=OperationalStateValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.disposition class=md-nav__link> <span class=md-ellipsis> disposition </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.operational class=md-nav__link> <span class=md-ellipsis> operational </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.other class=md-nav__link> <span class=md-ellipsis> other </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.under_development class=md-nav__link> <span class=md-ellipsis> under_development </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.under_major_modification class=md-nav__link> <span class=md-ellipsis> under_major_modification </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided class=md-nav__link> <span class=md-ellipsis> Provided </span> </a> <nav class=md-nav aria-label=Provided> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility class=md-nav__link> <span class=md-ellipsis> Responsibility </span> </a> <nav class=md-nav aria-label=Responsibility> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.provided_uuid class=md-nav__link> <span class=md-ellipsis> provided_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied class=md-nav__link> <span class=md-ellipsis> Satisfied </span> </a> <nav class=md-nav aria-label=Satisfied> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.responsibility_uuid class=md-nav__link> <span class=md-ellipsis> responsibility_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel class=md-nav__link> <span class=md-ellipsis> SecurityImpactLevel </span> </a> <nav class=md-nav aria-label=SecurityImpactLevel> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel.security_objective_availability class=md-nav__link> <span class=md-ellipsis> security_objective_availability </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel.security_objective_confidentiality class=md-nav__link> <span class=md-ellipsis> security_objective_confidentiality </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel.security_objective_integrity class=md-nav__link> <span class=md-ellipsis> security_objective_integrity </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Selected class=md-nav__link> <span class=md-ellipsis> Selected </span> </a> <nav class=md-nav aria-label=Selected> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Selected-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Selected.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter class=md-nav__link> <span class=md-ellipsis> SetParameter </span> </a> <nav class=md-nav aria-label=SetParameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter.param_id class=md-nav__link> <span class=md-ellipsis> param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement class=md-nav__link> <span class=md-ellipsis> Statement </span> </a> <nav class=md-nav aria-label=Statement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.by_components class=md-nav__link> <span class=md-ellipsis> by_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.statement_id class=md-nav__link> <span class=md-ellipsis> statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1 class=md-nav__link> <span class=md-ellipsis> Status1 </span> </a> <nav class=md-nav aria-label=Status1> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.System class=md-nav__link> <span class=md-ellipsis> System </span> </a> <nav class=md-nav aria-label=System> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.System-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.System.http___doi_org_10_6028_NIST_SP_800_60v2r1 class=md-nav__link> <span class=md-ellipsis> http___doi_org_10_6028_NIST_SP_800_60v2r1 </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics class=md-nav__link> <span class=md-ellipsis> SystemCharacteristics </span> </a> <nav class=md-nav aria-label=SystemCharacteristics> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.authorization_boundary class=md-nav__link> <span class=md-ellipsis> authorization_boundary </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.data_flow class=md-nav__link> <span class=md-ellipsis> data_flow </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.date_authorized class=md-nav__link> <span class=md-ellipsis> date_authorized </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.network_architecture class=md-nav__link> <span class=md-ellipsis> network_architecture </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.security_impact_level class=md-nav__link> <span class=md-ellipsis> security_impact_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.security_sensitivity_level class=md-nav__link> <span class=md-ellipsis> security_sensitivity_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_ids class=md-nav__link> <span class=md-ellipsis> system_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_information class=md-nav__link> <span class=md-ellipsis> system_information </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_name class=md-nav__link> <span class=md-ellipsis> system_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_name_short class=md-nav__link> <span class=md-ellipsis> system_name_short </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation class=md-nav__link> <span class=md-ellipsis> SystemImplementation </span> </a> <nav class=md-nav aria-label=SystemImplementation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.inventory_items class=md-nav__link> <span class=md-ellipsis> inventory_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.leveraged_authorizations class=md-nav__link> <span class=md-ellipsis> leveraged_authorizations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.users class=md-nav__link> <span class=md-ellipsis> users </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation class=md-nav__link> <span class=md-ellipsis> SystemInformation </span> </a> <nav class=md-nav aria-label=SystemInformation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation.information_types class=md-nav__link> <span class=md-ellipsis> information_types </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan class=md-nav__link> <span class=md-ellipsis> SystemSecurityPlan </span> </a> <nav class=md-nav aria-label=SystemSecurityPlan> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.control_implementation class=md-nav__link> <span class=md-ellipsis> control_implementation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.import_profile class=md-nav__link> <span class=md-ellipsis> import_profile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.system_characteristics class=md-nav__link> <span class=md-ellipsis> system_characteristics </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.system_implementation class=md-nav__link> <span class=md-ellipsis> system_implementation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.oscal.ssp class=md-nav__link> <span class=md-ellipsis> ssp </span> </a> <nav class=md-nav aria-label=ssp> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AdjustmentJustification class=md-nav__link> <span class=md-ellipsis> AdjustmentJustification </span> </a> <nav class=md-nav aria-label=AdjustmentJustification> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AdjustmentJustification-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AdjustmentJustification.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary class=md-nav__link> <span class=md-ellipsis> AuthorizationBoundary </span> </a> <nav class=md-nav aria-label=AuthorizationBoundary> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.diagrams class=md-nav__link> <span class=md-ellipsis> diagrams </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.AuthorizationBoundary.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Base class=md-nav__link> <span class=md-ellipsis> Base </span> </a> <nav class=md-nav aria-label=Base> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Base-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Base.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent class=md-nav__link> <span class=md-ellipsis> ByComponent </span> </a> <nav class=md-nav aria-label=ByComponent> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.component_uuid class=md-nav__link> <span class=md-ellipsis> component_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.export class=md-nav__link> <span class=md-ellipsis> export </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.implementation_status class=md-nav__link> <span class=md-ellipsis> implementation_status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.inherited class=md-nav__link> <span class=md-ellipsis> inherited </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.satisfied class=md-nav__link> <span class=md-ellipsis> satisfied </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ByComponent.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization class=md-nav__link> <span class=md-ellipsis> Categorization </span> </a> <nav class=md-nav aria-label=Categorization> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization.information_type_ids class=md-nav__link> <span class=md-ellipsis> information_type_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization.system class=md-nav__link> <span class=md-ellipsis> system </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Categorization.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation class=md-nav__link> <span class=md-ellipsis> ControlImplementation </span> </a> <nav class=md-nav aria-label=ControlImplementation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation.implemented_requirements class=md-nav__link> <span class=md-ellipsis> implemented_requirements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ControlImplementation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow class=md-nav__link> <span class=md-ellipsis> DataFlow </span> </a> <nav class=md-nav aria-label=DataFlow> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.diagrams class=md-nav__link> <span class=md-ellipsis> diagrams </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DataFlow.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateAuthorized class=md-nav__link> <span class=md-ellipsis> DateAuthorized </span> </a> <nav class=md-nav aria-label=DateAuthorized> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateAuthorized-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateAuthorized.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateDatatype class=md-nav__link> <span class=md-ellipsis> DateDatatype </span> </a> <nav class=md-nav aria-label=DateDatatype> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateDatatype-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.DateDatatype.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram class=md-nav__link> <span class=md-ellipsis> Diagram </span> </a> <nav class=md-nav aria-label=Diagram> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.caption class=md-nav__link> <span class=md-ellipsis> caption </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Diagram.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export class=md-nav__link> <span class=md-ellipsis> Export </span> </a> <nav class=md-nav aria-label=Export> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.provided class=md-nav__link> <span class=md-ellipsis> provided </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.responsibilities class=md-nav__link> <span class=md-ellipsis> responsibilities </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Export.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact class=md-nav__link> <span class=md-ellipsis> Impact </span> </a> <nav class=md-nav aria-label=Impact> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.adjustment_justification class=md-nav__link> <span class=md-ellipsis> adjustment_justification </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.base class=md-nav__link> <span class=md-ellipsis> base </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.selected class=md-nav__link> <span class=md-ellipsis> selected </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Impact.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement class=md-nav__link> <span class=md-ellipsis> ImplementedRequirement </span> </a> <nav class=md-nav aria-label=ImplementedRequirement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.by_components class=md-nav__link> <span class=md-ellipsis> by_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.set_parameters class=md-nav__link> <span class=md-ellipsis> set_parameters </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.statements class=md-nav__link> <span class=md-ellipsis> statements </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImplementedRequirement.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile class=md-nav__link> <span class=md-ellipsis> ImportProfile </span> </a> <nav class=md-nav aria-label=ImportProfile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile.href class=md-nav__link> <span class=md-ellipsis> href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.ImportProfile.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType class=md-nav__link> <span class=md-ellipsis> InformationType </span> </a> <nav class=md-nav aria-label=InformationType> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.availability_impact class=md-nav__link> <span class=md-ellipsis> availability_impact </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.categorizations class=md-nav__link> <span class=md-ellipsis> categorizations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.confidentiality_impact class=md-nav__link> <span class=md-ellipsis> confidentiality_impact </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.integrity_impact class=md-nav__link> <span class=md-ellipsis> integrity_impact </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.InformationType.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited class=md-nav__link> <span class=md-ellipsis> Inherited </span> </a> <nav class=md-nav aria-label=Inherited> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.provided_uuid class=md-nav__link> <span class=md-ellipsis> provided_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Inherited.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization class=md-nav__link> <span class=md-ellipsis> LeveragedAuthorization </span> </a> <nav class=md-nav aria-label=LeveragedAuthorization> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.date_authorized class=md-nav__link> <span class=md-ellipsis> date_authorized </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.party_uuid class=md-nav__link> <span class=md-ellipsis> party_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.title class=md-nav__link> <span class=md-ellipsis> title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.LeveragedAuthorization.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Model class=md-nav__link> <span class=md-ellipsis> Model </span> </a> <nav class=md-nav aria-label=Model> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Model-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Model.system_security_plan class=md-nav__link> <span class=md-ellipsis> system_security_plan </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture class=md-nav__link> <span class=md-ellipsis> NetworkArchitecture </span> </a> <nav class=md-nav aria-label=NetworkArchitecture> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.diagrams class=md-nav__link> <span class=md-ellipsis> diagrams </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.NetworkArchitecture.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues class=md-nav__link> <span class=md-ellipsis> OperationalStateValidValues </span> </a> <nav class=md-nav aria-label=OperationalStateValidValues> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.disposition class=md-nav__link> <span class=md-ellipsis> disposition </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.operational class=md-nav__link> <span class=md-ellipsis> operational </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.other class=md-nav__link> <span class=md-ellipsis> other </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.under_development class=md-nav__link> <span class=md-ellipsis> under_development </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.OperationalStateValidValues.under_major_modification class=md-nav__link> <span class=md-ellipsis> under_major_modification </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided class=md-nav__link> <span class=md-ellipsis> Provided </span> </a> <nav class=md-nav aria-label=Provided> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Provided.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility class=md-nav__link> <span class=md-ellipsis> Responsibility </span> </a> <nav class=md-nav aria-label=Responsibility> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.provided_uuid class=md-nav__link> <span class=md-ellipsis> provided_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Responsibility.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied class=md-nav__link> <span class=md-ellipsis> Satisfied </span> </a> <nav class=md-nav aria-label=Satisfied> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.responsibility_uuid class=md-nav__link> <span class=md-ellipsis> responsibility_uuid </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Satisfied.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel class=md-nav__link> <span class=md-ellipsis> SecurityImpactLevel </span> </a> <nav class=md-nav aria-label=SecurityImpactLevel> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel.security_objective_availability class=md-nav__link> <span class=md-ellipsis> security_objective_availability </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel.security_objective_confidentiality class=md-nav__link> <span class=md-ellipsis> security_objective_confidentiality </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel.security_objective_integrity class=md-nav__link> <span class=md-ellipsis> security_objective_integrity </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SecurityImpactLevel.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Selected class=md-nav__link> <span class=md-ellipsis> Selected </span> </a> <nav class=md-nav aria-label=Selected> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Selected-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Selected.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter class=md-nav__link> <span class=md-ellipsis> SetParameter </span> </a> <nav class=md-nav aria-label=SetParameter> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter.param_id class=md-nav__link> <span class=md-ellipsis> param_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter.values class=md-nav__link> <span class=md-ellipsis> values </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SetParameter.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement class=md-nav__link> <span class=md-ellipsis> Statement </span> </a> <nav class=md-nav aria-label=Statement> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.by_components class=md-nav__link> <span class=md-ellipsis> by_components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.responsible_roles class=md-nav__link> <span class=md-ellipsis> responsible_roles </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.statement_id class=md-nav__link> <span class=md-ellipsis> statement_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Statement.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1 class=md-nav__link> <span class=md-ellipsis> Status1 </span> </a> <nav class=md-nav aria-label=Status1> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.Status1.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.System class=md-nav__link> <span class=md-ellipsis> System </span> </a> <nav class=md-nav aria-label=System> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.System-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.System.http___doi_org_10_6028_NIST_SP_800_60v2r1 class=md-nav__link> <span class=md-ellipsis> http___doi_org_10_6028_NIST_SP_800_60v2r1 </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics class=md-nav__link> <span class=md-ellipsis> SystemCharacteristics </span> </a> <nav class=md-nav aria-label=SystemCharacteristics> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.authorization_boundary class=md-nav__link> <span class=md-ellipsis> authorization_boundary </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.data_flow class=md-nav__link> <span class=md-ellipsis> data_flow </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.date_authorized class=md-nav__link> <span class=md-ellipsis> date_authorized </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.network_architecture class=md-nav__link> <span class=md-ellipsis> network_architecture </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.responsible_parties class=md-nav__link> <span class=md-ellipsis> responsible_parties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.security_impact_level class=md-nav__link> <span class=md-ellipsis> security_impact_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.security_sensitivity_level class=md-nav__link> <span class=md-ellipsis> security_sensitivity_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.status class=md-nav__link> <span class=md-ellipsis> status </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_ids class=md-nav__link> <span class=md-ellipsis> system_ids </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_information class=md-nav__link> <span class=md-ellipsis> system_information </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_name class=md-nav__link> <span class=md-ellipsis> system_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_name_short class=md-nav__link> <span class=md-ellipsis> system_name_short </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemCharacteristics.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation class=md-nav__link> <span class=md-ellipsis> SystemImplementation </span> </a> <nav class=md-nav aria-label=SystemImplementation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.inventory_items class=md-nav__link> <span class=md-ellipsis> inventory_items </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.leveraged_authorizations class=md-nav__link> <span class=md-ellipsis> leveraged_authorizations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.remarks class=md-nav__link> <span class=md-ellipsis> remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.users class=md-nav__link> <span class=md-ellipsis> users </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemImplementation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation class=md-nav__link> <span class=md-ellipsis> SystemInformation </span> </a> <nav class=md-nav aria-label=SystemInformation> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation.information_types class=md-nav__link> <span class=md-ellipsis> information_types </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation.links class=md-nav__link> <span class=md-ellipsis> links </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation.props class=md-nav__link> <span class=md-ellipsis> props </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemInformation.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan class=md-nav__link> <span class=md-ellipsis> SystemSecurityPlan </span> </a> <nav class=md-nav aria-label=SystemSecurityPlan> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.back_matter class=md-nav__link> <span class=md-ellipsis> back_matter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.control_implementation class=md-nav__link> <span class=md-ellipsis> control_implementation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.import_profile class=md-nav__link> <span class=md-ellipsis> import_profile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.metadata class=md-nav__link> <span class=md-ellipsis> metadata </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.system_characteristics class=md-nav__link> <span class=md-ellipsis> system_characteristics </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.system_implementation class=md-nav__link> <span class=md-ellipsis> system_implementation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.uuid class=md-nav__link> <span class=md-ellipsis> uuid </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.oscal.ssp.SystemSecurityPlan.Config class=md-nav__link> <span class=md-ellipsis> Config </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.oscal.ssp</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.oscal.ssp class="doc doc-heading"> <code>trestle.oscal.ssp</code> <a href=#trestle.oscal.ssp class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <div class="doc doc-children"> <h3 id=trestle.oscal.ssp-attributes>Attributes<a href=#trestle.oscal.ssp-attributes class=headerlink title="Permanent link">¤</a></h3> <h3 id=trestle.oscal.ssp-classes>Classes<a href=#trestle.oscal.ssp-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.AdjustmentJustification class="doc doc-heading"> <code>AdjustmentJustification</code> <a href=#trestle.oscal.ssp.AdjustmentJustification class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AdjustmentJustification</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;If the selected security level is different from the base security level, this contains the justification for the change.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Adjustment Justification&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.AdjustmentJustification-attributes>Attributes<a href=#trestle.oscal.ssp.AdjustmentJustification-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.AdjustmentJustification.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;If the selected security level is different from the base security level, this contains the justification for the change.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Adjustment Justification&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.AdjustmentJustification.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.AuthorizationBoundary class="doc doc-heading"> <code>AuthorizationBoundary</code> <a href=#trestle.oscal.ssp.AuthorizationBoundary class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A description of this system's authorization boundary, optionally supplemented by diagrams that illustrate the authorization boundary.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>AuthorizationBoundary</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A description of this system&#39;s authorization boundary, optionally supplemented by diagrams that illustrate the authorization boundary.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the system&#39;s authorization boundary.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Authorization Boundary Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>diagrams</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Diagram</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.AuthorizationBoundary-attributes>Attributes<a href=#trestle.oscal.ssp.AuthorizationBoundary-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.AuthorizationBoundary.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the system&#39;s authorization boundary.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Authorization Boundary Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.AuthorizationBoundary.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.AuthorizationBoundary.diagrams class="doc doc-heading"> <code class="highlight language-python"><span class=n>diagrams</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Diagram</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.AuthorizationBoundary.diagrams class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.AuthorizationBoundary.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.AuthorizationBoundary.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.AuthorizationBoundary.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.AuthorizationBoundary.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.AuthorizationBoundary.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.AuthorizationBoundary.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.AuthorizationBoundary-classes>Classes<a href=#trestle.oscal.ssp.AuthorizationBoundary-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.AuthorizationBoundary.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.AuthorizationBoundary.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>426</span>
+<span class=normal>427</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.AuthorizationBoundary.Config-attributes>Attributes<a href=#trestle.oscal.ssp.AuthorizationBoundary.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.AuthorizationBoundary.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.AuthorizationBoundary.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Base class="doc doc-heading"> <code>Base</code> <a href=#trestle.oscal.ssp.Base class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Base</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The prescribed base (Confidentiality, Integrity, or Availability) security impact level.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Base Level (Confidentiality, Integrity, or Availability)&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Base-attributes>Attributes<a href=#trestle.oscal.ssp.Base-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Base.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The prescribed base (Confidentiality, Integrity, or Availability) security impact level.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Base Level (Confidentiality, Integrity, or Availability)&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Base.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.ByComponent class="doc doc-heading"> <code>ByComponent</code> <a href=#trestle.oscal.ssp.ByComponent class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Defines how the referenced component implements a set of controls.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ByComponent</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Defines how the referenced component implements a set of controls.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the component that is implemeting a given control.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Universally Unique Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this by-component entry elsewhere in this or other OSCAL instances. The locally defined UUID of the by-component entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;By-Component Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;An implementation statement that describes how a control or a control statement is implemented within the referenced system component.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span>
+    <span class=n>implementation_status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-status&#39;</span><span class=p>)</span>
+    <span class=n>export</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Export</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies content intended for external consumption, such as with leveraged organizations.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Export&#39;</span>
+    <span class=p>)</span>
+    <span class=n>inherited</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Inherited</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>satisfied</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Satisfied</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.ByComponent-attributes>Attributes<a href=#trestle.oscal.ssp.ByComponent-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.component_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;component-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the component that is implemeting a given control.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component Universally Unique Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.component_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An implementation statement that describes how a control or a control statement is implemented within the referenced system component.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.export class="doc doc-heading"> <code class="highlight language-python"><span class=n>export</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Export</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Identifies content intended for external consumption, such as with leveraged organizations.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Export&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.export class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.implementation_status class="doc doc-heading"> <code class="highlight language-python"><span class=n>implementation_status</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ImplementationStatus</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implementation-status&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.implementation_status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.inherited class="doc doc-heading"> <code class="highlight language-python"><span class=n>inherited</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Inherited</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.inherited class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.satisfied class="doc doc-heading"> <code class="highlight language-python"><span class=n>satisfied</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Satisfied</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.satisfied class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.set_parameters class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.set_parameters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ByComponent.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this by-component entry elsewhere in this or other OSCAL instances. The locally defined UUID of the by-component entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;By-Component Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.ByComponent-classes>Classes<a href=#trestle.oscal.ssp.ByComponent-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.ByComponent.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.ByComponent.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>373</span>
+<span class=normal>374</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.ByComponent.Config-attributes>Attributes<a href=#trestle.oscal.ssp.ByComponent.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.ByComponent.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ByComponent.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Categorization class="doc doc-heading"> <code>Categorization</code> <a href=#trestle.oscal.ssp.Categorization class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A set of information type identifiers qualified by the given identification system used, such as NIST SP 800-60.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Categorization</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A set of information type identifiers qualified by the given identification system used, such as NIST SP 800-60.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>system</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>,</span> <span class=n>System</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Specifies the information type identification system used.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Information Type Identification System&#39;</span>
+    <span class=p>)</span>
+    <span class=n>information_type_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;information-type-ids&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Categorization-attributes>Attributes<a href=#trestle.oscal.ssp.Categorization-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Categorization.information_type_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>information_type_ids</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;information-type-ids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Categorization.information_type_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Categorization.system class="doc doc-heading"> <code class="highlight language-python"><span class=n>system</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=n>AnyUrl</span><span class=p>,</span> <span class=n>System</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Specifies the information type identification system used.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Information Type Identification System&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Categorization.system class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Categorization-classes>Classes<a href=#trestle.oscal.ssp.Categorization-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Categorization.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Categorization.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>357</span>
+<span class=normal>358</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Categorization.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Categorization.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Categorization.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Categorization.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.ControlImplementation class="doc doc-heading"> <code>ControlImplementation</code> <a href=#trestle.oscal.ssp.ControlImplementation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes how the system satisfies a set of controls.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ControlImplementation</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes how the system satisfies a set of controls.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A statement describing important things to know about how this set of control satisfaction documentation is approached.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span>
+    <span class=n>implemented_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.ControlImplementation-attributes>Attributes<a href=#trestle.oscal.ssp.ControlImplementation-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ControlImplementation.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A statement describing important things to know about how this set of control satisfaction documentation is approached.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ControlImplementation.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ControlImplementation.implemented_requirements class="doc doc-heading"> <code class="highlight language-python"><span class=n>implemented_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ImplementedRequirement</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;implemented-requirements&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ControlImplementation.implemented_requirements class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ControlImplementation.set_parameters class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ControlImplementation.set_parameters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.ControlImplementation-classes>Classes<a href=#trestle.oscal.ssp.ControlImplementation-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.ControlImplementation.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.ControlImplementation.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>524</span>
+<span class=normal>525</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.ControlImplementation.Config-attributes>Attributes<a href=#trestle.oscal.ssp.ControlImplementation.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.ControlImplementation.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ControlImplementation.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.DataFlow class="doc doc-heading"> <code>DataFlow</code> <a href=#trestle.oscal.ssp.DataFlow class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A description of the logical flow of information within the system and across its boundaries, optionally supplemented by diagrams that illustrate these flows.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DataFlow</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A description of the logical flow of information within the system and across its boundaries, optionally supplemented by diagrams that illustrate these flows.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the system&#39;s data flow.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Data Flow Description&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>diagrams</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Diagram</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.DataFlow-attributes>Attributes<a href=#trestle.oscal.ssp.DataFlow-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.DataFlow.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the system&#39;s data flow.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Data Flow Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.DataFlow.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.DataFlow.diagrams class="doc doc-heading"> <code class="highlight language-python"><span class=n>diagrams</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Diagram</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.DataFlow.diagrams class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.DataFlow.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.DataFlow.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.DataFlow.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.DataFlow.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.DataFlow.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.DataFlow.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.DataFlow-classes>Classes<a href=#trestle.oscal.ssp.DataFlow-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.DataFlow.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.DataFlow.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>342</span>
+<span class=normal>343</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.DataFlow.Config-attributes>Attributes<a href=#trestle.oscal.ssp.DataFlow.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.DataFlow.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.DataFlow.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.DateAuthorized class="doc doc-heading"> <code>DateAuthorized</code> <a href=#trestle.oscal.ssp.DateAuthorized class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DateAuthorized</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>DateDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date the system received its authorization.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Authorization Date&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.DateAuthorized-attributes>Attributes<a href=#trestle.oscal.ssp.DateAuthorized-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.DateAuthorized.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>DateDatatype</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The date the system received its authorization.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Authorization Date&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.DateAuthorized.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.DateDatatype class="doc doc-heading"> <code>DateDatatype</code> <a href=#trestle.oscal.ssp.DateDatatype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>DateDatatype</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^(((2000|2400|2800|(19|2[0-9](0[48]|[2468][048]|[13579][26])))-02-29)|(((19|2[0-9])[0-9]</span><span class=si>{2}</span><span class=s1>)-02-(0[1-9]|1[0-9]|2[0-8]))|(((19|2[0-9])[0-9]</span><span class=si>{2}</span><span class=s1>)-(0[13578]|10|12)-(0[1-9]|[12][0-9]|3[01]))|(((19|2[0-9])[0-9]</span><span class=si>{2}</span><span class=s1>)-(0[469]|11)-(0[1-9]|[12][0-9]|30)))(Z|(-((0[0-9]|1[0-2]):00|0[39]:30)|\+((0[0-9]|1[0-4]):00|(0[34569]|10):30|(0[58]|12):45)))?$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A string representing a 24-hour period with an optional timezone.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.DateDatatype-attributes>Attributes<a href=#trestle.oscal.ssp.DateDatatype-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.DateDatatype.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^(((2000|2400|2800|(19|2[0-9](0[48]|[2468][048]|[13579][26])))-02-29)|(((19|2[0-9])[0-9]</span><span class=si>{2}</span><span class=s1>)-02-(0[1-9]|1[0-9]|2[0-8]))|(((19|2[0-9])[0-9]</span><span class=si>{2}</span><span class=s1>)-(0[13578]|10|12)-(0[1-9]|[12][0-9]|3[01]))|(((19|2[0-9])[0-9]</span><span class=si>{2}</span><span class=s1>)-(0[469]|11)-(0[1-9]|[12][0-9]|30)))(Z|(-((0[0-9]|1[0-2]):00|0[39]:30)|</span><span class=se>\\</span><span class=s1>+((0[0-9]|1[0-4]):00|(0[34569]|10):30|(0[58]|12):45)))?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A string representing a 24-hour period with an optional timezone.&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.DateDatatype.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Diagram class="doc doc-heading"> <code>Diagram</code> <a href=#trestle.oscal.ssp.Diagram class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A graphic that provides a visual representation the system, or some aspect of it.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Diagram</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A graphic that provides a visual representation the system, or some aspect of it.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this diagram elsewhere in this or other OSCAL instances. The locally defined UUID of the diagram can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Diagram ID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the diagram.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Diagram Description&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>caption</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A brief caption to annotate the diagram.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Caption&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Diagram-attributes>Attributes<a href=#trestle.oscal.ssp.Diagram-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Diagram.caption class="doc doc-heading"> <code class="highlight language-python"><span class=n>caption</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A brief caption to annotate the diagram.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Caption&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Diagram.caption class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Diagram.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the diagram.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Diagram Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Diagram.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Diagram.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Diagram.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Diagram.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Diagram.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Diagram.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Diagram.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Diagram.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this diagram elsewhere in this or other OSCAL instances. The locally defined UUID of the diagram can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Diagram ID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Diagram.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Diagram-classes>Classes<a href=#trestle.oscal.ssp.Diagram-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Diagram.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Diagram.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>306</span>
+<span class=normal>307</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Diagram.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Diagram.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Diagram.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Diagram.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Export class="doc doc-heading"> <code>Export</code> <a href=#trestle.oscal.ssp.Export class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies content intended for external consumption, such as with leveraged organizations.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Export</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies content intended for external consumption, such as with leveraged organizations.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;An implementation statement that describes the aspects of the control or control statement implementation that can be available to another system leveraging this system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Export Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>provided</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Provided</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsibilities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Responsibility</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Export-attributes>Attributes<a href=#trestle.oscal.ssp.Export-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Export.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An implementation statement that describes the aspects of the control or control statement implementation that can be available to another system leveraging this system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Export Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Export.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Export.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Export.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Export.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Export.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Export.provided class="doc doc-heading"> <code class="highlight language-python"><span class=n>provided</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Provided</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Export.provided class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Export.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Export.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Export.responsibilities class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsibilities</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Responsibility</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Export.responsibilities class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Export-classes>Classes<a href=#trestle.oscal.ssp.Export-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Export.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Export.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>285</span>
+<span class=normal>286</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Export.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Export.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Export.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Export.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Impact class="doc doc-heading"> <code>Impact</code> <a href=#trestle.oscal.ssp.Impact class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The expected level of impact resulting from the described information.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Impact</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The expected level of impact resulting from the described information.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>base</span><span class=p>:</span> <span class=n>Base</span>
+    <span class=n>selected</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Selected</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>adjustment_justification</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AdjustmentJustification</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;adjustment-justification&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Impact-attributes>Attributes<a href=#trestle.oscal.ssp.Impact-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Impact.adjustment_justification class="doc doc-heading"> <code class="highlight language-python"><span class=n>adjustment_justification</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>AdjustmentJustification</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;adjustment-justification&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Impact.adjustment_justification class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Impact.base class="doc doc-heading"> <code class="highlight language-python"><span class=n>base</span><span class=p>:</span> <span class=n>Base</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Impact.base class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Impact.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Impact.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Impact.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Impact.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Impact.selected class="doc doc-heading"> <code class="highlight language-python"><span class=n>selected</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Selected</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Impact.selected class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Impact-classes>Classes<a href=#trestle.oscal.ssp.Impact-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Impact.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Impact.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>611</span>
+<span class=normal>612</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Impact.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Impact.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Impact.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Impact.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.ImplementedRequirement class="doc doc-heading"> <code>ImplementedRequirement</code> <a href=#trestle.oscal.ssp.ImplementedRequirement class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes how the system satisfies the requirements of an individual control.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ImplementedRequirement</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes how the system satisfies the requirements of an individual control.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control requirement elsewhere in this or other OSCAL instances. The locally defined UUID of the control requirement can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Requirement Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>statements</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Statement</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>by_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-components&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.ImplementedRequirement-attributes>Attributes<a href=#trestle.oscal.ssp.ImplementedRequirement-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.by_components class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-components&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.by_components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Identifier Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.control_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.set_parameters class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_parameters</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;set-parameters&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.set_parameters class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.statements class="doc doc-heading"> <code class="highlight language-python"><span class=n>statements</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Statement</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.statements class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control requirement elsewhere in this or other OSCAL instances. The locally defined UUID of the control requirement can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Requirement Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.ImplementedRequirement-classes>Classes<a href=#trestle.oscal.ssp.ImplementedRequirement-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.ImplementedRequirement.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.ImplementedRequirement.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>489</span>
+<span class=normal>490</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.ImplementedRequirement.Config-attributes>Attributes<a href=#trestle.oscal.ssp.ImplementedRequirement.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.ImplementedRequirement.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImplementedRequirement.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.ImportProfile class="doc doc-heading"> <code>ImportProfile</code> <a href=#trestle.oscal.ssp.ImportProfile class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Used to import the OSCAL profile representing the system's control baseline.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ImportProfile</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Used to import the OSCAL profile representing the system&#39;s control baseline.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A resolvable URL reference to the profile or catalog to use as the system&#39;s control baseline.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Profile Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.ImportProfile-attributes>Attributes<a href=#trestle.oscal.ssp.ImportProfile-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImportProfile.href class="doc doc-heading"> <code class="highlight language-python"><span class=n>href</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A resolvable URL reference to the profile or catalog to use as the system&#39;s control baseline.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Profile Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImportProfile.href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.ImportProfile.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImportProfile.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.ImportProfile-classes>Classes<a href=#trestle.oscal.ssp.ImportProfile-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.ImportProfile.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.ImportProfile.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>269</span>
+<span class=normal>270</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.ImportProfile.Config-attributes>Attributes<a href=#trestle.oscal.ssp.ImportProfile.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.ImportProfile.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.ImportProfile.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.InformationType class="doc doc-heading"> <code>InformationType</code> <a href=#trestle.oscal.ssp.InformationType class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Contains details about one information type that is stored, processed, or transmitted by the system, such as privacy information, and those defined in NIST SP 800-60.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>InformationType</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Contains details about one information type that is stored, processed, or transmitted by the system, such as privacy information, and those defined in NIST SP 800-60.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this information type elsewhere in this or other OSCAL instances. The locally defined UUID of the information type can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Information Type Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A human readable name for the information type. This title should be meaningful within the context of the system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;title field&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of how this information type is used within the system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Information Type Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>categorizations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Categorization</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>confidentiality_impact</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Impact</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;confidentiality-impact&#39;</span><span class=p>)</span>
+    <span class=n>integrity_impact</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Impact</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;integrity-impact&#39;</span><span class=p>)</span>
+    <span class=n>availability_impact</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Impact</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;availability-impact&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.InformationType-attributes>Attributes<a href=#trestle.oscal.ssp.InformationType-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.InformationType.availability_impact class="doc doc-heading"> <code class="highlight language-python"><span class=n>availability_impact</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Impact</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;availability-impact&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.availability_impact class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.InformationType.categorizations class="doc doc-heading"> <code class="highlight language-python"><span class=n>categorizations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Categorization</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.categorizations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.InformationType.confidentiality_impact class="doc doc-heading"> <code class="highlight language-python"><span class=n>confidentiality_impact</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Impact</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;confidentiality-impact&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.confidentiality_impact class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.InformationType.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of how this information type is used within the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Information Type Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.InformationType.integrity_impact class="doc doc-heading"> <code class="highlight language-python"><span class=n>integrity_impact</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Impact</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;integrity-impact&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.integrity_impact class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.InformationType.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.InformationType.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.InformationType.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the information type. This title should be meaningful within the context of the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;title field&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.InformationType.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this information type elsewhere in this or other OSCAL instances. The locally defined UUID of the information type can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Information Type Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.InformationType-classes>Classes<a href=#trestle.oscal.ssp.InformationType-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.InformationType.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.InformationType.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>626</span>
+<span class=normal>627</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.InformationType.Config-attributes>Attributes<a href=#trestle.oscal.ssp.InformationType.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.InformationType.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.InformationType.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Inherited class="doc doc-heading"> <code>Inherited</code> <a href=#trestle.oscal.ssp.Inherited class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes a control implementation inherited by a leveraging system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Inherited</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes a control implementation inherited by a leveraging system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this inherited entry elsewhere in this or other OSCAL instances. The locally defined UUID of the inherited control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Inherited Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>provided_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;provided-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented identifier reference to an inherited control implementation that a leveraging system is inheriting from a leveraged system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Provided UUID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;An implementation statement that describes the aspects of a control or control statement implementation that a leveraging system is inheriting from a leveraged system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Inherited Control Implementation Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Inherited-attributes>Attributes<a href=#trestle.oscal.ssp.Inherited-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Inherited.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An implementation statement that describes the aspects of a control or control statement implementation that a leveraging system is inheriting from a leveraged system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Inherited Control Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Inherited.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Inherited.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Inherited.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Inherited.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Inherited.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Inherited.provided_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>provided_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;provided-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to an inherited control implementation that a leveraging system is inheriting from a leveraged system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Provided UUID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Inherited.provided_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Inherited.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Inherited.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Inherited.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this inherited entry elsewhere in this or other OSCAL instances. The locally defined UUID of the inherited control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Inherited Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Inherited.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Inherited-classes>Classes<a href=#trestle.oscal.ssp.Inherited-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Inherited.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Inherited.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>233</span>
+<span class=normal>234</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Inherited.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Inherited.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Inherited.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Inherited.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.LeveragedAuthorization class="doc doc-heading"> <code>LeveragedAuthorization</code> <a href=#trestle.oscal.ssp.LeveragedAuthorization class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A description of another authorized system from which this system inherits capabilities that satisfy security requirements. Another term for this concept is a common control provider.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>LeveragedAuthorization</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A description of another authorized system from which this system inherits capabilities that satisfy security requirements. Another term for this concept is a common control provider.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope and can be used to reference this leveraged authorization elsewhere in this or other OSCAL instances. The locally defined UUID of the leveraged authorization can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Leveraged Authorization Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the leveraged authorization in the context of the system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;title field&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>party_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;party-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the party that manages the leveraged system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;party-uuid field&#39;</span>
+    <span class=p>)</span>
+    <span class=n>date_authorized</span><span class=p>:</span> <span class=n>DateAuthorized</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;date-authorized&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.LeveragedAuthorization-attributes>Attributes<a href=#trestle.oscal.ssp.LeveragedAuthorization-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.LeveragedAuthorization.date_authorized class="doc doc-heading"> <code class="highlight language-python"><span class=n>date_authorized</span><span class=p>:</span> <span class=n>DateAuthorized</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;date-authorized&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.LeveragedAuthorization.date_authorized class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.LeveragedAuthorization.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.LeveragedAuthorization.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.LeveragedAuthorization.party_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>party_uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;party-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to the party that manages the leveraged system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;party-uuid field&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.LeveragedAuthorization.party_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.LeveragedAuthorization.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.LeveragedAuthorization.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.LeveragedAuthorization.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.LeveragedAuthorization.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.LeveragedAuthorization.title class="doc doc-heading"> <code class="highlight language-python"><span class=n>title</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human readable name for the leveraged authorization in the context of the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;title field&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.LeveragedAuthorization.title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.LeveragedAuthorization.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope and can be used to reference this leveraged authorization elsewhere in this or other OSCAL instances. The locally defined UUID of the leveraged authorization can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Leveraged Authorization Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.LeveragedAuthorization.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.LeveragedAuthorization-classes>Classes<a href=#trestle.oscal.ssp.LeveragedAuthorization-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.LeveragedAuthorization.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.LeveragedAuthorization.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>559</span>
+<span class=normal>560</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.LeveragedAuthorization.Config-attributes>Attributes<a href=#trestle.oscal.ssp.LeveragedAuthorization.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.LeveragedAuthorization.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.LeveragedAuthorization.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Model class="doc doc-heading"> <code>Model</code> <a href=#trestle.oscal.ssp.Model class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>732</span>
+<span class=normal>733</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Model</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>system_security_plan</span><span class=p>:</span> <span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-security-plan&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Model-attributes>Attributes<a href=#trestle.oscal.ssp.Model-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Model.system_security_plan class="doc doc-heading"> <code class="highlight language-python"><span class=n>system_security_plan</span><span class=p>:</span> <span class=n>SystemSecurityPlan</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-security-plan&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Model.system_security_plan class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.NetworkArchitecture class="doc doc-heading"> <code>NetworkArchitecture</code> <a href=#trestle.oscal.ssp.NetworkArchitecture class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A description of the system's network architecture, optionally supplemented by diagrams that illustrate the network architecture.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>NetworkArchitecture</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A description of the system&#39;s network architecture, optionally supplemented by diagrams that illustrate the network architecture.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the system&#39;s network architecture.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Network Architecture Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>diagrams</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Diagram</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.NetworkArchitecture-attributes>Attributes<a href=#trestle.oscal.ssp.NetworkArchitecture-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.NetworkArchitecture.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A summary of the system&#39;s network architecture.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Network Architecture Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.NetworkArchitecture.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.NetworkArchitecture.diagrams class="doc doc-heading"> <code class="highlight language-python"><span class=n>diagrams</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Diagram</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.NetworkArchitecture.diagrams class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.NetworkArchitecture.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.NetworkArchitecture.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.NetworkArchitecture.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.NetworkArchitecture.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.NetworkArchitecture.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.NetworkArchitecture.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.NetworkArchitecture-classes>Classes<a href=#trestle.oscal.ssp.NetworkArchitecture-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.NetworkArchitecture.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.NetworkArchitecture.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>542</span>
+<span class=normal>543</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.NetworkArchitecture.Config-attributes>Attributes<a href=#trestle.oscal.ssp.NetworkArchitecture.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.NetworkArchitecture.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.NetworkArchitecture.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.OperationalStateValidValues class="doc doc-heading"> <code>OperationalStateValidValues</code> <a href=#trestle.oscal.ssp.OperationalStateValidValues class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OperationalStateValidValues</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+    <span class=n>operational</span> <span class=o>=</span> <span class=s1>&#39;operational&#39;</span>
+    <span class=n>under_development</span> <span class=o>=</span> <span class=s1>&#39;under-development&#39;</span>
+    <span class=n>under_major_modification</span> <span class=o>=</span> <span class=s1>&#39;under-major-modification&#39;</span>
+    <span class=n>disposition</span> <span class=o>=</span> <span class=s1>&#39;disposition&#39;</span>
+    <span class=n>other</span> <span class=o>=</span> <span class=s1>&#39;other&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.OperationalStateValidValues-attributes>Attributes<a href=#trestle.oscal.ssp.OperationalStateValidValues-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.OperationalStateValidValues.disposition class="doc doc-heading"> <code class="highlight language-python"><span class=n>disposition</span> <span class=o>=</span> <span class=s1>&#39;disposition&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.OperationalStateValidValues.disposition class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.OperationalStateValidValues.operational class="doc doc-heading"> <code class="highlight language-python"><span class=n>operational</span> <span class=o>=</span> <span class=s1>&#39;operational&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.OperationalStateValidValues.operational class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.OperationalStateValidValues.other class="doc doc-heading"> <code class="highlight language-python"><span class=n>other</span> <span class=o>=</span> <span class=s1>&#39;other&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.OperationalStateValidValues.other class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.OperationalStateValidValues.under_development class="doc doc-heading"> <code class="highlight language-python"><span class=n>under_development</span> <span class=o>=</span> <span class=s1>&#39;under-development&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.OperationalStateValidValues.under_development class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.OperationalStateValidValues.under_major_modification class="doc doc-heading"> <code class="highlight language-python"><span class=n>under_major_modification</span> <span class=o>=</span> <span class=s1>&#39;under-major-modification&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.OperationalStateValidValues.under_major_modification class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Provided class="doc doc-heading"> <code>Provided</code> <a href=#trestle.oscal.ssp.Provided class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes a capability which may be inherited by a leveraging system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Provided</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes a capability which may be inherited by a leveraging system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this provided entry elsewhere in this or other OSCAL instances. The locally defined UUID of the provided entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Provided Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;An implementation statement that describes the aspects of the control or control statement implementation that can be provided to another system leveraging this system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Provided Control Implementation Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Provided-attributes>Attributes<a href=#trestle.oscal.ssp.Provided-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Provided.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An implementation statement that describes the aspects of the control or control statement implementation that can be provided to another system leveraging this system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Provided Control Implementation Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Provided.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Provided.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Provided.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Provided.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Provided.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Provided.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Provided.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Provided.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Provided.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Provided.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this provided entry elsewhere in this or other OSCAL instances. The locally defined UUID of the provided entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Provided Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Provided.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Provided-classes>Classes<a href=#trestle.oscal.ssp.Provided-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Provided.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Provided.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>197</span>
+<span class=normal>198</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Provided.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Provided.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Provided.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Provided.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Responsibility class="doc doc-heading"> <code>Responsibility</code> <a href=#trestle.oscal.ssp.Responsibility class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes a control implementation responsibility imposed on a leveraging system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Responsibility</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes a control implementation responsibility imposed on a leveraging system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this responsibility elsewhere in this or other OSCAL instances. The locally defined UUID of the responsibility can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Responsibility Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>provided_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;provided-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented identifier reference to an inherited control implementation that a leveraging system is inheriting from a leveraged system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Provided UUID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;An implementation statement that describes the aspects of the control or control statement implementation that a leveraging system must implement to satisfy the control provided by a leveraged system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Responsibility Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Responsibility-attributes>Attributes<a href=#trestle.oscal.ssp.Responsibility-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Responsibility.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An implementation statement that describes the aspects of the control or control statement implementation that a leveraging system must implement to satisfy the control provided by a leveraged system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Implementation Responsibility Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Responsibility.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Responsibility.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Responsibility.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Responsibility.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Responsibility.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Responsibility.provided_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>provided_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;provided-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to an inherited control implementation that a leveraging system is inheriting from a leveraged system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Provided UUID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Responsibility.provided_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Responsibility.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Responsibility.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Responsibility.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Responsibility.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Responsibility.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this responsibility elsewhere in this or other OSCAL instances. The locally defined UUID of the responsibility can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Responsibility Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Responsibility.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Responsibility-classes>Classes<a href=#trestle.oscal.ssp.Responsibility-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Responsibility.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Responsibility.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>160</span>
+<span class=normal>161</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Responsibility.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Responsibility.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Responsibility.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Responsibility.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Satisfied class="doc doc-heading"> <code>Satisfied</code> <a href=#trestle.oscal.ssp.Satisfied class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes how this system satisfies a responsibility imposed by a leveraged system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Satisfied</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes how this system satisfies a responsibility imposed by a leveraged system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this satisfied control implementation entry elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Satisfied Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>responsibility_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsibility-uuid&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented identifier reference to a control implementation that satisfies a responsibility imposed by a leveraged system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Responsibility UUID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;An implementation statement that describes the aspects of a control or control statement implementation that a leveraging system is implementing based on a requirement from a leveraged system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Satisfied Control Implementation Responsibility Description&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Satisfied-attributes>Attributes<a href=#trestle.oscal.ssp.Satisfied-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Satisfied.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;An implementation statement that describes the aspects of a control or control statement implementation that a leveraging system is implementing based on a requirement from a leveraged system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Satisfied Control Implementation Responsibility Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Satisfied.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Satisfied.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Satisfied.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Satisfied.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Satisfied.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Satisfied.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Satisfied.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Satisfied.responsibility_uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsibility_uuid</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsibility-uuid&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented identifier reference to a control implementation that satisfies a responsibility imposed by a leveraged system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Responsibility UUID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Satisfied.responsibility_uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Satisfied.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Satisfied.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Satisfied.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this satisfied control implementation entry elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Satisfied Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Satisfied.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Satisfied-classes>Classes<a href=#trestle.oscal.ssp.Satisfied-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Satisfied.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Satisfied.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>123</span>
+<span class=normal>124</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Satisfied.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Satisfied.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Satisfied.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Satisfied.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.SecurityImpactLevel class="doc doc-heading"> <code>SecurityImpactLevel</code> <a href=#trestle.oscal.ssp.SecurityImpactLevel class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>The overall level of expected impact resulting from unauthorized disclosure, modification, or loss of access to information.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SecurityImpactLevel</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    The overall level of expected impact resulting from unauthorized disclosure, modification, or loss of access to information.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>security_objective_confidentiality</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-objective-confidentiality&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A target-level of confidentiality for the system, based on the sensitivity of information within the system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Security Objective: Confidentiality&#39;</span>
+    <span class=p>)</span>
+    <span class=n>security_objective_integrity</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-objective-integrity&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A target-level of integrity for the system, based on the sensitivity of information within the system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Security Objective: Integrity&#39;</span>
+    <span class=p>)</span>
+    <span class=n>security_objective_availability</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-objective-availability&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A target-level of availability for the system, based on the sensitivity of information within the system.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Security Objective: Availability&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.SecurityImpactLevel-attributes>Attributes<a href=#trestle.oscal.ssp.SecurityImpactLevel-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SecurityImpactLevel.security_objective_availability class="doc doc-heading"> <code class="highlight language-python"><span class=n>security_objective_availability</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-objective-availability&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A target-level of availability for the system, based on the sensitivity of information within the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Security Objective: Availability&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SecurityImpactLevel.security_objective_availability class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SecurityImpactLevel.security_objective_confidentiality class="doc doc-heading"> <code class="highlight language-python"><span class=n>security_objective_confidentiality</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-objective-confidentiality&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A target-level of confidentiality for the system, based on the sensitivity of information within the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Security Objective: Confidentiality&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SecurityImpactLevel.security_objective_confidentiality class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SecurityImpactLevel.security_objective_integrity class="doc doc-heading"> <code class="highlight language-python"><span class=n>security_objective_integrity</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-objective-integrity&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A target-level of integrity for the system, based on the sensitivity of information within the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Security Objective: Integrity&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SecurityImpactLevel.security_objective_integrity class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.SecurityImpactLevel-classes>Classes<a href=#trestle.oscal.ssp.SecurityImpactLevel-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.SecurityImpactLevel.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.SecurityImpactLevel.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>92</span>
+<span class=normal>93</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.SecurityImpactLevel.Config-attributes>Attributes<a href=#trestle.oscal.ssp.SecurityImpactLevel.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.SecurityImpactLevel.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SecurityImpactLevel.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Selected class="doc doc-heading"> <code>Selected</code> <a href=#trestle.oscal.ssp.Selected class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Selected</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The selected (Confidentiality, Integrity, or Availability) security impact level.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Selected Level (Confidentiality, Integrity, or Availability)&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Selected-attributes>Attributes<a href=#trestle.oscal.ssp.Selected-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Selected.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The selected (Confidentiality, Integrity, or Availability) security impact level.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Selected Level (Confidentiality, Integrity, or Availability)&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Selected.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.SetParameter class="doc doc-heading"> <code>SetParameter</code> <a href=#trestle.oscal.ssp.SetParameter class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies the parameter that will be set by the enclosed value.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SetParameter</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies the parameter that will be set by the enclosed value.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>param_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;param-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s2>&quot;A human-oriented reference to a parameter within a control, who&#39;s catalog has been imported into the current implementation context.&quot;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter ID&#39;</span>
+    <span class=p>)</span>
+    <span class=n>values</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.SetParameter-attributes>Attributes<a href=#trestle.oscal.ssp.SetParameter-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SetParameter.param_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>param_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;param-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s2>&quot;A human-oriented reference to a parameter within a control, who&#39;s catalog has been imported into the current implementation context.&quot;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Parameter ID&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SetParameter.param_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SetParameter.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SetParameter.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SetParameter.values class="doc doc-heading"> <code class="highlight language-python"><span class=n>values</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SetParameter.values class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.SetParameter-classes>Classes<a href=#trestle.oscal.ssp.SetParameter-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.SetParameter.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.SetParameter.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>62</span>
+<span class=normal>63</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.SetParameter.Config-attributes>Attributes<a href=#trestle.oscal.ssp.SetParameter.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.SetParameter.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SetParameter.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Statement class="doc doc-heading"> <code>Statement</code> <a href=#trestle.oscal.ssp.Statement class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Identifies which statements within a control are addressed.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Statement</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Identifies which statements within a control are addressed.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>statement_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span>
+        <span class=sa>r</span><span class=s1>&#39;^[_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD][_A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02FF\u0370-\u037D\u037F-\u1FFF\u200C-\u200D\u2070-\u218F\u2C00-\u2FEF\u3001-\uD7FF\uF900-\uFDCF\uFDF0-\uFFFD\-\.0-9\u00B7\u0300-\u036F\u203F-\u2040]*$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;statement-id&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-oriented identifier reference to a control statement.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference&#39;</span>
+    <span class=p>)</span>
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference Universally Unique Identifier&#39;</span>
+    <span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span>
+    <span class=n>by_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-components&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Statement-attributes>Attributes<a href=#trestle.oscal.ssp.Statement-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Statement.by_components class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_components</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>ByComponent</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;by-components&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Statement.by_components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Statement.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Statement.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Statement.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Statement.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Statement.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Statement.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Statement.responsible_roles class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_roles</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleRole</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-roles&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Statement.responsible_roles class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Statement.statement_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>statement_id</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD][_A-Za-z</span><span class=se>\\</span><span class=s1>u00C0-</span><span class=se>\\</span><span class=s1>u00D6</span><span class=se>\\</span><span class=s1>u00D8-</span><span class=se>\\</span><span class=s1>u00F6</span><span class=se>\\</span><span class=s1>u00F8-</span><span class=se>\\</span><span class=s1>u02FF</span><span class=se>\\</span><span class=s1>u0370-</span><span class=se>\\</span><span class=s1>u037D</span><span class=se>\\</span><span class=s1>u037F-</span><span class=se>\\</span><span class=s1>u1FFF</span><span class=se>\\</span><span class=s1>u200C-</span><span class=se>\\</span><span class=s1>u200D</span><span class=se>\\</span><span class=s1>u2070-</span><span class=se>\\</span><span class=s1>u218F</span><span class=se>\\</span><span class=s1>u2C00-</span><span class=se>\\</span><span class=s1>u2FEF</span><span class=se>\\</span><span class=s1>u3001-</span><span class=se>\\</span><span class=s1>uD7FF</span><span class=se>\\</span><span class=s1>uF900-</span><span class=se>\\</span><span class=s1>uFDCF</span><span class=se>\\</span><span class=s1>uFDF0-</span><span class=se>\\</span><span class=s1>uFFFD</span><span class=se>\\</span><span class=s1>-</span><span class=se>\\</span><span class=s1>.0-9</span><span class=se>\\</span><span class=s1>u00B7</span><span class=se>\\</span><span class=s1>u0300-</span><span class=se>\\</span><span class=s1>u036F</span><span class=se>\\</span><span class=s1>u203F-</span><span class=se>\\</span><span class=s1>u2040]*$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;statement-id&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A human-oriented identifier reference to a control statement.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Statement.statement_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Statement.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Control Statement Reference Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Statement.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Statement-classes>Classes<a href=#trestle.oscal.ssp.Statement-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Statement.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Statement.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>457</span>
+<span class=normal>458</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Statement.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Statement.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Statement.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Statement.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.Status1 class="doc doc-heading"> <code>Status1</code> <a href=#trestle.oscal.ssp.Status1 class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Describes the operational status of the system.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Status1</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Describes the operational status of the system.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>state</span><span class=p>:</span> <span class=n>OperationalStateValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The current operating status.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;State&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.Status1-attributes>Attributes<a href=#trestle.oscal.ssp.Status1-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Status1.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Status1.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.Status1.state class="doc doc-heading"> <code class="highlight language-python"><span class=n>state</span><span class=p>:</span> <span class=n>OperationalStateValidValues</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The current operating status.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;State&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Status1.state class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.Status1-classes>Classes<a href=#trestle.oscal.ssp.Status1-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.Status1.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.Status1.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>445</span>
+<span class=normal>446</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.Status1.Config-attributes>Attributes<a href=#trestle.oscal.ssp.Status1.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.Status1.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.Status1.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.System class="doc doc-heading"> <code>System</code> <a href=#trestle.oscal.ssp.System class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Specifies the information type identification system used.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>System</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Specifies the information type identification system used.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>http___doi_org_10_6028_NIST_SP_800_60v2r1</span> <span class=o>=</span> <span class=s1>&#39;http://doi.org/10.6028/NIST.SP.800-60v2r1&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.System-attributes>Attributes<a href=#trestle.oscal.ssp.System-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.System.http___doi_org_10_6028_NIST_SP_800_60v2r1 class="doc doc-heading"> <code class="highlight language-python"><span class=n>http___doi_org_10_6028_NIST_SP_800_60v2r1</span> <span class=o>=</span> <span class=s1>&#39;http://doi.org/10.6028/NIST.SP.800-60v2r1&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.System.http___doi_org_10_6028_NIST_SP_800_60v2r1 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.SystemCharacteristics class="doc doc-heading"> <code>SystemCharacteristics</code> <a href=#trestle.oscal.ssp.SystemCharacteristics class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Contains the characteristics of the system, such as its name, purpose, and security impact level.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span>
+<span class=normal>672</span>
+<span class=normal>673</span>
+<span class=normal>674</span>
+<span class=normal>675</span>
+<span class=normal>676</span>
+<span class=normal>677</span>
+<span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span>
+<span class=normal>685</span>
+<span class=normal>686</span>
+<span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span>
+<span class=normal>700</span>
+<span class=normal>701</span>
+<span class=normal>702</span>
+<span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SystemCharacteristics</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Contains the characteristics of the system, such as its name, purpose, and security impact level.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>system_ids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemId</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-ids&#39;</span><span class=p>)</span>
+    <span class=n>system_name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-name&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The full name of the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Name - Full&#39;</span><span class=p>)</span>
+    <span class=n>system_name_short</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-name-short&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A short name for the system, such as an acronym, that is suitable for display in a data table or summary list.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Name - Short&#39;</span>
+    <span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Description&#39;</span><span class=p>)</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>date_authorized</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>DateAuthorized</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;date-authorized&#39;</span><span class=p>)</span>
+    <span class=n>security_sensitivity_level</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^\S(.*\S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=kc>None</span><span class=p>,</span>
+        <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-sensitivity-level&#39;</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The overall information system sensitivity categorization, such as defined by FIPS-199.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Security Sensitivity Level&#39;</span>
+    <span class=p>)</span>
+    <span class=n>system_information</span><span class=p>:</span> <span class=n>SystemInformation</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-information&#39;</span><span class=p>)</span>
+    <span class=n>security_impact_level</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>SecurityImpactLevel</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-impact-level&#39;</span><span class=p>)</span>
+    <span class=n>status</span><span class=p>:</span> <span class=n>Status1</span>
+    <span class=n>authorization_boundary</span><span class=p>:</span> <span class=n>AuthorizationBoundary</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;authorization-boundary&#39;</span><span class=p>)</span>
+    <span class=n>network_architecture</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>NetworkArchitecture</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;network-architecture&#39;</span><span class=p>)</span>
+    <span class=n>data_flow</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>DataFlow</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;data-flow&#39;</span><span class=p>)</span>
+    <span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.SystemCharacteristics-attributes>Attributes<a href=#trestle.oscal.ssp.SystemCharacteristics-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.authorization_boundary class="doc doc-heading"> <code class="highlight language-python"><span class=n>authorization_boundary</span><span class=p>:</span> <span class=n>AuthorizationBoundary</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;authorization-boundary&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.authorization_boundary class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.data_flow class="doc doc-heading"> <code class="highlight language-python"><span class=n>data_flow</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>DataFlow</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;data-flow&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.data_flow class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.date_authorized class="doc doc-heading"> <code class="highlight language-python"><span class=n>date_authorized</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>DateAuthorized</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;date-authorized&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.date_authorized class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A summary of the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Description&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.network_architecture class="doc doc-heading"> <code class="highlight language-python"><span class=n>network_architecture</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>NetworkArchitecture</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;network-architecture&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.network_architecture class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.responsible_parties class="doc doc-heading"> <code class="highlight language-python"><span class=n>responsible_parties</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>ResponsibleParty</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;responsible-parties&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.responsible_parties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.security_impact_level class="doc doc-heading"> <code class="highlight language-python"><span class=n>security_impact_level</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>SecurityImpactLevel</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-impact-level&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.security_impact_level class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.security_sensitivity_level class="doc doc-heading"> <code class="highlight language-python"><span class=n>security_sensitivity_level</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;security-sensitivity-level&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The overall information system sensitivity categorization, such as defined by FIPS-199.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Security Sensitivity Level&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.security_sensitivity_level class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.status class="doc doc-heading"> <code class="highlight language-python"><span class=n>status</span><span class=p>:</span> <span class=n>Status1</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.status class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.system_ids class="doc doc-heading"> <code class="highlight language-python"><span class=n>system_ids</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemId</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-ids&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_ids class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.system_information class="doc doc-heading"> <code class="highlight language-python"><span class=n>system_information</span><span class=p>:</span> <span class=n>SystemInformation</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-information&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_information class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.system_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>system_name</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-name&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;The full name of the system.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Name - Full&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.system_name_short class="doc doc-heading"> <code class="highlight language-python"><span class=n>system_name_short</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^</span><span class=se>\\</span><span class=s1>S(.*</span><span class=se>\\</span><span class=s1>S)?$&#39;</span><span class=p>)]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-name-short&#39;</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A short name for the system, such as an acronym, that is suitable for display in a data table or summary list.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Name - Short&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.system_name_short class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.SystemCharacteristics-classes>Classes<a href=#trestle.oscal.ssp.SystemCharacteristics-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.SystemCharacteristics.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.SystemCharacteristics.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>674</span>
+<span class=normal>675</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.SystemCharacteristics.Config-attributes>Attributes<a href=#trestle.oscal.ssp.SystemCharacteristics.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.SystemCharacteristics.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemCharacteristics.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.SystemImplementation class="doc doc-heading"> <code>SystemImplementation</code> <a href=#trestle.oscal.ssp.SystemImplementation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Provides information as to how the system is implemented.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SystemImplementation</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Provides information as to how the system is implemented.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>leveraged_authorizations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>LeveragedAuthorization</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;leveraged-authorizations&#39;</span><span class=p>)</span>
+    <span class=n>users</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemUser</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span>
+    <span class=n>inventory_items</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>InventoryItem</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;inventory-items&#39;</span><span class=p>)</span>
+    <span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.SystemImplementation-attributes>Attributes<a href=#trestle.oscal.ssp.SystemImplementation-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemImplementation.components class="doc doc-heading"> <code class="highlight language-python"><span class=n>components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemImplementation.components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemImplementation.inventory_items class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory_items</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>InventoryItem</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;inventory-items&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemImplementation.inventory_items class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemImplementation.leveraged_authorizations class="doc doc-heading"> <code class="highlight language-python"><span class=n>leveraged_authorizations</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>LeveragedAuthorization</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;leveraged-authorizations&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemImplementation.leveraged_authorizations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemImplementation.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemImplementation.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemImplementation.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemImplementation.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemImplementation.remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>remarks</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemImplementation.remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemImplementation.users class="doc doc-heading"> <code class="highlight language-python"><span class=n>users</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>SystemUser</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemImplementation.users class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.SystemImplementation-classes>Classes<a href=#trestle.oscal.ssp.SystemImplementation-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.SystemImplementation.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.SystemImplementation.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>594</span>
+<span class=normal>595</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.SystemImplementation.Config-attributes>Attributes<a href=#trestle.oscal.ssp.SystemImplementation.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.SystemImplementation.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemImplementation.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.SystemInformation class="doc doc-heading"> <code>SystemInformation</code> <a href=#trestle.oscal.ssp.SystemInformation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Contains details about all information types that are stored, processed, or transmitted by the system, such as privacy information, and those defined in NIST SP 800-60.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>656</span>
+<span class=normal>657</span>
+<span class=normal>658</span>
+<span class=normal>659</span>
+<span class=normal>660</span>
+<span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span>
+<span class=normal>664</span>
+<span class=normal>665</span>
+<span class=normal>666</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SystemInformation</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Contains details about all information types that are stored, processed, or transmitted by the system, such as privacy information, and those defined in NIST SP 800-60.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>information_types</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>InformationType</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;information-types&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.SystemInformation-attributes>Attributes<a href=#trestle.oscal.ssp.SystemInformation-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemInformation.information_types class="doc doc-heading"> <code class="highlight language-python"><span class=n>information_types</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>InformationType</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;information-types&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemInformation.information_types class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemInformation.links class="doc doc-heading"> <code class="highlight language-python"><span class=n>links</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Link</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemInformation.links class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemInformation.props class="doc doc-heading"> <code class="highlight language-python"><span class=n>props</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemInformation.props class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.SystemInformation-classes>Classes<a href=#trestle.oscal.ssp.SystemInformation-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.SystemInformation.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.SystemInformation.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>661</span>
+<span class=normal>662</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.SystemInformation.Config-attributes>Attributes<a href=#trestle.oscal.ssp.SystemInformation.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.SystemInformation.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemInformation.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.oscal.ssp.SystemSecurityPlan class="doc doc-heading"> <code>SystemSecurityPlan</code> <a href=#trestle.oscal.ssp.SystemSecurityPlan class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>A system security plan, such as those described in NIST SP 800-18.</p> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span>
+<span class=normal>714</span>
+<span class=normal>715</span>
+<span class=normal>716</span>
+<span class=normal>717</span>
+<span class=normal>718</span>
+<span class=normal>719</span>
+<span class=normal>720</span>
+<span class=normal>721</span>
+<span class=normal>722</span>
+<span class=normal>723</span>
+<span class=normal>724</span>
+<span class=normal>725</span>
+<span class=normal>726</span>
+<span class=normal>727</span>
+<span class=normal>728</span>
+<span class=normal>729</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>SystemSecurityPlan</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    A system security plan, such as those described in NIST SP 800-18.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+        <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+
+    <span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span>
+        <span class=n>regex</span><span class=o>=</span><span class=sa>r</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span>
+    <span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span>
+        <span class=o>...</span><span class=p>,</span>
+        <span class=n>description</span><span class=o>=</span>
+        <span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this system security plan (SSP) elsewhere in this or other OSCAL instances. The locally defined UUID of the SSP can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance).This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span>
+        <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Security Plan Universally Unique Identifier&#39;</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span>
+    <span class=n>import_profile</span><span class=p>:</span> <span class=n>ImportProfile</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-profile&#39;</span><span class=p>)</span>
+    <span class=n>system_characteristics</span><span class=p>:</span> <span class=n>SystemCharacteristics</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-characteristics&#39;</span><span class=p>)</span>
+    <span class=n>system_implementation</span><span class=p>:</span> <span class=n>SystemImplementation</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-implementation&#39;</span><span class=p>)</span>
+    <span class=n>control_implementation</span><span class=p>:</span> <span class=n>ControlImplementation</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-implementation&#39;</span><span class=p>)</span>
+    <span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.oscal.ssp.SystemSecurityPlan-attributes>Attributes<a href=#trestle.oscal.ssp.SystemSecurityPlan-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemSecurityPlan.back_matter class="doc doc-heading"> <code class="highlight language-python"><span class=n>back_matter</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>common</span><span class=o>.</span><span class=n>BackMatter</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;back-matter&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemSecurityPlan.back_matter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemSecurityPlan.control_implementation class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_implementation</span><span class=p>:</span> <span class=n>ControlImplementation</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;control-implementation&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemSecurityPlan.control_implementation class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemSecurityPlan.import_profile class="doc doc-heading"> <code class="highlight language-python"><span class=n>import_profile</span><span class=p>:</span> <span class=n>ImportProfile</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;import-profile&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemSecurityPlan.import_profile class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemSecurityPlan.metadata class="doc doc-heading"> <code class="highlight language-python"><span class=n>metadata</span><span class=p>:</span> <span class=n>common</span><span class=o>.</span><span class=n>Metadata</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemSecurityPlan.metadata class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemSecurityPlan.system_characteristics class="doc doc-heading"> <code class="highlight language-python"><span class=n>system_characteristics</span><span class=p>:</span> <span class=n>SystemCharacteristics</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-characteristics&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemSecurityPlan.system_characteristics class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemSecurityPlan.system_implementation class="doc doc-heading"> <code class="highlight language-python"><span class=n>system_implementation</span><span class=p>:</span> <span class=n>SystemImplementation</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>alias</span><span class=o>=</span><span class=s1>&#39;system-implementation&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemSecurityPlan.system_implementation class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.oscal.ssp.SystemSecurityPlan.uuid class="doc doc-heading"> <code class="highlight language-python"><span class=n>uuid</span><span class=p>:</span> <span class=n>constr</span><span class=p>(</span><span class=n>regex</span><span class=o>=</span><span class=s1>&#39;^[0-9A-Fa-f]</span><span class=si>{8}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{4}</span><span class=s1>-[45][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[89ABab][0-9A-Fa-f]</span><span class=si>{3}</span><span class=s1>-[0-9A-Fa-f]</span><span class=si>{12}</span><span class=s1>$&#39;</span><span class=p>)</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=o>...</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this system security plan (SSP) elsewhere in this or other OSCAL instances. The locally defined UUID of the SSP can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance).This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;System Security Plan Universally Unique Identifier&#39;</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemSecurityPlan.uuid class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.oscal.ssp.SystemSecurityPlan-classes>Classes<a href=#trestle.oscal.ssp.SystemSecurityPlan-classes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-class"> <h6 id=trestle.oscal.ssp.SystemSecurityPlan.Config class="doc doc-heading"> <code>Config</code> <a href=#trestle.oscal.ssp.SystemSecurityPlan.Config class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <details class=quote> <summary>Source code in <code>trestle/oscal/ssp.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>713</span>
+<span class=normal>714</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Config</span><span class=p>:</span>
+    <span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h7 id=trestle.oscal.ssp.SystemSecurityPlan.Config-attributes>Attributes<a href=#trestle.oscal.ssp.SystemSecurityPlan.Config-attributes class=headerlink title="Permanent link">¤</a></h7> <div class="doc doc-object doc-attribute"> <h8 id=trestle.oscal.ssp.SystemSecurityPlan.Config.extra class="doc doc-heading"> <code class="highlight language-python"><span class=n>extra</span> <span class=o>=</span> <span class=n>Extra</span><span class=o>.</span><span class=n>forbid</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.oscal.ssp.SystemSecurityPlan.Config.extra class=headerlink title="Permanent link">¤</a></h8> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/base_task/index.html b/latest/reference/API/trestle/tasks/base_task/index.html
new file mode 100644
index 000000000..a59c23130
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/base_task/index.html
@@ -0,0 +1,248 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.base_task module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/base_task/ rel=canonical><link href=../../oscal/ssp/ rel=prev><link href=../cis_xlsx_to_oscal_catalog/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.base_task - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.base_task - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.base_task module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/base_task.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/base_task/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.base_task - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.base_task module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/base_task.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.base_task class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.base_task </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.base_task </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.base_task class=md-nav__link> <span class=md-ellipsis> base_task </span> </a> <nav class=md-nav aria-label=base_task> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail class=md-nav__link> <span class=md-ellipsis> PassFail </span> </a> <nav class=md-nav aria-label=PassFail> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase class=md-nav__link> <span class=md-ellipsis> TaskBase </span> </a> <nav class=md-nav aria-label=TaskBase> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome class=md-nav__link> <span class=md-ellipsis> TaskOutcome </span> </a> <nav class=md-nav aria-label=TaskOutcome> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.FAILURE class=md-nav__link> <span class=md-ellipsis> FAILURE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.NOT_IMPLEMENTED class=md-nav__link> <span class=md-ellipsis> NOT_IMPLEMENTED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.ROLLEDBACK class=md-nav__link> <span class=md-ellipsis> ROLLEDBACK </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.SIM_FAILURE class=md-nav__link> <span class=md-ellipsis> SIM_FAILURE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.SIM_SUCCESS class=md-nav__link> <span class=md-ellipsis> SIM_SUCCESS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.SUCCESS class=md-nav__link> <span class=md-ellipsis> SUCCESS </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.base_task class=md-nav__link> <span class=md-ellipsis> base_task </span> </a> <nav class=md-nav aria-label=base_task> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail class=md-nav__link> <span class=md-ellipsis> PassFail </span> </a> <nav class=md-nav aria-label=PassFail> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.PassFail.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase class=md-nav__link> <span class=md-ellipsis> TaskBase </span> </a> <nav class=md-nav aria-label=TaskBase> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskBase.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome class=md-nav__link> <span class=md-ellipsis> TaskOutcome </span> </a> <nav class=md-nav aria-label=TaskOutcome> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.FAILURE class=md-nav__link> <span class=md-ellipsis> FAILURE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.NOT_IMPLEMENTED class=md-nav__link> <span class=md-ellipsis> NOT_IMPLEMENTED </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.ROLLEDBACK class=md-nav__link> <span class=md-ellipsis> ROLLEDBACK </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.SIM_FAILURE class=md-nav__link> <span class=md-ellipsis> SIM_FAILURE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.SIM_SUCCESS class=md-nav__link> <span class=md-ellipsis> SIM_SUCCESS </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.base_task.TaskOutcome.SUCCESS class=md-nav__link> <span class=md-ellipsis> SUCCESS </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.base_task</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.base_task class="doc doc-heading"> <code>trestle.tasks.base_task</code> <a href=#trestle.tasks.base_task class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Trestle tasks base templating.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.base_task-attributes>Attributes<a href=#trestle.tasks.base_task-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.base_task.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.base_task.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.base_task-classes>Classes<a href=#trestle.tasks.base_task-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.base_task.PassFail class="doc doc-heading"> <code>PassFail</code> <a href=#trestle.tasks.base_task.PassFail class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Holding pattern template for a task which does nothing and always passes.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.PassFail.name href=#trestle.tasks.base_task.PassFail.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PassFail</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Holding pattern template for a task which does nothing and always passes.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;pass-fail&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task pass-fail.</span>
+
+<span class=sd>        Attributes:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;This is a template task which reports pass fail depending on the specific configuration.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;In this case if no config section is provided the task will fail. This a a task specific behavior.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.pass-fail]&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;with two boolean flags&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;execute_status = True/False with a default pass&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;simulate_status = True/False with a default fail&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Note that if the config file does not have the appropriate section this should fail.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;The princple goal is a simple development example.&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>outcome</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;simulate_status&#39;</span><span class=p>,</span> <span class=n>fallback</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>outcome</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a actual outcome.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>outcome</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;execute_status&#39;</span><span class=p>,</span> <span class=n>fallback</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>outcome</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.base_task.PassFail-attributes>Attributes<a href=#trestle.tasks.base_task.PassFail-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.base_task.PassFail.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;pass-fail&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.base_task.PassFail.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.base_task.PassFail-functions>Functions<a href=#trestle.tasks.base_task.PassFail-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.base_task.PassFail.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.base_task.PassFail.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task pass-fail.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><span title=trestle.tasks.base_task.PassFail.__init__.config_object>config_object</span></code></td> <td> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task pass-fail.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.base_task.PassFail.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.base_task.PassFail.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a actual outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a actual outcome.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+        <span class=n>outcome</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;execute_status&#39;</span><span class=p>,</span> <span class=n>fallback</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>outcome</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.base_task.PassFail.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.base_task.PassFail.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;This is a template task which reports pass fail depending on the specific configuration.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;In this case if no config section is provided the task will fail. This a a task specific behavior.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.pass-fail]&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;with two boolean flags&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;execute_status = True/False with a default pass&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;simulate_status = True/False with a default fail&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Note that if the config file does not have the appropriate section this should fail.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;The princple goal is a simple development example.&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.base_task.PassFail.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.base_task.PassFail.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+        <span class=n>outcome</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;simulate_status&#39;</span><span class=p>,</span> <span class=n>fallback</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>outcome</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.base_task.TaskBase class="doc doc-heading"> <code>TaskBase</code> <a href=#trestle.tasks.base_task.TaskBase class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=abc.ABC>ABC</span></code></p> <p>Abstract base class for tasks.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase.name href=#trestle.tasks.base_task.TaskBase.name>name</a></code></td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TaskBase</span><span class=p>(</span><span class=n>ABC</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Abstract base class for tasks.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;base&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize task base and store config.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_config</span> <span class=o>=</span> <span class=n>config_object</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute the task including potential rollback.&quot;&quot;&quot;</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Simulate the task and report task outcome.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.base_task.TaskBase-attributes>Attributes<a href=#trestle.tasks.base_task.TaskBase-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.base_task.TaskBase.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39;base&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.base_task.TaskBase.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.base_task.TaskBase-functions>Functions<a href=#trestle.tasks.base_task.TaskBase-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.base_task.TaskBase.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.base_task.TaskBase.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize task base and store config.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize task base and store config.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_config</span> <span class=o>=</span> <span class=n>config_object</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.base_task.TaskBase.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.tasks.base_task.TaskBase.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Execute the task including potential rollback.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Execute the task including potential rollback.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.base_task.TaskBase.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.tasks.base_task.TaskBase.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.base_task.TaskBase.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.tasks.base_task.TaskBase.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Simulate the task and report task outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Simulate the task and report task outcome.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.base_task.TaskOutcome class="doc doc-heading"> <code>TaskOutcome</code> <a href=#trestle.tasks.base_task.TaskOutcome class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=enum.Enum>Enum</span></code></p> <p>Enum describing possible task outcomes.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/base_task.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>26</span>
+<span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TaskOutcome</span><span class=p>(</span><span class=n>Enum</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Enum describing possible task outcomes.&quot;&quot;&quot;</span>
+
+    <span class=n>SUCCESS</span> <span class=o>=</span> <span class=s1>&#39;success&#39;</span>
+    <span class=n>FAILURE</span> <span class=o>=</span> <span class=s1>&#39;failure&#39;</span>
+    <span class=n>ROLLEDBACK</span> <span class=o>=</span> <span class=s1>&#39;rolledback&#39;</span>
+    <span class=n>SIM_SUCCESS</span> <span class=o>=</span> <span class=s1>&#39;simulated-success&#39;</span>
+    <span class=n>SIM_FAILURE</span> <span class=o>=</span> <span class=s1>&#39;simulated-failure&#39;</span>
+    <span class=n>NOT_IMPLEMENTED</span> <span class=o>=</span> <span class=s1>&#39;not-implemented&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.base_task.TaskOutcome-attributes>Attributes<a href=#trestle.tasks.base_task.TaskOutcome-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.base_task.TaskOutcome.FAILURE class="doc doc-heading"> <code class="highlight language-python"><span class=n>FAILURE</span> <span class=o>=</span> <span class=s1>&#39;failure&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.base_task.TaskOutcome.FAILURE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.base_task.TaskOutcome.NOT_IMPLEMENTED class="doc doc-heading"> <code class="highlight language-python"><span class=n>NOT_IMPLEMENTED</span> <span class=o>=</span> <span class=s1>&#39;not-implemented&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.base_task.TaskOutcome.NOT_IMPLEMENTED class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.base_task.TaskOutcome.ROLLEDBACK class="doc doc-heading"> <code class="highlight language-python"><span class=n>ROLLEDBACK</span> <span class=o>=</span> <span class=s1>&#39;rolledback&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.base_task.TaskOutcome.ROLLEDBACK class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.base_task.TaskOutcome.SIM_FAILURE class="doc doc-heading"> <code class="highlight language-python"><span class=n>SIM_FAILURE</span> <span class=o>=</span> <span class=s1>&#39;simulated-failure&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.base_task.TaskOutcome.SIM_FAILURE class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.base_task.TaskOutcome.SIM_SUCCESS class="doc doc-heading"> <code class="highlight language-python"><span class=n>SIM_SUCCESS</span> <span class=o>=</span> <span class=s1>&#39;simulated-success&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.base_task.TaskOutcome.SIM_SUCCESS class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.base_task.TaskOutcome.SUCCESS class="doc doc-heading"> <code class="highlight language-python"><span class=n>SUCCESS</span> <span class=o>=</span> <span class=s1>&#39;success&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.base_task.TaskOutcome.SUCCESS class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/index.html b/latest/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/index.html
new file mode 100644
index 000000000..81b1d0e9e
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/index.html
@@ -0,0 +1,1095 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.cis_xlsx_to_oscal_catalog module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ rel=canonical><link href=../base_task/ rel=prev><link href=../csv_to_oscal_cd/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.cis_xlsx_to_oscal_catalog - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.cis_xlsx_to_oscal_catalog - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.cis_xlsx_to_oscal_catalog module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.cis_xlsx_to_oscal_catalog - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.cis_xlsx_to_oscal_catalog module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog class=md-nav__link> <span class=md-ellipsis> cis_xlsx_to_oscal_catalog </span> </a> <nav class=md-nav aria-label=cis_xlsx_to_oscal_catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.timestamp class=md-nav__link> <span class=md-ellipsis> timestamp </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper class=md-nav__link> <span class=md-ellipsis> CatalogHelper </span> </a> <nav class=md-nav aria-label=CatalogHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_control class=md-nav__link> <span class=md-ellipsis> add_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_group class=md-nav__link> <span class=md-ellipsis> add_group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_link class=md-nav__link> <span class=md-ellipsis> add_link </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.get_catalog class=md-nav__link> <span class=md-ellipsis> get_catalog </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog class=md-nav__link> <span class=md-ellipsis> CisXlsxToOscalCatalog </span> </a> <nav class=md-nav aria-label=CisXlsxToOscalCatalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper class=md-nav__link> <span class=md-ellipsis> XlsxHelper </span> </a> <nav class=md-nav aria-label=XlsxHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.is_ocp class=md-nav__link> <span class=md-ellipsis> is_ocp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.row_generator class=md-nav__link> <span class=md-ellipsis> row_generator </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog class=md-nav__link> <span class=md-ellipsis> cis_xlsx_to_oscal_catalog </span> </a> <nav class=md-nav aria-label=cis_xlsx_to_oscal_catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.timestamp class=md-nav__link> <span class=md-ellipsis> timestamp </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper class=md-nav__link> <span class=md-ellipsis> CatalogHelper </span> </a> <nav class=md-nav aria-label=CatalogHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_control class=md-nav__link> <span class=md-ellipsis> add_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_group class=md-nav__link> <span class=md-ellipsis> add_group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_link class=md-nav__link> <span class=md-ellipsis> add_link </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.get_catalog class=md-nav__link> <span class=md-ellipsis> get_catalog </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog class=md-nav__link> <span class=md-ellipsis> CisXlsxToOscalCatalog </span> </a> <nav class=md-nav aria-label=CisXlsxToOscalCatalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper class=md-nav__link> <span class=md-ellipsis> XlsxHelper </span> </a> <nav class=md-nav aria-label=XlsxHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.is_ocp class=md-nav__link> <span class=md-ellipsis> is_ocp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.row_generator class=md-nav__link> <span class=md-ellipsis> row_generator </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.cis_xlsx_to_oscal_catalog</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.cis_xlsx_to_oscal_catalog class="doc doc-heading"> <code>trestle.tasks.cis_xlsx_to_oscal_catalog</code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.cis_xlsx_to_oscal_catalog-attributes>Attributes<a href=#trestle.tasks.cis_xlsx_to_oscal_catalog-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.cis_xlsx_to_oscal_catalog.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.cis_xlsx_to_oscal_catalog.timestamp class="doc doc-heading"> <code class="highlight language-python"><span class=n>timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.timestamp class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.cis_xlsx_to_oscal_catalog-classes>Classes<a href=#trestle.tasks.cis_xlsx_to_oscal_catalog-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper class="doc doc-heading"> <code>CatalogHelper</code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>OSCAL Catalog Helper.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogHelper</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;OSCAL Catalog Helper.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=c1># metadata</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_metadata</span> <span class=o>=</span> <span class=n>Metadata</span><span class=p>(</span><span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>,</span> <span class=n>last_modified</span><span class=o>=</span><span class=n>timestamp</span><span class=p>,</span> <span class=n>oscal_version</span><span class=o>=</span><span class=n>OSCAL_VERSION</span><span class=p>,</span> <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_root_group</span> <span class=o>=</span> <span class=n>OrderedDict</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_root_resources</span> <span class=o>=</span> <span class=n>OrderedDict</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span> <span class=o>=</span> <span class=n>OrderedDict</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_all_controls</span> <span class=o>=</span> <span class=n>OrderedDict</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>add_group</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>section</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>],</span> <span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Part</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add group.&quot;&quot;&quot;</span>
+        <span class=n>numdots</span> <span class=o>=</span> <span class=n>section</span><span class=o>.</span><span class=n>count</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>numdots</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>group</span> <span class=o>=</span> <span class=n>Group</span><span class=p>(</span><span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=nb>id</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>section</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>props</span><span class=p>:</span>
+                <span class=n>group</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>props</span>
+            <span class=k>if</span> <span class=n>parts</span><span class=p>:</span>
+                <span class=n>group</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>parts</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_root_group</span><span class=p>[</span><span class=n>section</span><span class=p>]</span> <span class=o>=</span> <span class=n>group</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span><span class=p>[</span><span class=n>section</span><span class=p>]</span> <span class=o>=</span> <span class=n>group</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>key</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>section</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[:</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+            <span class=n>parent</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>parent</span><span class=o>.</span><span class=n>groups</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>parent</span><span class=o>.</span><span class=n>groups</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>group</span> <span class=o>=</span> <span class=n>Group</span><span class=p>(</span><span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=nb>id</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>section</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>props</span><span class=p>:</span>
+                <span class=n>group</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>props</span>
+            <span class=k>if</span> <span class=n>parts</span><span class=p>:</span>
+                <span class=n>group</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>parts</span>
+            <span class=n>parent</span><span class=o>.</span><span class=n>groups</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>group</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span><span class=p>[</span><span class=n>section</span><span class=p>]</span> <span class=o>=</span> <span class=n>group</span>
+
+    <span class=k>def</span> <span class=nf>_add_prop</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>prop</span><span class=p>:</span> <span class=n>Property</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add property to control.&quot;&quot;&quot;</span>
+        <span class=n>control_props</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>props</span>
+        <span class=n>control</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>last</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>for</span> <span class=n>i</span><span class=p>,</span> <span class=n>control_prop</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>control_props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>control_prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=p>:</span>
+                <span class=n>last</span> <span class=o>=</span> <span class=n>i</span>
+        <span class=k>for</span> <span class=n>i</span><span class=p>,</span> <span class=n>control_prop</span> <span class=ow>in</span> <span class=nb>enumerate</span><span class=p>(</span><span class=n>control_props</span><span class=p>):</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_prop</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>i</span> <span class=o>==</span> <span class=n>last</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>add_control</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>section</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>recommendation</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>],</span>
+        <span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Part</span><span class=p>],</span>
+        <span class=n>links</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add control.&quot;&quot;&quot;</span>
+        <span class=n>group</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span><span class=p>[</span><span class=n>section</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>group</span><span class=o>.</span><span class=n>controls</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>group</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>id_</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>recommendation</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>if</span> <span class=n>id_</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_all_controls</span><span class=p>:</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_all_controls</span><span class=p>[</span><span class=n>id_</span><span class=p>]</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>props</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;profile&#39;</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_add_prop</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>prop</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=n>Control</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=n>id_</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_all_controls</span><span class=p>[</span><span class=n>id_</span><span class=p>]</span> <span class=o>=</span> <span class=n>control</span>
+            <span class=k>if</span> <span class=n>props</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>props</span>
+            <span class=k>if</span> <span class=n>parts</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>parts</span>
+            <span class=k>if</span> <span class=n>links</span><span class=p>:</span>
+                <span class=n>control</span><span class=o>.</span><span class=n>links</span> <span class=o>=</span> <span class=n>links</span>
+            <span class=n>group</span><span class=o>.</span><span class=n>controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>add_link</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>recommendation</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>links</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>],</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add link.&quot;&quot;&quot;</span>
+        <span class=n>id_</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>recommendation</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>if</span> <span class=n>id_</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_root_resources</span><span class=p>:</span>
+            <span class=n>res_id</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+            <span class=n>link</span> <span class=o>=</span> <span class=n>Link</span><span class=p>(</span><span class=n>href</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;#</span><span class=si>{</span><span class=n>res_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=n>rel</span><span class=o>=</span><span class=s1>&#39;reference&#39;</span><span class=p>)</span>
+            <span class=n>links</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>link</span><span class=p>)</span>
+            <span class=n>resource</span> <span class=o>=</span> <span class=n>Resource</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=n>res_id</span><span class=p>,</span>
+                <span class=n>description</span><span class=o>=</span><span class=n>reference</span><span class=p>,</span>
+            <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_root_resources</span><span class=p>[</span><span class=n>id_</span><span class=p>]</span> <span class=o>=</span> <span class=n>resource</span>
+
+    <span class=k>def</span> <span class=nf>get_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Catalog</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get catalog.&quot;&quot;&quot;</span>
+        <span class=n>back_matter</span> <span class=o>=</span> <span class=n>BackMatter</span><span class=p>(</span><span class=n>resources</span><span class=o>=</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_resources</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=n>Catalog</span><span class=p>(</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+            <span class=n>metadata</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_metadata</span><span class=p>,</span>
+            <span class=n>groups</span><span class=o>=</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_group</span><span class=o>.</span><span class=n>values</span><span class=p>()),</span>
+            <span class=n>back_matter</span><span class=o>=</span><span class=n>back_matter</span>
+        <span class=p>)</span>
+        <span class=k>return</span> <span class=n>catalog</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper-functions>Functions<a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>title</span><span class=p>,</span> <span class=n>version</span><span class=p>)</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>version</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=c1># metadata</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_metadata</span> <span class=o>=</span> <span class=n>Metadata</span><span class=p>(</span><span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>,</span> <span class=n>last_modified</span><span class=o>=</span><span class=n>timestamp</span><span class=p>,</span> <span class=n>oscal_version</span><span class=o>=</span><span class=n>OSCAL_VERSION</span><span class=p>,</span> <span class=n>version</span><span class=o>=</span><span class=n>version</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_root_group</span> <span class=o>=</span> <span class=n>OrderedDict</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_root_resources</span> <span class=o>=</span> <span class=n>OrderedDict</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span> <span class=o>=</span> <span class=n>OrderedDict</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_all_controls</span> <span class=o>=</span> <span class=n>OrderedDict</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_control</span><span class=p>(</span><span class=n>section</span><span class=p>,</span> <span class=n>recommendation</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=n>links</span><span class=p>)</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add control.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_control</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>section</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>recommendation</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>],</span>
+    <span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Part</span><span class=p>],</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add control.&quot;&quot;&quot;</span>
+    <span class=n>group</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span><span class=p>[</span><span class=n>section</span><span class=p>]</span>
+    <span class=k>if</span> <span class=n>group</span><span class=o>.</span><span class=n>controls</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>group</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>id_</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>recommendation</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=k>if</span> <span class=n>id_</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_all_controls</span><span class=p>:</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_all_controls</span><span class=p>[</span><span class=n>id_</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>props</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;profile&#39;</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_prop</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>prop</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=n>Control</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=n>id_</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_all_controls</span><span class=p>[</span><span class=n>id_</span><span class=p>]</span> <span class=o>=</span> <span class=n>control</span>
+        <span class=k>if</span> <span class=n>props</span><span class=p>:</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>props</span>
+        <span class=k>if</span> <span class=n>parts</span><span class=p>:</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>parts</span>
+        <span class=k>if</span> <span class=n>links</span><span class=p>:</span>
+            <span class=n>control</span><span class=o>.</span><span class=n>links</span> <span class=o>=</span> <span class=n>links</span>
+        <span class=n>group</span><span class=o>.</span><span class=n>controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_group class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_group</span><span class=p>(</span><span class=n>section</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>parts</span><span class=p>)</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_group class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add group.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_group</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>section</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>],</span> <span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Part</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add group.&quot;&quot;&quot;</span>
+    <span class=n>numdots</span> <span class=o>=</span> <span class=n>section</span><span class=o>.</span><span class=n>count</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>numdots</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=n>group</span> <span class=o>=</span> <span class=n>Group</span><span class=p>(</span><span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=nb>id</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>section</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>props</span><span class=p>:</span>
+            <span class=n>group</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>props</span>
+        <span class=k>if</span> <span class=n>parts</span><span class=p>:</span>
+            <span class=n>group</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>parts</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_root_group</span><span class=p>[</span><span class=n>section</span><span class=p>]</span> <span class=o>=</span> <span class=n>group</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span><span class=p>[</span><span class=n>section</span><span class=p>]</span> <span class=o>=</span> <span class=n>group</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>key</span> <span class=o>=</span> <span class=s1>&#39;.&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>section</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[:</span><span class=o>-</span><span class=mi>1</span><span class=p>])</span>
+        <span class=n>parent</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>parent</span><span class=o>.</span><span class=n>groups</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>parent</span><span class=o>.</span><span class=n>groups</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>group</span> <span class=o>=</span> <span class=n>Group</span><span class=p>(</span><span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=nb>id</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>section</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>props</span><span class=p>:</span>
+            <span class=n>group</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>props</span>
+        <span class=k>if</span> <span class=n>parts</span><span class=p>:</span>
+            <span class=n>group</span><span class=o>.</span><span class=n>parts</span> <span class=o>=</span> <span class=n>parts</span>
+        <span class=n>parent</span><span class=o>.</span><span class=n>groups</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>group</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_all_groups</span><span class=p>[</span><span class=n>section</span><span class=p>]</span> <span class=o>=</span> <span class=n>group</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_link class="doc doc-heading"> <code class="highlight language-python"><span class=n>add_link</span><span class=p>(</span><span class=n>recommendation</span><span class=p>,</span> <span class=n>reference</span><span class=p>,</span> <span class=n>links</span><span class=p>)</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_link class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add link.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add_link</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>recommendation</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>reference</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>links</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>],</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add link.&quot;&quot;&quot;</span>
+    <span class=n>id_</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>recommendation</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=k>if</span> <span class=n>id_</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_root_resources</span><span class=p>:</span>
+        <span class=n>res_id</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>link</span> <span class=o>=</span> <span class=n>Link</span><span class=p>(</span><span class=n>href</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;#</span><span class=si>{</span><span class=n>res_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=n>rel</span><span class=o>=</span><span class=s1>&#39;reference&#39;</span><span class=p>)</span>
+        <span class=n>links</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>link</span><span class=p>)</span>
+        <span class=n>resource</span> <span class=o>=</span> <span class=n>Resource</span><span class=p>(</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=n>res_id</span><span class=p>,</span>
+            <span class=n>description</span><span class=o>=</span><span class=n>reference</span><span class=p>,</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_root_resources</span><span class=p>[</span><span class=n>id_</span><span class=p>]</span> <span class=o>=</span> <span class=n>resource</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.get_catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_catalog</span><span class=p>()</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.get_catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get catalog.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_catalog</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Catalog</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get catalog.&quot;&quot;&quot;</span>
+    <span class=n>back_matter</span> <span class=o>=</span> <span class=n>BackMatter</span><span class=p>(</span><span class=n>resources</span><span class=o>=</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_resources</span><span class=o>.</span><span class=n>values</span><span class=p>()))</span>
+    <span class=n>catalog</span> <span class=o>=</span> <span class=n>Catalog</span><span class=p>(</span>
+        <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+        <span class=n>metadata</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_metadata</span><span class=p>,</span>
+        <span class=n>groups</span><span class=o>=</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_root_group</span><span class=o>.</span><span class=n>values</span><span class=p>()),</span>
+        <span class=n>back_matter</span><span class=o>=</span><span class=n>back_matter</span>
+    <span class=p>)</span>
+    <span class=k>return</span> <span class=n>catalog</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog class="doc doc-heading"> <code>CisXlsxToOscalCatalog</code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to transform CIS .xlsx to OSCAL catalog.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.name href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CisXlsxToOscalCatalog</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to transform CIS .xlsx to OSCAL catalog.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;cis-xlsx-to-oscal-catalog&#39;</span>
+    <span class=n>ns</span> <span class=o>=</span> <span class=s1>&#39;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/catalog/cis&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Purpose: Create catalog from standard (e.g. CIS benchmark).&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.cis-xlsx-to-oscal-catalog]:&#39;</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  input-file             = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) path to read the compliance-as-code .xlsx spread sheet file.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir             = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) location to write the generated catalog.json file.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  title                  = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) title of the CIS catalog.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  version                = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) version of the CIS catalog.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite       = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_normalized_name</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get normalized name.&quot;&quot;&quot;</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=n>key</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;&amp;&#39;</span><span class=p>,</span> <span class=s1>&#39;a&#39;</span><span class=p>)</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;(&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;)&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>name</span>
+
+    <span class=k>def</span> <span class=nf>_create_property</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>value</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Property</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>CisXlsxToOscalCatalog</span><span class=o>.</span><span class=n>ns</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_property</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>xlsx_helper</span><span class=p>:</span> <span class=n>XlsxHelper</span><span class=p>,</span> <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>],</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add property.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_normalized_name</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>key</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>value</span><span class=p>:</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_create_property</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=p>))</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1> not found.&#39;</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_property_boolean</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>xlsx_helper</span><span class=p>:</span> <span class=n>XlsxHelper</span><span class=p>,</span> <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>],</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add property.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_normalized_name</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>key</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>value</span><span class=p>:</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_create_property</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;True&#39;</span><span class=p>))</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_create_property</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;False&#39;</span><span class=p>))</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1> not found.&#39;</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_part</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>xlsx_helper</span><span class=p>:</span> <span class=n>XlsxHelper</span><span class=p>,</span> <span class=n>parts</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Part</span><span class=p>],</span> <span class=n>id_</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add part.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>key</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>value</span><span class=p>:</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_normalized_name</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+            <span class=n>parts</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>Part</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=n>id_</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>prose</span><span class=o>=</span><span class=n>value</span><span class=p>))</span>
+
+    <span class=k>def</span> <span class=nf>_add_links</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>xlsx_helper</span><span class=p>:</span> <span class=n>XlsxHelper</span><span class=p>,</span> <span class=n>catalog_helper</span><span class=p>:</span> <span class=n>CatalogHelper</span><span class=p>,</span> <span class=n>links</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Link</span><span class=p>],</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>key</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add links.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>key</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>value</span><span class=p>:</span>
+            <span class=n>recommendation</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=s1>&#39;recommendation #&#39;</span><span class=p>)</span>
+            <span class=n>catalog_helper</span><span class=o>.</span><span class=n>add_link</span><span class=p>(</span><span class=n>recommendation</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>links</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Wrap the execute for exception handling.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>ifile</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;input-file&#39;</span><span class=p>]</span>
+            <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;output-dir&#39;</span><span class=p>]</span>
+            <span class=n>title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;title&#39;</span><span class=p>]</span>
+            <span class=n>version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;version&#39;</span><span class=p>]</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=o>.</span><span class=n>args</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1> missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># verbosity</span>
+        <span class=n>_quiet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>_verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=n>_quiet</span>
+        <span class=c1># output</span>
+        <span class=n>overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># calculate output file name &amp; check writability</span>
+        <span class=n>oname</span> <span class=o>=</span> <span class=s1>&#39;catalog.json&#39;</span>
+        <span class=n>ofile</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=n>xlsx_helper</span> <span class=o>=</span> <span class=n>XlsxHelper</span><span class=p>(</span><span class=n>ifile</span><span class=p>)</span>
+        <span class=n>catalog_helper</span> <span class=o>=</span> <span class=n>CatalogHelper</span><span class=p>(</span><span class=n>title</span><span class=p>,</span> <span class=n>version</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>is_ocp</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_process_ocp</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>catalog_helper</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_process_rhel</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>catalog_helper</span><span class=p>)</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=n>catalog_helper</span><span class=o>.</span><span class=n>get_catalog</span><span class=p>()</span>
+        <span class=c1># write OSCAL ComponentDefinition to file</span>
+        <span class=k>if</span> <span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>catalog</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_process_ocp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>xlsx_helper</span><span class=p>:</span> <span class=n>XlsxHelper</span><span class=p>,</span> <span class=n>catalog_helper</span><span class=p>:</span> <span class=n>CatalogHelper</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Process OCP.&quot;&quot;&quot;</span>
+        <span class=c1># transform each row into OSCAL equivalent</span>
+        <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>row_generator</span><span class=p>():</span>
+            <span class=n>section</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=s1>&#39;section #&#39;</span><span class=p>)</span>
+            <span class=n>recommendation</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=s1>&#39;recommendation #&#39;</span><span class=p>)</span>
+            <span class=n>title</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=s1>&#39;title&#39;</span><span class=p>)</span>
+            <span class=c1># init</span>
+            <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>parts</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>links</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=c1># props</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_property</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;profile&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_property</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;status&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_property</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;assessment status&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>recommendation</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>frag</span> <span class=o>=</span> <span class=n>section</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>frag</span> <span class=o>=</span> <span class=n>recommendation</span>
+            <span class=c1># parts</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_smt&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;statement&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_rat&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;rationale statement&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_imp&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;impact statement&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_rem&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;remediation procedure&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_aud&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;audit procedure&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_inf&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;additional information&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_ctl&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;CIS Controls&#39;</span><span class=p>)</span>
+            <span class=c1># group or control</span>
+            <span class=k>if</span> <span class=n>recommendation</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>catalog_helper</span><span class=o>.</span><span class=n>add_group</span><span class=p>(</span><span class=n>section</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>parts</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v7 IG1&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v7 IG2&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v7 IG3&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v8 IG1&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v8 IG2&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v8 IG3&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;MITRE ATT&amp;CK Mappings&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_links</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>catalog_helper</span><span class=p>,</span> <span class=n>links</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;references&#39;</span><span class=p>)</span>
+                <span class=n>catalog_helper</span><span class=o>.</span><span class=n>add_control</span><span class=p>(</span><span class=n>section</span><span class=p>,</span> <span class=n>recommendation</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=n>links</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_process_rhel</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>xlsx_helper</span><span class=p>:</span> <span class=n>XlsxHelper</span><span class=p>,</span> <span class=n>catalog_helper</span><span class=p>:</span> <span class=n>CatalogHelper</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Process RHEL.&quot;&quot;&quot;</span>
+        <span class=c1># transform each row into OSCAL equivalent</span>
+        <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>row_generator</span><span class=p>():</span>
+            <span class=n>section</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=s1>&#39;section #&#39;</span><span class=p>)</span>
+            <span class=n>recommendation</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=s1>&#39;recommendation #&#39;</span><span class=p>)</span>
+            <span class=n>title</span> <span class=o>=</span> <span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=s1>&#39;title&#39;</span><span class=p>)</span>
+            <span class=c1># init</span>
+            <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>parts</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>links</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=c1># props</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_property</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;profile&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_property</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;assessment status&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>recommendation</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>frag</span> <span class=o>=</span> <span class=n>section</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>frag</span> <span class=o>=</span> <span class=n>recommendation</span>
+            <span class=c1># parts</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_smt&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;statement&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_rat&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;rational statement&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_imp&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;impact statement&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_rem&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;remediation procedure&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_aud&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;audit procedure&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_inf&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;additional information&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_ctl&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;CIS Controls&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_1v8&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;CIS Safeguards 1 (v8)&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_2v8&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;CIS Safeguards 2 (v8)&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_3v8&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;CIS Safeguards 3 (v8)&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_1v7&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;CIS Safeguards 1 (v7)&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_2v7&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;CIS Safeguards 2 (v7)&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_part</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>frag</span><span class=si>}</span><span class=s1>_3v7&#39;</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;CIS Safeguards 3 (v7)&#39;</span><span class=p>)</span>
+            <span class=c1># group or control</span>
+            <span class=k>if</span> <span class=n>recommendation</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>catalog_helper</span><span class=o>.</span><span class=n>add_group</span><span class=p>(</span><span class=n>section</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>parts</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v7 IG1&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v7 IG2&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v7 IG3&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v8 IG1&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v8 IG2&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_property_boolean</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;v8 IG3&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_links</span><span class=p>(</span><span class=n>xlsx_helper</span><span class=p>,</span> <span class=n>catalog_helper</span><span class=p>,</span> <span class=n>links</span><span class=p>,</span> <span class=n>row</span><span class=p>,</span> <span class=s1>&#39;references&#39;</span><span class=p>)</span>
+                <span class=n>catalog_helper</span><span class=o>.</span><span class=n>add_control</span><span class=p>(</span><span class=n>section</span><span class=p>,</span> <span class=n>recommendation</span><span class=p>,</span> <span class=n>title</span><span class=p>,</span> <span class=n>props</span><span class=p>,</span> <span class=n>parts</span><span class=p>,</span> <span class=n>links</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-attributes>Attributes<a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;cis-xlsx-to-oscal-catalog&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.ns class="doc doc-heading"> <code class="highlight language-python"><span class=n>ns</span> <span class=o>=</span> <span class=s1>&#39;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/catalog/cis&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.ns class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-functions>Functions<a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an actual outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Purpose: Create catalog from standard (e.g. CIS benchmark).&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.cis-xlsx-to-oscal-catalog]:&#39;</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  input-file             = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) path to read the compliance-as-code .xlsx spread sheet file.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir             = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) location to write the generated catalog.json file.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  title                  = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) title of the CIS catalog.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  version                = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) version of the CIS catalog.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite       = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper class="doc doc-heading"> <code>XlsxHelper</code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Xlsx Helper common functions and assistance navigating spread sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>XlsxHelper</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Xlsx Helper common functions and assistance navigating spread sheet.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>file</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_spread_sheet</span> <span class=o>=</span> <span class=n>file</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span> <span class=o>=</span> <span class=n>load_workbook</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_spread_sheet</span><span class=p>)</span>
+        <span class=n>sheet_candidates</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;Combined Profiles&#39;</span><span class=p>,</span> <span class=s1>&#39;Combined&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>sheet_candidate</span> <span class=ow>in</span> <span class=n>sheet_candidates</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>sheet_candidate</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span><span class=o>.</span><span class=n>sheetnames</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span> <span class=o>=</span> <span class=n>sheet_candidate</span>
+                <span class=k>break</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>file</span><span class=si>}</span><span class=s1> missing one of </span><span class=si>{</span><span class=n>sheet_candidates</span><span class=si>}</span><span class=s1> sheet&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span><span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_mapper</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_key_to_col_map</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;statement&#39;</span><span class=p>:</span> <span class=s1>&#39;description&#39;</span><span class=p>}</span>
+
+    <span class=k>def</span> <span class=nf>is_ocp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if sheet is for OCP.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span> <span class=o>==</span> <span class=s1>&#39;Combined Profiles&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_normalize</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Normalize.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_translate</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Translate name key to column name.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_key_to_col_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_mapper</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Map columns heading names to column numbers.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_col_name_to_number</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>cols</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=o>.</span><span class=n>max_column</span> <span class=o>+</span> <span class=mi>1</span>
+        <span class=n>row</span> <span class=o>=</span> <span class=mi>1</span>
+        <span class=k>for</span> <span class=n>col</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>cols</span><span class=p>):</span>
+            <span class=n>cell</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=o>.</span><span class=n>cell</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>col</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>cell</span><span class=o>.</span><span class=n>value</span><span class=p>:</span>
+                <span class=n>name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_normalize</span><span class=p>(</span><span class=n>cell</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_col_name_to_number</span><span class=p>[</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=n>col</span>
+
+    <span class=k>def</span> <span class=nf>row_generator</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate rows until max reached.&quot;&quot;&quot;</span>
+        <span class=n>row</span> <span class=o>=</span> <span class=mi>2</span>
+        <span class=k>while</span> <span class=n>row</span> <span class=o>&lt;=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=o>.</span><span class=n>max_row</span><span class=p>:</span>
+            <span class=k>yield</span> <span class=n>row</span>
+            <span class=n>row</span> <span class=o>+=</span> <span class=mi>1</span>
+
+    <span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get cell value for given row and column name.&quot;&quot;&quot;</span>
+        <span class=n>nname</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_normalize</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+        <span class=n>cname</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_translate</span><span class=p>(</span><span class=n>nname</span><span class=p>)</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_col_name_to_number</span><span class=p>[</span><span class=n>cname</span><span class=p>]</span>
+        <span class=n>cell</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=o>.</span><span class=n>cell</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>col</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>cell</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper-functions>Functions<a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>file</span><span class=p>)</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>file</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_spread_sheet</span> <span class=o>=</span> <span class=n>file</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span> <span class=o>=</span> <span class=n>load_workbook</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_spread_sheet</span><span class=p>)</span>
+    <span class=n>sheet_candidates</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;Combined Profiles&#39;</span><span class=p>,</span> <span class=s1>&#39;Combined&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>for</span> <span class=n>sheet_candidate</span> <span class=ow>in</span> <span class=n>sheet_candidates</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>sheet_candidate</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span><span class=o>.</span><span class=n>sheetnames</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span> <span class=o>=</span> <span class=n>sheet_candidate</span>
+            <span class=k>break</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>file</span><span class=si>}</span><span class=s1> missing one of </span><span class=si>{</span><span class=n>sheet_candidates</span><span class=si>}</span><span class=s1> sheet&#39;</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span><span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_mapper</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_key_to_col_map</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;statement&#39;</span><span class=p>:</span> <span class=s1>&#39;description&#39;</span><span class=p>}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.get class="doc doc-heading"> <code class="highlight language-python"><span class=n>get</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>name</span><span class=p>)</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.get class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get cell value for given row and column name.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get cell value for given row and column name.&quot;&quot;&quot;</span>
+    <span class=n>nname</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_normalize</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+    <span class=n>cname</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_translate</span><span class=p>(</span><span class=n>nname</span><span class=p>)</span>
+    <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_col_name_to_number</span><span class=p>[</span><span class=n>cname</span><span class=p>]</span>
+    <span class=n>cell</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=o>.</span><span class=n>cell</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>col</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>cell</span><span class=o>.</span><span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.is_ocp class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_ocp</span><span class=p>()</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.is_ocp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Check if sheet is for OCP.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_ocp</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check if sheet is for OCP.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span> <span class=o>==</span> <span class=s1>&#39;Combined Profiles&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.row_generator class="doc doc-heading"> <code class="highlight language-python"><span class=n>row_generator</span><span class=p>()</span></code> <a href=#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.row_generator class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate rows until max reached.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>row_generator</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=nb>int</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate rows until max reached.&quot;&quot;&quot;</span>
+    <span class=n>row</span> <span class=o>=</span> <span class=mi>2</span>
+    <span class=k>while</span> <span class=n>row</span> <span class=o>&lt;=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=o>.</span><span class=n>max_row</span><span class=p>:</span>
+        <span class=k>yield</span> <span class=n>row</span>
+        <span class=n>row</span> <span class=o>+=</span> <span class=mi>1</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/csv_to_oscal_cd/index.html b/latest/reference/API/trestle/tasks/csv_to_oscal_cd/index.html
new file mode 100644
index 000000000..ccfc978a9
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/csv_to_oscal_cd/index.html
@@ -0,0 +1,2817 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.csv_to_oscal_cd module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/csv_to_oscal_cd/ rel=canonical><link href=../cis_xlsx_to_oscal_catalog/ rel=prev><link href=../ocp4_cis_profile_to_oscal_catalog/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.csv_to_oscal_cd - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.csv_to_oscal_cd - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.csv_to_oscal_cd module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/csv_to_oscal_cd.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/csv_to_oscal_cd/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.csv_to_oscal_cd - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.csv_to_oscal_cd module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/csv_to_oscal_cd.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.csv_to_oscal_cd class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd class=md-nav__link> <span class=md-ellipsis> csv_to_oscal_cd </span> </a> <nav class=md-nav aria-label=csv_to_oscal_cd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.ADJUSTED_RISK_RATING class=md-nav__link> <span class=md-ellipsis> ADJUSTED_RISK_RATING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CHECK_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> CHECK_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CHECK_ID class=md-nav__link> <span class=md-ellipsis> CHECK_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.COMPONENT_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> COMPONENT_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.COMPONENT_TITLE class=md-nav__link> <span class=md-ellipsis> COMPONENT_TITLE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.COMPONENT_TYPE class=md-nav__link> <span class=md-ellipsis> COMPONENT_TYPE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CONTROL_ID_LIST class=md-nav__link> <span class=md-ellipsis> CONTROL_ID_LIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.FETCHER_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> FETCHER_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.FETCHER_ID class=md-nav__link> <span class=md-ellipsis> FETCHER_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.HEADER_DECORATION_CHAR class=md-nav__link> <span class=md-ellipsis> HEADER_DECORATION_CHAR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.NAMESPACE class=md-nav__link> <span class=md-ellipsis> NAMESPACE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.ORIGINAL_RISK_RATING class=md-nav__link> <span class=md-ellipsis> ORIGINAL_RISK_RATING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER class=md-nav__link> <span class=md-ellipsis> PARAMETER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> PARAMETER_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_ID class=md-nav__link> <span class=md-ellipsis> PARAMETER_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_ALTERNATIVES class=md-nav__link> <span class=md-ellipsis> PARAMETER_VALUE_ALTERNATIVES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_DEFAULT class=md-nav__link> <span class=md-ellipsis> PARAMETER_VALUE_DEFAULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PROFILE_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> PROFILE_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PROFILE_SOURCE class=md-nav__link> <span class=md-ellipsis> PROFILE_SOURCE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.RISK_ADJUSTMENT class=md-nav__link> <span class=md-ellipsis> RISK_ADJUSTMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.RULE_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> RULE_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.RULE_ID class=md-nav__link> <span class=md-ellipsis> RULE_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.Row class=md-nav__link> <span class=md-ellipsis> Row </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.TARGET_COMPONENT class=md-nav__link> <span class=md-ellipsis> TARGET_COMPONENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.prefix_rule_set class=md-nav__link> <span class=md-ellipsis> prefix_rule_set </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.validation class=md-nav__link> <span class=md-ellipsis> validation </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn class=md-nav__link> <span class=md-ellipsis> CsvColumn </span> </a> <nav class=md-nav aria-label=CsvColumn> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_check_property_column_names class=md-nav__link> <span class=md-ellipsis> get_check_property_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_optional_column_names class=md-nav__link> <span class=md-ellipsis> get_filtered_optional_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_required_column_names class=md-nav__link> <span class=md-ellipsis> get_filtered_required_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_optional_column_names class=md-nav__link> <span class=md-ellipsis> get_optional_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_order class=md-nav__link> <span class=md-ellipsis> get_order </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_parameter_column_names class=md-nav__link> <span class=md-ellipsis> get_parameter_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names class=md-nav__link> <span class=md-ellipsis> get_required_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names_validation class=md-nav__link> <span class=md-ellipsis> get_required_column_names_validation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_rule_property_column_names class=md-nav__link> <span class=md-ellipsis> get_rule_property_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_optional class=md-nav__link> <span class=md-ellipsis> is_column_name_optional </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_parameter class=md-nav__link> <span class=md-ellipsis> is_column_name_parameter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_required class=md-nav__link> <span class=md-ellipsis> is_column_name_required </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition class=md-nav__link> <span class=md-ellipsis> CsvToOscalComponentDefinition </span> </a> <nav class=md-nav aria-label=CsvToOscalComponentDefinition> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.configure class=md-nav__link> <span class=md-ellipsis> configure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_add class=md-nav__link> <span class=md-ellipsis> control_mappings_add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_del class=md-nav__link> <span class=md-ellipsis> control_mappings_del </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.get_class class=md-nav__link> <span class=md-ellipsis> get_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_add class=md-nav__link> <span class=md-ellipsis> rules_add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_del class=md-nav__link> <span class=md-ellipsis> rules_del </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_mod class=md-nav__link> <span class=md-ellipsis> rules_mod </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_add class=md-nav__link> <span class=md-ellipsis> set_params_add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_del class=md-nav__link> <span class=md-ellipsis> set_params_del </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_mod class=md-nav__link> <span class=md-ellipsis> set_params_mod </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.derive_control_id class=md-nav__link> <span class=md-ellipsis> derive_control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.derive_part_id class=md-nav__link> <span class=md-ellipsis> derive_part_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.etype class=md-nav__link> <span class=md-ellipsis> etype </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.is_validation class=md-nav__link> <span class=md-ellipsis> is_validation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.row_property_builder class=md-nav__link> <span class=md-ellipsis> row_property_builder </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.synthesize_rule_key class=md-nav__link> <span class=md-ellipsis> synthesize_rule_key </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd class=md-nav__link> <span class=md-ellipsis> csv_to_oscal_cd </span> </a> <nav class=md-nav aria-label=csv_to_oscal_cd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.ADJUSTED_RISK_RATING class=md-nav__link> <span class=md-ellipsis> ADJUSTED_RISK_RATING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CHECK_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> CHECK_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CHECK_ID class=md-nav__link> <span class=md-ellipsis> CHECK_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.COMPONENT_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> COMPONENT_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.COMPONENT_TITLE class=md-nav__link> <span class=md-ellipsis> COMPONENT_TITLE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.COMPONENT_TYPE class=md-nav__link> <span class=md-ellipsis> COMPONENT_TYPE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CONTROL_ID_LIST class=md-nav__link> <span class=md-ellipsis> CONTROL_ID_LIST </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.FETCHER_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> FETCHER_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.FETCHER_ID class=md-nav__link> <span class=md-ellipsis> FETCHER_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.HEADER_DECORATION_CHAR class=md-nav__link> <span class=md-ellipsis> HEADER_DECORATION_CHAR </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.NAMESPACE class=md-nav__link> <span class=md-ellipsis> NAMESPACE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.ORIGINAL_RISK_RATING class=md-nav__link> <span class=md-ellipsis> ORIGINAL_RISK_RATING </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER class=md-nav__link> <span class=md-ellipsis> PARAMETER </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> PARAMETER_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_ID class=md-nav__link> <span class=md-ellipsis> PARAMETER_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_ALTERNATIVES class=md-nav__link> <span class=md-ellipsis> PARAMETER_VALUE_ALTERNATIVES </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_DEFAULT class=md-nav__link> <span class=md-ellipsis> PARAMETER_VALUE_DEFAULT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PROFILE_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> PROFILE_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.PROFILE_SOURCE class=md-nav__link> <span class=md-ellipsis> PROFILE_SOURCE </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.RISK_ADJUSTMENT class=md-nav__link> <span class=md-ellipsis> RISK_ADJUSTMENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.RULE_DESCRIPTION class=md-nav__link> <span class=md-ellipsis> RULE_DESCRIPTION </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.RULE_ID class=md-nav__link> <span class=md-ellipsis> RULE_ID </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.Row class=md-nav__link> <span class=md-ellipsis> Row </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.TARGET_COMPONENT class=md-nav__link> <span class=md-ellipsis> TARGET_COMPONENT </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.prefix_rule_set class=md-nav__link> <span class=md-ellipsis> prefix_rule_set </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.validation class=md-nav__link> <span class=md-ellipsis> validation </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn class=md-nav__link> <span class=md-ellipsis> CsvColumn </span> </a> <nav class=md-nav aria-label=CsvColumn> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_check_property_column_names class=md-nav__link> <span class=md-ellipsis> get_check_property_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_optional_column_names class=md-nav__link> <span class=md-ellipsis> get_filtered_optional_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_required_column_names class=md-nav__link> <span class=md-ellipsis> get_filtered_required_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_optional_column_names class=md-nav__link> <span class=md-ellipsis> get_optional_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_order class=md-nav__link> <span class=md-ellipsis> get_order </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_parameter_column_names class=md-nav__link> <span class=md-ellipsis> get_parameter_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names class=md-nav__link> <span class=md-ellipsis> get_required_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names_validation class=md-nav__link> <span class=md-ellipsis> get_required_column_names_validation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_rule_property_column_names class=md-nav__link> <span class=md-ellipsis> get_rule_property_column_names </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_optional class=md-nav__link> <span class=md-ellipsis> is_column_name_optional </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_parameter class=md-nav__link> <span class=md-ellipsis> is_column_name_parameter </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_required class=md-nav__link> <span class=md-ellipsis> is_column_name_required </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition class=md-nav__link> <span class=md-ellipsis> CsvToOscalComponentDefinition </span> </a> <nav class=md-nav aria-label=CsvToOscalComponentDefinition> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.configure class=md-nav__link> <span class=md-ellipsis> configure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_add class=md-nav__link> <span class=md-ellipsis> control_mappings_add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_del class=md-nav__link> <span class=md-ellipsis> control_mappings_del </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.get_class class=md-nav__link> <span class=md-ellipsis> get_class </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_add class=md-nav__link> <span class=md-ellipsis> rules_add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_del class=md-nav__link> <span class=md-ellipsis> rules_del </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_mod class=md-nav__link> <span class=md-ellipsis> rules_mod </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_add class=md-nav__link> <span class=md-ellipsis> set_params_add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_del class=md-nav__link> <span class=md-ellipsis> set_params_del </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_mod class=md-nav__link> <span class=md-ellipsis> set_params_mod </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.derive_control_id class=md-nav__link> <span class=md-ellipsis> derive_control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.derive_part_id class=md-nav__link> <span class=md-ellipsis> derive_part_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.etype class=md-nav__link> <span class=md-ellipsis> etype </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.is_validation class=md-nav__link> <span class=md-ellipsis> is_validation </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.row_property_builder class=md-nav__link> <span class=md-ellipsis> row_property_builder </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.csv_to_oscal_cd.synthesize_rule_key class=md-nav__link> <span class=md-ellipsis> synthesize_rule_key </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.csv_to_oscal_cd</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.csv_to_oscal_cd class="doc doc-heading"> <code>trestle.tasks.csv_to_oscal_cd</code> <a href=#trestle.tasks.csv_to_oscal_cd class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.csv_to_oscal_cd-attributes>Attributes<a href=#trestle.tasks.csv_to_oscal_cd-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.ADJUSTED_RISK_RATING class="doc doc-heading"> <code class="highlight language-python"><span class=n>ADJUSTED_RISK_RATING</span> <span class=o>=</span> <span class=s1>&#39;Adjusted_Risk_Rating&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.ADJUSTED_RISK_RATING class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.CHECK_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>CHECK_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Check_Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CHECK_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.CHECK_ID class="doc doc-heading"> <code class="highlight language-python"><span class=n>CHECK_ID</span> <span class=o>=</span> <span class=s1>&#39;Check_Id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CHECK_ID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.COMPONENT_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>COMPONENT_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Component_Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.COMPONENT_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.COMPONENT_TITLE class="doc doc-heading"> <code class="highlight language-python"><span class=n>COMPONENT_TITLE</span> <span class=o>=</span> <span class=s1>&#39;Component_Title&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.COMPONENT_TITLE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.COMPONENT_TYPE class="doc doc-heading"> <code class="highlight language-python"><span class=n>COMPONENT_TYPE</span> <span class=o>=</span> <span class=s1>&#39;Component_Type&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.COMPONENT_TYPE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.CONTROL_ID_LIST class="doc doc-heading"> <code class="highlight language-python"><span class=n>CONTROL_ID_LIST</span> <span class=o>=</span> <span class=s1>&#39;Control_Id_List&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CONTROL_ID_LIST class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.FETCHER_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>FETCHER_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Fetcher_Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.FETCHER_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.FETCHER_ID class="doc doc-heading"> <code class="highlight language-python"><span class=n>FETCHER_ID</span> <span class=o>=</span> <span class=s1>&#39;Fetcher_Id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.FETCHER_ID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.HEADER_DECORATION_CHAR class="doc doc-heading"> <code class="highlight language-python"><span class=n>HEADER_DECORATION_CHAR</span> <span class=o>=</span> <span class=s1>&#39;$&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.HEADER_DECORATION_CHAR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.NAMESPACE class="doc doc-heading"> <code class="highlight language-python"><span class=n>NAMESPACE</span> <span class=o>=</span> <span class=s1>&#39;Namespace&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.NAMESPACE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.ORIGINAL_RISK_RATING class="doc doc-heading"> <code class="highlight language-python"><span class=n>ORIGINAL_RISK_RATING</span> <span class=o>=</span> <span class=s1>&#39;Original_Risk_Rating&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.ORIGINAL_RISK_RATING class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.PARAMETER class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAMETER</span> <span class=o>=</span> <span class=s1>&#39;Parameter&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.PARAMETER_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAMETER_DESCRIPTION</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER</span><span class=si>}</span><span class=s1>_Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.PARAMETER_ID class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAMETER_ID</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER</span><span class=si>}</span><span class=s1>_Id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_ID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_ALTERNATIVES class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAMETER_VALUE_ALTERNATIVES</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER</span><span class=si>}</span><span class=s1>_Value_Alternatives&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_ALTERNATIVES class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_DEFAULT class="doc doc-heading"> <code class="highlight language-python"><span class=n>PARAMETER_VALUE_DEFAULT</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER</span><span class=si>}</span><span class=s1>_Value_Default&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_DEFAULT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.PROFILE_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROFILE_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Profile_Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.PROFILE_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.PROFILE_SOURCE class="doc doc-heading"> <code class="highlight language-python"><span class=n>PROFILE_SOURCE</span> <span class=o>=</span> <span class=s1>&#39;Profile_Source&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.PROFILE_SOURCE class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.RISK_ADJUSTMENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>RISK_ADJUSTMENT</span> <span class=o>=</span> <span class=s1>&#39;Risk_Adjustment&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.RISK_ADJUSTMENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.RULE_DESCRIPTION class="doc doc-heading"> <code class="highlight language-python"><span class=n>RULE_DESCRIPTION</span> <span class=o>=</span> <span class=s1>&#39;Rule_Description&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.RULE_DESCRIPTION class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.RULE_ID class="doc doc-heading"> <code class="highlight language-python"><span class=n>RULE_ID</span> <span class=o>=</span> <span class=s1>&#39;Rule_Id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.RULE_ID class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.Row class="doc doc-heading"> <code class="highlight language-python"><span class=n>Row</span> <span class=o>=</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.Row class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.TARGET_COMPONENT class="doc doc-heading"> <code class="highlight language-python"><span class=n>TARGET_COMPONENT</span> <span class=o>=</span> <span class=s1>&#39;Target_Component&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.TARGET_COMPONENT class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.prefix_rule_set class="doc doc-heading"> <code class="highlight language-python"><span class=n>prefix_rule_set</span> <span class=o>=</span> <span class=s1>&#39;rule_set_&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.prefix_rule_set class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.csv_to_oscal_cd.validation class="doc doc-heading"> <code class="highlight language-python"><span class=n>validation</span> <span class=o>=</span> <span class=s1>&#39;validation&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.validation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.csv_to_oscal_cd-classes>Classes<a href=#trestle.tasks.csv_to_oscal_cd-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.csv_to_oscal_cd.CsvColumn class="doc doc-heading"> <code>CsvColumn</code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>CsvColumn.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1393</span>
+<span class=normal>1394</span>
+<span class=normal>1395</span>
+<span class=normal>1396</span>
+<span class=normal>1397</span>
+<span class=normal>1398</span>
+<span class=normal>1399</span>
+<span class=normal>1400</span>
+<span class=normal>1401</span>
+<span class=normal>1402</span>
+<span class=normal>1403</span>
+<span class=normal>1404</span>
+<span class=normal>1405</span>
+<span class=normal>1406</span>
+<span class=normal>1407</span>
+<span class=normal>1408</span>
+<span class=normal>1409</span>
+<span class=normal>1410</span>
+<span class=normal>1411</span>
+<span class=normal>1412</span>
+<span class=normal>1413</span>
+<span class=normal>1414</span>
+<span class=normal>1415</span>
+<span class=normal>1416</span>
+<span class=normal>1417</span>
+<span class=normal>1418</span>
+<span class=normal>1419</span>
+<span class=normal>1420</span>
+<span class=normal>1421</span>
+<span class=normal>1422</span>
+<span class=normal>1423</span>
+<span class=normal>1424</span>
+<span class=normal>1425</span>
+<span class=normal>1426</span>
+<span class=normal>1427</span>
+<span class=normal>1428</span>
+<span class=normal>1429</span>
+<span class=normal>1430</span>
+<span class=normal>1431</span>
+<span class=normal>1432</span>
+<span class=normal>1433</span>
+<span class=normal>1434</span>
+<span class=normal>1435</span>
+<span class=normal>1436</span>
+<span class=normal>1437</span>
+<span class=normal>1438</span>
+<span class=normal>1439</span>
+<span class=normal>1440</span>
+<span class=normal>1441</span>
+<span class=normal>1442</span>
+<span class=normal>1443</span>
+<span class=normal>1444</span>
+<span class=normal>1445</span>
+<span class=normal>1446</span>
+<span class=normal>1447</span>
+<span class=normal>1448</span>
+<span class=normal>1449</span>
+<span class=normal>1450</span>
+<span class=normal>1451</span>
+<span class=normal>1452</span>
+<span class=normal>1453</span>
+<span class=normal>1454</span>
+<span class=normal>1455</span>
+<span class=normal>1456</span>
+<span class=normal>1457</span>
+<span class=normal>1458</span>
+<span class=normal>1459</span>
+<span class=normal>1460</span>
+<span class=normal>1461</span>
+<span class=normal>1462</span>
+<span class=normal>1463</span>
+<span class=normal>1464</span>
+<span class=normal>1465</span>
+<span class=normal>1466</span>
+<span class=normal>1467</span>
+<span class=normal>1468</span>
+<span class=normal>1469</span>
+<span class=normal>1470</span>
+<span class=normal>1471</span>
+<span class=normal>1472</span>
+<span class=normal>1473</span>
+<span class=normal>1474</span>
+<span class=normal>1475</span>
+<span class=normal>1476</span>
+<span class=normal>1477</span>
+<span class=normal>1478</span>
+<span class=normal>1479</span>
+<span class=normal>1480</span>
+<span class=normal>1481</span>
+<span class=normal>1482</span>
+<span class=normal>1483</span>
+<span class=normal>1484</span>
+<span class=normal>1485</span>
+<span class=normal>1486</span>
+<span class=normal>1487</span>
+<span class=normal>1488</span>
+<span class=normal>1489</span>
+<span class=normal>1490</span>
+<span class=normal>1491</span>
+<span class=normal>1492</span>
+<span class=normal>1493</span>
+<span class=normal>1494</span>
+<span class=normal>1495</span>
+<span class=normal>1496</span>
+<span class=normal>1497</span>
+<span class=normal>1498</span>
+<span class=normal>1499</span>
+<span class=normal>1500</span>
+<span class=normal>1501</span>
+<span class=normal>1502</span>
+<span class=normal>1503</span>
+<span class=normal>1504</span>
+<span class=normal>1505</span>
+<span class=normal>1506</span>
+<span class=normal>1507</span>
+<span class=normal>1508</span>
+<span class=normal>1509</span>
+<span class=normal>1510</span>
+<span class=normal>1511</span>
+<span class=normal>1512</span>
+<span class=normal>1513</span>
+<span class=normal>1514</span>
+<span class=normal>1515</span>
+<span class=normal>1516</span>
+<span class=normal>1517</span>
+<span class=normal>1518</span>
+<span class=normal>1519</span>
+<span class=normal>1520</span>
+<span class=normal>1521</span>
+<span class=normal>1522</span>
+<span class=normal>1523</span>
+<span class=normal>1524</span>
+<span class=normal>1525</span>
+<span class=normal>1526</span>
+<span class=normal>1527</span>
+<span class=normal>1528</span>
+<span class=normal>1529</span>
+<span class=normal>1530</span>
+<span class=normal>1531</span>
+<span class=normal>1532</span>
+<span class=normal>1533</span>
+<span class=normal>1534</span>
+<span class=normal>1535</span>
+<span class=normal>1536</span>
+<span class=normal>1537</span>
+<span class=normal>1538</span>
+<span class=normal>1539</span>
+<span class=normal>1540</span>
+<span class=normal>1541</span>
+<span class=normal>1542</span>
+<span class=normal>1543</span>
+<span class=normal>1544</span>
+<span class=normal>1545</span>
+<span class=normal>1546</span>
+<span class=normal>1547</span>
+<span class=normal>1548</span>
+<span class=normal>1549</span>
+<span class=normal>1550</span>
+<span class=normal>1551</span>
+<span class=normal>1552</span>
+<span class=normal>1553</span>
+<span class=normal>1554</span>
+<span class=normal>1555</span>
+<span class=normal>1556</span>
+<span class=normal>1557</span>
+<span class=normal>1558</span>
+<span class=normal>1559</span>
+<span class=normal>1560</span>
+<span class=normal>1561</span>
+<span class=normal>1562</span>
+<span class=normal>1563</span>
+<span class=normal>1564</span>
+<span class=normal>1565</span>
+<span class=normal>1566</span>
+<span class=normal>1567</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CsvColumn</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;CsvColumn.&quot;&quot;&quot;</span>
+
+    <span class=n>_columns_required</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>COMPONENT_TITLE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>COMPONENT_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>COMPONENT_TYPE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RULE_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RULE_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PROFILE_SOURCE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PROFILE_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CONTROL_ID_LIST</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>NAMESPACE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+    <span class=p>]</span>
+
+    <span class=n>_columns_required_validation</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>COMPONENT_TITLE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>COMPONENT_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>COMPONENT_TYPE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RULE_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>NAMESPACE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CHECK_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CHECK_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+    <span class=p>]</span>
+
+    <span class=n>_columns_optional</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CHECK_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CHECK_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>TARGET_COMPONENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ORIGINAL_RISK_RATING</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ADJUSTED_RISK_RATING</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RISK_ADJUSTMENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+    <span class=p>]</span>
+
+    <span class=n>_columns_parameter</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_VALUE_ALTERNATIVES</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_VALUE_DEFAULT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+    <span class=p>]</span>
+
+    <span class=n>_columns_ordered</span> <span class=o>=</span> <span class=n>_columns_required</span> <span class=o>+</span> <span class=n>_columns_parameter</span> <span class=o>+</span> <span class=n>_columns_optional</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_order</span><span class=p>(</span><span class=n>column_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get order for column_name.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>sys</span><span class=o>.</span><span class=n>maxsize</span>
+        <span class=k>if</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_ordered</span><span class=p>:</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_ordered</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>is_column_name_required</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Is column name required.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>name</span> <span class=ow>in</span> <span class=p>(</span><span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_required</span> <span class=o>+</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_required_validation</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>is_column_name_optional</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Is column name optional.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>name</span> <span class=ow>in</span> <span class=p>(</span><span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_optional</span><span class=p>)</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>is_column_name_parameter</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Is column name parameter.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>cname</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_parameter</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>name</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>cname</span><span class=p>):</span>
+                <span class=k>return</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=kc>False</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_required_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get required column names.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>rval</span> <span class=o>+=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_required</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_optional_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get optional column names.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>rval</span> <span class=o>+=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_optional</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_parameter_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parameter column names.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>rval</span> <span class=o>+=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_parameters</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_required_column_names_validation</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get required column names validation.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>rval</span> <span class=o>+=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_required_validation</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=n>_rule_property_column_names</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RULE_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RULE_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_VALUE_ALTERNATIVES</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CHECK_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CHECK_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>TARGET_COMPONENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ORIGINAL_RISK_RATING</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ADJUSTED_RISK_RATING</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RISK_ADJUSTMENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+    <span class=p>]</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_rule_property_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get rule property column names.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_rule_property_column_names</span>
+
+    <span class=c1># columns required which do not become properties</span>
+    <span class=n>_columns_required_filtered</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>COMPONENT_TITLE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>COMPONENT_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>COMPONENT_TYPE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PROFILE_SOURCE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PROFILE_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CONTROL_ID_LIST</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>NAMESPACE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+    <span class=p>]</span>
+
+    <span class=c1># optional columns which do not become properties, initially</span>
+    <span class=n>_columns_optional_filtered</span> <span class=o>=</span> <span class=p>[]</span>
+
+    <span class=n>_columns_filtered</span> <span class=o>=</span> <span class=n>_columns_required_filtered</span> <span class=o>+</span> <span class=n>_columns_optional_filtered</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_filtered_required_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get filtered required column names.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_required_column_names</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>column_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_filtered</span><span class=p>:</span>
+                <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_filtered_optional_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get filtered optional column names.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_optional_column_names</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>column_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_filtered</span><span class=p>:</span>
+                <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=n>_check_property_column_names</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RULE_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CHECK_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CHECK_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>TARGET_COMPONENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+    <span class=p>]</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_check_property_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get check property column names.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_check_property_column_names</span>
+
+    <span class=c1># optional columns which do become properties, afterwards</span>
+    <span class=n>_columns_parameters</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_ID</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_VALUE_ALTERNATIVES</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+    <span class=p>]</span>
+
+    <span class=c1># optional columns which require Param_Id be present in the row</span>
+    <span class=n>_columns_parameters_dependent</span> <span class=o>=</span> <span class=p>[</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_VALUE_ALTERNATIVES</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+        <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_VALUE_DEFAULT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+    <span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.csv_to_oscal_cd.CsvColumn-functions>Functions<a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.get_check_property_column_names class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_check_property_column_names</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_check_property_column_names class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get check property column names.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1550</span>
+<span class=normal>1551</span>
+<span class=normal>1552</span>
+<span class=normal>1553</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_check_property_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get check property column names.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_check_property_column_names</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_optional_column_names class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_filtered_optional_column_names</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_optional_column_names class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get filtered optional column names.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1534</span>
+<span class=normal>1535</span>
+<span class=normal>1536</span>
+<span class=normal>1537</span>
+<span class=normal>1538</span>
+<span class=normal>1539</span>
+<span class=normal>1540</span>
+<span class=normal>1541</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_filtered_optional_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get filtered optional column names.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_optional_column_names</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>column_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_filtered</span><span class=p>:</span>
+            <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_required_column_names class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_filtered_required_column_names</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_required_column_names class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get filtered required column names.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1525</span>
+<span class=normal>1526</span>
+<span class=normal>1527</span>
+<span class=normal>1528</span>
+<span class=normal>1529</span>
+<span class=normal>1530</span>
+<span class=normal>1531</span>
+<span class=normal>1532</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_filtered_required_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get filtered required column names.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_required_column_names</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>column_name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_filtered</span><span class=p>:</span>
+            <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.get_optional_column_names class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_optional_column_names</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_optional_column_names class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get optional column names.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1469</span>
+<span class=normal>1470</span>
+<span class=normal>1471</span>
+<span class=normal>1472</span>
+<span class=normal>1473</span>
+<span class=normal>1474</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_optional_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get optional column names.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>rval</span> <span class=o>+=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_optional</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.get_order class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_order</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_order class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get order for column_name.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1436</span>
+<span class=normal>1437</span>
+<span class=normal>1438</span>
+<span class=normal>1439</span>
+<span class=normal>1440</span>
+<span class=normal>1441</span>
+<span class=normal>1442</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_order</span><span class=p>(</span><span class=n>column_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get order for column_name.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=n>sys</span><span class=o>.</span><span class=n>maxsize</span>
+    <span class=k>if</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_ordered</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_ordered</span><span class=o>.</span><span class=n>index</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.get_parameter_column_names class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_parameter_column_names</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_parameter_column_names class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get parameter column names.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1476</span>
+<span class=normal>1477</span>
+<span class=normal>1478</span>
+<span class=normal>1479</span>
+<span class=normal>1480</span>
+<span class=normal>1481</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_parameter_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get parameter column names.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>rval</span> <span class=o>+=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_parameters</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_required_column_names</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get required column names.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1462</span>
+<span class=normal>1463</span>
+<span class=normal>1464</span>
+<span class=normal>1465</span>
+<span class=normal>1466</span>
+<span class=normal>1467</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_required_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get required column names.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>rval</span> <span class=o>+=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_required</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names_validation class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_required_column_names_validation</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names_validation class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get required column names validation.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1483</span>
+<span class=normal>1484</span>
+<span class=normal>1485</span>
+<span class=normal>1486</span>
+<span class=normal>1487</span>
+<span class=normal>1488</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_required_column_names_validation</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get required column names validation.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>rval</span> <span class=o>+=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_required_validation</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.get_rule_property_column_names class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_rule_property_column_names</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_rule_property_column_names class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get rule property column names.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1504</span>
+<span class=normal>1505</span>
+<span class=normal>1506</span>
+<span class=normal>1507</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_rule_property_column_names</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get rule property column names.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_rule_property_column_names</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_optional class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_column_name_optional</span><span class=p>(</span><span class=n>name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_optional class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Is column name optional.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1449</span>
+<span class=normal>1450</span>
+<span class=normal>1451</span>
+<span class=normal>1452</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>is_column_name_optional</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Is column name optional.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>name</span> <span class=ow>in</span> <span class=p>(</span><span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_optional</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_parameter class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_column_name_parameter</span><span class=p>(</span><span class=n>name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_parameter class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Is column name parameter.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1454</span>
+<span class=normal>1455</span>
+<span class=normal>1456</span>
+<span class=normal>1457</span>
+<span class=normal>1458</span>
+<span class=normal>1459</span>
+<span class=normal>1460</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>is_column_name_parameter</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Is column name parameter.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>cname</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_parameter</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>name</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>cname</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=kc>False</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_required class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_column_name_required</span><span class=p>(</span><span class=n>name</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_required class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Is column name required.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>1444</span>
+<span class=normal>1445</span>
+<span class=normal>1446</span>
+<span class=normal>1447</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>is_column_name_required</span><span class=p>(</span><span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Is column name required.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>name</span> <span class=ow>in</span> <span class=p>(</span><span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_required</span> <span class=o>+</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>_columns_required_validation</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition class="doc doc-heading"> <code>CsvToOscalComponentDefinition</code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to create OSCAL ComponentDefinition json.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.name href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span>
+<span class=normal>654</span>
+<span class=normal>655</span>
+<span class=normal>656</span>
+<span class=normal>657</span>
+<span class=normal>658</span>
+<span class=normal>659</span>
+<span class=normal>660</span>
+<span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span>
+<span class=normal>664</span>
+<span class=normal>665</span>
+<span class=normal>666</span>
+<span class=normal>667</span>
+<span class=normal>668</span>
+<span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span>
+<span class=normal>672</span>
+<span class=normal>673</span>
+<span class=normal>674</span>
+<span class=normal>675</span>
+<span class=normal>676</span>
+<span class=normal>677</span>
+<span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span>
+<span class=normal>685</span>
+<span class=normal>686</span>
+<span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span>
+<span class=normal>700</span>
+<span class=normal>701</span>
+<span class=normal>702</span>
+<span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span>
+<span class=normal>706</span>
+<span class=normal>707</span>
+<span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span>
+<span class=normal>714</span>
+<span class=normal>715</span>
+<span class=normal>716</span>
+<span class=normal>717</span>
+<span class=normal>718</span>
+<span class=normal>719</span>
+<span class=normal>720</span>
+<span class=normal>721</span>
+<span class=normal>722</span>
+<span class=normal>723</span>
+<span class=normal>724</span>
+<span class=normal>725</span>
+<span class=normal>726</span>
+<span class=normal>727</span>
+<span class=normal>728</span>
+<span class=normal>729</span>
+<span class=normal>730</span>
+<span class=normal>731</span>
+<span class=normal>732</span>
+<span class=normal>733</span>
+<span class=normal>734</span>
+<span class=normal>735</span>
+<span class=normal>736</span>
+<span class=normal>737</span>
+<span class=normal>738</span>
+<span class=normal>739</span>
+<span class=normal>740</span>
+<span class=normal>741</span>
+<span class=normal>742</span>
+<span class=normal>743</span>
+<span class=normal>744</span>
+<span class=normal>745</span>
+<span class=normal>746</span>
+<span class=normal>747</span>
+<span class=normal>748</span>
+<span class=normal>749</span>
+<span class=normal>750</span>
+<span class=normal>751</span>
+<span class=normal>752</span>
+<span class=normal>753</span>
+<span class=normal>754</span>
+<span class=normal>755</span>
+<span class=normal>756</span>
+<span class=normal>757</span>
+<span class=normal>758</span>
+<span class=normal>759</span>
+<span class=normal>760</span>
+<span class=normal>761</span>
+<span class=normal>762</span>
+<span class=normal>763</span>
+<span class=normal>764</span>
+<span class=normal>765</span>
+<span class=normal>766</span>
+<span class=normal>767</span>
+<span class=normal>768</span>
+<span class=normal>769</span>
+<span class=normal>770</span>
+<span class=normal>771</span>
+<span class=normal>772</span>
+<span class=normal>773</span>
+<span class=normal>774</span>
+<span class=normal>775</span>
+<span class=normal>776</span>
+<span class=normal>777</span>
+<span class=normal>778</span>
+<span class=normal>779</span>
+<span class=normal>780</span>
+<span class=normal>781</span>
+<span class=normal>782</span>
+<span class=normal>783</span>
+<span class=normal>784</span>
+<span class=normal>785</span>
+<span class=normal>786</span>
+<span class=normal>787</span>
+<span class=normal>788</span>
+<span class=normal>789</span>
+<span class=normal>790</span>
+<span class=normal>791</span>
+<span class=normal>792</span>
+<span class=normal>793</span>
+<span class=normal>794</span>
+<span class=normal>795</span>
+<span class=normal>796</span>
+<span class=normal>797</span>
+<span class=normal>798</span>
+<span class=normal>799</span>
+<span class=normal>800</span>
+<span class=normal>801</span>
+<span class=normal>802</span>
+<span class=normal>803</span>
+<span class=normal>804</span>
+<span class=normal>805</span>
+<span class=normal>806</span>
+<span class=normal>807</span>
+<span class=normal>808</span>
+<span class=normal>809</span>
+<span class=normal>810</span>
+<span class=normal>811</span>
+<span class=normal>812</span>
+<span class=normal>813</span>
+<span class=normal>814</span>
+<span class=normal>815</span>
+<span class=normal>816</span>
+<span class=normal>817</span>
+<span class=normal>818</span>
+<span class=normal>819</span>
+<span class=normal>820</span>
+<span class=normal>821</span>
+<span class=normal>822</span>
+<span class=normal>823</span>
+<span class=normal>824</span>
+<span class=normal>825</span>
+<span class=normal>826</span>
+<span class=normal>827</span>
+<span class=normal>828</span>
+<span class=normal>829</span>
+<span class=normal>830</span>
+<span class=normal>831</span>
+<span class=normal>832</span>
+<span class=normal>833</span>
+<span class=normal>834</span>
+<span class=normal>835</span>
+<span class=normal>836</span>
+<span class=normal>837</span>
+<span class=normal>838</span>
+<span class=normal>839</span>
+<span class=normal>840</span>
+<span class=normal>841</span>
+<span class=normal>842</span>
+<span class=normal>843</span>
+<span class=normal>844</span>
+<span class=normal>845</span>
+<span class=normal>846</span>
+<span class=normal>847</span>
+<span class=normal>848</span>
+<span class=normal>849</span>
+<span class=normal>850</span>
+<span class=normal>851</span>
+<span class=normal>852</span>
+<span class=normal>853</span>
+<span class=normal>854</span>
+<span class=normal>855</span>
+<span class=normal>856</span>
+<span class=normal>857</span>
+<span class=normal>858</span>
+<span class=normal>859</span>
+<span class=normal>860</span>
+<span class=normal>861</span>
+<span class=normal>862</span>
+<span class=normal>863</span>
+<span class=normal>864</span>
+<span class=normal>865</span>
+<span class=normal>866</span>
+<span class=normal>867</span>
+<span class=normal>868</span>
+<span class=normal>869</span>
+<span class=normal>870</span>
+<span class=normal>871</span>
+<span class=normal>872</span>
+<span class=normal>873</span>
+<span class=normal>874</span>
+<span class=normal>875</span>
+<span class=normal>876</span>
+<span class=normal>877</span>
+<span class=normal>878</span>
+<span class=normal>879</span>
+<span class=normal>880</span>
+<span class=normal>881</span>
+<span class=normal>882</span>
+<span class=normal>883</span>
+<span class=normal>884</span>
+<span class=normal>885</span>
+<span class=normal>886</span>
+<span class=normal>887</span>
+<span class=normal>888</span>
+<span class=normal>889</span>
+<span class=normal>890</span>
+<span class=normal>891</span>
+<span class=normal>892</span>
+<span class=normal>893</span>
+<span class=normal>894</span>
+<span class=normal>895</span>
+<span class=normal>896</span>
+<span class=normal>897</span>
+<span class=normal>898</span>
+<span class=normal>899</span>
+<span class=normal>900</span>
+<span class=normal>901</span>
+<span class=normal>902</span>
+<span class=normal>903</span>
+<span class=normal>904</span>
+<span class=normal>905</span>
+<span class=normal>906</span>
+<span class=normal>907</span>
+<span class=normal>908</span>
+<span class=normal>909</span>
+<span class=normal>910</span>
+<span class=normal>911</span>
+<span class=normal>912</span>
+<span class=normal>913</span>
+<span class=normal>914</span>
+<span class=normal>915</span>
+<span class=normal>916</span>
+<span class=normal>917</span>
+<span class=normal>918</span>
+<span class=normal>919</span>
+<span class=normal>920</span>
+<span class=normal>921</span>
+<span class=normal>922</span>
+<span class=normal>923</span>
+<span class=normal>924</span>
+<span class=normal>925</span>
+<span class=normal>926</span>
+<span class=normal>927</span>
+<span class=normal>928</span>
+<span class=normal>929</span>
+<span class=normal>930</span>
+<span class=normal>931</span>
+<span class=normal>932</span>
+<span class=normal>933</span>
+<span class=normal>934</span>
+<span class=normal>935</span>
+<span class=normal>936</span>
+<span class=normal>937</span>
+<span class=normal>938</span>
+<span class=normal>939</span>
+<span class=normal>940</span>
+<span class=normal>941</span>
+<span class=normal>942</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CsvToOscalComponentDefinition</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to create OSCAL ComponentDefinition json.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;csv-to-oscal-cd&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task csv-to-oscal-cd.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>name</span>
+        <span class=n>oscal_name</span> <span class=o>=</span> <span class=s1>&#39;component_definition&#39;</span>
+        <span class=c1># help note identifiers</span>
+        <span class=n>note01</span> <span class=o>=</span> <span class=s1>&#39;1&#39;</span>
+        <span class=n>note02</span> <span class=o>=</span> <span class=s1>&#39;2&#39;</span>
+        <span class=n>note03</span> <span class=o>=</span> <span class=s1>&#39;3&#39;</span>
+        <span class=n>note04</span> <span class=o>=</span> <span class=s1>&#39;4&#39;</span>
+        <span class=n>note05</span> <span class=o>=</span> <span class=s1>&#39;5&#39;</span>
+        <span class=c1># help generation</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Purpose: From csv produce OSCAL </span><span class=si>{</span><span class=n>oscal_name</span><span class=si>}</span><span class=s1> file.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Configuration flags sit under [task.</span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>]:&#39;</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  title                = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the component definition title.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  version              = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the component definition version.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  csv-file             = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the csv file.&#39;</span>
+        <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39; [1st row are column headings; 2nd row are column descriptions; 3rd row and beyond is data]&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  required columns:      &#39;</span>
+        <span class=k>for</span> <span class=n>text2</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_required_column_names</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>text2</span> <span class=ow>in</span> <span class=p>[</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RULE_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PROFILE_SOURCE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PROFILE_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CONTROL_ID_LIST</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>]:</span>
+                <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see note </span><span class=si>{</span><span class=n>note01</span><span class=si>}</span><span class=s1>)&#39;</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=s1>&#39;$$&#39;</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+            <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;                         &#39;</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  optional columns:      &#39;</span>
+        <span class=k>for</span> <span class=n>text2</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_optional_column_names</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>text2</span> <span class=ow>in</span> <span class=p>[</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ORIGINAL_RISK_RATING</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ADJUSTED_RISK_RATING</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RISK_ADJUSTMENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>]:</span>
+                <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see note </span><span class=si>{</span><span class=n>note01</span><span class=si>}</span><span class=s1>)&#39;</span>
+            <span class=k>elif</span> <span class=n>text2</span> <span class=ow>in</span> <span class=p>[</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>TARGET_COMPONENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>]:</span>
+                <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see note </span><span class=si>{</span><span class=n>note03</span><span class=si>}</span><span class=s1>)&#39;</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see note </span><span class=si>{</span><span class=n>note02</span><span class=si>}</span><span class=s1>)&#39;</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=s1>&#39;$&#39;</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+            <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;                         &#39;</span>
+        <span class=k>for</span> <span class=n>text2</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_parameter_column_names</span><span class=p>():</span>
+            <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see notes </span><span class=si>{</span><span class=n>note01</span><span class=si>}</span><span class=s1>, </span><span class=si>{</span><span class=n>note05</span><span class=si>}</span><span class=s1>)&#39;</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=s1>&#39;$&#39;</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+            <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;                         &#39;</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  comment columns:       &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Informational (see note </span><span class=si>{</span><span class=n>note04</span><span class=si>}</span><span class=s1>)&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=s1>&#39;#&#39;</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir           = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the output directory for synthesized OSCAL .json files.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  component-definition = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) the path of the existing component-definition OSCAL .json file.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  class.column-name    = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;(optional) the class to associate with the specified column name, e.g. class.</span><span class=si>{</span><span class=n>RULE_ID</span><span class=si>}</span><span class=s1> = scc_class&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite     = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  validate-controls    = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) on, warn, or off [default]; validate controls exist in resolved profile.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=c1># Notes</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;Notes: &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note01</span><span class=si>}</span><span class=s1>] column is ignored for validation component type&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;       &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note02</span><span class=si>}</span><span class=s1>] column is required for validation component type&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;       &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note03</span><span class=si>}</span><span class=s1>] column is optional for validation component type&#39;</span>
+        <span class=n>text3</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;, but may be needed to prevent </span><span class=si>{</span><span class=n>RULE_ID</span><span class=si>}</span><span class=s1> collisions&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;       &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note04</span><span class=si>}</span><span class=s1>] column name starting with # causes column to be ignored&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;       &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note05</span><span class=si>}</span><span class=s1>] additional parameters are specified by adding a common suffix per set&#39;</span>
+        <span class=n>text3</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;, for example: </span><span class=si>{</span><span class=n>PARAMETER_ID</span><span class=si>}</span><span class=s1>_1, </span><span class=si>{</span><span class=n>PARAMETER_DESCRIPTION</span><span class=si>}</span><span class=s1>_1, ...</span><span class=si>{</span><span class=n>PARAMETER_ID</span><span class=si>}</span><span class=s1>_2...&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>configure</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Configure.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+        <span class=c1># config verbosity</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_quiet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_quiet</span>
+        <span class=c1># title</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;title&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_title</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;title&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=c1># version</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;version&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;version&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=c1># config csv</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_csv_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;csv-file&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_file</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;csv-file&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_csv_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_file</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;&quot;csv-file&quot; not found&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=c1># announce csv</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># config cd</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cd_path</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cd_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;component-definition&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_file</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_cd_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_cd_file</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;&quot;component-definition&quot; not found&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+        <span class=c1># workspace</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_workspace</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>getcwd</span><span class=p>()</span>
+        <span class=c1># validate_controls</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_validate_controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;validate-controls&#39;</span><span class=p>,</span> <span class=s1>&#39;off&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>get_class</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get class value for specified name from config.&quot;&quot;&quot;</span>
+        <span class=n>key</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;class.</span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an executed outcome.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute path core.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>configure</span><span class=p>():</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config output</span>
+        <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;output-dir&#39;</span><span class=p>)</span>
+        <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># calculate output file name &amp; check writability</span>
+        <span class=n>oname</span> <span class=o>=</span> <span class=s1>&#39;component-definition.json&#39;</span>
+        <span class=n>ofile</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># fetch existing component-definition, if any</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span> <span class=o>=</span> <span class=n>_CdMgr</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_cd_path</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_title</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_version</span><span class=p>)</span>
+        <span class=c1># fetch csv</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span> <span class=o>=</span> <span class=n>_CsvMgr</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_path</span><span class=p>)</span>
+        <span class=c1># create resolved profile -&gt; catalog helper</span>
+        <span class=n>profile_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_profile_list</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_profile_catalog_helper</span> <span class=o>=</span> <span class=n>_ResolvedProfileCatalogHelper</span><span class=p>(</span><span class=n>profile_list</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_workspace</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_unresolved_controls</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># calculate deletion, addition &amp; modification rule lists</span>
+        <span class=n>rules</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_calculate_rules</span><span class=p>()</span>
+        <span class=c1># calculate deletion, addition &amp; modification set-parameter lists</span>
+        <span class=n>set_params</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_calculate_set_params</span><span class=p>(</span><span class=n>rules</span><span class=p>[</span><span class=mi>2</span><span class=p>])</span>
+        <span class=c1># calculate deletion, addition &amp; modification control mapping lists</span>
+        <span class=n>control_mappings</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_calculate_control_mappings</span><span class=p>(</span><span class=n>rules</span><span class=p>[</span><span class=mi>2</span><span class=p>])</span>
+        <span class=c1># rule set manager</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_rule_set_id_mgr</span> <span class=o>=</span> <span class=n>_RuleSetIdMgr</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_max_rule_set_number</span><span class=p>(),</span> <span class=nb>len</span><span class=p>(</span><span class=n>rules</span><span class=p>[</span><span class=mi>1</span><span class=p>]))</span>
+        <span class=c1># rule additions, deletions &amp; modifications (by row)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rules_del</span><span class=p>(</span><span class=n>rules</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rules_add</span><span class=p>(</span><span class=n>rules</span><span class=p>[</span><span class=mi>1</span><span class=p>])</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rules_mod</span><span class=p>(</span><span class=n>rules</span><span class=p>[</span><span class=mi>2</span><span class=p>])</span>
+        <span class=c1># set-parameters additions, deletions &amp; modifications (by row)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>set_params_del</span><span class=p>(</span><span class=n>set_params</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>set_params_add</span><span class=p>(</span><span class=n>set_params</span><span class=p>[</span><span class=mi>1</span><span class=p>])</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>set_params_mod</span><span class=p>(</span><span class=n>set_params</span><span class=p>[</span><span class=mi>2</span><span class=p>])</span>
+        <span class=c1># control mappings additions, deletions &amp; modifications (by row)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>control_mappings_del</span><span class=p>(</span><span class=n>control_mappings</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>control_mappings_add</span><span class=p>(</span><span class=n>control_mappings</span><span class=p>[</span><span class=mi>1</span><span class=p>])</span>
+        <span class=c1># note: control mappings mod is currently not possible</span>
+        <span class=c1># note: add/del user columns not currently supported</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_unresolved_controls</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Unresolved controls: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_unresolved_controls</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_controls</span> <span class=o>==</span> <span class=s1>&#39;warn&#39;</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_controls</span> <span class=o>==</span> <span class=s1>&#39;on&#39;</span><span class=p>:</span>
+                <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=c1># prepare new/revised component definition</span>
+        <span class=n>component_definition</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_component_definition</span><span class=p>()</span>
+        <span class=c1># write OSCAL ComponentDefinition to file</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>component_definition</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_calculate_rules</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>tuple</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Calculate rules add, delete, modify.&quot;&quot;&quot;</span>
+        <span class=n>cd_rules</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_rule_keys</span><span class=p>()</span>
+        <span class=n>csv_rules</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_rule_keys</span><span class=p>()</span>
+        <span class=n>del_rules</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>add_rules</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>mod_rules</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>cd_rules</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>csv_rules</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>del_rules</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rules del: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>csv_rules</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>cd_rules</span><span class=p>:</span>
+                <span class=n>mod_rules</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rules mod: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>add_rules</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rules add: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=p>(</span><span class=n>del_rules</span><span class=p>,</span> <span class=n>add_rules</span><span class=p>,</span> <span class=n>mod_rules</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_calculate_set_params</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>mod_rules</span><span class=p>:</span> <span class=n>List</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>tuple</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Calculate set parameters add, delete, modify.&quot;&quot;&quot;</span>
+        <span class=n>cd_set_params</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_set_params_keys</span><span class=p>()</span>
+        <span class=n>csv_set_params</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_set_params_keys</span><span class=p>()</span>
+        <span class=n>del_set_params</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>add_set_params</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>mod_set_params</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>cd_set_params</span><span class=p>:</span>
+            <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>key</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>key</span><span class=p>[</span><span class=mi>1</span><span class=p>],</span> <span class=n>key</span><span class=p>[</span><span class=mi>2</span><span class=p>],</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>rule_key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>mod_rules</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>csv_set_params</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>del_set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;params del: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>csv_set_params</span><span class=p>:</span>
+            <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>key</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>key</span><span class=p>[</span><span class=mi>1</span><span class=p>],</span> <span class=n>key</span><span class=p>[</span><span class=mi>2</span><span class=p>],</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>rule_key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>mod_rules</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>cd_set_params</span><span class=p>:</span>
+                <span class=n>mod_set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;params mod: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>add_set_params</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;params add: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=p>(</span><span class=n>del_set_params</span><span class=p>,</span> <span class=n>add_set_params</span><span class=p>,</span> <span class=n>mod_set_params</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_calculate_control_mappings</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>mod_rules</span><span class=p>:</span> <span class=n>List</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>tuple</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Calculate control mappings add, delete, modify.&quot;&quot;&quot;</span>
+        <span class=n>cd_controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_control_keys</span><span class=p>()</span>
+        <span class=n>csv_controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_control_keys</span><span class=p>()</span>
+        <span class=n>del_control_mappings</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>add_control_mappings</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>mod_control_mappings</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>cd_controls</span><span class=p>:</span>
+            <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>key</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>key</span><span class=p>[</span><span class=mi>1</span><span class=p>],</span> <span class=n>key</span><span class=p>[</span><span class=mi>2</span><span class=p>],</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>rule_key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>mod_rules</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>csv_controls</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>del_control_mappings</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;ctl-maps del: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>csv_controls</span><span class=p>:</span>
+            <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>key</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>key</span><span class=p>[</span><span class=mi>1</span><span class=p>],</span> <span class=n>key</span><span class=p>[</span><span class=mi>2</span><span class=p>],</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>rule_key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>mod_rules</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>cd_controls</span><span class=p>:</span>
+                <span class=n>mod_control_mappings</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;ctl-maps mod: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>add_control_mappings</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;ctl-maps add: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=p>(</span><span class=n>del_control_mappings</span><span class=p>,</span> <span class=n>add_control_mappings</span><span class=p>,</span> <span class=n>mod_control_mappings</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_namespace</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule_key</span><span class=p>:</span> <span class=nb>tuple</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get namespace.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>NAMESPACE</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_get_prop_name</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>column_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get property name.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>column_name</span><span class=o>.</span><span class=n>lstrip</span><span class=p>(</span><span class=s1>&#39;$&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>rules_del</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>del_rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete rules.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=n>del_rules</span><span class=p>:</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=c1># component</span>
+            <span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_component</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>description</span><span class=p>)</span>
+            <span class=c1># props</span>
+            <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_delete_rule_props</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_delete_rule_props</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>component</span><span class=p>:</span> <span class=n>DefinedComponent</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete rule props.&quot;&quot;&quot;</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>rule_set</span> <span class=o>=</span> <span class=n>_RuleSetHelper</span><span class=o>.</span><span class=n>get_rule_set</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>component</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>remarks</span> <span class=o>!=</span> <span class=n>rule_set</span><span class=p>:</span>
+                <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_parameter_id_column_names</span><span class=p>():</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_delete_rule_set_parameter</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>RULE_ID</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_delete_rule_implemented_requirement</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>props</span>
+
+    <span class=k>def</span> <span class=nf>_control_implementation_generator</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control_implementations</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ControlImplementation</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>ControlImplementation</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Control implementation generator.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>control_implementations</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>control_implementation</span> <span class=ow>in</span> <span class=n>control_implementations</span><span class=p>:</span>
+                <span class=k>yield</span> <span class=n>control_implementation</span>
+
+    <span class=k>def</span> <span class=nf>_set_parameter_generator</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>set_parameters</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set parameter generator.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>set_parameters</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>set_parameter</span> <span class=ow>in</span> <span class=n>set_parameters</span><span class=p>:</span>
+                <span class=k>yield</span> <span class=n>set_parameter</span>
+
+    <span class=k>def</span> <span class=nf>_implemented_requirement_generator</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>implemented_requirements</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ImplementedRequirement</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>ImplementedRequirement</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Implemented-requirement generator.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>implemented_requirements</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>implemented_requirement</span> <span class=ow>in</span> <span class=n>implemented_requirements</span><span class=p>:</span>
+                <span class=k>yield</span> <span class=n>implemented_requirement</span>
+
+    <span class=k>def</span> <span class=nf>_delete_rule_set_parameter</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>component</span><span class=p>:</span> <span class=n>DefinedComponent</span><span class=p>,</span> <span class=n>parameter_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete rule set-parameter.&quot;&quot;&quot;</span>
+        <span class=n>control_implementations</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span>
+        <span class=k>for</span> <span class=n>control_implementation</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_implementation_generator</span><span class=p>(</span><span class=n>control_implementations</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>:</span>
+                <span class=n>set_parameters</span> <span class=o>=</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span>
+                <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>set_parameter</span> <span class=ow>in</span> <span class=n>set_parameters</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>set_parameter</span><span class=o>.</span><span class=n>param_id</span> <span class=o>!=</span> <span class=n>parameter_id</span><span class=p>:</span>
+                        <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>add_set_parameter</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span> <span class=n>set_parameter</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=nb>len</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                    <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_delete_rule_implemented_requirement</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>component</span><span class=p>:</span> <span class=n>DefinedComponent</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete rule implemented_requirement.&quot;&quot;&quot;</span>
+        <span class=n>control_implementations</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span>
+        <span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>control_implementation</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_implementation_generator</span><span class=p>(</span><span class=n>control_implementations</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+                <span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span>
+                <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>implemented_requirement</span> <span class=ow>in</span> <span class=n>implemented_requirements</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_delete_ir_props</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_delete_ir_statements</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>))</span> <span class=ow>or</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>)):</span>
+                        <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>)</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>)):</span>
+                <span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_implementation</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_delete_ir_statements</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>implemented_requirement</span><span class=p>:</span> <span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete implemented-requirement statements.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>:</span>
+            <span class=n>statements</span> <span class=o>=</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span>
+            <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>statements</span><span class=p>:</span>
+                <span class=n>statement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_delete_props</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=nb>len</span><span class=p>(</span><span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+                    <span class=n>statement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=kc>None</span>
+                <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                    <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=nb>len</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>):</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_delete_ir_props</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>implemented_requirement</span><span class=p>:</span> <span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete implemented-requirement props.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_delete_props</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=nb>len</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>_delete_props</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>],</span> <span class=n>rule_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Delete props.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>props</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>props</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>RULE_ID</span> <span class=ow>and</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span> <span class=o>==</span> <span class=n>rule_id</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>rules_add</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>add_rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add rules.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>rule_key</span> <span class=ow>in</span> <span class=n>add_rules</span><span class=p>:</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_TITLE</span><span class=p>)</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_TYPE</span><span class=p>)</span>
+            <span class=n>component_description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_DESCRIPTION</span><span class=p>)</span>
+            <span class=c1># component</span>
+            <span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_component</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>component_description</span><span class=p>)</span>
+            <span class=c1># props</span>
+            <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+            <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>+</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_rule_props</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+            <span class=c1># additional props, when not validation component</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_validation</span><span class=p>(</span><span class=n>rule_key</span><span class=p>):</span>
+                <span class=c1># control implementation</span>
+                <span class=n>source</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>PROFILE_SOURCE</span><span class=p>)</span>
+                <span class=n>description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>PROFILE_DESCRIPTION</span><span class=p>)</span>
+                <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_control_implementation</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span><span class=p>)</span>
+                <span class=c1># set-parameters</span>
+                <span class=n>set_parameters</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_set_parameters</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>set_parameters</span><span class=p>:</span>
+                    <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+                    <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>add_set_parameters</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span> <span class=n>set_parameters</span><span class=p>)</span>
+                <span class=c1># control-mappings</span>
+                <span class=n>control_mappings</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>CONTROL_ID_LIST</span><span class=p>)</span><span class=o>.</span><span class=n>split</span><span class=p>()</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_rule_prop</span><span class=p>(</span><span class=n>control_implementation</span><span class=p>,</span> <span class=n>control_mappings</span><span class=p>,</span> <span class=n>rule_key</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_is_validation</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule_key</span><span class=p>:</span> <span class=nb>tuple</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check for validation component.&quot;&quot;&quot;</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_TYPE</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>is_validation</span><span class=p>(</span><span class=n>component_type</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_rule_prop</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control_implementation</span><span class=p>:</span> <span class=n>ControlImplementation</span><span class=p>,</span> <span class=n>control_mappings</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>rule_key</span><span class=p>:</span> <span class=nb>tuple</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add rule prop.&quot;&quot;&quot;</span>
+        <span class=n>namespace</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_namespace</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>control_mapping</span> <span class=ow>in</span> <span class=n>control_mappings</span><span class=p>:</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=n>derive_control_id</span><span class=p>(</span><span class=n>control_mapping</span><span class=p>)</span>
+            <span class=n>implemented_requirement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_implemented_requirement</span><span class=p>(</span><span class=n>control_implementation</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+            <span class=c1># create rule implementation (as property)</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>RULE_ID</span>
+            <span class=n>prop</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+                <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+                <span class=n>value</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>name</span><span class=p>),</span>
+                <span class=n>ns</span><span class=o>=</span><span class=n>namespace</span><span class=p>,</span>
+                <span class=n>class_</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>get_class</span><span class=p>(</span><span class=n>name</span><span class=p>),</span>
+            <span class=p>)</span>
+            <span class=n>part_id</span> <span class=o>=</span> <span class=n>derive_part_id</span><span class=p>(</span><span class=n>control_mapping</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>part_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>statement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_statement</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>,</span> <span class=n>part_id</span><span class=p>)</span>
+                <span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_create_rule_props</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule_key</span><span class=p>:</span> <span class=nb>tuple</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create rule props.&quot;&quot;&quot;</span>
+        <span class=n>rule_set</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_set_id_mgr</span><span class=o>.</span><span class=n>get_next_rule_set_id</span><span class=p>()</span>
+        <span class=n>row_number</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_row_number</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+        <span class=n>rule_set_mgr</span> <span class=o>=</span> <span class=n>_RuleSetMgr</span><span class=p>(</span><span class=n>row_number</span><span class=p>,</span> <span class=n>rule_set</span><span class=p>)</span>
+        <span class=n>namespace</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_namespace</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_validation</span><span class=p>(</span><span class=n>rule_key</span><span class=p>):</span>
+            <span class=n>column_names</span> <span class=o>=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_check_property_column_names</span><span class=p>()</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>column_names</span> <span class=o>=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_rule_property_column_names</span><span class=p>()</span>
+        <span class=c1># req&#39;d &amp; optional props</span>
+        <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>column_names</span><span class=p>:</span>
+            <span class=n>prop_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_prop_name</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+            <span class=n>prop_value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>column_name</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>rule_set_mgr</span><span class=o>.</span><span class=n>add_prop</span><span class=p>(</span><span class=n>prop_name</span><span class=p>,</span> <span class=n>prop_value</span><span class=p>,</span> <span class=n>namespace</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_class</span><span class=p>(</span><span class=n>prop_name</span><span class=p>))</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_validation</span><span class=p>(</span><span class=n>rule_key</span><span class=p>):</span>
+            <span class=c1># parameter columns</span>
+            <span class=n>column_names</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_parameter_column_names</span><span class=p>()</span>
+            <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>column_names</span><span class=p>:</span>
+                <span class=n>prop_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_prop_name</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+                <span class=n>prop_value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>column_name</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>rule_set_mgr</span><span class=o>.</span><span class=n>add_prop</span><span class=p>(</span><span class=n>prop_name</span><span class=p>,</span> <span class=n>prop_value</span><span class=p>,</span> <span class=n>namespace</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_class</span><span class=p>(</span><span class=n>prop_name</span><span class=p>))</span>
+        <span class=c1># user props</span>
+        <span class=n>column_names</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_user_column_names</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>column_names</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>column_name</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;#&#39;</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=n>prop_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_prop_name</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+            <span class=n>prop_value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>column_name</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>rule_set_mgr</span><span class=o>.</span><span class=n>add_prop</span><span class=p>(</span><span class=n>prop_name</span><span class=p>,</span> <span class=n>prop_value</span><span class=p>,</span> <span class=n>namespace</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_class</span><span class=p>(</span><span class=n>prop_name</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>rule_set_mgr</span><span class=o>.</span><span class=n>get_props</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_get_control_implementation</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>component</span><span class=p>:</span> <span class=n>DefinedComponent</span><span class=p>,</span> <span class=n>source</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>description</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ControlImplementation</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find or create control implementation.&quot;&quot;&quot;</span>
+        <span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>control_implementation</span> <span class=ow>in</span> <span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>source</span> <span class=o>==</span> <span class=n>source</span> <span class=ow>and</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>description</span> <span class=o>==</span> <span class=n>description</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>control_implementation</span>
+        <span class=n>control_implementation</span> <span class=o>=</span> <span class=n>ControlImplementation</span><span class=p>(</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span> <span class=n>source</span><span class=o>=</span><span class=n>source</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=n>description</span><span class=p>,</span> <span class=n>implemented_requirements</span><span class=o>=</span><span class=p>[]</span>
+        <span class=p>)</span>
+        <span class=n>component</span><span class=o>.</span><span class=n>control_implementations</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_implementation</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>control_implementation</span>
+
+    <span class=k>def</span> <span class=nf>_str_to_list</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>value</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Transform string to list.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=s1>&#39;,&#39;</span> <span class=ow>in</span> <span class=n>value</span><span class=p>:</span>
+            <span class=n>values</span> <span class=o>=</span> <span class=n>value</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+            <span class=c1># remove leading/trailing whitespace</span>
+            <span class=k>for</span> <span class=n>v</span> <span class=ow>in</span> <span class=n>values</span><span class=p>:</span>
+                <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>v</span><span class=o>.</span><span class=n>strip</span><span class=p>())</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>value</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_create_set_parameters</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule_key</span><span class=p>:</span> <span class=nb>tuple</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create set parameters.&quot;&quot;&quot;</span>
+        <span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>parameter_id_column_name</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_parameter_id_column_names</span><span class=p>():</span>
+            <span class=n>suffix</span> <span class=o>=</span> <span class=n>parameter_id_column_name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>PARAMETER_ID</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+            <span class=n>parameter_value_default_column_name</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PARAMETER_VALUE_DEFAULT</span><span class=si>}{</span><span class=n>suffix</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>parameter_id_column_name</span><span class=p>)</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>parameter_value_default_column_name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>name</span> <span class=ow>and</span> <span class=n>value</span><span class=p>:</span>
+                <span class=k>try</span><span class=p>:</span>
+                    <span class=n>values</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_str_to_list</span><span class=p>(</span><span class=n>value</span><span class=p>)</span>
+                    <span class=n>set_parameter</span> <span class=o>=</span> <span class=n>SetParameter</span><span class=p>(</span>
+                        <span class=n>param_id</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+                        <span class=n>values</span><span class=o>=</span><span class=n>values</span><span class=p>,</span>
+                    <span class=p>)</span>
+                    <span class=n>set_parameters</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_parameter</span><span class=p>)</span>
+                <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+                    <span class=n>row_number</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_row_number</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+                    <span class=n>text</span> <span class=o>=</span> <span class=p>(</span>
+                        <span class=sa>f</span><span class=s1>&#39;row </span><span class=si>{</span><span class=n>row_number</span><span class=si>}</span><span class=s1>: &quot;</span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>&quot; is invalid for column </span><span class=si>{</span><span class=n>parameter_id_column_name</span><span class=si>}</span><span class=s1> &#39;</span>
+                        <span class=sa>f</span><span class=s1>&#39;and/or &quot;</span><span class=si>{</span><span class=s2>&quot;,&quot;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>values</span><span class=p>)</span><span class=si>}</span><span class=s1>&quot; is invalid for column </span><span class=si>{</span><span class=n>parameter_value_default_column_name</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=p>)</span>
+                    <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>name</span><span class=p>:</span>
+                <span class=n>row_number</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_row_number</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+                <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;row &quot;</span><span class=si>{</span><span class=n>row_number</span><span class=si>}</span><span class=s1>&quot; missing value for &quot;</span><span class=si>{</span><span class=n>parameter_value_default_column_name</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>set_parameters</span>
+
+    <span class=k>def</span> <span class=nf>_get_implemented_requirement</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>control_implementation</span><span class=p>:</span> <span class=n>ControlImplementation</span><span class=p>,</span> <span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ImplementedRequirement</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find or create implemented requirement.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_validate_controls</span> <span class=o>!=</span> <span class=s1>&#39;off&#39;</span><span class=p>:</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolved_profile_catalog_helper</span><span class=o>.</span><span class=n>validate</span><span class=p>(</span><span class=n>control_id</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>control_id</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_unresolved_controls</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_unresolved_controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>implemented_requirement</span> <span class=ow>in</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>implemented_requirement</span>
+        <span class=n>implemented_requirement</span> <span class=o>=</span> <span class=n>ImplementedRequirement</span><span class=p>(</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+            <span class=n>control_id</span><span class=o>=</span><span class=n>control_id</span><span class=p>,</span>
+            <span class=n>description</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span>
+        <span class=p>)</span>
+        <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>implemented_requirement</span>
+
+    <span class=k>def</span> <span class=nf>_get_statement</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>implemented_requirement</span><span class=p>:</span> <span class=n>ImplementedRequirement</span><span class=p>,</span> <span class=n>part_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Statement</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Find or create statement.&quot;&quot;&quot;</span>
+        <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>statement</span> <span class=ow>in</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>statement</span><span class=o>.</span><span class=n>statement_id</span> <span class=o>==</span> <span class=n>part_id</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>statement</span>
+        <span class=n>statement</span> <span class=o>=</span> <span class=n>Statement</span><span class=p>(</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+            <span class=n>statement_id</span><span class=o>=</span><span class=n>part_id</span><span class=p>,</span>
+            <span class=n>description</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span>
+            <span class=n>props</span><span class=o>=</span><span class=p>[],</span>
+        <span class=p>)</span>
+        <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>statement</span>
+
+    <span class=k>def</span> <span class=nf>rules_mod</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>mod_rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Modify rules.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>rule_key</span> <span class=ow>in</span> <span class=n>mod_rules</span><span class=p>:</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_TITLE</span><span class=p>)</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_TYPE</span><span class=p>)</span>
+            <span class=n>component_description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_DESCRIPTION</span><span class=p>)</span>
+            <span class=c1># component</span>
+            <span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_component</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>component_description</span><span class=p>)</span>
+            <span class=c1># props</span>
+            <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modify_rule_props</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>rule_key</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_modify_rule_props</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>component</span><span class=p>:</span> <span class=n>DefinedComponent</span><span class=p>,</span> <span class=n>rule_key</span><span class=p>:</span> <span class=nb>tuple</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Modify rule props.&quot;&quot;&quot;</span>
+        <span class=n>rule_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>RULE_ID</span><span class=p>)</span>
+        <span class=n>rule_set</span> <span class=o>=</span> <span class=n>_RuleSetHelper</span><span class=o>.</span><span class=n>get_rule_set</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+        <span class=n>rule_ns</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>NAMESPACE</span><span class=p>)</span>
+        <span class=n>column_names</span> <span class=o>=</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_filtered_required_column_names</span><span class=p>()</span> <span class=o>+</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_filtered_optional_column_names</span><span class=p>()</span>
+        <span class=c1># req&#39;d &amp; optional props</span>
+        <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>column_names</span><span class=p>:</span>
+            <span class=n>column_value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>column_name</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>class_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_class</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>update_rule_definition</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>rule_set</span><span class=p>,</span> <span class=n>column_name</span><span class=p>,</span> <span class=n>column_value</span><span class=p>,</span> <span class=n>rule_ns</span><span class=p>,</span> <span class=n>class_</span><span class=p>)</span>
+        <span class=c1># parameter columns</span>
+        <span class=n>column_names</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_parameter_column_names</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>column_names</span><span class=p>:</span>
+            <span class=n>column_value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>column_name</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>class_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_class</span><span class=p>(</span><span class=n>column_name</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>update_rule_definition</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>rule_set</span><span class=p>,</span> <span class=n>column_name</span><span class=p>,</span> <span class=n>column_value</span><span class=p>,</span> <span class=n>rule_ns</span><span class=p>,</span> <span class=n>class_</span><span class=p>)</span>
+        <span class=c1># user props</span>
+        <span class=n>column_names</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_user_column_names</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>column_name</span> <span class=ow>in</span> <span class=n>column_names</span><span class=p>:</span>
+            <span class=n>column_value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>column_name</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>update_rule_definition</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>rule_set</span><span class=p>,</span> <span class=n>column_name</span><span class=p>,</span> <span class=n>column_value</span><span class=p>,</span> <span class=n>rule_ns</span><span class=p>,</span> <span class=n>class_</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>component</span><span class=o>.</span><span class=n>props</span>
+
+    <span class=k>def</span> <span class=nf>set_params_del</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>del_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set parameters delete.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=n>del_set_params</span><span class=p>:</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+            <span class=n>param_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+            <span class=c1># ctl impl</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+                <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=n>control_implementation</span><span class=p>:</span>
+                <span class=n>set_parameters</span> <span class=o>=</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span>
+                <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>set_parameter</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_set_parameter_generator</span><span class=p>(</span><span class=n>set_parameters</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>set_parameter</span><span class=o>.</span><span class=n>param_id</span> <span class=o>==</span> <span class=n>param_id</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>add_set_parameter</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span> <span class=n>set_parameter</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>==</span> <span class=p>[]:</span>
+                    <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>set_params_add</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>add_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set parameters add.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=n>add_set_params</span><span class=p>:</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+            <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+            <span class=n>param_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+            <span class=c1># ctl impl</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+                <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+            <span class=p>)</span>
+            <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+            <span class=c1># add</span>
+            <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=n>values</span> <span class=o>=</span> <span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_default_value_by_id</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>param_id</span><span class=p>)]</span>
+            <span class=n>set_parameter</span> <span class=o>=</span> <span class=n>SetParameter</span><span class=p>(</span>
+                <span class=n>param_id</span><span class=o>=</span><span class=n>param_id</span><span class=p>,</span>
+                <span class=n>values</span><span class=o>=</span><span class=n>values</span><span class=p>,</span>
+            <span class=p>)</span>
+            <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>add_set_parameter</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span> <span class=n>set_parameter</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>set_params_mod</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>mod_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set parameters modify.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=n>mod_set_params</span><span class=p>:</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+            <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+            <span class=n>param_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+            <span class=c1># ctl impl</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+                <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=n>control_implementation</span><span class=p>:</span>
+                <span class=n>set_parameters</span> <span class=o>=</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span>
+                <span class=k>for</span> <span class=n>set_parameter</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_set_parameter_generator</span><span class=p>(</span><span class=n>set_parameters</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>set_parameter</span><span class=o>.</span><span class=n>param_id</span> <span class=o>!=</span> <span class=n>param_id</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                    <span class=n>values</span> <span class=o>=</span> <span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_default_value_by_id</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>param_id</span><span class=p>)]</span>
+                    <span class=n>replacement</span> <span class=o>=</span> <span class=n>SetParameter</span><span class=p>(</span>
+                        <span class=n>param_id</span><span class=o>=</span><span class=n>param_id</span><span class=p>,</span>
+                        <span class=n>values</span><span class=o>=</span><span class=n>values</span><span class=p>,</span>
+                    <span class=p>)</span>
+                    <span class=k>if</span> <span class=n>set_parameter</span><span class=o>.</span><span class=n>values</span> <span class=o>==</span> <span class=n>replacement</span><span class=o>.</span><span class=n>values</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;params-mod: </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>param_id</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>set_parameter</span><span class=o>.</span><span class=n>values</span><span class=si>}</span><span class=s1> -&gt; </span><span class=si>{</span><span class=n>replacement</span><span class=o>.</span><span class=n>values</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=n>set_parameter</span><span class=o>.</span><span class=n>values</span> <span class=o>=</span> <span class=n>replacement</span><span class=o>.</span><span class=n>values</span>
+
+    <span class=k>def</span> <span class=nf>_control_mappings_generator</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control_mappings</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Control mappings generator.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=n>control_mappings</span><span class=p>:</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+                <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=n>control_implementation</span><span class=p>:</span>
+                <span class=k>yield</span> <span class=n>tokens</span>
+
+    <span class=k>def</span> <span class=nf>control_mappings_del</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>del_control_mappings</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Control mappings delete.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_mappings_generator</span><span class=p>(</span><span class=n>del_control_mappings</span><span class=p>):</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+            <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+            <span class=n>smt_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+            <span class=c1># ctl-id</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=n>derive_control_id</span><span class=p>(</span><span class=n>smt_id</span><span class=p>)</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+                <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+            <span class=p>)</span>
+            <span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span>
+            <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>implemented_requirement</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirement_generator</span><span class=p>(</span><span class=n>implemented_requirements</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+                    <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>remove_rule_statement</span><span class=p>(</span>
+                        <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>smt_id</span>
+                    <span class=p>)</span>
+                    <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>remove_rule</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>))</span> <span class=ow>or</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>)):</span>
+                        <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>control_mappings_add</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>add_control_mappings</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Control mappings add.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_mappings_generator</span><span class=p>(</span><span class=n>add_control_mappings</span><span class=p>):</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+            <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+            <span class=n>smt_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+            <span class=c1># ctl-id</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=n>derive_control_id</span><span class=p>(</span><span class=n>smt_id</span><span class=p>)</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+                <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+            <span class=p>)</span>
+            <span class=n>implemented_requirement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_implemented_requirement</span><span class=p>(</span><span class=n>control_implementation</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+            <span class=c1># namespace</span>
+            <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>],</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>],</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+            <span class=n>ns</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_namespace</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+            <span class=c1># create rule implementation (as property)</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>RULE_ID</span>
+            <span class=n>prop</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+                <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+                <span class=n>value</span><span class=o>=</span><span class=n>rule_id</span><span class=p>,</span>
+                <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>,</span>
+                <span class=n>class_</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>get_class</span><span class=p>(</span><span class=n>name</span><span class=p>),</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=n>smt_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>statement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_statement</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>,</span> <span class=n>smt_id</span><span class=p>)</span>
+                <span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-attributes>Attributes<a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;csv-to-oscal-cd&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-functions>Functions<a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task csv-to-oscal-cd.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task csv-to-oscal-cd.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.configure class="doc doc-heading"> <code class="highlight language-python"><span class=n>configure</span><span class=p>()</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.configure class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Configure.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>configure</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Configure.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+    <span class=c1># config verbosity</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_quiet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_quiet</span>
+    <span class=c1># title</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;title&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_title</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;title&quot;&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=c1># version</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;version&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_version</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;version&quot;&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=c1># config csv</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_csv_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;csv-file&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_file</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;csv-file&quot;&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_csv_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_file</span><span class=p>)</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;&quot;csv-file&quot; not found&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=c1># announce csv</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=c1># config cd</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_cd_path</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_cd_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;component-definition&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_file</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cd_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_cd_file</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_path</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;&quot;component-definition&quot; not found&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+    <span class=c1># workspace</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_workspace</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>getcwd</span><span class=p>()</span>
+    <span class=c1># validate_controls</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_validate_controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;validate-controls&#39;</span><span class=p>,</span> <span class=s1>&#39;off&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_add class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_mappings_add</span><span class=p>(</span><span class=n>add_control_mappings</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_add class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Control mappings add.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>911</span>
+<span class=normal>912</span>
+<span class=normal>913</span>
+<span class=normal>914</span>
+<span class=normal>915</span>
+<span class=normal>916</span>
+<span class=normal>917</span>
+<span class=normal>918</span>
+<span class=normal>919</span>
+<span class=normal>920</span>
+<span class=normal>921</span>
+<span class=normal>922</span>
+<span class=normal>923</span>
+<span class=normal>924</span>
+<span class=normal>925</span>
+<span class=normal>926</span>
+<span class=normal>927</span>
+<span class=normal>928</span>
+<span class=normal>929</span>
+<span class=normal>930</span>
+<span class=normal>931</span>
+<span class=normal>932</span>
+<span class=normal>933</span>
+<span class=normal>934</span>
+<span class=normal>935</span>
+<span class=normal>936</span>
+<span class=normal>937</span>
+<span class=normal>938</span>
+<span class=normal>939</span>
+<span class=normal>940</span>
+<span class=normal>941</span>
+<span class=normal>942</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>control_mappings_add</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>add_control_mappings</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Control mappings add.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_mappings_generator</span><span class=p>(</span><span class=n>add_control_mappings</span><span class=p>):</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+        <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+        <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+        <span class=n>smt_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+        <span class=c1># ctl-id</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>derive_control_id</span><span class=p>(</span><span class=n>smt_id</span><span class=p>)</span>
+        <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+            <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+        <span class=p>)</span>
+        <span class=n>implemented_requirement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_implemented_requirement</span><span class=p>(</span><span class=n>control_implementation</span><span class=p>,</span> <span class=n>control_id</span><span class=p>)</span>
+        <span class=c1># namespace</span>
+        <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>],</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>],</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>],</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>ns</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_namespace</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+        <span class=c1># create rule implementation (as property)</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=n>RULE_ID</span>
+        <span class=n>prop</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>rule_id</span><span class=p>,</span>
+            <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>,</span>
+            <span class=n>class_</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>get_class</span><span class=p>(</span><span class=n>name</span><span class=p>),</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=n>smt_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+            <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+            <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>statement</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_statement</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>,</span> <span class=n>smt_id</span><span class=p>)</span>
+            <span class=n>statement</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_del class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_mappings_del</span><span class=p>(</span><span class=n>del_control_mappings</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_del class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Control mappings delete.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>884</span>
+<span class=normal>885</span>
+<span class=normal>886</span>
+<span class=normal>887</span>
+<span class=normal>888</span>
+<span class=normal>889</span>
+<span class=normal>890</span>
+<span class=normal>891</span>
+<span class=normal>892</span>
+<span class=normal>893</span>
+<span class=normal>894</span>
+<span class=normal>895</span>
+<span class=normal>896</span>
+<span class=normal>897</span>
+<span class=normal>898</span>
+<span class=normal>899</span>
+<span class=normal>900</span>
+<span class=normal>901</span>
+<span class=normal>902</span>
+<span class=normal>903</span>
+<span class=normal>904</span>
+<span class=normal>905</span>
+<span class=normal>906</span>
+<span class=normal>907</span>
+<span class=normal>908</span>
+<span class=normal>909</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>control_mappings_del</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>del_control_mappings</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Control mappings delete.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_mappings_generator</span><span class=p>(</span><span class=n>del_control_mappings</span><span class=p>):</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+        <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+        <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+        <span class=n>smt_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+        <span class=c1># ctl-id</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>derive_control_id</span><span class=p>(</span><span class=n>smt_id</span><span class=p>)</span>
+        <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+            <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+        <span class=p>)</span>
+        <span class=n>implemented_requirements</span> <span class=o>=</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span>
+        <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>implemented_requirement</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_implemented_requirement_generator</span><span class=p>(</span><span class=n>implemented_requirements</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>control_id</span> <span class=o>==</span> <span class=n>control_id</span><span class=p>:</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>remove_rule_statement</span><span class=p>(</span>
+                    <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>smt_id</span>
+                <span class=p>)</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>remove_rule</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>props</span><span class=p>))</span> <span class=ow>or</span> <span class=nb>len</span><span class=p>(</span><span class=n>as_list</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span><span class=p>)):</span>
+                    <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an executed outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an executed outcome.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.get_class class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_class</span><span class=p>(</span><span class=n>name</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.get_class class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get class value for specified name from config.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_class</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get class value for specified name from config.&quot;&quot;&quot;</span>
+    <span class=n>key</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;class.</span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>name</span>
+    <span class=n>oscal_name</span> <span class=o>=</span> <span class=s1>&#39;component_definition&#39;</span>
+    <span class=c1># help note identifiers</span>
+    <span class=n>note01</span> <span class=o>=</span> <span class=s1>&#39;1&#39;</span>
+    <span class=n>note02</span> <span class=o>=</span> <span class=s1>&#39;2&#39;</span>
+    <span class=n>note03</span> <span class=o>=</span> <span class=s1>&#39;3&#39;</span>
+    <span class=n>note04</span> <span class=o>=</span> <span class=s1>&#39;4&#39;</span>
+    <span class=n>note05</span> <span class=o>=</span> <span class=s1>&#39;5&#39;</span>
+    <span class=c1># help generation</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Purpose: From csv produce OSCAL </span><span class=si>{</span><span class=n>oscal_name</span><span class=si>}</span><span class=s1> file.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Configuration flags sit under [task.</span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>]:&#39;</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  title                = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the component definition title.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  version              = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the component definition version.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  csv-file             = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the csv file.&#39;</span>
+    <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39; [1st row are column headings; 2nd row are column descriptions; 3rd row and beyond is data]&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  required columns:      &#39;</span>
+    <span class=k>for</span> <span class=n>text2</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_required_column_names</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>text2</span> <span class=ow>in</span> <span class=p>[</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RULE_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PROFILE_SOURCE</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>PROFILE_DESCRIPTION</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>CONTROL_ID_LIST</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>]:</span>
+            <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see note </span><span class=si>{</span><span class=n>note01</span><span class=si>}</span><span class=s1>)&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=s1>&#39;$$&#39;</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;                         &#39;</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  optional columns:      &#39;</span>
+    <span class=k>for</span> <span class=n>text2</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_optional_column_names</span><span class=p>():</span>
+        <span class=k>if</span> <span class=n>text2</span> <span class=ow>in</span> <span class=p>[</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ORIGINAL_RISK_RATING</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ADJUSTED_RISK_RATING</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>RISK_ADJUSTMENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>]:</span>
+            <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see note </span><span class=si>{</span><span class=n>note01</span><span class=si>}</span><span class=s1>)&#39;</span>
+        <span class=k>elif</span> <span class=n>text2</span> <span class=ow>in</span> <span class=p>[</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>TARGET_COMPONENT</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>]:</span>
+            <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see note </span><span class=si>{</span><span class=n>note03</span><span class=si>}</span><span class=s1>)&#39;</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see note </span><span class=si>{</span><span class=n>note02</span><span class=si>}</span><span class=s1>)&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=s1>&#39;$&#39;</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;                         &#39;</span>
+    <span class=k>for</span> <span class=n>text2</span> <span class=ow>in</span> <span class=n>CsvColumn</span><span class=o>.</span><span class=n>get_parameter_column_names</span><span class=p>():</span>
+        <span class=n>text2</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39; (see notes </span><span class=si>{</span><span class=n>note01</span><span class=si>}</span><span class=s1>, </span><span class=si>{</span><span class=n>note05</span><span class=si>}</span><span class=s1>)&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=s1>&#39;$&#39;</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;                         &#39;</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  comment columns:       &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Informational (see note </span><span class=si>{</span><span class=n>note04</span><span class=si>}</span><span class=s1>)&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=s1>&#39;#&#39;</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir           = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the output directory for synthesized OSCAL .json files.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  component-definition = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) the path of the existing component-definition OSCAL .json file.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  class.column-name    = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;(optional) the class to associate with the specified column name, e.g. class.</span><span class=si>{</span><span class=n>RULE_ID</span><span class=si>}</span><span class=s1> = scc_class&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite     = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  validate-controls    = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) on, warn, or off [default]; validate controls exist in resolved profile.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=c1># Notes</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;Notes: &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note01</span><span class=si>}</span><span class=s1>] column is ignored for validation component type&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;       &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note02</span><span class=si>}</span><span class=s1>] column is required for validation component type&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;       &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note03</span><span class=si>}</span><span class=s1>] column is optional for validation component type&#39;</span>
+    <span class=n>text3</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;, but may be needed to prevent </span><span class=si>{</span><span class=n>RULE_ID</span><span class=si>}</span><span class=s1> collisions&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;       &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note04</span><span class=si>}</span><span class=s1>] column name starting with # causes column to be ignored&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;       &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>note05</span><span class=si>}</span><span class=s1>] additional parameters are specified by adding a common suffix per set&#39;</span>
+    <span class=n>text3</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;, for example: </span><span class=si>{</span><span class=n>PARAMETER_ID</span><span class=si>}</span><span class=s1>_1, </span><span class=si>{</span><span class=n>PARAMETER_DESCRIPTION</span><span class=si>}</span><span class=s1>_1, ...</span><span class=si>{</span><span class=n>PARAMETER_ID</span><span class=si>}</span><span class=s1>_2...&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_add class="doc doc-heading"> <code class="highlight language-python"><span class=n>rules_add</span><span class=p>(</span><span class=n>add_rules</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_add class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add rules.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rules_add</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>add_rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add rules.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>rule_key</span> <span class=ow>in</span> <span class=n>add_rules</span><span class=p>:</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_TITLE</span><span class=p>)</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_TYPE</span><span class=p>)</span>
+        <span class=n>component_description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_DESCRIPTION</span><span class=p>)</span>
+        <span class=c1># component</span>
+        <span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_component</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>component_description</span><span class=p>)</span>
+        <span class=c1># props</span>
+        <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>component</span><span class=o>.</span><span class=n>props</span><span class=p>)</span>
+        <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>+</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_rule_props</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+        <span class=c1># additional props, when not validation component</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_validation</span><span class=p>(</span><span class=n>rule_key</span><span class=p>):</span>
+            <span class=c1># control implementation</span>
+            <span class=n>source</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>PROFILE_SOURCE</span><span class=p>)</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>PROFILE_DESCRIPTION</span><span class=p>)</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_control_implementation</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span><span class=p>)</span>
+            <span class=c1># set-parameters</span>
+            <span class=n>set_parameters</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create_set_parameters</span><span class=p>(</span><span class=n>rule_key</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>set_parameters</span><span class=p>:</span>
+                <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+                <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>add_set_parameters</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span> <span class=n>set_parameters</span><span class=p>)</span>
+            <span class=c1># control-mappings</span>
+            <span class=n>control_mappings</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>CONTROL_ID_LIST</span><span class=p>)</span><span class=o>.</span><span class=n>split</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_rule_prop</span><span class=p>(</span><span class=n>control_implementation</span><span class=p>,</span> <span class=n>control_mappings</span><span class=p>,</span> <span class=n>rule_key</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_del class="doc doc-heading"> <code class="highlight language-python"><span class=n>rules_del</span><span class=p>(</span><span class=n>del_rules</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_del class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Delete rules.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rules_del</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>del_rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Delete rules.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=n>del_rules</span><span class=p>:</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+        <span class=n>description</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=c1># component</span>
+        <span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_component</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>description</span><span class=p>)</span>
+        <span class=c1># props</span>
+        <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_delete_rule_props</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_mod class="doc doc-heading"> <code class="highlight language-python"><span class=n>rules_mod</span><span class=p>(</span><span class=n>mod_rules</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_mod class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Modify rules.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>762</span>
+<span class=normal>763</span>
+<span class=normal>764</span>
+<span class=normal>765</span>
+<span class=normal>766</span>
+<span class=normal>767</span>
+<span class=normal>768</span>
+<span class=normal>769</span>
+<span class=normal>770</span>
+<span class=normal>771</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>rules_mod</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>mod_rules</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Modify rules.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>rule_key</span> <span class=ow>in</span> <span class=n>mod_rules</span><span class=p>:</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_TITLE</span><span class=p>)</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_TYPE</span><span class=p>)</span>
+        <span class=n>component_description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_value</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>COMPONENT_DESCRIPTION</span><span class=p>)</span>
+        <span class=c1># component</span>
+        <span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>get_component</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>component_description</span><span class=p>)</span>
+        <span class=c1># props</span>
+        <span class=n>component</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modify_rule_props</span><span class=p>(</span><span class=n>component</span><span class=p>,</span> <span class=n>rule_key</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_add class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_params_add</span><span class=p>(</span><span class=n>add_set_params</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_add class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set parameters add.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>819</span>
+<span class=normal>820</span>
+<span class=normal>821</span>
+<span class=normal>822</span>
+<span class=normal>823</span>
+<span class=normal>824</span>
+<span class=normal>825</span>
+<span class=normal>826</span>
+<span class=normal>827</span>
+<span class=normal>828</span>
+<span class=normal>829</span>
+<span class=normal>830</span>
+<span class=normal>831</span>
+<span class=normal>832</span>
+<span class=normal>833</span>
+<span class=normal>834</span>
+<span class=normal>835</span>
+<span class=normal>836</span>
+<span class=normal>837</span>
+<span class=normal>838</span>
+<span class=normal>839</span>
+<span class=normal>840</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_params_add</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>add_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set parameters add.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=n>add_set_params</span><span class=p>:</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+        <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+        <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+        <span class=n>param_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+        <span class=c1># ctl impl</span>
+        <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+            <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+        <span class=p>)</span>
+        <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>)</span>
+        <span class=c1># add</span>
+        <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=n>values</span> <span class=o>=</span> <span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_default_value_by_id</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>param_id</span><span class=p>)]</span>
+        <span class=n>set_parameter</span> <span class=o>=</span> <span class=n>SetParameter</span><span class=p>(</span>
+            <span class=n>param_id</span><span class=o>=</span><span class=n>param_id</span><span class=p>,</span>
+            <span class=n>values</span><span class=o>=</span><span class=n>values</span><span class=p>,</span>
+        <span class=p>)</span>
+        <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>add_set_parameter</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span> <span class=n>set_parameter</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_del class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_params_del</span><span class=p>(</span><span class=n>del_set_params</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_del class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set parameters delete.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>797</span>
+<span class=normal>798</span>
+<span class=normal>799</span>
+<span class=normal>800</span>
+<span class=normal>801</span>
+<span class=normal>802</span>
+<span class=normal>803</span>
+<span class=normal>804</span>
+<span class=normal>805</span>
+<span class=normal>806</span>
+<span class=normal>807</span>
+<span class=normal>808</span>
+<span class=normal>809</span>
+<span class=normal>810</span>
+<span class=normal>811</span>
+<span class=normal>812</span>
+<span class=normal>813</span>
+<span class=normal>814</span>
+<span class=normal>815</span>
+<span class=normal>816</span>
+<span class=normal>817</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_params_del</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>del_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set parameters delete.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=n>del_set_params</span><span class=p>:</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+        <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+        <span class=n>param_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+        <span class=c1># ctl impl</span>
+        <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+            <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=n>control_implementation</span><span class=p>:</span>
+            <span class=n>set_parameters</span> <span class=o>=</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span>
+            <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>set_parameter</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_set_parameter_generator</span><span class=p>(</span><span class=n>set_parameters</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>set_parameter</span><span class=o>.</span><span class=n>param_id</span> <span class=o>==</span> <span class=n>param_id</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>_OscalHelper</span><span class=o>.</span><span class=n>add_set_parameter</span><span class=p>(</span><span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>,</span> <span class=n>set_parameter</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>==</span> <span class=p>[]:</span>
+                <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_mod class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_params_mod</span><span class=p>(</span><span class=n>mod_set_params</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_mod class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set parameters modify.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>842</span>
+<span class=normal>843</span>
+<span class=normal>844</span>
+<span class=normal>845</span>
+<span class=normal>846</span>
+<span class=normal>847</span>
+<span class=normal>848</span>
+<span class=normal>849</span>
+<span class=normal>850</span>
+<span class=normal>851</span>
+<span class=normal>852</span>
+<span class=normal>853</span>
+<span class=normal>854</span>
+<span class=normal>855</span>
+<span class=normal>856</span>
+<span class=normal>857</span>
+<span class=normal>858</span>
+<span class=normal>859</span>
+<span class=normal>860</span>
+<span class=normal>861</span>
+<span class=normal>862</span>
+<span class=normal>863</span>
+<span class=normal>864</span>
+<span class=normal>865</span>
+<span class=normal>866</span>
+<span class=normal>867</span>
+<span class=normal>868</span>
+<span class=normal>869</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_params_mod</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>mod_set_params</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set parameters modify.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>tokens</span> <span class=ow>in</span> <span class=n>mod_set_params</span><span class=p>:</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+        <span class=n>rule_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+        <span class=n>source</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span>
+        <span class=n>description</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>4</span><span class=p>]</span>
+        <span class=n>param_id</span> <span class=o>=</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>5</span><span class=p>]</span>
+        <span class=c1># ctl impl</span>
+        <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cd_mgr</span><span class=o>.</span><span class=n>find_control_implementation</span><span class=p>(</span>
+            <span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>source</span><span class=p>,</span> <span class=n>description</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=n>control_implementation</span><span class=p>:</span>
+            <span class=n>set_parameters</span> <span class=o>=</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span>
+            <span class=k>for</span> <span class=n>set_parameter</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_set_parameter_generator</span><span class=p>(</span><span class=n>set_parameters</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>set_parameter</span><span class=o>.</span><span class=n>param_id</span> <span class=o>!=</span> <span class=n>param_id</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>rule_key</span> <span class=o>=</span> <span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+                <span class=n>values</span> <span class=o>=</span> <span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>_csv_mgr</span><span class=o>.</span><span class=n>get_default_value_by_id</span><span class=p>(</span><span class=n>rule_key</span><span class=p>,</span> <span class=n>param_id</span><span class=p>)]</span>
+                <span class=n>replacement</span> <span class=o>=</span> <span class=n>SetParameter</span><span class=p>(</span>
+                    <span class=n>param_id</span><span class=o>=</span><span class=n>param_id</span><span class=p>,</span>
+                    <span class=n>values</span><span class=o>=</span><span class=n>values</span><span class=p>,</span>
+                <span class=p>)</span>
+                <span class=k>if</span> <span class=n>set_parameter</span><span class=o>.</span><span class=n>values</span> <span class=o>==</span> <span class=n>replacement</span><span class=o>.</span><span class=n>values</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;params-mod: </span><span class=si>{</span><span class=n>rule_id</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>param_id</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>set_parameter</span><span class=o>.</span><span class=n>values</span><span class=si>}</span><span class=s1> -&gt; </span><span class=si>{</span><span class=n>replacement</span><span class=o>.</span><span class=n>values</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>set_parameter</span><span class=o>.</span><span class=n>values</span> <span class=o>=</span> <span class=n>replacement</span><span class=o>.</span><span class=n>values</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.tasks.csv_to_oscal_cd-functions>Functions<a href=#trestle.tasks.csv_to_oscal_cd-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.csv_to_oscal_cd.derive_control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>derive_control_id</span><span class=p>(</span><span class=n>control_mapping</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.derive_control_id class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Derive control id.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>derive_control_id</span><span class=p>(</span><span class=n>control_mapping</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Derive control id.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=n>control_mapping</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;_smt&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.csv_to_oscal_cd.derive_part_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>derive_part_id</span><span class=p>(</span><span class=n>control_mapping</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.derive_part_id class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Derive part id.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>derive_part_id</span><span class=p>(</span><span class=n>control_mapping</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Derive part id.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=s1>&#39;_smt.&#39;</span> <span class=ow>in</span> <span class=n>control_mapping</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>control_mapping</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.csv_to_oscal_cd.etype class="doc doc-heading"> <code class="highlight language-python"><span class=n>etype</span><span class=p>(</span><span class=n>target</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.etype class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get etype.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>etype</span><span class=p>(</span><span class=n>target</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get etype.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>target</span><span class=p>:</span>
+        <span class=k>return</span> <span class=s1>&#39;invalid&#39;</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=k>return</span> <span class=s1>&#39;missing&#39;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.csv_to_oscal_cd.is_validation class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_validation</span><span class=p>(</span><span class=n>component_type</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.is_validation class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Check for validation component.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_validation</span><span class=p>(</span><span class=n>component_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check for validation component.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>component_type</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span> <span class=o>==</span> <span class=n>validation</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.csv_to_oscal_cd.row_property_builder class="doc doc-heading"> <code class="highlight language-python"><span class=n>row_property_builder</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>ns</span><span class=p>,</span> <span class=n>class_</span><span class=p>,</span> <span class=n>remarks</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.row_property_builder class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Row property builder.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>row_property_builder</span><span class=p>(</span><span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>ns</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>class_</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>remarks</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Property</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Row property builder.&quot;&quot;&quot;</span>
+    <span class=c1># name</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>Property</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=s1>&#39;value&#39;</span><span class=p>,</span>
+        <span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;property for row: </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> name: </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> is </span><span class=si>{</span><span class=n>etype</span><span class=p>(</span><span class=n>name</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+    <span class=c1># value</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>Property</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span>
+        <span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;property for row: </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> value: </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1> is </span><span class=si>{</span><span class=n>etype</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+    <span class=c1># ns</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>Property</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span>
+            <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>,</span>
+        <span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;property for row: </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> ns: </span><span class=si>{</span><span class=n>ns</span><span class=si>}</span><span class=s1> is </span><span class=si>{</span><span class=n>etype</span><span class=p>(</span><span class=n>ns</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+    <span class=c1># class</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=n>Property</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span>
+            <span class=n>class_</span><span class=o>=</span><span class=n>class_</span><span class=p>,</span>
+        <span class=p>)</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;property for row: </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> class: </span><span class=si>{</span><span class=n>class_</span><span class=si>}</span><span class=s1> is </span><span class=si>{</span><span class=n>etype</span><span class=p>(</span><span class=n>class_</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+    <span class=c1># prop</span>
+    <span class=n>prop</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+        <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span>
+        <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span>
+        <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>,</span>
+        <span class=n>class_</span><span class=o>=</span><span class=n>class_</span><span class=p>,</span>
+        <span class=n>remarks</span><span class=o>=</span><span class=n>remarks</span><span class=p>,</span>
+    <span class=p>)</span>
+    <span class=k>return</span> <span class=n>prop</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.csv_to_oscal_cd.synthesize_rule_key class="doc doc-heading"> <code class="highlight language-python"><span class=n>synthesize_rule_key</span><span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>check_id</span><span class=p>,</span> <span class=n>target_component</span><span class=p>)</span></code> <a href=#trestle.tasks.csv_to_oscal_cd.synthesize_rule_key class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Synthesize rule_key.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>synthesize_rule_key</span><span class=p>(</span>
+    <span class=n>component_title</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>component_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>rule_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>check_id</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=kc>None</span><span class=p>],</span>
+    <span class=n>target_component</span><span class=p>:</span> <span class=n>Union</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=kc>None</span><span class=p>]</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>tuple</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Synthesize rule_key.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>is_validation</span><span class=p>(</span><span class=n>component_type</span><span class=p>):</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=n>check_id</span><span class=p>,</span> <span class=n>target_component</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>(</span><span class=n>component_title</span><span class=p>,</span> <span class=n>component_type</span><span class=p>,</span> <span class=n>rule_id</span><span class=p>,</span> <span class=kc>None</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/index.html b/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/index.html
new file mode 100644
index 000000000..4e3fdaca8
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/index.html
@@ -0,0 +1,525 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.ocp4_cis_profile_to_oscal_catalog module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ rel=canonical><link href=../csv_to_oscal_cd/ rel=prev><link href=../ocp4_cis_profile_to_oscal_cd/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.ocp4_cis_profile_to_oscal_catalog - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.ocp4_cis_profile_to_oscal_catalog - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.ocp4_cis_profile_to_oscal_catalog module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.ocp4_cis_profile_to_oscal_catalog - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.ocp4_cis_profile_to_oscal_catalog module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog class=md-nav__link> <span class=md-ellipsis> ocp4_cis_profile_to_oscal_catalog </span> </a> <nav class=md-nav aria-label=ocp4_cis_profile_to_oscal_catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node class=md-nav__link> <span class=md-ellipsis> Node </span> </a> <nav class=md-nav aria-label=Node> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog class=md-nav__link> <span class=md-ellipsis> Ocp4CisProfileToOscalCatalog </span> </a> <nav class=md-nav aria-label=Ocp4CisProfileToOscalCatalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog class=md-nav__link> <span class=md-ellipsis> ocp4_cis_profile_to_oscal_catalog </span> </a> <nav class=md-nav aria-label=ocp4_cis_profile_to_oscal_catalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node class=md-nav__link> <span class=md-ellipsis> Node </span> </a> <nav class=md-nav aria-label=Node> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.description class=md-nav__link> <span class=md-ellipsis> description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog class=md-nav__link> <span class=md-ellipsis> Ocp4CisProfileToOscalCatalog </span> </a> <nav class=md-nav aria-label=Ocp4CisProfileToOscalCatalog> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.ocp4_cis_profile_to_oscal_catalog</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog class="doc doc-heading"> <code>trestle.tasks.ocp4_cis_profile_to_oscal_catalog</code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog-attributes>Attributes<a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog-classes>Classes<a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node class="doc doc-heading"> <code>Node</code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=pydantic.v1.BaseModel>BaseModel</span></code></p> <p>Representation of CIS profile entry.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Node</span><span class=p>(</span><span class=n>BaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Representation of CIS profile entry.&quot;&quot;&quot;</span>
+
+    <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+    <span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node-attributes>Attributes<a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.description class="doc doc-heading"> <code class="highlight language-python"><span class=n>description</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>Field</span><span class=p>(</span><span class=kc>None</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog class="doc doc-heading"> <code>Ocp4CisProfileToOscalCatalog</code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to transform OCP4 CIS profile to OSCAL catalog.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.name href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Ocp4CisProfileToOscalCatalog</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to transform OCP4 CIS profile to OSCAL catalog.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ocp4-cis-profile-to-oscal-catalog&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task ocp4-cis-profile-to-oscal-catalog.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Purpose: Create catalog from standard (e.g. CIS benchmark).&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.ocp4-cis-profile-to-oscal-catalog]:&#39;</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  input-dir              = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) location to read the compliance-as-code profile files.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir             = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) location to write the generated catalog.json file.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite       = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Wrap the execute for exception handling.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>idir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;input-dir&#39;</span><span class=p>]</span>
+            <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;output-dir&#39;</span><span class=p>]</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=o>.</span><span class=n>args</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1> missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># verbosity</span>
+        <span class=n>quiet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=n>quiet</span>
+        <span class=c1># output</span>
+        <span class=n>overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># calculate output file name &amp; check writability</span>
+        <span class=n>oname</span> <span class=o>=</span> <span class=s1>&#39;catalog.json&#39;</span>
+        <span class=n>ofile</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># metadata links (optional)</span>
+        <span class=n>metadata_links</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;metadata-links&#39;</span><span class=p>)</span>
+        <span class=c1># get list or &lt;name&gt;.profile files</span>
+        <span class=n>filelist</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_filelist</span><span class=p>(</span><span class=n>idir</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>filelist</span><span class=p>)</span> <span class=o>&lt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input: </span><span class=si>{</span><span class=n>idir</span><span class=si>}</span><span class=s1> no .profile file found&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># initialize node list</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_node_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># process files</span>
+        <span class=k>for</span> <span class=n>fp</span> <span class=ow>in</span> <span class=n>filelist</span><span class=p>:</span>
+            <span class=n>lines</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_content</span><span class=p>(</span><span class=n>fp</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_parse</span><span class=p>(</span><span class=n>lines</span><span class=p>)</span>
+        <span class=c1># get root nodes</span>
+        <span class=n>root_nodes</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_root_nodes</span><span class=p>()</span>
+        <span class=c1># groups and controls</span>
+        <span class=n>root</span> <span class=o>=</span> <span class=n>Group</span><span class=p>(</span><span class=n>title</span><span class=o>=</span><span class=s1>&#39;root&#39;</span><span class=p>,</span> <span class=n>groups</span><span class=o>=</span><span class=p>[])</span>
+        <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=n>root_nodes</span><span class=p>:</span>
+            <span class=n>group</span> <span class=o>=</span> <span class=n>Group</span><span class=p>(</span><span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>node</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>node</span><span class=o>.</span><span class=n>description</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>root</span><span class=o>.</span><span class=n>groups</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>group</span><span class=p>)</span>
+            <span class=n>depth</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_depth</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>name</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>depth</span> <span class=o>==</span> <span class=mi>3</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_groups</span><span class=p>(</span><span class=n>group</span><span class=p>,</span> <span class=n>node</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>depth</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>depth</span> <span class=o>==</span> <span class=mi>2</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_controls</span><span class=p>(</span><span class=n>group</span><span class=p>,</span> <span class=n>node</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=n>depth</span><span class=p>)</span>
+        <span class=c1># metadata</span>
+        <span class=n>metadata</span> <span class=o>=</span> <span class=n>Metadata</span><span class=p>(</span>
+            <span class=n>title</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_title</span><span class=p>,</span> <span class=n>last_modified</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span><span class=p>,</span> <span class=n>oscal_version</span><span class=o>=</span><span class=n>OSCAL_VERSION</span><span class=p>,</span> <span class=n>version</span><span class=o>=</span><span class=n>trestle</span><span class=o>.</span><span class=n>__version__</span>
+        <span class=p>)</span>
+        <span class=c1># metadata links</span>
+        <span class=k>if</span> <span class=n>metadata_links</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>metadata</span><span class=o>.</span><span class=n>links</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>metadata_links</span><span class=o>.</span><span class=n>split</span><span class=p>():</span>
+                <span class=n>link</span> <span class=o>=</span> <span class=n>Link</span><span class=p>(</span><span class=n>href</span><span class=o>=</span><span class=n>item</span><span class=p>)</span>
+                <span class=n>metadata</span><span class=o>.</span><span class=n>links</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>link</span><span class=p>)</span>
+        <span class=c1># catalog</span>
+        <span class=n>catalog</span> <span class=o>=</span> <span class=n>Catalog</span><span class=p>(</span><span class=n>uuid</span><span class=o>=</span><span class=n>_uuid</span><span class=p>(),</span> <span class=n>metadata</span><span class=o>=</span><span class=n>metadata</span><span class=p>,</span> <span class=n>groups</span><span class=o>=</span><span class=n>root</span><span class=o>.</span><span class=n>groups</span><span class=p>)</span>
+        <span class=c1># write OSCAL ComponentDefinition to file</span>
+        <span class=k>if</span> <span class=n>verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>catalog</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_filelist</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>idir</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get filelist.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=p>[</span><span class=n>x</span> <span class=k>for</span> <span class=n>x</span> <span class=ow>in</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>idir</span><span class=p>)</span><span class=o>.</span><span class=n>iterdir</span><span class=p>()</span> <span class=k>if</span> <span class=n>x</span><span class=o>.</span><span class=n>is_file</span><span class=p>()</span> <span class=ow>and</span> <span class=n>x</span><span class=o>.</span><span class=n>suffix</span> <span class=o>==</span> <span class=s1>&#39;.profile&#39;</span><span class=p>]</span>
+
+    <span class=k>def</span> <span class=nf>_get_content</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>fp</span><span class=p>:</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Fetch content from file.&quot;&quot;&quot;</span>
+        <span class=n>content</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>f</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+            <span class=n>content</span> <span class=o>=</span> <span class=n>f</span><span class=o>.</span><span class=n>readlines</span><span class=p>()</span>
+            <span class=n>f</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+            <span class=k>return</span> <span class=n>content</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;unable to process </span><span class=si>{</span><span class=n>fp</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>raise</span> <span class=n>e</span>
+
+    <span class=k>def</span> <span class=nf>_parse</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>lines</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Parse lines to build data structure.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>lines</span><span class=p>:</span>
+            <span class=n>line</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;title: &#39;</span><span class=p>)</span> <span class=ow>and</span> <span class=s2>&quot;&#39;&quot;</span> <span class=ow>in</span> <span class=n>line</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_title</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s2>&quot;&#39;&quot;</span><span class=p>)[</span><span class=mi>1</span><span class=p>]</span>
+                <span class=k>continue</span>
+            <span class=n>line_parts</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=kc>None</span><span class=p>,</span> <span class=mi>2</span><span class=p>)</span>
+            <span class=c1># must be 3 parts exactly</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>line_parts</span><span class=p>)</span> <span class=o>&lt;</span> <span class=mi>3</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=c1># normalized name and description</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>line_parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>rstrip</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=n>line_parts</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+            <span class=c1># name must be numbers and decimal points</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=nb>set</span><span class=p>(</span><span class=n>name</span><span class=p>)</span> <span class=o>&lt;=</span> <span class=nb>set</span><span class=p>(</span><span class=s1>&#39;0123456789.&#39;</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=c1># derive desired sortable key from name</span>
+            <span class=n>key</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_key</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_node_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>Node</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>description</span><span class=o>=</span><span class=n>description</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_key</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>int</span><span class=p>,</span> <span class=nb>int</span><span class=p>,</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert name to desired sortable key.&quot;&quot;&quot;</span>
+        <span class=n>parts</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>key</span> <span class=o>=</span> <span class=p>(</span><span class=nb>int</span><span class=p>(</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]),</span> <span class=mi>0</span><span class=p>,</span> <span class=mi>0</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=nb>len</span><span class=p>(</span><span class=n>parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>2</span><span class=p>:</span>
+            <span class=n>key</span> <span class=o>=</span> <span class=p>(</span><span class=nb>int</span><span class=p>(</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]),</span> <span class=nb>int</span><span class=p>(</span><span class=n>parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]),</span> <span class=mi>0</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=nb>len</span><span class=p>(</span><span class=n>parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>3</span><span class=p>:</span>
+            <span class=n>key</span> <span class=o>=</span> <span class=p>(</span><span class=nb>int</span><span class=p>(</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]),</span> <span class=nb>int</span><span class=p>(</span><span class=n>parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]),</span> <span class=nb>int</span><span class=p>(</span><span class=n>parts</span><span class=p>[</span><span class=mi>2</span><span class=p>]))</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;Unexpected value: </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>key</span>
+
+    <span class=k>def</span> <span class=nf>_get_root_nodes</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ValuesView</span><span class=p>[</span><span class=n>Node</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get root nodes.&quot;&quot;&quot;</span>
+        <span class=n>root_nodes</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_node_map</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>node</span><span class=o>.</span><span class=n>name</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=n>root_nodes</span><span class=p>[</span><span class=n>node</span><span class=o>.</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=n>node</span>
+        <span class=k>return</span> <span class=n>root_nodes</span><span class=o>.</span><span class=n>values</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_depth</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>prefix</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get maximum depth for prefix.&quot;&quot;&quot;</span>
+        <span class=n>depth</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>for</span> <span class=n>node</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_node_map</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>node</span><span class=o>.</span><span class=n>name</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>name</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>prefix</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=n>dots</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>dots</span><span class=p>)</span> <span class=o>&lt;=</span> <span class=n>depth</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>depth</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=n>dots</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>depth</span>
+
+    <span class=k>def</span> <span class=nf>_add_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>Group</span><span class=p>,</span> <span class=n>prefix</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>depth</span><span class=p>:</span> <span class=nb>int</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add controls to group.&quot;&quot;&quot;</span>
+        <span class=n>controls</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_node_map</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+            <span class=n>node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_node_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>node</span><span class=o>.</span><span class=n>name</span>
+            <span class=k>if</span> <span class=n>name</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>prefix</span><span class=p>):</span>
+                <span class=n>dots</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>dots</span><span class=p>)</span> <span class=o>==</span> <span class=n>depth</span><span class=p>:</span>
+                    <span class=n>id_</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>node</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>node</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>node</span><span class=o>.</span><span class=n>description</span><span class=si>}</span><span class=s1>&#39;</span>
+                    <span class=n>control</span> <span class=o>=</span> <span class=n>Control</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=n>id_</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+                    <span class=n>controls</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>controls</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>group</span><span class=o>.</span><span class=n>controls</span> <span class=o>=</span> <span class=n>controls</span>
+
+    <span class=k>def</span> <span class=nf>_add_groups</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>Group</span><span class=p>,</span> <span class=n>prefix</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>depth</span><span class=p>:</span> <span class=nb>int</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add sub-groups to group.&quot;&quot;&quot;</span>
+        <span class=n>groups</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_node_map</span><span class=o>.</span><span class=n>keys</span><span class=p>()):</span>
+            <span class=n>node</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_node_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>node</span><span class=o>.</span><span class=n>name</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>name</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>prefix</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>name</span> <span class=o>==</span> <span class=n>prefix</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>dots</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>dots</span><span class=p>)</span> <span class=o>!=</span> <span class=n>depth</span> <span class=o>-</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>title</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>node</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>node</span><span class=o>.</span><span class=n>description</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=n>sub_group</span> <span class=o>=</span> <span class=n>Group</span><span class=p>(</span><span class=n>title</span><span class=o>=</span><span class=n>title</span><span class=p>)</span>
+            <span class=n>groups</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>sub_group</span><span class=p>)</span>
+            <span class=n>sub_prefix</span> <span class=o>=</span> <span class=n>node</span><span class=o>.</span><span class=n>name</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_controls</span><span class=p>(</span><span class=n>sub_group</span><span class=p>,</span> <span class=n>sub_prefix</span><span class=p>,</span> <span class=n>depth</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>groups</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>group</span><span class=o>.</span><span class=n>groups</span> <span class=o>=</span> <span class=n>groups</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-attributes>Attributes<a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ocp4-cis-profile-to-oscal-catalog&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-functions>Functions<a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task ocp4-cis-profile-to-oscal-catalog.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task ocp4-cis-profile-to-oscal-catalog.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an actual outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Purpose: Create catalog from standard (e.g. CIS benchmark).&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.ocp4-cis-profile-to-oscal-catalog]:&#39;</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  input-dir              = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) location to read the compliance-as-code profile files.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir             = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) location to write the generated catalog.json file.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite       = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/index.html b/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/index.html
new file mode 100644
index 000000000..c52601f59
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/index.html
@@ -0,0 +1,1303 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.ocp4_cis_profile_to_oscal_cd module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ rel=canonical><link href=../ocp4_cis_profile_to_oscal_catalog/ rel=prev><link href=../oscal_catalog_to_csv/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.ocp4_cis_profile_to_oscal_cd - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.ocp4_cis_profile_to_oscal_cd - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.ocp4_cis_profile_to_oscal_cd module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.ocp4_cis_profile_to_oscal_cd - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.ocp4_cis_profile_to_oscal_cd module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd class=md-nav__link> <span class=md-ellipsis> ocp4_cis_profile_to_oscal_cd </span> </a> <nav class=md-nav aria-label=ocp4_cis_profile_to_oscal_cd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD class=md-nav__link> <span class=md-ellipsis> Ocp4CisProfileToOscalCD </span> </a> <nav class=md-nav aria-label=Ocp4CisProfileToOscalCD> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.set_timestamp class=md-nav__link> <span class=md-ellipsis> set_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd class=md-nav__link> <span class=md-ellipsis> ocp4_cis_profile_to_oscal_cd </span> </a> <nav class=md-nav aria-label=ocp4_cis_profile_to_oscal_cd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD class=md-nav__link> <span class=md-ellipsis> Ocp4CisProfileToOscalCD </span> </a> <nav class=md-nav aria-label=Ocp4CisProfileToOscalCD> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.set_timestamp class=md-nav__link> <span class=md-ellipsis> set_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.ocp4_cis_profile_to_oscal_cd</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd class="doc doc-heading"> <code>trestle.tasks.ocp4_cis_profile_to_oscal_cd</code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd-attributes>Attributes<a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd-classes>Classes<a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD class="doc doc-heading"> <code>Ocp4CisProfileToOscalCD</code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to transform OCP4 CIS profile to OSCAL component-definition.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.name href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Ocp4CisProfileToOscalCD</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to transform OCP4 CIS profile to OSCAL component-definition.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ocp4-cis-profile-to-oscal-cd&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task ocp4-cis-profile-to-oscal-cd.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>set_timestamp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set the timestamp.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Purpose: Create component definition from standard (e.g. CIS benchmark).&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.ocp4-cis-profile-to-oscal-cd]:&#39;</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  component-name         = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;component name, e.g. OSCO.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  org-name               = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;organization name, e.g. International Business Machines.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  org-remarks            = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;organization remarks, e.g. IBM.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  folder-cac             = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;folder containing compliance-as-code artifacts, e.g adjunct-data/cis-benchmarks/content.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir             = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;location to write the generated component-definition.json file.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=c1>#</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-name           = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile name, e.g. OCP4 CIS-benchmark v4.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-mnemonic       = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile mnemonic, e.g. ocp4-cis-node.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-ns             = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile ns, e.g. https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-version        = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile version, e.g. 1.1.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-check-version  = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile check version, e.g. 0.1.58.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=c1>#</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-type           = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile type, e.g. OCP4.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-list           = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile list is blank separated list of &quot;&lt;suffix&gt;&quot; for config entries: &#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;                           profile-file.&lt;suffix&gt;, profile-title.&lt;suffix&gt;, profile-url.&lt;suffix&gt;&#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;, e.g. cis cis-node.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-file.&lt;suffix&gt;  = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;path of the profile file to ingest&#39;</span>
+        <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;, e.g. ${folder-cac}/products/ocp4/profiles/cis-node.profile.&#39;</span>  <span class=c1># noqa</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-title.&lt;suffix&gt; = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;title of the profile&#39;</span>
+        <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;, e.g. CIS Red Hat OpenShift Container Platform 4 Benchmark.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-url.&lt;suffix&gt;   = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;URL of the profile&#39;</span>
+        <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;, e.g. https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  rule-to-parameters-map = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;map file for set-parameters, e.g. &#39;</span>
+        <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;adjunct-data/task-files/rule2var.json.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  selected-rules         = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;file with list of selected rules, e.g. &#39;</span>
+        <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;adjunct-data/task-files/selected_rules.json.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  enabled-rules          = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;file with list of enabled rules, e.g. &#39;</span>
+        <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;adjunct-data/task-files/enabled_rules.json.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+        <span class=c1>#</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;Notes:&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;1. If a control has selected rules but no enabled rules, then all those selected are included.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;2. If a control has selected and enabled rules, then only those enabled are included.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;3. If a control has no selected rules, then none are included regardless of enabled.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>component_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;component-name&#39;</span><span class=p>]</span>
+            <span class=n>org_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;org-name&#39;</span><span class=p>]</span>
+            <span class=n>org_remarks</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;org-remarks&#39;</span><span class=p>]</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_folder_cac</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;folder-cac&#39;</span><span class=p>]</span>
+            <span class=n>profile_check_version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;profile-check-version&#39;</span><span class=p>]</span>
+            <span class=n>profile_type</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;profile-type&#39;</span><span class=p>]</span>
+            <span class=n>profile_mnemonic</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;profile-mnemonic&#39;</span><span class=p>]</span>
+            <span class=n>profile_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;profile-name&#39;</span><span class=p>]</span>
+            <span class=n>profile_ns</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;profile-ns&#39;</span><span class=p>]</span>
+            <span class=n>profile_version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;profile-version&#39;</span><span class=p>]</span>
+            <span class=n>profile_sets</span> <span class=o>=</span> <span class=p>{}</span>
+            <span class=n>profile_list</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;profile-list&#39;</span><span class=p>]</span><span class=o>.</span><span class=n>split</span><span class=p>()</span>
+            <span class=k>for</span> <span class=n>profile</span> <span class=ow>in</span> <span class=n>profile_list</span><span class=p>:</span>
+                <span class=n>profile_sets</span><span class=p>[</span><span class=n>profile</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+                <span class=n>profile_sets</span><span class=p>[</span><span class=n>profile</span><span class=p>][</span><span class=s1>&#39;profile-file&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=sa>f</span><span class=s1>&#39;profile-file.</span><span class=si>{</span><span class=n>profile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>]</span>
+                <span class=n>profile_sets</span><span class=p>[</span><span class=n>profile</span><span class=p>][</span><span class=s1>&#39;profile-url&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=sa>f</span><span class=s1>&#39;profile-url.</span><span class=si>{</span><span class=n>profile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>]</span>
+                <span class=n>profile_sets</span><span class=p>[</span><span class=n>profile</span><span class=p>][</span><span class=s1>&#39;profile-title&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=sa>f</span><span class=s1>&#39;profile-title.</span><span class=si>{</span><span class=n>profile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>]</span>
+                <span class=n>profile_sets</span><span class=p>[</span><span class=n>profile</span><span class=p>][</span><span class=s1>&#39;profile-ns&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>profile_ns</span>
+                <span class=n>profile_sets</span><span class=p>[</span><span class=n>profile</span><span class=p>][</span><span class=s1>&#39;component-name&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>component_name</span>
+            <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;output-dir&#39;</span><span class=p>]</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=o>.</span><span class=n>args</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1> missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># selected rules</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_selected_rules</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_filter_rules</span><span class=p>(</span><span class=s1>&#39;selected-rules&#39;</span><span class=p>,</span> <span class=s1>&#39;selected&#39;</span><span class=p>)</span>
+        <span class=c1># enabled rules</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_enabled_rules</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_filter_rules</span><span class=p>(</span><span class=s1>&#39;enabled-rules&#39;</span><span class=p>,</span> <span class=s1>&#39;enabled&#39;</span><span class=p>)</span>
+        <span class=c1># verbosity</span>
+        <span class=n>quiet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=n>quiet</span>
+        <span class=c1># output</span>
+        <span class=n>overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># calculate output file name &amp; check writability</span>
+        <span class=n>oname</span> <span class=o>=</span> <span class=s1>&#39;component-definition.json&#39;</span>
+        <span class=n>ofile</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># fetch rule to parameters map</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_rule_to_parm_map</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_parameters_map</span><span class=p>(</span><span class=s1>&#39;rule-to-parameters-map&#39;</span><span class=p>)</span>
+        <span class=c1># roles, responsible_roles, parties, responsible parties</span>
+        <span class=n>party_uuid_01</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>party_uuid_02</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>party_uuid_03</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>roles</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_roles</span><span class=p>()</span>
+        <span class=n>responsible_roles</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_responsible_roles</span><span class=p>(</span><span class=n>party_uuid_01</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>)</span>
+        <span class=n>parties</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_parties</span><span class=p>(</span><span class=n>org_name</span><span class=p>,</span> <span class=n>org_remarks</span><span class=p>,</span> <span class=n>party_uuid_01</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>)</span>
+        <span class=n>responsible_parties</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_responsible_parties</span><span class=p>(</span><span class=n>party_uuid_01</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>)</span>
+        <span class=c1># metadata</span>
+        <span class=n>metadata</span> <span class=o>=</span> <span class=n>Metadata</span><span class=p>(</span>
+            <span class=n>title</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;Component definition for </span><span class=si>{</span><span class=n>profile_type</span><span class=si>}</span><span class=s1> profiles&#39;</span><span class=p>,</span>
+            <span class=n>last_modified</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span><span class=p>,</span>
+            <span class=n>oscal_version</span><span class=o>=</span><span class=n>OSCAL_VERSION</span><span class=p>,</span>
+            <span class=n>version</span><span class=o>=</span><span class=n>trestle</span><span class=o>.</span><span class=n>__version__</span><span class=p>,</span>
+            <span class=n>roles</span><span class=o>=</span><span class=n>roles</span><span class=p>,</span>
+            <span class=n>parties</span><span class=o>=</span><span class=n>parties</span><span class=p>,</span>
+            <span class=n>responsible_parties</span><span class=o>=</span><span class=n>responsible_parties</span>
+        <span class=p>)</span>
+        <span class=c1># defined component</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=n>component_name</span>
+        <span class=n>component_description</span> <span class=o>=</span> <span class=n>component_name</span>
+        <span class=n>defined_component</span> <span class=o>=</span> <span class=n>DefinedComponent</span><span class=p>(</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+            <span class=n>description</span><span class=o>=</span><span class=n>component_description</span><span class=p>,</span>
+            <span class=n>title</span><span class=o>=</span><span class=n>component_title</span><span class=p>,</span>
+            <span class=nb>type</span><span class=o>=</span><span class=s1>&#39;Service&#39;</span><span class=p>,</span>
+        <span class=p>)</span>
+        <span class=c1># add control implementation per profile</span>
+        <span class=n>prop1</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=s1>&#39;profile_name&#39;</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>profile_name</span><span class=p>,</span>
+            <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_profile_name&#39;</span><span class=p>,</span>
+            <span class=n>ns</span><span class=o>=</span><span class=n>profile_ns</span><span class=p>,</span>
+        <span class=p>)</span>
+        <span class=n>prop2</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=s1>&#39;profile_mnemonic&#39;</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>profile_mnemonic</span><span class=p>,</span>
+            <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_profile_mnemonic&#39;</span><span class=p>,</span>
+            <span class=n>ns</span><span class=o>=</span><span class=n>profile_ns</span><span class=p>,</span>
+        <span class=p>)</span>
+        <span class=n>prop3</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=s1>&#39;profile_version&#39;</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>profile_version</span><span class=p>,</span>
+            <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_profile_version&#39;</span><span class=p>,</span>
+            <span class=n>ns</span><span class=o>=</span><span class=n>profile_ns</span><span class=p>,</span>
+        <span class=p>)</span>
+        <span class=n>prop4</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+            <span class=n>name</span><span class=o>=</span><span class=s1>&#39;profile_check_version&#39;</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>profile_check_version</span><span class=p>,</span>
+        <span class=p>)</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=p>[</span><span class=n>prop1</span><span class=p>,</span> <span class=n>prop2</span><span class=p>,</span> <span class=n>prop3</span><span class=p>,</span> <span class=n>prop4</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>profile</span> <span class=ow>in</span> <span class=n>profile_list</span><span class=p>:</span>
+            <span class=n>profile_set</span> <span class=o>=</span> <span class=n>profile_sets</span><span class=p>[</span><span class=n>profile</span><span class=p>]</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_control_implementation</span><span class=p>(</span><span class=n>profile_set</span><span class=p>,</span> <span class=n>responsible_roles</span><span class=p>,</span> <span class=n>props</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control_implementation</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>defined_component</span><span class=o>.</span><span class=n>control_implementations</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>defined_component</span><span class=o>.</span><span class=n>control_implementations</span> <span class=o>=</span> <span class=p>[</span><span class=n>control_implementation</span><span class=p>]</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>defined_component</span><span class=o>.</span><span class=n>control_implementations</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_implementation</span><span class=p>)</span>
+        <span class=c1># defined components</span>
+        <span class=n>defined_components</span> <span class=o>=</span> <span class=p>[</span><span class=n>defined_component</span><span class=p>]</span>
+        <span class=c1># component definition</span>
+        <span class=n>component_definition</span> <span class=o>=</span> <span class=n>ComponentDefinition</span><span class=p>(</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+            <span class=n>metadata</span><span class=o>=</span><span class=n>metadata</span><span class=p>,</span>
+            <span class=n>components</span><span class=o>=</span><span class=n>defined_components</span><span class=p>,</span>
+        <span class=p>)</span>
+        <span class=c1># write OSCAL ComponentDefinition to file</span>
+        <span class=k>if</span> <span class=n>verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>component_definition</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>))</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_set_parameter</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>SetParameter</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get set parameter.&quot;&quot;&quot;</span>
+        <span class=n>set_parameter</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_to_parm_map</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>rule</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>key</span> <span class=o>==</span> <span class=n>rule</span><span class=p>:</span>
+                <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_to_parm_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+                <span class=n>remarks</span> <span class=o>=</span> <span class=n>value</span><span class=p>[</span><span class=s1>&#39;description&#39;</span><span class=p>]</span>
+                <span class=n>options</span> <span class=o>=</span> <span class=n>value</span><span class=p>[</span><span class=s1>&#39;options&#39;</span><span class=p>]</span>
+                <span class=n>default_value</span> <span class=o>=</span> <span class=n>options</span><span class=p>[</span><span class=s1>&#39;default&#39;</span><span class=p>]</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;key: </span><span class=si>{</span><span class=n>key</span><span class=si>}</span><span class=s1> options: </span><span class=si>{</span><span class=n>options</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>set_parameter</span> <span class=o>=</span> <span class=n>SetParameter</span><span class=p>(</span>
+                    <span class=n>param_id</span><span class=o>=</span><span class=n>rule</span><span class=p>,</span>
+                    <span class=n>values</span><span class=o>=</span><span class=p>[</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>default_value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>],</span>
+                    <span class=n>remarks</span><span class=o>=</span><span class=n>remarks</span><span class=p>,</span>
+                <span class=p>)</span>
+        <span class=k>return</span> <span class=n>set_parameter</span>
+
+    <span class=k>def</span> <span class=nf>_get_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rules</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get controls.&quot;&quot;&quot;</span>
+        <span class=n>controls</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>rule</span> <span class=ow>in</span> <span class=n>rules</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=n>rules</span><span class=p>[</span><span class=n>rule</span><span class=p>][</span><span class=mi>1</span><span class=p>]</span>
+            <span class=k>if</span> <span class=n>control</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>controls</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=n>controls</span><span class=p>[</span><span class=n>control</span><span class=p>]</span> <span class=o>=</span> <span class=p>[</span><span class=n>rule</span><span class=p>]</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>controls</span><span class=p>[</span><span class=n>control</span><span class=p>]</span> <span class=o>=</span> <span class=n>controls</span><span class=p>[</span><span class=n>control</span><span class=p>]</span> <span class=o>+</span> <span class=p>[</span><span class=n>rule</span><span class=p>]</span>
+        <span class=c1># trim rules associated with control with respect to enabled rules</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>controls</span><span class=p>:</span>
+            <span class=n>controls</span><span class=p>[</span><span class=n>control</span><span class=p>]</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_trimmed_rules</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>controls</span><span class=p>[</span><span class=n>control</span><span class=p>])</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>control</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>controls</span><span class=p>[</span><span class=n>control</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>controls</span>
+
+    <span class=c1># determine if trim is needed for the control, and if so then</span>
+    <span class=c1># for the associated set of rules drop those that are not enabled</span>
+    <span class=k>def</span> <span class=nf>_get_trimmed_rules</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>rules_for_control</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Trim rules if any rule for control appears in enabled rules list.&quot;&quot;&quot;</span>
+        <span class=n>retval</span> <span class=o>=</span> <span class=n>rules_for_control</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_trim_needed</span><span class=p>(</span><span class=n>rules_for_control</span><span class=p>):</span>
+            <span class=n>retval</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>rule</span> <span class=ow>in</span> <span class=n>rules_for_control</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>rule</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_enabled_rules</span><span class=p>:</span>
+                    <span class=n>retval</span> <span class=o>=</span> <span class=n>retval</span> <span class=o>+</span> <span class=p>[</span><span class=n>rule</span><span class=p>]</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;keep </span><span class=si>{</span><span class=n>control</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>rule</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;drop </span><span class=si>{</span><span class=n>control</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>rule</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>retval</span>
+
+    <span class=c1># if any rule in the set of rules for the control appears in the enabled list,</span>
+    <span class=c1># then trim is needed</span>
+    <span class=k>def</span> <span class=nf>_is_trim_needed</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rules_for_control</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if trim is needed.&quot;&quot;&quot;</span>
+        <span class=n>retval</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>for</span> <span class=n>rule</span> <span class=ow>in</span> <span class=n>rules_for_control</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>rule</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_enabled_rules</span><span class=p>:</span>
+                <span class=n>retval</span> <span class=o>=</span> <span class=kc>True</span>
+                <span class=k>break</span>
+        <span class=k>return</span> <span class=n>retval</span>
+
+    <span class=c1># fetch the set of rules that will be included/excluded from the CIS rules</span>
+    <span class=k>def</span> <span class=nf>_get_parameters_map</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parameters map.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>fp</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=n>config_key</span><span class=p>])</span>
+            <span class=n>f</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+            <span class=n>jdata</span> <span class=o>=</span> <span class=n>json</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>f</span><span class=p>)</span>
+            <span class=n>parameters_map</span> <span class=o>=</span> <span class=n>jdata</span>
+            <span class=n>f</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=o>.</span><span class=n>args</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1> missing&#39;</span><span class=p>)</span>
+            <span class=n>parameters_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;unable to process </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=n>config_key</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>parameters_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>return</span> <span class=n>parameters_map</span>
+
+    <span class=c1># fetch the set of rules that will be included/excluded from the CIS rules</span>
+    <span class=k>def</span> <span class=nf>_get_filter_rules</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_key</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>file_key</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get filter rules.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>fp</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=n>config_key</span><span class=p>])</span>
+            <span class=n>f</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+            <span class=n>jdata</span> <span class=o>=</span> <span class=n>json</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>f</span><span class=p>)</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>filter_rules</span> <span class=o>=</span> <span class=n>jdata</span><span class=p>[</span><span class=n>file_key</span><span class=p>]</span>
+            <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+                <span class=n>filter_rules</span> <span class=o>=</span> <span class=n>jdata</span>
+            <span class=n>f</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=o>.</span><span class=n>args</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1> missing&#39;</span><span class=p>)</span>
+            <span class=n>filter_rules</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;unable to process </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=n>config_key</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>filter_rules</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>return</span> <span class=n>filter_rules</span>
+
+    <span class=c1># create map from file:</span>
+    <span class=c1># key is rule</span>
+    <span class=c1># value is tuple comprising [ category, control, description ]</span>
+    <span class=k>def</span> <span class=nf>_get_cis_rules</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>filename</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get CIS rules.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>fp</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>filename</span><span class=p>)</span>
+            <span class=n>f</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+            <span class=n>content</span> <span class=o>=</span> <span class=n>f</span><span class=o>.</span><span class=n>readlines</span><span class=p>()</span>
+            <span class=n>rules</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_parse_cis_rules</span><span class=p>(</span><span class=n>content</span><span class=p>)</span>
+            <span class=n>f</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;unable to process </span><span class=si>{</span><span class=n>filename</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>rules</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>return</span> <span class=n>rules</span>
+
+    <span class=k>def</span> <span class=nf>_parse_cis_rules</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>content</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Parse CIS rules.&quot;&quot;&quot;</span>
+        <span class=n>rules</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>lineno</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>content</span><span class=p>:</span>
+            <span class=n>lineno</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=n>line</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;  #### &#39;</span><span class=p>):</span>
+                <span class=n>category</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;  #### &#39;</span><span class=p>)[</span><span class=mi>1</span><span class=p>]</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>lineno</span><span class=si>}</span><span class=s1> category: </span><span class=si>{</span><span class=n>category</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;  # &#39;</span><span class=p>):</span>
+                <span class=n>text</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;  # &#39;</span><span class=p>)[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+                <span class=k>if</span> <span class=s1>&#39;.&#39;</span> <span class=ow>in</span> <span class=n>text</span><span class=p>[</span><span class=mi>0</span><span class=p>]:</span>
+                    <span class=n>control</span> <span class=o>=</span> <span class=n>text</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+                    <span class=n>desc</span> <span class=o>=</span> <span class=n>text</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>lineno</span><span class=si>}</span><span class=s1> control: </span><span class=si>{</span><span class=n>control</span><span class=si>}</span><span class=s1> description: </span><span class=si>{</span><span class=n>desc</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>lineno</span><span class=si>}</span><span class=s1> skip: </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;    - &#39;</span><span class=p>):</span>
+                <span class=n>rule</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;    - &#39;</span><span class=p>)[</span><span class=mi>1</span><span class=p>]</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>lineno</span><span class=si>}</span><span class=s1> rule: </span><span class=si>{</span><span class=n>rule</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_selected</span><span class=p>(</span><span class=n>rule</span><span class=p>):</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;not selected rule: </span><span class=si>{</span><span class=n>rule</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>elif</span> <span class=n>rule</span> <span class=ow>in</span> <span class=n>rules</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;duplicate rule: </span><span class=si>{</span><span class=n>rule</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>rules</span><span class=p>[</span><span class=n>rule</span><span class=p>]</span> <span class=o>=</span> <span class=p>[</span><span class=n>category</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>desc</span><span class=p>]</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>lineno</span><span class=si>}</span><span class=s1> skip: </span><span class=si>{</span><span class=n>line</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rules</span>
+
+    <span class=c1># rule is selected if:</span>
+    <span class=c1># a) the selected rules file is not specified or is empty or</span>
+    <span class=c1># b) the rule appears in the list of selected rules from the file</span>
+    <span class=k>def</span> <span class=nf>_is_selected</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if rule is selected.&quot;&quot;&quot;</span>
+        <span class=n>retval</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_selected_rules</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span> <span class=ow>and</span> <span class=n>rule</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_selected_rules</span><span class=p>:</span>
+            <span class=n>retval</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>retval</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>rule</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>retval</span>
+
+    <span class=c1># rule is excluded if it does not appear in the list of trimmed rules</span>
+    <span class=c1># for the control</span>
+    <span class=k>def</span> <span class=nf>_is_excluded</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>controls</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if rule is excluded.&quot;&quot;&quot;</span>
+        <span class=n>retval</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=n>rule</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>controls</span><span class=p>[</span><span class=n>control</span><span class=p>]:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;exclude </span><span class=si>{</span><span class=n>rule</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>control</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>retval</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=n>retval</span>
+
+    <span class=k>def</span> <span class=nf>_build_roles</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Role</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build roles.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>Role</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=s1>&#39;prepared-by&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Indicates the organization that created this content.&#39;</span><span class=p>),</span>
+            <span class=n>Role</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=s1>&#39;prepared-for&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Indicates the organization for which this content was created..&#39;</span><span class=p>),</span>
+            <span class=n>Role</span><span class=p>(</span>
+                <span class=nb>id</span><span class=o>=</span><span class=s1>&#39;content-approver&#39;</span><span class=p>,</span>
+                <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Indicates the organization responsible for all content represented in the &quot;document&quot;.&#39;</span>
+            <span class=p>),</span>
+        <span class=p>]</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_build_control_implementation</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>profile_set</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>],</span> <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ControlImplementation</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build control implementation.&quot;&quot;&quot;</span>
+        <span class=n>implemented_requirements</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_implemented_requirements</span><span class=p>(</span><span class=n>profile_set</span><span class=p>,</span> <span class=n>responsible_roles</span><span class=p>)</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>implemented_requirements</span><span class=p>)</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=n>ControlImplementation</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+                <span class=n>source</span><span class=o>=</span><span class=n>profile_set</span><span class=p>[</span><span class=s1>&#39;profile-url&#39;</span><span class=p>],</span>
+                <span class=n>description</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>profile_set</span><span class=p>[</span><span class=s2>&quot;component-name&quot;</span><span class=p>]</span><span class=si>}</span><span class=s1> implemented controls for </span><span class=si>{</span><span class=n>profile_set</span><span class=p>[</span><span class=s2>&quot;profile-title&quot;</span><span class=p>]</span><span class=si>}</span><span class=s1>.&#39;</span><span class=p>,</span>
+                <span class=n>implemented_requirements</span><span class=o>=</span><span class=n>implemented_requirements</span><span class=p>,</span>
+                <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span>
+            <span class=p>)</span>
+        <span class=k>return</span> <span class=n>control_implementation</span>
+
+    <span class=k>def</span> <span class=nf>_get_title</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>dir_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>root</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Extract rule title from compliance-as-code rule.yml.&quot;&quot;&quot;</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Operation:</span>
+<span class=sd>        Given is a dir_name and a root directory. We walk the</span>
+<span class=sd>        directory tree looking for a directory named dir_name.</span>
+<span class=sd>        Once found, we read the content of the rule.yml file in</span>
+<span class=sd>        that directory. It is likely that we read each rule.yml</span>
+<span class=sd>        file exactly once, since each rule appears exactly once</span>
+<span class=sd>        in the one or more profiles, e.g. cis-node.profile, which</span>
+<span class=sd>        drive the search. From the content, we find the title and</span>
+<span class=sd>        return its corresponding value.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+
+        <span class=n>title</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>path</span><span class=p>,</span> <span class=n>dirs</span><span class=p>,</span> <span class=n>_files</span> <span class=ow>in</span> <span class=n>os</span><span class=o>.</span><span class=n>walk</span><span class=p>(</span><span class=n>root</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>dir_name</span> <span class=ow>in</span> <span class=n>dirs</span><span class=p>:</span>
+                <span class=n>folder</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>path</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>path</span><span class=p>,</span> <span class=n>dir_name</span><span class=p>)</span>
+                <span class=n>tpath</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>folder</span><span class=p>)</span> <span class=o>/</span> <span class=s1>&#39;rule.yml&#39;</span>
+                <span class=n>fp</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>tpath</span><span class=p>)</span>
+                <span class=n>f</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>open</span><span class=p>(</span><span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span>
+                <span class=n>content</span> <span class=o>=</span> <span class=n>f</span><span class=o>.</span><span class=n>readlines</span><span class=p>()</span>
+                <span class=n>f</span><span class=o>.</span><span class=n>close</span><span class=p>()</span>
+                <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>content</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>line</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;title:&#39;</span><span class=p>):</span>
+                        <span class=n>title</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;title:&#39;</span><span class=p>)[</span><span class=mi>1</span><span class=p>]</span>
+                        <span class=k>break</span>
+        <span class=k>if</span> <span class=n>title</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>msg</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;unable to find &quot;</span><span class=si>{</span><span class=n>dir_name</span><span class=si>}</span><span class=s1>&quot;&#39;</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=n>msg</span><span class=p>)</span>
+            <span class=n>title</span> <span class=o>=</span> <span class=s1>&#39;no title&#39;</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=n>title</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s2>&quot;&#39;&quot;</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>(</span><span class=s1>&#39;&quot;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>title</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>title</span>
+
+    <span class=k>def</span> <span class=nf>_build_implemented_requirements</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>profile_set</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span>
+                                        <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ImplementedRequirement</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build implemented requirements.&quot;&quot;&quot;</span>
+        <span class=n>implemented_requirements</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>profile_file</span> <span class=o>=</span> <span class=n>profile_set</span><span class=p>[</span><span class=s1>&#39;profile-file&#39;</span><span class=p>]</span>
+        <span class=n>rules</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_cis_rules</span><span class=p>(</span><span class=n>profile_file</span><span class=p>)</span>
+        <span class=n>controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_controls</span><span class=p>(</span><span class=n>rules</span><span class=p>)</span>
+        <span class=n>rule_prefix</span> <span class=o>=</span> <span class=s1>&#39;xccdf_org.ssgproject.content_rule_&#39;</span>
+        <span class=n>cac_openshift</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_folder_cac</span><span class=si>}</span><span class=s1>/applications/openshift&#39;</span>
+        <span class=k>for</span> <span class=n>rule</span> <span class=ow>in</span> <span class=n>rules</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_excluded</span><span class=p>(</span><span class=n>rule</span><span class=p>,</span> <span class=n>rules</span><span class=p>[</span><span class=n>rule</span><span class=p>][</span><span class=mi>1</span><span class=p>],</span> <span class=n>controls</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=n>remarks</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_title</span><span class=p>(</span><span class=n>rule</span><span class=p>,</span> <span class=n>cac_openshift</span><span class=p>)</span>
+            <span class=n>prop</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+                <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_goal_name_id&#39;</span><span class=p>,</span>
+                <span class=n>ns</span><span class=o>=</span><span class=n>profile_set</span><span class=p>[</span><span class=s1>&#39;profile-ns&#39;</span><span class=p>],</span>
+                <span class=n>name</span><span class=o>=</span><span class=s1>&#39;XCCDF_rule&#39;</span><span class=p>,</span>
+                <span class=n>value</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>rule_prefix</span><span class=si>}{</span><span class=n>rule</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+                <span class=n>remarks</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>remarks</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=p>)</span>
+            <span class=n>props</span> <span class=o>=</span> <span class=p>[</span><span class=n>prop</span><span class=p>]</span>
+            <span class=n>implemented_requirement</span> <span class=o>=</span> <span class=n>ImplementedRequirement</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+                <span class=n>control_id</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;CIS-</span><span class=si>{</span><span class=n>rules</span><span class=p>[</span><span class=n>rule</span><span class=p>][</span><span class=mi>1</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+                <span class=n>description</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>rules</span><span class=p>[</span><span class=n>rule</span><span class=p>][</span><span class=mi>2</span><span class=p>]</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>,</span>
+                <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span>
+                <span class=n>responsible_roles</span><span class=o>=</span><span class=n>responsible_roles</span><span class=p>,</span>
+            <span class=p>)</span>
+            <span class=n>set_parameter</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_set_parameter</span><span class=p>(</span><span class=n>rule</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>set_parameter</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[</span><span class=n>set_parameter</span><span class=p>]</span>
+            <span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>implemented_requirements</span>
+
+    <span class=k>def</span> <span class=nf>_build_responsible_roles</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>party_uuid_01</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                                 <span class=n>party_uuid_03</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build responsible roles.&quot;&quot;&quot;</span>
+        <span class=n>role_prepared_by</span> <span class=o>=</span> <span class=n>ResponsibleRole</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;prepared-by&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_01</span><span class=p>])</span>
+        <span class=n>role_prepared_for</span> <span class=o>=</span> <span class=n>ResponsibleRole</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;prepared-for&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>])</span>
+        <span class=n>role_content_approver</span> <span class=o>=</span> <span class=n>ResponsibleRole</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;content-approver&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_01</span><span class=p>])</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>role_prepared_by</span><span class=p>,</span>
+            <span class=n>role_prepared_for</span><span class=p>,</span>
+            <span class=n>role_content_approver</span><span class=p>,</span>
+        <span class=p>]</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_build_parties</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>org_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>org_remarks</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>party_uuid_01</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Party</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build parties.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>Party</span><span class=p>(</span><span class=n>uuid</span><span class=o>=</span><span class=n>party_uuid_01</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=s1>&#39;organization&#39;</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=n>org_name</span><span class=p>,</span> <span class=n>remarks</span><span class=o>=</span><span class=n>org_remarks</span><span class=p>),</span>
+            <span class=n>Party</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=n>party_uuid_02</span><span class=p>,</span>
+                <span class=nb>type</span><span class=o>=</span><span class=s1>&#39;organization&#39;</span><span class=p>,</span>
+                <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Customer&#39;</span><span class=p>,</span>
+                <span class=n>remarks</span><span class=o>=</span><span class=s1>&#39;organization to be customized at account creation only for their Component Definition&#39;</span>
+            <span class=p>),</span>
+            <span class=n>Party</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=n>party_uuid_03</span><span class=p>,</span>
+                <span class=nb>type</span><span class=o>=</span><span class=s1>&#39;organization&#39;</span><span class=p>,</span>
+                <span class=n>name</span><span class=o>=</span><span class=s1>&#39;ISV&#39;</span><span class=p>,</span>
+                <span class=n>remarks</span><span class=o>=</span><span class=s1>&#39;organization to be customized at ISV subscription only for their Component Definition&#39;</span>
+            <span class=p>),</span>
+        <span class=p>]</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_build_responsible_parties</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>party_uuid_01</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                                   <span class=n>party_uuid_03</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build responsible parties.&quot;&quot;&quot;</span>
+        <span class=n>prepared_by</span> <span class=o>=</span> <span class=n>ResponsibleParty</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;prepared-by&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_01</span><span class=p>])</span>
+        <span class=n>prepared_for</span> <span class=o>=</span> <span class=n>ResponsibleParty</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;prepared-for&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>])</span>
+        <span class=n>content_approver</span> <span class=o>=</span> <span class=n>ResponsibleParty</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;content-approver&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_01</span><span class=p>])</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>prepared_by</span><span class=p>,</span>
+            <span class=n>prepared_for</span><span class=p>,</span>
+            <span class=n>content_approver</span><span class=p>,</span>
+        <span class=p>]</span>
+        <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-attributes>Attributes<a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;ocp4-cis-profile-to-oscal-cd&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-functions>Functions<a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task ocp4-cis-profile-to-oscal-cd.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task ocp4-cis-profile-to-oscal-cd.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an actual outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Purpose: Create component definition from standard (e.g. CIS benchmark).&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.ocp4-cis-profile-to-oscal-cd]:&#39;</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  component-name         = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;component name, e.g. OSCO.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  org-name               = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;organization name, e.g. International Business Machines.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  org-remarks            = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;organization remarks, e.g. IBM.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  folder-cac             = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;folder containing compliance-as-code artifacts, e.g adjunct-data/cis-benchmarks/content.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir             = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;location to write the generated component-definition.json file.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=c1>#</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-name           = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile name, e.g. OCP4 CIS-benchmark v4.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-mnemonic       = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile mnemonic, e.g. ocp4-cis-node.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-ns             = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile ns, e.g. https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-version        = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile version, e.g. 1.1.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-check-version  = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile check version, e.g. 0.1.58.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=c1>#</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-type           = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile type, e.g. OCP4.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-list           = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;profile list is blank separated list of &quot;&lt;suffix&gt;&quot; for config entries: &#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;                           profile-file.&lt;suffix&gt;, profile-title.&lt;suffix&gt;, profile-url.&lt;suffix&gt;&#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;, e.g. cis cis-node.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-file.&lt;suffix&gt;  = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;path of the profile file to ingest&#39;</span>
+    <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;, e.g. ${folder-cac}/products/ocp4/profiles/cis-node.profile.&#39;</span>  <span class=c1># noqa</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-title.&lt;suffix&gt; = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;title of the profile&#39;</span>
+    <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;, e.g. CIS Red Hat OpenShift Container Platform 4 Benchmark.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-url.&lt;suffix&gt;   = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;URL of the profile&#39;</span>
+    <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;, e.g. https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  rule-to-parameters-map = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;map file for set-parameters, e.g. &#39;</span>
+    <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;adjunct-data/task-files/rule2var.json.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  selected-rules         = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;file with list of selected rules, e.g. &#39;</span>
+    <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;adjunct-data/task-files/selected_rules.json.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  enabled-rules          = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;file with list of enabled rules, e.g. &#39;</span>
+    <span class=n>text3</span> <span class=o>=</span> <span class=s1>&#39;adjunct-data/task-files/enabled_rules.json.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span> <span class=o>+</span> <span class=n>text3</span><span class=p>)</span>
+    <span class=c1>#</span>
+    <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+    <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;Notes:&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+    <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;1. If a control has selected rules but no enabled rules, then all those selected are included.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+    <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;2. If a control has selected and enabled rules, then only those enabled are included.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+    <span class=n>text</span> <span class=o>=</span> <span class=s1>&#39;3. If a control has no selected rules, then none are included regardless of enabled.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.set_timestamp class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_timestamp</span><span class=p>(</span><span class=n>timestamp</span><span class=p>)</span></code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.set_timestamp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set the timestamp.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_timestamp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set the timestamp.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/oscal_catalog_to_csv/index.html b/latest/reference/API/trestle/tasks/oscal_catalog_to_csv/index.html
new file mode 100644
index 000000000..247b01c75
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/oscal_catalog_to_csv/index.html
@@ -0,0 +1,1037 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.oscal_catalog_to_csv module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/oscal_catalog_to_csv/ rel=canonical><link href=../ocp4_cis_profile_to_oscal_cd/ rel=prev><link href=../oscal_profile_to_osco_profile/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.oscal_catalog_to_csv - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.oscal_catalog_to_csv - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.oscal_catalog_to_csv module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/oscal_catalog_to_csv.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/oscal_catalog_to_csv/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.oscal_catalog_to_csv - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.oscal_catalog_to_csv module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/oscal_catalog_to_csv.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.oscal_catalog_to_csv class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv class=md-nav__link> <span class=md-ellipsis> oscal_catalog_to_csv </span> </a> <nav class=md-nav aria-label=oscal_catalog_to_csv> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.level_control class=md-nav__link> <span class=md-ellipsis> level_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.level_default class=md-nav__link> <span class=md-ellipsis> level_default </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.level_list class=md-nav__link> <span class=md-ellipsis> level_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.level_statement class=md-nav__link> <span class=md-ellipsis> level_statement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.recurse class=md-nav__link> <span class=md-ellipsis> recurse </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.timestamp class=md-nav__link> <span class=md-ellipsis> timestamp </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper class=md-nav__link> <span class=md-ellipsis> CatalogHelper </span> </a> <nav class=md-nav aria-label=CatalogHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog class=md-nav__link> <span class=md-ellipsis> catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog_interface class=md-nav__link> <span class=md-ellipsis> catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.path class=md-nav__link> <span class=md-ellipsis> path </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_controls class=md-nav__link> <span class=md-ellipsis> get_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_family_controls class=md-nav__link> <span class=md-ellipsis> get_family_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_parent_control class=md-nav__link> <span class=md-ellipsis> get_parent_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_control class=md-nav__link> <span class=md-ellipsis> get_statement_text_for_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_part class=md-nav__link> <span class=md-ellipsis> get_statement_text_for_part </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager class=md-nav__link> <span class=md-ellipsis> ContentManager </span> </a> <nav class=md-nav aria-label=ContentManager> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.catalog_helper class=md-nav__link> <span class=md-ellipsis> catalog_helper </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.row_template class=md-nav__link> <span class=md-ellipsis> row_template </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.rows class=md-nav__link> <span class=md-ellipsis> rows </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.add class=md-nav__link> <span class=md-ellipsis> add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.get_content class=md-nav__link> <span class=md-ellipsis> get_content </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper class=md-nav__link> <span class=md-ellipsis> CsvHelper </span> </a> <nav class=md-nav aria-label=CsvHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper.path class=md-nav__link> <span class=md-ellipsis> path </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper.write class=md-nav__link> <span class=md-ellipsis> write </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv class=md-nav__link> <span class=md-ellipsis> OscalCatalogToCsv </span> </a> <nav class=md-nav aria-label=OscalCatalogToCsv> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.convert_control_id class=md-nav__link> <span class=md-ellipsis> convert_control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.convert_smt_id class=md-nav__link> <span class=md-ellipsis> convert_smt_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.join_str class=md-nav__link> <span class=md-ellipsis> join_str </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv class=md-nav__link> <span class=md-ellipsis> oscal_catalog_to_csv </span> </a> <nav class=md-nav aria-label=oscal_catalog_to_csv> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.level_control class=md-nav__link> <span class=md-ellipsis> level_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.level_default class=md-nav__link> <span class=md-ellipsis> level_default </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.level_list class=md-nav__link> <span class=md-ellipsis> level_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.level_statement class=md-nav__link> <span class=md-ellipsis> level_statement </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.recurse class=md-nav__link> <span class=md-ellipsis> recurse </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.timestamp class=md-nav__link> <span class=md-ellipsis> timestamp </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper class=md-nav__link> <span class=md-ellipsis> CatalogHelper </span> </a> <nav class=md-nav aria-label=CatalogHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog class=md-nav__link> <span class=md-ellipsis> catalog </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog_interface class=md-nav__link> <span class=md-ellipsis> catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.path class=md-nav__link> <span class=md-ellipsis> path </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_controls class=md-nav__link> <span class=md-ellipsis> get_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_family_controls class=md-nav__link> <span class=md-ellipsis> get_family_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_parent_control class=md-nav__link> <span class=md-ellipsis> get_parent_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_control class=md-nav__link> <span class=md-ellipsis> get_statement_text_for_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_part class=md-nav__link> <span class=md-ellipsis> get_statement_text_for_part </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager class=md-nav__link> <span class=md-ellipsis> ContentManager </span> </a> <nav class=md-nav aria-label=ContentManager> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.catalog_helper class=md-nav__link> <span class=md-ellipsis> catalog_helper </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.row_template class=md-nav__link> <span class=md-ellipsis> row_template </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.rows class=md-nav__link> <span class=md-ellipsis> rows </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.add class=md-nav__link> <span class=md-ellipsis> add </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.get_content class=md-nav__link> <span class=md-ellipsis> get_content </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper class=md-nav__link> <span class=md-ellipsis> CsvHelper </span> </a> <nav class=md-nav aria-label=CsvHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper.path class=md-nav__link> <span class=md-ellipsis> path </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper.write class=md-nav__link> <span class=md-ellipsis> write </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv class=md-nav__link> <span class=md-ellipsis> OscalCatalogToCsv </span> </a> <nav class=md-nav aria-label=OscalCatalogToCsv> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.convert_control_id class=md-nav__link> <span class=md-ellipsis> convert_control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.convert_smt_id class=md-nav__link> <span class=md-ellipsis> convert_smt_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_catalog_to_csv.join_str class=md-nav__link> <span class=md-ellipsis> join_str </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.oscal_catalog_to_csv</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.oscal_catalog_to_csv class="doc doc-heading"> <code>trestle.tasks.oscal_catalog_to_csv</code> <a href=#trestle.tasks.oscal_catalog_to_csv class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.oscal_catalog_to_csv-attributes>Attributes<a href=#trestle.tasks.oscal_catalog_to_csv-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.oscal_catalog_to_csv.level_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>level_control</span> <span class=o>=</span> <span class=s1>&#39;control&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.level_control class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.oscal_catalog_to_csv.level_default class="doc doc-heading"> <code class="highlight language-python"><span class=n>level_default</span> <span class=o>=</span> <span class=n>level_statement</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.level_default class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.oscal_catalog_to_csv.level_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>level_list</span> <span class=o>=</span> <span class=p>[</span><span class=n>level_control</span><span class=p>,</span> <span class=n>level_statement</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.level_list class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.oscal_catalog_to_csv.level_statement class="doc doc-heading"> <code class="highlight language-python"><span class=n>level_statement</span> <span class=o>=</span> <span class=s1>&#39;statement&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.level_statement class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.oscal_catalog_to_csv.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.oscal_catalog_to_csv.recurse class="doc doc-heading"> <code class="highlight language-python"><span class=n>recurse</span> <span class=o>=</span> <span class=kc>True</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.recurse class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.oscal_catalog_to_csv.timestamp class="doc doc-heading"> <code class="highlight language-python"><span class=n>timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.timestamp class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.oscal_catalog_to_csv-classes>Classes<a href=#trestle.tasks.oscal_catalog_to_csv-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper class="doc doc-heading"> <code>CatalogHelper</code> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>OSCAL Catalog Helper.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CatalogHelper</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;OSCAL Catalog Helper.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>path</span> <span class=o>=</span> <span class=n>path</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>catalog</span> <span class=o>=</span> <span class=n>Catalog</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>catalog</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_init_control_parent_map</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_init_control_parent_map</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>recurse</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize map: Child Control.id to parent Control.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_control_parent_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=n>recurse</span><span class=p>):</span>
+            <span class=n>parents</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_dependent_control_ids</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>parent</span> <span class=ow>in</span> <span class=n>parents</span><span class=p>:</span>
+                <span class=c1># assert child has only one parent</span>
+                <span class=k>if</span> <span class=n>parent</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_parent_map</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=s1>&#39;</span><span class=si>{parent}</span><span class=s1> duplicate?&#39;</span><span class=p>)</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_control_parent_map</span><span class=p>[</span><span class=n>parent</span><span class=p>]</span> <span class=o>=</span> <span class=n>control</span>
+
+    <span class=k>def</span> <span class=nf>get_parent_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ctl_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Control</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return parent Control of child Control.id, if any.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_parent_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>ctl_id</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_family_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ctl_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return family of controls for Control.id, if any.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>search_id</span> <span class=o>=</span> <span class=n>ctl_id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=n>recurse</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>search_id</span><span class=p>):</span>
+                <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>get_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>recurse</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return controls iterator.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=n>recurse</span><span class=p>):</span>
+            <span class=k>yield</span> <span class=n>control</span>
+
+    <span class=k>def</span> <span class=nf>get_statement_text_for_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get statement text for control.&quot;&quot;&quot;</span>
+        <span class=n>statement_text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_withdrawn</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>statement_text</span>
+
+    <span class=k>def</span> <span class=nf>get_statement_text_for_part</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>Part</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get statement text for part.&quot;&quot;&quot;</span>
+        <span class=n>statement_text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_derive_text</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=k>if</span> <span class=s1>&#39;_smt&#39;</span> <span class=ow>in</span> <span class=n>subpart</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                    <span class=n>partial_text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_derive_text</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>subpart</span><span class=p>)</span>
+                    <span class=n>statement_text</span> <span class=o>=</span> <span class=n>join_str</span><span class=p>(</span><span class=n>statement_text</span><span class=p>,</span> <span class=n>partial_text</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>statement_text</span>
+
+    <span class=k>def</span> <span class=nf>_withdrawn</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check if withdrawn.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;status&#39;</span> <span class=ow>and</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;withdrawn&#39;</span><span class=p>:</span>
+                <span class=n>status</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_status</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+                <span class=n>rval</span> <span class=o>=</span> <span class=n>join_str</span><span class=p>(</span><span class=s1>&#39;Withdrawn&#39;</span><span class=p>,</span> <span class=n>status</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+                <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[</span><span class=si>{</span><span class=n>rval</span><span class=si>}</span><span class=s1>]&#39;</span>
+                <span class=k>break</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_link_generator</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=n>Link</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Link generator.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>links</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>link</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>links</span><span class=p>:</span>
+                <span class=k>yield</span> <span class=n>link</span>
+
+    <span class=k>def</span> <span class=nf>_get_status</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get status.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>ilist</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>link</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_link_generator</span><span class=p>(</span><span class=n>control</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>link</span><span class=o>.</span><span class=n>rel</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;moved-to&#39;</span><span class=p>:</span>
+                <span class=n>moved</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_href_to_control</span><span class=p>(</span><span class=n>link</span><span class=o>.</span><span class=n>href</span><span class=p>)</span>
+                <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;: Moved to </span><span class=si>{</span><span class=n>moved</span><span class=si>}</span><span class=s1>.&#39;</span>
+                <span class=k>break</span>
+            <span class=k>if</span> <span class=n>link</span><span class=o>.</span><span class=n>rel</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;incorporated-into&#39;</span><span class=p>:</span>
+                <span class=n>incorporated</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_href_to_control</span><span class=p>(</span><span class=n>link</span><span class=o>.</span><span class=n>href</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>ilist</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>ilist</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>incorporated</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>ilist</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>ilist</span><span class=si>}</span><span class=s1>, </span><span class=si>{</span><span class=n>incorporated</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>if</span> <span class=n>ilist</span><span class=p>:</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;: Incorporated into </span><span class=si>{</span><span class=n>ilist</span><span class=si>}</span><span class=s1>.&#39;</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_href_to_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>href</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Convert href to control.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>href</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;#&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>upper</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_derive_text</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>Part</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive control text.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>:</span>
+            <span class=n>id_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_derive_id</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolve_parms</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part</span><span class=o>.</span><span class=n>prose</span><span class=p>)</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=n>join_str</span><span class=p>(</span><span class=n>id_</span><span class=p>,</span> <span class=n>text</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_derive_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>id_</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive control text sub-part id.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>id_parts</span> <span class=o>=</span> <span class=n>id_</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;_smt&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>id_parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]:</span>
+            <span class=n>id_sub_parts</span> <span class=o>=</span> <span class=n>id_parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>id_sub_parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>2</span><span class=p>:</span>
+                <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>id_sub_parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span><span class=si>}</span><span class=s1>.&#39;</span>
+            <span class=k>elif</span> <span class=nb>len</span><span class=p>(</span><span class=n>id_sub_parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>3</span><span class=p>:</span>
+                <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>id_sub_parts</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span><span class=si>}</span><span class=s1>.&#39;</span>
+            <span class=k>elif</span> <span class=nb>len</span><span class=p>(</span><span class=n>id_sub_parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>4</span><span class=p>:</span>
+                <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;(</span><span class=si>{</span><span class=n>id_sub_parts</span><span class=p>[</span><span class=mi>3</span><span class=p>]</span><span class=si>}</span><span class=s1>)&#39;</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_resolve_parms</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>utext</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Resolve parm.&quot;&quot;&quot;</span>
+        <span class=n>rtext</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolve_parms_for_control</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>utext</span><span class=p>)</span>
+        <span class=k>if</span> <span class=s1>&#39;{{&#39;</span> <span class=ow>in</span> <span class=n>rtext</span><span class=p>:</span>
+            <span class=n>parent_control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parent_control</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>parent_control</span><span class=p>:</span>
+                <span class=n>rtext</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolve_parms_for_control</span><span class=p>(</span><span class=n>parent_control</span><span class=p>,</span> <span class=n>rtext</span><span class=p>)</span>
+        <span class=k>if</span> <span class=s1>&#39;{{&#39;</span> <span class=ow>in</span> <span class=n>rtext</span><span class=p>:</span>
+            <span class=n>family_controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_family_controls</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>family_control</span> <span class=ow>in</span> <span class=n>family_controls</span><span class=p>:</span>
+                <span class=n>rtext</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolve_parms_for_control</span><span class=p>(</span><span class=n>family_control</span><span class=p>,</span> <span class=n>rtext</span><span class=p>)</span>
+        <span class=k>if</span> <span class=s1>&#39;{{&#39;</span> <span class=ow>in</span> <span class=n>rtext</span><span class=p>:</span>
+            <span class=n>text</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;control.id: </span><span class=si>{</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=si>}</span><span class=s1> unresolved: </span><span class=si>{</span><span class=n>rtext</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=n>text</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rtext</span>
+
+    <span class=k>def</span> <span class=nf>_resolve_parms_for_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>utext</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Resolve parms for control.&quot;&quot;&quot;</span>
+        <span class=n>rtext</span> <span class=o>=</span> <span class=n>utext</span>
+        <span class=n>staches</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=n>re</span><span class=o>.</span><span class=n>findall</span><span class=p>(</span><span class=sa>r</span><span class=s1>&#39;{{.*?}}&#39;</span><span class=p>,</span> <span class=n>utext</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>staches</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>stach</span> <span class=ow>in</span> <span class=n>staches</span><span class=p>:</span>
+                <span class=n>parm_id</span> <span class=o>=</span> <span class=n>stach</span>
+                <span class=n>parm_id</span> <span class=o>=</span> <span class=n>parm_id</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;{{&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+                <span class=n>parm_id</span> <span class=o>=</span> <span class=n>parm_id</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;}}&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+                <span class=n>parm_id</span> <span class=o>=</span> <span class=n>parm_id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_parm_value</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>parm_id</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>value</span><span class=p>:</span>
+                    <span class=n>rtext</span> <span class=o>=</span> <span class=n>rtext</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>stach</span><span class=p>,</span> <span class=n>value</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rtext</span>
+
+    <span class=k>def</span> <span class=nf>_get_parm_value</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>parm_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parm value.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>param</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>params</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>id</span> <span class=o>!=</span> <span class=n>parm_id</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>label</span><span class=p>:</span>
+                    <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[Assignment: </span><span class=si>{</span><span class=n>param</span><span class=o>.</span><span class=n>label</span><span class=si>}</span><span class=s1>]&#39;</span>
+                <span class=k>elif</span> <span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=p>:</span>
+                    <span class=n>choices</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_parm_choices</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>param</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=o>.</span><span class=n>how_many</span> <span class=o>==</span> <span class=n>HowMany</span><span class=o>.</span><span class=n>one</span><span class=p>:</span>
+                        <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[Selection (one): </span><span class=si>{</span><span class=n>choices</span><span class=si>}</span><span class=s1>]&#39;</span>
+                    <span class=k>else</span><span class=p>:</span>
+                        <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;[Selection (one or more): </span><span class=si>{</span><span class=n>choices</span><span class=si>}</span><span class=s1>]&#39;</span>
+                    <span class=k>break</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_get_parm_choices</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>param</span><span class=p>:</span> <span class=n>Parameter</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parm choices.&quot;&quot;&quot;</span>
+        <span class=n>choices</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>for</span> <span class=n>choice</span> <span class=ow>in</span> <span class=n>param</span><span class=o>.</span><span class=n>select</span><span class=o>.</span><span class=n>choice</span><span class=p>:</span>
+            <span class=n>rchoice</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_resolve_parms</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>choice</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>choices</span><span class=p>:</span>
+                <span class=n>choices</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39;; </span><span class=si>{</span><span class=n>rchoice</span><span class=si>}</span><span class=s1>&#39;</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>choices</span> <span class=o>+=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>rchoice</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>return</span> <span class=n>choices</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper-attributes>Attributes<a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog class="doc doc-heading"> <code class="highlight language-python"><span class=n>catalog</span> <span class=o>=</span> <span class=n>Catalog</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog_interface class="doc doc-heading"> <code class="highlight language-python"><span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>catalog</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog_interface class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper.path class="doc doc-heading"> <code class="highlight language-python"><span class=n>path</span> <span class=o>=</span> <span class=n>path</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper-functions>Functions<a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>path</span> <span class=o>=</span> <span class=n>path</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>catalog</span> <span class=o>=</span> <span class=n>Catalog</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>path</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>catalog</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_init_control_parent_map</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_controls</span><span class=p>(</span><span class=n>recurse</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return controls iterator.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>recurse</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return controls iterator.&quot;&quot;&quot;</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=n>recurse</span><span class=p>):</span>
+        <span class=k>yield</span> <span class=n>control</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_family_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_family_controls</span><span class=p>(</span><span class=n>ctl_id</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_family_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return family of controls for Control.id, if any.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_family_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ctl_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Control</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return family of controls for Control.id, if any.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>search_id</span> <span class=o>=</span> <span class=n>ctl_id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+    <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_all_controls_from_catalog</span><span class=p>(</span><span class=n>recurse</span><span class=p>):</span>
+        <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=n>search_id</span><span class=p>):</span>
+            <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_parent_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_parent_control</span><span class=p>(</span><span class=n>ctl_id</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_parent_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return parent Control of child Control.id, if any.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_parent_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ctl_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Control</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Return parent Control of child Control.id, if any.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_control_parent_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>ctl_id</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_statement_text_for_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get statement text for control.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_statement_text_for_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get statement text for control.&quot;&quot;&quot;</span>
+    <span class=n>statement_text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_withdrawn</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>statement_text</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_part class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_statement_text_for_part</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_part class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get statement text for part.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_statement_text_for_part</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>Part</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get statement text for part.&quot;&quot;&quot;</span>
+    <span class=n>statement_text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_derive_text</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;_smt&#39;</span> <span class=ow>in</span> <span class=n>subpart</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                <span class=n>partial_text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_derive_text</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>subpart</span><span class=p>)</span>
+                <span class=n>statement_text</span> <span class=o>=</span> <span class=n>join_str</span><span class=p>(</span><span class=n>statement_text</span><span class=p>,</span> <span class=n>partial_text</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>statement_text</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.oscal_catalog_to_csv.ContentManager class="doc doc-heading"> <code>ContentManager</code> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Content manager.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ContentManager</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Content manager.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_helper</span><span class=p>:</span> <span class=n>CatalogHelper</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>catalog_helper</span> <span class=o>=</span> <span class=n>catalog_helper</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>row_template</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=k>def</span> <span class=nf>add</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=n>List</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add row.&quot;&quot;&quot;</span>
+        <span class=n>n_row</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>copy</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+        <span class=n>t_row</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>row_template</span>
+        <span class=k>if</span> <span class=n>t_row</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>index</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>3</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>n_row</span><span class=p>[</span><span class=n>index</span><span class=p>]</span> <span class=o>==</span> <span class=n>t_row</span><span class=p>[</span><span class=n>index</span><span class=p>]:</span>
+                    <span class=n>n_row</span><span class=p>[</span><span class=n>index</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>n_row</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>row_template</span> <span class=o>=</span> <span class=n>row</span>
+
+    <span class=k>def</span> <span class=nf>get_content</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get content.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>level</span> <span class=o>==</span> <span class=n>level_control</span><span class=p>:</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_content_by_control</span><span class=p>()</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_content_by_statement</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_get_content_by_statement</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get content by statement.&quot;&quot;&quot;</span>
+        <span class=n>catalog_helper</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_helper</span>
+        <span class=n>header</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;Control Identifier&#39;</span><span class=p>,</span> <span class=s1>&#39;Control Title&#39;</span><span class=p>,</span> <span class=s1>&#39;Statement Identifier&#39;</span><span class=p>,</span> <span class=s1>&#39;Statement Text&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>header</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>catalog_helper</span><span class=o>.</span><span class=n>get_controls</span><span class=p>():</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=n>convert_control_id</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_parts_by_statement</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>statement_text</span> <span class=o>=</span> <span class=n>catalog_helper</span><span class=o>.</span><span class=n>get_statement_text_for_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+                <span class=n>row</span> <span class=o>=</span> <span class=p>[</span><span class=n>control_id</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>title</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>statement_text</span><span class=p>]</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows</span>
+
+    <span class=k>def</span> <span class=nf>_add_subparts_by_statement</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>Part</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add subparts by statement.&quot;&quot;&quot;</span>
+        <span class=n>catalog_helper</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_helper</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>convert_control_id</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;_smt&#39;</span> <span class=ow>in</span> <span class=n>subpart</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                <span class=n>statement_text</span> <span class=o>=</span> <span class=n>catalog_helper</span><span class=o>.</span><span class=n>get_statement_text_for_part</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>subpart</span><span class=p>)</span>
+                <span class=n>row</span> <span class=o>=</span> <span class=p>[</span><span class=n>control_id</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>title</span><span class=p>,</span> <span class=n>convert_smt_id</span><span class=p>(</span><span class=n>subpart</span><span class=o>.</span><span class=n>id</span><span class=p>),</span> <span class=n>statement_text</span><span class=p>]</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_parts_by_statement</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add parts by statement.&quot;&quot;&quot;</span>
+        <span class=n>catalog_helper</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_helper</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>convert_control_id</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                <span class=k>if</span> <span class=s1>&#39;_smt&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_add_subparts_by_statement</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>statement_text</span> <span class=o>=</span> <span class=n>catalog_helper</span><span class=o>.</span><span class=n>get_statement_text_for_part</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part</span><span class=p>)</span>
+                    <span class=n>row</span> <span class=o>=</span> <span class=p>[</span><span class=n>control_id</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>title</span><span class=p>,</span> <span class=n>convert_smt_id</span><span class=p>(</span><span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>),</span> <span class=n>statement_text</span><span class=p>]</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_content_by_control</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get content by statement.&quot;&quot;&quot;</span>
+        <span class=n>catalog_helper</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_helper</span>
+        <span class=n>header</span> <span class=o>=</span> <span class=p>[</span><span class=s1>&#39;Control Identifier&#39;</span><span class=p>,</span> <span class=s1>&#39;Control Title&#39;</span><span class=p>,</span> <span class=s1>&#39;Control Text&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>header</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>catalog_helper</span><span class=o>.</span><span class=n>get_controls</span><span class=p>():</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=n>convert_control_id</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_parts_by_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>control_text</span> <span class=o>=</span> <span class=n>catalog_helper</span><span class=o>.</span><span class=n>get_statement_text_for_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+                <span class=n>row</span> <span class=o>=</span> <span class=p>[</span><span class=n>control_id</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>title</span><span class=p>,</span> <span class=n>control_text</span><span class=p>]</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows</span>
+
+    <span class=k>def</span> <span class=nf>_add_subparts_by_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>,</span> <span class=n>part</span><span class=p>:</span> <span class=n>Part</span><span class=p>,</span> <span class=n>control_text</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add subparts by control.&quot;&quot;&quot;</span>
+        <span class=n>catalog_helper</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_helper</span>
+        <span class=k>for</span> <span class=n>subpart</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;_smt&#39;</span> <span class=ow>in</span> <span class=n>subpart</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                <span class=n>statement_text</span> <span class=o>=</span> <span class=n>catalog_helper</span><span class=o>.</span><span class=n>get_statement_text_for_part</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>subpart</span><span class=p>)</span>
+                <span class=n>control_text</span> <span class=o>=</span> <span class=n>join_str</span><span class=p>(</span><span class=n>control_text</span><span class=p>,</span> <span class=n>statement_text</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>control_text</span>
+
+    <span class=k>def</span> <span class=nf>_add_parts_by_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=n>Control</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add parts by control.&quot;&quot;&quot;</span>
+        <span class=n>catalog_helper</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_helper</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=n>convert_control_id</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>id</span><span class=p>)</span>
+        <span class=n>control_text</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>part</span> <span class=ow>in</span> <span class=n>control</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                <span class=k>if</span> <span class=s1>&#39;_smt&#39;</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>part</span><span class=o>.</span><span class=n>id</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=k>if</span> <span class=n>part</span><span class=o>.</span><span class=n>parts</span><span class=p>:</span>
+                    <span class=n>control_text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_add_subparts_by_control</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part</span><span class=p>,</span> <span class=n>control_text</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>statement_text</span> <span class=o>=</span> <span class=n>catalog_helper</span><span class=o>.</span><span class=n>get_statement_text_for_part</span><span class=p>(</span><span class=n>control</span><span class=p>,</span> <span class=n>part</span><span class=p>)</span>
+                    <span class=n>control_text</span> <span class=o>=</span> <span class=n>join_str</span><span class=p>(</span><span class=n>control_text</span><span class=p>,</span> <span class=n>statement_text</span><span class=p>)</span>
+        <span class=n>row</span> <span class=o>=</span> <span class=p>[</span><span class=n>control_id</span><span class=p>,</span> <span class=n>control</span><span class=o>.</span><span class=n>title</span><span class=p>,</span> <span class=n>control_text</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>add</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.oscal_catalog_to_csv.ContentManager-attributes>Attributes<a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.oscal_catalog_to_csv.ContentManager.catalog_helper class="doc doc-heading"> <code class="highlight language-python"><span class=n>catalog_helper</span> <span class=o>=</span> <span class=n>catalog_helper</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.catalog_helper class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.oscal_catalog_to_csv.ContentManager.row_template class="doc doc-heading"> <code class="highlight language-python"><span class=n>row_template</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.row_template class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.oscal_catalog_to_csv.ContentManager.rows class="doc doc-heading"> <code class="highlight language-python"><span class=n>rows</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.rows class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.oscal_catalog_to_csv.ContentManager-functions>Functions<a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.ContentManager.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>catalog_helper</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>catalog_helper</span><span class=p>:</span> <span class=n>CatalogHelper</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>catalog_helper</span> <span class=o>=</span> <span class=n>catalog_helper</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>row_template</span> <span class=o>=</span> <span class=kc>None</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.ContentManager.add class="doc doc-heading"> <code class="highlight language-python"><span class=n>add</span><span class=p>(</span><span class=n>row</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.add class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Add row.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>add</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=n>List</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Add row.&quot;&quot;&quot;</span>
+    <span class=n>n_row</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>copy</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+    <span class=n>t_row</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>row_template</span>
+    <span class=k>if</span> <span class=n>t_row</span><span class=p>:</span>
+        <span class=k>for</span> <span class=n>index</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>3</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>n_row</span><span class=p>[</span><span class=n>index</span><span class=p>]</span> <span class=o>==</span> <span class=n>t_row</span><span class=p>[</span><span class=n>index</span><span class=p>]:</span>
+                <span class=n>n_row</span><span class=p>[</span><span class=n>index</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>n_row</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>row_template</span> <span class=o>=</span> <span class=n>row</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.ContentManager.get_content class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_content</span><span class=p>(</span><span class=n>level</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.ContentManager.get_content class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get content.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_content</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>level</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get content.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>level</span> <span class=o>==</span> <span class=n>level_control</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_content_by_control</span><span class=p>()</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_content_by_statement</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.oscal_catalog_to_csv.CsvHelper class="doc doc-heading"> <code>CsvHelper</code> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Csv Helper.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>CsvHelper</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Csv Helper.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>path</span> <span class=o>=</span> <span class=n>path</span>
+
+    <span class=k>def</span> <span class=nf>write</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rows</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write csv file.&quot;&quot;&quot;</span>
+        <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>path</span><span class=p>,</span> <span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>newline</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=s1>&#39;utf-8&#39;</span><span class=p>)</span> <span class=k>as</span> <span class=n>output</span><span class=p>:</span>
+            <span class=n>csv_writer</span> <span class=o>=</span> <span class=n>csv</span><span class=o>.</span><span class=n>writer</span><span class=p>(</span><span class=n>output</span><span class=p>,</span> <span class=n>delimiter</span><span class=o>=</span><span class=s1>&#39;,&#39;</span><span class=p>,</span> <span class=n>quotechar</span><span class=o>=</span><span class=s1>&#39;&quot;&#39;</span><span class=p>,</span> <span class=n>quoting</span><span class=o>=</span><span class=n>csv</span><span class=o>.</span><span class=n>QUOTE_MINIMAL</span><span class=p>)</span>
+            <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=n>rows</span><span class=p>:</span>
+                <span class=n>csv_writer</span><span class=o>.</span><span class=n>writerow</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.oscal_catalog_to_csv.CsvHelper-attributes>Attributes<a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CsvHelper.path class="doc doc-heading"> <code class="highlight language-python"><span class=n>path</span> <span class=o>=</span> <span class=n>path</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper.path class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.oscal_catalog_to_csv.CsvHelper-functions>Functions<a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CsvHelper.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>path</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>path</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>path</span> <span class=o>=</span> <span class=n>path</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.CsvHelper.write class="doc doc-heading"> <code class="highlight language-python"><span class=n>write</span><span class=p>(</span><span class=n>rows</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.CsvHelper.write class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Write csv file.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span>
+<span class=normal>96</span>
+<span class=normal>97</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>write</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rows</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Write csv file.&quot;&quot;&quot;</span>
+    <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>path</span><span class=p>,</span> <span class=s1>&#39;w&#39;</span><span class=p>,</span> <span class=n>newline</span><span class=o>=</span><span class=s1>&#39;&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=s1>&#39;utf-8&#39;</span><span class=p>)</span> <span class=k>as</span> <span class=n>output</span><span class=p>:</span>
+        <span class=n>csv_writer</span> <span class=o>=</span> <span class=n>csv</span><span class=o>.</span><span class=n>writer</span><span class=p>(</span><span class=n>output</span><span class=p>,</span> <span class=n>delimiter</span><span class=o>=</span><span class=s1>&#39;,&#39;</span><span class=p>,</span> <span class=n>quotechar</span><span class=o>=</span><span class=s1>&#39;&quot;&#39;</span><span class=p>,</span> <span class=n>quoting</span><span class=o>=</span><span class=n>csv</span><span class=o>.</span><span class=n>QUOTE_MINIMAL</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=n>rows</span><span class=p>:</span>
+            <span class=n>csv_writer</span><span class=o>.</span><span class=n>writerow</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv class="doc doc-heading"> <code>OscalCatalogToCsv</code> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to transform OSCAL catalog to .csv.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.name href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OscalCatalogToCsv</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to transform OSCAL catalog to .csv.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;oscal-catalog-to-csv&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Purpose: Create .csv from OSCAL catalog.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.oscal-catalog-to-csv]:&#39;</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  input-file             = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) path of file to read the catalog.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir             = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) path of directory to write the generated .csv file.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-name            = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) name of the generated .csv file [default is name of input file with .csv suffix].&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite       = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  level                  = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;(optional) one of: </span><span class=si>{</span><span class=n>level_control</span><span class=si>}</span><span class=s1> or </span><span class=si>{</span><span class=n>level_statement</span><span class=si>}</span><span class=s1> [default].&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Wrap the execute for exception handling.&quot;&quot;&quot;</span>
+        <span class=c1># config processing</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># input</span>
+        <span class=n>ifile</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;input-file&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>ifile</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;input-file missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=n>ipth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ifile</span><span class=p>)</span>
+        <span class=c1># overwrite</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=c1># output</span>
+        <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;output-dir&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>odir</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;output-dir missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=n>iname</span> <span class=o>=</span> <span class=n>ipth</span><span class=o>.</span><span class=n>name</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>oname</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;output-name&#39;</span><span class=p>,</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>iname</span><span class=si>}</span><span class=s1>.csv&#39;</span><span class=p>)</span>
+        <span class=n>opth</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=ow>and</span> <span class=n>opth</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>opth</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=n>csv_helper</span> <span class=o>=</span> <span class=n>CsvHelper</span><span class=p>(</span><span class=n>opth</span><span class=p>)</span>
+        <span class=c1># level</span>
+        <span class=n>level</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;level&#39;</span><span class=p>,</span> <span class=n>level_default</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>level</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>level_list</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;level: </span><span class=si>{</span><span class=n>level</span><span class=si>}</span><span class=s1> unknown&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># helper</span>
+        <span class=n>catalog_helper</span> <span class=o>=</span> <span class=n>CatalogHelper</span><span class=p>(</span><span class=n>ipth</span><span class=p>)</span>
+        <span class=c1># process</span>
+        <span class=n>content_manager</span> <span class=o>=</span> <span class=n>ContentManager</span><span class=p>(</span><span class=n>catalog_helper</span><span class=p>)</span>
+        <span class=n>rows</span> <span class=o>=</span> <span class=n>content_manager</span><span class=o>.</span><span class=n>get_content</span><span class=p>(</span><span class=n>level</span><span class=p>)</span>
+        <span class=c1># write</span>
+        <span class=n>csv_helper</span><span class=o>.</span><span class=n>write</span><span class=p>(</span><span class=n>rows</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output-file: </span><span class=si>{</span><span class=n>opth</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># success</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-attributes>Attributes<a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;oscal-catalog-to-csv&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-functions>Functions<a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an actual outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Purpose: Create .csv from OSCAL catalog.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.oscal-catalog-to-csv]:&#39;</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  input-file             = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) path of file to read the catalog.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir             = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) path of directory to write the generated .csv file.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-name            = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) name of the generated .csv file [default is name of input file with .csv suffix].&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite       = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  level                  = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;(optional) one of: </span><span class=si>{</span><span class=n>level_control</span><span class=si>}</span><span class=s1> or </span><span class=si>{</span><span class=n>level_statement</span><span class=si>}</span><span class=s1> [default].&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.tasks.oscal_catalog_to_csv-functions>Functions<a href=#trestle.tasks.oscal_catalog_to_csv-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.oscal_catalog_to_csv.convert_control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>convert_control_id</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.convert_control_id class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert control id.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>convert_control_id</span><span class=p>(</span><span class=n>control_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert control id.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=n>copy</span><span class=o>.</span><span class=n>copy</span><span class=p>(</span><span class=n>control_id</span><span class=p>)</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=n>rval</span><span class=o>.</span><span class=n>upper</span><span class=p>()</span>
+    <span class=k>if</span> <span class=s1>&#39;.&#39;</span> <span class=ow>in</span> <span class=n>rval</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>rval</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>,</span> <span class=s1>&#39;(&#39;</span><span class=p>)</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>rval</span> <span class=o>+</span> <span class=s1>&#39;)&#39;</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.oscal_catalog_to_csv.convert_smt_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>convert_smt_id</span><span class=p>(</span><span class=n>smt_id</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.convert_smt_id class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Convert smt id.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>convert_smt_id</span><span class=p>(</span><span class=n>smt_id</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Convert smt id.&quot;&quot;&quot;</span>
+    <span class=n>parts</span> <span class=o>=</span> <span class=n>smt_id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;_smt&#39;</span><span class=p>)</span>
+    <span class=n>seg1</span> <span class=o>=</span> <span class=n>convert_control_id</span><span class=p>(</span><span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+    <span class=n>seg2</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>2</span><span class=p>:</span>
+        <span class=n>seg2</span> <span class=o>=</span> <span class=n>parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+        <span class=k>if</span> <span class=s1>&#39;.&#39;</span> <span class=ow>in</span> <span class=n>seg2</span><span class=p>:</span>
+            <span class=n>seg2</span> <span class=o>=</span> <span class=n>seg2</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>,</span> <span class=s1>&#39;(&#39;</span><span class=p>)</span>
+            <span class=n>seg2</span> <span class=o>=</span> <span class=n>seg2</span> <span class=o>+</span> <span class=s1>&#39;)&#39;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>seg1</span><span class=si>}{</span><span class=n>seg2</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.oscal_catalog_to_csv.join_str class="doc doc-heading"> <code class="highlight language-python"><span class=n>join_str</span><span class=p>(</span><span class=n>s1</span><span class=p>,</span> <span class=n>s2</span><span class=p>,</span> <span class=n>sep</span><span class=o>=</span><span class=s1>&#39; &#39;</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_catalog_to_csv.join_str class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Join strings.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>join_str</span><span class=p>(</span><span class=n>s1</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>s2</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>],</span> <span class=n>sep</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=s1>&#39; &#39;</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Join strings.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>s1</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>s2</span>
+    <span class=k>elif</span> <span class=n>s2</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>s1</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>s1</span><span class=si>}{</span><span class=n>sep</span><span class=si>}{</span><span class=n>s2</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/oscal_profile_to_osco_profile/index.html b/latest/reference/API/trestle/tasks/oscal_profile_to_osco_profile/index.html
new file mode 100644
index 000000000..0e98bf4c1
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/oscal_profile_to_osco_profile/index.html
@@ -0,0 +1,304 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.oscal_profile_to_osco_profile module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/oscal_profile_to_osco_profile/ rel=canonical><link href=../oscal_catalog_to_csv/ rel=prev><link href=../osco_result_to_oscal_ar/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.oscal_profile_to_osco_profile - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.oscal_profile_to_osco_profile - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.oscal_profile_to_osco_profile module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/oscal_profile_to_osco_profile.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/oscal_profile_to_osco_profile/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.oscal_profile_to_osco_profile - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.oscal_profile_to_osco_profile module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/oscal_profile_to_osco_profile.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.oscal_profile_to_osco_profile class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile class=md-nav__link> <span class=md-ellipsis> oscal_profile_to_osco_profile </span> </a> <nav class=md-nav aria-label=oscal_profile_to_osco_profile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco class=md-nav__link> <span class=md-ellipsis> ProfileToOsco </span> </a> <nav class=md-nav aria-label=ProfileToOsco> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile class=md-nav__link> <span class=md-ellipsis> oscal_profile_to_osco_profile </span> </a> <nav class=md-nav aria-label=oscal_profile_to_osco_profile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco class=md-nav__link> <span class=md-ellipsis> ProfileToOsco </span> </a> <nav class=md-nav aria-label=ProfileToOsco> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.oscal_profile_to_osco_profile</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.oscal_profile_to_osco_profile class="doc doc-heading"> <code>trestle.tasks.oscal_profile_to_osco_profile</code> <a href=#trestle.tasks.oscal_profile_to_osco_profile class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.oscal_profile_to_osco_profile-attributes>Attributes<a href=#trestle.tasks.oscal_profile_to_osco_profile-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.oscal_profile_to_osco_profile.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.oscal_profile_to_osco_profile.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.oscal_profile_to_osco_profile-classes>Classes<a href=#trestle.tasks.oscal_profile_to_osco_profile-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco class="doc doc-heading"> <code>ProfileToOsco</code> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to convert Profile to OSC yaml.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.name href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ProfileToOsco</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to convert Profile to OSC yaml.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;oscal-profile-to-osco-profile&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task oscal-profile-to-osco-profile.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;Purpose: Transform Open Security Controls Assessment Language (OSCAL) Profile &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39;into Open Shift Compliance Operator (OSCO) .yaml file.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.oscal-profile-to-osco-profile]:&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  input-file = (required) path of the input file comprising OSCAL profile.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  output-dir = (required) path of the output directory comprising synthesized .yaml file.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  output-name = (optional) name of created file in output directory, default is osco-profile.yaml.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  output-overwrite = (optional) true [default] or false; replace existing output when true.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  quiet = (optional) true or false [default]; display file creations and rules analysis when false.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Operation: The specified input profile is transformed into OSCO .yaml.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Notes:&#39;</span><span class=p>)</span>
+        <span class=n>note11</span> <span class=o>=</span> <span class=s1>&#39;[1] The input-file OSCAL profile should specify a metadata property with&#39;</span>
+        <span class=n>note12</span> <span class=o>=</span> <span class=s1>&#39;name &quot;osco_version&quot; and value of the form &quot;0.1.46&quot;.&#39;</span>
+        <span class=n>note13</span> <span class=o>=</span> <span class=s1>&#39;The value corresponds with the OpenShift Compliance Operator (OSCO) version&#39;</span>
+        <span class=n>note14</span> <span class=o>=</span> <span class=s1>&#39;and affects the format of the emitted yaml.&#39;</span>
+        <span class=n>note15</span> <span class=o>=</span> <span class=s1>&#39;If not specified, the default is &quot;0.1.46&quot;.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>note11</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>note12</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>note13</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>note14</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>note15</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>note21</span> <span class=o>=</span> <span class=s1>&#39;[2] For OSCO version &quot;0.1.39&quot; and prior no &quot;description&quot; is emitted for &quot;spec&quot;.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>note21</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Perform transformation.&quot;&quot;&quot;</span>
+        <span class=c1># check config</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># input-file</span>
+        <span class=n>input_file</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;input-file&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>input_file</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;input-file&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input-file: </span><span class=si>{</span><span class=n>input_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>input_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>input_file</span><span class=p>)</span>
+        <span class=c1># output-dir</span>
+        <span class=n>output_dir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;output-dir&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>output_dir</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;output-dir&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=n>output_path</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>output_dir</span><span class=p>)</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>output_path</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># output file path</span>
+        <span class=n>output_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;output-name&#39;</span><span class=p>,</span> <span class=s1>&#39;osco-profile.yaml&#39;</span><span class=p>)</span>
+        <span class=n>output_filepath</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>output_dir</span><span class=p>,</span> <span class=n>output_name</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output-file: </span><span class=si>{</span><span class=n>output_filepath</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># overwrite</span>
+        <span class=n>overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>output_filepath</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output-file: </span><span class=si>{</span><span class=n>output_filepath</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># read input</span>
+        <span class=n>profile</span> <span class=o>=</span> <span class=n>Profile</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>input_path</span><span class=p>)</span>
+        <span class=c1># transform</span>
+        <span class=n>transformer</span> <span class=o>=</span> <span class=n>OscalProfileToOscoProfileTransformer</span><span class=p>()</span>
+        <span class=n>ydata</span> <span class=o>=</span> <span class=n>json</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>transformer</span><span class=o>.</span><span class=n>transform</span><span class=p>(</span><span class=n>profile</span><span class=p>))</span>
+        <span class=c1># write output</span>
+        <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+        <span class=n>yaml</span><span class=o>.</span><span class=n>default_flow_style</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=n>output_filepath</span><span class=p>,</span> <span class=s1>&#39;w&#39;</span><span class=p>)</span> <span class=k>as</span> <span class=n>outfile</span><span class=p>:</span>
+            <span class=n>yaml</span><span class=o>.</span><span class=n>dump</span><span class=p>(</span><span class=n>ydata</span><span class=p>,</span> <span class=n>outfile</span><span class=p>)</span>
+        <span class=c1># success</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-attributes>Attributes<a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;oscal-profile-to-osco-profile&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-functions>Functions<a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task oscal-profile-to-osco-profile.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task oscal-profile-to-osco-profile.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an actual outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;Purpose: Transform Open Security Controls Assessment Language (OSCAL) Profile &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39;into Open Shift Compliance Operator (OSCO) .yaml file.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.oscal-profile-to-osco-profile]:&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  input-file = (required) path of the input file comprising OSCAL profile.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  output-dir = (required) path of the output directory comprising synthesized .yaml file.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  output-name = (optional) name of created file in output directory, default is osco-profile.yaml.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  output-overwrite = (optional) true [default] or false; replace existing output when true.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  quiet = (optional) true or false [default]; display file creations and rules analysis when false.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Operation: The specified input profile is transformed into OSCO .yaml.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Notes:&#39;</span><span class=p>)</span>
+    <span class=n>note11</span> <span class=o>=</span> <span class=s1>&#39;[1] The input-file OSCAL profile should specify a metadata property with&#39;</span>
+    <span class=n>note12</span> <span class=o>=</span> <span class=s1>&#39;name &quot;osco_version&quot; and value of the form &quot;0.1.46&quot;.&#39;</span>
+    <span class=n>note13</span> <span class=o>=</span> <span class=s1>&#39;The value corresponds with the OpenShift Compliance Operator (OSCO) version&#39;</span>
+    <span class=n>note14</span> <span class=o>=</span> <span class=s1>&#39;and affects the format of the emitted yaml.&#39;</span>
+    <span class=n>note15</span> <span class=o>=</span> <span class=s1>&#39;If not specified, the default is &quot;0.1.46&quot;.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>note11</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>note12</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>note13</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>note14</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>note15</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>note21</span> <span class=o>=</span> <span class=s1>&#39;[2] For OSCO version &quot;0.1.39&quot; and prior no &quot;description&quot; is emitted for &quot;spec&quot;.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>note21</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/osco_result_to_oscal_ar/index.html b/latest/reference/API/trestle/tasks/osco_result_to_oscal_ar/index.html
new file mode 100644
index 000000000..8033787ed
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/osco_result_to_oscal_ar/index.html
@@ -0,0 +1,388 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.osco_result_to_oscal_ar module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/osco_result_to_oscal_ar/ rel=canonical><link href=../oscal_profile_to_osco_profile/ rel=prev><link href=../tanium_result_to_oscal_ar/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.osco_result_to_oscal_ar - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.osco_result_to_oscal_ar - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.osco_result_to_oscal_ar module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/osco_result_to_oscal_ar.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/osco_result_to_oscal_ar/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.osco_result_to_oscal_ar - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.osco_result_to_oscal_ar module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/osco_result_to_oscal_ar.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.osco_result_to_oscal_ar class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar class=md-nav__link> <span class=md-ellipsis> osco_result_to_oscal_ar </span> </a> <nav class=md-nav aria-label=osco_result_to_oscal_ar> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR class=md-nav__link> <span class=md-ellipsis> OscoResultToOscalAR </span> </a> <nav class=md-nav aria-label=OscoResultToOscalAR> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar class=md-nav__link> <span class=md-ellipsis> osco_result_to_oscal_ar </span> </a> <nav class=md-nav aria-label=osco_result_to_oscal_ar> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR class=md-nav__link> <span class=md-ellipsis> OscoResultToOscalAR </span> </a> <nav class=md-nav aria-label=OscoResultToOscalAR> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.osco_result_to_oscal_ar</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.osco_result_to_oscal_ar class="doc doc-heading"> <code>trestle.tasks.osco_result_to_oscal_ar</code> <a href=#trestle.tasks.osco_result_to_oscal_ar class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.osco_result_to_oscal_ar-attributes>Attributes<a href=#trestle.tasks.osco_result_to_oscal_ar-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.osco_result_to_oscal_ar.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.osco_result_to_oscal_ar.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.osco_result_to_oscal_ar-classes>Classes<a href=#trestle.tasks.osco_result_to_oscal_ar-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR class="doc doc-heading"> <code>OscoResultToOscalAR</code> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to convert Osco result to OSCAL json.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.name href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OscoResultToOscalAR</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to convert Osco result to OSCAL json.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;osco-result-to-oscal-ar&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task osco-result-to-oscal-ar.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;Purpose: Transform Osco files into Open Security Controls Assessment Language (OSCAL) &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39;partial results files.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.osco-result-to-oscal-ar]:&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  checking  = (optional) True indicates perform strict checking of OSCAL properties, default is False.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  input-dir = (required) the path of the input directory comprising Osco results.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  output-dir = (required) the path of the output directory comprising synthesized OSCAL .json files.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  output-overwrite = (optional) true [default] or false; replace existing output when true.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  quiet = (optional) true or false [default]; display file creations and rules analysis when false.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  timestamp = (optional) timestamp for the Observations in ISO 8601 format, such as &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39; 2021-01-04T00:05:23+04:00 for example; if not specified then value for &quot;Timestamp&quot; key in the Osco &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39; result is used if present, otherwise current time is used.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;Operation: A transformation is performed on one or more Osco input files to produce output in OSCAL &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39;partial results format.&#39;</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_transform</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Perform transformation.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform_work</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span><span class=p>:</span>
+                <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;simulated-&#39;</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_transform_work</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Perform transformation work steps.</span>
+
+<span class=sd>        Work steps: read input, process, write output, display analysis</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span><span class=p>:</span>
+            <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;simulated-&#39;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config required input &amp; output dirs</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>idir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;input-dir&#39;</span><span class=p>]</span>
+            <span class=n>ipth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>idir</span><span class=p>)</span>
+            <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;output-dir&#39;</span><span class=p>]</span>
+            <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=o>.</span><span class=n>args</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1> missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config optional overwrite &amp; quiet</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>quiet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>quiet</span>
+        <span class=c1># config optional timestamp</span>
+        <span class=n>timestamp</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;timestamp&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>timestamp</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>OscoTransformer</span><span class=o>.</span><span class=n>set_timestamp</span><span class=p>(</span><span class=n>timestamp</span><span class=p>)</span>
+            <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config invalid &quot;timestamp&quot;&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config optional performance</span>
+        <span class=n>modes</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=s1>&#39;checking&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;checking&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>),</span>
+        <span class=p>}</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># process</span>
+        <span class=k>for</span> <span class=n>ifile</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>ipth</span><span class=o>.</span><span class=n>iterdir</span><span class=p>()):</span>
+            <span class=k>if</span> <span class=n>ifile</span><span class=o>.</span><span class=n>suffix</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;.json&#39;</span><span class=p>,</span> <span class=s1>&#39;.jsn&#39;</span><span class=p>,</span> <span class=s1>&#39;.yaml&#39;</span><span class=p>,</span> <span class=s1>&#39;.yml&#39;</span><span class=p>,</span> <span class=s1>&#39;.xml&#39;</span><span class=p>]:</span>
+                <span class=k>continue</span>
+            <span class=n>blob</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_file</span><span class=p>(</span><span class=n>ifile</span><span class=p>)</span>
+            <span class=n>osco_transformer</span> <span class=o>=</span> <span class=n>OscoTransformer</span><span class=p>()</span>
+            <span class=n>osco_transformer</span><span class=o>.</span><span class=n>set_modes</span><span class=p>(</span><span class=n>modes</span><span class=p>)</span>
+            <span class=n>results</span> <span class=o>=</span> <span class=n>osco_transformer</span><span class=o>.</span><span class=n>transform</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+            <span class=n>oname</span> <span class=o>=</span> <span class=n>ifile</span><span class=o>.</span><span class=n>stem</span> <span class=o>+</span> <span class=s1>&#39;.oscal&#39;</span> <span class=o>+</span> <span class=s1>&#39;.json&#39;</span>
+            <span class=n>ofile</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_write_file</span><span class=p>(</span><span class=n>results</span><span class=p>,</span> <span class=n>ofile</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_show_analysis</span><span class=p>(</span><span class=n>osco_transformer</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_read_file</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ifile</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read raw input file.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input: </span><span class=si>{</span><span class=n>ifile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=n>ifile</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>fp</span><span class=p>:</span>
+            <span class=n>blob</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>read</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>blob</span>
+
+    <span class=k>def</span> <span class=nf>_write_file</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>result</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>ofile</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write oscal results file.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>result</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>))</span>
+
+    <span class=k>def</span> <span class=nf>_show_analysis</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>osco_transformer</span><span class=p>:</span> <span class=n>OscoTransformer</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Show analysis.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>analysis</span> <span class=o>=</span> <span class=n>osco_transformer</span><span class=o>.</span><span class=n>analysis</span>
+            <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>analysis</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-attributes>Attributes<a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;osco-result-to-oscal-ar&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-functions>Functions<a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task osco-result-to-oscal-ar.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task osco-result-to-oscal-ar.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an actual outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;Purpose: Transform Osco files into Open Security Controls Assessment Language (OSCAL) &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39;partial results files.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.osco-result-to-oscal-ar]:&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  checking  = (optional) True indicates perform strict checking of OSCAL properties, default is False.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  input-dir = (required) the path of the input directory comprising Osco results.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  output-dir = (required) the path of the output directory comprising synthesized OSCAL .json files.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  output-overwrite = (optional) true [default] or false; replace existing output when true.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  quiet = (optional) true or false [default]; display file creations and rules analysis when false.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  timestamp = (optional) timestamp for the Observations in ISO 8601 format, such as &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39; 2021-01-04T00:05:23+04:00 for example; if not specified then value for &quot;Timestamp&quot; key in the Osco &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39; result is used if present, otherwise current time is used.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;Operation: A transformation is performed on one or more Osco input files to produce output in OSCAL &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39;partial results format.&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/tanium_result_to_oscal_ar/index.html b/latest/reference/API/trestle/tasks/tanium_result_to_oscal_ar/index.html
new file mode 100644
index 000000000..a1158ca88
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/tanium_result_to_oscal_ar/index.html
@@ -0,0 +1,414 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.tanium_result_to_oscal_ar module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/tanium_result_to_oscal_ar/ rel=canonical><link href=../osco_result_to_oscal_ar/ rel=prev><link href=../transform/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.tanium_result_to_oscal_ar - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.tanium_result_to_oscal_ar - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.tanium_result_to_oscal_ar module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/tanium_result_to_oscal_ar.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/tanium_result_to_oscal_ar/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.tanium_result_to_oscal_ar - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.tanium_result_to_oscal_ar module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/tanium_result_to_oscal_ar.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.tanium_result_to_oscal_ar class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar class=md-nav__link> <span class=md-ellipsis> tanium_result_to_oscal_ar </span> </a> <nav class=md-nav aria-label=tanium_result_to_oscal_ar> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR class=md-nav__link> <span class=md-ellipsis> TaniumResultToOscalAR </span> </a> <nav class=md-nav aria-label=TaniumResultToOscalAR> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar class=md-nav__link> <span class=md-ellipsis> tanium_result_to_oscal_ar </span> </a> <nav class=md-nav aria-label=tanium_result_to_oscal_ar> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR class=md-nav__link> <span class=md-ellipsis> TaniumResultToOscalAR </span> </a> <nav class=md-nav aria-label=TaniumResultToOscalAR> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.tanium_result_to_oscal_ar</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.tanium_result_to_oscal_ar class="doc doc-heading"> <code>trestle.tasks.tanium_result_to_oscal_ar</code> <a href=#trestle.tasks.tanium_result_to_oscal_ar class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.tanium_result_to_oscal_ar-attributes>Attributes<a href=#trestle.tasks.tanium_result_to_oscal_ar-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.tanium_result_to_oscal_ar.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.tanium_result_to_oscal_ar.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.tanium_result_to_oscal_ar-classes>Classes<a href=#trestle.tasks.tanium_result_to_oscal_ar-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR class="doc doc-heading"> <code>TaniumResultToOscalAR</code> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to convert Tanium result to OSCAL json.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.name href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 31</span>
+<span class=normal> 32</span>
+<span class=normal> 33</span>
+<span class=normal> 34</span>
+<span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TaniumResultToOscalAR</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to convert Tanium result to OSCAL json.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;tanium-result-to-oscal-ar&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task tanium-result-to-oscal-ar.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;Purpose: Transform Tanium files into Open Security Controls Assessment Language (OSCAL) results objects&#39;</span>
+            <span class=o>+</span> <span class=s1>&#39;and serialize to a file.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.tanium-result-to-oscal-ar]:&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  blocksize = (optional) the desired number Tanuim result input lines to process per CPU.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  cpus-max  = (optional) the desired maximum number of CPUs to employ, default is 1.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  cpus-min  = (optional) the desired minimum number of CPUs to employ.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  aggregate = (optional) True indicates employ properties aggregation, default is True.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  caching   = (optional) True indicates employ object caching, default is True.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  checking  = (optional) True indicates perform strict checking of OSCAL properties, default is False.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  input-dir = (required) the path of the input directory comprising Tanium results.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  output-dir = (required) the path of the output directory comprising synthesized OSCAL .json files.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  output-overwrite = (optional) true [default] or false; replace existing output when true.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  quiet = (optional) true or false [default]; display file creations and rules analysis when false.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;  timestamp = (optional) timestamp for the Observations in ISO 8601 format, such as &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39;2021-01-04T00:05:23+04:00 for example; if not specified then value for &quot;Timestamp&quot; key in the Tanium &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39;result is used if present, otherwise current time is used.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;Operation: A transformation is performed on one or more Tanium input files to produce output in &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39;OSCAL partial results format.&#39;</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_transform</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Perform transformation.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform_work</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span><span class=p>:</span>
+                <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;simulated-&#39;</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_transform_work</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Perform the transformation work.</span>
+
+<span class=sd>        Transformation work steps: read input, process, write output, display analysis.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span><span class=p>:</span>
+            <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;simulated-&#39;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;Config missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config required input &amp; output dirs</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>idir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;input-dir&#39;</span><span class=p>]</span>
+            <span class=n>ipth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>idir</span><span class=p>)</span>
+            <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;output-dir&#39;</span><span class=p>]</span>
+            <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=o>.</span><span class=n>args</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1> missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config optional overwrite &amp; quiet</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>quiet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>quiet</span>
+        <span class=c1># config optional timestamp</span>
+        <span class=n>timestamp</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;timestamp&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>timestamp</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>TaniumTransformer</span><span class=o>.</span><span class=n>set_timestamp</span><span class=p>(</span><span class=n>timestamp</span><span class=p>)</span>
+            <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config invalid &quot;timestamp&quot;&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config optional performance</span>
+        <span class=n>modes</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=s1>&#39;blocksize&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getint</span><span class=p>(</span><span class=s1>&#39;blocksize&#39;</span><span class=p>,</span> <span class=mi>10000</span><span class=p>),</span>
+            <span class=s1>&#39;cpus_max&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getint</span><span class=p>(</span><span class=s1>&#39;cpus-max&#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>),</span>
+            <span class=s1>&#39;cpus_min&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getint</span><span class=p>(</span><span class=s1>&#39;cpus-min&#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>),</span>
+            <span class=s1>&#39;aggregate&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;aggregate&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>),</span>
+            <span class=s1>&#39;caching&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;caching&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>),</span>
+            <span class=s1>&#39;checking&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;checking&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>),</span>
+        <span class=p>}</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># process</span>
+        <span class=k>for</span> <span class=n>ifile</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>ipth</span><span class=o>.</span><span class=n>iterdir</span><span class=p>()):</span>
+            <span class=n>blob</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_file</span><span class=p>(</span><span class=n>ifile</span><span class=p>)</span>
+            <span class=n>tanium_transformer</span> <span class=o>=</span> <span class=n>TaniumTransformer</span><span class=p>()</span>
+            <span class=n>tanium_transformer</span><span class=o>.</span><span class=n>set_modes</span><span class=p>(</span><span class=n>modes</span><span class=p>)</span>
+            <span class=n>results</span> <span class=o>=</span> <span class=n>tanium_transformer</span><span class=o>.</span><span class=n>transform</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+            <span class=n>oname</span> <span class=o>=</span> <span class=n>ifile</span><span class=o>.</span><span class=n>stem</span> <span class=o>+</span> <span class=s1>&#39;.oscal&#39;</span> <span class=o>+</span> <span class=s1>&#39;.json&#39;</span>
+            <span class=n>ofile</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_write_file</span><span class=p>(</span><span class=n>results</span><span class=p>,</span> <span class=n>ofile</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_show_analysis</span><span class=p>(</span><span class=n>tanium_transformer</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_read_file</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ifile</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read raw input file.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input: </span><span class=si>{</span><span class=n>ifile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=n>ifile</span><span class=p>,</span> <span class=s1>&#39;r&#39;</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>fp</span><span class=p>:</span>
+            <span class=n>blob</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>read</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>blob</span>
+
+    <span class=k>def</span> <span class=nf>_write_file</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>result</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>ofile</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write oscal results file.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>result</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>))</span>
+
+    <span class=k>def</span> <span class=nf>_show_analysis</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>tanium_transformer</span><span class=p>:</span> <span class=n>TaniumTransformer</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Show analysis.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>analysis</span> <span class=o>=</span> <span class=n>tanium_transformer</span><span class=o>.</span><span class=n>analysis</span>
+            <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>analysis</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-attributes>Attributes<a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;tanium-result-to-oscal-ar&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-functions>Functions<a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task tanium-result-to-oscal-ar.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task tanium-result-to-oscal-ar.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an actual outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>92</span>
+<span class=normal>93</span>
+<span class=normal>94</span>
+<span class=normal>95</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;Purpose: Transform Tanium files into Open Security Controls Assessment Language (OSCAL) results objects&#39;</span>
+        <span class=o>+</span> <span class=s1>&#39;and serialize to a file.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.tanium-result-to-oscal-ar]:&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  blocksize = (optional) the desired number Tanuim result input lines to process per CPU.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  cpus-max  = (optional) the desired maximum number of CPUs to employ, default is 1.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  cpus-min  = (optional) the desired minimum number of CPUs to employ.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  aggregate = (optional) True indicates employ properties aggregation, default is True.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  caching   = (optional) True indicates employ object caching, default is True.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  checking  = (optional) True indicates perform strict checking of OSCAL properties, default is False.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  input-dir = (required) the path of the input directory comprising Tanium results.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  output-dir = (required) the path of the output directory comprising synthesized OSCAL .json files.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;  output-overwrite = (optional) true [default] or false; replace existing output when true.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  quiet = (optional) true or false [default]; display file creations and rules analysis when false.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;  timestamp = (optional) timestamp for the Observations in ISO 8601 format, such as &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39;2021-01-04T00:05:23+04:00 for example; if not specified then value for &quot;Timestamp&quot; key in the Tanium &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39;result is used if present, otherwise current time is used.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;Operation: A transformation is performed on one or more Tanium input files to produce output in &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39;OSCAL partial results format.&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/transform/index.html b/latest/reference/API/trestle/tasks/transform/index.html
new file mode 100644
index 000000000..4f66fea7e
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/transform/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.transform module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/transform/ rel=canonical><link href=../tanium_result_to_oscal_ar/ rel=prev><link href=../xccdf_result_to_oscal_ar/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.transform - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.transform - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.transform module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/transform.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/transform/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.transform - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.transform module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/transform.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.transform class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.transform </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.transform </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.transform </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.transform</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.transform class="doc doc-heading"> <code>trestle.tasks.transform</code> <a href=#trestle.tasks.transform class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/xccdf_result_to_oscal_ar/index.html b/latest/reference/API/trestle/tasks/xccdf_result_to_oscal_ar/index.html
new file mode 100644
index 000000000..10889bf05
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/xccdf_result_to_oscal_ar/index.html
@@ -0,0 +1,520 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.xccdf_result_to_oscal_ar module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ rel=canonical><link href=../transform/ rel=prev><link href=../xlsx_helper/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.xccdf_result_to_oscal_ar - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.xccdf_result_to_oscal_ar - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.xccdf_result_to_oscal_ar module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/xccdf_result_to_oscal_ar.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.xccdf_result_to_oscal_ar - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.xccdf_result_to_oscal_ar module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/xccdf_result_to_oscal_ar.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.xccdf_result_to_oscal_ar class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar class=md-nav__link> <span class=md-ellipsis> xccdf_result_to_oscal_ar </span> </a> <nav class=md-nav aria-label=xccdf_result_to_oscal_ar> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.default_description class=md-nav__link> <span class=md-ellipsis> default_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.default_title class=md-nav__link> <span class=md-ellipsis> default_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.default_type class=md-nav__link> <span class=md-ellipsis> default_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR class=md-nav__link> <span class=md-ellipsis> XccdfResultToOscalAR </span> </a> <nav class=md-nav aria-label=XccdfResultToOscalAR> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar class=md-nav__link> <span class=md-ellipsis> xccdf_result_to_oscal_ar </span> </a> <nav class=md-nav aria-label=xccdf_result_to_oscal_ar> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.default_description class=md-nav__link> <span class=md-ellipsis> default_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.default_title class=md-nav__link> <span class=md-ellipsis> default_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.default_type class=md-nav__link> <span class=md-ellipsis> default_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR class=md-nav__link> <span class=md-ellipsis> XccdfResultToOscalAR </span> </a> <nav class=md-nav aria-label=XccdfResultToOscalAR> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.xccdf_result_to_oscal_ar</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.xccdf_result_to_oscal_ar class="doc doc-heading"> <code>trestle.tasks.xccdf_result_to_oscal_ar</code> <a href=#trestle.tasks.xccdf_result_to_oscal_ar class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.xccdf_result_to_oscal_ar-attributes>Attributes<a href=#trestle.tasks.xccdf_result_to_oscal_ar-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.xccdf_result_to_oscal_ar.default_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>default_description</span> <span class=o>=</span> <span class=s1>&#39;XCCDF Scan Results&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.default_description class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.xccdf_result_to_oscal_ar.default_title class="doc doc-heading"> <code class="highlight language-python"><span class=n>default_title</span> <span class=o>=</span> <span class=s1>&#39;XCCDF&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.default_title class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.xccdf_result_to_oscal_ar.default_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>default_type</span> <span class=o>=</span> <span class=s1>&#39;Validator&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.default_type class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.xccdf_result_to_oscal_ar.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.xccdf_result_to_oscal_ar-classes>Classes<a href=#trestle.tasks.xccdf_result_to_oscal_ar-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR class="doc doc-heading"> <code>XccdfResultToOscalAR</code> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to convert Xccdf result to OSCAL json.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.name href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 35</span>
+<span class=normal> 36</span>
+<span class=normal> 37</span>
+<span class=normal> 38</span>
+<span class=normal> 39</span>
+<span class=normal> 40</span>
+<span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>XccdfResultToOscalAR</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to convert Xccdf result to OSCAL json.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;xccdf-result-to-oscal-ar&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task xccdf-result-to-oscal-ar.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>opt</span> <span class=o>=</span> <span class=s1>&#39;(optional)&#39;</span>
+        <span class=n>req</span> <span class=o>=</span> <span class=s1>&#39;(required)&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;Purpose: Transform Xccdf files into Open Security Controls Assessment Language (OSCAL) &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39;partial results files.&#39;</span>
+        <span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.xccdf-result-to-oscal-ar]:&#39;</span><span class=p>)</span>
+        <span class=c1>#</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  input-dir              = </span><span class=si>{</span><span class=n>req</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;the path of the input directory comprising Xccdf results.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  output-dir             = </span><span class=si>{</span><span class=n>req</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;the path of the output directory comprising synthesized OSCAL .json files.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  checking               = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;True indicates perform strict checking of OSCAL properties, default is False.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  output-overwrite       = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;true [default] or false; replace existing output when true.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  quiet                  = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;true or false [default]; display file creations and rules analysis when false.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  title                  = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;default=</span><span class=si>{</span><span class=n>default_title</span><span class=si>}</span><span class=s1>.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  description            = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;default=</span><span class=si>{</span><span class=n>default_description</span><span class=si>}</span><span class=s1>.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  type                   = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;default=</span><span class=si>{</span><span class=n>default_type</span><span class=si>}</span><span class=s1>.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  property-name-to-class = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;list of name:class pairs for tagging named property with class, &#39;</span>
+        <span class=n>t3</span> <span class=o>=</span> <span class=s1>&#39;e.g. &quot;target:scc_inventory_item_id, version:scc_check_version&quot;.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}{</span><span class=n>t3</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  timestamp              = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+        <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;timestamp for the Observations in ISO 8601 format, such as &#39;</span>
+        <span class=n>t3</span> <span class=o>=</span> <span class=s1>&#39; 2021-01-04T00:05:23+04:00 for example; if not specified then value for &quot;Timestamp&quot; key in the Xccdf &#39;</span>
+        <span class=n>t4</span> <span class=o>=</span> <span class=s1>&#39; result is used if present, otherwise current time is used.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}{</span><span class=n>t3</span><span class=si>}{</span><span class=n>t4</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1>#</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+            <span class=s1>&#39;Operation: A transformation is performed on one or more Xccdf input files to produce output in OSCAL &#39;</span>
+            <span class=o>+</span> <span class=s1>&#39;partial results format.&#39;</span>
+        <span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>True</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_transform</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Perform transformation.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform_work</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span><span class=p>:</span>
+                <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;simulated-&#39;</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_transform_work</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Perform transformation work steps.</span>
+
+<span class=sd>        Work steps: read input, process, write output, display analysis</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span><span class=p>:</span>
+            <span class=n>mode</span> <span class=o>=</span> <span class=s1>&#39;simulated-&#39;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config required input &amp; output dirs</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>idir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;input-dir&#39;</span><span class=p>]</span>
+            <span class=n>ipth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>idir</span><span class=p>)</span>
+            <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=p>[</span><span class=s1>&#39;output-dir&#39;</span><span class=p>]</span>
+            <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>KeyError</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;key </span><span class=si>{</span><span class=n>e</span><span class=o>.</span><span class=n>args</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=si>}</span><span class=s1> missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config optional overwrite &amp; quiet</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=n>quiet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=ow>and</span> <span class=ow>not</span> <span class=n>quiet</span>
+        <span class=c1># title, description, type</span>
+        <span class=n>title</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;title&#39;</span><span class=p>,</span> <span class=n>default_title</span><span class=p>)</span>
+        <span class=n>description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;description&#39;</span><span class=p>,</span> <span class=n>default_description</span><span class=p>)</span>
+        <span class=n>type_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;type&#39;</span><span class=p>,</span> <span class=n>default_type</span><span class=p>)</span>
+        <span class=c1># property-name-to-class</span>
+        <span class=n>tags</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_tags</span><span class=p>()</span>
+        <span class=c1># config optional timestamp</span>
+        <span class=n>timestamp</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;timestamp&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>timestamp</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>XccdfTransformer</span><span class=o>.</span><span class=n>set_timestamp</span><span class=p>(</span><span class=n>timestamp</span><span class=p>)</span>
+            <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config invalid &quot;timestamp&quot;&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config optional performance</span>
+        <span class=n>modes</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=s1>&#39;checking&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;checking&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>),</span>
+        <span class=p>}</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># process</span>
+        <span class=k>for</span> <span class=n>ifile</span> <span class=ow>in</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>ipth</span><span class=o>.</span><span class=n>iterdir</span><span class=p>()):</span>
+            <span class=k>if</span> <span class=n>ifile</span><span class=o>.</span><span class=n>suffix</span> <span class=ow>not</span> <span class=ow>in</span> <span class=p>[</span><span class=s1>&#39;.json&#39;</span><span class=p>,</span> <span class=s1>&#39;.jsn&#39;</span><span class=p>,</span> <span class=s1>&#39;.yaml&#39;</span><span class=p>,</span> <span class=s1>&#39;.yml&#39;</span><span class=p>,</span> <span class=s1>&#39;.xml&#39;</span><span class=p>]:</span>
+                <span class=k>continue</span>
+            <span class=n>blob</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_read_file</span><span class=p>(</span><span class=n>ifile</span><span class=p>)</span>
+            <span class=n>xccdf_transformer</span> <span class=o>=</span> <span class=n>XccdfTransformer</span><span class=p>()</span>
+            <span class=n>xccdf_transformer</span><span class=o>.</span><span class=n>set_title</span><span class=p>(</span><span class=n>title</span><span class=p>)</span>
+            <span class=n>xccdf_transformer</span><span class=o>.</span><span class=n>set_description</span><span class=p>(</span><span class=n>description</span><span class=p>)</span>
+            <span class=n>xccdf_transformer</span><span class=o>.</span><span class=n>set_type</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span>
+            <span class=n>xccdf_transformer</span><span class=o>.</span><span class=n>set_modes</span><span class=p>(</span><span class=n>modes</span><span class=p>)</span>
+            <span class=n>xccdf_transformer</span><span class=o>.</span><span class=n>set_tags</span><span class=p>(</span><span class=n>tags</span><span class=p>)</span>
+            <span class=n>results</span> <span class=o>=</span> <span class=n>xccdf_transformer</span><span class=o>.</span><span class=n>transform</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+            <span class=n>oname</span> <span class=o>=</span> <span class=n>ifile</span><span class=o>.</span><span class=n>stem</span> <span class=o>+</span> <span class=s1>&#39;.oscal&#39;</span> <span class=o>+</span> <span class=s1>&#39;.json&#39;</span>
+            <span class=n>ofile</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_write_file</span><span class=p>(</span><span class=n>results</span><span class=p>,</span> <span class=n>ofile</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_show_analysis</span><span class=p>(</span><span class=n>xccdf_transformer</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=n>mode</span> <span class=o>+</span> <span class=s1>&#39;success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_tags</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get property name to class tags, if any.&quot;&quot;&quot;</span>
+        <span class=n>tags</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>data</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;property-name-to-class&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>data</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>data</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>):</span>
+                <span class=n>item</span> <span class=o>=</span> <span class=n>item</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>parts</span> <span class=o>=</span> <span class=n>item</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;:&#39;</span><span class=p>)</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>2</span><span class=p>:</span>
+                    <span class=n>name</span> <span class=o>=</span> <span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+                    <span class=n>value</span> <span class=o>=</span> <span class=n>parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+                    <span class=n>tags</span><span class=p>[</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=n>value</span>
+        <span class=k>return</span> <span class=n>tags</span>
+
+    <span class=k>def</span> <span class=nf>_read_file</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>ifile</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Read raw input file.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input: </span><span class=si>{</span><span class=n>ifile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>with</span> <span class=nb>open</span><span class=p>(</span><span class=n>ifile</span><span class=p>,</span> <span class=n>encoding</span><span class=o>=</span><span class=n>const</span><span class=o>.</span><span class=n>FILE_ENCODING</span><span class=p>)</span> <span class=k>as</span> <span class=n>fp</span><span class=p>:</span>
+            <span class=n>blob</span> <span class=o>=</span> <span class=n>fp</span><span class=o>.</span><span class=n>read</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>blob</span>
+
+    <span class=k>def</span> <span class=nf>_write_file</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>result</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>ofile</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Write oscal results file.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>result</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>))</span>
+
+    <span class=k>def</span> <span class=nf>_show_analysis</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>xccdf_transformer</span><span class=p>:</span> <span class=n>XccdfTransformer</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Show analysis.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>analysis</span> <span class=o>=</span> <span class=n>xccdf_transformer</span><span class=o>.</span><span class=n>analysis</span>
+            <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>analysis</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-attributes>Attributes<a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;xccdf-result-to-oscal-ar&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-functions>Functions<a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task xccdf-result-to-oscal-ar.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task xccdf-result-to-oscal-ar.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an actual outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an actual outcome.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>opt</span> <span class=o>=</span> <span class=s1>&#39;(optional)&#39;</span>
+    <span class=n>req</span> <span class=o>=</span> <span class=s1>&#39;(required)&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;Purpose: Transform Xccdf files into Open Security Controls Assessment Language (OSCAL) &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39;partial results files.&#39;</span>
+    <span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;Configuration flags sit under [task.xccdf-result-to-oscal-ar]:&#39;</span><span class=p>)</span>
+    <span class=c1>#</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  input-dir              = </span><span class=si>{</span><span class=n>req</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;the path of the input directory comprising Xccdf results.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  output-dir             = </span><span class=si>{</span><span class=n>req</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;the path of the output directory comprising synthesized OSCAL .json files.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  checking               = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;True indicates perform strict checking of OSCAL properties, default is False.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  output-overwrite       = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;true [default] or false; replace existing output when true.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  quiet                  = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;true or false [default]; display file creations and rules analysis when false.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  title                  = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;default=</span><span class=si>{</span><span class=n>default_title</span><span class=si>}</span><span class=s1>.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  description            = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;default=</span><span class=si>{</span><span class=n>default_description</span><span class=si>}</span><span class=s1>.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  type                   = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;default=</span><span class=si>{</span><span class=n>default_type</span><span class=si>}</span><span class=s1>.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  property-name-to-class = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;list of name:class pairs for tagging named property with class, &#39;</span>
+    <span class=n>t3</span> <span class=o>=</span> <span class=s1>&#39;e.g. &quot;target:scc_inventory_item_id, version:scc_check_version&quot;.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}{</span><span class=n>t3</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=n>t1</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;  timestamp              = </span><span class=si>{</span><span class=n>opt</span><span class=si>}</span><span class=s1> &#39;</span>
+    <span class=n>t2</span> <span class=o>=</span> <span class=s1>&#39;timestamp for the Observations in ISO 8601 format, such as &#39;</span>
+    <span class=n>t3</span> <span class=o>=</span> <span class=s1>&#39; 2021-01-04T00:05:23+04:00 for example; if not specified then value for &quot;Timestamp&quot; key in the Xccdf &#39;</span>
+    <span class=n>t4</span> <span class=o>=</span> <span class=s1>&#39; result is used if present, otherwise current time is used.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>t1</span><span class=si>}{</span><span class=n>t2</span><span class=si>}{</span><span class=n>t3</span><span class=si>}{</span><span class=n>t4</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=c1>#</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span>
+        <span class=s1>&#39;Operation: A transformation is performed on one or more Xccdf input files to produce output in OSCAL &#39;</span>
+        <span class=o>+</span> <span class=s1>&#39;partial results format.&#39;</span>
+    <span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_simulate</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transform</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/xlsx_helper/index.html b/latest/reference/API/trestle/tasks/xlsx_helper/index.html
new file mode 100644
index 000000000..e5ac675be
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/xlsx_helper/index.html
@@ -0,0 +1,1585 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.xlsx_helper module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_helper/ rel=canonical><link href=../xccdf_result_to_oscal_ar/ rel=prev><link href=../xlsx_to_oscal_cd/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.xlsx_helper - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.xlsx_helper - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.xlsx_helper module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/xlsx_helper.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_helper/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.xlsx_helper - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.xlsx_helper module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/xlsx_helper.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.xlsx_helper class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper class=md-nav__link> <span class=md-ellipsis> xlsx_helper </span> </a> <nav class=md-nav aria-label=xlsx_helper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column class=md-nav__link> <span class=md-ellipsis> Column </span> </a> <nav class=md-nav aria-label=Column> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.control_text class=md-nav__link> <span class=md-ellipsis> control_text </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.filter_column class=md-nav__link> <span class=md-ellipsis> filter_column </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.goal_name_id class=md-nav__link> <span class=md-ellipsis> goal_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.goal_version class=md-nav__link> <span class=md-ellipsis> goal_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.help_list class=md-nav__link> <span class=md-ellipsis> help_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.nist_mappings class=md-nav__link> <span class=md-ellipsis> nist_mappings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.parameter_opt_parm class=md-nav__link> <span class=md-ellipsis> parameter_opt_parm </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.rename_parameter_opt_parm class=md-nav__link> <span class=md-ellipsis> rename_parameter_opt_parm </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.rename_values_alternatives class=md-nav__link> <span class=md-ellipsis> rename_values_alternatives </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.resource_title class=md-nav__link> <span class=md-ellipsis> resource_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.rule_name_id class=md-nav__link> <span class=md-ellipsis> rule_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.rule_version class=md-nav__link> <span class=md-ellipsis> rule_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.text1 class=md-nav__link> <span class=md-ellipsis> text1 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.text2 class=md-nav__link> <span class=md-ellipsis> text2 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.tokens_nist_mappings class=md-nav__link> <span class=md-ellipsis> tokens_nist_mappings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.tokens_parameter_opt_parm class=md-nav__link> <span class=md-ellipsis> tokens_parameter_opt_parm </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.tokens_values_alternatives class=md-nav__link> <span class=md-ellipsis> tokens_values_alternatives </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.values_alternatives class=md-nav__link> <span class=md-ellipsis> values_alternatives </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper class=md-nav__link> <span class=md-ellipsis> XlsxHelper </span> </a> <nav class=md-nav aria-label=XlsxHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_check class=md-nav__link> <span class=md-ellipsis> by_check </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_control class=md-nav__link> <span class=md-ellipsis> by_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_goal class=md-nav__link> <span class=md-ellipsis> by_goal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_rule class=md-nav__link> <span class=md-ellipsis> by_rule </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.profile_type class=md-nav__link> <span class=md-ellipsis> profile_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.profile_types class=md-nav__link> <span class=md-ellipsis> profile_types </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.configure class=md-nav__link> <span class=md-ellipsis> configure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.configure_cd class=md-nav__link> <span class=md-ellipsis> configure_cd </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.configure_profile class=md-nav__link> <span class=md-ellipsis> configure_profile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_check_name_id class=md-nav__link> <span class=md-ellipsis> get_check_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_component_name class=md-nav__link> <span class=md-ellipsis> get_component_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_controls class=md-nav__link> <span class=md-ellipsis> get_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_goal_name_id class=md-nav__link> <span class=md-ellipsis> get_goal_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_goal_remarks class=md-nav__link> <span class=md-ellipsis> get_goal_remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name class=md-nav__link> <span class=md-ellipsis> get_parameter_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name_and_description class=md-nav__link> <span class=md-ellipsis> get_parameter_name_and_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_usage class=md-nav__link> <span class=md-ellipsis> get_parameter_usage </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_value_default class=md-nav__link> <span class=md-ellipsis> get_parameter_value_default </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_values class=md-nav__link> <span class=md-ellipsis> get_parameter_values </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_rule_name_id class=md-nav__link> <span class=md-ellipsis> get_rule_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.load class=md-nav__link> <span class=md-ellipsis> load </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.report_issues class=md-nav__link> <span class=md-ellipsis> report_issues </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.row_generator class=md-nav__link> <span class=md-ellipsis> row_generator </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.get_trestle_version class=md-nav__link> <span class=md-ellipsis> get_trestle_version </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper class=md-nav__link> <span class=md-ellipsis> xlsx_helper </span> </a> <nav class=md-nav aria-label=xlsx_helper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column class=md-nav__link> <span class=md-ellipsis> Column </span> </a> <nav class=md-nav aria-label=Column> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.control_id class=md-nav__link> <span class=md-ellipsis> control_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.control_text class=md-nav__link> <span class=md-ellipsis> control_text </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.filter_column class=md-nav__link> <span class=md-ellipsis> filter_column </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.goal_name_id class=md-nav__link> <span class=md-ellipsis> goal_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.goal_version class=md-nav__link> <span class=md-ellipsis> goal_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.help_list class=md-nav__link> <span class=md-ellipsis> help_list </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.nist_mappings class=md-nav__link> <span class=md-ellipsis> nist_mappings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.parameter_opt_parm class=md-nav__link> <span class=md-ellipsis> parameter_opt_parm </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.rename_parameter_opt_parm class=md-nav__link> <span class=md-ellipsis> rename_parameter_opt_parm </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.rename_values_alternatives class=md-nav__link> <span class=md-ellipsis> rename_values_alternatives </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.resource_title class=md-nav__link> <span class=md-ellipsis> resource_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.rule_name_id class=md-nav__link> <span class=md-ellipsis> rule_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.rule_version class=md-nav__link> <span class=md-ellipsis> rule_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.text1 class=md-nav__link> <span class=md-ellipsis> text1 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.text2 class=md-nav__link> <span class=md-ellipsis> text2 </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.tokens_nist_mappings class=md-nav__link> <span class=md-ellipsis> tokens_nist_mappings </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.tokens_parameter_opt_parm class=md-nav__link> <span class=md-ellipsis> tokens_parameter_opt_parm </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.tokens_values_alternatives class=md-nav__link> <span class=md-ellipsis> tokens_values_alternatives </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.Column.values_alternatives class=md-nav__link> <span class=md-ellipsis> values_alternatives </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper class=md-nav__link> <span class=md-ellipsis> XlsxHelper </span> </a> <nav class=md-nav aria-label=XlsxHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_check class=md-nav__link> <span class=md-ellipsis> by_check </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_control class=md-nav__link> <span class=md-ellipsis> by_control </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_goal class=md-nav__link> <span class=md-ellipsis> by_goal </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_rule class=md-nav__link> <span class=md-ellipsis> by_rule </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.profile_type class=md-nav__link> <span class=md-ellipsis> profile_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.profile_types class=md-nav__link> <span class=md-ellipsis> profile_types </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.configure class=md-nav__link> <span class=md-ellipsis> configure </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.configure_cd class=md-nav__link> <span class=md-ellipsis> configure_cd </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.configure_profile class=md-nav__link> <span class=md-ellipsis> configure_profile </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_check_name_id class=md-nav__link> <span class=md-ellipsis> get_check_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_component_name class=md-nav__link> <span class=md-ellipsis> get_component_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_controls class=md-nav__link> <span class=md-ellipsis> get_controls </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_goal_name_id class=md-nav__link> <span class=md-ellipsis> get_goal_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_goal_remarks class=md-nav__link> <span class=md-ellipsis> get_goal_remarks </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name class=md-nav__link> <span class=md-ellipsis> get_parameter_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name_and_description class=md-nav__link> <span class=md-ellipsis> get_parameter_name_and_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_usage class=md-nav__link> <span class=md-ellipsis> get_parameter_usage </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_value_default class=md-nav__link> <span class=md-ellipsis> get_parameter_value_default </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_values class=md-nav__link> <span class=md-ellipsis> get_parameter_values </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_rule_name_id class=md-nav__link> <span class=md-ellipsis> get_rule_name_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.load class=md-nav__link> <span class=md-ellipsis> load </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.report_issues class=md-nav__link> <span class=md-ellipsis> report_issues </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.row_generator class=md-nav__link> <span class=md-ellipsis> row_generator </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_helper.get_trestle_version class=md-nav__link> <span class=md-ellipsis> get_trestle_version </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.xlsx_helper</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.xlsx_helper class="doc doc-heading"> <code>trestle.tasks.xlsx_helper</code> <a href=#trestle.tasks.xlsx_helper class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>XLSX utilities.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.xlsx_helper-attributes>Attributes<a href=#trestle.tasks.xlsx_helper-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.xlsx_helper.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.xlsx_helper-classes>Classes<a href=#trestle.tasks.xlsx_helper-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.xlsx_helper.Column class="doc doc-heading"> <code>Column</code> <a href=#trestle.tasks.xlsx_helper.Column class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Spread sheet columns.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Column</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Spread sheet columns.&quot;&quot;&quot;</span>
+
+    <span class=n>control_id</span> <span class=o>=</span> <span class=s1>&#39;ControlId&#39;</span>
+    <span class=n>control_text</span> <span class=o>=</span> <span class=s1>&#39;ControlText&#39;</span>
+    <span class=n>goal_name_id</span> <span class=o>=</span> <span class=s1>&#39;goal_name_id&#39;</span>
+    <span class=n>goal_version</span> <span class=o>=</span> <span class=s1>&#39;goal_version&#39;</span>
+    <span class=n>rule_name_id</span> <span class=o>=</span> <span class=s1>&#39;rule_name_id&#39;</span>
+    <span class=n>rule_version</span> <span class=o>=</span> <span class=s1>&#39;rule_version&#39;</span>
+    <span class=n>nist_mappings</span> <span class=o>=</span> <span class=s1>&#39;NIST Mappings&#39;</span>
+    <span class=n>resource_title</span> <span class=o>=</span> <span class=s1>&#39;ResourceTitle&#39;</span>
+    <span class=n>parameter_opt_parm</span> <span class=o>=</span> <span class=s1>&#39;Parameter [optional parameter]&#39;</span>
+    <span class=n>values_alternatives</span> <span class=o>=</span> <span class=s1>&#39;Values default , [alternatives]&#39;</span>
+    <span class=n>filter_column</span> <span class=o>=</span> <span class=kc>None</span>
+
+    <span class=n>tokens_nist_mappings</span> <span class=o>=</span> <span class=n>nist_mappings</span><span class=o>.</span><span class=n>split</span><span class=p>()</span>
+    <span class=n>tokens_parameter_opt_parm</span> <span class=o>=</span> <span class=n>parameter_opt_parm</span><span class=o>.</span><span class=n>split</span><span class=p>()</span>
+    <span class=n>rename_parameter_opt_parm</span> <span class=o>=</span> <span class=s1>&#39;ParameterName&#39;</span>
+    <span class=n>tokens_values_alternatives</span> <span class=o>=</span> <span class=n>values_alternatives</span><span class=o>.</span><span class=n>split</span><span class=p>()</span>
+    <span class=n>rename_values_alternatives</span> <span class=o>=</span> <span class=s1>&#39;ParameterValue&#39;</span>
+
+    <span class=n>help_list</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;                      &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>control_id</span><span class=si>}</span><span class=s1>&quot; contains control ID.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>control_text</span><span class=si>}</span><span class=s1>&quot; contains control text.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;columns &quot;</span><span class=si>{</span><span class=n>nist_mappings</span><span class=si>}</span><span class=s1>&quot; contain NIST control mappings.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>resource_title</span><span class=si>}</span><span class=s1>&quot; contains component name.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>goal_name_id</span><span class=si>}</span><span class=s1>&quot; contains goal name.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>goal_version</span><span class=si>}</span><span class=s1>&quot; contains goal version.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>rule_name_id</span><span class=si>}</span><span class=s1>&quot; contains rule name.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>rule_version</span><span class=si>}</span><span class=s1>&quot; contains rule version.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>parameter_opt_parm</span><span class=si>}</span><span class=s1>&quot; contains parameter name + description, separated by newline.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>values_alternatives</span><span class=si>}</span><span class=s1>&quot; contains parameter values.&#39;</span>
+    <span class=n>help_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.xlsx_helper.Column-attributes>Attributes<a href=#trestle.tasks.xlsx_helper.Column-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.control_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_id</span> <span class=o>=</span> <span class=s1>&#39;ControlId&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.control_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.control_text class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_text</span> <span class=o>=</span> <span class=s1>&#39;ControlText&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.control_text class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.filter_column class="doc doc-heading"> <code class="highlight language-python"><span class=n>filter_column</span> <span class=o>=</span> <span class=kc>None</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.filter_column class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.goal_name_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>goal_name_id</span> <span class=o>=</span> <span class=s1>&#39;goal_name_id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.goal_name_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.goal_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>goal_version</span> <span class=o>=</span> <span class=s1>&#39;goal_version&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.goal_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.help_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>help_list</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.help_list class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.nist_mappings class="doc doc-heading"> <code class="highlight language-python"><span class=n>nist_mappings</span> <span class=o>=</span> <span class=s1>&#39;NIST Mappings&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.nist_mappings class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.parameter_opt_parm class="doc doc-heading"> <code class="highlight language-python"><span class=n>parameter_opt_parm</span> <span class=o>=</span> <span class=s1>&#39;Parameter [optional parameter]&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.parameter_opt_parm class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.rename_parameter_opt_parm class="doc doc-heading"> <code class="highlight language-python"><span class=n>rename_parameter_opt_parm</span> <span class=o>=</span> <span class=s1>&#39;ParameterName&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.rename_parameter_opt_parm class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.rename_values_alternatives class="doc doc-heading"> <code class="highlight language-python"><span class=n>rename_values_alternatives</span> <span class=o>=</span> <span class=s1>&#39;ParameterValue&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.rename_values_alternatives class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.resource_title class="doc doc-heading"> <code class="highlight language-python"><span class=n>resource_title</span> <span class=o>=</span> <span class=s1>&#39;ResourceTitle&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.resource_title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.rule_name_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>rule_name_id</span> <span class=o>=</span> <span class=s1>&#39;rule_name_id&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.rule_name_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.rule_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>rule_version</span> <span class=o>=</span> <span class=s1>&#39;rule_version&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.rule_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.text1 class="doc doc-heading"> <code class="highlight language-python"><span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39; &#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.text1 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.text2 class="doc doc-heading"> <code class="highlight language-python"><span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;column &quot;</span><span class=si>{</span><span class=n>values_alternatives</span><span class=si>}</span><span class=s1>&quot; contains parameter values.&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.text2 class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.tokens_nist_mappings class="doc doc-heading"> <code class="highlight language-python"><span class=n>tokens_nist_mappings</span> <span class=o>=</span> <span class=n>nist_mappings</span><span class=o>.</span><span class=n>split</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.tokens_nist_mappings class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.tokens_parameter_opt_parm class="doc doc-heading"> <code class="highlight language-python"><span class=n>tokens_parameter_opt_parm</span> <span class=o>=</span> <span class=n>parameter_opt_parm</span><span class=o>.</span><span class=n>split</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.tokens_parameter_opt_parm class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.tokens_values_alternatives class="doc doc-heading"> <code class="highlight language-python"><span class=n>tokens_values_alternatives</span> <span class=o>=</span> <span class=n>values_alternatives</span><span class=o>.</span><span class=n>split</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.tokens_values_alternatives class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.Column.values_alternatives class="doc doc-heading"> <code class="highlight language-python"><span class=n>values_alternatives</span> <span class=o>=</span> <span class=s1>&#39;Values default , [alternatives]&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.Column.values_alternatives class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.xlsx_helper.XlsxHelper class="doc doc-heading"> <code>XlsxHelper</code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Xlsx Helper common functions and assistance navigating spread sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>XlsxHelper</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Xlsx Helper common functions and assistance navigating spread sheet.&quot;&quot;&quot;</span>
+
+    <span class=n>by_goal</span> <span class=o>=</span> <span class=s1>&#39;by-goal&#39;</span>
+    <span class=n>by_rule</span> <span class=o>=</span> <span class=s1>&#39;by-rule&#39;</span>
+    <span class=n>by_control</span> <span class=o>=</span> <span class=s1>&#39;by-control&#39;</span>
+    <span class=n>by_check</span> <span class=o>=</span> <span class=s1>&#39;by-check&#39;</span>
+
+    <span class=n>profile_types</span> <span class=o>=</span> <span class=p>[</span><span class=n>by_goal</span><span class=p>,</span> <span class=n>by_rule</span><span class=p>,</span> <span class=n>by_control</span><span class=p>,</span> <span class=n>by_check</span><span class=p>]</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_column</span> <span class=o>=</span> <span class=n>Column</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>oscal_name</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Purpose: From spread sheet and catalog produce OSCAL </span><span class=si>{</span><span class=n>oscal_name</span><span class=si>}</span><span class=s1> file.&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Configuration flags sit under [task.</span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>]:&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>oscal_name</span> <span class=o>==</span> <span class=s1>&#39;component_definition&#39;</span><span class=p>:</span>
+            <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  catalog-file      = &#39;</span>
+            <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the OSCAL catalog file.&#39;</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  spread-sheet-file = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the spread sheet file.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  work-sheet-name   = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the name of the work sheet in the spread sheet file.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>help_list</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir        = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the output directory for synthesized OSCAL .json files.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite  = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  filter-column     = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) column heading of yes/no values; process only &quot;yes&quot; rows.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-type      = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;(optional) one of </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>profile_types</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>profile_type</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Profile type.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile_type</span>
+
+    <span class=k>def</span> <span class=nf>configure</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>task</span><span class=p>:</span> <span class=n>TaskBase</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Configure.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=c1># config verbosity</span>
+        <span class=n>quiet</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+        <span class=n>task</span><span class=o>.</span><span class=n>_verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=n>quiet</span>
+        <span class=c1># required for component-definition</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>configure_cd</span><span class=p>(</span><span class=n>task</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=c1># required for profile</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>configure_profile</span><span class=p>(</span><span class=n>task</span><span class=p>):</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=c1># optional</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>filter_column</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;filter-column&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+        <span class=c1># config spread sheet</span>
+        <span class=n>spread_sheet</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;spread-sheet-file&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>spread_sheet</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;spread-sheet&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>spread_sheet</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;&quot;spread-sheet&quot; not found&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=n>sheet_name</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;work-sheet-name&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>sheet_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;work-sheet-name&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=c1># announce spreadsheet</span>
+        <span class=k>if</span> <span class=n>task</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input: </span><span class=si>{</span><span class=n>spread_sheet</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># get profile type</span>
+        <span class=k>if</span> <span class=n>task</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;xlsx-to-oscal-profile&#39;</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_profile_type</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;profile-type&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>profile_types</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile_type</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>profile_types</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;invalid &quot;profile-type&quot; </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile_type</span><span class=si>}</span><span class=s1> &#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_profile_type</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=c1># load spread sheet</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>spread_sheet</span><span class=p>,</span> <span class=n>sheet_name</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>configure_cd</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>task</span><span class=p>:</span> <span class=n>TaskBase</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Configure cd.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>task</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;xlsx-to-oscal-cd&#39;</span><span class=p>:</span>
+            <span class=n>catalog_file</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;catalog-file&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>catalog_file</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;catalog-file&quot;&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+            <span class=k>try</span><span class=p>:</span>
+                <span class=n>catalog</span> <span class=o>=</span> <span class=n>Catalog</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>catalog_file</span><span class=p>))</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;catalog: </span><span class=si>{</span><span class=n>catalog_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+                <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error loading catalog </span><span class=si>{</span><span class=n>catalog_file</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>task</span><span class=o>.</span><span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>configure_profile</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>task</span><span class=p>:</span> <span class=n>TaskBase</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Configure profile.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>task</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;xlsx-to-oscal-profile&#39;</span><span class=p>:</span>
+            <span class=n>profile_title</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;profile-title&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>profile_title</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;profile-title&quot;&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+            <span class=n>spread_sheet_url</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;spread-sheet-url&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>spread_sheet_url</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;spread-sheet-url&quot;&#39;</span><span class=p>)</span>
+                <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>load</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>spread_sheet</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>sheet_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Load.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_spread_sheet</span> <span class=o>=</span> <span class=n>spread_sheet</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span> <span class=o>=</span> <span class=n>sheet_name</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span> <span class=o>=</span> <span class=n>load_workbook</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_spread_sheet</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span><span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_map_name_to_letters</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># accumulators</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_control_id</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_goal_name_id</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_goal_name_id</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_rule_name_id</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_rule_name_id</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_parameter_name</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_controls</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters_values</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rows_filtered</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># map columns</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_map_columns</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>row_generator</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Generate rows until control_id is None.&quot;&quot;&quot;</span>
+        <span class=n>row</span> <span class=o>=</span> <span class=mi>1</span>
+        <span class=n>rows_skipped_consecutive</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=c1># assume no more data when 100 consecutve rows no control id</span>
+        <span class=n>rows_skipped_consecutive_limit</span> <span class=o>=</span> <span class=mi>100</span>
+        <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+            <span class=n>row</span> <span class=o>=</span> <span class=n>row</span> <span class=o>+</span> <span class=mi>1</span>
+            <span class=n>control_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_control_id</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=n>goal_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_goal_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>control_id</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>goal_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>rows_skipped_consecutive</span> <span class=o>+=</span> <span class=mi>1</span>
+                <span class=k>if</span> <span class=n>rows_skipped_consecutive</span> <span class=o>&lt;</span> <span class=n>rows_skipped_consecutive_limit</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;break: </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>rows_skipped_consecutive</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=k>break</span>
+            <span class=k>if</span> <span class=n>control_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_control_id</span><span class=p>)</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>goal_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_goal_name_id</span><span class=p>)</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_filtered</span><span class=p>(</span><span class=n>row</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=k>yield</span> <span class=n>row</span>
+            <span class=n>rows_skipped_consecutive</span> <span class=o>=</span> <span class=mi>0</span>
+
+    <span class=k>def</span> <span class=nf>_is_filtered</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return True if row is to be skipped.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>filter_column</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>filter_column</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>if</span> <span class=n>value</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>!=</span> <span class=s1>&#39;yes&#39;</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_filtered</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>True</span>
+
+    <span class=k>def</span> <span class=nf>get_goal_name_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>strict</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get goal_name_id from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>goal_name_id</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_goal_name_id</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>strict</span><span class=p>:</span>
+                <span class=n>svalue</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>value</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>svalue</span><span class=p>)</span><span class=o>.</span><span class=n>split</span><span class=p>())</span>
+                <span class=k>if</span> <span class=n>value</span> <span class=o>!=</span> <span class=n>svalue</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_goal_name_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>get_check_name_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>strict</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get check_name_id from work_sheet.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_goal_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>strict</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_rule_name_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>strict</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get rule_name_id from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rule_name_id</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_rule_name_id</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>strict</span><span class=p>:</span>
+                <span class=n>svalue</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>value</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>svalue</span><span class=p>)</span><span class=o>.</span><span class=n>split</span><span class=p>())</span>
+                <span class=k>if</span> <span class=n>value</span> <span class=o>!=</span> <span class=n>svalue</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_rule_name_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>get_parameter_usage</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parameter_usage from work_sheet.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_goal_remarks</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>get_parameter_value_default</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parameter_value_default from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_values_alternatives</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>get_parameter_values</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parameter_values from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_values_alternatives</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parameter_name</span><span class=p>(</span><span class=n>row</span><span class=p>)</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters_values</span><span class=p>)</span>
+        <span class=c1># massage into comma separated list of values</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=n>value</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;,[]&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=n>value</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=n>value</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;]&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=n>value</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_goal_text</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get goal_text from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>control_text</span><span class=p>)</span>
+        <span class=n>goal_text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=c1># normalize &amp; tokenize</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=n>goal_text</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\t</span><span class=s1>&#39;</span><span class=p>,</span> <span class=s1>&#39; &#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_goal_text_tokens</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get goal_text tokens from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>goal_text</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_goal_text</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+        <span class=n>tokens</span> <span class=o>=</span> <span class=n>goal_text</span><span class=o>.</span><span class=n>split</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>tokens</span>
+
+    <span class=k>def</span> <span class=nf>get_goal_remarks</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get goal_remarks from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>tokens</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_goal_text_tokens</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+        <span class=c1># replace &quot;Check whether&quot; with &quot;Ensure&quot;, if present</span>
+        <span class=k>if</span> <span class=n>tokens</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;Check&#39;</span><span class=p>:</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>tokens</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;whether&#39;</span><span class=p>:</span>
+                        <span class=n>tokens</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=mi>0</span><span class=p>)</span>
+                <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>=</span> <span class=s1>&#39;Ensure&#39;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=s1>&#39; &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>tokens</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>get_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Produce dict of controls mapped to statements.</span>
+
+<span class=sd>        Example: {&#39;au-2&#39;: [&#39;(a)&#39;, &#39;(d)&#39;], &#39;au-12&#39;: [], &#39;si-4&#39;: [&#39;(a)&#39;, &#39;(b)&#39;, &#39;(c)&#39;]}</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>col</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>nist_mappings</span><span class=p>):</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+            <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=c1># remove blanks</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>split</span><span class=p>())</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control</span><span class=p>)</span> <span class=o>&lt;</span> <span class=mi>1</span> <span class=ow>or</span> <span class=n>control</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;none&#39;</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=c1># remove rhs of : inclusive</span>
+            <span class=k>if</span> <span class=s1>&#39;:&#39;</span> <span class=ow>in</span> <span class=n>control</span><span class=p>:</span>
+                <span class=n>control</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;:&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+            <span class=c1># remove alphabet parts of control &amp; accumulate in statements</span>
+            <span class=n>control</span><span class=p>,</span> <span class=n>statements</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_normalize_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+            <span class=c1># skip bogus control made up if dashes only</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>))</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>control</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>value</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=n>value</span><span class=p>[</span><span class=n>control</span><span class=p>]</span> <span class=o>=</span> <span class=n>statements</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>value</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_controls</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;row: </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> controls </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>get_component_name</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get component_name from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>resource_title</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;row </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> col </span><span class=si>{</span><span class=n>col</span><span class=si>}</span><span class=s1> missing component name&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>get_parameter_name</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parameter_name from work_sheet.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parameter_name_and_description</span><span class=p>(</span><span class=n>row</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+
+    <span class=k>def</span> <span class=nf>get_parameter_name_and_description</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get parameter_name and description from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>name</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>description</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_parameter_opt_parm</span><span class=p>)</span>
+        <span class=n>combined_values</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=n>combined_values</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span> <span class=ow>in</span> <span class=n>combined_values</span><span class=p>:</span>
+                <span class=n>parameter_parts</span> <span class=o>=</span> <span class=n>combined_values</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=s1>&#39; &#39;</span> <span class=ow>in</span> <span class=n>combined_values</span><span class=p>:</span>
+                <span class=n>parameter_parts</span> <span class=o>=</span> <span class=n>combined_values</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>parameter_parts</span> <span class=o>=</span> <span class=n>combined_values</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>parameter_parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>2</span><span class=p>:</span>
+                <span class=n>name</span> <span class=o>=</span> <span class=n>parameter_parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>description</span> <span class=o>=</span> <span class=n>parameter_parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>sname</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>name</span> <span class=o>=</span> <span class=n>sname</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>name</span> <span class=o>!=</span> <span class=n>sname</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_parameter_name</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;row </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> col </span><span class=si>{</span><span class=n>col</span><span class=si>}</span><span class=s1> invalid value&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>name</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parameter_value_default</span><span class=p>(</span><span class=n>row</span><span class=p>)</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=n>name</span><span class=p>,</span> <span class=n>description</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_control_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get control_id from work_sheet.&quot;&quot;&quot;</span>
+        <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>control_id</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get column letter.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>map_name_to_letters</span><span class=p>[</span><span class=n>name</span><span class=p>]</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>value</span><span class=p>)</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=n>value</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_map_columns</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Map columns.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>map_name_to_letters</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>columns</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=o>.</span><span class=n>max_column</span>
+        <span class=k>for</span> <span class=n>column</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=n>columns</span> <span class=o>+</span> <span class=mi>1</span><span class=p>):</span>
+            <span class=n>cell_value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cell_value</span><span class=p>(</span><span class=mi>1</span><span class=p>,</span> <span class=n>column</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>cell_value</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>cell_tokens</span> <span class=o>=</span> <span class=n>cell_value</span><span class=o>.</span><span class=n>split</span><span class=p>()</span>
+            <span class=n>normalized_cell_value</span> <span class=o>=</span> <span class=s1>&#39; &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>cell_tokens</span><span class=p>)</span>
+            <span class=c1># find columns of interest</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>control_id</span> <span class=ow>in</span> <span class=n>cell_tokens</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>control_text</span> <span class=ow>in</span> <span class=n>cell_tokens</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>control_text</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>goal_name_id</span> <span class=ow>in</span> <span class=n>cell_tokens</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>goal_name_id</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>goal_version</span> <span class=ow>in</span> <span class=n>cell_tokens</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>goal_version</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rule_name_id</span> <span class=ow>in</span> <span class=n>cell_tokens</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rule_name_id</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rule_version</span> <span class=ow>in</span> <span class=n>cell_tokens</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rule_version</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=c1># parameters and alternatives (exact tokens match)</span>
+            <span class=k>elif</span> <span class=n>cell_tokens</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>tokens_parameter_opt_parm</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_parameter_opt_parm</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=n>cell_tokens</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>tokens_values_alternatives</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_values_alternatives</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=c1># filter column (exact string match)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>filter_column</span> <span class=o>==</span> <span class=n>normalized_cell_value</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>filter_column</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+            <span class=c1># nist mappings and resource title (multiple columns match)</span>
+            <span class=k>elif</span> <span class=n>is_ordered_sublist</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>tokens_nist_mappings</span><span class=p>,</span> <span class=n>cell_tokens</span><span class=p>):</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>nist_mappings</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>0</span><span class=p>)</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>resource_title</span> <span class=ow>in</span> <span class=n>cell_tokens</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>resource_title</span><span class=p>,</span> <span class=n>column</span><span class=p>,</span> <span class=mi>0</span><span class=p>)</span>
+        <span class=c1># insure expected columns found</span>
+        <span class=k>for</span> <span class=n>name</span> <span class=ow>in</span> <span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>control_id</span><span class=p>,</span>
+                     <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>control_text</span><span class=p>,</span>
+                     <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rule_name_id</span><span class=p>,</span>
+                     <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rule_version</span><span class=p>,</span>
+                     <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>goal_name_id</span><span class=p>,</span>
+                     <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>goal_version</span><span class=p>,</span>
+                     <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>nist_mappings</span><span class=p>,</span>
+                     <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>resource_title</span><span class=p>,</span>
+                     <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_parameter_opt_parm</span><span class=p>,</span>
+                     <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_values_alternatives</span><span class=p>]:</span>
+            <span class=k>if</span> <span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>map_name_to_letters</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;missing column </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_column</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>column</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>limit</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add column.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>name</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>map_name_to_letters</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>map_name_to_letters</span><span class=p>[</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>limit</span> <span class=o>&gt;</span> <span class=mi>0</span> <span class=ow>and</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>map_name_to_letters</span><span class=p>[</span><span class=n>name</span><span class=p>])</span> <span class=o>==</span> <span class=n>limit</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;duplicate column </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>get_column_letter</span><span class=p>(</span><span class=n>column</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>map_name_to_letters</span><span class=p>[</span><span class=n>name</span><span class=p>]</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>get_column_letter</span><span class=p>(</span><span class=n>column</span><span class=p>))</span>
+
+    <span class=k>def</span> <span class=nf>_cell_value</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>col</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get value for cell, adjusting for merged cells.&quot;&quot;&quot;</span>
+        <span class=n>cell</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=o>.</span><span class=n>cell</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>col</span><span class=p>)</span>
+        <span class=n>retval</span> <span class=o>=</span> <span class=n>cell</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=nb>isinstance</span><span class=p>(</span><span class=n>cell</span><span class=p>,</span> <span class=n>MergedCell</span><span class=p>):</span>
+            <span class=c1># cell is merged</span>
+            <span class=k>for</span> <span class=n>mc_range</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=o>.</span><span class=n>merged_cells</span><span class=o>.</span><span class=n>ranges</span><span class=p>:</span>
+                <span class=n>coord</span> <span class=o>=</span> <span class=n>get_column_letter</span><span class=p>(</span><span class=n>col</span><span class=p>)</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+                <span class=k>if</span> <span class=n>coord</span> <span class=ow>in</span> <span class=n>mc_range</span><span class=p>:</span>
+                    <span class=n>retval</span> <span class=o>=</span> <span class=n>mc_range</span><span class=o>.</span><span class=n>start_cell</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>return</span> <span class=n>retval</span>
+
+    <span class=k>def</span> <span class=nf>_normalize_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Remove parenthesized characters from controls.&quot;&quot;&quot;</span>
+        <span class=n>statements</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=n>string</span><span class=o>.</span><span class=n>ascii_lowercase</span><span class=p>:</span>
+            <span class=n>needle</span> <span class=o>=</span> <span class=s1>&#39;(&#39;</span> <span class=o>+</span> <span class=n>i</span> <span class=o>+</span> <span class=s1>&#39;)&#39;</span>
+            <span class=k>if</span> <span class=n>needle</span> <span class=ow>in</span> <span class=n>control</span><span class=p>:</span>
+                <span class=n>statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>needle</span><span class=p>)</span>
+                <span class=n>control</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>needle</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>control</span><span class=p>,</span> <span class=n>statements</span>
+
+    <span class=k>def</span> <span class=nf>_add_row</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>account</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>int</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add row to accounting list of rows.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>row</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>account</span><span class=p>:</span>
+            <span class=n>account</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>report_issues</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Report issues.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_control_id</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing control_id: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_goal_name_id</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows invalid goal_name_id: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_goal_name_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_rule_name_id</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing rule_name_id: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_rule_name_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_rule_name_id</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows invalid rule_name_id: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_rule_name_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_parameter_name</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows invalid parameter_name: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_parameter_name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_controls</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing controls: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_controls</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing parameters: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters_values</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing parameters values: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters_values</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_filtered</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows filtered: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_filtered</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.xlsx_helper.XlsxHelper-attributes>Attributes<a href=#trestle.tasks.xlsx_helper.XlsxHelper-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.by_check class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_check</span> <span class=o>=</span> <span class=s1>&#39;by-check&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_check class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.by_control class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_control</span> <span class=o>=</span> <span class=s1>&#39;by-control&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_control class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.by_goal class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_goal</span> <span class=o>=</span> <span class=s1>&#39;by-goal&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_goal class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.by_rule class="doc doc-heading"> <code class="highlight language-python"><span class=n>by_rule</span> <span class=o>=</span> <span class=s1>&#39;by-rule&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.by_rule class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.profile_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>profile_type</span><span class=p>:</span> <span class=nb>str</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.profile_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Profile type.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.profile_types class="doc doc-heading"> <code class="highlight language-python"><span class=n>profile_types</span> <span class=o>=</span> <span class=p>[</span><span class=n>by_goal</span><span class=p>,</span> <span class=n>by_rule</span><span class=p>,</span> <span class=n>by_control</span><span class=p>,</span> <span class=n>by_check</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.profile_types class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.xlsx_helper.XlsxHelper-functions>Functions<a href=#trestle.tasks.xlsx_helper.XlsxHelper-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>97</span>
+<span class=normal>98</span>
+<span class=normal>99</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_column</span> <span class=o>=</span> <span class=n>Column</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.configure class="doc doc-heading"> <code class="highlight language-python"><span class=n>configure</span><span class=p>(</span><span class=n>task</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.configure class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Configure.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>configure</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>task</span><span class=p>:</span> <span class=n>TaskBase</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Configure.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=c1># config verbosity</span>
+    <span class=n>quiet</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;quiet&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+    <span class=n>task</span><span class=o>.</span><span class=n>_verbose</span> <span class=o>=</span> <span class=ow>not</span> <span class=n>quiet</span>
+    <span class=c1># required for component-definition</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>configure_cd</span><span class=p>(</span><span class=n>task</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=c1># required for profile</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>configure_profile</span><span class=p>(</span><span class=n>task</span><span class=p>):</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=c1># optional</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>filter_column</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;filter-column&#39;</span><span class=p>,</span> <span class=kc>None</span><span class=p>)</span>
+    <span class=c1># config spread sheet</span>
+    <span class=n>spread_sheet</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;spread-sheet-file&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>spread_sheet</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;spread-sheet&quot;&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>spread_sheet</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;&quot;spread-sheet&quot; not found&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=n>sheet_name</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;work-sheet-name&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>sheet_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;work-sheet-name&quot;&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=kc>False</span>
+    <span class=c1># announce spreadsheet</span>
+    <span class=k>if</span> <span class=n>task</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;input: </span><span class=si>{</span><span class=n>spread_sheet</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=c1># get profile type</span>
+    <span class=k>if</span> <span class=n>task</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;xlsx-to-oscal-profile&#39;</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_profile_type</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;profile-type&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>profile_types</span><span class=p>[</span><span class=mi>0</span><span class=p>])</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile_type</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>profile_types</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;invalid &quot;profile-type&quot; </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile_type</span><span class=si>}</span><span class=s1> &#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_profile_type</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=c1># load spread sheet</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>spread_sheet</span><span class=p>,</span> <span class=n>sheet_name</span><span class=p>)</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.configure_cd class="doc doc-heading"> <code class="highlight language-python"><span class=n>configure_cd</span><span class=p>(</span><span class=n>task</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.configure_cd class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Configure cd.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>configure_cd</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>task</span><span class=p>:</span> <span class=n>TaskBase</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Configure cd.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>task</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;xlsx-to-oscal-cd&#39;</span><span class=p>:</span>
+        <span class=n>catalog_file</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;catalog-file&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>catalog_file</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;catalog-file&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>catalog</span> <span class=o>=</span> <span class=n>Catalog</span><span class=o>.</span><span class=n>oscal_read</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>catalog_file</span><span class=p>))</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;catalog: </span><span class=si>{</span><span class=n>catalog_file</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>  <span class=c1># pragma: no cover</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error loading catalog </span><span class=si>{</span><span class=n>catalog_file</span><span class=si>}</span><span class=s1>: </span><span class=si>{</span><span class=n>e</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>task</span><span class=o>.</span><span class=n>catalog_interface</span> <span class=o>=</span> <span class=n>CatalogInterface</span><span class=p>(</span><span class=n>catalog</span><span class=p>)</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.configure_profile class="doc doc-heading"> <code class="highlight language-python"><span class=n>configure_profile</span><span class=p>(</span><span class=n>task</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.configure_profile class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Configure profile.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>configure_profile</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>task</span><span class=p>:</span> <span class=n>TaskBase</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Configure profile.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>task</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=s1>&#39;xlsx-to-oscal-profile&#39;</span><span class=p>:</span>
+        <span class=n>profile_title</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;profile-title&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>profile_title</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;profile-title&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+        <span class=n>spread_sheet_url</span> <span class=o>=</span> <span class=n>task</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;spread-sheet-url&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>spread_sheet_url</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=s1>&#39;config missing &quot;spread-sheet-url&quot;&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=kc>False</span>
+    <span class=k>return</span> <span class=kc>True</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_check_name_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_check_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>strict</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_check_name_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get check_name_id from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_check_name_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>strict</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get check_name_id from work_sheet.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_goal_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>strict</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_component_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_component_name</span><span class=p>(</span><span class=n>row</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_component_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get component_name from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_component_name</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get component_name from work_sheet.&quot;&quot;&quot;</span>
+    <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>resource_title</span><span class=p>)</span>
+    <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+    <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;row </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> col </span><span class=si>{</span><span class=n>col</span><span class=si>}</span><span class=s1> missing component name&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>value</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_controls</span><span class=p>(</span><span class=n>row</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Produce dict of controls mapped to statements.</p> <p>Example: {'au-2': ['(a)', '(d)'], 'au-12': [], 'si-4': ['(a)', '(b)', '(c)']}</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Produce dict of controls mapped to statements.</span>
+
+<span class=sd>    Example: {&#39;au-2&#39;: [&#39;(a)&#39;, &#39;(d)&#39;], &#39;au-12&#39;: [], &#39;si-4&#39;: [&#39;(a)&#39;, &#39;(b)&#39;, &#39;(c)&#39;]}</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>value</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>for</span> <span class=n>col</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>nist_mappings</span><span class=p>):</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+        <span class=k>if</span> <span class=n>control</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>continue</span>
+        <span class=c1># remove blanks</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>split</span><span class=p>())</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control</span><span class=p>)</span> <span class=o>&lt;</span> <span class=mi>1</span> <span class=ow>or</span> <span class=n>control</span><span class=o>.</span><span class=n>lower</span><span class=p>()</span> <span class=o>==</span> <span class=s1>&#39;none&#39;</span><span class=p>:</span>
+            <span class=k>continue</span>
+        <span class=c1># remove rhs of : inclusive</span>
+        <span class=k>if</span> <span class=s1>&#39;:&#39;</span> <span class=ow>in</span> <span class=n>control</span><span class=p>:</span>
+            <span class=n>control</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;:&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=c1># remove alphabet parts of control &amp; accumulate in statements</span>
+        <span class=n>control</span><span class=p>,</span> <span class=n>statements</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_normalize_control</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+        <span class=c1># skip bogus control made up if dashes only</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>))</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+            <span class=k>continue</span>
+        <span class=k>if</span> <span class=n>control</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>value</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>value</span><span class=p>[</span><span class=n>control</span><span class=p>]</span> <span class=o>=</span> <span class=n>statements</span>
+    <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>value</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_controls</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;row: </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> controls </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_goal_name_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_goal_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>strict</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_goal_name_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get goal_name_id from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_goal_name_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>strict</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get goal_name_id from work_sheet.&quot;&quot;&quot;</span>
+    <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>goal_name_id</span><span class=p>)</span>
+    <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+    <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_goal_name_id</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>strict</span><span class=p>:</span>
+            <span class=n>svalue</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>svalue</span><span class=p>)</span><span class=o>.</span><span class=n>split</span><span class=p>())</span>
+            <span class=k>if</span> <span class=n>value</span> <span class=o>!=</span> <span class=n>svalue</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_goal_name_id</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_goal_remarks class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_goal_remarks</span><span class=p>(</span><span class=n>row</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_goal_remarks class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get goal_remarks from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_goal_remarks</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get goal_remarks from work_sheet.&quot;&quot;&quot;</span>
+    <span class=n>tokens</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_goal_text_tokens</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+    <span class=c1># replace &quot;Check whether&quot; with &quot;Ensure&quot;, if present</span>
+    <span class=k>if</span> <span class=n>tokens</span><span class=p>:</span>
+        <span class=k>if</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;Check&#39;</span><span class=p>:</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>tokens</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>tokens</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;whether&#39;</span><span class=p>:</span>
+                    <span class=n>tokens</span><span class=o>.</span><span class=n>pop</span><span class=p>(</span><span class=mi>0</span><span class=p>)</span>
+            <span class=n>tokens</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>=</span> <span class=s1>&#39;Ensure&#39;</span>
+    <span class=n>value</span> <span class=o>=</span> <span class=s1>&#39; &#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=n>tokens</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_parameter_name</span><span class=p>(</span><span class=n>row</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get parameter_name from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_parameter_name</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get parameter_name from work_sheet.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parameter_name_and_description</span><span class=p>(</span><span class=n>row</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name_and_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_parameter_name_and_description</span><span class=p>(</span><span class=n>row</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name_and_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get parameter_name and description from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_parameter_name_and_description</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get parameter_name and description from work_sheet.&quot;&quot;&quot;</span>
+    <span class=n>name</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>description</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_parameter_opt_parm</span><span class=p>)</span>
+    <span class=n>combined_values</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+    <span class=k>if</span> <span class=n>combined_values</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>if</span> <span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span> <span class=ow>in</span> <span class=n>combined_values</span><span class=p>:</span>
+            <span class=n>parameter_parts</span> <span class=o>=</span> <span class=n>combined_values</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;</span><span class=se>\n</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>elif</span> <span class=s1>&#39; &#39;</span> <span class=ow>in</span> <span class=n>combined_values</span><span class=p>:</span>
+            <span class=n>parameter_parts</span> <span class=o>=</span> <span class=n>combined_values</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>parameter_parts</span> <span class=o>=</span> <span class=n>combined_values</span>
+        <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>parameter_parts</span><span class=p>)</span> <span class=o>==</span> <span class=mi>2</span><span class=p>:</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>parameter_parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=n>parameter_parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>sname</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=n>sname</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>name</span> <span class=o>!=</span> <span class=n>sname</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_parameter_name</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;row </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> col </span><span class=si>{</span><span class=n>col</span><span class=si>}</span><span class=s1> invalid value&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>name</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parameter_value_default</span><span class=p>(</span><span class=n>row</span><span class=p>)</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters</span><span class=p>)</span>
+    <span class=n>value</span> <span class=o>=</span> <span class=n>name</span><span class=p>,</span> <span class=n>description</span>
+    <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_usage class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_parameter_usage</span><span class=p>(</span><span class=n>row</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_usage class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get parameter_usage from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_parameter_usage</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get parameter_usage from work_sheet.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_goal_remarks</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_value_default class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_parameter_value_default</span><span class=p>(</span><span class=n>row</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_value_default class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get parameter_value_default from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_parameter_value_default</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get parameter_value_default from work_sheet.&quot;&quot;&quot;</span>
+    <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_values_alternatives</span><span class=p>)</span>
+    <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+    <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+    <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_values class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_parameter_values</span><span class=p>(</span><span class=n>row</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_values class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get parameter_values from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_parameter_values</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get parameter_values from work_sheet.&quot;&quot;&quot;</span>
+    <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rename_values_alternatives</span><span class=p>)</span>
+    <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+    <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_parameter_name</span><span class=p>(</span><span class=n>row</span><span class=p>)</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters_values</span><span class=p>)</span>
+    <span class=c1># massage into comma separated list of values</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=n>value</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;,[]&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=n>value</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;[&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=n>value</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;]&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=n>value</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.get_rule_name_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_rule_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>strict</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.get_rule_name_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get rule_name_id from work_sheet.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_rule_name_id</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span> <span class=n>strict</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get rule_name_id from work_sheet.&quot;&quot;&quot;</span>
+    <span class=n>col</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_column_letter</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>rule_name_id</span><span class=p>)</span>
+    <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span><span class=p>[</span><span class=n>col</span> <span class=o>+</span> <span class=nb>str</span><span class=p>(</span><span class=n>row</span><span class=p>)]</span><span class=o>.</span><span class=n>value</span>
+    <span class=k>if</span> <span class=n>value</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_rule_name_id</span><span class=p>)</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>strict</span><span class=p>:</span>
+            <span class=n>svalue</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>)</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=n>value</span> <span class=o>=</span> <span class=s1>&#39;&#39;</span><span class=o>.</span><span class=n>join</span><span class=p>(</span><span class=nb>str</span><span class=p>(</span><span class=n>svalue</span><span class=p>)</span><span class=o>.</span><span class=n>split</span><span class=p>())</span>
+            <span class=k>if</span> <span class=n>value</span> <span class=o>!=</span> <span class=n>svalue</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_rule_name_id</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.load class="doc doc-heading"> <code class="highlight language-python"><span class=n>load</span><span class=p>(</span><span class=n>spread_sheet</span><span class=p>,</span> <span class=n>sheet_name</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.load class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Load.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>load</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>spread_sheet</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>sheet_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Load.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_spread_sheet</span> <span class=o>=</span> <span class=n>spread_sheet</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span> <span class=o>=</span> <span class=n>sheet_name</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span> <span class=o>=</span> <span class=n>load_workbook</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_spread_sheet</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_work_sheet</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_wb</span><span class=p>[</span><span class=bp>self</span><span class=o>.</span><span class=n>_sheet_name</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_map_name_to_letters</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=c1># accumulators</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_control_id</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_goal_name_id</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_goal_name_id</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_rule_name_id</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_rule_name_id</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_parameter_name</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_controls</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters_values</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>rows_filtered</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=c1># map columns</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_map_columns</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>oscal_name</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>,</span> <span class=n>oscal_name</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Help information for </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> task.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Purpose: From spread sheet and catalog produce OSCAL </span><span class=si>{</span><span class=n>oscal_name</span><span class=si>}</span><span class=s1> file.&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=s1>&#39;&#39;</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Configuration flags sit under [task.</span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>]:&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>oscal_name</span> <span class=o>==</span> <span class=s1>&#39;component_definition&#39;</span><span class=p>:</span>
+        <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  catalog-file      = &#39;</span>
+        <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the OSCAL catalog file.&#39;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  spread-sheet-file = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the spread sheet file.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  work-sheet-name   = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the name of the work sheet in the spread sheet file.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_column</span><span class=o>.</span><span class=n>help_list</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-dir        = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(required) the path of the output directory for synthesized OSCAL .json files.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  output-overwrite  = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) true [default] or false; replace existing output when true.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  filter-column     = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=s1>&#39;(optional) column heading of yes/no values; process only &quot;yes&quot; rows.&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+    <span class=n>text1</span> <span class=o>=</span> <span class=s1>&#39;  profile-type      = &#39;</span>
+    <span class=n>text2</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;(optional) one of </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>profile_types</span><span class=si>}</span><span class=s1>&#39;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>text1</span> <span class=o>+</span> <span class=n>text2</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.report_issues class="doc doc-heading"> <code class="highlight language-python"><span class=n>report_issues</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.report_issues class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Report issues.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>report_issues</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Report issues.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_control_id</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing control_id: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_control_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_goal_name_id</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows invalid goal_name_id: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_goal_name_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_rule_name_id</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing rule_name_id: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_rule_name_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_rule_name_id</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows invalid rule_name_id: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_rule_name_id</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_parameter_name</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows invalid parameter_name: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_invalid_parameter_name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_controls</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing controls: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_controls</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing parameters: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters_values</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows missing parameters values: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_parameters_values</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_filtered</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;rows filtered: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>rows_filtered</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_helper.XlsxHelper.row_generator class="doc doc-heading"> <code class="highlight language-python"><span class=n>row_generator</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_helper.XlsxHelper.row_generator class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Generate rows until control_id is None.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>row_generator</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Iterator</span><span class=p>[</span><span class=nb>int</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Generate rows until control_id is None.&quot;&quot;&quot;</span>
+    <span class=n>row</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=n>rows_skipped_consecutive</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=c1># assume no more data when 100 consecutve rows no control id</span>
+    <span class=n>rows_skipped_consecutive_limit</span> <span class=o>=</span> <span class=mi>100</span>
+    <span class=k>while</span> <span class=kc>True</span><span class=p>:</span>
+        <span class=n>row</span> <span class=o>=</span> <span class=n>row</span> <span class=o>+</span> <span class=mi>1</span>
+        <span class=n>control_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_control_id</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+        <span class=n>goal_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_goal_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>control_id</span> <span class=ow>is</span> <span class=kc>None</span> <span class=ow>and</span> <span class=n>goal_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>rows_skipped_consecutive</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=k>if</span> <span class=n>rows_skipped_consecutive</span> <span class=o>&lt;</span> <span class=n>rows_skipped_consecutive_limit</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;break: </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> </span><span class=si>{</span><span class=n>rows_skipped_consecutive</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=k>break</span>
+        <span class=k>if</span> <span class=n>control_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_control_id</span><span class=p>)</span>
+            <span class=k>continue</span>
+        <span class=k>if</span> <span class=n>goal_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_row</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>rows_missing_goal_name_id</span><span class=p>)</span>
+            <span class=k>continue</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_filtered</span><span class=p>(</span><span class=n>row</span><span class=p>):</span>
+            <span class=k>continue</span>
+        <span class=k>yield</span> <span class=n>row</span>
+        <span class=n>rows_skipped_consecutive</span> <span class=o>=</span> <span class=mi>0</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.tasks.xlsx_helper-functions>Functions<a href=#trestle.tasks.xlsx_helper-functions class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-function"> <h4 id=trestle.tasks.xlsx_helper.get_trestle_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_trestle_version</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_helper.get_trestle_version class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Get trestle version wrapper.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_trestle_version</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get trestle version wrapper.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>__version__</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/xlsx_to_oscal_cd/index.html b/latest/reference/API/trestle/tasks/xlsx_to_oscal_cd/index.html
new file mode 100644
index 000000000..f278ca58f
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/xlsx_to_oscal_cd/index.html
@@ -0,0 +1,769 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.xlsx_to_oscal_cd module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_to_oscal_cd/ rel=canonical><link href=../xlsx_helper/ rel=prev><link href=../xlsx_to_oscal_profile/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.xlsx_to_oscal_cd - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.xlsx_to_oscal_cd - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.xlsx_to_oscal_cd module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_cd.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_to_oscal_cd/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.xlsx_to_oscal_cd - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.xlsx_to_oscal_cd module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_cd.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.xlsx_to_oscal_cd class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd class=md-nav__link> <span class=md-ellipsis> xlsx_to_oscal_cd </span> </a> <nav class=md-nav aria-label=xlsx_to_oscal_cd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.key_sep class=md-nav__link> <span class=md-ellipsis> key_sep </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.sep class=md-nav__link> <span class=md-ellipsis> sep </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition class=md-nav__link> <span class=md-ellipsis> XlsxToOscalComponentDefinition </span> </a> <nav class=md-nav aria-label=XlsxToOscalComponentDefinition> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.xlsx_helper class=md-nav__link> <span class=md-ellipsis> xlsx_helper </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.set_timestamp class=md-nav__link> <span class=md-ellipsis> set_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd class=md-nav__link> <span class=md-ellipsis> xlsx_to_oscal_cd </span> </a> <nav class=md-nav aria-label=xlsx_to_oscal_cd> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.key_sep class=md-nav__link> <span class=md-ellipsis> key_sep </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.sep class=md-nav__link> <span class=md-ellipsis> sep </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition class=md-nav__link> <span class=md-ellipsis> XlsxToOscalComponentDefinition </span> </a> <nav class=md-nav aria-label=XlsxToOscalComponentDefinition> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.xlsx_helper class=md-nav__link> <span class=md-ellipsis> xlsx_helper </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.set_timestamp class=md-nav__link> <span class=md-ellipsis> set_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_cd-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.xlsx_to_oscal_cd</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.xlsx_to_oscal_cd class="doc doc-heading"> <code>trestle.tasks.xlsx_to_oscal_cd</code> <a href=#trestle.tasks.xlsx_to_oscal_cd class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.xlsx_to_oscal_cd-attributes>Attributes<a href=#trestle.tasks.xlsx_to_oscal_cd-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.xlsx_to_oscal_cd.key_sep class="doc doc-heading"> <code class="highlight language-python"><span class=n>key_sep</span> <span class=o>=</span> <span class=s1>&#39;|&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_to_oscal_cd.key_sep class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.xlsx_to_oscal_cd.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_to_oscal_cd.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.xlsx_to_oscal_cd.sep class="doc doc-heading"> <code class="highlight language-python"><span class=n>sep</span> <span class=o>=</span> <span class=s1>&#39;|&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_to_oscal_cd.sep class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.xlsx_to_oscal_cd-classes>Classes<a href=#trestle.tasks.xlsx_to_oscal_cd-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition class="doc doc-heading"> <code>XlsxToOscalComponentDefinition</code> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to create OSCAL ComponentDefinition json.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.name href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>XlsxToOscalComponentDefinition</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to create OSCAL ComponentDefinition json.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;xlsx-to-oscal-cd&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task xlsx-to-oscal-cd.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span> <span class=o>=</span> <span class=n>XlsxHelper</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>set_timestamp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set the timestamp.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>print_info</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;component_definition&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an executed outcome.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute path core.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>configure</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config output</span>
+        <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;output-dir&#39;</span><span class=p>)</span>
+        <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># calculate output file name &amp; check writability</span>
+        <span class=n>oname</span> <span class=o>=</span> <span class=s1>&#39;component-definition.json&#39;</span>
+        <span class=n>ofile</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># initialize</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>defined_components</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># roles, responsible_roles, parties, responsible parties</span>
+        <span class=n>party_uuid_01</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>party_uuid_02</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>party_uuid_03</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+        <span class=n>roles</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_roles</span><span class=p>()</span>
+        <span class=n>responsible_roles</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_responsible_roles</span><span class=p>(</span><span class=n>party_uuid_01</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>)</span>
+        <span class=n>parties</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_parties</span><span class=p>(</span><span class=n>party_uuid_01</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>)</span>
+        <span class=n>responsible_parties</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_build_responsible_parties</span><span class=p>(</span><span class=n>party_uuid_01</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>)</span>
+        <span class=c1># process each row of spread sheet</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_process_rows</span><span class=p>(</span><span class=n>responsible_roles</span><span class=p>)</span>
+        <span class=c1># create OSCAL ComponentDefinition</span>
+        <span class=n>metadata</span> <span class=o>=</span> <span class=n>Metadata</span><span class=p>(</span>
+            <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Component definition for &#39;</span> <span class=o>+</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_catalog_title</span><span class=p>()</span> <span class=o>+</span> <span class=s1>&#39; profiles&#39;</span><span class=p>,</span>
+            <span class=n>last_modified</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span><span class=p>,</span>
+            <span class=n>oscal_version</span><span class=o>=</span><span class=n>OSCAL_VERSION</span><span class=p>,</span>
+            <span class=n>version</span><span class=o>=</span><span class=n>get_trestle_version</span><span class=p>(),</span>
+            <span class=n>roles</span><span class=o>=</span><span class=n>roles</span><span class=p>,</span>
+            <span class=n>parties</span><span class=o>=</span><span class=n>parties</span><span class=p>,</span>
+            <span class=n>responsible_parties</span><span class=o>=</span><span class=n>responsible_parties</span>
+        <span class=p>)</span>
+        <span class=n>component_definition</span> <span class=o>=</span> <span class=n>ComponentDefinition</span><span class=p>(</span>
+            <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+            <span class=n>metadata</span><span class=o>=</span><span class=n>metadata</span><span class=p>,</span>
+            <span class=n>components</span><span class=o>=</span><span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>defined_components</span><span class=o>.</span><span class=n>values</span><span class=p>()),</span>
+        <span class=p>)</span>
+        <span class=c1># write OSCAL ComponentDefinition to file</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>component_definition</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>))</span>
+        <span class=c1># issues</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_report_issues</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_process_rows</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Process spread sheet rows.&quot;&quot;&quot;</span>
+        <span class=n>ci_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>row_generator</span><span class=p>():</span>
+            <span class=c1># quit when first row with no goal_id encountered</span>
+            <span class=n>goal_name_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_goal_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=n>controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_controls</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>controls</span><span class=o>.</span><span class=n>keys</span><span class=p>())</span> <span class=o>==</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=c1># component</span>
+            <span class=n>component_name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_component_name</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=s1>&#39;Service&#39;</span>
+            <span class=n>defined_component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_defined_component</span><span class=p>(</span><span class=n>component_name</span><span class=p>,</span> <span class=n>component_type</span><span class=p>)</span>
+            <span class=c1># parameter</span>
+            <span class=n>parameter_name</span><span class=p>,</span> <span class=n>parameter_description</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_parameter_name_and_description</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=c1># control implementations</span>
+            <span class=n>source</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_catalog_url</span><span class=p>()</span>
+            <span class=n>description</span> <span class=o>=</span> <span class=n>component_name</span> <span class=o>+</span> <span class=s1>&#39; implemented controls for &#39;</span> <span class=o>+</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_catalog_title</span><span class=p>(</span>
+            <span class=p>)</span> <span class=o>+</span> <span class=s1>&#39;. It includes assessment asset configuration for CICD.&#39;</span>
+            <span class=n>key</span> <span class=o>=</span> <span class=n>source</span> <span class=o>+</span> <span class=n>key_sep</span> <span class=o>+</span> <span class=n>description</span>
+            <span class=n>control_implementation</span> <span class=o>=</span> <span class=n>ci_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>control_implementation</span><span class=p>:</span>
+                <span class=n>ci_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>ControlImplementation</span><span class=p>(</span>
+                    <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+                    <span class=n>source</span><span class=o>=</span><span class=n>source</span><span class=p>,</span>
+                    <span class=n>description</span><span class=o>=</span><span class=n>description</span><span class=p>,</span>
+                    <span class=n>implemented_requirements</span><span class=o>=</span><span class=p>[],</span>
+                <span class=p>)</span>
+                <span class=n>control_implementation</span> <span class=o>=</span> <span class=n>ci_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+                <span class=k>if</span> <span class=n>defined_component</span><span class=o>.</span><span class=n>control_implementations</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>defined_component</span><span class=o>.</span><span class=n>control_implementations</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=n>defined_component</span><span class=o>.</span><span class=n>control_implementations</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control_implementation</span><span class=p>)</span>
+            <span class=c1># implemented requirements</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_implemented_requirements</span><span class=p>(</span>
+                <span class=n>row</span><span class=p>,</span> <span class=n>control_implementation</span><span class=p>,</span> <span class=n>controls</span><span class=p>,</span> <span class=n>component_name</span><span class=p>,</span> <span class=n>parameter_name</span><span class=p>,</span> <span class=n>responsible_roles</span><span class=p>,</span> <span class=n>goal_name_id</span>
+            <span class=p>)</span>
+            <span class=c1># keep alternative parameter values at control implementation level</span>
+            <span class=n>parameter_values</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_parameter_values</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_set_parameter_values</span><span class=p>(</span><span class=n>parameter_name</span><span class=p>,</span> <span class=n>parameter_values</span><span class=p>,</span> <span class=n>control_implementation</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_implemented_requirements</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+        <span class=n>control_implementation</span><span class=p>:</span> <span class=n>ControlImplementation</span><span class=p>,</span>
+        <span class=n>controls</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]],</span>
+        <span class=n>component_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>parameter_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>responsible_roles</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>],</span>
+        <span class=n>goal_name_id</span><span class=p>:</span> <span class=nb>str</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add implemented requirements.&quot;&quot;&quot;</span>
+        <span class=n>goal_remarks</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_goal_remarks</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+        <span class=n>parameter_value_default</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_parameter_value_default</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>controls</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>control_uuid</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>())</span>
+            <span class=n>prop1</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+                <span class=n>name</span><span class=o>=</span><span class=s1>&#39;goal_name_id&#39;</span><span class=p>,</span>
+                <span class=n>class_</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_class_for_property_name</span><span class=p>(</span><span class=s1>&#39;goal_name_id&#39;</span><span class=p>),</span>
+                <span class=n>value</span><span class=o>=</span><span class=n>goal_name_id</span><span class=p>,</span>
+                <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_namespace</span><span class=p>(),</span>
+                <span class=n>remarks</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>goal_remarks</span><span class=p>)</span>
+            <span class=p>)</span>
+            <span class=n>prop2</span> <span class=o>=</span> <span class=n>Property</span><span class=p>(</span>
+                <span class=n>name</span><span class=o>=</span><span class=s1>&#39;goal_version&#39;</span><span class=p>,</span>
+                <span class=n>class_</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_class_for_property_name</span><span class=p>(</span><span class=s1>&#39;goal_version&#39;</span><span class=p>),</span>
+                <span class=n>value</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_goal_version</span><span class=p>(),</span>
+                <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_namespace</span><span class=p>(),</span>
+                <span class=n>remarks</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>goal_name_id</span><span class=p>)</span>
+            <span class=p>)</span>
+            <span class=n>props</span> <span class=o>=</span> <span class=p>[</span><span class=n>prop1</span><span class=p>,</span> <span class=n>prop2</span><span class=p>]</span>
+            <span class=n>control_id</span><span class=p>,</span> <span class=n>_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>catalog_interface</span><span class=o>.</span><span class=n>get_control_id_and_status</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+            <span class=k>if</span> <span class=ow>not</span> <span class=n>control_id</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;row </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> control </span><span class=si>{</span><span class=n>control</span><span class=si>}</span><span class=s1> not found in catalog&#39;</span><span class=p>)</span>
+                <span class=n>control_id</span> <span class=o>=</span> <span class=n>control</span>
+            <span class=c1># implemented_requirement</span>
+            <span class=n>implemented_requirement</span> <span class=o>=</span> <span class=n>ImplementedRequirement</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=n>control_uuid</span><span class=p>,</span>
+                <span class=n>description</span><span class=o>=</span><span class=n>control</span><span class=p>,</span>
+                <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span>
+                <span class=n>control_id</span><span class=o>=</span><span class=n>control_id</span><span class=p>,</span>
+                <span class=n>responsible_roles</span><span class=o>=</span><span class=n>responsible_roles</span><span class=p>,</span>
+            <span class=p>)</span>
+            <span class=c1># add statements</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_statements</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>control</span><span class=p>,</span> <span class=n>controls</span><span class=p>,</span> <span class=n>component_name</span><span class=p>,</span> <span class=n>implemented_requirement</span><span class=p>)</span>
+            <span class=c1># add set_parameter</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_add_set_parameter_default</span><span class=p>(</span><span class=n>parameter_name</span><span class=p>,</span> <span class=n>parameter_value_default</span><span class=p>,</span> <span class=n>implemented_requirement</span><span class=p>)</span>
+            <span class=c1># implemented_requirements</span>
+            <span class=n>control_implementation</span><span class=o>.</span><span class=n>implemented_requirements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>implemented_requirement</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_statements</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>row</span><span class=p>:</span> <span class=nb>int</span><span class=p>,</span>
+        <span class=n>control</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>controls</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]],</span>
+        <span class=n>component_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>implemented_requirement</span><span class=p>:</span> <span class=n>ImplementedRequirement</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add statements.&quot;&quot;&quot;</span>
+        <span class=n>control_statements</span> <span class=o>=</span> <span class=n>controls</span><span class=p>[</span><span class=n>control</span><span class=p>]</span>
+        <span class=k>if</span> <span class=n>control_statements</span><span class=p>:</span>
+            <span class=n>statements</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=k>for</span> <span class=n>control_statement</span> <span class=ow>in</span> <span class=n>control_statements</span><span class=p>:</span>
+                <span class=n>statement_id</span> <span class=o>=</span> <span class=n>control</span> <span class=o>+</span> <span class=n>control_statement</span>
+                <span class=k>if</span> <span class=nb>any</span><span class=p>(</span><span class=n>i</span> <span class=ow>in</span> <span class=n>control</span> <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=s1>&#39;()&#39;</span><span class=p>):</span>
+                    <span class=n>control</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;(&#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+                    <span class=n>control</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;)&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;row </span><span class=si>{</span><span class=n>row</span><span class=si>}</span><span class=s1> control </span><span class=si>{</span><span class=n>control</span><span class=si>}</span><span class=s1> edited to remove parentheses&#39;</span><span class=p>)</span>
+                <span class=n>statement</span> <span class=o>=</span> <span class=n>Statement</span><span class=p>(</span>
+                    <span class=n>statement_id</span><span class=o>=</span><span class=n>control</span><span class=p>,</span>
+                    <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+                    <span class=n>description</span><span class=o>=</span><span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>component_name</span><span class=si>}</span><span class=s1> implements </span><span class=si>{</span><span class=n>statement_id</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=p>)</span>
+                <span class=n>statements</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>statement</span><span class=p>)</span>
+            <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>statements</span> <span class=o>=</span> <span class=n>statements</span>
+
+    <span class=k>def</span> <span class=nf>_add_set_parameter_values</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>parameter_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>parameter_values</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>control_implementation</span><span class=p>:</span> <span class=n>ControlImplementation</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add set parameter values (the set of choices).&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>parameter_name</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>parameter_name</span> <span class=o>=</span> <span class=n>parameter_name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>parameter_values</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[</span><span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=n>parameter_name</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>parameter_values</span><span class=p>)]</span>
+                <span class=k>if</span> <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=c1># set_parameters is a list</span>
+                <span class=n>control_implementation</span><span class=o>.</span><span class=n>set_parameters</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>set_parameters</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_add_set_parameter_default</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span> <span class=n>parameter_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>parameter_value_default</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>implemented_requirement</span><span class=p>:</span> <span class=n>ImplementedRequirement</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add set parameter default (the &quot;recommended&quot; value).&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>parameter_name</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>parameter_name</span> <span class=o>=</span> <span class=n>parameter_name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39; &#39;</span><span class=p>,</span> <span class=s1>&#39;_&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>parameter_value_default</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>set_parameters</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                    <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=n>values</span> <span class=o>=</span> <span class=p>[</span><span class=n>parameter_value_default</span><span class=p>]</span>
+                <span class=n>set_parameter</span> <span class=o>=</span> <span class=n>SetParameter</span><span class=p>(</span><span class=n>param_id</span><span class=o>=</span><span class=n>parameter_name</span><span class=p>,</span> <span class=n>values</span><span class=o>=</span><span class=n>values</span><span class=p>)</span>
+                <span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[</span><span class=n>set_parameter</span><span class=p>]</span>
+                <span class=c1># set_parameters is a list</span>
+                <span class=n>implemented_requirement</span><span class=o>.</span><span class=n>set_parameters</span><span class=o>.</span><span class=n>extend</span><span class=p>(</span><span class=n>set_parameters</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_defined_component</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>component_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>component_type</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>DefinedComponent</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get defined component.&quot;&quot;&quot;</span>
+        <span class=n>key</span> <span class=o>=</span> <span class=n>component_name</span> <span class=o>+</span> <span class=n>key_sep</span> <span class=o>+</span> <span class=n>component_type</span>
+        <span class=n>defined_component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>defined_components</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>key</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>defined_component</span><span class=p>:</span>
+            <span class=c1># create new component</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=n>component_name</span>
+            <span class=n>component_description</span> <span class=o>=</span> <span class=n>component_name</span>
+            <span class=n>defined_component</span> <span class=o>=</span> <span class=n>DefinedComponent</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+                <span class=n>description</span><span class=o>=</span><span class=n>component_description</span><span class=p>,</span>
+                <span class=n>title</span><span class=o>=</span><span class=n>component_title</span><span class=p>,</span>
+                <span class=nb>type</span><span class=o>=</span><span class=n>component_type</span><span class=p>,</span>
+            <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>defined_components</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>defined_component</span>
+        <span class=k>return</span> <span class=n>defined_component</span>
+
+    <span class=k>def</span> <span class=nf>_build_roles</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Role</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build roles.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>Role</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=s1>&#39;prepared-by&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Indicates the organization that created this content.&#39;</span><span class=p>),</span>
+            <span class=n>Role</span><span class=p>(</span><span class=nb>id</span><span class=o>=</span><span class=s1>&#39;prepared-for&#39;</span><span class=p>,</span> <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Indicates the organization for which this content was created..&#39;</span><span class=p>),</span>
+            <span class=n>Role</span><span class=p>(</span>
+                <span class=nb>id</span><span class=o>=</span><span class=s1>&#39;content-approver&#39;</span><span class=p>,</span>
+                <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Indicates the organization responsible for all content represented in the &quot;document&quot;.&#39;</span>
+            <span class=p>),</span>
+        <span class=p>]</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_build_responsible_roles</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>party_uuid_01</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                                 <span class=n>party_uuid_03</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ResponsibleRole</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build responsible roles.&quot;&quot;&quot;</span>
+        <span class=n>role_prepared_by</span> <span class=o>=</span> <span class=n>ResponsibleRole</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;prepared-by&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_01</span><span class=p>])</span>
+        <span class=n>role_prepared_for</span> <span class=o>=</span> <span class=n>ResponsibleRole</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;prepared-for&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>])</span>
+        <span class=n>role_content_approver</span> <span class=o>=</span> <span class=n>ResponsibleRole</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;content-approver&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_01</span><span class=p>])</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>role_prepared_by</span><span class=p>,</span>
+            <span class=n>role_prepared_for</span><span class=p>,</span>
+            <span class=n>role_content_approver</span><span class=p>,</span>
+        <span class=p>]</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_build_parties</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>party_uuid_01</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Party</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build parties.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>Party</span><span class=p>(</span><span class=n>uuid</span><span class=o>=</span><span class=n>party_uuid_01</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=s1>&#39;organization&#39;</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_org_name</span><span class=p>(),</span> <span class=n>remarks</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_org_remarks</span><span class=p>()),</span>
+            <span class=n>Party</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=n>party_uuid_02</span><span class=p>,</span>
+                <span class=nb>type</span><span class=o>=</span><span class=s1>&#39;organization&#39;</span><span class=p>,</span>
+                <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Customer&#39;</span><span class=p>,</span>
+                <span class=n>remarks</span><span class=o>=</span><span class=s1>&#39;organization to be customized at account creation only for their Component Definition&#39;</span>
+            <span class=p>),</span>
+            <span class=n>Party</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=n>party_uuid_03</span><span class=p>,</span>
+                <span class=nb>type</span><span class=o>=</span><span class=s1>&#39;organization&#39;</span><span class=p>,</span>
+                <span class=n>name</span><span class=o>=</span><span class=s1>&#39;ISV&#39;</span><span class=p>,</span>
+                <span class=n>remarks</span><span class=o>=</span><span class=s1>&#39;organization to be customized at ISV subscription only for their Component Definition&#39;</span>
+            <span class=p>),</span>
+        <span class=p>]</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_build_responsible_parties</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>party_uuid_01</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>party_uuid_02</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+                                   <span class=n>party_uuid_03</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ResponsibleParty</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build responsible parties.&quot;&quot;&quot;</span>
+        <span class=n>prepared_by</span> <span class=o>=</span> <span class=n>ResponsibleParty</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;prepared-by&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_01</span><span class=p>])</span>
+        <span class=n>prepared_for</span> <span class=o>=</span> <span class=n>ResponsibleParty</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;prepared-for&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_02</span><span class=p>,</span> <span class=n>party_uuid_03</span><span class=p>])</span>
+        <span class=n>content_approver</span> <span class=o>=</span> <span class=n>ResponsibleParty</span><span class=p>(</span><span class=n>role_id</span><span class=o>=</span><span class=s1>&#39;content-approver&#39;</span><span class=p>,</span> <span class=n>party_uuids</span><span class=o>=</span><span class=p>[</span><span class=n>party_uuid_01</span><span class=p>])</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>[</span>
+            <span class=n>prepared_by</span><span class=p>,</span>
+            <span class=n>prepared_for</span><span class=p>,</span>
+            <span class=n>content_approver</span><span class=p>,</span>
+        <span class=p>]</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_report_issues</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Report issues.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>report_issues</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_get_org_name</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get org-name from config.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;org-name&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;org-name: </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_org_remarks</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get org-remarks from config.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;org-remarks&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;org-remarks: </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_class_for_property_name</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>property_name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get class for property-name from config.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=n>data</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;property-name-to-class&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>data</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>data</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;,&#39;</span><span class=p>):</span>
+                <span class=n>item</span> <span class=o>=</span> <span class=n>item</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+                <span class=n>parts</span> <span class=o>=</span> <span class=n>item</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;:&#39;</span><span class=p>)</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>parts</span><span class=p>)</span> <span class=o>!=</span> <span class=mi>2</span> <span class=ow>or</span> <span class=n>parts</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span> <span class=o>!=</span> <span class=n>property_name</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>value</span> <span class=o>=</span> <span class=n>parts</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+                <span class=k>break</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;property-name-to-class: </span><span class=si>{</span><span class=n>property_name</span><span class=si>}</span><span class=s1> -&gt; </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_namespace</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get namespace from config.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;namespace&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;namespace: </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_catalog_url</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get catalog url from config.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;catalog-url&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;catalog-url: </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_catalog_title</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get catalog title from config.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;catalog-title&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;catalog-title: </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_goal_version</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Fix goal_version at 1.0.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=s1>&#39;1.0&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-attributes>Attributes<a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;xlsx-to-oscal-cd&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.xlsx_helper class="doc doc-heading"> <code class="highlight language-python"><span class=n>xlsx_helper</span> <span class=o>=</span> <span class=n>XlsxHelper</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.xlsx_helper class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-functions>Functions<a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task xlsx-to-oscal-cd.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task xlsx-to-oscal-cd.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span> <span class=o>=</span> <span class=n>XlsxHelper</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an executed outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an executed outcome.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>print_info</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;component_definition&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.set_timestamp class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_timestamp</span><span class=p>(</span><span class=n>timestamp</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.set_timestamp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set the timestamp.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_timestamp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set the timestamp.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.tasks.xlsx_to_oscal_cd-functions>Functions<a href=#trestle.tasks.xlsx_to_oscal_cd-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/tasks/xlsx_to_oscal_profile/index.html b/latest/reference/API/trestle/tasks/xlsx_to_oscal_profile/index.html
new file mode 100644
index 000000000..a4fb51e14
--- /dev/null
+++ b/latest/reference/API/trestle/tasks/xlsx_to_oscal_profile/index.html
@@ -0,0 +1,475 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.tasks.xlsx_to_oscal_profile module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_to_oscal_profile/ rel=canonical><link href=../xlsx_to_oscal_cd/ rel=prev><link href=../../transforms/results/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.tasks.xlsx_to_oscal_profile - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.tasks.xlsx_to_oscal_profile - Compliance Trestle"><meta property=og:description content="Documentation for trestle.tasks.xlsx_to_oscal_profile module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_profile.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_to_oscal_profile/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.tasks.xlsx_to_oscal_profile - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.tasks.xlsx_to_oscal_profile module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/tasks/xlsx_to_oscal_profile.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.tasks.xlsx_to_oscal_profile class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5 checked> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile class=md-nav__link> <span class=md-ellipsis> xlsx_to_oscal_profile </span> </a> <nav class=md-nav aria-label=xlsx_to_oscal_profile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile class=md-nav__link> <span class=md-ellipsis> XlsxToOscalProfile </span> </a> <nav class=md-nav aria-label=XlsxToOscalProfile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.xlsx_helper class=md-nav__link> <span class=md-ellipsis> xlsx_helper </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.set_timestamp class=md-nav__link> <span class=md-ellipsis> set_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile class=md-nav__link> <span class=md-ellipsis> xlsx_to_oscal_profile </span> </a> <nav class=md-nav aria-label=xlsx_to_oscal_profile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile class=md-nav__link> <span class=md-ellipsis> XlsxToOscalProfile </span> </a> <nav class=md-nav aria-label=XlsxToOscalProfile> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.name class=md-nav__link> <span class=md-ellipsis> name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.xlsx_helper class=md-nav__link> <span class=md-ellipsis> xlsx_helper </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.execute class=md-nav__link> <span class=md-ellipsis> execute </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.print_info class=md-nav__link> <span class=md-ellipsis> print_info </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.set_timestamp class=md-nav__link> <span class=md-ellipsis> set_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.simulate class=md-nav__link> <span class=md-ellipsis> simulate </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.tasks.xlsx_to_oscal_profile-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.tasks.xlsx_to_oscal_profile</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.tasks.xlsx_to_oscal_profile class="doc doc-heading"> <code>trestle.tasks.xlsx_to_oscal_profile</code> <a href=#trestle.tasks.xlsx_to_oscal_profile class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>OSCAL transformation tasks.</p> <div class="doc doc-children"> <h3 id=trestle.tasks.xlsx_to_oscal_profile-attributes>Attributes<a href=#trestle.tasks.xlsx_to_oscal_profile-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.tasks.xlsx_to_oscal_profile.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_to_oscal_profile.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.tasks.xlsx_to_oscal_profile-classes>Classes<a href=#trestle.tasks.xlsx_to_oscal_profile-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile class="doc doc-heading"> <code>XlsxToOscalProfile</code> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.tasks.base_task.TaskBase href=../base_task/#trestle.tasks.base_task.TaskBase>TaskBase</a></code></p> <p>Task to create OSCAL Profile json.</p> <p><span class=doc-section-title>Attributes:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td><code><a class="autorefs autorefs-internal" title=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.name href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.name>name</a></code></td> <td> </td> <td> <div class=doc-md-description> <p>Name of the task.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 41</span>
+<span class=normal> 42</span>
+<span class=normal> 43</span>
+<span class=normal> 44</span>
+<span class=normal> 45</span>
+<span class=normal> 46</span>
+<span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span>
+<span class=normal>216</span>
+<span class=normal>217</span>
+<span class=normal>218</span>
+<span class=normal>219</span>
+<span class=normal>220</span>
+<span class=normal>221</span>
+<span class=normal>222</span>
+<span class=normal>223</span>
+<span class=normal>224</span>
+<span class=normal>225</span>
+<span class=normal>226</span>
+<span class=normal>227</span>
+<span class=normal>228</span>
+<span class=normal>229</span>
+<span class=normal>230</span>
+<span class=normal>231</span>
+<span class=normal>232</span>
+<span class=normal>233</span>
+<span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>XlsxToOscalProfile</span><span class=p>(</span><span class=n>TaskBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Task to create OSCAL Profile json.</span>
+
+<span class=sd>    Attributes:</span>
+<span class=sd>        name: Name of the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;xlsx-to-oscal-profile&#39;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Initialize trestle task xlsx-to-oscal-profile.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            config_object: Config section associated with the task.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span> <span class=o>=</span> <span class=n>XlsxHelper</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>set_timestamp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set the timestamp.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+
+    <span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>print_info</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;profile&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Provide an executed outcome.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Execute path core.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>configure</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># config output</span>
+        <span class=n>odir</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;output-dir&#39;</span><span class=p>)</span>
+        <span class=n>opth</span> <span class=o>=</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>odir</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>getboolean</span><span class=p>(</span><span class=s1>&#39;output-overwrite&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+        <span class=c1># insure output dir exists</span>
+        <span class=n>opth</span><span class=o>.</span><span class=n>mkdir</span><span class=p>(</span><span class=n>exist_ok</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>parents</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+        <span class=c1># calculate output file name &amp; check writability</span>
+        <span class=n>oname</span> <span class=o>=</span> <span class=s1>&#39;profile.json&#39;</span>
+        <span class=n>ofile</span> <span class=o>=</span> <span class=n>opth</span> <span class=o>/</span> <span class=n>oname</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=bp>self</span><span class=o>.</span><span class=n>_overwrite</span> <span class=ow>and</span> <span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>)</span><span class=o>.</span><span class=n>exists</span><span class=p>():</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>error</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1> already exists&#39;</span><span class=p>)</span>
+            <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+        <span class=c1># create OSCAL Profile</span>
+        <span class=n>metadata</span> <span class=o>=</span> <span class=n>Metadata</span><span class=p>(</span>
+            <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Profile for &#39;</span> <span class=o>+</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_profile_title</span><span class=p>(),</span>
+            <span class=n>last_modified</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span><span class=p>,</span>
+            <span class=n>oscal_version</span><span class=o>=</span><span class=n>OSCAL_VERSION</span><span class=p>,</span>
+            <span class=n>version</span><span class=o>=</span><span class=n>get_trestle_version</span><span class=p>(),</span>
+        <span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>profile_type</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>by_control</span><span class=p>:</span>
+            <span class=n>imports</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_imports_by_control</span><span class=p>()</span>
+            <span class=n>profile</span> <span class=o>=</span> <span class=n>Profile</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+                <span class=n>metadata</span><span class=o>=</span><span class=n>metadata</span><span class=p>,</span>
+                <span class=n>imports</span><span class=o>=</span><span class=n>imports</span><span class=p>,</span>
+            <span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>profile_type</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>by_rule</span><span class=p>:</span>
+                <span class=n>imports</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_imports_by_rule</span><span class=p>()</span>
+            <span class=k>elif</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>profile_type</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>by_check</span><span class=p>:</span>
+                <span class=n>imports</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_imports_by_check</span><span class=p>()</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>imports</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_imports_by_goal</span><span class=p>()</span>
+            <span class=n>set_parameters</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_set_parameters</span><span class=p>()</span>
+            <span class=n>modify</span> <span class=o>=</span> <span class=n>Modify</span><span class=p>(</span><span class=n>set_parameters</span><span class=o>=</span><span class=n>set_parameters</span><span class=p>)</span>
+            <span class=n>profile</span> <span class=o>=</span> <span class=n>Profile</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=nb>str</span><span class=p>(</span><span class=n>uuid</span><span class=o>.</span><span class=n>uuid4</span><span class=p>()),</span>
+                <span class=n>metadata</span><span class=o>=</span><span class=n>metadata</span><span class=p>,</span>
+                <span class=n>imports</span><span class=o>=</span><span class=n>imports</span><span class=p>,</span>
+                <span class=n>modify</span><span class=o>=</span><span class=n>modify</span><span class=p>,</span>
+            <span class=p>)</span>
+        <span class=c1># write OSCAL Profile to file</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_verbose</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;output: </span><span class=si>{</span><span class=n>ofile</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>profile</span><span class=o>.</span><span class=n>oscal_write</span><span class=p>(</span><span class=n>pathlib</span><span class=o>.</span><span class=n>Path</span><span class=p>(</span><span class=n>ofile</span><span class=p>))</span>
+        <span class=c1># issues</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_report_issues</span><span class=p>()</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;success&#39;</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_imports_by_goal</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Import</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get imports by goal.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_imports_by_check</span><span class=p>()</span>
+
+    <span class=k>def</span> <span class=nf>_get_imports_by_control</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Import</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get imports by control.&quot;&quot;&quot;</span>
+        <span class=n>import_</span> <span class=o>=</span> <span class=n>Import</span><span class=p>(</span>
+            <span class=n>href</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_spread_sheet_url</span><span class=p>(),</span>
+            <span class=n>include_controls</span><span class=o>=</span><span class=p>[</span><span class=n>SelectControlById</span><span class=p>(</span><span class=n>with_ids</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_with_ids_by_control</span><span class=p>())],</span>
+        <span class=p>)</span>
+        <span class=n>imports</span> <span class=o>=</span> <span class=p>[</span><span class=n>import_</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>imports</span>
+
+    <span class=k>def</span> <span class=nf>_get_imports_by_rule</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Import</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get imports by rule.&quot;&quot;&quot;</span>
+        <span class=n>import_</span> <span class=o>=</span> <span class=n>Import</span><span class=p>(</span>
+            <span class=n>href</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_spread_sheet_url</span><span class=p>(),</span>
+            <span class=n>include_controls</span><span class=o>=</span><span class=p>[</span><span class=n>SelectControlById</span><span class=p>(</span><span class=n>with_ids</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_with_ids_by_rule</span><span class=p>())],</span>
+        <span class=p>)</span>
+        <span class=n>imports</span> <span class=o>=</span> <span class=p>[</span><span class=n>import_</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>imports</span>
+
+    <span class=k>def</span> <span class=nf>_get_imports_by_check</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Import</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get imports by check.&quot;&quot;&quot;</span>
+        <span class=n>import_</span> <span class=o>=</span> <span class=n>Import</span><span class=p>(</span>
+            <span class=n>href</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_spread_sheet_url</span><span class=p>(),</span>
+            <span class=n>include_controls</span><span class=o>=</span><span class=p>[</span><span class=n>SelectControlById</span><span class=p>(</span><span class=n>with_ids</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_get_with_ids_by_check</span><span class=p>())],</span>
+        <span class=p>)</span>
+        <span class=n>imports</span> <span class=o>=</span> <span class=p>[</span><span class=n>import_</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>imports</span>
+
+    <span class=k>def</span> <span class=nf>_get_with_ids_by_control</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get controls from spread sheet.&quot;&quot;&quot;</span>
+        <span class=n>control_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>row_generator</span><span class=p>():</span>
+            <span class=c1># quit when first row with no goal_id encountered</span>
+            <span class=n>controls</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_controls</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>controls</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>controls</span><span class=p>:</span>
+                    <span class=n>control</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_oscal_namify</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+                    <span class=k>if</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>control_list</span><span class=p>:</span>
+                        <span class=k>continue</span>
+                    <span class=n>control_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>control</span><span class=p>)</span>
+        <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>control_list</span><span class=p>,</span> <span class=n>key</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_control_sort_key</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_with_ids_by_rule</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get rules from spread sheet.&quot;&quot;&quot;</span>
+        <span class=n>rule_name_id_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>row_generator</span><span class=p>():</span>
+            <span class=c1># quit when first row with no goal_id encountered</span>
+            <span class=n>rule_name_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_rule_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>strict</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>rule_name_id</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>rule_name_id</span> <span class=ow>in</span> <span class=n>rule_name_id_list</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>rule_name_id_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>rule_name_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>rule_name_id_list</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_with_ids_by_check</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get check from spread sheet.&quot;&quot;&quot;</span>
+        <span class=n>check_name_id_list</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>row_generator</span><span class=p>():</span>
+            <span class=c1># quit when first row with no goal_id encountered</span>
+            <span class=n>check_name_id</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_check_name_id</span><span class=p>(</span><span class=n>row</span><span class=p>,</span> <span class=n>strict</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>check_name_id</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>if</span> <span class=n>check_name_id</span> <span class=ow>in</span> <span class=n>check_name_id_list</span><span class=p>:</span>
+                    <span class=k>continue</span>
+                <span class=n>check_name_id_list</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>check_name_id</span><span class=p>)</span>
+        <span class=k>return</span> <span class=nb>sorted</span><span class=p>(</span><span class=n>check_name_id_list</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_control_sort_key</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>int</span><span class=p>,</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Fabricate sort key.&quot;&quot;&quot;</span>
+        <span class=n>k1</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>]</span>
+        <span class=n>k2</span> <span class=o>=</span> <span class=nb>int</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>)[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>0</span><span class=p>])</span>
+        <span class=k>if</span> <span class=s1>&#39;.&#39;</span> <span class=ow>in</span> <span class=n>control</span><span class=p>:</span>
+            <span class=n>k3</span> <span class=o>=</span> <span class=nb>int</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;-&#39;</span><span class=p>)[</span><span class=mi>1</span><span class=p>]</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)[</span><span class=mi>1</span><span class=p>])</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=n>k3</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>return</span> <span class=p>(</span><span class=n>k1</span><span class=p>,</span> <span class=n>k2</span><span class=p>,</span> <span class=n>k3</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_oscal_namify</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>control</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rectify parenthesized numbers in controls.&quot;&quot;&quot;</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;(&#39;</span><span class=p>,</span> <span class=s1>&#39;.&#39;</span><span class=p>)</span>
+        <span class=n>control</span> <span class=o>=</span> <span class=n>control</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;)&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>control</span>
+
+    <span class=k>def</span> <span class=nf>_get_set_parameters</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>SetParameter</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get set parameters from spread sheet.&quot;&quot;&quot;</span>
+        <span class=n>set_parameters</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>row</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>row_generator</span><span class=p>():</span>
+            <span class=c1># quit when first row with no goal_id encountered</span>
+            <span class=n>param_id</span><span class=p>,</span> <span class=n>label</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_parameter_name_and_description</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=n>usage</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_parameter_usage</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=n>values</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>get_parameter_values</span><span class=p>(</span><span class=n>row</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>param_id</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>set_parameter</span> <span class=o>=</span> <span class=n>SetParameter</span><span class=p>(</span>
+                <span class=n>param_id</span><span class=o>=</span><span class=n>param_id</span><span class=p>,</span>
+                <span class=n>label</span><span class=o>=</span><span class=n>label</span><span class=p>,</span>
+                <span class=n>usage</span><span class=o>=</span><span class=n>usage</span><span class=p>,</span>
+            <span class=p>)</span>
+            <span class=k>if</span> <span class=n>values</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>set_parameter</span><span class=o>.</span><span class=n>values</span> <span class=o>=</span> <span class=n>values</span>
+            <span class=n>set_parameters</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_parameter</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>set_parameters</span>
+
+    <span class=k>def</span> <span class=nf>_get_profile_title</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get profile title from config.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;profile-title&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;profile-title: </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_get_spread_sheet_url</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get spread sheet url from config.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_config</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;spread-sheet-url&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;spread-sheet-url: </span><span class=si>{</span><span class=n>value</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_report_issues</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Report issues.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>report_issues</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-attributes>Attributes<a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.name class="doc doc-heading"> <code class="highlight language-python"><span class=n>name</span> <span class=o>=</span> <span class=s1>&#39;xlsx-to-oscal-profile&#39;</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.xlsx_helper class="doc doc-heading"> <code class="highlight language-python"><span class=n>xlsx_helper</span> <span class=o>=</span> <span class=n>XlsxHelper</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.xlsx_helper class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-functions>Functions<a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize trestle task xlsx-to-oscal-profile.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>config_object</code> </td> <td> <code><span title=typing.Optional>Optional</span>[<span title=configparser.SectionProxy>SectionProxy</span>]</code> </td> <td> <div class=doc-md-description> <p>Config section associated with the task.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>config_object</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=n>configparser</span><span class=o>.</span><span class=n>SectionProxy</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Initialize trestle task xlsx-to-oscal-profile.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        config_object: Config section associated with the task.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=nb>super</span><span class=p>()</span><span class=o>.</span><span class=fm>__init__</span><span class=p>(</span><span class=n>config_object</span><span class=p>)</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span> <span class=o>=</span> <span class=n>XlsxHelper</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.execute class="doc doc-heading"> <code class="highlight language-python"><span class=n>execute</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.execute class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide an executed outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>execute</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide an executed outcome.&quot;&quot;&quot;</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_execute</span><span class=p>()</span>
+    <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;failure&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.print_info class="doc doc-heading"> <code class="highlight language-python"><span class=n>print_info</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.print_info class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Print the help string.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>print_info</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Print the help string.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>xlsx_helper</span><span class=o>.</span><span class=n>print_info</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>name</span><span class=p>,</span> <span class=s1>&#39;profile&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.set_timestamp class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_timestamp</span><span class=p>(</span><span class=n>timestamp</span><span class=p>)</span></code> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.set_timestamp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set the timestamp.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_timestamp</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set the timestamp.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.simulate class="doc doc-heading"> <code class="highlight language-python"><span class=n>simulate</span><span class=p>()</span></code> <a href=#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.simulate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Provide a simulated outcome.</p> <details class=quote> <summary>Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>simulate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TaskOutcome</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Provide a simulated outcome.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>TaskOutcome</span><span class=p>(</span><span class=s1>&#39;simulated-success&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.tasks.xlsx_to_oscal_profile-functions>Functions<a href=#trestle.tasks.xlsx_to_oscal_profile-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/transforms/implementations/osco/index.html b/latest/reference/API/trestle/transforms/implementations/osco/index.html
new file mode 100644
index 000000000..f3300167f
--- /dev/null
+++ b/latest/reference/API/trestle/transforms/implementations/osco/index.html
@@ -0,0 +1,669 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.transforms.implementations.osco module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/implementations/osco/ rel=canonical><link href=../../transformer_singleton/ rel=prev><link href=../tanium/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.transforms.implementations.osco - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.transforms.implementations.osco - Compliance Trestle"><meta property=og:description content="Documentation for trestle.transforms.implementations.osco module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/implementations/osco.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/implementations/osco/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.transforms.implementations.osco - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.transforms.implementations.osco module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/implementations/osco.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.transforms.implementations.osco class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6 checked> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5 checked> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco class=md-nav__link> <span class=md-ellipsis> osco </span> </a> <nav class=md-nav aria-label=osco> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer class=md-nav__link> <span class=md-ellipsis> OscalProfileToOscoProfileTransformer </span> </a> <nav class=md-nav aria-label=OscalProfileToOscoProfileTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer class=md-nav__link> <span class=md-ellipsis> OscoResultToOscalARTransformer </span> </a> <nav class=md-nav aria-label=OscoResultToOscalARTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.analysis class=md-nav__link> <span class=md-ellipsis> analysis </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.checking class=md-nav__link> <span class=md-ellipsis> checking </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.set_modes class=md-nav__link> <span class=md-ellipsis> set_modes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoTransformer class=md-nav__link> <span class=md-ellipsis> OscoTransformer </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse class=md-nav__link> <span class=md-ellipsis> RuleUse </span> </a> <nav class=md-nav aria-label=RuleUse> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.benchmark_href class=md-nav__link> <span class=md-ellipsis> benchmark_href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.benchmark_id class=md-nav__link> <span class=md-ellipsis> benchmark_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.host_name class=md-nav__link> <span class=md-ellipsis> host_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.id_ class=md-nav__link> <span class=md-ellipsis> id_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.idref class=md-nav__link> <span class=md-ellipsis> idref </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.inventory_key class=md-nav__link> <span class=md-ellipsis> inventory_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.result class=md-nav__link> <span class=md-ellipsis> result </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.scanner_name class=md-nav__link> <span class=md-ellipsis> scanner_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.scanner_version class=md-nav__link> <span class=md-ellipsis> scanner_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.severity class=md-nav__link> <span class=md-ellipsis> severity </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.target class=md-nav__link> <span class=md-ellipsis> target </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.target_type class=md-nav__link> <span class=md-ellipsis> target_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.time class=md-nav__link> <span class=md-ellipsis> time </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.weight class=md-nav__link> <span class=md-ellipsis> weight </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco class=md-nav__link> <span class=md-ellipsis> osco </span> </a> <nav class=md-nav aria-label=osco> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer class=md-nav__link> <span class=md-ellipsis> OscalProfileToOscoProfileTransformer </span> </a> <nav class=md-nav aria-label=OscalProfileToOscoProfileTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer class=md-nav__link> <span class=md-ellipsis> OscoResultToOscalARTransformer </span> </a> <nav class=md-nav aria-label=OscoResultToOscalARTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.analysis class=md-nav__link> <span class=md-ellipsis> analysis </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.checking class=md-nav__link> <span class=md-ellipsis> checking </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.set_modes class=md-nav__link> <span class=md-ellipsis> set_modes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.OscoTransformer class=md-nav__link> <span class=md-ellipsis> OscoTransformer </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse class=md-nav__link> <span class=md-ellipsis> RuleUse </span> </a> <nav class=md-nav aria-label=RuleUse> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.benchmark_href class=md-nav__link> <span class=md-ellipsis> benchmark_href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.benchmark_id class=md-nav__link> <span class=md-ellipsis> benchmark_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.host_name class=md-nav__link> <span class=md-ellipsis> host_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.id_ class=md-nav__link> <span class=md-ellipsis> id_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.idref class=md-nav__link> <span class=md-ellipsis> idref </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.inventory_key class=md-nav__link> <span class=md-ellipsis> inventory_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.result class=md-nav__link> <span class=md-ellipsis> result </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.scanner_name class=md-nav__link> <span class=md-ellipsis> scanner_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.scanner_version class=md-nav__link> <span class=md-ellipsis> scanner_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.severity class=md-nav__link> <span class=md-ellipsis> severity </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.target class=md-nav__link> <span class=md-ellipsis> target </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.target_type class=md-nav__link> <span class=md-ellipsis> target_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.time class=md-nav__link> <span class=md-ellipsis> time </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.weight class=md-nav__link> <span class=md-ellipsis> weight </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco.RuleUse.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.osco-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.transforms.implementations.osco</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.transforms.implementations.osco class="doc doc-heading"> <code>trestle.transforms.implementations.osco</code> <a href=#trestle.transforms.implementations.osco class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Facilitate OSCAL-OSCO transformation.</p> <div class="doc doc-children"> <h3 id=trestle.transforms.implementations.osco-attributes>Attributes<a href=#trestle.transforms.implementations.osco-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.transforms.implementations.osco.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.transforms.implementations.osco-classes>Classes<a href=#trestle.transforms.implementations.osco-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer class="doc doc-heading"> <code>OscalProfileToOscoProfileTransformer</code> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.transformer_factory.FromOscalTransformer href=../../transformer_factory/#trestle.transforms.transformer_factory.FromOscalTransformer>FromOscalTransformer</a></code></p> <p>Interface for Oscal Profile to Osco Profile transformer.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span>
+<span class=normal>641</span>
+<span class=normal>642</span>
+<span class=normal>643</span>
+<span class=normal>644</span>
+<span class=normal>645</span>
+<span class=normal>646</span>
+<span class=normal>647</span>
+<span class=normal>648</span>
+<span class=normal>649</span>
+<span class=normal>650</span>
+<span class=normal>651</span>
+<span class=normal>652</span>
+<span class=normal>653</span>
+<span class=normal>654</span>
+<span class=normal>655</span>
+<span class=normal>656</span>
+<span class=normal>657</span>
+<span class=normal>658</span>
+<span class=normal>659</span>
+<span class=normal>660</span>
+<span class=normal>661</span>
+<span class=normal>662</span>
+<span class=normal>663</span>
+<span class=normal>664</span>
+<span class=normal>665</span>
+<span class=normal>666</span>
+<span class=normal>667</span>
+<span class=normal>668</span>
+<span class=normal>669</span>
+<span class=normal>670</span>
+<span class=normal>671</span>
+<span class=normal>672</span>
+<span class=normal>673</span>
+<span class=normal>674</span>
+<span class=normal>675</span>
+<span class=normal>676</span>
+<span class=normal>677</span>
+<span class=normal>678</span>
+<span class=normal>679</span>
+<span class=normal>680</span>
+<span class=normal>681</span>
+<span class=normal>682</span>
+<span class=normal>683</span>
+<span class=normal>684</span>
+<span class=normal>685</span>
+<span class=normal>686</span>
+<span class=normal>687</span>
+<span class=normal>688</span>
+<span class=normal>689</span>
+<span class=normal>690</span>
+<span class=normal>691</span>
+<span class=normal>692</span>
+<span class=normal>693</span>
+<span class=normal>694</span>
+<span class=normal>695</span>
+<span class=normal>696</span>
+<span class=normal>697</span>
+<span class=normal>698</span>
+<span class=normal>699</span>
+<span class=normal>700</span>
+<span class=normal>701</span>
+<span class=normal>702</span>
+<span class=normal>703</span>
+<span class=normal>704</span>
+<span class=normal>705</span>
+<span class=normal>706</span>
+<span class=normal>707</span>
+<span class=normal>708</span>
+<span class=normal>709</span>
+<span class=normal>710</span>
+<span class=normal>711</span>
+<span class=normal>712</span>
+<span class=normal>713</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OscalProfileToOscoProfileTransformer</span><span class=p>(</span><span class=n>FromOscalTransformer</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Interface for Oscal Profile to Osco Profile transformer.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>extends</span><span class=o>=</span><span class=s1>&#39;ocp4-cis-node&#39;</span><span class=p>,</span>
+        <span class=n>api_version</span><span class=o>=</span><span class=s1>&#39;compliance.openshift.io/v1alpha1&#39;</span><span class=p>,</span>
+        <span class=n>kind</span><span class=o>=</span><span class=s1>&#39;TailoredProfile&#39;</span><span class=p>,</span>
+        <span class=n>name</span><span class=o>=</span><span class=s1>&#39;customized-tailored-profile&#39;</span><span class=p>,</span>
+        <span class=n>namespace</span><span class=o>=</span><span class=s1>&#39;openshift-compliance&#39;</span><span class=p>,</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_extends</span> <span class=o>=</span> <span class=n>extends</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_api_version</span> <span class=o>=</span> <span class=n>api_version</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_kind</span> <span class=o>=</span> <span class=n>kind</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_name</span> <span class=o>=</span> <span class=n>name</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_namespace</span> <span class=o>=</span> <span class=n>namespace</span>
+
+    <span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>profile</span><span class=p>:</span> <span class=n>Profile</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Transform the Profile into a OSCO yaml.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span> <span class=o>=</span> <span class=n>profile</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_osco_version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_normalized_version</span><span class=p>(</span><span class=s1>&#39;osco_version&#39;</span><span class=p>,</span> <span class=s1>&#39;0.1.46&#39;</span><span class=p>)</span>
+        <span class=c1># set values</span>
+        <span class=n>set_values</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_set_values</span><span class=p>()</span>
+        <span class=c1># spec</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_osco_version</span> <span class=o>&lt;</span> <span class=p>(</span><span class=mi>0</span><span class=p>,</span> <span class=mi>1</span><span class=p>,</span> <span class=mi>40</span><span class=p>):</span>
+            <span class=c1># for versions prior to 0.1.40, exclude &#39;description&#39;</span>
+            <span class=n>spec</span> <span class=o>=</span> <span class=p>{</span>
+                <span class=s1>&#39;extends&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_metadata_prop_value</span><span class=p>(</span><span class=s1>&#39;base_profile_mnemonic&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_extends</span><span class=p>),</span>
+                <span class=s1>&#39;title&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=p>,</span>
+                <span class=s1>&#39;setValues&#39;</span><span class=p>:</span> <span class=n>set_values</span><span class=p>,</span>
+            <span class=p>}</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># for versions 0.1.40 and beyond, include &#39;description&#39;</span>
+            <span class=n>spec</span> <span class=o>=</span> <span class=p>{</span>
+                <span class=s1>&#39;description&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_metadata_prop_value</span><span class=p>(</span><span class=s1>&#39;profile_mnemonic&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_name</span><span class=p>),</span>
+                <span class=s1>&#39;extends&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_metadata_prop_value</span><span class=p>(</span><span class=s1>&#39;base_profile_mnemonic&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_extends</span><span class=p>),</span>
+                <span class=s1>&#39;title&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=p>,</span>
+                <span class=s1>&#39;setValues&#39;</span><span class=p>:</span> <span class=n>set_values</span><span class=p>,</span>
+            <span class=p>}</span>
+        <span class=n>disable_rules</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_disable_rules</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>disable_rules</span><span class=p>:</span>
+            <span class=n>spec</span><span class=p>[</span><span class=s1>&#39;disableRules&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>disable_rules</span>
+        <span class=c1># yaml data</span>
+        <span class=n>ydata</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=s1>&#39;apiVersion&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_api_version</span><span class=p>,</span>
+            <span class=s1>&#39;kind&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_kind</span><span class=p>,</span>
+            <span class=s1>&#39;metadata&#39;</span><span class=p>:</span> <span class=p>{</span>
+                <span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_metadata_prop_value</span><span class=p>(</span><span class=s1>&#39;profile_mnemonic&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_name</span><span class=p>),</span>
+                <span class=s1>&#39;namespace&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_namespace</span><span class=p>,</span>
+            <span class=p>},</span>
+            <span class=s1>&#39;spec&#39;</span><span class=p>:</span> <span class=n>spec</span><span class=p>,</span>
+        <span class=p>}</span>
+        <span class=k>return</span> <span class=n>json</span><span class=o>.</span><span class=n>dumps</span><span class=p>(</span><span class=n>ydata</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_normalized_version</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>prop_name</span><span class=p>,</span> <span class=n>prop_default</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Tuple</span><span class=p>[</span><span class=nb>int</span><span class=p>,</span> <span class=nb>int</span><span class=p>,</span> <span class=nb>int</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get normalized version.</span>
+
+<span class=sd>        Normalize the &quot;x.y.z&quot; string value to an integer: 1,000,000*x + 1,000*y + z.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=n>vparts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_metadata_prop_value</span><span class=p>(</span><span class=n>prop_name</span><span class=p>,</span> <span class=n>prop_default</span><span class=p>)</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+            <span class=n>normalized_version</span> <span class=o>=</span> <span class=p>(</span><span class=nb>int</span><span class=p>(</span><span class=n>vparts</span><span class=p>[</span><span class=mi>0</span><span class=p>]),</span> <span class=nb>int</span><span class=p>(</span><span class=n>vparts</span><span class=p>[</span><span class=mi>1</span><span class=p>]),</span> <span class=nb>int</span><span class=p>(</span><span class=n>vparts</span><span class=p>[</span><span class=mi>2</span><span class=p>]))</span>
+        <span class=k>except</span> <span class=ne>Exception</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>warning</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;metadata prop name=</span><span class=si>{</span><span class=n>prop_name</span><span class=si>}</span><span class=s1> value error&#39;</span><span class=p>)</span>
+            <span class=n>vparts</span> <span class=o>=</span> <span class=n>prop_default</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;.&#39;</span><span class=p>)</span>
+            <span class=n>normalized_version</span> <span class=o>=</span> <span class=p>(</span><span class=nb>int</span><span class=p>(</span><span class=n>vparts</span><span class=p>[</span><span class=mi>0</span><span class=p>]),</span> <span class=nb>int</span><span class=p>(</span><span class=n>vparts</span><span class=p>[</span><span class=mi>1</span><span class=p>]),</span> <span class=nb>int</span><span class=p>(</span><span class=n>vparts</span><span class=p>[</span><span class=mi>2</span><span class=p>]))</span>
+        <span class=k>return</span> <span class=n>normalized_version</span>
+
+    <span class=k>def</span> <span class=nf>_get_set_values</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Dict</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Extract set_paramater name/value pairs from profile.&quot;&quot;&quot;</span>
+        <span class=n>set_values</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># for check versions prior to 0.1.59 include parameters</span>
+        <span class=c1># for later versions parameters should not be specified, caveat emptor</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>modify</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>set_parameter</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>modify</span><span class=o>.</span><span class=n>set_parameters</span><span class=p>):</span>
+                <span class=n>name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_format_osco_rule_name</span><span class=p>(</span><span class=n>set_parameter</span><span class=o>.</span><span class=n>param_id</span><span class=p>)</span>
+                <span class=n>parameter_value</span> <span class=o>=</span> <span class=n>set_parameter</span><span class=o>.</span><span class=n>values</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+                <span class=n>value</span> <span class=o>=</span> <span class=n>parameter_value</span>
+                <span class=n>rationale</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_rationale_for_set_value</span><span class=p>()</span>
+                <span class=n>set_value</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>name</span><span class=p>,</span> <span class=s1>&#39;value&#39;</span><span class=p>:</span> <span class=n>value</span><span class=p>,</span> <span class=s1>&#39;rationale&#39;</span><span class=p>:</span> <span class=n>rationale</span><span class=p>}</span>
+                <span class=n>set_values</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>set_value</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>set_values</span>
+
+    <span class=k>def</span> <span class=nf>_format_osco_rule_name</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Format for OSCO.</span>
+
+<span class=sd>        1. remove prefix xccdf_org.ssgproject.content_rule_</span>
+<span class=sd>        2. change underscores to dashes</span>
+<span class=sd>        3. add prefix ocp4-</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>normalized_name</span> <span class=o>=</span> <span class=n>name</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;xccdf_org.ssgproject.content_rule_&#39;</span><span class=p>,</span> <span class=s1>&#39;&#39;</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=s1>&#39;_&#39;</span><span class=p>,</span> <span class=s1>&#39;-&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>normalized_name</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;ocp4-&#39;</span><span class=p>):</span>
+            <span class=n>normalized_name</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;ocp4-</span><span class=si>{</span><span class=n>normalized_name</span><span class=si>}</span><span class=s1>&#39;</span>
+        <span class=k>return</span> <span class=n>normalized_name</span>
+
+    <span class=k>def</span> <span class=nf>_get_metadata_prop_value</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>default_</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Extract metadata prop or else default if not present.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+            <span class=k>if</span> <span class=n>prop</span><span class=o>.</span><span class=n>name</span> <span class=o>==</span> <span class=n>name</span><span class=p>:</span>
+                <span class=k>return</span> <span class=n>prop</span><span class=o>.</span><span class=n>value</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>info</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;using default: </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1> = </span><span class=si>{</span><span class=n>default_</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>default_</span>
+
+    <span class=k>def</span> <span class=nf>_get_disable_rules</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Extract disabled rules.&quot;&quot;&quot;</span>
+        <span class=n>value</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>_import</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>imports</span><span class=p>):</span>
+            <span class=k>for</span> <span class=n>control</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>_import</span><span class=o>.</span><span class=n>exclude_controls</span><span class=p>):</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_add_disable_rules_for_control</span><span class=p>(</span><span class=n>value</span><span class=p>,</span> <span class=n>control</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>value</span>
+
+    <span class=k>def</span> <span class=nf>_add_disable_rules_for_control</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>control</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Extract disabled rules for control.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>with_id</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>control</span><span class=o>.</span><span class=n>with_ids</span><span class=p>):</span>
+            <span class=n>name</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_format_osco_rule_name</span><span class=p>(</span><span class=n>with_id</span><span class=o>.</span><span class=n>__root__</span><span class=p>)</span>
+            <span class=n>rationale</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_rationale_for_disable_rule</span><span class=p>()</span>
+            <span class=n>entry</span> <span class=o>=</span> <span class=p>{</span><span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=n>name</span><span class=p>,</span> <span class=s1>&#39;rationale&#39;</span><span class=p>:</span> <span class=n>rationale</span><span class=p>}</span>
+            <span class=n>value</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>entry</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_get_rationale_for_set_value</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rationale for set value.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=s1>&#39;not determinable from specification&#39;</span>
+
+    <span class=k>def</span> <span class=nf>_get_rationale_for_disable_rule</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Rationale for disable rule.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=s1>&#39;not determinable from specification&#39;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer-functions>Functions<a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>extends</span><span class=o>=</span><span class=s1>&#39;ocp4-cis-node&#39;</span><span class=p>,</span> <span class=n>api_version</span><span class=o>=</span><span class=s1>&#39;compliance.openshift.io/v1alpha1&#39;</span><span class=p>,</span> <span class=n>kind</span><span class=o>=</span><span class=s1>&#39;TailoredProfile&#39;</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;customized-tailored-profile&#39;</span><span class=p>,</span> <span class=n>namespace</span><span class=o>=</span><span class=s1>&#39;openshift-compliance&#39;</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>extends</span><span class=o>=</span><span class=s1>&#39;ocp4-cis-node&#39;</span><span class=p>,</span>
+    <span class=n>api_version</span><span class=o>=</span><span class=s1>&#39;compliance.openshift.io/v1alpha1&#39;</span><span class=p>,</span>
+    <span class=n>kind</span><span class=o>=</span><span class=s1>&#39;TailoredProfile&#39;</span><span class=p>,</span>
+    <span class=n>name</span><span class=o>=</span><span class=s1>&#39;customized-tailored-profile&#39;</span><span class=p>,</span>
+    <span class=n>namespace</span><span class=o>=</span><span class=s1>&#39;openshift-compliance&#39;</span><span class=p>,</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_extends</span> <span class=o>=</span> <span class=n>extends</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_api_version</span> <span class=o>=</span> <span class=n>api_version</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_kind</span> <span class=o>=</span> <span class=n>kind</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_name</span> <span class=o>=</span> <span class=n>name</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_namespace</span> <span class=o>=</span> <span class=n>namespace</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.transform class="doc doc-heading"> <code class="highlight language-python"><span class=n>transform</span><span class=p>(</span><span class=n>profile</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.transform class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Transform the Profile into a OSCO yaml.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span>
+<span class=normal>614</span>
+<span class=normal>615</span>
+<span class=normal>616</span>
+<span class=normal>617</span>
+<span class=normal>618</span>
+<span class=normal>619</span>
+<span class=normal>620</span>
+<span class=normal>621</span>
+<span class=normal>622</span>
+<span class=normal>623</span>
+<span class=normal>624</span>
+<span class=normal>625</span>
+<span class=normal>626</span>
+<span class=normal>627</span>
+<span class=normal>628</span>
+<span class=normal>629</span>
+<span class=normal>630</span>
+<span class=normal>631</span>
+<span class=normal>632</span>
+<span class=normal>633</span>
+<span class=normal>634</span>
+<span class=normal>635</span>
+<span class=normal>636</span>
+<span class=normal>637</span>
+<span class=normal>638</span>
+<span class=normal>639</span>
+<span class=normal>640</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>profile</span><span class=p>:</span> <span class=n>Profile</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transform the Profile into a OSCO yaml.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span> <span class=o>=</span> <span class=n>profile</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_osco_version</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_normalized_version</span><span class=p>(</span><span class=s1>&#39;osco_version&#39;</span><span class=p>,</span> <span class=s1>&#39;0.1.46&#39;</span><span class=p>)</span>
+    <span class=c1># set values</span>
+    <span class=n>set_values</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_set_values</span><span class=p>()</span>
+    <span class=c1># spec</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_osco_version</span> <span class=o>&lt;</span> <span class=p>(</span><span class=mi>0</span><span class=p>,</span> <span class=mi>1</span><span class=p>,</span> <span class=mi>40</span><span class=p>):</span>
+        <span class=c1># for versions prior to 0.1.40, exclude &#39;description&#39;</span>
+        <span class=n>spec</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=s1>&#39;extends&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_metadata_prop_value</span><span class=p>(</span><span class=s1>&#39;base_profile_mnemonic&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_extends</span><span class=p>),</span>
+            <span class=s1>&#39;title&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=p>,</span>
+            <span class=s1>&#39;setValues&#39;</span><span class=p>:</span> <span class=n>set_values</span><span class=p>,</span>
+        <span class=p>}</span>
+    <span class=k>else</span><span class=p>:</span>
+        <span class=c1># for versions 0.1.40 and beyond, include &#39;description&#39;</span>
+        <span class=n>spec</span> <span class=o>=</span> <span class=p>{</span>
+            <span class=s1>&#39;description&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_metadata_prop_value</span><span class=p>(</span><span class=s1>&#39;profile_mnemonic&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_name</span><span class=p>),</span>
+            <span class=s1>&#39;extends&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_metadata_prop_value</span><span class=p>(</span><span class=s1>&#39;base_profile_mnemonic&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_extends</span><span class=p>),</span>
+            <span class=s1>&#39;title&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_profile</span><span class=o>.</span><span class=n>metadata</span><span class=o>.</span><span class=n>title</span><span class=p>,</span>
+            <span class=s1>&#39;setValues&#39;</span><span class=p>:</span> <span class=n>set_values</span><span class=p>,</span>
+        <span class=p>}</span>
+    <span class=n>disable_rules</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_disable_rules</span><span class=p>()</span>
+    <span class=k>if</span> <span class=n>disable_rules</span><span class=p>:</span>
+        <span class=n>spec</span><span class=p>[</span><span class=s1>&#39;disableRules&#39;</span><span class=p>]</span> <span class=o>=</span> <span class=n>disable_rules</span>
+    <span class=c1># yaml data</span>
+    <span class=n>ydata</span> <span class=o>=</span> <span class=p>{</span>
+        <span class=s1>&#39;apiVersion&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_api_version</span><span class=p>,</span>
+        <span class=s1>&#39;kind&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_kind</span><span class=p>,</span>
+        <span class=s1>&#39;metadata&#39;</span><span class=p>:</span> <span class=p>{</span>
+            <span class=s1>&#39;name&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_metadata_prop_value</span><span class=p>(</span><span class=s1>&#39;profile_mnemonic&#39;</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_name</span><span class=p>),</span>
+            <span class=s1>&#39;namespace&#39;</span><span class=p>:</span> <span class=bp>self</span><span class=o>.</span><span class=n>_namespace</span><span class=p>,</span>
+        <span class=p>},</span>
+        <span class=s1>&#39;spec&#39;</span><span class=p>:</span> <span class=n>spec</span><span class=p>,</span>
+    <span class=p>}</span>
+    <span class=k>return</span> <span class=n>json</span><span class=o>.</span><span class=n>dumps</span><span class=p>(</span><span class=n>ydata</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.osco.OscoResultToOscalARTransformer class="doc doc-heading"> <code>OscoResultToOscalARTransformer</code> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.transformer_factory.ResultsTransformer href=../../transformer_factory/#trestle.transforms.transformer_factory.ResultsTransformer>ResultsTransformer</a></code></p> <p>Interface for Osco transformer.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OscoResultToOscalARTransformer</span><span class=p>(</span><span class=n>ResultsTransformer</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Interface for Osco transformer.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>analysis</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Analysis.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>analysis</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>checking</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return checking.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;checking&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>set_modes</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>modes</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Keep modes info.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>modes</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=n>modes</span>
+
+    <span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Transform the blob into a Results.</span>
+
+<span class=sd>        The expected blob is a string that is one of:</span>
+<span class=sd>            - data from OpenShift Compliance Operator (json, yaml, xml)</span>
+<span class=sd>            - data from Auditree OSCO fetcher/check (json)</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span> <span class=o>=</span> <span class=n>_OscalResultsFactory</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get_timestamp</span><span class=p>(),</span> <span class=bp>self</span><span class=o>.</span><span class=n>checking</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_xml</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_json</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_yaml</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+
+    <span class=k>def</span> <span class=nf>_ingest_xml</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ingest xml data.&quot;&quot;&quot;</span>
+        <span class=c1># ?xml data</span>
+        <span class=k>if</span> <span class=n>blob</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;&lt;?xml&#39;</span><span class=p>):</span>
+            <span class=n>resource</span> <span class=o>=</span> <span class=n>blob</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>ingest_xml</span><span class=p>(</span><span class=n>resource</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=n>Results</span><span class=p>()</span>
+        <span class=n>results</span><span class=o>.</span><span class=n>__root__</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>result</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+
+    <span class=k>def</span> <span class=nf>_ingest_json</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ingest json data.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=c1># ? configmaps or auditree data</span>
+            <span class=n>jdata</span> <span class=o>=</span> <span class=n>json</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+            <span class=c1># https://docs.openshift.com/container-platform/3.7/rest_api/api/v1.ConfigMap.html#Get-api-v1-namespaces-namespace-configmaps-name</span>
+            <span class=k>if</span> <span class=s1>&#39;kind&#39;</span> <span class=ow>in</span> <span class=n>jdata</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=ow>and</span> <span class=n>jdata</span><span class=p>[</span><span class=s1>&#39;kind&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;ConfigMapList&#39;</span> <span class=ow>and</span> <span class=s1>&#39;items&#39;</span> <span class=ow>in</span> <span class=n>jdata</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=n>items</span> <span class=o>=</span> <span class=n>jdata</span><span class=p>[</span><span class=s1>&#39;items&#39;</span><span class=p>]</span>
+                <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>items</span><span class=p>:</span>
+                    <span class=k>if</span> <span class=s1>&#39;data&#39;</span> <span class=ow>in</span> <span class=n>item</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                        <span class=n>data</span> <span class=o>=</span> <span class=n>item</span><span class=p>[</span><span class=s1>&#39;data&#39;</span><span class=p>]</span>
+                        <span class=k>if</span> <span class=s1>&#39;results&#39;</span> <span class=ow>in</span> <span class=n>data</span><span class=p>:</span>
+                            <span class=n>resource</span> <span class=o>=</span> <span class=n>item</span>
+                            <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>ingest</span><span class=p>(</span><span class=n>resource</span><span class=p>)</span>
+            <span class=c1># https://github.com/ComplianceAsCode/auditree-arboretum/blob/main/arboretum/kubernetes/fetchers/fetch_cluster_resource.py</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>jdata</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>jdata</span><span class=p>[</span><span class=n>key</span><span class=p>]:</span>
+                        <span class=k>for</span> <span class=n>cluster</span> <span class=ow>in</span> <span class=n>jdata</span><span class=p>[</span><span class=n>key</span><span class=p>][</span><span class=n>group</span><span class=p>]:</span>
+                            <span class=k>if</span> <span class=s1>&#39;resources&#39;</span> <span class=ow>in</span> <span class=n>cluster</span><span class=p>:</span>
+                                <span class=k>for</span> <span class=n>resource</span> <span class=ow>in</span> <span class=n>cluster</span><span class=p>[</span><span class=s1>&#39;resources&#39;</span><span class=p>]:</span>
+                                    <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>ingest</span><span class=p>(</span><span class=n>resource</span><span class=p>)</span>
+        <span class=k>except</span> <span class=n>json</span><span class=o>.</span><span class=n>decoder</span><span class=o>.</span><span class=n>JSONDecodeError</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=n>Results</span><span class=p>()</span>
+        <span class=n>results</span><span class=o>.</span><span class=n>__root__</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>result</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+
+    <span class=k>def</span> <span class=nf>_ingest_yaml</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ingest yaml data.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=c1># ? yaml data</span>
+            <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+            <span class=n>resource</span> <span class=o>=</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>ingest</span><span class=p>(</span><span class=n>resource</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>e</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=n>Results</span><span class=p>()</span>
+        <span class=n>results</span><span class=o>.</span><span class=n>__root__</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>result</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-attributes>Attributes<a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.analysis class="doc doc-heading"> <code class="highlight language-python"><span class=n>analysis</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.analysis class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Analysis.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.checking class="doc doc-heading"> <code class="highlight language-python"><span class=n>checking</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.checking class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return checking.</p> </div> </div> <h5 id=trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-functions>Functions<a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.set_modes class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_modes</span><span class=p>(</span><span class=n>modes</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.set_modes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Keep modes info.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_modes</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>modes</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Keep modes info.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>modes</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=n>modes</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.transform class="doc doc-heading"> <code class="highlight language-python"><span class=n>transform</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.transform class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Transform the blob into a Results.</p> <details class=the-expected-blob-is-a-string-that-is-one-of open> <summary>The expected blob is a string that is one of</summary> <ul> <li>data from OpenShift Compliance Operator (json, yaml, xml)</li> <li>data from Auditree OSCO fetcher/check (json)</li> </ul> </details> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transform the blob into a Results.</span>
+
+<span class=sd>    The expected blob is a string that is one of:</span>
+<span class=sd>        - data from OpenShift Compliance Operator (json, yaml, xml)</span>
+<span class=sd>        - data from Auditree OSCO fetcher/check (json)</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>results</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span> <span class=o>=</span> <span class=n>_OscalResultsFactory</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get_timestamp</span><span class=p>(),</span> <span class=bp>self</span><span class=o>.</span><span class=n>checking</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_xml</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_json</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_yaml</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>results</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.osco.OscoTransformer class="doc doc-heading"> <code>OscoTransformer</code> <a href=#trestle.transforms.implementations.osco.OscoTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.implementations.osco.OscoResultToOscalARTransformer href=#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer>OscoResultToOscalARTransformer</a></code></p> <p>Legacy class name.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>149</span>
+<span class=normal>150</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>OscoTransformer</span><span class=p>(</span><span class=n>OscoResultToOscalARTransformer</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Legacy class name.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.osco.RuleUse class="doc doc-heading"> <code>RuleUse</code> <a href=#trestle.transforms.implementations.osco.RuleUse class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Represents one rule of OSCO data.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RuleUse</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Represents one rule of OSCO data.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>id_</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;id_&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>target</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>target_type</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target_type&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>host_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;host_name&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>benchmark_href</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_href&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>benchmark_id</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_id&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>scanner_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_name&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>scanner_version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_version&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>idref</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;idref&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;version&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>time</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;time&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>result</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;result&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>severity</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;severity&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>weight</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;weight&#39;</span><span class=p>]</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>inventory_key</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive inventory key.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>host_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=c1># OpenScap 1.3.3</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>target</span> <span class=o>+</span> <span class=s1>&#39;:&#39;</span> <span class=o>+</span> <span class=bp>self</span><span class=o>.</span><span class=n>target_type</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># OpenScap 1.3.5</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>host_name</span> <span class=o>+</span> <span class=s1>&#39;:&#39;</span> <span class=o>+</span> <span class=bp>self</span><span class=o>.</span><span class=n>target_type</span>
+        <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.implementations.osco.RuleUse-attributes>Attributes<a href=#trestle.transforms.implementations.osco.RuleUse-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.benchmark_href class="doc doc-heading"> <code class="highlight language-python"><span class=n>benchmark_href</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_href&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.benchmark_href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.benchmark_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>benchmark_id</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_id&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.benchmark_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.host_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>host_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;host_name&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.host_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.id_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>id_</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;id_&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.id_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.idref class="doc doc-heading"> <code class="highlight language-python"><span class=n>idref</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;idref&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.idref class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.inventory_key class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory_key</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.inventory_key class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Derive inventory key.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.result class="doc doc-heading"> <code class="highlight language-python"><span class=n>result</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;result&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.result class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.scanner_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>scanner_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_name&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.scanner_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.scanner_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>scanner_version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_version&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.scanner_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.severity class="doc doc-heading"> <code class="highlight language-python"><span class=n>severity</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;severity&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.severity class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.target class="doc doc-heading"> <code class="highlight language-python"><span class=n>target</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.target class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.target_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>target_type</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target_type&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.target_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.time class="doc doc-heading"> <code class="highlight language-python"><span class=n>time</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;time&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.time class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.version class="doc doc-heading"> <code class="highlight language-python"><span class=n>version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;version&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.osco.RuleUse.weight class="doc doc-heading"> <code class="highlight language-python"><span class=n>weight</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;weight&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.osco.RuleUse.weight class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.transforms.implementations.osco.RuleUse-functions>Functions<a href=#trestle.transforms.implementations.osco.RuleUse-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.osco.RuleUse.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>args</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.osco.RuleUse.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize given specified args.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/osco.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>id_</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;id_&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>target</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>target_type</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target_type&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>host_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;host_name&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>benchmark_href</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_href&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>benchmark_id</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_id&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>scanner_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_name&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>scanner_version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_version&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>idref</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;idref&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;version&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>time</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;time&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>result</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;result&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>severity</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;severity&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>weight</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;weight&#39;</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.transforms.implementations.osco-functions>Functions<a href=#trestle.transforms.implementations.osco-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/transforms/implementations/tanium/index.html b/latest/reference/API/trestle/transforms/implementations/tanium/index.html
new file mode 100644
index 000000000..7885aa8eb
--- /dev/null
+++ b/latest/reference/API/trestle/transforms/implementations/tanium/index.html
@@ -0,0 +1,1317 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.transforms.implementations.tanium module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/implementations/tanium/ rel=canonical><link href=../osco/ rel=prev><link href=../xccdf/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.transforms.implementations.tanium - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.transforms.implementations.tanium - Compliance Trestle"><meta property=og:description content="Documentation for trestle.transforms.implementations.tanium module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/implementations/tanium.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/implementations/tanium/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.transforms.implementations.tanium - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.transforms.implementations.tanium module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/implementations/tanium.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.transforms.implementations.tanium class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6 checked> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5 checked> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium class=md-nav__link> <span class=md-ellipsis> tanium </span> </a> <nav class=md-nav aria-label=tanium> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse class=md-nav__link> <span class=md-ellipsis> RuleUse </span> </a> <nav class=md-nav aria-label=RuleUse> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id class=md-nav__link> <span class=md-ellipsis> check_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id_benchmark class=md-nav__link> <span class=md-ellipsis> check_id_benchmark </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id_level class=md-nav__link> <span class=md-ellipsis> check_id_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id_version class=md-nav__link> <span class=md-ellipsis> check_id_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.collected class=md-nav__link> <span class=md-ellipsis> collected </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.component_type class=md-nav__link> <span class=md-ellipsis> component_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.computer_name class=md-nav__link> <span class=md-ellipsis> computer_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.count class=md-nav__link> <span class=md-ellipsis> count </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.ip_address class=md-nav__link> <span class=md-ellipsis> ip_address </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.rule_id class=md-nav__link> <span class=md-ellipsis> rule_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.tanium_client_ip_address class=md-nav__link> <span class=md-ellipsis> tanium_client_ip_address </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.timestamp class=md-nav__link> <span class=md-ellipsis> timestamp </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory class=md-nav__link> <span class=md-ellipsis> RuleUseFactory </span> </a> <nav class=md-nav aria-label=RuleUseFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory.make_list class=md-nav__link> <span class=md-ellipsis> make_list </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory class=md-nav__link> <span class=md-ellipsis> TaniumOscalFactory </span> </a> <nav class=md-nav aria-label=TaniumOscalFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.analysis class=md-nav__link> <span class=md-ellipsis> analysis </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.control_selections class=md-nav__link> <span class=md-ellipsis> control_selections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.inventory class=md-nav__link> <span class=md-ellipsis> inventory </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.observations class=md-nav__link> <span class=md-ellipsis> observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.results class=md-nav__link> <span class=md-ellipsis> results </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.reviewed_controls class=md-nav__link> <span class=md-ellipsis> reviewed_controls </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer class=md-nav__link> <span class=md-ellipsis> TaniumResultToOscalARTransformer </span> </a> <nav class=md-nav aria-label=TaniumResultToOscalARTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.aggregate class=md-nav__link> <span class=md-ellipsis> aggregate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.analysis class=md-nav__link> <span class=md-ellipsis> analysis </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.blocksize class=md-nav__link> <span class=md-ellipsis> blocksize </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.caching class=md-nav__link> <span class=md-ellipsis> caching </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.checking class=md-nav__link> <span class=md-ellipsis> checking </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_max class=md-nav__link> <span class=md-ellipsis> cpus_max </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_min class=md-nav__link> <span class=md-ellipsis> cpus_min </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.set_modes class=md-nav__link> <span class=md-ellipsis> set_modes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumTransformer class=md-nav__link> <span class=md-ellipsis> TaniumTransformer </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium class=md-nav__link> <span class=md-ellipsis> tanium </span> </a> <nav class=md-nav aria-label=tanium> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.logger class=md-nav__link> <span class=md-ellipsis> logger </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse class=md-nav__link> <span class=md-ellipsis> RuleUse </span> </a> <nav class=md-nav aria-label=RuleUse> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id class=md-nav__link> <span class=md-ellipsis> check_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id_benchmark class=md-nav__link> <span class=md-ellipsis> check_id_benchmark </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id_level class=md-nav__link> <span class=md-ellipsis> check_id_level </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id_version class=md-nav__link> <span class=md-ellipsis> check_id_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.collected class=md-nav__link> <span class=md-ellipsis> collected </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.component class=md-nav__link> <span class=md-ellipsis> component </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.component_type class=md-nav__link> <span class=md-ellipsis> component_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.computer_name class=md-nav__link> <span class=md-ellipsis> computer_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.count class=md-nav__link> <span class=md-ellipsis> count </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.ip_address class=md-nav__link> <span class=md-ellipsis> ip_address </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.rule_id class=md-nav__link> <span class=md-ellipsis> rule_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.state class=md-nav__link> <span class=md-ellipsis> state </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.tanium_client_ip_address class=md-nav__link> <span class=md-ellipsis> tanium_client_ip_address </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.timestamp class=md-nav__link> <span class=md-ellipsis> timestamp </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUse.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory class=md-nav__link> <span class=md-ellipsis> RuleUseFactory </span> </a> <nav class=md-nav aria-label=RuleUseFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory.make_list class=md-nav__link> <span class=md-ellipsis> make_list </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory class=md-nav__link> <span class=md-ellipsis> TaniumOscalFactory </span> </a> <nav class=md-nav aria-label=TaniumOscalFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.analysis class=md-nav__link> <span class=md-ellipsis> analysis </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.components class=md-nav__link> <span class=md-ellipsis> components </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.control_selections class=md-nav__link> <span class=md-ellipsis> control_selections </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.inventory class=md-nav__link> <span class=md-ellipsis> inventory </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.observations class=md-nav__link> <span class=md-ellipsis> observations </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.results class=md-nav__link> <span class=md-ellipsis> results </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.reviewed_controls class=md-nav__link> <span class=md-ellipsis> reviewed_controls </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer class=md-nav__link> <span class=md-ellipsis> TaniumResultToOscalARTransformer </span> </a> <nav class=md-nav aria-label=TaniumResultToOscalARTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.aggregate class=md-nav__link> <span class=md-ellipsis> aggregate </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.analysis class=md-nav__link> <span class=md-ellipsis> analysis </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.blocksize class=md-nav__link> <span class=md-ellipsis> blocksize </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.caching class=md-nav__link> <span class=md-ellipsis> caching </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.checking class=md-nav__link> <span class=md-ellipsis> checking </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_max class=md-nav__link> <span class=md-ellipsis> cpus_max </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_min class=md-nav__link> <span class=md-ellipsis> cpus_min </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.set_modes class=md-nav__link> <span class=md-ellipsis> set_modes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium.TaniumTransformer class=md-nav__link> <span class=md-ellipsis> TaniumTransformer </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.tanium-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.transforms.implementations.tanium</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.transforms.implementations.tanium class="doc doc-heading"> <code>trestle.transforms.implementations.tanium</code> <a href=#trestle.transforms.implementations.tanium class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Facilitate Tanium result to NIST OSCAL transformation.</p> <div class="doc doc-children"> <h3 id=trestle.transforms.implementations.tanium-attributes>Attributes<a href=#trestle.transforms.implementations.tanium-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.transforms.implementations.tanium.logger class="doc doc-heading"> <code class="highlight language-python"><span class=n>logger</span> <span class=o>=</span> <span class=n>logging</span><span class=o>.</span><span class=n>getLogger</span><span class=p>(</span><span class=vm>__name__</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.logger class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.transforms.implementations.tanium-classes>Classes<a href=#trestle.transforms.implementations.tanium-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.tanium.RuleUse class="doc doc-heading"> <code>RuleUse</code> <a href=#trestle.transforms.implementations.tanium.RuleUse class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Represents one row of Tanium data.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RuleUse</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Represents one row of Tanium data.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>tanium_row</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>comply</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>default_timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;tanium-row: </span><span class=si>{</span><span class=n>tanium_row</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=c1># level 1 keys</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>computer_name</span> <span class=o>=</span> <span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;Computer Name&#39;</span><span class=p>]</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>tanium_client_ip_address</span> <span class=o>=</span> <span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;Tanium Client IP Address&#39;</span><span class=p>]</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>ip_address</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;IP Address&#39;</span><span class=p>])</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>count</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;Count&#39;</span><span class=p>])</span>
+            <span class=c1># comply keys</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>check_id</span> <span class=o>=</span> <span class=n>comply</span><span class=p>[</span><span class=s1>&#39;Check ID&#39;</span><span class=p>]</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>rule_id</span> <span class=o>=</span> <span class=n>comply</span><span class=p>[</span><span class=s1>&#39;Rule ID&#39;</span><span class=p>]</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>state</span> <span class=o>=</span> <span class=n>comply</span><span class=p>[</span><span class=s1>&#39;State&#39;</span><span class=p>]</span>
+            <span class=c1># defaults</span>
+            <span class=n>no_results</span> <span class=o>=</span> <span class=s1>&#39;[no results]&#39;</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>check_id_level</span> <span class=o>=</span> <span class=n>no_results</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>check_id_version</span> <span class=o>=</span> <span class=n>no_results</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>check_id_benchmark</span> <span class=o>=</span> <span class=n>no_results</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>no_results</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>component_type</span> <span class=o>=</span> <span class=n>no_results</span>
+            <span class=c1># parse</span>
+            <span class=k>if</span> <span class=s1>&#39;;&#39;</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>check_id</span><span class=p>:</span>
+                <span class=n>items</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>check_id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;;&#39;</span><span class=p>)</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>items</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>2</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>check_id_level</span> <span class=o>=</span> <span class=n>items</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>items</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>check_id_version</span> <span class=o>=</span> <span class=n>items</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+                <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>items</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>check_id_benchmark</span> <span class=o>=</span> <span class=n>items</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>items</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+                    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>component</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;CIS &#39;</span><span class=p>):</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>component</span><span class=p>[</span><span class=nb>len</span><span class=p>(</span><span class=s1>&#39;CIS &#39;</span><span class=p>):]</span>
+                    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>component</span><span class=o>.</span><span class=n>endswith</span><span class=p>(</span><span class=s1>&#39; Benchmark&#39;</span><span class=p>):</span>
+                        <span class=bp>self</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>component</span><span class=p>[:</span><span class=o>-</span><span class=nb>len</span><span class=p>(</span><span class=s1>&#39; Benchmark&#39;</span><span class=p>)]</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>component_type</span> <span class=o>=</span> <span class=s1>&#39;Operating System&#39;</span>
+            <span class=c1># timestamp</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>timestamp</span> <span class=o>=</span> <span class=n>comply</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;Timestamp&#39;</span><span class=p>,</span> <span class=n>default_timestamp</span><span class=p>)</span>
+            <span class=c1># collected</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>collected</span> <span class=o>=</span> <span class=n>default_timestamp</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;tanium-row: </span><span class=si>{</span><span class=n>tanium_row</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>e</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+            <span class=k>raise</span> <span class=n>e</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.implementations.tanium.RuleUse-attributes>Attributes<a href=#trestle.transforms.implementations.tanium.RuleUse-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.check_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>check_id</span> <span class=o>=</span> <span class=n>comply</span><span class=p>[</span><span class=s1>&#39;Check ID&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.check_id_benchmark class="doc doc-heading"> <code class="highlight language-python"><span class=n>check_id_benchmark</span> <span class=o>=</span> <span class=n>no_results</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id_benchmark class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.check_id_level class="doc doc-heading"> <code class="highlight language-python"><span class=n>check_id_level</span> <span class=o>=</span> <span class=n>no_results</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id_level class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.check_id_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>check_id_version</span> <span class=o>=</span> <span class=n>no_results</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.check_id_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.collected class="doc doc-heading"> <code class="highlight language-python"><span class=n>collected</span> <span class=o>=</span> <span class=n>default_timestamp</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.collected class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.component class="doc doc-heading"> <code class="highlight language-python"><span class=n>component</span> <span class=o>=</span> <span class=n>no_results</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.component class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.component_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>component_type</span> <span class=o>=</span> <span class=n>no_results</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.component_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.computer_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>computer_name</span> <span class=o>=</span> <span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;Computer Name&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.computer_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.count class="doc doc-heading"> <code class="highlight language-python"><span class=n>count</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;Count&#39;</span><span class=p>])</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.count class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.ip_address class="doc doc-heading"> <code class="highlight language-python"><span class=n>ip_address</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;IP Address&#39;</span><span class=p>])</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.ip_address class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.rule_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>rule_id</span> <span class=o>=</span> <span class=n>comply</span><span class=p>[</span><span class=s1>&#39;Rule ID&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.rule_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.state class="doc doc-heading"> <code class="highlight language-python"><span class=n>state</span> <span class=o>=</span> <span class=n>comply</span><span class=p>[</span><span class=s1>&#39;State&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.state class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.tanium_client_ip_address class="doc doc-heading"> <code class="highlight language-python"><span class=n>tanium_client_ip_address</span> <span class=o>=</span> <span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;Tanium Client IP Address&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.tanium_client_ip_address class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.timestamp class="doc doc-heading"> <code class="highlight language-python"><span class=n>timestamp</span> <span class=o>=</span> <span class=n>comply</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;Timestamp&#39;</span><span class=p>,</span> <span class=n>default_timestamp</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.tanium.RuleUse.timestamp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.transforms.implementations.tanium.RuleUse-functions>Functions<a href=#trestle.transforms.implementations.tanium.RuleUse-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.tanium.RuleUse.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>tanium_row</span><span class=p>,</span> <span class=n>comply</span><span class=p>,</span> <span class=n>default_timestamp</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.tanium.RuleUse.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize given specified args.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>tanium_row</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>],</span> <span class=n>comply</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>],</span> <span class=n>default_timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;tanium-row: </span><span class=si>{</span><span class=n>tanium_row</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>try</span><span class=p>:</span>
+        <span class=c1># level 1 keys</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>computer_name</span> <span class=o>=</span> <span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;Computer Name&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>tanium_client_ip_address</span> <span class=o>=</span> <span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;Tanium Client IP Address&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>ip_address</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;IP Address&#39;</span><span class=p>])</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>count</span> <span class=o>=</span> <span class=nb>str</span><span class=p>(</span><span class=n>tanium_row</span><span class=p>[</span><span class=s1>&#39;Count&#39;</span><span class=p>])</span>
+        <span class=c1># comply keys</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>check_id</span> <span class=o>=</span> <span class=n>comply</span><span class=p>[</span><span class=s1>&#39;Check ID&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>rule_id</span> <span class=o>=</span> <span class=n>comply</span><span class=p>[</span><span class=s1>&#39;Rule ID&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>state</span> <span class=o>=</span> <span class=n>comply</span><span class=p>[</span><span class=s1>&#39;State&#39;</span><span class=p>]</span>
+        <span class=c1># defaults</span>
+        <span class=n>no_results</span> <span class=o>=</span> <span class=s1>&#39;[no results]&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>check_id_level</span> <span class=o>=</span> <span class=n>no_results</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>check_id_version</span> <span class=o>=</span> <span class=n>no_results</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>check_id_benchmark</span> <span class=o>=</span> <span class=n>no_results</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>no_results</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>component_type</span> <span class=o>=</span> <span class=n>no_results</span>
+        <span class=c1># parse</span>
+        <span class=k>if</span> <span class=s1>&#39;;&#39;</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>check_id</span><span class=p>:</span>
+            <span class=n>items</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>check_id</span><span class=o>.</span><span class=n>split</span><span class=p>(</span><span class=s1>&#39;;&#39;</span><span class=p>)</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>items</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>2</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>check_id_level</span> <span class=o>=</span> <span class=n>items</span><span class=p>[</span><span class=mi>2</span><span class=p>]</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>items</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>1</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>check_id_version</span> <span class=o>=</span> <span class=n>items</span><span class=p>[</span><span class=mi>1</span><span class=p>]</span>
+            <span class=k>if</span> <span class=nb>len</span><span class=p>(</span><span class=n>items</span><span class=p>)</span> <span class=o>&gt;</span> <span class=mi>0</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>check_id_benchmark</span> <span class=o>=</span> <span class=n>items</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=n>items</span><span class=p>[</span><span class=mi>0</span><span class=p>]</span>
+                <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>component</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;CIS &#39;</span><span class=p>):</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>component</span><span class=p>[</span><span class=nb>len</span><span class=p>(</span><span class=s1>&#39;CIS &#39;</span><span class=p>):]</span>
+                <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>component</span><span class=o>.</span><span class=n>endswith</span><span class=p>(</span><span class=s1>&#39; Benchmark&#39;</span><span class=p>):</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>component</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>component</span><span class=p>[:</span><span class=o>-</span><span class=nb>len</span><span class=p>(</span><span class=s1>&#39; Benchmark&#39;</span><span class=p>)]</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>component_type</span> <span class=o>=</span> <span class=s1>&#39;Operating System&#39;</span>
+        <span class=c1># timestamp</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>timestamp</span> <span class=o>=</span> <span class=n>comply</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;Timestamp&#39;</span><span class=p>,</span> <span class=n>default_timestamp</span><span class=p>)</span>
+        <span class=c1># collected</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>collected</span> <span class=o>=</span> <span class=n>default_timestamp</span>
+    <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;tanium-row: </span><span class=si>{</span><span class=n>tanium_row</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>e</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=n>traceback</span><span class=o>.</span><span class=n>format_exc</span><span class=p>())</span>
+        <span class=k>raise</span> <span class=n>e</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.tanium.RuleUseFactory class="doc doc-heading"> <code>RuleUseFactory</code> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Build RuleUse list.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RuleUseFactory</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Build RuleUse list.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+
+    <span class=k>def</span> <span class=nf>_make_sublist</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>tanium_row</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>RuleUse</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build RuleUse sublist from input data item.&quot;&quot;&quot;</span>
+        <span class=n>retval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>keys</span> <span class=o>=</span> <span class=n>tanium_row</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>keys</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>key</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;Comply&#39;</span><span class=p>):</span>
+                <span class=k>break</span>
+        <span class=n>comply_list</span> <span class=o>=</span> <span class=n>tanium_row</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>comply</span> <span class=ow>in</span> <span class=n>comply_list</span><span class=p>:</span>
+            <span class=n>rule_use</span> <span class=o>=</span> <span class=n>RuleUse</span><span class=p>(</span><span class=n>tanium_row</span><span class=p>,</span> <span class=n>comply</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span><span class=p>)</span>
+            <span class=n>retval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>rule_use</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>retval</span>
+
+    <span class=k>def</span> <span class=nf>make_list</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>RuleUse</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Build RuleUse list from input data.&quot;&quot;&quot;</span>
+        <span class=n>retval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>lines</span> <span class=o>=</span> <span class=n>blob</span><span class=o>.</span><span class=n>splitlines</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>lines</span><span class=p>:</span>
+            <span class=n>line</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+            <span class=k>if</span> <span class=n>line</span><span class=p>:</span>
+                <span class=n>jdata</span> <span class=o>=</span> <span class=n>json</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+                <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>jdata</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>jdata</span><span class=p>:</span>
+                        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;item: </span><span class=si>{</span><span class=n>item</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                        <span class=n>retval</span> <span class=o>+=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_make_sublist</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+                <span class=k>else</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;jdata: </span><span class=si>{</span><span class=n>jdata</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=n>retval</span> <span class=o>+=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_make_sublist</span><span class=p>(</span><span class=n>jdata</span><span class=p>)</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;ru_list: </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>retval</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>retval</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.implementations.tanium.RuleUseFactory-functions>Functions<a href=#trestle.transforms.implementations.tanium.RuleUseFactory-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.tanium.RuleUseFactory.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>timestamp</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize given specified args.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.tanium.RuleUseFactory.make_list class="doc doc-heading"> <code class="highlight language-python"><span class=n>make_list</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.tanium.RuleUseFactory.make_list class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Build RuleUse list from input data.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>make_list</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>RuleUse</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Build RuleUse list from input data.&quot;&quot;&quot;</span>
+    <span class=n>retval</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>lines</span> <span class=o>=</span> <span class=n>blob</span><span class=o>.</span><span class=n>splitlines</span><span class=p>()</span>
+    <span class=k>for</span> <span class=n>line</span> <span class=ow>in</span> <span class=n>lines</span><span class=p>:</span>
+        <span class=n>line</span> <span class=o>=</span> <span class=n>line</span><span class=o>.</span><span class=n>strip</span><span class=p>()</span>
+        <span class=k>if</span> <span class=n>line</span><span class=p>:</span>
+            <span class=n>jdata</span> <span class=o>=</span> <span class=n>json</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>line</span><span class=p>)</span>
+            <span class=k>if</span> <span class=nb>type</span><span class=p>(</span><span class=n>jdata</span><span class=p>)</span> <span class=ow>is</span> <span class=nb>list</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>jdata</span><span class=p>:</span>
+                    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;item: </span><span class=si>{</span><span class=n>item</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                    <span class=n>retval</span> <span class=o>+=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_make_sublist</span><span class=p>(</span><span class=n>item</span><span class=p>)</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;jdata: </span><span class=si>{</span><span class=n>jdata</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+                <span class=n>retval</span> <span class=o>+=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_make_sublist</span><span class=p>(</span><span class=n>jdata</span><span class=p>)</span>
+    <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;ru_list: </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=n>retval</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>retval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.tanium.TaniumOscalFactory class="doc doc-heading"> <code>TaniumOscalFactory</code> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Build Tanium OSCAL entities.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>234</span>
+<span class=normal>235</span>
+<span class=normal>236</span>
+<span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span>
+<span class=normal>275</span>
+<span class=normal>276</span>
+<span class=normal>277</span>
+<span class=normal>278</span>
+<span class=normal>279</span>
+<span class=normal>280</span>
+<span class=normal>281</span>
+<span class=normal>282</span>
+<span class=normal>283</span>
+<span class=normal>284</span>
+<span class=normal>285</span>
+<span class=normal>286</span>
+<span class=normal>287</span>
+<span class=normal>288</span>
+<span class=normal>289</span>
+<span class=normal>290</span>
+<span class=normal>291</span>
+<span class=normal>292</span>
+<span class=normal>293</span>
+<span class=normal>294</span>
+<span class=normal>295</span>
+<span class=normal>296</span>
+<span class=normal>297</span>
+<span class=normal>298</span>
+<span class=normal>299</span>
+<span class=normal>300</span>
+<span class=normal>301</span>
+<span class=normal>302</span>
+<span class=normal>303</span>
+<span class=normal>304</span>
+<span class=normal>305</span>
+<span class=normal>306</span>
+<span class=normal>307</span>
+<span class=normal>308</span>
+<span class=normal>309</span>
+<span class=normal>310</span>
+<span class=normal>311</span>
+<span class=normal>312</span>
+<span class=normal>313</span>
+<span class=normal>314</span>
+<span class=normal>315</span>
+<span class=normal>316</span>
+<span class=normal>317</span>
+<span class=normal>318</span>
+<span class=normal>319</span>
+<span class=normal>320</span>
+<span class=normal>321</span>
+<span class=normal>322</span>
+<span class=normal>323</span>
+<span class=normal>324</span>
+<span class=normal>325</span>
+<span class=normal>326</span>
+<span class=normal>327</span>
+<span class=normal>328</span>
+<span class=normal>329</span>
+<span class=normal>330</span>
+<span class=normal>331</span>
+<span class=normal>332</span>
+<span class=normal>333</span>
+<span class=normal>334</span>
+<span class=normal>335</span>
+<span class=normal>336</span>
+<span class=normal>337</span>
+<span class=normal>338</span>
+<span class=normal>339</span>
+<span class=normal>340</span>
+<span class=normal>341</span>
+<span class=normal>342</span>
+<span class=normal>343</span>
+<span class=normal>344</span>
+<span class=normal>345</span>
+<span class=normal>346</span>
+<span class=normal>347</span>
+<span class=normal>348</span>
+<span class=normal>349</span>
+<span class=normal>350</span>
+<span class=normal>351</span>
+<span class=normal>352</span>
+<span class=normal>353</span>
+<span class=normal>354</span>
+<span class=normal>355</span>
+<span class=normal>356</span>
+<span class=normal>357</span>
+<span class=normal>358</span>
+<span class=normal>359</span>
+<span class=normal>360</span>
+<span class=normal>361</span>
+<span class=normal>362</span>
+<span class=normal>363</span>
+<span class=normal>364</span>
+<span class=normal>365</span>
+<span class=normal>366</span>
+<span class=normal>367</span>
+<span class=normal>368</span>
+<span class=normal>369</span>
+<span class=normal>370</span>
+<span class=normal>371</span>
+<span class=normal>372</span>
+<span class=normal>373</span>
+<span class=normal>374</span>
+<span class=normal>375</span>
+<span class=normal>376</span>
+<span class=normal>377</span>
+<span class=normal>378</span>
+<span class=normal>379</span>
+<span class=normal>380</span>
+<span class=normal>381</span>
+<span class=normal>382</span>
+<span class=normal>383</span>
+<span class=normal>384</span>
+<span class=normal>385</span>
+<span class=normal>386</span>
+<span class=normal>387</span>
+<span class=normal>388</span>
+<span class=normal>389</span>
+<span class=normal>390</span>
+<span class=normal>391</span>
+<span class=normal>392</span>
+<span class=normal>393</span>
+<span class=normal>394</span>
+<span class=normal>395</span>
+<span class=normal>396</span>
+<span class=normal>397</span>
+<span class=normal>398</span>
+<span class=normal>399</span>
+<span class=normal>400</span>
+<span class=normal>401</span>
+<span class=normal>402</span>
+<span class=normal>403</span>
+<span class=normal>404</span>
+<span class=normal>405</span>
+<span class=normal>406</span>
+<span class=normal>407</span>
+<span class=normal>408</span>
+<span class=normal>409</span>
+<span class=normal>410</span>
+<span class=normal>411</span>
+<span class=normal>412</span>
+<span class=normal>413</span>
+<span class=normal>414</span>
+<span class=normal>415</span>
+<span class=normal>416</span>
+<span class=normal>417</span>
+<span class=normal>418</span>
+<span class=normal>419</span>
+<span class=normal>420</span>
+<span class=normal>421</span>
+<span class=normal>422</span>
+<span class=normal>423</span>
+<span class=normal>424</span>
+<span class=normal>425</span>
+<span class=normal>426</span>
+<span class=normal>427</span>
+<span class=normal>428</span>
+<span class=normal>429</span>
+<span class=normal>430</span>
+<span class=normal>431</span>
+<span class=normal>432</span>
+<span class=normal>433</span>
+<span class=normal>434</span>
+<span class=normal>435</span>
+<span class=normal>436</span>
+<span class=normal>437</span>
+<span class=normal>438</span>
+<span class=normal>439</span>
+<span class=normal>440</span>
+<span class=normal>441</span>
+<span class=normal>442</span>
+<span class=normal>443</span>
+<span class=normal>444</span>
+<span class=normal>445</span>
+<span class=normal>446</span>
+<span class=normal>447</span>
+<span class=normal>448</span>
+<span class=normal>449</span>
+<span class=normal>450</span>
+<span class=normal>451</span>
+<span class=normal>452</span>
+<span class=normal>453</span>
+<span class=normal>454</span>
+<span class=normal>455</span>
+<span class=normal>456</span>
+<span class=normal>457</span>
+<span class=normal>458</span>
+<span class=normal>459</span>
+<span class=normal>460</span>
+<span class=normal>461</span>
+<span class=normal>462</span>
+<span class=normal>463</span>
+<span class=normal>464</span>
+<span class=normal>465</span>
+<span class=normal>466</span>
+<span class=normal>467</span>
+<span class=normal>468</span>
+<span class=normal>469</span>
+<span class=normal>470</span>
+<span class=normal>471</span>
+<span class=normal>472</span>
+<span class=normal>473</span>
+<span class=normal>474</span>
+<span class=normal>475</span>
+<span class=normal>476</span>
+<span class=normal>477</span>
+<span class=normal>478</span>
+<span class=normal>479</span>
+<span class=normal>480</span>
+<span class=normal>481</span>
+<span class=normal>482</span>
+<span class=normal>483</span>
+<span class=normal>484</span>
+<span class=normal>485</span>
+<span class=normal>486</span>
+<span class=normal>487</span>
+<span class=normal>488</span>
+<span class=normal>489</span>
+<span class=normal>490</span>
+<span class=normal>491</span>
+<span class=normal>492</span>
+<span class=normal>493</span>
+<span class=normal>494</span>
+<span class=normal>495</span>
+<span class=normal>496</span>
+<span class=normal>497</span>
+<span class=normal>498</span>
+<span class=normal>499</span>
+<span class=normal>500</span>
+<span class=normal>501</span>
+<span class=normal>502</span>
+<span class=normal>503</span>
+<span class=normal>504</span>
+<span class=normal>505</span>
+<span class=normal>506</span>
+<span class=normal>507</span>
+<span class=normal>508</span>
+<span class=normal>509</span>
+<span class=normal>510</span>
+<span class=normal>511</span>
+<span class=normal>512</span>
+<span class=normal>513</span>
+<span class=normal>514</span>
+<span class=normal>515</span>
+<span class=normal>516</span>
+<span class=normal>517</span>
+<span class=normal>518</span>
+<span class=normal>519</span>
+<span class=normal>520</span>
+<span class=normal>521</span>
+<span class=normal>522</span>
+<span class=normal>523</span>
+<span class=normal>524</span>
+<span class=normal>525</span>
+<span class=normal>526</span>
+<span class=normal>527</span>
+<span class=normal>528</span>
+<span class=normal>529</span>
+<span class=normal>530</span>
+<span class=normal>531</span>
+<span class=normal>532</span>
+<span class=normal>533</span>
+<span class=normal>534</span>
+<span class=normal>535</span>
+<span class=normal>536</span>
+<span class=normal>537</span>
+<span class=normal>538</span>
+<span class=normal>539</span>
+<span class=normal>540</span>
+<span class=normal>541</span>
+<span class=normal>542</span>
+<span class=normal>543</span>
+<span class=normal>544</span>
+<span class=normal>545</span>
+<span class=normal>546</span>
+<span class=normal>547</span>
+<span class=normal>548</span>
+<span class=normal>549</span>
+<span class=normal>550</span>
+<span class=normal>551</span>
+<span class=normal>552</span>
+<span class=normal>553</span>
+<span class=normal>554</span>
+<span class=normal>555</span>
+<span class=normal>556</span>
+<span class=normal>557</span>
+<span class=normal>558</span>
+<span class=normal>559</span>
+<span class=normal>560</span>
+<span class=normal>561</span>
+<span class=normal>562</span>
+<span class=normal>563</span>
+<span class=normal>564</span>
+<span class=normal>565</span>
+<span class=normal>566</span>
+<span class=normal>567</span>
+<span class=normal>568</span>
+<span class=normal>569</span>
+<span class=normal>570</span>
+<span class=normal>571</span>
+<span class=normal>572</span>
+<span class=normal>573</span>
+<span class=normal>574</span>
+<span class=normal>575</span>
+<span class=normal>576</span>
+<span class=normal>577</span>
+<span class=normal>578</span>
+<span class=normal>579</span>
+<span class=normal>580</span>
+<span class=normal>581</span>
+<span class=normal>582</span>
+<span class=normal>583</span>
+<span class=normal>584</span>
+<span class=normal>585</span>
+<span class=normal>586</span>
+<span class=normal>587</span>
+<span class=normal>588</span>
+<span class=normal>589</span>
+<span class=normal>590</span>
+<span class=normal>591</span>
+<span class=normal>592</span>
+<span class=normal>593</span>
+<span class=normal>594</span>
+<span class=normal>595</span>
+<span class=normal>596</span>
+<span class=normal>597</span>
+<span class=normal>598</span>
+<span class=normal>599</span>
+<span class=normal>600</span>
+<span class=normal>601</span>
+<span class=normal>602</span>
+<span class=normal>603</span>
+<span class=normal>604</span>
+<span class=normal>605</span>
+<span class=normal>606</span>
+<span class=normal>607</span>
+<span class=normal>608</span>
+<span class=normal>609</span>
+<span class=normal>610</span>
+<span class=normal>611</span>
+<span class=normal>612</span>
+<span class=normal>613</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TaniumOscalFactory</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Build Tanium OSCAL entities.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>rule_use_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>RuleUse</span><span class=p>],</span>
+        <span class=n>blocksize</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>11000</span><span class=p>,</span>
+        <span class=n>cpus_max</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>1</span><span class=p>,</span>
+        <span class=n>cpus_min</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>1</span><span class=p>,</span>
+        <span class=n>checking</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+        <span class=n>caching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+        <span class=n>aggregate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_rule_use_list</span> <span class=o>=</span> <span class=n>rule_use_list</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_component_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_inventory_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>InventoryItem</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_observation_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_ns</span> <span class=o>=</span> <span class=s1>&#39;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&#39;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cpus</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_checking</span> <span class=o>=</span> <span class=n>checking</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_caching</span> <span class=o>=</span> <span class=n>caching</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_aggregate</span> <span class=o>=</span> <span class=n>aggregate</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_result</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=c1># blocksize: default, min</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_blocksize</span> <span class=o>=</span> <span class=n>blocksize</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_blocksize</span> <span class=o>&lt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_blocksize</span> <span class=o>=</span> <span class=mi>1</span>
+        <span class=c1># cpus max: default, max, min</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span> <span class=o>=</span> <span class=n>cpus_max</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span> <span class=o>&gt;</span> <span class=n>os</span><span class=o>.</span><span class=n>cpu_count</span><span class=p>():</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>cpu_count</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>=</span> <span class=n>cpus_min</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>&gt;</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>&lt;</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>=</span> <span class=mi>1</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span> <span class=o>=</span> <span class=n>PropertyAccounting</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span> <span class=o>=</span> <span class=n>PropertyManager</span><span class=p>(</span><span class=n>caching</span><span class=o>=</span><span class=n>caching</span><span class=p>,</span> <span class=n>checking</span><span class=o>=</span><span class=n>checking</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_is_duplicate_component</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule_use</span><span class=p>:</span> <span class=n>RuleUse</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check for duplicate component.&quot;&quot;&quot;</span>
+        <span class=n>retval</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=n>component_type</span> <span class=o>=</span> <span class=n>rule_use</span><span class=o>.</span><span class=n>component_type</span>
+        <span class=n>component_title</span> <span class=o>=</span> <span class=n>rule_use</span><span class=o>.</span><span class=n>component</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_component_map</span><span class=o>.</span><span class=n>values</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>component</span><span class=o>.</span><span class=n>type</span> <span class=o>!=</span> <span class=n>component_type</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span> <span class=o>!=</span> <span class=n>component_title</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>retval</span> <span class=o>=</span> <span class=kc>True</span>
+            <span class=k>break</span>
+        <span class=k>return</span> <span class=n>retval</span>
+
+    <span class=k>def</span> <span class=nf>_derive_components</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive components from RuleUse list.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_component_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>rule_use</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_use_list</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_is_duplicate_component</span><span class=p>(</span><span class=n>rule_use</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=n>component_type</span> <span class=o>=</span> <span class=n>rule_use</span><span class=o>.</span><span class=n>component_type</span>
+            <span class=n>component_title</span> <span class=o>=</span> <span class=n>rule_use</span><span class=o>.</span><span class=n>component</span>
+            <span class=c1># See Note in _get_component_ref.</span>
+            <span class=n>component_description</span> <span class=o>=</span> <span class=n>rule_use</span><span class=o>.</span><span class=n>component</span>
+            <span class=n>component_ref</span> <span class=o>=</span> <span class=n>_uuid_component</span><span class=p>()</span>
+            <span class=n>status</span> <span class=o>=</span> <span class=n>Status</span><span class=p>(</span><span class=n>state</span><span class=o>=</span><span class=s1>&#39;operational&#39;</span><span class=p>)</span>
+            <span class=n>component</span> <span class=o>=</span> <span class=n>SystemComponent</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=n>component_ref</span><span class=p>,</span>
+                <span class=nb>type</span><span class=o>=</span><span class=n>component_type</span><span class=p>,</span>
+                <span class=n>title</span><span class=o>=</span><span class=n>component_title</span><span class=p>,</span>
+                <span class=n>description</span><span class=o>=</span><span class=n>component_description</span><span class=p>,</span>
+                <span class=n>status</span><span class=o>=</span><span class=n>status</span>
+            <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_component_map</span><span class=p>[</span><span class=n>component_ref</span><span class=p>]</span> <span class=o>=</span> <span class=n>component</span>
+
+    <span class=k>def</span> <span class=nf>_get_component_ref</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule_use</span><span class=p>:</span> <span class=n>RuleUse</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get component reference for specified rule use.&quot;&quot;&quot;</span>
+        <span class=n>uuid</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>for</span> <span class=n>component_ref</span><span class=p>,</span> <span class=n>component</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_component_map</span><span class=o>.</span><span class=n>items</span><span class=p>():</span>
+            <span class=k>if</span> <span class=n>component</span><span class=o>.</span><span class=n>type</span> <span class=o>!=</span> <span class=n>rule_use</span><span class=o>.</span><span class=n>component_type</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=k>if</span> <span class=n>component</span><span class=o>.</span><span class=n>title</span> <span class=o>!=</span> <span class=n>rule_use</span><span class=o>.</span><span class=n>component</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=c1># Note: currently title and description are the same,</span>
+            <span class=c1># therefore checking description is not necessary.</span>
+            <span class=n>uuid</span> <span class=o>=</span> <span class=n>component_ref</span>
+            <span class=k>break</span>
+        <span class=k>return</span> <span class=n>uuid</span>
+
+    <span class=k>def</span> <span class=nf>_derive_inventory</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive inventory from RuleUse list.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_inventory_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>InventoryItem</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>rule_use</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_use_list</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>rule_use</span><span class=o>.</span><span class=n>tanium_client_ip_address</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inventory_map</span><span class=p>:</span>
+                <span class=k>continue</span>
+            <span class=n>inventory</span> <span class=o>=</span> <span class=n>InventoryItem</span><span class=p>(</span><span class=n>uuid</span><span class=o>=</span><span class=n>_uuid_inventory</span><span class=p>(),</span> <span class=n>description</span><span class=o>=</span><span class=s1>&#39;inventory&#39;</span><span class=p>)</span>
+            <span class=n>inventory</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=p>[</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span><span class=o>.</span><span class=n>materialize</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=s1>&#39;Computer_Name&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>computer_name</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>),</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span><span class=o>.</span><span class=n>materialize</span><span class=p>(</span>
+                    <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Tanium_Client_IP_Address&#39;</span><span class=p>,</span>
+                    <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>tanium_client_ip_address</span><span class=p>,</span>
+                    <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span>
+                    <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_inventory_item_id&#39;</span>
+                <span class=p>),</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span><span class=o>.</span><span class=n>materialize</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=s1>&#39;IP_Address&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>ip_address</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>),</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span><span class=o>.</span><span class=n>materialize</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=s1>&#39;Count&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>count</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>)</span>
+            <span class=p>]</span>
+            <span class=n>component_uuid</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_component_ref</span><span class=p>(</span><span class=n>rule_use</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>component_uuid</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+                <span class=n>inventory</span><span class=o>.</span><span class=n>implemented_components</span> <span class=o>=</span> <span class=p>[</span><span class=n>ImplementedComponent</span><span class=p>(</span><span class=n>component_uuid</span><span class=o>=</span><span class=n>component_uuid</span><span class=p>)]</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_inventory_map</span><span class=p>[</span><span class=n>rule_use</span><span class=o>.</span><span class=n>tanium_client_ip_address</span><span class=p>]</span> <span class=o>=</span> <span class=n>inventory</span>
+
+    <span class=k>def</span> <span class=nf>_get_inventory_ref</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule_use</span><span class=p>:</span> <span class=n>RuleUse</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get inventory reference for specified rule use.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inventory_map</span><span class=p>[</span><span class=n>rule_use</span><span class=o>.</span><span class=n>tanium_client_ip_address</span><span class=p>]</span><span class=o>.</span><span class=n>uuid</span>
+
+    <span class=k>def</span> <span class=nf>_conditional_include</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>props</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>],</span>
+        <span class=n>group</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>ns</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>class_</span><span class=p>:</span> <span class=nb>str</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Add non-aggregated property or remember common property.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_aggregate</span><span class=p>:</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>is_common_property</span><span class=p>(</span><span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=n>class_</span><span class=p>):</span>
+                <span class=c1># common property</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span><span class=o>.</span><span class=n>put_common_property</span><span class=p>(</span><span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=n>class_</span><span class=p>)</span>
+                <span class=k>return</span>
+        <span class=c1># non-aggregated property</span>
+        <span class=n>props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span><span class=o>.</span><span class=n>materialize</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=n>class_</span><span class=p>))</span>
+
+    <span class=k>def</span> <span class=nf>_get_observtion_properties</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>rule_use</span><span class=p>:</span> <span class=n>RuleUse</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get observation properties.&quot;&quot;&quot;</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>group</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_component_ref</span><span class=p>(</span><span class=n>rule_use</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_conditional_include</span><span class=p>(</span><span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span> <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Check_ID&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>check_id</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_conditional_include</span><span class=p>(</span>
+            <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span>
+            <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span>
+            <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Check_ID_Benchmark&#39;</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>check_id_benchmark</span><span class=p>,</span>
+            <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span>
+            <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_predefined_profile&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_conditional_include</span><span class=p>(</span>
+            <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span>
+            <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span>
+            <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Check_ID_Version&#39;</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>check_id_version</span><span class=p>,</span>
+            <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span>
+            <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_predefined_profile_version&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_conditional_include</span><span class=p>(</span>
+            <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span> <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Check_ID_Level&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>check_id_level</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_conditional_include</span><span class=p>(</span>
+            <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span>
+            <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span>
+            <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Rule_ID&#39;</span><span class=p>,</span>
+            <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>rule_id</span><span class=p>,</span>
+            <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span>
+            <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_goal_description&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_conditional_include</span><span class=p>(</span>
+            <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span> <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Rule_ID&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>rule_id</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_check_name_id&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_conditional_include</span><span class=p>(</span>
+            <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span> <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;State&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>state</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_result&#39;</span>
+        <span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_conditional_include</span><span class=p>(</span>
+            <span class=n>props</span><span class=o>=</span><span class=n>props</span><span class=p>,</span> <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Timestamp&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>timestamp</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_timestamp&#39;</span>
+        <span class=p>)</span>
+        <span class=k>return</span> <span class=n>props</span>
+
+    <span class=k>def</span> <span class=nf>_derive_common_property_accounting</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive common properties accounting from RuleUse list.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>rule_use</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_use_list</span><span class=p>:</span>
+            <span class=n>group</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_component_ref</span><span class=p>(</span><span class=n>rule_use</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>count_group</span><span class=p>(</span><span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>count_property</span><span class=p>(</span><span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Check_ID&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>check_id</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>count_property</span><span class=p>(</span>
+                <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span>
+                <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Check_ID_Benchmark&#39;</span><span class=p>,</span>
+                <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>check_id_benchmark</span><span class=p>,</span>
+                <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span>
+                <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_predefined_profile&#39;</span>
+            <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>count_property</span><span class=p>(</span>
+                <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span>
+                <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Check_ID_Version&#39;</span><span class=p>,</span>
+                <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>check_id_version</span><span class=p>,</span>
+                <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span>
+                <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_predefined_profile_version&#39;</span>
+            <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>count_property</span><span class=p>(</span>
+                <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Check_ID_Level&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>check_id_level</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span>
+            <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>count_property</span><span class=p>(</span>
+                <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Rule_ID&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>rule_id</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_goal_description&#39;</span>
+            <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>count_property</span><span class=p>(</span>
+                <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Rule_ID&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>rule_id</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_check_name_id&#39;</span>
+            <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>count_property</span><span class=p>(</span>
+                <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;State&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>state</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_result&#39;</span>
+            <span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span><span class=o>.</span><span class=n>count_property</span><span class=p>(</span>
+                <span class=n>group</span><span class=o>=</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=s1>&#39;Timestamp&#39;</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>timestamp</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_ns</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=s1>&#39;scc_timestamp&#39;</span>
+            <span class=p>)</span>
+
+    <span class=c1># parallel process to process one chuck of entire data set</span>
+    <span class=k>def</span> <span class=nf>_batch_observations</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>index</span><span class=p>:</span> <span class=nb>int</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive batch of observations from RuleUse list.&quot;&quot;&quot;</span>
+        <span class=n>observation_partial_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># determine which chunk to process</span>
+        <span class=n>batch_size</span> <span class=o>=</span> <span class=p>(</span><span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_rule_use_list</span><span class=p>)</span> <span class=o>//</span> <span class=bp>self</span><span class=o>.</span><span class=n>_batch_workers</span><span class=p>)</span> <span class=o>+</span> <span class=mi>1</span>
+        <span class=n>start</span> <span class=o>=</span> <span class=n>index</span> <span class=o>*</span> <span class=n>batch_size</span>
+        <span class=n>end</span> <span class=o>=</span> <span class=p>(</span><span class=n>index</span> <span class=o>+</span> <span class=mi>1</span><span class=p>)</span> <span class=o>*</span> <span class=n>batch_size</span>
+        <span class=n>end</span> <span class=o>=</span> <span class=nb>min</span><span class=p>(</span><span class=n>end</span><span class=p>,</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_rule_use_list</span><span class=p>))</span>
+        <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;start: </span><span class=si>{</span><span class=n>start</span><span class=si>}</span><span class=s1> end: </span><span class=si>{</span><span class=n>end</span><span class=w> </span><span class=o>-</span><span class=w> </span><span class=mi>1</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=c1># process just the one chunk</span>
+        <span class=k>for</span> <span class=n>i</span> <span class=ow>in</span> <span class=nb>range</span><span class=p>(</span><span class=n>start</span><span class=p>,</span> <span class=n>end</span><span class=p>):</span>
+            <span class=n>rule_use</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_rule_use_list</span><span class=p>[</span><span class=n>i</span><span class=p>]</span>
+            <span class=n>observation</span> <span class=o>=</span> <span class=n>Observation</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=n>_uuid_observation</span><span class=p>(),</span>
+                <span class=n>description</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>rule_id</span><span class=p>,</span>
+                <span class=n>methods</span><span class=o>=</span><span class=p>[</span><span class=s1>&#39;TEST-AUTOMATED&#39;</span><span class=p>],</span>
+                <span class=n>collected</span><span class=o>=</span><span class=n>rule_use</span><span class=o>.</span><span class=n>collected</span>
+            <span class=p>)</span>
+            <span class=n>subject_uuid</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_inventory_ref</span><span class=p>(</span><span class=n>rule_use</span><span class=p>)</span>
+            <span class=n>subject_reference</span> <span class=o>=</span> <span class=n>SubjectReference</span><span class=p>(</span><span class=n>subject_uuid</span><span class=o>=</span><span class=n>subject_uuid</span><span class=p>,</span> <span class=nb>type</span><span class=o>=</span><span class=s1>&#39;inventory-item&#39;</span><span class=p>)</span>
+            <span class=n>observation</span><span class=o>.</span><span class=n>subjects</span> <span class=o>=</span> <span class=p>[</span><span class=n>subject_reference</span><span class=p>]</span>
+            <span class=n>observation</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_observtion_properties</span><span class=p>(</span><span class=n>rule_use</span><span class=p>)</span>
+            <span class=n>observation_partial_map</span><span class=p>[</span><span class=n>subject_uuid</span><span class=p>]</span> <span class=o>=</span> <span class=n>observation_partial_map</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>subject_uuid</span><span class=p>,</span> <span class=p>[])</span> <span class=o>+</span> <span class=p>[</span><span class=n>observation</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>observation_partial_map</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>_batch_workers</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Calculate number of parallel processes to employ.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>cpus_estimate</span> <span class=o>=</span> <span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_rule_use_list</span><span class=p>)</span> <span class=o>//</span> <span class=bp>self</span><span class=o>.</span><span class=n>_blocksize</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_cpus</span> <span class=o>=</span> <span class=nb>max</span><span class=p>(</span><span class=nb>min</span><span class=p>(</span><span class=n>cpus_estimate</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span><span class=p>),</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span><span class=p>)</span>
+            <span class=n>logger</span><span class=o>.</span><span class=n>debug</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;CPUs estimate: </span><span class=si>{</span><span class=n>cpus_estimate</span><span class=si>}</span><span class=s1> available: </span><span class=si>{</span><span class=n>os</span><span class=o>.</span><span class=n>cpu_count</span><span class=p>()</span><span class=si>}</span><span class=s1> selection: </span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_cpus</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus</span>
+
+    <span class=k>def</span> <span class=nf>_derive_observations</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive observations from RuleUse list.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_observation_map</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_batch_workers</span> <span class=o>==</span> <span class=mi>1</span><span class=p>:</span>
+            <span class=c1># no need for multiprocessing</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_observation_map</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_batch_observations</span><span class=p>(</span><span class=mi>0</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># use multiprocessing to perform observations creation in parallel</span>
+            <span class=n>pool</span> <span class=o>=</span> <span class=n>multiprocessing</span><span class=o>.</span><span class=n>Pool</span><span class=p>(</span><span class=n>processes</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_batch_workers</span><span class=p>)</span>
+            <span class=n>rval_list</span> <span class=o>=</span> <span class=n>pool</span><span class=o>.</span><span class=n>map</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_batch_observations</span><span class=p>,</span> <span class=nb>range</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_batch_workers</span><span class=p>))</span>
+            <span class=c1># gather observations from the sundry batch workers</span>
+            <span class=k>for</span> <span class=n>partial_observation_map</span> <span class=ow>in</span> <span class=n>rval_list</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_observation_map</span> <span class=o>=</span> <span class=n>join_key_to_list_dicts</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_observation_map</span><span class=p>,</span> <span class=n>partial_observation_map</span><span class=p>)</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>components</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>SystemComponent</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;OSCAL components.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_component_map</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>inventory</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ValuesView</span><span class=p>[</span><span class=n>InventoryItem</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;OSCAL inventory.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_inventory_map</span><span class=o>.</span><span class=n>values</span><span class=p>()</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>observations</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;OSCAL observations.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=c1># observations are partitioned by local-definition uuid; join them into one list</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_observation_map</span><span class=p>:</span>
+            <span class=n>list_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_observation_map</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+            <span class=k>for</span> <span class=n>observation</span> <span class=ow>in</span> <span class=n>list_</span><span class=p>:</span>
+                <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>observation</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>control_selections</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>ControlSelection</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;OSCAL control selections.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>ControlSelection</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>reviewed_controls</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>ReviewedControls</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;OSCAL reviewed controls.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>ReviewedControls</span><span class=p>(</span><span class=n>control_selections</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>control_selections</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>analysis</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;OSCAL statistics.&quot;&quot;&quot;</span>
+        <span class=n>analysis</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>analysis</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;components: </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>components</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>analysis</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;inventory: </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>inventory</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>analysis</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;observations: </span><span class=si>{</span><span class=nb>len</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>observations</span><span class=p>)</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=n>analysis</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;cache: requests=</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span><span class=o>.</span><span class=n>requests</span><span class=si>}</span><span class=s1> hits=</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span><span class=o>.</span><span class=n>hits</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>analysis</span>
+
+    <span class=k>def</span> <span class=nf>_get_local_definitions</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>system_component</span><span class=p>:</span> <span class=n>SystemComponent</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>LocalDefinitions1</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get local definitions.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=n>LocalDefinitions1</span><span class=p>()</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+            <span class=k>if</span> <span class=n>component</span><span class=o>.</span><span class=n>uuid</span> <span class=o>==</span> <span class=n>system_component</span><span class=o>.</span><span class=n>uuid</span><span class=p>:</span>
+                <span class=n>rval</span><span class=o>.</span><span class=n>components</span> <span class=o>=</span> <span class=p>[</span><span class=n>component</span><span class=p>]</span>
+                <span class=n>rval</span><span class=o>.</span><span class=n>inventory_items</span> <span class=o>=</span> <span class=p>[]</span>
+                <span class=k>for</span> <span class=n>inventory_item</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>inventory</span><span class=p>:</span>
+                    <span class=k>for</span> <span class=n>implemented_component</span> <span class=ow>in</span> <span class=n>inventory_item</span><span class=o>.</span><span class=n>implemented_components</span><span class=p>:</span>
+                        <span class=k>if</span> <span class=n>implemented_component</span><span class=o>.</span><span class=n>component_uuid</span> <span class=o>==</span> <span class=n>system_component</span><span class=o>.</span><span class=n>uuid</span><span class=p>:</span>
+                            <span class=n>rval</span><span class=o>.</span><span class=n>inventory_items</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>inventory_item</span><span class=p>)</span>
+                <span class=k>break</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_get_local_definitions_uuids</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>local_definitions</span><span class=p>:</span> <span class=n>LocalDefinitions1</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get inventory uuids for given local definitions.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>if</span> <span class=n>local_definitions</span><span class=o>.</span><span class=n>inventory_items</span><span class=p>:</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=p>[</span><span class=n>inventory_item</span><span class=o>.</span><span class=n>uuid</span> <span class=k>for</span> <span class=n>inventory_item</span> <span class=ow>in</span> <span class=n>local_definitions</span><span class=o>.</span><span class=n>inventory_items</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_get_observations_for_uuid</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>uuid_</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get observations for given uuid.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=k>if</span> <span class=n>uuid_</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_observation_map</span><span class=p>:</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+            <span class=n>list_</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_observation_map</span><span class=p>[</span><span class=n>uuid_</span><span class=p>]</span>
+            <span class=k>for</span> <span class=n>observation</span> <span class=ow>in</span> <span class=n>list_</span><span class=p>:</span>
+                <span class=n>rval</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>observation</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_get_observations</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>local_definitions</span><span class=p>:</span> <span class=n>LocalDefinitions1</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get observations for given local definitions.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>local_definitions_uuids</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_local_definitions_uuids</span><span class=p>(</span><span class=n>local_definitions</span><span class=p>)</span>
+        <span class=k>for</span> <span class=n>uuid_</span> <span class=ow>in</span> <span class=n>local_definitions_uuids</span><span class=p>:</span>
+            <span class=n>observations</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_observations_for_uuid</span><span class=p>(</span><span class=n>uuid_</span><span class=p>)</span>
+            <span class=k>if</span> <span class=n>observations</span><span class=p>:</span>
+                <span class=n>rval</span> <span class=o>+=</span> <span class=n>observations</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_get_properties</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get properties for given group.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span><span class=o>.</span><span class=n>get_common_properties</span><span class=p>(</span><span class=n>group</span><span class=p>)</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>results</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Result</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;OSCAL result.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_result</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_derive_components</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_derive_inventory</span><span class=p>()</span>
+            <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_aggregate</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_derive_common_property_accounting</span><span class=p>()</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_derive_observations</span><span class=p>()</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=k>for</span> <span class=n>component</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>components</span><span class=p>:</span>
+            <span class=n>local_definitions</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_local_definitions</span><span class=p>(</span><span class=n>component</span><span class=p>)</span>
+            <span class=n>observations</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_observations</span><span class=p>(</span><span class=n>local_definitions</span><span class=p>)</span>
+            <span class=n>result</span> <span class=o>=</span> <span class=n>Result</span><span class=p>(</span>
+                <span class=n>uuid</span><span class=o>=</span><span class=n>_uuid_result</span><span class=p>(),</span>
+                <span class=n>title</span><span class=o>=</span><span class=s1>&#39;Tanium&#39;</span><span class=p>,</span>
+                <span class=n>description</span><span class=o>=</span><span class=s1>&#39;Tanium&#39;</span><span class=p>,</span>
+                <span class=n>start</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span><span class=p>,</span>
+                <span class=n>end</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span><span class=p>,</span>
+                <span class=n>reviewed_controls</span><span class=o>=</span><span class=bp>self</span><span class=o>.</span><span class=n>reviewed_controls</span><span class=p>,</span>
+                <span class=n>local_definitions</span><span class=o>=</span><span class=n>local_definitions</span><span class=p>,</span>
+                <span class=n>observations</span><span class=o>=</span><span class=n>observations</span>
+            <span class=p>)</span>
+            <span class=n>component_ref</span> <span class=o>=</span> <span class=n>component</span><span class=o>.</span><span class=n>uuid</span>
+            <span class=n>result</span><span class=o>.</span><span class=n>props</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_properties</span><span class=p>(</span><span class=n>component_ref</span><span class=p>)</span>
+            <span class=n>results</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>result</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.implementations.tanium.TaniumOscalFactory-attributes>Attributes<a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumOscalFactory.analysis class="doc doc-heading"> <code class="highlight language-python"><span class=n>analysis</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.analysis class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>OSCAL statistics.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumOscalFactory.components class="doc doc-heading"> <code class="highlight language-python"><span class=n>components</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>SystemComponent</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.components class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>OSCAL components.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumOscalFactory.control_selections class="doc doc-heading"> <code class="highlight language-python"><span class=n>control_selections</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>ControlSelection</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.control_selections class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>OSCAL control selections.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumOscalFactory.inventory class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory</span><span class=p>:</span> <span class=n>ValuesView</span><span class=p>[</span><span class=n>InventoryItem</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.inventory class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>OSCAL inventory.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumOscalFactory.observations class="doc doc-heading"> <code class="highlight language-python"><span class=n>observations</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.observations class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>OSCAL observations.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumOscalFactory.results class="doc doc-heading"> <code class="highlight language-python"><span class=n>results</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Result</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.results class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>OSCAL result.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumOscalFactory.reviewed_controls class="doc doc-heading"> <code class="highlight language-python"><span class=n>reviewed_controls</span><span class=p>:</span> <span class=n>ReviewedControls</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.reviewed_controls class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>OSCAL reviewed controls.</p> </div> </div> <h5 id=trestle.transforms.implementations.tanium.TaniumOscalFactory-functions>Functions<a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.tanium.TaniumOscalFactory.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>timestamp</span><span class=p>,</span> <span class=n>rule_use_list</span><span class=p>,</span> <span class=n>blocksize</span><span class=o>=</span><span class=mi>11000</span><span class=p>,</span> <span class=n>cpus_max</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>cpus_min</span><span class=o>=</span><span class=mi>1</span><span class=p>,</span> <span class=n>checking</span><span class=o>=</span><span class=kc>False</span><span class=p>,</span> <span class=n>caching</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>aggregate</span><span class=o>=</span><span class=kc>True</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.tanium.TaniumOscalFactory.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize given specified args.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>237</span>
+<span class=normal>238</span>
+<span class=normal>239</span>
+<span class=normal>240</span>
+<span class=normal>241</span>
+<span class=normal>242</span>
+<span class=normal>243</span>
+<span class=normal>244</span>
+<span class=normal>245</span>
+<span class=normal>246</span>
+<span class=normal>247</span>
+<span class=normal>248</span>
+<span class=normal>249</span>
+<span class=normal>250</span>
+<span class=normal>251</span>
+<span class=normal>252</span>
+<span class=normal>253</span>
+<span class=normal>254</span>
+<span class=normal>255</span>
+<span class=normal>256</span>
+<span class=normal>257</span>
+<span class=normal>258</span>
+<span class=normal>259</span>
+<span class=normal>260</span>
+<span class=normal>261</span>
+<span class=normal>262</span>
+<span class=normal>263</span>
+<span class=normal>264</span>
+<span class=normal>265</span>
+<span class=normal>266</span>
+<span class=normal>267</span>
+<span class=normal>268</span>
+<span class=normal>269</span>
+<span class=normal>270</span>
+<span class=normal>271</span>
+<span class=normal>272</span>
+<span class=normal>273</span>
+<span class=normal>274</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>timestamp</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>rule_use_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>RuleUse</span><span class=p>],</span>
+    <span class=n>blocksize</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>11000</span><span class=p>,</span>
+    <span class=n>cpus_max</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>1</span><span class=p>,</span>
+    <span class=n>cpus_min</span><span class=p>:</span> <span class=nb>int</span> <span class=o>=</span> <span class=mi>1</span><span class=p>,</span>
+    <span class=n>checking</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>,</span>
+    <span class=n>caching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span>
+    <span class=n>aggregate</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_rule_use_list</span> <span class=o>=</span> <span class=n>rule_use_list</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>timestamp</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_component_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>SystemComponent</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_inventory_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>InventoryItem</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_observation_list</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_ns</span> <span class=o>=</span> <span class=s1>&#39;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&#39;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_cpus</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_checking</span> <span class=o>=</span> <span class=n>checking</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_caching</span> <span class=o>=</span> <span class=n>caching</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_aggregate</span> <span class=o>=</span> <span class=n>aggregate</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_result</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=c1># blocksize: default, min</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_blocksize</span> <span class=o>=</span> <span class=n>blocksize</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_blocksize</span> <span class=o>&lt;</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_blocksize</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=c1># cpus max: default, max, min</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span> <span class=o>=</span> <span class=n>cpus_max</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span> <span class=o>&gt;</span> <span class=n>os</span><span class=o>.</span><span class=n>cpu_count</span><span class=p>():</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span> <span class=o>=</span> <span class=n>os</span><span class=o>.</span><span class=n>cpu_count</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>=</span> <span class=n>cpus_min</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>&gt;</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_max</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>&lt;</span> <span class=mi>1</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_cpus_min</span> <span class=o>=</span> <span class=mi>1</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_property_accounting</span> <span class=o>=</span> <span class=n>PropertyAccounting</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_property_manager</span> <span class=o>=</span> <span class=n>PropertyManager</span><span class=p>(</span><span class=n>caching</span><span class=o>=</span><span class=n>caching</span><span class=p>,</span> <span class=n>checking</span><span class=o>=</span><span class=n>checking</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer class="doc doc-heading"> <code>TaniumResultToOscalARTransformer</code> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.transformer_factory.ResultsTransformer href=../../transformer_factory/#trestle.transforms.transformer_factory.ResultsTransformer>ResultsTransformer</a></code></p> <p>Interface for Tanium transformer.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 47</span>
+<span class=normal> 48</span>
+<span class=normal> 49</span>
+<span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TaniumResultToOscalARTransformer</span><span class=p>(</span><span class=n>ResultsTransformer</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Interface for Tanium transformer.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>analysis</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return analysis info.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_analysis</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>blocksize</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return blocksize.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;blocksize&#39;</span><span class=p>,</span> <span class=mi>10000</span><span class=p>)</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>cpus_max</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return cpus_max.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;cpus_max&#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>cpus_min</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return cpus_min.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;cpus_min&#39;</span><span class=p>,</span> <span class=mi>1</span><span class=p>)</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>aggregate</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return aggregate.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;aggregate&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>caching</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return caching.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;caching&#39;</span><span class=p>,</span> <span class=kc>True</span><span class=p>)</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>checking</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return checking.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;checking&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>set_modes</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>modes</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Keep modes info.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>modes</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=n>modes</span>
+
+    <span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Transform the blob into a Results.&quot;&quot;&quot;</span>
+        <span class=n>ts0</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=n>Results</span><span class=p>()</span>
+        <span class=n>ru_factory</span> <span class=o>=</span> <span class=n>RuleUseFactory</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get_timestamp</span><span class=p>())</span>
+        <span class=n>ru_list</span> <span class=o>=</span> <span class=n>ru_factory</span><span class=o>.</span><span class=n>make_list</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+        <span class=n>tanium_oscal_factory</span> <span class=o>=</span> <span class=n>TaniumOscalFactory</span><span class=p>(</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>get_timestamp</span><span class=p>(),</span>
+            <span class=n>ru_list</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>blocksize</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>cpus_max</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>cpus_min</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>checking</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>caching</span><span class=p>,</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>aggregate</span>
+        <span class=p>)</span>
+        <span class=n>results</span><span class=o>.</span><span class=n>__root__</span> <span class=o>=</span> <span class=n>tanium_oscal_factory</span><span class=o>.</span><span class=n>results</span>
+        <span class=n>ts1</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_analysis</span> <span class=o>=</span> <span class=n>tanium_oscal_factory</span><span class=o>.</span><span class=n>analysis</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_analysis</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;transform time: </span><span class=si>{</span><span class=n>ts1</span><span class=w> </span><span class=o>-</span><span class=w> </span><span class=n>ts0</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-attributes>Attributes<a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.aggregate class="doc doc-heading"> <code class="highlight language-python"><span class=n>aggregate</span><span class=p>:</span> <span class=nb>bool</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.aggregate class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return aggregate.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.analysis class="doc doc-heading"> <code class="highlight language-python"><span class=n>analysis</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.analysis class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return analysis info.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.blocksize class="doc doc-heading"> <code class="highlight language-python"><span class=n>blocksize</span><span class=p>:</span> <span class=nb>int</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.blocksize class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return blocksize.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.caching class="doc doc-heading"> <code class="highlight language-python"><span class=n>caching</span><span class=p>:</span> <span class=nb>bool</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.caching class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return caching.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.checking class="doc doc-heading"> <code class="highlight language-python"><span class=n>checking</span><span class=p>:</span> <span class=nb>bool</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.checking class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return checking.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_max class="doc doc-heading"> <code class="highlight language-python"><span class=n>cpus_max</span><span class=p>:</span> <span class=nb>int</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_max class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return cpus_max.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_min class="doc doc-heading"> <code class="highlight language-python"><span class=n>cpus_min</span><span class=p>:</span> <span class=nb>int</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_min class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return cpus_min.</p> </div> </div> <h5 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-functions>Functions<a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.set_modes class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_modes</span><span class=p>(</span><span class=n>modes</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.set_modes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Keep modes info.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_modes</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>modes</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Keep modes info.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>modes</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=n>modes</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.transform class="doc doc-heading"> <code class="highlight language-python"><span class=n>transform</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.transform class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Transform the blob into a Results.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transform the blob into a Results.&quot;&quot;&quot;</span>
+    <span class=n>ts0</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span>
+    <span class=n>results</span> <span class=o>=</span> <span class=n>Results</span><span class=p>()</span>
+    <span class=n>ru_factory</span> <span class=o>=</span> <span class=n>RuleUseFactory</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>get_timestamp</span><span class=p>())</span>
+    <span class=n>ru_list</span> <span class=o>=</span> <span class=n>ru_factory</span><span class=o>.</span><span class=n>make_list</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+    <span class=n>tanium_oscal_factory</span> <span class=o>=</span> <span class=n>TaniumOscalFactory</span><span class=p>(</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>get_timestamp</span><span class=p>(),</span>
+        <span class=n>ru_list</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>blocksize</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>cpus_max</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>cpus_min</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>checking</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>caching</span><span class=p>,</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>aggregate</span>
+    <span class=p>)</span>
+    <span class=n>results</span><span class=o>.</span><span class=n>__root__</span> <span class=o>=</span> <span class=n>tanium_oscal_factory</span><span class=o>.</span><span class=n>results</span>
+    <span class=n>ts1</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>()</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_analysis</span> <span class=o>=</span> <span class=n>tanium_oscal_factory</span><span class=o>.</span><span class=n>analysis</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_analysis</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;transform time: </span><span class=si>{</span><span class=n>ts1</span><span class=w> </span><span class=o>-</span><span class=w> </span><span class=n>ts0</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>results</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.tanium.TaniumTransformer class="doc doc-heading"> <code>TaniumTransformer</code> <a href=#trestle.transforms.implementations.tanium.TaniumTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer href=#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer>TaniumResultToOscalARTransformer</a></code></p> <p>Legacy class name.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/tanium.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>117</span>
+<span class=normal>118</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TaniumTransformer</span><span class=p>(</span><span class=n>TaniumResultToOscalARTransformer</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Legacy class name.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> </div> </div> </div> <h3 id=trestle.transforms.implementations.tanium-functions>Functions<a href=#trestle.transforms.implementations.tanium-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/transforms/implementations/xccdf/index.html b/latest/reference/API/trestle/transforms/implementations/xccdf/index.html
new file mode 100644
index 000000000..2715a3475
--- /dev/null
+++ b/latest/reference/API/trestle/transforms/implementations/xccdf/index.html
@@ -0,0 +1,406 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.transforms.implementations.xccdf module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/implementations/xccdf/ rel=canonical><link href=../tanium/ rel=prev><link href=../../../../../../tutorials/cli/ rel=next><link rel=icon href=../../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.transforms.implementations.xccdf - Compliance Trestle</title><link rel=stylesheet href=../../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.transforms.implementations.xccdf - Compliance Trestle"><meta property=og:description content="Documentation for trestle.transforms.implementations.xccdf module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/implementations/xccdf.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/implementations/xccdf/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.transforms.implementations.xccdf - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.transforms.implementations.xccdf module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/implementations/xccdf.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.transforms.implementations.xccdf class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6 checked> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5 checked> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf class=md-nav__link> <span class=md-ellipsis> xccdf </span> </a> <nav class=md-nav aria-label=xccdf> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse class=md-nav__link> <span class=md-ellipsis> RuleUse </span> </a> <nav class=md-nav aria-label=RuleUse> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.benchmark_href class=md-nav__link> <span class=md-ellipsis> benchmark_href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.benchmark_id class=md-nav__link> <span class=md-ellipsis> benchmark_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.host_name class=md-nav__link> <span class=md-ellipsis> host_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.id_ class=md-nav__link> <span class=md-ellipsis> id_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.idref class=md-nav__link> <span class=md-ellipsis> idref </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.inventory_key class=md-nav__link> <span class=md-ellipsis> inventory_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.result class=md-nav__link> <span class=md-ellipsis> result </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.scanner_name class=md-nav__link> <span class=md-ellipsis> scanner_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.scanner_version class=md-nav__link> <span class=md-ellipsis> scanner_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.severity class=md-nav__link> <span class=md-ellipsis> severity </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.target class=md-nav__link> <span class=md-ellipsis> target </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.target_type class=md-nav__link> <span class=md-ellipsis> target_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.time class=md-nav__link> <span class=md-ellipsis> time </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.weight class=md-nav__link> <span class=md-ellipsis> weight </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer class=md-nav__link> <span class=md-ellipsis> XccdfResultToOscalARTransformer </span> </a> <nav class=md-nav aria-label=XccdfResultToOscalARTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.analysis class=md-nav__link> <span class=md-ellipsis> analysis </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.checking class=md-nav__link> <span class=md-ellipsis> checking </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_description class=md-nav__link> <span class=md-ellipsis> set_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_modes class=md-nav__link> <span class=md-ellipsis> set_modes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_tags class=md-nav__link> <span class=md-ellipsis> set_tags </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_title class=md-nav__link> <span class=md-ellipsis> set_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_type class=md-nav__link> <span class=md-ellipsis> set_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfTransformer class=md-nav__link> <span class=md-ellipsis> XccdfTransformer </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf class=md-nav__link> <span class=md-ellipsis> xccdf </span> </a> <nav class=md-nav aria-label=xccdf> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse class=md-nav__link> <span class=md-ellipsis> RuleUse </span> </a> <nav class=md-nav aria-label=RuleUse> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.benchmark_href class=md-nav__link> <span class=md-ellipsis> benchmark_href </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.benchmark_id class=md-nav__link> <span class=md-ellipsis> benchmark_id </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.host_name class=md-nav__link> <span class=md-ellipsis> host_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.id_ class=md-nav__link> <span class=md-ellipsis> id_ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.idref class=md-nav__link> <span class=md-ellipsis> idref </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.inventory_key class=md-nav__link> <span class=md-ellipsis> inventory_key </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.ns class=md-nav__link> <span class=md-ellipsis> ns </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.result class=md-nav__link> <span class=md-ellipsis> result </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.scanner_name class=md-nav__link> <span class=md-ellipsis> scanner_name </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.scanner_version class=md-nav__link> <span class=md-ellipsis> scanner_version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.severity class=md-nav__link> <span class=md-ellipsis> severity </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.target class=md-nav__link> <span class=md-ellipsis> target </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.target_type class=md-nav__link> <span class=md-ellipsis> target_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.time class=md-nav__link> <span class=md-ellipsis> time </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.version class=md-nav__link> <span class=md-ellipsis> version </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.weight class=md-nav__link> <span class=md-ellipsis> weight </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.RuleUse.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer class=md-nav__link> <span class=md-ellipsis> XccdfResultToOscalARTransformer </span> </a> <nav class=md-nav aria-label=XccdfResultToOscalARTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.analysis class=md-nav__link> <span class=md-ellipsis> analysis </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.checking class=md-nav__link> <span class=md-ellipsis> checking </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.tags class=md-nav__link> <span class=md-ellipsis> tags </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_description class=md-nav__link> <span class=md-ellipsis> set_description </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_modes class=md-nav__link> <span class=md-ellipsis> set_modes </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_tags class=md-nav__link> <span class=md-ellipsis> set_tags </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_title class=md-nav__link> <span class=md-ellipsis> set_title </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_type class=md-nav__link> <span class=md-ellipsis> set_type </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.implementations.xccdf.XccdfTransformer class=md-nav__link> <span class=md-ellipsis> XccdfTransformer </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.transforms.implementations.xccdf</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.transforms.implementations.xccdf class="doc doc-heading"> <code>trestle.transforms.implementations.xccdf</code> <a href=#trestle.transforms.implementations.xccdf class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Facilitate OSCAL-XCCDF transformation.</p> <div class="doc doc-children"> <h3 id=trestle.transforms.implementations.xccdf-classes>Classes<a href=#trestle.transforms.implementations.xccdf-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.xccdf.RuleUse class="doc doc-heading"> <code>RuleUse</code> <a href=#trestle.transforms.implementations.xccdf.RuleUse class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Represents one rule of XCCDF data.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>176</span>
+<span class=normal>177</span>
+<span class=normal>178</span>
+<span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>RuleUse</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Represents one rule of XCCDF data.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>id_</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;id_&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>target</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>target_type</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target_type&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>host_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;host_name&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>benchmark_href</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_href&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>benchmark_id</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_id&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>scanner_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_name&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>scanner_version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_version&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>idref</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;idref&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;version&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>time</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;time&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>result</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;result&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>severity</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;severity&#39;</span><span class=p>]</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>weight</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;weight&#39;</span><span class=p>]</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>inventory_key</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive inventory key.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>host_name</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=c1># OpenScap 1.3.3</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>target</span> <span class=o>+</span> <span class=s1>&#39;:&#39;</span> <span class=o>+</span> <span class=bp>self</span><span class=o>.</span><span class=n>target_type</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=c1># OpenScap 1.3.5</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>host_name</span> <span class=o>+</span> <span class=s1>&#39;:&#39;</span> <span class=o>+</span> <span class=bp>self</span><span class=o>.</span><span class=n>target_type</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>ns</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Derive namespace.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=sa>f</span><span class=s1>&#39;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/</span><span class=si>{</span><span class=bp>self</span><span class=o>.</span><span class=n>scanner_name</span><span class=si>}</span><span class=s1>&#39;</span>  <span class=c1># noqa: E231</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.implementations.xccdf.RuleUse-attributes>Attributes<a href=#trestle.transforms.implementations.xccdf.RuleUse-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.benchmark_href class="doc doc-heading"> <code class="highlight language-python"><span class=n>benchmark_href</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_href&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.benchmark_href class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.benchmark_id class="doc doc-heading"> <code class="highlight language-python"><span class=n>benchmark_id</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_id&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.benchmark_id class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.host_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>host_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;host_name&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.host_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.id_ class="doc doc-heading"> <code class="highlight language-python"><span class=n>id_</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;id_&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.id_ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.idref class="doc doc-heading"> <code class="highlight language-python"><span class=n>idref</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;idref&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.idref class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.inventory_key class="doc doc-heading"> <code class="highlight language-python"><span class=n>inventory_key</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.inventory_key class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Derive inventory key.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.ns class="doc doc-heading"> <code class="highlight language-python"><span class=n>ns</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.ns class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Derive namespace.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.result class="doc doc-heading"> <code class="highlight language-python"><span class=n>result</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;result&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.result class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.scanner_name class="doc doc-heading"> <code class="highlight language-python"><span class=n>scanner_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_name&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.scanner_name class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.scanner_version class="doc doc-heading"> <code class="highlight language-python"><span class=n>scanner_version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_version&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.scanner_version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.severity class="doc doc-heading"> <code class="highlight language-python"><span class=n>severity</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;severity&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.severity class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.target class="doc doc-heading"> <code class="highlight language-python"><span class=n>target</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.target class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.target_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>target_type</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target_type&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.target_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.time class="doc doc-heading"> <code class="highlight language-python"><span class=n>time</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;time&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.time class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.version class="doc doc-heading"> <code class="highlight language-python"><span class=n>version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;version&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.version class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.weight class="doc doc-heading"> <code class="highlight language-python"><span class=n>weight</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;weight&#39;</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.RuleUse.weight class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> <h5 id=trestle.transforms.implementations.xccdf.RuleUse-functions>Functions<a href=#trestle.transforms.implementations.xccdf.RuleUse-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.xccdf.RuleUse.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>args</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.xccdf.RuleUse.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize given specified args.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>args</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize given specified args.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>id_</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;id_&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>target</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>target_type</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;target_type&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>host_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;host_name&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>benchmark_href</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_href&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>benchmark_id</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;benchmark_id&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>scanner_name</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_name&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>scanner_version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;scanner_version&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>idref</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;idref&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>version</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;version&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>time</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;time&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>result</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;result&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>severity</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;severity&#39;</span><span class=p>]</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>weight</span> <span class=o>=</span> <span class=n>args</span><span class=p>[</span><span class=s1>&#39;weight&#39;</span><span class=p>]</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer class="doc doc-heading"> <code>XccdfResultToOscalARTransformer</code> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.transformer_factory.ResultsTransformer href=../../transformer_factory/#trestle.transforms.transformer_factory.ResultsTransformer>ResultsTransformer</a></code></p> <p>Interface for Xccdf transformer.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 50</span>
+<span class=normal> 51</span>
+<span class=normal> 52</span>
+<span class=normal> 53</span>
+<span class=normal> 54</span>
+<span class=normal> 55</span>
+<span class=normal> 56</span>
+<span class=normal> 57</span>
+<span class=normal> 58</span>
+<span class=normal> 59</span>
+<span class=normal> 60</span>
+<span class=normal> 61</span>
+<span class=normal> 62</span>
+<span class=normal> 63</span>
+<span class=normal> 64</span>
+<span class=normal> 65</span>
+<span class=normal> 66</span>
+<span class=normal> 67</span>
+<span class=normal> 68</span>
+<span class=normal> 69</span>
+<span class=normal> 70</span>
+<span class=normal> 71</span>
+<span class=normal> 72</span>
+<span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>XccdfResultToOscalARTransformer</span><span class=p>(</span><span class=n>ResultsTransformer</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Interface for Xccdf transformer.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>analysis</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Analysis.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>analysis</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>checking</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return checking.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=s1>&#39;checking&#39;</span><span class=p>,</span> <span class=kc>False</span><span class=p>)</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>tags</span><span class=p>(</span><span class=bp>self</span><span class=p>):</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Return tags.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_tags</span>
+
+    <span class=k>def</span> <span class=nf>set_tags</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>tags</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Keep tags info (property name to property class).&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_tags</span> <span class=o>=</span> <span class=n>tags</span>
+
+    <span class=k>def</span> <span class=nf>set_title</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Keep title info.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_title</span> <span class=o>=</span> <span class=n>title</span>
+
+    <span class=k>def</span> <span class=nf>set_description</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>description</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Keep description info.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_description</span> <span class=o>=</span> <span class=n>description</span>
+
+    <span class=k>def</span> <span class=nf>set_type</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>type_</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Keep type info.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_type</span> <span class=o>=</span> <span class=n>type_</span>
+
+    <span class=k>def</span> <span class=nf>set_modes</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>modes</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Keep modes info.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=n>modes</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=n>modes</span>
+
+    <span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Transform the blob into a Results.</span>
+
+<span class=sd>        The expected blob is a string that is one of:</span>
+<span class=sd>            - data from OpenShift Compliance Operator (json, yaml, xml)</span>
+<span class=sd>            - data from Auditree XCCDF fetcher/check (json)</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span> <span class=o>=</span> <span class=n>_OscalResultsFactory</span><span class=p>(</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_title</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_description</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_timestamp</span><span class=p>(),</span> <span class=bp>self</span><span class=o>.</span><span class=n>checking</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>tags</span>
+        <span class=p>)</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_xml</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_json</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_yaml</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+
+    <span class=k>def</span> <span class=nf>_ingest_xml</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Results</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ingest xml data.&quot;&quot;&quot;</span>
+        <span class=c1># ?xml data</span>
+        <span class=k>if</span> <span class=n>blob</span><span class=o>.</span><span class=n>startswith</span><span class=p>(</span><span class=s1>&#39;&lt;?xml&#39;</span><span class=p>):</span>
+            <span class=n>resource</span> <span class=o>=</span> <span class=n>blob</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>ingest_xml</span><span class=p>(</span><span class=n>resource</span><span class=p>)</span>
+        <span class=k>else</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=n>Results</span><span class=p>()</span>
+        <span class=n>results</span><span class=o>.</span><span class=n>__root__</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>result</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+
+    <span class=k>def</span> <span class=nf>_ingest_configmaps</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>jdata</span><span class=p>:</span> <span class=nb>dict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ingest configmaps.&quot;&quot;&quot;</span>
+        <span class=n>items</span> <span class=o>=</span> <span class=n>jdata</span><span class=p>[</span><span class=s1>&#39;items&#39;</span><span class=p>]</span>
+        <span class=k>for</span> <span class=n>item</span> <span class=ow>in</span> <span class=n>items</span><span class=p>:</span>
+            <span class=k>if</span> <span class=s1>&#39;data&#39;</span> <span class=ow>in</span> <span class=n>item</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=n>data</span> <span class=o>=</span> <span class=n>item</span><span class=p>[</span><span class=s1>&#39;data&#39;</span><span class=p>]</span>
+                <span class=k>if</span> <span class=s1>&#39;results&#39;</span> <span class=ow>in</span> <span class=n>data</span><span class=p>:</span>
+                    <span class=n>resource</span> <span class=o>=</span> <span class=n>item</span>
+                    <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>ingest</span><span class=p>(</span><span class=n>resource</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_ingest_auditree</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>jdata</span><span class=p>:</span> <span class=nb>dict</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ingest auditree.&quot;&quot;&quot;</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>jdata</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=k>for</span> <span class=n>group</span> <span class=ow>in</span> <span class=n>jdata</span><span class=p>[</span><span class=n>key</span><span class=p>]:</span>
+                <span class=k>for</span> <span class=n>cluster</span> <span class=ow>in</span> <span class=n>jdata</span><span class=p>[</span><span class=n>key</span><span class=p>][</span><span class=n>group</span><span class=p>]:</span>
+                    <span class=k>if</span> <span class=s1>&#39;resources&#39;</span> <span class=ow>in</span> <span class=n>cluster</span><span class=p>:</span>
+                        <span class=k>for</span> <span class=n>resource</span> <span class=ow>in</span> <span class=n>cluster</span><span class=p>[</span><span class=s1>&#39;resources&#39;</span><span class=p>]:</span>
+                            <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>ingest</span><span class=p>(</span><span class=n>resource</span><span class=p>)</span>
+
+    <span class=k>def</span> <span class=nf>_ingest_json</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>Results</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ingest json data.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=c1># ? configmaps or auditree data</span>
+            <span class=n>jdata</span> <span class=o>=</span> <span class=n>json</span><span class=o>.</span><span class=n>loads</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+            <span class=c1># https://docs.openshift.com/container-platform/3.7/rest_api/api/v1.ConfigMap.html#Get-api-v1-namespaces-namespace-configmaps-name</span>
+            <span class=k>if</span> <span class=s1>&#39;kind&#39;</span> <span class=ow>in</span> <span class=n>jdata</span><span class=o>.</span><span class=n>keys</span><span class=p>()</span> <span class=ow>and</span> <span class=n>jdata</span><span class=p>[</span><span class=s1>&#39;kind&#39;</span><span class=p>]</span> <span class=o>==</span> <span class=s1>&#39;ConfigMapList&#39;</span> <span class=ow>and</span> <span class=s1>&#39;items&#39;</span> <span class=ow>in</span> <span class=n>jdata</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_configmaps</span><span class=p>(</span><span class=n>jdata</span><span class=p>)</span>
+            <span class=c1># https://github.com/ComplianceAsCode/auditree-arboretum/blob/main/arboretum/kubernetes/fetchers/fetch_cluster_resource.py</span>
+            <span class=k>else</span><span class=p>:</span>
+                <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_auditree</span><span class=p>(</span><span class=n>jdata</span><span class=p>)</span>
+        <span class=k>except</span> <span class=n>json</span><span class=o>.</span><span class=n>decoder</span><span class=o>.</span><span class=n>JSONDecodeError</span><span class=p>:</span>
+            <span class=k>return</span> <span class=kc>None</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=n>Results</span><span class=p>()</span>
+        <span class=n>results</span><span class=o>.</span><span class=n>__root__</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>result</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+
+    <span class=k>def</span> <span class=nf>_ingest_yaml</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Ingest yaml data.&quot;&quot;&quot;</span>
+        <span class=k>try</span><span class=p>:</span>
+            <span class=c1># ? yaml data</span>
+            <span class=n>yaml</span> <span class=o>=</span> <span class=n>YAML</span><span class=p>(</span><span class=n>typ</span><span class=o>=</span><span class=s1>&#39;safe&#39;</span><span class=p>)</span>
+            <span class=n>resource</span> <span class=o>=</span> <span class=n>yaml</span><span class=o>.</span><span class=n>load</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>ingest</span><span class=p>(</span><span class=n>resource</span><span class=p>)</span>
+        <span class=k>except</span> <span class=ne>Exception</span> <span class=k>as</span> <span class=n>e</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=ne>RuntimeError</span><span class=p>(</span><span class=n>e</span><span class=p>)</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=n>Results</span><span class=p>()</span>
+        <span class=n>results</span><span class=o>.</span><span class=n>__root__</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span><span class=o>.</span><span class=n>result</span><span class=p>)</span>
+        <span class=k>return</span> <span class=n>results</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-attributes>Attributes<a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.analysis class="doc doc-heading"> <code class="highlight language-python"><span class=n>analysis</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.analysis class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Analysis.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.checking class="doc doc-heading"> <code class="highlight language-python"><span class=n>checking</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.checking class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return checking.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.tags class="doc doc-heading"> <code class="highlight language-python"><span class=n>tags</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.tags class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Return tags.</p> </div> </div> <h5 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-functions>Functions<a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_description class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_description</span><span class=p>(</span><span class=n>description</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_description class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Keep description info.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_description</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>description</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Keep description info.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_description</span> <span class=o>=</span> <span class=n>description</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_modes class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_modes</span><span class=p>(</span><span class=n>modes</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_modes class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Keep modes info.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_modes</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>modes</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Keep modes info.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=n>modes</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_modes</span> <span class=o>=</span> <span class=n>modes</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_tags class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_tags</span><span class=p>(</span><span class=n>tags</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_tags class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Keep tags info (property name to property class).</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_tags</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>tags</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>str</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Keep tags info (property name to property class).&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_tags</span> <span class=o>=</span> <span class=n>tags</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_title class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_title</span><span class=p>(</span><span class=n>title</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_title class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Keep title info.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_title</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>title</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Keep title info.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_title</span> <span class=o>=</span> <span class=n>title</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_type class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_type</span><span class=p>(</span><span class=n>type_</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_type class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Keep type info.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>set_type</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>type_</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Keep type info.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_type</span> <span class=o>=</span> <span class=n>type_</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.transform class="doc doc-heading"> <code class="highlight language-python"><span class=n>transform</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span></code> <a href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.transform class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Transform the blob into a Results.</p> <details class=the-expected-blob-is-a-string-that-is-one-of open> <summary>The expected blob is a string that is one of</summary> <ul> <li>data from OpenShift Compliance Operator (json, yaml, xml)</li> <li>data from Auditree XCCDF fetcher/check (json)</li> </ul> </details> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transform the blob into a Results.</span>
+
+<span class=sd>    The expected blob is a string that is one of:</span>
+<span class=sd>        - data from OpenShift Compliance Operator (json, yaml, xml)</span>
+<span class=sd>        - data from Auditree XCCDF fetcher/check (json)</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_results_factory</span> <span class=o>=</span> <span class=n>_OscalResultsFactory</span><span class=p>(</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_title</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_description</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>_type</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>get_timestamp</span><span class=p>(),</span> <span class=bp>self</span><span class=o>.</span><span class=n>checking</span><span class=p>,</span> <span class=bp>self</span><span class=o>.</span><span class=n>tags</span>
+    <span class=p>)</span>
+    <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_xml</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_json</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>results</span> <span class=ow>is</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=n>results</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_ingest_yaml</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span>
+    <span class=k>return</span> <span class=n>results</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.implementations.xccdf.XccdfTransformer class="doc doc-heading"> <code>XccdfTransformer</code> <a href=#trestle.transforms.implementations.xccdf.XccdfTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer href=#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer>XccdfResultToOscalARTransformer</a></code></p> <p>Legacy class name.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/implementations/xccdf.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>172</span>
+<span class=normal>173</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>XccdfTransformer</span><span class=p>(</span><span class=n>XccdfResultToOscalARTransformer</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Legacy class name.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/transforms/results/index.html b/latest/reference/API/trestle/transforms/results/index.html
new file mode 100644
index 000000000..a242276ca
--- /dev/null
+++ b/latest/reference/API/trestle/transforms/results/index.html
@@ -0,0 +1,8 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.transforms.results module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/results/ rel=canonical><link href=../../tasks/xlsx_to_oscal_profile/ rel=prev><link href=../transformer_factory/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.transforms.results - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.transforms.results - Compliance Trestle"><meta property=og:description content="Documentation for trestle.transforms.results module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/results.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/results/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.transforms.results - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.transforms.results module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/results.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.transforms.results class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.transforms.results </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6 checked> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.transforms.results </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.transforms.results </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.results class=md-nav__link> <span class=md-ellipsis> results </span> </a> <nav class=md-nav aria-label=results> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.results-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.results.Results class=md-nav__link> <span class=md-ellipsis> Results </span> </a> <nav class=md-nav aria-label=Results> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.results.Results-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.results.Results.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.results class=md-nav__link> <span class=md-ellipsis> results </span> </a> <nav class=md-nav aria-label=results> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.results-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.results.Results class=md-nav__link> <span class=md-ellipsis> Results </span> </a> <nav class=md-nav aria-label=Results> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.results.Results-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.results.Results.__root__ class=md-nav__link> <span class=md-ellipsis> __root__ </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.transforms.results</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.transforms.results class="doc doc-heading"> <code>trestle.transforms.results</code> <a href=#trestle.transforms.results class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Define Results class returned by transformers.</p> <div class="doc doc-children"> <h3 id=trestle.transforms.results-classes>Classes<a href=#trestle.transforms.results-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.results.Results class="doc doc-heading"> <code>Results</code> <a href=#trestle.transforms.results.Results class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.core.base_model.OscalBaseModel href=../../core/base_model/#trestle.core.base_model.OscalBaseModel>OscalBaseModel</a></code></p> <p>Transformer results as a list.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/results.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>24</span>
+<span class=normal>25</span>
+<span class=normal>26</span>
+<span class=normal>27</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>Results</span><span class=p>(</span><span class=n>OscalBaseModel</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transformer results as a list.&quot;&quot;&quot;</span>
+
+    <span class=n>__root__</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Result</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.results.Results-attributes>Attributes<a href=#trestle.transforms.results.Results-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.results.Results.__root__ class="doc doc-heading"> <code class="highlight language-python"><span class=n>__root__</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Result</span><span class=p>]</span> <span class=o>=</span> <span class=p>[]</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-class-attribute"><code>class-attribute</code></small> <small class="doc doc-label doc-label-instance-attribute"><code>instance-attribute</code></small> </span> <a href=#trestle.transforms.results.Results.__root__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/transforms/transformer_factory/index.html b/latest/reference/API/trestle/transforms/transformer_factory/index.html
new file mode 100644
index 000000000..884625ac1
--- /dev/null
+++ b/latest/reference/API/trestle/transforms/transformer_factory/index.html
@@ -0,0 +1,251 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.transforms.transformer_factory module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/transformer_factory/ rel=canonical><link href=../results/ rel=prev><link href=../transformer_helper/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.transforms.transformer_factory - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.transforms.transformer_factory - Compliance Trestle"><meta property=og:description content="Documentation for trestle.transforms.transformer_factory module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/transformer_factory.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/transformer_factory/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.transforms.transformer_factory - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.transforms.transformer_factory module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/transformer_factory.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.transforms.transformer_factory class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6 checked> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory class=md-nav__link> <span class=md-ellipsis> transformer_factory </span> </a> <nav class=md-nav aria-label=transformer_factory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.FromOscalTransformer class=md-nav__link> <span class=md-ellipsis> FromOscalTransformer </span> </a> <nav class=md-nav aria-label=FromOscalTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.FromOscalTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.FromOscalTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ResultsTransformer class=md-nav__link> <span class=md-ellipsis> ResultsTransformer </span> </a> <nav class=md-nav aria-label=ResultsTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ResultsTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ResultsTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ToOscalTransformer class=md-nav__link> <span class=md-ellipsis> ToOscalTransformer </span> </a> <nav class=md-nav aria-label=ToOscalTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ToOscalTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ToOscalTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase class=md-nav__link> <span class=md-ellipsis> TransformerBase </span> </a> <nav class=md-nav aria-label=TransformerBase> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase.get_timestamp class=md-nav__link> <span class=md-ellipsis> get_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase.set_timestamp class=md-nav__link> <span class=md-ellipsis> set_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory class=md-nav__link> <span class=md-ellipsis> TransformerFactory </span> </a> <nav class=md-nav aria-label=TransformerFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory.register_transformer class=md-nav__link> <span class=md-ellipsis> register_transformer </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory class=md-nav__link> <span class=md-ellipsis> transformer_factory </span> </a> <nav class=md-nav aria-label=transformer_factory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.FromOscalTransformer class=md-nav__link> <span class=md-ellipsis> FromOscalTransformer </span> </a> <nav class=md-nav aria-label=FromOscalTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.FromOscalTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.FromOscalTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ResultsTransformer class=md-nav__link> <span class=md-ellipsis> ResultsTransformer </span> </a> <nav class=md-nav aria-label=ResultsTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ResultsTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ResultsTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ToOscalTransformer class=md-nav__link> <span class=md-ellipsis> ToOscalTransformer </span> </a> <nav class=md-nav aria-label=ToOscalTransformer> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ToOscalTransformer-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.ToOscalTransformer.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase class=md-nav__link> <span class=md-ellipsis> TransformerBase </span> </a> <nav class=md-nav aria-label=TransformerBase> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase.get_timestamp class=md-nav__link> <span class=md-ellipsis> get_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase.set_timestamp class=md-nav__link> <span class=md-ellipsis> set_timestamp </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerBase.transform class=md-nav__link> <span class=md-ellipsis> transform </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory class=md-nav__link> <span class=md-ellipsis> TransformerFactory </span> </a> <nav class=md-nav aria-label=TransformerFactory> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory.get class=md-nav__link> <span class=md-ellipsis> get </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_factory.TransformerFactory.register_transformer class=md-nav__link> <span class=md-ellipsis> register_transformer </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.transforms.transformer_factory</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.transforms.transformer_factory class="doc doc-heading"> <code>trestle.transforms.transformer_factory</code> <a href=#trestle.transforms.transformer_factory class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Define the TransformerFactory and corresponding transformer classes it creates.</p> <div class="doc doc-children"> <h3 id=trestle.transforms.transformer_factory-classes>Classes<a href=#trestle.transforms.transformer_factory-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.transformer_factory.FromOscalTransformer class="doc doc-heading"> <code>FromOscalTransformer</code> <a href=#trestle.transforms.transformer_factory.FromOscalTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.transformer_factory.TransformerBase href=#trestle.transforms.transformer_factory.TransformerBase>TransformerBase</a></code></p> <p>Abstract interface for transformers from OSCAL.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>FromOscalTransformer</span><span class=p>(</span><span class=n>TransformerBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Abstract interface for transformers from OSCAL.&quot;&quot;&quot;</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>obj</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Transform the from OSCAL.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.transformer_factory.FromOscalTransformer-functions>Functions<a href=#trestle.transforms.transformer_factory.FromOscalTransformer-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_factory.FromOscalTransformer.transform class="doc doc-heading"> <code class="highlight language-python"><span class=n>transform</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.transforms.transformer_factory.FromOscalTransformer.transform class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Transform the from OSCAL.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>obj</span><span class=p>:</span> <span class=n>OscalBaseModel</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transform the from OSCAL.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.transformer_factory.ResultsTransformer class="doc doc-heading"> <code>ResultsTransformer</code> <a href=#trestle.transforms.transformer_factory.ResultsTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.transformer_factory.TransformerBase href=#trestle.transforms.transformer_factory.TransformerBase>TransformerBase</a></code></p> <p>Abstract interface for transformers that specifically return Results.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ResultsTransformer</span><span class=p>(</span><span class=n>TransformerBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Abstract interface for transformers that specifically return Results.&quot;&quot;&quot;</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Transform the blob into Results.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.transformer_factory.ResultsTransformer-functions>Functions<a href=#trestle.transforms.transformer_factory.ResultsTransformer-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_factory.ResultsTransformer.transform class="doc doc-heading"> <code class="highlight language-python"><span class=n>transform</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.transforms.transformer_factory.ResultsTransformer.transform class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Transform the blob into Results.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Results</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transform the blob into Results.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.transformer_factory.ToOscalTransformer class="doc doc-heading"> <code>ToOscalTransformer</code> <a href=#trestle.transforms.transformer_factory.ToOscalTransformer class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><a class="autorefs autorefs-internal" title=trestle.transforms.transformer_factory.TransformerBase href=#trestle.transforms.transformer_factory.TransformerBase>TransformerBase</a></code></p> <p>Abstract interface for transformers to OSCAL.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>ToOscalTransformer</span><span class=p>(</span><span class=n>TransformerBase</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Abstract interface for transformers to OSCAL.&quot;&quot;&quot;</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>obj</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>OscalBaseModel</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Transform the to OSCAL.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.transformer_factory.ToOscalTransformer-functions>Functions<a href=#trestle.transforms.transformer_factory.ToOscalTransformer-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_factory.ToOscalTransformer.transform class="doc doc-heading"> <code class="highlight language-python"><span class=n>transform</span><span class=p>(</span><span class=n>obj</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.transforms.transformer_factory.ToOscalTransformer.transform class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Transform the to OSCAL.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>obj</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>OscalBaseModel</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transform the to OSCAL.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.transformer_factory.TransformerBase class="doc doc-heading"> <code>TransformerBase</code> <a href=#trestle.transforms.transformer_factory.TransformerBase class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p class="doc doc-class-bases"> Bases: <code><span title=abc.ABC>ABC</span></code></p> <p>Abstract base interface for all transformers.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>27</span>
+<span class=normal>28</span>
+<span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TransformerBase</span><span class=p>(</span><span class=n>ABC</span><span class=p>):</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Abstract base interface for all transformers.&quot;&quot;&quot;</span>
+
+    <span class=c1># the current time for consistent timestamping</span>
+    <span class=n>_timestamp</span> <span class=o>=</span> <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>now</span><span class=p>(</span><span class=n>datetime</span><span class=o>.</span><span class=n>timezone</span><span class=o>.</span><span class=n>utc</span><span class=p>)</span><span class=o>.</span><span class=n>replace</span><span class=p>(</span><span class=n>microsecond</span><span class=o>=</span><span class=mi>0</span><span class=p>)</span><span class=o>.</span><span class=n>isoformat</span><span class=p>()</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>set_timestamp</span><span class=p>(</span><span class=n>value</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Set the default timestamp value.&quot;&quot;&quot;</span>
+        <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>strptime</span><span class=p>(</span><span class=n>value</span><span class=p>,</span> <span class=s1>&#39;%Y-%m-</span><span class=si>%d</span><span class=s1>T%H:%M:%S%z&#39;</span><span class=p>)</span>
+        <span class=n>TransformerBase</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>value</span>
+
+    <span class=nd>@staticmethod</span>
+    <span class=k>def</span> <span class=nf>get_timestamp</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get the default timestamp value.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=n>TransformerBase</span><span class=o>.</span><span class=n>_timestamp</span>
+
+    <span class=nd>@abstractmethod</span>
+    <span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Transform the blob into a general OscalBaseModel.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.transformer_factory.TransformerBase-functions>Functions<a href=#trestle.transforms.transformer_factory.TransformerBase-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_factory.TransformerBase.get_timestamp class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_timestamp</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.transforms.transformer_factory.TransformerBase.get_timestamp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get the default timestamp value.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>get_timestamp</span><span class=p>()</span> <span class=o>-&gt;</span> <span class=nb>str</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get the default timestamp value.&quot;&quot;&quot;</span>
+    <span class=k>return</span> <span class=n>TransformerBase</span><span class=o>.</span><span class=n>_timestamp</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_factory.TransformerBase.set_timestamp class="doc doc-heading"> <code class="highlight language-python"><span class=n>set_timestamp</span><span class=p>(</span><span class=n>value</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-staticmethod"><code>staticmethod</code></small> </span> <a href=#trestle.transforms.transformer_factory.TransformerBase.set_timestamp class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Set the default timestamp value.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@staticmethod</span>
+<span class=k>def</span> <span class=nf>set_timestamp</span><span class=p>(</span><span class=n>value</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Set the default timestamp value.&quot;&quot;&quot;</span>
+    <span class=n>datetime</span><span class=o>.</span><span class=n>datetime</span><span class=o>.</span><span class=n>strptime</span><span class=p>(</span><span class=n>value</span><span class=p>,</span> <span class=s1>&#39;%Y-%m-</span><span class=si>%d</span><span class=s1>T%H:%M:%S%z&#39;</span><span class=p>)</span>
+    <span class=n>TransformerBase</span><span class=o>.</span><span class=n>_timestamp</span> <span class=o>=</span> <span class=n>value</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_factory.TransformerBase.transform class="doc doc-heading"> <code class="highlight language-python"><span class=n>transform</span><span class=p>(</span><span class=n>blob</span><span class=p>)</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-abstractmethod"><code>abstractmethod</code></small> </span> <a href=#trestle.transforms.transformer_factory.TransformerBase.transform class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Transform the blob into a general OscalBaseModel.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span></pre></div></td><td class=code><div><pre><span></span><code><span class=nd>@abstractmethod</span>
+<span class=k>def</span> <span class=nf>transform</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>blob</span><span class=p>:</span> <span class=n>Any</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Any</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Transform the blob into a general OscalBaseModel.&quot;&quot;&quot;</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.transformer_factory.TransformerFactory class="doc doc-heading"> <code>TransformerFactory</code> <a href=#trestle.transforms.transformer_factory.TransformerFactory class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Perform registration and creation of transformers.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 73</span>
+<span class=normal> 74</span>
+<span class=normal> 75</span>
+<span class=normal> 76</span>
+<span class=normal> 77</span>
+<span class=normal> 78</span>
+<span class=normal> 79</span>
+<span class=normal> 80</span>
+<span class=normal> 81</span>
+<span class=normal> 82</span>
+<span class=normal> 83</span>
+<span class=normal> 84</span>
+<span class=normal> 85</span>
+<span class=normal> 86</span>
+<span class=normal> 87</span>
+<span class=normal> 88</span>
+<span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TransformerFactory</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Perform registration and creation of transformers.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize the transformers dictionary as empty.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_transformers</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Type</span><span class=p>[</span><span class=n>TransformerBase</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=k>def</span> <span class=nf>register_transformer</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>transformer</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>TransformerBase</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Register the transformer.</span>
+
+<span class=sd>        This registers transformers in the factory so they may be created by name.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            name (str): The name of the transformer.</span>
+<span class=sd>            transformer (TransformerBase): The transformer class to be registered.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            None</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_transformers</span><span class=p>[</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=n>transformer</span>
+
+    <span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TransformerBase</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>        Create an instance of the desired transformer based its name.</span>
+
+<span class=sd>        Args:</span>
+<span class=sd>            name (str): The name of the transformer.</span>
+
+<span class=sd>        Returns:</span>
+<span class=sd>            An instance of the desired transformer.</span>
+
+<span class=sd>        Raises:</span>
+<span class=sd>            TrestleError: if the name does not exist in the registry.</span>
+<span class=sd>        &quot;&quot;&quot;</span>
+        <span class=n>t</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transformers</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>t</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>t</span><span class=p>()</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error getting non-registered transform </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.transformer_factory.TransformerFactory-functions>Functions<a href=#trestle.transforms.transformer_factory.TransformerFactory-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_factory.TransformerFactory.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.transforms.transformer_factory.TransformerFactory.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize the transformers dictionary as empty.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize the transformers dictionary as empty.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_transformers</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Type</span><span class=p>[</span><span class=n>TransformerBase</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_factory.TransformerFactory.get class="doc doc-heading"> <code class="highlight language-python"><span class=n>get</span><span class=p>(</span><span class=n>name</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_factory.TransformerFactory.get class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Create an instance of the desired transformer based its name.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The name of the transformer.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.transforms.transformer_factory.TransformerBase href=#trestle.transforms.transformer_factory.TransformerBase>TransformerBase</a></code> </td> <td> <div class=doc-md-description> <p>An instance of the desired transformer.</p> </div> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Raises:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code><a class="autorefs autorefs-internal" title=trestle.common.err.TrestleError href=../../common/err/#trestle.common.err.TrestleError>TrestleError</a></code> </td> <td> <div class=doc-md-description> <p>if the name does not exist in the registry.</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>TransformerBase</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Create an instance of the desired transformer based its name.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        name (str): The name of the transformer.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        An instance of the desired transformer.</span>
+
+<span class=sd>    Raises:</span>
+<span class=sd>        TrestleError: if the name does not exist in the registry.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=n>t</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_transformers</span><span class=o>.</span><span class=n>get</span><span class=p>(</span><span class=n>name</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>t</span> <span class=ow>is</span> <span class=ow>not</span> <span class=kc>None</span><span class=p>:</span>
+        <span class=k>return</span> <span class=n>t</span><span class=p>()</span>
+    <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=sa>f</span><span class=s1>&#39;Error getting non-registered transform </span><span class=si>{</span><span class=n>name</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>)</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_factory.TransformerFactory.register_transformer class="doc doc-heading"> <code class="highlight language-python"><span class=n>register_transformer</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>transformer</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_factory.TransformerFactory.register_transformer class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Register the transformer.</p> <p>This registers transformers in the factory so they may be created by name.</p> <p><span class=doc-section-title>Parameters:</span></p> <table> <thead> <tr> <th>Name</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>name</code> </td> <td> <code>str</code> </td> <td> <div class=doc-md-description> <p>The name of the transformer.</p> </div> </td> <td> <em>required</em> </td> </tr> <tr class=doc-section-item> <td> <code>transformer</code> </td> <td> <code><a class="autorefs autorefs-internal" title=trestle.transforms.transformer_factory.TransformerBase href=#trestle.transforms.transformer_factory.TransformerBase>TransformerBase</a></code> </td> <td> <div class=doc-md-description> <p>The transformer class to be registered.</p> </div> </td> <td> <em>required</em> </td> </tr> </tbody> </table> <p><span class=doc-section-title>Returns:</span></p> <table> <thead> <tr> <th>Type</th> <th>Description</th> </tr> </thead> <tbody> <tr class=doc-section-item> <td> <code>None</code> </td> <td> <div class=doc-md-description> <p>None</p> </div> </td> </tr> </tbody> </table> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_factory.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span>
+<span class=normal>87</span>
+<span class=normal>88</span>
+<span class=normal>89</span>
+<span class=normal>90</span>
+<span class=normal>91</span>
+<span class=normal>92</span>
+<span class=normal>93</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>register_transformer</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>name</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span> <span class=n>transformer</span><span class=p>:</span> <span class=n>Type</span><span class=p>[</span><span class=n>TransformerBase</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;</span>
+<span class=sd>    Register the transformer.</span>
+
+<span class=sd>    This registers transformers in the factory so they may be created by name.</span>
+
+<span class=sd>    Args:</span>
+<span class=sd>        name (str): The name of the transformer.</span>
+<span class=sd>        transformer (TransformerBase): The transformer class to be registered.</span>
+
+<span class=sd>    Returns:</span>
+<span class=sd>        None</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_transformers</span><span class=p>[</span><span class=n>name</span><span class=p>]</span> <span class=o>=</span> <span class=n>transformer</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/transforms/transformer_helper/index.html b/latest/reference/API/trestle/transforms/transformer_helper/index.html
new file mode 100644
index 000000000..b9688f441
--- /dev/null
+++ b/latest/reference/API/trestle/transforms/transformer_helper/index.html
@@ -0,0 +1,585 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.transforms.transformer_helper module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/transformer_helper/ rel=canonical><link href=../transformer_factory/ rel=prev><link href=../transformer_singleton/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.transforms.transformer_helper - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.transforms.transformer_helper - Compliance Trestle"><meta property=og:description content="Documentation for trestle.transforms.transformer_helper module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/transformer_helper.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/transformer_helper/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.transforms.transformer_helper - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.transforms.transformer_helper module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/transformer_helper.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.transforms.transformer_helper class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6 checked> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper class=md-nav__link> <span class=md-ellipsis> transformer_helper </span> </a> <nav class=md-nav aria-label=transformer_helper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting class=md-nav__link> <span class=md-ellipsis> PropertyAccounting </span> </a> <nav class=md-nav aria-label=PropertyAccounting> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.count_group class=md-nav__link> <span class=md-ellipsis> count_group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.count_property class=md-nav__link> <span class=md-ellipsis> count_property </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.is_common_property class=md-nav__link> <span class=md-ellipsis> is_common_property </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager class=md-nav__link> <span class=md-ellipsis> PropertyManager </span> </a> <nav class=md-nav aria-label=PropertyManager> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.hits class=md-nav__link> <span class=md-ellipsis> hits </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.requests class=md-nav__link> <span class=md-ellipsis> requests </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.get_common_properties class=md-nav__link> <span class=md-ellipsis> get_common_properties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.materialize class=md-nav__link> <span class=md-ellipsis> materialize </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.put_common_property class=md-nav__link> <span class=md-ellipsis> put_common_property </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.TransformerHelper class=md-nav__link> <span class=md-ellipsis> TransformerHelper </span> </a> <nav class=md-nav aria-label=TransformerHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.TransformerHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.TransformerHelper.remove_common_observation_properties class=md-nav__link> <span class=md-ellipsis> remove_common_observation_properties </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper class=md-nav__link> <span class=md-ellipsis> transformer_helper </span> </a> <nav class=md-nav aria-label=transformer_helper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> <nav class=md-nav aria-label=Classes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting class=md-nav__link> <span class=md-ellipsis> PropertyAccounting </span> </a> <nav class=md-nav aria-label=PropertyAccounting> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.count_group class=md-nav__link> <span class=md-ellipsis> count_group </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.count_property class=md-nav__link> <span class=md-ellipsis> count_property </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.is_common_property class=md-nav__link> <span class=md-ellipsis> is_common_property </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager class=md-nav__link> <span class=md-ellipsis> PropertyManager </span> </a> <nav class=md-nav aria-label=PropertyManager> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.hits class=md-nav__link> <span class=md-ellipsis> hits </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.requests class=md-nav__link> <span class=md-ellipsis> requests </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.__init__ class=md-nav__link> <span class=md-ellipsis> __init__ </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.get_common_properties class=md-nav__link> <span class=md-ellipsis> get_common_properties </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.materialize class=md-nav__link> <span class=md-ellipsis> materialize </span> </a> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.PropertyManager.put_common_property class=md-nav__link> <span class=md-ellipsis> put_common_property </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.TransformerHelper class=md-nav__link> <span class=md-ellipsis> TransformerHelper </span> </a> <nav class=md-nav aria-label=TransformerHelper> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.TransformerHelper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> <nav class=md-nav aria-label=Functions> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper.TransformerHelper.remove_common_observation_properties class=md-nav__link> <span class=md-ellipsis> remove_common_observation_properties </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_helper-functions class=md-nav__link> <span class=md-ellipsis> Functions </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.transforms.transformer_helper</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.transforms.transformer_helper class="doc doc-heading"> <code>trestle.transforms.transformer_helper</code> <a href=#trestle.transforms.transformer_helper class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Transformer helper functions.</p> <div class="doc doc-children"> <h3 id=trestle.transforms.transformer_helper-classes>Classes<a href=#trestle.transforms.transformer_helper-classes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.transformer_helper.PropertyAccounting class="doc doc-heading"> <code>PropertyAccounting</code> <a href=#trestle.transforms.transformer_helper.PropertyAccounting class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Property accounting class.</p> <p>Help transformers do accounting.</p> <blockquote> <p>Each time a new record is processed the transformer calls count_group. For each attribute on that record, the transformer calls count_property. - If the property already exactly exists, then its count is incremented. - Otherwise, a new entry is made and the count for that property is set to 1. When the transformer wants to know if a property (name, value, ns, and class) is common to all records for the group, is_common_property is employed to check that the number of records in the group is equal to the number of duplicates there are for the property. If equal, then the property is common.</p> </blockquote> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>29</span>
+<span class=normal>30</span>
+<span class=normal>31</span>
+<span class=normal>32</span>
+<span class=normal>33</span>
+<span class=normal>34</span>
+<span class=normal>35</span>
+<span class=normal>36</span>
+<span class=normal>37</span>
+<span class=normal>38</span>
+<span class=normal>39</span>
+<span class=normal>40</span>
+<span class=normal>41</span>
+<span class=normal>42</span>
+<span class=normal>43</span>
+<span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span>
+<span class=normal>48</span>
+<span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span>
+<span class=normal>56</span>
+<span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span>
+<span class=normal>72</span>
+<span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PropertyAccounting</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Property accounting class.</span>
+
+<span class=sd>    Help transformers do accounting.</span>
+
+<span class=sd>    &gt; Each time a new record is processed the transformer calls count_group.</span>
+<span class=sd>    &gt; For each attribute on that record, the transformer calls count_property.</span>
+<span class=sd>      - If the property already exactly exists, then its count is incremented.</span>
+<span class=sd>      - Otherwise, a new entry is made and the count for that property is set to 1.</span>
+<span class=sd>    &gt; When the transformer wants to know if a property (name, value, ns, and class)</span>
+<span class=sd>      is common to all records for the group, is_common_property is employed to check</span>
+<span class=sd>      that the number of records in the group is equal to the number of duplicates</span>
+<span class=sd>      there are for the property. If equal, then the property is common.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>int</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>int</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=k>def</span> <span class=nf>count_group</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Group accounting.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>group</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;count_group created with group=None&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>group</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>+=</span> <span class=mi>1</span>
+
+    <span class=k>def</span> <span class=nf>count_property</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>group</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Property accounting.&quot;&quot;&quot;</span>
+        <span class=n>key</span> <span class=o>=</span> <span class=n>_segment_separator</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>class_</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>ns</span><span class=p>)])</span>
+        <span class=k>if</span> <span class=n>group</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>]:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>][</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>][</span><span class=n>key</span><span class=p>]</span> <span class=o>+=</span> <span class=mi>1</span>
+
+    <span class=k>def</span> <span class=nf>is_common_property</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>group</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Check for common property.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=kc>False</span>
+        <span class=n>key</span> <span class=o>=</span> <span class=n>_segment_separator</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>class_</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>ns</span><span class=p>)])</span>
+        <span class=k>if</span> <span class=n>group</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span> <span class=ow>and</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>]:</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>][</span><span class=n>key</span><span class=p>]</span>
+        <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.transformer_helper.PropertyAccounting-functions>Functions<a href=#trestle.transforms.transformer_helper.PropertyAccounting-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_helper.PropertyAccounting.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>()</span></code> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>44</span>
+<span class=normal>45</span>
+<span class=normal>46</span>
+<span class=normal>47</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>int</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=nb>int</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_helper.PropertyAccounting.count_group class="doc doc-heading"> <code class="highlight language-python"><span class=n>count_group</span><span class=p>(</span><span class=n>group</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.count_group class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Group accounting.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>49</span>
+<span class=normal>50</span>
+<span class=normal>51</span>
+<span class=normal>52</span>
+<span class=normal>53</span>
+<span class=normal>54</span>
+<span class=normal>55</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>count_group</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Group accounting.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>group</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;count_group created with group=None&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>group</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>+=</span> <span class=mi>1</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_helper.PropertyAccounting.count_property class="doc doc-heading"> <code class="highlight language-python"><span class=n>count_property</span><span class=p>(</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.count_property class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Property accounting.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>57</span>
+<span class=normal>58</span>
+<span class=normal>59</span>
+<span class=normal>60</span>
+<span class=normal>61</span>
+<span class=normal>62</span>
+<span class=normal>63</span>
+<span class=normal>64</span>
+<span class=normal>65</span>
+<span class=normal>66</span>
+<span class=normal>67</span>
+<span class=normal>68</span>
+<span class=normal>69</span>
+<span class=normal>70</span>
+<span class=normal>71</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>count_property</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>group</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Property accounting.&quot;&quot;&quot;</span>
+    <span class=n>key</span> <span class=o>=</span> <span class=n>_segment_separator</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>class_</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>ns</span><span class=p>)])</span>
+    <span class=k>if</span> <span class=n>group</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>]:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>][</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>][</span><span class=n>key</span><span class=p>]</span> <span class=o>+=</span> <span class=mi>1</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_helper.PropertyAccounting.is_common_property class="doc doc-heading"> <code class="highlight language-python"><span class=n>is_common_property</span><span class=p>(</span><span class=n>group</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_helper.PropertyAccounting.is_common_property class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Check for common property.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>73</span>
+<span class=normal>74</span>
+<span class=normal>75</span>
+<span class=normal>76</span>
+<span class=normal>77</span>
+<span class=normal>78</span>
+<span class=normal>79</span>
+<span class=normal>80</span>
+<span class=normal>81</span>
+<span class=normal>82</span>
+<span class=normal>83</span>
+<span class=normal>84</span>
+<span class=normal>85</span>
+<span class=normal>86</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>is_common_property</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>group</span><span class=p>:</span> <span class=nb>str</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>bool</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Check for common property.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=kc>False</span>
+    <span class=n>key</span> <span class=o>=</span> <span class=n>_segment_separator</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>class_</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>ns</span><span class=p>)])</span>
+    <span class=k>if</span> <span class=n>group</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span> <span class=ow>and</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>]:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_group_map</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>==</span> <span class=bp>self</span><span class=o>.</span><span class=n>_property_map</span><span class=p>[</span><span class=n>group</span><span class=p>][</span><span class=n>key</span><span class=p>]</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.transformer_helper.PropertyManager class="doc doc-heading"> <code>PropertyManager</code> <a href=#trestle.transforms.transformer_helper.PropertyManager class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>Property manager class.</p> <p>Help transformer manage properties.</p> <blockquote> <p>Use materialize to: fetch a property from cache (if caching), else create a new property instance and keep in cache (if caching). Use put_common_property to: keep common properties for each group. Use get_common_properties to: recall the list of common properties for the group.</p> </blockquote> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal> 89</span>
+<span class=normal> 90</span>
+<span class=normal> 91</span>
+<span class=normal> 92</span>
+<span class=normal> 93</span>
+<span class=normal> 94</span>
+<span class=normal> 95</span>
+<span class=normal> 96</span>
+<span class=normal> 97</span>
+<span class=normal> 98</span>
+<span class=normal> 99</span>
+<span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span>
+<span class=normal>108</span>
+<span class=normal>109</span>
+<span class=normal>110</span>
+<span class=normal>111</span>
+<span class=normal>112</span>
+<span class=normal>113</span>
+<span class=normal>114</span>
+<span class=normal>115</span>
+<span class=normal>116</span>
+<span class=normal>117</span>
+<span class=normal>118</span>
+<span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span>
+<span class=normal>138</span>
+<span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span>
+<span class=normal>156</span>
+<span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span>
+<span class=normal>165</span>
+<span class=normal>166</span>
+<span class=normal>167</span>
+<span class=normal>168</span>
+<span class=normal>169</span>
+<span class=normal>170</span>
+<span class=normal>171</span>
+<span class=normal>172</span>
+<span class=normal>173</span>
+<span class=normal>174</span>
+<span class=normal>175</span>
+<span class=normal>176</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>PropertyManager</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Property manager class.</span>
+
+<span class=sd>    Help transformer manage properties.</span>
+
+<span class=sd>    &gt; Use materialize to: fetch a property from cache (if caching), else create a new</span>
+<span class=sd>      property instance and keep in cache (if caching).</span>
+<span class=sd>    &gt; Use put_common_property to: keep common properties for each group.</span>
+<span class=sd>    &gt; Use get_common_properties to: recall the list of common properties for the group.</span>
+<span class=sd>    &quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>caching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span> <span class=n>checking</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_caching</span> <span class=o>=</span> <span class=n>caching</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_checking</span> <span class=o>=</span> <span class=n>checking</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_requests</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_hits</span> <span class=o>=</span> <span class=mi>0</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_map_unique</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>requests</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Cache requests.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_requests</span>
+
+    <span class=nd>@property</span>
+    <span class=k>def</span> <span class=nf>hits</span><span class=p>(</span><span class=bp>self</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=nb>int</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Cache hits.&quot;&quot;&quot;</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_hits</span>
+
+    <span class=k>def</span> <span class=nf>materialize</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Property</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Get property from cache or create new property.&quot;&quot;&quot;</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_requests</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=c1># try fetch from cache</span>
+        <span class=n>key</span> <span class=o>=</span> <span class=n>_segment_separator</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>class_</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>ns</span><span class=p>)])</span>
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_unique</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_hits</span> <span class=o>+=</span> <span class=mi>1</span>
+            <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_unique</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+        <span class=c1># create new property and put into cache if caching</span>
+        <span class=n>prop</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=n>class_</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>)</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_caching</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_map_unique</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span>
+        <span class=k>return</span> <span class=n>prop</span>
+
+    <span class=k>def</span> <span class=nf>put_common_property</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>group</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Remember common property.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>group</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;put_common_property created with group=None&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>group</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>:</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=n>key</span> <span class=o>=</span> <span class=n>_segment_separator</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>class_</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>ns</span><span class=p>)])</span>
+        <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>[</span><span class=n>group</span><span class=p>]:</span>
+            <span class=n>prop</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>materialize</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>class_</span><span class=p>,</span> <span class=n>ns</span><span class=p>)</span>
+            <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>[</span><span class=n>group</span><span class=p>][</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span>
+
+    <span class=k>def</span> <span class=nf>get_common_properties</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Recall common properties for the group.&quot;&quot;&quot;</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=kc>None</span>
+        <span class=k>if</span> <span class=ow>not</span> <span class=n>group</span><span class=p>:</span>
+            <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;get_common_properties created with group=None&#39;</span><span class=p>)</span>
+        <span class=k>if</span> <span class=n>group</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>:</span>
+            <span class=n>rval</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>[</span><span class=n>group</span><span class=p>]</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+        <span class=k>return</span> <span class=n>rval</span>
+
+    <span class=k>def</span> <span class=nf>_create</span><span class=p>(</span>
+        <span class=bp>self</span><span class=p>,</span>
+        <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+        <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Property</span><span class=p>:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Create new property.&quot;&quot;&quot;</span>
+        <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_checking</span><span class=p>:</span>
+            <span class=k>return</span> <span class=n>Property</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=n>class_</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+        <span class=k>return</span> <span class=n>Property</span><span class=o>.</span><span class=n>construct</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=n>class_</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>)</span>  <span class=c1># type: ignore</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.transformer_helper.PropertyManager-attributes>Attributes<a href=#trestle.transforms.transformer_helper.PropertyManager-attributes class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.transformer_helper.PropertyManager.hits class="doc doc-heading"> <code class="highlight language-python"><span class=n>hits</span><span class=p>:</span> <span class=nb>int</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.transformer_helper.PropertyManager.hits class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Cache hits.</p> </div> </div> <div class="doc doc-object doc-attribute"> <h6 id=trestle.transforms.transformer_helper.PropertyManager.requests class="doc doc-heading"> <code class="highlight language-python"><span class=n>requests</span><span class=p>:</span> <span class=nb>int</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-property"><code>property</code></small> </span> <a href=#trestle.transforms.transformer_helper.PropertyManager.requests class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Cache requests.</p> </div> </div> <h5 id=trestle.transforms.transformer_helper.PropertyManager-functions>Functions<a href=#trestle.transforms.transformer_helper.PropertyManager-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_helper.PropertyManager.__init__ class="doc doc-heading"> <code class="highlight language-python"><span class=fm>__init__</span><span class=p>(</span><span class=n>caching</span><span class=o>=</span><span class=kc>True</span><span class=p>,</span> <span class=n>checking</span><span class=o>=</span><span class=kc>False</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_helper.PropertyManager.__init__ class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Initialize.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>100</span>
+<span class=normal>101</span>
+<span class=normal>102</span>
+<span class=normal>103</span>
+<span class=normal>104</span>
+<span class=normal>105</span>
+<span class=normal>106</span>
+<span class=normal>107</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=fm>__init__</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>caching</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>True</span><span class=p>,</span> <span class=n>checking</span><span class=p>:</span> <span class=nb>bool</span> <span class=o>=</span> <span class=kc>False</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Initialize.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_caching</span> <span class=o>=</span> <span class=n>caching</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_checking</span> <span class=o>=</span> <span class=n>checking</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_requests</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_hits</span> <span class=o>=</span> <span class=mi>0</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_map_unique</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Any</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>:</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Property</span><span class=p>]]</span> <span class=o>=</span> <span class=p>{}</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_helper.PropertyManager.get_common_properties class="doc doc-heading"> <code class="highlight language-python"><span class=n>get_common_properties</span><span class=p>(</span><span class=n>group</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_helper.PropertyManager.get_common_properties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Recall common properties for the group.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>157</span>
+<span class=normal>158</span>
+<span class=normal>159</span>
+<span class=normal>160</span>
+<span class=normal>161</span>
+<span class=normal>162</span>
+<span class=normal>163</span>
+<span class=normal>164</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>get_common_properties</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>group</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Optional</span><span class=p>[</span><span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Recall common properties for the group.&quot;&quot;&quot;</span>
+    <span class=n>rval</span> <span class=o>=</span> <span class=kc>None</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>group</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;get_common_properties created with group=None&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>group</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>:</span>
+        <span class=n>rval</span> <span class=o>=</span> <span class=nb>list</span><span class=p>(</span><span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>[</span><span class=n>group</span><span class=p>]</span><span class=o>.</span><span class=n>values</span><span class=p>())</span>
+    <span class=k>return</span> <span class=n>rval</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_helper.PropertyManager.materialize class="doc doc-heading"> <code class="highlight language-python"><span class=n>materialize</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_helper.PropertyManager.materialize class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Get property from cache or create new property.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>119</span>
+<span class=normal>120</span>
+<span class=normal>121</span>
+<span class=normal>122</span>
+<span class=normal>123</span>
+<span class=normal>124</span>
+<span class=normal>125</span>
+<span class=normal>126</span>
+<span class=normal>127</span>
+<span class=normal>128</span>
+<span class=normal>129</span>
+<span class=normal>130</span>
+<span class=normal>131</span>
+<span class=normal>132</span>
+<span class=normal>133</span>
+<span class=normal>134</span>
+<span class=normal>135</span>
+<span class=normal>136</span>
+<span class=normal>137</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>materialize</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=n>Property</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Get property from cache or create new property.&quot;&quot;&quot;</span>
+    <span class=bp>self</span><span class=o>.</span><span class=n>_requests</span> <span class=o>+=</span> <span class=mi>1</span>
+    <span class=c1># try fetch from cache</span>
+    <span class=n>key</span> <span class=o>=</span> <span class=n>_segment_separator</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>class_</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>ns</span><span class=p>)])</span>
+    <span class=k>if</span> <span class=n>key</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_unique</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_hits</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=k>return</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_unique</span><span class=p>[</span><span class=n>key</span><span class=p>]</span>
+    <span class=c1># create new property and put into cache if caching</span>
+    <span class=n>prop</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_create</span><span class=p>(</span><span class=n>name</span><span class=o>=</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=n>value</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=n>class_</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=n>ns</span><span class=p>)</span>
+    <span class=k>if</span> <span class=bp>self</span><span class=o>.</span><span class=n>_caching</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_map_unique</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span>
+    <span class=k>return</span> <span class=n>prop</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_helper.PropertyManager.put_common_property class="doc doc-heading"> <code class="highlight language-python"><span class=n>put_common_property</span><span class=p>(</span><span class=n>group</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>name</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>value</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>class_</span><span class=o>=</span><span class=kc>None</span><span class=p>,</span> <span class=n>ns</span><span class=o>=</span><span class=kc>None</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_helper.PropertyManager.put_common_property class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Remember common property.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>139</span>
+<span class=normal>140</span>
+<span class=normal>141</span>
+<span class=normal>142</span>
+<span class=normal>143</span>
+<span class=normal>144</span>
+<span class=normal>145</span>
+<span class=normal>146</span>
+<span class=normal>147</span>
+<span class=normal>148</span>
+<span class=normal>149</span>
+<span class=normal>150</span>
+<span class=normal>151</span>
+<span class=normal>152</span>
+<span class=normal>153</span>
+<span class=normal>154</span>
+<span class=normal>155</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>put_common_property</span><span class=p>(</span>
+    <span class=bp>self</span><span class=p>,</span>
+    <span class=n>group</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>name</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>value</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>class_</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span><span class=p>,</span>
+    <span class=n>ns</span><span class=p>:</span> <span class=n>Optional</span><span class=p>[</span><span class=nb>str</span><span class=p>]</span> <span class=o>=</span> <span class=kc>None</span>
+<span class=p>)</span> <span class=o>-&gt;</span> <span class=kc>None</span><span class=p>:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remember common property.&quot;&quot;&quot;</span>
+    <span class=k>if</span> <span class=ow>not</span> <span class=n>group</span><span class=p>:</span>
+        <span class=k>raise</span> <span class=n>TrestleError</span><span class=p>(</span><span class=s1>&#39;put_common_property created with group=None&#39;</span><span class=p>)</span>
+    <span class=k>if</span> <span class=n>group</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>:</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>[</span><span class=n>group</span><span class=p>]</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=n>key</span> <span class=o>=</span> <span class=n>_segment_separator</span><span class=o>.</span><span class=n>join</span><span class=p>([</span><span class=nb>str</span><span class=p>(</span><span class=n>name</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>value</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>class_</span><span class=p>),</span> <span class=nb>str</span><span class=p>(</span><span class=n>ns</span><span class=p>)])</span>
+    <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>[</span><span class=n>group</span><span class=p>]:</span>
+        <span class=n>prop</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>materialize</span><span class=p>(</span><span class=n>name</span><span class=p>,</span> <span class=n>value</span><span class=p>,</span> <span class=n>class_</span><span class=p>,</span> <span class=n>ns</span><span class=p>)</span>
+        <span class=bp>self</span><span class=o>.</span><span class=n>_map_common</span><span class=p>[</span><span class=n>group</span><span class=p>][</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <div class="doc doc-object doc-class"> <h4 id=trestle.transforms.transformer_helper.TransformerHelper class="doc doc-heading"> <code>TransformerHelper</code> <a href=#trestle.transforms.transformer_helper.TransformerHelper class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> <p>OSCAL transformer helper.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>179</span>
+<span class=normal>180</span>
+<span class=normal>181</span>
+<span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span>
+<span class=normal>205</span>
+<span class=normal>206</span>
+<span class=normal>207</span>
+<span class=normal>208</span>
+<span class=normal>209</span>
+<span class=normal>210</span>
+<span class=normal>211</span>
+<span class=normal>212</span>
+<span class=normal>213</span>
+<span class=normal>214</span>
+<span class=normal>215</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>class</span> <span class=nc>TransformerHelper</span><span class=p>():</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;OSCAL transformer helper.&quot;&quot;&quot;</span>
+
+    <span class=k>def</span> <span class=nf>remove_common_observation_properties</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>observations</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Remove common observation properties.&quot;&quot;&quot;</span>
+        <span class=n>common_props</span> <span class=o>=</span> <span class=p>[]</span>
+        <span class=n>props</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=c1># count each property occurrence in each observation</span>
+        <span class=n>props_occurrence_counts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_property_occurrence_counts</span><span class=p>(</span><span class=n>observations</span><span class=p>)</span>
+        <span class=c1># remove common properties from observation</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>props_occurrence_counts</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=c1># skip property if not identical for each and every observation</span>
+            <span class=k>if</span> <span class=n>props_occurrence_counts</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>!=</span> <span class=nb>len</span><span class=p>(</span><span class=n>observations</span><span class=p>):</span>
+                <span class=k>continue</span>
+            <span class=c1># remove property from each observation and keep one instance</span>
+            <span class=k>for</span> <span class=n>observation</span> <span class=ow>in</span> <span class=n>observations</span><span class=p>:</span>
+                <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>observation</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+                    <span class=k>if</span> <span class=n>key</span> <span class=o>==</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>:</span><span class=si>{</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=si>}</span><span class=s1>:</span><span class=si>{</span><span class=n>prop</span><span class=o>.</span><span class=n>class_</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>:</span>
+                        <span class=n>props</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span>
+                        <span class=n>observation</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+                        <span class=k>break</span>
+        <span class=c1># formulate list of removed properties</span>
+        <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>props</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+            <span class=n>common_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>props</span><span class=p>[</span><span class=n>key</span><span class=p>])</span>
+        <span class=c1># return list of removed properties</span>
+        <span class=k>return</span> <span class=n>common_props</span>
+
+    <span class=k>def</span> <span class=nf>_get_property_occurrence_counts</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>observations</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>Dict</span><span class=p>[</span><span class=nb>str</span><span class=p>,</span> <span class=n>Property</span><span class=p>]:</span>
+<span class=w>        </span><span class=sd>&quot;&quot;&quot;Count each property occurrence in each observation.&quot;&quot;&quot;</span>
+        <span class=n>property_occurences</span> <span class=o>=</span> <span class=p>{}</span>
+        <span class=k>for</span> <span class=n>observation</span> <span class=ow>in</span> <span class=n>observations</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>observation</span><span class=o>.</span><span class=n>props</span><span class=p>:</span>
+                <span class=n>key</span> <span class=o>=</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>:</span><span class=si>{</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=si>}</span><span class=s1>:</span><span class=si>{</span><span class=n>prop</span><span class=o>.</span><span class=n>class_</span><span class=si>}</span><span class=s1>&#39;</span>
+                <span class=k>if</span> <span class=n>key</span> <span class=ow>not</span> <span class=ow>in</span> <span class=n>property_occurences</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+                    <span class=n>property_occurences</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=mi>0</span>
+                <span class=n>property_occurences</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>+=</span> <span class=mi>1</span>
+        <span class=k>return</span> <span class=n>property_occurences</span>
+</code></pre></div></td></tr></table></div> </details> <div class="doc doc-children"> <h5 id=trestle.transforms.transformer_helper.TransformerHelper-functions>Functions<a href=#trestle.transforms.transformer_helper.TransformerHelper-functions class=headerlink title="Permanent link">¤</a></h5> <div class="doc doc-object doc-function"> <h6 id=trestle.transforms.transformer_helper.TransformerHelper.remove_common_observation_properties class="doc doc-heading"> <code class="highlight language-python"><span class=n>remove_common_observation_properties</span><span class=p>(</span><span class=n>observations</span><span class=p>)</span></code> <a href=#trestle.transforms.transformer_helper.TransformerHelper.remove_common_observation_properties class=headerlink title="Permanent link">¤</a></h6> <div class="doc doc-contents "> <p>Remove common observation properties.</p> <details class=quote> <summary>Source code in <code>trestle/transforms/transformer_helper.py</code></summary> <div class=highlight><table class=highlighttable><tr><td class=linenos><div class=linenodiv><pre><span></span><span class=normal>182</span>
+<span class=normal>183</span>
+<span class=normal>184</span>
+<span class=normal>185</span>
+<span class=normal>186</span>
+<span class=normal>187</span>
+<span class=normal>188</span>
+<span class=normal>189</span>
+<span class=normal>190</span>
+<span class=normal>191</span>
+<span class=normal>192</span>
+<span class=normal>193</span>
+<span class=normal>194</span>
+<span class=normal>195</span>
+<span class=normal>196</span>
+<span class=normal>197</span>
+<span class=normal>198</span>
+<span class=normal>199</span>
+<span class=normal>200</span>
+<span class=normal>201</span>
+<span class=normal>202</span>
+<span class=normal>203</span>
+<span class=normal>204</span></pre></div></td><td class=code><div><pre><span></span><code><span class=k>def</span> <span class=nf>remove_common_observation_properties</span><span class=p>(</span><span class=bp>self</span><span class=p>,</span> <span class=n>observations</span><span class=p>:</span> <span class=n>List</span><span class=p>[</span><span class=n>Observation</span><span class=p>])</span> <span class=o>-&gt;</span> <span class=n>List</span><span class=p>[</span><span class=n>Property</span><span class=p>]:</span>
+<span class=w>    </span><span class=sd>&quot;&quot;&quot;Remove common observation properties.&quot;&quot;&quot;</span>
+    <span class=n>common_props</span> <span class=o>=</span> <span class=p>[]</span>
+    <span class=n>props</span> <span class=o>=</span> <span class=p>{}</span>
+    <span class=c1># count each property occurrence in each observation</span>
+    <span class=n>props_occurrence_counts</span> <span class=o>=</span> <span class=bp>self</span><span class=o>.</span><span class=n>_get_property_occurrence_counts</span><span class=p>(</span><span class=n>observations</span><span class=p>)</span>
+    <span class=c1># remove common properties from observation</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>props_occurrence_counts</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=c1># skip property if not identical for each and every observation</span>
+        <span class=k>if</span> <span class=n>props_occurrence_counts</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>!=</span> <span class=nb>len</span><span class=p>(</span><span class=n>observations</span><span class=p>):</span>
+            <span class=k>continue</span>
+        <span class=c1># remove property from each observation and keep one instance</span>
+        <span class=k>for</span> <span class=n>observation</span> <span class=ow>in</span> <span class=n>observations</span><span class=p>:</span>
+            <span class=k>for</span> <span class=n>prop</span> <span class=ow>in</span> <span class=n>as_list</span><span class=p>(</span><span class=n>observation</span><span class=o>.</span><span class=n>props</span><span class=p>):</span>
+                <span class=k>if</span> <span class=n>key</span> <span class=o>==</span> <span class=sa>f</span><span class=s1>&#39;</span><span class=si>{</span><span class=n>prop</span><span class=o>.</span><span class=n>name</span><span class=si>}</span><span class=s1>:</span><span class=si>{</span><span class=n>prop</span><span class=o>.</span><span class=n>value</span><span class=si>}</span><span class=s1>:</span><span class=si>{</span><span class=n>prop</span><span class=o>.</span><span class=n>class_</span><span class=si>}</span><span class=s1>&#39;</span><span class=p>:</span>
+                    <span class=n>props</span><span class=p>[</span><span class=n>key</span><span class=p>]</span> <span class=o>=</span> <span class=n>prop</span>
+                    <span class=n>observation</span><span class=o>.</span><span class=n>props</span><span class=o>.</span><span class=n>remove</span><span class=p>(</span><span class=n>prop</span><span class=p>)</span>
+                    <span class=k>break</span>
+    <span class=c1># formulate list of removed properties</span>
+    <span class=k>for</span> <span class=n>key</span> <span class=ow>in</span> <span class=n>props</span><span class=o>.</span><span class=n>keys</span><span class=p>():</span>
+        <span class=n>common_props</span><span class=o>.</span><span class=n>append</span><span class=p>(</span><span class=n>props</span><span class=p>[</span><span class=n>key</span><span class=p>])</span>
+    <span class=c1># return list of removed properties</span>
+    <span class=k>return</span> <span class=n>common_props</span>
+</code></pre></div></td></tr></table></div> </details> </div> </div> </div> </div> </div> <h3 id=trestle.transforms.transformer_helper-functions>Functions<a href=#trestle.transforms.transformer_helper-functions class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/API/trestle/transforms/transformer_singleton/index.html b/latest/reference/API/trestle/transforms/transformer_singleton/index.html
new file mode 100644
index 000000000..915afc0f5
--- /dev/null
+++ b/latest/reference/API/trestle/transforms/transformer_singleton/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for trestle.transforms.transformer_singleton module"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/transformer_singleton/ rel=canonical><link href=../transformer_helper/ rel=prev><link href=../implementations/osco/ rel=next><link rel=icon href=../../../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle.transforms.transformer_singleton - Compliance Trestle</title><link rel=stylesheet href=../../../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle.transforms.transformer_singleton - Compliance Trestle"><meta property=og:description content="Documentation for trestle.transforms.transformer_singleton module"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/transformer_singleton.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/transformer_singleton/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle.transforms.transformer_singleton - Compliance Trestle"><meta name=twitter:description content="Documentation for trestle.transforms.transformer_singleton module"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/API/trestle/transforms/transformer_singleton.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle.transforms.transformer_singleton class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../../../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2 checked> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1 checked> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6 checked> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=true> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.transformer_singleton class=md-nav__link> <span class=md-ellipsis> transformer_singleton </span> </a> <nav class=md-nav aria-label=transformer_singleton> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_singleton-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_singleton.transformer_factory class=md-nav__link> <span class=md-ellipsis> transformer_factory </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_singleton-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../../../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#trestle.transforms.transformer_singleton class=md-nav__link> <span class=md-ellipsis> transformer_singleton </span> </a> <nav class=md-nav aria-label=transformer_singleton> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_singleton-attributes class=md-nav__link> <span class=md-ellipsis> Attributes </span> </a> <nav class=md-nav aria-label=Attributes> <ul class=md-nav__list> <li class=md-nav__item> <a href=#trestle.transforms.transformer_singleton.transformer_factory class=md-nav__link> <span class=md-ellipsis> transformer_factory </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle.transforms.transformer_singleton-classes class=md-nav__link> <span class=md-ellipsis> Classes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1>trestle.transforms.transformer_singleton</h1> <div class="doc doc-object doc-module"> <h2 id=trestle.transforms.transformer_singleton class="doc doc-heading"> <code>trestle.transforms.transformer_singleton</code> <a href=#trestle.transforms.transformer_singleton class=headerlink title="Permanent link">¤</a></h2> <div class="doc doc-contents first"> <p>Create the singleton transformer factory here.</p> <div class="doc doc-children"> <h3 id=trestle.transforms.transformer_singleton-attributes>Attributes<a href=#trestle.transforms.transformer_singleton-attributes class=headerlink title="Permanent link">¤</a></h3> <div class="doc doc-object doc-attribute"> <h4 id=trestle.transforms.transformer_singleton.transformer_factory class="doc doc-heading"> <code class="highlight language-python"><span class=n>transformer_factory</span> <span class=o>=</span> <span class=n>TransformerFactory</span><span class=p>()</span></code> <span class="doc doc-labels"> <small class="doc doc-label doc-label-module-attribute"><code>module-attribute</code></small> </span> <a href=#trestle.transforms.transformer_singleton.transformer_factory class=headerlink title="Permanent link">¤</a></h4> <div class="doc doc-contents "> </div> </div> <h3 id=trestle.transforms.transformer_singleton-classes>Classes<a href=#trestle.transforms.transformer_singleton-classes class=headerlink title="Permanent link">¤</a></h3> </div> </div> </div><p>handler: python</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 31, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/reference/Unification-SCC-class-for-OSCO-and-Tanium-to-OSCAL.png b/latest/reference/Unification-SCC-class-for-OSCO-and-Tanium-to-OSCAL.png
new file mode 100644
index 0000000000000000000000000000000000000000..a8031cf371cc79f07bf97a4c95d9ec6acad5f191
GIT binary patch
literal 146161
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

literal 0
HcmV?d00001

diff --git a/latest/reference/Unification-SCC-class-for-OSCO-and-Tanium-to-OSCAL.xlsx b/latest/reference/Unification-SCC-class-for-OSCO-and-Tanium-to-OSCAL.xlsx
new file mode 100644
index 0000000000000000000000000000000000000000..b6e6aad12a835176f304631e64041c10a47f0fb7
GIT binary patch
literal 6952
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

literal 0
HcmV?d00001

diff --git a/latest/reference/third-party-result-schema-IBM-SCC/index.html b/latest/reference/third-party-result-schema-IBM-SCC/index.html
new file mode 100644
index 000000000..b2f3ca941
--- /dev/null
+++ b/latest/reference/third-party-result-schema-IBM-SCC/index.html
@@ -0,0 +1,184 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Description of how to use trestle to interchange results with IBM Cloud Security and Compliance Center"><link href=https://oscal-compass.github.io/compliance-trestle/latest/reference/third-party-result-schema-IBM-SCC/ rel=canonical><link href=../../plugins/fedramp/ rel=prev><link href=../API/trestle/cli/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>IBM SCC assessment results integration - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="IBM SCC assessment results integration - Compliance Trestle"><meta property=og:description content="Description of how to use trestle to interchange results with IBM Cloud Security and Compliance Center"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/third-party-result-schema-IBM-SCC.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/reference/third-party-result-schema-IBM-SCC/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="IBM SCC assessment results integration - Compliance Trestle"><meta name=twitter:description content="Description of how to use trestle to interchange results with IBM Cloud Security and Compliance Center"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/reference/third-party-result-schema-IBM-SCC.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#schema-of-assessment-results-for-interchange-with-ibm-cloud-security-and-compliance-center-scc class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> IBM SCC assessment results integration </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> Reference </a> </li> <li class=md-tabs__item> <a href=../../tutorials/cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8 checked> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=true> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> IBM SCC assessment results integration </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#general-guidance class=md-nav__link> <span class=md-ellipsis> General Guidance </span> </a> </li> <li class=md-nav__item> <a href=#transforms class=md-nav__link> <span class=md-ellipsis> Transforms </span> </a> </li> <li class=md-nav__item> <a href=#inventory class=md-nav__link> <span class=md-ellipsis> Inventory </span> </a> </li> <li class=md-nav__item> <a href=#observation class=md-nav__link> <span class=md-ellipsis> Observation </span> </a> </li> <li class=md-nav__item> <a href=#finding class=md-nav__link> <span class=md-ellipsis> Finding </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex=0> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=false> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../tutorials/Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#general-guidance class=md-nav__link> <span class=md-ellipsis> General Guidance </span> </a> </li> <li class=md-nav__item> <a href=#transforms class=md-nav__link> <span class=md-ellipsis> Transforms </span> </a> </li> <li class=md-nav__item> <a href=#inventory class=md-nav__link> <span class=md-ellipsis> Inventory </span> </a> </li> <li class=md-nav__item> <a href=#observation class=md-nav__link> <span class=md-ellipsis> Observation </span> </a> </li> <li class=md-nav__item> <a href=#finding class=md-nav__link> <span class=md-ellipsis> Finding </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=schema-of-assessment-results-for-interchange-with-ibm-cloud-security-and-compliance-center-scc>Schema of Assessment Results for Interchange with IBM Cloud Security and Compliance Center, SCC<a class=headerlink href=#schema-of-assessment-results-for-interchange-with-ibm-cloud-security-and-compliance-center-scc title="Permanent link">¤</a></h1> <p>This document depicts the structure and guidelines for creating an OSCAL result object which would be generated by various transformers for different tools such as Tanium to OSCAL and OSCO to OSCAL. Policy Validation Points (PVPs) such as toolchain that directly generate OSCAL results for sending to SCC Exchange API should follow the structure and guidelines described below.</p> <p>The overall object will be a <em>results</em> element of OSCAL Assessment Result schema wrapped in an outer json object as shown below.</p> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;results&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;result&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;object&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;result&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;object&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> <p>Each result object represents one assessment scan and should have the required properties as per OSCAL schema. The <em>start</em> and <em>end</em> represents the start and end datetime of evidence collection activity. The <em>end</em> is optional. In addition to these, the result object may contain details about inventory, list of observations (checks) for each inventory, and findings for profile level controls (such as NIST).</p> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cd54e9bf-f4d3-45d6-ae3b-6e8255847dc2&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;start&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-04-05T20:19:11.000+00:00&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;end&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-04-05T20:19:11.000+00:00&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;local-definitions&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{},</span>
+<span class=w>  </span><span class=nt>&quot;reviewed-controls&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{},</span>
+<span class=w>  </span><span class=nt>&quot;observations&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{},</span>
+<span class=w>  </span><span class=nt>&quot;findings&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{}</span>
+<span class=p>}</span>
+</code></pre></div> <p>The inventory should be included in <em>local-definitions</em> if observations are being reported, but can be omitted if only <em>findings</em> are being reported. As <em>reviewed-controls</em> is required as per OSCAL schema, an empty object should be included if only observations are being reported. Optionally, the controls for which the status is being reported in <em>findings</em> can be captured here. The actual assessment checks being performed on different inventory items should be captured under <em>observations</em>. This can be omitted if only <em>findings</em> are being reported. As <em>findings</em> is required as per OSCAL schema, an empty object can be included if only observations are being reported and no profile controls are being assessed. Otherwise, findings should include the status of profile controls.</p> <h2 id=general-guidance>General Guidance<a class=headerlink href=#general-guidance title="Permanent link">¤</a></h2> <ol> <li> <p>All the properties in the source result (tool specific format) should be represented as properties of the right objects in OSCAL such as inventory-items, observations, etc. The properties should have a tool specific namespace to convey that the property names are exactly same as what is coming from specific tools.</p> </li> <li> <p>Not everything from the non-OSCAL results are relevant (required) by SCC. The relevant properties MUST have SCC specific <em>class</em> such as scc_inventory_item_id, scc_result, etc. This will help SCC identify corresponding information from different tools and handle them appropriately. SCC MUST store the original property names so that when these are retrieved by tools later, they can get back the same name-value pairs as was there in the input data.</p> </li> <li> <p>There must be a pre-defined set of properties (class values) from SCC for each result object component such as <em>inventory-items</em>, <em>components</em>, <em>observations</em>, etc.</p> </li> <li> <p>A property value MUST be a string of appropriate format.</p> </li> </ol> <h2 id=transforms>Transforms<a class=headerlink href=#transforms title="Permanent link">¤</a></h2> <ol> <li>File <em>Unification SCC class for OSCO and Tanium to OSCAL.xlsx</em> contains the <em>SCC class</em> mapping from Tanium and OpenShift Compliance Operator results data to OSCAL. Although other properties are constructed during transformation, only items having <em>SCC class</em> are shown in the table.</li> </ol> <p><img src=../Unification-SCC-class-for-OSCO-and-Tanium-to-OSCAL.png></p> <h2 id=inventory>Inventory<a class=headerlink href=#inventory title="Permanent link">¤</a></h2> <ol> <li>Inventory is captured under <em>local-definitions</em> in result object. local-definitions can be used to represent inventory items, components, users, etc. For our purposes only components and inventory-items will be used. Components should be used to represent software, services, etc. whereas inventory-items represent specific machines, VMs, network devices, etc. The inventory items should be associated to a component through <em>implemented-components</em> as shown below.</li> </ol> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;local-definitions&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;components&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;b3e243a1-4660-4f5a-aa85-159b4b2d69ce&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Operating System&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;status&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;state&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;operational&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>}</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=nt>&quot;inventory-items&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>      </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;c9fb63cf-d21e-4584-88f8-44d67ea33ba0&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Computer Name&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cmp-wn-2106.demo.tanium.local&quot;</span>
+<span class=w>          </span><span class=p>},</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium Client IP Address&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;192.168.0.120&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_inventory_item_id&quot;</span>
+<span class=w>          </span><span class=p>},</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;IP Address&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;[&#39;fe80::cd44:4154:61e8:53ae&#39;, &#39;192.168.0.120&#39;]&quot;</span>
+<span class=w>          </span><span class=p>},</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Count&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1&quot;</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>],</span>
+<span class=w>        </span><span class=nt>&quot;implemented-components&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;component-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;b3e243a1-4660-4f5a-aa85-159b4b2d69ce&quot;</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>]</span>
+<span class=w>      </span><span class=p>}</span>
+<span class=w>    </span><span class=p>]</span>
+<span class=w>  </span><span class=p>}</span>
+<span class=p>}</span>
+</code></pre></div> <ol> <li> <p>Inventory items have one required property with class <em>scc_inventory_item_id</em> as shown above. Similarly in some other tool's result the scc_inventory_item_id may be specified through some other property. It is the job of the transformation code to appropriately specify class values for required properties. As shown above, non-mandatory property such as <em>count</em> from native result does not have any class specified.</p> </li> <li> <p>The <em>type</em> of the inventory item is specified by linking it to <em>component</em> via <em>implemented-components</em>.</p> </li> </ol> <h2 id=observation>Observation<a class=headerlink href=#observation title="Permanent link">¤</a></h2> <ol> <li>Loosely speaking, an <em>observation</em> object equates with results from a goal check, and the observation is uniquely identified by a uuid, e.g.,</li> </ol> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;00000000-0000-4000-9999-000000000016&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords&quot;</span>
+<span class=p>}</span>
+</code></pre></div> <ol> <li>A sample observation object generated from Tanium result looks like -</li> </ol> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;74b605f8-7e8c-41b3-9514-2412692fbe01&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-11T22:34:03+00:00&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;c8919d2b-3300-4f3f-98f6-15a7104c2e04&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-11T22:34:03.000+00:00&quot;</span>
+<span class=p>}</span>
+</code></pre></div> <ol> <li> <p>An observation has five required properties -</p> </li> <li> <p><em>scc_predefined_profile</em> - identifies both Goal based Profiles (eg CIS-benchmarks, IBM BP etc) and Control/Regulation based Profiles (eg. NIST, FS Cloud etc). The way the integrators or customers will differentiate between the two types of profiles is by the OSCAL element used i.e., Goal based Profiles are defined in the <em>observation</em> element which carries the goal id (check id) and posture. Control/Regulation based Profiles  are defined in the <em>finding</em> element which carries the control posture, the custom profile name, and the mapping of the goal results to NIST controls</p> </li> <li><em>scc_check_version, scc_predefined_profile_version</em> - gives the version of the goal/profile i.e., CIS benchmark version used for check.</li> <li><em>scc_goal_description, scc_check_name_id</em> - gives the specific goal check (rule) that was assessed from the scc_predefined_profile.</li> <li><em>scc_result</em> - gives the outcome of performing the check. Possible values are - "pass", "fail", "error" , "unknown", "notchecked", "notapplicable".</li> <li> <p><em>scc_timestamp</em> - datetime for this observation. This can be date and time when this observation was performed or reported.</p> </li> <li> <p>Targets such as systems or services MUST be a <em>subject</em> in the observation, which MUST be identified by a <em>uuid-ref</em> value pointing to the subject in local-definitions.</p> </li> </ol> <h2 id=finding>Finding<a class=headerlink href=#finding title="Permanent link">¤</a></h2> <ol> <li>A <em>finding</em> represents the assessment of a profile control such as NIST 800-53: AC-1 and the related observations. A sample finding object looks like -</li> </ol> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cde35fad-3922-4046-8ef8-830e77ffd75a&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;target&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;statement-id&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;id-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>      </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Profile&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10 - NIST 800-53&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>      </span><span class=p>},</span>
+<span class=w>      </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Version&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;version: 1&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>      </span><span class=p>},</span>
+<span class=w>      </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Custom ID&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span>
+<span class=w>      </span><span class=p>}</span>
+<span class=w>    </span><span class=p>],</span>
+<span class=w>    </span><span class=nt>&quot;status&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;not-satisfied&quot;</span>
+<span class=w>  </span><span class=p>},</span>
+<span class=w>  </span><span class=nt>&quot;related-observations&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;observation-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;d8bd1785-b95f-45c9-9fa8-32a362845102&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;observation-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;d06c6f13-5006-4e2d-b3f3-5cdb577473b1&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> <ol> <li> <p>A finding has two required property <em>scc_predefined_profile</em> that gives the name of the profile whose control is specified in "id-ref", and <em>scc_predefined_profile_version</em>.</p> </li> <li> <p>If there is no finding associated with a PVP, a single finding will be created (to preserve valid OSCAL) where the UUID maps to a 'all zeros' UUID e.g.:</p> </li> </ol> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;00000000-0000-4000-8000-000000000000&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;No finding&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;No finding.&quot;</span>
+<span class=p>}</span>
+</code></pre></div> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">December 19, 2023</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/search/search_index.json b/latest/search/search_index.json
new file mode 100644
index 000000000..0bb1bacb9
--- /dev/null
+++ b/latest/search/search_index.json
@@ -0,0 +1 @@
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"Compliance-trestle (also known as <code>trestle</code>)","text":"<p>Trestle is an ensemble of tools that enable the creation, validation, and governance of documentation artifacts for compliance needs. It leverages NIST's OSCAL as a standard data format for interchange between tools and people, and provides an opinionated approach to OSCAL adoption.</p> <p>Trestle is designed to operate as a CICD pipeline running on top of compliance artifacts in <code>git</code>, to provide transparency for the state of compliance across multiple stakeholders in an environment friendly to developers. Trestle passes the generated artifacts on to tools that orchestrate the enforcement, measurement, and reporting of compliance.</p> <p>It also provides tooling to manage OSCAL documents in a more human-friendly manner. By splitting large OSCAL data structures into smaller and easier to edit sub-structures, creation and maintenance of these artifacts can follow normal <code>git</code> workflows including peer review via pull request, versioning, releases/tagging.</p> <p>Trestle provides three separate but related functions in the compliance space:</p> <ul> <li>Manage OSCAL documents to allow editing and manipulation while making sure the schemas are enforced</li> <li>Transform documents from other formats to OSCAL</li> <li>Provide support and governance to author compliance content as markdown and drawio.</li> </ul> <p>Trestle provides tooling to help orchestrate the compliance process across a number of dimensions:</p> <ul> <li>Help manage OSCAL documents in a more human-friendly manner by expanding the large OSCAL data structures into smaller and easier to edit sub-structures while making sure the schemas are enforced.</li> <li>Transform documents from other formats to OSCAL</li> <li>Provide governance for markdown documents and enforce consistency of format and content based on specified templates</li> <li>Tooling manage authoring and governance of markdown and drawio files withn a repository.</li> <li>Support within trestle to streamline management within a managed git environment.</li> <li>An underlying object model that supports developers interacting with OSCAL artefacts.</li> </ul>"},{"location":"#important-note","title":"Important Note:","text":"<p>The current version of trestle supports NIST OSCAL 1.0.0-4.  There was a breaking change in OSCAL moving from version 1.0.0 to 1.0.2 mainly due to <code>prop</code> becoming <code>props</code> in AssessmentResults.  As a result, the current development path of trestle requires OSCAL 1.0.4, but for those who require OSCAL 1.0.0 please use trestle version 0.37.x.  That version is stable but will not have any features added, and we encourage users to move to OSCAL 1.0.4.</p> <p>OSCAL version 1.0.0 files are still handled on import but any AssessmentResults must conform to the OSCAL 1.0.4 schema, with props instead of prop.  And all files created by trestle will be output as OSCAL version 1.0.4.</p>"},{"location":"#why-trestle","title":"Why Trestle","text":"<p>Compliance suffers from being a complex topic that is hard to articulate simply. It involves complete and accurate execution of multiple procedures across many disciplines (e.g. IT, HR, management) with periodic verification and audit of those procedures against controls.</p> <p>While it is possible to manage the description of controls and how an organisation implements them in ad hoc ways with general tools (spreadsheets, documents), this is hard to maintain for multiple accreditations and, in the IT domain at least, creates a barrier between the compliance efforts and the people doing daily work (DevOps staff).</p> <p>Trestle aims to reduce or remove this barrier by bringing the maintenance of control descriptions into the DevOps domain. The goal is to have changes to the system (for example, updates to configuration management) easily related to the controls impacted, and to enable modification of those controls as required in concert with the system changes.</p> <p>Trestle implicitly provides a core opinionated workflow driven by its pipeline to allow standardized interlocks with other compliance tooling platforms.</p>"},{"location":"#machine-readable-compliance-format","title":"Machine readable compliance format","text":"<p>Compliance activities at scale, whether size of estate or number of accreditations, require automation to be successful and repeatable. OSCAL as a standard allows teams to bridge between the \"Governance\" layer and operational tools.</p> <p>By building human managed artifacts into OSCAL, Trestle is not only able to validate the integrity of the artifacts that people generate - it also enables reuse and sharing of artifacts, and furthermore can provide suitable input into tools that automate operational compliance.</p>"},{"location":"#supported-oscal-elements-and-extensions","title":"Supported OSCAL elements and extensions","text":"<p><code>trestle</code> implicitly supports all OSCAL schemas for use within the object model. The development roadmap for <code>trestle</code> includes adding workflow around specific elements / objects that is opinionated.</p>"},{"location":"#supported-file-formats-for-oscal-objects","title":"Supported file formats for OSCAL objects.","text":"<p>OSCAL supports <code>xml</code>, <code>json</code> and <code>yaml</code> with their metaschema tooling. Trestle natively supports only <code>json</code> and <code>yaml</code> formats at this time.</p> <p>Future roadmap anticipates that support for xml import and upstream references will be enabled. However, it is expected that full support will remain only for <code>json</code> and  <code>yaml</code>.</p> <p>Users needing to import XML OSCAL artifacts are recommended to look at NIST's OSCAL converters page here.</p>"},{"location":"#python-codebase-easy-installation-via-pip","title":"Python codebase, easy installation via pip","text":"<p>Trestle runs on most all python platforms (e.g. Linux, Mac, Windows) and is available on PyPi so it is easily installed via pip.  It is under active development and new releases are made available regularly.</p>"},{"location":"#development-status","title":"Development status","text":"<p>Compliance trestle is currently stable and is based on NIST OSCAL version 1.0.4, with active development continuing.</p>"},{"location":"#contributing-to-trestle","title":"Contributing to Trestle","text":"<p>Our project welcomes external contributions. Please consult contributing to get started.</p>"},{"location":"#license-authors","title":"License &amp; Authors","text":"<p>If you would like to see the detailed LICENSE click here. Consult contributors for a list of authors and maintainers for the core team.</p> <pre><code># Copyright (c) 2024 The OSCAL Compass Authors. All rights reserved.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n#     https://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n</code></pre> <p>We are a Cloud Native Computing Foundation sandbox project.</p> <p> </p> <p>The Linux Foundation\u00ae (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage\".</p> <p>Trestle was originally created by IBM.</p>"},{"location":"demos/","title":"Trestle demonstration projects and content","text":"<p>Trestle has a number of demonstrations setup in the oscal-compass/compliance-trestle-demos repository which is intended to be a single point of call for demonstrations and content.</p> <p>If you are interested in contributing a demonstration / content open a PR to the demonstration repo and a PR to this page.</p> <p>Demonstrations, where practical, should include instructions on how they were created.</p>"},{"location":"demos/#current-demonstrations","title":"Current demonstrations","text":""},{"location":"demos/#simple-sdk-examples","title":"Simple sdk examples.","text":"<p>This folder contains a number of small examples for using the trestle OSCAL sdks.</p>"},{"location":"demos/#arc42-architectural-template-enforcement-using-trestle-author","title":"arc42 architectural template enforcement using trestle author.","text":"<p>arc42 have created a set of open-source architecture documentation templates. This demonstration uses <code>trestle author</code> to enforce use of the (modified) arc42 templates.</p>"},{"location":"demos/#trestle-flask-microservice-demonstration","title":"Trestle flask microservice demonstration.","text":"<p><code>trestle</code> uses a python library called pydantic to form the underlying OSCAL object models. flask-pydantic introduces a mechanism which integrates pydantic models into flask, providing automated user input validation in one line of code. This demo accepts a catalog as a POSTed object, throwing errors if the catalog does not meet the schema, and returns the catalog in the response. Find the demonstration here.</p>"},{"location":"demos/#creating-a-cis-controls-catalog-from-an-excel-spreadsheet","title":"Creating a CIS controls catalog from an excel spreadsheet.","text":"<p>The Centre for Internet Security (CIS) produce a number of cross industry standards for IT security including their platform specific benchmarks and a suite of controls. This demo converts a spreadsheet of those controls into a a catalog and three profiles.</p>"},{"location":"demos/#creating-an-ssp-using-trestle-author","title":"Creating an SSP using trestle author.","text":"<p><code>trestle author ssp-generate</code> and <code>trestle author ssp-assemble</code> allow users to generate first a set of markdown documents to allow easy editing of control responses and second to reassemble that information up into an OSCAL ssp document. This is a 'baseline' demonstration with more sophisticated updates expected in the near term.</p>"},{"location":"demos/#trestle-repository-api-trestlecorerepository","title":"Trestle Repository API (<code>trestle.core.repository</code>)","text":"<p><code>trestle.core.repository</code> is an API which abstracts users from the file system of a trestle repository. It provides a way for external developers to access a trestle repository without relying on presumptions (such as cwd being within the repository). Find the demo here.</p>"},{"location":"demos/#task-examples","title":"Task examples","text":""},{"location":"demos/#convert-a-spreadsheet-into-a-component-definition","title":"Convert a spreadsheet into a <code>component-definition</code>","text":"<p>This demonstration shows how to use the <code>trestle task xlsx-to-oscal-cd</code> functionality.</p>"},{"location":"demos/#convert-a-xccdf-result-into-a-partial-assessment-results","title":"Convert a <code>xccdf</code> result into a partial <code>assessment-results</code>","text":"<p>This demonstration shows how to use the <code>trestle task xccdf_result_to_oscal_ar</code> functionality.</p>"},{"location":"installation/","title":"Install trestle in a python virtual environment","text":"<p>There are a few things you need to to start using trestle:</p> <ul> <li>Make sure you have a working and recent Python environment</li> <li>Set up a Python virtual environment</li> <li>Download and install trestle</li> <li>Confirm it is working properly</li> <li>Create a trestle workspace</li> </ul>"},{"location":"installation/#confirm-you-have-python-installed","title":"Confirm you have python installed","text":"<ul> <li>Ensure you have a modern Python (3.9, 3.10, 3.11).</li> </ul> <pre><code>$ python -V\nPython 3.9.2\n</code></pre>"},{"location":"installation/#setup-a-virtual-environment","title":"Setup a virtual environment","text":"<p>There are many ways to do this on Windows, Mac and Linux and with different Python installations, so please consult the documentation associated with your platform.  Below is how it works on a typical Linux platform.</p> <pre><code>$ cd\n$ python -m venv venv.trestle\n$ source venv.trestle/bin/activate\n(venv.trestle)$\n</code></pre> <ul> <li>Ensure you have a modern pip (19.x or greater).</li> </ul> <pre><code>(venv.trestle)$ python -m pip --version\npip 19.2.3 from /home...\n</code></pre> <p>You should probably upgrade your pip to the latest version with:</p> <pre><code>(venv.trestle)$ python -m pip install --upgrade pip\n</code></pre> <p>Details can be found at Installation - pip documentation</p>"},{"location":"installation/#install-trestle","title":"Install trestle","text":"<ul> <li>Install compliance-trestle.</li> </ul> <pre><code>(venv.trestle)$ python -m pip install compliance-trestle\nLooking in indexes: https://pypi.org/simple,...\n</code></pre>"},{"location":"installation/#confirm-trestle-is-installed-properly","title":"Confirm trestle is installed properly","text":"<ul> <li>Check trestle viability (and view help).</li> </ul> <pre><code>(venv.trestle)$ trestle -h\nusage: trestle [-h]\n               {assemble,author,create,describe,href,import,init,merge,partial-object-validate,remove,replicate,split,task,validate,version}\n               ...\n</code></pre> Full help text <pre><code>Manage OSCAL files in a human friendly manner.\n\npositional arguments:\n  {assemble,author,create,describe,href,import,init,merge,partial-object-validate,remove,replicate,split,task,validate,version}\n    assemble            Assemble all subcomponents from a specified trestle model into a single JSON/YAML file under\n                        dist.\n    author              trestle author, a collection of commands for authoring compliance content outside of OSCAL.\n    create              Create a sample OSCAL model in trestle project or create new elements within a given model.\n    describe            Describe contents of a model file including optional element path.\n    href                Change href of import in profile to point to catalog in trestle project. This command is\n                        needed when generating an SSP with a profile that imports a catalog from a temporary location\n                        different from the final intended location of the catalog. Omit the href argument to see the\n                        list of current imports in the profile.\n    import              Import an existing full OSCAL model into the trestle project.\n    init                Initialize a trestle working directory.\n    merge               Merge subcomponents on a trestle model.\n    partial-object-validate\n                        Direct validation any oscal object in a file, including list objects.\n    remove              Remove a subcomponent to an existing model.\n    replicate           Replicate a top level model within the trestle directory structure.\n    split               Split subcomponents on a trestle model.\n    task                Run arbitrary trestle tasks in a simple and extensible methodology.\n    validate            Validate contents of a trestle model in different modes.\n    version             Output version info for trestle and OSCAL.\n\noptional arguments:\n  -h, --help            show this help message and exit\n</code></pre>"},{"location":"installation/#create-a-trestle-workspace","title":"Create a trestle workspace","text":"<ul> <li>Create trestle workspace.</li> </ul> <pre><code>(venv.trestle)$ mkdir trestle.workspace\n(venv.trestle)$ cd trestle.workspace\n(venv.trestle)$ trestle init\nInitialized trestle project successfully in /home/&lt;user&gt;/trestle.workspace\n</code></pre> <p>Congratulations! You now have a working trestle workspace for safe manipulation of OSCAL documents!</p>"},{"location":"known_limitations/","title":"Known errors and limitations","text":""},{"location":"known_limitations/#utf-8-encoding-only","title":"utf-8 encoding only","text":"<p>Trestle supports only utf8 as a file text-encoding. If non-utf8 files are encountered, errors will be reported / thrown. Trestle provides a script that may be used to convert files to utf8 in a destructive manner that may change the file contents.</p> <p>WARNING: This script is potentially destructive and may remove / damage content. Ensure you have a backup before use.</p>"},{"location":"known_limitations/#single-oscal-release-only","title":"Single OSCAL release only","text":"<p>Each version of compliance trestle is designed to support only one version of the OSCAL schema.</p>"},{"location":"license/","title":"License","text":"<pre><code>                                 Apache License\n                           Version 2.0, January 2004\n                        https://www.apache.org/licenses/\n\n   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION\n\n   1. Definitions.\n\n      \"License\" shall mean the terms and conditions for use, reproduction,\n      and distribution as defined by Sections 1 through 9 of this document.\n\n      \"Licensor\" shall mean the copyright owner or entity authorized by\n      the copyright owner that is granting the License.\n\n      \"Legal Entity\" shall mean the union of the acting entity and all\n      other entities that control, are controlled by, or are under common\n      control with that entity. For the purposes of this definition,\n      \"control\" means (i) the power, direct or indirect, to cause the\n      direction or management of such entity, whether by contract or\n      otherwise, or (ii) ownership of fifty percent (50%) or more of the\n      outstanding shares, or (iii) beneficial ownership of such entity.\n\n      \"You\" (or \"Your\") shall mean an individual or Legal Entity\n      exercising permissions granted by this License.\n\n      \"Source\" form shall mean the preferred form for making modifications,\n      including but not limited to software source code, documentation\n      source, and configuration files.\n\n      \"Object\" form shall mean any form resulting from mechanical\n      transformation or translation of a Source form, including but\n      not limited to compiled object code, generated documentation,\n      and conversions to other media types.\n\n      \"Work\" shall mean the work of authorship, whether in Source or\n      Object form, made available under the License, as indicated by a\n      copyright notice that is included in or attached to the work\n      (an example is provided in the Appendix below).\n\n      \"Derivative Works\" shall mean any work, whether in Source or Object\n      form, that is based on (or derived from) the Work and for which the\n      editorial revisions, annotations, elaborations, or other modifications\n      represent, as a whole, an original work of authorship. For the purposes\n      of this License, Derivative Works shall not include works that remain\n      separable from, or merely link (or bind by name) to the interfaces of,\n      the Work and Derivative Works thereof.\n\n      \"Contribution\" shall mean any work of authorship, including\n      the original version of the Work and any modifications or additions\n      to that Work or Derivative Works thereof, that is intentionally\n      submitted to Licensor for inclusion in the Work by the copyright owner\n      or by an individual or Legal Entity authorized to submit on behalf of\n      the copyright owner. For the purposes of this definition, \"submitted\"\n      means any form of electronic, verbal, or written communication sent\n      to the Licensor or its representatives, including but not limited to\n      communication on electronic mailing lists, source code control systems,\n      and issue tracking systems that are managed by, or on behalf of, the\n      Licensor for the purpose of discussing and improving the Work, but\n      excluding communication that is conspicuously marked or otherwise\n      designated in writing by the copyright owner as \"Not a Contribution.\"\n\n      \"Contributor\" shall mean Licensor and any individual or Legal Entity\n      on behalf of whom a Contribution has been received by Licensor and\n      subsequently incorporated within the Work.\n\n   2. Grant of Copyright License. Subject to the terms and conditions of\n      this License, each Contributor hereby grants to You a perpetual,\n      worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n      copyright license to reproduce, prepare Derivative Works of,\n      publicly display, publicly perform, sublicense, and distribute the\n      Work and such Derivative Works in Source or Object form.\n\n   3. Grant of Patent License. Subject to the terms and conditions of\n      this License, each Contributor hereby grants to You a perpetual,\n      worldwide, non-exclusive, no-charge, royalty-free, irrevocable\n      (except as stated in this section) patent license to make, have made,\n      use, offer to sell, sell, import, and otherwise transfer the Work,\n      where such license applies only to those patent claims licensable\n      by such Contributor that are necessarily infringed by their\n      Contribution(s) alone or by combination of their Contribution(s)\n      with the Work to which such Contribution(s) was submitted. If You\n      institute patent litigation against any entity (including a\n      cross-claim or counterclaim in a lawsuit) alleging that the Work\n      or a Contribution incorporated within the Work constitutes direct\n      or contributory patent infringement, then any patent licenses\n      granted to You under this License for that Work shall terminate\n      as of the date such litigation is filed.\n\n   4. Redistribution. You may reproduce and distribute copies of the\n      Work or Derivative Works thereof in any medium, with or without\n      modifications, and in Source or Object form, provided that You\n      meet the following conditions:\n\n      (a) You must give any other recipients of the Work or\n          Derivative Works a copy of this License; and\n\n      (b) You must cause any modified files to carry prominent notices\n          stating that You changed the files; and\n\n      (c) You must retain, in the Source form of any Derivative Works\n          that You distribute, all copyright, patent, trademark, and\n          attribution notices from the Source form of the Work,\n          excluding those notices that do not pertain to any part of\n          the Derivative Works; and\n\n      (d) If the Work includes a \"NOTICE\" text file as part of its\n          distribution, then any Derivative Works that You distribute must\n          include a readable copy of the attribution notices contained\n          within such NOTICE file, excluding those notices that do not\n          pertain to any part of the Derivative Works, in at least one\n          of the following places: within a NOTICE text file distributed\n          as part of the Derivative Works; within the Source form or\n          documentation, if provided along with the Derivative Works; or,\n          within a display generated by the Derivative Works, if and\n          wherever such third-party notices normally appear. The contents\n          of the NOTICE file are for informational purposes only and\n          do not modify the License. You may add Your own attribution\n          notices within Derivative Works that You distribute, alongside\n          or as an addendum to the NOTICE text from the Work, provided\n          that such additional attribution notices cannot be construed\n          as modifying the License.\n\n      You may add Your own copyright statement to Your modifications and\n      may provide additional or different license terms and conditions\n      for use, reproduction, or distribution of Your modifications, or\n      for any such Derivative Works as a whole, provided Your use,\n      reproduction, and distribution of the Work otherwise complies with\n      the conditions stated in this License.\n\n   5. Submission of Contributions. Unless You explicitly state otherwise,\n      any Contribution intentionally submitted for inclusion in the Work\n      by You to the Licensor shall be under the terms and conditions of\n      this License, without any additional terms or conditions.\n      Notwithstanding the above, nothing herein shall supersede or modify\n      the terms of any separate license agreement you may have executed\n      with Licensor regarding such Contributions.\n\n   6. Trademarks. This License does not grant permission to use the trade\n      names, trademarks, service marks, or product names of the Licensor,\n      except as required for reasonable and customary use in describing the\n      origin of the Work and reproducing the content of the NOTICE file.\n\n   7. Disclaimer of Warranty. Unless required by applicable law or\n      agreed to in writing, Licensor provides the Work (and each\n      Contributor provides its Contributions) on an \"AS IS\" BASIS,\n      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or\n      implied, including, without limitation, any warranties or conditions\n      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A\n      PARTICULAR PURPOSE. You are solely responsible for determining the\n      appropriateness of using or redistributing the Work and assume any\n      risks associated with Your exercise of permissions under this License.\n\n   8. Limitation of Liability. In no event and under no legal theory,\n      whether in tort (including negligence), contract, or otherwise,\n      unless required by applicable law (such as deliberate and grossly\n      negligent acts) or agreed to in writing, shall any Contributor be\n      liable to You for damages, including any direct, indirect, special,\n      incidental, or consequential damages of any character arising as a\n      result of this License or out of the use or inability to use the\n      Work (including but not limited to damages for loss of goodwill,\n      work stoppage, computer failure or malfunction, or any and all\n      other commercial damages or losses), even if such Contributor\n      has been advised of the possibility of such damages.\n\n   9. Accepting Warranty or Additional Liability. While redistributing\n      the Work or Derivative Works thereof, You may choose to offer,\n      and charge a fee for, acceptance of support, warranty, indemnity,\n      or other liability obligations and/or rights consistent with this\n      License. However, in accepting such obligations, You may act only\n      on Your own behalf and on Your sole responsibility, not on behalf\n      of any other Contributor, and only if You agree to indemnify,\n      defend, and hold each Contributor harmless for any liability\n      incurred by, or claims asserted against, such Contributor by reason\n      of your accepting any such warranty or additional liability.\n\n   END OF TERMS AND CONDITIONS\n\n   APPENDIX: How to apply the Apache License to your work.\n\n      To apply the Apache License to your work, attach the following\n      boilerplate notice, with the fields enclosed by brackets \"[]\"\n      replaced with your own identifying information. (Don't include\n      the brackets!)  The text should be enclosed in the appropriate\n      comment syntax for the file format. We also recommend that a\n      file or class name and description of purpose be included on the\n      same \"printed page\" as the copyright notice for easier\n      identification within third-party archives.\n\n   Copyright [yyyy] [name of copyright owner]\n\n   Licensed under the Apache License, Version 2.0 (the \"License\");\n   you may not use this file except in compliance with the License.\n   You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n   Unless required by applicable law or agreed to in writing, software\n   distributed under the License is distributed on an \"AS IS\" BASIS,\n   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n   See the License for the specific language governing permissions and\n   limitations under the License.\n</code></pre>"},{"location":"contributing/","title":"Overview","text":""},{"location":"contributing/#contributing-in-general","title":"Contributing In General","text":"<p>Our project welcomes external contributions. If you have an itch, please feel free to scratch it.</p> <p>To contribute code or documentation, please submit a pull request.</p> <p>A good way to familiarize yourself with the codebase and contribution process is to look for and tackle low-hanging fruit in the issue tracker. Before embarking on a more ambitious contribution, please quickly get in touch with us.</p> <p>Note: We appreciate your effort, and want to avoid a situation where a contribution requires extensive rework (by you or by us), sits in backlog for a long time, or cannot be accepted at all!</p>"},{"location":"contributing/#proposing-new-features","title":"Proposing new features","text":"<p>If you would like to implement a new feature, please raise an issue labelled <code>enhancement</code> before sending a pull request so the feature can be discussed. This is to avoid you wasting your valuable time working on a feature that the project developers are not interested in accepting into the code base.</p>"},{"location":"contributing/#fixing-bugs","title":"Fixing bugs","text":"<p>If you would like to fix a bug, please raise an issue labelled <code>bug</code> before sending a pull request so it can be tracked.</p>"},{"location":"contributing/#merge-approval","title":"Merge approval","text":"<p>The project maintainers use LGTM (Looks Good To Me) in comments on the code review to indicate acceptance.</p> <p>A change requires LGTMs from at least two reviewers. One of the reviewers must be a <code>CODEOWNER</code>.</p> <p>For a list of the maintainers (also codeowners), see the maintainers page.</p>"},{"location":"contributing/#trestle-updating-testing-and-release-logistics","title":"Trestle updating, testing and release logistics","text":"<p>Contributors should make a working copy (branch or fork) from the develop branch of <code>trestle</code>. Contributors should update the working copy with changes, then create a pull request to merge into the develop branch. Contributors must include test cases to meet at least the minimum code coverage requirements. Upon approval from reviewer(s), the working copy is squashed and merged into the develop branch. Upon a cadence established by the maintainers, the develop branch is merged into the main branch and a new release is uniquely numbered and pushed to pypi.</p> <p><code>trestle</code> employs <code>semantic release</code> to automatically control release numbering. Code deliveries should be tagged with prefix <code>fix:</code> for changes that are bug fixes or <code>feat:</code> for changes that are new features.  See allowed_tags for a list of supported tags.</p>"},{"location":"contributing/#trestle-merging-and-release-workflow","title":"Trestle merging and release workflow","text":"<p><code>trestle</code> is operating on a simple, yet opinionated, method for continuous integration. It's designed to give developers a coherent understanding of the objectives of other past developers. The criteria for this are below. Trestle effectively uses a gitflow workflow with one modification: PR's merge into develop are squash merged as one commit.</p> <p>In trestle's CI environment this results in the following rules:</p> <ol> <li>All Commit's MUST be signed off with <code>git commit --signoff</code> irrespective of the author's affiliation. This ensures all code can be attributed.</li> <li>This is enforced by DCO bot and can be overrided by maintainers presuming at least one commit is signed-off.</li> <li>All commits SHOULD use conventional commits</li> <li>This is as github, when only one commit is in a PR, will use the native git commit message as the merge commit title.<ol> <li>When only a single commit is provided the commit MUST be an conventional commit and will be checked the <code>Lint PR</code> aciton.</li> </ol> </li> <li>All PR's title's MUST be formed as an convention commit</li> <li>This is checked by the <code>Lint PR</code> action</li> <li>All PR's to <code>develop</code> and hotfix PR's to <code>main</code> must close at least one issue by linking the PR to an issue.</li> <li>Trestle will release on demand the default approach for a hot fix should be to merge into <code>develop</code>, followed by releasing to <code>main</code>, unless this will release functionality that is not ready.</li> <li>Each feature/fix/chore (PR into develop) be represented by a single commit into develop / main with a coherent title (in the PR).</li> <li>The trestle preference for doing this is to use squash merge functionality when merging a PR into develop.</li> <li>Developers MUST pass the required CI checks for each PR. The checks enforce code quality with a format checker (yapf) and linter (flake8).</li> <li>Developers are encouraged to use GitHub's automated merge process where possible to keep the number of active PR's low.</li> </ol>"},{"location":"contributing/#merge-details-for-committers","title":"Merge details for committers:","text":"<ol> <li>All merges into develop MUST be conducted by a squash-merge</li> <li>All merges from develop into main MUST be done by a merge commit (e.g. preserving the history of commits into the develop branch).</li> <li>Hotfixes into main, not via develop, MUST be done via a squash merge.</li> <li>Merge's into any branch excluding main and develop are at the developers choice.</li> <li>Use of autocommit is encouraged to ensure commit messages and squash vs merge commit are completed properly.</li> </ol>"},{"location":"contributing/#working-from-a-fork","title":"Working from a fork","text":"<ol> <li>In order not to break Github Actions security model SonarCloud will not run on a fork.</li> <li>Given this a maintainer MAY determine that sonar needs to be run and ask you to first merge your branch to a    staging branch, after reviewing for security risks in the CI pipeline.</li> <li>From this staging branch sonar would be run and then the code merged.</li> </ol>"},{"location":"contributing/#typing-docstrings-and-documentation","title":"Typing, docstrings and documentation","text":"<p><code>trestle</code> has a goal of using PEP 484 type annotations where possible / practical. The devops process does not strictly enforce typing, however, the expectation is that type coverage is added for new commits with a focus on quality over quantity (e.g. don't add <code>Any</code> everywhere just to meet coverage requirements). Python typing of functions is an active work in progress.</p> <p><code>mkbuild</code> is used to generate the trestle documenation site. The <code>mkbuild</code> website includes an API reference section generated from the code. Docstrings within the code are expected to follow google style docstrings.</p>"},{"location":"contributing/#legal","title":"Legal","text":"<p>Each source file must include a license header for the Apache Software License 2.0. Using the SPDX format is the simplest approach. e.g.</p> <pre><code># Copyright (c) 2024 The OSCAL Compass Authors. All rights reserved.\n#\n# Licensed under the Apache License, Version 2.0 (the \"License\");\n# you may not use this file except in compliance with the License.\n# You may obtain a copy of the License at\n#\n#     https://www.apache.org/licenses/LICENSE-2.0\n#\n# Unless required by applicable law or agreed to in writing, software\n# distributed under the License is distributed on an \"AS IS\" BASIS,\n# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n# See the License for the specific language governing permissions and\n# limitations under the License.\n</code></pre> <p>We have tried to make it as easy as possible to make contributions. This applies to how we handle the legal aspects of contribution. We use the same approach - the Developer's Certificate of Origin 1.1 (DCO) - that the Linux\u00ae Kernel community uses to manage code contributions.</p> <p>We simply ask that when submitting a patch for review, the developer must include a sign-off statement in the commit message.</p> <p>Here is an example Signed-off-by line, which indicates that the submitter accepts the DCO:</p> <pre><code>Signed-off-by: John Doe &lt;john.doe@example.com&gt;\n</code></pre> <p>You can include this automatically when you commit a change to your local git repository using the following command:</p> <pre><code>git commit --signoff\n</code></pre> <p>Note that DCO signoff is enforced by DCO bot. Missing DCO's will be required to be rebased with a signed off commit before being accepted.</p>"},{"location":"contributing/#setup-developing-trestle","title":"Setup - Developing <code>trestle</code>","text":""},{"location":"contributing/#does-trestle-run-correctly-on-my-platform","title":"Does <code>trestle</code> run correctly on my platform","text":"<ul> <li>(Optional) setup a venv for python</li> <li>Run <code>make develop</code></li> <li>This will install all python dependencies</li> <li>It will also checkout the submodules required for testing.</li> <li>Run <code>make test</code></li> <li>This should run on all platforms</li> </ul>"},{"location":"contributing/#setting-up-vscode-for-python","title":"Setting up <code>vscode</code> for python.","text":"<ul> <li>Use the following commands to setup python:</li> </ul> <pre><code>python3 -m venv venv\n. ./venv/bin/activate\n# for zsh put .[dev] in quotes as below\npip install -q -e \".[dev]\" --upgrade --upgrade-strategy eager\n</code></pre> <ul> <li> <p>Install vscode plugin <code>Python extension for Visual Studio Code</code></p> </li> <li> <p>Enable <code>yapf</code> for code formatting</p> </li> <li> <p>Enable <code>flake8</code> for code linting</p> </li> </ul>"},{"location":"contributing/#testing-python-in-vscode","title":"Testing python in <code>vscode</code>","text":"<p>Tests should be in the test subdirectory. Each file should be named test_*.py and each test function should be named *_test().</p> <p>Note that with Python3 there should be no need for init.py in directories.</p> <p>Test discovery should be automatic when you select a .py file for editing. After tests are discovered a flask icon will appear on the left and you can select it to see a panel listing of your tests.  In addition your test functions will be annotated with Run/Debug so they can be launched directly from the editor.  When everything is set up properly you should be able to step through your test code - which is important.</p> <p>Sometimes the discovery fails - and you may need to resort to uninstalling the python extension and reinstalling it - perhaps also shutting down code and restarting.  This is a lightweight operation and seems to be safe and usually fixes any problems.</p> <p>Test discovery will fail or stop if any of the tests have errors in them - so be sure to monitor the Problems panel at the bottom for problems in the code.</p> <p>Note that there are many panels available in Output - so be sure to check <code>Python Test Log</code> for errors and output from the tests.</p> <p>pytest fixtures are available to allow provision of common functionality.  See conftest.py and tmp_dir for an example.</p>"},{"location":"contributing/#nist-reference-data-for-testing","title":"NIST reference data for testing.","text":"<p>Trestle relies on reference data from two NIST repositories for testing:</p> <ul> <li>https://github.com/usnistgov/OSCAL</li> <li>https://github.com/usnistgov/oscal-content</li> </ul> <p>Both of these repositories are submodules in the trestle project. In order to develop / test trestle the submodules must be checked out with <code>git submodule update --init</code> or <code>make submodules</code>.</p>"},{"location":"contributing/#code-testing","title":"Code testing","text":"<p>Tests must exist for at least 96% of trestle Python code. To determine the code coverage locally during development:</p> <pre><code>make test-cov\n</code></pre> <p>A PR without sufficient test coverage will fail the trestle CI process and will not be approved or merged.</p> <p>Additional code scrutiny is applied in the trestle CI pipeline by SonarCloud. Any failures must be addressed before code merging.</p>"},{"location":"contributing/#code-style-and-formating","title":"Code style and formating","text":"<p>Python code should generally follow PEP 8.</p> <p><code>trestle</code> uses yapf for code formatting and flake8 for code styling.  It also uses pre-commit hooks that are integrated into the development process and the CI. When you run <code>make develop</code> you are ensuring that the pre-commit hooks are installed and updated to their latest versions for this repository. This ensures that all delivered code has been properly formatted and passes the linter rules.  See the pre-commit configuration file for details on <code>yapf</code> and <code>flake8</code> configurations.</p> <p>Since <code>yapf</code> and <code>flake8</code> are installed as part of the <code>pre-commit</code> hooks, running <code>yapf</code> and <code>flake8</code> manually must be done through <code>pre-commit</code>.  See examples below:</p> <pre><code>make code-format\nmake code-lint\n</code></pre> <p>...will run <code>yapf</code> and <code>flake8</code> on the entire repo and is equivalent to:</p> <pre><code>pre-commit run yapf --all-files\npre-commit run flake8 --all-files\n</code></pre> <p>...and when looking to limit execution to a subset of files do similar to:</p> <pre><code>pre-commit run yapf --files trestle/*\npre-commit run flake8 --files trestle/*\n</code></pre> <p>Note that in both of these cases autogenerated files under <code>trestle/oscal</code> are excluded. Note that for IDE support <code>setup.cfg</code> maintains a cache of <code>flake8</code> configuration.</p>"},{"location":"contributing/#developers-guide-to-trestle-upgrade-commensurate-with-oscal-models-upgrade","title":"Developers Guide to trestle upgrade commensurate with OSCAL models upgrade","text":"<p>This is a general guide on how to go about upgrading compliance-trestle to support a new version of OSCAL models.</p> <p>The steps are as follows:</p> <ol> <li> Create  in GitHub repo (remote) <li> Clone upgrade branch into /trestle-upgrade folder (local &lt;- remote) <li> Download revised and new OSCAL models into folder /trestle-upgrade/release-schemas (local &lt;- remote) <ul> <li> See https://github.com/usnistgov/OSCAL/releases <li> Create &amp; source python virtual environment venv.trestle-upgrade (local) <li> Orient current folder to /trestle-upgrade (local) <li> Run make develop (local) <li> Make necessary code changes: <ul> <li> Run python scripts/gen_oscal.py (local) <li> Run make test-all (local) <li> Fix errors and failures via modification of code generation modules and existing trestle modules, as appropriate case-by-case (local) <li> Repeat until all errors and failures are fixed (local) <li> Run make code-format (local) <li> Run make code-lint (local) <li> Push /trestle-upgrade folder changes back to GitHub repo (local -&gt; remote) <li> Create PR for trestle-upgrade branch -&gt; develop branch (remote) <li> Get PR approval (remote) <li> Merge PR into develop branch (remote) <li> Create PR for develop branch -&gt; main branch (remote) <li> Create breaking change (remote) <li> Get PR approval (remote) <li> Merge develop branch into main branch (remote)"},{"location":"contributing/#overview-of-process-to-take-oscal-models-and-upgrade-trestle-python-code","title":"Overview of process to take OSCAL models and upgrade trestle Python code","text":""},{"location":"contributing/DCO/","title":"Developer Certificate of Originality","text":"<pre><code>Developer Certificate of Origin\nVersion 1.1\n\nCopyright (C) 2004, 2006 The Linux Foundation and its contributors.\n660 York Street, Suite 102,\nSan Francisco, CA 94110 USA\n\nEveryone is permitted to copy and distribute verbatim copies of this\nlicense document, but changing it is not allowed.\n\n\nDeveloper's Certificate of Origin 1.1\n\nBy making a contribution to this project, I certify that:\n\n(a) The contribution was created in whole or in part by me and I\nhave the right to submit it under the open source license\nindicated in the file; or\n\n(b) The contribution is based upon previous work that, to the best\nof my knowledge, is covered under an appropriate open source\nlicense and I have the right under that license to submit that\nwork with modifications, whether created in whole or in part\nby me, under the same open source license (unless I am\npermitted to submit under a different license), as indicated\nin the file; or\n\n(c) The contribution was provided directly to me by some other\nperson who certified (a), (b) or (c) and I have not modified\nit.\n\n(d) I understand and agree that this project and the contribution\nare public and that a record of the contribution (including all\npersonal information I submit with it, including my sign-off) is\nmaintained indefinitely and may be redistributed consistent with\nthis project or the open source license(s) involved.\n</code></pre>"},{"location":"contributing/code_of_conduct/","title":"Code of Conduct","text":"<p>Please refer to our OSCAL Compass Community Code of Conduct.</p>"},{"location":"contributing/github_actions_setup/","title":"Github actions setup","text":"<p>Github actions contains variables which have opaque values to a user. The variables are documented here such that trestle can be setup on a fork for independent development. This is not required to open a pull request against the compliance-trestle project. Project maintainers, after an initial review, will allow github actions workflows to run.</p>"},{"location":"contributing/github_actions_setup/#secrets","title":"Secrets","text":"<ul> <li> <p><code>APP_ID</code> and <code>PRIVATE_KEY</code>: GitHub App information with sufficient write access to merge content into <code>develop</code> and commit to <code>gh-pages</code> and <code>main</code></p> </li> <li> <p><code>SONAR_TOKEN</code>: Token to sonarcloud with rights to the appropriate project.</p> </li> </ul>"},{"location":"contributing/github_actions_setup/#authorization-with-pypi","title":"Authorization with pypi","text":"<p>Pypi authorization must be setup following the procedure in the following documents</p> <ul> <li>https://docs.pypi.org/trusted-publishers/adding-a-publisher/</li> </ul>"},{"location":"contributing/maintainers/","title":"Maintainers","text":"<p>Trestle was designed and open sourced by a team based at IBM Research and others around the world.  The list includes:</p> <p>Alejandro Jose Leiva Palomo AleJo2995</p> <p>Christopher Butler butler54</p> <p>Lou Degenaro degenaro</p> <p>Jennifer Power jpower432</p> <p>Manjiree Gadgil mrgadgil</p> <p>Vikas Agarwal vikas-agarwal76</p>"},{"location":"contributing/oscal_object_model/","title":"Using trestle as an object model for OSCAL","text":"<p>Trestle provides an object model for OSCAL to ease the development and validation of OSCAL objects that reside in the <code>trestle.oscal</code> module. This functionality, which is built on pydantic and python data classes, allows validation of the OSCAL schema and is leveraged to provide a variety of utility functions including:</p> <ul> <li>IO Support for yaml / json / python dict serialisation see <code>OscalBaseModel</code> for trestle enhancements</li> <li>The ability to generate pro-forma objects using <code>trestle.core.generate::generate_sample_model</code></li> <li>Integration into the flask api framework (demo)</li> </ul>"},{"location":"contributing/oscal_object_model/#mapping-and-variance-with-oscal-names","title":"Mapping and variance with OSCAL names.","text":"<p>The underlying object model that trestle relies on is the json schema published by NIST here. In understanding these models the model reference page is an indispensable source.</p> <p>When generating the python data class based models we have tried to be as faithful as we can to the naming convention provided by OSCAL. This is the hierarchy of rules that we have used:</p> <ol> <li>Do not include prepends from the json schema (e.g. <code>assembly_oscal-catalog_catalog</code> becomes the short name <code>catalog</code>), modules are used for scoping statements</li> <li>OSCAL modules use hyphen case (e.g. <code>system-security-plan</code>) and this is converted to CamelCase (e.g. <code>SystemSecurityPlan</code>)</li> <li>Name collisions with reserved words in python are post-pended with an underscore (e.g. <code>class</code> becomes <code>class_</code>)</li> <li>If a model is used across multiple OSCAL schemas (e.g. <code>metadata</code>) it is put into the common module(<code>trestle.oscal.common</code>), otherwise it will be scoped to a model specifically for that schema.</li> <li>Any unresolved duplicates are resolved by adding an index e.g. <code>class State1</code></li> </ol>"},{"location":"contributing/oscal_object_model/#oscal-schema-mapping","title":"OSCAL Schema mapping","text":"<p>This maps between OSCAL values and the corresponding pydantic/python data class in trestle. For example, to get a catalog you would call:</p> <pre><code>from pathlib import Path\nfrom trestle.oscal.catalog import Catalog\n\nmy_catalog = Catalog.oscal_read(Path('path/to/file.json'))\n</code></pre> Oscal schema json schema name Trestle module Trestle class name Catalog <code>catalog</code> <code>catalog</code> <code>trestle.oscal.catalog</code> Profile <code>profile</code> <code>profile</code> <code>trestle.oscal.profile</code> Component Definition <code>component-definition</code> <code>trestle.oscal.component</code> <code>ComponentDefinition</code> System Security Plan <code>system-security-plan</code> <code>trestle.oscal.ssp</code> <code>SystemSecurityPlan</code> Assessment Plan <code>assessment-plan</code> <code>trestle.oscal.assessment_plan</code> <code>AssessmentPlan</code> Assessment Results <code>assessment-results</code> <code>trestle.oscal.assessment_results</code> <code>AssessmentResults</code> Plan of action and milestones <code>plan-of-action-and-milestones</code> <code>trestle.oscal.poam</code> <code>PlanOfActionAndMilestones</code>"},{"location":"contributing/plugins/","title":"Adding plugins to trestle","text":"<p>Trestle provides a mechanism for 3rd party providers to extend its command interface via a plugin architecture. All trestle plugins that conforms to this specification will be automatically discovered by trestle if installed, and their command(s) will be added to trestle sub-commands list. Below we describe this plugin mechanism with the help of an example plugin <code>compliance-trestle-fedramp</code> that we created as a separate python project that can be installed via <code>pip</code>.</p>"},{"location":"contributing/plugins/#create-the-trestle-plugin-proejct","title":"Create the trestle plugin proejct","text":"<p>A separate plugin project needs to be created that will conatin the code for plugin and its commands. This plugin can be given any name and should be available for installation via <code>pip</code>. For example, we created a plugin project called  <code>compliance-trestle-fedramp</code> which can be installed as <code>pip install compliance-trestle-fedramp</code>. The project name doesn't need to start with <code>compliance-trestle</code>.</p>"},{"location":"contributing/plugins/#project-organization","title":"Project Organization","text":"<p>The plugin project should be organized as shown below.</p> <pre><code>compliance-trestle-fedramp\n\u251c\u2500\u2500 trestle_fedramp\n\u2502   \u251c\u2500\u2500 __init__.py\n\u2502   \u251c\u2500\u2500 commands\n|   |   \u251c\u2500\u2500 __init__.py\n|   |   \u251c\u2500\u2500 validate.py\n|   \u251c\u2500\u2500 jinja_ext\n|   |   \u251c\u2500\u2500 __init__.py\n|   |   \u251c\u2500\u2500 filters.py\n\u2502   \u251c\u2500\u2500 &lt;other source files or folder&gt;\n\u251c\u2500\u2500 &lt;other files or folder&gt;\n</code></pre> <p>Trestle uses a naming convention to discover the top-level module of the plugin projects. It expects the top-level module to be named <code>trestle_{plugin_name}</code>. This covention must be followed by plugins to be discoverable by trestle. In the above example, the top-level module is named as <code>trestle_fedramp</code> so that it can be autmatically discovered by trestle. All the python source files should be created inside this module (folder).</p> <p>To add commands to the CLI interface, the top-level module should contain a <code>commands</code> directory where all the plugin command files should be stored. Each command should have its own python file. In the above example, <code>validate.py</code> file contains one command for this plugin. Other python files or folders should be created in the top-level module folder, outside the <code>commands</code> folder. This helps in keeping the commands separate and in their discovery by trestle.</p> <p>To add jinja extensions available during <code>trestle author jinja</code>, the top-level module should contain a <code>jinja_ext</code> directory where all extension files should be stored. Each extension should have its own python file. In the above example, <code>filters.py</code> file contains a single extension class, which may define many filters or custom tags. Supporting code should be created in the top-level module folder, outside the <code>jinja_ext</code> folder. This helps in keeping the extensions separate and in their discovery by trestle.</p>"},{"location":"contributing/plugins/#command-creation","title":"Command Creation","text":"<p>The plugin command should be created as shown in the below code snippet.</p> <pre><code>from trestle.core.commands.command_docs import CommandBase\nfrom trestle.core.commands.command_docs import CommandPlusDocs\n\nclass ValidateCmd(CommandBase):\n    \"\"\"Validate contents of an OSCAL model based on FedRAMP specifications.\"\"\"\n\n    name = 'fedramp-validate'\n\n    def _init_arguments(self) -&gt; None:\n        logger.debug('Init arguments')\n        self.add_argument('-f', '--file', help='OSCAL file to validate.', type=str, required=True)\n\n        self.add_argument(\n            '-o', '--output-dir', help='Output directory for validation results.', type=str, required=True\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        model_file = pathlib.Path(args.file).resolve()\n\n        output_dir = pathlib.Path(args.output_dir).resolve()\n        ...\n        ...\n        return 0 if valid else 1\n</code></pre> <p>There should be a command class for example, <code>ValidateCmd</code> which should either extend from <code>CommandBase</code> or <code>CommandPlusDocs</code>. Trestle uses <code>ilcli</code> package to create commands. <code>CommandBase</code> extends from <code>ilcli.Command</code> that initializes the command including help messages and input parameters. <code>CommandPlusDocs</code> in turn extends from <code>CommandBase</code>. The difference between <code>CommandBase</code> and <code>CommandPLusDocs</code> is that <code>CommandBase</code> does not require command line parameter <code>trestle-root</code> to be set or the current directory to be a valid trestle root, whereas <code>CommandPlusDocs</code> requires a valid <code>trestle-root</code> and checks for it. Hence, depending upon the requirement of the plugin command it can extend from either of these classes.</p> <p>The docstring of the command class is used as the help message for the command. Input arguments to the command should be specified in <code>_init_arguments</code> method as shown above. The acutal code of the command is contained in<code>_run</code> method. This method is called by ilcli when the command is excuted on the commandline. The command arguments can be accessed from the <code>args</code> input parameter as shown above. The command should return <code>0</code> in case of successful execution, or any number greater than 0 in case of failure. Please see <code>trestle.core.commands.common.return_codes.CmdReturnCodes</code> class for specific return codes in case of failure.</p> <p>The command class should conatin the <code>name</code> field which should be set to the desired command name. In the above example, the command is called <code>fedramp-validate</code>. This name is automatically added to the list of sub-command names of trestle during the plugin discovery process. This command can then be invoked as <code>trestle {name}</code> from the commandline e.g., <code>trestle fedramp-validate</code>. Any input parameters to the command can also be passed on the commandline after the command name.</p>"},{"location":"contributing/plugins/#jinja-extension-creation","title":"Jinja Extension Creation","text":"<p>The plugin extension should be created as shown in the below code snippet.</p> <pre><code>from jinja2 import Environment\nfrom trestle.core.jinja.base import TrestleJinjaExtension\n\ndef _mark_tktk(value: str) -&gt; str:\n    \"\"\"Mark a value with TKTK to easily find it for future revision.\"\"\"\n    return f'TKTK {value} TKTK'\n\n\nclass Filters(TrestleJinjaExtension):\n    def __init__(self, environment: Environment) -&gt; None:\n        super(Filters, self).__init__(environment)\n\n        environment.filters['tktk'] = _mark_tktk\n</code></pre> <p>There should be an extension class, for example <code>Filters</code> that must extend from <code>TrestleJinjaExtension</code> or <code>jinja2.ext.Extention</code>. The <code>__init__</code> method must call init for its superclass. Beyond that, any behavior for standard jinja2 custom extensions is supported.</p> <p>Examples for implementing extensions can be found at <code>trestle/core/jinja/tags.py</code> and <code>trestle/core/jinja/filters.py</code></p>"},{"location":"contributing/website/","title":"Developing for the trestle documentation website","text":"<p>This page describes the developing for the trestle (website) which is deployed at https://oscal-compass.github.io/compliance-trestle.</p>"},{"location":"contributing/website/#documentation-for-use-within-the-github-project","title":"Documentation for use within the github project.","text":"<p>Github uses certain files within a project such as <code>/README.md</code>, <code>/CONTRIBUTING.md</code>, <code>LICENSE</code> which are specifically indexed by github. The current documentation website build reuses some of these files, specifically:</p> <ul> <li>Contents of <code>README.md</code></li> <li>Entirety of <code>LICENSE</code></li> <li>Entirety of <code>CONTRIBUTING.md</code></li> <li>Entirety of <code>CHANGELOG.md</code></li> <li>Entirely of <code>MAINTAINERS.md</code></li> <li>Entirely of <code>DCO1.1.txt</code></li> </ul> <p>For this to work correctly no relative links within the github repository should exist. All links should be absolute to the documentation website.</p>"},{"location":"contributing/website/#build-system-and-local-testing-of-the-website","title":"Build system and local testing of the website.","text":"<p>Trestle has adopted the <code>mkdocs</code> system to generate this website using a small number of extensions to mkdocs. The website can be viewed locally from a clone of the <code>compliance-trestle</code> repo by running <code>make docs-serve</code> in the root directory bringing the website up at <code>https://localhost:8000</code>. If you experience issues run <code>make develop</code> to ensure the appropriate markdown extensions are in your python environment.</p> <p><code>make docs-serve</code> performs two actions:</p> <ul> <li>Runs the custom automation script <code>scripts/website_automation.py</code></li> <li>Serves the website on localhost.</li> </ul> <p>All documentation specific assets are stored within the <code>./docs</code> folder. The exception being <code>mkdocs.yml</code> which configures the documentation tree. Before opening a PR users should ensure:</p> <ul> <li>No warnings are generated by mkdocs</li> <li>All markdown documents within <code>./docs</code> are included in the website navigation defined in <code>mkdocs.yml</code></li> </ul>"},{"location":"contributing/website/#trestle-custom-automation","title":"<code>trestle</code> custom automation.","text":"<p>In order to streamline development, and ensure the website remains up to date, a small automation script has been built. This automation script principally ensures that:</p> <ul> <li>License is consistent with github.com</li> <li>All modules are in the reference documentation</li> </ul> <p>running <code>make docs-automation</code> will ensure that the website is ready to deploy.</p>"},{"location":"contributing/website/#building-the-models-from-the-oscal-schemas","title":"Building the models from the OSCAL schemas.","text":"<p>The creation of the OSCAL models in <code>trestle/oscal</code> is a multi-step process:</p> <ul> <li>The oscal schemas are downloaded as modules from NIST into the <code>nist-source/json/schema</code> directory.</li> <li>The script <code>scripts/gen-oscal.py</code> loads each schema file and converts it to pydantic/python with <code>datamodel-codegen</code>.</li> <li>The generated python files may need some fixup, so a separate script <code>scripts/fix_any.py</code> is run on each file.</li> <li>Note that there is one schema specific to IBM needs and it is loaded from <code>3rd-party-schema-documents/IBM_target_schema_v1.0.0.json</code>.</li> </ul> <p>The whole process is handled in the Makefile by <code>make code-gen</code>.  A normal user would never need to run this but developers may need to, particularly if there are changes to the OSCAL schemas.</p> <p>Also note that the depenedent tools, pydantic and datamodel-codegen, may get updated by doing a fresh <code>make install</code> or <code>make develop</code>, which may then result in a change to the model files.</p>"},{"location":"contributing/website/#items-handled-by-fix_anypy","title":"Items handled by <code>fix_any.py</code>.","text":"<p>The original motivation for this script was to replace numerous situations where the type assigned to a given variable was simply <code>Any</code>, which meant no type enforcement would apply for that variable, defeating the purpose of the strict type enforcement provided by Pydantic.  As of this writing the number of such cases has been reduced to just one - which is handled by the script.</p> <p>Other issues handled by the script are:</p> <ul> <li>The current OSCAL schemas have situations where objects are defined within different classes in a schema using the same name, but the contents of those classes may or may not be different.  <code>datamodel-codegen</code> handles this by creating separate classes as needed and appending 1, 2 etc. to the names, keeping them distinct.  The resulting high level classes that reference them behave as expected, but if components of those classes are added in a granular way by a user or developer, the correct index must be used.</li> <li>To reduce side-effects of the duplicate classes, classes are checked to see if they are identical or not.  If they are identical the separate 1, 2 classes are culled and references to them are pointed to the non-indexed class.</li> <li>Currently there are 5 classes that require a separate '1' version: <code>Status, Type, Entry, LocalDefinitions, and Action</code>.</li> <li>In order to guarantee there are no induced forward references in the files, the classes are reordered to minimize the need for forwards, and any that can't be avoided are explicitly provided at the bottom of the file.</li> <li>The generated files have many classes that simply have a <code>__root__</code> element defined, along with a description.  Such classes don't have particular value in such a simple form and could instead simply be defined in the parent class.</li> </ul>"},{"location":"contributing/website/#seeing-the-changes-induced-by-fix_anypy-on-the-classes","title":"Seeing the changes induced by <code>fix_any.py</code> on the classes.","text":"<p>As a convenience for developers, a separate script, <code>scripts/order_classes.py</code> is available, which orders the classes in a given file alphabetically.  This way, if you use the script on files before and after applying <code>fix_any.py</code> you can use a normal diff tool to see the changes made.  This is strictly as a development tool for doing the comparison and the resulting files will not work since they will have forward references.</p>"},{"location":"plugins/fedramp/","title":"compliance-trestle-fedramp plugin","text":"<p>This plugin provides functionality for validating an SSP for FedRAMP compliance. It provides both an API interface and a trestle command for performing this validation.</p>"},{"location":"plugins/fedramp/#trestle-fedramp-validate","title":"<code>trestle fedramp-validate</code>","text":"<p>This command allows users to validate existing OSCAL SSP file (in JSON or YAML format) for FedRAMP compliance. For example, <code>trestle fedramp-validate -f /local_dir/ssp.json -o report/</code> will validate <code>ssp.json</code> file for fedramp compliance and store the validation reports in <code>report</code> folder.</p> <p>The following options are supported:</p> <ul> <li><code>-f or --file</code>: specifies the path of an existing OSCAL SSP file. It may be an absolute or relative path. The file must be in either JSON or YAML format. This is a required option.</li> <li><code>-o or --output</code>: specifies the name of the output directory where the validation reports will be stored. It may be an absolute or relative path. The output directory should already exist. This is also a required option.</li> </ul> <p>The validation reports are created in XML and HTML format and provide details on which part of the SSP are not complaint as per FedRAMP specification.</p>"},{"location":"plugins/fedramp/#trestle-fedramp-transform","title":"<code>trestle fedramp-transform</code>","text":"<p>This command allows users to extract information from an OSCAL SSP and transform it into a Word document based on the FedRAMP SSP Appendix A Template. The templates for the High, Moderate, and Low baseline security control requirements were retrieved from this location and are bundled with the application. The <code>Control Summary Information</code> tables are populated for each control based on the OSCAL SSP.</p> <p>For example, <code>trestle fedramp-transform -n ssp-name -l 'high' -o my_ssp.docx</code> will transform the OSCAL SSP file <code>ssp-name</code> into a Word document <code>my_ssp.docx</code> based on the SSP Appendix A - High FedRAMP Security Controls template.</p> <p>The following options are supported:</p> <ul> <li><code>-n or --ssp-name</code>: The name of the OSCAL SSP imported into trestle workspace. This is a required option.</li> <li><code>-l or --level</code>: The baseline level corresponding to the template. This is high, moderate, low. This is a required option.</li> <li><code>-o or --output-file</code>: The output location for the populated Word document. This is also a required option.</li> </ul>"},{"location":"reference/third-party-result-schema-IBM-SCC/","title":"Schema of Assessment Results for Interchange with IBM Cloud Security and Compliance Center, SCC","text":"<p>This document depicts the structure and guidelines for creating an OSCAL result object which would be generated by various transformers for different tools such as Tanium to OSCAL and OSCO to OSCAL. Policy Validation Points (PVPs) such as toolchain that directly generate OSCAL results for sending to SCC Exchange API should follow the structure and guidelines described below.</p> <p>The overall object will be a results element of OSCAL Assessment Result schema wrapped in an outer json object as shown below.</p> <pre><code>{\n  \"results\": [\n    {\n      \"result\": \"object\"\n    },\n    {\n      \"result\": \"object\"\n    }\n  ]\n}\n</code></pre> <p>Each result object represents one assessment scan and should have the required properties as per OSCAL schema. The start and end represents the start and end datetime of evidence collection activity. The end is optional. In addition to these, the result object may contain details about inventory, list of observations (checks) for each inventory, and findings for profile level controls (such as NIST).</p> <pre><code>{\n  \"uuid\": \"cd54e9bf-f4d3-45d6-ae3b-6e8255847dc2\",\n  \"title\": \"Tanium\",\n  \"description\": \"Tanium\",\n  \"start\": \"2021-04-05T20:19:11.000+00:00\",\n  \"end\": \"2021-04-05T20:19:11.000+00:00\",\n  \"local-definitions\": {},\n  \"reviewed-controls\": {},\n  \"observations\": {},\n  \"findings\": {}\n}\n</code></pre> <p>The inventory should be included in local-definitions if observations are being reported, but can be omitted if only findings are being reported. As reviewed-controls is required as per OSCAL schema, an empty object should be included if only observations are being reported. Optionally, the controls for which the status is being reported in findings can be captured here. The actual assessment checks being performed on different inventory items should be captured under observations. This can be omitted if only findings are being reported. As findings is required as per OSCAL schema, an empty object can be included if only observations are being reported and no profile controls are being assessed. Otherwise, findings should include the status of profile controls.</p>"},{"location":"reference/third-party-result-schema-IBM-SCC/#general-guidance","title":"General Guidance","text":"<ol> <li> <p>All the properties in the source result (tool specific format) should be represented as properties of the right objects in OSCAL such as inventory-items, observations, etc. The properties should have a tool specific namespace to convey that the property names are exactly same as what is coming from specific tools.</p> </li> <li> <p>Not everything from the non-OSCAL results are relevant (required) by SCC. The relevant properties MUST have SCC specific class such as scc_inventory_item_id, scc_result, etc. This will help SCC identify corresponding information from different tools and handle them appropriately. SCC MUST store the original property names so that when these are retrieved by tools later, they can get back the same name-value pairs as was there in the input data.</p> </li> <li> <p>There must be a pre-defined set of properties (class values) from SCC for each result object component such as inventory-items, components, observations, etc.</p> </li> <li> <p>A property value MUST be a string of appropriate format.</p> </li> </ol>"},{"location":"reference/third-party-result-schema-IBM-SCC/#transforms","title":"Transforms","text":"<ol> <li>File Unification SCC class for OSCO and Tanium to OSCAL.xlsx contains the SCC class mapping from Tanium and OpenShift Compliance Operator results data to OSCAL. Although other    properties are constructed during transformation, only items having SCC class are shown    in the table.</li> </ol>"},{"location":"reference/third-party-result-schema-IBM-SCC/#inventory","title":"Inventory","text":"<ol> <li>Inventory is captured under local-definitions in result object. local-definitions can be used to represent inventory items, components, users, etc. For our purposes only components and inventory-items will be used. Components should be used to represent software, services, etc. whereas inventory-items represent specific machines, VMs, network devices, etc. The inventory items should be associated to a component through implemented-components as shown below.</li> </ol> <pre><code>{\n  \"local-definitions\": {\n    \"components\": {\n      \"b3e243a1-4660-4f5a-aa85-159b4b2d69ce\": {\n        \"type\": \"Operating System\",\n        \"title\": \"Windows 10\",\n        \"description\": \"Windows 10\",\n        \"status\": {\n          \"state\": \"operational\"\n        }\n      }\n    },\n    \"inventory-items\": [\n      {\n        \"uuid\": \"c9fb63cf-d21e-4584-88f8-44d67ea33ba0\",\n        \"description\": \"inventory\",\n        \"props\": [\n          {\n            \"name\": \"Computer Name\",\n            \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n            \"value\": \"cmp-wn-2106.demo.tanium.local\"\n          },\n          {\n            \"name\": \"Tanium Client IP Address\",\n            \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n            \"value\": \"192.168.0.120\",\n            \"class\": \"scc_inventory_item_id\"\n          },\n          {\n            \"name\": \"IP Address\",\n            \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n            \"value\": \"['fe80::cd44:4154:61e8:53ae', '192.168.0.120']\"\n          },\n          {\n            \"name\": \"Count\",\n            \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n            \"value\": \"1\"\n          }\n        ],\n        \"implemented-components\": [\n          {\n            \"component-uuid\": \"b3e243a1-4660-4f5a-aa85-159b4b2d69ce\"\n          }\n        ]\n      }\n    ]\n  }\n}\n</code></pre> <ol> <li> <p>Inventory items have one required property with class scc_inventory_item_id as shown above. Similarly in some other tool's result the scc_inventory_item_id may be specified through some other property. It is the job of the transformation code to appropriately specify class values for required properties. As shown above, non-mandatory property such as count from native result does not have any class specified.</p> </li> <li> <p>The type of the inventory item is specified by linking it to component via implemented-components.</p> </li> </ol>"},{"location":"reference/third-party-result-schema-IBM-SCC/#observation","title":"Observation","text":"<ol> <li>Loosely speaking, an observation object equates with results from a goal check, and the observation is uniquely identified by a uuid, e.g.,</li> </ol> <pre><code>{\n  \"uuid\": \"00000000-0000-4000-9999-000000000016\",\n  \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords\"\n}\n</code></pre> <ol> <li>A sample observation object generated from Tanium result looks like -</li> </ol> <pre><code>{\n  \"uuid\": \"74b605f8-7e8c-41b3-9514-2412692fbe01\",\n  \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\",\n  \"props\": [\n    {\n      \"name\": \"Check ID\",\n      \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n      \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\"\n    },\n    {\n      \"name\": \"Check ID Benchmark\",\n      \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n      \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n      \"class\": \"scc_predefined_profile\"\n    },\n    {\n      \"name\": \"Check ID Version\",\n      \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n      \"value\": \"1.0.0-1\",\n      \"class\": \"scc_check_version\"\n    },\n    {\n      \"name\": \"Check ID Version\",\n      \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n      \"value\": \"1.0.0-1\",\n      \"class\": \"scc_predefined_profile_version\"\n    },\n    {\n      \"name\": \"Check ID Level\",\n      \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n      \"value\": \"Level 1 - Server\"\n    },\n    {\n      \"name\": \"Rule ID\",\n      \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n      \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\",\n      \"class\": \"scc_goal_description\"\n    },\n    {\n      \"name\": \"Rule ID\",\n      \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n      \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\",\n      \"class\": \"scc_check_name_id\"\n    },\n    {\n      \"name\": \"State\",\n      \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n      \"value\": \"fail\",\n      \"class\": \"scc_result\"\n    },\n    {\n      \"name\": \"Timestamp\",\n      \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n      \"value\": \"2021-05-11T22:34:03+00:00\",\n      \"class\": \"scc_timestamp\"\n    }\n  ],\n  \"methods\": [\n    \"TEST-AUTOMATED\"\n  ],\n  \"subjects\": [\n    {\n      \"uuid-ref\": \"c8919d2b-3300-4f3f-98f6-15a7104c2e04\",\n      \"type\": \"inventory-item\"\n    }\n  ],\n  \"collected\": \"2021-05-11T22:34:03.000+00:00\"\n}\n</code></pre> <ol> <li> <p>An observation has five required properties -</p> </li> <li> <p>scc_predefined_profile - identifies both Goal based Profiles (eg CIS-benchmarks, IBM BP etc) and Control/Regulation based Profiles (eg. NIST, FS Cloud etc). The way the integrators or customers will differentiate between the two types of profiles is by the OSCAL element used i.e., Goal based Profiles are defined in the observation element which carries the goal id (check id) and posture. Control/Regulation based Profiles\u00a0 are defined in the finding element which carries the control posture, the custom profile name, and the mapping of the goal results to NIST controls</p> </li> <li>scc_check_version, scc_predefined_profile_version - gives the version of the goal/profile i.e., CIS benchmark version used for check.</li> <li>scc_goal_description, scc_check_name_id - gives the specific goal check (rule) that was assessed from the scc_predefined_profile.</li> <li>scc_result - gives the outcome of performing the check. Possible values are - \"pass\", \"fail\", \"error\" , \"unknown\", \"notchecked\", \"notapplicable\".</li> <li> <p>scc_timestamp - datetime for this observation. This can be date and time when this observation was performed or reported.</p> </li> <li> <p>Targets such as systems or services MUST be a subject in the observation, which MUST be identified by a uuid-ref value pointing to the subject in local-definitions.</p> </li> </ol>"},{"location":"reference/third-party-result-schema-IBM-SCC/#finding","title":"Finding","text":"<ol> <li>A finding represents the assessment of a profile control such as NIST 800-53: AC-1 and the related observations. A sample finding object looks like -</li> </ol> <pre><code>{\n  \"uuid\": \"cde35fad-3922-4046-8ef8-830e77ffd75a\",\n  \"title\": \"800-53: IA-5\",\n  \"description\": \"800-53: IA-5\",\n  \"target\": {\n    \"type\": \"statement-id\",\n    \"id-ref\": \"800-53: IA-5\",\n    \"props\": [\n      {\n        \"name\": \"Profile\",\n        \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n        \"value\": \"Windows 10 - NIST 800-53\",\n        \"class\": \"scc_predefined_profile\"\n      },\n      {\n        \"name\": \"Version\",\n        \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n        \"value\": \"version: 1\",\n        \"class\": \"scc_predefined_profile_version\"\n      },\n      {\n        \"name\": \"Custom ID\",\n        \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n        \"value\": \"800-53: IA-5\"\n      }\n    ],\n    \"status\": \"not-satisfied\"\n  },\n  \"related-observations\": [\n    {\n      \"observation-uuid\": \"d8bd1785-b95f-45c9-9fa8-32a362845102\"\n    },\n    {\n      \"observation-uuid\": \"d06c6f13-5006-4e2d-b3f3-5cdb577473b1\"\n    }\n  ]\n}\n</code></pre> <ol> <li> <p>A finding has two required property scc_predefined_profile that gives the name of the profile whose control is specified in \"id-ref\", and scc_predefined_profile_version.</p> </li> <li> <p>If there is no finding associated with a PVP, a single finding will be created (to preserve valid OSCAL) where the UUID maps to a 'all zeros' UUID e.g.:</p> </li> </ol> <pre><code>{\n  \"uuid\": \"00000000-0000-4000-8000-000000000000\",\n  \"title\": \"No finding\",\n  \"description\": \"No finding.\"\n}\n</code></pre>"},{"location":"reference/API/trestle/cli/","title":"trestle.cli","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/cli/#trestle.cli","title":"<code>trestle.cli</code>","text":"<p>Starting point for the Trestle CLI.</p>"},{"location":"reference/API/trestle/cli/#trestle.cli-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/cli/#trestle.cli.logger","title":"<code>logger = logging.getLogger('trestle')</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/cli/#trestle.cli-classes","title":"Classes","text":""},{"location":"reference/API/trestle/cli/#trestle.cli.Trestle","title":"<code>Trestle</code>","text":"<p>               Bases: <code>CommandBase</code></p> <p>Manage OSCAL files in a human friendly manner.</p> Source code in <code>trestle/cli.py</code> <pre><code>class Trestle(CommandBase):\n    \"\"\"Manage OSCAL files in a human friendly manner.\"\"\"\n\n    subcommands = [\n        AssembleCmd,\n        AuthorCmd,\n        CreateCmd,\n        DescribeCmd,\n        HrefCmd,\n        ImportCmd,\n        InitCmd,\n        MergeCmd,\n        PartialObjectValidate,\n        RemoveCmd,\n        ReplicateCmd,\n        SplitCmd,\n        TaskCmd,\n        ValidateCmd,\n        VersionCmd\n    ]\n\n    # This block is uncovered as trestle cannot find plugins in it's unit tests - it is the base module.\n    for plugin, cmd_cls in discovered_plugins('commands'):  # pragma: nocover\n        # add commands (derived from CommandPlusDocs or CommandBase) to subcommands list\n        if issubclass(cmd_cls, CommandBase):\n            # don't add CommandPlusDocs or CommandBase\n            if cmd_cls is not CommandPlusDocs and cmd_cls is not CommandBase:\n                subcommands.append(cmd_cls)\n                logger.info(f'{cmd_cls} added to subcommands from plugin {plugin}')\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument('-v', '--verbose', help=const.DISPLAY_VERBOSE_OUTPUT, action='count', default=0)\n        self.add_argument(\n            '-tr', '--trestle-root', help='Path of trestle root dir', type=pathlib.Path, default=pathlib.Path.cwd()\n        )\n</code></pre>"},{"location":"reference/API/trestle/cli/#trestle.cli.Trestle-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/cli/#trestle.cli.Trestle.subcommands","title":"<code>subcommands = [AssembleCmd, AuthorCmd, CreateCmd, DescribeCmd, HrefCmd, ImportCmd, InitCmd, MergeCmd, PartialObjectValidate, RemoveCmd, ReplicateCmd, SplitCmd, TaskCmd, ValidateCmd, VersionCmd]</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/cli/#trestle.cli-functions","title":"Functions","text":""},{"location":"reference/API/trestle/cli/#trestle.cli.run","title":"<code>run()</code>","text":"<p>Run the trestle cli.</p> Source code in <code>trestle/cli.py</code> <pre><code>def run() -&gt; None:\n    \"\"\"Run the trestle cli.\"\"\"\n    log.set_global_logging_levels()\n    logger.debug('Main entry point.')\n\n    exit(Trestle().run())\n</code></pre>"},{"location":"reference/API/trestle/common/common_types/","title":"trestle.common.common_types","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types","title":"<code>trestle.common.common_types</code>","text":"<p>Special types are defined here.</p>"},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.FixedUuidModel","title":"<code>FixedUuidModel = Resource</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.OBT","title":"<code>OBT = TypeVar('OBT', bound=OscalBaseModel)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.TG","title":"<code>TG = TypeVar('TG')</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.TG2","title":"<code>TG2 = TypeVar('TG2')</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.TopLevelOscalModel","title":"<code>TopLevelOscalModel = TypeVar('TopLevelOscalModel', AssessmentPlan, AssessmentResults, Catalog, comp.ComponentDefinition, PlanOfActionAndMilestones, prof.Profile, ossp.SystemSecurityPlan)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.TypeWithByComps","title":"<code>TypeWithByComps = TypeVar('TypeWithByComps', ossp.ImplementedRequirement, ossp.Statement, comp.ImplementedRequirement, comp.Statement)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.TypeWithParamId","title":"<code>TypeWithParamId = TypeVar('TypeWithParamId', ossp.SetParameter, prof.SetParameter, comp.SetParameter)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.TypeWithParts","title":"<code>TypeWithParts = TypeVar('TypeWithParts', Control, Part, Group, prof.Add, prof.Group)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.TypeWithProps","title":"<code>TypeWithProps = TypeVar('TypeWithProps', Control, Part, AssessmentPart, comp.Statement, ossp.Statement, comp.ImplementedRequirement, ossp.ImplementedRequirement)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types.TypeWithSetParams","title":"<code>TypeWithSetParams = TypeVar('TypeWithSetParams', ossp.ImplementedRequirement, ossp.ByComponent, ossp.ControlImplementation, comp.ImplementedRequirement, comp.ControlImplementation, prof.Modify)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/common_types/#trestle.common.common_types-classes","title":"Classes","text":""},{"location":"reference/API/trestle/common/const/","title":"trestle.common.const","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/const/#trestle.common.const","title":"<code>trestle.common.const</code>","text":"<p>Core constants module containing all constants.</p>"},{"location":"reference/API/trestle/common/const/#trestle.common.const-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ADDED_BY_CONTROL_OWNER","title":"<code>ADDED_BY_CONTROL_OWNER = 'Added by control owner'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.AFTER_HASHES_REGEX","title":"<code>AFTER_HASHES_REGEX = '(?:##*\\\\s+)(.*)'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.AGGREGATES","title":"<code>AGGREGATES = 'aggregates'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ALIAS_PATH_SEPARATOR","title":"<code>ALIAS_PATH_SEPARATOR: str = '.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ALLOWED_EXTENSIONS_IN_DIRS","title":"<code>ALLOWED_EXTENSIONS_IN_DIRS = {'.json', '.xml', '.yaml', '.yml', '.md'}</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ALT_IDENTIFIER","title":"<code>ALT_IDENTIFIER = 'alt-identifier'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_DESC_ELEMENT","title":"<code>ARG_DESC_ELEMENT = 'Path of the element in the OSCAL model'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_DESC_FILE","title":"<code>ARG_DESC_FILE = 'Path of the file'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_DESC_MODE","title":"<code>ARG_DESC_MODE = 'Mode of the operation'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_ELEMENT","title":"<code>ARG_ELEMENT = 'element'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_ELEMENT_SHORT","title":"<code>ARG_ELEMENT_SHORT = 'e'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_FILE","title":"<code>ARG_FILE = 'file'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_FILE_SHORT","title":"<code>ARG_FILE_SHORT = 'f'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_MODE","title":"<code>ARG_MODE = 'mode'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_MODE_SHORT","title":"<code>ARG_MODE_SHORT = 'm'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_VALIDATE","title":"<code>ARG_VALIDATE = 'validate'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ARG_VALIDATE_SHORT","title":"<code>ARG_VALIDATE_SHORT = 'v'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ASSESMENT_OBJECTIVE_PART","title":"<code>ASSESMENT_OBJECTIVE_PART = 'assessment-objective'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.BUG_REPORT","title":"<code>BUG_REPORT = 'https://github.com/oscal-compass/compliance-trestle/issues/new/choose'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.CACHE_ABS_DIR","title":"<code>CACHE_ABS_DIR = '__abs__'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.CLOSE_COMMENT","title":"<code>CLOSE_COMMENT = ' --&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.COMPONENT_VALUES","title":"<code>COMPONENT_VALUES = 'component-values'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.COMP_DEF_RULES_PARAM_VALS_TAG","title":"<code>COMP_DEF_RULES_PARAM_VALS_TAG = TRESTLE_TAG + 'comp-def-rules-param-vals'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.COMP_DEF_RULES_TAG","title":"<code>COMP_DEF_RULES_TAG = TRESTLE_TAG + 'comp-def-rules'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.CONTROL_HEADER","title":"<code>CONTROL_HEADER = '## Control'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.CONTROL_IMPLEMENTATION","title":"<code>CONTROL_IMPLEMENTATION = 'control-implementation'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.CONTROL_OBJECTIVE_HEADER","title":"<code>CONTROL_OBJECTIVE_HEADER = '## Control Objective'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.CONTROL_ORIGINATION","title":"<code>CONTROL_ORIGINATION = 'control-origination'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.CONTROL_REGEX","title":"<code>CONTROL_REGEX = '(?i)(?:##\\\\s+Control\\\\s+)(.*)'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.CONTROL_STATEMENT_HEADER","title":"<code>CONTROL_STATEMENT_HEADER = '## Control Statement'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.DAY_SECONDS","title":"<code>DAY_SECONDS: int = 24 * HOUR_SECONDS</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.DISPLAY_NAME","title":"<code>DISPLAY_NAME = 'display-name'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.DISPLAY_VERBOSE_OUTPUT","title":"<code>DISPLAY_VERBOSE_OUTPUT = 'Display verbose output'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.DRAWIO_FILE_EXT","title":"<code>DRAWIO_FILE_EXT = '.drawio'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.EDITABLE_CONTENT","title":"<code>EDITABLE_CONTENT = 'Editable Content'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ELEMENT_WILDCARD","title":"<code>ELEMENT_WILDCARD = '*'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.FIELDS_SET","title":"<code>FIELDS_SET = '__fields_set__'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.FILE_DIGIT_PREFIX_LENGTH","title":"<code>FILE_DIGIT_PREFIX_LENGTH = 5</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.FILE_ENCODING","title":"<code>FILE_ENCODING = 'utf8'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.FILE_URI","title":"<code>FILE_URI = 'file:///'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.FILTER_BY_COMPONENTS","title":"<code>FILTER_BY_COMPONENTS = 'filter-by-components'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.FILTER_BY_PROFILE","title":"<code>FILTER_BY_PROFILE = 'filter-by-profile'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.FILTER_EXCLUDE_COMPONENTS","title":"<code>FILTER_EXCLUDE_COMPONENTS = 'filter-exclude-components'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.GENERATE_RESOLVED_CATALOG","title":"<code>GENERATE_RESOLVED_CATALOG = 'generate-resolved-catalog'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.GUIDELINES","title":"<code>GUIDELINES = 'guidelines'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HEADER_RULE_ID","title":"<code>HEADER_RULE_ID = 'rule-id'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_ALLOWED_SECTIONS","title":"<code>HELP_ALLOWED_SECTIONS = 'Short names of sections that are allowed to be in the assembled model, comma-separated'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_COMPDEFS","title":"<code>HELP_COMPDEFS = 'Comma-separated list of component-definitions for the ssp.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_FO_OUTPUT","title":"<code>HELP_FO_OUTPUT = 'Overwrites the content of all markdowns in the output folder.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_INCLUDE_ALL_PARTS","title":"<code>HELP_INCLUDE_ALL_PARTS = 'Include all control parts when generating SSP markdown.' + ' By default, only controls and parts with an attached rule will be written out.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_LEVERAGED","title":"<code>HELP_LEVERAGED = 'Name of the SSP to be leveraged.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_MARKDOWN_NAME","title":"<code>HELP_MARKDOWN_NAME = 'Name of the output generated profile markdown folder'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_OVERWRITE_HEADER_VALUES","title":"<code>HELP_OVERWRITE_HEADER_VALUES = 'Flag to overwrite values in a markdown control header.' + ' If a separate yaml header is passed in with -y, any items in the markdown header that are common with the' + ' provided header will be overwritten by the new values.  But new items passed in will always be added to the' + ' markdown header.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_REGENERATE","title":"<code>HELP_REGENERATE = 'Flag to force generation of new uuids in the model'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_REQUIRED_SECTIONS","title":"<code>HELP_REQUIRED_SECTIONS = 'Short names of sections that must be in the assembled model, comma-separated'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_SECTIONS","title":"<code>HELP_SECTIONS = 'Comma-separated list of sections as short_name_no_spaces:long name with spaces'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_SET_PARAMS","title":"<code>HELP_SET_PARAMS = 'set parameters and properties based on the yaml header in control markdown'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_VERSION","title":"<code>HELP_VERSION = 'New version for the assembled model'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HELP_YAML_PATH","title":"<code>HELP_YAML_PATH = 'Path to the optional yaml header file'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HOUR_SECONDS","title":"<code>HOUR_SECONDS: int = 3600</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HREF","title":"<code>HREF = 'href'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.HTTPS_URI","title":"<code>HTTPS_URI = 'https://'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IDX_SEP","title":"<code>IDX_SEP = '__'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IMPLEMENTATION_POINT","title":"<code>IMPLEMENTATION_POINT = 'implementation-point'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IMPLEMENTATION_POINT_EXTERNAL","title":"<code>IMPLEMENTATION_POINT_EXTERNAL = 'external'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IMPLEMENTATION_STATUS","title":"<code>IMPLEMENTATION_STATUS = 'implementation-status'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IMPLEMENTATION_STATUS_HEADER","title":"<code>IMPLEMENTATION_STATUS_HEADER = 'Implementation Status'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IMPLEMENTATION_STATUS_REMARKS_HEADER","title":"<code>IMPLEMENTATION_STATUS_REMARKS_HEADER = 'Implementation Status Remarks'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IMPLEMENTED_REQUIREMENT","title":"<code>IMPLEMENTED_REQUIREMENT = 'implemented-requirement'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INHERITANCE_VIEW_DIR","title":"<code>INHERITANCE_VIEW_DIR = 'inheritance'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INHERITED_UUID","title":"<code>INHERITED_UUID = 'inherited-uuid'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INIT_FULL_HELP","title":"<code>INIT_FULL_HELP = 'Initializes Trestle workspace for local, API and governed documents usage.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INIT_FULL_LONG","title":"<code>INIT_FULL_LONG = '--full'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INIT_FULL_SHORT","title":"<code>INIT_FULL_SHORT = '-fl'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INIT_GOVDOCS_HELP","title":"<code>INIT_GOVDOCS_HELP = 'Initializes Trestle workspace for governed documents usage only.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INIT_GOVDOCS_LONG","title":"<code>INIT_GOVDOCS_LONG = '--govdocs'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INIT_GOVDOCS_SHORT","title":"<code>INIT_GOVDOCS_SHORT = '-gd'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INIT_LOCAL_HELP","title":"<code>INIT_LOCAL_HELP = 'Initializes Trestle workspace for local management of OSCAL models.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INIT_LOCAL_LONG","title":"<code>INIT_LOCAL_LONG = '--local'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.INIT_LOCAL_SHORT","title":"<code>INIT_LOCAL_SHORT = '-loc'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IOF_HELP","title":"<code>IOF_HELP = 'Include fields that are optional in the OSCAL model when generating the new object.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IOF_LONG","title":"<code>IOF_LONG = '--include-optional-fields'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.IOF_SHORT","title":"<code>IOF_SHORT = '-iof'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ITEM","title":"<code>ITEM = 'item'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.LABEL","title":"<code>LABEL = 'label'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.LEVERAGED_SSP","title":"<code>LEVERAGED_SSP = 'leveraged-ssp'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.LEV_AUTH_UUID","title":"<code>LEV_AUTH_UUID = 'leveraged-authorization-uuid'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MARKDOWN_FILE_EXT","title":"<code>MARKDOWN_FILE_EXT = '.md'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MARKDOWN_URL_REGEX","title":"<code>MARKDOWN_URL_REGEX = '\\\\[([^\\\\]]+)\\\\]\\\\(([^)]+)\\\\)'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX","title":"<code>MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX = '[^a-zA-Z0-9-_ \\n]'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_DIR_A_PLAN","title":"<code>MODEL_DIR_A_PLAN = 'assessment-plans'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_DIR_A_RESULT","title":"<code>MODEL_DIR_A_RESULT = 'assessment-results'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_DIR_CATALOG","title":"<code>MODEL_DIR_CATALOG = 'catalogs'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_DIR_COMPDEF","title":"<code>MODEL_DIR_COMPDEF = 'component-definitions'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_DIR_LIST","title":"<code>MODEL_DIR_LIST = [MODEL_DIR_A_PLAN, MODEL_DIR_A_RESULT, MODEL_DIR_CATALOG, MODEL_DIR_COMPDEF, MODEL_DIR_POAM, MODEL_DIR_PROFILE, MODEL_DIR_SSP]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_DIR_POAM","title":"<code>MODEL_DIR_POAM = 'plan-of-action-and-milestones'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_DIR_PROFILE","title":"<code>MODEL_DIR_PROFILE = 'profiles'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_DIR_SSP","title":"<code>MODEL_DIR_SSP = 'system-security-plans'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_DIR_TO_MODEL_MODULE","title":"<code>MODEL_DIR_TO_MODEL_MODULE = {MODEL_DIR_A_PLAN: MODEL_MODULE_A_PLAN, MODEL_DIR_A_RESULT: MODEL_MODULE_A_RESULT, MODEL_DIR_CATALOG: MODEL_MODULE_CATALOG, MODEL_DIR_COMPDEF: MODEL_MODULE_COMPDEF, MODEL_DIR_POAM: MODEL_MODULE_POAM, MODEL_DIR_PROFILE: MODEL_MODULE_PROFILE, MODEL_DIR_SSP: MODEL_MODULE_SSP}</code>  <code>module-attribute</code>","text":"<p>Map of model type to oscal module.</p>"},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_MODULE_A_PLAN","title":"<code>MODEL_MODULE_A_PLAN = f'{PACKAGE_OSCAL}.{MODULE_NAME_A_PLAN}'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_MODULE_A_RESULT","title":"<code>MODEL_MODULE_A_RESULT = f'{PACKAGE_OSCAL}.{MODULE_NAME_A_RESULT}'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_MODULE_CATALOG","title":"<code>MODEL_MODULE_CATALOG = f'{PACKAGE_OSCAL}.{MODULE_NAME_CATALOG}'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_MODULE_COMPDEF","title":"<code>MODEL_MODULE_COMPDEF = f'{PACKAGE_OSCAL}.{MODULE_NAME_COMPDEF}'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_MODULE_LIST","title":"<code>MODEL_MODULE_LIST = [MODEL_MODULE_A_PLAN, MODEL_MODULE_A_RESULT, MODEL_MODULE_CATALOG, MODEL_MODULE_COMPDEF, MODEL_MODULE_POAM, MODEL_MODULE_PROFILE, MODEL_MODULE_SSP]</code>  <code>module-attribute</code>","text":"<p>Map of plural form of a model type to the oscal module that contains the classes related to it.</p>"},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_MODULE_POAM","title":"<code>MODEL_MODULE_POAM = f'{PACKAGE_OSCAL}.{MODULE_NAME_POAM}'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_MODULE_PROFILE","title":"<code>MODEL_MODULE_PROFILE = f'{PACKAGE_OSCAL}.{MODULE_NAME_PROFILE}'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_MODULE_SSP","title":"<code>MODEL_MODULE_SSP = f'{PACKAGE_OSCAL}.{MODULE_NAME_SSP}'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_MODULE_TO_MODEL_TYPE","title":"<code>MODEL_MODULE_TO_MODEL_TYPE = {MODEL_MODULE_A_PLAN: MODEL_TYPE_A_PLAN, MODEL_MODULE_A_RESULT: MODEL_TYPE_A_RESULT, MODEL_MODULE_CATALOG: MODEL_TYPE_CATALOG, MODEL_MODULE_COMPDEF: MODEL_TYPE_COMPDEF, MODEL_MODULE_POAM: MODEL_TYPE_POAM, MODEL_MODULE_PROFILE: MODEL_TYPE_PROFILE, MODEL_MODULE_SSP: MODEL_TYPE_SSP}</code>  <code>module-attribute</code>","text":"<p>Map of model type to model directory.</p>"},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_A_PLAN","title":"<code>MODEL_TYPE_A_PLAN = 'assessment-plan'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_A_RESULT","title":"<code>MODEL_TYPE_A_RESULT = 'assessment-results'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_CATALOG","title":"<code>MODEL_TYPE_CATALOG = 'catalog'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_COMPDEF","title":"<code>MODEL_TYPE_COMPDEF = 'component-definition'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_LIST","title":"<code>MODEL_TYPE_LIST = [MODEL_TYPE_A_PLAN, MODEL_TYPE_A_RESULT, MODEL_TYPE_CATALOG, MODEL_TYPE_COMPDEF, MODEL_TYPE_POAM, MODEL_TYPE_PROFILE, MODEL_TYPE_SSP]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_POAM","title":"<code>MODEL_TYPE_POAM = 'plan-of-action-and-milestones'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_PROFILE","title":"<code>MODEL_TYPE_PROFILE = 'profile'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_SSP","title":"<code>MODEL_TYPE_SSP = 'system-security-plan'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_TO_MODEL_DIR","title":"<code>MODEL_TYPE_TO_MODEL_DIR = {MODEL_TYPE_A_PLAN: MODEL_DIR_A_PLAN, MODEL_TYPE_A_RESULT: MODEL_DIR_A_RESULT, MODEL_TYPE_CATALOG: MODEL_DIR_CATALOG, MODEL_TYPE_COMPDEF: MODEL_DIR_COMPDEF, MODEL_TYPE_POAM: MODEL_DIR_POAM, MODEL_TYPE_PROFILE: MODEL_DIR_PROFILE, MODEL_TYPE_SSP: MODEL_DIR_SSP}</code>  <code>module-attribute</code>","text":"<p>Element path separator</p>"},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODEL_TYPE_TO_MODEL_MODULE","title":"<code>MODEL_TYPE_TO_MODEL_MODULE = {MODEL_TYPE_A_PLAN: MODEL_MODULE_A_PLAN, MODEL_TYPE_A_RESULT: MODEL_MODULE_A_RESULT, MODEL_TYPE_CATALOG: MODEL_MODULE_CATALOG, MODEL_TYPE_COMPDEF: MODEL_MODULE_COMPDEF, MODEL_TYPE_POAM: MODEL_MODULE_POAM, MODEL_TYPE_PROFILE: MODEL_MODULE_PROFILE, MODEL_TYPE_SSP: MODEL_MODULE_SSP}</code>  <code>module-attribute</code>","text":"<p>Map of model module to model type.</p>"},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODULE_NAME_A_PLAN","title":"<code>MODULE_NAME_A_PLAN = 'assessment_plan'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODULE_NAME_A_RESULT","title":"<code>MODULE_NAME_A_RESULT = 'assessment_results'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODULE_NAME_CATALOG","title":"<code>MODULE_NAME_CATALOG = 'catalog'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODULE_NAME_COMPDEF","title":"<code>MODULE_NAME_COMPDEF = 'component'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODULE_NAME_POAM","title":"<code>MODULE_NAME_POAM = 'poam'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODULE_NAME_PROFILE","title":"<code>MODULE_NAME_PROFILE = 'profile'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.MODULE_NAME_SSP","title":"<code>MODULE_NAME_SSP = 'ssp'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.NAME","title":"<code>NAME = 'name'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.NAMESPACE_FEDRAMP","title":"<code>NAMESPACE_FEDRAMP = 'https://fedramp.gov/ns/oscal'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.NAMESPACE_NIST","title":"<code>NAMESPACE_NIST = 'https://csrc.nist.gov/ns/oscal'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.NCNAME_REGEX","title":"<code>NCNAME_REGEX = '^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.NCNAME_UTF8_FIRST_CHAR_OPTIONS","title":"<code>NCNAME_UTF8_FIRST_CHAR_OPTIONS = string.ascii_letters + '_'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.NCNAME_UTF8_OTHER_CHAR_OPTIONS","title":"<code>NCNAME_UTF8_OTHER_CHAR_OPTIONS = string.ascii_letters + string.digits + '_.-'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.OBJECTIVE_PART","title":"<code>OBJECTIVE_PART = 'objective'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ONE","title":"<code>ONE = 'one'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ONE_OR_MORE_HYPHENED","title":"<code>ONE_OR_MORE_HYPHENED = 'one-or-more'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ONE_OR_MORE_SPACED","title":"<code>ONE_OR_MORE_SPACED = 'one or more'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ORIGINATION_CUSTOMER_CONFIGURED","title":"<code>ORIGINATION_CUSTOMER_CONFIGURED = 'customer-configured'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ORIGINATION_CUSTOMER_PROVIDED","title":"<code>ORIGINATION_CUSTOMER_PROVIDED = 'customer-provided'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ORIGINATION_INHERITED","title":"<code>ORIGINATION_INHERITED = 'inherited'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ORIGINATION_ORGANIZATION","title":"<code>ORIGINATION_ORGANIZATION = 'organization'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ORIGINATION_SYSTEM_SPECIFIC","title":"<code>ORIGINATION_SYSTEM_SPECIFIC = 'system-specific'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PACKAGE_OSCAL","title":"<code>PACKAGE_OSCAL = 'trestle.oscal'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PARAMETER_DESCRIPTION","title":"<code>PARAMETER_DESCRIPTION = 'Parameter_Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PARAMETER_ID","title":"<code>PARAMETER_ID = 'Parameter_Id'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PARAMETER_VALUE_ALTERNATIVES","title":"<code>PARAMETER_VALUE_ALTERNATIVES = 'Parameter_Value_Alternatives'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PARAM_VALUES_TAG","title":"<code>PARAM_VALUES_TAG = TRESTLE_TAG + 'param-values'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PARAM_VALUE_ORIGIN","title":"<code>PARAM_VALUE_ORIGIN = 'param-value-origin'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PART_REGEX","title":"<code>PART_REGEX = '(?i)(?:##\\\\s+part\\\\s+)(.*)'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PROFILE","title":"<code>PROFILE = 'profile'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT","title":"<code>PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT = '&lt;!-- Add prose here for required Section'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PROFILE_PARAM_VALUE_ORIGIN","title":"<code>PROFILE_PARAM_VALUE_ORIGIN = 'profile-param-value-origin'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PROFILE_VALUES","title":"<code>PROFILE_VALUES = 'profile-values'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PROPERTY_REGEX","title":"<code>PROPERTY_REGEX = '(?:###\\\\s+Property\\\\s+)([^\\\\s]*)\\\\s*:\\\\s+(.*)'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PROVIDED_STATEMENT_DESCRIPTION","title":"<code>PROVIDED_STATEMENT_DESCRIPTION = 'Provided Statement Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.PROVIDED_UUID","title":"<code>PROVIDED_UUID = 'provided-uuid'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.REMARKS","title":"<code>REMARKS = 'Remarks'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.REPLACE_ME","title":"<code>REPLACE_ME = 'REPLACE_ME'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.REPLACE_ME_PLACEHOLDER","title":"<code>REPLACE_ME_PLACEHOLDER = '&lt;REPLACE_ME&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.RESOLUTION_SOURCE","title":"<code>RESOLUTION_SOURCE = 'resolution-source'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.RESPONSIBILITY_STATEMENT_DESCRIPTION","title":"<code>RESPONSIBILITY_STATEMENT_DESCRIPTION = 'Responsibility Statement Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.RESPONSIBILITY_UUID","title":"<code>RESPONSIBILITY_UUID = 'responsibility-uuid'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.RESPONSIBLE_ROLE","title":"<code>RESPONSIBLE_ROLE = 'responsible-role'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.RESPONSIBLE_ROLES","title":"<code>RESPONSIBLE_ROLES = 'responsible-roles'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.ROOT","title":"<code>ROOT = '__root__'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.RULES_PARAMS_TAG","title":"<code>RULES_PARAMS_TAG = TRESTLE_TAG + 'rules-params'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.RULES_WARNING","title":"<code>RULES_WARNING = '&lt;!-- Note that the list of rules under ### Rules: is read-only and changes will not be captured after assembly to JSON --&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.RULE_DESCRIPTION","title":"<code>RULE_DESCRIPTION = 'Rule_Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.RULE_ID","title":"<code>RULE_ID = 'Rule_Id'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SAMPLE_UUID_STR","title":"<code>SAMPLE_UUID_STR = 'A0000000-0000-4000-8000-000000000000'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SATISFIED_STATEMENT_COMMENT","title":"<code>SATISFIED_STATEMENT_COMMENT = '&lt;!-- Use this section to explain how the inherited responsibility is being satisfied. --&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SATISFIED_STATEMENT_DESCRIPTION","title":"<code>SATISFIED_STATEMENT_DESCRIPTION = 'Satisfied Statement Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SECTIONS_TAG","title":"<code>SECTIONS_TAG = TRESTLE_TAG + 'sections'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SET_PARAMS_TAG","title":"<code>SET_PARAMS_TAG = TRESTLE_TAG + 'set-params'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SFTP_URI","title":"<code>SFTP_URI = 'sftp://'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SORT_ID","title":"<code>SORT_ID = 'sort-id'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT","title":"<code>SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT = SSP_ADD_IMPLEMENTATION_PREFIX + 'control'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT","title":"<code>SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT = SSP_ADD_IMPLEMENTATION_PREFIX + ITEM</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_ADD_IMPLEMENTATION_FOR_STATEMENT_TEXT","title":"<code>SSP_ADD_IMPLEMENTATION_FOR_STATEMENT_TEXT = SSP_ADD_IMPLEMENTATION_PREFIX + STATEMENT + CLOSE_COMMENT</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_ADD_IMPLEMENTATION_PREFIX","title":"<code>SSP_ADD_IMPLEMENTATION_PREFIX = '&lt;!-- Add control implementation description here for '</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT","title":"<code>SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT = f'&lt;!-- Add implementation prose for the main {SSP_MAIN_COMP_NAME} component for control'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_FEDRAMP_TAG","title":"<code>SSP_FEDRAMP_TAG = TRESTLE_TAG + 'fedramp-props'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_MAIN_COMP_NAME","title":"<code>SSP_MAIN_COMP_NAME = 'This System'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_MD_HRULE_LINE","title":"<code>SSP_MD_HRULE_LINE = '______________________________________________________________________'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_MD_IMPLEMENTATION_QUESTION","title":"<code>SSP_MD_IMPLEMENTATION_QUESTION = 'What is the solution and how is it implemented?'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_MD_LEAVE_BLANK_TEXT","title":"<code>SSP_MD_LEAVE_BLANK_TEXT = '&lt;!-- Please leave this section blank and enter implementation details in the parts below. --&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT","title":"<code>SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT = 'This is the control implementation for the system.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.SSP_VALUES","title":"<code>SSP_VALUES = 'ssp-values'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATEMENT","title":"<code>STATEMENT = 'statement'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_ALL","title":"<code>STATUS_ALL = [STATUS_IMPLEMENTED, STATUS_PARTIAL, STATUS_PARTIALLY_IMPLEMENTED, STATUS_PLANNED, STATUS_ALTERNATIVE, STATUS_NOT_APPLICABLE, STATUS_OPERATIONAL, STATUS_UNDER_DEVELOPMENT, STATUS_DISPOSITION, STATUS_OTHER, STATUS_UNDER_MAJOR_MODIFICATION]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_ALTERNATIVE","title":"<code>STATUS_ALTERNATIVE = 'alternative'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_COMPLETION_DATE","title":"<code>STATUS_COMPLETION_DATE = 'completion-date'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_DISPOSITION","title":"<code>STATUS_DISPOSITION = 'disposition'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_IMPLEMENTED","title":"<code>STATUS_IMPLEMENTED = 'implemented'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_INHERITED","title":"<code>STATUS_INHERITED = 'inherited'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_NOT_APPLICABLE","title":"<code>STATUS_NOT_APPLICABLE = 'not-applicable'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_OPERATIONAL","title":"<code>STATUS_OPERATIONAL = 'operational'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_OTHER","title":"<code>STATUS_OTHER = 'other'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_PARTIAL","title":"<code>STATUS_PARTIAL = 'partial'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_PARTIALLY_IMPLEMENTED","title":"<code>STATUS_PARTIALLY_IMPLEMENTED = 'partially-implemented'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_PLANNED","title":"<code>STATUS_PLANNED = 'planned'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_PLANNED_COMPLETION_DATE","title":"<code>STATUS_PLANNED_COMPLETION_DATE = 'planned-completion-date'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_PROMPT","title":"<code>STATUS_PROMPT = f'&lt;!-- For implementation status enter one of: {STATUS_IMPLEMENTED}, {STATUS_PARTIAL}, {STATUS_PLANNED}, {STATUS_ALTERNATIVE}, {STATUS_NOT_APPLICABLE} --&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_REMARKS","title":"<code>STATUS_REMARKS = 'status-remarks'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_UNDER_DEVELOPMENT","title":"<code>STATUS_UNDER_DEVELOPMENT = 'under-development'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.STATUS_UNDER_MAJOR_MODIFICATION","title":"<code>STATUS_UNDER_MAJOR_MODIFICATION = 'under-major-modification'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TABLE_OF_PARAMS_PART","title":"<code>TABLE_OF_PARAMS_PART = 'table_of_parameters'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TEMPLATE_VERSION_REGEX","title":"<code>TEMPLATE_VERSION_REGEX = '[0-9]+.[0-9]+.[0-9]+'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.THIS_SYSTEM_AS_KEY","title":"<code>THIS_SYSTEM_AS_KEY = 'this-system'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.THIS_SYSTEM_PROMPT","title":"<code>THIS_SYSTEM_PROMPT = '### ' + SSP_MAIN_COMP_NAME</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TITLE","title":"<code>TITLE = 'title'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRANSFORM_TYPES","title":"<code>TRANSFORM_TYPES = [FILTER_BY_PROFILE, FILTER_BY_COMPONENTS, FILTER_EXCLUDE_COMPONENTS, GENERATE_RESOLVED_CATALOG]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_ADD_PROPS_TAG","title":"<code>TRESTLE_ADD_PROPS_TAG = TRESTLE_TAG + 'add-props'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_CACHE_DIR","title":"<code>TRESTLE_CACHE_DIR = TRESTLE_CONFIG_DIR + '/cache'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_CONFIG_DIR","title":"<code>TRESTLE_CONFIG_DIR = '.trestle'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_CONFIG_FILE","title":"<code>TRESTLE_CONFIG_FILE = 'config.ini'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_DIST_DIR","title":"<code>TRESTLE_DIST_DIR = 'dist'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_GENERIC_NS","title":"<code>TRESTLE_GENERIC_NS = 'https://oscal-compass.github.io/compliance-trestle/schemas/oscal'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_GLOBAL_TAG","title":"<code>TRESTLE_GLOBAL_TAG = TRESTLE_TAG + 'global'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_HREF_HEADING","title":"<code>TRESTLE_HREF_HEADING = 'trestle://'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_HREF_REGEX","title":"<code>TRESTLE_HREF_REGEX = '^trestle://[^/]'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_IMP_STATUS_TAG","title":"<code>TRESTLE_IMP_STATUS_TAG = 'trestle-imp-status'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_INHERITED_PROPS_TAG","title":"<code>TRESTLE_INHERITED_PROPS_TAG = TRESTLE_TAG + 'inherited-props'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_INHERITED_PROPS_TRACKER","title":"<code>TRESTLE_INHERITED_PROPS_TRACKER = 'trestle_inherited_props_tracker'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_KEEP_FILE","title":"<code>TRESTLE_KEEP_FILE = '.keep'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_LEVERAGING_COMP_TAG","title":"<code>TRESTLE_LEVERAGING_COMP_TAG = TRESTLE_TAG + 'leveraging-comp'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_PROPS_TAG","title":"<code>TRESTLE_PROPS_TAG = TRESTLE_TAG + 'props'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_STATEMENT_TAG","title":"<code>TRESTLE_STATEMENT_TAG = TRESTLE_TAG + 'statement'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.TRESTLE_TAG","title":"<code>TRESTLE_TAG = 'x-trestle-'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.UNIX_CACHE_ROOT","title":"<code>UNIX_CACHE_ROOT = '__root__'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.UUID_REGEX","title":"<code>UUID_REGEX = '(?:^|[0-9A-Za-f])([0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12})(?:$|[^0-9A-Za-z])'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.VALUES","title":"<code>VALUES = 'values'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.VALUE_ASSIGNED_PREFIX","title":"<code>VALUE_ASSIGNED_PREFIX = 'value-assigned-prefix'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.VALUE_NOT_ASSIGNED_PREFIX","title":"<code>VALUE_NOT_ASSIGNED_PREFIX = 'value-not-assigned-prefix'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.VAL_MODE_ALL","title":"<code>VAL_MODE_ALL = 'all'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.VAL_MODE_CATALOG","title":"<code>VAL_MODE_CATALOG = 'catalog'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.VAL_MODE_DUPLICATES","title":"<code>VAL_MODE_DUPLICATES = 'duplicates'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.VAL_MODE_LINKS","title":"<code>VAL_MODE_LINKS = 'links'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.VAL_MODE_REFS","title":"<code>VAL_MODE_REFS = 'refs'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.VAL_MODE_RULES","title":"<code>VAL_MODE_RULES = 'rules'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.WEBSITE_ROOT","title":"<code>WEBSITE_ROOT = 'https://oscal-compass.github.io/compliance-trestle'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.WINDOWS_DRIVE_LETTER_REGEX","title":"<code>WINDOWS_DRIVE_LETTER_REGEX = '[A-Za-z]:'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.WINDOWS_DRIVE_URI_REGEX","title":"<code>WINDOWS_DRIVE_URI_REGEX = '([A-Za-z]:[\\\\\\\\/]?)[^\\\\\\\\/]'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.WINDOWS_PLATFORM_STR","title":"<code>WINDOWS_PLATFORM_STR = 'Windows'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.YAML_LEVERAGED_COMMENT","title":"<code>YAML_LEVERAGED_COMMENT = '  # Add or modify leveraged SSP Statements here.\\n'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.YAML_LEVERAGING_COMP_COMMENT","title":"<code>YAML_LEVERAGING_COMP_COMMENT = '  # Leveraged statements can be optionally associated with components in this system.\\n  # Associate leveraged statements to Components of this system here:\\n'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.YAML_PROFILE_VALUES_COMMENT","title":"<code>YAML_PROFILE_VALUES_COMMENT = '    # This section contains the parameters that are part of this control.\\n  # Each parameter has properties. Only the profile-values and display-name properties are editable.\\n  # The other properties are informational.\\n  #\\n  # The values property for a parameter represents values inherited from the OSCAL catalog.\\n  # To override the catalog settings, use bullets under profile-values as shown below:\\n  #\\n  #   profile-values:\\n  #     - value 1\\n  #     - value 2\\n  #\\n  # If the \"- &lt;REPLACE_ME&gt;\" placeholder appears under profile-values, it is the same as if\\n  # the profile-values property were left empty.\\n  #\\n  # Some parameters may show an aggregates property which lists other parameters. This means\\n  # the parameter value is made up of the values from the other parameters. For parameters\\n  # that aggregate, profile-values is not applicable.\\n  #\\n  # Property param-value-origin is meant for putting the origin from where that parameter comes from.\\n  # In order to be changed in the current profile, profile-param-value-origin property will be displayed with\\n  # the placeholder \"&lt;REPLACE_ME&gt;\" for you to be replaced. If a parameter already has a param-value-origin\\n  # coming from an inherited profile, do no change this value, instead use profile-param-value-origin as follows:\\n  #\\n  #    param-value-origin: DO NOT REPLACE - this is the original value\\n  #    profile-param-value-origin: &lt;REPLACE_ME&gt; - replace the new value required HERE\\n  #\\n'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.YAML_PROPS_COMMENT","title":"<code>YAML_PROPS_COMMENT = '  # Add or modify control properties here\\n  # Properties may be at the control or part level\\n  # Add control level properties like this:\\n  #   - name: ac1_new_prop\\n  #     value: new property value\\n  #\\n  # Add properties to a statement part like this, where \"b.\" is the label of the target statement part\\n  #   - name: ac1_new_prop\\n  #     value: new property value\\n  #     smt-part: b.\\n  #\\n'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT","title":"<code>YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT = '  # You may set new values for rule parameters by adding\\n  #\\n  # component-values:\\n  #   - value 1\\n  #   - value 2\\n  #\\n  # below a section of values:\\n  # The values list refers to the values as set by the components, and the component-values are the new values\\n  # to be placed in SetParameters of the component definition.\\n  #\\n'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.YAML_RULE_PARAM_VALUES_SSP_COMMENT","title":"<code>YAML_RULE_PARAM_VALUES_SSP_COMMENT = '  # You may set new values for rule parameters by adding\\n  #\\n  # ssp-values:\\n  #   - value 1\\n  #   - value 2\\n  #\\n  # below a section of values:\\n  # The values list refers to the values as set by the components, and the ssp-values are the new values\\n  # to be placed in SetParameters of the SSP.\\n  #\\n'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/const/#trestle.common.const.YAML_SSP_VALUES_COMMENT","title":"<code>YAML_SSP_VALUES_COMMENT = '  # You may set values for parameters in the assembled SSP by adding\\n  #\\n  # ssp-values:\\n  #   - value 1\\n  #   - value 2\\n  #\\n  # below a section of values:\\n  # The values list refers to the values in the resolved profile catalog, and the ssp-values represent new values\\n  # to be placed in SetParameters of the SSP.\\n  #\\n'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/err/","title":"trestle.common.err","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/err/#trestle.common.err","title":"<code>trestle.common.err</code>","text":"<p>Trestle core errors module.</p>"},{"location":"reference/API/trestle/common/err/#trestle.common.err-classes","title":"Classes","text":""},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleError","title":"<code>TrestleError</code>","text":"<p>               Bases: <code>RuntimeError</code></p> <p>General framework (non-application) related errors.</p> <p>Attributes:</p> Name Type Description <code>msg</code> <code>str</code> <p>Human readable string describing the exception.</p> Source code in <code>trestle/common/err.py</code> <pre><code>class TrestleError(RuntimeError):\n    \"\"\"\n    General framework (non-application) related errors.\n\n    Attributes:\n        msg (str): Human readable string describing the exception.\n    \"\"\"\n\n    def __init__(self, msg: str):\n        \"\"\"Intialization for TresleError.\n\n        Args:\n            msg (str): The error message\n        \"\"\"\n        RuntimeError.__init__(self)\n        self.msg = msg\n\n    def __str__(self) -&gt; str:\n        \"\"\"Return Trestle error message if asked for a string.\"\"\"\n        return self.msg\n</code></pre>"},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleError-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleError.msg","title":"<code>msg = msg</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleError-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleError.__init__","title":"<code>__init__(msg)</code>","text":"<p>Intialization for TresleError.</p> <p>Parameters:</p> Name Type Description Default <code>msg</code> <code>str</code> <p>The error message</p> required Source code in <code>trestle/common/err.py</code> <pre><code>def __init__(self, msg: str):\n    \"\"\"Intialization for TresleError.\n\n    Args:\n        msg (str): The error message\n    \"\"\"\n    RuntimeError.__init__(self)\n    self.msg = msg\n</code></pre>"},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleError.__str__","title":"<code>__str__()</code>","text":"<p>Return Trestle error message if asked for a string.</p> Source code in <code>trestle/common/err.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Return Trestle error message if asked for a string.\"\"\"\n    return self.msg\n</code></pre>"},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleIncorrectArgsError","title":"<code>TrestleIncorrectArgsError</code>","text":"<p>               Bases: <code>TrestleError</code></p> <p>General error for incorrect args passed to Trestle command.</p> Source code in <code>trestle/common/err.py</code> <pre><code>class TrestleIncorrectArgsError(TrestleError):\n    \"\"\"General error for incorrect args passed to Trestle command.\"\"\"\n\n    def __init__(self, msg: str):\n        \"\"\"\n        Initialize TrestleIncorrectArgsError.\n\n        Args:\n            msg (str): The error message\n        \"\"\"\n        super().__init__(msg)\n</code></pre>"},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleIncorrectArgsError-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleIncorrectArgsError.__init__","title":"<code>__init__(msg)</code>","text":"<p>Initialize TrestleIncorrectArgsError.</p> <p>Parameters:</p> Name Type Description Default <code>msg</code> <code>str</code> <p>The error message</p> required Source code in <code>trestle/common/err.py</code> <pre><code>def __init__(self, msg: str):\n    \"\"\"\n    Initialize TrestleIncorrectArgsError.\n\n    Args:\n        msg (str): The error message\n    \"\"\"\n    super().__init__(msg)\n</code></pre>"},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleNotFoundError","title":"<code>TrestleNotFoundError</code>","text":"<p>               Bases: <code>TrestleError</code></p> <p>General framework related not found error.</p> <p>Attributes:</p> Name Type Description <code>msg</code> <code>str</code> <p>Human readable string describing the exception.</p> Source code in <code>trestle/common/err.py</code> <pre><code>class TrestleNotFoundError(TrestleError):\n    \"\"\"\n    General framework related not found error.\n\n    Attributes:\n        msg (str): Human readable string describing the exception.\n    \"\"\"\n\n    def __init__(self, msg: str):\n        \"\"\"\n        Intialize TresleNotFoundError.\n\n        Args:\n            msg: The error message\n        \"\"\"\n        super().__init__(msg)\n</code></pre>"},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleNotFoundError-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleNotFoundError.__init__","title":"<code>__init__(msg)</code>","text":"<p>Intialize TresleNotFoundError.</p> <p>Parameters:</p> Name Type Description Default <code>msg</code> <code>str</code> <p>The error message</p> required Source code in <code>trestle/common/err.py</code> <pre><code>def __init__(self, msg: str):\n    \"\"\"\n    Intialize TresleNotFoundError.\n\n    Args:\n        msg: The error message\n    \"\"\"\n    super().__init__(msg)\n</code></pre>"},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleRootError","title":"<code>TrestleRootError</code>","text":"<p>               Bases: <code>TrestleError</code></p> <p>General error for trestle workspace root/setup errors.</p> Source code in <code>trestle/common/err.py</code> <pre><code>class TrestleRootError(TrestleError):\n    \"\"\"General error for trestle workspace root/setup errors.\"\"\"\n\n    def __init__(self, msg: str):\n        \"\"\"\n        Initialize TrestleRootError.\n\n        Args:\n            msg (str): The error message\n        \"\"\"\n        super().__init__(msg)\n</code></pre>"},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleRootError-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/err/#trestle.common.err.TrestleRootError.__init__","title":"<code>__init__(msg)</code>","text":"<p>Initialize TrestleRootError.</p> <p>Parameters:</p> Name Type Description Default <code>msg</code> <code>str</code> <p>The error message</p> required Source code in <code>trestle/common/err.py</code> <pre><code>def __init__(self, msg: str):\n    \"\"\"\n    Initialize TrestleRootError.\n\n    Args:\n        msg (str): The error message\n    \"\"\"\n    super().__init__(msg)\n</code></pre>"},{"location":"reference/API/trestle/common/err/#trestle.common.err-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/err/#trestle.common.err.handle_generic_command_exception","title":"<code>handle_generic_command_exception(exception, logger, msg='Exception occured during execution')</code>","text":"<p>Print out error message based on the verbosity and return appropriate status code.</p> Source code in <code>trestle/common/err.py</code> <pre><code>def handle_generic_command_exception(\n    exception: Exception, logger: Logger, msg: str = 'Exception occured during execution'\n) -&gt; int:\n    \"\"\"Print out error message based on the verbosity and return appropriate status code.\"\"\"\n    if get_current_verbosity_level(logger) == 0:\n        logger.error(msg + f': {exception}')\n    else:\n        logger.exception(msg + f': {exception}')\n\n    return _exception_to_error_code(exception)\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/","title":"trestle.common.file_utils","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils","title":"<code>trestle.common.file_utils</code>","text":"<p>Trestle file system utils.</p>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils-classes","title":"Classes","text":""},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.check_oscal_directories","title":"<code>check_oscal_directories(root_path)</code>","text":"<p>Identify the state of the trestle workspace.</p> <p>Traverses trestle workspace and looks for unexpected files or directories. Additional files are allowed in the Trestle root but not inside the model folders.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def check_oscal_directories(root_path: pathlib.Path) -&gt; bool:\n    \"\"\"\n    Identify the state of the trestle workspace.\n\n    Traverses trestle workspace and looks for unexpected files or directories.\n    Additional files are allowed in the Trestle root but not inside the model folders.\n    \"\"\"\n    trestle_dir_walk = os.walk(root_path)\n    is_valid = True\n\n    for _, dirs, _ in trestle_dir_walk:\n        for d in dirs:\n            if d in MODEL_DIR_LIST:\n                is_valid = _verify_oscal_folder(root_path / d)\n                if not is_valid:\n                    break\n    return is_valid\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.extract_project_model_path","title":"<code>extract_project_model_path(path)</code>","text":"<p>Get the base path of the trestle model project.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def extract_project_model_path(path: pathlib.Path) -&gt; Optional[pathlib.Path]:\n    \"\"\"Get the base path of the trestle model project.\"\"\"\n    if len(path.parts) &gt; 2:\n        for i in range(2, len(path.parts)):\n            current = pathlib.Path(path.parts[0]).joinpath(*path.parts[1:i + 1])\n            if _is_valid_project_model_path(current):\n                return current\n    return None\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.extract_trestle_project_root","title":"<code>extract_trestle_project_root(path)</code>","text":"<p>Get the trestle workspace root folder in the path.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def extract_trestle_project_root(path: pathlib.Path) -&gt; Optional[pathlib.Path]:\n    \"\"\"Get the trestle workspace root folder in the path.\"\"\"\n    while len(path.parts) &gt; 1:  # it must not be the system root directory\n        if is_valid_project_root(path):\n            return path\n        path = path.parent\n    return None\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.get_contextual_file_type","title":"<code>get_contextual_file_type(path)</code>","text":"<p>Return the file content type for files in the given directory, if it's a trestle workspace.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def get_contextual_file_type(path: pathlib.Path) -&gt; FileContentType:\n    \"\"\"Return the file content type for files in the given directory, if it's a trestle workspace.\"\"\"\n    if not _is_valid_project_model_path(path):\n        raise err.TrestleError(f'Trestle workspace not found at path {path}')\n\n    for file_or_directory in iterdir_without_hidden_files(path):\n        if file_or_directory.is_file():\n            return FileContentType.to_content_type(file_or_directory.suffix)\n\n    for file_or_directory in path.iterdir():\n        if file_or_directory.is_dir():\n            return get_contextual_file_type(file_or_directory)\n\n    raise err.TrestleError('No files found in the project.')\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.insert_text_in_file","title":"<code>insert_text_in_file(file_path, tag, text)</code>","text":"<p>Insert text lines after line containing tag.</p> <p>Return True on success, False tag not found. Text is a string with appropriate \\n line endings. If tag is none just add at end of file. This will only open file once if tag is not found.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def insert_text_in_file(file_path: pathlib.Path, tag: Optional[str], text: str) -&gt; bool:\n    r\"\"\"Insert text lines after line containing tag.\n\n    Return True on success, False tag not found.\n    Text is a string with appropriate \\n line endings.\n    If tag is none just add at end of file.\n    This will only open file once if tag is not found.\n    \"\"\"\n    if not file_path.exists():\n        raise TrestleError(f'Test file {file_path} not found.')\n    if tag:\n        lines: List[str] = []\n        with file_path.open('r', encoding=const.FILE_ENCODING) as f:\n            lines = f.readlines()\n        for ii, line in enumerate(lines):\n            if line.find(tag) &gt;= 0:\n                lines.insert(ii + 1, text)\n                with file_path.open('w', encoding=const.FILE_ENCODING) as f:\n                    f.writelines(lines)\n                return True\n    else:\n        with file_path.open('a', encoding=const.FILE_ENCODING) as f:\n            f.writelines(text)\n        return True\n    return False\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.is_directory_name_allowed","title":"<code>is_directory_name_allowed(name)</code>","text":"<p>Determine whether a directory name, which is a 'non-core-OSCAL activity/directory is allowed.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>the name which is assumed may take the form of a relative path for task/subtasks.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>Whether the name is allowed or not allowed (interferes with assumed project directories such as catalogs).</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def is_directory_name_allowed(name: str) -&gt; bool:\n    \"\"\"Determine whether a directory name, which is a 'non-core-OSCAL activity/directory is allowed.\n\n    args:\n        name: the name which is assumed may take the form of a relative path for task/subtasks.\n\n    Returns:\n        Whether the name is allowed or not allowed (interferes with assumed project directories such as catalogs).\n    \"\"\"\n    # Task must not use an OSCAL directory\n    # Task must not self-interfere with a project\n    pathed_name = pathlib.Path(name)\n\n    root_path = pathed_name.parts[0]\n    if root_path in const.MODEL_TYPE_TO_MODEL_DIR.values():\n        logger.warning('Task name is the same as an OSCAL schema name.')\n        return False\n    if root_path[0] == '.':\n        logger.warning('Task name must not start with \".\"')\n        return False\n    if pathed_name.suffix != '':\n        # Does it look like a file\n        logger.warning('Task name must not look like a file path (e.g. contain a suffix')\n        return False\n    if '__global__' in pathed_name.parts:\n        logger.warning('Task name cannot contain __global__')\n        return False\n    return True\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.is_hidden","title":"<code>is_hidden(file_path)</code>","text":"<p>Determine whether a file is hidden based on the appropriate os attributes.</p> <p>This function will only work for the current file path only (e.g. not if a parent is hidden).</p> <p>Parameters:</p> Name Type Description Default <code>file_path</code> <code>Path</code> <p>The file path for which we are testing whether the file / directory is hidden.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>Whether or not the file is file/directory is hidden.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def is_hidden(file_path: pathlib.Path) -&gt; bool:\n    \"\"\"\n    Determine whether a file is hidden based on the appropriate os attributes.\n\n    This function will only work for the current file path only (e.g. not if a parent is hidden).\n\n    Args:\n        file_path: The file path for which we are testing whether the file / directory is hidden.\n\n    Returns:\n        Whether or not the file is file/directory is hidden.\n    \"\"\"\n    # as far as trestle is concerned all .* files are hidden even on windows, regardless of attributes\n    if file_path.stem.startswith('.'):\n        return True\n    # Handle windows\n    if is_windows():  # pragma: no cover\n        attribute = win32api.GetFileAttributes(str(file_path))\n        return attribute &amp; (win32con.FILE_ATTRIBUTE_HIDDEN | win32con.FILE_ATTRIBUTE_SYSTEM)\n    return False\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.is_local_and_visible","title":"<code>is_local_and_visible(file_path)</code>","text":"<p>Is the file or dir local (not a symlink) and not hidden.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def is_local_and_visible(file_path: pathlib.Path) -&gt; bool:\n    \"\"\"Is the file or dir local (not a symlink) and not hidden.\"\"\"\n    return not (is_hidden(file_path) or is_symlink(file_path))\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.is_symlink","title":"<code>is_symlink(file_path)</code>","text":"<p>Is the file path a symlink.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def is_symlink(file_path: pathlib.Path) -&gt; bool:\n    \"\"\"Is the file path a symlink.\"\"\"\n    if is_windows():\n        return file_path.suffix == '.lnk'\n    return file_path.is_symlink()\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.is_valid_project_root","title":"<code>is_valid_project_root(path)</code>","text":"<p>Check if the path is a valid trestle workspace root.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def is_valid_project_root(path: pathlib.Path) -&gt; bool:\n    \"\"\"Check if the path is a valid trestle workspace root.\"\"\"\n    trestle_dir = path / const.TRESTLE_CONFIG_DIR\n    return trestle_dir.exists() and trestle_dir.is_dir()\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.is_windows","title":"<code>is_windows()</code>","text":"<p>Check if current operating system is Windows.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def is_windows() -&gt; bool:\n    \"\"\"Check if current operating system is Windows.\"\"\"\n    return platform.system() == const.WINDOWS_PLATFORM_STR\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.iterdir_without_hidden_files","title":"<code>iterdir_without_hidden_files(directory_path)</code>","text":"<p>Get iterator over all paths in the given directory_path excluding hidden files.</p> <p>Parameters:</p> Name Type Description Default <code>directory_path</code> <code>Path</code> <p>The directory to iterate through.</p> required <p>Returns:</p> Type Description <code>Iterable[Path]</code> <p>Iterator over the files in the directory excluding hidden files.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def iterdir_without_hidden_files(directory_path: pathlib.Path) -&gt; Iterable[pathlib.Path]:\n    \"\"\"\n    Get iterator over all paths in the given directory_path excluding hidden files.\n\n    Args:\n        directory_path: The directory to iterate through.\n\n    Returns:\n        Iterator over the files in the directory excluding hidden files.\n    \"\"\"\n    filtered_paths = list(filter(lambda p: not is_hidden(p) or p.is_dir(), pathlib.Path.iterdir(directory_path)))\n\n    return filtered_paths.__iter__()\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.load_file","title":"<code>load_file(file_path)</code>","text":"<p>Load JSON or YAML file content into a dict.</p> <p>This is not intended to be the default load mechanism. It should only be used if a OSCAL object type is unknown but the context a user is in.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def load_file(file_path: pathlib.Path) -&gt; Dict[str, Any]:\n    \"\"\"\n    Load JSON or YAML file content into a dict.\n\n    This is not intended to be the default load mechanism. It should only be used\n    if a OSCAL object type is unknown but the context a user is in.\n    \"\"\"\n    content_type = FileContentType.to_content_type(file_path.suffix)\n    with file_path.open('r', encoding=const.FILE_ENCODING) as f:\n        if content_type == FileContentType.YAML:\n            yaml = YAML(typ='safe')\n            return yaml.load(f)\n        if content_type == FileContentType.JSON:\n            return json.load(f)\n    return {}\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.make_hidden_file","title":"<code>make_hidden_file(file_path)</code>","text":"<p>Make hidden file.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def make_hidden_file(file_path: pathlib.Path) -&gt; None:\n    \"\"\"Make hidden file.\"\"\"\n    if not file_path.name.startswith('.') and not is_windows():\n        file_path = file_path.parent / ('.' + file_path.name)\n\n    file_path.touch()\n    if is_windows():\n        atts = win32api.GetFileAttributes(str(file_path))\n        win32api.SetFileAttributes(str(file_path), win32con.FILE_ATTRIBUTE_HIDDEN | atts)\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.prune_empty_dirs","title":"<code>prune_empty_dirs(file_path, pattern)</code>","text":"<p>Remove directories with no subdirs and with no files matching pattern.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def prune_empty_dirs(file_path: pathlib.Path, pattern: str) -&gt; None:\n    \"\"\"Remove directories with no subdirs and with no files matching pattern.\"\"\"\n    deleted: Set[str] = set()\n    # this traverses from leaf nodes upward so only needs one traversal\n    for current_dir, subdirs, _ in os.walk(str(file_path), topdown=False):\n        true_dirs = [subdir for subdir in subdirs if os.path.join(current_dir, subdir) not in deleted]\n        if not true_dirs and not any(glob.glob(f'{current_dir}/{pattern}')):\n            shutil.rmtree(current_dir)\n            deleted.add(current_dir)\n</code></pre>"},{"location":"reference/API/trestle/common/file_utils/#trestle.common.file_utils.relative_resolve","title":"<code>relative_resolve(candidate, cwd)</code>","text":"<p>Resolve a candidate file path relative to a provided cwd.</p> <p>This is to circumvent bad behaviour for resolve on windows platforms where the path must exist.</p> <p>If a relative dir is passed it presumes the directory is relative to the PROVIDED cwd. If relative expansions exist (e.g. ../) the final result must still be within the cwd.</p> <p>If an absolute path is provided it tests whether the path is within the cwd or not.</p> Source code in <code>trestle/common/file_utils.py</code> <pre><code>def relative_resolve(candidate: pathlib.Path, cwd: pathlib.Path) -&gt; pathlib.Path:\n    \"\"\"Resolve a candidate file path relative to a provided cwd.\n\n    This is to circumvent bad behaviour for resolve on windows platforms where the path must exist.\n\n    If a relative dir is passed it presumes the directory is relative to the PROVIDED cwd.\n    If relative expansions exist (e.g. ../) the final result must still be within the cwd.\n\n    If an absolute path is provided it tests whether the path is within the cwd or not.\n\n    \"\"\"\n    # Expand user first if applicable.\n    candidate = candidate.expanduser()\n\n    if not cwd.is_absolute():\n        raise TrestleError('Error handling current working directory. CWD is expected to be absolute.')\n\n    if not candidate.is_absolute():\n        new = pathlib.Path(cwd / candidate).resolve()\n    else:\n        new = candidate.resolve()\n    try:\n        new.relative_to(cwd)\n    except ValueError:\n        raise TrestleError(f'Provided dir {candidate} is not relative to {cwd}')\n    return new\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/","title":"trestle.common.list_utils","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils","title":"<code>trestle.common.list_utils</code>","text":"<p>Trestle List Utils.</p>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils-classes","title":"Classes","text":""},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.as_dict","title":"<code>as_dict(dict_or_none)</code>","text":"<p>Convert dict or None object to itself or an empty dict if none.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def as_dict(dict_or_none: Optional[Dict[TG, TG2]]) -&gt; Dict[TG, TG2]:\n    \"\"\"Convert dict or None object to itself or an empty dict if none.\"\"\"\n    return dict_or_none if dict_or_none else {}\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.as_filtered_list","title":"<code>as_filtered_list(list_or_none, filter_condition)</code>","text":"<p>Convert to list and filter based on the condition.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def as_filtered_list(list_or_none: Optional[List[TG]], filter_condition: Callable[[TG], bool]) -&gt; List[TG]:\n    \"\"\"Convert to list and filter based on the condition.\"\"\"\n    result_list = as_list(list_or_none)\n    result_list = list(filter(filter_condition, result_list))\n    return result_list\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.as_list","title":"<code>as_list(list_or_none)</code>","text":"<p>Convert list or None object to itself or an empty list if none.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def as_list(list_or_none: Optional[List[TG]]) -&gt; List[TG]:\n    \"\"\"Convert list or None object to itself or an empty list if none.\"\"\"\n    return list_or_none if list_or_none else []\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.comma_colon_sep_to_dict","title":"<code>comma_colon_sep_to_dict(string_or_none)</code>","text":"<p>Convert optional comma and colon-sep list to dict.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def comma_colon_sep_to_dict(string_or_none: Optional[str]) -&gt; Dict[str, str]:\n    \"\"\"Convert optional comma and colon-sep list to dict.\"\"\"\n    entries = comma_sep_to_list(string_or_none)\n    dic = {}\n    for entry in entries:\n        # if more than one colon include any colons in the value after the first one\n        token = entry.split(':', 1)\n        if len(token) == 1:\n            dic[token[0].strip()] = token[0].strip()\n        else:\n            dic[token[0].strip()] = token[1].strip()\n    return dic\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.comma_sep_to_list","title":"<code>comma_sep_to_list(string_or_none)</code>","text":"<p>Convert optional comma-sep string to list of strings and strip.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def comma_sep_to_list(string_or_none: Optional[str]) -&gt; List[str]:\n    \"\"\"Convert optional comma-sep string to list of strings and strip.\"\"\"\n    string_or_none = string_or_none.strip() if string_or_none else None\n    return list(map(str.strip, string_or_none.split(','))) if string_or_none else []\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.deep_append","title":"<code>deep_append(dic, path, value)</code>","text":"<p>Append to list in dict.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def deep_append(dic: Dict[str, Any], path: List[str], value: Any) -&gt; None:\n    \"\"\"Append to list in dict.\"\"\"\n    if not path:\n        raise TrestleError('Error appending value in deep append with empty path.')\n    for node in path[:-1]:\n        dic[node] = dic.get(node, {})\n        dic = dic[node]\n    if path[-1] not in dic:\n        dic[path[-1]] = []\n    dic[path[-1]].append(value)\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.deep_get","title":"<code>deep_get(dic, path, default=None)</code>","text":"<p>Get value from deep in dictionary.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def deep_get(dic: Dict[str, Any], path: List[str], default: Any = None) -&gt; Any:\n    \"\"\"Get value from deep in dictionary.\"\"\"\n    if not path:\n        raise TrestleError('Error getting value in deep get with empty path.')\n    for node in path[:-1]:\n        if node not in dic:\n            return default\n        dic = dic[node]\n    return dic.get(path[-1], default)\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.deep_set","title":"<code>deep_set(dic, path, value, pop_if_none=True)</code>","text":"<p>Set value deep in dictionary.</p> <p>pop_if_none will cause the key to be removed if value is None</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def deep_set(dic: Dict[str, Any], path: List[str], value: Any, pop_if_none: bool = True) -&gt; None:\n    \"\"\"\n    Set value deep in dictionary.\n\n    pop_if_none will cause the key to be removed if value is None\n    \"\"\"\n    if not path:\n        raise TrestleError('Error setting value in deep set with empty path.')\n    for node in path[:-1]:\n        dic[node] = dic.get(node, {})\n        dic = dic[node]\n    if value or not pop_if_none:\n        dic[path[-1]] = value\n    else:\n        dic.pop(path[-1], None)\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.deep_update","title":"<code>deep_update(dic, path, dic_value)</code>","text":"<p>Update the dict based on path.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def deep_update(dic: Dict[str, Any], path: List[str], dic_value: Dict[str, Any]) -&gt; None:\n    \"\"\"Update the dict based on path.\"\"\"\n    if not path:\n        raise TrestleError('Error updating value in deep update with empty path.')\n    for node in path:\n        dic[node] = dic.get(node, {})\n        dic = dic[node]\n    dic.update(dic_value)\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.delete_item_from_list","title":"<code>delete_item_from_list(item_list, value, key)</code>","text":"<p>Remove the first matching item if it is present in a list based on the callable key matching the query value.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def delete_item_from_list(item_list: List[TG], value: TG2, key: Callable[[TG], TG2]) -&gt; List[TG]:\n    \"\"\"Remove the first matching item if it is present in a list based on the callable key matching the query value.\"\"\"\n    keys = [key(item) for item in item_list]\n    if value in keys:\n        index = keys.index(value)\n        del item_list[index]\n    return item_list\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.delete_list_from_list","title":"<code>delete_list_from_list(item_list, indices)</code>","text":"<p>Delete a list of items from a list based on indices.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def delete_list_from_list(item_list: List[TG], indices: List[int]) -&gt; None:\n    \"\"\"Delete a list of items from a list based on indices.\"\"\"\n    for index in sorted(indices, reverse=True):\n        del item_list[index]\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.get_default","title":"<code>get_default(item, default)</code>","text":"<p>Return the default value for the item if it is not set.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def get_default(item: TG, default: TG) -&gt; TG:\n    \"\"\"Return the default value for the item if it is not set.\"\"\"\n    return item if item else default\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.get_item_from_list","title":"<code>get_item_from_list(item_list, value, key, remove=False)</code>","text":"<p>Get first item from list if present based on key matching value with option to remove it from the list.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def get_item_from_list(item_list: Optional[List[TG]],\n                       value: TG2,\n                       key: Callable[[TG], TG2],\n                       remove: bool = False) -&gt; Optional[TG]:\n    \"\"\"Get first item from list if present based on key matching value with option to remove it from the list.\"\"\"\n    if not item_list:\n        return None\n    keys = [key(item) for item in item_list]\n    item = None\n    if value in keys:\n        index = keys.index(value)\n        item = item_list[index]\n        if remove:\n            del item_list[index]\n    return item\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.is_ordered_sublist","title":"<code>is_ordered_sublist(needle, haystack)</code>","text":"<p>Determine if needle is exactly contained in haystack.</p> <p>The needle list comprises an ordered list of strings. The haystack list comprises an ordered list of strings that is to be searched. If the strings in the needle appear in the haystack in that exact order then return true, else false.</p> <p>Examples: needle=['a','b','c'], haystack=['x','y','a','b','c','z'], result = True needle=['a','b','c'], haystack=['x','y','a','b','z','c'], result = False</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def is_ordered_sublist(needle: List[str], haystack: List[str]) -&gt; bool:\n    \"\"\"Determine if needle is exactly contained in haystack.\n\n    The needle list comprises an ordered list of strings.\n    The haystack list comprises an ordered list of strings that is to be searched.\n    If the strings in the needle appear in the haystack in that exact order then\n    return true, else false.\n\n    Examples:\n    needle=['a','b','c'], haystack=['x','y','a','b','c','z'], result = True\n    needle=['a','b','c'], haystack=['x','y','a','b','z','c'], result = False\n    \"\"\"\n    return ' '.join(needle) in ' '.join(haystack)\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.join_key_to_list_dicts","title":"<code>join_key_to_list_dicts(dict1, dict2)</code>","text":"<p>Join two dicts of str to List.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def join_key_to_list_dicts(dict1: Dict[str, List[Any]], dict2: Dict[str, List[Any]]) -&gt; Dict[str, List[Any]]:\n    \"\"\"Join two dicts of str to List.\"\"\"\n    # merge like keys\n    dict3 = {key: dict1[key] + dict2.get(key, []) for key in dict1}\n    # merge unlike keys\n    dict3.update({key: dict2[key] for key in dict2 if key not in dict3})\n    return dict3\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.merge_dicts","title":"<code>merge_dicts(dest, src)</code>","text":"<p>Merge the two dicts with priority to src.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def merge_dicts(dest: Optional[Dict[str, str]], src: Optional[Dict[str, str]]) -&gt; Dict[str, str]:\n    \"\"\"Merge the two dicts with priority to src.\"\"\"\n    return {**as_dict(dest), **as_dict(src)}\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.none_if_empty","title":"<code>none_if_empty(list_)</code>","text":"<p>Convert to None if empty list.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def none_if_empty(list_: List[TG]) -&gt; Optional[List[TG]]:\n    \"\"\"Convert to None if empty list.\"\"\"\n    return list_ if list_ else None\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.pop_item_from_list","title":"<code>pop_item_from_list(item_list, value, key)</code>","text":"<p>Pop first matching item from a list if it is present based on the key matching the value.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def pop_item_from_list(item_list: Optional[List[TG]], value: TG2, key: Callable[[TG], TG2]) -&gt; Optional[TG]:\n    \"\"\"Pop first matching item from a list if it is present based on the key matching the value.\"\"\"\n    return get_item_from_list(item_list, value, key, True)\n</code></pre>"},{"location":"reference/API/trestle/common/list_utils/#trestle.common.list_utils.set_or_pop","title":"<code>set_or_pop(dic, key, value)</code>","text":"<p>Set if value is non-empty list or not None otherwise remove.</p> Source code in <code>trestle/common/list_utils.py</code> <pre><code>def set_or_pop(dic: Dict[str, Any], key: str, value: Any) -&gt; None:\n    \"\"\"Set if value is non-empty list or not None otherwise remove.\"\"\"\n    if value:\n        dic[key] = value\n    else:\n        dic.pop(key, None)\n</code></pre>"},{"location":"reference/API/trestle/common/load_validate/","title":"trestle.common.load_validate","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/load_validate/#trestle.common.load_validate","title":"<code>trestle.common.load_validate</code>","text":"<p>Function to load and validate files while avoiding circular imports.</p>"},{"location":"reference/API/trestle/common/load_validate/#trestle.common.load_validate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/load_validate/#trestle.common.load_validate.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/load_validate/#trestle.common.load_validate-classes","title":"Classes","text":""},{"location":"reference/API/trestle/common/load_validate/#trestle.common.load_validate-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/load_validate/#trestle.common.load_validate.load_validate_model_name","title":"<code>load_validate_model_name(trestle_root, model_name, model_class, file_content_type=None)</code>","text":"<p>Load a model by its name and type and validate it.</p> Source code in <code>trestle/common/load_validate.py</code> <pre><code>def load_validate_model_name(\n    trestle_root: Path,\n    model_name: str,\n    model_class: TG,\n    file_content_type: Optional[FileContentType] = None\n) -&gt; Tuple[TG, Path]:\n    \"\"\"Load a model by its name and type and validate it.\"\"\"\n    model_path = ModelUtils.get_model_path_for_name_and_class(trestle_root, model_name, model_class, file_content_type)\n    model = load_validate_model_path(trestle_root, model_path)\n    return model, model_path\n</code></pre>"},{"location":"reference/API/trestle/common/load_validate/#trestle.common.load_validate.load_validate_model_path","title":"<code>load_validate_model_path(trestle_root, model_path)</code>","text":"<p>Load a model by its path and validate it.</p> Source code in <code>trestle/common/load_validate.py</code> <pre><code>def load_validate_model_path(trestle_root: Path, model_path: Path) -&gt; TopLevelOscalModel:\n    \"\"\"Load a model by its path and validate it.\"\"\"\n    _, _, model = ModelUtils.load_distributed(model_path, trestle_root)\n    args = argparse.Namespace(mode=const.VAL_MODE_ALL, quiet=True)\n    validator: Validator = validator_factory.get(args)\n    if not validator.model_is_valid(model, True, trestle_root):\n        logger.warning(f'Model loaded at {model_path} fails validation, but is being loaded anyway.')\n    return model\n</code></pre>"},{"location":"reference/API/trestle/common/log/","title":"trestle.common.log","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/log/#trestle.common.log","title":"<code>trestle.common.log</code>","text":"<p>Common logging utilities.</p>"},{"location":"reference/API/trestle/common/log/#trestle.common.log-classes","title":"Classes","text":""},{"location":"reference/API/trestle/common/log/#trestle.common.log.SpecificLevelFilter","title":"<code>SpecificLevelFilter</code>","text":"<p>               Bases: <code>Filter</code></p> <p>Filter for the same level as provided by setLevel for a log handler.</p> <p>Python by default logs all levels above to a given destination. This makes it easy to split levels where you might log all levels to file and only errors to std.err, however, does not allow logging a specific level elsewhere.</p> Source code in <code>trestle/common/log.py</code> <pre><code>class SpecificLevelFilter(logging.Filter):\n    \"\"\"\n    Filter for the same level as provided by setLevel for a log handler.\n\n    Python by default logs all levels above to a given destination. This makes it easy to split levels where you might\n    log all levels to file and only errors to std.err, however, does not allow logging a specific level elsewhere.\n    \"\"\"\n\n    def __init__(self, level: int) -&gt; None:\n        \"\"\"Initialize providing maximum level to be pushed through the filter.\"\"\"\n        self._level = level\n\n    def filter(self, log_record: logging.LogRecord) -&gt; bool:  # noqa: A003\n        \"\"\"Filter log messages.\"\"\"\n        return log_record.levelno == self._level\n</code></pre>"},{"location":"reference/API/trestle/common/log/#trestle.common.log.SpecificLevelFilter-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/log/#trestle.common.log.SpecificLevelFilter.__init__","title":"<code>__init__(level)</code>","text":"<p>Initialize providing maximum level to be pushed through the filter.</p> Source code in <code>trestle/common/log.py</code> <pre><code>def __init__(self, level: int) -&gt; None:\n    \"\"\"Initialize providing maximum level to be pushed through the filter.\"\"\"\n    self._level = level\n</code></pre>"},{"location":"reference/API/trestle/common/log/#trestle.common.log.SpecificLevelFilter.filter","title":"<code>filter(log_record)</code>","text":"<p>Filter log messages.</p> Source code in <code>trestle/common/log.py</code> <pre><code>def filter(self, log_record: logging.LogRecord) -&gt; bool:  # noqa: A003\n    \"\"\"Filter log messages.\"\"\"\n    return log_record.levelno == self._level\n</code></pre>"},{"location":"reference/API/trestle/common/log/#trestle.common.log.Trace","title":"<code>Trace</code>","text":"<p>Class allowing low priority trace message when verbose &gt; 1 and log level below DEBUG.</p> Source code in <code>trestle/common/log.py</code> <pre><code>class Trace():\n    \"\"\"Class allowing low priority trace message when verbose &gt; 1 and log level below DEBUG.\"\"\"\n\n    def __init__(self, logger: logging.Logger) -&gt; None:\n        \"\"\"Store the main logger with its module name.\"\"\"\n        self._logger = logger\n\n    def log(self, msg: str) -&gt; None:\n        \"\"\"Output the trace msg if log level is below DEBUG.\"\"\"\n        level = self._logger.getEffectiveLevel()\n        if level &lt; logging.DEBUG:\n            self._logger.debug(msg)\n</code></pre>"},{"location":"reference/API/trestle/common/log/#trestle.common.log.Trace-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/log/#trestle.common.log.Trace.__init__","title":"<code>__init__(logger)</code>","text":"<p>Store the main logger with its module name.</p> Source code in <code>trestle/common/log.py</code> <pre><code>def __init__(self, logger: logging.Logger) -&gt; None:\n    \"\"\"Store the main logger with its module name.\"\"\"\n    self._logger = logger\n</code></pre>"},{"location":"reference/API/trestle/common/log/#trestle.common.log.Trace.log","title":"<code>log(msg)</code>","text":"<p>Output the trace msg if log level is below DEBUG.</p> Source code in <code>trestle/common/log.py</code> <pre><code>def log(self, msg: str) -&gt; None:\n    \"\"\"Output the trace msg if log level is below DEBUG.\"\"\"\n    level = self._logger.getEffectiveLevel()\n    if level &lt; logging.DEBUG:\n        self._logger.debug(msg)\n</code></pre>"},{"location":"reference/API/trestle/common/log/#trestle.common.log-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/log/#trestle.common.log.get_current_verbosity_level","title":"<code>get_current_verbosity_level(logger)</code>","text":"<p>Get the current verbosity level based on logging level.</p> Source code in <code>trestle/common/log.py</code> <pre><code>def get_current_verbosity_level(logger: logging.Logger) -&gt; int:\n    \"\"\"Get the current verbosity level based on logging level.\"\"\"\n    level = logger.getEffectiveLevel()\n    if level &lt; logging.DEBUG:\n        return 2\n    elif level == logging.DEBUG:\n        return 1\n    return 0\n</code></pre>"},{"location":"reference/API/trestle/common/log/#trestle.common.log.set_global_logging_levels","title":"<code>set_global_logging_levels(level=logging.INFO)</code>","text":"<p>Initialise logging.</p> <p>Should only be invoked by the CLI classes or similar.</p> Source code in <code>trestle/common/log.py</code> <pre><code>def set_global_logging_levels(level: int = logging.INFO) -&gt; None:\n    \"\"\"Initialise logging.\n\n    Should only be invoked by the CLI classes or similar.\n    \"\"\"\n    # This line stops default root loggers setup for a python context from logging extra messages.\n    # DO NOT USE THIS COMMAND directly from an SDK. Handle logs levels based on your own application\n    _logger.propagate = False\n    # Remove handlers\n    _logger.handlers.clear()\n    # set global level\n    _logger.setLevel(level)\n    # Create standard out\n    console_out_handler = logging.StreamHandler(sys.stdout)\n    console_out_handler.setLevel(logging.INFO)\n    console_out_handler.addFilter(SpecificLevelFilter(logging.INFO))\n\n    console_debug_handler = logging.StreamHandler(sys.stdout)\n    console_debug_handler.setLevel(logging.DEBUG)\n    console_debug_handler.addFilter(SpecificLevelFilter(logging.DEBUG))\n\n    console_error_handler = logging.StreamHandler(sys.stderr)\n    console_error_handler.setLevel(logging.WARNING)\n    # create formatters\n    error_formatter = logging.Formatter('%(name)s:%(lineno)d %(levelname)s: %(message)s')\n    debug_formatter = logging.Formatter('%(name)s:%(lineno)d %(levelname)s: %(message)s')\n    console_debug_handler.setFormatter(debug_formatter)\n    console_error_handler.setFormatter(error_formatter)\n    # add ch to logger\n    _logger.addHandler(console_out_handler)\n    _logger.addHandler(console_error_handler)\n    _logger.addHandler(console_debug_handler)\n</code></pre>"},{"location":"reference/API/trestle/common/log/#trestle.common.log.set_log_level_from_args","title":"<code>set_log_level_from_args(args)</code>","text":"<p>Vanity function to automatically set log levels based on verbosity flags.</p> Source code in <code>trestle/common/log.py</code> <pre><code>def set_log_level_from_args(args: argparse.Namespace) -&gt; None:\n    \"\"\"Vanity function to automatically set log levels based on verbosity flags.\"\"\"\n    if args.verbose &gt; 1:\n        # these msgs only output by trace calls\n        set_global_logging_levels(_get_trace_level())\n    elif args.verbose == 1:\n        set_global_logging_levels(logging.DEBUG)\n    else:\n        set_global_logging_levels(logging.INFO)\n        sys.excepthook = _exception_handler\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/","title":"trestle.common.model_utils","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils","title":"<code>trestle.common.model_utils</code>","text":"<p>Common utilities for the OSCAL models and directories.</p>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils-classes","title":"Classes","text":""},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils","title":"<code>ModelUtils</code>","text":"<p>Utilities for the OSCAL models input and output.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>class ModelUtils:\n    \"\"\"Utilities for the OSCAL models input and output.\"\"\"\n\n    @staticmethod\n    def load_distributed(\n        abs_path: Path,\n        abs_trestle_root: Path,\n        collection_type: Optional[Type[Any]] = None\n    ) -&gt; Tuple[Type[OscalBaseModel],\n               str,\n               Optional[Union[OscalBaseModel, List[OscalBaseModel], Dict[str, OscalBaseModel]]]]:\n        \"\"\"\n        Given path to a model, load the model.\n\n        If the model is decomposed/split/distributed,the decomposed models are loaded recursively.\n\n        Args:\n            abs_path: The path to the file/directory to be loaded.\n            abs_trestle_root: The trestle workspace root directory.\n            collection_type: The type of collection model, if it is a collection model.\n                typing.List is the only collection type handled or expected.\n                Defaults to None.\n\n        Returns:\n            Return a tuple of Model Type (e.g. class 'trestle.oscal.catalog.Catalog'),\n            Model Alias (e.g. 'catalog.metadata') and Instance of the Model.\n            If the model is decomposed/split/distributed, the instance of the model contains\n                the decomposed models loaded recursively.\n\n        Note:\n            This does not validate the model.  You must either validate the model separately or use the load_validate\n            utilities.\n        \"\"\"\n        # if trying to load file that does not exist, load path instead\n        if not abs_path.exists():\n            abs_path = abs_path.with_name(abs_path.stem)\n\n        if not abs_path.exists():\n            raise TrestleNotFoundError(f'File {abs_path} not found for load.')\n\n        if collection_type:\n            # If the path contains a list type model\n            if collection_type is list:\n                return ModelUtils._load_list(abs_path, abs_trestle_root)\n            # the only other collection type in OSCAL is dict, and it only applies to include_all,\n            # which is too granular ever to be loaded by this routine\n            else:\n                raise TrestleError(f'Collection type {collection_type} not recognized for distributed load.')\n\n        # Get current model\n        primary_model_type, primary_model_alias = ModelUtils.get_stripped_model_type(abs_path, abs_trestle_root)\n        primary_model_instance: Optional[Union[OscalBaseModel, List[OscalBaseModel], Dict[str, OscalBaseModel]]] = None\n\n        # is this an attempt to load an actual json or yaml file?\n        content_type = FileContentType.path_to_content_type(abs_path)\n        # if file is sought but it doesn't exist, ignore and load as decomposed model\n        if FileContentType.is_readable_file(content_type) and abs_path.exists():\n            primary_model_instance = primary_model_type.oscal_read(abs_path)\n        # Is model decomposed?\n        decomposed_dir = abs_path.with_name(abs_path.stem)\n\n        if decomposed_dir.exists():\n            aliases_not_to_be_stripped = []\n            instances_to_be_merged: List[OscalBaseModel] = []\n\n            for local_path in sorted(trestle.common.file_utils.iterdir_without_hidden_files(decomposed_dir)):\n                if local_path.is_file():\n                    model_type, model_alias, model_instance = ModelUtils.load_distributed(local_path, abs_trestle_root)\n                    aliases_not_to_be_stripped.append(model_alias.split('.')[-1])\n                    instances_to_be_merged.append(model_instance)\n\n                elif local_path.is_dir():\n                    model_type, model_alias = ModelUtils.get_stripped_model_type(local_path, abs_trestle_root)\n                    # Only load the directory if it is a collection model. Otherwise do nothing - it gets loaded when\n                    # iterating over the model file\n\n                    # If a model is just a container for a list e.g.\n                    # class Foo(OscalBaseModel):  noqa: E800\n                    #      __root__: List[Bar]    noqa: E800\n                    # You need to test whether first a root key exists\n                    # then whether the outer_type of root is a collection.\n                    # Alternative is to do a try except to avoid the error for an unknown key.\n\n                    if model_type.is_collection_container():\n                        # This directory is a decomposed List or Dict\n                        collection_type = model_type.get_collection_type()\n                        model_type, model_alias, model_instance = ModelUtils.load_distributed(local_path,\n                                                                                              abs_trestle_root,\n                                                                                              collection_type)\n                        aliases_not_to_be_stripped.append(model_alias.split('.')[-1])\n                        instances_to_be_merged.append(model_instance)\n            primary_model_dict = {}\n            if primary_model_instance is not None:\n                primary_model_dict = primary_model_instance.__dict__\n\n            merged_model_type, merged_model_alias = ModelUtils.get_stripped_model_type(abs_path,\n                                                                                       abs_trestle_root,\n                                                                                       aliases_not_to_be_stripped)\n\n            # The following use of top_level is to allow loading of a top level model by name only, e.g. MyCatalog\n            # There may be a better overall way to approach this.\n            top_level = len(merged_model_alias.split('.')) == 1\n\n            for i in range(len(aliases_not_to_be_stripped)):\n                alias = aliases_not_to_be_stripped[i]\n                instance = instances_to_be_merged[i]\n                if hasattr(instance, '__dict__') and '__root__' in instance.__dict__ and isinstance(instance,\n                                                                                                    OscalBaseModel):\n                    instance = instance.__dict__['__root__']\n                if top_level and not primary_model_dict:\n                    primary_model_dict = instance.__dict__\n                else:\n                    primary_model_dict[alias] = instance\n\n            merged_model_instance = merged_model_type(**primary_model_dict)\n            return merged_model_type, merged_model_alias, merged_model_instance\n        return primary_model_type, primary_model_alias, primary_model_instance\n\n    @staticmethod\n    def load_model_for_class(\n        trestle_root: pathlib.Path,\n        model_name: str,\n        model_class: TG,\n        file_content_type: Optional[FileContentType] = None\n    ) -&gt; Tuple[TG, pathlib.Path]:\n        \"\"\"Load a model by name and model class and infer file content type if not specified.\n\n        If you need to load an existing model but its content type may not be known, use this method.\n        But the file content type should be specified if it is somehow known.\n\n        Note:\n            This does not validate the model.  If you want to validate the model use the load_validate utilities.\n        \"\"\"\n        root_model_path = ModelUtils._root_path_for_top_level_model(\n            trestle_root, model_name, model_class\n        )  # type: ignore\n        if file_content_type is None:\n            file_content_type = FileContentType.path_to_content_type(root_model_path)\n        if not FileContentType.is_readable_file(file_content_type):\n            raise TrestleError(f'Unable to load model {model_name} without specifying json or yaml.')\n        full_model_path = root_model_path.with_suffix(FileContentType.to_file_extension(file_content_type))\n        _, _, model = ModelUtils.load_distributed(full_model_path, trestle_root)\n        return model, full_model_path  # type: ignore\n\n    @staticmethod\n    def load_model_for_type(trestle_root: pathlib.Path, model_type: str,\n                            model_name: str) -&gt; Tuple[TopLevelOscalModel, pathlib.Path]:\n        \"\"\"Load model for the given type and name.\"\"\"\n        dir_name = ModelUtils.model_type_to_model_dir(model_type)\n        model_path = trestle_root / dir_name / model_name\n\n        if not model_path.exists():\n            raise TrestleError(f'No model is found at path: {model_path}.')\n\n        _, _, oscal_object = ModelUtils.load_distributed(model_path, trestle_root)\n\n        return oscal_object, model_path  # type: ignore\n\n    @staticmethod\n    def save_top_level_model(\n        model: TopLevelOscalModel, trestle_root: pathlib.Path, model_name: str, file_content_type: FileContentType\n    ) -&gt; None:\n        \"\"\"Save a model by name and infer model type by inspection.\n\n        You don't need to specify the model type (catalog, profile, etc.) but you must specify the file content type.\n        If the model directory does not exist, it is created.\n        \"\"\"\n        root_model_path = ModelUtils._root_path_for_top_level_model(trestle_root, model_name, model)\n        full_model_path = root_model_path.with_suffix(FileContentType.to_file_extension(file_content_type))\n        if not full_model_path.parent.exists():\n            full_model_path.parent.mkdir(parents=True, exist_ok=True)\n        model.oscal_write(full_model_path)\n\n    @staticmethod\n    def get_relative_model_type(relative_path: pathlib.Path) -&gt; Tuple[Type[OscalBaseModel], str]:\n        \"\"\"\n        Given the relative path of a file with respect to 'trestle_root' return the oscal model type.\n\n        Args:\n            relative_path: Relative path of the model with respect to the root directory of the trestle workspace.\n        Returns:\n            Type of Oscal Model for the provided model\n            Alias of that oscal model.\n        \"\"\"\n        if len(relative_path.parts) &lt; 2:\n            raise TrestleError(\n                'Insufficient path length to be a valid relative path w.r.t trestle workspace root directory.'\n            )\n        model_dir = relative_path.parts[0]\n        model_relative_path = pathlib.Path(*relative_path.parts[2:])  # catalogs, profiles, etc\n\n        if model_dir in const.MODEL_DIR_LIST:\n            module_name = const.MODEL_DIR_TO_MODEL_MODULE[model_dir]\n        else:\n            raise TrestleError(f'No valid trestle model type directory (e.g. catalogs) found for {model_dir}.')\n\n        model_type, model_alias = ModelUtils.get_root_model(module_name)\n        full_alias = model_alias\n\n        for index, part in enumerate(model_relative_path.parts):\n            alias = ModelUtils._extract_alias(part)\n            if index &gt; 0 or model_alias != alias:\n                model_alias = alias\n                full_alias = f'{full_alias}.{model_alias}'\n                if utils.is_collection_field_type(model_type):\n                    model_type = utils.get_inner_type(model_type)\n                else:\n                    model_type = model_type.alias_to_field_map()[alias].outer_type_\n\n        return model_type, full_alias\n\n    @staticmethod\n    def get_stripped_model_type(\n        absolute_path: pathlib.Path,\n        absolute_trestle_root: pathlib.Path,\n        aliases_not_to_be_stripped: List[str] = None\n    ) -&gt; Tuple[Type[OscalBaseModel], str]:\n        \"\"\"\n        Get the stripped contextual model class and alias based on the contextual path.\n\n        This function relies on the directory structure of the trestle model being edited to determine, based on the\n        existing files and folder, which fields should be stripped from the model type represented by the\n        path passed in as a parameter.\n        \"\"\"\n        if aliases_not_to_be_stripped is None:\n            aliases_not_to_be_stripped = []\n        singular_model_type, model_alias = ModelUtils.get_relative_model_type(\n            absolute_path.relative_to(absolute_trestle_root))\n        logger.debug(f'singular model type {singular_model_type} model alias {model_alias}')\n\n        # Stripped models do not apply to collection types such as List[] and Dict{}\n        # if model type is a list or dict, generate a new wrapping model for it\n        if utils.is_collection_field_type(singular_model_type):\n            malias = model_alias.split('.')[-1]\n            class_name = alias_to_classname(malias, AliasMode.JSON)\n            logger.debug(f'collection field type class name {class_name} and alias {malias}')\n            model_type = create_model(class_name, __base__=OscalBaseModel, __root__=(singular_model_type, ...))\n            logger.debug(f'model_type created: {model_type}')\n            return model_type, model_alias\n\n        malias = model_alias.split('.')[-1]\n        logger.debug(f'not collection field type, malias: {malias}')\n        if absolute_path.is_dir() and malias != ModelUtils._extract_alias(absolute_path.name):\n            split_subdir = absolute_path / malias\n        else:\n            split_subdir = absolute_path.parent / absolute_path.with_suffix('').name\n\n        aliases_to_be_stripped = set()\n        if split_subdir.exists():\n            for f in iterdir_without_hidden_files(split_subdir):\n                alias = ModelUtils._extract_alias(f.name)\n                if alias not in aliases_not_to_be_stripped:\n                    aliases_to_be_stripped.add(alias)\n\n        logger.debug(f'aliases to be stripped: {aliases_to_be_stripped}')\n        if len(aliases_to_be_stripped) &gt; 0:\n            model_type = singular_model_type.create_stripped_model_type(\n                stripped_fields_aliases=list(aliases_to_be_stripped)\n            )\n            logger.debug(f'model_type: {model_type}')\n            return model_type, model_alias\n        return singular_model_type, model_alias\n\n    @staticmethod\n    def model_type_to_model_dir(model_type: str) -&gt; str:\n        \"\"\"Get plural model directory from model type.\"\"\"\n        if model_type not in const.MODEL_TYPE_LIST:\n            raise err.TrestleError(f'Not a valid model type: {model_type}.')\n        return const.MODEL_TYPE_TO_MODEL_DIR[model_type]\n\n    @staticmethod\n    def get_models_of_type(model_type: str, root: pathlib.Path) -&gt; List[str]:\n        \"\"\"Get list of model names for requested type in trestle directory.\"\"\"\n        if model_type not in const.MODEL_TYPE_LIST:\n            raise err.TrestleError(f'Model type {model_type} is not supported')\n        # search relative to project root\n        trestle_root = extract_trestle_project_root(root)\n        if not trestle_root:\n            logger.error(f'Given directory {root} is not within a trestle project.')\n            raise err.TrestleError('Given directory is not within a trestle project.')\n\n        # contruct path to the model file name\n        model_dir_name = ModelUtils.model_type_to_model_dir(model_type)\n        root_model_dir = trestle_root / model_dir_name\n        model_list = []\n        for f in root_model_dir.glob('*/'):\n            # only look for proper json and yaml files\n            if not ModelUtils._should_ignore(f.stem):\n                if not f.is_dir():\n                    logger.warning(\n                        f'Ignoring validation of misplaced file {f.name} '\n                        + f'found in the model directory, {model_dir_name}.'\n                    )\n                else:\n                    model_list.append(f.stem)\n        return model_list\n\n    @staticmethod\n    def get_all_models(root: pathlib.Path) -&gt; List[Tuple[str, str]]:\n        \"\"\"Get list of all models in trestle directory as tuples (model_type, model_name).\"\"\"\n        full_list = []\n        for model_type in const.MODEL_TYPE_LIST:\n            models = ModelUtils.get_models_of_type(model_type, root)\n            for m in models:\n                full_list.append((model_type, m))\n        return full_list\n\n    @staticmethod\n    def get_model_path_for_name_and_class(\n        trestle_root: pathlib.Path,\n        model_name: str,\n        model_class: Type[TopLevelOscalModel],\n        file_content_type: Optional[FileContentType] = None\n    ) -&gt; Optional[pathlib.Path]:\n        \"\"\"\n        Find the full path of a model given its name, model type and file content type.\n\n        If file_content_type is given it will not inspect the file system or confirm the needed path and file exists.\n        \"\"\"\n        if file_content_type is None:\n            root_model_path = ModelUtils._root_path_for_top_level_model(trestle_root, model_name, model_class)\n            file_content_type = FileContentType.path_to_content_type(root_model_path)\n            if not FileContentType.is_readable_file(file_content_type):\n                return None\n\n            return root_model_path.with_suffix(FileContentType.to_file_extension(file_content_type))\n\n        root_path = ModelUtils._root_path_for_top_level_model(trestle_root, model_name, model_class)\n        return root_path.with_suffix(FileContentType.to_file_extension(file_content_type))\n\n    @staticmethod\n    def get_singular_alias(alias_path: str, relative_path: Optional[pathlib.Path] = None) -&gt; str:\n        \"\"\"\n        Get the alias in the singular form from a jsonpath.\n\n        If contextual_mode is True and contextual_path is None, it assumes alias_path\n        is relative to the directory the user is running trestle from.\n\n        Args:\n            alias_path: The current alias element path as a string\n            relative_path: Optional relative path (w.r.t. trestle_root) to cater for relative element paths.\n        Returns:\n            Alias as a string\n        \"\"\"\n        if len(alias_path.strip()) == 0:\n            raise err.TrestleError(f'Invalid jsonpath {alias_path}')\n\n        singular_alias: str = ''\n\n        full_alias_path = alias_path\n        if relative_path:\n            logger.debug(f'get_singular_alias contextual mode: {str}')\n            _, full_model_alias = ModelUtils.get_relative_model_type(relative_path)\n            first_alias_a = full_model_alias.split('.')[-1]\n            first_alias_b = alias_path.split('.')[0]\n            if first_alias_a == first_alias_b:\n                full_model_alias = '.'.join(full_model_alias.split('.')[:-1])\n            full_alias_path = '.'.join([full_model_alias, alias_path]).strip('.')\n\n        path_parts = full_alias_path.split(const.ALIAS_PATH_SEPARATOR)\n        logger.debug(f'path parts: {path_parts}')\n\n        model_types = []\n\n        root_model_alias = path_parts[0]\n        found = False\n        for module_name in const.MODEL_TYPE_TO_MODEL_MODULE.values():\n            model_type, model_alias = ModelUtils.get_root_model(module_name)\n            if root_model_alias == model_alias:\n                found = True\n                model_types.append(model_type)\n                break\n\n        if not found:\n            raise err.TrestleError(f'{root_model_alias} is an invalid root model alias.')\n\n        if len(path_parts) == 1:\n            return root_model_alias\n\n        model_type = model_types[0]\n        # go through path parts skipping first one\n        for i in range(1, len(path_parts)):\n            if utils.is_collection_field_type(model_type):\n                # if it is a collection type and last part is * then break\n                if i == len(path_parts) - 1 and path_parts[i] == '*':\n                    break\n                # otherwise get the inner type of items in the collection\n                model_type = utils.get_inner_type(model_type)\n                # and bump i\n                i = i + 1\n            else:\n                path_part = path_parts[i]\n                field_map = model_type.alias_to_field_map()\n                if path_part not in field_map:\n                    continue\n                field = field_map[path_part]\n                model_type = field.outer_type_\n            model_types.append(model_type)\n\n        last_alias = path_parts[-1]\n        if last_alias == '*':\n            last_alias = path_parts[-2]\n\n        # generic model and not list, so return itself fixme doc\n        if not utils.is_collection_field_type(model_type):\n            return last_alias\n\n        parent_model_type = model_types[-2]\n        try:\n            field_map = parent_model_type.alias_to_field_map()\n            field = field_map[last_alias]\n            outer_type = field.outer_type_\n            inner_type = utils.get_inner_type(outer_type)\n            inner_type_name = inner_type.__name__\n            singular_alias = str_utils.classname_to_alias(inner_type_name, AliasMode.JSON)\n        except Exception as e:\n            raise err.TrestleError(f'Error in json path {alias_path}: {e}')\n\n        return singular_alias\n\n    @staticmethod\n    def get_root_model(module_name: str) -&gt; Tuple[Type[Any], str]:\n        \"\"\"Get the root model class and alias based on the module.\"\"\"\n        try:\n            module = importlib.import_module(module_name)\n        except ModuleNotFoundError as e:\n            raise err.TrestleError(str(e))\n\n        if hasattr(module, 'Model'):\n            model_metadata = next(iter(module.Model.__fields__.values()))\n            return model_metadata.type_, model_metadata.alias\n        raise err.TrestleError('Invalid module')\n\n    @staticmethod\n    def _root_path_for_top_level_model(\n        trestle_root: pathlib.Path, model_name: str, model_class: Union[TopLevelOscalModel, Type[TopLevelOscalModel]]\n    ) -&gt; pathlib.Path:\n        \"\"\"\n        Find the root path to a model given its name and class - with no suffix.\n\n        This is a private method used only to construct the root filepath based on model name and type.\n        It does not check for existence or content type and it does not create the directory if it does not exist.\n        \"\"\"\n        if not hasattr(model_class, '__module__') or model_class.__module__ not in const.MODEL_MODULE_LIST:\n            raise TrestleError(f'Unable to determine model type for model {model_name} with class {model_class}')\n        model_alias = const.MODEL_MODULE_TO_MODEL_TYPE[model_class.__module__]\n        model_dir = trestle_root / f'{const.MODEL_TYPE_TO_MODEL_DIR[model_alias]}/{model_name}'\n        return model_dir / model_alias\n\n    @staticmethod\n    def _extract_alias(string_dir: str) -&gt; str:\n        \"\"\"\n        Extract alias from filename or directory name removing extensions and prefixes related to dict and list.\n\n        As we need to do this for multiple parts of a path operating on strings is easier.\n        \"\"\"\n        alias = string_dir.split('.')[0].split(\n            const.IDX_SEP\n        )[-1]  # get suffix of file or directory name representing list or dict item\n        return alias\n\n    @staticmethod\n    def _should_ignore(name: str) -&gt; bool:\n        \"\"\"Check if the file or directory should be ignored or not.\"\"\"\n        return name[0] == '.' or name[0] == '_'\n\n    @staticmethod\n    def _load_list(abs_path: Path, abs_trestle_root: Path) -&gt; Tuple[Type[OscalBaseModel], str, List[OscalBaseModel]]:\n        \"\"\"Given path to a directory of list(array) models, load the distributed models.\"\"\"\n        aliases_not_to_be_stripped = []\n        instances_to_be_merged: List[OscalBaseModel] = []\n        collection_model_type, collection_model_alias = ModelUtils.get_stripped_model_type(abs_path, abs_trestle_root)\n        for path in sorted(trestle.common.file_utils.iterdir_without_hidden_files(abs_path)):\n\n            # ASSUMPTION HERE: if it is a directory, there's a file that can not be decomposed further.\n            if path.is_dir():\n                continue\n            _, model_alias, model_instance = ModelUtils.load_distributed(path, abs_trestle_root)\n\n            instances_to_be_merged.append(model_instance)\n            aliases_not_to_be_stripped.append(model_alias.split('.')[-1])\n\n        return collection_model_type, collection_model_alias, instances_to_be_merged\n\n    @staticmethod\n    def _parameter_to_dict_recurse(obj: Union[OscalBaseModel, str], partial: bool) -&gt; Union[str, Dict[str, Any]]:\n        \"\"\"\n        Convert obj to dict containing only string values with recursion.\n\n        Args:\n            obj: The parameter or its consituent parts in recursive calls\n            partial: Whether to convert the entire param or just the parts needed for markdown header\n\n        Returns:\n            The converted parameter as dictionary\n        \"\"\"\n        main_fields = ['id', 'label', 'values', 'select', 'choice', 'how_many', 'guidelines', 'prose']\n        if isinstance(obj, common.Remarks):\n            return obj.__root__\n        if isinstance(obj, common.HowMany):\n            return obj.value\n        # it is either a string already or we cast it to string\n        if not hasattr(obj, const.FIELDS_SET):\n            return str(obj)\n        # it is an oscal object and we need to recurse within its attributes\n        res = {}\n        for field in obj.__fields_set__:\n            if partial and field not in main_fields:\n                continue\n            attr = getattr(obj, field)\n            if not attr:\n                continue\n            if isinstance(attr, list):\n                new_list = []\n                for item in attr:\n                    new_list.append(ModelUtils._parameter_to_dict_recurse(item, partial))\n                res[field] = new_list\n            elif isinstance(attr, str):\n                res[field] = attr\n            else:\n                res[field] = ModelUtils._parameter_to_dict_recurse(attr, partial)\n        return res\n\n    @staticmethod\n    def parameter_to_dict(obj: Union[OscalBaseModel, str], partial: bool) -&gt; Union[str, Dict[str, Any]]:\n        \"\"\"\n        Convert obj to dict containing only string values, storing only the fields that have values set.\n\n        Args:\n            obj: The parameter or its consituent parts in recursive calls\n            partial: Whether to convert the entire param or just the parts needed for markdown header\n\n        Returns:\n            The converted parameter as dictionary, with values as None if not present\n        \"\"\"\n        res = ModelUtils._parameter_to_dict_recurse(obj, partial)\n        if 'values' not in res:\n            res['values'] = None  # type: ignore\n        return res\n\n    @staticmethod\n    def _string_to_howmany(count_str: str) -&gt; Optional[str]:\n        clean_str = count_str.lower().strip().replace('-', ' ').replace('_', ' ')\n        if clean_str == const.ONE:\n            return common.HowMany.one  # type: ignore\n        if clean_str == const.ONE_OR_MORE_SPACED:\n            return common.HowMany.one_or_more  # type: ignore\n        return None\n\n    @staticmethod\n    def dict_to_parameter(param_dict: Dict[str, Any]) -&gt; common.Parameter:\n        \"\"\"\n        Convert dict with only string values to Parameter with handling for HowMany and with validity checks.\n\n        Args:\n            param_dict: Dictionary of pure string values representing Parameter contents\n\n        Returns:\n            A valid OSCAL Parameter\n\n        Notes:\n            This handles both partial and full parameter dictionaries\n            It checks for validity of the values if a select and HowMany is specified\n            There is special handling for values: If it is a single string it is converted to list of one ParameterValue\n            But if it is a list of strings is regarded as a list of values and is converted to a list of ParameterValues\n        \"\"\"\n        values = param_dict.get('values', [])\n        # special handling when only one value present - convert to list of 1\n        if isinstance(values, str):\n            values = [values]\n            param_dict['values'] = values\n        if 'select' in param_dict and 'how_many' in param_dict['select']:\n            count_str = param_dict['select']['how_many']\n            how_many = ModelUtils._string_to_howmany(count_str)\n            if how_many is None:\n                raise TrestleError(f'Unrecognized HowMany value {how_many} in Parameter: should be one-or-more or one.')\n            param_dict['select']['how_many'] = how_many\n            if how_many == const.ONE and len(values) &gt; 1:\n                logger.warning(f'Parameter specifies HowMany=1 but has {len(values)} values given.')\n            choices = param_dict['select'].get('choice', [])\n            if choices and values:\n                for value in values:\n                    if value not in choices:\n                        logger.warning(f\"Parameter {param_dict['id']} has value \\\"{value}\\\" not in choices: {choices}.\")\n        props = param_dict.get('props', [])\n        if const.DISPLAY_NAME in param_dict:\n            display_name = param_dict.pop(const.DISPLAY_NAME)\n            props.append(common.Property(name=const.DISPLAY_NAME, value=display_name, ns=const.TRESTLE_GENERIC_NS))\n        if const.AGGREGATES in param_dict:\n            # removing aggregates as this is prop just informative in markdown\n            param_dict.pop(const.AGGREGATES)\n        param_value_origin = None\n        if const.PARAM_VALUE_ORIGIN in param_dict:\n            param_value_origin = param_dict.pop(const.PARAM_VALUE_ORIGIN)\n            if param_value_origin is not None:\n                props.append(common.Property(name=const.PARAM_VALUE_ORIGIN, value=param_value_origin))\n            else:\n                raise TrestleError(\n                    f'Parameter value origin property for parameter {param_dict[\"id\"]}'\n                    'is None and it should have a value'\n                )\n        if const.ALT_IDENTIFIER in param_dict:\n            # removing alt-identifier as this is prop just informative in markdown\n            param_dict.pop(const.ALT_IDENTIFIER)\n\n        if 'ns' in param_dict:\n            param_dict.pop('ns')\n        param = common.Parameter(**param_dict)\n        param.props = none_if_empty(props)\n        return param\n\n    @staticmethod\n    def last_modified_at_time(timestamp: Optional[datetime] = None) -&gt; datetime:\n        \"\"\"Generate a LastModified set to timestamp or now.\"\"\"\n        timestamp = timestamp if timestamp else datetime.now().astimezone()\n        return timestamp\n\n    @staticmethod\n    def update_last_modified(model: TopLevelOscalModel, timestamp: Optional[datetime] = None) -&gt; None:\n        \"\"\"Update the LastModified timestamp in top level model to now.\"\"\"\n        timestamp = timestamp if timestamp else datetime.now().astimezone()\n        model.metadata.last_modified = timestamp\n\n    @staticmethod\n    def model_age(model: TopLevelOscalModel) -&gt; int:\n        \"\"\"Find time in seconds since LastModified timestamp.\"\"\"\n        # default to one year if no last_modified\n        age_seconds = const.DAY_SECONDS * 365\n        if model.metadata.last_modified:\n            dt = datetime.now().astimezone() - model.metadata.last_modified\n            age_seconds = dt.seconds\n        return age_seconds\n\n    @staticmethod\n    def find_values_by_name(object_of_interest: Any, name_of_interest: str) -&gt; List[Any]:\n        \"\"\"Traverse object and return list of values of specified name.\"\"\"\n        loe = []\n        if isinstance(object_of_interest, BaseModel):\n            value = getattr(object_of_interest, name_of_interest, None)\n            if value is not None:\n                loe.append(value)\n            fields = getattr(object_of_interest, const.FIELDS_SET, None)\n            if fields is not None:\n                for field in fields:\n                    loe.extend(\n                        ModelUtils.find_values_by_name(getattr(object_of_interest, field, None), name_of_interest)\n                    )\n        elif type(object_of_interest) is list:\n            for item in object_of_interest:\n                loe.extend(ModelUtils.find_values_by_name(item, name_of_interest))\n        elif type(object_of_interest) is dict:\n            if name_of_interest in object_of_interest:\n                loe.append(object_of_interest[name_of_interest])\n            for item in object_of_interest.values():\n                loe.extend(ModelUtils.find_values_by_name(item, name_of_interest))\n        return loe\n\n    @staticmethod\n    def has_no_duplicate_values_by_name(object_of_interest: BaseModel, name_of_interest: str) -&gt; bool:\n        \"\"\"Determine if duplicate values of type exist in object.\"\"\"\n        loe = ModelUtils.find_values_by_name(object_of_interest, name_of_interest)\n        set_loe = set(loe)\n        if len(loe) == len(set_loe):\n            return True\n        items: Dict[str, Any] = {}\n        for item in loe:\n            items[item] = items.get(item, 0) + 1\n        # now print items\n        for item, instances in items.items():\n            if instances &gt; 1:\n                logger.warning(f'Duplicate detected of item {item} with {instances} instances.')\n        return False\n\n    @staticmethod\n    def find_uuid_refs(object_of_interest: BaseModel) -&gt; Set[str]:\n        \"\"\"Find uuid references made in prose and links.\"\"\"\n        # hrefs have form #foo or #uuid\n        uuid_strs = ModelUtils.find_values_by_name(object_of_interest, 'href')\n\n        # prose has uuid refs in markdown form: [foo](#bar) or [foo](#uuid)\n        prose_list = ModelUtils.find_values_by_name(object_of_interest, 'prose')\n        for prose in prose_list:\n            matches = re.findall(const.MARKDOWN_URL_REGEX, prose)\n            # the [1] is to extract the inner of 3 capture patterns\n            new_uuids = [match[1] for match in matches]\n            uuid_strs.extend(new_uuids)\n\n        # collect the strings that start with # and are potential uuids\n        uuid_strs = [uuid_str for uuid_str in uuid_strs if uuid_str and uuid_str[0] == '#']\n\n        # go through all matches and build set of those that are uuids\n        uuid_set = {uuid_match for uuid_str in uuid_strs for uuid_match in re.findall(const.UUID_REGEX, uuid_str[1:])}\n        return uuid_set\n\n    @staticmethod\n    def _regenerate_uuids_in_place(object_of_interest: Any, uuid_lut: Dict[str, str]) -&gt; Tuple[Any, Dict[str, str]]:\n        \"\"\"Update all uuids in model that require updating.\n\n        Go through the model and replace all dicts with key == 'uuid' and replace the value with a new uuid4.\n        Build a lookup table of the updates that were made.\n        This function does not update the corresponding refs to those uuid's.  That is done by update_uuid_refs\n        Note that this function needs to be started off with uuid_lut == {}, i.e. an empty dict.\n        After that it recurses and grows the lut.\n\n        Args:\n            object_of_interest: pydantic.BaseModel, list, dict or str will be updated\n            uuid_lut: dict of the growing lut of old:new uuid's.  First call must be made with value {}\n\n        Returns:\n            The updated object_of_interest with new uuid's (but refs to them are not updated)\n            The final lookup table of old:new uuid's\n\n        \"\"\"\n        uuid_str = 'uuid'\n        # Certain types are known not to need updating and should not change\n        # Resources are identified by uuid, and the corresponding href will have # in front of the uuid string\n        # Neither of these should change\n        # If other similar types are found they should be added to the FixedUuidModel typevar to prevent updating\n        if isinstance(object_of_interest, common.Resource):\n            pass\n        elif isinstance(object_of_interest, BaseModel):\n            # fields has names of all fields in model\n            fields = getattr(object_of_interest, const.FIELDS_SET, None)\n            for field in fields:\n                new_object = None\n                if field == uuid_str:\n                    orig_uuid = getattr(object_of_interest, field)\n                    if orig_uuid:\n                        new_object = str(uuid.uuid4())\n                        uuid_lut[orig_uuid] = new_object\n                else:\n                    new_object, uuid_lut = ModelUtils._regenerate_uuids_in_place(\n                        object_of_interest.__dict__[field],\n                        uuid_lut\n                    )\n                object_of_interest.__dict__[field] = new_object\n        elif type(object_of_interest) is list:\n            new_list = []\n            for item in object_of_interest:\n                new_item, uuid_lut = ModelUtils._regenerate_uuids_in_place(item, uuid_lut)\n                new_list.append(new_item)\n            object_of_interest = new_list\n        elif type(object_of_interest) is dict:\n            new_dict = {}\n            for key, value in object_of_interest.items():\n                if key == uuid_str:\n                    new_val = str(uuid.uuid4())\n                    new_dict[uuid_str] = new_val\n                    uuid_lut[value] = new_val\n                else:\n                    new_value, uuid_lut = ModelUtils._regenerate_uuids_in_place(value, uuid_lut)\n                    new_dict[key] = new_value\n            object_of_interest = new_dict\n        return object_of_interest, uuid_lut\n\n    @staticmethod\n    def _update_new_uuid_refs(object_of_interest: Any, uuid_lut: Dict[str, str]) -&gt; Tuple[Any, int]:\n        \"\"\"Update all refs to uuids that were changed.\"\"\"\n        n_refs_updated = 0\n        if isinstance(object_of_interest, BaseModel):\n            fields = getattr(object_of_interest, const.FIELDS_SET, None)\n            for field in fields:\n                new_object, n_new_updates = ModelUtils._update_new_uuid_refs(\n                    object_of_interest.__dict__[field],\n                    uuid_lut\n                )\n                n_refs_updated += n_new_updates\n                object_of_interest.__dict__[field] = new_object\n        elif type(object_of_interest) is list:\n            new_list = []\n            for item in object_of_interest:\n                new_item, n_new_updates = ModelUtils._update_new_uuid_refs(item, uuid_lut)\n                n_refs_updated += n_new_updates\n                new_list.append(new_item)\n            object_of_interest = new_list\n        elif type(object_of_interest) is dict:\n            new_dict = {}\n            for key, value in object_of_interest.items():\n                if isinstance(value, str):\n                    if value in uuid_lut:\n                        new_dict[key] = uuid_lut[value]\n                        n_refs_updated += 1\n                    else:\n                        new_dict[key] = value\n                else:\n                    new_value, n_new_updates = ModelUtils._update_new_uuid_refs(value, uuid_lut)\n                    n_refs_updated += n_new_updates\n                    new_dict[key] = new_value\n            object_of_interest = new_dict\n        elif isinstance(object_of_interest, str):\n            if object_of_interest in uuid_lut:\n                n_refs_updated += 1\n                object_of_interest = uuid_lut[object_of_interest]\n        return object_of_interest, n_refs_updated\n\n    @staticmethod\n    def regenerate_uuids(object_of_interest: Any) -&gt; Tuple[Any, Dict[str, str], int]:\n        \"\"\"Regenerate all uuids in object and update corresponding references.\n\n        Find all dicts with key == 'uuid' and replace the value with a new uuid4.\n        Build a corresponding lookup table as you go, of old:new uuid values.\n        Then make a second pass through the object and replace all string values\n        present in the lookup table with the new value.\n\n        Args:\n            object_of_interest: pydantic.BaseModel, list, dict or str will be updated\n\n        Returns:\n            The updated object with new uuid's and refs\n            The final lookup table of old:new uuid's\n            A count of the number of refs that were updated\n        \"\"\"\n        new_object, uuid_lut = ModelUtils._regenerate_uuids_in_place(object_of_interest, {})\n        new_object, n_refs_updated = ModelUtils._update_new_uuid_refs(new_object, uuid_lut)\n        return new_object, uuid_lut, n_refs_updated\n\n    @staticmethod\n    def fields_set_non_none(obj: BaseModel) -&gt; Set[str]:\n        \"\"\"Find the fields set with Nones and empty items removed.\"\"\"\n        return set(as_filtered_list(list(obj.__fields_set__), lambda f: getattr(obj, f)))\n\n    @staticmethod\n    def _objects_differ(\n        obj_a: Any, obj_b: Any, ignore_type_list: List[Any], ignore_name_list: List[str], ignore_all_uuid: bool\n    ) -&gt; bool:\n        \"\"\"\n        Compare two objects with option to ignore given types.\n\n        This does not check for tuples or other structures that won't be found in JSON.\n        \"\"\"\n        obj_a_type = type(obj_a)\n        obj_b_type = type(obj_b)\n        if bool(obj_a) != bool(obj_b) or obj_a_type != obj_b_type:\n            return True\n        if not bool(obj_a):\n            return False\n        if obj_a_type in ignore_type_list:\n            return False\n        if obj_a_type is str:\n            return obj_a != obj_b\n        elif isinstance(obj_a, BaseModel):\n            fields_a = ModelUtils.fields_set_non_none(obj_a)\n            fields_b = ModelUtils.fields_set_non_none(obj_b)\n            if fields_a != fields_b:\n                return True\n            for field in list_utils.as_filtered_list(fields_a, lambda f: f not in ignore_name_list):  # type: ignore\n                if ignore_all_uuid and 'uuid' in field:\n                    continue\n                if ModelUtils._objects_differ(getattr(obj_a, field),\n                                              getattr(obj_b, field),\n                                              ignore_type_list,\n                                              ignore_name_list,\n                                              ignore_all_uuid):\n                    return True\n        elif obj_a_type is list:\n            if len(obj_a) != len(obj_b):\n                return True\n            for item_a, item_b in zip(obj_a, obj_b):\n                if ModelUtils._objects_differ(item_a, item_b, ignore_type_list, ignore_name_list, ignore_all_uuid):\n                    return True\n        elif obj_a_type is dict:\n            if obj_a.keys() != obj_b.keys():\n                return True\n            for key, val in obj_a.items():\n                if ignore_all_uuid and 'uuid' in key:\n                    continue\n                if key not in ignore_name_list and ModelUtils._objects_differ(\n                        val, obj_b[key], ignore_type_list, ignore_name_list, ignore_all_uuid):\n                    return True\n        elif obj_a != obj_b:\n            return True\n        return False\n\n    @staticmethod\n    def models_are_equivalent(\n        model_a: Optional[TopLevelOscalModel],\n        model_b: Optional[TopLevelOscalModel],\n        ignore_all_uuid: bool = False\n    ) -&gt; bool:\n        \"\"\"\n        Test if models are equivalent except for last modified and possibly uuid.\n\n        If a model has had uuids regenerated, then all uuids *and references to them* are updated.  This means that\n        special handling is required if a model has had uuids regenerated - when checking equivalence.\n        \"\"\"\n        uuid_type_list = [\n            common.LastModified,\n            common.LocationUuid,\n            common.PartyUuid,\n            common.RelatedRisk,\n            common.Source,\n            assessment_plan.RelatedObservation,\n            assessment_results.RelatedObservation,\n            poam.RelatedObservation,\n            poam.RelatedObservation1\n        ]\n        type_list = uuid_type_list if ignore_all_uuid else [common.LastModified]\n        return not ModelUtils._objects_differ(model_a, model_b, type_list, ['last_modified'], ignore_all_uuid)\n\n    @staticmethod\n    def get_title_from_model_uri(trestle_root: pathlib.Path, uri: str) -&gt; str:\n        \"\"\"Get title from model at uri.\"\"\"\n        try:\n            fetcher = cache.FetcherFactory.get_fetcher(trestle_root, uri)\n            model, _ = fetcher.get_oscal()\n            return model.metadata.title\n        except TrestleError as e:\n            logger.warning(f'Error finding title for model at uri {uri}: {e}')\n            raise\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.dict_to_parameter","title":"<code>dict_to_parameter(param_dict)</code>  <code>staticmethod</code>","text":"<p>Convert dict with only string values to Parameter with handling for HowMany and with validity checks.</p> <p>Parameters:</p> Name Type Description Default <code>param_dict</code> <code>Dict[str, Any]</code> <p>Dictionary of pure string values representing Parameter contents</p> required <p>Returns:</p> Type Description <code>Parameter</code> <p>A valid OSCAL Parameter</p> Notes <p>This handles both partial and full parameter dictionaries It checks for validity of the values if a select and HowMany is specified There is special handling for values: If it is a single string it is converted to list of one ParameterValue But if it is a list of strings is regarded as a list of values and is converted to a list of ParameterValues</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef dict_to_parameter(param_dict: Dict[str, Any]) -&gt; common.Parameter:\n    \"\"\"\n    Convert dict with only string values to Parameter with handling for HowMany and with validity checks.\n\n    Args:\n        param_dict: Dictionary of pure string values representing Parameter contents\n\n    Returns:\n        A valid OSCAL Parameter\n\n    Notes:\n        This handles both partial and full parameter dictionaries\n        It checks for validity of the values if a select and HowMany is specified\n        There is special handling for values: If it is a single string it is converted to list of one ParameterValue\n        But if it is a list of strings is regarded as a list of values and is converted to a list of ParameterValues\n    \"\"\"\n    values = param_dict.get('values', [])\n    # special handling when only one value present - convert to list of 1\n    if isinstance(values, str):\n        values = [values]\n        param_dict['values'] = values\n    if 'select' in param_dict and 'how_many' in param_dict['select']:\n        count_str = param_dict['select']['how_many']\n        how_many = ModelUtils._string_to_howmany(count_str)\n        if how_many is None:\n            raise TrestleError(f'Unrecognized HowMany value {how_many} in Parameter: should be one-or-more or one.')\n        param_dict['select']['how_many'] = how_many\n        if how_many == const.ONE and len(values) &gt; 1:\n            logger.warning(f'Parameter specifies HowMany=1 but has {len(values)} values given.')\n        choices = param_dict['select'].get('choice', [])\n        if choices and values:\n            for value in values:\n                if value not in choices:\n                    logger.warning(f\"Parameter {param_dict['id']} has value \\\"{value}\\\" not in choices: {choices}.\")\n    props = param_dict.get('props', [])\n    if const.DISPLAY_NAME in param_dict:\n        display_name = param_dict.pop(const.DISPLAY_NAME)\n        props.append(common.Property(name=const.DISPLAY_NAME, value=display_name, ns=const.TRESTLE_GENERIC_NS))\n    if const.AGGREGATES in param_dict:\n        # removing aggregates as this is prop just informative in markdown\n        param_dict.pop(const.AGGREGATES)\n    param_value_origin = None\n    if const.PARAM_VALUE_ORIGIN in param_dict:\n        param_value_origin = param_dict.pop(const.PARAM_VALUE_ORIGIN)\n        if param_value_origin is not None:\n            props.append(common.Property(name=const.PARAM_VALUE_ORIGIN, value=param_value_origin))\n        else:\n            raise TrestleError(\n                f'Parameter value origin property for parameter {param_dict[\"id\"]}'\n                'is None and it should have a value'\n            )\n    if const.ALT_IDENTIFIER in param_dict:\n        # removing alt-identifier as this is prop just informative in markdown\n        param_dict.pop(const.ALT_IDENTIFIER)\n\n    if 'ns' in param_dict:\n        param_dict.pop('ns')\n    param = common.Parameter(**param_dict)\n    param.props = none_if_empty(props)\n    return param\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.fields_set_non_none","title":"<code>fields_set_non_none(obj)</code>  <code>staticmethod</code>","text":"<p>Find the fields set with Nones and empty items removed.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef fields_set_non_none(obj: BaseModel) -&gt; Set[str]:\n    \"\"\"Find the fields set with Nones and empty items removed.\"\"\"\n    return set(as_filtered_list(list(obj.__fields_set__), lambda f: getattr(obj, f)))\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.find_uuid_refs","title":"<code>find_uuid_refs(object_of_interest)</code>  <code>staticmethod</code>","text":"<p>Find uuid references made in prose and links.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef find_uuid_refs(object_of_interest: BaseModel) -&gt; Set[str]:\n    \"\"\"Find uuid references made in prose and links.\"\"\"\n    # hrefs have form #foo or #uuid\n    uuid_strs = ModelUtils.find_values_by_name(object_of_interest, 'href')\n\n    # prose has uuid refs in markdown form: [foo](#bar) or [foo](#uuid)\n    prose_list = ModelUtils.find_values_by_name(object_of_interest, 'prose')\n    for prose in prose_list:\n        matches = re.findall(const.MARKDOWN_URL_REGEX, prose)\n        # the [1] is to extract the inner of 3 capture patterns\n        new_uuids = [match[1] for match in matches]\n        uuid_strs.extend(new_uuids)\n\n    # collect the strings that start with # and are potential uuids\n    uuid_strs = [uuid_str for uuid_str in uuid_strs if uuid_str and uuid_str[0] == '#']\n\n    # go through all matches and build set of those that are uuids\n    uuid_set = {uuid_match for uuid_str in uuid_strs for uuid_match in re.findall(const.UUID_REGEX, uuid_str[1:])}\n    return uuid_set\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.find_values_by_name","title":"<code>find_values_by_name(object_of_interest, name_of_interest)</code>  <code>staticmethod</code>","text":"<p>Traverse object and return list of values of specified name.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef find_values_by_name(object_of_interest: Any, name_of_interest: str) -&gt; List[Any]:\n    \"\"\"Traverse object and return list of values of specified name.\"\"\"\n    loe = []\n    if isinstance(object_of_interest, BaseModel):\n        value = getattr(object_of_interest, name_of_interest, None)\n        if value is not None:\n            loe.append(value)\n        fields = getattr(object_of_interest, const.FIELDS_SET, None)\n        if fields is not None:\n            for field in fields:\n                loe.extend(\n                    ModelUtils.find_values_by_name(getattr(object_of_interest, field, None), name_of_interest)\n                )\n    elif type(object_of_interest) is list:\n        for item in object_of_interest:\n            loe.extend(ModelUtils.find_values_by_name(item, name_of_interest))\n    elif type(object_of_interest) is dict:\n        if name_of_interest in object_of_interest:\n            loe.append(object_of_interest[name_of_interest])\n        for item in object_of_interest.values():\n            loe.extend(ModelUtils.find_values_by_name(item, name_of_interest))\n    return loe\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.get_all_models","title":"<code>get_all_models(root)</code>  <code>staticmethod</code>","text":"<p>Get list of all models in trestle directory as tuples (model_type, model_name).</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef get_all_models(root: pathlib.Path) -&gt; List[Tuple[str, str]]:\n    \"\"\"Get list of all models in trestle directory as tuples (model_type, model_name).\"\"\"\n    full_list = []\n    for model_type in const.MODEL_TYPE_LIST:\n        models = ModelUtils.get_models_of_type(model_type, root)\n        for m in models:\n            full_list.append((model_type, m))\n    return full_list\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.get_model_path_for_name_and_class","title":"<code>get_model_path_for_name_and_class(trestle_root, model_name, model_class, file_content_type=None)</code>  <code>staticmethod</code>","text":"<p>Find the full path of a model given its name, model type and file content type.</p> <p>If file_content_type is given it will not inspect the file system or confirm the needed path and file exists.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef get_model_path_for_name_and_class(\n    trestle_root: pathlib.Path,\n    model_name: str,\n    model_class: Type[TopLevelOscalModel],\n    file_content_type: Optional[FileContentType] = None\n) -&gt; Optional[pathlib.Path]:\n    \"\"\"\n    Find the full path of a model given its name, model type and file content type.\n\n    If file_content_type is given it will not inspect the file system or confirm the needed path and file exists.\n    \"\"\"\n    if file_content_type is None:\n        root_model_path = ModelUtils._root_path_for_top_level_model(trestle_root, model_name, model_class)\n        file_content_type = FileContentType.path_to_content_type(root_model_path)\n        if not FileContentType.is_readable_file(file_content_type):\n            return None\n\n        return root_model_path.with_suffix(FileContentType.to_file_extension(file_content_type))\n\n    root_path = ModelUtils._root_path_for_top_level_model(trestle_root, model_name, model_class)\n    return root_path.with_suffix(FileContentType.to_file_extension(file_content_type))\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.get_models_of_type","title":"<code>get_models_of_type(model_type, root)</code>  <code>staticmethod</code>","text":"<p>Get list of model names for requested type in trestle directory.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef get_models_of_type(model_type: str, root: pathlib.Path) -&gt; List[str]:\n    \"\"\"Get list of model names for requested type in trestle directory.\"\"\"\n    if model_type not in const.MODEL_TYPE_LIST:\n        raise err.TrestleError(f'Model type {model_type} is not supported')\n    # search relative to project root\n    trestle_root = extract_trestle_project_root(root)\n    if not trestle_root:\n        logger.error(f'Given directory {root} is not within a trestle project.')\n        raise err.TrestleError('Given directory is not within a trestle project.')\n\n    # contruct path to the model file name\n    model_dir_name = ModelUtils.model_type_to_model_dir(model_type)\n    root_model_dir = trestle_root / model_dir_name\n    model_list = []\n    for f in root_model_dir.glob('*/'):\n        # only look for proper json and yaml files\n        if not ModelUtils._should_ignore(f.stem):\n            if not f.is_dir():\n                logger.warning(\n                    f'Ignoring validation of misplaced file {f.name} '\n                    + f'found in the model directory, {model_dir_name}.'\n                )\n            else:\n                model_list.append(f.stem)\n    return model_list\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.get_relative_model_type","title":"<code>get_relative_model_type(relative_path)</code>  <code>staticmethod</code>","text":"<p>Given the relative path of a file with respect to 'trestle_root' return the oscal model type.</p> <p>Parameters:</p> Name Type Description Default <code>relative_path</code> <code>Path</code> <p>Relative path of the model with respect to the root directory of the trestle workspace.</p> required <p>Returns:     Type of Oscal Model for the provided model     Alias of that oscal model.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef get_relative_model_type(relative_path: pathlib.Path) -&gt; Tuple[Type[OscalBaseModel], str]:\n    \"\"\"\n    Given the relative path of a file with respect to 'trestle_root' return the oscal model type.\n\n    Args:\n        relative_path: Relative path of the model with respect to the root directory of the trestle workspace.\n    Returns:\n        Type of Oscal Model for the provided model\n        Alias of that oscal model.\n    \"\"\"\n    if len(relative_path.parts) &lt; 2:\n        raise TrestleError(\n            'Insufficient path length to be a valid relative path w.r.t trestle workspace root directory.'\n        )\n    model_dir = relative_path.parts[0]\n    model_relative_path = pathlib.Path(*relative_path.parts[2:])  # catalogs, profiles, etc\n\n    if model_dir in const.MODEL_DIR_LIST:\n        module_name = const.MODEL_DIR_TO_MODEL_MODULE[model_dir]\n    else:\n        raise TrestleError(f'No valid trestle model type directory (e.g. catalogs) found for {model_dir}.')\n\n    model_type, model_alias = ModelUtils.get_root_model(module_name)\n    full_alias = model_alias\n\n    for index, part in enumerate(model_relative_path.parts):\n        alias = ModelUtils._extract_alias(part)\n        if index &gt; 0 or model_alias != alias:\n            model_alias = alias\n            full_alias = f'{full_alias}.{model_alias}'\n            if utils.is_collection_field_type(model_type):\n                model_type = utils.get_inner_type(model_type)\n            else:\n                model_type = model_type.alias_to_field_map()[alias].outer_type_\n\n    return model_type, full_alias\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.get_root_model","title":"<code>get_root_model(module_name)</code>  <code>staticmethod</code>","text":"<p>Get the root model class and alias based on the module.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef get_root_model(module_name: str) -&gt; Tuple[Type[Any], str]:\n    \"\"\"Get the root model class and alias based on the module.\"\"\"\n    try:\n        module = importlib.import_module(module_name)\n    except ModuleNotFoundError as e:\n        raise err.TrestleError(str(e))\n\n    if hasattr(module, 'Model'):\n        model_metadata = next(iter(module.Model.__fields__.values()))\n        return model_metadata.type_, model_metadata.alias\n    raise err.TrestleError('Invalid module')\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.get_singular_alias","title":"<code>get_singular_alias(alias_path, relative_path=None)</code>  <code>staticmethod</code>","text":"<p>Get the alias in the singular form from a jsonpath.</p> <p>If contextual_mode is True and contextual_path is None, it assumes alias_path is relative to the directory the user is running trestle from.</p> <p>Parameters:</p> Name Type Description Default <code>alias_path</code> <code>str</code> <p>The current alias element path as a string</p> required <code>relative_path</code> <code>Optional[Path]</code> <p>Optional relative path (w.r.t. trestle_root) to cater for relative element paths.</p> <code>None</code> <p>Returns:     Alias as a string</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef get_singular_alias(alias_path: str, relative_path: Optional[pathlib.Path] = None) -&gt; str:\n    \"\"\"\n    Get the alias in the singular form from a jsonpath.\n\n    If contextual_mode is True and contextual_path is None, it assumes alias_path\n    is relative to the directory the user is running trestle from.\n\n    Args:\n        alias_path: The current alias element path as a string\n        relative_path: Optional relative path (w.r.t. trestle_root) to cater for relative element paths.\n    Returns:\n        Alias as a string\n    \"\"\"\n    if len(alias_path.strip()) == 0:\n        raise err.TrestleError(f'Invalid jsonpath {alias_path}')\n\n    singular_alias: str = ''\n\n    full_alias_path = alias_path\n    if relative_path:\n        logger.debug(f'get_singular_alias contextual mode: {str}')\n        _, full_model_alias = ModelUtils.get_relative_model_type(relative_path)\n        first_alias_a = full_model_alias.split('.')[-1]\n        first_alias_b = alias_path.split('.')[0]\n        if first_alias_a == first_alias_b:\n            full_model_alias = '.'.join(full_model_alias.split('.')[:-1])\n        full_alias_path = '.'.join([full_model_alias, alias_path]).strip('.')\n\n    path_parts = full_alias_path.split(const.ALIAS_PATH_SEPARATOR)\n    logger.debug(f'path parts: {path_parts}')\n\n    model_types = []\n\n    root_model_alias = path_parts[0]\n    found = False\n    for module_name in const.MODEL_TYPE_TO_MODEL_MODULE.values():\n        model_type, model_alias = ModelUtils.get_root_model(module_name)\n        if root_model_alias == model_alias:\n            found = True\n            model_types.append(model_type)\n            break\n\n    if not found:\n        raise err.TrestleError(f'{root_model_alias} is an invalid root model alias.')\n\n    if len(path_parts) == 1:\n        return root_model_alias\n\n    model_type = model_types[0]\n    # go through path parts skipping first one\n    for i in range(1, len(path_parts)):\n        if utils.is_collection_field_type(model_type):\n            # if it is a collection type and last part is * then break\n            if i == len(path_parts) - 1 and path_parts[i] == '*':\n                break\n            # otherwise get the inner type of items in the collection\n            model_type = utils.get_inner_type(model_type)\n            # and bump i\n            i = i + 1\n        else:\n            path_part = path_parts[i]\n            field_map = model_type.alias_to_field_map()\n            if path_part not in field_map:\n                continue\n            field = field_map[path_part]\n            model_type = field.outer_type_\n        model_types.append(model_type)\n\n    last_alias = path_parts[-1]\n    if last_alias == '*':\n        last_alias = path_parts[-2]\n\n    # generic model and not list, so return itself fixme doc\n    if not utils.is_collection_field_type(model_type):\n        return last_alias\n\n    parent_model_type = model_types[-2]\n    try:\n        field_map = parent_model_type.alias_to_field_map()\n        field = field_map[last_alias]\n        outer_type = field.outer_type_\n        inner_type = utils.get_inner_type(outer_type)\n        inner_type_name = inner_type.__name__\n        singular_alias = str_utils.classname_to_alias(inner_type_name, AliasMode.JSON)\n    except Exception as e:\n        raise err.TrestleError(f'Error in json path {alias_path}: {e}')\n\n    return singular_alias\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.get_stripped_model_type","title":"<code>get_stripped_model_type(absolute_path, absolute_trestle_root, aliases_not_to_be_stripped=None)</code>  <code>staticmethod</code>","text":"<p>Get the stripped contextual model class and alias based on the contextual path.</p> <p>This function relies on the directory structure of the trestle model being edited to determine, based on the existing files and folder, which fields should be stripped from the model type represented by the path passed in as a parameter.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef get_stripped_model_type(\n    absolute_path: pathlib.Path,\n    absolute_trestle_root: pathlib.Path,\n    aliases_not_to_be_stripped: List[str] = None\n) -&gt; Tuple[Type[OscalBaseModel], str]:\n    \"\"\"\n    Get the stripped contextual model class and alias based on the contextual path.\n\n    This function relies on the directory structure of the trestle model being edited to determine, based on the\n    existing files and folder, which fields should be stripped from the model type represented by the\n    path passed in as a parameter.\n    \"\"\"\n    if aliases_not_to_be_stripped is None:\n        aliases_not_to_be_stripped = []\n    singular_model_type, model_alias = ModelUtils.get_relative_model_type(\n        absolute_path.relative_to(absolute_trestle_root))\n    logger.debug(f'singular model type {singular_model_type} model alias {model_alias}')\n\n    # Stripped models do not apply to collection types such as List[] and Dict{}\n    # if model type is a list or dict, generate a new wrapping model for it\n    if utils.is_collection_field_type(singular_model_type):\n        malias = model_alias.split('.')[-1]\n        class_name = alias_to_classname(malias, AliasMode.JSON)\n        logger.debug(f'collection field type class name {class_name} and alias {malias}')\n        model_type = create_model(class_name, __base__=OscalBaseModel, __root__=(singular_model_type, ...))\n        logger.debug(f'model_type created: {model_type}')\n        return model_type, model_alias\n\n    malias = model_alias.split('.')[-1]\n    logger.debug(f'not collection field type, malias: {malias}')\n    if absolute_path.is_dir() and malias != ModelUtils._extract_alias(absolute_path.name):\n        split_subdir = absolute_path / malias\n    else:\n        split_subdir = absolute_path.parent / absolute_path.with_suffix('').name\n\n    aliases_to_be_stripped = set()\n    if split_subdir.exists():\n        for f in iterdir_without_hidden_files(split_subdir):\n            alias = ModelUtils._extract_alias(f.name)\n            if alias not in aliases_not_to_be_stripped:\n                aliases_to_be_stripped.add(alias)\n\n    logger.debug(f'aliases to be stripped: {aliases_to_be_stripped}')\n    if len(aliases_to_be_stripped) &gt; 0:\n        model_type = singular_model_type.create_stripped_model_type(\n            stripped_fields_aliases=list(aliases_to_be_stripped)\n        )\n        logger.debug(f'model_type: {model_type}')\n        return model_type, model_alias\n    return singular_model_type, model_alias\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.get_title_from_model_uri","title":"<code>get_title_from_model_uri(trestle_root, uri)</code>  <code>staticmethod</code>","text":"<p>Get title from model at uri.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef get_title_from_model_uri(trestle_root: pathlib.Path, uri: str) -&gt; str:\n    \"\"\"Get title from model at uri.\"\"\"\n    try:\n        fetcher = cache.FetcherFactory.get_fetcher(trestle_root, uri)\n        model, _ = fetcher.get_oscal()\n        return model.metadata.title\n    except TrestleError as e:\n        logger.warning(f'Error finding title for model at uri {uri}: {e}')\n        raise\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.has_no_duplicate_values_by_name","title":"<code>has_no_duplicate_values_by_name(object_of_interest, name_of_interest)</code>  <code>staticmethod</code>","text":"<p>Determine if duplicate values of type exist in object.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef has_no_duplicate_values_by_name(object_of_interest: BaseModel, name_of_interest: str) -&gt; bool:\n    \"\"\"Determine if duplicate values of type exist in object.\"\"\"\n    loe = ModelUtils.find_values_by_name(object_of_interest, name_of_interest)\n    set_loe = set(loe)\n    if len(loe) == len(set_loe):\n        return True\n    items: Dict[str, Any] = {}\n    for item in loe:\n        items[item] = items.get(item, 0) + 1\n    # now print items\n    for item, instances in items.items():\n        if instances &gt; 1:\n            logger.warning(f'Duplicate detected of item {item} with {instances} instances.')\n    return False\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.last_modified_at_time","title":"<code>last_modified_at_time(timestamp=None)</code>  <code>staticmethod</code>","text":"<p>Generate a LastModified set to timestamp or now.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef last_modified_at_time(timestamp: Optional[datetime] = None) -&gt; datetime:\n    \"\"\"Generate a LastModified set to timestamp or now.\"\"\"\n    timestamp = timestamp if timestamp else datetime.now().astimezone()\n    return timestamp\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.load_distributed","title":"<code>load_distributed(abs_path, abs_trestle_root, collection_type=None)</code>  <code>staticmethod</code>","text":"<p>Given path to a model, load the model.</p> <p>If the model is decomposed/split/distributed,the decomposed models are loaded recursively.</p> <p>Parameters:</p> Name Type Description Default <code>abs_path</code> <code>Path</code> <p>The path to the file/directory to be loaded.</p> required <code>abs_trestle_root</code> <code>Path</code> <p>The trestle workspace root directory.</p> required <code>collection_type</code> <code>Optional[Type[Any]]</code> <p>The type of collection model, if it is a collection model. typing.List is the only collection type handled or expected. Defaults to None.</p> <code>None</code> <p>Returns:</p> Type Description <code>Type[OscalBaseModel]</code> <p>Return a tuple of Model Type (e.g. class 'trestle.oscal.catalog.Catalog'),</p> <code>str</code> <p>Model Alias (e.g. 'catalog.metadata') and Instance of the Model.</p> <code>Optional[Union[OscalBaseModel, List[OscalBaseModel], Dict[str, OscalBaseModel]]]</code> <p>If the model is decomposed/split/distributed, the instance of the model contains the decomposed models loaded recursively.</p> Note <p>This does not validate the model.  You must either validate the model separately or use the load_validate utilities.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef load_distributed(\n    abs_path: Path,\n    abs_trestle_root: Path,\n    collection_type: Optional[Type[Any]] = None\n) -&gt; Tuple[Type[OscalBaseModel],\n           str,\n           Optional[Union[OscalBaseModel, List[OscalBaseModel], Dict[str, OscalBaseModel]]]]:\n    \"\"\"\n    Given path to a model, load the model.\n\n    If the model is decomposed/split/distributed,the decomposed models are loaded recursively.\n\n    Args:\n        abs_path: The path to the file/directory to be loaded.\n        abs_trestle_root: The trestle workspace root directory.\n        collection_type: The type of collection model, if it is a collection model.\n            typing.List is the only collection type handled or expected.\n            Defaults to None.\n\n    Returns:\n        Return a tuple of Model Type (e.g. class 'trestle.oscal.catalog.Catalog'),\n        Model Alias (e.g. 'catalog.metadata') and Instance of the Model.\n        If the model is decomposed/split/distributed, the instance of the model contains\n            the decomposed models loaded recursively.\n\n    Note:\n        This does not validate the model.  You must either validate the model separately or use the load_validate\n        utilities.\n    \"\"\"\n    # if trying to load file that does not exist, load path instead\n    if not abs_path.exists():\n        abs_path = abs_path.with_name(abs_path.stem)\n\n    if not abs_path.exists():\n        raise TrestleNotFoundError(f'File {abs_path} not found for load.')\n\n    if collection_type:\n        # If the path contains a list type model\n        if collection_type is list:\n            return ModelUtils._load_list(abs_path, abs_trestle_root)\n        # the only other collection type in OSCAL is dict, and it only applies to include_all,\n        # which is too granular ever to be loaded by this routine\n        else:\n            raise TrestleError(f'Collection type {collection_type} not recognized for distributed load.')\n\n    # Get current model\n    primary_model_type, primary_model_alias = ModelUtils.get_stripped_model_type(abs_path, abs_trestle_root)\n    primary_model_instance: Optional[Union[OscalBaseModel, List[OscalBaseModel], Dict[str, OscalBaseModel]]] = None\n\n    # is this an attempt to load an actual json or yaml file?\n    content_type = FileContentType.path_to_content_type(abs_path)\n    # if file is sought but it doesn't exist, ignore and load as decomposed model\n    if FileContentType.is_readable_file(content_type) and abs_path.exists():\n        primary_model_instance = primary_model_type.oscal_read(abs_path)\n    # Is model decomposed?\n    decomposed_dir = abs_path.with_name(abs_path.stem)\n\n    if decomposed_dir.exists():\n        aliases_not_to_be_stripped = []\n        instances_to_be_merged: List[OscalBaseModel] = []\n\n        for local_path in sorted(trestle.common.file_utils.iterdir_without_hidden_files(decomposed_dir)):\n            if local_path.is_file():\n                model_type, model_alias, model_instance = ModelUtils.load_distributed(local_path, abs_trestle_root)\n                aliases_not_to_be_stripped.append(model_alias.split('.')[-1])\n                instances_to_be_merged.append(model_instance)\n\n            elif local_path.is_dir():\n                model_type, model_alias = ModelUtils.get_stripped_model_type(local_path, abs_trestle_root)\n                # Only load the directory if it is a collection model. Otherwise do nothing - it gets loaded when\n                # iterating over the model file\n\n                # If a model is just a container for a list e.g.\n                # class Foo(OscalBaseModel):  noqa: E800\n                #      __root__: List[Bar]    noqa: E800\n                # You need to test whether first a root key exists\n                # then whether the outer_type of root is a collection.\n                # Alternative is to do a try except to avoid the error for an unknown key.\n\n                if model_type.is_collection_container():\n                    # This directory is a decomposed List or Dict\n                    collection_type = model_type.get_collection_type()\n                    model_type, model_alias, model_instance = ModelUtils.load_distributed(local_path,\n                                                                                          abs_trestle_root,\n                                                                                          collection_type)\n                    aliases_not_to_be_stripped.append(model_alias.split('.')[-1])\n                    instances_to_be_merged.append(model_instance)\n        primary_model_dict = {}\n        if primary_model_instance is not None:\n            primary_model_dict = primary_model_instance.__dict__\n\n        merged_model_type, merged_model_alias = ModelUtils.get_stripped_model_type(abs_path,\n                                                                                   abs_trestle_root,\n                                                                                   aliases_not_to_be_stripped)\n\n        # The following use of top_level is to allow loading of a top level model by name only, e.g. MyCatalog\n        # There may be a better overall way to approach this.\n        top_level = len(merged_model_alias.split('.')) == 1\n\n        for i in range(len(aliases_not_to_be_stripped)):\n            alias = aliases_not_to_be_stripped[i]\n            instance = instances_to_be_merged[i]\n            if hasattr(instance, '__dict__') and '__root__' in instance.__dict__ and isinstance(instance,\n                                                                                                OscalBaseModel):\n                instance = instance.__dict__['__root__']\n            if top_level and not primary_model_dict:\n                primary_model_dict = instance.__dict__\n            else:\n                primary_model_dict[alias] = instance\n\n        merged_model_instance = merged_model_type(**primary_model_dict)\n        return merged_model_type, merged_model_alias, merged_model_instance\n    return primary_model_type, primary_model_alias, primary_model_instance\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.load_model_for_class","title":"<code>load_model_for_class(trestle_root, model_name, model_class, file_content_type=None)</code>  <code>staticmethod</code>","text":"<p>Load a model by name and model class and infer file content type if not specified.</p> <p>If you need to load an existing model but its content type may not be known, use this method. But the file content type should be specified if it is somehow known.</p> Note <p>This does not validate the model.  If you want to validate the model use the load_validate utilities.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef load_model_for_class(\n    trestle_root: pathlib.Path,\n    model_name: str,\n    model_class: TG,\n    file_content_type: Optional[FileContentType] = None\n) -&gt; Tuple[TG, pathlib.Path]:\n    \"\"\"Load a model by name and model class and infer file content type if not specified.\n\n    If you need to load an existing model but its content type may not be known, use this method.\n    But the file content type should be specified if it is somehow known.\n\n    Note:\n        This does not validate the model.  If you want to validate the model use the load_validate utilities.\n    \"\"\"\n    root_model_path = ModelUtils._root_path_for_top_level_model(\n        trestle_root, model_name, model_class\n    )  # type: ignore\n    if file_content_type is None:\n        file_content_type = FileContentType.path_to_content_type(root_model_path)\n    if not FileContentType.is_readable_file(file_content_type):\n        raise TrestleError(f'Unable to load model {model_name} without specifying json or yaml.')\n    full_model_path = root_model_path.with_suffix(FileContentType.to_file_extension(file_content_type))\n    _, _, model = ModelUtils.load_distributed(full_model_path, trestle_root)\n    return model, full_model_path  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.load_model_for_type","title":"<code>load_model_for_type(trestle_root, model_type, model_name)</code>  <code>staticmethod</code>","text":"<p>Load model for the given type and name.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef load_model_for_type(trestle_root: pathlib.Path, model_type: str,\n                        model_name: str) -&gt; Tuple[TopLevelOscalModel, pathlib.Path]:\n    \"\"\"Load model for the given type and name.\"\"\"\n    dir_name = ModelUtils.model_type_to_model_dir(model_type)\n    model_path = trestle_root / dir_name / model_name\n\n    if not model_path.exists():\n        raise TrestleError(f'No model is found at path: {model_path}.')\n\n    _, _, oscal_object = ModelUtils.load_distributed(model_path, trestle_root)\n\n    return oscal_object, model_path  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.model_age","title":"<code>model_age(model)</code>  <code>staticmethod</code>","text":"<p>Find time in seconds since LastModified timestamp.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef model_age(model: TopLevelOscalModel) -&gt; int:\n    \"\"\"Find time in seconds since LastModified timestamp.\"\"\"\n    # default to one year if no last_modified\n    age_seconds = const.DAY_SECONDS * 365\n    if model.metadata.last_modified:\n        dt = datetime.now().astimezone() - model.metadata.last_modified\n        age_seconds = dt.seconds\n    return age_seconds\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.model_type_to_model_dir","title":"<code>model_type_to_model_dir(model_type)</code>  <code>staticmethod</code>","text":"<p>Get plural model directory from model type.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef model_type_to_model_dir(model_type: str) -&gt; str:\n    \"\"\"Get plural model directory from model type.\"\"\"\n    if model_type not in const.MODEL_TYPE_LIST:\n        raise err.TrestleError(f'Not a valid model type: {model_type}.')\n    return const.MODEL_TYPE_TO_MODEL_DIR[model_type]\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.models_are_equivalent","title":"<code>models_are_equivalent(model_a, model_b, ignore_all_uuid=False)</code>  <code>staticmethod</code>","text":"<p>Test if models are equivalent except for last modified and possibly uuid.</p> <p>If a model has had uuids regenerated, then all uuids and references to them are updated.  This means that special handling is required if a model has had uuids regenerated - when checking equivalence.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef models_are_equivalent(\n    model_a: Optional[TopLevelOscalModel],\n    model_b: Optional[TopLevelOscalModel],\n    ignore_all_uuid: bool = False\n) -&gt; bool:\n    \"\"\"\n    Test if models are equivalent except for last modified and possibly uuid.\n\n    If a model has had uuids regenerated, then all uuids *and references to them* are updated.  This means that\n    special handling is required if a model has had uuids regenerated - when checking equivalence.\n    \"\"\"\n    uuid_type_list = [\n        common.LastModified,\n        common.LocationUuid,\n        common.PartyUuid,\n        common.RelatedRisk,\n        common.Source,\n        assessment_plan.RelatedObservation,\n        assessment_results.RelatedObservation,\n        poam.RelatedObservation,\n        poam.RelatedObservation1\n    ]\n    type_list = uuid_type_list if ignore_all_uuid else [common.LastModified]\n    return not ModelUtils._objects_differ(model_a, model_b, type_list, ['last_modified'], ignore_all_uuid)\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.parameter_to_dict","title":"<code>parameter_to_dict(obj, partial)</code>  <code>staticmethod</code>","text":"<p>Convert obj to dict containing only string values, storing only the fields that have values set.</p> <p>Parameters:</p> Name Type Description Default <code>obj</code> <code>Union[OscalBaseModel, str]</code> <p>The parameter or its consituent parts in recursive calls</p> required <code>partial</code> <code>bool</code> <p>Whether to convert the entire param or just the parts needed for markdown header</p> required <p>Returns:</p> Type Description <code>Union[str, Dict[str, Any]]</code> <p>The converted parameter as dictionary, with values as None if not present</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef parameter_to_dict(obj: Union[OscalBaseModel, str], partial: bool) -&gt; Union[str, Dict[str, Any]]:\n    \"\"\"\n    Convert obj to dict containing only string values, storing only the fields that have values set.\n\n    Args:\n        obj: The parameter or its consituent parts in recursive calls\n        partial: Whether to convert the entire param or just the parts needed for markdown header\n\n    Returns:\n        The converted parameter as dictionary, with values as None if not present\n    \"\"\"\n    res = ModelUtils._parameter_to_dict_recurse(obj, partial)\n    if 'values' not in res:\n        res['values'] = None  # type: ignore\n    return res\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.regenerate_uuids","title":"<code>regenerate_uuids(object_of_interest)</code>  <code>staticmethod</code>","text":"<p>Regenerate all uuids in object and update corresponding references.</p> <p>Find all dicts with key == 'uuid' and replace the value with a new uuid4. Build a corresponding lookup table as you go, of old:new uuid values. Then make a second pass through the object and replace all string values present in the lookup table with the new value.</p> <p>Parameters:</p> Name Type Description Default <code>object_of_interest</code> <code>Any</code> <p>pydantic.BaseModel, list, dict or str will be updated</p> required <p>Returns:</p> Type Description <code>Any</code> <p>The updated object with new uuid's and refs</p> <code>Dict[str, str]</code> <p>The final lookup table of old:new uuid's</p> <code>int</code> <p>A count of the number of refs that were updated</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef regenerate_uuids(object_of_interest: Any) -&gt; Tuple[Any, Dict[str, str], int]:\n    \"\"\"Regenerate all uuids in object and update corresponding references.\n\n    Find all dicts with key == 'uuid' and replace the value with a new uuid4.\n    Build a corresponding lookup table as you go, of old:new uuid values.\n    Then make a second pass through the object and replace all string values\n    present in the lookup table with the new value.\n\n    Args:\n        object_of_interest: pydantic.BaseModel, list, dict or str will be updated\n\n    Returns:\n        The updated object with new uuid's and refs\n        The final lookup table of old:new uuid's\n        A count of the number of refs that were updated\n    \"\"\"\n    new_object, uuid_lut = ModelUtils._regenerate_uuids_in_place(object_of_interest, {})\n    new_object, n_refs_updated = ModelUtils._update_new_uuid_refs(new_object, uuid_lut)\n    return new_object, uuid_lut, n_refs_updated\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.save_top_level_model","title":"<code>save_top_level_model(model, trestle_root, model_name, file_content_type)</code>  <code>staticmethod</code>","text":"<p>Save a model by name and infer model type by inspection.</p> <p>You don't need to specify the model type (catalog, profile, etc.) but you must specify the file content type. If the model directory does not exist, it is created.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef save_top_level_model(\n    model: TopLevelOscalModel, trestle_root: pathlib.Path, model_name: str, file_content_type: FileContentType\n) -&gt; None:\n    \"\"\"Save a model by name and infer model type by inspection.\n\n    You don't need to specify the model type (catalog, profile, etc.) but you must specify the file content type.\n    If the model directory does not exist, it is created.\n    \"\"\"\n    root_model_path = ModelUtils._root_path_for_top_level_model(trestle_root, model_name, model)\n    full_model_path = root_model_path.with_suffix(FileContentType.to_file_extension(file_content_type))\n    if not full_model_path.parent.exists():\n        full_model_path.parent.mkdir(parents=True, exist_ok=True)\n    model.oscal_write(full_model_path)\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils.ModelUtils.update_last_modified","title":"<code>update_last_modified(model, timestamp=None)</code>  <code>staticmethod</code>","text":"<p>Update the LastModified timestamp in top level model to now.</p> Source code in <code>trestle/common/model_utils.py</code> <pre><code>@staticmethod\ndef update_last_modified(model: TopLevelOscalModel, timestamp: Optional[datetime] = None) -&gt; None:\n    \"\"\"Update the LastModified timestamp in top level model to now.\"\"\"\n    timestamp = timestamp if timestamp else datetime.now().astimezone()\n    model.metadata.last_modified = timestamp\n</code></pre>"},{"location":"reference/API/trestle/common/model_utils/#trestle.common.model_utils-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/str_utils/","title":"trestle.common.str_utils","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils","title":"<code>trestle.common.str_utils</code>","text":"<p>Trestle String Utils.</p>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils-classes","title":"Classes","text":""},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.AliasMode","title":"<code>AliasMode</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Allowed formats for classname alias.</p> <p>Currently there are only two.  If others are added, check they get handled properly in the code.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>class AliasMode(enum.Enum):\n    \"\"\"\n    Allowed formats for classname alias.\n\n    Currently there are only two.  If others are added, check they get handled properly in the code.\n    \"\"\"\n\n    JSON = 1\n    FIELD = 2\n</code></pre>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.AliasMode-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.AliasMode.FIELD","title":"<code>FIELD = 2</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.AliasMode.JSON","title":"<code>JSON = 1</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.alias_to_classname","title":"<code>alias_to_classname(alias, mode)</code>","text":"<p>Return class name based dashed or snake alias.</p> <p>This is applicable creating dynamic wrapper model for a list or dict field.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>def alias_to_classname(alias: str, mode: AliasMode) -&gt; str:\n    \"\"\"\n    Return class name based dashed or snake alias.\n\n    This is applicable creating dynamic wrapper model for a list or dict field.\n    \"\"\"\n    if mode == AliasMode.JSON:\n        return _snake_to_upper_camel(alias.replace('-', '_'))\n    return _snake_to_upper_camel(alias)\n</code></pre>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.as_string","title":"<code>as_string(string_or_none)</code>","text":"<p>Convert string or None to itself or empty string.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>def as_string(string_or_none: Optional[str]) -&gt; str:\n    \"\"\"Convert string or None to itself or empty string.\"\"\"\n    return string_or_none if string_or_none else ''\n</code></pre>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.classname_to_alias","title":"<code>classname_to_alias(classname, mode)</code>","text":"<p>Return oscal key name or field element name based on class name.</p> <p>This is applicable when asking for a singular element.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>def classname_to_alias(classname: str, mode: AliasMode) -&gt; str:\n    \"\"\"\n    Return oscal key name or field element name based on class name.\n\n    This is applicable when asking for a singular element.\n    \"\"\"\n    suffix = classname.split('.')[-1]\n\n    # the alias mode is either json or field - yaml doesn't apply here\n    if mode == AliasMode.JSON:\n        # things like class_ should just be class\n        if suffix[-1] == '_':\n            suffix = suffix[:-1]\n        return _camel_to_dash(suffix).rstrip(string.digits)\n    # else alias mode is field\n    return _camel_to_snake(suffix).rstrip(string.digits)\n</code></pre>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.dash_to_underscore","title":"<code>dash_to_underscore(name)</code>","text":"<p>Convert dash to underscore.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>def dash_to_underscore(name: str) -&gt; str:\n    \"\"\"Convert dash to underscore.\"\"\"\n    return name.replace('-', '_')\n</code></pre>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.spaces_and_caps_to_lower_single_spaces","title":"<code>spaces_and_caps_to_lower_single_spaces(spaced_str)</code>","text":"<p>Convert caps and duplicate spaces to lower with single spaces.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>def spaces_and_caps_to_lower_single_spaces(spaced_str: str) -&gt; str:\n    \"\"\"Convert caps and duplicate spaces to lower with single spaces.\"\"\"\n    single_space = ' '.join(spaced_str.strip().split())\n    return single_space.lower()\n</code></pre>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.spaces_and_caps_to_snake","title":"<code>spaces_and_caps_to_snake(spaced_str)</code>","text":"<p>Convert caps and spaces to snake.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>def spaces_and_caps_to_snake(spaced_str: str) -&gt; str:\n    \"\"\"Convert caps and spaces to snake.\"\"\"\n    underscored = '_'.join(spaced_str.strip().split())\n    return underscored.lower()\n</code></pre>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.string_from_root","title":"<code>string_from_root(item_with_root)</code>","text":"<p>Convert root to string if present.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>def string_from_root(item_with_root: Optional[Any]) -&gt; str:\n    \"\"\"Convert root to string if present.\"\"\"\n    return as_string(item_with_root.__root__) if item_with_root else ''\n</code></pre>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.strip_lower_equals","title":"<code>strip_lower_equals(str_a, str_b)</code>","text":"<p>Safe test of lower string equality allowing Nones.</p> <p>If either argument is None the result is False because the intent is to report if they are equal as actual strings.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>def strip_lower_equals(str_a: Optional[str], str_b: Optional[str]) -&gt; bool:\n    \"\"\"\n    Safe test of lower string equality allowing Nones.\n\n    If either argument is None the result is False because the intent is to report if they are equal as actual strings.\n    \"\"\"\n    if str_a is None or str_b is None:\n        return False\n    return str_a.strip().lower() == str_b.strip().lower()\n</code></pre>"},{"location":"reference/API/trestle/common/str_utils/#trestle.common.str_utils.underscore_to_dash","title":"<code>underscore_to_dash(name)</code>","text":"<p>Convert underscore to dash and drop final dash if present.</p> Source code in <code>trestle/common/str_utils.py</code> <pre><code>def underscore_to_dash(name: str) -&gt; str:\n    \"\"\"Convert underscore to dash and drop final dash if present.\"\"\"\n    converted = name.replace('_', '-')\n    return converted if converted[-1] != '-' else converted[:-1]\n</code></pre>"},{"location":"reference/API/trestle/common/trash/","title":"trestle.common.trash","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash","title":"<code>trestle.common.trash</code>","text":"<p>Trestle trash module.</p>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.TRESTLE_TRASH_DIR","title":"<code>TRESTLE_TRASH_DIR = '.trestle/_trash/'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.TRESTLE_TRASH_DIR_EXT","title":"<code>TRESTLE_TRASH_DIR_EXT = '__bk'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.TRESTLE_TRASH_FILE_EXT","title":"<code>TRESTLE_TRASH_FILE_EXT = '.bk'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/trash/#trestle.common.trash-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.get_trash_root","title":"<code>get_trash_root(path)</code>","text":"<p>Find the trestle trash root path.</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def get_trash_root(path: pathlib.Path) -&gt; Optional[pathlib.Path]:\n    \"\"\"Find the trestle trash root path.\"\"\"\n    if path is None or len(path.parts) &lt;= 0:\n        return None\n\n    current = path\n    while len(current.parts) &gt; 1:  # it must not be the system root directory\n        trash_dir = current / TRESTLE_TRASH_DIR\n        if trash_dir.exists() and trash_dir.is_dir():\n            return trash_dir\n        current = current.parent\n\n    return None\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.has_parent_path","title":"<code>has_parent_path(sub_path, parent_path)</code>","text":"<p>Check if sub_path has the specified parent_dir path.</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def has_parent_path(sub_path: pathlib.Path, parent_path: pathlib.Path) -&gt; bool:\n    \"\"\"Check if sub_path has the specified parent_dir path.\"\"\"\n    # sub_path should be longer than parent path\n    if len(sub_path.parts) &lt; len(parent_path.parts):\n        return False\n\n    for i, part in enumerate(parent_path.parts):\n        if part != sub_path.parts[i]:\n            return False\n    return True\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.recover","title":"<code>recover(dest_content_path, delete_trash=False)</code>","text":"<p>Recover the specified file or directory from the trash directory.</p> <p>dest_content_path: destination content path that needs to be recovered from trash It recovers the latest path content from trash if exists</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def recover(dest_content_path: pathlib.Path, delete_trash: bool = False) -&gt; None:\n    \"\"\"Recover the specified file or directory from the trash directory.\n\n    dest_content_path: destination content path that needs to be recovered from trash\n    It recovers the latest path content from trash if exists\n    \"\"\"\n    if dest_content_path.suffix != '':\n        return recover_file(dest_content_path, delete_trash)\n    return recover_dir(dest_content_path, delete_trash)\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.recover_dir","title":"<code>recover_dir(dest_dir_path, delete_trash=False)</code>","text":"<p>Move the specified dir from the trash directory.</p> <p>dest_dir_path: destination path of the directory inside a trestle workspace</p> <p>It recovers the latest directory and contents from trash if exists</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def recover_dir(dest_dir_path: pathlib.Path, delete_trash: bool = False) -&gt; None:\n    \"\"\"Move the specified dir from the trash directory.\n\n    dest_dir_path: destination path of the directory inside a trestle workspace\n\n    It recovers the latest directory and contents from trash if exists\n    \"\"\"\n    trash_dir_path = to_trash_dir_path(dest_dir_path)\n    if not (trash_dir_path.exists() and trash_dir_path.is_dir()):\n        raise AssertionError(f'Specified path \"{dest_dir_path}\" could not be found in trash')\n\n    # move all files/directories under sub_path\n    for item_path in pathlib.Path.iterdir(trash_dir_path):\n        if item_path.is_file():\n            recover_file(to_origin_file_path(item_path), delete_trash)\n        elif item_path.is_dir():\n            recover_dir(to_origin_dir_path(item_path), delete_trash)\n\n    if delete_trash:\n        trash_dir_path.rmdir()\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.recover_file","title":"<code>recover_file(file_path, delete_trash=False)</code>","text":"<p>Recover the specified file from the trash directory.</p> <p>It recovers the latest file from trash if exists</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def recover_file(file_path: pathlib.Path, delete_trash: bool = False) -&gt; None:\n    \"\"\"Recover the specified file from the trash directory.\n\n    It recovers the latest file from trash if exists\n    \"\"\"\n    trash_file_path = to_trash_file_path(file_path)\n    if not trash_file_path.exists():\n        raise AssertionError(f'Specified path \"{file_path}\" could not be found in trash')\n\n    file_path.parent.mkdir(exist_ok=True, parents=True)\n    copyfile(trash_file_path, file_path)\n\n    if delete_trash:\n        trash_file_path.unlink()\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.store","title":"<code>store(content_path, delete_content=False)</code>","text":"<p>Move the specified file or directory to the trash directory.</p> <p>It overwrites the previous file or directory if exists</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def store(content_path: pathlib.Path, delete_content: bool = False) -&gt; None:\n    \"\"\"Move the specified file or directory to the trash directory.\n\n    It overwrites the previous file or directory if exists\n    \"\"\"\n    if content_path.is_file():\n        return store_file(content_path, delete_content)\n    if content_path.is_dir():\n        return store_dir(content_path, delete_content)\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.store_dir","title":"<code>store_dir(dir_path, delete_source=False)</code>","text":"<p>Move the specified dir to the trash directory.</p> <p>It overwrites the previous directory and contents if exists</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def store_dir(dir_path: pathlib.Path, delete_source: bool = False) -&gt; None:\n    \"\"\"Move the specified dir to the trash directory.\n\n    It overwrites the previous directory and contents if exists\n    \"\"\"\n    if not dir_path.is_dir():\n        raise AssertionError(f'Specified path \"{dir_path}\" is not a dir')\n\n    # move all files/directories under sub_path\n    for item_path in pathlib.Path.iterdir(dir_path):\n        if item_path.is_file():\n            store_file(item_path, delete_source)\n        elif item_path.is_dir():\n            store_dir(item_path, delete_source)\n\n    if delete_source:\n        dir_path.rmdir()\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.store_file","title":"<code>store_file(file_path, delete_source=False)</code>","text":"<p>Move the specified file to the trash directory.</p> <p>It overwrites the previous file if exists</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def store_file(file_path: pathlib.Path, delete_source: bool = False) -&gt; None:\n    \"\"\"Move the specified file to the trash directory.\n\n    It overwrites the previous file if exists\n    \"\"\"\n    if not file_path.is_file():\n        raise AssertionError(f'Specified path \"{file_path}\" is not a file')\n\n    trash_file_path = to_trash_file_path(file_path)\n    trash_file_path.parent.mkdir(exist_ok=True, parents=True)\n    copyfile(file_path, trash_file_path)\n\n    if delete_source:\n        file_path.unlink()\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.to_origin_dir_path","title":"<code>to_origin_dir_path(trash_dir_path)</code>","text":"<p>Convert trash content path to origin path.</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def to_origin_dir_path(trash_dir_path: pathlib.Path) -&gt; pathlib.Path:\n    \"\"\"Convert trash content path to origin path.\"\"\"\n    if trash_dir_path.suffix != '' and trash_dir_path.suffix.endswith(TRESTLE_TRASH_FILE_EXT):\n        raise AssertionError(f'Given path \"{trash_dir_path}\" is a trash file, not a valid trash directory')\n\n    trestle_root = file_utils.extract_trestle_project_root(trash_dir_path)\n    if trestle_root is None:\n        raise AssertionError(f'Directory path \"{trash_dir_path}\" is not in a valid trestle project path')\n\n    trash_root = get_trash_root(trash_dir_path)\n    if trash_root is None:\n        raise AssertionError(f'Directory path \"{trash_dir_path}\" is not in a valid trestle trash path')\n\n    if not has_parent_path(trash_dir_path, trash_root):\n        raise AssertionError(f'Directory path \"{trash_dir_path}\" is not a valid trash dir path')\n\n    relative_path = trash_dir_path.relative_to(str(trash_root))\n\n    origin_path_parts: List[str] = []\n    for item in relative_path.parts:\n        parts = item.split(TRESTLE_TRASH_DIR_EXT)\n        origin_path_parts.append(parts[0])\n\n    origin_relative_path = pathlib.Path('/'.join(origin_path_parts))\n    origin_path = trestle_root / origin_relative_path\n    return origin_path\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.to_origin_file_path","title":"<code>to_origin_file_path(trash_file_path)</code>","text":"<p>Convert trash file path to origin file path.</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def to_origin_file_path(trash_file_path: pathlib.Path) -&gt; pathlib.Path:\n    \"\"\"Convert trash file path to origin file path.\"\"\"\n    if trash_file_path.suffix != TRESTLE_TRASH_FILE_EXT:\n        raise AssertionError(f'File path \"{trash_file_path}\" is not a valid trash file path')\n\n    origin_dir = to_origin_dir_path(trash_file_path.parent)\n    file_parts = trash_file_path.name.split(TRESTLE_TRASH_FILE_EXT)\n    origin_file_path = origin_dir / file_parts[0]\n\n    return origin_file_path\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.to_origin_path","title":"<code>to_origin_path(trash_content_path)</code>","text":"<p>Convert the trash path to origin path.</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def to_origin_path(trash_content_path: pathlib.Path) -&gt; pathlib.Path:\n    \"\"\"Convert the trash path to origin path.\"\"\"\n    if trash_content_path.suffix == TRESTLE_TRASH_FILE_EXT:\n        return to_origin_file_path(trash_content_path)\n    return to_origin_dir_path(trash_content_path)\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.to_trash_dir_path","title":"<code>to_trash_dir_path(dir_path)</code>","text":"<p>Construct the path to the trashed file.</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def to_trash_dir_path(dir_path: pathlib.Path) -&gt; pathlib.Path:\n    \"\"\"Construct the path to the trashed file.\"\"\"\n    absolute_path = dir_path.resolve()\n    root_path = file_utils.extract_trestle_project_root(absolute_path)\n    if root_path is None:\n        raise AssertionError(f'Directory path \"{absolute_path}\" is not in a valid trestle project')\n\n    trestle_trash_path = root_path / TRESTLE_TRASH_DIR\n\n    relative_path = absolute_path.relative_to(str(root_path))\n    if len(relative_path.parts) == 0:\n        trash_dir = trestle_trash_path\n    else:\n        trash_dir = trestle_trash_path / f'{relative_path}{TRESTLE_TRASH_DIR_EXT}'\n\n    return trash_dir\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.to_trash_file_path","title":"<code>to_trash_file_path(file_path)</code>","text":"<p>Construct the path to the trashed file.</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def to_trash_file_path(file_path: pathlib.Path) -&gt; pathlib.Path:\n    \"\"\"Construct the path to the trashed file.\"\"\"\n    trash_file_dir = to_trash_dir_path(file_path.parent)\n    trash_file_path = trash_file_dir / f'{file_path.name}{TRESTLE_TRASH_FILE_EXT}'\n\n    return trash_file_path\n</code></pre>"},{"location":"reference/API/trestle/common/trash/#trestle.common.trash.to_trash_path","title":"<code>to_trash_path(path)</code>","text":"<p>Convert the dir or file path to apporpriate trash file or dir path.</p> Source code in <code>trestle/common/trash.py</code> <pre><code>def to_trash_path(path: pathlib.Path) -&gt; pathlib.Path:\n    \"\"\"Convert the dir or file path to apporpriate trash file or dir path.\"\"\"\n    if path.suffix != '':\n        return to_trash_file_path(path)\n    return to_trash_dir_path(path)\n</code></pre>"},{"location":"reference/API/trestle/common/type_utils/","title":"trestle.common.type_utils","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/common/type_utils/#trestle.common.type_utils","title":"<code>trestle.common.type_utils</code>","text":"<p>Utilities for dealing with models.</p>"},{"location":"reference/API/trestle/common/type_utils/#trestle.common.type_utils-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/common/type_utils/#trestle.common.type_utils.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/common/type_utils/#trestle.common.type_utils-functions","title":"Functions","text":""},{"location":"reference/API/trestle/common/type_utils/#trestle.common.type_utils.get_inner_type","title":"<code>get_inner_type(collection_field_type)</code>","text":"<p>Get the inner model in a generic collection model such as a List or a Dict.</p> <p>For a dict the return type is of the value and not the key.</p> <p>Parameters:</p> Name Type Description Default <code>collection_field_type</code> <code>Union[Type[List[Any]], Type[Dict[str, Any]]]</code> <p>Provided type annotation from a pydantic object</p> required <p>Returns:</p> Type Description <code>Type[Any]</code> <p>The desired type.</p> Source code in <code>trestle/common/type_utils.py</code> <pre><code>def get_inner_type(collection_field_type: Union[Type[List[Any]], Type[Dict[str, Any]]]) -&gt; Type[Any]:\n    \"\"\"Get the inner model in a generic collection model such as a List or a Dict.\n\n    For a dict the return type is of the value and not the key.\n\n    Args:\n        collection_field_type: Provided type annotation from a pydantic object\n\n    Returns:\n        The desired type.\n    \"\"\"\n    try:\n        # Pydantic special cases must be dealt with here:\n        _, _, singular_type = _get_model_field_info(collection_field_type)\n        if singular_type is not None:\n            return singular_type\n        return typing_extensions.get_args(collection_field_type)[-1]\n    except Exception as e:\n        logger.debug(e)\n        raise err.TrestleError('Model type is not a Dict or List') from e\n</code></pre>"},{"location":"reference/API/trestle/common/type_utils/#trestle.common.type_utils.get_origin","title":"<code>get_origin(field_type)</code>","text":"<p>Generalized and robust get_origin function.</p> <p>This function is derived from work by pydantic, however, avoids complications from various python versions.</p> Source code in <code>trestle/common/type_utils.py</code> <pre><code>def get_origin(field_type: Type[Any]) -&gt; Optional[Type[Any]]:\n    \"\"\"Generalized and robust get_origin function.\n\n    This function is derived from work by pydantic, however, avoids complications\n    from various python versions.\n    \"\"\"\n    # This executes a fallback that allows a list to be generated from a constrained list.\n    return typing_extensions.get_origin(field_type) or getattr(field_type, '__origin__', None)\n</code></pre>"},{"location":"reference/API/trestle/common/type_utils/#trestle.common.type_utils.is_collection_field_type","title":"<code>is_collection_field_type(field_type)</code>","text":"<p>Check whether a type hint is a collection type as used by OSCAL.</p> <p>Specifically this is whether the type is a list or not.</p> <p>Parameters:</p> Name Type Description Default <code>field_type</code> <code>Type[Any]</code> <p>A type or a type alias of a field typically as served via pydantic introspection</p> required <p>Returns:</p> Type Description <code>bool</code> <p>True if it is a collection type list.</p> Source code in <code>trestle/common/type_utils.py</code> <pre><code>def is_collection_field_type(field_type: Type[Any]) -&gt; bool:\n    \"\"\"Check whether a type hint is a collection type as used by OSCAL.\n\n    Specifically this is whether the type is a list or not.\n\n    Args:\n        field_type: A type or a type alias of a field typically as served via pydantic introspection\n\n    Returns:\n        True if it is a collection type list.\n    \"\"\"\n    # first check if it is a pydantic __root__ object\n    _, root_type, _ = _get_model_field_info(field_type)\n    if root_type == 'List':\n        return True\n    # Retrieves type from a type annotation\n    origin_type = get_origin(field_type)\n    return origin_type == list\n</code></pre>"},{"location":"reference/API/trestle/core/all_validator/","title":"trestle.core.all_validator","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/all_validator/#trestle.core.all_validator","title":"<code>trestle.core.all_validator</code>","text":"<p>Validate based on all registered validators.</p>"},{"location":"reference/API/trestle/core/all_validator/#trestle.core.all_validator-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/all_validator/#trestle.core.all_validator.AllValidator","title":"<code>AllValidator</code>","text":"<p>               Bases: <code>Validator</code></p> <p>Validator to confirm the model passes all registered validation tests.</p> Source code in <code>trestle/core/all_validator.py</code> <pre><code>class AllValidator(Validator):\n    \"\"\"Validator to confirm the model passes all registered validation tests.\"\"\"\n\n    last_failure_msg: str\n\n    def error_msg(self) -&gt; str:\n        \"\"\"Return information on which validation failed.\"\"\"\n        return self.last_failure_msg\n\n    def model_is_valid(self, model: OscalBaseModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None) -&gt; bool:\n        \"\"\"\n        Validate an oscal model against all available validators in the trestle library.\n\n        args:\n            model: An Oscal model that can be passed to the validator.\n            quiet: Don't report msgs unless invalid.\n\n        returns:\n            True (valid) if the model passed all registered validators.\n        \"\"\"\n        self.last_failure_msg = self.__doc__\n        for val in vfact.validator_factory.get_all():\n            if val != self and not val.model_is_valid(model, quiet, trestle_root):\n                self.last_failure_msg = val.error_msg()\n                return False\n        return True\n</code></pre>"},{"location":"reference/API/trestle/core/all_validator/#trestle.core.all_validator.AllValidator-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/all_validator/#trestle.core.all_validator.AllValidator.last_failure_msg","title":"<code>last_failure_msg: str</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/all_validator/#trestle.core.all_validator.AllValidator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/all_validator/#trestle.core.all_validator.AllValidator.error_msg","title":"<code>error_msg()</code>","text":"<p>Return information on which validation failed.</p> Source code in <code>trestle/core/all_validator.py</code> <pre><code>def error_msg(self) -&gt; str:\n    \"\"\"Return information on which validation failed.\"\"\"\n    return self.last_failure_msg\n</code></pre>"},{"location":"reference/API/trestle/core/all_validator/#trestle.core.all_validator.AllValidator.model_is_valid","title":"<code>model_is_valid(model, quiet, trestle_root=None)</code>","text":"<p>Validate an oscal model against all available validators in the trestle library.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>OscalBaseModel</code> <p>An Oscal model that can be passed to the validator.</p> required <code>quiet</code> <code>bool</code> <p>Don't report msgs unless invalid.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>True (valid) if the model passed all registered validators.</p> Source code in <code>trestle/core/all_validator.py</code> <pre><code>def model_is_valid(self, model: OscalBaseModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None) -&gt; bool:\n    \"\"\"\n    Validate an oscal model against all available validators in the trestle library.\n\n    args:\n        model: An Oscal model that can be passed to the validator.\n        quiet: Don't report msgs unless invalid.\n\n    returns:\n        True (valid) if the model passed all registered validators.\n    \"\"\"\n    self.last_failure_msg = self.__doc__\n    for val in vfact.validator_factory.get_all():\n        if val != self and not val.model_is_valid(model, quiet, trestle_root):\n            self.last_failure_msg = val.error_msg()\n            return False\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/","title":"trestle.core.base_model","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model","title":"<code>trestle.core.base_model</code>","text":"<p>Pydantic base model for use within a trestle workspace and associated configuration.</p> <p>The heart of the current OSCAL model within trestle is based on pydantic (https://pydantic-docs.helpmanual.io/) which itself is a veneer on-top of python data classes.</p> <p>Functionality here defines a base-model which all trestle oscal data models inherit from. This allows additional functionality to be easily inserted.</p> <p>I can write a comment in here and you can even edit on the same line.</p>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel","title":"<code>OscalBaseModel</code>","text":"<p>               Bases: <code>TrestleBaseModel</code></p> <p>Trestle defined pydantic base model for use with OSCAL pydantic dataclasses.</p> <p>This BaseModel provides two types of functionality: 1. Overrides default configuation of the pydantic library with behaviours required for trestle 2. Provides utility functions for trestle which are specific to OSCAL and the naming schema associated with it.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>class OscalBaseModel(TrestleBaseModel):\n    \"\"\"\n    Trestle defined pydantic base model for use with OSCAL pydantic dataclasses.\n\n    This BaseModel provides two types of functionality:\n    1. Overrides default configuation of the pydantic library with behaviours required for trestle\n    2. Provides utility functions for trestle which are specific to OSCAL and the naming schema associated with it.\n    \"\"\"\n\n    class Config:\n        \"\"\"Overriding configuration class for pydantic base model, for use with OSCAL data classes.\"\"\"\n\n        json_loads = orjson.loads\n        # TODO: json_dumps with orjson.dumps see #840\n\n        json_encoders = {datetime.datetime: lambda x: robust_datetime_serialization(x)}\n        allow_population_by_field_name = True\n\n        # Enforce strict schema\n        extra = Extra.forbid\n\n        # Validate on assignment of variables to ensure no escapes\n        validate_assignment = True\n\n    @classmethod\n    def create_stripped_model_type(\n        cls,\n        stripped_fields: Optional[List[str]] = None,\n        stripped_fields_aliases: Optional[List[str]] = None\n    ) -&gt; Type['OscalBaseModel']:\n        \"\"\"Create a pydantic model, which is derived from the current model, but missing certain fields.\n\n        OSCAL mandates a 'strict' schema (e.g. unless otherwise stated no additional fields), and certain fields\n        are mandatory. Given this the corresponding dataclasses are also strict. Workflows with trestle require missing\n        mandatory fields. This allows creation of derivative models missing certain fields.\n\n        Args:\n            stripped_fields: The fields to be removed from the current data class.\n            stripped_fields_aliases: The fields to be removed from the current data class provided by alias.\n\n        Returns:\n            Pydantic data class thta can be used to instanciate a model.\n\n        Raises:\n            TrestleError: If user provided both stripped_fields and stripped_field_aliases or neither.\n            TrestleError: If incorrect aliases or field names are provided.\n        \"\"\"\n        if stripped_fields is not None and stripped_fields_aliases is not None:\n            raise err.TrestleError('Either \"stripped_fields\" or \"stripped_fields_aliases\" need to be passed, not both.')\n        if stripped_fields is None and stripped_fields_aliases is None:\n            raise err.TrestleError('Exactly one of \"stripped_fields\" or \"stripped_fields_aliases\" must be provided')\n\n        # create alias to field_name mapping\n        excluded_fields = []\n        if stripped_fields is not None:\n            excluded_fields = stripped_fields\n        elif stripped_fields_aliases is not None:\n            alias_to_field = cls.alias_to_field_map()\n            try:\n                excluded_fields = [alias_to_field[key].name for key in stripped_fields_aliases]\n            except KeyError as e:\n                raise err.TrestleError(f'Field {str(e)} does not exist in the model')\n\n        current_fields = cls.__fields__\n        new_fields_for_model = {}\n        # Build field list\n        for current_mfield in current_fields.values():\n            if current_mfield.name in excluded_fields:\n                continue\n            # Validate name in the field\n            # Cehcke behaviour with an alias\n            if current_mfield.required:\n                new_fields_for_model[\n                    current_mfield.name\n                ] = (current_mfield.outer_type_, Field(..., title=current_mfield.name, alias=current_mfield.alias))\n            else:\n                new_fields_for_model[current_mfield.name] = (\n                    Optional[current_mfield.outer_type_],\n                    Field(None, title=current_mfield.name, alias=current_mfield.alias)\n                )\n        new_model = create_model(cls.__name__, __base__=OscalBaseModel, **new_fields_for_model)  # type: ignore\n        # TODO: This typing cast should NOT be necessary. Potentially fixable with a fix to pydantic. Issue #175\n        new_model = cast(Type[OscalBaseModel], new_model)\n\n        return new_model\n\n    def get_field_by_alias(self, field_alias: str) -&gt; Any:\n        \"\"\"Convert field alias to a field.\"\"\"\n        attr_field = self.alias_to_field_map().get(field_alias, None)\n        return attr_field\n\n    def get_field_value_by_alias(self, attr_alias: str) -&gt; Optional[Any]:\n        \"\"\"Get attribute value by field alias.\"\"\"\n        # TODO: can this be restricted beyond Any easily.\n        attr_field = self.get_field_by_alias(attr_alias)\n        if isinstance(attr_field, ModelField):\n            return getattr(self, attr_field.name, None)\n\n        return None\n\n    def stripped_instance(\n        self,\n        stripped_fields: Optional[List[str]] = None,\n        stripped_fields_aliases: Optional[List[str]] = None\n    ) -&gt; 'OscalBaseModel':\n        \"\"\"Return a new model instance with the specified fields being stripped.\n\n        Args:\n            stripped_fields: The fields to be removed from the current data class.\n            stripped_fields_aliases: The fields to be removed from the current data class provided by alias.\n\n        Returns:\n            The current datamodel with the fields provided removed in a derivate (run time created) data model.\n\n        Raises:\n            err.TrestleError: If user provided both stripped_fields and stripped_field_aliases or neither.\n            err.TrestleError: If incorrect aliases or field names are provided.\n        \"\"\"\n        # stripped class type\n        stripped_class: Type[OscalBaseModel] = self.create_stripped_model_type(\n            stripped_fields=stripped_fields, stripped_fields_aliases=stripped_fields_aliases\n        )\n\n        # remaining values\n        remaining_values = {}\n        for field in self.__fields__.values():\n            if field.name in stripped_class.__fields__:\n                remaining_values[field.name] = self.__dict__[field.name]\n\n        # create stripped model instance\n        # TODO: Not sure if we can avoid type escapes here\n        stripped_instance = stripped_class(**remaining_values)\n\n        return stripped_instance\n\n    def oscal_dict(self) -&gt; Dict[str, Any]:\n        \"\"\"Return a dictionary including the root wrapping object key.\"\"\"\n        class_name = self.__class__.__name__\n        result = {}\n        raw_dict = self.dict(by_alias=True, exclude_none=True)\n        # Additional check to avoid root serialization\n        if '__root__' in raw_dict.keys():\n            result[classname_to_alias(class_name, AliasMode.JSON)] = raw_dict['__root__']\n        else:\n            result[classname_to_alias(class_name, AliasMode.JSON)] = raw_dict\n        return result\n\n    def oscal_serialize_json_bytes(self, pretty: bool = False, wrapped: bool = True) -&gt; bytes:\n        \"\"\"\n        Return an 'oscal wrapped' json object serialized in a compressed form as bytes.\n\n        Args:\n            pretty: Whether or not to pretty-print json output or have in compressed form.\n        Returns:\n            Oscal model serialized to a json object including packaging inside of a single top level key.\n        \"\"\"\n        if wrapped:\n            odict = self.oscal_dict()\n        else:\n            odict = self.dict(by_alias=True, exclude_none=True)\n        if pretty:\n            return orjson.dumps(odict, default=self.__json_encoder__, option=orjson.OPT_INDENT_2)  # type: ignore\n        return orjson.dumps(odict, default=self.__json_encoder__)  # type: ignore\n\n    def oscal_serialize_json(self, pretty: bool = False, wrapped: bool = True) -&gt; str:\n        \"\"\"\n        Return an 'oscal wrapped' json object serialized in a compressed form as bytes.\n\n        Args:\n            pretty: Whether or not to pretty-print json output or have in compressed form.\n        Returns:\n            Oscal model serialized to a json object including packaging inside of a single top level key.\n        \"\"\"\n        # This function is provided for backwards compatibility\n        return self.oscal_serialize_json_bytes(pretty, wrapped).decode(const.FILE_ENCODING)\n\n    def oscal_write(self, path: pathlib.Path) -&gt; None:\n        \"\"\"\n        Write out a pydantic data model in an oscal friendly way.\n\n        OSCAL schema mandates that top level elements are wrapped in a singular\n        json/yaml field. This function handles both json and yaml output as well\n        as formatting of the json.\n\n        Args:\n            path: The output file location for the oscal object.\n\n        Raises:\n            err.TrestleError: If a unknown file extension is provided.\n        \"\"\"\n        content_type = FileContentType.to_content_type(path.suffix)\n        # The output will have \\r\\n newlines on windows and \\n newlines elsewhere\n\n        if content_type == FileContentType.YAML:\n            write_file = pathlib.Path(path).open('w', encoding=const.FILE_ENCODING)\n            yaml = YAML(typ='safe')\n            yaml.dump(yaml.load(self.oscal_serialize_json()), write_file)\n            write_file.flush()\n            write_file.close()\n        elif content_type == FileContentType.JSON:\n            write_file = pathlib.Path(path).open('wb')  # type: ignore\n            write_file.write(self.oscal_serialize_json_bytes(pretty=True))  # type: ignore\n            # Flush / close required (by experience) due to flushing issues in tests.\n            write_file.flush()\n            write_file.close()\n\n    @classmethod\n    def oscal_read(cls, path: pathlib.Path) -&gt; Optional['OscalBaseModel']:\n        \"\"\"\n        Read OSCAL objects.\n\n        Handles the fact OSCAL wraps top level elements and also deals with both yaml and json.\n\n        Args:\n            path: The path of the oscal object to read.\n        Returns:\n            The oscal object read into trestle oscal models.\n        \"\"\"\n        # Create the wrapper model.\n        alias = classname_to_alias(cls.__name__, AliasMode.JSON)\n\n        content_type = FileContentType.to_content_type(path.suffix)\n        logger.debug(f'oscal_read content type {content_type} and alias {alias} from {path}')\n\n        if not path.exists():\n            logger.warning(f'path does not exist in oscal_read: {path}')\n            return None\n\n        obj: Dict[str, Any] = {}\n        try:\n            if content_type == FileContentType.YAML:\n                yaml = YAML(typ='safe')\n                fh = path.open('r', encoding=const.FILE_ENCODING)\n                obj = yaml.load(fh)\n                fh.close()\n            elif content_type == FileContentType.JSON:\n                obj = load_file(\n                    path,\n                    json_loads=cls.__config__.json_loads,\n                )\n        except Exception as e:\n            raise err.TrestleError(f'Error loading file {path} {str(e)}')\n        try:\n            if not len(obj) == 1:\n                raise err.TrestleError(\n                    f'Invalid OSCAL file structure, oscal file '\n                    f'does not have a single top level key wrapping it. It has {len(obj)} keys.'\n                )\n            parsed = cls.parse_obj(obj[alias])\n        except KeyError:\n            raise err.TrestleError(f'Provided oscal file does not have top level key key: {alias}')\n        except Exception as e:\n            raise err.TrestleError(f'Error parsing file {path} {str(e)}')\n\n        return parsed\n\n    def copy_to(self, new_oscal_type: Type['OscalBaseModel']) -&gt; 'OscalBaseModel':\n        \"\"\"\n        Opportunistic copy operation between similar types of data classes.\n\n        Due to the way in which oscal is constructed we get a set of similar / the same definition across various\n        oscal models. Due to the lack of guarantees that they are the same we cannot easily 'collapse' the mode.\n\n        Args:\n            new_oscal_type: The desired type of oscal model\n\n        Returns:\n            Opportunistic copy of the data into the new model type.\n        \"\"\"\n        logger.debug('Copy to started')\n        if self.__class__.__name__ == new_oscal_type.__name__:\n            logger.debug('Json based copy')\n            # Note: Json based oppportunistic copy\n            # Dev notes: Do not change this from json. Due to enums (in particular) json is the closest we can get.\n            return new_oscal_type.parse_raw(self.oscal_serialize_json(pretty=False, wrapped=False))\n\n        if ('__root__' in self.__fields__ and len(self.__fields__) == 1 and '__root__' in new_oscal_type.__fields__\n                and len(new_oscal_type.__fields__) == 1):\n            logger.debug('Root element based copy too')\n            return new_oscal_type.parse_obj(self.__root__)  # type: ignore\n\n        # bad place here.\n        raise err.TrestleError('Provided inconsistent classes to copy to methodology.')\n\n    def copy_from(self, existing_oscal_object: 'OscalBaseModel') -&gt; None:\n        \"\"\"\n        Copy operation that implicitly does type conversion.\n\n        Typically would\n        be used to set an attribute, however, does not need to be.\n\n        Deals with two scenarios:\n        1) Casting across oscal models of equivalent type. The purpose if this\n        is to cross class spaces.\n\n        2) The same as above where the item is an array style object which does\n        not correctly serialize to a dict.\n\n        3) if the from and 'to' objects are root schema elements the copy operation\n        will copy the root element to the value.\n\n        Args:\n            existing_oscal_object: The oscal object where fields are copied from.\n\n        \"\"\"\n        recast_object = existing_oscal_object.copy_to(self.__class__)\n        for raw_field in self.__dict__:\n            self.__dict__[raw_field] = recast_object.__dict__[raw_field]\n\n    @classmethod\n    def alias_to_field_map(cls) -&gt; Dict[str, ModelField]:\n        \"\"\"Create a map from field alias to field.\n\n        Returns:\n            A dict which has key's of aliases and Fields as values.\n        \"\"\"\n        alias_to_field: Dict[str, ModelField] = {}\n        for field in cls.__fields__.values():\n            alias_to_field[field.alias] = field\n\n        return alias_to_field\n\n    @classmethod\n    def is_collection_container(cls) -&gt; bool:\n        \"\"\"\n        Determine whether a pydantic model has being created to wrap a collection primitive (e.g a list or dict).\n\n        In performing model decomposition it is possible using trestle framework to automatically generate a model\n        which looks like\n\n        class Foo(OscalBaseModel):\n            __root__: List[Bar]\n\n        Returns:\n            Boolean on if it meets the above criteria\n\n        When these cases exist we need special handling of the type information.\n        \"\"\"\n        # Additional sanity check on field length\n        if len(cls.__fields__) == 1 and '__root__' in cls.__fields__:\n            # This is now a __root__ key only model\n            if is_collection_field_type(cls.__fields__['__root__'].outer_type_):\n                return True\n        return False\n\n    @classmethod\n    def get_collection_type(cls) -&gt; Optional[type]:\n        \"\"\"\n        If the type wraps an collection, return the collection type.\n\n        Returns:\n            The collection type.\n\n        Raises:\n            err.TrestleError: if not a wrapper of the collection type.\n        \"\"\"\n        if not cls.is_collection_container():\n            raise err.TrestleError('OscalBaseModel is not wrapping a collection type')\n        return get_origin(cls.__fields__['__root__'].outer_type_)\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.Config","title":"<code>Config</code>","text":"<p>Overriding configuration class for pydantic base model, for use with OSCAL data classes.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>class Config:\n    \"\"\"Overriding configuration class for pydantic base model, for use with OSCAL data classes.\"\"\"\n\n    json_loads = orjson.loads\n    # TODO: json_dumps with orjson.dumps see #840\n\n    json_encoders = {datetime.datetime: lambda x: robust_datetime_serialization(x)}\n    allow_population_by_field_name = True\n\n    # Enforce strict schema\n    extra = Extra.forbid\n\n    # Validate on assignment of variables to ensure no escapes\n    validate_assignment = True\n</code></pre> Attributes\u00a4 <code>allow_population_by_field_name = True</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4 <code>json_encoders = {datetime.datetime: lambda x: robust_datetime_serialization(x)}</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4 <code>json_loads = orjson.loads</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4 <code>validate_assignment = True</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.alias_to_field_map","title":"<code>alias_to_field_map()</code>  <code>classmethod</code>","text":"<p>Create a map from field alias to field.</p> <p>Returns:</p> Type Description <code>Dict[str, ModelField]</code> <p>A dict which has key's of aliases and Fields as values.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>@classmethod\ndef alias_to_field_map(cls) -&gt; Dict[str, ModelField]:\n    \"\"\"Create a map from field alias to field.\n\n    Returns:\n        A dict which has key's of aliases and Fields as values.\n    \"\"\"\n    alias_to_field: Dict[str, ModelField] = {}\n    for field in cls.__fields__.values():\n        alias_to_field[field.alias] = field\n\n    return alias_to_field\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.copy_from","title":"<code>copy_from(existing_oscal_object)</code>","text":"<p>Copy operation that implicitly does type conversion.</p> <p>Typically would be used to set an attribute, however, does not need to be.</p> <p>Deals with two scenarios: 1) Casting across oscal models of equivalent type. The purpose if this is to cross class spaces.</p> <p>2) The same as above where the item is an array style object which does not correctly serialize to a dict.</p> <p>3) if the from and 'to' objects are root schema elements the copy operation will copy the root element to the value.</p> <p>Parameters:</p> Name Type Description Default <code>existing_oscal_object</code> <code>OscalBaseModel</code> <p>The oscal object where fields are copied from.</p> required Source code in <code>trestle/core/base_model.py</code> <pre><code>def copy_from(self, existing_oscal_object: 'OscalBaseModel') -&gt; None:\n    \"\"\"\n    Copy operation that implicitly does type conversion.\n\n    Typically would\n    be used to set an attribute, however, does not need to be.\n\n    Deals with two scenarios:\n    1) Casting across oscal models of equivalent type. The purpose if this\n    is to cross class spaces.\n\n    2) The same as above where the item is an array style object which does\n    not correctly serialize to a dict.\n\n    3) if the from and 'to' objects are root schema elements the copy operation\n    will copy the root element to the value.\n\n    Args:\n        existing_oscal_object: The oscal object where fields are copied from.\n\n    \"\"\"\n    recast_object = existing_oscal_object.copy_to(self.__class__)\n    for raw_field in self.__dict__:\n        self.__dict__[raw_field] = recast_object.__dict__[raw_field]\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.copy_to","title":"<code>copy_to(new_oscal_type)</code>","text":"<p>Opportunistic copy operation between similar types of data classes.</p> <p>Due to the way in which oscal is constructed we get a set of similar / the same definition across various oscal models. Due to the lack of guarantees that they are the same we cannot easily 'collapse' the mode.</p> <p>Parameters:</p> Name Type Description Default <code>new_oscal_type</code> <code>Type[OscalBaseModel]</code> <p>The desired type of oscal model</p> required <p>Returns:</p> Type Description <code>OscalBaseModel</code> <p>Opportunistic copy of the data into the new model type.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>def copy_to(self, new_oscal_type: Type['OscalBaseModel']) -&gt; 'OscalBaseModel':\n    \"\"\"\n    Opportunistic copy operation between similar types of data classes.\n\n    Due to the way in which oscal is constructed we get a set of similar / the same definition across various\n    oscal models. Due to the lack of guarantees that they are the same we cannot easily 'collapse' the mode.\n\n    Args:\n        new_oscal_type: The desired type of oscal model\n\n    Returns:\n        Opportunistic copy of the data into the new model type.\n    \"\"\"\n    logger.debug('Copy to started')\n    if self.__class__.__name__ == new_oscal_type.__name__:\n        logger.debug('Json based copy')\n        # Note: Json based oppportunistic copy\n        # Dev notes: Do not change this from json. Due to enums (in particular) json is the closest we can get.\n        return new_oscal_type.parse_raw(self.oscal_serialize_json(pretty=False, wrapped=False))\n\n    if ('__root__' in self.__fields__ and len(self.__fields__) == 1 and '__root__' in new_oscal_type.__fields__\n            and len(new_oscal_type.__fields__) == 1):\n        logger.debug('Root element based copy too')\n        return new_oscal_type.parse_obj(self.__root__)  # type: ignore\n\n    # bad place here.\n    raise err.TrestleError('Provided inconsistent classes to copy to methodology.')\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.create_stripped_model_type","title":"<code>create_stripped_model_type(stripped_fields=None, stripped_fields_aliases=None)</code>  <code>classmethod</code>","text":"<p>Create a pydantic model, which is derived from the current model, but missing certain fields.</p> <p>OSCAL mandates a 'strict' schema (e.g. unless otherwise stated no additional fields), and certain fields are mandatory. Given this the corresponding dataclasses are also strict. Workflows with trestle require missing mandatory fields. This allows creation of derivative models missing certain fields.</p> <p>Parameters:</p> Name Type Description Default <code>stripped_fields</code> <code>Optional[List[str]]</code> <p>The fields to be removed from the current data class.</p> <code>None</code> <code>stripped_fields_aliases</code> <code>Optional[List[str]]</code> <p>The fields to be removed from the current data class provided by alias.</p> <code>None</code> <p>Returns:</p> Type Description <code>Type[OscalBaseModel]</code> <p>Pydantic data class thta can be used to instanciate a model.</p> <p>Raises:</p> Type Description <code>TrestleError</code> <p>If user provided both stripped_fields and stripped_field_aliases or neither.</p> <code>TrestleError</code> <p>If incorrect aliases or field names are provided.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>@classmethod\ndef create_stripped_model_type(\n    cls,\n    stripped_fields: Optional[List[str]] = None,\n    stripped_fields_aliases: Optional[List[str]] = None\n) -&gt; Type['OscalBaseModel']:\n    \"\"\"Create a pydantic model, which is derived from the current model, but missing certain fields.\n\n    OSCAL mandates a 'strict' schema (e.g. unless otherwise stated no additional fields), and certain fields\n    are mandatory. Given this the corresponding dataclasses are also strict. Workflows with trestle require missing\n    mandatory fields. This allows creation of derivative models missing certain fields.\n\n    Args:\n        stripped_fields: The fields to be removed from the current data class.\n        stripped_fields_aliases: The fields to be removed from the current data class provided by alias.\n\n    Returns:\n        Pydantic data class thta can be used to instanciate a model.\n\n    Raises:\n        TrestleError: If user provided both stripped_fields and stripped_field_aliases or neither.\n        TrestleError: If incorrect aliases or field names are provided.\n    \"\"\"\n    if stripped_fields is not None and stripped_fields_aliases is not None:\n        raise err.TrestleError('Either \"stripped_fields\" or \"stripped_fields_aliases\" need to be passed, not both.')\n    if stripped_fields is None and stripped_fields_aliases is None:\n        raise err.TrestleError('Exactly one of \"stripped_fields\" or \"stripped_fields_aliases\" must be provided')\n\n    # create alias to field_name mapping\n    excluded_fields = []\n    if stripped_fields is not None:\n        excluded_fields = stripped_fields\n    elif stripped_fields_aliases is not None:\n        alias_to_field = cls.alias_to_field_map()\n        try:\n            excluded_fields = [alias_to_field[key].name for key in stripped_fields_aliases]\n        except KeyError as e:\n            raise err.TrestleError(f'Field {str(e)} does not exist in the model')\n\n    current_fields = cls.__fields__\n    new_fields_for_model = {}\n    # Build field list\n    for current_mfield in current_fields.values():\n        if current_mfield.name in excluded_fields:\n            continue\n        # Validate name in the field\n        # Cehcke behaviour with an alias\n        if current_mfield.required:\n            new_fields_for_model[\n                current_mfield.name\n            ] = (current_mfield.outer_type_, Field(..., title=current_mfield.name, alias=current_mfield.alias))\n        else:\n            new_fields_for_model[current_mfield.name] = (\n                Optional[current_mfield.outer_type_],\n                Field(None, title=current_mfield.name, alias=current_mfield.alias)\n            )\n    new_model = create_model(cls.__name__, __base__=OscalBaseModel, **new_fields_for_model)  # type: ignore\n    # TODO: This typing cast should NOT be necessary. Potentially fixable with a fix to pydantic. Issue #175\n    new_model = cast(Type[OscalBaseModel], new_model)\n\n    return new_model\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.get_collection_type","title":"<code>get_collection_type()</code>  <code>classmethod</code>","text":"<p>If the type wraps an collection, return the collection type.</p> <p>Returns:</p> Type Description <code>Optional[type]</code> <p>The collection type.</p> <p>Raises:</p> Type Description <code>TrestleError</code> <p>if not a wrapper of the collection type.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>@classmethod\ndef get_collection_type(cls) -&gt; Optional[type]:\n    \"\"\"\n    If the type wraps an collection, return the collection type.\n\n    Returns:\n        The collection type.\n\n    Raises:\n        err.TrestleError: if not a wrapper of the collection type.\n    \"\"\"\n    if not cls.is_collection_container():\n        raise err.TrestleError('OscalBaseModel is not wrapping a collection type')\n    return get_origin(cls.__fields__['__root__'].outer_type_)\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.get_field_by_alias","title":"<code>get_field_by_alias(field_alias)</code>","text":"<p>Convert field alias to a field.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>def get_field_by_alias(self, field_alias: str) -&gt; Any:\n    \"\"\"Convert field alias to a field.\"\"\"\n    attr_field = self.alias_to_field_map().get(field_alias, None)\n    return attr_field\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.get_field_value_by_alias","title":"<code>get_field_value_by_alias(attr_alias)</code>","text":"<p>Get attribute value by field alias.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>def get_field_value_by_alias(self, attr_alias: str) -&gt; Optional[Any]:\n    \"\"\"Get attribute value by field alias.\"\"\"\n    # TODO: can this be restricted beyond Any easily.\n    attr_field = self.get_field_by_alias(attr_alias)\n    if isinstance(attr_field, ModelField):\n        return getattr(self, attr_field.name, None)\n\n    return None\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.is_collection_container","title":"<code>is_collection_container()</code>  <code>classmethod</code>","text":"<p>Determine whether a pydantic model has being created to wrap a collection primitive (e.g a list or dict).</p> <p>In performing model decomposition it is possible using trestle framework to automatically generate a model which looks like</p> <p>class Foo(OscalBaseModel):     root: List[Bar]</p> <p>Returns:</p> Type Description <code>bool</code> <p>Boolean on if it meets the above criteria</p> <p>When these cases exist we need special handling of the type information.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>@classmethod\ndef is_collection_container(cls) -&gt; bool:\n    \"\"\"\n    Determine whether a pydantic model has being created to wrap a collection primitive (e.g a list or dict).\n\n    In performing model decomposition it is possible using trestle framework to automatically generate a model\n    which looks like\n\n    class Foo(OscalBaseModel):\n        __root__: List[Bar]\n\n    Returns:\n        Boolean on if it meets the above criteria\n\n    When these cases exist we need special handling of the type information.\n    \"\"\"\n    # Additional sanity check on field length\n    if len(cls.__fields__) == 1 and '__root__' in cls.__fields__:\n        # This is now a __root__ key only model\n        if is_collection_field_type(cls.__fields__['__root__'].outer_type_):\n            return True\n    return False\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.oscal_dict","title":"<code>oscal_dict()</code>","text":"<p>Return a dictionary including the root wrapping object key.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>def oscal_dict(self) -&gt; Dict[str, Any]:\n    \"\"\"Return a dictionary including the root wrapping object key.\"\"\"\n    class_name = self.__class__.__name__\n    result = {}\n    raw_dict = self.dict(by_alias=True, exclude_none=True)\n    # Additional check to avoid root serialization\n    if '__root__' in raw_dict.keys():\n        result[classname_to_alias(class_name, AliasMode.JSON)] = raw_dict['__root__']\n    else:\n        result[classname_to_alias(class_name, AliasMode.JSON)] = raw_dict\n    return result\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.oscal_read","title":"<code>oscal_read(path)</code>  <code>classmethod</code>","text":"<p>Read OSCAL objects.</p> <p>Handles the fact OSCAL wraps top level elements and also deals with both yaml and json.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>The path of the oscal object to read.</p> required <p>Returns:     The oscal object read into trestle oscal models.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>@classmethod\ndef oscal_read(cls, path: pathlib.Path) -&gt; Optional['OscalBaseModel']:\n    \"\"\"\n    Read OSCAL objects.\n\n    Handles the fact OSCAL wraps top level elements and also deals with both yaml and json.\n\n    Args:\n        path: The path of the oscal object to read.\n    Returns:\n        The oscal object read into trestle oscal models.\n    \"\"\"\n    # Create the wrapper model.\n    alias = classname_to_alias(cls.__name__, AliasMode.JSON)\n\n    content_type = FileContentType.to_content_type(path.suffix)\n    logger.debug(f'oscal_read content type {content_type} and alias {alias} from {path}')\n\n    if not path.exists():\n        logger.warning(f'path does not exist in oscal_read: {path}')\n        return None\n\n    obj: Dict[str, Any] = {}\n    try:\n        if content_type == FileContentType.YAML:\n            yaml = YAML(typ='safe')\n            fh = path.open('r', encoding=const.FILE_ENCODING)\n            obj = yaml.load(fh)\n            fh.close()\n        elif content_type == FileContentType.JSON:\n            obj = load_file(\n                path,\n                json_loads=cls.__config__.json_loads,\n            )\n    except Exception as e:\n        raise err.TrestleError(f'Error loading file {path} {str(e)}')\n    try:\n        if not len(obj) == 1:\n            raise err.TrestleError(\n                f'Invalid OSCAL file structure, oscal file '\n                f'does not have a single top level key wrapping it. It has {len(obj)} keys.'\n            )\n        parsed = cls.parse_obj(obj[alias])\n    except KeyError:\n        raise err.TrestleError(f'Provided oscal file does not have top level key key: {alias}')\n    except Exception as e:\n        raise err.TrestleError(f'Error parsing file {path} {str(e)}')\n\n    return parsed\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.oscal_serialize_json","title":"<code>oscal_serialize_json(pretty=False, wrapped=True)</code>","text":"<p>Return an 'oscal wrapped' json object serialized in a compressed form as bytes.</p> <p>Parameters:</p> Name Type Description Default <code>pretty</code> <code>bool</code> <p>Whether or not to pretty-print json output or have in compressed form.</p> <code>False</code> <p>Returns:     Oscal model serialized to a json object including packaging inside of a single top level key.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>def oscal_serialize_json(self, pretty: bool = False, wrapped: bool = True) -&gt; str:\n    \"\"\"\n    Return an 'oscal wrapped' json object serialized in a compressed form as bytes.\n\n    Args:\n        pretty: Whether or not to pretty-print json output or have in compressed form.\n    Returns:\n        Oscal model serialized to a json object including packaging inside of a single top level key.\n    \"\"\"\n    # This function is provided for backwards compatibility\n    return self.oscal_serialize_json_bytes(pretty, wrapped).decode(const.FILE_ENCODING)\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.oscal_serialize_json_bytes","title":"<code>oscal_serialize_json_bytes(pretty=False, wrapped=True)</code>","text":"<p>Return an 'oscal wrapped' json object serialized in a compressed form as bytes.</p> <p>Parameters:</p> Name Type Description Default <code>pretty</code> <code>bool</code> <p>Whether or not to pretty-print json output or have in compressed form.</p> <code>False</code> <p>Returns:     Oscal model serialized to a json object including packaging inside of a single top level key.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>def oscal_serialize_json_bytes(self, pretty: bool = False, wrapped: bool = True) -&gt; bytes:\n    \"\"\"\n    Return an 'oscal wrapped' json object serialized in a compressed form as bytes.\n\n    Args:\n        pretty: Whether or not to pretty-print json output or have in compressed form.\n    Returns:\n        Oscal model serialized to a json object including packaging inside of a single top level key.\n    \"\"\"\n    if wrapped:\n        odict = self.oscal_dict()\n    else:\n        odict = self.dict(by_alias=True, exclude_none=True)\n    if pretty:\n        return orjson.dumps(odict, default=self.__json_encoder__, option=orjson.OPT_INDENT_2)  # type: ignore\n    return orjson.dumps(odict, default=self.__json_encoder__)  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.oscal_write","title":"<code>oscal_write(path)</code>","text":"<p>Write out a pydantic data model in an oscal friendly way.</p> <p>OSCAL schema mandates that top level elements are wrapped in a singular json/yaml field. This function handles both json and yaml output as well as formatting of the json.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>The output file location for the oscal object.</p> required <p>Raises:</p> Type Description <code>TrestleError</code> <p>If a unknown file extension is provided.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>def oscal_write(self, path: pathlib.Path) -&gt; None:\n    \"\"\"\n    Write out a pydantic data model in an oscal friendly way.\n\n    OSCAL schema mandates that top level elements are wrapped in a singular\n    json/yaml field. This function handles both json and yaml output as well\n    as formatting of the json.\n\n    Args:\n        path: The output file location for the oscal object.\n\n    Raises:\n        err.TrestleError: If a unknown file extension is provided.\n    \"\"\"\n    content_type = FileContentType.to_content_type(path.suffix)\n    # The output will have \\r\\n newlines on windows and \\n newlines elsewhere\n\n    if content_type == FileContentType.YAML:\n        write_file = pathlib.Path(path).open('w', encoding=const.FILE_ENCODING)\n        yaml = YAML(typ='safe')\n        yaml.dump(yaml.load(self.oscal_serialize_json()), write_file)\n        write_file.flush()\n        write_file.close()\n    elif content_type == FileContentType.JSON:\n        write_file = pathlib.Path(path).open('wb')  # type: ignore\n        write_file.write(self.oscal_serialize_json_bytes(pretty=True))  # type: ignore\n        # Flush / close required (by experience) due to flushing issues in tests.\n        write_file.flush()\n        write_file.close()\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.OscalBaseModel.stripped_instance","title":"<code>stripped_instance(stripped_fields=None, stripped_fields_aliases=None)</code>","text":"<p>Return a new model instance with the specified fields being stripped.</p> <p>Parameters:</p> Name Type Description Default <code>stripped_fields</code> <code>Optional[List[str]]</code> <p>The fields to be removed from the current data class.</p> <code>None</code> <code>stripped_fields_aliases</code> <code>Optional[List[str]]</code> <p>The fields to be removed from the current data class provided by alias.</p> <code>None</code> <p>Returns:</p> Type Description <code>OscalBaseModel</code> <p>The current datamodel with the fields provided removed in a derivate (run time created) data model.</p> <p>Raises:</p> Type Description <code>TrestleError</code> <p>If user provided both stripped_fields and stripped_field_aliases or neither.</p> <code>TrestleError</code> <p>If incorrect aliases or field names are provided.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>def stripped_instance(\n    self,\n    stripped_fields: Optional[List[str]] = None,\n    stripped_fields_aliases: Optional[List[str]] = None\n) -&gt; 'OscalBaseModel':\n    \"\"\"Return a new model instance with the specified fields being stripped.\n\n    Args:\n        stripped_fields: The fields to be removed from the current data class.\n        stripped_fields_aliases: The fields to be removed from the current data class provided by alias.\n\n    Returns:\n        The current datamodel with the fields provided removed in a derivate (run time created) data model.\n\n    Raises:\n        err.TrestleError: If user provided both stripped_fields and stripped_field_aliases or neither.\n        err.TrestleError: If incorrect aliases or field names are provided.\n    \"\"\"\n    # stripped class type\n    stripped_class: Type[OscalBaseModel] = self.create_stripped_model_type(\n        stripped_fields=stripped_fields, stripped_fields_aliases=stripped_fields_aliases\n    )\n\n    # remaining values\n    remaining_values = {}\n    for field in self.__fields__.values():\n        if field.name in stripped_class.__fields__:\n            remaining_values[field.name] = self.__dict__[field.name]\n\n    # create stripped model instance\n    # TODO: Not sure if we can avoid type escapes here\n    stripped_instance = stripped_class(**remaining_values)\n\n    return stripped_instance\n</code></pre>"},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/base_model/#trestle.core.base_model.robust_datetime_serialization","title":"<code>robust_datetime_serialization(input_dt)</code>","text":"<p>Return a nicely formatted string for in a format compatible with OSCAL specifications.</p> <p>Parameters:</p> Name Type Description Default <code>input_dt</code> <code>datetime</code> <p>Input datetime to convert to a string.</p> required <p>Returns:</p> Type Description <code>str</code> <p>String in isoformat to the millisecond enforcing that timezone offset is provided.</p> <p>Raises:</p> Type Description <code>TrestleError</code> <p>Error is raised if datetime object does not contain sufficient timezone information.</p> Source code in <code>trestle/core/base_model.py</code> <pre><code>def robust_datetime_serialization(input_dt: datetime.datetime) -&gt; str:\n    \"\"\"Return a nicely formatted string for in a format compatible with OSCAL specifications.\n\n    Args:\n        input_dt: Input datetime to convert to a string.\n\n    Returns:\n        String in isoformat to the millisecond enforcing that timezone offset is provided.\n\n    Raises:\n        TrestleError: Error is raised if datetime object does not contain sufficient timezone information.\n    \"\"\"\n    # fail if the input datetime is not aware - ie it has no associated timezone\n    if input_dt.tzinfo is None:\n        raise err.TrestleError('Missing timezone in datetime')\n    if input_dt.tzinfo.utcoffset(input_dt) is None:\n        raise err.TrestleError('Missing utcoffset in datetime')\n\n    # use this leave in original timezone rather than utc\n    # return input_dt.astimezone().isoformat(timespec='milliseconds')  noqa: E800\n\n    # force it to be utc\n    return input_dt.astimezone(datetime.timezone.utc).isoformat(timespec='milliseconds')\n</code></pre>"},{"location":"reference/API/trestle/core/catalog_validator/","title":"trestle.core.catalog_validator","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/catalog_validator/#trestle.core.catalog_validator","title":"<code>trestle.core.catalog_validator</code>","text":"<p>Validate catalog by confirming no duplicate param ids.</p>"},{"location":"reference/API/trestle/core/catalog_validator/#trestle.core.catalog_validator-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/catalog_validator/#trestle.core.catalog_validator.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/catalog_validator/#trestle.core.catalog_validator-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/catalog_validator/#trestle.core.catalog_validator.CatalogValidator","title":"<code>CatalogValidator</code>","text":"<p>               Bases: <code>Validator</code></p> <p>Validator to confirm all param ids in catalog are unique.</p> Source code in <code>trestle/core/catalog_validator.py</code> <pre><code>class CatalogValidator(Validator):\n    \"\"\"Validator to confirm all param ids in catalog are unique.\"\"\"\n\n    def model_is_valid(\n        self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n    ) -&gt; bool:\n        \"\"\"\n        Test if the model is valid.\n\n        args:\n            model: A top level OSCAL model.\n            quiet: Don't report msgs unless invalid.\n\n        returns:\n            True (valid) if it is not a catalog, or it is a catalog and its links are 1:1 with resources.\n        \"\"\"\n        if not isinstance(model, Catalog):\n            return True\n        catalog: Catalog = model\n        cat_interface = CatalogInterface(catalog)\n        param_ids = set()\n        for control in cat_interface.get_all_controls_from_dict():\n            for param in as_list(control.params):\n                if param.id in param_ids:\n                    logger.warning(f'Catalog has duplicated parameter id: {param.id} in control {control.id}')\n                    return False\n                param_ids.add(param.id)\n        for param_id in cat_interface.loose_param_dict.keys():\n            if param_id in param_ids:\n                logger.warning(f'Catalog has duplicated parameter id: {param.id} in control {control.id}')\n                return False\n        return True\n</code></pre>"},{"location":"reference/API/trestle/core/catalog_validator/#trestle.core.catalog_validator.CatalogValidator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog_validator/#trestle.core.catalog_validator.CatalogValidator.model_is_valid","title":"<code>model_is_valid(model, quiet, trestle_root=None)</code>","text":"<p>Test if the model is valid.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>TopLevelOscalModel</code> <p>A top level OSCAL model.</p> required <code>quiet</code> <code>bool</code> <p>Don't report msgs unless invalid.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>True (valid) if it is not a catalog, or it is a catalog and its links are 1:1 with resources.</p> Source code in <code>trestle/core/catalog_validator.py</code> <pre><code>def model_is_valid(\n    self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n) -&gt; bool:\n    \"\"\"\n    Test if the model is valid.\n\n    args:\n        model: A top level OSCAL model.\n        quiet: Don't report msgs unless invalid.\n\n    returns:\n        True (valid) if it is not a catalog, or it is a catalog and its links are 1:1 with resources.\n    \"\"\"\n    if not isinstance(model, Catalog):\n        return True\n    catalog: Catalog = model\n    cat_interface = CatalogInterface(catalog)\n    param_ids = set()\n    for control in cat_interface.get_all_controls_from_dict():\n        for param in as_list(control.params):\n            if param.id in param_ids:\n                logger.warning(f'Catalog has duplicated parameter id: {param.id} in control {control.id}')\n                return False\n            param_ids.add(param.id)\n    for param_id in cat_interface.loose_param_dict.keys():\n        if param_id in param_ids:\n            logger.warning(f'Catalog has duplicated parameter id: {param.id} in control {control.id}')\n            return False\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/catalog_validator/#trestle.core.catalog_validator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_context/","title":"trestle.core.control_context","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context","title":"<code>trestle.core.control_context</code>","text":"<p>Provide a context for control operations.</p>"},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ContextPurpose","title":"<code>ContextPurpose</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Specify the modality of the control markdown.</p> Source code in <code>trestle/core/control_context.py</code> <pre><code>class ContextPurpose(Enum):\n    \"\"\"Specify the modality of the control markdown.\"\"\"\n\n    CATALOG = 0\n    COMPONENT = 1\n    PROFILE = 2\n    SSP = 3\n</code></pre>"},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ContextPurpose-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ContextPurpose.CATALOG","title":"<code>CATALOG = 0</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ContextPurpose.COMPONENT","title":"<code>COMPONENT = 1</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ContextPurpose.PROFILE","title":"<code>PROFILE = 2</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ContextPurpose.SSP","title":"<code>SSP = 3</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext","title":"<code>ControlContext</code>  <code>dataclass</code>","text":"<p>Class encapsulating control markdown usage.</p> Source code in <code>trestle/core/control_context.py</code> <pre><code>@dataclass\nclass ControlContext:\n    \"\"\"Class encapsulating control markdown usage.\"\"\"\n\n    purpose: ContextPurpose\n    to_markdown: bool\n    trestle_root: pathlib.Path\n    md_root: pathlib.Path\n    prompt_responses: bool\n    include_all_parts: bool\n    overwrite_header_values: bool\n    set_parameters_flag: bool\n    cli_yaml_header: Optional[Dict[Any, Any]] = None\n    sections_dict: Optional[Dict[str, str]] = None\n    profile: Optional[prof.Profile] = None\n    required_sections: Optional[List[str]] = None\n    allowed_sections: Optional[List[str]] = None\n    comp_def: Optional[comp.ComponentDefinition] = None\n    comp_name: Optional[str] = None\n    component: Optional[comp.DefinedComponent] = None\n    comp_def_name_list: Optional[List[str]] = None\n    inherited_props: Optional[Dict[str, Any]] = None\n    rules_dict: Optional[Dict[str, Dict[str, Any]]] = None\n    rules_params_dict: Optional[Dict[str, Dict[str, Any]]] = None\n    control_implementation: Optional[comp.ControlImplementation] = None\n    uri_name_map: Optional[Dict[str, str]] = None\n    comp_dict: Optional[CompDict] = None\n    merged_header: Optional[Dict[str, Any]] = None\n\n    @classmethod\n    def generate(\n        cls,\n        purpose: ContextPurpose,\n        to_markdown: bool,\n        trestle_root: pathlib.Path,\n        md_root: pathlib.Path,\n        prompt_responses: bool = False,\n        include_all_parts: bool = False,\n        overwrite_header_values: bool = False,\n        set_parameters_flag: bool = False,\n        cli_yaml_header: Optional[Dict[Any, Any]] = None,\n        sections_dict: Optional[Dict[str, str]] = None,\n        profile: Optional[prof.Profile] = None,\n        required_sections: Optional[List[str]] = None,\n        allowed_sections: Optional[List[str]] = None,\n        comp_def: Optional[comp.ComponentDefinition] = None,\n        comp_name: Optional[str] = None,\n        component: Optional[comp.DefinedComponent] = None,\n        comp_def_name_list: Optional[List[str]] = None,\n        inherited_props: Optional[Dict[str, Any]] = None,\n        rules_dict: Optional[Dict[str, Dict[str, Any]]] = None,\n        rules_params_dict: Optional[Dict[str, Dict[str, Any]]] = None,\n        control_implementation: Optional[comp.ControlImplementation] = None,\n        uri_name_map: Optional[Dict[str, str]] = None,\n        comp_dict: Optional[CompDict] = None,\n        merged_header: Optional[Dict[str, Any]] = None\n    ) -&gt; ControlContext:\n        \"\"\"Generate control context of the needed type.\"\"\"\n        context = cls(\n            purpose,\n            to_markdown,\n            trestle_root,\n            md_root,\n            prompt_responses,\n            include_all_parts,\n            overwrite_header_values,\n            set_parameters_flag,\n            cli_yaml_header=cli_yaml_header,\n            sections_dict=sections_dict,\n            profile=profile,\n            required_sections=required_sections,\n            allowed_sections=allowed_sections,\n            comp_def=comp_def,\n            comp_name=comp_name,\n            component=component,\n            comp_def_name_list=comp_def_name_list,\n            inherited_props=inherited_props,\n            rules_dict=rules_dict,\n            rules_params_dict=rules_params_dict,\n            control_implementation=control_implementation,\n            uri_name_map=uri_name_map,\n            comp_dict=comp_dict\n        )\n        context.cli_yaml_header = as_dict(cli_yaml_header)\n        context.sections_dict = as_dict(sections_dict)\n        context.merged_header = as_dict(merged_header)\n        # catalog generate always sets params\n        if to_markdown:\n            context.set_parameters = True\n        return context\n\n    @classmethod\n    def clone(cls, context: ControlContext) -&gt; ControlContext:\n        \"\"\"Create a deep clone of the context without duplicating large objects.\"\"\"\n        new_context = cls(\n            context.purpose,\n            context.to_markdown,\n            context.trestle_root,\n            context.md_root,\n            context.prompt_responses,\n            context.include_all_parts,\n            context.overwrite_header_values,\n            context.set_parameters_flag,\n            cli_yaml_header=copy.deepcopy(context.cli_yaml_header),\n            sections_dict=copy.deepcopy(context.sections_dict),\n            profile=context.profile,\n            required_sections=context.required_sections,\n            allowed_sections=context.allowed_sections,\n            comp_def=context.comp_def,\n            comp_name=context.comp_name,\n            component=context.component,\n            comp_def_name_list=context.comp_def_name_list,\n            inherited_props=copy.deepcopy(context.inherited_props),\n            rules_dict=copy.deepcopy(context.rules_dict),\n            rules_params_dict=copy.deepcopy(context.rules_params_dict),\n            control_implementation=copy.deepcopy(context.control_implementation),\n            uri_name_map=context.uri_name_map,\n            comp_dict=copy.deepcopy(context.comp_dict),\n            merged_header=copy.deepcopy(context.merged_header)\n        )\n        return new_context\n</code></pre>"},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.allowed_sections","title":"<code>allowed_sections: Optional[List[str]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.cli_yaml_header","title":"<code>cli_yaml_header: Optional[Dict[Any, Any]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.comp_def","title":"<code>comp_def: Optional[comp.ComponentDefinition] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.comp_def_name_list","title":"<code>comp_def_name_list: Optional[List[str]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.comp_dict","title":"<code>comp_dict: Optional[CompDict] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.comp_name","title":"<code>comp_name: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.component","title":"<code>component: Optional[comp.DefinedComponent] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.control_implementation","title":"<code>control_implementation: Optional[comp.ControlImplementation] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.include_all_parts","title":"<code>include_all_parts: bool</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.inherited_props","title":"<code>inherited_props: Optional[Dict[str, Any]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.md_root","title":"<code>md_root: pathlib.Path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.merged_header","title":"<code>merged_header: Optional[Dict[str, Any]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.overwrite_header_values","title":"<code>overwrite_header_values: bool</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.profile","title":"<code>profile: Optional[prof.Profile] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.prompt_responses","title":"<code>prompt_responses: bool</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.purpose","title":"<code>purpose: ContextPurpose</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.required_sections","title":"<code>required_sections: Optional[List[str]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.rules_dict","title":"<code>rules_dict: Optional[Dict[str, Dict[str, Any]]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.rules_params_dict","title":"<code>rules_params_dict: Optional[Dict[str, Dict[str, Any]]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.sections_dict","title":"<code>sections_dict: Optional[Dict[str, str]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.set_parameters_flag","title":"<code>set_parameters_flag: bool</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.to_markdown","title":"<code>to_markdown: bool</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.trestle_root","title":"<code>trestle_root: pathlib.Path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.uri_name_map","title":"<code>uri_name_map: Optional[Dict[str, str]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.__init__","title":"<code>__init__(purpose, to_markdown, trestle_root, md_root, prompt_responses, include_all_parts, overwrite_header_values, set_parameters_flag, cli_yaml_header=None, sections_dict=None, profile=None, required_sections=None, allowed_sections=None, comp_def=None, comp_name=None, component=None, comp_def_name_list=None, inherited_props=None, rules_dict=None, rules_params_dict=None, control_implementation=None, uri_name_map=None, comp_dict=None, merged_header=None)</code>","text":""},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.clone","title":"<code>clone(context)</code>  <code>classmethod</code>","text":"<p>Create a deep clone of the context without duplicating large objects.</p> Source code in <code>trestle/core/control_context.py</code> <pre><code>@classmethod\ndef clone(cls, context: ControlContext) -&gt; ControlContext:\n    \"\"\"Create a deep clone of the context without duplicating large objects.\"\"\"\n    new_context = cls(\n        context.purpose,\n        context.to_markdown,\n        context.trestle_root,\n        context.md_root,\n        context.prompt_responses,\n        context.include_all_parts,\n        context.overwrite_header_values,\n        context.set_parameters_flag,\n        cli_yaml_header=copy.deepcopy(context.cli_yaml_header),\n        sections_dict=copy.deepcopy(context.sections_dict),\n        profile=context.profile,\n        required_sections=context.required_sections,\n        allowed_sections=context.allowed_sections,\n        comp_def=context.comp_def,\n        comp_name=context.comp_name,\n        component=context.component,\n        comp_def_name_list=context.comp_def_name_list,\n        inherited_props=copy.deepcopy(context.inherited_props),\n        rules_dict=copy.deepcopy(context.rules_dict),\n        rules_params_dict=copy.deepcopy(context.rules_params_dict),\n        control_implementation=copy.deepcopy(context.control_implementation),\n        uri_name_map=context.uri_name_map,\n        comp_dict=copy.deepcopy(context.comp_dict),\n        merged_header=copy.deepcopy(context.merged_header)\n    )\n    return new_context\n</code></pre>"},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context.ControlContext.generate","title":"<code>generate(purpose, to_markdown, trestle_root, md_root, prompt_responses=False, include_all_parts=False, overwrite_header_values=False, set_parameters_flag=False, cli_yaml_header=None, sections_dict=None, profile=None, required_sections=None, allowed_sections=None, comp_def=None, comp_name=None, component=None, comp_def_name_list=None, inherited_props=None, rules_dict=None, rules_params_dict=None, control_implementation=None, uri_name_map=None, comp_dict=None, merged_header=None)</code>  <code>classmethod</code>","text":"<p>Generate control context of the needed type.</p> Source code in <code>trestle/core/control_context.py</code> <pre><code>@classmethod\ndef generate(\n    cls,\n    purpose: ContextPurpose,\n    to_markdown: bool,\n    trestle_root: pathlib.Path,\n    md_root: pathlib.Path,\n    prompt_responses: bool = False,\n    include_all_parts: bool = False,\n    overwrite_header_values: bool = False,\n    set_parameters_flag: bool = False,\n    cli_yaml_header: Optional[Dict[Any, Any]] = None,\n    sections_dict: Optional[Dict[str, str]] = None,\n    profile: Optional[prof.Profile] = None,\n    required_sections: Optional[List[str]] = None,\n    allowed_sections: Optional[List[str]] = None,\n    comp_def: Optional[comp.ComponentDefinition] = None,\n    comp_name: Optional[str] = None,\n    component: Optional[comp.DefinedComponent] = None,\n    comp_def_name_list: Optional[List[str]] = None,\n    inherited_props: Optional[Dict[str, Any]] = None,\n    rules_dict: Optional[Dict[str, Dict[str, Any]]] = None,\n    rules_params_dict: Optional[Dict[str, Dict[str, Any]]] = None,\n    control_implementation: Optional[comp.ControlImplementation] = None,\n    uri_name_map: Optional[Dict[str, str]] = None,\n    comp_dict: Optional[CompDict] = None,\n    merged_header: Optional[Dict[str, Any]] = None\n) -&gt; ControlContext:\n    \"\"\"Generate control context of the needed type.\"\"\"\n    context = cls(\n        purpose,\n        to_markdown,\n        trestle_root,\n        md_root,\n        prompt_responses,\n        include_all_parts,\n        overwrite_header_values,\n        set_parameters_flag,\n        cli_yaml_header=cli_yaml_header,\n        sections_dict=sections_dict,\n        profile=profile,\n        required_sections=required_sections,\n        allowed_sections=allowed_sections,\n        comp_def=comp_def,\n        comp_name=comp_name,\n        component=component,\n        comp_def_name_list=comp_def_name_list,\n        inherited_props=inherited_props,\n        rules_dict=rules_dict,\n        rules_params_dict=rules_params_dict,\n        control_implementation=control_implementation,\n        uri_name_map=uri_name_map,\n        comp_dict=comp_dict\n    )\n    context.cli_yaml_header = as_dict(cli_yaml_header)\n    context.sections_dict = as_dict(sections_dict)\n    context.merged_header = as_dict(merged_header)\n    # catalog generate always sets params\n    if to_markdown:\n        context.set_parameters = True\n    return context\n</code></pre>"},{"location":"reference/API/trestle/core/control_context/#trestle.core.control_context-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_interface/","title":"trestle.core.control_interface","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface","title":"<code>trestle.core.control_interface</code>","text":"<p>Handle queries and utility operations on controls in memory.</p>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.CompDict","title":"<code>CompDict = Dict[str, Dict[str, ComponentImpInfo]]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ComponentImpInfo","title":"<code>ComponentImpInfo</code>  <code>dataclass</code>","text":"<p>Class to capture component prose and status.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@dataclass\nclass ComponentImpInfo:\n    \"\"\"Class to capture component prose and status.\"\"\"\n\n    prose: str\n    rules: List[str]\n    props: List[common.Property]\n    # the lambda is needed to prevent a mutable from being used as a default\n    # without the lambda it would break python 3.11 and is a bug either way\n    status: common.ImplementationStatus = field(\n        default_factory=lambda: common.ImplementationStatus(state=const.STATUS_OPERATIONAL)\n    )\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ComponentImpInfo-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ComponentImpInfo.props","title":"<code>props: List[common.Property]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ComponentImpInfo.prose","title":"<code>prose: str</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ComponentImpInfo.rules","title":"<code>rules: List[str]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ComponentImpInfo.status","title":"<code>status: common.ImplementationStatus = field(default_factory=lambda: common.ImplementationStatus(state=const.STATUS_OPERATIONAL))</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ComponentImpInfo-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ComponentImpInfo.__init__","title":"<code>__init__(prose, rules, props, status=lambda: common.ImplementationStatus(state=const.STATUS_OPERATIONAL)())</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface","title":"<code>ControlInterface</code>","text":"<p>Class to interact with controls in memory.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>class ControlInterface:\n    \"\"\"Class to interact with controls in memory.\"\"\"\n\n    @staticmethod\n    def _wrap_label(label: str):\n        l_side = r'\\['\n        r_side = r'\\]'\n        wrapped = '' if label == '' else f'{l_side}{label}{r_side}'\n        return wrapped\n\n    @staticmethod\n    def _gap_join(a_str: str, b_str: str) -&gt; str:\n        a_clean = a_str.strip()\n        b_clean = b_str.strip()\n        if not b_clean:\n            return a_clean\n        gap = '\\n\\n' if a_clean else ''\n        return a_clean + gap + b_clean\n\n    @staticmethod\n    def _get_control_section_part(part: common.Part, section_name: str) -&gt; str:\n        \"\"\"Get the prose for a named section in the control.\"\"\"\n        prose = ''\n        if part.name == section_name and part.prose is not None:\n            prose = ControlInterface._gap_join(prose, part.prose)\n        if part.parts:\n            for sub_part in part.parts:\n                prose = ControlInterface._gap_join(\n                    prose, ControlInterface._get_control_section_part(sub_part, section_name)\n                )\n        return prose\n\n    @staticmethod\n    def get_control_section_prose(control: cat.Control, section_name: str) -&gt; str:\n        \"\"\"Get the prose for the control section.\"\"\"\n        prose = ''\n        if control.parts:\n            for part in control.parts:\n                prose = ControlInterface._gap_join(\n                    prose, ControlInterface._get_control_section_part(part, section_name)\n                )\n        return prose\n\n    @staticmethod\n    def _find_section_info(part: common.Part, skip_section_list: List[str]) -&gt; Tuple[str, str, str]:\n        \"\"\"Find section not in list.\"\"\"\n        if part.prose and part.name not in skip_section_list:\n            return part.id, part.name, part.title\n        if part.parts:\n            for sub_part in part.parts:\n                id_, name, title = ControlInterface._find_section_info(sub_part, skip_section_list)\n                if id_:\n                    return id_, name, title\n        return '', '', ''\n\n    @staticmethod\n    def _find_section(control: cat.Control, skip_section_list: List[str]) -&gt; Tuple[str, str, str]:\n        \"\"\"Find next section not in list.\"\"\"\n        if control.parts:\n            for part in control.parts:\n                id_, name, title = ControlInterface._find_section_info(part, skip_section_list)\n                if id_:\n                    return id_, name, title\n        return '', '', ''\n\n    @staticmethod\n    def strip_to_make_ncname(label: str) -&gt; str:\n        \"\"\"Strip chars to conform with NCNAME regex.\"\"\"\n        orig_label = label\n        # make sure first char is allowed\n        while label and label[0] not in const.NCNAME_UTF8_FIRST_CHAR_OPTIONS:\n            label = label[1:]\n        new_label = label[:1]\n        # now check remaining chars\n        if len(label) &gt; 1:\n            for ii in range(1, len(label)):\n                if label[ii] in const.NCNAME_UTF8_OTHER_CHAR_OPTIONS:\n                    new_label += label[ii]\n        # do final check to confirm it is NCNAME\n        match = re.search(const.NCNAME_REGEX, new_label)\n        if not match:\n            raise TrestleError(f'Unable to convert label {orig_label} to NCNAME format.')\n        return new_label\n\n    @staticmethod\n    def get_prop(item: TypeWithProps, prop_name: str, default: Optional[str] = None) -&gt; str:\n        \"\"\"Get the property with that name or return empty string.\"\"\"\n        for prop in as_list(item.props):\n            if prop.name.strip().lower() == prop_name.strip().lower():\n                return prop.value.strip()\n        return default if default else ''\n\n    @staticmethod\n    def _delete_prop(part_control: TypeWithProps, prop_name: str) -&gt; None:\n        \"\"\"Delete property with that name.\"\"\"\n        # assumes at most one instance\n        names = [prop.name for prop in as_list(part_control.props)]\n        if prop_name in names:\n            index = names.index(prop_name)\n            del part_control.props[index]\n        part_control.props = none_if_empty(part_control.props)\n\n    @staticmethod\n    def _replace_prop(part_control: TypeWithProps, new_prop: common.Property) -&gt; None:\n        \"\"\"Delete property with that name if present and insert new one.\"\"\"\n        # assumes at most one instance\n        names = [prop.name for prop in as_list(part_control.props)]\n        if new_prop.name in names:\n            index = names.index(new_prop.name)\n            del part_control.props[index]\n        part_control.props = as_list(part_control.props)\n        part_control.props.append(new_prop)\n\n    @staticmethod\n    def _apply_params_format(param_str: Optional[str], params_format: Optional[str]) -&gt; Optional[str]:\n        if param_str is not None and params_format:\n            if params_format.count('.') &gt; 1:\n                raise TrestleError(\n                    f'Additional text {params_format} '\n                    f'for the parameter format cannot contain multiple dots (.)'\n                )\n            param_str = params_format.replace('.', param_str)\n        return param_str\n\n    @staticmethod\n    def create_statement_id(control_id: str, lower: bool = False) -&gt; str:\n        \"\"\"Create the control statement id from the control id.\"\"\"\n        id_ = f'{control_id}_smt'\n        return id_.lower() if lower else id_\n\n    @staticmethod\n    def get_statement_id(control: cat.Control) -&gt; str:\n        \"\"\"Find the statement id in the control.\"\"\"\n        for part in as_list(control.parts):\n            if part.name == const.STATEMENT:\n                return part.id\n        return ControlInterface.create_statement_id(control.id)\n\n    @staticmethod\n    def get_sort_id(control: cat.Control, allow_none=False) -&gt; Optional[str]:\n        \"\"\"Get the sort-id for the control.\"\"\"\n        for prop in as_list(control.props):\n            if prop.name == const.SORT_ID:\n                return prop.value.strip()\n        return None if allow_none else control.id\n\n    @staticmethod\n    def get_label(item: TypeWithProps) -&gt; str:\n        \"\"\"Get the label from the props of a part or control.\"\"\"\n        return ControlInterface.get_prop(item, 'label')\n\n    @staticmethod\n    def get_part_by_id(item: TypeWithParts, id_: str) -&gt; Optional[common.Part]:\n        \"\"\"Find the part within this item's list of parts that matches id.\"\"\"\n        for part in as_list(item.parts):\n            if part.id == id_:\n                return part\n            deep_part = ControlInterface.get_part_by_id(part, id_)\n            if deep_part:\n                return deep_part\n        return None\n\n    @staticmethod\n    def get_part(part: common.Part, item_type: str, skip_id: Optional[str]) -&gt; List[Union[str, List[str]]]:\n        \"\"\"\n        Find parts with the specified item type, within the given part.\n\n        For a part in a control find the parts in it that match the item_type\n        Return list of string formatted labels and associated descriptive prose\n        \"\"\"\n        items = []\n        if part.name in [const.STATEMENT, item_type]:\n            # the options here are to force the label to be the part.id or the part.label\n            # the label may be of the form (a) while the part.id is ac-1_smt.a.1.a\n            # here we choose the latter and extract the final element\n            label = ControlInterface.get_label(part)\n            label = part.id.split('.')[-1] if not label else label\n            wrapped_label = ControlInterface._wrap_label(label)\n            pad = '' if wrapped_label == '' or not part.prose else ' '\n            prose = '' if part.prose is None else part.prose\n            # top level prose has already been written out, if present\n            # use presence of . in id to tell if this is top level prose\n            if part.id != skip_id:\n                if '\\n*' in prose:\n                    # it is multiline prose\n                    sub_items = []\n                    multi_prose = prose.split('\\n*')\n                    items.append(f'{wrapped_label}{pad}{multi_prose[0]}')\n                    multi_prose.remove(multi_prose[0])\n                    for prose in multi_prose:\n                        sub_items.append(f'{prose}')\n                    items.append(sub_items)\n                else:\n                    items.append(f'{wrapped_label}{pad}{prose}')\n            if part.parts:\n                sub_list = []\n                for prt in part.parts:\n                    sub_list.extend(ControlInterface.get_part(prt, item_type, skip_id))\n                sub_list.append('')\n                items.append(sub_list)\n        return items\n\n    @staticmethod\n    def _get_adds_for_control(profile: prof.Profile, control_id: str) -&gt; List[prof.Add]:\n        \"\"\"Get the adds for a given control id from a profile.\"\"\"\n        adds: List[prof.Add] = []\n        if profile.modify:\n            for alter in as_list(profile.modify.alters):\n                if alter.control_id == control_id:\n                    adds.extend(as_list(alter.adds))\n        return adds\n\n    @staticmethod\n    def get_all_add_info(control_id: str, profile: prof.Profile) -&gt; List[PartInfo]:\n        \"\"\"Get the adds for a control from a profile by control id.\"\"\"\n        part_infos = []\n        for add in ControlInterface._get_adds_for_control(profile, control_id):\n            # add control level props with no name\n            if add.props:\n                smt_part = add.by_id if add.by_id else ''\n                part_infos.append(PartInfo(name='', prose='', smt_part=smt_part, props=add.props))\n            # add part level props with part name\n            for part in as_list(add.parts):\n                subpart_info = ControlInterface._get_part_and_subpart_info(part, add.by_id)\n                part_infos.append(\n                    PartInfo(\n                        name=part.name, prose=part.prose, smt_part=add.by_id, props=part.props, parts=subpart_info\n                    )\n                )\n        return part_infos\n\n    @staticmethod\n    def _get_part_and_subpart_info(part: common.Part, add_by_id: str) -&gt; List[PartInfo]:\n        \"\"\"Get part and its subparts info needed for markdown purposes.\"\"\"\n        part_infos = []\n        for subpart in as_list(part.parts):\n            subpart_info = None\n            if subpart.parts:\n                # Recursively add subparts info\n                subpart_info = ControlInterface._get_part_and_subpart_info(subpart, add_by_id)\n            part_infos.append(\n                PartInfo(\n                    name=subpart.name, prose=subpart.prose, smt_part=add_by_id, props=subpart.props, parts=subpart_info\n                )\n            )\n\n        return part_infos\n\n    @staticmethod\n    def get_section(control: cat.Control, skip_section_list: List[str]) -&gt; Tuple[str, str, str, str]:\n        \"\"\"Get sections that are not in the list.\"\"\"\n        id_, name, title = ControlInterface._find_section(control, skip_section_list)\n        if id_:\n            return id_, name, title, ControlInterface.get_control_section_prose(control, name)\n        return '', '', '', ''\n\n    @staticmethod\n    def get_part_prose(control: cat.Control, part_name: str) -&gt; str:\n        \"\"\"Get the prose for a named part.\"\"\"\n        prose = ''\n        for part in as_list(control.parts):\n            prose += ControlInterface._get_control_section_part(part, part_name)\n        return prose.strip()\n\n    @staticmethod\n    def setparam_to_param(param_id: str, set_param: prof.SetParameter) -&gt; common.Parameter:\n        \"\"\"\n        Convert setparameter to parameter.\n\n        Args:\n            param_id: the id of the parameter\n            set_param: the set_parameter from a profile\n\n        Returns:\n            a Parameter with param_id and content from the SetParameter\n        \"\"\"\n        return common.Parameter(\n            id=param_id, values=set_param.values, select=set_param.select, label=set_param.label, props=set_param.props\n        )\n\n    @staticmethod\n    def uniquify_set_params(set_params: Optional[List[TypeWithParamId]]) -&gt; List[TypeWithParamId]:\n        \"\"\"Remove items with same param_id with priority to later items.\"\"\"\n        found_ids: Set[str] = set()\n        unique_list: List[TypeWithParamId] = []\n        for set_param in reversed(as_list(set_params)):\n            if set_param.param_id not in found_ids:\n                unique_list.append(set_param)\n                found_ids.add(set_param.param_id)\n        return list(reversed(unique_list))\n\n    @staticmethod\n    def get_rules_dict_from_item(item: TypeWithProps) -&gt; Tuple[Dict[str, Dict[str, str]], List[common.Property]]:\n        \"\"\"Get all rules found in this items props.\"\"\"\n        # rules is dict containing rule_id and description\n        rules_dict = {}\n        name = ''\n        desc = ''\n        id_ = ''\n        rules_props = []\n        for prop in as_list(item.props):\n            if prop.name == const.RULE_ID:\n                name = prop.value\n                id_ = prop.remarks\n                rules_props.append(prop)\n            elif prop.name == const.RULE_DESCRIPTION:\n                desc = prop.value\n                rules_props.append(prop)\n            # grab each pair in case there are multiple pairs\n            # then clear and look for new pair\n            if name and desc:\n                rules_dict[id_] = {'name': name, 'description': desc}\n                name = desc = id_ = ''\n        return rules_dict, rules_props\n\n    @staticmethod\n    def item_has_rules(item: TypeWithProps) -&gt; bool:\n        \"\"\"Determine if the item has rules in its props.\"\"\"\n        _, rules_props = ControlInterface.get_rules_dict_from_item(item)\n        return bool(rules_props)\n\n    @staticmethod\n    def get_rule_list_for_item(item: TypeWithProps) -&gt; Tuple[List[str], List[common.Property]]:\n        \"\"\"Get the list of rules applying to this item from its top level props.\"\"\"\n        props = []\n        rule_list = []\n        for prop in as_list(item.props):\n            if prop.name == const.RULE_ID:\n                rule_list.append(prop.value)\n                props.append(prop)\n        return rule_list, props\n\n    @staticmethod\n    def get_rule_list_for_imp_req(\n        imp_req: ossp.ImplementedRequirement\n    ) -&gt; Tuple[List[str], List[str], List[common.Property]]:\n        \"\"\"Get the list of rules applying to an imp_req as two lists.\"\"\"\n        comp_rules, rule_props = ControlInterface.get_rule_list_for_item(imp_req)\n        statement_rules = set()\n        for statement in as_list(imp_req.statements):\n            stat_rules, statement_props = ControlInterface.get_rule_list_for_item(statement)\n            statement_rules.update(stat_rules)\n            rule_props.extend(statement_props)\n        return comp_rules, sorted(statement_rules), rule_props\n\n    @staticmethod\n    def get_params_dict_from_item(item: TypeWithProps) -&gt; Tuple[Dict[str, Dict[str, str]], List[common.Property]]:\n        \"\"\"Get all params found in this item with rule_id as key.\"\"\"\n        # id, description, options - where options is a string containing comma-sep list of items\n        # params is dict with rule_id as key and value contains: param_name, description and choices\n        params: Dict[str, List[Dict[str, str]]] = {}\n        props = []\n        for prop in as_list(item.props):\n            if const.PARAMETER_ID in prop.name:\n                rule_id = prop.remarks\n                param_name = prop.value\n                # rule already exists in parameters dict\n                if rule_id in params.keys():\n                    existing_param = next((prm for prm in params[rule_id] if prm['name'] == param_name), None)\n                    if existing_param is not None:\n                        raise TrestleError(f'Param id for rule {rule_id} already exists')\n                    else:\n                        # append a new parameter for the current rule\n                        params[rule_id].append({'name': param_name})\n                else:\n                    # create new param for this rule for the first parameter\n                    params[rule_id] = [{'name': param_name}]\n                props.append(prop)\n            elif const.PARAMETER_DESCRIPTION in prop.name:\n                rule_id = prop.remarks\n                if rule_id in params:\n                    param = next((prm for prm in params[rule_id] if prm['name'] == param_name), None)\n                    param['description'] = prop.value\n                    props.append(prop)\n                else:\n                    raise TrestleError(f'Param description for rule {rule_id} found with no param_id')\n            elif const.PARAMETER_VALUE_ALTERNATIVES in prop.name:\n                rule_id = prop.remarks\n                if rule_id in params:\n                    param = next((prm for prm in params[rule_id] if prm['name'] == param_name), None)\n                    param['options'] = prop.value\n                    props.append(prop)\n                else:\n                    raise TrestleError(f'Param options for rule {rule_id} found with no param_id')\n        new_params = {}\n        for rule_id, rule_params in params.items():\n            new_params[rule_id] = []\n            for param in rule_params:\n                if 'name' not in param:\n                    logger.warning(f'Parameter for rule_id {rule_id} has no matching name.  Ignoring the param.')\n                else:\n                    param['description'] = param.get('description', '')\n                    param['options'] = param.get('options', '')\n                    new_params[rule_id].append(param)\n        return new_params, props\n\n    @staticmethod\n    def get_rules_and_params_dict_from_item(\n        item: TypeWithProps\n    ) -&gt; Tuple[Dict[str, Dict[str, str]], Dict[str, Dict[str, str]], List[common.Property]]:\n        \"\"\"Get the rule dict and params dict from item with props.\"\"\"\n        rules_dict, rules_props = ControlInterface.get_rules_dict_from_item(item)\n        params_dict, params_props = ControlInterface.get_params_dict_from_item(item)\n        rules_props.extend(params_props)\n        return rules_dict, params_dict, rules_props\n\n    @staticmethod\n    def get_set_params_from_item(\n        item: Union[comp.ControlImplementation, comp.ImplementedRequirement]\n    ) -&gt; Dict[str, comp.SetParameter]:\n        \"\"\"Get set params that have values from control implementation or imp req.\"\"\"\n        return {\n            set_param.param_id: set_param\n            for set_param in as_filtered_list(item.set_parameters, lambda i: i.values)\n        }\n\n    @staticmethod\n    def merge_props(dest: Optional[List[common.Property]],\n                    src: Optional[List[common.Property]]) -&gt; List[common.Property]:\n        \"\"\"Merge a source list of properties into a destination list.\"\"\"\n        if not src:\n            return dest\n        new_props: List[common.Property] = []\n        src_map = {prop.name: prop for prop in src}\n        dest_map = {prop.name: prop for prop in dest}\n        all_names = set(src_map.keys()).union(dest_map.keys())\n        for name in sorted(all_names):\n            if name in src_map and name not in dest_map:\n                new_props.append(src_map[name])\n            elif name in dest_map and name not in src_map:\n                new_props.append(dest_map[name])\n            else:\n                new_prop = dest_map[name]\n                src_prop = src_map[name]\n                new_prop.class_ = src_prop.class_ if src_prop.class_ else new_prop.class_\n                new_prop.ns = src_prop.ns if src_prop.ns else new_prop.ns\n                new_prop.remarks = src_prop.remarks if src_prop.remarks else new_prop.remarks\n                new_prop.uuid = src_prop.uuid if src_prop.uuid else new_prop.uuid\n                new_prop.value = src_prop.value\n                new_props.append(new_prop)\n        return new_props\n\n    @staticmethod\n    def merge_part(dest: common.Part, src: common.Part) -&gt; common.Part:\n        \"\"\"Merge a source part into the destination part.\"\"\"\n        dest.name = src.name if src.name else dest.name\n        dest.ns = src.ns if src.ns else dest.ns\n        dest.props = none_if_empty(ControlInterface.merge_props(dest.props, src.props))\n        dest.prose = src.prose\n        dest.title = src.title if src.title else dest.title\n        ControlInterface.merge_parts(dest, src)\n        return dest\n\n    @staticmethod\n    def merge_parts(dest: TypeWithParts, src: TypeWithParts) -&gt; None:\n        \"\"\"Merge the parts from the source into the destination.\"\"\"\n        if not dest.parts:\n            dest.parts = src.parts\n        elif not src.parts:\n            dest.parts = None\n        else:\n            new_parts: List[common.Part] = []\n            dest_map = {part.id: part for part in dest.parts}\n            for src_part in src.parts:\n                dest_part = dest_map.get(src_part.id, None)\n                if not dest_part:\n                    new_parts.append(src_part)\n                else:\n                    new_part = ControlInterface.merge_part(dest_part, src_part)\n                    if new_part:\n                        new_parts.append(new_part)\n            dest.parts = new_parts\n\n    @staticmethod\n    def merge_dicts_deep(\n        dest: Dict[Any, Any],\n        src: Dict[Any, Any],\n        overwrite_header_values: bool,\n        depth: int = 0,\n        level: int = 0\n    ) -&gt; None:\n        \"\"\"\n        Merge dict src into dest.\n\n        New items are always added from src to dest.\n        Items present in both will be overriden dest if overwrite_header_values is True.\n        \"\"\"\n        if src is None:\n            return\n        for key in src.keys():\n            if key in dest:\n                if depth and level == depth:\n                    if overwrite_header_values:\n                        dest[key] = src[key]\n                    continue\n                # if they are both dicts, recurse\n                if isinstance(dest[key], dict) and isinstance(src[key], dict):\n                    ControlInterface.merge_dicts_deep(dest[key], src[key], overwrite_header_values, depth, level + 1)\n                # if they are both lists, add any item that is not already in the list\n                elif isinstance(dest[key], list) and isinstance(src[key], list):\n                    for item in src[key]:\n                        if item not in dest[key]:\n                            dest[key].append(item)\n                # otherwise override dest if needed\n                elif overwrite_header_values:\n                    dest[key] = src[key]\n            else:\n                # if the item was not already in dest, add it from src\n                dest[key] = src[key]\n\n    @staticmethod\n    def is_withdrawn(control: cat.Control) -&gt; bool:\n        \"\"\"\n        Determine if control is marked Withdrawn.\n\n        Args:\n            control: The control that may be marked withdrawn.\n\n        Returns:\n            True if marked withdrawn, false otherwise.\n\n        This is determined by property with name 'status' with value 'Withdrawn'.\n        \"\"\"\n        for _ in as_filtered_list(\n                control.props,\n                lambda p: strip_lower_equals(p.name, 'status') and strip_lower_equals(p.value, 'withdrawn')):\n            return True\n        return False\n\n    @staticmethod\n    def _setparam_values_as_str(set_param: comp.SetParameter) -&gt; str:\n        \"\"\"Convert values to string.\"\"\"\n        out_str = ''\n        for value in as_list(set_param.values):\n            value_str = string_from_root(value)\n            if value_str:\n                if out_str:\n                    out_str += ', '\n                out_str += value_str\n        return out_str\n\n    @staticmethod\n    def _param_values_as_str_list(param: common.Parameter) -&gt; List[str]:\n        \"\"\"Convert param values to list of strings.\"\"\"\n        return as_list(param.values)\n\n    @staticmethod\n    def _param_values_as_str(param: common.Parameter, brackets=False) -&gt; Optional[str]:\n        \"\"\"Convert param values to string with optional brackets.\"\"\"\n        if not param.values:\n            return None\n        values_str = ', '.join(ControlInterface._param_values_as_str_list(param))\n        return f'[{values_str}]' if brackets else values_str\n\n    @staticmethod\n    def _param_selection_as_str(param: common.Parameter, verbose: bool = False, brackets: bool = False) -&gt; str:\n        \"\"\"Convert parameter selection to str.\"\"\"\n        if param.select and param.select.choice:\n            how_many_str = ''\n            # if all values are specified there is no how_many string and parens are dropped.  See ac-2.2\n            if param.select.how_many:\n                how_many_str = ' (one)' if param.select.how_many == const.ONE else ' (one or more)'\n            choices_str = '; '.join(as_list(param.select.choice))\n            choices_str = f'[{choices_str}]' if brackets else choices_str\n            choices_str = f'Selection{how_many_str}: {choices_str}' if verbose else choices_str\n            return choices_str\n        return ''\n\n    @staticmethod\n    def _param_as_aggregated_value(\n        param: common.Parameter,\n        param_dict: Dict[str, common.Parameter],\n        verbose: bool = False,\n        brackets: bool = False\n    ) -&gt; str:\n        \"\"\"Convert parameter aggregation to str.\"\"\"\n        # review is an aggregated parameter\n        if const.AGGREGATES in [prop.name for prop in as_list(param.props)]:\n            aggregated_values = ''\n            for prop in as_list(param.props):\n                if prop.value not in param_dict:\n                    continue\n                aggregated_values += ', '.join(as_list(param_dict[prop.value].values)) + ', '\n            return aggregated_values[:-2]\n        return ''\n\n    @staticmethod\n    def _param_label_choices_as_str(param: common.Parameter, verbose: bool = False, brackets: bool = False) -&gt; str:\n        \"\"\"Convert param label or choices to string, using choices if present.\"\"\"\n        choices = ControlInterface._param_selection_as_str(param, verbose, brackets)\n        text = choices if choices else param.label\n        text = text if text else param.id\n        return text\n\n    @staticmethod\n    def _param_values_assignment_str(\n        param: common.Parameter,\n        param_dict: Dict[str, common.Parameter],\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; str:\n        \"\"\"Convert param values, label or choices to string.\"\"\"\n        # use values if present\n        param_str = ControlInterface._param_values_as_str(param, False)\n        if param_str and value_assigned_prefix:\n            param_str = f'{value_assigned_prefix} {param_str}'\n        # otherwise use param selection if present\n        if not param_str:\n            param_str = ControlInterface._param_selection_as_str(param, True, False)\n        # otherwise use param aggregated values if present\n        if not param_str:\n            if any(as_list(param_dict[prop.value].values) for prop in as_list(param.props) if prop.value in param_dict):\n                param_str = ControlInterface._param_as_aggregated_value(param, param_dict, True, False)\n        # finally use label and param_id as fallbacks\n        if not param_str:\n            param_str = param.label if param.label else param.id\n            if value_not_assigned_prefix:\n                param_str = f'{value_not_assigned_prefix} {param_str}'\n        return f'{param_str}'\n\n    @staticmethod\n    def _param_labels_assignment_str(\n        param: common.Parameter,\n        label_prefix: Optional[str] = None,\n    ) -&gt; str:\n        \"\"\"Convert param label or choices to string.\"\"\"\n        # use values if present\n        param_str = ControlInterface._param_selection_as_str(param, True, False)\n        # finally use label and param_id as fallbacks\n        if not param_str:\n            param_str = param.label if param.label else param.id\n            if label_prefix:\n                param_str = f'{label_prefix} {param_str}'\n        return f'{param_str}'\n\n    @staticmethod\n    def param_to_str(\n        param: common.Parameter,\n        param_rep: ParameterRep,\n        verbose: bool = False,\n        brackets: bool = False,\n        params_format: Optional[str] = None,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None,\n        param_dict: Dict[str, common.Parameter] = None\n    ) -&gt; Optional[str]:\n        \"\"\"\n        Convert parameter to string based on best available representation.\n\n        Args:\n            param: the parameter to convert\n            param_rep: how to represent the parameter\n            verbose: provide verbose text for selection choices\n            brackets: add brackets around the lists of items\n            params_format: a string containing a single dot that represents a form of highlighting around the param\n            value_assigned_prefix: string to place before the parameter string if a value was assigned\n            value_not_assigned_prefix: string to place before the parameter string if value not assigned\n\n        Returns:\n            formatted string or None\n        \"\"\"\n        param_str = None\n        if param_rep == ParameterRep.VALUE_OR_STRING_NONE:\n            param_str = ControlInterface._param_values_as_str(param)\n            param_str = param_str if param_str else 'None'\n        elif param_rep == ParameterRep.LABEL_OR_CHOICES:\n            param_str = ControlInterface._param_label_choices_as_str(param, verbose, brackets)\n        elif param_rep == ParameterRep.VALUE_OR_LABEL_OR_CHOICES:\n            param_str = ControlInterface._param_values_as_str(param)\n            if not param_str:\n                param_str = ControlInterface._param_label_choices_as_str(param, verbose, brackets)\n        elif param_rep == ParameterRep.VALUE_OR_EMPTY_STRING:\n            param_str = ControlInterface._param_values_as_str(param, brackets)\n            if not param_str:\n                param_str = ''\n        elif param_rep == ParameterRep.ASSIGNMENT_FORM:\n            param_str = ControlInterface._param_values_assignment_str(\n                param, param_dict, value_assigned_prefix, value_not_assigned_prefix\n            )\n            if not param_str:\n                param_str = ''\n        elif param_rep == ParameterRep.LABEL_FORM:\n            param_str = ControlInterface._param_labels_assignment_str(param, value_not_assigned_prefix)\n            if not param_str:\n                param_str = ''\n        return ControlInterface._apply_params_format(param_str, params_format)\n\n    @staticmethod\n    def get_control_param_dict(control: cat.Control, values_only: bool) -&gt; Dict[str, common.Parameter]:\n        \"\"\"\n        Create mapping of param id's to params for params in the control.\n\n        Args:\n            control: the control containing params of interest\n            values_only: only add params to the dict that have actual values\n\n        Returns:\n            Dictionary of param_id mapped to param\n\n        Notes:\n            Warning is given if there is a parameter with no ID\n        \"\"\"\n        param_dict: Dict[str, common.Parameter] = {}\n        for param in as_list(control.params):\n            if not param.id:\n                logger.warning(f'Control {control.id} has parameter with no id.  Ignoring.')\n            if param.values or not values_only:\n                param_dict[param.id] = param\n        return param_dict\n\n    @staticmethod\n    def _replace_ids_with_text(\n        prose: str,\n        param_rep: ParameterRep,\n        param_dict: Dict[str, common.Parameter],\n        params_format: Optional[str] = None,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; str:\n        \"\"\"Find all instances of param_ids in prose and replace each with corresponding parameter representation.\n\n        Need to check all values in dict for a match\n        Reject matches where the string has an adjacent alphanumeric char: param_1 and param_10 or aparam_1\n        \"\"\"\n        for param in param_dict.values():\n            if param.id not in prose:\n                continue\n            # create the replacement text for the param_id\n            param_str = ControlInterface.param_to_str(\n                param, param_rep, False, False, params_format, value_assigned_prefix, value_not_assigned_prefix\n            )\n            # non-capturing groups are odd in re.sub so capture all 3 groups and replace the middle one\n            pattern = r'(^|[^a-zA-Z0-9_])' + param.id + r'($|[^a-zA-Z0-9_])'\n            prose = re.sub(pattern, r'\\1' + param_str + r'\\2', prose)\n        return prose\n\n    @staticmethod\n    def _replace_params(\n        text: str,\n        param_dict: Dict[str, common.Parameter],\n        params_format: Optional[str] = None,\n        param_rep: ParameterRep = ParameterRep.VALUE_OR_LABEL_OR_CHOICES,\n        show_value_warnings: bool = False,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; str:\n        \"\"\"\n        Replace params found in moustaches with values from the param_dict.\n\n        A single line of prose may contain multiple moustaches.\n        \"\"\"\n        # first check if there are any moustache patterns in the text\n        if param_rep == ParameterRep.LEAVE_MOUSTACHE:\n            return text\n        orig_text = text\n        staches: List[str] = re.findall(r'{{.*?}}', text)\n        if not staches:\n            return text\n        # now have list of all staches including braces, e.g. ['{{foo}}', '{{bar}}']\n        # clean the staches so they just have the param ids\n        param_ids = []\n        for stache in staches:\n            # remove braces so these are just param_ids but may have extra chars\n            stache_contents = stache[2:(-2)]\n            param_id = stache_contents.replace('insert: param,', '').strip()\n            param_ids.append(param_id)\n\n        # now replace original stache text with param values\n        for i, _ in enumerate(staches):\n            # A moustache may refer to a param_id not listed in the control's params\n            if param_ids[i] not in param_dict:\n                if show_value_warnings:\n                    logger.warning(f'Control prose references param {param_ids[i]} not set in the control: {staches}')\n            elif param_dict[param_ids[i]] is not None:\n                param = param_dict[param_ids[i]]\n                param_str = ControlInterface.param_to_str(\n                    param,\n                    param_rep,\n                    False,\n                    False,\n                    params_format,\n                    value_assigned_prefix,\n                    value_not_assigned_prefix,\n                    param_dict\n                )\n                text = text.replace(staches[i], param_str, 1).strip()\n                if show_value_warnings and param_rep != ParameterRep.LABEL_OR_CHOICES and not param.values:\n                    # verifies the current parameter is not an aggregated parameter to throw a warning\n                    if const.AGGREGATES not in [prop.name for prop in as_list(param.props)]:\n                        logger.warning(f'Parameter {param_id} has no values and was referenced by prose.')\n            elif show_value_warnings:\n                logger.warning(f'Control prose references param {param_ids[i]} with no specified value.')\n        # there may be staches remaining that we can't replace if not in param_dict\n        if text != orig_text:\n            while True:\n                new_text = ControlInterface._replace_params(\n                    text,\n                    param_dict,\n                    params_format,\n                    param_rep,\n                    show_value_warnings,\n                    value_assigned_prefix,\n                    value_not_assigned_prefix\n                )\n                if new_text == text:\n                    break\n                text = new_text\n        return text\n\n    @staticmethod\n    def _replace_part_prose(\n        control: cat.Control,\n        part: common.Part,\n        param_dict: Dict[str, common.Parameter],\n        params_format: Optional[str] = None,\n        param_rep: ParameterRep = ParameterRep.VALUE_OR_LABEL_OR_CHOICES,\n        show_value_warnings: bool = False,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; None:\n        \"\"\"Replace the part prose according to set_param.\"\"\"\n        if part.prose is not None:\n            fixed_prose = ControlInterface._replace_params(\n                part.prose,\n                param_dict,\n                params_format,\n                param_rep,\n                show_value_warnings,\n                value_assigned_prefix,\n                value_not_assigned_prefix\n            )\n            # change the prose in the control itself\n            part.prose = fixed_prose\n        for prt in as_list(part.parts):\n            ControlInterface._replace_part_prose(\n                control,\n                prt,\n                param_dict,\n                params_format,\n                param_rep,\n                show_value_warnings,\n                value_assigned_prefix,\n                value_not_assigned_prefix\n            )\n        for sub_control in as_list(control.controls):\n            for prt in as_list(sub_control.parts):\n                ControlInterface._replace_part_prose(\n                    sub_control,\n                    prt,\n                    param_dict,\n                    params_format,\n                    param_rep,\n                    show_value_warnings,\n                    value_assigned_prefix,\n                    value_not_assigned_prefix\n                )\n\n    @staticmethod\n    def _replace_param_choices(\n        param: common.Parameter,\n        param_dict: Dict[str, common.Parameter],\n        params_format: Optional[str],\n        param_rep: ParameterRep,\n        show_value_warnings: bool,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; None:\n        \"\"\"Set values for all choices param that refer to params with values.\"\"\"\n        if param.select:\n            new_choices: List[str] = []\n            for choice in as_list(param.select.choice):\n                new_choice = ControlInterface._replace_params(\n                    choice,\n                    param_dict,\n                    params_format,\n                    param_rep,\n                    show_value_warnings,\n                    value_assigned_prefix,\n                    value_not_assigned_prefix\n                )\n                new_choices.append(new_choice)\n            param.select.choice = new_choices\n\n    @staticmethod\n    def replace_control_prose(\n        control: cat.Control,\n        param_dict: Dict[str, common.Parameter],\n        params_format: Optional[str] = None,\n        param_rep: ParameterRep = ParameterRep.VALUE_OR_LABEL_OR_CHOICES,\n        show_value_warnings: bool = False,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; None:\n        \"\"\"Replace the control prose according to set_param.\"\"\"\n        # first replace all choices that reference parameters\n        # note that in ASSIGNMENT_FORM each choice with a parameter will end up as [Assignment: value]\n        for param in as_list(control.params):\n            ControlInterface._replace_param_choices(\n                param,\n                param_dict,\n                params_format,\n                param_rep,\n                show_value_warnings,\n                value_assigned_prefix,\n                value_not_assigned_prefix\n            )\n        for part in as_list(control.parts):\n            if part.prose is not None:\n                fixed_prose = ControlInterface._replace_params(\n                    part.prose,\n                    param_dict,\n                    params_format,\n                    param_rep,\n                    show_value_warnings,\n                    value_assigned_prefix,\n                    value_not_assigned_prefix\n                )\n                # change the prose in the control itself\n                part.prose = fixed_prose\n            for prt in as_list(part.parts):\n                ControlInterface._replace_part_prose(\n                    control,\n                    prt,\n                    param_dict,\n                    params_format,\n                    param_rep,\n                    show_value_warnings,\n                    value_assigned_prefix,\n                    value_not_assigned_prefix\n                )\n\n    @staticmethod\n    def bad_header(header: str) -&gt; bool:\n        \"\"\"Return true if header format is bad.\"\"\"\n        if not header or header[0] != '#':\n            return True\n        n = len(header)\n        if n &lt; 2:\n            return True\n        for ii in range(1, n):\n            if header[ii] == ' ':\n                return False\n            if header[ii] != '#':\n                return True\n        return True\n\n    @staticmethod\n    def get_component_by_name(comp_def: comp.ComponentDefinition, comp_name: str) -&gt; Optional[comp.DefinedComponent]:\n        \"\"\"Get the component with this name from the comp_def.\"\"\"\n        for sub_comp in as_list(comp_def.components):\n            if sub_comp.title == comp_name:\n                return sub_comp\n        return None\n\n    @staticmethod\n    def get_status_from_props(item: TypeWithProps) -&gt; common.ImplementationStatus:\n        \"\"\"Get the status of an item from its props.\"\"\"\n        status = common.ImplementationStatus(state=const.STATUS_PLANNED)\n        for prop in as_list(item.props):\n            if prop.name == const.IMPLEMENTATION_STATUS:\n                status = ControlInterface._prop_as_status(prop)\n                break\n        return status\n\n    @staticmethod\n    def clean_props(\n        props: Optional[List[common.Property]],\n        remove_imp_status: bool = True,\n        remove_all_rule_info: bool = False\n    ) -&gt; List[common.Property]:\n        \"\"\"Remove duplicate props and implementation status.\"\"\"\n        new_props: List[common.Property] = []\n        found_props: Set[Tuple[str, str, str, str]] = set()\n        rule_tag_list = [\n            const.RULE_DESCRIPTION, const.RULE_ID, const.PARAMETER_DESCRIPTION, const.PARAMETER_VALUE_ALTERNATIVES\n        ]\n        # reverse the list so the latest items are kept\n        for prop in reversed(as_list(props)):\n            prop_tuple = (prop.name, as_string(prop.value), as_string(prop.ns), prop.remarks)\n            if prop_tuple in found_props or (prop.name == const.IMPLEMENTATION_STATUS and remove_imp_status):\n                continue\n            if remove_all_rule_info and prop.name in rule_tag_list:\n                continue\n            found_props.add(prop_tuple)\n            new_props.append(prop)\n        new_props.reverse()\n        return new_props\n\n    @staticmethod\n    def cull_props_by_rules(props: Optional[List[common.Property]], rules: List[str]) -&gt; List[common.Property]:\n        \"\"\"Cull properties to the ones needed by rules.\"\"\"\n        needed_rule_ids: Set[str] = set()\n        culled_props: List[common.Property] = []\n        for prop in as_list(props):\n            if prop.value in rules and prop.remarks:\n                needed_rule_ids.add(prop.remarks)\n        for prop in as_list(props):\n            if prop.value in rules or prop.remarks in needed_rule_ids:\n                culled_props.append(prop)\n        return culled_props\n\n    @staticmethod\n    def _status_as_prop(status: common.ImplementationStatus) -&gt; common.Property:\n        \"\"\"Convert status to property.\"\"\"\n        return common.Property(name=const.IMPLEMENTATION_STATUS, value=status.state, remarks=status.remarks)\n\n    @staticmethod\n    def _prop_as_status(prop: common.Property) -&gt; common.ImplementationStatus:\n        \"\"\"Convert property to status.\"\"\"\n        return common.ImplementationStatus(state=prop.value, remarks=prop.remarks)\n\n    @staticmethod\n    def insert_status_in_props(item: TypeWithProps, status: common.ImplementationStatus) -&gt; None:\n        \"\"\"Insert status content into props of the item.\"\"\"\n        prop = ControlInterface._status_as_prop(status)\n        ControlInterface._replace_prop(item, prop)\n\n    @staticmethod\n    def _copy_status_in_props(dest: TypeWithProps, src: TypeWithProps) -&gt; None:\n        \"\"\"Copy status in props from one object to another.\"\"\"\n        status = ControlInterface.get_status_from_props(src)\n        ControlInterface.insert_status_in_props(dest, status)\n\n    @staticmethod\n    def insert_imp_req_into_component(\n        component: comp.DefinedComponent,\n        new_imp_req: comp.ImplementedRequirement,\n        profile_title: str,\n        trestle_root: pathlib.Path\n    ) -&gt; None:\n        \"\"\"\n        Insert imp req into component by matching source title and control id to existing imp req.\n\n        Args:\n            component: The defined component receiving the imp_req\n            new_imp_req: The new imp_req being added\n            profile_title: The title of the source profile for the control implementation containing the imp_req\n\n        Notes:\n            Inserts the imp_req on the first match found.  Note it is possible two control implementations could\n            have the same source and specify the same control\n        \"\"\"\n        for control_imp in as_list(component.control_implementations):\n            _, control_imp_param_dict, _ = ControlInterface.get_rules_and_params_dict_from_item(control_imp)\n            control_imp_rule_param_ids = [\n                param['name'] for params in control_imp_param_dict.values() for param in params\n            ]\n            if profile_title != ModelUtils.get_title_from_model_uri(trestle_root, control_imp.source):\n                continue\n            for imp_req in as_list(control_imp.implemented_requirements):\n                if imp_req.control_id != new_imp_req.control_id:\n                    continue\n                _, imp_req_param_dict, _ = ControlInterface.get_rules_and_params_dict_from_item(imp_req)\n                imp_req_rule_param_ids = [param['name'] for params in imp_req_param_dict.values() for param in params]\n                status = ControlInterface.get_status_from_props(new_imp_req)\n                ControlInterface.insert_status_in_props(imp_req, status)\n                imp_req.description = new_imp_req.description\n                statement_dict = {stat.statement_id: stat for stat in as_list(imp_req.statements)}\n                # update set parameter values with values from markdown - but only for rule param vals\n                for set_param in as_list(new_imp_req.set_parameters):\n                    if set_param.param_id not in (control_imp_rule_param_ids + imp_req_rule_param_ids):\n                        continue\n                    found = False\n                    for dest_param in as_list(imp_req.set_parameters):\n                        if dest_param.param_id != set_param.param_id:\n                            continue\n                        dest_param.values = set_param.values\n                        found = True\n                        break\n                    # if rule parameter val was not already set by a set_param, make new set_param for it\n                    if found:\n                        continue\n                    # but first check if the parameter was already set with the same value in the control_imp\n                    # if so we don't need to insert a new set_param in imp_req\n                    for dest_param in as_list(control_imp.set_parameters):\n                        if dest_param.param_id != set_param.param_id:\n                            continue\n                        if dest_param.values == set_param.values:\n                            found = True\n                            break\n                    if found:\n                        continue\n                    imp_req.set_parameters = as_list(imp_req.set_parameters)\n                    imp_req.set_parameters.append(\n                        comp.SetParameter(param_id=set_param.param_id, values=set_param.values)\n                    )\n                new_statements: List[comp.Statement] = []\n                for statement in as_list(new_imp_req.statements):\n                    # get the original version of the statement if available, or use new one\n                    stat = statement_dict.get(statement.statement_id, statement)\n                    # update the description and status from markdown\n                    stat.description = statement.description\n                    ControlInterface._copy_status_in_props(stat, statement)\n                    new_statements.append(stat)\n                imp_req.statements = none_if_empty(new_statements)\n                return\n        logger.warning(\n            f'Unable to add imp req for component {component.title} control {new_imp_req.control_id} and source: {profile_title}'  # noqa E501\n        )\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.bad_header","title":"<code>bad_header(header)</code>  <code>staticmethod</code>","text":"<p>Return true if header format is bad.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef bad_header(header: str) -&gt; bool:\n    \"\"\"Return true if header format is bad.\"\"\"\n    if not header or header[0] != '#':\n        return True\n    n = len(header)\n    if n &lt; 2:\n        return True\n    for ii in range(1, n):\n        if header[ii] == ' ':\n            return False\n        if header[ii] != '#':\n            return True\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.clean_props","title":"<code>clean_props(props, remove_imp_status=True, remove_all_rule_info=False)</code>  <code>staticmethod</code>","text":"<p>Remove duplicate props and implementation status.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef clean_props(\n    props: Optional[List[common.Property]],\n    remove_imp_status: bool = True,\n    remove_all_rule_info: bool = False\n) -&gt; List[common.Property]:\n    \"\"\"Remove duplicate props and implementation status.\"\"\"\n    new_props: List[common.Property] = []\n    found_props: Set[Tuple[str, str, str, str]] = set()\n    rule_tag_list = [\n        const.RULE_DESCRIPTION, const.RULE_ID, const.PARAMETER_DESCRIPTION, const.PARAMETER_VALUE_ALTERNATIVES\n    ]\n    # reverse the list so the latest items are kept\n    for prop in reversed(as_list(props)):\n        prop_tuple = (prop.name, as_string(prop.value), as_string(prop.ns), prop.remarks)\n        if prop_tuple in found_props or (prop.name == const.IMPLEMENTATION_STATUS and remove_imp_status):\n            continue\n        if remove_all_rule_info and prop.name in rule_tag_list:\n            continue\n        found_props.add(prop_tuple)\n        new_props.append(prop)\n    new_props.reverse()\n    return new_props\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.create_statement_id","title":"<code>create_statement_id(control_id, lower=False)</code>  <code>staticmethod</code>","text":"<p>Create the control statement id from the control id.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef create_statement_id(control_id: str, lower: bool = False) -&gt; str:\n    \"\"\"Create the control statement id from the control id.\"\"\"\n    id_ = f'{control_id}_smt'\n    return id_.lower() if lower else id_\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.cull_props_by_rules","title":"<code>cull_props_by_rules(props, rules)</code>  <code>staticmethod</code>","text":"<p>Cull properties to the ones needed by rules.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef cull_props_by_rules(props: Optional[List[common.Property]], rules: List[str]) -&gt; List[common.Property]:\n    \"\"\"Cull properties to the ones needed by rules.\"\"\"\n    needed_rule_ids: Set[str] = set()\n    culled_props: List[common.Property] = []\n    for prop in as_list(props):\n        if prop.value in rules and prop.remarks:\n            needed_rule_ids.add(prop.remarks)\n    for prop in as_list(props):\n        if prop.value in rules or prop.remarks in needed_rule_ids:\n            culled_props.append(prop)\n    return culled_props\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_all_add_info","title":"<code>get_all_add_info(control_id, profile)</code>  <code>staticmethod</code>","text":"<p>Get the adds for a control from a profile by control id.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_all_add_info(control_id: str, profile: prof.Profile) -&gt; List[PartInfo]:\n    \"\"\"Get the adds for a control from a profile by control id.\"\"\"\n    part_infos = []\n    for add in ControlInterface._get_adds_for_control(profile, control_id):\n        # add control level props with no name\n        if add.props:\n            smt_part = add.by_id if add.by_id else ''\n            part_infos.append(PartInfo(name='', prose='', smt_part=smt_part, props=add.props))\n        # add part level props with part name\n        for part in as_list(add.parts):\n            subpart_info = ControlInterface._get_part_and_subpart_info(part, add.by_id)\n            part_infos.append(\n                PartInfo(\n                    name=part.name, prose=part.prose, smt_part=add.by_id, props=part.props, parts=subpart_info\n                )\n            )\n    return part_infos\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_component_by_name","title":"<code>get_component_by_name(comp_def, comp_name)</code>  <code>staticmethod</code>","text":"<p>Get the component with this name from the comp_def.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_component_by_name(comp_def: comp.ComponentDefinition, comp_name: str) -&gt; Optional[comp.DefinedComponent]:\n    \"\"\"Get the component with this name from the comp_def.\"\"\"\n    for sub_comp in as_list(comp_def.components):\n        if sub_comp.title == comp_name:\n            return sub_comp\n    return None\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_control_param_dict","title":"<code>get_control_param_dict(control, values_only)</code>  <code>staticmethod</code>","text":"<p>Create mapping of param id's to params for params in the control.</p> <p>Parameters:</p> Name Type Description Default <code>control</code> <code>Control</code> <p>the control containing params of interest</p> required <code>values_only</code> <code>bool</code> <p>only add params to the dict that have actual values</p> required <p>Returns:</p> Type Description <code>Dict[str, Parameter]</code> <p>Dictionary of param_id mapped to param</p> Notes <p>Warning is given if there is a parameter with no ID</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_control_param_dict(control: cat.Control, values_only: bool) -&gt; Dict[str, common.Parameter]:\n    \"\"\"\n    Create mapping of param id's to params for params in the control.\n\n    Args:\n        control: the control containing params of interest\n        values_only: only add params to the dict that have actual values\n\n    Returns:\n        Dictionary of param_id mapped to param\n\n    Notes:\n        Warning is given if there is a parameter with no ID\n    \"\"\"\n    param_dict: Dict[str, common.Parameter] = {}\n    for param in as_list(control.params):\n        if not param.id:\n            logger.warning(f'Control {control.id} has parameter with no id.  Ignoring.')\n        if param.values or not values_only:\n            param_dict[param.id] = param\n    return param_dict\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_control_section_prose","title":"<code>get_control_section_prose(control, section_name)</code>  <code>staticmethod</code>","text":"<p>Get the prose for the control section.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_control_section_prose(control: cat.Control, section_name: str) -&gt; str:\n    \"\"\"Get the prose for the control section.\"\"\"\n    prose = ''\n    if control.parts:\n        for part in control.parts:\n            prose = ControlInterface._gap_join(\n                prose, ControlInterface._get_control_section_part(part, section_name)\n            )\n    return prose\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_label","title":"<code>get_label(item)</code>  <code>staticmethod</code>","text":"<p>Get the label from the props of a part or control.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_label(item: TypeWithProps) -&gt; str:\n    \"\"\"Get the label from the props of a part or control.\"\"\"\n    return ControlInterface.get_prop(item, 'label')\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_params_dict_from_item","title":"<code>get_params_dict_from_item(item)</code>  <code>staticmethod</code>","text":"<p>Get all params found in this item with rule_id as key.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_params_dict_from_item(item: TypeWithProps) -&gt; Tuple[Dict[str, Dict[str, str]], List[common.Property]]:\n    \"\"\"Get all params found in this item with rule_id as key.\"\"\"\n    # id, description, options - where options is a string containing comma-sep list of items\n    # params is dict with rule_id as key and value contains: param_name, description and choices\n    params: Dict[str, List[Dict[str, str]]] = {}\n    props = []\n    for prop in as_list(item.props):\n        if const.PARAMETER_ID in prop.name:\n            rule_id = prop.remarks\n            param_name = prop.value\n            # rule already exists in parameters dict\n            if rule_id in params.keys():\n                existing_param = next((prm for prm in params[rule_id] if prm['name'] == param_name), None)\n                if existing_param is not None:\n                    raise TrestleError(f'Param id for rule {rule_id} already exists')\n                else:\n                    # append a new parameter for the current rule\n                    params[rule_id].append({'name': param_name})\n            else:\n                # create new param for this rule for the first parameter\n                params[rule_id] = [{'name': param_name}]\n            props.append(prop)\n        elif const.PARAMETER_DESCRIPTION in prop.name:\n            rule_id = prop.remarks\n            if rule_id in params:\n                param = next((prm for prm in params[rule_id] if prm['name'] == param_name), None)\n                param['description'] = prop.value\n                props.append(prop)\n            else:\n                raise TrestleError(f'Param description for rule {rule_id} found with no param_id')\n        elif const.PARAMETER_VALUE_ALTERNATIVES in prop.name:\n            rule_id = prop.remarks\n            if rule_id in params:\n                param = next((prm for prm in params[rule_id] if prm['name'] == param_name), None)\n                param['options'] = prop.value\n                props.append(prop)\n            else:\n                raise TrestleError(f'Param options for rule {rule_id} found with no param_id')\n    new_params = {}\n    for rule_id, rule_params in params.items():\n        new_params[rule_id] = []\n        for param in rule_params:\n            if 'name' not in param:\n                logger.warning(f'Parameter for rule_id {rule_id} has no matching name.  Ignoring the param.')\n            else:\n                param['description'] = param.get('description', '')\n                param['options'] = param.get('options', '')\n                new_params[rule_id].append(param)\n    return new_params, props\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_part","title":"<code>get_part(part, item_type, skip_id)</code>  <code>staticmethod</code>","text":"<p>Find parts with the specified item type, within the given part.</p> <p>For a part in a control find the parts in it that match the item_type Return list of string formatted labels and associated descriptive prose</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_part(part: common.Part, item_type: str, skip_id: Optional[str]) -&gt; List[Union[str, List[str]]]:\n    \"\"\"\n    Find parts with the specified item type, within the given part.\n\n    For a part in a control find the parts in it that match the item_type\n    Return list of string formatted labels and associated descriptive prose\n    \"\"\"\n    items = []\n    if part.name in [const.STATEMENT, item_type]:\n        # the options here are to force the label to be the part.id or the part.label\n        # the label may be of the form (a) while the part.id is ac-1_smt.a.1.a\n        # here we choose the latter and extract the final element\n        label = ControlInterface.get_label(part)\n        label = part.id.split('.')[-1] if not label else label\n        wrapped_label = ControlInterface._wrap_label(label)\n        pad = '' if wrapped_label == '' or not part.prose else ' '\n        prose = '' if part.prose is None else part.prose\n        # top level prose has already been written out, if present\n        # use presence of . in id to tell if this is top level prose\n        if part.id != skip_id:\n            if '\\n*' in prose:\n                # it is multiline prose\n                sub_items = []\n                multi_prose = prose.split('\\n*')\n                items.append(f'{wrapped_label}{pad}{multi_prose[0]}')\n                multi_prose.remove(multi_prose[0])\n                for prose in multi_prose:\n                    sub_items.append(f'{prose}')\n                items.append(sub_items)\n            else:\n                items.append(f'{wrapped_label}{pad}{prose}')\n        if part.parts:\n            sub_list = []\n            for prt in part.parts:\n                sub_list.extend(ControlInterface.get_part(prt, item_type, skip_id))\n            sub_list.append('')\n            items.append(sub_list)\n    return items\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_part_by_id","title":"<code>get_part_by_id(item, id_)</code>  <code>staticmethod</code>","text":"<p>Find the part within this item's list of parts that matches id.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_part_by_id(item: TypeWithParts, id_: str) -&gt; Optional[common.Part]:\n    \"\"\"Find the part within this item's list of parts that matches id.\"\"\"\n    for part in as_list(item.parts):\n        if part.id == id_:\n            return part\n        deep_part = ControlInterface.get_part_by_id(part, id_)\n        if deep_part:\n            return deep_part\n    return None\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_part_prose","title":"<code>get_part_prose(control, part_name)</code>  <code>staticmethod</code>","text":"<p>Get the prose for a named part.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_part_prose(control: cat.Control, part_name: str) -&gt; str:\n    \"\"\"Get the prose for a named part.\"\"\"\n    prose = ''\n    for part in as_list(control.parts):\n        prose += ControlInterface._get_control_section_part(part, part_name)\n    return prose.strip()\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_prop","title":"<code>get_prop(item, prop_name, default=None)</code>  <code>staticmethod</code>","text":"<p>Get the property with that name or return empty string.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_prop(item: TypeWithProps, prop_name: str, default: Optional[str] = None) -&gt; str:\n    \"\"\"Get the property with that name or return empty string.\"\"\"\n    for prop in as_list(item.props):\n        if prop.name.strip().lower() == prop_name.strip().lower():\n            return prop.value.strip()\n    return default if default else ''\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_rule_list_for_imp_req","title":"<code>get_rule_list_for_imp_req(imp_req)</code>  <code>staticmethod</code>","text":"<p>Get the list of rules applying to an imp_req as two lists.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_rule_list_for_imp_req(\n    imp_req: ossp.ImplementedRequirement\n) -&gt; Tuple[List[str], List[str], List[common.Property]]:\n    \"\"\"Get the list of rules applying to an imp_req as two lists.\"\"\"\n    comp_rules, rule_props = ControlInterface.get_rule_list_for_item(imp_req)\n    statement_rules = set()\n    for statement in as_list(imp_req.statements):\n        stat_rules, statement_props = ControlInterface.get_rule_list_for_item(statement)\n        statement_rules.update(stat_rules)\n        rule_props.extend(statement_props)\n    return comp_rules, sorted(statement_rules), rule_props\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_rule_list_for_item","title":"<code>get_rule_list_for_item(item)</code>  <code>staticmethod</code>","text":"<p>Get the list of rules applying to this item from its top level props.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_rule_list_for_item(item: TypeWithProps) -&gt; Tuple[List[str], List[common.Property]]:\n    \"\"\"Get the list of rules applying to this item from its top level props.\"\"\"\n    props = []\n    rule_list = []\n    for prop in as_list(item.props):\n        if prop.name == const.RULE_ID:\n            rule_list.append(prop.value)\n            props.append(prop)\n    return rule_list, props\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_rules_and_params_dict_from_item","title":"<code>get_rules_and_params_dict_from_item(item)</code>  <code>staticmethod</code>","text":"<p>Get the rule dict and params dict from item with props.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_rules_and_params_dict_from_item(\n    item: TypeWithProps\n) -&gt; Tuple[Dict[str, Dict[str, str]], Dict[str, Dict[str, str]], List[common.Property]]:\n    \"\"\"Get the rule dict and params dict from item with props.\"\"\"\n    rules_dict, rules_props = ControlInterface.get_rules_dict_from_item(item)\n    params_dict, params_props = ControlInterface.get_params_dict_from_item(item)\n    rules_props.extend(params_props)\n    return rules_dict, params_dict, rules_props\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_rules_dict_from_item","title":"<code>get_rules_dict_from_item(item)</code>  <code>staticmethod</code>","text":"<p>Get all rules found in this items props.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_rules_dict_from_item(item: TypeWithProps) -&gt; Tuple[Dict[str, Dict[str, str]], List[common.Property]]:\n    \"\"\"Get all rules found in this items props.\"\"\"\n    # rules is dict containing rule_id and description\n    rules_dict = {}\n    name = ''\n    desc = ''\n    id_ = ''\n    rules_props = []\n    for prop in as_list(item.props):\n        if prop.name == const.RULE_ID:\n            name = prop.value\n            id_ = prop.remarks\n            rules_props.append(prop)\n        elif prop.name == const.RULE_DESCRIPTION:\n            desc = prop.value\n            rules_props.append(prop)\n        # grab each pair in case there are multiple pairs\n        # then clear and look for new pair\n        if name and desc:\n            rules_dict[id_] = {'name': name, 'description': desc}\n            name = desc = id_ = ''\n    return rules_dict, rules_props\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_section","title":"<code>get_section(control, skip_section_list)</code>  <code>staticmethod</code>","text":"<p>Get sections that are not in the list.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_section(control: cat.Control, skip_section_list: List[str]) -&gt; Tuple[str, str, str, str]:\n    \"\"\"Get sections that are not in the list.\"\"\"\n    id_, name, title = ControlInterface._find_section(control, skip_section_list)\n    if id_:\n        return id_, name, title, ControlInterface.get_control_section_prose(control, name)\n    return '', '', '', ''\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_set_params_from_item","title":"<code>get_set_params_from_item(item)</code>  <code>staticmethod</code>","text":"<p>Get set params that have values from control implementation or imp req.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_set_params_from_item(\n    item: Union[comp.ControlImplementation, comp.ImplementedRequirement]\n) -&gt; Dict[str, comp.SetParameter]:\n    \"\"\"Get set params that have values from control implementation or imp req.\"\"\"\n    return {\n        set_param.param_id: set_param\n        for set_param in as_filtered_list(item.set_parameters, lambda i: i.values)\n    }\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_sort_id","title":"<code>get_sort_id(control, allow_none=False)</code>  <code>staticmethod</code>","text":"<p>Get the sort-id for the control.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_sort_id(control: cat.Control, allow_none=False) -&gt; Optional[str]:\n    \"\"\"Get the sort-id for the control.\"\"\"\n    for prop in as_list(control.props):\n        if prop.name == const.SORT_ID:\n            return prop.value.strip()\n    return None if allow_none else control.id\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_statement_id","title":"<code>get_statement_id(control)</code>  <code>staticmethod</code>","text":"<p>Find the statement id in the control.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_statement_id(control: cat.Control) -&gt; str:\n    \"\"\"Find the statement id in the control.\"\"\"\n    for part in as_list(control.parts):\n        if part.name == const.STATEMENT:\n            return part.id\n    return ControlInterface.create_statement_id(control.id)\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.get_status_from_props","title":"<code>get_status_from_props(item)</code>  <code>staticmethod</code>","text":"<p>Get the status of an item from its props.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef get_status_from_props(item: TypeWithProps) -&gt; common.ImplementationStatus:\n    \"\"\"Get the status of an item from its props.\"\"\"\n    status = common.ImplementationStatus(state=const.STATUS_PLANNED)\n    for prop in as_list(item.props):\n        if prop.name == const.IMPLEMENTATION_STATUS:\n            status = ControlInterface._prop_as_status(prop)\n            break\n    return status\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.insert_imp_req_into_component","title":"<code>insert_imp_req_into_component(component, new_imp_req, profile_title, trestle_root)</code>  <code>staticmethod</code>","text":"<p>Insert imp req into component by matching source title and control id to existing imp req.</p> <p>Parameters:</p> Name Type Description Default <code>component</code> <code>DefinedComponent</code> <p>The defined component receiving the imp_req</p> required <code>new_imp_req</code> <code>ImplementedRequirement</code> <p>The new imp_req being added</p> required <code>profile_title</code> <code>str</code> <p>The title of the source profile for the control implementation containing the imp_req</p> required Notes <p>Inserts the imp_req on the first match found.  Note it is possible two control implementations could have the same source and specify the same control</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef insert_imp_req_into_component(\n    component: comp.DefinedComponent,\n    new_imp_req: comp.ImplementedRequirement,\n    profile_title: str,\n    trestle_root: pathlib.Path\n) -&gt; None:\n    \"\"\"\n    Insert imp req into component by matching source title and control id to existing imp req.\n\n    Args:\n        component: The defined component receiving the imp_req\n        new_imp_req: The new imp_req being added\n        profile_title: The title of the source profile for the control implementation containing the imp_req\n\n    Notes:\n        Inserts the imp_req on the first match found.  Note it is possible two control implementations could\n        have the same source and specify the same control\n    \"\"\"\n    for control_imp in as_list(component.control_implementations):\n        _, control_imp_param_dict, _ = ControlInterface.get_rules_and_params_dict_from_item(control_imp)\n        control_imp_rule_param_ids = [\n            param['name'] for params in control_imp_param_dict.values() for param in params\n        ]\n        if profile_title != ModelUtils.get_title_from_model_uri(trestle_root, control_imp.source):\n            continue\n        for imp_req in as_list(control_imp.implemented_requirements):\n            if imp_req.control_id != new_imp_req.control_id:\n                continue\n            _, imp_req_param_dict, _ = ControlInterface.get_rules_and_params_dict_from_item(imp_req)\n            imp_req_rule_param_ids = [param['name'] for params in imp_req_param_dict.values() for param in params]\n            status = ControlInterface.get_status_from_props(new_imp_req)\n            ControlInterface.insert_status_in_props(imp_req, status)\n            imp_req.description = new_imp_req.description\n            statement_dict = {stat.statement_id: stat for stat in as_list(imp_req.statements)}\n            # update set parameter values with values from markdown - but only for rule param vals\n            for set_param in as_list(new_imp_req.set_parameters):\n                if set_param.param_id not in (control_imp_rule_param_ids + imp_req_rule_param_ids):\n                    continue\n                found = False\n                for dest_param in as_list(imp_req.set_parameters):\n                    if dest_param.param_id != set_param.param_id:\n                        continue\n                    dest_param.values = set_param.values\n                    found = True\n                    break\n                # if rule parameter val was not already set by a set_param, make new set_param for it\n                if found:\n                    continue\n                # but first check if the parameter was already set with the same value in the control_imp\n                # if so we don't need to insert a new set_param in imp_req\n                for dest_param in as_list(control_imp.set_parameters):\n                    if dest_param.param_id != set_param.param_id:\n                        continue\n                    if dest_param.values == set_param.values:\n                        found = True\n                        break\n                if found:\n                    continue\n                imp_req.set_parameters = as_list(imp_req.set_parameters)\n                imp_req.set_parameters.append(\n                    comp.SetParameter(param_id=set_param.param_id, values=set_param.values)\n                )\n            new_statements: List[comp.Statement] = []\n            for statement in as_list(new_imp_req.statements):\n                # get the original version of the statement if available, or use new one\n                stat = statement_dict.get(statement.statement_id, statement)\n                # update the description and status from markdown\n                stat.description = statement.description\n                ControlInterface._copy_status_in_props(stat, statement)\n                new_statements.append(stat)\n            imp_req.statements = none_if_empty(new_statements)\n            return\n    logger.warning(\n        f'Unable to add imp req for component {component.title} control {new_imp_req.control_id} and source: {profile_title}'  # noqa E501\n    )\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.insert_status_in_props","title":"<code>insert_status_in_props(item, status)</code>  <code>staticmethod</code>","text":"<p>Insert status content into props of the item.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef insert_status_in_props(item: TypeWithProps, status: common.ImplementationStatus) -&gt; None:\n    \"\"\"Insert status content into props of the item.\"\"\"\n    prop = ControlInterface._status_as_prop(status)\n    ControlInterface._replace_prop(item, prop)\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.is_withdrawn","title":"<code>is_withdrawn(control)</code>  <code>staticmethod</code>","text":"<p>Determine if control is marked Withdrawn.</p> <p>Parameters:</p> Name Type Description Default <code>control</code> <code>Control</code> <p>The control that may be marked withdrawn.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>True if marked withdrawn, false otherwise.</p> <p>This is determined by property with name 'status' with value 'Withdrawn'.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef is_withdrawn(control: cat.Control) -&gt; bool:\n    \"\"\"\n    Determine if control is marked Withdrawn.\n\n    Args:\n        control: The control that may be marked withdrawn.\n\n    Returns:\n        True if marked withdrawn, false otherwise.\n\n    This is determined by property with name 'status' with value 'Withdrawn'.\n    \"\"\"\n    for _ in as_filtered_list(\n            control.props,\n            lambda p: strip_lower_equals(p.name, 'status') and strip_lower_equals(p.value, 'withdrawn')):\n        return True\n    return False\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.item_has_rules","title":"<code>item_has_rules(item)</code>  <code>staticmethod</code>","text":"<p>Determine if the item has rules in its props.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef item_has_rules(item: TypeWithProps) -&gt; bool:\n    \"\"\"Determine if the item has rules in its props.\"\"\"\n    _, rules_props = ControlInterface.get_rules_dict_from_item(item)\n    return bool(rules_props)\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.merge_dicts_deep","title":"<code>merge_dicts_deep(dest, src, overwrite_header_values, depth=0, level=0)</code>  <code>staticmethod</code>","text":"<p>Merge dict src into dest.</p> <p>New items are always added from src to dest. Items present in both will be overriden dest if overwrite_header_values is True.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef merge_dicts_deep(\n    dest: Dict[Any, Any],\n    src: Dict[Any, Any],\n    overwrite_header_values: bool,\n    depth: int = 0,\n    level: int = 0\n) -&gt; None:\n    \"\"\"\n    Merge dict src into dest.\n\n    New items are always added from src to dest.\n    Items present in both will be overriden dest if overwrite_header_values is True.\n    \"\"\"\n    if src is None:\n        return\n    for key in src.keys():\n        if key in dest:\n            if depth and level == depth:\n                if overwrite_header_values:\n                    dest[key] = src[key]\n                continue\n            # if they are both dicts, recurse\n            if isinstance(dest[key], dict) and isinstance(src[key], dict):\n                ControlInterface.merge_dicts_deep(dest[key], src[key], overwrite_header_values, depth, level + 1)\n            # if they are both lists, add any item that is not already in the list\n            elif isinstance(dest[key], list) and isinstance(src[key], list):\n                for item in src[key]:\n                    if item not in dest[key]:\n                        dest[key].append(item)\n            # otherwise override dest if needed\n            elif overwrite_header_values:\n                dest[key] = src[key]\n        else:\n            # if the item was not already in dest, add it from src\n            dest[key] = src[key]\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.merge_part","title":"<code>merge_part(dest, src)</code>  <code>staticmethod</code>","text":"<p>Merge a source part into the destination part.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef merge_part(dest: common.Part, src: common.Part) -&gt; common.Part:\n    \"\"\"Merge a source part into the destination part.\"\"\"\n    dest.name = src.name if src.name else dest.name\n    dest.ns = src.ns if src.ns else dest.ns\n    dest.props = none_if_empty(ControlInterface.merge_props(dest.props, src.props))\n    dest.prose = src.prose\n    dest.title = src.title if src.title else dest.title\n    ControlInterface.merge_parts(dest, src)\n    return dest\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.merge_parts","title":"<code>merge_parts(dest, src)</code>  <code>staticmethod</code>","text":"<p>Merge the parts from the source into the destination.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef merge_parts(dest: TypeWithParts, src: TypeWithParts) -&gt; None:\n    \"\"\"Merge the parts from the source into the destination.\"\"\"\n    if not dest.parts:\n        dest.parts = src.parts\n    elif not src.parts:\n        dest.parts = None\n    else:\n        new_parts: List[common.Part] = []\n        dest_map = {part.id: part for part in dest.parts}\n        for src_part in src.parts:\n            dest_part = dest_map.get(src_part.id, None)\n            if not dest_part:\n                new_parts.append(src_part)\n            else:\n                new_part = ControlInterface.merge_part(dest_part, src_part)\n                if new_part:\n                    new_parts.append(new_part)\n        dest.parts = new_parts\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.merge_props","title":"<code>merge_props(dest, src)</code>  <code>staticmethod</code>","text":"<p>Merge a source list of properties into a destination list.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef merge_props(dest: Optional[List[common.Property]],\n                src: Optional[List[common.Property]]) -&gt; List[common.Property]:\n    \"\"\"Merge a source list of properties into a destination list.\"\"\"\n    if not src:\n        return dest\n    new_props: List[common.Property] = []\n    src_map = {prop.name: prop for prop in src}\n    dest_map = {prop.name: prop for prop in dest}\n    all_names = set(src_map.keys()).union(dest_map.keys())\n    for name in sorted(all_names):\n        if name in src_map and name not in dest_map:\n            new_props.append(src_map[name])\n        elif name in dest_map and name not in src_map:\n            new_props.append(dest_map[name])\n        else:\n            new_prop = dest_map[name]\n            src_prop = src_map[name]\n            new_prop.class_ = src_prop.class_ if src_prop.class_ else new_prop.class_\n            new_prop.ns = src_prop.ns if src_prop.ns else new_prop.ns\n            new_prop.remarks = src_prop.remarks if src_prop.remarks else new_prop.remarks\n            new_prop.uuid = src_prop.uuid if src_prop.uuid else new_prop.uuid\n            new_prop.value = src_prop.value\n            new_props.append(new_prop)\n    return new_props\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.param_to_str","title":"<code>param_to_str(param, param_rep, verbose=False, brackets=False, params_format=None, value_assigned_prefix=None, value_not_assigned_prefix=None, param_dict=None)</code>  <code>staticmethod</code>","text":"<p>Convert parameter to string based on best available representation.</p> <p>Parameters:</p> Name Type Description Default <code>param</code> <code>Parameter</code> <p>the parameter to convert</p> required <code>param_rep</code> <code>ParameterRep</code> <p>how to represent the parameter</p> required <code>verbose</code> <code>bool</code> <p>provide verbose text for selection choices</p> <code>False</code> <code>brackets</code> <code>bool</code> <p>add brackets around the lists of items</p> <code>False</code> <code>params_format</code> <code>Optional[str]</code> <p>a string containing a single dot that represents a form of highlighting around the param</p> <code>None</code> <code>value_assigned_prefix</code> <code>Optional[str]</code> <p>string to place before the parameter string if a value was assigned</p> <code>None</code> <code>value_not_assigned_prefix</code> <code>Optional[str]</code> <p>string to place before the parameter string if value not assigned</p> <code>None</code> <p>Returns:</p> Type Description <code>Optional[str]</code> <p>formatted string or None</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef param_to_str(\n    param: common.Parameter,\n    param_rep: ParameterRep,\n    verbose: bool = False,\n    brackets: bool = False,\n    params_format: Optional[str] = None,\n    value_assigned_prefix: Optional[str] = None,\n    value_not_assigned_prefix: Optional[str] = None,\n    param_dict: Dict[str, common.Parameter] = None\n) -&gt; Optional[str]:\n    \"\"\"\n    Convert parameter to string based on best available representation.\n\n    Args:\n        param: the parameter to convert\n        param_rep: how to represent the parameter\n        verbose: provide verbose text for selection choices\n        brackets: add brackets around the lists of items\n        params_format: a string containing a single dot that represents a form of highlighting around the param\n        value_assigned_prefix: string to place before the parameter string if a value was assigned\n        value_not_assigned_prefix: string to place before the parameter string if value not assigned\n\n    Returns:\n        formatted string or None\n    \"\"\"\n    param_str = None\n    if param_rep == ParameterRep.VALUE_OR_STRING_NONE:\n        param_str = ControlInterface._param_values_as_str(param)\n        param_str = param_str if param_str else 'None'\n    elif param_rep == ParameterRep.LABEL_OR_CHOICES:\n        param_str = ControlInterface._param_label_choices_as_str(param, verbose, brackets)\n    elif param_rep == ParameterRep.VALUE_OR_LABEL_OR_CHOICES:\n        param_str = ControlInterface._param_values_as_str(param)\n        if not param_str:\n            param_str = ControlInterface._param_label_choices_as_str(param, verbose, brackets)\n    elif param_rep == ParameterRep.VALUE_OR_EMPTY_STRING:\n        param_str = ControlInterface._param_values_as_str(param, brackets)\n        if not param_str:\n            param_str = ''\n    elif param_rep == ParameterRep.ASSIGNMENT_FORM:\n        param_str = ControlInterface._param_values_assignment_str(\n            param, param_dict, value_assigned_prefix, value_not_assigned_prefix\n        )\n        if not param_str:\n            param_str = ''\n    elif param_rep == ParameterRep.LABEL_FORM:\n        param_str = ControlInterface._param_labels_assignment_str(param, value_not_assigned_prefix)\n        if not param_str:\n            param_str = ''\n    return ControlInterface._apply_params_format(param_str, params_format)\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.replace_control_prose","title":"<code>replace_control_prose(control, param_dict, params_format=None, param_rep=ParameterRep.VALUE_OR_LABEL_OR_CHOICES, show_value_warnings=False, value_assigned_prefix=None, value_not_assigned_prefix=None)</code>  <code>staticmethod</code>","text":"<p>Replace the control prose according to set_param.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef replace_control_prose(\n    control: cat.Control,\n    param_dict: Dict[str, common.Parameter],\n    params_format: Optional[str] = None,\n    param_rep: ParameterRep = ParameterRep.VALUE_OR_LABEL_OR_CHOICES,\n    show_value_warnings: bool = False,\n    value_assigned_prefix: Optional[str] = None,\n    value_not_assigned_prefix: Optional[str] = None\n) -&gt; None:\n    \"\"\"Replace the control prose according to set_param.\"\"\"\n    # first replace all choices that reference parameters\n    # note that in ASSIGNMENT_FORM each choice with a parameter will end up as [Assignment: value]\n    for param in as_list(control.params):\n        ControlInterface._replace_param_choices(\n            param,\n            param_dict,\n            params_format,\n            param_rep,\n            show_value_warnings,\n            value_assigned_prefix,\n            value_not_assigned_prefix\n        )\n    for part in as_list(control.parts):\n        if part.prose is not None:\n            fixed_prose = ControlInterface._replace_params(\n                part.prose,\n                param_dict,\n                params_format,\n                param_rep,\n                show_value_warnings,\n                value_assigned_prefix,\n                value_not_assigned_prefix\n            )\n            # change the prose in the control itself\n            part.prose = fixed_prose\n        for prt in as_list(part.parts):\n            ControlInterface._replace_part_prose(\n                control,\n                prt,\n                param_dict,\n                params_format,\n                param_rep,\n                show_value_warnings,\n                value_assigned_prefix,\n                value_not_assigned_prefix\n            )\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.setparam_to_param","title":"<code>setparam_to_param(param_id, set_param)</code>  <code>staticmethod</code>","text":"<p>Convert setparameter to parameter.</p> <p>Parameters:</p> Name Type Description Default <code>param_id</code> <code>str</code> <p>the id of the parameter</p> required <code>set_param</code> <code>SetParameter</code> <p>the set_parameter from a profile</p> required <p>Returns:</p> Type Description <code>Parameter</code> <p>a Parameter with param_id and content from the SetParameter</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef setparam_to_param(param_id: str, set_param: prof.SetParameter) -&gt; common.Parameter:\n    \"\"\"\n    Convert setparameter to parameter.\n\n    Args:\n        param_id: the id of the parameter\n        set_param: the set_parameter from a profile\n\n    Returns:\n        a Parameter with param_id and content from the SetParameter\n    \"\"\"\n    return common.Parameter(\n        id=param_id, values=set_param.values, select=set_param.select, label=set_param.label, props=set_param.props\n    )\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.strip_to_make_ncname","title":"<code>strip_to_make_ncname(label)</code>  <code>staticmethod</code>","text":"<p>Strip chars to conform with NCNAME regex.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef strip_to_make_ncname(label: str) -&gt; str:\n    \"\"\"Strip chars to conform with NCNAME regex.\"\"\"\n    orig_label = label\n    # make sure first char is allowed\n    while label and label[0] not in const.NCNAME_UTF8_FIRST_CHAR_OPTIONS:\n        label = label[1:]\n    new_label = label[:1]\n    # now check remaining chars\n    if len(label) &gt; 1:\n        for ii in range(1, len(label)):\n            if label[ii] in const.NCNAME_UTF8_OTHER_CHAR_OPTIONS:\n                new_label += label[ii]\n    # do final check to confirm it is NCNAME\n    match = re.search(const.NCNAME_REGEX, new_label)\n    if not match:\n        raise TrestleError(f'Unable to convert label {orig_label} to NCNAME format.')\n    return new_label\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ControlInterface.uniquify_set_params","title":"<code>uniquify_set_params(set_params)</code>  <code>staticmethod</code>","text":"<p>Remove items with same param_id with priority to later items.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@staticmethod\ndef uniquify_set_params(set_params: Optional[List[TypeWithParamId]]) -&gt; List[TypeWithParamId]:\n    \"\"\"Remove items with same param_id with priority to later items.\"\"\"\n    found_ids: Set[str] = set()\n    unique_list: List[TypeWithParamId] = []\n    for set_param in reversed(as_list(set_params)):\n        if set_param.param_id not in found_ids:\n            unique_list.append(set_param)\n            found_ids.add(set_param.param_id)\n    return list(reversed(unique_list))\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ParameterRep","title":"<code>ParameterRep</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Enum for ways to represent a parameter.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>class ParameterRep(Enum):\n    \"\"\"Enum for ways to represent a parameter.\"\"\"\n\n    LEAVE_MOUSTACHE = 0\n    VALUE_OR_STRING_NONE = 1\n    LABEL_OR_CHOICES = 2\n    VALUE_OR_LABEL_OR_CHOICES = 3\n    VALUE_OR_EMPTY_STRING = 4\n    ASSIGNMENT_FORM = 5\n    LABEL_FORM = 6\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ParameterRep-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ParameterRep.ASSIGNMENT_FORM","title":"<code>ASSIGNMENT_FORM = 5</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ParameterRep.LABEL_FORM","title":"<code>LABEL_FORM = 6</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ParameterRep.LABEL_OR_CHOICES","title":"<code>LABEL_OR_CHOICES = 2</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ParameterRep.LEAVE_MOUSTACHE","title":"<code>LEAVE_MOUSTACHE = 0</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ParameterRep.VALUE_OR_EMPTY_STRING","title":"<code>VALUE_OR_EMPTY_STRING = 4</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ParameterRep.VALUE_OR_LABEL_OR_CHOICES","title":"<code>VALUE_OR_LABEL_OR_CHOICES = 3</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.ParameterRep.VALUE_OR_STRING_NONE","title":"<code>VALUE_OR_STRING_NONE = 1</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo","title":"<code>PartInfo</code>  <code>dataclass</code>","text":"<p>Class to capture control part info needed in markdown.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>@dataclass\nclass PartInfo:\n    \"\"\"Class to capture control part info needed in markdown.\"\"\"\n\n    name: str\n    prose: str\n    smt_part: str = ''\n    props: Optional[List[common.Property]] = None\n    parts: Optional[List[PartInfo]] = None\n\n    def to_dicts(self, part_id_map: Dict[str, str]) -&gt; Tuple[Dict[str, Any], List[Dict[str, Any]]]:\n        \"\"\"Convert the part info to a dict or list of props.\"\"\"\n        prop_list = []\n        part = {}\n        # if it has a part name then it is a part with prose\n        if self.name:\n            part['name'] = part_id_map.get(self.name, self.name)\n            if self.prose:\n                part['prose'] = self.prose\n            if self.parts:\n                all_subparts = []\n                for subpart in self.parts:\n                    subpart_dict, _ = subpart.to_dicts(part_id_map)\n                    all_subparts.append(subpart_dict)\n                part['parts'] = all_subparts\n\n        # otherwise it is a list of props\n        else:\n            for prop in as_list(self.props):\n                prop_d = {'name': prop.name, 'value': prop.value}\n                if prop.ns:\n                    prop_d['ns'] = str(prop.ns)\n                if self.smt_part:\n                    prop_d['smt-part'] = part_id_map.get(self.smt_part, self.smt_part)\n                prop_list.append(prop_d)\n        return part, prop_list\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo.name","title":"<code>name: str</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo.parts","title":"<code>parts: Optional[List[PartInfo]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo.props","title":"<code>props: Optional[List[common.Property]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo.prose","title":"<code>prose: str</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo.smt_part","title":"<code>smt_part: str = ''</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo.__init__","title":"<code>__init__(name, prose, smt_part='', props=None, parts=None)</code>","text":""},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface.PartInfo.to_dicts","title":"<code>to_dicts(part_id_map)</code>","text":"<p>Convert the part info to a dict or list of props.</p> Source code in <code>trestle/core/control_interface.py</code> <pre><code>def to_dicts(self, part_id_map: Dict[str, str]) -&gt; Tuple[Dict[str, Any], List[Dict[str, Any]]]:\n    \"\"\"Convert the part info to a dict or list of props.\"\"\"\n    prop_list = []\n    part = {}\n    # if it has a part name then it is a part with prose\n    if self.name:\n        part['name'] = part_id_map.get(self.name, self.name)\n        if self.prose:\n            part['prose'] = self.prose\n        if self.parts:\n            all_subparts = []\n            for subpart in self.parts:\n                subpart_dict, _ = subpart.to_dicts(part_id_map)\n                all_subparts.append(subpart_dict)\n            part['parts'] = all_subparts\n\n    # otherwise it is a list of props\n    else:\n        for prop in as_list(self.props):\n            prop_d = {'name': prop.name, 'value': prop.value}\n            if prop.ns:\n                prop_d['ns'] = str(prop.ns)\n            if self.smt_part:\n                prop_d['smt-part'] = part_id_map.get(self.smt_part, self.smt_part)\n            prop_list.append(prop_d)\n    return part, prop_list\n</code></pre>"},{"location":"reference/API/trestle/core/control_interface/#trestle.core.control_interface-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_reader/","title":"trestle.core.control_reader","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader","title":"<code>trestle.core.control_reader</code>","text":"<p>Handle reading of writing controls from markdown.</p>"},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader.ControlReader","title":"<code>ControlReader</code>","text":"<p>Class to read controls from markdown.</p> Source code in <code>trestle/core/control_reader.py</code> <pre><code>class ControlReader:\n    \"\"\"Class to read controls from markdown.\"\"\"\n\n    @staticmethod\n    def _clean_prose(prose: List[str]) -&gt; List[str]:\n        # remove empty and horizontal rule lines at start and end of list of prose lines\n        forward_index = 0\n        for line in prose:\n            if line.strip() and not line.startswith('____'):\n                break\n            forward_index += 1\n        new_prose = prose[forward_index:]\n        reverse_index = 0\n        for line in reversed(new_prose):\n            if line.strip() and not line.startswith('____'):\n                break\n            reverse_index += 1\n        clean_prose = new_prose[:len(new_prose) - reverse_index]\n        clean_prose = clean_prose if clean_prose else ['']\n        # if there is no useful prose this will return [''] and allow generation of a statement with empty prose\n        return clean_prose\n\n    @staticmethod\n    def _comp_name_in_dict(comp_name: str, comp_dict: CompDict) -&gt; str:\n        \"\"\"If the name is already in the dict in a similar form, stick to that form.\"\"\"\n        simple_name = ControlReader.simplify_name(comp_name)\n        for name in comp_dict.keys():\n            if simple_name == ControlReader.simplify_name(name):\n                return name\n        return comp_name\n\n    @staticmethod\n    def _add_node_to_dict(\n        comp_name: Optional[str],\n        label: str,\n        comp_dict: CompDict,\n        node: ControlMarkdownNode,\n        control_id: str,\n        comp_list: List[str],\n        context: ControlContext\n    ) -&gt; None:\n        \"\"\"\n        Extract the label, prose, possible component name - along with implementation status.\n\n        In component mode there is only one component and its name is not in markdown.\n        In ssp mode there are many components in each md file.\n        \"\"\"\n        component_mode = context.purpose == ContextPurpose.COMPONENT\n        # for ssp, ### marks component name but for component it is ##\n        # if it is a header, make sure it has correct format\n        if node.key and node.key[0] == '#' and ControlInterface.bad_header(node.key):\n            raise TrestleError(f'Improper header format for control {control_id}: {node.key}')\n        if not component_mode:\n            # look for component name heading if present\n            prefix = '### '\n            if node.key.startswith(prefix):\n                if len(node.key.split()) &lt;= 1:\n                    raise TrestleError(\n                        f'Header line in control {control_id} markdown starts with {prefix} but has no content.'\n                    )\n                comp_name = node.key.split(' ', 1)[1].strip()\n                simp_comp_name = ControlReader.simplify_name(comp_name)\n                if simp_comp_name in comp_list:\n                    raise TrestleError(\n                        f'Control {control_id} has a section with two component headings for {comp_name}.  '\n                        'Please combine the sections so there is only one heading for each component in a '\n                        'statement.'\n                    )\n                comp_list.append(simp_comp_name)\n                comp_name = ControlReader._comp_name_in_dict(comp_name, comp_dict)\n\n        # prose may be empty in md and we want to capture that so put it in the comp_dict\n        prose = '\\n'.join(ControlReader._clean_prose(node.content.text))\n        # add the prose to the comp_dict, creating new entry as needed\n        if comp_name in comp_dict:\n            if label in comp_dict[comp_name]:\n                comp_dict[comp_name][label].prose = prose\n            else:\n                # create new entry with prose\n                comp_dict[comp_name][label] = ComponentImpInfo(prose=prose, rules=[], props=[])\n        elif comp_name:\n            comp_dict[comp_name] = {label: ComponentImpInfo(prose=prose, rules=[], props=[])}\n\n        # build list of subnodes that get handled specially so they aren't processed here\n        subnode_kill: List[int] = []\n        status_str = None\n        remarks_str = None\n        rules_list: List[str] = []\n        for ii, subnode in enumerate(node.subnodes):\n            if subnode.key.find(const.IMPLEMENTATION_STATUS_REMARKS_HEADER) &gt;= 0:\n                remarks_str = subnode.key.split(maxsplit=4)[-1]\n                subnode_kill.append(ii)\n            elif subnode.key.find(const.IMPLEMENTATION_STATUS_HEADER) &gt;= 0:\n                status_str = subnode.key.split(maxsplit=3)[-1]\n                subnode_kill.append(ii)\n            elif subnode.key.find('Rules:') &gt;= 0:\n                rules_list = [text[2:] for text in subnode.content.text if text.startswith('- ')]\n                subnode_kill.append(ii)\n        if status_str:\n            new_status = common.ImplementationStatus(state=status_str, remarks=remarks_str)\n            if comp_name not in comp_dict:\n                comp_dict[comp_name] = {}\n            if label not in comp_dict[comp_name]:\n                comp_dict[comp_name][label] = ComponentImpInfo(prose='', rules=[], props=[])\n            comp_dict[comp_name][label].status = new_status\n        if rules_list:\n            comp_dict[comp_name][label].rules = rules_list\n        delete_list_from_list(node.subnodes, subnode_kill)\n        for subnode in as_list(node.subnodes):\n            ControlReader._add_node_to_dict(comp_name, label, comp_dict, subnode, control_id, comp_list, context)\n\n    @staticmethod\n    def _insert_header_content(\n        imp_req: generic.GenericImplementedRequirement, header: Dict[str, Any], control_id: str\n    ) -&gt; None:\n        \"\"\"Insert yaml header content into the imp_req and its by_comps as props.\"\"\"\n        dict_ = header.get(const.TRESTLE_PROPS_TAG, {})\n        roles = as_list(dict_.get(const.RESPONSIBLE_ROLES, []))\n        props = []\n        responsible_roles = []\n        for role in roles:\n            if isinstance(role, str):\n                # role_id must conform to NCNAME regex\n                role = role.strip().replace(' ', '_')\n                if role:\n                    responsible_roles.append(common.ResponsibleRole(role_id=role))\n            else:\n                logger.warning(f'Role in header for control {control_id} not recognized: {role}')\n        if props:\n            imp_req.props = as_list(imp_req.props)\n            imp_req.props.extend(props)\n        if responsible_roles:\n            imp_req.responsible_roles = as_list(imp_req.responsible_roles)\n            imp_req.responsible_roles.extend(responsible_roles)\n            imp_req.responsible_roles = none_if_empty(imp_req.responsible_roles)\n            # enforce single list of resp. roles for control and each by_comp\n            for by_comp in as_list(imp_req.by_components):\n                by_comp.responsible_roles = imp_req.responsible_roles\n\n    @staticmethod\n    def simplify_name(name: str) -&gt; str:\n        \"\"\"Simplify the name to ignore variations in case, space, hyphen, underscore, slash.\"\"\"\n        return name.lower().replace(' ', '').replace('-', '').replace('_', '').replace('/', '')\n\n    @staticmethod\n    def _get_label_from_implementation_header(imp_header: str):\n        # assumed to be of form: Implementation for part a.\n        split_header = imp_header.split(' ', 4)\n        if len(split_header) != 5:\n            raise TrestleError(f'Implementation header cannot be parsed for statement part: {imp_header}')\n        return split_header[4].strip()\n\n    @staticmethod\n    def read_control_info_from_md(control_file: pathlib.Path,\n                                  context: ControlContext) -&gt; Tuple[Dict[str, List[str]], CompDict]:\n        \"\"\"\n        Find all labels and associated implementation prose in the markdown for this control.\n\n        Args:\n            control_file: path to the control markdown file\n            context: context of the control usage\n\n        Returns:\n            The yaml header as dict in second part of tuple.\n            Adds to the passed in comp_dict.\n        \"\"\"\n        yaml_header = {}\n        comp_dict = {}\n\n        if not control_file.exists():\n            return yaml_header, comp_dict\n        # if the file exists, load the contents but do not use prose from comp_dict\n        # for non ssp or component mode just use empty string for comp\n        comp_name = ''\n        try:\n            control_id = control_file.stem\n            if context.purpose == ContextPurpose.COMPONENT:\n                comp_name = context.comp_name if context.comp_name else const.SSP_MAIN_COMP_NAME\n\n            md_api = MarkdownAPI()\n            yaml_header, control_md = md_api.processor.process_markdown(control_file)\n\n            # first get the header strings, including statement labels, for statement imp reqs\n            imp_string = '## Implementation '\n            headers = control_md.get_all_headers_for_level(2)\n            # get e.g. ## Implementation a.  ## Implementation b. etc\n            imp_header_list = [header for header in headers if header.startswith(imp_string)]\n\n            # now get the (one) header for the main solution\n            main_headers = list(control_md.get_all_headers_for_key(const.SSP_MD_IMPLEMENTATION_QUESTION, False))\n            # should be only one header, so warn if others found\n            if main_headers:\n                if len(main_headers) &gt; 1:\n                    logger.warning(\n                        f'Control {control_id} has {len(main_headers)} main header responses.  Will use first one only.'\n                    )\n                main_header = main_headers[0]\n                node = control_md.get_all_nodes_for_keys([main_header], False)[0]\n                # this node is top level so it will have empty label\n                # it may have subnodes of Rules, Implementation Status, Implementaton Remarks\n                ControlReader._add_node_to_dict(comp_name, '', comp_dict, node, control_id, [], context)\n            for imp_header in imp_header_list:\n                label = ControlReader._get_label_from_implementation_header(imp_header)\n                node = control_md.get_node_for_key(imp_header)\n                ControlReader._add_node_to_dict(comp_name, label, comp_dict, node, control_id, [], context)\n\n        except TrestleError as e:\n            raise TrestleError(f'Error occurred reading {control_file}: {e}')\n        return yaml_header, comp_dict\n\n    @staticmethod\n    def _handle_empty_prose(prose: str, id_: str) -&gt; str:\n        \"\"\"Regard prompt text or id_ as no prose and return blank string.\"\"\"\n        if prose.startswith(const.SSP_ADD_IMPLEMENTATION_PREFIX) or prose == id_:\n            return ''\n        return prose\n\n    @staticmethod\n    def read_implemented_requirement(control_file: pathlib.Path,\n                                     context: ControlContext) -&gt; Tuple[str, comp.ImplementedRequirement]:\n        \"\"\"\n        Get the implementated requirement associated with given control and link to existing components or new ones.\n\n        Args:\n            control_file: path of the control markdown file\n            context: context of the control usage\n\n        Returns:\n            Tuple: The control sort-id and the one implemented requirement for this control.\n\n        Notes:\n            Each statement may have several responses, with each response in a by_component for a specific component.\n            statement_map keeps track of statements that may have several by_component responses.\n            This is only used during component assemble and only for updating one component.\n        \"\"\"\n        control_id = control_file.stem\n        md_header, md_comp_dict = ControlReader.read_control_info_from_md(control_file, context)\n        comp_name = context.component.title\n\n        statement_map: Dict[str, comp.Statement] = {}\n        # create a new implemented requirement linked to the control id to hold the statements\n        imp_req = gens.generate_sample_model(comp.ImplementedRequirement)\n        imp_req.control_id = control_id\n\n        imp_req.statements = []\n        comp_dict = md_comp_dict[comp_name]\n        for label, comp_info in comp_dict.items():\n            # if no label it applies to the imp_req itself rather than a statement\n            if not label:\n                imp_req.description = ControlReader._handle_empty_prose(comp_info.prose, control_id)\n                ControlInterface.insert_status_in_props(imp_req, comp_info.status)\n                continue\n            statement_id = ControlInterface.create_statement_id(control_id)\n            if label in ['', const.STATEMENT]:\n                statement_part_id = statement_id\n            else:\n                clean_label = label.strip('.')\n                statement_part_id = ControlInterface.strip_to_make_ncname(f'{statement_id}.{clean_label}')\n            if statement_part_id in statement_map:\n                statement = statement_map[statement_part_id]\n            else:\n                statement = gens.generate_sample_model(comp.Statement)\n                statement.statement_id = statement_part_id\n                statement_map[statement_part_id] = statement\n            statement.description = comp_info.prose\n            statement.props = none_if_empty(ControlInterface.clean_props(comp_info.props))\n            ControlInterface.insert_status_in_props(statement, comp_info.status)\n\n        imp_req.statements = list(statement_map.values())\n        imp_req.set_parameters = []\n\n        for _, param_dict_list in md_header.get(const.COMP_DEF_RULES_PARAM_VALS_TAG, {}).items():\n            for param_dict in param_dict_list:\n                values = param_dict.get(const.VALUES, [])\n                comp_values = param_dict.get(const.COMPONENT_VALUES, [])\n                values = comp_values if comp_values else values\n                set_param = ossp.SetParameter(param_id=param_dict['name'], values=values)\n                imp_req.set_parameters.append(set_param)\n        imp_req.statements = none_if_empty(list(statement_map.values()))\n        imp_req.set_parameters = none_if_empty(imp_req.set_parameters)\n\n        ControlReader._insert_header_content(imp_req, md_header, control_id)\n        sort_id = md_header.get(const.SORT_ID, control_id)\n        return sort_id, imp_req\n\n    @staticmethod\n    def get_props_list(control_id: str, label_map: Dict[str, str],\n                       yaml_header: Dict[str, Any]) -&gt; Tuple[List[common.Property], Dict[str, List[common.Property]]]:\n        \"\"\"Get the list of props in the yaml header of this control as separate lists with and without by_id.\"\"\"\n        prop_list = yaml_header.get(const.TRESTLE_ADD_PROPS_TAG, [])\n        props = []\n        props_by_id = {}\n        for prop_d in prop_list:\n            by_id = prop_d.get('smt-part', None)\n            if by_id and control_id in label_map:\n                by_id = label_map[control_id].get(by_id, by_id)\n            prop = common.Property(name=prop_d['name'], value=prop_d['value'], ns=prop_d.get('ns', None))\n            if by_id:\n                if by_id not in props_by_id:\n                    props_by_id[by_id] = []\n                props_by_id[by_id].append(prop)\n            else:\n                props.append(prop)\n        return props, props_by_id\n\n    @staticmethod\n    def read_editable_content(\n        control_path: pathlib.Path,\n        required_sections_list: List[str],\n        part_label_to_id_map: Dict[str, Dict[str, str]],\n        cli_section_dict: Dict[str, str],\n        write_mode: bool\n    ) -&gt; Tuple[str, List[prof.Alter], Dict[str, Any]]:\n        \"\"\"Get parts for the markdown control corresponding to Editable Content - along with the set-parameter dict.\"\"\"\n        control_id = control_path.stem\n\n        md_api = MarkdownAPI()\n        yaml_header, control_tree = md_api.processor.process_control_markdown(control_path, cli_section_dict, part_label_to_id_map)  # noqa: E501\n        # extract the sort_id if present in header\n        sort_id = yaml_header.get(const.SORT_ID, control_id)\n\n        editable_node = None\n        for header in list(control_tree.get_all_headers_for_level(1)):\n            if header.startswith('# Editable'):\n                editable_node = control_tree.get_node_for_key(header)\n                break\n        if not editable_node:\n            return sort_id, [], {}\n\n        editable_parts = control_tree.get_editable_parts_and_subparts()\n        by_id_parts = control_tree.get_by_id_parts()\n        found_sections = [p.name for p in editable_parts]\n\n        # Validate that all required sections have a prose\n        for editable_part in editable_parts:\n            if not write_mode and editable_part.name in required_sections_list and editable_part.prose.startswith(\n                    const.PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT):\n                raise TrestleError(f'Control {control_id} is missing prose for required section {editable_part.title}')\n\n        # Validate that all required sections are present\n        missing_sections = set(required_sections_list) - set(found_sections)\n        if missing_sections:\n            raise TrestleError(f'Control {control_id} is missing required sections {missing_sections}')\n        param_dict: Dict[str, Any] = {}\n        # get set_params from the header and add to parm_dict\n        header_params = yaml_header.get(const.SET_PARAMS_TAG, {})\n        if header_params:\n            param_dict.update(header_params)\n\n        props, props_by_id = ControlReader.get_props_list(control_id, part_label_to_id_map, yaml_header)\n\n        # When adding props without by_id it can either be starting or ending and we default to ending\n        # This is the default behavior as described for implicit binding in\n        # https://pages.nist.gov/OSCAL/concepts/processing/profile-resolution/\n        # When adding props to a part using by_id, it is the same situation because it cannot be before or after since\n        # props are not in the same list as parts\n\n        adds: List[prof.Add] = []\n\n        # add the parts and props at control level\n        if editable_parts or props:\n            adds.append(\n                prof.Add(\n                    parts=none_if_empty(editable_parts),\n                    props=none_if_empty(props),\n                    position=prof.PositionValidValues.ending.value\n                )\n            )\n\n        # add the parts and props at the part level, by-id\n        by_ids = set(by_id_parts.keys()).union(props_by_id.keys())\n        for by_id in sorted(by_ids):\n            parts = by_id_parts.get(by_id, None)\n            props = props_by_id.get(by_id, None)\n            adds.append(prof.Add(parts=parts, props=props, position=prof.PositionValidValues.ending.value, by_id=by_id))\n\n        new_alters = []\n        if adds:\n            new_alters = [prof.Alter(control_id=control_id, adds=adds)]\n        return sort_id, new_alters, param_dict\n\n    @staticmethod\n    def _update_display_prop_namespace(item: TypeWithProps):\n        \"\"\"Set namespace for special property display_name.\"\"\"\n        for prop in as_list(item.props):\n            if prop.name == const.DISPLAY_NAME:\n                prop.ns = const.TRESTLE_GENERIC_NS\n\n    @staticmethod\n    def read_control(control_path: pathlib.Path, set_parameters_flag: bool) -&gt; Tuple[cat.Control, str]:\n        \"\"\"Read the control and group title from the markdown file.\"\"\"\n        control = gens.generate_sample_model(cat.Control)\n        md_api = MarkdownAPI()\n        yaml_header, control_tree = md_api.processor.process_control_markdown(control_path)\n        control_titles = list(control_tree.get_all_headers_for_level(1))\n        if len(control_titles) == 0:\n            raise TrestleError(f'Control markdown: {control_path} contains no control title.')\n        if len(control_titles) &gt; 1:\n            raise TrestleError(f'Control markdown: {control_path} contains multiple control titles {control_titles}.')\n\n        control.id = control_tree.subnodes[0].content.control_id\n        group_title = control_tree.subnodes[0].content.control_group\n        control.title = control_tree.subnodes[0].content.control_title\n\n        control_statement = control_tree.get_control_statement()\n        statement_part = control_statement.content.part\n\n        control.parts = [statement_part] if statement_part else None\n        control_objective = control_tree.get_control_objective()\n        if control_objective is not None:\n            objective_part = control_objective.content.part\n            if objective_part:\n                if control.parts:\n                    control.parts.append(objective_part)\n                else:\n                    control.parts = [objective_part]\n\n        control_guidance = control_tree.get_control_guidance()\n        if control_guidance is not None:\n            guidance_part = control_guidance.content.part\n            if guidance_part:\n                if control.parts:\n                    control.parts.append(guidance_part)\n                else:\n                    control.parts = [guidance_part]\n\n        all_other_parts = []\n        for section_node in control_tree.get_other_control_parts():\n            parts = section_node.content.part\n            all_other_parts.extend([parts])\n        if all_other_parts:\n            if control.parts:\n                control.parts.extend(all_other_parts)\n            else:\n                control.parts = all_other_parts\n\n        if set_parameters_flag:\n            params: Dict[str, str] = yaml_header.get(const.SET_PARAMS_TAG, [])\n            if params:\n                control.params = []\n                for id_, param_dict in params.items():\n                    param_dict['id'] = id_\n                    param = ModelUtils.dict_to_parameter(param_dict)\n                    # if display_name is in list of properties, set its namespace\n                    ControlReader._update_display_prop_namespace(param)\n                    control.params.append(param)\n        sort_id = deep_get(yaml_header, [const.TRESTLE_GLOBAL_TAG, const.SORT_ID], None)\n        if sort_id:\n            control.props = control.props if control.props else []\n            control.props.append(common.Property(name=const.SORT_ID, value=sort_id))\n        return control, group_title\n</code></pre>"},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader.ControlReader-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader.ControlReader.get_props_list","title":"<code>get_props_list(control_id, label_map, yaml_header)</code>  <code>staticmethod</code>","text":"<p>Get the list of props in the yaml header of this control as separate lists with and without by_id.</p> Source code in <code>trestle/core/control_reader.py</code> <pre><code>@staticmethod\ndef get_props_list(control_id: str, label_map: Dict[str, str],\n                   yaml_header: Dict[str, Any]) -&gt; Tuple[List[common.Property], Dict[str, List[common.Property]]]:\n    \"\"\"Get the list of props in the yaml header of this control as separate lists with and without by_id.\"\"\"\n    prop_list = yaml_header.get(const.TRESTLE_ADD_PROPS_TAG, [])\n    props = []\n    props_by_id = {}\n    for prop_d in prop_list:\n        by_id = prop_d.get('smt-part', None)\n        if by_id and control_id in label_map:\n            by_id = label_map[control_id].get(by_id, by_id)\n        prop = common.Property(name=prop_d['name'], value=prop_d['value'], ns=prop_d.get('ns', None))\n        if by_id:\n            if by_id not in props_by_id:\n                props_by_id[by_id] = []\n            props_by_id[by_id].append(prop)\n        else:\n            props.append(prop)\n    return props, props_by_id\n</code></pre>"},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader.ControlReader.read_control","title":"<code>read_control(control_path, set_parameters_flag)</code>  <code>staticmethod</code>","text":"<p>Read the control and group title from the markdown file.</p> Source code in <code>trestle/core/control_reader.py</code> <pre><code>@staticmethod\ndef read_control(control_path: pathlib.Path, set_parameters_flag: bool) -&gt; Tuple[cat.Control, str]:\n    \"\"\"Read the control and group title from the markdown file.\"\"\"\n    control = gens.generate_sample_model(cat.Control)\n    md_api = MarkdownAPI()\n    yaml_header, control_tree = md_api.processor.process_control_markdown(control_path)\n    control_titles = list(control_tree.get_all_headers_for_level(1))\n    if len(control_titles) == 0:\n        raise TrestleError(f'Control markdown: {control_path} contains no control title.')\n    if len(control_titles) &gt; 1:\n        raise TrestleError(f'Control markdown: {control_path} contains multiple control titles {control_titles}.')\n\n    control.id = control_tree.subnodes[0].content.control_id\n    group_title = control_tree.subnodes[0].content.control_group\n    control.title = control_tree.subnodes[0].content.control_title\n\n    control_statement = control_tree.get_control_statement()\n    statement_part = control_statement.content.part\n\n    control.parts = [statement_part] if statement_part else None\n    control_objective = control_tree.get_control_objective()\n    if control_objective is not None:\n        objective_part = control_objective.content.part\n        if objective_part:\n            if control.parts:\n                control.parts.append(objective_part)\n            else:\n                control.parts = [objective_part]\n\n    control_guidance = control_tree.get_control_guidance()\n    if control_guidance is not None:\n        guidance_part = control_guidance.content.part\n        if guidance_part:\n            if control.parts:\n                control.parts.append(guidance_part)\n            else:\n                control.parts = [guidance_part]\n\n    all_other_parts = []\n    for section_node in control_tree.get_other_control_parts():\n        parts = section_node.content.part\n        all_other_parts.extend([parts])\n    if all_other_parts:\n        if control.parts:\n            control.parts.extend(all_other_parts)\n        else:\n            control.parts = all_other_parts\n\n    if set_parameters_flag:\n        params: Dict[str, str] = yaml_header.get(const.SET_PARAMS_TAG, [])\n        if params:\n            control.params = []\n            for id_, param_dict in params.items():\n                param_dict['id'] = id_\n                param = ModelUtils.dict_to_parameter(param_dict)\n                # if display_name is in list of properties, set its namespace\n                ControlReader._update_display_prop_namespace(param)\n                control.params.append(param)\n    sort_id = deep_get(yaml_header, [const.TRESTLE_GLOBAL_TAG, const.SORT_ID], None)\n    if sort_id:\n        control.props = control.props if control.props else []\n        control.props.append(common.Property(name=const.SORT_ID, value=sort_id))\n    return control, group_title\n</code></pre>"},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader.ControlReader.read_control_info_from_md","title":"<code>read_control_info_from_md(control_file, context)</code>  <code>staticmethod</code>","text":"<p>Find all labels and associated implementation prose in the markdown for this control.</p> <p>Parameters:</p> Name Type Description Default <code>control_file</code> <code>Path</code> <p>path to the control markdown file</p> required <code>context</code> <code>ControlContext</code> <p>context of the control usage</p> required <p>Returns:</p> Type Description <code>Dict[str, List[str]]</code> <p>The yaml header as dict in second part of tuple.</p> <code>CompDict</code> <p>Adds to the passed in comp_dict.</p> Source code in <code>trestle/core/control_reader.py</code> <pre><code>@staticmethod\ndef read_control_info_from_md(control_file: pathlib.Path,\n                              context: ControlContext) -&gt; Tuple[Dict[str, List[str]], CompDict]:\n    \"\"\"\n    Find all labels and associated implementation prose in the markdown for this control.\n\n    Args:\n        control_file: path to the control markdown file\n        context: context of the control usage\n\n    Returns:\n        The yaml header as dict in second part of tuple.\n        Adds to the passed in comp_dict.\n    \"\"\"\n    yaml_header = {}\n    comp_dict = {}\n\n    if not control_file.exists():\n        return yaml_header, comp_dict\n    # if the file exists, load the contents but do not use prose from comp_dict\n    # for non ssp or component mode just use empty string for comp\n    comp_name = ''\n    try:\n        control_id = control_file.stem\n        if context.purpose == ContextPurpose.COMPONENT:\n            comp_name = context.comp_name if context.comp_name else const.SSP_MAIN_COMP_NAME\n\n        md_api = MarkdownAPI()\n        yaml_header, control_md = md_api.processor.process_markdown(control_file)\n\n        # first get the header strings, including statement labels, for statement imp reqs\n        imp_string = '## Implementation '\n        headers = control_md.get_all_headers_for_level(2)\n        # get e.g. ## Implementation a.  ## Implementation b. etc\n        imp_header_list = [header for header in headers if header.startswith(imp_string)]\n\n        # now get the (one) header for the main solution\n        main_headers = list(control_md.get_all_headers_for_key(const.SSP_MD_IMPLEMENTATION_QUESTION, False))\n        # should be only one header, so warn if others found\n        if main_headers:\n            if len(main_headers) &gt; 1:\n                logger.warning(\n                    f'Control {control_id} has {len(main_headers)} main header responses.  Will use first one only.'\n                )\n            main_header = main_headers[0]\n            node = control_md.get_all_nodes_for_keys([main_header], False)[0]\n            # this node is top level so it will have empty label\n            # it may have subnodes of Rules, Implementation Status, Implementaton Remarks\n            ControlReader._add_node_to_dict(comp_name, '', comp_dict, node, control_id, [], context)\n        for imp_header in imp_header_list:\n            label = ControlReader._get_label_from_implementation_header(imp_header)\n            node = control_md.get_node_for_key(imp_header)\n            ControlReader._add_node_to_dict(comp_name, label, comp_dict, node, control_id, [], context)\n\n    except TrestleError as e:\n        raise TrestleError(f'Error occurred reading {control_file}: {e}')\n    return yaml_header, comp_dict\n</code></pre>"},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader.ControlReader.read_editable_content","title":"<code>read_editable_content(control_path, required_sections_list, part_label_to_id_map, cli_section_dict, write_mode)</code>  <code>staticmethod</code>","text":"<p>Get parts for the markdown control corresponding to Editable Content - along with the set-parameter dict.</p> Source code in <code>trestle/core/control_reader.py</code> <pre><code>@staticmethod\ndef read_editable_content(\n    control_path: pathlib.Path,\n    required_sections_list: List[str],\n    part_label_to_id_map: Dict[str, Dict[str, str]],\n    cli_section_dict: Dict[str, str],\n    write_mode: bool\n) -&gt; Tuple[str, List[prof.Alter], Dict[str, Any]]:\n    \"\"\"Get parts for the markdown control corresponding to Editable Content - along with the set-parameter dict.\"\"\"\n    control_id = control_path.stem\n\n    md_api = MarkdownAPI()\n    yaml_header, control_tree = md_api.processor.process_control_markdown(control_path, cli_section_dict, part_label_to_id_map)  # noqa: E501\n    # extract the sort_id if present in header\n    sort_id = yaml_header.get(const.SORT_ID, control_id)\n\n    editable_node = None\n    for header in list(control_tree.get_all_headers_for_level(1)):\n        if header.startswith('# Editable'):\n            editable_node = control_tree.get_node_for_key(header)\n            break\n    if not editable_node:\n        return sort_id, [], {}\n\n    editable_parts = control_tree.get_editable_parts_and_subparts()\n    by_id_parts = control_tree.get_by_id_parts()\n    found_sections = [p.name for p in editable_parts]\n\n    # Validate that all required sections have a prose\n    for editable_part in editable_parts:\n        if not write_mode and editable_part.name in required_sections_list and editable_part.prose.startswith(\n                const.PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT):\n            raise TrestleError(f'Control {control_id} is missing prose for required section {editable_part.title}')\n\n    # Validate that all required sections are present\n    missing_sections = set(required_sections_list) - set(found_sections)\n    if missing_sections:\n        raise TrestleError(f'Control {control_id} is missing required sections {missing_sections}')\n    param_dict: Dict[str, Any] = {}\n    # get set_params from the header and add to parm_dict\n    header_params = yaml_header.get(const.SET_PARAMS_TAG, {})\n    if header_params:\n        param_dict.update(header_params)\n\n    props, props_by_id = ControlReader.get_props_list(control_id, part_label_to_id_map, yaml_header)\n\n    # When adding props without by_id it can either be starting or ending and we default to ending\n    # This is the default behavior as described for implicit binding in\n    # https://pages.nist.gov/OSCAL/concepts/processing/profile-resolution/\n    # When adding props to a part using by_id, it is the same situation because it cannot be before or after since\n    # props are not in the same list as parts\n\n    adds: List[prof.Add] = []\n\n    # add the parts and props at control level\n    if editable_parts or props:\n        adds.append(\n            prof.Add(\n                parts=none_if_empty(editable_parts),\n                props=none_if_empty(props),\n                position=prof.PositionValidValues.ending.value\n            )\n        )\n\n    # add the parts and props at the part level, by-id\n    by_ids = set(by_id_parts.keys()).union(props_by_id.keys())\n    for by_id in sorted(by_ids):\n        parts = by_id_parts.get(by_id, None)\n        props = props_by_id.get(by_id, None)\n        adds.append(prof.Add(parts=parts, props=props, position=prof.PositionValidValues.ending.value, by_id=by_id))\n\n    new_alters = []\n    if adds:\n        new_alters = [prof.Alter(control_id=control_id, adds=adds)]\n    return sort_id, new_alters, param_dict\n</code></pre>"},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader.ControlReader.read_implemented_requirement","title":"<code>read_implemented_requirement(control_file, context)</code>  <code>staticmethod</code>","text":"<p>Get the implementated requirement associated with given control and link to existing components or new ones.</p> <p>Parameters:</p> Name Type Description Default <code>control_file</code> <code>Path</code> <p>path of the control markdown file</p> required <code>context</code> <code>ControlContext</code> <p>context of the control usage</p> required <p>Returns:</p> Name Type Description <code>Tuple</code> <code>Tuple[str, ImplementedRequirement]</code> <p>The control sort-id and the one implemented requirement for this control.</p> Notes <p>Each statement may have several responses, with each response in a by_component for a specific component. statement_map keeps track of statements that may have several by_component responses. This is only used during component assemble and only for updating one component.</p> Source code in <code>trestle/core/control_reader.py</code> <pre><code>@staticmethod\ndef read_implemented_requirement(control_file: pathlib.Path,\n                                 context: ControlContext) -&gt; Tuple[str, comp.ImplementedRequirement]:\n    \"\"\"\n    Get the implementated requirement associated with given control and link to existing components or new ones.\n\n    Args:\n        control_file: path of the control markdown file\n        context: context of the control usage\n\n    Returns:\n        Tuple: The control sort-id and the one implemented requirement for this control.\n\n    Notes:\n        Each statement may have several responses, with each response in a by_component for a specific component.\n        statement_map keeps track of statements that may have several by_component responses.\n        This is only used during component assemble and only for updating one component.\n    \"\"\"\n    control_id = control_file.stem\n    md_header, md_comp_dict = ControlReader.read_control_info_from_md(control_file, context)\n    comp_name = context.component.title\n\n    statement_map: Dict[str, comp.Statement] = {}\n    # create a new implemented requirement linked to the control id to hold the statements\n    imp_req = gens.generate_sample_model(comp.ImplementedRequirement)\n    imp_req.control_id = control_id\n\n    imp_req.statements = []\n    comp_dict = md_comp_dict[comp_name]\n    for label, comp_info in comp_dict.items():\n        # if no label it applies to the imp_req itself rather than a statement\n        if not label:\n            imp_req.description = ControlReader._handle_empty_prose(comp_info.prose, control_id)\n            ControlInterface.insert_status_in_props(imp_req, comp_info.status)\n            continue\n        statement_id = ControlInterface.create_statement_id(control_id)\n        if label in ['', const.STATEMENT]:\n            statement_part_id = statement_id\n        else:\n            clean_label = label.strip('.')\n            statement_part_id = ControlInterface.strip_to_make_ncname(f'{statement_id}.{clean_label}')\n        if statement_part_id in statement_map:\n            statement = statement_map[statement_part_id]\n        else:\n            statement = gens.generate_sample_model(comp.Statement)\n            statement.statement_id = statement_part_id\n            statement_map[statement_part_id] = statement\n        statement.description = comp_info.prose\n        statement.props = none_if_empty(ControlInterface.clean_props(comp_info.props))\n        ControlInterface.insert_status_in_props(statement, comp_info.status)\n\n    imp_req.statements = list(statement_map.values())\n    imp_req.set_parameters = []\n\n    for _, param_dict_list in md_header.get(const.COMP_DEF_RULES_PARAM_VALS_TAG, {}).items():\n        for param_dict in param_dict_list:\n            values = param_dict.get(const.VALUES, [])\n            comp_values = param_dict.get(const.COMPONENT_VALUES, [])\n            values = comp_values if comp_values else values\n            set_param = ossp.SetParameter(param_id=param_dict['name'], values=values)\n            imp_req.set_parameters.append(set_param)\n    imp_req.statements = none_if_empty(list(statement_map.values()))\n    imp_req.set_parameters = none_if_empty(imp_req.set_parameters)\n\n    ControlReader._insert_header_content(imp_req, md_header, control_id)\n    sort_id = md_header.get(const.SORT_ID, control_id)\n    return sort_id, imp_req\n</code></pre>"},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader.ControlReader.simplify_name","title":"<code>simplify_name(name)</code>  <code>staticmethod</code>","text":"<p>Simplify the name to ignore variations in case, space, hyphen, underscore, slash.</p> Source code in <code>trestle/core/control_reader.py</code> <pre><code>@staticmethod\ndef simplify_name(name: str) -&gt; str:\n    \"\"\"Simplify the name to ignore variations in case, space, hyphen, underscore, slash.\"\"\"\n    return name.lower().replace(' ', '').replace('-', '').replace('_', '').replace('/', '')\n</code></pre>"},{"location":"reference/API/trestle/core/control_reader/#trestle.core.control_reader-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_writer/","title":"trestle.core.control_writer","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/control_writer/#trestle.core.control_writer","title":"<code>trestle.core.control_writer</code>","text":"<p>Handle writing of controls to markdown.</p>"},{"location":"reference/API/trestle/core/control_writer/#trestle.core.control_writer-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/control_writer/#trestle.core.control_writer.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/control_writer/#trestle.core.control_writer-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/control_writer/#trestle.core.control_writer.ControlWriter","title":"<code>ControlWriter</code>","text":"<p>Class to write controls as markdown.</p> Source code in <code>trestle/core/control_writer.py</code> <pre><code>class ControlWriter():\n    \"\"\"Class to write controls as markdown.\"\"\"\n\n    def __init__(self):\n        \"\"\"Initialize the class.\"\"\"\n        self._md_file: Optional[MDWriter] = None\n\n    def _add_part_and_its_items(self, control: cat.Control, name: str, item_type: str) -&gt; None:\n        \"\"\"For a given control add its one statement and its items to the md file after replacing params.\"\"\"\n        items = []\n        if control.parts:\n            for part in control.parts:\n                if part.name == name:\n                    # If the part has prose write it as a raw line and not list element\n                    skip_id = part.id\n                    if part.prose:\n                        self._md_file.new_line(part.prose)\n                    items.append(ControlInterface.get_part(part, item_type, skip_id))\n            # unwrap the list if it is many levels deep\n            while not isinstance(items, str) and len(items) == 1:\n                items = items[0]\n            self._md_file.new_paragraph()\n            self._md_file.new_list(items)\n\n    def _add_yaml_header(self, yaml_header: Optional[Dict]) -&gt; None:\n        if yaml_header:\n            self._md_file.add_yaml_header(yaml_header)\n\n    def _add_control_statement(self, control: cat.Control, group_title: str, print_group_title=True) -&gt; None:\n        \"\"\"Add the control statement and items to the md file.\"\"\"\n        self._md_file.new_paragraph()\n        control_id = control.id\n        group_name = ''\n        control_title = control.title\n\n        if print_group_title:\n            group_name = r' \\[' + group_title + r'\\]'\n\n        title = f'{control_id} -{group_name} {control_title}'\n\n        header_title = 'Control Statement'\n        self._md_file.new_header(level=1, title=title)\n        self._md_file.new_header(level=2, title=header_title)\n        self._md_file.set_indent_level(-1)\n        self._add_part_and_its_items(control, const.STATEMENT, const.ITEM)\n        self._md_file.set_indent_level(-1)\n\n    def _add_control_objective(self, control: cat.Control) -&gt; None:\n        if control.parts:\n            for part in control.parts:\n                if part.name == const.OBJECTIVE_PART or part.name == const.ASSESMENT_OBJECTIVE_PART:\n                    self._md_file.new_paragraph()\n                    heading_title = 'Control Objective'\n                    if part.name == const.ASSESMENT_OBJECTIVE_PART:\n                        heading_title = 'Control Assessment Objective'\n                    self._md_file.new_header(level=2, title=heading_title)\n                    self._md_file.set_indent_level(-1)\n                    self._add_part_and_its_items(control, part.name, part.name)\n                    self._md_file.set_indent_level(-1)\n                    return\n\n    def _add_sections(self, control: cat.Control, allowed_sections: Optional[List[str]]) -&gt; None:\n        \"\"\"Add the extra control sections after the main ones.\"\"\"\n        skip_section_list = [const.STATEMENT, const.ITEM, const.OBJECTIVE_PART, const.ASSESMENT_OBJECTIVE_PART]\n        while True:\n            _, name, title, prose = ControlInterface.get_section(control, skip_section_list)\n            if not name:\n                return\n            if allowed_sections and name not in allowed_sections:\n                skip_section_list.append(name)\n                continue\n            if prose:\n                # section title will be from the section_dict, the part title, or the part name in that order\n                # this way the user-provided section title can override the part title\n                section_title = self._sections_dict.get(name, title) if self._sections_dict else title\n                section_title = section_title if section_title else name\n                skip_section_list.append(name)\n                self._md_file.new_header(level=2, title=f'Control {section_title}')\n                self._md_file.new_line(prose)\n                self._md_file.new_paragraph()\n\n    def _insert_status(self, status: ImplementationStatus, level: int) -&gt; None:\n        self._md_file.new_header(level=level, title=f'{const.IMPLEMENTATION_STATUS_HEADER}: {status.state}')\n        # this used to output remarks also\n\n    def _insert_rules(self, rules: List[str], level: int) -&gt; None:\n        if rules:\n            self._md_file.new_header(level=level, title='Rules:')\n            self._md_file.set_indent_level(0)\n            self._md_file.new_list(rules)\n            self._md_file.set_indent_level(-1)\n\n    def _insert_comp_info(\n        self, part_label: str, comp_info: Dict[str, ComponentImpInfo], context: ControlContext\n    ) -&gt; None:\n        \"\"\"Insert prose and status from the component info.\"\"\"\n        level = 3 if context.purpose == ContextPurpose.COMPONENT else 4\n        if part_label in comp_info:\n            info = comp_info[part_label]\n            if context.purpose in [ContextPurpose.COMPONENT, ContextPurpose.SSP] and not self._include_component(info):\n                return\n            self._md_file.new_paragraph()\n            if info.prose:\n                self._md_file.new_line(info.prose)\n            else:\n                self._md_file.new_line(f'{const.SSP_ADD_IMPLEMENTATION_FOR_ITEM_TEXT} {part_label} --&gt;')\n\n            self._insert_rules(info.rules, level)\n            self._insert_status(info.status, level)\n        else:\n            self._insert_status(ImplementationStatus(state=const.STATUS_PLANNED), level)\n\n    def _process_main_component(self, part_id: str, part_label: str, comp_dict: CompDict) -&gt; None:\n        \"\"\"Handle prompts for This System component.\"\"\"\n        self._md_file.new_paragraph()\n        self._md_file.new_header(3, const.SSP_MAIN_COMP_NAME)\n        self._md_file.new_paragraph()\n        prose = f'{const.SSP_ADD_THIS_SYSTEM_IMPLEMENTATION_FOR_CONTROL_TEXT}: {part_id} --&gt;'\n        status = ImplementationStatus(state=const.STATUS_PLANNED)\n        sys_comp_dict: Dict[str, ComponentImpInfo] = comp_dict.get(const.SSP_MAIN_COMP_NAME, {})\n        if sys_comp_dict and part_label in sys_comp_dict:\n            comp_info = sys_comp_dict[part_label]\n            if comp_info.prose:\n                prose = comp_info.prose\n            status = comp_info.status\n        self._md_file.new_paraline(prose)\n        self._insert_status(status, 4)\n\n    def _add_component_control_prompts(self, control_id: str, comp_dict: CompDict, context: ControlContext) -&gt; bool:\n        \"\"\"Add prompts to the markdown for the control itself, per component.\"\"\"\n        if context.purpose not in [ContextPurpose.COMPONENT, ContextPurpose.SSP]:\n            return False\n        self._md_file.new_paraline(const.STATUS_PROMPT)\n        self._md_file.new_paraline(const.RULES_WARNING)\n        did_write = False\n        # do special handling for This System\n        if context.purpose == ContextPurpose.SSP:\n            # Passing in the control id and the empty key ('') for the label\n            self._process_main_component(control_id, '', comp_dict)\n            did_write = True\n\n        sorted_comp_names = sorted(comp_dict.keys())\n        for comp_name in sorted_comp_names:\n            dic = comp_dict[comp_name]\n            # This System already handled\n            if comp_name == const.SSP_MAIN_COMP_NAME:\n                continue\n            for comp_info in [val for key, val in dic.items() if key == '']:\n                # don't output component name for component markdown since only one component\n                if context.purpose != ContextPurpose.COMPONENT:\n                    self._md_file.new_header(3, comp_name)\n                prose = comp_info.prose if comp_info.prose != control_id else ''\n                if not prose:\n                    prose = f'{const.SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT}: {control_id} --&gt;'\n                self._md_file.new_paraline(prose)\n                level = 3 if context.purpose == ContextPurpose.COMPONENT else 4\n                self._insert_rules(comp_info.rules, level)\n                self._insert_status(comp_info.status, level)\n                did_write = True\n        return did_write\n\n    def _add_implementation_response_prompts(\n        self, control: cat.Control, comp_dict: CompDict, context: ControlContext\n    ) -&gt; None:\n        \"\"\"Add the response request text for all parts to the markdown along with the header.\"\"\"\n        self._md_file.new_hr()\n        self._md_file.new_paragraph()\n        # top level request for implementation details\n        self._md_file.new_header(level=2, title=f'{const.SSP_MD_IMPLEMENTATION_QUESTION}')\n\n        # write out control level prose and status\n        did_write_part = self._add_component_control_prompts(control.id, comp_dict, context)\n\n        # if the control has no parts written out then enter implementation in the top level entry\n        # but if it does have parts written out, leave top level blank and provide details in the parts\n        # Note that parts corresponding to sections don't get written out here so a check is needed\n        # If we have responses per component then enter them in separate ### sections\n        if control.parts:\n            for part in control.parts:\n                if part.parts and part.name == const.STATEMENT:\n                    for prt in part.parts:\n                        if prt.name != const.ITEM:\n                            continue\n                        # if no label guess the label from the sub-part id\n                        part_label = ControlInterface.get_label(prt)\n                        part_label = prt.id.split('.')[-1] if not part_label else part_label\n\n                        # Determine if this part should be written out\n                        if self._skip_part(context, part_label, comp_dict):\n                            continue\n\n                        if not did_write_part:\n                            self._md_file.new_line(const.SSP_MD_LEAVE_BLANK_TEXT)\n                            # insert extra line to make mdformat happy\n                            self._md_file._add_line_raw('')\n                        self._md_file.new_hr()\n                        self._md_file.new_header(level=2, title=f'Implementation for part {part_label}')\n                        wrote_label_content = False\n                        # To reduce verbosity by default, the main component\n                        # is conditionally written for each part dependant on the control context.\n                        if context.purpose == ContextPurpose.SSP and context.include_all_parts:\n                            self._process_main_component(prt.id, part_label, comp_dict)\n                            wrote_label_content = True\n                        sorted_comp_names = sorted(comp_dict.keys())\n                        for comp_name in sorted_comp_names:\n                            # This System already handled\n                            if comp_name == const.SSP_MAIN_COMP_NAME:\n                                continue\n                            dic = comp_dict[comp_name]\n                            if part_label in dic:\n                                # insert the component name for ssp but not for comp_def\n                                # because there should only be one component in generated comp_def markdown\n                                if context.purpose != ContextPurpose.COMPONENT:\n                                    self._md_file.new_header(level=3, title=comp_name)\n                                self._insert_comp_info(part_label, dic, context)\n                                wrote_label_content = True\n                        if not wrote_label_content:\n                            level = 3 if context.purpose == ContextPurpose.COMPONENT else 4\n                            self._insert_status(ImplementationStatus(state=const.STATUS_PLANNED), level)\n                        self._md_file.new_paragraph()\n                        did_write_part = True\n        # if we loaded nothing for this control yet then it must need a fresh prompt for the control statement\n        if not comp_dict and not did_write_part:\n            self._md_file.new_line(f'{const.SSP_ADD_IMPLEMENTATION_FOR_CONTROL_TEXT}: {control.id} --&gt;')\n            if context.purpose in [ContextPurpose.COMPONENT, ContextPurpose.SSP]:\n                status = ControlInterface.get_status_from_props(control)\n                self._insert_status(status, 3)\n        if not did_write_part:\n            part_label = ''\n            for comp_name, dic in comp_dict.items():\n                if part_label in dic:\n                    if comp_name != const.SSP_MAIN_COMP_NAME:\n                        self._md_file.new_header(level=3, title=comp_name)\n                    self._insert_comp_info(part_label, dic, context)\n        self._md_file.new_hr()\n\n    def _include_component(self, comp_info: ComponentImpInfo) -&gt; bool:\n        \"\"\"\n        Check if a component has the required Markdown fields.\n\n        Notes: This is a simple function to centralize logic to check\n        when a component meets the requirement to get written to Markdown.\n        \"\"\"\n        if comp_info.rules or comp_info.prose:\n            return True\n        return False\n\n    def _skip_part(self, context: ControlContext, part_label: str, comp_dict: CompDict) -&gt; bool:\n        \"\"\"\n        Check if a part should be skipped based on rules and context.\n\n        Notes: The default logic is to conditionally add control parts based\n        on whether the component has rules or existing prose associated with that part. This can be\n        changed using the control context for SSP markdown.\n        \"\"\"\n        if context.purpose == ContextPurpose.SSP and context.include_all_parts:\n            return False\n        else:\n            skip_item = True\n            for _, dic in comp_dict.items():\n                if part_label in dic:\n                    if self._include_component(dic[part_label]):\n                        skip_item = False\n                        break\n        return skip_item\n\n    def _dump_subpart_infos(self, level: int, part: Dict[str, Any]) -&gt; None:\n        name = part['name']\n        title = self._sections_dict.get(name, name) if self._sections_dict else name\n        self._md_file.new_header(level=level, title=title)\n        if 'prose' in part:\n            self._md_file.new_paraline(part['prose'])\n        for subpart in as_list(part.get('parts', None)):\n            self._dump_subpart_infos(level + 1, subpart)\n\n    def _dump_subparts(self, level: int, part: Part) -&gt; None:\n        name = part.name\n        title = self._sections_dict.get(name, name) if self._sections_dict else name\n        self._md_file.new_header(level=level, title=title)\n        if part.prose:\n            self._md_file.new_paraline(part.prose)\n        for subpart in as_list(part.parts):\n            self._dump_subparts(level + 1, subpart)\n\n    def _dump_section(self, level: int, part: Part, added_sections: List[str], prefix: str) -&gt; None:\n        title = self._sections_dict.get(part.name, part.name) if self._sections_dict else part.name\n        title = f'{prefix} {title}' if prefix else title\n        self._md_file.new_header(level=level, title=title)\n        if part.prose:\n            self._md_file.new_paraline(part.prose)\n        for subpart in as_list(part.parts):\n            self._dump_subparts(level + 1, subpart)\n        added_sections.append(part.name)\n\n    def _dump_section_info(self, level: int, part: Dict[str, Any], added_sections: List[str], prefix: str) -&gt; None:\n        part_prose = part.get('prose', None)\n        part_subparts = part.get('parts', None)\n        name = part['name']\n        title = self._sections_dict.get(name, name) if self._sections_dict else name\n        title = f'{prefix} {title}' if prefix else title\n        self._md_file.new_header(level=level, title=title)\n        if part_prose:\n            self._md_file.new_paraline(part_prose)\n        for subpart in as_list(part_subparts):\n            self._dump_subpart_infos(level + 1, subpart)\n        added_sections.append(name)\n\n    def _add_additional_content(\n        self,\n        control: cat.Control,\n        profile: prof.Profile,\n        header: Dict[str, Any],\n        part_id_map: Dict[str, str],\n        found_alters: List[prof.Alter]\n    ) -&gt; List[str]:\n        # get part and subpart info from adds of the profile\n        part_infos = ControlInterface.get_all_add_info(control.id, profile)\n        has_content = len(part_infos) &gt; 0\n\n        self._md_file.new_header(level=1, title=const.EDITABLE_CONTENT)\n        self._md_file.new_line('&lt;!-- Make additions and edits below --&gt;')\n        self._md_file.new_line(\n            '&lt;!-- The above represents the contents of the control as received by the profile, prior to additions. --&gt;'  # noqa E501\n        )\n        self._md_file.new_line(\n            '&lt;!-- If the profile makes additions to the control, they will appear below. --&gt;'  # noqa E501\n        )\n        self._md_file.new_line(\n            '&lt;!-- The above markdown may not be edited but you may edit the content below, and/or introduce new additions to be made by the profile. --&gt;'  # noqa E501\n        )\n        self._md_file.new_line(\n            '&lt;!-- If there is a yaml header at the top, parameter values may be edited. Use --set-parameters to incorporate the changes during assembly. --&gt;'  # noqa E501\n        )\n        self._md_file.new_line(\n            '&lt;!-- The content here will then replace what is in the profile for this control, after running profile-assemble. --&gt;'  # noqa E501\n        )\n        if has_content:\n            self._md_file.new_line(\n                '&lt;!-- The added parts in the profile for this control are below.  You may edit them and/or add new ones. --&gt;'  # noqa E501\n            )\n        else:\n            self._md_file.new_line(\n                '&lt;!-- The current profile has no added parts for this control, but you may add new ones here. --&gt;'\n            )\n        self._md_file.new_line(\n            '&lt;!-- Each addition must have a heading either of the form ## Control my_addition_name --&gt;'\n        )\n        self._md_file.new_line('&lt;!-- or ## Part a. (where the a. refers to one of the control statement labels.) --&gt;')\n        self._md_file.new_line('&lt;!-- \"## Control\" parts are new parts added after the statement part. --&gt;')\n        self._md_file.new_line(\n            '&lt;!-- \"## Part\" parts are new parts added into the top-level statement part with that label. --&gt;'\n        )\n        self._md_file.new_line('&lt;!-- Subparts may be added with nested hash levels of the form ### My Subpart Name --&gt;')\n        self._md_file.new_line('&lt;!-- underneath the parent ## Control or ## Part being added --&gt;')\n        self._md_file.new_line(\n            '&lt;!-- See https://oscal-compass.github.io/compliance-trestle/tutorials/ssp_profile_catalog_authoring/ssp_profile_catalog_authoring for guidance. --&gt;'  # noqa E501\n        )\n        # next is to make mdformat happy\n        self._md_file._add_line_raw('')\n\n        added_sections: List[str] = []\n\n        control_part_id_map = part_id_map.get(control.id, {})\n        statement_id = ControlInterface.get_statement_id(control)\n\n        # if the file already has markdown content, read its alters\n        if self._md_file.exists():\n            if const.TRESTLE_ADD_PROPS_TAG in header:\n                header.pop(const.TRESTLE_ADD_PROPS_TAG)\n            for alter in found_alters:\n                for add in as_list(alter.adds):\n                    # by_id could refer to statement (Control) or part (Part)\n                    if add.by_id:\n                        # is this a part that goes after the control statement\n                        if add.by_id == statement_id:\n                            for part in as_list(add.parts):\n                                if part.prose or part.parts:\n                                    self._dump_section(2, part, added_sections, 'Control')\n                        else:\n                            # or is it a sub-part of a statement part\n                            part_label = control_part_id_map.get(add.by_id, add.by_id)\n                            if add.parts:\n                                self._md_file.new_header(level=2, title=f'Part {part_label}')\n                                for part in as_list(add.parts):\n                                    if part.prose or part.parts:\n                                        name = part.name\n                                        # need special handling for statement parts because their name is 'item'\n                                        # get the short name as last piece of the part id after the '.'\n                                        if name == const.ITEM:\n                                            name = part.id.split('.')[-1]\n                                        title = self._sections_dict.get(name, name) if self._sections_dict else name\n                                        self._md_file.new_header(level=3, title=title)\n                                        if part.prose:\n                                            self._md_file.new_paraline(part.prose)\n                                        for subpart in as_list(part.parts):\n                                            self._dump_subparts(3, subpart)\n                                        added_sections.append(name)\n                    else:\n                        # if not by_id just add at end of control's parts\n                        for part in as_list(add.parts):\n                            if part.prose or part.parts:\n                                self._dump_section(2, part, added_sections, 'Control')\n                    if add.props:\n                        if const.TRESTLE_ADD_PROPS_TAG not in header:\n                            header[const.TRESTLE_ADD_PROPS_TAG] = []\n                        by_id = add.by_id\n                        part_info = PartInfo(name='', prose='', props=add.props, smt_part=by_id)\n                        _, prop_list = part_info.to_dicts(part_id_map.get(control.id, {}))\n                        header[const.TRESTLE_ADD_PROPS_TAG].extend(prop_list)\n        else:\n            # md does not already exist so fill in directly\n            in_part = ''\n            for part_info in part_infos:\n                part, prop_list = part_info.to_dicts(part_id_map.get(control.id, {}))\n                # is this part of a statement part\n                if part_info.smt_part and part_info.prose and part_info.smt_part in control_part_id_map:\n                    # avoid outputting ## Part again if in same part\n                    if not part_info.smt_part == in_part:\n                        in_part = part_info.smt_part\n                        part_label = control_part_id_map.get(part_info.smt_part, part_info.smt_part)\n                        self._md_file.new_header(level=2, title=f'Part {part_label}')\n                    self._dump_section_info(3, part, added_sections, '')\n                # is it a control part\n                elif part_info.prose or part_info.parts:\n                    in_part = ''\n                    self._dump_section_info(2, part, added_sections, 'Control')\n                elif prop_list:\n                    in_part = ''\n                    if const.TRESTLE_ADD_PROPS_TAG not in header:\n                        header[const.TRESTLE_ADD_PROPS_TAG] = []\n                    header[const.TRESTLE_ADD_PROPS_TAG].extend(prop_list)\n        return added_sections\n\n    def _prompt_required_sections(self, required_sections: List[str], added_sections: List[str]) -&gt; None:\n        \"\"\"Add prompts for any required sections that haven't already been written out.\"\"\"\n        missing_sections = set(required_sections).difference(added_sections)\n        for section in sorted(missing_sections):\n            section_title = self._sections_dict.get(section, section)\n            self._md_file.new_header(2, f'Control {section_title}')\n            self._md_file.new_line(f'{const.PROFILE_ADD_REQUIRED_SECTION_FOR_CONTROL_TEXT}: {section_title} --&gt;')\n\n    @staticmethod\n    def _merge_headers(memory_header: Dict[str, Any], md_header: Dict[str, Any],\n                       context: ControlContext) -&gt; Dict[str, Any]:\n        merged_header = copy.deepcopy(md_header)\n        ControlInterface.merge_dicts_deep(merged_header, memory_header, False, 1)\n        return merged_header\n\n    def write_control_for_editing(\n        self,\n        context: ControlContext,\n        control: cat.Control,\n        dest_path: pathlib.Path,\n        group_title: str,\n        part_id_map: Dict[str, str],\n        found_alters: List[prof.Alter]\n    ) -&gt; None:\n        \"\"\"\n        Write out the control in markdown format into the specified directory.\n\n        Args:\n            context: The context of the control usage\n            control: The control to write as markdown\n            dest_path: Path to the directory where the control will be written\n            group_title: Title of the group containing the control\n            part_id_map: Mapping of part_id to label\n            found_alters: List of alters read from the markdown file - if it exists\n\n        Returns:\n            None\n\n        Notes:\n            The filename is constructed from the control's id and created in the dest_path.\n            If a yaml header is present in the file, new values in provided header will not replace those in the\n            markdown header unless overwrite_header_values is true.  If it is true then overwrite any existing values,\n            but in all cases new items from the provided header will be added to the markdown header.\n            If the markdown file already exists, its current header and prose are read.\n            Controls are checked if they are marked withdrawn, and if so they are not written out.\n        \"\"\"\n        if ControlInterface.is_withdrawn(control):\n            logger.debug(f'Not writing out control {control.id} since it is marked Withdrawn.')\n            return\n\n        control_file = dest_path / (control.id + const.MARKDOWN_FILE_EXT)\n        # read the existing markdown header and content if it exists\n        md_header, comp_dict = ControlReader.read_control_info_from_md(control_file, context)\n        # Merge the memory comp_dict with the md one if control exists\n        if comp_dict:\n            template_comp_dict = context.comp_dict\n            ControlInterface.merge_dicts_deep(comp_dict, template_comp_dict, False)\n            context.comp_dict = comp_dict\n\n        header_comment_dict = {const.TRESTLE_ADD_PROPS_TAG: const.YAML_PROPS_COMMENT}\n        if context.to_markdown:\n            if context.purpose == ContextPurpose.PROFILE:\n                header_comment_dict[const.SET_PARAMS_TAG] = const.YAML_PROFILE_VALUES_COMMENT\n            elif context.purpose == ContextPurpose.SSP:\n                header_comment_dict[const.SET_PARAMS_TAG] = const.YAML_SSP_VALUES_COMMENT\n                header_comment_dict[const.COMP_DEF_RULES_PARAM_VALS_TAG] = const.YAML_RULE_PARAM_VALUES_SSP_COMMENT\n                # The add props information to SSP only. It is added to the profile later.\n                if const.TRESTLE_ADD_PROPS_TAG not in md_header:\n                    md_header[const.TRESTLE_ADD_PROPS_TAG] = []\n            elif context.purpose == ContextPurpose.COMPONENT:\n                header_comment_dict[const.COMP_DEF_RULES_PARAM_VALS_TAG\n                                    ] = const.YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT\n\n        # begin adding info to the md file\n        self._md_file = MDWriter(control_file, header_comment_dict)\n        self._sections_dict = context.sections_dict\n\n        context.merged_header = ControlWriter._merge_headers(context.merged_header, md_header, context)\n        # if the control has an explicitly defined sort-id and there is none in the yaml_header, then insert it\n        # in the yaml header and allow overwrite_header_values to control whether it overwrites an existing one\n        # in the markdown header\n        context.cli_yaml_header = as_dict(context.cli_yaml_header)\n        if context.purpose != ContextPurpose.PROFILE:\n            ControlInterface.merge_dicts_deep(\n                context.merged_header, context.cli_yaml_header, context.overwrite_header_values\n            )\n        # the global contents are special and get overwritten on generate\n        set_or_pop(\n            context.merged_header,\n            const.TRESTLE_GLOBAL_TAG,\n            context.cli_yaml_header.get(const.TRESTLE_GLOBAL_TAG, None)\n        )\n        sort_id = ControlInterface.get_sort_id(control, True)\n        if sort_id:\n            deep_set(context.merged_header, [const.TRESTLE_GLOBAL_TAG, const.SORT_ID], sort_id)\n\n        # merge any provided sections with sections in the header, with priority to the one from context (e.g. CLI)\n        header_sections_dict = context.merged_header.get(const.SECTIONS_TAG, {})\n        merged_sections_dict = merge_dicts(header_sections_dict, context.sections_dict)\n        set_or_pop(context.merged_header, const.SECTIONS_TAG, merged_sections_dict)\n\n        # now begin filling in content from the control in memory\n        self._add_control_statement(control, group_title)\n\n        self._add_control_objective(control)\n\n        # add allowed sections to the markdown\n        self._add_sections(control, context.allowed_sections)\n\n        # prompt responses for imp reqs using special format if comp_def mode\n        if context.prompt_responses:\n            self._add_implementation_response_prompts(control, context.comp_dict, context)\n\n        # for profile generate\n        # add sections corresponding to added parts in the profile\n        added_sections: List[str] = []\n        if context.purpose == ContextPurpose.PROFILE:\n            added_sections = self._add_additional_content(\n                control, context.profile, context.merged_header, part_id_map, found_alters\n            )\n\n        self._add_yaml_header(context.merged_header)\n\n        if context.required_sections:\n            self._prompt_required_sections(context.required_sections, added_sections)\n\n        self._md_file.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/control_writer/#trestle.core.control_writer.ControlWriter-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/control_writer/#trestle.core.control_writer.ControlWriter.__init__","title":"<code>__init__()</code>","text":"<p>Initialize the class.</p> Source code in <code>trestle/core/control_writer.py</code> <pre><code>def __init__(self):\n    \"\"\"Initialize the class.\"\"\"\n    self._md_file: Optional[MDWriter] = None\n</code></pre>"},{"location":"reference/API/trestle/core/control_writer/#trestle.core.control_writer.ControlWriter.write_control_for_editing","title":"<code>write_control_for_editing(context, control, dest_path, group_title, part_id_map, found_alters)</code>","text":"<p>Write out the control in markdown format into the specified directory.</p> <p>Parameters:</p> Name Type Description Default <code>context</code> <code>ControlContext</code> <p>The context of the control usage</p> required <code>control</code> <code>Control</code> <p>The control to write as markdown</p> required <code>dest_path</code> <code>Path</code> <p>Path to the directory where the control will be written</p> required <code>group_title</code> <code>str</code> <p>Title of the group containing the control</p> required <code>part_id_map</code> <code>Dict[str, str]</code> <p>Mapping of part_id to label</p> required <code>found_alters</code> <code>List[Alter]</code> <p>List of alters read from the markdown file - if it exists</p> required <p>Returns:</p> Type Description <code>None</code> <p>None</p> Notes <p>The filename is constructed from the control's id and created in the dest_path. If a yaml header is present in the file, new values in provided header will not replace those in the markdown header unless overwrite_header_values is true.  If it is true then overwrite any existing values, but in all cases new items from the provided header will be added to the markdown header. If the markdown file already exists, its current header and prose are read. Controls are checked if they are marked withdrawn, and if so they are not written out.</p> Source code in <code>trestle/core/control_writer.py</code> <pre><code>def write_control_for_editing(\n    self,\n    context: ControlContext,\n    control: cat.Control,\n    dest_path: pathlib.Path,\n    group_title: str,\n    part_id_map: Dict[str, str],\n    found_alters: List[prof.Alter]\n) -&gt; None:\n    \"\"\"\n    Write out the control in markdown format into the specified directory.\n\n    Args:\n        context: The context of the control usage\n        control: The control to write as markdown\n        dest_path: Path to the directory where the control will be written\n        group_title: Title of the group containing the control\n        part_id_map: Mapping of part_id to label\n        found_alters: List of alters read from the markdown file - if it exists\n\n    Returns:\n        None\n\n    Notes:\n        The filename is constructed from the control's id and created in the dest_path.\n        If a yaml header is present in the file, new values in provided header will not replace those in the\n        markdown header unless overwrite_header_values is true.  If it is true then overwrite any existing values,\n        but in all cases new items from the provided header will be added to the markdown header.\n        If the markdown file already exists, its current header and prose are read.\n        Controls are checked if they are marked withdrawn, and if so they are not written out.\n    \"\"\"\n    if ControlInterface.is_withdrawn(control):\n        logger.debug(f'Not writing out control {control.id} since it is marked Withdrawn.')\n        return\n\n    control_file = dest_path / (control.id + const.MARKDOWN_FILE_EXT)\n    # read the existing markdown header and content if it exists\n    md_header, comp_dict = ControlReader.read_control_info_from_md(control_file, context)\n    # Merge the memory comp_dict with the md one if control exists\n    if comp_dict:\n        template_comp_dict = context.comp_dict\n        ControlInterface.merge_dicts_deep(comp_dict, template_comp_dict, False)\n        context.comp_dict = comp_dict\n\n    header_comment_dict = {const.TRESTLE_ADD_PROPS_TAG: const.YAML_PROPS_COMMENT}\n    if context.to_markdown:\n        if context.purpose == ContextPurpose.PROFILE:\n            header_comment_dict[const.SET_PARAMS_TAG] = const.YAML_PROFILE_VALUES_COMMENT\n        elif context.purpose == ContextPurpose.SSP:\n            header_comment_dict[const.SET_PARAMS_TAG] = const.YAML_SSP_VALUES_COMMENT\n            header_comment_dict[const.COMP_DEF_RULES_PARAM_VALS_TAG] = const.YAML_RULE_PARAM_VALUES_SSP_COMMENT\n            # The add props information to SSP only. It is added to the profile later.\n            if const.TRESTLE_ADD_PROPS_TAG not in md_header:\n                md_header[const.TRESTLE_ADD_PROPS_TAG] = []\n        elif context.purpose == ContextPurpose.COMPONENT:\n            header_comment_dict[const.COMP_DEF_RULES_PARAM_VALS_TAG\n                                ] = const.YAML_RULE_PARAM_VALUES_COMPONENT_COMMENT\n\n    # begin adding info to the md file\n    self._md_file = MDWriter(control_file, header_comment_dict)\n    self._sections_dict = context.sections_dict\n\n    context.merged_header = ControlWriter._merge_headers(context.merged_header, md_header, context)\n    # if the control has an explicitly defined sort-id and there is none in the yaml_header, then insert it\n    # in the yaml header and allow overwrite_header_values to control whether it overwrites an existing one\n    # in the markdown header\n    context.cli_yaml_header = as_dict(context.cli_yaml_header)\n    if context.purpose != ContextPurpose.PROFILE:\n        ControlInterface.merge_dicts_deep(\n            context.merged_header, context.cli_yaml_header, context.overwrite_header_values\n        )\n    # the global contents are special and get overwritten on generate\n    set_or_pop(\n        context.merged_header,\n        const.TRESTLE_GLOBAL_TAG,\n        context.cli_yaml_header.get(const.TRESTLE_GLOBAL_TAG, None)\n    )\n    sort_id = ControlInterface.get_sort_id(control, True)\n    if sort_id:\n        deep_set(context.merged_header, [const.TRESTLE_GLOBAL_TAG, const.SORT_ID], sort_id)\n\n    # merge any provided sections with sections in the header, with priority to the one from context (e.g. CLI)\n    header_sections_dict = context.merged_header.get(const.SECTIONS_TAG, {})\n    merged_sections_dict = merge_dicts(header_sections_dict, context.sections_dict)\n    set_or_pop(context.merged_header, const.SECTIONS_TAG, merged_sections_dict)\n\n    # now begin filling in content from the control in memory\n    self._add_control_statement(control, group_title)\n\n    self._add_control_objective(control)\n\n    # add allowed sections to the markdown\n    self._add_sections(control, context.allowed_sections)\n\n    # prompt responses for imp reqs using special format if comp_def mode\n    if context.prompt_responses:\n        self._add_implementation_response_prompts(control, context.comp_dict, context)\n\n    # for profile generate\n    # add sections corresponding to added parts in the profile\n    added_sections: List[str] = []\n    if context.purpose == ContextPurpose.PROFILE:\n        added_sections = self._add_additional_content(\n            control, context.profile, context.merged_header, part_id_map, found_alters\n        )\n\n    self._add_yaml_header(context.merged_header)\n\n    if context.required_sections:\n        self._prompt_required_sections(context.required_sections, added_sections)\n\n    self._md_file.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/control_writer/#trestle.core.control_writer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/docs_control_writer/","title":"trestle.core.docs_control_writer","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer","title":"<code>trestle.core.docs_control_writer</code>","text":"<p>Handle writing of controls to markdown for docs purposes.</p>"},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer.DocsControlWriter","title":"<code>DocsControlWriter</code>","text":"<p>               Bases: <code>ControlWriter</code></p> <p>Class to write controls as markdown for docs purposes.</p> Source code in <code>trestle/core/docs_control_writer.py</code> <pre><code>class DocsControlWriter(ControlWriter):\n    \"\"\"Class to write controls as markdown for docs purposes.\"\"\"\n\n    def write_control_with_sections(\n        self,\n        control: cat.Control,\n        profile: prof.Profile,\n        group_title: str,\n        sections: List[str],\n        sections_dict: Optional[Dict[str, str]] = None,\n        label_column: bool = True,\n        add_group_to_title: bool = False\n    ) -&gt; str:\n        \"\"\"Write the control into markdown file with specified sections.\"\"\"\n        self._md_file = MDWriter(None)\n        self._sections_dict = sections_dict if sections_dict else {}\n        tag_pattern = '{: #[.]}'  # noqa: FS003 - not f string but tag\n        if not isinstance(group_title, str):\n            raise TrestleError(f'Group title must be provided and be a string, instead received: {group_title}')\n\n        for section in sections:\n            if 'statement' == section:\n                self._add_control_statement(control, group_title, add_group_to_title, tag_pattern=tag_pattern)\n\n            elif const.OBJECTIVE_PART == section:\n                self._add_control_objective(control, tag_pattern=tag_pattern)\n\n            elif 'table_of_parameters' == section:\n                self.get_param_table(\n                    control, label_column, section_dict=sections_dict, tag_pattern=tag_pattern, md_file=self._md_file\n                )\n            else:\n                self._add_one_section(control, profile, section, tag_pattern=tag_pattern)\n\n        return '\\n'.join(self._md_file._lines)\n\n    def get_control_statement_ssp(self, control: cat.Control) -&gt; List[str]:\n        \"\"\"Get the control statement as formatted markdown from a control formatted for SSP.\"\"\"\n        self._md_file = MDWriter(None)\n        self._add_control_statement_ssp(control)\n        return self._md_file.get_lines()\n\n    def get_param_table(\n        self,\n        control: cat.Control,\n        label_column: bool = False,\n        section_dict: Optional[Dict[str, str]] = None,\n        tag_pattern: str = None,\n        md_file: MDWriter = None\n    ) -&gt; List[str]:\n        \"\"\"Get parameters of a control as a markdown table for ssp_io, with optional third label column.\"\"\"\n\n        def _get_displayname_if_exists(param_id: str) -&gt; str:\n            for param in as_filtered_list(control.params, lambda p: p.id == param_id):\n                for prop in as_filtered_list(param.props, lambda p: p.name == const.DISPLAY_NAME):\n                    return prop.value\n            return param_id\n\n        param_dict = ControlInterface.get_control_param_dict(control, False)\n\n        if param_dict:\n            if md_file:\n                self._md_file = md_file\n            else:\n                self._md_file = MDWriter(None)\n            header_title = 'Table of Parameters'\n            if section_dict:\n                header_title = section_dict.get(const.TABLE_OF_PARAMS_PART, 'Table of Parameters')\n            self._md_file.new_paragraph()\n            self._md_file.new_header(level=2, title=header_title, add_new_line_after_header=not tag_pattern)\n            if tag_pattern:\n                self._md_file.new_line(tag_pattern.replace('[.]', header_title.replace(' ', '-').lower()))\n                self._md_file.new_paragraph()\n            self._md_file.set_indent_level(-1)\n            if label_column:\n                self._md_file.new_table(\n                    [\n                        [\n                            _get_displayname_if_exists(key),\n                            ControlInterface.param_to_str(param_dict[key], ParameterRep.VALUE_OR_EMPTY_STRING),\n                            ControlInterface.param_to_str(param_dict[key], ParameterRep.LABEL_OR_CHOICES, True),\n                        ] for key in param_dict.keys()\n                    ], ['Parameter ID', 'Values', 'Label or Choices']\n                )\n            else:\n                self._md_file.new_table(\n                    [\n                        [\n                            _get_displayname_if_exists(key),\n                            ControlInterface.param_to_str(param_dict[key], ParameterRep.VALUE_OR_LABEL_OR_CHOICES)\n                        ] for key in param_dict.keys()\n                    ], ['Parameter ID', 'Values']\n                )\n            self._md_file.set_indent_level(-1)\n            if tag_pattern:\n                bottom_tag_pattern = '{: #\\\"Parameters for [.]\\\" caption-side=\\\"top\\\"}'  # noqa: FS003 - not f string\n                control_id = self._get_pretty_control_id_if_exists(control)\n                self._md_file.new_line(bottom_tag_pattern.replace('[.]', control_id))\n                self._md_file.new_paragraph()\n            return self._md_file.get_lines()\n\n        return []\n\n    def _add_control_statement(\n        self, control: cat.Control, group_title: str, print_group_title: bool = True, tag_pattern: str = None\n    ) -&gt; None:\n        \"\"\"Add the control statement and items to the md file.\"\"\"\n        self._md_file.new_paragraph()\n\n        group_name = ''\n        control_title = control.title\n\n        if print_group_title:\n            group_name = ' \\[' + group_title + '\\]'\n\n        control_id = self._get_pretty_control_id_if_exists(control)\n\n        title = f'{control_id} -{group_name} {control_title}'\n\n        header_title = self._sections_dict.get(const.STATEMENT, 'Control Statement')\n        self._md_file.new_header(level=1, title=title, add_new_line_after_header=not tag_pattern)\n        if tag_pattern:\n            self._md_file.new_line(tag_pattern.replace('[.]', control.id))\n            self._md_file.new_paragraph()\n\n        self._md_file.new_header(level=2, title=header_title, add_new_line_after_header=not tag_pattern)\n        if tag_pattern:\n            self._md_file.new_line(tag_pattern.replace('[.]', header_title.replace(' ', '-').lower()))\n            self._md_file.new_paragraph()\n\n        self._md_file.set_indent_level(-1)\n        self._add_part_and_its_items(control, const.STATEMENT, const.ITEM)\n        self._md_file.set_indent_level(-1)\n\n    def _add_control_objective(self, control: cat.Control, tag_pattern: str = None) -&gt; None:\n        if control.parts:\n            for part in control.parts:\n                if part.name == const.OBJECTIVE_PART:\n                    self._md_file.new_paragraph()\n                    heading_title = self._sections_dict.get(const.OBJECTIVE_PART, 'Control Objective')\n                    self._md_file.new_header(level=2, title=heading_title, add_new_line_after_header=not tag_pattern)\n                    if tag_pattern:\n                        self._md_file.new_line(tag_pattern.replace('[.]', heading_title.replace(' ', '-').lower()))\n                        self._md_file.new_paragraph()\n                    self._md_file.set_indent_level(-1)\n                    self._add_part_and_its_items(control, const.OBJECTIVE_PART, const.OBJECTIVE_PART)\n                    self._md_file.set_indent_level(-1)\n                    return\n\n    def _add_one_section(\n        self, control: cat.Control, profile: prof.Profile, section: str, tag_pattern: Optional[str] = None\n    ) -&gt; None:\n        \"\"\"Add specific control section.\"\"\"\n        prose = ControlInterface.get_control_section_prose(control, section)\n        if prose:\n            section_title = self._sections_dict.get(section, section)\n            heading_title = f'{section_title}'\n            self._md_file.new_header(level=2, title=heading_title, add_new_line_after_header=not tag_pattern)\n            if tag_pattern:\n                self._md_file.new_line(tag_pattern.replace('[.]', heading_title.replace(' ', '-').lower()))\n                self._md_file.new_paragraph()\n            self._md_file.new_line(prose)\n            self._md_file.new_paragraph()\n        else:\n            # write parts and subparts if exist\n            part_infos = ControlInterface.get_all_add_info(control.id, profile)\n            for part_info in part_infos:\n                if part_info.name == section:\n                    self._write_part_info(part_info, section, tag_pattern)\n                    break\n\n    def _write_part_info(\n        self,\n        part_info: PartInfo,\n        section_name: str,\n        tag_pattern: Optional[str] = None,\n        section_prefix: str = '',\n        heading_level: int = 2\n    ) -&gt; None:\n        section_title = self._sections_dict.get(section_name, part_info.name)\n\n        heading_title = f'{section_title}'\n        tag_section_name = section_prefix + f'{section_title}'\n        tag_section_name = re.sub(const.MATCH_ALL_EXCEPT_LETTERS_UNDERSCORE_SPACE_REGEX, '', tag_section_name)\n        tag_section_name = tag_section_name.replace(' ', '-').replace('_', '-').lower()\n        self._md_file.new_header(level=heading_level, title=heading_title, add_new_line_after_header=not tag_pattern)\n        if tag_pattern:\n            self._md_file.new_line(tag_pattern.replace('[.]', tag_section_name))\n            self._md_file.new_paragraph()\n        prose = '' if part_info.prose is None else part_info.prose\n        self._md_file.new_line(prose)\n        self._md_file.new_paragraph()\n\n        for subpart_info in as_list(part_info.parts):\n            self._write_part_info(\n                subpart_info, subpart_info.name, tag_pattern, tag_section_name + '-', heading_level + 1\n            )\n\n    def _get_pretty_control_id_if_exists(self, control: cat.Control) -&gt; str:\n        control_id = control.id.upper()\n        if control.props:\n            # Take control id from the properties\n            for prop in control.props:\n                if prop.name == 'label':\n                    control_id = prop.value\n                    break\n        return control_id\n\n    def _add_control_statement_ssp(self, control: cat.Control) -&gt; None:\n        \"\"\"Add the control statement and items to the markdown SSP.\"\"\"\n        self._md_file.new_paragraph()\n        label = ControlInterface.get_label(control)\n        label = label if label else control.id.upper()\n        title = f'{label} - {control.title}'\n        self._md_file.new_header(level=1, title=title)\n        self._md_file.new_header(level=2, title='Control Statement')\n        self._md_file.set_indent_level(-1)\n        self._add_part_and_its_items(control, const.STATEMENT, const.ITEM)\n        self._md_file.set_indent_level(-1)\n</code></pre>"},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer.DocsControlWriter-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer.DocsControlWriter.get_control_statement_ssp","title":"<code>get_control_statement_ssp(control)</code>","text":"<p>Get the control statement as formatted markdown from a control formatted for SSP.</p> Source code in <code>trestle/core/docs_control_writer.py</code> <pre><code>def get_control_statement_ssp(self, control: cat.Control) -&gt; List[str]:\n    \"\"\"Get the control statement as formatted markdown from a control formatted for SSP.\"\"\"\n    self._md_file = MDWriter(None)\n    self._add_control_statement_ssp(control)\n    return self._md_file.get_lines()\n</code></pre>"},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer.DocsControlWriter.get_param_table","title":"<code>get_param_table(control, label_column=False, section_dict=None, tag_pattern=None, md_file=None)</code>","text":"<p>Get parameters of a control as a markdown table for ssp_io, with optional third label column.</p> Source code in <code>trestle/core/docs_control_writer.py</code> <pre><code>def get_param_table(\n    self,\n    control: cat.Control,\n    label_column: bool = False,\n    section_dict: Optional[Dict[str, str]] = None,\n    tag_pattern: str = None,\n    md_file: MDWriter = None\n) -&gt; List[str]:\n    \"\"\"Get parameters of a control as a markdown table for ssp_io, with optional third label column.\"\"\"\n\n    def _get_displayname_if_exists(param_id: str) -&gt; str:\n        for param in as_filtered_list(control.params, lambda p: p.id == param_id):\n            for prop in as_filtered_list(param.props, lambda p: p.name == const.DISPLAY_NAME):\n                return prop.value\n        return param_id\n\n    param_dict = ControlInterface.get_control_param_dict(control, False)\n\n    if param_dict:\n        if md_file:\n            self._md_file = md_file\n        else:\n            self._md_file = MDWriter(None)\n        header_title = 'Table of Parameters'\n        if section_dict:\n            header_title = section_dict.get(const.TABLE_OF_PARAMS_PART, 'Table of Parameters')\n        self._md_file.new_paragraph()\n        self._md_file.new_header(level=2, title=header_title, add_new_line_after_header=not tag_pattern)\n        if tag_pattern:\n            self._md_file.new_line(tag_pattern.replace('[.]', header_title.replace(' ', '-').lower()))\n            self._md_file.new_paragraph()\n        self._md_file.set_indent_level(-1)\n        if label_column:\n            self._md_file.new_table(\n                [\n                    [\n                        _get_displayname_if_exists(key),\n                        ControlInterface.param_to_str(param_dict[key], ParameterRep.VALUE_OR_EMPTY_STRING),\n                        ControlInterface.param_to_str(param_dict[key], ParameterRep.LABEL_OR_CHOICES, True),\n                    ] for key in param_dict.keys()\n                ], ['Parameter ID', 'Values', 'Label or Choices']\n            )\n        else:\n            self._md_file.new_table(\n                [\n                    [\n                        _get_displayname_if_exists(key),\n                        ControlInterface.param_to_str(param_dict[key], ParameterRep.VALUE_OR_LABEL_OR_CHOICES)\n                    ] for key in param_dict.keys()\n                ], ['Parameter ID', 'Values']\n            )\n        self._md_file.set_indent_level(-1)\n        if tag_pattern:\n            bottom_tag_pattern = '{: #\\\"Parameters for [.]\\\" caption-side=\\\"top\\\"}'  # noqa: FS003 - not f string\n            control_id = self._get_pretty_control_id_if_exists(control)\n            self._md_file.new_line(bottom_tag_pattern.replace('[.]', control_id))\n            self._md_file.new_paragraph()\n        return self._md_file.get_lines()\n\n    return []\n</code></pre>"},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer.DocsControlWriter.write_control_with_sections","title":"<code>write_control_with_sections(control, profile, group_title, sections, sections_dict=None, label_column=True, add_group_to_title=False)</code>","text":"<p>Write the control into markdown file with specified sections.</p> Source code in <code>trestle/core/docs_control_writer.py</code> <pre><code>def write_control_with_sections(\n    self,\n    control: cat.Control,\n    profile: prof.Profile,\n    group_title: str,\n    sections: List[str],\n    sections_dict: Optional[Dict[str, str]] = None,\n    label_column: bool = True,\n    add_group_to_title: bool = False\n) -&gt; str:\n    \"\"\"Write the control into markdown file with specified sections.\"\"\"\n    self._md_file = MDWriter(None)\n    self._sections_dict = sections_dict if sections_dict else {}\n    tag_pattern = '{: #[.]}'  # noqa: FS003 - not f string but tag\n    if not isinstance(group_title, str):\n        raise TrestleError(f'Group title must be provided and be a string, instead received: {group_title}')\n\n    for section in sections:\n        if 'statement' == section:\n            self._add_control_statement(control, group_title, add_group_to_title, tag_pattern=tag_pattern)\n\n        elif const.OBJECTIVE_PART == section:\n            self._add_control_objective(control, tag_pattern=tag_pattern)\n\n        elif 'table_of_parameters' == section:\n            self.get_param_table(\n                control, label_column, section_dict=sections_dict, tag_pattern=tag_pattern, md_file=self._md_file\n            )\n        else:\n            self._add_one_section(control, profile, section, tag_pattern=tag_pattern)\n\n    return '\\n'.join(self._md_file._lines)\n</code></pre>"},{"location":"reference/API/trestle/core/docs_control_writer/#trestle.core.docs_control_writer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/draw_io/","title":"trestle.core.draw_io","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io","title":"<code>trestle.core.draw_io</code>","text":"<p>Functionality for reading information from a drawio file.</p>"},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIO","title":"<code>DrawIO</code>","text":"<p>Access and process drawio data / metadata.</p> Source code in <code>trestle/core/draw_io.py</code> <pre><code>class DrawIO():\n    \"\"\"Access and process drawio data / metadata.\"\"\"\n\n    def __init__(self, file_path: pathlib.Path) -&gt; None:\n        \"\"\"\n        Load drawio object into memory.\n\n        args:\n            file_path: Path to the drawio object.\n        \"\"\"\n        self.file_path: pathlib.Path = file_path\n        self._load()\n        self.banned_keys = ['id', 'label']\n\n    def _load(self) -&gt; None:\n        \"\"\"Load the file.\"\"\"\n        if not self.file_path.exists() or self.file_path.is_dir():\n            raise TrestleError(f'Candidate drawio file {str(self.file_path)} does not exist or is a directory')\n        try:\n            self.raw_xml = defusedxml.ElementTree.parse(self.file_path, forbid_dtd=True)\n        except Exception as e:\n            raise TrestleError(f'Exception loading Element tree from file: {e}')\n        self.mx_file = self.raw_xml.getroot()\n        if not self.mx_file.tag == 'mxfile':\n            raise TrestleError('DrawIO file is not a draw io file (mxfile)')\n        self.diagrams = []\n        for diagram in list(self.mx_file):\n            # Determine if compressed or not\n            # Assumption 1 mxGraphModel\n            n_children = len(list(diagram))\n            if n_children == 0:\n                # Compressed object\n                self.diagrams.append(self._uncompress(diagram.text))\n            elif n_children == 1:\n                self.diagrams.append(list(diagram)[0])\n            else:\n                raise TrestleError('Unhandled behaviour in drawio read.')\n\n    def _uncompress(self, compressed_text: str) -&gt; Element:\n        \"\"\"\n        Given a compressed object from a drawio file return an xml element for the mxGraphModel.\n\n        Args:\n            compressed_text: A compressed mxGraphModel from inside an mxfile\n\n        Returns:\n            An element containing the mxGraphModel\n        \"\"\"\n        # Assume b64 encode\n        decoded = base64.b64decode(compressed_text)\n        clean_text = unquote(zlib.decompress(decoded, -15).decode(const.FILE_ENCODING))\n        element = defusedxml.ElementTree.fromstring(clean_text, forbid_dtd=True)\n        if not element.tag == 'mxGraphModel':\n            raise TrestleError('Unknown data structure within a compressed drawio file.')\n        return element\n\n    def get_metadata(self) -&gt; List[Dict[str, str]]:\n        \"\"\"Get metadata from each tab if it exists or provide an empty dict.\"\"\"\n        # Note that id and label are special for drawio.\n        md_list: List[Dict[str, str]] = []\n        for diagram in self.diagrams:\n            md_dict: Dict[str, str] = {}\n            # Drawio creates data within a root and then an object element type\n            children = list(diagram)\n            root_obj = children[0]\n            md_objects = root_obj.findall('object')\n            # Should always be true - to test presumptions.\n            if len(md_objects) == 0:\n                md_list.append(md_dict)\n                continue\n            items = md_objects[0].items()\n            for item in items:\n                key = item[0]\n                val = item[1]\n                if key in self.banned_keys:\n                    continue\n                md_dict[key] = val\n            md_list.append(md_dict)\n        return md_list\n\n    @classmethod\n    def restructure_metadata(cls, input_dict: Dict[str, str]) -&gt; Dict[str, Any]:\n        \"\"\"Restructure metadata into a hierarchial dict assuming a period separator.\"\"\"\n        # get the list of duplicate keys\n        # Get a count of keys\n        result = {}\n        key_map = {}\n        for keys in input_dict.keys():\n            stub = keys.split('.')[0]\n            tmp = key_map.get(stub, [])\n            tmp.append(keys)\n            key_map[stub] = tmp\n\n        for key, values in key_map.items():\n            holding = {}\n            if len(values) == 1 and key == values[0]:\n                result[key] = input_dict[key]\n            else:\n                for value in values:\n                    holding[value.split('.', 1)[-1]] = input_dict[value]\n                result[key] = cls.restructure_metadata(holding)\n        return result\n\n    def write_drawio_with_metadata(\n        self, path: pathlib.Path, metadata: Dict, diagram_metadata_idx: int, target_path: pathlib.Path = None\n    ) -&gt; None:\n        \"\"\"\n        Write modified metadata to drawio file.\n\n        Writes given metadata to 'object' element attributes inside of the selected drawio diagram element.\n        Currently supports writing only uncompressed elements.\n\n        Args:\n            path: path to write modified drawio file to\n            metadata: dictionary of modified metadata to insert to drawio\n            diagram_metadata_idx: index of diagram which metadata was modified\n            target_path: if not provided the changes will be written to path\n        \"\"\"\n        flattened_dict = self._flatten_dictionary(metadata)\n        if diagram_metadata_idx &gt;= len(list(self.diagrams)):\n            raise TrestleError(f'Drawio file {path} does not contain a diagram for index {diagram_metadata_idx}')\n\n        diagram = list(self.diagrams)[diagram_metadata_idx]\n        children = list(diagram)\n        root_obj = children[0]\n        md_objects = root_obj.findall('object')\n        if len(md_objects) == 0:\n            raise TrestleError(f'Unable to write metadata, diagram in drawio file {path} does not have objects.')\n\n        for key in md_objects[0].attrib.copy():\n            if key not in flattened_dict.keys() and key not in self.banned_keys:\n                # outdated key delete\n                del md_objects[0].attrib[key]\n                continue\n            if key in self.banned_keys:\n                continue\n            md_objects[0].attrib[key] = flattened_dict[key]\n        for key in flattened_dict.keys():\n            if key in self.banned_keys:\n                continue\n            md_objects[0].attrib[key] = flattened_dict[key]\n        parent_diagram = self.mx_file.findall('diagram')[diagram_metadata_idx]\n        if len(parent_diagram.findall('mxGraphModel')) == 0:\n            parent_diagram.insert(0, diagram)\n\n        if target_path:\n            self.raw_xml.write(target_path)\n        else:\n            self.raw_xml.write(path)\n\n    def _flatten_dictionary(self, metadata: Dict, parent_key='', separator='.') -&gt; Dict[str, str]:\n        \"\"\"Flatten hierarchial dict back to xml attributes.\"\"\"\n        items = []\n        for key, value in metadata.items():\n            new_key = parent_key + separator + key if parent_key else key\n            if isinstance(value, Dict):\n                items.extend(self._flatten_dictionary(value, new_key, separator).items())\n            else:\n                items.append((new_key, value))\n        return dict(items)\n</code></pre>"},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIO-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIO.banned_keys","title":"<code>banned_keys = ['id', 'label']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIO.file_path","title":"<code>file_path: pathlib.Path = file_path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIO-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIO.__init__","title":"<code>__init__(file_path)</code>","text":"<p>Load drawio object into memory.</p> <p>Parameters:</p> Name Type Description Default <code>file_path</code> <code>Path</code> <p>Path to the drawio object.</p> required Source code in <code>trestle/core/draw_io.py</code> <pre><code>def __init__(self, file_path: pathlib.Path) -&gt; None:\n    \"\"\"\n    Load drawio object into memory.\n\n    args:\n        file_path: Path to the drawio object.\n    \"\"\"\n    self.file_path: pathlib.Path = file_path\n    self._load()\n    self.banned_keys = ['id', 'label']\n</code></pre>"},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIO.get_metadata","title":"<code>get_metadata()</code>","text":"<p>Get metadata from each tab if it exists or provide an empty dict.</p> Source code in <code>trestle/core/draw_io.py</code> <pre><code>def get_metadata(self) -&gt; List[Dict[str, str]]:\n    \"\"\"Get metadata from each tab if it exists or provide an empty dict.\"\"\"\n    # Note that id and label are special for drawio.\n    md_list: List[Dict[str, str]] = []\n    for diagram in self.diagrams:\n        md_dict: Dict[str, str] = {}\n        # Drawio creates data within a root and then an object element type\n        children = list(diagram)\n        root_obj = children[0]\n        md_objects = root_obj.findall('object')\n        # Should always be true - to test presumptions.\n        if len(md_objects) == 0:\n            md_list.append(md_dict)\n            continue\n        items = md_objects[0].items()\n        for item in items:\n            key = item[0]\n            val = item[1]\n            if key in self.banned_keys:\n                continue\n            md_dict[key] = val\n        md_list.append(md_dict)\n    return md_list\n</code></pre>"},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIO.restructure_metadata","title":"<code>restructure_metadata(input_dict)</code>  <code>classmethod</code>","text":"<p>Restructure metadata into a hierarchial dict assuming a period separator.</p> Source code in <code>trestle/core/draw_io.py</code> <pre><code>@classmethod\ndef restructure_metadata(cls, input_dict: Dict[str, str]) -&gt; Dict[str, Any]:\n    \"\"\"Restructure metadata into a hierarchial dict assuming a period separator.\"\"\"\n    # get the list of duplicate keys\n    # Get a count of keys\n    result = {}\n    key_map = {}\n    for keys in input_dict.keys():\n        stub = keys.split('.')[0]\n        tmp = key_map.get(stub, [])\n        tmp.append(keys)\n        key_map[stub] = tmp\n\n    for key, values in key_map.items():\n        holding = {}\n        if len(values) == 1 and key == values[0]:\n            result[key] = input_dict[key]\n        else:\n            for value in values:\n                holding[value.split('.', 1)[-1]] = input_dict[value]\n            result[key] = cls.restructure_metadata(holding)\n    return result\n</code></pre>"},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIO.write_drawio_with_metadata","title":"<code>write_drawio_with_metadata(path, metadata, diagram_metadata_idx, target_path=None)</code>","text":"<p>Write modified metadata to drawio file.</p> <p>Writes given metadata to 'object' element attributes inside of the selected drawio diagram element. Currently supports writing only uncompressed elements.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>path to write modified drawio file to</p> required <code>metadata</code> <code>Dict</code> <p>dictionary of modified metadata to insert to drawio</p> required <code>diagram_metadata_idx</code> <code>int</code> <p>index of diagram which metadata was modified</p> required <code>target_path</code> <code>Path</code> <p>if not provided the changes will be written to path</p> <code>None</code> Source code in <code>trestle/core/draw_io.py</code> <pre><code>def write_drawio_with_metadata(\n    self, path: pathlib.Path, metadata: Dict, diagram_metadata_idx: int, target_path: pathlib.Path = None\n) -&gt; None:\n    \"\"\"\n    Write modified metadata to drawio file.\n\n    Writes given metadata to 'object' element attributes inside of the selected drawio diagram element.\n    Currently supports writing only uncompressed elements.\n\n    Args:\n        path: path to write modified drawio file to\n        metadata: dictionary of modified metadata to insert to drawio\n        diagram_metadata_idx: index of diagram which metadata was modified\n        target_path: if not provided the changes will be written to path\n    \"\"\"\n    flattened_dict = self._flatten_dictionary(metadata)\n    if diagram_metadata_idx &gt;= len(list(self.diagrams)):\n        raise TrestleError(f'Drawio file {path} does not contain a diagram for index {diagram_metadata_idx}')\n\n    diagram = list(self.diagrams)[diagram_metadata_idx]\n    children = list(diagram)\n    root_obj = children[0]\n    md_objects = root_obj.findall('object')\n    if len(md_objects) == 0:\n        raise TrestleError(f'Unable to write metadata, diagram in drawio file {path} does not have objects.')\n\n    for key in md_objects[0].attrib.copy():\n        if key not in flattened_dict.keys() and key not in self.banned_keys:\n            # outdated key delete\n            del md_objects[0].attrib[key]\n            continue\n        if key in self.banned_keys:\n            continue\n        md_objects[0].attrib[key] = flattened_dict[key]\n    for key in flattened_dict.keys():\n        if key in self.banned_keys:\n            continue\n        md_objects[0].attrib[key] = flattened_dict[key]\n    parent_diagram = self.mx_file.findall('diagram')[diagram_metadata_idx]\n    if len(parent_diagram.findall('mxGraphModel')) == 0:\n        parent_diagram.insert(0, diagram)\n\n    if target_path:\n        self.raw_xml.write(target_path)\n    else:\n        self.raw_xml.write(path)\n</code></pre>"},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIOMetadataValidator","title":"<code>DrawIOMetadataValidator</code>","text":"<p>Validator to check whether drawio metadata meets validation expectations.</p> Source code in <code>trestle/core/draw_io.py</code> <pre><code>class DrawIOMetadataValidator():\n    \"\"\"Validator to check whether drawio metadata meets validation expectations.\"\"\"\n\n    def __init__(self, template_path: pathlib.Path, must_be_first_tab: bool = True) -&gt; None:\n        \"\"\"\n        Initialize drawio validator.\n\n        Args:\n            template_path: Path to a templated drawio file where metadata will be looked up on the first tab only.\n            must_be_first_tab: Whether to search the candidate file for a metadata across multiple tabs.\n        \"\"\"\n        self.template_path = template_path\n        self.must_be_first_tab = must_be_first_tab\n        # Load metadat from template\n        template_drawio = DrawIO(self.template_path)\n        # Zero index as must be first tab\n        self.template_metadata = template_drawio.get_metadata()[0]\n        self.template_version = MarkdownValidator.extract_template_version(self.template_metadata)\n        if self.template_version not in str(self.template_path):\n            raise TrestleError(\n                f'Version of the template {self.template_version} does not match the path {self.template_path}.'\n                + f'Move the template to the folder {self.template_version}'\n            )\n        if 'Version' in self.template_metadata.keys() and self.template_metadata['Version'] != self.template_version:\n            raise TrestleError(f'Version does not match template-version in template: {self.template_path}.')\n\n    def validate(self, candidate: pathlib.Path) -&gt; bool:\n        \"\"\"\n        Run drawio validation against a candidate file.\n\n        Args:\n            candidate: The path to a candidate markdown file to be validated.\n\n        Returns:\n            Whether or not the validation passes.\n\n        Raises:\n            err.TrestleError: If a file IO / formatting error occurs.\n        \"\"\"\n        logging.info(f'Validating drawio file {candidate} against template file {self.template_path}')\n        candidate_drawio = DrawIO(candidate)\n        drawio_metadata = candidate_drawio.get_metadata()\n\n        if self.must_be_first_tab:\n            return MarkdownValidator.compare_keys(self.template_metadata, drawio_metadata[0])\n        for md_tab in drawio_metadata:\n            status = MarkdownValidator.compare_keys(self.template_metadata, md_tab)\n            if status:\n                return status\n        return False\n</code></pre>"},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIOMetadataValidator-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIOMetadataValidator.must_be_first_tab","title":"<code>must_be_first_tab = must_be_first_tab</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIOMetadataValidator.template_metadata","title":"<code>template_metadata = template_drawio.get_metadata()[0]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIOMetadataValidator.template_path","title":"<code>template_path = template_path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIOMetadataValidator.template_version","title":"<code>template_version = MarkdownValidator.extract_template_version(self.template_metadata)</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIOMetadataValidator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIOMetadataValidator.__init__","title":"<code>__init__(template_path, must_be_first_tab=True)</code>","text":"<p>Initialize drawio validator.</p> <p>Parameters:</p> Name Type Description Default <code>template_path</code> <code>Path</code> <p>Path to a templated drawio file where metadata will be looked up on the first tab only.</p> required <code>must_be_first_tab</code> <code>bool</code> <p>Whether to search the candidate file for a metadata across multiple tabs.</p> <code>True</code> Source code in <code>trestle/core/draw_io.py</code> <pre><code>def __init__(self, template_path: pathlib.Path, must_be_first_tab: bool = True) -&gt; None:\n    \"\"\"\n    Initialize drawio validator.\n\n    Args:\n        template_path: Path to a templated drawio file where metadata will be looked up on the first tab only.\n        must_be_first_tab: Whether to search the candidate file for a metadata across multiple tabs.\n    \"\"\"\n    self.template_path = template_path\n    self.must_be_first_tab = must_be_first_tab\n    # Load metadat from template\n    template_drawio = DrawIO(self.template_path)\n    # Zero index as must be first tab\n    self.template_metadata = template_drawio.get_metadata()[0]\n    self.template_version = MarkdownValidator.extract_template_version(self.template_metadata)\n    if self.template_version not in str(self.template_path):\n        raise TrestleError(\n            f'Version of the template {self.template_version} does not match the path {self.template_path}.'\n            + f'Move the template to the folder {self.template_version}'\n        )\n    if 'Version' in self.template_metadata.keys() and self.template_metadata['Version'] != self.template_version:\n        raise TrestleError(f'Version does not match template-version in template: {self.template_path}.')\n</code></pre>"},{"location":"reference/API/trestle/core/draw_io/#trestle.core.draw_io.DrawIOMetadataValidator.validate","title":"<code>validate(candidate)</code>","text":"<p>Run drawio validation against a candidate file.</p> <p>Parameters:</p> Name Type Description Default <code>candidate</code> <code>Path</code> <p>The path to a candidate markdown file to be validated.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>Whether or not the validation passes.</p> <p>Raises:</p> Type Description <code>TrestleError</code> <p>If a file IO / formatting error occurs.</p> Source code in <code>trestle/core/draw_io.py</code> <pre><code>def validate(self, candidate: pathlib.Path) -&gt; bool:\n    \"\"\"\n    Run drawio validation against a candidate file.\n\n    Args:\n        candidate: The path to a candidate markdown file to be validated.\n\n    Returns:\n        Whether or not the validation passes.\n\n    Raises:\n        err.TrestleError: If a file IO / formatting error occurs.\n    \"\"\"\n    logging.info(f'Validating drawio file {candidate} against template file {self.template_path}')\n    candidate_drawio = DrawIO(candidate)\n    drawio_metadata = candidate_drawio.get_metadata()\n\n    if self.must_be_first_tab:\n        return MarkdownValidator.compare_keys(self.template_metadata, drawio_metadata[0])\n    for md_tab in drawio_metadata:\n        status = MarkdownValidator.compare_keys(self.template_metadata, md_tab)\n        if status:\n            return status\n    return False\n</code></pre>"},{"location":"reference/API/trestle/core/duplicates_validator/","title":"trestle.core.duplicates_validator","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/duplicates_validator/#trestle.core.duplicates_validator","title":"<code>trestle.core.duplicates_validator</code>","text":"<p>Validate by confirming no duplicate uuids.</p>"},{"location":"reference/API/trestle/core/duplicates_validator/#trestle.core.duplicates_validator-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/duplicates_validator/#trestle.core.duplicates_validator.DuplicatesValidator","title":"<code>DuplicatesValidator</code>","text":"<p>               Bases: <code>Validator</code></p> <p>Validator to check for duplicate uuids and param_ids in the model.</p> Source code in <code>trestle/core/duplicates_validator.py</code> <pre><code>class DuplicatesValidator(Validator):\n    \"\"\"Validator to check for duplicate uuids and param_ids in the model.\"\"\"\n\n    def model_is_valid(self, model: OscalBaseModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None) -&gt; bool:\n        \"\"\"\n        Test if the model is valid and contains no duplicate uuids or param_ids.\n\n        args:\n            model: An Oscal model that can be passed to the validator.\n            quiet: Don't report msgs unless invalid.\n\n        returns:\n            True (valid) if the model does not contain duplicate uuid's.\n        \"\"\"\n        if not ModelUtils.has_no_duplicate_values_by_name(model, 'uuid'):\n            return False\n        # only profile, comp-def and ssp have set-params and only set-params have param_id\n        # param_id is required to be unique in profiles but not in other models\n        if isinstance(model, Profile):\n            return ModelUtils.has_no_duplicate_values_by_name(model, 'param_id')\n        return True\n</code></pre>"},{"location":"reference/API/trestle/core/duplicates_validator/#trestle.core.duplicates_validator.DuplicatesValidator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/duplicates_validator/#trestle.core.duplicates_validator.DuplicatesValidator.model_is_valid","title":"<code>model_is_valid(model, quiet, trestle_root=None)</code>","text":"<p>Test if the model is valid and contains no duplicate uuids or param_ids.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>OscalBaseModel</code> <p>An Oscal model that can be passed to the validator.</p> required <code>quiet</code> <code>bool</code> <p>Don't report msgs unless invalid.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>True (valid) if the model does not contain duplicate uuid's.</p> Source code in <code>trestle/core/duplicates_validator.py</code> <pre><code>def model_is_valid(self, model: OscalBaseModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None) -&gt; bool:\n    \"\"\"\n    Test if the model is valid and contains no duplicate uuids or param_ids.\n\n    args:\n        model: An Oscal model that can be passed to the validator.\n        quiet: Don't report msgs unless invalid.\n\n    returns:\n        True (valid) if the model does not contain duplicate uuid's.\n    \"\"\"\n    if not ModelUtils.has_no_duplicate_values_by_name(model, 'uuid'):\n        return False\n    # only profile, comp-def and ssp have set-params and only set-params have param_id\n    # param_id is required to be unique in profiles but not in other models\n    if isinstance(model, Profile):\n        return ModelUtils.has_no_duplicate_values_by_name(model, 'param_id')\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/generators/","title":"trestle.core.generators","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/generators/#trestle.core.generators","title":"<code>trestle.core.generators</code>","text":"<p>Capabilities to allow the generation of various oscal objects.</p>"},{"location":"reference/API/trestle/core/generators/#trestle.core.generators-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.TG","title":"<code>TG = TypeVar('TG', bound=OscalBaseModel)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.sample_base64","title":"<code>sample_base64 = Base64(filename=const.REPLACE_ME, media_type=const.REPLACE_ME, value=sample_base64_value)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.sample_base64_value","title":"<code>sample_base64_value = 0</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.sample_date_value","title":"<code>sample_date_value = '2400-02-29'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.sample_method","title":"<code>sample_method = Methods.EXAMINE</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.sample_observation_type_valid_value","title":"<code>sample_observation_type_valid_value = ObservationTypeValidValues.historic</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.sample_task_valid_value","title":"<code>sample_task_valid_value = TaskValidValues.milestone</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.type_base64","title":"<code>type_base64 = type(sample_base64)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.generate_sample_model","title":"<code>generate_sample_model(model, include_optional=False, depth=-1)</code>","text":"<p>Given a model class, generate an object of that class with sample values.</p> <p>Can generate optional variables with an enabled flag. Any array objects will have a single entry injected into it.</p> <p>Note: Trestle generate will not activate recursive loops irrespective of the depth flag.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>Union[Type[TG], List[TG], Dict[str, TG]]</code> <p>The model type provided. Typically for a user as an OscalBaseModel Subclass.</p> required <code>include_optional</code> <code>bool</code> <p>Whether or not to generate optional fields.</p> <code>False</code> <code>depth</code> <code>int</code> <p>Depth of the tree at which optional fields are generated. Negative values (default) removes the limit.</p> <code>-1</code> <p>Returns:</p> Type Description <code>TG</code> <p>The generated instance with a pro-forma values filled out as best as possible.</p> Source code in <code>trestle/core/generators.py</code> <pre><code>def generate_sample_model(\n    model: Union[Type[TG], List[TG], Dict[str, TG]], include_optional: bool = False, depth: int = -1\n) -&gt; TG:\n    \"\"\"Given a model class, generate an object of that class with sample values.\n\n    Can generate optional variables with an enabled flag. Any array objects will have a single entry injected into it.\n\n    Note: Trestle generate will not activate recursive loops irrespective of the depth flag.\n\n    Args:\n        model: The model type provided. Typically for a user as an OscalBaseModel Subclass.\n        include_optional: Whether or not to generate optional fields.\n        depth: Depth of the tree at which optional fields are generated. Negative values (default) removes the limit.\n\n    Returns:\n        The generated instance with a pro-forma values filled out as best as possible.\n    \"\"\"\n    effective_optional = include_optional and not depth == 0\n\n    model_type = model\n    # This block normalizes model type down to\n    if utils.is_collection_field_type(model):  # type: ignore\n        model_type = utils.get_origin(model)  # type: ignore\n        model = utils.get_inner_type(model)  # type: ignore\n    model = cast(TG, model)  # type: ignore\n\n    model_dict = {}  # type: ignore\n    # this block is needed to avoid situations where an inbuilt is inside a list / dict.\n    # the only time dict ever appears is with include_all, which is handled specially\n    # the only type of collection possible after OSCAL 1.0.0 is list\n    if safe_is_sub(model, OscalBaseModel):\n        for field in model.__fields__:  # type: ignore\n            if model_type in [OscalVersion]:\n                model_dict[field] = OSCAL_VERSION\n                break\n            if field == 'include_all':\n                if include_optional:\n                    model_dict[field] = {}\n                continue\n            outer_type = model.__fields__[field].outer_type_  # type: ignore\n            # next appears to be needed for python 3.7\n            if utils.get_origin(outer_type) == Union:\n                outer_type = outer_type.__args__[0]\n            if model.__fields__[field].required or effective_optional:  # type: ignore\n                # FIXME could be ForwardRef('SystemComponentStatus')\n                if utils.is_collection_field_type(outer_type):\n                    inner_type = utils.get_inner_type(outer_type)\n                    if inner_type == model:\n                        continue\n                    model_dict[field] = generate_sample_model(\n                        outer_type, include_optional=include_optional, depth=depth - 1\n                    )\n                elif is_by_type(outer_type):\n                    model_dict[field] = generate_sample_value_by_type(outer_type, field)\n                elif safe_is_sub(outer_type, OscalBaseModel):\n                    model_dict[field] = generate_sample_model(\n                        outer_type, include_optional=include_optional, depth=depth - 1\n                    )\n                else:\n                    # Handle special cases (hacking)\n                    if model_type in [Base64Datatype]:\n                        model_dict[field] = sample_base64_value\n                    elif model_type in [Base64]:\n                        if field == 'filename':\n                            model_dict[field] = sample_base64.filename\n                        elif field == 'media_type':\n                            model_dict[field] = sample_base64.media_type\n                        elif field == 'value':\n                            model_dict[field] = sample_base64.value\n                    elif model_type in [DateDatatype]:\n                        model_dict[field] = sample_date_value\n                    # Hacking here:\n                    # Root models should ideally not exist, however, sometimes we are stuck with them.\n                    # If that is the case we need sufficient information on the type in order to generate a model.\n                    # E.g. we need the type of the container.\n                    elif field == '__root__' and hasattr(model, '__name__'):\n                        model_dict[field] = generate_sample_value_by_type(\n                            outer_type, str_utils.classname_to_alias(model.__name__, AliasMode.FIELD)\n                        )\n                    else:\n                        model_dict[field] = generate_sample_value_by_type(outer_type, field)\n        # Note: this assumes list constrains in oscal are always 1 as a minimum size. if two this may still fail.\n    else:\n        if model_type is list:\n            return [generate_sample_value_by_type(model, '')]  # type: ignore\n        if model_type is dict:\n            return {const.REPLACE_ME: generate_sample_value_by_type(model, '')}  # type: ignore\n        raise err.TrestleError('Unhandled collection type.')\n    if model_type is list:\n        return [model(**model_dict)]  # type: ignore\n    if model_type is dict:\n        return {const.REPLACE_ME: model(**model_dict)}  # type: ignore\n    return model(**model_dict)  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.generate_sample_value_by_type","title":"<code>generate_sample_value_by_type(type_, field_name)</code>","text":"<p>Given a type, return sample value.</p> <p>Includes the Optional use of passing down a parent_model</p> Source code in <code>trestle/core/generators.py</code> <pre><code>def generate_sample_value_by_type(\n    type_: type,\n    field_name: str,\n) -&gt; Union[datetime, bool, int, str, float, Enum]:\n    \"\"\"Given a type, return sample value.\n\n    Includes the Optional use of passing down a parent_model\n    \"\"\"\n    # FIXME: Should be in separate generator module as it inherits EVERYTHING\n    if is_enum_method(type_):\n        return sample_method\n    if is_enum_task_valid_value(type_):\n        return sample_task_valid_value\n    if is_enum_observation_type_valid_value(type_):\n        return sample_observation_type_valid_value\n    if type_ is Base64:\n        return sample_base64\n    if type_ is datetime:\n        return datetime.now().astimezone()\n    if type_ is bool:\n        return False\n    if type_ is int:\n        return 0\n    if type_ is float:\n        return 0.00\n    if safe_is_sub(type_, ConstrainedStr) or (hasattr(type_, '__name__') and 'ConstrainedStr' in type_.__name__):\n        # This code here is messy. we need to meet a set of constraints. If we do\n        # TODO: handle regex directly\n        if 'uuid' == field_name:\n            return str(uuid.uuid4())\n        # some things like location_uuid in lists arrive here with field_name=''\n        if type_.regex and type_.regex.pattern.startswith('^[0-9A-Fa-f]{8}'):  # type: ignore\n            return const.SAMPLE_UUID_STR\n        if field_name == 'date_authorized':\n            return str(date.today().isoformat())\n        if field_name == 'oscal_version':\n            return OSCAL_VERSION\n        if 'uuid' in field_name:\n            return const.SAMPLE_UUID_STR\n        # Only case where are UUID is required but not in name.\n        if field_name.rstrip('s') == 'member_of_organization':\n            return const.SAMPLE_UUID_STR\n        return const.REPLACE_ME\n    if hasattr(type_, '__name__') and 'ConstrainedIntValue' in type_.__name__:\n        # create an int value as close to the floor as possible does not test upper bound\n        multiple = type_.multiple_of if type_.multiple_of else 1  # type: ignore # default to every integer\n        # this command is a bit of a problem\n        floor = type_.ge if type_.ge else 0  # type: ignore\n        floor = type_.gt + 1 if type_.gt else floor  # type: ignore\n        if math.remainder(floor, multiple) == 0:\n            return floor\n        return (floor + 1) * multiple\n    if safe_is_sub(type_, Enum):\n        # keys and values diverge due to hypens in oscal names\n        return type_(list(type_.__members__.values())[0])  # type: ignore\n    if type_ is str:\n        if field_name == 'oscal_version':\n            return OSCAL_VERSION\n        return const.REPLACE_ME\n    if type_ is pydantic.v1.networks.EmailStr:\n        return pydantic.v1.networks.EmailStr('dummy@sample.com')\n    if type_ is pydantic.v1.networks.AnyUrl:\n        # TODO: Cleanup: this should be usable from a url.. but it's not inuitive.\n        return pydantic.v1.networks.AnyUrl('https://sample.com/replaceme.html', scheme='http', host='sample.com')\n    if type_ is list:\n        raise err.TrestleError(f'Unable to generate sample for type {type_}')\n    # default to empty dict for anything else\n    return {}  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.is_by_type","title":"<code>is_by_type(model_type)</code>","text":"<p>Check for by type.</p> Source code in <code>trestle/core/generators.py</code> <pre><code>def is_by_type(model_type: Union[Type[TG], List[TG], Dict[str, TG]]) -&gt; bool:\n    \"\"\"Check for by type.\"\"\"\n    rval = False\n    if model_type == type_base64:\n        rval = True\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.is_enum_method","title":"<code>is_enum_method(type_)</code>","text":"<p>Test for method.</p> Source code in <code>trestle/core/generators.py</code> <pre><code>def is_enum_method(type_: type) -&gt; bool:\n    \"\"\"Test for method.\"\"\"\n    rval = False\n    if utils.get_origin(type_) == Union:\n        args = typing.get_args(type_)\n        for arg in args:\n            if \"&lt;enum 'Methods'&gt;\" == f'{arg}':\n                rval = True\n                break\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.is_enum_observation_type_valid_value","title":"<code>is_enum_observation_type_valid_value(type_)</code>","text":"<p>Test for observation type valid value.</p> Source code in <code>trestle/core/generators.py</code> <pre><code>def is_enum_observation_type_valid_value(type_: type) -&gt; bool:\n    \"\"\"Test for observation type valid value.\"\"\"\n    rval = False\n    if utils.get_origin(type_) == Union:\n        args = typing.get_args(type_)\n        for arg in args:\n            if \"&lt;enum 'ObservationTypeValidValues'&gt;\" == f'{arg}':\n                rval = True\n                break\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.is_enum_task_valid_value","title":"<code>is_enum_task_valid_value(type_)</code>","text":"<p>Test for task valid value.</p> Source code in <code>trestle/core/generators.py</code> <pre><code>def is_enum_task_valid_value(type_: type) -&gt; bool:\n    \"\"\"Test for task valid value.\"\"\"\n    rval = False\n    if utils.get_origin(type_) == Union:\n        args = typing.get_args(type_)\n        for arg in args:\n            if \"&lt;enum 'TaskValidValues'&gt;\" == f'{arg}':\n                rval = True\n                break\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/core/generators/#trestle.core.generators.safe_is_sub","title":"<code>safe_is_sub(sub, parent)</code>","text":"<p>Is this a subclass of parent.</p> Source code in <code>trestle/core/generators.py</code> <pre><code>def safe_is_sub(sub: Any, parent: Any) -&gt; bool:\n    \"\"\"Is this a subclass of parent.\"\"\"\n    is_class = inspect.isclass(sub)\n    return is_class and issubclass(sub, parent)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/","title":"trestle.core.generic_oscal","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal","title":"<code>trestle.core.generic_oscal</code>","text":"<p>Generic classes to support both SSP and DefinedComponents.</p>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.IMPLEMENTED_REQUIREMENTS","title":"<code>IMPLEMENTED_REQUIREMENTS = 'implemented_requirements'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent","title":"<code>GenericByComponent</code>","text":"<p>               Bases: <code>TrestleBaseModel</code></p> <p>Generic ByComponent for SSP and DefinedComponent.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>class GenericByComponent(TrestleBaseModel):\n    \"\"\"Generic ByComponent for SSP and DefinedComponent.\"\"\"\n\n    # only in SSP\n    component_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'  # noqa FS003\n    ) = Field(\n        ...,\n        alias='component_uuid',\n        description='A machine-oriented identifier reference to the component that is implemeting a given control.',\n        title='Component Universally Unique Identifier Reference',\n    )\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'  # noqa FS003\n    ) = Field(\n        ...,\n        description=  # noqa E251\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this by-component entry elsewhere in this or other OSCAL instances. The locally defined UUID of the by-component entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',  # noqa E501\n        title='By-Component Universally Unique Identifier',\n    )\n    description: str = Field(\n        ...,\n        description=  # noqa E251\n        'An implementation statement that describes how a control or a control statement is implemented within the referenced system component.',  # noqa E501\n        title='Control Implementation Description',\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    set_parameters: Optional[List[GenericSetParameter]] = Field(None, alias='set-parameters')\n    implementation_status: Optional[common.ImplementationStatus] = Field(None, alias='implementation-status')\n    # removed export, inherited, satisfied\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n\n    @staticmethod\n    def generate() -&gt; GenericByComponent:\n        \"\"\"Generate instance of generic ByComponent.\"\"\"\n        uuid = str(uuid4())\n        return GenericByComponent(component_uuid=const.SAMPLE_UUID_STR, uuid=uuid, description='')\n\n    def as_ssp(self) -&gt; ossp.ByComponent:\n        \"\"\"Convert to ssp format.\"\"\"\n        set_params = []\n        for set_param in as_list(self.set_parameters):\n            new_set_param = ossp.SetParameter(\n                param_id=set_param.param_id, values=set_param.values, remarks=set_param.remarks\n            )\n            set_params.append(new_set_param)\n        set_params = none_if_empty(set_params)\n        return ossp.ByComponent(\n            component_uuid=self.component_uuid,\n            uuid=self.uuid,\n            description=self.description,\n            props=self.props,\n            links=self.links,\n            set_parameters=set_params,\n            implementation_status=self.implementation_status,\n            responsible_roles=self.responsible_roles\n        )\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.component_uuid","title":"<code>component_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='component_uuid', description='A machine-oriented identifier reference to the component that is implemeting a given control.', title='Component Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.description","title":"<code>description: str = Field(..., description='An implementation statement that describes how a control or a control statement is implemented within the referenced system component.', title='Control Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.implementation_status","title":"<code>implementation_status: Optional[common.ImplementationStatus] = Field(None, alias='implementation-status')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.set_parameters","title":"<code>set_parameters: Optional[List[GenericSetParameter]] = Field(None, alias='set-parameters')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this by-component entry elsewhere in this or other OSCAL instances. The locally defined UUID of the by-component entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='By-Component Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.as_ssp","title":"<code>as_ssp()</code>","text":"<p>Convert to ssp format.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>def as_ssp(self) -&gt; ossp.ByComponent:\n    \"\"\"Convert to ssp format.\"\"\"\n    set_params = []\n    for set_param in as_list(self.set_parameters):\n        new_set_param = ossp.SetParameter(\n            param_id=set_param.param_id, values=set_param.values, remarks=set_param.remarks\n        )\n        set_params.append(new_set_param)\n    set_params = none_if_empty(set_params)\n    return ossp.ByComponent(\n        component_uuid=self.component_uuid,\n        uuid=self.uuid,\n        description=self.description,\n        props=self.props,\n        links=self.links,\n        set_parameters=set_params,\n        implementation_status=self.implementation_status,\n        responsible_roles=self.responsible_roles\n    )\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericByComponent.generate","title":"<code>generate()</code>  <code>staticmethod</code>","text":"<p>Generate instance of generic ByComponent.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>@staticmethod\ndef generate() -&gt; GenericByComponent:\n    \"\"\"Generate instance of generic ByComponent.\"\"\"\n    uuid = str(uuid4())\n    return GenericByComponent(component_uuid=const.SAMPLE_UUID_STR, uuid=uuid, description='')\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent","title":"<code>GenericComponent</code>","text":"<p>               Bases: <code>TrestleBaseModel</code></p> <p>Generic component for SSP SystemComponent and DefinedComponent.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>class GenericComponent(TrestleBaseModel):\n    \"\"\"Generic component for SSP SystemComponent and DefinedComponent.\"\"\"\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'  # noqa FS003 F722\n    ) = Field(\n        ...,\n        description=  # noqa E251\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this component elsewhere in this or other OSCAL instances. The locally defined UUID of the component can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',  # noqa E501\n        title='Component Identifier',\n    )\n    type: constr(regex=r'^\\S(.*\\S)?$') = Field(  # noqa A003 F722\n        ...,\n        description='A category describing the purpose of the component.',\n        title='Component Type',\n    )\n    title: str = Field(\n        ...,\n        description='A human readable name for the component.',\n        title='Component Title',\n    )\n    description: str = Field(\n        ...,\n        description='A description of the component, including information about its function.',\n        title='Component Description',\n    )\n    purpose: Optional[str] = Field(\n        None,\n        description='A summary of the technological or business purpose of the component.',\n        title='Purpose',\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    protocols: Optional[List[common.Protocol]] = Field(None)\n    # ssp does not have a list of ci's but it does have one ci\n    control_implementations: Optional[List[GenericControlImplementation]] = Field(None, alias='control-implementations')\n    remarks: Optional[str] = None\n    # ssp has\n    status: common.ImplementationStatus\n\n    def as_defined_component(self) -&gt; comp.DefinedComponent:\n        \"\"\"Convert to DefinedComponent.\"\"\"\n        status = self.status\n        class_dict = copy.deepcopy(self.__dict__)\n        class_dict.pop('status', None)\n        def_comp = comp.DefinedComponent(**class_dict)\n        ControlInterface.insert_status_in_props(def_comp, status)\n        return def_comp\n\n    @classmethod\n    def from_defined_component(cls, def_comp: comp.DefinedComponent) -&gt; GenericComponent:\n        \"\"\"Convert defined component to generic.\"\"\"\n        status = ControlInterface.get_status_from_props(def_comp)\n        class_dict = copy.deepcopy(def_comp.__dict__)\n        if 'control_implementations' in class_dict:\n            new_cis = []\n            for ci in class_dict['control_implementations']:\n                new_cis.append(GenericControlImplementation.from_component_ci(ci))\n            class_dict['control-implementations'] = new_cis\n            class_dict.pop('control_implementations', None)\n        class_dict['status'] = status\n        return cls(**class_dict)\n\n    def as_system_component(self, status_override: str = '') -&gt; ossp.SystemComponent:\n        \"\"\"Convert to SystemComponent.\"\"\"\n        class_dict = copy.deepcopy(self.__dict__)\n        class_dict.pop('control_implementations', None)\n        status_str = self.status.state if self.status else const.STATUS_OPERATIONAL\n        status_str = status_override if status_override else status_str\n        if status_str not in ['under-development', 'operational', 'disposition', 'other']:\n            logger.warning(\n                f'SystemComponent status {status_str} not recognized.  Setting to {const.STATUS_OPERATIONAL}'\n            )\n            status_str = const.STATUS_OPERATIONAL\n        class_dict['status'] = ossp.Status(state=status_str, remarks=self.status.remarks)\n        return ossp.SystemComponent(**class_dict)\n\n    @staticmethod\n    def generate() -&gt; GenericComponent:\n        \"\"\"Generate instance of GenericComponent.\"\"\"\n        uuid = str(uuid4())\n        status = common.ImplementationStatus(state=const.STATUS_OPERATIONAL)\n        return GenericComponent(uuid=uuid, type=const.REPLACE_ME, title='', description='', status=status)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.control_implementations","title":"<code>control_implementations: Optional[List[GenericControlImplementation]] = Field(None, alias='control-implementations')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.description","title":"<code>description: str = Field(..., description='A description of the component, including information about its function.', title='Component Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.protocols","title":"<code>protocols: Optional[List[common.Protocol]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.purpose","title":"<code>purpose: Optional[str] = Field(None, description='A summary of the technological or business purpose of the component.', title='Purpose')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.status","title":"<code>status: common.ImplementationStatus</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.title","title":"<code>title: str = Field(..., description='A human readable name for the component.', title='Component Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.type","title":"<code>type: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description='A category describing the purpose of the component.', title='Component Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this component elsewhere in this or other OSCAL instances. The locally defined UUID of the component can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Component Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.as_defined_component","title":"<code>as_defined_component()</code>","text":"<p>Convert to DefinedComponent.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>def as_defined_component(self) -&gt; comp.DefinedComponent:\n    \"\"\"Convert to DefinedComponent.\"\"\"\n    status = self.status\n    class_dict = copy.deepcopy(self.__dict__)\n    class_dict.pop('status', None)\n    def_comp = comp.DefinedComponent(**class_dict)\n    ControlInterface.insert_status_in_props(def_comp, status)\n    return def_comp\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.as_system_component","title":"<code>as_system_component(status_override='')</code>","text":"<p>Convert to SystemComponent.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>def as_system_component(self, status_override: str = '') -&gt; ossp.SystemComponent:\n    \"\"\"Convert to SystemComponent.\"\"\"\n    class_dict = copy.deepcopy(self.__dict__)\n    class_dict.pop('control_implementations', None)\n    status_str = self.status.state if self.status else const.STATUS_OPERATIONAL\n    status_str = status_override if status_override else status_str\n    if status_str not in ['under-development', 'operational', 'disposition', 'other']:\n        logger.warning(\n            f'SystemComponent status {status_str} not recognized.  Setting to {const.STATUS_OPERATIONAL}'\n        )\n        status_str = const.STATUS_OPERATIONAL\n    class_dict['status'] = ossp.Status(state=status_str, remarks=self.status.remarks)\n    return ossp.SystemComponent(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.from_defined_component","title":"<code>from_defined_component(def_comp)</code>  <code>classmethod</code>","text":"<p>Convert defined component to generic.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>@classmethod\ndef from_defined_component(cls, def_comp: comp.DefinedComponent) -&gt; GenericComponent:\n    \"\"\"Convert defined component to generic.\"\"\"\n    status = ControlInterface.get_status_from_props(def_comp)\n    class_dict = copy.deepcopy(def_comp.__dict__)\n    if 'control_implementations' in class_dict:\n        new_cis = []\n        for ci in class_dict['control_implementations']:\n            new_cis.append(GenericControlImplementation.from_component_ci(ci))\n        class_dict['control-implementations'] = new_cis\n        class_dict.pop('control_implementations', None)\n    class_dict['status'] = status\n    return cls(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericComponent.generate","title":"<code>generate()</code>  <code>staticmethod</code>","text":"<p>Generate instance of GenericComponent.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>@staticmethod\ndef generate() -&gt; GenericComponent:\n    \"\"\"Generate instance of GenericComponent.\"\"\"\n    uuid = str(uuid4())\n    status = common.ImplementationStatus(state=const.STATUS_OPERATIONAL)\n    return GenericComponent(uuid=uuid, type=const.REPLACE_ME, title='', description='', status=status)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation","title":"<code>GenericControlImplementation</code>","text":"<p>               Bases: <code>TrestleBaseModel</code></p> <p>Generic control implementation for SSP and CompDef.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>class GenericControlImplementation(TrestleBaseModel):\n    \"\"\"Generic control implementation for SSP and CompDef.\"\"\"\n\n    # not in ssp\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'  # noqa FS003 F722\n    ) = Field(\n        ...,\n        description=  # noqa E251\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference a set of implemented controls elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation set can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',  # noqa E501\n        title='Control Implementation Set Identifier',\n    )\n    # not in ssp\n    source: str = Field(\n        ...,\n        description=  # noqa E251\n        'A reference to an OSCAL catalog or profile providing the referenced control or subcontrol definition.',  # noqa E501\n        title='Source Resource Reference',\n    )\n    description: str = Field(\n        ...,\n        description=  # noqa E251\n        'A description of how the specified set of controls are implemented for the containing component or capability.',  # noqa E501\n        title='Control Implementation Description',\n    )\n    # not in ssp\n    props: Optional[List[common.Property]] = Field(None)\n    # not in ssp\n    links: Optional[List[common.Link]] = Field(None)\n    set_parameters: Optional[List[GenericSetParameter]] = Field(None, alias='set-parameters')\n    implemented_requirements: List[GenericImplementedRequirement] = Field(..., alias='implemented-requirements')\n\n    @staticmethod\n    def generate() -&gt; GenericControlImplementation:\n        \"\"\"Generate instance of this class.\"\"\"\n        uuid = str(uuid4())\n        imp_reqs = [GenericImplementedRequirement.generate()]\n        class_dict = {\n            'uuid': uuid,\n            'control-id': const.REPLACE_ME,\n            'source': const.REPLACE_ME,\n            'description': '',\n            'implemented-requirements': imp_reqs\n        }\n        return GenericControlImplementation(**class_dict)\n\n    @classmethod\n    def from_component_ci(cls, control_imp: comp.ControlImplementation) -&gt; GenericControlImplementation:\n        \"\"\"Convert component control imp to generic.\"\"\"\n        class_dict = copy.deepcopy(control_imp.__dict__)\n        if IMPLEMENTED_REQUIREMENTS in class_dict:\n            new_irs = []\n            ir_list = class_dict.get(IMPLEMENTED_REQUIREMENTS, None)\n            for ir in as_list(ir_list):\n                new_ir = GenericImplementedRequirement.from_comp_def(ir)\n                new_irs.append(new_ir)\n            class_dict['implemented-requirements'] = none_if_empty(new_irs)\n            class_dict.pop(IMPLEMENTED_REQUIREMENTS, None)\n            new_sps = []\n            sp_list = class_dict.get('set_parameters', None)\n            for sp in as_list(sp_list):\n                new_sps.append(GenericSetParameter.from_defined_component(sp))\n            class_dict['set-parameters'] = none_if_empty(new_sps)\n            class_dict.pop('set_parameters', None)\n\n        return cls(**class_dict)\n\n    def as_ssp(self) -&gt; ossp.ControlImplementation:\n        \"\"\"Represent in ssp form.\"\"\"\n        imp_reqs = []\n        for imp_req in self.implemented_requirements:\n            imp_reqs.append(imp_req.as_ssp())\n        class_dict = self.__dict__\n        for prop in ['uuid', 'source', 'props', 'links', IMPLEMENTED_REQUIREMENTS]:\n            class_dict.pop(prop, None)\n        if imp_reqs:\n            class_dict['implemented-requirements'] = imp_reqs\n            class_dict.pop(IMPLEMENTED_REQUIREMENTS, None)\n        return ossp.ControlImplementation(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.description","title":"<code>description: str = Field(..., description='A description of how the specified set of controls are implemented for the containing component or capability.', title='Control Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.implemented_requirements","title":"<code>implemented_requirements: List[GenericImplementedRequirement] = Field(..., alias='implemented-requirements')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.set_parameters","title":"<code>set_parameters: Optional[List[GenericSetParameter]] = Field(None, alias='set-parameters')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.source","title":"<code>source: str = Field(..., description='A reference to an OSCAL catalog or profile providing the referenced control or subcontrol definition.', title='Source Resource Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference a set of implemented controls elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation set can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Control Implementation Set Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.as_ssp","title":"<code>as_ssp()</code>","text":"<p>Represent in ssp form.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>def as_ssp(self) -&gt; ossp.ControlImplementation:\n    \"\"\"Represent in ssp form.\"\"\"\n    imp_reqs = []\n    for imp_req in self.implemented_requirements:\n        imp_reqs.append(imp_req.as_ssp())\n    class_dict = self.__dict__\n    for prop in ['uuid', 'source', 'props', 'links', IMPLEMENTED_REQUIREMENTS]:\n        class_dict.pop(prop, None)\n    if imp_reqs:\n        class_dict['implemented-requirements'] = imp_reqs\n        class_dict.pop(IMPLEMENTED_REQUIREMENTS, None)\n    return ossp.ControlImplementation(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.from_component_ci","title":"<code>from_component_ci(control_imp)</code>  <code>classmethod</code>","text":"<p>Convert component control imp to generic.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>@classmethod\ndef from_component_ci(cls, control_imp: comp.ControlImplementation) -&gt; GenericControlImplementation:\n    \"\"\"Convert component control imp to generic.\"\"\"\n    class_dict = copy.deepcopy(control_imp.__dict__)\n    if IMPLEMENTED_REQUIREMENTS in class_dict:\n        new_irs = []\n        ir_list = class_dict.get(IMPLEMENTED_REQUIREMENTS, None)\n        for ir in as_list(ir_list):\n            new_ir = GenericImplementedRequirement.from_comp_def(ir)\n            new_irs.append(new_ir)\n        class_dict['implemented-requirements'] = none_if_empty(new_irs)\n        class_dict.pop(IMPLEMENTED_REQUIREMENTS, None)\n        new_sps = []\n        sp_list = class_dict.get('set_parameters', None)\n        for sp in as_list(sp_list):\n            new_sps.append(GenericSetParameter.from_defined_component(sp))\n        class_dict['set-parameters'] = none_if_empty(new_sps)\n        class_dict.pop('set_parameters', None)\n\n    return cls(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericControlImplementation.generate","title":"<code>generate()</code>  <code>staticmethod</code>","text":"<p>Generate instance of this class.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>@staticmethod\ndef generate() -&gt; GenericControlImplementation:\n    \"\"\"Generate instance of this class.\"\"\"\n    uuid = str(uuid4())\n    imp_reqs = [GenericImplementedRequirement.generate()]\n    class_dict = {\n        'uuid': uuid,\n        'control-id': const.REPLACE_ME,\n        'source': const.REPLACE_ME,\n        'description': '',\n        'implemented-requirements': imp_reqs\n    }\n    return GenericControlImplementation(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement","title":"<code>GenericImplementedRequirement</code>","text":"<p>               Bases: <code>TrestleBaseModel</code></p> <p>Generic ImplementedRequirement for SSP and DefinedComponent.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>class GenericImplementedRequirement(TrestleBaseModel):\n    \"\"\"Generic ImplementedRequirement for SSP and DefinedComponent.\"\"\"\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'  # noqa FS003 F722\n    ) = Field(\n        ...,\n        description=  # noqa E251\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference a specific control implementation elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance).This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',  # noqa E501\n        title='Control Implementation Identifier',\n    )\n    control_id: constr(\n        regex=  # noqa E251\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'  # noqa E501\n    ) = Field(\n        ...,\n        alias='control-id',\n        description=  # noqa E251\n        'A human-oriented identifier reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).',  # noqa E501\n        title='Control Identifier Reference',\n    )\n    # only compdef has description\n    description: str = Field(\n        ...,\n        description=  # noqa E251\n        'A description of how the specified control is implemented for the containing component or capability.',  # noqa E501\n        title='Control Implementation Description',\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    set_parameters: Optional[List[GenericSetParameter]] = Field(None, alias='set-parameters')\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    statements: Optional[List[GenericStatement]] = Field(None)\n    remarks: Optional[str] = None\n    # ssp has following\n    by_components: Optional[List[GenericByComponent]] = Field(None, alias='by-components')\n\n    @staticmethod\n    def generate() -&gt; GenericImplementedRequirement:\n        \"\"\"Generate instance of this class.\"\"\"\n        uuid = str(uuid4())\n        class_dict = {'uuid': uuid, 'control-id': const.REPLACE_ME, 'description': ''}\n        return GenericImplementedRequirement(**class_dict)\n\n    @classmethod\n    def from_comp_def(cls, imp_req: comp.ImplementedRequirement) -&gt; GenericImplementedRequirement:\n        \"\"\"Convert component form of imp req to generic.\"\"\"\n        class_dict = copy.deepcopy(imp_req.__dict__)\n        class_dict['control-id'] = class_dict.pop('control_id', None)\n        return cls(**class_dict)\n\n    def as_ssp(self) -&gt; ossp.ImplementedRequirement:\n        \"\"\"Convert to ssp form.\"\"\"\n        class_dict = copy.deepcopy(self.__dict__)\n        del class_dict['description']\n        new_stat_list = []\n        for statement in as_list(self.statements):\n            new_stat_list.append(statement.as_ssp())\n        if new_stat_list:\n            class_dict['statements'] = new_stat_list\n        return ossp.ImplementedRequirement(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.by_components","title":"<code>by_components: Optional[List[GenericByComponent]] = Field(None, alias='by-components')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.control_id","title":"<code>control_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='control-id', description='A human-oriented identifier reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).', title='Control Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.description","title":"<code>description: str = Field(..., description='A description of how the specified control is implemented for the containing component or capability.', title='Control Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.set_parameters","title":"<code>set_parameters: Optional[List[GenericSetParameter]] = Field(None, alias='set-parameters')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.statements","title":"<code>statements: Optional[List[GenericStatement]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference a specific control implementation elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance).This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Control Implementation Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.as_ssp","title":"<code>as_ssp()</code>","text":"<p>Convert to ssp form.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>def as_ssp(self) -&gt; ossp.ImplementedRequirement:\n    \"\"\"Convert to ssp form.\"\"\"\n    class_dict = copy.deepcopy(self.__dict__)\n    del class_dict['description']\n    new_stat_list = []\n    for statement in as_list(self.statements):\n        new_stat_list.append(statement.as_ssp())\n    if new_stat_list:\n        class_dict['statements'] = new_stat_list\n    return ossp.ImplementedRequirement(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.from_comp_def","title":"<code>from_comp_def(imp_req)</code>  <code>classmethod</code>","text":"<p>Convert component form of imp req to generic.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>@classmethod\ndef from_comp_def(cls, imp_req: comp.ImplementedRequirement) -&gt; GenericImplementedRequirement:\n    \"\"\"Convert component form of imp req to generic.\"\"\"\n    class_dict = copy.deepcopy(imp_req.__dict__)\n    class_dict['control-id'] = class_dict.pop('control_id', None)\n    return cls(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericImplementedRequirement.generate","title":"<code>generate()</code>  <code>staticmethod</code>","text":"<p>Generate instance of this class.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>@staticmethod\ndef generate() -&gt; GenericImplementedRequirement:\n    \"\"\"Generate instance of this class.\"\"\"\n    uuid = str(uuid4())\n    class_dict = {'uuid': uuid, 'control-id': const.REPLACE_ME, 'description': ''}\n    return GenericImplementedRequirement(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericSetParameter","title":"<code>GenericSetParameter</code>","text":"<p>               Bases: <code>TrestleBaseModel</code></p> <p>Generic SetParameter for SSP and DefinedComponent.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>class GenericSetParameter(TrestleBaseModel):\n    \"\"\"Generic SetParameter for SSP and DefinedComponent.\"\"\"\n\n    param_id: constr(\n        regex=  # noqa E251\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'  # noqa E501\n    ) = Field(\n        ...,\n        alias='param-id',\n        description=  # noqa E251\n        \"A human-oriented reference to a parameter within a control, who's catalog has been imported into the current implementation context.\",  # noqa E501\n        title='Parameter ID',\n    )\n    values: List[str] = Field(...)\n    remarks: Optional[str] = None\n\n    @staticmethod\n    def from_defined_component(sp: comp.SetParameter):\n        \"\"\"Generate generic set parameter from comp_def version.\"\"\"\n        class_dict = {'param-id': sp.param_id, 'values': sp.values, 'remarks': sp.remarks}\n        return GenericSetParameter(**class_dict)\n\n    def to_ssp(self):\n        \"\"\"Convert to ssp format.\"\"\"\n        return (ossp.SetParameter(param_id=self.param_id, values=self.values, remarks=self.remarks))\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericSetParameter-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericSetParameter.param_id","title":"<code>param_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='param-id', description=\"A human-oriented reference to a parameter within a control, who's catalog has been imported into the current implementation context.\", title='Parameter ID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericSetParameter.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericSetParameter.values","title":"<code>values: List[str] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericSetParameter-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericSetParameter.from_defined_component","title":"<code>from_defined_component(sp)</code>  <code>staticmethod</code>","text":"<p>Generate generic set parameter from comp_def version.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>@staticmethod\ndef from_defined_component(sp: comp.SetParameter):\n    \"\"\"Generate generic set parameter from comp_def version.\"\"\"\n    class_dict = {'param-id': sp.param_id, 'values': sp.values, 'remarks': sp.remarks}\n    return GenericSetParameter(**class_dict)\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericSetParameter.to_ssp","title":"<code>to_ssp()</code>","text":"<p>Convert to ssp format.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>def to_ssp(self):\n    \"\"\"Convert to ssp format.\"\"\"\n    return (ossp.SetParameter(param_id=self.param_id, values=self.values, remarks=self.remarks))\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement","title":"<code>GenericStatement</code>","text":"<p>               Bases: <code>TrestleBaseModel</code></p> <p>Generic statement for SSP and DefinedComp.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>class GenericStatement(TrestleBaseModel):\n    \"\"\"Generic statement for SSP and DefinedComp.\"\"\"\n\n    statement_id: constr(\n        regex=  # noqa E251\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'  # noqa FS003 E501\n    ) = Field(\n        ...,\n        alias='statement_id',\n        description='A human-oriented identifier reference to a control statement.',\n        title='Control Statement Reference',\n    )\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'  # noqa FS003 F722\n    ) = Field(\n        ...,\n        description=  # noqa E251\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).',  # noqa E501\n        title='Control Statement Reference Universally Unique Identifier',\n    )\n    # this is not in ssp statement\n    description: str = Field(\n        ...,\n        description='A summary of how the containing control statement is implemented by the component or capability.',\n        title='Statement Implementation Description',\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n    # ssp has following\n    by_components: Optional[List[GenericByComponent]] = Field(None, alias='by-components')\n\n    def as_ssp(self) -&gt; ossp.Statement:\n        \"\"\"Represent in ssp form.\"\"\"\n        class_dict = copy.deepcopy(self.__dict__)\n        class_dict.pop('description', None)\n        by_comps = []\n        for by_comp in as_list(self.by_components):\n            new_by_comp = by_comp.as_ssp()\n            by_comps.append(new_by_comp)\n        return ossp.Statement(\n            statement_id=self.statement_id,\n            uuid=self.uuid,\n            props=self.props,\n            links=self.links,\n            responsible_roles=self.responsible_roles,\n            by_components=by_comps,\n            remarks=self.remarks\n        )\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement.by_components","title":"<code>by_components: Optional[List[GenericByComponent]] = Field(None, alias='by-components')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement.description","title":"<code>description: str = Field(..., description='A summary of how the containing control statement is implemented by the component or capability.', title='Statement Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement.statement_id","title":"<code>statement_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='statement_id', description='A human-oriented identifier reference to a control statement.', title='Control Statement Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-4[0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).', title='Control Statement Reference Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal.GenericStatement.as_ssp","title":"<code>as_ssp()</code>","text":"<p>Represent in ssp form.</p> Source code in <code>trestle/core/generic_oscal.py</code> <pre><code>def as_ssp(self) -&gt; ossp.Statement:\n    \"\"\"Represent in ssp form.\"\"\"\n    class_dict = copy.deepcopy(self.__dict__)\n    class_dict.pop('description', None)\n    by_comps = []\n    for by_comp in as_list(self.by_components):\n        new_by_comp = by_comp.as_ssp()\n        by_comps.append(new_by_comp)\n    return ossp.Statement(\n        statement_id=self.statement_id,\n        uuid=self.uuid,\n        props=self.props,\n        links=self.links,\n        responsible_roles=self.responsible_roles,\n        by_components=by_comps,\n        remarks=self.remarks\n    )\n</code></pre>"},{"location":"reference/API/trestle/core/generic_oscal/#trestle.core.generic_oscal-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/links_validator/","title":"trestle.core.links_validator","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/links_validator/#trestle.core.links_validator","title":"<code>trestle.core.links_validator</code>","text":"<p>Validate catalog by confirming control links match resources in backmatter.</p>"},{"location":"reference/API/trestle/core/links_validator/#trestle.core.links_validator-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/links_validator/#trestle.core.links_validator.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/links_validator/#trestle.core.links_validator-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/links_validator/#trestle.core.links_validator.LinksValidator","title":"<code>LinksValidator</code>","text":"<p>               Bases: <code>Validator</code></p> <p>Validator to confirm all uuids in links and prose match resources in backmatter.</p> Source code in <code>trestle/core/links_validator.py</code> <pre><code>class LinksValidator(Validator):\n    \"\"\"Validator to confirm all uuids in links and prose match resources in backmatter.\"\"\"\n\n    def model_is_valid(\n        self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n    ) -&gt; bool:\n        \"\"\"\n        Test if the model is valid.\n\n        args:\n            model: A top level OSCAL model.\n            quiet: Don't report msgs unless invalid.\n\n        returns:\n            Always returns True, but gives warning if links and resources are not one-to-one.\n        \"\"\"\n        refs = ModelUtils.find_uuid_refs(model)\n\n        # find uuids in backmatter\n        links: List[str] = []\n        if model.back_matter and model.back_matter.resources:\n            links = [res.uuid for res in model.back_matter.resources]\n            seen: Set[str] = set()\n            dupes: List[str] = []\n            for uuid in links:\n                if uuid in seen:\n                    dupes.append(uuid)\n                else:\n                    seen.add(uuid)\n            if dupes:\n                if not quiet:\n                    logger.warning(f'Backmatter has  {len(dupes)} duplicate link uuids.')\n                logger.debug(f'Backmatter has {len(dupes)} duplicate link uuids: {dupes}')\n\n        links = set(links)\n        in_refs = refs.difference(links)\n        if in_refs:\n            if not quiet:\n                logger.warning(f'Model references {len(refs)} uuids and {len(in_refs)} of them are not in resources.')\n            logger.debug(f'Model references {len(in_refs)} uuids not in resources: {in_refs}')\n\n        in_links = links.difference(refs)\n        if in_links:\n            if not quiet:\n                logger.warning(f'Resources have {len(links)} uuids and {len(in_links)} are not referenced by model.')\n            logger.debug(f'Resources have {len(in_links)} uuids not referenced by model: {in_links}')\n\n        # This validator is intended just to give warnings, so it always returns True\n        return True\n</code></pre>"},{"location":"reference/API/trestle/core/links_validator/#trestle.core.links_validator.LinksValidator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/links_validator/#trestle.core.links_validator.LinksValidator.model_is_valid","title":"<code>model_is_valid(model, quiet, trestle_root=None)</code>","text":"<p>Test if the model is valid.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>TopLevelOscalModel</code> <p>A top level OSCAL model.</p> required <code>quiet</code> <code>bool</code> <p>Don't report msgs unless invalid.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>Always returns True, but gives warning if links and resources are not one-to-one.</p> Source code in <code>trestle/core/links_validator.py</code> <pre><code>def model_is_valid(\n    self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n) -&gt; bool:\n    \"\"\"\n    Test if the model is valid.\n\n    args:\n        model: A top level OSCAL model.\n        quiet: Don't report msgs unless invalid.\n\n    returns:\n        Always returns True, but gives warning if links and resources are not one-to-one.\n    \"\"\"\n    refs = ModelUtils.find_uuid_refs(model)\n\n    # find uuids in backmatter\n    links: List[str] = []\n    if model.back_matter and model.back_matter.resources:\n        links = [res.uuid for res in model.back_matter.resources]\n        seen: Set[str] = set()\n        dupes: List[str] = []\n        for uuid in links:\n            if uuid in seen:\n                dupes.append(uuid)\n            else:\n                seen.add(uuid)\n        if dupes:\n            if not quiet:\n                logger.warning(f'Backmatter has  {len(dupes)} duplicate link uuids.')\n            logger.debug(f'Backmatter has {len(dupes)} duplicate link uuids: {dupes}')\n\n    links = set(links)\n    in_refs = refs.difference(links)\n    if in_refs:\n        if not quiet:\n            logger.warning(f'Model references {len(refs)} uuids and {len(in_refs)} of them are not in resources.')\n        logger.debug(f'Model references {len(in_refs)} uuids not in resources: {in_refs}')\n\n    in_links = links.difference(refs)\n    if in_links:\n        if not quiet:\n            logger.warning(f'Resources have {len(links)} uuids and {len(in_links)} are not referenced by model.')\n        logger.debug(f'Resources have {len(in_links)} uuids not referenced by model: {in_links}')\n\n    # This validator is intended just to give warnings, so it always returns True\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/object_factory/","title":"trestle.core.object_factory","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/object_factory/#trestle.core.object_factory","title":"<code>trestle.core.object_factory</code>","text":"<p>Generic object factory.</p>"},{"location":"reference/API/trestle/core/object_factory/#trestle.core.object_factory-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/object_factory/#trestle.core.object_factory.ObjectFactory","title":"<code>ObjectFactory</code>","text":"<p>Allow registration and creation of factory objects.</p> Source code in <code>trestle/core/object_factory.py</code> <pre><code>class ObjectFactory:\n    \"\"\"Allow registration and creation of factory objects.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize the objects dictionary as empty.\"\"\"\n        self._objects: Dict[str, Any] = {}\n\n    def register_object(self, mode: str, obj: Any) -&gt; None:\n        \"\"\"Register an object to the object factory.\n\n        Args:\n            mode: Descriptive key for the mode / type of object to be retrieved.\n            obj: The object type to be registered.\n        \"\"\"\n        self._objects[mode] = obj\n\n    def get(self, args: argparse.Namespace) -&gt; Any:\n        \"\"\"Create the object from the args.\"\"\"\n        return self._objects.get(args.mode)\n\n    def get_all(self) -&gt; ValuesView[Any]:\n        \"\"\"Get all registered objects.\"\"\"\n        return self._objects.values()\n</code></pre>"},{"location":"reference/API/trestle/core/object_factory/#trestle.core.object_factory.ObjectFactory-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/object_factory/#trestle.core.object_factory.ObjectFactory.__init__","title":"<code>__init__()</code>","text":"<p>Initialize the objects dictionary as empty.</p> Source code in <code>trestle/core/object_factory.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize the objects dictionary as empty.\"\"\"\n    self._objects: Dict[str, Any] = {}\n</code></pre>"},{"location":"reference/API/trestle/core/object_factory/#trestle.core.object_factory.ObjectFactory.get","title":"<code>get(args)</code>","text":"<p>Create the object from the args.</p> Source code in <code>trestle/core/object_factory.py</code> <pre><code>def get(self, args: argparse.Namespace) -&gt; Any:\n    \"\"\"Create the object from the args.\"\"\"\n    return self._objects.get(args.mode)\n</code></pre>"},{"location":"reference/API/trestle/core/object_factory/#trestle.core.object_factory.ObjectFactory.get_all","title":"<code>get_all()</code>","text":"<p>Get all registered objects.</p> Source code in <code>trestle/core/object_factory.py</code> <pre><code>def get_all(self) -&gt; ValuesView[Any]:\n    \"\"\"Get all registered objects.\"\"\"\n    return self._objects.values()\n</code></pre>"},{"location":"reference/API/trestle/core/object_factory/#trestle.core.object_factory.ObjectFactory.register_object","title":"<code>register_object(mode, obj)</code>","text":"<p>Register an object to the object factory.</p> <p>Parameters:</p> Name Type Description Default <code>mode</code> <code>str</code> <p>Descriptive key for the mode / type of object to be retrieved.</p> required <code>obj</code> <code>Any</code> <p>The object type to be registered.</p> required Source code in <code>trestle/core/object_factory.py</code> <pre><code>def register_object(self, mode: str, obj: Any) -&gt; None:\n    \"\"\"Register an object to the object factory.\n\n    Args:\n        mode: Descriptive key for the mode / type of object to be retrieved.\n        obj: The object type to be registered.\n    \"\"\"\n    self._objects[mode] = obj\n</code></pre>"},{"location":"reference/API/trestle/core/parser/","title":"trestle.core.parser","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/parser/#trestle.core.parser","title":"<code>trestle.core.parser</code>","text":"<p>Model parsing for use when models themselves must be inferred and are not known.</p> <p>Under most use cases trestle.core.base_model.OscalBaseModel provides functionality for loading Oscal models from files. However, under some circumstances the model internals are unknown.  Use of this module should be avoided unless the BaseModel functionality is inadequate.</p>"},{"location":"reference/API/trestle/core/parser/#trestle.core.parser-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/parser/#trestle.core.parser.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/parser/#trestle.core.parser-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/parser/#trestle.core.parser-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/parser/#trestle.core.parser.parse_dict","title":"<code>parse_dict(data, model_name)</code>","text":"<p>Load a model from the data dict.</p> <p>This functionality is provided for situations when the OSCAL data type is not known ahead of time. Here the model has been loaded into memory using json loads or similar and passed as a dict.</p> <p>Parameters:</p> Name Type Description Default <code>data</code> <code>Dict[str, Any]</code> <p>Oscal data loaded into memory as a dictionary with the <code>root key</code> removed.</p> required <code>model_name</code> <code>str</code> <p>should be of the form 'module.class' from trestle.oscal.* modules</p> required <p>Returns:</p> Type Description <code>OscalBaseModel</code> <p>The oscal model of the desired model.</p> Source code in <code>trestle/core/parser.py</code> <pre><code>def parse_dict(data: Dict[str, Any], model_name: str) -&gt; OscalBaseModel:\n    \"\"\"Load a model from the data dict.\n\n    This functionality is provided for situations when the OSCAL data type is not known ahead of time. Here the model\n    has been loaded into memory using json loads or similar and passed as a dict.\n\n    Args:\n        data: Oscal data loaded into memory as a dictionary with the `root key` removed.\n        model_name: should be of the form 'module.class' from trestle.oscal.* modules\n\n    Returns:\n        The oscal model of the desired model.\n    \"\"\"\n    if data is None:\n        raise TrestleError('data name is required')\n\n    if model_name is None:\n        raise TrestleError('model_name is required')\n\n    parts = model_name.split('.')\n    class_name = parts.pop()\n    module_name = '.'.join(parts)\n\n    logger.debug(f'Loading class \"{class_name}\" from \"{module_name}\"')\n    module = importlib.import_module(module_name)\n    mclass: OscalBaseModel = getattr(module, class_name)\n    if mclass is None:\n        raise TrestleError(f'class \"{class_name}\" could not be found in \"{module_name}\"')\n\n    instance = mclass.parse_obj(data)\n    return instance\n</code></pre>"},{"location":"reference/API/trestle/core/parser/#trestle.core.parser.root_key","title":"<code>root_key(data)</code>","text":"<p>Find root model name in the data.</p> Source code in <code>trestle/core/parser.py</code> <pre><code>def root_key(data: Dict[str, Any]) -&gt; str:\n    \"\"\"Find root model name in the data.\"\"\"\n    if len(data.items()) == 1:\n        return next(iter(data))\n\n    raise TrestleError('data does not contain a root key')\n</code></pre>"},{"location":"reference/API/trestle/core/parser/#trestle.core.parser.to_full_model_name","title":"<code>to_full_model_name(root_key)</code>","text":"<p>Find model name from the root_key in the file.</p> <p>Parameters:</p> Name Type Description Default <code>root_key</code> <code>str</code> <p>root key such as 'system-security-plan' from a top level OSCAL model.</p> required Source code in <code>trestle/core/parser.py</code> <pre><code>def to_full_model_name(root_key: str) -&gt; str:\n    \"\"\"\n    Find model name from the root_key in the file.\n\n    Args:\n        root_key: root key such as 'system-security-plan' from a top level OSCAL model.\n    \"\"\"\n    if root_key not in const.MODEL_TYPE_LIST:\n        raise TrestleError(f'{root_key} is not a top level model name.')\n\n    module = const.MODEL_TYPE_TO_MODEL_MODULE[root_key]\n    class_name = alias_to_classname(root_key, AliasMode.JSON)\n    return f'{module}.{class_name}'\n</code></pre>"},{"location":"reference/API/trestle/core/pipeline/","title":"trestle.core.pipeline","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/pipeline/#trestle.core.pipeline","title":"<code>trestle.core.pipeline</code>","text":"<p>Abstract base class for pipelines and filters.</p>"},{"location":"reference/API/trestle/core/pipeline/#trestle.core.pipeline-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/pipeline/#trestle.core.pipeline.Pipeline","title":"<code>Pipeline</code>","text":"<p>Pipeline base class.</p> Source code in <code>trestle/core/pipeline.py</code> <pre><code>class Pipeline():\n    \"\"\"Pipeline base class.\"\"\"\n\n    class Filter(ABC):\n        \"\"\"Filter class used by pipeline.\"\"\"\n\n        @abstractclassmethod\n        def process(self, input_: Any) -&gt; Any:\n            \"\"\"Process the input to output.\"\"\"\n            return input_\n\n    def __init__(self, filters: List[Filter]) -&gt; None:\n        \"\"\"Initialize the class.\"\"\"\n        self._filters = filters\n\n    def process(self, input_: Any) -&gt; Any:\n        \"\"\"Process the filter pipeline.\"\"\"\n        for filter_ in self._filters:\n            input_ = filter_.process(input_)\n        return input_\n</code></pre>"},{"location":"reference/API/trestle/core/pipeline/#trestle.core.pipeline.Pipeline-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/pipeline/#trestle.core.pipeline.Pipeline.Filter","title":"<code>Filter</code>","text":"<p>               Bases: <code>ABC</code></p> <p>Filter class used by pipeline.</p> Source code in <code>trestle/core/pipeline.py</code> <pre><code>class Filter(ABC):\n    \"\"\"Filter class used by pipeline.\"\"\"\n\n    @abstractclassmethod\n    def process(self, input_: Any) -&gt; Any:\n        \"\"\"Process the input to output.\"\"\"\n        return input_\n</code></pre> Functions\u00a4 <code>process(input_)</code> \u00a4 <p>Process the input to output.</p> Source code in <code>trestle/core/pipeline.py</code> <pre><code>@abstractclassmethod\ndef process(self, input_: Any) -&gt; Any:\n    \"\"\"Process the input to output.\"\"\"\n    return input_\n</code></pre>"},{"location":"reference/API/trestle/core/pipeline/#trestle.core.pipeline.Pipeline-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/pipeline/#trestle.core.pipeline.Pipeline.__init__","title":"<code>__init__(filters)</code>","text":"<p>Initialize the class.</p> Source code in <code>trestle/core/pipeline.py</code> <pre><code>def __init__(self, filters: List[Filter]) -&gt; None:\n    \"\"\"Initialize the class.\"\"\"\n    self._filters = filters\n</code></pre>"},{"location":"reference/API/trestle/core/pipeline/#trestle.core.pipeline.Pipeline.process","title":"<code>process(input_)</code>","text":"<p>Process the filter pipeline.</p> Source code in <code>trestle/core/pipeline.py</code> <pre><code>def process(self, input_: Any) -&gt; Any:\n    \"\"\"Process the filter pipeline.\"\"\"\n    for filter_ in self._filters:\n        input_ = filter_.process(input_)\n    return input_\n</code></pre>"},{"location":"reference/API/trestle/core/plugins/","title":"trestle.core.plugins","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/plugins/#trestle.core.plugins","title":"<code>trestle.core.plugins</code>","text":"<p>Plugin discovery code.</p>"},{"location":"reference/API/trestle/core/plugins/#trestle.core.plugins-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/plugins/#trestle.core.plugins.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/plugins/#trestle.core.plugins-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/plugins/#trestle.core.plugins.discovered_plugins","title":"<code>discovered_plugins(search_module)</code>","text":"<p>Yield discovered plugin classes within a given module name.</p> Source code in <code>trestle/core/plugins.py</code> <pre><code>def discovered_plugins(search_module: str) -&gt; Iterator[Tuple[str, Any]]:\n    \"\"\"Yield discovered plugin classes within a given module name.\"\"\"\n    logger.debug(_discovered_plugins)\n    # This block is uncovered as trestle cannot find plugins in it's unit tests - it is the base module.\n    for plugin, value in _discovered_plugins.items():  # pragma: nocover\n        for _, module, _ in pkgutil.iter_modules([pathlib.Path(value.__path__[0], search_module)]):\n            logger.debug(module)\n            plugin_module = importlib.import_module(f'{plugin}.{search_module}.{module}')\n            clsmembers = inspect.getmembers(plugin_module, inspect.isclass)\n            logger.debug(clsmembers)\n            for _, plugin_cls in clsmembers:\n                yield (plugin, plugin_cls)\n</code></pre>"},{"location":"reference/API/trestle/core/profile_resolver/","title":"trestle.core.profile_resolver","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/profile_resolver/#trestle.core.profile_resolver","title":"<code>trestle.core.profile_resolver</code>","text":"<p>Create resolved catalog from profile.</p>"},{"location":"reference/API/trestle/core/profile_resolver/#trestle.core.profile_resolver-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/profile_resolver/#trestle.core.profile_resolver.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/profile_resolver/#trestle.core.profile_resolver-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/profile_resolver/#trestle.core.profile_resolver.ProfileResolver","title":"<code>ProfileResolver</code>","text":"<p>Class to resolve a catalog given a profile.</p> Source code in <code>trestle/core/profile_resolver.py</code> <pre><code>class ProfileResolver():\n    \"\"\"Class to resolve a catalog given a profile.\"\"\"\n\n    @staticmethod\n    def _extract_inherited_props(res_cat: cat.Catalog) -&gt; Tuple[cat.Catalog, Dict[str, Any]]:\n        \"\"\"\n        Build the control dict of inherited props.\n\n        Args:\n            The resolved profile catalog with a possible temporary part in each control\n\n        Returns:\n            The temporary parts are removed from each control and a Dict of added props per control_id is returned\n\n        Notes:\n        If an upstream profile adds props to the control they are tracked in a special temporary part in the control\n        called const.TRESTLE_INHERITED_PROPS_TRACKER.  If that part is present in a control its contents should be added\n        to the dict entry for that control, and the part removed from the control.\n        \"\"\"\n        prop_dict: Dict[str, Any] = {}\n        cat_interface = CatalogInterface(res_cat)\n        for control in cat_interface.get_all_controls_from_dict():\n            part: com.Part = pop_item_from_list(control.parts, TRESTLE_INHERITED_PROPS_TRACKER, lambda p: p.name)\n            if part:\n                props_list: List[Dict[str, Any]] = []\n                for prop in as_list(part.props):\n                    props_list.append({'name': prop.name, 'value': prop.value})\n                for sub_part in as_list(part.parts):\n                    for prop in as_list(sub_part.props):\n                        props_list.append({'name': prop.name, 'value': prop.value, 'part_name': sub_part.title})\n                prop_dict[control.id] = props_list\n        cat_interface.update_catalog_controls()\n        clean_res_cat = cat_interface.get_catalog()\n        return clean_res_cat, prop_dict\n\n    @staticmethod\n    def get_resolved_profile_catalog_and_inherited_props(\n        trestle_root: pathlib.Path,\n        profile_path: str,\n        block_adds: bool = False,\n        block_params: bool = False,\n        params_format: Optional[str] = None,\n        param_rep: ParameterRep = ParameterRep.LEAVE_MOUSTACHE,\n        show_value_warnings: bool = False,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; Tuple[cat.Catalog, Optional[Dict[str, Any]]]:\n        \"\"\"\n        Create the resolved profile catalog given a profile path along with inherited props.\n\n        Args:\n            trestle_root: root directory of the trestle workspace\n            profile_path: string path or uri of the profile being resolved\n            block_adds: prevent the application of adds in the final profile\n            block_params: prevent the application of setparams in the final profile\n            params_format: optional pattern with dot to wrap the param string, where dot represents the param string\n            param_rep: desired way to convert params to strings\n            show_value_warnings: warn if prose references a value that has not been set\n            value_assigned_prefix: Prefix placed in front of param string if a value was assigned\n            value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned\n\n        Returns:\n            The resolved profile catalog and a control dict of inherited props\n        \"\"\"\n        logger.debug(f'get resolved profile catalog and inherited props for {profile_path} via generated Import.')\n        import_ = prof.Import(href=str(profile_path), include_all={})\n        # The final Import has change_prose=True to force parameter substitution in the prose only at the last stage.\n        import_filter = Import(\n            trestle_root,\n            import_, [],\n            True,\n            block_adds,\n            block_params,\n            params_format,\n            param_rep,\n            None,\n            show_value_warnings,\n            value_assigned_prefix,\n            value_not_assigned_prefix\n        )\n        logger.debug('launch pipeline')\n        resolved_profile_catalog = next(import_filter.process())\n        resolved_profile_catalog, inherited_props = ProfileResolver._extract_inherited_props(resolved_profile_catalog)\n        return resolved_profile_catalog, inherited_props\n\n    @staticmethod\n    def get_resolved_profile_catalog(\n        trestle_root: pathlib.Path,\n        profile_path: str,\n        block_adds: bool = False,\n        block_params: bool = False,\n        params_format: Optional[str] = None,\n        param_rep: ParameterRep = ParameterRep.LEAVE_MOUSTACHE,\n        show_value_warnings: bool = False,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; cat.Catalog:\n        \"\"\"\n        Create the resolved profile catalog given a profile path.\n\n        Args:\n            trestle_root: root directory of the trestle workspace\n            profile_path: string path or uri of the profile being resolved\n            block_adds: prevent the application of adds in the final profile\n            block_params: prevent the application of setparams in the final profile\n            params_format: optional pattern with dot to wrap the param string, where dot represents the param string\n            param_rep: desired way to convert params to strings\n            show_value_warnings: warn if prose references a value that has not been set\n            value_assigned_prefix: Prefix placed in front of param string if a value was assigned\n            value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned\n\n        Returns:\n            The resolved profile catalog\n        \"\"\"\n        logger.debug(f'get resolved profile catalog for {profile_path} via generated Import.')\n        resolved_profile_catalog, _ = ProfileResolver.get_resolved_profile_catalog_and_inherited_props(\n            trestle_root,\n            profile_path,\n            block_adds,\n            block_params,\n            params_format,\n            param_rep,\n            show_value_warnings,\n            value_assigned_prefix,\n            value_not_assigned_prefix\n        )\n        return resolved_profile_catalog\n</code></pre>"},{"location":"reference/API/trestle/core/profile_resolver/#trestle.core.profile_resolver.ProfileResolver-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/profile_resolver/#trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog","title":"<code>get_resolved_profile_catalog(trestle_root, profile_path, block_adds=False, block_params=False, params_format=None, param_rep=ParameterRep.LEAVE_MOUSTACHE, show_value_warnings=False, value_assigned_prefix=None, value_not_assigned_prefix=None)</code>  <code>staticmethod</code>","text":"<p>Create the resolved profile catalog given a profile path.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>root directory of the trestle workspace</p> required <code>profile_path</code> <code>str</code> <p>string path or uri of the profile being resolved</p> required <code>block_adds</code> <code>bool</code> <p>prevent the application of adds in the final profile</p> <code>False</code> <code>block_params</code> <code>bool</code> <p>prevent the application of setparams in the final profile</p> <code>False</code> <code>params_format</code> <code>Optional[str]</code> <p>optional pattern with dot to wrap the param string, where dot represents the param string</p> <code>None</code> <code>param_rep</code> <code>ParameterRep</code> <p>desired way to convert params to strings</p> <code>LEAVE_MOUSTACHE</code> <code>show_value_warnings</code> <code>bool</code> <p>warn if prose references a value that has not been set</p> <code>False</code> <code>value_assigned_prefix</code> <code>Optional[str]</code> <p>Prefix placed in front of param string if a value was assigned</p> <code>None</code> <code>value_not_assigned_prefix</code> <code>Optional[str]</code> <p>Prefix placed in front of param string if a value was not assigned</p> <code>None</code> <p>Returns:</p> Type Description <code>Catalog</code> <p>The resolved profile catalog</p> Source code in <code>trestle/core/profile_resolver.py</code> <pre><code>@staticmethod\ndef get_resolved_profile_catalog(\n    trestle_root: pathlib.Path,\n    profile_path: str,\n    block_adds: bool = False,\n    block_params: bool = False,\n    params_format: Optional[str] = None,\n    param_rep: ParameterRep = ParameterRep.LEAVE_MOUSTACHE,\n    show_value_warnings: bool = False,\n    value_assigned_prefix: Optional[str] = None,\n    value_not_assigned_prefix: Optional[str] = None\n) -&gt; cat.Catalog:\n    \"\"\"\n    Create the resolved profile catalog given a profile path.\n\n    Args:\n        trestle_root: root directory of the trestle workspace\n        profile_path: string path or uri of the profile being resolved\n        block_adds: prevent the application of adds in the final profile\n        block_params: prevent the application of setparams in the final profile\n        params_format: optional pattern with dot to wrap the param string, where dot represents the param string\n        param_rep: desired way to convert params to strings\n        show_value_warnings: warn if prose references a value that has not been set\n        value_assigned_prefix: Prefix placed in front of param string if a value was assigned\n        value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned\n\n    Returns:\n        The resolved profile catalog\n    \"\"\"\n    logger.debug(f'get resolved profile catalog for {profile_path} via generated Import.')\n    resolved_profile_catalog, _ = ProfileResolver.get_resolved_profile_catalog_and_inherited_props(\n        trestle_root,\n        profile_path,\n        block_adds,\n        block_params,\n        params_format,\n        param_rep,\n        show_value_warnings,\n        value_assigned_prefix,\n        value_not_assigned_prefix\n    )\n    return resolved_profile_catalog\n</code></pre>"},{"location":"reference/API/trestle/core/profile_resolver/#trestle.core.profile_resolver.ProfileResolver.get_resolved_profile_catalog_and_inherited_props","title":"<code>get_resolved_profile_catalog_and_inherited_props(trestle_root, profile_path, block_adds=False, block_params=False, params_format=None, param_rep=ParameterRep.LEAVE_MOUSTACHE, show_value_warnings=False, value_assigned_prefix=None, value_not_assigned_prefix=None)</code>  <code>staticmethod</code>","text":"<p>Create the resolved profile catalog given a profile path along with inherited props.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>root directory of the trestle workspace</p> required <code>profile_path</code> <code>str</code> <p>string path or uri of the profile being resolved</p> required <code>block_adds</code> <code>bool</code> <p>prevent the application of adds in the final profile</p> <code>False</code> <code>block_params</code> <code>bool</code> <p>prevent the application of setparams in the final profile</p> <code>False</code> <code>params_format</code> <code>Optional[str]</code> <p>optional pattern with dot to wrap the param string, where dot represents the param string</p> <code>None</code> <code>param_rep</code> <code>ParameterRep</code> <p>desired way to convert params to strings</p> <code>LEAVE_MOUSTACHE</code> <code>show_value_warnings</code> <code>bool</code> <p>warn if prose references a value that has not been set</p> <code>False</code> <code>value_assigned_prefix</code> <code>Optional[str]</code> <p>Prefix placed in front of param string if a value was assigned</p> <code>None</code> <code>value_not_assigned_prefix</code> <code>Optional[str]</code> <p>Prefix placed in front of param string if a value was not assigned</p> <code>None</code> <p>Returns:</p> Type Description <code>Tuple[Catalog, Optional[Dict[str, Any]]]</code> <p>The resolved profile catalog and a control dict of inherited props</p> Source code in <code>trestle/core/profile_resolver.py</code> <pre><code>@staticmethod\ndef get_resolved_profile_catalog_and_inherited_props(\n    trestle_root: pathlib.Path,\n    profile_path: str,\n    block_adds: bool = False,\n    block_params: bool = False,\n    params_format: Optional[str] = None,\n    param_rep: ParameterRep = ParameterRep.LEAVE_MOUSTACHE,\n    show_value_warnings: bool = False,\n    value_assigned_prefix: Optional[str] = None,\n    value_not_assigned_prefix: Optional[str] = None\n) -&gt; Tuple[cat.Catalog, Optional[Dict[str, Any]]]:\n    \"\"\"\n    Create the resolved profile catalog given a profile path along with inherited props.\n\n    Args:\n        trestle_root: root directory of the trestle workspace\n        profile_path: string path or uri of the profile being resolved\n        block_adds: prevent the application of adds in the final profile\n        block_params: prevent the application of setparams in the final profile\n        params_format: optional pattern with dot to wrap the param string, where dot represents the param string\n        param_rep: desired way to convert params to strings\n        show_value_warnings: warn if prose references a value that has not been set\n        value_assigned_prefix: Prefix placed in front of param string if a value was assigned\n        value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned\n\n    Returns:\n        The resolved profile catalog and a control dict of inherited props\n    \"\"\"\n    logger.debug(f'get resolved profile catalog and inherited props for {profile_path} via generated Import.')\n    import_ = prof.Import(href=str(profile_path), include_all={})\n    # The final Import has change_prose=True to force parameter substitution in the prose only at the last stage.\n    import_filter = Import(\n        trestle_root,\n        import_, [],\n        True,\n        block_adds,\n        block_params,\n        params_format,\n        param_rep,\n        None,\n        show_value_warnings,\n        value_assigned_prefix,\n        value_not_assigned_prefix\n    )\n    logger.debug('launch pipeline')\n    resolved_profile_catalog = next(import_filter.process())\n    resolved_profile_catalog, inherited_props = ProfileResolver._extract_inherited_props(resolved_profile_catalog)\n    return resolved_profile_catalog, inherited_props\n</code></pre>"},{"location":"reference/API/trestle/core/profile_resolver/#trestle.core.profile_resolver-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/refs_validator/","title":"trestle.core.refs_validator","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/refs_validator/#trestle.core.refs_validator","title":"<code>trestle.core.refs_validator</code>","text":"<p>Validate by confirming all refs have corresponding id.</p>"},{"location":"reference/API/trestle/core/refs_validator/#trestle.core.refs_validator-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/refs_validator/#trestle.core.refs_validator-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/refs_validator/#trestle.core.refs_validator.RefsValidator","title":"<code>RefsValidator</code>","text":"<p>               Bases: <code>Validator</code></p> <p>Validator to confirm all references in responsible parties are found in roles.</p> Source code in <code>trestle/core/refs_validator.py</code> <pre><code>class RefsValidator(Validator):\n    \"\"\"Validator to confirm all references in responsible parties are found in roles.\"\"\"\n\n    def model_is_valid(\n        self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n    ) -&gt; bool:\n        \"\"\"\n        Test if the model is valid.\n\n        args:\n            model: A top level OSCAL model.\n            quiet: Don't report msgs unless invalid.\n\n        returns:\n            True (valid) if the model's responsible parties match those found in roles.\n        \"\"\"\n        roles = as_list(model.metadata.roles)\n        role_ids = [role.id for role in roles]\n        responsible_parties = as_list(model.metadata.responsible_parties)\n        if not responsible_parties:\n            return True\n        party_roles = [party.role_id for party in responsible_parties]\n        # return true if all party roles are in the roles list\n        return all(item in role_ids for item in party_roles)\n</code></pre>"},{"location":"reference/API/trestle/core/refs_validator/#trestle.core.refs_validator.RefsValidator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/refs_validator/#trestle.core.refs_validator.RefsValidator.model_is_valid","title":"<code>model_is_valid(model, quiet, trestle_root=None)</code>","text":"<p>Test if the model is valid.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>TopLevelOscalModel</code> <p>A top level OSCAL model.</p> required <code>quiet</code> <code>bool</code> <p>Don't report msgs unless invalid.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>True (valid) if the model's responsible parties match those found in roles.</p> Source code in <code>trestle/core/refs_validator.py</code> <pre><code>def model_is_valid(\n    self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n) -&gt; bool:\n    \"\"\"\n    Test if the model is valid.\n\n    args:\n        model: A top level OSCAL model.\n        quiet: Don't report msgs unless invalid.\n\n    returns:\n        True (valid) if the model's responsible parties match those found in roles.\n    \"\"\"\n    roles = as_list(model.metadata.roles)\n    role_ids = [role.id for role in roles]\n    responsible_parties = as_list(model.metadata.responsible_parties)\n    if not responsible_parties:\n        return True\n    party_roles = [party.role_id for party in responsible_parties]\n    # return true if all party roles are in the roles list\n    return all(item in role_ids for item in party_roles)\n</code></pre>"},{"location":"reference/API/trestle/core/refs_validator/#trestle.core.refs_validator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/repository/","title":"trestle.core.repository","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository","title":"<code>trestle.core.repository</code>","text":"<p>Trestle Repository APIs.</p>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring","title":"<code>AgileAuthoring</code>","text":"<p>               Bases: <code>Repository</code></p> <p>AgileAuthoring extends the Repository class for performing authoring specific operations on Trestle repository.</p> <p>This class provides a set of APIs to perform generate and assemble authoring operations in the trestle repository rather than using the command line.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>class AgileAuthoring(Repository):\n    \"\"\"\n    AgileAuthoring extends the Repository class for performing authoring specific operations on Trestle repository.\n\n    This class provides a set of APIs to perform generate and assemble authoring operations in the trestle repository\n    rather than using the command line.\n\n    \"\"\"\n\n    def __init__(self, root_dir: pathlib.Path) -&gt; None:\n        \"\"\"Initialize trestle repository object.\"\"\"\n        super().__init__(root_dir)\n\n    def assemble_catalog_markdown(\n        self,\n        name: str,\n        output: str,\n        markdown_dir: str,\n        set_parameters: bool = False,\n        regenerate: bool = False,\n        version: Optional[str] = None\n    ) -&gt; bool:\n        \"\"\"Assemble catalog markdown into OSCAL Catalog in JSON.\"\"\"\n        logger.debug(f'Assembling model {name} of type catalog.')\n        success = False\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(\n            name=name,\n            output=output,\n            markdown=markdown_dir,\n            trestle_root=self.root_dir,\n            set_parameters=set_parameters,\n            regenerate=regenerate,\n            version=version,\n            verbose=verbose\n        )\n\n        try:\n            ret = catalogauthorcmd.CatalogAssemble()._run(args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error assembling catalog {name}: {e}')\n\n        logger.debug(f'Model {name} assembled successfully.')\n        return success\n\n    def assemble_profile_markdown(\n        self,\n        name: str,\n        output: str,\n        markdown_dir: str,\n        set_parameters: bool = False,\n        regenerate: bool = False,\n        version: Optional[str] = None,\n        sections: Optional[str] = None,\n        required_sections: Optional[str] = None,\n        allowed_sections: Optional[str] = None\n    ) -&gt; bool:\n        \"\"\"Assemble profile markdown into OSCAL Profile in JSON.\"\"\"\n        logger.debug(f'Assembling model {name} of type profile.')\n        success = False\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(\n            name=name,\n            output=output,\n            markdown=markdown_dir,\n            trestle_root=self.root_dir,\n            set_parameters=set_parameters,\n            regenerate=regenerate,\n            version=version,\n            sections=sections,\n            required_sections=required_sections,\n            allowed_sections=allowed_sections,\n            verbose=verbose\n        )\n\n        try:\n            ret = profileauthorcmd.ProfileAssemble()._run(args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error assembling profile {name}: {e}')\n\n        logger.debug(f'Model {name} assembled successfully.')\n        return success\n\n    def assemble_component_definition_markdown(\n        self, name: str, output: str, markdown_dir: str, regenerate: bool = False, version: str = ''\n    ) -&gt; bool:\n        \"\"\"Assemble component definition markdown into OSCAL Component Definition in JSON.\"\"\"\n        logger.debug(f'Assembling model {name} of type component definition.')\n        success = False\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(\n            name=name,\n            output=output,\n            markdown=markdown_dir,\n            trestle_root=self.root_dir,\n            regenerate=regenerate,\n            version=version,\n            verbose=verbose\n        )\n\n        try:\n            ret = componentauthorcmd.ComponentAssemble()._run(args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error assembling component definition {name}: {e}')\n\n        logger.debug(f'Model {name} assembled successfully.')\n        return success\n\n    def assemble_ssp_markdown(\n        self,\n        name: str,\n        output: str,\n        markdown_dir: str,\n        compdefs: str,\n        regenerate: bool = False,\n        version: Optional[str] = None\n    ) -&gt; bool:\n        \"\"\"Assemble ssp markdown into OSCAL SSP in JSON.\"\"\"\n        logger.debug(f'Assembling model {name} of type ssp.')\n        success = False\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(\n            name=name,\n            output=output,\n            markdown=markdown_dir,\n            compdefs=compdefs,\n            trestle_root=self.root_dir,\n            regenerate=regenerate,\n            version=version,\n            verbose=verbose\n        )\n\n        try:\n            ret = sspauthorcmd.SSPAssemble()._run(args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error assembling ssp {name}: {e}')\n\n        logger.debug(f'Model {name} assembled successfully.')\n        return success\n\n    def generate_catalog_markdown(\n        self,\n        name: str,\n        output: str,\n        force_overwrite: bool = False,\n        yaml_header: Optional[str] = None,\n        overwrite_header_values: bool = False\n    ) -&gt; bool:\n        \"\"\"Generate catalog markdown from OSCAL Catalog in JSON.\"\"\"\n        logger.debug(f'Generating markdown for {name} of type catalog.')\n        success = False\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(\n            name=name,\n            output=output,\n            trestle_root=self.root_dir,\n            force_overwrite=force_overwrite,\n            yaml_header=yaml_header,\n            overwrite_header_values=overwrite_header_values,\n            verbose=verbose\n        )\n\n        try:\n            ret = catalogauthorcmd.CatalogGenerate()._run(args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error generate markdown for catalog {name}: {e}')\n\n        logger.debug(f'Model {name} markdown generated successfully.')\n        return success\n\n    def generate_profile_markdown(\n        self,\n        name: str,\n        output: str,\n        force_overwrite: bool = False,\n        yaml_header: Optional[str] = None,\n        overwrite_header_values: bool = False,\n        sections: Optional[str] = None,\n        required_sections: Optional[str] = None\n    ) -&gt; bool:\n        \"\"\"Generate profile markdown from OSCAL Profile in JSON.\"\"\"\n        logger.debug(f'Generating markdown for {name} of type profile.')\n        success = False\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(\n            name=name,\n            output=output,\n            trestle_root=self.root_dir,\n            force_overwrite=force_overwrite,\n            yaml_header=yaml_header,\n            overwrite_header_values=overwrite_header_values,\n            sections=sections,\n            required_sections=required_sections,\n            verbose=verbose\n        )\n\n        try:\n            ret = profileauthorcmd.ProfileGenerate()._run(args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error generate markdown for profile {name}: {e}')\n\n        logger.debug(f'Model {name} markdown generated successfully.')\n        return success\n\n    def generate_component_definition_markdown(\n        self,\n        name: str,\n        output: str,\n        force_overwrite: bool = False,\n    ) -&gt; bool:\n        \"\"\"Generate component definition markdown from OSCAL Component Definition in JSON.\"\"\"\n        logger.debug(f'Generating markdown for {name} of type component definition.')\n        success = False\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(\n            name=name, output=output, trestle_root=self.root_dir, force_overwrite=force_overwrite, verbose=verbose\n        )\n\n        try:\n            ret = componentauthorcmd.ComponentGenerate()._run(args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error generating markdown for component definition {name}: {e}')\n\n        logger.debug(f'Model {name} markdown generated successfully.')\n        return success\n\n    def generate_ssp_markdown(\n        self,\n        profile: str,\n        output: str,\n        compdefs: str,\n        leveraged_ssp: Optional[str] = None,\n        force_overwrite: bool = False,\n        include_all_parts: bool = False,\n        yaml_header: Optional[str] = None,\n        overwrite_header_values: bool = False\n    ) -&gt; bool:\n        \"\"\"Generate ssp markdown from OSCAL Profile and Component Definitions.\"\"\"\n        logger.debug(f'Generating markdown for {output} of type ssp.')\n        success = False\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(\n            profile=profile,\n            output=output,\n            compdefs=compdefs,\n            leveraged_ssp=leveraged_ssp,\n            trestle_root=self.root_dir,\n            force_overwrite=force_overwrite,\n            include_all_parts=include_all_parts,\n            yaml_header=yaml_header,\n            overwrite_header_values=overwrite_header_values,\n            verbose=verbose\n        )\n\n        try:\n            ret = sspauthorcmd.SSPGenerate()._run(args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error in generating markdown for ssp {output}: {e}')\n\n        logger.debug(f'Model {output} markdown generated successfully.')\n        return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring.__init__","title":"<code>__init__(root_dir)</code>","text":"<p>Initialize trestle repository object.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def __init__(self, root_dir: pathlib.Path) -&gt; None:\n    \"\"\"Initialize trestle repository object.\"\"\"\n    super().__init__(root_dir)\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring.assemble_catalog_markdown","title":"<code>assemble_catalog_markdown(name, output, markdown_dir, set_parameters=False, regenerate=False, version=None)</code>","text":"<p>Assemble catalog markdown into OSCAL Catalog in JSON.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def assemble_catalog_markdown(\n    self,\n    name: str,\n    output: str,\n    markdown_dir: str,\n    set_parameters: bool = False,\n    regenerate: bool = False,\n    version: Optional[str] = None\n) -&gt; bool:\n    \"\"\"Assemble catalog markdown into OSCAL Catalog in JSON.\"\"\"\n    logger.debug(f'Assembling model {name} of type catalog.')\n    success = False\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(\n        name=name,\n        output=output,\n        markdown=markdown_dir,\n        trestle_root=self.root_dir,\n        set_parameters=set_parameters,\n        regenerate=regenerate,\n        version=version,\n        verbose=verbose\n    )\n\n    try:\n        ret = catalogauthorcmd.CatalogAssemble()._run(args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error assembling catalog {name}: {e}')\n\n    logger.debug(f'Model {name} assembled successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring.assemble_component_definition_markdown","title":"<code>assemble_component_definition_markdown(name, output, markdown_dir, regenerate=False, version='')</code>","text":"<p>Assemble component definition markdown into OSCAL Component Definition in JSON.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def assemble_component_definition_markdown(\n    self, name: str, output: str, markdown_dir: str, regenerate: bool = False, version: str = ''\n) -&gt; bool:\n    \"\"\"Assemble component definition markdown into OSCAL Component Definition in JSON.\"\"\"\n    logger.debug(f'Assembling model {name} of type component definition.')\n    success = False\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(\n        name=name,\n        output=output,\n        markdown=markdown_dir,\n        trestle_root=self.root_dir,\n        regenerate=regenerate,\n        version=version,\n        verbose=verbose\n    )\n\n    try:\n        ret = componentauthorcmd.ComponentAssemble()._run(args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error assembling component definition {name}: {e}')\n\n    logger.debug(f'Model {name} assembled successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring.assemble_profile_markdown","title":"<code>assemble_profile_markdown(name, output, markdown_dir, set_parameters=False, regenerate=False, version=None, sections=None, required_sections=None, allowed_sections=None)</code>","text":"<p>Assemble profile markdown into OSCAL Profile in JSON.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def assemble_profile_markdown(\n    self,\n    name: str,\n    output: str,\n    markdown_dir: str,\n    set_parameters: bool = False,\n    regenerate: bool = False,\n    version: Optional[str] = None,\n    sections: Optional[str] = None,\n    required_sections: Optional[str] = None,\n    allowed_sections: Optional[str] = None\n) -&gt; bool:\n    \"\"\"Assemble profile markdown into OSCAL Profile in JSON.\"\"\"\n    logger.debug(f'Assembling model {name} of type profile.')\n    success = False\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(\n        name=name,\n        output=output,\n        markdown=markdown_dir,\n        trestle_root=self.root_dir,\n        set_parameters=set_parameters,\n        regenerate=regenerate,\n        version=version,\n        sections=sections,\n        required_sections=required_sections,\n        allowed_sections=allowed_sections,\n        verbose=verbose\n    )\n\n    try:\n        ret = profileauthorcmd.ProfileAssemble()._run(args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error assembling profile {name}: {e}')\n\n    logger.debug(f'Model {name} assembled successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring.assemble_ssp_markdown","title":"<code>assemble_ssp_markdown(name, output, markdown_dir, compdefs, regenerate=False, version=None)</code>","text":"<p>Assemble ssp markdown into OSCAL SSP in JSON.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def assemble_ssp_markdown(\n    self,\n    name: str,\n    output: str,\n    markdown_dir: str,\n    compdefs: str,\n    regenerate: bool = False,\n    version: Optional[str] = None\n) -&gt; bool:\n    \"\"\"Assemble ssp markdown into OSCAL SSP in JSON.\"\"\"\n    logger.debug(f'Assembling model {name} of type ssp.')\n    success = False\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(\n        name=name,\n        output=output,\n        markdown=markdown_dir,\n        compdefs=compdefs,\n        trestle_root=self.root_dir,\n        regenerate=regenerate,\n        version=version,\n        verbose=verbose\n    )\n\n    try:\n        ret = sspauthorcmd.SSPAssemble()._run(args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error assembling ssp {name}: {e}')\n\n    logger.debug(f'Model {name} assembled successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring.generate_catalog_markdown","title":"<code>generate_catalog_markdown(name, output, force_overwrite=False, yaml_header=None, overwrite_header_values=False)</code>","text":"<p>Generate catalog markdown from OSCAL Catalog in JSON.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def generate_catalog_markdown(\n    self,\n    name: str,\n    output: str,\n    force_overwrite: bool = False,\n    yaml_header: Optional[str] = None,\n    overwrite_header_values: bool = False\n) -&gt; bool:\n    \"\"\"Generate catalog markdown from OSCAL Catalog in JSON.\"\"\"\n    logger.debug(f'Generating markdown for {name} of type catalog.')\n    success = False\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(\n        name=name,\n        output=output,\n        trestle_root=self.root_dir,\n        force_overwrite=force_overwrite,\n        yaml_header=yaml_header,\n        overwrite_header_values=overwrite_header_values,\n        verbose=verbose\n    )\n\n    try:\n        ret = catalogauthorcmd.CatalogGenerate()._run(args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error generate markdown for catalog {name}: {e}')\n\n    logger.debug(f'Model {name} markdown generated successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring.generate_component_definition_markdown","title":"<code>generate_component_definition_markdown(name, output, force_overwrite=False)</code>","text":"<p>Generate component definition markdown from OSCAL Component Definition in JSON.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def generate_component_definition_markdown(\n    self,\n    name: str,\n    output: str,\n    force_overwrite: bool = False,\n) -&gt; bool:\n    \"\"\"Generate component definition markdown from OSCAL Component Definition in JSON.\"\"\"\n    logger.debug(f'Generating markdown for {name} of type component definition.')\n    success = False\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(\n        name=name, output=output, trestle_root=self.root_dir, force_overwrite=force_overwrite, verbose=verbose\n    )\n\n    try:\n        ret = componentauthorcmd.ComponentGenerate()._run(args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error generating markdown for component definition {name}: {e}')\n\n    logger.debug(f'Model {name} markdown generated successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring.generate_profile_markdown","title":"<code>generate_profile_markdown(name, output, force_overwrite=False, yaml_header=None, overwrite_header_values=False, sections=None, required_sections=None)</code>","text":"<p>Generate profile markdown from OSCAL Profile in JSON.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def generate_profile_markdown(\n    self,\n    name: str,\n    output: str,\n    force_overwrite: bool = False,\n    yaml_header: Optional[str] = None,\n    overwrite_header_values: bool = False,\n    sections: Optional[str] = None,\n    required_sections: Optional[str] = None\n) -&gt; bool:\n    \"\"\"Generate profile markdown from OSCAL Profile in JSON.\"\"\"\n    logger.debug(f'Generating markdown for {name} of type profile.')\n    success = False\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(\n        name=name,\n        output=output,\n        trestle_root=self.root_dir,\n        force_overwrite=force_overwrite,\n        yaml_header=yaml_header,\n        overwrite_header_values=overwrite_header_values,\n        sections=sections,\n        required_sections=required_sections,\n        verbose=verbose\n    )\n\n    try:\n        ret = profileauthorcmd.ProfileGenerate()._run(args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error generate markdown for profile {name}: {e}')\n\n    logger.debug(f'Model {name} markdown generated successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.AgileAuthoring.generate_ssp_markdown","title":"<code>generate_ssp_markdown(profile, output, compdefs, leveraged_ssp=None, force_overwrite=False, include_all_parts=False, yaml_header=None, overwrite_header_values=False)</code>","text":"<p>Generate ssp markdown from OSCAL Profile and Component Definitions.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def generate_ssp_markdown(\n    self,\n    profile: str,\n    output: str,\n    compdefs: str,\n    leveraged_ssp: Optional[str] = None,\n    force_overwrite: bool = False,\n    include_all_parts: bool = False,\n    yaml_header: Optional[str] = None,\n    overwrite_header_values: bool = False\n) -&gt; bool:\n    \"\"\"Generate ssp markdown from OSCAL Profile and Component Definitions.\"\"\"\n    logger.debug(f'Generating markdown for {output} of type ssp.')\n    success = False\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(\n        profile=profile,\n        output=output,\n        compdefs=compdefs,\n        leveraged_ssp=leveraged_ssp,\n        trestle_root=self.root_dir,\n        force_overwrite=force_overwrite,\n        include_all_parts=include_all_parts,\n        yaml_header=yaml_header,\n        overwrite_header_values=overwrite_header_values,\n        verbose=verbose\n    )\n\n    try:\n        ret = sspauthorcmd.SSPGenerate()._run(args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error in generating markdown for ssp {output}: {e}')\n\n    logger.debug(f'Model {output} markdown generated successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL","title":"<code>ManagedOSCAL</code>","text":"<p>Object representing OSCAL models in repository for programmatic manipulation.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>class ManagedOSCAL:\n    \"\"\"Object representing OSCAL models in repository for programmatic manipulation.\"\"\"\n\n    def __init__(self, root_dir: pathlib.Path, model_type: Type[OscalBaseModel], name: str) -&gt; None:\n        \"\"\"Initialize repository OSCAL model object.\"\"\"\n        if not file_utils.is_valid_project_root(root_dir):\n            raise TrestleError(f'Provided root directory {str(root_dir)} is not a valid Trestle root directory.')\n        self.root_dir = root_dir\n        self.model_type = model_type\n        self.model_name = name\n\n        # set model alais and dir\n        self.model_alias = classname_to_alias(self.model_type.__name__, AliasMode.JSON)\n        if parser.to_full_model_name(self.model_alias) is None:\n            raise TrestleError(f'Given model {self.model_alias} is not a top level model.')\n\n        plural_path = ModelUtils.model_type_to_model_dir(self.model_alias)\n        self.model_dir = self.root_dir / plural_path / self.model_name\n\n        if not self.model_dir.exists() or not self.model_dir.is_dir():\n            raise TrestleError(f'Model dir {self.model_name} does not exist.')\n\n        file_content_type = FileContentType.path_to_content_type(self.model_dir / self.model_alias)\n        if file_content_type == FileContentType.UNKNOWN:\n            raise TrestleError(f'Model file for model {self.model_name} does not exist.')\n        self.file_content_type = file_content_type\n\n        filepath = pathlib.Path(\n            self.model_dir,\n            self.model_alias + FileContentType.path_to_file_extension(self.model_dir / self.model_alias)\n        )\n\n        self.filepath = filepath\n\n    def read(self) -&gt; OscalBaseModel:\n        \"\"\"Read OSCAL model from repository.\"\"\"\n        logger.debug(f'Reading model {self.model_name}.')\n        model = load_validate_model_path(self.root_dir, self.filepath)\n        return model\n\n    def write(self, model: OscalBaseModel) -&gt; bool:\n        \"\"\"Write OSCAL model to repository.\"\"\"\n        logger.debug(f'Writing model {self.model_name}.')\n        model_alias = classname_to_alias(model.__class__.__name__, AliasMode.JSON)\n        if parser.to_full_model_name(model_alias) is None:\n            raise TrestleError(f'Given model {model_alias} is not a top level model.')\n\n        # split directory if the model was split\n        split_dir = pathlib.Path(self.model_dir, self.model_alias)\n\n        # Prepare actions; delete split model dir if any, recreate model file, and write to filepath\n        top_element = Element(model)\n        remove_action = RemovePathAction(split_dir)\n        create_action = CreatePathAction(self.filepath, True)\n        write_action = WriteFileAction(self.filepath, top_element, self.file_content_type)\n\n        # create a plan to create the directory and imported file.\n        import_plan = Plan()\n        import_plan.add_action(remove_action)\n        import_plan.add_action(create_action)\n        import_plan.add_action(write_action)\n\n        import_plan.execute()\n\n        logger.debug(f'Model {self.model_name} written to repository')\n        return True\n\n    def split(self, model_file: pathlib.Path, elements: List[str]) -&gt; bool:\n        \"\"\"Split the given OSCAL model file in repository.\n\n        Model file path should be relative to the main model directory, e.g., model dir is $TRESTLE_ROOT/catalogs/NIST\n        then model file path can be 'catalog/metadata.json' if metadata is to be split.\n\n        Elements should be specified relative to model file, e.g., 'metadata.props.*'\n        \"\"\"\n        logger.debug(f'Splitting model {self.model_name}, file {model_file}.')\n        # input model_file should be relative to the model dir\n        model_file_path = self.model_dir / model_file\n        model_file_path = model_file_path.resolve()\n        file_parent = model_file_path.parent\n        filename = model_file_path.name\n\n        elems = ''\n        first = True\n        for elem in elements:\n            if first:\n                elems = elem\n                first = False\n            else:\n                elems = elems + ',' + elem\n\n        success = False\n        try:\n            ret = splitcmd.SplitCmd().perform_split(file_parent, filename, elems, self.root_dir)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error in splitting model: {e}')\n\n        logger.debug(f'Model {self.model_name}, file {model_file} splitted successfully.')\n        return success\n\n    def merge(self, elements: List[str], parent_model_dir: Optional[pathlib.Path] = None) -&gt; bool:\n        \"\"\"Merge OSCAL elements in repository.\n\n        The parent_model_dir specifies the parent model direcotry in which to merge relative to main model dir.\n        For example, if we have to merge 'metadata.*' into 'metadata' then parent_model_dir should be the 'catalog'\n        dir that contains the 'metadata.json' file or the 'metadata' directory\n        \"\"\"\n        logger.debug(f'Merging model {self.model_name}, parent dir {parent_model_dir}.')\n        if parent_model_dir is None:\n            effective_cwd = self.model_dir\n        else:\n            effective_cwd = self.model_dir / parent_model_dir\n\n        success = True\n        try:\n            for elem in elements:\n                plan = mergecmd.MergeCmd.merge(effective_cwd, ElementPath(elem), self.root_dir)\n                plan.execute()\n\n        except Exception as e:\n            raise TrestleError(f'Error in merging model: {e}')\n\n        logger.debug(f'Model {self.model_name} merged successfully.')\n        return success\n\n    def validate(self) -&gt; bool:\n        \"\"\"Validate OSCAL model in repository.\"\"\"\n        logger.debug(f'Validating model {self.model_name}.')\n        repo = Repository(self.root_dir)\n        success = repo.validate_model(self.model_type, self.model_name)\n        return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.file_content_type","title":"<code>file_content_type = file_content_type</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.filepath","title":"<code>filepath = filepath</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.model_alias","title":"<code>model_alias = classname_to_alias(self.model_type.__name__, AliasMode.JSON)</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.model_dir","title":"<code>model_dir = self.root_dir / plural_path / self.model_name</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.model_name","title":"<code>model_name = name</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.model_type","title":"<code>model_type = model_type</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.root_dir","title":"<code>root_dir = root_dir</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.__init__","title":"<code>__init__(root_dir, model_type, name)</code>","text":"<p>Initialize repository OSCAL model object.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def __init__(self, root_dir: pathlib.Path, model_type: Type[OscalBaseModel], name: str) -&gt; None:\n    \"\"\"Initialize repository OSCAL model object.\"\"\"\n    if not file_utils.is_valid_project_root(root_dir):\n        raise TrestleError(f'Provided root directory {str(root_dir)} is not a valid Trestle root directory.')\n    self.root_dir = root_dir\n    self.model_type = model_type\n    self.model_name = name\n\n    # set model alais and dir\n    self.model_alias = classname_to_alias(self.model_type.__name__, AliasMode.JSON)\n    if parser.to_full_model_name(self.model_alias) is None:\n        raise TrestleError(f'Given model {self.model_alias} is not a top level model.')\n\n    plural_path = ModelUtils.model_type_to_model_dir(self.model_alias)\n    self.model_dir = self.root_dir / plural_path / self.model_name\n\n    if not self.model_dir.exists() or not self.model_dir.is_dir():\n        raise TrestleError(f'Model dir {self.model_name} does not exist.')\n\n    file_content_type = FileContentType.path_to_content_type(self.model_dir / self.model_alias)\n    if file_content_type == FileContentType.UNKNOWN:\n        raise TrestleError(f'Model file for model {self.model_name} does not exist.')\n    self.file_content_type = file_content_type\n\n    filepath = pathlib.Path(\n        self.model_dir,\n        self.model_alias + FileContentType.path_to_file_extension(self.model_dir / self.model_alias)\n    )\n\n    self.filepath = filepath\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.merge","title":"<code>merge(elements, parent_model_dir=None)</code>","text":"<p>Merge OSCAL elements in repository.</p> <p>The parent_model_dir specifies the parent model direcotry in which to merge relative to main model dir. For example, if we have to merge 'metadata.*' into 'metadata' then parent_model_dir should be the 'catalog' dir that contains the 'metadata.json' file or the 'metadata' directory</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def merge(self, elements: List[str], parent_model_dir: Optional[pathlib.Path] = None) -&gt; bool:\n    \"\"\"Merge OSCAL elements in repository.\n\n    The parent_model_dir specifies the parent model direcotry in which to merge relative to main model dir.\n    For example, if we have to merge 'metadata.*' into 'metadata' then parent_model_dir should be the 'catalog'\n    dir that contains the 'metadata.json' file or the 'metadata' directory\n    \"\"\"\n    logger.debug(f'Merging model {self.model_name}, parent dir {parent_model_dir}.')\n    if parent_model_dir is None:\n        effective_cwd = self.model_dir\n    else:\n        effective_cwd = self.model_dir / parent_model_dir\n\n    success = True\n    try:\n        for elem in elements:\n            plan = mergecmd.MergeCmd.merge(effective_cwd, ElementPath(elem), self.root_dir)\n            plan.execute()\n\n    except Exception as e:\n        raise TrestleError(f'Error in merging model: {e}')\n\n    logger.debug(f'Model {self.model_name} merged successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.read","title":"<code>read()</code>","text":"<p>Read OSCAL model from repository.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def read(self) -&gt; OscalBaseModel:\n    \"\"\"Read OSCAL model from repository.\"\"\"\n    logger.debug(f'Reading model {self.model_name}.')\n    model = load_validate_model_path(self.root_dir, self.filepath)\n    return model\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.split","title":"<code>split(model_file, elements)</code>","text":"<p>Split the given OSCAL model file in repository.</p> <p>Model file path should be relative to the main model directory, e.g., model dir is $TRESTLE_ROOT/catalogs/NIST then model file path can be 'catalog/metadata.json' if metadata is to be split.</p> <p>Elements should be specified relative to model file, e.g., 'metadata.props.*'</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def split(self, model_file: pathlib.Path, elements: List[str]) -&gt; bool:\n    \"\"\"Split the given OSCAL model file in repository.\n\n    Model file path should be relative to the main model directory, e.g., model dir is $TRESTLE_ROOT/catalogs/NIST\n    then model file path can be 'catalog/metadata.json' if metadata is to be split.\n\n    Elements should be specified relative to model file, e.g., 'metadata.props.*'\n    \"\"\"\n    logger.debug(f'Splitting model {self.model_name}, file {model_file}.')\n    # input model_file should be relative to the model dir\n    model_file_path = self.model_dir / model_file\n    model_file_path = model_file_path.resolve()\n    file_parent = model_file_path.parent\n    filename = model_file_path.name\n\n    elems = ''\n    first = True\n    for elem in elements:\n        if first:\n            elems = elem\n            first = False\n        else:\n            elems = elems + ',' + elem\n\n    success = False\n    try:\n        ret = splitcmd.SplitCmd().perform_split(file_parent, filename, elems, self.root_dir)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error in splitting model: {e}')\n\n    logger.debug(f'Model {self.model_name}, file {model_file} splitted successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.validate","title":"<code>validate()</code>","text":"<p>Validate OSCAL model in repository.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def validate(self) -&gt; bool:\n    \"\"\"Validate OSCAL model in repository.\"\"\"\n    logger.debug(f'Validating model {self.model_name}.')\n    repo = Repository(self.root_dir)\n    success = repo.validate_model(self.model_type, self.model_name)\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.ManagedOSCAL.write","title":"<code>write(model)</code>","text":"<p>Write OSCAL model to repository.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def write(self, model: OscalBaseModel) -&gt; bool:\n    \"\"\"Write OSCAL model to repository.\"\"\"\n    logger.debug(f'Writing model {self.model_name}.')\n    model_alias = classname_to_alias(model.__class__.__name__, AliasMode.JSON)\n    if parser.to_full_model_name(model_alias) is None:\n        raise TrestleError(f'Given model {model_alias} is not a top level model.')\n\n    # split directory if the model was split\n    split_dir = pathlib.Path(self.model_dir, self.model_alias)\n\n    # Prepare actions; delete split model dir if any, recreate model file, and write to filepath\n    top_element = Element(model)\n    remove_action = RemovePathAction(split_dir)\n    create_action = CreatePathAction(self.filepath, True)\n    write_action = WriteFileAction(self.filepath, top_element, self.file_content_type)\n\n    # create a plan to create the directory and imported file.\n    import_plan = Plan()\n    import_plan.add_action(remove_action)\n    import_plan.add_action(create_action)\n    import_plan.add_action(write_action)\n\n    import_plan.execute()\n\n    logger.debug(f'Model {self.model_name} written to repository')\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository","title":"<code>Repository</code>","text":"<p>Repository class for performing operations on Trestle repository.</p> <p>This class provides a set of APIs to perform operations on trestle repository programmatically rather than using the command line. It takes the trestle root directory as input while creating an instance of this object. Operations such as import and get model return a ManagedOSCAL object representing the specific model that can be used to perform operations on the specific models.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>class Repository:\n    \"\"\"Repository class for performing operations on Trestle repository.\n\n    This class provides a set of APIs to perform operations on trestle repository programmatically\n    rather than using the command line. It takes the trestle root directory as input while creating\n    an instance of this object. Operations such as import and get model return a ManagedOSCAL object\n    representing the specific model that can be used to perform operations on the specific models.\n\n    \"\"\"\n\n    def __init__(self, root_dir: pathlib.Path) -&gt; None:\n        \"\"\"Initialize trestle repository object.\"\"\"\n        if not file_utils.is_valid_project_root(root_dir):\n            raise TrestleError(f'Provided root directory {root_dir} is not a valid Trestle root directory.')\n        self.root_dir = root_dir\n\n    def import_model(\n        self, model: OscalBaseModel, name: str, content_type: FileContentType = FileContentType.JSON\n    ) -&gt; ManagedOSCAL:\n        \"\"\"Import OSCAL object into trestle repository.\"\"\"\n        logger.debug(f'Importing model {name} of type {model.__class__.__name__}.')\n        model_alias = classname_to_alias(model.__class__.__name__, AliasMode.JSON)\n        if parser.to_full_model_name(model_alias) is None:\n            raise TrestleError(f'Given model {model_alias} is not a top level model.')\n\n        # Work out output directory and file\n        plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n\n        desired_model_dir = self.root_dir / plural_path\n        desired_model_path = desired_model_dir / name / (model_alias + FileContentType.to_file_extension(content_type))\n        desired_model_path = desired_model_path.resolve()\n\n        if desired_model_path.exists():\n            raise TrestleError(f'OSCAL file to be created here: {desired_model_path} exists.')\n\n        content_type = FileContentType.to_content_type(pathlib.Path(desired_model_path).suffix)\n\n        # Prepare actions\n        top_element = Element(model)\n        create_action = CreatePathAction(desired_model_path, True)\n        write_action = WriteFileAction(desired_model_path, top_element, content_type)\n\n        # create a plan to create the directory and imported file.\n        import_plan = Plan()\n        import_plan.add_action(create_action)\n        import_plan.add_action(write_action)\n        import_plan.execute()\n\n        # Validate the imported file, rollback if unsuccessful\n        success = False\n        errmsg = ''\n        try:\n            success = self.validate_model(model.__class__, name)\n            if not success:\n                errmsg = f'Validation of model {name} did not pass'\n                logger.error(errmsg)\n        except Exception as err:\n            logger.error(errmsg)\n            errmsg = f'Import of model {name} failed. Validation failed with error: {err}'\n\n        if not success:\n            # rollback in case of validation error or failure\n            logger.debug(f'Rolling back import of model {name} to {desired_model_path}')\n            try:\n                import_plan.rollback()\n            except TrestleError as err:\n                logger.error(f'Failed to rollback: {err}. Remove {desired_model_path} to resolve state.')\n            else:\n                logger.debug(f'Successful rollback of import to {desired_model_path}')\n\n            # raise trestle error\n            raise TrestleError(errmsg)\n\n        # all well; model was imported and validated successfully\n        logger.debug(f'Model {name} of type {model.__class__.__name__} imported successfully.')\n        return ManagedOSCAL(self.root_dir, model.__class__, name)\n\n    def load_and_import_model(\n        self,\n        model_path: pathlib.Path,\n        name: str,\n        content_type: FileContentType = FileContentType.JSON\n    ) -&gt; ManagedOSCAL:\n        \"\"\"Load the model at the specified path into trestle with the specified name.\"\"\"\n        fetcher = cache.FetcherFactory.get_fetcher(self.root_dir, str(model_path))\n        model, _ = fetcher.get_oscal(True)\n\n        return self.import_model(model, name, content_type)\n\n    def list_models(self, model_type: Type[OscalBaseModel]) -&gt; List[str]:\n        \"\"\"List models of a given type in trestle repository.\"\"\"\n        logger.debug(f'Listing models of type {model_type.__name__}.')\n        model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n        if parser.to_full_model_name(model_alias) is None:\n            raise TrestleError(f'Given model {model_alias} is not a top level model.')\n        models = ModelUtils.get_models_of_type(model_alias, self.root_dir)\n\n        return models\n\n    def get_model(self, model_type: Type[OscalBaseModel], name: str) -&gt; ManagedOSCAL:\n        \"\"\"Get a specific OSCAL model from repository.\"\"\"\n        logger.debug(f'Getting model {name} of type {model_type.__name__}.')\n        model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n        if parser.to_full_model_name(model_alias) is None:\n            raise TrestleError(f'Given model {model_alias} is not a top level model.')\n        plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n        desired_model_dir = self.root_dir / plural_path / name\n\n        if not desired_model_dir.exists() or not desired_model_dir.is_dir():\n            raise TrestleError(f'Model {name} does not exist.')\n\n        return ManagedOSCAL(self.root_dir, model_type, name)\n\n    def delete_model(self, model_type: Type[OscalBaseModel], name: str) -&gt; bool:\n        \"\"\"Delete an OSCAL model from repository.\"\"\"\n        logger.debug(f'Deleting model {name} of type {model_type.__name__}.')\n        model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n        if parser.to_full_model_name(model_alias) is None:\n            raise TrestleError(f'Given model {model_alias} is not a top level model.')\n        plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n        desired_model_dir = self.root_dir / plural_path / name\n\n        if not desired_model_dir.exists() or not desired_model_dir.is_dir():\n            raise TrestleError(f'Model {name} does not exist.')\n        shutil.rmtree(desired_model_dir)\n\n        # remove model from dist directory if it exists\n        dist_model_dir = self.root_dir / const.TRESTLE_DIST_DIR / plural_path\n        file_content_type = FileContentType.path_to_content_type(dist_model_dir / name)\n        if file_content_type != FileContentType.UNKNOWN:\n            file_path = pathlib.Path(\n                dist_model_dir, name + FileContentType.path_to_file_extension(dist_model_dir / name)\n            )\n            logger.debug(f'Deleting model {name} from dist directory.')\n            os.remove(file_path)\n\n        logger.debug(f'Model {name} deleted successfully.')\n        return True\n\n    def assemble_model(self, model_type: Type[OscalBaseModel], name: str, extension: str = 'json') -&gt; bool:\n        \"\"\"Assemble an OSCAL model in repository and publish it to 'dist' directory.\"\"\"\n        logger.debug(f'Assembling model {name} of type {model_type.__name__}.')\n        success = False\n\n        model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n        if parser.to_full_model_name(model_alias) is None:\n            raise TrestleError(f'Given model {model_alias} is not a top level model.')\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(\n            type=model_alias, name=name, extension=extension, trestle_root=self.root_dir, verbose=verbose\n        )\n\n        try:\n            ret = assemblecmd.AssembleCmd().assemble_model(model_alias, args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error in assembling model: {e}')\n\n        logger.debug(f'Model {name} assembled successfully.')\n        return success\n\n    def validate_model(self, model_type: Type[OscalBaseModel], name: str) -&gt; bool:\n        \"\"\"Validate an OSCAL model in repository.\"\"\"\n        logger.debug(f'Validating model {name} of type {model_type.__name__}.')\n        success = False\n\n        model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n        if parser.to_full_model_name(model_alias) is None:\n            raise TrestleError(f'Given model {model_alias} is not a top level model.')\n\n        verbose = log.get_current_verbosity_level(logger)\n        args = argparse.Namespace(type=model_alias, name=name, trestle_root=self.root_dir, verbose=verbose, quiet=False)\n\n        try:\n            ret = validatecmd.ValidateCmd()._run(args)\n            if ret == 0:\n                success = True\n        except Exception as e:\n            raise TrestleError(f'Error in validating model: {e}')\n\n        logger.debug(f'Model {name} validated successfully.')\n        return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository.root_dir","title":"<code>root_dir = root_dir</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository.__init__","title":"<code>__init__(root_dir)</code>","text":"<p>Initialize trestle repository object.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def __init__(self, root_dir: pathlib.Path) -&gt; None:\n    \"\"\"Initialize trestle repository object.\"\"\"\n    if not file_utils.is_valid_project_root(root_dir):\n        raise TrestleError(f'Provided root directory {root_dir} is not a valid Trestle root directory.')\n    self.root_dir = root_dir\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository.assemble_model","title":"<code>assemble_model(model_type, name, extension='json')</code>","text":"<p>Assemble an OSCAL model in repository and publish it to 'dist' directory.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def assemble_model(self, model_type: Type[OscalBaseModel], name: str, extension: str = 'json') -&gt; bool:\n    \"\"\"Assemble an OSCAL model in repository and publish it to 'dist' directory.\"\"\"\n    logger.debug(f'Assembling model {name} of type {model_type.__name__}.')\n    success = False\n\n    model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n    if parser.to_full_model_name(model_alias) is None:\n        raise TrestleError(f'Given model {model_alias} is not a top level model.')\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(\n        type=model_alias, name=name, extension=extension, trestle_root=self.root_dir, verbose=verbose\n    )\n\n    try:\n        ret = assemblecmd.AssembleCmd().assemble_model(model_alias, args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error in assembling model: {e}')\n\n    logger.debug(f'Model {name} assembled successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository.delete_model","title":"<code>delete_model(model_type, name)</code>","text":"<p>Delete an OSCAL model from repository.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def delete_model(self, model_type: Type[OscalBaseModel], name: str) -&gt; bool:\n    \"\"\"Delete an OSCAL model from repository.\"\"\"\n    logger.debug(f'Deleting model {name} of type {model_type.__name__}.')\n    model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n    if parser.to_full_model_name(model_alias) is None:\n        raise TrestleError(f'Given model {model_alias} is not a top level model.')\n    plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n    desired_model_dir = self.root_dir / plural_path / name\n\n    if not desired_model_dir.exists() or not desired_model_dir.is_dir():\n        raise TrestleError(f'Model {name} does not exist.')\n    shutil.rmtree(desired_model_dir)\n\n    # remove model from dist directory if it exists\n    dist_model_dir = self.root_dir / const.TRESTLE_DIST_DIR / plural_path\n    file_content_type = FileContentType.path_to_content_type(dist_model_dir / name)\n    if file_content_type != FileContentType.UNKNOWN:\n        file_path = pathlib.Path(\n            dist_model_dir, name + FileContentType.path_to_file_extension(dist_model_dir / name)\n        )\n        logger.debug(f'Deleting model {name} from dist directory.')\n        os.remove(file_path)\n\n    logger.debug(f'Model {name} deleted successfully.')\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository.get_model","title":"<code>get_model(model_type, name)</code>","text":"<p>Get a specific OSCAL model from repository.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def get_model(self, model_type: Type[OscalBaseModel], name: str) -&gt; ManagedOSCAL:\n    \"\"\"Get a specific OSCAL model from repository.\"\"\"\n    logger.debug(f'Getting model {name} of type {model_type.__name__}.')\n    model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n    if parser.to_full_model_name(model_alias) is None:\n        raise TrestleError(f'Given model {model_alias} is not a top level model.')\n    plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n    desired_model_dir = self.root_dir / plural_path / name\n\n    if not desired_model_dir.exists() or not desired_model_dir.is_dir():\n        raise TrestleError(f'Model {name} does not exist.')\n\n    return ManagedOSCAL(self.root_dir, model_type, name)\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository.import_model","title":"<code>import_model(model, name, content_type=FileContentType.JSON)</code>","text":"<p>Import OSCAL object into trestle repository.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def import_model(\n    self, model: OscalBaseModel, name: str, content_type: FileContentType = FileContentType.JSON\n) -&gt; ManagedOSCAL:\n    \"\"\"Import OSCAL object into trestle repository.\"\"\"\n    logger.debug(f'Importing model {name} of type {model.__class__.__name__}.')\n    model_alias = classname_to_alias(model.__class__.__name__, AliasMode.JSON)\n    if parser.to_full_model_name(model_alias) is None:\n        raise TrestleError(f'Given model {model_alias} is not a top level model.')\n\n    # Work out output directory and file\n    plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n\n    desired_model_dir = self.root_dir / plural_path\n    desired_model_path = desired_model_dir / name / (model_alias + FileContentType.to_file_extension(content_type))\n    desired_model_path = desired_model_path.resolve()\n\n    if desired_model_path.exists():\n        raise TrestleError(f'OSCAL file to be created here: {desired_model_path} exists.')\n\n    content_type = FileContentType.to_content_type(pathlib.Path(desired_model_path).suffix)\n\n    # Prepare actions\n    top_element = Element(model)\n    create_action = CreatePathAction(desired_model_path, True)\n    write_action = WriteFileAction(desired_model_path, top_element, content_type)\n\n    # create a plan to create the directory and imported file.\n    import_plan = Plan()\n    import_plan.add_action(create_action)\n    import_plan.add_action(write_action)\n    import_plan.execute()\n\n    # Validate the imported file, rollback if unsuccessful\n    success = False\n    errmsg = ''\n    try:\n        success = self.validate_model(model.__class__, name)\n        if not success:\n            errmsg = f'Validation of model {name} did not pass'\n            logger.error(errmsg)\n    except Exception as err:\n        logger.error(errmsg)\n        errmsg = f'Import of model {name} failed. Validation failed with error: {err}'\n\n    if not success:\n        # rollback in case of validation error or failure\n        logger.debug(f'Rolling back import of model {name} to {desired_model_path}')\n        try:\n            import_plan.rollback()\n        except TrestleError as err:\n            logger.error(f'Failed to rollback: {err}. Remove {desired_model_path} to resolve state.')\n        else:\n            logger.debug(f'Successful rollback of import to {desired_model_path}')\n\n        # raise trestle error\n        raise TrestleError(errmsg)\n\n    # all well; model was imported and validated successfully\n    logger.debug(f'Model {name} of type {model.__class__.__name__} imported successfully.')\n    return ManagedOSCAL(self.root_dir, model.__class__, name)\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository.list_models","title":"<code>list_models(model_type)</code>","text":"<p>List models of a given type in trestle repository.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def list_models(self, model_type: Type[OscalBaseModel]) -&gt; List[str]:\n    \"\"\"List models of a given type in trestle repository.\"\"\"\n    logger.debug(f'Listing models of type {model_type.__name__}.')\n    model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n    if parser.to_full_model_name(model_alias) is None:\n        raise TrestleError(f'Given model {model_alias} is not a top level model.')\n    models = ModelUtils.get_models_of_type(model_alias, self.root_dir)\n\n    return models\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository.load_and_import_model","title":"<code>load_and_import_model(model_path, name, content_type=FileContentType.JSON)</code>","text":"<p>Load the model at the specified path into trestle with the specified name.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def load_and_import_model(\n    self,\n    model_path: pathlib.Path,\n    name: str,\n    content_type: FileContentType = FileContentType.JSON\n) -&gt; ManagedOSCAL:\n    \"\"\"Load the model at the specified path into trestle with the specified name.\"\"\"\n    fetcher = cache.FetcherFactory.get_fetcher(self.root_dir, str(model_path))\n    model, _ = fetcher.get_oscal(True)\n\n    return self.import_model(model, name, content_type)\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository.Repository.validate_model","title":"<code>validate_model(model_type, name)</code>","text":"<p>Validate an OSCAL model in repository.</p> Source code in <code>trestle/core/repository.py</code> <pre><code>def validate_model(self, model_type: Type[OscalBaseModel], name: str) -&gt; bool:\n    \"\"\"Validate an OSCAL model in repository.\"\"\"\n    logger.debug(f'Validating model {name} of type {model_type.__name__}.')\n    success = False\n\n    model_alias = classname_to_alias(model_type.__name__, AliasMode.JSON)\n    if parser.to_full_model_name(model_alias) is None:\n        raise TrestleError(f'Given model {model_alias} is not a top level model.')\n\n    verbose = log.get_current_verbosity_level(logger)\n    args = argparse.Namespace(type=model_alias, name=name, trestle_root=self.root_dir, verbose=verbose, quiet=False)\n\n    try:\n        ret = validatecmd.ValidateCmd()._run(args)\n        if ret == 0:\n            success = True\n    except Exception as e:\n        raise TrestleError(f'Error in validating model: {e}')\n\n    logger.debug(f'Model {name} validated successfully.')\n    return success\n</code></pre>"},{"location":"reference/API/trestle/core/repository/#trestle.core.repository-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/rule_parameters_validator/","title":"trestle.core.rule_parameters_validator","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/rule_parameters_validator/#trestle.core.rule_parameters_validator","title":"<code>trestle.core.rule_parameters_validator</code>","text":"<p>Validate by confirming rule parameter values are consistent.</p>"},{"location":"reference/API/trestle/core/rule_parameters_validator/#trestle.core.rule_parameters_validator-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/rule_parameters_validator/#trestle.core.rule_parameters_validator.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/rule_parameters_validator/#trestle.core.rule_parameters_validator-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/rule_parameters_validator/#trestle.core.rule_parameters_validator.RuleParametersValidator","title":"<code>RuleParametersValidator</code>","text":"<p>               Bases: <code>Validator</code></p> <p>Validator to confirm all rule parameter values are consistent.</p> Source code in <code>trestle/core/rule_parameters_validator.py</code> <pre><code>class RuleParametersValidator(Validator):\n    \"\"\"Validator to confirm all rule parameter values are consistent.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize rule param values dictionary.\"\"\"\n        self._rule_param_values_dict: Dict[str, Any] = {}\n\n    def _add_imp_req_rule_params_to_dict(\n        self,\n        imp_requirement: ImplementedRequirement,\n        cat_int: CatalogInterface,\n    ) -&gt; None:\n        \"\"\"\n        Iterate all by components in an object and add the rule shared parameter values to list.\n\n        args:\n            imp_requirement: Current implemented requirement.\n            cat_int: Instance of catalog interface with controls catalog loaded.\n        \"\"\"\n        for by_component in as_list(imp_requirement.by_components):\n            # adds rule param values present in set parameters for current imp req\n            self._add_rule_params(imp_requirement, imp_requirement.control_id, cat_int, by_component.component_uuid)\n            # adds rule param values present in set parameters for current by_component in by_components list\n            # in the current implemented requirement\n            self._add_rule_params(by_component, imp_requirement.control_id, cat_int, by_component.component_uuid)\n            for statement in as_list(imp_requirement.statements):\n                # iterates by each by component inclded at each statemtent set for current imp req\n                for by_comp in as_list(statement.by_components):\n                    # adds rule param values present in set parameters for current by_component in by_components list\n                    # of current statement in current implemented requirement\n                    self._add_rule_params(by_comp, imp_requirement.control_id, cat_int, by_comp.component_uuid)\n\n    def _add_rule_params(\n        self, item: TypeWithSetParams, control_id: str, cat_int: CatalogInterface, comp_uuid: str = ''\n    ) -&gt; None:\n        \"\"\"\n        Add a rule shared parameter to the rule shared parameters list.\n\n        args:\n            item: Generic item to iterate over parameters.\n            control_id: Current control id.\n            cat_int: Instance of catalog interface with controls catalog loaded.\n            comp_uuid: Component uuid to save.\n        \"\"\"\n        for set_param in as_list(item.set_parameters):\n            # validates if current param_id is or not associated with a control so we can assume it\u00b4s a rule param\n            control = cat_int.get_control_by_param_id(set_param.param_id)\n            if not control:\n                deep_set(self._rule_param_values_dict, [set_param.param_id, comp_uuid, control_id], set_param.values)\n\n    def model_is_valid(\n        self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n    ) -&gt; bool:\n        \"\"\"\n        Test if the model is valid.\n\n        args:\n            model: A top level OSCAL model.\n            quiet: Don't report msgs unless invalid.\n            trestle_root: Trestle root path.\n\n        returns:\n            True (valid) if the model's rule parameter values are the same across controls.\n        \"\"\"\n        # verify if model type is either an SSP of a Component Definition\n        if not isinstance(model, SystemSecurityPlan):\n            return True\n\n        if not model.import_profile.href:\n            logger.info(f'INVALID: Model {model.metadata.title} has no referenced profile')\n            return False\n        profile_catalog = ProfileResolver().get_resolved_profile_catalog(trestle_root, model.import_profile.href)\n        catalog_interface = CatalogInterface(profile_catalog)\n        # iterate by each implemented requirement defined\n        for imp_req in model.control_implementation.implemented_requirements:\n            # adds rule param values to dict by implemented requirement basis\n            self._add_imp_req_rule_params_to_dict(imp_req, catalog_interface)\n        if self._rule_param_values_dict:\n            # compare all values in shared paramerets by component basis\n            for shared_param, values_dict in self._rule_param_values_dict.items():\n                for comp_name, value_dict in values_dict.items():\n                    expected_value = next(iter(value_dict.values()))\n                    if not all(value == expected_value for value in value_dict.values()):\n                        logger.error(\n                            f'Rule parameter values for param: {shared_param} in '\n                            f' {comp_name} are not consistent with '\n                            'other values provided across controls. Invalid model'\n                        )\n                        return False\n        return True\n</code></pre>"},{"location":"reference/API/trestle/core/rule_parameters_validator/#trestle.core.rule_parameters_validator.RuleParametersValidator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/rule_parameters_validator/#trestle.core.rule_parameters_validator.RuleParametersValidator.__init__","title":"<code>__init__()</code>","text":"<p>Initialize rule param values dictionary.</p> Source code in <code>trestle/core/rule_parameters_validator.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize rule param values dictionary.\"\"\"\n    self._rule_param_values_dict: Dict[str, Any] = {}\n</code></pre>"},{"location":"reference/API/trestle/core/rule_parameters_validator/#trestle.core.rule_parameters_validator.RuleParametersValidator.model_is_valid","title":"<code>model_is_valid(model, quiet, trestle_root=None)</code>","text":"<p>Test if the model is valid.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>TopLevelOscalModel</code> <p>A top level OSCAL model.</p> required <code>quiet</code> <code>bool</code> <p>Don't report msgs unless invalid.</p> required <code>trestle_root</code> <code>Optional[Path]</code> <p>Trestle root path.</p> <code>None</code> <p>Returns:</p> Type Description <code>bool</code> <p>True (valid) if the model's rule parameter values are the same across controls.</p> Source code in <code>trestle/core/rule_parameters_validator.py</code> <pre><code>def model_is_valid(\n    self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n) -&gt; bool:\n    \"\"\"\n    Test if the model is valid.\n\n    args:\n        model: A top level OSCAL model.\n        quiet: Don't report msgs unless invalid.\n        trestle_root: Trestle root path.\n\n    returns:\n        True (valid) if the model's rule parameter values are the same across controls.\n    \"\"\"\n    # verify if model type is either an SSP of a Component Definition\n    if not isinstance(model, SystemSecurityPlan):\n        return True\n\n    if not model.import_profile.href:\n        logger.info(f'INVALID: Model {model.metadata.title} has no referenced profile')\n        return False\n    profile_catalog = ProfileResolver().get_resolved_profile_catalog(trestle_root, model.import_profile.href)\n    catalog_interface = CatalogInterface(profile_catalog)\n    # iterate by each implemented requirement defined\n    for imp_req in model.control_implementation.implemented_requirements:\n        # adds rule param values to dict by implemented requirement basis\n        self._add_imp_req_rule_params_to_dict(imp_req, catalog_interface)\n    if self._rule_param_values_dict:\n        # compare all values in shared paramerets by component basis\n        for shared_param, values_dict in self._rule_param_values_dict.items():\n            for comp_name, value_dict in values_dict.items():\n                expected_value = next(iter(value_dict.values()))\n                if not all(value == expected_value for value in value_dict.values()):\n                    logger.error(\n                        f'Rule parameter values for param: {shared_param} in '\n                        f' {comp_name} are not consistent with '\n                        'other values provided across controls. Invalid model'\n                    )\n                    return False\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/rule_parameters_validator/#trestle.core.rule_parameters_validator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/ssp_io/","title":"trestle.core.ssp_io","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io","title":"<code>trestle.core.ssp_io</code>","text":"<p>Handle direct IO for writing SSP responses as markdown.</p>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter","title":"<code>SSPMarkdownWriter</code>","text":"<p>Class to write control responses as markdown.</p> <p>Functions in this class are mainly used by jinja and not by the trestle code itself.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>class SSPMarkdownWriter():\n    \"\"\"\n    Class to write control responses as markdown.\n\n    Functions in this class are mainly used by jinja and not by the trestle code itself.\n    \"\"\"\n\n    def __init__(self, trestle_root: pathlib.Path) -&gt; None:\n        \"\"\"Initialize the class.\"\"\"\n        self._trestle_root = trestle_root\n        self._ssp: ssp.SystemSecurityPlan = None\n        self._resolved_catalog: Catalog = None\n        self._catalog_interface: CatalogInterface = None\n\n    def set_ssp(self, ssp: ssp.SystemSecurityPlan) -&gt; None:\n        \"\"\"Set ssp.\"\"\"\n        self._ssp = ssp\n\n    def set_catalog(self, resolved_catalog: Catalog) -&gt; None:\n        \"\"\"Set catalog.\"\"\"\n        self._resolved_catalog = resolved_catalog\n        self._catalog_interface = catalog_interface.CatalogInterface(self._resolved_catalog)\n\n    def get_control_statement(self, control_id: str, level: int) -&gt; str:\n        \"\"\"\n        Get the control statement for an ssp - to be printed in markdown as a structured list.\n\n        Args:\n            control_id: The control_id to use.\n\n        Returns:\n            A markdown blob as a string.\n        \"\"\"\n        if not self._resolved_catalog:\n            raise TrestleError('Cannot get control statement, set resolved catalog first.')\n\n        writer = DocsControlWriter()\n        control = self._catalog_interface.get_control(control_id)\n        if not control:\n            return ''\n\n        control_lines = writer.get_control_statement_ssp(control)\n\n        return self._build_tree_and_adjust(control_lines, level)\n\n    def get_control_part(self, control_id: str, part_name: str, level: int) -&gt; str:\n        \"\"\"Get control part with given name.\"\"\"\n        control_part = self._catalog_interface.get_control_part_prose(control_id, part_name)\n\n        md_list = self._write_str_with_header(\n            f'Control Part: {part_name} for control: {control_id}', control_part, level\n        )\n        return self._build_tree_and_adjust(md_list.split('\\n'), level)\n\n    def get_fedramp_control_tables(self, control_id: str, level: int, label_column: bool = False) -&gt; str:\n        \"\"\"Get the fedramp metadata as markdown tables, with optional third label column for params.\n\n        The fedramp metadata has the following elements:\n        - Responsible roles field\n        - Parameter values table\n        - Implementation status field\n        - Control origination field\n\n        Returns:\n            tables as one coherent markdown blob.\n        \"\"\"\n        resp_roles_table = self.get_responsible_roles_table(control_id, level)\n        params_values = self._parameter_table(control_id, level, label_column)\n        impl_status = self.get_fedramp_implementation_status(control_id, level)\n        control_orig = self.get_fedramp_control_origination(control_id, level)\n\n        final_output = ''\n        if resp_roles_table:\n            final_output += resp_roles_table\n        if params_values:\n            final_output += '\\n' + params_values\n        if impl_status:\n            final_output += '\\n' + impl_status\n        if control_orig:\n            final_output += '\\n' + control_orig\n        return final_output\n\n    def get_responsible_roles_table(self, control_id: str, level: int) -&gt; str:\n        \"\"\"\n        For each role id - if the role exists in metadata use the title as what gets printed in the roles table.\n\n        If not (for now) warn and use the role-id as the printed text.\n        \"\"\"\n        if self._ssp is None:\n            raise TrestleError('Cannot get responsible roles, SSP is not set.')\n\n        for impl_requirement in self._ssp.control_implementation.implemented_requirements:\n            if impl_requirement.control_id == control_id:\n                if impl_requirement.responsible_roles:\n                    resp_roles = as_list(impl_requirement.responsible_roles)\n                    role_ids = [role.role_id.replace('_', ' ') for role in resp_roles]\n\n                    # now check if this role exists in the metadata\n                    role_titles = dict(zip(role_ids, role_ids))\n                    roles = as_list(self._ssp.metadata.roles)\n                    for role in roles:\n                        if role.id in role_ids:\n                            role_titles[role.id] = role.title\n\n                    # dictionary to md table\n                    md_list = self._write_table_with_header(\n                        'Responsible Roles.', [[key, role_titles[key]] for key in role_titles.keys()],\n                        ['Role ID', 'Title'],\n                        level\n                    )\n                    return md_list\n                else:\n                    logger.warning(\n                        f'No responsible roles were found for the control with id: {control_id} in given SSP.'\n                    )\n                    return ''\n\n        return ''\n\n    def _parameter_table(self, control_id: str, level: int, label_column: bool = False) -&gt; str:\n        \"\"\"Print Param_id | ValueOrLabelOrChoices | Optional Label Column.\"\"\"\n        if not self._ssp:\n            raise TrestleError('Cannot get parameter table, set SSP first.')\n\n        writer = DocsControlWriter()\n        control = self._catalog_interface.get_control(control_id)\n        if not control:\n            return ''\n        params_lines = writer.get_param_table(control, label_column)\n        # need to make sure no params still have moustaches.  convert to brackets to avoid jinja complaints\n        clean_lines = []\n        for line in params_lines:\n            clean_lines.append(line.replace('{{', '[[').replace('}}', ']]'))\n\n        tree = DocsMarkdownNode.build_tree_from_markdown(clean_lines)\n        tree.change_header_level_by(level)\n        return tree.content.raw_text\n\n    def get_fedramp_implementation_status(self, control_id: str, level: int) -&gt; str:\n        \"\"\"\n        Print implementation status as a list of items, only showing those that are applicable for the control.\n\n        This is unlike the word document FedRAMP which uses checkboxes on standard set of options.\n        Using a LUT to map between structured data fields, defined by FedRAMP and historical text.\n        \"\"\"\n        if not self._ssp:\n            raise TrestleError('Cannot get Fedramp implementation status, set SSP first.')\n\n        implementation_statuses: List[str] = []\n        control_impl_req = self._control_implemented_req(control_id)\n        if control_impl_req and control_impl_req.props:\n            for prop in control_impl_req.props:\n                if prop.name == IMPLEMENTATION_STATUS:\n                    implementation_statuses.append(prop.value)\n\n        md_list = self._write_list_with_header('FedRamp Implementation Status.', implementation_statuses, level)\n        return md_list\n\n    def get_fedramp_control_origination(self, control_id: str, level: int) -&gt; str:\n        \"\"\"\n        Print control origination, as a list of items, only showing those that are applicable for the control.\n\n        Using a LUT to map between structured data fields, defined by FedRAMP and historical text.\n        \"\"\"\n        if not self._ssp:\n            raise TrestleError('Cannot get FedRamp control origination, set SSP first.')\n\n        control_origination = []\n        control_impl_req = self._control_implemented_req(control_id)\n\n        if control_impl_req and control_impl_req.props:\n            for prop in control_impl_req.props:\n                if prop.name == CONTROL_ORIGINATION:\n                    control_origination.append(prop.value)\n\n        md_list = self._write_list_with_header('FedRamp Control Origination.', control_origination, level)\n        return md_list\n\n    @staticmethod\n    def _write_component_prompt(\n        md_writer: MDWriter,\n        comp_name: str,\n        prose: str,\n        rules: List[str],\n        status: str,\n        show_rules: bool,\n        show_status: bool\n    ) -&gt; None:\n        header = f'Component: {comp_name}'\n        md_writer.new_header(1, header)\n        md_writer.set_indent_level(-1)\n        md_writer.new_line(prose)\n        md_writer.set_indent_level(-1)\n        if rules and show_rules:\n            md_writer.new_header(2, title='Rules:')\n            md_writer.set_indent_level(-1)\n            md_writer.new_list(rules)\n            md_writer.set_indent_level(-1)\n        if status and show_status:\n            md_writer.new_header(2, title=f'Implementation Status: {status}')\n\n    def get_control_response(\n        self,\n        control_id: str,\n        level: int,\n        write_empty_responses: bool = False,\n        show_comp: bool = True,\n        show_rules: bool = False,\n        show_status: bool = True\n    ) -&gt; str:\n        \"\"\"\n        Get the full control implemented requirements, broken down based on the available control responses.\n\n        Args:\n            control_id: id of the control\n            level: level of indentation\n            write_empty_responses: write response even if empty\n            show_comp: show the component name in the response\n\n        Notes:\n            This is intended to be invoked from a jinja template that has already written out the prompt for\n            control response\n        \"\"\"\n        if not self._resolved_catalog:\n            raise TrestleError('Cannot get control response, set resolved catalog first.')\n\n        control = self._catalog_interface.get_control(control_id)\n        imp_req = self._control_implemented_req(control_id)\n        if not imp_req:\n            logger.info(f'No implemented requirements found for the control {control_id}')\n            return ''\n\n        md_writer = MDWriter(None)\n\n        system_prose = ''\n        system_rules = []\n        system_status = STATUS_OPERATIONAL\n        imp_req_responses = self._get_responses_by_components(imp_req, write_empty_responses)\n        if SSP_MAIN_COMP_NAME in imp_req_responses:\n            system_prose, system_rules, system_status = imp_req_responses[SSP_MAIN_COMP_NAME]\n\n        SSPMarkdownWriter._write_component_prompt(\n            md_writer, SSP_MAIN_COMP_NAME, system_prose, system_rules, system_status, show_rules, show_status\n        )\n\n        # if a control has no statement sub-parts then get the response bycomps from the imp_req itself\n        # otherwise get them from the statements in the imp_req\n        # an imp_req and a statement are both things that can have bycomps\n        has_bycomps = imp_req.statements if imp_req.statements else [imp_req]\n        for has_bycomp in has_bycomps:\n            statement_id = getattr(has_bycomp, 'statement_id', f'{control_id}_smt')\n            label = statement_id\n            part_name = None\n\n            # look up label for this statement\n            if control.parts:\n                found_label, part = self._catalog_interface.get_statement_label_if_exists(control_id, statement_id)\n                if found_label:\n                    label = found_label\n                    part_name = part.name\n\n            response_per_component = self._get_responses_by_components(has_bycomp, write_empty_responses)\n\n            if response_per_component or write_empty_responses:\n                if part_name and part_name == ITEM:\n                    # print part header only if subitem\n                    header = f'Implementation for part {label}'\n                    md_writer.new_header(1, title=header)\n                for comp_name, comp_response in response_per_component.items():\n                    if comp_name == SSP_MAIN_COMP_NAME:\n                        continue\n                    prose, rules, status = comp_response\n                    if show_comp:\n                        SSPMarkdownWriter._write_component_prompt(\n                            md_writer, comp_name, prose, rules, status, show_rules, show_status\n                        )\n\n        lines = md_writer.get_lines()\n\n        tree = DocsMarkdownNode.build_tree_from_markdown(lines)\n        tree.change_header_level_by(level)\n\n        return tree.content.raw_text\n\n    def _get_responses_by_components(self, has_bycomps: TypeWithByComps,\n                                     write_empty_responses: bool) -&gt; Dict[str, Tuple[str, List[str], str]]:\n        \"\"\"Get response per component, substitute component id with title if possible.\"\"\"\n        response_per_component: Dict[str, Tuple[str, str]] = {}\n        for by_comp in as_list(has_bycomps.by_components):  # type: ignore\n            # look up component title\n            subheader = by_comp.component_uuid\n            prose = ''\n            status = ''\n            rules = []\n            if self._ssp.system_implementation.components:\n                for comp in self._ssp.system_implementation.components:\n                    if comp.uuid == by_comp.component_uuid:\n                        title = comp.title\n                        if title:\n                            subheader = title\n            if by_comp.description:\n                prose = by_comp.description\n            if by_comp.implementation_status:\n                status = by_comp.implementation_status.state\n            rules, _ = ControlInterface.get_rule_list_for_item(by_comp)\n\n            if prose or (not prose and write_empty_responses):\n                if subheader:\n                    response_per_component[subheader] = (prose, rules, status)\n\n        return response_per_component\n\n    def _control_implemented_req(self, control_id: str) -&gt; Optional[ssp.ImplementedRequirement]:\n        \"\"\"Retrieve control implemented requirement by control-id.\"\"\"\n        requirements = self._ssp.control_implementation.implemented_requirements\n        for requirement in requirements:\n            if requirement.control_id == control_id:\n                return requirement\n        logger.debug(f'No implemented requirement found for control {control_id}')\n        return None\n\n    def _write_list_with_header(self, header: str, lines: List[str], level: int) -&gt; str:\n        if lines:\n            md_writer = MDWriter(None)\n            md_writer.new_paragraph()\n            md_writer.new_header(level=1, title=header)\n            md_writer.set_indent_level(-1)\n            md_writer.new_list(lines)\n            md_writer.set_indent_level(-1)\n\n            return self._build_tree_and_adjust(md_writer.get_lines(), level)\n\n        return ''\n\n    def _write_table_with_header(\n        self, header: str, values: List[List[str]], table_header: List[str], level: int\n    ) -&gt; str:\n        if values and values[0]:\n            md_writer = MDWriter(None)\n            md_writer.new_paragraph()\n            md_writer.new_header(level=1, title=header)\n            md_writer.set_indent_level(-1)\n            md_writer.new_table(values, table_header)\n            md_writer.set_indent_level(-1)\n\n            return self._build_tree_and_adjust(md_writer.get_lines(), level)\n        return ''\n\n    def _write_str_with_header(self, header: str, text: str, level: int) -&gt; str:\n        if text:\n            md_writer = MDWriter(None)\n            md_writer.new_paragraph()\n            md_writer.new_header(level=1, title=header)\n            md_writer.set_indent_level(-1)\n            md_writer.new_line(text)\n            md_writer.set_indent_level(-1)\n\n            return self._build_tree_and_adjust(md_writer.get_lines(), level)\n        return ''\n\n    def _build_tree_and_adjust(self, lines: List[str], level: int) -&gt; str:\n        tree = DocsMarkdownNode.build_tree_from_markdown(lines)\n        tree.change_header_level_by(level)\n\n        return tree.content.raw_text\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.__init__","title":"<code>__init__(trestle_root)</code>","text":"<p>Initialize the class.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def __init__(self, trestle_root: pathlib.Path) -&gt; None:\n    \"\"\"Initialize the class.\"\"\"\n    self._trestle_root = trestle_root\n    self._ssp: ssp.SystemSecurityPlan = None\n    self._resolved_catalog: Catalog = None\n    self._catalog_interface: CatalogInterface = None\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.get_control_part","title":"<code>get_control_part(control_id, part_name, level)</code>","text":"<p>Get control part with given name.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def get_control_part(self, control_id: str, part_name: str, level: int) -&gt; str:\n    \"\"\"Get control part with given name.\"\"\"\n    control_part = self._catalog_interface.get_control_part_prose(control_id, part_name)\n\n    md_list = self._write_str_with_header(\n        f'Control Part: {part_name} for control: {control_id}', control_part, level\n    )\n    return self._build_tree_and_adjust(md_list.split('\\n'), level)\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.get_control_response","title":"<code>get_control_response(control_id, level, write_empty_responses=False, show_comp=True, show_rules=False, show_status=True)</code>","text":"<p>Get the full control implemented requirements, broken down based on the available control responses.</p> <p>Parameters:</p> Name Type Description Default <code>control_id</code> <code>str</code> <p>id of the control</p> required <code>level</code> <code>int</code> <p>level of indentation</p> required <code>write_empty_responses</code> <code>bool</code> <p>write response even if empty</p> <code>False</code> <code>show_comp</code> <code>bool</code> <p>show the component name in the response</p> <code>True</code> Notes <p>This is intended to be invoked from a jinja template that has already written out the prompt for control response</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def get_control_response(\n    self,\n    control_id: str,\n    level: int,\n    write_empty_responses: bool = False,\n    show_comp: bool = True,\n    show_rules: bool = False,\n    show_status: bool = True\n) -&gt; str:\n    \"\"\"\n    Get the full control implemented requirements, broken down based on the available control responses.\n\n    Args:\n        control_id: id of the control\n        level: level of indentation\n        write_empty_responses: write response even if empty\n        show_comp: show the component name in the response\n\n    Notes:\n        This is intended to be invoked from a jinja template that has already written out the prompt for\n        control response\n    \"\"\"\n    if not self._resolved_catalog:\n        raise TrestleError('Cannot get control response, set resolved catalog first.')\n\n    control = self._catalog_interface.get_control(control_id)\n    imp_req = self._control_implemented_req(control_id)\n    if not imp_req:\n        logger.info(f'No implemented requirements found for the control {control_id}')\n        return ''\n\n    md_writer = MDWriter(None)\n\n    system_prose = ''\n    system_rules = []\n    system_status = STATUS_OPERATIONAL\n    imp_req_responses = self._get_responses_by_components(imp_req, write_empty_responses)\n    if SSP_MAIN_COMP_NAME in imp_req_responses:\n        system_prose, system_rules, system_status = imp_req_responses[SSP_MAIN_COMP_NAME]\n\n    SSPMarkdownWriter._write_component_prompt(\n        md_writer, SSP_MAIN_COMP_NAME, system_prose, system_rules, system_status, show_rules, show_status\n    )\n\n    # if a control has no statement sub-parts then get the response bycomps from the imp_req itself\n    # otherwise get them from the statements in the imp_req\n    # an imp_req and a statement are both things that can have bycomps\n    has_bycomps = imp_req.statements if imp_req.statements else [imp_req]\n    for has_bycomp in has_bycomps:\n        statement_id = getattr(has_bycomp, 'statement_id', f'{control_id}_smt')\n        label = statement_id\n        part_name = None\n\n        # look up label for this statement\n        if control.parts:\n            found_label, part = self._catalog_interface.get_statement_label_if_exists(control_id, statement_id)\n            if found_label:\n                label = found_label\n                part_name = part.name\n\n        response_per_component = self._get_responses_by_components(has_bycomp, write_empty_responses)\n\n        if response_per_component or write_empty_responses:\n            if part_name and part_name == ITEM:\n                # print part header only if subitem\n                header = f'Implementation for part {label}'\n                md_writer.new_header(1, title=header)\n            for comp_name, comp_response in response_per_component.items():\n                if comp_name == SSP_MAIN_COMP_NAME:\n                    continue\n                prose, rules, status = comp_response\n                if show_comp:\n                    SSPMarkdownWriter._write_component_prompt(\n                        md_writer, comp_name, prose, rules, status, show_rules, show_status\n                    )\n\n    lines = md_writer.get_lines()\n\n    tree = DocsMarkdownNode.build_tree_from_markdown(lines)\n    tree.change_header_level_by(level)\n\n    return tree.content.raw_text\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.get_control_statement","title":"<code>get_control_statement(control_id, level)</code>","text":"<p>Get the control statement for an ssp - to be printed in markdown as a structured list.</p> <p>Parameters:</p> Name Type Description Default <code>control_id</code> <code>str</code> <p>The control_id to use.</p> required <p>Returns:</p> Type Description <code>str</code> <p>A markdown blob as a string.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def get_control_statement(self, control_id: str, level: int) -&gt; str:\n    \"\"\"\n    Get the control statement for an ssp - to be printed in markdown as a structured list.\n\n    Args:\n        control_id: The control_id to use.\n\n    Returns:\n        A markdown blob as a string.\n    \"\"\"\n    if not self._resolved_catalog:\n        raise TrestleError('Cannot get control statement, set resolved catalog first.')\n\n    writer = DocsControlWriter()\n    control = self._catalog_interface.get_control(control_id)\n    if not control:\n        return ''\n\n    control_lines = writer.get_control_statement_ssp(control)\n\n    return self._build_tree_and_adjust(control_lines, level)\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_origination","title":"<code>get_fedramp_control_origination(control_id, level)</code>","text":"<p>Print control origination, as a list of items, only showing those that are applicable for the control.</p> <p>Using a LUT to map between structured data fields, defined by FedRAMP and historical text.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def get_fedramp_control_origination(self, control_id: str, level: int) -&gt; str:\n    \"\"\"\n    Print control origination, as a list of items, only showing those that are applicable for the control.\n\n    Using a LUT to map between structured data fields, defined by FedRAMP and historical text.\n    \"\"\"\n    if not self._ssp:\n        raise TrestleError('Cannot get FedRamp control origination, set SSP first.')\n\n    control_origination = []\n    control_impl_req = self._control_implemented_req(control_id)\n\n    if control_impl_req and control_impl_req.props:\n        for prop in control_impl_req.props:\n            if prop.name == CONTROL_ORIGINATION:\n                control_origination.append(prop.value)\n\n    md_list = self._write_list_with_header('FedRamp Control Origination.', control_origination, level)\n    return md_list\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_control_tables","title":"<code>get_fedramp_control_tables(control_id, level, label_column=False)</code>","text":"<p>Get the fedramp metadata as markdown tables, with optional third label column for params.</p> <p>The fedramp metadata has the following elements: - Responsible roles field - Parameter values table - Implementation status field - Control origination field</p> <p>Returns:</p> Type Description <code>str</code> <p>tables as one coherent markdown blob.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def get_fedramp_control_tables(self, control_id: str, level: int, label_column: bool = False) -&gt; str:\n    \"\"\"Get the fedramp metadata as markdown tables, with optional third label column for params.\n\n    The fedramp metadata has the following elements:\n    - Responsible roles field\n    - Parameter values table\n    - Implementation status field\n    - Control origination field\n\n    Returns:\n        tables as one coherent markdown blob.\n    \"\"\"\n    resp_roles_table = self.get_responsible_roles_table(control_id, level)\n    params_values = self._parameter_table(control_id, level, label_column)\n    impl_status = self.get_fedramp_implementation_status(control_id, level)\n    control_orig = self.get_fedramp_control_origination(control_id, level)\n\n    final_output = ''\n    if resp_roles_table:\n        final_output += resp_roles_table\n    if params_values:\n        final_output += '\\n' + params_values\n    if impl_status:\n        final_output += '\\n' + impl_status\n    if control_orig:\n        final_output += '\\n' + control_orig\n    return final_output\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.get_fedramp_implementation_status","title":"<code>get_fedramp_implementation_status(control_id, level)</code>","text":"<p>Print implementation status as a list of items, only showing those that are applicable for the control.</p> <p>This is unlike the word document FedRAMP which uses checkboxes on standard set of options. Using a LUT to map between structured data fields, defined by FedRAMP and historical text.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def get_fedramp_implementation_status(self, control_id: str, level: int) -&gt; str:\n    \"\"\"\n    Print implementation status as a list of items, only showing those that are applicable for the control.\n\n    This is unlike the word document FedRAMP which uses checkboxes on standard set of options.\n    Using a LUT to map between structured data fields, defined by FedRAMP and historical text.\n    \"\"\"\n    if not self._ssp:\n        raise TrestleError('Cannot get Fedramp implementation status, set SSP first.')\n\n    implementation_statuses: List[str] = []\n    control_impl_req = self._control_implemented_req(control_id)\n    if control_impl_req and control_impl_req.props:\n        for prop in control_impl_req.props:\n            if prop.name == IMPLEMENTATION_STATUS:\n                implementation_statuses.append(prop.value)\n\n    md_list = self._write_list_with_header('FedRamp Implementation Status.', implementation_statuses, level)\n    return md_list\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.get_responsible_roles_table","title":"<code>get_responsible_roles_table(control_id, level)</code>","text":"<p>For each role id - if the role exists in metadata use the title as what gets printed in the roles table.</p> <p>If not (for now) warn and use the role-id as the printed text.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def get_responsible_roles_table(self, control_id: str, level: int) -&gt; str:\n    \"\"\"\n    For each role id - if the role exists in metadata use the title as what gets printed in the roles table.\n\n    If not (for now) warn and use the role-id as the printed text.\n    \"\"\"\n    if self._ssp is None:\n        raise TrestleError('Cannot get responsible roles, SSP is not set.')\n\n    for impl_requirement in self._ssp.control_implementation.implemented_requirements:\n        if impl_requirement.control_id == control_id:\n            if impl_requirement.responsible_roles:\n                resp_roles = as_list(impl_requirement.responsible_roles)\n                role_ids = [role.role_id.replace('_', ' ') for role in resp_roles]\n\n                # now check if this role exists in the metadata\n                role_titles = dict(zip(role_ids, role_ids))\n                roles = as_list(self._ssp.metadata.roles)\n                for role in roles:\n                    if role.id in role_ids:\n                        role_titles[role.id] = role.title\n\n                # dictionary to md table\n                md_list = self._write_table_with_header(\n                    'Responsible Roles.', [[key, role_titles[key]] for key in role_titles.keys()],\n                    ['Role ID', 'Title'],\n                    level\n                )\n                return md_list\n            else:\n                logger.warning(\n                    f'No responsible roles were found for the control with id: {control_id} in given SSP.'\n                )\n                return ''\n\n    return ''\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.set_catalog","title":"<code>set_catalog(resolved_catalog)</code>","text":"<p>Set catalog.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def set_catalog(self, resolved_catalog: Catalog) -&gt; None:\n    \"\"\"Set catalog.\"\"\"\n    self._resolved_catalog = resolved_catalog\n    self._catalog_interface = catalog_interface.CatalogInterface(self._resolved_catalog)\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io.SSPMarkdownWriter.set_ssp","title":"<code>set_ssp(ssp)</code>","text":"<p>Set ssp.</p> Source code in <code>trestle/core/ssp_io.py</code> <pre><code>def set_ssp(self, ssp: ssp.SystemSecurityPlan) -&gt; None:\n    \"\"\"Set ssp.\"\"\"\n    self._ssp = ssp\n</code></pre>"},{"location":"reference/API/trestle/core/ssp_io/#trestle.core.ssp_io-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/trestle_base_model/","title":"trestle.core.trestle_base_model","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/trestle_base_model/#trestle.core.trestle_base_model","title":"<code>trestle.core.trestle_base_model</code>","text":"<p>Trestle Base Model.</p>"},{"location":"reference/API/trestle/core/trestle_base_model/#trestle.core.trestle_base_model-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/trestle_base_model/#trestle.core.trestle_base_model.Model","title":"<code>Model = TypeVar('Model', bound='BaseModel')</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/trestle_base_model/#trestle.core.trestle_base_model-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel","title":"<code>TrestleBaseModel</code>","text":"<p>               Bases: <code>BaseModel</code></p> <p>Trestle Base Model. Serves as wrapper around BaseModel for overriding methods.</p> Source code in <code>trestle/core/trestle_base_model.py</code> <pre><code>class TrestleBaseModel(BaseModel):\n    \"\"\"Trestle Base Model. Serves as wrapper around BaseModel for overriding methods.\"\"\"\n\n    @classmethod\n    def parse_obj(cls: Type['Model'], obj: Any) -&gt; 'Model':\n        \"\"\"Parse object to the given class.\"\"\"\n        try:\n            return super().parse_obj(obj)\n        except ValidationError as e:\n            # check if failed due to the wrong OSCAL version:\n            oscal_version_error = False\n            for err in e.errors():\n                for field in err['loc']:\n                    if field == 'oscal-version':\n                        message = err['msg']\n                        oscal_version_error = True\n                        break\n            if oscal_version_error:\n                raise TrestleError(f'{message}')\n            else:\n                raise\n</code></pre>"},{"location":"reference/API/trestle/core/trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/trestle_base_model/#trestle.core.trestle_base_model.TrestleBaseModel.parse_obj","title":"<code>parse_obj(obj)</code>  <code>classmethod</code>","text":"<p>Parse object to the given class.</p> Source code in <code>trestle/core/trestle_base_model.py</code> <pre><code>@classmethod\ndef parse_obj(cls: Type['Model'], obj: Any) -&gt; 'Model':\n    \"\"\"Parse object to the given class.\"\"\"\n    try:\n        return super().parse_obj(obj)\n    except ValidationError as e:\n        # check if failed due to the wrong OSCAL version:\n        oscal_version_error = False\n        for err in e.errors():\n            for field in err['loc']:\n                if field == 'oscal-version':\n                    message = err['msg']\n                    oscal_version_error = True\n                    break\n        if oscal_version_error:\n            raise TrestleError(f'{message}')\n        else:\n            raise\n</code></pre>"},{"location":"reference/API/trestle/core/validator/","title":"trestle.core.validator","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/validator/#trestle.core.validator","title":"<code>trestle.core.validator</code>","text":"<p>Base class for all validators.</p>"},{"location":"reference/API/trestle/core/validator/#trestle.core.validator-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/validator/#trestle.core.validator.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/validator/#trestle.core.validator-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/validator/#trestle.core.validator.Validator","title":"<code>Validator</code>","text":"<p>               Bases: <code>ABC</code></p> <p>Validator base class.</p> Source code in <code>trestle/core/validator.py</code> <pre><code>class Validator(ABC):\n    \"\"\"Validator base class.\"\"\"\n\n    def error_msg(self) -&gt; Optional[str]:\n        \"\"\"Error message used to describe this validator.\"\"\"\n        # subclasses can override as needed\n        return self.__doc__\n\n    @abstractmethod\n    def model_is_valid(\n        self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n    ) -&gt; bool:\n        \"\"\"\n        Validate the model.\n\n        args:\n            model: An Oscal model that can be passed to the validator.\n            quiet: Don't report msgs unless invalid.\n\n        returns:\n            Whether or not the model passed this validation test.\n        \"\"\"\n\n    def validate(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"Perform the validation according to user options.\"\"\"\n        trestle_root = args.trestle_root  # trestle root is set via command line in args. Default is cwd.\n\n        # validate by type - all of type or just specified by name\n        if args.type:\n            models = []\n            if args.name:\n                models = [args.name]\n            else:\n                models = ModelUtils.get_models_of_type(args.type, trestle_root)\n            models_path = trestle_root / ModelUtils.model_type_to_model_dir(args.type)\n            for m in models:\n                model_path = models_path / m\n                try:\n                    _, _, model = ModelUtils.load_distributed(model_path, trestle_root)\n                except TrestleError as e:\n                    logger.warning(f'File load error {e}')\n                    return CmdReturnCodes.OSCAL_VALIDATION_ERROR.value\n                if not self.model_is_valid(model, args.quiet, trestle_root):  # type: ignore\n                    logger.info(f'INVALID: Model {model_path} did not pass the {self.error_msg()}')\n                    return CmdReturnCodes.OSCAL_VALIDATION_ERROR.value\n                if not args.quiet:\n                    logger.info(f'VALID: Model {model_path} passed the {self.error_msg()}')\n            return CmdReturnCodes.SUCCESS.value\n\n        # validate all\n        if args.all:\n            model_tups = ModelUtils.get_all_models(trestle_root)\n            for mt in model_tups:\n\n                model_dir = trestle_root / ModelUtils.model_type_to_model_dir(mt[0]) / mt[1]\n                extension_type = trestle.common.file_utils.get_contextual_file_type(model_dir)\n                model_path = model_dir / f'{mt[0]}{FileContentType.to_file_extension(extension_type)}'\n                _, _, model = ModelUtils.load_distributed(model_path, trestle_root)\n                if not self.model_is_valid(model, args.quiet, trestle_root):  # type: ignore\n                    logger.info(f'INVALID: Model {model_path} did not pass the {self.error_msg()}')\n                    return CmdReturnCodes.OSCAL_VALIDATION_ERROR.value\n                if not args.quiet:\n                    logger.info(f'VALID: Model {model_path} passed the {self.error_msg()}')\n            return CmdReturnCodes.SUCCESS.value\n\n        # validate file\n        if args.file:\n            file_path = trestle_root / args.file\n            _, _, model = ModelUtils.load_distributed(file_path, trestle_root)\n            if not self.model_is_valid(model, args.quiet, trestle_root):  # type: ignore\n                logger.info(f'INVALID: Model {file_path} did not pass the {self.error_msg()}')\n                return CmdReturnCodes.OSCAL_VALIDATION_ERROR.value\n            if not args.quiet:\n                logger.info(f'VALID: Model {file_path} passed the {self.error_msg()}')\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/validator/#trestle.core.validator.Validator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/validator/#trestle.core.validator.Validator.error_msg","title":"<code>error_msg()</code>","text":"<p>Error message used to describe this validator.</p> Source code in <code>trestle/core/validator.py</code> <pre><code>def error_msg(self) -&gt; Optional[str]:\n    \"\"\"Error message used to describe this validator.\"\"\"\n    # subclasses can override as needed\n    return self.__doc__\n</code></pre>"},{"location":"reference/API/trestle/core/validator/#trestle.core.validator.Validator.model_is_valid","title":"<code>model_is_valid(model, quiet, trestle_root=None)</code>  <code>abstractmethod</code>","text":"<p>Validate the model.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>TopLevelOscalModel</code> <p>An Oscal model that can be passed to the validator.</p> required <code>quiet</code> <code>bool</code> <p>Don't report msgs unless invalid.</p> required <p>Returns:</p> Type Description <code>bool</code> <p>Whether or not the model passed this validation test.</p> Source code in <code>trestle/core/validator.py</code> <pre><code>@abstractmethod\ndef model_is_valid(\n    self, model: TopLevelOscalModel, quiet: bool, trestle_root: Optional[pathlib.Path] = None\n) -&gt; bool:\n    \"\"\"\n    Validate the model.\n\n    args:\n        model: An Oscal model that can be passed to the validator.\n        quiet: Don't report msgs unless invalid.\n\n    returns:\n        Whether or not the model passed this validation test.\n    \"\"\"\n</code></pre>"},{"location":"reference/API/trestle/core/validator/#trestle.core.validator.Validator.validate","title":"<code>validate(args)</code>","text":"<p>Perform the validation according to user options.</p> Source code in <code>trestle/core/validator.py</code> <pre><code>def validate(self, args: argparse.Namespace) -&gt; int:\n    \"\"\"Perform the validation according to user options.\"\"\"\n    trestle_root = args.trestle_root  # trestle root is set via command line in args. Default is cwd.\n\n    # validate by type - all of type or just specified by name\n    if args.type:\n        models = []\n        if args.name:\n            models = [args.name]\n        else:\n            models = ModelUtils.get_models_of_type(args.type, trestle_root)\n        models_path = trestle_root / ModelUtils.model_type_to_model_dir(args.type)\n        for m in models:\n            model_path = models_path / m\n            try:\n                _, _, model = ModelUtils.load_distributed(model_path, trestle_root)\n            except TrestleError as e:\n                logger.warning(f'File load error {e}')\n                return CmdReturnCodes.OSCAL_VALIDATION_ERROR.value\n            if not self.model_is_valid(model, args.quiet, trestle_root):  # type: ignore\n                logger.info(f'INVALID: Model {model_path} did not pass the {self.error_msg()}')\n                return CmdReturnCodes.OSCAL_VALIDATION_ERROR.value\n            if not args.quiet:\n                logger.info(f'VALID: Model {model_path} passed the {self.error_msg()}')\n        return CmdReturnCodes.SUCCESS.value\n\n    # validate all\n    if args.all:\n        model_tups = ModelUtils.get_all_models(trestle_root)\n        for mt in model_tups:\n\n            model_dir = trestle_root / ModelUtils.model_type_to_model_dir(mt[0]) / mt[1]\n            extension_type = trestle.common.file_utils.get_contextual_file_type(model_dir)\n            model_path = model_dir / f'{mt[0]}{FileContentType.to_file_extension(extension_type)}'\n            _, _, model = ModelUtils.load_distributed(model_path, trestle_root)\n            if not self.model_is_valid(model, args.quiet, trestle_root):  # type: ignore\n                logger.info(f'INVALID: Model {model_path} did not pass the {self.error_msg()}')\n                return CmdReturnCodes.OSCAL_VALIDATION_ERROR.value\n            if not args.quiet:\n                logger.info(f'VALID: Model {model_path} passed the {self.error_msg()}')\n        return CmdReturnCodes.SUCCESS.value\n\n    # validate file\n    if args.file:\n        file_path = trestle_root / args.file\n        _, _, model = ModelUtils.load_distributed(file_path, trestle_root)\n        if not self.model_is_valid(model, args.quiet, trestle_root):  # type: ignore\n            logger.info(f'INVALID: Model {file_path} did not pass the {self.error_msg()}')\n            return CmdReturnCodes.OSCAL_VALIDATION_ERROR.value\n        if not args.quiet:\n            logger.info(f'VALID: Model {file_path} passed the {self.error_msg()}')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/validator_factory/","title":"trestle.core.validator_factory","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/validator_factory/#trestle.core.validator_factory","title":"<code>trestle.core.validator_factory</code>","text":"<p>Register all validators here in the validator_factory.</p>"},{"location":"reference/API/trestle/core/validator_factory/#trestle.core.validator_factory-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/validator_factory/#trestle.core.validator_factory.validator_factory","title":"<code>validator_factory: ObjectFactory = ObjectFactory()</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/validator_factory/#trestle.core.validator_factory-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/validator_factory/#trestle.core.validator_factory-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/validator_factory/#trestle.core.validator_factory.init_arguments","title":"<code>init_arguments(cmd)</code>","text":"<p>Feed the arguments to the argument parser.</p> Source code in <code>trestle/core/validator_factory.py</code> <pre><code>def init_arguments(cmd: Command) -&gt; None:\n    \"\"\"Feed the arguments to the argument parser.\"\"\"\n    group = cmd.parser.add_mutually_exclusive_group(required=True)\n    group.add_argument('-f', '--file', help='Path of file in trestle directory to validate.')\n    group.add_argument('-t', '--type', choices=const.MODEL_TYPE_LIST, help='Validate one or all models of this type.')\n    group.add_argument('-a', '--all', action='store_true', help='Validate all models in trestle directory.')\n    cmd.add_argument('-n', '--name', help='Name of single model to validate (with --type specified).', required=False)\n    quiet_help = 'Do not report messages unless validation fails.'\n    cmd.add_argument('-q', '--quiet', action='store_true', help=quiet_help, required=False)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_api/","title":"trestle.core.catalog.catalog_api","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api","title":"<code>trestle.core.catalog.catalog_api</code>","text":"<p>Main entrypoint to interact with catalog in memory.</p>"},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI","title":"<code>CatalogAPI</code>","text":"<p>Main entrypoint to interact with catalog in memory.</p> <p>Encapsulates all necessary functionality to manipulate, read and write the catalog and its markdown representation.</p> Source code in <code>trestle/core/catalog/catalog_api.py</code> <pre><code>class CatalogAPI():\n    \"\"\"\n    Main entrypoint to interact with catalog in memory.\n\n    Encapsulates all necessary functionality to manipulate, read\n    and write the catalog and its markdown representation.\n    \"\"\"\n\n    def __init__(self, catalog: Optional[cat.Catalog], context: Optional[ControlContext] = None):\n        \"\"\"Initialize catalog api.\"\"\"\n        if not catalog:\n            # catalog assemble initializes with no catalog but may merge into an existing one later\n            logger.debug('No catalog was provided in CatalogAPI init, generating a new one.')\n            catalog = gens.generate_sample_model(cat.Catalog)\n        self._catalog = catalog\n        self._catalog_interface = CatalogInterface(self._catalog)\n        self._writer = CatalogWriter(self._catalog_interface)\n        self._reader = CatalogReader(self._catalog_interface)\n        self._merger = CatalogMerger(self._catalog_interface)\n        self._context = context\n\n    def update_context(self, context: ControlContext) -&gt; None:\n        \"\"\"Update current context.\"\"\"\n        if not context:\n            raise TrestleError('ControlContext cannot be empty.')\n        self._context = context\n\n    def write_catalog_as_markdown(self, label_as_key: bool = False) -&gt; None:\n        \"\"\"\n        Write out the catalog controls from dict as markdown files to the specified directory.\n\n        Args:\n            label_as_key: Whether to use label_as_key for part_id to label map\n\n        Returns:\n            None\n        \"\"\"\n        # create the directory in which to write the control markdown files\n        self._context.md_root.mkdir(exist_ok=True, parents=True)\n\n        part_id_map = self._catalog_interface.get_statement_part_id_map(label_as_key=label_as_key)\n\n        if self._context.purpose == ContextPurpose.PROFILE:\n            found_alters, _, _ = self.read_additional_content_from_md(label_as_key=True)\n            self._writer.write_catalog_as_profile_markdown(self._context, part_id_map, found_alters)\n        elif self._context.purpose == ContextPurpose.COMPONENT:\n            self._writer.write_catalog_as_component_markdown(self._context, part_id_map)\n        elif self._context.purpose == ContextPurpose.SSP:\n            self._writer.write_catalog_as_ssp_markdown(self._context, part_id_map)\n        else:\n            self._writer.write_catalog_as_catalog(self._context, part_id_map)\n\n        # prune any directories that have no markdown files\n        prune_empty_dirs(self._context.md_root, '*.md')\n\n    def read_catalog_from_markdown(self, markdown_dir: pathlib.Path, is_set_parameters: bool) -&gt; cat.Catalog:\n        \"\"\"Read catalog from markdown.\"\"\"\n        md_catalog = self._reader.read_catalog_from_markdown(markdown_dir, is_set_parameters)\n        md_catalog_interface = CatalogInterface(md_catalog)\n        if md_catalog_interface.get_count_of_controls_in_catalog(True) == 0:\n            raise TrestleError(f'No controls were loaded from markdown {markdown_dir}.  No catalog created.')\n\n        return md_catalog\n\n    def read_additional_content_from_md(self,\n                                        label_as_key: bool = False\n                                        ) -&gt; Tuple[List[prof.Alter], Dict[str, Any], Dict[str, str]]:\n        \"\"\"Read additional content from markdown.\"\"\"\n        if not self._context:\n            raise TrestleError('Reading content from the markdown requires context to be initialized!')\n        label_map = self._catalog_interface.get_statement_part_id_map(label_as_key=label_as_key)\n\n        return self._reader.read_additional_content(\n            self._context.md_root,\n            self._context.required_sections,\n            label_map,\n            self._context.sections_dict,\n            self._context.to_markdown\n        )\n\n    def merge_catalog(self, catalog: cat.Catalog, replace_params: bool) -&gt; None:\n        \"\"\"Merge one catalog into another.\"\"\"\n        return self._merger.merge_catalog(catalog, replace_params)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI.__init__","title":"<code>__init__(catalog, context=None)</code>","text":"<p>Initialize catalog api.</p> Source code in <code>trestle/core/catalog/catalog_api.py</code> <pre><code>def __init__(self, catalog: Optional[cat.Catalog], context: Optional[ControlContext] = None):\n    \"\"\"Initialize catalog api.\"\"\"\n    if not catalog:\n        # catalog assemble initializes with no catalog but may merge into an existing one later\n        logger.debug('No catalog was provided in CatalogAPI init, generating a new one.')\n        catalog = gens.generate_sample_model(cat.Catalog)\n    self._catalog = catalog\n    self._catalog_interface = CatalogInterface(self._catalog)\n    self._writer = CatalogWriter(self._catalog_interface)\n    self._reader = CatalogReader(self._catalog_interface)\n    self._merger = CatalogMerger(self._catalog_interface)\n    self._context = context\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI.merge_catalog","title":"<code>merge_catalog(catalog, replace_params)</code>","text":"<p>Merge one catalog into another.</p> Source code in <code>trestle/core/catalog/catalog_api.py</code> <pre><code>def merge_catalog(self, catalog: cat.Catalog, replace_params: bool) -&gt; None:\n    \"\"\"Merge one catalog into another.\"\"\"\n    return self._merger.merge_catalog(catalog, replace_params)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI.read_additional_content_from_md","title":"<code>read_additional_content_from_md(label_as_key=False)</code>","text":"<p>Read additional content from markdown.</p> Source code in <code>trestle/core/catalog/catalog_api.py</code> <pre><code>def read_additional_content_from_md(self,\n                                    label_as_key: bool = False\n                                    ) -&gt; Tuple[List[prof.Alter], Dict[str, Any], Dict[str, str]]:\n    \"\"\"Read additional content from markdown.\"\"\"\n    if not self._context:\n        raise TrestleError('Reading content from the markdown requires context to be initialized!')\n    label_map = self._catalog_interface.get_statement_part_id_map(label_as_key=label_as_key)\n\n    return self._reader.read_additional_content(\n        self._context.md_root,\n        self._context.required_sections,\n        label_map,\n        self._context.sections_dict,\n        self._context.to_markdown\n    )\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI.read_catalog_from_markdown","title":"<code>read_catalog_from_markdown(markdown_dir, is_set_parameters)</code>","text":"<p>Read catalog from markdown.</p> Source code in <code>trestle/core/catalog/catalog_api.py</code> <pre><code>def read_catalog_from_markdown(self, markdown_dir: pathlib.Path, is_set_parameters: bool) -&gt; cat.Catalog:\n    \"\"\"Read catalog from markdown.\"\"\"\n    md_catalog = self._reader.read_catalog_from_markdown(markdown_dir, is_set_parameters)\n    md_catalog_interface = CatalogInterface(md_catalog)\n    if md_catalog_interface.get_count_of_controls_in_catalog(True) == 0:\n        raise TrestleError(f'No controls were loaded from markdown {markdown_dir}.  No catalog created.')\n\n    return md_catalog\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI.update_context","title":"<code>update_context(context)</code>","text":"<p>Update current context.</p> Source code in <code>trestle/core/catalog/catalog_api.py</code> <pre><code>def update_context(self, context: ControlContext) -&gt; None:\n    \"\"\"Update current context.\"\"\"\n    if not context:\n        raise TrestleError('ControlContext cannot be empty.')\n    self._context = context\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api.CatalogAPI.write_catalog_as_markdown","title":"<code>write_catalog_as_markdown(label_as_key=False)</code>","text":"<p>Write out the catalog controls from dict as markdown files to the specified directory.</p> <p>Parameters:</p> Name Type Description Default <code>label_as_key</code> <code>bool</code> <p>Whether to use label_as_key for part_id to label map</p> <code>False</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> Source code in <code>trestle/core/catalog/catalog_api.py</code> <pre><code>def write_catalog_as_markdown(self, label_as_key: bool = False) -&gt; None:\n    \"\"\"\n    Write out the catalog controls from dict as markdown files to the specified directory.\n\n    Args:\n        label_as_key: Whether to use label_as_key for part_id to label map\n\n    Returns:\n        None\n    \"\"\"\n    # create the directory in which to write the control markdown files\n    self._context.md_root.mkdir(exist_ok=True, parents=True)\n\n    part_id_map = self._catalog_interface.get_statement_part_id_map(label_as_key=label_as_key)\n\n    if self._context.purpose == ContextPurpose.PROFILE:\n        found_alters, _, _ = self.read_additional_content_from_md(label_as_key=True)\n        self._writer.write_catalog_as_profile_markdown(self._context, part_id_map, found_alters)\n    elif self._context.purpose == ContextPurpose.COMPONENT:\n        self._writer.write_catalog_as_component_markdown(self._context, part_id_map)\n    elif self._context.purpose == ContextPurpose.SSP:\n        self._writer.write_catalog_as_ssp_markdown(self._context, part_id_map)\n    else:\n        self._writer.write_catalog_as_catalog(self._context, part_id_map)\n\n    # prune any directories that have no markdown files\n    prune_empty_dirs(self._context.md_root, '*.md')\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_api/#trestle.core.catalog.catalog_api-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog/catalog_interface/","title":"trestle.core.catalog.catalog_interface","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface","title":"<code>trestle.core.catalog.catalog_interface</code>","text":"<p>Provide interface to catalog allowing queries and operations at control level.</p>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface","title":"<code>CatalogInterface</code>","text":"<p>Interface to query and modify catalog contents.</p> <p>The catalog is contained in two separate forms:  As an actual OSCAL catalog, and as a separate dict providing direct lookup of a control by id.</p> <p>The two representations should be converted as needed using provided routines: dict -&gt; cat: update_catalog_controls cat -&gt; dict: _create_control_dict</p> <p>In normal use the dict is created by the CatalogInterface constructor, changes are then made to controls in the dict, then the catalog controls are updated by pulling from the dict back into the catalog.</p> <p>This class does no direct file i/o.  i/o is performed via ControlIO.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>class CatalogInterface():\n    \"\"\"\n    Interface to query and modify catalog contents.\n\n    The catalog is contained in two separate forms:  As an actual OSCAL catalog,\n    and as a separate dict providing direct lookup of a control by id.\n\n    The two representations should be converted as needed using provided routines:\n    dict -&gt; cat: update_catalog_controls\n    cat -&gt; dict: _create_control_dict\n\n    In normal use the dict is created by the CatalogInterface constructor,\n    changes are then made to controls in the dict,\n    then the catalog controls are updated by pulling from the dict back into the catalog.\n\n    This class does no direct file i/o.  i/o is performed via ControlIO.\n    \"\"\"\n\n    @dataclass\n    class ControlHandle:\n        \"\"\"Convenience class for handling controls as members of a group.\n\n        group_id: id of parent group or '' if not in a group\n        group_title: title of the group\n        group_class: class of the group\n        path: path of parent groups leading to this control - without the final control_id, or [''] if in cat list\n        important to remember that controls may not be in a group and are directly attached to cat\n        control: the control itself\n        \"\"\"\n\n        group_id: str\n        group_title: Optional[str]\n        group_class: Optional[str]\n        group_path: List[str]\n        control_path: List[str]\n        control: cat.Control\n\n    def __init__(self, catalog: Optional[cat.Catalog] = None) -&gt; None:\n        \"\"\"Initialize the interface with the catalog.\"\"\"\n        self._catalog = catalog\n        self._param_control_map: Dict[str, str] = {}\n        self._generate_group_index: int = 0\n        self._control_dict = self._create_control_dict() if catalog else None\n        self.loose_param_dict: Dict[str, common.Parameter] = {param.id: param\n                                                              for param in as_list(catalog.params)} if catalog else {}\n        # map control id to CompDict\n        self._control_comp_dicts: Dict[str, CompDict] = {}\n        # map control id to dict containing set parameters by component\n        self._control_comp_set_params: Dict[str, Dict[str, comp.SetParameter]] = {}\n\n    def add_comp_info(self, control_id: str, comp_name: str, label: str, comp_info: ComponentImpInfo) -&gt; None:\n        \"\"\"Add comp_info for a control.\"\"\"\n        deep_set(self._control_comp_dicts, [control_id, comp_name, label], comp_info)\n\n    def get_comp_info(self, control_id: str) -&gt; CompDict:\n        \"\"\"Get comp_dict for this control.\"\"\"\n        return self._control_comp_dicts.get(control_id, {})\n\n    def clear_comp_dicts(self) -&gt; None:\n        \"\"\"Clear the control component dicts.\"\"\"\n        self._control_comp_dicts = {}\n\n    def add_comp_set_param(self, control_id: str, comp_name: str, set_param: comp.SetParameter) -&gt; None:\n        \"\"\"Add component setparam for control with overwrite.\"\"\"\n        deep_append(self._control_comp_set_params, [control_id, comp_name], set_param)\n\n    def get_control_comp_set_params(self, control_id: str) -&gt; Dict[str, List[comp.SetParameter]]:\n        \"\"\"Get dict of setparams list per component.\"\"\"\n        return self._control_comp_set_params.get(control_id, {})\n\n    def clear_set_params(self) -&gt; None:\n        \"\"\"Clear the control set params.\"\"\"\n        self._control_comp_set_params = {}\n\n    def _generate_group_id(self, group: cat.Group) -&gt; str:\n        \"\"\"Generate sequential group ids.\"\"\"\n        group_id = f'trestle_group_{self._generate_group_index:04d}'\n        self._generate_group_index += 1\n        logger.warning(f'Group titled \"{group.title}\" has no id and has been assigned id: {group_id}')\n        return group_id\n\n    def _add_params_to_map(self, control: cat.Control) -&gt; None:\n        # this does not need to recurse because it is called for each control in the catalog\n        for param in as_list(control.params):\n            if param.id in self._param_control_map:\n                logger.warning(\n                    f'Duplicate param id {param.id} in control {control.id} and {self._param_control_map[param.id]}.'\n                )\n            self._param_control_map[param.id] = control.id\n\n    def _add_sub_controls(\n        self, control_handle: ControlHandle, control_dict: Dict[str, ControlHandle], path: List[str]\n    ) -&gt; None:\n        \"\"\"\n        Get all controls contained in this control and add it to the growing control dict.\n\n        Add all its sub-controls to the dict recursively.\n        The path does not change because only groups are in the path, and controls cannot contain groups.\n        \"\"\"\n        if control_handle.control.controls:\n            group_id = control_handle.group_id\n            group_title = control_handle.group_title\n            group_class = control_handle.group_class\n            group_path = control_handle.group_path\n            control_path = path[:]\n            control_path.append(control_handle.control.id)\n            for sub_control in control_handle.control.controls:\n                control_handle = CatalogInterface.ControlHandle(\n                    group_id=group_id,\n                    group_title=group_title,\n                    group_class=group_class,\n                    group_path=group_path,\n                    control_path=control_path,\n                    control=sub_control\n                )\n                control_dict[sub_control.id] = control_handle\n                self._add_sub_controls(control_handle, control_dict, control_path)\n\n    def _add_group_controls(self, group: cat.Group, control_dict: Dict[str, ControlHandle], path: List[str]) -&gt; None:\n        \"\"\"Add all controls in the group recursively, including sub groups and sub controls.\"\"\"\n        group.id = self._generate_group_id(group) if group.id is None else group.id\n        if group.controls is not None:\n            group_path = path[:]\n            if not group_path or group_path[-1] != group.id:\n                group_path.append(group.id)\n            for control in group.controls:\n                control_handle = CatalogInterface.ControlHandle(\n                    group_id=group.id,\n                    group_title=group.title,\n                    group_class=group.class_,\n                    control=control,\n                    group_path=group_path,\n                    control_path=group_path\n                )\n                control_dict[control.id] = control_handle\n                self._add_sub_controls(control_handle, control_dict, group_path)\n        if group.groups is not None:\n            group_path = path[:]\n            group_path.append(group.id)\n            for sub_group in group.groups:\n                new_path = group_path[:]\n                sub_group.id = self._generate_group_id(sub_group) if sub_group.id is None else sub_group.id\n                new_path.append(sub_group.id)\n                self._add_group_controls(sub_group, control_dict, new_path)\n\n    def _create_control_dict(self) -&gt; Dict[str, ControlHandle]:\n        control_dict: Dict[str, CatalogInterface.ControlHandle] = {}\n        # add controls by group\n        if self._catalog.groups is not None:\n            for group in self._catalog.groups:\n                self._add_group_controls(group, control_dict, [])\n        # now add controls not in a group, if any\n        if self._catalog.controls is not None:\n            group_path = ['']\n            for control in self._catalog.controls:\n                control_handle = CatalogInterface.ControlHandle(\n                    group_id='',\n                    group_title='',\n                    group_class=const.MODEL_TYPE_CATALOG,\n                    control=control,\n                    group_path=group_path,\n                    control_path=group_path\n                )\n                control_dict[control.id] = control_handle\n                self._add_sub_controls(control_handle, control_dict, group_path)\n        for handle in control_dict.values():\n            self._add_params_to_map(handle.control)\n        return control_dict\n\n    @staticmethod\n    def _get_all_controls_in_list(controls: List[cat.Control], recurse: bool) -&gt; List[cat.Control]:\n        \"\"\"Get all controls in a list with optional recursion for sub controls.\"\"\"\n        new_list: List[cat.Control] = []\n        for control in controls:\n            new_list.append(control)\n            if recurse and control.controls:\n                new_list.extend(CatalogInterface._get_all_controls_in_list(control.controls, recurse))\n        return new_list\n\n    @staticmethod\n    def _get_all_controls_in_group(group: cat.Group, recurse: bool) -&gt; List[cat.Control]:\n        \"\"\"\n        Create a list of all controls in this group.\n\n        recurse specifies to recurse within controls, but groups are always recursed\n        \"\"\"\n        controls: List[cat.Control] = []\n        if group.controls:\n            controls.extend(CatalogInterface._get_all_controls_in_list(group.controls, recurse))\n        for sub_group in as_list(group.groups):\n            controls.extend(CatalogInterface._get_all_controls_in_group(sub_group, recurse))\n        return controls\n\n    def get_sorted_controls_in_group(self, group_id: str) -&gt; List[cat.Control]:\n        \"\"\"Get the list of controls in a group sorted by the control sort-id.\"\"\"\n        controls: List[cat.Control] = []\n        for control in self.get_all_controls_from_dict():\n            grp_id, _, _ = self.get_group_info_by_control(control.id)\n            if grp_id == group_id:\n                controls.append(control)\n        return sorted(controls, key=lambda control: ControlInterface.get_sort_id(control))\n\n    def get_dependent_control_ids(self, control_id: str) -&gt; List[str]:\n        \"\"\"Find all child ids of this control from the dict with recursion.\"\"\"\n        children: List[str] = []\n        control = self.get_control(control_id)\n        if control:\n            new_controls = self._get_all_controls_in_list(as_list(control.controls), True)\n            children.extend([con.id for con in new_controls])\n        return children\n\n    def get_control_ids(self) -&gt; List[str]:\n        \"\"\"Get all control ids from the control dict.\"\"\"\n        return self._control_dict.keys()\n\n    def get_control(self, control_id: str) -&gt; Optional[cat.Control]:\n        \"\"\"Get control from the control dict with this id.\"\"\"\n        return None if control_id not in self._control_dict else self._control_dict[control_id].control\n\n    @staticmethod\n    def get_control_ids_from_catalog(catalog: cat.Catalog) -&gt; List[str]:\n        \"\"\"\n        Get all control ids from a catalog.\n\n        This is intended to provide a quick list of all controls in a catalog without the expense of building the\n        control dict.  So, if repeated queries are made into a catalog, it is worth instantiating a CatalogInterface\n        and associated control dict.  Otherwise just use this to get a list of all controls.\n\n        This function is needed within the CatalogInterface in order to determine if new controls have been added\n        to the dict and need to be inserted in the actual catalog during update.\n        \"\"\"\n        controls = CatalogInterface._get_all_controls_in_list(as_list(catalog.controls), True)\n        id_list = [control.id for control in controls]\n        for group in as_list(catalog.groups):\n            controls = CatalogInterface._get_all_controls_in_group(group, True)\n            id_list.extend([control.id for control in as_list(controls)])\n        return id_list\n\n    def get_control_by_param_id(self, param_id: str) -&gt; Optional[cat.Control]:\n        \"\"\"Get control from catalog that has this param id using the dict.\"\"\"\n        if param_id in self._param_control_map:\n            return self.get_control(self._param_control_map[param_id])\n        return None\n\n    def get_control_id_and_status(self, control_name: str) -&gt; Tuple[str, str]:\n        \"\"\"\n        Get the control id and status using the control name.\n\n        Returns empty string if status not found.\n        \"\"\"\n        for control in self.get_all_controls_from_dict():\n            if ControlInterface.get_label(control).strip().lower() == control_name.strip().lower():\n                status = ControlInterface.get_prop(control, 'status')\n                return control.id, status\n        return '', ''\n\n    def get_catalog_title(self) -&gt; str:\n        \"\"\"Get the title of the catalog.\"\"\"\n        return self._catalog.metadata.title\n\n    def get_statement_part_id_map(self, label_as_key: bool) -&gt; Dict[str, Dict[str, str]]:\n        \"\"\"Create mapping of label to part_id for top level parts in statement of all controls.\"\"\"\n        id_map = {}\n        for control in self.get_all_controls_from_catalog(True):\n            statement_part = get_item_from_list(control.parts, const.STATEMENT, lambda p: p.name)\n            if not statement_part:\n                continue\n            id_dict: Dict[str, str] = {}\n            for sub_part in as_list(statement_part.parts):\n                label = ControlInterface.get_label(sub_part)\n                # skip add to map for empty label\n                if not label:\n                    continue\n                if label_as_key:\n                    id_dict[label] = sub_part.id\n                else:\n                    id_dict[sub_part.id] = label\n            if id_dict:\n                id_map[control.id] = id_dict\n        return id_map\n\n    @staticmethod\n    def _get_statement_sub_parts(part: common.Part, indent: int) -&gt; List[Dict[str, str]]:\n        items = []\n        # this may be '' if no label\n        label = ControlInterface.get_label(part)\n        prose = '' if part.prose is None else part.prose\n        items.append({'indent': indent, 'label': label, 'prose': prose})\n        for prt in as_filtered_list(part.parts, lambda p: p.name == const.ITEM):\n            items.extend(CatalogInterface._get_statement_sub_parts(prt, indent + 1))\n        return items\n\n    def get_statement_parts(self, control_id: str) -&gt; List[Dict[str, str]]:\n        \"\"\"Get list of statement parts as dicts with indentation, label and prose.\"\"\"\n        items = []\n        control = self.get_control(control_id)\n\n        # control may have no statement or parts\n        # but if statement present it is first part\n        if control is None:\n            logger.warning(f'No control found for id {control_id}')\n        elif control.parts:\n            part = control.parts[0]\n            if part.name == 'statement':\n                items.extend(CatalogInterface._get_statement_sub_parts(part, 0))\n            else:\n                logger.warning(f'Control {control_id} has parts but first part name is {part.name} - not statement')\n        return items\n\n    def get_control_part_prose(self, control_id: str, part_name: str) -&gt; str:\n        \"\"\"\n        Get the prose for a named part in the control.\n\n        Args:\n            control_id: id of the control\n            part_name: name of the part\n\n        Returns:\n            Single string concatenating prose from all parts and sub-parts in control with that name.\n        \"\"\"\n        control = self.get_control(control_id)\n        return ControlInterface.get_part_prose(control, part_name)\n\n    def get_all_controls_from_catalog(self, recurse: bool) -&gt; Iterator[cat.Control]:\n        \"\"\"\n        Yield all controls from the actual catalog by group including optional sub controls.\n\n        Args:\n            recurse: Whether to recurse within controls, but groups are always recursed\n\n        Returns:\n            iterator of the controls in the catalog\n\n        Notes:\n            This follows the actual structure of the catalog and groups\n        \"\"\"\n        if self._catalog.groups:\n            for group in self._catalog.groups:\n                controls = self._get_all_controls_in_group(group, recurse)\n                for control in controls:\n                    yield control\n        if self._catalog.controls:\n            cat_controls = self._get_all_controls_in_list(self._catalog.controls, recurse)\n            for control in cat_controls:\n                yield control\n\n    def get_all_controls_from_dict(self) -&gt; List[cat.Control]:\n        \"\"\"Yield individual controls from the dict.\"\"\"\n        return [handle.control for handle in self._control_dict.values()]\n\n    def get_count_of_controls_in_dict(self) -&gt; int:\n        \"\"\"Find number of controls in the dict.\"\"\"\n        return len(self._control_dict.keys())\n\n    def get_count_of_controls_in_catalog(self, recurse: bool) -&gt; int:\n        \"\"\"Get count of controls from the actual catalog including optional sub controls.\"\"\"\n        return len(list(self.get_all_controls_from_catalog(recurse)))\n\n    def get_group_ids(self) -&gt; List[str]:\n        \"\"\"Get all the group id's as a list of sorted strings.\"\"\"\n        return sorted(filter(lambda id_: id_, list({control.group_id for control in self._control_dict.values()})))\n\n    def get_all_groups_from_catalog(self) -&gt; List[cat.Group]:\n        \"\"\"\n        Retrieve all groups in the catalog sorted by group_id.\n\n        This ignores controls that are direct children of the catalog.\n        \"\"\"\n        groups: List[cat.Group] = []\n        if self._catalog.groups:\n            for my_group in self._catalog.groups:\n                for res in CatalogInterface._get_groups_from_group(my_group):\n                    groups.append(res)\n        return sorted(groups, key=lambda group: group.id)\n\n    def get_statement_label_if_exists(self, control_id: str,\n                                      statement_id: str) -&gt; Tuple[Optional[str], Optional[common.Part]]:\n        \"\"\"Get statement label if available.\"\"\"\n\n        def does_part_exists(part: common.Part) -&gt; bool:\n            does_match = False\n            if part.name and part.name in {const.STATEMENT, const.ITEM} and part.id == statement_id:\n                does_match = True\n            return does_match\n\n        control = self.get_control(control_id)\n        if not control:\n            return '', None\n        label = None\n        found_part = None\n        if control.parts:\n            for part in as_list(control.parts):\n                # Performance OSCAL assumption, ids are nested so recurse only if prefix\n                if part.id and statement_id.startswith(part.id):\n                    part = self.find_part_with_condition(part, does_part_exists)\n                    if part:\n                        label = ControlInterface.get_label(part)\n                        found_part = part\n                        break\n\n        return label, found_part\n\n    def find_part_with_condition(self, part: common.Part, condition: Callable) -&gt; Optional[common.Part]:\n        \"\"\"Traverse part and find subpart that satisfies given condition.\"\"\"\n        if condition(part):\n            # Part that satisfies the condition is found.\n            return part\n        else:\n            if part.parts:\n                for subpart in part.parts:\n                    found_part = self.find_part_with_condition(subpart, condition)\n                    if found_part:\n                        return found_part\n\n        return None\n\n    def delete_withdrawn_controls(self) -&gt; None:\n        \"\"\"Delete all withdrawn controls from the catalog.\"\"\"\n        delete_list = []\n        for control in self.get_all_controls_from_dict():\n            if ControlInterface.is_withdrawn(control):\n                delete_list.append(control.id)\n        for id_ in delete_list:\n            self.delete_control(id_)\n\n    @staticmethod\n    def _get_groups_from_group(group: cat.Group) -&gt; Iterator[cat.Group]:\n        yield group\n        if group.groups:\n            for new_group in group.groups:\n                for res in CatalogInterface._get_groups_from_group(new_group):\n                    yield res\n\n    def get_group_info_by_control(self, control_id: str) -&gt; Tuple[str, str, str]:\n        \"\"\"Get the group_id, title, class for this control from the dict.\"\"\"\n        return (\n            '' if self._control_dict is None else self._control_dict[control_id].group_id,\n            '' if self._control_dict is None else self._control_dict[control_id].group_title,\n            '' if self._control_dict is None else self._control_dict[control_id].group_class\n        )\n\n    def get_control_path(self, control_id: str) -&gt; List[str]:\n        \"\"\"Return the path into the markdown directory for this control based only on the groups.\"\"\"\n        return self._control_dict[control_id].group_path\n\n    def get_control_file_path(self, md_root: pathlib.Path, control_id: str) -&gt; Optional[pathlib.Path]:\n        \"\"\"Get the path to the control from the given root.\"\"\"\n        if control_id not in self._control_dict:\n            return None\n        path = md_root\n        for item in self.get_control_path(control_id):\n            path = path / item\n        return path / f'{control_id}.md'\n\n    def get_full_control_path(self, control_id: str) -&gt; List[str]:\n        \"\"\"Return the path to the control including groups and sub-controls.\"\"\"\n        return self._control_dict[control_id].control_path\n\n    def replace_control(self, control: cat.Control) -&gt; None:\n        \"\"\"\n        Replace the control in the control_dict.\n\n        This only replaces the parent control and not its children.\n        \"\"\"\n        self._control_dict[control.id].control = control\n\n    def delete_control(self, control_id: str) -&gt; None:\n        \"\"\"\n        Delete the control from the control_dict based on id.\n\n        Delete all its dependent children also.\n        \"\"\"\n        control = self.get_control(control_id)\n        if control:\n            for sub_control_id in self.get_dependent_control_ids(control.id):\n                self._control_dict.pop(sub_control_id, None)\n            self._control_dict.pop(control_id, None)\n\n    def get_catalog(self, update=True) -&gt; cat.Catalog:\n        \"\"\"Safe method to get catalog after forced update from catalog dict.\"\"\"\n        if update:\n            self.update_catalog_controls()\n        return self._catalog\n\n    def _update_all_controls_in_list(self, controls: List[cat.Control]) -&gt; List[cat.Control]:\n        \"\"\"\n        Given a list of controls, create fresh list pulled from the control dict.\n\n        Args:\n            controls: a list of controls in the original catalog\n\n        Returns:\n            The new list of updated controls, possibly with some missing if they have been removed from the dict.\n            Children are inserted as needed into parent controls.\n        \"\"\"\n        new_list: List[cat.Control] = []\n        for control in controls:\n            # first update the control itself by getting it from the dict\n            new_control = self.get_control(control.id)\n            if new_control:\n                # this overrides any sub controls in the control itself\n                # any added sub-controls should add to the skipped list\n                new_control.controls = self._update_all_controls_in_list(as_list(control.controls))\n                new_control.controls = none_if_empty(new_control.controls)\n                new_list.append(new_control)\n        return new_list\n\n    def _update_all_controls_in_group(self, group: cat.Group) -&gt; None:\n        \"\"\"Given a group of controls, create fresh version pulled from the control dict.\"\"\"\n        group.controls = self._update_all_controls_in_list(as_list(group.controls))\n        group.controls = none_if_empty(group.controls)\n        new_groups: List[cat.Group] = []\n        for sub_group in as_list(group.groups):\n            self._update_all_controls_in_group(sub_group)\n            new_groups.append(sub_group)\n        group.groups = none_if_empty(new_groups)\n\n    def _insert_control_in_catalog(self, control_handle: ControlHandle) -&gt; None:\n        \"\"\"Insert the control into the catalog based on its path.\"\"\"\n        path = control_handle.group_path\n        node = self._catalog\n        if path[0] != '':\n            for group_id in path:\n                found_group = None\n                for group in as_list(node.groups):\n                    if group.id == group_id:\n                        found_group = group\n                        break\n                if found_group:\n                    node = found_group\n                else:\n                    raise TrestleError(f'No controls found in catalog for group {group.id}')\n            node.title = control_handle.group_title\n            node.class_ = control_handle.group_class\n        node.controls = delete_item_from_list(\n            as_list(node.controls), control_handle.control.id, lambda control: control.id\n        )\n        node.controls.append(control_handle.control)\n        node.controls = none_if_empty(sorted(node.controls, key=lambda control: ControlInterface.get_sort_id(control)))\n\n    def update_catalog_controls(self) -&gt; None:\n        \"\"\"\n        Update the actual catalog by pulling fresh controls from the dict.\n\n        During assembly, controls may be added, but not children of controls.\n        New groups may not be added.\n        A control containing controls cannot be added.  Controls containing controls are only available if\n        the parent catalog was loaded from json.\n        \"\"\"\n        # first go through the catalog and pull existing controls from the dict\n        for group in as_list(self._catalog.groups):\n            self._update_all_controls_in_group(group)\n\n        new_list = []\n        for control in as_list(self._catalog.controls):\n            new_control = self.get_control(control.id)\n            new_control.controls = self._update_all_controls_in_list(as_list(control.controls))\n            new_control.controls = none_if_empty(new_control.controls)\n            new_list.append(new_control)\n        self._catalog.controls = none_if_empty(new_list)\n\n        # now add any new controls that are discovered in the dict\n        ids_in_catalog = CatalogInterface.get_control_ids_from_catalog(self._catalog)\n        for control_handle in self._control_dict.values():\n            if control_handle.control.id not in ids_in_catalog:\n                self._insert_control_in_catalog(control_handle)\n\n        self._catalog.params = none_if_empty(list(self.loose_param_dict.values()))\n\n    def _find_string_in_part(self, control_id: str, part: common.Part, seek_str: str) -&gt; List[str]:\n        hits: List[str] = []\n        if part.prose and part.prose.find(seek_str) &gt;= 0:\n            hits.append((control_id, part.prose))\n        if part.parts:\n            for sub_part in part.parts:\n                hits.extend(self._find_string_in_part(control_id, sub_part, seek_str))\n        return hits\n\n    def find_string_in_control(self, control: cat.Control, seek_str: str) -&gt; List[Tuple[str, str]]:\n        \"\"\"Find all instances of this string in prose of control.\"\"\"\n        hits: List[Tuple[str, str]] = []\n        if control.parts:\n            for part in control.parts:\n                hits.extend(self._find_string_in_part(control.id, part, seek_str))\n        return hits\n\n    @staticmethod\n    def _get_full_profile_param_dict(profile: Optional[prof.Profile]) -&gt; Dict[str, common.Parameter]:\n        \"\"\"Get the full mapping of param_id to modified value for this profiles set_params.\"\"\"\n        set_param_dict: Dict[str, common.Parameter] = {}\n        if profile and profile.modify:\n            for set_param in as_list(profile.modify.set_parameters):\n                param = ControlInterface.setparam_to_param(set_param.param_id, set_param)\n                set_param_dict[set_param.param_id] = param\n        return set_param_dict\n\n    @staticmethod\n    def _get_profile_param_dict(\n        control: cat.Control, profile_param_dict: Dict[str, common.Parameter], values_only: bool\n    ) -&gt; Dict[str, common.Parameter]:\n        \"\"\"\n        Get the dict of params for this control including possible overrides made by the profile modifications.\n\n        Args:\n            control: The control being queried\n            profile_param_dict: The full dict of params and modified values made by the profile\n\n        Returns:\n            mapping of param ids to their final parameter states after possible modify by the profile setparameters\n        \"\"\"\n        # get the mapping of param_id's to params for this control, excluding those with no value set\n        param_dict = ControlInterface.get_control_param_dict(control, values_only)\n        for key in param_dict.keys():\n            if key in profile_param_dict:\n                param_dict[key] = profile_param_dict[key]\n        return param_dict\n\n    def _get_full_param_dict(self) -&gt; Dict[str, common.Parameter]:\n        param_dict: Dict[str, common.Parameter] = {}\n        # build the full mapping of params to values from the catalog interface\n        for control in self.get_all_controls_from_dict():\n            param_dict.update(ControlInterface.get_control_param_dict(control, False))\n        return param_dict\n\n    def _change_prose_with_param_values(\n        self,\n        param_format,\n        param_rep,\n        show_value_warnings: bool,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; None:\n        \"\"\"Go through all controls and change prose based on param values.\"\"\"\n        param_dict = self._get_full_param_dict()\n        # insert param values into prose of all controls\n        for control in self.get_all_controls_from_dict():\n            ControlInterface.replace_control_prose(\n                control,\n                param_dict,\n                param_format,\n                param_rep,\n                show_value_warnings,\n                value_assigned_prefix,\n                value_not_assigned_prefix\n            )\n\n    @staticmethod\n    def _get_display_name_and_ns(param: common.Parameter) -&gt; Tuple[Optional[str], Optional[str]]:\n        for prop in as_list(param.props):\n            if prop.name == const.DISPLAY_NAME:\n                ns = str(prop.ns) if prop.ns else None\n                return prop.value, ns\n        return None, None\n\n    @staticmethod\n    def _get_param_value_origin_and_ns(param: common.Parameter) -&gt; Tuple[Optional[str], Optional[str]]:\n        for prop in as_list(param.props):\n            if prop.name == const.PARAM_VALUE_ORIGIN:\n                ns = str(prop.ns) if prop.ns else None\n                return prop.value, ns\n        return None, None\n\n    @staticmethod\n    def _prune_controls(md_path: pathlib.Path, written_controls: Set[str]) -&gt; List[str]:\n        \"\"\"Search directory and remove any controls that were not written out.\"\"\"\n        deleted_controls = []\n        for control_file in md_path.rglob('*.md'):\n            if control_file.stem not in written_controls:\n                logger.debug(\n                    f'Existing control markdown {control_file} deleted since it was not written out during generate'\n                )  # noqa E501\n                control_file.unlink()\n                deleted_controls.append(control_file.stem)\n        return sorted(deleted_controls)\n\n    def _extend_rules_param_list(\n        self, control_id: str, header: Dict[str, Any], param_id_rule_name_map: Dict[str, str]\n    ) -&gt; None:\n        \"\"\"Go through all set_params and put in rules param list if name matches.\"\"\"\n        control_comp_set_params = {}\n        rules_set_params = {}\n        all_set_params = self.get_control_comp_set_params(control_id)\n        for comp_name, param_list in all_set_params.items():\n            for param in param_list:\n                param_vals = none_if_empty(as_list(param.values))\n                rule_name = deep_get(param_id_rule_name_map, [comp_name, param.param_id], None)\n                if rule_name:\n                    param_dict = {'name': param.param_id}\n                    if param_vals:\n                        param_dict['values'] = param_vals\n                    deep_append(rules_set_params, [comp_name], param_dict)\n        set_or_pop(header, const.COMP_DEF_RULES_PARAM_VALS_TAG, rules_set_params)\n        set_or_pop(header, const.SET_PARAMS_TAG, control_comp_set_params)\n\n    def _get_control_memory_info(self, control_id: str, context: ControlContext) -&gt; Tuple[Dict[str, Any], CompDict]:\n        \"\"\"Build the rule info for the control into the header.\"\"\"\n        header = {}\n        rule_names_list: List[str] = []\n        comp_dict = self.get_comp_info(control_id)\n        # find the rule names that are needed by the control\n        for _, value in comp_dict.items():\n            for comp_info in value.values():\n                rule_names_list.extend(as_list(comp_info.rules))\n        if rule_names_list:\n            header_rules_dict = {}\n            rule_ids = {}\n            param_id_rule_name_map = {}\n            rule_id_rule_name_map = {}\n            # only include rules needed by control in the header\n            for comp_name, rules_dict in context.rules_dict.items():\n                for rule_id, rule_dict in rules_dict.items():\n                    if rule_dict['name'] in rule_names_list:\n                        deep_append(rule_ids, [comp_name], rule_id)\n                        deep_append(header_rules_dict, [comp_name], rule_dict)\n                        deep_set(rule_id_rule_name_map, [comp_name, rule_id], rule_dict['name'])\n            set_or_pop(header, const.COMP_DEF_RULES_TAG, header_rules_dict)\n            rules_params = {}\n            rules_param_names = []\n            for comp_name, rules_params_dict in as_dict(context.rules_params_dict).items():\n                for rule_id, rules_parameters in rules_params_dict.items():\n                    if rule_id in rule_ids.get(comp_name, []):\n                        for rule_parameter in rules_parameters:\n                            param_name = rule_parameter['name']\n                            rules_param_names.append(param_name)\n                            rule_parameter[const.HEADER_RULE_ID] = rule_id_rule_name_map[comp_name].get(rule_id, None)\n                            deep_append(rules_params, [comp_name], rule_parameter)\n                            deep_set(\n                                param_id_rule_name_map, [comp_name, rule_parameter['name']],\n                                rule_id_rule_name_map[comp_name][rule_id]\n                            )\n            set_or_pop(header, const.RULES_PARAMS_TAG, rules_params)\n\n            self._extend_rules_param_list(control_id, header, param_id_rule_name_map)\n\n        return header, comp_dict\n\n    @staticmethod\n    def _get_group_ids_and_dirs(md_path: pathlib.Path) -&gt; Dict[str, pathlib.Path]:\n        \"\"\"\n        Create a sorted map of group id to group dir that is ordered by group id.\n\n        This includes '' as the root group id.\n        \"\"\"\n        # manually insert the top dir as group ''\n        id_map: Dict[str, pathlib.Path] = {'': md_path}\n        for gdir in md_path.rglob('*'):\n            if gdir.is_dir():\n                dir_name = gdir.parts[-1]\n                id_map[dir_name] = gdir\n        # rebuild the dict by inserting items in manner sorted by key\n        sorted_id_map: Dict[str, pathlib.Path] = {}\n        for key in sorted(id_map):\n            sorted_id_map[key] = id_map[key]\n        return sorted_id_map\n\n    def get_sections(self) -&gt; List[str]:\n        \"\"\"Get the available sections by a full index of all controls.\"\"\"\n        return list(\n            {\n                part.name\n                for control_handle in self._control_dict.values()\n                for part in as_list(control_handle.control.parts)\n                if part.name != const.STATEMENT\n            }\n        )\n\n    def _find_control_in_group(self, group_id: str) -&gt; Tuple[str, ControlHandle]:\n        \"\"\"\n        Find a representative control for this group and its control handle.\n\n        This is a simple way to get group info (title etc.) given only group id.\n        It is not intended for high performance loops.  Use only as needed.\n        \"\"\"\n        for control_id, control_handle in self._control_dict.items():\n            if control_handle.group_id == group_id:\n                return control_id, control_handle\n        raise TrestleError(f'No controls found for group {group_id}')\n\n    def _add_control_imp_comp_info(\n        self, context: ControlContext, part_id_map: Dict[str, Dict[str, str]], comp_rules_props: List[common.Property]\n    ) -&gt; None:\n        \"\"\"Add component info to the impreqs of the control implementation based on applied rules.\"\"\"\n        control_imp_rules_dict, control_imp_rules_params_dict, ci_rules_props = ControlInterface.get_rules_and_params_dict_from_item(context.control_implementation)  # noqa E501\n        context.rules_dict[context.comp_name].update(control_imp_rules_dict)\n        comp_rules_params_dict = context.rules_params_dict.get(context.comp_name, {})\n        comp_rules_params_dict.update(control_imp_rules_params_dict)\n        context.rules_params_dict[context.comp_name] = comp_rules_params_dict\n        ci_set_params = ControlInterface.get_set_params_from_item(context.control_implementation)\n        catalog_control_ids = self.get_control_ids()\n        for imp_req in as_list(context.control_implementation.implemented_requirements):\n            if imp_req.control_id not in catalog_control_ids:\n                logger.warning(\n                    f'Component {context.component.title} references control {imp_req.control_id} not in profile.'\n                )\n            control_part_id_map = part_id_map.get(imp_req.control_id, {})\n            # find if any rules apply to this control, including in statements\n            control_rules, statement_rules, ir_props = ControlInterface.get_rule_list_for_imp_req(imp_req)\n            rule_props = comp_rules_props[:]\n            rule_props.extend(ci_rules_props)\n            rule_props.extend(ir_props)\n            rule_props = ControlInterface.clean_props(rule_props, remove_imp_status=False)\n            if control_rules:\n                status = ControlInterface.get_status_from_props(imp_req)\n                final_props = ControlInterface.cull_props_by_rules(rule_props, control_rules)\n                comp_info = ComponentImpInfo(imp_req.description, control_rules, final_props, status)\n                self.add_comp_info(imp_req.control_id, context.comp_name, '', comp_info)\n            set_params = copy.deepcopy(ci_set_params)\n            set_params.update(ControlInterface.get_set_params_from_item(imp_req))\n            for set_param in set_params.values():\n                # add to control_comp_set_params dict\n                self.add_comp_set_param(imp_req.control_id, context.comp_name, set_param)\n            for statement in as_list(imp_req.statements):\n                rule_list, stat_props = ControlInterface.get_rule_list_for_item(statement)\n                if rule_list:\n                    status = ControlInterface.get_status_from_props(statement)\n                    if statement.statement_id not in control_part_id_map:\n                        label = statement.statement_id\n                        logger.warning(\n                            f'No statement label found for statement id {label}.  Defaulting to {label}.'  # noqa E501\n                        )\n                    else:\n                        label = control_part_id_map[statement.statement_id]\n                    all_props = rule_props[:]\n                    all_props.extend(stat_props)\n                    final_props = ControlInterface.cull_props_by_rules(all_props, rule_list)\n                    comp_info = ComponentImpInfo(statement.description, rule_list, final_props, status)\n                    self.add_comp_info(imp_req.control_id, context.comp_name, label, comp_info)\n\n    def generate_control_rule_info(self, part_id_map: Dict[str, Dict[str, str]], context: ControlContext) -&gt; None:\n        \"\"\"\n        Generate rule info for controls directly from the components.\n\n        Args:\n            part_id_map: Mapping of label to part in the control\n            context: Control context for the current operation\n\n        Returns:\n            Returns nothing but places the rules_dict and rules_params_dict in the context for each component\n        \"\"\"\n        context.rules_dict = {}\n        context.rules_params_dict = {}\n        comps_uuids = []\n        for comp_def_name in context.comp_def_name_list:\n            context.comp_def, _ = ModelUtils.load_model_for_class(\n                context.trestle_root,\n                comp_def_name,\n                comp.ComponentDefinition\n            )\n            component_uuids = [comp.uuid for comp in context.comp_def.components]\n            comps_uuids.extend(component_uuids)\n            for component in as_list(context.comp_def.components):\n                context.component = component\n                context.comp_name = component.title\n                # get top level rule info applying to all controls from the component props\n                comp_rules_dict, comp_rules_params_dict, comp_rules_props = ControlInterface.get_rules_and_params_dict_from_item(component)  # noqa E501\n                context.rules_dict[context.comp_name] = comp_rules_dict\n                deep_update(context.rules_params_dict, [context.comp_name], comp_rules_params_dict)\n                for control_imp in as_list(component.control_implementations):\n                    context.control_implementation = control_imp\n                    self._add_control_imp_comp_info(context, part_id_map, comp_rules_props)\n                # add the rule_id to the param_dict\n                for param_comp_name, rule_param_dict in context.rules_params_dict.items():\n                    for rule_tag, params_list in rule_param_dict.items():\n                        for param in params_list:\n                            rule_dict = deep_get(context.rules_dict, [param_comp_name, rule_tag], {})\n                            param[const.HEADER_RULE_ID] = rule_dict.get(const.NAME, 'unknown_rule')\n        # determine if there are duplicated uuids and throw an exception\n        dup_comp_uuids = set({comp_uuid for comp_uuid in comps_uuids if comps_uuids.count(comp_uuid) &gt; 1})\n        if len(dup_comp_uuids) &gt; 0:\n            # throw an exception if there are repeated component uuids\n            for comp_uuid in dup_comp_uuids:\n                logger.error(f'Component uuid {comp_uuid} is duplicated')\n            raise TrestleError('Component uuids cannot be duplicated between different component definitions')\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.loose_param_dict","title":"<code>loose_param_dict: Dict[str, common.Parameter] = {param.id: paramfor param in as_list(catalog.params)} if catalog else {}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.ControlHandle","title":"<code>ControlHandle</code>  <code>dataclass</code>","text":"<p>Convenience class for handling controls as members of a group.</p> <p>group_id: id of parent group or '' if not in a group group_title: title of the group group_class: class of the group path: path of parent groups leading to this control - without the final control_id, or [''] if in cat list important to remember that controls may not be in a group and are directly attached to cat control: the control itself</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>@dataclass\nclass ControlHandle:\n    \"\"\"Convenience class for handling controls as members of a group.\n\n    group_id: id of parent group or '' if not in a group\n    group_title: title of the group\n    group_class: class of the group\n    path: path of parent groups leading to this control - without the final control_id, or [''] if in cat list\n    important to remember that controls may not be in a group and are directly attached to cat\n    control: the control itself\n    \"\"\"\n\n    group_id: str\n    group_title: Optional[str]\n    group_class: Optional[str]\n    group_path: List[str]\n    control_path: List[str]\n    control: cat.Control\n</code></pre> Attributes\u00a4 <code>control: cat.Control</code> <code>instance-attribute</code> \u00a4 <code>control_path: List[str]</code> <code>instance-attribute</code> \u00a4 <code>group_class: Optional[str]</code> <code>instance-attribute</code> \u00a4 <code>group_id: str</code> <code>instance-attribute</code> \u00a4 <code>group_path: List[str]</code> <code>instance-attribute</code> \u00a4 <code>group_title: Optional[str]</code> <code>instance-attribute</code> \u00a4 Functions\u00a4 <code>__init__(group_id, group_title, group_class, group_path, control_path, control)</code> \u00a4"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.__init__","title":"<code>__init__(catalog=None)</code>","text":"<p>Initialize the interface with the catalog.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def __init__(self, catalog: Optional[cat.Catalog] = None) -&gt; None:\n    \"\"\"Initialize the interface with the catalog.\"\"\"\n    self._catalog = catalog\n    self._param_control_map: Dict[str, str] = {}\n    self._generate_group_index: int = 0\n    self._control_dict = self._create_control_dict() if catalog else None\n    self.loose_param_dict: Dict[str, common.Parameter] = {param.id: param\n                                                          for param in as_list(catalog.params)} if catalog else {}\n    # map control id to CompDict\n    self._control_comp_dicts: Dict[str, CompDict] = {}\n    # map control id to dict containing set parameters by component\n    self._control_comp_set_params: Dict[str, Dict[str, comp.SetParameter]] = {}\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_info","title":"<code>add_comp_info(control_id, comp_name, label, comp_info)</code>","text":"<p>Add comp_info for a control.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def add_comp_info(self, control_id: str, comp_name: str, label: str, comp_info: ComponentImpInfo) -&gt; None:\n    \"\"\"Add comp_info for a control.\"\"\"\n    deep_set(self._control_comp_dicts, [control_id, comp_name, label], comp_info)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.add_comp_set_param","title":"<code>add_comp_set_param(control_id, comp_name, set_param)</code>","text":"<p>Add component setparam for control with overwrite.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def add_comp_set_param(self, control_id: str, comp_name: str, set_param: comp.SetParameter) -&gt; None:\n    \"\"\"Add component setparam for control with overwrite.\"\"\"\n    deep_append(self._control_comp_set_params, [control_id, comp_name], set_param)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.clear_comp_dicts","title":"<code>clear_comp_dicts()</code>","text":"<p>Clear the control component dicts.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def clear_comp_dicts(self) -&gt; None:\n    \"\"\"Clear the control component dicts.\"\"\"\n    self._control_comp_dicts = {}\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.clear_set_params","title":"<code>clear_set_params()</code>","text":"<p>Clear the control set params.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def clear_set_params(self) -&gt; None:\n    \"\"\"Clear the control set params.\"\"\"\n    self._control_comp_set_params = {}\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.delete_control","title":"<code>delete_control(control_id)</code>","text":"<p>Delete the control from the control_dict based on id.</p> <p>Delete all its dependent children also.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def delete_control(self, control_id: str) -&gt; None:\n    \"\"\"\n    Delete the control from the control_dict based on id.\n\n    Delete all its dependent children also.\n    \"\"\"\n    control = self.get_control(control_id)\n    if control:\n        for sub_control_id in self.get_dependent_control_ids(control.id):\n            self._control_dict.pop(sub_control_id, None)\n        self._control_dict.pop(control_id, None)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.delete_withdrawn_controls","title":"<code>delete_withdrawn_controls()</code>","text":"<p>Delete all withdrawn controls from the catalog.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def delete_withdrawn_controls(self) -&gt; None:\n    \"\"\"Delete all withdrawn controls from the catalog.\"\"\"\n    delete_list = []\n    for control in self.get_all_controls_from_dict():\n        if ControlInterface.is_withdrawn(control):\n            delete_list.append(control.id)\n    for id_ in delete_list:\n        self.delete_control(id_)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.find_part_with_condition","title":"<code>find_part_with_condition(part, condition)</code>","text":"<p>Traverse part and find subpart that satisfies given condition.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def find_part_with_condition(self, part: common.Part, condition: Callable) -&gt; Optional[common.Part]:\n    \"\"\"Traverse part and find subpart that satisfies given condition.\"\"\"\n    if condition(part):\n        # Part that satisfies the condition is found.\n        return part\n    else:\n        if part.parts:\n            for subpart in part.parts:\n                found_part = self.find_part_with_condition(subpart, condition)\n                if found_part:\n                    return found_part\n\n    return None\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.find_string_in_control","title":"<code>find_string_in_control(control, seek_str)</code>","text":"<p>Find all instances of this string in prose of control.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def find_string_in_control(self, control: cat.Control, seek_str: str) -&gt; List[Tuple[str, str]]:\n    \"\"\"Find all instances of this string in prose of control.\"\"\"\n    hits: List[Tuple[str, str]] = []\n    if control.parts:\n        for part in control.parts:\n            hits.extend(self._find_string_in_part(control.id, part, seek_str))\n    return hits\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.generate_control_rule_info","title":"<code>generate_control_rule_info(part_id_map, context)</code>","text":"<p>Generate rule info for controls directly from the components.</p> <p>Parameters:</p> Name Type Description Default <code>part_id_map</code> <code>Dict[str, Dict[str, str]]</code> <p>Mapping of label to part in the control</p> required <code>context</code> <code>ControlContext</code> <p>Control context for the current operation</p> required <p>Returns:</p> Type Description <code>None</code> <p>Returns nothing but places the rules_dict and rules_params_dict in the context for each component</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def generate_control_rule_info(self, part_id_map: Dict[str, Dict[str, str]], context: ControlContext) -&gt; None:\n    \"\"\"\n    Generate rule info for controls directly from the components.\n\n    Args:\n        part_id_map: Mapping of label to part in the control\n        context: Control context for the current operation\n\n    Returns:\n        Returns nothing but places the rules_dict and rules_params_dict in the context for each component\n    \"\"\"\n    context.rules_dict = {}\n    context.rules_params_dict = {}\n    comps_uuids = []\n    for comp_def_name in context.comp_def_name_list:\n        context.comp_def, _ = ModelUtils.load_model_for_class(\n            context.trestle_root,\n            comp_def_name,\n            comp.ComponentDefinition\n        )\n        component_uuids = [comp.uuid for comp in context.comp_def.components]\n        comps_uuids.extend(component_uuids)\n        for component in as_list(context.comp_def.components):\n            context.component = component\n            context.comp_name = component.title\n            # get top level rule info applying to all controls from the component props\n            comp_rules_dict, comp_rules_params_dict, comp_rules_props = ControlInterface.get_rules_and_params_dict_from_item(component)  # noqa E501\n            context.rules_dict[context.comp_name] = comp_rules_dict\n            deep_update(context.rules_params_dict, [context.comp_name], comp_rules_params_dict)\n            for control_imp in as_list(component.control_implementations):\n                context.control_implementation = control_imp\n                self._add_control_imp_comp_info(context, part_id_map, comp_rules_props)\n            # add the rule_id to the param_dict\n            for param_comp_name, rule_param_dict in context.rules_params_dict.items():\n                for rule_tag, params_list in rule_param_dict.items():\n                    for param in params_list:\n                        rule_dict = deep_get(context.rules_dict, [param_comp_name, rule_tag], {})\n                        param[const.HEADER_RULE_ID] = rule_dict.get(const.NAME, 'unknown_rule')\n    # determine if there are duplicated uuids and throw an exception\n    dup_comp_uuids = set({comp_uuid for comp_uuid in comps_uuids if comps_uuids.count(comp_uuid) &gt; 1})\n    if len(dup_comp_uuids) &gt; 0:\n        # throw an exception if there are repeated component uuids\n        for comp_uuid in dup_comp_uuids:\n            logger.error(f'Component uuid {comp_uuid} is duplicated')\n        raise TrestleError('Component uuids cannot be duplicated between different component definitions')\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_catalog","title":"<code>get_all_controls_from_catalog(recurse)</code>","text":"<p>Yield all controls from the actual catalog by group including optional sub controls.</p> <p>Parameters:</p> Name Type Description Default <code>recurse</code> <code>bool</code> <p>Whether to recurse within controls, but groups are always recursed</p> required <p>Returns:</p> Type Description <code>Iterator[Control]</code> <p>iterator of the controls in the catalog</p> Notes <p>This follows the actual structure of the catalog and groups</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_all_controls_from_catalog(self, recurse: bool) -&gt; Iterator[cat.Control]:\n    \"\"\"\n    Yield all controls from the actual catalog by group including optional sub controls.\n\n    Args:\n        recurse: Whether to recurse within controls, but groups are always recursed\n\n    Returns:\n        iterator of the controls in the catalog\n\n    Notes:\n        This follows the actual structure of the catalog and groups\n    \"\"\"\n    if self._catalog.groups:\n        for group in self._catalog.groups:\n            controls = self._get_all_controls_in_group(group, recurse)\n            for control in controls:\n                yield control\n    if self._catalog.controls:\n        cat_controls = self._get_all_controls_in_list(self._catalog.controls, recurse)\n        for control in cat_controls:\n            yield control\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_controls_from_dict","title":"<code>get_all_controls_from_dict()</code>","text":"<p>Yield individual controls from the dict.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_all_controls_from_dict(self) -&gt; List[cat.Control]:\n    \"\"\"Yield individual controls from the dict.\"\"\"\n    return [handle.control for handle in self._control_dict.values()]\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_all_groups_from_catalog","title":"<code>get_all_groups_from_catalog()</code>","text":"<p>Retrieve all groups in the catalog sorted by group_id.</p> <p>This ignores controls that are direct children of the catalog.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_all_groups_from_catalog(self) -&gt; List[cat.Group]:\n    \"\"\"\n    Retrieve all groups in the catalog sorted by group_id.\n\n    This ignores controls that are direct children of the catalog.\n    \"\"\"\n    groups: List[cat.Group] = []\n    if self._catalog.groups:\n        for my_group in self._catalog.groups:\n            for res in CatalogInterface._get_groups_from_group(my_group):\n                groups.append(res)\n    return sorted(groups, key=lambda group: group.id)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog","title":"<code>get_catalog(update=True)</code>","text":"<p>Safe method to get catalog after forced update from catalog dict.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_catalog(self, update=True) -&gt; cat.Catalog:\n    \"\"\"Safe method to get catalog after forced update from catalog dict.\"\"\"\n    if update:\n        self.update_catalog_controls()\n    return self._catalog\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_catalog_title","title":"<code>get_catalog_title()</code>","text":"<p>Get the title of the catalog.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_catalog_title(self) -&gt; str:\n    \"\"\"Get the title of the catalog.\"\"\"\n    return self._catalog.metadata.title\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_comp_info","title":"<code>get_comp_info(control_id)</code>","text":"<p>Get comp_dict for this control.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_comp_info(self, control_id: str) -&gt; CompDict:\n    \"\"\"Get comp_dict for this control.\"\"\"\n    return self._control_comp_dicts.get(control_id, {})\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_control","title":"<code>get_control(control_id)</code>","text":"<p>Get control from the control dict with this id.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_control(self, control_id: str) -&gt; Optional[cat.Control]:\n    \"\"\"Get control from the control dict with this id.\"\"\"\n    return None if control_id not in self._control_dict else self._control_dict[control_id].control\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_by_param_id","title":"<code>get_control_by_param_id(param_id)</code>","text":"<p>Get control from catalog that has this param id using the dict.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_control_by_param_id(self, param_id: str) -&gt; Optional[cat.Control]:\n    \"\"\"Get control from catalog that has this param id using the dict.\"\"\"\n    if param_id in self._param_control_map:\n        return self.get_control(self._param_control_map[param_id])\n    return None\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_comp_set_params","title":"<code>get_control_comp_set_params(control_id)</code>","text":"<p>Get dict of setparams list per component.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_control_comp_set_params(self, control_id: str) -&gt; Dict[str, List[comp.SetParameter]]:\n    \"\"\"Get dict of setparams list per component.\"\"\"\n    return self._control_comp_set_params.get(control_id, {})\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_file_path","title":"<code>get_control_file_path(md_root, control_id)</code>","text":"<p>Get the path to the control from the given root.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_control_file_path(self, md_root: pathlib.Path, control_id: str) -&gt; Optional[pathlib.Path]:\n    \"\"\"Get the path to the control from the given root.\"\"\"\n    if control_id not in self._control_dict:\n        return None\n    path = md_root\n    for item in self.get_control_path(control_id):\n        path = path / item\n    return path / f'{control_id}.md'\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_id_and_status","title":"<code>get_control_id_and_status(control_name)</code>","text":"<p>Get the control id and status using the control name.</p> <p>Returns empty string if status not found.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_control_id_and_status(self, control_name: str) -&gt; Tuple[str, str]:\n    \"\"\"\n    Get the control id and status using the control name.\n\n    Returns empty string if status not found.\n    \"\"\"\n    for control in self.get_all_controls_from_dict():\n        if ControlInterface.get_label(control).strip().lower() == control_name.strip().lower():\n            status = ControlInterface.get_prop(control, 'status')\n            return control.id, status\n    return '', ''\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids","title":"<code>get_control_ids()</code>","text":"<p>Get all control ids from the control dict.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_control_ids(self) -&gt; List[str]:\n    \"\"\"Get all control ids from the control dict.\"\"\"\n    return self._control_dict.keys()\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_ids_from_catalog","title":"<code>get_control_ids_from_catalog(catalog)</code>  <code>staticmethod</code>","text":"<p>Get all control ids from a catalog.</p> <p>This is intended to provide a quick list of all controls in a catalog without the expense of building the control dict.  So, if repeated queries are made into a catalog, it is worth instantiating a CatalogInterface and associated control dict.  Otherwise just use this to get a list of all controls.</p> <p>This function is needed within the CatalogInterface in order to determine if new controls have been added to the dict and need to be inserted in the actual catalog during update.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>@staticmethod\ndef get_control_ids_from_catalog(catalog: cat.Catalog) -&gt; List[str]:\n    \"\"\"\n    Get all control ids from a catalog.\n\n    This is intended to provide a quick list of all controls in a catalog without the expense of building the\n    control dict.  So, if repeated queries are made into a catalog, it is worth instantiating a CatalogInterface\n    and associated control dict.  Otherwise just use this to get a list of all controls.\n\n    This function is needed within the CatalogInterface in order to determine if new controls have been added\n    to the dict and need to be inserted in the actual catalog during update.\n    \"\"\"\n    controls = CatalogInterface._get_all_controls_in_list(as_list(catalog.controls), True)\n    id_list = [control.id for control in controls]\n    for group in as_list(catalog.groups):\n        controls = CatalogInterface._get_all_controls_in_group(group, True)\n        id_list.extend([control.id for control in as_list(controls)])\n    return id_list\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_part_prose","title":"<code>get_control_part_prose(control_id, part_name)</code>","text":"<p>Get the prose for a named part in the control.</p> <p>Parameters:</p> Name Type Description Default <code>control_id</code> <code>str</code> <p>id of the control</p> required <code>part_name</code> <code>str</code> <p>name of the part</p> required <p>Returns:</p> Type Description <code>str</code> <p>Single string concatenating prose from all parts and sub-parts in control with that name.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_control_part_prose(self, control_id: str, part_name: str) -&gt; str:\n    \"\"\"\n    Get the prose for a named part in the control.\n\n    Args:\n        control_id: id of the control\n        part_name: name of the part\n\n    Returns:\n        Single string concatenating prose from all parts and sub-parts in control with that name.\n    \"\"\"\n    control = self.get_control(control_id)\n    return ControlInterface.get_part_prose(control, part_name)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_control_path","title":"<code>get_control_path(control_id)</code>","text":"<p>Return the path into the markdown directory for this control based only on the groups.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_control_path(self, control_id: str) -&gt; List[str]:\n    \"\"\"Return the path into the markdown directory for this control based only on the groups.\"\"\"\n    return self._control_dict[control_id].group_path\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_catalog","title":"<code>get_count_of_controls_in_catalog(recurse)</code>","text":"<p>Get count of controls from the actual catalog including optional sub controls.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_count_of_controls_in_catalog(self, recurse: bool) -&gt; int:\n    \"\"\"Get count of controls from the actual catalog including optional sub controls.\"\"\"\n    return len(list(self.get_all_controls_from_catalog(recurse)))\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_count_of_controls_in_dict","title":"<code>get_count_of_controls_in_dict()</code>","text":"<p>Find number of controls in the dict.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_count_of_controls_in_dict(self) -&gt; int:\n    \"\"\"Find number of controls in the dict.\"\"\"\n    return len(self._control_dict.keys())\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_dependent_control_ids","title":"<code>get_dependent_control_ids(control_id)</code>","text":"<p>Find all child ids of this control from the dict with recursion.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_dependent_control_ids(self, control_id: str) -&gt; List[str]:\n    \"\"\"Find all child ids of this control from the dict with recursion.\"\"\"\n    children: List[str] = []\n    control = self.get_control(control_id)\n    if control:\n        new_controls = self._get_all_controls_in_list(as_list(control.controls), True)\n        children.extend([con.id for con in new_controls])\n    return children\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_full_control_path","title":"<code>get_full_control_path(control_id)</code>","text":"<p>Return the path to the control including groups and sub-controls.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_full_control_path(self, control_id: str) -&gt; List[str]:\n    \"\"\"Return the path to the control including groups and sub-controls.\"\"\"\n    return self._control_dict[control_id].control_path\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_group_ids","title":"<code>get_group_ids()</code>","text":"<p>Get all the group id's as a list of sorted strings.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_group_ids(self) -&gt; List[str]:\n    \"\"\"Get all the group id's as a list of sorted strings.\"\"\"\n    return sorted(filter(lambda id_: id_, list({control.group_id for control in self._control_dict.values()})))\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_group_info_by_control","title":"<code>get_group_info_by_control(control_id)</code>","text":"<p>Get the group_id, title, class for this control from the dict.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_group_info_by_control(self, control_id: str) -&gt; Tuple[str, str, str]:\n    \"\"\"Get the group_id, title, class for this control from the dict.\"\"\"\n    return (\n        '' if self._control_dict is None else self._control_dict[control_id].group_id,\n        '' if self._control_dict is None else self._control_dict[control_id].group_title,\n        '' if self._control_dict is None else self._control_dict[control_id].group_class\n    )\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_sections","title":"<code>get_sections()</code>","text":"<p>Get the available sections by a full index of all controls.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_sections(self) -&gt; List[str]:\n    \"\"\"Get the available sections by a full index of all controls.\"\"\"\n    return list(\n        {\n            part.name\n            for control_handle in self._control_dict.values()\n            for part in as_list(control_handle.control.parts)\n            if part.name != const.STATEMENT\n        }\n    )\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_sorted_controls_in_group","title":"<code>get_sorted_controls_in_group(group_id)</code>","text":"<p>Get the list of controls in a group sorted by the control sort-id.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_sorted_controls_in_group(self, group_id: str) -&gt; List[cat.Control]:\n    \"\"\"Get the list of controls in a group sorted by the control sort-id.\"\"\"\n    controls: List[cat.Control] = []\n    for control in self.get_all_controls_from_dict():\n        grp_id, _, _ = self.get_group_info_by_control(control.id)\n        if grp_id == group_id:\n            controls.append(control)\n    return sorted(controls, key=lambda control: ControlInterface.get_sort_id(control))\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_label_if_exists","title":"<code>get_statement_label_if_exists(control_id, statement_id)</code>","text":"<p>Get statement label if available.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_statement_label_if_exists(self, control_id: str,\n                                  statement_id: str) -&gt; Tuple[Optional[str], Optional[common.Part]]:\n    \"\"\"Get statement label if available.\"\"\"\n\n    def does_part_exists(part: common.Part) -&gt; bool:\n        does_match = False\n        if part.name and part.name in {const.STATEMENT, const.ITEM} and part.id == statement_id:\n            does_match = True\n        return does_match\n\n    control = self.get_control(control_id)\n    if not control:\n        return '', None\n    label = None\n    found_part = None\n    if control.parts:\n        for part in as_list(control.parts):\n            # Performance OSCAL assumption, ids are nested so recurse only if prefix\n            if part.id and statement_id.startswith(part.id):\n                part = self.find_part_with_condition(part, does_part_exists)\n                if part:\n                    label = ControlInterface.get_label(part)\n                    found_part = part\n                    break\n\n    return label, found_part\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_part_id_map","title":"<code>get_statement_part_id_map(label_as_key)</code>","text":"<p>Create mapping of label to part_id for top level parts in statement of all controls.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_statement_part_id_map(self, label_as_key: bool) -&gt; Dict[str, Dict[str, str]]:\n    \"\"\"Create mapping of label to part_id for top level parts in statement of all controls.\"\"\"\n    id_map = {}\n    for control in self.get_all_controls_from_catalog(True):\n        statement_part = get_item_from_list(control.parts, const.STATEMENT, lambda p: p.name)\n        if not statement_part:\n            continue\n        id_dict: Dict[str, str] = {}\n        for sub_part in as_list(statement_part.parts):\n            label = ControlInterface.get_label(sub_part)\n            # skip add to map for empty label\n            if not label:\n                continue\n            if label_as_key:\n                id_dict[label] = sub_part.id\n            else:\n                id_dict[sub_part.id] = label\n        if id_dict:\n            id_map[control.id] = id_dict\n    return id_map\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.get_statement_parts","title":"<code>get_statement_parts(control_id)</code>","text":"<p>Get list of statement parts as dicts with indentation, label and prose.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def get_statement_parts(self, control_id: str) -&gt; List[Dict[str, str]]:\n    \"\"\"Get list of statement parts as dicts with indentation, label and prose.\"\"\"\n    items = []\n    control = self.get_control(control_id)\n\n    # control may have no statement or parts\n    # but if statement present it is first part\n    if control is None:\n        logger.warning(f'No control found for id {control_id}')\n    elif control.parts:\n        part = control.parts[0]\n        if part.name == 'statement':\n            items.extend(CatalogInterface._get_statement_sub_parts(part, 0))\n        else:\n            logger.warning(f'Control {control_id} has parts but first part name is {part.name} - not statement')\n    return items\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.replace_control","title":"<code>replace_control(control)</code>","text":"<p>Replace the control in the control_dict.</p> <p>This only replaces the parent control and not its children.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def replace_control(self, control: cat.Control) -&gt; None:\n    \"\"\"\n    Replace the control in the control_dict.\n\n    This only replaces the parent control and not its children.\n    \"\"\"\n    self._control_dict[control.id].control = control\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface.CatalogInterface.update_catalog_controls","title":"<code>update_catalog_controls()</code>","text":"<p>Update the actual catalog by pulling fresh controls from the dict.</p> <p>During assembly, controls may be added, but not children of controls. New groups may not be added. A control containing controls cannot be added.  Controls containing controls are only available if the parent catalog was loaded from json.</p> Source code in <code>trestle/core/catalog/catalog_interface.py</code> <pre><code>def update_catalog_controls(self) -&gt; None:\n    \"\"\"\n    Update the actual catalog by pulling fresh controls from the dict.\n\n    During assembly, controls may be added, but not children of controls.\n    New groups may not be added.\n    A control containing controls cannot be added.  Controls containing controls are only available if\n    the parent catalog was loaded from json.\n    \"\"\"\n    # first go through the catalog and pull existing controls from the dict\n    for group in as_list(self._catalog.groups):\n        self._update_all_controls_in_group(group)\n\n    new_list = []\n    for control in as_list(self._catalog.controls):\n        new_control = self.get_control(control.id)\n        new_control.controls = self._update_all_controls_in_list(as_list(control.controls))\n        new_control.controls = none_if_empty(new_control.controls)\n        new_list.append(new_control)\n    self._catalog.controls = none_if_empty(new_list)\n\n    # now add any new controls that are discovered in the dict\n    ids_in_catalog = CatalogInterface.get_control_ids_from_catalog(self._catalog)\n    for control_handle in self._control_dict.values():\n        if control_handle.control.id not in ids_in_catalog:\n            self._insert_control_in_catalog(control_handle)\n\n    self._catalog.params = none_if_empty(list(self.loose_param_dict.values()))\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_interface/#trestle.core.catalog.catalog_interface-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog/catalog_merger/","title":"trestle.core.catalog.catalog_merger","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger","title":"<code>trestle.core.catalog.catalog_merger</code>","text":"<p>Provide interface to merge one catalog to another.</p>"},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger.CatalogMerger","title":"<code>CatalogMerger</code>","text":"<p>Catalog merger.</p> <p>Catalog merger handles all operations related to merging contents of one catalog to another.</p> Source code in <code>trestle/core/catalog/catalog_merger.py</code> <pre><code>class CatalogMerger():\n    \"\"\"\n    Catalog merger.\n\n    Catalog merger handles all operations related to\n    merging contents of one catalog to another.\n    \"\"\"\n\n    def __init__(self, catalog_interface: CatalogInterface):\n        \"\"\"Initialize catalog merger.\"\"\"\n        self._catalog_interface = catalog_interface\n\n    @staticmethod\n    def merge_controls(dest: cat.Control, src: cat.Control, replace_params: bool) -&gt; None:\n        \"\"\"\n        Merge the src control into dest.\n\n        Args:\n            dest: destination control into which content will be added\n            src: source control with new content\n            replace_params: replace the control params with the new ones\n        \"\"\"\n        ControlInterface.merge_parts(dest, src)\n        if replace_params:\n            dest.params = src.params\n\n    def merge_catalog(self, catalog: cat.Catalog, replace_params: bool) -&gt; None:\n        \"\"\"\n        Merge the provided new catalog controls into the original catalog in this catalog interface.\n\n        Args:\n            catalog: catalog containing controls that are merged into the current catalog of the interface\n            replace_params: replace all params in the control with the new ones\n\n        Notes:\n            This is mainly to support the reading of a catalog from markdown.  It allows retention of content such as\n            metadata and backmatter, along with labels and other parameter attributes that aren't in markdown.\n            The list of controls and group structure is specified by the markdown structure - but this doesn't allow\n            controls to contain controls.  Group lists are specified per directory.\n\n            Reading the markdown tells you groups and controls in them - and groups in groups.\n            Controls cannot change groups.  If the control was in the original json, its parts are replaced,\n            including its parameters.  Only values may be specified.  If no value specified, the value is unset in json.\n        \"\"\"\n        cat_interface = CatalogInterface(catalog)\n        for src in cat_interface.get_all_controls_from_dict():\n            group_id, _, _ = cat_interface.get_group_info_by_control(src.id)\n            dest = self._catalog_interface.get_control(src.id)\n            if dest:\n                dest_group, _, _ = self._catalog_interface.get_group_info_by_control(dest.id)\n                if dest_group != group_id:\n                    raise TrestleError(f'Markdown for control {src.id} has different group id.')\n                CatalogMerger.merge_controls(dest, src, replace_params)\n                self._catalog_interface.replace_control(dest)\n            else:\n                # this is a new control that isn't already in the merge destination\n                # need to add the control knowing its group must already exist\n                # get group info from an arbitrary control already present in group\n                _, control_handle = self._catalog_interface._find_control_in_group(group_id)\n                new_control_handle = copy.deepcopy(control_handle)\n                new_control_handle.control = src\n                # add the control and its handle to the param_dict\n                self._catalog_interface._control_dict[src.id] = new_control_handle  # type: ignore\n\n        # now need to cull any controls that are not in the src catalog\n        if cat_interface._control_dict is None:\n            handled_ids = None\n        else:\n            handled_ids = set(cat_interface._control_dict.keys())\n        orig_ids = set(self._catalog_interface._control_dict.keys())\n        extra_ids = orig_ids.difference(handled_ids)\n        for extra_id in sorted(extra_ids):\n            self._catalog_interface._control_dict.pop(extra_id)\n\n        self._catalog_interface.update_catalog_controls()\n\n    def _merge_header_and_comp_dict(\n        self, control: cat.Control, control_file_path: pathlib.Path, context: ControlContext\n    ) -&gt; None:\n        \"\"\"\n        Merge the header and the comp_dict.\n\n        Notes:\n            now have all rules in context.rules_dict and all rules_params in context.rules_params_dict\n            all set-params per component for each control are in the cat interface\n            all comp-infos by control and part are in the cat interface\n\n            can now write out catalog and pull from the markdown:\n            header for param values to set during assem\n            prose and status for This System\n            status for all parts that still have rules\n        \"\"\"\n        memory_header, memory_comp_dict = self._catalog_interface._get_control_memory_info(control.id, context)\n        ControlInterface.merge_dicts_deep(memory_header, context.merged_header, True)\n        md_header, md_comp_dict = CatalogReader._read_comp_info_from_md(control_file_path, context)\n        # md content replaces memory content but unless memory has no rules for it and the content is removed\n        # but This System doesn't require rules, so its content is always kept\n\n        # go through the just-read md_comp_dict and update the memory dict with contents in md\n        if const.SSP_MAIN_COMP_NAME in md_comp_dict:\n            memory_comp_dict[const.SSP_MAIN_COMP_NAME] = md_comp_dict[const.SSP_MAIN_COMP_NAME]\n        for comp_name, md_label_dict in md_comp_dict.items():\n            memory_label_dict = memory_comp_dict.get(comp_name, None)\n            if comp_name != const.SSP_MAIN_COMP_NAME:\n                if not memory_label_dict:\n                    continue\n                for label, comp_info in md_label_dict.items():\n                    if label in memory_label_dict:\n                        memory_label_dict[label] = comp_info\n\n        memory_rules_param_vals = memory_header.get(const.COMP_DEF_RULES_PARAM_VALS_TAG, {})\n        md_rules_param_vals = md_header.get(const.COMP_DEF_RULES_PARAM_VALS_TAG, {})\n        for comp_name, val_list in md_rules_param_vals.items():\n            val_dict = {val['name']: val for val in val_list}\n            if comp_name not in memory_rules_param_vals:\n                memory_rules_param_vals[comp_name] = val_list\n            else:\n                # merge the lists with priority to md\n                new_list = []\n                mem_list = memory_rules_param_vals[comp_name]\n                mem_names = [mem['name'] for mem in mem_list]\n                for val in mem_list:\n                    new_list.append(val_dict.get(val['name'], val))\n                for key, val in val_dict.items():\n                    if key not in mem_names:\n                        new_list.append(val)\n                memory_rules_param_vals[comp_name] = new_list\n\n        set_or_pop(memory_header, const.COMP_DEF_RULES_PARAM_VALS_TAG, memory_rules_param_vals)\n        context.merged_header = memory_header\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger.CatalogMerger-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger.CatalogMerger.__init__","title":"<code>__init__(catalog_interface)</code>","text":"<p>Initialize catalog merger.</p> Source code in <code>trestle/core/catalog/catalog_merger.py</code> <pre><code>def __init__(self, catalog_interface: CatalogInterface):\n    \"\"\"Initialize catalog merger.\"\"\"\n    self._catalog_interface = catalog_interface\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger.CatalogMerger.merge_catalog","title":"<code>merge_catalog(catalog, replace_params)</code>","text":"<p>Merge the provided new catalog controls into the original catalog in this catalog interface.</p> <p>Parameters:</p> Name Type Description Default <code>catalog</code> <code>Catalog</code> <p>catalog containing controls that are merged into the current catalog of the interface</p> required <code>replace_params</code> <code>bool</code> <p>replace all params in the control with the new ones</p> required Notes <p>This is mainly to support the reading of a catalog from markdown.  It allows retention of content such as metadata and backmatter, along with labels and other parameter attributes that aren't in markdown. The list of controls and group structure is specified by the markdown structure - but this doesn't allow controls to contain controls.  Group lists are specified per directory.</p> <p>Reading the markdown tells you groups and controls in them - and groups in groups. Controls cannot change groups.  If the control was in the original json, its parts are replaced, including its parameters.  Only values may be specified.  If no value specified, the value is unset in json.</p> Source code in <code>trestle/core/catalog/catalog_merger.py</code> <pre><code>def merge_catalog(self, catalog: cat.Catalog, replace_params: bool) -&gt; None:\n    \"\"\"\n    Merge the provided new catalog controls into the original catalog in this catalog interface.\n\n    Args:\n        catalog: catalog containing controls that are merged into the current catalog of the interface\n        replace_params: replace all params in the control with the new ones\n\n    Notes:\n        This is mainly to support the reading of a catalog from markdown.  It allows retention of content such as\n        metadata and backmatter, along with labels and other parameter attributes that aren't in markdown.\n        The list of controls and group structure is specified by the markdown structure - but this doesn't allow\n        controls to contain controls.  Group lists are specified per directory.\n\n        Reading the markdown tells you groups and controls in them - and groups in groups.\n        Controls cannot change groups.  If the control was in the original json, its parts are replaced,\n        including its parameters.  Only values may be specified.  If no value specified, the value is unset in json.\n    \"\"\"\n    cat_interface = CatalogInterface(catalog)\n    for src in cat_interface.get_all_controls_from_dict():\n        group_id, _, _ = cat_interface.get_group_info_by_control(src.id)\n        dest = self._catalog_interface.get_control(src.id)\n        if dest:\n            dest_group, _, _ = self._catalog_interface.get_group_info_by_control(dest.id)\n            if dest_group != group_id:\n                raise TrestleError(f'Markdown for control {src.id} has different group id.')\n            CatalogMerger.merge_controls(dest, src, replace_params)\n            self._catalog_interface.replace_control(dest)\n        else:\n            # this is a new control that isn't already in the merge destination\n            # need to add the control knowing its group must already exist\n            # get group info from an arbitrary control already present in group\n            _, control_handle = self._catalog_interface._find_control_in_group(group_id)\n            new_control_handle = copy.deepcopy(control_handle)\n            new_control_handle.control = src\n            # add the control and its handle to the param_dict\n            self._catalog_interface._control_dict[src.id] = new_control_handle  # type: ignore\n\n    # now need to cull any controls that are not in the src catalog\n    if cat_interface._control_dict is None:\n        handled_ids = None\n    else:\n        handled_ids = set(cat_interface._control_dict.keys())\n    orig_ids = set(self._catalog_interface._control_dict.keys())\n    extra_ids = orig_ids.difference(handled_ids)\n    for extra_id in sorted(extra_ids):\n        self._catalog_interface._control_dict.pop(extra_id)\n\n    self._catalog_interface.update_catalog_controls()\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger.CatalogMerger.merge_controls","title":"<code>merge_controls(dest, src, replace_params)</code>  <code>staticmethod</code>","text":"<p>Merge the src control into dest.</p> <p>Parameters:</p> Name Type Description Default <code>dest</code> <code>Control</code> <p>destination control into which content will be added</p> required <code>src</code> <code>Control</code> <p>source control with new content</p> required <code>replace_params</code> <code>bool</code> <p>replace the control params with the new ones</p> required Source code in <code>trestle/core/catalog/catalog_merger.py</code> <pre><code>@staticmethod\ndef merge_controls(dest: cat.Control, src: cat.Control, replace_params: bool) -&gt; None:\n    \"\"\"\n    Merge the src control into dest.\n\n    Args:\n        dest: destination control into which content will be added\n        src: source control with new content\n        replace_params: replace the control params with the new ones\n    \"\"\"\n    ControlInterface.merge_parts(dest, src)\n    if replace_params:\n        dest.params = src.params\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_merger/#trestle.core.catalog.catalog_merger-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog/catalog_reader/","title":"trestle.core.catalog.catalog_reader","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader","title":"<code>trestle.core.catalog.catalog_reader</code>","text":"<p>Provide interface to read catalog from markdown back to OSCAL.</p>"},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader.CatalogReader","title":"<code>CatalogReader</code>","text":"<p>Catalog reader.</p> <p>Catalog reader handles all operations related to reading catalog from markdown.</p> Source code in <code>trestle/core/catalog/catalog_reader.py</code> <pre><code>class CatalogReader():\n    \"\"\"\n    Catalog reader.\n\n    Catalog reader handles all operations related to\n    reading catalog from markdown.\n    \"\"\"\n\n    def __init__(self, catalog_interface: CatalogInterface):\n        \"\"\"Initialize catalog reader.\"\"\"\n        self._catalog_interface = catalog_interface\n\n    def read_additional_content(\n        self,\n        md_path: pathlib.Path,\n        required_sections_list: List[str],\n        label_map: Dict[str, Dict[str, str]],\n        sections_dict: Dict[str, str],\n        write_mode: bool\n    ) -&gt; Tuple[List[prof.Alter], Dict[str, Any], Dict[str, str]]:\n        \"\"\"Read all markdown controls and return list of alters plus control param dict and param sort map.\"\"\"\n        alters_map: Dict[str, prof.Alter] = {}\n        final_param_dict: Dict[str, Any] = {}\n        param_sort_map: Dict[str, str] = {}\n        for group_path in CatalogInterface._get_group_ids_and_dirs(md_path).values():\n            for control_file in group_path.glob('*.md'):\n                sort_id, control_alters, control_param_dict = ControlReader.read_editable_content(\n                    control_file,\n                    required_sections_list,\n                    label_map,\n                    sections_dict,\n                    write_mode\n                )\n                alters_map[sort_id] = control_alters\n                for param_id, param_dict in control_param_dict.items():\n                    # if profile_values are present, overwrite values with them\n                    if const.PROFILE_VALUES in param_dict:\n                        if param_dict[const.PROFILE_VALUES] != [] and param_dict[const.PROFILE_VALUES] is not None:\n                            if not write_mode and const.REPLACE_ME_PLACEHOLDER in param_dict[const.PROFILE_VALUES]:\n                                param_dict[const.PROFILE_VALUES].remove(const.REPLACE_ME_PLACEHOLDER)\n                            if param_dict[const.PROFILE_VALUES] != [] and param_dict[const.PROFILE_VALUES] is not None:\n                                param_dict[const.VALUES] = param_dict[const.PROFILE_VALUES]\n                        if not write_mode:\n                            param_dict.pop(const.PROFILE_VALUES)\n                    # verifies if at control profile edition the param value origin was modified\n                    # through the profile-param-value-origin tag\n                    if const.PROFILE_PARAM_VALUE_ORIGIN in param_dict:\n                        if param_dict[const.PROFILE_PARAM_VALUE_ORIGIN] != const.REPLACE_ME_PLACEHOLDER:\n                            param_dict[const.PARAM_VALUE_ORIGIN] = param_dict[const.PROFILE_PARAM_VALUE_ORIGIN]\n                            param_dict.pop(const.PROFILE_PARAM_VALUE_ORIGIN)\n                        else:\n                            # removes replace me placeholder and profile-param-value-origin as it was not modified\n                            param_dict.pop(const.PROFILE_PARAM_VALUE_ORIGIN)\n                            # validates param-value-origin is in dict to remove it\n                            # because a value wasn\u00b4t provided and it shouldn\u00b4t be inheriting value from parent\n                            if const.PARAM_VALUE_ORIGIN in param_dict:\n                                param_dict.pop(const.PARAM_VALUE_ORIGIN)\n                    final_param_dict[param_id] = param_dict\n                    param_sort_map[param_id] = sort_id\n        new_alters: List[prof.Alter] = []\n        # fill the alters according to the control sorting order\n        for key in sorted(alters_map.keys()):\n            new_alters.extend(alters_map[key])\n        return new_alters, final_param_dict, param_sort_map\n\n    def read_catalog_from_markdown(self, md_path: pathlib.Path, set_parameters_flag: bool) -&gt; cat.Catalog:\n        \"\"\"\n        Read the groups and catalog controls from the given directory.\n\n        This will overwrite the existing groups and controls in the catalog.\n        \"\"\"\n        id_map = CatalogInterface._get_group_ids_and_dirs(md_path)\n        groups: List[cat.Group] = []\n        # read each group dir\n        for group_id, group_dir in id_map.items():\n            control_list_raw = []\n            group_title = ''\n            # Need to get group title from at least one control in this directory\n            # All controls in dir should have same group title\n            # Set group title to the first one found and warn if different non-empty title appears\n            # Controls with empty group titles are tolerated but at least one title must be present or warning given\n            # The special group with no name that has the catalog as parent is just a list and has no title\n            for control_path in group_dir.glob('*.md'):\n                control, control_group_title = ControlReader.read_control(control_path, set_parameters_flag)\n                if control_group_title:\n                    if group_title:\n                        if control_group_title != group_title:\n                            logger.warning(\n                                f'Control {control.id} group title {control_group_title} differs from {group_title}'\n                            )\n                    else:\n                        group_title = control_group_title\n                control_list_raw.append(control)\n            control_list = sorted(control_list_raw, key=lambda control: ControlInterface.get_sort_id(control))\n            if group_id:\n                if not group_title:\n                    logger.warning(\n                        f'No group title found in controls for group {group_id}.  The title will be recovered if assembling into an existing catalog with the group title defined.'  # noqa E501\n                    )\n                new_group = cat.Group(id=group_id, title=group_title)\n                new_group.controls = none_if_empty(control_list)\n                groups.append(new_group)\n            else:\n                # if the list of controls has no group id it also has no title and is just the controls of the catalog\n                self._catalog_interface._catalog.controls = none_if_empty(control_list)\n        self._catalog_interface._catalog.groups = none_if_empty(groups)\n        self._catalog_interface._create_control_dict()\n        self._catalog_interface._catalog.params = none_if_empty(self._catalog_interface._catalog.params)\n        return self._catalog_interface._catalog\n\n    @staticmethod\n    def read_catalog_imp_reqs(md_path: pathlib.Path, context: ControlContext) -&gt; List[comp.ImplementedRequirement]:\n        \"\"\"Read the full set of control implemented requirements from markdown.\n\n        Args:\n            md_path: Path to the markdown control files, with directories for each group\n            context: Context for the operation\n\n        Returns:\n            List of implemented requirements gathered from each control\n\n        Notes:\n            As the controls are read into the catalog the needed components are added if not already available.\n            avail_comps provides the mapping of component name to the actual component.\n            This is only used during component assemble and only for updating one component\n        \"\"\"\n        imp_req_map: Dict[str, comp.ImplementedRequirement] = {}\n        for group_path in CatalogInterface._get_group_ids_and_dirs(md_path).values():\n            for control_file in group_path.glob('*.md'):\n                sort_id, imp_req = ControlReader.read_implemented_requirement(control_file, context)\n                imp_req_map[sort_id] = imp_req\n        return [imp_req_map[key] for key in sorted(imp_req_map.keys())]\n\n    @staticmethod\n    def _get_imp_req_for_control(ssp: ossp.SystemSecurityPlan, control_id: str) -&gt; ossp.ImplementedRequirement:\n        for imp_req in as_list(ssp.control_implementation.implemented_requirements):\n            if imp_req.control_id == control_id:\n                return imp_req\n        imp_req = gens.generate_sample_model(ossp.ImplementedRequirement)\n        imp_req.control_id = control_id\n        ssp.control_implementation.implemented_requirements = as_list(\n            ssp.control_implementation.implemented_requirements\n        )\n        ssp.control_implementation.implemented_requirements.append(imp_req)\n        return imp_req\n\n    @staticmethod\n    def _get_imp_req_for_statement(\n        ssp: ossp.SystemSecurityPlan, control_id: str, statement_id: str\n    ) -&gt; ossp.ImplementedRequirement:\n        control_imp_req: Optional[ossp.ImplementedRequirement] = None\n        for imp_req in as_list(ssp.control_implementation.implemented_requirements):\n            if imp_req.control_id == control_id:\n                control_imp_req = imp_req\n                if statement_id in [stat.statement_id for stat in as_list(imp_req.statements)]:\n                    return imp_req\n        # we didn't find imp_req with statement so need to make statement and/or imp_req\n        if not control_imp_req:\n            control_imp_req = gens.generate_sample_model(ossp.ImplementedRequirement)\n            control_imp_req.control_id = control_id\n            control_imp_req.statements = None\n            ssp.control_implementation.implemented_requirements = as_list(\n                ssp.control_implementation.implemented_requirements\n            )\n            ssp.control_implementation.implemented_requirements.append(control_imp_req)\n        CatalogReader._add_statement_to_impl_requirement(control_imp_req, statement_id)\n        return control_imp_req\n\n    @staticmethod\n    def _add_statement_to_impl_requirement(impl_req: ossp.ImplementedRequirement, statement_id: str) -&gt; ossp.Statement:\n        \"\"\"Update the implemented requirement with a new statement.\"\"\"\n        statement = gens.generate_sample_model(ossp.Statement)\n        statement.statement_id = statement_id\n        statement.by_components = None\n        impl_req.statements = as_list(impl_req.statements)\n        impl_req.statements.append(statement)\n        return statement\n\n    @staticmethod\n    def _get_by_comp_from_imp_req(\n        imp_req: ossp.ImplementedRequirement, statement_id: str, comp_uuid: str\n    ) -&gt; ossp.ByComponent:\n        if statement_id:\n            found_statement: Optional[ossp.Statement] = None\n            for statement in as_list(imp_req.statements):\n                if statement.statement_id == statement_id:\n                    found_statement = statement\n                    break\n\n            # If the statement doesn't exist, create it\n            if not found_statement:\n                found_statement = CatalogReader._add_statement_to_impl_requirement(imp_req, statement_id)\n            else:\n                for by_comp in as_list(found_statement.by_components):\n                    if by_comp.component_uuid == comp_uuid:\n                        return by_comp\n\n            # didnt find bycomp or new statement so need to make one\n            by_comp = gens.generate_sample_model(ossp.ByComponent)\n            by_comp.component_uuid = comp_uuid\n            by_comp.implementation_status = com.ImplementationStatus(state=const.STATUS_PLANNED)\n            found_statement.by_components = as_list(found_statement.by_components)\n            found_statement.by_components.append(by_comp)\n            return by_comp\n        else:\n            for by_comp in as_list(imp_req.by_components):\n                if by_comp.component_uuid == comp_uuid:\n                    return by_comp\n            by_comp = gens.generate_sample_model(ossp.ByComponent)\n            by_comp.component_uuid = comp_uuid\n            by_comp.implementation_status = com.ImplementationStatus(state=const.STATUS_PLANNED)\n            imp_req.by_components = as_list(imp_req.by_components)\n            imp_req.by_components.append(by_comp)\n            return by_comp\n\n    @staticmethod\n    def _read_comp_info_from_md(control_file_path: pathlib.Path,\n                                context: ControlContext) -&gt; Tuple[Dict[str, Any], CompDict]:\n        md_header = {}\n        comp_dict = {}\n        if control_file_path.exists():\n            md_header, comp_dict = ControlReader.read_control_info_from_md(control_file_path, context)\n        return md_header, comp_dict\n\n    @staticmethod\n    def _update_ssp_with_comp_info(\n        ssp: ossp.SystemSecurityPlan,\n        control_id: str,\n        gen_comp: generic.GenericComponent,\n        comp_info_dict: Dict[str, ComponentImpInfo],\n        part_id_map_by_label: Dict[str, Dict[str, str]]\n    ) -&gt; None:\n        # get imp req for control and find one with by_comp, creating if needed\n        imp_req = CatalogReader._get_imp_req_for_control(ssp, control_id)\n        # if control has no parts it will not have part id map and bycomps will go at control level\n        control_part_id_map = part_id_map_by_label.get(control_id, {})\n        for label, comp_info in comp_info_dict.items():\n            part_id = control_part_id_map.get(label, '')\n            by_comp = CatalogReader._get_by_comp_from_imp_req(imp_req, part_id, gen_comp.uuid)\n            by_comp.description = comp_info.prose\n            by_comp.implementation_status = comp_info.status\n\n    @staticmethod\n    def _insert_set_param_into_by_comps(\n        item: Union[ossp.ImplementedRequirement, ossp.ByComponent],\n        rule_id: str,\n        param_name: str,\n        param_values: List[str],\n        comp_uuid: str\n    ) -&gt; None:\n        for by_comp in as_list(item.by_components):\n            if by_comp.component_uuid == comp_uuid:\n                for prop in as_list(by_comp.props):\n                    if prop.name == const.RULE_ID and prop.value == rule_id:\n                        found = False\n                        for sp in as_list(by_comp.set_parameters):\n                            if sp.param_id == param_name:\n                                sp.values = param_values\n                                found = True\n                                break\n                        if not found:\n                            sp = ossp.SetParameter(param_id=param_name, values=param_values)\n                            by_comp.set_parameters = as_list(by_comp.set_parameters)\n                            by_comp.set_parameters.append(sp)\n\n    @staticmethod\n    def _insert_param_dict_in_imp_req(\n        imp_req: ossp.ImplementedRequirement,\n        param_dict: Dict[str, str],\n        comp_name: str,\n        md_header: Dict[str, Dict[str, str]],\n        comp_uuid: str\n    ):\n        \"\"\"Insert the param in the by_comps that are supported by the rule.\"\"\"\n        # given param name find rule_id in comp name header entry\n        # then find all statements with by_comp that have that rule id in props\n        rules_dict = md_header.get(const.RULES_PARAMS_TAG, {})\n        comp_rules_params = rules_dict.get(comp_name, [])\n        param_name = param_dict['name']\n        param_values = param_dict['values']\n        for comp_rule_param in comp_rules_params:\n            if comp_rule_param['name'] == param_name:\n                rule_id = comp_rule_param[const.HEADER_RULE_ID]\n                CatalogReader._insert_set_param_into_by_comps(imp_req, rule_id, param_name, param_values, comp_uuid)\n                for statement in as_list(imp_req.statements):\n                    CatalogReader._insert_set_param_into_by_comps(\n                        statement, rule_id, param_name, param_values, comp_uuid\n                    )\n\n    @staticmethod\n    def _add_set_params_to_item(param_dict: Dict[str, str], item: TypeWithSetParams, param_id: str) -&gt; None:\n        value_list = param_dict[const.SSP_VALUES]\n        param_values = value_list\n        new_sp_list = []\n        for sp in as_list(item.set_parameters):\n            if sp.param_id != param_id:\n                new_sp_list.append(sp)\n        item.set_parameters = new_sp_list\n        item.set_parameters.append(ossp.SetParameter(param_id=param_id, values=param_values))\n\n    @staticmethod\n    def _add_props_to_imp_req(\n        control_id: str,\n        part_id_map_by_label: Dict[str, Dict[str, str]],\n        yaml_header: Dict[str, Any],\n        imp_req: ossp.ImplementedRequirement\n    ) -&gt; None:\n        \"\"\"Add the props from the yaml header to the imp_req.\"\"\"\n        control_part_id_map = part_id_map_by_label.get(control_id, {})\n        props, props_by_id = ControlReader.get_props_list(control_id, control_part_id_map, yaml_header)\n        # add the props at control level\n        if props:\n            imp_req.props = as_list(imp_req.props)\n            imp_req.props.extend(props)\n\n        # add the props at the part level\n        for label, part_id in control_part_id_map.items():\n            props = props_by_id.get(label, [])\n            if not props:\n                continue\n            for statement in as_list(imp_req.statements):\n                if statement.statement_id == part_id:\n                    statement.props = as_list(statement.props)\n                    statement.props.extend(props)\n\n    @staticmethod\n    def _update_ssp_with_md_header(\n        ssp: ossp.SystemSecurityPlan,\n        control_id: str,\n        comp_dict: Dict[str, generic.GenericComponent],\n        part_label_to_id_map: Dict[str, Dict[str, str]],\n        md_header: Dict[str, Dict[str, str]]\n    ) -&gt; None:\n        \"\"\"Update the ssp with info from the header of an ssp control markdown file.\"\"\"\n        # rules param vals go in bycomps of imp_req\n        # param vals go directly in imp_req\n        rules_param_vals_dict = md_header.get(const.COMP_DEF_RULES_PARAM_VALS_TAG, {})\n        imp_req = CatalogReader._get_imp_req_for_control(ssp, control_id)\n        for comp_name, param_dict_list in rules_param_vals_dict.items():\n            for param_dict in as_list(param_dict_list):\n                if const.SSP_VALUES in param_dict:\n                    param_dict['values'] = param_dict['ssp-values']\n                CatalogReader._insert_param_dict_in_imp_req(\n                    imp_req, param_dict, comp_name, md_header, comp_dict[comp_name].uuid\n                )\n        param_vals_dict = md_header.get(const.SET_PARAMS_TAG, {})\n        for param_id, param_dict in param_vals_dict.items():\n            if const.SSP_VALUES in param_dict:\n                CatalogReader._add_set_params_to_item(param_dict, imp_req, param_id)\n\n        CatalogReader._add_props_to_imp_req(control_id, part_label_to_id_map, md_header, imp_req)\n\n    @staticmethod\n    def read_ssp_md_content(\n        md_path: pathlib.Path,\n        ssp: ossp.SystemSecurityPlan,\n        comp_dict: Dict[str, generic.GenericComponent],\n        part_id_map_by_label: Dict[str, Dict[str, str]],\n        context: ControlContext\n    ) -&gt; None:\n        \"\"\"\n        Read md content into the ssp.\n\n        Args:\n            md_path: path to the catalog markdown\n            ssp: ssp in which to insert the md content\n            comp_dict: map of component name to component\n            part_id_map_by_label: map label to part_id of control\n            context: control context for the procedure\n\n        Notes:\n            The ssp should already contain info from the comp defs and this fills in selected content from md.\n            The only content read from md is:\n                ssp values in the comp def rules param vals of the header\n                ssp values in the set-params of the header\n                all prose for implementaton responses\n                all status values\n            ssp has components but may not have all needed imp reqs and bycomps\n            know controlid and comp name in comp_dict\n        \"\"\"\n        for group_path in CatalogInterface._get_group_ids_and_dirs(md_path).values():\n            for control_file in group_path.glob('*.md'):\n                skip = False\n                for file in control_file.parents:\n                    if file.name == const.INHERITANCE_VIEW_DIR:\n                        skip = True\n                        break\n                if skip:\n                    continue\n\n                control_id = control_file.stem\n\n                md_header, control_comp_dict = CatalogReader._read_comp_info_from_md(control_file, context)\n\n                for comp_name, comp_info_dict in control_comp_dict.items():\n                    if comp_name not in comp_dict:\n                        err_msg = f'Control {control_id} references component {comp_name} not defined in a component-definition.'  # noqa E501\n                        # give added guidance if no comp defs were specified at command line\n                        if not context.comp_def_name_list:\n                            err_msg += '  Please specify the names of any component-definitions needed for assembly.'\n                        raise TrestleError(err_msg)\n                    CatalogReader._update_ssp_with_comp_info(\n                        ssp, control_id, comp_dict[comp_name], comp_info_dict, part_id_map_by_label\n                    )\n                CatalogReader._update_ssp_with_md_header(ssp, control_id, comp_dict, part_id_map_by_label, md_header)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader.CatalogReader-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader.CatalogReader.__init__","title":"<code>__init__(catalog_interface)</code>","text":"<p>Initialize catalog reader.</p> Source code in <code>trestle/core/catalog/catalog_reader.py</code> <pre><code>def __init__(self, catalog_interface: CatalogInterface):\n    \"\"\"Initialize catalog reader.\"\"\"\n    self._catalog_interface = catalog_interface\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader.CatalogReader.read_additional_content","title":"<code>read_additional_content(md_path, required_sections_list, label_map, sections_dict, write_mode)</code>","text":"<p>Read all markdown controls and return list of alters plus control param dict and param sort map.</p> Source code in <code>trestle/core/catalog/catalog_reader.py</code> <pre><code>def read_additional_content(\n    self,\n    md_path: pathlib.Path,\n    required_sections_list: List[str],\n    label_map: Dict[str, Dict[str, str]],\n    sections_dict: Dict[str, str],\n    write_mode: bool\n) -&gt; Tuple[List[prof.Alter], Dict[str, Any], Dict[str, str]]:\n    \"\"\"Read all markdown controls and return list of alters plus control param dict and param sort map.\"\"\"\n    alters_map: Dict[str, prof.Alter] = {}\n    final_param_dict: Dict[str, Any] = {}\n    param_sort_map: Dict[str, str] = {}\n    for group_path in CatalogInterface._get_group_ids_and_dirs(md_path).values():\n        for control_file in group_path.glob('*.md'):\n            sort_id, control_alters, control_param_dict = ControlReader.read_editable_content(\n                control_file,\n                required_sections_list,\n                label_map,\n                sections_dict,\n                write_mode\n            )\n            alters_map[sort_id] = control_alters\n            for param_id, param_dict in control_param_dict.items():\n                # if profile_values are present, overwrite values with them\n                if const.PROFILE_VALUES in param_dict:\n                    if param_dict[const.PROFILE_VALUES] != [] and param_dict[const.PROFILE_VALUES] is not None:\n                        if not write_mode and const.REPLACE_ME_PLACEHOLDER in param_dict[const.PROFILE_VALUES]:\n                            param_dict[const.PROFILE_VALUES].remove(const.REPLACE_ME_PLACEHOLDER)\n                        if param_dict[const.PROFILE_VALUES] != [] and param_dict[const.PROFILE_VALUES] is not None:\n                            param_dict[const.VALUES] = param_dict[const.PROFILE_VALUES]\n                    if not write_mode:\n                        param_dict.pop(const.PROFILE_VALUES)\n                # verifies if at control profile edition the param value origin was modified\n                # through the profile-param-value-origin tag\n                if const.PROFILE_PARAM_VALUE_ORIGIN in param_dict:\n                    if param_dict[const.PROFILE_PARAM_VALUE_ORIGIN] != const.REPLACE_ME_PLACEHOLDER:\n                        param_dict[const.PARAM_VALUE_ORIGIN] = param_dict[const.PROFILE_PARAM_VALUE_ORIGIN]\n                        param_dict.pop(const.PROFILE_PARAM_VALUE_ORIGIN)\n                    else:\n                        # removes replace me placeholder and profile-param-value-origin as it was not modified\n                        param_dict.pop(const.PROFILE_PARAM_VALUE_ORIGIN)\n                        # validates param-value-origin is in dict to remove it\n                        # because a value wasn\u00b4t provided and it shouldn\u00b4t be inheriting value from parent\n                        if const.PARAM_VALUE_ORIGIN in param_dict:\n                            param_dict.pop(const.PARAM_VALUE_ORIGIN)\n                final_param_dict[param_id] = param_dict\n                param_sort_map[param_id] = sort_id\n    new_alters: List[prof.Alter] = []\n    # fill the alters according to the control sorting order\n    for key in sorted(alters_map.keys()):\n        new_alters.extend(alters_map[key])\n    return new_alters, final_param_dict, param_sort_map\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_from_markdown","title":"<code>read_catalog_from_markdown(md_path, set_parameters_flag)</code>","text":"<p>Read the groups and catalog controls from the given directory.</p> <p>This will overwrite the existing groups and controls in the catalog.</p> Source code in <code>trestle/core/catalog/catalog_reader.py</code> <pre><code>def read_catalog_from_markdown(self, md_path: pathlib.Path, set_parameters_flag: bool) -&gt; cat.Catalog:\n    \"\"\"\n    Read the groups and catalog controls from the given directory.\n\n    This will overwrite the existing groups and controls in the catalog.\n    \"\"\"\n    id_map = CatalogInterface._get_group_ids_and_dirs(md_path)\n    groups: List[cat.Group] = []\n    # read each group dir\n    for group_id, group_dir in id_map.items():\n        control_list_raw = []\n        group_title = ''\n        # Need to get group title from at least one control in this directory\n        # All controls in dir should have same group title\n        # Set group title to the first one found and warn if different non-empty title appears\n        # Controls with empty group titles are tolerated but at least one title must be present or warning given\n        # The special group with no name that has the catalog as parent is just a list and has no title\n        for control_path in group_dir.glob('*.md'):\n            control, control_group_title = ControlReader.read_control(control_path, set_parameters_flag)\n            if control_group_title:\n                if group_title:\n                    if control_group_title != group_title:\n                        logger.warning(\n                            f'Control {control.id} group title {control_group_title} differs from {group_title}'\n                        )\n                else:\n                    group_title = control_group_title\n            control_list_raw.append(control)\n        control_list = sorted(control_list_raw, key=lambda control: ControlInterface.get_sort_id(control))\n        if group_id:\n            if not group_title:\n                logger.warning(\n                    f'No group title found in controls for group {group_id}.  The title will be recovered if assembling into an existing catalog with the group title defined.'  # noqa E501\n                )\n            new_group = cat.Group(id=group_id, title=group_title)\n            new_group.controls = none_if_empty(control_list)\n            groups.append(new_group)\n        else:\n            # if the list of controls has no group id it also has no title and is just the controls of the catalog\n            self._catalog_interface._catalog.controls = none_if_empty(control_list)\n    self._catalog_interface._catalog.groups = none_if_empty(groups)\n    self._catalog_interface._create_control_dict()\n    self._catalog_interface._catalog.params = none_if_empty(self._catalog_interface._catalog.params)\n    return self._catalog_interface._catalog\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader.CatalogReader.read_catalog_imp_reqs","title":"<code>read_catalog_imp_reqs(md_path, context)</code>  <code>staticmethod</code>","text":"<p>Read the full set of control implemented requirements from markdown.</p> <p>Parameters:</p> Name Type Description Default <code>md_path</code> <code>Path</code> <p>Path to the markdown control files, with directories for each group</p> required <code>context</code> <code>ControlContext</code> <p>Context for the operation</p> required <p>Returns:</p> Type Description <code>List[ImplementedRequirement]</code> <p>List of implemented requirements gathered from each control</p> Notes <p>As the controls are read into the catalog the needed components are added if not already available. avail_comps provides the mapping of component name to the actual component. This is only used during component assemble and only for updating one component</p> Source code in <code>trestle/core/catalog/catalog_reader.py</code> <pre><code>@staticmethod\ndef read_catalog_imp_reqs(md_path: pathlib.Path, context: ControlContext) -&gt; List[comp.ImplementedRequirement]:\n    \"\"\"Read the full set of control implemented requirements from markdown.\n\n    Args:\n        md_path: Path to the markdown control files, with directories for each group\n        context: Context for the operation\n\n    Returns:\n        List of implemented requirements gathered from each control\n\n    Notes:\n        As the controls are read into the catalog the needed components are added if not already available.\n        avail_comps provides the mapping of component name to the actual component.\n        This is only used during component assemble and only for updating one component\n    \"\"\"\n    imp_req_map: Dict[str, comp.ImplementedRequirement] = {}\n    for group_path in CatalogInterface._get_group_ids_and_dirs(md_path).values():\n        for control_file in group_path.glob('*.md'):\n            sort_id, imp_req = ControlReader.read_implemented_requirement(control_file, context)\n            imp_req_map[sort_id] = imp_req\n    return [imp_req_map[key] for key in sorted(imp_req_map.keys())]\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader.CatalogReader.read_ssp_md_content","title":"<code>read_ssp_md_content(md_path, ssp, comp_dict, part_id_map_by_label, context)</code>  <code>staticmethod</code>","text":"<p>Read md content into the ssp.</p> <p>Parameters:</p> Name Type Description Default <code>md_path</code> <code>Path</code> <p>path to the catalog markdown</p> required <code>ssp</code> <code>SystemSecurityPlan</code> <p>ssp in which to insert the md content</p> required <code>comp_dict</code> <code>Dict[str, GenericComponent]</code> <p>map of component name to component</p> required <code>part_id_map_by_label</code> <code>Dict[str, Dict[str, str]]</code> <p>map label to part_id of control</p> required <code>context</code> <code>ControlContext</code> <p>control context for the procedure</p> required Notes <p>The ssp should already contain info from the comp defs and this fills in selected content from md. The only content read from md is:     ssp values in the comp def rules param vals of the header     ssp values in the set-params of the header     all prose for implementaton responses     all status values ssp has components but may not have all needed imp reqs and bycomps know controlid and comp name in comp_dict</p> Source code in <code>trestle/core/catalog/catalog_reader.py</code> <pre><code>@staticmethod\ndef read_ssp_md_content(\n    md_path: pathlib.Path,\n    ssp: ossp.SystemSecurityPlan,\n    comp_dict: Dict[str, generic.GenericComponent],\n    part_id_map_by_label: Dict[str, Dict[str, str]],\n    context: ControlContext\n) -&gt; None:\n    \"\"\"\n    Read md content into the ssp.\n\n    Args:\n        md_path: path to the catalog markdown\n        ssp: ssp in which to insert the md content\n        comp_dict: map of component name to component\n        part_id_map_by_label: map label to part_id of control\n        context: control context for the procedure\n\n    Notes:\n        The ssp should already contain info from the comp defs and this fills in selected content from md.\n        The only content read from md is:\n            ssp values in the comp def rules param vals of the header\n            ssp values in the set-params of the header\n            all prose for implementaton responses\n            all status values\n        ssp has components but may not have all needed imp reqs and bycomps\n        know controlid and comp name in comp_dict\n    \"\"\"\n    for group_path in CatalogInterface._get_group_ids_and_dirs(md_path).values():\n        for control_file in group_path.glob('*.md'):\n            skip = False\n            for file in control_file.parents:\n                if file.name == const.INHERITANCE_VIEW_DIR:\n                    skip = True\n                    break\n            if skip:\n                continue\n\n            control_id = control_file.stem\n\n            md_header, control_comp_dict = CatalogReader._read_comp_info_from_md(control_file, context)\n\n            for comp_name, comp_info_dict in control_comp_dict.items():\n                if comp_name not in comp_dict:\n                    err_msg = f'Control {control_id} references component {comp_name} not defined in a component-definition.'  # noqa E501\n                    # give added guidance if no comp defs were specified at command line\n                    if not context.comp_def_name_list:\n                        err_msg += '  Please specify the names of any component-definitions needed for assembly.'\n                    raise TrestleError(err_msg)\n                CatalogReader._update_ssp_with_comp_info(\n                    ssp, control_id, comp_dict[comp_name], comp_info_dict, part_id_map_by_label\n                )\n            CatalogReader._update_ssp_with_md_header(ssp, control_id, comp_dict, part_id_map_by_label, md_header)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_reader/#trestle.core.catalog.catalog_reader-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog/catalog_writer/","title":"trestle.core.catalog.catalog_writer","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer","title":"<code>trestle.core.catalog.catalog_writer</code>","text":"<p>Provide interface to write OSCAL catalog to markdown.</p>"},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer.CatalogWriter","title":"<code>CatalogWriter</code>","text":"<p>Catalog writer.</p> <p>Catalog writer handles all operation related to writing catalog to markdown.</p> Source code in <code>trestle/core/catalog/catalog_writer.py</code> <pre><code>class CatalogWriter():\n    \"\"\"\n    Catalog writer.\n\n    Catalog writer handles all operation related to writing\n    catalog to markdown.\n    \"\"\"\n\n    def __init__(self, catalog_interface: CatalogInterface):\n        \"\"\"Initialize catalog writer.\"\"\"\n        self._catalog_interface = catalog_interface\n\n    def write_catalog_as_profile_markdown(\n        self, context: ControlContext, part_id_map: Dict[str, Dict[str, str]], md_alters: List[prof.Alter]\n    ) -&gt; None:\n        \"\"\"Write out the catalog as profile markdown.\"\"\"\n        # Get the list of params for this profile from its set_params\n        # this is just from the set_params\n        profile_set_param_dict = CatalogInterface._get_full_profile_param_dict(context.profile)\n\n        # write out the controls\n        for control in self._catalog_interface.get_all_controls_from_catalog(True):\n            # here we do special handling of how set-parameters merge with the yaml header\n            new_context = ControlContext.clone(context)\n            new_context.merged_header = {}\n\n            new_context = self._add_inherited_props_to_header(new_context, control.id)\n\n            # get all params and vals for this control from the resolved profile catalog with block adds in effect\n            control_param_dict = ControlInterface.get_control_param_dict(control, False)\n            set_param_dict = self._construct_set_parameters_dict(profile_set_param_dict, control_param_dict, context)\n\n            if set_param_dict:\n                self._add_set_params_from_cli_yaml_header_to_header(new_context, set_param_dict, control_param_dict)\n\n            elif const.SET_PARAMS_TAG in new_context.merged_header:\n                # need to cull any params that are not in control\n                pop_list: List[str] = []\n                for key in new_context.merged_header[const.SET_PARAMS_TAG].keys():\n                    if key not in control_param_dict:\n                        pop_list.append(key)\n                for pop in pop_list:\n                    new_context.merged_header[const.SET_PARAMS_TAG].pop(pop)\n\n            found_control_alters = [alter for alter in md_alters if alter.control_id == control.id]\n\n            self._write_control_into_dir(new_context, control, part_id_map, found_control_alters)\n\n    def _add_inherited_props_to_header(self, context: ControlContext, control_id: str) -&gt; ControlContext:\n        \"\"\"Add inherited props to the merged header under inherited tag.\"\"\"\n        if context.inherited_props:\n            inherited_props = context.inherited_props.get(control_id, None)\n            if inherited_props:\n                # build set in order of list so that duplicates will have final value stick, then convert to list\n                unique_props = list({prop['name']: prop for prop in inherited_props}.values())\n                context.merged_header[const.TRESTLE_INHERITED_PROPS_TAG] = unique_props\n\n        return context\n\n    def _add_set_params_from_cli_yaml_header_to_header(\n        self, context: ControlContext, set_param_dict: Dict[str, str], control_param_dict: Dict[str, common.Parameter]\n    ):\n        \"\"\"\n        Add set parameters from the provided cli yaml header to the merged header.\n\n        If overwrite-header-value flag is given\n            - Set-parameters in set_param_dict will be overwritten with those in cli yaml header\n            - No new params from the cli yaml header will be added &lt;- TODO: Is this correct?\n        If ohv flag is NOT given :\n            - Set-parameters from the cli yaml header will be added\n            - Will not overwrite params that are already in set_param_dict\n        \"\"\"\n        if const.SET_PARAMS_TAG not in context.cli_yaml_header:\n            context.cli_yaml_header[const.SET_PARAMS_TAG] = {}\n\n        if context.cli_yaml_header:\n            if context.overwrite_header_values:\n                # update the control params with new values\n                for key, value in context.cli_yaml_header[const.SET_PARAMS_TAG].items():\n                    if key in control_param_dict:\n                        set_param_dict[key] = value\n            else:\n                # update the control params with any values in yaml header not set in control\n                # need to maintain order in the set_param_dict\n                for key, value in context.cli_yaml_header[const.SET_PARAMS_TAG].items():\n                    if key in control_param_dict and key not in set_param_dict:\n                        set_param_dict[key] = value\n        context.merged_header[const.SET_PARAMS_TAG] = set_param_dict\n\n    def _construct_set_parameters_dict(\n        self,\n        profile_set_param_dict: Dict[str, common.Parameter],\n        control_param_dict: Dict[str, Dict[str, Any]],\n        context: ControlContext\n    ) -&gt; Dict[str, Dict[str, Any]]:\n        \"\"\"\n        Build set-parameters dictionary from the given profile.modify.set-parameters and control.params.\n\n        Resulting dictionary will have:\n        - All parameters from the control where:\n            - If control_param in profile.modify.set_params:\n                - Display name (if exists) - from profile\n                - Profile-values - from profile\n                - Values - from control\n            - If control_param is not in profile.modify.set_params:\n                - Values - from control\n        \"\"\"\n        set_param_dict: Dict[str, Dict[str, Any]] = {}\n        for param_id, param_dict in control_param_dict.items():\n            # if the param is in the full_param_dict, load its contents first and mark as profile-values\n            display_name = ''\n            param_value_origin, _ = CatalogInterface._get_param_value_origin_and_ns(param_dict)\n            prof_param_value_origin = ''\n            if param_id in profile_set_param_dict:\n                # get the param from the profile set_param\n                param = profile_set_param_dict[param_id]\n                display_name, _ = CatalogInterface._get_display_name_and_ns(param)\n                prof_param_value_origin, _ = CatalogInterface._get_param_value_origin_and_ns(param)\n                # assign its contents to the dict\n                new_dict = ModelUtils.parameter_to_dict(param, True)\n                if const.VALUES in new_dict:\n                    if context.purpose == ContextPurpose.PROFILE:\n                        new_dict[const.PROFILE_VALUES] = new_dict[const.VALUES]\n                        new_dict.pop(const.VALUES)\n                # validates if parent profile has param-value-origin field\n                if param_value_origin != '' and param_value_origin is not None:\n                    if context.purpose == ContextPurpose.PROFILE:\n                        new_dict[const.PARAM_VALUE_ORIGIN] = param_value_origin\n                # validates if current profile has param-value-origin field and\n                # adds it to prof-param-value-origin\n                if prof_param_value_origin != '' and prof_param_value_origin is not None:\n                    if context.purpose == ContextPurpose.PROFILE:\n                        if const.AGGREGATES not in [prop.name for prop in as_list(param.props)]:\n                            new_dict[const.PROFILE_PARAM_VALUE_ORIGIN] = prof_param_value_origin\n                else:\n                    if const.AGGREGATES not in [prop.name for prop in as_list(param.props)]:\n                        new_dict[const.PROFILE_PARAM_VALUE_ORIGIN] = const.REPLACE_ME_PLACEHOLDER\n                # then insert the original, incoming values as values\n                if param_id in control_param_dict:\n                    orig_param = control_param_dict[param_id]\n                    orig_dict = ModelUtils.parameter_to_dict(orig_param, True)\n                    # pull only the values from the actual control dict\n                    # all the other elements are from the profile set_param\n                    new_dict[const.VALUES] = orig_dict.get(const.VALUES, None)\n                    new_dict[const.GUIDELINES] = orig_dict.get(const.GUIDELINES, None)\n                    if new_dict[const.VALUES] is None:\n                        new_dict.pop(const.VALUES)\n                    if new_dict[const.GUIDELINES] is None:\n                        new_dict.pop(const.GUIDELINES)\n                    if const.AGGREGATES in [prop.name for prop in as_list(orig_param.props)]:\n                        new_dict.pop(const.PROFILE_PARAM_VALUE_ORIGIN)\n            else:\n                # if the profile doesnt change this param at all, show it in the header with values\n                tmp_dict = ModelUtils.parameter_to_dict(param_dict, True)\n                values = tmp_dict.get('values', None)\n                # if values are None then don\u00b4t display them in the markdown\n                if values is not None:\n                    new_dict = {\n                        'id': param_id,\n                        'values': values,\n                    }\n                else:\n                    new_dict = {\n                        'id': param_id,\n                    }\n                new_dict[const.PROFILE_VALUES] = [const.REPLACE_ME_PLACEHOLDER]\n                new_dict[const.PROFILE_PARAM_VALUE_ORIGIN] = const.REPLACE_ME_PLACEHOLDER\n            if param_value_origin is not None:\n                if context.purpose == ContextPurpose.PROFILE:\n                    new_dict[const.PARAM_VALUE_ORIGIN] = param_value_origin\n            new_dict.pop('id', None)\n            # validates if there are aggregated parameter values to the current parameter\n            aggregated_props = [prop for prop in as_list(param_dict.props) if prop.name == const.AGGREGATES]\n            if aggregated_props != []:\n                props_to_add = []\n                for prop in aggregated_props:\n                    props_to_add.append(prop.value)\n                new_dict[const.AGGREGATES] = props_to_add\n                new_dict.pop(const.PROFILE_VALUES, None)\n            alt_identifier = [prop for prop in as_list(param_dict.props) if prop.name == const.ALT_IDENTIFIER]\n            if alt_identifier != []:\n                new_dict[const.ALT_IDENTIFIER] = alt_identifier[0].value\n            # adds display name, if no display name then do not add to dict\n            if display_name != '' and display_name is not None:\n                new_dict[const.DISPLAY_NAME] = display_name\n            key_order = (\n                const.LABEL,\n                const.GUIDELINES,\n                const.VALUES,\n                const.AGGREGATES,\n                const.ALT_IDENTIFIER,\n                const.DISPLAY_NAME,\n                const.PROFILE_VALUES,\n                const.PARAM_VALUE_ORIGIN,\n                const.PROFILE_PARAM_VALUE_ORIGIN\n            )\n            ordered_dict = {k: new_dict[k] for k in key_order if k in new_dict.keys()}\n            set_param_dict[param_id] = ordered_dict\n\n        return set_param_dict\n\n    @staticmethod\n    def _fixup_param_dicts(context: ControlContext) -&gt; None:\n        \"\"\"Merge info in the rules params dict and the rules param vals dict.\"\"\"\n        for comp_name, comp_dict in context.rules_params_dict.items():\n            rules_dict = context.rules_dict.get(comp_name, {})\n            for rule_id, params_list in comp_dict.items():\n                for param in params_list:\n                    rule_name = deep_get(rules_dict, [rule_id, 'name'], 'unknown_rule_name')\n                    param[const.HEADER_RULE_ID] = rule_name\n\n    def write_catalog_as_ssp_markdown(self, context: ControlContext, part_id_map: Dict[str, Dict[str, str]]) -&gt; None:\n        \"\"\"\n        Write out the catalog as component markdown.\n\n        Already have resolved profile catalog, but with no setparams from compdefs\n        Load all control level rules and param values based on compdefs and profile values\n\n        In memory:\n        for each compdef:\n            for each comp:\n                load top level rules\n                for each control_imp:\n                    load set-params\n                    for each imp_req (bound to 1 control):\n                        load set-params\n                        load control level rules and status\n                        load part level rules and status\n                        add as compinfo to control comp_dict\n\n        \"\"\"\n        # generate rule and param info from the components\n        self._catalog_interface.generate_control_rule_info(part_id_map, context)\n\n        # now have all rules in context.rules_dict and all rules_params in context.rules_params_dict\n        # all set-params per component for each control are in the cat interface\n        # all comp-infos by control and part are in the cat interface\n        #\n        # can now write out catalog and pull from the markdown:\n        # header for param values to set during assem\n        # prose and status for This System\n        # status for all parts that still have rules\n\n        CatalogWriter._fixup_param_dicts(context)\n\n        # remove items left after above loop\n        context.component = None\n        context.comp_name = None\n\n        # get param_dict of set_params in profile\n        profile_set_param_dict = CatalogInterface._get_full_profile_param_dict(context.profile)\n        catalog_merger = CatalogMerger(self._catalog_interface)\n        for control in self._catalog_interface.get_all_controls_from_dict():\n            control_id = control.id\n            context.comp_dict = self._catalog_interface._control_comp_dicts.get(control_id, {})\n            control_file_path = self._catalog_interface.get_control_file_path(context.md_root, control_id)\n            control_file_path.parent.mkdir(exist_ok=True, parents=True)\n            # the catalog interface is from the resolved profile catalog\n            control = self._catalog_interface.get_control(control_id)\n            _, group_title, _ = self._catalog_interface.get_group_info_by_control(control_id)\n            control_param_dict = ControlInterface.get_control_param_dict(control, False)\n            set_param_dict = self._construct_set_parameters_dict(profile_set_param_dict, control_param_dict, context)\n            new_context = ControlContext.clone(context)\n\n            if set_param_dict:\n                self._add_set_params_from_cli_yaml_header_to_header(new_context, set_param_dict, control_param_dict)\n\n            elif const.SET_PARAMS_TAG in new_context.merged_header:\n                # need to cull any params that are not in control\n                pop_list: List[str] = []\n                for key in new_context.merged_header[const.SET_PARAMS_TAG].keys():\n                    if key not in control_param_dict:\n                        pop_list.append(key)\n                for pop in pop_list:\n                    new_context.merged_header[const.SET_PARAMS_TAG].pop(pop)\n\n            # merge the md_header and md_comp_dict with info in cat_interface for this control in new_context\n            catalog_merger._merge_header_and_comp_dict(control, control_file_path, new_context)\n\n            if const.COMP_DEF_RULES_PARAM_VALS_TAG in new_context.merged_header:\n                for _, param_list in new_context.merged_header[const.COMP_DEF_RULES_PARAM_VALS_TAG].items():\n                    for param_dict in param_list:\n                        param_dict.pop(const.HEADER_RULE_ID, None)\n\n            control_writer = ControlWriter()\n            control_writer.write_control_for_editing(\n                new_context, control, control_file_path.parent, group_title, part_id_map, []\n            )\n\n    def write_catalog_as_component_markdown(\n        self, context: ControlContext, part_id_map: Dict[str, Dict[str, str]]\n    ) -&gt; None:\n        \"\"\"Write out the catalog as component markdown.\"\"\"\n        context.rules_dict = {}\n        context.rules_params_dict = {}\n\n        def _update_values(set_param: comp.SetParameter, control_param_dict) -&gt; None:\n            # set the param values based on the control_param_dict if available\n            if set_param.param_id in control_param_dict:\n                control_param_dict[set_param.param_id] = set_param\n\n        control_ids_in_comp_imp = [\n            imp_req.control_id for imp_req in as_list(context.control_implementation.implemented_requirements)\n        ]\n\n        missing_controls = set(control_ids_in_comp_imp).difference(self._catalog_interface.get_control_ids())\n        if missing_controls:\n            logger.warning(f'Component {context.comp_name} references controls {missing_controls} not in profile.')\n\n        # get top level rule info applying to all controls\n        comp_rules_dict, comp_rules_params_dict, _ = ControlInterface.get_rules_and_params_dict_from_item(context.component)  # noqa E501\n        context.rules_dict[context.comp_name] = comp_rules_dict\n        context.rules_params_dict[context.comp_name] = comp_rules_params_dict\n        for control_imp in as_list(context.component.control_implementations):\n            control_imp_rules_dict, control_imp_rules_params_dict, _ = ControlInterface.get_rules_and_params_dict_from_item(control_imp)  # noqa E501\n            context.rules_dict[context.comp_name].update(control_imp_rules_dict)\n            comp_rules_params_dict = context.rules_params_dict.get(context.comp_name, {})\n            comp_rules_params_dict.update(control_imp_rules_params_dict)\n            context.rules_params_dict[context.comp_name].update(comp_rules_params_dict)\n            ci_set_params = ControlInterface.get_set_params_from_item(control_imp)\n            for imp_req in as_list(control_imp.implemented_requirements):\n                control_part_id_map = part_id_map.get(imp_req.control_id, {})\n                status = ControlInterface.get_status_from_props(imp_req)\n                control_rules, _ = ControlInterface.get_rule_list_for_item(imp_req)\n                comp_info = ComponentImpInfo(imp_req.description, control_rules, [], status)\n                self._catalog_interface.add_comp_info(imp_req.control_id, context.comp_name, '', comp_info)\n                set_params = copy.deepcopy(ci_set_params)\n                set_params.update(ControlInterface.get_set_params_from_item(imp_req))\n                for set_param in set_params.values():\n                    self._catalog_interface.add_comp_set_param(imp_req.control_id, context.comp_name, set_param)\n                for statement in as_list(imp_req.statements):\n                    status = ControlInterface.get_status_from_props(statement)\n                    if statement.statement_id not in control_part_id_map:\n                        label = statement.statement_id\n                        logger.warning(f'No statement label found for statement id {label}.  Defaulting to {label}.')\n                    else:\n                        label = control_part_id_map[statement.statement_id]\n                    rule_list, _ = ControlInterface.get_rule_list_for_item(statement)\n                    comp_info = ComponentImpInfo(statement.description, rule_list, [], status)\n                    self._catalog_interface.add_comp_info(imp_req.control_id, context.comp_name, label, comp_info)\n\n        catalog_merger = CatalogMerger(self._catalog_interface)\n\n        for control in self._catalog_interface.get_all_controls_from_catalog(True):\n            if control.id in control_ids_in_comp_imp:\n                context.comp_dict = self._catalog_interface.get_comp_info(control.id)\n                new_context = ControlContext.clone(context)\n                # get the resolved catalog values for the control params\n                control_param_dict = ControlInterface.get_control_param_dict(control, False)\n                # update them with values in the ci\n                for set_param in as_list(new_context.control_implementation.set_parameters):\n                    _update_values(set_param, control_param_dict)\n                # update them with values in the imp_req\n                for imp_req in as_list(new_context.control_implementation.implemented_requirements):\n                    if imp_req.control_id == control.id:\n                        for set_param in as_list(imp_req.set_parameters):\n                            _update_values(set_param, control_param_dict)\n\n                # insert the param values into the header\n                if control_param_dict:\n                    new_context.merged_header[const.PARAM_VALUES_TAG] = {}\n                    for key, param in control_param_dict.items():\n                        new_context.merged_header[const.PARAM_VALUES_TAG][key] = none_if_empty(\n                            ControlInterface._param_values_as_str_list(param)\n                        )\n                # merge the md_header and md_comp_dict with info in cat_interface for this control\n                control_file_path = self._catalog_interface.get_control_file_path(context.md_root, control.id)\n                catalog_merger._merge_header_and_comp_dict(control, control_file_path, new_context)\n\n                self._write_control_into_dir(new_context, control, part_id_map, [])\n\n    def write_catalog_as_catalog(self, context: ControlContext, part_id_map: Dict[str, Dict[str, str]]) -&gt; None:\n        \"\"\"Write the catalog as a simple catalog.\"\"\"\n        # write out the controls\n        for control in self._catalog_interface.get_all_controls_from_catalog(True):\n            # here we do special handling of how set-parameters merge with the yaml header\n            new_context = ControlContext.clone(context)\n\n            control_param_dict = ControlInterface.get_control_param_dict(control, False)\n            set_param_dict: Dict[str, str] = {}\n            for param_id, param_dict in control_param_dict.items():\n                tmp_dict = ModelUtils.parameter_to_dict(param_dict, True)\n                values = tmp_dict.get('values', None)\n                new_dict = {'values': values}\n                set_param_dict[param_id] = new_dict\n            if set_param_dict:\n                if const.SET_PARAMS_TAG not in new_context.cli_yaml_header:\n                    new_context.cli_yaml_header[const.SET_PARAMS_TAG] = {}\n                if new_context.overwrite_header_values:\n                    # update the control params with new values\n                    for key, value in new_context.cli_yaml_header[const.SET_PARAMS_TAG].items():\n                        if key in control_param_dict:\n                            set_param_dict[key] = value\n                else:\n                    # update the control params with any values in yaml header not set in control\n                    # need to maintain order in the set_param_dict\n                    for key, value in new_context.cli_yaml_header[const.SET_PARAMS_TAG].items():\n                        if key in control_param_dict and key not in set_param_dict:\n                            set_param_dict[key] = value\n                new_context.cli_yaml_header[const.SET_PARAMS_TAG] = set_param_dict\n            elif const.SET_PARAMS_TAG in new_context.cli_yaml_header:\n                # need to cull any params that are not in control\n                pop_list: List[str] = []\n                for key in new_context.cli_yaml_header[const.SET_PARAMS_TAG].keys():\n                    if key not in control_param_dict:\n                        pop_list.append(key)\n                for pop in pop_list:\n                    new_context.cli_yaml_header[const.SET_PARAMS_TAG].pop(pop)\n\n            self._write_control_into_dir(new_context, control, part_id_map, [])\n\n    def _write_control_into_dir(\n        self,\n        context: ControlContext,\n        control: cat.Control,\n        part_id_map: Dict[str, Dict[str, str]],\n        found_control_alters: List[prof.Alter]\n    ):\n        # we need to create the dir structure on demand because we don't know a priori what groups are included\n        _, group_title, _ = self._catalog_interface.get_group_info_by_control(control.id)\n        group_dir = context.md_root\n        control_path = self._catalog_interface.get_control_path(control.id)\n        for sub_dir in control_path:\n            group_dir = group_dir / sub_dir\n            if not group_dir.exists():\n                group_dir.mkdir(parents=True, exist_ok=True)\n\n        writer = ControlWriter()\n        writer.write_control_for_editing(context, control, group_dir, group_title, part_id_map, found_control_alters)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer.CatalogWriter-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer.CatalogWriter.__init__","title":"<code>__init__(catalog_interface)</code>","text":"<p>Initialize catalog writer.</p> Source code in <code>trestle/core/catalog/catalog_writer.py</code> <pre><code>def __init__(self, catalog_interface: CatalogInterface):\n    \"\"\"Initialize catalog writer.\"\"\"\n    self._catalog_interface = catalog_interface\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_catalog","title":"<code>write_catalog_as_catalog(context, part_id_map)</code>","text":"<p>Write the catalog as a simple catalog.</p> Source code in <code>trestle/core/catalog/catalog_writer.py</code> <pre><code>def write_catalog_as_catalog(self, context: ControlContext, part_id_map: Dict[str, Dict[str, str]]) -&gt; None:\n    \"\"\"Write the catalog as a simple catalog.\"\"\"\n    # write out the controls\n    for control in self._catalog_interface.get_all_controls_from_catalog(True):\n        # here we do special handling of how set-parameters merge with the yaml header\n        new_context = ControlContext.clone(context)\n\n        control_param_dict = ControlInterface.get_control_param_dict(control, False)\n        set_param_dict: Dict[str, str] = {}\n        for param_id, param_dict in control_param_dict.items():\n            tmp_dict = ModelUtils.parameter_to_dict(param_dict, True)\n            values = tmp_dict.get('values', None)\n            new_dict = {'values': values}\n            set_param_dict[param_id] = new_dict\n        if set_param_dict:\n            if const.SET_PARAMS_TAG not in new_context.cli_yaml_header:\n                new_context.cli_yaml_header[const.SET_PARAMS_TAG] = {}\n            if new_context.overwrite_header_values:\n                # update the control params with new values\n                for key, value in new_context.cli_yaml_header[const.SET_PARAMS_TAG].items():\n                    if key in control_param_dict:\n                        set_param_dict[key] = value\n            else:\n                # update the control params with any values in yaml header not set in control\n                # need to maintain order in the set_param_dict\n                for key, value in new_context.cli_yaml_header[const.SET_PARAMS_TAG].items():\n                    if key in control_param_dict and key not in set_param_dict:\n                        set_param_dict[key] = value\n            new_context.cli_yaml_header[const.SET_PARAMS_TAG] = set_param_dict\n        elif const.SET_PARAMS_TAG in new_context.cli_yaml_header:\n            # need to cull any params that are not in control\n            pop_list: List[str] = []\n            for key in new_context.cli_yaml_header[const.SET_PARAMS_TAG].keys():\n                if key not in control_param_dict:\n                    pop_list.append(key)\n            for pop in pop_list:\n                new_context.cli_yaml_header[const.SET_PARAMS_TAG].pop(pop)\n\n        self._write_control_into_dir(new_context, control, part_id_map, [])\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_component_markdown","title":"<code>write_catalog_as_component_markdown(context, part_id_map)</code>","text":"<p>Write out the catalog as component markdown.</p> Source code in <code>trestle/core/catalog/catalog_writer.py</code> <pre><code>def write_catalog_as_component_markdown(\n    self, context: ControlContext, part_id_map: Dict[str, Dict[str, str]]\n) -&gt; None:\n    \"\"\"Write out the catalog as component markdown.\"\"\"\n    context.rules_dict = {}\n    context.rules_params_dict = {}\n\n    def _update_values(set_param: comp.SetParameter, control_param_dict) -&gt; None:\n        # set the param values based on the control_param_dict if available\n        if set_param.param_id in control_param_dict:\n            control_param_dict[set_param.param_id] = set_param\n\n    control_ids_in_comp_imp = [\n        imp_req.control_id for imp_req in as_list(context.control_implementation.implemented_requirements)\n    ]\n\n    missing_controls = set(control_ids_in_comp_imp).difference(self._catalog_interface.get_control_ids())\n    if missing_controls:\n        logger.warning(f'Component {context.comp_name} references controls {missing_controls} not in profile.')\n\n    # get top level rule info applying to all controls\n    comp_rules_dict, comp_rules_params_dict, _ = ControlInterface.get_rules_and_params_dict_from_item(context.component)  # noqa E501\n    context.rules_dict[context.comp_name] = comp_rules_dict\n    context.rules_params_dict[context.comp_name] = comp_rules_params_dict\n    for control_imp in as_list(context.component.control_implementations):\n        control_imp_rules_dict, control_imp_rules_params_dict, _ = ControlInterface.get_rules_and_params_dict_from_item(control_imp)  # noqa E501\n        context.rules_dict[context.comp_name].update(control_imp_rules_dict)\n        comp_rules_params_dict = context.rules_params_dict.get(context.comp_name, {})\n        comp_rules_params_dict.update(control_imp_rules_params_dict)\n        context.rules_params_dict[context.comp_name].update(comp_rules_params_dict)\n        ci_set_params = ControlInterface.get_set_params_from_item(control_imp)\n        for imp_req in as_list(control_imp.implemented_requirements):\n            control_part_id_map = part_id_map.get(imp_req.control_id, {})\n            status = ControlInterface.get_status_from_props(imp_req)\n            control_rules, _ = ControlInterface.get_rule_list_for_item(imp_req)\n            comp_info = ComponentImpInfo(imp_req.description, control_rules, [], status)\n            self._catalog_interface.add_comp_info(imp_req.control_id, context.comp_name, '', comp_info)\n            set_params = copy.deepcopy(ci_set_params)\n            set_params.update(ControlInterface.get_set_params_from_item(imp_req))\n            for set_param in set_params.values():\n                self._catalog_interface.add_comp_set_param(imp_req.control_id, context.comp_name, set_param)\n            for statement in as_list(imp_req.statements):\n                status = ControlInterface.get_status_from_props(statement)\n                if statement.statement_id not in control_part_id_map:\n                    label = statement.statement_id\n                    logger.warning(f'No statement label found for statement id {label}.  Defaulting to {label}.')\n                else:\n                    label = control_part_id_map[statement.statement_id]\n                rule_list, _ = ControlInterface.get_rule_list_for_item(statement)\n                comp_info = ComponentImpInfo(statement.description, rule_list, [], status)\n                self._catalog_interface.add_comp_info(imp_req.control_id, context.comp_name, label, comp_info)\n\n    catalog_merger = CatalogMerger(self._catalog_interface)\n\n    for control in self._catalog_interface.get_all_controls_from_catalog(True):\n        if control.id in control_ids_in_comp_imp:\n            context.comp_dict = self._catalog_interface.get_comp_info(control.id)\n            new_context = ControlContext.clone(context)\n            # get the resolved catalog values for the control params\n            control_param_dict = ControlInterface.get_control_param_dict(control, False)\n            # update them with values in the ci\n            for set_param in as_list(new_context.control_implementation.set_parameters):\n                _update_values(set_param, control_param_dict)\n            # update them with values in the imp_req\n            for imp_req in as_list(new_context.control_implementation.implemented_requirements):\n                if imp_req.control_id == control.id:\n                    for set_param in as_list(imp_req.set_parameters):\n                        _update_values(set_param, control_param_dict)\n\n            # insert the param values into the header\n            if control_param_dict:\n                new_context.merged_header[const.PARAM_VALUES_TAG] = {}\n                for key, param in control_param_dict.items():\n                    new_context.merged_header[const.PARAM_VALUES_TAG][key] = none_if_empty(\n                        ControlInterface._param_values_as_str_list(param)\n                    )\n            # merge the md_header and md_comp_dict with info in cat_interface for this control\n            control_file_path = self._catalog_interface.get_control_file_path(context.md_root, control.id)\n            catalog_merger._merge_header_and_comp_dict(control, control_file_path, new_context)\n\n            self._write_control_into_dir(new_context, control, part_id_map, [])\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_profile_markdown","title":"<code>write_catalog_as_profile_markdown(context, part_id_map, md_alters)</code>","text":"<p>Write out the catalog as profile markdown.</p> Source code in <code>trestle/core/catalog/catalog_writer.py</code> <pre><code>def write_catalog_as_profile_markdown(\n    self, context: ControlContext, part_id_map: Dict[str, Dict[str, str]], md_alters: List[prof.Alter]\n) -&gt; None:\n    \"\"\"Write out the catalog as profile markdown.\"\"\"\n    # Get the list of params for this profile from its set_params\n    # this is just from the set_params\n    profile_set_param_dict = CatalogInterface._get_full_profile_param_dict(context.profile)\n\n    # write out the controls\n    for control in self._catalog_interface.get_all_controls_from_catalog(True):\n        # here we do special handling of how set-parameters merge with the yaml header\n        new_context = ControlContext.clone(context)\n        new_context.merged_header = {}\n\n        new_context = self._add_inherited_props_to_header(new_context, control.id)\n\n        # get all params and vals for this control from the resolved profile catalog with block adds in effect\n        control_param_dict = ControlInterface.get_control_param_dict(control, False)\n        set_param_dict = self._construct_set_parameters_dict(profile_set_param_dict, control_param_dict, context)\n\n        if set_param_dict:\n            self._add_set_params_from_cli_yaml_header_to_header(new_context, set_param_dict, control_param_dict)\n\n        elif const.SET_PARAMS_TAG in new_context.merged_header:\n            # need to cull any params that are not in control\n            pop_list: List[str] = []\n            for key in new_context.merged_header[const.SET_PARAMS_TAG].keys():\n                if key not in control_param_dict:\n                    pop_list.append(key)\n            for pop in pop_list:\n                new_context.merged_header[const.SET_PARAMS_TAG].pop(pop)\n\n        found_control_alters = [alter for alter in md_alters if alter.control_id == control.id]\n\n        self._write_control_into_dir(new_context, control, part_id_map, found_control_alters)\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer.CatalogWriter.write_catalog_as_ssp_markdown","title":"<code>write_catalog_as_ssp_markdown(context, part_id_map)</code>","text":"<p>Write out the catalog as component markdown.</p> <p>Already have resolved profile catalog, but with no setparams from compdefs Load all control level rules and param values based on compdefs and profile values</p> <p>In memory: for each compdef:     for each comp:         load top level rules         for each control_imp:             load set-params             for each imp_req (bound to 1 control):                 load set-params                 load control level rules and status                 load part level rules and status                 add as compinfo to control comp_dict</p> Source code in <code>trestle/core/catalog/catalog_writer.py</code> <pre><code>def write_catalog_as_ssp_markdown(self, context: ControlContext, part_id_map: Dict[str, Dict[str, str]]) -&gt; None:\n    \"\"\"\n    Write out the catalog as component markdown.\n\n    Already have resolved profile catalog, but with no setparams from compdefs\n    Load all control level rules and param values based on compdefs and profile values\n\n    In memory:\n    for each compdef:\n        for each comp:\n            load top level rules\n            for each control_imp:\n                load set-params\n                for each imp_req (bound to 1 control):\n                    load set-params\n                    load control level rules and status\n                    load part level rules and status\n                    add as compinfo to control comp_dict\n\n    \"\"\"\n    # generate rule and param info from the components\n    self._catalog_interface.generate_control_rule_info(part_id_map, context)\n\n    # now have all rules in context.rules_dict and all rules_params in context.rules_params_dict\n    # all set-params per component for each control are in the cat interface\n    # all comp-infos by control and part are in the cat interface\n    #\n    # can now write out catalog and pull from the markdown:\n    # header for param values to set during assem\n    # prose and status for This System\n    # status for all parts that still have rules\n\n    CatalogWriter._fixup_param_dicts(context)\n\n    # remove items left after above loop\n    context.component = None\n    context.comp_name = None\n\n    # get param_dict of set_params in profile\n    profile_set_param_dict = CatalogInterface._get_full_profile_param_dict(context.profile)\n    catalog_merger = CatalogMerger(self._catalog_interface)\n    for control in self._catalog_interface.get_all_controls_from_dict():\n        control_id = control.id\n        context.comp_dict = self._catalog_interface._control_comp_dicts.get(control_id, {})\n        control_file_path = self._catalog_interface.get_control_file_path(context.md_root, control_id)\n        control_file_path.parent.mkdir(exist_ok=True, parents=True)\n        # the catalog interface is from the resolved profile catalog\n        control = self._catalog_interface.get_control(control_id)\n        _, group_title, _ = self._catalog_interface.get_group_info_by_control(control_id)\n        control_param_dict = ControlInterface.get_control_param_dict(control, False)\n        set_param_dict = self._construct_set_parameters_dict(profile_set_param_dict, control_param_dict, context)\n        new_context = ControlContext.clone(context)\n\n        if set_param_dict:\n            self._add_set_params_from_cli_yaml_header_to_header(new_context, set_param_dict, control_param_dict)\n\n        elif const.SET_PARAMS_TAG in new_context.merged_header:\n            # need to cull any params that are not in control\n            pop_list: List[str] = []\n            for key in new_context.merged_header[const.SET_PARAMS_TAG].keys():\n                if key not in control_param_dict:\n                    pop_list.append(key)\n            for pop in pop_list:\n                new_context.merged_header[const.SET_PARAMS_TAG].pop(pop)\n\n        # merge the md_header and md_comp_dict with info in cat_interface for this control in new_context\n        catalog_merger._merge_header_and_comp_dict(control, control_file_path, new_context)\n\n        if const.COMP_DEF_RULES_PARAM_VALS_TAG in new_context.merged_header:\n            for _, param_list in new_context.merged_header[const.COMP_DEF_RULES_PARAM_VALS_TAG].items():\n                for param_dict in param_list:\n                    param_dict.pop(const.HEADER_RULE_ID, None)\n\n        control_writer = ControlWriter()\n        control_writer.write_control_for_editing(\n            new_context, control, control_file_path.parent, group_title, part_id_map, []\n        )\n</code></pre>"},{"location":"reference/API/trestle/core/catalog/catalog_writer/#trestle.core.catalog.catalog_writer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/add/","title":"trestle.core.commands.add","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/add/#trestle.core.commands.add","title":"<code>trestle.core.commands.add</code>","text":"<p>Trestle Add Command.</p>"},{"location":"reference/API/trestle/core/commands/add/#trestle.core.commands.add-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/add/#trestle.core.commands.add.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/add/#trestle.core.commands.add-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/add/#trestle.core.commands.add.Add","title":"<code>Add</code>","text":"<p>Class supporting Add of an OSCAL object to a provided file based on element path.</p> Examples of element paths <p>catalog.metadata catalog.controls.control assessment-results.results.</p> <p>The method first finds the parent model from the file and loads the file into the model. Then the method executes 'add' for each of the element paths specified. Add was originally its own command but has been incorporated into the Create command.</p> Source code in <code>trestle/core/commands/add.py</code> <pre><code>class Add():\n    \"\"\"\n    Class supporting Add of an OSCAL object to a provided file based on element path.\n\n    Examples of element paths:\n        catalog.metadata\n        catalog.controls.control\n        assessment-results.results.\n\n    The method first finds the parent model from the file and loads the file into the model.\n    Then the method executes 'add' for each of the element paths specified.\n    Add was originally its own command but has been incorporated into the Create command.\n    \"\"\"\n\n    def add_from_args(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"Parse args for add element to file.\"\"\"\n        file_path = pathlib.Path(args.file).resolve()\n\n        # Get parent model and then load json into parent model\n        parent_model, _ = ModelUtils.get_stripped_model_type(file_path, args.trestle_root)\n        parent_object = parent_model.oscal_read(file_path)\n        parent_element = Element(parent_object, classname_to_alias(parent_model.__name__, AliasMode.JSON))\n\n        add_plan = Plan()\n        # Do _add for each element_path specified in args\n        element_paths: List[str] = args.element.split(',')\n        for elm_path_str in element_paths:\n            element_path = ElementPath(elm_path_str)\n            update_action, parent_element = self.add(element_path, parent_element, args.include_optional_fields)\n            add_plan.add_action(update_action)\n\n        create_action = CreatePathAction(file_path, True)\n        # this will output json or yaml based on type of input file\n        write_action = WriteFileAction(file_path, parent_element, FileContentType.to_content_type(file_path.suffix))\n\n        add_plan.add_action(create_action)\n        add_plan.add_action(write_action)\n\n        add_plan.execute()\n        return CmdReturnCodes.SUCCESS.value\n\n    @staticmethod\n    def add(element_path: ElementPath, parent_element: Element, include_optional: bool) -&gt; Tuple[UpdateAction, Element]:\n        \"\"\"For a element_path, add a child model to the parent_element of a given parent_model.\n\n        Args:\n            element_path: element path of the item to create within the model\n            parent_element: the parent element that will host the created element\n            include_optional: whether to create optional attributes in the created element\n\n        Notes:\n            First we find the child model at the specified element path and instantiate it with default values.\n            Then we check if there's already existing element at that path, in which case we append the child model\n            to the existing list of dict.\n            Then we set up an action plan to update the model (specified by file_path) in memory, create a file\n            at the same location and write the file.\n            We update the parent_element to prepare for next adds in the chain\n        \"\"\"\n        if '*' in element_path.get_full_path_parts():\n            raise err.TrestleError('trestle add does not support Wildcard element path.')\n        # Get child model\n        try:\n            child_model = element_path.get_type(type(parent_element.get()))\n\n            # Create child element with sample values\n            child_object = gens.generate_sample_model(child_model, include_optional=include_optional)\n\n            if parent_element.get_at(element_path) is not None:\n                # The element already exists\n                if type(parent_element.get_at(element_path)) is list:\n                    child_object = parent_element.get_at(element_path) + child_object\n                elif type(parent_element.get_at(element_path)) is dict:\n                    child_object = {**parent_element.get_at(element_path), **child_object}\n                else:\n                    raise err.TrestleError('Already exists and is not a list or dictionary.')\n\n        except Exception as e:\n            raise err.TrestleError(f'Bad element path. {str(e)}')\n\n        update_action = UpdateAction(\n            sub_element=child_object, dest_element=parent_element, sub_element_path=element_path\n        )\n        parent_element = parent_element.set_at(element_path, child_object)\n\n        return update_action, parent_element\n</code></pre>"},{"location":"reference/API/trestle/core/commands/add/#trestle.core.commands.add.Add-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/add/#trestle.core.commands.add.Add.add","title":"<code>add(element_path, parent_element, include_optional)</code>  <code>staticmethod</code>","text":"<p>For a element_path, add a child model to the parent_element of a given parent_model.</p> <p>Parameters:</p> Name Type Description Default <code>element_path</code> <code>ElementPath</code> <p>element path of the item to create within the model</p> required <code>parent_element</code> <code>Element</code> <p>the parent element that will host the created element</p> required <code>include_optional</code> <code>bool</code> <p>whether to create optional attributes in the created element</p> required Notes <p>First we find the child model at the specified element path and instantiate it with default values. Then we check if there's already existing element at that path, in which case we append the child model to the existing list of dict. Then we set up an action plan to update the model (specified by file_path) in memory, create a file at the same location and write the file. We update the parent_element to prepare for next adds in the chain</p> Source code in <code>trestle/core/commands/add.py</code> <pre><code>@staticmethod\ndef add(element_path: ElementPath, parent_element: Element, include_optional: bool) -&gt; Tuple[UpdateAction, Element]:\n    \"\"\"For a element_path, add a child model to the parent_element of a given parent_model.\n\n    Args:\n        element_path: element path of the item to create within the model\n        parent_element: the parent element that will host the created element\n        include_optional: whether to create optional attributes in the created element\n\n    Notes:\n        First we find the child model at the specified element path and instantiate it with default values.\n        Then we check if there's already existing element at that path, in which case we append the child model\n        to the existing list of dict.\n        Then we set up an action plan to update the model (specified by file_path) in memory, create a file\n        at the same location and write the file.\n        We update the parent_element to prepare for next adds in the chain\n    \"\"\"\n    if '*' in element_path.get_full_path_parts():\n        raise err.TrestleError('trestle add does not support Wildcard element path.')\n    # Get child model\n    try:\n        child_model = element_path.get_type(type(parent_element.get()))\n\n        # Create child element with sample values\n        child_object = gens.generate_sample_model(child_model, include_optional=include_optional)\n\n        if parent_element.get_at(element_path) is not None:\n            # The element already exists\n            if type(parent_element.get_at(element_path)) is list:\n                child_object = parent_element.get_at(element_path) + child_object\n            elif type(parent_element.get_at(element_path)) is dict:\n                child_object = {**parent_element.get_at(element_path), **child_object}\n            else:\n                raise err.TrestleError('Already exists and is not a list or dictionary.')\n\n    except Exception as e:\n        raise err.TrestleError(f'Bad element path. {str(e)}')\n\n    update_action = UpdateAction(\n        sub_element=child_object, dest_element=parent_element, sub_element_path=element_path\n    )\n    parent_element = parent_element.set_at(element_path, child_object)\n\n    return update_action, parent_element\n</code></pre>"},{"location":"reference/API/trestle/core/commands/add/#trestle.core.commands.add.Add.add_from_args","title":"<code>add_from_args(args)</code>","text":"<p>Parse args for add element to file.</p> Source code in <code>trestle/core/commands/add.py</code> <pre><code>def add_from_args(self, args: argparse.Namespace) -&gt; int:\n    \"\"\"Parse args for add element to file.\"\"\"\n    file_path = pathlib.Path(args.file).resolve()\n\n    # Get parent model and then load json into parent model\n    parent_model, _ = ModelUtils.get_stripped_model_type(file_path, args.trestle_root)\n    parent_object = parent_model.oscal_read(file_path)\n    parent_element = Element(parent_object, classname_to_alias(parent_model.__name__, AliasMode.JSON))\n\n    add_plan = Plan()\n    # Do _add for each element_path specified in args\n    element_paths: List[str] = args.element.split(',')\n    for elm_path_str in element_paths:\n        element_path = ElementPath(elm_path_str)\n        update_action, parent_element = self.add(element_path, parent_element, args.include_optional_fields)\n        add_plan.add_action(update_action)\n\n    create_action = CreatePathAction(file_path, True)\n    # this will output json or yaml based on type of input file\n    write_action = WriteFileAction(file_path, parent_element, FileContentType.to_content_type(file_path.suffix))\n\n    add_plan.add_action(create_action)\n    add_plan.add_action(write_action)\n\n    add_plan.execute()\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/add/#trestle.core.commands.add-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/assemble/","title":"trestle.core.commands.assemble","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble","title":"<code>trestle.core.commands.assemble</code>","text":"<p>Trestle Assemble Command.</p>"},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble.AssembleCmd","title":"<code>AssembleCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Assemble all subcomponents from a specified trestle model into a single JSON/YAML file under dist.</p> Source code in <code>trestle/core/commands/assemble.py</code> <pre><code>class AssembleCmd(CommandPlusDocs):\n    \"\"\"Assemble all subcomponents from a specified trestle model into a single JSON/YAML file under dist.\"\"\"\n\n    name = 'assemble'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument('model', help='', choices=const.MODEL_TYPE_LIST)\n        self.add_argument('-n', '--name', help='Name of a single model to assemble.')\n        self.add_argument('-t', '--type', action='store_true', help='Assemble all models of the given type.')\n        self.add_argument(\n            '-x', '--extension', help='Type of file output.', choices=['json', 'yaml', 'yml'], default='json'\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            return self.assemble_model(args.model, args)\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while assembling OSCAL model')\n\n    @classmethod\n    def assemble_model(cls, model_alias: str, args: argparse.Namespace) -&gt; int:\n        \"\"\"Assemble a top level OSCAL model within the trestle dist directory.\"\"\"\n        log.set_log_level_from_args(args)\n        logger.info(f'Assembling models of type {model_alias}.')\n\n        trestle_root = args.trestle_root  # trestle root is set via command line in args. Default is cwd.\n        if not trestle_root or not file_utils.is_valid_project_root(args.trestle_root):\n            raise TrestleRootError(f'Given directory {trestle_root} is not a trestle project.')\n\n        model_names = []\n        if args.name:\n            model_names = [args.name]\n            logger.info(f'Assembling single model of type {model_alias}: {args.name}.')\n        else:\n            model_names = ModelUtils.get_models_of_type(model_alias, trestle_root)\n            nmodels = len(model_names)\n            logger.info(f'Assembling {nmodels} found models of type {model_alias}.')\n        if len(model_names) == 0:\n            logger.info(f'No models found to assemble of type {model_alias}.')\n            return CmdReturnCodes.SUCCESS.value\n\n        for model_name in model_names:\n            # contruct path to the model file name\n            root_model_dir = trestle_root / ModelUtils.model_type_to_model_dir(model_alias)\n\n            model_file_type = file_utils.get_contextual_file_type(root_model_dir / model_name)\n\n            model_file_name = f'{model_alias}{FileContentType.to_file_extension(model_file_type)}'\n            root_model_filepath = root_model_dir / model_name / model_file_name\n\n            if not root_model_filepath.exists():\n                raise TrestleError(f'No top level model file at {root_model_dir}')\n\n            assembled_model = load_validate_model_path(args.trestle_root, root_model_filepath)\n            plural_alias = ModelUtils.model_type_to_model_dir(model_alias)\n\n            assembled_model_dir = trestle_root / const.TRESTLE_DIST_DIR / plural_alias\n\n            assembled_model_filepath = assembled_model_dir / f'{model_name}.{args.extension}'\n\n            plan = Plan()\n            plan.add_action(CreatePathAction(assembled_model_filepath, True))\n            plan.add_action(\n                WriteFileAction(\n                    assembled_model_filepath,\n                    Element(assembled_model),\n                    FileContentType.to_content_type(f'.{args.extension}')\n                )\n            )\n\n            plan.execute()\n\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble.AssembleCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble.AssembleCmd.name","title":"<code>name = 'assemble'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble.AssembleCmd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble.AssembleCmd.assemble_model","title":"<code>assemble_model(model_alias, args)</code>  <code>classmethod</code>","text":"<p>Assemble a top level OSCAL model within the trestle dist directory.</p> Source code in <code>trestle/core/commands/assemble.py</code> <pre><code>@classmethod\ndef assemble_model(cls, model_alias: str, args: argparse.Namespace) -&gt; int:\n    \"\"\"Assemble a top level OSCAL model within the trestle dist directory.\"\"\"\n    log.set_log_level_from_args(args)\n    logger.info(f'Assembling models of type {model_alias}.')\n\n    trestle_root = args.trestle_root  # trestle root is set via command line in args. Default is cwd.\n    if not trestle_root or not file_utils.is_valid_project_root(args.trestle_root):\n        raise TrestleRootError(f'Given directory {trestle_root} is not a trestle project.')\n\n    model_names = []\n    if args.name:\n        model_names = [args.name]\n        logger.info(f'Assembling single model of type {model_alias}: {args.name}.')\n    else:\n        model_names = ModelUtils.get_models_of_type(model_alias, trestle_root)\n        nmodels = len(model_names)\n        logger.info(f'Assembling {nmodels} found models of type {model_alias}.')\n    if len(model_names) == 0:\n        logger.info(f'No models found to assemble of type {model_alias}.')\n        return CmdReturnCodes.SUCCESS.value\n\n    for model_name in model_names:\n        # contruct path to the model file name\n        root_model_dir = trestle_root / ModelUtils.model_type_to_model_dir(model_alias)\n\n        model_file_type = file_utils.get_contextual_file_type(root_model_dir / model_name)\n\n        model_file_name = f'{model_alias}{FileContentType.to_file_extension(model_file_type)}'\n        root_model_filepath = root_model_dir / model_name / model_file_name\n\n        if not root_model_filepath.exists():\n            raise TrestleError(f'No top level model file at {root_model_dir}')\n\n        assembled_model = load_validate_model_path(args.trestle_root, root_model_filepath)\n        plural_alias = ModelUtils.model_type_to_model_dir(model_alias)\n\n        assembled_model_dir = trestle_root / const.TRESTLE_DIST_DIR / plural_alias\n\n        assembled_model_filepath = assembled_model_dir / f'{model_name}.{args.extension}'\n\n        plan = Plan()\n        plan.add_action(CreatePathAction(assembled_model_filepath, True))\n        plan.add_action(\n            WriteFileAction(\n                assembled_model_filepath,\n                Element(assembled_model),\n                FileContentType.to_content_type(f'.{args.extension}')\n            )\n        )\n\n        plan.execute()\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/assemble/#trestle.core.commands.assemble-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/command_docs/","title":"trestle.core.commands.command_docs","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/command_docs/#trestle.core.commands.command_docs","title":"<code>trestle.core.commands.command_docs</code>","text":"<p>Trestle command abstraction.</p> <p>Improves parsing until such a point as ILCLI is fixed.</p>"},{"location":"reference/API/trestle/core/commands/command_docs/#trestle.core.commands.command_docs-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/command_docs/#trestle.core.commands.command_docs.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/command_docs/#trestle.core.commands.command_docs-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/command_docs/#trestle.core.commands.command_docs.CommandBase","title":"<code>CommandBase</code>","text":"<p>               Bases: <code>Command</code></p> <p>Linear extension to the ILCLI interface to use documentation string more.</p> <p>Trestle commands not requiring trestle-root should extend from this class.</p> Source code in <code>trestle/core/commands/command_docs.py</code> <pre><code>class CommandBase(Command):\n    \"\"\"Linear extension to the ILCLI interface to use documentation string more.\n\n    Trestle commands not requiring trestle-root should extend from this class.\n    \"\"\"\n\n    # Example commands extedning from this class - init', 'trestle', 'version', 'partial-object-validate'\n    def __init__(\n        self,\n        parser: Optional[argparse.ArgumentParser] = None,\n        parent: Optional[Command] = None,\n        name: Optional[str] = None,\n        out: Optional[TextIO] = None,\n        err: Optional[TextIO] = None\n    ) -&gt; None:\n        \"\"\"Override default ILCLI behaviour to include class documentation in command help description.\"\"\"\n        super(CommandBase, self).__init__(parser, parent, name, out, err)\n        self.parser.description = self.__doc__\n</code></pre>"},{"location":"reference/API/trestle/core/commands/command_docs/#trestle.core.commands.command_docs.CommandBase-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/command_docs/#trestle.core.commands.command_docs.CommandBase.__init__","title":"<code>__init__(parser=None, parent=None, name=None, out=None, err=None)</code>","text":"<p>Override default ILCLI behaviour to include class documentation in command help description.</p> Source code in <code>trestle/core/commands/command_docs.py</code> <pre><code>def __init__(\n    self,\n    parser: Optional[argparse.ArgumentParser] = None,\n    parent: Optional[Command] = None,\n    name: Optional[str] = None,\n    out: Optional[TextIO] = None,\n    err: Optional[TextIO] = None\n) -&gt; None:\n    \"\"\"Override default ILCLI behaviour to include class documentation in command help description.\"\"\"\n    super(CommandBase, self).__init__(parser, parent, name, out, err)\n    self.parser.description = self.__doc__\n</code></pre>"},{"location":"reference/API/trestle/core/commands/command_docs/#trestle.core.commands.command_docs.CommandPlusDocs","title":"<code>CommandPlusDocs</code>","text":"<p>               Bases: <code>CommandBase</code></p> <p>This class validates trestle-root argument.</p> <p>Trestle commands requiring trestle-root should extend from this class. All commands that extend this class will validate the state of trestle workspace.</p> Source code in <code>trestle/core/commands/command_docs.py</code> <pre><code>class CommandPlusDocs(CommandBase):\n    \"\"\"This class validates trestle-root argument.\n\n    Trestle commands requiring trestle-root should extend from this class.\n    All commands that extend this class will validate the state of trestle workspace.\n    \"\"\"\n\n    def _validate_arguments(self, args: argparse.ArgumentParser) -&gt; int:\n        \"\"\"Check trestle-root argument is a valid trestle root directory.\"\"\"\n        root = file_utils.extract_trestle_project_root(args.trestle_root)  # type: ignore\n        if root is None:\n            logger.error(f'Given directory {args.trestle_root} is not in a valid trestle root directory')\n            return CmdReturnCodes.TRESTLE_ROOT_ERROR.value\n        is_oscal_dir_valid = file_utils.check_oscal_directories(args.trestle_root)  # type: ignore\n        if not is_oscal_dir_valid:\n            return CmdReturnCodes.TRESTLE_ROOT_ERROR.value\n        args.trestle_root = root  # type: ignore\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/create/","title":"trestle.core.commands.create","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/create/#trestle.core.commands.create","title":"<code>trestle.core.commands.create</code>","text":"<p>Trestle Create CommandPlusDocs.</p>"},{"location":"reference/API/trestle/core/commands/create/#trestle.core.commands.create-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/create/#trestle.core.commands.create.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/create/#trestle.core.commands.create-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/create/#trestle.core.commands.create.CreateCmd","title":"<code>CreateCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Create a sample OSCAL model in trestle workspace or create new elements within a given model.</p> Source code in <code>trestle/core/commands/create.py</code> <pre><code>class CreateCmd(CommandPlusDocs):\n    \"\"\"Create a sample OSCAL model in trestle workspace or create new elements within a given model.\"\"\"\n\n    name = 'create'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument('-t', '--type', help='Type of model if created anew.', choices=const.MODEL_TYPE_LIST)\n        self.add_argument('-o', '--output', help='Name of the output created model.')\n        self.add_argument(const.IOF_SHORT, const.IOF_LONG, help=const.IOF_HELP, action='store_true')\n        self.add_argument(\n            '-x', '--extension', help='Type of file output.', choices=['json', 'yaml', 'yml'], default='json'\n        )\n        self.add_argument(\n            '-f', '--file', help='Optional existing OSCAL file that will have elements created within it.', type=str\n        )\n        self.add_argument(\n            '-e', '--element', help='Optional path of element to be created whithin the specified file.', type=str\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"\n        Execute the create command.\n\n        Notes\n            Either a new model will be created of the specified type,\n            or an existing file will have new elements added within it.\n        \"\"\"\n        try:\n            # Normal create path\n            if args.type and args.output:\n                object_type = ElementPath(args.type).get_type()\n                return self.create_object(args.type, object_type, args)\n            # Add path\n            elif args.file and args.element:\n                add = Add()\n                return add.add_from_args(args)\n\n            raise err.TrestleIncorrectArgsError(\n                'Create requires either a model type and output name, or a file and element path.'\n            )\n\n        except Exception as e:  # pragma: no cover\n            return err.handle_generic_command_exception(e, logger, 'Error while creating a sample OSCAL model')\n\n    @classmethod\n    def create_object(cls, model_alias: str, object_type: Type[TopLevelOscalModel], args: argparse.Namespace) -&gt; int:\n        \"\"\"Create a top level OSCAL object within the trestle directory, leveraging functionality in add.\"\"\"\n        log.set_log_level_from_args(args)\n        trestle_root = args.trestle_root  # trestle root is set via command line in args. Default is cwd.\n        if not trestle_root or not file_utils.is_valid_project_root(args.trestle_root):\n            raise err.TrestleRootError(f'Given directory {trestle_root} is not a trestle project.')\n\n        plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n\n        desired_model_dir = trestle_root / plural_path / args.output\n\n        desired_model_path = desired_model_dir / (model_alias + '.' + args.extension)\n\n        if desired_model_path.exists():\n            raise err.TrestleError(f'OSCAL file to be created here: {desired_model_path} exists.')\n\n        # Create sample model.\n        sample_model = generators.generate_sample_model(object_type, include_optional=args.include_optional_fields)\n        # Presuming top level level model not sure how to do the typing for this.\n        sample_model.metadata.title = f'Generic {model_alias} created by trestle named {args.output}.'\n        sample_model.metadata.last_modified = datetime.now().astimezone()\n        sample_model.metadata.oscal_version = trestle.oscal.OSCAL_VERSION\n        sample_model.metadata.version = '0.0.0'\n\n        top_element = Element(sample_model, model_alias)\n\n        create_action = CreatePathAction(desired_model_path.resolve(), True)\n        write_action = WriteFileAction(\n            desired_model_path.resolve(), top_element, FileContentType.to_content_type(desired_model_path.suffix)\n        )\n\n        # create a plan to write the directory and file.\n        create_plan = Plan()\n        create_plan.add_action(create_action)\n        create_plan.add_action(write_action)\n        create_plan.execute()\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/create/#trestle.core.commands.create.CreateCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/create/#trestle.core.commands.create.CreateCmd.name","title":"<code>name = 'create'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/create/#trestle.core.commands.create.CreateCmd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/create/#trestle.core.commands.create.CreateCmd.create_object","title":"<code>create_object(model_alias, object_type, args)</code>  <code>classmethod</code>","text":"<p>Create a top level OSCAL object within the trestle directory, leveraging functionality in add.</p> Source code in <code>trestle/core/commands/create.py</code> <pre><code>@classmethod\ndef create_object(cls, model_alias: str, object_type: Type[TopLevelOscalModel], args: argparse.Namespace) -&gt; int:\n    \"\"\"Create a top level OSCAL object within the trestle directory, leveraging functionality in add.\"\"\"\n    log.set_log_level_from_args(args)\n    trestle_root = args.trestle_root  # trestle root is set via command line in args. Default is cwd.\n    if not trestle_root or not file_utils.is_valid_project_root(args.trestle_root):\n        raise err.TrestleRootError(f'Given directory {trestle_root} is not a trestle project.')\n\n    plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n\n    desired_model_dir = trestle_root / plural_path / args.output\n\n    desired_model_path = desired_model_dir / (model_alias + '.' + args.extension)\n\n    if desired_model_path.exists():\n        raise err.TrestleError(f'OSCAL file to be created here: {desired_model_path} exists.')\n\n    # Create sample model.\n    sample_model = generators.generate_sample_model(object_type, include_optional=args.include_optional_fields)\n    # Presuming top level level model not sure how to do the typing for this.\n    sample_model.metadata.title = f'Generic {model_alias} created by trestle named {args.output}.'\n    sample_model.metadata.last_modified = datetime.now().astimezone()\n    sample_model.metadata.oscal_version = trestle.oscal.OSCAL_VERSION\n    sample_model.metadata.version = '0.0.0'\n\n    top_element = Element(sample_model, model_alias)\n\n    create_action = CreatePathAction(desired_model_path.resolve(), True)\n    write_action = WriteFileAction(\n        desired_model_path.resolve(), top_element, FileContentType.to_content_type(desired_model_path.suffix)\n    )\n\n    # create a plan to write the directory and file.\n    create_plan = Plan()\n    create_plan.add_action(create_action)\n    create_plan.add_action(write_action)\n    create_plan.execute()\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/describe/","title":"trestle.core.commands.describe","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe","title":"<code>trestle.core.commands.describe</code>","text":"<p>Trestle Describe Command.</p>"},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe.DescribeCmd","title":"<code>DescribeCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Describe contents of a model file including optional element path.</p> Source code in <code>trestle/core/commands/describe.py</code> <pre><code>class DescribeCmd(CommandPlusDocs):\n    \"\"\"Describe contents of a model file including optional element path.\"\"\"\n\n    # The only output is via log lines.  No other results or side-effects.\n\n    name = 'describe'\n\n    def _init_arguments(self) -&gt; None:\n        logger.debug('Init arguments')\n        self.add_argument('-f', '--file', help='OSCAL file to import.', type=str, required=True)\n\n        self.add_argument(\n            '-e', '--element', help='Optional name of element in file to describe.', type=str, required=False\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            logger.debug('Entering trestle describe.')\n\n            log.set_log_level_from_args(args)\n\n            if args.file:\n                model_file = pathlib.Path(args.file)\n\n                element = '' if not args.element else args.element.strip(\"'\")\n                results = self.describe(model_file.resolve(), element, args.trestle_root)\n\n                return CmdReturnCodes.SUCCESS.value if len(results) &gt; 0 else CmdReturnCodes.COMMAND_ERROR.value\n            else:\n                raise TrestleIncorrectArgsError('No file specified for command describe.')\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while describing contents of a model')\n\n    @classmethod\n    def _clean_type_string(cls, text: str) -&gt; str:\n        text = text.replace(\"&lt;class '\", '').replace(\"'&gt;\", '')\n        text = text.replace('trestle.oscal.', '')\n        text = text.replace('pydantic.main.', 'stripped.')\n        return text\n\n    @classmethod\n    def _description_text(cls, sub_model: Optional[Union[OscalBaseModel, List[OscalBaseModel]]]) -&gt; str:\n        clip_string = 100\n        if sub_model is None:\n            return 'None'\n        if type(sub_model) is list:\n            n_items = len(sub_model)\n            type_text = 'Unknown' if not n_items else f'{cls._clean_type_string(str(type(sub_model[0])))}'\n            text = f'list of {n_items} items of type {type_text}'\n            return text\n        if type(sub_model) is str:\n            return sub_model if len(sub_model\n                                    ) &lt; clip_string else sub_model[:clip_string] + '[truncated]'  # type: ignore\n        if hasattr(sub_model, 'type_'):\n            return cls._clean_type_string(str(sub_model.type_))\n        return cls._clean_type_string(str(type(sub_model)))\n\n    @classmethod\n    def describe(cls, file_path: pathlib.Path, element_path_str: str, trestle_root: pathlib.Path) -&gt; List[str]:\n        \"\"\"Describe the contents of the file.\n\n        Args:\n            file_path: pathlib.Path Path for model file to describe.\n            element_path_str: Element path of element in model to describe.  Can be ''.\n\n        Returns:\n            The list of lines of text in the description, or an empty list on failure\n        \"\"\"\n        # figure out the model type so we can read it\n        try:\n            model_type, _ = ModelUtils.get_stripped_model_type(file_path, trestle_root)\n            model: OscalBaseModel = model_type.oscal_read(file_path)\n        except TrestleError as e:\n            logger.warning(f'Error loading model {file_path} to describe: {e}')\n            return []\n\n        sub_model = model\n\n        # if an element path was provided, follow the path chain to the desired sub_model\n        if element_path_str:\n            if '*' in element_path_str or ',' in element_path_str:\n                logger.warning('Wildcards and commas are not allowed in the element path for describe.')\n                return []\n\n            if '.' not in element_path_str:\n                logger.warning('The element path for describe must either be omitted or contain at least 2 parts.')\n                return []\n\n            element_paths = utils.parse_element_arg(model, element_path_str)\n\n            sub_model_element = Element(model)\n\n            for element_path in element_paths:\n                sub_model = sub_model_element.get_at(element_path, False)\n                sub_model_element = Element(sub_model)\n\n        # now that we have the desired sub_model we can describe it\n\n        text_out: List[str] = []\n\n        # create top level text depending on whether an element path was used\n        element_text = '' if not element_path_str else f' at element path {element_path_str}'\n\n        if type(sub_model) is list:\n            text = f'Model file {file_path}{element_text} is a {cls._description_text(sub_model)}'\n            text_out.append(text)\n            logger.info(text)\n        else:\n            text = f'Model file {file_path}{element_text} is of type '\n            text += f'{cls._clean_type_string(str(type(sub_model)))} and contains:'\n            text_out.append(text)\n            logger.info(text)\n            for key in sub_model.__fields__.keys():\n                value = getattr(sub_model, key, None)\n                text = f'    {key}: {cls._description_text(value)}'\n                text_out.append(text)\n                logger.info(text)\n\n        return text_out\n</code></pre>"},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe.DescribeCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe.DescribeCmd.name","title":"<code>name = 'describe'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe.DescribeCmd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe.DescribeCmd.describe","title":"<code>describe(file_path, element_path_str, trestle_root)</code>  <code>classmethod</code>","text":"<p>Describe the contents of the file.</p> <p>Parameters:</p> Name Type Description Default <code>file_path</code> <code>Path</code> <p>pathlib.Path Path for model file to describe.</p> required <code>element_path_str</code> <code>str</code> <p>Element path of element in model to describe.  Can be ''.</p> required <p>Returns:</p> Type Description <code>List[str]</code> <p>The list of lines of text in the description, or an empty list on failure</p> Source code in <code>trestle/core/commands/describe.py</code> <pre><code>@classmethod\ndef describe(cls, file_path: pathlib.Path, element_path_str: str, trestle_root: pathlib.Path) -&gt; List[str]:\n    \"\"\"Describe the contents of the file.\n\n    Args:\n        file_path: pathlib.Path Path for model file to describe.\n        element_path_str: Element path of element in model to describe.  Can be ''.\n\n    Returns:\n        The list of lines of text in the description, or an empty list on failure\n    \"\"\"\n    # figure out the model type so we can read it\n    try:\n        model_type, _ = ModelUtils.get_stripped_model_type(file_path, trestle_root)\n        model: OscalBaseModel = model_type.oscal_read(file_path)\n    except TrestleError as e:\n        logger.warning(f'Error loading model {file_path} to describe: {e}')\n        return []\n\n    sub_model = model\n\n    # if an element path was provided, follow the path chain to the desired sub_model\n    if element_path_str:\n        if '*' in element_path_str or ',' in element_path_str:\n            logger.warning('Wildcards and commas are not allowed in the element path for describe.')\n            return []\n\n        if '.' not in element_path_str:\n            logger.warning('The element path for describe must either be omitted or contain at least 2 parts.')\n            return []\n\n        element_paths = utils.parse_element_arg(model, element_path_str)\n\n        sub_model_element = Element(model)\n\n        for element_path in element_paths:\n            sub_model = sub_model_element.get_at(element_path, False)\n            sub_model_element = Element(sub_model)\n\n    # now that we have the desired sub_model we can describe it\n\n    text_out: List[str] = []\n\n    # create top level text depending on whether an element path was used\n    element_text = '' if not element_path_str else f' at element path {element_path_str}'\n\n    if type(sub_model) is list:\n        text = f'Model file {file_path}{element_text} is a {cls._description_text(sub_model)}'\n        text_out.append(text)\n        logger.info(text)\n    else:\n        text = f'Model file {file_path}{element_text} is of type '\n        text += f'{cls._clean_type_string(str(type(sub_model)))} and contains:'\n        text_out.append(text)\n        logger.info(text)\n        for key in sub_model.__fields__.keys():\n            value = getattr(sub_model, key, None)\n            text = f'    {key}: {cls._description_text(value)}'\n            text_out.append(text)\n            logger.info(text)\n\n    return text_out\n</code></pre>"},{"location":"reference/API/trestle/core/commands/describe/#trestle.core.commands.describe-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/href/","title":"trestle.core.commands.href","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href","title":"<code>trestle.core.commands.href</code>","text":"<p>Trestle Href Command.</p>"},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href.HrefCmd","title":"<code>HrefCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Change href of import in profile to point to catalog in trestle workspace.</p> <p>This command is needed when generating an SSP with a profile that imports a catalog from a temporary location different from the final intended location of the catalog.  Omit the href argument to see the list of current imports in the profile.</p> Source code in <code>trestle/core/commands/href.py</code> <pre><code>class HrefCmd(CommandPlusDocs):\n    \"\"\"Change href of import in profile to point to catalog in trestle workspace.\n\n    This command is needed when generating an SSP with a profile that imports a catalog from a temporary\n    location different from the final intended location of the catalog.  Omit the href argument to see\n    the list of current imports in the profile.\n    \"\"\"\n\n    name = 'href'\n\n    def _init_arguments(self) -&gt; None:\n        logger.debug('Init arguments')\n        self.add_argument(\n            '-n', '--name', help='Name of trestle profile to modify (just its name).', type=str, required=True\n        )\n\n        self.add_argument(\n            '-hr',\n            '--href',\n            help='New href of form trestle://catalogs/mycat/catalog.json.',\n            type=str,\n            required=False,\n            default=''\n        )\n\n        self.add_argument(\n            '-i',\n            '--item',\n            help='Item number of href to modify.  Get list by running href with just -n &lt;prof_name&gt; to list values.',\n            type=int,\n            required=False,\n            default=0\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            logger.debug('Entering trestle href.')\n\n            log.set_log_level_from_args(args)\n\n            profile_name: str = args.name\n\n            new_href: str = args.href.strip(\"'\")\n\n            item_num = args.item\n\n            return self.change_import_href(args.trestle_root, profile_name, new_href, item_num)\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, f'Error while changing href or import in profile: {e}')\n\n    @classmethod\n    def change_import_href(cls, trestle_root: pathlib.Path, profile_name: str, new_href: str, import_num: int) -&gt; int:\n        \"\"\"Change the href of the import in the profile to point to a catalog in a specific location.\n\n        A Profile has an Imports list containing at least one href of a catalog or profile to be imported.\n        If the item being referenced is currently in the same trestle workspace as the main profile, the original\n        href is likely different from the one needed to access the item from the profile.  Therefore,\n        in order for trestle to find the item directly from the profile, the href must be modified in a way that\n        trestle can load it.\n\n        If the item is already at the link referred to by the href as a valid URI or absolute file path then no\n        change is needed.  But if the item is being worked on in the same trestle directory as the profile,\n        the href should be modified to something like trestle://catalogs/my_catalog/catalog.json\n\n        This change only needs to be made once to the profile while the profile is being used to generate SSP's\n        from the local item, but if the final profile is released the href would need to be changed to the\n        intended final location of the referenced item.\n\n        Args:\n            trestle_root: trestle_root for this call\n            profile_name: Name of profile already imported into trestle containing href's to be changed\n            new_href: New value for the href of the import.  If blank just list the hrefs\n            import_num: Item number of the href to change.\n\n\n        Returns:\n            0 on success, 1 on failure\n\n        Assumptions and requirements:\n            The profile must be a valid profile in the trestle workspace.\n            The import must either be a valid uri, including local file, or trestle://\n            The original href is not checked and will be overwritten.\n            If href is the empty string, just list all hrefs.\n\n        Future work:\n            Allow multiple imports with matching hrefs.\n            Allow href to point to profile in trestle rather than catalog, and by name.\n            Allow full chaining of linked catalogs and profiles.\n\n        \"\"\"\n        profile_data, profile_path = load_validate_model_name(trestle_root, profile_name, Profile)\n        n_imports = len(profile_data.imports)\n        if not new_href:\n            logger.info(f'List of imports for profile {profile_name}:')\n            for ii, import_ in enumerate(profile_data.imports):\n                logger.info(f'{ii:2}: {import_.href}')\n            return CmdReturnCodes.SUCCESS.value\n        if n_imports &lt;= import_num:\n            raise TrestleError(f'Import number {import_num} is too large.  This profile has only {n_imports} imports.')\n\n        logger.info(f'Changing import {import_num} in profile {profile_name} from, to:')\n        logger.info(f'{profile_data.imports[import_num].href}')\n        logger.info(f'{new_href}')\n        profile_data.imports[import_num].href = new_href\n        profile_data.oscal_write(profile_path)  # type: ignore\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href.HrefCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href.HrefCmd.name","title":"<code>name = 'href'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href.HrefCmd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href.HrefCmd.change_import_href","title":"<code>change_import_href(trestle_root, profile_name, new_href, import_num)</code>  <code>classmethod</code>","text":"<p>Change the href of the import in the profile to point to a catalog in a specific location.</p> <p>A Profile has an Imports list containing at least one href of a catalog or profile to be imported. If the item being referenced is currently in the same trestle workspace as the main profile, the original href is likely different from the one needed to access the item from the profile.  Therefore, in order for trestle to find the item directly from the profile, the href must be modified in a way that trestle can load it.</p> <p>If the item is already at the link referred to by the href as a valid URI or absolute file path then no change is needed.  But if the item is being worked on in the same trestle directory as the profile, the href should be modified to something like trestle://catalogs/my_catalog/catalog.json</p> <p>This change only needs to be made once to the profile while the profile is being used to generate SSP's from the local item, but if the final profile is released the href would need to be changed to the intended final location of the referenced item.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>trestle_root for this call</p> required <code>profile_name</code> <code>str</code> <p>Name of profile already imported into trestle containing href's to be changed</p> required <code>new_href</code> <code>str</code> <p>New value for the href of the import.  If blank just list the hrefs</p> required <code>import_num</code> <code>int</code> <p>Item number of the href to change.</p> required <p>Returns:</p> Type Description <code>int</code> <p>0 on success, 1 on failure</p> Assumptions and requirements <p>The profile must be a valid profile in the trestle workspace. The import must either be a valid uri, including local file, or trestle:// The original href is not checked and will be overwritten. If href is the empty string, just list all hrefs.</p> Future work <p>Allow multiple imports with matching hrefs. Allow href to point to profile in trestle rather than catalog, and by name. Allow full chaining of linked catalogs and profiles.</p> Source code in <code>trestle/core/commands/href.py</code> <pre><code>@classmethod\ndef change_import_href(cls, trestle_root: pathlib.Path, profile_name: str, new_href: str, import_num: int) -&gt; int:\n    \"\"\"Change the href of the import in the profile to point to a catalog in a specific location.\n\n    A Profile has an Imports list containing at least one href of a catalog or profile to be imported.\n    If the item being referenced is currently in the same trestle workspace as the main profile, the original\n    href is likely different from the one needed to access the item from the profile.  Therefore,\n    in order for trestle to find the item directly from the profile, the href must be modified in a way that\n    trestle can load it.\n\n    If the item is already at the link referred to by the href as a valid URI or absolute file path then no\n    change is needed.  But if the item is being worked on in the same trestle directory as the profile,\n    the href should be modified to something like trestle://catalogs/my_catalog/catalog.json\n\n    This change only needs to be made once to the profile while the profile is being used to generate SSP's\n    from the local item, but if the final profile is released the href would need to be changed to the\n    intended final location of the referenced item.\n\n    Args:\n        trestle_root: trestle_root for this call\n        profile_name: Name of profile already imported into trestle containing href's to be changed\n        new_href: New value for the href of the import.  If blank just list the hrefs\n        import_num: Item number of the href to change.\n\n\n    Returns:\n        0 on success, 1 on failure\n\n    Assumptions and requirements:\n        The profile must be a valid profile in the trestle workspace.\n        The import must either be a valid uri, including local file, or trestle://\n        The original href is not checked and will be overwritten.\n        If href is the empty string, just list all hrefs.\n\n    Future work:\n        Allow multiple imports with matching hrefs.\n        Allow href to point to profile in trestle rather than catalog, and by name.\n        Allow full chaining of linked catalogs and profiles.\n\n    \"\"\"\n    profile_data, profile_path = load_validate_model_name(trestle_root, profile_name, Profile)\n    n_imports = len(profile_data.imports)\n    if not new_href:\n        logger.info(f'List of imports for profile {profile_name}:')\n        for ii, import_ in enumerate(profile_data.imports):\n            logger.info(f'{ii:2}: {import_.href}')\n        return CmdReturnCodes.SUCCESS.value\n    if n_imports &lt;= import_num:\n        raise TrestleError(f'Import number {import_num} is too large.  This profile has only {n_imports} imports.')\n\n    logger.info(f'Changing import {import_num} in profile {profile_name} from, to:')\n    logger.info(f'{profile_data.imports[import_num].href}')\n    logger.info(f'{new_href}')\n    profile_data.imports[import_num].href = new_href\n    profile_data.oscal_write(profile_path)  # type: ignore\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/href/#trestle.core.commands.href-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/import_/","title":"trestle.core.commands.import_","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/import_/#trestle.core.commands.import_","title":"<code>trestle.core.commands.import_</code>","text":"<p>Trestle Import Command.</p>"},{"location":"reference/API/trestle/core/commands/import_/#trestle.core.commands.import_-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/import_/#trestle.core.commands.import_.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/import_/#trestle.core.commands.import_-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/import_/#trestle.core.commands.import_.ImportCmd","title":"<code>ImportCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Import an existing full OSCAL model into the trestle workspace.</p> Source code in <code>trestle/core/commands/import_.py</code> <pre><code>class ImportCmd(CommandPlusDocs):\n    \"\"\"Import an existing full OSCAL model into the trestle workspace.\"\"\"\n\n    name = 'import'\n\n    def _init_arguments(self) -&gt; None:\n        logger.debug('Init arguments')\n        self.add_argument(\n            '-f', '--file', help='OSCAL file to import - either file path or url.', type=str, required=True\n        )\n        self.add_argument('-o', '--output', help='Name of output element.', type=str, required=True)\n        self.add_argument('-r', '--regenerate', action='store_true', help=const.HELP_REGENERATE)\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"Top level import run command.\"\"\"\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root = args.trestle_root\n            if not file_utils.is_valid_project_root(trestle_root):\n                raise TrestleRootError(f'Attempt to import from non-valid trestle project root {trestle_root}')\n\n            input_uri = args.file\n            if cache.FetcherFactory.in_trestle_directory(trestle_root, input_uri):\n                raise TrestleError(\n                    f'Imported file {input_uri} cannot be from current trestle project. Use duplicate instead.'\n                )\n\n            content_type = FileContentType.to_content_type('.' + input_uri.split('.')[-1])\n\n            fetcher = cache.FetcherFactory.get_fetcher(trestle_root, str(input_uri))\n\n            model_read, parent_alias = fetcher.get_oscal(True)\n\n            # validate the loaded model in memory before writing out\n            # this will do any needed fixes to the file, such as assign missing catalog group ids\n            args_validate = argparse.Namespace(mode=const.VAL_MODE_ALL)\n            validator: Validator = validator_factory.get(args_validate)\n            if not validator.model_is_valid(model_read, True, trestle_root):  # type: ignore\n                logger.warning(f'Validation of file to be imported {input_uri} did not pass.  Import failed.')\n                return CmdReturnCodes.COMMAND_ERROR.value\n\n            plural_path = ModelUtils.model_type_to_model_dir(parent_alias)\n\n            output_name = args.output\n\n            desired_model_dir = trestle_root / plural_path\n            desired_model_path: pathlib.Path = desired_model_dir / output_name / parent_alias\n            desired_model_path = desired_model_path.with_suffix(FileContentType.to_file_extension(content_type)\n                                                                ).resolve()\n\n            if desired_model_path.exists():\n                logger.warning(f'Cannot import because file to be imported here: {desired_model_path} already exists.')\n                return CmdReturnCodes.COMMAND_ERROR.value\n\n            if args.regenerate:\n                logger.debug(f'regenerating uuids in imported file {input_uri}')\n                model_read, lut, nchanged = ModelUtils.regenerate_uuids(model_read)\n                logger.debug(f'uuid lut has {len(lut.items())} entries and {nchanged} refs were updated')\n\n            top_element = Element(model_read)\n            create_action = CreatePathAction(desired_model_path, True)\n            write_action = WriteFileAction(desired_model_path, top_element, content_type)\n\n            # create a plan to create the directory and write the imported file.\n            import_plan = Plan()\n            import_plan.add_action(create_action)\n            import_plan.add_action(write_action)\n\n            import_plan.execute()\n\n            args = argparse.Namespace(\n                file=desired_model_path,\n                verbose=args.verbose,\n                trestle_root=args.trestle_root,\n                type=None,\n                all=None,\n                quiet=True\n            )\n            return CmdReturnCodes.SUCCESS.value\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while importing OSCAL file')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/import_/#trestle.core.commands.import_.ImportCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/import_/#trestle.core.commands.import_.ImportCmd.name","title":"<code>name = 'import'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/import_/#trestle.core.commands.import_-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/init/","title":"trestle.core.commands.init","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/init/#trestle.core.commands.init","title":"<code>trestle.core.commands.init</code>","text":"<p>Trestle Init Command.</p>"},{"location":"reference/API/trestle/core/commands/init/#trestle.core.commands.init-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/init/#trestle.core.commands.init.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/init/#trestle.core.commands.init-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/init/#trestle.core.commands.init.InitCmd","title":"<code>InitCmd</code>","text":"<p>               Bases: <code>CommandBase</code></p> <p>Initialize a trestle working directory.</p> Source code in <code>trestle/core/commands/init.py</code> <pre><code>class InitCmd(CommandBase):\n    \"\"\"Initialize a trestle working directory.\"\"\"\n\n    name = 'init'\n\n    def _init_arguments(self) -&gt; None:\n\n        self.add_argument(const.INIT_FULL_SHORT, const.INIT_FULL_LONG, help=const.INIT_FULL_HELP, action='store_true')\n        self.add_argument(\n            const.INIT_LOCAL_SHORT, const.INIT_LOCAL_LONG, help=const.INIT_LOCAL_HELP, action='store_true'\n        )\n        self.add_argument(\n            const.INIT_GOVDOCS_SHORT, const.INIT_GOVDOCS_LONG, help=const.INIT_GOVDOCS_HELP, action='store_true'\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"Create a trestle workspace in the current directory.\"\"\"\n        try:\n            log.set_log_level_from_args(args)\n            dir_path: pathlib.Path = args.trestle_root\n            if not dir_path.exists() or not dir_path.is_dir():\n                raise TrestleRootError(\n                    f'Initialization failed. Given directory {dir_path} does not exist or is not a directory.'\n                )\n\n            if not (args.full or args.local or args.govdocs):\n                # Running in full mode by default\n                args.full = True\n\n            init_dist_folder = True if args.full else False\n            init_oscal_folders = True if args.local or args.full else False\n            copy_config_file = True if args.full or args.local else False\n\n            self._create_directories(dir_path, init_oscal_folders, init_dist_folder)\n\n            if copy_config_file:\n                self._copy_config_file(dir_path)\n\n            logger.info(f'Initialized trestle project successfully in {dir_path}')\n\n            return CmdReturnCodes.SUCCESS.value\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Failed to initialize Trestle working directory.')\n\n    def _create_directories(self, root: pathlib.Path, create_model_folders: bool, create_dist_folder: bool) -&gt; None:\n        \"\"\"Create the directory tree if it does not exist.\"\"\"\n        # Prepare directory list to be created\n        try:\n            directory_list = [root / pathlib.Path(const.TRESTLE_CONFIG_DIR)]\n\n            if create_model_folders:\n                for model_dir in const.MODEL_DIR_LIST:\n                    directory_list.append(root / pathlib.Path(model_dir))\n                    if create_dist_folder:\n                        directory_list.append(root / pathlib.Path(const.TRESTLE_DIST_DIR) / model_dir)\n\n            # Create directories\n            for directory in directory_list:\n                directory.mkdir(parents=True, exist_ok=True)\n                file_path = pathlib.Path(directory) / const.TRESTLE_KEEP_FILE\n                file_utils.make_hidden_file(file_path)\n        except OSError as e:\n            raise TrestleError(f'Error while creating directories: {e}')\n        except Exception as e:\n            raise TrestleError(f'Unexpected error while creating directories: {e}')\n\n    def _copy_config_file(self, root: pathlib.Path) -&gt; None:\n        \"\"\"Copy the initial config.ini file to .trestle directory.\"\"\"\n        try:\n            ref = importlib_resources.files('trestle.resources') / const.TRESTLE_CONFIG_FILE\n            with importlib_resources.as_file(ref) as source_path:\n                destination_path = (root / pathlib.Path(const.TRESTLE_CONFIG_DIR) / const.TRESTLE_CONFIG_FILE).resolve()\n                copyfile(source_path, destination_path)\n\n        except (shutil.SameFileError, OSError) as e:\n            raise TrestleError(f'Error while copying config file: {e}')\n        except Exception as e:\n            raise TrestleError(f'Unexpected error while copying config file: {e}')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/init/#trestle.core.commands.init.InitCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/init/#trestle.core.commands.init.InitCmd.name","title":"<code>name = 'init'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/init/#trestle.core.commands.init-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/merge/","title":"trestle.core.commands.merge","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge","title":"<code>trestle.core.commands.merge</code>","text":"<p>Trestle Merge Command.</p>"},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge.trace","title":"<code>trace = log.Trace(logger)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge.MergeCmd","title":"<code>MergeCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Merge subcomponents on a trestle model.</p> Source code in <code>trestle/core/commands/merge.py</code> <pre><code>class MergeCmd(CommandPlusDocs):\n    \"\"\"Merge subcomponents on a trestle model.\"\"\"\n\n    name = 'merge'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument(\n            f'-{const.ARG_ELEMENT_SHORT}',\n            f'--{const.ARG_ELEMENT}',\n            help=f'{const.ARG_DESC_ELEMENT}(s) to be merged. The last element is merged into the second last element.',\n            required=True\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"Merge elements into the parent oscal model.\"\"\"\n        try:\n            log.set_log_level_from_args(args)\n\n            # remove any quotes passed in as on windows platforms\n            elements_clean = args.element.strip(\"'\")\n            element_paths = elements_clean.split(',')\n            trace.log(f'merge _run element paths {element_paths}')\n            cwd = Path.cwd()\n            rc = self.perform_all_merges(element_paths, cwd, args.trestle_root)\n            return rc\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while merging subcomponents on a trestle model')\n\n    @classmethod\n    def perform_all_merges(cls, element_paths: List[str], effective_cwd: Path, trestle_root: Path) -&gt; int:\n        \"\"\"Run all merges over a list of element paths.\"\"\"\n        for element_path in element_paths:\n            logger.debug(f'merge {element_path}')\n            plan = cls.merge(effective_cwd, ElementPath(element_path), trestle_root)\n            plan.execute()\n        return CmdReturnCodes.SUCCESS.value\n\n    @classmethod\n    def merge(cls, effective_cwd: Path, element_path: ElementPath, trestle_root: Path) -&gt; Plan:\n        \"\"\"Merge operations.\n\n        It returns a plan for the operation\n        \"\"\"\n        if not element_path.is_multipart():\n            raise TrestleError(\n                'Multiple parts of an element path must be passed to merge e.g. catalog.* or catalog.groups'\n            )\n\n        target_model_alias = element_path.get_last()\n        logger.debug(f'merge element path list: {element_path} target model alias {target_model_alias}')\n        # 1. Load desination model into a stripped model\n        # Load destination model\n        destination_path = element_path.get_preceding_path()\n        destination_model_alias = destination_path.get_last()\n        trace.log(f'merge destination model alias: {destination_model_alias}')\n        trace.log('merge getting contextual file type effective working directory')\n        # Destination model filetype\n        file_type = file_utils.get_contextual_file_type(effective_cwd)\n        trace.log(f'contextual file type is {file_type}')\n\n        file_ext = FileContentType.to_file_extension(file_type)\n        # Destination model filename\n        destination_model_path = (\n            effective_cwd / f'{classname_to_alias(destination_model_alias, AliasMode.JSON)}{file_ext}'\n        )\n        trace.log(f'destination model filename is {destination_model_path}')\n        destination_model_type, _ = ModelUtils.get_stripped_model_type(destination_model_path, trestle_root)\n\n        destination_model_object: OscalBaseModel = None\n        if destination_model_path.exists():\n            trace.log('dest filename exists so read it')\n            destination_model_object = destination_model_type.oscal_read(destination_model_path)\n        # 2. If target is wildcard, load distributed destination model and replace destination model.\n        # Handle WILDCARD '*' match. Return plan to load the destination model, with its distributed attributes\n        if target_model_alias == '*':\n            trace.log('handle target model alias wildcard')\n            collection_type = None\n            if destination_model_type.is_collection_container():\n                collection_type = destination_model_type.get_collection_type()\n\n            merged_model_type, _, merged_model_instance = ModelUtils.load_distributed(\n                destination_model_path, trestle_root, collection_type)\n            plan = Plan()\n            reset_destination_action = CreatePathAction(destination_model_path, clear_content=True)\n            wrapper_alias = destination_model_alias\n            write_destination_action = WriteFileAction(\n                destination_model_path, Element(merged_model_instance, wrapper_alias), content_type=file_type\n            )\n            remove_path_folder = effective_cwd / destination_model_alias\n            delete_target_action = RemovePathAction(remove_path_folder)\n            plan: Plan = Plan()\n            plan.add_action(reset_destination_action)\n            plan.add_action(write_destination_action)\n            plan.add_action(delete_target_action)\n            return plan\n\n        trace.log(f'get dest model with fields stripped: {target_model_alias}')\n        # Get destination model without the target field stripped\n        merged_model_type, _ = ModelUtils.get_stripped_model_type(destination_model_path, trestle_root,\n                                                                  aliases_not_to_be_stripped=[target_model_alias])\n        # 3. Load Target model. Target model could be stripped\n        try:\n            target_model_type = element_path.get_type(merged_model_type)\n        except Exception as e:\n            logger.debug(f'target model not found, element path list {element_path} type {merged_model_type}')\n            raise TrestleError(\n                f'Target model not found. Possibly merge of the elements not allowed at this point. {str(e)}'\n            )\n        target_model_path = effective_cwd / destination_model_alias\n        trace.log(f'look for target model path {target_model_path} at dest alias {destination_model_alias} rel to cwd')\n\n        # target_model filename - depends whether destination model is decomposed or not\n        if target_model_path.exists():\n            trace.log(f'target model path does exist so target path is subdir with target alias {target_model_alias}')\n            target_model_path = target_model_path / target_model_alias\n        else:\n            trace.log(f'target model filename does not exist so target path is target alias {target_model_alias}')\n            target_model_path = target_model_path / target_model_alias  # FIXME this is same as above\n        trace.log(f'final target model path is {target_model_path}')\n\n        # if target model is a file then handle file. If file doesn't exist, handle the directory,\n        # but in this case it's a list or a dict collection type\n        target_model_filename = target_model_path.with_suffix(file_ext)\n        if target_model_filename.exists():\n            trace.log(f'target model path with extension does exist so load distrib {target_model_filename}')\n            _, _, target_model_object = ModelUtils.load_distributed(target_model_filename, trestle_root)\n        else:\n            target_model_filename = Path(target_model_path)\n            trace.log(f'target model path plus extension does not exist so load distrib {target_model_filename}')\n            trace.log(f'get collection type for model type {target_model_type}')\n            collection_type = type_utils.get_origin(target_model_type)\n            trace.log(f'load {target_model_filename} as collection type {collection_type}')\n            _, _, target_model_object = ModelUtils.load_distributed(target_model_filename,\n                                                                    trestle_root, collection_type)\n\n        if hasattr(target_model_object, '__dict__') and '__root__' in target_model_object.__dict__:\n            trace.log('loaded object has dict and root so set target model object to root contents')\n            target_model_object = target_model_object.__dict__['__root__']\n        # 4. Insert target model into destination model.\n        merged_dict = {}\n        if destination_model_object is not None:\n            merged_dict = destination_model_object.__dict__\n        merged_dict[target_model_alias] = target_model_object\n        merged_model_object = merged_model_type(**merged_dict)\n        merged_destination_element = Element(merged_model_object)\n        # 5. Create action  plan\n        trace.log(f'create path action clear content: {destination_model_path}')\n        reset_destination_action = CreatePathAction(destination_model_path, clear_content=True)\n        trace.log(f'write file action {destination_model_path}')\n        write_destination_action = WriteFileAction(\n            destination_model_path, merged_destination_element, content_type=file_type\n        )\n        # FIXME this will delete metadata.json but it will leave metadata/roles/roles.*\n        # need to clean up all lower dirs\n        trace.log(f'remove path action {target_model_filename}')\n        delete_target_action = RemovePathAction(target_model_filename)\n\n        plan: Plan = Plan()\n        plan.add_action(reset_destination_action)\n        plan.add_action(write_destination_action)\n        plan.add_action(delete_target_action)\n\n        # TODO: Destination model directory is empty or already merged? Then clean up.\n\n        return plan\n</code></pre>"},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge.MergeCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge.MergeCmd.name","title":"<code>name = 'merge'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge.MergeCmd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge.MergeCmd.merge","title":"<code>merge(effective_cwd, element_path, trestle_root)</code>  <code>classmethod</code>","text":"<p>Merge operations.</p> <p>It returns a plan for the operation</p> Source code in <code>trestle/core/commands/merge.py</code> <pre><code>@classmethod\ndef merge(cls, effective_cwd: Path, element_path: ElementPath, trestle_root: Path) -&gt; Plan:\n    \"\"\"Merge operations.\n\n    It returns a plan for the operation\n    \"\"\"\n    if not element_path.is_multipart():\n        raise TrestleError(\n            'Multiple parts of an element path must be passed to merge e.g. catalog.* or catalog.groups'\n        )\n\n    target_model_alias = element_path.get_last()\n    logger.debug(f'merge element path list: {element_path} target model alias {target_model_alias}')\n    # 1. Load desination model into a stripped model\n    # Load destination model\n    destination_path = element_path.get_preceding_path()\n    destination_model_alias = destination_path.get_last()\n    trace.log(f'merge destination model alias: {destination_model_alias}')\n    trace.log('merge getting contextual file type effective working directory')\n    # Destination model filetype\n    file_type = file_utils.get_contextual_file_type(effective_cwd)\n    trace.log(f'contextual file type is {file_type}')\n\n    file_ext = FileContentType.to_file_extension(file_type)\n    # Destination model filename\n    destination_model_path = (\n        effective_cwd / f'{classname_to_alias(destination_model_alias, AliasMode.JSON)}{file_ext}'\n    )\n    trace.log(f'destination model filename is {destination_model_path}')\n    destination_model_type, _ = ModelUtils.get_stripped_model_type(destination_model_path, trestle_root)\n\n    destination_model_object: OscalBaseModel = None\n    if destination_model_path.exists():\n        trace.log('dest filename exists so read it')\n        destination_model_object = destination_model_type.oscal_read(destination_model_path)\n    # 2. If target is wildcard, load distributed destination model and replace destination model.\n    # Handle WILDCARD '*' match. Return plan to load the destination model, with its distributed attributes\n    if target_model_alias == '*':\n        trace.log('handle target model alias wildcard')\n        collection_type = None\n        if destination_model_type.is_collection_container():\n            collection_type = destination_model_type.get_collection_type()\n\n        merged_model_type, _, merged_model_instance = ModelUtils.load_distributed(\n            destination_model_path, trestle_root, collection_type)\n        plan = Plan()\n        reset_destination_action = CreatePathAction(destination_model_path, clear_content=True)\n        wrapper_alias = destination_model_alias\n        write_destination_action = WriteFileAction(\n            destination_model_path, Element(merged_model_instance, wrapper_alias), content_type=file_type\n        )\n        remove_path_folder = effective_cwd / destination_model_alias\n        delete_target_action = RemovePathAction(remove_path_folder)\n        plan: Plan = Plan()\n        plan.add_action(reset_destination_action)\n        plan.add_action(write_destination_action)\n        plan.add_action(delete_target_action)\n        return plan\n\n    trace.log(f'get dest model with fields stripped: {target_model_alias}')\n    # Get destination model without the target field stripped\n    merged_model_type, _ = ModelUtils.get_stripped_model_type(destination_model_path, trestle_root,\n                                                              aliases_not_to_be_stripped=[target_model_alias])\n    # 3. Load Target model. Target model could be stripped\n    try:\n        target_model_type = element_path.get_type(merged_model_type)\n    except Exception as e:\n        logger.debug(f'target model not found, element path list {element_path} type {merged_model_type}')\n        raise TrestleError(\n            f'Target model not found. Possibly merge of the elements not allowed at this point. {str(e)}'\n        )\n    target_model_path = effective_cwd / destination_model_alias\n    trace.log(f'look for target model path {target_model_path} at dest alias {destination_model_alias} rel to cwd')\n\n    # target_model filename - depends whether destination model is decomposed or not\n    if target_model_path.exists():\n        trace.log(f'target model path does exist so target path is subdir with target alias {target_model_alias}')\n        target_model_path = target_model_path / target_model_alias\n    else:\n        trace.log(f'target model filename does not exist so target path is target alias {target_model_alias}')\n        target_model_path = target_model_path / target_model_alias  # FIXME this is same as above\n    trace.log(f'final target model path is {target_model_path}')\n\n    # if target model is a file then handle file. If file doesn't exist, handle the directory,\n    # but in this case it's a list or a dict collection type\n    target_model_filename = target_model_path.with_suffix(file_ext)\n    if target_model_filename.exists():\n        trace.log(f'target model path with extension does exist so load distrib {target_model_filename}')\n        _, _, target_model_object = ModelUtils.load_distributed(target_model_filename, trestle_root)\n    else:\n        target_model_filename = Path(target_model_path)\n        trace.log(f'target model path plus extension does not exist so load distrib {target_model_filename}')\n        trace.log(f'get collection type for model type {target_model_type}')\n        collection_type = type_utils.get_origin(target_model_type)\n        trace.log(f'load {target_model_filename} as collection type {collection_type}')\n        _, _, target_model_object = ModelUtils.load_distributed(target_model_filename,\n                                                                trestle_root, collection_type)\n\n    if hasattr(target_model_object, '__dict__') and '__root__' in target_model_object.__dict__:\n        trace.log('loaded object has dict and root so set target model object to root contents')\n        target_model_object = target_model_object.__dict__['__root__']\n    # 4. Insert target model into destination model.\n    merged_dict = {}\n    if destination_model_object is not None:\n        merged_dict = destination_model_object.__dict__\n    merged_dict[target_model_alias] = target_model_object\n    merged_model_object = merged_model_type(**merged_dict)\n    merged_destination_element = Element(merged_model_object)\n    # 5. Create action  plan\n    trace.log(f'create path action clear content: {destination_model_path}')\n    reset_destination_action = CreatePathAction(destination_model_path, clear_content=True)\n    trace.log(f'write file action {destination_model_path}')\n    write_destination_action = WriteFileAction(\n        destination_model_path, merged_destination_element, content_type=file_type\n    )\n    # FIXME this will delete metadata.json but it will leave metadata/roles/roles.*\n    # need to clean up all lower dirs\n    trace.log(f'remove path action {target_model_filename}')\n    delete_target_action = RemovePathAction(target_model_filename)\n\n    plan: Plan = Plan()\n    plan.add_action(reset_destination_action)\n    plan.add_action(write_destination_action)\n    plan.add_action(delete_target_action)\n\n    # TODO: Destination model directory is empty or already merged? Then clean up.\n\n    return plan\n</code></pre>"},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge.MergeCmd.perform_all_merges","title":"<code>perform_all_merges(element_paths, effective_cwd, trestle_root)</code>  <code>classmethod</code>","text":"<p>Run all merges over a list of element paths.</p> Source code in <code>trestle/core/commands/merge.py</code> <pre><code>@classmethod\ndef perform_all_merges(cls, element_paths: List[str], effective_cwd: Path, trestle_root: Path) -&gt; int:\n    \"\"\"Run all merges over a list of element paths.\"\"\"\n    for element_path in element_paths:\n        logger.debug(f'merge {element_path}')\n        plan = cls.merge(effective_cwd, ElementPath(element_path), trestle_root)\n        plan.execute()\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/merge/#trestle.core.commands.merge-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/partial_object_validate/","title":"trestle.core.commands.partial_object_validate","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate","title":"<code>trestle.core.commands.partial_object_validate</code>","text":"<p>Trestle schema-validate command.</p>"},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate.PartialObjectValidate","title":"<code>PartialObjectValidate</code>","text":"<p>               Bases: <code>CommandBase</code></p> <p>Direct validation any oscal object in a file, including list objects.</p> Source code in <code>trestle/core/commands/partial_object_validate.py</code> <pre><code>class PartialObjectValidate(CommandBase):\n    \"\"\"Direct validation any oscal object in a file, including list objects.\"\"\"\n\n    name = 'partial-object-validate'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument(\n            f'-{const.ARG_FILE_SHORT}',\n            f'--{const.ARG_FILE}',\n            help=const.ARG_DESC_FILE + ' to validate',\n            required=True,\n            type=pathlib.Path\n        )\n\n        self.add_argument(\n            f'-{const.ARG_ELEMENT_SHORT}',\n            f'--{const.ARG_ELEMENT}',\n            help=const.ARG_DESC_ELEMENT + ' to validate.',\n            required=True\n        )\n\n        self.add_argument(\n            '-nv', '--no-validators', help='Only perform the most basic validation of the file', action='store_true'\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            file_path: pathlib.Path = args.file.resolve()\n            if not file_path.exists() or not file_path.is_file():\n                raise TrestleError('File path provided does not exist or is a directory')\n\n            element_str: str = args.element\n            if ',' in element_str:\n                logger.warning('Only a single element path is allowed.')\n\n            return self.partial_object_validate(file_path, element_str)\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while validating OSCAL file')\n\n    @classmethod\n    def partial_object_validate(cls, file_path: pathlib.Path, element_string: str) -&gt; int:\n        \"\"\"Run a schema validation on a file inferring file type based on element string.\"\"\"\n        # get model type\n        logger.info(f'Validating {file_path}')\n        element_path = elements.ElementPath(element_string)\n        # get a wrapped object\n        obm_type = element_path.get_obm_wrapped_type()\n        obm_type.oscal_read(file_path)\n\n        logger.info(f'VALID: {file_path} for {element_string}')\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate.PartialObjectValidate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate.PartialObjectValidate.name","title":"<code>name = 'partial-object-validate'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate.PartialObjectValidate-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate.PartialObjectValidate.partial_object_validate","title":"<code>partial_object_validate(file_path, element_string)</code>  <code>classmethod</code>","text":"<p>Run a schema validation on a file inferring file type based on element string.</p> Source code in <code>trestle/core/commands/partial_object_validate.py</code> <pre><code>@classmethod\ndef partial_object_validate(cls, file_path: pathlib.Path, element_string: str) -&gt; int:\n    \"\"\"Run a schema validation on a file inferring file type based on element string.\"\"\"\n    # get model type\n    logger.info(f'Validating {file_path}')\n    element_path = elements.ElementPath(element_string)\n    # get a wrapped object\n    obm_type = element_path.get_obm_wrapped_type()\n    obm_type.oscal_read(file_path)\n\n    logger.info(f'VALID: {file_path} for {element_string}')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/partial_object_validate/#trestle.core.commands.partial_object_validate-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/remove/","title":"trestle.core.commands.remove","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/remove/#trestle.core.commands.remove","title":"<code>trestle.core.commands.remove</code>","text":"<p>Trestle Remove Command.</p>"},{"location":"reference/API/trestle/core/commands/remove/#trestle.core.commands.remove-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/remove/#trestle.core.commands.remove.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/remove/#trestle.core.commands.remove-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/remove/#trestle.core.commands.remove.RemoveCmd","title":"<code>RemoveCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Remove a subcomponent from an existing model.</p> Source code in <code>trestle/core/commands/remove.py</code> <pre><code>class RemoveCmd(CommandPlusDocs):\n    \"\"\"Remove a subcomponent from an existing model.\"\"\"\n\n    name = 'remove'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument(\n            f'-{const.ARG_FILE_SHORT}',\n            f'--{const.ARG_FILE}',\n            help=const.ARG_DESC_FILE + ' to remove component/subcomponent to.',\n            required=True\n        )\n        self.add_argument(\n            f'-{const.ARG_ELEMENT_SHORT}',\n            f'--{const.ARG_ELEMENT}',\n            help=const.ARG_DESC_ELEMENT + ' to remove.',\n            required=True\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"Remove an OSCAL component/subcomponent to the specified component.\n\n        This method takes input a filename and a list of comma-seperated element path. Element paths are field aliases.\n        The method first finds the parent model from the file and loads the file into the model.\n        Then the method executes 'remove' for each of the element paths specified.\n        \"\"\"\n        try:\n            log.set_log_level_from_args(args)\n            args_dict = args.__dict__\n\n            file_path = pathlib.Path(args_dict[const.ARG_FILE]).resolve()\n            relative_path = file_path.relative_to(args.trestle_root)\n            # Get parent model and then load json into parent model\n            parent_model, parent_alias = ModelUtils.get_relative_model_type(relative_path)\n\n            parent_object = parent_model.oscal_read(file_path)\n            parent_element = Element(parent_object, parent_alias)\n\n            add_plan = Plan()\n\n            # Do _remove for each element_path specified in args\n            element_paths: List[str] = str(args_dict[const.ARG_ELEMENT]).split(',')\n            for elm_path_str in element_paths:\n                element_path = ElementPath(elm_path_str)\n                remove_action, parent_element = self.remove(element_path, parent_element)\n                add_plan.add_action(remove_action)\n\n            create_action = CreatePathAction(file_path, True)\n            write_action = WriteFileAction(file_path, parent_element, FileContentType.to_content_type(file_path.suffix))\n            add_plan.add_action(remove_action)\n            add_plan.add_action(create_action)\n            add_plan.add_action(write_action)\n\n            add_plan.execute()\n\n            return CmdReturnCodes.SUCCESS.value\n\n        except Exception as e:\n            return err.handle_generic_command_exception(e, logger, 'Error while removing OSCAL component')\n\n    @classmethod\n    def remove(cls, element_path: ElementPath, parent_element: Element) -&gt; Tuple[RemoveAction, Element]:\n        \"\"\"For the element_path, remove a model from the parent_element of a given parent_model.\n\n        First we check if there is an existing element at that path\n        If not, we complain.\n        Then we set up an action plan to update the model (specified by file_path) in memory,\n        return the action and return the parent_element.\n\n        LIMITATIONS:\n        1. This does not remove elements of a list or dict. Instead, the entire list or dict is removed.\n        2. This cannot remove arbitrarily named elements that are not specified in the schema.\n        For example, \"responsible-parties\" contains named elements, e.g., \"organisation\". The tool will not\n        remove the \"organisation\" as it is not in the schema, but one can remove its elements, e.g., \"party-uuids\".\n        \"\"\"\n        element_path_list = element_path.get_full_path_parts()\n        if '*' in element_path_list:\n            raise err.TrestleError('trestle remove does not support Wildcard element path.')\n\n        deleting_element = parent_element.get_at(element_path)\n\n        if deleting_element is not None:\n            # The element already exists\n            if type(deleting_element) is list:\n                logger.warning(\n                    'Warning: trestle remove does not support removing elements of a list: '\n                    'this removes the entire list'\n                )\n            elif type(deleting_element) is dict:\n                logger.warning(\n                    'Warning: trestle remove does not support removing dict elements: '\n                    'this removes the entire dict element'\n                )\n        else:\n            raise err.TrestleError(f'Bad element path: {str(element_path)}')\n\n        remove_action = RemoveAction(parent_element, element_path)\n\n        return remove_action, parent_element\n</code></pre>"},{"location":"reference/API/trestle/core/commands/remove/#trestle.core.commands.remove.RemoveCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/remove/#trestle.core.commands.remove.RemoveCmd.name","title":"<code>name = 'remove'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/remove/#trestle.core.commands.remove.RemoveCmd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/remove/#trestle.core.commands.remove.RemoveCmd.remove","title":"<code>remove(element_path, parent_element)</code>  <code>classmethod</code>","text":"<p>For the element_path, remove a model from the parent_element of a given parent_model.</p> <p>First we check if there is an existing element at that path If not, we complain. Then we set up an action plan to update the model (specified by file_path) in memory, return the action and return the parent_element.</p> <p>LIMITATIONS: 1. This does not remove elements of a list or dict. Instead, the entire list or dict is removed. 2. This cannot remove arbitrarily named elements that are not specified in the schema. For example, \"responsible-parties\" contains named elements, e.g., \"organisation\". The tool will not remove the \"organisation\" as it is not in the schema, but one can remove its elements, e.g., \"party-uuids\".</p> Source code in <code>trestle/core/commands/remove.py</code> <pre><code>@classmethod\ndef remove(cls, element_path: ElementPath, parent_element: Element) -&gt; Tuple[RemoveAction, Element]:\n    \"\"\"For the element_path, remove a model from the parent_element of a given parent_model.\n\n    First we check if there is an existing element at that path\n    If not, we complain.\n    Then we set up an action plan to update the model (specified by file_path) in memory,\n    return the action and return the parent_element.\n\n    LIMITATIONS:\n    1. This does not remove elements of a list or dict. Instead, the entire list or dict is removed.\n    2. This cannot remove arbitrarily named elements that are not specified in the schema.\n    For example, \"responsible-parties\" contains named elements, e.g., \"organisation\". The tool will not\n    remove the \"organisation\" as it is not in the schema, but one can remove its elements, e.g., \"party-uuids\".\n    \"\"\"\n    element_path_list = element_path.get_full_path_parts()\n    if '*' in element_path_list:\n        raise err.TrestleError('trestle remove does not support Wildcard element path.')\n\n    deleting_element = parent_element.get_at(element_path)\n\n    if deleting_element is not None:\n        # The element already exists\n        if type(deleting_element) is list:\n            logger.warning(\n                'Warning: trestle remove does not support removing elements of a list: '\n                'this removes the entire list'\n            )\n        elif type(deleting_element) is dict:\n            logger.warning(\n                'Warning: trestle remove does not support removing dict elements: '\n                'this removes the entire dict element'\n            )\n    else:\n        raise err.TrestleError(f'Bad element path: {str(element_path)}')\n\n    remove_action = RemoveAction(parent_element, element_path)\n\n    return remove_action, parent_element\n</code></pre>"},{"location":"reference/API/trestle/core/commands/replicate/","title":"trestle.core.commands.replicate","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate","title":"<code>trestle.core.commands.replicate</code>","text":"<p>Trestle Replicate Command.</p>"},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate.ReplicateCmd","title":"<code>ReplicateCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Replicate a top level model within the trestle directory structure.</p> Source code in <code>trestle/core/commands/replicate.py</code> <pre><code>class ReplicateCmd(CommandPlusDocs):\n    \"\"\"Replicate a top level model within the trestle directory structure.\"\"\"\n\n    name = 'replicate'\n\n    def _init_arguments(self) -&gt; None:\n        logger.debug('Init arguments')\n\n        self.add_argument('model', help='Choose OSCAL model', choices=const.MODEL_TYPE_LIST)\n        self.add_argument('-n', '--name', help='Name of model to replicate.', type=str, required=True)\n        self.add_argument('-o', '--output', help='Name of replicated model.', type=str, required=True)\n        self.add_argument('-r', '--regenerate', action='store_true', help=const.HELP_REGENERATE)\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"Execute and process the args.\"\"\"\n        try:\n            log.set_log_level_from_args(args)\n            return self.replicate_object(args.model, args)\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while replicating model')\n\n    @classmethod\n    def replicate_object(cls, model_alias: str, args: argparse.Namespace) -&gt; int:\n        \"\"\"\n        Core replicate routine invoked by subcommands.\n\n        Args:\n            model_alias: Name of the top level model in the trestle directory.\n            args: CLI arguments\n        Returns:\n            A return code that can be used as standard posix codes. 0 is success.\n        \"\"\"\n        logger.debug('Entering replicate_object.')\n\n        # 1 Bad working directory if not running from current working directory\n        trestle_root = args.trestle_root  # trestle root is set via command line in args. Default is cwd.\n        if not trestle_root or not file_utils.is_valid_project_root(trestle_root):\n            raise TrestleError(f'Given directory: {trestle_root} is not a trestle project.')\n\n        plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n\n        # 2 Check that input file given exists.\n\n        input_file_stem = trestle_root / plural_path / args.name / model_alias\n        content_type = FileContentType.path_to_content_type(input_file_stem)\n        if content_type == FileContentType.UNKNOWN:\n            raise TrestleError(\n                f'Input file {args.name} has no json or yaml file at expected location {input_file_stem}.'\n            )\n\n        input_file = input_file_stem.with_suffix(FileContentType.to_file_extension(content_type))\n\n        # 3 Distributed load from file\n        _, model_alias, model_instance = ModelUtils.load_distributed(input_file, trestle_root)\n\n        rep_model_path = trestle_root / plural_path / args.output / (\n            model_alias + FileContentType.to_file_extension(content_type)\n        )\n\n        if rep_model_path.exists():\n            raise TrestleError(f'OSCAL file to be replicated here: {rep_model_path} exists.')\n\n        if args.regenerate:\n            logger.debug(f'regenerating uuids for model {input_file}')\n            model_instance, uuid_lut, n_refs_updated = ModelUtils.regenerate_uuids(model_instance)\n            logger.debug(f'{len(uuid_lut)} uuids generated and {n_refs_updated} references updated')\n\n        # 4 Prepare actions and plan\n        top_element = Element(model_instance)\n        create_action = CreatePathAction(rep_model_path, True)\n        write_action = WriteFileAction(rep_model_path, top_element, content_type)\n\n        # create a plan to create the directory and imported file.\n        replicate_plan = Plan()\n        replicate_plan.add_action(create_action)\n        replicate_plan.add_action(write_action)\n\n        replicate_plan.execute()\n\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate.ReplicateCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate.ReplicateCmd.name","title":"<code>name = 'replicate'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate.ReplicateCmd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate.ReplicateCmd.replicate_object","title":"<code>replicate_object(model_alias, args)</code>  <code>classmethod</code>","text":"<p>Core replicate routine invoked by subcommands.</p> <p>Parameters:</p> Name Type Description Default <code>model_alias</code> <code>str</code> <p>Name of the top level model in the trestle directory.</p> required <code>args</code> <code>Namespace</code> <p>CLI arguments</p> required <p>Returns:     A return code that can be used as standard posix codes. 0 is success.</p> Source code in <code>trestle/core/commands/replicate.py</code> <pre><code>@classmethod\ndef replicate_object(cls, model_alias: str, args: argparse.Namespace) -&gt; int:\n    \"\"\"\n    Core replicate routine invoked by subcommands.\n\n    Args:\n        model_alias: Name of the top level model in the trestle directory.\n        args: CLI arguments\n    Returns:\n        A return code that can be used as standard posix codes. 0 is success.\n    \"\"\"\n    logger.debug('Entering replicate_object.')\n\n    # 1 Bad working directory if not running from current working directory\n    trestle_root = args.trestle_root  # trestle root is set via command line in args. Default is cwd.\n    if not trestle_root or not file_utils.is_valid_project_root(trestle_root):\n        raise TrestleError(f'Given directory: {trestle_root} is not a trestle project.')\n\n    plural_path = ModelUtils.model_type_to_model_dir(model_alias)\n\n    # 2 Check that input file given exists.\n\n    input_file_stem = trestle_root / plural_path / args.name / model_alias\n    content_type = FileContentType.path_to_content_type(input_file_stem)\n    if content_type == FileContentType.UNKNOWN:\n        raise TrestleError(\n            f'Input file {args.name} has no json or yaml file at expected location {input_file_stem}.'\n        )\n\n    input_file = input_file_stem.with_suffix(FileContentType.to_file_extension(content_type))\n\n    # 3 Distributed load from file\n    _, model_alias, model_instance = ModelUtils.load_distributed(input_file, trestle_root)\n\n    rep_model_path = trestle_root / plural_path / args.output / (\n        model_alias + FileContentType.to_file_extension(content_type)\n    )\n\n    if rep_model_path.exists():\n        raise TrestleError(f'OSCAL file to be replicated here: {rep_model_path} exists.')\n\n    if args.regenerate:\n        logger.debug(f'regenerating uuids for model {input_file}')\n        model_instance, uuid_lut, n_refs_updated = ModelUtils.regenerate_uuids(model_instance)\n        logger.debug(f'{len(uuid_lut)} uuids generated and {n_refs_updated} references updated')\n\n    # 4 Prepare actions and plan\n    top_element = Element(model_instance)\n    create_action = CreatePathAction(rep_model_path, True)\n    write_action = WriteFileAction(rep_model_path, top_element, content_type)\n\n    # create a plan to create the directory and imported file.\n    replicate_plan = Plan()\n    replicate_plan.add_action(create_action)\n    replicate_plan.add_action(write_action)\n\n    replicate_plan.execute()\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/replicate/#trestle.core.commands.replicate-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/split/","title":"trestle.core.commands.split","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split","title":"<code>trestle.core.commands.split</code>","text":"<p>Trestle Split Command.</p>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.trace","title":"<code>trace = log.Trace(logger)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.AliasTracker","title":"<code>AliasTracker</code>","text":"<p>               Bases: <code>TrestleBaseModel</code></p> <p>Convenience class to track writing out of models.</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>class AliasTracker(TrestleBaseModel):\n    \"\"\"Convenience class to track writing out of models.\"\"\"\n\n    # This tracks the parts that need to be split from each element\n    # and makes sure it is written out once\n\n    aliases: List[str]\n    written: bool = False\n\n    def add_alias(self, alias: str) -&gt; None:\n        \"\"\"Add alias.\"\"\"\n        if alias not in self.aliases:\n            self.aliases.append(alias)\n\n    def get_aliases(self) -&gt; List[str]:\n        \"\"\"Get the list of aliases.\"\"\"\n        return self.aliases\n\n    def needs_writing(self) -&gt; bool:\n        \"\"\"Need to write the model.\"\"\"\n        return not self.written\n\n    def mark_written(self) -&gt; None:\n        \"\"\"Mark this model as written.\"\"\"\n        self.written = True\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.AliasTracker-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.AliasTracker.aliases","title":"<code>aliases: List[str]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.AliasTracker.written","title":"<code>written: bool = False</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.AliasTracker-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.AliasTracker.add_alias","title":"<code>add_alias(alias)</code>","text":"<p>Add alias.</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>def add_alias(self, alias: str) -&gt; None:\n    \"\"\"Add alias.\"\"\"\n    if alias not in self.aliases:\n        self.aliases.append(alias)\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.AliasTracker.get_aliases","title":"<code>get_aliases()</code>","text":"<p>Get the list of aliases.</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>def get_aliases(self) -&gt; List[str]:\n    \"\"\"Get the list of aliases.\"\"\"\n    return self.aliases\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.AliasTracker.mark_written","title":"<code>mark_written()</code>","text":"<p>Mark this model as written.</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>def mark_written(self) -&gt; None:\n    \"\"\"Mark this model as written.\"\"\"\n    self.written = True\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.AliasTracker.needs_writing","title":"<code>needs_writing()</code>","text":"<p>Need to write the model.</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>def needs_writing(self) -&gt; bool:\n    \"\"\"Need to write the model.\"\"\"\n    return not self.written\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.SplitCmd","title":"<code>SplitCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Split subcomponents on a trestle model.</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>class SplitCmd(CommandPlusDocs):\n    \"\"\"Split subcomponents on a trestle model.\"\"\"\n\n    name = 'split'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument(\n            f'-{const.ARG_FILE_SHORT}', f'--{const.ARG_FILE}', help=const.ARG_DESC_FILE + ' to split.', required=False\n        )\n        self.add_argument(\n            f'-{const.ARG_ELEMENT_SHORT}',\n            f'--{const.ARG_ELEMENT}',\n            help=const.ARG_DESC_ELEMENT + ' to split.',\n            required=False\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"Split an OSCAL file into elements.\"\"\"\n        try:\n            log.set_log_level_from_args(args)\n            trace.log('Entering trestle split.')\n            # get the Model\n            args_raw: Dict[str, str] = args.__dict__\n\n            # remove any quotes passed in as on windows platforms\n            elements_clean: str = args_raw[const.ARG_ELEMENT].strip(\"'\")\n\n            file_name = ''\n            file_name = '' if not args_raw[const.ARG_FILE] else args_raw[const.ARG_FILE]\n            # cwd must be in the model directory if file to split is not specified\n            effective_cwd = pathlib.Path.cwd()\n\n            return self.perform_split(effective_cwd, file_name, elements_clean, args.trestle_root)\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while performing a split operation')\n\n    @classmethod\n    def perform_split(\n        cls, effective_cwd: pathlib.Path, file_name: str, elements: str, trestle_root: pathlib.Path\n    ) -&gt; int:\n        \"\"\"Perform the split operation.\n\n        Args:\n            effective_cwd: effective directory in which the the split operation is performed\n            file_name: file name of model to split, or '' if deduced from elements and cwd\n            elements: comma separated list of paths to strip from the file, with quotes removed\n\n        Returns:\n            0 on success and 1 on failure\n        \"\"\"\n        file_path_list: List[Tuple[str, str]] = []\n\n        if file_name:\n            file_path_list.append((file_name, elements))\n        else:\n            # cwd must be in the model directory if file to split is not specified\n            # find top directory for this model based on trestle root and cwd\n            model_dir = file_utils.extract_project_model_path(effective_cwd)\n            if model_dir is None:\n                raise TrestleError('Current directory must be within a model directory if file is not specified')\n\n            content_type: FileContentType = FileContentType.dir_to_content_type(model_dir)\n\n            # determine the file needed for each split path\n            element_paths = elements.split(',')\n            for path in element_paths:\n                element_path = ElementPath(path)\n                # if element path is relative use directory context to determine absolute path\n                element_path.make_absolute(model_dir, effective_cwd)\n                file_path = element_path.find_last_file_in_path(content_type, model_dir)\n                # now make the element path relative to the model file to be loaded\n                if file_path is None or element_path.make_relative(file_path.relative_to(model_dir)) != 0:\n                    raise TrestleError(f'Unable to match element path with files in model directory {element_path}')\n\n                file_path_list.append((file_path, element_path.to_string()))\n\n        # match paths to corresponding files since several paths may be split from the same file\n        file_path_dict: Dict[str, str] = {}\n        for file_path in file_path_list:\n            key = file_path[0]  # type: ignore\n            path = file_path[1]  # type: ignore\n            if key not in file_path_dict:\n                file_path_dict[key] = path\n            else:\n                current_path = file_path_dict[key]\n                file_path_dict[key] = f'{current_path},{path}'\n\n        for raw_file_name, element_path in file_path_dict.items():\n            file_path = file_utils.relative_resolve(pathlib.Path(raw_file_name), effective_cwd)\n            # this makes assumptions that the path is relative.\n            if not file_path.exists():\n                raise TrestleError(f'File {file_path} does not exist.')\n\n            content_type = FileContentType.to_content_type(file_path.suffix)\n\n            # find the base directory of the file\n            base_dir = file_path.parent\n            model_type, _ = ModelUtils.get_stripped_model_type(file_path, trestle_root)\n\n            model: OscalBaseModel = model_type.oscal_read(file_path)\n\n            if cmd_utils.split_is_too_fine(element_path, model):\n                raise TrestleError('Cannot split the model to the level of uuids, strings, etc.')\n\n            # use the model itself to resolve any wildcards and create list of element paths\n            logger.debug(f'split calling parse_element_args on {element_path}')\n            # use contextual mode to parse\n\n            element_paths: List[ElementPath] = cmd_utils.parse_element_args(\n                model, element_path.split(','), base_dir.relative_to(trestle_root)\n            )\n\n            # analyze the split tree and determine which aliases should be stripped from each file\n            aliases_to_strip = cls.find_aliases_to_strip(element_paths)\n\n            # need the file name relative to the base directory\n            file_name_no_path = str(file_path.name)\n\n            split_plan = cls.split_model(\n                model, element_paths, base_dir, content_type, file_name_no_path, aliases_to_strip\n            )\n            trash.store(file_path, True)\n\n            try:\n                split_plan.execute()\n            except Exception as e:\n                trash.recover(file_path, True)\n                raise TrestleError(f'Split has failed with error: {e}.')\n\n        return CmdReturnCodes.SUCCESS.value\n\n    @classmethod\n    def prepare_sub_model_split_actions(\n        cls,\n        sub_model_item: OscalBaseModel,\n        sub_model_dir: pathlib.Path,\n        file_prefix: str,\n        content_type: FileContentType\n    ) -&gt; List[Action]:\n        \"\"\"Create split actions of sub model.\"\"\"\n        actions: List[Action] = []\n        file_name = cmd_utils.to_model_file_name(sub_model_item, file_prefix, content_type)\n        model_type = classname_to_alias(type(sub_model_item).__name__, AliasMode.JSON)\n        sub_model_file = sub_model_dir / file_name\n        actions.append(CreatePathAction(sub_model_file))\n        actions.append(WriteFileAction(sub_model_file, Element(sub_model_item, model_type), content_type))\n        return actions\n\n    @classmethod\n    def split_model_at_path_chain(\n        cls,\n        model_obj: OscalBaseModel,\n        element_paths: List[ElementPath],\n        base_dir: pathlib.Path,\n        content_type: FileContentType,\n        cur_path_index: int,\n        split_plan: Plan,\n        strip_root: bool,\n        root_file_name: str,\n        aliases_to_strip: Dict[str, AliasTracker],\n        last_one: bool = True\n    ) -&gt; int:\n        \"\"\"Recursively split the model at the provided chain of element paths.\n\n        It assumes that a chain of element paths starts at the cur_path_index with the first path ending\n        with a wildcard (*)\n\n        If the wildcard follows an element that is inherently a list of items, the list of items is extracted.\n        But if the wildcard follows a generic model than members of that model class found in the model will be\n        split off.  But only the non-trivial elements are removed, i.e. not str, int, datetime, etc.\n\n        Args:\n            model_obj: The OscalBaseModel to be split\n            element_paths: The List[ElementPath] of elements to split, including embedded wildcards\n            base_dir: pathlib.Path of the file being split\n            content_type: json or yaml files\n            cur_path_index: Index into the list of element paths for the current split operation\n            split_plan: The accumulated plan of actions needed to perform the split\n            strip_root: Whether to strip elements from the root object\n            root_file_name: Filename of root file that gets split into a list of items\n            aliases_to_strip: AliasTracker previously loaded with aliases that need to be split from each element\n            last_one: bool indicating last item in array has been split and stripped model can now be written\n\n        Returns:\n            int representing the index where the chain of the path ends.\n\n        Examples:\n            For example, element paths could have a list of paths as below for a `ComponentDefinition` model where\n            the first path is the start of the chain.\n\n            For each of the sub model described by the first element path (e.g component-defintion.components.*) in the\n            chain, the subsequent paths (e.g component.control-implementations.*) will be applied recursively\n            to retrieve the sub-sub models:\n            [\n                'component-definition.component.*',\n                'component.control-implementations.*'\n            ]\n            for a command like below:\n            trestle split -f component.yaml -e component-definition.components.*.control-implementations.*\n        \"\"\"\n        if split_plan is None:\n            raise TrestleError('Split plan must have been initialized')\n\n        if cur_path_index &lt; 0:\n            raise TrestleError('Current index of the chain of paths cannot be less than 0')\n\n        # if there are no more element_paths, return the current plan\n        if cur_path_index &gt;= len(element_paths):\n            return cur_path_index\n\n        # initialize local variables\n        element = Element(model_obj)\n        stripped_field_alias: List[str] = []\n\n        # get the sub_model specified by the element_path of this round\n        element_path = element_paths[cur_path_index]\n\n        # does the next element_path point back at me\n        is_parent = cur_path_index + 1 &lt; len(element_paths) and element_paths[cur_path_index\n                                                                              + 1].get_parent() == element_path\n\n        # root dir name for sub models dir\n        # 00000__group.json will have the root_dir name as 00000__group for sub models of group\n        # catalog.json will have the root_dir name as catalog\n        root_dir = ''\n        if root_file_name != '':\n            root_dir = str(pathlib.Path(root_file_name).with_suffix(''))\n\n        sub_models = element.get_at(element_path, False)  # we call sub_models as in plural, but it can be just one\n\n        # assume cur_path_index is the end of the chain\n        # value of this variable may change during recursive split of the sub-models below\n        path_chain_end = cur_path_index\n\n        # if wildcard is present in the element_path and the next path in the chain has current path as the parent,\n        # Then deal with case of list, or split of arbitrary oscalbasemodel\n        if is_parent and element_path.get_last() is not ElementPath.WILDCARD:\n            # create dir for all sub model items\n            sub_models_dir = base_dir / element_path.to_root_path()\n            sub_model_plan = Plan()\n            path_chain_end = cls.split_model_at_path_chain(\n                sub_models,\n                element_paths,\n                sub_models_dir,\n                content_type,\n                cur_path_index + 1,\n                sub_model_plan,\n                True,\n                '',\n                aliases_to_strip\n            )\n            sub_model_actions = sub_model_plan.get_actions()\n            split_plan.add_actions(sub_model_actions)\n        elif element_path.get_last() == ElementPath.WILDCARD:\n            # extract sub-models into a dict with appropriate prefix\n            sub_model_items: Dict[str, OscalBaseModel] = {}\n            sub_models_dir = base_dir / element_path.to_file_path(root_dir=root_dir)\n            if isinstance(sub_models, list):\n                for i, sub_model_item in enumerate(sub_models):\n                    # e.g. `groups/00000_groups/`\n                    prefix = str(i).zfill(const.FILE_DIGIT_PREFIX_LENGTH)\n                    sub_model_items[prefix] = sub_model_item\n\n            # process list sub model items\n            count = 0\n            for key, sub_model_item in sub_model_items.items():\n                count += 1\n                # recursively split the sub-model if there are more element paths to traverse\n                # e.g. split component.control-implementations.*\n                require_recursive_split = cur_path_index + 1 &lt; len(element_paths) and element_paths[\n                    cur_path_index + 1].get_parent() == element_path\n\n                if require_recursive_split:\n                    # prepare individual directory for each sub-model\n                    sub_root_file_name = cmd_utils.to_model_file_name(sub_model_item, key, content_type)\n                    sub_model_plan = Plan()\n\n                    last_one: bool = count == len(sub_model_items)\n                    path_chain_end = cls.split_model_at_path_chain(\n                        sub_model_item,\n                        element_paths,\n                        sub_models_dir,\n                        content_type,\n                        cur_path_index + 1,\n                        sub_model_plan,\n                        True,\n                        sub_root_file_name,\n                        aliases_to_strip,\n                        last_one\n                    )\n                    sub_model_actions = sub_model_plan.get_actions()\n                else:\n                    sub_model_actions = cls.prepare_sub_model_split_actions(\n                        sub_model_item, sub_models_dir, key, content_type\n                    )\n\n                split_plan.add_actions(sub_model_actions)\n        else:\n            # the chain of path ends at the current index.\n            # so no recursive call. Let's just write the sub model to the file and get out\n            if sub_models is not None:\n                sub_model_file = base_dir / element_path.to_file_path(content_type, root_dir=root_dir)\n                split_plan.add_action(CreatePathAction(sub_model_file))\n                split_plan.add_action(\n                    WriteFileAction(sub_model_file, Element(sub_models, element_path.get_element_name()), content_type)\n                )\n\n        # Strip the root model and add a WriteAction for the updated model object in the plan\n        if strip_root:\n            full_path = element_path.get_full()\n            path = '.'.join(full_path.split('.')[:-1])\n            aliases = [element_path.get_element_name()]\n            need_to_write = True\n            use_alias_dict = aliases_to_strip is not None and path in aliases_to_strip\n            if use_alias_dict:\n                aliases = aliases_to_strip[path].get_aliases()\n                need_to_write = aliases_to_strip[path].needs_writing()\n\n            stripped_model = model_obj.stripped_instance(stripped_fields_aliases=aliases)\n            # can mark it written even if it doesn't need writing since it is empty\n            # but if an array only mark it written if it's the last one\n            if last_one and use_alias_dict:\n                aliases_to_strip[path].mark_written()\n            # If it's an empty model after stripping the fields, don't create path and don't write\n            field_list = [x for x in model_obj.__fields__.keys() if model_obj.__fields__[x] is not None]\n            if set(field_list) == set(stripped_field_alias):\n                return path_chain_end\n\n            if need_to_write:\n                if root_file_name != '':\n                    root_file = base_dir / root_file_name\n                else:\n                    root_file = base_dir / element_path.to_root_path(content_type)\n\n                split_plan.add_action(CreatePathAction(root_file))\n                wrapper_alias = classname_to_alias(stripped_model.__class__.__name__, AliasMode.JSON)\n                split_plan.add_action(WriteFileAction(root_file, Element(stripped_model, wrapper_alias), content_type))\n\n        # return the end of the current path chain\n        return path_chain_end\n\n    @classmethod\n    def split_model(\n        cls,\n        model_obj: OscalBaseModel,\n        element_paths: List[ElementPath],\n        base_dir: pathlib.Path,\n        content_type: FileContentType,\n        root_file_name: str,\n        aliases_to_strip: Dict[str, AliasTracker]\n    ) -&gt; Plan:\n        \"\"\"Split the model at the provided element paths.\n\n        It returns a plan for the operation\n        \"\"\"\n        # initialize plan\n        split_plan = Plan()\n\n        # loop through the element path list and update the split_plan\n        stripped_field_alias = []\n        cur_path_index = 0\n        while cur_path_index &lt; len(element_paths):\n            # extract the sub element name for each of the root path of the path chain\n            element_path = element_paths[cur_path_index]\n\n            if element_path.get_parent() is None and len(element_path.get()) &gt; 1:\n                stripped_part = element_path.get()[1]\n                if stripped_part == ElementPath.WILDCARD:\n                    stripped_field_alias.append('__root__')\n                else:\n                    if stripped_part not in stripped_field_alias:\n                        stripped_field_alias.append(stripped_part)\n\n            # split model at the path chain\n            cur_path_index = cls.split_model_at_path_chain(\n                model_obj,\n                element_paths,\n                base_dir,\n                content_type,\n                cur_path_index,\n                split_plan,\n                False,\n                root_file_name,\n                aliases_to_strip\n            )\n\n            cur_path_index += 1\n\n        # strip the root model object and add a WriteAction\n        stripped_root = model_obj.stripped_instance(stripped_fields_aliases=stripped_field_alias)\n        # If it's an empty model after stripping the fields, don't create path and don't write\n        if set(model_obj.__fields__.keys()) == set(stripped_field_alias):\n            return split_plan\n        if root_file_name != '':\n            root_file = base_dir / root_file_name\n        else:\n            root_file = base_dir / element_paths[0].to_root_path(content_type)\n        split_plan.add_action(CreatePathAction(root_file, True))\n        wrapper_alias = classname_to_alias(stripped_root.__class__.__name__, AliasMode.JSON)\n        split_plan.add_action(WriteFileAction(root_file, Element(stripped_root, wrapper_alias), content_type))\n\n        return split_plan\n\n    @classmethod\n    def find_aliases_to_strip(cls, element_paths: List[ElementPath]) -&gt; Dict[str, AliasTracker]:\n        \"\"\"Find list of aliases that need to be stripped as each element written out.\"\"\"\n        # A given path may be present in several split actions\n        # Need to determine all parts stripped at each node in order to strip them all and\n        # write the stripped model only once\n        tracker_map: Dict[str, AliasTracker] = {}\n        for element_path in element_paths:\n            path = element_path.get_full()\n            path_parts = path.split('.')\n            alias = path_parts[-1]\n            if len(path_parts) &gt; 2 and alias != '*':\n                root_path = '.'.join(path_parts[:-1])\n                if root_path in tracker_map:\n                    tracker_map[root_path].add_alias(alias)\n                else:\n                    tracker_map[root_path] = AliasTracker(aliases=[alias])\n        return tracker_map\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.SplitCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.SplitCmd.name","title":"<code>name = 'split'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.SplitCmd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.SplitCmd.find_aliases_to_strip","title":"<code>find_aliases_to_strip(element_paths)</code>  <code>classmethod</code>","text":"<p>Find list of aliases that need to be stripped as each element written out.</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>@classmethod\ndef find_aliases_to_strip(cls, element_paths: List[ElementPath]) -&gt; Dict[str, AliasTracker]:\n    \"\"\"Find list of aliases that need to be stripped as each element written out.\"\"\"\n    # A given path may be present in several split actions\n    # Need to determine all parts stripped at each node in order to strip them all and\n    # write the stripped model only once\n    tracker_map: Dict[str, AliasTracker] = {}\n    for element_path in element_paths:\n        path = element_path.get_full()\n        path_parts = path.split('.')\n        alias = path_parts[-1]\n        if len(path_parts) &gt; 2 and alias != '*':\n            root_path = '.'.join(path_parts[:-1])\n            if root_path in tracker_map:\n                tracker_map[root_path].add_alias(alias)\n            else:\n                tracker_map[root_path] = AliasTracker(aliases=[alias])\n    return tracker_map\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.SplitCmd.perform_split","title":"<code>perform_split(effective_cwd, file_name, elements, trestle_root)</code>  <code>classmethod</code>","text":"<p>Perform the split operation.</p> <p>Parameters:</p> Name Type Description Default <code>effective_cwd</code> <code>Path</code> <p>effective directory in which the the split operation is performed</p> required <code>file_name</code> <code>str</code> <p>file name of model to split, or '' if deduced from elements and cwd</p> required <code>elements</code> <code>str</code> <p>comma separated list of paths to strip from the file, with quotes removed</p> required <p>Returns:</p> Type Description <code>int</code> <p>0 on success and 1 on failure</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>@classmethod\ndef perform_split(\n    cls, effective_cwd: pathlib.Path, file_name: str, elements: str, trestle_root: pathlib.Path\n) -&gt; int:\n    \"\"\"Perform the split operation.\n\n    Args:\n        effective_cwd: effective directory in which the the split operation is performed\n        file_name: file name of model to split, or '' if deduced from elements and cwd\n        elements: comma separated list of paths to strip from the file, with quotes removed\n\n    Returns:\n        0 on success and 1 on failure\n    \"\"\"\n    file_path_list: List[Tuple[str, str]] = []\n\n    if file_name:\n        file_path_list.append((file_name, elements))\n    else:\n        # cwd must be in the model directory if file to split is not specified\n        # find top directory for this model based on trestle root and cwd\n        model_dir = file_utils.extract_project_model_path(effective_cwd)\n        if model_dir is None:\n            raise TrestleError('Current directory must be within a model directory if file is not specified')\n\n        content_type: FileContentType = FileContentType.dir_to_content_type(model_dir)\n\n        # determine the file needed for each split path\n        element_paths = elements.split(',')\n        for path in element_paths:\n            element_path = ElementPath(path)\n            # if element path is relative use directory context to determine absolute path\n            element_path.make_absolute(model_dir, effective_cwd)\n            file_path = element_path.find_last_file_in_path(content_type, model_dir)\n            # now make the element path relative to the model file to be loaded\n            if file_path is None or element_path.make_relative(file_path.relative_to(model_dir)) != 0:\n                raise TrestleError(f'Unable to match element path with files in model directory {element_path}')\n\n            file_path_list.append((file_path, element_path.to_string()))\n\n    # match paths to corresponding files since several paths may be split from the same file\n    file_path_dict: Dict[str, str] = {}\n    for file_path in file_path_list:\n        key = file_path[0]  # type: ignore\n        path = file_path[1]  # type: ignore\n        if key not in file_path_dict:\n            file_path_dict[key] = path\n        else:\n            current_path = file_path_dict[key]\n            file_path_dict[key] = f'{current_path},{path}'\n\n    for raw_file_name, element_path in file_path_dict.items():\n        file_path = file_utils.relative_resolve(pathlib.Path(raw_file_name), effective_cwd)\n        # this makes assumptions that the path is relative.\n        if not file_path.exists():\n            raise TrestleError(f'File {file_path} does not exist.')\n\n        content_type = FileContentType.to_content_type(file_path.suffix)\n\n        # find the base directory of the file\n        base_dir = file_path.parent\n        model_type, _ = ModelUtils.get_stripped_model_type(file_path, trestle_root)\n\n        model: OscalBaseModel = model_type.oscal_read(file_path)\n\n        if cmd_utils.split_is_too_fine(element_path, model):\n            raise TrestleError('Cannot split the model to the level of uuids, strings, etc.')\n\n        # use the model itself to resolve any wildcards and create list of element paths\n        logger.debug(f'split calling parse_element_args on {element_path}')\n        # use contextual mode to parse\n\n        element_paths: List[ElementPath] = cmd_utils.parse_element_args(\n            model, element_path.split(','), base_dir.relative_to(trestle_root)\n        )\n\n        # analyze the split tree and determine which aliases should be stripped from each file\n        aliases_to_strip = cls.find_aliases_to_strip(element_paths)\n\n        # need the file name relative to the base directory\n        file_name_no_path = str(file_path.name)\n\n        split_plan = cls.split_model(\n            model, element_paths, base_dir, content_type, file_name_no_path, aliases_to_strip\n        )\n        trash.store(file_path, True)\n\n        try:\n            split_plan.execute()\n        except Exception as e:\n            trash.recover(file_path, True)\n            raise TrestleError(f'Split has failed with error: {e}.')\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.SplitCmd.prepare_sub_model_split_actions","title":"<code>prepare_sub_model_split_actions(sub_model_item, sub_model_dir, file_prefix, content_type)</code>  <code>classmethod</code>","text":"<p>Create split actions of sub model.</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>@classmethod\ndef prepare_sub_model_split_actions(\n    cls,\n    sub_model_item: OscalBaseModel,\n    sub_model_dir: pathlib.Path,\n    file_prefix: str,\n    content_type: FileContentType\n) -&gt; List[Action]:\n    \"\"\"Create split actions of sub model.\"\"\"\n    actions: List[Action] = []\n    file_name = cmd_utils.to_model_file_name(sub_model_item, file_prefix, content_type)\n    model_type = classname_to_alias(type(sub_model_item).__name__, AliasMode.JSON)\n    sub_model_file = sub_model_dir / file_name\n    actions.append(CreatePathAction(sub_model_file))\n    actions.append(WriteFileAction(sub_model_file, Element(sub_model_item, model_type), content_type))\n    return actions\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.SplitCmd.split_model","title":"<code>split_model(model_obj, element_paths, base_dir, content_type, root_file_name, aliases_to_strip)</code>  <code>classmethod</code>","text":"<p>Split the model at the provided element paths.</p> <p>It returns a plan for the operation</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>@classmethod\ndef split_model(\n    cls,\n    model_obj: OscalBaseModel,\n    element_paths: List[ElementPath],\n    base_dir: pathlib.Path,\n    content_type: FileContentType,\n    root_file_name: str,\n    aliases_to_strip: Dict[str, AliasTracker]\n) -&gt; Plan:\n    \"\"\"Split the model at the provided element paths.\n\n    It returns a plan for the operation\n    \"\"\"\n    # initialize plan\n    split_plan = Plan()\n\n    # loop through the element path list and update the split_plan\n    stripped_field_alias = []\n    cur_path_index = 0\n    while cur_path_index &lt; len(element_paths):\n        # extract the sub element name for each of the root path of the path chain\n        element_path = element_paths[cur_path_index]\n\n        if element_path.get_parent() is None and len(element_path.get()) &gt; 1:\n            stripped_part = element_path.get()[1]\n            if stripped_part == ElementPath.WILDCARD:\n                stripped_field_alias.append('__root__')\n            else:\n                if stripped_part not in stripped_field_alias:\n                    stripped_field_alias.append(stripped_part)\n\n        # split model at the path chain\n        cur_path_index = cls.split_model_at_path_chain(\n            model_obj,\n            element_paths,\n            base_dir,\n            content_type,\n            cur_path_index,\n            split_plan,\n            False,\n            root_file_name,\n            aliases_to_strip\n        )\n\n        cur_path_index += 1\n\n    # strip the root model object and add a WriteAction\n    stripped_root = model_obj.stripped_instance(stripped_fields_aliases=stripped_field_alias)\n    # If it's an empty model after stripping the fields, don't create path and don't write\n    if set(model_obj.__fields__.keys()) == set(stripped_field_alias):\n        return split_plan\n    if root_file_name != '':\n        root_file = base_dir / root_file_name\n    else:\n        root_file = base_dir / element_paths[0].to_root_path(content_type)\n    split_plan.add_action(CreatePathAction(root_file, True))\n    wrapper_alias = classname_to_alias(stripped_root.__class__.__name__, AliasMode.JSON)\n    split_plan.add_action(WriteFileAction(root_file, Element(stripped_root, wrapper_alias), content_type))\n\n    return split_plan\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split.SplitCmd.split_model_at_path_chain","title":"<code>split_model_at_path_chain(model_obj, element_paths, base_dir, content_type, cur_path_index, split_plan, strip_root, root_file_name, aliases_to_strip, last_one=True)</code>  <code>classmethod</code>","text":"<p>Recursively split the model at the provided chain of element paths.</p> <p>It assumes that a chain of element paths starts at the cur_path_index with the first path ending with a wildcard (*)</p> <p>If the wildcard follows an element that is inherently a list of items, the list of items is extracted. But if the wildcard follows a generic model than members of that model class found in the model will be split off.  But only the non-trivial elements are removed, i.e. not str, int, datetime, etc.</p> <p>Parameters:</p> Name Type Description Default <code>model_obj</code> <code>OscalBaseModel</code> <p>The OscalBaseModel to be split</p> required <code>element_paths</code> <code>List[ElementPath]</code> <p>The List[ElementPath] of elements to split, including embedded wildcards</p> required <code>base_dir</code> <code>Path</code> <p>pathlib.Path of the file being split</p> required <code>content_type</code> <code>FileContentType</code> <p>json or yaml files</p> required <code>cur_path_index</code> <code>int</code> <p>Index into the list of element paths for the current split operation</p> required <code>split_plan</code> <code>Plan</code> <p>The accumulated plan of actions needed to perform the split</p> required <code>strip_root</code> <code>bool</code> <p>Whether to strip elements from the root object</p> required <code>root_file_name</code> <code>str</code> <p>Filename of root file that gets split into a list of items</p> required <code>aliases_to_strip</code> <code>Dict[str, AliasTracker]</code> <p>AliasTracker previously loaded with aliases that need to be split from each element</p> required <code>last_one</code> <code>bool</code> <p>bool indicating last item in array has been split and stripped model can now be written</p> <code>True</code> <p>Returns:</p> Type Description <code>int</code> <p>int representing the index where the chain of the path ends.</p> <p>Examples:</p> <p>For example, element paths could have a list of paths as below for a <code>ComponentDefinition</code> model where the first path is the start of the chain.</p> <p>For each of the sub model described by the first element path (e.g component-defintion.components.) in the chain, the subsequent paths (e.g component.control-implementations.) will be applied recursively to retrieve the sub-sub models: [     'component-definition.component.',     'component.control-implementations.' ] for a command like below: trestle split -f component.yaml -e component-definition.components..control-implementations.</p> Source code in <code>trestle/core/commands/split.py</code> <pre><code>@classmethod\ndef split_model_at_path_chain(\n    cls,\n    model_obj: OscalBaseModel,\n    element_paths: List[ElementPath],\n    base_dir: pathlib.Path,\n    content_type: FileContentType,\n    cur_path_index: int,\n    split_plan: Plan,\n    strip_root: bool,\n    root_file_name: str,\n    aliases_to_strip: Dict[str, AliasTracker],\n    last_one: bool = True\n) -&gt; int:\n    \"\"\"Recursively split the model at the provided chain of element paths.\n\n    It assumes that a chain of element paths starts at the cur_path_index with the first path ending\n    with a wildcard (*)\n\n    If the wildcard follows an element that is inherently a list of items, the list of items is extracted.\n    But if the wildcard follows a generic model than members of that model class found in the model will be\n    split off.  But only the non-trivial elements are removed, i.e. not str, int, datetime, etc.\n\n    Args:\n        model_obj: The OscalBaseModel to be split\n        element_paths: The List[ElementPath] of elements to split, including embedded wildcards\n        base_dir: pathlib.Path of the file being split\n        content_type: json or yaml files\n        cur_path_index: Index into the list of element paths for the current split operation\n        split_plan: The accumulated plan of actions needed to perform the split\n        strip_root: Whether to strip elements from the root object\n        root_file_name: Filename of root file that gets split into a list of items\n        aliases_to_strip: AliasTracker previously loaded with aliases that need to be split from each element\n        last_one: bool indicating last item in array has been split and stripped model can now be written\n\n    Returns:\n        int representing the index where the chain of the path ends.\n\n    Examples:\n        For example, element paths could have a list of paths as below for a `ComponentDefinition` model where\n        the first path is the start of the chain.\n\n        For each of the sub model described by the first element path (e.g component-defintion.components.*) in the\n        chain, the subsequent paths (e.g component.control-implementations.*) will be applied recursively\n        to retrieve the sub-sub models:\n        [\n            'component-definition.component.*',\n            'component.control-implementations.*'\n        ]\n        for a command like below:\n        trestle split -f component.yaml -e component-definition.components.*.control-implementations.*\n    \"\"\"\n    if split_plan is None:\n        raise TrestleError('Split plan must have been initialized')\n\n    if cur_path_index &lt; 0:\n        raise TrestleError('Current index of the chain of paths cannot be less than 0')\n\n    # if there are no more element_paths, return the current plan\n    if cur_path_index &gt;= len(element_paths):\n        return cur_path_index\n\n    # initialize local variables\n    element = Element(model_obj)\n    stripped_field_alias: List[str] = []\n\n    # get the sub_model specified by the element_path of this round\n    element_path = element_paths[cur_path_index]\n\n    # does the next element_path point back at me\n    is_parent = cur_path_index + 1 &lt; len(element_paths) and element_paths[cur_path_index\n                                                                          + 1].get_parent() == element_path\n\n    # root dir name for sub models dir\n    # 00000__group.json will have the root_dir name as 00000__group for sub models of group\n    # catalog.json will have the root_dir name as catalog\n    root_dir = ''\n    if root_file_name != '':\n        root_dir = str(pathlib.Path(root_file_name).with_suffix(''))\n\n    sub_models = element.get_at(element_path, False)  # we call sub_models as in plural, but it can be just one\n\n    # assume cur_path_index is the end of the chain\n    # value of this variable may change during recursive split of the sub-models below\n    path_chain_end = cur_path_index\n\n    # if wildcard is present in the element_path and the next path in the chain has current path as the parent,\n    # Then deal with case of list, or split of arbitrary oscalbasemodel\n    if is_parent and element_path.get_last() is not ElementPath.WILDCARD:\n        # create dir for all sub model items\n        sub_models_dir = base_dir / element_path.to_root_path()\n        sub_model_plan = Plan()\n        path_chain_end = cls.split_model_at_path_chain(\n            sub_models,\n            element_paths,\n            sub_models_dir,\n            content_type,\n            cur_path_index + 1,\n            sub_model_plan,\n            True,\n            '',\n            aliases_to_strip\n        )\n        sub_model_actions = sub_model_plan.get_actions()\n        split_plan.add_actions(sub_model_actions)\n    elif element_path.get_last() == ElementPath.WILDCARD:\n        # extract sub-models into a dict with appropriate prefix\n        sub_model_items: Dict[str, OscalBaseModel] = {}\n        sub_models_dir = base_dir / element_path.to_file_path(root_dir=root_dir)\n        if isinstance(sub_models, list):\n            for i, sub_model_item in enumerate(sub_models):\n                # e.g. `groups/00000_groups/`\n                prefix = str(i).zfill(const.FILE_DIGIT_PREFIX_LENGTH)\n                sub_model_items[prefix] = sub_model_item\n\n        # process list sub model items\n        count = 0\n        for key, sub_model_item in sub_model_items.items():\n            count += 1\n            # recursively split the sub-model if there are more element paths to traverse\n            # e.g. split component.control-implementations.*\n            require_recursive_split = cur_path_index + 1 &lt; len(element_paths) and element_paths[\n                cur_path_index + 1].get_parent() == element_path\n\n            if require_recursive_split:\n                # prepare individual directory for each sub-model\n                sub_root_file_name = cmd_utils.to_model_file_name(sub_model_item, key, content_type)\n                sub_model_plan = Plan()\n\n                last_one: bool = count == len(sub_model_items)\n                path_chain_end = cls.split_model_at_path_chain(\n                    sub_model_item,\n                    element_paths,\n                    sub_models_dir,\n                    content_type,\n                    cur_path_index + 1,\n                    sub_model_plan,\n                    True,\n                    sub_root_file_name,\n                    aliases_to_strip,\n                    last_one\n                )\n                sub_model_actions = sub_model_plan.get_actions()\n            else:\n                sub_model_actions = cls.prepare_sub_model_split_actions(\n                    sub_model_item, sub_models_dir, key, content_type\n                )\n\n            split_plan.add_actions(sub_model_actions)\n    else:\n        # the chain of path ends at the current index.\n        # so no recursive call. Let's just write the sub model to the file and get out\n        if sub_models is not None:\n            sub_model_file = base_dir / element_path.to_file_path(content_type, root_dir=root_dir)\n            split_plan.add_action(CreatePathAction(sub_model_file))\n            split_plan.add_action(\n                WriteFileAction(sub_model_file, Element(sub_models, element_path.get_element_name()), content_type)\n            )\n\n    # Strip the root model and add a WriteAction for the updated model object in the plan\n    if strip_root:\n        full_path = element_path.get_full()\n        path = '.'.join(full_path.split('.')[:-1])\n        aliases = [element_path.get_element_name()]\n        need_to_write = True\n        use_alias_dict = aliases_to_strip is not None and path in aliases_to_strip\n        if use_alias_dict:\n            aliases = aliases_to_strip[path].get_aliases()\n            need_to_write = aliases_to_strip[path].needs_writing()\n\n        stripped_model = model_obj.stripped_instance(stripped_fields_aliases=aliases)\n        # can mark it written even if it doesn't need writing since it is empty\n        # but if an array only mark it written if it's the last one\n        if last_one and use_alias_dict:\n            aliases_to_strip[path].mark_written()\n        # If it's an empty model after stripping the fields, don't create path and don't write\n        field_list = [x for x in model_obj.__fields__.keys() if model_obj.__fields__[x] is not None]\n        if set(field_list) == set(stripped_field_alias):\n            return path_chain_end\n\n        if need_to_write:\n            if root_file_name != '':\n                root_file = base_dir / root_file_name\n            else:\n                root_file = base_dir / element_path.to_root_path(content_type)\n\n            split_plan.add_action(CreatePathAction(root_file))\n            wrapper_alias = classname_to_alias(stripped_model.__class__.__name__, AliasMode.JSON)\n            split_plan.add_action(WriteFileAction(root_file, Element(stripped_model, wrapper_alias), content_type))\n\n    # return the end of the current path chain\n    return path_chain_end\n</code></pre>"},{"location":"reference/API/trestle/core/commands/split/#trestle.core.commands.split-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/task/","title":"trestle.core.commands.task","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/task/#trestle.core.commands.task","title":"<code>trestle.core.commands.task</code>","text":"<p>Trestle task command.</p>"},{"location":"reference/API/trestle/core/commands/task/#trestle.core.commands.task-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/task/#trestle.core.commands.task.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/task/#trestle.core.commands.task-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/task/#trestle.core.commands.task.TaskCmd","title":"<code>TaskCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Run arbitrary trestle tasks in a simple and extensible methodology.</p> Source code in <code>trestle/core/commands/task.py</code> <pre><code>class TaskCmd(CommandPlusDocs):\n    \"\"\"Run arbitrary trestle tasks in a simple and extensible methodology.\"\"\"\n\n    name = 'task'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument(\n            'task',\n            nargs='?',\n            type=str,\n            help='The name of the task to be run, trestle task -l will list available tasks.'\n        )\n        self.add_argument('-l', '--list', action='store_true', help='List the available tasks')\n        self.add_argument(\n            '-c', '--config', type=pathlib.Path, help='Pass a customized configuration file specifically for a task'\n        )\n        self.add_argument('-i', '--info', action='store_true', help='Print information about a particular task.')\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            logger.debug('Entering trestle task.')\n            log.set_log_level_from_args(args)\n            # Initial logic for conflicting args\n            if args.task and args.list:\n                raise TrestleIncorrectArgsError('Task name or -l can be provided not both.')\n\n            if not args.task and not args.list:\n                raise TrestleIncorrectArgsError(\n                    'Either a trestle task or \"-l/--list\" shoudl be passed as input arguments.'\n                )\n\n            # Ensure trestle directory (must be true)\n            trestle_root = args.trestle_root  # trestle root is set via command line in args. Default is cwd.\n            if not trestle_root or not file_utils.is_valid_project_root(args.trestle_root):\n                raise TrestleError(f'Given directory: {trestle_root} is not a trestle project.')\n\n            config_path = trestle_root / const.TRESTLE_CONFIG_DIR / const.TRESTLE_CONFIG_FILE\n\n            if args.config:\n                config_path = pathlib.Path(args.config)\n            if not config_path.exists():\n                raise TrestleError(f'Config file at {config_path} does not exist.')\n\n            # permit ${name} in config definitions\n            global_config = configparser.ConfigParser(interpolation=configparser.ExtendedInterpolation())\n            global_config.read_file(config_path.open('r', encoding=const.FILE_ENCODING))\n            # run setup\n            task_index = self._build_task_index()\n\n            # Clean to run\n            if args.list:\n                self._list_tasks(task_index)\n                return CmdReturnCodes.SUCCESS.value\n            # run the task\n            if args.task not in task_index.keys():\n                raise TrestleIncorrectArgsError(f'Unknown trestle task: {args.task}')\n\n            logger.debug(f'Loading task: {args.task}')\n            section_label = 'task.' + args.task\n            config_section: Optional[configparser.SectionProxy] = None\n            if section_label in global_config.sections():\n                config_section = global_config[section_label]\n            else:\n                logger.warning(\n                    f'Config file was not configured with the appropriate section for the task: \"[{section_label}]\"'\n                )\n\n            task = task_index[args.task](config_section)\n            if args.info:\n                task.print_info()\n                return CmdReturnCodes.SUCCESS.value\n\n            simulate_result = task.simulate()\n            if not (simulate_result == TaskOutcome.SIM_SUCCESS):\n                raise TrestleError(f'Task {args.task} reported a {simulate_result}')\n\n            actual_result = task.execute()\n            if not (actual_result == TaskOutcome.SUCCESS):\n                raise TrestleError(f'Task {args.task} reported a {actual_result}')\n\n            logger.info(f'Task: {args.task} executed successfully.')\n            return CmdReturnCodes.SUCCESS.value\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while executing Trestle task')\n\n    def _build_task_index(self) -&gt; Dict[str, Type[TaskBase]]:\n        \"\"\"Build an index of all classes in which are tasks and present as a dictionary.\"\"\"\n        task_index: Dict[str, Type[TaskBase]] = {}\n        pkgpath = str(pathlib.Path(trestle.tasks.__file__).parent)\n        for _, name, _ in pkgutil.iter_modules([pkgpath]):\n            __import__(f'trestle.tasks.{name}')\n            clsmembers = inspect.getmembers(sys.modules[f'trestle.tasks.{name}'], inspect.isclass)\n            for candidate in clsmembers:\n                if issubclass(candidate[1], TaskBase):\n                    task_index[candidate[1].name] = candidate[1]\n        return task_index\n\n    def _list_tasks(self, task_index: Dict[str, Type[TaskBase]]) -&gt; None:\n        logger.info('Available tasks:')\n        for key in task_index.keys():\n            logger.info(f'    {key}')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/task/#trestle.core.commands.task.TaskCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/task/#trestle.core.commands.task.TaskCmd.name","title":"<code>name = 'task'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/task/#trestle.core.commands.task-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/validate/","title":"trestle.core.commands.validate","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/validate/#trestle.core.commands.validate","title":"<code>trestle.core.commands.validate</code>","text":"<p>Trestle Validate Command.</p>"},{"location":"reference/API/trestle/core/commands/validate/#trestle.core.commands.validate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/validate/#trestle.core.commands.validate.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/validate/#trestle.core.commands.validate-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/validate/#trestle.core.commands.validate.ValidateCmd","title":"<code>ValidateCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Validate contents of a trestle model in different modes.</p> Source code in <code>trestle/core/commands/validate.py</code> <pre><code>class ValidateCmd(CommandPlusDocs):\n    \"\"\"Validate contents of a trestle model in different modes.\"\"\"\n\n    name = ARG_VALIDATE\n\n    def _init_arguments(self) -&gt; None:\n        vfact.init_arguments(self)\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n\n            mode_args = argparse.Namespace(mode=VAL_MODE_ALL)\n            validator = vfact.validator_factory.get(mode_args)\n\n            return validator.validate(args)\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while validating contents of a trestle model')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/validate/#trestle.core.commands.validate.ValidateCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/validate/#trestle.core.commands.validate.ValidateCmd.name","title":"<code>name = ARG_VALIDATE</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/validate/#trestle.core.commands.validate-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/version/","title":"trestle.core.commands.version","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/version/#trestle.core.commands.version","title":"<code>trestle.core.commands.version</code>","text":"<p>Trestle Validate Command.</p>"},{"location":"reference/API/trestle/core/commands/version/#trestle.core.commands.version-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/version/#trestle.core.commands.version.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/version/#trestle.core.commands.version-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/version/#trestle.core.commands.version.VersionCmd","title":"<code>VersionCmd</code>","text":"<p>               Bases: <code>CommandBase</code></p> <p>Output version info for trestle and OSCAL.</p> Source code in <code>trestle/core/commands/version.py</code> <pre><code>class VersionCmd(CommandBase):\n    \"\"\"Output version info for trestle and OSCAL.\"\"\"\n\n    name = 'version'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument('-n', '--name', help='Name of the OSCAL model', default=None, type=str)\n        self.add_argument(\n            '-t',\n            '--type',\n            help='Type of the model being queried: (catalog, profile, component-definition, ...)',\n            default=None,\n            type=str\n        )\n\n    def _get_version(self, type_name: str, obj_name: str, trestle_root: pathlib.Path) -&gt; str:\n        \"\"\"Fetch the version of the OSCAL object from its metadata.\"\"\"\n        oscal_object, obj_path = ModelUtils.load_model_for_type(trestle_root, type_name, obj_name)  # type: ignore\n\n        if not (oscal_object.metadata or oscal_object.metadata.version):  # type: ignore\n            raise TrestleError(f'Unable to determine the version. Metadata version is missing in model: {obj_path}.')\n\n        return oscal_object.metadata.version\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            status = CmdReturnCodes.COMMAND_ERROR.value\n\n            if not args.name and not args.type:\n                version_string = f'Trestle version v{__version__} based on OSCAL version {OSCAL_VERSION}'\n                self.out(version_string)\n                status = CmdReturnCodes.SUCCESS.value\n\n            if not (args.name and args.type) and (args.name or args.type):\n                raise TrestleError('Either both arguments --name and --type should be provided or none.')\n\n            if args.name and args.type:\n                trestle_root = pathlib.Path(args.trestle_root)\n                version = self._get_version(args.type, args.name, trestle_root)\n                version_string = f'Version of OSCAL object of {args.name} {args.type} is: {version}.'\n                self.out(version_string)\n                status = CmdReturnCodes.SUCCESS.value\n\n            return status\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error occurred when running trestle version')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/version/#trestle.core.commands.version.VersionCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/version/#trestle.core.commands.version.VersionCmd.name","title":"<code>name = 'version'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/version/#trestle.core.commands.version-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/","title":"trestle.core.commands.author.catalog","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog","title":"<code>trestle.core.commands.author.catalog</code>","text":"<p>Author commands to generate catalog controls as markdown and assemble them back to json.</p>"},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogAssemble","title":"<code>CatalogAssemble</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Assemble markdown files of controls into a Catalog json file.</p> Source code in <code>trestle/core/commands/author/catalog.py</code> <pre><code>class CatalogAssemble(AuthorCommonCommand):\n    \"\"\"Assemble markdown files of controls into a Catalog json file.\"\"\"\n\n    name = 'catalog-assemble'\n\n    def _init_arguments(self) -&gt; None:\n        name_help_str = (\n            'Optional name of the catalog model in the trestle workspace that is being modified.  '\n            'If not provided the output name is used.'\n        )\n        self.add_argument('-n', '--name', help=name_help_str, required=False, type=str)\n        file_help_str = 'Name of the input markdown file directory'\n        self.add_argument('-m', '--markdown', help=file_help_str, required=True, type=str)\n        output_help_str = 'Name of the output generated json Catalog'\n        self.add_argument('-o', '--output', help=output_help_str, required=True, type=str)\n        self.add_argument('-sp', '--set-parameters', action='store_true', help=const.HELP_SET_PARAMS)\n        self.add_argument('-r', '--regenerate', action='store_true', help=const.HELP_REGENERATE)\n        self.add_argument('-vn', '--version', help=const.HELP_VERSION, required=False, type=str)\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root = pathlib.Path(args.trestle_root)\n            return CatalogAssemble.assemble_catalog(\n                trestle_root=trestle_root,\n                md_name=args.markdown,\n                assem_cat_name=args.output,\n                parent_cat_name=args.name,\n                set_parameters_flag=args.set_parameters,\n                regenerate=args.regenerate,\n                version=args.version\n            )\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error occurred while assembling catalog')\n\n    @staticmethod\n    def assemble_catalog(\n        trestle_root: pathlib.Path,\n        md_name: str,\n        assem_cat_name: str,\n        parent_cat_name: Optional[str],\n        set_parameters_flag: bool,\n        regenerate: bool,\n        version: Optional[str]\n    ) -&gt; int:\n        \"\"\"\n        Assemble the markdown directory into a json catalog model file.\n\n        Args:\n            trestle_root: The trestle root directory\n            md_name: The name of the directory containing the markdown control files for the ssp\n            assem_cat_name: The output name of the catalog model to be created from the assembly\n            parent_cat_name: Optional name of the parent catalog that the markdown controls will replace\n            set_parameters_flag: set the parameters and props in the control to the values in the markdown yaml header\n            regenerate: whether to regenerate the uuid's in the catalog\n            version: version for the assembled catalog\n\n        Returns:\n            0 on success, 1 otherwise\n\n        Notes:\n            If the destination catalog_name model already exists in the trestle workspace, it is overwritten.\n            If a parent catalog is not specified, the assembled catalog will be used as the parent if it exists.\n            If no parent catalog name is available, the catalog is created anew using only the markdown content.\n        \"\"\"\n        md_dir = trestle_root / md_name\n        if not md_dir.exists():\n            raise TrestleError(f'Markdown directory {md_name} does not exist.')\n\n        # assemble the markdown controls into fresh md_catalog\n        catalog_api_from_md = CatalogAPI(catalog=None)\n        try:\n            md_catalog = catalog_api_from_md.read_catalog_from_markdown(md_dir, set_parameters_flag)\n        except Exception as e:\n            raise TrestleError(f'Error reading catalog from markdown {md_dir}: {e}')\n\n        # this is None if it doesn't exist yet\n        assem_cat_path = ModelUtils.get_model_path_for_name_and_class(trestle_root, assem_cat_name, Catalog)\n        logger.debug(f'assem_cat_path is {assem_cat_path}')\n\n        # if original cat is not specified, use the assembled cat but only if it already exists\n        if not parent_cat_name and assem_cat_path:\n            parent_cat_name = assem_cat_name\n\n        # default to JSON but allow override later if other file type found\n        new_content_type = FileContentType.JSON\n\n        # if we have parent catalog then merge the markdown controls into it\n        # the parent can be a separate catalog or the destination assembled catalog if it exists\n        # but this is the catalog that the markdown is merged into in memory\n        logger.debug(f'parent_cat_name is {parent_cat_name}')\n        if parent_cat_name:\n            parent_cat, parent_cat_path = load_validate_model_name(trestle_root, parent_cat_name, Catalog)\n            parent_cat_api = CatalogAPI(catalog=parent_cat)\n            # merge the just-read md catalog into the original json\n            parent_cat_api.merge_catalog(md_catalog, set_parameters_flag)\n            md_catalog = parent_cat_api._catalog_interface.get_catalog()\n            new_content_type = FileContentType.path_to_content_type(parent_cat_path)\n\n        if version:\n            md_catalog.metadata.version = version\n\n        # now check the destination catalog to see if the in-memory catalog matches it\n        if assem_cat_path:\n            new_content_type = FileContentType.path_to_content_type(assem_cat_path)\n            existing_cat = load_validate_model_path(trestle_root, assem_cat_path)\n            if ModelUtils.models_are_equivalent(existing_cat, md_catalog):  # type: ignore\n                logger.info('Assembled catalog is not different from existing version, so no update.')\n                return CmdReturnCodes.SUCCESS.value\n            else:\n                logger.debug('new assembled catalog is different from existing one')\n\n        if regenerate:\n            md_catalog, _, _ = ModelUtils.regenerate_uuids(md_catalog)\n            logger.debug('regenerating uuids in catalog')\n        ModelUtils.update_last_modified(md_catalog)\n\n        md_catalog.metadata.oscal_version = OSCAL_VERSION\n\n        # we still may not know the assem_cat_path but can now create it with file content type\n        assem_cat_path = ModelUtils.get_model_path_for_name_and_class(\n            trestle_root, assem_cat_name, Catalog, new_content_type\n        )\n\n        if assem_cat_path.parent.exists():\n            logger.info('Creating catalog from markdown and destination catalog exists, so updating.')\n            shutil.rmtree(str(assem_cat_path.parent))\n\n        assem_cat_path.parent.mkdir(parents=True, exist_ok=True)\n        md_catalog.oscal_write(assem_cat_path.parent / 'catalog.json')\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogAssemble-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogAssemble.name","title":"<code>name = 'catalog-assemble'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogAssemble-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogAssemble.assemble_catalog","title":"<code>assemble_catalog(trestle_root, md_name, assem_cat_name, parent_cat_name, set_parameters_flag, regenerate, version)</code>  <code>staticmethod</code>","text":"<p>Assemble the markdown directory into a json catalog model file.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>The trestle root directory</p> required <code>md_name</code> <code>str</code> <p>The name of the directory containing the markdown control files for the ssp</p> required <code>assem_cat_name</code> <code>str</code> <p>The output name of the catalog model to be created from the assembly</p> required <code>parent_cat_name</code> <code>Optional[str]</code> <p>Optional name of the parent catalog that the markdown controls will replace</p> required <code>set_parameters_flag</code> <code>bool</code> <p>set the parameters and props in the control to the values in the markdown yaml header</p> required <code>regenerate</code> <code>bool</code> <p>whether to regenerate the uuid's in the catalog</p> required <code>version</code> <code>Optional[str]</code> <p>version for the assembled catalog</p> required <p>Returns:</p> Type Description <code>int</code> <p>0 on success, 1 otherwise</p> Notes <p>If the destination catalog_name model already exists in the trestle workspace, it is overwritten. If a parent catalog is not specified, the assembled catalog will be used as the parent if it exists. If no parent catalog name is available, the catalog is created anew using only the markdown content.</p> Source code in <code>trestle/core/commands/author/catalog.py</code> <pre><code>@staticmethod\ndef assemble_catalog(\n    trestle_root: pathlib.Path,\n    md_name: str,\n    assem_cat_name: str,\n    parent_cat_name: Optional[str],\n    set_parameters_flag: bool,\n    regenerate: bool,\n    version: Optional[str]\n) -&gt; int:\n    \"\"\"\n    Assemble the markdown directory into a json catalog model file.\n\n    Args:\n        trestle_root: The trestle root directory\n        md_name: The name of the directory containing the markdown control files for the ssp\n        assem_cat_name: The output name of the catalog model to be created from the assembly\n        parent_cat_name: Optional name of the parent catalog that the markdown controls will replace\n        set_parameters_flag: set the parameters and props in the control to the values in the markdown yaml header\n        regenerate: whether to regenerate the uuid's in the catalog\n        version: version for the assembled catalog\n\n    Returns:\n        0 on success, 1 otherwise\n\n    Notes:\n        If the destination catalog_name model already exists in the trestle workspace, it is overwritten.\n        If a parent catalog is not specified, the assembled catalog will be used as the parent if it exists.\n        If no parent catalog name is available, the catalog is created anew using only the markdown content.\n    \"\"\"\n    md_dir = trestle_root / md_name\n    if not md_dir.exists():\n        raise TrestleError(f'Markdown directory {md_name} does not exist.')\n\n    # assemble the markdown controls into fresh md_catalog\n    catalog_api_from_md = CatalogAPI(catalog=None)\n    try:\n        md_catalog = catalog_api_from_md.read_catalog_from_markdown(md_dir, set_parameters_flag)\n    except Exception as e:\n        raise TrestleError(f'Error reading catalog from markdown {md_dir}: {e}')\n\n    # this is None if it doesn't exist yet\n    assem_cat_path = ModelUtils.get_model_path_for_name_and_class(trestle_root, assem_cat_name, Catalog)\n    logger.debug(f'assem_cat_path is {assem_cat_path}')\n\n    # if original cat is not specified, use the assembled cat but only if it already exists\n    if not parent_cat_name and assem_cat_path:\n        parent_cat_name = assem_cat_name\n\n    # default to JSON but allow override later if other file type found\n    new_content_type = FileContentType.JSON\n\n    # if we have parent catalog then merge the markdown controls into it\n    # the parent can be a separate catalog or the destination assembled catalog if it exists\n    # but this is the catalog that the markdown is merged into in memory\n    logger.debug(f'parent_cat_name is {parent_cat_name}')\n    if parent_cat_name:\n        parent_cat, parent_cat_path = load_validate_model_name(trestle_root, parent_cat_name, Catalog)\n        parent_cat_api = CatalogAPI(catalog=parent_cat)\n        # merge the just-read md catalog into the original json\n        parent_cat_api.merge_catalog(md_catalog, set_parameters_flag)\n        md_catalog = parent_cat_api._catalog_interface.get_catalog()\n        new_content_type = FileContentType.path_to_content_type(parent_cat_path)\n\n    if version:\n        md_catalog.metadata.version = version\n\n    # now check the destination catalog to see if the in-memory catalog matches it\n    if assem_cat_path:\n        new_content_type = FileContentType.path_to_content_type(assem_cat_path)\n        existing_cat = load_validate_model_path(trestle_root, assem_cat_path)\n        if ModelUtils.models_are_equivalent(existing_cat, md_catalog):  # type: ignore\n            logger.info('Assembled catalog is not different from existing version, so no update.')\n            return CmdReturnCodes.SUCCESS.value\n        else:\n            logger.debug('new assembled catalog is different from existing one')\n\n    if regenerate:\n        md_catalog, _, _ = ModelUtils.regenerate_uuids(md_catalog)\n        logger.debug('regenerating uuids in catalog')\n    ModelUtils.update_last_modified(md_catalog)\n\n    md_catalog.metadata.oscal_version = OSCAL_VERSION\n\n    # we still may not know the assem_cat_path but can now create it with file content type\n    assem_cat_path = ModelUtils.get_model_path_for_name_and_class(\n        trestle_root, assem_cat_name, Catalog, new_content_type\n    )\n\n    if assem_cat_path.parent.exists():\n        logger.info('Creating catalog from markdown and destination catalog exists, so updating.')\n        shutil.rmtree(str(assem_cat_path.parent))\n\n    assem_cat_path.parent.mkdir(parents=True, exist_ok=True)\n    md_catalog.oscal_write(assem_cat_path.parent / 'catalog.json')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogGenerate","title":"<code>CatalogGenerate</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Generate Catalog controls in markdown form from a catalog in the trestle workspace.</p> Source code in <code>trestle/core/commands/author/catalog.py</code> <pre><code>class CatalogGenerate(AuthorCommonCommand):\n    \"\"\"Generate Catalog controls in markdown form from a catalog in the trestle workspace.\"\"\"\n\n    name = 'catalog-generate'\n\n    def _init_arguments(self) -&gt; None:\n        name_help_str = 'Name of the catalog model in the trestle workspace'\n        self.add_argument('-n', '--name', help=name_help_str, required=True, type=str)\n        self.add_argument(\n            '-o', '--output', help='Name of the output generated catalog markdown folder', required=True, type=str\n        )  # noqa E501\n        self.add_argument('-fo', '--force-overwrite', help=const.HELP_FO_OUTPUT, required=False, action='store_true')\n        self.add_argument('-y', '--yaml-header', help=const.HELP_YAML_PATH, required=False, type=str)\n        self.add_argument(\n            '-ohv',\n            '--overwrite-header-values',\n            help=const.HELP_OVERWRITE_HEADER_VALUES,\n            required=False,\n            action='store_true',\n            default=False\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root = args.trestle_root\n            if not file_utils.is_directory_name_allowed(args.output):\n                raise TrestleError(f'{args.output} is not an allowed directory name')\n\n            if args.force_overwrite:\n                try:\n                    logger.info(f'Overwriting the content in {args.output} folder.')\n                    clear_folder(pathlib.Path(args.output))\n                except TrestleError as e:  # pragma: no cover\n                    raise TrestleError(f'Unable to overwrite contents in {args.output} folder: {e}')\n\n            yaml_header: Dict[str, Any] = {}\n            if args.yaml_header:\n                try:\n                    logging.debug(f'Loading yaml header file {args.yaml_header}')\n                    yaml = YAML(typ='safe')\n                    yaml_header = yaml.load(pathlib.Path(args.yaml_header).open('r'))\n                except YAMLError as e:\n                    raise TrestleError(f'YAML error loading yaml header {args.yaml_header} for ssp generation: {e}')\n\n            catalog_path = trestle_root / f'catalogs/{args.name}/catalog.json'\n\n            markdown_path = trestle_root / args.output\n\n            return self.generate_markdown(\n                trestle_root, catalog_path, markdown_path, yaml_header, args.overwrite_header_values\n            )\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error occurred when generating markdown for catalog')\n\n    def generate_markdown(\n        self,\n        trestle_root: pathlib.Path,\n        catalog_path: pathlib.Path,\n        markdown_path: pathlib.Path,\n        yaml_header: Dict[str, Any],\n        overwrite_header_values: bool\n    ) -&gt; int:\n        \"\"\"Generate markdown for the controls in the catalog.\"\"\"\n        try:\n            catalog = load_validate_model_path(trestle_root, catalog_path)\n            context = ControlContext.generate(\n                ContextPurpose.CATALOG,\n                True,\n                trestle_root,\n                markdown_path,\n                cli_yaml_header=yaml_header,\n                overwrite_header_values=overwrite_header_values,\n                set_parameters_flag=True\n            )\n            catalog_api = CatalogAPI(catalog=catalog, context=context)\n            catalog_api.write_catalog_as_markdown()\n\n        except TrestleNotFoundError as e:\n            raise TrestleError(f'Catalog {catalog_path} not found for load: {e}')\n        except Exception as e:\n            raise TrestleError(f'Error generating markdown for controls in {catalog_path}: {e}')\n\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogGenerate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogGenerate.name","title":"<code>name = 'catalog-generate'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogGenerate-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog.CatalogGenerate.generate_markdown","title":"<code>generate_markdown(trestle_root, catalog_path, markdown_path, yaml_header, overwrite_header_values)</code>","text":"<p>Generate markdown for the controls in the catalog.</p> Source code in <code>trestle/core/commands/author/catalog.py</code> <pre><code>def generate_markdown(\n    self,\n    trestle_root: pathlib.Path,\n    catalog_path: pathlib.Path,\n    markdown_path: pathlib.Path,\n    yaml_header: Dict[str, Any],\n    overwrite_header_values: bool\n) -&gt; int:\n    \"\"\"Generate markdown for the controls in the catalog.\"\"\"\n    try:\n        catalog = load_validate_model_path(trestle_root, catalog_path)\n        context = ControlContext.generate(\n            ContextPurpose.CATALOG,\n            True,\n            trestle_root,\n            markdown_path,\n            cli_yaml_header=yaml_header,\n            overwrite_header_values=overwrite_header_values,\n            set_parameters_flag=True\n        )\n        catalog_api = CatalogAPI(catalog=catalog, context=context)\n        catalog_api.write_catalog_as_markdown()\n\n    except TrestleNotFoundError as e:\n        raise TrestleError(f'Catalog {catalog_path} not found for load: {e}')\n    except Exception as e:\n        raise TrestleError(f'Error generating markdown for controls in {catalog_path}: {e}')\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/catalog/#trestle.core.commands.author.catalog-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/command/","title":"trestle.core.commands.author.command","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/command/#trestle.core.commands.author.command","title":"<code>trestle.core.commands.author.command</code>","text":"<p>Trestle author command.</p> <p>Umbrella command for all markdown related transformations</p>"},{"location":"reference/API/trestle/core/commands/author/command/#trestle.core.commands.author.command-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/command/#trestle.core.commands.author.command.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/command/#trestle.core.commands.author.command-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/command/#trestle.core.commands.author.command.AuthorCmd","title":"<code>AuthorCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>trestle author, a collection of commands for authoring compliance content outside of OSCAL.</p> Source code in <code>trestle/core/commands/author/command.py</code> <pre><code>class AuthorCmd(CommandPlusDocs):\n    \"\"\"trestle author, a collection of commands for authoring compliance content outside of OSCAL.\"\"\"\n\n    name = 'author'\n\n    subcommands = [\n        CatalogAssemble,\n        CatalogGenerate,\n        ComponentAssemble,\n        ComponentGenerate,\n        Docs,\n        Folders,\n        Headers,\n        JinjaCmd,\n        ProfileAssemble,\n        ProfileGenerate,\n        ProfileInherit,\n        ProfileResolve,\n        SSPAssemble,\n        SSPFilter,\n        SSPGenerate\n    ]\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/command/#trestle.core.commands.author.command.AuthorCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/command/#trestle.core.commands.author.command.AuthorCmd.name","title":"<code>name = 'author'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/command/#trestle.core.commands.author.command.AuthorCmd.subcommands","title":"<code>subcommands = [CatalogAssemble, CatalogGenerate, ComponentAssemble, ComponentGenerate, Docs, Folders, Headers, JinjaCmd, ProfileAssemble, ProfileGenerate, ProfileInherit, ProfileResolve, SSPAssemble, SSPFilter, SSPGenerate]</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/common/","title":"trestle.core.commands.author.common","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common","title":"<code>trestle.core.commands.author.common</code>","text":"<p>AuthorCommonCommands - reusable utilities to increase code base abstraction for author command.</p>"},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common.AuthorCommonCommand","title":"<code>AuthorCommonCommand</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Extension for the subset of commands that operate using the common mode structure.</p> Source code in <code>trestle/core/commands/author/common.py</code> <pre><code>class AuthorCommonCommand(CommandPlusDocs):\n    \"\"\"Extension for the subset of commands that operate using the common mode structure.\"\"\"\n\n    trestle_root: pathlib.Path\n\n    task_name: str\n\n    def _initialize(self, args: argparse.Namespace) -&gt; int:\n        log.set_log_level_from_args(args)\n        # Externalize\n        self.trestle_root = args.trestle_root\n        self.task_name = args.task_name\n\n        try:\n            self.global_ = args.__getattribute__('global')\n        except AttributeError:\n            self.global_ = None\n\n        if self.task_name:\n            self.task_path = self.trestle_root / self.task_name\n            if not file_utils.is_directory_name_allowed(self.task_name):\n                logger.error(\n                    f'Task name {self.task_name} is invalid as it interferes with OSCAL and trestle reserved names.'\n                )\n                return CmdReturnCodes.COMMAND_ERROR.value\n\n        rc = self._setup_template_dir(args)\n\n        return rc\n\n    def rel_dir(self, path: pathlib.Path) -&gt; str:\n        \"\"\"Stringify a directory relative to trestle root.\"\"\"\n        return str(path.relative_to(self.trestle_root))\n\n    def _setup_template_dir(self, args: argparse.Namespace) -&gt; int:\n        \"\"\"Set template directory and update to new format.\"\"\"\n        if not self.global_ and self.task_name is None:\n            logger.error('At least a global flag or a task name should be provided.')\n            return CmdReturnCodes.INCORRECT_ARGS.value\n        if self.global_:\n            old_template_dir = self.trestle_root / TRESTLE_CONFIG_DIR / 'author' / '__global__'\n            self._set_template_version_to_latest(args, old_template_dir)\n            self.template_dir = old_template_dir / args.template_version\n        elif self.task_name and not self.global_:\n            old_template_dir = self.trestle_root / TRESTLE_CONFIG_DIR / 'author' / self.task_name\n            self._set_template_version_to_latest(args, old_template_dir)\n            self.template_dir = old_template_dir / args.template_version\n\n        if old_template_dir.exists():\n            TemplateVersioning.update_template_folder_structure(old_template_dir)\n\n        return CmdReturnCodes.SUCCESS.value\n\n    def _set_template_version_to_latest(self, args: argparse.Namespace, template_dir: pathlib.Path) -&gt; None:\n        \"\"\"Set template version argument to the latest version if none was given.\"\"\"\n        if not TemplateVersioning.is_valid_version(args.template_version):\n            raise TrestleError(f'Version {args.template_version} is invalid, version format should be: 0.0.1')\n        if args.template_version is None and args.mode == ARG_VALIDATE:\n            # in validate mode no version will validate instances based on header version\n            args.template_version = ''\n        if args.template_version is None:\n            args.template_version = START_TEMPLATE_VERSION\n            if template_dir.exists():\n                all_versions = TemplateVersioning.get_all_versions_for_task(template_dir)\n                if all_versions:\n                    args.template_version = max(all_versions)\n        if args.template_version == '':\n            logger.info('Instances will be validated against template version specified in their headers.')\n        else:\n            logger.info(f'Set template version to {args.template_version}.')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common.AuthorCommonCommand-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common.AuthorCommonCommand.task_name","title":"<code>task_name: str</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common.AuthorCommonCommand.trestle_root","title":"<code>trestle_root: pathlib.Path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common.AuthorCommonCommand-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/common/#trestle.core.commands.author.common.AuthorCommonCommand.rel_dir","title":"<code>rel_dir(path)</code>","text":"<p>Stringify a directory relative to trestle root.</p> Source code in <code>trestle/core/commands/author/common.py</code> <pre><code>def rel_dir(self, path: pathlib.Path) -&gt; str:\n    \"\"\"Stringify a directory relative to trestle root.\"\"\"\n    return str(path.relative_to(self.trestle_root))\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/component/","title":"trestle.core.commands.author.component","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component","title":"<code>trestle.core.commands.author.component</code>","text":"<p>Author commands to generate component definition as markdown and assemble to json after edit.</p>"},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentAssemble","title":"<code>ComponentAssemble</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Assemble markdown files of controls into a Component json file.</p> Source code in <code>trestle/core/commands/author/component.py</code> <pre><code>class ComponentAssemble(AuthorCommonCommand):\n    \"\"\"Assemble markdown files of controls into a Component json file.\"\"\"\n\n    name = 'component-assemble'\n\n    def _init_arguments(self) -&gt; None:\n        name_help_str = (\n            'Optional name of the component-definition model in the trestle workspace that is being modified.  '\n            'If not provided the output name is used.'\n        )\n        self.add_argument('-n', '--name', help=name_help_str, required=False, type=str)\n        file_help_str = 'Name of the source markdown directory'\n        self.add_argument('-m', '--markdown', help=file_help_str, required=True, type=str)\n        output_help_str = 'Name of the output generated json component-definition (ok to overwrite original)'\n        self.add_argument('-o', '--output', help=output_help_str, required=True, type=str)\n        self.add_argument('-r', '--regenerate', action='store_true', help=const.HELP_REGENERATE)\n        self.add_argument('-vn', '--version', help=const.HELP_VERSION, required=False, type=str)\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            return self.assemble_component(\n                trestle_root=args.trestle_root,\n                parent_comp_name=args.name,\n                md_name=args.markdown,\n                assem_comp_name=args.output,\n                regenerate=args.regenerate,\n                version=args.version,\n            )\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Assembly of markdown to component-definition failed')\n\n    @staticmethod\n    def assemble_component(\n        trestle_root: pathlib.Path,\n        parent_comp_name: Optional[str],\n        md_name: str,\n        assem_comp_name: str,\n        regenerate: bool,\n        version: Optional[str],\n    ) -&gt; int:\n        \"\"\"\n        Assemble the markdown directory into a json component-definition model file.\n\n        Args:\n            trestle_root: The trestle root directory\n            parent_comp_name: Optional name of component-definition used to generate markdown, default = assem_comp_name\n            md_name: The name of the directory containing the markdown control files for the component\n            assem_comp_name: The name of the assembled component-definiton.  Can be same as the parent to overwrite\n            regenerate: Whether to regenerate the uuid's in the component\n            version: Optional version for the assembled component\n\n        Returns:\n            0 on success, 1 otherwise\n\n        Notes:\n            There must already be a component model and it will either be updated or a new json component created.\n            The generated markdown has the current values for parameters of controls being imported, as set by\n            the original catalog and any intermediate components.  It also shows the current SetParameters being applied\n            by this component.  That list of SetParameters can be edited by changing the assigned values and adding or\n            removing SetParameters from that list.  During assembly that list will be used to create the SetParameters\n            in the assembled component if the --set-parameters option is specified.\n        \"\"\"\n        md_dir = trestle_root / md_name\n        if not md_dir.exists():\n            raise TrestleError(f'Markdown directory {md_name} does not exist.')\n\n        if not parent_comp_name:\n            parent_comp_name = assem_comp_name\n\n        # load the comp-def that will be updated\n        parent_comp, parent_comp_path = ModelUtils.load_model_for_class(\n            trestle_root,\n            parent_comp_name,\n            comp.ComponentDefinition\n        )\n        new_content_type = FileContentType.path_to_content_type(parent_comp_path)\n\n        context = ControlContext.generate(ContextPurpose.COMPONENT, False, trestle_root, md_dir)\n\n        ComponentAssemble.assemble_comp_def_into_parent(parent_comp, md_dir, context)\n\n        if version:\n            parent_comp.metadata.version = version\n\n        assem_comp_path = ModelUtils.get_model_path_for_name_and_class(\n            trestle_root, assem_comp_name, comp.ComponentDefinition, new_content_type\n        )\n\n        if not version and assem_comp_path.exists():\n            _, _, existing_comp = ModelUtils.load_distributed(assem_comp_path, trestle_root)\n            # comp def will change statement uuids so need to ignore them in comparison\n            if ModelUtils.models_are_equivalent(existing_comp, parent_comp, True):  # type: ignore\n                logger.info('Assembled component definition is no different from existing version, so no update.')\n                return CmdReturnCodes.SUCCESS.value\n\n        if regenerate:\n            parent_comp, _, _ = ModelUtils.regenerate_uuids(parent_comp)\n        ModelUtils.update_last_modified(parent_comp)  # type: ignore\n\n        if assem_comp_path.parent.exists():\n            logger.info(\n                'Creating component definition from markdown and destination component definition exists, so updating.'\n            )  # noqa E501\n            shutil.rmtree(str(assem_comp_path.parent))\n\n        assem_comp_path.parent.mkdir(parents=True, exist_ok=True)\n        parent_comp.oscal_write(assem_comp_path)  # type: ignore\n        return CmdReturnCodes.SUCCESS.value\n\n    @staticmethod\n    def assemble_comp_def_into_parent(\n        parent_comp: comp.ComponentDefinition, md_dir: pathlib.Path, context: ControlContext\n    ) -&gt; None:\n        \"\"\"Assemble markdown content into provided component-definition model.\"\"\"\n        # find the needed list of comps\n        sub_dirs = file_utils.iterdir_without_hidden_files(md_dir)\n        comp_names = [sub_dir.name for sub_dir in sub_dirs if sub_dir.is_dir()]\n\n        # make sure parent has list of comps to work with - possibly empty\n        if not parent_comp.components:\n            parent_comp.components = []\n\n        parent_comp.components[:] = [comp for comp in parent_comp.components if comp.title in comp_names]\n\n        # create new comps if needed\n        existing_comp_names = [component.title for component in parent_comp.components]\n        for comp_name in comp_names:\n            if comp_name not in existing_comp_names:\n                parent_comp.components.append(\n                    comp.DefinedComponent(\n                        uuid=str(uuid4()), title=comp_name, type=const.REPLACE_ME, description=const.REPLACE_ME\n                    )\n                )\n\n        for component in parent_comp.components:\n            context.comp_name = component.title\n            context.comp_def = parent_comp\n            context.component = component\n            logger.info(f'Assembling markdown for component {component.title}')\n            ComponentAssemble._update_component_with_markdown(md_dir, component, context)\n\n    @staticmethod\n    def _get_profile_title_and_href_from_dir(md_dir: pathlib.Path) -&gt; Tuple[str, str]:\n        \"\"\"Get profile title and href from yaml header of first md file found in dir that has info.\"\"\"\n        md_files = md_dir.rglob('*.md')\n        markdown_api = MarkdownAPI()\n        for md_file in md_files:\n            header, _ = markdown_api.processor.read_markdown_wo_processing(md_file)\n            prof_title = deep_get(header, [const.TRESTLE_GLOBAL_TAG, const.PROFILE, const.TITLE])\n            profile_href = deep_get(header, [const.TRESTLE_GLOBAL_TAG, const.PROFILE, const.HREF], 'unknown_href')\n            # return first one found\n            if prof_title:\n                return prof_title, profile_href\n        logger.warning(f'Cannot find profile title and href in markdown headers of directory {md_dir}')\n        return 'unknown_title', 'unknown_href'\n\n    @staticmethod\n    def _update_component_with_markdown(\n        md_dir: pathlib.Path, component: comp.DefinedComponent, context: ControlContext\n    ) -&gt; None:\n        md_path = md_dir / component.title\n        sub_dirs = file_utils.iterdir_without_hidden_files(md_path)\n        source_dirs = [sub_dir.name for sub_dir in sub_dirs if sub_dir.is_dir()]\n        for source_dir in source_dirs:\n            profile_title, _ = ComponentAssemble._get_profile_title_and_href_from_dir(md_path / source_dir)\n            # context has defined component and comp_name\n            imp_reqs = CatalogReader.read_catalog_imp_reqs(md_path / source_dir, context)\n            # the imp_reqs need to be inserted into the correct control_implementation\n            for imp_req in imp_reqs:\n                ControlInterface.insert_imp_req_into_component(component, imp_req, profile_title, context.trestle_root)\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentAssemble-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentAssemble.name","title":"<code>name = 'component-assemble'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentAssemble-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentAssemble.assemble_comp_def_into_parent","title":"<code>assemble_comp_def_into_parent(parent_comp, md_dir, context)</code>  <code>staticmethod</code>","text":"<p>Assemble markdown content into provided component-definition model.</p> Source code in <code>trestle/core/commands/author/component.py</code> <pre><code>@staticmethod\ndef assemble_comp_def_into_parent(\n    parent_comp: comp.ComponentDefinition, md_dir: pathlib.Path, context: ControlContext\n) -&gt; None:\n    \"\"\"Assemble markdown content into provided component-definition model.\"\"\"\n    # find the needed list of comps\n    sub_dirs = file_utils.iterdir_without_hidden_files(md_dir)\n    comp_names = [sub_dir.name for sub_dir in sub_dirs if sub_dir.is_dir()]\n\n    # make sure parent has list of comps to work with - possibly empty\n    if not parent_comp.components:\n        parent_comp.components = []\n\n    parent_comp.components[:] = [comp for comp in parent_comp.components if comp.title in comp_names]\n\n    # create new comps if needed\n    existing_comp_names = [component.title for component in parent_comp.components]\n    for comp_name in comp_names:\n        if comp_name not in existing_comp_names:\n            parent_comp.components.append(\n                comp.DefinedComponent(\n                    uuid=str(uuid4()), title=comp_name, type=const.REPLACE_ME, description=const.REPLACE_ME\n                )\n            )\n\n    for component in parent_comp.components:\n        context.comp_name = component.title\n        context.comp_def = parent_comp\n        context.component = component\n        logger.info(f'Assembling markdown for component {component.title}')\n        ComponentAssemble._update_component_with_markdown(md_dir, component, context)\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentAssemble.assemble_component","title":"<code>assemble_component(trestle_root, parent_comp_name, md_name, assem_comp_name, regenerate, version)</code>  <code>staticmethod</code>","text":"<p>Assemble the markdown directory into a json component-definition model file.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>The trestle root directory</p> required <code>parent_comp_name</code> <code>Optional[str]</code> <p>Optional name of component-definition used to generate markdown, default = assem_comp_name</p> required <code>md_name</code> <code>str</code> <p>The name of the directory containing the markdown control files for the component</p> required <code>assem_comp_name</code> <code>str</code> <p>The name of the assembled component-definiton.  Can be same as the parent to overwrite</p> required <code>regenerate</code> <code>bool</code> <p>Whether to regenerate the uuid's in the component</p> required <code>version</code> <code>Optional[str]</code> <p>Optional version for the assembled component</p> required <p>Returns:</p> Type Description <code>int</code> <p>0 on success, 1 otherwise</p> Notes <p>There must already be a component model and it will either be updated or a new json component created. The generated markdown has the current values for parameters of controls being imported, as set by the original catalog and any intermediate components.  It also shows the current SetParameters being applied by this component.  That list of SetParameters can be edited by changing the assigned values and adding or removing SetParameters from that list.  During assembly that list will be used to create the SetParameters in the assembled component if the --set-parameters option is specified.</p> Source code in <code>trestle/core/commands/author/component.py</code> <pre><code>@staticmethod\ndef assemble_component(\n    trestle_root: pathlib.Path,\n    parent_comp_name: Optional[str],\n    md_name: str,\n    assem_comp_name: str,\n    regenerate: bool,\n    version: Optional[str],\n) -&gt; int:\n    \"\"\"\n    Assemble the markdown directory into a json component-definition model file.\n\n    Args:\n        trestle_root: The trestle root directory\n        parent_comp_name: Optional name of component-definition used to generate markdown, default = assem_comp_name\n        md_name: The name of the directory containing the markdown control files for the component\n        assem_comp_name: The name of the assembled component-definiton.  Can be same as the parent to overwrite\n        regenerate: Whether to regenerate the uuid's in the component\n        version: Optional version for the assembled component\n\n    Returns:\n        0 on success, 1 otherwise\n\n    Notes:\n        There must already be a component model and it will either be updated or a new json component created.\n        The generated markdown has the current values for parameters of controls being imported, as set by\n        the original catalog and any intermediate components.  It also shows the current SetParameters being applied\n        by this component.  That list of SetParameters can be edited by changing the assigned values and adding or\n        removing SetParameters from that list.  During assembly that list will be used to create the SetParameters\n        in the assembled component if the --set-parameters option is specified.\n    \"\"\"\n    md_dir = trestle_root / md_name\n    if not md_dir.exists():\n        raise TrestleError(f'Markdown directory {md_name} does not exist.')\n\n    if not parent_comp_name:\n        parent_comp_name = assem_comp_name\n\n    # load the comp-def that will be updated\n    parent_comp, parent_comp_path = ModelUtils.load_model_for_class(\n        trestle_root,\n        parent_comp_name,\n        comp.ComponentDefinition\n    )\n    new_content_type = FileContentType.path_to_content_type(parent_comp_path)\n\n    context = ControlContext.generate(ContextPurpose.COMPONENT, False, trestle_root, md_dir)\n\n    ComponentAssemble.assemble_comp_def_into_parent(parent_comp, md_dir, context)\n\n    if version:\n        parent_comp.metadata.version = version\n\n    assem_comp_path = ModelUtils.get_model_path_for_name_and_class(\n        trestle_root, assem_comp_name, comp.ComponentDefinition, new_content_type\n    )\n\n    if not version and assem_comp_path.exists():\n        _, _, existing_comp = ModelUtils.load_distributed(assem_comp_path, trestle_root)\n        # comp def will change statement uuids so need to ignore them in comparison\n        if ModelUtils.models_are_equivalent(existing_comp, parent_comp, True):  # type: ignore\n            logger.info('Assembled component definition is no different from existing version, so no update.')\n            return CmdReturnCodes.SUCCESS.value\n\n    if regenerate:\n        parent_comp, _, _ = ModelUtils.regenerate_uuids(parent_comp)\n    ModelUtils.update_last_modified(parent_comp)  # type: ignore\n\n    if assem_comp_path.parent.exists():\n        logger.info(\n            'Creating component definition from markdown and destination component definition exists, so updating.'\n        )  # noqa E501\n        shutil.rmtree(str(assem_comp_path.parent))\n\n    assem_comp_path.parent.mkdir(parents=True, exist_ok=True)\n    parent_comp.oscal_write(assem_comp_path)  # type: ignore\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentGenerate","title":"<code>ComponentGenerate</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Generate component in markdown form from a component in the trestle workspace.</p> Source code in <code>trestle/core/commands/author/component.py</code> <pre><code>class ComponentGenerate(AuthorCommonCommand):\n    \"\"\"Generate component in markdown form from a component in the trestle workspace.\"\"\"\n\n    name = 'component-generate'\n\n    def _init_arguments(self) -&gt; None:\n        name_help_str = 'Name of the source component model in the trestle workspace'\n        self.add_argument('-n', '--name', help=name_help_str, required=True, type=str)\n        self.add_argument(\n            '-o', '--output', help='Name of the output generated component markdown folder', required=True, type=str\n        )  # noqa E501\n        self.add_argument('-fo', '--force-overwrite', help=const.HELP_FO_OUTPUT, required=False, action='store_true')\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n\n            if args.force_overwrite:\n                try:\n                    logger.info(f'Overwriting the content in {args.output} folder.')\n                    clear_folder(pathlib.Path(args.output))\n                except TrestleError as e:  # pragma: no cover\n                    raise TrestleError(f'Unable to overwrite contents in {args.output} folder: {e}')\n\n            return self.component_generate_all(args.trestle_root, args.name, args.output)\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Generation of the component markdown failed')\n\n    def component_generate_all(self, trestle_root: pathlib.Path, comp_def_name: str, markdown_dir_name: str) -&gt; int:\n        \"\"\"Generate markdown for all components in comp def.\"\"\"\n        if not file_utils.is_directory_name_allowed(markdown_dir_name):\n            raise TrestleError(f'{markdown_dir_name} is not an allowed directory name')\n        md_path = trestle_root / markdown_dir_name\n        md_path.mkdir(parents=True, exist_ok=True)\n        component_def, _ = load_validate_model_name(trestle_root, comp_def_name, comp.ComponentDefinition)\n\n        context = ControlContext.generate(ContextPurpose.COMPONENT, True, trestle_root, md_path)\n        context.prompt_responses = True\n        context.comp_def = component_def\n\n        rc = CmdReturnCodes.SUCCESS.value\n        for component in as_list(component_def.components):\n            rc = self.component_generate_by_name(context, component, md_path / component.title)\n            if rc != CmdReturnCodes.SUCCESS.value:\n                break\n        return rc\n\n    @staticmethod\n    def _get_name_from_uri(source_uri: str) -&gt; str:\n        \"\"\"Get the name from a source profile or catalog source uri.\"\"\"\n        uri_type = FetcherFactory.get_uri_type(source_uri)\n        if uri_type == FetcherFactory.UriType.TRESTLE:\n            return source_uri.split('/')[-2]\n        return ''\n\n    def component_generate_by_name(\n        self, context: ControlContext, component: comp.DefinedComponent, markdown_dir_path: pathlib.Path\n    ) -&gt; int:\n        \"\"\"Create markdown for the component using its source profiles.\"\"\"\n        logger.info(f'Generating markdown for component {component.title}')\n        context.comp_name = component.title\n        context.component = component\n        context.uri_name_map = {}\n        cat_api_dict: Dict[str, CatalogAPI] = {}\n        name_index = 1\n        for control_imp in as_list(component.control_implementations):\n            context.control_implementation = control_imp\n            source_profile_uri = control_imp.source\n            # get the resolved profile catalog for this source, generating it if not already created\n            if source_profile_uri not in cat_api_dict:\n                name = ComponentGenerate._get_name_from_uri(source_profile_uri)\n                if not name:\n                    name = f'source_{name_index:03d}'\n                    name_index += 1\n                context.uri_name_map[source_profile_uri] = name\n                resolved_catalog = ProfileResolver.get_resolved_profile_catalog(\n                    context.trestle_root, source_profile_uri, param_rep=ParameterRep.LEAVE_MOUSTACHE\n                )\n                local_catalog_api = CatalogAPI(resolved_catalog)\n                cat_api_dict[source_profile_uri] = local_catalog_api\n            else:\n                local_catalog_api = cat_api_dict[source_profile_uri]\n            # insert the profile title (from title of resolved catalog) into the yaml header so it appears in md\n            # different controls in the final catalog may have different profile titles if from different control_imps\n            context.cli_yaml_header = {}\n            context.cli_yaml_header[const.TRESTLE_GLOBAL_TAG] = {}\n\n            profile_title = local_catalog_api._catalog_interface.get_catalog_title()\n            profile_header = {'title': profile_title, 'href': source_profile_uri}\n            context.cli_yaml_header[const.TRESTLE_GLOBAL_TAG][const.PROFILE] = profile_header\n\n            sub_dir_name = context.uri_name_map[source_profile_uri]\n            context.md_root = markdown_dir_path / sub_dir_name\n            # write controls corresponding to this source catalog\n            # if two controlimps load the same control, the second one will merge into the first\n            # otherwise the full catalog will be written in subsets by control_imp\n            # if an imp_req has a set param also in the control_imp. the imp_req value is used for the control\n            cat_api_dict[source_profile_uri].update_context(context)\n            cat_api_dict[source_profile_uri].write_catalog_as_markdown()\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentGenerate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentGenerate.name","title":"<code>name = 'component-generate'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentGenerate-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentGenerate.component_generate_all","title":"<code>component_generate_all(trestle_root, comp_def_name, markdown_dir_name)</code>","text":"<p>Generate markdown for all components in comp def.</p> Source code in <code>trestle/core/commands/author/component.py</code> <pre><code>def component_generate_all(self, trestle_root: pathlib.Path, comp_def_name: str, markdown_dir_name: str) -&gt; int:\n    \"\"\"Generate markdown for all components in comp def.\"\"\"\n    if not file_utils.is_directory_name_allowed(markdown_dir_name):\n        raise TrestleError(f'{markdown_dir_name} is not an allowed directory name')\n    md_path = trestle_root / markdown_dir_name\n    md_path.mkdir(parents=True, exist_ok=True)\n    component_def, _ = load_validate_model_name(trestle_root, comp_def_name, comp.ComponentDefinition)\n\n    context = ControlContext.generate(ContextPurpose.COMPONENT, True, trestle_root, md_path)\n    context.prompt_responses = True\n    context.comp_def = component_def\n\n    rc = CmdReturnCodes.SUCCESS.value\n    for component in as_list(component_def.components):\n        rc = self.component_generate_by_name(context, component, md_path / component.title)\n        if rc != CmdReturnCodes.SUCCESS.value:\n            break\n    return rc\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component.ComponentGenerate.component_generate_by_name","title":"<code>component_generate_by_name(context, component, markdown_dir_path)</code>","text":"<p>Create markdown for the component using its source profiles.</p> Source code in <code>trestle/core/commands/author/component.py</code> <pre><code>def component_generate_by_name(\n    self, context: ControlContext, component: comp.DefinedComponent, markdown_dir_path: pathlib.Path\n) -&gt; int:\n    \"\"\"Create markdown for the component using its source profiles.\"\"\"\n    logger.info(f'Generating markdown for component {component.title}')\n    context.comp_name = component.title\n    context.component = component\n    context.uri_name_map = {}\n    cat_api_dict: Dict[str, CatalogAPI] = {}\n    name_index = 1\n    for control_imp in as_list(component.control_implementations):\n        context.control_implementation = control_imp\n        source_profile_uri = control_imp.source\n        # get the resolved profile catalog for this source, generating it if not already created\n        if source_profile_uri not in cat_api_dict:\n            name = ComponentGenerate._get_name_from_uri(source_profile_uri)\n            if not name:\n                name = f'source_{name_index:03d}'\n                name_index += 1\n            context.uri_name_map[source_profile_uri] = name\n            resolved_catalog = ProfileResolver.get_resolved_profile_catalog(\n                context.trestle_root, source_profile_uri, param_rep=ParameterRep.LEAVE_MOUSTACHE\n            )\n            local_catalog_api = CatalogAPI(resolved_catalog)\n            cat_api_dict[source_profile_uri] = local_catalog_api\n        else:\n            local_catalog_api = cat_api_dict[source_profile_uri]\n        # insert the profile title (from title of resolved catalog) into the yaml header so it appears in md\n        # different controls in the final catalog may have different profile titles if from different control_imps\n        context.cli_yaml_header = {}\n        context.cli_yaml_header[const.TRESTLE_GLOBAL_TAG] = {}\n\n        profile_title = local_catalog_api._catalog_interface.get_catalog_title()\n        profile_header = {'title': profile_title, 'href': source_profile_uri}\n        context.cli_yaml_header[const.TRESTLE_GLOBAL_TAG][const.PROFILE] = profile_header\n\n        sub_dir_name = context.uri_name_map[source_profile_uri]\n        context.md_root = markdown_dir_path / sub_dir_name\n        # write controls corresponding to this source catalog\n        # if two controlimps load the same control, the second one will merge into the first\n        # otherwise the full catalog will be written in subsets by control_imp\n        # if an imp_req has a set param also in the control_imp. the imp_req value is used for the control\n        cat_api_dict[source_profile_uri].update_context(context)\n        cat_api_dict[source_profile_uri].write_catalog_as_markdown()\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/component/#trestle.core.commands.author.component-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/consts/","title":"trestle.core.commands.author.consts","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts","title":"<code>trestle.core.commands.author.consts</code>","text":"<p>Constants associated with trestle author commands to decrease duplication.</p>"},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.EXCLUDE_HELP","title":"<code>EXCLUDE_HELP = '[DEPRECATED: use --ignore instead] The name of a folder, relative to the root of the trestle project,' + 'e.g. architecture or architecture/infrastructure.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.EXCLUDE_LONG","title":"<code>EXCLUDE_LONG = '--exclude'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.EXCLUDE_SHORT","title":"<code>EXCLUDE_SHORT = '-ex'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.GH_HELP","title":"<code>GH_HELP = \"Governed heading: Heading where for each line is a superset of the template's content\"</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.GH_LONG","title":"<code>GH_LONG = '--governed-heading'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.GH_SHORT","title":"<code>GH_SHORT = '-gh'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.GLOBAL_HELP","title":"<code>GLOBAL_HELP = 'Use a consistent template defined in .trestle/author/__global__,' + 'if used without a task name applies to all files within the repository.' + '\\n\\n'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.GLOBAL_LONG","title":"<code>GLOBAL_LONG = '--global'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.GLOBAL_SHORT","title":"<code>GLOBAL_SHORT = '-g'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.HEADER_VALIDATE_HELP","title":"<code>HEADER_VALIDATE_HELP = 'Validate the structure of a markdown yaml header and/or drawio metadata on the first tab.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.HOV_HELP","title":"<code>HOV_HELP = 'Only validate the header / metadata for files. Includes project structure where appropriate.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.HOV_LONG","title":"<code>HOV_LONG = '--header-only-validate'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.HOV_SHORT","title":"<code>HOV_SHORT = '-hov'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.IGNORE_HELP","title":"<code>IGNORE_HELP = 'Provide a regex to ignore files and folders with matching name from validation (i.e. ^_.*).'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.LONG_HEADER_VALIDATE","title":"<code>LONG_HEADER_VALIDATE = '--header-validate'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.LONG_IGNORE","title":"<code>LONG_IGNORE = '--ignore'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.LONG_README_VALIDATE","title":"<code>LONG_README_VALIDATE = '--readme-validate'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.LONG_TEMPLATE_VERSION","title":"<code>LONG_TEMPLATE_VERSION = '--template-version'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.MODE_ARG_NAME","title":"<code>MODE_ARG_NAME = 'mode'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.MODE_CHOICES","title":"<code>MODE_CHOICES = ['validate', 'template-validate', 'setup', 'create-sample']</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.README_VALIDATE_FOLDERS_HELP","title":"<code>README_VALIDATE_FOLDERS_HELP = 'Enable to validate README.md files. Required if readme files are included in the' + 'template.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.README_VALIDATE_HELP","title":"<code>README_VALIDATE_HELP = 'Enable to validate README.md files otherwise README files are excluded.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.RECURSE_HELP","title":"<code>RECURSE_HELP = 'Recurse and validate any subdirectories.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.RECURSE_LONG","title":"<code>RECURSE_LONG = '--recurse'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.RECURSE_SHORT","title":"<code>RECURSE_SHORT = '-r'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.REFERENCE_TEMPLATES","title":"<code>REFERENCE_TEMPLATES = {'md': 'template.md', 'drawio': 'template.drawio'}</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.SHORT_HEADER_VALIDATE","title":"<code>SHORT_HEADER_VALIDATE = '-hv'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.SHORT_IGNORE","title":"<code>SHORT_IGNORE = '-ig'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.SHORT_README_VALIDATE","title":"<code>SHORT_README_VALIDATE = '-rv'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.SHORT_TEMPLATE_VERSION","title":"<code>SHORT_TEMPLATE_VERSION = '-tv'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.START_TEMPLATE_VERSION","title":"<code>START_TEMPLATE_VERSION = '0.0.1'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.TASK_NAME_LONG","title":"<code>TASK_NAME_LONG = '--task-name'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.TASK_NAME_SHORT","title":"<code>TASK_NAME_SHORT = '-tn'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.TEMPLATE_TYPE_HEADER","title":"<code>TEMPLATE_TYPE_HEADER = 'x-trestle-template-type'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_HELP","title":"<code>TEMPLATE_TYPE_VALIDATE_HELP = 'Validate that template and instance files match with x-trestle-template-type field'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_LONG","title":"<code>TEMPLATE_TYPE_VALIDATE_LONG = '--validate-template-type'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.TEMPLATE_TYPE_VALIDATE_SHORT","title":"<code>TEMPLATE_TYPE_VALIDATE_SHORT = '-vtt'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.TEMPLATE_VERSION_HEADER","title":"<code>TEMPLATE_VERSION_HEADER = 'x-trestle-template-version'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.TEMPLATE_VERSION_HELP","title":"<code>TEMPLATE_VERSION_HELP = 'Specify a template version to use for the task, latest version will be used by default.'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/consts/#trestle.core.commands.author.consts.TRESTLE_RESOURCES","title":"<code>TRESTLE_RESOURCES = 'trestle.resources'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/docs/","title":"trestle.core.commands.author.docs","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs","title":"<code>trestle.core.commands.author.docs</code>","text":"<p>Trestle author docs sub-command.</p>"},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.Docs","title":"<code>Docs</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Markdown governed documents - enforcing consistent markdown across a set of files.</p> Source code in <code>trestle/core/commands/author/docs.py</code> <pre><code>class Docs(AuthorCommonCommand):\n    \"\"\"Markdown governed documents - enforcing consistent markdown across a set of files.\"\"\"\n\n    name = 'docs'\n\n    template_name = 'template.md'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument(\n            author_const.GH_SHORT, author_const.GH_LONG, help=author_const.GH_HELP, default=None, type=str\n        )\n        self.add_argument(\n            author_const.SHORT_HEADER_VALIDATE,\n            author_const.LONG_HEADER_VALIDATE,\n            help=author_const.HEADER_VALIDATE_HELP,\n            action='store_true'\n        )\n        self.add_argument(\n            author_const.SHORT_TEMPLATE_VERSION,\n            author_const.LONG_TEMPLATE_VERSION,\n            help=author_const.TEMPLATE_VERSION_HELP,\n            action='store'\n        )\n        self.add_argument(\n            author_const.HOV_SHORT, author_const.HOV_LONG, help=author_const.HOV_HELP, action='store_true'\n        )\n        self.add_argument(\n            author_const.SHORT_IGNORE, author_const.LONG_IGNORE, help=author_const.IGNORE_HELP, default=None, type=str\n        )\n        self.add_argument(\n            author_const.RECURSE_SHORT, author_const.RECURSE_LONG, help=author_const.RECURSE_HELP, action='store_true'\n        )\n        self.add_argument(author_const.MODE_ARG_NAME, choices=author_const.MODE_CHOICES)\n        tn_help_str = '\\n'.join(\n            [\n                'The name of the the task to be governed.',\n                ''\n                'The template file is at .trestle/author/[task-name]/template.md',\n                'Note that by default this will automatically enforce the task.'\n            ]\n        )\n\n        self.add_argument(\n            author_const.TASK_NAME_SHORT, author_const.TASK_NAME_LONG, help=tn_help_str, required=True, type=str\n        )\n        self.add_argument(\n            author_const.SHORT_README_VALIDATE,\n            author_const.LONG_README_VALIDATE,\n            help=author_const.README_VALIDATE_HELP,\n            action='store_true'\n        )\n\n        self.add_argument(\n            author_const.TEMPLATE_TYPE_VALIDATE_SHORT,\n            author_const.TEMPLATE_TYPE_VALIDATE_LONG,\n            help=author_const.TEMPLATE_TYPE_VALIDATE_HELP,\n            action='store_true'\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            status = 1\n            if self._initialize(args):\n                return status\n\n            if args.mode == 'create-sample':\n                status = self.create_sample()\n\n            elif args.mode == 'template-validate':\n                status = self.template_validate(\n                    args.governed_heading,\n                    args.header_validate,\n                    args.header_only_validate,\n                )\n            elif args.mode == 'setup':\n                status = self.setup_template_governed_docs(args.template_version)\n            elif args.mode == 'validate':\n                # mode is validate\n                status = self.validate(\n                    args.governed_heading,\n                    args.header_validate,\n                    args.header_only_validate,\n                    args.recurse,\n                    args.readme_validate,\n                    args.template_version,\n                    args.ignore,\n                    args.validate_template_type\n                )\n\n            return status\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error occurred when running trestle author docs')\n\n    def setup_template_governed_docs(self, template_version: str) -&gt; int:\n        \"\"\"Create structure to allow markdown template enforcement.\n\n        Returns:\n            Unix return code.\n        \"\"\"\n        if not self.task_path.exists():\n            self.task_path.mkdir(exist_ok=True, parents=True)\n        elif self.task_path.is_file():\n            raise TrestleError(f'Task path: {self.rel_dir(self.task_path)} is a file not a directory.')\n        if not self.template_dir.exists():\n            self.template_dir.mkdir(exist_ok=True, parents=True)\n        elif self.template_dir.is_file():\n            raise TrestleError(f'Template path: {self.rel_dir(self.template_dir)} is a file not a directory.')\n        logger.debug(self.template_dir)\n        if not self._validate_template_dir():\n            raise TrestleError('Aborting setup')\n        template_file = self.template_dir / self.template_name\n        if template_file.is_file():\n            return CmdReturnCodes.SUCCESS.value\n        TemplateVersioning.write_versioned_template('template.md', self.template_dir, template_file, template_version)\n        logger.info(f'Template file setup for task {self.task_name} at {self.rel_dir(template_file)}')\n        logger.info(f'Task directory is {self.rel_dir(self.task_path)}')\n        return CmdReturnCodes.SUCCESS.value\n\n    def create_sample(self) -&gt; int:\n        \"\"\"Presuming the template exists, copy into a sample markdown file with an index.\"\"\"\n        template_file = self.template_dir / self.template_name\n\n        if not self._validate_template_dir():\n            raise TrestleError('Aborting setup')\n        if not template_file.is_file():\n            raise TrestleError('No template file ... exiting.')\n\n        index = 0\n        while True:\n            candidate_task = self.task_path / f'{self.task_name}_{index:03d}.md'\n            if candidate_task.is_file():\n                index = index + 1\n            else:\n                shutil.copy(str(template_file), str(candidate_task))\n                break\n        return CmdReturnCodes.SUCCESS.value\n\n    def template_validate(self, heading: Optional[str], validate_header: bool, validate_only_header: bool) -&gt; int:\n        \"\"\"Validate that the template is acceptable markdown.\"\"\"\n        template_file = self.template_dir / self.template_name\n        if not self._validate_template_dir():\n            raise TrestleError(f'Aborting setup, template directory {self.template_dir} is invalid.')\n        if not template_file.is_file():\n            raise TrestleError(f'Required template file: {self.rel_dir(template_file)} does not exist. Exiting.')\n        try:\n            md_api = MarkdownAPI()\n            validate_body = False if validate_only_header else True\n            md_api.load_validator_with_template(\n                template_file, validate_header or validate_only_header, validate_body, heading, True\n            )\n        except Exception as ex:\n            raise TrestleError(f'Template for task {self.task_name} failed to validate due to {ex}')\n\n        logger.info(f'TEMPLATES VALID: {self.task_name}')\n        return CmdReturnCodes.SUCCESS.value\n\n    def _validate_template_dir(self) -&gt; bool:\n        \"\"\"Template directory should only have template file.\"\"\"\n        for child in file_utils.iterdir_without_hidden_files(self.template_dir):\n            # Only allowable template file in the directory is the template directory.\n            if child.name != self.template_name and child.name.lower() != 'readme.md':\n                logger.warning(f'Unknown file: {child.name} in template directory {self.rel_dir(self.template_dir)}')\n                return False\n        return True\n\n    def _validate_dir(\n        self,\n        governed_heading: str,\n        md_dir: pathlib.Path,\n        validate_header: bool,\n        validate_only_header: bool,\n        recurse: bool,\n        readme_validate: bool,\n        template_version: Optional[str] = None,\n        ignore: Optional[str] = None,\n        validate_by_type_field: bool = False\n    ) -&gt; int:\n        \"\"\"\n        Validate md files in a directory with option to recurse.\n\n        Template version will be fetched from the instance header.\n        \"\"\"\n        # status is a linux returncode\n        status = 0\n        for item_path in md_dir.iterdir():\n            if file_utils.is_local_and_visible(item_path):\n                if item_path.is_file():\n                    if not item_path.suffix == const.MARKDOWN_FILE_EXT:\n                        logger.info(\n                            f'Unexpected file {self.rel_dir(item_path)} in folder {self.rel_dir(md_dir)}, skipping.'\n                        )\n                        continue\n                    if not readme_validate and item_path.name.lower() == 'readme.md':\n                        continue\n\n                    if ignore:\n                        p = re.compile(ignore)\n                        matched = p.match(item_path.parts[-1])\n                        if matched is not None:\n                            logger.info(f'Ignoring file {item_path} from validation.')\n                            continue\n\n                    md_api = MarkdownAPI()\n                    if template_version != '':\n                        template_file = self.template_dir / self.template_name\n                    else:\n                        instance_version = md_api.processor.fetch_value_from_header(\n                            item_path, author_const.TEMPLATE_VERSION_HEADER\n                        )\n                        if instance_version is None:\n                            instance_version = '0.0.1'\n                        versione_template_dir = TemplateVersioning.get_versioned_template_dir(\n                            self.template_dir, instance_version\n                        )\n                        # checks on naming template name out of type header if needed\n                        if validate_by_type_field:\n                            # get template name out of its type which essentially needs to be the same\n                            template_name = md_api.processor.fetch_value_from_header(\n                                item_path, author_const.TEMPLATE_TYPE_HEADER\n                            )\n                            # throw an error if template type is not present\n                            if template_name is None:\n                                logger.error(\n                                    f'INVALID: Instance file {item_path} does not have'\n                                    f' {author_const.TEMPLATE_TYPE_HEADER}'\n                                    ' field in its header and can not be validated using optional parameter validate'\n                                    ' template type field'\n                                )\n                                status = 1\n                                return status\n                            template_name = template_name + '.md'\n                            template_file = versione_template_dir / template_name\n                        else:  # continues regular flow without template type\n                            template_file = versione_template_dir / self.template_name\n                    if not template_file.is_file():\n                        raise TrestleError(\n                            f'Required template file: {self.rel_dir(template_file)} does not exist. Exiting.'\n                        )\n                    md_api.load_validator_with_template(\n                        template_file, validate_header, not validate_only_header, governed_heading\n                    )\n                    if not md_api.validate_instance(item_path):\n                        logger.info(f'INVALID: {self.rel_dir(item_path)}')\n                        status = 1\n                    else:\n                        logger.info(f'VALID: {self.rel_dir(item_path)}')\n                elif recurse:\n                    if ignore:\n                        p = re.compile(ignore)\n                        if len(list(filter(p.match, str(item_path.relative_to(md_dir)).split('/')))) &gt; 0:\n                            logger.info(f'Ignoring directory {item_path} from validation.')\n                            continue\n                    rc = self._validate_dir(\n                        governed_heading,\n                        item_path,\n                        validate_header,\n                        validate_only_header,\n                        recurse,\n                        readme_validate,\n                        template_version,\n                        ignore,\n                        validate_by_type_field\n                    )\n                    if rc != 0:\n                        status = rc\n\n        return status\n\n    def validate(\n        self,\n        governed_heading: str,\n        validate_header: bool,\n        validate_only_header: bool,\n        recurse: bool,\n        readme_validate: bool,\n        template_version: str,\n        ignore: str,\n        validate_by_type_field: bool\n    ) -&gt; int:\n        \"\"\"\n        Validate task.\n\n        Args:\n            governed_heading: A heading for which structural enforcement (see online docs).\n            validate_header: Whether or not to validate the key structure of the yaml header to the markdown document.\n            validate_only_header: Whether to validate just the yaml header.\n            recurse: Whether to allow validated files to be in a directory tree.\n            readme_validate: Whether to validate readme files, otherwise they will be ignored.\n\n        Returns:\n            Return code to be used for the command.\n        \"\"\"\n        if not self.task_path.is_dir():\n            raise TrestleError(f'Task directory {self.rel_dir(self.task_path)} does not exist. Exiting validate.')\n\n        return self._validate_dir(\n            governed_heading,\n            self.task_path,\n            validate_header,\n            validate_only_header,\n            recurse,\n            readme_validate,\n            template_version,\n            ignore,\n            validate_by_type_field\n        )\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.Docs-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.Docs.name","title":"<code>name = 'docs'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.Docs.template_name","title":"<code>template_name = 'template.md'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.Docs-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.Docs.create_sample","title":"<code>create_sample()</code>","text":"<p>Presuming the template exists, copy into a sample markdown file with an index.</p> Source code in <code>trestle/core/commands/author/docs.py</code> <pre><code>def create_sample(self) -&gt; int:\n    \"\"\"Presuming the template exists, copy into a sample markdown file with an index.\"\"\"\n    template_file = self.template_dir / self.template_name\n\n    if not self._validate_template_dir():\n        raise TrestleError('Aborting setup')\n    if not template_file.is_file():\n        raise TrestleError('No template file ... exiting.')\n\n    index = 0\n    while True:\n        candidate_task = self.task_path / f'{self.task_name}_{index:03d}.md'\n        if candidate_task.is_file():\n            index = index + 1\n        else:\n            shutil.copy(str(template_file), str(candidate_task))\n            break\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.Docs.setup_template_governed_docs","title":"<code>setup_template_governed_docs(template_version)</code>","text":"<p>Create structure to allow markdown template enforcement.</p> <p>Returns:</p> Type Description <code>int</code> <p>Unix return code.</p> Source code in <code>trestle/core/commands/author/docs.py</code> <pre><code>def setup_template_governed_docs(self, template_version: str) -&gt; int:\n    \"\"\"Create structure to allow markdown template enforcement.\n\n    Returns:\n        Unix return code.\n    \"\"\"\n    if not self.task_path.exists():\n        self.task_path.mkdir(exist_ok=True, parents=True)\n    elif self.task_path.is_file():\n        raise TrestleError(f'Task path: {self.rel_dir(self.task_path)} is a file not a directory.')\n    if not self.template_dir.exists():\n        self.template_dir.mkdir(exist_ok=True, parents=True)\n    elif self.template_dir.is_file():\n        raise TrestleError(f'Template path: {self.rel_dir(self.template_dir)} is a file not a directory.')\n    logger.debug(self.template_dir)\n    if not self._validate_template_dir():\n        raise TrestleError('Aborting setup')\n    template_file = self.template_dir / self.template_name\n    if template_file.is_file():\n        return CmdReturnCodes.SUCCESS.value\n    TemplateVersioning.write_versioned_template('template.md', self.template_dir, template_file, template_version)\n    logger.info(f'Template file setup for task {self.task_name} at {self.rel_dir(template_file)}')\n    logger.info(f'Task directory is {self.rel_dir(self.task_path)}')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.Docs.template_validate","title":"<code>template_validate(heading, validate_header, validate_only_header)</code>","text":"<p>Validate that the template is acceptable markdown.</p> Source code in <code>trestle/core/commands/author/docs.py</code> <pre><code>def template_validate(self, heading: Optional[str], validate_header: bool, validate_only_header: bool) -&gt; int:\n    \"\"\"Validate that the template is acceptable markdown.\"\"\"\n    template_file = self.template_dir / self.template_name\n    if not self._validate_template_dir():\n        raise TrestleError(f'Aborting setup, template directory {self.template_dir} is invalid.')\n    if not template_file.is_file():\n        raise TrestleError(f'Required template file: {self.rel_dir(template_file)} does not exist. Exiting.')\n    try:\n        md_api = MarkdownAPI()\n        validate_body = False if validate_only_header else True\n        md_api.load_validator_with_template(\n            template_file, validate_header or validate_only_header, validate_body, heading, True\n        )\n    except Exception as ex:\n        raise TrestleError(f'Template for task {self.task_name} failed to validate due to {ex}')\n\n    logger.info(f'TEMPLATES VALID: {self.task_name}')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs.Docs.validate","title":"<code>validate(governed_heading, validate_header, validate_only_header, recurse, readme_validate, template_version, ignore, validate_by_type_field)</code>","text":"<p>Validate task.</p> <p>Parameters:</p> Name Type Description Default <code>governed_heading</code> <code>str</code> <p>A heading for which structural enforcement (see online docs).</p> required <code>validate_header</code> <code>bool</code> <p>Whether or not to validate the key structure of the yaml header to the markdown document.</p> required <code>validate_only_header</code> <code>bool</code> <p>Whether to validate just the yaml header.</p> required <code>recurse</code> <code>bool</code> <p>Whether to allow validated files to be in a directory tree.</p> required <code>readme_validate</code> <code>bool</code> <p>Whether to validate readme files, otherwise they will be ignored.</p> required <p>Returns:</p> Type Description <code>int</code> <p>Return code to be used for the command.</p> Source code in <code>trestle/core/commands/author/docs.py</code> <pre><code>def validate(\n    self,\n    governed_heading: str,\n    validate_header: bool,\n    validate_only_header: bool,\n    recurse: bool,\n    readme_validate: bool,\n    template_version: str,\n    ignore: str,\n    validate_by_type_field: bool\n) -&gt; int:\n    \"\"\"\n    Validate task.\n\n    Args:\n        governed_heading: A heading for which structural enforcement (see online docs).\n        validate_header: Whether or not to validate the key structure of the yaml header to the markdown document.\n        validate_only_header: Whether to validate just the yaml header.\n        recurse: Whether to allow validated files to be in a directory tree.\n        readme_validate: Whether to validate readme files, otherwise they will be ignored.\n\n    Returns:\n        Return code to be used for the command.\n    \"\"\"\n    if not self.task_path.is_dir():\n        raise TrestleError(f'Task directory {self.rel_dir(self.task_path)} does not exist. Exiting validate.')\n\n    return self._validate_dir(\n        governed_heading,\n        self.task_path,\n        validate_header,\n        validate_only_header,\n        recurse,\n        readme_validate,\n        template_version,\n        ignore,\n        validate_by_type_field\n    )\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/docs/#trestle.core.commands.author.docs-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/folders/","title":"trestle.core.commands.author.folders","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders","title":"<code>trestle.core.commands.author.folders</code>","text":"<p>Trestle author docs sub-command.</p>"},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders.Folders","title":"<code>Folders</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Markdown governed folders - enforcing consistent files and templates across directories.</p> Source code in <code>trestle/core/commands/author/folders.py</code> <pre><code>class Folders(AuthorCommonCommand):\n    \"\"\"Markdown governed folders - enforcing consistent files and templates across directories.\"\"\"\n\n    name = 'folders'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument(\n            author_const.GH_SHORT, author_const.GH_LONG, help=author_const.GH_HELP, default=None, type=str\n        )\n        self.add_argument(\n            author_const.SHORT_HEADER_VALIDATE,\n            author_const.LONG_HEADER_VALIDATE,\n            help=author_const.HEADER_VALIDATE_HELP,\n            action='store_true'\n        )\n        self.add_argument(\n            author_const.HOV_SHORT, author_const.HOV_LONG, help=author_const.HOV_HELP, action='store_true'\n        )\n        self.add_argument(\n            author_const.SHORT_TEMPLATE_VERSION,\n            author_const.LONG_TEMPLATE_VERSION,\n            help=author_const.TEMPLATE_VERSION_HELP,\n            action='store'\n        )\n        self.add_argument(\n            author_const.SHORT_IGNORE, author_const.LONG_IGNORE, help=author_const.IGNORE_HELP, default=None, type=str\n        )\n        self.add_argument(author_const.MODE_ARG_NAME, choices=author_const.MODE_CHOICES)\n        tn_help_str = '\\n'.join(\n            [\n                'The name of the the task to be governed.',\n                '',\n                'The template files are at .trestle/author/[task-name],',\n                'where the directory tree established and the markdown files within that directory'\n                + 'tree are enforced.'\n            ]\n        )\n\n        self.add_argument(\n            author_const.TASK_NAME_SHORT, author_const.TASK_NAME_LONG, help=tn_help_str, required=True, type=str\n        )\n        self.add_argument(\n            author_const.SHORT_README_VALIDATE,\n            author_const.LONG_README_VALIDATE,\n            help=author_const.README_VALIDATE_FOLDERS_HELP,\n            action='store_true'\n        )\n\n        self.add_argument(\n            author_const.TEMPLATE_TYPE_VALIDATE_SHORT,\n            author_const.TEMPLATE_TYPE_VALIDATE_LONG,\n            help=author_const.TEMPLATE_TYPE_VALIDATE_HELP,\n            action='store_true'\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            if self._initialize(args):\n                raise TrestleError(f'Error when initializing trestle folders command with args: {args}')\n            if args.mode == 'create-sample':\n                status = self.create_sample()\n\n            elif args.mode == 'template-validate':\n                status = self.template_validate(\n                    args.header_validate, args.header_only_validate, args.governed_heading, args.readme_validate\n                )\n            elif args.mode == 'setup':\n                status = self.setup_template(args.template_version)\n            elif args.mode == 'validate':\n                # mode is validate\n                status = self.validate(\n                    args.header_validate,\n                    args.header_only_validate,\n                    args.governed_heading,\n                    args.readme_validate,\n                    args.template_version,\n                    args.ignore,\n                    args.validate_template_type\n                )\n            else:\n                raise TrestleIncorrectArgsError(f'Unsupported mode: {args.mode} for folders command.')\n\n            return status\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error occurred when running trestle author folders')\n\n    def setup_template(self, template_version: str) -&gt; int:\n        \"\"\"Create structure to allow markdown template enforcement.\"\"\"\n        if not self.task_path.exists():\n            self.task_path.mkdir(exist_ok=True, parents=True)\n        elif self.task_path.is_file():\n            raise TrestleError(f'Task path: {self.rel_dir(self.task_path)} is a file not a directory.')\n        if not self.template_dir.exists():\n            self.template_dir.mkdir(exist_ok=True, parents=True)\n        elif self.template_dir.is_file():\n            raise TrestleError(f'Template path: {self.rel_dir(self.template_dir)} is a file not a directory.')\n\n        template_file_a_md = self.template_dir / 'a_template.md'\n        template_file_another_md = self.template_dir / 'another_template.md'\n        template_file_drawio = self.template_dir / 'architecture.drawio'\n        TemplateVersioning.write_versioned_template(\n            'template.md', self.template_dir, template_file_a_md, template_version\n        )\n        TemplateVersioning.write_versioned_template(\n            'template.md', self.template_dir, template_file_another_md, template_version\n        )\n        TemplateVersioning.write_versioned_template(\n            'template.drawio', self.template_dir, template_file_drawio, template_version\n        )\n\n        return CmdReturnCodes.SUCCESS.value\n\n    def template_validate(\n        self, validate_header: bool, validate_only_header: bool, heading: str, readme_validate: bool\n    ) -&gt; int:\n        \"\"\"Validate that the template is acceptable markdown.\"\"\"\n        if not self.template_dir.is_dir():\n            raise TrestleError(\n                f'Template directory {self.rel_dir(self.template_dir)} for task {self.task_name} does not exist.'\n            )\n        # get list of files:\n        template_files = self.template_dir.rglob('*')\n\n        for template_file in template_files:\n            try:\n                if not file_utils.is_local_and_visible(template_file):\n                    continue\n                elif template_file.is_dir():\n                    continue\n                elif template_file.suffix.lower() == const.MARKDOWN_FILE_EXT:\n                    if not readme_validate and template_file.name == 'readme.md':\n                        raise TrestleError('Template directory contains a readme.md file and readme validation is off.')\n\n                    md_api = MarkdownAPI()\n                    md_api.load_validator_with_template(\n                        template_file, validate_header, not validate_only_header, heading\n                    )\n                elif template_file.suffix.lower().lstrip('.') == 'drawio':\n                    _ = draw_io.DrawIOMetadataValidator(template_file)\n                else:\n                    logger.info(\n                        f'File: {self.rel_dir(template_file)} within the template directory was ignored'\n                        + ' as it is not markdown.'\n                    )\n            except Exception as ex:\n                raise TrestleError(\n                    f'Template file {self.rel_dir(template_file)} for task {self.task_name}'\n                    + f' failed to validate due to {ex}'\n                )\n        logger.info(f'TEMPLATES VALID: {self.task_name}.')\n        return CmdReturnCodes.SUCCESS.value\n\n    def _measure_template_folder(\n        self,\n        instance_dir: pathlib.Path,\n        validate_header: bool,\n        validate_only_header: bool,\n        governed_heading: str,\n        readme_validate: bool,\n        template_version: str,\n        ignore: str,\n        validate_by_type_field: bool,\n    ) -&gt; bool:\n        \"\"\"\n        Validate instances against templates.\n\n        Validation will succeed if:\n            1. All template files from the specified version are present in the task\n            2. All of the instances are valid\n        \"\"\"\n        all_versioned_templates: Dict[str, Any] = {}\n        instance_version = template_version\n        instance_file_names: List[pathlib.Path] = []\n        # Fetch all instances versions and build dictionary of required template files\n        for instance_file in instance_dir.iterdir():\n            if not file_utils.is_local_and_visible(instance_file):\n                continue\n            if not instance_file.is_file():\n                continue\n            if instance_file.name.lower() == 'readme.md' and not readme_validate:\n                continue\n            if ignore:\n                p = re.compile(ignore)\n                matched = p.match(instance_file.parts[-1])\n                if matched is not None:\n                    logger.info(f'Ignoring file {instance_file} from validation.')\n                    continue\n            instance_file_name = instance_file.relative_to(instance_dir)\n            instance_file_names.append(instance_file_name)\n            if instance_file.suffix == const.MARKDOWN_FILE_EXT:\n                md_api = MarkdownAPI()\n                versioned_template_dir = None\n                # checks on naming template name out of type header if needed\n                if validate_by_type_field:\n                    template_name = md_api.processor.fetch_value_from_header(\n                        instance_file, author_const.TEMPLATE_TYPE_HEADER\n                    )\n                    if template_name is None:\n                        logger.warning(\n                            f'INVALID: Instance file {instance_file_name} does not have'\n                            f' {author_const.TEMPLATE_TYPE_HEADER}'\n                            ' field in its header and can not be validated using optional parameter validate'\n                            ' template type field'\n                        )\n                        return False\n                    template_name = template_name + '.md'\n                else:\n                    template_name = instance_file_name\n                if template_version != '':\n                    template_file = self.template_dir / template_name\n                    versioned_template_dir = self.template_dir\n                else:\n                    instance_version = md_api.processor.fetch_value_from_header(\n                        instance_file, author_const.TEMPLATE_VERSION_HEADER\n                    )\n                    if instance_version is None:\n                        instance_version = '0.0.1'  # backward compatibility\n                    versioned_template_dir = TemplateVersioning.get_versioned_template_dir(\n                        self.template_dir, instance_version\n                    )\n                    template_file = versioned_template_dir / template_name\n\n                # Check if instance is in the available templates,\n                # additional files are allowed but should not be validated.\n                templates = self._get_templates(versioned_template_dir, readme_validate)\n                is_template_present = False\n                template_type_is_valid = False\n                for template in templates:\n                    # checks if valdation needs to check on x-trestle-template-type field on header\n                    if validate_by_type_field:\n                        instance_template_type = md_api.processor.fetch_value_from_header(\n                            instance_file, author_const.TEMPLATE_TYPE_HEADER\n                        )\n                        if template.stem == instance_template_type:\n                            is_template_present = True\n                            template_type_is_valid = True\n                            break\n                    # validation through template type field is not needed and performs validation\n                    # through file name flow as usual\n                    else:\n                        if template.name == str(instance_file_name):\n                            is_template_present = True\n                            break\n\n                if not is_template_present:\n                    logger.info(\n                        f'INFO: File{instance_file} will not be validated '\n                        f'as its name does not match any template file.'\n                    )\n                    continue\n\n                if instance_version not in all_versioned_templates.keys():\n                    all_versioned_templates[instance_version] = dict.fromkeys(\n                        [t.relative_to(versioned_template_dir) for t in templates], False\n                    )\n\n                if instance_file_name in all_versioned_templates[instance_version] or template_type_is_valid:\n                    # validate\n                    md_api.load_validator_with_template(\n                        template_file, validate_header, not validate_only_header, governed_heading\n                    )\n                    status = md_api.validate_instance(instance_file)\n                    if not status:\n                        logger.warning(\n                            f'INVALID: Markdown file {instance_file} failed validation against' + f' {template_file}'\n                        )\n                        return False\n                    else:\n                        logger.info(f'VALID: {instance_file}')\n                    # mark template as present\n                    if template_type_is_valid:\n                        template_file_name = [\n                            temp.relative_to(versioned_template_dir) for temp in templates if temp.name == template_name\n                        ]\n                        all_versioned_templates[instance_version][template_file_name[0]] = True\n                    else:\n                        all_versioned_templates[instance_version][instance_file_name] = True\n\n            elif instance_file.suffix == const.DRAWIO_FILE_EXT:\n                drawio = draw_io.DrawIO(instance_file)\n                metadata = drawio.get_metadata()[0]\n                versioned_template_dir = None\n                if template_version != '':\n                    template_file = self.template_dir / instance_file_name\n                    versioned_template_dir = self.template_dir\n                else:\n                    if author_const.TEMPLATE_VERSION_HEADER in metadata.keys():\n                        instance_version = metadata[author_const.TEMPLATE_VERSION_HEADER]\n                    else:\n                        instance_version = '0.0.1'  # backward compatibility\n\n                    versioned_template_dir = TemplateVersioning.get_versioned_template_dir(\n                        self.template_dir, instance_version\n                    )\n                    template_file = versioned_template_dir / instance_file_name\n\n                if instance_version not in all_versioned_templates.keys():\n                    templates = self._get_templates(versioned_template_dir, readme_validate)\n\n                    all_versioned_templates[instance_version] = dict.fromkeys(\n                        [t.relative_to(versioned_template_dir) for t in templates], False\n                    )\n\n                if instance_file_name in all_versioned_templates[instance_version]:\n                    # validate\n                    drawio_validator = draw_io.DrawIOMetadataValidator(template_file)\n                    status = drawio_validator.validate(instance_file)\n                    if not status:\n                        logger.warning(\n                            f'INVALID: Drawio file {instance_file} failed validation against' + f' {template_file}'\n                        )\n                        return False\n                    else:\n                        logger.info(f'VALID: {instance_file}')\n                    # mark template as present\n                    all_versioned_templates[instance_version][instance_file_name] = True\n\n            else:\n                logger.debug(f'Unsupported extension of the instance file: {instance_file}, will not be validated.')\n\n        # Check that all template files are present\n        for version in all_versioned_templates.keys():\n            for template in all_versioned_templates[version]:\n                if not all_versioned_templates[version][template]:\n                    logger.warning(\n                        f'Required template file {template} does not exist in measured instance' + f'{instance_dir}'\n                    )\n                    return False\n\n        return True\n\n    def _get_templates(self, versioned_template_dir: pathlib.Path, readme_validate: bool) -&gt; List[pathlib.Path]:\n        \"\"\"Get templates for the given version.\"\"\"\n        templates = list(\n            filter(\n                lambda p: file_utils.is_local_and_visible(p) and p.is_file()\n                and  # noqa: W504 - conflicting lint and formatting\n                (p.suffix == const.MARKDOWN_FILE_EXT or p.suffix == const.DRAWIO_FILE_EXT),\n                versioned_template_dir.iterdir()\n            )\n        )\n        if not readme_validate:\n            templates = list(filter(lambda p: p.name.lower() != 'readme.md', templates))\n\n        return templates\n\n    def create_sample(self) -&gt; int:\n        \"\"\"\n        Create a sample folder within the task and populate with template content.\n\n        Returns:\n            Unix return code for running sample as a command.\n        \"\"\"\n        ii = 0\n        while True:\n            sample_path = self.task_path / f'sample_folder_{ii}'\n            if sample_path.exists():\n                ii = ii + 1\n                continue\n            shutil.copytree(str(self.template_dir), str(sample_path))\n            return CmdReturnCodes.SUCCESS.value\n\n    def validate(\n        self,\n        validate_header: bool,\n        validate_only_header: bool,\n        governed_heading: str,\n        readme_validate: bool,\n        template_version: str,\n        ignore: str,\n        validate_by_type_field: bool,\n    ) -&gt; int:\n        \"\"\"Validate task.\"\"\"\n        if not self.task_path.is_dir():\n            raise TrestleError(f'Task directory {self.task_path} does not exist. Exiting validate.')\n\n        for task_instance in self.task_path.iterdir():\n            if task_instance.is_dir():\n                if file_utils.is_symlink(task_instance):\n                    continue\n                result = self._measure_template_folder(\n                    task_instance,\n                    validate_header,\n                    validate_only_header,\n                    governed_heading,\n                    readme_validate,\n                    template_version,\n                    ignore,\n                    validate_by_type_field\n                )\n                if not result:\n                    raise TrestleError(\n                        'Governed-folder validation failed for task'\n                        + f'{self.task_name} on directory {self.rel_dir(task_instance)}'\n                    )\n            else:\n                logger.info(\n                    f'Unexpected file {self.rel_dir(task_instance)} identified in {self.task_name}'\n                    + ' directory, ignoring.'\n                )\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders.Folders-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders.Folders.name","title":"<code>name = 'folders'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders.Folders-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders.Folders.create_sample","title":"<code>create_sample()</code>","text":"<p>Create a sample folder within the task and populate with template content.</p> <p>Returns:</p> Type Description <code>int</code> <p>Unix return code for running sample as a command.</p> Source code in <code>trestle/core/commands/author/folders.py</code> <pre><code>def create_sample(self) -&gt; int:\n    \"\"\"\n    Create a sample folder within the task and populate with template content.\n\n    Returns:\n        Unix return code for running sample as a command.\n    \"\"\"\n    ii = 0\n    while True:\n        sample_path = self.task_path / f'sample_folder_{ii}'\n        if sample_path.exists():\n            ii = ii + 1\n            continue\n        shutil.copytree(str(self.template_dir), str(sample_path))\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders.Folders.setup_template","title":"<code>setup_template(template_version)</code>","text":"<p>Create structure to allow markdown template enforcement.</p> Source code in <code>trestle/core/commands/author/folders.py</code> <pre><code>def setup_template(self, template_version: str) -&gt; int:\n    \"\"\"Create structure to allow markdown template enforcement.\"\"\"\n    if not self.task_path.exists():\n        self.task_path.mkdir(exist_ok=True, parents=True)\n    elif self.task_path.is_file():\n        raise TrestleError(f'Task path: {self.rel_dir(self.task_path)} is a file not a directory.')\n    if not self.template_dir.exists():\n        self.template_dir.mkdir(exist_ok=True, parents=True)\n    elif self.template_dir.is_file():\n        raise TrestleError(f'Template path: {self.rel_dir(self.template_dir)} is a file not a directory.')\n\n    template_file_a_md = self.template_dir / 'a_template.md'\n    template_file_another_md = self.template_dir / 'another_template.md'\n    template_file_drawio = self.template_dir / 'architecture.drawio'\n    TemplateVersioning.write_versioned_template(\n        'template.md', self.template_dir, template_file_a_md, template_version\n    )\n    TemplateVersioning.write_versioned_template(\n        'template.md', self.template_dir, template_file_another_md, template_version\n    )\n    TemplateVersioning.write_versioned_template(\n        'template.drawio', self.template_dir, template_file_drawio, template_version\n    )\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders.Folders.template_validate","title":"<code>template_validate(validate_header, validate_only_header, heading, readme_validate)</code>","text":"<p>Validate that the template is acceptable markdown.</p> Source code in <code>trestle/core/commands/author/folders.py</code> <pre><code>def template_validate(\n    self, validate_header: bool, validate_only_header: bool, heading: str, readme_validate: bool\n) -&gt; int:\n    \"\"\"Validate that the template is acceptable markdown.\"\"\"\n    if not self.template_dir.is_dir():\n        raise TrestleError(\n            f'Template directory {self.rel_dir(self.template_dir)} for task {self.task_name} does not exist.'\n        )\n    # get list of files:\n    template_files = self.template_dir.rglob('*')\n\n    for template_file in template_files:\n        try:\n            if not file_utils.is_local_and_visible(template_file):\n                continue\n            elif template_file.is_dir():\n                continue\n            elif template_file.suffix.lower() == const.MARKDOWN_FILE_EXT:\n                if not readme_validate and template_file.name == 'readme.md':\n                    raise TrestleError('Template directory contains a readme.md file and readme validation is off.')\n\n                md_api = MarkdownAPI()\n                md_api.load_validator_with_template(\n                    template_file, validate_header, not validate_only_header, heading\n                )\n            elif template_file.suffix.lower().lstrip('.') == 'drawio':\n                _ = draw_io.DrawIOMetadataValidator(template_file)\n            else:\n                logger.info(\n                    f'File: {self.rel_dir(template_file)} within the template directory was ignored'\n                    + ' as it is not markdown.'\n                )\n        except Exception as ex:\n            raise TrestleError(\n                f'Template file {self.rel_dir(template_file)} for task {self.task_name}'\n                + f' failed to validate due to {ex}'\n            )\n    logger.info(f'TEMPLATES VALID: {self.task_name}.')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders.Folders.validate","title":"<code>validate(validate_header, validate_only_header, governed_heading, readme_validate, template_version, ignore, validate_by_type_field)</code>","text":"<p>Validate task.</p> Source code in <code>trestle/core/commands/author/folders.py</code> <pre><code>def validate(\n    self,\n    validate_header: bool,\n    validate_only_header: bool,\n    governed_heading: str,\n    readme_validate: bool,\n    template_version: str,\n    ignore: str,\n    validate_by_type_field: bool,\n) -&gt; int:\n    \"\"\"Validate task.\"\"\"\n    if not self.task_path.is_dir():\n        raise TrestleError(f'Task directory {self.task_path} does not exist. Exiting validate.')\n\n    for task_instance in self.task_path.iterdir():\n        if task_instance.is_dir():\n            if file_utils.is_symlink(task_instance):\n                continue\n            result = self._measure_template_folder(\n                task_instance,\n                validate_header,\n                validate_only_header,\n                governed_heading,\n                readme_validate,\n                template_version,\n                ignore,\n                validate_by_type_field\n            )\n            if not result:\n                raise TrestleError(\n                    'Governed-folder validation failed for task'\n                    + f'{self.task_name} on directory {self.rel_dir(task_instance)}'\n                )\n        else:\n            logger.info(\n                f'Unexpected file {self.rel_dir(task_instance)} identified in {self.task_name}'\n                + ' directory, ignoring.'\n            )\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/folders/#trestle.core.commands.author.folders-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/headers/","title":"trestle.core.commands.author.headers","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers","title":"<code>trestle.core.commands.author.headers</code>","text":"<p>Trestle author headers command.</p>"},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers.Headers","title":"<code>Headers</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Enforce header / metadata across file types supported by author (markdown and drawio).</p> Source code in <code>trestle/core/commands/author/headers.py</code> <pre><code>class Headers(AuthorCommonCommand):\n    \"\"\"Enforce header / metadata across file types supported by author (markdown and drawio).\"\"\"\n\n    name = 'headers'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument(\n            author_const.RECURSE_SHORT, author_const.RECURSE_LONG, help=author_const.RECURSE_HELP, action='store_true'\n        )\n        self.add_argument(author_const.MODE_ARG_NAME, choices=author_const.MODE_CHOICES)\n        tn_help_str = '\\n'.join(\n            [\n                'The name of the the task to be governed.',\n                '',\n                'The template files for header metadata governance are located at .trestle/author/[task name]',\n                'Currently supported types are:',\n                'Markdown: .trestle/author/[task name]/template.md',\n                'Drawio: .trestle/author/[task name]/template.drawio',\n                '',\n                'Note that by default this will automatically enforce the task.'\n            ]\n        )\n        self.add_argument(\n            author_const.TASK_NAME_SHORT, author_const.TASK_NAME_LONG, help=tn_help_str, type=str, default=None\n        )\n        self.add_argument(\n            author_const.SHORT_README_VALIDATE,\n            author_const.LONG_README_VALIDATE,\n            help=author_const.README_VALIDATE_HELP,\n            action='store_true'\n        )\n        self.add_argument(\n            author_const.SHORT_TEMPLATE_VERSION,\n            author_const.LONG_TEMPLATE_VERSION,\n            help=author_const.TEMPLATE_VERSION_HELP,\n            action='store'\n        )\n        self.add_argument(\n            author_const.SHORT_IGNORE, author_const.LONG_IGNORE, help=author_const.IGNORE_HELP, default=None, type=str\n        )\n        self.add_argument(\n            author_const.GLOBAL_SHORT, author_const.GLOBAL_LONG, help=author_const.GLOBAL_HELP, action='store_true'\n        )\n        self.add_argument(\n            author_const.EXCLUDE_SHORT,\n            author_const.EXCLUDE_LONG,\n            help=author_const.EXCLUDE_HELP,\n            type=pathlib.Path,\n            nargs='*',\n            default=None\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            status = 1\n            if self._initialize(args):\n                return status\n            # Handle conditional requirement of args.task_name\n            # global is special so we need to use get attribute.\n            if not self.global_ and not self.task_name:\n                logger.warning('Task name (-tn) argument is required when global is not specified')\n                return status\n\n            if args.exclude:\n                logger.warning('--exclude or -e is deprecated, use --ignore instead.')\n\n            if args.mode == 'create-sample':\n                status = self.create_sample()\n\n            elif args.mode == 'template-validate':\n                status = self.template_validate()\n            elif args.mode == 'setup':\n                status = self.setup(args.template_version)\n            elif args.mode == 'validate':\n                exclusions = []\n                if args.exclude:\n                    exclusions = args.exclude\n                # mode is validate\n                status = self.validate(\n                    args.recurse, args.readme_validate, exclusions, args.template_version, args.ignore\n                )\n            return status\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error occurred when running trestle author headers')\n\n    def create_sample(self) -&gt; int:\n        \"\"\"Create sample object, this always defaults to markdown.\"\"\"\n        logger.info('Header only validation does not support sample creation.')\n        logger.info('Exiting')\n        return CmdReturnCodes.SUCCESS.value\n\n    def setup(self, template_version: str) -&gt; int:\n        \"\"\"Create template directory and templates.\"\"\"\n        # Step 1 - validation\n\n        if self.task_name and not self.task_path.exists():\n            self.task_path.mkdir(exist_ok=True, parents=True)\n        elif self.task_name and self.task_path.is_file():\n            raise TrestleError(f'Task path: {self.rel_dir(self.task_path)} is a file not a directory.')\n\n        if not self.template_dir.exists():\n            self.template_dir.mkdir(exist_ok=True, parents=True)\n        logger.info(f'Populating template files to {self.rel_dir(self.template_dir)}')\n        for template in author_const.REFERENCE_TEMPLATES.values():\n            destination_path = self.template_dir / template\n            TemplateVersioning.write_versioned_template(template, self.template_dir, destination_path, template_version)\n\n            logger.info(f'Template directory populated {self.rel_dir(destination_path)}')\n        return CmdReturnCodes.SUCCESS.value\n\n    def template_validate(self) -&gt; int:\n        \"\"\"Validate the integrity of the template files.\"\"\"\n        logger.info('Checking template file integrity')\n        for template_file in self.template_dir.iterdir():\n            if (template_file.name not in author_const.REFERENCE_TEMPLATES.values()\n                    and template_file.name.lower() != 'readme.md'):\n                raise TrestleError(f'Unexpected template file {self.rel_dir(template_file)}')\n\n            if template_file.suffix == const.MARKDOWN_FILE_EXT:\n                try:\n                    md_api = MarkdownAPI()\n                    md_api.load_validator_with_template(template_file, True, False)\n                except Exception as ex:\n                    raise TrestleError(f'Template for task {self.task_name} failed to validate due to {ex}')\n\n            elif template_file.suffix == const.DRAWIO_FILE_EXT:\n                try:\n                    _ = DrawIOMetadataValidator(template_file)\n                except Exception as ex:\n                    raise TrestleError(f'Template for task {self.task_name} failed to validate due to {ex}')\n\n        logger.info('Templates validated')\n        return CmdReturnCodes.SUCCESS.value\n\n    def _validate_dir(\n        self,\n        candidate_dir: pathlib.Path,\n        recurse: bool,\n        readme_validate: bool,\n        relative_exclusions: List[pathlib.Path],\n        template_version: str,\n        ignore: str\n    ) -&gt; bool:\n        \"\"\"Validate a directory within the trestle workspace.\"\"\"\n        all_versioned_templates: Dict[str, Any] = {}\n        instance_version = template_version\n        instance_file_names: List[pathlib.Path] = []\n        # Fetch all instances versions and build dictionary of required template files\n        instances = list(candidate_dir.iterdir())\n        if recurse:\n            instances = candidate_dir.rglob('*')\n            if ignore:\n                p = re.compile(ignore)\n                instances = list(\n                    filter(\n                        lambda f: len(list(filter(p.match, str(f.relative_to(candidate_dir)).split('/')))) == 0,\n                        instances\n                    )\n                )\n        for instance_file in instances:\n            if not file_utils.is_local_and_visible(instance_file):\n                continue\n            if instance_file.name.lower() == 'readme.md' and not readme_validate:\n                continue\n            if instance_file.is_dir() and not recurse:\n                continue\n            if any(str(ex) in str(instance_file) for ex in relative_exclusions):\n                continue\n            if ignore:\n                p = re.compile(ignore)\n                matched = p.match(instance_file.parts[-1])\n                if matched is not None:\n                    logger.info(f'Ignoring file {instance_file} from validation.')\n                    continue\n            instance_file_name = instance_file.relative_to(candidate_dir)\n            instance_file_names.append(instance_file_name)\n            if instance_file.suffix == const.MARKDOWN_FILE_EXT:\n                md_api = MarkdownAPI()\n                versioned_template_dir = None\n                if template_version != '':\n                    versioned_template_dir = self.template_dir\n                else:\n                    instance_version = md_api.processor.fetch_value_from_header(\n                        instance_file, author_const.TEMPLATE_VERSION_HEADER\n                    )\n                    if instance_version is None:\n                        instance_version = '0.0.1'  # backward compatibility\n                    versioned_template_dir = TemplateVersioning.get_versioned_template_dir(\n                        self.template_dir, instance_version\n                    )\n\n                if instance_version not in all_versioned_templates.keys():\n                    templates = list(\n                        filter(lambda p: file_utils.is_local_and_visible(p), versioned_template_dir.iterdir())\n                    )\n                    if not readme_validate:\n                        templates = list(filter(lambda p: p.name.lower() != 'readme.md', templates))\n                    self._update_templates(all_versioned_templates, templates, instance_version)\n\n                # validate\n                md_api.load_validator_with_template(all_versioned_templates[instance_version]['md'], True, False)\n                status = md_api.validate_instance(instance_file)\n                if not status:\n                    logger.info(f'INVALID: {self.rel_dir(instance_file)}')\n                    return False\n                else:\n                    logger.info(f'VALID: {self.rel_dir(instance_file)}')\n\n            elif instance_file.suffix == const.DRAWIO_FILE_EXT:\n                drawio = DrawIO(instance_file)\n                metadata = drawio.get_metadata()[0]\n\n                versioned_template_dir = None\n                if template_version != '':\n                    versioned_template_dir = self.template_dir\n                else:\n                    if author_const.TEMPLATE_VERSION_HEADER in metadata.keys():\n                        instance_version = metadata[author_const.TEMPLATE_VERSION_HEADER]\n                    else:\n                        instance_version = '0.0.1'  # backward compatibility\n\n                    versioned_template_dir = TemplateVersioning.get_versioned_template_dir(\n                        self.template_dir, instance_version\n                    )\n\n                if instance_version not in all_versioned_templates.keys():\n                    templates = list(\n                        filter(lambda p: file_utils.is_local_and_visible(p), versioned_template_dir.iterdir())\n                    )\n                    if not readme_validate:\n                        templates = list(filter(lambda p: p.name.lower() != 'readme.md', templates))\n                    self._update_templates(all_versioned_templates, templates, instance_version)\n\n                # validate\n                drawio_validator = DrawIOMetadataValidator(all_versioned_templates[instance_version]['drawio'])\n                status = drawio_validator.validate(instance_file)\n                if not status:\n                    logger.info(f'INVALID: {self.rel_dir(instance_file)}')\n                    return False\n                else:\n                    logger.info(f'VALID: {self.rel_dir(instance_file)}')\n\n            else:\n                logger.debug(f'Unsupported extension of the instance file: {instance_file}, will not be validated.')\n\n        return True\n\n    def _update_templates(\n        self, all_versioned_templates: Dict[str, Dict[str, str]], templates: List[str], instance_version: str\n    ) -&gt; None:\n        all_versioned_templates[instance_version] = {}\n        all_drawio_templates = list(filter(lambda p: p.suffix == const.DRAWIO_FILE_EXT, templates))\n        all_md_templates = list(filter(lambda p: p.suffix == const.MARKDOWN_FILE_EXT, templates))\n        if all_drawio_templates:\n            all_versioned_templates[instance_version]['drawio'] = all_drawio_templates[0]\n        if all_md_templates:\n            all_versioned_templates[instance_version]['md'] = all_md_templates[0]\n\n    def validate(\n        self,\n        recurse: bool,\n        readme_validate: bool,\n        relative_excludes: List[pathlib.Path],\n        template_version: str,\n        ignore: str\n    ) -&gt; int:\n        \"\"\"Run validation based on available templates.\"\"\"\n        paths = []\n        if self.task_name:\n            if not self.task_path.is_dir():\n                raise TrestleError(f'Task directory {self.rel_dir(self.task_path)} does not exist. Exiting validate.')\n\n            paths = [self.task_path]\n        else:\n            for path in self.trestle_root.iterdir():\n                relative_path = path.relative_to(self.trestle_root)\n                # Files in the root directory must be exclused\n                if path.is_file():\n                    continue\n                if not file_utils.is_directory_name_allowed(path):\n                    continue\n                if str(relative_path).rstrip('/') in const.MODEL_DIR_LIST:\n                    continue\n                if (relative_path in relative_excludes):\n                    continue\n                if not file_utils.is_hidden(path):\n                    paths.append(path)\n\n        for path in paths:\n            try:\n                valid = self._validate_dir(path, recurse, readme_validate, relative_excludes, template_version, ignore)\n                if not valid:\n                    logger.info(f'validation failed on {path}')\n                    return CmdReturnCodes.DOCUMENTS_VALIDATION_ERROR.value\n            except Exception as e:\n                raise TrestleError(f'Error during header validation on {path} {e}')\n\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers.Headers-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers.Headers.name","title":"<code>name = 'headers'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers.Headers-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers.Headers.create_sample","title":"<code>create_sample()</code>","text":"<p>Create sample object, this always defaults to markdown.</p> Source code in <code>trestle/core/commands/author/headers.py</code> <pre><code>def create_sample(self) -&gt; int:\n    \"\"\"Create sample object, this always defaults to markdown.\"\"\"\n    logger.info('Header only validation does not support sample creation.')\n    logger.info('Exiting')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers.Headers.setup","title":"<code>setup(template_version)</code>","text":"<p>Create template directory and templates.</p> Source code in <code>trestle/core/commands/author/headers.py</code> <pre><code>def setup(self, template_version: str) -&gt; int:\n    \"\"\"Create template directory and templates.\"\"\"\n    # Step 1 - validation\n\n    if self.task_name and not self.task_path.exists():\n        self.task_path.mkdir(exist_ok=True, parents=True)\n    elif self.task_name and self.task_path.is_file():\n        raise TrestleError(f'Task path: {self.rel_dir(self.task_path)} is a file not a directory.')\n\n    if not self.template_dir.exists():\n        self.template_dir.mkdir(exist_ok=True, parents=True)\n    logger.info(f'Populating template files to {self.rel_dir(self.template_dir)}')\n    for template in author_const.REFERENCE_TEMPLATES.values():\n        destination_path = self.template_dir / template\n        TemplateVersioning.write_versioned_template(template, self.template_dir, destination_path, template_version)\n\n        logger.info(f'Template directory populated {self.rel_dir(destination_path)}')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers.Headers.template_validate","title":"<code>template_validate()</code>","text":"<p>Validate the integrity of the template files.</p> Source code in <code>trestle/core/commands/author/headers.py</code> <pre><code>def template_validate(self) -&gt; int:\n    \"\"\"Validate the integrity of the template files.\"\"\"\n    logger.info('Checking template file integrity')\n    for template_file in self.template_dir.iterdir():\n        if (template_file.name not in author_const.REFERENCE_TEMPLATES.values()\n                and template_file.name.lower() != 'readme.md'):\n            raise TrestleError(f'Unexpected template file {self.rel_dir(template_file)}')\n\n        if template_file.suffix == const.MARKDOWN_FILE_EXT:\n            try:\n                md_api = MarkdownAPI()\n                md_api.load_validator_with_template(template_file, True, False)\n            except Exception as ex:\n                raise TrestleError(f'Template for task {self.task_name} failed to validate due to {ex}')\n\n        elif template_file.suffix == const.DRAWIO_FILE_EXT:\n            try:\n                _ = DrawIOMetadataValidator(template_file)\n            except Exception as ex:\n                raise TrestleError(f'Template for task {self.task_name} failed to validate due to {ex}')\n\n    logger.info('Templates validated')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers.Headers.validate","title":"<code>validate(recurse, readme_validate, relative_excludes, template_version, ignore)</code>","text":"<p>Run validation based on available templates.</p> Source code in <code>trestle/core/commands/author/headers.py</code> <pre><code>def validate(\n    self,\n    recurse: bool,\n    readme_validate: bool,\n    relative_excludes: List[pathlib.Path],\n    template_version: str,\n    ignore: str\n) -&gt; int:\n    \"\"\"Run validation based on available templates.\"\"\"\n    paths = []\n    if self.task_name:\n        if not self.task_path.is_dir():\n            raise TrestleError(f'Task directory {self.rel_dir(self.task_path)} does not exist. Exiting validate.')\n\n        paths = [self.task_path]\n    else:\n        for path in self.trestle_root.iterdir():\n            relative_path = path.relative_to(self.trestle_root)\n            # Files in the root directory must be exclused\n            if path.is_file():\n                continue\n            if not file_utils.is_directory_name_allowed(path):\n                continue\n            if str(relative_path).rstrip('/') in const.MODEL_DIR_LIST:\n                continue\n            if (relative_path in relative_excludes):\n                continue\n            if not file_utils.is_hidden(path):\n                paths.append(path)\n\n    for path in paths:\n        try:\n            valid = self._validate_dir(path, recurse, readme_validate, relative_excludes, template_version, ignore)\n            if not valid:\n                logger.info(f'validation failed on {path}')\n                return CmdReturnCodes.DOCUMENTS_VALIDATION_ERROR.value\n        except Exception as e:\n            raise TrestleError(f'Error during header validation on {path} {e}')\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/headers/#trestle.core.commands.author.headers-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/jinja/","title":"trestle.core.commands.author.jinja","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja","title":"<code>trestle.core.commands.author.jinja</code>","text":"<p>Trestle Commands.</p>"},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.JinjaCmd","title":"<code>JinjaCmd</code>","text":"<p>               Bases: <code>CommandPlusDocs</code></p> <p>Transform an input template to an output document using jinja templating.</p> Source code in <code>trestle/core/commands/author/jinja.py</code> <pre><code>class JinjaCmd(CommandPlusDocs):\n    \"\"\"Transform an input template to an output document using jinja templating.\"\"\"\n\n    max_recursion_depth = 2\n\n    name = 'jinja'\n\n    def _init_arguments(self) -&gt; None:\n        self.add_argument('-i', '--input', help='Input jinja template, relative to trestle root', required=True)\n        self.add_argument('-o', '--output', help='Output template, relative to trestle root.', required=True)\n        self.add_argument(\n            '-lut',\n            '--look-up-table',\n            help='Key-value pair table, stored as yaml, to be passed to jinja as variables',\n            required=False\n        )\n        self.add_argument(\n            '-elp',\n            '--external-lut-prefix',\n            help='Prefix paths for LUT, to maintain compatibility with other templating systems',\n            required=False\n        )\n        self.add_argument(\n            '-nc',\n            '--number-captions',\n            help='Add incremental numbering to table and image captions, in the form Table n - ... and Figure n - ...',\n            action='store_true'\n        )\n        self.add_argument(\n            '-bf',\n            '--bracket-format',\n            help='With -sv, allows brackets around value, e.g. [.] or ((.)), with the dot representing the value.',\n            required=False\n        )\n        self.add_argument(\n            '-vap',\n            '--value-assigned-prefix',\n            help='Places a prefix in front of the parameter string if a value has been assigned.',\n            required=False,\n            type=str,\n            default=''\n        )\n        self.add_argument(\n            '-vnap',\n            '--value-not-assigned-prefix',\n            help='Places a prefix in front of the parameter string if a value has *not* been assigned.',\n            required=False,\n            type=str,\n            default=''\n        )\n        self.add_argument(\n            '-ssp', '--system-security-plan', help='An optional SSP to be passed', default=None, required=False\n        )\n        self.add_argument('-p', '--profile', help='An optional profile to be passed', default=None, required=False)\n        self.add_argument(\n            '-dp',\n            '--docs-profile',\n            help='Output profile controls to separate markdown files',\n            action='store_true',\n            required=False\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; None:\n        try:\n            log.set_log_level_from_args(args)\n            logger.debug(f'Starting {self.name} command')\n            input_path = pathlib.Path(args.input)\n            output_path = pathlib.Path(args.output)\n\n            logger.debug(f'input_path: {input_path}')\n            logger.debug(f'output_path: {output_path}')\n            logger.debug(f'system_security_plan path: {args.system_security_plan}')\n            logger.debug(f'profile: {args.profile}')\n            logger.debug(f'docs_profile: {args.docs_profile}')\n            logger.debug(f'lookup_table: {args.look_up_table}')\n\n            if args.system_security_plan and args.docs_profile:\n                raise TrestleIncorrectArgsError('Output to multiple files is possible with profile only.')\n\n            if args.docs_profile and not args.profile:\n                raise TrestleIncorrectArgsError('Profile must be provided to output to multiple files.')\n\n            lut = {}\n            if args.look_up_table:\n                lut_table = pathlib.Path(args.look_up_table)\n                lookup_table_path = pathlib.Path.cwd() / lut_table\n                lut = JinjaCmd.load_LUT(lookup_table_path, args.external_lut_prefix)\n\n            if args.profile and args.docs_profile:\n                return JinjaCmd.jinja_multiple_md(\n                    pathlib.Path(args.trestle_root),\n                    input_path,\n                    output_path,\n                    args.profile,\n                    lut,\n                    parameters_formatting=args.bracket_format,\n                    value_assigned_prefix=args.value_assigned_prefix,\n                    value_not_assigned_prefix=args.value_not_assigned_prefix\n                )\n\n            return JinjaCmd.jinja_ify(\n                pathlib.Path(args.trestle_root),\n                input_path,\n                output_path,\n                args.system_security_plan,\n                args.profile,\n                lut,\n                number_captions=args.number_captions,\n                parameters_formatting=args.bracket_format,\n                value_assigned_prefix=args.value_assigned_prefix,\n                value_not_assigned_prefix=args.value_not_assigned_prefix\n            )\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(  # type: ignore\n                e, logger, 'Error while generating markdown via Jinja template'\n            )\n\n    @staticmethod\n    def load_LUT(path: pathlib.Path, prefix: Optional[str]) -&gt; Dict[str, Any]:  # noqa: N802\n        \"\"\"Load a Yaml lookup table from file.\"\"\"\n        yaml = YAML()\n        lut = yaml.load(path.open('r', encoding=const.FILE_ENCODING))\n        if prefix:\n            prefixes = prefix.split('.')\n            while prefixes:\n                old_lut = lut\n                lut[prefixes.pop(-1)] = old_lut\n\n        return lut\n\n    @staticmethod\n    def jinja_ify(\n        trestle_root: pathlib.Path,\n        r_input_file: pathlib.Path,\n        r_output_file: pathlib.Path,\n        ssp: Optional[str],\n        profile: Optional[str],\n        lut: Dict[str, Any],\n        number_captions: Optional[bool] = False,\n        parameters_formatting: Optional[str] = None,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; int:\n        \"\"\"Run jinja over an input file with additional booleans.\"\"\"\n        template_folder = pathlib.Path.cwd()\n        jinja_env = Environment(\n            loader=FileSystemLoader(template_folder), extensions=extensions(), trim_blocks=True, autoescape=True\n        )\n        template = jinja_env.get_template(str(r_input_file))\n        # create boolean dict\n        if operator.xor(bool(ssp), bool(profile)):\n            raise TrestleIncorrectArgsError('Both SSP and profile should be provided or not at all')\n\n        if ssp:\n            # name lookup\n            ssp_data, _ = load_validate_model_name(trestle_root, ssp, SystemSecurityPlan)\n            lut['ssp'] = ssp_data\n            profile_path = ModelUtils.get_model_path_for_name_and_class(trestle_root, profile, Profile)\n            profile_resolver = ProfileResolver()\n            resolved_catalog = profile_resolver.get_resolved_profile_catalog(\n                trestle_root,\n                profile_path,\n                False,\n                False,\n                parameters_formatting,\n                ParameterRep.ASSIGNMENT_FORM,\n                False,\n                value_assigned_prefix,\n                value_not_assigned_prefix\n            )\n\n            ssp_writer = SSPMarkdownWriter(trestle_root)\n            ssp_writer.set_ssp(ssp_data)\n            ssp_writer.set_catalog(resolved_catalog)\n            lut['catalog'] = resolved_catalog\n            lut['catalog_interface'] = CatalogInterface(resolved_catalog)\n            lut['control_interface'] = ControlInterface()\n            lut['control_writer'] = DocsControlWriter()\n            lut['ssp_md_writer'] = ssp_writer\n\n        output = JinjaCmd.render_template(template, lut, template_folder)\n\n        output_file = trestle_root / r_output_file\n        if number_captions:\n            output_file.open('w', encoding=const.FILE_ENCODING).write(_number_captions(output))\n        else:\n            output_file.open('w', encoding=const.FILE_ENCODING).write(output)\n\n        return CmdReturnCodes.SUCCESS.value\n\n    @staticmethod\n    def jinja_multiple_md(\n        trestle_root: pathlib.Path,\n        r_input_file: pathlib.Path,\n        r_output_file: pathlib.Path,\n        profile_name: Optional[str],\n        lut: Dict[str, Any],\n        parameters_formatting: Optional[str] = None,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; int:\n        \"\"\"Output profile as multiple markdown files using Jinja.\"\"\"\n        template_folder = pathlib.Path.cwd()\n\n        # Output to multiple markdown files\n        profile, profile_path = ModelUtils.load_model_for_class(trestle_root, profile_name, Profile)\n        profile_resolver = ProfileResolver()\n        resolved_catalog = profile_resolver.get_resolved_profile_catalog(\n            trestle_root,\n            profile_path,\n            False,\n            False,\n            parameters_formatting,\n            ParameterRep.ASSIGNMENT_FORM,\n            False,\n            value_assigned_prefix,\n            value_not_assigned_prefix\n        )\n        catalog_interface = CatalogInterface(resolved_catalog)\n\n        # Generate a single markdown page for each control per each group\n        for group in catalog_interface.get_all_groups_from_catalog():\n            for control in catalog_interface.get_sorted_controls_in_group(group.id):\n                _, group_title, _ = catalog_interface.get_group_info_by_control(control.id)\n                group_dir = r_output_file\n                control_path = catalog_interface.get_control_path(control.id)\n                for sub_dir in control_path:\n                    group_dir = group_dir / sub_dir\n                    if not group_dir.exists():\n                        group_dir.mkdir(parents=True, exist_ok=True)\n\n                control_writer = DocsControlWriter()\n\n                jinja_env = Environment(\n                    loader=FileSystemLoader(template_folder),\n                    extensions=extensions(),\n                    trim_blocks=True,\n                    autoescape=True\n                )\n                template = jinja_env.get_template(str(r_input_file))\n                lut['catalog_interface'] = catalog_interface\n                lut['control_interface'] = ControlInterface()\n                lut['control_writer'] = control_writer\n                lut['control'] = control\n                lut['profile'] = profile\n                lut['group_title'] = group_title\n                output = JinjaCmd.render_template(template, lut, template_folder)\n\n                output_file = trestle_root / group_dir / pathlib.Path(control.id + const.MARKDOWN_FILE_EXT)\n                output_file.open('w', encoding=const.FILE_ENCODING).write(output)\n\n        return CmdReturnCodes.SUCCESS.value\n\n    @staticmethod\n    def render_template(template: Template, lut: Dict[str, Any], template_folder: pathlib.Path) -&gt; str:\n        \"\"\"Render template.\"\"\"\n        new_output = template.render(**lut)\n        output = ''\n        # This recursion allows nesting within expressions (e.g. an expression can contain jinja templates).\n        error_countdown = JinjaCmd.max_recursion_depth\n        while new_output != output and error_countdown &gt; 0:\n            error_countdown = error_countdown - 1\n            output = new_output\n            random_name = uuid.uuid4()  # Should be random and not used.\n            dict_loader = DictLoader({str(random_name): new_output})\n            jinja_env = Environment(\n                loader=ChoiceLoader([dict_loader, FileSystemLoader(template_folder)]),\n                extensions=extensions(),\n                autoescape=True,\n                trim_blocks=True\n            )\n            template = jinja_env.get_template(str(random_name))\n            new_output = template.render(**lut)\n\n        return output\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.JinjaCmd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.JinjaCmd.max_recursion_depth","title":"<code>max_recursion_depth = 2</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.JinjaCmd.name","title":"<code>name = 'jinja'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.JinjaCmd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.JinjaCmd.jinja_ify","title":"<code>jinja_ify(trestle_root, r_input_file, r_output_file, ssp, profile, lut, number_captions=False, parameters_formatting=None, value_assigned_prefix=None, value_not_assigned_prefix=None)</code>  <code>staticmethod</code>","text":"<p>Run jinja over an input file with additional booleans.</p> Source code in <code>trestle/core/commands/author/jinja.py</code> <pre><code>@staticmethod\ndef jinja_ify(\n    trestle_root: pathlib.Path,\n    r_input_file: pathlib.Path,\n    r_output_file: pathlib.Path,\n    ssp: Optional[str],\n    profile: Optional[str],\n    lut: Dict[str, Any],\n    number_captions: Optional[bool] = False,\n    parameters_formatting: Optional[str] = None,\n    value_assigned_prefix: Optional[str] = None,\n    value_not_assigned_prefix: Optional[str] = None\n) -&gt; int:\n    \"\"\"Run jinja over an input file with additional booleans.\"\"\"\n    template_folder = pathlib.Path.cwd()\n    jinja_env = Environment(\n        loader=FileSystemLoader(template_folder), extensions=extensions(), trim_blocks=True, autoescape=True\n    )\n    template = jinja_env.get_template(str(r_input_file))\n    # create boolean dict\n    if operator.xor(bool(ssp), bool(profile)):\n        raise TrestleIncorrectArgsError('Both SSP and profile should be provided or not at all')\n\n    if ssp:\n        # name lookup\n        ssp_data, _ = load_validate_model_name(trestle_root, ssp, SystemSecurityPlan)\n        lut['ssp'] = ssp_data\n        profile_path = ModelUtils.get_model_path_for_name_and_class(trestle_root, profile, Profile)\n        profile_resolver = ProfileResolver()\n        resolved_catalog = profile_resolver.get_resolved_profile_catalog(\n            trestle_root,\n            profile_path,\n            False,\n            False,\n            parameters_formatting,\n            ParameterRep.ASSIGNMENT_FORM,\n            False,\n            value_assigned_prefix,\n            value_not_assigned_prefix\n        )\n\n        ssp_writer = SSPMarkdownWriter(trestle_root)\n        ssp_writer.set_ssp(ssp_data)\n        ssp_writer.set_catalog(resolved_catalog)\n        lut['catalog'] = resolved_catalog\n        lut['catalog_interface'] = CatalogInterface(resolved_catalog)\n        lut['control_interface'] = ControlInterface()\n        lut['control_writer'] = DocsControlWriter()\n        lut['ssp_md_writer'] = ssp_writer\n\n    output = JinjaCmd.render_template(template, lut, template_folder)\n\n    output_file = trestle_root / r_output_file\n    if number_captions:\n        output_file.open('w', encoding=const.FILE_ENCODING).write(_number_captions(output))\n    else:\n        output_file.open('w', encoding=const.FILE_ENCODING).write(output)\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.JinjaCmd.jinja_multiple_md","title":"<code>jinja_multiple_md(trestle_root, r_input_file, r_output_file, profile_name, lut, parameters_formatting=None, value_assigned_prefix=None, value_not_assigned_prefix=None)</code>  <code>staticmethod</code>","text":"<p>Output profile as multiple markdown files using Jinja.</p> Source code in <code>trestle/core/commands/author/jinja.py</code> <pre><code>@staticmethod\ndef jinja_multiple_md(\n    trestle_root: pathlib.Path,\n    r_input_file: pathlib.Path,\n    r_output_file: pathlib.Path,\n    profile_name: Optional[str],\n    lut: Dict[str, Any],\n    parameters_formatting: Optional[str] = None,\n    value_assigned_prefix: Optional[str] = None,\n    value_not_assigned_prefix: Optional[str] = None\n) -&gt; int:\n    \"\"\"Output profile as multiple markdown files using Jinja.\"\"\"\n    template_folder = pathlib.Path.cwd()\n\n    # Output to multiple markdown files\n    profile, profile_path = ModelUtils.load_model_for_class(trestle_root, profile_name, Profile)\n    profile_resolver = ProfileResolver()\n    resolved_catalog = profile_resolver.get_resolved_profile_catalog(\n        trestle_root,\n        profile_path,\n        False,\n        False,\n        parameters_formatting,\n        ParameterRep.ASSIGNMENT_FORM,\n        False,\n        value_assigned_prefix,\n        value_not_assigned_prefix\n    )\n    catalog_interface = CatalogInterface(resolved_catalog)\n\n    # Generate a single markdown page for each control per each group\n    for group in catalog_interface.get_all_groups_from_catalog():\n        for control in catalog_interface.get_sorted_controls_in_group(group.id):\n            _, group_title, _ = catalog_interface.get_group_info_by_control(control.id)\n            group_dir = r_output_file\n            control_path = catalog_interface.get_control_path(control.id)\n            for sub_dir in control_path:\n                group_dir = group_dir / sub_dir\n                if not group_dir.exists():\n                    group_dir.mkdir(parents=True, exist_ok=True)\n\n            control_writer = DocsControlWriter()\n\n            jinja_env = Environment(\n                loader=FileSystemLoader(template_folder),\n                extensions=extensions(),\n                trim_blocks=True,\n                autoescape=True\n            )\n            template = jinja_env.get_template(str(r_input_file))\n            lut['catalog_interface'] = catalog_interface\n            lut['control_interface'] = ControlInterface()\n            lut['control_writer'] = control_writer\n            lut['control'] = control\n            lut['profile'] = profile\n            lut['group_title'] = group_title\n            output = JinjaCmd.render_template(template, lut, template_folder)\n\n            output_file = trestle_root / group_dir / pathlib.Path(control.id + const.MARKDOWN_FILE_EXT)\n            output_file.open('w', encoding=const.FILE_ENCODING).write(output)\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.JinjaCmd.load_LUT","title":"<code>load_LUT(path, prefix)</code>  <code>staticmethod</code>","text":"<p>Load a Yaml lookup table from file.</p> Source code in <code>trestle/core/commands/author/jinja.py</code> <pre><code>@staticmethod\ndef load_LUT(path: pathlib.Path, prefix: Optional[str]) -&gt; Dict[str, Any]:  # noqa: N802\n    \"\"\"Load a Yaml lookup table from file.\"\"\"\n    yaml = YAML()\n    lut = yaml.load(path.open('r', encoding=const.FILE_ENCODING))\n    if prefix:\n        prefixes = prefix.split('.')\n        while prefixes:\n            old_lut = lut\n            lut[prefixes.pop(-1)] = old_lut\n\n    return lut\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja.JinjaCmd.render_template","title":"<code>render_template(template, lut, template_folder)</code>  <code>staticmethod</code>","text":"<p>Render template.</p> Source code in <code>trestle/core/commands/author/jinja.py</code> <pre><code>@staticmethod\ndef render_template(template: Template, lut: Dict[str, Any], template_folder: pathlib.Path) -&gt; str:\n    \"\"\"Render template.\"\"\"\n    new_output = template.render(**lut)\n    output = ''\n    # This recursion allows nesting within expressions (e.g. an expression can contain jinja templates).\n    error_countdown = JinjaCmd.max_recursion_depth\n    while new_output != output and error_countdown &gt; 0:\n        error_countdown = error_countdown - 1\n        output = new_output\n        random_name = uuid.uuid4()  # Should be random and not used.\n        dict_loader = DictLoader({str(random_name): new_output})\n        jinja_env = Environment(\n            loader=ChoiceLoader([dict_loader, FileSystemLoader(template_folder)]),\n            extensions=extensions(),\n            autoescape=True,\n            trim_blocks=True\n        )\n        template = jinja_env.get_template(str(random_name))\n        new_output = template.render(**lut)\n\n    return output\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/jinja/#trestle.core.commands.author.jinja-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/prof/","title":"trestle.core.commands.author.prof","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof","title":"<code>trestle.core.commands.author.prof</code>","text":"<p>Author commands to generate profile as markdown and assemble to json after edit.</p>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileAssemble","title":"<code>ProfileAssemble</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Assemble markdown files of controls into a Profile json file.</p> Source code in <code>trestle/core/commands/author/prof.py</code> <pre><code>class ProfileAssemble(AuthorCommonCommand):\n    \"\"\"Assemble markdown files of controls into a Profile json file.\"\"\"\n\n    name = 'profile-assemble'\n\n    def _init_arguments(self) -&gt; None:\n        name_help_str = (\n            'Optional name of the profile model in the trestle workspace that is being modified.  '\n            'If not provided the output name is used.'\n        )\n        self.add_argument('-n', '--name', help=name_help_str, required=False, type=str)\n        file_help_str = 'Name of the source markdown file directory'\n        self.add_argument('-m', '--markdown', help=file_help_str, required=True, type=str)\n        output_help_str = 'Name of the output generated json Profile (ok to overwrite original)'\n        self.add_argument('-o', '--output', help=output_help_str, required=True, type=str)\n        self.add_argument('-sp', '--set-parameters', action='store_true', help=const.HELP_SET_PARAMS, required=False)\n        self.add_argument('-r', '--regenerate', action='store_true', help=const.HELP_REGENERATE)\n        self.add_argument('-vn', '--version', help=const.HELP_VERSION, required=False, type=str)\n        self.add_argument('-s', '--sections', help=const.HELP_SECTIONS, required=False, type=str)\n        self.add_argument('-rs', '--required-sections', help=const.HELP_REQUIRED_SECTIONS, required=False, type=str)\n        self.add_argument('-as', '--allowed-sections', help=const.HELP_ALLOWED_SECTIONS, required=False, type=str)\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root = pathlib.Path(args.trestle_root)\n            return self.assemble_profile(\n                trestle_root=trestle_root,\n                parent_prof_name=args.name,\n                md_name=args.markdown,\n                assem_prof_name=args.output,\n                set_parameters_flag=args.set_parameters,\n                regenerate=args.regenerate,\n                version=args.version,\n                sections_dict=comma_colon_sep_to_dict(args.sections),\n                required_sections=comma_sep_to_list(args.required_sections),\n                allowed_sections=args.allowed_sections\n            )\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Assembly of markdown to profile failed')\n\n    @staticmethod\n    def _update_alter_adds(profile: prof.Profile, alters: List[prof.Alter], alter_dict: Dict) -&gt; None:\n        for new_alter in alters:\n            alter = alter_dict.get(new_alter.control_id, None)\n            if not alter:\n                # the control did not have alters, so add\n                alter = prof.Alter(control_id=new_alter.control_id)\n            # even though we removed adds at start, we may have added one already\n            if alter.adds:\n                alter.adds.extend(new_alter.adds)\n            else:\n                alter.adds = new_alter.adds\n            # update the dict with the new alter with its added adds\n            alter_dict[new_alter.control_id] = alter\n\n    @staticmethod\n    def _replace_alter_adds(profile: prof.Profile, alters: List[prof.Alter]) -&gt; bool:\n        \"\"\"Replace the alter adds in the orig_profile with the new ones and return True if changed.\"\"\"\n        changed = False\n        if not profile.modify:\n            profile.modify = prof.Modify(alters=alters)\n            if alters:\n                changed = True\n        elif not profile.modify.alters:\n            profile.modify.alters = alters\n            if alters:\n                changed = True\n        else:\n            alter_dict = {}\n            # if an alter has adds - remove them up front and build dict of alters by control id\n            for alter in profile.modify.alters:\n                alter.adds = None\n                alter_dict[alter.control_id] = alter\n            # now go through new alters and add them to each control in dict by control id\n            ProfileAssemble._update_alter_adds(profile, alters, alter_dict)\n            # get the new list of alters from the dict and update profile\n            new_alters = list(alter_dict.values())\n            # special case, if all adds were deleted remove such alters completely\n            new_alters = list(filter(lambda alt: alt.adds or alt.removes, new_alters))\n            if profile.modify.alters != new_alters:\n                changed = True\n            profile.modify.alters = none_if_empty(new_alters)\n        return changed\n\n    @staticmethod\n    def _replace_modify_set_params(\n        profile: prof.Profile, param_dict: Dict[str, Any], param_map: Dict[str, str]\n    ) -&gt; bool:\n        \"\"\"\n        Replace the set_params in the profile with list and values from markdown.\n\n        Notes:\n            Returns whether or not change was made.\n        \"\"\"\n        changed = False\n        if param_dict:\n            if not profile.modify:\n                profile.modify = prof.Modify()\n            new_set_params: List[prof.SetParameter] = []\n            for key, sub_param_dict in param_dict.items():\n                if sub_param_dict:\n                    sub_param_dict['id'] = key\n                    param = ModelUtils.dict_to_parameter(sub_param_dict)\n                    new_set_params.append(\n                        prof.SetParameter(\n                            param_id=key,\n                            label=param.label,\n                            values=param.values,\n                            select=param.select,\n                            props=param.props\n                        )\n                    )\n            if profile.modify.set_parameters != new_set_params:\n                changed = True\n            # sort the params first by control sorting then by param_id\n            profile.modify.set_parameters = sorted(\n                new_set_params, key=lambda param: (param_map[param.param_id], param.param_id)\n            )\n        if profile.modify:\n            profile.modify.set_parameters = none_if_empty(profile.modify.set_parameters)\n        return changed\n\n    @staticmethod\n    def assemble_profile(\n        trestle_root: pathlib.Path,\n        parent_prof_name: str,\n        md_name: str,\n        assem_prof_name: str,\n        set_parameters_flag: bool,\n        regenerate: bool,\n        version: Optional[str],\n        sections_dict: Dict[str, str],\n        required_sections: List[str],\n        allowed_sections: Optional[List[str]]\n    ) -&gt; int:\n        \"\"\"\n        Assemble the markdown directory into a json profile model file.\n\n        Args:\n            trestle_root: The trestle root directory\n            parent_prof_name: Optional name of profile used to generate the markdown (default is assem_prof_name)\n            md_name: The name of the directory containing the markdown control files for the profile\n            assem_prof_name: The name of the assembled profile.  It can be the same as the parent to overwrite\n            set_parameters_flag: Use the params and props in yaml header to add or alter setparameters in the profile\n            regenerate: Whether to regenerate the uuid's in the profile\n            version: Optional version for the assembled profile\n            sections_dict: Optional map of short name to long name for sections\n            required_sections: List of required sections in assembled profile, as comma-separated short names\n            allowed_sections: Optional list of section short names that are allowed, as comma-separated short names\n\n        Returns:\n            0 on success, 1 otherwise\n\n        Notes:\n            There must already be a profile model and it will either be updated or a new json profile created.\n            The generated markdown has the current values for parameters of controls being imported, as set by\n            the original catalog and any intermediate profiles.  It also shows the current SetParameters being applied\n            by this profile.  That list of SetParameters can be edited by changing the assigned values and adding or\n            removing SetParameters from that list.  During assembly that list will be used to create the SetParameters\n            in the assembled profile if the --set-parameters option is specified.\n        \"\"\"\n        md_dir = trestle_root / md_name\n        if not md_dir.exists():\n            raise TrestleError(f'Markdown directory {md_name} does not exist.')\n\n        if not parent_prof_name:\n            parent_prof_name = assem_prof_name\n\n        parent_prof_path = ModelUtils.get_model_path_for_name_and_class(trestle_root, parent_prof_name, prof.Profile)\n        if parent_prof_path is None:\n            raise TrestleError(f'Profile {parent_prof_name} does not exist.  An existing profile must be provided.')\n\n        parent_prof, parent_prof_path = load_validate_model_name(trestle_root, parent_prof_name, prof.Profile)\n        new_content_type = FileContentType.path_to_content_type(parent_prof_path)\n\n        catalog = ProfileResolver.get_resolved_profile_catalog(\n            trestle_root, parent_prof_path, param_rep=ParameterRep.LEAVE_MOUSTACHE\n        )\n\n        context = ControlContext.generate(\n            ContextPurpose.PROFILE, to_markdown=False, trestle_root=trestle_root, md_root=md_dir\n        )\n        context.sections_dict = sections_dict\n        context.required_sections = required_sections\n\n        # load the editable sections of the markdown and create Adds for them\n        # then overwrite the Adds in the existing profile with the new ones\n        # keep track if any changes were made\n        catalog_api = CatalogAPI(catalog=catalog, context=context)\n        found_alters, param_dict, param_map = catalog_api.read_additional_content_from_md(label_as_key=True)\n\n        if allowed_sections is not None:\n            for bad_part in [\n                    part for alter in found_alters for add in as_list(alter.adds)\n                    for part in as_filtered_list(add.parts, lambda a: a.name not in allowed_sections)  # type: ignore\n            ]:\n                raise TrestleError(f'Profile has alter with name {bad_part.name} not in allowed sections.')\n\n        ProfileAssemble._replace_alter_adds(parent_prof, found_alters)\n        if set_parameters_flag:\n            ProfileAssemble._replace_modify_set_params(parent_prof, param_dict, param_map)\n\n        if version:\n            parent_prof.metadata.version = version\n\n        parent_prof.metadata.oscal_version = OSCAL_VERSION\n\n        assem_prof_path = ModelUtils.get_model_path_for_name_and_class(\n            trestle_root, assem_prof_name, prof.Profile, new_content_type\n        )\n\n        if assem_prof_path.exists():\n            _, _, existing_prof = ModelUtils.load_distributed(assem_prof_path, trestle_root)\n            if ModelUtils.models_are_equivalent(existing_prof, parent_prof):  # type: ignore\n                logger.info('Assembled profile is no different from existing version, so no update.')\n                return CmdReturnCodes.SUCCESS.value\n\n        if regenerate:\n            parent_prof, _, _ = ModelUtils.regenerate_uuids(parent_prof)\n        ModelUtils.update_last_modified(parent_prof)  # type: ignore\n\n        if assem_prof_path.parent.exists():\n            logger.info('Creating profile from markdown and destination profile exists, so updating.')\n            shutil.rmtree(str(assem_prof_path.parent))\n\n        assem_prof_path.parent.mkdir(parents=True, exist_ok=True)\n        parent_prof.oscal_write(assem_prof_path)  # type: ignore\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileAssemble-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileAssemble.name","title":"<code>name = 'profile-assemble'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileAssemble-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileAssemble.assemble_profile","title":"<code>assemble_profile(trestle_root, parent_prof_name, md_name, assem_prof_name, set_parameters_flag, regenerate, version, sections_dict, required_sections, allowed_sections)</code>  <code>staticmethod</code>","text":"<p>Assemble the markdown directory into a json profile model file.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>The trestle root directory</p> required <code>parent_prof_name</code> <code>str</code> <p>Optional name of profile used to generate the markdown (default is assem_prof_name)</p> required <code>md_name</code> <code>str</code> <p>The name of the directory containing the markdown control files for the profile</p> required <code>assem_prof_name</code> <code>str</code> <p>The name of the assembled profile.  It can be the same as the parent to overwrite</p> required <code>set_parameters_flag</code> <code>bool</code> <p>Use the params and props in yaml header to add or alter setparameters in the profile</p> required <code>regenerate</code> <code>bool</code> <p>Whether to regenerate the uuid's in the profile</p> required <code>version</code> <code>Optional[str]</code> <p>Optional version for the assembled profile</p> required <code>sections_dict</code> <code>Dict[str, str]</code> <p>Optional map of short name to long name for sections</p> required <code>required_sections</code> <code>List[str]</code> <p>List of required sections in assembled profile, as comma-separated short names</p> required <code>allowed_sections</code> <code>Optional[List[str]]</code> <p>Optional list of section short names that are allowed, as comma-separated short names</p> required <p>Returns:</p> Type Description <code>int</code> <p>0 on success, 1 otherwise</p> Notes <p>There must already be a profile model and it will either be updated or a new json profile created. The generated markdown has the current values for parameters of controls being imported, as set by the original catalog and any intermediate profiles.  It also shows the current SetParameters being applied by this profile.  That list of SetParameters can be edited by changing the assigned values and adding or removing SetParameters from that list.  During assembly that list will be used to create the SetParameters in the assembled profile if the --set-parameters option is specified.</p> Source code in <code>trestle/core/commands/author/prof.py</code> <pre><code>@staticmethod\ndef assemble_profile(\n    trestle_root: pathlib.Path,\n    parent_prof_name: str,\n    md_name: str,\n    assem_prof_name: str,\n    set_parameters_flag: bool,\n    regenerate: bool,\n    version: Optional[str],\n    sections_dict: Dict[str, str],\n    required_sections: List[str],\n    allowed_sections: Optional[List[str]]\n) -&gt; int:\n    \"\"\"\n    Assemble the markdown directory into a json profile model file.\n\n    Args:\n        trestle_root: The trestle root directory\n        parent_prof_name: Optional name of profile used to generate the markdown (default is assem_prof_name)\n        md_name: The name of the directory containing the markdown control files for the profile\n        assem_prof_name: The name of the assembled profile.  It can be the same as the parent to overwrite\n        set_parameters_flag: Use the params and props in yaml header to add or alter setparameters in the profile\n        regenerate: Whether to regenerate the uuid's in the profile\n        version: Optional version for the assembled profile\n        sections_dict: Optional map of short name to long name for sections\n        required_sections: List of required sections in assembled profile, as comma-separated short names\n        allowed_sections: Optional list of section short names that are allowed, as comma-separated short names\n\n    Returns:\n        0 on success, 1 otherwise\n\n    Notes:\n        There must already be a profile model and it will either be updated or a new json profile created.\n        The generated markdown has the current values for parameters of controls being imported, as set by\n        the original catalog and any intermediate profiles.  It also shows the current SetParameters being applied\n        by this profile.  That list of SetParameters can be edited by changing the assigned values and adding or\n        removing SetParameters from that list.  During assembly that list will be used to create the SetParameters\n        in the assembled profile if the --set-parameters option is specified.\n    \"\"\"\n    md_dir = trestle_root / md_name\n    if not md_dir.exists():\n        raise TrestleError(f'Markdown directory {md_name} does not exist.')\n\n    if not parent_prof_name:\n        parent_prof_name = assem_prof_name\n\n    parent_prof_path = ModelUtils.get_model_path_for_name_and_class(trestle_root, parent_prof_name, prof.Profile)\n    if parent_prof_path is None:\n        raise TrestleError(f'Profile {parent_prof_name} does not exist.  An existing profile must be provided.')\n\n    parent_prof, parent_prof_path = load_validate_model_name(trestle_root, parent_prof_name, prof.Profile)\n    new_content_type = FileContentType.path_to_content_type(parent_prof_path)\n\n    catalog = ProfileResolver.get_resolved_profile_catalog(\n        trestle_root, parent_prof_path, param_rep=ParameterRep.LEAVE_MOUSTACHE\n    )\n\n    context = ControlContext.generate(\n        ContextPurpose.PROFILE, to_markdown=False, trestle_root=trestle_root, md_root=md_dir\n    )\n    context.sections_dict = sections_dict\n    context.required_sections = required_sections\n\n    # load the editable sections of the markdown and create Adds for them\n    # then overwrite the Adds in the existing profile with the new ones\n    # keep track if any changes were made\n    catalog_api = CatalogAPI(catalog=catalog, context=context)\n    found_alters, param_dict, param_map = catalog_api.read_additional_content_from_md(label_as_key=True)\n\n    if allowed_sections is not None:\n        for bad_part in [\n                part for alter in found_alters for add in as_list(alter.adds)\n                for part in as_filtered_list(add.parts, lambda a: a.name not in allowed_sections)  # type: ignore\n        ]:\n            raise TrestleError(f'Profile has alter with name {bad_part.name} not in allowed sections.')\n\n    ProfileAssemble._replace_alter_adds(parent_prof, found_alters)\n    if set_parameters_flag:\n        ProfileAssemble._replace_modify_set_params(parent_prof, param_dict, param_map)\n\n    if version:\n        parent_prof.metadata.version = version\n\n    parent_prof.metadata.oscal_version = OSCAL_VERSION\n\n    assem_prof_path = ModelUtils.get_model_path_for_name_and_class(\n        trestle_root, assem_prof_name, prof.Profile, new_content_type\n    )\n\n    if assem_prof_path.exists():\n        _, _, existing_prof = ModelUtils.load_distributed(assem_prof_path, trestle_root)\n        if ModelUtils.models_are_equivalent(existing_prof, parent_prof):  # type: ignore\n            logger.info('Assembled profile is no different from existing version, so no update.')\n            return CmdReturnCodes.SUCCESS.value\n\n    if regenerate:\n        parent_prof, _, _ = ModelUtils.regenerate_uuids(parent_prof)\n    ModelUtils.update_last_modified(parent_prof)  # type: ignore\n\n    if assem_prof_path.parent.exists():\n        logger.info('Creating profile from markdown and destination profile exists, so updating.')\n        shutil.rmtree(str(assem_prof_path.parent))\n\n    assem_prof_path.parent.mkdir(parents=True, exist_ok=True)\n    parent_prof.oscal_write(assem_prof_path)  # type: ignore\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileGenerate","title":"<code>ProfileGenerate</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Generate profile in markdown form from a profile in the trestle workspace.</p> Source code in <code>trestle/core/commands/author/prof.py</code> <pre><code>class ProfileGenerate(AuthorCommonCommand):\n    \"\"\"Generate profile in markdown form from a profile in the trestle workspace.\"\"\"\n\n    name = 'profile-generate'\n\n    def _init_arguments(self) -&gt; None:\n        name_help_str = 'Name of the source profile model in the trestle workspace'\n        self.add_argument('-n', '--name', help=name_help_str, required=True, type=str)\n        self.add_argument('-o', '--output', help=const.HELP_MARKDOWN_NAME, required=True, type=str)\n        self.add_argument('-y', '--yaml-header', help=const.HELP_YAML_PATH, required=False, type=str)\n        self.add_argument(\n            '-fo', '--force-overwrite', help=const.HELP_FO_OUTPUT, required=False, action='store_true', default=False\n        )\n        self.add_argument(\n            '-ohv',\n            '--overwrite-header-values',\n            help=const.HELP_OVERWRITE_HEADER_VALUES,\n            required=False,\n            action='store_true',\n            default=False\n        )\n        self.add_argument('-s', '--sections', help=const.HELP_SECTIONS, required=False, type=str)\n        self.add_argument('-rs', '--required-sections', help=const.HELP_REQUIRED_SECTIONS, required=False, type=str)\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root: pathlib.Path = args.trestle_root\n            if not file_utils.is_directory_name_allowed(args.output):\n                raise TrestleError(f'{args.output} is not an allowed directory name')\n\n            yaml_header: Dict[str, Any] = {}\n            if args.yaml_header:\n                try:\n                    logging.debug(f'Loading yaml header file {args.yaml_header}')\n                    yaml = YAML()\n                    yaml_header = yaml.load(pathlib.Path(args.yaml_header).open('r'))\n                except YAMLError as e:\n                    raise TrestleError(f'YAML error loading yaml header for ssp generation: {e}')\n\n            if args.force_overwrite:\n                try:\n                    logger.info(f'Overwriting the content in {args.output}.')\n                    clear_folder(pathlib.Path(args.output))\n                except TrestleError as e:  # pragma: no cover\n                    raise TrestleError(f'Unable to overwrite contents of {args.output}: {e}')\n\n            # combine command line sections with any in the yaml header, with priority to command line\n            sections_dict = comma_colon_sep_to_dict(args.sections)\n\n            profile_path = trestle_root / f'profiles/{args.name}/profile.json'\n\n            markdown_path = trestle_root / args.output\n\n            return self.generate_markdown(\n                trestle_root,\n                profile_path,\n                markdown_path,\n                yaml_header,\n                args.overwrite_header_values,\n                sections_dict,\n                comma_sep_to_list(args.required_sections)\n            )\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Generation of the profile markdown failed')\n\n    def generate_markdown(\n        self,\n        trestle_root: pathlib.Path,\n        profile_path: pathlib.Path,\n        markdown_path: pathlib.Path,\n        yaml_header: Dict[str, Any],\n        overwrite_header_values: bool,\n        sections_dict: Optional[Dict[str, str]],\n        required_sections: Optional[List[str]]\n    ) -&gt; int:\n        \"\"\"Generate markdown for the controls in the profile.\n\n        Args:\n            trestle_root: Root directory of the trestle workspace\n            profile_path: Path of the profile json file\n            markdown_path: Path to the directory into which the markdown will be written\n            yaml_header: Dict to merge into the yaml header of the control markdown\n            overwrite_header_values: Overwrite values in the markdown header but allow new items to be added\n            sections_dict: Optional dict mapping section short names to long\n            required_sections: Optional list of sections that get prompted for prose if not in the profile\n\n        Returns:\n            0 on success, 1 on error\n        \"\"\"\n        try:\n            if sections_dict and const.STATEMENT in sections_dict:\n                logger.warning('statement is not allowed as a section name.')\n                return CmdReturnCodes.COMMAND_ERROR.value\n            _, _, profile = ModelUtils.load_distributed(profile_path, trestle_root)\n            catalog, inherited_props = ProfileResolver().get_resolved_profile_catalog_and_inherited_props(\n                trestle_root, profile_path, True, True, None, ParameterRep.LEAVE_MOUSTACHE\n            )\n\n            deep_set(yaml_header, [const.TRESTLE_GLOBAL_TAG, const.PROFILE, const.TITLE], profile.metadata.title)\n\n            context = ControlContext.generate(ContextPurpose.PROFILE, True, trestle_root, markdown_path)\n            context.cli_yaml_header = yaml_header\n            context.sections_dict = sections_dict\n            context.profile = profile\n            context.overwrite_header_values = overwrite_header_values\n            context.set_parameters_flag = True\n            context.required_sections = required_sections\n            context.inherited_props = inherited_props\n            catalog_api = CatalogAPI(catalog=catalog, context=context)\n            catalog_api.write_catalog_as_markdown()\n\n        except TrestleNotFoundError as e:\n            raise TrestleError(f'Profile {profile_path} not found, error {e}')\n        except TrestleError as e:\n            raise TrestleError(f'Error generating the catalog as markdown: {e}')\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileGenerate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileGenerate.name","title":"<code>name = 'profile-generate'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileGenerate-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileGenerate.generate_markdown","title":"<code>generate_markdown(trestle_root, profile_path, markdown_path, yaml_header, overwrite_header_values, sections_dict, required_sections)</code>","text":"<p>Generate markdown for the controls in the profile.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>Root directory of the trestle workspace</p> required <code>profile_path</code> <code>Path</code> <p>Path of the profile json file</p> required <code>markdown_path</code> <code>Path</code> <p>Path to the directory into which the markdown will be written</p> required <code>yaml_header</code> <code>Dict[str, Any]</code> <p>Dict to merge into the yaml header of the control markdown</p> required <code>overwrite_header_values</code> <code>bool</code> <p>Overwrite values in the markdown header but allow new items to be added</p> required <code>sections_dict</code> <code>Optional[Dict[str, str]]</code> <p>Optional dict mapping section short names to long</p> required <code>required_sections</code> <code>Optional[List[str]]</code> <p>Optional list of sections that get prompted for prose if not in the profile</p> required <p>Returns:</p> Type Description <code>int</code> <p>0 on success, 1 on error</p> Source code in <code>trestle/core/commands/author/prof.py</code> <pre><code>def generate_markdown(\n    self,\n    trestle_root: pathlib.Path,\n    profile_path: pathlib.Path,\n    markdown_path: pathlib.Path,\n    yaml_header: Dict[str, Any],\n    overwrite_header_values: bool,\n    sections_dict: Optional[Dict[str, str]],\n    required_sections: Optional[List[str]]\n) -&gt; int:\n    \"\"\"Generate markdown for the controls in the profile.\n\n    Args:\n        trestle_root: Root directory of the trestle workspace\n        profile_path: Path of the profile json file\n        markdown_path: Path to the directory into which the markdown will be written\n        yaml_header: Dict to merge into the yaml header of the control markdown\n        overwrite_header_values: Overwrite values in the markdown header but allow new items to be added\n        sections_dict: Optional dict mapping section short names to long\n        required_sections: Optional list of sections that get prompted for prose if not in the profile\n\n    Returns:\n        0 on success, 1 on error\n    \"\"\"\n    try:\n        if sections_dict and const.STATEMENT in sections_dict:\n            logger.warning('statement is not allowed as a section name.')\n            return CmdReturnCodes.COMMAND_ERROR.value\n        _, _, profile = ModelUtils.load_distributed(profile_path, trestle_root)\n        catalog, inherited_props = ProfileResolver().get_resolved_profile_catalog_and_inherited_props(\n            trestle_root, profile_path, True, True, None, ParameterRep.LEAVE_MOUSTACHE\n        )\n\n        deep_set(yaml_header, [const.TRESTLE_GLOBAL_TAG, const.PROFILE, const.TITLE], profile.metadata.title)\n\n        context = ControlContext.generate(ContextPurpose.PROFILE, True, trestle_root, markdown_path)\n        context.cli_yaml_header = yaml_header\n        context.sections_dict = sections_dict\n        context.profile = profile\n        context.overwrite_header_values = overwrite_header_values\n        context.set_parameters_flag = True\n        context.required_sections = required_sections\n        context.inherited_props = inherited_props\n        catalog_api = CatalogAPI(catalog=catalog, context=context)\n        catalog_api.write_catalog_as_markdown()\n\n    except TrestleNotFoundError as e:\n        raise TrestleError(f'Profile {profile_path} not found, error {e}')\n    except TrestleError as e:\n        raise TrestleError(f'Error generating the catalog as markdown: {e}')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileInherit","title":"<code>ProfileInherit</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Generate and populate profile in JSON from a parent profile and leveraged ssp in the trestle workspace.</p> Source code in <code>trestle/core/commands/author/prof.py</code> <pre><code>class ProfileInherit(AuthorCommonCommand):\n    \"\"\"Generate and populate profile in JSON from a parent profile and leveraged ssp in the trestle workspace.\"\"\"\n\n    name = 'profile-inherit'\n\n    def _init_arguments(self) -&gt; None:\n        ssp_help_str = 'Name of the leveraged ssp model in the trestle workspace'\n        self.add_argument('-s', '--ssp', help=ssp_help_str, required=True, type=str)\n        profile_help_str = 'Name of the parent profile model in the trestle workspace'\n        self.add_argument('-p', '--profile', help=profile_help_str, required=True, type=str)\n        output_help_str = 'Name of the output generated json Profile'\n        self.add_argument('-o', '--output', help=output_help_str, required=True, type=str)\n        self.add_argument('-vn', '--version', help=const.HELP_VERSION, required=False, type=str)\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root: pathlib.Path = args.trestle_root\n\n            if args.profile and args.profile == args.output:\n                logger.warning(f'Output profile {args.output} cannot equal parent')\n                return CmdReturnCodes.INCORRECT_ARGS.value\n\n            return self.initialize_profile(\n                trestle_root=trestle_root,\n                parent_prof_name=args.profile,\n                output_prof_name=args.output,\n                leveraged_ssp_name=args.ssp,\n                version=args.version\n            )\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Profile generation failed')\n\n    @staticmethod\n    def _is_inherited(all_comps: List[ssp.ByComponent]) -&gt; bool:\n        # Fail fast by checking for any non-compliant components.\n        # Must contain provided export statements, no responsibility\n        # statements, and be implemented.\n        for comp in all_comps:\n            if comp.export is None:\n                return False\n\n            if comp.export.responsibilities is not None:\n                return False\n\n            if comp.export.provided is None:\n                return False\n\n            if comp.implementation_status.state != const.STATUS_IMPLEMENTED:\n                return False\n\n        return True\n\n    @staticmethod\n    def _create_components_by_id(leveraged_ssp: ssp.SystemSecurityPlan) -&gt; Dict[str, List[ssp.ByComponent]]:\n        components_by_id: Dict[str, List[ssp.ByComponent]] = {}\n        for implemented_requirement in leveraged_ssp.control_implementation.implemented_requirements:\n            by_components: List[ssp.ByComponent] = []\n            if implemented_requirement.by_components:\n                by_components.extend(implemented_requirement.by_components)\n            if implemented_requirement.statements:\n                for stm in implemented_requirement.statements:\n                    if stm.by_components:\n                        by_components.extend(stm.by_components)\n            components_by_id[implemented_requirement.control_id] = none_if_empty(by_components)\n        return components_by_id\n\n    @staticmethod\n    def update_profile_import(\n        orig_prof_import: prof.Import, leveraged_ssp: ssp.SystemSecurityPlan, catalog_api: CatalogAPI\n    ) -&gt; None:\n        \"\"\"Add controls to different sections of a profile import based on catalog and leveraged SSP.\n\n        Args:\n            orig_prof_import: The original profile import that will have the control selection updated.\n            leveraged_ssp: SSP input for control filtering\n            catalog_api: Catalog API with access to controls that need to be filtered\n\n        Returns:\n            None\n        \"\"\"\n        exclude_with_ids: Set[str] = set()\n\n        # Create dictionary containing all by-components by control for faster searching\n        components_by_id: Dict[str, List[ssp.ByComponent]] = ProfileInherit._create_components_by_id(leveraged_ssp)\n\n        # Looping by controls in the catalog because the ids in the profile should\n        # be a subset of the catalog and not the ssp controls.\n        catalog_control_ids: Set[str] = set(catalog_api._catalog_interface.get_control_ids())\n        for control_id in catalog_control_ids:\n\n            if control_id not in components_by_id:\n                continue\n\n            by_comps: Optional[List[ssp.ByComponent]] = components_by_id[control_id]\n            if by_comps is not None and ProfileInherit._is_inherited(by_comps):\n                exclude_with_ids.add(control_id)\n\n        include_with_ids: Set[str] = catalog_control_ids - exclude_with_ids\n\n        orig_prof_import.include_controls = [prof.SelectControl(with_ids=sorted(include_with_ids))]\n        orig_prof_import.exclude_controls = [prof.SelectControl(with_ids=sorted(exclude_with_ids))]\n\n    def initialize_profile(\n        self,\n        trestle_root: pathlib.Path,\n        parent_prof_name: str,\n        output_prof_name: str,\n        leveraged_ssp_name: str,\n        version: Optional[str],\n    ) -&gt; int:\n        \"\"\"Initialize profile with controls from a parent profile, filtering by inherited controls.\n\n        Args:\n            trestle_root: Root directory of the trestle workspace\n            parent_prof_name: Name of the parent profile in the trestle workspace\n            output_prof_name: Name of the output profile json file\n            leveraged_ssp_name: Name of the ssp in the trestle workspace for control filtering\n            version: Optional profile version\n\n        Returns:\n            0 on success, 1 on error\n\n        Notes:\n            The profile model will either be updated or a new json profile created. This will overwrite\n            any import information on an exiting profile, but will preserve control modifications and parameters.\n            Allowing profile updates ensure that SSP export updates can be incorporated into an existing profile. All\n            controls from the original profile will exists and will be grouped by included and excluded controls based\n            on inheritance information.\n        \"\"\"\n        try:\n            result_profile: prof.Profile\n            existing_profile: Optional[prof.Profile] = None\n\n            existing_profile_path = ModelUtils.get_model_path_for_name_and_class(\n                trestle_root, output_prof_name, prof.Profile\n            )\n\n            # If a profile exists at the output path, use that as a starting point for a new profile.\n            # else create a new sample profile.\n            if existing_profile_path is not None:\n                existing_profile, _ = load_validate_model_name(trestle_root,\n                                                               output_prof_name,\n                                                               prof.Profile,\n                                                               FileContentType.JSON)\n                result_profile = copy.deepcopy(existing_profile)\n            else:\n                result_profile = gens.generate_sample_model(prof.Profile)\n\n            parent_prof_path = ModelUtils.get_model_path_for_name_and_class(\n                trestle_root, parent_prof_name, prof.Profile\n            )\n            if parent_prof_path is None:\n                raise TrestleNotFoundError(\n                    f'Profile {parent_prof_name} does not exist.  An existing profile must be provided.'\n                )\n\n            local_path = f'profiles/{parent_prof_name}/profile.json'\n            profile_import: prof.Import = gens.generate_sample_model(prof.Import)\n            profile_import.href = const.TRESTLE_HREF_HEADING + local_path\n\n            leveraged_ssp: ssp.SystemSecurityPlan\n            try:\n                leveraged_ssp, _ = load_validate_model_name(\n                    trestle_root,\n                    leveraged_ssp_name,\n                    ssp.SystemSecurityPlan,\n                    FileContentType.JSON\n                )\n            except TrestleNotFoundError as e:\n                raise TrestleError(f'SSP {leveraged_ssp_name} not found: {e}')\n\n            prof_resolver = ProfileResolver()\n            catalog = prof_resolver.get_resolved_profile_catalog(\n                trestle_root, parent_prof_path, show_value_warnings=True\n            )\n            catalog_api = CatalogAPI(catalog=catalog)\n\n            # Sort controls based on what controls in the SSP have exported provided information with no\n            # customer responsibility\n            ProfileInherit.update_profile_import(profile_import, leveraged_ssp, catalog_api)\n\n            result_profile.imports[0] = profile_import\n\n            if version:\n                result_profile.metadata.version = version\n\n            if ModelUtils.models_are_equivalent(existing_profile, result_profile):\n                logger.info('Profile is no different from existing version, so no update.')\n                return CmdReturnCodes.SUCCESS.value\n\n            ModelUtils.update_last_modified(result_profile)\n            ModelUtils.save_top_level_model(result_profile, trestle_root, output_prof_name, FileContentType.JSON)\n\n        except TrestleError as e:\n            raise TrestleError(f'Error initializing profile {output_prof_name}: {e}')\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileInherit-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileInherit.name","title":"<code>name = 'profile-inherit'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileInherit-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileInherit.initialize_profile","title":"<code>initialize_profile(trestle_root, parent_prof_name, output_prof_name, leveraged_ssp_name, version)</code>","text":"<p>Initialize profile with controls from a parent profile, filtering by inherited controls.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>Root directory of the trestle workspace</p> required <code>parent_prof_name</code> <code>str</code> <p>Name of the parent profile in the trestle workspace</p> required <code>output_prof_name</code> <code>str</code> <p>Name of the output profile json file</p> required <code>leveraged_ssp_name</code> <code>str</code> <p>Name of the ssp in the trestle workspace for control filtering</p> required <code>version</code> <code>Optional[str]</code> <p>Optional profile version</p> required <p>Returns:</p> Type Description <code>int</code> <p>0 on success, 1 on error</p> Notes <p>The profile model will either be updated or a new json profile created. This will overwrite any import information on an exiting profile, but will preserve control modifications and parameters. Allowing profile updates ensure that SSP export updates can be incorporated into an existing profile. All controls from the original profile will exists and will be grouped by included and excluded controls based on inheritance information.</p> Source code in <code>trestle/core/commands/author/prof.py</code> <pre><code>def initialize_profile(\n    self,\n    trestle_root: pathlib.Path,\n    parent_prof_name: str,\n    output_prof_name: str,\n    leveraged_ssp_name: str,\n    version: Optional[str],\n) -&gt; int:\n    \"\"\"Initialize profile with controls from a parent profile, filtering by inherited controls.\n\n    Args:\n        trestle_root: Root directory of the trestle workspace\n        parent_prof_name: Name of the parent profile in the trestle workspace\n        output_prof_name: Name of the output profile json file\n        leveraged_ssp_name: Name of the ssp in the trestle workspace for control filtering\n        version: Optional profile version\n\n    Returns:\n        0 on success, 1 on error\n\n    Notes:\n        The profile model will either be updated or a new json profile created. This will overwrite\n        any import information on an exiting profile, but will preserve control modifications and parameters.\n        Allowing profile updates ensure that SSP export updates can be incorporated into an existing profile. All\n        controls from the original profile will exists and will be grouped by included and excluded controls based\n        on inheritance information.\n    \"\"\"\n    try:\n        result_profile: prof.Profile\n        existing_profile: Optional[prof.Profile] = None\n\n        existing_profile_path = ModelUtils.get_model_path_for_name_and_class(\n            trestle_root, output_prof_name, prof.Profile\n        )\n\n        # If a profile exists at the output path, use that as a starting point for a new profile.\n        # else create a new sample profile.\n        if existing_profile_path is not None:\n            existing_profile, _ = load_validate_model_name(trestle_root,\n                                                           output_prof_name,\n                                                           prof.Profile,\n                                                           FileContentType.JSON)\n            result_profile = copy.deepcopy(existing_profile)\n        else:\n            result_profile = gens.generate_sample_model(prof.Profile)\n\n        parent_prof_path = ModelUtils.get_model_path_for_name_and_class(\n            trestle_root, parent_prof_name, prof.Profile\n        )\n        if parent_prof_path is None:\n            raise TrestleNotFoundError(\n                f'Profile {parent_prof_name} does not exist.  An existing profile must be provided.'\n            )\n\n        local_path = f'profiles/{parent_prof_name}/profile.json'\n        profile_import: prof.Import = gens.generate_sample_model(prof.Import)\n        profile_import.href = const.TRESTLE_HREF_HEADING + local_path\n\n        leveraged_ssp: ssp.SystemSecurityPlan\n        try:\n            leveraged_ssp, _ = load_validate_model_name(\n                trestle_root,\n                leveraged_ssp_name,\n                ssp.SystemSecurityPlan,\n                FileContentType.JSON\n            )\n        except TrestleNotFoundError as e:\n            raise TrestleError(f'SSP {leveraged_ssp_name} not found: {e}')\n\n        prof_resolver = ProfileResolver()\n        catalog = prof_resolver.get_resolved_profile_catalog(\n            trestle_root, parent_prof_path, show_value_warnings=True\n        )\n        catalog_api = CatalogAPI(catalog=catalog)\n\n        # Sort controls based on what controls in the SSP have exported provided information with no\n        # customer responsibility\n        ProfileInherit.update_profile_import(profile_import, leveraged_ssp, catalog_api)\n\n        result_profile.imports[0] = profile_import\n\n        if version:\n            result_profile.metadata.version = version\n\n        if ModelUtils.models_are_equivalent(existing_profile, result_profile):\n            logger.info('Profile is no different from existing version, so no update.')\n            return CmdReturnCodes.SUCCESS.value\n\n        ModelUtils.update_last_modified(result_profile)\n        ModelUtils.save_top_level_model(result_profile, trestle_root, output_prof_name, FileContentType.JSON)\n\n    except TrestleError as e:\n        raise TrestleError(f'Error initializing profile {output_prof_name}: {e}')\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileInherit.update_profile_import","title":"<code>update_profile_import(orig_prof_import, leveraged_ssp, catalog_api)</code>  <code>staticmethod</code>","text":"<p>Add controls to different sections of a profile import based on catalog and leveraged SSP.</p> <p>Parameters:</p> Name Type Description Default <code>orig_prof_import</code> <code>Import</code> <p>The original profile import that will have the control selection updated.</p> required <code>leveraged_ssp</code> <code>SystemSecurityPlan</code> <p>SSP input for control filtering</p> required <code>catalog_api</code> <code>CatalogAPI</code> <p>Catalog API with access to controls that need to be filtered</p> required <p>Returns:</p> Type Description <code>None</code> <p>None</p> Source code in <code>trestle/core/commands/author/prof.py</code> <pre><code>@staticmethod\ndef update_profile_import(\n    orig_prof_import: prof.Import, leveraged_ssp: ssp.SystemSecurityPlan, catalog_api: CatalogAPI\n) -&gt; None:\n    \"\"\"Add controls to different sections of a profile import based on catalog and leveraged SSP.\n\n    Args:\n        orig_prof_import: The original profile import that will have the control selection updated.\n        leveraged_ssp: SSP input for control filtering\n        catalog_api: Catalog API with access to controls that need to be filtered\n\n    Returns:\n        None\n    \"\"\"\n    exclude_with_ids: Set[str] = set()\n\n    # Create dictionary containing all by-components by control for faster searching\n    components_by_id: Dict[str, List[ssp.ByComponent]] = ProfileInherit._create_components_by_id(leveraged_ssp)\n\n    # Looping by controls in the catalog because the ids in the profile should\n    # be a subset of the catalog and not the ssp controls.\n    catalog_control_ids: Set[str] = set(catalog_api._catalog_interface.get_control_ids())\n    for control_id in catalog_control_ids:\n\n        if control_id not in components_by_id:\n            continue\n\n        by_comps: Optional[List[ssp.ByComponent]] = components_by_id[control_id]\n        if by_comps is not None and ProfileInherit._is_inherited(by_comps):\n            exclude_with_ids.add(control_id)\n\n    include_with_ids: Set[str] = catalog_control_ids - exclude_with_ids\n\n    orig_prof_import.include_controls = [prof.SelectControl(with_ids=sorted(include_with_ids))]\n    orig_prof_import.exclude_controls = [prof.SelectControl(with_ids=sorted(exclude_with_ids))]\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileResolve","title":"<code>ProfileResolve</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Resolve profile to resolved profile catalog.</p> Source code in <code>trestle/core/commands/author/prof.py</code> <pre><code>class ProfileResolve(AuthorCommonCommand):\n    \"\"\"Resolve profile to resolved profile catalog.\"\"\"\n\n    name = 'profile-resolve'\n\n    def _init_arguments(self) -&gt; None:\n        name_help_str = 'Name of the source profile model in the trestle workspace'\n        self.add_argument('-n', '--name', help=name_help_str, required=True, type=str)\n        self.add_argument('-o', '--output', help='Name of the output resolved profile catalog', required=True, type=str)\n        self.add_argument(\n            '-sv',\n            '--show-values',\n            help='Show values for parameters in prose',\n            required=False,\n            action='store_true',\n            default=False\n        )\n        self.add_argument(\n            '-sl',\n            '--show-labels',\n            help='Show labels for parameters in prose instead of values',\n            required=False,\n            action='store_true',\n            default=False\n        )\n        self.add_argument(\n            '-bf',\n            '--bracket-format',\n            help='With -sv, allows brackets around value, e.g. [.] or ((.)), with the dot representing the value.',\n            required=False,\n            type=str,\n            default=''\n        )\n        self.add_argument(\n            '-vap',\n            '--value-assigned-prefix',\n            help='With -sv, places a prefix in front of the parameter string if a value has been assigned.',\n            required=False,\n            type=str,\n            default=''\n        )\n        self.add_argument(\n            '-vnap',\n            '--value-not-assigned-prefix',\n            help='With -sv, places a prefix in front of the parameter string if a value has *not* been assigned.',\n            required=False,\n            type=str,\n            default=''\n        )\n        self.add_argument(\n            '-lp',\n            '--label-prefix',\n            help='With -sl, places a prefix in front of the parameter label.',\n            required=False,\n            type=str,\n            default=''\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root: pathlib.Path = args.trestle_root\n            profile_path = trestle_root / f'profiles/{args.name}/profile.json'\n            catalog_name = args.output\n            show_values = args.show_values\n            param_format = args.bracket_format\n            value_assigned_prefix = args.value_assigned_prefix\n            value_not_assigned_prefix = args.value_not_assigned_prefix\n            label_prefix = args.label_prefix\n            show_labels = args.show_labels\n\n            return self.resolve_profile(\n                trestle_root,\n                profile_path,\n                catalog_name,\n                show_values,\n                param_format,\n                value_assigned_prefix,\n                value_not_assigned_prefix,\n                show_labels,\n                label_prefix\n            )\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Generation of the resolved profile catalog failed')\n\n    def resolve_profile(\n        self,\n        trestle_root: pathlib.Path,\n        profile_path: pathlib.Path,\n        catalog_name: str,\n        show_values: bool,\n        bracket_format: str,\n        value_assigned_prefix: Optional[str],\n        value_not_assigned_prefix: Optional[str],\n        show_labels: bool,\n        label_prefix: Optional[str]\n    ) -&gt; int:\n        \"\"\"Create resolved profile catalog from given profile.\n\n        Args:\n            trestle_root: Root directory of the trestle workspace\n            profile_path: Path of the profile json file\n            catalog_name: Name of the resolved profile catalog\n            show_values: If true, show values of parameters in prose rather than original {{}} form\n            bracket_format: String representing brackets around value, e.g. [.] or ((.))\n            value_assigned_prefix: Prefix placed in front of param string if a value was assigned\n            value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned\n            show_labels: Show labels for parameters and not values\n            label_prefix: Prefix placed in front of param label\n\n        Returns:\n            0 on success and raises exception on error\n        \"\"\"\n        if not profile_path.exists():\n            raise TrestleNotFoundError(f'Cannot resolve profile catalog: profile {profile_path} does not exist.')\n\n        param_rep = ParameterRep.LEAVE_MOUSTACHE\n        if show_values:\n            param_rep = ParameterRep.ASSIGNMENT_FORM\n            if label_prefix or show_labels:\n                raise TrestleError('Use of show-values is not compatible with show-labels or label-prefix')\n        elif value_assigned_prefix or value_not_assigned_prefix:\n            raise TrestleError('Use of value-assigned-prefix or value-not-assigned-prefix requires show-values')\n        if show_labels:\n            param_rep = ParameterRep.LABEL_FORM\n            # overload value_not_assigned_prefix to use the label_prefix value\n            value_not_assigned_prefix = label_prefix\n        elif label_prefix:\n            raise TrestleError('Use of label-prefix requires show-labels')\n\n        bracket_format = none_if_empty(bracket_format)\n        catalog = ProfileResolver().get_resolved_profile_catalog(\n            trestle_root,\n            profile_path,\n            False,\n            False,\n            bracket_format,\n            param_rep,\n            False,\n            value_assigned_prefix,\n            value_not_assigned_prefix\n        )\n        ModelUtils.save_top_level_model(catalog, trestle_root, catalog_name, FileContentType.JSON)\n\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileResolve-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileResolve.name","title":"<code>name = 'profile-resolve'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileResolve-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof.ProfileResolve.resolve_profile","title":"<code>resolve_profile(trestle_root, profile_path, catalog_name, show_values, bracket_format, value_assigned_prefix, value_not_assigned_prefix, show_labels, label_prefix)</code>","text":"<p>Create resolved profile catalog from given profile.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>Root directory of the trestle workspace</p> required <code>profile_path</code> <code>Path</code> <p>Path of the profile json file</p> required <code>catalog_name</code> <code>str</code> <p>Name of the resolved profile catalog</p> required <code>show_values</code> <code>bool</code> <p>If true, show values of parameters in prose rather than original {{}} form</p> required <code>bracket_format</code> <code>str</code> <p>String representing brackets around value, e.g. [.] or ((.))</p> required <code>value_assigned_prefix</code> <code>Optional[str]</code> <p>Prefix placed in front of param string if a value was assigned</p> required <code>value_not_assigned_prefix</code> <code>Optional[str]</code> <p>Prefix placed in front of param string if a value was not assigned</p> required <code>show_labels</code> <code>bool</code> <p>Show labels for parameters and not values</p> required <code>label_prefix</code> <code>Optional[str]</code> <p>Prefix placed in front of param label</p> required <p>Returns:</p> Type Description <code>int</code> <p>0 on success and raises exception on error</p> Source code in <code>trestle/core/commands/author/prof.py</code> <pre><code>def resolve_profile(\n    self,\n    trestle_root: pathlib.Path,\n    profile_path: pathlib.Path,\n    catalog_name: str,\n    show_values: bool,\n    bracket_format: str,\n    value_assigned_prefix: Optional[str],\n    value_not_assigned_prefix: Optional[str],\n    show_labels: bool,\n    label_prefix: Optional[str]\n) -&gt; int:\n    \"\"\"Create resolved profile catalog from given profile.\n\n    Args:\n        trestle_root: Root directory of the trestle workspace\n        profile_path: Path of the profile json file\n        catalog_name: Name of the resolved profile catalog\n        show_values: If true, show values of parameters in prose rather than original {{}} form\n        bracket_format: String representing brackets around value, e.g. [.] or ((.))\n        value_assigned_prefix: Prefix placed in front of param string if a value was assigned\n        value_not_assigned_prefix: Prefix placed in front of param string if a value was *not* assigned\n        show_labels: Show labels for parameters and not values\n        label_prefix: Prefix placed in front of param label\n\n    Returns:\n        0 on success and raises exception on error\n    \"\"\"\n    if not profile_path.exists():\n        raise TrestleNotFoundError(f'Cannot resolve profile catalog: profile {profile_path} does not exist.')\n\n    param_rep = ParameterRep.LEAVE_MOUSTACHE\n    if show_values:\n        param_rep = ParameterRep.ASSIGNMENT_FORM\n        if label_prefix or show_labels:\n            raise TrestleError('Use of show-values is not compatible with show-labels or label-prefix')\n    elif value_assigned_prefix or value_not_assigned_prefix:\n        raise TrestleError('Use of value-assigned-prefix or value-not-assigned-prefix requires show-values')\n    if show_labels:\n        param_rep = ParameterRep.LABEL_FORM\n        # overload value_not_assigned_prefix to use the label_prefix value\n        value_not_assigned_prefix = label_prefix\n    elif label_prefix:\n        raise TrestleError('Use of label-prefix requires show-labels')\n\n    bracket_format = none_if_empty(bracket_format)\n    catalog = ProfileResolver().get_resolved_profile_catalog(\n        trestle_root,\n        profile_path,\n        False,\n        False,\n        bracket_format,\n        param_rep,\n        False,\n        value_assigned_prefix,\n        value_not_assigned_prefix\n    )\n    ModelUtils.save_top_level_model(catalog, trestle_root, catalog_name, FileContentType.JSON)\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/prof/#trestle.core.commands.author.prof-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/","title":"trestle.core.commands.author.ssp","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp","title":"<code>trestle.core.commands.author.ssp</code>","text":"<p>Create ssp from catalog and profile.</p>"},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPAssemble","title":"<code>SSPAssemble</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Assemble markdown files of controls into an SSP json file.</p> Source code in <code>trestle/core/commands/author/ssp.py</code> <pre><code>class SSPAssemble(AuthorCommonCommand):\n    \"\"\"Assemble markdown files of controls into an SSP json file.\"\"\"\n\n    name = 'ssp-assemble'\n\n    def _init_arguments(self) -&gt; None:\n        name_help_str = (\n            'Optional name of the ssp model in the trestle workspace that is being modified.  '\n            'If not provided the output name is used.'\n        )\n        self.add_argument('-n', '--name', help=name_help_str, required=False, type=str)\n        file_help_str = 'Name of the input markdown file directory'\n        self.add_argument('-m', '--markdown', help=file_help_str, required=True, type=str)\n        output_help_str = 'Name of the output generated json SSP'\n        self.add_argument('-cd', '--compdefs', help=const.HELP_COMPDEFS, required=False, type=str)\n        self.add_argument('-o', '--output', help=output_help_str, required=True, type=str)\n        self.add_argument('-r', '--regenerate', action='store_true', help=const.HELP_REGENERATE)\n        self.add_argument('-vn', '--version', help=const.HELP_VERSION, required=False, type=str)\n\n    @staticmethod\n    def _get_ssp_component(ssp: ossp.SystemSecurityPlan, gen_comp: generic.GenericComponent) -&gt; ossp.SystemComponent:\n        for component in as_list(ssp.system_implementation.components):\n            if component.title == gen_comp.title:\n                return component\n        # if this is a new system component assign its status as operational by default\n        # the status of the system components are not stored in the markdown\n        gen_comp.status.state = const.STATUS_OPERATIONAL\n        new_component = gen_comp.as_system_component()\n        return new_component\n\n    @staticmethod\n    def _merge_by_comps(stat: ossp.Statement, statement: ossp.Statement, set_params: List[ossp.SetParameter]) -&gt; None:\n        for by_comp in as_list(statement.by_components):\n            found = False\n            for dest_by_comp in as_list(stat.by_components):\n                if dest_by_comp.component_uuid == by_comp.component_uuid:\n                    dest_by_comp.description = by_comp.description\n                    dest_by_comp.props = as_list(dest_by_comp.props)\n                    dest_by_comp.props.extend(as_list(statement.props))\n                    dest_by_comp.props = none_if_empty(ControlInterface.clean_props(by_comp.props))\n                    dest_by_comp.implementation_status = by_comp.implementation_status\n                    dest_by_comp.set_parameters = none_if_empty(set_params)\n                    found = True\n                    break\n            if not found:\n                stat.by_components = as_list(stat.by_components)\n                by_comp.set_parameters = none_if_empty(set_params)\n                stat.by_components.append(by_comp)\n\n    @staticmethod\n    def _merge_statement(\n        imp_req: ossp.ImplementedRequirement,\n        statement: generic.GenericStatement,\n        set_params: List[ossp.SetParameter],\n    ) -&gt; None:\n        \"\"\"Merge the generic statement into the statements of the imp_req.\"\"\"\n        # if the statement id is already in the imp_req, merge its by_comps into the existing statement\n        for stat in as_list(imp_req.statements):\n            if stat.statement_id == statement.statement_id:\n                SSPAssemble._merge_by_comps(stat, statement, set_params)\n                return\n        # otherwise just ad the statement - but only if it has by_comps\n        if statement.by_components:\n            imp_req.statements = as_list(imp_req.statements)\n            imp_req.statements.append(statement)\n\n    @staticmethod\n    def _merge_imp_req_into_imp_req(\n        imp_req: ossp.ImplementedRequirement,\n        gen_imp_req: generic.GenericImplementedRequirement,\n        set_params: List[ossp.SetParameter]\n    ) -&gt; None:\n        \"\"\"Merge comp def imp req into existing imp req.\"\"\"\n        # convert generic imp req from comp defs into ssp form\n        src_imp_req = gen_imp_req.as_ssp()\n        imp_req.props = none_if_empty(\n            ControlInterface.clean_props(gen_imp_req.props, remove_imp_status=True, remove_all_rule_info=True)\n        )\n        for statement in as_list(src_imp_req.statements):\n            SSPAssemble._merge_statement(imp_req, statement, set_params)\n\n    @staticmethod\n    def _get_params_for_rules(context: ControlContext, rules_list: List[str],\n                              set_params: List[ossp.SetParameter]) -&gt; List[ossp.SetParameter]:\n        \"\"\"Get all set_params needed by the rules along with non-rule set_params.\"\"\"\n        needed_param_ids: Set[str] = set()\n        rule_dict = context.rules_params_dict.get(context.comp_name, {})\n        # find param_ids needed by rules\n        for rule_id in rules_list:\n            # get list of param_ids associated with this rule_id\n            param_ids = [\n                param['name'] for params in rule_dict.values() for param in params if param['rule-id'] == rule_id\n            ]\n            needed_param_ids.update(param_ids)\n        all_rule_param_ids = [param['name'] for params in rule_dict.values() for param in params]\n        # any set_param that isn't associated with a rule should be included as a normal control set param with no rule\n        for set_param in set_params:\n            if set_param.param_id not in all_rule_param_ids:\n                needed_param_ids.add(set_param.param_id)\n        param_ids_list = sorted(needed_param_ids)\n        needed_set_params: List[ossp.SetParameter] = []\n        for param_id in param_ids_list:\n            set_param = None\n            for sp in set_params:\n                if sp.param_id == param_id:\n                    set_param = sp\n                    break\n            if set_param:\n                needed_set_params.append(set_param)\n            else:\n                logger.warning(f'No set param found for param {param_id}')\n        return needed_set_params\n\n    @staticmethod\n    def _add_imp_req_to_ssp(\n        ssp: ossp.SystemSecurityPlan,\n        gen_comp: generic.GenericComponent,\n        gen_imp_req: generic.GenericImplementedRequirement,\n        set_params: List[ossp.SetParameter],\n        context: ControlContext\n    ) -&gt; None:\n        \"\"\"Add imp req from control implementation into new ssp being assembled.\"\"\"\n        # the incoming gen_imp_req comes directly from the comp def\n        # but the imp_req here is pulled from the ssp and created if not already there\n        imp_req = CatalogReader._get_imp_req_for_control(ssp, gen_imp_req.control_id)\n        local_set_params = as_list(set_params)[:]\n        local_set_params.extend(as_list(imp_req.set_parameters))\n        local_set_params = ControlInterface.uniquify_set_params(local_set_params)\n        # get any rules set at control level, if present\n        rules_list, _ = ControlInterface.get_rule_list_for_item(gen_imp_req)  # type: ignore\n        # There should be no rule content at top level of imp_req in ssp so strip them out\n        imp_req.props = none_if_empty(\n            ControlInterface.clean_props(gen_imp_req.props, remove_imp_status=True, remove_all_rule_info=True)\n        )\n        # if we have rules applying or need to make set_params, we need to make a by_comp\n        control_set_params = SSPAssemble._get_params_for_rules(context, rules_list, local_set_params)\n        if rules_list or control_set_params:\n            by_comp = gens.generate_sample_model(ossp.ByComponent)\n            by_comp.component_uuid = gen_comp.uuid\n            by_comp.description = gen_imp_req.description\n            by_comp.set_parameters = none_if_empty(control_set_params)\n            by_comp.implementation_status = ControlInterface.get_status_from_props(gen_imp_req)  # type: ignore\n            by_comp.props = none_if_empty(ControlInterface.clean_props(gen_imp_req.props))\n            imp_req.by_components = as_list(imp_req.by_components)\n            imp_req.by_components.append(by_comp)\n        # each statement in ci corresponds to by_comp in an ssp imp req\n        # so insert the new by_comp directly into the ssp, generating parts as needed\n        imp_req.statements = as_list(imp_req.statements)\n        for statement in as_list(gen_imp_req.statements):\n            if ControlInterface.item_has_rules(statement):  # type: ignore\n                imp_req = CatalogReader._get_imp_req_for_statement(ssp, gen_imp_req.control_id, statement.statement_id)\n                by_comp = CatalogReader._get_by_comp_from_imp_req(imp_req, statement.statement_id, gen_comp.uuid)\n                by_comp.description = statement.description\n                by_comp.props = none_if_empty(ControlInterface.clean_props(statement.props))\n                rules_list, _ = ControlInterface.get_rule_list_for_item(statement)  # type: ignore\n                by_comp.set_parameters = none_if_empty(\n                    SSPAssemble._get_params_for_rules(context, rules_list, local_set_params)\n                )\n        imp_req.statements = none_if_empty(imp_req.statements)\n        ssp.control_implementation.implemented_requirements = as_list(\n            ssp.control_implementation.implemented_requirements\n        )\n\n    @staticmethod\n    def _merge_imp_req_into_ssp(\n        ssp: ossp.SystemSecurityPlan,\n        gen_imp_req: generic.GenericImplementedRequirement,\n        set_params: List[ossp.SetParameter],\n    ) -&gt; None:\n        \"\"\"Merge the new imp_reqs into the ssp.\"\"\"\n        for imp_req in as_list(ssp.control_implementation.implemented_requirements):\n            if imp_req.control_id == gen_imp_req.control_id:\n                SSPAssemble._merge_imp_req_into_imp_req(imp_req, gen_imp_req, set_params)\n                return\n        new_imp_req = gen_imp_req.as_ssp()\n        imp_req.props = none_if_empty(\n            ControlInterface.clean_props(gen_imp_req.props, remove_imp_status=True, remove_all_rule_info=True)\n        )\n        ssp.control_implementation.implemented_requirements.append(new_imp_req)\n\n    def _merge_comp_defs(\n        self,\n        ssp: ossp.SystemSecurityPlan,\n        comp_dict: Dict[str, generic.GenericComponent],\n        context: ControlContext,\n        catalog_interface: CatalogInterface\n    ) -&gt; None:\n        \"\"\"Merge the original generic comp defs into the ssp.\"\"\"\n        all_comps: List[ossp.SystemComponent] = []\n        # determine if this is a new and empty ssp\n        new_ssp = not ssp.control_implementation.implemented_requirements\n        for _, gen_comp in comp_dict.items():\n            context.comp_name = gen_comp.title\n            all_ci_props: List[com.Property] = []\n            ssp_comp = SSPAssemble._get_ssp_component(ssp, gen_comp)\n            set_params: List[ossp.SetParameter] = []\n            for ci in as_list(gen_comp.control_implementations):\n                all_ci_props.extend(as_list(ci.props))\n                # get the list of set_params in the control implementation - for this component\n                for sp in as_list(ci.set_parameters):\n                    set_params.append(sp.to_ssp())\n                for imp_req in as_list(ci.implemented_requirements):\n                    # ignore any controls not in the ssp profile (resolved catalog)\n                    if not catalog_interface.get_control(imp_req.control_id):\n                        logger.debug(f'Ignoring imp_req for control {imp_req.control_id} not in ssp profile')\n                        continue\n                    if new_ssp:\n                        SSPAssemble._add_imp_req_to_ssp(ssp, gen_comp, imp_req, set_params, context)\n                    else:\n                        # compile all new uuids for new component definitions\n                        comp_uuids = [x.uuid for x in comp_dict.values()]\n                        for imp_requirement in as_list(ssp.control_implementation.implemented_requirements):\n                            to_delete = []\n                            for i, by_comp in enumerate(imp_requirement.by_components):\n                                if by_comp.component_uuid not in comp_uuids:\n                                    logger.warning(\n                                        f'By_component {by_comp.component_uuid} removed from implemented requirement '\n                                        f'{imp_requirement.control_id} because the corresponding component is not in '\n                                        'the specified compdefs '\n                                    )\n                                    to_delete.append(i)\n                            if to_delete:\n                                delete_list_from_list(imp_requirement.by_components, to_delete)\n                        SSPAssemble._merge_imp_req_into_ssp(ssp, imp_req, set_params)\n            ssp_comp.props = as_list(gen_comp.props)\n            ssp_comp.props.extend(all_ci_props)\n            ssp_comp.props = none_if_empty(ControlInterface.clean_props(ssp_comp.props))\n            all_comps.append(ssp_comp)\n\n        ssp.system_implementation.components = none_if_empty(all_comps)\n\n    def _generate_roles_in_metadata(self, ssp: ossp.SystemSecurityPlan) -&gt; bool:\n        \"\"\"Find all roles referenced by imp reqs and create role in metadata as needed.\"\"\"\n        metadata = ssp.metadata\n        metadata.roles = as_list(metadata.roles)\n        known_role_ids = [role.id for role in metadata.roles]\n        changed = False\n        for imp_req in ssp.control_implementation.implemented_requirements:\n            role_ids = [resp_role.role_id for resp_role in as_list(imp_req.responsible_roles)]\n            for role_id in role_ids:\n                if role_id not in known_role_ids:\n                    role = com.Role(id=role_id, title=role_id)\n                    metadata.roles.append(role)\n                    known_role_ids.append(role_id)\n                    changed = True\n        metadata.roles = none_if_empty(metadata.roles)\n        return changed\n\n    @staticmethod\n    def _build_comp_dict_from_comp_defs(\n        trestle_root: pathlib.Path, comp_def_name_list: List[str], create_sys_comp: bool\n    ) -&gt; Dict[str, generic.GenericComponent]:\n        comp_dict: Dict[str, generic.GenericComponent] = {}\n        for comp_name in comp_def_name_list:\n            comp_def, _ = ModelUtils.load_model_for_class(trestle_root, comp_name, comp.ComponentDefinition)\n            for def_comp in as_list(comp_def.components):\n                gen_def_comp = generic.GenericComponent.from_defined_component(def_comp)\n                comp_dict[def_comp.title] = gen_def_comp\n        if create_sys_comp:\n            sys_comp = generic.GenericComponent.generate()\n            sys_comp.type = const.THIS_SYSTEM_AS_KEY\n            sys_comp.title = const.SSP_MAIN_COMP_NAME\n            comp_dict[sys_comp.title] = sys_comp\n        return comp_dict\n\n    @staticmethod\n    def _get_this_system_as_gen_comp(ssp: ossp.SystemSecurityPlan) -&gt; Optional[generic.GenericComponent]:\n        for component in as_list(ssp.system_implementation.components):\n            if component.title == const.SSP_MAIN_COMP_NAME:\n                return generic.GenericComponent.from_defined_component(component)\n        return None\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root = pathlib.Path(args.trestle_root)\n\n            md_path = trestle_root / args.markdown\n\n            # the original, reference ssp name defaults to same as output if name not specified\n            # thus in cyclic editing you are reading and writing same json ssp\n            orig_ssp_name = args.output\n            if args.name:\n                orig_ssp_name = args.name\n            new_ssp_name = args.output\n\n            _, profile_href = ComponentAssemble._get_profile_title_and_href_from_dir(md_path)\n            res_cat = ProfileResolver.get_resolved_profile_catalog(\n                trestle_root, profile_href, param_rep=ParameterRep.LEAVE_MOUSTACHE\n            )\n            catalog_interface = CatalogInterface(res_cat)\n\n            new_file_content_type = FileContentType.JSON\n\n            # if output ssp already exists, load it to see if new one is different\n            existing_ssp: Optional[ossp.SystemSecurityPlan] = None\n            new_ssp_path = ModelUtils.get_model_path_for_name_and_class(\n                trestle_root, new_ssp_name, ossp.SystemSecurityPlan\n            )\n            if new_ssp_path:\n                _, _, existing_ssp = ModelUtils.load_distributed(new_ssp_path, trestle_root)\n                new_file_content_type = FileContentType.path_to_content_type(new_ssp_path)\n\n            ssp: ossp.SystemSecurityPlan\n\n            # if orig ssp exists - need to load it rather than instantiate new one\n            orig_ssp_path = ModelUtils.get_model_path_for_name_and_class(\n                trestle_root, orig_ssp_name, ossp.SystemSecurityPlan\n            )\n\n            context = ControlContext.generate(ContextPurpose.SSP, True, trestle_root, md_path)\n            context.comp_def_name_list = comma_sep_to_list(args.compdefs)\n            part_id_map_by_id = catalog_interface.get_statement_part_id_map(False)\n            catalog_interface.generate_control_rule_info(part_id_map_by_id, context)\n\n            # load all original comp defs\n            # only additions from markdown will be imp_req prose and status\n            # and param vals\n            # if this is a new ssp then create system component in the comp_dict\n            comp_dict = SSPAssemble._build_comp_dict_from_comp_defs(\n                trestle_root, context.comp_def_name_list, not orig_ssp_path\n            )\n\n            part_id_map_by_label = catalog_interface.get_statement_part_id_map(True)\n\n            # if ssp already exists use it as container for new content\n            if orig_ssp_path:\n                # load the existing json ssp\n                _, _, ssp = ModelUtils.load_distributed(orig_ssp_path, trestle_root)\n                # add the This System comp to the comp dict so its uuid is known\n                sys_comp = SSPAssemble._get_this_system_as_gen_comp(ssp)\n                if not sys_comp:\n                    raise TrestleError('Original ssp has no system component.')\n                comp_dict[const.SSP_MAIN_COMP_NAME] = sys_comp\n\n                ssp_sys_imp_comps = ssp.system_implementation.components\n                # Gather the leveraged components to add back after the merge\n                leveraged_comps: Dict[str, ossp.SystemComponent] = {}\n                for sys_comp in ssp_sys_imp_comps:\n                    if sys_comp.props is not None:\n                        prop_names = [x.name for x in sys_comp.props]\n                        if const.LEV_AUTH_UUID in prop_names:\n                            leveraged_comps[sys_comp.title] = sys_comp\n\n                # Verifies older compdefs in an ssp no longer exist in newly provided ones\n                comp_titles = [x.title for x in comp_dict.values()]\n                diffs = [x for x in ssp_sys_imp_comps if x.title not in comp_titles and x.title not in leveraged_comps]\n                if diffs:\n                    for diff in diffs:\n                        logger.warning(\n                            f'Component named: {diff.title} was removed from system components from ssp '\n                            'because the corresponding component is not in '\n                            'the specified compdefs '\n                        )\n                    index_list = [ssp_sys_imp_comps.index(value) for value in diffs if value in ssp_sys_imp_comps]\n                    delete_list_from_list(ssp.system_implementation.components, index_list)\n\n                self._merge_comp_defs(ssp, comp_dict, context, catalog_interface)\n                CatalogReader.read_ssp_md_content(md_path, ssp, comp_dict, part_id_map_by_label, context)\n\n                new_file_content_type = FileContentType.path_to_content_type(orig_ssp_path)\n\n                # Add the leveraged comps back to the final ssp\n                ssp.system_implementation.components.extend(list(leveraged_comps.values()))\n            else:\n                # create a sample ssp to hold all the parts\n                ssp = gens.generate_sample_model(ossp.SystemSecurityPlan)\n                ssp.control_implementation.implemented_requirements = []\n                ssp.control_implementation.description = const.SSP_SYSTEM_CONTROL_IMPLEMENTATION_TEXT\n                ssp.system_implementation.components = []\n                self._merge_comp_defs(ssp, comp_dict, context, catalog_interface)\n                CatalogReader.read_ssp_md_content(md_path, ssp, comp_dict, part_id_map_by_label, context)\n\n                import_profile: ossp.ImportProfile = gens.generate_sample_model(ossp.ImportProfile)\n                import_profile.href = const.REPLACE_ME\n                ssp.import_profile = import_profile\n\n            # now that we know the complete list of needed components, add them to the sys_imp\n            # TODO if the ssp already existed then components may need to be removed if not ref'd by imp_reqs\n            self._generate_roles_in_metadata(ssp)\n\n            # If this is a leveraging SSP, update it with the retrieved exports from the leveraged SSP\n            inheritance_markdown_path = md_path.joinpath(const.INHERITANCE_VIEW_DIR)\n            if os.path.exists(inheritance_markdown_path):\n                SSPInheritanceAPI(inheritance_markdown_path, trestle_root).update_ssp_inheritance(ssp)\n\n            ssp.import_profile.href = profile_href\n\n            if args.version:\n                ssp.metadata.version = args.version\n\n            if ModelUtils.models_are_equivalent(existing_ssp, ssp):\n                logger.info('No changes to assembled ssp so ssp not written out.')\n                return CmdReturnCodes.SUCCESS.value\n\n            if args.regenerate:\n                ssp, _, _ = ModelUtils.regenerate_uuids(ssp)\n            ModelUtils.update_last_modified(ssp)\n            # validate model rules before saving\n            args_validate = argparse.Namespace(mode=const.VAL_MODE_RULES)\n            validator: Validator = validator_factory.get(args_validate)\n            if not validator.model_is_valid(ssp, True, trestle_root):\n                logger.error(\n                    'Validation of file to be imported did not pass. Rule parameter values validation failed, '\n                    'please check values are correct for shared parameters in current model'\n                )\n                return CmdReturnCodes.COMMAND_ERROR.value\n            # write out the ssp as json\n            ModelUtils.save_top_level_model(ssp, trestle_root, new_ssp_name, new_file_content_type)\n\n            return CmdReturnCodes.SUCCESS.value\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while assembling SSP')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPAssemble-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPAssemble.name","title":"<code>name = 'ssp-assemble'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPFilter","title":"<code>SSPFilter</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Filter the controls in an ssp.</p> <p>The filtered ssp is based on controls included by the following: profile, components, implementation status, and/or control origination.</p> Source code in <code>trestle/core/commands/author/ssp.py</code> <pre><code>class SSPFilter(AuthorCommonCommand):\n    \"\"\"\n    Filter the controls in an ssp.\n\n    The filtered ssp is based on controls included by the following:\n    profile, components, implementation status, and/or control origination.\n    \"\"\"\n\n    name = 'ssp-filter'\n\n    def _init_arguments(self) -&gt; None:\n        file_help_str = 'Name of the input ssp'\n        self.add_argument('-n', '--name', help=file_help_str, required=True, type=str)\n        file_help_str = 'Name of the optional input profile that defines set of controls in filtered ssp'\n        self.add_argument('-p', '--profile', help=file_help_str, required=False, type=str)\n        output_help_str = 'Name of the output generated SSP'\n        self.add_argument('-o', '--output', help=output_help_str, required=True, type=str)\n        self.add_argument('-r', '--regenerate', action='store_true', help=const.HELP_REGENERATE)\n        self.add_argument('-vn', '--version', help=const.HELP_VERSION, required=False, type=str)\n        comp_help_str = 'Colon-delimited list of component names to include in filtered ssp.'\n        self.add_argument('-c', '--components', help=comp_help_str, required=False, type=str)\n        is_help_str = 'Comma-delimited list of control implementation statuses to include in filtered ssp.'\n        self.add_argument('-is', '--implementation-status', help=is_help_str, required=False, type=str)\n        co_help_str = 'Comma-delimited list of control origination values to include in filtered ssp.'\n        self.add_argument('-co', '--control-origination', help=co_help_str, required=False, type=str)\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root = pathlib.Path(args.trestle_root)\n            comp_names: Optional[List[str]] = None\n            impl_status_values: Optional[List[str]] = None\n            co_values: Optional[List[str]] = None\n\n            if not (args.components or args.implementation_status or args.profile or args.control_origination):\n                logger.warning(\n                    'You must specify at least one, or a combination of: profile, list of component names'\n                    ', list of implementation statuses, or list of control origination values for ssp-filter.'\n                )\n                return CmdReturnCodes.COMMAND_ERROR.value\n\n            if args.components:\n                comp_names = args.components.split(':')\n\n            if args.implementation_status:\n                impl_status_values = args.implementation_status.split(',')\n                allowed_is_values = {\n                    const.STATUS_PLANNED,\n                    const.STATUS_PARTIAL,\n                    const.STATUS_IMPLEMENTED,\n                    const.STATUS_ALTERNATIVE,\n                    const.STATUS_NOT_APPLICABLE\n                }\n                allowed_is_string = ', '.join(str(item) for item in allowed_is_values)\n                for impl_status in impl_status_values:\n                    if impl_status not in allowed_is_values:\n                        logger.warning(\n                            f'Provided implementation status \"{impl_status}\" is invalid.\\n'\n                            f'Please use the following for ssp-filter: {allowed_is_string}'\n                        )\n                        return CmdReturnCodes.COMMAND_ERROR.value\n\n            if args.control_origination:\n                co_values = args.control_origination.split(',')\n                allowed_co_values = {\n                    const.ORIGINATION_ORGANIZATION,\n                    const.ORIGINATION_SYSTEM_SPECIFIC,\n                    const.ORIGINATION_INHERITED,\n                    const.ORIGINATION_CUSTOMER_CONFIGURED,\n                    const.ORIGINATION_CUSTOMER_PROVIDED\n                }\n                allowed_co_string = ', '.join(str(item) for item in allowed_co_values)\n                for co in co_values:\n                    if co not in allowed_co_values:\n                        logger.warning(\n                            f'Provided control origination \"{co}\" is invalid.\\n'\n                            f'Please use the following for ssp-filter: {allowed_co_string}'\n                        )\n                        return CmdReturnCodes.COMMAND_ERROR.value\n\n            return self.filter_ssp(\n                trestle_root,\n                args.name,\n                args.profile,\n                args.output,\n                args.regenerate,\n                args.version,\n                comp_names,\n                impl_status_values,\n                co_values\n            )\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error generating the filtered ssp')\n\n    def filter_ssp(\n        self,\n        trestle_root: pathlib.Path,\n        ssp_name: str,\n        profile_name: str,\n        out_name: str,\n        regenerate: bool,\n        version: Optional[str],\n        components: Optional[List[str]] = None,\n        implementation_status: Optional[List[str]] = None,\n        control_origination: Optional[List[str]] = None\n    ) -&gt; int:\n        \"\"\"\n        Filter the ssp and output new ssp.\n\n        The filtered ssp is based on controls included by the following:\n        profile, components, implementation status, and/or control origination.\n\n        Args:\n            trestle_root: root directory of the trestle workspace\n            ssp_name: name of the ssp model\n            profile_name: name of the optional profile model used for filtering\n            out_name: name of the output ssp model with filtered controls\n            regenerate: whether to regenerate the uuid's in the ssp\n            version: new version for the model\n            components: optional list of component names used for filtering\n            implementation_status: optional list of implementation statuses for filtering\n            control_origination: optional list of control origination values for filtering\n\n        Returns:\n            0 on success, 1 otherwise\n        \"\"\"\n        # load the ssp\n        ssp: ossp.SystemSecurityPlan\n        ssp, _ = load_validate_model_name(trestle_root, ssp_name, ossp.SystemSecurityPlan, FileContentType.JSON)\n        profile_path = ModelUtils.get_model_path_for_name_and_class(\n            trestle_root, profile_name, prof.Profile, FileContentType.JSON\n        )\n\n        if components:\n            raw_comp_names = [ControlReader.simplify_name(name) for name in components]\n            comp_uuids: List[str] = []\n            for component in ssp.system_implementation.components:\n                if ControlReader.simplify_name(component.title) in raw_comp_names:\n                    comp_uuids.append(component.uuid)\n\n            if len(comp_uuids) != len(components):\n                raise TrestleError(\n                    f'Unable to filter the ssp because one of the components {components} is not in the ssp.'\n                )\n\n            # imp_reqs can be by comp\n            # and imp_reqs can have statements that are by comp\n            if comp_uuids:\n                new_imp_reqs: List[ossp.ImplementedRequirement] = []\n                # these are all required to be present\n                for imp_req in ssp.control_implementation.implemented_requirements:\n                    new_by_comps: List[ossp.ByComponent] = []\n                    # by_comps is optional\n                    for by_comp in as_list(imp_req.by_components):\n                        if by_comp.component_uuid in comp_uuids:\n                            new_by_comps.append(by_comp)\n                    imp_req.by_components = none_if_empty(new_by_comps)\n                    new_imp_reqs.append(imp_req)\n                    new_statements: List[ossp.Statement] = []\n                    for statement in as_list(imp_req.statements):\n                        new_by_comps: List[ossp.ByComponent] = []\n                        for by_comp in as_list(statement.by_components):\n                            if by_comp.component_uuid in comp_uuids:\n                                new_by_comps.append(by_comp)\n                        statement.by_components = none_if_empty(new_by_comps)\n                        new_statements.append(statement)\n                    imp_req.statements = none_if_empty(new_statements)\n                ssp.control_implementation.implemented_requirements = new_imp_reqs\n                # now remove any unused components from the ssp\n                new_comp_list: List[ossp.SystemComponent] = []\n                for comp_ in ssp.system_implementation.components:\n                    if comp_.uuid in comp_uuids:\n                        new_comp_list.append(comp_)\n                ssp.system_implementation.components = new_comp_list\n\n        # filter by controls in profile\n        if profile_name:\n            prof_resolver = ProfileResolver()\n            catalog = prof_resolver.get_resolved_profile_catalog(trestle_root, profile_path, show_value_warnings=True)\n            catalog_api = CatalogAPI(catalog=catalog)\n\n            # The input ssp should reference a superset of the controls referenced by the profile\n            # Need to cull references in the ssp to controls not in the profile\n            # Also make sure the output ssp contains imp reqs for all controls in the profile\n            control_imp = ssp.control_implementation\n            ssp_control_ids: Set[str] = set()\n\n            new_set_params: List[ossp.SetParameter] = []\n            for set_param in as_list(control_imp.set_parameters):\n                control = catalog_api._catalog_interface.get_control_by_param_id(set_param.param_id)\n                if control is not None:\n                    new_set_params.append(set_param)\n                    ssp_control_ids.add(control.id)\n            control_imp.set_parameters = none_if_empty(new_set_params)\n\n            new_imp_requirements: List[ossp.ImplementedRequirement] = []\n            for imp_requirement in as_list(control_imp.implemented_requirements):\n                control = catalog_api._catalog_interface.get_control(imp_requirement.control_id)\n                if control is not None:\n                    new_imp_requirements.append(imp_requirement)\n                    ssp_control_ids.add(control.id)\n            control_imp.implemented_requirements = new_imp_requirements\n\n            # make sure all controls in the profile have implemented reqs in the final ssp\n            if not ssp_control_ids.issuperset(catalog_api._catalog_interface.get_control_ids()):\n                raise TrestleError('Unable to filter the ssp because the profile references controls not in it.')\n\n            ssp.control_implementation = control_imp\n\n        # filter implemented requirements and statements by component implementation status\n        # this will remove any implemented requirements without statements or by_component fields set\n        if implementation_status:\n            new_imp_reqs: List[ossp.ImplementedRequirement] = []\n            # these are all required to be present\n            for imp_req in ssp.control_implementation.implemented_requirements:\n                new_by_comps: List[ossp.ByComponent] = []\n                # by_comps is optional\n                for by_comp in as_list(imp_req.by_components):\n                    if by_comp.implementation_status.state in implementation_status:\n                        new_by_comps.append(by_comp)\n                imp_req.by_components = none_if_empty(new_by_comps)\n\n                new_statements: List[ossp.Statement] = []\n                for statement in as_list(imp_req.statements):\n                    new_by_comps: List[ossp.ByComponent] = []\n                    for by_comp in as_list(statement.by_components):\n                        if by_comp.implementation_status.state in implementation_status:\n                            new_by_comps.append(by_comp)\n                    statement.by_components = none_if_empty(new_by_comps)\n                    if statement.by_components is not None:\n                        new_statements.append(statement)\n                imp_req.statements = none_if_empty(new_statements)\n\n                if imp_req.by_components is not None or imp_req.statements is not None:\n                    new_imp_reqs.append(imp_req)\n\n            ssp.control_implementation.implemented_requirements = new_imp_reqs\n\n        # filter implemented requirements by control origination property.\n        # this will remove any implemented requirements without the control origination\n        # property set\n        if control_origination:\n            new_imp_reqs: List[ossp.ImplementedRequirement] = []\n\n            for imp_requirement in ssp.control_implementation.implemented_requirements:\n                if imp_requirement.props:\n                    for prop in imp_requirement.props:\n                        if prop.name == const.CONTROL_ORIGINATION and prop.value in control_origination:\n                            new_imp_reqs.append(imp_requirement)\n                            # only add the imp requirement one time\n                            break\n\n            ssp.control_implementation.implemented_requirements = new_imp_reqs\n\n        if version:\n            ssp.metadata.version = version\n\n        existing_ssp_path = ModelUtils.get_model_path_for_name_and_class(\n            trestle_root, out_name, ossp.SystemSecurityPlan\n        )\n        if existing_ssp_path is not None:\n            existing_ssp, _ = load_validate_model_name(trestle_root, out_name, ossp.SystemSecurityPlan)\n            if ModelUtils.models_are_equivalent(existing_ssp, ssp):  # type: ignore\n                logger.info('No changes to filtered ssp so ssp not written out.')\n                return CmdReturnCodes.SUCCESS.value\n\n        if regenerate:\n            ssp, _, _ = ModelUtils.regenerate_uuids(ssp)\n\n        ModelUtils.update_last_modified(ssp)\n\n        ModelUtils.save_top_level_model(ssp, trestle_root, out_name, FileContentType.JSON)\n\n        return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPFilter-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPFilter.name","title":"<code>name = 'ssp-filter'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPFilter-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPFilter.filter_ssp","title":"<code>filter_ssp(trestle_root, ssp_name, profile_name, out_name, regenerate, version, components=None, implementation_status=None, control_origination=None)</code>","text":"<p>Filter the ssp and output new ssp.</p> <p>The filtered ssp is based on controls included by the following: profile, components, implementation status, and/or control origination.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>root directory of the trestle workspace</p> required <code>ssp_name</code> <code>str</code> <p>name of the ssp model</p> required <code>profile_name</code> <code>str</code> <p>name of the optional profile model used for filtering</p> required <code>out_name</code> <code>str</code> <p>name of the output ssp model with filtered controls</p> required <code>regenerate</code> <code>bool</code> <p>whether to regenerate the uuid's in the ssp</p> required <code>version</code> <code>Optional[str]</code> <p>new version for the model</p> required <code>components</code> <code>Optional[List[str]]</code> <p>optional list of component names used for filtering</p> <code>None</code> <code>implementation_status</code> <code>Optional[List[str]]</code> <p>optional list of implementation statuses for filtering</p> <code>None</code> <code>control_origination</code> <code>Optional[List[str]]</code> <p>optional list of control origination values for filtering</p> <code>None</code> <p>Returns:</p> Type Description <code>int</code> <p>0 on success, 1 otherwise</p> Source code in <code>trestle/core/commands/author/ssp.py</code> <pre><code>def filter_ssp(\n    self,\n    trestle_root: pathlib.Path,\n    ssp_name: str,\n    profile_name: str,\n    out_name: str,\n    regenerate: bool,\n    version: Optional[str],\n    components: Optional[List[str]] = None,\n    implementation_status: Optional[List[str]] = None,\n    control_origination: Optional[List[str]] = None\n) -&gt; int:\n    \"\"\"\n    Filter the ssp and output new ssp.\n\n    The filtered ssp is based on controls included by the following:\n    profile, components, implementation status, and/or control origination.\n\n    Args:\n        trestle_root: root directory of the trestle workspace\n        ssp_name: name of the ssp model\n        profile_name: name of the optional profile model used for filtering\n        out_name: name of the output ssp model with filtered controls\n        regenerate: whether to regenerate the uuid's in the ssp\n        version: new version for the model\n        components: optional list of component names used for filtering\n        implementation_status: optional list of implementation statuses for filtering\n        control_origination: optional list of control origination values for filtering\n\n    Returns:\n        0 on success, 1 otherwise\n    \"\"\"\n    # load the ssp\n    ssp: ossp.SystemSecurityPlan\n    ssp, _ = load_validate_model_name(trestle_root, ssp_name, ossp.SystemSecurityPlan, FileContentType.JSON)\n    profile_path = ModelUtils.get_model_path_for_name_and_class(\n        trestle_root, profile_name, prof.Profile, FileContentType.JSON\n    )\n\n    if components:\n        raw_comp_names = [ControlReader.simplify_name(name) for name in components]\n        comp_uuids: List[str] = []\n        for component in ssp.system_implementation.components:\n            if ControlReader.simplify_name(component.title) in raw_comp_names:\n                comp_uuids.append(component.uuid)\n\n        if len(comp_uuids) != len(components):\n            raise TrestleError(\n                f'Unable to filter the ssp because one of the components {components} is not in the ssp.'\n            )\n\n        # imp_reqs can be by comp\n        # and imp_reqs can have statements that are by comp\n        if comp_uuids:\n            new_imp_reqs: List[ossp.ImplementedRequirement] = []\n            # these are all required to be present\n            for imp_req in ssp.control_implementation.implemented_requirements:\n                new_by_comps: List[ossp.ByComponent] = []\n                # by_comps is optional\n                for by_comp in as_list(imp_req.by_components):\n                    if by_comp.component_uuid in comp_uuids:\n                        new_by_comps.append(by_comp)\n                imp_req.by_components = none_if_empty(new_by_comps)\n                new_imp_reqs.append(imp_req)\n                new_statements: List[ossp.Statement] = []\n                for statement in as_list(imp_req.statements):\n                    new_by_comps: List[ossp.ByComponent] = []\n                    for by_comp in as_list(statement.by_components):\n                        if by_comp.component_uuid in comp_uuids:\n                            new_by_comps.append(by_comp)\n                    statement.by_components = none_if_empty(new_by_comps)\n                    new_statements.append(statement)\n                imp_req.statements = none_if_empty(new_statements)\n            ssp.control_implementation.implemented_requirements = new_imp_reqs\n            # now remove any unused components from the ssp\n            new_comp_list: List[ossp.SystemComponent] = []\n            for comp_ in ssp.system_implementation.components:\n                if comp_.uuid in comp_uuids:\n                    new_comp_list.append(comp_)\n            ssp.system_implementation.components = new_comp_list\n\n    # filter by controls in profile\n    if profile_name:\n        prof_resolver = ProfileResolver()\n        catalog = prof_resolver.get_resolved_profile_catalog(trestle_root, profile_path, show_value_warnings=True)\n        catalog_api = CatalogAPI(catalog=catalog)\n\n        # The input ssp should reference a superset of the controls referenced by the profile\n        # Need to cull references in the ssp to controls not in the profile\n        # Also make sure the output ssp contains imp reqs for all controls in the profile\n        control_imp = ssp.control_implementation\n        ssp_control_ids: Set[str] = set()\n\n        new_set_params: List[ossp.SetParameter] = []\n        for set_param in as_list(control_imp.set_parameters):\n            control = catalog_api._catalog_interface.get_control_by_param_id(set_param.param_id)\n            if control is not None:\n                new_set_params.append(set_param)\n                ssp_control_ids.add(control.id)\n        control_imp.set_parameters = none_if_empty(new_set_params)\n\n        new_imp_requirements: List[ossp.ImplementedRequirement] = []\n        for imp_requirement in as_list(control_imp.implemented_requirements):\n            control = catalog_api._catalog_interface.get_control(imp_requirement.control_id)\n            if control is not None:\n                new_imp_requirements.append(imp_requirement)\n                ssp_control_ids.add(control.id)\n        control_imp.implemented_requirements = new_imp_requirements\n\n        # make sure all controls in the profile have implemented reqs in the final ssp\n        if not ssp_control_ids.issuperset(catalog_api._catalog_interface.get_control_ids()):\n            raise TrestleError('Unable to filter the ssp because the profile references controls not in it.')\n\n        ssp.control_implementation = control_imp\n\n    # filter implemented requirements and statements by component implementation status\n    # this will remove any implemented requirements without statements or by_component fields set\n    if implementation_status:\n        new_imp_reqs: List[ossp.ImplementedRequirement] = []\n        # these are all required to be present\n        for imp_req in ssp.control_implementation.implemented_requirements:\n            new_by_comps: List[ossp.ByComponent] = []\n            # by_comps is optional\n            for by_comp in as_list(imp_req.by_components):\n                if by_comp.implementation_status.state in implementation_status:\n                    new_by_comps.append(by_comp)\n            imp_req.by_components = none_if_empty(new_by_comps)\n\n            new_statements: List[ossp.Statement] = []\n            for statement in as_list(imp_req.statements):\n                new_by_comps: List[ossp.ByComponent] = []\n                for by_comp in as_list(statement.by_components):\n                    if by_comp.implementation_status.state in implementation_status:\n                        new_by_comps.append(by_comp)\n                statement.by_components = none_if_empty(new_by_comps)\n                if statement.by_components is not None:\n                    new_statements.append(statement)\n            imp_req.statements = none_if_empty(new_statements)\n\n            if imp_req.by_components is not None or imp_req.statements is not None:\n                new_imp_reqs.append(imp_req)\n\n        ssp.control_implementation.implemented_requirements = new_imp_reqs\n\n    # filter implemented requirements by control origination property.\n    # this will remove any implemented requirements without the control origination\n    # property set\n    if control_origination:\n        new_imp_reqs: List[ossp.ImplementedRequirement] = []\n\n        for imp_requirement in ssp.control_implementation.implemented_requirements:\n            if imp_requirement.props:\n                for prop in imp_requirement.props:\n                    if prop.name == const.CONTROL_ORIGINATION and prop.value in control_origination:\n                        new_imp_reqs.append(imp_requirement)\n                        # only add the imp requirement one time\n                        break\n\n        ssp.control_implementation.implemented_requirements = new_imp_reqs\n\n    if version:\n        ssp.metadata.version = version\n\n    existing_ssp_path = ModelUtils.get_model_path_for_name_and_class(\n        trestle_root, out_name, ossp.SystemSecurityPlan\n    )\n    if existing_ssp_path is not None:\n        existing_ssp, _ = load_validate_model_name(trestle_root, out_name, ossp.SystemSecurityPlan)\n        if ModelUtils.models_are_equivalent(existing_ssp, ssp):  # type: ignore\n            logger.info('No changes to filtered ssp so ssp not written out.')\n            return CmdReturnCodes.SUCCESS.value\n\n    if regenerate:\n        ssp, _, _ = ModelUtils.regenerate_uuids(ssp)\n\n    ModelUtils.update_last_modified(ssp)\n\n    ModelUtils.save_top_level_model(ssp, trestle_root, out_name, FileContentType.JSON)\n\n    return CmdReturnCodes.SUCCESS.value\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPGenerate","title":"<code>SSPGenerate</code>","text":"<p>               Bases: <code>AuthorCommonCommand</code></p> <p>Generate SSP in markdown form from a Profile.</p> Source code in <code>trestle/core/commands/author/ssp.py</code> <pre><code>class SSPGenerate(AuthorCommonCommand):\n    \"\"\"Generate SSP in markdown form from a Profile.\"\"\"\n\n    name = 'ssp-generate'\n\n    def _init_arguments(self) -&gt; None:\n        file_help_str = 'Main profile href, or name of the profile model in the trestle workspace'\n        self.add_argument('-p', '--profile', help=file_help_str, required=True, type=str)\n        self.add_argument(\n            '-o', '--output', help='Name of the output generated ssp markdown folder', required=True, type=str\n        )  # noqa E501\n        self.add_argument('-cd', '--compdefs', help=const.HELP_COMPDEFS, required=False, type=str)\n\n        ls_help_str = 'Leveraged ssp with inheritable controls href or name in the trestle_workspace'\n        self.add_argument('-ls', '--leveraged-ssp', help=ls_help_str, required=False, type=str)\n\n        self.add_argument('-y', '--yaml-header', help=const.HELP_YAML_PATH, required=False, type=str)\n        self.add_argument(\n            '-fo', '--force-overwrite', help=const.HELP_FO_OUTPUT, required=False, action='store_true', default=False\n        )\n        self.add_argument(\n            '-ohv',\n            '--overwrite-header-values',\n            help=const.HELP_OVERWRITE_HEADER_VALUES,\n            required=False,\n            action='store_true',\n            default=False\n        )\n        self.add_argument(\n            '-iap',\n            '--include-all-parts',\n            help=const.HELP_INCLUDE_ALL_PARTS,\n            required=False,\n            action='store_true',\n            default=False\n        )\n\n    def _run(self, args: argparse.Namespace) -&gt; int:\n        try:\n            log.set_log_level_from_args(args)\n            trestle_root = args.trestle_root\n            if not file_utils.is_directory_name_allowed(args.output):\n                raise TrestleError(f'{args.output} is not an allowed directory name')\n\n            yaml_header: Dict[str, Any] = {}\n            if args.yaml_header:\n                try:\n                    logging.debug(f'Loading yaml header file {args.yaml_header}')\n                    yaml = YAML()\n                    yaml_header = yaml.load(pathlib.Path(args.yaml_header).open('r'))\n                except YAMLError as e:\n                    raise TrestleError(f'YAML error loading yaml header {args.yaml_header} for ssp generation: {e}')\n\n            compdef_name_list = comma_sep_to_list(args.compdefs)\n\n            md_path = trestle_root / args.output\n\n            return self._generate_ssp_markdown(\n                trestle_root,\n                args.profile,\n                compdef_name_list,\n                args.leveraged_ssp,\n                md_path,\n                yaml_header,\n                args.overwrite_header_values,\n                args.force_overwrite,\n                args.include_all_parts\n            )\n\n        except Exception as e:  # pragma: no cover\n            return handle_generic_command_exception(e, logger, 'Error while writing markdown from catalog')\n\n    def _generate_ssp_markdown(\n        self,\n        trestle_root: pathlib.Path,\n        profile_name_or_href: str,\n        compdef_name_list: List[str],\n        leveraged_ssp_name_or_href: str,\n        md_path: pathlib.Path,\n        yaml_header: Dict[str, Any],\n        overwrite_header_values: bool,\n        force_overwrite: bool,\n        include_all_parts: bool\n    ) -&gt; int:\n        \"\"\"\n        Generate the ssp markdown from the profile and compdefs.\n\n        Notes:\n        Get RPC from profile.\n        For each compdef:\n            For each comp:\n                Load top level rules\n                for each control_imp:\n                    Load rules params values\n                    For each imp_req (bound to 1 control):\n                        Load control level rules and status\n                        Load part level rules\n                        If rules apply then write out control and add to list written out\n                        If control exists, read it and insert content\n        \"\"\"\n        if force_overwrite:\n            try:\n                logger.info(f'Overwriting the content in {md_path}.')\n                clear_folder(pathlib.Path(md_path))\n            except TrestleError as e:  # pragma: no cover\n                raise TrestleError(f'Unable to overwrite contents of {md_path}: {e}')\n\n        context = ControlContext.generate(ContextPurpose.SSP, True, trestle_root, md_path)\n        context.cli_yaml_header = yaml_header\n        context.sections_dict = None\n        context.prompt_responses = True\n        context.overwrite_header_values = overwrite_header_values\n        context.allowed_sections = None\n        context.comp_def_name_list = compdef_name_list\n        context.include_all_parts = include_all_parts\n\n        # if file not recognized as URI form, assume it represents name of file in trestle directory\n        profile_in_trestle_dir = '://' not in profile_name_or_href\n        profile_href = profile_name_or_href\n        if profile_in_trestle_dir:\n            local_path = f'profiles/{profile_name_or_href}/profile.json'\n            profile_href = const.TRESTLE_HREF_HEADING + local_path\n            profile_path = trestle_root / local_path\n            _, _, context.profile = ModelUtils.load_distributed(profile_path, trestle_root)\n        else:\n            fetcher = FetcherFactory.get_fetcher(trestle_root, profile_href)\n            context.profile = fetcher.get_oscal()\n            profile_path = profile_href\n\n        profile_resolver = ProfileResolver()\n        # in ssp context we want to see missing value warnings\n        resolved_catalog = profile_resolver.get_resolved_profile_catalog(\n            trestle_root,\n            profile_path,\n            block_params=False,\n            params_format='[.]',\n            param_rep=ParameterRep.ASSIGNMENT_FORM,\n            show_value_warnings=True\n        )\n\n        catalog_api = CatalogAPI(catalog=resolved_catalog, context=context)\n\n        context.cli_yaml_header[const.TRESTLE_GLOBAL_TAG] = {}\n        profile_header = {'title': context.profile.metadata.title, 'href': profile_href}\n\n        context.cli_yaml_header[const.TRESTLE_GLOBAL_TAG][const.PROFILE] = profile_header\n\n        catalog_api.write_catalog_as_markdown()\n\n        # Generate inheritance view after controls view completes\n        if leveraged_ssp_name_or_href:\n            self._generate_inheritance_markdown(trestle_root, leveraged_ssp_name_or_href, resolved_catalog, md_path)\n\n        return CmdReturnCodes.SUCCESS.value\n\n    def _generate_inheritance_markdown(\n        self,\n        trestle_root: pathlib.Path,\n        leveraged_ssp_name_or_href: str,\n        resolved_catalog: CatalogInterface,\n        md_path: str\n    ) -&gt; None:\n        \"\"\"\n        Generate markdown for inheritance view.\n\n        Notes:\n            This will create the inheritance view markdown files in the same directory as the ssp markdown files.\n            The information will be from the leveraged ssp, but filtered by the chosen profile to ensure only relevant\n            controls are present for mapping.\n        \"\"\"\n        # if file not recognized as URI form, assume it represents name of file in trestle directory\n        ssp_in_trestle_dir = '://' not in leveraged_ssp_name_or_href\n        ssp_href = leveraged_ssp_name_or_href\n        if ssp_in_trestle_dir:\n            local_path = f'{const.MODEL_DIR_SSP}/{leveraged_ssp_name_or_href}/system-security-plan.json'\n            ssp_href = const.TRESTLE_HREF_HEADING + local_path\n\n        inheritance_view_path: pathlib.Path = md_path.joinpath(const.INHERITANCE_VIEW_DIR)\n        inheritance_view_path.mkdir(exist_ok=True)\n        logger.debug(f'Creating content for inheritance view in {inheritance_view_path}')\n\n        ssp_inheritance_api = SSPInheritanceAPI(inheritance_view_path, trestle_root)\n\n        # Filter the ssp implemented requirements by the catalog specified\n        catalog_api: CatalogAPI = CatalogAPI(catalog=resolved_catalog)\n        ssp_inheritance_api.write_inheritance_as_markdown(ssp_href, catalog_api)\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPGenerate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp.SSPGenerate.name","title":"<code>name = 'ssp-generate'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/ssp/#trestle.core.commands.author.ssp-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/","title":"trestle.core.commands.author.versioning.template_versioning","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning","title":"<code>trestle.core.commands.author.versioning.template_versioning</code>","text":"<p>A Template Versioning.</p>"},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning","title":"<code>TemplateVersioning</code>","text":"<p>Template versioning solution.</p> <ol> <li>Load template with a specified version.<ol> <li>Template version can be specified via -tv flag</li> <li>If no version specified the latest version will be used by default.</li> <li>Otherwise use the templates from the specified version.</li> </ol> </li> <li>Backward compatibility.<ol> <li>Version 0.0.1 will be reserved for the template versions prior to this change.</li> <li>If the old template path is detected (i.e. without the template version).     then the filesystem will be updated to the new path with the version.</li> <li>Upon first run, old template versions prior to this change will be placed to the folder 0.0.1.</li> <li>If templates have no headers then 0.0.1 version will be used.</li> </ol> </li> <li>Versioning organization.<ol> <li>Template and instance version is added both: in the file system (via path) and in the headers or metadata.</li> </ol> </li> <li>Instance version validation.<ol> <li>Markdown:<ol> <li>When validating the instance the header will be used to validate the version.</li> </ol> </li> <li>Drawio:<ol> <li>When validating the instance the metadata will be used to validate the version.</li> </ol> </li> </ol> </li> </ol> Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code> <pre><code>class TemplateVersioning:\n    \"\"\"\n    Template versioning solution.\n\n    1. Load template with a specified version.\n        1. Template version can be specified via -tv flag\n        2. If no version specified the latest version will be used by default.\n        3. Otherwise use the templates from the specified version.\n    2. Backward compatibility.\n        1. Version 0.0.1 will be reserved for the template versions prior to this change.\n        2. If the old template path is detected (i.e. without the template version).\n            then the filesystem will be updated to the new path with the version.\n        3. Upon first run, old template versions prior to this change will be placed to the folder 0.0.1.\n        4. If templates have no headers then 0.0.1 version will be used.\n    3. Versioning organization.\n        1. Template and instance version is added both: in the file system (via path) and in the headers or metadata.\n    4. Instance version validation.\n        1. Markdown:\n            1. When validating the instance the header will be used to validate the version.\n        2. Drawio:\n            1. When validating the instance the metadata will be used to validate the version.\n    \"\"\"\n\n    @staticmethod\n    def update_template_folder_structure(task_path: Path) -&gt; None:\n        \"\"\"\n        Automatically detect whether the path is an old style and update it.\n\n        An old-style path is a path of the form:\n         root_folder/.trestle/author/{template_name}/{template_objects}\n        The new version path is a path of the form:\n         root_folder/.trestle/author/{template_name}/{version}/{template_objects}\n        By default all old-style templates will be updated to version 0.0.1\n        \"\"\"\n        TemplateVersioning._check_if_exists_and_dir(task_path)\n\n        try:\n            all_files_wo_version = list(\n                filter(lambda p: p.is_file(), file_utils.iterdir_without_hidden_files(task_path))\n            )\n\n            pattern = re.compile(TEMPLATE_VERSION_REGEX)\n            all_non_template_directories = list(\n                filter(\n                    lambda p: p.is_dir() and pattern.search(p.parts[-1]) is None,\n                    file_utils.iterdir_without_hidden_files(task_path)\n                )\n            )\n\n            new_dir = Path(f'{task_path}/{START_TEMPLATE_VERSION}')\n            new_dir.mkdir(parents=True, exist_ok=True)\n\n            if len(all_files_wo_version) == 0:\n                logger.debug('No templates outside of the version folders.')\n                # if the base template folder is empty, delete it\n                if len(list(new_dir.iterdir())) == 0:\n                    new_dir.rmdir()\n\n            for f in all_files_wo_version + all_non_template_directories:\n                if f.is_file():\n                    shutil.copy(f, new_dir)\n                elif f.is_dir():\n                    shutil.copytree(f, new_dir / f.name)\n\n            for p in all_files_wo_version + all_non_template_directories:\n                if p.is_dir():\n                    shutil.rmtree(p)\n                else:\n                    p.unlink()\n\n        except OSError as e:\n            raise TrestleError(f'Error while updating template folder: {e}')\n        except Exception as e:\n            raise TrestleError(f'Unexpected error while updating template folder: {e}')\n\n    @staticmethod\n    def get_versioned_template_dir(task_path: Path, version: Optional[str] = None) -&gt; Path:\n        \"\"\"\n        Get a template folder of the specified version.\n\n        If no version is given, the latest version of template will be returned\n        \"\"\"\n        TemplateVersioning._check_if_exists_and_dir(task_path)\n        latest_path = None\n        if version is None:\n            latest_path, _ = TemplateVersioning.get_latest_version_for_task(task_path)\n        else:\n            latest_path = Path(f'{task_path}/{version}/')\n\n        if not latest_path.exists():\n            raise TrestleError(f'The task: {task_path} with version: {version} does not exists.')\n\n        return latest_path\n\n    @staticmethod\n    def get_latest_version_for_task(task_path: Path) -&gt; Tuple[Path, str]:\n        \"\"\"Get latest version of the template for the given task.\"\"\"\n        TemplateVersioning._check_if_exists_and_dir(task_path)\n\n        all_versions = TemplateVersioning.get_all_versions_for_task(task_path)\n        max_version = START_TEMPLATE_VERSION\n\n        if len(all_versions) == 0:\n            logger.debug(f'No template versions were found for task: {task_path}, defaulting to 0.0.1')\n            max_version = START_TEMPLATE_VERSION\n        else:\n            max_version = max(all_versions)\n\n        latest_path = Path(f'{task_path}/{max_version}')\n\n        return latest_path, max_version\n\n    @staticmethod\n    def get_all_versions_for_task(task_path: Path) -&gt; List[str]:\n        \"\"\"Get all versions for the task.\"\"\"\n        pattern = re.compile(TEMPLATE_VERSION_REGEX)\n        all_versions = []\n        max_version = START_TEMPLATE_VERSION\n        for p in task_path.iterdir():\n            if p.is_dir() and pattern.search(p.parts[-1]) is not None:\n                match = pattern.search(p.parts[-1]).string\n                all_versions.append(match)\n                if match &gt; max_version:\n                    max_version = match\n\n        return all_versions\n\n    @staticmethod\n    def write_versioned_template(\n        resource_name: str, task_path: Path, target_file: Path, version: Optional[str] = None\n    ) -&gt; None:\n        \"\"\"\n        Write a template with the header or metadata of a specified version.\n\n        If no version was given the latest version for the task will be used.\n\n        Args:\n            resource_name:  Template resource name\n            task_path: Task path\n            target_file: File path where template will be written\n            version: return a resource of a specific version\n\n        Returns:\n            A dotted path of a versioned template, list of all available versions\n        \"\"\"\n        TemplateVersioning._check_if_exists_and_dir(task_path)\n        try:\n            templates_resource_path = TRESTLE_RESOURCES + '.templates'\n\n            ref = importlib_resources.files(templates_resource_path) / resource_name\n            with importlib_resources.as_file(ref) as generic_template:\n                if version is None:\n                    _, version = TemplateVersioning.get_latest_version_for_task(task_path)\n\n                # modify header/metadata in the template\n                if generic_template.suffix == MARKDOWN_FILE_EXT:\n                    md_api = MarkdownAPI()\n                    header, md_body = md_api.processor.read_markdown_wo_processing(generic_template)\n                    header[TEMPLATE_VERSION_HEADER] = version\n                    md_api.write_markdown_with_header(target_file, header, md_body)\n                    logger.debug(f'Successfully written template markdown to {target_file}')\n                elif generic_template.suffix == DRAWIO_FILE_EXT:\n                    drawio = DrawIO(generic_template)\n                    metadata = drawio.get_metadata()[0]\n                    metadata[TEMPLATE_VERSION_HEADER] = version\n\n                    drawio.write_drawio_with_metadata(generic_template, metadata, 0, target_file)\n                    logger.debug(f'Successfully written template drawio to {target_file}')\n                else:\n                    raise TrestleError(f'Unsupported template file extension {generic_template.suffix}')\n        except OSError as e:\n            raise TrestleError(f'Error while updating template folder: {e}')\n\n    @staticmethod\n    def is_valid_version(template_version: str) -&gt; bool:\n        \"\"\"Check if the version format is correct.\"\"\"\n        if template_version is None:\n            return True  # we can have empty version\n        if template_version == '0.0.0':\n            return False\n        version_regex = r'^[0-9]+\\.[0-9]+\\.[0-9]+$'\n        pattern = re.compile(version_regex)\n        if pattern.search(template_version):\n            return True\n        else:\n            return False\n\n    @staticmethod\n    def _check_if_exists_and_dir(task_path: Path) -&gt; None:\n        if not task_path.exists():\n            raise TrestleError(f'Path: {task_path} does not exists.')\n\n        if not task_path.is_dir():\n            raise TrestleError(f'File {task_path} passed, however template directory is expected.')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_all_versions_for_task","title":"<code>get_all_versions_for_task(task_path)</code>  <code>staticmethod</code>","text":"<p>Get all versions for the task.</p> Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code> <pre><code>@staticmethod\ndef get_all_versions_for_task(task_path: Path) -&gt; List[str]:\n    \"\"\"Get all versions for the task.\"\"\"\n    pattern = re.compile(TEMPLATE_VERSION_REGEX)\n    all_versions = []\n    max_version = START_TEMPLATE_VERSION\n    for p in task_path.iterdir():\n        if p.is_dir() and pattern.search(p.parts[-1]) is not None:\n            match = pattern.search(p.parts[-1]).string\n            all_versions.append(match)\n            if match &gt; max_version:\n                max_version = match\n\n    return all_versions\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_latest_version_for_task","title":"<code>get_latest_version_for_task(task_path)</code>  <code>staticmethod</code>","text":"<p>Get latest version of the template for the given task.</p> Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code> <pre><code>@staticmethod\ndef get_latest_version_for_task(task_path: Path) -&gt; Tuple[Path, str]:\n    \"\"\"Get latest version of the template for the given task.\"\"\"\n    TemplateVersioning._check_if_exists_and_dir(task_path)\n\n    all_versions = TemplateVersioning.get_all_versions_for_task(task_path)\n    max_version = START_TEMPLATE_VERSION\n\n    if len(all_versions) == 0:\n        logger.debug(f'No template versions were found for task: {task_path}, defaulting to 0.0.1')\n        max_version = START_TEMPLATE_VERSION\n    else:\n        max_version = max(all_versions)\n\n    latest_path = Path(f'{task_path}/{max_version}')\n\n    return latest_path, max_version\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.get_versioned_template_dir","title":"<code>get_versioned_template_dir(task_path, version=None)</code>  <code>staticmethod</code>","text":"<p>Get a template folder of the specified version.</p> <p>If no version is given, the latest version of template will be returned</p> Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code> <pre><code>@staticmethod\ndef get_versioned_template_dir(task_path: Path, version: Optional[str] = None) -&gt; Path:\n    \"\"\"\n    Get a template folder of the specified version.\n\n    If no version is given, the latest version of template will be returned\n    \"\"\"\n    TemplateVersioning._check_if_exists_and_dir(task_path)\n    latest_path = None\n    if version is None:\n        latest_path, _ = TemplateVersioning.get_latest_version_for_task(task_path)\n    else:\n        latest_path = Path(f'{task_path}/{version}/')\n\n    if not latest_path.exists():\n        raise TrestleError(f'The task: {task_path} with version: {version} does not exists.')\n\n    return latest_path\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.is_valid_version","title":"<code>is_valid_version(template_version)</code>  <code>staticmethod</code>","text":"<p>Check if the version format is correct.</p> Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code> <pre><code>@staticmethod\ndef is_valid_version(template_version: str) -&gt; bool:\n    \"\"\"Check if the version format is correct.\"\"\"\n    if template_version is None:\n        return True  # we can have empty version\n    if template_version == '0.0.0':\n        return False\n    version_regex = r'^[0-9]+\\.[0-9]+\\.[0-9]+$'\n    pattern = re.compile(version_regex)\n    if pattern.search(template_version):\n        return True\n    else:\n        return False\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.update_template_folder_structure","title":"<code>update_template_folder_structure(task_path)</code>  <code>staticmethod</code>","text":"<p>Automatically detect whether the path is an old style and update it.</p> An old-style path is a path of the form <p>root_folder/.trestle/author/{template_name}/{template_objects}</p> <p>The new version path is a path of the form:  root_folder/.trestle/author/{template_name}/{version}/{template_objects} By default all old-style templates will be updated to version 0.0.1</p> Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code> <pre><code>@staticmethod\ndef update_template_folder_structure(task_path: Path) -&gt; None:\n    \"\"\"\n    Automatically detect whether the path is an old style and update it.\n\n    An old-style path is a path of the form:\n     root_folder/.trestle/author/{template_name}/{template_objects}\n    The new version path is a path of the form:\n     root_folder/.trestle/author/{template_name}/{version}/{template_objects}\n    By default all old-style templates will be updated to version 0.0.1\n    \"\"\"\n    TemplateVersioning._check_if_exists_and_dir(task_path)\n\n    try:\n        all_files_wo_version = list(\n            filter(lambda p: p.is_file(), file_utils.iterdir_without_hidden_files(task_path))\n        )\n\n        pattern = re.compile(TEMPLATE_VERSION_REGEX)\n        all_non_template_directories = list(\n            filter(\n                lambda p: p.is_dir() and pattern.search(p.parts[-1]) is None,\n                file_utils.iterdir_without_hidden_files(task_path)\n            )\n        )\n\n        new_dir = Path(f'{task_path}/{START_TEMPLATE_VERSION}')\n        new_dir.mkdir(parents=True, exist_ok=True)\n\n        if len(all_files_wo_version) == 0:\n            logger.debug('No templates outside of the version folders.')\n            # if the base template folder is empty, delete it\n            if len(list(new_dir.iterdir())) == 0:\n                new_dir.rmdir()\n\n        for f in all_files_wo_version + all_non_template_directories:\n            if f.is_file():\n                shutil.copy(f, new_dir)\n            elif f.is_dir():\n                shutil.copytree(f, new_dir / f.name)\n\n        for p in all_files_wo_version + all_non_template_directories:\n            if p.is_dir():\n                shutil.rmtree(p)\n            else:\n                p.unlink()\n\n    except OSError as e:\n        raise TrestleError(f'Error while updating template folder: {e}')\n    except Exception as e:\n        raise TrestleError(f'Unexpected error while updating template folder: {e}')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/author/versioning/template_versioning/#trestle.core.commands.author.versioning.template_versioning.TemplateVersioning.write_versioned_template","title":"<code>write_versioned_template(resource_name, task_path, target_file, version=None)</code>  <code>staticmethod</code>","text":"<p>Write a template with the header or metadata of a specified version.</p> <p>If no version was given the latest version for the task will be used.</p> <p>Parameters:</p> Name Type Description Default <code>resource_name</code> <code>str</code> <p>Template resource name</p> required <code>task_path</code> <code>Path</code> <p>Task path</p> required <code>target_file</code> <code>Path</code> <p>File path where template will be written</p> required <code>version</code> <code>Optional[str]</code> <p>return a resource of a specific version</p> <code>None</code> <p>Returns:</p> Type Description <code>None</code> <p>A dotted path of a versioned template, list of all available versions</p> Source code in <code>trestle/core/commands/author/versioning/template_versioning.py</code> <pre><code>@staticmethod\ndef write_versioned_template(\n    resource_name: str, task_path: Path, target_file: Path, version: Optional[str] = None\n) -&gt; None:\n    \"\"\"\n    Write a template with the header or metadata of a specified version.\n\n    If no version was given the latest version for the task will be used.\n\n    Args:\n        resource_name:  Template resource name\n        task_path: Task path\n        target_file: File path where template will be written\n        version: return a resource of a specific version\n\n    Returns:\n        A dotted path of a versioned template, list of all available versions\n    \"\"\"\n    TemplateVersioning._check_if_exists_and_dir(task_path)\n    try:\n        templates_resource_path = TRESTLE_RESOURCES + '.templates'\n\n        ref = importlib_resources.files(templates_resource_path) / resource_name\n        with importlib_resources.as_file(ref) as generic_template:\n            if version is None:\n                _, version = TemplateVersioning.get_latest_version_for_task(task_path)\n\n            # modify header/metadata in the template\n            if generic_template.suffix == MARKDOWN_FILE_EXT:\n                md_api = MarkdownAPI()\n                header, md_body = md_api.processor.read_markdown_wo_processing(generic_template)\n                header[TEMPLATE_VERSION_HEADER] = version\n                md_api.write_markdown_with_header(target_file, header, md_body)\n                logger.debug(f'Successfully written template markdown to {target_file}')\n            elif generic_template.suffix == DRAWIO_FILE_EXT:\n                drawio = DrawIO(generic_template)\n                metadata = drawio.get_metadata()[0]\n                metadata[TEMPLATE_VERSION_HEADER] = version\n\n                drawio.write_drawio_with_metadata(generic_template, metadata, 0, target_file)\n                logger.debug(f'Successfully written template drawio to {target_file}')\n            else:\n                raise TrestleError(f'Unsupported template file extension {generic_template.suffix}')\n    except OSError as e:\n        raise TrestleError(f'Error while updating template folder: {e}')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/common/cmd_utils/","title":"trestle.core.commands.common.cmd_utils","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils","title":"<code>trestle.core.commands.common.cmd_utils</code>","text":"<p>Trestle command related utilities.</p>"},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils.clear_folder","title":"<code>clear_folder(folder_path)</code>","text":"<p>Clear all contents of the specified folder.</p> Source code in <code>trestle/core/commands/common/cmd_utils.py</code> <pre><code>def clear_folder(folder_path: pathlib.Path) -&gt; None:\n    \"\"\"Clear all contents of the specified folder.\"\"\"\n    if not folder_path.exists() or not folder_path.is_dir():\n        return\n    try:\n        shutil.rmtree(folder_path)\n    except OSError as e:  # pragma: no cover\n        raise TrestleError(f'Error deleting contents of {folder_path}: {e}')\n</code></pre>"},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils.model_type_is_too_granular","title":"<code>model_type_is_too_granular(model_type)</code>","text":"<p>Is an model_type too fine to split.</p> Source code in <code>trestle/core/commands/common/cmd_utils.py</code> <pre><code>def model_type_is_too_granular(model_type: Type[Any]) -&gt; bool:\n    \"\"\"Is an model_type too fine to split.\"\"\"\n    if type_utils.is_collection_field_type(model_type):\n        return False\n    if hasattr(model_type, '__fields__') and '__root__' in model_type.__fields__:\n        return True\n    if model_type.__name__ in ['str', 'ConstrainedStrValue', 'int', 'float', 'datetime']:\n        return True\n    return False\n</code></pre>"},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils.parse_chain","title":"<code>parse_chain(model_obj, path_parts, relative_path=None)</code>","text":"<p>Parse the model chain starting from the beginning.</p> <p>Parameters:</p> Name Type Description Default <code>model_obj</code> <code>Union[OscalBaseModel, None]</code> <p>Model to use for inspecting available elements, if available or none</p> required <code>path_parts</code> <code>List[str]</code> <p>list of string paths to parse including wildcards</p> required <code>relative_path</code> <code>Optional[Path]</code> <p>Optional relative path (w.r.t trestle workspace root directory)</p> <code>None</code> <p>Returns:</p> Type Description <code>List[ElementPath]</code> <p>List of ElementPath</p> Source code in <code>trestle/core/commands/common/cmd_utils.py</code> <pre><code>def parse_chain(\n    model_obj: Union[OscalBaseModel, None],\n    path_parts: List[str],\n    relative_path: Optional[pathlib.Path] = None\n) -&gt; List[ElementPath]:\n    \"\"\"Parse the model chain starting from the beginning.\n\n    Args:\n        model_obj: Model to use for inspecting available elements, if available or none\n        path_parts: list of string paths to parse including wildcards\n        relative_path: Optional relative path (w.r.t trestle workspace root directory)\n\n    Returns:\n        List of ElementPath\n    \"\"\"\n    element_paths: List[ElementPath] = []\n    sub_model = model_obj\n    have_model_to_parse = model_obj is not None\n\n    prev_element_path = None\n    latest_path = None\n    parent_model = path_parts[0]\n    i = 1\n    while i &lt; len(path_parts):\n        p = path_parts[i]\n\n        # if hit wildcard create element path up to this point\n        if p == ElementPath.WILDCARD and len(element_paths) &gt; 0:\n            # append wildcard to the latest element path\n            latest_path = element_paths.pop()\n            if latest_path.get_last() == ElementPath.WILDCARD:\n                raise TrestleError(f'Invalid element path with consecutive {ElementPath.WILDCARD}')\n\n            latest_path_str = ElementPath.PATH_SEPARATOR.join([latest_path.to_string(), p])\n            element_path = ElementPath(latest_path_str, latest_path.get_parent())\n        else:\n            # create and append element_path\n            # at this point sub_model may be a list of items\n            # new element path is needed only if any of the items contains the desired part\n            if p != ElementPath.WILDCARD:\n                new_attrib = str_utils.dash_to_underscore(p)\n                if isinstance(sub_model, list):\n                    for item in sub_model:\n                        # go into the list and find one with requested part\n                        sub_item = getattr(item, new_attrib, None)\n                        if sub_item is not None:\n                            sub_model = sub_item\n                            break\n                else:\n                    sub_model = getattr(sub_model, new_attrib, None)\n            if have_model_to_parse and sub_model is None:\n                return element_paths\n            p = ElementPath.PATH_SEPARATOR.join([parent_model, p])\n            element_path = ElementPath(p, parent_path=prev_element_path)\n\n        # If the path has wildcard and there are more parts later,\n        # get the parent model for the alias path\n        # If path has wildcard and it does not refer to a list, then there can be nothing after *\n        if element_path.get_last() == ElementPath.WILDCARD:\n            full_path_str = ElementPath.PATH_SEPARATOR.join(element_path.get_full_path_parts()[:-1])\n            parent_model = ModelUtils.get_singular_alias(full_path_str, relative_path)\n            # Does wildcard mean we need to inspect the sub_model to determine what can be split off from it?\n            # If it has __root__ it may mean it contains a list of objects and should be split as a list\n            if isinstance(sub_model, OscalBaseModel):\n                root = getattr(sub_model, '__root__', None)\n                if root is None or not isinstance(root, list):\n                    # Cannot have parts beyond * if it isn't a list\n                    if i &lt; len(path_parts) - 1:\n                        raise TrestleError(\n                            f'Cannot split beyond * when the wildcard does not refer to a list.  Path: {path_parts}'\n                        )\n                    for key in sub_model.__fields__.keys():\n                        # only create element path is item is present in the sub_model\n                        if getattr(sub_model, key, None) is None:\n                            continue\n                        new_alias = str_utils.underscore_to_dash(key)\n                        new_path = full_path_str + '.' + new_alias\n                        if not split_is_too_fine(new_path, model_obj):\n                            # to add parts of an element, need to add two links\n                            # prev_element_path may be None, for example catalog.*\n                            if prev_element_path is not None:\n                                element_paths.append(prev_element_path)\n                            element_paths.append(ElementPath(parent_model + '.' + new_alias, latest_path))\n                    # Since wildcard is last in the chain when splitting an oscal model we are done\n                    return element_paths\n        else:\n            parent_model = element_path.get_element_name()\n\n        # store values for next cycle\n        prev_element_path = element_path\n        element_paths.append(element_path)\n        i += 1\n    return element_paths\n</code></pre>"},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils.parse_element_arg","title":"<code>parse_element_arg(model_obj, element_arg, relative_path=None)</code>","text":"<p>Parse an element arg string into a list of ElementPath.</p> <p>Parameters:</p> Name Type Description Default <code>model_obj</code> <code>Union[OscalBaseModel, None]</code> <p>The OscalBaseModel being inspected to determine available elements that can be split</p> required <code>element_arg</code> <code>str</code> <p>Single element path, as a string.</p> required <code>relative_path</code> <code>Optional[Path]</code> <p>Optional relative path (from trestle root) used to validate element args are valid.</p> <code>None</code> <p>Returns:     The requested parsed list of ElementPath for use in split</p> Source code in <code>trestle/core/commands/common/cmd_utils.py</code> <pre><code>def parse_element_arg(\n    model_obj: Union[OscalBaseModel, None],\n    element_arg: str,\n    relative_path: Optional[pathlib.Path] = None\n) -&gt; List[ElementPath]:\n    \"\"\"Parse an element arg string into a list of ElementPath.\n\n    Args:\n        model_obj: The OscalBaseModel being inspected to determine available elements that can be split\n        element_arg: Single element path, as a string.\n        relative_path: Optional relative path (from trestle root) used to validate element args are valid.\n    Returns:\n        The requested parsed list of ElementPath for use in split\n    \"\"\"\n    element_arg = element_arg.strip()\n\n    if element_arg == '*':\n        raise TrestleError('Invalid element path containing only a single wildcard.')\n\n    if element_arg == '':\n        raise TrestleError('Invalid element path is empty string.')\n\n    # search for wildcards and create paths with its parent path\n    path_parts = element_arg.split(ElementPath.PATH_SEPARATOR)\n    if len(path_parts) &lt;= 1:\n        raise TrestleError(f'Invalid element path \"{element_arg}\" with only one element and no wildcard')\n\n    element_paths = parse_chain(model_obj, path_parts, relative_path)\n\n    if len(element_paths) &lt;= 0:\n        # don't complain if nothing to split\n        pass\n\n    return element_paths\n</code></pre>"},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils.parse_element_args","title":"<code>parse_element_args(model, element_args, relative_path=None)</code>","text":"<p>Parse element args into a list of ElementPath.</p> <p>The element paths are either simple links of two elements, or two elements followed by *. The * represents either a list of the items in that element, or a splitting of that element into its parts. The only parts split off are the non-trivial ones determined by the granularity check.</p> <p>contextual_mode specifies if the path is a valid project model path or not. For example, if we are processing a metadata.parties.*, we need to know which metadata we are processing. If we pass contextual_mode=true, we can infer the root model by inspecting the file directory</p> <p>If contextual_mode=False, then the path must include the full path, e.g. catalog.metadata.parties. instead of just metadata.parties.</p> <p>When the * represents splitting a model rather than a list, the model is inspected for what parts are available, and for each new part two element paths are created, one for the parent to the current element, and another from the current element to the child.</p> <p>A path may have multiple *'s, but only the final one can represent splitting a model.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>Union[OscalBaseModel, None]</code> <p>The OscalBaseModel being inspected to determine available elements that can be split</p> required <code>element_args</code> <code>List[str]</code> <p>List of str representing links in the chain of element paths to be parsed</p> required <code>relative_path</code> <code>Optional[Path]</code> <p>Optional relative path (from trestle root) used to validate element args are valid.</p> <code>None</code> <p>Returns:     The requested parsed list of ElementPath for use in split</p> Source code in <code>trestle/core/commands/common/cmd_utils.py</code> <pre><code>def parse_element_args(\n    model: Union[OscalBaseModel, None],\n    element_args: List[str],\n    relative_path: Optional[pathlib.Path] = None\n) -&gt; List[ElementPath]:\n    \"\"\"Parse element args into a list of ElementPath.\n\n    The element paths are either simple links of two elements, or two elements followed by *.\n    The * represents either a list of the items in that element, or a splitting of that element into its parts.\n    The only parts split off are the non-trivial ones determined by the granularity check.\n\n    contextual_mode specifies if the path is a valid project model path or not. For example,\n    if we are processing a metadata.parties.*, we need to know which metadata we are processing. If we pass\n    contextual_mode=true, we can infer the root model by inspecting the file directory\n\n    If contextual_mode=False, then the path must include the full path, e.g. catalog.metadata.parties.* instead of just\n    metadata.parties.*\n\n    When the * represents splitting a model rather than a list, the model is inspected for what parts are available,\n    and for each new part two element paths are created, one for the parent to the current element, and another from\n    the current element to the child.\n\n    A path may have multiple *'s, but only the final one can represent splitting a model.\n\n    Args:\n        model: The OscalBaseModel being inspected to determine available elements that can be split\n        element_args: List of str representing links in the chain of element paths to be parsed\n        relative_path: Optional relative path (from trestle root) used to validate element args are valid.\n    Returns:\n        The requested parsed list of ElementPath for use in split\n    \"\"\"\n    # collect all paths\n    element_paths: List[ElementPath] = []\n    for element_arg in element_args:\n        paths = parse_element_arg(model, element_arg, relative_path)\n        element_paths.extend(paths)\n\n    return element_paths\n</code></pre>"},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils.split_is_too_fine","title":"<code>split_is_too_fine(split_paths, model_obj)</code>","text":"<p>Determine if the element path list goes too fine, e.g. individual strings.</p> Source code in <code>trestle/core/commands/common/cmd_utils.py</code> <pre><code>def split_is_too_fine(split_paths: str, model_obj: OscalBaseModel) -&gt; bool:\n    \"\"\"Determine if the element path list goes too fine, e.g. individual strings.\"\"\"\n    for split_path in split_paths.split(','):\n        # find model type one level above if finishing with '.*'\n        model_type = ElementPath(split_path.rstrip('.*')).get_type(type(model_obj))\n        if model_type_is_too_granular(model_type):\n            return True\n    return False\n</code></pre>"},{"location":"reference/API/trestle/core/commands/common/cmd_utils/#trestle.core.commands.common.cmd_utils.to_model_file_name","title":"<code>to_model_file_name(model_obj, file_prefix, content_type)</code>","text":"<p>Return the file name for the item.</p> Source code in <code>trestle/core/commands/common/cmd_utils.py</code> <pre><code>def to_model_file_name(model_obj: OscalBaseModel, file_prefix: str, content_type: FileContentType) -&gt; str:\n    \"\"\"Return the file name for the item.\"\"\"\n    file_ext = FileContentType.to_file_extension(content_type)\n    model_type = classname_to_alias(type(model_obj).__name__, AliasMode.JSON)\n    file_name = f'{file_prefix}{const.IDX_SEP}{model_type}{file_ext}'\n    return file_name\n</code></pre>"},{"location":"reference/API/trestle/core/commands/common/return_codes/","title":"trestle.core.commands.common.return_codes","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes","title":"<code>trestle.core.commands.common.return_codes</code>","text":"<p>Trestle command return codes.</p>"},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes","title":"<code>CmdReturnCodes</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Trestle CLI return codes.</p> <p>SUCCESS - Operation/validation completed successfully COMMAND_ERROR - Generic expected error while executing command (handled by command) INCORRECT_ARGS - Provided arguments were incorrect/incomplete DOCUMENTS_VALIDATION_ERROR - Validation of the markdown or drawio files failed MODEL_VALIDATION_ERROR - Validation of OSCAL model failed TRESTLE_ROOT_ERROR - Workspace setup has failed, the root is not trestle directory IO_ERROR - IO related errors, i.e. permission issue, non-existing file, etc AUTH_ERROR - Authenication error while accessing/storing cache UNKNOWN_ERROR - Unexpected error (unhandled by command) INVALID_MODEL - Loaded model is invalid</p> Source code in <code>trestle/core/commands/common/return_codes.py</code> <pre><code>class CmdReturnCodes(enum.Enum):\n    \"\"\"\n    Trestle CLI return codes.\n\n    SUCCESS - Operation/validation completed successfully\n    COMMAND_ERROR - Generic expected error while executing command (handled by command)\n    INCORRECT_ARGS - Provided arguments were incorrect/incomplete\n    DOCUMENTS_VALIDATION_ERROR - Validation of the markdown or drawio files failed\n    MODEL_VALIDATION_ERROR - Validation of OSCAL model failed\n    TRESTLE_ROOT_ERROR - Workspace setup has failed, the root is not trestle directory\n    IO_ERROR - IO related errors, i.e. permission issue, non-existing file, etc\n    AUTH_ERROR - Authenication error while accessing/storing cache\n    UNKNOWN_ERROR - Unexpected error (unhandled by command)\n    INVALID_MODEL - Loaded model is invalid\n    \"\"\"\n\n    SUCCESS = 0\n    COMMAND_ERROR = 1\n    INCORRECT_ARGS = 2\n    DOCUMENTS_VALIDATION_ERROR = 3\n    OSCAL_VALIDATION_ERROR = 4\n    TRESTLE_ROOT_ERROR = 5\n    IO_ERROR = 6\n    AUTH_ERROR = 7\n    UNKNOWN_ERROR = 8\n</code></pre>"},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes.AUTH_ERROR","title":"<code>AUTH_ERROR = 7</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes.COMMAND_ERROR","title":"<code>COMMAND_ERROR = 1</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes.DOCUMENTS_VALIDATION_ERROR","title":"<code>DOCUMENTS_VALIDATION_ERROR = 3</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes.INCORRECT_ARGS","title":"<code>INCORRECT_ARGS = 2</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes.IO_ERROR","title":"<code>IO_ERROR = 6</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes.OSCAL_VALIDATION_ERROR","title":"<code>OSCAL_VALIDATION_ERROR = 4</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes.SUCCESS","title":"<code>SUCCESS = 0</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes.TRESTLE_ROOT_ERROR","title":"<code>TRESTLE_ROOT_ERROR = 5</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/commands/common/return_codes/#trestle.core.commands.common.return_codes.CmdReturnCodes.UNKNOWN_ERROR","title":"<code>UNKNOWN_ERROR = 8</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/bycomp_interface/","title":"trestle.core.crm.bycomp_interface","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface","title":"<code>trestle.core.crm.bycomp_interface</code>","text":"<p>Provide interface to by-component allowing queries and operations for exports/inheritance statements.</p>"},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface.ByComponentInterface","title":"<code>ByComponentInterface</code>","text":"<p>Interface to query and modify by-component assembly inheritance contents.</p> <p>The by-component is contained in two separate forms:  As an actual OSCAL by-component assembly, and multiple dicts providing direct lookup of inheritance statement by uuid.</p> <p>The dicts are created by the ByComponentInterface constructor, parsed and the responsibility and provided statements are separated into three catagories:</p> <p>isolated responsibilities - A responsibility with no provided statement isolated provided - A provided statement with no referring responsibility statements export set - A set with a single responsibility and referred provided statement</p> <p>For updating ByComponent inheritance and satisfied statements, the interface provides a method to reconcile the the by-component assembly and merge input inherited and satisfied statements.</p> Source code in <code>trestle/core/crm/bycomp_interface.py</code> <pre><code>class ByComponentInterface:\n    \"\"\"\n    Interface to query and modify by-component assembly inheritance contents.\n\n    The by-component is contained in two separate forms:  As an actual OSCAL by-component assembly,\n    and multiple dicts providing direct lookup of inheritance statement by uuid.\n\n    The dicts are created by the ByComponentInterface constructor, parsed and the responsibility and provided statements\n    are separated into three catagories:\n\n    isolated responsibilities - A responsibility with no provided statement\n    isolated provided - A provided statement with no referring responsibility statements\n    export set - A set with a single responsibility and referred provided statement\n\n    For updating ByComponent inheritance and satisfied statements, the interface provides a method to reconcile the\n    the by-component assembly and merge input inherited and satisfied statements.\n    \"\"\"\n\n    def __init__(self, by_comp: ossp.ByComponent):\n        \"\"\"Initialize export writer for a single by-component assembly.\"\"\"\n        self._by_comp: ossp.ByComponent = by_comp\n\n        self._provided_dict: Dict[str, ossp.Provided] = {}\n        self._responsibility_dict: Dict[str, ossp.Responsibility] = {}\n        self._responsibility_by_provided: Dict[str, List[ossp.Responsibility]] = {}\n\n        self._inherited_dict: Dict[str, ossp.Inherited] = self._create_inherited_dict()\n        self._satisfied_dict: Dict[str, ossp.Satisfied] = self._create_satisfied_dict()\n\n        if by_comp.export:\n            self._provided_dict = self._create_provided_dict()\n            self._responsibility_dict = self._create_responsibility_dict()\n            self._responsibility_by_provided = self._create_responsibility_by_provided_dict()\n\n    def _create_provided_dict(self) -&gt; Dict[str, ossp.Provided]:\n        provided_dict: Dict[str, ossp.Provided] = {}\n        for provided in as_list(self._by_comp.export.provided):\n            provided_dict[provided.uuid] = provided\n        return provided_dict\n\n    def _create_responsibility_dict(self) -&gt; Dict[str, ossp.Responsibility]:\n        responsibility_dict: Dict[str, ossp.Responsibility] = {}\n        for responsibility in as_list(self._by_comp.export.responsibilities):\n            responsibility_dict[responsibility.uuid] = responsibility\n        return responsibility_dict\n\n    def _create_responsibility_by_provided_dict(self) -&gt; Dict[str, List[ossp.Responsibility]]:\n        responsibility_by_provided: Dict[str, List[ossp.Responsibility]] = {}\n        for responsibility in as_list(self._by_comp.export.responsibilities):\n            if responsibility.provided_uuid is None:\n                continue\n            if responsibility.provided_uuid not in responsibility_by_provided:\n                responsibility_by_provided[responsibility.provided_uuid] = [responsibility]\n            else:\n                existing_list: List[ossp.Responsibility] = responsibility_by_provided[responsibility.provided_uuid]\n                existing_list.append(responsibility)\n        return responsibility_by_provided\n\n    def _create_inherited_dict(self) -&gt; Dict[str, ossp.Inherited]:\n        inherited_dict: Dict[str, ossp.Inherited] = {}\n        for inherited in as_list(self._by_comp.inherited):\n            inherited_dict[str(inherited.provided_uuid)] = inherited\n        return inherited_dict\n\n    def _create_satisfied_dict(self) -&gt; Dict[str, ossp.Satisfied]:\n        satisfied_dict: Dict[str, ossp.Satisfied] = {}\n        for satisfied in as_list(self._by_comp.satisfied):\n            satisfied_dict[str(satisfied.responsibility_uuid)] = satisfied\n        return satisfied_dict\n\n    def get_isolated_responsibilities(self) -&gt; List[ossp.Responsibility]:\n        \"\"\"Return all isolated exported responsibilities.\"\"\"\n        all_responsibilities: List[ossp.Responsibility] = []\n        for resp in as_dict(self._responsibility_dict).values():\n            if resp.provided_uuid is None:\n                all_responsibilities.append(resp)\n        return all_responsibilities\n\n    def get_isolated_provided(self) -&gt; List[ossp.Provided]:\n        \"\"\"Return all isolated exported provided capabilities.\"\"\"\n        all_provided: List[ossp.Provided] = []\n        for provided in as_dict(self._provided_dict).values():\n            if not self._provided_has_responsibilities(provided.uuid):\n                all_provided.append(provided)\n        return all_provided\n\n    def get_export_sets(self) -&gt; List[Tuple[ossp.Responsibility, ossp.Provided]]:\n        \"\"\"Return a dictionary of every responsibility relationship with provided.\"\"\"\n        all_export_sets: List[Tuple[ossp.Responsibility, ossp.Provided]] = []\n        for provided_uuid, responsibilities in as_dict(self._responsibility_by_provided).items():\n\n            # Ensure the provided object exists in the dictionary.\n            # If it doesn't this is a bug.\n            if provided_uuid not in self._provided_dict:\n                raise TrestleError(f'Provided capability {provided_uuid} not found')\n            provided: ossp.Provided = self._provided_dict[provided_uuid]\n\n            for responsibility in responsibilities:\n                shared_responsibility: Tuple[ossp.Responsibility, ossp.Provided] = (responsibility, provided)\n                all_export_sets.append(shared_responsibility)\n        return all_export_sets\n\n    def reconcile_inheritance_by_component(\n        self, incoming_inherited: List[ossp.Inherited], incoming_satisfied: List[ossp.Satisfied]\n    ) -&gt; ossp.ByComponent:\n        \"\"\"\n        Reconcile the inherited and satisfied statements in the by-component assembly with changes from the export.\n\n        Notes:\n            A statement is determined as existing if the provided uuid or responsibility uuid is in the existing\n            by-component assembly. If existing, the description will be updated if it has changed.\n\n            Any existing inherited or satisfied statements that are not in the incoming export will be removed.\n            If a statement is in the incoming export, but not in the existing by-component assembly, it will be added.\n        \"\"\"\n        new_inherited: List[ossp.Inherited] = []\n        new_satisfied: List[ossp.Satisfied] = []\n\n        # Create a copy of the input by-component assembly to reconcile and return\n        new_by_comp: ossp.ByComponent = copy.deepcopy(self._by_comp)\n\n        for statement in incoming_inherited:\n            if statement.provided_uuid in self._inherited_dict:\n                existing_statement = self._inherited_dict[str(statement.provided_uuid)]\n                # Update the description if it has changed\n                existing_statement.description = statement.description\n                statement = existing_statement\n            new_inherited.append(statement)\n\n        new_by_comp.inherited = none_if_empty(new_inherited)\n\n        for statement in incoming_satisfied:\n            if statement.responsibility_uuid in self._satisfied_dict:\n                existing_statement = self._satisfied_dict[str(statement.responsibility_uuid)]\n                # Update the description if it has changed\n                existing_statement.description = statement.description\n                statement = existing_statement\n            new_satisfied.append(statement)\n\n        new_by_comp.satisfied = none_if_empty(new_satisfied)\n\n        return new_by_comp\n\n    def _provided_has_responsibilities(self, provided_uuid: str) -&gt; bool:\n        \"\"\"Return whether a provided UUID has responsibilities.\"\"\"\n        return provided_uuid in self._responsibility_by_provided\n</code></pre>"},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface.ByComponentInterface-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface.ByComponentInterface.__init__","title":"<code>__init__(by_comp)</code>","text":"<p>Initialize export writer for a single by-component assembly.</p> Source code in <code>trestle/core/crm/bycomp_interface.py</code> <pre><code>def __init__(self, by_comp: ossp.ByComponent):\n    \"\"\"Initialize export writer for a single by-component assembly.\"\"\"\n    self._by_comp: ossp.ByComponent = by_comp\n\n    self._provided_dict: Dict[str, ossp.Provided] = {}\n    self._responsibility_dict: Dict[str, ossp.Responsibility] = {}\n    self._responsibility_by_provided: Dict[str, List[ossp.Responsibility]] = {}\n\n    self._inherited_dict: Dict[str, ossp.Inherited] = self._create_inherited_dict()\n    self._satisfied_dict: Dict[str, ossp.Satisfied] = self._create_satisfied_dict()\n\n    if by_comp.export:\n        self._provided_dict = self._create_provided_dict()\n        self._responsibility_dict = self._create_responsibility_dict()\n        self._responsibility_by_provided = self._create_responsibility_by_provided_dict()\n</code></pre>"},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface.ByComponentInterface.get_export_sets","title":"<code>get_export_sets()</code>","text":"<p>Return a dictionary of every responsibility relationship with provided.</p> Source code in <code>trestle/core/crm/bycomp_interface.py</code> <pre><code>def get_export_sets(self) -&gt; List[Tuple[ossp.Responsibility, ossp.Provided]]:\n    \"\"\"Return a dictionary of every responsibility relationship with provided.\"\"\"\n    all_export_sets: List[Tuple[ossp.Responsibility, ossp.Provided]] = []\n    for provided_uuid, responsibilities in as_dict(self._responsibility_by_provided).items():\n\n        # Ensure the provided object exists in the dictionary.\n        # If it doesn't this is a bug.\n        if provided_uuid not in self._provided_dict:\n            raise TrestleError(f'Provided capability {provided_uuid} not found')\n        provided: ossp.Provided = self._provided_dict[provided_uuid]\n\n        for responsibility in responsibilities:\n            shared_responsibility: Tuple[ossp.Responsibility, ossp.Provided] = (responsibility, provided)\n            all_export_sets.append(shared_responsibility)\n    return all_export_sets\n</code></pre>"},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_provided","title":"<code>get_isolated_provided()</code>","text":"<p>Return all isolated exported provided capabilities.</p> Source code in <code>trestle/core/crm/bycomp_interface.py</code> <pre><code>def get_isolated_provided(self) -&gt; List[ossp.Provided]:\n    \"\"\"Return all isolated exported provided capabilities.\"\"\"\n    all_provided: List[ossp.Provided] = []\n    for provided in as_dict(self._provided_dict).values():\n        if not self._provided_has_responsibilities(provided.uuid):\n            all_provided.append(provided)\n    return all_provided\n</code></pre>"},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface.ByComponentInterface.get_isolated_responsibilities","title":"<code>get_isolated_responsibilities()</code>","text":"<p>Return all isolated exported responsibilities.</p> Source code in <code>trestle/core/crm/bycomp_interface.py</code> <pre><code>def get_isolated_responsibilities(self) -&gt; List[ossp.Responsibility]:\n    \"\"\"Return all isolated exported responsibilities.\"\"\"\n    all_responsibilities: List[ossp.Responsibility] = []\n    for resp in as_dict(self._responsibility_dict).values():\n        if resp.provided_uuid is None:\n            all_responsibilities.append(resp)\n    return all_responsibilities\n</code></pre>"},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface.ByComponentInterface.reconcile_inheritance_by_component","title":"<code>reconcile_inheritance_by_component(incoming_inherited, incoming_satisfied)</code>","text":"<p>Reconcile the inherited and satisfied statements in the by-component assembly with changes from the export.</p> Notes <p>A statement is determined as existing if the provided uuid or responsibility uuid is in the existing by-component assembly. If existing, the description will be updated if it has changed.</p> <p>Any existing inherited or satisfied statements that are not in the incoming export will be removed. If a statement is in the incoming export, but not in the existing by-component assembly, it will be added.</p> Source code in <code>trestle/core/crm/bycomp_interface.py</code> <pre><code>def reconcile_inheritance_by_component(\n    self, incoming_inherited: List[ossp.Inherited], incoming_satisfied: List[ossp.Satisfied]\n) -&gt; ossp.ByComponent:\n    \"\"\"\n    Reconcile the inherited and satisfied statements in the by-component assembly with changes from the export.\n\n    Notes:\n        A statement is determined as existing if the provided uuid or responsibility uuid is in the existing\n        by-component assembly. If existing, the description will be updated if it has changed.\n\n        Any existing inherited or satisfied statements that are not in the incoming export will be removed.\n        If a statement is in the incoming export, but not in the existing by-component assembly, it will be added.\n    \"\"\"\n    new_inherited: List[ossp.Inherited] = []\n    new_satisfied: List[ossp.Satisfied] = []\n\n    # Create a copy of the input by-component assembly to reconcile and return\n    new_by_comp: ossp.ByComponent = copy.deepcopy(self._by_comp)\n\n    for statement in incoming_inherited:\n        if statement.provided_uuid in self._inherited_dict:\n            existing_statement = self._inherited_dict[str(statement.provided_uuid)]\n            # Update the description if it has changed\n            existing_statement.description = statement.description\n            statement = existing_statement\n        new_inherited.append(statement)\n\n    new_by_comp.inherited = none_if_empty(new_inherited)\n\n    for statement in incoming_satisfied:\n        if statement.responsibility_uuid in self._satisfied_dict:\n            existing_statement = self._satisfied_dict[str(statement.responsibility_uuid)]\n            # Update the description if it has changed\n            existing_statement.description = statement.description\n            statement = existing_statement\n        new_satisfied.append(statement)\n\n    new_by_comp.satisfied = none_if_empty(new_satisfied)\n\n    return new_by_comp\n</code></pre>"},{"location":"reference/API/trestle/core/crm/bycomp_interface/#trestle.core.crm.bycomp_interface-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/export_reader/","title":"trestle.core.crm.export_reader","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader","title":"<code>trestle.core.crm.export_reader</code>","text":"<p>Provided interface to read inheritance statements from Markdown.</p>"},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader.ByComponentDict","title":"<code>ByComponentDict = Dict[str, Tuple[List[ossp.Inherited], List[ossp.Satisfied]]]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader.InheritanceViewDict","title":"<code>InheritanceViewDict = Dict[str, ByComponentDict]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader.ExportReader","title":"<code>ExportReader</code>","text":"<p>By-Component Assembly Exports Markdown reader.</p> <p>Export reader handles all operations related to reading authored inherited and satisfied statements from exports in Markdown. The reader will read all the markdown files in the exports directory and update the SSP with the inheritance.</p> Source code in <code>trestle/core/crm/export_reader.py</code> <pre><code>class ExportReader:\n    \"\"\"\n    By-Component Assembly Exports Markdown reader.\n\n    Export reader handles all operations related to reading authored inherited and satisfied statements from exports\n    in Markdown. The reader will read all the markdown files in the exports directory and update the SSP with the\n    inheritance.\n    \"\"\"\n\n    def __init__(self, root_path: pathlib.Path, ssp: ossp.SystemSecurityPlan):\n        \"\"\"\n        Initialize export reader.\n\n        Arguments:\n            root_path: A root path object where an SSP's inheritance markdown is located.\n            ssp: A system security plan object that will be updated with the inheritance information.\n\n        Notes:\n            The mapped components list is used to track which components have been mapped to controls in the markdown.\n            It can be retrieved with the get_leveraged_components method. This will be empty until the\n            read_exports_from_markdown method is called.\n        \"\"\"\n        self._ssp: ossp.SystemSecurityPlan = ssp\n\n        # Create a dictionary of implemented requirements keyed by control id for merging operations\n        self._implemented_requirements: Dict[str, ossp.ImplementedRequirement] = self._create_impl_req_dict()\n\n        # List of component titles that have been mapped to controls in the Markdown\n        self._mapped_components: List[str] = []\n\n        self._root_path: pathlib.Path = root_path\n\n    def _create_impl_req_dict(self) -&gt; Dict[str, ossp.ImplementedRequirement]:\n        \"\"\"Create a dictionary of implemented requirements keyed by control id.\"\"\"\n        impl_req_dict: Dict[str, ossp.ImplementedRequirement] = {}\n        for impl_req in as_list(self._ssp.control_implementation.implemented_requirements):\n            impl_req_dict[impl_req.control_id] = impl_req\n        return impl_req_dict\n\n    def read_exports_from_markdown(self) -&gt; ossp.SystemSecurityPlan:\n        \"\"\"Read inheritance markdown and update the SSP with the inheritance information.\"\"\"\n        # Read the information from the markdown files into a dictionary for quick lookup\n        markdown_dict: InheritanceViewDict = self._read_inheritance_markdown_directory()\n\n        # Merge the markdown information into existing the implemented requirements\n        self._merge_exports_implemented_requirements(markdown_dict)\n\n        # Process remaining markdown information that was not in the implemented requirements\n        for control_id, by_comp_dict in markdown_dict.items():\n            if by_comp_dict:\n                logging.debug(f'Adding control mapping {control_id} to implemented requirements')\n                self._add_control_mappings_to_implemented_requirements(control_id, by_comp_dict)\n\n        self._ssp.control_implementation.implemented_requirements = list(self._implemented_requirements.values())\n        return self._ssp\n\n    def get_leveraged_ssp_href(self) -&gt; str:\n        \"\"\"Get the href of the leveraged SSP from a markdown file.\"\"\"\n        comp_dirs = os.listdir(self._root_path)\n        if len(comp_dirs) == 0:\n            raise TrestleError('No components were found in the markdown.')\n\n        control_dirs = os.listdir(self._root_path.joinpath(comp_dirs[0]))\n        if len(control_dirs) == 0:\n            raise TrestleError('No controls were found in the markdown for component {comp_dirs[0]}.')\n\n        control_dir = self._root_path.joinpath(comp_dirs[0], control_dirs[0])\n\n        files = [f for f in os.listdir(control_dir) if os.path.isfile(os.path.join(control_dir, f))]\n        if len(files) == 0:\n            raise TrestleError(f'No files were found in the markdown for control {control_dirs[0]}.')\n\n        markdown_file_path = control_dir.joinpath(files[0])\n        reader = InheritanceMarkdownReader(markdown_file_path)\n        return reader.get_leveraged_ssp_reference()\n\n    def get_leveraged_components(self) -&gt; List[str]:\n        \"\"\"Get a list of component titles that have been mapped to controls in the Markdown.\"\"\"\n        return self._mapped_components\n\n    def _merge_exports_implemented_requirements(self, markdown_dict: InheritanceViewDict) -&gt; None:\n        \"\"\"Merge all exported inheritance info from the markdown into the implemented requirement dict.\"\"\"\n        for implemented_requirement in self._implemented_requirements.values():\n\n            # If the control id existing in the markdown, then update the by_components\n            if implemented_requirement.control_id in markdown_dict:\n\n                # Delete the entry from the markdown_dict once processed to avoid duplicates\n                by_comp_dict: ByComponentDict = markdown_dict.pop(implemented_requirement.control_id)\n\n                self._update_type_with_by_comp(implemented_requirement, by_comp_dict)\n\n            # Update any implemented requirements statements assemblies\n            new_statements: List[ossp.Statement] = []\n\n            for stm in as_list(implemented_requirement.statements):\n                statement_id = getattr(stm, 'statement_id', f'{implemented_requirement.control_id}_smt')\n\n                # If the statement id existing in the markdown, then update the by_components\n                if statement_id in markdown_dict:\n\n                    # Delete the entry from the markdown_dict once processed to avoid duplicates\n                    by_comp_dict: ByComponentDict = markdown_dict.pop(statement_id)\n\n                    self._update_type_with_by_comp(stm, by_comp_dict)\n\n                new_statements.append(stm)\n\n            implemented_requirement.statements = none_if_empty(new_statements)\n\n    def _update_type_with_by_comp(self, with_bycomp: TypeWithByComps, by_comp_dict: ByComponentDict) -&gt; None:\n        \"\"\"Update the by_components for a type with by_components.\"\"\"\n        new_by_comp: List[ossp.ByComponent] = []\n\n        by_comp: ossp.ByComponent\n        comp_inheritance_info: Tuple[List[ossp.Inherited], List[ossp.Satisfied]]\n        for by_comp in as_list(with_bycomp.by_components):\n\n            # If the by_component uuid exists in the by_comp_dict, then update it\n            # If not, clear the by_component inheritance information\n            comp_inheritance_info = by_comp_dict.pop(by_comp.component_uuid, ([], []))\n\n            bycomp_interface = ByComponentInterface(by_comp)\n            by_comp = bycomp_interface.reconcile_inheritance_by_component(\n                comp_inheritance_info[0], comp_inheritance_info[1]\n            )\n\n            new_by_comp.append(by_comp)\n\n        # Add any new by_components that were not in the original statement\n        new_by_comp.extend(ExportReader._add_new_by_comps(by_comp_dict))\n        with_bycomp.by_components = none_if_empty(new_by_comp)\n\n    def _add_control_mappings_to_implemented_requirements(\n        self, control_mapping: str, by_comps: ByComponentDict\n    ) -&gt; None:\n        \"\"\"Add control mappings to implemented requirements.\"\"\"\n        # Determine if the control id is actually a statement id\n        if '_smt.' in control_mapping:\n            control_id = control_mapping.split('_smt')[0]\n            implemented_req = self._add_or_get_implemented_requirement(control_id)\n            statement = gens.generate_sample_model(ossp.Statement)\n            statement.statement_id = control_mapping\n            statement.by_components = ExportReader._add_new_by_comps(by_comps)\n            implemented_req.statements = as_list(implemented_req.statements)\n            implemented_req.statements.append(statement)\n            implemented_req.statements = sorted(implemented_req.statements, key=lambda x: x.statement_id)\n        else:\n            implemented_req = self._add_or_get_implemented_requirement(control_mapping)\n            implemented_req.by_components = as_list(implemented_req.by_components)\n            implemented_req.by_components.extend(ExportReader._add_new_by_comps(by_comps))\n\n    def _add_or_get_implemented_requirement(self, control_id: str) -&gt; ossp.ImplementedRequirement:\n        \"\"\"Add or get implemented requirement from implemented requirements dictionary.\"\"\"\n        if control_id in self._implemented_requirements:\n            return self._implemented_requirements[control_id]\n\n        implemented_requirement = gens.generate_sample_model(ossp.ImplementedRequirement)\n        implemented_requirement.control_id = control_id\n        self._implemented_requirements[control_id] = implemented_requirement\n        return implemented_requirement\n\n    @staticmethod\n    def _add_new_by_comps(by_comp_dict: ByComponentDict) -&gt; List[ossp.ByComponent]:\n        \"\"\"Add new by_components to the implemented requirement.\"\"\"\n        new_by_comp: List[ossp.ByComponent] = []\n        for comp_uuid, inheritance_info in by_comp_dict.items():\n            by_comp: ossp.ByComponent = gens.generate_sample_model(ossp.ByComponent)\n            by_comp.component_uuid = comp_uuid\n            by_comp.inherited = none_if_empty(inheritance_info[0])\n            by_comp.satisfied = none_if_empty(inheritance_info[1])\n            new_by_comp.append(by_comp)\n        return new_by_comp\n\n    def _read_inheritance_markdown_directory(self) -&gt; InheritanceViewDict:\n        \"\"\"Read all inheritance markdown files and return a dictionary of all the information.\"\"\"\n        markdown_dict: InheritanceViewDict = {}\n\n        # Creating a dictionary to find the component uuid by title for faster lookup\n        uuid_by_title: Dict[str, str] = {}\n        for component in as_list(self._ssp.system_implementation.components):\n            uuid_by_title[component.title] = component.uuid\n\n        for comp_dir in os.listdir(self._root_path):\n            is_comp_leveraged = False\n            for control_dir in os.listdir(os.path.join(self._root_path, comp_dir)):\n                control_dir_path = os.path.join(self._root_path, comp_dir, control_dir)\n\n                # Initialize the by_component dictionary for the control directory\n                # If it exists in the markdown dictionary, then update it with the new information\n                by_comp_dict = markdown_dict.get(control_dir, {})\n\n                for file in os.listdir(control_dir_path):\n                    file_path = pathlib.Path(control_dir_path).joinpath(file)\n                    reader = InheritanceMarkdownReader(file_path)\n                    leveraged_info = reader.process_leveraged_statement_markdown()\n\n                    # If there is no leveraged information, then skip this file\n                    if leveraged_info is None:\n                        continue\n\n                    # If a file has leveraged information, then set the flag to indicate the component is leveraged\n                    is_comp_leveraged = True\n\n                    for comp in leveraged_info.leveraging_comp_titles:\n                        if comp not in uuid_by_title:\n                            keys_as_string = ', '.join(uuid_by_title.keys())\n                            raise TrestleError(\n                                f'Component \"{comp}\" does not exist in the {self._ssp.metadata.title} SSP. '\n                                f'Please use options: {keys_as_string}.'\n                            )\n\n                        comp_uuid = uuid_by_title[comp]\n                        inherited, satisfied = by_comp_dict.get(comp_uuid, ([], []))\n\n                        if leveraged_info.inherited is not None:\n                            inherited.append(leveraged_info.inherited)\n                        if leveraged_info.satisfied is not None:\n                            satisfied.append(leveraged_info.satisfied)\n\n                        by_comp_dict[comp_uuid] = (inherited, satisfied)\n\n                markdown_dict[control_dir] = by_comp_dict\n\n            if is_comp_leveraged:\n                self._mapped_components.append(comp_dir)\n\n        return markdown_dict\n</code></pre>"},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader.ExportReader-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader.ExportReader.__init__","title":"<code>__init__(root_path, ssp)</code>","text":"<p>Initialize export reader.</p> <p>Parameters:</p> Name Type Description Default <code>root_path</code> <code>Path</code> <p>A root path object where an SSP's inheritance markdown is located.</p> required <code>ssp</code> <code>SystemSecurityPlan</code> <p>A system security plan object that will be updated with the inheritance information.</p> required Notes <p>The mapped components list is used to track which components have been mapped to controls in the markdown. It can be retrieved with the get_leveraged_components method. This will be empty until the read_exports_from_markdown method is called.</p> Source code in <code>trestle/core/crm/export_reader.py</code> <pre><code>def __init__(self, root_path: pathlib.Path, ssp: ossp.SystemSecurityPlan):\n    \"\"\"\n    Initialize export reader.\n\n    Arguments:\n        root_path: A root path object where an SSP's inheritance markdown is located.\n        ssp: A system security plan object that will be updated with the inheritance information.\n\n    Notes:\n        The mapped components list is used to track which components have been mapped to controls in the markdown.\n        It can be retrieved with the get_leveraged_components method. This will be empty until the\n        read_exports_from_markdown method is called.\n    \"\"\"\n    self._ssp: ossp.SystemSecurityPlan = ssp\n\n    # Create a dictionary of implemented requirements keyed by control id for merging operations\n    self._implemented_requirements: Dict[str, ossp.ImplementedRequirement] = self._create_impl_req_dict()\n\n    # List of component titles that have been mapped to controls in the Markdown\n    self._mapped_components: List[str] = []\n\n    self._root_path: pathlib.Path = root_path\n</code></pre>"},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader.ExportReader.get_leveraged_components","title":"<code>get_leveraged_components()</code>","text":"<p>Get a list of component titles that have been mapped to controls in the Markdown.</p> Source code in <code>trestle/core/crm/export_reader.py</code> <pre><code>def get_leveraged_components(self) -&gt; List[str]:\n    \"\"\"Get a list of component titles that have been mapped to controls in the Markdown.\"\"\"\n    return self._mapped_components\n</code></pre>"},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader.ExportReader.get_leveraged_ssp_href","title":"<code>get_leveraged_ssp_href()</code>","text":"<p>Get the href of the leveraged SSP from a markdown file.</p> Source code in <code>trestle/core/crm/export_reader.py</code> <pre><code>def get_leveraged_ssp_href(self) -&gt; str:\n    \"\"\"Get the href of the leveraged SSP from a markdown file.\"\"\"\n    comp_dirs = os.listdir(self._root_path)\n    if len(comp_dirs) == 0:\n        raise TrestleError('No components were found in the markdown.')\n\n    control_dirs = os.listdir(self._root_path.joinpath(comp_dirs[0]))\n    if len(control_dirs) == 0:\n        raise TrestleError('No controls were found in the markdown for component {comp_dirs[0]}.')\n\n    control_dir = self._root_path.joinpath(comp_dirs[0], control_dirs[0])\n\n    files = [f for f in os.listdir(control_dir) if os.path.isfile(os.path.join(control_dir, f))]\n    if len(files) == 0:\n        raise TrestleError(f'No files were found in the markdown for control {control_dirs[0]}.')\n\n    markdown_file_path = control_dir.joinpath(files[0])\n    reader = InheritanceMarkdownReader(markdown_file_path)\n    return reader.get_leveraged_ssp_reference()\n</code></pre>"},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader.ExportReader.read_exports_from_markdown","title":"<code>read_exports_from_markdown()</code>","text":"<p>Read inheritance markdown and update the SSP with the inheritance information.</p> Source code in <code>trestle/core/crm/export_reader.py</code> <pre><code>def read_exports_from_markdown(self) -&gt; ossp.SystemSecurityPlan:\n    \"\"\"Read inheritance markdown and update the SSP with the inheritance information.\"\"\"\n    # Read the information from the markdown files into a dictionary for quick lookup\n    markdown_dict: InheritanceViewDict = self._read_inheritance_markdown_directory()\n\n    # Merge the markdown information into existing the implemented requirements\n    self._merge_exports_implemented_requirements(markdown_dict)\n\n    # Process remaining markdown information that was not in the implemented requirements\n    for control_id, by_comp_dict in markdown_dict.items():\n        if by_comp_dict:\n            logging.debug(f'Adding control mapping {control_id} to implemented requirements')\n            self._add_control_mappings_to_implemented_requirements(control_id, by_comp_dict)\n\n    self._ssp.control_implementation.implemented_requirements = list(self._implemented_requirements.values())\n    return self._ssp\n</code></pre>"},{"location":"reference/API/trestle/core/crm/export_reader/#trestle.core.crm.export_reader-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/export_writer/","title":"trestle.core.crm.export_writer","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/crm/export_writer/#trestle.core.crm.export_writer","title":"<code>trestle.core.crm.export_writer</code>","text":"<p>Provided interface to write provided and responsibility exports statements to Markdown.</p>"},{"location":"reference/API/trestle/core/crm/export_writer/#trestle.core.crm.export_writer-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/export_writer/#trestle.core.crm.export_writer.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/export_writer/#trestle.core.crm.export_writer-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/crm/export_writer/#trestle.core.crm.export_writer.ExportWriter","title":"<code>ExportWriter</code>","text":"<p>By-Component Assembly Exports writer.</p> <p>Export writer handles all operations related to writing provided and responsibility exported statements to Markdown.</p> Source code in <code>trestle/core/crm/export_writer.py</code> <pre><code>class ExportWriter:\n    \"\"\"\n    By-Component Assembly Exports writer.\n\n    Export writer handles all operations related to writing provided and responsibility exported statements\n    to Markdown.\n    \"\"\"\n\n    def __init__(self, root_path: pathlib.Path, ssp: ossp.SystemSecurityPlan, leveraged_ssp_href: str):\n        \"\"\"\n        Initialize export writer.\n\n        Arguments:\n            root_path: A root path object where all markdown files and directories should be written.\n            ssp: A system security plan with exports\n        \"\"\"\n        self._ssp: ossp.SystemSecurityPlan = ssp\n        self._root_path: pathlib.Path = root_path\n        self._leveraged_ssp_href: str = leveraged_ssp_href\n\n        # Find all the components and create paths for name\n        self._paths_by_comp: Dict[str, pathlib.Path] = {}\n        for component in as_list(self._ssp.system_implementation.components):\n            self._paths_by_comp[component.uuid] = self._root_path.joinpath(component.title)\n\n    def write_exports_as_markdown(self) -&gt; None:\n        \"\"\"Write export statement for leveraged SSP as the inheritance Markdown view.\"\"\"\n        # Process all information under exports in control implementation\n        for implemented_requirement in as_list(self._ssp.control_implementation.implemented_requirements):\n            for by_comp in as_list(implemented_requirement.by_components):\n                self._process_by_component(by_comp, implemented_requirement.control_id)\n\n            for stm in as_list(implemented_requirement.statements):\n                statement_id = getattr(stm, 'statement_id', f'{implemented_requirement.control_id}_smt')\n                for by_comp in as_list(stm.by_components):\n                    self._process_by_component(by_comp, statement_id)\n\n    def _process_by_component(self, by_comp: ossp.ByComponent, control_id: str) -&gt; None:\n        \"\"\"Complete the Markdown writing operations for each by-component assembly.\"\"\"\n        if by_comp.component_uuid not in self._paths_by_comp:\n            raise TrestleError(f'Component id {by_comp.component_uuid} is not in the system implementation')\n\n        comp_path: pathlib.Path = self._paths_by_comp[by_comp.component_uuid]\n\n        export_interface: ByComponentInterface = ByComponentInterface(by_comp=by_comp)\n        leveraged_statements: Dict[str, LeveragedStatements] = self._statement_types_from_exports(export_interface)\n\n        # Only create the directory if leveraged statements exist. If not return.\n        if not leveraged_statements:\n            logger.debug(f'Component {by_comp.component_uuid} has no exports for control {control_id}')\n            return\n\n        control_path: pathlib.Path = comp_path.joinpath(control_id)\n        control_path.mkdir(exist_ok=True, parents=True)\n\n        for statement_file_path, leveraged_stm in leveraged_statements.items():\n            statement_path: pathlib.Path = control_path.joinpath(f'{statement_file_path}{const.MARKDOWN_FILE_EXT}')\n            leveraged_stm.write_statement_md(statement_path)\n\n    def _statement_types_from_exports(self, export_interface: ByComponentInterface) -&gt; Dict[str, LeveragedStatements]:\n        \"\"\"Process all exports and return a file basename and LeveragedStatement object for each.\"\"\"\n        all_statements: Dict[str, LeveragedStatements] = {}\n\n        for responsibility in export_interface.get_isolated_responsibilities():\n            all_statements[responsibility.uuid] = StatementResponsibility(\n                responsibility.uuid, responsibility.description, self._leveraged_ssp_href\n            )\n\n        for provided in export_interface.get_isolated_provided():\n            all_statements[provided.uuid\n                           ] = StatementProvided(provided.uuid, provided.description, self._leveraged_ssp_href)\n\n        for responsibility, provided in export_interface.get_export_sets():\n            path = f'{provided.uuid}_{responsibility.uuid}'\n            all_statements[path] = StatementTree(\n                provided.uuid,\n                provided.description,\n                responsibility.uuid,\n                responsibility.description,\n                self._leveraged_ssp_href\n            )\n\n        return all_statements\n</code></pre>"},{"location":"reference/API/trestle/core/crm/export_writer/#trestle.core.crm.export_writer.ExportWriter-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/export_writer/#trestle.core.crm.export_writer.ExportWriter.__init__","title":"<code>__init__(root_path, ssp, leveraged_ssp_href)</code>","text":"<p>Initialize export writer.</p> <p>Parameters:</p> Name Type Description Default <code>root_path</code> <code>Path</code> <p>A root path object where all markdown files and directories should be written.</p> required <code>ssp</code> <code>SystemSecurityPlan</code> <p>A system security plan with exports</p> required Source code in <code>trestle/core/crm/export_writer.py</code> <pre><code>def __init__(self, root_path: pathlib.Path, ssp: ossp.SystemSecurityPlan, leveraged_ssp_href: str):\n    \"\"\"\n    Initialize export writer.\n\n    Arguments:\n        root_path: A root path object where all markdown files and directories should be written.\n        ssp: A system security plan with exports\n    \"\"\"\n    self._ssp: ossp.SystemSecurityPlan = ssp\n    self._root_path: pathlib.Path = root_path\n    self._leveraged_ssp_href: str = leveraged_ssp_href\n\n    # Find all the components and create paths for name\n    self._paths_by_comp: Dict[str, pathlib.Path] = {}\n    for component in as_list(self._ssp.system_implementation.components):\n        self._paths_by_comp[component.uuid] = self._root_path.joinpath(component.title)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/export_writer/#trestle.core.crm.export_writer.ExportWriter.write_exports_as_markdown","title":"<code>write_exports_as_markdown()</code>","text":"<p>Write export statement for leveraged SSP as the inheritance Markdown view.</p> Source code in <code>trestle/core/crm/export_writer.py</code> <pre><code>def write_exports_as_markdown(self) -&gt; None:\n    \"\"\"Write export statement for leveraged SSP as the inheritance Markdown view.\"\"\"\n    # Process all information under exports in control implementation\n    for implemented_requirement in as_list(self._ssp.control_implementation.implemented_requirements):\n        for by_comp in as_list(implemented_requirement.by_components):\n            self._process_by_component(by_comp, implemented_requirement.control_id)\n\n        for stm in as_list(implemented_requirement.statements):\n            statement_id = getattr(stm, 'statement_id', f'{implemented_requirement.control_id}_smt')\n            for by_comp in as_list(stm.by_components):\n                self._process_by_component(by_comp, statement_id)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/export_writer/#trestle.core.crm.export_writer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/","title":"trestle.core.crm.leveraged_statements","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements","title":"<code>trestle.core.crm.leveraged_statements</code>","text":"<p>Handle writing of inherited statements to markdown.</p>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.component_mapping_default","title":"<code>component_mapping_default: List[Dict[str, str]] = [{'name': const.REPLACE_ME}]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceInfo","title":"<code>InheritanceInfo</code>  <code>dataclass</code>","text":"<p>Class to capture component inheritance information.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>@dataclass\nclass InheritanceInfo:\n    \"\"\"Class to capture component inheritance information.\"\"\"\n\n    leveraging_comp_titles: List[str]\n    inherited: Optional[ssp.Inherited]\n    satisfied: Optional[ssp.Satisfied]\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceInfo-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceInfo.inherited","title":"<code>inherited: Optional[ssp.Inherited]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceInfo.leveraging_comp_titles","title":"<code>leveraging_comp_titles: List[str]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceInfo.satisfied","title":"<code>satisfied: Optional[ssp.Satisfied]</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceInfo-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceInfo.__init__","title":"<code>__init__(leveraging_comp_titles, inherited, satisfied)</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader","title":"<code>InheritanceMarkdownReader</code>","text":"<p>Class to read leveraged statement information from Markdown.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>class InheritanceMarkdownReader:\n    \"\"\"Class to read leveraged statement information from Markdown.\"\"\"\n\n    def __init__(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n        \"\"\"Initialize the class.\"\"\"\n        # Save the file name for logging\n        self._leveraged_statement_file = leveraged_statement_file\n\n        md_api: MarkdownAPI = MarkdownAPI()\n\n        yaml_header, inheritance_md = md_api.processor.process_markdown(leveraged_statement_file)\n        self._yaml_header: Dict[str, Any] = yaml_header\n        self._inheritance_md: DocsMarkdownNode = inheritance_md\n\n    def process_leveraged_statement_markdown(self) -&gt; Optional[InheritanceInfo]:\n        \"\"\"\n        Read inheritance information from Markdown.\n\n        Returns:\n            Optional InheritanceInfo - A list of mapped component titles, an optional satisfied statement and an\n            optional inherited statement\n\n        Notes:\n            Returns inheritance information in the context of the leveraging SSP. If no leveraging component titles are\n            mapped in the yaml header None will be returned. The satisfied and inherited fields are\n            generated and returned to added information to by-component assemblies for\n            the mapped leveraging components.\n\n        \"\"\"\n        leveraging_comps: List[str] = []\n        inherited_statement: Optional[ssp.Inherited] = None\n        satisfied_statement: Optional[ssp.Satisfied] = None\n\n        leveraging_comp_header_value: List[Dict[str, str]] = self._yaml_header[const.TRESTLE_LEVERAGING_COMP_TAG]\n\n        # If there are no mapped components, return early\n        if not leveraging_comp_header_value or leveraging_comp_header_value == component_mapping_default:\n            return None\n        else:\n            for comp_dicts in leveraging_comp_header_value:\n                for comp_title in comp_dicts.values():\n                    leveraging_comps.append(comp_title)\n\n        statement_info: Dict[str, str] = self._yaml_header[const.TRESTLE_STATEMENT_TAG]\n\n        if const.PROVIDED_UUID in statement_info:\n            # Set inherited\n\n            provided_description = self.get_provided_description()\n            if provided_description is None:\n                raise TrestleError(f'Provided statement cannot be empty in {self._leveraged_statement_file}')\n\n            inherited_statement = gens.generate_sample_model(ssp.Inherited)\n\n            inherited_statement.description = provided_description\n            inherited_statement.provided_uuid = statement_info[const.PROVIDED_UUID]\n\n        if const.RESPONSIBILITY_UUID in statement_info:\n            # Set satisfied\n            satisfied_description = self.get_satisfied_description()\n            if satisfied_description is None:\n                raise TrestleError(f'Satisfied statement cannot be empty in {self._leveraged_statement_file}')\n\n            satisfied_statement = gens.generate_sample_model(ssp.Satisfied)\n\n            satisfied_statement.description = satisfied_description\n            satisfied_statement.responsibility_uuid = statement_info[const.RESPONSIBILITY_UUID]\n\n        return InheritanceInfo(leveraging_comps, inherited_statement, satisfied_statement)\n\n    def get_leveraged_ssp_reference(self) -&gt; str:\n        \"\"\"Return the leveraged SSP reference in the yaml header.\"\"\"\n        return self._yaml_header[const.TRESTLE_GLOBAL_TAG][const.LEVERAGED_SSP][const.HREF]\n\n    def get_satisfied_description(self) -&gt; Optional[str]:\n        \"\"\"Return the satisfied description in the Markdown.\"\"\"\n        node = self._inheritance_md.get_node_for_key(const.SATISFIED_STATEMENT_DESCRIPTION, False)\n        if node is not None:\n            return self.strip_heading_and_comments(node.content.raw_text)\n        else:\n            return None\n\n    def get_provided_description(self) -&gt; Optional[str]:\n        \"\"\"Return the provided description in the Markdown.\"\"\"\n        node = self._inheritance_md.get_node_for_key(const.PROVIDED_STATEMENT_DESCRIPTION, False)\n        if node is not None:\n            return self.strip_heading_and_comments(node.content.raw_text)\n        else:\n            return None\n\n    def get_leveraged_component_header_value(self) -&gt; Dict[str, str]:\n        \"\"\"Provide the leveraged component value in the yaml header.\"\"\"\n        return self._yaml_header[const.TRESTLE_LEVERAGING_COMP_TAG]\n\n    @staticmethod\n    def strip_heading_and_comments(markdown_text: str) -&gt; str:\n        \"\"\"Remove the heading and comments from lines to get the multi-line paragraph.\"\"\"\n        lines = markdown_text.split('\\n')\n        non_heading_comment_lines = []\n        inside_heading = False\n        inside_comment = False\n\n        for line in lines:\n            if line.startswith('#'):\n                inside_heading = True\n            elif line.startswith('&lt;!--'):\n                inside_comment = True\n                if line.rstrip().endswith('--&gt;'):\n                    inside_comment = False\n                continue\n            elif line.strip() == '':\n                inside_heading = False\n                inside_comment = False\n\n            if not inside_heading and not inside_comment:\n                non_heading_comment_lines.append(line)\n\n        stripped_markdown = '\\n'.join(non_heading_comment_lines).strip()\n        return stripped_markdown\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.__init__","title":"<code>__init__(leveraged_statement_file)</code>","text":"<p>Initialize the class.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def __init__(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n    \"\"\"Initialize the class.\"\"\"\n    # Save the file name for logging\n    self._leveraged_statement_file = leveraged_statement_file\n\n    md_api: MarkdownAPI = MarkdownAPI()\n\n    yaml_header, inheritance_md = md_api.processor.process_markdown(leveraged_statement_file)\n    self._yaml_header: Dict[str, Any] = yaml_header\n    self._inheritance_md: DocsMarkdownNode = inheritance_md\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_component_header_value","title":"<code>get_leveraged_component_header_value()</code>","text":"<p>Provide the leveraged component value in the yaml header.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def get_leveraged_component_header_value(self) -&gt; Dict[str, str]:\n    \"\"\"Provide the leveraged component value in the yaml header.\"\"\"\n    return self._yaml_header[const.TRESTLE_LEVERAGING_COMP_TAG]\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_leveraged_ssp_reference","title":"<code>get_leveraged_ssp_reference()</code>","text":"<p>Return the leveraged SSP reference in the yaml header.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def get_leveraged_ssp_reference(self) -&gt; str:\n    \"\"\"Return the leveraged SSP reference in the yaml header.\"\"\"\n    return self._yaml_header[const.TRESTLE_GLOBAL_TAG][const.LEVERAGED_SSP][const.HREF]\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_provided_description","title":"<code>get_provided_description()</code>","text":"<p>Return the provided description in the Markdown.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def get_provided_description(self) -&gt; Optional[str]:\n    \"\"\"Return the provided description in the Markdown.\"\"\"\n    node = self._inheritance_md.get_node_for_key(const.PROVIDED_STATEMENT_DESCRIPTION, False)\n    if node is not None:\n        return self.strip_heading_and_comments(node.content.raw_text)\n    else:\n        return None\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.get_satisfied_description","title":"<code>get_satisfied_description()</code>","text":"<p>Return the satisfied description in the Markdown.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def get_satisfied_description(self) -&gt; Optional[str]:\n    \"\"\"Return the satisfied description in the Markdown.\"\"\"\n    node = self._inheritance_md.get_node_for_key(const.SATISFIED_STATEMENT_DESCRIPTION, False)\n    if node is not None:\n        return self.strip_heading_and_comments(node.content.raw_text)\n    else:\n        return None\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.process_leveraged_statement_markdown","title":"<code>process_leveraged_statement_markdown()</code>","text":"<p>Read inheritance information from Markdown.</p> <p>Returns:</p> Type Description <code>Optional[InheritanceInfo]</code> <p>Optional InheritanceInfo - A list of mapped component titles, an optional satisfied statement and an</p> <code>Optional[InheritanceInfo]</code> <p>optional inherited statement</p> Notes <p>Returns inheritance information in the context of the leveraging SSP. If no leveraging component titles are mapped in the yaml header None will be returned. The satisfied and inherited fields are generated and returned to added information to by-component assemblies for the mapped leveraging components.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def process_leveraged_statement_markdown(self) -&gt; Optional[InheritanceInfo]:\n    \"\"\"\n    Read inheritance information from Markdown.\n\n    Returns:\n        Optional InheritanceInfo - A list of mapped component titles, an optional satisfied statement and an\n        optional inherited statement\n\n    Notes:\n        Returns inheritance information in the context of the leveraging SSP. If no leveraging component titles are\n        mapped in the yaml header None will be returned. The satisfied and inherited fields are\n        generated and returned to added information to by-component assemblies for\n        the mapped leveraging components.\n\n    \"\"\"\n    leveraging_comps: List[str] = []\n    inherited_statement: Optional[ssp.Inherited] = None\n    satisfied_statement: Optional[ssp.Satisfied] = None\n\n    leveraging_comp_header_value: List[Dict[str, str]] = self._yaml_header[const.TRESTLE_LEVERAGING_COMP_TAG]\n\n    # If there are no mapped components, return early\n    if not leveraging_comp_header_value or leveraging_comp_header_value == component_mapping_default:\n        return None\n    else:\n        for comp_dicts in leveraging_comp_header_value:\n            for comp_title in comp_dicts.values():\n                leveraging_comps.append(comp_title)\n\n    statement_info: Dict[str, str] = self._yaml_header[const.TRESTLE_STATEMENT_TAG]\n\n    if const.PROVIDED_UUID in statement_info:\n        # Set inherited\n\n        provided_description = self.get_provided_description()\n        if provided_description is None:\n            raise TrestleError(f'Provided statement cannot be empty in {self._leveraged_statement_file}')\n\n        inherited_statement = gens.generate_sample_model(ssp.Inherited)\n\n        inherited_statement.description = provided_description\n        inherited_statement.provided_uuid = statement_info[const.PROVIDED_UUID]\n\n    if const.RESPONSIBILITY_UUID in statement_info:\n        # Set satisfied\n        satisfied_description = self.get_satisfied_description()\n        if satisfied_description is None:\n            raise TrestleError(f'Satisfied statement cannot be empty in {self._leveraged_statement_file}')\n\n        satisfied_statement = gens.generate_sample_model(ssp.Satisfied)\n\n        satisfied_statement.description = satisfied_description\n        satisfied_statement.responsibility_uuid = statement_info[const.RESPONSIBILITY_UUID]\n\n    return InheritanceInfo(leveraging_comps, inherited_statement, satisfied_statement)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.InheritanceMarkdownReader.strip_heading_and_comments","title":"<code>strip_heading_and_comments(markdown_text)</code>  <code>staticmethod</code>","text":"<p>Remove the heading and comments from lines to get the multi-line paragraph.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>@staticmethod\ndef strip_heading_and_comments(markdown_text: str) -&gt; str:\n    \"\"\"Remove the heading and comments from lines to get the multi-line paragraph.\"\"\"\n    lines = markdown_text.split('\\n')\n    non_heading_comment_lines = []\n    inside_heading = False\n    inside_comment = False\n\n    for line in lines:\n        if line.startswith('#'):\n            inside_heading = True\n        elif line.startswith('&lt;!--'):\n            inside_comment = True\n            if line.rstrip().endswith('--&gt;'):\n                inside_comment = False\n            continue\n        elif line.strip() == '':\n            inside_heading = False\n            inside_comment = False\n\n        if not inside_heading and not inside_comment:\n            non_heading_comment_lines.append(line)\n\n    stripped_markdown = '\\n'.join(non_heading_comment_lines).strip()\n    return stripped_markdown\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.LeveragedStatements","title":"<code>LeveragedStatements</code>","text":"<p>               Bases: <code>ABC</code></p> <p>Abstract class for managing leveraged statements.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>class LeveragedStatements(ABC):\n    \"\"\"Abstract class for managing leveraged statements.\"\"\"\n\n    def __init__(self, leveraged_ssp_reference: str) -&gt; None:\n        \"\"\"Initialize the class.\"\"\"\n        self._md_file: Optional[MDWriter] = None\n        self.header_comment_dict: Dict[str, str] = {\n            const.TRESTLE_LEVERAGING_COMP_TAG: const.YAML_LEVERAGING_COMP_COMMENT,\n            const.TRESTLE_STATEMENT_TAG: const.YAML_LEVERAGED_COMMENT\n        }\n        self.merged_header_dict: Dict[str, Any] = {\n            const.TRESTLE_STATEMENT_TAG: '',\n            const.TRESTLE_LEVERAGING_COMP_TAG: component_mapping_default,\n            const.TRESTLE_GLOBAL_TAG: {\n                const.LEVERAGED_SSP: {\n                    const.HREF: leveraged_ssp_reference\n                }\n            }\n        }\n\n    @abstractmethod\n    def write_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n        \"\"\"Write inheritance information to a single markdown file.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.LeveragedStatements-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.LeveragedStatements.header_comment_dict","title":"<code>header_comment_dict: Dict[str, str] = {const.TRESTLE_LEVERAGING_COMP_TAG: const.YAML_LEVERAGING_COMP_COMMENT, const.TRESTLE_STATEMENT_TAG: const.YAML_LEVERAGED_COMMENT}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.LeveragedStatements.merged_header_dict","title":"<code>merged_header_dict: Dict[str, Any] = {const.TRESTLE_STATEMENT_TAG: '', const.TRESTLE_LEVERAGING_COMP_TAG: component_mapping_default, const.TRESTLE_GLOBAL_TAG: {const.LEVERAGED_SSP: {const.HREF: leveraged_ssp_reference}}}</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.LeveragedStatements-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.LeveragedStatements.__init__","title":"<code>__init__(leveraged_ssp_reference)</code>","text":"<p>Initialize the class.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def __init__(self, leveraged_ssp_reference: str) -&gt; None:\n    \"\"\"Initialize the class.\"\"\"\n    self._md_file: Optional[MDWriter] = None\n    self.header_comment_dict: Dict[str, str] = {\n        const.TRESTLE_LEVERAGING_COMP_TAG: const.YAML_LEVERAGING_COMP_COMMENT,\n        const.TRESTLE_STATEMENT_TAG: const.YAML_LEVERAGED_COMMENT\n    }\n    self.merged_header_dict: Dict[str, Any] = {\n        const.TRESTLE_STATEMENT_TAG: '',\n        const.TRESTLE_LEVERAGING_COMP_TAG: component_mapping_default,\n        const.TRESTLE_GLOBAL_TAG: {\n            const.LEVERAGED_SSP: {\n                const.HREF: leveraged_ssp_reference\n            }\n        }\n    }\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.LeveragedStatements.write_statement_md","title":"<code>write_statement_md(leveraged_statement_file)</code>  <code>abstractmethod</code>","text":"<p>Write inheritance information to a single markdown file.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>@abstractmethod\ndef write_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n    \"\"\"Write inheritance information to a single markdown file.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementProvided","title":"<code>StatementProvided</code>","text":"<p>               Bases: <code>LeveragedStatements</code></p> <p>Concrete class for managing provided statements.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>class StatementProvided(LeveragedStatements):\n    \"\"\"Concrete class for managing provided statements.\"\"\"\n\n    def __init__(\n        self,\n        provided_uuid: str,\n        provided_description: str,\n        leveraged_ssp_reference: str,\n    ) -&gt; None:\n        \"\"\"Initialize the class.\"\"\"\n        self.provided_uuid = provided_uuid\n        self.provided_description = provided_description\n        super().__init__(leveraged_ssp_reference)\n\n    def write_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n        \"\"\"Write provided statements to a markdown file.\"\"\"\n        self._md_file = MDWriter(leveraged_statement_file, self.header_comment_dict)\n\n        if self._md_file.exists():\n            return self.update_statement_md(leveraged_statement_file)\n\n        self._add_generated_content()\n        self._md_file.write_out()\n\n    def update_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n        \"\"\"Update provided statements in a markdown file.\"\"\"\n        md_reader = InheritanceMarkdownReader(leveraged_statement_file)\n\n        self.merged_header_dict[const.TRESTLE_LEVERAGING_COMP_TAG] = md_reader.get_leveraged_component_header_value()\n\n        self._add_generated_content()\n        self._md_file.write_out()\n\n    def _add_generated_content(self) -&gt; None:\n        self.merged_header_dict[const.TRESTLE_STATEMENT_TAG] = {const.PROVIDED_UUID: self.provided_uuid}\n        self._md_file.add_yaml_header(self.merged_header_dict)\n\n        self._md_file.new_header(level=1, title=const.PROVIDED_STATEMENT_DESCRIPTION)\n        self._md_file.new_line(self.provided_description)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementProvided-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementProvided.provided_description","title":"<code>provided_description = provided_description</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementProvided.provided_uuid","title":"<code>provided_uuid = provided_uuid</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementProvided-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementProvided.__init__","title":"<code>__init__(provided_uuid, provided_description, leveraged_ssp_reference)</code>","text":"<p>Initialize the class.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def __init__(\n    self,\n    provided_uuid: str,\n    provided_description: str,\n    leveraged_ssp_reference: str,\n) -&gt; None:\n    \"\"\"Initialize the class.\"\"\"\n    self.provided_uuid = provided_uuid\n    self.provided_description = provided_description\n    super().__init__(leveraged_ssp_reference)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementProvided.update_statement_md","title":"<code>update_statement_md(leveraged_statement_file)</code>","text":"<p>Update provided statements in a markdown file.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def update_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n    \"\"\"Update provided statements in a markdown file.\"\"\"\n    md_reader = InheritanceMarkdownReader(leveraged_statement_file)\n\n    self.merged_header_dict[const.TRESTLE_LEVERAGING_COMP_TAG] = md_reader.get_leveraged_component_header_value()\n\n    self._add_generated_content()\n    self._md_file.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementProvided.write_statement_md","title":"<code>write_statement_md(leveraged_statement_file)</code>","text":"<p>Write provided statements to a markdown file.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def write_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n    \"\"\"Write provided statements to a markdown file.\"\"\"\n    self._md_file = MDWriter(leveraged_statement_file, self.header_comment_dict)\n\n    if self._md_file.exists():\n        return self.update_statement_md(leveraged_statement_file)\n\n    self._add_generated_content()\n    self._md_file.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementResponsibility","title":"<code>StatementResponsibility</code>","text":"<p>               Bases: <code>LeveragedStatements</code></p> <p>Concrete class for managing responsibility statements.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>class StatementResponsibility(LeveragedStatements):\n    \"\"\"Concrete class for managing responsibility statements.\"\"\"\n\n    def __init__(\n        self,\n        responsibility_uuid: str,\n        responsibility_description: str,\n        leveraged_ssp_reference: str,\n    ) -&gt; None:\n        \"\"\"Initialize the class.\"\"\"\n        self.responsibility_uuid = responsibility_uuid\n        self.responsibility_description = responsibility_description\n        self.satisfied_description = ''\n        super().__init__(leveraged_ssp_reference)\n\n    def write_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n        \"\"\"Write responsibility statements to a markdown file.\"\"\"\n        self._md_file = MDWriter(leveraged_statement_file, self.header_comment_dict)\n\n        if self._md_file.exists():\n            return self.update_statement_md(leveraged_statement_file)\n\n        self._add_generated_content()\n        self._md_file.write_out()\n\n    def update_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n        \"\"\"Update responsibility statements in a markdown file.\"\"\"\n        md_reader = InheritanceMarkdownReader(leveraged_statement_file)\n\n        self.merged_header_dict[const.TRESTLE_LEVERAGING_COMP_TAG] = md_reader.get_leveraged_component_header_value()\n\n        satisfied_description = md_reader.get_satisfied_description()\n        if satisfied_description is not None:\n            self.satisfied_description = satisfied_description\n\n        self._add_generated_content()\n        self._md_file.write_out()\n\n    def _add_generated_content(self) -&gt; None:\n        self.merged_header_dict[const.TRESTLE_STATEMENT_TAG] = {const.RESPONSIBILITY_UUID: self.responsibility_uuid}\n        self._md_file.add_yaml_header(self.merged_header_dict)\n\n        self._md_file.new_header(level=1, title=const.RESPONSIBILITY_STATEMENT_DESCRIPTION)\n        self._md_file.new_line(self.responsibility_description)\n        self._md_file.new_header(level=1, title=const.SATISFIED_STATEMENT_DESCRIPTION)\n        self._md_file.new_line(const.SATISFIED_STATEMENT_COMMENT)\n        self._md_file.new_line(self.satisfied_description)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementResponsibility-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_description","title":"<code>responsibility_description = responsibility_description</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementResponsibility.responsibility_uuid","title":"<code>responsibility_uuid = responsibility_uuid</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementResponsibility.satisfied_description","title":"<code>satisfied_description = ''</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementResponsibility-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementResponsibility.__init__","title":"<code>__init__(responsibility_uuid, responsibility_description, leveraged_ssp_reference)</code>","text":"<p>Initialize the class.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def __init__(\n    self,\n    responsibility_uuid: str,\n    responsibility_description: str,\n    leveraged_ssp_reference: str,\n) -&gt; None:\n    \"\"\"Initialize the class.\"\"\"\n    self.responsibility_uuid = responsibility_uuid\n    self.responsibility_description = responsibility_description\n    self.satisfied_description = ''\n    super().__init__(leveraged_ssp_reference)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementResponsibility.update_statement_md","title":"<code>update_statement_md(leveraged_statement_file)</code>","text":"<p>Update responsibility statements in a markdown file.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def update_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n    \"\"\"Update responsibility statements in a markdown file.\"\"\"\n    md_reader = InheritanceMarkdownReader(leveraged_statement_file)\n\n    self.merged_header_dict[const.TRESTLE_LEVERAGING_COMP_TAG] = md_reader.get_leveraged_component_header_value()\n\n    satisfied_description = md_reader.get_satisfied_description()\n    if satisfied_description is not None:\n        self.satisfied_description = satisfied_description\n\n    self._add_generated_content()\n    self._md_file.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementResponsibility.write_statement_md","title":"<code>write_statement_md(leveraged_statement_file)</code>","text":"<p>Write responsibility statements to a markdown file.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def write_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n    \"\"\"Write responsibility statements to a markdown file.\"\"\"\n    self._md_file = MDWriter(leveraged_statement_file, self.header_comment_dict)\n\n    if self._md_file.exists():\n        return self.update_statement_md(leveraged_statement_file)\n\n    self._add_generated_content()\n    self._md_file.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree","title":"<code>StatementTree</code>","text":"<p>               Bases: <code>LeveragedStatements</code></p> <p>Concrete class for managing provided and responsibility statements.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>class StatementTree(LeveragedStatements):\n    \"\"\"Concrete class for managing provided and responsibility statements.\"\"\"\n\n    def __init__(\n        self,\n        provided_uuid: str,\n        provided_description: str,\n        responsibility_uuid: str,\n        responsibility_description: str,\n        leveraged_ssp_reference: str\n    ) -&gt; None:\n        \"\"\"Initialize the class.\"\"\"\n        self.provided_uuid = provided_uuid\n        self.provided_description = provided_description\n        self.responsibility_uuid = responsibility_uuid\n        self.responsibility_description = responsibility_description\n        self.satisfied_description = ''\n        super().__init__(leveraged_ssp_reference)\n\n    def write_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n        \"\"\"Write a provided and responsibility statements to a markdown file.\"\"\"\n        self._md_file = MDWriter(leveraged_statement_file, self.header_comment_dict)\n\n        if self._md_file.exists():\n            return self.update_statement_md(leveraged_statement_file)\n\n        self._add_generated_content()\n        self._md_file.write_out()\n\n    def update_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n        \"\"\"Update provided and responsibility statements in a markdown file.\"\"\"\n        md_reader = InheritanceMarkdownReader(leveraged_statement_file)\n\n        self.merged_header_dict[const.TRESTLE_LEVERAGING_COMP_TAG] = md_reader.get_leveraged_component_header_value()\n\n        satisfied_description = md_reader.get_satisfied_description()\n        if satisfied_description is not None:\n            self.satisfied_description = satisfied_description\n\n        self._add_generated_content()\n        self._md_file.write_out()\n\n    def _add_generated_content(self) -&gt; None:\n        statement_dict: Dict[str, str] = {\n            const.PROVIDED_UUID: self.provided_uuid, const.RESPONSIBILITY_UUID: self.responsibility_uuid\n        }\n\n        self.merged_header_dict[const.TRESTLE_STATEMENT_TAG] = statement_dict\n        self._md_file.add_yaml_header(self.merged_header_dict)\n\n        self._md_file.new_header(level=1, title=const.PROVIDED_STATEMENT_DESCRIPTION)\n        self._md_file.new_line(self.provided_description)\n        self._md_file.new_header(level=1, title=const.RESPONSIBILITY_STATEMENT_DESCRIPTION)\n        self._md_file.new_line(self.responsibility_description)\n        self._md_file.new_header(level=1, title=const.SATISFIED_STATEMENT_DESCRIPTION)\n        self._md_file.new_line(const.SATISFIED_STATEMENT_COMMENT)\n        self._md_file.new_line(self.satisfied_description)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree.provided_description","title":"<code>provided_description = provided_description</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree.provided_uuid","title":"<code>provided_uuid = provided_uuid</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree.responsibility_description","title":"<code>responsibility_description = responsibility_description</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree.responsibility_uuid","title":"<code>responsibility_uuid = responsibility_uuid</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree.satisfied_description","title":"<code>satisfied_description = ''</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree.__init__","title":"<code>__init__(provided_uuid, provided_description, responsibility_uuid, responsibility_description, leveraged_ssp_reference)</code>","text":"<p>Initialize the class.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def __init__(\n    self,\n    provided_uuid: str,\n    provided_description: str,\n    responsibility_uuid: str,\n    responsibility_description: str,\n    leveraged_ssp_reference: str\n) -&gt; None:\n    \"\"\"Initialize the class.\"\"\"\n    self.provided_uuid = provided_uuid\n    self.provided_description = provided_description\n    self.responsibility_uuid = responsibility_uuid\n    self.responsibility_description = responsibility_description\n    self.satisfied_description = ''\n    super().__init__(leveraged_ssp_reference)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree.update_statement_md","title":"<code>update_statement_md(leveraged_statement_file)</code>","text":"<p>Update provided and responsibility statements in a markdown file.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def update_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n    \"\"\"Update provided and responsibility statements in a markdown file.\"\"\"\n    md_reader = InheritanceMarkdownReader(leveraged_statement_file)\n\n    self.merged_header_dict[const.TRESTLE_LEVERAGING_COMP_TAG] = md_reader.get_leveraged_component_header_value()\n\n    satisfied_description = md_reader.get_satisfied_description()\n    if satisfied_description is not None:\n        self.satisfied_description = satisfied_description\n\n    self._add_generated_content()\n    self._md_file.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/crm/leveraged_statements/#trestle.core.crm.leveraged_statements.StatementTree.write_statement_md","title":"<code>write_statement_md(leveraged_statement_file)</code>","text":"<p>Write a provided and responsibility statements to a markdown file.</p> Source code in <code>trestle/core/crm/leveraged_statements.py</code> <pre><code>def write_statement_md(self, leveraged_statement_file: pathlib.Path) -&gt; None:\n    \"\"\"Write a provided and responsibility statements to a markdown file.\"\"\"\n    self._md_file = MDWriter(leveraged_statement_file, self.header_comment_dict)\n\n    if self._md_file.exists():\n        return self.update_statement_md(leveraged_statement_file)\n\n    self._add_generated_content()\n    self._md_file.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/","title":"trestle.core.crm.ssp_inheritance_api","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api","title":"<code>trestle.core.crm.ssp_inheritance_api</code>","text":"<p>API for updating inheritance information in SSPs.</p>"},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI","title":"<code>SSPInheritanceAPI</code>","text":"<p>API for updating inheritance information in SSPs through inheritance markdown.</p> Source code in <code>trestle/core/crm/ssp_inheritance_api.py</code> <pre><code>class SSPInheritanceAPI():\n    \"\"\"API for updating inheritance information in SSPs through inheritance markdown.\"\"\"\n\n    def __init__(self, inheritance_md_path: pathlib.Path, trestle_root: pathlib.Path) -&gt; None:\n        \"\"\"Initialize the SSP Inheritance API class.\"\"\"\n        self._inheritance_markdown_path: pathlib.Path = inheritance_md_path\n        self._trestle_root: pathlib.Path = trestle_root\n\n    def write_inheritance_as_markdown(\n        self, leveraged_ssp_reference: str, catalog_api: Optional[CatalogAPI] = None\n    ) -&gt; None:\n        \"\"\"\n        Write inheritance information to markdown.\n\n        Args:\n            leveraged_ssp_reference: Location of the SSP to write inheritance information from.\n            catalog_api: Catalog API to filter inheritance information by catalog.\n\n        Notes:\n            If a catalog API is provided, the written controls in the markdown will be filtered by the catalog.\n        \"\"\"\n        leveraged_ssp: ossp.SystemSecurityPlan = self._fetch_leveraged_ssp(leveraged_ssp_reference)\n\n        if catalog_api is not None:\n            control_imp: ossp.ControlImplementation = leveraged_ssp.control_implementation\n\n            new_imp_requirements: List[ossp.ImplementedRequirement] = []\n            for imp_requirement in as_list(control_imp.implemented_requirements):\n                control = catalog_api._catalog_interface.get_control(imp_requirement.control_id)\n                if control is not None:\n                    new_imp_requirements.append(imp_requirement)\n            control_imp.implemented_requirements = new_imp_requirements\n\n            leveraged_ssp.control_implementation = control_imp\n\n        export_writer: ExportWriter = ExportWriter(\n            self._inheritance_markdown_path, leveraged_ssp, leveraged_ssp_reference\n        )\n        export_writer.write_exports_as_markdown()\n\n    def update_ssp_inheritance(self, ssp: ossp.SystemSecurityPlan) -&gt; None:\n        \"\"\"\n        Update inheritance information in SSP.\n\n        Args:\n            ssp: SSP to update with inheritance information.\n        \"\"\"\n        logger.debug('Reading inheritance information from markdown.')\n        reader = ExportReader(self._inheritance_markdown_path, ssp)\n        ssp = reader.read_exports_from_markdown()\n\n        leveraged_ssp_reference = reader.get_leveraged_ssp_href()\n\n        leveraged_ssp: ossp.SystemSecurityPlan = self._fetch_leveraged_ssp(leveraged_ssp_reference)\n\n        link: common.Link = common.Link(href=leveraged_ssp_reference)\n        leveraged_auths: List[ossp.LeveragedAuthorization] = []\n        leveraged_auth: ossp.LeveragedAuthorization = gens.generate_sample_model(ossp.LeveragedAuthorization)\n        leveraged_components: List[str] = reader.get_leveraged_components()\n\n        if not leveraged_components:\n            logger.warning(\n                'No leveraged components mapped to the SSP. '\n                'Please edit the inheritance markdown to include the leveraged authorization.'\n            )\n        else:\n            existing_leveraged_auth: ossp.LeveragedAuthorization = self._leveraged_auth_from_existing(\n                as_list(ssp.system_implementation.leveraged_authorizations), link\n            )\n            if existing_leveraged_auth is not None:\n                leveraged_auth = existing_leveraged_auth\n            else:\n                leveraged_auth.links = as_list(leveraged_auth.links)\n                leveraged_auth.links.append(link)\n\n            leveraged_auth.title = f'Leveraged Authorization for {leveraged_ssp.metadata.title}'\n            leveraged_auths.append(leveraged_auth)\n\n        # Overwrite the leveraged authorization in the SSP. The only leveraged authorization should be the one\n        # coming from inheritance view\n        ssp.system_implementation.leveraged_authorizations = none_if_empty(leveraged_auths)\n\n        self._reconcile_components(ssp, leveraged_ssp, leveraged_components, leveraged_auth)\n\n    def _fetch_leveraged_ssp(self, leveraged_ssp_reference: str) -&gt; ossp.SystemSecurityPlan:\n        \"\"\"Fetch the leveraged SSP.\"\"\"\n        leveraged_ssp: ossp.SystemSecurityPlan\n        fetcher = FetcherFactory.get_fetcher(self._trestle_root, leveraged_ssp_reference)\n        try:\n            leveraged_ssp, _ = fetcher.get_oscal()\n        except TrestleError as e:\n            raise TrestleError(f'Unable to fetch ssp from {leveraged_ssp_reference}: {e}')\n        return leveraged_ssp\n\n    def _reconcile_components(\n        self,\n        ssp: ossp.SystemSecurityPlan,\n        leveraged_ssp: ossp.SystemSecurityPlan,\n        leveraged_components: List[str],\n        leveraged_auth: ossp.LeveragedAuthorization\n    ) -&gt; None:\n        \"\"\"Reconcile components in the leveraging SSP with those in the leveraged SSP.\"\"\"\n        mapped_components: Dict[str, ossp.SystemComponent] = {}\n        for component in as_list(leveraged_ssp.system_implementation.components):\n            if component.title in leveraged_components:\n                mapped_components[component.uuid] = component\n\n        new_components: List[ossp.SystemComponent] = []\n        for component in as_list(ssp.system_implementation.components):\n            props_dict: Dict[str, str] = {prop.name: prop.value for prop in as_list(component.props)}\n\n            # If this component is part of the original SSP components, add\n            # and continue\n            if const.LEV_AUTH_UUID not in props_dict:\n                new_components.append(component)\n                continue\n\n            # If the leveraged component already exists, update the title, description, type, and status\n            original_comp_uuid = props_dict[const.INHERITED_UUID]\n            if original_comp_uuid in mapped_components:\n                original_component = mapped_components.pop(original_comp_uuid)\n                self._update_leveraged_system_component(component, original_component, leveraged_auth.uuid)\n                new_components.append(component)\n\n        # Add any remaining components to the new components\n        for component in mapped_components.values():\n            new_component: ossp.SystemComponent = gens.generate_sample_model(ossp.SystemComponent)\n            self._update_leveraged_system_component(new_component, component, leveraged_auth.uuid)\n            logger.debug(f'Adding component {new_component.title} to components.')\n            new_components.append(new_component)\n\n        ssp.system_implementation.components = new_components\n\n    @staticmethod\n    def _update_leveraged_system_component(\n        new_comp: ossp.SystemComponent, original_comp: ossp.SystemComponent, leveraged_auth_id: str\n    ) -&gt; None:\n        \"\"\"Create a leveraged system component in the context of a leveraging system component.\"\"\"\n        new_comp.type = original_comp.type\n        new_comp.title = original_comp.title\n        new_comp.description = original_comp.description\n        new_comp.status = original_comp.status\n\n        new_comp.props = [\n            common.Property(name=const.IMPLEMENTATION_POINT, value=const.IMPLEMENTATION_POINT_EXTERNAL),\n            common.Property(name=const.LEV_AUTH_UUID, value=leveraged_auth_id),\n            common.Property(name=const.INHERITED_UUID, value=original_comp.uuid)\n        ]\n\n    def _leveraged_auth_from_existing(\n        self, leveraged_authorizations: List[ossp.LeveragedAuthorization], criteria_link: common.Link\n    ) -&gt; Optional[ossp.LeveragedAuthorization]:\n        \"\"\"Return the leveraged authorization if it is present in the ssp.\"\"\"\n        for leveraged_auth in leveraged_authorizations:\n            if leveraged_auth.links and any(link.href == criteria_link.href for link in leveraged_auth.links):\n                return leveraged_auth\n        return None\n</code></pre>"},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.__init__","title":"<code>__init__(inheritance_md_path, trestle_root)</code>","text":"<p>Initialize the SSP Inheritance API class.</p> Source code in <code>trestle/core/crm/ssp_inheritance_api.py</code> <pre><code>def __init__(self, inheritance_md_path: pathlib.Path, trestle_root: pathlib.Path) -&gt; None:\n    \"\"\"Initialize the SSP Inheritance API class.\"\"\"\n    self._inheritance_markdown_path: pathlib.Path = inheritance_md_path\n    self._trestle_root: pathlib.Path = trestle_root\n</code></pre>"},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.update_ssp_inheritance","title":"<code>update_ssp_inheritance(ssp)</code>","text":"<p>Update inheritance information in SSP.</p> <p>Parameters:</p> Name Type Description Default <code>ssp</code> <code>SystemSecurityPlan</code> <p>SSP to update with inheritance information.</p> required Source code in <code>trestle/core/crm/ssp_inheritance_api.py</code> <pre><code>def update_ssp_inheritance(self, ssp: ossp.SystemSecurityPlan) -&gt; None:\n    \"\"\"\n    Update inheritance information in SSP.\n\n    Args:\n        ssp: SSP to update with inheritance information.\n    \"\"\"\n    logger.debug('Reading inheritance information from markdown.')\n    reader = ExportReader(self._inheritance_markdown_path, ssp)\n    ssp = reader.read_exports_from_markdown()\n\n    leveraged_ssp_reference = reader.get_leveraged_ssp_href()\n\n    leveraged_ssp: ossp.SystemSecurityPlan = self._fetch_leveraged_ssp(leveraged_ssp_reference)\n\n    link: common.Link = common.Link(href=leveraged_ssp_reference)\n    leveraged_auths: List[ossp.LeveragedAuthorization] = []\n    leveraged_auth: ossp.LeveragedAuthorization = gens.generate_sample_model(ossp.LeveragedAuthorization)\n    leveraged_components: List[str] = reader.get_leveraged_components()\n\n    if not leveraged_components:\n        logger.warning(\n            'No leveraged components mapped to the SSP. '\n            'Please edit the inheritance markdown to include the leveraged authorization.'\n        )\n    else:\n        existing_leveraged_auth: ossp.LeveragedAuthorization = self._leveraged_auth_from_existing(\n            as_list(ssp.system_implementation.leveraged_authorizations), link\n        )\n        if existing_leveraged_auth is not None:\n            leveraged_auth = existing_leveraged_auth\n        else:\n            leveraged_auth.links = as_list(leveraged_auth.links)\n            leveraged_auth.links.append(link)\n\n        leveraged_auth.title = f'Leveraged Authorization for {leveraged_ssp.metadata.title}'\n        leveraged_auths.append(leveraged_auth)\n\n    # Overwrite the leveraged authorization in the SSP. The only leveraged authorization should be the one\n    # coming from inheritance view\n    ssp.system_implementation.leveraged_authorizations = none_if_empty(leveraged_auths)\n\n    self._reconcile_components(ssp, leveraged_ssp, leveraged_components, leveraged_auth)\n</code></pre>"},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api.SSPInheritanceAPI.write_inheritance_as_markdown","title":"<code>write_inheritance_as_markdown(leveraged_ssp_reference, catalog_api=None)</code>","text":"<p>Write inheritance information to markdown.</p> <p>Parameters:</p> Name Type Description Default <code>leveraged_ssp_reference</code> <code>str</code> <p>Location of the SSP to write inheritance information from.</p> required <code>catalog_api</code> <code>Optional[CatalogAPI]</code> <p>Catalog API to filter inheritance information by catalog.</p> <code>None</code> Notes <p>If a catalog API is provided, the written controls in the markdown will be filtered by the catalog.</p> Source code in <code>trestle/core/crm/ssp_inheritance_api.py</code> <pre><code>def write_inheritance_as_markdown(\n    self, leveraged_ssp_reference: str, catalog_api: Optional[CatalogAPI] = None\n) -&gt; None:\n    \"\"\"\n    Write inheritance information to markdown.\n\n    Args:\n        leveraged_ssp_reference: Location of the SSP to write inheritance information from.\n        catalog_api: Catalog API to filter inheritance information by catalog.\n\n    Notes:\n        If a catalog API is provided, the written controls in the markdown will be filtered by the catalog.\n    \"\"\"\n    leveraged_ssp: ossp.SystemSecurityPlan = self._fetch_leveraged_ssp(leveraged_ssp_reference)\n\n    if catalog_api is not None:\n        control_imp: ossp.ControlImplementation = leveraged_ssp.control_implementation\n\n        new_imp_requirements: List[ossp.ImplementedRequirement] = []\n        for imp_requirement in as_list(control_imp.implemented_requirements):\n            control = catalog_api._catalog_interface.get_control(imp_requirement.control_id)\n            if control is not None:\n                new_imp_requirements.append(imp_requirement)\n        control_imp.implemented_requirements = new_imp_requirements\n\n        leveraged_ssp.control_implementation = control_imp\n\n    export_writer: ExportWriter = ExportWriter(\n        self._inheritance_markdown_path, leveraged_ssp, leveraged_ssp_reference\n    )\n    export_writer.write_exports_as_markdown()\n</code></pre>"},{"location":"reference/API/trestle/core/crm/ssp_inheritance_api/#trestle.core.crm.ssp_inheritance_api-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/jinja/base/","title":"trestle.core.jinja.base","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/jinja/base/#trestle.core.jinja.base","title":"<code>trestle.core.jinja.base</code>","text":"<p>Trestle core.jinja base class.</p>"},{"location":"reference/API/trestle/core/jinja/base/#trestle.core.jinja.base-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/jinja/base/#trestle.core.jinja.base.TrestleJinjaExtension","title":"<code>TrestleJinjaExtension</code>","text":"<p>               Bases: <code>Extension</code></p> <p>Class to define common methods to be inherited from for use in trestle.</p> Source code in <code>trestle/core/jinja/base.py</code> <pre><code>class TrestleJinjaExtension(Extension):\n    \"\"\"Class to define common methods to be inherited from for use in trestle.\"\"\"\n\n    max_tag_parse = 20\n\n    def __init__(self, environment: Environment) -&gt; None:\n        \"\"\"Ensure enviroment is set and carried into class vars.\"\"\"\n        super().__init__(environment)\n\n    @staticmethod\n    def parse_expression(parser):\n        \"\"\"Safely parse jinja expression.\"\"\"\n        # Licensed under MIT from:\n        # https://github.com/MoritzS/jinja2-django-tags/blob/master/jdj_tags/extensions.py#L424\n        # Due to how the jinja2 parser works, it treats \"foo\" \"bar\" as a single\n        # string literal as it is the case in python.\n        # But the url tag in django supports multiple string arguments, e.g.\n        # \"{% url 'my_view' 'arg1' 'arg2' %}\".\n        # That's why we have to check if it's a string literal first.\n        token = parser.stream.current\n        if token.test(lexer.TOKEN_STRING):\n            expr = nodes.Const(token.value, lineno=token.lineno)\n            next(parser.stream)\n        else:\n            expr = parser.parse_expression(False)\n\n        return expr\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/base/#trestle.core.jinja.base.TrestleJinjaExtension-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/jinja/base/#trestle.core.jinja.base.TrestleJinjaExtension.max_tag_parse","title":"<code>max_tag_parse = 20</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/jinja/base/#trestle.core.jinja.base.TrestleJinjaExtension-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/jinja/base/#trestle.core.jinja.base.TrestleJinjaExtension.__init__","title":"<code>__init__(environment)</code>","text":"<p>Ensure enviroment is set and carried into class vars.</p> Source code in <code>trestle/core/jinja/base.py</code> <pre><code>def __init__(self, environment: Environment) -&gt; None:\n    \"\"\"Ensure enviroment is set and carried into class vars.\"\"\"\n    super().__init__(environment)\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/base/#trestle.core.jinja.base.TrestleJinjaExtension.parse_expression","title":"<code>parse_expression(parser)</code>  <code>staticmethod</code>","text":"<p>Safely parse jinja expression.</p> Source code in <code>trestle/core/jinja/base.py</code> <pre><code>@staticmethod\ndef parse_expression(parser):\n    \"\"\"Safely parse jinja expression.\"\"\"\n    # Licensed under MIT from:\n    # https://github.com/MoritzS/jinja2-django-tags/blob/master/jdj_tags/extensions.py#L424\n    # Due to how the jinja2 parser works, it treats \"foo\" \"bar\" as a single\n    # string literal as it is the case in python.\n    # But the url tag in django supports multiple string arguments, e.g.\n    # \"{% url 'my_view' 'arg1' 'arg2' %}\".\n    # That's why we have to check if it's a string literal first.\n    token = parser.stream.current\n    if token.test(lexer.TOKEN_STRING):\n        expr = nodes.Const(token.value, lineno=token.lineno)\n        next(parser.stream)\n    else:\n        expr = parser.parse_expression(False)\n\n    return expr\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/ext/","title":"trestle.core.jinja.ext","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/jinja/ext/#trestle.core.jinja.ext","title":"<code>trestle.core.jinja.ext</code>","text":"<p>Trestle core.jinja extension loading functionality.</p>"},{"location":"reference/API/trestle/core/jinja/ext/#trestle.core.jinja.ext-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/jinja/ext/#trestle.core.jinja.ext.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/jinja/ext/#trestle.core.jinja.ext-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/jinja/ext/#trestle.core.jinja.ext-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/jinja/ext/#trestle.core.jinja.ext.extensions","title":"<code>extensions()</code>  <code>cached</code>","text":"<p>Return list of Jinja extensions packaged with compliance-trestle and included from plugins.</p> Source code in <code>trestle/core/jinja/ext.py</code> <pre><code>@functools.cache\ndef extensions() -&gt; List[Extension]:\n    \"\"\"Return list of Jinja extensions packaged with compliance-trestle and included from plugins.\"\"\"\n    extensions = [tags.MDSectionInclude, tags.MDCleanInclude, tags.MDDatestamp, filters.JinjaSSPFilters]\n    # This block is uncovered as trestle cannot find plugins in it's unit tests - it is the base module.\n    for plugin, ext_cls in discovered_plugins('jinja_ext'):  # pragma: nocover\n        # add extensions (derived from TrestleJinjaExtension) to extensions list\n        if issubclass(ext_cls, Extension):\n            # don't add Extension or TrestleJinjaExtension\n            if ext_cls is not TrestleJinjaExtension and ext_cls is not Extension:\n                extensions.append(ext_cls)\n                logger.info(f'{ext_cls} added to jinja extensions from plugin {plugin}')\n    return extensions\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/filters/","title":"trestle.core.jinja.filters","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters","title":"<code>trestle.core.jinja.filters</code>","text":"<p>Trestle utilities to customize jinja filters.</p>"},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters.JinjaSSPFilters","title":"<code>JinjaSSPFilters</code>","text":"<p>               Bases: <code>TrestleJinjaExtension</code></p> <p>Collection of useful OSCAL-specific filters.</p> Source code in <code>trestle/core/jinja/filters.py</code> <pre><code>class JinjaSSPFilters(TrestleJinjaExtension):\n    \"\"\"Collection of useful OSCAL-specific filters.\"\"\"\n\n    def __init__(self, environment: Environment) -&gt; None:\n        \"\"\"Initialize class and add filters.\"\"\"\n        super(JinjaSSPFilters, self).__init__(environment)\n\n        environment.filters['as_list'] = as_list\n        environment.filters['get_default'] = get_default\n        environment.filters['first_or_none'] = first_or_none\n        environment.filters['get_party'] = get_party\n        environment.filters['parties_for_role'] = parties_for_role\n        environment.filters['diagram_href'] = diagram_href\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters.JinjaSSPFilters-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters.JinjaSSPFilters.__init__","title":"<code>__init__(environment)</code>","text":"<p>Initialize class and add filters.</p> Source code in <code>trestle/core/jinja/filters.py</code> <pre><code>def __init__(self, environment: Environment) -&gt; None:\n    \"\"\"Initialize class and add filters.\"\"\"\n    super(JinjaSSPFilters, self).__init__(environment)\n\n    environment.filters['as_list'] = as_list\n    environment.filters['get_default'] = get_default\n    environment.filters['first_or_none'] = first_or_none\n    environment.filters['get_party'] = get_party\n    environment.filters['parties_for_role'] = parties_for_role\n    environment.filters['diagram_href'] = diagram_href\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters.diagram_href","title":"<code>diagram_href(diagram)</code>","text":"<p>Retrieve the diagrams's link href.</p> Source code in <code>trestle/core/jinja/filters.py</code> <pre><code>def diagram_href(diagram: Optional[Diagram]) -&gt; str:\n    \"\"\"Retrieve the diagrams's link href.\"\"\"\n    if diagram:\n        return next((link.href for link in as_list(diagram.links) if link.rel == 'diagram'), '')\n    else:\n        return ''\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters.first_or_none","title":"<code>first_or_none(value)</code>","text":"<p>Retrieve the first array entry, or None for lists that are None or empty.</p> Source code in <code>trestle/core/jinja/filters.py</code> <pre><code>def first_or_none(value: Optional[List[Any]]) -&gt; Optional[Any]:\n    \"\"\"Retrieve the first array entry, or None for lists that are None or empty.\"\"\"\n    return next(iter(as_list(value)), None)\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters.get_party","title":"<code>get_party(uuid, ssp)</code>","text":"<p>Get the metadata.parties entry for this UUID.</p> Source code in <code>trestle/core/jinja/filters.py</code> <pre><code>def get_party(uuid: str, ssp: SystemSecurityPlan) -&gt; Optional[Party]:\n    \"\"\"Get the metadata.parties entry for this UUID.\"\"\"\n    return next((x for x in as_list(ssp.metadata.parties) if x.uuid == uuid), None)\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/filters/#trestle.core.jinja.filters.parties_for_role","title":"<code>parties_for_role(responsible_parties, role_id, ssp)</code>","text":"<p>Get a list of parties from a list of responsible_parties and a given role_id.</p> Source code in <code>trestle/core/jinja/filters.py</code> <pre><code>def parties_for_role(responsible_parties: List[ResponsibleParty], role_id: str,\n                     ssp: SystemSecurityPlan) -&gt; Iterator[Party]:\n    \"\"\"Get a list of parties from a list of responsible_parties and a given role_id.\"\"\"\n    logger.debug(f'Finding parties for role: {role_id}')\n    for responsible_party in as_list(responsible_parties):\n        if responsible_party.role_id == role_id:\n            logger.debug(\n                f'Found responsible party for role_id: {role_id} with {len(responsible_party.party_uuids)} parties'\n            )\n            for uuid in responsible_party.party_uuids:\n                logger.debug(f'Looking for parties with uuid: {uuid}')\n                party = get_party(uuid, ssp)\n                if party:\n                    yield party\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/","title":"trestle.core.jinja.tags","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags","title":"<code>trestle.core.jinja.tags</code>","text":"<p>Trestle utilities to customize jinja tags.</p>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDCleanInclude","title":"<code>MDCleanInclude</code>","text":"<p>               Bases: <code>TrestleJinjaExtension</code></p> <p>Inject the parameter of the tag as the resulting content.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>class MDCleanInclude(TrestleJinjaExtension):\n    \"\"\"Inject the parameter of the tag as the resulting content.\"\"\"\n\n    tags = {'md_clean_include'}\n\n    def __init__(self, environment: Environment) -&gt; None:\n        \"\"\"Ensure enviroment is set and carried into class vars.\"\"\"\n        super().__init__(environment)\n\n    def parse(self, parser):\n        \"\"\"Execute parsing of md token and return nodes.\"\"\"\n        kwargs = None\n        expected_heading_level = None\n        count = 0\n        while parser.stream.current.type != lexer.TOKEN_BLOCK_END:\n            count = count + 1\n            if count &gt; self.max_tag_parse:\n                raise err.TrestleError('Unexpected Jinja tag structure provided, please review docs.')\n            token = parser.stream.current\n            if token.test('name:md_clean_include'):\n                parser.stream.expect(lexer.TOKEN_NAME)\n                markdown_source = parser.stream.expect(lexer.TOKEN_STRING)\n            elif kwargs is not None:\n                arg = token.value\n                next(parser.stream)\n                parser.stream.expect(lexer.TOKEN_ASSIGN)\n                token = parser.stream.current\n                exp = self.parse_expression(parser)\n                kwargs[arg] = exp.value\n            else:\n                if parser.stream.look().type == lexer.TOKEN_ASSIGN:\n                    kwargs = {}\n                continue\n        md_content, _, _ = self.environment.loader.get_source(self.environment, markdown_source.value)\n        fm = frontmatter.loads(md_content)\n        content = fm.content\n        content += '\\n\\n'\n        if kwargs is not None:\n            expected_heading_level = kwargs.get('heading_level')\n        if expected_heading_level is not None:\n            content = adjust_heading_level(content, expected_heading_level)\n\n        local_parser = Parser(self.environment, content)\n        top_level_output = local_parser.parse()\n\n        return top_level_output.body\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDCleanInclude-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDCleanInclude.tags","title":"<code>tags = {'md_clean_include'}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDCleanInclude-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDCleanInclude.__init__","title":"<code>__init__(environment)</code>","text":"<p>Ensure enviroment is set and carried into class vars.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>def __init__(self, environment: Environment) -&gt; None:\n    \"\"\"Ensure enviroment is set and carried into class vars.\"\"\"\n    super().__init__(environment)\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDCleanInclude.parse","title":"<code>parse(parser)</code>","text":"<p>Execute parsing of md token and return nodes.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>def parse(self, parser):\n    \"\"\"Execute parsing of md token and return nodes.\"\"\"\n    kwargs = None\n    expected_heading_level = None\n    count = 0\n    while parser.stream.current.type != lexer.TOKEN_BLOCK_END:\n        count = count + 1\n        if count &gt; self.max_tag_parse:\n            raise err.TrestleError('Unexpected Jinja tag structure provided, please review docs.')\n        token = parser.stream.current\n        if token.test('name:md_clean_include'):\n            parser.stream.expect(lexer.TOKEN_NAME)\n            markdown_source = parser.stream.expect(lexer.TOKEN_STRING)\n        elif kwargs is not None:\n            arg = token.value\n            next(parser.stream)\n            parser.stream.expect(lexer.TOKEN_ASSIGN)\n            token = parser.stream.current\n            exp = self.parse_expression(parser)\n            kwargs[arg] = exp.value\n        else:\n            if parser.stream.look().type == lexer.TOKEN_ASSIGN:\n                kwargs = {}\n            continue\n    md_content, _, _ = self.environment.loader.get_source(self.environment, markdown_source.value)\n    fm = frontmatter.loads(md_content)\n    content = fm.content\n    content += '\\n\\n'\n    if kwargs is not None:\n        expected_heading_level = kwargs.get('heading_level')\n    if expected_heading_level is not None:\n        content = adjust_heading_level(content, expected_heading_level)\n\n    local_parser = Parser(self.environment, content)\n    top_level_output = local_parser.parse()\n\n    return top_level_output.body\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDDatestamp","title":"<code>MDDatestamp</code>","text":"<p>               Bases: <code>TrestleJinjaExtension</code></p> <p>Inject the parameter of the tag as the resulting content.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>class MDDatestamp(TrestleJinjaExtension):\n    \"\"\"Inject the parameter of the tag as the resulting content.\"\"\"\n\n    tags = {'md_datestamp'}\n\n    def __init__(self, environment: Environment) -&gt; None:\n        \"\"\"Ensure enviroment is set and carried into class vars.\"\"\"\n        super().__init__(environment)\n\n    def parse(self, parser):\n        \"\"\"Execute parsing of md token and return nodes.\"\"\"\n        kwargs = None\n        count = 0\n        while parser.stream.current.type != lexer.TOKEN_BLOCK_END:\n            count = count + 1\n            token = parser.stream.current\n            if count &gt; self.max_tag_parse:\n                raise err.TrestleError(f'Unexpected Jinja tag structure provided at token {token.value}')\n            if token.test('name:md_datestamp'):\n                parser.stream.expect(lexer.TOKEN_NAME)\n            elif kwargs is not None:\n                arg = token.value\n                next(parser.stream)\n                parser.stream.expect(lexer.TOKEN_ASSIGN)\n                token = parser.stream.current\n                exp = self.parse_expression(parser)\n                kwargs[arg] = exp.value\n            else:\n                if parser.stream.look().type == lexer.TOKEN_ASSIGN or parser.stream.look().type == lexer.TOKEN_STRING:\n                    kwargs = {}\n                continue\n\n        if kwargs is not None:\n            if 'format' in kwargs and type(kwargs['format'] is str):\n                date_string = date.today().strftime(kwargs['format'])\n            else:\n                date_string = date.today().strftime(markdown_const.JINJA_DATESTAMP_FORMAT)\n            if 'newline' in kwargs and kwargs['newline'] is False:\n                pass\n            else:\n                date_string += '\\n\\n'\n        else:\n            date_string = date.today().strftime(markdown_const.JINJA_DATESTAMP_FORMAT) + '\\n\\n'\n\n        local_parser = Parser(self.environment, date_string)\n        datestamp_output = local_parser.parse()\n\n        return datestamp_output.body\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDDatestamp-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDDatestamp.tags","title":"<code>tags = {'md_datestamp'}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDDatestamp-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDDatestamp.__init__","title":"<code>__init__(environment)</code>","text":"<p>Ensure enviroment is set and carried into class vars.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>def __init__(self, environment: Environment) -&gt; None:\n    \"\"\"Ensure enviroment is set and carried into class vars.\"\"\"\n    super().__init__(environment)\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDDatestamp.parse","title":"<code>parse(parser)</code>","text":"<p>Execute parsing of md token and return nodes.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>def parse(self, parser):\n    \"\"\"Execute parsing of md token and return nodes.\"\"\"\n    kwargs = None\n    count = 0\n    while parser.stream.current.type != lexer.TOKEN_BLOCK_END:\n        count = count + 1\n        token = parser.stream.current\n        if count &gt; self.max_tag_parse:\n            raise err.TrestleError(f'Unexpected Jinja tag structure provided at token {token.value}')\n        if token.test('name:md_datestamp'):\n            parser.stream.expect(lexer.TOKEN_NAME)\n        elif kwargs is not None:\n            arg = token.value\n            next(parser.stream)\n            parser.stream.expect(lexer.TOKEN_ASSIGN)\n            token = parser.stream.current\n            exp = self.parse_expression(parser)\n            kwargs[arg] = exp.value\n        else:\n            if parser.stream.look().type == lexer.TOKEN_ASSIGN or parser.stream.look().type == lexer.TOKEN_STRING:\n                kwargs = {}\n            continue\n\n    if kwargs is not None:\n        if 'format' in kwargs and type(kwargs['format'] is str):\n            date_string = date.today().strftime(kwargs['format'])\n        else:\n            date_string = date.today().strftime(markdown_const.JINJA_DATESTAMP_FORMAT)\n        if 'newline' in kwargs and kwargs['newline'] is False:\n            pass\n        else:\n            date_string += '\\n\\n'\n    else:\n        date_string = date.today().strftime(markdown_const.JINJA_DATESTAMP_FORMAT) + '\\n\\n'\n\n    local_parser = Parser(self.environment, date_string)\n    datestamp_output = local_parser.parse()\n\n    return datestamp_output.body\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDSectionInclude","title":"<code>MDSectionInclude</code>","text":"<p>               Bases: <code>TrestleJinjaExtension</code></p> <p>Inject the parameter of the tag as the resulting content.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>class MDSectionInclude(TrestleJinjaExtension):\n    \"\"\"Inject the parameter of the tag as the resulting content.\"\"\"\n\n    tags = {'mdsection_include'}\n\n    def __init__(self, environment: Environment) -&gt; None:\n        \"\"\"Ensure enviroment is set and carried into class vars.\"\"\"\n        super().__init__(environment)\n\n    def parse(self, parser):\n        \"\"\"Execute parsing of md token and return nodes.\"\"\"\n        kwargs = None\n        expected_heading_level = None\n        count = 0\n        while parser.stream.current.type != lexer.TOKEN_BLOCK_END:\n            count = count + 1\n            if count &gt; self.max_tag_parse:\n                raise err.TrestleError('Unexpected Jinja tag structure provided, please review docs.')\n            token = parser.stream.current\n            if token.test('name:mdsection_include'):\n                parser.stream.expect(lexer.TOKEN_NAME)\n                markdown_source = parser.stream.expect(lexer.TOKEN_STRING)\n                section_title = parser.stream.expect(lexer.TOKEN_STRING)\n            elif kwargs is not None:\n                arg = token.value\n                next(parser.stream)\n                parser.stream.expect(lexer.TOKEN_ASSIGN)\n                token = parser.stream.current\n                exp = self.parse_expression(parser)\n                kwargs[arg] = exp.value\n            else:\n                if parser.stream.look().type == lexer.TOKEN_ASSIGN:\n                    kwargs = {}\n                continue\n        # Use the established environment to source the file\n        md_content, _, _ = self.environment.loader.get_source(self.environment, markdown_source.value)\n        fm = frontmatter.loads(md_content)\n        if not fm.metadata == {}:\n            logger.warning('Non zero metadata on MD section include - ignoring')\n        full_md = docs_markdown_node.DocsMarkdownNode.build_tree_from_markdown(fm.content.split('\\n'))\n        md_section = full_md.get_node_for_key(section_title.value, strict_matching=True)\n        # adjust\n        if kwargs is not None:\n            expected_heading_level = kwargs.get('heading_level')\n        if expected_heading_level is not None:\n            level = md_section.get_node_header_lvl()\n            delta = int(expected_heading_level) - level\n            if not delta == 0:\n                md_section.change_header_level_by(delta)\n        if not md_section:\n            raise err.TrestleError(\n                f'Unable to retrieve section \"{section_title.value}\"\" from {markdown_source.value} jinja template.'\n            )\n        local_parser = Parser(self.environment, md_section.content.raw_text)\n        top_level_output = local_parser.parse()\n\n        return top_level_output.body\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDSectionInclude-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDSectionInclude.tags","title":"<code>tags = {'mdsection_include'}</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDSectionInclude-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDSectionInclude.__init__","title":"<code>__init__(environment)</code>","text":"<p>Ensure enviroment is set and carried into class vars.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>def __init__(self, environment: Environment) -&gt; None:\n    \"\"\"Ensure enviroment is set and carried into class vars.\"\"\"\n    super().__init__(environment)\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.MDSectionInclude.parse","title":"<code>parse(parser)</code>","text":"<p>Execute parsing of md token and return nodes.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>def parse(self, parser):\n    \"\"\"Execute parsing of md token and return nodes.\"\"\"\n    kwargs = None\n    expected_heading_level = None\n    count = 0\n    while parser.stream.current.type != lexer.TOKEN_BLOCK_END:\n        count = count + 1\n        if count &gt; self.max_tag_parse:\n            raise err.TrestleError('Unexpected Jinja tag structure provided, please review docs.')\n        token = parser.stream.current\n        if token.test('name:mdsection_include'):\n            parser.stream.expect(lexer.TOKEN_NAME)\n            markdown_source = parser.stream.expect(lexer.TOKEN_STRING)\n            section_title = parser.stream.expect(lexer.TOKEN_STRING)\n        elif kwargs is not None:\n            arg = token.value\n            next(parser.stream)\n            parser.stream.expect(lexer.TOKEN_ASSIGN)\n            token = parser.stream.current\n            exp = self.parse_expression(parser)\n            kwargs[arg] = exp.value\n        else:\n            if parser.stream.look().type == lexer.TOKEN_ASSIGN:\n                kwargs = {}\n            continue\n    # Use the established environment to source the file\n    md_content, _, _ = self.environment.loader.get_source(self.environment, markdown_source.value)\n    fm = frontmatter.loads(md_content)\n    if not fm.metadata == {}:\n        logger.warning('Non zero metadata on MD section include - ignoring')\n    full_md = docs_markdown_node.DocsMarkdownNode.build_tree_from_markdown(fm.content.split('\\n'))\n    md_section = full_md.get_node_for_key(section_title.value, strict_matching=True)\n    # adjust\n    if kwargs is not None:\n        expected_heading_level = kwargs.get('heading_level')\n    if expected_heading_level is not None:\n        level = md_section.get_node_header_lvl()\n        delta = int(expected_heading_level) - level\n        if not delta == 0:\n            md_section.change_header_level_by(delta)\n    if not md_section:\n        raise err.TrestleError(\n            f'Unable to retrieve section \"{section_title.value}\"\" from {markdown_source.value} jinja template.'\n        )\n    local_parser = Parser(self.environment, md_section.content.raw_text)\n    top_level_output = local_parser.parse()\n\n    return top_level_output.body\n</code></pre>"},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/jinja/tags/#trestle.core.jinja.tags.adjust_heading_level","title":"<code>adjust_heading_level(input_md, expected)</code>","text":"<p>Adjust the header level of a markdown string such that the most significant header matches the expected #'s.</p> Source code in <code>trestle/core/jinja/tags.py</code> <pre><code>def adjust_heading_level(input_md: str, expected: int) -&gt; str:\n    \"\"\"Adjust the header level of a markdown string such that the most significant header matches the expected #'s.\"\"\"\n    output_md = input_md\n    mdn = docs_markdown_node.DocsMarkdownNode.build_tree_from_markdown(input_md.split('\\n'))\n    if mdn.subnodes:\n        mdn_top_heading = mdn.subnodes[0].get_node_header_lvl()\n        delta = int(expected) - mdn_top_heading\n        if not delta == 0:\n            mdn.change_header_level_by(delta)\n            output_md = mdn.content.raw_text\n    return output_md\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/","title":"trestle.core.markdown.base_markdown_node","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node","title":"<code>trestle.core.markdown.base_markdown_node</code>","text":"<p>A base markdown node.</p>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode","title":"<code>BaseMarkdownNode</code>","text":"<p>Markdown will be read to the tree.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>class BaseMarkdownNode:\n    \"\"\"Markdown will be read to the tree.\"\"\"\n\n    def __init__(self, key: str, content: BaseSectionContent, starting_line: int):\n        \"\"\"Initialize markdown node.\"\"\"\n        self.subnodes: List[BaseMarkdownNode] = []\n        self.key = key\n        self.content = content\n        self.starting_line = starting_line\n\n    @classmethod\n    def build_tree_from_markdown(cls, lines: List[str]) -&gt; BaseMarkdownNode:\n        \"\"\"Construct a tree out of the given markdown.\"\"\"\n        ob = cls.__new__(cls)\n        start_level = ob._get_max_header_lvl(lines)\n        ob, _ = ob._build_tree(lines, 'root', 0, start_level)\n        return ob\n\n    def get_all_headers_for_level(self, level: int) -&gt; Iterable[str]:\n        \"\"\"Return all headers per specified level of hierarchy.\"\"\"\n        return list(\n            filter(lambda header: self._get_header_level_if_valid(header) == level, self.content.subnodes_keys)\n        ).__iter__()\n\n    def get_node_for_key(self, key: str, strict_matching: bool = True) -&gt; Optional[BaseMarkdownNode]:\n        \"\"\"Return a first node for the given key, substring matching is supported. The method is case insensitive.\"\"\"\n        if not strict_matching:\n            if not any(key.lower() in el.lower() for el in self.content.subnodes_keys):\n                return None\n            elif len(as_filtered_list(self.content.subnodes_keys, lambda el: key.lower() in el.lower())) &gt; 1:\n                logger.warning(f'Multiple nodes for {key} were found, only the first one will be returned.')\n        else:\n            if key.lower() not in [el.lower() for el in self.content.subnodes_keys]:\n                return None\n            elif len(as_filtered_list(self.content.subnodes_keys, lambda el: el.lower() == key.lower())) &gt; 1:\n                logger.warning(f'Multiple nodes for {key} were found, only the first one will be returned.')\n\n        return self._rec_traverse(self, key, strict_matching)\n\n    def get_all_nodes_for_keys(\n        self,\n        keys: List[str],\n        strict_matching: bool = True,\n        stop_recurse_on_first_match: bool = False\n    ) -&gt; List[BaseMarkdownNode]:\n        \"\"\"\n        Return all nodes for the given keys, substring matching is supported.\n\n        Args:\n            keys: List of strings for the headers being collected\n            strict_matching: Force exact match of key with header vs. simple substring match\n            stop_recurse_on_first_match: Return first match of any of the keys and don't search subnodes\n\n        Returns: List of found markdown nodes\n        \"\"\"\n        if not strict_matching:\n            if not any(key in el for el in self.content.subnodes_keys for key in keys):\n                return []\n        elif not set(keys).intersection(self.content.subnodes_keys):\n            return []\n\n        return self._rec_traverse_all(self, keys, strict_matching, stop_recurse_on_first_match)\n\n    def get_all_headers_for_key(self, key: str, strict_matching: bool = True) -&gt; Iterable[str]:\n        \"\"\"Return all headers contained in the node with a given key.\"\"\"\n        if strict_matching:\n            return list(filter(lambda header: key == header, self.content.subnodes_keys)).__iter__()\n        else:\n            return list(filter(lambda header: key in header, self.content.subnodes_keys)).__iter__()\n\n    def get_node_header_lvl(self) -&gt; Optional[int]:\n        \"\"\"Return current node header level.\"\"\"\n        return self._get_header_level_if_valid(self.key)\n\n    def change_header_level_by(self, delta_level: int) -&gt; None:\n        \"\"\"\n        Change all headers in the tree by specified level up or down.\n\n        All children nodes will be modified by specified level as well.\n\n        Args:\n            delta_level: each header will be modified by this number, can be negative.\n        \"\"\"\n        # construct a map\n        header_map = {}\n        if self.key != 'root':\n            new_key = self._modify_header_level(self.key, delta_level)\n            header_map[self.key] = new_key\n        for key in self.content.subnodes_keys:\n            new_key = self._modify_header_level(key, delta_level)\n            header_map[key] = new_key\n\n        # go through all contents and modify headers\n        self._rec_traverse_header_update(self, header_map)\n\n    def delete_nodes_text(self, keys: List[str], strict_matching: bool = True) -&gt; List[str]:\n        \"\"\"Remove text from this node that is found in matching subnodes.\"\"\"\n        text_lines = self.content.raw_text.split('\\n')\n        matching_nodes = self.get_all_nodes_for_keys(keys, strict_matching, True)\n        # need to delete from end and proceed backwards\n        sorted_nodes = sorted(matching_nodes, key=lambda node: node.starting_line, reverse=True)\n        for node in sorted_nodes:\n            last_line = node.starting_line + len(node.content.raw_text.split('\\n'))\n            delete_list_from_list(text_lines, list(range(node.starting_line, last_line)))\n        return text_lines\n\n    @abstractmethod\n    def _build_tree(self, lines: List[str], root_key: str, starting_line: int,\n                    level: int) -&gt; Tuple[BaseMarkdownNode, int]:\n        \"\"\"Build a tree from the markdown recursively.\"\"\"\n        pass\n\n    def _modify_header_level(self, header: str, delta_level: int) -&gt; str:\n        \"\"\"Modify header level by specified level.\"\"\"\n        if delta_level == 0:\n            logger.debug('Nothing to modify in header, level 0 is given.')\n            return header\n\n        current_level = self._get_header_level_if_valid(header)\n        if current_level is None:\n            current_level = 0\n        if current_level + delta_level &lt; 0:\n            logger.warning(\n                f'Cannot substract {delta_level} as level of {header} is {current_level}. All `#` will be removed.'\n            )\n            delta_level = current_level * -1\n\n        if current_level + delta_level == 0:\n            replacement = ''\n        else:\n            replacement = '#' * (current_level + delta_level)\n        header = header.replace('#' * current_level, replacement)\n\n        return header.strip(' ')\n\n    def _get_header_level_if_valid(self, line: str) -&gt; Optional[int]:\n        \"\"\"\n        Return a level of the header if the given line is indeed a header.\n\n        Level of the header is determined by the number of # symbols.\n        \"\"\"\n        header_symbols = re.match(md_const.HEADER_REGEX, line)\n        # Header is valid only if it line starts with header\n        if header_symbols is not None and header_symbols.regs[0][0] == 0:\n            return header_symbols.regs[0][1]\n        return None\n\n    def _does_start_with(self, line: str, start_chars: str) -&gt; bool:\n        \"\"\"Determine whether the line starts with given characters.\"\"\"\n        return line.startswith(start_chars)\n\n    def _does_contain(self, line: str, reg: str) -&gt; bool:\n        \"\"\"Determine if the line matches regex.\"\"\"\n        if len(line) == 0 and reg != r'':\n            return False\n        regexp = re.compile(reg)\n        return regexp.search(line) is not None\n\n    def _read_code_lines(self, lines: List[str], line: str, i: int) -&gt; tuple[list[str], int]:\n        \"\"\"Read code block.\"\"\"\n        code_lines = [line]\n        while True:\n            if i &gt;= len(lines):\n                raise TrestleError(f'Code block is not closed: {code_lines}')\n\n            line = lines[i]\n            code_lines.append(line)\n            i += 1\n            if self._does_contain(line, md_const.CODEBLOCK_DEF):\n                break\n        return code_lines, i\n\n    def _read_html_block(self, lines: List[str], line: str, i: int, ending_regex: str) -&gt; tuple[list[str], int]:\n        \"\"\"Read html block.\"\"\"\n        html_block = [line]\n        if self._does_contain(line, r'&lt;br[ /]*&gt;'):\n            return html_block, i\n        if self._does_contain(line, ending_regex):\n            return html_block, i\n        while True:\n            if i &gt;= len(lines):\n                raise TrestleError(f'HTML block is not closed: {html_block}')\n\n            line = lines[i]\n            html_block.append(line)\n            i += 1\n            if self._does_contain(line, ending_regex):\n                break\n        return html_block, i\n\n    def _read_table_block(self, lines: List[str], line: str, i: int) -&gt; tuple[list[str], int]:\n        \"\"\"Read table.\"\"\"\n        table_block = [line]\n        while True:\n            if i &gt;= len(lines):\n                return table_block, i\n\n            line = lines[i]\n            if not self._does_contain(line, md_const.TABLE_REGEX):\n                table_block.append(line)\n                break\n            table_block.append(line)\n            i += 1\n        return table_block, i\n\n    def _rec_traverse(self, node: BaseMarkdownNode, key: str, strict_matching: bool) -&gt; Optional[BaseMarkdownNode]:\n        \"\"\"\n        Recursevely traverses the tree and searches for the given key.\n\n        If strict matching is turned off, node will be matched if key is a substring of the node's header.\n        \"\"\"\n        if key.lower() == node.key.lower() or (not strict_matching and key.lower() in node.key.lower()):\n            return node\n        if (not strict_matching and any(key.lower() in el.lower()\n                                        for el in node.content.subnodes_keys)) or (key.lower() in [\n                                            el.lower() for el in node.content.subnodes_keys\n                                        ]):\n            for subnode in node.subnodes:\n                matched_node = self._rec_traverse(subnode, key, strict_matching)\n                if matched_node is not None:\n                    return matched_node\n\n        return None\n\n    def _rec_traverse_all(\n        self, node: BaseMarkdownNode, keys: List[str], strict_matching: bool, stop_recurse_on_first_match: bool\n    ) -&gt; List[BaseMarkdownNode]:\n        \"\"\"\n        Recursevely traverse the tree and find all nodes matching the keys.\n\n        If strict matching is turned off, nodes will be matched if key is a substring of the node's header.\n        stop_recurse_on_first_match will return only the highest level key match and not any subnodes\n        \"\"\"\n        found_nodes: List[BaseMarkdownNode] = []\n        for key in keys:\n            if key == node.key or (not strict_matching and key in node.key):\n                found_nodes.append(node)\n                if stop_recurse_on_first_match:\n                    return found_nodes\n        for subnode in node.subnodes:\n            matched_nodes = self._rec_traverse_all(subnode, keys, strict_matching, stop_recurse_on_first_match)\n            found_nodes.extend(matched_nodes)\n        return found_nodes\n\n    def _rec_traverse_header_update(self, node: BaseMarkdownNode, header_map: Dict[str, str]) -&gt; None:\n        \"\"\"Recursively traverse tree and update the contents.\"\"\"\n        if node:\n            if node.key != 'root':\n                new_key = header_map[node.key]\n                node.key = new_key\n\n            # update text\n            lines = node.content.raw_text.split('\\n')\n            if lines:\n                for i in range(0, len(lines)):\n                    line = lines[i]\n                    if line in header_map.keys():\n                        new_key = header_map[line]\n                        lines[i] = new_key\n                    elif line.strip(' ') in header_map.keys():\n                        # keep spaces if any\n                        new_key = header_map[line.strip(' ')]\n                        lines[i] = line.replace(line.strip(' '), new_key)\n\n                node.content.raw_text = '\\n'.join(lines)\n\n            # update subnodes\n            if node.content.subnodes_keys:\n                for i in range(0, len(node.content.subnodes_keys)):\n                    subnode_key = node.content.subnodes_keys[i]\n                    if subnode_key in header_map.keys():\n                        new_key = header_map[subnode_key]\n                        node.content.subnodes_keys[i] = new_key\n\n        for subnode in node.subnodes:\n            self._rec_traverse_header_update(subnode, header_map)\n\n    def _get_max_header_lvl(self, lines: List[str]) -&gt; int:\n        \"\"\"Go through all lines to determine highest header level. Less # means higher.\"\"\"\n        min_lvl = math.inf\n        for line in lines:\n            line = line.strip(' ')\n            header_lvl = self._get_header_level_if_valid(line)\n\n            if header_lvl is not None and header_lvl &lt; min_lvl:\n                min_lvl = header_lvl\n\n        return min_lvl - 1\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.content","title":"<code>content = content</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.key","title":"<code>key = key</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.starting_line","title":"<code>starting_line = starting_line</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.subnodes","title":"<code>subnodes: List[BaseMarkdownNode] = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.__init__","title":"<code>__init__(key, content, starting_line)</code>","text":"<p>Initialize markdown node.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def __init__(self, key: str, content: BaseSectionContent, starting_line: int):\n    \"\"\"Initialize markdown node.\"\"\"\n    self.subnodes: List[BaseMarkdownNode] = []\n    self.key = key\n    self.content = content\n    self.starting_line = starting_line\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.build_tree_from_markdown","title":"<code>build_tree_from_markdown(lines)</code>  <code>classmethod</code>","text":"<p>Construct a tree out of the given markdown.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>@classmethod\ndef build_tree_from_markdown(cls, lines: List[str]) -&gt; BaseMarkdownNode:\n    \"\"\"Construct a tree out of the given markdown.\"\"\"\n    ob = cls.__new__(cls)\n    start_level = ob._get_max_header_lvl(lines)\n    ob, _ = ob._build_tree(lines, 'root', 0, start_level)\n    return ob\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.change_header_level_by","title":"<code>change_header_level_by(delta_level)</code>","text":"<p>Change all headers in the tree by specified level up or down.</p> <p>All children nodes will be modified by specified level as well.</p> <p>Parameters:</p> Name Type Description Default <code>delta_level</code> <code>int</code> <p>each header will be modified by this number, can be negative.</p> required Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def change_header_level_by(self, delta_level: int) -&gt; None:\n    \"\"\"\n    Change all headers in the tree by specified level up or down.\n\n    All children nodes will be modified by specified level as well.\n\n    Args:\n        delta_level: each header will be modified by this number, can be negative.\n    \"\"\"\n    # construct a map\n    header_map = {}\n    if self.key != 'root':\n        new_key = self._modify_header_level(self.key, delta_level)\n        header_map[self.key] = new_key\n    for key in self.content.subnodes_keys:\n        new_key = self._modify_header_level(key, delta_level)\n        header_map[key] = new_key\n\n    # go through all contents and modify headers\n    self._rec_traverse_header_update(self, header_map)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.delete_nodes_text","title":"<code>delete_nodes_text(keys, strict_matching=True)</code>","text":"<p>Remove text from this node that is found in matching subnodes.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def delete_nodes_text(self, keys: List[str], strict_matching: bool = True) -&gt; List[str]:\n    \"\"\"Remove text from this node that is found in matching subnodes.\"\"\"\n    text_lines = self.content.raw_text.split('\\n')\n    matching_nodes = self.get_all_nodes_for_keys(keys, strict_matching, True)\n    # need to delete from end and proceed backwards\n    sorted_nodes = sorted(matching_nodes, key=lambda node: node.starting_line, reverse=True)\n    for node in sorted_nodes:\n        last_line = node.starting_line + len(node.content.raw_text.split('\\n'))\n        delete_list_from_list(text_lines, list(range(node.starting_line, last_line)))\n    return text_lines\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_key","title":"<code>get_all_headers_for_key(key, strict_matching=True)</code>","text":"<p>Return all headers contained in the node with a given key.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def get_all_headers_for_key(self, key: str, strict_matching: bool = True) -&gt; Iterable[str]:\n    \"\"\"Return all headers contained in the node with a given key.\"\"\"\n    if strict_matching:\n        return list(filter(lambda header: key == header, self.content.subnodes_keys)).__iter__()\n    else:\n        return list(filter(lambda header: key in header, self.content.subnodes_keys)).__iter__()\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_headers_for_level","title":"<code>get_all_headers_for_level(level)</code>","text":"<p>Return all headers per specified level of hierarchy.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def get_all_headers_for_level(self, level: int) -&gt; Iterable[str]:\n    \"\"\"Return all headers per specified level of hierarchy.\"\"\"\n    return list(\n        filter(lambda header: self._get_header_level_if_valid(header) == level, self.content.subnodes_keys)\n    ).__iter__()\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_all_nodes_for_keys","title":"<code>get_all_nodes_for_keys(keys, strict_matching=True, stop_recurse_on_first_match=False)</code>","text":"<p>Return all nodes for the given keys, substring matching is supported.</p> <p>Parameters:</p> Name Type Description Default <code>keys</code> <code>List[str]</code> <p>List of strings for the headers being collected</p> required <code>strict_matching</code> <code>bool</code> <p>Force exact match of key with header vs. simple substring match</p> <code>True</code> <code>stop_recurse_on_first_match</code> <code>bool</code> <p>Return first match of any of the keys and don't search subnodes</p> <code>False</code> <p>Returns: List of found markdown nodes</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def get_all_nodes_for_keys(\n    self,\n    keys: List[str],\n    strict_matching: bool = True,\n    stop_recurse_on_first_match: bool = False\n) -&gt; List[BaseMarkdownNode]:\n    \"\"\"\n    Return all nodes for the given keys, substring matching is supported.\n\n    Args:\n        keys: List of strings for the headers being collected\n        strict_matching: Force exact match of key with header vs. simple substring match\n        stop_recurse_on_first_match: Return first match of any of the keys and don't search subnodes\n\n    Returns: List of found markdown nodes\n    \"\"\"\n    if not strict_matching:\n        if not any(key in el for el in self.content.subnodes_keys for key in keys):\n            return []\n    elif not set(keys).intersection(self.content.subnodes_keys):\n        return []\n\n    return self._rec_traverse_all(self, keys, strict_matching, stop_recurse_on_first_match)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_for_key","title":"<code>get_node_for_key(key, strict_matching=True)</code>","text":"<p>Return a first node for the given key, substring matching is supported. The method is case insensitive.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def get_node_for_key(self, key: str, strict_matching: bool = True) -&gt; Optional[BaseMarkdownNode]:\n    \"\"\"Return a first node for the given key, substring matching is supported. The method is case insensitive.\"\"\"\n    if not strict_matching:\n        if not any(key.lower() in el.lower() for el in self.content.subnodes_keys):\n            return None\n        elif len(as_filtered_list(self.content.subnodes_keys, lambda el: key.lower() in el.lower())) &gt; 1:\n            logger.warning(f'Multiple nodes for {key} were found, only the first one will be returned.')\n    else:\n        if key.lower() not in [el.lower() for el in self.content.subnodes_keys]:\n            return None\n        elif len(as_filtered_list(self.content.subnodes_keys, lambda el: el.lower() == key.lower())) &gt; 1:\n            logger.warning(f'Multiple nodes for {key} were found, only the first one will be returned.')\n\n    return self._rec_traverse(self, key, strict_matching)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseMarkdownNode.get_node_header_lvl","title":"<code>get_node_header_lvl()</code>","text":"<p>Return current node header level.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def get_node_header_lvl(self) -&gt; Optional[int]:\n    \"\"\"Return current node header level.\"\"\"\n    return self._get_header_level_if_valid(self.key)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseSectionContent","title":"<code>BaseSectionContent</code>","text":"<p>A content of the node.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>class BaseSectionContent:\n    \"\"\"A content of the node.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize section content.\"\"\"\n        self.raw_text = ''\n        self.subnodes_keys: List[str] = []\n\n    def union(self, node: BaseMarkdownNode) -&gt; None:\n        \"\"\"Unites contents together.\"\"\"\n        self.subnodes_keys.append(node.key)\n        self.subnodes_keys.extend(node.content.subnodes_keys)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseSectionContent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseSectionContent.raw_text","title":"<code>raw_text = ''</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseSectionContent.subnodes_keys","title":"<code>subnodes_keys: List[str] = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseSectionContent-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseSectionContent.__init__","title":"<code>__init__()</code>","text":"<p>Initialize section content.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize section content.\"\"\"\n    self.raw_text = ''\n    self.subnodes_keys: List[str] = []\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node.BaseSectionContent.union","title":"<code>union(node)</code>","text":"<p>Unites contents together.</p> Source code in <code>trestle/core/markdown/base_markdown_node.py</code> <pre><code>def union(self, node: BaseMarkdownNode) -&gt; None:\n    \"\"\"Unites contents together.\"\"\"\n    self.subnodes_keys.append(node.key)\n    self.subnodes_keys.extend(node.content.subnodes_keys)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/base_markdown_node/#trestle.core.markdown.base_markdown_node-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/","title":"trestle.core.markdown.control_markdown_node","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node","title":"<code>trestle.core.markdown.control_markdown_node</code>","text":"<p>A control markdown node.</p>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.tree_context","title":"<code>tree_context = TreeContext()</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode","title":"<code>ControlMarkdownNode</code>","text":"<p>               Bases: <code>BaseMarkdownNode</code></p> <p>Markdown will be read to the tree.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>class ControlMarkdownNode(BaseMarkdownNode):\n    \"\"\"Markdown will be read to the tree.\"\"\"\n\n    def __init__(self, key: str, content: ControlSectionContent, starting_line: int):\n        \"\"\"Initialize markdown node.\"\"\"\n        super(ControlMarkdownNode, self).__init__(key, content, starting_line)\n        self.content: ControlSectionContent = content\n\n    def _build_tree(self,\n                    lines: List[str],\n                    root_key: str,\n                    starting_line: int,\n                    level: int,\n                    parent_part_id: str = '') -&gt; Tuple[ControlMarkdownNode, int]:\n        \"\"\"\n        Build a tree from the markdown recursively.\n\n        The tree is contructed with valid headers as node's keys\n        and node's content contains everything that is under that header.\n        The subsections are placed into node's children with the same structure.\n\n        A header is valid iff the line starts with # and it is not:\n          1. Inside of the html blocks\n          2. Inside single lined in the &lt;&gt; tags\n          3. Inside the html comment\n          4. Inside any table, code block or blockquotes\n\n        Specific Control Rules:\n          1. If we are in control statement or objective, no subsections are allowed.\n        \"\"\"\n        content = ControlSectionContent()\n        node_children = []\n        i = starting_line\n\n        section_heading_type = self._get_section_heading_type(root_key)\n\n        part_id, part_name, part_title, by_id_part = self._get_part_info_from_section_name(root_key, parent_part_id,\n                                                                                           section_heading_type)\n\n        current_key_lvl = self._get_header_level_if_valid(root_key)\n\n        if section_heading_type == ControlSectionType.UNDEFINED and tree_context.control_id:\n            logger.warning(\n                f'Undefined section {root_key} is found in the markdown for control {tree_context.control_id}. '\n                f'This section will be ignored. Please make sure the spelling is correct.'\n            )\n\n        if current_key_lvl and current_key_lvl == 1 and section_heading_type != ControlSectionType.EDITABLE_CONTENT:\n            # Parse control title\n            if tree_context.control_id:\n                logger.debug(\n                    f'Duplicate control_id is found for the markdown {root_key}, '\n                    f'make sure you have reset tree context before reading another markdown.'\n                    f'Use markdown processor to avoid this error.'\n                )\n                raise TrestleError(\n                    f'Multiple top-level headers are found but only one header is allowed. See line {root_key} '\n                    f'for control {tree_context.control_id}.'\n                )\n            tree_context.control_id, tree_context.control_group, tree_context.control_title = ControlMarkdownNode._parse_control_title_line(root_key)  # noqa: E501\n            content.control_id = tree_context.control_id\n            content.control_group = tree_context.control_group\n            content.control_title = tree_context.control_title\n\n        def _strip_prose_or_none(part: Optional[common.Part]):\n            if part and part.prose:\n                part.prose = part.prose.strip() if part.prose.strip() else None\n\n        def _add_child_prose_if_need(part: common.Part, text: str, should_add: bool):\n            if should_add:\n                part.prose += text\n\n        while i &lt; len(lines):\n            line = lines[i].strip(' ')\n            header_lvl = self._get_header_level_if_valid(line)\n\n            if header_lvl is not None:\n                if header_lvl &gt;= level + 1:\n                    if section_heading_type in [ControlSectionType.STATEMENT, ControlSectionType.OBJECTIVE]:\n                        raise TrestleError(\n                            f'Control Statement or Objective sections cannot contain subsections but found: {line}.'\n                            f'Please delete this subsection and refer to docs on the required format.'\n                        )\n                    # build subtree\n                    subtree, i = self._build_tree(lines, line, i + 1, level + 1, part_id)\n                    node_children.append(subtree)\n                    content.union(subtree)\n                    if content.part and subtree.content.part and section_heading_type not in [\n                            ControlSectionType.STATEMENT, ControlSectionType.OBJECTIVE, ControlSectionType.GUIDANCE\n                    ]:\n                        # Control statement, objective and guidance have special treatment\n                        # in those sections any subsections go to the prose rather than subparts.\n                        content.part.parts = as_list(content.part.parts)\n                        content.part.parts.append(subtree.content.part)\n                    # Control parts can have general markdown in the prose, if we are in the control part\n                    # add its contents under the prose of a parent\n                    _add_child_prose_if_need(\n                        content.part,\n                        subtree.content.raw_text,\n                        section_heading_type\n                        in [ControlSectionType.STATEMENT, ControlSectionType.OBJECTIVE, ControlSectionType.GUIDANCE]\n                    )\n                    continue\n                else:\n                    i -= 1  # need to revert back one line to properly handle next heading\n                    break  # level of the header is above or equal to the current level, subtree is over\n\n            if section_heading_type not in [ControlSectionType.UNDEFINED, ControlSectionType.EDITABLE_CONTENT]:\n                # Read part\n                content.part = self._create_part_if_needed(content.part, part_name, part_id)\n                content.part.title = part_title\n                read_parts = section_heading_type in [ControlSectionType.STATEMENT, ControlSectionType.OBJECTIVE]\n                if by_id_part and section_heading_type == ControlSectionType.EDITABLE_BY_ID_PART:\n                    content.by_id_name = by_id_part\n                i = self._process_part_line(i, line, lines, content.part, read_parts=read_parts)\n                continue\n\n            # Nothing to do, simply increment\n            i += 1\n\n        first_line_to_grab = starting_line - 1 if starting_line else 0\n        content.raw_text = '\\n'.join(lines[first_line_to_grab:i])\n\n        _strip_prose_or_none(content.part)\n\n        md_node = ControlMarkdownNode(key=root_key, content=content, starting_line=first_line_to_grab)\n        md_node.subnodes = node_children\n        return md_node, i\n\n    def get_control_statement(self) -&gt; Optional[ControlMarkdownNode]:\n        \"\"\"Get control statement node.\"\"\"\n        return self.get_node_for_key('## Control Statement')\n\n    def get_control_objective(self) -&gt; Optional[ControlMarkdownNode]:\n        \"\"\"Get control objective node.\"\"\"\n        return self.get_node_for_key(const.CONTROL_OBJECTIVE_HEADER)\n\n    def get_control_guidance(self) -&gt; Optional[ControlMarkdownNode]:\n        \"\"\"Get control guidance node.\"\"\"\n        return self.get_node_for_key('## Control Guidance')\n\n    def get_by_id_parts(self) -&gt; Dict[str, List[common.Part]]:\n        \"\"\"Get by id editable parts.\"\"\"\n        part_id_to_parts_map = {}\n        for node_key in as_filtered_list(self.content.subnodes_keys, lambda k: re.match(const.PART_REGEX, k)):\n            # A by id part section\n            part_node = self.get_node_for_key(node_key)\n            if not part_node.content.part:\n                raise TrestleError(f'Error no part was found in section {part_node.key}.')\n            if part_node.content.by_id_name not in part_id_to_parts_map:\n                part_id_to_parts_map[part_node.content.by_id_name] = []\n            for subpart in part_node.subnodes:\n                # We only care about subsections of ## Part section\n                if subpart.content.part:\n                    part_id_to_parts_map[part_node.content.by_id_name].append(subpart.content.part)\n\n        return part_id_to_parts_map\n\n    def get_editable_parts_and_subparts(self) -&gt; Optional[List[common.Part]]:\n        \"\"\"Get editable parts and subparts if exist.\"\"\"\n        by_id_parts = self.get_by_id_parts()\n        exclude_parts_id = list(by_id_parts.keys())\n        editable_node = self.get_node_for_key(f'# {const.EDITABLE_CONTENT}')\n        parts = self._get_subparts(editable_node, exclude_parts_id)\n        return parts\n\n    def _get_subparts(self,\n                      control_node: ControlMarkdownNode,\n                      exclude_ids: List[str] = None) -&gt; Optional[List[common.Part]]:\n        \"\"\"Get subparts of the control part node if exists.\"\"\"\n        if not control_node:\n            raise TrestleError(\n                'No control node was provided to extract subparts. '\n                'Please make sure your markdown contains # Editable Content section.'\n            )\n        parts = []\n        for editable_part in as_filtered_list(control_node.subnodes, lambda p: p.content.part is not None):\n            if editable_part.content.part.id not in exclude_ids:\n                parts.append(editable_part.content.part)\n        return parts\n\n    def _get_section_heading_type(self, root_key: str) -&gt; ControlSectionType:\n        \"\"\"Determine the section type based on the heading.\"\"\"\n        if root_key.lower() == '## control statement':\n            return ControlSectionType.STATEMENT\n        elif root_key.lower() == '## control objective':\n            return ControlSectionType.OBJECTIVE\n        elif root_key.lower() == '## control guidance':\n            return ControlSectionType.GUIDANCE\n        elif self._does_contain(root_key, const.PART_REGEX):\n            return ControlSectionType.EDITABLE_BY_ID_PART\n        elif f'# {const.EDITABLE_CONTENT}'.lower() in root_key.lower():\n            return ControlSectionType.EDITABLE_CONTENT\n        elif self._does_contain(root_key, const.CONTROL_REGEX):\n            return ControlSectionType.GENERIC_CONTROL_PART\n        elif '### ' in root_key.lower():\n            return ControlSectionType.GENERIC_SUBPART\n\n        return ControlSectionType.UNDEFINED\n\n    def _get_part_info_from_section_name(self, root_key: str, parent_id: str,\n                                         section_heading_type: ControlSectionType) -&gt; Tuple[str, str, str, str]:\n        \"\"\"Get part information such as id, name and title based on the section heading.\"\"\"\n        part_id = ''\n        part_name = ''\n        part_title = None\n        by_part_id = None  # special case used for ## Part\n\n        if section_heading_type in [ControlSectionType.GUIDANCE, ControlSectionType.GENERIC_CONTROL_PART]:\n            prefix = const.CONTROL_HEADER + ' '\n            control_md_heading_label = root_key[len(prefix):].strip()\n            control_md_heading_label_ncname = ControlInterface.strip_to_make_ncname(control_md_heading_label)\n            control_md_heading_label_snakename = spaces_and_caps_to_snake(control_md_heading_label)\n\n        if section_heading_type == ControlSectionType.STATEMENT:\n            part_id = ControlInterface.create_statement_id(tree_context.control_id)\n            part_name = const.STATEMENT\n\n        if section_heading_type == ControlSectionType.OBJECTIVE:\n            part_id = f'{tree_context.control_id}_obj'\n            part_name = 'objective'\n\n        if section_heading_type == ControlSectionType.GUIDANCE:\n            # Read control guidance to a part object\n            part_id = ControlInterface.strip_to_make_ncname(tree_context.control_id + '_gdn')\n            part_name = control_md_heading_label_ncname\n\n        if section_heading_type == ControlSectionType.EDITABLE_BY_ID_PART:\n            # Read editable part\n            by_part_label = re.match(const.PART_REGEX, root_key.lower()).groups(0)[0]\n            control_label_map = tree_context.part_label_to_id_map.get(tree_context.control_id, None)\n            if control_label_map is None:\n                raise TrestleError(f'No label map found for control {tree_context.control_id}')\n            by_part_id = control_label_map.get(by_part_label, None)\n            if by_part_id is None:\n                raise TrestleError(f'No part id found for label {by_part_label} in control {tree_context.control_id}')\n\n            part_name = spaces_and_caps_to_snake(root_key.replace('#', '').replace('.', '').strip())\n            part_id = f'{by_part_id}'\n            part_title = root_key.replace('#', '').strip()\n\n        if section_heading_type == ControlSectionType.GENERIC_CONTROL_PART:\n            # Read other control parts to a part objects\n            part_name = control_md_heading_label_snakename\n            if tree_context.section_to_part_name_map:\n                if control_md_heading_label in tree_context.section_to_part_name_map:\n                    part_name = tree_context.section_to_part_name_map[control_md_heading_label]\n\n                part_id = f'{tree_context.control_id}_{part_name}'\n                part_title = control_md_heading_label\n            else:\n                part_id = spaces_and_caps_to_snake(tree_context.control_id + '_' + control_md_heading_label)\n\n        if section_heading_type == ControlSectionType.GENERIC_SUBPART:\n            # Read other control parts to a part objects\n            match = re.match(const.AFTER_HASHES_REGEX, root_key)\n            if not match:\n                raise TrestleError(f'Unexpected editable header {root_key} found in part {part_id}')\n            part_name_raw = match.groups(0)[0]\n            part_name = spaces_and_caps_to_snake(part_name_raw)\n            parent_suffix = parent_id + '.' if parent_id else ''\n            part_id = parent_suffix + part_name\n\n        return part_id, part_name, part_title, by_part_id\n\n    def get_other_control_parts(self) -&gt; List[Optional[ControlMarkdownNode]]:\n        \"\"\"Get all other control parts that are not statement, guidance or objective.\"\"\"\n        all_other_nodes = []\n        all_control_sections = self.get_all_headers_for_key(const.CONTROL_HEADER, False)\n        control_statement = self.get_control_statement()\n        control_objective = self.get_control_objective()\n        control_guidance = self.get_control_guidance()\n        control_statement_heading = control_statement.key if control_statement else ''\n        control_objective_heading = control_objective.key if control_objective else ''\n        control_guidance_heading = control_guidance.key if control_guidance else ''\n        for heading_key in all_control_sections:\n            if heading_key not in {control_statement_heading, control_objective_heading, control_guidance_heading}:\n                section_node = self.get_node_for_key(heading_key)\n                all_other_nodes.append(section_node)\n\n        return all_other_nodes\n\n    def _create_part_if_needed(self, content_part: common.Part, part_name: str, part_id: str, prose: str = ''):\n        \"\"\"Create a new part if does not exist or return existing part.\"\"\"\n        if not content_part:\n            if not tree_context.control_id:\n                raise TrestleError(\n                    f'Unexpected error, control id, group and title should be before ## Control {part_name}.'\n                    'However, none was found.'\n                )\n\n            content_part = common.Part(name=part_name, id=part_id, prose=prose)\n\n        return content_part\n\n    def _process_part_line(\n        self, line_idx: int, line: str, lines: List[str], part: common.Part, read_parts: bool = True\n    ) -&gt; int:\n        \"\"\"\n        Process line for the part.\n\n        If the read_parts is given and the line starts with '-' then\n        the markdown list will be read to the subparts of the given part.\n        \"\"\"\n        if self._does_start_with(line, HTML_COMMENT_START):\n            comment_lines, line_idx = self._read_html_block(lines, line, line_idx + 1, HTML_COMMENT_END_REGEX)\n            if line_idx &gt;= len(lines):\n                return line_idx\n            line = lines[line_idx]\n\n        if self._does_start_with(line, CODEBLOCK_DEF):\n            code_lines, line_idx = self._read_code_lines(lines, line, line_idx + 1)\n            if line_idx &gt;= len(lines):\n                return line_idx\n            line = lines[line_idx]\n            part.prose += '\\n'.join(code_lines)\n\n        if not line or not line.lstrip():\n            # Empty line\n            part.prose += '\\n'\n            line_idx += 1\n            return line_idx\n\n        if line.lstrip()[0] != '-' or not read_parts:\n            # Line of text in prose\n            part.prose += line + '\\n'\n            line_idx += 1\n        else:\n            # A part of inside of statement part\n            if read_parts:\n                end_idx, parts = self._read_parts(0, line_idx, lines, part.id, [])\n                part.parts = none_if_empty(parts)\n                line_idx = end_idx\n            else:\n                logger.warning(\n                    f'{part.name} does not support subparts, ignoring {line} in control {tree_context.control_id}.'\n                )\n                line_idx += 1\n\n        return line_idx\n\n    def _read_parts(self, indent: int, ii: int, lines: List[str], parent_id: str,\n                    parts: List[common.Part]) -&gt; Tuple[int, List[common.Part]]:\n        \"\"\"If indentation level goes up or down, create new list or close current one.\"\"\"\n        while True:\n            ii, new_indent, line = ControlMarkdownNode._get_next_indent(ii, lines)\n            if new_indent &lt; 0:\n                # we are done reading control statement\n                return ii, parts\n            if new_indent == indent:\n                # create new item part and add to current list of parts\n                id_text, prose = ControlMarkdownNode._read_part_id_prose(line)\n                # id_text is the part id and needs to be as a label property value\n                # if none is there then create one from previous part, or use default\n                if not id_text:\n                    prev_label = ControlInterface.get_label(parts[-1]) if parts else ''\n                    id_text = ControlMarkdownNode._create_next_label(prev_label, indent)\n                id_ = ControlInterface.strip_to_make_ncname(parent_id.rstrip('.') + '.' + id_text.strip('.'))\n                name = const.OBJECTIVE_PART if id_.find('_obj') &gt; 0 else const.ITEM\n                prop = common.Property(name='label', value=id_text)\n                part = common.Part(name=name, id=id_, prose=prose, props=[prop])\n                if id_ in [p.id for p in parts]:\n                    logger.warning(\n                        f'Duplicate part id {id_} is found in markdown '\n                        f'{tree_context.control_id}. Please correct the part label in line {line}.'\n                    )\n                parts.append(part)\n                ii += 1\n            elif new_indent &gt; indent:\n                # add new list of parts to last part and continue\n                if len(parts) == 0:\n                    raise TrestleError(f'Improper indentation structure: {line}')\n                ii, new_parts = self._read_parts(new_indent, ii, lines, parts[-1].id, [])\n                if new_parts:\n                    parts[-1].parts = new_parts\n            else:\n                # return list of sub-parts\n                return ii, parts\n\n    @staticmethod\n    def _indent(line: str) -&gt; int:\n        \"\"\"Measure indent of non-empty line.\"\"\"\n        if not line:\n            raise TrestleError('Empty line queried for indent.')\n        if line[0] not in [' ', '-', '\\t']:\n            return -1\n\n        indent = 0\n        for ii in range(len(line)):\n            if line[ii] == '-':\n                return indent\n            # if line is indented it must start with -\n            if line[ii] == '\\t':\n                # treat tab as two spaces\n                indent += 2\n            elif line[ii] != ' ':\n                break\n            else:\n                indent += 1\n        raise TrestleError(f'List elements must start with -: {line}')\n\n    @staticmethod\n    def _parse_control_title_line(line: str) -&gt; Tuple[str, str, str]:\n        \"\"\"Process the title line and extract the control id, group title (in brackets) and control title.\"\"\"\n        if line.count('-') == 0:\n            raise TrestleError(f'Markdown control title format error, missing - after control id: {line}')\n        split_line = line.split()\n        if len(split_line) &lt; 3 or split_line[2] != '-':\n            raise TrestleError(f'Cannot parse control markdown title for control_id group and title: {line}')\n        # first token after the #\n        control_id = split_line[1]\n        group_title_start = line.find('\\[')\n        group_title_end = line.find('\\]')\n        if group_title_start &lt; 0 or group_title_end &lt; 0 or group_title_start &gt; group_title_end:\n            raise TrestleError(f'unable to read group title for control {control_id}')\n        group_title = line[group_title_start + 2:group_title_end].strip()\n        control_title = line[group_title_end + 2:].strip()\n        return control_id, group_title, control_title\n\n    @staticmethod\n    def _read_part_id_prose(line: str) -&gt; Tuple[str, str]:\n        \"\"\"Extract the part id letter or number and prose from line.\"\"\"\n        start = line.find('\\\\[')\n        end = line.find('\\\\]')\n        prose = line.strip() if start &lt; 0 else line[end + 2:].strip()\n        id_ = '' if start &lt; 0 or end &lt; 0 else line[start + 2:end]\n        return id_, prose\n\n    @staticmethod\n    def _create_next_label(prev_label: str, indent: int) -&gt; str:\n        \"\"\"\n        Create new label at indent level based on previous label if available.\n\n        If previous label is available, make this the next one in the sequence.\n        Otherwise start with a or 1 on alternate levels of indentation.\n        If alphabetic label reaches z, next one is aa.\n        Numeric ranges from 1 to 9, then 10 etc.\n        \"\"\"\n        if not prev_label:\n            # assume indent goes in steps of 2\n            return ['a', '1'][(indent // 2) % 2]\n        label_prefix = ''\n        label_suffix = prev_label\n        is_char = prev_label[-1] in string.ascii_letters\n        # if it isn't ending in letter or digit just append 'a' to end\n        if not is_char and prev_label[-1] not in string.digits:\n            return prev_label + 'a'\n        # break in middle of string if mixed types\n        if len(prev_label) &gt; 1:\n            ii = len(prev_label) - 1\n            while ii &gt;= 0:\n                if prev_label[ii] not in string.ascii_letters + string.digits:\n                    break\n                if (prev_label[ii] in string.ascii_letters) != is_char:\n                    break\n                ii -= 1\n            if ii &gt;= 0:\n                label_prefix = prev_label[:(ii + 1)]\n                label_suffix = prev_label[(ii + 1):]\n\n        return label_prefix + ControlMarkdownNode._bump_label(label_suffix)\n\n    @staticmethod\n    def _bump_label(label: str) -&gt; str:\n        \"\"\"\n        Find next label given a string of 1 or more pure letters or digits.\n\n        The input must be either a string of digits or a string of ascii letters - or empty string.\n        \"\"\"\n        if not label:\n            return 'a'\n        if label[0] in string.digits:\n            return str(int(label) + 1)\n        if len(label) == 1 and label[0].lower() &lt; 'z':\n            return chr(ord(label[0]) + 1)\n        # if this happens to be a string of letters, force it lowercase and bump\n        label = label.lower()\n        factor = 1\n        value = 0\n        # delta is needed because a counts as 0 when first value on right, but 1 for all others\n        delta = 0\n        for letter in label[::-1]:\n            value += (ord(letter) - ord('a') + delta) * factor\n            factor *= 26\n            delta = 1\n\n        value += 1\n\n        new_label = ''\n        delta = 0\n        while value &gt; 0:\n            new_label += chr(ord('a') + value % 26 - delta)\n            value = value // 26\n            delta = 1\n        return new_label[::-1]\n\n    @staticmethod\n    def _get_next_indent(ii: int, lines: List[str], skip_empty_lines: bool = True) -&gt; Tuple[int, int, str]:\n        \"\"\"Seek to next content line.  ii remains at line read.\"\"\"\n        while 0 &lt;= ii &lt; len(lines):\n            line = lines[ii]\n            if line and not line.isspace():\n                if line[0] == '#':\n                    return ii, -1, line\n                indent = ControlMarkdownNode._indent(line)\n                if indent &gt;= 0:\n                    # extract text after -\n                    start = indent + 1\n                    while start &lt; len(line) and line[start] == ' ':\n                        start += 1\n                    if start &gt;= len(line):\n                        raise TrestleError(f'Invalid line {line}')\n                    return ii, indent, line[start:]\n                return ii, indent, line\n            elif not skip_empty_lines:\n                return ii, -1, line\n            ii += 1\n        return ii, -1, ''\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.content","title":"<code>content: ControlSectionContent = content</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.__init__","title":"<code>__init__(key, content, starting_line)</code>","text":"<p>Initialize markdown node.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def __init__(self, key: str, content: ControlSectionContent, starting_line: int):\n    \"\"\"Initialize markdown node.\"\"\"\n    super(ControlMarkdownNode, self).__init__(key, content, starting_line)\n    self.content: ControlSectionContent = content\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_by_id_parts","title":"<code>get_by_id_parts()</code>","text":"<p>Get by id editable parts.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def get_by_id_parts(self) -&gt; Dict[str, List[common.Part]]:\n    \"\"\"Get by id editable parts.\"\"\"\n    part_id_to_parts_map = {}\n    for node_key in as_filtered_list(self.content.subnodes_keys, lambda k: re.match(const.PART_REGEX, k)):\n        # A by id part section\n        part_node = self.get_node_for_key(node_key)\n        if not part_node.content.part:\n            raise TrestleError(f'Error no part was found in section {part_node.key}.')\n        if part_node.content.by_id_name not in part_id_to_parts_map:\n            part_id_to_parts_map[part_node.content.by_id_name] = []\n        for subpart in part_node.subnodes:\n            # We only care about subsections of ## Part section\n            if subpart.content.part:\n                part_id_to_parts_map[part_node.content.by_id_name].append(subpart.content.part)\n\n    return part_id_to_parts_map\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_guidance","title":"<code>get_control_guidance()</code>","text":"<p>Get control guidance node.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def get_control_guidance(self) -&gt; Optional[ControlMarkdownNode]:\n    \"\"\"Get control guidance node.\"\"\"\n    return self.get_node_for_key('## Control Guidance')\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_objective","title":"<code>get_control_objective()</code>","text":"<p>Get control objective node.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def get_control_objective(self) -&gt; Optional[ControlMarkdownNode]:\n    \"\"\"Get control objective node.\"\"\"\n    return self.get_node_for_key(const.CONTROL_OBJECTIVE_HEADER)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_control_statement","title":"<code>get_control_statement()</code>","text":"<p>Get control statement node.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def get_control_statement(self) -&gt; Optional[ControlMarkdownNode]:\n    \"\"\"Get control statement node.\"\"\"\n    return self.get_node_for_key('## Control Statement')\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_editable_parts_and_subparts","title":"<code>get_editable_parts_and_subparts()</code>","text":"<p>Get editable parts and subparts if exist.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def get_editable_parts_and_subparts(self) -&gt; Optional[List[common.Part]]:\n    \"\"\"Get editable parts and subparts if exist.\"\"\"\n    by_id_parts = self.get_by_id_parts()\n    exclude_parts_id = list(by_id_parts.keys())\n    editable_node = self.get_node_for_key(f'# {const.EDITABLE_CONTENT}')\n    parts = self._get_subparts(editable_node, exclude_parts_id)\n    return parts\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlMarkdownNode.get_other_control_parts","title":"<code>get_other_control_parts()</code>","text":"<p>Get all other control parts that are not statement, guidance or objective.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def get_other_control_parts(self) -&gt; List[Optional[ControlMarkdownNode]]:\n    \"\"\"Get all other control parts that are not statement, guidance or objective.\"\"\"\n    all_other_nodes = []\n    all_control_sections = self.get_all_headers_for_key(const.CONTROL_HEADER, False)\n    control_statement = self.get_control_statement()\n    control_objective = self.get_control_objective()\n    control_guidance = self.get_control_guidance()\n    control_statement_heading = control_statement.key if control_statement else ''\n    control_objective_heading = control_objective.key if control_objective else ''\n    control_guidance_heading = control_guidance.key if control_guidance else ''\n    for heading_key in all_control_sections:\n        if heading_key not in {control_statement_heading, control_objective_heading, control_guidance_heading}:\n            section_node = self.get_node_for_key(heading_key)\n            all_other_nodes.append(section_node)\n\n    return all_other_nodes\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionContent","title":"<code>ControlSectionContent</code>","text":"<p>               Bases: <code>BaseSectionContent</code></p> <p>A content of the node.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>class ControlSectionContent(BaseSectionContent):\n    \"\"\"A content of the node.\"\"\"\n\n    def __init__(self):\n        \"\"\"Initialize section content.\n\n        Attributes:\n            part: A part that is found in markdown. A part is defined in markdown by two or more # symbols\n            by_id_name: Required for parts defined as ## Part a in a markdown\n        \"\"\"\n        super(ControlSectionContent, self).__init__()\n        self.part = None\n        self.by_id_name = ''\n\n    def union(self, node: ControlMarkdownNode) -&gt; None:\n        \"\"\"Unites contents together.\"\"\"\n        super().union(node)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionContent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionContent.by_id_name","title":"<code>by_id_name = ''</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionContent.part","title":"<code>part = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionContent-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionContent.__init__","title":"<code>__init__()</code>","text":"<p>Initialize section content.</p> <p>Attributes:</p> Name Type Description <code>part</code> <p>A part that is found in markdown. A part is defined in markdown by two or more # symbols</p> <code>by_id_name</code> <p>Required for parts defined as ## Part a in a markdown</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def __init__(self):\n    \"\"\"Initialize section content.\n\n    Attributes:\n        part: A part that is found in markdown. A part is defined in markdown by two or more # symbols\n        by_id_name: Required for parts defined as ## Part a in a markdown\n    \"\"\"\n    super(ControlSectionContent, self).__init__()\n    self.part = None\n    self.by_id_name = ''\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionContent.union","title":"<code>union(node)</code>","text":"<p>Unites contents together.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def union(self, node: ControlMarkdownNode) -&gt; None:\n    \"\"\"Unites contents together.\"\"\"\n    super().union(node)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType","title":"<code>ControlSectionType</code>","text":"<p>               Bases: <code>Enum</code></p> <p>A type of the section in the markdown.</p> <p>Supported types: 1 - Control Statement 2 - Control Objective 3 - Control Guidance 4 - ## Part foo 5 - Control foo 6 - ### foo 7 - # Editable content</p> <p>Matching is case-insensitive.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>class ControlSectionType(Enum):\n    \"\"\"A type of the section in the markdown.\n\n    Supported types:\n    1 - Control Statement\n    2 - Control Objective\n    3 - Control Guidance\n    4 - ## Part foo\n    5 - Control foo\n    6 - ### foo\n    7 - # Editable content\n\n    Matching is case-insensitive.\n    \"\"\"\n\n    STATEMENT = 1\n    OBJECTIVE = 2\n    GUIDANCE = 3\n    EDITABLE_BY_ID_PART = 4\n    GENERIC_CONTROL_PART = 5\n    GENERIC_SUBPART = 6\n    EDITABLE_CONTENT = 7\n    UNDEFINED = 8\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_BY_ID_PART","title":"<code>EDITABLE_BY_ID_PART = 4</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType.EDITABLE_CONTENT","title":"<code>EDITABLE_CONTENT = 7</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_CONTROL_PART","title":"<code>GENERIC_CONTROL_PART = 5</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType.GENERIC_SUBPART","title":"<code>GENERIC_SUBPART = 6</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType.GUIDANCE","title":"<code>GUIDANCE = 3</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType.OBJECTIVE","title":"<code>OBJECTIVE = 2</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType.STATEMENT","title":"<code>STATEMENT = 1</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.ControlSectionType.UNDEFINED","title":"<code>UNDEFINED = 8</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext","title":"<code>TreeContext</code>","text":"<p>A shared singleton tree context.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>class TreeContext:\n    \"\"\"A shared singleton tree context.\"\"\"\n\n    def __init__(self):\n        \"\"\"Initialize tree context.\"\"\"\n        self.control_id = ''\n        self.control_group = ''\n        self.control_title = ''\n        self.part_label_to_id_map = None\n        self.section_to_part_name_map = None\n\n    def reset(self):\n        \"\"\"Reset global control tree context.\"\"\"\n        self.control_id = ''\n        self.control_group = ''\n        self.control_title = ''\n        self.part_label_to_id_map = None\n        self.section_to_part_name_map = None\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext.control_group","title":"<code>control_group = ''</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext.control_id","title":"<code>control_id = ''</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext.control_title","title":"<code>control_title = ''</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext.part_label_to_id_map","title":"<code>part_label_to_id_map = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext.section_to_part_name_map","title":"<code>section_to_part_name_map = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext.__init__","title":"<code>__init__()</code>","text":"<p>Initialize tree context.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def __init__(self):\n    \"\"\"Initialize tree context.\"\"\"\n    self.control_id = ''\n    self.control_group = ''\n    self.control_title = ''\n    self.part_label_to_id_map = None\n    self.section_to_part_name_map = None\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node.TreeContext.reset","title":"<code>reset()</code>","text":"<p>Reset global control tree context.</p> Source code in <code>trestle/core/markdown/control_markdown_node.py</code> <pre><code>def reset(self):\n    \"\"\"Reset global control tree context.\"\"\"\n    self.control_id = ''\n    self.control_group = ''\n    self.control_title = ''\n    self.part_label_to_id_map = None\n    self.section_to_part_name_map = None\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/control_markdown_node/#trestle.core.markdown.control_markdown_node-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/","title":"trestle.core.markdown.docs_markdown_node","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node","title":"<code>trestle.core.markdown.docs_markdown_node</code>","text":"<p>A docs markdown node.</p>"},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode","title":"<code>DocsMarkdownNode</code>","text":"<p>               Bases: <code>BaseMarkdownNode</code></p> <p>Markdown will be read to the tree.</p> Source code in <code>trestle/core/markdown/docs_markdown_node.py</code> <pre><code>class DocsMarkdownNode(BaseMarkdownNode):\n    \"\"\"Markdown will be read to the tree.\"\"\"\n\n    def __init__(self, key: str, content: DocsSectionContent, starting_line: int):\n        \"\"\"Initialize markdown node.\"\"\"\n        super(DocsMarkdownNode, self).__init__(key, content, starting_line)\n        self.content: DocsSectionContent = content\n\n    @classmethod\n    def build_tree_from_markdown(cls, lines: List[str], governed_header: Optional[str] = None):\n        \"\"\"Construct a tree out of the given markdown.\"\"\"\n        ob = cls.__new__(cls)\n        start_level = ob._get_max_header_lvl(lines)\n        ob, _ = ob._build_tree(lines, 'root', 0, start_level, governed_header)\n        return ob\n\n    def _build_tree(\n        self,\n        lines: List[str],\n        root_key: str,\n        starting_line: int,\n        level: int,\n        governed_header: Optional[str] = None\n    ) -&gt; Tuple[DocsMarkdownNode, int]:\n        \"\"\"\n        Build a tree from the markdown recursively.\n\n        The tree is contructed with valid headers as node's keys\n        and node's content contains everything that is under that header.\n        The subsections are placed into node's children with the same structure.\n\n        A header is valid iff the line starts with # and it is not:\n          1. Inside of the html blocks\n          2. Inside single lined in the &lt;&gt; tags\n          3. Inside the html comment\n          4. Inside any table, code block or blockquotes\n        \"\"\"\n        content = DocsSectionContent()\n        node_children = []\n        i = starting_line\n\n        while True:\n            if i &gt;= len(lines):\n                break\n            line = lines[i].strip(' ')\n            header_lvl = self._get_header_level_if_valid(line)\n\n            if header_lvl is not None:\n                if header_lvl &gt;= level + 1:\n                    # build subtree\n                    subtree, i = self._build_tree(lines, line, i + 1, level + 1, governed_header)\n                    node_children.append(subtree)\n                    content.union(subtree)\n                else:\n                    break  # level of the header is above or equal to the current level, subtree is over\n            elif self._does_start_with(line, md_const.CODEBLOCK_DEF):\n                code_lines, i = self._read_code_lines(lines, line, i + 1)\n                content.code_lines.extend(code_lines)\n            elif self._does_start_with(line, md_const.HTML_COMMENT_START):\n                html_lines, i = self._read_html_block(lines, line, i + 1, md_const.HTML_COMMENT_END_REGEX)\n                content.html_lines.extend(html_lines)\n            elif self._does_contain(line, md_const.HTML_TAG_REGEX_START):\n                html_lines, i = self._read_html_block(lines, line, i + 1, md_const.HTML_TAG_REGEX_END)\n                content.html_lines.extend(html_lines)\n            elif self._does_start_with(line, md_const.TABLE_SYMBOL):\n                table_block, i = self._read_table_block(lines, line, i + 1)\n                content.tables.extend(table_block)\n            elif self._does_start_with(line, md_const.BLOCKQUOTE_CHAR):\n                content.blockquotes.append(line)\n                i += 1\n            elif governed_header is not None and self._does_contain(\n                    root_key, fr'^[#]+ {governed_header}$') and self._does_contain(line, md_const.GOVERNED_DOC_REGEX):\n                regexp = re.compile(md_const.GOVERNED_DOC_REGEX)\n                match = regexp.search(line)\n                header = match.group(0).strip('*').strip(':')\n                content.governed_document.append(header)\n                i += 1\n            else:\n                content.text.append(line)\n                i += 1\n\n        first_line_to_grab = starting_line - 1 if starting_line else 0\n        content.raw_text = '\\n'.join(lines[first_line_to_grab:i])\n        md_node = DocsMarkdownNode(key=root_key, content=content, starting_line=first_line_to_grab)\n        md_node.subnodes = node_children\n        return md_node, i\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.content","title":"<code>content: DocsSectionContent = content</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.__init__","title":"<code>__init__(key, content, starting_line)</code>","text":"<p>Initialize markdown node.</p> Source code in <code>trestle/core/markdown/docs_markdown_node.py</code> <pre><code>def __init__(self, key: str, content: DocsSectionContent, starting_line: int):\n    \"\"\"Initialize markdown node.\"\"\"\n    super(DocsMarkdownNode, self).__init__(key, content, starting_line)\n    self.content: DocsSectionContent = content\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsMarkdownNode.build_tree_from_markdown","title":"<code>build_tree_from_markdown(lines, governed_header=None)</code>  <code>classmethod</code>","text":"<p>Construct a tree out of the given markdown.</p> Source code in <code>trestle/core/markdown/docs_markdown_node.py</code> <pre><code>@classmethod\ndef build_tree_from_markdown(cls, lines: List[str], governed_header: Optional[str] = None):\n    \"\"\"Construct a tree out of the given markdown.\"\"\"\n    ob = cls.__new__(cls)\n    start_level = ob._get_max_header_lvl(lines)\n    ob, _ = ob._build_tree(lines, 'root', 0, start_level, governed_header)\n    return ob\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent","title":"<code>DocsSectionContent</code>","text":"<p>               Bases: <code>BaseSectionContent</code></p> <p>A content of the node.</p> Source code in <code>trestle/core/markdown/docs_markdown_node.py</code> <pre><code>class DocsSectionContent(BaseSectionContent):\n    \"\"\"A content of the node.\"\"\"\n\n    def __init__(self):\n        \"\"\"Initialize section content.\"\"\"\n        super(DocsSectionContent, self).__init__()\n        self.tables = []\n        self.text = []\n        self.code_lines = []\n        self.html_lines = []\n        self.blockquotes = []\n        self.governed_document = []\n\n    def union(self, node: DocsMarkdownNode) -&gt; None:\n        \"\"\"Unites contents together.\"\"\"\n        super().union(node)\n        self.code_lines.extend(node.content.code_lines)\n        self.html_lines.extend(node.content.html_lines)\n        self.tables.extend(node.content.tables)\n        self.blockquotes.extend(node.content.blockquotes)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent.blockquotes","title":"<code>blockquotes = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent.code_lines","title":"<code>code_lines = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent.governed_document","title":"<code>governed_document = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent.html_lines","title":"<code>html_lines = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent.tables","title":"<code>tables = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent.text","title":"<code>text = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent.__init__","title":"<code>__init__()</code>","text":"<p>Initialize section content.</p> Source code in <code>trestle/core/markdown/docs_markdown_node.py</code> <pre><code>def __init__(self):\n    \"\"\"Initialize section content.\"\"\"\n    super(DocsSectionContent, self).__init__()\n    self.tables = []\n    self.text = []\n    self.code_lines = []\n    self.html_lines = []\n    self.blockquotes = []\n    self.governed_document = []\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/docs_markdown_node/#trestle.core.markdown.docs_markdown_node.DocsSectionContent.union","title":"<code>union(node)</code>","text":"<p>Unites contents together.</p> Source code in <code>trestle/core/markdown/docs_markdown_node.py</code> <pre><code>def union(self, node: DocsMarkdownNode) -&gt; None:\n    \"\"\"Unites contents together.\"\"\"\n    super().union(node)\n    self.code_lines.extend(node.content.code_lines)\n    self.html_lines.extend(node.content.html_lines)\n    self.tables.extend(node.content.tables)\n    self.blockquotes.extend(node.content.blockquotes)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_api/","title":"trestle.core.markdown.markdown_api","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api","title":"<code>trestle.core.markdown.markdown_api</code>","text":"<p>A markdown API.</p>"},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.MarkdownAPI","title":"<code>MarkdownAPI</code>","text":"<p>A common API that wraps around the existing markdown functionality.</p> Source code in <code>trestle/core/markdown/markdown_api.py</code> <pre><code>class MarkdownAPI:\n    \"\"\"A common API that wraps around the existing markdown functionality.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize markdown API.\"\"\"\n        self.processor = MarkdownProcessor()\n        self.validator = None\n\n    def load_validator_with_template(\n        self,\n        md_template_path: pathlib.Path,\n        validate_yaml_header: bool,\n        validate_md_body: bool,\n        governed_section: Optional[str] = None,\n        validate_template: bool = False\n    ) -&gt; None:\n        \"\"\"Load and initialize markdown validator.\"\"\"\n        try:\n            self.processor.governed_header = governed_section\n            if validate_template:\n                template_header, template_tree = self.processor.process_markdown(md_template_path, validate_yaml_header,\n                                                                                 validate_md_body or governed_section is\n                                                                                 not None)\n            else:\n                template_header, template_tree = self.processor.process_markdown(md_template_path)\n\n            if not template_header and validate_yaml_header:\n                raise TrestleError(f'Expected yaml header for markdown template where none exists {md_template_path}')\n\n            self.validator = MarkdownValidator(\n                md_template_path,\n                template_header,\n                template_tree,\n                validate_yaml_header,\n                validate_md_body,\n                governed_section\n            )\n        except TrestleError as e:\n            raise TrestleError(f'Error while loading markdown template {md_template_path}: {e}.')\n\n    def validate_instance(self, md_instance_path: pathlib.Path) -&gt; bool:\n        \"\"\"Validate a given markdown instance against a template.\"\"\"\n        if self.validator is None:\n            raise TrestleError('Markdown validator is not initialized, load template first.')\n        instance_header, instance_tree = self.processor.process_markdown(md_instance_path)\n        return self.validator.is_valid_against_template(md_instance_path, instance_header, instance_tree)\n\n    def write_markdown_with_header(self, path: pathlib.Path, header: Dict[str, str], md_body: str) -&gt; None:\n        \"\"\"Write markdown with the YAML header.\"\"\"\n        try:\n            # use encoding to handle character sets as well as possible\n            with open(path, 'w', encoding=const.FILE_ENCODING, errors='replace') as md_file:\n                md_file.write('---\\n')\n                yaml.safe_dump(header, md_file, sort_keys=False)\n                md_file.write('---\\n\\n')\n                md_file.write(md_body)\n        except IOError as e:\n            raise TrestleError(f'Error while writing markdown file: {e}')\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.MarkdownAPI-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.MarkdownAPI.processor","title":"<code>processor = MarkdownProcessor()</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.MarkdownAPI.validator","title":"<code>validator = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.MarkdownAPI-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.MarkdownAPI.__init__","title":"<code>__init__()</code>","text":"<p>Initialize markdown API.</p> Source code in <code>trestle/core/markdown/markdown_api.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize markdown API.\"\"\"\n    self.processor = MarkdownProcessor()\n    self.validator = None\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.MarkdownAPI.load_validator_with_template","title":"<code>load_validator_with_template(md_template_path, validate_yaml_header, validate_md_body, governed_section=None, validate_template=False)</code>","text":"<p>Load and initialize markdown validator.</p> Source code in <code>trestle/core/markdown/markdown_api.py</code> <pre><code>def load_validator_with_template(\n    self,\n    md_template_path: pathlib.Path,\n    validate_yaml_header: bool,\n    validate_md_body: bool,\n    governed_section: Optional[str] = None,\n    validate_template: bool = False\n) -&gt; None:\n    \"\"\"Load and initialize markdown validator.\"\"\"\n    try:\n        self.processor.governed_header = governed_section\n        if validate_template:\n            template_header, template_tree = self.processor.process_markdown(md_template_path, validate_yaml_header,\n                                                                             validate_md_body or governed_section is\n                                                                             not None)\n        else:\n            template_header, template_tree = self.processor.process_markdown(md_template_path)\n\n        if not template_header and validate_yaml_header:\n            raise TrestleError(f'Expected yaml header for markdown template where none exists {md_template_path}')\n\n        self.validator = MarkdownValidator(\n            md_template_path,\n            template_header,\n            template_tree,\n            validate_yaml_header,\n            validate_md_body,\n            governed_section\n        )\n    except TrestleError as e:\n        raise TrestleError(f'Error while loading markdown template {md_template_path}: {e}.')\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.MarkdownAPI.validate_instance","title":"<code>validate_instance(md_instance_path)</code>","text":"<p>Validate a given markdown instance against a template.</p> Source code in <code>trestle/core/markdown/markdown_api.py</code> <pre><code>def validate_instance(self, md_instance_path: pathlib.Path) -&gt; bool:\n    \"\"\"Validate a given markdown instance against a template.\"\"\"\n    if self.validator is None:\n        raise TrestleError('Markdown validator is not initialized, load template first.')\n    instance_header, instance_tree = self.processor.process_markdown(md_instance_path)\n    return self.validator.is_valid_against_template(md_instance_path, instance_header, instance_tree)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_api/#trestle.core.markdown.markdown_api.MarkdownAPI.write_markdown_with_header","title":"<code>write_markdown_with_header(path, header, md_body)</code>","text":"<p>Write markdown with the YAML header.</p> Source code in <code>trestle/core/markdown/markdown_api.py</code> <pre><code>def write_markdown_with_header(self, path: pathlib.Path, header: Dict[str, str], md_body: str) -&gt; None:\n    \"\"\"Write markdown with the YAML header.\"\"\"\n    try:\n        # use encoding to handle character sets as well as possible\n        with open(path, 'w', encoding=const.FILE_ENCODING, errors='replace') as md_file:\n            md_file.write('---\\n')\n            yaml.safe_dump(header, md_file, sort_keys=False)\n            md_file.write('---\\n\\n')\n            md_file.write(md_body)\n    except IOError as e:\n        raise TrestleError(f'Error while writing markdown file: {e}')\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_const/","title":"trestle.core.markdown.markdown_const","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const","title":"<code>trestle.core.markdown.markdown_const</code>","text":"<p>Markdown specific constants.</p>"},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.BLOCKQUOTE_CHAR","title":"<code>BLOCKQUOTE_CHAR = '&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.CODEBLOCK_DEF","title":"<code>CODEBLOCK_DEF = '```'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.GOVERNED_DOC_REGEX","title":"<code>GOVERNED_DOC_REGEX = '.*:'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.HEADER_REGEX","title":"<code>HEADER_REGEX = '^[#]+'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.HTML_COMMENT_END_REGEX","title":"<code>HTML_COMMENT_END_REGEX = '.*--&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.HTML_COMMENT_START","title":"<code>HTML_COMMENT_START = '&lt;!--'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.HTML_TAG_REGEX_END","title":"<code>HTML_TAG_REGEX_END = '&lt;\\\\/.*&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.HTML_TAG_REGEX_START","title":"<code>HTML_TAG_REGEX_START = '^[ \\\\t]*&lt;.*&gt;'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.INLINE_CODE_CHAR","title":"<code>INLINE_CODE_CHAR = '^`'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.JINJA_DATESTAMP_FORMAT","title":"<code>JINJA_DATESTAMP_FORMAT = '%Y-%m-%d'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.LIST_CHAR","title":"<code>LIST_CHAR = '-'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.SUBSTITUTION_REGEX","title":"<code>SUBSTITUTION_REGEX = '{(.*?)}'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.TABLE_REGEX","title":"<code>TABLE_REGEX = '|'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_const/#trestle.core.markdown.markdown_const.TABLE_SYMBOL","title":"<code>TABLE_SYMBOL = '|'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_processor/","title":"trestle.core.markdown.markdown_processor","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor","title":"<code>trestle.core.markdown.markdown_processor</code>","text":"<p>A markdown processor.</p>"},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor","title":"<code>MarkdownProcessor</code>","text":"<p>A markdown processor.</p> Source code in <code>trestle/core/markdown/markdown_processor.py</code> <pre><code>class MarkdownProcessor:\n    \"\"\"A markdown processor.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize markdown processor.\"\"\"\n        self.governed_header = None\n\n    def render_gfm_to_html(self, markdown_text: str) -&gt; str:\n        \"\"\"Render given Github Flavored Markdown to HTML.\"\"\"\n        try:\n            html = cmarkgfm.github_flavored_markdown_to_html(markdown_text)\n            return html\n        except ValueError as e:\n            raise TrestleError(f'Not a valid Github Flavored markdown: {e}.')\n\n    def process_markdown(self,\n                         md_path: pathlib.Path,\n                         read_header: bool = True,\n                         read_body: bool = True) -&gt; Tuple[Dict, DocsMarkdownNode]:\n        \"\"\"Parse the markdown and builds the tree to operate over it.\"\"\"\n        header, markdown_wo_header = self.read_markdown_wo_processing(md_path, read_header, read_body)\n\n        _ = self.render_gfm_to_html(markdown_wo_header)\n\n        lines = markdown_wo_header.split('\\n')\n        tree = DocsMarkdownNode.build_tree_from_markdown(lines, self.governed_header)\n        return header, tree\n\n    def process_control_markdown(\n        self,\n        md_path: pathlib.Path,\n        cli_section_dict: Dict[str, str] = None,\n        part_label_to_id_map: Dict[str, str] = None\n    ) -&gt; Tuple[Dict, ControlMarkdownNode]:\n        \"\"\"Parse control markdown and build tree with identified OSCAL components.\"\"\"\n        try:\n            header, markdown_wo_header = self.read_markdown_wo_processing(md_path, read_header=True, read_body=True)\n\n            section_to_part_name_map = {}\n            if cli_section_dict is not None:\n                # Read x-trestle-sections to the dictionary and merge it with CLI provided dictionary\n                yaml_header_sections_dict = header.get(const.SECTIONS_TAG, {})\n                merged_dict = merge_dicts(yaml_header_sections_dict, cli_section_dict)\n                section_to_part_name_map = {v: k for k, v in merged_dict.items()}\n            _ = self.render_gfm_to_html(markdown_wo_header)\n\n            lines = markdown_wo_header.split('\\n')\n            tree_context.reset()\n            tree_context.section_to_part_name_map = section_to_part_name_map\n            tree_context.part_label_to_id_map = part_label_to_id_map\n            tree = ControlMarkdownNode.build_tree_from_markdown(lines)\n            tree_context.reset()\n            return header, tree\n        except TrestleError as e:\n            logger.error(f'Error while reading control markdown: {md_path}: {e}')\n            raise e\n\n    def read_markdown_wo_processing(self,\n                                    md_path: pathlib.Path,\n                                    read_header: bool = True,\n                                    read_body: bool = True) -&gt; Tuple[Dict, str]:\n        \"\"\"Read markdown header to dictionary and body to string.\"\"\"\n        try:\n            contents = frontmatter.loads(md_path.open('r', encoding=const.FILE_ENCODING).read())\n            header = {}\n            markdown_wo_header = ''\n            if read_header:\n                header = contents.metadata\n            if read_body:\n                markdown_wo_header = contents.content\n\n            return header, markdown_wo_header\n        except UnicodeDecodeError as e:\n            logger.debug(traceback.format_exc())\n            raise TrestleError(f'Markdown cannot be decoded into {const.FILE_ENCODING}, error: {e}')\n        except ScannerError as e:\n            logger.debug(traceback.format_exc())\n            raise TrestleError(f'Header is not in a valid YAML format: {e}')\n        except FileNotFoundError as e:\n            logger.debug(traceback.format_exc())\n            raise TrestleError(f'Markdown with path {md_path}, not found: {e}')\n\n    def fetch_value_from_header(self, md_path: pathlib.Path, key: str) -&gt; Optional[str]:\n        \"\"\"Fetch value for the given key from the markdown header if exists.\"\"\"\n        header, _ = self.read_markdown_wo_processing(md_path)\n        value = None\n\n        if key in header.keys():\n            value = header[key]\n\n        return value\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor.governed_header","title":"<code>governed_header = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor.__init__","title":"<code>__init__()</code>","text":"<p>Initialize markdown processor.</p> Source code in <code>trestle/core/markdown/markdown_processor.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize markdown processor.\"\"\"\n    self.governed_header = None\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor.fetch_value_from_header","title":"<code>fetch_value_from_header(md_path, key)</code>","text":"<p>Fetch value for the given key from the markdown header if exists.</p> Source code in <code>trestle/core/markdown/markdown_processor.py</code> <pre><code>def fetch_value_from_header(self, md_path: pathlib.Path, key: str) -&gt; Optional[str]:\n    \"\"\"Fetch value for the given key from the markdown header if exists.\"\"\"\n    header, _ = self.read_markdown_wo_processing(md_path)\n    value = None\n\n    if key in header.keys():\n        value = header[key]\n\n    return value\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor.process_control_markdown","title":"<code>process_control_markdown(md_path, cli_section_dict=None, part_label_to_id_map=None)</code>","text":"<p>Parse control markdown and build tree with identified OSCAL components.</p> Source code in <code>trestle/core/markdown/markdown_processor.py</code> <pre><code>def process_control_markdown(\n    self,\n    md_path: pathlib.Path,\n    cli_section_dict: Dict[str, str] = None,\n    part_label_to_id_map: Dict[str, str] = None\n) -&gt; Tuple[Dict, ControlMarkdownNode]:\n    \"\"\"Parse control markdown and build tree with identified OSCAL components.\"\"\"\n    try:\n        header, markdown_wo_header = self.read_markdown_wo_processing(md_path, read_header=True, read_body=True)\n\n        section_to_part_name_map = {}\n        if cli_section_dict is not None:\n            # Read x-trestle-sections to the dictionary and merge it with CLI provided dictionary\n            yaml_header_sections_dict = header.get(const.SECTIONS_TAG, {})\n            merged_dict = merge_dicts(yaml_header_sections_dict, cli_section_dict)\n            section_to_part_name_map = {v: k for k, v in merged_dict.items()}\n        _ = self.render_gfm_to_html(markdown_wo_header)\n\n        lines = markdown_wo_header.split('\\n')\n        tree_context.reset()\n        tree_context.section_to_part_name_map = section_to_part_name_map\n        tree_context.part_label_to_id_map = part_label_to_id_map\n        tree = ControlMarkdownNode.build_tree_from_markdown(lines)\n        tree_context.reset()\n        return header, tree\n    except TrestleError as e:\n        logger.error(f'Error while reading control markdown: {md_path}: {e}')\n        raise e\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor.process_markdown","title":"<code>process_markdown(md_path, read_header=True, read_body=True)</code>","text":"<p>Parse the markdown and builds the tree to operate over it.</p> Source code in <code>trestle/core/markdown/markdown_processor.py</code> <pre><code>def process_markdown(self,\n                     md_path: pathlib.Path,\n                     read_header: bool = True,\n                     read_body: bool = True) -&gt; Tuple[Dict, DocsMarkdownNode]:\n    \"\"\"Parse the markdown and builds the tree to operate over it.\"\"\"\n    header, markdown_wo_header = self.read_markdown_wo_processing(md_path, read_header, read_body)\n\n    _ = self.render_gfm_to_html(markdown_wo_header)\n\n    lines = markdown_wo_header.split('\\n')\n    tree = DocsMarkdownNode.build_tree_from_markdown(lines, self.governed_header)\n    return header, tree\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor.read_markdown_wo_processing","title":"<code>read_markdown_wo_processing(md_path, read_header=True, read_body=True)</code>","text":"<p>Read markdown header to dictionary and body to string.</p> Source code in <code>trestle/core/markdown/markdown_processor.py</code> <pre><code>def read_markdown_wo_processing(self,\n                                md_path: pathlib.Path,\n                                read_header: bool = True,\n                                read_body: bool = True) -&gt; Tuple[Dict, str]:\n    \"\"\"Read markdown header to dictionary and body to string.\"\"\"\n    try:\n        contents = frontmatter.loads(md_path.open('r', encoding=const.FILE_ENCODING).read())\n        header = {}\n        markdown_wo_header = ''\n        if read_header:\n            header = contents.metadata\n        if read_body:\n            markdown_wo_header = contents.content\n\n        return header, markdown_wo_header\n    except UnicodeDecodeError as e:\n        logger.debug(traceback.format_exc())\n        raise TrestleError(f'Markdown cannot be decoded into {const.FILE_ENCODING}, error: {e}')\n    except ScannerError as e:\n        logger.debug(traceback.format_exc())\n        raise TrestleError(f'Header is not in a valid YAML format: {e}')\n    except FileNotFoundError as e:\n        logger.debug(traceback.format_exc())\n        raise TrestleError(f'Markdown with path {md_path}, not found: {e}')\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor.MarkdownProcessor.render_gfm_to_html","title":"<code>render_gfm_to_html(markdown_text)</code>","text":"<p>Render given Github Flavored Markdown to HTML.</p> Source code in <code>trestle/core/markdown/markdown_processor.py</code> <pre><code>def render_gfm_to_html(self, markdown_text: str) -&gt; str:\n    \"\"\"Render given Github Flavored Markdown to HTML.\"\"\"\n    try:\n        html = cmarkgfm.github_flavored_markdown_to_html(markdown_text)\n        return html\n    except ValueError as e:\n        raise TrestleError(f'Not a valid Github Flavored markdown: {e}.')\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_processor/#trestle.core.markdown.markdown_processor-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/","title":"trestle.core.markdown.markdown_validator","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator","title":"<code>trestle.core.markdown.markdown_validator</code>","text":"<p>Markdown Validator.</p>"},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator","title":"<code>MarkdownValidator</code>","text":"<p>A markdown validator. Validates markdown instance against given template.</p> Source code in <code>trestle/core/markdown/markdown_validator.py</code> <pre><code>class MarkdownValidator:\n    \"\"\"A markdown validator. Validates markdown instance against given template.\"\"\"\n\n    def __init__(\n        self,\n        tmp_path: pathlib.Path,\n        template_header: Dict,\n        template_tree: DocsMarkdownNode,\n        validate_yaml_header: bool,\n        validate_md_body: bool,\n        governed_section: Optional[str] = None\n    ):\n        \"\"\"Initialize markdown validator.\"\"\"\n        self._validate_yaml_header = validate_yaml_header\n        self._validate_md_body = validate_md_body\n        self.governed_section = governed_section.strip(' ') if governed_section is not None else None\n        self.template_header = template_header\n        self.template_tree = template_tree\n        self.template_path = tmp_path\n        self.template_version = self.extract_template_version(self.template_header)\n\n        if self.template_version not in str(self.template_path):\n            raise TrestleError(\n                f'Version of the template {self.template_version} does not match the path {self.template_path}.'\n                + f'Move the template to the folder {self.template_version}'\n            )\n        if 'Version' in self.template_header.keys() and self.template_header['Version'] != self.template_version:\n            raise TrestleError(f'Version does not match template-version in template: {self.template_path}.')\n        self._ignore_headers = []\n        for key in self.template_header.keys():\n            if key.lower().startswith('x-trestle-'):\n                self._ignore_headers.append(key.lower())\n                if key.lower() == 'x-trestle-ignore':\n                    for key2 in template_header['x-trestle-ignore']:\n                        self._ignore_headers.append(key2.lower())\n\n    def is_valid_against_template(\n        self, instance: pathlib.Path, instance_header: Dict, instance_tree: DocsMarkdownNode\n    ) -&gt; bool:\n        \"\"\"\n        Validate instance markdown against template.\n\n        Instance is correct against a template iff:\n            1. For YAML header keys:\n                a. All keys from the template are present and not modified\n                b. Template version in the template and instance match\n            2. On the Markdown w/o YAML header:\n                a. No additional headers of the level 1 were added\n                b. Headers were not reordered\n                c. Headers in the instance should be a superset of the template headers\n                d. Headers must be in heirarchical order (i.e. # then ### then ## is not allowed)\n            3. If Governed Header is given then:\n                a. Governed Header is not modified\n                b. All keys (i.e. key: something) inside the section are present\n\n        Args:\n            instance: a path to the markdown instance that should be validated\n            instance_header: a YAML header extracted from the markdown\n            instance_tree: a tree structure representing markdown contents\n        Returns:\n            Whether or not the the candidate is valid against the template.\n        \"\"\"\n        if self._validate_yaml_header:\n            headers_match = self.compare_keys(self.template_header, instance_header, self._ignore_headers)\n\n            if not headers_match:\n                logger.info(f'YAML header mismatch between template {self.template_path} and instance {instance}')\n                return False\n            elif headers_match and not self._validate_md_body:\n                return True\n\n        if self.governed_section is not None:\n            instance_gov_nodes = instance_tree.get_all_nodes_for_keys([self.governed_section], False)\n            template_gov_nodes = self.template_tree.get_all_nodes_for_keys([self.governed_section], False)\n\n            if not instance_gov_nodes:\n                logger.info(f'Governed section {self.governed_section} not found in instance: {instance}')\n                return False\n\n            if not template_gov_nodes:\n                logger.info(f'Governed section {self.governed_section} not found in template: {self.template_path}')\n                return False\n\n            if [node.key for node in instance_gov_nodes] != [node.key for node in template_gov_nodes]:\n                logger.info(\n                    f'Governed sections were changed, '\n                    f'template expects: {[node.key for node in template_gov_nodes]},'\n                    f'but found {[node.key for node in instance_gov_nodes]}.'\n                )\n                return False\n\n            for instance_gov_node, template_gov_node in zip(instance_gov_nodes, template_gov_nodes):\n                instance_keys = instance_gov_node.content.governed_document\n                template_keys = template_gov_node.content.governed_document\n\n                is_valid = self._validate_headings(instance, template_keys, instance_keys)\n                if not is_valid:\n                    return False\n\n        if self._validate_md_body:\n            instance_keys = instance_tree.content.subnodes_keys\n            template_keys = self.template_tree.content.subnodes_keys\n            if len(template_keys) &gt; len(instance_keys):\n                logger.info(f'Headings in the instance: {instance} were removed.')\n                return False\n\n            instance_lvl1_keys = list(instance_tree.get_all_headers_for_level(1))\n            template_lvl1_keys = list(self.template_tree.get_all_headers_for_level(1))\n            if len(template_lvl1_keys) &lt; len(instance_lvl1_keys):\n                logger.info(f'New headers of level 1 were added to the markdown instance: {instance}. ')\n                return False\n\n            is_valid = self._validate_headings(instance, template_keys, instance_keys)\n            if not is_valid:\n                return False\n\n        return True\n\n    @classmethod\n    def compare_keys(\n        cls,\n        template: Dict[str, Any],\n        candidate: Dict[str, Any],\n        ignore_fields: Optional[Dict[str, Any]] = None\n    ) -&gt; bool:\n        \"\"\"\n        Compare a template dictionary against a candidate as to whether key structure is maintained.\n\n        Args:\n            template: Template dict which is used as a model of key-value pairs\n            candidate: Candidate dictionary to be measured\n        Returns:\n            Whether or not the the candidate matches the template keys.\n        \"\"\"\n        if ignore_fields is None:\n            ignore_fields = []\n        for key in list(candidate.keys()):\n            if key.lower() in ignore_fields:\n                candidate.pop(key)\n        for key in list(template.keys()):\n            if key.lower() in ignore_fields:\n                template.pop(key)\n        template_version = cls.extract_template_version(template)\n        candidate_version = cls.extract_template_version(candidate)\n        if template_version != candidate_version:\n            logger.info(f'Versions of the template {template_version} and instance {candidate_version} are different')\n            return False\n\n        if len(template.keys()) != len(candidate.keys()):\n            logger.info(f'Number of keys does not match in template {template} and instance {candidate}')\n            return False\n        for key in template.keys():\n            if key in candidate.keys():\n                if isinstance(template[key], dict):\n                    if isinstance(candidate[key], dict):\n                        status = cls.compare_keys(template[key], candidate[key], ignore_fields)\n                        if not status:\n                            return status\n                    else:\n                        logger.info(f'Value under {key} must be dictionary in candidate {candidate}')\n                        return False\n            else:\n                logger.info(f'Key {key} is not in candidate {candidate}')\n                return False\n        return True\n\n    def _validate_headings(self, instance: pathlib.Path, template_keys: List[str], instance_keys: List[str]) -&gt; bool:\n        \"\"\"Validate instance headings against template.\"\"\"\n        if len(template_keys) &gt; len(instance_keys):\n            logger.info(\n                f'Headings in the instance: {instance} were removed.'\n                f'Expected {len(template_keys)} headings, but found only {len(instance_keys)}.'\n            )\n            return False\n        template_header_pointer = 0\n        present_keys = []\n        for key in instance_keys:\n            if template_header_pointer &gt;= len(template_keys):\n                break\n            if key in template_keys and key not in present_keys:\n                present_keys.append(template_keys[template_keys.index(key)])\n                template_header_pointer += 1\n            elif re.search(md_const.SUBSTITUTION_REGEX, template_keys[template_header_pointer]) is not None:\n                present_keys.append(template_keys[template_header_pointer])\n                template_header_pointer += 1  # skip headers with substitutions\n        diff_keys = set(template_keys) - set(present_keys)\n        if template_header_pointer != len(template_keys) and len(diff_keys) &gt; 0:\n            logger.info(\n                f'Headings in the instance: {instance} were removed. '\n                f'Expected {len(template_keys)} headings, but found only {template_header_pointer}.'\n            )\n            for result in as_list(diff_keys):\n                logger.info(f'Heading {result} in the instance: {instance} was removed or not present ')\n            return False\n        return True\n\n    @classmethod\n    def extract_template_version(cls, header: Dict[str, Any]) -&gt; Optional[str]:\n        \"\"\"\n        Extract the template version from the header.\n\n        If no header is found then starting version(0.0.1) will be used by default\n        \"\"\"\n        if TEMPLATE_VERSION_HEADER not in header.keys():\n            return START_TEMPLATE_VERSION\n\n        return header[TEMPLATE_VERSION_HEADER]\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator.governed_section","title":"<code>governed_section = governed_section.strip(' ') if governed_section is not None else None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator.template_header","title":"<code>template_header = template_header</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator.template_path","title":"<code>template_path = tmp_path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator.template_tree","title":"<code>template_tree = template_tree</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator.template_version","title":"<code>template_version = self.extract_template_version(self.template_header)</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator.__init__","title":"<code>__init__(tmp_path, template_header, template_tree, validate_yaml_header, validate_md_body, governed_section=None)</code>","text":"<p>Initialize markdown validator.</p> Source code in <code>trestle/core/markdown/markdown_validator.py</code> <pre><code>def __init__(\n    self,\n    tmp_path: pathlib.Path,\n    template_header: Dict,\n    template_tree: DocsMarkdownNode,\n    validate_yaml_header: bool,\n    validate_md_body: bool,\n    governed_section: Optional[str] = None\n):\n    \"\"\"Initialize markdown validator.\"\"\"\n    self._validate_yaml_header = validate_yaml_header\n    self._validate_md_body = validate_md_body\n    self.governed_section = governed_section.strip(' ') if governed_section is not None else None\n    self.template_header = template_header\n    self.template_tree = template_tree\n    self.template_path = tmp_path\n    self.template_version = self.extract_template_version(self.template_header)\n\n    if self.template_version not in str(self.template_path):\n        raise TrestleError(\n            f'Version of the template {self.template_version} does not match the path {self.template_path}.'\n            + f'Move the template to the folder {self.template_version}'\n        )\n    if 'Version' in self.template_header.keys() and self.template_header['Version'] != self.template_version:\n        raise TrestleError(f'Version does not match template-version in template: {self.template_path}.')\n    self._ignore_headers = []\n    for key in self.template_header.keys():\n        if key.lower().startswith('x-trestle-'):\n            self._ignore_headers.append(key.lower())\n            if key.lower() == 'x-trestle-ignore':\n                for key2 in template_header['x-trestle-ignore']:\n                    self._ignore_headers.append(key2.lower())\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator.compare_keys","title":"<code>compare_keys(template, candidate, ignore_fields=None)</code>  <code>classmethod</code>","text":"<p>Compare a template dictionary against a candidate as to whether key structure is maintained.</p> <p>Parameters:</p> Name Type Description Default <code>template</code> <code>Dict[str, Any]</code> <p>Template dict which is used as a model of key-value pairs</p> required <code>candidate</code> <code>Dict[str, Any]</code> <p>Candidate dictionary to be measured</p> required <p>Returns:     Whether or not the the candidate matches the template keys.</p> Source code in <code>trestle/core/markdown/markdown_validator.py</code> <pre><code>@classmethod\ndef compare_keys(\n    cls,\n    template: Dict[str, Any],\n    candidate: Dict[str, Any],\n    ignore_fields: Optional[Dict[str, Any]] = None\n) -&gt; bool:\n    \"\"\"\n    Compare a template dictionary against a candidate as to whether key structure is maintained.\n\n    Args:\n        template: Template dict which is used as a model of key-value pairs\n        candidate: Candidate dictionary to be measured\n    Returns:\n        Whether or not the the candidate matches the template keys.\n    \"\"\"\n    if ignore_fields is None:\n        ignore_fields = []\n    for key in list(candidate.keys()):\n        if key.lower() in ignore_fields:\n            candidate.pop(key)\n    for key in list(template.keys()):\n        if key.lower() in ignore_fields:\n            template.pop(key)\n    template_version = cls.extract_template_version(template)\n    candidate_version = cls.extract_template_version(candidate)\n    if template_version != candidate_version:\n        logger.info(f'Versions of the template {template_version} and instance {candidate_version} are different')\n        return False\n\n    if len(template.keys()) != len(candidate.keys()):\n        logger.info(f'Number of keys does not match in template {template} and instance {candidate}')\n        return False\n    for key in template.keys():\n        if key in candidate.keys():\n            if isinstance(template[key], dict):\n                if isinstance(candidate[key], dict):\n                    status = cls.compare_keys(template[key], candidate[key], ignore_fields)\n                    if not status:\n                        return status\n                else:\n                    logger.info(f'Value under {key} must be dictionary in candidate {candidate}')\n                    return False\n        else:\n            logger.info(f'Key {key} is not in candidate {candidate}')\n            return False\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator.extract_template_version","title":"<code>extract_template_version(header)</code>  <code>classmethod</code>","text":"<p>Extract the template version from the header.</p> <p>If no header is found then starting version(0.0.1) will be used by default</p> Source code in <code>trestle/core/markdown/markdown_validator.py</code> <pre><code>@classmethod\ndef extract_template_version(cls, header: Dict[str, Any]) -&gt; Optional[str]:\n    \"\"\"\n    Extract the template version from the header.\n\n    If no header is found then starting version(0.0.1) will be used by default\n    \"\"\"\n    if TEMPLATE_VERSION_HEADER not in header.keys():\n        return START_TEMPLATE_VERSION\n\n    return header[TEMPLATE_VERSION_HEADER]\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator.MarkdownValidator.is_valid_against_template","title":"<code>is_valid_against_template(instance, instance_header, instance_tree)</code>","text":"<p>Validate instance markdown against template.</p> Instance is correct against a template iff <ol> <li>For YAML header keys:     a. All keys from the template are present and not modified     b. Template version in the template and instance match</li> <li>On the Markdown w/o YAML header:     a. No additional headers of the level 1 were added     b. Headers were not reordered     c. Headers in the instance should be a superset of the template headers     d. Headers must be in heirarchical order (i.e. # then ### then ## is not allowed)</li> <li>If Governed Header is given then:     a. Governed Header is not modified     b. All keys (i.e. key: something) inside the section are present</li> </ol> <p>Parameters:</p> Name Type Description Default <code>instance</code> <code>Path</code> <p>a path to the markdown instance that should be validated</p> required <code>instance_header</code> <code>Dict</code> <p>a YAML header extracted from the markdown</p> required <code>instance_tree</code> <code>DocsMarkdownNode</code> <p>a tree structure representing markdown contents</p> required <p>Returns:     Whether or not the the candidate is valid against the template.</p> Source code in <code>trestle/core/markdown/markdown_validator.py</code> <pre><code>def is_valid_against_template(\n    self, instance: pathlib.Path, instance_header: Dict, instance_tree: DocsMarkdownNode\n) -&gt; bool:\n    \"\"\"\n    Validate instance markdown against template.\n\n    Instance is correct against a template iff:\n        1. For YAML header keys:\n            a. All keys from the template are present and not modified\n            b. Template version in the template and instance match\n        2. On the Markdown w/o YAML header:\n            a. No additional headers of the level 1 were added\n            b. Headers were not reordered\n            c. Headers in the instance should be a superset of the template headers\n            d. Headers must be in heirarchical order (i.e. # then ### then ## is not allowed)\n        3. If Governed Header is given then:\n            a. Governed Header is not modified\n            b. All keys (i.e. key: something) inside the section are present\n\n    Args:\n        instance: a path to the markdown instance that should be validated\n        instance_header: a YAML header extracted from the markdown\n        instance_tree: a tree structure representing markdown contents\n    Returns:\n        Whether or not the the candidate is valid against the template.\n    \"\"\"\n    if self._validate_yaml_header:\n        headers_match = self.compare_keys(self.template_header, instance_header, self._ignore_headers)\n\n        if not headers_match:\n            logger.info(f'YAML header mismatch between template {self.template_path} and instance {instance}')\n            return False\n        elif headers_match and not self._validate_md_body:\n            return True\n\n    if self.governed_section is not None:\n        instance_gov_nodes = instance_tree.get_all_nodes_for_keys([self.governed_section], False)\n        template_gov_nodes = self.template_tree.get_all_nodes_for_keys([self.governed_section], False)\n\n        if not instance_gov_nodes:\n            logger.info(f'Governed section {self.governed_section} not found in instance: {instance}')\n            return False\n\n        if not template_gov_nodes:\n            logger.info(f'Governed section {self.governed_section} not found in template: {self.template_path}')\n            return False\n\n        if [node.key for node in instance_gov_nodes] != [node.key for node in template_gov_nodes]:\n            logger.info(\n                f'Governed sections were changed, '\n                f'template expects: {[node.key for node in template_gov_nodes]},'\n                f'but found {[node.key for node in instance_gov_nodes]}.'\n            )\n            return False\n\n        for instance_gov_node, template_gov_node in zip(instance_gov_nodes, template_gov_nodes):\n            instance_keys = instance_gov_node.content.governed_document\n            template_keys = template_gov_node.content.governed_document\n\n            is_valid = self._validate_headings(instance, template_keys, instance_keys)\n            if not is_valid:\n                return False\n\n    if self._validate_md_body:\n        instance_keys = instance_tree.content.subnodes_keys\n        template_keys = self.template_tree.content.subnodes_keys\n        if len(template_keys) &gt; len(instance_keys):\n            logger.info(f'Headings in the instance: {instance} were removed.')\n            return False\n\n        instance_lvl1_keys = list(instance_tree.get_all_headers_for_level(1))\n        template_lvl1_keys = list(self.template_tree.get_all_headers_for_level(1))\n        if len(template_lvl1_keys) &lt; len(instance_lvl1_keys):\n            logger.info(f'New headers of level 1 were added to the markdown instance: {instance}. ')\n            return False\n\n        is_valid = self._validate_headings(instance, template_keys, instance_keys)\n        if not is_valid:\n            return False\n\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/markdown_validator/#trestle.core.markdown.markdown_validator-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/md_writer/","title":"trestle.core.markdown.md_writer","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer","title":"<code>trestle.core.markdown.md_writer</code>","text":"<p>Create formatted markdown files with optional yaml header.</p>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter","title":"<code>MDWriter</code>","text":"<p>Simple class to create markdown files.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>class MDWriter():\n    \"\"\"Simple class to create markdown files.\"\"\"\n\n    def __init__(self, file_path: pathlib.Path, header_comments_dict: Optional[Dict[str, str]] = None):\n        \"\"\"Initialize the class.\"\"\"\n        self._file_path = file_path\n        self._lines = []\n        self._indent_level = 0\n        self._indent_size = 2\n        self._yaml_header = None\n        self._header_comments_dict = header_comments_dict\n\n    def _current_indent_space(self):\n        if self._indent_level &lt;= 0:\n            return ''\n        return ' ' * (self._indent_level * self._indent_size)\n\n    def _add_line_raw(self, line: str) -&gt; None:\n        out_line = '' if self._is_blank(line) else line\n        self._lines.append(out_line)\n\n    def _add_indent_level(self, delta: int) -&gt; None:\n        self._indent_level += delta\n\n    def exists(self) -&gt; bool:\n        \"\"\"Check if the file already exists.\"\"\"\n        return self._file_path.exists()\n\n    def add_yaml_header(self, header: dict) -&gt; None:\n        \"\"\"Add the yaml header.\"\"\"\n        self._yaml_header = header\n\n    def set_indent_level(self, level: int) -&gt; None:\n        \"\"\"Set the current indent level.\"\"\"\n        self._indent_level = level\n\n    def set_indent_step_size(self, size: int) -&gt; None:\n        \"\"\"Set the indent step size in spaces.\"\"\"\n        self._indent_size = size\n\n    def _is_blank(self, line: str) -&gt; bool:\n        return line.strip() == ''\n\n    def _prev_blank_line(self) -&gt; bool:\n        return len(self._lines) &gt; 0 and self._is_blank(self._lines[-1])\n\n    def new_line(self, line: str) -&gt; None:\n        \"\"\"Add a line of text to the output.\"\"\"\n        # prevent double empty lines\n        out_line = '' if self._is_blank(line) else self._current_indent_space() + line\n        if self._prev_blank_line() and out_line == '':\n            return\n        self._add_line_raw(out_line)\n\n    def new_paraline(self, line: str) -&gt; None:\n        \"\"\"Add a paragraph and a line to output.\"\"\"\n        self.new_paragraph()\n        self.new_line(line)\n\n    def new_paragraph(self):\n        \"\"\"Start a new paragraph.\"\"\"\n        self.new_line('')\n\n    def new_header(self, level: int, title: str, add_new_line_after_header: bool = True) -&gt; None:\n        \"\"\"Add new header.\"\"\"\n        # headers might be separated by blank lines\n        self.new_paragraph()\n        self.new_line('#' * level + ' ' + title)\n        if add_new_line_after_header:\n            self.new_paragraph()\n\n    def new_hr(self) -&gt; None:\n        \"\"\"Add horizontal rule.\"\"\"\n        self.new_paragraph()\n        self.new_line(const.SSP_MD_HRULE_LINE)\n        self.new_paragraph()\n\n    def new_list(self, list_: List[Any]) -&gt; None:\n        \"\"\"Add a list to the markdown.\"\"\"\n        # in general this is a list of lists\n        # if string just write it out\n        if isinstance(list_, str):\n            if self._is_blank(list_):\n                self.new_paragraph()\n            else:\n                self.new_line('- ' + list_)\n        # else it is a sublist so indent\n        else:\n            self._add_indent_level(1)\n            self.new_paragraph()\n            for item in list_:\n                if self._indent_level &lt;= 0:\n                    self.new_paragraph()\n                self.new_list(item)\n            self._add_indent_level(-1)\n\n    def new_table(self, table_list: List[List[str]], header: List[str]):\n        \"\"\"Add table to the markdown. All rows must be of equal length.\"\"\"\n        header_str = '| ' + ' | '.join(header) + ' |'\n        sep_str = '|---' * len(header) + '|'\n        self.new_line(header_str)\n        self.new_line(sep_str)\n        for row in table_list:\n            row_str = '| ' + ' | '.join(row) + ' |'\n            self.new_line(row_str)\n\n    def _check_header(self) -&gt; None:\n        while len(self._lines) &gt; 0 and self._lines[0] == '':\n            self._lines = self._lines[1:]\n\n    def write_out(self) -&gt; None:\n        \"\"\"Write out the markdown file.\"\"\"\n        self._check_header()\n        try:\n            self._file_path.parent.mkdir(exist_ok=True, parents=True)\n            with open(self._file_path, 'w', encoding=const.FILE_ENCODING) as f:\n                # Make sure yaml header is written first\n                if self._yaml_header:\n                    f.write('---\\n')\n                    yaml = YAML()\n                    yaml.indent(mapping=2, sequence=4, offset=2)\n                    yaml.dump(self._yaml_header, f)\n                    f.write('---\\n\\n')\n\n                f.write('\\n'.join(self._lines))\n                # if last line has text it will need an extra \\n at end\n                if self._lines and self._lines[-1]:\n                    f.write('\\n')\n            # insert helpful comments into the header happens after header is written out\n            for tag, comment in as_dict(self._header_comments_dict).items():\n                if tag in as_dict(self._yaml_header):\n                    file_utils.insert_text_in_file(self._file_path, tag, comment)\n        except IOError as e:\n            logger.debug(f'md_writer error attempting to write out md file {self._file_path} {e}')\n            raise TrestleError(f'Error attempting to write out md file {self._file_path} {e}')\n\n    def get_lines(self) -&gt; List[str]:\n        \"\"\"Return the current lines in the file.\"\"\"\n        return self._lines\n\n    def get_text(self) -&gt; str:\n        \"\"\"Get the text as currently written.\"\"\"\n        return '\\n'.join(self._lines)\n\n    def cull_headings(self, md_in: pathlib.Path, cull_list: List[str], strict_match: bool = False) -&gt; None:\n        \"\"\"\n        Cull headers from the lines of input markdown file with optional strict string match.\n\n        Args:\n            md_in: the path of the markdown file being edited\n            cull_list: the list of strings in headers that are to be culled\n            strict_match: whether to require an exact string match on header key or just a substring\n\n        Returns None and creates new markdown at the path specified during MDWriter construction\n        It is allowed to overwrite the original file\n        \"\"\"\n        markdown_api = MarkdownAPI()\n        header, content = markdown_api.processor.process_markdown(md_in)\n        self._yaml_header = header\n        self._lines = content.delete_nodes_text(cull_list, strict_match)\n        self.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.__init__","title":"<code>__init__(file_path, header_comments_dict=None)</code>","text":"<p>Initialize the class.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def __init__(self, file_path: pathlib.Path, header_comments_dict: Optional[Dict[str, str]] = None):\n    \"\"\"Initialize the class.\"\"\"\n    self._file_path = file_path\n    self._lines = []\n    self._indent_level = 0\n    self._indent_size = 2\n    self._yaml_header = None\n    self._header_comments_dict = header_comments_dict\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.add_yaml_header","title":"<code>add_yaml_header(header)</code>","text":"<p>Add the yaml header.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def add_yaml_header(self, header: dict) -&gt; None:\n    \"\"\"Add the yaml header.\"\"\"\n    self._yaml_header = header\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.cull_headings","title":"<code>cull_headings(md_in, cull_list, strict_match=False)</code>","text":"<p>Cull headers from the lines of input markdown file with optional strict string match.</p> <p>Parameters:</p> Name Type Description Default <code>md_in</code> <code>Path</code> <p>the path of the markdown file being edited</p> required <code>cull_list</code> <code>List[str]</code> <p>the list of strings in headers that are to be culled</p> required <code>strict_match</code> <code>bool</code> <p>whether to require an exact string match on header key or just a substring</p> <code>False</code> <p>Returns None and creates new markdown at the path specified during MDWriter construction It is allowed to overwrite the original file</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def cull_headings(self, md_in: pathlib.Path, cull_list: List[str], strict_match: bool = False) -&gt; None:\n    \"\"\"\n    Cull headers from the lines of input markdown file with optional strict string match.\n\n    Args:\n        md_in: the path of the markdown file being edited\n        cull_list: the list of strings in headers that are to be culled\n        strict_match: whether to require an exact string match on header key or just a substring\n\n    Returns None and creates new markdown at the path specified during MDWriter construction\n    It is allowed to overwrite the original file\n    \"\"\"\n    markdown_api = MarkdownAPI()\n    header, content = markdown_api.processor.process_markdown(md_in)\n    self._yaml_header = header\n    self._lines = content.delete_nodes_text(cull_list, strict_match)\n    self.write_out()\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.exists","title":"<code>exists()</code>","text":"<p>Check if the file already exists.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def exists(self) -&gt; bool:\n    \"\"\"Check if the file already exists.\"\"\"\n    return self._file_path.exists()\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.get_lines","title":"<code>get_lines()</code>","text":"<p>Return the current lines in the file.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def get_lines(self) -&gt; List[str]:\n    \"\"\"Return the current lines in the file.\"\"\"\n    return self._lines\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.get_text","title":"<code>get_text()</code>","text":"<p>Get the text as currently written.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def get_text(self) -&gt; str:\n    \"\"\"Get the text as currently written.\"\"\"\n    return '\\n'.join(self._lines)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.new_header","title":"<code>new_header(level, title, add_new_line_after_header=True)</code>","text":"<p>Add new header.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def new_header(self, level: int, title: str, add_new_line_after_header: bool = True) -&gt; None:\n    \"\"\"Add new header.\"\"\"\n    # headers might be separated by blank lines\n    self.new_paragraph()\n    self.new_line('#' * level + ' ' + title)\n    if add_new_line_after_header:\n        self.new_paragraph()\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.new_hr","title":"<code>new_hr()</code>","text":"<p>Add horizontal rule.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def new_hr(self) -&gt; None:\n    \"\"\"Add horizontal rule.\"\"\"\n    self.new_paragraph()\n    self.new_line(const.SSP_MD_HRULE_LINE)\n    self.new_paragraph()\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.new_line","title":"<code>new_line(line)</code>","text":"<p>Add a line of text to the output.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def new_line(self, line: str) -&gt; None:\n    \"\"\"Add a line of text to the output.\"\"\"\n    # prevent double empty lines\n    out_line = '' if self._is_blank(line) else self._current_indent_space() + line\n    if self._prev_blank_line() and out_line == '':\n        return\n    self._add_line_raw(out_line)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.new_list","title":"<code>new_list(list_)</code>","text":"<p>Add a list to the markdown.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def new_list(self, list_: List[Any]) -&gt; None:\n    \"\"\"Add a list to the markdown.\"\"\"\n    # in general this is a list of lists\n    # if string just write it out\n    if isinstance(list_, str):\n        if self._is_blank(list_):\n            self.new_paragraph()\n        else:\n            self.new_line('- ' + list_)\n    # else it is a sublist so indent\n    else:\n        self._add_indent_level(1)\n        self.new_paragraph()\n        for item in list_:\n            if self._indent_level &lt;= 0:\n                self.new_paragraph()\n            self.new_list(item)\n        self._add_indent_level(-1)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.new_paragraph","title":"<code>new_paragraph()</code>","text":"<p>Start a new paragraph.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def new_paragraph(self):\n    \"\"\"Start a new paragraph.\"\"\"\n    self.new_line('')\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.new_paraline","title":"<code>new_paraline(line)</code>","text":"<p>Add a paragraph and a line to output.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def new_paraline(self, line: str) -&gt; None:\n    \"\"\"Add a paragraph and a line to output.\"\"\"\n    self.new_paragraph()\n    self.new_line(line)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.new_table","title":"<code>new_table(table_list, header)</code>","text":"<p>Add table to the markdown. All rows must be of equal length.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def new_table(self, table_list: List[List[str]], header: List[str]):\n    \"\"\"Add table to the markdown. All rows must be of equal length.\"\"\"\n    header_str = '| ' + ' | '.join(header) + ' |'\n    sep_str = '|---' * len(header) + '|'\n    self.new_line(header_str)\n    self.new_line(sep_str)\n    for row in table_list:\n        row_str = '| ' + ' | '.join(row) + ' |'\n        self.new_line(row_str)\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.set_indent_level","title":"<code>set_indent_level(level)</code>","text":"<p>Set the current indent level.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def set_indent_level(self, level: int) -&gt; None:\n    \"\"\"Set the current indent level.\"\"\"\n    self._indent_level = level\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.set_indent_step_size","title":"<code>set_indent_step_size(size)</code>","text":"<p>Set the indent step size in spaces.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def set_indent_step_size(self, size: int) -&gt; None:\n    \"\"\"Set the indent step size in spaces.\"\"\"\n    self._indent_size = size\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer.MDWriter.write_out","title":"<code>write_out()</code>","text":"<p>Write out the markdown file.</p> Source code in <code>trestle/core/markdown/md_writer.py</code> <pre><code>def write_out(self) -&gt; None:\n    \"\"\"Write out the markdown file.\"\"\"\n    self._check_header()\n    try:\n        self._file_path.parent.mkdir(exist_ok=True, parents=True)\n        with open(self._file_path, 'w', encoding=const.FILE_ENCODING) as f:\n            # Make sure yaml header is written first\n            if self._yaml_header:\n                f.write('---\\n')\n                yaml = YAML()\n                yaml.indent(mapping=2, sequence=4, offset=2)\n                yaml.dump(self._yaml_header, f)\n                f.write('---\\n\\n')\n\n            f.write('\\n'.join(self._lines))\n            # if last line has text it will need an extra \\n at end\n            if self._lines and self._lines[-1]:\n                f.write('\\n')\n        # insert helpful comments into the header happens after header is written out\n        for tag, comment in as_dict(self._header_comments_dict).items():\n            if tag in as_dict(self._yaml_header):\n                file_utils.insert_text_in_file(self._file_path, tag, comment)\n    except IOError as e:\n        logger.debug(f'md_writer error attempting to write out md file {self._file_path} {e}')\n        raise TrestleError(f'Error attempting to write out md file {self._file_path} {e}')\n</code></pre>"},{"location":"reference/API/trestle/core/markdown/md_writer/#trestle.core.markdown.md_writer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/actions/","title":"trestle.core.models.actions","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions","title":"<code>trestle.core.models.actions</code>","text":"<p>Action wrapper of a command.</p>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action","title":"<code>Action</code>","text":"<p>               Bases: <code>ABC</code></p> <p>Action wrapper of a command.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>class Action(ABC):\n    \"\"\"Action wrapper of a command.\"\"\"\n\n    def __init__(self, action_type: ActionType, has_rollback: bool) -&gt; None:\n        \"\"\"Initialize an base action.\"\"\"\n        self._type: ActionType = action_type\n        self._has_rollback: bool = has_rollback\n\n        # child class must set this flag once it executes\n        self._has_executed = False\n\n    def to_string(self) -&gt; str:\n        \"\"\"Return a string representation.\"\"\"\n        return self.__str__()\n\n    def get_type(self) -&gt; ActionType:\n        \"\"\"Return the action type.\"\"\"\n        return self._type\n\n    def _mark_executed(self) -&gt; None:\n        \"\"\"Set flag that the action has been executed.\"\"\"\n        self._has_executed = True\n\n    def has_executed(self) -&gt; bool:\n        \"\"\"Return if the action has been executed.\"\"\"\n        return self._has_executed\n\n    def _mark_rollback(self) -&gt; None:\n        \"\"\"Set flag that the action has been rollbacked.\"\"\"\n        self._has_executed = False\n\n    def has_rollback(self) -&gt; bool:\n        \"\"\"Return if rollback of the action is possible.\"\"\"\n        return self._has_rollback\n\n    def __eq__(self, other: object) -&gt; bool:\n        \"\"\"Check that two actions are equal.\"\"\"\n        if not isinstance(other, Action):\n            return False\n        if self.get_type() is not other.get_type():\n            return False\n        is_eq = self.__dict__ == other.__dict__\n        return is_eq\n\n    @abstractmethod\n    def execute(self) -&gt; None:\n        \"\"\"Execute the action.\"\"\"\n\n    @abstractmethod\n    def rollback(self) -&gt; None:\n        \"\"\"Rollback the action.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action.__eq__","title":"<code>__eq__(other)</code>","text":"<p>Check that two actions are equal.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __eq__(self, other: object) -&gt; bool:\n    \"\"\"Check that two actions are equal.\"\"\"\n    if not isinstance(other, Action):\n        return False\n    if self.get_type() is not other.get_type():\n        return False\n    is_eq = self.__dict__ == other.__dict__\n    return is_eq\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action.__init__","title":"<code>__init__(action_type, has_rollback)</code>","text":"<p>Initialize an base action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __init__(self, action_type: ActionType, has_rollback: bool) -&gt; None:\n    \"\"\"Initialize an base action.\"\"\"\n    self._type: ActionType = action_type\n    self._has_rollback: bool = has_rollback\n\n    # child class must set this flag once it executes\n    self._has_executed = False\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action.execute","title":"<code>execute()</code>  <code>abstractmethod</code>","text":"<p>Execute the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>@abstractmethod\ndef execute(self) -&gt; None:\n    \"\"\"Execute the action.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action.get_type","title":"<code>get_type()</code>","text":"<p>Return the action type.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def get_type(self) -&gt; ActionType:\n    \"\"\"Return the action type.\"\"\"\n    return self._type\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action.has_executed","title":"<code>has_executed()</code>","text":"<p>Return if the action has been executed.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def has_executed(self) -&gt; bool:\n    \"\"\"Return if the action has been executed.\"\"\"\n    return self._has_executed\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action.has_rollback","title":"<code>has_rollback()</code>","text":"<p>Return if rollback of the action is possible.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def has_rollback(self) -&gt; bool:\n    \"\"\"Return if rollback of the action is possible.\"\"\"\n    return self._has_rollback\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action.rollback","title":"<code>rollback()</code>  <code>abstractmethod</code>","text":"<p>Rollback the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>@abstractmethod\ndef rollback(self) -&gt; None:\n    \"\"\"Rollback the action.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.Action.to_string","title":"<code>to_string()</code>","text":"<p>Return a string representation.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def to_string(self) -&gt; str:\n    \"\"\"Return a string representation.\"\"\"\n    return self.__str__()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.ActionType","title":"<code>ActionType</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Action type enum for different action type.</p> <p>File system related actions have code like 1 Model processing related actions have code like 2</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>class ActionType(Enum):\n    \"\"\"Action type enum for different action type.\n\n    File system related actions have code like 1*\n    Model processing related actions have code like 2*\n    \"\"\"\n\n    # create a file or directory path\n    CREATE_PATH = 10\n\n    # remove a file or directory path\n    REMOVE_PATH = 12\n\n    # write element to a destination file or stream\n    WRITE = 11\n\n    # update or add the element at the path\n    UPDATE = 20\n\n    # remove the element at the path\n    REMOVE = 21\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.ActionType-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.ActionType.CREATE_PATH","title":"<code>CREATE_PATH = 10</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.ActionType.REMOVE","title":"<code>REMOVE = 21</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.ActionType.REMOVE_PATH","title":"<code>REMOVE_PATH = 12</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.ActionType.UPDATE","title":"<code>UPDATE = 20</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.ActionType.WRITE","title":"<code>WRITE = 11</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.CreatePathAction","title":"<code>CreatePathAction</code>","text":"<p>               Bases: <code>Action</code></p> <p>Create a file or directory path.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>class CreatePathAction(Action):\n    \"\"\"Create a file or directory path.\"\"\"\n\n    def __init__(self, sub_path: pathlib.Path, clear_content: bool = False) -&gt; None:\n        \"\"\"Initialize a create path action.\n\n        It creates all the missing directories in the path.\n        If it is a file, then it also creates an empty file with the name provided\n\n        Arguments:\n            sub_path: this is the desired file or directory path that needs to be created under the project root\n        \"\"\"\n        sub_path = sub_path.resolve()\n\n        self._trestle_project_root = file_utils.extract_trestle_project_root(sub_path)\n        if self._trestle_project_root is None:\n            raise TrestleError(f'Sub path \"{sub_path}\" should be child of a valid trestle project')\n\n        self._sub_path = sub_path\n        self._created_paths: List[pathlib.Path] = []\n\n        # variables for handling with file content\n        self._clear_content = clear_content\n        self._old_file_content = None\n\n        super().__init__(ActionType.CREATE_PATH, True)\n\n    def get_trestle_project_root(self) -&gt; Optional[pathlib.Path]:\n        \"\"\"Return the trestle workspace root path.\"\"\"\n        return self._trestle_project_root\n\n    def get_created_paths(self) -&gt; List[pathlib.Path]:\n        \"\"\"Get the list of paths that were created after being executed.\"\"\"\n        return self._created_paths\n\n    def execute(self) -&gt; None:\n        \"\"\"Execute the action.\"\"\"\n        # find the start of the sub_path relative to trestle project root\n        cur_index = len(self._trestle_project_root.parts)\n\n        # loop through the sub_path parts and create as necessary\n        cur_path = self._trestle_project_root\n        while cur_index &lt; len(self._sub_path.parts):\n            part = self._sub_path.parts[cur_index]\n\n            # create a path relative to the current\n            # it starts with the project root, so we shall always create\n            # sub directories or files relative to the project root\n            cur_path = cur_path / part  # type: ignore\n\n            # create the sub_path file or directory if it does not exists already\n            if cur_path.suffix != '':  # suffix will denote a file\n                if not cur_path.exists():\n                    # create file\n                    cur_path.touch()\n\n                    # add in the list for rollback\n                    self._created_paths.append(cur_path)\n                elif self._clear_content:\n                    # read file content for rollback\n                    with open(cur_path, 'r+', encoding=const.FILE_ENCODING) as fp:\n                        # read all content\n                        self._old_file_content = fp.read()\n\n                        # clear file content\n                        fp.truncate(0)\n            else:\n                if not cur_path.exists():\n                    # create directory\n                    cur_path.mkdir()\n\n                    # add in the list for rollback\n                    self._created_paths.append(cur_path)\n\n            # move to the next part of the sub_path parts\n            cur_index = cur_index + 1\n\n        self._mark_executed()\n\n    def rollback(self) -&gt; None:\n        \"\"\"Rollback the action.\"\"\"\n        if self.has_executed():\n            if len(self._created_paths) &gt; 0:\n                for cur_path in reversed(self._created_paths):\n                    if cur_path.exists():\n                        if cur_path.is_file():\n                            cur_path.unlink()\n                        elif cur_path.is_dir():\n                            cur_path.rmdir()\n\n                self._created_paths.clear()\n\n            # rollback the content of a file if required\n            # we should be here only if there were no path created and the sub_part already existed\n            elif self._sub_path.is_file() and self._sub_path.exists() and self._clear_content is True:\n                if self._old_file_content is not None:\n                    with open(self._sub_path, 'w', encoding=const.FILE_ENCODING) as fp:\n                        fp.write(self._old_file_content)\n\n        self._mark_rollback()\n\n    def __str__(self) -&gt; str:\n        \"\"\"Return string representation.\"\"\"\n        return f'{self._type} {self._sub_path}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.CreatePathAction-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.CreatePathAction.__init__","title":"<code>__init__(sub_path, clear_content=False)</code>","text":"<p>Initialize a create path action.</p> <p>It creates all the missing directories in the path. If it is a file, then it also creates an empty file with the name provided</p> <p>Parameters:</p> Name Type Description Default <code>sub_path</code> <code>Path</code> <p>this is the desired file or directory path that needs to be created under the project root</p> required Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __init__(self, sub_path: pathlib.Path, clear_content: bool = False) -&gt; None:\n    \"\"\"Initialize a create path action.\n\n    It creates all the missing directories in the path.\n    If it is a file, then it also creates an empty file with the name provided\n\n    Arguments:\n        sub_path: this is the desired file or directory path that needs to be created under the project root\n    \"\"\"\n    sub_path = sub_path.resolve()\n\n    self._trestle_project_root = file_utils.extract_trestle_project_root(sub_path)\n    if self._trestle_project_root is None:\n        raise TrestleError(f'Sub path \"{sub_path}\" should be child of a valid trestle project')\n\n    self._sub_path = sub_path\n    self._created_paths: List[pathlib.Path] = []\n\n    # variables for handling with file content\n    self._clear_content = clear_content\n    self._old_file_content = None\n\n    super().__init__(ActionType.CREATE_PATH, True)\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.CreatePathAction.__str__","title":"<code>__str__()</code>","text":"<p>Return string representation.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Return string representation.\"\"\"\n    return f'{self._type} {self._sub_path}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.CreatePathAction.execute","title":"<code>execute()</code>","text":"<p>Execute the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def execute(self) -&gt; None:\n    \"\"\"Execute the action.\"\"\"\n    # find the start of the sub_path relative to trestle project root\n    cur_index = len(self._trestle_project_root.parts)\n\n    # loop through the sub_path parts and create as necessary\n    cur_path = self._trestle_project_root\n    while cur_index &lt; len(self._sub_path.parts):\n        part = self._sub_path.parts[cur_index]\n\n        # create a path relative to the current\n        # it starts with the project root, so we shall always create\n        # sub directories or files relative to the project root\n        cur_path = cur_path / part  # type: ignore\n\n        # create the sub_path file or directory if it does not exists already\n        if cur_path.suffix != '':  # suffix will denote a file\n            if not cur_path.exists():\n                # create file\n                cur_path.touch()\n\n                # add in the list for rollback\n                self._created_paths.append(cur_path)\n            elif self._clear_content:\n                # read file content for rollback\n                with open(cur_path, 'r+', encoding=const.FILE_ENCODING) as fp:\n                    # read all content\n                    self._old_file_content = fp.read()\n\n                    # clear file content\n                    fp.truncate(0)\n        else:\n            if not cur_path.exists():\n                # create directory\n                cur_path.mkdir()\n\n                # add in the list for rollback\n                self._created_paths.append(cur_path)\n\n        # move to the next part of the sub_path parts\n        cur_index = cur_index + 1\n\n    self._mark_executed()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.CreatePathAction.get_created_paths","title":"<code>get_created_paths()</code>","text":"<p>Get the list of paths that were created after being executed.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def get_created_paths(self) -&gt; List[pathlib.Path]:\n    \"\"\"Get the list of paths that were created after being executed.\"\"\"\n    return self._created_paths\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.CreatePathAction.get_trestle_project_root","title":"<code>get_trestle_project_root()</code>","text":"<p>Return the trestle workspace root path.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def get_trestle_project_root(self) -&gt; Optional[pathlib.Path]:\n    \"\"\"Return the trestle workspace root path.\"\"\"\n    return self._trestle_project_root\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.CreatePathAction.rollback","title":"<code>rollback()</code>","text":"<p>Rollback the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def rollback(self) -&gt; None:\n    \"\"\"Rollback the action.\"\"\"\n    if self.has_executed():\n        if len(self._created_paths) &gt; 0:\n            for cur_path in reversed(self._created_paths):\n                if cur_path.exists():\n                    if cur_path.is_file():\n                        cur_path.unlink()\n                    elif cur_path.is_dir():\n                        cur_path.rmdir()\n\n            self._created_paths.clear()\n\n        # rollback the content of a file if required\n        # we should be here only if there were no path created and the sub_part already existed\n        elif self._sub_path.is_file() and self._sub_path.exists() and self._clear_content is True:\n            if self._old_file_content is not None:\n                with open(self._sub_path, 'w', encoding=const.FILE_ENCODING) as fp:\n                    fp.write(self._old_file_content)\n\n    self._mark_rollback()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemoveAction","title":"<code>RemoveAction</code>","text":"<p>               Bases: <code>Action</code></p> <p>Remove sub element at the element path in the source element.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>class RemoveAction(Action):\n    \"\"\"Remove sub element at the element path in the source element.\"\"\"\n\n    def __init__(self, src_element: Element, sub_element_path: ElementPath) -&gt; None:\n        \"\"\"Initialize a remove element action.\"\"\"\n        super().__init__(ActionType.REMOVE, True)\n\n        self._src_element: Element = src_element\n        self._sub_element_path: ElementPath = sub_element_path\n        self._prev_sub_element = None\n\n    def execute(self) -&gt; None:\n        \"\"\"Execute the action.\"\"\"\n        self._prev_sub_element = self._src_element.get_at(self._sub_element_path)\n        self._src_element.set_at(self._sub_element_path, None)\n        self._mark_executed()\n\n    def rollback(self) -&gt; None:\n        \"\"\"Rollback the action.\"\"\"\n        if self.has_executed():\n            self._src_element.set_at(self._sub_element_path, self._prev_sub_element)\n        self._mark_rollback()\n\n    def __str__(self) -&gt; str:\n        \"\"\"Return string representation.\"\"\"\n        return f'{self._type} element at {self._sub_element_path} from {self._src_element}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemoveAction-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemoveAction.__init__","title":"<code>__init__(src_element, sub_element_path)</code>","text":"<p>Initialize a remove element action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __init__(self, src_element: Element, sub_element_path: ElementPath) -&gt; None:\n    \"\"\"Initialize a remove element action.\"\"\"\n    super().__init__(ActionType.REMOVE, True)\n\n    self._src_element: Element = src_element\n    self._sub_element_path: ElementPath = sub_element_path\n    self._prev_sub_element = None\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemoveAction.__str__","title":"<code>__str__()</code>","text":"<p>Return string representation.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Return string representation.\"\"\"\n    return f'{self._type} element at {self._sub_element_path} from {self._src_element}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemoveAction.execute","title":"<code>execute()</code>","text":"<p>Execute the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def execute(self) -&gt; None:\n    \"\"\"Execute the action.\"\"\"\n    self._prev_sub_element = self._src_element.get_at(self._sub_element_path)\n    self._src_element.set_at(self._sub_element_path, None)\n    self._mark_executed()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemoveAction.rollback","title":"<code>rollback()</code>","text":"<p>Rollback the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def rollback(self) -&gt; None:\n    \"\"\"Rollback the action.\"\"\"\n    if self.has_executed():\n        self._src_element.set_at(self._sub_element_path, self._prev_sub_element)\n    self._mark_rollback()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemovePathAction","title":"<code>RemovePathAction</code>","text":"<p>               Bases: <code>Action</code></p> <p>Remove a file or directory path.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>class RemovePathAction(Action):\n    \"\"\"Remove a file or directory path.\"\"\"\n\n    def __init__(self, sub_path: pathlib.Path) -&gt; None:\n        \"\"\"Initialize a remove path action.\n\n        It removes the file or directory recursively into trash.\n\n        Arguments:\n            sub_path: this is the desired file or directory path that needs to be removed under the project root\n        \"\"\"\n        if not isinstance(sub_path, pathlib.Path):\n            raise TrestleError('Sub path must be of type pathlib.Path')\n\n        self._trestle_project_root = file_utils.extract_trestle_project_root(sub_path)\n        if self._trestle_project_root is None:\n            raise TrestleError(f'Sub path \"{sub_path}\" should be child of a valid trestle project.')\n\n        self._sub_path = sub_path\n\n        super().__init__(ActionType.REMOVE_PATH, True)\n\n    def get_trestle_project_root(self) -&gt; Optional[pathlib.Path]:\n        \"\"\"Return the trestle workspace root path.\"\"\"\n        return self._trestle_project_root\n\n    def execute(self) -&gt; None:\n        \"\"\"Execute the action.\"\"\"\n        if not self._sub_path.exists():\n            logger.debug(f'path {self._sub_path} does not exist in remove path action - ignoring.')\n\n        trash.store(self._sub_path, True)\n\n        # check if parent folder is empty and if so delete\n        parent_dir = pathlib.Path(os.path.dirname(self._sub_path))\n        files = list(parent_dir.iterdir())\n        if not files:\n            trash.store(parent_dir, True)\n        self._mark_executed()\n\n    def rollback(self) -&gt; None:\n        \"\"\"Rollback the action.\"\"\"\n        if self.has_executed():\n            trash_path = trash.to_trash_path(self._sub_path)\n            if trash_path is None or trash_path.exists() is False:\n                # FIXME suppress file contents not found message til trash/rollback behavior is fixed.  # issue 412\n                return\n            trash.recover(self._sub_path, True)\n\n        self._mark_rollback()\n\n    def __str__(self) -&gt; str:\n        \"\"\"Return string representation.\"\"\"\n        return f'{self._type} {self._sub_path}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemovePathAction-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemovePathAction.__init__","title":"<code>__init__(sub_path)</code>","text":"<p>Initialize a remove path action.</p> <p>It removes the file or directory recursively into trash.</p> <p>Parameters:</p> Name Type Description Default <code>sub_path</code> <code>Path</code> <p>this is the desired file or directory path that needs to be removed under the project root</p> required Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __init__(self, sub_path: pathlib.Path) -&gt; None:\n    \"\"\"Initialize a remove path action.\n\n    It removes the file or directory recursively into trash.\n\n    Arguments:\n        sub_path: this is the desired file or directory path that needs to be removed under the project root\n    \"\"\"\n    if not isinstance(sub_path, pathlib.Path):\n        raise TrestleError('Sub path must be of type pathlib.Path')\n\n    self._trestle_project_root = file_utils.extract_trestle_project_root(sub_path)\n    if self._trestle_project_root is None:\n        raise TrestleError(f'Sub path \"{sub_path}\" should be child of a valid trestle project.')\n\n    self._sub_path = sub_path\n\n    super().__init__(ActionType.REMOVE_PATH, True)\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemovePathAction.__str__","title":"<code>__str__()</code>","text":"<p>Return string representation.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Return string representation.\"\"\"\n    return f'{self._type} {self._sub_path}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemovePathAction.execute","title":"<code>execute()</code>","text":"<p>Execute the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def execute(self) -&gt; None:\n    \"\"\"Execute the action.\"\"\"\n    if not self._sub_path.exists():\n        logger.debug(f'path {self._sub_path} does not exist in remove path action - ignoring.')\n\n    trash.store(self._sub_path, True)\n\n    # check if parent folder is empty and if so delete\n    parent_dir = pathlib.Path(os.path.dirname(self._sub_path))\n    files = list(parent_dir.iterdir())\n    if not files:\n        trash.store(parent_dir, True)\n    self._mark_executed()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemovePathAction.get_trestle_project_root","title":"<code>get_trestle_project_root()</code>","text":"<p>Return the trestle workspace root path.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def get_trestle_project_root(self) -&gt; Optional[pathlib.Path]:\n    \"\"\"Return the trestle workspace root path.\"\"\"\n    return self._trestle_project_root\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.RemovePathAction.rollback","title":"<code>rollback()</code>","text":"<p>Rollback the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def rollback(self) -&gt; None:\n    \"\"\"Rollback the action.\"\"\"\n    if self.has_executed():\n        trash_path = trash.to_trash_path(self._sub_path)\n        if trash_path is None or trash_path.exists() is False:\n            # FIXME suppress file contents not found message til trash/rollback behavior is fixed.  # issue 412\n            return\n        trash.recover(self._sub_path, True)\n\n    self._mark_rollback()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.UpdateAction","title":"<code>UpdateAction</code>","text":"<p>               Bases: <code>Action</code></p> <p>Update element at the element path in the destination element with the source element.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>class UpdateAction(Action):\n    \"\"\"Update element at the element path in the destination element with the source element.\"\"\"\n\n    def __init__(self, sub_element, dest_element: Element, sub_element_path: ElementPath) -&gt; None:\n        \"\"\"Initialize an add element action.\n\n        Sub element can be OscalBaseModel, Element, list or None\n        \"\"\"\n        super().__init__(ActionType.UPDATE, True)\n\n        if not Element.is_allowed_sub_element_type(sub_element):\n            allowed_types = Element.get_allowed_sub_element_types()\n            raise TrestleError(\n                f'Sub element \"{sub_element.__class__} is not a allowed sub element types in \"{allowed_types}\"'\n            )\n\n        self._sub_element = sub_element\n        self._dest_element: Element = dest_element\n        self._sub_element_path: ElementPath = sub_element_path\n        self._prev_sub_element = None\n\n    def execute(self) -&gt; None:\n        \"\"\"Execute the action.\"\"\"\n        self._prev_sub_element = self._dest_element.get_at(self._sub_element_path)\n        self._dest_element.set_at(self._sub_element_path, self._sub_element)\n        self._mark_executed()\n\n    def rollback(self) -&gt; None:\n        \"\"\"Rollback the action.\"\"\"\n        if self.has_executed():\n            self._dest_element.set_at(self._sub_element_path, self._prev_sub_element)\n        self._mark_rollback()\n\n    def __str__(self) -&gt; str:\n        \"\"\"Return string representation.\"\"\"\n        return f'{self._type} {self._model_obj.__class__} to {self._dest_element} at {self._sub_element_path}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.UpdateAction-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.UpdateAction.__init__","title":"<code>__init__(sub_element, dest_element, sub_element_path)</code>","text":"<p>Initialize an add element action.</p> <p>Sub element can be OscalBaseModel, Element, list or None</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __init__(self, sub_element, dest_element: Element, sub_element_path: ElementPath) -&gt; None:\n    \"\"\"Initialize an add element action.\n\n    Sub element can be OscalBaseModel, Element, list or None\n    \"\"\"\n    super().__init__(ActionType.UPDATE, True)\n\n    if not Element.is_allowed_sub_element_type(sub_element):\n        allowed_types = Element.get_allowed_sub_element_types()\n        raise TrestleError(\n            f'Sub element \"{sub_element.__class__} is not a allowed sub element types in \"{allowed_types}\"'\n        )\n\n    self._sub_element = sub_element\n    self._dest_element: Element = dest_element\n    self._sub_element_path: ElementPath = sub_element_path\n    self._prev_sub_element = None\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.UpdateAction.__str__","title":"<code>__str__()</code>","text":"<p>Return string representation.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Return string representation.\"\"\"\n    return f'{self._type} {self._model_obj.__class__} to {self._dest_element} at {self._sub_element_path}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.UpdateAction.execute","title":"<code>execute()</code>","text":"<p>Execute the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def execute(self) -&gt; None:\n    \"\"\"Execute the action.\"\"\"\n    self._prev_sub_element = self._dest_element.get_at(self._sub_element_path)\n    self._dest_element.set_at(self._sub_element_path, self._sub_element)\n    self._mark_executed()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.UpdateAction.rollback","title":"<code>rollback()</code>","text":"<p>Rollback the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def rollback(self) -&gt; None:\n    \"\"\"Rollback the action.\"\"\"\n    if self.has_executed():\n        self._dest_element.set_at(self._sub_element_path, self._prev_sub_element)\n    self._mark_rollback()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteAction","title":"<code>WriteAction</code>","text":"<p>               Bases: <code>Action</code></p> <p>Write the element to a destination stream.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>class WriteAction(Action):\n    \"\"\"Write the element to a destination stream.\"\"\"\n\n    def __init__(self, writer: Optional[io.TextIOWrapper], element: Element, content_type: FileContentType) -&gt; None:\n        \"\"\"Initialize an write file action.\"\"\"\n        super().__init__(ActionType.WRITE, True)\n\n        if writer is not None and not issubclass(io.TextIOWrapper, writer.__class__):\n            raise TrestleError(f'Writer must be of io.TextIOWrapper, given f{writer.__class__}')\n\n        self._writer: Optional[io.TextIOWrapper] = writer\n        self._element: Element = element\n        self._content_type: FileContentType = content_type\n        self._lastStreamPos = -1\n        if self._writer is not None:\n            self._lastStreamPos = self._writer.tell()\n\n    def _is_writer_valid(self) -&gt; bool:\n        if self._writer is not None and isinstance(self._writer, io.TextIOWrapper) and not self._writer.closed:\n            return True\n\n        return False\n\n    def _encode(self) -&gt; str:\n        \"\"\"Encode the element to appropriate content type.\"\"\"\n        if self._content_type == FileContentType.YAML:\n            return self._element.to_yaml()\n        if self._content_type == FileContentType.JSON:\n            return self._element.to_json()\n\n        raise TrestleError(f'Invalid content type {self._content_type}')\n\n    def execute(self) -&gt; None:\n        \"\"\"Execute the action.\"\"\"\n        if self._element is None:\n            raise TrestleError('Element is empty and cannot write')\n\n        if not self._is_writer_valid():\n            raise TrestleError('Writer is not provided or closed')\n\n        self._writer.write(self._encode())\n        self._writer.flush()\n        self._mark_executed()\n\n    def rollback(self) -&gt; None:\n        \"\"\"Rollback the action.\"\"\"\n        if not self._is_writer_valid():\n            raise TrestleError('Writer is not provided or closed')\n\n        if self._lastStreamPos &lt; 0:\n            raise TrestleError('Last stream position is not available to rollback to')\n\n        if self.has_executed():\n            self._writer.seek(self._lastStreamPos)\n            self._writer.truncate()\n\n        self._mark_rollback()\n\n    def __str__(self) -&gt; str:\n        \"\"\"Return string representation.\"\"\"\n        return f'{self.get_type()} {self._element}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteAction-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteAction.__init__","title":"<code>__init__(writer, element, content_type)</code>","text":"<p>Initialize an write file action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __init__(self, writer: Optional[io.TextIOWrapper], element: Element, content_type: FileContentType) -&gt; None:\n    \"\"\"Initialize an write file action.\"\"\"\n    super().__init__(ActionType.WRITE, True)\n\n    if writer is not None and not issubclass(io.TextIOWrapper, writer.__class__):\n        raise TrestleError(f'Writer must be of io.TextIOWrapper, given f{writer.__class__}')\n\n    self._writer: Optional[io.TextIOWrapper] = writer\n    self._element: Element = element\n    self._content_type: FileContentType = content_type\n    self._lastStreamPos = -1\n    if self._writer is not None:\n        self._lastStreamPos = self._writer.tell()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteAction.__str__","title":"<code>__str__()</code>","text":"<p>Return string representation.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Return string representation.\"\"\"\n    return f'{self.get_type()} {self._element}'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteAction.execute","title":"<code>execute()</code>","text":"<p>Execute the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def execute(self) -&gt; None:\n    \"\"\"Execute the action.\"\"\"\n    if self._element is None:\n        raise TrestleError('Element is empty and cannot write')\n\n    if not self._is_writer_valid():\n        raise TrestleError('Writer is not provided or closed')\n\n    self._writer.write(self._encode())\n    self._writer.flush()\n    self._mark_executed()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteAction.rollback","title":"<code>rollback()</code>","text":"<p>Rollback the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def rollback(self) -&gt; None:\n    \"\"\"Rollback the action.\"\"\"\n    if not self._is_writer_valid():\n        raise TrestleError('Writer is not provided or closed')\n\n    if self._lastStreamPos &lt; 0:\n        raise TrestleError('Last stream position is not available to rollback to')\n\n    if self.has_executed():\n        self._writer.seek(self._lastStreamPos)\n        self._writer.truncate()\n\n    self._mark_rollback()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteFileAction","title":"<code>WriteFileAction</code>","text":"<p>               Bases: <code>WriteAction</code></p> <p>Write the element to a destination file.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>class WriteFileAction(WriteAction):\n    \"\"\"Write the element to a destination file.\"\"\"\n\n    def __init__(self, file_path: pathlib.Path, element: Element, content_type: FileContentType) -&gt; None:\n        \"\"\"Initialize a write file action.\n\n        It opens the file in append mode. Therefore the file needs to exist even if it is a new file.\n        \"\"\"\n        if not isinstance(file_path, pathlib.Path):\n            raise TrestleError('file_path should be of type pathlib.Path')\n\n        inferred_content_type = FileContentType.to_content_type(file_path.suffix)\n        if inferred_content_type != content_type:\n            raise TrestleError(f'Mismatch between stated content type {content_type.name} and file path {file_path}')\n\n        self._file_path = file_path\n\n        # initialize super without writer for now\n        # Note, execute and rollback sets the writer as appropriate\n        super().__init__(None, element, content_type)\n\n    def execute(self) -&gt; None:\n        \"\"\"Execute the action.\"\"\"\n        if not self._file_path.exists():\n            raise TrestleError(f'File at {self._file_path} does not exist')\n\n        with open(self._file_path, 'a+', encoding=const.FILE_ENCODING) as writer:\n            if self._lastStreamPos &lt; 0:\n                self._lastStreamPos = writer.tell()\n            else:\n                writer.seek(self._lastStreamPos)\n\n            self._writer = writer\n            super().execute()\n\n    def rollback(self) -&gt; None:\n        \"\"\"Execute the rollback action.\"\"\"\n        if not self._file_path.exists():\n            raise TrestleError(f'File at {self._file_path} does not exist')\n\n        with open(self._file_path, 'a+', encoding=const.FILE_ENCODING) as writer:\n            self._writer = writer\n            super().rollback()\n\n    def __str__(self) -&gt; str:\n        \"\"\"Return string representation.\"\"\"\n        return f'{self._type} {self._element} to \"{self._file_path}\"'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteFileAction-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteFileAction.__init__","title":"<code>__init__(file_path, element, content_type)</code>","text":"<p>Initialize a write file action.</p> <p>It opens the file in append mode. Therefore the file needs to exist even if it is a new file.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __init__(self, file_path: pathlib.Path, element: Element, content_type: FileContentType) -&gt; None:\n    \"\"\"Initialize a write file action.\n\n    It opens the file in append mode. Therefore the file needs to exist even if it is a new file.\n    \"\"\"\n    if not isinstance(file_path, pathlib.Path):\n        raise TrestleError('file_path should be of type pathlib.Path')\n\n    inferred_content_type = FileContentType.to_content_type(file_path.suffix)\n    if inferred_content_type != content_type:\n        raise TrestleError(f'Mismatch between stated content type {content_type.name} and file path {file_path}')\n\n    self._file_path = file_path\n\n    # initialize super without writer for now\n    # Note, execute and rollback sets the writer as appropriate\n    super().__init__(None, element, content_type)\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteFileAction.__str__","title":"<code>__str__()</code>","text":"<p>Return string representation.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Return string representation.\"\"\"\n    return f'{self._type} {self._element} to \"{self._file_path}\"'\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteFileAction.execute","title":"<code>execute()</code>","text":"<p>Execute the action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def execute(self) -&gt; None:\n    \"\"\"Execute the action.\"\"\"\n    if not self._file_path.exists():\n        raise TrestleError(f'File at {self._file_path} does not exist')\n\n    with open(self._file_path, 'a+', encoding=const.FILE_ENCODING) as writer:\n        if self._lastStreamPos &lt; 0:\n            self._lastStreamPos = writer.tell()\n        else:\n            writer.seek(self._lastStreamPos)\n\n        self._writer = writer\n        super().execute()\n</code></pre>"},{"location":"reference/API/trestle/core/models/actions/#trestle.core.models.actions.WriteFileAction.rollback","title":"<code>rollback()</code>","text":"<p>Execute the rollback action.</p> Source code in <code>trestle/core/models/actions.py</code> <pre><code>def rollback(self) -&gt; None:\n    \"\"\"Execute the rollback action.\"\"\"\n    if not self._file_path.exists():\n        raise TrestleError(f'File at {self._file_path} does not exist')\n\n    with open(self._file_path, 'a+', encoding=const.FILE_ENCODING) as writer:\n        self._writer = writer\n        super().rollback()\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/","title":"trestle.core.models.elements","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements","title":"<code>trestle.core.models.elements</code>","text":"<p>Element wrapper of an OSCAL model element.</p>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element","title":"<code>Element</code>","text":"<p>Element wrapper of an OSCAL model.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>class Element:\n    \"\"\"Element wrapper of an OSCAL model.\"\"\"\n\n    IGNORE_WRAPPER_ALIAS = '__'\n\n    _allowed_sub_element_types: List[str] = ['Element', 'OscalBaseModel', 'list', 'None', 'dict']\n\n    def __init__(self, elem: OscalBaseModel, wrapper_alias: str = ''):\n        \"\"\"Initialize an element wrapper.\n\n        wrapper_alias is the OSCAL alias for the given elem object and used for seriazation in to_json() method.\n\n        For example,\n         - List[Catalog.Group] element should have wrapper alias 'groups'\n         - Catalog element should have wrapper alias 'catalog'\n\n        wrapper_alias is deduced for collection type object\n\n        if wrapper_alias = IGNORE_WRAPPER_ALIAS, then it is ignored and assumed to be json-serializable during to_json()\n        \"\"\"\n        # FIXME: There are instances where elem is a list.\n        self._elem: OscalBaseModel = elem\n\n        if wrapper_alias == '' and wrapper_alias != self.IGNORE_WRAPPER_ALIAS:\n            class_name = elem.__class__.__name__\n            if utils.is_collection_field_type(elem):\n                class_name = self._get_singular_classname()\n                if class_name is None:\n                    raise TrestleError(\n                        f'wrapper_alias not found for a collection type object: {elem.__class__.__name__}'\n                    )\n            wrapper_alias = str_utils.classname_to_alias(class_name, AliasMode.JSON)\n\n        self._wrapper_alias: str = wrapper_alias\n\n    def _get_singular_classname(self) -&gt; str:\n        \"\"\"Get the inner class name for list or dict objects.\"\"\"\n        # this assumes all items in list and all values in dict are same type\n        class_name = None\n        root = getattr(self._elem, '__root__', None)\n        if root is not None:\n            type_str = root.__class__.__name__\n            if type_str == 'list':\n                class_name = self._elem.__root__[0].__class__.__name__\n            elif type_str == 'dict':\n                class_name = list(self._elem.__root__.values())[0].__class__.__name__\n        return class_name\n\n    def get(self) -&gt; OscalBaseModel:\n        \"\"\"Return the model object.\"\"\"\n        return self._elem\n\n    def _split_element_path(self, element_path: ElementPath):\n        \"\"\"Split the element path into root_model and remaing attr names.\"\"\"\n        path_parts = element_path.get()\n        root_model = path_parts[0]\n        path_parts = path_parts[1:]\n\n        return root_model, path_parts\n\n    def get_at(self,\n               element_path: ElementPath = None,\n               check_parent: bool = True) -&gt; Union[OscalBaseModel, List[OscalBaseModel]]:\n        \"\"\"Get the element at the specified element path.\n\n        it will return the sub-model object at the path. Sub-model object\n        can be of type OscalBaseModel or List\n        \"\"\"\n        if element_path is None:\n            return self._elem\n\n        # find the root-model and element path parts\n        _, path_parts = self._split_element_path(element_path)\n\n        # TODO validate that self._elem is of same type as root_model\n\n        # initialize the starting element for search\n        elm = self._elem\n        if hasattr(elm, '__root__') and (isinstance(elm.__root__, dict) or isinstance(elm.__root__, list)):\n            elm = elm.__root__\n\n        # if parent exists and does not end with wildcard, use the parent as the starting element for search\n        if check_parent and element_path.get_parent(\n        ) is not None and element_path.get_parent().get_last() != ElementPath.WILDCARD:\n            elm_at = self.get_at(element_path.get_parent())\n            if elm_at is None:\n                raise TrestleNotFoundError(f'Invalid parent path {element_path.get_parent()}')\n            elm = elm_at\n\n        # return the sub-element at the specified path\n        for attr in path_parts:\n            if elm is None:\n                break\n\n            # process for wildcard and array indexes\n\n            if attr == ElementPath.WILDCARD:\n                break\n            elif attr.isnumeric():\n                if isinstance(elm, list):\n                    elm = elm[int(attr)]\n                else:\n                    # index to a non list type should return None\n                    return None\n            else:\n                elm = elm.get_field_value_by_alias(attr)\n\n        return elm\n\n    def get_preceding_element(self, element_path: ElementPath) -&gt; Optional[OscalBaseModel]:\n        \"\"\"Get the preceding element in the path.\"\"\"\n        preceding_path = element_path.get_preceding_path()\n        preceding_elm: Optional[OscalBaseModel] = self.get_at(preceding_path)\n        return preceding_elm\n\n    def _get_sub_element_obj(self, sub_element):\n        \"\"\"Convert sub element into allowed model obj.\"\"\"\n        if not self.is_allowed_sub_element_type(sub_element):\n            raise TrestleError(\n                f'Sub element must be one of \"{self.get_allowed_sub_element_types()}\", found \"{sub_element.__class__}\"'\n            )\n\n        model_obj = sub_element\n        if isinstance(sub_element, Element):\n            model_obj = sub_element.get()\n\n        return model_obj\n\n    def set_at(self, element_path: ElementPath, sub_element: OscalBaseModel) -&gt; 'Element':\n        \"\"\"Set a sub_element at the path in the current element.\n\n        Sub element can be Element, OscalBaseModel, list or None type\n        It returns the element itself so that chaining operation can be done such as\n            `element.set_at(path, sub-element).get()`.\n        \"\"\"\n        # convert the element_path to ElementPath if needed\n        if isinstance(element_path, str):\n            element_path = ElementPath(element_path)\n\n        # convert sub-element to OscalBaseModel if needed\n        model_obj = self._get_sub_element_obj(sub_element)\n\n        # find the root-model and element path parts\n        _, path_parts = self._split_element_path(element_path)\n\n        # TODO validate that self._elem is of same type as root_model\n\n        # If wildcard is present, check the input type and determine the preceding element\n        if element_path.get_last() == ElementPath.WILDCARD:\n            # validate the type is either list or OscalBaseModel\n            if not isinstance(model_obj, list) and not isinstance(model_obj, OscalBaseModel):\n                raise TrestleError(\n                    f'The model object needs to be a List or OscalBaseModel for path with \"{ElementPath.WILDCARD}\"'\n                )\n\n            # since wildcard * is there, we need to go one level up for preceding element in the path\n            preceding_elm = self.get_preceding_element(element_path.get_preceding_path())\n        else:\n            # get the preceding element in the path\n            preceding_elm = self.get_preceding_element(element_path)\n\n        if preceding_elm is None:\n            raise TrestleError(f'Invalid sub element path {element_path} with no valid preceding element')\n\n        # check if it can be a valid sub_element of the parent\n        sub_element_name = element_path.get_element_name().replace('-', '_')\n        if hasattr(preceding_elm, sub_element_name) is False:\n            raise TrestleError(\n                f'Element \"{preceding_elm.__class__}\" does not have the attribute \"{sub_element_name}\" '\n                f'of type \"{model_obj.__class__}\"'\n            )\n\n        # set the sub-element\n        try:\n            setattr(preceding_elm, sub_element_name, model_obj)\n        except ValidationError:\n            sub_element_class = self.get_sub_element_class(preceding_elm, sub_element_name)\n            raise TrestleError(\n                f'Validation error: {sub_element_name} is expected to be \"{sub_element_class}\", '\n                f'but found \"{model_obj.__class__}\"'\n            )\n\n        # returning self will allow to do 'chaining' of commands after set\n        return self\n\n    def to_yaml(self) -&gt; str:\n        \"\"\"Convert into YAML string.\"\"\"\n        yaml = YAML(typ='safe')\n        yaml.default_flow_style = False\n        from io import StringIO\n        string_stream = StringIO()\n        yaml.dump(yaml.load(self.to_json(pretty=False)), string_stream)\n        yaml_data = string_stream.getvalue()\n        string_stream.close()\n\n        return yaml_data\n\n    def to_json(self, pretty: bool = True) -&gt; str:\n        \"\"\"Convert into JSON string.\"\"\"\n        if self._wrapper_alias == self.IGNORE_WRAPPER_ALIAS:\n            json_data = self._elem.oscal_serialize_json(pretty=pretty, wrapped=False)\n\n        else:\n            # Note before trying to edit this\n            # This transient model allows self._elem not be an OscalBaseModel (e.g. a DICT or LIST)\n            # typing need to be clarified.\n            if isinstance(self._elem, OscalBaseModel):\n                json_data = self._elem.oscal_serialize_json(pretty=pretty)\n            else:\n                dynamic_passer = {}\n                dynamic_passer['TransientField'] = (self._elem.__class__, Field(self, alias=self._wrapper_alias))\n                wrapper_model = create_model('TransientModel', __base__=OscalBaseModel, **dynamic_passer)\n                wrapped_model = wrapper_model.construct(**{self._wrapper_alias: self._elem})\n                json_data = wrapped_model.oscal_serialize_json(pretty=pretty, wrapped=False)\n        return json_data\n\n    @classmethod\n    def get_sub_element_class(cls, parent_elm: OscalBaseModel, sub_element_name: str):\n        \"\"\"Get the class of the sub-element.\"\"\"\n        sub_element_class = parent_elm.__fields__[sub_element_name].outer_type_\n        return sub_element_class\n\n    @classmethod\n    def get_allowed_sub_element_types(cls) -&gt; List[str]:\n        \"\"\"Get the list of allowed sub element types.\"\"\"\n        return cls._allowed_sub_element_types\n\n    @classmethod\n    def is_allowed_sub_element_type(cls, elm) -&gt; bool:\n        \"\"\"Check if is of allowed sub element type.\"\"\"\n        # FIXME: The following logic does not use the _allowed_sub_element_types being defined for the class\n        if (isinstance(elm, Element) or isinstance(elm, OscalBaseModel) or isinstance(elm, list)\n                or isinstance(elm, dict) or elm is None):\n            return True\n\n        return False\n\n    def __str__(self) -&gt; str:\n        \"\"\"Return string representation of element.\"\"\"\n        return type(self._elem).__name__\n\n    def __eq__(self, other: object) -&gt; bool:\n        \"\"\"Check that two elements are equal.\"\"\"\n        if not isinstance(other, Element):\n            return False\n\n        return self.get() == other.get()\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.IGNORE_WRAPPER_ALIAS","title":"<code>IGNORE_WRAPPER_ALIAS = '__'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.__eq__","title":"<code>__eq__(other)</code>","text":"<p>Check that two elements are equal.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def __eq__(self, other: object) -&gt; bool:\n    \"\"\"Check that two elements are equal.\"\"\"\n    if not isinstance(other, Element):\n        return False\n\n    return self.get() == other.get()\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.__init__","title":"<code>__init__(elem, wrapper_alias='')</code>","text":"<p>Initialize an element wrapper.</p> <p>wrapper_alias is the OSCAL alias for the given elem object and used for seriazation in to_json() method.</p> <p>For example,  - List[Catalog.Group] element should have wrapper alias 'groups'  - Catalog element should have wrapper alias 'catalog'</p> <p>wrapper_alias is deduced for collection type object</p> <p>if wrapper_alias = IGNORE_WRAPPER_ALIAS, then it is ignored and assumed to be json-serializable during to_json()</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def __init__(self, elem: OscalBaseModel, wrapper_alias: str = ''):\n    \"\"\"Initialize an element wrapper.\n\n    wrapper_alias is the OSCAL alias for the given elem object and used for seriazation in to_json() method.\n\n    For example,\n     - List[Catalog.Group] element should have wrapper alias 'groups'\n     - Catalog element should have wrapper alias 'catalog'\n\n    wrapper_alias is deduced for collection type object\n\n    if wrapper_alias = IGNORE_WRAPPER_ALIAS, then it is ignored and assumed to be json-serializable during to_json()\n    \"\"\"\n    # FIXME: There are instances where elem is a list.\n    self._elem: OscalBaseModel = elem\n\n    if wrapper_alias == '' and wrapper_alias != self.IGNORE_WRAPPER_ALIAS:\n        class_name = elem.__class__.__name__\n        if utils.is_collection_field_type(elem):\n            class_name = self._get_singular_classname()\n            if class_name is None:\n                raise TrestleError(\n                    f'wrapper_alias not found for a collection type object: {elem.__class__.__name__}'\n                )\n        wrapper_alias = str_utils.classname_to_alias(class_name, AliasMode.JSON)\n\n    self._wrapper_alias: str = wrapper_alias\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.__str__","title":"<code>__str__()</code>","text":"<p>Return string representation of element.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Return string representation of element.\"\"\"\n    return type(self._elem).__name__\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.get","title":"<code>get()</code>","text":"<p>Return the model object.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get(self) -&gt; OscalBaseModel:\n    \"\"\"Return the model object.\"\"\"\n    return self._elem\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.get_allowed_sub_element_types","title":"<code>get_allowed_sub_element_types()</code>  <code>classmethod</code>","text":"<p>Get the list of allowed sub element types.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>@classmethod\ndef get_allowed_sub_element_types(cls) -&gt; List[str]:\n    \"\"\"Get the list of allowed sub element types.\"\"\"\n    return cls._allowed_sub_element_types\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.get_at","title":"<code>get_at(element_path=None, check_parent=True)</code>","text":"<p>Get the element at the specified element path.</p> <p>it will return the sub-model object at the path. Sub-model object can be of type OscalBaseModel or List</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_at(self,\n           element_path: ElementPath = None,\n           check_parent: bool = True) -&gt; Union[OscalBaseModel, List[OscalBaseModel]]:\n    \"\"\"Get the element at the specified element path.\n\n    it will return the sub-model object at the path. Sub-model object\n    can be of type OscalBaseModel or List\n    \"\"\"\n    if element_path is None:\n        return self._elem\n\n    # find the root-model and element path parts\n    _, path_parts = self._split_element_path(element_path)\n\n    # TODO validate that self._elem is of same type as root_model\n\n    # initialize the starting element for search\n    elm = self._elem\n    if hasattr(elm, '__root__') and (isinstance(elm.__root__, dict) or isinstance(elm.__root__, list)):\n        elm = elm.__root__\n\n    # if parent exists and does not end with wildcard, use the parent as the starting element for search\n    if check_parent and element_path.get_parent(\n    ) is not None and element_path.get_parent().get_last() != ElementPath.WILDCARD:\n        elm_at = self.get_at(element_path.get_parent())\n        if elm_at is None:\n            raise TrestleNotFoundError(f'Invalid parent path {element_path.get_parent()}')\n        elm = elm_at\n\n    # return the sub-element at the specified path\n    for attr in path_parts:\n        if elm is None:\n            break\n\n        # process for wildcard and array indexes\n\n        if attr == ElementPath.WILDCARD:\n            break\n        elif attr.isnumeric():\n            if isinstance(elm, list):\n                elm = elm[int(attr)]\n            else:\n                # index to a non list type should return None\n                return None\n        else:\n            elm = elm.get_field_value_by_alias(attr)\n\n    return elm\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.get_preceding_element","title":"<code>get_preceding_element(element_path)</code>","text":"<p>Get the preceding element in the path.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_preceding_element(self, element_path: ElementPath) -&gt; Optional[OscalBaseModel]:\n    \"\"\"Get the preceding element in the path.\"\"\"\n    preceding_path = element_path.get_preceding_path()\n    preceding_elm: Optional[OscalBaseModel] = self.get_at(preceding_path)\n    return preceding_elm\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.get_sub_element_class","title":"<code>get_sub_element_class(parent_elm, sub_element_name)</code>  <code>classmethod</code>","text":"<p>Get the class of the sub-element.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>@classmethod\ndef get_sub_element_class(cls, parent_elm: OscalBaseModel, sub_element_name: str):\n    \"\"\"Get the class of the sub-element.\"\"\"\n    sub_element_class = parent_elm.__fields__[sub_element_name].outer_type_\n    return sub_element_class\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.is_allowed_sub_element_type","title":"<code>is_allowed_sub_element_type(elm)</code>  <code>classmethod</code>","text":"<p>Check if is of allowed sub element type.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>@classmethod\ndef is_allowed_sub_element_type(cls, elm) -&gt; bool:\n    \"\"\"Check if is of allowed sub element type.\"\"\"\n    # FIXME: The following logic does not use the _allowed_sub_element_types being defined for the class\n    if (isinstance(elm, Element) or isinstance(elm, OscalBaseModel) or isinstance(elm, list)\n            or isinstance(elm, dict) or elm is None):\n        return True\n\n    return False\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.set_at","title":"<code>set_at(element_path, sub_element)</code>","text":"<p>Set a sub_element at the path in the current element.</p> <p>Sub element can be Element, OscalBaseModel, list or None type It returns the element itself so that chaining operation can be done such as     <code>element.set_at(path, sub-element).get()</code>.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def set_at(self, element_path: ElementPath, sub_element: OscalBaseModel) -&gt; 'Element':\n    \"\"\"Set a sub_element at the path in the current element.\n\n    Sub element can be Element, OscalBaseModel, list or None type\n    It returns the element itself so that chaining operation can be done such as\n        `element.set_at(path, sub-element).get()`.\n    \"\"\"\n    # convert the element_path to ElementPath if needed\n    if isinstance(element_path, str):\n        element_path = ElementPath(element_path)\n\n    # convert sub-element to OscalBaseModel if needed\n    model_obj = self._get_sub_element_obj(sub_element)\n\n    # find the root-model and element path parts\n    _, path_parts = self._split_element_path(element_path)\n\n    # TODO validate that self._elem is of same type as root_model\n\n    # If wildcard is present, check the input type and determine the preceding element\n    if element_path.get_last() == ElementPath.WILDCARD:\n        # validate the type is either list or OscalBaseModel\n        if not isinstance(model_obj, list) and not isinstance(model_obj, OscalBaseModel):\n            raise TrestleError(\n                f'The model object needs to be a List or OscalBaseModel for path with \"{ElementPath.WILDCARD}\"'\n            )\n\n        # since wildcard * is there, we need to go one level up for preceding element in the path\n        preceding_elm = self.get_preceding_element(element_path.get_preceding_path())\n    else:\n        # get the preceding element in the path\n        preceding_elm = self.get_preceding_element(element_path)\n\n    if preceding_elm is None:\n        raise TrestleError(f'Invalid sub element path {element_path} with no valid preceding element')\n\n    # check if it can be a valid sub_element of the parent\n    sub_element_name = element_path.get_element_name().replace('-', '_')\n    if hasattr(preceding_elm, sub_element_name) is False:\n        raise TrestleError(\n            f'Element \"{preceding_elm.__class__}\" does not have the attribute \"{sub_element_name}\" '\n            f'of type \"{model_obj.__class__}\"'\n        )\n\n    # set the sub-element\n    try:\n        setattr(preceding_elm, sub_element_name, model_obj)\n    except ValidationError:\n        sub_element_class = self.get_sub_element_class(preceding_elm, sub_element_name)\n        raise TrestleError(\n            f'Validation error: {sub_element_name} is expected to be \"{sub_element_class}\", '\n            f'but found \"{model_obj.__class__}\"'\n        )\n\n    # returning self will allow to do 'chaining' of commands after set\n    return self\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.to_json","title":"<code>to_json(pretty=True)</code>","text":"<p>Convert into JSON string.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def to_json(self, pretty: bool = True) -&gt; str:\n    \"\"\"Convert into JSON string.\"\"\"\n    if self._wrapper_alias == self.IGNORE_WRAPPER_ALIAS:\n        json_data = self._elem.oscal_serialize_json(pretty=pretty, wrapped=False)\n\n    else:\n        # Note before trying to edit this\n        # This transient model allows self._elem not be an OscalBaseModel (e.g. a DICT or LIST)\n        # typing need to be clarified.\n        if isinstance(self._elem, OscalBaseModel):\n            json_data = self._elem.oscal_serialize_json(pretty=pretty)\n        else:\n            dynamic_passer = {}\n            dynamic_passer['TransientField'] = (self._elem.__class__, Field(self, alias=self._wrapper_alias))\n            wrapper_model = create_model('TransientModel', __base__=OscalBaseModel, **dynamic_passer)\n            wrapped_model = wrapper_model.construct(**{self._wrapper_alias: self._elem})\n            json_data = wrapped_model.oscal_serialize_json(pretty=pretty, wrapped=False)\n    return json_data\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.Element.to_yaml","title":"<code>to_yaml()</code>","text":"<p>Convert into YAML string.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def to_yaml(self) -&gt; str:\n    \"\"\"Convert into YAML string.\"\"\"\n    yaml = YAML(typ='safe')\n    yaml.default_flow_style = False\n    from io import StringIO\n    string_stream = StringIO()\n    yaml.dump(yaml.load(self.to_json(pretty=False)), string_stream)\n    yaml_data = string_stream.getvalue()\n    string_stream.close()\n\n    return yaml_data\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath","title":"<code>ElementPath</code>","text":"<p>Element path wrapper of an element.</p> <p>This only allows a single wildcard '*' at the end to denote elements of an array or dict</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>class ElementPath:\n    \"\"\"Element path wrapper of an element.\n\n    This only allows a single wildcard '*' at the end to denote elements of an array or dict\n    \"\"\"\n\n    PATH_SEPARATOR: str = const.ALIAS_PATH_SEPARATOR\n\n    WILDCARD: str = '*'\n\n    def __init__(self, element_path: str, parent_path: Optional['ElementPath'] = None) -&gt; None:\n        \"\"\"Initialize an element wrapper.\n\n        It assumes the element path contains oscal field alias with hyphens only\n        \"\"\"\n        self._parent_path = parent_path\n\n        self._path: List[str] = self._parse(element_path)\n\n        # Initialize private variables for lazy processing and caching\n        self._element_name: Optional[str] = None\n        self._preceding_path: Optional['ElementPath'] = None\n\n    def _parse(self, element_path: str) -&gt; List[str]:\n        \"\"\"Parse the element path and validate.\"\"\"\n        parts: List[str] = element_path.split(self.PATH_SEPARATOR)\n\n        for part in parts:\n            if part == '':\n                raise TrestleError(\n                    f'Invalid path \"{element_path}\" because there are empty path parts between \"{self.PATH_SEPARATOR}\" '\n                    'or in the beginning'\n                )\n\n        if parts[0] == self.WILDCARD:\n            raise TrestleError(f'Invalid path {element_path} with wildcard.')\n        return parts\n\n    def get(self) -&gt; List[str]:\n        \"\"\"Return the path parts as a list.\"\"\"\n        return self._path\n\n    def get_type(self, root_model: Optional[Type[Any]] = None, use_parent: bool = False) -&gt; Type[Any]:\n        \"\"\"Get the type of an element.\n\n        If possible the model type will be derived from one of the top level models,\n        otherwise a 'root model' can be passed for situations where this is not possible.\n\n        This type path should *NOT* have wild cards in it. It *may* have* indices.\n        Valid Examples:\n            catalog.metadata\n            catalog.groups\n            catalog.groups.group\n            catalog\n            catalog.groups.0\n\n        Args:\n            root_model: An OscalBaseModel Type from which to base the approach on.\n            use_parent: Whether or not to normalise the full path across parent ElementPaths, default to not.\n\n        Returns:\n            The type of the model whether or not it is an OscalBaseModel or not.\n        \"\"\"\n        effective_path: List[str]\n        if use_parent:\n            effective_path = self.get_full_path_parts()\n        else:\n            effective_path = self._path\n\n        if not root_model:\n            # lookup root model from top level oscal models or fail\n            prev_model = self._top_level_type_lookup(effective_path[0])\n        else:\n            prev_model = root_model\n        if len(effective_path) == 1:\n            return prev_model\n        # variables\n        # for current_element_str in effective_path[1:]:\n        for current_element_str in effective_path[1:]:\n            # Determine if the parent model is a collection.\n            if utils.is_collection_field_type(prev_model):\n                inner_model = utils.get_inner_type(prev_model)\n                inner_class_name = classname_to_alias(inner_model.__name__, AliasMode.JSON)\n                # Assert that the current name fits an expected form.\n                # Valid choices here are *, integer (for arrays) and the inner model alias\n                if (inner_class_name == current_element_str or current_element_str == self.WILDCARD\n                        or current_element_str.isnumeric()):\n                    prev_model = inner_model\n\n                else:\n                    raise TrestleError('Unexpected key in element path when finding type.')\n\n            else:\n                # Indices, * are not allowed on non-collection types\n                if current_element_str == self.WILDCARD:\n                    raise TrestleError(\n                        'Wild card in unexpected position when trying to find class type.'\n                        + ' Element path type lookup can only occur where a single type can be identified.'\n                    )\n                prev_model = prev_model.alias_to_field_map()[current_element_str].outer_type_\n        return prev_model\n\n    def get_obm_wrapped_type(self,\n                             root_model: Optional[Type[Any]] = None,\n                             use_parent: bool = False) -&gt; Type[OscalBaseModel]:\n        \"\"\"Get the type of the element. Wraps the collection type in an OscalBaseModel as a __root__ element.\n\n        This should principally be used for validating content.\n\n        Args:\n            root_model: An OscalBaseModel Type from which to base the approach on.\n            use_parent: Whether or not to normalise the full path across parent ElementPaths, default to not.\n\n        Returns:\n            The type of the model whether wrapped or not as an OscalBaseModel.\n        \"\"\"\n        base_type = self.get_type(root_model, use_parent)\n        # Get an outer model type.\n        origin_type = utils.get_origin(base_type)\n\n        if origin_type in [list, dict]:\n            # OSCAL does not support collections of collections directly. We should not hit this scenario\n            collection_name = self.get_last()\n            if collection_name == self.WILDCARD:\n                logger.critical('Unexpected error in type system when inferring type from element path.')\n                logger.critical('Please report this issue.')\n                raise TrestleError('Unknown error inferring type from element path.')\n            # Final path must be the alias\n\n            new_base_type = create_model(\n                str_utils.alias_to_classname(collection_name, AliasMode.JSON),\n                __base__=OscalBaseModel,\n                __root__=(base_type, ...)\n            )\n            return new_base_type\n        return base_type\n\n    def _top_level_type_lookup(self, element_str: str) -&gt; Type[common_types.TopLevelOscalModel]:\n        \"\"\"From an individual element tag, induce the type of the model.\n\n        Args:\n            element_str: individual element as text such as 'catalog' or 'profile'\n\n        Returns:\n            Top level object model such as catalog, profile etc.\n        \"\"\"\n        # Even though awkward use chain of models.\n        if element_str not in const.MODEL_TYPE_LIST:\n            raise TrestleError(f'{element_str} is not a top level model (e.g. catalog, profile)')\n        model_package = const.MODEL_TYPE_TO_MODEL_MODULE[element_str]\n        object_type, _ = ModelUtils.get_root_model(model_package)\n        object_type = cast(Type[common_types.TopLevelOscalModel], object_type)\n        return object_type\n\n    def is_multipart(self) -&gt; bool:\n        \"\"\"Assert whether or not an element path is multiple parts.\n\n        Originally element paths had to have multiple paths.\n        This provides a check for higher level code that still has that requirement.\n\n        Single part:\n            catalog\n            control\n            assessment-results\n\n        Multipart:\n            catalog.metadata\n            catalog.controls.control\n        \"\"\"\n        return len(self._path) &gt; 1\n\n    def to_string(self) -&gt; str:\n        \"\"\"Return the path parts as a dot-separated string.\"\"\"\n        return self.PATH_SEPARATOR.join(self.get())\n\n    def get_parent(self) -&gt; 'ElementPath':\n        \"\"\"Return the parent path.\n\n        It can be None or a valid ElementPath\n        \"\"\"\n        return self._parent_path\n\n    def get_first(self) -&gt; str:\n        \"\"\"Return the first part of the path.\"\"\"\n        return self._path[0]\n\n    def get_last(self) -&gt; str:\n        \"\"\"Return the last part of the path.\"\"\"\n        return self._path[-1]\n\n    def get_full(self) -&gt; str:\n        \"\"\"Return the full path including parent path parts as a dot separated str.\"\"\"\n        all_parts = self.get_full_path_parts()\n        return self.PATH_SEPARATOR.join(all_parts)\n\n    def get_element_name(self) -&gt; str:\n        \"\"\"Return the element alias name from the path.\n\n        Essentailly this the last part of the element path\n        \"\"\"\n        # if it is available then return otherwise compute\n        if self._element_name is None:\n            element_name = self.get_last()\n            if element_name == self.WILDCARD:\n                element_name = self._path[-2]\n\n            self._element_name = element_name\n\n        return self._element_name\n\n    def get_full_path_parts(self) -&gt; List[str]:\n        \"\"\"Get full path parts to the element including parent path parts as a list.\"\"\"\n        path_parts = []\n        if self.get_parent() is not None:\n            parent_path_parts = self.get_parent().get_full_path_parts()\n            path_parts.extend(parent_path_parts)\n            path_parts.extend(self.get()[1:])  # don't use the first part\n        else:\n            path_parts.extend(self.get())\n\n        return path_parts\n\n    def get_preceding_path(self) -&gt; 'ElementPath':\n        \"\"\"Return the element path to the preceding element in the path.\"\"\"\n        # if it is available then return otherwise compute\n        if self._preceding_path is None:\n            path_parts = self.get_full_path_parts()\n\n            if len(path_parts) &gt; 1:\n                prec_path_parts = path_parts[:-1]\n                self._preceding_path = ElementPath(self.PATH_SEPARATOR.join(prec_path_parts))\n\n        return self._preceding_path\n\n    def find_last_file_in_path(self, content_type: FileContentType, model_dir: pathlib.Path) -&gt; pathlib.Path:\n        \"\"\"Find the last (nearest) existing file in the element path leading to this element.\"\"\"\n        # model dir is the top level dir for this model, e.g. catalogs/mycat\n        path = model_dir\n        extension = FileContentType.to_file_extension(content_type)\n        good_model: pathlib.Path = None\n        for element in self._path:\n            if element == '*':\n                break\n            model_file = (path / element).with_suffix(extension)\n            if not model_file.exists():\n                break\n            path = path / element\n            good_model = model_file\n        return good_model\n\n    def make_absolute(self, model_dir: pathlib.Path, reference_dir: pathlib.Path):\n        \"\"\"Make the parts absolute from the top model dir.\"\"\"\n        # Match the current relative element path to the model directory and reference directory\n        # If the element path is partial and doesn't connect to the top of the model,\n        # need to deduce absolute element path from the model_dir and the reference directory\n        # that corresponds to the root of the element path\n\n        # if first element is a model type it is already absolute\n        if self._path[0] not in const.MODEL_TYPE_LIST:\n            rel_path = list(reference_dir.relative_to(model_dir).parts)\n            rel_path.extend(self._path)\n            self._path = rel_path\n\n    def make_relative(self, model_relative_path: pathlib.Path) -&gt; int:\n        \"\"\"Make the parts relative to the model path.\"\"\"\n        # The element path should currently be absolute\n        # The model relative path should be relative to the top leve of the model\n        # Change the element path to be relative to the model being loaded\n        # Returns 0 on success and 1 on failur\n        rel_path_parts = model_relative_path.parts[:-1]\n        n_rel_parts = len(rel_path_parts)\n        # the element path can't start above the model path\n        if n_rel_parts &gt;= len(self._path):\n            return 1\n        # confirm the leading parts match\n        for ii in range(n_rel_parts):\n            if rel_path_parts[ii] != self._path[ii]:\n                return 1\n        # chop off the leading parts of the absolute element path\n        self._path = self._path[n_rel_parts:]\n        return 0\n\n    def to_file_path(self, content_type: FileContentType = None, root_dir: str = '') -&gt; pathlib.Path:\n        \"\"\"Convert to a file or directory path for the element path.\n\n        if content_type is not passed, it will return a path for directory\n        \"\"\"\n        path_parts = self.get()\n\n        # skip wildcard\n        if path_parts[-1] == ElementPath.WILDCARD:\n            path_parts = path_parts[:-1]\n\n        if root_dir != '':\n            path_parts[0] = root_dir\n\n        path_str = '/'.join(path_parts)\n\n        # add file extension if required\n        # this will be omitted if it is a dir path\n        if content_type is not None:\n            file_extension = FileContentType.to_file_extension(content_type)\n            path_str = path_str + file_extension\n\n        # prepare the path\n        file_path: pathlib.Path = pathlib.Path(f'./{path_str}')\n\n        return file_path\n\n    def to_root_path(self, content_type: FileContentType = None) -&gt; pathlib.Path:\n        \"\"\"Convert to a file path for the element root.\"\"\"\n        path_str = f'./{self.get_first()}'\n        if content_type is not None:\n            file_extension = FileContentType.to_file_extension(content_type)\n            path_str = path_str + file_extension\n\n        file_path: pathlib.Path = pathlib.Path(path_str)\n        return file_path\n\n    def __str__(self) -&gt; str:\n        \"\"\"Return string representation of element path.\"\"\"\n        return self.to_string()\n\n    def __eq__(self, other) -&gt; bool:\n        \"\"\"Override equality method.\"\"\"\n        if not isinstance(other, ElementPath):\n            return False\n\n        return self.get() == other.get()\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.PATH_SEPARATOR","title":"<code>PATH_SEPARATOR: str = const.ALIAS_PATH_SEPARATOR</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.WILDCARD","title":"<code>WILDCARD: str = '*'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.__eq__","title":"<code>__eq__(other)</code>","text":"<p>Override equality method.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def __eq__(self, other) -&gt; bool:\n    \"\"\"Override equality method.\"\"\"\n    if not isinstance(other, ElementPath):\n        return False\n\n    return self.get() == other.get()\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.__init__","title":"<code>__init__(element_path, parent_path=None)</code>","text":"<p>Initialize an element wrapper.</p> <p>It assumes the element path contains oscal field alias with hyphens only</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def __init__(self, element_path: str, parent_path: Optional['ElementPath'] = None) -&gt; None:\n    \"\"\"Initialize an element wrapper.\n\n    It assumes the element path contains oscal field alias with hyphens only\n    \"\"\"\n    self._parent_path = parent_path\n\n    self._path: List[str] = self._parse(element_path)\n\n    # Initialize private variables for lazy processing and caching\n    self._element_name: Optional[str] = None\n    self._preceding_path: Optional['ElementPath'] = None\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.__str__","title":"<code>__str__()</code>","text":"<p>Return string representation of element path.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Return string representation of element path.\"\"\"\n    return self.to_string()\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.find_last_file_in_path","title":"<code>find_last_file_in_path(content_type, model_dir)</code>","text":"<p>Find the last (nearest) existing file in the element path leading to this element.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def find_last_file_in_path(self, content_type: FileContentType, model_dir: pathlib.Path) -&gt; pathlib.Path:\n    \"\"\"Find the last (nearest) existing file in the element path leading to this element.\"\"\"\n    # model dir is the top level dir for this model, e.g. catalogs/mycat\n    path = model_dir\n    extension = FileContentType.to_file_extension(content_type)\n    good_model: pathlib.Path = None\n    for element in self._path:\n        if element == '*':\n            break\n        model_file = (path / element).with_suffix(extension)\n        if not model_file.exists():\n            break\n        path = path / element\n        good_model = model_file\n    return good_model\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get","title":"<code>get()</code>","text":"<p>Return the path parts as a list.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get(self) -&gt; List[str]:\n    \"\"\"Return the path parts as a list.\"\"\"\n    return self._path\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get_element_name","title":"<code>get_element_name()</code>","text":"<p>Return the element alias name from the path.</p> <p>Essentailly this the last part of the element path</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_element_name(self) -&gt; str:\n    \"\"\"Return the element alias name from the path.\n\n    Essentailly this the last part of the element path\n    \"\"\"\n    # if it is available then return otherwise compute\n    if self._element_name is None:\n        element_name = self.get_last()\n        if element_name == self.WILDCARD:\n            element_name = self._path[-2]\n\n        self._element_name = element_name\n\n    return self._element_name\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get_first","title":"<code>get_first()</code>","text":"<p>Return the first part of the path.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_first(self) -&gt; str:\n    \"\"\"Return the first part of the path.\"\"\"\n    return self._path[0]\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get_full","title":"<code>get_full()</code>","text":"<p>Return the full path including parent path parts as a dot separated str.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_full(self) -&gt; str:\n    \"\"\"Return the full path including parent path parts as a dot separated str.\"\"\"\n    all_parts = self.get_full_path_parts()\n    return self.PATH_SEPARATOR.join(all_parts)\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get_full_path_parts","title":"<code>get_full_path_parts()</code>","text":"<p>Get full path parts to the element including parent path parts as a list.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_full_path_parts(self) -&gt; List[str]:\n    \"\"\"Get full path parts to the element including parent path parts as a list.\"\"\"\n    path_parts = []\n    if self.get_parent() is not None:\n        parent_path_parts = self.get_parent().get_full_path_parts()\n        path_parts.extend(parent_path_parts)\n        path_parts.extend(self.get()[1:])  # don't use the first part\n    else:\n        path_parts.extend(self.get())\n\n    return path_parts\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get_last","title":"<code>get_last()</code>","text":"<p>Return the last part of the path.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_last(self) -&gt; str:\n    \"\"\"Return the last part of the path.\"\"\"\n    return self._path[-1]\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get_obm_wrapped_type","title":"<code>get_obm_wrapped_type(root_model=None, use_parent=False)</code>","text":"<p>Get the type of the element. Wraps the collection type in an OscalBaseModel as a root element.</p> <p>This should principally be used for validating content.</p> <p>Parameters:</p> Name Type Description Default <code>root_model</code> <code>Optional[Type[Any]]</code> <p>An OscalBaseModel Type from which to base the approach on.</p> <code>None</code> <code>use_parent</code> <code>bool</code> <p>Whether or not to normalise the full path across parent ElementPaths, default to not.</p> <code>False</code> <p>Returns:</p> Type Description <code>Type[OscalBaseModel]</code> <p>The type of the model whether wrapped or not as an OscalBaseModel.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_obm_wrapped_type(self,\n                         root_model: Optional[Type[Any]] = None,\n                         use_parent: bool = False) -&gt; Type[OscalBaseModel]:\n    \"\"\"Get the type of the element. Wraps the collection type in an OscalBaseModel as a __root__ element.\n\n    This should principally be used for validating content.\n\n    Args:\n        root_model: An OscalBaseModel Type from which to base the approach on.\n        use_parent: Whether or not to normalise the full path across parent ElementPaths, default to not.\n\n    Returns:\n        The type of the model whether wrapped or not as an OscalBaseModel.\n    \"\"\"\n    base_type = self.get_type(root_model, use_parent)\n    # Get an outer model type.\n    origin_type = utils.get_origin(base_type)\n\n    if origin_type in [list, dict]:\n        # OSCAL does not support collections of collections directly. We should not hit this scenario\n        collection_name = self.get_last()\n        if collection_name == self.WILDCARD:\n            logger.critical('Unexpected error in type system when inferring type from element path.')\n            logger.critical('Please report this issue.')\n            raise TrestleError('Unknown error inferring type from element path.')\n        # Final path must be the alias\n\n        new_base_type = create_model(\n            str_utils.alias_to_classname(collection_name, AliasMode.JSON),\n            __base__=OscalBaseModel,\n            __root__=(base_type, ...)\n        )\n        return new_base_type\n    return base_type\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get_parent","title":"<code>get_parent()</code>","text":"<p>Return the parent path.</p> <p>It can be None or a valid ElementPath</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_parent(self) -&gt; 'ElementPath':\n    \"\"\"Return the parent path.\n\n    It can be None or a valid ElementPath\n    \"\"\"\n    return self._parent_path\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get_preceding_path","title":"<code>get_preceding_path()</code>","text":"<p>Return the element path to the preceding element in the path.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_preceding_path(self) -&gt; 'ElementPath':\n    \"\"\"Return the element path to the preceding element in the path.\"\"\"\n    # if it is available then return otherwise compute\n    if self._preceding_path is None:\n        path_parts = self.get_full_path_parts()\n\n        if len(path_parts) &gt; 1:\n            prec_path_parts = path_parts[:-1]\n            self._preceding_path = ElementPath(self.PATH_SEPARATOR.join(prec_path_parts))\n\n    return self._preceding_path\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.get_type","title":"<code>get_type(root_model=None, use_parent=False)</code>","text":"<p>Get the type of an element.</p> <p>If possible the model type will be derived from one of the top level models, otherwise a 'root model' can be passed for situations where this is not possible.</p> <p>This type path should NOT have wild cards in it. It may have* indices. Valid Examples:     catalog.metadata     catalog.groups     catalog.groups.group     catalog     catalog.groups.0</p> <p>Parameters:</p> Name Type Description Default <code>root_model</code> <code>Optional[Type[Any]]</code> <p>An OscalBaseModel Type from which to base the approach on.</p> <code>None</code> <code>use_parent</code> <code>bool</code> <p>Whether or not to normalise the full path across parent ElementPaths, default to not.</p> <code>False</code> <p>Returns:</p> Type Description <code>Type[Any]</code> <p>The type of the model whether or not it is an OscalBaseModel or not.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def get_type(self, root_model: Optional[Type[Any]] = None, use_parent: bool = False) -&gt; Type[Any]:\n    \"\"\"Get the type of an element.\n\n    If possible the model type will be derived from one of the top level models,\n    otherwise a 'root model' can be passed for situations where this is not possible.\n\n    This type path should *NOT* have wild cards in it. It *may* have* indices.\n    Valid Examples:\n        catalog.metadata\n        catalog.groups\n        catalog.groups.group\n        catalog\n        catalog.groups.0\n\n    Args:\n        root_model: An OscalBaseModel Type from which to base the approach on.\n        use_parent: Whether or not to normalise the full path across parent ElementPaths, default to not.\n\n    Returns:\n        The type of the model whether or not it is an OscalBaseModel or not.\n    \"\"\"\n    effective_path: List[str]\n    if use_parent:\n        effective_path = self.get_full_path_parts()\n    else:\n        effective_path = self._path\n\n    if not root_model:\n        # lookup root model from top level oscal models or fail\n        prev_model = self._top_level_type_lookup(effective_path[0])\n    else:\n        prev_model = root_model\n    if len(effective_path) == 1:\n        return prev_model\n    # variables\n    # for current_element_str in effective_path[1:]:\n    for current_element_str in effective_path[1:]:\n        # Determine if the parent model is a collection.\n        if utils.is_collection_field_type(prev_model):\n            inner_model = utils.get_inner_type(prev_model)\n            inner_class_name = classname_to_alias(inner_model.__name__, AliasMode.JSON)\n            # Assert that the current name fits an expected form.\n            # Valid choices here are *, integer (for arrays) and the inner model alias\n            if (inner_class_name == current_element_str or current_element_str == self.WILDCARD\n                    or current_element_str.isnumeric()):\n                prev_model = inner_model\n\n            else:\n                raise TrestleError('Unexpected key in element path when finding type.')\n\n        else:\n            # Indices, * are not allowed on non-collection types\n            if current_element_str == self.WILDCARD:\n                raise TrestleError(\n                    'Wild card in unexpected position when trying to find class type.'\n                    + ' Element path type lookup can only occur where a single type can be identified.'\n                )\n            prev_model = prev_model.alias_to_field_map()[current_element_str].outer_type_\n    return prev_model\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.is_multipart","title":"<code>is_multipart()</code>","text":"<p>Assert whether or not an element path is multiple parts.</p> <p>Originally element paths had to have multiple paths. This provides a check for higher level code that still has that requirement.</p> Single part <p>catalog control assessment-results</p> Multipart <p>catalog.metadata catalog.controls.control</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def is_multipart(self) -&gt; bool:\n    \"\"\"Assert whether or not an element path is multiple parts.\n\n    Originally element paths had to have multiple paths.\n    This provides a check for higher level code that still has that requirement.\n\n    Single part:\n        catalog\n        control\n        assessment-results\n\n    Multipart:\n        catalog.metadata\n        catalog.controls.control\n    \"\"\"\n    return len(self._path) &gt; 1\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.make_absolute","title":"<code>make_absolute(model_dir, reference_dir)</code>","text":"<p>Make the parts absolute from the top model dir.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def make_absolute(self, model_dir: pathlib.Path, reference_dir: pathlib.Path):\n    \"\"\"Make the parts absolute from the top model dir.\"\"\"\n    # Match the current relative element path to the model directory and reference directory\n    # If the element path is partial and doesn't connect to the top of the model,\n    # need to deduce absolute element path from the model_dir and the reference directory\n    # that corresponds to the root of the element path\n\n    # if first element is a model type it is already absolute\n    if self._path[0] not in const.MODEL_TYPE_LIST:\n        rel_path = list(reference_dir.relative_to(model_dir).parts)\n        rel_path.extend(self._path)\n        self._path = rel_path\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.make_relative","title":"<code>make_relative(model_relative_path)</code>","text":"<p>Make the parts relative to the model path.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def make_relative(self, model_relative_path: pathlib.Path) -&gt; int:\n    \"\"\"Make the parts relative to the model path.\"\"\"\n    # The element path should currently be absolute\n    # The model relative path should be relative to the top leve of the model\n    # Change the element path to be relative to the model being loaded\n    # Returns 0 on success and 1 on failur\n    rel_path_parts = model_relative_path.parts[:-1]\n    n_rel_parts = len(rel_path_parts)\n    # the element path can't start above the model path\n    if n_rel_parts &gt;= len(self._path):\n        return 1\n    # confirm the leading parts match\n    for ii in range(n_rel_parts):\n        if rel_path_parts[ii] != self._path[ii]:\n            return 1\n    # chop off the leading parts of the absolute element path\n    self._path = self._path[n_rel_parts:]\n    return 0\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.to_file_path","title":"<code>to_file_path(content_type=None, root_dir='')</code>","text":"<p>Convert to a file or directory path for the element path.</p> <p>if content_type is not passed, it will return a path for directory</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def to_file_path(self, content_type: FileContentType = None, root_dir: str = '') -&gt; pathlib.Path:\n    \"\"\"Convert to a file or directory path for the element path.\n\n    if content_type is not passed, it will return a path for directory\n    \"\"\"\n    path_parts = self.get()\n\n    # skip wildcard\n    if path_parts[-1] == ElementPath.WILDCARD:\n        path_parts = path_parts[:-1]\n\n    if root_dir != '':\n        path_parts[0] = root_dir\n\n    path_str = '/'.join(path_parts)\n\n    # add file extension if required\n    # this will be omitted if it is a dir path\n    if content_type is not None:\n        file_extension = FileContentType.to_file_extension(content_type)\n        path_str = path_str + file_extension\n\n    # prepare the path\n    file_path: pathlib.Path = pathlib.Path(f'./{path_str}')\n\n    return file_path\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.to_root_path","title":"<code>to_root_path(content_type=None)</code>","text":"<p>Convert to a file path for the element root.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def to_root_path(self, content_type: FileContentType = None) -&gt; pathlib.Path:\n    \"\"\"Convert to a file path for the element root.\"\"\"\n    path_str = f'./{self.get_first()}'\n    if content_type is not None:\n        file_extension = FileContentType.to_file_extension(content_type)\n        path_str = path_str + file_extension\n\n    file_path: pathlib.Path = pathlib.Path(path_str)\n    return file_path\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements.ElementPath.to_string","title":"<code>to_string()</code>","text":"<p>Return the path parts as a dot-separated string.</p> Source code in <code>trestle/core/models/elements.py</code> <pre><code>def to_string(self) -&gt; str:\n    \"\"\"Return the path parts as a dot-separated string.\"\"\"\n    return self.PATH_SEPARATOR.join(self.get())\n</code></pre>"},{"location":"reference/API/trestle/core/models/elements/#trestle.core.models.elements-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/file_content_type/","title":"trestle.core.models.file_content_type","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type","title":"<code>trestle.core.models.file_content_type</code>","text":"<p>Action wrapper of a command.</p>"},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType","title":"<code>FileContentType</code>","text":"<p>               Bases: <code>Enum</code></p> <p>File Content type for read/write.</p> Source code in <code>trestle/core/models/file_content_type.py</code> <pre><code>class FileContentType(Enum):\n    \"\"\"File Content type for read/write.\"\"\"\n\n    # JSON formatted content\n    JSON = 1\n\n    # YAML formatted content\n    YAML = 2\n\n    # No extension and possibly a DIR\n    DIRLIKE = 3\n\n    # Type could not be determined\n    UNKNOWN = 4\n\n    @classmethod\n    def to_file_extension(cls, content_type: 'FileContentType') -&gt; str:\n        \"\"\"Get file extension for the type, including the dot.\"\"\"\n        if content_type == FileContentType.YAML:\n            return '.yaml'\n        if content_type == FileContentType.JSON:\n            return '.json'\n        raise TrestleError(f'Invalid file content type {content_type}')\n\n    @classmethod\n    def to_content_type(cls, file_extension: str) -&gt; 'FileContentType':\n        \"\"\"Get content type form file extension, including the dot.\"\"\"\n        if file_extension == '.json':\n            return FileContentType.JSON\n        if file_extension == '.yaml' or file_extension == '.yml':\n            return FileContentType.YAML\n        if not file_extension:\n            return FileContentType.DIRLIKE\n\n        raise TrestleError(f'Unsupported file extension {file_extension}')\n\n    @classmethod\n    def path_to_content_type(cls, file_path: Path) -&gt; 'FileContentType':\n        \"\"\"Get content type from file path looking for extension.\"\"\"\n        if file_path.with_suffix('.json').exists():\n            return FileContentType.JSON\n        if file_path.with_suffix('.yaml').exists():\n            return FileContentType.YAML\n        if file_path.with_suffix('.yml').exists():\n            return FileContentType.YAML\n        return FileContentType.UNKNOWN\n\n    @classmethod\n    def dir_to_content_type(cls, dir_path: Path) -&gt; 'FileContentType':\n        \"\"\"Get content type by looking for json or yaml files in dir.\"\"\"\n        files = dir_path.glob('*')\n        for file in files:\n            if file.is_file():\n                suffix = file.suffix\n                if suffix == '.json':\n                    return FileContentType.JSON\n                if suffix in ['.yaml', '.yml']:\n                    return FileContentType.YAML\n        return FileContentType.UNKNOWN\n\n    @classmethod\n    def path_to_file_extension(cls, file_path: Path) -&gt; str:\n        \"\"\"Get extension from file path looking for extension.\"\"\"\n        if file_path.with_suffix('.json').exists():\n            return '.json'\n        if file_path.with_suffix('.yaml').exists():\n            return '.yaml'\n        if file_path.with_suffix('.yml').exists():\n            return '.yml'\n        return ''\n\n    @classmethod\n    def is_readable_file(cls, content_type: 'FileContentType') -&gt; bool:\n        \"\"\"Is the file a type that can be read directly.\"\"\"\n        return content_type == FileContentType.JSON or content_type == FileContentType.YAML\n</code></pre>"},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.DIRLIKE","title":"<code>DIRLIKE = 3</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.JSON","title":"<code>JSON = 1</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.UNKNOWN","title":"<code>UNKNOWN = 4</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.YAML","title":"<code>YAML = 2</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.dir_to_content_type","title":"<code>dir_to_content_type(dir_path)</code>  <code>classmethod</code>","text":"<p>Get content type by looking for json or yaml files in dir.</p> Source code in <code>trestle/core/models/file_content_type.py</code> <pre><code>@classmethod\ndef dir_to_content_type(cls, dir_path: Path) -&gt; 'FileContentType':\n    \"\"\"Get content type by looking for json or yaml files in dir.\"\"\"\n    files = dir_path.glob('*')\n    for file in files:\n        if file.is_file():\n            suffix = file.suffix\n            if suffix == '.json':\n                return FileContentType.JSON\n            if suffix in ['.yaml', '.yml']:\n                return FileContentType.YAML\n    return FileContentType.UNKNOWN\n</code></pre>"},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.is_readable_file","title":"<code>is_readable_file(content_type)</code>  <code>classmethod</code>","text":"<p>Is the file a type that can be read directly.</p> Source code in <code>trestle/core/models/file_content_type.py</code> <pre><code>@classmethod\ndef is_readable_file(cls, content_type: 'FileContentType') -&gt; bool:\n    \"\"\"Is the file a type that can be read directly.\"\"\"\n    return content_type == FileContentType.JSON or content_type == FileContentType.YAML\n</code></pre>"},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.path_to_content_type","title":"<code>path_to_content_type(file_path)</code>  <code>classmethod</code>","text":"<p>Get content type from file path looking for extension.</p> Source code in <code>trestle/core/models/file_content_type.py</code> <pre><code>@classmethod\ndef path_to_content_type(cls, file_path: Path) -&gt; 'FileContentType':\n    \"\"\"Get content type from file path looking for extension.\"\"\"\n    if file_path.with_suffix('.json').exists():\n        return FileContentType.JSON\n    if file_path.with_suffix('.yaml').exists():\n        return FileContentType.YAML\n    if file_path.with_suffix('.yml').exists():\n        return FileContentType.YAML\n    return FileContentType.UNKNOWN\n</code></pre>"},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.path_to_file_extension","title":"<code>path_to_file_extension(file_path)</code>  <code>classmethod</code>","text":"<p>Get extension from file path looking for extension.</p> Source code in <code>trestle/core/models/file_content_type.py</code> <pre><code>@classmethod\ndef path_to_file_extension(cls, file_path: Path) -&gt; str:\n    \"\"\"Get extension from file path looking for extension.\"\"\"\n    if file_path.with_suffix('.json').exists():\n        return '.json'\n    if file_path.with_suffix('.yaml').exists():\n        return '.yaml'\n    if file_path.with_suffix('.yml').exists():\n        return '.yml'\n    return ''\n</code></pre>"},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.to_content_type","title":"<code>to_content_type(file_extension)</code>  <code>classmethod</code>","text":"<p>Get content type form file extension, including the dot.</p> Source code in <code>trestle/core/models/file_content_type.py</code> <pre><code>@classmethod\ndef to_content_type(cls, file_extension: str) -&gt; 'FileContentType':\n    \"\"\"Get content type form file extension, including the dot.\"\"\"\n    if file_extension == '.json':\n        return FileContentType.JSON\n    if file_extension == '.yaml' or file_extension == '.yml':\n        return FileContentType.YAML\n    if not file_extension:\n        return FileContentType.DIRLIKE\n\n    raise TrestleError(f'Unsupported file extension {file_extension}')\n</code></pre>"},{"location":"reference/API/trestle/core/models/file_content_type/#trestle.core.models.file_content_type.FileContentType.to_file_extension","title":"<code>to_file_extension(content_type)</code>  <code>classmethod</code>","text":"<p>Get file extension for the type, including the dot.</p> Source code in <code>trestle/core/models/file_content_type.py</code> <pre><code>@classmethod\ndef to_file_extension(cls, content_type: 'FileContentType') -&gt; str:\n    \"\"\"Get file extension for the type, including the dot.\"\"\"\n    if content_type == FileContentType.YAML:\n        return '.yaml'\n    if content_type == FileContentType.JSON:\n        return '.json'\n    raise TrestleError(f'Invalid file content type {content_type}')\n</code></pre>"},{"location":"reference/API/trestle/core/models/interfaces/","title":"trestle.core.models.interfaces","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces","title":"<code>trestle.core.models.interfaces</code>","text":"<p>Interfaces for use within other trestle functions defined as pydantic data models.</p>"},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly","title":"<code>OSCALAssembly</code>","text":"<p>               Bases: <code>TrestleBaseModel</code></p> <p>Data model to represent an assembled set of OSCAL objects.</p> <p>Here the assembly represents the constraints as expected by the current OSCAL schema. At this point in time a 'flat' model has been chosen rather than an tree.</p> Source code in <code>trestle/core/models/interfaces.py</code> <pre><code>class OSCALAssembly(TrestleBaseModel):\n    \"\"\"Data model to represent an assembled set of OSCAL objects.\n\n    Here the assembly represents the constraints as expected by the current OSCAL\n    schema. At this point in time a 'flat' model has been chosen rather than an tree.\n    \"\"\"\n\n    poam: Optional[o_poam.PlanOfActionAndMilestones] = None\n    sar: Optional[o_ar.AssessmentResults] = None\n    sap: Optional[o_ap.AssessmentPlan] = None\n    ssp: Optional[o_ssp.SystemSecurityPlan] = None\n    profiles: Optional[Dict[str, o_profile.Profile]] = None\n    catalogs: Optional[Dict[str, o_catalog.Catalog]] = None\n    components: Optional[Dict[str, o_component.ComponentDefinition]] = None\n\n    class Config:\n        \"\"\"Pydantic config overrides.\"\"\"\n\n        allow_population_by_field_name = True\n        # Enforce strict schema\n        extra = Extra.forbid\n        # Validate on assignment of variables to ensure no escapes\n        validate_assignment = True\n</code></pre>"},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly.catalogs","title":"<code>catalogs: Optional[Dict[str, o_catalog.Catalog]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly.components","title":"<code>components: Optional[Dict[str, o_component.ComponentDefinition]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly.poam","title":"<code>poam: Optional[o_poam.PlanOfActionAndMilestones] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly.profiles","title":"<code>profiles: Optional[Dict[str, o_profile.Profile]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly.sap","title":"<code>sap: Optional[o_ap.AssessmentPlan] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly.sar","title":"<code>sar: Optional[o_ar.AssessmentResults] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly.ssp","title":"<code>ssp: Optional[o_ssp.SystemSecurityPlan] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/models/interfaces/#trestle.core.models.interfaces.OSCALAssembly.Config","title":"<code>Config</code>","text":"<p>Pydantic config overrides.</p> Source code in <code>trestle/core/models/interfaces.py</code> <pre><code>class Config:\n    \"\"\"Pydantic config overrides.\"\"\"\n\n    allow_population_by_field_name = True\n    # Enforce strict schema\n    extra = Extra.forbid\n    # Validate on assignment of variables to ensure no escapes\n    validate_assignment = True\n</code></pre> Attributes\u00a4 <code>allow_population_by_field_name = True</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4 <code>validate_assignment = True</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/core/models/plans/","title":"trestle.core.models.plans","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans","title":"<code>trestle.core.models.plans</code>","text":"<p>Plan of action of a command.</p>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan","title":"<code>Plan</code>","text":"<p>Plan of action of a command.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>class Plan:\n    \"\"\"Plan of action of a command.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize a plan.\"\"\"\n        self._actions: List[Action] = []\n\n    def _action_key(self, action: Action) -&gt; int:\n        return hash(action)\n\n    def __str__(self) -&gt; str:\n        \"\"\"Print the plan.\"\"\"\n        list_actions = []\n        index = 1\n        for action in self._actions:\n            list_actions.append(f'{index}. {action}')\n            index = index + 1\n\n        list_str = '\\n'.join(list_actions)\n        return list_str\n\n    def get_actions(self) -&gt; List[Action]:\n        \"\"\"Get all actions.\"\"\"\n        return self._actions\n\n    def add_action(self, action: Action) -&gt; None:\n        \"\"\"Add a new action.\"\"\"\n        self._actions.append(action)\n\n    def add_actions(self, actions: List[Action]) -&gt; None:\n        \"\"\"Add actions in order.\"\"\"\n        self._actions.extend(actions)\n\n    def clear_actions(self) -&gt; None:\n        \"\"\"Clear all actions.\"\"\"\n        self._actions = []\n\n    def execute(self) -&gt; None:\n        \"\"\"Execute the actions in the plan.\"\"\"\n        for action in self._actions:\n            try:\n                action.execute()\n            except Exception as e:\n                logger.error(f'Failed to execute action {action} for the plan: {e}. Rolling back.')\n                self.rollback()\n                raise e\n\n    def rollback(self) -&gt; None:\n        \"\"\"Rollback the actions in the plan.\"\"\"\n        # execute in reverse order\n        for action in reversed(self._actions):\n            if action.has_rollback() is False:\n                raise UnsupportedOperation(f'{action.get_type()} does not support rollback')\n            action.rollback()\n\n    def __eq__(self, other: object) -&gt; bool:\n        \"\"\"Check that two plans are equal.\"\"\"\n        if not isinstance(other, Plan):\n            return False\n\n        return self.get_actions() == other.get_actions()\n</code></pre>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan.__eq__","title":"<code>__eq__(other)</code>","text":"<p>Check that two plans are equal.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>def __eq__(self, other: object) -&gt; bool:\n    \"\"\"Check that two plans are equal.\"\"\"\n    if not isinstance(other, Plan):\n        return False\n\n    return self.get_actions() == other.get_actions()\n</code></pre>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan.__init__","title":"<code>__init__()</code>","text":"<p>Initialize a plan.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize a plan.\"\"\"\n    self._actions: List[Action] = []\n</code></pre>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan.__str__","title":"<code>__str__()</code>","text":"<p>Print the plan.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>def __str__(self) -&gt; str:\n    \"\"\"Print the plan.\"\"\"\n    list_actions = []\n    index = 1\n    for action in self._actions:\n        list_actions.append(f'{index}. {action}')\n        index = index + 1\n\n    list_str = '\\n'.join(list_actions)\n    return list_str\n</code></pre>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan.add_action","title":"<code>add_action(action)</code>","text":"<p>Add a new action.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>def add_action(self, action: Action) -&gt; None:\n    \"\"\"Add a new action.\"\"\"\n    self._actions.append(action)\n</code></pre>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan.add_actions","title":"<code>add_actions(actions)</code>","text":"<p>Add actions in order.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>def add_actions(self, actions: List[Action]) -&gt; None:\n    \"\"\"Add actions in order.\"\"\"\n    self._actions.extend(actions)\n</code></pre>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan.clear_actions","title":"<code>clear_actions()</code>","text":"<p>Clear all actions.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>def clear_actions(self) -&gt; None:\n    \"\"\"Clear all actions.\"\"\"\n    self._actions = []\n</code></pre>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan.execute","title":"<code>execute()</code>","text":"<p>Execute the actions in the plan.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>def execute(self) -&gt; None:\n    \"\"\"Execute the actions in the plan.\"\"\"\n    for action in self._actions:\n        try:\n            action.execute()\n        except Exception as e:\n            logger.error(f'Failed to execute action {action} for the plan: {e}. Rolling back.')\n            self.rollback()\n            raise e\n</code></pre>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan.get_actions","title":"<code>get_actions()</code>","text":"<p>Get all actions.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>def get_actions(self) -&gt; List[Action]:\n    \"\"\"Get all actions.\"\"\"\n    return self._actions\n</code></pre>"},{"location":"reference/API/trestle/core/models/plans/#trestle.core.models.plans.Plan.rollback","title":"<code>rollback()</code>","text":"<p>Rollback the actions in the plan.</p> Source code in <code>trestle/core/models/plans.py</code> <pre><code>def rollback(self) -&gt; None:\n    \"\"\"Rollback the actions in the plan.\"\"\"\n    # execute in reverse order\n    for action in reversed(self._actions):\n        if action.has_rollback() is False:\n            raise UnsupportedOperation(f'{action.get_type()} does not support rollback')\n        action.rollback()\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/","title":"trestle.core.remote.cache","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache","title":"<code>trestle.core.remote.cache</code>","text":"<p>Trestle cache operations library.</p> <p>Allows for using URI's to reference external directories and then expand.</p>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherBase","title":"<code>FetcherBase</code>","text":"<p>               Bases: <code>ABC</code></p> <p>FetcherBase - base class for caching and fetching remote oscal objects.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>class FetcherBase(ABC):\n    \"\"\"FetcherBase - base class for caching and fetching remote oscal objects.\"\"\"\n\n    def __init__(self, trestle_root: pathlib.Path, uri: str) -&gt; None:\n        \"\"\"Intialize fetcher base.\n\n        Args:\n            trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.\n            uri: Reference to the source object to cache.\n        \"\"\"\n        logger.debug('Initializing FetcherBase')\n        self._cached_object_path: pathlib.Path\n        self._uri = uri\n        self._trestle_root = trestle_root.resolve()\n        self._trestle_cache_path: pathlib.Path = self._trestle_root / const.TRESTLE_CACHE_DIR\n        # ensure trestle cache directory exists.\n        self._trestle_cache_path.mkdir(exist_ok=True)\n        self._expiration_seconds = const.DAY_SECONDS\n\n    @staticmethod\n    def _time_since_modification(file_path: pathlib.Path) -&gt; datetime.timedelta:\n        \"\"\"Get time since last modification.\"\"\"\n        last_modification = datetime.datetime.fromtimestamp(file_path.stat().st_mtime)\n        return datetime.datetime.now() - last_modification\n\n    @abstractmethod\n    def _do_fetch(self) -&gt; None:\n        \"\"\"Fetch the object from a remote source.\"\"\"\n        pass\n\n    def _in_cache(self) -&gt; bool:\n        \"\"\"Return whether object is present in the cache or not.\"\"\"\n        return self._cached_object_path.exists()\n\n    def _is_stale(self) -&gt; bool:\n        # Either cache empty or cached item is too old\n        if not self._in_cache():\n            return True\n        return FetcherBase._time_since_modification(self._cached_object_path\n                                                    ) &gt; datetime.timedelta(seconds=self._expiration_seconds)\n\n    def _update_cache(self, force_update: bool = False) -&gt; bool:\n        \"\"\"Update the cache by fetching the target remote object, if stale or forced.\n\n        Args:\n            force_update: force the fetch regardless of staleness.\n\n        Returns:\n            True if update occurred\n        \"\"\"\n        if self._is_stale() or force_update:\n            try:\n                self._do_fetch()\n                return True\n            except Exception as e:\n                raise TrestleError(\n                    f'Cache update failure for {self._uri}.  Please confirm the file is json and not html: {e}.'\n                ) from e  # noqa E501\n        return False\n\n    def get_raw(self, force_update: bool = False) -&gt; Dict[str, Any]:\n        \"\"\"Retrieve the raw dictionary representing the underlying object.\"\"\"\n        self._update_cache(force_update)\n        # Return results in the cache, whether yaml or json, or whatever is supported by fs.load_file().\n        try:\n            raw_data = file_utils.load_file(self._cached_object_path)\n        except Exception:\n            try:\n                raw_data = file_utils.load_file(self._cached_object_path)\n            except Exception as e:\n                raise TrestleError(f'Cache get failure for {self._uri}: {e}.') from e\n        return raw_data\n\n    def get_oscal_with_model_type(self,\n                                  model_type: Type[OscalBaseModel],\n                                  force_update: bool = False) -&gt; Optional[OscalBaseModel]:\n        \"\"\"Retrieve the cached file as a particular OSCAL model.\n\n        Arguments:\n            model_type: Type[OscalBaseModel] Specifies the OSCAL model type of the fetched object.\n        \"\"\"\n        self._update_cache(force_update)\n        cache_file = self._cached_object_path\n        if not cache_file.exists():\n            raise TrestleError(f'get_oscal failure for {self._uri}')\n\n        try:\n            return model_type.oscal_read(cache_file)\n        except Exception as e:\n            logger.debug(f'get_oscal failed, error loading cache file for {self._uri} as {model_type}')\n            raise TrestleError(f'get_oscal failure for {self._uri}: {e}.') from e\n\n    def get_oscal(self, force_update: bool = False) -&gt; Tuple[OscalBaseModel, str]:\n        \"\"\"Retrieve the cached file and model name without knowing its model type.\"\"\"\n        model_dict = self.get_raw(force_update)\n        root_key = parser.root_key(model_dict)\n        model_name = parser.to_full_model_name(root_key)\n        if model_name is None:\n            raise TrestleError(f'Failed cache read of non top level model with root_key {root_key}')\n        return parser.parse_dict(model_dict[root_key], model_name), root_key\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherBase-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherBase.__init__","title":"<code>__init__(trestle_root, uri)</code>","text":"<p>Intialize fetcher base.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>Path of the trestle workspace, i.e., within which .trestle is to be found.</p> required <code>uri</code> <code>str</code> <p>Reference to the source object to cache.</p> required Source code in <code>trestle/core/remote/cache.py</code> <pre><code>def __init__(self, trestle_root: pathlib.Path, uri: str) -&gt; None:\n    \"\"\"Intialize fetcher base.\n\n    Args:\n        trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.\n        uri: Reference to the source object to cache.\n    \"\"\"\n    logger.debug('Initializing FetcherBase')\n    self._cached_object_path: pathlib.Path\n    self._uri = uri\n    self._trestle_root = trestle_root.resolve()\n    self._trestle_cache_path: pathlib.Path = self._trestle_root / const.TRESTLE_CACHE_DIR\n    # ensure trestle cache directory exists.\n    self._trestle_cache_path.mkdir(exist_ok=True)\n    self._expiration_seconds = const.DAY_SECONDS\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherBase.get_oscal","title":"<code>get_oscal(force_update=False)</code>","text":"<p>Retrieve the cached file and model name without knowing its model type.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>def get_oscal(self, force_update: bool = False) -&gt; Tuple[OscalBaseModel, str]:\n    \"\"\"Retrieve the cached file and model name without knowing its model type.\"\"\"\n    model_dict = self.get_raw(force_update)\n    root_key = parser.root_key(model_dict)\n    model_name = parser.to_full_model_name(root_key)\n    if model_name is None:\n        raise TrestleError(f'Failed cache read of non top level model with root_key {root_key}')\n    return parser.parse_dict(model_dict[root_key], model_name), root_key\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherBase.get_oscal_with_model_type","title":"<code>get_oscal_with_model_type(model_type, force_update=False)</code>","text":"<p>Retrieve the cached file as a particular OSCAL model.</p> <p>Parameters:</p> Name Type Description Default <code>model_type</code> <code>Type[OscalBaseModel]</code> <p>Type[OscalBaseModel] Specifies the OSCAL model type of the fetched object.</p> required Source code in <code>trestle/core/remote/cache.py</code> <pre><code>def get_oscal_with_model_type(self,\n                              model_type: Type[OscalBaseModel],\n                              force_update: bool = False) -&gt; Optional[OscalBaseModel]:\n    \"\"\"Retrieve the cached file as a particular OSCAL model.\n\n    Arguments:\n        model_type: Type[OscalBaseModel] Specifies the OSCAL model type of the fetched object.\n    \"\"\"\n    self._update_cache(force_update)\n    cache_file = self._cached_object_path\n    if not cache_file.exists():\n        raise TrestleError(f'get_oscal failure for {self._uri}')\n\n    try:\n        return model_type.oscal_read(cache_file)\n    except Exception as e:\n        logger.debug(f'get_oscal failed, error loading cache file for {self._uri} as {model_type}')\n        raise TrestleError(f'get_oscal failure for {self._uri}: {e}.') from e\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherBase.get_raw","title":"<code>get_raw(force_update=False)</code>","text":"<p>Retrieve the raw dictionary representing the underlying object.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>def get_raw(self, force_update: bool = False) -&gt; Dict[str, Any]:\n    \"\"\"Retrieve the raw dictionary representing the underlying object.\"\"\"\n    self._update_cache(force_update)\n    # Return results in the cache, whether yaml or json, or whatever is supported by fs.load_file().\n    try:\n        raw_data = file_utils.load_file(self._cached_object_path)\n    except Exception:\n        try:\n            raw_data = file_utils.load_file(self._cached_object_path)\n        except Exception as e:\n            raise TrestleError(f'Cache get failure for {self._uri}: {e}.') from e\n    return raw_data\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherFactory","title":"<code>FetcherFactory</code>","text":"<p>Factory method for creating a fetcher.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>class FetcherFactory:\n    \"\"\"Factory method for creating a fetcher.\"\"\"\n\n    class UriType(Enum):\n        \"\"\"Specify types of URI.\"\"\"\n\n        LOCAL_FILE = 1\n\n        SFTP = 2\n\n        HTTPS = 3\n\n        TRESTLE = 4\n\n    @staticmethod\n    def uri_type_is_not_local(uri_type: UriType) -&gt; bool:\n        \"\"\"Determine if the uri type is not local.\"\"\"\n        return uri_type in [FetcherFactory.UriType.SFTP, FetcherFactory.UriType.HTTPS]\n\n    @staticmethod\n    def get_uri_type(uri: str) -&gt; UriType:\n        \"\"\"Determine the type of uri.\"\"\"\n        if uri.startswith(const.SFTP_URI):\n            return FetcherFactory.UriType.SFTP\n        if uri.startswith(const.HTTPS_URI):\n            return FetcherFactory.UriType.HTTPS\n        if uri.startswith(const.TRESTLE_HREF_HEADING):\n            return FetcherFactory.UriType.TRESTLE\n        # if we land here, assume it is a local file and may have relative path\n        # but it at least needs a filename with suffix\n        # the most minimal allowed uri is of the form a.yml\n        uri_clean = uri.strip()\n        if uri_clean.startswith('ftp:'):\n            raise TrestleError(f'Invalid uri {uri}  ftp is not supported.  Use sftp instead.')\n        uri_len = len(uri_clean)\n        # at least 5 chars and ending with dot followed by at least 3 chars\n        if uri_len &gt; 4 and 0 &lt; uri_clean.rfind('.') &lt; uri_len - 3:\n            return FetcherFactory.UriType.LOCAL_FILE\n        raise TrestleError(f'Invalid uri not recognized as a readable file path with extension: {uri}')\n\n    @staticmethod\n    def in_trestle_directory(trestle_root: pathlib.Path, uri: str) -&gt; bool:\n        \"\"\"Check if in trestle directory when uri may not be a file path.\"\"\"\n        uri_type = FetcherFactory.get_uri_type(uri)\n        if uri_type == FetcherFactory.UriType.TRESTLE:\n            return True\n        if uri_type != FetcherFactory.UriType.LOCAL_FILE:\n            return False\n        try:\n            pathlib.Path(uri).resolve().relative_to(str(trestle_root.resolve()))\n        except Exception:\n            return False\n        return True\n\n    @classmethod\n    def get_fetcher(cls, trestle_root: pathlib.Path, uri: str) -&gt; Union[LocalFetcher, SFTPFetcher, HTTPSFetcher]:\n        \"\"\"Return an instantiated fetcher object based on the type of URI.\n\n        Args:\n            trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.\n            uri: Reference to the remote object to cache.\n\n        Returns:\n            fetcher object for the given URI.\n        \"\"\"\n        fetcher_dict = {\n            FetcherFactory.UriType.LOCAL_FILE: LocalFetcher,\n            FetcherFactory.UriType.SFTP: SFTPFetcher,\n            FetcherFactory.UriType.HTTPS: HTTPSFetcher,\n            FetcherFactory.UriType.TRESTLE: LocalFetcher,\n        }\n        uri_type = cls.get_uri_type(uri)\n        return fetcher_dict[uri_type](trestle_root, uri)  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherFactory-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherFactory.UriType","title":"<code>UriType</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Specify types of URI.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>class UriType(Enum):\n    \"\"\"Specify types of URI.\"\"\"\n\n    LOCAL_FILE = 1\n\n    SFTP = 2\n\n    HTTPS = 3\n\n    TRESTLE = 4\n</code></pre> Attributes\u00a4 <code>HTTPS = 3</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4 <code>LOCAL_FILE = 1</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4 <code>SFTP = 2</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4 <code>TRESTLE = 4</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherFactory-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherFactory.get_fetcher","title":"<code>get_fetcher(trestle_root, uri)</code>  <code>classmethod</code>","text":"<p>Return an instantiated fetcher object based on the type of URI.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>Path of the trestle workspace, i.e., within which .trestle is to be found.</p> required <code>uri</code> <code>str</code> <p>Reference to the remote object to cache.</p> required <p>Returns:</p> Type Description <code>Union[LocalFetcher, SFTPFetcher, HTTPSFetcher]</code> <p>fetcher object for the given URI.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>@classmethod\ndef get_fetcher(cls, trestle_root: pathlib.Path, uri: str) -&gt; Union[LocalFetcher, SFTPFetcher, HTTPSFetcher]:\n    \"\"\"Return an instantiated fetcher object based on the type of URI.\n\n    Args:\n        trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.\n        uri: Reference to the remote object to cache.\n\n    Returns:\n        fetcher object for the given URI.\n    \"\"\"\n    fetcher_dict = {\n        FetcherFactory.UriType.LOCAL_FILE: LocalFetcher,\n        FetcherFactory.UriType.SFTP: SFTPFetcher,\n        FetcherFactory.UriType.HTTPS: HTTPSFetcher,\n        FetcherFactory.UriType.TRESTLE: LocalFetcher,\n    }\n    uri_type = cls.get_uri_type(uri)\n    return fetcher_dict[uri_type](trestle_root, uri)  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherFactory.get_uri_type","title":"<code>get_uri_type(uri)</code>  <code>staticmethod</code>","text":"<p>Determine the type of uri.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>@staticmethod\ndef get_uri_type(uri: str) -&gt; UriType:\n    \"\"\"Determine the type of uri.\"\"\"\n    if uri.startswith(const.SFTP_URI):\n        return FetcherFactory.UriType.SFTP\n    if uri.startswith(const.HTTPS_URI):\n        return FetcherFactory.UriType.HTTPS\n    if uri.startswith(const.TRESTLE_HREF_HEADING):\n        return FetcherFactory.UriType.TRESTLE\n    # if we land here, assume it is a local file and may have relative path\n    # but it at least needs a filename with suffix\n    # the most minimal allowed uri is of the form a.yml\n    uri_clean = uri.strip()\n    if uri_clean.startswith('ftp:'):\n        raise TrestleError(f'Invalid uri {uri}  ftp is not supported.  Use sftp instead.')\n    uri_len = len(uri_clean)\n    # at least 5 chars and ending with dot followed by at least 3 chars\n    if uri_len &gt; 4 and 0 &lt; uri_clean.rfind('.') &lt; uri_len - 3:\n        return FetcherFactory.UriType.LOCAL_FILE\n    raise TrestleError(f'Invalid uri not recognized as a readable file path with extension: {uri}')\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherFactory.in_trestle_directory","title":"<code>in_trestle_directory(trestle_root, uri)</code>  <code>staticmethod</code>","text":"<p>Check if in trestle directory when uri may not be a file path.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>@staticmethod\ndef in_trestle_directory(trestle_root: pathlib.Path, uri: str) -&gt; bool:\n    \"\"\"Check if in trestle directory when uri may not be a file path.\"\"\"\n    uri_type = FetcherFactory.get_uri_type(uri)\n    if uri_type == FetcherFactory.UriType.TRESTLE:\n        return True\n    if uri_type != FetcherFactory.UriType.LOCAL_FILE:\n        return False\n    try:\n        pathlib.Path(uri).resolve().relative_to(str(trestle_root.resolve()))\n    except Exception:\n        return False\n    return True\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.FetcherFactory.uri_type_is_not_local","title":"<code>uri_type_is_not_local(uri_type)</code>  <code>staticmethod</code>","text":"<p>Determine if the uri type is not local.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>@staticmethod\ndef uri_type_is_not_local(uri_type: UriType) -&gt; bool:\n    \"\"\"Determine if the uri type is not local.\"\"\"\n    return uri_type in [FetcherFactory.UriType.SFTP, FetcherFactory.UriType.HTTPS]\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.HTTPSFetcher","title":"<code>HTTPSFetcher</code>","text":"<p>               Bases: <code>FetcherBase</code></p> <p>Fetcher for https content.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>class HTTPSFetcher(FetcherBase):\n    \"\"\"Fetcher for https content.\"\"\"\n\n    # Use request: https://requests.readthedocs.io/en/master/\n    def __init__(self, trestle_root: pathlib.Path, uri: str) -&gt; None:\n        \"\"\"Initialize HTTPS fetcher.\"\"\"\n        logger.debug('Initializing HTTPSFetcher')\n        super().__init__(trestle_root, uri)\n        self._username = None\n        self._password = None\n        u = parse.urlparse(self._uri)\n        self._url = uri\n        # If the either the username or password is omitted in the URI, then the other becomes ''\n        # so we test for either None or ''.\n        if u.username != '' and u.username is not None:\n            # This also checks for invalid environment variable name (IEEE 1003.1)\n            if not re.match('{{[a-zA-Z_][a-zA-Z0-9_]*}}', u.username) or u.username == '{{_}}':\n                raise TrestleError(\n                    'Cache request for invalid input URI: '\n                    f'username must refer to an environment variable using moustache {self._uri}'\n                )\n            username_var = u.username[2:-2]\n            if username_var not in os.environ:\n                raise TrestleError(\n                    f'Cache request for invalid input URI: username not found in the environment {self._uri}'\n                )\n            self._username = os.environ[username_var]\n        if u.password != '' and u.password is not None:  # noqa S105\n            if not re.match('{{[a-zA-Z_][a-zA-Z0-9_]*}}', u.password) or u.password == '{{_}}':  # noqa S105\n                raise TrestleError(\n                    'Cache request for invalid input URI: '\n                    f'password must refer to an environment variable using moustache {self._uri}'\n                )\n            password_var = u.password[2:-2]\n            if password_var not in os.environ:\n                raise TrestleError(\n                    'Cache request for invalid input URI: '\n                    f'password not found in the environment {self._uri}'\n                )\n            self._password = os.environ[password_var]\n        if self._username and (self._password == '' or self._password is None):  # noqa S105\n            raise TrestleError(\n                f'Cache request for invalid input URI: username found '\n                f'but password not found via environment variable {self._uri}'\n            )\n        if self._password and not self._username:\n            raise TrestleError(\n                f'Cache request for invalid input URI: password found '\n                f'but username not found via environment variable {self._uri}'\n            )\n        if u.hostname is None:\n            raise TrestleError(f'Cache request for {self._uri} requires hostname')\n        https_cached_dir = self._trestle_cache_path / u.hostname\n        # Skip any number of back- or forward slashes preceding the URI path (u.path)\n        path_parent = pathlib.Path(u.path[re.search('[^/\\\\\\\\]', u.path).span()[0]:]).parent\n        https_cached_dir = https_cached_dir / path_parent\n        https_cached_dir.mkdir(parents=True, exist_ok=True)\n        self._cached_object_path = https_cached_dir / pathlib.Path(pathlib.Path(u.path).name)\n\n    def _do_fetch(self) -&gt; None:\n        auth = None\n        verify = None\n        # This order reflects requests library behavior: REQUESTS_CA_BUNDLE comes first.\n        for env_var_name in ['REQUESTS_CA_BUNDLE', 'CURL_CA_BUNDLE']:\n            if env_var_name in os.environ:\n                if pathlib.Path(os.environ[env_var_name]).exists():\n                    verify = os.environ[env_var_name]\n                    break\n                else:\n                    err_str = f'Env var ${env_var_name} found but path does not exist: {os.environ[env_var_name]}'\n                    logger.warning(err_str)\n                    raise TrestleError(f'Cache update failure with bad inputenv var: {err_str}')\n        if self._username is not None and self._password is not None:\n            auth = HTTPBasicAuth(self._username, self._password)\n\n        try:\n            response = requests.get(self._url, auth=auth, verify=verify, timeout=30)\n        except Exception as e:\n            raise TrestleError(f'Cache update failure to connect via HTTPS: {self._url} ({e})')\n\n        if response.status_code == 200:\n            try:\n                result = response.text\n            except Exception as err:\n                raise TrestleError(f'Cache update failure reading response via HTTPS: {self._url} ({err})')\n            else:\n                self._cached_object_path.write_text(result, encoding=const.FILE_ENCODING)\n        else:\n            raise TrestleError(f'GET returned code {response.status_code}: {self._uri}')\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.HTTPSFetcher-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.HTTPSFetcher.__init__","title":"<code>__init__(trestle_root, uri)</code>","text":"<p>Initialize HTTPS fetcher.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>def __init__(self, trestle_root: pathlib.Path, uri: str) -&gt; None:\n    \"\"\"Initialize HTTPS fetcher.\"\"\"\n    logger.debug('Initializing HTTPSFetcher')\n    super().__init__(trestle_root, uri)\n    self._username = None\n    self._password = None\n    u = parse.urlparse(self._uri)\n    self._url = uri\n    # If the either the username or password is omitted in the URI, then the other becomes ''\n    # so we test for either None or ''.\n    if u.username != '' and u.username is not None:\n        # This also checks for invalid environment variable name (IEEE 1003.1)\n        if not re.match('{{[a-zA-Z_][a-zA-Z0-9_]*}}', u.username) or u.username == '{{_}}':\n            raise TrestleError(\n                'Cache request for invalid input URI: '\n                f'username must refer to an environment variable using moustache {self._uri}'\n            )\n        username_var = u.username[2:-2]\n        if username_var not in os.environ:\n            raise TrestleError(\n                f'Cache request for invalid input URI: username not found in the environment {self._uri}'\n            )\n        self._username = os.environ[username_var]\n    if u.password != '' and u.password is not None:  # noqa S105\n        if not re.match('{{[a-zA-Z_][a-zA-Z0-9_]*}}', u.password) or u.password == '{{_}}':  # noqa S105\n            raise TrestleError(\n                'Cache request for invalid input URI: '\n                f'password must refer to an environment variable using moustache {self._uri}'\n            )\n        password_var = u.password[2:-2]\n        if password_var not in os.environ:\n            raise TrestleError(\n                'Cache request for invalid input URI: '\n                f'password not found in the environment {self._uri}'\n            )\n        self._password = os.environ[password_var]\n    if self._username and (self._password == '' or self._password is None):  # noqa S105\n        raise TrestleError(\n            f'Cache request for invalid input URI: username found '\n            f'but password not found via environment variable {self._uri}'\n        )\n    if self._password and not self._username:\n        raise TrestleError(\n            f'Cache request for invalid input URI: password found '\n            f'but username not found via environment variable {self._uri}'\n        )\n    if u.hostname is None:\n        raise TrestleError(f'Cache request for {self._uri} requires hostname')\n    https_cached_dir = self._trestle_cache_path / u.hostname\n    # Skip any number of back- or forward slashes preceding the URI path (u.path)\n    path_parent = pathlib.Path(u.path[re.search('[^/\\\\\\\\]', u.path).span()[0]:]).parent\n    https_cached_dir = https_cached_dir / path_parent\n    https_cached_dir.mkdir(parents=True, exist_ok=True)\n    self._cached_object_path = https_cached_dir / pathlib.Path(pathlib.Path(u.path).name)\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.LocalFetcher","title":"<code>LocalFetcher</code>","text":"<p>               Bases: <code>FetcherBase</code></p> <p>Fetcher for local content.</p> <p>Used for both file:/// and C:\\ or C:/ type paths, but the path must be absolute. Also used for trestle:// files present in the current trestle root.</p> <p>If file:/// is used on a Windows system, it must be followed by C:/ or other drive letter to be sure it is an absolute path, e.g. file:///C:/Users/Default/Documents/profile.json. The drive letter may be lowercase. LocalFetcher does not do any caching and assumes the file is quickly accessible.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>class LocalFetcher(FetcherBase):\n    r\"\"\"Fetcher for local content.\n\n    Used for both file:/// and C:\\\\ or C:/ type paths, but the path must be absolute.\n    Also used for trestle:// files present in the current trestle root.\n\n    If file:/// is used on a Windows system, it must be followed by C:/ or other drive letter\n    to be sure it is an absolute path, e.g. file:///C:/Users/Default/Documents/profile.json.\n    The drive letter may be lowercase.\n    LocalFetcher does not do any caching and assumes the file is quickly accessible.\n    \"\"\"\n\n    def __init__(self, trestle_root: pathlib.Path, uri: str) -&gt; None:\n        \"\"\"Initialize local fetcher.\n\n        Args:\n            trestle_root: trestle root path\n            uri: Reference to the file in the local filesystem to cache, which must be outside trestle_root.\n        \"\"\"\n        super().__init__(trestle_root, uri)\n\n        # Handle as file:/// form\n        if uri.startswith(const.FILE_URI):\n            # strip off entire header including /\n            uri = uri[len(const.FILE_URI):]\n\n            # if it has a drive letter don't add / to front\n            uri = uri if re.match(const.WINDOWS_DRIVE_LETTER_REGEX, uri) else '/' + uri\n        elif uri.startswith(const.TRESTLE_HREF_HEADING):\n            uri = str(trestle_root / uri[len(const.TRESTLE_HREF_HEADING):])\n            self._abs_path = pathlib.Path(uri).resolve()\n            self._cached_object_path = self._abs_path\n            return\n\n        # now the URI should be either unix / style or windows C:/ style.  It may be relative.\n\n        if ':' in uri and platform.system() != const.WINDOWS_PLATFORM_STR:\n            raise TrestleError(f'Cannot have : in uri on non-Windows system unless ftps, https or trestle: {uri}')\n\n        # if it has a drive letter but no / after it, it is not absolute\n        if re.match(const.WINDOWS_DRIVE_LETTER_REGEX, uri):\n            if platform.system() != const.WINDOWS_PLATFORM_STR:\n                raise TrestleError(f'Cannot cache Windows paths on non-Windows system. {uri}')\n\n        # store the abs path to the file for fetching\n        # if this is a windows file it will have a drive letter at start after resolve\n        try:\n            self._abs_path = pathlib.Path(uri).resolve()\n        except Exception:\n            raise TrestleError(f'The uri provided is invalid or unresolvable as a file path: {uri}')\n\n        # set the cached path to be the actual file path\n        self._cached_object_path = self._abs_path\n\n    def _is_stale(self) -&gt; bool:\n        # Local file is always stale.\n        return True\n\n    def _do_fetch(self) -&gt; None:\n        \"\"\"No need to fetch since using actual file path.\"\"\"\n        pass\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.LocalFetcher-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.LocalFetcher.__init__","title":"<code>__init__(trestle_root, uri)</code>","text":"<p>Initialize local fetcher.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>trestle root path</p> required <code>uri</code> <code>str</code> <p>Reference to the file in the local filesystem to cache, which must be outside trestle_root.</p> required Source code in <code>trestle/core/remote/cache.py</code> <pre><code>def __init__(self, trestle_root: pathlib.Path, uri: str) -&gt; None:\n    \"\"\"Initialize local fetcher.\n\n    Args:\n        trestle_root: trestle root path\n        uri: Reference to the file in the local filesystem to cache, which must be outside trestle_root.\n    \"\"\"\n    super().__init__(trestle_root, uri)\n\n    # Handle as file:/// form\n    if uri.startswith(const.FILE_URI):\n        # strip off entire header including /\n        uri = uri[len(const.FILE_URI):]\n\n        # if it has a drive letter don't add / to front\n        uri = uri if re.match(const.WINDOWS_DRIVE_LETTER_REGEX, uri) else '/' + uri\n    elif uri.startswith(const.TRESTLE_HREF_HEADING):\n        uri = str(trestle_root / uri[len(const.TRESTLE_HREF_HEADING):])\n        self._abs_path = pathlib.Path(uri).resolve()\n        self._cached_object_path = self._abs_path\n        return\n\n    # now the URI should be either unix / style or windows C:/ style.  It may be relative.\n\n    if ':' in uri and platform.system() != const.WINDOWS_PLATFORM_STR:\n        raise TrestleError(f'Cannot have : in uri on non-Windows system unless ftps, https or trestle: {uri}')\n\n    # if it has a drive letter but no / after it, it is not absolute\n    if re.match(const.WINDOWS_DRIVE_LETTER_REGEX, uri):\n        if platform.system() != const.WINDOWS_PLATFORM_STR:\n            raise TrestleError(f'Cannot cache Windows paths on non-Windows system. {uri}')\n\n    # store the abs path to the file for fetching\n    # if this is a windows file it will have a drive letter at start after resolve\n    try:\n        self._abs_path = pathlib.Path(uri).resolve()\n    except Exception:\n        raise TrestleError(f'The uri provided is invalid or unresolvable as a file path: {uri}')\n\n    # set the cached path to be the actual file path\n    self._cached_object_path = self._abs_path\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.SFTPFetcher","title":"<code>SFTPFetcher</code>","text":"<p>               Bases: <code>FetcherBase</code></p> <p>Fetcher for SFTP content.</p> Source code in <code>trestle/core/remote/cache.py</code> <pre><code>class SFTPFetcher(FetcherBase):\n    \"\"\"Fetcher for SFTP content.\"\"\"\n\n    def __init__(self, trestle_root: pathlib.Path, uri: str) -&gt; None:\n        \"\"\"Initialize SFTP fetcher. Update the expected cache path as per caching specs.\n\n        Args:\n            trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.\n            uri: Reference to the remote file to cache that can be fetched using the sftp:// scheme.\n        \"\"\"\n        logger.debug(f'initialize SFTPFetcher for uri {uri}')\n        super().__init__(trestle_root, uri)\n        # Is this a valid URI, however? Username and password are optional, of course.\n        try:\n            u = parse.urlparse(self._uri)\n        except Exception as e:\n            logger.warning(f'SFTP fetcher unable to parse uri {self._uri} error {e}')\n            raise TrestleError(f'Unable to parse malformed url {self._uri} error {e}')\n        logger.debug(f'SFTP fetcher with parsed uri {u}')\n        if not u.hostname:\n            logger.debug('SFTP fetcher uri missing hostname')\n            logger.warning(f'Malformed URI, cannot parse hostname in URL {self._uri}')\n            raise TrestleError(f'Cache request for invalid input URI: missing hostname {self._uri}')\n        if not u.path:\n            logger.debug('SFTP fetcher uri missing path')\n            logger.warning(f'Malformed URI, cannot parse path in URL {self._uri}')\n            raise TrestleError(f'Cache request for invalid input URI: missing file path {self._uri}')\n\n        sftp_cached_dir = self._trestle_cache_path / u.hostname\n        # Skip any number of back- or forward slashes preceding the URL path (u.path)\n        path_parent = pathlib.Path(u.path[re.search('[^/\\\\\\\\]', u.path).span()[0]:]).parent\n        sftp_cached_dir = sftp_cached_dir / path_parent\n        sftp_cached_dir.mkdir(parents=True, exist_ok=True)\n        self._cached_object_path = sftp_cached_dir / pathlib.Path(pathlib.Path(u.path).name)\n\n    def _do_fetch(self) -&gt; None:\n        \"\"\"Fetch remote object and update the cache if appropriate and possible to do so.\n\n        Authentication relies on the user's private key being either active via ssh-agent or\n        supplied via environment variable SSH_KEY. In the latter case, it must not require a passphrase prompt.\n        \"\"\"\n        u = parse.urlparse(self._uri)\n        client = paramiko.SSHClient()\n        # Must pick up host keys from the default known_hosts on this environment:\n        try:\n            client.load_system_host_keys()\n        except Exception as e:\n            raise TrestleError(f'Cache update failure for {self._uri}: {e}.')\n        # Use the supplied private key file if given, or look for keys in default path.\n        if 'SSH_KEY' in os.environ:\n            pkey = paramiko.RSAKey.from_private_key(StringIO(os.environ['SSH_KEY']))\n            look_for_keys = False\n        else:\n            pkey = None\n            look_for_keys = True\n\n        username = getpass.getuser() if not u.username else u.username\n        try:\n            client.connect(\n                u.hostname,\n                username=username,\n                password=u.password,\n                pkey=pkey,\n                look_for_keys=look_for_keys,\n                port=22 if not u.port else u.port,\n            )\n        except Exception as e:\n            raise TrestleError(f'Cache update failure to connect via SSH: {u.hostname}: {e}.')\n\n        try:\n            sftp_client = client.open_sftp()\n        except Exception as e:\n            raise TrestleError(f'Cache update failure to open sftp for {u.hostname}: {e}.')\n\n        localpath = self._cached_object_path\n        try:\n            sftp_client.get(remotepath=u.path[1:], localpath=(localpath.__str__()))\n        except Exception as e:\n            raise TrestleError(f'Error getting remote resource {self._uri} into cache {localpath}: {e}')\n</code></pre>"},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.SFTPFetcher-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/remote/cache/#trestle.core.remote.cache.SFTPFetcher.__init__","title":"<code>__init__(trestle_root, uri)</code>","text":"<p>Initialize SFTP fetcher. Update the expected cache path as per caching specs.</p> <p>Parameters:</p> Name Type Description Default <code>trestle_root</code> <code>Path</code> <p>Path of the trestle workspace, i.e., within which .trestle is to be found.</p> required <code>uri</code> <code>str</code> <p>Reference to the remote file to cache that can be fetched using the sftp:// scheme.</p> required Source code in <code>trestle/core/remote/cache.py</code> <pre><code>def __init__(self, trestle_root: pathlib.Path, uri: str) -&gt; None:\n    \"\"\"Initialize SFTP fetcher. Update the expected cache path as per caching specs.\n\n    Args:\n        trestle_root: Path of the trestle workspace, i.e., within which .trestle is to be found.\n        uri: Reference to the remote file to cache that can be fetched using the sftp:// scheme.\n    \"\"\"\n    logger.debug(f'initialize SFTPFetcher for uri {uri}')\n    super().__init__(trestle_root, uri)\n    # Is this a valid URI, however? Username and password are optional, of course.\n    try:\n        u = parse.urlparse(self._uri)\n    except Exception as e:\n        logger.warning(f'SFTP fetcher unable to parse uri {self._uri} error {e}')\n        raise TrestleError(f'Unable to parse malformed url {self._uri} error {e}')\n    logger.debug(f'SFTP fetcher with parsed uri {u}')\n    if not u.hostname:\n        logger.debug('SFTP fetcher uri missing hostname')\n        logger.warning(f'Malformed URI, cannot parse hostname in URL {self._uri}')\n        raise TrestleError(f'Cache request for invalid input URI: missing hostname {self._uri}')\n    if not u.path:\n        logger.debug('SFTP fetcher uri missing path')\n        logger.warning(f'Malformed URI, cannot parse path in URL {self._uri}')\n        raise TrestleError(f'Cache request for invalid input URI: missing file path {self._uri}')\n\n    sftp_cached_dir = self._trestle_cache_path / u.hostname\n    # Skip any number of back- or forward slashes preceding the URL path (u.path)\n    path_parent = pathlib.Path(u.path[re.search('[^/\\\\\\\\]', u.path).span()[0]:]).parent\n    sftp_cached_dir = sftp_cached_dir / path_parent\n    sftp_cached_dir.mkdir(parents=True, exist_ok=True)\n    self._cached_object_path = sftp_cached_dir / pathlib.Path(pathlib.Path(u.path).name)\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/merge/","title":"trestle.core.resolver.merge","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge","title":"<code>trestle.core.resolver.merge</code>","text":"<p>Create resolved catalog from profile.</p>"},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.CATALOG_EXCLUDE","title":"<code>CATALOG_EXCLUDE = ['uuid', 'metadata', 'back_matter']</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.CONTROL_EXCLUDE","title":"<code>CONTROL_EXCLUDE = [ID]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.ID","title":"<code>ID = 'id'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.ITEM_EXCLUDE_MAP","title":"<code>ITEM_EXCLUDE_MAP = {'Part': PART_EXCLUDE, 'Property': PROPERTY_EXCLUDE, 'Parameter': PARAMETER_EXCLUDE, 'Control': CONTROL_EXCLUDE, 'Catalog': CATALOG_EXCLUDE}</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.NAME","title":"<code>NAME = 'name'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.PARAMETER_EXCLUDE","title":"<code>PARAMETER_EXCLUDE = [ID]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.PART_EXCLUDE","title":"<code>PART_EXCLUDE = [NAME]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.PROPERTY_EXCLUDE","title":"<code>PROPERTY_EXCLUDE = [NAME]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.Merge","title":"<code>Merge</code>","text":"<p>               Bases: <code>Filter</code></p> <p>Merge the incoming catalogs according to rules in the profile.</p> <p>The incoming catalogs have already been pruned based on the import. Now the controls must be gathered, merged, and grouped based on the merge settings.</p> Source code in <code>trestle/core/resolver/merge.py</code> <pre><code>class Merge(Pipeline.Filter):\n    \"\"\"\n    Merge the incoming catalogs according to rules in the profile.\n\n    The incoming catalogs have already been pruned based on the import.\n    Now the controls must be gathered, merged, and grouped based on the merge settings.\n    \"\"\"\n\n    def __init__(self, profile: prof.Profile) -&gt; None:\n        \"\"\"Initialize the class with the profile.\"\"\"\n        logger.debug('merge filter initialize')\n        self._profile = profile\n\n    def _get_id(self, item: OBT) -&gt; Optional[str]:\n        id_ = getattr(item, ID, None)\n        if id_ is None:\n            id_ = getattr(item, NAME, None)\n        return id_\n\n    def _item_genertor(self, dest: List[OBT], src: List[OBT], merge_method: Optional[str]) -&gt; Iterator[OBT]:\n        if merge_method == prof.CombinationMethodValidValues.keep.value:\n            dest.extend(src)\n        else:\n            for item in src:\n                # if there is an exact copy of this in dest then ignore it\n                if item not in dest:\n                    yield item\n\n    def _merge_item(self, item: OBT, dest: List[OBT], merge_method: Optional[str]) -&gt; bool:\n        merged = False\n        item_id = self._get_id(item)\n        if item_id is not None:\n            for other in dest:\n                other_id = self._get_id(other)\n                if other_id != item_id:\n                    continue\n                if merge_method == prof.CombinationMethodValidValues.merge.value:\n                    self._merge_items(other, item, merge_method)\n                merged = True\n                break\n        return merged\n\n    def _merge_lists(self, dest: List[OBT], src: List[OBT], merge_method: Optional[str]) -&gt; None:\n        added_items = []\n        if merge_method == prof.CombinationMethodValidValues.keep.value:\n            dest.extend(src)\n            return\n        for item in self._item_genertor(dest, src, merge_method):\n            merged = self._merge_item(item, dest, merge_method)\n            # it isn't already in dest and no match was found for merge, so append\n            if not merged:\n                added_items.append(item)\n        dest.extend(added_items)\n\n    def _merge_attrs(\n        self, dest: Union[OBT, List[OBT]], src: Union[OBT, List[OBT]], attr: str, merge_method: Optional[str]\n    ) -&gt; None:\n        \"\"\"Merge this attr of src into the attr of dest.\"\"\"\n        src_attr = getattr(src, attr, None)\n        if src_attr is None:\n            return\n        item_type = type(src).__name__\n        if attr in ITEM_EXCLUDE_MAP.get(item_type, []):\n            return\n        dest_attr = getattr(dest, attr, None)\n        if dest_attr and isinstance(dest_attr, list):\n            self._merge_lists(dest_attr, src_attr, merge_method)\n            setattr(dest, attr, dest_attr)\n            return\n        if dest_attr and merge_method == prof.CombinationMethodValidValues.use_first.value:\n            return\n        if dest_attr == src_attr and merge_method not in [None, prof.CombinationMethodValidValues.keep.value]:\n            return\n        setattr(dest, attr, src_attr)\n\n    def _merge_items(self, dest: OBT, src: OBT, merge_method: Optional[str]) -&gt; None:\n        \"\"\"Merge two items recursively.\"\"\"\n        for field in src.__fields_set__:\n            self._merge_attrs(dest, src, field, merge_method)\n\n    def _group_contents(self, group: cat.Group) -&gt; Tuple[List[cat.Control], List[com.Parameter]]:\n        \"\"\"Get flattened content of group and its groups recursively.\"\"\"\n        controls = []\n        params = []\n        controls.extend(as_list(group.controls))\n        params.extend(as_list(group.params))\n        if group.groups is not None:\n            for sub_group in group.groups:\n                new_controls, new_params = self._group_contents(sub_group)\n                controls.extend(new_controls)\n                params.extend(new_params)\n        return controls, params\n\n    def _flatten_catalog(self, catalog: cat.Catalog, as_is: bool) -&gt; cat.Catalog:\n        \"\"\"Flatten the groups of the catalog if as_is is False.\"\"\"\n        if as_is or catalog.groups is None:\n            return catalog\n\n        # as_is is False so flatten the controls into a single list\n        catalog.controls = as_list(catalog.controls)\n        catalog.params = as_list(catalog.params)\n        for group in catalog.groups:\n            new_controls, new_params = self._group_contents(group)\n            catalog.controls.extend(new_controls)\n            catalog.params.extend(new_params)\n        catalog.controls = none_if_empty(catalog.controls)\n        catalog.params = none_if_empty(catalog.params)\n        catalog.groups = None\n        return catalog\n\n    def _merge_two_catalogs(\n        self, dest: cat.Catalog, src: cat.Catalog, merge_method: Optional[str], as_is: bool\n    ) -&gt; cat.Catalog:\n        # merge_method is use_first, merge, keep\n        # no combine or merge_method equates to merge_method=keep\n        # if as_is is false, the result is flattened\n\n        dest = self._flatten_catalog(dest, as_is)\n        src = self._flatten_catalog(src, as_is)\n\n        self._merge_items(dest, src, merge_method)\n\n        return dest\n\n    def _merge_catalog(self, merged: Optional[cat.Catalog], catalog: cat.Catalog) -&gt; cat.Catalog:\n        \"\"\"Merge the controls in the catalog into merged catalog.\"\"\"\n        # no merge means keep, including dups\n        # same for merge with no combine\n        # groups are merged only if separate directive such as as-is is given\n        # use-first is a merge combination rule\n        # merge is a merge combination rule for controls.  groups are not merged by this rule\n        # merge/as-is and merge/custom are used for merging groups\n        # if neither as-is nor custom is specified - just get single list of controls\n        # unstructured controls should appear after any loose params\n\n        # make copies to avoid changing input objects\n        local_cat = catalog.copy(deep=True)\n        local_merged = merged.copy(deep=True) if merged else None\n\n        merge_method = prof.CombinationMethodValidValues.keep.value\n        as_is = False\n        if self._profile.merge is not None:\n            if self._profile.merge.custom is not None:\n                raise TrestleError('Profile with custom merge is not supported.')\n            if self._profile.merge.as_is is not None:\n                as_is = self._profile.merge.as_is\n            if self._profile.merge.combine is None:\n                logger.debug('Profile has merge but no combine so defaulting to combine/merge.')\n                merge_method = prof.CombinationMethodValidValues.merge.value\n            else:\n                merge_combine = self._profile.merge.combine\n                if merge_combine.method.value is None:\n                    logger.debug('Profile has merge combine but no method.  Defaulting to merge.')\n                    merge_method = prof.CombinationMethodValidValues.merge.value\n                else:\n                    merge_method = merge_combine.method.value\n\n        if local_merged is None:\n            return self._flatten_catalog(local_cat, as_is)\n\n        # merge the incoming catalog with merged based on merge_method and as_is\n        return self._merge_two_catalogs(local_merged, local_cat, merge_method, as_is)\n\n    def process(self, pipelines: List[Pipeline]) -&gt; Iterator[cat.Catalog]:  # type: ignore\n        \"\"\"\n        Merge the incoming catalogs.\n\n        This pulls from import and iterates over the incoming catalogs.\n        The way groups, lists of controls, and controls themselves get merged is specified by the profile.\n        \"\"\"\n        merged: Optional[cat.Catalog] = None\n        logger.debug(f'merge entering process with {len(pipelines)} pipelines')\n        for pipeline in pipelines:\n            catalog = next(pipeline.process(None))\n            merged = self._merge_catalog(merged, catalog)\n        yield merged  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.Merge-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.Merge.__init__","title":"<code>__init__(profile)</code>","text":"<p>Initialize the class with the profile.</p> Source code in <code>trestle/core/resolver/merge.py</code> <pre><code>def __init__(self, profile: prof.Profile) -&gt; None:\n    \"\"\"Initialize the class with the profile.\"\"\"\n    logger.debug('merge filter initialize')\n    self._profile = profile\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge.Merge.process","title":"<code>process(pipelines)</code>","text":"<p>Merge the incoming catalogs.</p> <p>This pulls from import and iterates over the incoming catalogs. The way groups, lists of controls, and controls themselves get merged is specified by the profile.</p> Source code in <code>trestle/core/resolver/merge.py</code> <pre><code>def process(self, pipelines: List[Pipeline]) -&gt; Iterator[cat.Catalog]:  # type: ignore\n    \"\"\"\n    Merge the incoming catalogs.\n\n    This pulls from import and iterates over the incoming catalogs.\n    The way groups, lists of controls, and controls themselves get merged is specified by the profile.\n    \"\"\"\n    merged: Optional[cat.Catalog] = None\n    logger.debug(f'merge entering process with {len(pipelines)} pipelines')\n    for pipeline in pipelines:\n        catalog = next(pipeline.process(None))\n        merged = self._merge_catalog(merged, catalog)\n    yield merged  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/merge/#trestle.core.resolver.merge-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/resolver/modify/","title":"trestle.core.resolver.modify","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify","title":"<code>trestle.core.resolver.modify</code>","text":"<p>Create resolved catalog from profile.</p>"},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify.Modify","title":"<code>Modify</code>","text":"<p>               Bases: <code>Filter</code></p> <p>Modify the controls based on the profile.</p> Source code in <code>trestle/core/resolver/modify.py</code> <pre><code>class Modify(Pipeline.Filter):\n    \"\"\"Modify the controls based on the profile.\"\"\"\n\n    def __init__(\n        self,\n        profile: prof.Profile,\n        change_prose: bool = False,\n        block_adds: bool = False,\n        block_params: bool = False,\n        params_format: str = None,\n        param_rep: ParameterRep = ParameterRep.LEAVE_MOUSTACHE,\n        show_value_warnings: bool = False,\n        value_assigned_prefix: Optional[str] = None,\n        value_not_assigned_prefix: Optional[str] = None\n    ) -&gt; None:\n        \"\"\"Initialize the filter.\"\"\"\n        self._profile = profile\n        self._catalog_interface: Optional[CatalogInterface] = None\n        self._block_adds = block_adds\n        self._block_params = block_params\n        self._change_prose = change_prose\n        self._params_format = params_format\n        self._param_rep = param_rep\n        self.show_value_warnings = show_value_warnings\n        self._value_assigned_prefix = value_assigned_prefix\n        self._value_not_assigned_prefix = value_not_assigned_prefix\n        logger.debug(f'modify initialize filter with profile {profile.metadata.title}')\n\n    @staticmethod\n    def _add_adds_to_part(part: common.Part, add: prof.Add, added_parts=False) -&gt; None:\n        for attr in ['params', 'props', 'parts', 'links']:\n            # don't add parts if already added earlier\n            if added_parts and attr == 'parts':\n                continue\n            add_list = getattr(add, attr, None)\n            if add_list:\n                Modify._add_attr_to_part(part, add_list[:], attr, add.position)\n\n    @staticmethod\n    def _add_to_list(parts_list: List[common.Part], add: prof.Add) -&gt; bool:\n        \"\"\"Add the contents of the add according to its by_id and position.\n\n        Return True on success or False if id needed and not found.\n\n        This is only called when by_id is not None.\n        The add will be inserted if the id is found, or return False if not.\n        This allows a separate recursive routine to search sub-lists for the id.\n        Position before/after will put the item adjacent to the target in the same list as target\n        Position starting/ending will put the item within the target itself\n        \"\"\"\n        # Test here for matched by_id attribute.\n        added_parts = False\n        for index in range(len(parts_list)):\n            # find the matching part\n            if parts_list[index].id == add.by_id:\n                if add.position == prof.PositionValidValues.after:\n                    for offset, new_item in enumerate(as_list(add.parts)):\n                        parts_list.insert(index + 1 + offset, new_item)\n                    added_parts = True\n                elif add.position == prof.PositionValidValues.before:\n                    for offset, new_item in enumerate(as_list(add.parts)):\n                        parts_list.insert(index + offset, new_item)\n                    added_parts = True\n                # if starting or ending or None, the adds go directly into this part according to type\n                Modify._add_adds_to_part(parts_list[index], add, added_parts)\n                return True\n        return False\n\n    @staticmethod\n    def _add_to_parts(parts: List[common.Part], add: prof.Add) -&gt; bool:\n        \"\"\"\n        Add the add to the parts.\n\n        This is only called if add.by_id is not None.\n        \"\"\"\n        if Modify._add_to_list(parts, add):\n            return True\n        for part in parts:\n            if part.parts is not None and Modify._add_to_parts(part.parts, add):\n                return True\n        return False\n\n    @staticmethod\n    def _add_attr_to_part(part: common.Part, items: List[OBT], attr: str, position: Optional[str]) -&gt; None:\n        attr_list = as_list(getattr(part, attr, None))\n        # position may be None and if so will go at end\n        if position in [prof.PositionValidValues.starting, prof.PositionValidValues.before]:\n            items.extend(attr_list)\n            attr_list = items\n        else:\n            attr_list.extend(items)\n        setattr(part, attr, attr_list)\n\n    @staticmethod\n    def _add_attr_to_control(control: cat.Control, items: List[OBT], attr: str, position: Optional[str]) -&gt; None:\n        attr_list = as_list(getattr(control, attr, None))\n        if position in [prof.PositionValidValues.starting, prof.PositionValidValues.before]:\n            items.extend(attr_list)\n            attr_list = items\n        else:\n            attr_list.extend(items)\n        setattr(control, attr, attr_list)\n\n    @staticmethod\n    def _add_to_trestle_props(control: cat.Control, add: prof.Add) -&gt; None:\n        \"\"\"Add props to special trestle part that keeps track of inherited props.\"\"\"\n        if add.props:\n            trestle_part = get_item_from_list(control.parts, TRESTLE_INHERITED_PROPS_TRACKER, lambda p: p.name)\n            if trestle_part is None:\n                trestle_part = common.Part(\n                    id=TRESTLE_INHERITED_PROPS_TRACKER, name=TRESTLE_INHERITED_PROPS_TRACKER, props=[], parts=[]\n                )\n                control.parts = as_list(control.parts)\n                control.parts.append(trestle_part)\n                trestle_part = control.parts[-1]\n            if add.by_id is None or add.by_id == control.id:\n                trestle_part.props.extend(add.props)\n            else:\n                by_id_part = get_item_from_list(trestle_part.parts, add.by_id, lambda p: p.title)\n                if by_id_part is None:\n                    trestle_part.parts.append(\n                        common.Part(name=TRESTLE_INHERITED_PROPS_TRACKER + '_' + add.by_id, title=add.by_id, props=[])\n                    )\n                    by_id_part = trestle_part.parts[-1]\n                by_id_part.props.extend(add.props)\n\n    @staticmethod\n    def _add_to_control(control: cat.Control, add: prof.Add) -&gt; None:\n        \"\"\"First step in applying Add to control.\"\"\"\n        control.parts = as_list(control.parts)\n        if add.by_id is None or add.by_id == control.id:\n            # add contents will be added to the control directly and with no recursion\n            for attr in ['params', 'props', 'parts', 'links']:\n                add_list = getattr(add, attr, None)\n                if add_list:\n                    Modify._add_attr_to_control(control, add_list[:], attr, add.position)\n        else:\n            # this is only called if by_id is not None\n            if not Modify._add_to_parts(control.parts, add):\n                logger.warning(f'Could not find id for add in control {control.id}: {add.by_id}')\n        Modify._add_to_trestle_props(control, add)\n        control.parts = none_if_empty(control.parts)\n\n    @staticmethod\n    def _set_overwrite_items(param: common.Parameter, set_param: prof.SetParameter) -&gt; None:\n        # these overwrite\n        if set_param.class_:\n            param.class_ = set_param.class_\n        if set_param.depends_on:\n            param.depends_on = set_param.depends_on\n        if set_param.label:\n            param.label = set_param.label\n        if set_param.usage:\n            param.usage = set_param.usage\n        if set_param.values:\n            param.values = set_param.values\n        if set_param.select:\n            param.select = set_param.select\n\n    @staticmethod\n    def _set_appended_items(param: common.Parameter, set_param: prof.SetParameter) -&gt; None:\n        # these append\n        if set_param.constraints:\n            if not param.constraints:\n                param.constraints = []\n            param.constraints.extend(set_param.constraints)\n        if set_param.guidelines:\n            if not param.guidelines:\n                param.guidelines = []\n            param.guidelines.extend(set_param.guidelines)\n\n    @staticmethod\n    def _set_replaced_or_appended_items(param: common.Parameter, set_param: prof.SetParameter) -&gt; None:\n        # these replace or append\n        if set_param.props:\n            new_props = as_list(param.props)\n            names = [prop.name for prop in new_props]\n            for prop in set_param.props:\n                if prop.name in names:\n                    new_props[names.index(prop.name)] = prop\n                else:\n                    new_props.append(prop)\n            param.props = new_props\n        if set_param.links:\n            new_links = as_list(param.links)\n            hrefs = [link.href for link in new_links]\n            for link in set_param.links:\n                if link.href in hrefs:\n                    new_links[hrefs.index(link.href)] = link\n                else:\n                    new_links.append(link)\n            param.links = new_links\n\n    def _set_parameter_in_control_or_loose(self, set_param: prof.SetParameter) -&gt; None:\n        \"\"\"\n        Find the control with the param_id in it and set the parameter contents.\n\n        It modifies controls in the control_dict not the catalog.\n        Parameters are either bound to a control or are 'loose' and bound to the catalog itself.\n        \"\"\"\n        # find the target param in control or the catalog's loose ones, i.e. catalog.params\n        control = self._catalog_interface.get_control_by_param_id(set_param.param_id)\n        loose_param = False\n        if control:\n            control.params = as_list(control.params)\n            param_ids = [param.id for param in control.params]\n            if set_param.param_id not in param_ids:\n                raise TrestleNotFoundError(f'Param id {set_param.param_id} not found in control {control.id}')\n            index = param_ids.index(set_param.param_id)\n            param = control.params[index]\n        else:\n            param = self._catalog_interface.loose_param_dict.get(set_param.param_id, None)\n            if param:\n                loose_param = True\n            else:\n                logger.warning(f'SetParameter for param_id {set_param.param_id} not found in catalog')\n                return\n\n        # rules here follow https://pages.nist.gov/OSCAL/concepts/processing/profile-resolution/\n        # see 'Modify Phase' and Setting Parameters\n\n        Modify._set_overwrite_items(param, set_param)\n        Modify._set_appended_items(param, set_param)\n        Modify._set_replaced_or_appended_items(param, set_param)\n\n        if loose_param:\n            self._catalog_interface.loose_param_dict[set_param.param_id] = param\n        else:\n            control.params[index] = param\n            self._catalog_interface.replace_control(control)\n\n    def _modify_controls(self, catalog: cat.Catalog) -&gt; cat.Catalog:\n        \"\"\"Modify the controls based on the profile.\"\"\"\n        logger.debug(f'modify specify catalog {catalog.metadata.title} for profile {self._profile.metadata.title}')\n        self._catalog_interface = CatalogInterface(catalog)\n        alters: Optional[List[prof.Alter]] = None\n        # find the modify and alters\n        if self._profile.modify:\n            # change all parameter values\n            if self._profile.modify.set_parameters and not self._block_params:\n                set_param_list = self._profile.modify.set_parameters\n                for set_param in set_param_list:\n                    self._set_parameter_in_control_or_loose(set_param)\n            alters = self._profile.modify.alters\n\n        # an add with no by-id applies to the control\n        # if position is starting it should appear immediately after title\n        # if position is ending it should appear at end\n        # if not specified it defaults to ending\n        # if no by-id then before is treated as starting and after is treated as ending\n        if alters is not None:\n            title = self._profile.metadata.title\n            for alter in alters:\n                if alter.control_id is None:\n                    logger.warning(f'Alter must have control id specified in profile {title}.')\n                    continue\n                id_ = alter.control_id\n                if alter.removes is not None:\n                    logger.warning(f'Alter not supported for removes in profile {title} control {id_}')\n                    continue\n                # we want a warning about adds even if adds are blocked, as in profile generate\n                if alter.adds is None:\n                    logger.warning(f'Alter has no adds in profile {title} control {id_}')\n                    continue\n                if not self._block_adds:\n                    for add in alter.adds:\n                        control = self._catalog_interface.get_control(id_)\n                        if control is None:\n                            logger.warning(\n                                f'Alter/Add refers to control {id_} but it is not found in the import '\n                                + f'for profile {self._profile.metadata.title}'\n                            )\n                        else:\n                            self._add_to_control(control, add)\n                            self._catalog_interface.replace_control(control)\n\n        if self._change_prose:\n            # go through all controls and fix the prose based on param values\n            self._catalog_interface._change_prose_with_param_values(\n                self._params_format,\n                self._param_rep,\n                self.show_value_warnings,\n                self._value_assigned_prefix,\n                self._value_not_assigned_prefix\n            )\n\n        catalog = self._catalog_interface.get_catalog()\n\n        # update the original profile metadata with new contents\n        # roles and responsible-parties will be pulled in with new uuid's\n        # the title simply becomes the title of the current profile - and will get overwritten\n        # by any other profiles downstream so that only the final profile title is used\n        new_metadata = self._profile.metadata\n        new_metadata.title = self._profile.metadata.title\n        new_metadata.oscal_version = OSCAL_VERSION\n\n        links: List[common.Link] = []\n        for import_ in self._profile.imports:\n            links.append(common.Link(**{'href': import_.href, 'rel': RESOLUTION_SOURCE}))\n        new_metadata.links = links\n\n        # move catalog controls from dummy group '' into the catalog\n        for group in as_list(catalog.groups):\n            if not group.id:\n                catalog.controls = group.controls\n                catalog.groups.remove(group)\n                break\n\n        catalog.metadata = new_metadata\n\n        return catalog\n\n    def process(self, catalog_iter: Iterator[cat.Catalog]) -&gt; Iterator[cat.Catalog]:\n        \"\"\"Make the modifications to the controls based on the profile.\"\"\"\n        catalog = next(catalog_iter)\n        logger.debug(\n            f'modify process with catalog {catalog.metadata.title} using profile {self._profile.metadata.title}'\n        )\n        yield self._modify_controls(catalog)\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify.Modify-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify.Modify.show_value_warnings","title":"<code>show_value_warnings = show_value_warnings</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify.Modify-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify.Modify.__init__","title":"<code>__init__(profile, change_prose=False, block_adds=False, block_params=False, params_format=None, param_rep=ParameterRep.LEAVE_MOUSTACHE, show_value_warnings=False, value_assigned_prefix=None, value_not_assigned_prefix=None)</code>","text":"<p>Initialize the filter.</p> Source code in <code>trestle/core/resolver/modify.py</code> <pre><code>def __init__(\n    self,\n    profile: prof.Profile,\n    change_prose: bool = False,\n    block_adds: bool = False,\n    block_params: bool = False,\n    params_format: str = None,\n    param_rep: ParameterRep = ParameterRep.LEAVE_MOUSTACHE,\n    show_value_warnings: bool = False,\n    value_assigned_prefix: Optional[str] = None,\n    value_not_assigned_prefix: Optional[str] = None\n) -&gt; None:\n    \"\"\"Initialize the filter.\"\"\"\n    self._profile = profile\n    self._catalog_interface: Optional[CatalogInterface] = None\n    self._block_adds = block_adds\n    self._block_params = block_params\n    self._change_prose = change_prose\n    self._params_format = params_format\n    self._param_rep = param_rep\n    self.show_value_warnings = show_value_warnings\n    self._value_assigned_prefix = value_assigned_prefix\n    self._value_not_assigned_prefix = value_not_assigned_prefix\n    logger.debug(f'modify initialize filter with profile {profile.metadata.title}')\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify.Modify.process","title":"<code>process(catalog_iter)</code>","text":"<p>Make the modifications to the controls based on the profile.</p> Source code in <code>trestle/core/resolver/modify.py</code> <pre><code>def process(self, catalog_iter: Iterator[cat.Catalog]) -&gt; Iterator[cat.Catalog]:\n    \"\"\"Make the modifications to the controls based on the profile.\"\"\"\n    catalog = next(catalog_iter)\n    logger.debug(\n        f'modify process with catalog {catalog.metadata.title} using profile {self._profile.metadata.title}'\n    )\n    yield self._modify_controls(catalog)\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/modify/#trestle.core.resolver.modify-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/resolver/prune/","title":"trestle.core.resolver.prune","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/core/resolver/prune/#trestle.core.resolver.prune","title":"<code>trestle.core.resolver.prune</code>","text":"<p>Create resolved catalog from profile.</p>"},{"location":"reference/API/trestle/core/resolver/prune/#trestle.core.resolver.prune-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/core/resolver/prune/#trestle.core.resolver.prune.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/core/resolver/prune/#trestle.core.resolver.prune-classes","title":"Classes","text":""},{"location":"reference/API/trestle/core/resolver/prune/#trestle.core.resolver.prune.Prune","title":"<code>Prune</code>","text":"<p>               Bases: <code>Filter</code></p> <p>Prune the catalog based on the import include rule.</p> Source code in <code>trestle/core/resolver/prune.py</code> <pre><code>class Prune(Pipeline.Filter):\n    \"\"\"Prune the catalog based on the import include rule.\"\"\"\n\n    def __init__(self, import_: prof.Import, profile: prof.Profile) -&gt; None:\n        \"\"\"\n        Inject the import.\n\n        This needs to be created prior to knowing the catalog.\n        The profile itself is only needed for debug messages.\n        The import is one possibly several imports in that profile.\n        \"\"\"\n        self._import = import_\n        self._profile = profile\n        self._catalog_interface: Optional[CatalogInterface] = None\n        self._catalog: Optional[cat.Catalog] = None\n\n    def _set_catalog(self, catalog: cat.Catalog) -&gt; None:\n        \"\"\"Set the catalog used by the catalog interface.\"\"\"\n        self._catalog_interface = CatalogInterface(catalog)\n        self._catalog = catalog\n\n    def _controls_selected(self, select_list: Optional[List[prof.SelectControl]]) -&gt; List[str]:\n        control_ids: List[str] = []\n        if select_list is not None:\n            for select_control in select_list:\n                if select_control.matching is not None:\n                    raise TrestleError('Profiles with SelectControl based on matching are not supported.')\n                include_children = select_control.with_child_controls == 'yes'\n                if select_control.with_ids:\n                    new_ids = select_control.with_ids\n                    for withid_ in new_ids:\n                        id_ = withid_.__root__\n                        control_ids.append(id_)\n                        if include_children:\n                            control_ids.extend(self._catalog_interface.get_dependent_control_ids(id_))\n        return control_ids\n\n    def _find_needed_control_ids(self) -&gt; List[str]:\n        \"\"\"Get list of control_ids needed by profile and corresponding groups.\"\"\"\n        if self._import.include_controls is not None:\n            include_ids = self._controls_selected(self._import.include_controls)\n        else:\n            if self._import.include_all is None:\n                logger.warning('Profile does not specify include-controls, so including all.')\n            include_ids = self._catalog_interface.get_control_ids()\n\n        exclude_ids = self._controls_selected(self._import.exclude_controls)\n\n        if not set(include_ids).issuperset(set(exclude_ids)):\n            logger.debug(f'include_ids is not a superset of exclude_ids in import {self._import.href}')\n        return sorted([id_ for id_ in include_ids if id_ not in exclude_ids])\n\n    def _prune_control(self, needed_ids: List[str], control: cat.Control, exclude_ids: List[str]) -&gt; cat.Control:\n        \"\"\"\n        Prune the control based on the Import requirements.\n\n        This is only called if the control is needed\n        Some or all of its sub_controls may not be needed\n        This always returns the original control, possibly with fewer subcontrols\n        \"\"\"\n        if control.controls is None:\n            return control\n        controls = []\n        for sub_control in control.controls:\n            if sub_control.id in needed_ids and sub_control.id not in exclude_ids:\n                controls.append(self._prune_control(needed_ids, sub_control, exclude_ids))\n                exclude_ids.append(sub_control.id)\n        control.controls = none_if_empty(controls)\n        return control\n\n    def _prune_controls(self, needed_ids: List[str]) -&gt; List[str]:\n        loaded_ids: List[str] = []\n        final_ids: List[str] = []\n        for control_id in needed_ids:\n            if control_id not in loaded_ids:\n                control = self._catalog_interface.get_control(control_id)\n                if control is None:\n                    msg = (\n                        f'Profile titled \"{self._profile.metadata.title}\" references control {control_id} '\n                        f'but it is not in catalog titled \"{self._catalog.metadata.title}\"'\n                    )\n                    raise TrestleError(msg)\n                control = self._prune_control(needed_ids, control, loaded_ids)\n                self._catalog_interface.replace_control(control)\n                loaded_ids.append(control_id)\n                final_ids.append(control_id)\n        return final_ids\n\n    def _re_insert_child_controls(self, control: cat.Control) -&gt; cat.Control:\n        \"\"\"Re insert this control and its children recursively.\"\"\"\n        new_controls = []\n        for sub_control in as_list(control.controls):\n            new_control = self._re_insert_child_controls(sub_control)\n            new_controls.append(new_control)\n        control.controls = none_if_empty(new_controls)\n        return control\n\n    def _re_insert_children(self) -&gt; None:\n        \"\"\"Go through all controls in control dict and load child controls from control dict.\"\"\"\n        for control in self._catalog_interface.get_all_controls_from_dict():\n            _ = self._re_insert_child_controls(control)\n\n    def _prune_catalog(self) -&gt; cat.Catalog:\n        \"\"\"Prune the controls in the current catalog.\"\"\"\n        if self._import is None:\n            return self._catalog\n\n        needed_ids = self._find_needed_control_ids()\n\n        # if a control includes controls - only include those that we know are needed\n        final_control_ids = self._prune_controls(needed_ids)\n\n        self._re_insert_children()\n\n        cat_controls = []\n\n        # build the needed groups of controls\n        group_dict: Dict[str, cat.Group] = {}\n        for control_id in final_control_ids:\n            control = self._catalog_interface.get_control(control_id)\n            group_id, group_title, group_class = self._catalog_interface.get_group_info_by_control(control_id)\n            if not group_id:\n                cat_controls.append(control)\n                continue\n            group = group_dict.get(group_id)\n            if group is None:\n                group = cat.Group(id=group_id, title=group_title, class_=group_class, controls=[control])\n                group_dict[group_id] = group\n            else:\n                group_dict[group_id].controls.append(control)\n\n        new_groups: Optional[List[cat.Group]] = list(group_dict.values())\n\n        # should avoid empty lists so set to None if empty\n        new_groups = none_if_empty(new_groups)\n        cat_controls = none_if_empty(cat_controls)\n        new_params = self._catalog.params\n\n        new_cat = cat.Catalog(\n            uuid=str(uuid4()),\n            metadata=self._catalog.metadata,\n            back_matter=common.BackMatter(),\n            controls=cat_controls,\n            groups=new_groups,\n            params=new_params\n        )\n\n        # find all referenced uuids - they should be 1:1 with those in backmatter\n        needed_uuid_refs = ModelUtils.find_uuid_refs(new_cat)\n\n        # prune the list of resources to only those that are needed\n        new_resources: Optional[List[common.Resource]] = []\n        if self._catalog.back_matter and self._catalog.back_matter.resources:\n            new_resources = [res for res in self._catalog.back_matter.resources if res.uuid in needed_uuid_refs]\n        new_resources = none_if_empty(new_resources)\n        new_cat.back_matter.resources = new_resources\n\n        return new_cat\n\n    def process(self, catalog_iter: Iterator[cat.Catalog]) -&gt; Iterator[cat.Catalog]:  # type: ignore\n        \"\"\"\n        Prune the catalog based on the include rule in the import_.\n\n        This only processes the one catalog yielded by the one import in this pipeline.\n        It must yield in order to have the merge filter loop over available imported catalogs.\n        \"\"\"\n        self._set_catalog(next(catalog_iter))\n        logger.debug(f'prune yielding catalog {self._catalog.metadata.title} with import {self._import.href}')\n        yield self._prune_catalog()\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/prune/#trestle.core.resolver.prune.Prune-functions","title":"Functions","text":""},{"location":"reference/API/trestle/core/resolver/prune/#trestle.core.resolver.prune.Prune.__init__","title":"<code>__init__(import_, profile)</code>","text":"<p>Inject the import.</p> <p>This needs to be created prior to knowing the catalog. The profile itself is only needed for debug messages. The import is one possibly several imports in that profile.</p> Source code in <code>trestle/core/resolver/prune.py</code> <pre><code>def __init__(self, import_: prof.Import, profile: prof.Profile) -&gt; None:\n    \"\"\"\n    Inject the import.\n\n    This needs to be created prior to knowing the catalog.\n    The profile itself is only needed for debug messages.\n    The import is one possibly several imports in that profile.\n    \"\"\"\n    self._import = import_\n    self._profile = profile\n    self._catalog_interface: Optional[CatalogInterface] = None\n    self._catalog: Optional[cat.Catalog] = None\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/prune/#trestle.core.resolver.prune.Prune.process","title":"<code>process(catalog_iter)</code>","text":"<p>Prune the catalog based on the include rule in the import_.</p> <p>This only processes the one catalog yielded by the one import in this pipeline. It must yield in order to have the merge filter loop over available imported catalogs.</p> Source code in <code>trestle/core/resolver/prune.py</code> <pre><code>def process(self, catalog_iter: Iterator[cat.Catalog]) -&gt; Iterator[cat.Catalog]:  # type: ignore\n    \"\"\"\n    Prune the catalog based on the include rule in the import_.\n\n    This only processes the one catalog yielded by the one import in this pipeline.\n    It must yield in order to have the merge filter loop over available imported catalogs.\n    \"\"\"\n    self._set_catalog(next(catalog_iter))\n    logger.debug(f'prune yielding catalog {self._catalog.metadata.title} with import {self._import.href}')\n    yield self._prune_catalog()\n</code></pre>"},{"location":"reference/API/trestle/core/resolver/prune/#trestle.core.resolver.prune-functions","title":"Functions","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/","title":"trestle.oscal.assessment_plan","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan","title":"<code>trestle.oscal.assessment_plan</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan","title":"<code>AssessmentPlan</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An assessment plan, such as those provided by a FedRAMP assessor.</p> Source code in <code>trestle/oscal/assessment_plan.py</code> <pre><code>class AssessmentPlan(OscalBaseModel):\n    \"\"\"\n    An assessment plan, such as those provided by a FedRAMP assessor.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment plan in this or other OSCAL instances. The locally defined UUID of the assessment plan can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Assessment Plan Universally Unique Identifier',\n    )\n    metadata: common.Metadata\n    import_ssp: common.ImportSsp = Field(..., alias='import-ssp')\n    local_definitions: Optional[LocalDefinitions] = Field(\n        None,\n        alias='local-definitions',\n        description=\n        'Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.',\n        title='Local Definitions'\n    )\n    terms_and_conditions: Optional[TermsAndConditions] = Field(\n        None,\n        alias='terms-and-conditions',\n        description=\n        'Used to define various terms and conditions under which an assessment, described by the plan, can be performed. Each child part defines a different type of term or condition.',\n        title='Assessment Plan Terms and Conditions'\n    )\n    reviewed_controls: common.ReviewedControls = Field(..., alias='reviewed-controls')\n    assessment_subjects: Optional[List[common.AssessmentSubject]] = Field(None, alias='assessment-subjects')\n    assessment_assets: Optional[common.AssessmentAssets] = Field(None, alias='assessment-assets')\n    tasks: Optional[List[common.Task]] = Field(None)\n    back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.assessment_assets","title":"<code>assessment_assets: Optional[common.AssessmentAssets] = Field(None, alias='assessment-assets')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.assessment_subjects","title":"<code>assessment_subjects: Optional[List[common.AssessmentSubject]] = Field(None, alias='assessment-subjects')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.back_matter","title":"<code>back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.import_ssp","title":"<code>import_ssp: common.ImportSsp = Field(..., alias='import-ssp')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.local_definitions","title":"<code>local_definitions: Optional[LocalDefinitions] = Field(None, alias='local-definitions', description='Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.', title='Local Definitions')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.metadata","title":"<code>metadata: common.Metadata</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.reviewed_controls","title":"<code>reviewed_controls: common.ReviewedControls = Field(..., alias='reviewed-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.tasks","title":"<code>tasks: Optional[List[common.Task]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.terms_and_conditions","title":"<code>terms_and_conditions: Optional[TermsAndConditions] = Field(None, alias='terms-and-conditions', description='Used to define various terms and conditions under which an assessment, described by the plan, can be performed. Each child part defines a different type of term or condition.', title='Assessment Plan Terms and Conditions')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment plan in this or other OSCAL instances. The locally defined UUID of the assessment plan can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Assessment Plan Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.AssessmentPlan.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_plan.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions","title":"<code>LocalDefinitions</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.</p> Source code in <code>trestle/oscal/assessment_plan.py</code> <pre><code>class LocalDefinitions(OscalBaseModel):\n    \"\"\"\n    Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    components: Optional[List[common.SystemComponent]] = Field(None)\n    inventory_items: Optional[List[common.InventoryItem]] = Field(None, alias='inventory-items')\n    users: Optional[List[common.SystemUser]] = Field(None)\n    objectives_and_methods: Optional[List[common.LocalObjective]] = Field(None, alias='objectives-and-methods')\n    activities: Optional[List[common.Activity]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions.activities","title":"<code>activities: Optional[List[common.Activity]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions.components","title":"<code>components: Optional[List[common.SystemComponent]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions.inventory_items","title":"<code>inventory_items: Optional[List[common.InventoryItem]] = Field(None, alias='inventory-items')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions.objectives_and_methods","title":"<code>objectives_and_methods: Optional[List[common.LocalObjective]] = Field(None, alias='objectives-and-methods')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions.users","title":"<code>users: Optional[List[common.SystemUser]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.LocalDefinitions.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_plan.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.Model","title":"<code>Model</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/assessment_plan.py</code> <pre><code>class Model(OscalBaseModel):\n    assessment_plan: AssessmentPlan = Field(..., alias='assessment-plan')\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.Model-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.Model.assessment_plan","title":"<code>assessment_plan: AssessmentPlan = Field(..., alias='assessment-plan')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.TermsAndConditions","title":"<code>TermsAndConditions</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to define various terms and conditions under which an assessment, described by the plan, can be performed. Each child part defines a different type of term or condition.</p> Source code in <code>trestle/oscal/assessment_plan.py</code> <pre><code>class TermsAndConditions(OscalBaseModel):\n    \"\"\"\n    Used to define various terms and conditions under which an assessment, described by the plan, can be performed. Each child part defines a different type of term or condition.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    parts: Optional[List[common.AssessmentPart]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.TermsAndConditions-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.TermsAndConditions.parts","title":"<code>parts: Optional[List[common.AssessmentPart]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.TermsAndConditions-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_plan/#trestle.oscal.assessment_plan.TermsAndConditions.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_plan.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_results/","title":"trestle.oscal.assessment_results","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results","title":"<code>trestle.oscal.assessment_results</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentLog","title":"<code>AssessmentLog</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A log of all assessment-related actions taken.</p> Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class AssessmentLog(OscalBaseModel):\n    \"\"\"\n    A log of all assessment-related actions taken.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    entries: List[Entry1] = Field(...)\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentLog-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentLog.entries","title":"<code>entries: List[Entry1] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentLog-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentLog.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults","title":"<code>AssessmentResults</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Security assessment results, such as those provided by a FedRAMP assessor in the FedRAMP Security Assessment Report.</p> Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class AssessmentResults(OscalBaseModel):\n    \"\"\"\n    Security assessment results, such as those provided by a FedRAMP assessor in the FedRAMP Security Assessment Report.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment results instance in this or other OSCAL instances. The locally defined UUID of the assessment result can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Assessment Results Universally Unique Identifier',\n    )\n    metadata: common.Metadata\n    import_ap: ImportAp = Field(..., alias='import-ap')\n    local_definitions: Optional[LocalDefinitions] = Field(\n        None,\n        alias='local-definitions',\n        description=\n        'Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.',\n        title='Local Definitions'\n    )\n    results: List[Result] = Field(...)\n    back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults.back_matter","title":"<code>back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults.import_ap","title":"<code>import_ap: ImportAp = Field(..., alias='import-ap')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults.local_definitions","title":"<code>local_definitions: Optional[LocalDefinitions] = Field(None, alias='local-definitions', description='Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.', title='Local Definitions')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults.metadata","title":"<code>metadata: common.Metadata</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults.results","title":"<code>results: List[Result] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment results instance in this or other OSCAL instances. The locally defined UUID of the assessment result can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Assessment Results Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.AssessmentResults.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Attestation","title":"<code>Attestation</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A set of textual statements, typically written by the assessor.</p> Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Attestation(OscalBaseModel):\n    \"\"\"\n    A set of textual statements, typically written by the assessor.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    responsible_parties: Optional[List[common.ResponsibleParty]] = Field(None, alias='responsible-parties')\n    parts: List[common.AssessmentPart] = Field(...)\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Attestation-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Attestation.parts","title":"<code>parts: List[common.AssessmentPart] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Attestation.responsible_parties","title":"<code>responsible_parties: Optional[List[common.ResponsibleParty]] = Field(None, alias='responsible-parties')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Attestation-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Attestation.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1","title":"<code>Entry1</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies the result of an action and/or task that occurred as part of executing an assessment plan or an assessment event that occurred in producing the assessment results.</p> Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Entry1(OscalBaseModel):\n    \"\"\"\n    Identifies the result of an action and/or task that occurred as part of executing an assessment plan or an assessment event that occurred in producing the assessment results.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference an assessment event in this or other OSCAL instances. The locally defined UUID of the assessment log entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Assessment Log Entry Universally Unique Identifier',\n    )\n    title: Optional[str] = Field(None, description='The title for this event.', title='Action Title')\n    description: Optional[str] = Field(\n        None, description='A human-readable description of this event.', title='Action Description'\n    )\n    start: datetime = Field(..., description='Identifies the start date and time of an event.', title='Start')\n    end: Optional[datetime] = Field(\n        None,\n        description=\n        'Identifies the end date and time of an event. If the event is a point in time, the start and end will be the same date and time.',\n        title='End'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    logged_by: Optional[List[common.LoggedBy]] = Field(None, alias='logged-by')\n    related_tasks: Optional[List[common.RelatedTask]] = Field(None, alias='related-tasks')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.description","title":"<code>description: Optional[str] = Field(None, description='A human-readable description of this event.', title='Action Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.end","title":"<code>end: Optional[datetime] = Field(None, description='Identifies the end date and time of an event. If the event is a point in time, the start and end will be the same date and time.', title='End')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.logged_by","title":"<code>logged_by: Optional[List[common.LoggedBy]] = Field(None, alias='logged-by')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.related_tasks","title":"<code>related_tasks: Optional[List[common.RelatedTask]] = Field(None, alias='related-tasks')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.start","title":"<code>start: datetime = Field(..., description='Identifies the start date and time of an event.', title='Start')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.title","title":"<code>title: Optional[str] = Field(None, description='The title for this event.', title='Action Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference an assessment event in this or other OSCAL instances. The locally defined UUID of the assessment log entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Assessment Log Entry Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Entry1.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.ImportAp","title":"<code>ImportAp</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used by assessment-results to import information about the original plan for assessing the system.</p> Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class ImportAp(OscalBaseModel):\n    \"\"\"\n    Used by assessment-results to import information about the original plan for assessing the system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    href: str = Field(\n        ...,\n        description='A resolvable URL reference to the assessment plan governing the assessment activities.',\n        title='Assessment Plan Reference'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.ImportAp-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.ImportAp.href","title":"<code>href: str = Field(..., description='A resolvable URL reference to the assessment plan governing the assessment activities.', title='Assessment Plan Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.ImportAp.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.ImportAp-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.ImportAp.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions","title":"<code>LocalDefinitions</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.</p> Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class LocalDefinitions(OscalBaseModel):\n    \"\"\"\n    Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    objectives_and_methods: Optional[List[common.LocalObjective]] = Field(None, alias='objectives-and-methods')\n    activities: Optional[List[common.Activity]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions.activities","title":"<code>activities: Optional[List[common.Activity]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions.objectives_and_methods","title":"<code>objectives_and_methods: Optional[List[common.LocalObjective]] = Field(None, alias='objectives-and-methods')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions1","title":"<code>LocalDefinitions1</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.</p> Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class LocalDefinitions1(OscalBaseModel):\n    \"\"\"\n    Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    components: Optional[List[common.SystemComponent]] = Field(None)\n    inventory_items: Optional[List[common.InventoryItem]] = Field(None, alias='inventory-items')\n    users: Optional[List[common.SystemUser]] = Field(None)\n    assessment_assets: Optional[common.AssessmentAssets] = Field(None, alias='assessment-assets')\n    tasks: Optional[List[common.Task]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions1-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions1.assessment_assets","title":"<code>assessment_assets: Optional[common.AssessmentAssets] = Field(None, alias='assessment-assets')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions1.components","title":"<code>components: Optional[List[common.SystemComponent]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions1.inventory_items","title":"<code>inventory_items: Optional[List[common.InventoryItem]] = Field(None, alias='inventory-items')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions1.tasks","title":"<code>tasks: Optional[List[common.Task]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions1.users","title":"<code>users: Optional[List[common.SystemUser]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions1-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.LocalDefinitions1.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Model","title":"<code>Model</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Model(OscalBaseModel):\n    assessment_results: AssessmentResults = Field(..., alias='assessment-results')\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Model-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Model.assessment_results","title":"<code>assessment_results: AssessmentResults = Field(..., alias='assessment-results')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result","title":"<code>Result</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used by the assessment results and POA&amp;M. In the assessment results, this identifies all of the assessment observations and findings, initial and residual risks, deviations, and disposition. In the POA&amp;M, this identifies initial and residual risks, deviations, and disposition.</p> Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Result(OscalBaseModel):\n    \"\"\"\n    Used by the assessment results and POA&amp;M. In the assessment results, this identifies all of the assessment observations and findings, initial and residual risks, deviations, and disposition. In the POA&amp;M, this identifies initial and residual risks, deviations, and disposition.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this set of results in this or other OSCAL instances. The locally defined UUID of the assessment result can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Results Universally Unique Identifier',\n    )\n    title: str = Field(..., description='The title for this set of results.', title='Results Title')\n    description: str = Field(\n        ..., description='A human-readable description of this set of test results.', title='Results Description'\n    )\n    start: datetime = Field(\n        ...,\n        description='Date/time stamp identifying the start of the evidence collection reflected in these results.',\n        title='start field'\n    )\n    end: Optional[datetime] = Field(\n        None,\n        description=\n        'Date/time stamp identifying the end of the evidence collection reflected in these results. In a continuous motoring scenario, this may contain the same value as start if appropriate.',\n        title='end field'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    local_definitions: Optional[LocalDefinitions1] = Field(\n        None,\n        alias='local-definitions',\n        description=\n        'Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.',\n        title='Local Definitions'\n    )\n    reviewed_controls: common.ReviewedControls = Field(..., alias='reviewed-controls')\n    attestations: Optional[List[Attestation]] = Field(None)\n    assessment_log: Optional[AssessmentLog] = Field(\n        None,\n        alias='assessment-log',\n        description='A log of all assessment-related actions taken.',\n        title='Assessment Log'\n    )\n    observations: Optional[List[common.Observation]] = Field(None)\n    risks: Optional[List[common.Risk]] = Field(None)\n    findings: Optional[List[common.Finding]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.assessment_log","title":"<code>assessment_log: Optional[AssessmentLog] = Field(None, alias='assessment-log', description='A log of all assessment-related actions taken.', title='Assessment Log')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.attestations","title":"<code>attestations: Optional[List[Attestation]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.description","title":"<code>description: str = Field(..., description='A human-readable description of this set of test results.', title='Results Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.end","title":"<code>end: Optional[datetime] = Field(None, description='Date/time stamp identifying the end of the evidence collection reflected in these results. In a continuous motoring scenario, this may contain the same value as start if appropriate.', title='end field')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.findings","title":"<code>findings: Optional[List[common.Finding]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.local_definitions","title":"<code>local_definitions: Optional[LocalDefinitions1] = Field(None, alias='local-definitions', description='Used to define data objects that are used in the assessment plan, that do not appear in the referenced SSP.', title='Local Definitions')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.observations","title":"<code>observations: Optional[List[common.Observation]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.reviewed_controls","title":"<code>reviewed_controls: common.ReviewedControls = Field(..., alias='reviewed-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.risks","title":"<code>risks: Optional[List[common.Risk]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.start","title":"<code>start: datetime = Field(..., description='Date/time stamp identifying the start of the evidence collection reflected in these results.', title='start field')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.title","title":"<code>title: str = Field(..., description='The title for this set of results.', title='Results Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this set of results in this or other OSCAL instances. The locally defined UUID of the assessment result can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Results Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/assessment_results/#trestle.oscal.assessment_results.Result.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/assessment_results.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/catalog/","title":"trestle.oscal.catalog","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog","title":"<code>trestle.oscal.catalog</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog","title":"<code>Catalog</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A structured, organized collection of control information.</p> Source code in <code>trestle/oscal/catalog.py</code> <pre><code>class Catalog(OscalBaseModel):\n    \"\"\"\n    A structured, organized collection of control information.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n                 ) = Field(\n                     ...,\n                     description='Provides a globally unique means to identify a given catalog instance.',\n                     title='Catalog Universally Unique Identifier'\n                 )\n    metadata: common.Metadata\n    params: Optional[List[common.Parameter]] = Field(None)\n    controls: Optional[List[Control]] = Field(None)\n    groups: Optional[List[Group]] = Field(None)\n    back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')\n</code></pre>"},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog.back_matter","title":"<code>back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog.controls","title":"<code>controls: Optional[List[Control]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog.groups","title":"<code>groups: Optional[List[Group]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog.metadata","title":"<code>metadata: common.Metadata</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog.params","title":"<code>params: Optional[List[common.Parameter]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='Provides a globally unique means to identify a given catalog instance.', title='Catalog Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Catalog.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/catalog.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control","title":"<code>Control</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A structured object representing a requirement or guideline, which when implemented will reduce an aspect of risk related to an information system and its information.</p> Source code in <code>trestle/oscal/catalog.py</code> <pre><code>class Control(OscalBaseModel):\n    \"\"\"\n    A structured object representing a requirement or guideline, which when implemented will reduce an aspect of risk related to an information system and its information.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        description=\n        'Identifies a control such that it can be referenced in the defining catalog and other OSCAL instances (e.g., profiles).',\n        title='Control Identifier'\n    )\n    class_: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='class',\n        description='A textual label that provides a sub-type or characterization of the control.',\n        title='Control Class'\n    )\n    title: str = Field(\n        ...,\n        description='A name given to the control, which may be used by a tool for display and navigation.',\n        title='Control Title'\n    )\n    params: Optional[List[common.Parameter]] = Field(None)\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    parts: Optional[List[common.Part]] = Field(None)\n    controls: Optional[List[Control]] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control.class_","title":"<code>class_: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='class', description='A textual label that provides a sub-type or characterization of the control.', title='Control Class')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control.controls","title":"<code>controls: Optional[List[Control]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control.id","title":"<code>id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., description='Identifies a control such that it can be referenced in the defining catalog and other OSCAL instances (e.g., profiles).', title='Control Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control.params","title":"<code>params: Optional[List[common.Parameter]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control.parts","title":"<code>parts: Optional[List[common.Part]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control.title","title":"<code>title: str = Field(..., description='A name given to the control, which may be used by a tool for display and navigation.', title='Control Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Control.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/catalog.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group","title":"<code>Group</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A group of controls, or of groups of controls.</p> Source code in <code>trestle/oscal/catalog.py</code> <pre><code>class Group(OscalBaseModel):\n    \"\"\"\n    A group of controls, or of groups of controls.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    id: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        description=\n        'Identifies the group for the purpose of cross-linking within the defining instance or from other instances that reference the catalog.',\n        title='Group Identifier'\n    )\n    class_: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='class',\n        description='A textual label that provides a sub-type or characterization of the group.',\n        title='Group Class'\n    )\n    title: str = Field(\n        ...,\n        description='A name given to the group, which may be used by a tool for display and navigation.',\n        title='Group Title'\n    )\n    params: Optional[List[common.Parameter]] = Field(None)\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    parts: Optional[List[common.Part]] = Field(None)\n    groups: Optional[List[Group]] = None\n    controls: Optional[List[Control]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.class_","title":"<code>class_: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='class', description='A textual label that provides a sub-type or characterization of the group.', title='Group Class')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.controls","title":"<code>controls: Optional[List[Control]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.groups","title":"<code>groups: Optional[List[Group]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.id","title":"<code>id: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, description='Identifies the group for the purpose of cross-linking within the defining instance or from other instances that reference the catalog.', title='Group Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.params","title":"<code>params: Optional[List[common.Parameter]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.parts","title":"<code>parts: Optional[List[common.Part]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.title","title":"<code>title: str = Field(..., description='A name given to the group, which may be used by a tool for display and navigation.', title='Group Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Group.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/catalog.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Model","title":"<code>Model</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/catalog.py</code> <pre><code>class Model(OscalBaseModel):\n    catalog: Catalog\n</code></pre>"},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Model-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/catalog/#trestle.oscal.catalog.Model.catalog","title":"<code>catalog: Catalog</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/","title":"trestle.oscal.common","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common","title":"<code>trestle.oscal.common</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.HowMany","title":"<code>HowMany = HowManyValidValues</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action","title":"<code>Action</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An action applied by a role within a given party to the content.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Action(OscalBaseModel):\n    \"\"\"\n    An action applied by a role within a given party to the content.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A unique identifier that can be used to reference this defined action elsewhere in an OSCAL document. A UUID should be consistently used for a given location across revisions of the document.',\n        title='Action Universally Unique Identifier'\n    )\n    date: Optional[datetime] = Field(\n        None, description='The date and time when the action occurred.', title='Action Occurrence Date'\n    )\n    type: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ..., description='The type of action documented by the assembly, such as an approval.', title='Action Type'\n    )\n    system: AnyUrl = Field(..., description='Specifies the action type system used.', title='Action Type System')\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action.date","title":"<code>date: Optional[datetime] = Field(None, description='The date and time when the action occurred.', title='Action Occurrence Date')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action.responsible_parties","title":"<code>responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action.system","title":"<code>system: AnyUrl = Field(..., description='Specifies the action type system used.', title='Action Type System')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action.type","title":"<code>type: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., description='The type of action documented by the assembly, such as an approval.', title='Action Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A unique identifier that can be used to reference this defined action elsewhere in an OSCAL document. A UUID should be consistently used for a given location across revisions of the document.', title='Action Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Action.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity","title":"<code>Activity</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies an assessment or related process that can be performed. In the assessment plan, this is an intended activity which may be associated with an assessment task. In the assessment results, this an activity that was actually performed as part of an assessment.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Activity(OscalBaseModel):\n    \"\"\"\n    Identifies an assessment or related process that can be performed. In the assessment plan, this is an intended activity which may be associated with an assessment task. In the assessment results, this an activity that was actually performed as part of an assessment.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment activity elsewhere in this or other OSCAL instances. The locally defined UUID of the activity can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Assessment Activity Universally Unique Identifier',\n    )\n    title: Optional[str] = Field(\n        None, description='The title for this included activity.', title='Included Activity Title'\n    )\n    description: str = Field(\n        ...,\n        description='A human-readable description of this included activity.',\n        title='Included Activity Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    steps: Optional[List[Step]] = Field(None)\n    related_controls: Optional[ReviewedControls] = Field(None, alias='related-controls')\n    responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.description","title":"<code>description: str = Field(..., description='A human-readable description of this included activity.', title='Included Activity Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.related_controls","title":"<code>related_controls: Optional[ReviewedControls] = Field(None, alias='related-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.responsible_roles","title":"<code>responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.steps","title":"<code>steps: Optional[List[Step]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.title","title":"<code>title: Optional[str] = Field(None, description='The title for this included activity.', title='Included Activity Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment activity elsewhere in this or other OSCAL instances. The locally defined UUID of the activity can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Assessment Activity Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Activity.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AddrLine","title":"<code>AddrLine</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AddrLine(OscalBaseModel):\n    __root__: StringDatatype = Field(..., description='A single line of an address.', title='Address line')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AddrLine-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AddrLine.__root__","title":"<code>__root__: StringDatatype = Field(..., description='A single line of an address.', title='Address line')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address","title":"<code>Address</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A postal address for the location.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Address(OscalBaseModel):\n    \"\"\"\n    A postal address for the location.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    type: Optional[Union[TokenDatatype, AddressTypeValidValues]] = Field(\n        None, description='Indicates the type of address.', title='Address Type'\n    )\n    addr_lines: Optional[List[constr(regex=r'^\\S(.*\\S)?$')]] = Field(None, alias='addr-lines')\n    city: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None, description='City, town or geographical region for the mailing address.', title='City'\n    )\n    state: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None, description='State, province or analogous geographical region for a mailing address.', title='State'\n    )\n    postal_code: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None, alias='postal-code', description='Postal or ZIP code for mailing address.', title='Postal Code'\n    )\n    country: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None, description='The ISO 3166-1 alpha-2 country code for the mailing address.', title='Country Code'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address.addr_lines","title":"<code>addr_lines: Optional[List[constr(regex='^\\\\S(.*\\\\S)?$')]] = Field(None, alias='addr-lines')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address.city","title":"<code>city: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, description='City, town or geographical region for the mailing address.', title='City')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address.country","title":"<code>country: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, description='The ISO 3166-1 alpha-2 country code for the mailing address.', title='Country Code')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address.postal_code","title":"<code>postal_code: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='postal-code', description='Postal or ZIP code for mailing address.', title='Postal Code')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address.state","title":"<code>state: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, description='State, province or analogous geographical region for a mailing address.', title='State')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address.type","title":"<code>type: Optional[Union[TokenDatatype, AddressTypeValidValues]] = Field(None, description='Indicates the type of address.', title='Address Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Address.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AddressTypeValidValues","title":"<code>AddressTypeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AddressTypeValidValues(Enum):\n    home = 'home'\n    work = 'work'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AddressTypeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AddressTypeValidValues.home","title":"<code>home = 'home'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AddressTypeValidValues.work","title":"<code>work = 'work'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm","title":"<code>Algorithm</code>","text":"<p>               Bases: <code>Enum</code></p> <p>The digest method by which a hash is derived.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Algorithm(Enum):\n    \"\"\"\n    The digest method by which a hash is derived.\n    \"\"\"\n\n    SHA_224 = 'SHA-224'\n    SHA_256 = 'SHA-256'\n    SHA_384 = 'SHA-384'\n    SHA_512 = 'SHA-512'\n    SHA3_224 = 'SHA3-224'\n    SHA3_256 = 'SHA3-256'\n    SHA3_384 = 'SHA3-384'\n    SHA3_512 = 'SHA3-512'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm.SHA3_224","title":"<code>SHA3_224 = 'SHA3-224'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm.SHA3_256","title":"<code>SHA3_256 = 'SHA3-256'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm.SHA3_384","title":"<code>SHA3_384 = 'SHA3-384'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm.SHA3_512","title":"<code>SHA3_512 = 'SHA3-512'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm.SHA_224","title":"<code>SHA_224 = 'SHA-224'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm.SHA_256","title":"<code>SHA_256 = 'SHA-256'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm.SHA_384","title":"<code>SHA_384 = 'SHA-384'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Algorithm.SHA_512","title":"<code>SHA_512 = 'SHA-512'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentAssets","title":"<code>AssessmentAssets</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies the assets used to perform this assessment, such as the assessment team, scanning tools, and assumptions.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AssessmentAssets(OscalBaseModel):\n    \"\"\"\n    Identifies the assets used to perform this assessment, such as the assessment team, scanning tools, and assumptions.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    components: Optional[List[SystemComponent]] = Field(None)\n    assessment_platforms: List[AssessmentPlatform] = Field(..., alias='assessment-platforms')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentAssets-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentAssets.assessment_platforms","title":"<code>assessment_platforms: List[AssessmentPlatform] = Field(..., alias='assessment-platforms')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentAssets.components","title":"<code>components: Optional[List[SystemComponent]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentAssets-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentAssets.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart","title":"<code>AssessmentPart</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A partition of an assessment plan or results or a child of another part.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AssessmentPart(OscalBaseModel):\n    \"\"\"\n    A partition of an assessment plan or results or a child of another part.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this part elsewhere in this or other OSCAL instances. The locally defined UUID of the part can be used to reference the data item locally or globally (e.g., in an ported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Part Identifier'\n    )\n    name: Union[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ),\n                Name] = Field(\n                    ...,\n                    description=\"A textual label that uniquely identifies the part's semantic type.\",\n                    title='Part Name'\n                )\n    ns: Optional[AnyUrl] = Field(\n        None,\n        description=\n        \"A namespace qualifying the part's name. This allows different organizations to associate distinct semantics with the same name.\",\n        title='Part Namespace'\n    )\n    class_: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='class',\n        description=\n        \"A textual label that provides a sub-type or characterization of the part's name. This can be used to further distinguish or discriminate between the semantics of multiple parts of the same control with the same name and ns.\",\n        title='Part Class'\n    )\n    title: Optional[str] = Field(\n        None,\n        description='A name given to the part, which may be used by a tool for display and navigation.',\n        title='Part Title'\n    )\n    props: Optional[List[Property]] = Field(None)\n    prose: Optional[str] = Field(None, description='Permits multiple paragraphs, lists, tables etc.', title='Part Text')\n    parts: Optional[List[AssessmentPart]] = None\n    links: Optional[List[Link]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.class_","title":"<code>class_: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='class', description=\"A textual label that provides a sub-type or characterization of the part's name. This can be used to further distinguish or discriminate between the semantics of multiple parts of the same control with the same name and ns.\", title='Part Class')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.name","title":"<code>name: Union[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$'), Name] = Field(..., description=\"A textual label that uniquely identifies the part's semantic type.\", title='Part Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.ns","title":"<code>ns: Optional[AnyUrl] = Field(None, description=\"A namespace qualifying the part's name. This allows different organizations to associate distinct semantics with the same name.\", title='Part Namespace')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.parts","title":"<code>parts: Optional[List[AssessmentPart]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.prose","title":"<code>prose: Optional[str] = Field(None, description='Permits multiple paragraphs, lists, tables etc.', title='Part Text')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.title","title":"<code>title: Optional[str] = Field(None, description='A name given to the part, which may be used by a tool for display and navigation.', title='Part Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.uuid","title":"<code>uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this part elsewhere in this or other OSCAL instances. The locally defined UUID of the part can be used to reference the data item locally or globally (e.g., in an ported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Part Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPart.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform","title":"<code>AssessmentPlatform</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to represent the toolset used to perform aspects of the assessment.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AssessmentPlatform(OscalBaseModel):\n    \"\"\"\n    Used to represent the toolset used to perform aspects of the assessment.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment platform elsewhere in this or other OSCAL instances. The locally defined UUID of the assessment platform can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Assessment Platform Universally Unique Identifier',\n    )\n    title: Optional[str] = Field(\n        None, description='The title or name for the assessment platform.', title='Assessment Platform Title'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    uses_components: Optional[List[UsesComponent]] = Field(None, alias='uses-components')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform.title","title":"<code>title: Optional[str] = Field(None, description='The title or name for the assessment platform.', title='Assessment Platform Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform.uses_components","title":"<code>uses_components: Optional[List[UsesComponent]] = Field(None, alias='uses-components')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this assessment platform elsewhere in this or other OSCAL instances. The locally defined UUID of the assessment platform can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Assessment Platform Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentPlatform.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject","title":"<code>AssessmentSubject</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies system elements being assessed, such as components, inventory items, and locations. In the assessment plan, this identifies a planned assessment subject. In the assessment results this is an actual assessment subject, and reflects any changes from the plan. exactly what will be the focus of this assessment. Any subjects not identified in this way are out-of-scope.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AssessmentSubject(OscalBaseModel):\n    \"\"\"\n    Identifies system elements being assessed, such as components, inventory items, and locations. In the assessment plan, this identifies a planned assessment subject. In the assessment results this is an actual assessment subject, and reflects any changes from the plan. exactly what will be the focus of this assessment. Any subjects not identified in this way are out-of-scope.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    type: Union[TokenDatatype, AssessmentSubjectValidValues] = Field(\n        ...,\n        description=\n        'Indicates the type of assessment subject, such as a component, inventory, item, location, or party represented by this selection statement.',\n        title='Subject Type'\n    )\n    description: Optional[str] = Field(\n        None,\n        description='A human-readable description of the collection of subjects being included in this assessment.',\n        title='Include Subjects Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    include_all: Optional[IncludeAll] = Field(None, alias='include-all')\n    include_subjects: Optional[List[SelectSubjectById]] = Field(None, alias='include-subjects')\n    exclude_subjects: Optional[List[SelectSubjectById]] = Field(None, alias='exclude-subjects')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject.description","title":"<code>description: Optional[str] = Field(None, description='A human-readable description of the collection of subjects being included in this assessment.', title='Include Subjects Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject.exclude_subjects","title":"<code>exclude_subjects: Optional[List[SelectSubjectById]] = Field(None, alias='exclude-subjects')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject.include_all","title":"<code>include_all: Optional[IncludeAll] = Field(None, alias='include-all')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject.include_subjects","title":"<code>include_subjects: Optional[List[SelectSubjectById]] = Field(None, alias='include-subjects')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject.type","title":"<code>type: Union[TokenDatatype, AssessmentSubjectValidValues] = Field(..., description='Indicates the type of assessment subject, such as a component, inventory, item, location, or party represented by this selection statement.', title='Subject Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubject.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder","title":"<code>AssessmentSubjectPlaceholder</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used when the assessment subjects will be determined as part of one or more other assessment activities. These assessment subjects will be recorded in the assessment results in the assessment log.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AssessmentSubjectPlaceholder(OscalBaseModel):\n    \"\"\"\n    Used when the assessment subjects will be determined as part of one or more other assessment activities. These assessment subjects will be recorded in the assessment results in the assessment log.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier for a set of assessment subjects that will be identified by a task or an activity that is part of a task. The locally defined UUID of the assessment subject placeholder can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Assessment Subject Placeholder Universally Unique Identifier',\n    )\n    description: Optional[str] = Field(\n        None,\n        description='A human-readable description of intent of this assessment subject placeholder.',\n        title='Assessment Subject Placeholder Description'\n    )\n    sources: List[Source] = Field(...)\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder.description","title":"<code>description: Optional[str] = Field(None, description='A human-readable description of intent of this assessment subject placeholder.', title='Assessment Subject Placeholder Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder.sources","title":"<code>sources: List[Source] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier for a set of assessment subjects that will be identified by a task or an activity that is part of a task. The locally defined UUID of the assessment subject placeholder can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Assessment Subject Placeholder Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectPlaceholder.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectValidValues","title":"<code>AssessmentSubjectValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AssessmentSubjectValidValues(Enum):\n    component = 'component'\n    inventory_item = 'inventory-item'\n    location = 'location'\n    party = 'party'\n    user = 'user'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectValidValues.component","title":"<code>component = 'component'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectValidValues.inventory_item","title":"<code>inventory_item = 'inventory-item'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectValidValues.location","title":"<code>location = 'location'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectValidValues.party","title":"<code>party = 'party'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssessmentSubjectValidValues.user","title":"<code>user = 'user'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity","title":"<code>AssociatedActivity</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies an individual activity to be performed as part of a task.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AssociatedActivity(OscalBaseModel):\n    \"\"\"\n    Identifies an individual activity to be performed as part of a task.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    activity_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='activity-uuid',\n        description='A machine-oriented identifier reference to an activity defined in the list of activities.',\n        title='Activity Universally Unique Identifier Reference'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')\n    subjects: List[AssessmentSubject] = Field(...)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity.activity_uuid","title":"<code>activity_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='activity-uuid', description='A machine-oriented identifier reference to an activity defined in the list of activities.', title='Activity Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity.responsible_roles","title":"<code>responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity.subjects","title":"<code>subjects: List[AssessmentSubject] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AssociatedActivity.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AtFrequency","title":"<code>AtFrequency</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The task is intended to occur at the specified frequency.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AtFrequency(OscalBaseModel):\n    \"\"\"\n    The task is intended to occur at the specified frequency.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    period: conint(\n        ge=1, multiple_of=1\n    ) = Field(..., description='The task must occur after the specified period has elapsed.', title='Period')\n    unit: TimeUnitValidValues = Field(..., description='The unit of time for the period.', title='Time Unit')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AtFrequency-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AtFrequency.period","title":"<code>period: conint(ge=1, multiple_of=1) = Field(..., description='The task must occur after the specified period has elapsed.', title='Period')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AtFrequency.unit","title":"<code>unit: TimeUnitValidValues = Field(..., description='The unit of time for the period.', title='Time Unit')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AtFrequency-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AtFrequency.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AuthorizedPrivilege","title":"<code>AuthorizedPrivilege</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies a specific system privilege held by the user, along with an associated description and/or rationale for the privilege.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class AuthorizedPrivilege(OscalBaseModel):\n    \"\"\"\n    Identifies a specific system privilege held by the user, along with an associated description and/or rationale for the privilege.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    title: str = Field(..., description='A human readable name for the privilege.', title='Privilege Title')\n    description: Optional[str] = Field(\n        None, description=\"A summary of the privilege's purpose within the system.\", title='Privilege Description'\n    )\n    functions_performed: List[constr(regex=r'^\\S(.*\\S)?$')] = Field(..., alias='functions-performed')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AuthorizedPrivilege-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AuthorizedPrivilege.description","title":"<code>description: Optional[str] = Field(None, description=\"A summary of the privilege's purpose within the system.\", title='Privilege Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AuthorizedPrivilege.functions_performed","title":"<code>functions_performed: List[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(..., alias='functions-performed')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AuthorizedPrivilege.title","title":"<code>title: str = Field(..., description='A human readable name for the privilege.', title='Privilege Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AuthorizedPrivilege-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.AuthorizedPrivilege.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.BackMatter","title":"<code>BackMatter</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A collection of resources that may be referenced from within the OSCAL document instance.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class BackMatter(OscalBaseModel):\n    \"\"\"\n    A collection of resources that may be referenced from within the OSCAL document instance.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    resources: Optional[List[Resource]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.BackMatter-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.BackMatter.resources","title":"<code>resources: Optional[List[Resource]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.BackMatter-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.BackMatter.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64","title":"<code>Base64</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A resource encoded using the Base64 alphabet defined by RFC 2045.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Base64(OscalBaseModel):\n    \"\"\"\n    A resource encoded using the Base64 alphabet defined by RFC 2045.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    filename: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        description=\n        'Name of the file before it was encoded as Base64 to be embedded in a resource. This is the name that will be assigned to the file when the file is decoded.',\n        title='File Name'\n    )\n    media_type: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        alias='media-type',\n        description='A label that indicates the nature of a resource, as a data serialization or format.',\n        title='Media Type'\n    )\n    value: constr(regex=r'^[0-9A-Za-z+/]+={0,2}$')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64.filename","title":"<code>filename: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, description='Name of the file before it was encoded as Base64 to be embedded in a resource. This is the name that will be assigned to the file when the file is decoded.', title='File Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64.media_type","title":"<code>media_type: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='media-type', description='A label that indicates the nature of a resource, as a data serialization or format.', title='Media Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64.value","title":"<code>value: constr(regex='^[0-9A-Za-z+/]+={0,2}$')</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64Datatype","title":"<code>Base64Datatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Base64Datatype(OscalBaseModel):\n    __root__: constr(\n        regex=r'^[0-9A-Za-z+/]+={0,2}$'\n    ) = Field(..., description='Binary data encoded using the Base 64 encoding algorithm as defined by RFC4648.')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64Datatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Base64Datatype.__root__","title":"<code>__root__: constr(regex='^[0-9A-Za-z+/]+={0,2}$') = Field(..., description='Binary data encoded using the Base 64 encoding algorithm as defined by RFC4648.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Characterization","title":"<code>Characterization</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A collection of descriptive data about the containing object from a specific origin.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Characterization(OscalBaseModel):\n    \"\"\"\n    A collection of descriptive data about the containing object from a specific origin.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    origin: Origin\n    facets: List[Facet] = Field(...)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Characterization-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Characterization.facets","title":"<code>facets: List[Facet] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Characterization.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Characterization.origin","title":"<code>origin: Origin</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Characterization.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Characterization-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Characterization.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Citation","title":"<code>Citation</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An optional citation consisting of end note text using structured markup.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Citation(OscalBaseModel):\n    \"\"\"\n    An optional citation consisting of end note text using structured markup.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    text: str = Field(..., description='A line of citation text.', title='Citation Text')\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Citation-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Citation.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Citation.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Citation.text","title":"<code>text: str = Field(..., description='A line of citation text.', title='Citation Text')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Citation-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Citation.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection","title":"<code>ControlObjectiveSelection</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies the control objectives of the assessment. In the assessment plan, these are the planned objectives. In the assessment results, these are the assessed objectives, and reflects any changes from the plan.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ControlObjectiveSelection(OscalBaseModel):\n    \"\"\"\n    Identifies the control objectives of the assessment. In the assessment plan, these are the planned objectives. In the assessment results, these are the assessed objectives, and reflects any changes from the plan.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    description: Optional[str] = Field(\n        None,\n        description='A human-readable description of this collection of control objectives.',\n        title='Control Objectives Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    include_all: Optional[IncludeAll] = Field(None, alias='include-all')\n    include_objectives: Optional[List[SelectObjectiveById]] = Field(None, alias='include-objectives')\n    exclude_objectives: Optional[List[SelectObjectiveById]] = Field(None, alias='exclude-objectives')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection.description","title":"<code>description: Optional[str] = Field(None, description='A human-readable description of this collection of control objectives.', title='Control Objectives Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection.exclude_objectives","title":"<code>exclude_objectives: Optional[List[SelectObjectiveById]] = Field(None, alias='exclude-objectives')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection.include_all","title":"<code>include_all: Optional[IncludeAll] = Field(None, alias='include-all')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection.include_objectives","title":"<code>include_objectives: Optional[List[SelectObjectiveById]] = Field(None, alias='include-objectives')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlObjectiveSelection.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection","title":"<code>ControlSelection</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies the controls being assessed. In the assessment plan, these are the planned controls. In the assessment results, these are the actual controls, and reflects any changes from the plan.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ControlSelection(OscalBaseModel):\n    \"\"\"\n    Identifies the controls being assessed. In the assessment plan, these are the planned controls. In the assessment results, these are the actual controls, and reflects any changes from the plan.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    description: Optional[str] = Field(\n        None,\n        description='A human-readable description of in-scope controls specified for assessment.',\n        title='Assessed Controls Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    include_all: Optional[IncludeAll] = Field(None, alias='include-all')\n    include_controls: Optional[List[SelectControlById]] = Field(None, alias='include-controls')\n    exclude_controls: Optional[List[SelectControlById]] = Field(None, alias='exclude-controls')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection.description","title":"<code>description: Optional[str] = Field(None, description='A human-readable description of in-scope controls specified for assessment.', title='Assessed Controls Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection.exclude_controls","title":"<code>exclude_controls: Optional[List[SelectControlById]] = Field(None, alias='exclude-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection.include_all","title":"<code>include_all: Optional[IncludeAll] = Field(None, alias='include-all')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection.include_controls","title":"<code>include_controls: Optional[List[SelectControlById]] = Field(None, alias='include-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ControlSelection.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DateTimeWithTimezoneDatatype","title":"<code>DateTimeWithTimezoneDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class DateTimeWithTimezoneDatatype(OscalBaseModel):\n    __root__: datetime = Field(..., description='A string representing a point in time with a required timezone.')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DateTimeWithTimezoneDatatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DateTimeWithTimezoneDatatype.__root__","title":"<code>__root__: datetime = Field(..., description='A string representing a point in time with a required timezone.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Dependency","title":"<code>Dependency</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to indicate that a task is dependent on another task.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Dependency(OscalBaseModel):\n    \"\"\"\n    Used to indicate that a task is dependent on another task.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    task_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='task-uuid',\n        description='A machine-oriented identifier reference to a unique task.',\n        title='Task Universally Unique Identifier Reference'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Dependency-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Dependency.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Dependency.task_uuid","title":"<code>task_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='task-uuid', description='A machine-oriented identifier reference to a unique task.', title='Task Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Dependency-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Dependency.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DocumentId","title":"<code>DocumentId</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A document identifier qualified by an identifier scheme.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class DocumentId(OscalBaseModel):\n    \"\"\"\n    A document identifier qualified by an identifier scheme.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    scheme: Optional[Union[URIDatatype, DocumentSchemeValidValues]] = Field(\n        None,\n        description=\n        'Qualifies the kind of document identifier using a URI. If the scheme is not provided the value of the element will be interpreted as a string of characters.',\n        title='Document Identification Scheme'\n    )\n    identifier: constr(regex=r'^\\S(.*\\S)?$')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DocumentId-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DocumentId.identifier","title":"<code>identifier: constr(regex='^\\\\S(.*\\\\S)?$')</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DocumentId.scheme","title":"<code>scheme: Optional[Union[URIDatatype, DocumentSchemeValidValues]] = Field(None, description='Qualifies the kind of document identifier using a URI. If the scheme is not provided the value of the element will be interpreted as a string of characters.', title='Document Identification Scheme')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DocumentId-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DocumentId.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DocumentSchemeValidValues","title":"<code>DocumentSchemeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class DocumentSchemeValidValues(Enum):\n    http___www_doi_org_ = 'http://www.doi.org/'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DocumentSchemeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.DocumentSchemeValidValues.http___www_doi_org_","title":"<code>http___www_doi_org_ = 'http://www.doi.org/'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.EmailAddress","title":"<code>EmailAddress</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class EmailAddress(OscalBaseModel):\n    __root__: EmailStr = Field(\n        ..., description='An email address as defined by RFC 5322 Section 3.4.1.', title='Email Address'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.EmailAddress-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.EmailAddress.__root__","title":"<code>__root__: EmailStr = Field(..., description='An email address as defined by RFC 5322 Section 3.4.1.', title='Email Address')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.EmailAddressDatatype","title":"<code>EmailAddressDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An email address string formatted according to RFC 6531.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class EmailAddressDatatype(OscalBaseModel):\n    \"\"\"\n    An email address string formatted according to RFC 6531.\n    \"\"\"\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry","title":"<code>Entry</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies an individual risk response that occurred as part of managing an identified risk.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Entry(OscalBaseModel):\n    \"\"\"\n    Identifies an individual risk response that occurred as part of managing an identified risk.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this risk log entry elsewhere in this or other OSCAL instances. The locally defined UUID of the risk log entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Risk Log Entry Universally Unique Identifier',\n    )\n    title: Optional[str] = Field(None, description='The title for this risk log entry.', title='Title')\n    description: Optional[str] = Field(\n        None,\n        description='A human-readable description of what was done regarding the risk.',\n        title='Risk Task Description'\n    )\n    start: datetime = Field(..., description='Identifies the start date and time of the event.', title='Start')\n    end: Optional[datetime] = Field(\n        None,\n        description=\n        'Identifies the end date and time of the event. If the event is a point in time, the start and end will be the same date and time.',\n        title='End'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    logged_by: Optional[List[LoggedBy]] = Field(None, alias='logged-by')\n    status_change: Optional[RiskStatus] = Field(None, alias='status-change')\n    related_responses: Optional[List[RelatedResponse]] = Field(None, alias='related-responses')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.description","title":"<code>description: Optional[str] = Field(None, description='A human-readable description of what was done regarding the risk.', title='Risk Task Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.end","title":"<code>end: Optional[datetime] = Field(None, description='Identifies the end date and time of the event. If the event is a point in time, the start and end will be the same date and time.', title='End')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.logged_by","title":"<code>logged_by: Optional[List[LoggedBy]] = Field(None, alias='logged-by')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.related_responses","title":"<code>related_responses: Optional[List[RelatedResponse]] = Field(None, alias='related-responses')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.start","title":"<code>start: datetime = Field(..., description='Identifies the start date and time of the event.', title='Start')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.status_change","title":"<code>status_change: Optional[RiskStatus] = Field(None, alias='status-change')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.title","title":"<code>title: Optional[str] = Field(None, description='The title for this risk log entry.', title='Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this risk log entry elsewhere in this or other OSCAL instances. The locally defined UUID of the risk log entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Risk Log Entry Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Entry.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ExternalId","title":"<code>ExternalId</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An identifier for a person or organization using a designated scheme. e.g. an Open Researcher and Contributor ID (ORCID).</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ExternalId(OscalBaseModel):\n    \"\"\"\n    An identifier for a person or organization using a designated scheme. e.g. an Open Researcher and Contributor ID (ORCID).\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    scheme: Union[URIDatatype, ExternalSchemeValidValues] = Field(\n        ..., description='Indicates the type of external identifier.', title='External Identifier Schema'\n    )\n    id: constr(regex=r'^\\S(.*\\S)?$')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ExternalId-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ExternalId.id","title":"<code>id: constr(regex='^\\\\S(.*\\\\S)?$')</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ExternalId.scheme","title":"<code>scheme: Union[URIDatatype, ExternalSchemeValidValues] = Field(..., description='Indicates the type of external identifier.', title='External Identifier Schema')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ExternalId-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ExternalId.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ExternalSchemeValidValues","title":"<code>ExternalSchemeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ExternalSchemeValidValues(Enum):\n    http___orcid_org_ = 'http://orcid.org/'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ExternalSchemeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ExternalSchemeValidValues.http___orcid_org_","title":"<code>http___orcid_org_ = 'http://orcid.org/'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet","title":"<code>Facet</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An individual characteristic that is part of a larger set produced by the same actor.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Facet(OscalBaseModel):\n    \"\"\"\n    An individual characteristic that is part of a larger set produced by the same actor.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    name: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(..., description='The name of the risk metric within the specified system.', title='Facet Name')\n    system: Union[URIDatatype, NamingSystemValidValues] = Field(\n        ...,\n        description=\n        'Specifies the naming system under which this risk metric is organized, which allows for the same names to be used in different systems controlled by different parties. This avoids the potential of a name clash.',\n        title='Naming System'\n    )\n    value: constr(regex=r'^\\S(.*\\S)?$'\n                  ) = Field(..., description='Indicates the value of the facet.', title='Facet Value')\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet.name","title":"<code>name: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., description='The name of the risk metric within the specified system.', title='Facet Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet.system","title":"<code>system: Union[URIDatatype, NamingSystemValidValues] = Field(..., description='Specifies the naming system under which this risk metric is organized, which allows for the same names to be used in different systems controlled by different parties. This avoids the potential of a name clash.', title='Naming System')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet.value","title":"<code>value: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description='Indicates the value of the facet.', title='Facet Value')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Facet.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding","title":"<code>Finding</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes an individual finding.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Finding(OscalBaseModel):\n    \"\"\"\n    Describes an individual finding.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this finding in this or other OSCAL instances. The locally defined UUID of the finding can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Finding Universally Unique Identifier',\n    )\n    title: str = Field(..., description='The title for this finding.', title='Finding Title')\n    description: str = Field(\n        ..., description='A human-readable description of this finding.', title='Finding Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    origins: Optional[List[Origin]] = Field(None)\n    target: FindingTarget\n    implementation_statement_uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None,\n        alias='implementation-statement-uuid',\n        description=\n        'A machine-oriented identifier reference to the implementation statement in the SSP to which this finding is related.',\n        title='Implementation Statement UUID'\n    )\n    related_observations: Optional[List[RelatedObservation]] = Field(None, alias='related-observations')\n    related_risks: Optional[List[RelatedRisk]] = Field(None, alias='related-risks')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.description","title":"<code>description: str = Field(..., description='A human-readable description of this finding.', title='Finding Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.implementation_statement_uuid","title":"<code>implementation_statement_uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, alias='implementation-statement-uuid', description='A machine-oriented identifier reference to the implementation statement in the SSP to which this finding is related.', title='Implementation Statement UUID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.origins","title":"<code>origins: Optional[List[Origin]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.related_observations","title":"<code>related_observations: Optional[List[RelatedObservation]] = Field(None, alias='related-observations')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.related_risks","title":"<code>related_risks: Optional[List[RelatedRisk]] = Field(None, alias='related-risks')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.target","title":"<code>target: FindingTarget</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.title","title":"<code>title: str = Field(..., description='The title for this finding.', title='Finding Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this finding in this or other OSCAL instances. The locally defined UUID of the finding can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Finding Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Finding.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget","title":"<code>FindingTarget</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Captures an assessor's conclusions regarding the degree to which an objective is satisfied.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class FindingTarget(OscalBaseModel):\n    \"\"\"\n    Captures an assessor's conclusions regarding the degree to which an objective is satisfied.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    type: FindingTargetTypeValidValues = Field(\n        ..., description='Identifies the type of the target.', title='Finding Target Type'\n    )\n    target_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='target-id',\n        description='A machine-oriented identifier reference for a specific target qualified by the type.',\n        title='Finding Target Identifier Reference'\n    )\n    title: Optional[str] = Field(\n        None, description='The title for this objective status.', title='Objective Status Title'\n    )\n    description: Optional[str] = Field(\n        None,\n        description=\n        \"A human-readable description of the assessor's conclusions regarding the degree to which an objective is satisfied.\",\n        title='Objective Status Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    implementation_status: Optional[ImplementationStatus] = Field(None, alias='implementation-status')\n    remarks: Optional[str] = None\n    status: Optional[ObjectiveStatus] = Field(\n        None,\n        description='A determination of if the objective is satisfied or not within a given system.',\n        title='Objective Status'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.description","title":"<code>description: Optional[str] = Field(None, description=\"A human-readable description of the assessor's conclusions regarding the degree to which an objective is satisfied.\", title='Objective Status Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.implementation_status","title":"<code>implementation_status: Optional[ImplementationStatus] = Field(None, alias='implementation-status')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.status","title":"<code>status: Optional[ObjectiveStatus] = Field(None, description='A determination of if the objective is satisfied or not within a given system.', title='Objective Status')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.target_id","title":"<code>target_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='target-id', description='A machine-oriented identifier reference for a specific target qualified by the type.', title='Finding Target Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.title","title":"<code>title: Optional[str] = Field(None, description='The title for this objective status.', title='Objective Status Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.type","title":"<code>type: FindingTargetTypeValidValues = Field(..., description='Identifies the type of the target.', title='Finding Target Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTarget.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTargetTypeValidValues","title":"<code>FindingTargetTypeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class FindingTargetTypeValidValues(Enum):\n    statement_id = 'statement-id'\n    objective_id = 'objective-id'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTargetTypeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTargetTypeValidValues.objective_id","title":"<code>objective_id = 'objective-id'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FindingTargetTypeValidValues.statement_id","title":"<code>statement_id = 'statement-id'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FunctionPerformed","title":"<code>FunctionPerformed</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class FunctionPerformed(OscalBaseModel):\n    __root__: StringDatatype = Field(\n        ...,\n        description='Describes a function performed for a given authorized privilege by this user class.',\n        title='Functions Performed'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FunctionPerformed-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.FunctionPerformed.__root__","title":"<code>__root__: StringDatatype = Field(..., description='Describes a function performed for a given authorized privilege by this user class.', title='Functions Performed')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Hash","title":"<code>Hash</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A representation of a cryptographic digest generated over a resource using a specified hash algorithm.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Hash(OscalBaseModel):\n    \"\"\"\n    A representation of a cryptographic digest generated over a resource using a specified hash algorithm.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    algorithm: Union[constr(regex=r'^\\S(.*\\S)?$'), Algorithm] = Field(\n        ..., description='The digest method by which a hash is derived.', title='Hash algorithm'\n    )\n    value: constr(regex=r'^\\S(.*\\S)?$')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Hash-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Hash.algorithm","title":"<code>algorithm: Union[constr(regex='^\\\\S(.*\\\\S)?$'), Algorithm] = Field(..., description='The digest method by which a hash is derived.', title='Hash algorithm')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Hash.value","title":"<code>value: constr(regex='^\\\\S(.*\\\\S)?$')</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Hash-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Hash.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.HowManyValidValues","title":"<code>HowManyValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class HowManyValidValues(Enum):\n    one = 'one'\n    one_or_more = 'one-or-more'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.HowManyValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.HowManyValidValues.one","title":"<code>one = 'one'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.HowManyValidValues.one_or_more","title":"<code>one_or_more = 'one-or-more'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifiedSubject","title":"<code>IdentifiedSubject</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to detail assessment subjects that were identfied by this task.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class IdentifiedSubject(OscalBaseModel):\n    \"\"\"\n    Used to detail assessment subjects that were identfied by this task.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    subject_placeholder_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='subject-placeholder-uuid',\n        description=\n        'A machine-oriented identifier reference to a unique assessment subject placeholder defined by this task.',\n        title='Assessment Subject Placeholder Universally Unique Identifier Reference'\n    )\n    subjects: List[AssessmentSubject] = Field(...)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifiedSubject-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifiedSubject.subject_placeholder_uuid","title":"<code>subject_placeholder_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='subject-placeholder-uuid', description='A machine-oriented identifier reference to a unique assessment subject placeholder defined by this task.', title='Assessment Subject Placeholder Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifiedSubject.subjects","title":"<code>subjects: List[AssessmentSubject] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifiedSubject-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifiedSubject.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifierType","title":"<code>IdentifierType</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Identifies the identification system from which the provided identifier was assigned.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class IdentifierType(Enum):\n    \"\"\"\n    Identifies the identification system from which the provided identifier was assigned.\n    \"\"\"\n\n    https___fedramp_gov = 'https://fedramp.gov'\n    http___fedramp_gov_ns_oscal = 'http://fedramp.gov/ns/oscal'\n    https___ietf_org_rfc_rfc4122 = 'https://ietf.org/rfc/rfc4122'\n    http___ietf_org_rfc_rfc4122 = 'http://ietf.org/rfc/rfc4122'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifierType-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifierType.http___fedramp_gov_ns_oscal","title":"<code>http___fedramp_gov_ns_oscal = 'http://fedramp.gov/ns/oscal'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifierType.http___ietf_org_rfc_rfc4122","title":"<code>http___ietf_org_rfc_rfc4122 = 'http://ietf.org/rfc/rfc4122'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifierType.https___fedramp_gov","title":"<code>https___fedramp_gov = 'https://fedramp.gov'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IdentifierType.https___ietf_org_rfc_rfc4122","title":"<code>https___ietf_org_rfc_rfc4122 = 'https://ietf.org/rfc/rfc4122'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementationStatus","title":"<code>ImplementationStatus</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Indicates the degree to which the a given control is implemented.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ImplementationStatus(OscalBaseModel):\n    \"\"\"\n    Indicates the degree to which the a given control is implemented.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    state: Union[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ),\n                 State] = Field(\n                     ...,\n                     description='Identifies the implementation status of the control or control objective.',\n                     title='Implementation State'\n                 )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementationStatus-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementationStatus.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementationStatus.state","title":"<code>state: Union[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$'), State] = Field(..., description='Identifies the implementation status of the control or control objective.', title='Implementation State')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementationStatus-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementationStatus.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementedComponent","title":"<code>ImplementedComponent</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The set of components that are implemented in a given system inventory item.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ImplementedComponent(OscalBaseModel):\n    \"\"\"\n    The set of components that are implemented in a given system inventory item.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    component_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='component-uuid',\n        description=\n        'A machine-oriented identifier reference to a component that is implemented as part of an inventory item.',\n        title='Component Universally Unique Identifier Reference'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementedComponent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementedComponent.component_uuid","title":"<code>component_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='component-uuid', description='A machine-oriented identifier reference to a component that is implemented as part of an inventory item.', title='Component Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementedComponent.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementedComponent.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementedComponent.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementedComponent.responsible_parties","title":"<code>responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementedComponent-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImplementedComponent.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImportSsp","title":"<code>ImportSsp</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used by the assessment plan and POA&amp;M to import information about the system.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ImportSsp(OscalBaseModel):\n    \"\"\"\n    Used by the assessment plan and POA&amp;M to import information about the system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    href: str = Field(\n        ...,\n        description='A resolvable URL reference to the system security plan for the system being assessed.',\n        title='System Security Plan Reference'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImportSsp-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImportSsp.href","title":"<code>href: str = Field(..., description='A resolvable URL reference to the system security plan for the system being assessed.', title='System Security Plan Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImportSsp.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImportSsp-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ImportSsp.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IncludeAll","title":"<code>IncludeAll</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Include all controls from the imported catalog or profile resources.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class IncludeAll(OscalBaseModel):\n    \"\"\"\n    Include all controls from the imported catalog or profile resources.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IncludeAll-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IncludeAll.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IntegerDatatype","title":"<code>IntegerDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class IntegerDatatype(OscalBaseModel):\n    __root__: int = Field(..., description='A whole number value.')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IntegerDatatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.IntegerDatatype.__root__","title":"<code>__root__: int = Field(..., description='A whole number value.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem","title":"<code>InventoryItem</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A single managed inventory item within the system.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class InventoryItem(OscalBaseModel):\n    \"\"\"\n    A single managed inventory item within the system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this inventory item elsewhere in this or other OSCAL instances. The locally defined UUID of the inventory item can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Inventory Item Universally Unique Identifier',\n    )\n    description: str = Field(\n        ...,\n        description='A summary of the inventory item stating its purpose within the system.',\n        title='Inventory Item Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')\n    implemented_components: Optional[List[ImplementedComponent]] = Field(None, alias='implemented-components')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem.description","title":"<code>description: str = Field(..., description='A summary of the inventory item stating its purpose within the system.', title='Inventory Item Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem.implemented_components","title":"<code>implemented_components: Optional[List[ImplementedComponent]] = Field(None, alias='implemented-components')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem.responsible_parties","title":"<code>responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this inventory item elsewhere in this or other OSCAL instances. The locally defined UUID of the inventory item can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Inventory Item Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.InventoryItem.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.JsonSchemaDirective","title":"<code>JsonSchemaDirective</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class JsonSchemaDirective(OscalBaseModel):\n    __root__: URIReferenceDatatype = Field(\n        ...,\n        description='A JSON Schema directive to bind a specific schema to its document instance.',\n        title='Schema Directive'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.JsonSchemaDirective-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.JsonSchemaDirective.__root__","title":"<code>__root__: URIReferenceDatatype = Field(..., description='A JSON Schema directive to bind a specific schema to its document instance.', title='Schema Directive')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LastModified","title":"<code>LastModified</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class LastModified(OscalBaseModel):\n    __root__: DateTimeWithTimezoneDatatype = Field(\n        ...,\n        description='The date and time the document was last stored for later retrieval.',\n        title='Last Modified Timestamp'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LastModified-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LastModified.__root__","title":"<code>__root__: DateTimeWithTimezoneDatatype = Field(..., description='The date and time the document was last stored for later retrieval.', title='Last Modified Timestamp')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Lifecycle","title":"<code>Lifecycle</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Identifies whether this is a recommendation, such as from an assessor or tool, or an actual plan accepted by the system owner.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Lifecycle(Enum):\n    \"\"\"\n    Identifies whether this is a recommendation, such as from an assessor or tool, or an actual plan accepted by the system owner.\n    \"\"\"\n\n    recommendation = 'recommendation'\n    planned = 'planned'\n    completed = 'completed'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Lifecycle-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Lifecycle.completed","title":"<code>completed = 'completed'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Lifecycle.planned","title":"<code>planned = 'planned'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Lifecycle.recommendation","title":"<code>recommendation = 'recommendation'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Link","title":"<code>Link</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A reference to a local or remote resource, that has a specific relation to the containing object.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Link(OscalBaseModel):\n    \"\"\"\n    A reference to a local or remote resource, that has a specific relation to the containing object.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    href: str = Field(..., description='A resolvable URL reference to a resource.', title='Hypertext Reference')\n    rel: Optional[\n        Union[constr(\n            regex=\n            r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n        ),\n              Rel]\n    ] = Field(\n        None,\n        description=\n        \"Describes the type of relationship provided by the link's hypertext reference. This can be an indicator of the link's purpose.\",\n        title='Link Relation Type'\n    )\n    media_type: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        alias='media-type',\n        description='A label that indicates the nature of a resource, as a data serialization or format.',\n        title='Media Type'\n    )\n    resource_fragment: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        alias='resource-fragment',\n        description=\n        'In case where the href points to a back-matter/resource, this value will indicate the URI fragment to append to any rlink associated with the resource. This value MUST be URI encoded.',\n        title='Resource Fragment'\n    )\n    text: Optional[str] = Field(\n        None,\n        description='A textual label to associate with the link, which may be used for presentation in a tool.',\n        title='Link Text'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Link-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Link.href","title":"<code>href: str = Field(..., description='A resolvable URL reference to a resource.', title='Hypertext Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Link.media_type","title":"<code>media_type: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='media-type', description='A label that indicates the nature of a resource, as a data serialization or format.', title='Media Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Link.rel","title":"<code>rel: Optional[Union[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$'), Rel]] = Field(None, description=\"Describes the type of relationship provided by the link's hypertext reference. This can be an indicator of the link's purpose.\", title='Link Relation Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Link.resource_fragment","title":"<code>resource_fragment: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='resource-fragment', description='In case where the href points to a back-matter/resource, this value will indicate the URI fragment to append to any rlink associated with the resource. This value MUST be URI encoded.', title='Resource Fragment')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Link.text","title":"<code>text: Optional[str] = Field(None, description='A textual label to associate with the link, which may be used for presentation in a tool.', title='Link Text')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Link-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Link.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective","title":"<code>LocalObjective</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A local definition of a control objective for this assessment. Uses catalog syntax for control objective and assessment actions.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class LocalObjective(OscalBaseModel):\n    \"\"\"\n    A local definition of a control objective for this assessment. Uses catalog syntax for control objective and assessment actions.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    control_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='control-id',\n        description=\n        'A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).',\n        title='Control Identifier Reference'\n    )\n    description: Optional[str] = Field(\n        None, description='A human-readable description of this control objective.', title='Objective Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    parts: List[Part] = Field(...)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective.control_id","title":"<code>control_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='control-id', description='A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).', title='Control Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective.description","title":"<code>description: Optional[str] = Field(None, description='A human-readable description of this control objective.', title='Objective Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective.parts","title":"<code>parts: List[Part] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocalObjective.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location","title":"<code>Location</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A physical point of presence, which may be associated with people, organizations, or other concepts within the current or linked OSCAL document.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Location(OscalBaseModel):\n    \"\"\"\n    A physical point of presence, which may be associated with people, organizations, or other concepts within the current or linked OSCAL document.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n                 ) = Field(\n                     ...,\n                     description='A unique ID for the location, for reference.',\n                     title='Location Universally Unique Identifier'\n                 )\n    title: Optional[str] = Field(\n        None,\n        description='A name given to the location, which may be used by a tool for display and navigation.',\n        title='Location Title'\n    )\n    address: Optional[Address] = None\n    email_addresses: Optional[List[EmailAddress]] = Field(None, alias='email-addresses')\n    telephone_numbers: Optional[List[TelephoneNumber]] = Field(None, alias='telephone-numbers')\n    urls: Optional[List[AnyUrl]] = Field(None)\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.address","title":"<code>address: Optional[Address] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.email_addresses","title":"<code>email_addresses: Optional[List[EmailAddress]] = Field(None, alias='email-addresses')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.telephone_numbers","title":"<code>telephone_numbers: Optional[List[TelephoneNumber]] = Field(None, alias='telephone-numbers')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.title","title":"<code>title: Optional[str] = Field(None, description='A name given to the location, which may be used by a tool for display and navigation.', title='Location Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.urls","title":"<code>urls: Optional[List[AnyUrl]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A unique ID for the location, for reference.', title='Location Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Location.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocationUuid","title":"<code>LocationUuid</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class LocationUuid(OscalBaseModel):\n    __root__: UUIDDatatype = Field(\n        ..., description='Reference to a location by UUID.', title='Location Universally Unique Identifier Reference'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocationUuid-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LocationUuid.__root__","title":"<code>__root__: UUIDDatatype = Field(..., description='Reference to a location by UUID.', title='Location Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LoggedBy","title":"<code>LoggedBy</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to indicate who created a log entry in what role.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class LoggedBy(OscalBaseModel):\n    \"\"\"\n    Used to indicate who created a log entry in what role.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    party_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='party-uuid',\n        description='A machine-oriented identifier reference to the party who is making the log entry.',\n        title='Party UUID Reference'\n    )\n    role_id: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='role-id',\n        description='A point to the role-id of the role in which the party is making the log entry.',\n        title='Actor Role'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LoggedBy-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LoggedBy.party_uuid","title":"<code>party_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='party-uuid', description='A machine-oriented identifier reference to the party who is making the log entry.', title='Party UUID Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LoggedBy.role_id","title":"<code>role_id: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='role-id', description='A point to the role-id of the role in which the party is making the log entry.', title='Actor Role')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LoggedBy-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.LoggedBy.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata","title":"<code>Metadata</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Provides information about the containing document, and defines concepts that are shared across the document.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Metadata(OscalBaseModel):\n    \"\"\"\n    Provides information about the containing document, and defines concepts that are shared across the document.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    title: str = Field(\n        ...,\n        description='A name given to the document, which may be used by a tool for display and navigation.',\n        title='Document Title'\n    )\n    published: Optional[datetime] = None\n    last_modified: datetime = Field(..., alias='last-modified')\n    version: constr(regex=r'^\\S(.*\\S)?$')\n    oscal_version: OscalVersion = Field(..., alias='oscal-version')\n    revisions: Optional[List[Revision]] = Field(None)\n    document_ids: Optional[List[DocumentId]] = Field(None, alias='document-ids')\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    roles: Optional[List[Role]] = Field(None)\n    locations: Optional[List[Location]] = Field(None)\n    parties: Optional[List[Party]] = Field(None)\n    responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')\n    actions: Optional[List[Action]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.actions","title":"<code>actions: Optional[List[Action]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.document_ids","title":"<code>document_ids: Optional[List[DocumentId]] = Field(None, alias='document-ids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.last_modified","title":"<code>last_modified: datetime = Field(..., alias='last-modified')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.locations","title":"<code>locations: Optional[List[Location]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.oscal_version","title":"<code>oscal_version: OscalVersion = Field(..., alias='oscal-version')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.parties","title":"<code>parties: Optional[List[Party]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.published","title":"<code>published: Optional[datetime] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.responsible_parties","title":"<code>responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.revisions","title":"<code>revisions: Optional[List[Revision]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.roles","title":"<code>roles: Optional[List[Role]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.title","title":"<code>title: str = Field(..., description='A name given to the document, which may be used by a tool for display and navigation.', title='Document Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.version","title":"<code>version: constr(regex='^\\\\S(.*\\\\S)?$')</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Metadata.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Methods","title":"<code>Methods</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Identifies how the observation was made.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Methods(Enum):\n    \"\"\"\n    Identifies how the observation was made.\n    \"\"\"\n\n    EXAMINE = 'EXAMINE'\n    INTERVIEW = 'INTERVIEW'\n    TEST = 'TEST'\n    UNKNOWN = 'UNKNOWN'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Methods-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Methods.EXAMINE","title":"<code>EXAMINE = 'EXAMINE'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Methods.INTERVIEW","title":"<code>INTERVIEW = 'INTERVIEW'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Methods.TEST","title":"<code>TEST = 'TEST'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Methods.UNKNOWN","title":"<code>UNKNOWN = 'UNKNOWN'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor","title":"<code>MitigatingFactor</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes an existing mitigating factor that may affect the overall determination of the risk, with an optional link to an implementation statement in the SSP.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class MitigatingFactor(OscalBaseModel):\n    \"\"\"\n    Describes an existing mitigating factor that may affect the overall determination of the risk, with an optional link to an implementation statement in the SSP.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this mitigating factor elsewhere in this or other OSCAL instances. The locally defined UUID of the mitigating factor can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Mitigating Factor Universally Unique Identifier',\n    )\n    implementation_uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None,\n        alias='implementation-uuid',\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this implementation statement elsewhere in this or other OSCAL instancess. The locally defined UUID of the implementation statement can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Implementation UUID',\n    )\n    description: str = Field(\n        ...,\n        description='A human-readable description of this mitigating factor.',\n        title='Mitigating Factor Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    subjects: Optional[List[SubjectReference]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor.description","title":"<code>description: str = Field(..., description='A human-readable description of this mitigating factor.', title='Mitigating Factor Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor.implementation_uuid","title":"<code>implementation_uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, alias='implementation-uuid', description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this implementation statement elsewhere in this or other OSCAL instancess. The locally defined UUID of the implementation statement can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Implementation UUID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor.subjects","title":"<code>subjects: Optional[List[SubjectReference]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this mitigating factor elsewhere in this or other OSCAL instances. The locally defined UUID of the mitigating factor can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Mitigating Factor Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.MitigatingFactor.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Name","title":"<code>Name</code>","text":"<p>               Bases: <code>Enum</code></p> <p>A textual label that uniquely identifies the part's semantic type.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Name(Enum):\n    \"\"\"\n    A textual label that uniquely identifies the part's semantic type.\n    \"\"\"\n\n    asset = 'asset'\n    method = 'method'\n    objective = 'objective'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Name-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Name.asset","title":"<code>asset = 'asset'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Name.method","title":"<code>method = 'method'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Name.objective","title":"<code>objective = 'objective'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues","title":"<code>NamingSystemValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class NamingSystemValidValues(Enum):\n    http___fedramp_gov = 'http://fedramp.gov'\n    http___fedramp_gov_ns_oscal = 'http://fedramp.gov/ns/oscal'\n    http___csrc_nist_gov_ns_oscal = 'http://csrc.nist.gov/ns/oscal'\n    http___csrc_nist_gov_ns_oscal_unknown = 'http://csrc.nist.gov/ns/oscal/unknown'\n    http___cve_mitre_org = 'http://cve.mitre.org'\n    http___www_first_org_cvss_v2_0 = 'http://www.first.org/cvss/v2.0'\n    http___www_first_org_cvss_v3_0 = 'http://www.first.org/cvss/v3.0'\n    http___www_first_org_cvss_v3_1 = 'http://www.first.org/cvss/v3.1'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal","title":"<code>http___csrc_nist_gov_ns_oscal = 'http://csrc.nist.gov/ns/oscal'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues.http___csrc_nist_gov_ns_oscal_unknown","title":"<code>http___csrc_nist_gov_ns_oscal_unknown = 'http://csrc.nist.gov/ns/oscal/unknown'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues.http___cve_mitre_org","title":"<code>http___cve_mitre_org = 'http://cve.mitre.org'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov","title":"<code>http___fedramp_gov = 'http://fedramp.gov'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues.http___fedramp_gov_ns_oscal","title":"<code>http___fedramp_gov_ns_oscal = 'http://fedramp.gov/ns/oscal'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v2_0","title":"<code>http___www_first_org_cvss_v2_0 = 'http://www.first.org/cvss/v2.0'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_0","title":"<code>http___www_first_org_cvss_v3_0 = 'http://www.first.org/cvss/v3.0'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NamingSystemValidValues.http___www_first_org_cvss_v3_1","title":"<code>http___www_first_org_cvss_v3_1 = 'http://www.first.org/cvss/v3.1'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.NonNegativeIntegerDatatype","title":"<code>NonNegativeIntegerDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An integer value that is equal to or greater than 0.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class NonNegativeIntegerDatatype(OscalBaseModel):\n    \"\"\"\n    An integer value that is equal to or greater than 0.\n    \"\"\"\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatus","title":"<code>ObjectiveStatus</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A determination of if the objective is satisfied or not within a given system.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ObjectiveStatus(OscalBaseModel):\n    \"\"\"\n    A determination of if the objective is satisfied or not within a given system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    state: ObjectiveStatusStateValidValues = Field(\n        ...,\n        description='An indication as to whether the objective is satisfied or not.',\n        title='Objective Status State'\n    )\n    reason: Optional[Union[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ),\n                           Reason]] = Field(\n                               None,\n                               description=\"The reason the objective was given it's status.\",\n                               title='Objective Status Reason'\n                           )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatus-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatus.reason","title":"<code>reason: Optional[Union[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$'), Reason]] = Field(None, description=\"The reason the objective was given it's status.\", title='Objective Status Reason')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatus.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatus.state","title":"<code>state: ObjectiveStatusStateValidValues = Field(..., description='An indication as to whether the objective is satisfied or not.', title='Objective Status State')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatus-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatus.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatusStateValidValues","title":"<code>ObjectiveStatusStateValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ObjectiveStatusStateValidValues(Enum):\n    satisfied = 'satisfied'\n    not_satisfied = 'not-satisfied'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatusStateValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatusStateValidValues.not_satisfied","title":"<code>not_satisfied = 'not-satisfied'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObjectiveStatusStateValidValues.satisfied","title":"<code>satisfied = 'satisfied'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation","title":"<code>Observation</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes an individual observation.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Observation(OscalBaseModel):\n    \"\"\"\n    Describes an individual observation.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this observation elsewhere in this or other OSCAL instances. The locally defined UUID of the observation can be used to reference the data item locally or globally (e.g., in an imorted OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Observation Universally Unique Identifier',\n    )\n    title: Optional[str] = Field(None, description='The title for this observation.', title='Observation Title')\n    description: str = Field(\n        ...,\n        description='A human-readable description of this assessment observation.',\n        title='Observation Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    methods: List[Union[constr(regex=r'^\\S(.*\\S)?$'), Methods]] = Field(...)\n    types: Optional[List[Union[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ),\n                               ObservationTypeValidValues]]] = Field(None)\n    origins: Optional[List[Origin]] = Field(None)\n    subjects: Optional[List[SubjectReference]] = Field(None)\n    relevant_evidence: Optional[List[RelevantEvidence]] = Field(None, alias='relevant-evidence')\n    collected: datetime = Field(\n        ...,\n        description='Date/time stamp identifying when the finding information was collected.',\n        title='Collected Field'\n    )\n    expires: Optional[datetime] = Field(\n        None,\n        description=\n        'Date/time identifying when the finding information is out-of-date and no longer valid. Typically used with continuous assessment scenarios.',\n        title='Expires Field'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.collected","title":"<code>collected: datetime = Field(..., description='Date/time stamp identifying when the finding information was collected.', title='Collected Field')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.description","title":"<code>description: str = Field(..., description='A human-readable description of this assessment observation.', title='Observation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.expires","title":"<code>expires: Optional[datetime] = Field(None, description='Date/time identifying when the finding information is out-of-date and no longer valid. Typically used with continuous assessment scenarios.', title='Expires Field')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.methods","title":"<code>methods: List[Union[constr(regex='^\\\\S(.*\\\\S)?$'), Methods]] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.origins","title":"<code>origins: Optional[List[Origin]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.relevant_evidence","title":"<code>relevant_evidence: Optional[List[RelevantEvidence]] = Field(None, alias='relevant-evidence')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.subjects","title":"<code>subjects: Optional[List[SubjectReference]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.title","title":"<code>title: Optional[str] = Field(None, description='The title for this observation.', title='Observation Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.types","title":"<code>types: Optional[List[Union[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$'), ObservationTypeValidValues]]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this observation elsewhere in this or other OSCAL instances. The locally defined UUID of the observation can be used to reference the data item locally or globally (e.g., in an imorted OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Observation Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Observation.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObservationTypeValidValues","title":"<code>ObservationTypeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ObservationTypeValidValues(Enum):\n    ssp_statement_issue = 'ssp-statement-issue'\n    control_objective = 'control-objective'\n    mitigation = 'mitigation'\n    finding = 'finding'\n    historic = 'historic'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObservationTypeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObservationTypeValidValues.control_objective","title":"<code>control_objective = 'control-objective'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObservationTypeValidValues.finding","title":"<code>finding = 'finding'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObservationTypeValidValues.historic","title":"<code>historic = 'historic'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObservationTypeValidValues.mitigation","title":"<code>mitigation = 'mitigation'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ObservationTypeValidValues.ssp_statement_issue","title":"<code>ssp_statement_issue = 'ssp-statement-issue'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OnDate","title":"<code>OnDate</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The task is intended to occur on the specified date.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class OnDate(OscalBaseModel):\n    \"\"\"\n    The task is intended to occur on the specified date.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    date: datetime = Field(..., description='The task must occur on the specified date.', title='On Date Condition')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OnDate-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OnDate.date","title":"<code>date: datetime = Field(..., description='The task must occur on the specified date.', title='On Date Condition')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OnDate-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OnDate.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Origin","title":"<code>Origin</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies the source of the finding, such as a tool, interviewed person, or activity.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Origin(OscalBaseModel):\n    \"\"\"\n    Identifies the source of the finding, such as a tool, interviewed person, or activity.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    actors: List[OriginActor] = Field(...)\n    related_tasks: Optional[List[RelatedTask]] = Field(None, alias='related-tasks')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Origin-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Origin.actors","title":"<code>actors: List[OriginActor] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Origin.related_tasks","title":"<code>related_tasks: Optional[List[RelatedTask]] = Field(None, alias='related-tasks')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Origin-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Origin.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActor","title":"<code>OriginActor</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The actor that produces an observation, a finding, or a risk. One or more actor type can be used to specify a person that is using a tool.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class OriginActor(OscalBaseModel):\n    \"\"\"\n    The actor that produces an observation, a finding, or a risk. One or more actor type can be used to specify a person that is using a tool.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    type: OriginActorValidValues = Field(..., description='The kind of actor.', title='Actor Type')\n    actor_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='actor-uuid',\n        description='A machine-oriented identifier reference to the tool or person based on the associated type.',\n        title='Actor Universally Unique Identifier Reference'\n    )\n    role_id: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='role-id',\n        description='For a party, this can optionally be used to specify the role the actor was performing.',\n        title='Actor Role'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActor-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActor.actor_uuid","title":"<code>actor_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='actor-uuid', description='A machine-oriented identifier reference to the tool or person based on the associated type.', title='Actor Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActor.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActor.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActor.role_id","title":"<code>role_id: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='role-id', description='For a party, this can optionally be used to specify the role the actor was performing.', title='Actor Role')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActor.type","title":"<code>type: OriginActorValidValues = Field(..., description='The kind of actor.', title='Actor Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActor-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActor.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActorValidValues","title":"<code>OriginActorValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class OriginActorValidValues(Enum):\n    tool = 'tool'\n    assessment_platform = 'assessment-platform'\n    party = 'party'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActorValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActorValidValues.assessment_platform","title":"<code>assessment_platform = 'assessment-platform'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActorValidValues.party","title":"<code>party = 'party'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OriginActorValidValues.tool","title":"<code>tool = 'tool'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OscalVersion","title":"<code>OscalVersion</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class OscalVersion(OscalBaseModel):\n    __root__: constr(regex=r'^\\S(.*\\S)?$') = Field(\n        ...,\n        description='The OSCAL model version the document was authored against and will conform to as valid.',\n        title='OSCAL Version'\n    )\n\n    @validator('__root__')\n    def oscal_version_is_valid(cls, v):\n        strict_version = False\n        if not strict_version:\n            return v\n        p = re.compile(OSCAL_VERSION_REGEX)\n        matched = p.match(v)\n        if matched is None:\n            raise ValueError(f'OSCAL version: {v} is not supported, use {OSCAL_VERSION} instead.')\n        return v\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OscalVersion-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OscalVersion.__root__","title":"<code>__root__: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description='The OSCAL model version the document was authored against and will conform to as valid.', title='OSCAL Version')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OscalVersion-functions","title":"Functions","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.OscalVersion.oscal_version_is_valid","title":"<code>oscal_version_is_valid(v)</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>@validator('__root__')\ndef oscal_version_is_valid(cls, v):\n    strict_version = False\n    if not strict_version:\n        return v\n    p = re.compile(OSCAL_VERSION_REGEX)\n    matched = p.match(v)\n    if matched is None:\n        raise ValueError(f'OSCAL version: {v} is not supported, use {OSCAL_VERSION} instead.')\n    return v\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter","title":"<code>Parameter</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Parameters provide a mechanism for the dynamic assignment of value(s) in a control.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Parameter(OscalBaseModel):\n    \"\"\"\n    Parameters provide a mechanism for the dynamic assignment of value(s) in a control.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(..., description='A unique identifier for the parameter.', title='Parameter Identifier')\n    class_: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='class',\n        description=\n        'A textual label that provides a characterization of the type, purpose, use or scope of the parameter.',\n        title='Parameter Class'\n    )\n    depends_on: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='depends-on',\n        description=\n        '(deprecated) Another parameter invoking this one. This construct has been deprecated and should not be used.',\n        title='Depends on'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    label: Optional[str] = Field(\n        None,\n        description=\n        'A short, placeholder name for the parameter, which can be used as a substitute for a value if no value is assigned.',\n        title='Parameter Label'\n    )\n    usage: Optional[str] = Field(\n        None, description='Describes the purpose and use of a parameter.', title='Parameter Usage Description'\n    )\n    constraints: Optional[List[ParameterConstraint]] = Field(None)\n    guidelines: Optional[List[ParameterGuideline]] = Field(None)\n    values: Optional[List[constr(regex=r'^\\S(.*\\S)?$')]] = Field(None)\n    select: Optional[ParameterSelection] = None\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.class_","title":"<code>class_: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='class', description='A textual label that provides a characterization of the type, purpose, use or scope of the parameter.', title='Parameter Class')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.constraints","title":"<code>constraints: Optional[List[ParameterConstraint]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.depends_on","title":"<code>depends_on: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='depends-on', description='(deprecated) Another parameter invoking this one. This construct has been deprecated and should not be used.', title='Depends on')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.guidelines","title":"<code>guidelines: Optional[List[ParameterGuideline]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.id","title":"<code>id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., description='A unique identifier for the parameter.', title='Parameter Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.label","title":"<code>label: Optional[str] = Field(None, description='A short, placeholder name for the parameter, which can be used as a substitute for a value if no value is assigned.', title='Parameter Label')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.select","title":"<code>select: Optional[ParameterSelection] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.usage","title":"<code>usage: Optional[str] = Field(None, description='Describes the purpose and use of a parameter.', title='Parameter Usage Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.values","title":"<code>values: Optional[List[constr(regex='^\\\\S(.*\\\\S)?$')]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Parameter.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterConstraint","title":"<code>ParameterConstraint</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A formal or informal expression of a constraint or test.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ParameterConstraint(OscalBaseModel):\n    \"\"\"\n    A formal or informal expression of a constraint or test.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    description: Optional[str] = Field(\n        None, description='A textual summary of the constraint to be applied.', title='Constraint Description'\n    )\n    tests: Optional[List[Test]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterConstraint-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterConstraint.description","title":"<code>description: Optional[str] = Field(None, description='A textual summary of the constraint to be applied.', title='Constraint Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterConstraint.tests","title":"<code>tests: Optional[List[Test]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterConstraint-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterConstraint.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterGuideline","title":"<code>ParameterGuideline</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A prose statement that provides a recommendation for the use of a parameter.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ParameterGuideline(OscalBaseModel):\n    \"\"\"\n    A prose statement that provides a recommendation for the use of a parameter.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    prose: str = Field(..., description='Prose permits multiple paragraphs, lists, tables etc.', title='Guideline Text')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterGuideline-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterGuideline.prose","title":"<code>prose: str = Field(..., description='Prose permits multiple paragraphs, lists, tables etc.', title='Guideline Text')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterGuideline-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterGuideline.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterSelection","title":"<code>ParameterSelection</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Presenting a choice among alternatives.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ParameterSelection(OscalBaseModel):\n    \"\"\"\n    Presenting a choice among alternatives.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    how_many: Optional[HowManyValidValues] = Field(\n        None,\n        alias='how-many',\n        description=\n        'Describes the number of selections that must occur. Without this setting, only one value should be assumed to be permitted.',\n        title='Parameter Cardinality'\n    )\n    choice: Optional[List[str]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterSelection-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterSelection.choice","title":"<code>choice: Optional[List[str]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterSelection.how_many","title":"<code>how_many: Optional[HowManyValidValues] = Field(None, alias='how-many', description='Describes the number of selections that must occur. Without this setting, only one value should be assumed to be permitted.', title='Parameter Cardinality')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterSelection-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterSelection.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterValue","title":"<code>ParameterValue</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ParameterValue(OscalBaseModel):\n    __root__: StringDatatype = Field(..., description='A parameter value or set of values.', title='Parameter Value')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterValue-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ParameterValue.__root__","title":"<code>__root__: StringDatatype = Field(..., description='A parameter value or set of values.', title='Parameter Value')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part","title":"<code>Part</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An annotated, markup-based textual element of a control's or catalog group's definition, or a child of another part.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Part(OscalBaseModel):\n    \"\"\"\n    An annotated, markup-based textual element of a control's or catalog group's definition, or a child of another part.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    id: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None, description='A unique identifier for the part.', title='Part Identifier'\n    )\n    name: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        description=\n        \"A textual label that uniquely identifies the part's semantic type, which exists in a value space qualified by the ns.\",\n        title='Part Name'\n    )\n    ns: Optional[AnyUrl] = Field(\n        None,\n        description=\n        \"An optional namespace qualifying the part's name. This allows different organizations to associate distinct semantics with the same name.\",\n        title='Part Namespace'\n    )\n    class_: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='class',\n        description=\n        \"An optional textual providing a sub-type or characterization of the part's name, or a category to which the part belongs.\",\n        title='Part Class'\n    )\n    title: Optional[str] = Field(\n        None,\n        description='An optional name given to the part, which may be used by a tool for display and navigation.',\n        title='Part Title'\n    )\n    props: Optional[List[Property]] = Field(None)\n    prose: Optional[str] = Field(None, description='Permits multiple paragraphs, lists, tables etc.', title='Part Text')\n    parts: Optional[List[Part]] = None\n    links: Optional[List[Link]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.class_","title":"<code>class_: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='class', description=\"An optional textual providing a sub-type or characterization of the part's name, or a category to which the part belongs.\", title='Part Class')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.id","title":"<code>id: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, description='A unique identifier for the part.', title='Part Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.name","title":"<code>name: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., description=\"A textual label that uniquely identifies the part's semantic type, which exists in a value space qualified by the ns.\", title='Part Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.ns","title":"<code>ns: Optional[AnyUrl] = Field(None, description=\"An optional namespace qualifying the part's name. This allows different organizations to associate distinct semantics with the same name.\", title='Part Namespace')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.parts","title":"<code>parts: Optional[List[Part]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.prose","title":"<code>prose: Optional[str] = Field(None, description='Permits multiple paragraphs, lists, tables etc.', title='Part Text')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.title","title":"<code>title: Optional[str] = Field(None, description='An optional name given to the part, which may be used by a tool for display and navigation.', title='Part Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Part.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party","title":"<code>Party</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An organization or person, which may be associated with roles or other concepts within the current or linked OSCAL document.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Party(OscalBaseModel):\n    \"\"\"\n    An organization or person, which may be associated with roles or other concepts within the current or linked OSCAL document.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(..., description='A unique identifier for the party.', title='Party Universally Unique Identifier')\n    type: PartyTypeValidValues = Field(\n        ..., description='A category describing the kind of party the object describes.', title='Party Type'\n    )\n    name: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        description='The full name of the party. This is typically the legal name associated with the party.',\n        title='Party Name'\n    )\n    short_name: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        alias='short-name',\n        description='A short common name, abbreviation, or acronym for the party.',\n        title='Party Short Name'\n    )\n    external_ids: Optional[List[ExternalId]] = Field(None, alias='external-ids')\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    email_addresses: Optional[List[EmailAddress]] = Field(None, alias='email-addresses')\n    telephone_numbers: Optional[List[TelephoneNumber]] = Field(None, alias='telephone-numbers')\n    addresses: Optional[List[Address]] = Field(None)\n    location_uuids: Optional[List[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )]] = Field(\n        None, alias='location-uuids'\n    )\n    member_of_organizations: Optional[List[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )]] = Field(\n        None, alias='member-of-organizations'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.addresses","title":"<code>addresses: Optional[List[Address]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.email_addresses","title":"<code>email_addresses: Optional[List[EmailAddress]] = Field(None, alias='email-addresses')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.external_ids","title":"<code>external_ids: Optional[List[ExternalId]] = Field(None, alias='external-ids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.location_uuids","title":"<code>location_uuids: Optional[List[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')]] = Field(None, alias='location-uuids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.member_of_organizations","title":"<code>member_of_organizations: Optional[List[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')]] = Field(None, alias='member-of-organizations')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.name","title":"<code>name: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, description='The full name of the party. This is typically the legal name associated with the party.', title='Party Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.short_name","title":"<code>short_name: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='short-name', description='A short common name, abbreviation, or acronym for the party.', title='Party Short Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.telephone_numbers","title":"<code>telephone_numbers: Optional[List[TelephoneNumber]] = Field(None, alias='telephone-numbers')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.type","title":"<code>type: PartyTypeValidValues = Field(..., description='A category describing the kind of party the object describes.', title='Party Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A unique identifier for the party.', title='Party Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Party.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PartyTypeValidValues","title":"<code>PartyTypeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class PartyTypeValidValues(Enum):\n    person = 'person'\n    organization = 'organization'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PartyTypeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PartyTypeValidValues.organization","title":"<code>organization = 'organization'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PartyTypeValidValues.person","title":"<code>person = 'person'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PartyUuid","title":"<code>PartyUuid</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class PartyUuid(OscalBaseModel):\n    __root__: UUIDDatatype = Field(\n        ..., description='Reference to a party by UUID.', title='Party Universally Unique Identifier Reference'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PartyUuid-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PartyUuid.__root__","title":"<code>__root__: UUIDDatatype = Field(..., description='Reference to a party by UUID.', title='Party Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRange","title":"<code>PortRange</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Where applicable this is the IPv4 port range on which the service operates.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class PortRange(OscalBaseModel):\n    \"\"\"\n    Where applicable this is the IPv4 port range on which the service operates.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    start: Optional[conint(ge=0, multiple_of=1)] = Field(\n        None, description='Indicates the starting port number in a port range', title='Start'\n    )\n    end: Optional[conint(ge=0, multiple_of=1)] = Field(\n        None, description='Indicates the ending port number in a port range', title='End'\n    )\n    transport: Optional[PortRangeValidValues] = Field(\n        None, description='Indicates the transport type.', title='Transport'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRange-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRange.end","title":"<code>end: Optional[conint(ge=0, multiple_of=1)] = Field(None, description='Indicates the ending port number in a port range', title='End')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRange.start","title":"<code>start: Optional[conint(ge=0, multiple_of=1)] = Field(None, description='Indicates the starting port number in a port range', title='Start')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRange.transport","title":"<code>transport: Optional[PortRangeValidValues] = Field(None, description='Indicates the transport type.', title='Transport')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRange-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRange.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRangeValidValues","title":"<code>PortRangeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class PortRangeValidValues(Enum):\n    TCP = 'TCP'\n    UDP = 'UDP'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRangeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRangeValidValues.TCP","title":"<code>TCP = 'TCP'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PortRangeValidValues.UDP","title":"<code>UDP = 'UDP'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.PositiveIntegerDatatype","title":"<code>PositiveIntegerDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An integer value that is greater than 0.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class PositiveIntegerDatatype(OscalBaseModel):\n    \"\"\"\n    An integer value that is greater than 0.\n    \"\"\"\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property","title":"<code>Property</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An attribute, characteristic, or quality of the containing object expressed as a namespace qualified name/value pair.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Property(OscalBaseModel):\n    \"\"\"\n    An attribute, characteristic, or quality of the containing object expressed as a namespace qualified name/value pair.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    name: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        description=\n        \"A textual label, within a namespace, that uniquely identifies a specific attribute, characteristic, or quality of the property's containing object.\",\n        title='Property Name'\n    )\n    uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None, description='A unique identifier for a property.', title='Property Universally Unique Identifier'\n    )\n    ns: Optional[AnyUrl] = Field(\n        None,\n        description=\n        \"A namespace qualifying the property's name. This allows different organizations to associate distinct semantics with the same name.\",\n        title='Property Namespace'\n    )\n    value: constr(regex=r'^\\S(.*\\S)?$') = Field(\n        ..., description='Indicates the value of the attribute, characteristic, or quality.', title='Property Value'\n    )\n    class_: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='class',\n        description=\"A textual label that provides a sub-type or characterization of the property's name.\",\n        title='Property Class'\n    )\n    group: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None, description='An identifier for relating distinct sets of properties.', title='Property Group'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property.class_","title":"<code>class_: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='class', description=\"A textual label that provides a sub-type or characterization of the property's name.\", title='Property Class')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property.group","title":"<code>group: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, description='An identifier for relating distinct sets of properties.', title='Property Group')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property.name","title":"<code>name: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., description=\"A textual label, within a namespace, that uniquely identifies a specific attribute, characteristic, or quality of the property's containing object.\", title='Property Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property.ns","title":"<code>ns: Optional[AnyUrl] = Field(None, description=\"A namespace qualifying the property's name. This allows different organizations to associate distinct semantics with the same name.\", title='Property Namespace')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property.uuid","title":"<code>uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, description='A unique identifier for a property.', title='Property Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property.value","title":"<code>value: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description='Indicates the value of the attribute, characteristic, or quality.', title='Property Value')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Property.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Protocol","title":"<code>Protocol</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Information about the protocol used to provide a service.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Protocol(OscalBaseModel):\n    \"\"\"\n    Information about the protocol used to provide a service.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this service protocol information elsewhere in this or other OSCAL instances. The locally defined UUID of the service protocol can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Service Protocol Information Universally Unique Identifier',\n    )\n    name: constr(regex=r'^\\S(.*\\S)?$') = Field(\n        ...,\n        description=\n        'The common name of the protocol, which should be the appropriate \"service name\" from the IANA Service Name and Transport Protocol Port Number Registry.',\n        title='Protocol Name'\n    )\n    title: Optional[str] = Field(\n        None,\n        description='A human readable name for the protocol (e.g., Transport Layer Security).',\n        title='Protocol Title'\n    )\n    port_ranges: Optional[List[PortRange]] = Field(None, alias='port-ranges')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Protocol-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Protocol.name","title":"<code>name: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description='The common name of the protocol, which should be the appropriate \"service name\" from the IANA Service Name and Transport Protocol Port Number Registry.', title='Protocol Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Protocol.port_ranges","title":"<code>port_ranges: Optional[List[PortRange]] = Field(None, alias='port-ranges')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Protocol.title","title":"<code>title: Optional[str] = Field(None, description='A human readable name for the protocol (e.g., Transport Layer Security).', title='Protocol Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Protocol.uuid","title":"<code>uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this service protocol information elsewhere in this or other OSCAL instances. The locally defined UUID of the service protocol can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Service Protocol Information Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Protocol-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Protocol.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Published","title":"<code>Published</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Published(OscalBaseModel):\n    __root__: DateTimeWithTimezoneDatatype = Field(\n        ..., description='The date and time the document was last made available.', title='Publication Timestamp'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Published-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Published.__root__","title":"<code>__root__: DateTimeWithTimezoneDatatype = Field(..., description='The date and time the document was last made available.', title='Publication Timestamp')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Reason","title":"<code>Reason</code>","text":"<p>               Bases: <code>Enum</code></p> <p>The reason the objective was given it's status.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Reason(Enum):\n    \"\"\"\n    The reason the objective was given it's status.\n    \"\"\"\n\n    pass_ = 'pass'\n    fail = 'fail'\n    other = 'other'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Reason-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Reason.fail","title":"<code>fail = 'fail'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Reason.other","title":"<code>other = 'other'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Reason.pass_","title":"<code>pass_ = 'pass'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rel","title":"<code>Rel</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Describes the type of relationship provided by the link's hypertext reference. This can be an indicator of the link's purpose.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Rel(Enum):\n    \"\"\"\n    Describes the type of relationship provided by the link's hypertext reference. This can be an indicator of the link's purpose.\n    \"\"\"\n\n    reference = 'reference'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rel-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rel.reference","title":"<code>reference = 'reference'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedObservation","title":"<code>RelatedObservation</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Relates the finding to a set of referenced observations that were used to determine the finding.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RelatedObservation(OscalBaseModel):\n    \"\"\"\n    Relates the finding to a set of referenced observations that were used to determine the finding.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    observation_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='observation-uuid',\n        description='A machine-oriented identifier reference to an observation defined in the list of observations.',\n        title='Observation Universally Unique Identifier Reference'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedObservation-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedObservation.observation_uuid","title":"<code>observation_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='observation-uuid', description='A machine-oriented identifier reference to an observation defined in the list of observations.', title='Observation Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedObservation-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedObservation.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedResponse","title":"<code>RelatedResponse</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies an individual risk response that this log entry is for.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RelatedResponse(OscalBaseModel):\n    \"\"\"\n    Identifies an individual risk response that this log entry is for.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    response_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='response-uuid',\n        description='A machine-oriented identifier reference to a unique risk response.',\n        title='Response Universally Unique Identifier Reference'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    related_tasks: Optional[List[RelatedTask]] = Field(None, alias='related-tasks')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedResponse-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedResponse.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedResponse.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedResponse.related_tasks","title":"<code>related_tasks: Optional[List[RelatedTask]] = Field(None, alias='related-tasks')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedResponse.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedResponse.response_uuid","title":"<code>response_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='response-uuid', description='A machine-oriented identifier reference to a unique risk response.', title='Response Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedResponse-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedResponse.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedRisk","title":"<code>RelatedRisk</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Relates the finding to a set of referenced risks that were used to determine the finding.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RelatedRisk(OscalBaseModel):\n    \"\"\"\n    Relates the finding to a set of referenced risks that were used to determine the finding.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    risk_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='risk-uuid',\n        description='A machine-oriented identifier reference to a risk defined in the list of risks.',\n        title='Risk Universally Unique Identifier Reference'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedRisk-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedRisk.risk_uuid","title":"<code>risk_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='risk-uuid', description='A machine-oriented identifier reference to a risk defined in the list of risks.', title='Risk Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedRisk-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedRisk.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask","title":"<code>RelatedTask</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies an individual task for which the containing object is a consequence of.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RelatedTask(OscalBaseModel):\n    \"\"\"\n    Identifies an individual task for which the containing object is a consequence of.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    task_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='task-uuid',\n        description='A machine-oriented identifier reference to a unique task.',\n        title='Task Universally Unique Identifier Reference'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')\n    subjects: Optional[List[AssessmentSubject]] = Field(None)\n    identified_subject: Optional[IdentifiedSubject] = Field(\n        None,\n        alias='identified-subject',\n        description='Used to detail assessment subjects that were identfied by this task.',\n        title='Identified Subject'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask.identified_subject","title":"<code>identified_subject: Optional[IdentifiedSubject] = Field(None, alias='identified-subject', description='Used to detail assessment subjects that were identfied by this task.', title='Identified Subject')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask.responsible_parties","title":"<code>responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask.subjects","title":"<code>subjects: Optional[List[AssessmentSubject]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask.task_uuid","title":"<code>task_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='task-uuid', description='A machine-oriented identifier reference to a unique task.', title='Task Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelatedTask.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelevantEvidence","title":"<code>RelevantEvidence</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Links this observation to relevant evidence.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RelevantEvidence(OscalBaseModel):\n    \"\"\"\n    Links this observation to relevant evidence.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    href: Optional[str] = Field(\n        None, description='A resolvable URL reference to relevant evidence.', title='Relevant Evidence Reference'\n    )\n    description: str = Field(\n        ..., description='A human-readable description of this evidence.', title='Relevant Evidence Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelevantEvidence-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelevantEvidence.description","title":"<code>description: str = Field(..., description='A human-readable description of this evidence.', title='Relevant Evidence Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelevantEvidence.href","title":"<code>href: Optional[str] = Field(None, description='A resolvable URL reference to relevant evidence.', title='Relevant Evidence Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelevantEvidence.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelevantEvidence.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelevantEvidence.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelevantEvidence-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RelevantEvidence.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Remarks","title":"<code>Remarks</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Remarks(OscalBaseModel):\n    __root__: str = Field(..., description='Additional commentary about the containing object.', title='Remarks')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Remarks-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Remarks.__root__","title":"<code>__root__: str = Field(..., description='Additional commentary about the containing object.', title='Remarks')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset","title":"<code>RequiredAsset</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies an asset required to achieve remediation.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RequiredAsset(OscalBaseModel):\n    \"\"\"\n    Identifies an asset required to achieve remediation.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this required asset elsewhere in this or other OSCAL instances. The locally defined UUID of the asset can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Required Universally Unique Identifier',\n    )\n    subjects: Optional[List[SubjectReference]] = Field(None)\n    title: Optional[str] = Field(\n        None, description='The title for this required asset.', title='Title for Required Asset'\n    )\n    description: str = Field(\n        ..., description='A human-readable description of this required asset.', title='Description of Required Asset'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset.description","title":"<code>description: str = Field(..., description='A human-readable description of this required asset.', title='Description of Required Asset')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset.subjects","title":"<code>subjects: Optional[List[SubjectReference]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset.title","title":"<code>title: Optional[str] = Field(None, description='The title for this required asset.', title='Title for Required Asset')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this required asset elsewhere in this or other OSCAL instances. The locally defined UUID of the asset can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Required Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RequiredAsset.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource","title":"<code>Resource</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A resource associated with content in the containing document instance. A resource may be directly included in the document using base64 encoding or may point to one or more equivalent internet resources.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Resource(OscalBaseModel):\n    \"\"\"\n    A resource associated with content in the containing document instance. A resource may be directly included in the document using base64 encoding or may point to one or more equivalent internet resources.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(..., description='A unique identifier for a resource.', title='Resource Universally Unique Identifier')\n    title: Optional[str] = Field(\n        None,\n        description='An optional name given to the resource, which may be used by a tool for display and navigation.',\n        title='Resource Title'\n    )\n    description: Optional[str] = Field(\n        None,\n        description='An optional short summary of the resource used to indicate the purpose of the resource.',\n        title='Resource Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    document_ids: Optional[List[DocumentId]] = Field(None, alias='document-ids')\n    citation: Optional[Citation] = Field(\n        None, description='An optional citation consisting of end note text using structured markup.', title='Citation'\n    )\n    rlinks: Optional[List[Rlink]] = Field(None)\n    base64: Optional[Base64] = Field(\n        None, description='A resource encoded using the Base64 alphabet defined by RFC 2045.', title='Base64'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.base64","title":"<code>base64: Optional[Base64] = Field(None, description='A resource encoded using the Base64 alphabet defined by RFC 2045.', title='Base64')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.citation","title":"<code>citation: Optional[Citation] = Field(None, description='An optional citation consisting of end note text using structured markup.', title='Citation')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.description","title":"<code>description: Optional[str] = Field(None, description='An optional short summary of the resource used to indicate the purpose of the resource.', title='Resource Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.document_ids","title":"<code>document_ids: Optional[List[DocumentId]] = Field(None, alias='document-ids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.rlinks","title":"<code>rlinks: Optional[List[Rlink]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.title","title":"<code>title: Optional[str] = Field(None, description='An optional name given to the resource, which may be used by a tool for display and navigation.', title='Resource Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A unique identifier for a resource.', title='Resource Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Resource.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response","title":"<code>Response</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes either recommended or an actual plan for addressing the risk.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Response(OscalBaseModel):\n    \"\"\"\n    Describes either recommended or an actual plan for addressing the risk.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this remediation elsewhere in this or other OSCAL instances. The locally defined UUID of the risk response can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Remediation Universally Unique Identifier',\n    )\n    lifecycle: Union[\n        constr(\n            regex=\n            r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n        ),\n        Lifecycle\n    ] = Field(\n        ...,\n        description=\n        'Identifies whether this is a recommendation, such as from an assessor or tool, or an actual plan accepted by the system owner.',\n        title='Remediation Intent'\n    )\n    title: str = Field(..., description='The title for this response activity.', title='Response Title')\n    description: str = Field(\n        ..., description='A human-readable description of this response plan.', title='Response Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    origins: Optional[List[Origin]] = Field(None)\n    required_assets: Optional[List[RequiredAsset]] = Field(None, alias='required-assets')\n    tasks: Optional[List[Task]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.description","title":"<code>description: str = Field(..., description='A human-readable description of this response plan.', title='Response Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.lifecycle","title":"<code>lifecycle: Union[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$'), Lifecycle] = Field(..., description='Identifies whether this is a recommendation, such as from an assessor or tool, or an actual plan accepted by the system owner.', title='Remediation Intent')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.origins","title":"<code>origins: Optional[List[Origin]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.required_assets","title":"<code>required_assets: Optional[List[RequiredAsset]] = Field(None, alias='required-assets')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.tasks","title":"<code>tasks: Optional[List[Task]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.title","title":"<code>title: str = Field(..., description='The title for this response activity.', title='Response Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this remediation elsewhere in this or other OSCAL instances. The locally defined UUID of the risk response can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Remediation Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Response.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleParty","title":"<code>ResponsibleParty</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A reference to a set of persons and/or organizations that have responsibility for performing the referenced role in the context of the containing object.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ResponsibleParty(OscalBaseModel):\n    \"\"\"\n    A reference to a set of persons and/or organizations that have responsibility for performing the referenced role in the context of the containing object.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    role_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ..., alias='role-id', description='A reference to a role performed by a party.', title='Responsible Role'\n    )\n    party_uuids: List[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(..., alias='party-uuids')\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleParty-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleParty.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleParty.party_uuids","title":"<code>party_uuids: List[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(..., alias='party-uuids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleParty.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleParty.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleParty.role_id","title":"<code>role_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='role-id', description='A reference to a role performed by a party.', title='Responsible Role')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleParty-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleParty.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleRole","title":"<code>ResponsibleRole</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A reference to a role with responsibility for performing a function relative to the containing object, optionally associated with a set of persons and/or organizations that perform that role.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ResponsibleRole(OscalBaseModel):\n    \"\"\"\n    A reference to a role with responsibility for performing a function relative to the containing object, optionally associated with a set of persons and/or organizations that perform that role.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    role_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='role-id',\n        description='A human-oriented identifier reference to a role performed.',\n        title='Responsible Role ID'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    party_uuids: Optional[List[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )]] = Field(\n        None, alias='party-uuids'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleRole-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleRole.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleRole.party_uuids","title":"<code>party_uuids: Optional[List[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')]] = Field(None, alias='party-uuids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleRole.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleRole.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleRole.role_id","title":"<code>role_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='role-id', description='A human-oriented identifier reference to a role performed.', title='Responsible Role ID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleRole-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ResponsibleRole.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls","title":"<code>ReviewedControls</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies the controls being assessed and their control objectives.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ReviewedControls(OscalBaseModel):\n    \"\"\"\n    Identifies the controls being assessed and their control objectives.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    description: Optional[str] = Field(\n        None, description='A human-readable description of control objectives.', title='Control Objective Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    control_selections: List[ControlSelection] = Field(..., alias='control-selections')\n    control_objective_selections: Optional[List[ControlObjectiveSelection]] = Field(\n        None, alias='control-objective-selections'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls.control_objective_selections","title":"<code>control_objective_selections: Optional[List[ControlObjectiveSelection]] = Field(None, alias='control-objective-selections')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls.control_selections","title":"<code>control_selections: List[ControlSelection] = Field(..., alias='control-selections')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls.description","title":"<code>description: Optional[str] = Field(None, description='A human-readable description of control objectives.', title='Control Objective Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ReviewedControls.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision","title":"<code>Revision</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An entry in a sequential list of revisions to the containing document, expected to be in reverse chronological order (i.e. latest first).</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Revision(OscalBaseModel):\n    \"\"\"\n    An entry in a sequential list of revisions to the containing document, expected to be in reverse chronological order (i.e. latest first).\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    title: Optional[str] = Field(\n        None,\n        description='A name given to the document revision, which may be used by a tool for display and navigation.',\n        title='Document Title'\n    )\n    published: Optional[datetime] = None\n    last_modified: Optional[datetime] = Field(None, alias='last-modified')\n    version: constr(regex=r'^\\S(.*\\S)?$')\n    oscal_version: Optional[OscalVersion] = Field(None, alias='oscal-version')\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision.last_modified","title":"<code>last_modified: Optional[datetime] = Field(None, alias='last-modified')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision.oscal_version","title":"<code>oscal_version: Optional[OscalVersion] = Field(None, alias='oscal-version')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision.published","title":"<code>published: Optional[datetime] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision.title","title":"<code>title: Optional[str] = Field(None, description='A name given to the document revision, which may be used by a tool for display and navigation.', title='Document Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision.version","title":"<code>version: constr(regex='^\\\\S(.*\\\\S)?$')</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Revision.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk","title":"<code>Risk</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>An identified risk.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Risk(OscalBaseModel):\n    \"\"\"\n    An identified risk.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this risk elsewhere in this or other OSCAL instances. The locally defined UUID of the risk can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Risk Universally Unique Identifier',\n    )\n    title: str = Field(..., description='The title for this risk.', title='Risk Title')\n    description: str = Field(\n        ...,\n        description=\n        'A human-readable summary of the identified risk, to include a statement of how the risk impacts the system.',\n        title='Risk Description'\n    )\n    statement: str = Field(\n        ..., description='An summary of impact for how the risk affects the system.', title='Risk Statement'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    status: RiskStatus\n    origins: Optional[List[Origin]] = Field(None)\n    threat_ids: Optional[List[ThreatId]] = Field(None, alias='threat-ids')\n    characterizations: Optional[List[Characterization]] = Field(None)\n    mitigating_factors: Optional[List[MitigatingFactor]] = Field(None, alias='mitigating-factors')\n    deadline: Optional[datetime] = Field(\n        None, description='The date/time by which the risk must be resolved.', title='Risk Resolution Deadline'\n    )\n    remediations: Optional[List[Response]] = Field(None)\n    risk_log: Optional[RiskLog] = Field(\n        None, alias='risk-log', description='A log of all risk-related tasks taken.', title='Risk Log'\n    )\n    related_observations: Optional[List[RelatedObservation]] = Field(None, alias='related-observations')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.characterizations","title":"<code>characterizations: Optional[List[Characterization]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.deadline","title":"<code>deadline: Optional[datetime] = Field(None, description='The date/time by which the risk must be resolved.', title='Risk Resolution Deadline')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.description","title":"<code>description: str = Field(..., description='A human-readable summary of the identified risk, to include a statement of how the risk impacts the system.', title='Risk Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.mitigating_factors","title":"<code>mitigating_factors: Optional[List[MitigatingFactor]] = Field(None, alias='mitigating-factors')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.origins","title":"<code>origins: Optional[List[Origin]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.related_observations","title":"<code>related_observations: Optional[List[RelatedObservation]] = Field(None, alias='related-observations')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.remediations","title":"<code>remediations: Optional[List[Response]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.risk_log","title":"<code>risk_log: Optional[RiskLog] = Field(None, alias='risk-log', description='A log of all risk-related tasks taken.', title='Risk Log')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.statement","title":"<code>statement: str = Field(..., description='An summary of impact for how the risk affects the system.', title='Risk Statement')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.status","title":"<code>status: RiskStatus</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.threat_ids","title":"<code>threat_ids: Optional[List[ThreatId]] = Field(None, alias='threat-ids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.title","title":"<code>title: str = Field(..., description='The title for this risk.', title='Risk Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this risk elsewhere in this or other OSCAL instances. The locally defined UUID of the risk can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Risk Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Risk.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskLog","title":"<code>RiskLog</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A log of all risk-related tasks taken.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RiskLog(OscalBaseModel):\n    \"\"\"\n    A log of all risk-related tasks taken.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    entries: List[Entry] = Field(...)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskLog-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskLog.entries","title":"<code>entries: List[Entry] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskLog-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskLog.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatus","title":"<code>RiskStatus</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RiskStatus(OscalBaseModel):\n    __root__: Union[TokenDatatype, RiskStatusValidValues] = Field(\n        ..., description='Describes the status of the associated risk.', title='Risk Status'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatus-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatus.__root__","title":"<code>__root__: Union[TokenDatatype, RiskStatusValidValues] = Field(..., description='Describes the status of the associated risk.', title='Risk Status')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatusValidValues","title":"<code>RiskStatusValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RiskStatusValidValues(Enum):\n    open = 'open'\n    investigating = 'investigating'\n    remediating = 'remediating'\n    deviation_requested = 'deviation-requested'\n    deviation_approved = 'deviation-approved'\n    closed = 'closed'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatusValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatusValidValues.closed","title":"<code>closed = 'closed'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatusValidValues.deviation_approved","title":"<code>deviation_approved = 'deviation-approved'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatusValidValues.deviation_requested","title":"<code>deviation_requested = 'deviation-requested'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatusValidValues.investigating","title":"<code>investigating = 'investigating'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatusValidValues.open","title":"<code>open = 'open'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RiskStatusValidValues.remediating","title":"<code>remediating = 'remediating'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rlink","title":"<code>Rlink</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A URL-based pointer to an external resource with an optional hash for verification and change detection.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Rlink(OscalBaseModel):\n    \"\"\"\n    A URL-based pointer to an external resource with an optional hash for verification and change detection.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    href: str = Field(\n        ..., description='A resolvable URL pointing to the referenced resource.', title='Hypertext Reference'\n    )\n    media_type: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        alias='media-type',\n        description='A label that indicates the nature of a resource, as a data serialization or format.',\n        title='Media Type'\n    )\n    hashes: Optional[List[Hash]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rlink-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rlink.hashes","title":"<code>hashes: Optional[List[Hash]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rlink.href","title":"<code>href: str = Field(..., description='A resolvable URL pointing to the referenced resource.', title='Hypertext Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rlink.media_type","title":"<code>media_type: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='media-type', description='A label that indicates the nature of a resource, as a data serialization or format.', title='Media Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rlink-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Rlink.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role","title":"<code>Role</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Defines a function, which might be assigned to a party in a specific situation.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Role(OscalBaseModel):\n    \"\"\"\n    Defines a function, which might be assigned to a party in a specific situation.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(..., description='A unique identifier for the role.', title='Role Identifier')\n    title: str = Field(\n        ...,\n        description='A name given to the role, which may be used by a tool for display and navigation.',\n        title='Role Title'\n    )\n    short_name: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        alias='short-name',\n        description='A short common name, abbreviation, or acronym for the role.',\n        title='Role Short Name'\n    )\n    description: Optional[str] = Field(\n        None, description=\"A summary of the role's purpose and associated responsibilities.\", title='Role Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role.description","title":"<code>description: Optional[str] = Field(None, description=\"A summary of the role's purpose and associated responsibilities.\", title='Role Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role.id","title":"<code>id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., description='A unique identifier for the role.', title='Role Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role.short_name","title":"<code>short_name: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='short-name', description='A short common name, abbreviation, or acronym for the role.', title='Role Short Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role.title","title":"<code>title: str = Field(..., description='A name given to the role, which may be used by a tool for display and navigation.', title='Role Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Role.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RoleId","title":"<code>RoleId</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class RoleId(OscalBaseModel):\n    __root__: TokenDatatype = Field(..., description='Reference to a role by UUID.', title='Role Identifier Reference')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RoleId-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.RoleId.__root__","title":"<code>__root__: TokenDatatype = Field(..., description='Reference to a role by UUID.', title='Role Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectControlById","title":"<code>SelectControlById</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to select a control for inclusion/exclusion based on one or more control identifiers. A set of statement identifiers can be used to target the inclusion/exclusion to only specific control statements providing more granularity over the specific statements that are within the asessment scope.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SelectControlById(OscalBaseModel):\n    \"\"\"\n    Used to select a control for inclusion/exclusion based on one or more control identifiers. A set of statement identifiers can be used to target the inclusion/exclusion to only specific control statements providing more granularity over the specific statements that are within the asessment scope.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    control_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='control-id',\n        description=\n        'A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).',\n        title='Control Identifier Reference'\n    )\n    statement_ids: Optional[List[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )]] = Field(\n        None, alias='statement-ids'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectControlById-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectControlById.control_id","title":"<code>control_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='control-id', description='A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).', title='Control Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectControlById.statement_ids","title":"<code>statement_ids: Optional[List[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')]] = Field(None, alias='statement-ids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectControlById-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectControlById.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectObjectiveById","title":"<code>SelectObjectiveById</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to select a control objective for inclusion/exclusion based on the control objective's identifier.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SelectObjectiveById(OscalBaseModel):\n    \"\"\"\n    Used to select a control objective for inclusion/exclusion based on the control objective's identifier.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    objective_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(..., alias='objective-id', description='Points to an assessment objective.', title='Objective ID')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectObjectiveById-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectObjectiveById.objective_id","title":"<code>objective_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='objective-id', description='Points to an assessment objective.', title='Objective ID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectObjectiveById-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectObjectiveById.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectById","title":"<code>SelectSubjectById</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies a set of assessment subjects to include/exclude by UUID.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SelectSubjectById(OscalBaseModel):\n    \"\"\"\n    Identifies a set of assessment subjects to include/exclude by UUID.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    subject_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='subject-uuid',\n        description=\n        \"A machine-oriented identifier reference to a component, inventory-item, location, party, user, or resource using it's UUID.\",\n        title='Subject Universally Unique Identifier Reference'\n    )\n    type: Union[TokenDatatype, SelectSubjectByIdValidValues] = Field(\n        ...,\n        description='Used to indicate the type of object pointed to by the uuid-ref within a subject.',\n        title='Subject Universally Unique Identifier Reference Type'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectById-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectById.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectById.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectById.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectById.subject_uuid","title":"<code>subject_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='subject-uuid', description=\"A machine-oriented identifier reference to a component, inventory-item, location, party, user, or resource using it's UUID.\", title='Subject Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectById.type","title":"<code>type: Union[TokenDatatype, SelectSubjectByIdValidValues] = Field(..., description='Used to indicate the type of object pointed to by the uuid-ref within a subject.', title='Subject Universally Unique Identifier Reference Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectById-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectById.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectByIdValidValues","title":"<code>SelectSubjectByIdValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SelectSubjectByIdValidValues(Enum):\n    component = 'component'\n    inventory_item = 'inventory-item'\n    location = 'location'\n    party = 'party'\n    user = 'user'\n    resource = 'resource'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectByIdValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectByIdValidValues.component","title":"<code>component = 'component'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectByIdValidValues.inventory_item","title":"<code>inventory_item = 'inventory-item'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectByIdValidValues.location","title":"<code>location = 'location'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectByIdValidValues.party","title":"<code>party = 'party'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectByIdValidValues.resource","title":"<code>resource = 'resource'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SelectSubjectByIdValidValues.user","title":"<code>user = 'user'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Source","title":"<code>Source</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Assessment subjects will be identified while conducting the referenced activity-instance.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Source(OscalBaseModel):\n    \"\"\"\n    Assessment subjects will be identified while conducting the referenced activity-instance.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    task_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='task-uuid',\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference (in this or other OSCAL instances) an assessment activity to be performed as part of the event. The locally defined UUID of the task can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Task Universally Unique Identifier',\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Source-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Source.task_uuid","title":"<code>task_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='task-uuid', description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference (in this or other OSCAL instances) an assessment activity to be performed as part of the event. The locally defined UUID of the task can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Task Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Source-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Source.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.State","title":"<code>State</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Identifies the implementation status of the control or control objective.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class State(Enum):\n    \"\"\"\n    Identifies the implementation status of the control or control objective.\n    \"\"\"\n\n    implemented = 'implemented'\n    partial = 'partial'\n    planned = 'planned'\n    alternative = 'alternative'\n    not_applicable = 'not-applicable'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.State-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.State.alternative","title":"<code>alternative = 'alternative'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.State.implemented","title":"<code>implemented = 'implemented'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.State.not_applicable","title":"<code>not_applicable = 'not-applicable'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.State.partial","title":"<code>partial = 'partial'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.State.planned","title":"<code>planned = 'planned'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Status","title":"<code>Status</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes the operational status of the system component.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Status(OscalBaseModel):\n    \"\"\"\n    Describes the operational status of the system component.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    state: SystemComponentOperationalStateValidValues = Field(..., description='The operational status.', title='State')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Status-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Status.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Status.state","title":"<code>state: SystemComponentOperationalStateValidValues = Field(..., description='The operational status.', title='State')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Status-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Status.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step","title":"<code>Step</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies an individual step in a series of steps related to an activity, such as an assessment test or examination procedure.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Step(OscalBaseModel):\n    \"\"\"\n    Identifies an individual step in a series of steps related to an activity, such as an assessment test or examination procedure.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this step elsewhere in this or other OSCAL instances. The locally defined UUID of the step (in a series of steps) can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Step Universally Unique Identifier',\n    )\n    title: Optional[str] = Field(None, description='The title for this step.', title='Step Title')\n    description: str = Field(..., description='A human-readable description of this step.', title='Step Description')\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    reviewed_controls: Optional[ReviewedControls] = Field(None, alias='reviewed-controls')\n    responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step.description","title":"<code>description: str = Field(..., description='A human-readable description of this step.', title='Step Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step.responsible_roles","title":"<code>responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step.reviewed_controls","title":"<code>reviewed_controls: Optional[ReviewedControls] = Field(None, alias='reviewed-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step.title","title":"<code>title: Optional[str] = Field(None, description='The title for this step.', title='Step Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this step elsewhere in this or other OSCAL instances. The locally defined UUID of the step (in a series of steps) can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Step Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Step.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.StringDatatype","title":"<code>StringDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class StringDatatype(OscalBaseModel):\n    __root__: constr(regex=r'^\\S(.*\\S)?$') = Field(\n        ...,\n        description=\n        'A non-empty string with leading and trailing whitespace disallowed. Whitespace is: U+9, U+10, U+32 or [ \\n\\t]+'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.StringDatatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.StringDatatype.__root__","title":"<code>__root__: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description='A non-empty string with leading and trailing whitespace disallowed. Whitespace is: U+9, U+10, U+32 or [ \\n\\t]+')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference","title":"<code>SubjectReference</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A human-oriented identifier reference to a resource. Use type to indicate whether the identified resource is a component, inventory item, location, user, or something else.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SubjectReference(OscalBaseModel):\n    \"\"\"\n    A human-oriented identifier reference to a resource. Use type to indicate whether the identified resource is a component, inventory item, location, user, or something else.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    subject_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='subject-uuid',\n        description=\n        \"A machine-oriented identifier reference to a component, inventory-item, location, party, user, or resource using it's UUID.\",\n        title='Subject Universally Unique Identifier Reference'\n    )\n    type: Union[TokenDatatype, SubjectReferenceValidValues] = Field(\n        ...,\n        description='Used to indicate the type of object pointed to by the uuid-ref within a subject.',\n        title='Subject Universally Unique Identifier Reference Type'\n    )\n    title: Optional[str] = Field(\n        None, description='The title or name for the referenced subject.', title='Subject Reference Title'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference.subject_uuid","title":"<code>subject_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='subject-uuid', description=\"A machine-oriented identifier reference to a component, inventory-item, location, party, user, or resource using it's UUID.\", title='Subject Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference.title","title":"<code>title: Optional[str] = Field(None, description='The title or name for the referenced subject.', title='Subject Reference Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference.type","title":"<code>type: Union[TokenDatatype, SubjectReferenceValidValues] = Field(..., description='Used to indicate the type of object pointed to by the uuid-ref within a subject.', title='Subject Universally Unique Identifier Reference Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReference.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReferenceValidValues","title":"<code>SubjectReferenceValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SubjectReferenceValidValues(Enum):\n    component = 'component'\n    inventory_item = 'inventory-item'\n    location = 'location'\n    party = 'party'\n    user = 'user'\n    resource = 'resource'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReferenceValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReferenceValidValues.component","title":"<code>component = 'component'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReferenceValidValues.inventory_item","title":"<code>inventory_item = 'inventory-item'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReferenceValidValues.location","title":"<code>location = 'location'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReferenceValidValues.party","title":"<code>party = 'party'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReferenceValidValues.resource","title":"<code>resource = 'resource'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SubjectReferenceValidValues.user","title":"<code>user = 'user'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent","title":"<code>SystemComponent</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A defined component that can be part of an implemented system.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SystemComponent(OscalBaseModel):\n    \"\"\"\n    A defined component that can be part of an implemented system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this component elsewhere in this or other OSCAL instances. The locally defined UUID of the component can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Component Identifier',\n    )\n    type: Union[constr(regex=r'^\\S(.*\\S)?$'), SystemComponentTypeValidValues] = Field(\n        ..., description='A category describing the purpose of the component.', title='Component Type'\n    )\n    title: str = Field(..., description='A human readable name for the system component.', title='Component Title')\n    description: str = Field(\n        ...,\n        description='A description of the component, including information about its function.',\n        title='Component Description'\n    )\n    purpose: Optional[str] = Field(\n        None, description='A summary of the technological or business purpose of the component.', title='Purpose'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    status: Status = Field(..., description='Describes the operational status of the system component.', title='Status')\n    responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')\n    protocols: Optional[List[Protocol]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.description","title":"<code>description: str = Field(..., description='A description of the component, including information about its function.', title='Component Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.protocols","title":"<code>protocols: Optional[List[Protocol]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.purpose","title":"<code>purpose: Optional[str] = Field(None, description='A summary of the technological or business purpose of the component.', title='Purpose')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.responsible_roles","title":"<code>responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.status","title":"<code>status: Status = Field(..., description='Describes the operational status of the system component.', title='Status')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.title","title":"<code>title: str = Field(..., description='A human readable name for the system component.', title='Component Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.type","title":"<code>type: Union[constr(regex='^\\\\S(.*\\\\S)?$'), SystemComponentTypeValidValues] = Field(..., description='A category describing the purpose of the component.', title='Component Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this component elsewhere in this or other OSCAL instances. The locally defined UUID of the component can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Component Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponent.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentOperationalStateValidValues","title":"<code>SystemComponentOperationalStateValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SystemComponentOperationalStateValidValues(Enum):\n    under_development = 'under-development'\n    operational = 'operational'\n    disposition = 'disposition'\n    other = 'other'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentOperationalStateValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentOperationalStateValidValues.disposition","title":"<code>disposition = 'disposition'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentOperationalStateValidValues.operational","title":"<code>operational = 'operational'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentOperationalStateValidValues.other","title":"<code>other = 'other'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentOperationalStateValidValues.under_development","title":"<code>under_development = 'under-development'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues","title":"<code>SystemComponentTypeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SystemComponentTypeValidValues(Enum):\n    this_system = 'this-system'\n    system = 'system'\n    interconnection = 'interconnection'\n    software = 'software'\n    hardware = 'hardware'\n    service = 'service'\n    policy = 'policy'\n    physical = 'physical'\n    process_procedure = 'process-procedure'\n    plan = 'plan'\n    guidance = 'guidance'\n    standard = 'standard'\n    validation = 'validation'\n    network = 'network'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.guidance","title":"<code>guidance = 'guidance'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.hardware","title":"<code>hardware = 'hardware'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.interconnection","title":"<code>interconnection = 'interconnection'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.network","title":"<code>network = 'network'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.physical","title":"<code>physical = 'physical'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.plan","title":"<code>plan = 'plan'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.policy","title":"<code>policy = 'policy'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.process_procedure","title":"<code>process_procedure = 'process-procedure'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.service","title":"<code>service = 'service'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.software","title":"<code>software = 'software'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.standard","title":"<code>standard = 'standard'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.system","title":"<code>system = 'system'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.this_system","title":"<code>this_system = 'this-system'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemComponentTypeValidValues.validation","title":"<code>validation = 'validation'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemId","title":"<code>SystemId</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A human-oriented, globally unique identifier with cross-instance scope that can be used to reference this system identification property elsewhere in this or other OSCAL instances. When referencing an externally defined system identification, the system identification must be used in the context of the external / imported OSCAL instance (e.g., uri-reference). This string should be assigned per-subject, which means it should be consistently used to identify the same system across revisions of the document.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SystemId(OscalBaseModel):\n    \"\"\"\n    A human-oriented, globally unique identifier with cross-instance scope that can be used to reference this system identification property elsewhere in this or other OSCAL instances. When referencing an externally defined system identification, the system identification must be used in the context of the external / imported OSCAL instance (e.g., uri-reference). This string should be assigned per-subject, which means it should be consistently used to identify the same system across revisions of the document.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    identifier_type: Optional[Union[AnyUrl, IdentifierType]] = Field(\n        None,\n        alias='identifier-type',\n        description='Identifies the identification system from which the provided identifier was assigned.',\n        title='Identification System Type'\n    )\n    id: constr(regex=r'^\\S(.*\\S)?$')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemId-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemId.id","title":"<code>id: constr(regex='^\\\\S(.*\\\\S)?$')</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemId.identifier_type","title":"<code>identifier_type: Optional[Union[AnyUrl, IdentifierType]] = Field(None, alias='identifier-type', description='Identifies the identification system from which the provided identifier was assigned.', title='Identification System Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemId-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemId.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser","title":"<code>SystemUser</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A type of user that interacts with the system based on an associated role.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class SystemUser(OscalBaseModel):\n    \"\"\"\n    A type of user that interacts with the system based on an associated role.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this user class elsewhere in this or other OSCAL instances. The locally defined UUID of the system user can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='User Universally Unique Identifier',\n    )\n    title: Optional[str] = Field(\n        None,\n        description='A name given to the user, which may be used by a tool for display and navigation.',\n        title='User Title'\n    )\n    short_name: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        alias='short-name',\n        description='A short common name, abbreviation, or acronym for the user.',\n        title='User Short Name'\n    )\n    description: Optional[str] = Field(\n        None, description=\"A summary of the user's purpose within the system.\", title='User Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    role_ids: Optional[List[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )]] = Field(\n        None, alias='role-ids'\n    )\n    authorized_privileges: Optional[List[AuthorizedPrivilege]] = Field(None, alias='authorized-privileges')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.authorized_privileges","title":"<code>authorized_privileges: Optional[List[AuthorizedPrivilege]] = Field(None, alias='authorized-privileges')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.description","title":"<code>description: Optional[str] = Field(None, description=\"A summary of the user's purpose within the system.\", title='User Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.role_ids","title":"<code>role_ids: Optional[List[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')]] = Field(None, alias='role-ids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.short_name","title":"<code>short_name: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='short-name', description='A short common name, abbreviation, or acronym for the user.', title='User Short Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.title","title":"<code>title: Optional[str] = Field(None, description='A name given to the user, which may be used by a tool for display and navigation.', title='User Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this user class elsewhere in this or other OSCAL instances. The locally defined UUID of the system user can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='User Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.SystemUser.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task","title":"<code>Task</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Represents a scheduled event or milestone, which may be associated with a series of assessment actions.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Task(OscalBaseModel):\n    \"\"\"\n    Represents a scheduled event or milestone, which may be associated with a series of assessment actions.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this task elsewhere in this or other OSCAL instances. The locally defined UUID of the task can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Task Universally Unique Identifier',\n    )\n    type: Union[TokenDatatype, TaskValidValues] = Field(..., description='The type of task.', title='Task Type')\n    title: str = Field(..., description='The title for this task.', title='Task Title')\n    description: Optional[str] = Field(\n        None, description='A human-readable description of this task.', title='Task Description'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    timing: Optional[Timing] = Field(\n        None, description='The timing under which the task is intended to occur.', title='Event Timing'\n    )\n    dependencies: Optional[List[Dependency]] = Field(None)\n    tasks: Optional[List[Task]] = None\n    associated_activities: Optional[List[AssociatedActivity]] = Field(None, alias='associated-activities')\n    subjects: Optional[List[AssessmentSubject]] = Field(None)\n    responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.associated_activities","title":"<code>associated_activities: Optional[List[AssociatedActivity]] = Field(None, alias='associated-activities')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.dependencies","title":"<code>dependencies: Optional[List[Dependency]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.description","title":"<code>description: Optional[str] = Field(None, description='A human-readable description of this task.', title='Task Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.responsible_roles","title":"<code>responsible_roles: Optional[List[ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.subjects","title":"<code>subjects: Optional[List[AssessmentSubject]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.tasks","title":"<code>tasks: Optional[List[Task]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.timing","title":"<code>timing: Optional[Timing] = Field(None, description='The timing under which the task is intended to occur.', title='Event Timing')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.title","title":"<code>title: str = Field(..., description='The title for this task.', title='Task Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.type","title":"<code>type: Union[TokenDatatype, TaskValidValues] = Field(..., description='The type of task.', title='Task Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this task elsewhere in this or other OSCAL instances. The locally defined UUID of the task can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Task Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Task.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TaskValidValues","title":"<code>TaskValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class TaskValidValues(Enum):\n    milestone = 'milestone'\n    action = 'action'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TaskValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TaskValidValues.action","title":"<code>action = 'action'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TaskValidValues.milestone","title":"<code>milestone = 'milestone'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneNumber","title":"<code>TelephoneNumber</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A telephone service number as defined by ITU-T E.164.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class TelephoneNumber(OscalBaseModel):\n    \"\"\"\n    A telephone service number as defined by ITU-T E.164.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    type: Optional[Union[StringDatatype, TelephoneTypeValidValues]] = Field(\n        None, description='Indicates the type of phone number.', title='type flag'\n    )\n    number: constr(regex=r'^\\S(.*\\S)?$')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneNumber-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneNumber.number","title":"<code>number: constr(regex='^\\\\S(.*\\\\S)?$')</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneNumber.type","title":"<code>type: Optional[Union[StringDatatype, TelephoneTypeValidValues]] = Field(None, description='Indicates the type of phone number.', title='type flag')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneNumber-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneNumber.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneTypeValidValues","title":"<code>TelephoneTypeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class TelephoneTypeValidValues(Enum):\n    home = 'home'\n    office = 'office'\n    mobile = 'mobile'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneTypeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneTypeValidValues.home","title":"<code>home = 'home'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneTypeValidValues.mobile","title":"<code>mobile = 'mobile'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TelephoneTypeValidValues.office","title":"<code>office = 'office'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Test","title":"<code>Test</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A test expression which is expected to be evaluated by a tool.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Test(OscalBaseModel):\n    \"\"\"\n    A test expression which is expected to be evaluated by a tool.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    expression: constr(\n        regex=r'^\\S(.*\\S)?$'\n    ) = Field(..., description='A formal (executable) expression of a constraint.', title='Constraint test')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Test-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Test.expression","title":"<code>expression: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description='A formal (executable) expression of a constraint.', title='Constraint test')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Test.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Test-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Test.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatId","title":"<code>ThreatId</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A pointer, by ID, to an externally-defined threat.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ThreatId(OscalBaseModel):\n    \"\"\"\n    A pointer, by ID, to an externally-defined threat.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    system: Union[URIDatatype, ThreatIdValidValues] = Field(\n        ..., description='Specifies the source of the threat information.', title='Threat Type Identification System'\n    )\n    href: Optional[str] = Field(\n        None,\n        description='An optional location for the threat data, from which this ID originates.',\n        title='Threat Information Resource Reference'\n    )\n    id: AnyUrl\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatId-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatId.href","title":"<code>href: Optional[str] = Field(None, description='An optional location for the threat data, from which this ID originates.', title='Threat Information Resource Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatId.id","title":"<code>id: AnyUrl</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatId.system","title":"<code>system: Union[URIDatatype, ThreatIdValidValues] = Field(..., description='Specifies the source of the threat information.', title='Threat Type Identification System')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatId-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatId.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatIdValidValues","title":"<code>ThreatIdValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class ThreatIdValidValues(Enum):\n    http___fedramp_gov = 'http://fedramp.gov'\n    http___fedramp_gov_ns_oscal = 'http://fedramp.gov/ns/oscal'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatIdValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov","title":"<code>http___fedramp_gov = 'http://fedramp.gov'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.ThreatIdValidValues.http___fedramp_gov_ns_oscal","title":"<code>http___fedramp_gov_ns_oscal = 'http://fedramp.gov/ns/oscal'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TimeUnitValidValues","title":"<code>TimeUnitValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class TimeUnitValidValues(Enum):\n    seconds = 'seconds'\n    minutes = 'minutes'\n    hours = 'hours'\n    days = 'days'\n    months = 'months'\n    years = 'years'\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TimeUnitValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TimeUnitValidValues.days","title":"<code>days = 'days'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TimeUnitValidValues.hours","title":"<code>hours = 'hours'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TimeUnitValidValues.minutes","title":"<code>minutes = 'minutes'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TimeUnitValidValues.months","title":"<code>months = 'months'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TimeUnitValidValues.seconds","title":"<code>seconds = 'seconds'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TimeUnitValidValues.years","title":"<code>years = 'years'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Timing","title":"<code>Timing</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The timing under which the task is intended to occur.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Timing(OscalBaseModel):\n    \"\"\"\n    The timing under which the task is intended to occur.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    on_date: Optional[OnDate] = Field(\n        None,\n        alias='on-date',\n        description='The task is intended to occur on the specified date.',\n        title='On Date Condition'\n    )\n    within_date_range: Optional[WithinDateRange] = Field(\n        None,\n        alias='within-date-range',\n        description='The task is intended to occur within the specified date range.',\n        title='On Date Range Condition'\n    )\n    at_frequency: Optional[AtFrequency] = Field(\n        None,\n        alias='at-frequency',\n        description='The task is intended to occur at the specified frequency.',\n        title='Frequency Condition'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Timing-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Timing.at_frequency","title":"<code>at_frequency: Optional[AtFrequency] = Field(None, alias='at-frequency', description='The task is intended to occur at the specified frequency.', title='Frequency Condition')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Timing.on_date","title":"<code>on_date: Optional[OnDate] = Field(None, alias='on-date', description='The task is intended to occur on the specified date.', title='On Date Condition')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Timing.within_date_range","title":"<code>within_date_range: Optional[WithinDateRange] = Field(None, alias='within-date-range', description='The task is intended to occur within the specified date range.', title='On Date Range Condition')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Timing-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Timing.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TokenDatatype","title":"<code>TokenDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class TokenDatatype(OscalBaseModel):\n    __root__: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        description=\n        'A non-colonized name as defined by XML Schema Part 2: Datatypes Second Edition. https://www.w3.org/TR/xmlschema11-2/#NCName.'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TokenDatatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.TokenDatatype.__root__","title":"<code>__root__: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., description='A non-colonized name as defined by XML Schema Part 2: Datatypes Second Edition. https://www.w3.org/TR/xmlschema11-2/#NCName.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.URIDatatype","title":"<code>URIDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class URIDatatype(OscalBaseModel):\n    __root__: AnyUrl = Field(..., description='A universal resource identifier (URI) formatted according to RFC3986.')\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.URIDatatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.URIDatatype.__root__","title":"<code>__root__: AnyUrl = Field(..., description='A universal resource identifier (URI) formatted according to RFC3986.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.URIReferenceDatatype","title":"<code>URIReferenceDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class URIReferenceDatatype(OscalBaseModel):\n    __root__: str = Field(\n        ...,\n        description=\n        'A URI Reference, either a URI or a relative-reference, formatted according to section 4.1 of RFC3986.'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.URIReferenceDatatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.URIReferenceDatatype.__root__","title":"<code>__root__: str = Field(..., description='A URI Reference, either a URI or a relative-reference, formatted according to section 4.1 of RFC3986.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UUIDDatatype","title":"<code>UUIDDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class UUIDDatatype(OscalBaseModel):\n    __root__: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(..., description=\"A type 4 ('random' or 'pseudorandom') or type 5 UUID per RFC 4122.\")\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UUIDDatatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UUIDDatatype.__root__","title":"<code>__root__: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description=\"A type 4 ('random' or 'pseudorandom') or type 5 UUID per RFC 4122.\")</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UsesComponent","title":"<code>UsesComponent</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The set of components that are used by the assessment platform.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class UsesComponent(OscalBaseModel):\n    \"\"\"\n    The set of components that are used by the assessment platform.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    component_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='component-uuid',\n        description=\n        'A machine-oriented identifier reference to a component that is implemented as part of an inventory item.',\n        title='Component Universally Unique Identifier Reference'\n    )\n    props: Optional[List[Property]] = Field(None)\n    links: Optional[List[Link]] = Field(None)\n    responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UsesComponent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UsesComponent.component_uuid","title":"<code>component_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='component-uuid', description='A machine-oriented identifier reference to a component that is implemented as part of an inventory item.', title='Component Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UsesComponent.links","title":"<code>links: Optional[List[Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UsesComponent.props","title":"<code>props: Optional[List[Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UsesComponent.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UsesComponent.responsible_parties","title":"<code>responsible_parties: Optional[List[ResponsibleParty]] = Field(None, alias='responsible-parties')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UsesComponent-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.UsesComponent.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Version","title":"<code>Version</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class Version(OscalBaseModel):\n    __root__: StringDatatype = Field(\n        ...,\n        description=\n        'Used to distinguish a specific revision of an OSCAL document from other previous and future versions.',\n        title='Document Version'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Version-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.Version.__root__","title":"<code>__root__: StringDatatype = Field(..., description='Used to distinguish a specific revision of an OSCAL document from other previous and future versions.', title='Document Version')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.WithinDateRange","title":"<code>WithinDateRange</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The task is intended to occur within the specified date range.</p> Source code in <code>trestle/oscal/common.py</code> <pre><code>class WithinDateRange(OscalBaseModel):\n    \"\"\"\n    The task is intended to occur within the specified date range.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    start: datetime = Field(\n        ..., description='The task must occur on or after the specified date.', title='Start Date Condition'\n    )\n    end: datetime = Field(\n        ..., description='The task must occur on or before the specified date.', title='End Date Condition'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.WithinDateRange-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.WithinDateRange.end","title":"<code>end: datetime = Field(..., description='The task must occur on or before the specified date.', title='End Date Condition')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.WithinDateRange.start","title":"<code>start: datetime = Field(..., description='The task must occur on or after the specified date.', title='Start Date Condition')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.WithinDateRange-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/common/#trestle.oscal.common.WithinDateRange.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/common.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/component/","title":"trestle.oscal.component","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component","title":"<code>trestle.oscal.component</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability","title":"<code>Capability</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A grouping of other components and/or capabilities.</p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class Capability(OscalBaseModel):\n    \"\"\"\n    A grouping of other components and/or capabilities.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n                 ) = Field(\n                     ...,\n                     description='Provides a globally unique means to identify a given capability.',\n                     title='Capability Identifier'\n                 )\n    name: constr(regex=r'^\\S(.*\\S)?$'\n                 ) = Field(..., description=\"The capability's human-readable name.\", title='Capability Name')\n    description: str = Field(..., description='A summary of the capability.', title='Capability Description')\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    incorporates_components: Optional[List[IncorporatesComponent]] = Field(None, alias='incorporates-components')\n    control_implementations: Optional[List[ControlImplementation]] = Field(None, alias='control-implementations')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability.control_implementations","title":"<code>control_implementations: Optional[List[ControlImplementation]] = Field(None, alias='control-implementations')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability.description","title":"<code>description: str = Field(..., description='A summary of the capability.', title='Capability Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability.incorporates_components","title":"<code>incorporates_components: Optional[List[IncorporatesComponent]] = Field(None, alias='incorporates-components')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability.name","title":"<code>name: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description=\"The capability's human-readable name.\", title='Capability Name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='Provides a globally unique means to identify a given capability.', title='Capability Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Capability.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/component.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition","title":"<code>ComponentDefinition</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A collection of component descriptions, which may optionally be grouped by capability.</p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class ComponentDefinition(OscalBaseModel):\n    \"\"\"\n    A collection of component descriptions, which may optionally be grouped by capability.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n                 ) = Field(\n                     ...,\n                     description='Provides a globally unique means to identify a given component definition instance.',\n                     title='Component Definition Universally Unique Identifier'\n                 )\n    metadata: common.Metadata\n    import_component_definitions: Optional[List[ImportComponentDefinition]] = Field(\n        None, alias='import-component-definitions'\n    )\n    components: Optional[List[DefinedComponent]] = Field(None)\n    capabilities: Optional[List[Capability]] = Field(None)\n    back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition.back_matter","title":"<code>back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition.capabilities","title":"<code>capabilities: Optional[List[Capability]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition.components","title":"<code>components: Optional[List[DefinedComponent]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition.import_component_definitions","title":"<code>import_component_definitions: Optional[List[ImportComponentDefinition]] = Field(None, alias='import-component-definitions')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition.metadata","title":"<code>metadata: common.Metadata</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='Provides a globally unique means to identify a given component definition instance.', title='Component Definition Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ComponentDefinition.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/component.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation","title":"<code>ControlImplementation</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Defines how the component or capability supports a set of controls.</p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class ControlImplementation(OscalBaseModel):\n    \"\"\"\n    Defines how the component or capability supports a set of controls.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'Provides a means to identify a set of control implementations that are supported by a given component or capability.',\n        title='Control Implementation Set Identifier'\n    )\n    source: str = Field(\n        ...,\n        description=\n        'A reference to an OSCAL catalog or profile providing the referenced control or subcontrol definition.',\n        title='Source Resource Reference'\n    )\n    description: str = Field(\n        ...,\n        description=\n        'A description of how the specified set of controls are implemented for the containing component or capability.',\n        title='Control Implementation Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')\n    implemented_requirements: List[ImplementedRequirement] = Field(..., alias='implemented-requirements')\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation.description","title":"<code>description: str = Field(..., description='A description of how the specified set of controls are implemented for the containing component or capability.', title='Control Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation.implemented_requirements","title":"<code>implemented_requirements: List[ImplementedRequirement] = Field(..., alias='implemented-requirements')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation.set_parameters","title":"<code>set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation.source","title":"<code>source: str = Field(..., description='A reference to an OSCAL catalog or profile providing the referenced control or subcontrol definition.', title='Source Resource Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='Provides a means to identify a set of control implementations that are supported by a given component or capability.', title='Control Implementation Set Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ControlImplementation.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/component.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent","title":"<code>DefinedComponent</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A defined component that can be part of an implemented system.</p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class DefinedComponent(OscalBaseModel):\n    \"\"\"\n    A defined component that can be part of an implemented system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n                 ) = Field(\n                     ...,\n                     description='Provides a globally unique means to identify a given component.',\n                     title='Component Identifier'\n                 )\n    type: Union[constr(regex=r'^\\S(.*\\S)?$'), DefinedComponentTypeValidValues] = Field(\n        ..., description='A category describing the purpose of the component.', title='Component Type'\n    )\n    title: str = Field(..., description='A human readable name for the component.', title='Component Title')\n    description: str = Field(\n        ...,\n        description='A description of the component, including information about its function.',\n        title='Component Description'\n    )\n    purpose: Optional[str] = Field(\n        None, description='A summary of the technological or business purpose of the component.', title='Purpose'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    protocols: Optional[List[common.Protocol]] = Field(None)\n    control_implementations: Optional[List[ControlImplementation]] = Field(None, alias='control-implementations')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.control_implementations","title":"<code>control_implementations: Optional[List[ControlImplementation]] = Field(None, alias='control-implementations')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.description","title":"<code>description: str = Field(..., description='A description of the component, including information about its function.', title='Component Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.protocols","title":"<code>protocols: Optional[List[common.Protocol]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.purpose","title":"<code>purpose: Optional[str] = Field(None, description='A summary of the technological or business purpose of the component.', title='Purpose')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.title","title":"<code>title: str = Field(..., description='A human readable name for the component.', title='Component Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.type","title":"<code>type: Union[constr(regex='^\\\\S(.*\\\\S)?$'), DefinedComponentTypeValidValues] = Field(..., description='A category describing the purpose of the component.', title='Component Type')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='Provides a globally unique means to identify a given component.', title='Component Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponent.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/component.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues","title":"<code>DefinedComponentTypeValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class DefinedComponentTypeValidValues(Enum):\n    interconnection = 'interconnection'\n    software = 'software'\n    hardware = 'hardware'\n    service = 'service'\n    policy = 'policy'\n    physical = 'physical'\n    process_procedure = 'process-procedure'\n    plan = 'plan'\n    guidance = 'guidance'\n    standard = 'standard'\n    validation = 'validation'\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.guidance","title":"<code>guidance = 'guidance'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.hardware","title":"<code>hardware = 'hardware'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.interconnection","title":"<code>interconnection = 'interconnection'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.physical","title":"<code>physical = 'physical'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.plan","title":"<code>plan = 'plan'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.policy","title":"<code>policy = 'policy'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.process_procedure","title":"<code>process_procedure = 'process-procedure'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.service","title":"<code>service = 'service'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.software","title":"<code>software = 'software'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.standard","title":"<code>standard = 'standard'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.DefinedComponentTypeValidValues.validation","title":"<code>validation = 'validation'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement","title":"<code>ImplementedRequirement</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes how the containing component or capability implements an individual control.</p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class ImplementedRequirement(OscalBaseModel):\n    \"\"\"\n    Describes how the containing component or capability implements an individual control.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description='Provides a globally unique means to identify a given control implementation by a component.',\n        title='Control Implementation Identifier'\n    )\n    control_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='control-id',\n        description=\n        'A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).',\n        title='Control Identifier Reference'\n    )\n    description: str = Field(\n        ...,\n        description=\n        'A suggestion from the supplier (e.g., component vendor or author) for how the specified control may be implemented if the containing component or capability is instantiated in a system security plan.',\n        title='Control Implementation Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    statements: Optional[List[Statement]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.control_id","title":"<code>control_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='control-id', description='A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).', title='Control Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.description","title":"<code>description: str = Field(..., description='A suggestion from the supplier (e.g., component vendor or author) for how the specified control may be implemented if the containing component or capability is instantiated in a system security plan.', title='Control Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.set_parameters","title":"<code>set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.statements","title":"<code>statements: Optional[List[Statement]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='Provides a globally unique means to identify a given control implementation by a component.', title='Control Implementation Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImplementedRequirement.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/component.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImportComponentDefinition","title":"<code>ImportComponentDefinition</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Loads a component definition from another resource.</p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class ImportComponentDefinition(OscalBaseModel):\n    \"\"\"\n    Loads a component definition from another resource.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    href: str = Field(\n        ...,\n        description=\n        'A link to a resource that defines a set of components and/or capabilities to import into this collection.',\n        title='Hyperlink Reference'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImportComponentDefinition-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImportComponentDefinition.href","title":"<code>href: str = Field(..., description='A link to a resource that defines a set of components and/or capabilities to import into this collection.', title='Hyperlink Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImportComponentDefinition-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.ImportComponentDefinition.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/component.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.IncorporatesComponent","title":"<code>IncorporatesComponent</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The collection of components comprising this capability.</p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class IncorporatesComponent(OscalBaseModel):\n    \"\"\"\n    The collection of components comprising this capability.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    component_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='component-uuid',\n        description='A machine-oriented identifier reference to a component.',\n        title='Component Reference'\n    )\n    description: str = Field(\n        ...,\n        description='A description of the component, including information about its function.',\n        title='Component Description'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.IncorporatesComponent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.IncorporatesComponent.component_uuid","title":"<code>component_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='component-uuid', description='A machine-oriented identifier reference to a component.', title='Component Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.IncorporatesComponent.description","title":"<code>description: str = Field(..., description='A description of the component, including information about its function.', title='Component Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.IncorporatesComponent-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.IncorporatesComponent.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/component.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Model","title":"<code>Model</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class Model(OscalBaseModel):\n    component_definition: ComponentDefinition = Field(..., alias='component-definition')\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Model-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Model.component_definition","title":"<code>component_definition: ComponentDefinition = Field(..., alias='component-definition')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.SetParameter","title":"<code>SetParameter</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies the parameter that will be set by the enclosed value.</p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class SetParameter(OscalBaseModel):\n    \"\"\"\n    Identifies the parameter that will be set by the enclosed value.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    param_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='param-id',\n        description=\n        \"A human-oriented reference to a parameter within a control, who's catalog has been imported into the current implementation context.\",\n        title='Parameter ID'\n    )\n    values: List[constr(regex=r'^\\S(.*\\S)?$')] = Field(...)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.SetParameter-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.SetParameter.param_id","title":"<code>param_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='param-id', description=\"A human-oriented reference to a parameter within a control, who's catalog has been imported into the current implementation context.\", title='Parameter ID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.SetParameter.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.SetParameter.values","title":"<code>values: List[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.SetParameter-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.SetParameter.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/component.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement","title":"<code>Statement</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies which statements within a control are addressed.</p> Source code in <code>trestle/oscal/component.py</code> <pre><code>class Statement(OscalBaseModel):\n    \"\"\"\n    Identifies which statements within a control are addressed.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    statement_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='statement-id',\n        description='A human-oriented identifier reference to a control statement.',\n        title='Control Statement Reference'\n    )\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).',\n        title='Control Statement Reference Universally Unique Identifier'\n    )\n    description: str = Field(\n        ...,\n        description='A summary of how the containing control statement is implemented by the component or capability.',\n        title='Statement Implementation Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement.description","title":"<code>description: str = Field(..., description='A summary of how the containing control statement is implemented by the component or capability.', title='Statement Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement.statement_id","title":"<code>statement_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='statement-id', description='A human-oriented identifier reference to a control statement.', title='Control Statement Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).', title='Control Statement Reference Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/component/#trestle.oscal.component.Statement.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/component.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/poam/","title":"trestle.oscal.poam","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam","title":"<code>trestle.oscal.poam</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.LocalDefinitions","title":"<code>LocalDefinitions</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Allows components, and inventory-items to be defined within the POA&amp;M for circumstances where no OSCAL-based SSP exists, or is not delivered with the POA&amp;M.</p> Source code in <code>trestle/oscal/poam.py</code> <pre><code>class LocalDefinitions(OscalBaseModel):\n    \"\"\"\n    Allows components, and inventory-items to be defined within the POA&amp;M for circumstances where no OSCAL-based SSP exists, or is not delivered with the POA&amp;M.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    components: Optional[List[common.SystemComponent]] = Field(None)\n    inventory_items: Optional[List[common.InventoryItem]] = Field(None, alias='inventory-items')\n    assessment_assets: Optional[common.AssessmentAssets] = Field(None, alias='assessment-assets')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.LocalDefinitions-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.LocalDefinitions.assessment_assets","title":"<code>assessment_assets: Optional[common.AssessmentAssets] = Field(None, alias='assessment-assets')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.LocalDefinitions.components","title":"<code>components: Optional[List[common.SystemComponent]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.LocalDefinitions.inventory_items","title":"<code>inventory_items: Optional[List[common.InventoryItem]] = Field(None, alias='inventory-items')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.LocalDefinitions.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.LocalDefinitions-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.LocalDefinitions.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/poam.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.Model","title":"<code>Model</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/poam.py</code> <pre><code>class Model(OscalBaseModel):\n    plan_of_action_and_milestones: PlanOfActionAndMilestones = Field(..., alias='plan-of-action-and-milestones')\n</code></pre>"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.Model-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.Model.plan_of_action_and_milestones","title":"<code>plan_of_action_and_milestones: PlanOfActionAndMilestones = Field(..., alias='plan-of-action-and-milestones')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.Origination","title":"<code>Origination</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies the source of the finding, such as a tool or person.</p> Source code in <code>trestle/oscal/poam.py</code> <pre><code>class Origination(OscalBaseModel):\n    \"\"\"\n    Identifies the source of the finding, such as a tool or person.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    actors: List[common.OriginActor] = Field(...)\n</code></pre>"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.Origination-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.Origination.actors","title":"<code>actors: List[common.OriginActor] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.Origination-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.Origination.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/poam.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones","title":"<code>PlanOfActionAndMilestones</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A plan of action and milestones which identifies initial and residual risks, deviations, and disposition, such as those required by FedRAMP.</p> Source code in <code>trestle/oscal/poam.py</code> <pre><code>class PlanOfActionAndMilestones(OscalBaseModel):\n    \"\"\"\n    A plan of action and milestones which identifies initial and residual risks, deviations, and disposition, such as those required by FedRAMP.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with instancescope that can be used to reference this POA&amp;M instance in this OSCAL instance. This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='POA&amp;M Universally Unique Identifier'\n    )\n    metadata: common.Metadata\n    import_ssp: Optional[common.ImportSsp] = Field(None, alias='import-ssp')\n    system_id: Optional[common.SystemId] = Field(None, alias='system-id')\n    local_definitions: Optional[LocalDefinitions] = Field(None, alias='local-definitions')\n    observations: Optional[List[common.Observation]] = Field(None)\n    risks: Optional[List[common.Risk]] = Field(None)\n    findings: Optional[List[common.Finding]] = Field(None)\n    poam_items: List[PoamItem] = Field(..., alias='poam-items')\n    back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')\n</code></pre>"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.back_matter","title":"<code>back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.findings","title":"<code>findings: Optional[List[common.Finding]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.import_ssp","title":"<code>import_ssp: Optional[common.ImportSsp] = Field(None, alias='import-ssp')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.local_definitions","title":"<code>local_definitions: Optional[LocalDefinitions] = Field(None, alias='local-definitions')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.metadata","title":"<code>metadata: common.Metadata</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.observations","title":"<code>observations: Optional[List[common.Observation]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.poam_items","title":"<code>poam_items: List[PoamItem] = Field(..., alias='poam-items')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.risks","title":"<code>risks: Optional[List[common.Risk]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.system_id","title":"<code>system_id: Optional[common.SystemId] = Field(None, alias='system-id')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with instancescope that can be used to reference this POA&amp;M instance in this OSCAL instance. This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='POA&amp;M Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PlanOfActionAndMilestones.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/poam.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem","title":"<code>PoamItem</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes an individual POA&amp;M item.</p> Source code in <code>trestle/oscal/poam.py</code> <pre><code>class PoamItem(OscalBaseModel):\n    \"\"\"\n    Describes an individual POA&amp;M item.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None,\n        description=\n        'A machine-oriented, globally unique identifier with instance scope that can be used to reference this POA&amp;M item entry in this OSCAL instance. This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='POA&amp;M Item Universally Unique Identifier'\n    )\n    title: str = Field(..., description='The title or name for this POA&amp;M item .', title='POA&amp;M Item Title')\n    description: str = Field(\n        ..., description='A human-readable description of POA&amp;M item.', title='POA&amp;M Item Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    related_findings: Optional[List[RelatedFinding]] = Field(None, alias='related-findings')\n    related_observations: Optional[List[common.RelatedObservation]] = Field(None, alias='related-observations')\n    related_risks: Optional[List[common.RelatedRisk]] = Field(None, alias='related-risks')\n    remarks: Optional[str] = None\n    origins: Optional[List[Origination]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.description","title":"<code>description: str = Field(..., description='A human-readable description of POA&amp;M item.', title='POA&amp;M Item Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.origins","title":"<code>origins: Optional[List[Origination]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.related_findings","title":"<code>related_findings: Optional[List[RelatedFinding]] = Field(None, alias='related-findings')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.related_observations","title":"<code>related_observations: Optional[List[common.RelatedObservation]] = Field(None, alias='related-observations')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.related_risks","title":"<code>related_risks: Optional[List[common.RelatedRisk]] = Field(None, alias='related-risks')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.title","title":"<code>title: str = Field(..., description='The title or name for this POA&amp;M item .', title='POA&amp;M Item Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.uuid","title":"<code>uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, description='A machine-oriented, globally unique identifier with instance scope that can be used to reference this POA&amp;M item entry in this OSCAL instance. This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='POA&amp;M Item Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.PoamItem.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/poam.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.RelatedFinding","title":"<code>RelatedFinding</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Relates the finding to referenced finding(s).</p> Source code in <code>trestle/oscal/poam.py</code> <pre><code>class RelatedFinding(OscalBaseModel):\n    \"\"\"\n    Relates the finding to referenced finding(s).\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    finding_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='finding-uuid',\n        description='A machine-oriented identifier reference to a finding defined in the list of findings.',\n        title='Finding Universally Unique Identifier Reference'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.RelatedFinding-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.RelatedFinding.finding_uuid","title":"<code>finding_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='finding-uuid', description='A machine-oriented identifier reference to a finding defined in the list of findings.', title='Finding Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.RelatedFinding-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/poam/#trestle.oscal.poam.RelatedFinding.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/poam.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/","title":"trestle.oscal.profile","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile","title":"<code>trestle.oscal.profile</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add","title":"<code>Add</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Specifies contents to be added into controls, in resolution.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Add(OscalBaseModel):\n    \"\"\"\n    Specifies contents to be added into controls, in resolution.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    position: Optional[PositionValidValues] = Field(\n        None,\n        description='Where to add the new content with respect to the targeted element (beside it or inside it).',\n        title='Position'\n    )\n    by_id: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None, alias='by-id', description='Target location of the addition.', title='Reference by ID'\n    )\n    title: Optional[str] = Field(\n        None,\n        description='A name given to the control, which may be used by a tool for display and navigation.',\n        title='Title Change'\n    )\n    params: Optional[List[common.Parameter]] = Field(None)\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    parts: Optional[List[common.Part]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add.by_id","title":"<code>by_id: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='by-id', description='Target location of the addition.', title='Reference by ID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add.params","title":"<code>params: Optional[List[common.Parameter]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add.parts","title":"<code>parts: Optional[List[common.Part]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add.position","title":"<code>position: Optional[PositionValidValues] = Field(None, description='Where to add the new content with respect to the targeted element (beside it or inside it).', title='Position')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add.title","title":"<code>title: Optional[str] = Field(None, description='A name given to the control, which may be used by a tool for display and navigation.', title='Title Change')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Add.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Alter","title":"<code>Alter</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Specifies changes to be made to an included control when a profile is resolved.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Alter(OscalBaseModel):\n    \"\"\"\n    Specifies changes to be made to an included control when a profile is resolved.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    control_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='control-id',\n        description=\n        'A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).',\n        title='Control Identifier Reference'\n    )\n    removes: Optional[List[Remove]] = Field(None)\n    adds: Optional[List[Add]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Alter-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Alter.adds","title":"<code>adds: Optional[List[Add]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Alter.control_id","title":"<code>control_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='control-id', description='A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).', title='Control Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Alter.removes","title":"<code>removes: Optional[List[Remove]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Alter-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Alter.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.BooleanDatatype","title":"<code>BooleanDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class BooleanDatatype(OscalBaseModel):\n    __root__: bool = Field(..., description='A binary value that is either: true or false.')\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.BooleanDatatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.BooleanDatatype.__root__","title":"<code>__root__: bool = Field(..., description='A binary value that is either: true or false.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.CombinationMethodValidValues","title":"<code>CombinationMethodValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class CombinationMethodValidValues(Enum):\n    use_first = 'use-first'\n    merge = 'merge'\n    keep = 'keep'\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.CombinationMethodValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.CombinationMethodValidValues.keep","title":"<code>keep = 'keep'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.CombinationMethodValidValues.merge","title":"<code>merge = 'merge'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.CombinationMethodValidValues.use_first","title":"<code>use_first = 'use-first'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Combine","title":"<code>Combine</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A Combine element defines how to resolve duplicate instances of the same control (e.g., controls with the same ID).</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Combine(OscalBaseModel):\n    \"\"\"\n    A Combine element defines how to resolve duplicate instances of the same control (e.g., controls with the same ID).\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    method: Optional[CombinationMethodValidValues] = Field(\n        None, description='Declare how clashing controls should be handled.', title='Combination Method'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Combine-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Combine.method","title":"<code>method: Optional[CombinationMethodValidValues] = Field(None, description='Declare how clashing controls should be handled.', title='Combination Method')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Combine-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Combine.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Custom","title":"<code>Custom</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Provides an alternate grouping structure that selected controls will be placed in.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Custom(OscalBaseModel):\n    \"\"\"\n    Provides an alternate grouping structure that selected controls will be placed in.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    groups: Optional[List[Group]] = Field(None)\n    insert_controls: Optional[List[InsertControls]] = Field(None, alias='insert-controls')\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Custom-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Custom.groups","title":"<code>groups: Optional[List[Group]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Custom.insert_controls","title":"<code>insert_controls: Optional[List[InsertControls]] = Field(None, alias='insert-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Custom-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Custom.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group","title":"<code>Group</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A group of (selected) controls or of groups of controls.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Group(OscalBaseModel):\n    \"\"\"\n    A group of (selected) controls or of groups of controls.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    id: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None, description='Identifies the group.', title='Group Identifier'\n    )\n    class_: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='class',\n        description='A textual label that provides a sub-type or characterization of the group.',\n        title='Group Class'\n    )\n    title: str = Field(..., description='A name to be given to the group for use in display.', title='Group Title')\n    params: Optional[List[common.Parameter]] = Field(None)\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    parts: Optional[List[common.Part]] = Field(None)\n    groups: Optional[List[Group]] = None\n    insert_controls: Optional[List[InsertControls]] = Field(None, alias='insert-controls')\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.class_","title":"<code>class_: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='class', description='A textual label that provides a sub-type or characterization of the group.', title='Group Class')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.groups","title":"<code>groups: Optional[List[Group]] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.id","title":"<code>id: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, description='Identifies the group.', title='Group Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.insert_controls","title":"<code>insert_controls: Optional[List[InsertControls]] = Field(None, alias='insert-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.params","title":"<code>params: Optional[List[common.Parameter]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.parts","title":"<code>parts: Optional[List[common.Part]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.title","title":"<code>title: str = Field(..., description='A name to be given to the group for use in display.', title='Group Title')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Group.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Import","title":"<code>Import</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Designates a referenced source catalog or profile that provides a source of control information for use in creating a new overlay or baseline.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Import(OscalBaseModel):\n    \"\"\"\n    Designates a referenced source catalog or profile that provides a source of control information for use in creating a new overlay or baseline.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    href: str = Field(\n        ...,\n        description='A resolvable URL reference to the base catalog or profile that this profile is tailoring.',\n        title='Catalog or Profile Reference'\n    )\n    include_all: Optional[common.IncludeAll] = Field(None, alias='include-all')\n    include_controls: Optional[List[SelectControl]] = Field(None, alias='include-controls')\n    exclude_controls: Optional[List[SelectControl]] = Field(None, alias='exclude-controls')\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Import-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Import.exclude_controls","title":"<code>exclude_controls: Optional[List[SelectControl]] = Field(None, alias='exclude-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Import.href","title":"<code>href: str = Field(..., description='A resolvable URL reference to the base catalog or profile that this profile is tailoring.', title='Catalog or Profile Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Import.include_all","title":"<code>include_all: Optional[common.IncludeAll] = Field(None, alias='include-all')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Import.include_controls","title":"<code>include_controls: Optional[List[SelectControl]] = Field(None, alias='include-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Import-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Import.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.InsertControls","title":"<code>InsertControls</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Specifies which controls to use in the containing context.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class InsertControls(OscalBaseModel):\n    \"\"\"\n    Specifies which controls to use in the containing context.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    order: Optional[OrderValidValues] = Field(\n        None, description='A designation of how a selection of controls in a profile is to be ordered.', title='Order'\n    )\n    include_all: Optional[common.IncludeAll] = Field(None, alias='include-all')\n    include_controls: Optional[List[SelectControl]] = Field(None, alias='include-controls')\n    exclude_controls: Optional[List[SelectControl]] = Field(None, alias='exclude-controls')\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.InsertControls-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.InsertControls.exclude_controls","title":"<code>exclude_controls: Optional[List[SelectControl]] = Field(None, alias='exclude-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.InsertControls.include_all","title":"<code>include_all: Optional[common.IncludeAll] = Field(None, alias='include-all')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.InsertControls.include_controls","title":"<code>include_controls: Optional[List[SelectControl]] = Field(None, alias='include-controls')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.InsertControls.order","title":"<code>order: Optional[OrderValidValues] = Field(None, description='A designation of how a selection of controls in a profile is to be ordered.', title='Order')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.InsertControls-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.InsertControls.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.ItemNameValidValues","title":"<code>ItemNameValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class ItemNameValidValues(Enum):\n    param = 'param'\n    prop = 'prop'\n    link = 'link'\n    part = 'part'\n    mapping = 'mapping'\n    map = 'map'\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.ItemNameValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.ItemNameValidValues.link","title":"<code>link = 'link'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.ItemNameValidValues.map","title":"<code>map = 'map'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.ItemNameValidValues.mapping","title":"<code>mapping = 'mapping'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.ItemNameValidValues.param","title":"<code>param = 'param'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.ItemNameValidValues.part","title":"<code>part = 'part'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.ItemNameValidValues.prop","title":"<code>prop = 'prop'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Matching","title":"<code>Matching</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Selecting a set of controls by matching their IDs with a wildcard pattern.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Matching(OscalBaseModel):\n    \"\"\"\n    Selecting a set of controls by matching their IDs with a wildcard pattern.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    pattern: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None, description='A glob expression matching the IDs of one or more controls to be selected.', title='Pattern'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Matching-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Matching.pattern","title":"<code>pattern: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, description='A glob expression matching the IDs of one or more controls to be selected.', title='Pattern')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Matching-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Matching.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Merge","title":"<code>Merge</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Provides structuring directives that instruct how controls are organized after profile resolution.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Merge(OscalBaseModel):\n    \"\"\"\n    Provides structuring directives that instruct how controls are organized after profile resolution.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    combine: Optional[Combine] = Field(\n        None,\n        description=\n        'A Combine element defines how to resolve duplicate instances of the same control (e.g., controls with the same ID).',\n        title='Combination Rule'\n    )\n    flat: Optional[Dict[str, Any]] = Field(\n        None, description='Directs that controls appear without any grouping structure.', title='Flat Without Grouping'\n    )\n    as_is: Optional[BooleanDatatype] = Field(\n        None,\n        alias='as-is',\n        description=\n        'Indicates that the controls selected should retain their original grouping as defined in the import source.',\n        title='Group As-Is'\n    )\n    custom: Optional[Custom] = Field(\n        None,\n        description='Provides an alternate grouping structure that selected controls will be placed in.',\n        title='Custom Grouping'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Merge-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Merge.as_is","title":"<code>as_is: Optional[BooleanDatatype] = Field(None, alias='as-is', description='Indicates that the controls selected should retain their original grouping as defined in the import source.', title='Group As-Is')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Merge.combine","title":"<code>combine: Optional[Combine] = Field(None, description='A Combine element defines how to resolve duplicate instances of the same control (e.g., controls with the same ID).', title='Combination Rule')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Merge.custom","title":"<code>custom: Optional[Custom] = Field(None, description='Provides an alternate grouping structure that selected controls will be placed in.', title='Custom Grouping')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Merge.flat","title":"<code>flat: Optional[Dict[str, Any]] = Field(None, description='Directs that controls appear without any grouping structure.', title='Flat Without Grouping')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Merge-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Merge.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Model","title":"<code>Model</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Model(OscalBaseModel):\n    profile: Profile\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Model-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Model.profile","title":"<code>profile: Profile</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Modify","title":"<code>Modify</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Set parameters or amend controls in resolution.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Modify(OscalBaseModel):\n    \"\"\"\n    Set parameters or amend controls in resolution.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')\n    alters: Optional[List[Alter]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Modify-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Modify.alters","title":"<code>alters: Optional[List[Alter]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Modify.set_parameters","title":"<code>set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Modify-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Modify.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.OrderValidValues","title":"<code>OrderValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class OrderValidValues(Enum):\n    keep = 'keep'\n    ascending = 'ascending'\n    descending = 'descending'\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.OrderValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.OrderValidValues.ascending","title":"<code>ascending = 'ascending'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.OrderValidValues.descending","title":"<code>descending = 'descending'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.OrderValidValues.keep","title":"<code>keep = 'keep'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.PositionValidValues","title":"<code>PositionValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class PositionValidValues(Enum):\n    before = 'before'\n    after = 'after'\n    starting = 'starting'\n    ending = 'ending'\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.PositionValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.PositionValidValues.after","title":"<code>after = 'after'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.PositionValidValues.before","title":"<code>before = 'before'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.PositionValidValues.ending","title":"<code>ending = 'ending'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.PositionValidValues.starting","title":"<code>starting = 'starting'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile","title":"<code>Profile</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Each OSCAL profile is defined by a profile element.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Profile(OscalBaseModel):\n    \"\"\"\n    Each OSCAL profile is defined by a profile element.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n                 ) = Field(\n                     ...,\n                     description='Provides a globally unique means to identify a given profile instance.',\n                     title='Profile Universally Unique Identifier'\n                 )\n    metadata: common.Metadata\n    imports: List[Import] = Field(...)\n    merge: Optional[Merge] = None\n    modify: Optional[Modify] = None\n    back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile.back_matter","title":"<code>back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile.imports","title":"<code>imports: List[Import] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile.merge","title":"<code>merge: Optional[Merge] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile.metadata","title":"<code>metadata: common.Metadata</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile.modify","title":"<code>modify: Optional[Modify] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='Provides a globally unique means to identify a given profile instance.', title='Profile Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Profile.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Remove","title":"<code>Remove</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Specifies objects to be removed from a control based on specific aspects of the object that must all match.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Remove(OscalBaseModel):\n    \"\"\"\n    Specifies objects to be removed from a control based on specific aspects of the object that must all match.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    by_name: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='by-name',\n        description='Identify items remove by matching their assigned name.',\n        title='Reference by (assigned) name'\n    )\n    by_class: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='by-class',\n        description='Identify items to remove by matching their class.',\n        title='Reference by class'\n    )\n    by_id: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None, alias='by-id', description='Identify items to remove indicated by their id.', title='Reference by ID'\n    )\n    by_item_name: Optional[ItemNameValidValues] = Field(\n        None,\n        alias='by-item-name',\n        description=\"Identify items to remove by the name of the item's information object name, e.g. title or prop.\",\n        title='Item Name Reference'\n    )\n    by_ns: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='by-ns',\n        description=\"Identify items to remove by the item's ns, which is the namespace associated with a part, or prop.\",\n        title='Item Namespace Reference'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Remove-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Remove.by_class","title":"<code>by_class: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='by-class', description='Identify items to remove by matching their class.', title='Reference by class')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Remove.by_id","title":"<code>by_id: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='by-id', description='Identify items to remove indicated by their id.', title='Reference by ID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Remove.by_item_name","title":"<code>by_item_name: Optional[ItemNameValidValues] = Field(None, alias='by-item-name', description=\"Identify items to remove by the name of the item's information object name, e.g. title or prop.\", title='Item Name Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Remove.by_name","title":"<code>by_name: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='by-name', description='Identify items remove by matching their assigned name.', title='Reference by (assigned) name')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Remove.by_ns","title":"<code>by_ns: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='by-ns', description=\"Identify items to remove by the item's ns, which is the namespace associated with a part, or prop.\", title='Item Namespace Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Remove-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.Remove.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SelectControl","title":"<code>SelectControl</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Select a control or controls from an imported control set.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class SelectControl(OscalBaseModel):\n    \"\"\"\n    Select a control or controls from an imported control set.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    with_child_controls: Optional[WithChildControlsValidValues] = Field(\n        None,\n        alias='with-child-controls',\n        description='When a control is included, whether its child (dependent) controls are also included.',\n        title='Include Contained Controls with Control'\n    )\n    with_ids: Optional[List[WithId]] = Field(None, alias='with-ids')\n    matching: Optional[List[Matching]] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SelectControl-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SelectControl.matching","title":"<code>matching: Optional[List[Matching]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SelectControl.with_child_controls","title":"<code>with_child_controls: Optional[WithChildControlsValidValues] = Field(None, alias='with-child-controls', description='When a control is included, whether its child (dependent) controls are also included.', title='Include Contained Controls with Control')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SelectControl.with_ids","title":"<code>with_ids: Optional[List[WithId]] = Field(None, alias='with-ids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SelectControl-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SelectControl.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter","title":"<code>SetParameter</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A parameter setting, to be propagated to points of insertion.</p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class SetParameter(OscalBaseModel):\n    \"\"\"\n    A parameter setting, to be propagated to points of insertion.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    param_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(..., alias='param-id', description='An identifier for the parameter.', title='Parameter ID')\n    class_: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='class',\n        description='A textual label that provides a characterization of the parameter.',\n        title='Parameter Class'\n    )\n    depends_on: Optional[constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    )] = Field(\n        None,\n        alias='depends-on',\n        description=\n        '**(deprecated)** Another parameter invoking this one. This construct has been deprecated and should not be used.',\n        title='Depends On'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    label: Optional[str] = Field(\n        None,\n        description=\n        'A short, placeholder name for the parameter, which can be used as a substitute for a value if no value is assigned.',\n        title='Parameter Label'\n    )\n    usage: Optional[str] = Field(\n        None, description='Describes the purpose and use of a parameter.', title='Parameter Usage Description'\n    )\n    constraints: Optional[List[common.ParameterConstraint]] = Field(None)\n    guidelines: Optional[List[common.ParameterGuideline]] = Field(None)\n    values: Optional[List[constr(regex=r'^\\S(.*\\S)?$')]] = Field(None)\n    select: Optional[common.ParameterSelection] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.class_","title":"<code>class_: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='class', description='A textual label that provides a characterization of the parameter.', title='Parameter Class')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.constraints","title":"<code>constraints: Optional[List[common.ParameterConstraint]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.depends_on","title":"<code>depends_on: Optional[constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$')] = Field(None, alias='depends-on', description='**(deprecated)** Another parameter invoking this one. This construct has been deprecated and should not be used.', title='Depends On')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.guidelines","title":"<code>guidelines: Optional[List[common.ParameterGuideline]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.label","title":"<code>label: Optional[str] = Field(None, description='A short, placeholder name for the parameter, which can be used as a substitute for a value if no value is assigned.', title='Parameter Label')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.param_id","title":"<code>param_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='param-id', description='An identifier for the parameter.', title='Parameter ID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.select","title":"<code>select: Optional[common.ParameterSelection] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.usage","title":"<code>usage: Optional[str] = Field(None, description='Describes the purpose and use of a parameter.', title='Parameter Usage Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.values","title":"<code>values: Optional[List[constr(regex='^\\\\S(.*\\\\S)?$')]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.SetParameter.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/profile.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.WithChildControlsValidValues","title":"<code>WithChildControlsValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class WithChildControlsValidValues(Enum):\n    yes = 'yes'\n    no = 'no'\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.WithChildControlsValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.WithChildControlsValidValues.no","title":"<code>no = 'no'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.WithChildControlsValidValues.yes","title":"<code>yes = 'yes'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.WithId","title":"<code>WithId</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/profile.py</code> <pre><code>class WithId(OscalBaseModel):\n    __root__: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ..., description='Selecting a control by its ID given as a literal.', title='Match Controls by Identifier'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.WithId-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/profile/#trestle.oscal.profile.WithId.__root__","title":"<code>__root__: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., description='Selecting a control by its ID given as a literal.', title='Match Controls by Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/","title":"trestle.oscal.ssp","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp","title":"<code>trestle.oscal.ssp</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AdjustmentJustification","title":"<code>AdjustmentJustification</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class AdjustmentJustification(OscalBaseModel):\n    __root__: str = Field(\n        ...,\n        description=\n        'If the selected security level is different from the base security level, this contains the justification for the change.',\n        title='Adjustment Justification'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AdjustmentJustification-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AdjustmentJustification.__root__","title":"<code>__root__: str = Field(..., description='If the selected security level is different from the base security level, this contains the justification for the change.', title='Adjustment Justification')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AuthorizationBoundary","title":"<code>AuthorizationBoundary</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A description of this system's authorization boundary, optionally supplemented by diagrams that illustrate the authorization boundary.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class AuthorizationBoundary(OscalBaseModel):\n    \"\"\"\n    A description of this system's authorization boundary, optionally supplemented by diagrams that illustrate the authorization boundary.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    description: str = Field(\n        ...,\n        description=\"A summary of the system's authorization boundary.\",\n        title='Authorization Boundary Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    diagrams: Optional[List[Diagram]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AuthorizationBoundary-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AuthorizationBoundary.description","title":"<code>description: str = Field(..., description=\"A summary of the system's authorization boundary.\", title='Authorization Boundary Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AuthorizationBoundary.diagrams","title":"<code>diagrams: Optional[List[Diagram]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AuthorizationBoundary.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AuthorizationBoundary.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AuthorizationBoundary.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AuthorizationBoundary-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.AuthorizationBoundary.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Base","title":"<code>Base</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Base(OscalBaseModel):\n    __root__: constr(regex=r'^\\S(.*\\S)?$') = Field(\n        ...,\n        description='The prescribed base (Confidentiality, Integrity, or Availability) security impact level.',\n        title='Base Level (Confidentiality, Integrity, or Availability)'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Base-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Base.__root__","title":"<code>__root__: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description='The prescribed base (Confidentiality, Integrity, or Availability) security impact level.', title='Base Level (Confidentiality, Integrity, or Availability)')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent","title":"<code>ByComponent</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Defines how the referenced component implements a set of controls.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class ByComponent(OscalBaseModel):\n    \"\"\"\n    Defines how the referenced component implements a set of controls.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    component_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='component-uuid',\n        description='A machine-oriented identifier reference to the component that is implemeting a given control.',\n        title='Component Universally Unique Identifier Reference'\n    )\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this by-component entry elsewhere in this or other OSCAL instances. The locally defined UUID of the by-component entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='By-Component Universally Unique Identifier',\n    )\n    description: str = Field(\n        ...,\n        description=\n        'An implementation statement that describes how a control or a control statement is implemented within the referenced system component.',\n        title='Control Implementation Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')\n    implementation_status: Optional[common.ImplementationStatus] = Field(None, alias='implementation-status')\n    export: Optional[Export] = Field(\n        None,\n        description='Identifies content intended for external consumption, such as with leveraged organizations.',\n        title='Export'\n    )\n    inherited: Optional[List[Inherited]] = Field(None)\n    satisfied: Optional[List[Satisfied]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.component_uuid","title":"<code>component_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='component-uuid', description='A machine-oriented identifier reference to the component that is implemeting a given control.', title='Component Universally Unique Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.description","title":"<code>description: str = Field(..., description='An implementation statement that describes how a control or a control statement is implemented within the referenced system component.', title='Control Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.export","title":"<code>export: Optional[Export] = Field(None, description='Identifies content intended for external consumption, such as with leveraged organizations.', title='Export')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.implementation_status","title":"<code>implementation_status: Optional[common.ImplementationStatus] = Field(None, alias='implementation-status')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.inherited","title":"<code>inherited: Optional[List[Inherited]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.satisfied","title":"<code>satisfied: Optional[List[Satisfied]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.set_parameters","title":"<code>set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this by-component entry elsewhere in this or other OSCAL instances. The locally defined UUID of the by-component entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='By-Component Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ByComponent.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Categorization","title":"<code>Categorization</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A set of information type identifiers qualified by the given identification system used, such as NIST SP 800-60.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Categorization(OscalBaseModel):\n    \"\"\"\n    A set of information type identifiers qualified by the given identification system used, such as NIST SP 800-60.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    system: Union[AnyUrl, System] = Field(\n        ...,\n        description='Specifies the information type identification system used.',\n        title='Information Type Identification System'\n    )\n    information_type_ids: Optional[List[constr(regex=r'^\\S(.*\\S)?$')]] = Field(None, alias='information-type-ids')\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Categorization-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Categorization.information_type_ids","title":"<code>information_type_ids: Optional[List[constr(regex='^\\\\S(.*\\\\S)?$')]] = Field(None, alias='information-type-ids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Categorization.system","title":"<code>system: Union[AnyUrl, System] = Field(..., description='Specifies the information type identification system used.', title='Information Type Identification System')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Categorization-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Categorization.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ControlImplementation","title":"<code>ControlImplementation</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes how the system satisfies a set of controls.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class ControlImplementation(OscalBaseModel):\n    \"\"\"\n    Describes how the system satisfies a set of controls.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    description: str = Field(\n        ...,\n        description=\n        'A statement describing important things to know about how this set of control satisfaction documentation is approached.',\n        title='Control Implementation Description'\n    )\n    set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')\n    implemented_requirements: List[ImplementedRequirement] = Field(..., alias='implemented-requirements')\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ControlImplementation-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ControlImplementation.description","title":"<code>description: str = Field(..., description='A statement describing important things to know about how this set of control satisfaction documentation is approached.', title='Control Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ControlImplementation.implemented_requirements","title":"<code>implemented_requirements: List[ImplementedRequirement] = Field(..., alias='implemented-requirements')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ControlImplementation.set_parameters","title":"<code>set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ControlImplementation-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ControlImplementation.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DataFlow","title":"<code>DataFlow</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A description of the logical flow of information within the system and across its boundaries, optionally supplemented by diagrams that illustrate these flows.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class DataFlow(OscalBaseModel):\n    \"\"\"\n    A description of the logical flow of information within the system and across its boundaries, optionally supplemented by diagrams that illustrate these flows.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    description: str = Field(..., description=\"A summary of the system's data flow.\", title='Data Flow Description')\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    diagrams: Optional[List[Diagram]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DataFlow-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DataFlow.description","title":"<code>description: str = Field(..., description=\"A summary of the system's data flow.\", title='Data Flow Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DataFlow.diagrams","title":"<code>diagrams: Optional[List[Diagram]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DataFlow.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DataFlow.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DataFlow.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DataFlow-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DataFlow.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DateAuthorized","title":"<code>DateAuthorized</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class DateAuthorized(OscalBaseModel):\n    __root__: DateDatatype = Field(\n        ..., description='The date the system received its authorization.', title='System Authorization Date'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DateAuthorized-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DateAuthorized.__root__","title":"<code>__root__: DateDatatype = Field(..., description='The date the system received its authorization.', title='System Authorization Date')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DateDatatype","title":"<code>DateDatatype</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class DateDatatype(OscalBaseModel):\n    __root__: constr(\n        regex=\n        r'^(((2000|2400|2800|(19|2[0-9](0[48]|[2468][048]|[13579][26])))-02-29)|(((19|2[0-9])[0-9]{2})-02-(0[1-9]|1[0-9]|2[0-8]))|(((19|2[0-9])[0-9]{2})-(0[13578]|10|12)-(0[1-9]|[12][0-9]|3[01]))|(((19|2[0-9])[0-9]{2})-(0[469]|11)-(0[1-9]|[12][0-9]|30)))(Z|(-((0[0-9]|1[0-2]):00|0[39]:30)|\\+((0[0-9]|1[0-4]):00|(0[34569]|10):30|(0[58]|12):45)))?$'\n    ) = Field(..., description='A string representing a 24-hour period with an optional timezone.')\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DateDatatype-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.DateDatatype.__root__","title":"<code>__root__: constr(regex='^(((2000|2400|2800|(19|2[0-9](0[48]|[2468][048]|[13579][26])))-02-29)|(((19|2[0-9])[0-9]{2})-02-(0[1-9]|1[0-9]|2[0-8]))|(((19|2[0-9])[0-9]{2})-(0[13578]|10|12)-(0[1-9]|[12][0-9]|3[01]))|(((19|2[0-9])[0-9]{2})-(0[469]|11)-(0[1-9]|[12][0-9]|30)))(Z|(-((0[0-9]|1[0-2]):00|0[39]:30)|\\\\+((0[0-9]|1[0-4]):00|(0[34569]|10):30|(0[58]|12):45)))?$') = Field(..., description='A string representing a 24-hour period with an optional timezone.')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram","title":"<code>Diagram</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A graphic that provides a visual representation the system, or some aspect of it.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Diagram(OscalBaseModel):\n    \"\"\"\n    A graphic that provides a visual representation the system, or some aspect of it.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this diagram elsewhere in this or other OSCAL instances. The locally defined UUID of the diagram can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Diagram ID'\n    )\n    description: Optional[str] = Field(None, description='A summary of the diagram.', title='Diagram Description')\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    caption: Optional[str] = Field(None, description='A brief caption to annotate the diagram.', title='Caption')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram.caption","title":"<code>caption: Optional[str] = Field(None, description='A brief caption to annotate the diagram.', title='Caption')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram.description","title":"<code>description: Optional[str] = Field(None, description='A summary of the diagram.', title='Diagram Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this diagram elsewhere in this or other OSCAL instances. The locally defined UUID of the diagram can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Diagram ID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Diagram.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export","title":"<code>Export</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies content intended for external consumption, such as with leveraged organizations.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Export(OscalBaseModel):\n    \"\"\"\n    Identifies content intended for external consumption, such as with leveraged organizations.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    description: Optional[str] = Field(\n        None,\n        description=\n        'An implementation statement that describes the aspects of the control or control statement implementation that can be available to another system leveraging this system.',\n        title='Control Implementation Export Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    provided: Optional[List[Provided]] = Field(None)\n    responsibilities: Optional[List[Responsibility]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export.description","title":"<code>description: Optional[str] = Field(None, description='An implementation statement that describes the aspects of the control or control statement implementation that can be available to another system leveraging this system.', title='Control Implementation Export Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export.provided","title":"<code>provided: Optional[List[Provided]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export.responsibilities","title":"<code>responsibilities: Optional[List[Responsibility]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Export.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Impact","title":"<code>Impact</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The expected level of impact resulting from the described information.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Impact(OscalBaseModel):\n    \"\"\"\n    The expected level of impact resulting from the described information.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    base: Base\n    selected: Optional[Selected] = None\n    adjustment_justification: Optional[AdjustmentJustification] = Field(None, alias='adjustment-justification')\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Impact-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Impact.adjustment_justification","title":"<code>adjustment_justification: Optional[AdjustmentJustification] = Field(None, alias='adjustment-justification')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Impact.base","title":"<code>base: Base</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Impact.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Impact.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Impact.selected","title":"<code>selected: Optional[Selected] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Impact-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Impact.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement","title":"<code>ImplementedRequirement</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes how the system satisfies the requirements of an individual control.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class ImplementedRequirement(OscalBaseModel):\n    \"\"\"\n    Describes how the system satisfies the requirements of an individual control.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control requirement elsewhere in this or other OSCAL instances. The locally defined UUID of the control requirement can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Control Requirement Universally Unique Identifier',\n    )\n    control_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='control-id',\n        description=\n        'A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).',\n        title='Control Identifier Reference'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    statements: Optional[List[Statement]] = Field(None)\n    by_components: Optional[List[ByComponent]] = Field(None, alias='by-components')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.by_components","title":"<code>by_components: Optional[List[ByComponent]] = Field(None, alias='by-components')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.control_id","title":"<code>control_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='control-id', description='A reference to a control with a corresponding id value. When referencing an externally defined control, the Control Identifier Reference must be used in the context of the external / imported OSCAL instance (e.g., uri-reference).', title='Control Identifier Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.set_parameters","title":"<code>set_parameters: Optional[List[SetParameter]] = Field(None, alias='set-parameters')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.statements","title":"<code>statements: Optional[List[Statement]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control requirement elsewhere in this or other OSCAL instances. The locally defined UUID of the control requirement can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Control Requirement Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImplementedRequirement.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImportProfile","title":"<code>ImportProfile</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Used to import the OSCAL profile representing the system's control baseline.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class ImportProfile(OscalBaseModel):\n    \"\"\"\n    Used to import the OSCAL profile representing the system's control baseline.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    href: str = Field(\n        ...,\n        description=\"A resolvable URL reference to the profile or catalog to use as the system's control baseline.\",\n        title='Profile Reference'\n    )\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImportProfile-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImportProfile.href","title":"<code>href: str = Field(..., description=\"A resolvable URL reference to the profile or catalog to use as the system's control baseline.\", title='Profile Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImportProfile.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImportProfile-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.ImportProfile.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType","title":"<code>InformationType</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Contains details about one information type that is stored, processed, or transmitted by the system, such as privacy information, and those defined in NIST SP 800-60.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class InformationType(OscalBaseModel):\n    \"\"\"\n    Contains details about one information type that is stored, processed, or transmitted by the system, such as privacy information, and those defined in NIST SP 800-60.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this information type elsewhere in this or other OSCAL instances. The locally defined UUID of the information type can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Information Type Universally Unique Identifier',\n    )\n    title: str = Field(\n        ...,\n        description=\n        'A human readable name for the information type. This title should be meaningful within the context of the system.',\n        title='title field'\n    )\n    description: str = Field(\n        ...,\n        description='A summary of how this information type is used within the system.',\n        title='Information Type Description'\n    )\n    categorizations: Optional[List[Categorization]] = Field(None)\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    confidentiality_impact: Optional[Impact] = Field(None, alias='confidentiality-impact')\n    integrity_impact: Optional[Impact] = Field(None, alias='integrity-impact')\n    availability_impact: Optional[Impact] = Field(None, alias='availability-impact')\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.availability_impact","title":"<code>availability_impact: Optional[Impact] = Field(None, alias='availability-impact')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.categorizations","title":"<code>categorizations: Optional[List[Categorization]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.confidentiality_impact","title":"<code>confidentiality_impact: Optional[Impact] = Field(None, alias='confidentiality-impact')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.description","title":"<code>description: str = Field(..., description='A summary of how this information type is used within the system.', title='Information Type Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.integrity_impact","title":"<code>integrity_impact: Optional[Impact] = Field(None, alias='integrity-impact')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.title","title":"<code>title: str = Field(..., description='A human readable name for the information type. This title should be meaningful within the context of the system.', title='title field')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.uuid","title":"<code>uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this information type elsewhere in this or other OSCAL instances. The locally defined UUID of the information type can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Information Type Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.InformationType.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited","title":"<code>Inherited</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes a control implementation inherited by a leveraging system.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Inherited(OscalBaseModel):\n    \"\"\"\n    Describes a control implementation inherited by a leveraging system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this inherited entry elsewhere in this or other OSCAL instances. The locally defined UUID of the inherited control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Inherited Universally Unique Identifier',\n    )\n    provided_uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None,\n        alias='provided-uuid',\n        description=\n        'A machine-oriented identifier reference to an inherited control implementation that a leveraging system is inheriting from a leveraged system.',\n        title='Provided UUID'\n    )\n    description: str = Field(\n        ...,\n        description=\n        'An implementation statement that describes the aspects of a control or control statement implementation that a leveraging system is inheriting from a leveraged system.',\n        title='Inherited Control Implementation Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited.description","title":"<code>description: str = Field(..., description='An implementation statement that describes the aspects of a control or control statement implementation that a leveraging system is inheriting from a leveraged system.', title='Inherited Control Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited.provided_uuid","title":"<code>provided_uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, alias='provided-uuid', description='A machine-oriented identifier reference to an inherited control implementation that a leveraging system is inheriting from a leveraged system.', title='Provided UUID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this inherited entry elsewhere in this or other OSCAL instances. The locally defined UUID of the inherited control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Inherited Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Inherited.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization","title":"<code>LeveragedAuthorization</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A description of another authorized system from which this system inherits capabilities that satisfy security requirements. Another term for this concept is a common control provider.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class LeveragedAuthorization(OscalBaseModel):\n    \"\"\"\n    A description of another authorized system from which this system inherits capabilities that satisfy security requirements. Another term for this concept is a common control provider.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope and can be used to reference this leveraged authorization elsewhere in this or other OSCAL instances. The locally defined UUID of the leveraged authorization can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Leveraged Authorization Universally Unique Identifier',\n    )\n    title: str = Field(\n        ...,\n        description='A human readable name for the leveraged authorization in the context of the system.',\n        title='title field'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    party_uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        alias='party-uuid',\n        description='A machine-oriented identifier reference to the party that manages the leveraged system.',\n        title='party-uuid field'\n    )\n    date_authorized: DateAuthorized = Field(..., alias='date-authorized')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization.date_authorized","title":"<code>date_authorized: DateAuthorized = Field(..., alias='date-authorized')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization.party_uuid","title":"<code>party_uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., alias='party-uuid', description='A machine-oriented identifier reference to the party that manages the leveraged system.', title='party-uuid field')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization.title","title":"<code>title: str = Field(..., description='A human readable name for the leveraged authorization in the context of the system.', title='title field')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope and can be used to reference this leveraged authorization elsewhere in this or other OSCAL instances. The locally defined UUID of the leveraged authorization can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Leveraged Authorization Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.LeveragedAuthorization.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Model","title":"<code>Model</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Model(OscalBaseModel):\n    system_security_plan: SystemSecurityPlan = Field(..., alias='system-security-plan')\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Model-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Model.system_security_plan","title":"<code>system_security_plan: SystemSecurityPlan = Field(..., alias='system-security-plan')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.NetworkArchitecture","title":"<code>NetworkArchitecture</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A description of the system's network architecture, optionally supplemented by diagrams that illustrate the network architecture.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class NetworkArchitecture(OscalBaseModel):\n    \"\"\"\n    A description of the system's network architecture, optionally supplemented by diagrams that illustrate the network architecture.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    description: str = Field(\n        ..., description=\"A summary of the system's network architecture.\", title='Network Architecture Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    diagrams: Optional[List[Diagram]] = Field(None)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.NetworkArchitecture-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.NetworkArchitecture.description","title":"<code>description: str = Field(..., description=\"A summary of the system's network architecture.\", title='Network Architecture Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.NetworkArchitecture.diagrams","title":"<code>diagrams: Optional[List[Diagram]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.NetworkArchitecture.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.NetworkArchitecture.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.NetworkArchitecture.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.NetworkArchitecture-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.NetworkArchitecture.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.OperationalStateValidValues","title":"<code>OperationalStateValidValues</code>","text":"<p>               Bases: <code>Enum</code></p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class OperationalStateValidValues(Enum):\n    operational = 'operational'\n    under_development = 'under-development'\n    under_major_modification = 'under-major-modification'\n    disposition = 'disposition'\n    other = 'other'\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.OperationalStateValidValues-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.OperationalStateValidValues.disposition","title":"<code>disposition = 'disposition'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.OperationalStateValidValues.operational","title":"<code>operational = 'operational'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.OperationalStateValidValues.other","title":"<code>other = 'other'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.OperationalStateValidValues.under_development","title":"<code>under_development = 'under-development'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.OperationalStateValidValues.under_major_modification","title":"<code>under_major_modification = 'under-major-modification'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided","title":"<code>Provided</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes a capability which may be inherited by a leveraging system.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Provided(OscalBaseModel):\n    \"\"\"\n    Describes a capability which may be inherited by a leveraging system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this provided entry elsewhere in this or other OSCAL instances. The locally defined UUID of the provided entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Provided Universally Unique Identifier',\n    )\n    description: str = Field(\n        ...,\n        description=\n        'An implementation statement that describes the aspects of the control or control statement implementation that can be provided to another system leveraging this system.',\n        title='Provided Control Implementation Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided.description","title":"<code>description: str = Field(..., description='An implementation statement that describes the aspects of the control or control statement implementation that can be provided to another system leveraging this system.', title='Provided Control Implementation Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this provided entry elsewhere in this or other OSCAL instances. The locally defined UUID of the provided entry can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Provided Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Provided.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility","title":"<code>Responsibility</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes a control implementation responsibility imposed on a leveraging system.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Responsibility(OscalBaseModel):\n    \"\"\"\n    Describes a control implementation responsibility imposed on a leveraging system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this responsibility elsewhere in this or other OSCAL instances. The locally defined UUID of the responsibility can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Responsibility Universally Unique Identifier',\n    )\n    provided_uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None,\n        alias='provided-uuid',\n        description=\n        'A machine-oriented identifier reference to an inherited control implementation that a leveraging system is inheriting from a leveraged system.',\n        title='Provided UUID'\n    )\n    description: str = Field(\n        ...,\n        description=\n        'An implementation statement that describes the aspects of the control or control statement implementation that a leveraging system must implement to satisfy the control provided by a leveraged system.',\n        title='Control Implementation Responsibility Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility.description","title":"<code>description: str = Field(..., description='An implementation statement that describes the aspects of the control or control statement implementation that a leveraging system must implement to satisfy the control provided by a leveraged system.', title='Control Implementation Responsibility Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility.provided_uuid","title":"<code>provided_uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, alias='provided-uuid', description='A machine-oriented identifier reference to an inherited control implementation that a leveraging system is inheriting from a leveraged system.', title='Provided UUID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this responsibility elsewhere in this or other OSCAL instances. The locally defined UUID of the responsibility can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Responsibility Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Responsibility.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied","title":"<code>Satisfied</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes how this system satisfies a responsibility imposed by a leveraged system.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Satisfied(OscalBaseModel):\n    \"\"\"\n    Describes how this system satisfies a responsibility imposed by a leveraged system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this satisfied control implementation entry elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='Satisfied Universally Unique Identifier',\n    )\n    responsibility_uuid: Optional[constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    )] = Field(\n        None,\n        alias='responsibility-uuid',\n        description=\n        'A machine-oriented identifier reference to a control implementation that satisfies a responsibility imposed by a leveraged system.',\n        title='Responsibility UUID'\n    )\n    description: str = Field(\n        ...,\n        description=\n        'An implementation statement that describes the aspects of a control or control statement implementation that a leveraging system is implementing based on a requirement from a leveraged system.',\n        title='Satisfied Control Implementation Responsibility Description'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied.description","title":"<code>description: str = Field(..., description='An implementation statement that describes the aspects of a control or control statement implementation that a leveraging system is implementing based on a requirement from a leveraged system.', title='Satisfied Control Implementation Responsibility Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied.responsibility_uuid","title":"<code>responsibility_uuid: Optional[constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$')] = Field(None, alias='responsibility-uuid', description='A machine-oriented identifier reference to a control implementation that satisfies a responsibility imposed by a leveraged system.', title='Responsibility UUID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this satisfied control implementation entry elsewhere in this or other OSCAL instances. The locally defined UUID of the control implementation can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance). This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='Satisfied Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Satisfied.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SecurityImpactLevel","title":"<code>SecurityImpactLevel</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>The overall level of expected impact resulting from unauthorized disclosure, modification, or loss of access to information.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class SecurityImpactLevel(OscalBaseModel):\n    \"\"\"\n    The overall level of expected impact resulting from unauthorized disclosure, modification, or loss of access to information.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    security_objective_confidentiality: constr(regex=r'^\\S(.*\\S)?$') = Field(\n        ...,\n        alias='security-objective-confidentiality',\n        description=\n        'A target-level of confidentiality for the system, based on the sensitivity of information within the system.',\n        title='Security Objective: Confidentiality'\n    )\n    security_objective_integrity: constr(regex=r'^\\S(.*\\S)?$') = Field(\n        ...,\n        alias='security-objective-integrity',\n        description=\n        'A target-level of integrity for the system, based on the sensitivity of information within the system.',\n        title='Security Objective: Integrity'\n    )\n    security_objective_availability: constr(regex=r'^\\S(.*\\S)?$') = Field(\n        ...,\n        alias='security-objective-availability',\n        description=\n        'A target-level of availability for the system, based on the sensitivity of information within the system.',\n        title='Security Objective: Availability'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SecurityImpactLevel-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SecurityImpactLevel.security_objective_availability","title":"<code>security_objective_availability: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., alias='security-objective-availability', description='A target-level of availability for the system, based on the sensitivity of information within the system.', title='Security Objective: Availability')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SecurityImpactLevel.security_objective_confidentiality","title":"<code>security_objective_confidentiality: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., alias='security-objective-confidentiality', description='A target-level of confidentiality for the system, based on the sensitivity of information within the system.', title='Security Objective: Confidentiality')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SecurityImpactLevel.security_objective_integrity","title":"<code>security_objective_integrity: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., alias='security-objective-integrity', description='A target-level of integrity for the system, based on the sensitivity of information within the system.', title='Security Objective: Integrity')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SecurityImpactLevel-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SecurityImpactLevel.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Selected","title":"<code>Selected</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Selected(OscalBaseModel):\n    __root__: constr(regex=r'^\\S(.*\\S)?$') = Field(\n        ...,\n        description='The selected (Confidentiality, Integrity, or Availability) security impact level.',\n        title='Selected Level (Confidentiality, Integrity, or Availability)'\n    )\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Selected-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Selected.__root__","title":"<code>__root__: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., description='The selected (Confidentiality, Integrity, or Availability) security impact level.', title='Selected Level (Confidentiality, Integrity, or Availability)')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SetParameter","title":"<code>SetParameter</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies the parameter that will be set by the enclosed value.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class SetParameter(OscalBaseModel):\n    \"\"\"\n    Identifies the parameter that will be set by the enclosed value.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    param_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='param-id',\n        description=\n        \"A human-oriented reference to a parameter within a control, who's catalog has been imported into the current implementation context.\",\n        title='Parameter ID'\n    )\n    values: List[constr(regex=r'^\\S(.*\\S)?$')] = Field(...)\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SetParameter-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SetParameter.param_id","title":"<code>param_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='param-id', description=\"A human-oriented reference to a parameter within a control, who's catalog has been imported into the current implementation context.\", title='Parameter ID')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SetParameter.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SetParameter.values","title":"<code>values: List[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SetParameter-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SetParameter.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement","title":"<code>Statement</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Identifies which statements within a control are addressed.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Statement(OscalBaseModel):\n    \"\"\"\n    Identifies which statements within a control are addressed.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    statement_id: constr(\n        regex=\n        r'^[_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD][_A-Za-z\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02FF\\u0370-\\u037D\\u037F-\\u1FFF\\u200C-\\u200D\\u2070-\\u218F\\u2C00-\\u2FEF\\u3001-\\uD7FF\\uF900-\\uFDCF\\uFDF0-\\uFFFD\\-\\.0-9\\u00B7\\u0300-\\u036F\\u203F-\\u2040]*$'\n    ) = Field(\n        ...,\n        alias='statement-id',\n        description='A human-oriented identifier reference to a control statement.',\n        title='Control Statement Reference'\n    )\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).',\n        title='Control Statement Reference Universally Unique Identifier'\n    )\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')\n    by_components: Optional[List[ByComponent]] = Field(None, alias='by-components')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement.by_components","title":"<code>by_components: Optional[List[ByComponent]] = Field(None, alias='by-components')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement.responsible_roles","title":"<code>responsible_roles: Optional[List[common.ResponsibleRole]] = Field(None, alias='responsible-roles')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement.statement_id","title":"<code>statement_id: constr(regex='^[_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD][_A-Za-z\\\\u00C0-\\\\u00D6\\\\u00D8-\\\\u00F6\\\\u00F8-\\\\u02FF\\\\u0370-\\\\u037D\\\\u037F-\\\\u1FFF\\\\u200C-\\\\u200D\\\\u2070-\\\\u218F\\\\u2C00-\\\\u2FEF\\\\u3001-\\\\uD7FF\\\\uF900-\\\\uFDCF\\\\uFDF0-\\\\uFFFD\\\\-\\\\.0-9\\\\u00B7\\\\u0300-\\\\u036F\\\\u203F-\\\\u2040]*$') = Field(..., alias='statement-id', description='A human-oriented identifier reference to a control statement.', title='Control Statement Reference')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this control statement elsewhere in this or other OSCAL instances. The UUID of the control statement in the source OSCAL instance is sufficient to reference the data item locally or globally (e.g., in an imported OSCAL instance).', title='Control Statement Reference Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Statement.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Status1","title":"<code>Status1</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Describes the operational status of the system.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Status1(OscalBaseModel):\n    \"\"\"\n    Describes the operational status of the system.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    state: OperationalStateValidValues = Field(..., description='The current operating status.', title='State')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Status1-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Status1.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Status1.state","title":"<code>state: OperationalStateValidValues = Field(..., description='The current operating status.', title='State')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Status1-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.Status1.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.System","title":"<code>System</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Specifies the information type identification system used.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class System(Enum):\n    \"\"\"\n    Specifies the information type identification system used.\n    \"\"\"\n\n    http___doi_org_10_6028_NIST_SP_800_60v2r1 = 'http://doi.org/10.6028/NIST.SP.800-60v2r1'\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.System-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.System.http___doi_org_10_6028_NIST_SP_800_60v2r1","title":"<code>http___doi_org_10_6028_NIST_SP_800_60v2r1 = 'http://doi.org/10.6028/NIST.SP.800-60v2r1'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics","title":"<code>SystemCharacteristics</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Contains the characteristics of the system, such as its name, purpose, and security impact level.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class SystemCharacteristics(OscalBaseModel):\n    \"\"\"\n    Contains the characteristics of the system, such as its name, purpose, and security impact level.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    system_ids: List[common.SystemId] = Field(..., alias='system-ids')\n    system_name: constr(\n        regex=r'^\\S(.*\\S)?$'\n    ) = Field(..., alias='system-name', description='The full name of the system.', title='System Name - Full')\n    system_name_short: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        alias='system-name-short',\n        description=\n        'A short name for the system, such as an acronym, that is suitable for display in a data table or summary list.',\n        title='System Name - Short'\n    )\n    description: str = Field(..., description='A summary of the system.', title='System Description')\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    date_authorized: Optional[DateAuthorized] = Field(None, alias='date-authorized')\n    security_sensitivity_level: Optional[constr(regex=r'^\\S(.*\\S)?$')] = Field(\n        None,\n        alias='security-sensitivity-level',\n        description='The overall information system sensitivity categorization, such as defined by FIPS-199.',\n        title='Security Sensitivity Level'\n    )\n    system_information: SystemInformation = Field(..., alias='system-information')\n    security_impact_level: Optional[SecurityImpactLevel] = Field(None, alias='security-impact-level')\n    status: Status1\n    authorization_boundary: AuthorizationBoundary = Field(..., alias='authorization-boundary')\n    network_architecture: Optional[NetworkArchitecture] = Field(None, alias='network-architecture')\n    data_flow: Optional[DataFlow] = Field(None, alias='data-flow')\n    responsible_parties: Optional[List[common.ResponsibleParty]] = Field(None, alias='responsible-parties')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.authorization_boundary","title":"<code>authorization_boundary: AuthorizationBoundary = Field(..., alias='authorization-boundary')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.data_flow","title":"<code>data_flow: Optional[DataFlow] = Field(None, alias='data-flow')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.date_authorized","title":"<code>date_authorized: Optional[DateAuthorized] = Field(None, alias='date-authorized')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.description","title":"<code>description: str = Field(..., description='A summary of the system.', title='System Description')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.network_architecture","title":"<code>network_architecture: Optional[NetworkArchitecture] = Field(None, alias='network-architecture')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.responsible_parties","title":"<code>responsible_parties: Optional[List[common.ResponsibleParty]] = Field(None, alias='responsible-parties')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.security_impact_level","title":"<code>security_impact_level: Optional[SecurityImpactLevel] = Field(None, alias='security-impact-level')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.security_sensitivity_level","title":"<code>security_sensitivity_level: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='security-sensitivity-level', description='The overall information system sensitivity categorization, such as defined by FIPS-199.', title='Security Sensitivity Level')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.status","title":"<code>status: Status1</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.system_ids","title":"<code>system_ids: List[common.SystemId] = Field(..., alias='system-ids')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.system_information","title":"<code>system_information: SystemInformation = Field(..., alias='system-information')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.system_name","title":"<code>system_name: constr(regex='^\\\\S(.*\\\\S)?$') = Field(..., alias='system-name', description='The full name of the system.', title='System Name - Full')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.system_name_short","title":"<code>system_name_short: Optional[constr(regex='^\\\\S(.*\\\\S)?$')] = Field(None, alias='system-name-short', description='A short name for the system, such as an acronym, that is suitable for display in a data table or summary list.', title='System Name - Short')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemCharacteristics.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation","title":"<code>SystemImplementation</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Provides information as to how the system is implemented.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class SystemImplementation(OscalBaseModel):\n    \"\"\"\n    Provides information as to how the system is implemented.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    leveraged_authorizations: Optional[List[LeveragedAuthorization]] = Field(None, alias='leveraged-authorizations')\n    users: List[common.SystemUser] = Field(...)\n    components: List[common.SystemComponent] = Field(...)\n    inventory_items: Optional[List[common.InventoryItem]] = Field(None, alias='inventory-items')\n    remarks: Optional[str] = None\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation.components","title":"<code>components: List[common.SystemComponent] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation.inventory_items","title":"<code>inventory_items: Optional[List[common.InventoryItem]] = Field(None, alias='inventory-items')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation.leveraged_authorizations","title":"<code>leveraged_authorizations: Optional[List[LeveragedAuthorization]] = Field(None, alias='leveraged-authorizations')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation.remarks","title":"<code>remarks: Optional[str] = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation.users","title":"<code>users: List[common.SystemUser] = Field(...)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemImplementation.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemInformation","title":"<code>SystemInformation</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Contains details about all information types that are stored, processed, or transmitted by the system, such as privacy information, and those defined in NIST SP 800-60.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class SystemInformation(OscalBaseModel):\n    \"\"\"\n    Contains details about all information types that are stored, processed, or transmitted by the system, such as privacy information, and those defined in NIST SP 800-60.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    props: Optional[List[common.Property]] = Field(None)\n    links: Optional[List[common.Link]] = Field(None)\n    information_types: List[InformationType] = Field(..., alias='information-types')\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemInformation-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemInformation.information_types","title":"<code>information_types: List[InformationType] = Field(..., alias='information-types')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemInformation.links","title":"<code>links: Optional[List[common.Link]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemInformation.props","title":"<code>props: Optional[List[common.Property]] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemInformation-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemInformation.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan","title":"<code>SystemSecurityPlan</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>A system security plan, such as those described in NIST SP 800-18.</p> Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class SystemSecurityPlan(OscalBaseModel):\n    \"\"\"\n    A system security plan, such as those described in NIST SP 800-18.\n    \"\"\"\n\n    class Config:\n        extra = Extra.forbid\n\n    uuid: constr(\n        regex=r'^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$'\n    ) = Field(\n        ...,\n        description=\n        'A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this system security plan (SSP) elsewhere in this or other OSCAL instances. The locally defined UUID of the SSP can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance).This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.',\n        title='System Security Plan Universally Unique Identifier',\n    )\n    metadata: common.Metadata\n    import_profile: ImportProfile = Field(..., alias='import-profile')\n    system_characteristics: SystemCharacteristics = Field(..., alias='system-characteristics')\n    system_implementation: SystemImplementation = Field(..., alias='system-implementation')\n    control_implementation: ControlImplementation = Field(..., alias='control-implementation')\n    back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')\n</code></pre>"},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan.back_matter","title":"<code>back_matter: Optional[common.BackMatter] = Field(None, alias='back-matter')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan.control_implementation","title":"<code>control_implementation: ControlImplementation = Field(..., alias='control-implementation')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan.import_profile","title":"<code>import_profile: ImportProfile = Field(..., alias='import-profile')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan.metadata","title":"<code>metadata: common.Metadata</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan.system_characteristics","title":"<code>system_characteristics: SystemCharacteristics = Field(..., alias='system-characteristics')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan.system_implementation","title":"<code>system_implementation: SystemImplementation = Field(..., alias='system-implementation')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan.uuid","title":"<code>uuid: constr(regex='^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[45][0-9A-Fa-f]{3}-[89ABab][0-9A-Fa-f]{3}-[0-9A-Fa-f]{12}$') = Field(..., description='A machine-oriented, globally unique identifier with cross-instance scope that can be used to reference this system security plan (SSP) elsewhere in this or other OSCAL instances. The locally defined UUID of the SSP can be used to reference the data item locally or globally (e.g., in an imported OSCAL instance).This UUID should be assigned per-subject, which means it should be consistently used to identify the same subject across revisions of the document.', title='System Security Plan Universally Unique Identifier')</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan-classes","title":"Classes","text":""},{"location":"reference/API/trestle/oscal/ssp/#trestle.oscal.ssp.SystemSecurityPlan.Config","title":"<code>Config</code>","text":"Source code in <code>trestle/oscal/ssp.py</code> <pre><code>class Config:\n    extra = Extra.forbid\n</code></pre> Attributes\u00a4 <code>extra = Extra.forbid</code> <code>class-attribute</code> <code>instance-attribute</code> \u00a4"},{"location":"reference/API/trestle/tasks/base_task/","title":"trestle.tasks.base_task","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task","title":"<code>trestle.tasks.base_task</code>","text":"<p>Trestle tasks base templating.</p>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.PassFail","title":"<code>PassFail</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Holding pattern template for a task which does nothing and always passes.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>class PassFail(TaskBase):\n    \"\"\"\n    Holding pattern template for a task which does nothing and always passes.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'pass-fail'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task pass-fail.\n\n        Attributes:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        logger.info(f'Help information for {self.name} task.')\n        logger.info('This is a template task which reports pass fail depending on the specific configuration.')\n        logger.info(\n            'In this case if no config section is provided the task will fail. This a a task specific behavior.'\n        )\n        logger.info('Configuration flags sit under [task.pass-fail]')\n        logger.info('with two boolean flags')\n        logger.info('execute_status = True/False with a default pass')\n        logger.info('simulate_status = True/False with a default fail')\n        logger.info('Note that if the config file does not have the appropriate section this should fail.')\n        logger.info('The princple goal is a simple development example.')\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        if self._config:\n            outcome = self._config.getboolean('simulate_status', fallback=True)\n            if outcome:\n                return TaskOutcome('simulated-success')\n        return TaskOutcome('simulated-failure')\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide a actual outcome.\"\"\"\n        if self._config:\n            outcome = self._config.getboolean('execute_status', fallback=True)\n            if outcome:\n                return TaskOutcome('success')\n        return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.PassFail-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.PassFail.name","title":"<code>name = 'pass-fail'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.PassFail-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.PassFail.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task pass-fail.</p> <p>Attributes:</p> Name Type Description <code>config_object</code> <p>Config section associated with the task.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task pass-fail.\n\n    Attributes:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.PassFail.execute","title":"<code>execute()</code>","text":"<p>Provide a actual outcome.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide a actual outcome.\"\"\"\n    if self._config:\n        outcome = self._config.getboolean('execute_status', fallback=True)\n        if outcome:\n            return TaskOutcome('success')\n    return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.PassFail.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    logger.info(f'Help information for {self.name} task.')\n    logger.info('This is a template task which reports pass fail depending on the specific configuration.')\n    logger.info(\n        'In this case if no config section is provided the task will fail. This a a task specific behavior.'\n    )\n    logger.info('Configuration flags sit under [task.pass-fail]')\n    logger.info('with two boolean flags')\n    logger.info('execute_status = True/False with a default pass')\n    logger.info('simulate_status = True/False with a default fail')\n    logger.info('Note that if the config file does not have the appropriate section this should fail.')\n    logger.info('The princple goal is a simple development example.')\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.PassFail.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    if self._config:\n        outcome = self._config.getboolean('simulate_status', fallback=True)\n        if outcome:\n            return TaskOutcome('simulated-success')\n    return TaskOutcome('simulated-failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskBase","title":"<code>TaskBase</code>","text":"<p>               Bases: <code>ABC</code></p> <p>Abstract base class for tasks.</p> <p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>class TaskBase(ABC):\n    \"\"\"\n    Abstract base class for tasks.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name: str = 'base'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"Initialize task base and store config.\"\"\"\n        self._config = config_object\n\n    @abstractmethod\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n\n    @abstractmethod\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Execute the task including potential rollback.\"\"\"\n\n    @abstractmethod\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Simulate the task and report task outcome.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskBase-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskBase.name","title":"<code>name: str = 'base'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskBase-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskBase.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize task base and store config.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"Initialize task base and store config.\"\"\"\n    self._config = config_object\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskBase.execute","title":"<code>execute()</code>  <code>abstractmethod</code>","text":"<p>Execute the task including potential rollback.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>@abstractmethod\ndef execute(self) -&gt; TaskOutcome:\n    \"\"\"Execute the task including potential rollback.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskBase.print_info","title":"<code>print_info()</code>  <code>abstractmethod</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>@abstractmethod\ndef print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskBase.simulate","title":"<code>simulate()</code>  <code>abstractmethod</code>","text":"<p>Simulate the task and report task outcome.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>@abstractmethod\ndef simulate(self) -&gt; TaskOutcome:\n    \"\"\"Simulate the task and report task outcome.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskOutcome","title":"<code>TaskOutcome</code>","text":"<p>               Bases: <code>Enum</code></p> <p>Enum describing possible task outcomes.</p> Source code in <code>trestle/tasks/base_task.py</code> <pre><code>class TaskOutcome(Enum):\n    \"\"\"Enum describing possible task outcomes.\"\"\"\n\n    SUCCESS = 'success'\n    FAILURE = 'failure'\n    ROLLEDBACK = 'rolledback'\n    SIM_SUCCESS = 'simulated-success'\n    SIM_FAILURE = 'simulated-failure'\n    NOT_IMPLEMENTED = 'not-implemented'\n</code></pre>"},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskOutcome-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskOutcome.FAILURE","title":"<code>FAILURE = 'failure'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskOutcome.NOT_IMPLEMENTED","title":"<code>NOT_IMPLEMENTED = 'not-implemented'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskOutcome.ROLLEDBACK","title":"<code>ROLLEDBACK = 'rolledback'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskOutcome.SIM_FAILURE","title":"<code>SIM_FAILURE = 'simulated-failure'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskOutcome.SIM_SUCCESS","title":"<code>SIM_SUCCESS = 'simulated-success'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/base_task/#trestle.tasks.base_task.TaskOutcome.SUCCESS","title":"<code>SUCCESS = 'success'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/","title":"trestle.tasks.cis_xlsx_to_oscal_catalog","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog","title":"<code>trestle.tasks.cis_xlsx_to_oscal_catalog</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.timestamp","title":"<code>timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper","title":"<code>CatalogHelper</code>","text":"<p>OSCAL Catalog Helper.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>class CatalogHelper:\n    \"\"\"OSCAL Catalog Helper.\"\"\"\n\n    def __init__(self, title: str, version: str) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        # metadata\n        self._metadata = Metadata(title=title, last_modified=timestamp, oscal_version=OSCAL_VERSION, version=version)\n        self._root_group = OrderedDict()\n        self._root_resources = OrderedDict()\n        self._all_groups = OrderedDict()\n        self._all_controls = OrderedDict()\n\n    def add_group(self, section: str, title: str, props: List[Property], parts: List[Part]) -&gt; None:\n        \"\"\"Add group.\"\"\"\n        numdots = section.count('.')\n        if numdots == 0:\n            group = Group(title=f'{title}', id=f'CIS-{section}')\n            if props:\n                group.props = props\n            if parts:\n                group.parts = parts\n            self._root_group[section] = group\n            self._all_groups[section] = group\n        else:\n            key = '.'.join(section.split('.')[:-1])\n            parent = self._all_groups[key]\n            if parent.groups is None:\n                parent.groups = []\n            group = Group(title=f'{title}', id=f'CIS-{section}')\n            if props:\n                group.props = props\n            if parts:\n                group.parts = parts\n            parent.groups.append(group)\n            self._all_groups[section] = group\n\n    def _add_prop(self, control: Control, prop: Property) -&gt; None:\n        \"\"\"Add property to control.\"\"\"\n        control_props = control.props\n        control.props = []\n        last = 0\n        for i, control_prop in enumerate(control_props):\n            if control_prop.name == prop.name:\n                last = i\n        for i, control_prop in enumerate(control_props):\n            control.props.append(control_prop)\n            if i == last:\n                control.props.append(prop)\n\n    def add_control(\n        self,\n        section: str,\n        recommendation: str,\n        title: str,\n        props: List[Property],\n        parts: List[Part],\n        links: List[Link]\n    ) -&gt; None:\n        \"\"\"Add control.\"\"\"\n        group = self._all_groups[section]\n        if group.controls is None:\n            group.controls = []\n        id_ = f'CIS-{recommendation}'\n        if id_ in self._all_controls:\n            control = self._all_controls[id_]\n            for prop in props:\n                if prop.name == 'profile':\n                    self._add_prop(control, prop)\n        else:\n            title = f'{title}'\n            control = Control(id=id_, title=title)\n            self._all_controls[id_] = control\n            if props:\n                control.props = props\n            if parts:\n                control.parts = parts\n            if links:\n                control.links = links\n            group.controls.append(control)\n\n    def add_link(\n        self,\n        recommendation: str,\n        reference: str,\n        links: List[Link],\n    ) -&gt; None:\n        \"\"\"Add link.\"\"\"\n        id_ = f'CIS-{recommendation}'\n        if id_ not in self._root_resources:\n            res_id = str(uuid.uuid4())\n            link = Link(href=f'#{res_id}', rel='reference')\n            links.append(link)\n            resource = Resource(\n                uuid=res_id,\n                description=reference,\n            )\n            self._root_resources[id_] = resource\n\n    def get_catalog(self) -&gt; Catalog:\n        \"\"\"Get catalog.\"\"\"\n        back_matter = BackMatter(resources=list(self._root_resources.values()))\n        catalog = Catalog(\n            uuid=str(uuid.uuid4()),\n            metadata=self._metadata,\n            groups=list(self._root_group.values()),\n            back_matter=back_matter\n        )\n        return catalog\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.__init__","title":"<code>__init__(title, version)</code>","text":"<p>Initialize.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def __init__(self, title: str, version: str) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    # metadata\n    self._metadata = Metadata(title=title, last_modified=timestamp, oscal_version=OSCAL_VERSION, version=version)\n    self._root_group = OrderedDict()\n    self._root_resources = OrderedDict()\n    self._all_groups = OrderedDict()\n    self._all_controls = OrderedDict()\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_control","title":"<code>add_control(section, recommendation, title, props, parts, links)</code>","text":"<p>Add control.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def add_control(\n    self,\n    section: str,\n    recommendation: str,\n    title: str,\n    props: List[Property],\n    parts: List[Part],\n    links: List[Link]\n) -&gt; None:\n    \"\"\"Add control.\"\"\"\n    group = self._all_groups[section]\n    if group.controls is None:\n        group.controls = []\n    id_ = f'CIS-{recommendation}'\n    if id_ in self._all_controls:\n        control = self._all_controls[id_]\n        for prop in props:\n            if prop.name == 'profile':\n                self._add_prop(control, prop)\n    else:\n        title = f'{title}'\n        control = Control(id=id_, title=title)\n        self._all_controls[id_] = control\n        if props:\n            control.props = props\n        if parts:\n            control.parts = parts\n        if links:\n            control.links = links\n        group.controls.append(control)\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_group","title":"<code>add_group(section, title, props, parts)</code>","text":"<p>Add group.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def add_group(self, section: str, title: str, props: List[Property], parts: List[Part]) -&gt; None:\n    \"\"\"Add group.\"\"\"\n    numdots = section.count('.')\n    if numdots == 0:\n        group = Group(title=f'{title}', id=f'CIS-{section}')\n        if props:\n            group.props = props\n        if parts:\n            group.parts = parts\n        self._root_group[section] = group\n        self._all_groups[section] = group\n    else:\n        key = '.'.join(section.split('.')[:-1])\n        parent = self._all_groups[key]\n        if parent.groups is None:\n            parent.groups = []\n        group = Group(title=f'{title}', id=f'CIS-{section}')\n        if props:\n            group.props = props\n        if parts:\n            group.parts = parts\n        parent.groups.append(group)\n        self._all_groups[section] = group\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.add_link","title":"<code>add_link(recommendation, reference, links)</code>","text":"<p>Add link.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def add_link(\n    self,\n    recommendation: str,\n    reference: str,\n    links: List[Link],\n) -&gt; None:\n    \"\"\"Add link.\"\"\"\n    id_ = f'CIS-{recommendation}'\n    if id_ not in self._root_resources:\n        res_id = str(uuid.uuid4())\n        link = Link(href=f'#{res_id}', rel='reference')\n        links.append(link)\n        resource = Resource(\n            uuid=res_id,\n            description=reference,\n        )\n        self._root_resources[id_] = resource\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CatalogHelper.get_catalog","title":"<code>get_catalog()</code>","text":"<p>Get catalog.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def get_catalog(self) -&gt; Catalog:\n    \"\"\"Get catalog.\"\"\"\n    back_matter = BackMatter(resources=list(self._root_resources.values()))\n    catalog = Catalog(\n        uuid=str(uuid.uuid4()),\n        metadata=self._metadata,\n        groups=list(self._root_group.values()),\n        back_matter=back_matter\n    )\n    return catalog\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog","title":"<code>CisXlsxToOscalCatalog</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to transform CIS .xlsx to OSCAL catalog.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>class CisXlsxToOscalCatalog(TaskBase):\n    \"\"\"\n    Task to transform CIS .xlsx to OSCAL catalog.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'cis-xlsx-to-oscal-catalog'\n    ns = 'https://oscal-compass.github.io/compliance-trestle/schemas/oscal/catalog/cis'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        logger.info(f'Help information for {self.name} task.')\n        logger.info('')\n        logger.info('Purpose: Create catalog from standard (e.g. CIS benchmark).')\n        logger.info('')\n        logger.info('Configuration flags sit under [task.cis-xlsx-to-oscal-catalog]:')\n        text1 = '  input-file             = '\n        text2 = '(required) path to read the compliance-as-code .xlsx spread sheet file.'\n        logger.info(text1 + text2)\n        text1 = '  output-dir             = '\n        text2 = '(required) location to write the generated catalog.json file.'\n        logger.info(text1 + text2)\n        text1 = '  title                  = '\n        text2 = '(required) title of the CIS catalog.'\n        logger.info(text1 + text2)\n        text1 = '  version                = '\n        text2 = '(required) version of the CIS catalog.'\n        logger.info(text1 + text2)\n        text1 = '  output-overwrite       = '\n        text2 = '(optional) true [default] or false; replace existing output when true.'\n        logger.info(text1 + text2)\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        return TaskOutcome('simulated-success')\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an actual outcome.\"\"\"\n        try:\n            return self._execute()\n        except Exception:\n            logger.info(traceback.format_exc())\n            return TaskOutcome('failure')\n\n    def _get_normalized_name(self, key: str) -&gt; str:\n        \"\"\"Get normalized name.\"\"\"\n        name = key\n        name = name.replace(' ', '_')\n        name = name.replace('&amp;', 'a')\n        name = name.replace('(', '')\n        name = name.replace(')', '')\n        return name\n\n    def _create_property(self, name: str, value: str) -&gt; Property:\n        return Property(name=name, value=value, ns=CisXlsxToOscalCatalog.ns)\n\n    def _add_property(self, xlsx_helper: XlsxHelper, props: List[Property], row: int, key: str) -&gt; None:\n        \"\"\"Add property.\"\"\"\n        try:\n            name = self._get_normalized_name(key)\n            value = xlsx_helper.get(row, key)\n            if value:\n                props.append(self._create_property(name, value))\n        except KeyError as e:\n            text = f'key {e} not found.'\n            logger.debug(text)\n\n    def _add_property_boolean(self, xlsx_helper: XlsxHelper, props: List[Property], row: int, key: str) -&gt; None:\n        \"\"\"Add property.\"\"\"\n        try:\n            name = self._get_normalized_name(key)\n            value = xlsx_helper.get(row, key)\n            if value:\n                props.append(self._create_property(name, 'True'))\n            else:\n                props.append(self._create_property(name, 'False'))\n        except KeyError as e:\n            text = f'key {e} not found.'\n            logger.debug(text)\n\n    def _add_part(self, xlsx_helper: XlsxHelper, parts: List[Part], id_: str, row: int, key: str) -&gt; None:\n        \"\"\"Add part.\"\"\"\n        value = xlsx_helper.get(row, key)\n        if value:\n            name = self._get_normalized_name(key)\n            parts.append(Part(id=id_, name=name, prose=value))\n\n    def _add_links(\n        self, xlsx_helper: XlsxHelper, catalog_helper: CatalogHelper, links: List[Link], row: int, key: str\n    ) -&gt; None:\n        \"\"\"Add links.\"\"\"\n        value = xlsx_helper.get(row, key)\n        if value:\n            recommendation = xlsx_helper.get(row, 'recommendation #')\n            catalog_helper.add_link(recommendation, value, links)\n\n    def _execute(self) -&gt; TaskOutcome:\n        \"\"\"Wrap the execute for exception handling.\"\"\"\n        if not self._config:\n            logger.warning('config missing')\n            return TaskOutcome('failure')\n        try:\n            ifile = self._config['input-file']\n            odir = self._config['output-dir']\n            title = self._config['title']\n            version = self._config['version']\n        except KeyError as e:\n            logger.info(f'key {e.args[0]} missing')\n            return TaskOutcome('failure')\n        # verbosity\n        _quiet = self._config.get('quiet', False)\n        _verbose = not _quiet\n        # output\n        overwrite = self._config.getboolean('output-overwrite', True)\n        opth = pathlib.Path(odir)\n        # insure output dir exists\n        opth.mkdir(exist_ok=True, parents=True)\n        # calculate output file name &amp; check writability\n        oname = 'catalog.json'\n        ofile = opth / oname\n        if not overwrite and pathlib.Path(ofile).exists():\n            logger.warning(f'output: {ofile} already exists')\n            return TaskOutcome('failure')\n        xlsx_helper = XlsxHelper(ifile)\n        catalog_helper = CatalogHelper(title, version)\n        if xlsx_helper.is_ocp():\n            self._process_ocp(xlsx_helper, catalog_helper)\n        else:\n            self._process_rhel(xlsx_helper, catalog_helper)\n        catalog = catalog_helper.get_catalog()\n        # write OSCAL ComponentDefinition to file\n        if _verbose:\n            logger.info(f'output: {ofile}')\n        catalog.oscal_write(pathlib.Path(ofile))\n        return TaskOutcome('success')\n\n    def _process_ocp(self, xlsx_helper: XlsxHelper, catalog_helper: CatalogHelper) -&gt; None:\n        \"\"\"Process OCP.\"\"\"\n        # transform each row into OSCAL equivalent\n        for row in xlsx_helper.row_generator():\n            section = xlsx_helper.get(row, 'section #')\n            recommendation = xlsx_helper.get(row, 'recommendation #')\n            title = xlsx_helper.get(row, 'title')\n            # init\n            props = []\n            parts = []\n            links = []\n            # props\n            self._add_property(xlsx_helper, props, row, 'profile')\n            self._add_property(xlsx_helper, props, row, 'status')\n            self._add_property(xlsx_helper, props, row, 'assessment status')\n            if recommendation is None:\n                frag = section\n            else:\n                frag = recommendation\n            # parts\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_smt', row, 'statement')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_rat', row, 'rationale statement')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_imp', row, 'impact statement')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_rem', row, 'remediation procedure')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_aud', row, 'audit procedure')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_inf', row, 'additional information')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_ctl', row, 'CIS Controls')\n            # group or control\n            if recommendation is None:\n                catalog_helper.add_group(section, title, props, parts)\n            else:\n                self._add_property_boolean(xlsx_helper, props, row, 'v7 IG1')\n                self._add_property_boolean(xlsx_helper, props, row, 'v7 IG2')\n                self._add_property_boolean(xlsx_helper, props, row, 'v7 IG3')\n                self._add_property_boolean(xlsx_helper, props, row, 'v8 IG1')\n                self._add_property_boolean(xlsx_helper, props, row, 'v8 IG2')\n                self._add_property_boolean(xlsx_helper, props, row, 'v8 IG3')\n                self._add_property(xlsx_helper, props, row, 'MITRE ATT&amp;CK Mappings')\n                self._add_links(xlsx_helper, catalog_helper, links, row, 'references')\n                catalog_helper.add_control(section, recommendation, title, props, parts, links)\n\n    def _process_rhel(self, xlsx_helper: XlsxHelper, catalog_helper: CatalogHelper) -&gt; None:\n        \"\"\"Process RHEL.\"\"\"\n        # transform each row into OSCAL equivalent\n        for row in xlsx_helper.row_generator():\n            section = xlsx_helper.get(row, 'section #')\n            recommendation = xlsx_helper.get(row, 'recommendation #')\n            title = xlsx_helper.get(row, 'title')\n            # init\n            props = []\n            parts = []\n            links = []\n            # props\n            self._add_property(xlsx_helper, props, row, 'profile')\n            self._add_property(xlsx_helper, props, row, 'assessment status')\n            if recommendation is None:\n                frag = section\n            else:\n                frag = recommendation\n            # parts\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_smt', row, 'statement')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_rat', row, 'rational statement')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_imp', row, 'impact statement')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_rem', row, 'remediation procedure')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_aud', row, 'audit procedure')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_inf', row, 'additional information')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_ctl', row, 'CIS Controls')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_1v8', row, 'CIS Safeguards 1 (v8)')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_2v8', row, 'CIS Safeguards 2 (v8)')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_3v8', row, 'CIS Safeguards 3 (v8)')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_1v7', row, 'CIS Safeguards 1 (v7)')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_2v7', row, 'CIS Safeguards 2 (v7)')\n            self._add_part(xlsx_helper, parts, f'CIS-{frag}_3v7', row, 'CIS Safeguards 3 (v7)')\n            # group or control\n            if recommendation is None:\n                catalog_helper.add_group(section, title, props, parts)\n            else:\n                self._add_property_boolean(xlsx_helper, props, row, 'v7 IG1')\n                self._add_property_boolean(xlsx_helper, props, row, 'v7 IG2')\n                self._add_property_boolean(xlsx_helper, props, row, 'v7 IG3')\n                self._add_property_boolean(xlsx_helper, props, row, 'v8 IG1')\n                self._add_property_boolean(xlsx_helper, props, row, 'v8 IG2')\n                self._add_property_boolean(xlsx_helper, props, row, 'v8 IG3')\n                self._add_links(xlsx_helper, catalog_helper, links, row, 'references')\n                catalog_helper.add_control(section, recommendation, title, props, parts, links)\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.name","title":"<code>name = 'cis-xlsx-to-oscal-catalog'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.ns","title":"<code>ns = 'https://oscal-compass.github.io/compliance-trestle/schemas/oscal/catalog/cis'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.execute","title":"<code>execute()</code>","text":"<p>Provide an actual outcome.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an actual outcome.\"\"\"\n    try:\n        return self._execute()\n    except Exception:\n        logger.info(traceback.format_exc())\n        return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    logger.info(f'Help information for {self.name} task.')\n    logger.info('')\n    logger.info('Purpose: Create catalog from standard (e.g. CIS benchmark).')\n    logger.info('')\n    logger.info('Configuration flags sit under [task.cis-xlsx-to-oscal-catalog]:')\n    text1 = '  input-file             = '\n    text2 = '(required) path to read the compliance-as-code .xlsx spread sheet file.'\n    logger.info(text1 + text2)\n    text1 = '  output-dir             = '\n    text2 = '(required) location to write the generated catalog.json file.'\n    logger.info(text1 + text2)\n    text1 = '  title                  = '\n    text2 = '(required) title of the CIS catalog.'\n    logger.info(text1 + text2)\n    text1 = '  version                = '\n    text2 = '(required) version of the CIS catalog.'\n    logger.info(text1 + text2)\n    text1 = '  output-overwrite       = '\n    text2 = '(optional) true [default] or false; replace existing output when true.'\n    logger.info(text1 + text2)\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.CisXlsxToOscalCatalog.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    return TaskOutcome('simulated-success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper","title":"<code>XlsxHelper</code>","text":"<p>Xlsx Helper common functions and assistance navigating spread sheet.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>class XlsxHelper:\n    \"\"\"Xlsx Helper common functions and assistance navigating spread sheet.\"\"\"\n\n    def __init__(self, file: str) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self._spread_sheet = file\n        self._wb = load_workbook(self._spread_sheet)\n        sheet_candidates = ['Combined Profiles', 'Combined']\n        self._sheet_name = None\n        for sheet_candidate in sheet_candidates:\n            if sheet_candidate in self._wb.sheetnames:\n                self._sheet_name = sheet_candidate\n                break\n        if not self._sheet_name:\n            raise RuntimeError(f'{file} missing one of {sheet_candidates} sheet')\n        self._work_sheet = self._wb[self._sheet_name]\n        self._mapper()\n        self._key_to_col_map = {'statement': 'description'}\n\n    def is_ocp(self) -&gt; bool:\n        \"\"\"Check if sheet is for OCP.\"\"\"\n        return self._sheet_name == 'Combined Profiles'\n\n    def _normalize(self, name: str) -&gt; str:\n        \"\"\"Normalize.\"\"\"\n        return name.lower()\n\n    def _translate(self, name: str) -&gt; str:\n        \"\"\"Translate name key to column name.\"\"\"\n        return self._key_to_col_map.get(name, name)\n\n    def _mapper(self) -&gt; None:\n        \"\"\"Map columns heading names to column numbers.\"\"\"\n        self._col_name_to_number = {}\n        cols = self._work_sheet.max_column + 1\n        row = 1\n        for col in range(row, cols):\n            cell = self._work_sheet.cell(row, col)\n            if cell.value:\n                name = self._normalize(cell.value)\n                self._col_name_to_number[name] = col\n\n    def row_generator(self) -&gt; Iterator[int]:\n        \"\"\"Generate rows until max reached.\"\"\"\n        row = 2\n        while row &lt;= self._work_sheet.max_row:\n            yield row\n            row += 1\n\n    def get(self, row: int, name: str) -&gt; str:\n        \"\"\"Get cell value for given row and column name.\"\"\"\n        nname = self._normalize(name)\n        cname = self._translate(nname)\n        col = self._col_name_to_number[cname]\n        cell = self._work_sheet.cell(row, col)\n        return cell.value\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.__init__","title":"<code>__init__(file)</code>","text":"<p>Initialize.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def __init__(self, file: str) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self._spread_sheet = file\n    self._wb = load_workbook(self._spread_sheet)\n    sheet_candidates = ['Combined Profiles', 'Combined']\n    self._sheet_name = None\n    for sheet_candidate in sheet_candidates:\n        if sheet_candidate in self._wb.sheetnames:\n            self._sheet_name = sheet_candidate\n            break\n    if not self._sheet_name:\n        raise RuntimeError(f'{file} missing one of {sheet_candidates} sheet')\n    self._work_sheet = self._wb[self._sheet_name]\n    self._mapper()\n    self._key_to_col_map = {'statement': 'description'}\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.get","title":"<code>get(row, name)</code>","text":"<p>Get cell value for given row and column name.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def get(self, row: int, name: str) -&gt; str:\n    \"\"\"Get cell value for given row and column name.\"\"\"\n    nname = self._normalize(name)\n    cname = self._translate(nname)\n    col = self._col_name_to_number[cname]\n    cell = self._work_sheet.cell(row, col)\n    return cell.value\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.is_ocp","title":"<code>is_ocp()</code>","text":"<p>Check if sheet is for OCP.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def is_ocp(self) -&gt; bool:\n    \"\"\"Check if sheet is for OCP.\"\"\"\n    return self._sheet_name == 'Combined Profiles'\n</code></pre>"},{"location":"reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/#trestle.tasks.cis_xlsx_to_oscal_catalog.XlsxHelper.row_generator","title":"<code>row_generator()</code>","text":"<p>Generate rows until max reached.</p> Source code in <code>trestle/tasks/cis_xlsx_to_oscal_catalog.py</code> <pre><code>def row_generator(self) -&gt; Iterator[int]:\n    \"\"\"Generate rows until max reached.\"\"\"\n    row = 2\n    while row &lt;= self._work_sheet.max_row:\n        yield row\n        row += 1\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/","title":"trestle.tasks.csv_to_oscal_cd","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd","title":"<code>trestle.tasks.csv_to_oscal_cd</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.ADJUSTED_RISK_RATING","title":"<code>ADJUSTED_RISK_RATING = 'Adjusted_Risk_Rating'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CHECK_DESCRIPTION","title":"<code>CHECK_DESCRIPTION = 'Check_Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CHECK_ID","title":"<code>CHECK_ID = 'Check_Id'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.COMPONENT_DESCRIPTION","title":"<code>COMPONENT_DESCRIPTION = 'Component_Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.COMPONENT_TITLE","title":"<code>COMPONENT_TITLE = 'Component_Title'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.COMPONENT_TYPE","title":"<code>COMPONENT_TYPE = 'Component_Type'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CONTROL_ID_LIST","title":"<code>CONTROL_ID_LIST = 'Control_Id_List'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.FETCHER_DESCRIPTION","title":"<code>FETCHER_DESCRIPTION = 'Fetcher_Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.FETCHER_ID","title":"<code>FETCHER_ID = 'Fetcher_Id'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.HEADER_DECORATION_CHAR","title":"<code>HEADER_DECORATION_CHAR = '$'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.NAMESPACE","title":"<code>NAMESPACE = 'Namespace'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.ORIGINAL_RISK_RATING","title":"<code>ORIGINAL_RISK_RATING = 'Original_Risk_Rating'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.PARAMETER","title":"<code>PARAMETER = 'Parameter'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.PARAMETER_DESCRIPTION","title":"<code>PARAMETER_DESCRIPTION = f'{PARAMETER}_Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.PARAMETER_ID","title":"<code>PARAMETER_ID = f'{PARAMETER}_Id'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_ALTERNATIVES","title":"<code>PARAMETER_VALUE_ALTERNATIVES = f'{PARAMETER}_Value_Alternatives'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.PARAMETER_VALUE_DEFAULT","title":"<code>PARAMETER_VALUE_DEFAULT = f'{PARAMETER}_Value_Default'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.PROFILE_DESCRIPTION","title":"<code>PROFILE_DESCRIPTION = 'Profile_Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.PROFILE_SOURCE","title":"<code>PROFILE_SOURCE = 'Profile_Source'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.RISK_ADJUSTMENT","title":"<code>RISK_ADJUSTMENT = 'Risk_Adjustment'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.RULE_DESCRIPTION","title":"<code>RULE_DESCRIPTION = 'Rule_Description'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.RULE_ID","title":"<code>RULE_ID = 'Rule_Id'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.Row","title":"<code>Row = Iterator[List[str]]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.TARGET_COMPONENT","title":"<code>TARGET_COMPONENT = 'Target_Component'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.prefix_rule_set","title":"<code>prefix_rule_set = 'rule_set_'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.validation","title":"<code>validation = 'validation'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn","title":"<code>CsvColumn</code>","text":"<p>CsvColumn.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>class CsvColumn():\n    \"\"\"CsvColumn.\"\"\"\n\n    _columns_required = [\n        f'{COMPONENT_TITLE}',\n        f'{COMPONENT_DESCRIPTION}',\n        f'{COMPONENT_TYPE}',\n        f'{RULE_ID}',\n        f'{RULE_DESCRIPTION}',\n        f'{PROFILE_SOURCE}',\n        f'{PROFILE_DESCRIPTION}',\n        f'{CONTROL_ID_LIST}',\n        f'{NAMESPACE}',\n    ]\n\n    _columns_required_validation = [\n        f'{COMPONENT_TITLE}',\n        f'{COMPONENT_DESCRIPTION}',\n        f'{COMPONENT_TYPE}',\n        f'{RULE_ID}',\n        f'{NAMESPACE}',\n        f'{CHECK_ID}',\n        f'{CHECK_DESCRIPTION}',\n    ]\n\n    _columns_optional = [\n        f'{CHECK_ID}',\n        f'{CHECK_DESCRIPTION}',\n        f'{TARGET_COMPONENT}',\n        f'{ORIGINAL_RISK_RATING}',\n        f'{ADJUSTED_RISK_RATING}',\n        f'{RISK_ADJUSTMENT}',\n    ]\n\n    _columns_parameter = [\n        f'{PARAMETER_ID}',\n        f'{PARAMETER_DESCRIPTION}',\n        f'{PARAMETER_VALUE_ALTERNATIVES}',\n        f'{PARAMETER_VALUE_DEFAULT}',\n    ]\n\n    _columns_ordered = _columns_required + _columns_parameter + _columns_optional\n\n    @staticmethod\n    def get_order(column_name: str) -&gt; int:\n        \"\"\"Get order for column_name.\"\"\"\n        rval = sys.maxsize\n        if column_name in CsvColumn._columns_ordered:\n            rval = CsvColumn._columns_ordered.index(column_name)\n        return rval\n\n    @staticmethod\n    def is_column_name_required(name: str) -&gt; bool:\n        \"\"\"Is column name required.\"\"\"\n        return name in (CsvColumn._columns_required + CsvColumn._columns_required_validation)\n\n    @staticmethod\n    def is_column_name_optional(name: str) -&gt; bool:\n        \"\"\"Is column name optional.\"\"\"\n        return name in (CsvColumn._columns_optional)\n\n    @staticmethod\n    def is_column_name_parameter(name: str) -&gt; bool:\n        \"\"\"Is column name parameter.\"\"\"\n        for cname in CsvColumn._columns_parameter:\n            if name.startswith(cname):\n                return True\n        return False\n\n    @staticmethod\n    def get_required_column_names() -&gt; List[str]:\n        \"\"\"Get required column names.\"\"\"\n        rval = []\n        rval += CsvColumn._columns_required\n        return rval\n\n    @staticmethod\n    def get_optional_column_names() -&gt; List[str]:\n        \"\"\"Get optional column names.\"\"\"\n        rval = []\n        rval += CsvColumn._columns_optional\n        return rval\n\n    @staticmethod\n    def get_parameter_column_names() -&gt; List[str]:\n        \"\"\"Get parameter column names.\"\"\"\n        rval = []\n        rval += CsvColumn._columns_parameters\n        return rval\n\n    @staticmethod\n    def get_required_column_names_validation() -&gt; List[str]:\n        \"\"\"Get required column names validation.\"\"\"\n        rval = []\n        rval += CsvColumn._columns_required_validation\n        return rval\n\n    _rule_property_column_names = [\n        f'{RULE_ID}',\n        f'{RULE_DESCRIPTION}',\n        f'{PARAMETER_ID}',\n        f'{PARAMETER_DESCRIPTION}',\n        f'{PARAMETER_VALUE_ALTERNATIVES}',\n        f'{CHECK_ID}',\n        f'{CHECK_DESCRIPTION}',\n        f'{TARGET_COMPONENT}',\n        f'{ORIGINAL_RISK_RATING}',\n        f'{ADJUSTED_RISK_RATING}',\n        f'{RISK_ADJUSTMENT}',\n    ]\n\n    @staticmethod\n    def get_rule_property_column_names() -&gt; List[str]:\n        \"\"\"Get rule property column names.\"\"\"\n        return CsvColumn._rule_property_column_names\n\n    # columns required which do not become properties\n    _columns_required_filtered = [\n        f'{COMPONENT_TITLE}',\n        f'{COMPONENT_DESCRIPTION}',\n        f'{COMPONENT_TYPE}',\n        f'{PROFILE_SOURCE}',\n        f'{PROFILE_DESCRIPTION}',\n        f'{CONTROL_ID_LIST}',\n        f'{NAMESPACE}',\n    ]\n\n    # optional columns which do not become properties, initially\n    _columns_optional_filtered = []\n\n    _columns_filtered = _columns_required_filtered + _columns_optional_filtered\n\n    @staticmethod\n    def get_filtered_required_column_names() -&gt; List[str]:\n        \"\"\"Get filtered required column names.\"\"\"\n        rval = []\n        for column_name in CsvColumn.get_required_column_names():\n            if column_name not in CsvColumn._columns_filtered:\n                rval.append(column_name)\n        return rval\n\n    @staticmethod\n    def get_filtered_optional_column_names() -&gt; List[str]:\n        \"\"\"Get filtered optional column names.\"\"\"\n        rval = []\n        for column_name in CsvColumn.get_optional_column_names():\n            if column_name not in CsvColumn._columns_filtered:\n                rval.append(column_name)\n        return rval\n\n    _check_property_column_names = [\n        f'{RULE_ID}',\n        f'{CHECK_ID}',\n        f'{CHECK_DESCRIPTION}',\n        f'{TARGET_COMPONENT}',\n    ]\n\n    @staticmethod\n    def get_check_property_column_names() -&gt; List[str]:\n        \"\"\"Get check property column names.\"\"\"\n        return CsvColumn._check_property_column_names\n\n    # optional columns which do become properties, afterwards\n    _columns_parameters = [\n        f'{PARAMETER_ID}',\n        f'{PARAMETER_DESCRIPTION}',\n        f'{PARAMETER_VALUE_ALTERNATIVES}',\n    ]\n\n    # optional columns which require Param_Id be present in the row\n    _columns_parameters_dependent = [\n        f'{PARAMETER_DESCRIPTION}',\n        f'{PARAMETER_VALUE_ALTERNATIVES}',\n        f'{PARAMETER_VALUE_DEFAULT}',\n    ]\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_check_property_column_names","title":"<code>get_check_property_column_names()</code>  <code>staticmethod</code>","text":"<p>Get check property column names.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef get_check_property_column_names() -&gt; List[str]:\n    \"\"\"Get check property column names.\"\"\"\n    return CsvColumn._check_property_column_names\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_optional_column_names","title":"<code>get_filtered_optional_column_names()</code>  <code>staticmethod</code>","text":"<p>Get filtered optional column names.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef get_filtered_optional_column_names() -&gt; List[str]:\n    \"\"\"Get filtered optional column names.\"\"\"\n    rval = []\n    for column_name in CsvColumn.get_optional_column_names():\n        if column_name not in CsvColumn._columns_filtered:\n            rval.append(column_name)\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_filtered_required_column_names","title":"<code>get_filtered_required_column_names()</code>  <code>staticmethod</code>","text":"<p>Get filtered required column names.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef get_filtered_required_column_names() -&gt; List[str]:\n    \"\"\"Get filtered required column names.\"\"\"\n    rval = []\n    for column_name in CsvColumn.get_required_column_names():\n        if column_name not in CsvColumn._columns_filtered:\n            rval.append(column_name)\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_optional_column_names","title":"<code>get_optional_column_names()</code>  <code>staticmethod</code>","text":"<p>Get optional column names.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef get_optional_column_names() -&gt; List[str]:\n    \"\"\"Get optional column names.\"\"\"\n    rval = []\n    rval += CsvColumn._columns_optional\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_order","title":"<code>get_order(column_name)</code>  <code>staticmethod</code>","text":"<p>Get order for column_name.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef get_order(column_name: str) -&gt; int:\n    \"\"\"Get order for column_name.\"\"\"\n    rval = sys.maxsize\n    if column_name in CsvColumn._columns_ordered:\n        rval = CsvColumn._columns_ordered.index(column_name)\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_parameter_column_names","title":"<code>get_parameter_column_names()</code>  <code>staticmethod</code>","text":"<p>Get parameter column names.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef get_parameter_column_names() -&gt; List[str]:\n    \"\"\"Get parameter column names.\"\"\"\n    rval = []\n    rval += CsvColumn._columns_parameters\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names","title":"<code>get_required_column_names()</code>  <code>staticmethod</code>","text":"<p>Get required column names.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef get_required_column_names() -&gt; List[str]:\n    \"\"\"Get required column names.\"\"\"\n    rval = []\n    rval += CsvColumn._columns_required\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_required_column_names_validation","title":"<code>get_required_column_names_validation()</code>  <code>staticmethod</code>","text":"<p>Get required column names validation.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef get_required_column_names_validation() -&gt; List[str]:\n    \"\"\"Get required column names validation.\"\"\"\n    rval = []\n    rval += CsvColumn._columns_required_validation\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.get_rule_property_column_names","title":"<code>get_rule_property_column_names()</code>  <code>staticmethod</code>","text":"<p>Get rule property column names.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef get_rule_property_column_names() -&gt; List[str]:\n    \"\"\"Get rule property column names.\"\"\"\n    return CsvColumn._rule_property_column_names\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_optional","title":"<code>is_column_name_optional(name)</code>  <code>staticmethod</code>","text":"<p>Is column name optional.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef is_column_name_optional(name: str) -&gt; bool:\n    \"\"\"Is column name optional.\"\"\"\n    return name in (CsvColumn._columns_optional)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_parameter","title":"<code>is_column_name_parameter(name)</code>  <code>staticmethod</code>","text":"<p>Is column name parameter.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef is_column_name_parameter(name: str) -&gt; bool:\n    \"\"\"Is column name parameter.\"\"\"\n    for cname in CsvColumn._columns_parameter:\n        if name.startswith(cname):\n            return True\n    return False\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvColumn.is_column_name_required","title":"<code>is_column_name_required(name)</code>  <code>staticmethod</code>","text":"<p>Is column name required.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>@staticmethod\ndef is_column_name_required(name: str) -&gt; bool:\n    \"\"\"Is column name required.\"\"\"\n    return name in (CsvColumn._columns_required + CsvColumn._columns_required_validation)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition","title":"<code>CsvToOscalComponentDefinition</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to create OSCAL ComponentDefinition json.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>class CsvToOscalComponentDefinition(TaskBase):\n    \"\"\"\n    Task to create OSCAL ComponentDefinition json.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'csv-to-oscal-cd'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task csv-to-oscal-cd.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        name = self.name\n        oscal_name = 'component_definition'\n        # help note identifiers\n        note01 = '1'\n        note02 = '2'\n        note03 = '3'\n        note04 = '4'\n        note05 = '5'\n        # help generation\n        logger.info(f'Help information for {name} task.')\n        logger.info('')\n        logger.info(f'Purpose: From csv produce OSCAL {oscal_name} file.')\n        logger.info('')\n        logger.info('')\n        logger.info(f'Configuration flags sit under [task.{name}]:')\n        text1 = '  title                = '\n        text2 = '(required) the component definition title.'\n        logger.info(text1 + text2)\n        text1 = '  version              = '\n        text2 = '(required) the component definition version.'\n        logger.info(text1 + text2)\n        text1 = '  csv-file             = '\n        text2 = '(required) the path of the csv file.'\n        text3 = ' [1st row are column headings; 2nd row are column descriptions; 3rd row and beyond is data]'\n        logger.info(text1 + text2 + text3)\n        text1 = '  required columns:      '\n        for text2 in CsvColumn.get_required_column_names():\n            if text2 in [f'{RULE_DESCRIPTION}', f'{PROFILE_SOURCE}', f'{PROFILE_DESCRIPTION}', f'{CONTROL_ID_LIST}']:\n                text2 += f' (see note {note01})'\n            logger.info(text1 + '$$' + text2)\n            text1 = '                         '\n        text1 = '  optional columns:      '\n        for text2 in CsvColumn.get_optional_column_names():\n            if text2 in [f'{ORIGINAL_RISK_RATING}', f'{ADJUSTED_RISK_RATING}', f'{RISK_ADJUSTMENT}']:\n                text2 += f' (see note {note01})'\n            elif text2 in [f'{TARGET_COMPONENT}']:\n                text2 += f' (see note {note03})'\n            else:\n                text2 += f' (see note {note02})'\n            logger.info(text1 + '$' + text2)\n            text1 = '                         '\n        for text2 in CsvColumn.get_parameter_column_names():\n            text2 += f' (see notes {note01}, {note05})'\n            logger.info(text1 + '$' + text2)\n            text1 = '                         '\n        text1 = '  comment columns:       '\n        text2 = f'Informational (see note {note04})'\n        logger.info(text1 + '#' + text2)\n        text1 = '  output-dir           = '\n        text2 = '(required) the path of the output directory for synthesized OSCAL .json files.'\n        logger.info(text1 + text2)\n        text1 = '  component-definition = '\n        text2 = '(optional) the path of the existing component-definition OSCAL .json file.'\n        logger.info(text1 + text2)\n        text1 = '  class.column-name    = '\n        text2 = f'(optional) the class to associate with the specified column name, e.g. class.{RULE_ID} = scc_class'\n        logger.info(text1 + text2)\n        text1 = '  output-overwrite     = '\n        text2 = '(optional) true [default] or false; replace existing output when true.'\n        logger.info(text1 + text2)\n        text1 = '  validate-controls    = '\n        text2 = '(optional) on, warn, or off [default]; validate controls exist in resolved profile.'\n        logger.info(text1 + text2)\n        # Notes\n        text1 = ''\n        text2 = ''\n        logger.info(text1 + text2)\n        text1 = 'Notes: '\n        text2 = f'[{note01}] column is ignored for validation component type'\n        logger.info(text1 + text2)\n        text1 = '       '\n        text2 = f'[{note02}] column is required for validation component type'\n        logger.info(text1 + text2)\n        text1 = '       '\n        text2 = f'[{note03}] column is optional for validation component type'\n        text3 = f', but may be needed to prevent {RULE_ID} collisions'\n        logger.info(text1 + text2 + text3)\n        text1 = '       '\n        text2 = f'[{note04}] column name starting with # causes column to be ignored'\n        logger.info(text1 + text2)\n        text1 = '       '\n        text2 = f'[{note05}] additional parameters are specified by adding a common suffix per set'\n        text3 = f', for example: {PARAMETER_ID}_1, {PARAMETER_DESCRIPTION}_1, ...{PARAMETER_ID}_2...'\n        logger.info(text1 + text2 + text3)\n\n    def configure(self) -&gt; bool:\n        \"\"\"Configure.\"\"\"\n        self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n        # config verbosity\n        self._quiet = self._config.get('quiet', False)\n        self._verbose = not self._quiet\n        # title\n        self._title = self._config.get('title')\n        if self._title is None:\n            logger.warning('config missing \"title\"')\n            return False\n        # version\n        self._version = self._config.get('version')\n        if self._version is None:\n            logger.warning('config missing \"version\"')\n            return False\n        # config csv\n        self._csv_file = self._config.get('csv-file')\n        if self._csv_file is None:\n            logger.warning('config missing \"csv-file\"')\n            return False\n        self._csv_path = pathlib.Path(self._csv_file)\n        if not self._csv_path.exists():\n            logger.warning('\"csv-file\" not found')\n            return False\n        # announce csv\n        if self._verbose:\n            logger.info(f'input: {self._csv_file}')\n        # config cd\n        self._cd_path = None\n        self._cd_file = self._config.get('component-definition')\n        if self._cd_file is not None:\n            self._cd_path = pathlib.Path(self._cd_file)\n            if not self._cd_path.exists():\n                logger.warning('\"component-definition\" not found')\n                return False\n        # workspace\n        self._workspace = os.getcwd()\n        # validate_controls\n        self._validate_controls = self._config.get('validate-controls', 'off')\n        return True\n\n    def get_class(self, name: str) -&gt; str:\n        \"\"\"Get class value for specified name from config.\"\"\"\n        key = f'class.{name}'\n        return self._config.get(key)\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        return TaskOutcome('simulated-success')\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an executed outcome.\"\"\"\n        try:\n            return self._execute()\n        except Exception:\n            logger.error(traceback.format_exc())\n            return TaskOutcome('failure')\n\n    def _execute(self) -&gt; TaskOutcome:\n        \"\"\"Execute path core.\"\"\"\n        if not self.configure():\n            return TaskOutcome('failure')\n        # config output\n        odir = self._config.get('output-dir')\n        opth = pathlib.Path(odir)\n        self._overwrite = self._config.getboolean('output-overwrite', True)\n        # insure output dir exists\n        opth.mkdir(exist_ok=True, parents=True)\n        # calculate output file name &amp; check writability\n        oname = 'component-definition.json'\n        ofile = opth / oname\n        if not self._overwrite and pathlib.Path(ofile).exists():\n            logger.warning(f'output: {ofile} already exists')\n            return TaskOutcome('failure')\n        # fetch existing component-definition, if any\n        self._cd_mgr = _CdMgr(self._cd_path, self._title, self._timestamp, self._version)\n        # fetch csv\n        self._csv_mgr = _CsvMgr(self._csv_path)\n        # create resolved profile -&gt; catalog helper\n        profile_list = self._csv_mgr.get_profile_list()\n        self._resolved_profile_catalog_helper = _ResolvedProfileCatalogHelper(profile_list, self._workspace)\n        self._unresolved_controls = []\n        # calculate deletion, addition &amp; modification rule lists\n        rules = self._calculate_rules()\n        # calculate deletion, addition &amp; modification set-parameter lists\n        set_params = self._calculate_set_params(rules[2])\n        # calculate deletion, addition &amp; modification control mapping lists\n        control_mappings = self._calculate_control_mappings(rules[2])\n        # rule set manager\n        self._rule_set_id_mgr = _RuleSetIdMgr(self._cd_mgr.get_max_rule_set_number(), len(rules[1]))\n        # rule additions, deletions &amp; modifications (by row)\n        self.rules_del(rules[0])\n        self.rules_add(rules[1])\n        self.rules_mod(rules[2])\n        # set-parameters additions, deletions &amp; modifications (by row)\n        self.set_params_del(set_params[0])\n        self.set_params_add(set_params[1])\n        self.set_params_mod(set_params[2])\n        # control mappings additions, deletions &amp; modifications (by row)\n        self.control_mappings_del(control_mappings[0])\n        self.control_mappings_add(control_mappings[1])\n        # note: control mappings mod is currently not possible\n        # note: add/del user columns not currently supported\n        if len(self._unresolved_controls) &gt; 0:\n            text = f'Unresolved controls: {self._unresolved_controls}'\n            if self._validate_controls == 'warn':\n                logger.warning(text)\n            elif self._validate_controls == 'on':\n                raise RuntimeError(text)\n        # prepare new/revised component definition\n        component_definition = self._cd_mgr.get_component_definition()\n        # write OSCAL ComponentDefinition to file\n        if self._verbose:\n            logger.info(f'output: {ofile}')\n        component_definition.oscal_write(pathlib.Path(ofile))\n        return TaskOutcome('success')\n\n    def _calculate_rules(self) -&gt; tuple:\n        \"\"\"Calculate rules add, delete, modify.\"\"\"\n        cd_rules = self._cd_mgr.get_rule_keys()\n        csv_rules = self._csv_mgr.get_rule_keys()\n        del_rules = []\n        add_rules = []\n        mod_rules = []\n        for key in cd_rules:\n            if key in csv_rules:\n                continue\n            else:\n                del_rules.append(key)\n                logger.debug(f'rules del: {key}')\n        for key in csv_rules:\n            if key in cd_rules:\n                mod_rules.append(key)\n                logger.debug(f'rules mod: {key}')\n            else:\n                add_rules.append(key)\n                logger.debug(f'rules add: {key}')\n        return (del_rules, add_rules, mod_rules)\n\n    def _calculate_set_params(self, mod_rules: List) -&gt; tuple:\n        \"\"\"Calculate set parameters add, delete, modify.\"\"\"\n        cd_set_params = self._cd_mgr.get_set_params_keys()\n        csv_set_params = self._csv_mgr.get_set_params_keys()\n        del_set_params = []\n        add_set_params = []\n        mod_set_params = []\n        for key in cd_set_params:\n            rule_key = synthesize_rule_key(key[0], key[1], key[2], None, None)\n            if rule_key not in mod_rules:\n                continue\n            if key in csv_set_params:\n                continue\n            else:\n                del_set_params.append(key)\n                logger.debug(f'params del: {key}')\n        for key in csv_set_params:\n            rule_key = synthesize_rule_key(key[0], key[1], key[2], None, None)\n            if rule_key not in mod_rules:\n                continue\n            if key in cd_set_params:\n                mod_set_params.append(key)\n                logger.debug(f'params mod: {key}')\n            else:\n                add_set_params.append(key)\n                logger.debug(f'params add: {key}')\n        return (del_set_params, add_set_params, mod_set_params)\n\n    def _calculate_control_mappings(self, mod_rules: List) -&gt; tuple:\n        \"\"\"Calculate control mappings add, delete, modify.\"\"\"\n        cd_controls = self._cd_mgr.get_control_keys()\n        csv_controls = self._csv_mgr.get_control_keys()\n        del_control_mappings = []\n        add_control_mappings = []\n        mod_control_mappings = []\n        for key in cd_controls:\n            rule_key = synthesize_rule_key(key[0], key[1], key[2], None, None)\n            if rule_key not in mod_rules:\n                continue\n            if key in csv_controls:\n                continue\n            else:\n                del_control_mappings.append(key)\n                logger.debug(f'ctl-maps del: {key}')\n        for key in csv_controls:\n            rule_key = synthesize_rule_key(key[0], key[1], key[2], None, None)\n            if rule_key not in mod_rules:\n                continue\n            if key in cd_controls:\n                mod_control_mappings.append(key)\n                logger.debug(f'ctl-maps mod: {key}')\n            else:\n                add_control_mappings.append(key)\n                logger.debug(f'ctl-maps add: {key}')\n        return (del_control_mappings, add_control_mappings, mod_control_mappings)\n\n    def _get_namespace(self, rule_key: tuple) -&gt; str:\n        \"\"\"Get namespace.\"\"\"\n        return self._csv_mgr.get_value(rule_key, NAMESPACE).strip()\n\n    def _get_prop_name(self, column_name: str) -&gt; str:\n        \"\"\"Get property name.\"\"\"\n        return column_name.lstrip('$')\n\n    def rules_del(self, del_rules: List[str]) -&gt; None:\n        \"\"\"Delete rules.\"\"\"\n        for tokens in del_rules:\n            component_title = tokens[0]\n            component_type = tokens[1]\n            rule_id = tokens[2]\n            description = ''\n            # component\n            component = self._cd_mgr.get_component(component_title, component_type, description)\n            # props\n            component.props = self._delete_rule_props(component, rule_id)\n\n    def _delete_rule_props(self, component: DefinedComponent, rule_id: str) -&gt; List[Property]:\n        \"\"\"Delete rule props.\"\"\"\n        props = []\n        rule_set = _RuleSetHelper.get_rule_set(component.props, rule_id)\n        for prop in component.props:\n            if prop.remarks != rule_set:\n                props.append(prop)\n            elif prop.name in self._csv_mgr.get_parameter_id_column_names():\n                self._delete_rule_set_parameter(component, prop.value)\n            elif prop.name == RULE_ID:\n                self._delete_rule_implemented_requirement(component, prop.value)\n        return props\n\n    def _control_implementation_generator(\n        self, control_implementations: List[ControlImplementation]\n    ) -&gt; Iterator[ControlImplementation]:\n        \"\"\"Control implementation generator.\"\"\"\n        if control_implementations:\n            for control_implementation in control_implementations:\n                yield control_implementation\n\n    def _set_parameter_generator(self, set_parameters: List[SetParameter]) -&gt; Iterator[SetParameter]:\n        \"\"\"Set parameter generator.\"\"\"\n        if set_parameters:\n            for set_parameter in set_parameters:\n                yield set_parameter\n\n    def _implemented_requirement_generator(\n        self, implemented_requirements: List[ImplementedRequirement]\n    ) -&gt; Iterator[ImplementedRequirement]:\n        \"\"\"Implemented-requirement generator.\"\"\"\n        if implemented_requirements:\n            for implemented_requirement in implemented_requirements:\n                yield implemented_requirement\n\n    def _delete_rule_set_parameter(self, component: DefinedComponent, parameter_id: str) -&gt; None:\n        \"\"\"Delete rule set-parameter.\"\"\"\n        control_implementations = component.control_implementations\n        for control_implementation in self._control_implementation_generator(control_implementations):\n            if control_implementation.set_parameters:\n                set_parameters = control_implementation.set_parameters\n                control_implementation.set_parameters = []\n                for set_parameter in set_parameters:\n                    if set_parameter.param_id != parameter_id:\n                        _OscalHelper.add_set_parameter(control_implementation.set_parameters, set_parameter)\n                if not len(control_implementation.set_parameters):\n                    control_implementation.set_parameters = None\n\n    def _delete_rule_implemented_requirement(self, component: DefinedComponent, rule_id: str) -&gt; None:\n        \"\"\"Delete rule implemented_requirement.\"\"\"\n        control_implementations = component.control_implementations\n        component.control_implementations = []\n        for control_implementation in self._control_implementation_generator(control_implementations):\n            if control_implementation.implemented_requirements:\n                implemented_requirements = control_implementation.implemented_requirements\n                control_implementation.implemented_requirements = []\n                for implemented_requirement in implemented_requirements:\n                    self._delete_ir_props(implemented_requirement, rule_id)\n                    self._delete_ir_statements(implemented_requirement, rule_id)\n                    if len(as_list(implemented_requirement.props)) or len(as_list(implemented_requirement.statements)):\n                        control_implementation.implemented_requirements.append(implemented_requirement)\n            if len(as_list(control_implementation.implemented_requirements)):\n                component.control_implementations.append(control_implementation)\n\n    def _delete_ir_statements(self, implemented_requirement: ImplementedRequirement, rule_id: str) -&gt; None:\n        \"\"\"Delete implemented-requirement statements.\"\"\"\n        if implemented_requirement.statements:\n            statements = implemented_requirement.statements\n            implemented_requirement.statements = []\n            for statement in statements:\n                statement.props = self._delete_props(statement.props, rule_id)\n                if not len(statement.props):\n                    statement.props = None\n                if statement.props:\n                    implemented_requirement.statements.append(statement)\n            if not len(implemented_requirement.statements):\n                implemented_requirement.statements = None\n\n    def _delete_ir_props(self, implemented_requirement: ImplementedRequirement, rule_id: str) -&gt; None:\n        \"\"\"Delete implemented-requirement props.\"\"\"\n        if implemented_requirement.props:\n            implemented_requirement.props = self._delete_props(implemented_requirement.props, rule_id)\n            if not len(implemented_requirement.props):\n                implemented_requirement.props = None\n\n    def _delete_props(self, props: List[Property], rule_id: str) -&gt; List[property]:\n        \"\"\"Delete props.\"\"\"\n        rval = []\n        if props:\n            for prop in props:\n                if prop.name == RULE_ID and prop.value == rule_id:\n                    continue\n                rval.append(prop)\n        return rval\n\n    def rules_add(self, add_rules: List[str]) -&gt; None:\n        \"\"\"Add rules.\"\"\"\n        for rule_key in add_rules:\n            component_title = self._csv_mgr.get_value(rule_key, COMPONENT_TITLE)\n            component_type = self._csv_mgr.get_value(rule_key, COMPONENT_TYPE)\n            component_description = self._csv_mgr.get_value(rule_key, COMPONENT_DESCRIPTION)\n            # component\n            component = self._cd_mgr.get_component(component_title, component_type, component_description)\n            # props\n            component.props = as_list(component.props)\n            component.props = component.props + self._create_rule_props(rule_key)\n            # additional props, when not validation component\n            if not self._is_validation(rule_key):\n                # control implementation\n                source = self._csv_mgr.get_value(rule_key, PROFILE_SOURCE)\n                description = self._csv_mgr.get_value(rule_key, PROFILE_DESCRIPTION)\n                control_implementation = self._get_control_implementation(component, source, description)\n                # set-parameters\n                set_parameters = self._create_set_parameters(rule_key)\n                if set_parameters:\n                    control_implementation.set_parameters = as_list(control_implementation.set_parameters)\n                    _OscalHelper.add_set_parameters(control_implementation.set_parameters, set_parameters)\n                # control-mappings\n                control_mappings = self._csv_mgr.get_value(rule_key, CONTROL_ID_LIST).split()\n                self._add_rule_prop(control_implementation, control_mappings, rule_key)\n\n    def _is_validation(self, rule_key: tuple) -&gt; bool:\n        \"\"\"Check for validation component.\"\"\"\n        component_type = self._csv_mgr.get_value(rule_key, COMPONENT_TYPE)\n        return is_validation(component_type)\n\n    def _add_rule_prop(\n        self, control_implementation: ControlImplementation, control_mappings: List[str], rule_key: tuple\n    ) -&gt; None:\n        \"\"\"Add rule prop.\"\"\"\n        namespace = self._get_namespace(rule_key)\n        for control_mapping in control_mappings:\n            control_id = derive_control_id(control_mapping)\n            implemented_requirement = self._get_implemented_requirement(control_implementation, control_id)\n            # create rule implementation (as property)\n            name = RULE_ID\n            prop = Property(\n                name=name,\n                value=self._csv_mgr.get_value(rule_key, name),\n                ns=namespace,\n                class_=self.get_class(name),\n            )\n            part_id = derive_part_id(control_mapping)\n            if part_id is None:\n                implemented_requirement.props = as_list(implemented_requirement.props)\n                implemented_requirement.props.append(prop)\n            else:\n                statement = self._get_statement(implemented_requirement, part_id)\n                statement.props.append(prop)\n\n    def _create_rule_props(self, rule_key: tuple) -&gt; List[Property]:\n        \"\"\"Create rule props.\"\"\"\n        rule_set = self._rule_set_id_mgr.get_next_rule_set_id()\n        row_number = self._csv_mgr.get_row_number(rule_key)\n        rule_set_mgr = _RuleSetMgr(row_number, rule_set)\n        namespace = self._get_namespace(rule_key)\n        if self._is_validation(rule_key):\n            column_names = CsvColumn.get_check_property_column_names()\n        else:\n            column_names = CsvColumn.get_rule_property_column_names()\n        # req'd &amp; optional props\n        for column_name in column_names:\n            prop_name = self._get_prop_name(column_name)\n            prop_value = self._csv_mgr.get_value(rule_key, column_name).strip()\n            rule_set_mgr.add_prop(prop_name, prop_value, namespace, self.get_class(prop_name))\n        if not self._is_validation(rule_key):\n            # parameter columns\n            column_names = self._csv_mgr.get_parameter_column_names()\n            for column_name in column_names:\n                prop_name = self._get_prop_name(column_name)\n                prop_value = self._csv_mgr.get_value(rule_key, column_name).strip()\n                rule_set_mgr.add_prop(prop_name, prop_value, namespace, self.get_class(prop_name))\n        # user props\n        column_names = self._csv_mgr.get_user_column_names()\n        for column_name in column_names:\n            if column_name.startswith('#'):\n                continue\n            prop_name = self._get_prop_name(column_name)\n            prop_value = self._csv_mgr.get_value(rule_key, column_name).strip()\n            rule_set_mgr.add_prop(prop_name, prop_value, namespace, self.get_class(prop_name))\n        return rule_set_mgr.get_props()\n\n    def _get_control_implementation(\n        self, component: DefinedComponent, source: str, description: str\n    ) -&gt; ControlImplementation:\n        \"\"\"Find or create control implementation.\"\"\"\n        component.control_implementations = as_list(component.control_implementations)\n        for control_implementation in component.control_implementations:\n            if control_implementation.source == source and control_implementation.description == description:\n                return control_implementation\n        control_implementation = ControlImplementation(\n            uuid=str(uuid.uuid4()), source=source, description=description, implemented_requirements=[]\n        )\n        component.control_implementations.append(control_implementation)\n        return control_implementation\n\n    def _str_to_list(self, value: str) -&gt; List[str]:\n        \"\"\"Transform string to list.\"\"\"\n        rval = []\n        if ',' in value:\n            values = value.split(',')\n            # remove leading/trailing whitespace\n            for v in values:\n                rval.append(v.strip())\n        else:\n            rval.append(value)\n        return rval\n\n    def _create_set_parameters(self, rule_key: tuple) -&gt; List[SetParameter]:\n        \"\"\"Create set parameters.\"\"\"\n        set_parameters = []\n        for parameter_id_column_name in self._csv_mgr.get_parameter_id_column_names():\n            suffix = parameter_id_column_name.replace(PARAMETER_ID, '')\n            parameter_value_default_column_name = f'{PARAMETER_VALUE_DEFAULT}{suffix}'\n            name = self._csv_mgr.get_value(rule_key, parameter_id_column_name)\n            value = self._csv_mgr.get_value(rule_key, parameter_value_default_column_name)\n            if name and value:\n                try:\n                    values = self._str_to_list(value)\n                    set_parameter = SetParameter(\n                        param_id=name,\n                        values=values,\n                    )\n                    set_parameters.append(set_parameter)\n                except Exception:\n                    row_number = self._csv_mgr.get_row_number(rule_key)\n                    text = (\n                        f'row {row_number}: \"{name}\" is invalid for column {parameter_id_column_name} '\n                        f'and/or \"{\",\".join(values)}\" is invalid for column {parameter_value_default_column_name}'\n                    )\n                    raise RuntimeError(text)\n            elif name:\n                row_number = self._csv_mgr.get_row_number(rule_key)\n                text = f'row \"{row_number}\" missing value for \"{parameter_value_default_column_name}\"'\n                logger.debug(text)\n        return set_parameters\n\n    def _get_implemented_requirement(\n        self, control_implementation: ControlImplementation, control_id: str\n    ) -&gt; ImplementedRequirement:\n        \"\"\"Find or create implemented requirement.\"\"\"\n        if self._validate_controls != 'off':\n            if not self._resolved_profile_catalog_helper.validate(control_id):\n                if control_id not in self._unresolved_controls:\n                    self._unresolved_controls.append(control_id)\n        for implemented_requirement in control_implementation.implemented_requirements:\n            if implemented_requirement.control_id == control_id:\n                return implemented_requirement\n        implemented_requirement = ImplementedRequirement(\n            uuid=str(uuid.uuid4()),\n            control_id=control_id,\n            description='',\n        )\n        control_implementation.implemented_requirements.append(implemented_requirement)\n        return implemented_requirement\n\n    def _get_statement(self, implemented_requirement: ImplementedRequirement, part_id: str) -&gt; Statement:\n        \"\"\"Find or create statement.\"\"\"\n        implemented_requirement.statements = as_list(implemented_requirement.statements)\n        for statement in implemented_requirement.statements:\n            if statement.statement_id == part_id:\n                return statement\n        statement = Statement(\n            uuid=str(uuid.uuid4()),\n            statement_id=part_id,\n            description='',\n            props=[],\n        )\n        implemented_requirement.statements.append(statement)\n        return statement\n\n    def rules_mod(self, mod_rules: List[str]) -&gt; None:\n        \"\"\"Modify rules.\"\"\"\n        for rule_key in mod_rules:\n            component_title = self._csv_mgr.get_value(rule_key, COMPONENT_TITLE)\n            component_type = self._csv_mgr.get_value(rule_key, COMPONENT_TYPE)\n            component_description = self._csv_mgr.get_value(rule_key, COMPONENT_DESCRIPTION)\n            # component\n            component = self._cd_mgr.get_component(component_title, component_type, component_description)\n            # props\n            component.props = self._modify_rule_props(component, rule_key)\n\n    def _modify_rule_props(self, component: DefinedComponent, rule_key: tuple) -&gt; List[Property]:\n        \"\"\"Modify rule props.\"\"\"\n        rule_id = self._csv_mgr.get_value(rule_key, RULE_ID)\n        rule_set = _RuleSetHelper.get_rule_set(component.props, rule_id)\n        rule_ns = self._csv_mgr.get_value(rule_key, NAMESPACE)\n        column_names = CsvColumn.get_filtered_required_column_names() + CsvColumn.get_filtered_optional_column_names()\n        # req'd &amp; optional props\n        for column_name in column_names:\n            column_value = self._csv_mgr.get_value(rule_key, column_name).strip()\n            class_ = self.get_class(column_name)\n            self._cd_mgr.update_rule_definition(component, rule_set, column_name, column_value, rule_ns, class_)\n        # parameter columns\n        column_names = self._csv_mgr.get_parameter_column_names()\n        for column_name in column_names:\n            column_value = self._csv_mgr.get_value(rule_key, column_name).strip()\n            class_ = self.get_class(column_name)\n            self._cd_mgr.update_rule_definition(component, rule_set, column_name, column_value, rule_ns, class_)\n        # user props\n        column_names = self._csv_mgr.get_user_column_names()\n        for column_name in column_names:\n            column_value = self._csv_mgr.get_value(rule_key, column_name).strip()\n            self._cd_mgr.update_rule_definition(component, rule_set, column_name, column_value, rule_ns, class_)\n        return component.props\n\n    def set_params_del(self, del_set_params: List[str]) -&gt; None:\n        \"\"\"Set parameters delete.\"\"\"\n        for tokens in del_set_params:\n            component_title = tokens[0]\n            component_type = tokens[1]\n            source = tokens[3]\n            description = tokens[4]\n            param_id = tokens[5]\n            # ctl impl\n            control_implementation = self._cd_mgr.find_control_implementation(\n                component_title, component_type, source, description\n            )\n            if control_implementation:\n                set_parameters = control_implementation.set_parameters\n                control_implementation.set_parameters = []\n                for set_parameter in self._set_parameter_generator(set_parameters):\n                    if set_parameter.param_id == param_id:\n                        continue\n                    _OscalHelper.add_set_parameter(control_implementation.set_parameters, set_parameter)\n                if control_implementation.set_parameters == []:\n                    control_implementation.set_parameters = None\n\n    def set_params_add(self, add_set_params: List[str]) -&gt; None:\n        \"\"\"Set parameters add.\"\"\"\n        for tokens in add_set_params:\n            component_title = tokens[0]\n            component_type = tokens[1]\n            rule_id = tokens[2]\n            source = tokens[3]\n            description = tokens[4]\n            param_id = tokens[5]\n            # ctl impl\n            control_implementation = self._cd_mgr.find_control_implementation(\n                component_title, component_type, source, description\n            )\n            control_implementation.set_parameters = as_list(control_implementation.set_parameters)\n            # add\n            rule_key = synthesize_rule_key(component_title, component_type, rule_id, None, None)\n            values = [self._csv_mgr.get_default_value_by_id(rule_key, param_id)]\n            set_parameter = SetParameter(\n                param_id=param_id,\n                values=values,\n            )\n            _OscalHelper.add_set_parameter(control_implementation.set_parameters, set_parameter)\n\n    def set_params_mod(self, mod_set_params: List[str]) -&gt; None:\n        \"\"\"Set parameters modify.\"\"\"\n        for tokens in mod_set_params:\n            component_title = tokens[0]\n            component_type = tokens[1]\n            rule_id = tokens[2]\n            source = tokens[3]\n            description = tokens[4]\n            param_id = tokens[5]\n            # ctl impl\n            control_implementation = self._cd_mgr.find_control_implementation(\n                component_title, component_type, source, description\n            )\n            if control_implementation:\n                set_parameters = control_implementation.set_parameters\n                for set_parameter in self._set_parameter_generator(set_parameters):\n                    if set_parameter.param_id != param_id:\n                        continue\n                    rule_key = synthesize_rule_key(component_title, component_type, rule_id, None, None)\n                    values = [self._csv_mgr.get_default_value_by_id(rule_key, param_id)]\n                    replacement = SetParameter(\n                        param_id=param_id,\n                        values=values,\n                    )\n                    if set_parameter.values == replacement.values:\n                        continue\n                    logger.debug(f'params-mod: {rule_id} {param_id} {set_parameter.values} -&gt; {replacement.values}')\n                    set_parameter.values = replacement.values\n\n    def _control_mappings_generator(self, control_mappings: List[str]) -&gt; Iterator[List[str]]:\n        \"\"\"Control mappings generator.\"\"\"\n        for tokens in control_mappings:\n            component_title = tokens[0]\n            component_type = tokens[1]\n            source = tokens[3]\n            description = tokens[4]\n            control_implementation = self._cd_mgr.find_control_implementation(\n                component_title, component_type, source, description\n            )\n            if control_implementation:\n                yield tokens\n\n    def control_mappings_del(self, del_control_mappings: List[str]) -&gt; None:\n        \"\"\"Control mappings delete.\"\"\"\n        for tokens in self._control_mappings_generator(del_control_mappings):\n            component_title = tokens[0]\n            component_type = tokens[1]\n            rule_id = tokens[2]\n            source = tokens[3]\n            description = tokens[4]\n            smt_id = tokens[5]\n            # ctl-id\n            control_id = derive_control_id(smt_id)\n            control_implementation = self._cd_mgr.find_control_implementation(\n                component_title, component_type, source, description\n            )\n            implemented_requirements = control_implementation.implemented_requirements\n            control_implementation.implemented_requirements = []\n            for implemented_requirement in self._implemented_requirement_generator(implemented_requirements):\n                if implemented_requirement.control_id == control_id:\n                    implemented_requirement.statements = _OscalHelper.remove_rule_statement(\n                        implemented_requirement.statements, rule_id, smt_id\n                    )\n                    implemented_requirement.props = _OscalHelper.remove_rule(implemented_requirement.props, rule_id)\n                    if len(as_list(implemented_requirement.props)) or len(as_list(implemented_requirement.statements)):\n                        control_implementation.implemented_requirements.append(implemented_requirement)\n                else:\n                    control_implementation.implemented_requirements.append(implemented_requirement)\n\n    def control_mappings_add(self, add_control_mappings: List[str]) -&gt; None:\n        \"\"\"Control mappings add.\"\"\"\n        for tokens in self._control_mappings_generator(add_control_mappings):\n            component_title = tokens[0]\n            component_type = tokens[1]\n            rule_id = tokens[2]\n            source = tokens[3]\n            description = tokens[4]\n            smt_id = tokens[5]\n            # ctl-id\n            control_id = derive_control_id(smt_id)\n            control_implementation = self._cd_mgr.find_control_implementation(\n                component_title, component_type, source, description\n            )\n            implemented_requirement = self._get_implemented_requirement(control_implementation, control_id)\n            # namespace\n            rule_key = synthesize_rule_key(tokens[0], tokens[1], tokens[2], None, None)\n            ns = self._get_namespace(rule_key)\n            # create rule implementation (as property)\n            name = RULE_ID\n            prop = Property(\n                name=name,\n                value=rule_id,\n                ns=ns,\n                class_=self.get_class(name),\n            )\n            if smt_id == control_id:\n                implemented_requirement.props = as_list(implemented_requirement.props)\n                implemented_requirement.props.append(prop)\n            else:\n                statement = self._get_statement(implemented_requirement, smt_id)\n                statement.props.append(prop)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.name","title":"<code>name = 'csv-to-oscal-cd'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task csv-to-oscal-cd.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task csv-to-oscal-cd.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.configure","title":"<code>configure()</code>","text":"<p>Configure.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def configure(self) -&gt; bool:\n    \"\"\"Configure.\"\"\"\n    self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n    # config verbosity\n    self._quiet = self._config.get('quiet', False)\n    self._verbose = not self._quiet\n    # title\n    self._title = self._config.get('title')\n    if self._title is None:\n        logger.warning('config missing \"title\"')\n        return False\n    # version\n    self._version = self._config.get('version')\n    if self._version is None:\n        logger.warning('config missing \"version\"')\n        return False\n    # config csv\n    self._csv_file = self._config.get('csv-file')\n    if self._csv_file is None:\n        logger.warning('config missing \"csv-file\"')\n        return False\n    self._csv_path = pathlib.Path(self._csv_file)\n    if not self._csv_path.exists():\n        logger.warning('\"csv-file\" not found')\n        return False\n    # announce csv\n    if self._verbose:\n        logger.info(f'input: {self._csv_file}')\n    # config cd\n    self._cd_path = None\n    self._cd_file = self._config.get('component-definition')\n    if self._cd_file is not None:\n        self._cd_path = pathlib.Path(self._cd_file)\n        if not self._cd_path.exists():\n            logger.warning('\"component-definition\" not found')\n            return False\n    # workspace\n    self._workspace = os.getcwd()\n    # validate_controls\n    self._validate_controls = self._config.get('validate-controls', 'off')\n    return True\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_add","title":"<code>control_mappings_add(add_control_mappings)</code>","text":"<p>Control mappings add.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def control_mappings_add(self, add_control_mappings: List[str]) -&gt; None:\n    \"\"\"Control mappings add.\"\"\"\n    for tokens in self._control_mappings_generator(add_control_mappings):\n        component_title = tokens[0]\n        component_type = tokens[1]\n        rule_id = tokens[2]\n        source = tokens[3]\n        description = tokens[4]\n        smt_id = tokens[5]\n        # ctl-id\n        control_id = derive_control_id(smt_id)\n        control_implementation = self._cd_mgr.find_control_implementation(\n            component_title, component_type, source, description\n        )\n        implemented_requirement = self._get_implemented_requirement(control_implementation, control_id)\n        # namespace\n        rule_key = synthesize_rule_key(tokens[0], tokens[1], tokens[2], None, None)\n        ns = self._get_namespace(rule_key)\n        # create rule implementation (as property)\n        name = RULE_ID\n        prop = Property(\n            name=name,\n            value=rule_id,\n            ns=ns,\n            class_=self.get_class(name),\n        )\n        if smt_id == control_id:\n            implemented_requirement.props = as_list(implemented_requirement.props)\n            implemented_requirement.props.append(prop)\n        else:\n            statement = self._get_statement(implemented_requirement, smt_id)\n            statement.props.append(prop)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.control_mappings_del","title":"<code>control_mappings_del(del_control_mappings)</code>","text":"<p>Control mappings delete.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def control_mappings_del(self, del_control_mappings: List[str]) -&gt; None:\n    \"\"\"Control mappings delete.\"\"\"\n    for tokens in self._control_mappings_generator(del_control_mappings):\n        component_title = tokens[0]\n        component_type = tokens[1]\n        rule_id = tokens[2]\n        source = tokens[3]\n        description = tokens[4]\n        smt_id = tokens[5]\n        # ctl-id\n        control_id = derive_control_id(smt_id)\n        control_implementation = self._cd_mgr.find_control_implementation(\n            component_title, component_type, source, description\n        )\n        implemented_requirements = control_implementation.implemented_requirements\n        control_implementation.implemented_requirements = []\n        for implemented_requirement in self._implemented_requirement_generator(implemented_requirements):\n            if implemented_requirement.control_id == control_id:\n                implemented_requirement.statements = _OscalHelper.remove_rule_statement(\n                    implemented_requirement.statements, rule_id, smt_id\n                )\n                implemented_requirement.props = _OscalHelper.remove_rule(implemented_requirement.props, rule_id)\n                if len(as_list(implemented_requirement.props)) or len(as_list(implemented_requirement.statements)):\n                    control_implementation.implemented_requirements.append(implemented_requirement)\n            else:\n                control_implementation.implemented_requirements.append(implemented_requirement)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.execute","title":"<code>execute()</code>","text":"<p>Provide an executed outcome.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an executed outcome.\"\"\"\n    try:\n        return self._execute()\n    except Exception:\n        logger.error(traceback.format_exc())\n        return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.get_class","title":"<code>get_class(name)</code>","text":"<p>Get class value for specified name from config.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def get_class(self, name: str) -&gt; str:\n    \"\"\"Get class value for specified name from config.\"\"\"\n    key = f'class.{name}'\n    return self._config.get(key)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    name = self.name\n    oscal_name = 'component_definition'\n    # help note identifiers\n    note01 = '1'\n    note02 = '2'\n    note03 = '3'\n    note04 = '4'\n    note05 = '5'\n    # help generation\n    logger.info(f'Help information for {name} task.')\n    logger.info('')\n    logger.info(f'Purpose: From csv produce OSCAL {oscal_name} file.')\n    logger.info('')\n    logger.info('')\n    logger.info(f'Configuration flags sit under [task.{name}]:')\n    text1 = '  title                = '\n    text2 = '(required) the component definition title.'\n    logger.info(text1 + text2)\n    text1 = '  version              = '\n    text2 = '(required) the component definition version.'\n    logger.info(text1 + text2)\n    text1 = '  csv-file             = '\n    text2 = '(required) the path of the csv file.'\n    text3 = ' [1st row are column headings; 2nd row are column descriptions; 3rd row and beyond is data]'\n    logger.info(text1 + text2 + text3)\n    text1 = '  required columns:      '\n    for text2 in CsvColumn.get_required_column_names():\n        if text2 in [f'{RULE_DESCRIPTION}', f'{PROFILE_SOURCE}', f'{PROFILE_DESCRIPTION}', f'{CONTROL_ID_LIST}']:\n            text2 += f' (see note {note01})'\n        logger.info(text1 + '$$' + text2)\n        text1 = '                         '\n    text1 = '  optional columns:      '\n    for text2 in CsvColumn.get_optional_column_names():\n        if text2 in [f'{ORIGINAL_RISK_RATING}', f'{ADJUSTED_RISK_RATING}', f'{RISK_ADJUSTMENT}']:\n            text2 += f' (see note {note01})'\n        elif text2 in [f'{TARGET_COMPONENT}']:\n            text2 += f' (see note {note03})'\n        else:\n            text2 += f' (see note {note02})'\n        logger.info(text1 + '$' + text2)\n        text1 = '                         '\n    for text2 in CsvColumn.get_parameter_column_names():\n        text2 += f' (see notes {note01}, {note05})'\n        logger.info(text1 + '$' + text2)\n        text1 = '                         '\n    text1 = '  comment columns:       '\n    text2 = f'Informational (see note {note04})'\n    logger.info(text1 + '#' + text2)\n    text1 = '  output-dir           = '\n    text2 = '(required) the path of the output directory for synthesized OSCAL .json files.'\n    logger.info(text1 + text2)\n    text1 = '  component-definition = '\n    text2 = '(optional) the path of the existing component-definition OSCAL .json file.'\n    logger.info(text1 + text2)\n    text1 = '  class.column-name    = '\n    text2 = f'(optional) the class to associate with the specified column name, e.g. class.{RULE_ID} = scc_class'\n    logger.info(text1 + text2)\n    text1 = '  output-overwrite     = '\n    text2 = '(optional) true [default] or false; replace existing output when true.'\n    logger.info(text1 + text2)\n    text1 = '  validate-controls    = '\n    text2 = '(optional) on, warn, or off [default]; validate controls exist in resolved profile.'\n    logger.info(text1 + text2)\n    # Notes\n    text1 = ''\n    text2 = ''\n    logger.info(text1 + text2)\n    text1 = 'Notes: '\n    text2 = f'[{note01}] column is ignored for validation component type'\n    logger.info(text1 + text2)\n    text1 = '       '\n    text2 = f'[{note02}] column is required for validation component type'\n    logger.info(text1 + text2)\n    text1 = '       '\n    text2 = f'[{note03}] column is optional for validation component type'\n    text3 = f', but may be needed to prevent {RULE_ID} collisions'\n    logger.info(text1 + text2 + text3)\n    text1 = '       '\n    text2 = f'[{note04}] column name starting with # causes column to be ignored'\n    logger.info(text1 + text2)\n    text1 = '       '\n    text2 = f'[{note05}] additional parameters are specified by adding a common suffix per set'\n    text3 = f', for example: {PARAMETER_ID}_1, {PARAMETER_DESCRIPTION}_1, ...{PARAMETER_ID}_2...'\n    logger.info(text1 + text2 + text3)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_add","title":"<code>rules_add(add_rules)</code>","text":"<p>Add rules.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def rules_add(self, add_rules: List[str]) -&gt; None:\n    \"\"\"Add rules.\"\"\"\n    for rule_key in add_rules:\n        component_title = self._csv_mgr.get_value(rule_key, COMPONENT_TITLE)\n        component_type = self._csv_mgr.get_value(rule_key, COMPONENT_TYPE)\n        component_description = self._csv_mgr.get_value(rule_key, COMPONENT_DESCRIPTION)\n        # component\n        component = self._cd_mgr.get_component(component_title, component_type, component_description)\n        # props\n        component.props = as_list(component.props)\n        component.props = component.props + self._create_rule_props(rule_key)\n        # additional props, when not validation component\n        if not self._is_validation(rule_key):\n            # control implementation\n            source = self._csv_mgr.get_value(rule_key, PROFILE_SOURCE)\n            description = self._csv_mgr.get_value(rule_key, PROFILE_DESCRIPTION)\n            control_implementation = self._get_control_implementation(component, source, description)\n            # set-parameters\n            set_parameters = self._create_set_parameters(rule_key)\n            if set_parameters:\n                control_implementation.set_parameters = as_list(control_implementation.set_parameters)\n                _OscalHelper.add_set_parameters(control_implementation.set_parameters, set_parameters)\n            # control-mappings\n            control_mappings = self._csv_mgr.get_value(rule_key, CONTROL_ID_LIST).split()\n            self._add_rule_prop(control_implementation, control_mappings, rule_key)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_del","title":"<code>rules_del(del_rules)</code>","text":"<p>Delete rules.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def rules_del(self, del_rules: List[str]) -&gt; None:\n    \"\"\"Delete rules.\"\"\"\n    for tokens in del_rules:\n        component_title = tokens[0]\n        component_type = tokens[1]\n        rule_id = tokens[2]\n        description = ''\n        # component\n        component = self._cd_mgr.get_component(component_title, component_type, description)\n        # props\n        component.props = self._delete_rule_props(component, rule_id)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.rules_mod","title":"<code>rules_mod(mod_rules)</code>","text":"<p>Modify rules.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def rules_mod(self, mod_rules: List[str]) -&gt; None:\n    \"\"\"Modify rules.\"\"\"\n    for rule_key in mod_rules:\n        component_title = self._csv_mgr.get_value(rule_key, COMPONENT_TITLE)\n        component_type = self._csv_mgr.get_value(rule_key, COMPONENT_TYPE)\n        component_description = self._csv_mgr.get_value(rule_key, COMPONENT_DESCRIPTION)\n        # component\n        component = self._cd_mgr.get_component(component_title, component_type, component_description)\n        # props\n        component.props = self._modify_rule_props(component, rule_key)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_add","title":"<code>set_params_add(add_set_params)</code>","text":"<p>Set parameters add.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def set_params_add(self, add_set_params: List[str]) -&gt; None:\n    \"\"\"Set parameters add.\"\"\"\n    for tokens in add_set_params:\n        component_title = tokens[0]\n        component_type = tokens[1]\n        rule_id = tokens[2]\n        source = tokens[3]\n        description = tokens[4]\n        param_id = tokens[5]\n        # ctl impl\n        control_implementation = self._cd_mgr.find_control_implementation(\n            component_title, component_type, source, description\n        )\n        control_implementation.set_parameters = as_list(control_implementation.set_parameters)\n        # add\n        rule_key = synthesize_rule_key(component_title, component_type, rule_id, None, None)\n        values = [self._csv_mgr.get_default_value_by_id(rule_key, param_id)]\n        set_parameter = SetParameter(\n            param_id=param_id,\n            values=values,\n        )\n        _OscalHelper.add_set_parameter(control_implementation.set_parameters, set_parameter)\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_del","title":"<code>set_params_del(del_set_params)</code>","text":"<p>Set parameters delete.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def set_params_del(self, del_set_params: List[str]) -&gt; None:\n    \"\"\"Set parameters delete.\"\"\"\n    for tokens in del_set_params:\n        component_title = tokens[0]\n        component_type = tokens[1]\n        source = tokens[3]\n        description = tokens[4]\n        param_id = tokens[5]\n        # ctl impl\n        control_implementation = self._cd_mgr.find_control_implementation(\n            component_title, component_type, source, description\n        )\n        if control_implementation:\n            set_parameters = control_implementation.set_parameters\n            control_implementation.set_parameters = []\n            for set_parameter in self._set_parameter_generator(set_parameters):\n                if set_parameter.param_id == param_id:\n                    continue\n                _OscalHelper.add_set_parameter(control_implementation.set_parameters, set_parameter)\n            if control_implementation.set_parameters == []:\n                control_implementation.set_parameters = None\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.set_params_mod","title":"<code>set_params_mod(mod_set_params)</code>","text":"<p>Set parameters modify.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def set_params_mod(self, mod_set_params: List[str]) -&gt; None:\n    \"\"\"Set parameters modify.\"\"\"\n    for tokens in mod_set_params:\n        component_title = tokens[0]\n        component_type = tokens[1]\n        rule_id = tokens[2]\n        source = tokens[3]\n        description = tokens[4]\n        param_id = tokens[5]\n        # ctl impl\n        control_implementation = self._cd_mgr.find_control_implementation(\n            component_title, component_type, source, description\n        )\n        if control_implementation:\n            set_parameters = control_implementation.set_parameters\n            for set_parameter in self._set_parameter_generator(set_parameters):\n                if set_parameter.param_id != param_id:\n                    continue\n                rule_key = synthesize_rule_key(component_title, component_type, rule_id, None, None)\n                values = [self._csv_mgr.get_default_value_by_id(rule_key, param_id)]\n                replacement = SetParameter(\n                    param_id=param_id,\n                    values=values,\n                )\n                if set_parameter.values == replacement.values:\n                    continue\n                logger.debug(f'params-mod: {rule_id} {param_id} {set_parameter.values} -&gt; {replacement.values}')\n                set_parameter.values = replacement.values\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.CsvToOscalComponentDefinition.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    return TaskOutcome('simulated-success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.derive_control_id","title":"<code>derive_control_id(control_mapping)</code>","text":"<p>Derive control id.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def derive_control_id(control_mapping: str) -&gt; str:\n    \"\"\"Derive control id.\"\"\"\n    rval = control_mapping.split('_smt')[0]\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.derive_part_id","title":"<code>derive_part_id(control_mapping)</code>","text":"<p>Derive part id.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def derive_part_id(control_mapping: str) -&gt; str:\n    \"\"\"Derive part id.\"\"\"\n    if '_smt.' in control_mapping:\n        rval = control_mapping\n    else:\n        rval = None\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.etype","title":"<code>etype(target)</code>","text":"<p>Get etype.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def etype(target: str) -&gt; str:\n    \"\"\"Get etype.\"\"\"\n    if target:\n        return 'invalid'\n    else:\n        return 'missing'\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.is_validation","title":"<code>is_validation(component_type)</code>","text":"<p>Check for validation component.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def is_validation(component_type: str) -&gt; bool:\n    \"\"\"Check for validation component.\"\"\"\n    return component_type.lower().strip() == validation\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.row_property_builder","title":"<code>row_property_builder(row, name, value, ns, class_, remarks)</code>","text":"<p>Row property builder.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def row_property_builder(row: int, name: str, value, ns: str, class_: str, remarks: str) -&gt; Property:\n    \"\"\"Row property builder.\"\"\"\n    # name\n    try:\n        Property(\n            name=name,\n            value='value',\n        )\n    except Exception:\n        text = f'property for row: {row} name: {name} is {etype(name)}'\n        raise RuntimeError(text)\n    # value\n    try:\n        Property(\n            name=name,\n            value=value,\n        )\n    except Exception:\n        text = f'property for row: {row} value: {value} is {etype(value)}'\n        raise RuntimeError(text)\n    # ns\n    try:\n        Property(\n            name=name,\n            value=value,\n            ns=ns,\n        )\n    except Exception:\n        text = f'property for row: {row} ns: {ns} is {etype(ns)}'\n        raise RuntimeError(text)\n    # class\n    try:\n        Property(\n            name=name,\n            value=value,\n            class_=class_,\n        )\n    except Exception:\n        text = f'property for row: {row} class: {class_} is {etype(class_)}'\n        raise RuntimeError(text)\n    # prop\n    prop = Property(\n        name=name,\n        value=value,\n        ns=ns,\n        class_=class_,\n        remarks=remarks,\n    )\n    return prop\n</code></pre>"},{"location":"reference/API/trestle/tasks/csv_to_oscal_cd/#trestle.tasks.csv_to_oscal_cd.synthesize_rule_key","title":"<code>synthesize_rule_key(component_title, component_type, rule_id, check_id, target_component)</code>","text":"<p>Synthesize rule_key.</p> Source code in <code>trestle/tasks/csv_to_oscal_cd.py</code> <pre><code>def synthesize_rule_key(\n    component_title: str,\n    component_type: str,\n    rule_id: str,\n    check_id: Union[str, None],\n    target_component: Union[str, None]\n) -&gt; tuple:\n    \"\"\"Synthesize rule_key.\"\"\"\n    if is_validation(component_type):\n        rval = (component_title, component_type, rule_id, check_id, target_component)\n    else:\n        rval = (component_title, component_type, rule_id, None, None)\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/","title":"trestle.tasks.ocp4_cis_profile_to_oscal_catalog","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog","title":"<code>trestle.tasks.ocp4_cis_profile_to_oscal_catalog</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node","title":"<code>Node</code>","text":"<p>               Bases: <code>BaseModel</code></p> <p>Representation of CIS profile entry.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code> <pre><code>class Node(BaseModel):\n    \"\"\"Representation of CIS profile entry.\"\"\"\n\n    name: Optional[str] = Field(None)\n    description: Optional[str] = Field(None)\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.description","title":"<code>description: Optional[str] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Node.name","title":"<code>name: Optional[str] = Field(None)</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog","title":"<code>Ocp4CisProfileToOscalCatalog</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to transform OCP4 CIS profile to OSCAL catalog.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code> <pre><code>class Ocp4CisProfileToOscalCatalog(TaskBase):\n    \"\"\"\n    Task to transform OCP4 CIS profile to OSCAL catalog.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'ocp4-cis-profile-to-oscal-catalog'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task ocp4-cis-profile-to-oscal-catalog.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n        self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        logger.info(f'Help information for {self.name} task.')\n        logger.info('')\n        logger.info('Purpose: Create catalog from standard (e.g. CIS benchmark).')\n        logger.info('')\n        logger.info('Configuration flags sit under [task.ocp4-cis-profile-to-oscal-catalog]:')\n        text1 = '  input-dir              = '\n        text2 = '(required) location to read the compliance-as-code profile files.'\n        logger.info(text1 + text2)\n        text1 = '  output-dir             = '\n        text2 = '(required) location to write the generated catalog.json file.'\n        logger.info(text1 + text2)\n        text1 = '  output-overwrite       = '\n        text2 = '(optional) true [default] or false; replace existing output when true.'\n        logger.info(text1 + text2)\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        return TaskOutcome('simulated-success')\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an actual outcome.\"\"\"\n        try:\n            return self._execute()\n        except Exception:\n            logger.info(traceback.format_exc())\n            return TaskOutcome('failure')\n\n    def _execute(self) -&gt; TaskOutcome:\n        \"\"\"Wrap the execute for exception handling.\"\"\"\n        if not self._config:\n            logger.warning('config missing')\n            return TaskOutcome('failure')\n        try:\n            idir = self._config['input-dir']\n            odir = self._config['output-dir']\n        except KeyError as e:\n            logger.info(f'key {e.args[0]} missing')\n            return TaskOutcome('failure')\n        # verbosity\n        quiet = self._config.get('quiet', False)\n        verbose = not quiet\n        # output\n        overwrite = self._config.getboolean('output-overwrite', True)\n        opth = pathlib.Path(odir)\n        # insure output dir exists\n        opth.mkdir(exist_ok=True, parents=True)\n        # calculate output file name &amp; check writability\n        oname = 'catalog.json'\n        ofile = opth / oname\n        if not overwrite and pathlib.Path(ofile).exists():\n            logger.warning(f'output: {ofile} already exists')\n            return TaskOutcome('failure')\n        # metadata links (optional)\n        metadata_links = self._config.get('metadata-links')\n        # get list or &lt;name&gt;.profile files\n        filelist = self._get_filelist(idir)\n        if len(filelist) &lt; 1:\n            logger.warning(f'input: {idir} no .profile file found')\n            return TaskOutcome('failure')\n        # initialize node list\n        self._node_map = {}\n        # process files\n        for fp in filelist:\n            lines = self._get_content(fp)\n            self._parse(lines)\n        # get root nodes\n        root_nodes = self._get_root_nodes()\n        # groups and controls\n        root = Group(title='root', groups=[])\n        for node in root_nodes:\n            group = Group(title=f'{node.name} {node.description}')\n            root.groups.append(group)\n            depth = self._depth(node.name)\n            if depth == 3:\n                self._add_groups(group, node.name, depth)\n            if depth == 2:\n                self._add_controls(group, node.name, depth)\n        # metadata\n        metadata = Metadata(\n            title=self._title, last_modified=self._timestamp, oscal_version=OSCAL_VERSION, version=trestle.__version__\n        )\n        # metadata links\n        if metadata_links is not None:\n            metadata.links = []\n            for item in metadata_links.split():\n                link = Link(href=item)\n                metadata.links.append(link)\n        # catalog\n        catalog = Catalog(uuid=_uuid(), metadata=metadata, groups=root.groups)\n        # write OSCAL ComponentDefinition to file\n        if verbose:\n            logger.info(f'output: {ofile}')\n        catalog.oscal_write(pathlib.Path(ofile))\n        return TaskOutcome('success')\n\n    def _get_filelist(self, idir: str) -&gt; List[pathlib.Path]:\n        \"\"\"Get filelist.\"\"\"\n        return [x for x in pathlib.Path(idir).iterdir() if x.is_file() and x.suffix == '.profile']\n\n    def _get_content(self, fp: pathlib.Path) -&gt; List[str]:\n        \"\"\"Fetch content from file.\"\"\"\n        content = None\n        try:\n            f = fp.open('r', encoding=const.FILE_ENCODING)\n            content = f.readlines()\n            f.close()\n            return content\n        except Exception as e:\n            logger.warning(f'unable to process {fp.name}')\n            raise e\n\n    def _parse(self, lines: List[str]) -&gt; None:\n        \"\"\"Parse lines to build data structure.\"\"\"\n        for line in lines:\n            line = line.strip()\n            if line.startswith('title: ') and \"'\" in line:\n                self._title = line.split(\"'\")[1]\n                continue\n            line_parts = line.split(None, 2)\n            # must be 3 parts exactly\n            if len(line_parts) &lt; 3:\n                continue\n            # normalized name and description\n            name = line_parts[1].rstrip('.')\n            description = line_parts[2]\n            # name must be numbers and decimal points\n            if not set(name) &lt;= set('0123456789.'):\n                continue\n            # derive desired sortable key from name\n            key = self._get_key(name)\n            self._node_map[key] = Node(name=name, description=description)\n\n    def _get_key(self, name: str) -&gt; Tuple[int, int, int]:\n        \"\"\"Convert name to desired sortable key.\"\"\"\n        parts = name.split('.')\n        if len(parts) == 1:\n            key = (int(parts[0]), 0, 0)\n        elif len(parts) == 2:\n            key = (int(parts[0]), int(parts[1]), 0)\n        elif len(parts) == 3:\n            key = (int(parts[0]), int(parts[1]), int(parts[2]))\n        else:\n            text = f'Unexpected value: {name}'\n            raise RuntimeError(text)\n        return key\n\n    def _get_root_nodes(self) -&gt; ValuesView[Node]:\n        \"\"\"Get root nodes.\"\"\"\n        root_nodes = {}\n        for node in self._node_map.values():\n            if len(node.name) == 1:\n                root_nodes[node.name] = node\n        return root_nodes.values()\n\n    def _depth(self, prefix: str) -&gt; int:\n        \"\"\"Get maximum depth for prefix.\"\"\"\n        depth = 0\n        for node in self._node_map.values():\n            name = node.name\n            if not name.startswith(prefix):\n                continue\n            dots = name.split('.')\n            if len(dots) &lt;= depth:\n                continue\n            depth = len(dots)\n        return depth\n\n    def _add_controls(self, group: Group, prefix: str, depth: int):\n        \"\"\"Add controls to group.\"\"\"\n        controls = []\n        for key in sorted(self._node_map.keys()):\n            node = self._node_map[key]\n            name = node.name\n            if name.startswith(prefix):\n                dots = name.split('.')\n                if len(dots) == depth:\n                    id_ = f'CIS-{node.name}'\n                    title = f'{node.name} {node.description}'\n                    control = Control(id=id_, title=title)\n                    controls.append(control)\n        if len(controls) &gt; 0:\n            group.controls = controls\n\n    def _add_groups(self, group: Group, prefix: str, depth: int):\n        \"\"\"Add sub-groups to group.\"\"\"\n        groups = []\n        for key in sorted(self._node_map.keys()):\n            node = self._node_map[key]\n            name = node.name\n            if not name.startswith(prefix):\n                continue\n            if name == prefix:\n                continue\n            dots = name.split('.')\n            if len(dots) != depth - 1:\n                continue\n            title = f'{node.name} {node.description}'\n            sub_group = Group(title=title)\n            groups.append(sub_group)\n            sub_prefix = node.name\n            self._add_controls(sub_group, sub_prefix, depth)\n        if len(groups) &gt; 0:\n            group.groups = groups\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.name","title":"<code>name = 'ocp4-cis-profile-to-oscal-catalog'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task ocp4-cis-profile-to-oscal-catalog.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task ocp4-cis-profile-to-oscal-catalog.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n    self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.execute","title":"<code>execute()</code>","text":"<p>Provide an actual outcome.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an actual outcome.\"\"\"\n    try:\n        return self._execute()\n    except Exception:\n        logger.info(traceback.format_exc())\n        return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    logger.info(f'Help information for {self.name} task.')\n    logger.info('')\n    logger.info('Purpose: Create catalog from standard (e.g. CIS benchmark).')\n    logger.info('')\n    logger.info('Configuration flags sit under [task.ocp4-cis-profile-to-oscal-catalog]:')\n    text1 = '  input-dir              = '\n    text2 = '(required) location to read the compliance-as-code profile files.'\n    logger.info(text1 + text2)\n    text1 = '  output-dir             = '\n    text2 = '(required) location to write the generated catalog.json file.'\n    logger.info(text1 + text2)\n    text1 = '  output-overwrite       = '\n    text2 = '(optional) true [default] or false; replace existing output when true.'\n    logger.info(text1 + text2)\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/#trestle.tasks.ocp4_cis_profile_to_oscal_catalog.Ocp4CisProfileToOscalCatalog.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_catalog.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    return TaskOutcome('simulated-success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/","title":"trestle.tasks.ocp4_cis_profile_to_oscal_cd","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd","title":"<code>trestle.tasks.ocp4_cis_profile_to_oscal_cd</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD","title":"<code>Ocp4CisProfileToOscalCD</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to transform OCP4 CIS profile to OSCAL component-definition.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code> <pre><code>class Ocp4CisProfileToOscalCD(TaskBase):\n    \"\"\"\n    Task to transform OCP4 CIS profile to OSCAL component-definition.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'ocp4-cis-profile-to-oscal-cd'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task ocp4-cis-profile-to-oscal-cd.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n        self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n\n    def set_timestamp(self, timestamp: str) -&gt; None:\n        \"\"\"Set the timestamp.\"\"\"\n        self._timestamp = timestamp\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        logger.info(f'Help information for {self.name} task.')\n        logger.info('')\n        logger.info('Purpose: Create component definition from standard (e.g. CIS benchmark).')\n        logger.info('')\n        logger.info('Configuration flags sit under [task.ocp4-cis-profile-to-oscal-cd]:')\n        text1 = '  component-name         = '\n        text2 = 'component name, e.g. OSCO.'\n        logger.info(text1 + text2)\n        text1 = '  org-name               = '\n        text2 = 'organization name, e.g. International Business Machines.'\n        logger.info(text1 + text2)\n        text1 = '  org-remarks            = '\n        text2 = 'organization remarks, e.g. IBM.'\n        logger.info(text1 + text2)\n        text1 = '  folder-cac             = '\n        text2 = 'folder containing compliance-as-code artifacts, e.g adjunct-data/cis-benchmarks/content.'\n        logger.info(text1 + text2)\n        text1 = '  output-dir             = '\n        text2 = 'location to write the generated component-definition.json file.'\n        logger.info(text1 + text2)\n        #\n        text1 = '  profile-name           = '\n        text2 = 'profile name, e.g. OCP4 CIS-benchmark v4.'\n        logger.info(text1 + text2)\n        text1 = '  profile-mnemonic       = '\n        text2 = 'profile mnemonic, e.g. ocp4-cis-node.'\n        logger.info(text1 + text2)\n        text1 = '  profile-ns             = '\n        text2 = 'profile ns, e.g. https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud.'\n        logger.info(text1 + text2)\n        text1 = '  profile-version        = '\n        text2 = 'profile version, e.g. 1.1.'\n        logger.info(text1 + text2)\n        text1 = '  profile-check-version  = '\n        text2 = 'profile check version, e.g. 0.1.58.'\n        logger.info(text1 + text2)\n        #\n        text1 = '  profile-type           = '\n        text2 = 'profile type, e.g. OCP4.'\n        logger.info(text1 + text2)\n        text1 = '  profile-list           = '\n        text2 = 'profile list is blank separated list of \"&lt;suffix&gt;\" for config entries: '\n        logger.info(text1 + text2)\n        text1 = '                           profile-file.&lt;suffix&gt;, profile-title.&lt;suffix&gt;, profile-url.&lt;suffix&gt;'\n        text2 = ', e.g. cis cis-node.'\n        logger.info(text1 + text2)\n        text1 = '  profile-file.&lt;suffix&gt;  = '\n        text2 = 'path of the profile file to ingest'\n        text3 = ', e.g. ${folder-cac}/products/ocp4/profiles/cis-node.profile.'  # noqa\n        logger.info(text1 + text2 + text3)\n        text1 = '  profile-title.&lt;suffix&gt; = '\n        text2 = 'title of the profile'\n        text3 = ', e.g. CIS Red Hat OpenShift Container Platform 4 Benchmark.'\n        logger.info(text1 + text2 + text3)\n        text1 = '  profile-url.&lt;suffix&gt;   = '\n        text2 = 'URL of the profile'\n        text3 = ', e.g. https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile.'\n        logger.info(text1 + text2 + text3)\n        text1 = '  rule-to-parameters-map = '\n        text2 = 'map file for set-parameters, e.g. '\n        text3 = 'adjunct-data/task-files/rule2var.json.'\n        logger.info(text1 + text2 + text3)\n        text1 = '  selected-rules         = '\n        text2 = 'file with list of selected rules, e.g. '\n        text3 = 'adjunct-data/task-files/selected_rules.json.'\n        logger.info(text1 + text2 + text3)\n        text1 = '  enabled-rules          = '\n        text2 = 'file with list of enabled rules, e.g. '\n        text3 = 'adjunct-data/task-files/enabled_rules.json.'\n        logger.info(text1 + text2 + text3)\n        #\n        text = ''\n        logger.info(text)\n        text = 'Notes:'\n        logger.info(text)\n        text = '1. If a control has selected rules but no enabled rules, then all those selected are included.'\n        logger.info(text)\n        text = '2. If a control has selected and enabled rules, then only those enabled are included.'\n        logger.info(text)\n        text = '3. If a control has no selected rules, then none are included regardless of enabled.'\n        logger.info(text)\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        return TaskOutcome('simulated-success')\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an actual outcome.\"\"\"\n        try:\n            return self._execute()\n        except Exception:\n            logger.info(traceback.format_exc())\n            return TaskOutcome('failure')\n\n    def _execute(self) -&gt; TaskOutcome:\n        if not self._config:\n            logger.warning('config missing')\n            return TaskOutcome('failure')\n        try:\n            component_name = self._config['component-name']\n            org_name = self._config['org-name']\n            org_remarks = self._config['org-remarks']\n            self._folder_cac = self._config['folder-cac']\n            profile_check_version = self._config['profile-check-version']\n            profile_type = self._config['profile-type']\n            profile_mnemonic = self._config['profile-mnemonic']\n            profile_name = self._config['profile-name']\n            profile_ns = self._config['profile-ns']\n            profile_version = self._config['profile-version']\n            profile_sets = {}\n            profile_list = self._config['profile-list'].split()\n            for profile in profile_list:\n                profile_sets[profile] = {}\n                profile_sets[profile]['profile-file'] = self._config[f'profile-file.{profile}']\n                profile_sets[profile]['profile-url'] = self._config[f'profile-url.{profile}']\n                profile_sets[profile]['profile-title'] = self._config[f'profile-title.{profile}']\n                profile_sets[profile]['profile-ns'] = profile_ns\n                profile_sets[profile]['component-name'] = component_name\n            odir = self._config['output-dir']\n        except KeyError as e:\n            logger.info(f'key {e.args[0]} missing')\n            return TaskOutcome('failure')\n        # selected rules\n        self._selected_rules = self._get_filter_rules('selected-rules', 'selected')\n        # enabled rules\n        self._enabled_rules = self._get_filter_rules('enabled-rules', 'enabled')\n        # verbosity\n        quiet = self._config.get('quiet', False)\n        verbose = not quiet\n        # output\n        overwrite = self._config.getboolean('output-overwrite', True)\n        opth = pathlib.Path(odir)\n        # insure output dir exists\n        opth.mkdir(exist_ok=True, parents=True)\n        # calculate output file name &amp; check writability\n        oname = 'component-definition.json'\n        ofile = opth / oname\n        if not overwrite and pathlib.Path(ofile).exists():\n            logger.warning(f'output: {ofile} already exists')\n            return TaskOutcome('failure')\n        # fetch rule to parameters map\n        self._rule_to_parm_map = self._get_parameters_map('rule-to-parameters-map')\n        # roles, responsible_roles, parties, responsible parties\n        party_uuid_01 = str(uuid.uuid4())\n        party_uuid_02 = str(uuid.uuid4())\n        party_uuid_03 = str(uuid.uuid4())\n        roles = self._build_roles()\n        responsible_roles = self._build_responsible_roles(party_uuid_01, party_uuid_02, party_uuid_03)\n        parties = self._build_parties(org_name, org_remarks, party_uuid_01, party_uuid_02, party_uuid_03)\n        responsible_parties = self._build_responsible_parties(party_uuid_01, party_uuid_02, party_uuid_03)\n        # metadata\n        metadata = Metadata(\n            title=f'Component definition for {profile_type} profiles',\n            last_modified=self._timestamp,\n            oscal_version=OSCAL_VERSION,\n            version=trestle.__version__,\n            roles=roles,\n            parties=parties,\n            responsible_parties=responsible_parties\n        )\n        # defined component\n        component_title = component_name\n        component_description = component_name\n        defined_component = DefinedComponent(\n            uuid=str(uuid.uuid4()),\n            description=component_description,\n            title=component_title,\n            type='Service',\n        )\n        # add control implementation per profile\n        prop1 = Property(\n            name='profile_name',\n            value=profile_name,\n            class_='scc_profile_name',\n            ns=profile_ns,\n        )\n        prop2 = Property(\n            name='profile_mnemonic',\n            value=profile_mnemonic,\n            class_='scc_profile_mnemonic',\n            ns=profile_ns,\n        )\n        prop3 = Property(\n            name='profile_version',\n            value=profile_version,\n            class_='scc_profile_version',\n            ns=profile_ns,\n        )\n        prop4 = Property(\n            name='profile_check_version',\n            value=profile_check_version,\n        )\n        props = [prop1, prop2, prop3, prop4]\n        for profile in profile_list:\n            profile_set = profile_sets[profile]\n            control_implementation = self._build_control_implementation(profile_set, responsible_roles, props)\n            if control_implementation is not None:\n                if defined_component.control_implementations is None:\n                    defined_component.control_implementations = [control_implementation]\n                else:\n                    defined_component.control_implementations.append(control_implementation)\n        # defined components\n        defined_components = [defined_component]\n        # component definition\n        component_definition = ComponentDefinition(\n            uuid=str(uuid.uuid4()),\n            metadata=metadata,\n            components=defined_components,\n        )\n        # write OSCAL ComponentDefinition to file\n        if verbose:\n            logger.info(f'output: {ofile}')\n        component_definition.oscal_write(pathlib.Path(ofile))\n        return TaskOutcome('success')\n\n    def _get_set_parameter(self, rule: str) -&gt; SetParameter:\n        \"\"\"Get set parameter.\"\"\"\n        set_parameter = None\n        for key in self._rule_to_parm_map.keys():\n            logger.debug(f'{key} {rule}')\n            if key == rule:\n                value = self._rule_to_parm_map[key]\n                remarks = value['description']\n                options = value['options']\n                default_value = options['default']\n                logger.debug(f'key: {key} options: {options}')\n                set_parameter = SetParameter(\n                    param_id=rule,\n                    values=[f'{default_value}'],\n                    remarks=remarks,\n                )\n        return set_parameter\n\n    def _get_controls(self, rules: Dict[str, Tuple[str, str, str]]) -&gt; Dict[str, List[str]]:\n        \"\"\"Get controls.\"\"\"\n        controls = {}\n        for rule in rules.keys():\n            control = rules[rule][1]\n            if control not in controls.keys():\n                controls[control] = [rule]\n            else:\n                controls[control] = controls[control] + [rule]\n        # trim rules associated with control with respect to enabled rules\n        for control in controls:\n            controls[control] = self._get_trimmed_rules(control, controls[control])\n            logger.debug(f'{control} {controls[control]}')\n        return controls\n\n    # determine if trim is needed for the control, and if so then\n    # for the associated set of rules drop those that are not enabled\n    def _get_trimmed_rules(self, control: str, rules_for_control: List[str]) -&gt; List[str]:\n        \"\"\"Trim rules if any rule for control appears in enabled rules list.\"\"\"\n        retval = rules_for_control\n        if self._is_trim_needed(rules_for_control):\n            retval = []\n            for rule in rules_for_control:\n                if rule in self._enabled_rules:\n                    retval = retval + [rule]\n                    logger.debug(f'keep {control} {rule}')\n                else:\n                    logger.debug(f'drop {control} {rule}')\n        return retval\n\n    # if any rule in the set of rules for the control appears in the enabled list,\n    # then trim is needed\n    def _is_trim_needed(self, rules_for_control: List[str]) -&gt; bool:\n        \"\"\"Check if trim is needed.\"\"\"\n        retval = False\n        for rule in rules_for_control:\n            if rule in self._enabled_rules:\n                retval = True\n                break\n        return retval\n\n    # fetch the set of rules that will be included/excluded from the CIS rules\n    def _get_parameters_map(self, config_key: str) -&gt; List[str]:\n        \"\"\"Get parameters map.\"\"\"\n        try:\n            fp = pathlib.Path(self._config[config_key])\n            f = fp.open('r', encoding=const.FILE_ENCODING)\n            jdata = json.load(f)\n            parameters_map = jdata\n            f.close()\n        except KeyError as e:\n            logger.debug(f'key {e.args[0]} missing')\n            parameters_map = {}\n        except Exception:\n            logger.warning(f'unable to process {self._config[config_key]}')\n            parameters_map = {}\n        return parameters_map\n\n    # fetch the set of rules that will be included/excluded from the CIS rules\n    def _get_filter_rules(self, config_key: str, file_key: str) -&gt; List[str]:\n        \"\"\"Get filter rules.\"\"\"\n        try:\n            fp = pathlib.Path(self._config[config_key])\n            f = fp.open('r', encoding=const.FILE_ENCODING)\n            jdata = json.load(f)\n            try:\n                filter_rules = jdata[file_key]\n            except Exception:\n                filter_rules = jdata\n            f.close()\n        except KeyError as e:\n            logger.debug(f'key {e.args[0]} missing')\n            filter_rules = []\n        except Exception:\n            logger.warning(f'unable to process {self._config[config_key]}')\n            filter_rules = []\n        return filter_rules\n\n    # create map from file:\n    # key is rule\n    # value is tuple comprising [ category, control, description ]\n    def _get_cis_rules(self, filename: str) -&gt; Dict[str, Tuple[str, str, str]]:\n        \"\"\"Get CIS rules.\"\"\"\n        try:\n            fp = pathlib.Path(filename)\n            f = fp.open('r', encoding=const.FILE_ENCODING)\n            content = f.readlines()\n            rules = self._parse_cis_rules(content)\n            f.close()\n        except Exception:\n            logger.warning(f'unable to process {filename}')\n            rules = {}\n        return rules\n\n    def _parse_cis_rules(self, content: List[str]) -&gt; Dict[str, Tuple[str, str, str]]:\n        \"\"\"Parse CIS rules.\"\"\"\n        rules = {}\n        lineno = 0\n        for line in content:\n            lineno += 1\n            line = line.replace('\\n', '')\n            if line.startswith('  #### '):\n                category = line.split('  #### ')[1]\n                logger.debug(f'{lineno} category: {category}')\n            elif line.startswith('  # '):\n                text = line.split('  # ')[1].split(' ', 1)\n                if '.' in text[0]:\n                    control = text[0]\n                    desc = text[1]\n                    logger.debug(f'{lineno} control: {control} description: {desc}')\n                else:\n                    logger.debug(f'{lineno} skip: {line}')\n            elif line.startswith('    - '):\n                rule = line.split('    - ')[1]\n                logger.debug(f'{lineno} rule: {rule}')\n                if not self._is_selected(rule):\n                    logger.debug(f'not selected rule: {rule}')\n                elif rule in rules.keys():\n                    logger.info(f'duplicate rule: {rule}')\n                else:\n                    rules[rule] = [category, control, desc]\n            else:\n                logger.debug(f'{lineno} skip: {line}')\n        return rules\n\n    # rule is selected if:\n    # a) the selected rules file is not specified or is empty or\n    # b) the rule appears in the list of selected rules from the file\n    def _is_selected(self, rule: str) -&gt; bool:\n        \"\"\"Check if rule is selected.\"\"\"\n        retval = True\n        if len(self._selected_rules) &gt; 0 and rule not in self._selected_rules:\n            retval = False\n        logger.debug(f'{retval} {rule}')\n        return retval\n\n    # rule is excluded if it does not appear in the list of trimmed rules\n    # for the control\n    def _is_excluded(self, rule: str, control: str, controls: Dict[str, List[str]]) -&gt; bool:\n        \"\"\"Check if rule is excluded.\"\"\"\n        retval = False\n        if rule not in controls[control]:\n            logger.debug(f'exclude {rule} {control}')\n            retval = True\n        return retval\n\n    def _build_roles(self) -&gt; List[Role]:\n        \"\"\"Build roles.\"\"\"\n        value = [\n            Role(id='prepared-by', title='Indicates the organization that created this content.'),\n            Role(id='prepared-for', title='Indicates the organization for which this content was created..'),\n            Role(\n                id='content-approver',\n                title='Indicates the organization responsible for all content represented in the \"document\".'\n            ),\n        ]\n        return value\n\n    def _build_control_implementation(\n        self, profile_set: Dict[str, str], responsible_roles: List[ResponsibleRole], props: List[Property]\n    ) -&gt; ControlImplementation:\n        \"\"\"Build control implementation.\"\"\"\n        implemented_requirements = self._build_implemented_requirements(profile_set, responsible_roles)\n        if len(implemented_requirements) == 0:\n            control_implementation = None\n        else:\n            control_implementation = ControlImplementation(\n                uuid=str(uuid.uuid4()),\n                source=profile_set['profile-url'],\n                description=f'{profile_set[\"component-name\"]} implemented controls for {profile_set[\"profile-title\"]}.',\n                implemented_requirements=implemented_requirements,\n                props=props,\n            )\n        return control_implementation\n\n    def _get_title(self, dir_name: str, root: str) -&gt; str:\n        \"\"\"Extract rule title from compliance-as-code rule.yml.\"\"\"\n        \"\"\"\n        Operation:\n        Given is a dir_name and a root directory. We walk the\n        directory tree looking for a directory named dir_name.\n        Once found, we read the content of the rule.yml file in\n        that directory. It is likely that we read each rule.yml\n        file exactly once, since each rule appears exactly once\n        in the one or more profiles, e.g. cis-node.profile, which\n        drive the search. From the content, we find the title and\n        return its corresponding value.\n        \"\"\"\n\n        title = None\n        for path, dirs, _files in os.walk(root):\n            if dir_name in dirs:\n                folder = os.path.join(path, dir_name)\n                tpath = pathlib.Path(folder) / 'rule.yml'\n                fp = pathlib.Path(tpath)\n                f = fp.open('r', encoding=const.FILE_ENCODING)\n                content = f.readlines()\n                f.close()\n                for line in content:\n                    if line.startswith('title:'):\n                        title = line.split('title:')[1]\n                        break\n        if title is None:\n            msg = f'unable to find \"{dir_name}\"'\n            logger.warning(msg)\n            title = 'no title'\n        title = title.strip().strip(\"'\").strip('\"')\n        logger.debug(f'{title}')\n        return title\n\n    def _build_implemented_requirements(self, profile_set: Dict[str, str],\n                                        responsible_roles: List[ResponsibleRole]) -&gt; List[ImplementedRequirement]:\n        \"\"\"Build implemented requirements.\"\"\"\n        implemented_requirements = []\n        profile_file = profile_set['profile-file']\n        rules = self._get_cis_rules(profile_file)\n        controls = self._get_controls(rules)\n        rule_prefix = 'xccdf_org.ssgproject.content_rule_'\n        cac_openshift = f'{self._folder_cac}/applications/openshift'\n        for rule in rules:\n            if self._is_excluded(rule, rules[rule][1], controls):\n                continue\n            remarks = self._get_title(rule, cac_openshift)\n            prop = Property(\n                class_='scc_goal_name_id',\n                ns=profile_set['profile-ns'],\n                name='XCCDF_rule',\n                value=f'{rule_prefix}{rule}',\n                remarks=f'{remarks}'\n            )\n            props = [prop]\n            implemented_requirement = ImplementedRequirement(\n                uuid=f'{str(uuid.uuid4())}',\n                control_id=f'CIS-{rules[rule][1]}',\n                description=f'{rules[rule][2]}',\n                props=props,\n                responsible_roles=responsible_roles,\n            )\n            set_parameter = self._get_set_parameter(rule)\n            if set_parameter is not None:\n                implemented_requirement.set_parameters = [set_parameter]\n            implemented_requirements.append(implemented_requirement)\n        return implemented_requirements\n\n    def _build_responsible_roles(self, party_uuid_01: str, party_uuid_02: str,\n                                 party_uuid_03: str) -&gt; List[ResponsibleRole]:\n        \"\"\"Build responsible roles.\"\"\"\n        role_prepared_by = ResponsibleRole(role_id='prepared-by', party_uuids=[party_uuid_01])\n        role_prepared_for = ResponsibleRole(role_id='prepared-for', party_uuids=[party_uuid_02, party_uuid_03])\n        role_content_approver = ResponsibleRole(role_id='content-approver', party_uuids=[party_uuid_01])\n        value = [\n            role_prepared_by,\n            role_prepared_for,\n            role_content_approver,\n        ]\n        return value\n\n    def _build_parties(\n        self, org_name: str, org_remarks: str, party_uuid_01: str, party_uuid_02: str, party_uuid_03: str\n    ) -&gt; List[Party]:\n        \"\"\"Build parties.\"\"\"\n        value = [\n            Party(uuid=party_uuid_01, type='organization', name=org_name, remarks=org_remarks),\n            Party(\n                uuid=party_uuid_02,\n                type='organization',\n                name='Customer',\n                remarks='organization to be customized at account creation only for their Component Definition'\n            ),\n            Party(\n                uuid=party_uuid_03,\n                type='organization',\n                name='ISV',\n                remarks='organization to be customized at ISV subscription only for their Component Definition'\n            ),\n        ]\n        return value\n\n    def _build_responsible_parties(self, party_uuid_01: str, party_uuid_02: str,\n                                   party_uuid_03: str) -&gt; List[ResponsibleParty]:\n        \"\"\"Build responsible parties.\"\"\"\n        prepared_by = ResponsibleParty(role_id='prepared-by', party_uuids=[party_uuid_01])\n        prepared_for = ResponsibleParty(role_id='prepared-for', party_uuids=[party_uuid_02, party_uuid_03])\n        content_approver = ResponsibleParty(role_id='content-approver', party_uuids=[party_uuid_01])\n        value = [\n            prepared_by,\n            prepared_for,\n            content_approver,\n        ]\n        return value\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.name","title":"<code>name = 'ocp4-cis-profile-to-oscal-cd'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task ocp4-cis-profile-to-oscal-cd.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task ocp4-cis-profile-to-oscal-cd.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n    self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.execute","title":"<code>execute()</code>","text":"<p>Provide an actual outcome.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an actual outcome.\"\"\"\n    try:\n        return self._execute()\n    except Exception:\n        logger.info(traceback.format_exc())\n        return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    logger.info(f'Help information for {self.name} task.')\n    logger.info('')\n    logger.info('Purpose: Create component definition from standard (e.g. CIS benchmark).')\n    logger.info('')\n    logger.info('Configuration flags sit under [task.ocp4-cis-profile-to-oscal-cd]:')\n    text1 = '  component-name         = '\n    text2 = 'component name, e.g. OSCO.'\n    logger.info(text1 + text2)\n    text1 = '  org-name               = '\n    text2 = 'organization name, e.g. International Business Machines.'\n    logger.info(text1 + text2)\n    text1 = '  org-remarks            = '\n    text2 = 'organization remarks, e.g. IBM.'\n    logger.info(text1 + text2)\n    text1 = '  folder-cac             = '\n    text2 = 'folder containing compliance-as-code artifacts, e.g adjunct-data/cis-benchmarks/content.'\n    logger.info(text1 + text2)\n    text1 = '  output-dir             = '\n    text2 = 'location to write the generated component-definition.json file.'\n    logger.info(text1 + text2)\n    #\n    text1 = '  profile-name           = '\n    text2 = 'profile name, e.g. OCP4 CIS-benchmark v4.'\n    logger.info(text1 + text2)\n    text1 = '  profile-mnemonic       = '\n    text2 = 'profile mnemonic, e.g. ocp4-cis-node.'\n    logger.info(text1 + text2)\n    text1 = '  profile-ns             = '\n    text2 = 'profile ns, e.g. https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud.'\n    logger.info(text1 + text2)\n    text1 = '  profile-version        = '\n    text2 = 'profile version, e.g. 1.1.'\n    logger.info(text1 + text2)\n    text1 = '  profile-check-version  = '\n    text2 = 'profile check version, e.g. 0.1.58.'\n    logger.info(text1 + text2)\n    #\n    text1 = '  profile-type           = '\n    text2 = 'profile type, e.g. OCP4.'\n    logger.info(text1 + text2)\n    text1 = '  profile-list           = '\n    text2 = 'profile list is blank separated list of \"&lt;suffix&gt;\" for config entries: '\n    logger.info(text1 + text2)\n    text1 = '                           profile-file.&lt;suffix&gt;, profile-title.&lt;suffix&gt;, profile-url.&lt;suffix&gt;'\n    text2 = ', e.g. cis cis-node.'\n    logger.info(text1 + text2)\n    text1 = '  profile-file.&lt;suffix&gt;  = '\n    text2 = 'path of the profile file to ingest'\n    text3 = ', e.g. ${folder-cac}/products/ocp4/profiles/cis-node.profile.'  # noqa\n    logger.info(text1 + text2 + text3)\n    text1 = '  profile-title.&lt;suffix&gt; = '\n    text2 = 'title of the profile'\n    text3 = ', e.g. CIS Red Hat OpenShift Container Platform 4 Benchmark.'\n    logger.info(text1 + text2 + text3)\n    text1 = '  profile-url.&lt;suffix&gt;   = '\n    text2 = 'URL of the profile'\n    text3 = ', e.g. https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile.'\n    logger.info(text1 + text2 + text3)\n    text1 = '  rule-to-parameters-map = '\n    text2 = 'map file for set-parameters, e.g. '\n    text3 = 'adjunct-data/task-files/rule2var.json.'\n    logger.info(text1 + text2 + text3)\n    text1 = '  selected-rules         = '\n    text2 = 'file with list of selected rules, e.g. '\n    text3 = 'adjunct-data/task-files/selected_rules.json.'\n    logger.info(text1 + text2 + text3)\n    text1 = '  enabled-rules          = '\n    text2 = 'file with list of enabled rules, e.g. '\n    text3 = 'adjunct-data/task-files/enabled_rules.json.'\n    logger.info(text1 + text2 + text3)\n    #\n    text = ''\n    logger.info(text)\n    text = 'Notes:'\n    logger.info(text)\n    text = '1. If a control has selected rules but no enabled rules, then all those selected are included.'\n    logger.info(text)\n    text = '2. If a control has selected and enabled rules, then only those enabled are included.'\n    logger.info(text)\n    text = '3. If a control has no selected rules, then none are included regardless of enabled.'\n    logger.info(text)\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.set_timestamp","title":"<code>set_timestamp(timestamp)</code>","text":"<p>Set the timestamp.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code> <pre><code>def set_timestamp(self, timestamp: str) -&gt; None:\n    \"\"\"Set the timestamp.\"\"\"\n    self._timestamp = timestamp\n</code></pre>"},{"location":"reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/#trestle.tasks.ocp4_cis_profile_to_oscal_cd.Ocp4CisProfileToOscalCD.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/ocp4_cis_profile_to_oscal_cd.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    return TaskOutcome('simulated-success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/","title":"trestle.tasks.oscal_catalog_to_csv","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv","title":"<code>trestle.tasks.oscal_catalog_to_csv</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.level_control","title":"<code>level_control = 'control'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.level_default","title":"<code>level_default = level_statement</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.level_list","title":"<code>level_list = [level_control, level_statement]</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.level_statement","title":"<code>level_statement = 'statement'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.recurse","title":"<code>recurse = True</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.timestamp","title":"<code>timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper","title":"<code>CatalogHelper</code>","text":"<p>OSCAL Catalog Helper.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>class CatalogHelper:\n    \"\"\"OSCAL Catalog Helper.\"\"\"\n\n    def __init__(self, path) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self.path = path\n        self.catalog = Catalog.oscal_read(path)\n        self.catalog_interface = CatalogInterface(self.catalog)\n        self._init_control_parent_map()\n\n    def _init_control_parent_map(self, recurse=True) -&gt; None:\n        \"\"\"Initialize map: Child Control.id to parent Control.\"\"\"\n        self._control_parent_map = {}\n        for control in self.catalog_interface.get_all_controls_from_catalog(recurse):\n            parents = self.catalog_interface.get_dependent_control_ids(control.id)\n            for parent in parents:\n                # assert child has only one parent\n                if parent in self._control_parent_map.keys():\n                    raise RuntimeError('{parent} duplicate?')\n                self._control_parent_map[parent] = control\n\n    def get_parent_control(self, ctl_id: str) -&gt; Control:\n        \"\"\"Return parent Control of child Control.id, if any.\"\"\"\n        return self._control_parent_map.get(ctl_id)\n\n    def get_family_controls(self, ctl_id: str) -&gt; List[Control]:\n        \"\"\"Return family of controls for Control.id, if any.\"\"\"\n        rval = []\n        search_id = ctl_id.split('.')[0]\n        for control in self.catalog_interface.get_all_controls_from_catalog(recurse):\n            if control.id.startswith(search_id):\n                rval.append(control)\n        return rval\n\n    def get_controls(self, recurse=True) -&gt; Iterator:\n        \"\"\"Return controls iterator.\"\"\"\n        for control in self.catalog_interface.get_all_controls_from_catalog(recurse):\n            yield control\n\n    def get_statement_text_for_control(self, control: Control) -&gt; Optional[str]:\n        \"\"\"Get statement text for control.\"\"\"\n        statement_text = self._withdrawn(control)\n        return statement_text\n\n    def get_statement_text_for_part(self, control: Control, part: Part) -&gt; Optional[str]:\n        \"\"\"Get statement text for part.\"\"\"\n        statement_text = self._derive_text(control, part)\n        if part.parts:\n            for subpart in part.parts:\n                if '_smt' in subpart.id:\n                    partial_text = self._derive_text(control, subpart)\n                    statement_text = join_str(statement_text, partial_text)\n        return statement_text\n\n    def _withdrawn(self, control: Control) -&gt; Optional[str]:\n        \"\"\"Check if withdrawn.\"\"\"\n        rval = None\n        for prop in control.props:\n            if prop.name.lower() == 'status' and prop.value.lower() == 'withdrawn':\n                status = self._get_status(control)\n                rval = join_str('Withdrawn', status, '')\n                rval = f'[{rval}]'\n                break\n        return rval\n\n    def _link_generator(self, control: Control) -&gt; Iterator[Link]:\n        \"\"\"Link generator.\"\"\"\n        if control.links:\n            for link in control.links:\n                yield link\n\n    def _get_status(self, control: Control) -&gt; Optional[str]:\n        \"\"\"Get status.\"\"\"\n        rval = None\n        ilist = None\n        for link in self._link_generator(control):\n            if link.rel.lower() == 'moved-to':\n                moved = self._href_to_control(link.href)\n                rval = f': Moved to {moved}.'\n                break\n            if link.rel.lower() == 'incorporated-into':\n                incorporated = self._href_to_control(link.href)\n                if ilist is None:\n                    ilist = f'{incorporated}'\n                else:\n                    ilist = f'{ilist}, {incorporated}'\n        if ilist:\n            rval = f': Incorporated into {ilist}.'\n        return rval\n\n    def _href_to_control(self, href: str) -&gt; str:\n        \"\"\"Convert href to control.\"\"\"\n        rval = href.replace('#', '').upper()\n        return rval\n\n    def _derive_text(self, control: Control, part: Part) -&gt; Optional[str]:\n        \"\"\"Derive control text.\"\"\"\n        rval = None\n        if part.prose:\n            id_ = self._derive_id(part.id)\n            text = self._resolve_parms(control, part.prose)\n            rval = join_str(id_, text)\n        return rval\n\n    def _derive_id(self, id_: str) -&gt; str:\n        \"\"\"Derive control text sub-part id.\"\"\"\n        rval = None\n        id_parts = id_.split('_smt')\n        if id_parts[1]:\n            id_sub_parts = id_parts[1].split('.')\n            if len(id_sub_parts) == 2:\n                rval = f'{id_sub_parts[1]}.'\n            elif len(id_sub_parts) == 3:\n                rval = f'{id_sub_parts[2]}.'\n            elif len(id_sub_parts) == 4:\n                rval = f'({id_sub_parts[3]})'\n        return rval\n\n    def _resolve_parms(self, control: Control, utext: str) -&gt; str:\n        \"\"\"Resolve parm.\"\"\"\n        rtext = self._resolve_parms_for_control(control, utext)\n        if '{{' in rtext:\n            parent_control = self.get_parent_control(control.id)\n            if parent_control:\n                rtext = self._resolve_parms_for_control(parent_control, rtext)\n        if '{{' in rtext:\n            family_controls = self.get_family_controls(control.id)\n            for family_control in family_controls:\n                rtext = self._resolve_parms_for_control(family_control, rtext)\n        if '{{' in rtext:\n            text = f'control.id: {control.id} unresolved: {rtext}'\n            raise RuntimeError(text)\n        return rtext\n\n    def _resolve_parms_for_control(self, control: Control, utext: str) -&gt; str:\n        \"\"\"Resolve parms for control.\"\"\"\n        rtext = utext\n        staches: List[str] = re.findall(r'{{.*?}}', utext)\n        if staches:\n            for stach in staches:\n                parm_id = stach\n                parm_id = parm_id.replace('{{', '')\n                parm_id = parm_id.replace('}}', '')\n                parm_id = parm_id.split(',')[1].strip()\n                value = self._get_parm_value(control, parm_id)\n                if value:\n                    rtext = rtext.replace(stach, value)\n        return rtext\n\n    def _get_parm_value(self, control: Control, parm_id: str) -&gt; str:\n        \"\"\"Get parm value.\"\"\"\n        rval = None\n        if control.params:\n            for param in control.params:\n                if param.id != parm_id:\n                    continue\n                if param.label:\n                    rval = f'[Assignment: {param.label}]'\n                elif param.select:\n                    choices = self._get_parm_choices(control, param)\n                    if param.select.how_many == HowMany.one:\n                        rval = f'[Selection (one): {choices}]'\n                    else:\n                        rval = f'[Selection (one or more): {choices}]'\n                    break\n        return rval\n\n    def _get_parm_choices(self, control: Control, param: Parameter) -&gt; str:\n        \"\"\"Get parm choices.\"\"\"\n        choices = ''\n        for choice in param.select.choice:\n            rchoice = self._resolve_parms(control, choice)\n            if choices:\n                choices += f'; {rchoice}'\n            else:\n                choices += f'{rchoice}'\n        return choices\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog","title":"<code>catalog = Catalog.oscal_read(path)</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.catalog_interface","title":"<code>catalog_interface = CatalogInterface(self.catalog)</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.path","title":"<code>path = path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.__init__","title":"<code>__init__(path)</code>","text":"<p>Initialize.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def __init__(self, path) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self.path = path\n    self.catalog = Catalog.oscal_read(path)\n    self.catalog_interface = CatalogInterface(self.catalog)\n    self._init_control_parent_map()\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_controls","title":"<code>get_controls(recurse=True)</code>","text":"<p>Return controls iterator.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def get_controls(self, recurse=True) -&gt; Iterator:\n    \"\"\"Return controls iterator.\"\"\"\n    for control in self.catalog_interface.get_all_controls_from_catalog(recurse):\n        yield control\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_family_controls","title":"<code>get_family_controls(ctl_id)</code>","text":"<p>Return family of controls for Control.id, if any.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def get_family_controls(self, ctl_id: str) -&gt; List[Control]:\n    \"\"\"Return family of controls for Control.id, if any.\"\"\"\n    rval = []\n    search_id = ctl_id.split('.')[0]\n    for control in self.catalog_interface.get_all_controls_from_catalog(recurse):\n        if control.id.startswith(search_id):\n            rval.append(control)\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_parent_control","title":"<code>get_parent_control(ctl_id)</code>","text":"<p>Return parent Control of child Control.id, if any.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def get_parent_control(self, ctl_id: str) -&gt; Control:\n    \"\"\"Return parent Control of child Control.id, if any.\"\"\"\n    return self._control_parent_map.get(ctl_id)\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_control","title":"<code>get_statement_text_for_control(control)</code>","text":"<p>Get statement text for control.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def get_statement_text_for_control(self, control: Control) -&gt; Optional[str]:\n    \"\"\"Get statement text for control.\"\"\"\n    statement_text = self._withdrawn(control)\n    return statement_text\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CatalogHelper.get_statement_text_for_part","title":"<code>get_statement_text_for_part(control, part)</code>","text":"<p>Get statement text for part.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def get_statement_text_for_part(self, control: Control, part: Part) -&gt; Optional[str]:\n    \"\"\"Get statement text for part.\"\"\"\n    statement_text = self._derive_text(control, part)\n    if part.parts:\n        for subpart in part.parts:\n            if '_smt' in subpart.id:\n                partial_text = self._derive_text(control, subpart)\n                statement_text = join_str(statement_text, partial_text)\n    return statement_text\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.ContentManager","title":"<code>ContentManager</code>","text":"<p>Content manager.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>class ContentManager():\n    \"\"\"Content manager.\"\"\"\n\n    def __init__(self, catalog_helper: CatalogHelper) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self.catalog_helper = catalog_helper\n        self.rows = []\n        self.row_template = None\n\n    def add(self, row: List):\n        \"\"\"Add row.\"\"\"\n        n_row = copy.copy(row)\n        t_row = self.row_template\n        if t_row:\n            for index in range(3):\n                if n_row[index] == t_row[index]:\n                    n_row[index] = None\n        self.rows.append(n_row)\n        self.row_template = row\n\n    def get_content(self, level: str) -&gt; List:\n        \"\"\"Get content.\"\"\"\n        if level == level_control:\n            rval = self._get_content_by_control()\n        else:\n            rval = self._get_content_by_statement()\n        return rval\n\n    def _get_content_by_statement(self) -&gt; List:\n        \"\"\"Get content by statement.\"\"\"\n        catalog_helper = self.catalog_helper\n        header = ['Control Identifier', 'Control Title', 'Statement Identifier', 'Statement Text']\n        self.rows.append(header)\n        for control in catalog_helper.get_controls():\n            control_id = convert_control_id(control.id)\n            if control.parts:\n                self._add_parts_by_statement(control)\n            else:\n                statement_text = catalog_helper.get_statement_text_for_control(control)\n                row = [control_id, control.title, '', statement_text]\n                self.add(row)\n        return self.rows\n\n    def _add_subparts_by_statement(self, control: Control, part: Part) -&gt; None:\n        \"\"\"Add subparts by statement.\"\"\"\n        catalog_helper = self.catalog_helper\n        control_id = convert_control_id(control.id)\n        for subpart in part.parts:\n            if '_smt' in subpart.id:\n                statement_text = catalog_helper.get_statement_text_for_part(control, subpart)\n                row = [control_id, control.title, convert_smt_id(subpart.id), statement_text]\n                self.add(row)\n\n    def _add_parts_by_statement(self, control: Control) -&gt; None:\n        \"\"\"Add parts by statement.\"\"\"\n        catalog_helper = self.catalog_helper\n        control_id = convert_control_id(control.id)\n        for part in control.parts:\n            if part.id:\n                if '_smt' not in part.id:\n                    continue\n                if part.parts:\n                    self._add_subparts_by_statement(control, part)\n                else:\n                    statement_text = catalog_helper.get_statement_text_for_part(control, part)\n                    row = [control_id, control.title, convert_smt_id(part.id), statement_text]\n                    self.add(row)\n\n    def _get_content_by_control(self) -&gt; List:\n        \"\"\"Get content by statement.\"\"\"\n        catalog_helper = self.catalog_helper\n        header = ['Control Identifier', 'Control Title', 'Control Text']\n        self.rows.append(header)\n        for control in catalog_helper.get_controls():\n            control_id = convert_control_id(control.id)\n            if control.parts:\n                self._add_parts_by_control(control)\n            else:\n                control_text = catalog_helper.get_statement_text_for_control(control)\n                row = [control_id, control.title, control_text]\n                self.add(row)\n        return self.rows\n\n    def _add_subparts_by_control(self, control: Control, part: Part, control_text) -&gt; str:\n        \"\"\"Add subparts by control.\"\"\"\n        catalog_helper = self.catalog_helper\n        for subpart in part.parts:\n            if '_smt' in subpart.id:\n                statement_text = catalog_helper.get_statement_text_for_part(control, subpart)\n                control_text = join_str(control_text, statement_text)\n        return control_text\n\n    def _add_parts_by_control(self, control: Control) -&gt; None:\n        \"\"\"Add parts by control.\"\"\"\n        catalog_helper = self.catalog_helper\n        control_id = convert_control_id(control.id)\n        control_text = None\n        for part in control.parts:\n            if part.id:\n                if '_smt' not in part.id:\n                    continue\n                if part.parts:\n                    control_text = self._add_subparts_by_control(control, part, control_text)\n                else:\n                    statement_text = catalog_helper.get_statement_text_for_part(control, part)\n                    control_text = join_str(control_text, statement_text)\n        row = [control_id, control.title, control_text]\n        self.add(row)\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.ContentManager-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.ContentManager.catalog_helper","title":"<code>catalog_helper = catalog_helper</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.ContentManager.row_template","title":"<code>row_template = None</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.ContentManager.rows","title":"<code>rows = []</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.ContentManager-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.ContentManager.__init__","title":"<code>__init__(catalog_helper)</code>","text":"<p>Initialize.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def __init__(self, catalog_helper: CatalogHelper) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self.catalog_helper = catalog_helper\n    self.rows = []\n    self.row_template = None\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.ContentManager.add","title":"<code>add(row)</code>","text":"<p>Add row.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def add(self, row: List):\n    \"\"\"Add row.\"\"\"\n    n_row = copy.copy(row)\n    t_row = self.row_template\n    if t_row:\n        for index in range(3):\n            if n_row[index] == t_row[index]:\n                n_row[index] = None\n    self.rows.append(n_row)\n    self.row_template = row\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.ContentManager.get_content","title":"<code>get_content(level)</code>","text":"<p>Get content.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def get_content(self, level: str) -&gt; List:\n    \"\"\"Get content.\"\"\"\n    if level == level_control:\n        rval = self._get_content_by_control()\n    else:\n        rval = self._get_content_by_statement()\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CsvHelper","title":"<code>CsvHelper</code>","text":"<p>Csv Helper.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>class CsvHelper:\n    \"\"\"Csv Helper.\"\"\"\n\n    def __init__(self, path) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self.path = path\n\n    def write(self, rows: List[List[str]]) -&gt; None:\n        \"\"\"Write csv file.\"\"\"\n        with open(self.path, 'w', newline='', encoding='utf-8') as output:\n            csv_writer = csv.writer(output, delimiter=',', quotechar='\"', quoting=csv.QUOTE_MINIMAL)\n            for row in rows:\n                csv_writer.writerow(row)\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CsvHelper-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CsvHelper.path","title":"<code>path = path</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CsvHelper-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CsvHelper.__init__","title":"<code>__init__(path)</code>","text":"<p>Initialize.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def __init__(self, path) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self.path = path\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.CsvHelper.write","title":"<code>write(rows)</code>","text":"<p>Write csv file.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def write(self, rows: List[List[str]]) -&gt; None:\n    \"\"\"Write csv file.\"\"\"\n    with open(self.path, 'w', newline='', encoding='utf-8') as output:\n        csv_writer = csv.writer(output, delimiter=',', quotechar='\"', quoting=csv.QUOTE_MINIMAL)\n        for row in rows:\n            csv_writer.writerow(row)\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv","title":"<code>OscalCatalogToCsv</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to transform OSCAL catalog to .csv.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>class OscalCatalogToCsv(TaskBase):\n    \"\"\"\n    Task to transform OSCAL catalog to .csv.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'oscal-catalog-to-csv'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        logger.info(f'Help information for {self.name} task.')\n        logger.info('')\n        logger.info('Purpose: Create .csv from OSCAL catalog.')\n        logger.info('')\n        logger.info('Configuration flags sit under [task.oscal-catalog-to-csv]:')\n        text1 = '  input-file             = '\n        text2 = '(required) path of file to read the catalog.'\n        logger.info(text1 + text2)\n        text1 = '  output-dir             = '\n        text2 = '(required) path of directory to write the generated .csv file.'\n        logger.info(text1 + text2)\n        text1 = '  output-name            = '\n        text2 = '(optional) name of the generated .csv file [default is name of input file with .csv suffix].'\n        logger.info(text1 + text2)\n        text1 = '  output-overwrite       = '\n        text2 = '(optional) true [default] or false; replace existing output when true.'\n        logger.info(text1 + text2)\n        text1 = '  level                  = '\n        text2 = f'(optional) one of: {level_control} or {level_statement} [default].'\n        logger.info(text1 + text2)\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        return TaskOutcome('simulated-success')\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an actual outcome.\"\"\"\n        try:\n            return self._execute()\n        except Exception:\n            logger.info(traceback.format_exc())\n            return TaskOutcome('failure')\n\n    def _execute(self) -&gt; TaskOutcome:\n        \"\"\"Wrap the execute for exception handling.\"\"\"\n        # config processing\n        if not self._config:\n            logger.warning('config missing')\n            return TaskOutcome('failure')\n        # input\n        ifile = self._config.get('input-file')\n        if not ifile:\n            logger.warning('input-file missing')\n            return TaskOutcome('failure')\n        ipth = pathlib.Path(ifile)\n        # overwrite\n        self._overwrite = self._config.getboolean('output-overwrite', True)\n        # output\n        odir = self._config.get('output-dir')\n        if not odir:\n            logger.warning('output-dir missing')\n            return TaskOutcome('failure')\n        opth = pathlib.Path(odir)\n        opth.mkdir(exist_ok=True, parents=True)\n        iname = ipth.name.split('.')[0]\n        oname = self._config.get('output-name', f'{iname}.csv')\n        opth = opth / oname\n        if not self._overwrite and opth.exists():\n            logger.warning(f'output: {opth} already exists')\n            return TaskOutcome('failure')\n        csv_helper = CsvHelper(opth)\n        # level\n        level = self._config.get('level', level_default)\n        if level not in level_list:\n            logger.warning(f'level: {level} unknown')\n            return TaskOutcome('failure')\n        # helper\n        catalog_helper = CatalogHelper(ipth)\n        # process\n        content_manager = ContentManager(catalog_helper)\n        rows = content_manager.get_content(level)\n        # write\n        csv_helper.write(rows)\n        logger.info(f'output-file: {opth}')\n        # success\n        return TaskOutcome('success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.name","title":"<code>name = 'oscal-catalog-to-csv'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.execute","title":"<code>execute()</code>","text":"<p>Provide an actual outcome.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an actual outcome.\"\"\"\n    try:\n        return self._execute()\n    except Exception:\n        logger.info(traceback.format_exc())\n        return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    logger.info(f'Help information for {self.name} task.')\n    logger.info('')\n    logger.info('Purpose: Create .csv from OSCAL catalog.')\n    logger.info('')\n    logger.info('Configuration flags sit under [task.oscal-catalog-to-csv]:')\n    text1 = '  input-file             = '\n    text2 = '(required) path of file to read the catalog.'\n    logger.info(text1 + text2)\n    text1 = '  output-dir             = '\n    text2 = '(required) path of directory to write the generated .csv file.'\n    logger.info(text1 + text2)\n    text1 = '  output-name            = '\n    text2 = '(optional) name of the generated .csv file [default is name of input file with .csv suffix].'\n    logger.info(text1 + text2)\n    text1 = '  output-overwrite       = '\n    text2 = '(optional) true [default] or false; replace existing output when true.'\n    logger.info(text1 + text2)\n    text1 = '  level                  = '\n    text2 = f'(optional) one of: {level_control} or {level_statement} [default].'\n    logger.info(text1 + text2)\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.OscalCatalogToCsv.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    return TaskOutcome('simulated-success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.convert_control_id","title":"<code>convert_control_id(control_id)</code>","text":"<p>Convert control id.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def convert_control_id(control_id: str) -&gt; str:\n    \"\"\"Convert control id.\"\"\"\n    rval = copy.copy(control_id)\n    rval = rval.upper()\n    if '.' in rval:\n        rval = rval.replace('.', '(')\n        rval = rval + ')'\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.convert_smt_id","title":"<code>convert_smt_id(smt_id)</code>","text":"<p>Convert smt id.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def convert_smt_id(smt_id: str) -&gt; str:\n    \"\"\"Convert smt id.\"\"\"\n    parts = smt_id.split('_smt')\n    seg1 = convert_control_id(parts[0])\n    seg2 = ''\n    if len(parts) == 2:\n        seg2 = parts[1]\n        if '.' in seg2:\n            seg2 = seg2.replace('.', '(')\n            seg2 = seg2 + ')'\n    rval = f'{seg1}{seg2}'\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_catalog_to_csv/#trestle.tasks.oscal_catalog_to_csv.join_str","title":"<code>join_str(s1, s2, sep=' ')</code>","text":"<p>Join strings.</p> Source code in <code>trestle/tasks/oscal_catalog_to_csv.py</code> <pre><code>def join_str(s1: Optional[str], s2: Optional[str], sep: str = ' ') -&gt; Optional[str]:\n    \"\"\"Join strings.\"\"\"\n    if s1 is None:\n        rval = s2\n    elif s2 is None:\n        rval = s1\n    else:\n        rval = f'{s1}{sep}{s2}'\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/","title":"trestle.tasks.oscal_profile_to_osco_profile","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile","title":"<code>trestle.tasks.oscal_profile_to_osco_profile</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco","title":"<code>ProfileToOsco</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to convert Profile to OSC yaml.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code> <pre><code>class ProfileToOsco(TaskBase):\n    \"\"\"\n    Task to convert Profile to OSC yaml.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'oscal-profile-to-osco-profile'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task oscal-profile-to-osco-profile.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        logger.info(f'Help information for {self.name} task.')\n        logger.info('')\n        logger.info(\n            'Purpose: Transform Open Security Controls Assessment Language (OSCAL) Profile '\n            + 'into Open Shift Compliance Operator (OSCO) .yaml file.'\n        )\n        logger.info('')\n        logger.info('Configuration flags sit under [task.oscal-profile-to-osco-profile]:')\n        logger.info('  input-file = (required) path of the input file comprising OSCAL profile.')\n        logger.info('  output-dir = (required) path of the output directory comprising synthesized .yaml file.')\n        logger.info(\n            '  output-name = (optional) name of created file in output directory, default is osco-profile.yaml.'\n        )\n        logger.info('  output-overwrite = (optional) true [default] or false; replace existing output when true.')\n        logger.info(\n            '  quiet = (optional) true or false [default]; display file creations and rules analysis when false.'\n        )\n        logger.info('')\n        logger.info('Operation: The specified input profile is transformed into OSCO .yaml.')\n        logger.info('')\n        logger.info('Notes:')\n        note11 = '[1] The input-file OSCAL profile should specify a metadata property with'\n        note12 = 'name \"osco_version\" and value of the form \"0.1.46\".'\n        note13 = 'The value corresponds with the OpenShift Compliance Operator (OSCO) version'\n        note14 = 'and affects the format of the emitted yaml.'\n        note15 = 'If not specified, the default is \"0.1.46\".'\n        logger.info(f'{note11} {note12} {note13} {note14} {note15}')\n        note21 = '[2] For OSCO version \"0.1.39\" and prior no \"description\" is emitted for \"spec\".'\n        logger.info(f'{note21}')\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        return TaskOutcome('simulated-success')\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an actual outcome.\"\"\"\n        try:\n            return self._execute()\n        except Exception:\n            logger.warning(traceback.format_exc())\n            return TaskOutcome('failure')\n\n    def _execute(self) -&gt; TaskOutcome:\n        \"\"\"Perform transformation.\"\"\"\n        # check config\n        if not self._config:\n            logger.warning('config missing')\n            return TaskOutcome('failure')\n        # input-file\n        input_file = self._config.get('input-file')\n        if input_file is None:\n            logger.warning('config missing \"input-file\"')\n            return TaskOutcome('failure')\n        logger.info(f'input-file: {input_file}')\n        input_path = pathlib.Path(input_file)\n        # output-dir\n        output_dir = self._config.get('output-dir')\n        if output_dir is None:\n            logger.warning('config missing \"output-dir\"')\n            return TaskOutcome('failure')\n        output_path = pathlib.Path(output_dir)\n        # insure output dir exists\n        output_path.mkdir(exist_ok=True, parents=True)\n        # output file path\n        output_name = self._config.get('output-name', 'osco-profile.yaml')\n        output_filepath = pathlib.Path(output_dir, output_name)\n        logger.info(f'output-file: {output_filepath}')\n        # overwrite\n        overwrite = self._config.getboolean('output-overwrite', True)\n        if not overwrite and pathlib.Path(output_filepath).exists():\n            logger.warning(f'output-file: {output_filepath} already exists')\n            return TaskOutcome('failure')\n        # read input\n        profile = Profile.oscal_read(input_path)\n        # transform\n        transformer = OscalProfileToOscoProfileTransformer()\n        ydata = json.loads(transformer.transform(profile))\n        # write output\n        yaml = YAML(typ='safe')\n        yaml.default_flow_style = False\n        with open(output_filepath, 'w') as outfile:\n            yaml.dump(ydata, outfile)\n        # success\n        return TaskOutcome('success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.name","title":"<code>name = 'oscal-profile-to-osco-profile'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task oscal-profile-to-osco-profile.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task oscal-profile-to-osco-profile.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.execute","title":"<code>execute()</code>","text":"<p>Provide an actual outcome.</p> Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an actual outcome.\"\"\"\n    try:\n        return self._execute()\n    except Exception:\n        logger.warning(traceback.format_exc())\n        return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    logger.info(f'Help information for {self.name} task.')\n    logger.info('')\n    logger.info(\n        'Purpose: Transform Open Security Controls Assessment Language (OSCAL) Profile '\n        + 'into Open Shift Compliance Operator (OSCO) .yaml file.'\n    )\n    logger.info('')\n    logger.info('Configuration flags sit under [task.oscal-profile-to-osco-profile]:')\n    logger.info('  input-file = (required) path of the input file comprising OSCAL profile.')\n    logger.info('  output-dir = (required) path of the output directory comprising synthesized .yaml file.')\n    logger.info(\n        '  output-name = (optional) name of created file in output directory, default is osco-profile.yaml.'\n    )\n    logger.info('  output-overwrite = (optional) true [default] or false; replace existing output when true.')\n    logger.info(\n        '  quiet = (optional) true or false [default]; display file creations and rules analysis when false.'\n    )\n    logger.info('')\n    logger.info('Operation: The specified input profile is transformed into OSCO .yaml.')\n    logger.info('')\n    logger.info('Notes:')\n    note11 = '[1] The input-file OSCAL profile should specify a metadata property with'\n    note12 = 'name \"osco_version\" and value of the form \"0.1.46\".'\n    note13 = 'The value corresponds with the OpenShift Compliance Operator (OSCO) version'\n    note14 = 'and affects the format of the emitted yaml.'\n    note15 = 'If not specified, the default is \"0.1.46\".'\n    logger.info(f'{note11} {note12} {note13} {note14} {note15}')\n    note21 = '[2] For OSCO version \"0.1.39\" and prior no \"description\" is emitted for \"spec\".'\n    logger.info(f'{note21}')\n</code></pre>"},{"location":"reference/API/trestle/tasks/oscal_profile_to_osco_profile/#trestle.tasks.oscal_profile_to_osco_profile.ProfileToOsco.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/oscal_profile_to_osco_profile.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    return TaskOutcome('simulated-success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/","title":"trestle.tasks.osco_result_to_oscal_ar","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar","title":"<code>trestle.tasks.osco_result_to_oscal_ar</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR","title":"<code>OscoResultToOscalAR</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to convert Osco result to OSCAL json.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code> <pre><code>class OscoResultToOscalAR(TaskBase):\n    \"\"\"\n    Task to convert Osco result to OSCAL json.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'osco-result-to-oscal-ar'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task osco-result-to-oscal-ar.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        logger.info(f'Help information for {self.name} task.')\n        logger.info('')\n        logger.info(\n            'Purpose: Transform Osco files into Open Security Controls Assessment Language (OSCAL) '\n            + 'partial results files.'\n        )\n        logger.info('')\n        logger.info('Configuration flags sit under [task.osco-result-to-oscal-ar]:')\n        logger.info(\n            '  checking  = (optional) True indicates perform strict checking of OSCAL properties, default is False.'\n        )\n        logger.info('  input-dir = (required) the path of the input directory comprising Osco results.')\n        logger.info(\n            '  output-dir = (required) the path of the output directory comprising synthesized OSCAL .json files.'\n        )\n        logger.info('  output-overwrite = (optional) true [default] or false; replace existing output when true.')\n        logger.info(\n            '  quiet = (optional) true or false [default]; display file creations and rules analysis when false.'\n        )\n        logger.info(\n            '  timestamp = (optional) timestamp for the Observations in ISO 8601 format, such as '\n            + ' 2021-01-04T00:05:23+04:00 for example; if not specified then value for \"Timestamp\" key in the Osco '\n            + ' result is used if present, otherwise current time is used.'\n        )\n        logger.info('')\n        logger.info(\n            'Operation: A transformation is performed on one or more Osco input files to produce output in OSCAL '\n            + 'partial results format.'\n        )\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        self._simulate = True\n        return self._transform()\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an actual outcome.\"\"\"\n        self._simulate = False\n        return self._transform()\n\n    def _transform(self) -&gt; TaskOutcome:\n        \"\"\"Perform transformation.\"\"\"\n        try:\n            return self._transform_work()\n        except Exception:\n            logger.debug(traceback.format_exc())\n            mode = ''\n            if self._simulate:\n                mode = 'simulated-'\n            return TaskOutcome(mode + 'failure')\n\n    def _transform_work(self) -&gt; TaskOutcome:\n        \"\"\"\n        Perform transformation work steps.\n\n        Work steps: read input, process, write output, display analysis\n        \"\"\"\n        mode = ''\n        if self._simulate:\n            mode = 'simulated-'\n        if not self._config:\n            logger.warning('config missing')\n            return TaskOutcome(mode + 'failure')\n        # config required input &amp; output dirs\n        try:\n            idir = self._config['input-dir']\n            ipth = pathlib.Path(idir)\n            odir = self._config['output-dir']\n            opth = pathlib.Path(odir)\n        except KeyError as e:\n            logger.debug(f'key {e.args[0]} missing')\n            return TaskOutcome(mode + 'failure')\n        # config optional overwrite &amp; quiet\n        self._overwrite = self._config.getboolean('output-overwrite', True)\n        quiet = self._config.get('quiet', False)\n        self._verbose = not self._simulate and not quiet\n        # config optional timestamp\n        timestamp = self._config.get('timestamp')\n        if timestamp is not None:\n            try:\n                OscoTransformer.set_timestamp(timestamp)\n            except Exception:\n                logger.warning('config invalid \"timestamp\"')\n                return TaskOutcome(mode + 'failure')\n        # config optional performance\n        modes = {\n            'checking': self._config.getboolean('checking', False),\n        }\n        # insure output dir exists\n        opth.mkdir(exist_ok=True, parents=True)\n        # process\n        for ifile in sorted(ipth.iterdir()):\n            if ifile.suffix not in ['.json', '.jsn', '.yaml', '.yml', '.xml']:\n                continue\n            blob = self._read_file(ifile)\n            osco_transformer = OscoTransformer()\n            osco_transformer.set_modes(modes)\n            results = osco_transformer.transform(blob)\n            oname = ifile.stem + '.oscal' + '.json'\n            ofile = opth / oname\n            if not self._overwrite and pathlib.Path(ofile).exists():\n                logger.warning(f'output: {ofile} already exists')\n                return TaskOutcome(mode + 'failure')\n            self._write_file(results, ofile)\n            self._show_analysis(osco_transformer)\n        return TaskOutcome(mode + 'success')\n\n    def _read_file(self, ifile: str) -&gt; str:\n        \"\"\"Read raw input file.\"\"\"\n        if not self._simulate and self._verbose:\n            logger.info(f'input: {ifile}')\n        with open(ifile, encoding=const.FILE_ENCODING) as fp:\n            blob = fp.read()\n        return blob\n\n    def _write_file(self, result: str, ofile: str) -&gt; None:\n        \"\"\"Write oscal results file.\"\"\"\n        if not self._simulate:\n            if self._verbose:\n                logger.info(f'output: {ofile}')\n            result.oscal_write(pathlib.Path(ofile))\n\n    def _show_analysis(self, osco_transformer: OscoTransformer) -&gt; None:\n        \"\"\"Show analysis.\"\"\"\n        if not self._simulate and self._verbose:\n            analysis = osco_transformer.analysis\n            for line in analysis:\n                logger.info(line)\n</code></pre>"},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.name","title":"<code>name = 'osco-result-to-oscal-ar'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task osco-result-to-oscal-ar.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task osco-result-to-oscal-ar.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n</code></pre>"},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.execute","title":"<code>execute()</code>","text":"<p>Provide an actual outcome.</p> Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an actual outcome.\"\"\"\n    self._simulate = False\n    return self._transform()\n</code></pre>"},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    logger.info(f'Help information for {self.name} task.')\n    logger.info('')\n    logger.info(\n        'Purpose: Transform Osco files into Open Security Controls Assessment Language (OSCAL) '\n        + 'partial results files.'\n    )\n    logger.info('')\n    logger.info('Configuration flags sit under [task.osco-result-to-oscal-ar]:')\n    logger.info(\n        '  checking  = (optional) True indicates perform strict checking of OSCAL properties, default is False.'\n    )\n    logger.info('  input-dir = (required) the path of the input directory comprising Osco results.')\n    logger.info(\n        '  output-dir = (required) the path of the output directory comprising synthesized OSCAL .json files.'\n    )\n    logger.info('  output-overwrite = (optional) true [default] or false; replace existing output when true.')\n    logger.info(\n        '  quiet = (optional) true or false [default]; display file creations and rules analysis when false.'\n    )\n    logger.info(\n        '  timestamp = (optional) timestamp for the Observations in ISO 8601 format, such as '\n        + ' 2021-01-04T00:05:23+04:00 for example; if not specified then value for \"Timestamp\" key in the Osco '\n        + ' result is used if present, otherwise current time is used.'\n    )\n    logger.info('')\n    logger.info(\n        'Operation: A transformation is performed on one or more Osco input files to produce output in OSCAL '\n        + 'partial results format.'\n    )\n</code></pre>"},{"location":"reference/API/trestle/tasks/osco_result_to_oscal_ar/#trestle.tasks.osco_result_to_oscal_ar.OscoResultToOscalAR.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/osco_result_to_oscal_ar.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    self._simulate = True\n    return self._transform()\n</code></pre>"},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/","title":"trestle.tasks.tanium_result_to_oscal_ar","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar","title":"<code>trestle.tasks.tanium_result_to_oscal_ar</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR","title":"<code>TaniumResultToOscalAR</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to convert Tanium result to OSCAL json.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code> <pre><code>class TaniumResultToOscalAR(TaskBase):\n    \"\"\"\n    Task to convert Tanium result to OSCAL json.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'tanium-result-to-oscal-ar'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task tanium-result-to-oscal-ar.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        logger.info(f'Help information for {self.name} task.')\n        logger.info('')\n        logger.info(\n            'Purpose: Transform Tanium files into Open Security Controls Assessment Language (OSCAL) results objects'\n            + 'and serialize to a file.'\n        )\n        logger.info('')\n        logger.info('Configuration flags sit under [task.tanium-result-to-oscal-ar]:')\n        logger.info('  blocksize = (optional) the desired number Tanuim result input lines to process per CPU.')\n        logger.info('  cpus-max  = (optional) the desired maximum number of CPUs to employ, default is 1.')\n        logger.info('  cpus-min  = (optional) the desired minimum number of CPUs to employ.')\n        logger.info('  aggregate = (optional) True indicates employ properties aggregation, default is True.')\n        logger.info('  caching   = (optional) True indicates employ object caching, default is True.')\n        logger.info(\n            '  checking  = (optional) True indicates perform strict checking of OSCAL properties, default is False.'\n        )\n        logger.info('  input-dir = (required) the path of the input directory comprising Tanium results.')\n        logger.info(\n            '  output-dir = (required) the path of the output directory comprising synthesized OSCAL .json files.'\n        )\n        logger.info('  output-overwrite = (optional) true [default] or false; replace existing output when true.')\n        logger.info(\n            '  quiet = (optional) true or false [default]; display file creations and rules analysis when false.'\n        )\n        logger.info(\n            '  timestamp = (optional) timestamp for the Observations in ISO 8601 format, such as '\n            + '2021-01-04T00:05:23+04:00 for example; if not specified then value for \"Timestamp\" key in the Tanium '\n            + 'result is used if present, otherwise current time is used.'\n        )\n        logger.info('')\n        logger.info(\n            'Operation: A transformation is performed on one or more Tanium input files to produce output in '\n            + 'OSCAL partial results format.'\n        )\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        self._simulate = True\n        return self._transform()\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an actual outcome.\"\"\"\n        self._simulate = False\n        return self._transform()\n\n    def _transform(self) -&gt; TaskOutcome:\n        \"\"\"Perform transformation.\"\"\"\n        try:\n            return self._transform_work()\n        except Exception:\n            logger.info(traceback.format_exc())\n            mode = ''\n            if self._simulate:\n                mode = 'simulated-'\n            return TaskOutcome(mode + 'failure')\n\n    def _transform_work(self) -&gt; TaskOutcome:\n        \"\"\"\n        Perform the transformation work.\n\n        Transformation work steps: read input, process, write output, display analysis.\n        \"\"\"\n        mode = ''\n        if self._simulate:\n            mode = 'simulated-'\n        if not self._config:\n            logger.warning('Config missing')\n            return TaskOutcome(mode + 'failure')\n        # config required input &amp; output dirs\n        try:\n            idir = self._config['input-dir']\n            ipth = pathlib.Path(idir)\n            odir = self._config['output-dir']\n            opth = pathlib.Path(odir)\n        except KeyError as e:\n            logger.debug(f'key {e.args[0]} missing')\n            return TaskOutcome(mode + 'failure')\n        # config optional overwrite &amp; quiet\n        self._overwrite = self._config.getboolean('output-overwrite', True)\n        quiet = self._config.get('quiet', False)\n        self._verbose = not self._simulate and not quiet\n        # config optional timestamp\n        timestamp = self._config.get('timestamp')\n        if timestamp is not None:\n            try:\n                TaniumTransformer.set_timestamp(timestamp)\n            except Exception:\n                logger.warning('config invalid \"timestamp\"')\n                return TaskOutcome(mode + 'failure')\n        # config optional performance\n        modes = {\n            'blocksize': self._config.getint('blocksize', 10000),\n            'cpus_max': self._config.getint('cpus-max', 1),\n            'cpus_min': self._config.getint('cpus-min', 1),\n            'aggregate': self._config.getboolean('aggregate', True),\n            'caching': self._config.getboolean('caching', True),\n            'checking': self._config.getboolean('checking', False),\n        }\n        # insure output dir exists\n        opth.mkdir(exist_ok=True, parents=True)\n        # process\n        for ifile in sorted(ipth.iterdir()):\n            blob = self._read_file(ifile)\n            tanium_transformer = TaniumTransformer()\n            tanium_transformer.set_modes(modes)\n            results = tanium_transformer.transform(blob)\n            oname = ifile.stem + '.oscal' + '.json'\n            ofile = opth / oname\n            if not self._overwrite and pathlib.Path(ofile).exists():\n                logger.warning(f'output: {ofile} already exists')\n                return TaskOutcome(mode + 'failure')\n            self._write_file(results, ofile)\n            self._show_analysis(tanium_transformer)\n        return TaskOutcome(mode + 'success')\n\n    def _read_file(self, ifile: str) -&gt; str:\n        \"\"\"Read raw input file.\"\"\"\n        if not self._simulate and self._verbose:\n            logger.info(f'input: {ifile}')\n        with open(ifile, 'r', encoding=const.FILE_ENCODING) as fp:\n            blob = fp.read()\n        return blob\n\n    def _write_file(self, result: str, ofile: str) -&gt; None:\n        \"\"\"Write oscal results file.\"\"\"\n        if not self._simulate:\n            if self._verbose:\n                logger.info(f'output: {ofile}')\n            result.oscal_write(pathlib.Path(ofile))\n\n    def _show_analysis(self, tanium_transformer: TaniumTransformer) -&gt; None:\n        \"\"\"Show analysis.\"\"\"\n        if not self._simulate and self._verbose:\n            analysis = tanium_transformer.analysis\n            for line in analysis:\n                logger.info(line)\n</code></pre>"},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.name","title":"<code>name = 'tanium-result-to-oscal-ar'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task tanium-result-to-oscal-ar.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task tanium-result-to-oscal-ar.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n</code></pre>"},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.execute","title":"<code>execute()</code>","text":"<p>Provide an actual outcome.</p> Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an actual outcome.\"\"\"\n    self._simulate = False\n    return self._transform()\n</code></pre>"},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    logger.info(f'Help information for {self.name} task.')\n    logger.info('')\n    logger.info(\n        'Purpose: Transform Tanium files into Open Security Controls Assessment Language (OSCAL) results objects'\n        + 'and serialize to a file.'\n    )\n    logger.info('')\n    logger.info('Configuration flags sit under [task.tanium-result-to-oscal-ar]:')\n    logger.info('  blocksize = (optional) the desired number Tanuim result input lines to process per CPU.')\n    logger.info('  cpus-max  = (optional) the desired maximum number of CPUs to employ, default is 1.')\n    logger.info('  cpus-min  = (optional) the desired minimum number of CPUs to employ.')\n    logger.info('  aggregate = (optional) True indicates employ properties aggregation, default is True.')\n    logger.info('  caching   = (optional) True indicates employ object caching, default is True.')\n    logger.info(\n        '  checking  = (optional) True indicates perform strict checking of OSCAL properties, default is False.'\n    )\n    logger.info('  input-dir = (required) the path of the input directory comprising Tanium results.')\n    logger.info(\n        '  output-dir = (required) the path of the output directory comprising synthesized OSCAL .json files.'\n    )\n    logger.info('  output-overwrite = (optional) true [default] or false; replace existing output when true.')\n    logger.info(\n        '  quiet = (optional) true or false [default]; display file creations and rules analysis when false.'\n    )\n    logger.info(\n        '  timestamp = (optional) timestamp for the Observations in ISO 8601 format, such as '\n        + '2021-01-04T00:05:23+04:00 for example; if not specified then value for \"Timestamp\" key in the Tanium '\n        + 'result is used if present, otherwise current time is used.'\n    )\n    logger.info('')\n    logger.info(\n        'Operation: A transformation is performed on one or more Tanium input files to produce output in '\n        + 'OSCAL partial results format.'\n    )\n</code></pre>"},{"location":"reference/API/trestle/tasks/tanium_result_to_oscal_ar/#trestle.tasks.tanium_result_to_oscal_ar.TaniumResultToOscalAR.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/tanium_result_to_oscal_ar.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    self._simulate = True\n    return self._transform()\n</code></pre>"},{"location":"reference/API/trestle/tasks/transform/","title":"trestle.tasks.transform","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/transform/#trestle.tasks.transform","title":"<code>trestle.tasks.transform</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/","title":"trestle.tasks.xccdf_result_to_oscal_ar","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar","title":"<code>trestle.tasks.xccdf_result_to_oscal_ar</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.default_description","title":"<code>default_description = 'XCCDF Scan Results'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.default_title","title":"<code>default_title = 'XCCDF'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.default_type","title":"<code>default_type = 'Validator'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR","title":"<code>XccdfResultToOscalAR</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to convert Xccdf result to OSCAL json.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code> <pre><code>class XccdfResultToOscalAR(TaskBase):\n    \"\"\"\n    Task to convert Xccdf result to OSCAL json.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'xccdf-result-to-oscal-ar'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task xccdf-result-to-oscal-ar.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        opt = '(optional)'\n        req = '(required)'\n        logger.info(f'Help information for {self.name} task.')\n        logger.info('')\n        logger.info(\n            'Purpose: Transform Xccdf files into Open Security Controls Assessment Language (OSCAL) '\n            + 'partial results files.'\n        )\n        logger.info('')\n        logger.info('Configuration flags sit under [task.xccdf-result-to-oscal-ar]:')\n        #\n        t1 = f'  input-dir              = {req} '\n        t2 = 'the path of the input directory comprising Xccdf results.'\n        logger.info(f'{t1}{t2}')\n        t1 = f'  output-dir             = {req} '\n        t2 = 'the path of the output directory comprising synthesized OSCAL .json files.'\n        logger.info(f'{t1}{t2}')\n        t1 = f'  checking               = {opt} '\n        t2 = 'True indicates perform strict checking of OSCAL properties, default is False.'\n        logger.info(f'{t1}{t2}')\n        t1 = f'  output-overwrite       = {opt} '\n        t2 = 'true [default] or false; replace existing output when true.'\n        logger.info(f'{t1}{t2}')\n        t1 = f'  quiet                  = {opt} '\n        t2 = 'true or false [default]; display file creations and rules analysis when false.'\n        logger.info(f'{t1}{t2}')\n        t1 = f'  title                  = {opt} '\n        t2 = f'default={default_title}.'\n        logger.info(f'{t1}{t2}')\n        t1 = f'  description            = {opt} '\n        t2 = f'default={default_description}.'\n        logger.info(f'{t1}{t2}')\n        t1 = f'  type                   = {opt} '\n        t2 = f'default={default_type}.'\n        logger.info(f'{t1}{t2}')\n        t1 = f'  property-name-to-class = {opt} '\n        t2 = 'list of name:class pairs for tagging named property with class, '\n        t3 = 'e.g. \"target:scc_inventory_item_id, version:scc_check_version\".'\n        logger.info(f'{t1}{t2}{t3}')\n        t1 = f'  timestamp              = {opt} '\n        t2 = 'timestamp for the Observations in ISO 8601 format, such as '\n        t3 = ' 2021-01-04T00:05:23+04:00 for example; if not specified then value for \"Timestamp\" key in the Xccdf '\n        t4 = ' result is used if present, otherwise current time is used.'\n        logger.info(f'{t1}{t2}{t3}{t4}')\n        #\n        logger.info('')\n        logger.info(\n            'Operation: A transformation is performed on one or more Xccdf input files to produce output in OSCAL '\n            + 'partial results format.'\n        )\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        self._simulate = True\n        return self._transform()\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an actual outcome.\"\"\"\n        self._simulate = False\n        return self._transform()\n\n    def _transform(self) -&gt; TaskOutcome:\n        \"\"\"Perform transformation.\"\"\"\n        try:\n            return self._transform_work()\n        except Exception:\n            logger.debug(traceback.format_exc())\n            mode = ''\n            if self._simulate:\n                mode = 'simulated-'\n            return TaskOutcome(mode + 'failure')\n\n    def _transform_work(self) -&gt; TaskOutcome:\n        \"\"\"\n        Perform transformation work steps.\n\n        Work steps: read input, process, write output, display analysis\n        \"\"\"\n        mode = ''\n        if self._simulate:\n            mode = 'simulated-'\n        if not self._config:\n            logger.warning('config missing')\n            return TaskOutcome(mode + 'failure')\n        # config required input &amp; output dirs\n        try:\n            idir = self._config['input-dir']\n            ipth = pathlib.Path(idir)\n            odir = self._config['output-dir']\n            opth = pathlib.Path(odir)\n        except KeyError as e:\n            logger.debug(f'key {e.args[0]} missing')\n            return TaskOutcome(mode + 'failure')\n        # config optional overwrite &amp; quiet\n        self._overwrite = self._config.getboolean('output-overwrite', True)\n        quiet = self._config.get('quiet', False)\n        self._verbose = not self._simulate and not quiet\n        # title, description, type\n        title = self._config.get('title', default_title)\n        description = self._config.get('description', default_description)\n        type_ = self._config.get('type', default_type)\n        # property-name-to-class\n        tags = self._get_tags()\n        # config optional timestamp\n        timestamp = self._config.get('timestamp')\n        if timestamp is not None:\n            try:\n                XccdfTransformer.set_timestamp(timestamp)\n            except Exception:\n                logger.warning('config invalid \"timestamp\"')\n                return TaskOutcome(mode + 'failure')\n        # config optional performance\n        modes = {\n            'checking': self._config.getboolean('checking', False),\n        }\n        # insure output dir exists\n        opth.mkdir(exist_ok=True, parents=True)\n        # process\n        for ifile in sorted(ipth.iterdir()):\n            if ifile.suffix not in ['.json', '.jsn', '.yaml', '.yml', '.xml']:\n                continue\n            blob = self._read_file(ifile)\n            xccdf_transformer = XccdfTransformer()\n            xccdf_transformer.set_title(title)\n            xccdf_transformer.set_description(description)\n            xccdf_transformer.set_type(type_)\n            xccdf_transformer.set_modes(modes)\n            xccdf_transformer.set_tags(tags)\n            results = xccdf_transformer.transform(blob)\n            oname = ifile.stem + '.oscal' + '.json'\n            ofile = opth / oname\n            if not self._overwrite and pathlib.Path(ofile).exists():\n                logger.warning(f'output: {ofile} already exists')\n                return TaskOutcome(mode + 'failure')\n            self._write_file(results, ofile)\n            self._show_analysis(xccdf_transformer)\n        return TaskOutcome(mode + 'success')\n\n    def _get_tags(self) -&gt; Dict:\n        \"\"\"Get property name to class tags, if any.\"\"\"\n        tags = {}\n        data = self._config.get('property-name-to-class')\n        if data is not None:\n            for item in data.split(','):\n                item = item.strip()\n                parts = item.split(':')\n                if len(parts) == 2:\n                    name = parts[0]\n                    value = parts[1]\n                    tags[name] = value\n        return tags\n\n    def _read_file(self, ifile: str) -&gt; str:\n        \"\"\"Read raw input file.\"\"\"\n        if not self._simulate and self._verbose:\n            logger.info(f'input: {ifile}')\n        with open(ifile, encoding=const.FILE_ENCODING) as fp:\n            blob = fp.read()\n        return blob\n\n    def _write_file(self, result: str, ofile: str) -&gt; None:\n        \"\"\"Write oscal results file.\"\"\"\n        if not self._simulate:\n            if self._verbose:\n                logger.info(f'output: {ofile}')\n            result.oscal_write(pathlib.Path(ofile))\n\n    def _show_analysis(self, xccdf_transformer: XccdfTransformer) -&gt; None:\n        \"\"\"Show analysis.\"\"\"\n        if not self._simulate and self._verbose:\n            analysis = xccdf_transformer.analysis\n            for line in analysis:\n                logger.info(line)\n</code></pre>"},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.name","title":"<code>name = 'xccdf-result-to-oscal-ar'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task xccdf-result-to-oscal-ar.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task xccdf-result-to-oscal-ar.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n</code></pre>"},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.execute","title":"<code>execute()</code>","text":"<p>Provide an actual outcome.</p> Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an actual outcome.\"\"\"\n    self._simulate = False\n    return self._transform()\n</code></pre>"},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    opt = '(optional)'\n    req = '(required)'\n    logger.info(f'Help information for {self.name} task.')\n    logger.info('')\n    logger.info(\n        'Purpose: Transform Xccdf files into Open Security Controls Assessment Language (OSCAL) '\n        + 'partial results files.'\n    )\n    logger.info('')\n    logger.info('Configuration flags sit under [task.xccdf-result-to-oscal-ar]:')\n    #\n    t1 = f'  input-dir              = {req} '\n    t2 = 'the path of the input directory comprising Xccdf results.'\n    logger.info(f'{t1}{t2}')\n    t1 = f'  output-dir             = {req} '\n    t2 = 'the path of the output directory comprising synthesized OSCAL .json files.'\n    logger.info(f'{t1}{t2}')\n    t1 = f'  checking               = {opt} '\n    t2 = 'True indicates perform strict checking of OSCAL properties, default is False.'\n    logger.info(f'{t1}{t2}')\n    t1 = f'  output-overwrite       = {opt} '\n    t2 = 'true [default] or false; replace existing output when true.'\n    logger.info(f'{t1}{t2}')\n    t1 = f'  quiet                  = {opt} '\n    t2 = 'true or false [default]; display file creations and rules analysis when false.'\n    logger.info(f'{t1}{t2}')\n    t1 = f'  title                  = {opt} '\n    t2 = f'default={default_title}.'\n    logger.info(f'{t1}{t2}')\n    t1 = f'  description            = {opt} '\n    t2 = f'default={default_description}.'\n    logger.info(f'{t1}{t2}')\n    t1 = f'  type                   = {opt} '\n    t2 = f'default={default_type}.'\n    logger.info(f'{t1}{t2}')\n    t1 = f'  property-name-to-class = {opt} '\n    t2 = 'list of name:class pairs for tagging named property with class, '\n    t3 = 'e.g. \"target:scc_inventory_item_id, version:scc_check_version\".'\n    logger.info(f'{t1}{t2}{t3}')\n    t1 = f'  timestamp              = {opt} '\n    t2 = 'timestamp for the Observations in ISO 8601 format, such as '\n    t3 = ' 2021-01-04T00:05:23+04:00 for example; if not specified then value for \"Timestamp\" key in the Xccdf '\n    t4 = ' result is used if present, otherwise current time is used.'\n    logger.info(f'{t1}{t2}{t3}{t4}')\n    #\n    logger.info('')\n    logger.info(\n        'Operation: A transformation is performed on one or more Xccdf input files to produce output in OSCAL '\n        + 'partial results format.'\n    )\n</code></pre>"},{"location":"reference/API/trestle/tasks/xccdf_result_to_oscal_ar/#trestle.tasks.xccdf_result_to_oscal_ar.XccdfResultToOscalAR.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/xccdf_result_to_oscal_ar.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    self._simulate = True\n    return self._transform()\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/","title":"trestle.tasks.xlsx_helper","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper","title":"<code>trestle.tasks.xlsx_helper</code>","text":"<p>XLSX utilities.</p>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column","title":"<code>Column</code>","text":"<p>Spread sheet columns.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>class Column():\n    \"\"\"Spread sheet columns.\"\"\"\n\n    control_id = 'ControlId'\n    control_text = 'ControlText'\n    goal_name_id = 'goal_name_id'\n    goal_version = 'goal_version'\n    rule_name_id = 'rule_name_id'\n    rule_version = 'rule_version'\n    nist_mappings = 'NIST Mappings'\n    resource_title = 'ResourceTitle'\n    parameter_opt_parm = 'Parameter [optional parameter]'\n    values_alternatives = 'Values default , [alternatives]'\n    filter_column = None\n\n    tokens_nist_mappings = nist_mappings.split()\n    tokens_parameter_opt_parm = parameter_opt_parm.split()\n    rename_parameter_opt_parm = 'ParameterName'\n    tokens_values_alternatives = values_alternatives.split()\n    rename_values_alternatives = 'ParameterValue'\n\n    help_list = []\n    text1 = '                      '\n    text2 = f'column \"{control_id}\" contains control ID.'\n    help_list.append(text1 + text2)\n    text2 = f'column \"{control_text}\" contains control text.'\n    help_list.append(text1 + text2)\n    text2 = f'columns \"{nist_mappings}\" contain NIST control mappings.'\n    help_list.append(text1 + text2)\n    text2 = f'column \"{resource_title}\" contains component name.'\n    help_list.append(text1 + text2)\n    text2 = f'column \"{goal_name_id}\" contains goal name.'\n    help_list.append(text1 + text2)\n    text2 = f'column \"{goal_version}\" contains goal version.'\n    help_list.append(text1 + text2)\n    text2 = f'column \"{rule_name_id}\" contains rule name.'\n    help_list.append(text1 + text2)\n    text2 = f'column \"{rule_version}\" contains rule version.'\n    help_list.append(text1 + text2)\n    text2 = f'column \"{parameter_opt_parm}\" contains parameter name + description, separated by newline.'\n    help_list.append(text1 + text2)\n    text2 = f'column \"{values_alternatives}\" contains parameter values.'\n    help_list.append(text1 + text2)\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.control_id","title":"<code>control_id = 'ControlId'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.control_text","title":"<code>control_text = 'ControlText'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.filter_column","title":"<code>filter_column = None</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.goal_name_id","title":"<code>goal_name_id = 'goal_name_id'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.goal_version","title":"<code>goal_version = 'goal_version'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.help_list","title":"<code>help_list = []</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.nist_mappings","title":"<code>nist_mappings = 'NIST Mappings'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.parameter_opt_parm","title":"<code>parameter_opt_parm = 'Parameter [optional parameter]'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.rename_parameter_opt_parm","title":"<code>rename_parameter_opt_parm = 'ParameterName'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.rename_values_alternatives","title":"<code>rename_values_alternatives = 'ParameterValue'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.resource_title","title":"<code>resource_title = 'ResourceTitle'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.rule_name_id","title":"<code>rule_name_id = 'rule_name_id'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.rule_version","title":"<code>rule_version = 'rule_version'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.text1","title":"<code>text1 = '                      '</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.text2","title":"<code>text2 = f'column \"{values_alternatives}\" contains parameter values.'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.tokens_nist_mappings","title":"<code>tokens_nist_mappings = nist_mappings.split()</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.tokens_parameter_opt_parm","title":"<code>tokens_parameter_opt_parm = parameter_opt_parm.split()</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.tokens_values_alternatives","title":"<code>tokens_values_alternatives = values_alternatives.split()</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.Column.values_alternatives","title":"<code>values_alternatives = 'Values default , [alternatives]'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper","title":"<code>XlsxHelper</code>","text":"<p>Xlsx Helper common functions and assistance navigating spread sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>class XlsxHelper:\n    \"\"\"Xlsx Helper common functions and assistance navigating spread sheet.\"\"\"\n\n    by_goal = 'by-goal'\n    by_rule = 'by-rule'\n    by_control = 'by-control'\n    by_check = 'by-check'\n\n    profile_types = [by_goal, by_rule, by_control, by_check]\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self._column = Column()\n\n    def print_info(self, name, oscal_name) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        logger.info(f'Help information for {name} task.')\n        logger.info('')\n        logger.info(f'Purpose: From spread sheet and catalog produce OSCAL {oscal_name} file.')\n        logger.info('')\n        logger.info(f'Configuration flags sit under [task.{name}]:')\n        if oscal_name == 'component_definition':\n            text1 = '  catalog-file      = '\n            text2 = '(required) the path of the OSCAL catalog file.'\n            logger.info(text1 + text2)\n        text1 = '  spread-sheet-file = '\n        text2 = '(required) the path of the spread sheet file.'\n        logger.info(text1 + text2)\n        text1 = '  work-sheet-name   = '\n        text2 = '(required) the name of the work sheet in the spread sheet file.'\n        logger.info(text1 + text2)\n        for line in self._column.help_list:\n            logger.info(line)\n        text1 = '  output-dir        = '\n        text2 = '(required) the path of the output directory for synthesized OSCAL .json files.'\n        logger.info(text1 + text2)\n        text1 = '  output-overwrite  = '\n        text2 = '(optional) true [default] or false; replace existing output when true.'\n        logger.info(text1 + text2)\n        text1 = '  filter-column     = '\n        text2 = '(optional) column heading of yes/no values; process only \"yes\" rows.'\n        logger.info(text1 + text2)\n        text1 = '  profile-type      = '\n        text2 = f'(optional) one of {self.profile_types}'\n        logger.info(text1 + text2)\n\n    @property\n    def profile_type(self) -&gt; str:\n        \"\"\"Profile type.\"\"\"\n        return self._profile_type\n\n    def configure(self, task: TaskBase) -&gt; bool:\n        \"\"\"Configure.\"\"\"\n        if not task._config:\n            logger.warning('config missing')\n            return False\n        # config verbosity\n        quiet = task._config.get('quiet', False)\n        task._verbose = not quiet\n        # required for component-definition\n        if not self.configure_cd(task):\n            return False\n        # required for profile\n        if not self.configure_profile(task):\n            return False\n        # optional\n        self._column.filter_column = task._config.get('filter-column', None)\n        # config spread sheet\n        spread_sheet = task._config.get('spread-sheet-file')\n        if spread_sheet is None:\n            logger.warning('config missing \"spread-sheet\"')\n            return False\n        if not pathlib.Path(spread_sheet).exists():\n            logger.warning('\"spread-sheet\" not found')\n            return False\n        sheet_name = task._config.get('work-sheet-name')\n        if sheet_name is None:\n            logger.warning('config missing \"work-sheet-name\"')\n            return False\n        # announce spreadsheet\n        if task._verbose:\n            logger.info(f'input: {spread_sheet}')\n        # get profile type\n        if task.name == 'xlsx-to-oscal-profile':\n            self._profile_type = task._config.get('profile-type', self.profile_types[0])\n            if self._profile_type not in self.profile_types:\n                logger.warning(f'invalid \"profile-type\" {self._profile_type} ')\n                return False\n        else:\n            self._profile_type = None\n        # load spread sheet\n        self.load(spread_sheet, sheet_name)\n        return True\n\n    def configure_cd(self, task: TaskBase) -&gt; bool:\n        \"\"\"Configure cd.\"\"\"\n        if task.name == 'xlsx-to-oscal-cd':\n            catalog_file = task._config.get('catalog-file')\n            if catalog_file is None:\n                logger.warning('config missing \"catalog-file\"')\n                return False\n            try:\n                catalog = Catalog.oscal_read(pathlib.Path(catalog_file))\n                logger.debug(f'catalog: {catalog_file}')\n            except Exception as e:  # pragma: no cover\n                raise TrestleError(f'Error loading catalog {catalog_file}: {e}')\n            task.catalog_interface = CatalogInterface(catalog)\n        return True\n\n    def configure_profile(self, task: TaskBase) -&gt; bool:\n        \"\"\"Configure profile.\"\"\"\n        if task.name == 'xlsx-to-oscal-profile':\n            profile_title = task._config.get('profile-title')\n            if profile_title is None:\n                logger.warning('config missing \"profile-title\"')\n                return False\n            spread_sheet_url = task._config.get('spread-sheet-url')\n            if spread_sheet_url is None:\n                logger.warning('config missing \"spread-sheet-url\"')\n                return False\n        return True\n\n    def load(self, spread_sheet: str, sheet_name: str) -&gt; None:\n        \"\"\"Load.\"\"\"\n        self._spread_sheet = spread_sheet\n        self._sheet_name = sheet_name\n        self._wb = load_workbook(self._spread_sheet)\n        self._work_sheet = self._wb[self._sheet_name]\n        self._map_name_to_letters = {}\n        # accumulators\n        self.rows_missing_control_id = []\n        self.rows_missing_goal_name_id = []\n        self.rows_invalid_goal_name_id = []\n        self.rows_missing_rule_name_id = []\n        self.rows_invalid_rule_name_id = []\n        self.rows_invalid_parameter_name = []\n        self.rows_missing_controls = []\n        self.rows_missing_parameters = []\n        self.rows_missing_parameters_values = []\n        self.rows_filtered = []\n        # map columns\n        self._map_columns()\n\n    def row_generator(self) -&gt; Iterator[int]:\n        \"\"\"Generate rows until control_id is None.\"\"\"\n        row = 1\n        rows_skipped_consecutive = 0\n        # assume no more data when 100 consecutve rows no control id\n        rows_skipped_consecutive_limit = 100\n        while True:\n            row = row + 1\n            control_id = self._get_control_id(row)\n            goal_id = self.get_goal_name_id(row)\n            if control_id is None and goal_id is None:\n                rows_skipped_consecutive += 1\n                if rows_skipped_consecutive &lt; rows_skipped_consecutive_limit:\n                    continue\n                logger.debug(f'break: {row} {rows_skipped_consecutive}')\n                break\n            if control_id is None:\n                self._add_row(row, self.rows_missing_control_id)\n                continue\n            if goal_id is None:\n                self._add_row(row, self.rows_missing_goal_name_id)\n                continue\n            if self._is_filtered(row):\n                continue\n            yield row\n            rows_skipped_consecutive = 0\n\n    def _is_filtered(self, row) -&gt; bool:\n        \"\"\"Return True if row is to be skipped.\"\"\"\n        if self._column.filter_column is None:\n            return False\n        col = self._get_column_letter(self._column.filter_column)\n        value = self._work_sheet[col + str(row)].value\n        if value is None:\n            return False\n        if value.lower() != 'yes':\n            return False\n        self._add_row(row, self.rows_filtered)\n        return True\n\n    def get_goal_name_id(self, row: int, strict: bool = True) -&gt; str:\n        \"\"\"Get goal_name_id from work_sheet.\"\"\"\n        col = self._get_column_letter(self._column.goal_name_id)\n        value = self._work_sheet[col + str(row)].value\n        if value is None:\n            self._add_row(row, self.rows_missing_goal_name_id)\n        else:\n            value = str(value).strip()\n            if strict:\n                svalue = str(value).strip()\n                value = ''.join(str(svalue).split())\n                if value != svalue:\n                    self._add_row(row, self.rows_invalid_goal_name_id)\n        return value\n\n    def get_check_name_id(self, row: int, strict: bool = False) -&gt; str:\n        \"\"\"Get check_name_id from work_sheet.\"\"\"\n        return self.get_goal_name_id(row, strict)\n\n    def get_rule_name_id(self, row: int, strict: bool = False) -&gt; str:\n        \"\"\"Get rule_name_id from work_sheet.\"\"\"\n        col = self._get_column_letter(self._column.rule_name_id)\n        value = self._work_sheet[col + str(row)].value\n        if value is None:\n            self._add_row(row, self.rows_missing_rule_name_id)\n        else:\n            value = str(value).strip()\n            if strict:\n                svalue = str(value).strip()\n                value = ''.join(str(svalue).split())\n                if value != svalue:\n                    self._add_row(row, self.rows_invalid_rule_name_id)\n        return value\n\n    def get_parameter_usage(self, row: int) -&gt; str:\n        \"\"\"Get parameter_usage from work_sheet.\"\"\"\n        return self.get_goal_remarks(row)\n\n    def get_parameter_value_default(self, row: int) -&gt; str:\n        \"\"\"Get parameter_value_default from work_sheet.\"\"\"\n        col = self._get_column_letter(self._column.rename_values_alternatives)\n        value = self._work_sheet[col + str(row)].value\n        if value is not None:\n            value = str(value).split(',')[0].strip()\n        return value\n\n    def get_parameter_values(self, row: int) -&gt; str:\n        \"\"\"Get parameter_values from work_sheet.\"\"\"\n        col = self._get_column_letter(self._column.rename_values_alternatives)\n        value = self._work_sheet[col + str(row)].value\n        if value is None and self.get_parameter_name(row) is not None:\n            self._add_row(row, self.rows_missing_parameters_values)\n        # massage into comma separated list of values\n        else:\n            value = str(value).strip().replace(' ', '')\n            value = value.replace(',[]', '')\n            value = value.replace('[', '')\n            value = value.replace(']', '')\n            value = value.split(',')\n        return value\n\n    def _get_goal_text(self, row: int) -&gt; str:\n        \"\"\"Get goal_text from work_sheet.\"\"\"\n        col = self._get_column_letter(self._column.control_text)\n        goal_text = self._work_sheet[col + str(row)].value\n        # normalize &amp; tokenize\n        value = goal_text.replace('\\t', ' ')\n        return value\n\n    def _get_goal_text_tokens(self, row: int) -&gt; List[str]:\n        \"\"\"Get goal_text tokens from work_sheet.\"\"\"\n        goal_text = self._get_goal_text(row)\n        tokens = goal_text.split()\n        return tokens\n\n    def get_goal_remarks(self, row: int) -&gt; str:\n        \"\"\"Get goal_remarks from work_sheet.\"\"\"\n        tokens = self._get_goal_text_tokens(row)\n        # replace \"Check whether\" with \"Ensure\", if present\n        if tokens:\n            if tokens[0] == 'Check':\n                if len(tokens) &gt; 1:\n                    if tokens[1] == 'whether':\n                        tokens.pop(0)\n                tokens[0] = 'Ensure'\n        value = ' '.join(tokens)\n        return value\n\n    def get_controls(self, row: int) -&gt; Dict[str, List[str]]:\n        \"\"\"Produce dict of controls mapped to statements.\n\n        Example: {'au-2': ['(a)', '(d)'], 'au-12': [], 'si-4': ['(a)', '(b)', '(c)']}\n        \"\"\"\n        value = {}\n        for col in self._get_column_letter(self._column.nist_mappings):\n            control = self._work_sheet[col + str(row)].value\n            if control is None:\n                continue\n            # remove blanks\n            control = ''.join(control.split())\n            if len(control) &lt; 1 or control.lower() == 'none':\n                continue\n            # remove rhs of : inclusive\n            if ':' in control:\n                control = control.split(':')[0]\n            # remove alphabet parts of control &amp; accumulate in statements\n            control, statements = self._normalize_control(control)\n            # skip bogus control made up if dashes only\n            if len(control.replace('-', '')) == 0:\n                continue\n            if control not in value.keys():\n                value[control] = statements\n        if len(value.keys()) == 0:\n            self._add_row(row, self.rows_missing_controls)\n        logger.debug(f'row: {row} controls {value}')\n        return value\n\n    def get_component_name(self, row: int) -&gt; str:\n        \"\"\"Get component_name from work_sheet.\"\"\"\n        col = self._get_column_letter(self._column.resource_title)\n        value = self._work_sheet[col + str(row)].value\n        if value is None:\n            raise RuntimeError(f'row {row} col {col} missing component name')\n        return value.strip()\n\n    def get_parameter_name(self, row: int) -&gt; Tuple[str, str]:\n        \"\"\"Get parameter_name from work_sheet.\"\"\"\n        return self.get_parameter_name_and_description(row)[0]\n\n    def get_parameter_name_and_description(self, row: int) -&gt; Tuple[str, str]:\n        \"\"\"Get parameter_name and description from work_sheet.\"\"\"\n        name = None\n        description = None\n        col = self._get_column_letter(self._column.rename_parameter_opt_parm)\n        combined_values = self._work_sheet[col + str(row)].value\n        if combined_values is not None:\n            if '\\n' in combined_values:\n                parameter_parts = combined_values.split('\\n')\n            elif ' ' in combined_values:\n                parameter_parts = combined_values.split(' ', 1)\n            else:\n                parameter_parts = combined_values\n            if len(parameter_parts) == 2:\n                name = parameter_parts[1].strip()\n                description = parameter_parts[0].strip()\n                sname = str(name).strip()\n                name = sname.replace(' ', '_')\n                if name != sname:\n                    self._add_row(row, self.rows_invalid_parameter_name)\n            else:\n                logger.info(f'row {row} col {col} invalid value')\n        if name is None and self.get_parameter_value_default(row) is not None:\n            self._add_row(row, self.rows_missing_parameters)\n        value = name, description\n        return value\n\n    def _get_control_id(self, row: int) -&gt; int:\n        \"\"\"Get control_id from work_sheet.\"\"\"\n        col = self._get_column_letter(self._column.control_id)\n        value = self._work_sheet[col + str(row)].value\n        return value\n\n    def _get_column_letter(self, name: str) -&gt; str:\n        \"\"\"Get column letter.\"\"\"\n        value = self.map_name_to_letters[name]\n        if len(value) == 1:\n            value = value[0]\n        return value\n\n    def _map_columns(self) -&gt; None:\n        \"\"\"Map columns.\"\"\"\n        self.map_name_to_letters = {}\n        columns = self._work_sheet.max_column\n        for column in range(1, columns + 1):\n            cell_value = self._cell_value(1, column)\n            if cell_value is None:\n                continue\n            cell_tokens = cell_value.split()\n            normalized_cell_value = ' '.join(cell_tokens)\n            # find columns of interest\n            if self._column.control_id in cell_tokens:\n                self._add_column(self._column.control_id, column, 1)\n            elif self._column.control_text in cell_tokens:\n                self._add_column(self._column.control_text, column, 1)\n            elif self._column.goal_name_id in cell_tokens:\n                self._add_column(self._column.goal_name_id, column, 1)\n            elif self._column.goal_version in cell_tokens:\n                self._add_column(self._column.goal_version, column, 1)\n            elif self._column.rule_name_id in cell_tokens:\n                self._add_column(self._column.rule_name_id, column, 1)\n            elif self._column.rule_version in cell_tokens:\n                self._add_column(self._column.rule_version, column, 1)\n            # parameters and alternatives (exact tokens match)\n            elif cell_tokens == self._column.tokens_parameter_opt_parm:\n                self._add_column(self._column.rename_parameter_opt_parm, column, 1)\n            elif cell_tokens == self._column.tokens_values_alternatives:\n                self._add_column(self._column.rename_values_alternatives, column, 1)\n            # filter column (exact string match)\n            elif self._column.filter_column == normalized_cell_value:\n                self._add_column(self._column.filter_column, column, 1)\n            # nist mappings and resource title (multiple columns match)\n            elif is_ordered_sublist(self._column.tokens_nist_mappings, cell_tokens):\n                self._add_column(self._column.nist_mappings, column, 0)\n            elif self._column.resource_title in cell_tokens:\n                self._add_column(self._column.resource_title, column, 0)\n        # insure expected columns found\n        for name in [self._column.control_id,\n                     self._column.control_text,\n                     self._column.rule_name_id,\n                     self._column.rule_version,\n                     self._column.goal_name_id,\n                     self._column.goal_version,\n                     self._column.nist_mappings,\n                     self._column.resource_title,\n                     self._column.rename_parameter_opt_parm,\n                     self._column.rename_values_alternatives]:\n            if name not in self.map_name_to_letters.keys():\n                raise RuntimeError(f'missing column {name}')\n\n    def _add_column(self, name: str, column: int, limit: int) -&gt; None:\n        \"\"\"Add column.\"\"\"\n        if name not in self.map_name_to_letters:\n            self.map_name_to_letters[name] = []\n        if limit &gt; 0 and len(self.map_name_to_letters[name]) == limit:\n            raise RuntimeError(f'duplicate column {name} {get_column_letter(column)}')\n        self.map_name_to_letters[name].append(get_column_letter(column))\n\n    def _cell_value(self, row: int, col: int) -&gt; Any:\n        \"\"\"Get value for cell, adjusting for merged cells.\"\"\"\n        cell = self._work_sheet.cell(row, col)\n        retval = cell.value\n        if isinstance(cell, MergedCell):\n            # cell is merged\n            for mc_range in self._work_sheet.merged_cells.ranges:\n                coord = get_column_letter(col) + str(row)\n                if coord in mc_range:\n                    retval = mc_range.start_cell.value\n        return retval\n\n    def _normalize_control(self, control: str) -&gt; Tuple[str, List[str]]:\n        \"\"\"Remove parenthesized characters from controls.\"\"\"\n        statements = []\n        for i in string.ascii_lowercase:\n            needle = '(' + i + ')'\n            if needle in control:\n                statements.append(needle)\n                control = control.replace(needle, '')\n        control = control.lower()\n        return control, statements\n\n    def _add_row(self, row: int, account: List[int]) -&gt; None:\n        \"\"\"Add row to accounting list of rows.\"\"\"\n        if row not in account:\n            account.append(row)\n\n    def report_issues(self) -&gt; None:\n        \"\"\"Report issues.\"\"\"\n        if self.rows_missing_control_id:\n            logger.info(f'rows missing control_id: {self.rows_missing_control_id}')\n        if self.rows_invalid_goal_name_id:\n            logger.info(f'rows invalid goal_name_id: {self.rows_invalid_goal_name_id}')\n        if self.rows_missing_rule_name_id:\n            logger.info(f'rows missing rule_name_id: {self.rows_missing_rule_name_id}')\n        if self.rows_invalid_rule_name_id:\n            logger.info(f'rows invalid rule_name_id: {self.rows_invalid_rule_name_id}')\n        if self.rows_invalid_parameter_name:\n            logger.info(f'rows invalid parameter_name: {self.rows_invalid_parameter_name}')\n        if self.rows_missing_controls:\n            logger.info(f'rows missing controls: {self.rows_missing_controls}')\n        if self.rows_missing_parameters:\n            logger.info(f'rows missing parameters: {self.rows_missing_parameters}')\n        if self.rows_missing_parameters_values:\n            logger.info(f'rows missing parameters values: {self.rows_missing_parameters_values}')\n        if self.rows_filtered:\n            logger.info(f'rows filtered: {self.rows_filtered}')\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.by_check","title":"<code>by_check = 'by-check'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.by_control","title":"<code>by_control = 'by-control'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.by_goal","title":"<code>by_goal = 'by-goal'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.by_rule","title":"<code>by_rule = 'by-rule'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.profile_type","title":"<code>profile_type: str</code>  <code>property</code>","text":"<p>Profile type.</p>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.profile_types","title":"<code>profile_types = [by_goal, by_rule, by_control, by_check]</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.__init__","title":"<code>__init__()</code>","text":"<p>Initialize.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self._column = Column()\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.configure","title":"<code>configure(task)</code>","text":"<p>Configure.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def configure(self, task: TaskBase) -&gt; bool:\n    \"\"\"Configure.\"\"\"\n    if not task._config:\n        logger.warning('config missing')\n        return False\n    # config verbosity\n    quiet = task._config.get('quiet', False)\n    task._verbose = not quiet\n    # required for component-definition\n    if not self.configure_cd(task):\n        return False\n    # required for profile\n    if not self.configure_profile(task):\n        return False\n    # optional\n    self._column.filter_column = task._config.get('filter-column', None)\n    # config spread sheet\n    spread_sheet = task._config.get('spread-sheet-file')\n    if spread_sheet is None:\n        logger.warning('config missing \"spread-sheet\"')\n        return False\n    if not pathlib.Path(spread_sheet).exists():\n        logger.warning('\"spread-sheet\" not found')\n        return False\n    sheet_name = task._config.get('work-sheet-name')\n    if sheet_name is None:\n        logger.warning('config missing \"work-sheet-name\"')\n        return False\n    # announce spreadsheet\n    if task._verbose:\n        logger.info(f'input: {spread_sheet}')\n    # get profile type\n    if task.name == 'xlsx-to-oscal-profile':\n        self._profile_type = task._config.get('profile-type', self.profile_types[0])\n        if self._profile_type not in self.profile_types:\n            logger.warning(f'invalid \"profile-type\" {self._profile_type} ')\n            return False\n    else:\n        self._profile_type = None\n    # load spread sheet\n    self.load(spread_sheet, sheet_name)\n    return True\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.configure_cd","title":"<code>configure_cd(task)</code>","text":"<p>Configure cd.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def configure_cd(self, task: TaskBase) -&gt; bool:\n    \"\"\"Configure cd.\"\"\"\n    if task.name == 'xlsx-to-oscal-cd':\n        catalog_file = task._config.get('catalog-file')\n        if catalog_file is None:\n            logger.warning('config missing \"catalog-file\"')\n            return False\n        try:\n            catalog = Catalog.oscal_read(pathlib.Path(catalog_file))\n            logger.debug(f'catalog: {catalog_file}')\n        except Exception as e:  # pragma: no cover\n            raise TrestleError(f'Error loading catalog {catalog_file}: {e}')\n        task.catalog_interface = CatalogInterface(catalog)\n    return True\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.configure_profile","title":"<code>configure_profile(task)</code>","text":"<p>Configure profile.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def configure_profile(self, task: TaskBase) -&gt; bool:\n    \"\"\"Configure profile.\"\"\"\n    if task.name == 'xlsx-to-oscal-profile':\n        profile_title = task._config.get('profile-title')\n        if profile_title is None:\n            logger.warning('config missing \"profile-title\"')\n            return False\n        spread_sheet_url = task._config.get('spread-sheet-url')\n        if spread_sheet_url is None:\n            logger.warning('config missing \"spread-sheet-url\"')\n            return False\n    return True\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_check_name_id","title":"<code>get_check_name_id(row, strict=False)</code>","text":"<p>Get check_name_id from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_check_name_id(self, row: int, strict: bool = False) -&gt; str:\n    \"\"\"Get check_name_id from work_sheet.\"\"\"\n    return self.get_goal_name_id(row, strict)\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_component_name","title":"<code>get_component_name(row)</code>","text":"<p>Get component_name from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_component_name(self, row: int) -&gt; str:\n    \"\"\"Get component_name from work_sheet.\"\"\"\n    col = self._get_column_letter(self._column.resource_title)\n    value = self._work_sheet[col + str(row)].value\n    if value is None:\n        raise RuntimeError(f'row {row} col {col} missing component name')\n    return value.strip()\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_controls","title":"<code>get_controls(row)</code>","text":"<p>Produce dict of controls mapped to statements.</p> <p>Example: {'au-2': ['(a)', '(d)'], 'au-12': [], 'si-4': ['(a)', '(b)', '(c)']}</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_controls(self, row: int) -&gt; Dict[str, List[str]]:\n    \"\"\"Produce dict of controls mapped to statements.\n\n    Example: {'au-2': ['(a)', '(d)'], 'au-12': [], 'si-4': ['(a)', '(b)', '(c)']}\n    \"\"\"\n    value = {}\n    for col in self._get_column_letter(self._column.nist_mappings):\n        control = self._work_sheet[col + str(row)].value\n        if control is None:\n            continue\n        # remove blanks\n        control = ''.join(control.split())\n        if len(control) &lt; 1 or control.lower() == 'none':\n            continue\n        # remove rhs of : inclusive\n        if ':' in control:\n            control = control.split(':')[0]\n        # remove alphabet parts of control &amp; accumulate in statements\n        control, statements = self._normalize_control(control)\n        # skip bogus control made up if dashes only\n        if len(control.replace('-', '')) == 0:\n            continue\n        if control not in value.keys():\n            value[control] = statements\n    if len(value.keys()) == 0:\n        self._add_row(row, self.rows_missing_controls)\n    logger.debug(f'row: {row} controls {value}')\n    return value\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_goal_name_id","title":"<code>get_goal_name_id(row, strict=True)</code>","text":"<p>Get goal_name_id from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_goal_name_id(self, row: int, strict: bool = True) -&gt; str:\n    \"\"\"Get goal_name_id from work_sheet.\"\"\"\n    col = self._get_column_letter(self._column.goal_name_id)\n    value = self._work_sheet[col + str(row)].value\n    if value is None:\n        self._add_row(row, self.rows_missing_goal_name_id)\n    else:\n        value = str(value).strip()\n        if strict:\n            svalue = str(value).strip()\n            value = ''.join(str(svalue).split())\n            if value != svalue:\n                self._add_row(row, self.rows_invalid_goal_name_id)\n    return value\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_goal_remarks","title":"<code>get_goal_remarks(row)</code>","text":"<p>Get goal_remarks from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_goal_remarks(self, row: int) -&gt; str:\n    \"\"\"Get goal_remarks from work_sheet.\"\"\"\n    tokens = self._get_goal_text_tokens(row)\n    # replace \"Check whether\" with \"Ensure\", if present\n    if tokens:\n        if tokens[0] == 'Check':\n            if len(tokens) &gt; 1:\n                if tokens[1] == 'whether':\n                    tokens.pop(0)\n            tokens[0] = 'Ensure'\n    value = ' '.join(tokens)\n    return value\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name","title":"<code>get_parameter_name(row)</code>","text":"<p>Get parameter_name from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_parameter_name(self, row: int) -&gt; Tuple[str, str]:\n    \"\"\"Get parameter_name from work_sheet.\"\"\"\n    return self.get_parameter_name_and_description(row)[0]\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_name_and_description","title":"<code>get_parameter_name_and_description(row)</code>","text":"<p>Get parameter_name and description from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_parameter_name_and_description(self, row: int) -&gt; Tuple[str, str]:\n    \"\"\"Get parameter_name and description from work_sheet.\"\"\"\n    name = None\n    description = None\n    col = self._get_column_letter(self._column.rename_parameter_opt_parm)\n    combined_values = self._work_sheet[col + str(row)].value\n    if combined_values is not None:\n        if '\\n' in combined_values:\n            parameter_parts = combined_values.split('\\n')\n        elif ' ' in combined_values:\n            parameter_parts = combined_values.split(' ', 1)\n        else:\n            parameter_parts = combined_values\n        if len(parameter_parts) == 2:\n            name = parameter_parts[1].strip()\n            description = parameter_parts[0].strip()\n            sname = str(name).strip()\n            name = sname.replace(' ', '_')\n            if name != sname:\n                self._add_row(row, self.rows_invalid_parameter_name)\n        else:\n            logger.info(f'row {row} col {col} invalid value')\n    if name is None and self.get_parameter_value_default(row) is not None:\n        self._add_row(row, self.rows_missing_parameters)\n    value = name, description\n    return value\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_usage","title":"<code>get_parameter_usage(row)</code>","text":"<p>Get parameter_usage from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_parameter_usage(self, row: int) -&gt; str:\n    \"\"\"Get parameter_usage from work_sheet.\"\"\"\n    return self.get_goal_remarks(row)\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_value_default","title":"<code>get_parameter_value_default(row)</code>","text":"<p>Get parameter_value_default from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_parameter_value_default(self, row: int) -&gt; str:\n    \"\"\"Get parameter_value_default from work_sheet.\"\"\"\n    col = self._get_column_letter(self._column.rename_values_alternatives)\n    value = self._work_sheet[col + str(row)].value\n    if value is not None:\n        value = str(value).split(',')[0].strip()\n    return value\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_parameter_values","title":"<code>get_parameter_values(row)</code>","text":"<p>Get parameter_values from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_parameter_values(self, row: int) -&gt; str:\n    \"\"\"Get parameter_values from work_sheet.\"\"\"\n    col = self._get_column_letter(self._column.rename_values_alternatives)\n    value = self._work_sheet[col + str(row)].value\n    if value is None and self.get_parameter_name(row) is not None:\n        self._add_row(row, self.rows_missing_parameters_values)\n    # massage into comma separated list of values\n    else:\n        value = str(value).strip().replace(' ', '')\n        value = value.replace(',[]', '')\n        value = value.replace('[', '')\n        value = value.replace(']', '')\n        value = value.split(',')\n    return value\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.get_rule_name_id","title":"<code>get_rule_name_id(row, strict=False)</code>","text":"<p>Get rule_name_id from work_sheet.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_rule_name_id(self, row: int, strict: bool = False) -&gt; str:\n    \"\"\"Get rule_name_id from work_sheet.\"\"\"\n    col = self._get_column_letter(self._column.rule_name_id)\n    value = self._work_sheet[col + str(row)].value\n    if value is None:\n        self._add_row(row, self.rows_missing_rule_name_id)\n    else:\n        value = str(value).strip()\n        if strict:\n            svalue = str(value).strip()\n            value = ''.join(str(svalue).split())\n            if value != svalue:\n                self._add_row(row, self.rows_invalid_rule_name_id)\n    return value\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.load","title":"<code>load(spread_sheet, sheet_name)</code>","text":"<p>Load.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def load(self, spread_sheet: str, sheet_name: str) -&gt; None:\n    \"\"\"Load.\"\"\"\n    self._spread_sheet = spread_sheet\n    self._sheet_name = sheet_name\n    self._wb = load_workbook(self._spread_sheet)\n    self._work_sheet = self._wb[self._sheet_name]\n    self._map_name_to_letters = {}\n    # accumulators\n    self.rows_missing_control_id = []\n    self.rows_missing_goal_name_id = []\n    self.rows_invalid_goal_name_id = []\n    self.rows_missing_rule_name_id = []\n    self.rows_invalid_rule_name_id = []\n    self.rows_invalid_parameter_name = []\n    self.rows_missing_controls = []\n    self.rows_missing_parameters = []\n    self.rows_missing_parameters_values = []\n    self.rows_filtered = []\n    # map columns\n    self._map_columns()\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.print_info","title":"<code>print_info(name, oscal_name)</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def print_info(self, name, oscal_name) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    logger.info(f'Help information for {name} task.')\n    logger.info('')\n    logger.info(f'Purpose: From spread sheet and catalog produce OSCAL {oscal_name} file.')\n    logger.info('')\n    logger.info(f'Configuration flags sit under [task.{name}]:')\n    if oscal_name == 'component_definition':\n        text1 = '  catalog-file      = '\n        text2 = '(required) the path of the OSCAL catalog file.'\n        logger.info(text1 + text2)\n    text1 = '  spread-sheet-file = '\n    text2 = '(required) the path of the spread sheet file.'\n    logger.info(text1 + text2)\n    text1 = '  work-sheet-name   = '\n    text2 = '(required) the name of the work sheet in the spread sheet file.'\n    logger.info(text1 + text2)\n    for line in self._column.help_list:\n        logger.info(line)\n    text1 = '  output-dir        = '\n    text2 = '(required) the path of the output directory for synthesized OSCAL .json files.'\n    logger.info(text1 + text2)\n    text1 = '  output-overwrite  = '\n    text2 = '(optional) true [default] or false; replace existing output when true.'\n    logger.info(text1 + text2)\n    text1 = '  filter-column     = '\n    text2 = '(optional) column heading of yes/no values; process only \"yes\" rows.'\n    logger.info(text1 + text2)\n    text1 = '  profile-type      = '\n    text2 = f'(optional) one of {self.profile_types}'\n    logger.info(text1 + text2)\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.report_issues","title":"<code>report_issues()</code>","text":"<p>Report issues.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def report_issues(self) -&gt; None:\n    \"\"\"Report issues.\"\"\"\n    if self.rows_missing_control_id:\n        logger.info(f'rows missing control_id: {self.rows_missing_control_id}')\n    if self.rows_invalid_goal_name_id:\n        logger.info(f'rows invalid goal_name_id: {self.rows_invalid_goal_name_id}')\n    if self.rows_missing_rule_name_id:\n        logger.info(f'rows missing rule_name_id: {self.rows_missing_rule_name_id}')\n    if self.rows_invalid_rule_name_id:\n        logger.info(f'rows invalid rule_name_id: {self.rows_invalid_rule_name_id}')\n    if self.rows_invalid_parameter_name:\n        logger.info(f'rows invalid parameter_name: {self.rows_invalid_parameter_name}')\n    if self.rows_missing_controls:\n        logger.info(f'rows missing controls: {self.rows_missing_controls}')\n    if self.rows_missing_parameters:\n        logger.info(f'rows missing parameters: {self.rows_missing_parameters}')\n    if self.rows_missing_parameters_values:\n        logger.info(f'rows missing parameters values: {self.rows_missing_parameters_values}')\n    if self.rows_filtered:\n        logger.info(f'rows filtered: {self.rows_filtered}')\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.XlsxHelper.row_generator","title":"<code>row_generator()</code>","text":"<p>Generate rows until control_id is None.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def row_generator(self) -&gt; Iterator[int]:\n    \"\"\"Generate rows until control_id is None.\"\"\"\n    row = 1\n    rows_skipped_consecutive = 0\n    # assume no more data when 100 consecutve rows no control id\n    rows_skipped_consecutive_limit = 100\n    while True:\n        row = row + 1\n        control_id = self._get_control_id(row)\n        goal_id = self.get_goal_name_id(row)\n        if control_id is None and goal_id is None:\n            rows_skipped_consecutive += 1\n            if rows_skipped_consecutive &lt; rows_skipped_consecutive_limit:\n                continue\n            logger.debug(f'break: {row} {rows_skipped_consecutive}')\n            break\n        if control_id is None:\n            self._add_row(row, self.rows_missing_control_id)\n            continue\n        if goal_id is None:\n            self._add_row(row, self.rows_missing_goal_name_id)\n            continue\n        if self._is_filtered(row):\n            continue\n        yield row\n        rows_skipped_consecutive = 0\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/xlsx_helper/#trestle.tasks.xlsx_helper.get_trestle_version","title":"<code>get_trestle_version()</code>","text":"<p>Get trestle version wrapper.</p> Source code in <code>trestle/tasks/xlsx_helper.py</code> <pre><code>def get_trestle_version() -&gt; str:\n    \"\"\"Get trestle version wrapper.\"\"\"\n    return __version__\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/","title":"trestle.tasks.xlsx_to_oscal_cd","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd","title":"<code>trestle.tasks.xlsx_to_oscal_cd</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.key_sep","title":"<code>key_sep = '|'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.sep","title":"<code>sep = '|'</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition","title":"<code>XlsxToOscalComponentDefinition</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to create OSCAL ComponentDefinition json.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code> <pre><code>class XlsxToOscalComponentDefinition(TaskBase):\n    \"\"\"\n    Task to create OSCAL ComponentDefinition json.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'xlsx-to-oscal-cd'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task xlsx-to-oscal-cd.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n        self.xlsx_helper = XlsxHelper()\n        self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n\n    def set_timestamp(self, timestamp: str) -&gt; None:\n        \"\"\"Set the timestamp.\"\"\"\n        self._timestamp = timestamp\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        self.xlsx_helper.print_info(self.name, 'component_definition')\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        return TaskOutcome('simulated-success')\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an executed outcome.\"\"\"\n        try:\n            return self._execute()\n        except Exception:\n            logger.info(traceback.format_exc())\n            return TaskOutcome('failure')\n\n    def _execute(self) -&gt; TaskOutcome:\n        \"\"\"Execute path core.\"\"\"\n        if not self.xlsx_helper.configure(self):\n            return TaskOutcome('failure')\n        # config output\n        odir = self._config.get('output-dir')\n        opth = pathlib.Path(odir)\n        self._overwrite = self._config.getboolean('output-overwrite', True)\n        # insure output dir exists\n        opth.mkdir(exist_ok=True, parents=True)\n        # calculate output file name &amp; check writability\n        oname = 'component-definition.json'\n        ofile = opth / oname\n        if not self._overwrite and pathlib.Path(ofile).exists():\n            logger.warning(f'output: {ofile} already exists')\n            return TaskOutcome('failure')\n        # initialize\n        self.defined_components = {}\n        # roles, responsible_roles, parties, responsible parties\n        party_uuid_01 = str(uuid.uuid4())\n        party_uuid_02 = str(uuid.uuid4())\n        party_uuid_03 = str(uuid.uuid4())\n        roles = self._build_roles()\n        responsible_roles = self._build_responsible_roles(party_uuid_01, party_uuid_02, party_uuid_03)\n        parties = self._build_parties(party_uuid_01, party_uuid_02, party_uuid_03)\n        responsible_parties = self._build_responsible_parties(party_uuid_01, party_uuid_02, party_uuid_03)\n        # process each row of spread sheet\n        self._process_rows(responsible_roles)\n        # create OSCAL ComponentDefinition\n        metadata = Metadata(\n            title='Component definition for ' + self._get_catalog_title() + ' profiles',\n            last_modified=self._timestamp,\n            oscal_version=OSCAL_VERSION,\n            version=get_trestle_version(),\n            roles=roles,\n            parties=parties,\n            responsible_parties=responsible_parties\n        )\n        component_definition = ComponentDefinition(\n            uuid=str(uuid.uuid4()),\n            metadata=metadata,\n            components=list(self.defined_components.values()),\n        )\n        # write OSCAL ComponentDefinition to file\n        if self._verbose:\n            logger.info(f'output: {ofile}')\n        component_definition.oscal_write(pathlib.Path(ofile))\n        # issues\n        self._report_issues()\n        return TaskOutcome('success')\n\n    def _process_rows(self, responsible_roles: List[ResponsibleRole]) -&gt; None:\n        \"\"\"Process spread sheet rows.\"\"\"\n        ci_map = {}\n        for row in self.xlsx_helper.row_generator():\n            # quit when first row with no goal_id encountered\n            goal_name_id = self.xlsx_helper.get_goal_name_id(row)\n            controls = self.xlsx_helper.get_controls(row)\n            if len(controls.keys()) == 0:\n                continue\n            # component\n            component_name = self.xlsx_helper.get_component_name(row)\n            component_type = 'Service'\n            defined_component = self._get_defined_component(component_name, component_type)\n            # parameter\n            parameter_name, parameter_description = self.xlsx_helper.get_parameter_name_and_description(row)\n            # control implementations\n            source = self._get_catalog_url()\n            description = component_name + ' implemented controls for ' + self._get_catalog_title(\n            ) + '. It includes assessment asset configuration for CICD.'\n            key = source + key_sep + description\n            control_implementation = ci_map.get(key)\n            if not control_implementation:\n                ci_map[key] = ControlImplementation(\n                    uuid=str(uuid.uuid4()),\n                    source=source,\n                    description=description,\n                    implemented_requirements=[],\n                )\n                control_implementation = ci_map[key]\n                if defined_component.control_implementations is None:\n                    defined_component.control_implementations = []\n                defined_component.control_implementations.append(control_implementation)\n            # implemented requirements\n            self._add_implemented_requirements(\n                row, control_implementation, controls, component_name, parameter_name, responsible_roles, goal_name_id\n            )\n            # keep alternative parameter values at control implementation level\n            parameter_values = self.xlsx_helper.get_parameter_values(row)\n            self._add_set_parameter_values(parameter_name, parameter_values, control_implementation)\n\n    def _add_implemented_requirements(\n        self,\n        row: int,\n        control_implementation: ControlImplementation,\n        controls: Dict[str, List[str]],\n        component_name: str,\n        parameter_name: str,\n        responsible_roles: List[ResponsibleRole],\n        goal_name_id: str\n    ) -&gt; None:\n        \"\"\"Add implemented requirements.\"\"\"\n        goal_remarks = self.xlsx_helper.get_goal_remarks(row)\n        parameter_value_default = self.xlsx_helper.get_parameter_value_default(row)\n        for control in controls.keys():\n            control_uuid = str(uuid.uuid4())\n            prop1 = Property(\n                name='goal_name_id',\n                class_=self._get_class_for_property_name('goal_name_id'),\n                value=goal_name_id,\n                ns=self._get_namespace(),\n                remarks=str(goal_remarks)\n            )\n            prop2 = Property(\n                name='goal_version',\n                class_=self._get_class_for_property_name('goal_version'),\n                value=self._get_goal_version(),\n                ns=self._get_namespace(),\n                remarks=str(goal_name_id)\n            )\n            props = [prop1, prop2]\n            control_id, _ = self.catalog_interface.get_control_id_and_status(control)\n            if not control_id:\n                logger.info(f'row {row} control {control} not found in catalog')\n                control_id = control\n            # implemented_requirement\n            implemented_requirement = ImplementedRequirement(\n                uuid=control_uuid,\n                description=control,\n                props=props,\n                control_id=control_id,\n                responsible_roles=responsible_roles,\n            )\n            # add statements\n            self._add_statements(row, control, controls, component_name, implemented_requirement)\n            # add set_parameter\n            self._add_set_parameter_default(parameter_name, parameter_value_default, implemented_requirement)\n            # implemented_requirements\n            control_implementation.implemented_requirements.append(implemented_requirement)\n\n    def _add_statements(\n        self,\n        row: int,\n        control: str,\n        controls: Dict[str, List[str]],\n        component_name: str,\n        implemented_requirement: ImplementedRequirement\n    ) -&gt; None:\n        \"\"\"Add statements.\"\"\"\n        control_statements = controls[control]\n        if control_statements:\n            statements = []\n            for control_statement in control_statements:\n                statement_id = control + control_statement\n                if any(i in control for i in '()'):\n                    control = control.replace('(', '_')\n                    control = control.replace(')', '')\n                    logger.info(f'row {row} control {control} edited to remove parentheses')\n                statement = Statement(\n                    statement_id=control,\n                    uuid=str(uuid.uuid4()),\n                    description=f'{component_name} implements {statement_id}'\n                )\n                statements.append(statement)\n            implemented_requirement.statements = statements\n\n    def _add_set_parameter_values(\n        self, parameter_name: str, parameter_values: str, control_implementation: ControlImplementation\n    ) -&gt; None:\n        \"\"\"Add set parameter values (the set of choices).\"\"\"\n        if parameter_name is not None:\n            parameter_name = parameter_name.replace(' ', '_')\n            if parameter_values is not None:\n                set_parameters = [SetParameter(param_id=parameter_name, values=parameter_values)]\n                if control_implementation.set_parameters is None:\n                    control_implementation.set_parameters = []\n                # set_parameters is a list\n                control_implementation.set_parameters.extend(set_parameters)\n\n    def _add_set_parameter_default(\n        self, parameter_name: str, parameter_value_default: str, implemented_requirement: ImplementedRequirement\n    ) -&gt; None:\n        \"\"\"Add set parameter default (the \"recommended\" value).\"\"\"\n        if parameter_name is not None:\n            parameter_name = parameter_name.replace(' ', '_')\n            if parameter_value_default is not None:\n                if implemented_requirement.set_parameters is None:\n                    implemented_requirement.set_parameters = []\n                values = [parameter_value_default]\n                set_parameter = SetParameter(param_id=parameter_name, values=values)\n                set_parameters = [set_parameter]\n                # set_parameters is a list\n                implemented_requirement.set_parameters.extend(set_parameters)\n\n    def _get_defined_component(self, component_name: str, component_type: str) -&gt; DefinedComponent:\n        \"\"\"Get defined component.\"\"\"\n        key = component_name + key_sep + component_type\n        defined_component = self.defined_components.get(key)\n        if not defined_component:\n            # create new component\n            component_title = component_name\n            component_description = component_name\n            defined_component = DefinedComponent(\n                uuid=str(uuid.uuid4()),\n                description=component_description,\n                title=component_title,\n                type=component_type,\n            )\n            self.defined_components[key] = defined_component\n        return defined_component\n\n    def _build_roles(self) -&gt; List[Role]:\n        \"\"\"Build roles.\"\"\"\n        value = [\n            Role(id='prepared-by', title='Indicates the organization that created this content.'),\n            Role(id='prepared-for', title='Indicates the organization for which this content was created..'),\n            Role(\n                id='content-approver',\n                title='Indicates the organization responsible for all content represented in the \"document\".'\n            ),\n        ]\n        return value\n\n    def _build_responsible_roles(self, party_uuid_01: str, party_uuid_02: str,\n                                 party_uuid_03: str) -&gt; List[ResponsibleRole]:\n        \"\"\"Build responsible roles.\"\"\"\n        role_prepared_by = ResponsibleRole(role_id='prepared-by', party_uuids=[party_uuid_01])\n        role_prepared_for = ResponsibleRole(role_id='prepared-for', party_uuids=[party_uuid_02, party_uuid_03])\n        role_content_approver = ResponsibleRole(role_id='content-approver', party_uuids=[party_uuid_01])\n        value = [\n            role_prepared_by,\n            role_prepared_for,\n            role_content_approver,\n        ]\n        return value\n\n    def _build_parties(self, party_uuid_01: str, party_uuid_02: str, party_uuid_03: str) -&gt; List[Party]:\n        \"\"\"Build parties.\"\"\"\n        value = [\n            Party(uuid=party_uuid_01, type='organization', name=self._get_org_name(), remarks=self._get_org_remarks()),\n            Party(\n                uuid=party_uuid_02,\n                type='organization',\n                name='Customer',\n                remarks='organization to be customized at account creation only for their Component Definition'\n            ),\n            Party(\n                uuid=party_uuid_03,\n                type='organization',\n                name='ISV',\n                remarks='organization to be customized at ISV subscription only for their Component Definition'\n            ),\n        ]\n        return value\n\n    def _build_responsible_parties(self, party_uuid_01: str, party_uuid_02: str,\n                                   party_uuid_03: str) -&gt; List[ResponsibleParty]:\n        \"\"\"Build responsible parties.\"\"\"\n        prepared_by = ResponsibleParty(role_id='prepared-by', party_uuids=[party_uuid_01])\n        prepared_for = ResponsibleParty(role_id='prepared-for', party_uuids=[party_uuid_02, party_uuid_03])\n        content_approver = ResponsibleParty(role_id='content-approver', party_uuids=[party_uuid_01])\n        value = [\n            prepared_by,\n            prepared_for,\n            content_approver,\n        ]\n        return value\n\n    def _report_issues(self) -&gt; None:\n        \"\"\"Report issues.\"\"\"\n        self.xlsx_helper.report_issues()\n\n    def _get_org_name(self) -&gt; str:\n        \"\"\"Get org-name from config.\"\"\"\n        value = self._config.get('org-name')\n        logger.debug(f'org-name: {value}')\n        return value\n\n    def _get_org_remarks(self) -&gt; str:\n        \"\"\"Get org-remarks from config.\"\"\"\n        value = self._config.get('org-remarks')\n        logger.debug(f'org-remarks: {value}')\n        return value\n\n    def _get_class_for_property_name(self, property_name: str) -&gt; str:\n        \"\"\"Get class for property-name from config.\"\"\"\n        value = None\n        data = self._config.get('property-name-to-class')\n        if data is not None:\n            for item in data.split(','):\n                item = item.strip()\n                parts = item.split(':')\n                if len(parts) != 2 or parts[0] != property_name:\n                    continue\n                value = parts[1]\n                break\n        logger.debug(f'property-name-to-class: {property_name} -&gt; {value}')\n        return value\n\n    def _get_namespace(self) -&gt; str:\n        \"\"\"Get namespace from config.\"\"\"\n        value = self._config.get('namespace')\n        logger.debug(f'namespace: {value}')\n        return value\n\n    def _get_catalog_url(self) -&gt; str:\n        \"\"\"Get catalog url from config.\"\"\"\n        value = self._config.get('catalog-url')\n        logger.debug(f'catalog-url: {value}')\n        return value\n\n    def _get_catalog_title(self) -&gt; str:\n        \"\"\"Get catalog title from config.\"\"\"\n        value = self._config.get('catalog-title')\n        logger.debug(f'catalog-title: {value}')\n        return value\n\n    def _get_goal_version(self) -&gt; str:\n        \"\"\"Fix goal_version at 1.0.\"\"\"\n        return '1.0'\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.name","title":"<code>name = 'xlsx-to-oscal-cd'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.xlsx_helper","title":"<code>xlsx_helper = XlsxHelper()</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task xlsx-to-oscal-cd.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task xlsx-to-oscal-cd.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n    self.xlsx_helper = XlsxHelper()\n    self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.execute","title":"<code>execute()</code>","text":"<p>Provide an executed outcome.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an executed outcome.\"\"\"\n    try:\n        return self._execute()\n    except Exception:\n        logger.info(traceback.format_exc())\n        return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    self.xlsx_helper.print_info(self.name, 'component_definition')\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.set_timestamp","title":"<code>set_timestamp(timestamp)</code>","text":"<p>Set the timestamp.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code> <pre><code>def set_timestamp(self, timestamp: str) -&gt; None:\n    \"\"\"Set the timestamp.\"\"\"\n    self._timestamp = timestamp\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd.XlsxToOscalComponentDefinition.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_cd.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    return TaskOutcome('simulated-success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_cd/#trestle.tasks.xlsx_to_oscal_cd-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/","title":"trestle.tasks.xlsx_to_oscal_profile","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile","title":"<code>trestle.tasks.xlsx_to_oscal_profile</code>","text":"<p>OSCAL transformation tasks.</p>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile-classes","title":"Classes","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile","title":"<code>XlsxToOscalProfile</code>","text":"<p>               Bases: <code>TaskBase</code></p> <p>Task to create OSCAL Profile json.</p> <p>Attributes:</p> Name Type Description <code>name</code> <p>Name of the task.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code> <pre><code>class XlsxToOscalProfile(TaskBase):\n    \"\"\"\n    Task to create OSCAL Profile json.\n\n    Attributes:\n        name: Name of the task.\n    \"\"\"\n\n    name = 'xlsx-to-oscal-profile'\n\n    def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n        \"\"\"\n        Initialize trestle task xlsx-to-oscal-profile.\n\n        Args:\n            config_object: Config section associated with the task.\n        \"\"\"\n        super().__init__(config_object)\n        self.xlsx_helper = XlsxHelper()\n        self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n\n    def set_timestamp(self, timestamp: str) -&gt; None:\n        \"\"\"Set the timestamp.\"\"\"\n        self._timestamp = timestamp\n\n    def print_info(self) -&gt; None:\n        \"\"\"Print the help string.\"\"\"\n        self.xlsx_helper.print_info(self.name, 'profile')\n\n    def simulate(self) -&gt; TaskOutcome:\n        \"\"\"Provide a simulated outcome.\"\"\"\n        return TaskOutcome('simulated-success')\n\n    def execute(self) -&gt; TaskOutcome:\n        \"\"\"Provide an executed outcome.\"\"\"\n        try:\n            return self._execute()\n        except Exception:\n            logger.info(traceback.format_exc())\n            return TaskOutcome('failure')\n\n    def _execute(self) -&gt; TaskOutcome:\n        \"\"\"Execute path core.\"\"\"\n        if not self.xlsx_helper.configure(self):\n            return TaskOutcome('failure')\n        # config output\n        odir = self._config.get('output-dir')\n        opth = pathlib.Path(odir)\n        self._overwrite = self._config.getboolean('output-overwrite', True)\n        # insure output dir exists\n        opth.mkdir(exist_ok=True, parents=True)\n        # calculate output file name &amp; check writability\n        oname = 'profile.json'\n        ofile = opth / oname\n        if not self._overwrite and pathlib.Path(ofile).exists():\n            logger.error(f'output: {ofile} already exists')\n            return TaskOutcome('failure')\n        # create OSCAL Profile\n        metadata = Metadata(\n            title='Profile for ' + self._get_profile_title(),\n            last_modified=self._timestamp,\n            oscal_version=OSCAL_VERSION,\n            version=get_trestle_version(),\n        )\n        if self.xlsx_helper.profile_type == self.xlsx_helper.by_control:\n            imports = self._get_imports_by_control()\n            profile = Profile(\n                uuid=str(uuid.uuid4()),\n                metadata=metadata,\n                imports=imports,\n            )\n        else:\n            if self.xlsx_helper.profile_type == self.xlsx_helper.by_rule:\n                imports = self._get_imports_by_rule()\n            elif self.xlsx_helper.profile_type == self.xlsx_helper.by_check:\n                imports = self._get_imports_by_check()\n            else:\n                imports = self._get_imports_by_goal()\n            set_parameters = self._get_set_parameters()\n            modify = Modify(set_parameters=set_parameters)\n            profile = Profile(\n                uuid=str(uuid.uuid4()),\n                metadata=metadata,\n                imports=imports,\n                modify=modify,\n            )\n        # write OSCAL Profile to file\n        if self._verbose:\n            logger.info(f'output: {ofile}')\n        profile.oscal_write(pathlib.Path(ofile))\n        # issues\n        self._report_issues()\n        return TaskOutcome('success')\n\n    def _get_imports_by_goal(self) -&gt; List[Import]:\n        \"\"\"Get imports by goal.\"\"\"\n        return self._get_imports_by_check()\n\n    def _get_imports_by_control(self) -&gt; List[Import]:\n        \"\"\"Get imports by control.\"\"\"\n        import_ = Import(\n            href=self._get_spread_sheet_url(),\n            include_controls=[SelectControlById(with_ids=self._get_with_ids_by_control())],\n        )\n        imports = [import_]\n        return imports\n\n    def _get_imports_by_rule(self) -&gt; List[Import]:\n        \"\"\"Get imports by rule.\"\"\"\n        import_ = Import(\n            href=self._get_spread_sheet_url(),\n            include_controls=[SelectControlById(with_ids=self._get_with_ids_by_rule())],\n        )\n        imports = [import_]\n        return imports\n\n    def _get_imports_by_check(self) -&gt; List[Import]:\n        \"\"\"Get imports by check.\"\"\"\n        import_ = Import(\n            href=self._get_spread_sheet_url(),\n            include_controls=[SelectControlById(with_ids=self._get_with_ids_by_check())],\n        )\n        imports = [import_]\n        return imports\n\n    def _get_with_ids_by_control(self) -&gt; List[str]:\n        \"\"\"Get controls from spread sheet.\"\"\"\n        control_list = []\n        for row in self.xlsx_helper.row_generator():\n            # quit when first row with no goal_id encountered\n            controls = self.xlsx_helper.get_controls(row)\n            if controls is not None:\n                for control in controls:\n                    control = self._oscal_namify(control)\n                    if control in control_list:\n                        continue\n                    control_list.append(control)\n        return sorted(control_list, key=self._control_sort_key)\n\n    def _get_with_ids_by_rule(self) -&gt; List[str]:\n        \"\"\"Get rules from spread sheet.\"\"\"\n        rule_name_id_list = []\n        for row in self.xlsx_helper.row_generator():\n            # quit when first row with no goal_id encountered\n            rule_name_id = self.xlsx_helper.get_rule_name_id(row, strict=True)\n            if rule_name_id is not None:\n                if rule_name_id in rule_name_id_list:\n                    continue\n                rule_name_id_list.append(rule_name_id)\n        return sorted(rule_name_id_list)\n\n    def _get_with_ids_by_check(self) -&gt; List[str]:\n        \"\"\"Get check from spread sheet.\"\"\"\n        check_name_id_list = []\n        for row in self.xlsx_helper.row_generator():\n            # quit when first row with no goal_id encountered\n            check_name_id = self.xlsx_helper.get_check_name_id(row, strict=True)\n            if check_name_id is not None:\n                if check_name_id in check_name_id_list:\n                    continue\n                check_name_id_list.append(check_name_id)\n        return sorted(check_name_id_list)\n\n    def _control_sort_key(self, control: str) -&gt; Tuple[str, int, int]:\n        \"\"\"Fabricate sort key.\"\"\"\n        k1 = control.split('-')[0]\n        k2 = int(control.split('-')[1].split('.')[0])\n        if '.' in control:\n            k3 = int(control.split('-')[1].split('.')[1])\n        else:\n            k3 = 0\n        return (k1, k2, k3)\n\n    def _oscal_namify(self, control: str) -&gt; str:\n        \"\"\"Rectify parenthesized numbers in controls.\"\"\"\n        control = control.replace('(', '.')\n        control = control.replace(')', '')\n        return control\n\n    def _get_set_parameters(self) -&gt; List[SetParameter]:\n        \"\"\"Get set parameters from spread sheet.\"\"\"\n        set_parameters = []\n        for row in self.xlsx_helper.row_generator():\n            # quit when first row with no goal_id encountered\n            param_id, label = self.xlsx_helper.get_parameter_name_and_description(row)\n            usage = self.xlsx_helper.get_parameter_usage(row)\n            values = self.xlsx_helper.get_parameter_values(row)\n            if param_id is None:\n                continue\n            set_parameter = SetParameter(\n                param_id=param_id,\n                label=label,\n                usage=usage,\n            )\n            if values is not None:\n                set_parameter.values = values\n            set_parameters.append(set_parameter)\n        return set_parameters\n\n    def _get_profile_title(self) -&gt; str:\n        \"\"\"Get profile title from config.\"\"\"\n        value = self._config.get('profile-title')\n        logger.debug(f'profile-title: {value}')\n        return value\n\n    def _get_spread_sheet_url(self) -&gt; str:\n        \"\"\"Get spread sheet url from config.\"\"\"\n        value = self._config.get('spread-sheet-url')\n        logger.debug(f'spread-sheet-url: {value}')\n        return value\n\n    def _report_issues(self) -&gt; None:\n        \"\"\"Report issues.\"\"\"\n        self.xlsx_helper.report_issues()\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.name","title":"<code>name = 'xlsx-to-oscal-profile'</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.xlsx_helper","title":"<code>xlsx_helper = XlsxHelper()</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile-functions","title":"Functions","text":""},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.__init__","title":"<code>__init__(config_object)</code>","text":"<p>Initialize trestle task xlsx-to-oscal-profile.</p> <p>Parameters:</p> Name Type Description Default <code>config_object</code> <code>Optional[SectionProxy]</code> <p>Config section associated with the task.</p> required Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code> <pre><code>def __init__(self, config_object: Optional[configparser.SectionProxy]) -&gt; None:\n    \"\"\"\n    Initialize trestle task xlsx-to-oscal-profile.\n\n    Args:\n        config_object: Config section associated with the task.\n    \"\"\"\n    super().__init__(config_object)\n    self.xlsx_helper = XlsxHelper()\n    self._timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.execute","title":"<code>execute()</code>","text":"<p>Provide an executed outcome.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code> <pre><code>def execute(self) -&gt; TaskOutcome:\n    \"\"\"Provide an executed outcome.\"\"\"\n    try:\n        return self._execute()\n    except Exception:\n        logger.info(traceback.format_exc())\n        return TaskOutcome('failure')\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.print_info","title":"<code>print_info()</code>","text":"<p>Print the help string.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code> <pre><code>def print_info(self) -&gt; None:\n    \"\"\"Print the help string.\"\"\"\n    self.xlsx_helper.print_info(self.name, 'profile')\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.set_timestamp","title":"<code>set_timestamp(timestamp)</code>","text":"<p>Set the timestamp.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code> <pre><code>def set_timestamp(self, timestamp: str) -&gt; None:\n    \"\"\"Set the timestamp.\"\"\"\n    self._timestamp = timestamp\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile.XlsxToOscalProfile.simulate","title":"<code>simulate()</code>","text":"<p>Provide a simulated outcome.</p> Source code in <code>trestle/tasks/xlsx_to_oscal_profile.py</code> <pre><code>def simulate(self) -&gt; TaskOutcome:\n    \"\"\"Provide a simulated outcome.\"\"\"\n    return TaskOutcome('simulated-success')\n</code></pre>"},{"location":"reference/API/trestle/tasks/xlsx_to_oscal_profile/#trestle.tasks.xlsx_to_oscal_profile-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/results/","title":"trestle.transforms.results","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/transforms/results/#trestle.transforms.results","title":"<code>trestle.transforms.results</code>","text":"<p>Define Results class returned by transformers.</p>"},{"location":"reference/API/trestle/transforms/results/#trestle.transforms.results-classes","title":"Classes","text":""},{"location":"reference/API/trestle/transforms/results/#trestle.transforms.results.Results","title":"<code>Results</code>","text":"<p>               Bases: <code>OscalBaseModel</code></p> <p>Transformer results as a list.</p> Source code in <code>trestle/transforms/results.py</code> <pre><code>class Results(OscalBaseModel):\n    \"\"\"Transformer results as a list.\"\"\"\n\n    __root__: List[Result] = []\n</code></pre>"},{"location":"reference/API/trestle/transforms/results/#trestle.transforms.results.Results-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/results/#trestle.transforms.results.Results.__root__","title":"<code>__root__: List[Result] = []</code>  <code>class-attribute</code> <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/transformer_factory/","title":"trestle.transforms.transformer_factory","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory","title":"<code>trestle.transforms.transformer_factory</code>","text":"<p>Define the TransformerFactory and corresponding transformer classes it creates.</p>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory-classes","title":"Classes","text":""},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.FromOscalTransformer","title":"<code>FromOscalTransformer</code>","text":"<p>               Bases: <code>TransformerBase</code></p> <p>Abstract interface for transformers from OSCAL.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>class FromOscalTransformer(TransformerBase):\n    \"\"\"Abstract interface for transformers from OSCAL.\"\"\"\n\n    @abstractmethod\n    def transform(self, obj: OscalBaseModel) -&gt; str:\n        \"\"\"Transform the from OSCAL.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.FromOscalTransformer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.FromOscalTransformer.transform","title":"<code>transform(obj)</code>  <code>abstractmethod</code>","text":"<p>Transform the from OSCAL.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>@abstractmethod\ndef transform(self, obj: OscalBaseModel) -&gt; str:\n    \"\"\"Transform the from OSCAL.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.ResultsTransformer","title":"<code>ResultsTransformer</code>","text":"<p>               Bases: <code>TransformerBase</code></p> <p>Abstract interface for transformers that specifically return Results.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>class ResultsTransformer(TransformerBase):\n    \"\"\"Abstract interface for transformers that specifically return Results.\"\"\"\n\n    @abstractmethod\n    def transform(self, blob: str) -&gt; Results:\n        \"\"\"Transform the blob into Results.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.ResultsTransformer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.ResultsTransformer.transform","title":"<code>transform(blob)</code>  <code>abstractmethod</code>","text":"<p>Transform the blob into Results.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>@abstractmethod\ndef transform(self, blob: str) -&gt; Results:\n    \"\"\"Transform the blob into Results.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.ToOscalTransformer","title":"<code>ToOscalTransformer</code>","text":"<p>               Bases: <code>TransformerBase</code></p> <p>Abstract interface for transformers to OSCAL.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>class ToOscalTransformer(TransformerBase):\n    \"\"\"Abstract interface for transformers to OSCAL.\"\"\"\n\n    @abstractmethod\n    def transform(self, obj: str) -&gt; OscalBaseModel:\n        \"\"\"Transform the to OSCAL.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.ToOscalTransformer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.ToOscalTransformer.transform","title":"<code>transform(obj)</code>  <code>abstractmethod</code>","text":"<p>Transform the to OSCAL.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>@abstractmethod\ndef transform(self, obj: str) -&gt; OscalBaseModel:\n    \"\"\"Transform the to OSCAL.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerBase","title":"<code>TransformerBase</code>","text":"<p>               Bases: <code>ABC</code></p> <p>Abstract base interface for all transformers.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>class TransformerBase(ABC):\n    \"\"\"Abstract base interface for all transformers.\"\"\"\n\n    # the current time for consistent timestamping\n    _timestamp = datetime.datetime.now(datetime.timezone.utc).replace(microsecond=0).isoformat()\n\n    @staticmethod\n    def set_timestamp(value: str) -&gt; None:\n        \"\"\"Set the default timestamp value.\"\"\"\n        datetime.datetime.strptime(value, '%Y-%m-%dT%H:%M:%S%z')\n        TransformerBase._timestamp = value\n\n    @staticmethod\n    def get_timestamp() -&gt; str:\n        \"\"\"Get the default timestamp value.\"\"\"\n        return TransformerBase._timestamp\n\n    @abstractmethod\n    def transform(self, blob: Any) -&gt; Any:\n        \"\"\"Transform the blob into a general OscalBaseModel.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerBase-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerBase.get_timestamp","title":"<code>get_timestamp()</code>  <code>staticmethod</code>","text":"<p>Get the default timestamp value.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>@staticmethod\ndef get_timestamp() -&gt; str:\n    \"\"\"Get the default timestamp value.\"\"\"\n    return TransformerBase._timestamp\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerBase.set_timestamp","title":"<code>set_timestamp(value)</code>  <code>staticmethod</code>","text":"<p>Set the default timestamp value.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>@staticmethod\ndef set_timestamp(value: str) -&gt; None:\n    \"\"\"Set the default timestamp value.\"\"\"\n    datetime.datetime.strptime(value, '%Y-%m-%dT%H:%M:%S%z')\n    TransformerBase._timestamp = value\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerBase.transform","title":"<code>transform(blob)</code>  <code>abstractmethod</code>","text":"<p>Transform the blob into a general OscalBaseModel.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>@abstractmethod\ndef transform(self, blob: Any) -&gt; Any:\n    \"\"\"Transform the blob into a general OscalBaseModel.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerFactory","title":"<code>TransformerFactory</code>","text":"<p>Perform registration and creation of transformers.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>class TransformerFactory:\n    \"\"\"Perform registration and creation of transformers.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize the transformers dictionary as empty.\"\"\"\n        self._transformers: Dict[str, Type[TransformerBase]] = {}\n\n    def register_transformer(self, name: str, transformer: Type[TransformerBase]) -&gt; None:\n        \"\"\"\n        Register the transformer.\n\n        This registers transformers in the factory so they may be created by name.\n\n        Args:\n            name (str): The name of the transformer.\n            transformer (TransformerBase): The transformer class to be registered.\n\n        Returns:\n            None\n        \"\"\"\n        self._transformers[name] = transformer\n\n    def get(self, name: str) -&gt; TransformerBase:\n        \"\"\"\n        Create an instance of the desired transformer based its name.\n\n        Args:\n            name (str): The name of the transformer.\n\n        Returns:\n            An instance of the desired transformer.\n\n        Raises:\n            TrestleError: if the name does not exist in the registry.\n        \"\"\"\n        t = self._transformers.get(name)\n        if t is not None:\n            return t()\n        raise TrestleError(f'Error getting non-registered transform {name}')\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerFactory-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerFactory.__init__","title":"<code>__init__()</code>","text":"<p>Initialize the transformers dictionary as empty.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize the transformers dictionary as empty.\"\"\"\n    self._transformers: Dict[str, Type[TransformerBase]] = {}\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerFactory.get","title":"<code>get(name)</code>","text":"<p>Create an instance of the desired transformer based its name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the transformer.</p> required <p>Returns:</p> Type Description <code>TransformerBase</code> <p>An instance of the desired transformer.</p> <p>Raises:</p> Type Description <code>TrestleError</code> <p>if the name does not exist in the registry.</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>def get(self, name: str) -&gt; TransformerBase:\n    \"\"\"\n    Create an instance of the desired transformer based its name.\n\n    Args:\n        name (str): The name of the transformer.\n\n    Returns:\n        An instance of the desired transformer.\n\n    Raises:\n        TrestleError: if the name does not exist in the registry.\n    \"\"\"\n    t = self._transformers.get(name)\n    if t is not None:\n        return t()\n    raise TrestleError(f'Error getting non-registered transform {name}')\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_factory/#trestle.transforms.transformer_factory.TransformerFactory.register_transformer","title":"<code>register_transformer(name, transformer)</code>","text":"<p>Register the transformer.</p> <p>This registers transformers in the factory so they may be created by name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the transformer.</p> required <code>transformer</code> <code>TransformerBase</code> <p>The transformer class to be registered.</p> required <p>Returns:</p> Type Description <code>None</code> <p>None</p> Source code in <code>trestle/transforms/transformer_factory.py</code> <pre><code>def register_transformer(self, name: str, transformer: Type[TransformerBase]) -&gt; None:\n    \"\"\"\n    Register the transformer.\n\n    This registers transformers in the factory so they may be created by name.\n\n    Args:\n        name (str): The name of the transformer.\n        transformer (TransformerBase): The transformer class to be registered.\n\n    Returns:\n        None\n    \"\"\"\n    self._transformers[name] = transformer\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/","title":"trestle.transforms.transformer_helper","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper","title":"<code>trestle.transforms.transformer_helper</code>","text":"<p>Transformer helper functions.</p>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper-classes","title":"Classes","text":""},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyAccounting","title":"<code>PropertyAccounting</code>","text":"<p>Property accounting class.</p> <p>Help transformers do accounting.</p> <p>Each time a new record is processed the transformer calls count_group. For each attribute on that record, the transformer calls count_property.   - If the property already exactly exists, then its count is incremented.   - Otherwise, a new entry is made and the count for that property is set to 1. When the transformer wants to know if a property (name, value, ns, and class)   is common to all records for the group, is_common_property is employed to check   that the number of records in the group is equal to the number of duplicates   there are for the property. If equal, then the property is common.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>class PropertyAccounting():\n    \"\"\"Property accounting class.\n\n    Help transformers do accounting.\n\n    &gt; Each time a new record is processed the transformer calls count_group.\n    &gt; For each attribute on that record, the transformer calls count_property.\n      - If the property already exactly exists, then its count is incremented.\n      - Otherwise, a new entry is made and the count for that property is set to 1.\n    &gt; When the transformer wants to know if a property (name, value, ns, and class)\n      is common to all records for the group, is_common_property is employed to check\n      that the number of records in the group is equal to the number of duplicates\n      there are for the property. If equal, then the property is common.\n    \"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self._group_map: Dict[str, int] = {}\n        self._property_map: Dict[str, Dict[str, int]] = {}\n\n    def count_group(self, group: Optional[str] = None) -&gt; None:\n        \"\"\"Group accounting.\"\"\"\n        if not group:\n            raise TrestleError('count_group created with group=None')\n        if group not in self._group_map:\n            self._group_map[group] = 0\n        self._group_map[group] += 1\n\n    def count_property(\n        self,\n        group: str,\n        name: Optional[str] = None,\n        value: Optional[str] = None,\n        class_: Optional[str] = None,\n        ns: Optional[str] = None\n    ) -&gt; None:\n        \"\"\"Property accounting.\"\"\"\n        key = _segment_separator.join([str(name), str(value), str(class_), str(ns)])\n        if group not in self._property_map:\n            self._property_map[group] = {}\n        if key not in self._property_map[group]:\n            self._property_map[group][key] = 0\n        self._property_map[group][key] += 1\n\n    def is_common_property(\n        self,\n        group: str,\n        name: Optional[str] = None,\n        value: Optional[str] = None,\n        class_: Optional[str] = None,\n        ns: Optional[str] = None\n    ) -&gt; bool:\n        \"\"\"Check for common property.\"\"\"\n        rval = False\n        key = _segment_separator.join([str(name), str(value), str(class_), str(ns)])\n        if group in self._group_map and key in self._property_map[group]:\n            rval = self._group_map[group] == self._property_map[group][key]\n        return rval\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyAccounting-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyAccounting.__init__","title":"<code>__init__()</code>","text":"<p>Initialize.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self._group_map: Dict[str, int] = {}\n    self._property_map: Dict[str, Dict[str, int]] = {}\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyAccounting.count_group","title":"<code>count_group(group=None)</code>","text":"<p>Group accounting.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>def count_group(self, group: Optional[str] = None) -&gt; None:\n    \"\"\"Group accounting.\"\"\"\n    if not group:\n        raise TrestleError('count_group created with group=None')\n    if group not in self._group_map:\n        self._group_map[group] = 0\n    self._group_map[group] += 1\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyAccounting.count_property","title":"<code>count_property(group, name=None, value=None, class_=None, ns=None)</code>","text":"<p>Property accounting.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>def count_property(\n    self,\n    group: str,\n    name: Optional[str] = None,\n    value: Optional[str] = None,\n    class_: Optional[str] = None,\n    ns: Optional[str] = None\n) -&gt; None:\n    \"\"\"Property accounting.\"\"\"\n    key = _segment_separator.join([str(name), str(value), str(class_), str(ns)])\n    if group not in self._property_map:\n        self._property_map[group] = {}\n    if key not in self._property_map[group]:\n        self._property_map[group][key] = 0\n    self._property_map[group][key] += 1\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyAccounting.is_common_property","title":"<code>is_common_property(group, name=None, value=None, class_=None, ns=None)</code>","text":"<p>Check for common property.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>def is_common_property(\n    self,\n    group: str,\n    name: Optional[str] = None,\n    value: Optional[str] = None,\n    class_: Optional[str] = None,\n    ns: Optional[str] = None\n) -&gt; bool:\n    \"\"\"Check for common property.\"\"\"\n    rval = False\n    key = _segment_separator.join([str(name), str(value), str(class_), str(ns)])\n    if group in self._group_map and key in self._property_map[group]:\n        rval = self._group_map[group] == self._property_map[group][key]\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyManager","title":"<code>PropertyManager</code>","text":"<p>Property manager class.</p> <p>Help transformer manage properties.</p> <p>Use materialize to: fetch a property from cache (if caching), else create a new   property instance and keep in cache (if caching). Use put_common_property to: keep common properties for each group. Use get_common_properties to: recall the list of common properties for the group.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>class PropertyManager():\n    \"\"\"Property manager class.\n\n    Help transformer manage properties.\n\n    &gt; Use materialize to: fetch a property from cache (if caching), else create a new\n      property instance and keep in cache (if caching).\n    &gt; Use put_common_property to: keep common properties for each group.\n    &gt; Use get_common_properties to: recall the list of common properties for the group.\n    \"\"\"\n\n    def __init__(self, caching: bool = True, checking: bool = False) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self._caching = caching\n        self._checking = checking\n        self._requests = 0\n        self._hits = 0\n        self._map_unique: Dict[str, Any] = {}\n        self._map_common: Dict[str, Dict[str, Property]] = {}\n\n    @property\n    def requests(self) -&gt; int:\n        \"\"\"Cache requests.\"\"\"\n        return self._requests\n\n    @property\n    def hits(self) -&gt; int:\n        \"\"\"Cache hits.\"\"\"\n        return self._hits\n\n    def materialize(\n        self,\n        name: Optional[str] = None,\n        value: Optional[str] = None,\n        class_: Optional[str] = None,\n        ns: Optional[str] = None\n    ) -&gt; Property:\n        \"\"\"Get property from cache or create new property.\"\"\"\n        self._requests += 1\n        # try fetch from cache\n        key = _segment_separator.join([str(name), str(value), str(class_), str(ns)])\n        if key in self._map_unique:\n            self._hits += 1\n            return self._map_unique[key]\n        # create new property and put into cache if caching\n        prop = self._create(name=name, value=value, class_=class_, ns=ns)\n        if self._caching:\n            self._map_unique[key] = prop\n        return prop\n\n    def put_common_property(\n        self,\n        group: Optional[str] = None,\n        name: Optional[str] = None,\n        value: Optional[str] = None,\n        class_: Optional[str] = None,\n        ns: Optional[str] = None\n    ) -&gt; None:\n        \"\"\"Remember common property.\"\"\"\n        if not group:\n            raise TrestleError('put_common_property created with group=None')\n        if group not in self._map_common:\n            self._map_common[group] = {}\n        key = _segment_separator.join([str(name), str(value), str(class_), str(ns)])\n        if key not in self._map_common[group]:\n            prop = self.materialize(name, value, class_, ns)\n            self._map_common[group][key] = prop\n\n    def get_common_properties(self, group: Optional[str] = None) -&gt; Optional[List[Property]]:\n        \"\"\"Recall common properties for the group.\"\"\"\n        rval = None\n        if not group:\n            raise TrestleError('get_common_properties created with group=None')\n        if group in self._map_common:\n            rval = list(self._map_common[group].values())\n        return rval\n\n    def _create(\n        self,\n        name: Optional[str] = None,\n        value: Optional[str] = None,\n        class_: Optional[str] = None,\n        ns: Optional[str] = None\n    ) -&gt; Property:\n        \"\"\"Create new property.\"\"\"\n        if self._checking:\n            return Property(name=name, value=value, class_=class_, ns=ns)  # type: ignore\n        return Property.construct(name=name, value=value, class_=class_, ns=ns)  # type: ignore\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyManager-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyManager.hits","title":"<code>hits: int</code>  <code>property</code>","text":"<p>Cache hits.</p>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyManager.requests","title":"<code>requests: int</code>  <code>property</code>","text":"<p>Cache requests.</p>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyManager-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyManager.__init__","title":"<code>__init__(caching=True, checking=False)</code>","text":"<p>Initialize.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>def __init__(self, caching: bool = True, checking: bool = False) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self._caching = caching\n    self._checking = checking\n    self._requests = 0\n    self._hits = 0\n    self._map_unique: Dict[str, Any] = {}\n    self._map_common: Dict[str, Dict[str, Property]] = {}\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyManager.get_common_properties","title":"<code>get_common_properties(group=None)</code>","text":"<p>Recall common properties for the group.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>def get_common_properties(self, group: Optional[str] = None) -&gt; Optional[List[Property]]:\n    \"\"\"Recall common properties for the group.\"\"\"\n    rval = None\n    if not group:\n        raise TrestleError('get_common_properties created with group=None')\n    if group in self._map_common:\n        rval = list(self._map_common[group].values())\n    return rval\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyManager.materialize","title":"<code>materialize(name=None, value=None, class_=None, ns=None)</code>","text":"<p>Get property from cache or create new property.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>def materialize(\n    self,\n    name: Optional[str] = None,\n    value: Optional[str] = None,\n    class_: Optional[str] = None,\n    ns: Optional[str] = None\n) -&gt; Property:\n    \"\"\"Get property from cache or create new property.\"\"\"\n    self._requests += 1\n    # try fetch from cache\n    key = _segment_separator.join([str(name), str(value), str(class_), str(ns)])\n    if key in self._map_unique:\n        self._hits += 1\n        return self._map_unique[key]\n    # create new property and put into cache if caching\n    prop = self._create(name=name, value=value, class_=class_, ns=ns)\n    if self._caching:\n        self._map_unique[key] = prop\n    return prop\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.PropertyManager.put_common_property","title":"<code>put_common_property(group=None, name=None, value=None, class_=None, ns=None)</code>","text":"<p>Remember common property.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>def put_common_property(\n    self,\n    group: Optional[str] = None,\n    name: Optional[str] = None,\n    value: Optional[str] = None,\n    class_: Optional[str] = None,\n    ns: Optional[str] = None\n) -&gt; None:\n    \"\"\"Remember common property.\"\"\"\n    if not group:\n        raise TrestleError('put_common_property created with group=None')\n    if group not in self._map_common:\n        self._map_common[group] = {}\n    key = _segment_separator.join([str(name), str(value), str(class_), str(ns)])\n    if key not in self._map_common[group]:\n        prop = self.materialize(name, value, class_, ns)\n        self._map_common[group][key] = prop\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.TransformerHelper","title":"<code>TransformerHelper</code>","text":"<p>OSCAL transformer helper.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>class TransformerHelper():\n    \"\"\"OSCAL transformer helper.\"\"\"\n\n    def remove_common_observation_properties(self, observations: List[Observation]) -&gt; List[Property]:\n        \"\"\"Remove common observation properties.\"\"\"\n        common_props = []\n        props = {}\n        # count each property occurrence in each observation\n        props_occurrence_counts = self._get_property_occurrence_counts(observations)\n        # remove common properties from observation\n        for key in props_occurrence_counts.keys():\n            # skip property if not identical for each and every observation\n            if props_occurrence_counts[key] != len(observations):\n                continue\n            # remove property from each observation and keep one instance\n            for observation in observations:\n                for prop in as_list(observation.props):\n                    if key == f'{prop.name}:{prop.value}:{prop.class_}':\n                        props[key] = prop\n                        observation.props.remove(prop)\n                        break\n        # formulate list of removed properties\n        for key in props.keys():\n            common_props.append(props[key])\n        # return list of removed properties\n        return common_props\n\n    def _get_property_occurrence_counts(self, observations: List[Observation]) -&gt; Dict[str, Property]:\n        \"\"\"Count each property occurrence in each observation.\"\"\"\n        property_occurences = {}\n        for observation in observations:\n            for prop in observation.props:\n                key = f'{prop.name}:{prop.value}:{prop.class_}'\n                if key not in property_occurences.keys():\n                    property_occurences[key] = 0\n                property_occurences[key] += 1\n        return property_occurences\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.TransformerHelper-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper.TransformerHelper.remove_common_observation_properties","title":"<code>remove_common_observation_properties(observations)</code>","text":"<p>Remove common observation properties.</p> Source code in <code>trestle/transforms/transformer_helper.py</code> <pre><code>def remove_common_observation_properties(self, observations: List[Observation]) -&gt; List[Property]:\n    \"\"\"Remove common observation properties.\"\"\"\n    common_props = []\n    props = {}\n    # count each property occurrence in each observation\n    props_occurrence_counts = self._get_property_occurrence_counts(observations)\n    # remove common properties from observation\n    for key in props_occurrence_counts.keys():\n        # skip property if not identical for each and every observation\n        if props_occurrence_counts[key] != len(observations):\n            continue\n        # remove property from each observation and keep one instance\n        for observation in observations:\n            for prop in as_list(observation.props):\n                if key == f'{prop.name}:{prop.value}:{prop.class_}':\n                    props[key] = prop\n                    observation.props.remove(prop)\n                    break\n    # formulate list of removed properties\n    for key in props.keys():\n        common_props.append(props[key])\n    # return list of removed properties\n    return common_props\n</code></pre>"},{"location":"reference/API/trestle/transforms/transformer_helper/#trestle.transforms.transformer_helper-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/transformer_singleton/","title":"trestle.transforms.transformer_singleton","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/transforms/transformer_singleton/#trestle.transforms.transformer_singleton","title":"<code>trestle.transforms.transformer_singleton</code>","text":"<p>Create the singleton transformer factory here.</p>"},{"location":"reference/API/trestle/transforms/transformer_singleton/#trestle.transforms.transformer_singleton-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/transformer_singleton/#trestle.transforms.transformer_singleton.transformer_factory","title":"<code>transformer_factory = TransformerFactory()</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/transformer_singleton/#trestle.transforms.transformer_singleton-classes","title":"Classes","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/","title":"trestle.transforms.implementations.osco","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco","title":"<code>trestle.transforms.implementations.osco</code>","text":"<p>Facilitate OSCAL-OSCO transformation.</p>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco-classes","title":"Classes","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer","title":"<code>OscalProfileToOscoProfileTransformer</code>","text":"<p>               Bases: <code>FromOscalTransformer</code></p> <p>Interface for Oscal Profile to Osco Profile transformer.</p> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>class OscalProfileToOscoProfileTransformer(FromOscalTransformer):\n    \"\"\"Interface for Oscal Profile to Osco Profile transformer.\"\"\"\n\n    def __init__(\n        self,\n        extends='ocp4-cis-node',\n        api_version='compliance.openshift.io/v1alpha1',\n        kind='TailoredProfile',\n        name='customized-tailored-profile',\n        namespace='openshift-compliance',\n    ) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self._extends = extends\n        self._api_version = api_version\n        self._kind = kind\n        self._name = name\n        self._namespace = namespace\n\n    def transform(self, profile: Profile) -&gt; str:\n        \"\"\"Transform the Profile into a OSCO yaml.\"\"\"\n        self._profile = profile\n        self._osco_version = self._get_normalized_version('osco_version', '0.1.46')\n        # set values\n        set_values = self._get_set_values()\n        # spec\n        if self._osco_version &lt; (0, 1, 40):\n            # for versions prior to 0.1.40, exclude 'description'\n            spec = {\n                'extends': self._get_metadata_prop_value('base_profile_mnemonic', self._extends),\n                'title': self._profile.metadata.title,\n                'setValues': set_values,\n            }\n        else:\n            # for versions 0.1.40 and beyond, include 'description'\n            spec = {\n                'description': self._get_metadata_prop_value('profile_mnemonic', self._name),\n                'extends': self._get_metadata_prop_value('base_profile_mnemonic', self._extends),\n                'title': self._profile.metadata.title,\n                'setValues': set_values,\n            }\n        disable_rules = self._get_disable_rules()\n        if disable_rules:\n            spec['disableRules'] = disable_rules\n        # yaml data\n        ydata = {\n            'apiVersion': self._api_version,\n            'kind': self._kind,\n            'metadata': {\n                'name': self._get_metadata_prop_value('profile_mnemonic', self._name),\n                'namespace': self._namespace,\n            },\n            'spec': spec,\n        }\n        return json.dumps(ydata)\n\n    def _get_normalized_version(self, prop_name, prop_default) -&gt; Tuple[int, int, int]:\n        \"\"\"Get normalized version.\n\n        Normalize the \"x.y.z\" string value to an integer: 1,000,000*x + 1,000*y + z.\n        \"\"\"\n        try:\n            vparts = self._get_metadata_prop_value(prop_name, prop_default).split('.')\n            normalized_version = (int(vparts[0]), int(vparts[1]), int(vparts[2]))\n        except Exception:\n            logger.warning(f'metadata prop name={prop_name} value error')\n            vparts = prop_default.split('.')\n            normalized_version = (int(vparts[0]), int(vparts[1]), int(vparts[2]))\n        return normalized_version\n\n    def _get_set_values(self) -&gt; List[Dict]:\n        \"\"\"Extract set_paramater name/value pairs from profile.\"\"\"\n        set_values = []\n        # for check versions prior to 0.1.59 include parameters\n        # for later versions parameters should not be specified, caveat emptor\n        if self._profile.modify is not None:\n            for set_parameter in as_list(self._profile.modify.set_parameters):\n                name = self._format_osco_rule_name(set_parameter.param_id)\n                parameter_value = set_parameter.values[0]\n                value = parameter_value\n                rationale = self._get_rationale_for_set_value()\n                set_value = {'name': name, 'value': value, 'rationale': rationale}\n                set_values.append(set_value)\n        return set_values\n\n    def _format_osco_rule_name(self, name: str) -&gt; str:\n        \"\"\"Format for OSCO.\n\n        1. remove prefix xccdf_org.ssgproject.content_rule_\n        2. change underscores to dashes\n        3. add prefix ocp4-\n        \"\"\"\n        normalized_name = name.replace('xccdf_org.ssgproject.content_rule_', '').replace('_', '-')\n        if not normalized_name.startswith('ocp4-'):\n            normalized_name = f'ocp4-{normalized_name}'\n        return normalized_name\n\n    def _get_metadata_prop_value(self, name: str, default_: str) -&gt; str:\n        \"\"\"Extract metadata prop or else default if not present.\"\"\"\n        for prop in as_list(self._profile.metadata.props):\n            if prop.name == name:\n                return prop.value\n        logger.info(f'using default: {name} = {default_}')\n        return default_\n\n    def _get_disable_rules(self) -&gt; List[str]:\n        \"\"\"Extract disabled rules.\"\"\"\n        value = []\n        for _import in as_list(self._profile.imports):\n            for control in as_list(_import.exclude_controls):\n                self._add_disable_rules_for_control(value, control)\n        return value\n\n    def _add_disable_rules_for_control(self, value, control):\n        \"\"\"Extract disabled rules for control.\"\"\"\n        for with_id in as_list(control.with_ids):\n            name = self._format_osco_rule_name(with_id.__root__)\n            rationale = self._get_rationale_for_disable_rule()\n            entry = {'name': name, 'rationale': rationale}\n            value.append(entry)\n\n    def _get_rationale_for_set_value(self) -&gt; str:\n        \"\"\"Rationale for set value.\"\"\"\n        return 'not determinable from specification'\n\n    def _get_rationale_for_disable_rule(self) -&gt; str:\n        \"\"\"Rationale for disable rule.\"\"\"\n        return 'not determinable from specification'\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.__init__","title":"<code>__init__(extends='ocp4-cis-node', api_version='compliance.openshift.io/v1alpha1', kind='TailoredProfile', name='customized-tailored-profile', namespace='openshift-compliance')</code>","text":"<p>Initialize.</p> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>def __init__(\n    self,\n    extends='ocp4-cis-node',\n    api_version='compliance.openshift.io/v1alpha1',\n    kind='TailoredProfile',\n    name='customized-tailored-profile',\n    namespace='openshift-compliance',\n) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self._extends = extends\n    self._api_version = api_version\n    self._kind = kind\n    self._name = name\n    self._namespace = namespace\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscalProfileToOscoProfileTransformer.transform","title":"<code>transform(profile)</code>","text":"<p>Transform the Profile into a OSCO yaml.</p> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>def transform(self, profile: Profile) -&gt; str:\n    \"\"\"Transform the Profile into a OSCO yaml.\"\"\"\n    self._profile = profile\n    self._osco_version = self._get_normalized_version('osco_version', '0.1.46')\n    # set values\n    set_values = self._get_set_values()\n    # spec\n    if self._osco_version &lt; (0, 1, 40):\n        # for versions prior to 0.1.40, exclude 'description'\n        spec = {\n            'extends': self._get_metadata_prop_value('base_profile_mnemonic', self._extends),\n            'title': self._profile.metadata.title,\n            'setValues': set_values,\n        }\n    else:\n        # for versions 0.1.40 and beyond, include 'description'\n        spec = {\n            'description': self._get_metadata_prop_value('profile_mnemonic', self._name),\n            'extends': self._get_metadata_prop_value('base_profile_mnemonic', self._extends),\n            'title': self._profile.metadata.title,\n            'setValues': set_values,\n        }\n    disable_rules = self._get_disable_rules()\n    if disable_rules:\n        spec['disableRules'] = disable_rules\n    # yaml data\n    ydata = {\n        'apiVersion': self._api_version,\n        'kind': self._kind,\n        'metadata': {\n            'name': self._get_metadata_prop_value('profile_mnemonic', self._name),\n            'namespace': self._namespace,\n        },\n        'spec': spec,\n    }\n    return json.dumps(ydata)\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer","title":"<code>OscoResultToOscalARTransformer</code>","text":"<p>               Bases: <code>ResultsTransformer</code></p> <p>Interface for Osco transformer.</p> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>class OscoResultToOscalARTransformer(ResultsTransformer):\n    \"\"\"Interface for Osco transformer.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self._modes = {}\n\n    @property\n    def analysis(self) -&gt; List[str]:\n        \"\"\"Analysis.\"\"\"\n        return self._results_factory.analysis\n\n    @property\n    def checking(self):\n        \"\"\"Return checking.\"\"\"\n        return self._modes.get('checking', False)\n\n    def set_modes(self, modes: Dict[str, Any]) -&gt; None:\n        \"\"\"Keep modes info.\"\"\"\n        if modes is not None:\n            self._modes = modes\n\n    def transform(self, blob: str) -&gt; Results:\n        \"\"\"Transform the blob into a Results.\n\n        The expected blob is a string that is one of:\n            - data from OpenShift Compliance Operator (json, yaml, xml)\n            - data from Auditree OSCO fetcher/check (json)\n        \"\"\"\n        results = None\n        self._results_factory = _OscalResultsFactory(self.get_timestamp(), self.checking)\n        if results is None:\n            results = self._ingest_xml(blob)\n        if results is None:\n            results = self._ingest_json(blob)\n        if results is None:\n            results = self._ingest_yaml(blob)\n        return results\n\n    def _ingest_xml(self, blob: str) -&gt; Results:\n        \"\"\"Ingest xml data.\"\"\"\n        # ?xml data\n        if blob.startswith('&lt;?xml'):\n            resource = blob\n            self._results_factory.ingest_xml(resource)\n        else:\n            return None\n        results = Results()\n        results.__root__.append(self._results_factory.result)\n        return results\n\n    def _ingest_json(self, blob: str) -&gt; Results:\n        \"\"\"Ingest json data.\"\"\"\n        try:\n            # ? configmaps or auditree data\n            jdata = json.loads(blob)\n            # https://docs.openshift.com/container-platform/3.7/rest_api/api/v1.ConfigMap.html#Get-api-v1-namespaces-namespace-configmaps-name\n            if 'kind' in jdata.keys() and jdata['kind'] == 'ConfigMapList' and 'items' in jdata.keys():\n                items = jdata['items']\n                for item in items:\n                    if 'data' in item.keys():\n                        data = item['data']\n                        if 'results' in data:\n                            resource = item\n                            self._results_factory.ingest(resource)\n            # https://github.com/ComplianceAsCode/auditree-arboretum/blob/main/arboretum/kubernetes/fetchers/fetch_cluster_resource.py\n            else:\n                for key in jdata.keys():\n                    for group in jdata[key]:\n                        for cluster in jdata[key][group]:\n                            if 'resources' in cluster:\n                                for resource in cluster['resources']:\n                                    self._results_factory.ingest(resource)\n        except json.decoder.JSONDecodeError:\n            return None\n        results = Results()\n        results.__root__.append(self._results_factory.result)\n        return results\n\n    def _ingest_yaml(self, blob: str) -&gt; Results:\n        \"\"\"Ingest yaml data.\"\"\"\n        try:\n            # ? yaml data\n            yaml = YAML(typ='safe')\n            resource = yaml.load(blob)\n            self._results_factory.ingest(resource)\n        except Exception as e:\n            raise e\n        results = Results()\n        results.__root__.append(self._results_factory.result)\n        return results\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.analysis","title":"<code>analysis: List[str]</code>  <code>property</code>","text":"<p>Analysis.</p>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.checking","title":"<code>checking</code>  <code>property</code>","text":"<p>Return checking.</p>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.__init__","title":"<code>__init__()</code>","text":"<p>Initialize.</p> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self._modes = {}\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.set_modes","title":"<code>set_modes(modes)</code>","text":"<p>Keep modes info.</p> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>def set_modes(self, modes: Dict[str, Any]) -&gt; None:\n    \"\"\"Keep modes info.\"\"\"\n    if modes is not None:\n        self._modes = modes\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscoResultToOscalARTransformer.transform","title":"<code>transform(blob)</code>","text":"<p>Transform the blob into a Results.</p> The expected blob is a string that is one of <ul> <li>data from OpenShift Compliance Operator (json, yaml, xml)</li> <li>data from Auditree OSCO fetcher/check (json)</li> </ul> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>def transform(self, blob: str) -&gt; Results:\n    \"\"\"Transform the blob into a Results.\n\n    The expected blob is a string that is one of:\n        - data from OpenShift Compliance Operator (json, yaml, xml)\n        - data from Auditree OSCO fetcher/check (json)\n    \"\"\"\n    results = None\n    self._results_factory = _OscalResultsFactory(self.get_timestamp(), self.checking)\n    if results is None:\n        results = self._ingest_xml(blob)\n    if results is None:\n        results = self._ingest_json(blob)\n    if results is None:\n        results = self._ingest_yaml(blob)\n    return results\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.OscoTransformer","title":"<code>OscoTransformer</code>","text":"<p>               Bases: <code>OscoResultToOscalARTransformer</code></p> <p>Legacy class name.</p> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>class OscoTransformer(OscoResultToOscalARTransformer):\n    \"\"\"Legacy class name.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse","title":"<code>RuleUse</code>","text":"<p>Represents one rule of OSCO data.</p> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>class RuleUse():\n    \"\"\"Represents one rule of OSCO data.\"\"\"\n\n    def __init__(self, args: Dict[str, str]) -&gt; None:\n        \"\"\"Initialize given specified args.\"\"\"\n        self.id_ = args['id_']\n        self.target = args['target']\n        self.target_type = args['target_type']\n        self.host_name = args['host_name']\n        self.benchmark_href = args['benchmark_href']\n        self.benchmark_id = args['benchmark_id']\n        self.scanner_name = args['scanner_name']\n        self.scanner_version = args['scanner_version']\n        self.idref = args['idref']\n        self.version = args['version']\n        self.time = args['time']\n        self.result = args['result']\n        self.severity = args['severity']\n        self.weight = args['weight']\n\n    @property\n    def inventory_key(self):\n        \"\"\"Derive inventory key.\"\"\"\n        if self.host_name is None:\n            # OpenScap 1.3.3\n            rval = self.target + ':' + self.target_type\n        else:\n            # OpenScap 1.3.5\n            rval = self.host_name + ':' + self.target_type\n        return rval\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.benchmark_href","title":"<code>benchmark_href = args['benchmark_href']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.benchmark_id","title":"<code>benchmark_id = args['benchmark_id']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.host_name","title":"<code>host_name = args['host_name']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.id_","title":"<code>id_ = args['id_']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.idref","title":"<code>idref = args['idref']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.inventory_key","title":"<code>inventory_key</code>  <code>property</code>","text":"<p>Derive inventory key.</p>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.result","title":"<code>result = args['result']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.scanner_name","title":"<code>scanner_name = args['scanner_name']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.scanner_version","title":"<code>scanner_version = args['scanner_version']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.severity","title":"<code>severity = args['severity']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.target","title":"<code>target = args['target']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.target_type","title":"<code>target_type = args['target_type']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.time","title":"<code>time = args['time']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.version","title":"<code>version = args['version']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.weight","title":"<code>weight = args['weight']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco.RuleUse.__init__","title":"<code>__init__(args)</code>","text":"<p>Initialize given specified args.</p> Source code in <code>trestle/transforms/implementations/osco.py</code> <pre><code>def __init__(self, args: Dict[str, str]) -&gt; None:\n    \"\"\"Initialize given specified args.\"\"\"\n    self.id_ = args['id_']\n    self.target = args['target']\n    self.target_type = args['target_type']\n    self.host_name = args['host_name']\n    self.benchmark_href = args['benchmark_href']\n    self.benchmark_id = args['benchmark_id']\n    self.scanner_name = args['scanner_name']\n    self.scanner_version = args['scanner_version']\n    self.idref = args['idref']\n    self.version = args['version']\n    self.time = args['time']\n    self.result = args['result']\n    self.severity = args['severity']\n    self.weight = args['weight']\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/osco/#trestle.transforms.implementations.osco-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/","title":"trestle.transforms.implementations.tanium","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium","title":"<code>trestle.transforms.implementations.tanium</code>","text":"<p>Facilitate Tanium result to NIST OSCAL transformation.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.logger","title":"<code>logger = logging.getLogger(__name__)</code>  <code>module-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium-classes","title":"Classes","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse","title":"<code>RuleUse</code>","text":"<p>Represents one row of Tanium data.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>class RuleUse():\n    \"\"\"Represents one row of Tanium data.\"\"\"\n\n    def __init__(self, tanium_row: Dict[str, Any], comply: Dict[str, str], default_timestamp: str) -&gt; None:\n        \"\"\"Initialize given specified args.\"\"\"\n        logger.debug(f'tanium-row: {tanium_row}')\n        try:\n            # level 1 keys\n            self.computer_name = tanium_row['Computer Name']\n            self.tanium_client_ip_address = tanium_row['Tanium Client IP Address']\n            self.ip_address = str(tanium_row['IP Address'])\n            self.count = str(tanium_row['Count'])\n            # comply keys\n            self.check_id = comply['Check ID']\n            self.rule_id = comply['Rule ID']\n            self.state = comply['State']\n            # defaults\n            no_results = '[no results]'\n            self.check_id_level = no_results\n            self.check_id_version = no_results\n            self.check_id_benchmark = no_results\n            self.component = no_results\n            self.component_type = no_results\n            # parse\n            if ';' in self.check_id:\n                items = self.check_id.split(';')\n                if len(items) &gt; 2:\n                    self.check_id_level = items[2]\n                if len(items) &gt; 1:\n                    self.check_id_version = items[1]\n                if len(items) &gt; 0:\n                    self.check_id_benchmark = items[0]\n                    self.component = items[0]\n                    if self.component.startswith('CIS '):\n                        self.component = self.component[len('CIS '):]\n                    if self.component.endswith(' Benchmark'):\n                        self.component = self.component[:-len(' Benchmark')]\n                    self.component_type = 'Operating System'\n            # timestamp\n            self.timestamp = comply.get('Timestamp', default_timestamp)\n            # collected\n            self.collected = default_timestamp\n        except Exception as e:\n            logger.debug(f'tanium-row: {tanium_row}')\n            logger.debug(e)\n            logger.debug(traceback.format_exc())\n            raise e\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.check_id","title":"<code>check_id = comply['Check ID']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.check_id_benchmark","title":"<code>check_id_benchmark = no_results</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.check_id_level","title":"<code>check_id_level = no_results</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.check_id_version","title":"<code>check_id_version = no_results</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.collected","title":"<code>collected = default_timestamp</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.component","title":"<code>component = no_results</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.component_type","title":"<code>component_type = no_results</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.computer_name","title":"<code>computer_name = tanium_row['Computer Name']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.count","title":"<code>count = str(tanium_row['Count'])</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.ip_address","title":"<code>ip_address = str(tanium_row['IP Address'])</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.rule_id","title":"<code>rule_id = comply['Rule ID']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.state","title":"<code>state = comply['State']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.tanium_client_ip_address","title":"<code>tanium_client_ip_address = tanium_row['Tanium Client IP Address']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.timestamp","title":"<code>timestamp = comply.get('Timestamp', default_timestamp)</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUse.__init__","title":"<code>__init__(tanium_row, comply, default_timestamp)</code>","text":"<p>Initialize given specified args.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>def __init__(self, tanium_row: Dict[str, Any], comply: Dict[str, str], default_timestamp: str) -&gt; None:\n    \"\"\"Initialize given specified args.\"\"\"\n    logger.debug(f'tanium-row: {tanium_row}')\n    try:\n        # level 1 keys\n        self.computer_name = tanium_row['Computer Name']\n        self.tanium_client_ip_address = tanium_row['Tanium Client IP Address']\n        self.ip_address = str(tanium_row['IP Address'])\n        self.count = str(tanium_row['Count'])\n        # comply keys\n        self.check_id = comply['Check ID']\n        self.rule_id = comply['Rule ID']\n        self.state = comply['State']\n        # defaults\n        no_results = '[no results]'\n        self.check_id_level = no_results\n        self.check_id_version = no_results\n        self.check_id_benchmark = no_results\n        self.component = no_results\n        self.component_type = no_results\n        # parse\n        if ';' in self.check_id:\n            items = self.check_id.split(';')\n            if len(items) &gt; 2:\n                self.check_id_level = items[2]\n            if len(items) &gt; 1:\n                self.check_id_version = items[1]\n            if len(items) &gt; 0:\n                self.check_id_benchmark = items[0]\n                self.component = items[0]\n                if self.component.startswith('CIS '):\n                    self.component = self.component[len('CIS '):]\n                if self.component.endswith(' Benchmark'):\n                    self.component = self.component[:-len(' Benchmark')]\n                self.component_type = 'Operating System'\n        # timestamp\n        self.timestamp = comply.get('Timestamp', default_timestamp)\n        # collected\n        self.collected = default_timestamp\n    except Exception as e:\n        logger.debug(f'tanium-row: {tanium_row}')\n        logger.debug(e)\n        logger.debug(traceback.format_exc())\n        raise e\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUseFactory","title":"<code>RuleUseFactory</code>","text":"<p>Build RuleUse list.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>class RuleUseFactory():\n    \"\"\"Build RuleUse list.\"\"\"\n\n    def __init__(self, timestamp: str) -&gt; None:\n        \"\"\"Initialize given specified args.\"\"\"\n        self._timestamp = timestamp\n\n    def _make_sublist(self, tanium_row: Dict[str, Any]) -&gt; List[RuleUse]:\n        \"\"\"Build RuleUse sublist from input data item.\"\"\"\n        retval = []\n        keys = tanium_row\n        for key in keys:\n            if key.startswith('Comply'):\n                break\n        comply_list = tanium_row[key]\n        for comply in comply_list:\n            rule_use = RuleUse(tanium_row, comply, self._timestamp)\n            retval.append(rule_use)\n        return retval\n\n    def make_list(self, blob: str) -&gt; List[RuleUse]:\n        \"\"\"Build RuleUse list from input data.\"\"\"\n        retval = []\n        lines = blob.splitlines()\n        for line in lines:\n            line = line.strip()\n            if line:\n                jdata = json.loads(line)\n                if type(jdata) is list:\n                    for item in jdata:\n                        logger.debug(f'item: {item}')\n                        retval += self._make_sublist(item)\n                else:\n                    logger.debug(f'jdata: {jdata}')\n                    retval += self._make_sublist(jdata)\n        logger.debug(f'ru_list: {len(retval)}')\n        return retval\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUseFactory-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUseFactory.__init__","title":"<code>__init__(timestamp)</code>","text":"<p>Initialize given specified args.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>def __init__(self, timestamp: str) -&gt; None:\n    \"\"\"Initialize given specified args.\"\"\"\n    self._timestamp = timestamp\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.RuleUseFactory.make_list","title":"<code>make_list(blob)</code>","text":"<p>Build RuleUse list from input data.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>def make_list(self, blob: str) -&gt; List[RuleUse]:\n    \"\"\"Build RuleUse list from input data.\"\"\"\n    retval = []\n    lines = blob.splitlines()\n    for line in lines:\n        line = line.strip()\n        if line:\n            jdata = json.loads(line)\n            if type(jdata) is list:\n                for item in jdata:\n                    logger.debug(f'item: {item}')\n                    retval += self._make_sublist(item)\n            else:\n                logger.debug(f'jdata: {jdata}')\n                retval += self._make_sublist(jdata)\n    logger.debug(f'ru_list: {len(retval)}')\n    return retval\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory","title":"<code>TaniumOscalFactory</code>","text":"<p>Build Tanium OSCAL entities.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>class TaniumOscalFactory():\n    \"\"\"Build Tanium OSCAL entities.\"\"\"\n\n    def __init__(\n        self,\n        timestamp: str,\n        rule_use_list: List[RuleUse],\n        blocksize: int = 11000,\n        cpus_max: int = 1,\n        cpus_min: int = 1,\n        checking: bool = False,\n        caching: bool = True,\n        aggregate: bool = True\n    ) -&gt; None:\n        \"\"\"Initialize given specified args.\"\"\"\n        self._rule_use_list = rule_use_list\n        self._timestamp = timestamp\n        self._component_map: Dict[str, SystemComponent] = {}\n        self._inventory_map: Dict[str, InventoryItem] = {}\n        self._observation_list: List[Observation] = []\n        self._ns = 'https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium'\n        self._cpus = None\n        self._checking = checking\n        self._caching = caching\n        self._aggregate = aggregate\n        self._result = None\n        # blocksize: default, min\n        self._blocksize = blocksize\n        if self._blocksize &lt; 1:\n            self._blocksize = 1\n        # cpus max: default, max, min\n        self._cpus_max = cpus_max\n        if self._cpus_max &gt; os.cpu_count():\n            self._cpus_max = os.cpu_count()\n        self._cpus_min = cpus_min\n        if self._cpus_min &gt; self._cpus_max:\n            self._cpus_min = self._cpus_max\n        if self._cpus_min &lt; 1:\n            self._cpus_min = 1\n        self._property_accounting = PropertyAccounting()\n        self._property_manager = PropertyManager(caching=caching, checking=checking)\n\n    def _is_duplicate_component(self, rule_use: RuleUse) -&gt; bool:\n        \"\"\"Check for duplicate component.\"\"\"\n        retval = False\n        component_type = rule_use.component_type\n        component_title = rule_use.component\n        for component in self._component_map.values():\n            if component.type != component_type:\n                continue\n            if component.title != component_title:\n                continue\n            retval = True\n            break\n        return retval\n\n    def _derive_components(self) -&gt; None:\n        \"\"\"Derive components from RuleUse list.\"\"\"\n        self._component_map: Dict[str, SystemComponent] = {}\n        for rule_use in self._rule_use_list:\n            if self._is_duplicate_component(rule_use):\n                continue\n            component_type = rule_use.component_type\n            component_title = rule_use.component\n            # See Note in _get_component_ref.\n            component_description = rule_use.component\n            component_ref = _uuid_component()\n            status = Status(state='operational')\n            component = SystemComponent(\n                uuid=component_ref,\n                type=component_type,\n                title=component_title,\n                description=component_description,\n                status=status\n            )\n            self._component_map[component_ref] = component\n\n    def _get_component_ref(self, rule_use: RuleUse) -&gt; Optional[str]:\n        \"\"\"Get component reference for specified rule use.\"\"\"\n        uuid = None\n        for component_ref, component in self._component_map.items():\n            if component.type != rule_use.component_type:\n                continue\n            if component.title != rule_use.component:\n                continue\n            # Note: currently title and description are the same,\n            # therefore checking description is not necessary.\n            uuid = component_ref\n            break\n        return uuid\n\n    def _derive_inventory(self) -&gt; None:\n        \"\"\"Derive inventory from RuleUse list.\"\"\"\n        self._inventory_map: Dict[str, InventoryItem] = {}\n        for rule_use in self._rule_use_list:\n            if rule_use.tanium_client_ip_address in self._inventory_map:\n                continue\n            inventory = InventoryItem(uuid=_uuid_inventory(), description='inventory')\n            inventory.props = [\n                self._property_manager.materialize(name='Computer_Name', value=rule_use.computer_name, ns=self._ns),\n                self._property_manager.materialize(\n                    name='Tanium_Client_IP_Address',\n                    value=rule_use.tanium_client_ip_address,\n                    ns=self._ns,\n                    class_='scc_inventory_item_id'\n                ),\n                self._property_manager.materialize(name='IP_Address', value=rule_use.ip_address, ns=self._ns),\n                self._property_manager.materialize(name='Count', value=rule_use.count, ns=self._ns)\n            ]\n            component_uuid = self._get_component_ref(rule_use)\n            if component_uuid is not None:\n                inventory.implemented_components = [ImplementedComponent(component_uuid=component_uuid)]\n            self._inventory_map[rule_use.tanium_client_ip_address] = inventory\n\n    def _get_inventory_ref(self, rule_use: RuleUse) -&gt; str:\n        \"\"\"Get inventory reference for specified rule use.\"\"\"\n        return self._inventory_map[rule_use.tanium_client_ip_address].uuid\n\n    def _conditional_include(\n        self,\n        props: List[Property],\n        group: str = None,\n        name: str = None,\n        value: str = None,\n        ns: str = None,\n        class_: str = None\n    ) -&gt; None:\n        \"\"\"Add non-aggregated property or remember common property.\"\"\"\n        if self._aggregate:\n            if self._property_accounting.is_common_property(group=group, name=name, value=value, ns=ns, class_=class_):\n                # common property\n                self._property_manager.put_common_property(group=group, name=name, value=value, ns=ns, class_=class_)\n                return\n        # non-aggregated property\n        props.append(self._property_manager.materialize(name=name, value=value, ns=ns, class_=class_))\n\n    def _get_observtion_properties(self, rule_use: RuleUse) -&gt; List[Property]:\n        \"\"\"Get observation properties.\"\"\"\n        props = []\n        group = self._get_component_ref(rule_use)\n        self._conditional_include(props=props, group=group, name='Check_ID', value=rule_use.check_id, ns=self._ns)\n        self._conditional_include(\n            props=props,\n            group=group,\n            name='Check_ID_Benchmark',\n            value=rule_use.check_id_benchmark,\n            ns=self._ns,\n            class_='scc_predefined_profile'\n        )\n        self._conditional_include(\n            props=props,\n            group=group,\n            name='Check_ID_Version',\n            value=rule_use.check_id_version,\n            ns=self._ns,\n            class_='scc_predefined_profile_version'\n        )\n        self._conditional_include(\n            props=props, group=group, name='Check_ID_Level', value=rule_use.check_id_level, ns=self._ns\n        )\n        self._conditional_include(\n            props=props,\n            group=group,\n            name='Rule_ID',\n            value=rule_use.rule_id,\n            ns=self._ns,\n            class_='scc_goal_description'\n        )\n        self._conditional_include(\n            props=props, group=group, name='Rule_ID', value=rule_use.rule_id, ns=self._ns, class_='scc_check_name_id'\n        )\n        self._conditional_include(\n            props=props, group=group, name='State', value=rule_use.state, ns=self._ns, class_='scc_result'\n        )\n        self._conditional_include(\n            props=props, group=group, name='Timestamp', value=rule_use.timestamp, ns=self._ns, class_='scc_timestamp'\n        )\n        return props\n\n    def _derive_common_property_accounting(self) -&gt; None:\n        \"\"\"Derive common properties accounting from RuleUse list.\"\"\"\n        for rule_use in self._rule_use_list:\n            group = self._get_component_ref(rule_use)\n            self._property_accounting.count_group(group=group)\n            self._property_accounting.count_property(group=group, name='Check_ID', value=rule_use.check_id, ns=self._ns)\n            self._property_accounting.count_property(\n                group=group,\n                name='Check_ID_Benchmark',\n                value=rule_use.check_id_benchmark,\n                ns=self._ns,\n                class_='scc_predefined_profile'\n            )\n            self._property_accounting.count_property(\n                group=group,\n                name='Check_ID_Version',\n                value=rule_use.check_id_version,\n                ns=self._ns,\n                class_='scc_predefined_profile_version'\n            )\n            self._property_accounting.count_property(\n                group=group, name='Check_ID_Level', value=rule_use.check_id_level, ns=self._ns\n            )\n            self._property_accounting.count_property(\n                group=group, name='Rule_ID', value=rule_use.rule_id, ns=self._ns, class_='scc_goal_description'\n            )\n            self._property_accounting.count_property(\n                group=group, name='Rule_ID', value=rule_use.rule_id, ns=self._ns, class_='scc_check_name_id'\n            )\n            self._property_accounting.count_property(\n                group=group, name='State', value=rule_use.state, ns=self._ns, class_='scc_result'\n            )\n            self._property_accounting.count_property(\n                group=group, name='Timestamp', value=rule_use.timestamp, ns=self._ns, class_='scc_timestamp'\n            )\n\n    # parallel process to process one chuck of entire data set\n    def _batch_observations(self, index: int) -&gt; Dict[str, List[Observation]]:\n        \"\"\"Derive batch of observations from RuleUse list.\"\"\"\n        observation_partial_map: Dict[str, List[Observation]] = {}\n        # determine which chunk to process\n        batch_size = (len(self._rule_use_list) // self._batch_workers) + 1\n        start = index * batch_size\n        end = (index + 1) * batch_size\n        end = min(end, len(self._rule_use_list))\n        logger.debug(f'start: {start} end: {end - 1}')\n        # process just the one chunk\n        for i in range(start, end):\n            rule_use = self._rule_use_list[i]\n            observation = Observation(\n                uuid=_uuid_observation(),\n                description=rule_use.rule_id,\n                methods=['TEST-AUTOMATED'],\n                collected=rule_use.collected\n            )\n            subject_uuid = self._get_inventory_ref(rule_use)\n            subject_reference = SubjectReference(subject_uuid=subject_uuid, type='inventory-item')\n            observation.subjects = [subject_reference]\n            observation.props = self._get_observtion_properties(rule_use)\n            observation_partial_map[subject_uuid] = observation_partial_map.get(subject_uuid, []) + [observation]\n        return observation_partial_map\n\n    @property\n    def _batch_workers(self) -&gt; int:\n        \"\"\"Calculate number of parallel processes to employ.\"\"\"\n        if self._cpus is None:\n            cpus_estimate = len(self._rule_use_list) // self._blocksize\n            self._cpus = max(min(cpus_estimate, self._cpus_max), self._cpus_min)\n            logger.debug(f'CPUs estimate: {cpus_estimate} available: {os.cpu_count()} selection: {self._cpus}')\n        return self._cpus\n\n    def _derive_observations(self) -&gt; None:\n        \"\"\"Derive observations from RuleUse list.\"\"\"\n        self._observation_map = {}\n        if self._batch_workers == 1:\n            # no need for multiprocessing\n            self._observation_map = self._batch_observations(0)\n        else:\n            # use multiprocessing to perform observations creation in parallel\n            pool = multiprocessing.Pool(processes=self._batch_workers)\n            rval_list = pool.map(self._batch_observations, range(self._batch_workers))\n            # gather observations from the sundry batch workers\n            for partial_observation_map in rval_list:\n                self._observation_map = join_key_to_list_dicts(self._observation_map, partial_observation_map)\n\n    @property\n    def components(self) -&gt; List[SystemComponent]:\n        \"\"\"OSCAL components.\"\"\"\n        return list(self._component_map.values())\n\n    @property\n    def inventory(self) -&gt; ValuesView[InventoryItem]:\n        \"\"\"OSCAL inventory.\"\"\"\n        return self._inventory_map.values()\n\n    @property\n    def observations(self) -&gt; List[Observation]:\n        \"\"\"OSCAL observations.\"\"\"\n        rval = []\n        # observations are partitioned by local-definition uuid; join them into one list\n        for key in self._observation_map:\n            list_ = self._observation_map[key]\n            for observation in list_:\n                rval.append(observation)\n        return rval\n\n    @property\n    def control_selections(self) -&gt; List[ControlSelection]:\n        \"\"\"OSCAL control selections.\"\"\"\n        rval = []\n        rval.append(ControlSelection())\n        return rval\n\n    @property\n    def reviewed_controls(self) -&gt; ReviewedControls:\n        \"\"\"OSCAL reviewed controls.\"\"\"\n        rval = ReviewedControls(control_selections=self.control_selections)\n        return rval\n\n    @property\n    def analysis(self) -&gt; List[str]:\n        \"\"\"OSCAL statistics.\"\"\"\n        analysis = []\n        analysis.append(f'components: {len(self.components)}')\n        analysis.append(f'inventory: {len(self.inventory)}')\n        analysis.append(f'observations: {len(self.observations)}')\n        analysis.append(f'cache: requests={self._property_manager.requests} hits={self._property_manager.hits}')\n        return analysis\n\n    def _get_local_definitions(self, system_component: SystemComponent) -&gt; LocalDefinitions1:\n        \"\"\"Get local definitions.\"\"\"\n        rval = LocalDefinitions1()\n        for component in self.components:\n            if component.uuid == system_component.uuid:\n                rval.components = [component]\n                rval.inventory_items = []\n                for inventory_item in self.inventory:\n                    for implemented_component in inventory_item.implemented_components:\n                        if implemented_component.component_uuid == system_component.uuid:\n                            rval.inventory_items.append(inventory_item)\n                break\n        return rval\n\n    def _get_local_definitions_uuids(self, local_definitions: LocalDefinitions1) -&gt; List[str]:\n        \"\"\"Get inventory uuids for given local definitions.\"\"\"\n        rval = []\n        if local_definitions.inventory_items:\n            rval = [inventory_item.uuid for inventory_item in local_definitions.inventory_items]\n        return rval\n\n    def _get_observations_for_uuid(self, uuid_: str) -&gt; List[Observation]:\n        \"\"\"Get observations for given uuid.\"\"\"\n        rval = 0\n        if uuid_ in self._observation_map:\n            rval = []\n            list_ = self._observation_map[uuid_]\n            for observation in list_:\n                rval.append(observation)\n        return rval\n\n    def _get_observations(self, local_definitions: LocalDefinitions1) -&gt; List[Observation]:\n        \"\"\"Get observations for given local definitions.\"\"\"\n        rval = []\n        local_definitions_uuids = self._get_local_definitions_uuids(local_definitions)\n        for uuid_ in local_definitions_uuids:\n            observations = self._get_observations_for_uuid(uuid_)\n            if observations:\n                rval += observations\n        return rval\n\n    def _get_properties(self, group: str) -&gt; List[Property]:\n        \"\"\"Get properties for given group.\"\"\"\n        return self._property_manager.get_common_properties(group)\n\n    @property\n    def results(self) -&gt; List[Result]:\n        \"\"\"OSCAL result.\"\"\"\n        if self._result is None:\n            self._derive_components()\n            self._derive_inventory()\n            if self._aggregate:\n                self._derive_common_property_accounting()\n            self._derive_observations()\n        results = []\n        for component in self.components:\n            local_definitions = self._get_local_definitions(component)\n            observations = self._get_observations(local_definitions)\n            result = Result(\n                uuid=_uuid_result(),\n                title='Tanium',\n                description='Tanium',\n                start=self._timestamp,\n                end=self._timestamp,\n                reviewed_controls=self.reviewed_controls,\n                local_definitions=local_definitions,\n                observations=observations\n            )\n            component_ref = component.uuid\n            result.props = self._get_properties(component_ref)\n            results.append(result)\n        return results\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory.analysis","title":"<code>analysis: List[str]</code>  <code>property</code>","text":"<p>OSCAL statistics.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory.components","title":"<code>components: List[SystemComponent]</code>  <code>property</code>","text":"<p>OSCAL components.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory.control_selections","title":"<code>control_selections: List[ControlSelection]</code>  <code>property</code>","text":"<p>OSCAL control selections.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory.inventory","title":"<code>inventory: ValuesView[InventoryItem]</code>  <code>property</code>","text":"<p>OSCAL inventory.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory.observations","title":"<code>observations: List[Observation]</code>  <code>property</code>","text":"<p>OSCAL observations.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory.results","title":"<code>results: List[Result]</code>  <code>property</code>","text":"<p>OSCAL result.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory.reviewed_controls","title":"<code>reviewed_controls: ReviewedControls</code>  <code>property</code>","text":"<p>OSCAL reviewed controls.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumOscalFactory.__init__","title":"<code>__init__(timestamp, rule_use_list, blocksize=11000, cpus_max=1, cpus_min=1, checking=False, caching=True, aggregate=True)</code>","text":"<p>Initialize given specified args.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>def __init__(\n    self,\n    timestamp: str,\n    rule_use_list: List[RuleUse],\n    blocksize: int = 11000,\n    cpus_max: int = 1,\n    cpus_min: int = 1,\n    checking: bool = False,\n    caching: bool = True,\n    aggregate: bool = True\n) -&gt; None:\n    \"\"\"Initialize given specified args.\"\"\"\n    self._rule_use_list = rule_use_list\n    self._timestamp = timestamp\n    self._component_map: Dict[str, SystemComponent] = {}\n    self._inventory_map: Dict[str, InventoryItem] = {}\n    self._observation_list: List[Observation] = []\n    self._ns = 'https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium'\n    self._cpus = None\n    self._checking = checking\n    self._caching = caching\n    self._aggregate = aggregate\n    self._result = None\n    # blocksize: default, min\n    self._blocksize = blocksize\n    if self._blocksize &lt; 1:\n        self._blocksize = 1\n    # cpus max: default, max, min\n    self._cpus_max = cpus_max\n    if self._cpus_max &gt; os.cpu_count():\n        self._cpus_max = os.cpu_count()\n    self._cpus_min = cpus_min\n    if self._cpus_min &gt; self._cpus_max:\n        self._cpus_min = self._cpus_max\n    if self._cpus_min &lt; 1:\n        self._cpus_min = 1\n    self._property_accounting = PropertyAccounting()\n    self._property_manager = PropertyManager(caching=caching, checking=checking)\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer","title":"<code>TaniumResultToOscalARTransformer</code>","text":"<p>               Bases: <code>ResultsTransformer</code></p> <p>Interface for Tanium transformer.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>class TaniumResultToOscalARTransformer(ResultsTransformer):\n    \"\"\"Interface for Tanium transformer.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self._modes = {}\n\n    @property\n    def analysis(self) -&gt; List[str]:\n        \"\"\"Return analysis info.\"\"\"\n        return self._analysis\n\n    @property\n    def blocksize(self) -&gt; int:\n        \"\"\"Return blocksize.\"\"\"\n        return self._modes.get('blocksize', 10000)\n\n    @property\n    def cpus_max(self) -&gt; int:\n        \"\"\"Return cpus_max.\"\"\"\n        return self._modes.get('cpus_max', 1)\n\n    @property\n    def cpus_min(self) -&gt; int:\n        \"\"\"Return cpus_min.\"\"\"\n        return self._modes.get('cpus_min', 1)\n\n    @property\n    def aggregate(self) -&gt; bool:\n        \"\"\"Return aggregate.\"\"\"\n        return self._modes.get('aggregate', True)\n\n    @property\n    def caching(self) -&gt; bool:\n        \"\"\"Return caching.\"\"\"\n        return self._modes.get('caching', True)\n\n    @property\n    def checking(self) -&gt; bool:\n        \"\"\"Return checking.\"\"\"\n        return self._modes.get('checking', False)\n\n    def set_modes(self, modes: Dict[str, Any]) -&gt; None:\n        \"\"\"Keep modes info.\"\"\"\n        if modes is not None:\n            self._modes = modes\n\n    def transform(self, blob: str) -&gt; Results:\n        \"\"\"Transform the blob into a Results.\"\"\"\n        ts0 = datetime.datetime.now()\n        results = Results()\n        ru_factory = RuleUseFactory(self.get_timestamp())\n        ru_list = ru_factory.make_list(blob)\n        tanium_oscal_factory = TaniumOscalFactory(\n            self.get_timestamp(),\n            ru_list,\n            self.blocksize,\n            self.cpus_max,\n            self.cpus_min,\n            self.checking,\n            self.caching,\n            self.aggregate\n        )\n        results.__root__ = tanium_oscal_factory.results\n        ts1 = datetime.datetime.now()\n        self._analysis = tanium_oscal_factory.analysis\n        self._analysis.append(f'transform time: {ts1 - ts0}')\n        return results\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.aggregate","title":"<code>aggregate: bool</code>  <code>property</code>","text":"<p>Return aggregate.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.analysis","title":"<code>analysis: List[str]</code>  <code>property</code>","text":"<p>Return analysis info.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.blocksize","title":"<code>blocksize: int</code>  <code>property</code>","text":"<p>Return blocksize.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.caching","title":"<code>caching: bool</code>  <code>property</code>","text":"<p>Return caching.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.checking","title":"<code>checking: bool</code>  <code>property</code>","text":"<p>Return checking.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_max","title":"<code>cpus_max: int</code>  <code>property</code>","text":"<p>Return cpus_max.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.cpus_min","title":"<code>cpus_min: int</code>  <code>property</code>","text":"<p>Return cpus_min.</p>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.__init__","title":"<code>__init__()</code>","text":"<p>Initialize.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self._modes = {}\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.set_modes","title":"<code>set_modes(modes)</code>","text":"<p>Keep modes info.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>def set_modes(self, modes: Dict[str, Any]) -&gt; None:\n    \"\"\"Keep modes info.\"\"\"\n    if modes is not None:\n        self._modes = modes\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumResultToOscalARTransformer.transform","title":"<code>transform(blob)</code>","text":"<p>Transform the blob into a Results.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>def transform(self, blob: str) -&gt; Results:\n    \"\"\"Transform the blob into a Results.\"\"\"\n    ts0 = datetime.datetime.now()\n    results = Results()\n    ru_factory = RuleUseFactory(self.get_timestamp())\n    ru_list = ru_factory.make_list(blob)\n    tanium_oscal_factory = TaniumOscalFactory(\n        self.get_timestamp(),\n        ru_list,\n        self.blocksize,\n        self.cpus_max,\n        self.cpus_min,\n        self.checking,\n        self.caching,\n        self.aggregate\n    )\n    results.__root__ = tanium_oscal_factory.results\n    ts1 = datetime.datetime.now()\n    self._analysis = tanium_oscal_factory.analysis\n    self._analysis.append(f'transform time: {ts1 - ts0}')\n    return results\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium.TaniumTransformer","title":"<code>TaniumTransformer</code>","text":"<p>               Bases: <code>TaniumResultToOscalARTransformer</code></p> <p>Legacy class name.</p> Source code in <code>trestle/transforms/implementations/tanium.py</code> <pre><code>class TaniumTransformer(TaniumResultToOscalARTransformer):\n    \"\"\"Legacy class name.\"\"\"\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/tanium/#trestle.transforms.implementations.tanium-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/","title":"trestle.transforms.implementations.xccdf","text":"<p>handler: python</p>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf","title":"<code>trestle.transforms.implementations.xccdf</code>","text":"<p>Facilitate OSCAL-XCCDF transformation.</p>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf-classes","title":"Classes","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse","title":"<code>RuleUse</code>","text":"<p>Represents one rule of XCCDF data.</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>class RuleUse():\n    \"\"\"Represents one rule of XCCDF data.\"\"\"\n\n    def __init__(self, args: Dict[str, str]) -&gt; None:\n        \"\"\"Initialize given specified args.\"\"\"\n        self.id_ = args['id_']\n        self.target = args['target']\n        self.target_type = args['target_type']\n        self.host_name = args['host_name']\n        self.benchmark_href = args['benchmark_href']\n        self.benchmark_id = args['benchmark_id']\n        self.scanner_name = args['scanner_name']\n        self.scanner_version = args['scanner_version']\n        self.idref = args['idref']\n        self.version = args['version']\n        self.time = args['time']\n        self.result = args['result']\n        self.severity = args['severity']\n        self.weight = args['weight']\n\n    @property\n    def inventory_key(self):\n        \"\"\"Derive inventory key.\"\"\"\n        if self.host_name is None:\n            # OpenScap 1.3.3\n            rval = self.target + ':' + self.target_type\n        else:\n            # OpenScap 1.3.5\n            rval = self.host_name + ':' + self.target_type\n        return rval\n\n    @property\n    def ns(self):\n        \"\"\"Derive namespace.\"\"\"\n        return f'https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/{self.scanner_name}'  # noqa: E231\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.benchmark_href","title":"<code>benchmark_href = args['benchmark_href']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.benchmark_id","title":"<code>benchmark_id = args['benchmark_id']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.host_name","title":"<code>host_name = args['host_name']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.id_","title":"<code>id_ = args['id_']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.idref","title":"<code>idref = args['idref']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.inventory_key","title":"<code>inventory_key</code>  <code>property</code>","text":"<p>Derive inventory key.</p>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.ns","title":"<code>ns</code>  <code>property</code>","text":"<p>Derive namespace.</p>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.result","title":"<code>result = args['result']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.scanner_name","title":"<code>scanner_name = args['scanner_name']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.scanner_version","title":"<code>scanner_version = args['scanner_version']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.severity","title":"<code>severity = args['severity']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.target","title":"<code>target = args['target']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.target_type","title":"<code>target_type = args['target_type']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.time","title":"<code>time = args['time']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.version","title":"<code>version = args['version']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.weight","title":"<code>weight = args['weight']</code>  <code>instance-attribute</code>","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.RuleUse.__init__","title":"<code>__init__(args)</code>","text":"<p>Initialize given specified args.</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>def __init__(self, args: Dict[str, str]) -&gt; None:\n    \"\"\"Initialize given specified args.\"\"\"\n    self.id_ = args['id_']\n    self.target = args['target']\n    self.target_type = args['target_type']\n    self.host_name = args['host_name']\n    self.benchmark_href = args['benchmark_href']\n    self.benchmark_id = args['benchmark_id']\n    self.scanner_name = args['scanner_name']\n    self.scanner_version = args['scanner_version']\n    self.idref = args['idref']\n    self.version = args['version']\n    self.time = args['time']\n    self.result = args['result']\n    self.severity = args['severity']\n    self.weight = args['weight']\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer","title":"<code>XccdfResultToOscalARTransformer</code>","text":"<p>               Bases: <code>ResultsTransformer</code></p> <p>Interface for Xccdf transformer.</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>class XccdfResultToOscalARTransformer(ResultsTransformer):\n    \"\"\"Interface for Xccdf transformer.\"\"\"\n\n    def __init__(self) -&gt; None:\n        \"\"\"Initialize.\"\"\"\n        self._modes = {}\n\n    @property\n    def analysis(self) -&gt; List[str]:\n        \"\"\"Analysis.\"\"\"\n        return self._results_factory.analysis\n\n    @property\n    def checking(self):\n        \"\"\"Return checking.\"\"\"\n        return self._modes.get('checking', False)\n\n    @property\n    def tags(self):\n        \"\"\"Return tags.\"\"\"\n        return self._tags\n\n    def set_tags(self, tags: Dict[str, str]) -&gt; None:\n        \"\"\"Keep tags info (property name to property class).\"\"\"\n        self._tags = tags\n\n    def set_title(self, title: str) -&gt; None:\n        \"\"\"Keep title info.\"\"\"\n        self._title = title\n\n    def set_description(self, description: str) -&gt; None:\n        \"\"\"Keep description info.\"\"\"\n        self._description = description\n\n    def set_type(self, type_: str) -&gt; None:\n        \"\"\"Keep type info.\"\"\"\n        self._type = type_\n\n    def set_modes(self, modes: Dict[str, Any]) -&gt; None:\n        \"\"\"Keep modes info.\"\"\"\n        if modes is not None:\n            self._modes = modes\n\n    def transform(self, blob: str) -&gt; Results:\n        \"\"\"Transform the blob into a Results.\n\n        The expected blob is a string that is one of:\n            - data from OpenShift Compliance Operator (json, yaml, xml)\n            - data from Auditree XCCDF fetcher/check (json)\n        \"\"\"\n        self._results_factory = _OscalResultsFactory(\n            self._title, self._description, self._type, self.get_timestamp(), self.checking, self.tags\n        )\n        results = self._ingest_xml(blob)\n        if results is None:\n            results = self._ingest_json(blob)\n        if results is None:\n            results = self._ingest_yaml(blob)\n        return results\n\n    def _ingest_xml(self, blob: str) -&gt; Optional[Results]:\n        \"\"\"Ingest xml data.\"\"\"\n        # ?xml data\n        if blob.startswith('&lt;?xml'):\n            resource = blob\n            self._results_factory.ingest_xml(resource)\n        else:\n            return None\n        results = Results()\n        results.__root__.append(self._results_factory.result)\n        return results\n\n    def _ingest_configmaps(self, jdata: dict) -&gt; None:\n        \"\"\"Ingest configmaps.\"\"\"\n        items = jdata['items']\n        for item in items:\n            if 'data' in item.keys():\n                data = item['data']\n                if 'results' in data:\n                    resource = item\n                    self._results_factory.ingest(resource)\n\n    def _ingest_auditree(self, jdata: dict) -&gt; None:\n        \"\"\"Ingest auditree.\"\"\"\n        for key in jdata.keys():\n            for group in jdata[key]:\n                for cluster in jdata[key][group]:\n                    if 'resources' in cluster:\n                        for resource in cluster['resources']:\n                            self._results_factory.ingest(resource)\n\n    def _ingest_json(self, blob: str) -&gt; Optional[Results]:\n        \"\"\"Ingest json data.\"\"\"\n        try:\n            # ? configmaps or auditree data\n            jdata = json.loads(blob)\n            # https://docs.openshift.com/container-platform/3.7/rest_api/api/v1.ConfigMap.html#Get-api-v1-namespaces-namespace-configmaps-name\n            if 'kind' in jdata.keys() and jdata['kind'] == 'ConfigMapList' and 'items' in jdata.keys():\n                self._ingest_configmaps(jdata)\n            # https://github.com/ComplianceAsCode/auditree-arboretum/blob/main/arboretum/kubernetes/fetchers/fetch_cluster_resource.py\n            else:\n                self._ingest_auditree(jdata)\n        except json.decoder.JSONDecodeError:\n            return None\n        results = Results()\n        results.__root__.append(self._results_factory.result)\n        return results\n\n    def _ingest_yaml(self, blob: str) -&gt; Results:\n        \"\"\"Ingest yaml data.\"\"\"\n        try:\n            # ? yaml data\n            yaml = YAML(typ='safe')\n            resource = yaml.load(blob)\n            self._results_factory.ingest(resource)\n        except Exception as e:\n            raise RuntimeError(e)\n        results = Results()\n        results.__root__.append(self._results_factory.result)\n        return results\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-attributes","title":"Attributes","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.analysis","title":"<code>analysis: List[str]</code>  <code>property</code>","text":"<p>Analysis.</p>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.checking","title":"<code>checking</code>  <code>property</code>","text":"<p>Return checking.</p>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.tags","title":"<code>tags</code>  <code>property</code>","text":"<p>Return tags.</p>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer-functions","title":"Functions","text":""},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.__init__","title":"<code>__init__()</code>","text":"<p>Initialize.</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>def __init__(self) -&gt; None:\n    \"\"\"Initialize.\"\"\"\n    self._modes = {}\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_description","title":"<code>set_description(description)</code>","text":"<p>Keep description info.</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>def set_description(self, description: str) -&gt; None:\n    \"\"\"Keep description info.\"\"\"\n    self._description = description\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_modes","title":"<code>set_modes(modes)</code>","text":"<p>Keep modes info.</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>def set_modes(self, modes: Dict[str, Any]) -&gt; None:\n    \"\"\"Keep modes info.\"\"\"\n    if modes is not None:\n        self._modes = modes\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_tags","title":"<code>set_tags(tags)</code>","text":"<p>Keep tags info (property name to property class).</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>def set_tags(self, tags: Dict[str, str]) -&gt; None:\n    \"\"\"Keep tags info (property name to property class).\"\"\"\n    self._tags = tags\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_title","title":"<code>set_title(title)</code>","text":"<p>Keep title info.</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>def set_title(self, title: str) -&gt; None:\n    \"\"\"Keep title info.\"\"\"\n    self._title = title\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.set_type","title":"<code>set_type(type_)</code>","text":"<p>Keep type info.</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>def set_type(self, type_: str) -&gt; None:\n    \"\"\"Keep type info.\"\"\"\n    self._type = type_\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfResultToOscalARTransformer.transform","title":"<code>transform(blob)</code>","text":"<p>Transform the blob into a Results.</p> The expected blob is a string that is one of <ul> <li>data from OpenShift Compliance Operator (json, yaml, xml)</li> <li>data from Auditree XCCDF fetcher/check (json)</li> </ul> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>def transform(self, blob: str) -&gt; Results:\n    \"\"\"Transform the blob into a Results.\n\n    The expected blob is a string that is one of:\n        - data from OpenShift Compliance Operator (json, yaml, xml)\n        - data from Auditree XCCDF fetcher/check (json)\n    \"\"\"\n    self._results_factory = _OscalResultsFactory(\n        self._title, self._description, self._type, self.get_timestamp(), self.checking, self.tags\n    )\n    results = self._ingest_xml(blob)\n    if results is None:\n        results = self._ingest_json(blob)\n    if results is None:\n        results = self._ingest_yaml(blob)\n    return results\n</code></pre>"},{"location":"reference/API/trestle/transforms/implementations/xccdf/#trestle.transforms.implementations.xccdf.XccdfTransformer","title":"<code>XccdfTransformer</code>","text":"<p>               Bases: <code>XccdfResultToOscalARTransformer</code></p> <p>Legacy class name.</p> Source code in <code>trestle/transforms/implementations/xccdf.py</code> <pre><code>class XccdfTransformer(XccdfResultToOscalARTransformer):\n    \"\"\"Legacy class name.\"\"\"\n</code></pre>"},{"location":"tutorials/cli/","title":"trestle CLI Overview and OSCAL usecases","text":"<p>The trestle CLI has three primary use cases:</p> <ul> <li>Serve as tooling to generate and manipulate OSCAL files directly by an end user. The objective is to reduce the complexity of creating and editing workflows. Example commands are: <code>trestle import</code>, <code>trestle create</code>, <code>trestle split</code>, <code>trestle merge</code>.</li> <li>Act as an automation tool that, by design, can be an integral part of a CI/CD pipeline e.g. <code>trestle validate</code>, <code>trestle tasks</code>.</li> <li>Allow governance of markdown documents so they conform to specific style or structure requirements.</li> </ul> <p>To support each of these use cases trestle creates an opinionated directory structure to manage governed documents.</p>"},{"location":"tutorials/cli/#opinionated-directory-structure","title":"Opinionated directory structure","text":"<p>Trestle relies on an opinionated directory structure (trestle workspace), similar to <code>git</code>, <code>go</code>, or <code>auditree</code>, to manage the workflow. Most trestle commands are restricted to working within an initialized directory tree.</p> <p>The directory structure setup by trestle has three major elements:</p> <ul> <li>A <code>.trestle</code> hidden folder.</li> <li>A <code>dist</code> folder.</li> <li>Folders for each of the top level OSCAL models.</li> </ul> <p>The outline of the schema is below:</p> <pre><code>.\n\u251c\u2500\u2500 .trestle\n\u251c\u2500\u2500 dist\n\u2502   \u251c\u2500\u2500 catalogs\n\u2502   \u251c\u2500\u2500 profiles\n\u2502   \u251c\u2500\u2500 component-definitions\n\u2502   \u251c\u2500\u2500 system-security-plans\n\u2502   \u251c\u2500\u2500 assessment-plans\n\u2502   \u251c\u2500\u2500 assessment-results\n\u2502   \u2514\u2500\u2500 plan-of-action-and-milestones\n\u251c\u2500\u2500 catalogs\n\u251c\u2500\u2500 profiles\n\u251c\u2500\u2500 component-definitions\n\u251c\u2500\u2500 system-security-plans\n\u251c\u2500\u2500 assessment-plans\n\u251c\u2500\u2500 assessment-results\n\u2514\u2500\u2500 plan-of-action-and-milestones\n</code></pre> <p><code>.trestle</code> directory is a special directory containing various trestle artefacts to help run various other commands. Examples include configuration files, caches and templates.</p> <p><code>dist</code> directory will contain the assembled version of the top level models located on the source model directories.</p> <p>The bulk of the folder structure is used to represent each of the top level schemas or top level models such as <code>catalogs</code> and <code>profiles</code>. For each of these directories the following root structure is maintained:</p> <pre><code>\u251c\u2500\u2500 .trestle\n\u2514\u2500\u2500 TOP_LEVEL_MODEL_PLURAL\n    \u2514\u2500\u2500 NAME_OF_MODEL_INSTANCE\n        \u2514\u2500\u2500 TOP_LEVEL_MODEL_NAME.{json,yaml,yml}\n</code></pre> <p>which appears, for a catalog a user decides is titled nist-800-53, as:</p> <pre><code>\u251c\u2500\u2500 .trestle\n\u2514\u2500\u2500 catalogs\n    \u2514\u2500\u2500 nist-800-53\n        \u2514\u2500\u2500 catalog.json\n</code></pre> <p>In most of the places in the documentation we use <code>json</code> format for specifying model files, but they are equally applicable to <code>yaml</code> format also. The default format is <code>json</code>, and <code>yaml</code> is supported on best effort basis. Within one model directory the two different formats should not be mixed.</p>"},{"location":"tutorials/cli/#support-for-subdivided-document-structures","title":"Support for subdivided document structures","text":"<p>The files constructed by OSCAL can run into tens of thousands of lines of yaml or formatted json. At this size the files become completely unmanageable for users. To combat this, trestle can <code>trestle split</code> a file into many smaller files and later merge those split files together.</p> <p>Directory structures such as the one below can represent OSCAL document structures. Users are strongly encourage to rely on split and merge to code these structures.</p> <p>Users can query the contents of files using <code>trestle describe</code>, and probe the contents more deeply using it in combination with element paths.</p> <pre><code>.\n\u251c\u2500\u2500 .trestle\n\u251c\u2500\u2500 dist \n\u2502   \u2514\u2500\u2500 catalogs\n\u2502       \u2514\u2500\u2500 nist800-53.json \n\u2514\u2500\u2500 catalogs\n    \u2514\u2500\u2500 nist800-53\n        \u251c\u2500\u2500 catalog.json\n        \u2514\u2500\u2500 catalog\n            \u251c\u2500\u2500 metadata.json\n            \u251c\u2500\u2500 metadata\n            \u2502   \u251c\u2500\u2500 revision-history\n            \u2502   \u2502   \u251c\u2500\u2500 00000__revision-history.json\n            \u2502   \u2502   \u251c\u2500\u2500 00001__revision-history.json\n            \u2502   \u2502   \u2514\u2500\u2500 00002__revision-history.json   \n            \u2502   \u2514\u2500\u2500 responsible-parties\n            \u2502       \u251c\u2500\u2500 creator__responsible-party.json\n            \u2502       \u2514\u2500\u2500 contact__responsible-party.json       \n            \u2514\u2500\u2500 groups\n                \u251c\u2500\u2500 00000__group.json        \n                \u251c\u2500\u2500 00000__group\n                \u2502   \u2514\u2500\u2500 controls\n                \u2502       \u251c\u2500\u2500 00000__control.json\n                \u2502       \u2514\u2500\u2500 00001__control.json\n                \u251c\u2500\u2500 00001__group.json \n                \u2514\u2500\u2500 00001__group\n                    \u2514\u2500\u2500 controls\n                        \u251c\u2500\u2500 00000__control.json\n                        \u2514\u2500\u2500 00001__control.json\n...\n</code></pre>"},{"location":"tutorials/cli/#specifying-attributes-elements-within-trestle-commands","title":"Specifying attributes / elements within trestle commands.","text":"<p>OSCAL models are rich and contain multiple nested data structures. Given this, a mechanism is required to address elements /attributes within an oscal object.</p> <p>This accessing method is called 'element path' and is similar to jsonPath. Commands provide element path by a <code>-e</code> argument where available, e.g. trestle split -f catalog.json -e 'catalog.metadata.*'. This path is used whenever specifying an attribute or model, rather than exposing trestle's underlying object model name. Users can refer to NIST's json outline to understand object names in trestle.</p>"},{"location":"tutorials/cli/#rules-for-element-path","title":"Rules for element path","text":"<ol> <li>Element path is an expression of the attribute names, in json form , concatenated by a period (<code>.</code>).</li> <li>E.g. The metadata in a catalog is referred to as <code>catalog.metadata</code></li> <li>Element paths are relative to the file.</li> <li>e.g. For <code>metadata.json</code> roles would be referred to as <code>metadata.roles</code>, from the catalog file that would be <code>catalog.metadata.roles</code></li> <li>Arrays can be handled by a wild card <code>*</code> or a numerical index for a specific index.</li> <li><code>catalog.groups.*</code> to refer to each group in a catalog</li> <li><code>catalog.groups.*.controls.*</code> to refer to 'for each control under a top level group'</li> <li>For NIST 800-53 <code>catalog.groups.0.controls.0.</code></li> <li>On *nix platforms if using the wildcard the element path argument should be wrapped in quotes to prevent problems with the shell interpreting the wild card before trestle can</li> <li>When dealing with an array based object, the array syntax may be skipped when passing a model</li> <li>e.g. a control could be <code>catalog.controls.control</code> or <code>catalog.groups.controls.control</code></li> <li>This syntax is required as OSCAL, across the schema, has conflicting element definitions.</li> </ol>"},{"location":"tutorials/cli/#a-note-for-software-developers-using-trestle","title":"A note for software developers using trestle.","text":"<p>Trestle provides utilities for converting from element path to trestle's python object model. The (slightly simplified) model is:</p> <ol> <li>Class attributes are converted from <code>dash-case</code> to <code>dash_case</code> (aka snake_case)</li> <li>Class names are converted from <code>dash-case</code> to <code>DashCase</code> (aka CamelCase)</li> </ol>"},{"location":"tutorials/cli/#trestle-version","title":"<code>trestle version</code>","text":"<p>This command will return the current version of Trestle and OSCAL it is using.</p> <p>Running <code>trestle version</code> will return:</p> <p>Trestle version v2.0.0 based on OSCAL version 1.0.4</p> <p>It can also be used to retrieve the metadata version of the OSCAL object:</p> <pre><code>\"catalog\": {\n\n    \"uuid\": \"fa3f44a8-25cd-4f6a-8175-7afe647df7ed\",\n\n    \"metadata\": {\n\n      \"title\": \"Catalog1\",\n\n      \"last-modified\": \"2023-01-11T17:04:02.840910+00:00\",\n\n      \"version\": \"0.1.10\", &lt;&lt;&lt; this version here\n\n      \"oscal-version\": \"1.0.4\"\n\n    },\n...\n</code></pre> <ul> <li><code>-t or --type</code> - a type of the OSCAL object (can be either catalog, profile, component-definition, system-security-plan, etc)</li> <li><code>-n or --name</code> - a name of the OSCAL object</li> </ul> <p>Running <code>trestle version -n nist -t catalog</code> will return:</p> <p>Version of OSCAL object of nist catalog is: 1.0.0</p>"},{"location":"tutorials/cli/#trestle-init","title":"<code>trestle init</code>","text":"<p>This command will create (initialize) a trestle workspace in the current directory with the necessary directory structure and trestle artefacts. This command has multiple modes that it can run in:</p> <ul> <li><code>--full</code></li> <li><code>--local</code></li> <li><code>--govdocs</code></li> </ul> <p>By default <code>trestle init</code> will run in the <code>--full</code> mode.</p> <p><code>--full</code> mode is meant to be used when full functionality of Trestle is used i.e. managing OSCAL models locally, govern documents or using Trestle for API purposes. <code>dist</code> repository will be used when <code>trestle assemble</code> command is used. Running <code>trestle init --full</code> will create the directory structure below for different artefacts:</p> <pre><code>.\n\u251c\u2500\u2500 .trestle\n\u251c\u2500\u2500 dist\n\u2502   \u251c\u2500\u2500 catalogs\n\u2502   \u251c\u2500\u2500 profiles\n\u2502   \u251c\u2500\u2500 component-definitions\n\u2502   \u251c\u2500\u2500 system-security-plans\n\u2502   \u251c\u2500\u2500 assessment-plans\n\u2502   \u251c\u2500\u2500 assessment-results\n\u2502   \u2514\u2500\u2500 plan-of-action-and-milestones\n\u251c\u2500\u2500 catalogs\n\u251c\u2500\u2500 profiles\n\u251c\u2500\u2500 component-definitions\n\u251c\u2500\u2500 system-security-plans\n\u251c\u2500\u2500 assessment-plans\n\u251c\u2500\u2500 assessment-results\n\u2514\u2500\u2500 plan-of-action-and-milestones\n</code></pre> <p><code>--local</code> mode is meant to be used when Trestle is used to only manage OSCAL models locally. Running <code>trestle init --local</code> will create the directory structure below for different artefacts:</p> <pre><code>.\n\u251c\u2500\u2500 .trestle\n\u251c\u2500\u2500 catalogs\n\u251c\u2500\u2500 profiles\n\u251c\u2500\u2500 component-definitions\n\u251c\u2500\u2500 system-security-plans\n\u251c\u2500\u2500 assessment-plans\n\u251c\u2500\u2500 assessment-results\n\u2514\u2500\u2500 plan-of-action-and-milestones\n</code></pre> <p><code>--govdocs</code> mode is meant to be used when Trestle is only used to govern documents. Running <code>trestle init --govdocs</code> will create the directory structure below:</p> <pre><code>.\n\u251c\u2500\u2500 .trestle\n</code></pre> <p><code>.trestle</code> directory is a special directory containing various trestle artefacts to help run various other commands.</p> <p><code>dist</code> directory will contain the merged or assembled version of the top level models located on the source model directories which are: <code>catalogs</code>, <code>profiles</code>, <code>component-definitions</code>, <code>system-security-plans</code>, <code>assessment-plans</code>, <code>assessment-results</code> and <code>plan-of-action-and-milestones</code>.</p> <p>Notice that trestle is a highly opinionated tool and, therefore, the names of the files and directories that are created by any of the <code>trestle</code> commands and subcommands MUST NOT be changed manually.</p>"},{"location":"tutorials/cli/#trestle-create","title":"<code>trestle create</code>","text":"<p>This command will create a bare-bones sample file for one of the top level OSCAL models, and it can also create new elements within an existing file.  For example, <code>trestle create -t catalog -o nist800-53</code> will create a sample catalog file, <code>catalog.json</code> in the catalog subdirectory, <code>nist800-53</code> as shown below:</p> <pre><code>.\n\u251c\u2500\u2500 .trestle\n\u2514\u2500\u2500 catalogs\n    \u2514\u2500\u2500 nist800-53\n        \u2514\u2500\u2500 catalog.json\n...\n</code></pre> <p>The <code>-t</code> specifies the type of the model to create, which can be one of catalog, profile, component-definition, system-security-plan, assessment-plan, assessment-results, plan-of-action-and-milestones.  Each type will be created in its corresponding directory, such as catalogs, profiles, etc.</p> <p>The following additional options are supported:</p> <ul> <li><code>-o or --output</code>: specifies the name/alias of a model. It is used as the prefix for the output filename under the <code>dist</code> directory and for naming the source subdirectories under  <code>catalogs</code>, <code>profiles</code>, <code>component-definitions</code>, <code>system-security-plans</code>, <code>assessment-plans</code>, <code>assessment-results</code> or <code>plan-of-action-and-milestones</code>.</li> </ul> <p>The user can edit the parts of the generated OSCAL model by modifying the sample content in those directories.</p> <p>Passing <code>-iof</code> or <code>--include-optional-fields</code> will make <code>trestle create</code> generate a richer model containing all optional fields until finding recursion in the model (e.g controls within control).</p> <p>In addition, <code>trestle create</code> can create new components within an existing file by specifying the existing file name and the corresponding element path to create within that file.</p> <p>For example,</p> <p><code>$TRESTLE_BASEDIR/catalogs/nist800-53$ trestle create -f ./catalog.json -e catalog.metadata.roles</code></p> <p>will add the following property under the <code>metadata</code> property for a catalog that will be written to the appropriate file under <code>catalogs/nist800-53</code> directory:</p> <pre><code>{\n  \"roles\": [\n    {\n      \"id\": \"REPLACE_ME\",\n      \"title\": \"REPLACE_ME\"\n    }\n  ]\n}\n</code></pre> <p>Default values for mandatory datatypes will be like below. All UUID's will be populated by default whether or not they are mandatory.</p> <pre><code>  - DateTime: &lt;Current date-time&gt;\n  - Boolean: false\n  - Integer: 0\n  - String: REPLACE_ME\n  - Float/Double: 0.00\n  - Id field: Auto generated UUID\n</code></pre> <p>Again, passing <code>-iof</code> or <code>--include-optional-fields</code> will make <code>trestle create</code> generate a richer version of the element being created, by including optional fields.</p>"},{"location":"tutorials/cli/#trestle-import","title":"<code>trestle import</code>","text":"<p>This command allows users to import existing OSCAL files so that they can be managed using trestle. For example <code>trestle import -f /local_dir/existing_catalog.json -o my_existing_catalog</code> will import <code>existing_catalog.json</code> into a new folder under <code>catalogs</code> as shown below:</p> <pre><code>.\n\u251c\u2500\u2500 .trestle\n\u2514\u2500\u2500 catalogs\n    \u2514\u2500\u2500 my_existing_catalog\n        \u2514\u2500\u2500 catalog.json\n...\n</code></pre> <p>The following options are supported:</p> <ul> <li><code>-f or --file</code>: specifies the path of an existing OSCAL file or URL to a remote file.</li> <li><code>-o or --output</code>: specifies the name/alias of a model. It is used as the prefix for the output filename under the <code>dist</code> directory and for naming the source subdirectories under  <code>catalogs</code>, <code>profiles</code>, <code>component-definitions</code>, <code>system-security-plans</code>, <code>assessment-plans</code>, <code>assessment-results</code> or <code>plan-of-action-and-milestones</code>.</li> </ul> <p>The <code>--file</code> option may be an absolute or relative path, and it may be a URL.  For details on allowed formats please see the documentation for the <code>href</code> command.  The file must be imported from outside the current trestle directory or an error will result.</p> <p>The import subcommand can determine the type of the model that is to be imported by the contents of the file.  But the file name must end with an allowed json or yaml extension: <code>.json, .yaml, .yml</code></p> <p>During the import process the file must pass the <code>validate</code> test described below for the command, <code>validate</code>.  If the file does not pass validation a warning will be given describing the nature of the problem and the import will fail.</p> <p>Once a file has been imported it can be split into a rich tree of sub-components as shown at the top of this document.  But the file must be imported first.</p>"},{"location":"tutorials/cli/#trestle-replicate","title":"<code>trestle replicate</code>","text":"<p>This command allows users to replicate a certain OSCAL model (file and directory structure). For example <code>trestle replicate catalog -n cat1 -o cat11</code> will replicate the Catalog cat1 into <code>cat11</code> directory. It can also regenerate all the UUIDs as required.</p>"},{"location":"tutorials/cli/#trestle-split","title":"<code>trestle split</code>","text":"<p>This command allows users to further decompose a trestle model into additional subcomponents.</p> <p>The following options are currently supported:</p> <ul> <li><code>-f or --file</code>: this is optional and specifies the file path of the json/yaml file containing the elements that will be split.</li> <li><code>-e or --elements</code>: specifies the model subcomponent element(s) (JSON/YAML property path) that is/are going to be split. Multiple elements can be specified at once using a comma-separated value, e.g <code>-e 'catalog.metadata,catalog.groups'</code>.  Make sure to include the quotes that enclose the comma-separated paths.</li> </ul> <p>If the element is of JSON/YAML type array list and you want trestle to create a separate subcomponent file per array item, the element needs to be suffixed with <code>.*</code>, e.g. <code>-e 'catalog.groups.*'</code>. If the suffix is not specified, split will place all array items in only one separate subcomponent file, e.g. <code>'groups.json'</code>.  Again, make sure to include the quotes around the elements.</p> <p>If you just want to split a file into all its constituent parts and the file does not contain a simple list of objects, you can still use <code>*</code> and the file will be split into all its non-trivial elements.  Thus if you split a catalog with <code>-e catalog.*</code> the result will be a new directory, <code>catalog</code>, containing files representing the large items, <code>back-matter.json, groups.json and metadata.json</code>, but there will still be a <code>catalog.json</code> file containing just the catalog's <code>uuid</code>.  Small items such as strings and dates cannot be split off and will remain in the original model file that is being split.</p> <p>Here are some examples.  Starting with a single catalog file, <code>my_catalog/catalog.json</code>, if you do <code>trestle split -f catalog.json -e 'catalog.*'</code> you end up with:</p> <pre><code>catalogs\n \u2517 my_catalog\n \u2503 \u2523 catalog\n \u2503 \u2503 \u2523 back-matter.json\n \u2503 \u2503 \u2523 groups.json\n \u2503 \u2503 \u2517 metadata.json\n \u2503 \u2517 catalog.json\n</code></pre> <p>If you then split roles out of metadata as a single file containing a list of roles, <code>trestle split -f catalog/metadata.json -e 'metadata.roles'</code> you would end up with:</p> <pre><code>catalogs\n \u2517 my_catalog\n \u2503 \u2523 catalog\n \u2503 \u2503 \u2523 metadata\n \u2503 \u2503 \u2503 \u2517 roles.json\n \u2503 \u2503 \u2523 back-matter.json\n \u2503 \u2503 \u2523 groups.json\n \u2503 \u2503 \u2517 metadata.json\n \u2503 \u2517 catalog.json\n</code></pre> <p>If instead you had specified <code>-e 'metadata.roles.*'</code> you would get:</p> <pre><code>my_catalog\n \u2523 catalog\n \u2503 \u2523 metadata\n \u2503 \u2503 \u2517 roles\n \u2503 \u2503 \u2503 \u2523 00000__role.json\n \u2503 \u2503 \u2503 \u2517 00001__role.json\n \u2503 \u2523 back-matter.json\n \u2503 \u2523 groups.json\n \u2503 \u2517 metadata.json\n \u2517 catalog.json\n</code></pre> <p>You can see there is no <code>roles.json</code> file anymore and instead there is a subdirectory, <code>roles</code> containing a list of files, one for each <code>role</code>.</p> <p>If the <code>-f or --file</code> option is not specified, the file to split will be determined from the elements specified, in the context of the current working directory.  The current directory must be within a specific model (e.g. <code>catalog</code> or <code>profile</code>), and the element paths must either be absolute (e.g. <code>catalog.metadata.roles</code>) or relative to the current working directory.  For example, if you are in <code>catalogs/mycat/catalog/groups</code> and you want to split the file <code>00000__group.json</code>, you must use <code>-f</code> to specify the filename, and the element path can either be absolute, as <code>catalog.group.*</code>, or you can set the current working directory to where the file is and use element path <code>group.*</code>.  This makes it easier to specify splits when deep in a directory structure.</p> <p>Every subdirectory in a trestle directory model should have a corresponding <code>.json</code> or <code>.yaml</code> file with the same name, except when that subdirectory corresponds to a list of items, such as <code>catalog.groups</code>. When those subcomponents are split/expanded each file or subdirectory under them represents an item of the collection. Because of that, if a corresponding <code>groups.json | groups.yaml</code> file were to exist, its contents would just be an empty representation of that collection and the user would need to be careful never to edit that file. Therefore, we decided not to create that corresponding file in those cases. Following the same logic, another exception is when all the fields from a <code>.json | .yaml</code> file are split, leaving the original file as an empty object. In that case, the file would be deleted as well.</p> <p>To inspect a file to see what elements can be split from it, use the <code>describe</code> command described below.  It is also useful for inspection of files created by the split operation.</p>"},{"location":"tutorials/cli/#trestle-merge","title":"<code>trestle merge</code>","text":"<p>The trestle merge command is the reversal of <code>trestle split</code>. This command allows users to reverse the decomposition of a trestle model by aggregating subcomponents scattered across multiple files or directories into the parent JSON/YAML file. To merge a model, you have to first change working directory to the root model component directory that you want to merge a sub-component model into. The following option is required:</p> <ul> <li><code>-e or --elements</code>: specifies the properties (JSON/YAML path) that will be merged, relative to the current working directory. This must contain at least 2 elements, where the last element is the model/sub-component to be merged into the second from last component.</li> </ul> <p>For example, in the command <code>trestle merge -e 'catalog.metadata'</code>, executed in the same directory where <code>catalog.json</code> or the split <code>catalog</code> directory exists, the property <code>metadata</code> from <code>metadata.json</code> would be moved/merged into <code>catalog.json</code>. If the <code>metadata</code> model has already been split into smaller sub-component models previously, those smaller sub-components are first recusively merged into <code>metadata</code>, before merging <code>metadata</code> subcomponent into <code>catalog</code>. To specify merging every sub-component split from a component, <code>.*</code> can be used. For example, <code>trestle merge -e 'catalog.*'</code> command, issued from the directory where <code>catalog.json</code> or<code>catalog</code> directory exists, will merge every single sub-component of that catalog back into the <code>catalog.json</code>.</p>"},{"location":"tutorials/cli/#trestle-describe","title":"<code>trestle describe</code>","text":"<p>This command lets users inspect model files to explore contents using an optional element path.  The command can work well in concert with <code>split</code> to show what each file contains, and probe within the contents to determine sub-components that can be extracted as separate files.</p> <p>Unlike split, describe only describes the contents of a single item, so the element path may not contain wildcards (<code>*</code>) or commas.</p> <p>For example, if a catalog file has been imported to <code>catalogs/my_catalog/catalog.json</code> then the commmand, <code>trestle describe -f catalog.json</code> might yield:</p> <pre><code>#Model file catalog.json is of type catalog.Catalog and contains\nuuid: 613fca2d-704a-42e7-8e2b-b206fb92b456\nmetadata: common.Metadata\nparams: None\ncontrols: None\ngroups: list of 20 items of type catalog.Group\nback_matter: common.BackMatter\n</code></pre> <p>Note that contents are listed even when they are empty (and therefore optional) so the full potential contents can be seen.  Also note that if an item corresponds to a list of elements, the number and type of elements is provided.  Finally, if an item is a simple string such as <code>id</code>, <code>uuid</code> or <code>title</code>, the string is shown directly up to a maximum of 100 characters.  If the string is clipped it will be indicated by <code>[truncated]</code> at the end of the string.</p> <p>An element path can be specified to probe the contents, as in <code>trestle describe -f catalog.json -e 'catalog.metadata.roles'</code>.  A possible response is:</p> <pre><code>Model file catalog.json at element path catalog.metadata.roles is a list of 2 items of type common.Role\n</code></pre> <p>You can also query individual elements, and elements of an element, e.g. <code>trestle describe -f catalog.json -e 'catalog.groups.5.controls.3'</code></p> <pre><code># Model file catalog.json at element path catalog.groups.5.controls.3 is of type catalog.Control and contains:\nid: cp-4\nclass_: SP800-53\ntitle: Contingency Plan Testing\nparams: list of 2 items of type common.Parameter\nprops: list of 2 items of type common.Property\nlinks: list of 14 items of type common.Link\nparts: list of 2 items of type common.Part\ncontrols: list of 5 items of type catalog.Control\n</code></pre> <p>(Note that the numbering starts at 0, so the <code>.3</code> corresponds to the 4th element.)</p> <p>In all output from <code>describe</code> the type of the item shown corresponds to the python file and class of the corresponding OSCAL model in trestle.</p> <p>If you split items off a model so they end up in a subdirectory, the original file is referred to as a \"stripped\" model, with parts of it stripped off and only some elements remaining.  For example, if you do <code>trestle split -f catalog.json -e 'catalog.metadata'</code> it will split off metadata from the original <code>catalog.json</code> file and place it in <code>catalog/metadata.json</code>.  If you then do <code>trestle describe -f catalog.json</code> on the new file, it will say something like:</p> <pre><code># Model file catalog.json is of type stripped.Catalog and contains:\nuuid: 613fca2d-704a-42e7-8e2b-b206fb92b456\nparams: None\ncontrols: None\ngroups: list of 20 items of type catalog.Group\nback_matter: common.BackMatter\n</code></pre> <p>Note that the type of the file is now <code>stripped.Catalog</code> and it no longer contains <code>metadata</code>.  Even though metadata is no longer in the original <code>.json</code> file, trestle is still aware it is present in the model since it is properly placed as its own file in the subdirectory, <code>catalog</code>.</p>"},{"location":"tutorials/cli/#trestle-partial-object-validate","title":"<code>trestle partial-object-validate</code>","text":"<p>OSCAL objects may be extremely large. Some systems may only be able to produce partial OSCAL objects. For example, the tanium-result-to-oscal-ar task produces the <code>results</code> attribute of an <code>assessment-results</code> object.</p> <p><code>trestle partial-object-validate</code> allows the validation of any sub-element/attribute using element path.</p> <p>Using the example above <code>trestle partial-object-validate -f results.json -e assessment-results.results</code>.</p> <p>The file is not required to be in the trestle directory or required to be a specific file name.</p>"},{"location":"tutorials/cli/#example-valid-element-paths","title":"Example valid element-paths","text":"<p>All element paths must be absolute e.g.: <code>catalog.metadata</code> <code>catalog</code> <code>catalog.groups</code> <code>catalog.groups.group.controls.control.controls.control</code> Remembering in the end you only care about the end type. So in this scenario <code>catalog.groups.group.controls.control.controls.control</code> is equivalent to <code>catalog.controls.control</code>.</p>"},{"location":"tutorials/cli/#trestle-href","title":"<code>trestle href</code>","text":"<p>This command changes the href of an Import in a profile and is needed when generating an SSP (system security plan) with the author tool, <code>ssp-generate</code>. The Imports in a profile are used to load associated catalogs of controls and profiles, and must be available at the corresponding href uri.  If an imported catalog is in the trestle directory then the href should be changed with a command of the form:</p> <pre><code>trestle href -n my_profile -hr trestle://catalogs/my_catalog/catalog.json\n</code></pre> <p>Similarly, if the item imported is a profile, a corresponding href should point to a json file in the <code>profiles</code> directory.</p> <p>Note that catalogs or profiles in the trestle directory are indicated by the <code>trestle://</code> prefix, followed by the path from the top level models directory to the actual catalog file.  The profile itself, which is having its imports modified, is just indicated by its name with the <code>-n</code> option.</p> <p>If the profile has more than one import, you can display the corresponding hrefs with:</p> <pre><code>trestle href -n my_profile\n</code></pre> <p>This will give a numbered list of the hrefs.  You can then change them individually by providing the corresponding item number:</p> <pre><code>trestle href -n my_profile -i 1 -hr trestle://catalogs/my_catalog/catalog.json\n</code></pre> <p>This will change the href indexed as <code>1</code> when the list was displayed.  The href's are indexed starting from 0.</p> <p>The <code>trestle href</code> command can also be used to change the value back to the intended one prior to distribution of the profile.</p> <p>The provided href can be of form <code>trestle://</code>, <code>https://</code>, <code>sftp://</code>, or <code>file:///</code>.  If <code>file:///</code> is used, the path provided must be absolute - and on Windows it must include the drive letter followed by a slash.  The only time a relative path is allowed is with the <code>trestle://</code> heading.</p> <p>A username and password may be embedded in the url for <code>https://</code>, and a CA certificate path will be searched from environment variables <code>REQUESTS_CA_BUNDLE</code> and <code>CURL_CA_BUNDLE</code> in that order.</p> <p>Authorization for <code>sftp://</code> access relies on the user's private key being either active via <code>ssh-agent</code> or supplied via the environment variable <code>SSH_KEY</code>. In the latter case it must not require a passphrase prompt.</p>"},{"location":"tutorials/cli/#trestle-assemble","title":"<code>trestle assemble</code>","text":"<p>This command assembles all contents (files and directories) representing a specific model into a single OSCAL file located under <code>dist</code> folder. For example,</p> <p><code>$TRESTLE_BASEDIR$ trestle assemble catalog -n nist800-53</code></p> <p>will traverse the <code>catalogs/nist800-53</code> directory and its children and combine all data into a OSCAL file that will be written to <code>dist/catalogs/nist800-53.json</code>. Note that the parts of catalog <code>nist800-53</code> can be written in either YAML/JSON (e.g. based on the file extension), however, the output will be generated as YAML/JSON as desired. Trestle will infer the content type from the file extension and create the model representation appropriately in memory and then output in the desired format. Trestle assemble will also validate content as it assembles the files and make sure the contents are syntactically correct.</p>"},{"location":"tutorials/cli/#trestle-remove","title":"<code>trestle remove</code>","text":"<p>The trestle remove command is the reversal of <code>trestle create -f filename.json -e element_path</code>, as it will remove the corresponding element from the specified file.</p>"},{"location":"tutorials/cli/#trestle-validate","title":"<code>trestle validate</code>","text":"<p>Trestle validate checks the integrity of one or more OSCAL files in a number of ways.</p> <p><code>validate</code> returns a non-zero return code if there is any validation problem detected in a file.</p> <p>The current list of validation modes that get checked internally are:</p> Mode Purpose duplicates Detect whether disallowed duplicate uuid's are present oscal_version Confirm that the oscal version of the file is supported refs Confirm that all references in responsible parties are found in roles catalog Confirm all parameter ids in a catalog are unique links Confirm referenced resources are 1:1 with resources in backmatter <p>You can validate a single model file by specifying its full path:</p> <p><code>trestle validate -f catalogs/my_cat/catalog.json</code></p> <p>or by specifying its model name and type:</p> <p><code>trestle validate -t catalog -n my_cat</code></p> <p>In addition to validating a single file you can validate all files of a given type with the <code>-t</code> option and no file name:</p> <p><code>trestle validate -t catalog</code></p> <p>And you can validate all models with the <code>-a</code> option:</p> <p><code>trestle validate -a</code></p> <p>Note that when you <code>Import</code> a file it will perform a full validation on it first, and if it does not pass validation the file cannot be imported.</p> <p>By default validate will display warning messages and a message indicating the file is valid, but you can suppress those messages with the <code>-q --quiet</code> option.</p> <p>The links validator is special because it always returns success that the file is valid - but it will list any inconsistencies it finds between the references to links, and corresponding links in the backmatter.</p>"},{"location":"tutorials/cli/#trestle-tasks","title":"<code>trestle tasks</code>","text":"<p>Open Shift Compliance Operator and Tanium are supported as 3rd party tools.</p>"},{"location":"tutorials/cli/#trestle-task-xccdf-result-to-oscal-ar","title":"<code>trestle task xccdf-result-to-oscal-ar</code>","text":"<p>The trestle task xccdf-result-to-oscal-ar command facilitates transformation of XCCDF results, e.g. OpenShift Compliance Operator (OSCO) scan results, .yaml files into OSCAL partial results .json files. Specify required config parameters to indicate the location of the input and the output. Specify optional config parameters to indicate the name of the oscal-metadata.yaml file, if any, and whether overwriting of existing output is permitted.</p> <p> Example command invocation: </p> <p><code>$TRESTLE_BASEDIR$ trestle task xccdf-result-to-oscal-ar -c /home/user/task.config</code></p> <p> Example config: </p> <p>/home/user/task.config</p> <pre><code>[task.xccdf-result-to-oscal-ar]\n\ninput-dir =  /home/user/git/evidence/xccdf/input\noutput-dir = /home/user/git/evidence/oscal/output\noscal-metadata = oscal-metadata.yaml\noutput-overwrite = true\n</code></pre> <p>input</p> <p> Example input directory contents listing: </p> <p>/home/user/git/evidence/xccdf/input</p> <pre><code>-rw-rw-r--. 1 user user  3832 Feb  2 09:36 oscal-metadata.yaml\n-rw-rw-r--. 1 user user 49132 Feb  2 06:12 ssg-ocp4-ds-cis-111.222.333.444-pod.yaml\n-rw-rw-r--. 1 user user 52747 Feb  2 06:41 ssg-ocp4-ds-cis-111.222.333.555-pod.yaml\n</code></pre> <p> Example input OSCO scan result file contents (snippet): </p> <p>ssg-ocp4-ds-cis-111.222.333.444-pod.yaml</p> display sample <pre><code>apiVersion: v1\ndata:\n  exit-code: '2'\n  results: |\n    &lt;?xml version=\"1.0\" encoding=\"UTF-8\"?&gt;\n    &lt;TestResult xmlns=\"https://checklists.nist.gov/xccdf/1.2\" \n                id=\"xccdf_org.open-scap_testresult_xccdf_org.ssgproject.content_profile_cis\"\n                start-time=\"2020-08-03T02:26:26+00:00\" end-time=\"2020-08-03T02:26:26+00:00\"\n                version=\"0.1.52\"\n                test-system=\"cpe:/a:redhat:openscap:1.3.3\"&gt;\n              &lt;benchmark href=\"/content/ssg-ocp4-ds.xml\" id=\"xccdf_org.ssgproject.content_benchmark_OCP-4\"/&gt;\n              &lt;title&gt;OSCAP Scan Result&lt;/title&gt;\n              &lt;profile idref=\"xccdf_org.ssgproject.content_profile_cis\"/&gt;\n              &lt;target&gt;kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp&lt;/target&gt;\n              &lt;target-facts&gt;\n                &lt;fact name=\"urn:xccdf:fact:identifier\" type=\"string\"&gt;chroot:///host&lt;/fact&gt;\n                &lt;fact name=\"urn:xccdf:fact:scanner:name\" type=\"string\"&gt;OpenSCAP&lt;/fact&gt;\n                &lt;fact name=\"urn:xccdf:fact:scanner:version\" type=\"string\"&gt;1.3.3&lt;/fact&gt;\n              &lt;/target-facts&gt;\n              &lt;target-id-ref system=\"https://scap.nist.gov/schema/asset-identification/1.1\" name=\"asset0\" href=\"\"/&gt;\n              &lt;platform idref=\"cpe:/a:redhat:openshift_container_platform:4.1\"/&gt;\n              &lt;platform idref=\"cpe:/a:machine\"/&gt;\n              &lt;set-value idref=\"xccdf_org.ssgproject.content_value_ocp_data_root\"&gt;/kubernetes-api-resources&lt;/set-value&gt;\n              &lt;set-value idref=\"xccdf_org.ssgproject.content_value_var_kube_authorization_mode\"&gt;Webhook&lt;/set-value&gt;\n              &lt;set-value idref=\"xccdf_org.ssgproject.content_value_var_streaming_connection_timeouts\"&gt;5m&lt;/set-value&gt;\n              &lt;rule-result idref=\"xccdf_org.ssgproject.content_rule_ocp_idp_no_htpasswd\" time=\"2020-08-03T02:26:26+00:00\" severity=\"medium\" weight=\"1.000000\"&gt;\n                &lt;result&gt;notselected&lt;/result&gt;\n                &lt;ident system=\"https://nvd.nist.gov/cce/index.cfm\"&gt;CCE-84209-6&lt;/ident&gt;\n              &lt;/rule-result&gt;\n              &lt;rule-result idref=\"xccdf_org.ssgproject.content_rule_accounts_restrict_service_account_tokens\" time=\"2020-08-03T02:26:26+00:00\" severity=\"medium\" weight=\"1.000000\"&gt;\n                &lt;result&gt;notchecked&lt;/result&gt;\n                &lt;message severity=\"info\"&gt;No candidate or applicable check found.&lt;/message&gt;\n              &lt;/rule-result&gt;\n              &lt;rule-result idref=\"xccdf_org.ssgproject.content_rule_accounts_unique_service_account\" time=\"2020-08-03T02:26:26+00:00\" severity=\"medium\" weight=\"1.000000\"&gt;\n                &lt;result&gt;notchecked&lt;/result&gt;\n                &lt;message severity=\"info\"&gt;No candidate or applicable check found.&lt;/message&gt;\n              &lt;/rule-result&gt;\n\n              ...\n\n           &lt;/TestResult&gt;\nkind: ConfigMap\nmetadata:\n  annotations:\n    compliance-remediations/processed: ''\n    compliance.openshift.io/scan-error-msg: ''\n    compliance.openshift.io/scan-result: NON-COMPLIANT\n    openscap-scan-result/node: 111.222.333.444\n  creationTimestamp: '2020-08-03T02:26:34Z'\n  labels:\n    compliance-scan: ssg-ocp4-ds-cis\n  name: ssg-ocp4-ds-cis-111.222.333.444-pod\n  namespace: openshift-compliance\n  resourceVersion: '22693328'\n  selfLink: \n    /api/v1/namespaces/openshift-compliance/configmaps/ssg-ocp4-ds-cis-111.222.333.444-pod\n  uid: 1da3ea81-0a25-4512-ad86-7ac360246b5d\n</code></pre> <p></p> <p> Example input OSCAL metadata file contents: </p> <p>oscal-metadata.yaml</p> display sample <pre><code>ssg-ocp4-ds-cis-111.222.333.444-pod:\n  locker: https://github.mycorp.com/degenaro/evidence-locker\n  namespace: xccdf\n  benchmark: CIS Kubernetes Benchmark\n  subject-references:\n    component:\n      uuid-ref: 56666738-0f9a-4e38-9aac-c0fad00a5821\n      type: component\n      title: Red Hat OpenShift Kubernetes\n    inventory-item:\n      uuid-ref: 46aADFAC-A1fd-4Cf0-a6aA-d1AfAb3e0d3e\n      type: inventory-item\n      title: Pod\n      properties:\n        target: kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp\n        target-ip: 111.222.333.444\n        cluster-name: ROKS-OpenSCAP-1\n        cluster-type: openshift\n        cluster-region: us-south\n\nssg-rhel7-ds-cis-111.222.333.444-pod:\n  locker: https://github.mycorp.com/degenaro/evidence-locker\n  namespace: xccdf\n  benchmark: CIS Kubernetes Benchmark\n  subject-references:\n    component:\n      uuid-ref: 89cfe7a7-ce6b-4699-aa7b-2f5739c72001\n      type: component\n      title: RedHat Enterprise Linux 7.8\n    inventory-item:\n      uuid-ref: 46aADFAC-A1fd-4Cf0-a6aA-d1AfAb3e0d3e\n      type: inventory-item\n      title: VM\n      properties:\n        target: kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp\n        target-ip: 111.222.333.444\n        cluster-name: ROKS-OpenSCAP-1\n        cluster-type: openshift\n        cluster-region: us-south\n</code></pre> <p>metadata format</p> <p>The oscal-metadata.yaml file comprises one or more mappings. Below is shown the format of a single mapping. The items in angle brackets are to be replaced with desired values for augmenting the produced OSCAL.</p> <p>The mapping whose name matches the <code>[metadata][name]</code> in the evidence for the corresponding embedded XML, if any, will be used for augmenting the produced OSCAL.</p> <pre><code>name:\n  locker: &lt;locker&gt;\n  namespace: &lt;namespace&gt;\n  benchmark: &lt;benchmark&gt;\n  subject-references:\n    component:\n      uuid-ref: &lt;uuid-ref-component&gt;\n      type: &lt;component-type&gt;\n      title: &lt;component-title&gt;\n    inventory-item:\n      uuid-ref: &lt;uuid-ref-inventory-item&gt;\n      type: &lt;inventory-item-type&gt;\n      title: &lt;inventory-item-title&gt;\n      properties:\n        target: &lt;target&gt;\n        cluster-name: &lt;cluster-name&gt;\n        cluster-type: &lt;cluster-type&gt;\n        cluster-region: &lt;cluster-region&gt;\n</code></pre> <p>output</p> <p> Example output directory contents listing: </p> <p>/home/user/git/evidence/oscal/output</p> <pre><code>-rw-rw-r--. 1 user user 49132 Feb  3 10:59 ssg-ocp4-ds-cis-111.222.333.444-pod.json\n-rw-rw-r--. 1 user user 52747 Feb  3 10:59 ssg-ocp4-ds-cis-111.222.333.555-pod.json\n</code></pre> <p> Example output OSCAL Observations file contents (snippet): </p> <p>ssg-ocp4-ds-cis-111.222.333.444-pod.json</p> display sample <pre><code>{\n  \"observations\": [\n    {\n      \"uuid\": \"56666738-0f9a-4e38-9aac-c0fad00a5821\",\n      \"title\": \"xccdf_org.ssgproject.content_rule_ocp_idp_no_htpasswd\",\n      \"description\": \"xccdf_org.ssgproject.content_rule_ocp_idp_no_htpasswd\",\n      \"props\": [\n        {\n          \"name\": \"benchmark\",\n          \"ns\": \"dns://osco\",\n          \"class\": \"source\",\n          \"value\": \"CIS Kubernetes Benchmark\"\n        }\n      ],\n      \"methods\": [\n        \"TEST-AUTOMATED\"\n      ],\n      \"subjects\": [\n        {\n          \"uuid-ref\": \"56666738-0f9a-4e38-9aac-c0fad00a5821\",\n          \"type\": \"component\",\n          \"title\": \"Red Hat OpenShift Kubernetes\"\n        },\n        {\n          \"uuid-ref\": \"46aADFAC-A1fd-4Cf0-a6aA-d1AfAb3e0d3e\",\n          \"type\": \"inventory-item\",\n          \"title\": \"Pod\",\n          \"props\": [\n            {\n              \"name\": \"target\",\n              \"ns\": \"dns://osco\",\n              \"class\": \"inventory-item\",\n              \"value\": \"kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp\"\n            },\n            {\n              \"name\": \"target-ip\",\n              \"ns\": \"dns://osco\",\n              \"class\": \"inventory-item\",\n              \"value\": \"111.222.333.444\"\n            },\n            {\n              \"name\": \"cluster-name\",\n              \"ns\": \"dns://osco\",\n              \"class\": \"inventory-item\",\n              \"value\": \"ROKS-OpenSCAP-1\"\n            },\n            {\n              \"name\": \"cluster-type\",\n              \"ns\": \"dns://osco\",\n              \"class\": \"inventory-item\",\n              \"value\": \"openshift\"\n            },\n            {\n              \"name\": \"cluster-region\",\n              \"ns\": \"dns://osco\",\n              \"class\": \"inventory-item\",\n              \"value\": \"us-south\"\n            }\n          ]\n        }\n      ],\n      \"relevant-evidence\": [\n        {\n          \"href\": \"https://github.mycorp.com/degenaro/evidence-locker\",\n          \"description\": \"Evidence location.\",\n          \"props\": [\n            {\n              \"name\": \"rule\",\n              \"ns\": \"dns://xccdf\",\n              \"class\": \"id\",\n              \"value\": \"xccdf_org.ssgproject.content_rule_ocp_idp_no_htpasswd\"\n            },\n            {\n              \"name\": \"time\",\n              \"ns\": \"dns://xccdf\",\n              \"class\": \"timestamp\",\n              \"value\": \"2020-08-03T02:26:26+00:00\"\n            },\n            {\n              \"name\": \"result\",\n              \"ns\": \"dns://xccdf\",\n              \"class\": \"result\",\n              \"value\": \"notselected\"\n            }\n          ]\n        }\n      ]\n    }\n  ]\n}\n</code></pre>"},{"location":"tutorials/cli/#trestle-task-tanium-result-to-oscal-ar","title":"<code>trestle task tanium-result-to-oscal-ar</code>","text":"<p>The trestle task tanium-result-to-oscal-ar command facilitates transformation of Tanuim reports, each input file comprising individual lines consumable as json, into OSCAL partial results .json files. Specify required config parameters to indicate the location of the input and the output. Specify optional config parameter output-overwrite to indicate whether overwriting of existing output is permitted. Specify optional config parameter timestamp as ISO 8601 formated string (e.g., 2021-02-24T19:31:13+00:00) to override the timestamp attached to each Observation.</p> <p> Example command invocation: </p> <p><code>$TRESTLE_BASEDIR$ trestle task tanium-result-to-oscal-ar -c /home/user/task.config</code></p> <p> Example config: </p> <p>/home/user/task.config</p> <pre><code>[task.tanium-result-to-oscal-ar]\n\ninput-dir =  /home/user/git/compliance/tanium/input\noutput-dir = /home/user/git/compliance/oscal/output\noutput-overwrite = true\n</code></pre> <p>input</p> <p> Example input directory contents listing: </p> <p>/home/user/git/compliance/tanium/input</p> <pre><code>-rw-rw-r--. 1 degenaro degenaro 1830 Mar  7 08:23 Tanium.comply-nist-results\n</code></pre> <p>Tanium.comply-nist-results</p> display sample <pre><code>{\n  \"IP Address\": \"fe80::3cd5:564b:940e:49ab\",\n  \"Computer Name\": \"cmp-wn-2106.demo.tanium.local\",\n  \"Comply - JovalCM Results[c2dc8749]\": [\n    {\n      \"Benchmark\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\",\n      \"Benchmark Version\": \"1.5.0.1\",\n      \"Profile\": \"Windows 10 - NIST 800-53\",\n      \"ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords\",\n      \"Result\": \"pass\",\n      \"Custom ID\": \"800-53: IA-5\",\n      \"Version\": \"version: 1\"\n    }\n  ],\n  \"Count\": \"1\",\n  \"Age\": \"600\"\n}\n</code></pre> <pre><code>{\n  \"IP Address\": \"10.8.69.11\",\n  \"Computer Name\": \"\",\n  \"Comply - JovalCM Results[c2dc8749]\": [\n    {\n      \"Benchmark\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\",\n      \"Benchmark Version\": \"1.5.0.1\",\n      \"Profile\": \"Windows 10 - NIST 800-53\",\n      \"ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.2_L1_Ensure_Maximum_password_age_is_set_to_60_or_fewer_days_but_not_0\",\n      \"Result\": \"pass\",\n      \"Custom ID\": \"800-53: IA-5\",\n      \"Version\": \"version: 1\"\n    }\n  ],\n  \"Count\": \"1\",\n  \"Age\": \"600\"\n}\n</code></pre> <pre><code>{\n  \"IP Address\": \"10.8.69.11\",\n  \"Computer Name\": \"cmp-wn-2106.demo.tanium.local\",\n  \"Comply - JovalCM Results[c2dc8749]\": [\n    {\n      \"Benchmark\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\",\n      \"Benchmark Version\": \"1.5.0.1\",\n      \"Profile\": \"Windows 10 - NIST 800-53\",\n      \"ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.3_L1_Ensure_Minimum_password_age_is_set_to_1_or_more_days\",\n      \"Result\": \"fail\",\n      \"Custom ID\": \"800-53: IA-5\",\n      \"Version\": \"version: 1\"\n    }\n  ],\n  \"Count\": \"1\",\n  \"Age\": \"600\"\n}\n</code></pre> <pre><code>{\n  \"IP Address\": \"10.8.69.11\",\n  \"Computer Name\": \"cmp-wn-2106.demo.tanium.local\",\n  \"Comply - JovalCM Results[c2dc8749]\": [\n    {\n      \"Benchmark\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\",\n      \"Benchmark Version\": \"1.5.0.1\",\n      \"Profile\": \"Windows 10 - NIST 800-53\",\n      \"ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.4_L1_Ensure_Minimum_password_length_is_set_to_14_or_more_characters\",\n      \"Result\": \"pass\",\n      \"Custom ID\": \"800-53: IA-5\",\n      \"Version\": \"version: 1\"\n    }\n  ],\n  \"Count\": \"1\",\n  \"Age\": \"600\"\n}\n</code></pre> <p>output</p> <p> Example output directory contents listing: </p> <p>/home/user/git/compliance/oscal/output</p> <pre><code>-rw-rw-r--. 1 degenaro degenaro 6479 Mar  7 08:25 Tanium.oscal.json\n</code></pre> <p>Tanium.oscal.json</p> display sample <pre><code>{\n  \"results\": [\n    {\n      \"uuid\": \"0ed0791e-5454-4d07-919f-15a0d806a5a8\",\n      \"title\": \"Tanium\",\n      \"description\": \"Tanium\",\n      \"start\": \"2021-04-13T00:16:20.000+00:00\",\n      \"local-definitions\": {\n        \"inventory-items\": [\n          {\n            \"uuid\": \"da8b87f6-2068-415f-94bb-e14e31b4f5c2\",\n            \"description\": \"inventory\",\n            \"props\": [\n              {\n                \"name\": \"computer-name\",\n                \"ns\": \"dns://tanium\",\n                \"value\": \"cmp-wn-2106.demo.tanium.local\",\n                \"class\": \" inventory-item\"\n              },\n              {\n                \"name\": \"computer-ip\",\n                \"ns\": \"dns://tanium\",\n                \"value\": \"fe80::3cd5:564b:940e:49ab\",\n                \"class\": \" inventory-item\"\n              },\n              {\n                \"name\": \"profile\",\n                \"ns\": \"dns://tanium\",\n                \"value\": \"Windows 10\",\n                \"class\": \" inventory-item\"\n              }\n            ]\n          },\n          {\n            \"uuid\": \"f3ab87b2-70c1-4332-991e-c003d4314c0b\",\n            \"description\": \"inventory\",\n            \"props\": [\n              {\n                \"name\": \"computer-name\",\n                \"ns\": \"dns://tanium\",\n                \"value\": \"\",\n                \"class\": \" inventory-item\"\n              },\n              {\n                \"name\": \"computer-ip\",\n                \"ns\": \"dns://tanium\",\n                \"value\": \"10.8.69.11\",\n                \"class\": \" inventory-item\"\n              },\n              {\n                \"name\": \"profile\",\n                \"ns\": \"dns://tanium\",\n                \"value\": \"Windows 10\",\n                \"class\": \" inventory-item\"\n              }\n            ]\n          }\n        ]\n      },\n      \"reviewed-controls\": {\n        \"control-selections\": [\n          {}\n        ]\n      },\n      \"observations\": [\n        {\n          \"uuid\": \"b3250b66-fe6f-4ac0-be99-cb4ff093dc31\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords\",\n          \"props\": [\n            {\n              \"name\": \"benchmark\",\n              \"ns\": \"dns://tanium\",\n              \"value\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\",\n              \"class\": \"source\"\n            },\n            {\n              \"name\": \"rule\",\n              \"ns\": \"dns://xccdf\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords\",\n              \"class\": \"id\"\n            },\n            {\n              \"name\": \"result\",\n              \"ns\": \"dns://xccdf\",\n              \"value\": \"pass\",\n              \"class\": \"result\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"da8b87f6-2068-415f-94bb-e14e31b4f5c2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-04-13T00:16:20.000+00:00\"\n        },\n        {\n          \"uuid\": \"5ae9c133-c32d-44c5-b52e-5af4513cb94a\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.2_L1_Ensure_Maximum_password_age_is_set_to_60_or_fewer_days_but_not_0\",\n          \"props\": [\n            {\n              \"name\": \"benchmark\",\n              \"ns\": \"dns://tanium\",\n              \"value\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\",\n              \"class\": \"source\"\n            },\n            {\n              \"name\": \"rule\",\n              \"ns\": \"dns://xccdf\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.2_L1_Ensure_Maximum_password_age_is_set_to_60_or_fewer_days_but_not_0\",\n              \"class\": \"id\"\n            },\n            {\n              \"name\": \"result\",\n              \"ns\": \"dns://xccdf\",\n              \"value\": \"pass\",\n              \"class\": \"result\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"f3ab87b2-70c1-4332-991e-c003d4314c0b\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-04-13T00:16:20.000+00:00\"\n        },\n        {\n          \"uuid\": \"8d021edc-176e-4373-a3c4-a19e954c1e4d\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.3_L1_Ensure_Minimum_password_age_is_set_to_1_or_more_days\",\n          \"props\": [\n            {\n              \"name\": \"benchmark\",\n              \"ns\": \"dns://tanium\",\n              \"value\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\",\n              \"class\": \"source\"\n            },\n            {\n              \"name\": \"rule\",\n              \"ns\": \"dns://xccdf\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.3_L1_Ensure_Minimum_password_age_is_set_to_1_or_more_days\",\n              \"class\": \"id\"\n            },\n            {\n              \"name\": \"result\",\n              \"ns\": \"dns://xccdf\",\n              \"value\": \"fail\",\n              \"class\": \"result\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"f3ab87b2-70c1-4332-991e-c003d4314c0b\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-04-13T00:16:20.000+00:00\"\n        },\n        {\n          \"uuid\": \"36aa7551-d047-4f4a-9853-6ac63cfc9e48\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.4_L1_Ensure_Minimum_password_length_is_set_to_14_or_more_characters\",\n          \"props\": [\n            {\n              \"name\": \"benchmark\",\n              \"ns\": \"dns://tanium\",\n              \"value\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\",\n              \"class\": \"source\"\n            },\n            {\n              \"name\": \"rule\",\n              \"ns\": \"dns://xccdf\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.4_L1_Ensure_Minimum_password_length_is_set_to_14_or_more_characters\",\n              \"class\": \"id\"\n            },\n            {\n              \"name\": \"result\",\n              \"ns\": \"dns://xccdf\",\n              \"value\": \"pass\",\n              \"class\": \"result\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"f3ab87b2-70c1-4332-991e-c003d4314c0b\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-04-13T00:16:20.000+00:00\"\n        }\n      ],\n      \"findings\": [\n        {\n          \"uuid\": \"ba4e264f-0aee-4ead-9ee3-6161c5cc4ecb\",\n          \"title\": \"800-53: IA-5\",\n          \"description\": \"800-53: IA-5\",\n          \"target\": {\n            \"type\": \"objective-id\",\n            \"id-ref\": \"800-53: IA-5\",\n            \"props\": [\n              {\n                \"name\": \"profile\",\n                \"ns\": \"dns://tanium\",\n                \"value\": \"NIST 800-53\",\n                \"class\": \"source\"\n              },\n              {\n                \"name\": \"id-ref\",\n                \"ns\": \"dns://tanium\",\n                \"value\": \"800-53: IA-5\",\n                \"class\": \"source\"\n              },\n              {\n                \"name\": \"result\",\n                \"ns\": \"dns://xccdf\",\n                \"value\": \"FAIL\",\n                \"class\": \"STRVALUE\"\n              }\n            ],\n            \"status\": \"not-satisfied\"\n          },\n          \"related-observations\": [\n            {\n              \"observation-uuid\": \"b3250b66-fe6f-4ac0-be99-cb4ff093dc31\"\n            },\n            {\n              \"observation-uuid\": \"5ae9c133-c32d-44c5-b52e-5af4513cb94a\"\n            },\n            {\n              \"observation-uuid\": \"8d021edc-176e-4373-a3c4-a19e954c1e4d\"\n            },\n            {\n              \"observation-uuid\": \"36aa7551-d047-4f4a-9853-6ac63cfc9e48\"\n            }\n          ]\n        }\n      ]\n    }\n  ]\n}\n</code></pre>"},{"location":"tutorials/cli/#trestle-task-xlsx-to-oscal-cd","title":"<code>trestle task xlsx-to-oscal-cd</code>","text":"<p>The trestle task xlsx-to-oscal-cd command facilitates transformation of an excel spreadsheet into an OSCAL component-definition.json file. Specify in the config:</p> <ul> <li> location of catalog file <li> location of spreadsheet file <li> work sheet name in the spreadsheet file <li> output directory to write the component-definition.json file <li> whether or not to overwrite an existing component-definition.json file <li> the organization name <li> the organization remarks <li> the namespace <li> comma separated mappings from name to class <li> the catalog URL <li> the catalog title  <p> Example command invocation: </p> <p><code>$TRESTLE_BASEDIR$ trestle task xlsx-to-oscal-cd -c /home/user/task-xlsx-to-oscal-cd.config</code></p> <p> Example config: </p> <p>/home/user/task-xlsx-to-oscal-cd.config</p> <pre><code>[task.xlsx-to-oscal-cd]\n\ncatalog-file = nist-content/nist.gov/SP800-53/rev4/json/NIST_SP-800-53_rev4_catalog.json\nspread-sheet-file = /home/user/compliance/data/spread-sheet/good.xlsx\nwork-sheet-name = example_best_practices_controls\noutput-dir = /home/user/compliance/data/tasks/xlsx/output\noutput-overwrite = true\n\norg-name = International Business Machines\norg-remarks = IBM\nnamespace = https://oscal-compass.github.io/compliance-trestle/schemas/oscal/cd/ibm-cloud\nproperty-name-to-class = goal_name_id:scc_goal_name_id, goal_version:scc_goal_version\ncatalog-url = https://github.com/usnistgov/oscal-content/blob/master/nist.gov/SP800-53/rev4/json/NIST_SP-800-53_rev4_catalog.json\ncatalog-title = NIST Special Publication 800-53 Revision 4\n</code></pre> <p>catalog-file</p> <p> Example catalog-file: </p> <p>nist-content/nist.gov/SP800-53/rev4/json/NIST_SP-800-53_rev4_catalog.json</p> <p>spread-sheet-file</p> <p> Example spread-sheet-file: </p> <p>/home/user/compliance/data/spread-sheet/good.xlsx</p> <p>output</p> <p> Example component-definition.json: </p> <p>/home/user/compliance/data/tasks/xlsx/output/component-definition.json</p>"},{"location":"tutorials/cli/#spreadsheet-to-component-definition-mapping","title":"spreadsheet to component definition mapping","text":"display mapping table spreadsheet column name component definition path comments  ControlId <ul> <li>implemented_requirement.property[name='goal_name_id'].value      <ul> <li>only used if column 'goal_name_id' is empty      ControlText <ul> <li>implemented_requirement.property[name='goal_name_id'].remarks      <ul> <li>transformation code replaces \"Check whether\" with \"Ensure\" in text      Nist Mappings <ul> <li>implemented_requirement.description      <ul> <li>heading may span multiple columns     <li>one value expected per column     <li>each entry is separated into control + statements (if any)      ResourceTitle <ul> <li>component.title         <li>component.description     <li>component.control-implementation.description + {text}      <ul> </ul> goal_name_id <ul> <li>implemented_requirement.property[name='goal_name_id'].value      <ul> </ul> Version <ul> <li>implemented_requirement.property[name='goal_version'].value      <ul> <li>Value from spreadsheet is not currently used.      <li>Value '1.0' is hard coded.      Parameter [optional parameter] <ul> <li>implemented_requirement.set_parameter.param_id      <ul> <li>The expected text is in two parts separated by '\\n'.     <li>The text following the '\\n' is the value used.      Values [alternatives] <ul> <li>implemented_requirement.set_parameter.values      <ul> <li>The expected text is of the following format:      <li>v0, [v1, v2...]     <li>The value v0 is used."},{"location":"tutorials/cli/#trestle-task-xlsx-to-oscal-profile","title":"<code>trestle task xlsx-to-oscal-profile</code>","text":"<p>The trestle task xlsx-to-oscal-profile command facilitates transformation of an excel spreadsheet into an OSCAL profile.json file. Specify in the config:</p> <ul> <li> the href URL of the spreadsheet <li> file system location of spreadsheet file <li> work sheet name in the spreadsheet file <li> output directory to write the profile.json file <li> whether or not to overwrite an existing profile.json file <li> the profile title  <p> Example command invocation: </p> <p><code>$TRESTLE_BASEDIR$ trestle task xlsx-to-oscal-profile -c /home/user/task-xlsx-to-oscal-profile.config</code></p> <p> Example config: </p> <p>/home/user/task-xlsx-to-oscal-profile.config</p> <pre><code>[task.xlsx-to-oscal-profile]\n\nspread-sheet-url = https://github.mycorp.com/spread-sheets/good.xlsx\nspread-sheet-file = /home/user/compliance/data/spread-sheet/good.xlsx\nwork-sheet-name = example_best_practices_controls\noutput-dir = /home/user/compliance/data/tasks/xlsx/output\noutput-overwrite = true\n\nprofile-title = IBM Best Practices SCC GOALS\n</code></pre> <p>spread-sheet-file</p> <p> Example spread-sheet-file: </p> <p>/home/user/compliance/data/spread-sheet/good.xlsx</p> <p>output</p> <p> Example profile.json: </p> <p>/home/user/compliance/data/tasks/xlsx/output/profile.json</p>"},{"location":"tutorials/compliance_posture/","title":"Tutorial: What\u2019s your compliance posture?","text":""},{"location":"tutorials/compliance_posture/#introduction","title":"Introduction","text":"<p>The cloud with its continuous integration and continuous deployment is the modern computing paradigm. There is a plethora of cloud environments: public, private, on-premise, hybrid-cloud, multi-cloud, etc. along with a corresponding contingent of vendors. The cloud offers great flexibility where you can choose just one or some combination optimal for each application. But, as demonstrated from time to time, the cloud can be a dangerous place. Hackers, bots, malware, and more are constant threats seeking to find and exploit weakness in your computing solution. To combat them there are strategies to avoid embarrassment and financial ruin from security breeches. Educating your workforce is of paramount importance. Moreover, employing a trust-but-verify strategy will go a long way toward deflecting trouble.</p> <p>The time has come for continuous auditing, and giving stakeholders (such as account owners, application owners, system owners and compliance officers) a current picture of their compliance posture:</p> <ul> <li>Are password rules being followed?</li> <li>Are deployed applications using compromised encryption algorithms?</li> <li>Has a user gotten elevated privileges?</li> <li>Are unauthorized open source projects wrongfully part of your application stack?</li> </ul> <p>Getting answers to these questions only quarterly or annually is leaving you exposed.</p> <p>Moreover, assuring continuous compliance across multiple cloud vendors can complicate matters. If each has its own compliance regime, then one must become expert in each domain\u2019s compliance solution space, or else be wedded to a single or few providers. That is not an ideal prospect.</p> <p>Common sense dictates that standardization would simplify matters. The National Institute of Standards and Technologies (NIST) is developing the Open Security Controls Assessment Language (OSCAL).</p> <p>The compliance-trestle open source github project is an effort to employ OSCAL for compliance standardization and automation. Of great utility is the trestle oscal module that facilitates transformation of data to/from Python object representations in accordance with the OSCAL schemas.</p>"},{"location":"tutorials/compliance_posture/#simple-continuous-compliance-architecture","title":"Simple Continuous Compliance Architecture","text":"<p>Cloud Services can often be configured to monitor (and sometimes enforce) policies. Examples include OpenShift Compliance Operator and Tanium. However, the compliance reporting \u201craw\u201d data produced is unique to each.</p> <p>Two steps are needed to ascertain your compliance posture. Step 1 is to transform available compliance \u201craw\u201d data into standardized form (OSCAL). Step 2 is to examine the OSCAL data and assemble a compliance posture for the controls and components of interest. And trestle is the go-to solution.</p>"},{"location":"tutorials/compliance_posture/#step-1-transformation","title":"Step 1 \u2013 Transformation","text":"<p>The bad news is that a transformer to OSCAL is needed for each Cloud Service type.</p> <p>However, there is plenty of good news:</p> <ul> <li>a transformer for your Cloud Service type may already exist, such as: Tanium to OSCAL, OpenShift Compliance Operator to OSCAL</li> <li>once a transformer for a Cloud Service type has been written, it can be open-sourced/re-used</li> <li>writing a transformer is fairly easy: just a few lines of Python code using trestle as a foundation</li> </ul> <p>In the case of Tanium, the OSCAL compliance data document is a System Assessment Results fragment with Findings and Observations, while in the case of OpenShift Compliance Operator there are Observations only.</p> <p>Tutorials are available to show you: how to run a transformer, how to write a transformer.</p>"},{"location":"tutorials/compliance_posture/#step-2-reporting","title":"Step 2 \u2013 Reporting","text":"<p>Coming soon is a trestle tool to assemble the OSCAL fragments documents together using OSCAL compliance configuration data (System Assessment Plan  and System Security Plan) into a complete System Assessment Results.</p>"},{"location":"tutorials/introduction_to_trestle/","title":"Tutorial: Introduction to trestle workflow","text":"<p>Here are step-by-step instructions to manipulate a NIST standard OSCAL catalog using the compliance-trestle (<code>\"trestle\"</code>) tool.</p>"},{"location":"tutorials/introduction_to_trestle/#objective","title":"Objective","text":"<p>Learn how to split and merge an OSCAL catalog json file using trestle commands and its command line interface (CLI).  Trestle simplifies the manipulation and management of large OSCAL documents by allowing controlled deconstruction into smaller components, and later reconstruction after editing those components.  And all operations guarantee that the individual files conform to the corresponding OSCAL schema to maintain integrity of the document in the process.</p> <p>This tutorial assumes you have installed Python and installed trestle in a virtual environment per the directions found here.</p> <p>The examples shown will work for linux and mac, but Windows will require the following modifications:</p> <ul> <li>use backslashes `\\` for file paths (this is optional in most cases) <li>use copy instead of cp (unless you have cp installed) <li>use md instead of mkdir (unless you have mkdir installed) <li>quotes (') are often not needed unless the text includes spaces, but if quotes are needed they should be double quotes (\")  <p>Commands are shown without prompts so they are easy to cut and paste, and responses by trestle are shown with &gt;&gt;&gt; at the start of the line.  In actual usage the &gt;&gt;&gt; would not appear.</p> <p>Be sure to include the quotes (' ') as shown in the examples, e.g. <code>merge -e 'catalog.*'</code> [On windows you should probably use double quotes (\") as needed.]</p> <p>In this tutorial you will see sections that contain dropdown that is revealed when you click on them.  Below is an example (\"Like this\").  Be sure to click on those sections to see their contents - and then close them if you like.</p> <p></p> Like this <pre><code>more\ninformation\nin\nhere\n</code></pre> <p></p>"},{"location":"tutorials/introduction_to_trestle/#step-1-create-a-trestle-workspace-if-you-dont-have-one-already","title":"Step 1: Create a trestle workspace if you don't have one already","text":"<pre><code>mkdir my_workspace\ncd my_workspace\ntrestle init\n&gt;&gt;&gt; Initialized trestle project successfully in [user_path]/my_workspace\n</code></pre>"},{"location":"tutorials/introduction_to_trestle/#step-2-import-a-catalog-from-the-trestle-sample-data-directory-into-your-trestle-workspace","title":"Step 2: Import a catalog from the trestle sample data directory into your trestle workspace","text":"<p>For this tutorial we will use a catalog file from NIST, but we first must <code>import</code> it into the trestle workspace.  This can be done either by first downloading the file locally and then importing it, or you can download it directly using its url address.</p> <p>We will import the file directly from the NIST OSCAL github site.  The specific catalog is NIST_SP-800-53_rev5_catalog.json</p> <p>Import the file from the url with the following command:</p> <pre><code>trestle import -f https://raw.githubusercontent.com/usnistgov/oscal-content/master/nist.gov/SP800-53/rev5/json/NIST_SP-800-53_rev5_catalog.json -o mycatalog\n</code></pre> <p>As a reminder, you could also have imported the file from a local directory on your file system, or an sftp:// address.  But the file must first be imported to the trestle workspace in order for it to be directly manipulated by trestle as in this tutorial.</p> <p>The <code>import</code> command will also check the validity of the file including the presence of any duplicate uuid's.  If the file is manually created please be sure it conforms with the current OSCAL schema (OSCAL version 1.0.4) and has no defined uuid's that are duplicates. If there are any errors the Import will fail and the file must be corrected.</p> <p></p> Your initial workspace will look like this <pre><code>my_workspace\n \u2523 .trestle\n \u2503 \u2523 .keep\n \u2503 \u2517 config.ini\n \u2523 assessment-plans\n \u2503 \u2517 .keep\n \u2523 assessment-results\n \u2503 \u2517 .keep\n \u2523 catalogs\n \u2503 \u2523 mycatalog\n \u2503 \u2503 \u2517 catalog.json\n \u2503 \u2517 .keep\n \u2523 component-definitions\n \u2503 \u2517 .keep\n \u2523 dist\n \u2503 \u2523 assessment-plans\n \u2503 \u2503 \u2517 .keep\n \u2503 \u2523 assessment-results\n \u2503 \u2503 \u2517 .keep\n \u2503 \u2523 catalogs\n \u2503 \u2503 \u2517 .keep\n \u2503 \u2523 component-definitions\n \u2503 \u2503 \u2517 .keep\n \u2503 \u2523 plan-of-action-and-milestones\n \u2503 \u2503 \u2517 .keep\n \u2503 \u2523 profiles\n \u2503 \u2503 \u2517 .keep\n \u2503 \u2523 system-security-plans\n \u2503 \u2503 \u2517 .keep\n \u2503 \u2517 target-definitions\n \u2503 \u2503 \u2517 .keep\n \u2523 plan-of-action-and-milestones\n \u2503 \u2517 .keep\n \u2523 profiles\n \u2503 \u2517 .keep\n \u2523 system-security-plans\n \u2503 \u2517 .keep\n \u2517 target-definitions\n \u2503 \u2517 .keep\n</code></pre> <p></p> <p>You will see that the directory now shows your catalog file in <code>my_workspace/catalogs/mycatalog/catalog.json</code>.  Note that the <code>.keep</code> files are simply to make sure git does not remove the directories - and can be ignored.  Also note that the json file itself is singular (catalog) while the directory above is plural (catalogs).  This convention is used throughout trestle because a given model directory like catalogs may contain several individual models - each of which is singular.  The imported catalog file size may be larger than the original due to a change in formatting, but the contents should be the same.</p> <p>From here on in this tutorial we will just focus on the catalogs directory since the others are not directly involved.</p> <p>You have now populated your trestle workspace with an OSCAL catalog that you can manipulate.  Let's start.</p>"},{"location":"tutorials/introduction_to_trestle/#step-3-split-the-file-into-smaller-parts","title":"Step 3: Split the file into smaller parts","text":"<p>The OSCAL schema specifies that a catalog must contain metadata, groups, and back-matter - so this command will pull them out of the original file and place them in separate json files for additional manipulations.</p> <p>To begin splitting the file, first cd to the directory where <code>catalog.json</code> has been placed.</p> <pre><code>cd catalogs/mycatalog\ntrestle split -f ./catalog.json -e 'catalog.metadata,catalog.groups,catalog.back-matter'\n</code></pre> <p>Here the <code>-f</code> refers to the filename of the json catalog file, and <code>-e</code> refers to the comma-separated list of <code>elements</code> you would like to split from the file.  This list does not represent the full file contents of the source <code>catalog.json</code> file, so some contents will be left behind in a much smaller <code>catalog.json</code> file after the split.  The elements that were split off will be placed in separate json files next to the new and smaller <code>catalog.json</code> file.</p> <p></p> Your new catalogs directory with json files split out <pre><code>catalogs\n \u2517 mycatalog\n \u2503 \u2523 catalog\n \u2503 \u2503 \u2523 back-matter.json\n \u2503 \u2503 \u2523 groups.json\n \u2503 \u2503 \u2517 metadata.json\n \u2503 \u2517 catalog.json\n</code></pre> <p></p> <p>Note there still remains a catalog.json file, but it is much smaller since the bulk of its contents have been split off.</p> <p>Any split step can be reversed by a corresponding <code>merge</code> operation.  In this case we can go backwards with:</p> <pre><code>trestle merge -e 'catalog.metadata,catalog.groups,catalog.back-matter'\n</code></pre> <p>or simply</p> <pre><code>trestle merge -e 'catalog.*'\n</code></pre> <p>You can go back and forth splitting and merging, but for the next step please start with the above files split so that <code>metadata.json</code> can be further split.</p>"},{"location":"tutorials/introduction_to_trestle/#step-4-split-the-metadata-into-constituent-files","title":"Step 4: Split the metadata into constituent files","text":"<pre><code>cd catalog\ntrestle split -f ./metadata.json -e 'metadata.roles,metadata.parties,metadata.responsible-parties'\n</code></pre> The directory will now look like this, with metadata split into files <pre><code>catalogs\n \u2517 mycatalog\n \u2503 \u2523 catalog\n \u2503 \u2503 \u2523 metadata\n \u2503 \u2503 \u2503 \u2523 parties.json\n \u2503 \u2503 \u2503 \u2523 responsible-parties.json\n \u2503 \u2503 \u2503 \u2517 roles.json\n \u2503 \u2503 \u2523 back-matter.json\n \u2503 \u2503 \u2523 groups.json\n \u2503 \u2503 \u2517 metadata.json\n \u2503 \u2517 catalog.json\n</code></pre> <p>Again there remains a metadata.json file but it is smaller than the original.</p> <p>And this step can be reversed with the following:</p> <pre><code>trestle merge -e 'metadata.roles,metadata.parties,metadata.responsible-parties'\n</code></pre> <p>or simply</p> <pre><code>trestle merge -e 'metadata.*'\n</code></pre>"},{"location":"tutorials/introduction_to_trestle/#step-5-split-metadata-further-using-wildcards","title":"Step 5: Split metadata further using wildcards","text":"<pre><code>cd metadata\ntrestle split -f ./roles.json -e 'roles.*'\ntrestle split -f ./responsible-parties.json -e 'responsible-parties.*'\n</code></pre> The directory now looks like this, with new subdirectories containing multiple roles and responsible-parties <pre><code>catalogs\n \u2517 mycatalog\n \u2503 \u2523 catalog\n \u2503 \u2503 \u2523 metadata\n \u2503 \u2503 \u2503 \u2523 responsible-parties\n \u2503 \u2503 \u2503 \u2503 \u2523 contact__responsible-party.json\n \u2503 \u2503 \u2503 \u2503 \u2517 creator__responsible-party.json\n \u2503 \u2503 \u2503 \u2523 roles\n \u2503 \u2503 \u2503 \u2503 \u2523 00000__role.json\n \u2503 \u2503 \u2503 \u2503 \u2517 00001__role.json\n \u2503 \u2503 \u2503 \u2517 parties.json\n \u2503 \u2503 \u2523 back-matter.json\n \u2503 \u2503 \u2523 groups.json\n \u2503 \u2503 \u2517 metadata.json\n \u2503 \u2517 catalog.json\n</code></pre> <p>Note that the presence of wildcards caused new directories to be created containing the full lists of roles and responsible parties.  You can read the wildcard as split off all roles from <code>roles.json</code>.</p> <p>This split can be reversed with</p> <pre><code>trestle merge -e 'roles.*,responsible-parties.*'\n</code></pre>"},{"location":"tutorials/introduction_to_trestle/#step-6-split-groups-and-controls-with-two-wildcards","title":"Step 6: Split groups and controls with two wildcards","text":"<p>This single command will split off all controls in all groups.  To do it you need to go back up into the catalog directory where the <code>groups.json</code> file is found:</p> <pre><code>cd ..\ntrestle split -f ./groups.json -e 'groups.*.controls.*'\n</code></pre> <p></p> Your directory is now very large with that one command! <pre><code>catalogs\n \u2517 mycatalog\n \u2503 \u2523 catalog\n \u2503 \u2503 \u2523 groups\n \u2503 \u2503 \u2503 \u2523 00000__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00011__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00012__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00013__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00014__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00015__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00016__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00017__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00018__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00019__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00020__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00021__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00022__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00023__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00024__control.json\n \u2503 \u2503 \u2503 \u2523 00001__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00005__control.json\n \u2503 \u2503 \u2503 \u2523 00002__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00011__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00012__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00013__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00014__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00015__control.json\n \u2503 \u2503 \u2503 \u2523 00003__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00008__control.json\n \u2503 \u2503 \u2503 \u2523 00004__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00011__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00012__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00013__control.json\n \u2503 \u2503 \u2503 \u2523 00005__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00011__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00012__control.json\n \u2503 \u2503 \u2503 \u2523 00006__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00011__control.json\n \u2503 \u2503 \u2503 \u2523 00007__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00009__control.json\n \u2503 \u2503 \u2503 \u2523 00008__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00006__control.json\n \u2503 \u2503 \u2503 \u2523 00009__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00007__control.json\n \u2503 \u2503 \u2503 \u2523 00010__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00011__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00012__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00013__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00014__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00015__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00016__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00017__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00018__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00019__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00020__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00021__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00022__control.json\n \u2503 \u2503 \u2503 \u2523 00011__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00010__control.json\n \u2503 \u2503 \u2503 \u2523 00012__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00011__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00012__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00013__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00014__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00015__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00016__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00017__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00018__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00019__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00020__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00021__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00022__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00023__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00024__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00025__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00026__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00027__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00028__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00029__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00030__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00031__control.json\n \u2503 \u2503 \u2503 \u2523 00013__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00008__control.json\n \u2503 \u2503 \u2503 \u2523 00014__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00007__control.json\n \u2503 \u2503 \u2503 \u2523 00015__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00009__control.json\n \u2503 \u2503 \u2503 \u2523 00016__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00011__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00012__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00013__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00014__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00015__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00016__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00017__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00018__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00019__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00020__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00021__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00022__control.json\n \u2503 \u2503 \u2503 \u2523 00017__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00011__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00012__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00013__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00014__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00015__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00016__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00017__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00018__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00019__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00020__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00021__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00022__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00023__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00024__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00025__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00026__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00027__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00028__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00029__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00030__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00031__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00032__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00033__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00034__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00035__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00036__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00037__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00038__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00039__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00040__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00041__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00042__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00043__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00044__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00045__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00046__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00047__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00048__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00049__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00050__control.json\n \u2503 \u2503 \u2503 \u2523 00018__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00011__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00012__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00013__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00014__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00015__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00016__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00017__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00018__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00019__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00020__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00021__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00022__control.json\n \u2503 \u2503 \u2503 \u2523 00019__group\n \u2503 \u2503 \u2503 \u2503 \u2517 controls\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00000__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00001__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00002__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00003__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00004__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00005__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00006__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00007__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00008__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00009__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2523 00010__control.json\n \u2503 \u2503 \u2503 \u2503 \u2503 \u2517 00011__control.json\n \u2503 \u2503 \u2503 \u2523 00000__group.json\n \u2503 \u2503 \u2503 \u2523 00001__group.json\n \u2503 \u2503 \u2503 \u2523 00002__group.json\n \u2503 \u2503 \u2503 \u2523 00003__group.json\n \u2503 \u2503 \u2503 \u2523 00004__group.json\n \u2503 \u2503 \u2503 \u2523 00005__group.json\n \u2503 \u2503 \u2503 \u2523 00006__group.json\n \u2503 \u2503 \u2503 \u2523 00007__group.json\n \u2503 \u2503 \u2503 \u2523 00008__group.json\n \u2503 \u2503 \u2503 \u2523 00009__group.json\n \u2503 \u2503 \u2503 \u2523 00010__group.json\n \u2503 \u2503 \u2503 \u2523 00011__group.json\n \u2503 \u2503 \u2503 \u2523 00012__group.json\n \u2503 \u2503 \u2503 \u2523 00013__group.json\n \u2503 \u2503 \u2503 \u2523 00014__group.json\n \u2503 \u2503 \u2503 \u2523 00015__group.json\n \u2503 \u2503 \u2503 \u2523 00016__group.json\n \u2503 \u2503 \u2503 \u2523 00017__group.json\n \u2503 \u2503 \u2503 \u2523 00018__group.json\n \u2503 \u2503 \u2503 \u2517 00019__group.json\n \u2503 \u2503 \u2523 metadata\n \u2503 \u2503 \u2503 \u2523 responsible-parties\n \u2503 \u2503 \u2503 \u2503 \u2523 contact__responsible-party.json\n \u2503 \u2503 \u2503 \u2503 \u2517 creator__responsible-party.json\n \u2503 \u2503 \u2503 \u2523 roles\n \u2503 \u2503 \u2503 \u2503 \u2523 00000__role.json\n \u2503 \u2503 \u2503 \u2503 \u2517 00001__role.json\n \u2503 \u2503 \u2503 \u2517 parties.json\n \u2503 \u2503 \u2523 back-matter.json\n \u2503 \u2503 \u2517 metadata.json\n \u2503 \u2517 catalog.json\n</code></pre> <p></p> <p>All 20 groups of controls have been split off, and each one has a corresponding directory with its full list of controls in it.</p> <p>You can then reverse the split with</p> <pre><code>trestle merge -e 'groups.*'\n</code></pre>"},{"location":"tutorials/introduction_to_trestle/#step-7-collapse-the-entire-directory-structure-back-into-a-single-catalogjson-file-possibly-after-modifying-individual-files","title":"Step 7: Collapse the entire directory structure back into a single <code>catalog.json</code> file - possibly after modifying individual files","text":"<p>You can collapse everything back to a single <code>catalog.json</code> file after first going up one directory to the mycatalog directory</p> <pre><code>cd ..\ntrestle merge -e 'catalog.*'\n</code></pre> <p></p> After all that splitting and merging you are back to this directory structure <pre><code>catalogs\n \u2517 mycatalog\n \u2503 \u2517 catalog.json\n</code></pre> <p></p>"},{"location":"tutorials/introduction_to_trestle/#conclusion","title":"Conclusion","text":"<p>This completes the tutorial on using <code>trestle</code> to split and merge an OSCAL catalog file.  Not shown here are modifications of the individual files that would be done in an actual use case, but note that if any changes are made that violate the OSCAL schema, <code>trestle</code> will notice them and flag them in the merge.  This way not only does <code>trestle</code> allow user-driven decomposition and aggregation of these large, complex files; it also does constant checks on the contents against the required schema to make sure no errors are introduced in the process.</p>"},{"location":"tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/","title":"Tutorial: Setup for and use of ComplianceAsCode profile to OSCAL Catalog transformer","text":"<p>Here are step by step instructions for setup and transformation of ComplianceAsCode profile data files into NIST standard OSCAL Catalog using the compliance-trestle tool.</p>"},{"location":"tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/#objective","title":"Objective","text":"<p>How to transform one or more <code>.profile</code> compliance files into a standardized <code>OSCAL.json</code> file.</p> <p>There are 2 short steps shown below. The first is a one-time check/set-up of your environment. The second is a one-command transformation from <code>.profile</code> to <code>OSCAL.json</code>.</p>"},{"location":"tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/#step-1-install-trestle-in-a-python-virtual-environment","title":"Step 1: Install trestle in a Python virtual environment","text":"<p>Follow the instructions here to install trestle in a virtual environment.</p>"},{"location":"tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/#step-2-transform-profile-data-cis-benchmarks","title":"Step 2: Transform profile data (CIS benchmarks)","text":"<p>Linux, Mac</p> Windows <p>Make these changes:</p> <ul> <li>use backslashes `\\` for file paths <li>use `md` instead of mkdir -p <li>put the url in double quotes for `curl` <li>use `more` instead of cat </li> </li> </li> </li> </ul> <ul> <li>Navigate to trestle workspace.</li> </ul> <pre><code>(venv.trestle)$ cd trestle.workspace\n</code></pre> <ul> <li>View configuration information.</li> </ul> <pre><code>(venv.trestle)$ trestle task ocp4-cis-profile-to-oscal-catalog -i\ntrestle.core.commands.task:102 WARNING: Config file was not configured with the appropriate section for the task: \"[task.ocp4-cis-profile-to-oscal-catalog]\"\nHelp information for ocp4-cis-profile-to-oscal-catalog task.\n\nPurpose: Create catalog from from standard (e.g. CIS benchmark).\n\nConfiguration flags sit under [task.ocp4-cis-profile-to-oscal-catalog]:\n  input-dir              = (required) location to read the compliance-as-code profile files.\n  output-dir             = (required) location to write the generated catalog.json file.\n  output-overwrite       = (optional) true [default] or false; replace existing output when true.\n</code></pre> <ul> <li>Create data folders.</li> </ul> <pre><code>(venv.trestle)$ mkdir -p adjunct-data/cis-benchmarks\n(venv.trestle)$ mkdir -p adjunct-data/task-files\n</code></pre> <ul> <li>Fetch ComplianceAsCode profile data.</li> </ul> <pre><code>(venv.trestle)$ curl 'https://raw.githubusercontent.com/ComplianceAsCode/content/master/products/ocp4/profiles/cis-node.profile' &gt; adjunct-data/cis-benchmarks/cis-node.profile\n(venv.trestle)$ curl 'https://raw.githubusercontent.com/ComplianceAsCode/content/master/products/ocp4/profiles/cis-node.profile' &gt; adjunct-data/cis-benchmarks/cis.profile\n</code></pre> <ul> <li>Fetch trestle task file.</li> </ul> <pre><code>(venv.trestle)$ curl 'https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/task.ocp4-cis-profile-to-oscal-catalog/demo-ocp4-cis-profile-to-oscal-catalog.config' &gt; adjunct-data/task-files/demo-ocp4-cis-profile-to-oscal-catalog.config\n</code></pre> demo-ocp4-cis-profile-to-oscal-catalog.config <pre><code>[task.ocp4-cis-profile-to-oscal-catalog]\n\ninput-dir = adjunct-data/cis-benchmarks\noutput-dir = catalogs/ocp4-cis\n</code></pre> <ul> <li>Perform and validate the transform.</li> </ul> <pre><code>(venv.trestle)$ trestle task ocp4-cis-profile-to-oscal-catalog -c adjunct-data/task-files/demo-ocp4-cis-profile-to-oscal-catalog.config\noutput: catalogs/ocp4-cis/catalog.json\nTask: ocp4-cis-profile-to-oscal-catalog executed successfully.\n\n(venv.trestle)$ trestle validate --all\nVALID: Model /home/&lt;user&gt;/trestle.workspace/catalogs/ocp4-cis/catalog.json passed the Validator to confirm the model passes all registered validation tests.\n</code></pre> <ul> <li>View the generated OSCAL.</li> </ul> <pre><code>(venv.trestle)$ cat catlogs/ocp4-cis/catalog.json\n</code></pre> catalog.json <pre><code>{\n  \"catalog\": {\n    \"uuid\": \"19543ebf-4667-48b7-be47-d51154f16fda\",\n    \"metadata\": {\n      \"title\": \"CIS Red Hat OpenShift Container Platform 4 Benchmark\",\n      \"last-modified\": \"2021-12-03T13:52:21+00:00\",\n      \"version\": \"0.29.0\",\n      \"oscal-version\": \"1.0.0\",\n      \"links\": [\n        {\n          \"href\": \"https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis-node.profile\"\n        },\n        {\n          \"href\": \"https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile\"\n        }\n      ]\n    },\n    \"groups\": [\n      {\n        \"title\": \"1 Control Plane Components\",\n        \"groups\": [\n          {\n            \"title\": \"1.1 Master Node Configuration Files\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-1.1.1\",\n                \"title\": \"1.1.1 Ensure that the API server pod specification file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.2\",\n                \"title\": \"1.1.2 Ensure that the API server pod specification file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-1.1.3\",\n                \"title\": \"1.1.3 Ensure that the controller manager pod specification file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.4\",\n                \"title\": \"1.1.4 Ensure that the controller manager pod specification file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-1.1.5\",\n                \"title\": \"1.1.5 Ensure that the scheduler pod specification file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.6\",\n                \"title\": \"1.1.6 Ensure that the scheduler pod specification file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-1.1.7\",\n                \"title\": \"1.1.7 Ensure that the etcd pod specification file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.8\",\n                \"title\": \"1.1.8 Ensure that the etcd pod specification file ownership is set to root:root (Automated)\"\n              },\n              {\n                \"id\": \"CIS-1.1.9\",\n                \"title\": \"1.1.9 Ensure that the Container Network Interface file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.10\",\n                \"title\": \"1.1.10 Ensure that the Container Network Interface file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-1.1.11\",\n                \"title\": \"1.1.11 Ensure that the etcd data directory permissions are set to 700 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.12\",\n                \"title\": \"1.1.12 Ensure that the etcd data directory ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-1.1.13\",\n                \"title\": \"1.1.13 Ensure that the admin.conf file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.14\",\n                \"title\": \"1.1.14 Ensure that the admin.conf file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-1.1.15\",\n                \"title\": \"1.1.15 Ensure that the scheduler.conf file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.16\",\n                \"title\": \"1.1.16 Ensure that the scheduler.conf file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-1.1.17\",\n                \"title\": \"1.1.17 Ensure that the controller-manager.conf file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.18\",\n                \"title\": \"1.1.18 Ensure that the controller-manager.conf file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-1.1.19\",\n                \"title\": \"1.1.19 Ensure that the OpenShift PKI directory and file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-1.1.20\",\n                \"title\": \"1.1.20 Ensure that the OpenShift PKI certificate file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-1.1.21\",\n                \"title\": \"1.1.21 Ensure that the OpenShift PKI key file permissions are set to 600\"\n              }\n            ]\n          },\n          {\n            \"title\": \"1.2 API Server\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-1.2.1\",\n                \"title\": \"1.2.1 Ensure that the --anonymous-auth argument is set to false\"\n              },\n              {\n                \"id\": \"CIS-1.2.2\",\n                \"title\": \"1.2.2 Ensure that the --basic-auth-file argument is not set\"\n              },\n              {\n                \"id\": \"CIS-1.2.3\",\n                \"title\": \"1.2.3 Ensure that the --token-auth-file parameter is not set\"\n              },\n              {\n                \"id\": \"CIS-1.2.4\",\n                \"title\": \"1.2.4 Ensure that the --kubelet-https argument is set to true\"\n              },\n              {\n                \"id\": \"CIS-1.2.5\",\n                \"title\": \"1.2.5 Ensure that the --kubelet-client-certificate and --kubelet-client-key arguments are set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.6\",\n                \"title\": \"1.2.6 Ensure that the --kubelet-certificate-authority argument is set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.7\",\n                \"title\": \"1.2.7 Ensure that the --authorization-mode argument is not set to AlwaysAllow\"\n              },\n              {\n                \"id\": \"CIS-1.2.8\",\n                \"title\": \"1.2.8 Ensure that the --authorization-mode argument includes Node\"\n              },\n              {\n                \"id\": \"CIS-1.2.9\",\n                \"title\": \"1.2.9 Ensure that the --authorization-mode argument includes RBAC\"\n              },\n              {\n                \"id\": \"CIS-1.2.10\",\n                \"title\": \"1.2.10 Ensure that the admission control plugin EventRateLimit is set\"\n              },\n              {\n                \"id\": \"CIS-1.2.11\",\n                \"title\": \"1.2.11 Ensure that the admission control plugin AlwaysAdmit is not set\"\n              },\n              {\n                \"id\": \"CIS-1.2.12\",\n                \"title\": \"1.2.12 Ensure that the admission control plugin AlwaysPullImages is set\"\n              },\n              {\n                \"id\": \"CIS-1.2.13\",\n                \"title\": \"1.2.13 Ensure that the admission control plugin SecurityContextDeny is not set\"\n              },\n              {\n                \"id\": \"CIS-1.2.14\",\n                \"title\": \"1.2.14 Ensure that the admission control plugin ServiceAccount is set\"\n              },\n              {\n                \"id\": \"CIS-1.2.15\",\n                \"title\": \"1.2.15 Ensure that the admission control plugin NamespaceLifecycle is set\"\n              },\n              {\n                \"id\": \"CIS-1.2.16\",\n                \"title\": \"1.2.16 Ensure that the admission control plugin PodSecurityPolicy is set (Automated)\"\n              },\n              {\n                \"id\": \"CIS-1.2.17\",\n                \"title\": \"1.2.17 Ensure that the admission control plugin NodeRestriction is set (Automated)\"\n              },\n              {\n                \"id\": \"CIS-1.2.18\",\n                \"title\": \"1.2.18 Ensure that the --insecure-bind-address argument is not set\"\n              },\n              {\n                \"id\": \"CIS-1.2.19\",\n                \"title\": \"1.2.19 Ensure that the --insecure-port argument is set to 0\"\n              },\n              {\n                \"id\": \"CIS-1.2.20\",\n                \"title\": \"1.2.20 Ensure that the --secure-port argument is not set to 0\"\n              },\n              {\n                \"id\": \"CIS-1.2.21\",\n                \"title\": \"1.2.21 Ensure that the --profiling argument is set to false\"\n              },\n              {\n                \"id\": \"CIS-1.2.22\",\n                \"title\": \"1.2.22 Ensure that the --audit-log-path argument is set\"\n              },\n              {\n                \"id\": \"CIS-1.2.23\",\n                \"title\": \"1.2.23 Ensure that the audit logs are forwarded off the cluster for retention\"\n              },\n              {\n                \"id\": \"CIS-1.2.24\",\n                \"title\": \"1.2.24 Ensure that the --audit-log-maxbackup argument is set to 10 or as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.25\",\n                \"title\": \"1.2.25 Ensure that the --audit-log-maxsize argument is set to 100 or as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.26\",\n                \"title\": \"1.2.26 Ensure that the --request-timeout argument is set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.27\",\n                \"title\": \"1.2.27 Ensure that the --service-account-lookup argument is set to true\"\n              },\n              {\n                \"id\": \"CIS-1.2.28\",\n                \"title\": \"1.2.28 Ensure that the --service-account-key-file argument is set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.29\",\n                \"title\": \"1.2.29 Ensure that the --etcd-certfile and --etcd-keyfile arguments are set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.30\",\n                \"title\": \"1.2.30 Ensure that the --tls-cert-file and --tls-private-key-file arguments are set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.31\",\n                \"title\": \"1.2.31 Ensure that the --client-ca-file argument is set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.32\",\n                \"title\": \"1.2.32 Ensure that the --etcd-cafile argument is set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.33\",\n                \"title\": \"1.2.33 Ensure that the --encryption-provider-config argument is set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.2.34\",\n                \"title\": \"1.2.34 Ensure that encryption providers are appropriately configured\"\n              },\n              {\n                \"id\": \"CIS-1.2.35\",\n                \"title\": \"1.2.35 Ensure that the API Server only makes use of Strong Cryptographic Ciphers\"\n              }\n            ]\n          },\n          {\n            \"title\": \"1.3 Controller Manager\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-1.3.1\",\n                \"title\": \"1.3.1 Ensure that garbage collection is configured as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.3.2\",\n                \"title\": \"1.3.2 Ensure that controller manager healthz endpoints are protected by RBAC. (Automated)\"\n              },\n              {\n                \"id\": \"CIS-1.3.3\",\n                \"title\": \"1.3.3 Ensure that the --use-service-account-credentials argument is set to true\"\n              },\n              {\n                \"id\": \"CIS-1.3.4\",\n                \"title\": \"1.3.4 Ensure that the --service-account-private-key-file argument is set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.3.5\",\n                \"title\": \"1.3.5 Ensure that the --root-ca-file argument is set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-1.3.6\",\n                \"title\": \"1.3.6 Ensure that the RotateKubeletServerCertificate argument is set to true\"\n              },\n              {\n                \"id\": \"CIS-1.3.7\",\n                \"title\": \"1.3.7 Ensure that the --bind-address argument is set to 127.0.0.1\"\n              }\n            ]\n          },\n          {\n            \"title\": \"1.4 Scheduler\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-1.4.1\",\n                \"title\": \"1.4.1 Ensure that the --profiling argument is set to false  (info only)\"\n              },\n              {\n                \"id\": \"CIS-1.4.2\",\n                \"title\": \"1.4.2 Ensure that the --bind-address argument is set to 127.0.0.1\"\n              }\n            ]\n          }\n        ]\n      },\n      {\n        \"title\": \"2 etcd\",\n        \"controls\": [\n          {\n            \"id\": \"CIS-2.1\",\n            \"title\": \"2.1 Ensure that the --cert-file and --key-file arguments are set as appropriate\"\n          },\n          {\n            \"id\": \"CIS-2.2\",\n            \"title\": \"2.2 Ensure that the --client-cert-auth argument is set to true\"\n          },\n          {\n            \"id\": \"CIS-2.3\",\n            \"title\": \"2.3 Ensure that the --auto-tls argument is not set to true\"\n          },\n          {\n            \"id\": \"CIS-2.4\",\n            \"title\": \"2.4 Ensure that the --peer-cert-file and --peer-key-file arguments are set as appropriate\"\n          },\n          {\n            \"id\": \"CIS-2.5\",\n            \"title\": \"2.5 Ensure that the --peer-client-cert-auth argument is set to true\"\n          },\n          {\n            \"id\": \"CIS-2.6\",\n            \"title\": \"2.6 Ensure that the --peer-auto-tls argument is not set to true\"\n          },\n          {\n            \"id\": \"CIS-2.7\",\n            \"title\": \"2.7 Ensure that a unique Certificate Authority is used for etcd\"\n          }\n        ]\n      },\n      {\n        \"title\": \"3 Control Plane Configuration\",\n        \"groups\": [\n          {\n            \"title\": \"3.1 Authentication and Authorization\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-3.1.1\",\n                \"title\": \"3.1.1 Client certificate authentication should not be used for users\"\n              }\n            ]\n          },\n          {\n            \"title\": \"3.2 Logging\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-3.2.1\",\n                \"title\": \"3.2.1 Ensure that a minimal audit policy is created\"\n              },\n              {\n                \"id\": \"CIS-3.2.2\",\n                \"title\": \"3.2.2 Ensure that the audit policy covers key security concerns\"\n              }\n            ]\n          }\n        ]\n      },\n      {\n        \"title\": \"4 Worker Nodes\",\n        \"groups\": [\n          {\n            \"title\": \"4.1 Worker node configuration\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-4.1.1\",\n                \"title\": \"4.1.1 Ensure that the kubelet service file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-4.1.2\",\n                \"title\": \"4.1.2 Ensure that the kubelet service file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-4.1.3\",\n                \"title\": \"4.1.3 If proxy kubeconfig file exists ensure permissions are set to 644 or more restrictive (Automated)\"\n              },\n              {\n                \"id\": \"CIS-4.1.4\",\n                \"title\": \"4.1.4 If proxy kubeconfig file exists ensure ownership is set to root:root (Manual)\"\n              },\n              {\n                \"id\": \"CIS-4.1.5\",\n                \"title\": \"4.1.5 Ensure that the --kubeconfig kubelet.conf file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-4.1.6\",\n                \"title\": \"4.1.6 Ensure that the --kubeconfig kubelet.conf file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-4.1.7\",\n                \"title\": \"4.1.7 Ensure that the certificate authorities file permissions are set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-4.1.8\",\n                \"title\": \"4.1.8 Ensure that the client certificate authorities file ownership is set to root:root\"\n              },\n              {\n                \"id\": \"CIS-4.1.9\",\n                \"title\": \"4.1.9 Ensure that the kubelet --config configuration file has permissions set to 644 or more restrictive\"\n              },\n              {\n                \"id\": \"CIS-4.1.10\",\n                \"title\": \"4.1.10 Ensure that the kubelet configuration file ownership is set to root:root\"\n              }\n            ]\n          },\n          {\n            \"title\": \"4.2 Kubelet\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-4.2.1\",\n                \"title\": \"4.2.1 Ensure that the --anonymous-auth argument is set to false\"\n              },\n              {\n                \"id\": \"CIS-4.2.2\",\n                \"title\": \"4.2.2 Ensure that the --authorization-mode argument is not set to AlwaysAllow\"\n              },\n              {\n                \"id\": \"CIS-4.2.3\",\n                \"title\": \"4.2.3 Ensure that the --client-ca-file argument is set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-4.2.4\",\n                \"title\": \"4.2.4 Ensure that the --read-only-port argument is set to 0\"\n              },\n              {\n                \"id\": \"CIS-4.2.5\",\n                \"title\": \"4.2.5 Ensure that the --streaming-connection-idle-timeout argument is not set to 0\"\n              },\n              {\n                \"id\": \"CIS-4.2.6\",\n                \"title\": \"4.2.6 Ensure that the --protect-kernel-defaults argument is set to true\"\n              },\n              {\n                \"id\": \"CIS-4.2.7\",\n                \"title\": \"4.2.7 Ensure that the --make-iptables-util-chains argument is set to true\"\n              },\n              {\n                \"id\": \"CIS-4.2.8\",\n                \"title\": \"4.2.8 Ensure that the --hostname-override argument is not set\"\n              },\n              {\n                \"id\": \"CIS-4.2.9\",\n                \"title\": \"4.2.9 Ensure that the --event-qps argument is set to 0 or a level which ensures appropriate event capture\"\n              },\n              {\n                \"id\": \"CIS-4.2.10\",\n                \"title\": \"4.2.10 Ensure that the --tls-cert-file and --tls-private-key-file arguments are set as appropriate\"\n              },\n              {\n                \"id\": \"CIS-4.2.11\",\n                \"title\": \"4.2.11 Ensure that the --rotate-certificates argument is not set to false\"\n              },\n              {\n                \"id\": \"CIS-4.2.12\",\n                \"title\": \"4.2.12 Verify that the RotateKubeletServerCertificate argument is set to true\"\n              },\n              {\n                \"id\": \"CIS-4.2.13\",\n                \"title\": \"4.2.13 Ensure that the Kubelet only makes use of Strong Cryptographic Ciphers\"\n              }\n            ]\n          }\n        ]\n      },\n      {\n        \"title\": \"5 Policies\",\n        \"groups\": [\n          {\n            \"title\": \"5.1 RBAC and Service Accounts\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-5.1.1\",\n                \"title\": \"5.1.1 Ensure that the cluster-admin role is only used where required\"\n              },\n              {\n                \"id\": \"CIS-5.1.2\",\n                \"title\": \"5.1.2 Minimize access to secrets (info)\"\n              },\n              {\n                \"id\": \"CIS-5.1.3\",\n                \"title\": \"5.1.3 Minimize wildcard use in Roles and ClusterRoles (info)\"\n              },\n              {\n                \"id\": \"CIS-5.1.4\",\n                \"title\": \"5.1.4 Minimize access to create pods (info)\"\n              },\n              {\n                \"id\": \"CIS-5.1.5\",\n                \"title\": \"5.1.5 Ensure that default service accounts are not actively used. (info)\"\n              },\n              {\n                \"id\": \"CIS-5.1.6\",\n                \"title\": \"5.1.6 Ensure that Service Account Tokens are only mounted where necessary (info)\"\n              }\n            ]\n          },\n          {\n            \"title\": \"5.2 Pod Security Policies / Security Context Constraints\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-5.2.1\",\n                \"title\": \"5.2.1 Minimize the admission of privileged containers (info)\"\n              },\n              {\n                \"id\": \"CIS-5.2.2\",\n                \"title\": \"5.2.2 Minimize the admission of containers wishing to share the host process ID namespace (info)\"\n              },\n              {\n                \"id\": \"CIS-5.2.3\",\n                \"title\": \"5.2.3 Minimize the admission of containers wishing to share the host IPC namespace (info)\"\n              },\n              {\n                \"id\": \"CIS-5.2.4\",\n                \"title\": \"5.2.4 Minimize the admission of containers wishing to share the host network namespace (info)\"\n              },\n              {\n                \"id\": \"CIS-5.2.5\",\n                \"title\": \"5.2.5 Minimize the admission of containers with allowPrivilegeEscalation (info)\"\n              },\n              {\n                \"id\": \"CIS-5.2.6\",\n                \"title\": \"5.2.6 Minimize the admission of root containers (info)\"\n              },\n              {\n                \"id\": \"CIS-5.2.7\",\n                \"title\": \"5.2.7 Minimize the admission of containers with the NET_RAW capability (info)\"\n              },\n              {\n                \"id\": \"CIS-5.2.8\",\n                \"title\": \"5.2.8 Minimize the admission of containers with added capabilities (info)\"\n              },\n              {\n                \"id\": \"CIS-5.2.9\",\n                \"title\": \"5.2.9 Minimize the admission of containers with capabilities assigned (info)\"\n              }\n            ]\n          },\n          {\n            \"title\": \"5.3 Network Policies and CNI\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-5.3.1\",\n                \"title\": \"5.3.1 Ensure that the CNI in use supports Network Policies (info)\"\n              },\n              {\n                \"id\": \"CIS-5.3.2\",\n                \"title\": \"5.3.2 Ensure that all Namespaces have Network Policies defined\"\n              }\n            ]\n          },\n          {\n            \"title\": \"5.4 Secrets Management\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-5.4.1\",\n                \"title\": \"5.4.1 Prefer using secrets as files over secrets as environment variables (info)\"\n              },\n              {\n                \"id\": \"CIS-5.4.2\",\n                \"title\": \"5.4.2 Consider external secret storage (info)\"\n              }\n            ]\n          },\n          {\n            \"title\": \"5.5 Extensible Admission Control\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-5.5.1\",\n                \"title\": \"5.5.1 Configure Image Provenance using ImagePolicyWebhook admission controller\"\n              }\n            ]\n          },\n          {\n            \"title\": \"5.6 General Policies\",\n            \"controls\": [\n              {\n                \"id\": \"CIS-5.6.1\",\n                \"title\": \"5.6.1 Create administrative boundaries between resources using namespaces (info)\"\n              },\n              {\n                \"id\": \"CIS-5.6.2\",\n                \"title\": \"5.6.2 Ensure Seccomp Profile Pod Definitions (info)\"\n              },\n              {\n                \"id\": \"CIS-5.6.3\",\n                \"title\": \"5.6.3 Apply Security Context to your Pods and Containers (info)\"\n              },\n              {\n                \"id\": \"CIS-5.6.4\",\n                \"title\": \"5.6.4 The Default Namespace should not be used (info)\"\n              }\n            ]\n          }\n        ]\n      }\n    ]\n  }\n}\n</code></pre> <p> </p> <p> Congratulations! You have completed this tutorial. </p> <p> </p>"},{"location":"tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/","title":"Tutorial: Setup for and use of ComplianceAsCode profile to OSCAL Component Definition transformer","text":"<p>Here are step by step instructions for setup and transformation of ComplianceAsCode profile data files into NIST standard OSCAL Component Definition using the compliance-trestle tool.</p>"},{"location":"tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/#objective","title":"Objective","text":"<p>How to transform one or more <code>.profile</code> compliance files into a standardized <code>OSCAL.json</code> file.</p> <p>There are 2 short steps shown below. The first is a one-time check/set-up of your environment. The second is a one-command transformation from <code>.profile</code> to <code>OSCAL.json</code>.</p>"},{"location":"tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/#step-1-install-trestle-in-a-python-virtual-environment","title":"Step 1: Install trestle in a Python virtual environment","text":"<p>Follow the instructions here to install trestle in a virtual environment.</p>"},{"location":"tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/#step-2-transform-profile-data-cis-benchmarks","title":"Step 2: Transform profile data (CIS benchmarks)","text":"<p>Linux, Mac</p> Windows <p>Make these changes:</p> <ul> <li>use backslashes `\\` for file paths <li>use `md` instead of mkdir -p <li>put the url in double quotes for `curl` <li>use `more` instead of cat </li> </li> </li> </li> </ul> <ul> <li>Navigate to trestle workspace.</li> </ul> <pre><code>(venv.trestle)$ cd trestle.workspace\n</code></pre> <ul> <li>View configuration information.</li> </ul> <pre><code>(venv.trestle)$ trestle task ocp4-cis-profile-to-oscal-cd -i\ntrestle.core.commands.task:99 WARNING: Config file was not configured with the appropriate section for the task: \"[task.ocp4-cis-profile-to-oscal-cd]\"\nHelp information for ocp4-cis-profile-to-oscal-cd task.\n\nPurpose: Create component definition from standard (e.g. CIS benchmark).\n\nConfiguration flags sit under [task.ocp4-cis-profile-to-oscal-cd]:\n  component-name         = component name, e.g. OSCO.\n  org-name               = organization name, e.g. International Business Machines.\n  org-remarks            = organization remarks, e.g. IBM.\n  folder-cac             = folder containing compliance-as-code artifacts, e.g adjunct-data/cis-benchmarks/content.\n  output-dir             = location to write the generated component-definition.json file.\n  profile-name           = profile name, e.g. OCP4 CIS-benchmark v4.\n  profile-mnemonic       = profile mnemonic, e.g. ocp4-cis-node.\n  profile-ns             = profile ns, e.g. http://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud.\n  profile-version        = profile version, e.g. 1.1.\n  profile-check-version  = profile check version, e.g. 0.1.58.\n  profile-type           = profile type, e.g. OCP4.\n  profile-list           = profile list is blank separated list of \"&lt;suffix&gt;\" for config entries: \n                           profile-file.&lt;suffix&gt;, profile-title.&lt;suffix&gt;, profile-url.&lt;suffix&gt;, e.g. cis cis-node.\n  profile-file.&lt;suffix&gt;  = path of the profile file to ingest, e.g. ${folder-cac}/products/ocp4/profiles/cis-node.profile.\n  profile-title.&lt;suffix&gt; = title of the profile, e.g. CIS Red Hat OpenShift Container Platform 4 Benchmark.\n  profile-url.&lt;suffix&gt;   = URL of the profile, e.g. https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile.\n  rule-to-parameters-map = map file for set-parameters, e.g. adjunct-data/task-files/rule2var.json.\n  selected-rules         = file with list of selected rules, e.g. adjunct-data/task-files/selected_rules.json.\n  enabled-rules          = file with list of enabled rules, e.g. adjunct-data/task-files/enabled_rules.json.\n\nNotes:\n1. If a control has selected rules but no enabled rules, then all those selected are included.\n2. If a control has selected and enabled rules, then only those enabled are included.\n3. If a control has no selected rules, then none are included regardless of enabled.\n</code></pre> <ul> <li>Create data folders.</li> </ul> <pre><code>(venv.trestle)$ mkdir -p adjunct-data/cis-benchmarks\n(venv.trestle)$ mkdir -p adjunct-data/config-files\n(venv.trestle)$ mkdir -p adjunct-data/task-files\n</code></pre> <ul> <li>Fetch ComplianceAsCode data.</li> </ul> <pre><code>(venv.trestle)$ cd adjunct-data/cis-benchmarks/\n(venv.trestle)$ git clone https://github.com/ComplianceAsCode/content.git\n(venv.trestle)$ cd -\n</code></pre> <ul> <li>Fetch trestle config and task files.</li> </ul> <pre><code>(venv.trestle)$ curl 'https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/task.ocp4-cis-profile-to-oscal-cd/demo-ocp4-cis-profile-to-oscal-cd.config' &gt; adjunct-data/config-files/demo-ocp4-cis-profile-to-oscal-cd.config\n(venv.trestle)$ curl 'https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/task.ocp4-cis-profile-to-oscal-cd/selected_rules.json' &gt; adjunct-data/task-files/selected_rules.json\n(venv.trestle)$ curl 'https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/task.ocp4-cis-profile-to-oscal-cd/enabled_rules.json' &gt; adjunct-data/task-files/enabled_rules.json\n</code></pre> demo-ocp4-cis-profile-to-oscal-cd.config <pre><code>[task.ocp4-cis-profile-to-oscal-cd]\n\ncomponent-name = OSCO\n\nfolder-cac = adjunct-data/cis-benchmarks/content\n\norg-name = International Business Machines\norg-remarks = IBM\n\noutput-dir = component-definitions/ocp4-cis\n\nprofile-name = OCP4 CIS-benchmark v4\nprofile-mnemonic = ocp4-cis-node\nprofile-ns = http://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud\nprofile-version = 1.1\nprofile-check-version = 0.1.58\n\nprofile-type = OCP4\nprofile-list = cis-node cis\n\nprofile-file.cis-node = ${folder-cac}/products/ocp4/profiles/cis-node.profile\nprofile-url.cis-node = https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis-node.profile\nprofile-title.cis-node = CIS Red Hat OpenShift Container Platform 4 Benchmark\n\nprofile-file.cis = ${folder-cac}/products/ocp4/profiles/cis.profile\nprofile-url.cis = https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile\nprofile-title.cis = CIS Red Hat OpenShift Container Platform 4 Benchmark\n\nselected-rules  = adjunct-data/task-files/selected_rules.json\nenabled-rules  = adjunct-data/task-files/enabled_rules.json\n</code></pre> selected_rules.json <pre><code>[\n  \"file_permissions_kube_apiserver\",\n  \"file_owner_kube_apiserver\",\n  \"file_groupowner_kube_apiserver\"\n]\n</code></pre> enabled_rules.json <pre><code>[\n  \"file_permissions_cni_conf\",\n  \"file_permissions_multus_conf\",\n  \"file_owner_cni_conf\",\n  \"file_groupowner_cni_conf\",\n  \"file_owner_multus_conf\",\n  \"file_groupowner_multus_conf\",\n  \"kubelet_eviction_thresholds_set_soft_memory_available\",\n  \"kubelet_eviction_thresholds_set_soft_nodefs_available\",\n  \"kubelet_eviction_thresholds_set_soft_nodefs_inodesfree\",\n  \"kubelet_eviction_thresholds_set_soft_imagefs_available\",\n  \"kubelet_eviction_thresholds_set_soft_imagefs_inodesfree\",\n  \"kubelet_eviction_thresholds_set_hard_memory_available\",\n  \"kubelet_eviction_thresholds_set_hard_nodefs_available\",\n  \"kubelet_eviction_thresholds_set_hard_nodefs_inodesfree\",\n  \"kubelet_eviction_thresholds_set_hard_imagefs_available\",\n  \"kubelet_eviction_thresholds_set_hard_imagefs_inodesfree\",\n  \"etcd_unique_ca\",\n  \"file_permissions_kubelet_conf\",\n  \"file_groupowner_kubelet_conf\",\n  \"file_owner_kubelet_conf\",\n  \"file_permissions_worker_ca\",\n  \"file_owner_worker_ca\",\n  \"file_groupowner_worker_ca\",\n  \"kubelet_anonymous_auth\",\n  \"kubelet_configure_client_ca\",\n  \"kubelet_enable_streaming_connections\",\n  \"kubelet_enable_iptables_util_chains\",\n  \"kubelet_disable_hostname_override\",\n  \"kubelet_configure_event_creation\",\n  \"kubelet_configure_tls_cipher_suites\"\n]\n</code></pre> <ul> <li>Perform and validate the transform.</li> </ul> <pre><code>(venv.trestle)$ trestle task ocp4-cis-profile-to-oscal-cd -c adjunct-data/config-files/demo-ocp4-cis-profile-to-oscal-cd.config\noutput: component-definitions/ocp4-cis/component-definition.json\nTask: ocp4-cis-profile-to-oscal-cd executed successfully.\n\n(venv.trestle)$ trestle validate --all\nVALID: Model /home/&lt;user&gt;/trestle.workspace/component-definitions/ocp4-cis/component-definition.json passed the Validator to confirm the model passes all registered validation tests.\n</code></pre> <ul> <li>View the generated OSCAL.</li> </ul> <pre><code>(venv.trestle)$ cat component-definitions/ocp4-cis/component-definition.json\n</code></pre> component-definition.json <pre><code>{\n  \"component-definition\": {\n    \"uuid\": \"d1b961ee-188b-42b9-943d-e11dc260f9dc\",\n    \"metadata\": {\n      \"title\": \"Component definition for OCP4 profiles\",\n      \"last-modified\": \"2022-01-06T22:43:59+00:00\",\n      \"version\": \"0.33.0\",\n      \"oscal-version\": \"1.0.0\",\n      \"roles\": [\n        {\n          \"id\": \"prepared-by\",\n          \"title\": \"Indicates the organization that created this content.\"\n        },\n        {\n          \"id\": \"prepared-for\",\n          \"title\": \"Indicates the organization for which this content was created..\"\n        },\n        {\n          \"id\": \"content-approver\",\n          \"title\": \"Indicates the organization responsible for all content represented in the \\\"document\\\".\"\n        }\n      ],\n      \"parties\": [\n        {\n          \"uuid\": \"d00dff65-e4ae-4344-a206-1e298eff9066\",\n          \"type\": \"organization\",\n          \"name\": \"International Business Machines\",\n          \"remarks\": \"IBM\"\n        },\n        {\n          \"uuid\": \"851b55f0-5ba6-4684-8a48-5dad22ba2625\",\n          \"type\": \"organization\",\n          \"name\": \"Customer\",\n          \"remarks\": \"organization to be customized at account creation only for their Component Definition\"\n        },\n        {\n          \"uuid\": \"150f9eb7-7fa5-4989-b9be-bc3cba220354\",\n          \"type\": \"organization\",\n          \"name\": \"ISV\",\n          \"remarks\": \"organization to be customized at ISV subscription only for their Component Definition\"\n        }\n      ],\n      \"responsible-parties\": [\n        {\n          \"role-id\": \"prepared-by\",\n          \"party-uuids\": [\n            \"d00dff65-e4ae-4344-a206-1e298eff9066\"\n          ]\n        },\n        {\n          \"role-id\": \"prepared-for\",\n          \"party-uuids\": [\n            \"851b55f0-5ba6-4684-8a48-5dad22ba2625\",\n            \"150f9eb7-7fa5-4989-b9be-bc3cba220354\"\n          ]\n        },\n        {\n          \"role-id\": \"content-approver\",\n          \"party-uuids\": [\n            \"d00dff65-e4ae-4344-a206-1e298eff9066\"\n          ]\n        }\n      ]\n    },\n    \"components\": [\n      {\n        \"uuid\": \"e2ee2b93-6103-42de-b615-65b0b3ff2dc4\",\n        \"type\": \"Service\",\n        \"title\": \"OSCO\",\n        \"description\": \"OSCO\",\n        \"control-implementations\": [\n          {\n            \"uuid\": \"f9c2699a-2d2c-4ee2-87f3-042d1a9b3a79\",\n            \"source\": \"https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis-node.profile\",\n            \"description\": \"OSCO implemented controls for CIS Red Hat OpenShift Container Platform 4 Benchmark.\",\n            \"props\": [\n              {\n                \"name\": \"profile_name\",\n                \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud\",\n                \"value\": \"OCP4 CIS-benchmark v4\",\n                \"class\": \"scc_profile_name\"\n              },\n              {\n                \"name\": \"profile_mnemonic\",\n                \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud\",\n                \"value\": \"ocp4-cis-node\",\n                \"class\": \"scc_profile_mnemonic\"\n              },\n              {\n                \"name\": \"profile_version\",\n                \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud\",\n                \"value\": \"1.1\",\n                \"class\": \"scc_profile_version\"\n              },\n              {\n                \"name\": \"profile_check_version\",\n                \"value\": \"0.1.58\"\n              }\n            ],\n            \"implemented-requirements\": [\n              {\n                \"uuid\": \"97142b13-bc30-4e72-be7f-36de9149a679\",\n                \"control-id\": \"CIS-1.1.1\",\n                \"description\": \"Ensure that the API server pod specification file permissions are set to 644 or more restrictive\",\n                \"props\": [\n                  {\n                    \"name\": \"XCCDF_rule\",\n                    \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud\",\n                    \"value\": \"xccdf_org.ssgproject.content_rule_file_permissions_kube_apiserver\",\n                    \"class\": \"scc_goal_name_id\",\n                    \"remarks\": \"Verify Permissions on the Kubernetes API Server Pod Specification File\"\n                  }\n                ],\n                \"responsible-roles\": [\n                  {\n                    \"role-id\": \"prepared-by\",\n                    \"party-uuids\": [\n                      \"d00dff65-e4ae-4344-a206-1e298eff9066\"\n                    ]\n                  },\n                  {\n                    \"role-id\": \"prepared-for\",\n                    \"party-uuids\": [\n                      \"851b55f0-5ba6-4684-8a48-5dad22ba2625\",\n                      \"150f9eb7-7fa5-4989-b9be-bc3cba220354\"\n                    ]\n                  },\n                  {\n                    \"role-id\": \"content-approver\",\n                    \"party-uuids\": [\n                      \"d00dff65-e4ae-4344-a206-1e298eff9066\"\n                    ]\n                  }\n                ]\n              },\n              {\n                \"uuid\": \"0690e2a7-b228-4954-93fe-c1d55936cfa8\",\n                \"control-id\": \"CIS-1.1.2\",\n                \"description\": \"Ensure that the API server pod specification file ownership is set to root:root\",\n                \"props\": [\n                  {\n                    \"name\": \"XCCDF_rule\",\n                    \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud\",\n                    \"value\": \"xccdf_org.ssgproject.content_rule_file_owner_kube_apiserver\",\n                    \"class\": \"scc_goal_name_id\",\n                    \"remarks\": \"Verify User Who Owns The Kubernetes API Server Pod Specification File\"\n                  }\n                ],\n                \"responsible-roles\": [\n                  {\n                    \"role-id\": \"prepared-by\",\n                    \"party-uuids\": [\n                      \"d00dff65-e4ae-4344-a206-1e298eff9066\"\n                    ]\n                  },\n                  {\n                    \"role-id\": \"prepared-for\",\n                    \"party-uuids\": [\n                      \"851b55f0-5ba6-4684-8a48-5dad22ba2625\",\n                      \"150f9eb7-7fa5-4989-b9be-bc3cba220354\"\n                    ]\n                  },\n                  {\n                    \"role-id\": \"content-approver\",\n                    \"party-uuids\": [\n                      \"d00dff65-e4ae-4344-a206-1e298eff9066\"\n                    ]\n                  }\n                ]\n              },\n              {\n                \"uuid\": \"18c61fb2-8603-440d-9d9a-8d6d1e232cd3\",\n                \"control-id\": \"CIS-1.1.2\",\n                \"description\": \"Ensure that the API server pod specification file ownership is set to root:root\",\n                \"props\": [\n                  {\n                    \"name\": \"XCCDF_rule\",\n                    \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud\",\n                    \"value\": \"xccdf_org.ssgproject.content_rule_file_groupowner_kube_apiserver\",\n                    \"class\": \"scc_goal_name_id\",\n                    \"remarks\": \"Verify Group Who Owns The Kubernetes API Server Pod Specification File\"\n                  }\n                ],\n                \"responsible-roles\": [\n                  {\n                    \"role-id\": \"prepared-by\",\n                    \"party-uuids\": [\n                      \"d00dff65-e4ae-4344-a206-1e298eff9066\"\n                    ]\n                  },\n                  {\n                    \"role-id\": \"prepared-for\",\n                    \"party-uuids\": [\n                      \"851b55f0-5ba6-4684-8a48-5dad22ba2625\",\n                      \"150f9eb7-7fa5-4989-b9be-bc3cba220354\"\n                    ]\n                  },\n                  {\n                    \"role-id\": \"content-approver\",\n                    \"party-uuids\": [\n                      \"d00dff65-e4ae-4344-a206-1e298eff9066\"\n                    ]\n                  }\n                ]\n              }\n            ]\n          }\n        ]\n      }\n    ]\n  }\n}\n</code></pre> <p> </p> <p> Congratulations! You have completed this tutorial. </p> <p> </p>"},{"location":"tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/","title":"Tutorial: Setup for and use of Tanium to OSCAL transformer","text":"<p>Here are step by step instructions for setup and transformation of Tanium compliance data files into NIST standard OSCAL using the compliance-trestle tool.</p>"},{"location":"tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/#objective","title":"Objective","text":"<p>How to transform a <code>Tanium.results</code> compliance file into a standardized <code>OSCAL.json</code> file.</p> <p>There are 2 short steps shown below. The first is a one-time check/set-up of your environment. The second is a one-command transformation from <code>Tanium.results</code> to <code>OSCAL.json</code>.</p>"},{"location":"tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/#step-1-environment-setup","title":"Step 1: Environment setup","text":"<p>Linux, Mac</p> Windows <p>Make these changes:</p> <ul> <li>use backslashes `\\` for file paths <li>use `md` instead of mkdir -p <li>put the url in double quotes for `curl` <li>use `more` instead of cat </li> </li> </li> </li> </ul> <ul> <li>Insure you have a modern Python (3.9, 3.10, 3.11).</li> </ul> <pre><code>$ python -V\nPython 3.8.3\n</code></pre> <ul> <li>Setup a virtual environment.</li> </ul> <pre><code>$ cd\n$ python -m venv venv.trestle\n$ source venv.trestle/bin/activate\n(venv.trestle)$\n</code></pre> <ul> <li>Insure you have a modern pip (19.x or greater).</li> </ul> <pre><code>(venv.trestle)$ pip --version\npip 19.2.3 from /home...\n</code></pre> <ul> <li>Install compliance-trestle.</li> </ul> <pre><code>(venv.trestle)$ pip install compliance-trestle\nLooking in indexes: https://pypi.org/simple,...\n</code></pre> <ul> <li>Check trestle viability (and view help).</li> </ul> <pre><code>(venv.trestle)$ trestle -h\nusage: trestle [-h] {init,create,split,merge,replicate,add,remove,validate,import,task,assemble} ...\n</code></pre> <ul> <li>Create trestle workspace.</li> </ul> <pre><code>(venv.trestle)$ mkdir trestle.workspace\n(venv.trestle)$ cd trestle.workspace\n(venv.trestle)$ trestle init\nInitialized trestle project successfully in /home/&lt;user&gt;/trestle.workspace\n</code></pre>"},{"location":"tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/#step-2-transform-sample","title":"Step 2: Transform sample","text":"<ul> <li>Create Tanium data folders.</li> </ul> <pre><code>(venv.trestle)$ mkdir -p tanium/tests/data/tasks/tanium/input\n</code></pre> <ul> <li>Fetch sample Tanium data file. It is a \"raw\" Tanium result for which a transformation to OSCAL is desired.</li> </ul> <pre><code>(venv.trestle)$ curl 'https://raw.githubusercontent.com/oscal-compass/compliance-trestle/develop/tests/data/tasks/tanium/input-doc/Tanium.doc-json' &gt; tanium/tests/data/tasks/tanium/input/Tanium.doc-json\n</code></pre> sample: Tanium.doc-json <pre><code>{\n  \"Computer Name\": \"RHEL8\",\n  \"Tanium Client IP Address\": \"192.168.0.125\",\n  \"IP Address\": [\n    \"192.168.0.125\",\n    \"192.168.122.1\",\n    \"fe80::3c47:1aff:fe33:601\"\n  ],\n  \"Comply - Compliance Findings\": [\n    {\n      \"Check ID\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\",\n      \"State\": \"fail\",\n      \"Rule ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\"\n    },\n    {\n      \"Check ID\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled\",\n      \"State\": \"fail\",\n      \"Rule ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled\"\n    },\n    {\n      \"Check ID\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled\",\n      \"State\": \"fail\",\n      \"Rule ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled\"\n    },\n    {\n      \"Check ID\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition\",\n      \"State\": \"pass\",\n      \"Rule ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition\"\n    },\n    {\n      \"Check ID\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition\",\n      \"State\": \"pass\",\n      \"Rule ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition\"\n    },\n    {\n      \"Check ID\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition\",\n      \"State\": \"pass\",\n      \"Rule ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition\"\n    },\n    {\n      \"Check ID\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition\",\n      \"State\": \"pass\",\n      \"Rule ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition\"\n    },\n    {\n      \"Check ID\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition\",\n      \"State\": \"fail\",\n      \"Rule ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition\"\n    },\n    {\n      \"Check ID\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions\",\n      \"State\": \"notchecked\",\n      \"Rule ID\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions\"\n    }\n  ],\n  \"Count\": \"1\"\n}\n</code></pre> <ul> <li>Fetch sample trestle tanium-result-to-oscal-ar config file. It informs the trestle command where to read input and write output.</li> </ul> <pre><code>(venv.trestle)$ curl 'https://raw.githubusercontent.com/oscal-compass/compliance-trestle/develop/tests/data/tasks/tanium/demo-tanium-result-to-oscal-ar.config' &gt; tanium/demo-tanium-result-to-oscal-ar.config\n</code></pre> sample: demo-tanium-result-to-oscal-ar.config <pre><code>[task.tanium-result-to-oscal-ar]\n\ninput-dir =  tests/data/tasks/tanium/input\noutput-dir = tests/data/tasks/tanium/runtime\n</code></pre> <ul> <li>Perform the transform.</li> </ul> <pre><code>(venv.trestle)$ cd tanium\n(venv.trestle)$ trestle task tanium-result-to-oscal-ar -c demo-tanium-result-to-oscal-ar.config \ninput: tests/data/tasks/tanium/input/Tanium.doc-json\noutput: tests/data/tasks/tanium/runtime/Tanium.oscal.json\ninventory: 1\nobservations: 9\nTask: tanium-result-to-oscal-ar executed successfully.\n</code></pre> <ul> <li>View the generated OSCAL.</li> </ul> <pre><code>(venv.trestle)$ cat tests/data/tasks/tanium/runtime/Tanium.oscal.json\n</code></pre> sample:  Tanium.oscal.json <pre><code>{\n  \"results\": [\n    {\n      \"uuid\": \"f79add8e-488a-45f3-9024-72ecf95c7952\",\n      \"title\": \"Tanium\",\n      \"description\": \"Tanium\",\n      \"start\": \"2021-05-12T13:46:46.000+00:00\",\n      \"end\": \"2021-05-12T13:46:46.000+00:00\",\n      \"local-definitions\": {\n        \"components\": {\n          \"1ea447fe-a2af-4110-baae-c70ed5223261\": {\n            \"type\": \"Operating System\",\n            \"title\": \"Red Hat Enterprise Linux 8\",\n            \"description\": \"Red Hat Enterprise Linux 8\",\n            \"status\": {\n              \"state\": \"operational\"\n            }\n          }\n        },\n        \"inventory-items\": [\n          {\n            \"uuid\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n            \"description\": \"inventory\",\n            \"props\": [\n              {\n                \"name\": \"Computer Name\",\n                \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n                \"value\": \"RHEL8\"\n              },\n              {\n                \"name\": \"Tanium Client IP Address\",\n                \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n                \"value\": \"192.168.0.125\",\n                \"class\": \"scc_inventory_item_id\"\n              },\n              {\n                \"name\": \"IP Address\",\n                \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n                \"value\": \"['192.168.0.125', '192.168.122.1', 'fe80::3c47:1aff:fe33:601']\"\n              },\n              {\n                \"name\": \"Count\",\n                \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n                \"value\": \"1\"\n              }\n            ],\n            \"implemented-components\": [\n              {\n                \"component-uuid\": \"1ea447fe-a2af-4110-baae-c70ed5223261\"\n              }\n            ]\n          }\n        ]\n      },\n      \"reviewed-controls\": {\n        \"control-selections\": [\n          {}\n        ]\n      },\n      \"observations\": [\n        {\n          \"uuid\": \"e67f5fd9-5b1f-4134-a67e-cebdc2e5735c\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\",\n          \"props\": [\n            {\n              \"name\": \"Check ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\"\n            },\n            {\n              \"name\": \"Check ID Benchmark\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n              \"class\": \"scc_predefined_profile\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_check_version\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_predefined_profile_version\"\n            },\n            {\n              \"name\": \"Check ID Level\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"Level 1 - Server\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\",\n              \"class\": \"scc_goal_description\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled\",\n              \"class\": \"scc_check_name_id\"\n            },\n            {\n              \"name\": \"State\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"fail\",\n              \"class\": \"scc_result\"\n            },\n            {\n              \"name\": \"Timestamp\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"2021-05-12T13:46:46+00:00\",\n              \"class\": \"scc_timestamp\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-05-12T13:46:46.000+00:00\"\n        },\n        {\n          \"uuid\": \"6cb81459-9c25-4a8b-bf3c-d8ff08ee728c\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled\",\n          \"props\": [\n            {\n              \"name\": \"Check ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled\"\n            },\n            {\n              \"name\": \"Check ID Benchmark\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n              \"class\": \"scc_predefined_profile\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_check_version\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_predefined_profile_version\"\n            },\n            {\n              \"name\": \"Check ID Level\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"Level 1 - Server\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled\",\n              \"class\": \"scc_goal_description\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled\",\n              \"class\": \"scc_check_name_id\"\n            },\n            {\n              \"name\": \"State\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"fail\",\n              \"class\": \"scc_result\"\n            },\n            {\n              \"name\": \"Timestamp\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"2021-05-12T13:46:46+00:00\",\n              \"class\": \"scc_timestamp\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-05-12T13:46:46.000+00:00\"\n        },\n        {\n          \"uuid\": \"9453eaed-db41-4a20-b684-2887de2d9657\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled\",\n          \"props\": [\n            {\n              \"name\": \"Check ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled\"\n            },\n            {\n              \"name\": \"Check ID Benchmark\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n              \"class\": \"scc_predefined_profile\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_check_version\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_predefined_profile_version\"\n            },\n            {\n              \"name\": \"Check ID Level\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"Level 1 - Server\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled\",\n              \"class\": \"scc_goal_description\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled\",\n              \"class\": \"scc_check_name_id\"\n            },\n            {\n              \"name\": \"State\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"fail\",\n              \"class\": \"scc_result\"\n            },\n            {\n              \"name\": \"Timestamp\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"2021-05-12T13:46:46+00:00\",\n              \"class\": \"scc_timestamp\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-05-12T13:46:46.000+00:00\"\n        },\n        {\n          \"uuid\": \"a37c2569-8695-4cfe-8b5c-bd8d6eaf9df7\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition\",\n          \"props\": [\n            {\n              \"name\": \"Check ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition\"\n            },\n            {\n              \"name\": \"Check ID Benchmark\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n              \"class\": \"scc_predefined_profile\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_check_version\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_predefined_profile_version\"\n            },\n            {\n              \"name\": \"Check ID Level\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"Level 1 - Server\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition\",\n              \"class\": \"scc_goal_description\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition\",\n              \"class\": \"scc_check_name_id\"\n            },\n            {\n              \"name\": \"State\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"pass\",\n              \"class\": \"scc_result\"\n            },\n            {\n              \"name\": \"Timestamp\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"2021-05-12T13:46:46+00:00\",\n              \"class\": \"scc_timestamp\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-05-12T13:46:46.000+00:00\"\n        },\n        {\n          \"uuid\": \"b77e1b49-a818-4d43-adaf-69effcbd9219\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition\",\n          \"props\": [\n            {\n              \"name\": \"Check ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition\"\n            },\n            {\n              \"name\": \"Check ID Benchmark\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n              \"class\": \"scc_predefined_profile\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_check_version\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_predefined_profile_version\"\n            },\n            {\n              \"name\": \"Check ID Level\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"Level 1 - Server\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition\",\n              \"class\": \"scc_goal_description\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition\",\n              \"class\": \"scc_check_name_id\"\n            },\n            {\n              \"name\": \"State\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"pass\",\n              \"class\": \"scc_result\"\n            },\n            {\n              \"name\": \"Timestamp\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"2021-05-12T13:46:46+00:00\",\n              \"class\": \"scc_timestamp\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-05-12T13:46:46.000+00:00\"\n        },\n        {\n          \"uuid\": \"ac25b329-7a4a-45f4-b42b-1cce470e237b\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition\",\n          \"props\": [\n            {\n              \"name\": \"Check ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition\"\n            },\n            {\n              \"name\": \"Check ID Benchmark\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n              \"class\": \"scc_predefined_profile\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_check_version\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_predefined_profile_version\"\n            },\n            {\n              \"name\": \"Check ID Level\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"Level 1 - Server\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition\",\n              \"class\": \"scc_goal_description\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition\",\n              \"class\": \"scc_check_name_id\"\n            },\n            {\n              \"name\": \"State\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"pass\",\n              \"class\": \"scc_result\"\n            },\n            {\n              \"name\": \"Timestamp\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"2021-05-12T13:46:46+00:00\",\n              \"class\": \"scc_timestamp\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-05-12T13:46:46.000+00:00\"\n        },\n        {\n          \"uuid\": \"f9c0f033-f08b-431d-b411-fe1f63c2c98c\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition\",\n          \"props\": [\n            {\n              \"name\": \"Check ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition\"\n            },\n            {\n              \"name\": \"Check ID Benchmark\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n              \"class\": \"scc_predefined_profile\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_check_version\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_predefined_profile_version\"\n            },\n            {\n              \"name\": \"Check ID Level\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"Level 1 - Server\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition\",\n              \"class\": \"scc_goal_description\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition\",\n              \"class\": \"scc_check_name_id\"\n            },\n            {\n              \"name\": \"State\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"pass\",\n              \"class\": \"scc_result\"\n            },\n            {\n              \"name\": \"Timestamp\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"2021-05-12T13:46:46+00:00\",\n              \"class\": \"scc_timestamp\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-05-12T13:46:46.000+00:00\"\n        },\n        {\n          \"uuid\": \"149a814e-7f80-4e6d-a613-54f027e0d663\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition\",\n          \"props\": [\n            {\n              \"name\": \"Check ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition\"\n            },\n            {\n              \"name\": \"Check ID Benchmark\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n              \"class\": \"scc_predefined_profile\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_check_version\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_predefined_profile_version\"\n            },\n            {\n              \"name\": \"Check ID Level\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"Level 1 - Server\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition\",\n              \"class\": \"scc_goal_description\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition\",\n              \"class\": \"scc_check_name_id\"\n            },\n            {\n              \"name\": \"State\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"fail\",\n              \"class\": \"scc_result\"\n            },\n            {\n              \"name\": \"Timestamp\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"2021-05-12T13:46:46+00:00\",\n              \"class\": \"scc_timestamp\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-05-12T13:46:46.000+00:00\"\n        },\n        {\n          \"uuid\": \"a0e602b5-e587-41c5-846b-675b26cf3e18\",\n          \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions\",\n          \"props\": [\n            {\n              \"name\": \"Check ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions\"\n            },\n            {\n              \"name\": \"Check ID Benchmark\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"CIS Red Hat Enterprise Linux 8 Benchmark\",\n              \"class\": \"scc_predefined_profile\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_check_version\"\n            },\n            {\n              \"name\": \"Check ID Version\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"1.0.0-1\",\n              \"class\": \"scc_predefined_profile_version\"\n            },\n            {\n              \"name\": \"Check ID Level\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"Level 1 - Server\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions\",\n              \"class\": \"scc_goal_description\"\n            },\n            {\n              \"name\": \"Rule ID\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions\",\n              \"class\": \"scc_check_name_id\"\n            },\n            {\n              \"name\": \"State\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"notchecked\",\n              \"class\": \"scc_result\"\n            },\n            {\n              \"name\": \"Timestamp\",\n              \"ns\": \"https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium\",\n              \"value\": \"2021-05-12T13:46:46+00:00\",\n              \"class\": \"scc_timestamp\"\n            }\n          ],\n          \"methods\": [\n            \"TEST-AUTOMATED\"\n          ],\n          \"subjects\": [\n            {\n              \"uuid-ref\": \"2d33d2b0-af5c-4c37-85b1-e4f414183de2\",\n              \"type\": \"inventory-item\"\n            }\n          ],\n          \"collected\": \"2021-05-12T13:46:46.000+00:00\"\n        }\n      ],\n      \"findings\": [\n        {\n          \"uuid\": \"00000000-0000-4000-8000-000000000000\",\n          \"title\": \"No Finding.\",\n          \"description\": \"No Finding.\"\n        }\n      ]\n    }\n  ]\n}\n</code></pre> <p> Congratulations! You have bridged Tanium data into an OSCAL Assessment Results using compliance-trestle. </p> <p> </p> <p>Newtown, Victoria</p> <p></p>"},{"location":"tutorials/Transformers_and_Tasks/csv_to_oscal_cd/","title":"Tutorial: Setup for and use of standard format csv-file to OSCAL Component Definition json-file transformer","text":"<p>Here are step by step instructions for setup and transformation of trestle standard format csv-file into OSCAL Component Definition json-file using the compliance-trestle tool.</p>"},{"location":"tutorials/Transformers_and_Tasks/csv_to_oscal_cd/#objective","title":"Objective","text":"<p>How to transform trestle standard format csv-file into a <code>component-definition.json</code> file.</p> <p>There are 2 short steps shown below. The first is a one-time check/set-up of your environment. The second is a one-command transformation from <code>.csv</code> to <code>component-definition.json</code>.</p> Table: expected .csv content <p>The below table represents the expectations of trestle task <code>csv-to-oscal-cd</code> for the contents of the input csv-file for synthesis of the output OSCAL Component Definition json-file.</p> <p><code>Column Name</code> is the name of the expected column in the input csv-file. Any additional columns not identified here, for example foobar, are also extracted and placed into the output json-file as component.control-implementation.prop[\"foobar\"].</p> <p><code>Component Definition Locale</code> is the <code>path</code> within the output json-file into witch the value is stashed.</p> Column Name Value Type Specification Value Description Component Definition Locale Example Value   Rule_Id String required A textual label that uniquely identifies a policy (desired state) that can be used to reference it elsewhere in this or other documents. component.control-implementation.prop[\"Rule_Id\"] password_policy_min_length_characters   Rule_Description String required A description of the policy (desired state) including information about its purpose and scope. component.control-implementation.prop[\"Rule_Description\"] Ensure password policy requires minimum length of 12 characters   Profile_Reference_URL String required A URL reference to the source catalog or profile for which this component is implementing controls for. A profile designates a selection and configuration of controls from one or more catalogs component.control-implementation.source https://github.com/usnistgov/oscal-content/blob/main/nist.gov/SP800-53/rev5/json/NIST_SP-800-53_rev5_HIGH-baseline_profile.json   Profile_Description String required A description of the profile. component.control-implementation.description NIST Special Publication 800-53 Revision 5 HIGH IMPACT BASELINE   Component_Type String required A category describing the purpose of the component. component.type Validation   Control_Mappings String List (blank separated) required A list of textual labels that uniquely identify the controls or statements that the component implements. component.control-implementation.implemented-requirement.statement.statement-id*and*component.control-implementation.implemented-requirement.control-id ia-5.1_smt.a ia-5.1   Resource String required A human readable name for the component. component.title Compliance Center   Parameter_Id String optional A textual label that uniquely identifies the parameter associated with that policy (desired state) or controls implemented by the policy (desired state).   A description of the parameter including the purpose and use of the parameter. component.control-implementation.prop[\"Parameter_Id\"]*and*component.control-implementation.set-parameter.param-id minimum_password_length   Parameter_Description String optional A description of the parameter including the purpose and use of the parameter. component.control-implementation.prop[\"Parameter_Description\"] Minimum Password   Parameter_Default_Value String optional A value recommended in this profile for the parameter of the control or policy (desired state). component.control-implementation.set-parameter.values 12   Parameter_Value_Alternatives String List (blank separated) optional ONLY for the policy (desired state) parameters: A value or set of values the parameter can take. component.control-implementation.prop[\"Parameter_Value_Alternatives\"] 12 8   Check_Id String optional A textual label that uniquely identifies a check of the policy (desired state) that can be used to reference it elsewhere in this or other documents. component.control-implementation.prop[\"Check_Id\"] check_password_policy_min_length_characters   Check_Description String optional A description of the check of the policy (desired state) including the method (interview or examine or test) and procedure details. component.control-implementation.prop[\"Check_Description\"] Check whether password policy requires minimum length of 12 characters   Fetcher String optional A textual label that uniquely identifies a collector of the actual state (evidence) associated with the policy (desired state) that can be used to reference it elsewhere in this or other documents. component.control-implementation.prop[\"Fetcher\"] fetch_password_policy_min_length_characters   Fetcher_Description String optional A description of the collector of the actual state (evidence) associated with the policy (desired state) including the method (interview or examine or API) and questionaire component.control-implementation.prop[\"Fetcher_Description\"] Fetch whether password policy requires minimum length of 12 characters   Resource_Instance_Type String optional A textual label that uniquely identifies a resource (component) type from the resource instance id. This text is part of all instance ids of a particular resource at runtime. For example the text 'db2' is part of all instance ids of resource DB2. component.control-implementation.prop[\"Resource_Instance_Type\"] DB2"},{"location":"tutorials/Transformers_and_Tasks/csv_to_oscal_cd/#step-1-install-trestle-in-a-python-virtual-environment","title":"Step 1: Install trestle in a Python virtual environment","text":"<p>Follow the instructions here to install trestle in a virtual environment.</p>"},{"location":"tutorials/Transformers_and_Tasks/csv_to_oscal_cd/#step-2-transform-profile-data-cis-benchmarks","title":"Step 2: Transform profile data (CIS benchmarks)","text":"<p>Linux, Mac</p> Windows <p>Make these changes:</p> <ul> <li>use backslashes `\\` for file paths <li>use `md` instead of mkdir -p <li>put the url in double quotes for `curl` <li>use `more` instead of cat </li> </li> </li> </li> </ul> <ul> <li>Navigate to trestle workspace.</li> </ul> <pre><code>(venv.trestle)$ cd trestle.workspace\n</code></pre> <ul> <li>View configuration information.</li> </ul> <pre><code>(venv.trestle)$ trestle task csv-to-oscal-cd -i\ntrestle.core.commands.task:101 WARNING: Config file was not configured with the appropriate section for the task: \"[task.csv-to-oscal-cd]\"\nHelp information for csv-to-oscal-cd task.\n\nHelp information for csv-to-oscal-cd task.\n\nPurpose: From csv produce OSCAL component_definition file.\n\n\nConfiguration flags sit under [task.csv-to-oscal-cd]:\n  title                = (required) the component definition title.\n  version              = (required) the component definition version.\n  csv-file             = (required) the path of the csv file. [1st row are column headings; 2nd row are column descriptions; 3rd row and beyond is data]\n  required columns:      $$Component_Title\n                         $$Component_Description\n                         $$Component_Type\n                         $$Rule_Id\n                         $$Rule_Description (see note 1)\n                         $$Profile_Source (see note 1)\n                         $$Profile_Description (see note 1)\n                         $$Control_Id_List (see note 1)\n                         $$Namespace\n  optional columns:      $Check_Id (see note 2)\n                         $Check_Description (see note 2)\n                         $Target_Component (see note 3)\n                         $Original_Risk_Rating (see note 1)\n                         $Adjusted_Risk_Rating (see note 1)\n                         $Risk_Adjustment (see note 1)\n                         $Parameter_Id (see notes 1, 5)\n                         $Parameter_Description (see notes 1, 5)\n                         $Parameter_Value_Alternatives (see notes 1, 5)\n  comment columns:       #Informational (see note 4)\n  output-dir           = (required) the path of the output directory for synthesized OSCAL .json files.\n  component-definition = (optional) the path of the existing component-definition OSCAL .json file.\n  class.column-name    = (optional) the class to associate with the specified column name, e.g. class.Rule_Id = scc_class\n  output-overwrite     = (optional) true [default] or false; replace existing output when true.\n  validate-controls    = (optional) on, warn, or off [default]; validate controls exist in resolved profile.\n\nNotes: [1] column is ignored for validation component type\n       [2] column is required for validation component type\n       [3] column is optional for validation component type, but may be needed to prevent Rule_Id collisions\n       [4] column name starting with # causes column to be ignored\n       [5] additional parameters are specified by adding a common suffix per set, for example: Parameter_Id_1, Parameter_Description_1, ...Parameter_Id_2...\n</code></pre> <ul> <li>Create data folder.</li> </ul> <pre><code>(venv.trestle)$ mkdir -p adjunct-data\n</code></pre> <ul> <li>Fetch sample csv-file.</li> </ul> <pre><code>(venv.trestle)$ curl 'https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ocp4-sample-input.csv' &gt; adjunct-data/ocp4-sample-input.csv\n</code></pre> <ul> <li>Fetch trestle task file.</li> </ul> <pre><code>(venv.trestle)$ curl 'https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/demo-csv-to-oscal-cd.config' &gt; adjunct-data/task-files/demo-csv-to-oscal-cd.config\n</code></pre> demo-csv-to-oscal-cd.config <pre><code>[task.csv-to-oscal-cd]\n\ncsv-file = adjunct-data/ocp4-sample-input.csv\noutput-dir = component-definitions/ocp4-sample\ntitle = ocp4-sample\nversion = 1.0\n</code></pre> <ul> <li>Perform and validate the transform.</li> </ul> <pre><code>(venv.trestle)$ trestle task csv-to-oscal-cd -c demo-csv-to-oscal-cd.config \ninput: adjunct-data/ocp4-sample-input.csv\noutput: component-definitions/ocp4-sample/component-definition.json\nTask: csv-to-oscal-cd executed successfully.\n</code></pre> <ul> <li>View the generated OSCAL.</li> </ul> <pre><code>(venv.trestle)$ component-definitions/ocp4-sample/component-definition.json\n</code></pre> component-definition.json <pre><code>{\n  \"component-definition\": {\n    \"uuid\": \"83cc8984-b00a-4799-885c-60b689efebd0\",\n    \"metadata\": {\n      \"title\": \"ocp4-sample\",\n      \"last-modified\": \"2022-11-18T17:06:49+00:00\",\n      \"version\": \"1.0\",\n      \"oscal-version\": \"1.0.2\"\n    },\n    \"components\": [\n      {\n        \"uuid\": \"c0080494-186a-421d-9afd-f51e0359cbd8\",\n        \"type\": \"Service\",\n        \"title\": \"OSCO\",\n        \"description\": \"\",\n        \"control-implementations\": [\n          {\n            \"uuid\": \"43a69f86-a3ad-40fa-ada6-2f988b951728\",\n            \"source\": \"https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile\",\n            \"description\": \"ocp4\",\n            \"props\": [\n              {\n                \"name\": \"Rule_Id\",\n                \"value\": \"content_rule_api_server_anonymous_auth\",\n                \"remarks\": \"rule_set_0\"\n              },\n              {\n                \"name\": \"Rule_Description\",\n                \"value\": \"Ensure that the --anonymous-auth argument is set to false\",\n                \"remarks\": \"rule_set_0\"\n              },\n              {\n                \"name\": \"Check_Id\",\n                \"value\": \"xccdf_org.ssgproject.content_rule_api_server_anonymous_auth\",\n                \"remarks\": \"rule_set_0\"\n              },\n              {\n                \"name\": \"Check_Description\",\n                \"value\": \"Ensure that the --anonymous-auth argument is set to false\",\n                \"remarks\": \"rule_set_0\"\n              },\n              {\n                \"name\": \"Rule_Id\",\n                \"value\": \"content_rule_api_server_basic_auth\",\n                \"remarks\": \"rule_set_1\"\n              },\n              {\n                \"name\": \"Rule_Description\",\n                \"value\": \"Ensure that the --basic-auth-file argument is not set\",\n                \"remarks\": \"rule_set_1\"\n              },\n              {\n                \"name\": \"Check_Id\",\n                \"value\": \"xccdf_org.ssgproject.content_rule_api_server_basic_auth\",\n                \"remarks\": \"rule_set_1\"\n              },\n              {\n                \"name\": \"Check_Description\",\n                \"value\": \"Ensure that the --basic-auth-file argument is not set\",\n                \"remarks\": \"rule_set_1\"\n              },\n              {\n                \"name\": \"Rule_Id\",\n                \"value\": \"content_rule_api_server_token_auth\",\n                \"remarks\": \"rule_set_2\"\n              },\n              {\n                \"name\": \"Rule_Description\",\n                \"value\": \"Ensure that the --token-auth-file parameter is not set\",\n                \"remarks\": \"rule_set_2\"\n              },\n              {\n                \"name\": \"Check_Id\",\n                \"value\": \"xccdf_org.ssgproject.content_rule_api_server_token_auth\",\n                \"remarks\": \"rule_set_2\"\n              },\n              {\n                \"name\": \"Check_Description\",\n                \"value\": \"Ensure that the --token-auth-file parameter is not set\",\n                \"remarks\": \"rule_set_2\"\n              },\n              {\n                \"name\": \"Rule_Id\",\n                \"value\": \"content_rule_api_server_https_for_kubelet_conn\",\n                \"remarks\": \"rule_set_3\"\n              },\n              {\n                \"name\": \"Rule_Description\",\n                \"value\": \"Ensure that the --kubelet-https argument is set to true\",\n                \"remarks\": \"rule_set_3\"\n              },\n              {\n                \"name\": \"Check_Id\",\n                \"value\": \"xccdf_org.ssgproject.content_rule_api_server_https_for_kubelet_conn\",\n                \"remarks\": \"rule_set_3\"\n              },\n              {\n                \"name\": \"Check_Description\",\n                \"value\": \"Ensure that the --kubelet-https argument is set to true\",\n                \"remarks\": \"rule_set_3\"\n              }\n            ],\n            \"implemented-requirements\": [\n              {\n                \"uuid\": \"c2893d38-1be4-4b0e-a090-96e846e15a3b\",\n                \"control-id\": \"CIS-1.2.1\",\n                \"description\": \"\",\n                \"props\": [\n                  {\n                    \"name\": \"Rule_Id\",\n                    \"value\": \"content_rule_api_server_anonymous_auth\"\n                  }\n                ]\n              },\n              {\n                \"uuid\": \"3c2f7129-9724-47c0-aadb-3b3c9c44995c\",\n                \"control-id\": \"CIS-1.2.2\",\n                \"description\": \"\",\n                \"props\": [\n                  {\n                    \"name\": \"Rule_Id\",\n                    \"value\": \"content_rule_api_server_basic_auth\"\n                  }\n                ]\n              },\n              {\n                \"uuid\": \"a4e2862f-7a1b-4182-b827-f5e797f589db\",\n                \"control-id\": \"CIS-1.2.3\",\n                \"description\": \"\",\n                \"props\": [\n                  {\n                    \"name\": \"Rule_Id\",\n                    \"value\": \"content_rule_api_server_token_auth\"\n                  }\n                ]\n              },\n              {\n                \"uuid\": \"daec13ab-829e-4dd6-a9d6-9ad18391681e\",\n                \"control-id\": \"CIS-1.2.4\",\n                \"description\": \"\",\n                \"props\": [\n                  {\n                    \"name\": \"Rule_Id\",\n                    \"value\": \"content_rule_api_server_https_for_kubelet_conn\"\n                  }\n                ]\n              }\n            ]\n          }\n        ]\n      }\n    ]\n  }\n}\n</code></pre> <p> </p> <p> Congratulations! You have completed this tutorial. </p> <p> </p>"},{"location":"tutorials/Transformers_and_Tasks/csv_to_oscal_cd/#examples-csv-files-suitable-for-csv-to-oscsl-cd-transformation","title":"Examples: csv files suitable for csv-to-oscsl-cd transformation","text":"<p>The examples given here comprise csv files that can be transformed into OSCAL Component Definitions. The csv files comprise required headings and values expected by the trestle task transformer, and may present optional ones as well.</p> <ol> <li>OCP4 sample input</li> </ol> <p>This is a simple example csv that has just one rule per control and one check per rule: ocp4-sample-input.csv</p> <ol> <li>Multiple occurrence sample input</li> </ol> <p>This is a simple example csv that has multiple checks per rule and multiple target-components per rule: rule-name-overlap.csv</p>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/","title":"Tutorial: How to build an Oscal Assessment Results \"lite\" with Trestle SDK from your posture result format","text":"<p>The compliance-trestle (trestle) project provides helpful modules to assist your standardization efforts. Discussed below are some best practices for automated bridging to NIST OSCAL.</p>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#why-nist-oscal","title":"Why NIST OSCAL?","text":"<p>The Open Security Controls Assessment Language OSCAL is a set of formats expressed in XML, JSON, and YAML that provide machine-readable representations of control catalogs, control baselines, system security plans, and assessment plans and results as adopted by the National Institute of Standards and Technology NIST.</p> <p>Standardizing to OSCAL facilitates data interchange and understandability.</p>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#objective","title":"Objective","text":"<p>The objective here is to transform your compliance data into valid OSCAL, in particular System Assessment Results SAR.</p> <p>Examples of existing transformers  included with trestle are for the OpenShift Compliance Operator OSCO and Tanium.</p>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#overview","title":"Overview","text":"<p>You have a source of compliance data that is in non-OSCAL format (spreadsheet, XML, JSON, database, object-store...) and you would like to transform into standardized form in terms of NIST OSCAL. Presumed is an existing method for obtaining the compliance data from the cloud and materializing on disk as one or more files.</p> <p></p> <ul> <li>Source files on disk (pink) is our starting point.</li> <li>OSCAL files on disk (blue) is our ending point.</li> <li>OSCAL object management and emitter Python code are provided by trestle (green).</li> <li>Transformation Python code (yellow) is to be written by you.</li> </ul> <p>Other possible code stack configurations (not shown):</p> <ul> <li>write your own command module (file interface), but use trestle logic module (data processing)</li> <li>write your own command and logic modules, but rely on trestle OSCAL support and base</li> </ul> <p>For example, one could create an auditree-arboretum harvest report (file interface) that employs the trestle xccdf-result-to-oscal-ar transformation (data processing) module.</p>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#choose-mapping-strategy","title":"Choose Mapping Strategy","text":"<p>There are 3 potential levels of OSCAL Assessment Results that can be emitted by your transformer. From most complex to least complex they are:</p> <ul> <li>a complete SAR</li> <li>a partial SAR comprising Findings with Observations</li> <li>a partial SAR comprising Observations only</li> </ul> <p>Below is a snippet from the SAR model with these three levels shown.</p> <p></p> <p>Although producing a complete SAR is possible, this transformation is not covered here. We focus on partial results, either Observations only or Observations with Findings.</p> <p>Based on the data in hand from your compliance data source, and additional metadata that can be made available at the time of transformation, choose the best fit.</p>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#observations-only","title":"Observations only","text":"<p>Emitting Observations only requires just rudimentary source data. For example, if each instance of source data includes not much more than:</p> <ul> <li>inventory-name: ssg-ocp4-ds-cis-111.222.333.444-pod</li> <li>rule-name: xccdf_org.ssgproject.content_rule_scheduler_profiling_argument</li> <li>rule-result: fail</li> </ul> <p>then the best mapping would be to an Observations only.</p> example snippet: instance suitable for mapping to Observation <pre><code>data: &lt;rule-result idref=\"xccdf_org.ssgproject.content_rule_scheduler_profiling_argument\"\n  time=\"2020-08-03T02:26:26+00:00\" severity=\"low\" weight=\"1.000000\"&gt; &lt;result&gt;fail&lt;/result&gt;\n  &lt;/rule-result&gt;\nmetadata:\n  name: ssg-ocp4-ds-cis-111.222.333.444-pod\n</code></pre> example snippet: instance OSCAL Observation <pre><code>{\n  \"uuid\": \"56666738-0f9a-4e38-9aac-c0fad00a5821\",\n  \"title\": \"xccdf_org.ssgproject.content_rule_scheduler_profiling_argument\",\n  \"description\": \"xccdf_org.ssgproject.content_rule_scheduler_profiling_argument\",\n  \"methods\": [\n    \"TEST-AUTOMATED\"\n  ],\n  \"subjects\": [\n    {\n      \"uuid-ref\": \"56666738-0f9a-4e38-9aac-c0fad00a5821\",\n      \"type\": \"component\",\n      \"title\": \"Red Hat OpenShift Kubernetes\"\n    },\n    {\n      \"uuid-ref\": \"46aADFAC-A1fd-4Cf0-a6aA-d1AfAb3e0d3e\",\n      \"type\": \"inventory-item\",\n      \"title\": \"Pod\",\n      \"props\": [\n        {\n          \"name\": \"target\",\n          \"value\": \"kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp\"\n        },\n        {\n          \"name\": \"cluster-name\",\n          \"value\": \"ROKS-OpenSCAP-1\"\n        },\n        {\n          \"name\": \"cluster-type\",\n          \"value\": \"openshift\"\n        },\n        {\n          \"name\": \"cluster-region\",\n          \"value\": \"us-south\"\n        }\n      ]\n    }\n  ],\n  \"relevant-evidence\": [\n    {\n      \"href\": \"https://github.mycorp.com/degenaro/evidence-locker\",\n      \"description\": \"Evidence location.\",\n      \"props\": [\n        {\n          \"name\": \"rule\",\n          \"ns\": \"dns://xccdf\",\n          \"class\": \"id\",\n          \"value\": \"xccdf_org.ssgproject.content_rule_scheduler_profiling_argument\"\n        },\n        {\n          \"name\": \"time\",\n          \"ns\": \"dns://xccdf\",\n          \"class\": \"timestamp\",\n          \"value\": \"2020-08-03T02:26:26+00:00\"\n        },\n        {\n          \"name\": \"result\",\n          \"ns\": \"dns://xccdf\",\n          \"class\": \"result\",\n          \"value\": \"fail\"\n        },\n        {\n          \"name\": \"target\",\n          \"ns\": \"dns://xccdf\",\n          \"class\": \"target\",\n          \"value\": \"kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp\"\n        }\n      ]\n    }\n  ]\n}\n</code></pre>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#findings-with-observations","title":"Findings with Observations","text":"<p>To additionally produce Findings, information about the controls associated with each rule-name is required. The control information can be part of the source data itself or can be provided as one or more supplemental metadata files.</p> <p>If each instance of source data includes:</p> <ul> <li>inventory-name: cmp-wn-2115.demo.tanium.local</li> <li>rule-name: xccdf_org.cisecurity.benchmarks_rule_19.7.44.2.1_L2_Ensure_Prevent_Codec_Download_is_set_to_Enabled</li> <li>rule-result: fail</li> <li>control-name: 800-53: SC-18</li> </ul> <p>then the best mapping wound be to Findings with Observations.</p> example snippet: xml instance suitable for mapping to Finding with Observation <pre><code>{\n  \"IP Address\": \"10.8.68.218\",\n  \"Computer Name\": \"cmp-wn-2115.demo.tanium.local\",\n  \"Comply - JovalCM Results[c2dc8749]\": [\n    {\n      \"Benchmark\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\",\n      \"Benchmark Version\": \"1.5.0.1\",\n      \"Profile\": \"Windows 10 - NIST 800-53\",\n      \"ID\": \"xccdf_org.cisecurity.benchmarks_rule_19.7.44.2.1_L2_Ensure_Prevent_Codec_Download_is_set_to_Enabled\",\n      \"Result\": \"fail\",\n      \"Custom ID\": \"800-53: SC-18\",\n      \"Version\": \"version: 1\"\n    }\n  ],\n  \"Count\": \"1\",\n  \"Age\": \"600\"\n}\n</code></pre> example snippet: instance OSCAL Finding <pre><code>{\n  \"findings\": [\n    {\n      \"uuid\": \"99c0a0de-e34e-4e22-95a1-1d4f24826565\",\n      \"title\": \"800-53: IA-5\",\n      \"description\": \"800-53: IA-5\",\n      \"collected\": \"2021-03-16T13:29:14.000+00:00\",\n      \"objective-status\": {\n        \"props\": [\n          {\n            \"name\": \"profile\",\n            \"ns\": \"dns://tanium\",\n            \"class\": \"source\",\n            \"value\": \"NIST 800-53\"\n          },\n          {\n            \"name\": \"id-ref\",\n            \"ns\": \"dns://tanium\",\n            \"class\": \"source\",\n            \"value\": \"IA-5\"\n          },\n          {\n            \"name\": \"result\",\n            \"ns\": \"dns://xccdf\",\n            \"class\": \"STRVALUE\",\n            \"value\": \"FAIL\"\n          }\n        ],\n        \"status\": \"not-satisfied\"\n      },\n      \"related-observations\": [\n        {\n          \"observation-uuid\": \"61092735-e365-4638-bc2c-ecd0ed407e73\"\n        },\n        {\n          \"observation-uuid\": \"95a20b8e-ed0a-4b6c-bf87-8789265c7158\"\n        }\n      ]\n    }\n  ]\n}\n</code></pre> example snippet: instance OSCAL Observation <pre><code>{\n  \"observations\": [\n    {\n      \"uuid\": \"61092735-e365-4638-bc2c-ecd0ed407e73\",\n      \"description\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords\",\n      \"props\": [\n        {\n          \"name\": \"benchmark\",\n          \"ns\": \"dns://tanium\",\n          \"class\": \"source\",\n          \"value\": \"CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark\"\n        },\n        {\n          \"name\": \"rule\",\n          \"ns\": \"dns://xccdf\",\n          \"class\": \"id\",\n          \"value\": \"xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords\"\n        },\n        {\n          \"name\": \"result\",\n          \"ns\": \"dns://xccdf\",\n          \"class\": \"result\",\n          \"value\": \"pass\"\n        },\n        {\n          \"name\": \"time\",\n          \"ns\": \"dns://xccdf\",\n          \"class\": \"timestamp\",\n          \"value\": \"2021-03-16T13:29:14+00:00\"\n        }\n      ],\n      \"methods\": [\n        \"TEST-AUTOMATED\"\n      ],\n      \"subjects\": [\n        {\n          \"uuid-ref\": \"2650b9ba-e767-4381-9a3f-127d1552d7d2\",\n          \"type\": \"inventory-item\"\n        }\n      ]\n    }\n  ]\n}\n</code></pre> example snippet: local definitions <pre><code>{\n  \"results\": [\n    {\n      \"uuid\": \"98028241-8705-4211-bf36-71e1f7aa6192\",\n      \"title\": \"Tanium\",\n      \"description\": \"Tanium\",\n      \"start\": \"2021-03-16T13:29:14.000+00:00\",\n      \"local-definitions\": {\n        \"inventory-items\": [\n          {\n            \"uuid\": \"2650b9ba-e767-4381-9a3f-127d1552d7d2\",\n            \"description\": \"inventory\",\n            \"props\": [\n              {\n                \"name\": \"computer-name\",\n                \"ns\": \"dns://tanium\",\n                \"class\": \" inventory-item\",\n                \"value\": \"cmp-wn-2106.demo.tanium.local\"\n              },\n              {\n                \"name\": \"computer-ip\",\n                \"ns\": \"dns://tanium\",\n                \"class\": \" inventory-item\",\n                \"value\": \"fe80::3cd5:564b:940e:49ab\"\n              },\n              {\n                \"name\": \"profile\",\n                \"ns\": \"dns://tanium\",\n                \"class\": \" inventory-item\",\n                \"value\": \"Windows 10\"\n              }\n            ]\n          }\n        ]\n      }\n    }\n  ]\n}\n</code></pre>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#implement-mapping-strategy","title":"Implement Mapping Strategy","text":"<p>The best practice for building a transformer is to employ layers. Recall that the top two layers (in yellow) are for you to implement, while the bottom two layers (in green) are provided by trestle to assist you.</p> <p>Trestle is a Python based multi-faceted platform that simplifies this task by providing a set of Python classes which enforce adherence to the OSCAL schema, insuring that the produced OSCAL validates.</p> <ul> <li>file interfacing (read/write files)</li> <li>data processing (in-memory object structure construction)</li> <li>use of OSCAL versioned platform objects (trestle base and oscal functionality)</li> </ul>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#file-interfacing","title":"File Interfacing","text":"<p>Write a command line tool, for example a trestle task or auditree-arboretum harvest report that:</p> <ul> <li>imports the commensurate data processing module</li> <li>reads the input</li> <li>send input to data processing module</li> <li>receives transformed data from data processing module</li> <li>writes the output</li> </ul>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#data-processing","title":"Data Processing","text":"<p>Write a data processing module that receives data, and optionally metadata, for transformation from native form into OSCAL. Separation from the command line file read/write mechanism allows for module re-use.</p> <p>The module should:</p> <ul> <li>import the trestle oscal module</li> <li>receive input data to be transformed</li> <li>receive metadata, optionally</li> <li>transform input into trestle oscal classes hierarchy</li> <li>send transformed OSCAL data in return</li> </ul> <p>For the Observation only case, the transform is straight forward. Code should create one Observation for each rule/result pair.</p> <p>For the Findings case, a bit more logic is required. Code should accumulate Observations for each Finding and determine an overall status for it. For example, if 15 Observations are found for Finding control AC-3, where 14 have result=PASS and 1 has result=FAIL, then the overall status for the Finding would be <code>not satisfied</code> with overall result=FAIL.</p>"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#examples","title":"Examples","text":"<p>There are 2 transformers in trestle. The xccdf-result-to-oscal-ar transformer emits OSCAL Observations, the simplest partial result.</p> <p>The tanium-result-to-oscal-ar transformer emits OSCAL Findings, a more complex partial result.</p> <p>Table of approximate lines of code.</p> task-name  OSCAL type  file interface  data processing  test cases   xccdf-result-to-oscal-ar  Observations only  275  350  400   tanum-to-oscal  Findings, with Observations  200  350  300"},{"location":"tutorials/Transformers_and_Tasks/transformer_construction/#contributing","title":"Contributing","text":"<p>Consider contributing your transformer to trestle or auditree-arboretum or other appropriate open source repository.</p>"},{"location":"tutorials/Trestle_authoring/ssp_profile_catalog_authoring/","title":"Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring","text":""},{"location":"tutorials/Trestle_authoring/ssp_profile_catalog_authoring/#introduction-and-background","title":"Introduction and background","text":"<p>In addition to core functionality for automated processing of OSCAL documents, Trestle has authoring tools that allow conversion of OSCAL documents to markdown for easy editing - and conversion back to OSCAL for validation and automation.  A big part of compliance involves writing guidance prose associated with controls, along with the setting of parameters and properties for those controls.  This cannot be completely automated because it requires human editing, along with human approvals of those edits.  The purpose of the authoring tools is to allow selected edits of oscal documents guided by prompts for where content is required.  This serves to streamline the edit/approval process whereby the author is presented with one markdown document per control, and it provides a view of the the key information needed during the editing process.  This greatly simplifies the editing process compared to multiple authors working together on a single large JSON document.</p> <p>The key modes of authoring are -generate and -assemble.  During -generate a JSON document is converted to markdown format, allowing authors to add or edit prose and parameter values.  After editing, the markdown can then be -assembled into the same or a new JSON document that captures the edit changes.  In a normal authoring cycle, the markdown is generated for the first time from a given JSON file, and after that there is a continuous process of editing and reassembling to keep the JSON up to date with the markdown edits.</p> <p>A third mode of authoring is -filter, where parts of a document are removed.  This allows one large master document to be represented in simpler ways with, e.g. proprietary prose culled in form intended for consumption outside a company.</p> Integration with git and CI/CD <p>The command line interface in Trestle makes a powerful combination with git and CI/CD environments (Continuous Integration, Continuous Delivery or Deployment) when the trestle commands are performed via github actions or equivalent.  This allows different classes of users based on 1) their access to the repository 2) the changes to documents they are allowed to commit, and 3) the changes they can make to actions that are triggered by a commit.  As an example, a command line option may limit the type of content added to a profile, and if disallowed changes are detected during commit - the commit will be rejected.  This, in combination with having all controls as individual markdown files organized by groups in directories, makes management and tracking of author edits robust and automatically controlled by the built-in features of the respository.</p> <p>For an example of actions triggered by a commit, a change to a control in a catalog could generate a pull request that is approved by someone with appropriate authority, and when it is later merged it triggers notification downstream to authors of profiles that import that catalog.</p> The author commands <p>The author commands are:</p> <ol> <li><code>catalog-generate</code> converts a control Catalog to individual controls in markdown format for addition or editing of guidance prose and parameters, with parameters stored in a yaml header at the top of the markdown file.  <code>catalog-assemble</code> then gathers the prose and parameters and updates the controls in the Catalog to make a new OSCAL Catalog.</li> <li><code>profile-generate</code> takes a given Profile and converts the controls represented by its resolved profile catalog to individual controls in markdown format, with sections corresponding to the content that the Profile adds to the Catalog, along with both the current values of parameters in the resolved profile catalog - and the values that are being modified by the given profile's SetParameters.  The user may edit the content or add more, and <code>profile-assemble</code> then gathers the updated content and creates a new OSCAL Profile that includes those changes.</li> <li><code>profile-resolve</code> is special as an authoring tool because it does not involve markdown and instead it simply creates a JSON resolved profile catalog from a specified JSON profile in the trestle directory.  There are options to specify whether or not parameters get replace in the control prose or not, along with any special brackets that might be desired to indicate the parameters embedded in the prose.</li> <li><code>profile-inherit</code> takes a given parent profile and filters its contents based on the inherited controls included in a given ssp to be include in the final profile.</li> <li><code>component-generate</code> takes a given ComponentDefinition file and represents all the controls in markdown in separate directories for each Component in the file.  This allows editing of the prose on a per-component basis.  <code>component-assemble</code> then assembles the markdown for all controls in all component directories into a new, or the same, ComponentDefinition file.</li> <li><code>ssp-generate</code> takes a given Profile and an optional list of component-definitions, and represents the individual controls as markdown files with sections that prompt for prose regarding the implementation response for items in the statement of the control, with separate response sections for each component.  <code>ssp-assemble</code> then gathers the response sections and creates an OSCAL System Security Plan comprising the resolved profile catalog and the implementation responses for each component.  The list of component-definitions is optional, but without them the SSP will only have one component: <code>This System</code>.  Rules, parameters and status associated with the implemented requirements are stored in the SetParameters and Properties of the components in the component definitions and represented in the markdown, allowing changes to be made to the parameter values and status.  These edits are then included in the assembled SSP.  Note that the rules themselves may not be edited and strictly correspond to what is in the component definitions.</li> <li><code>ssp-filter</code> takes a given ssp and filters its contents based on the controls included in a provided profile, or in a list of components to be included in the final ssp.</li> </ol> <p>In summary, the <code>catalog</code> tools allow conversion of a Catalog to markdown for editing - and back again to a Catalog.  The <code>profile</code> tools similarly convert a Profile's resolved profile catalog to markdown and allow conversion to a new Profile with modified additions that get applied in resolving the profile catalog.  <code>component</code> tools perform similarly for ComponentDefinitions.  Finally, the <code>ssp</code> tools allow the addition of implementation prose to the markdown of a system security plan, which is then assembled into a JSON SSP on a by-component basis.</p> <p>Note that the original ssp implementation in trestle created SSP's by adding prose directly to the SSP markdown on a per-component basis, and there was no connection with separate ComponentDefinition JSON files.  This is now changed so that control responses can be added to the ComponentDefinition and then merged to create the SSP markdown.  In addition, rules and status are captured in the component definition as properties that propogate via markdown into the assembled SSP.  The OSCAL schema doesn't include a form of implementation status for components in the component definition, which is why trestle embeds the status value in the properties.  Similarly, rules and rule parameter values are not currently part of the schema, so they are also embedded in properties.</p> Some details of the author commands <p>The markdown files for controls usually have a YAML header at the top containing metadata about the control.  Sometimes that information is read-only and intended as additional information useful during markdown editing, but in other cases the content may be edited and incorporated as new values for the control after <code>-assemble</code>.  In addition, most <code>-generate</code> commands allow specifying a separate YAML header file containing information either needed by the command, or intended to be incorporated into the header of each control markdown file.  When generating markdown a YAML header may be optionally provided, and if so, the option <code>--overwrite-header-values</code> will cause the values in the provided YAML header to overwrite the value in the markdown file's header for any items that are common.  Otherwise the provided YAML header will simply insert any values not already in the markdown header. By default, Trestle will preserve the history of the changes in generated markdowns, however <code>--force-overwrite</code> option can be used to overwrite markdowns with content from JSON. Note that this option will completely delete all existing markdowns (in the given <code>output</code> folder) without saving any changes. To save the changes, run assemble first. Similarly, when assembling to JSON, the <code>--set-parameters</code> option will cause any changes in the header to take effect and change values in the assembled JSON for the control.  The changes can including setting parameter and property values.  The <code>--set-parameters</code> option is available only for <code>catalog-assemble</code> and <code>profile-assemble</code>.</p> <p>As described earlier, the authoring tools are designed to work well in a CI/CD environment where changes are made in a pipeline by people with different responsibilities and authority.  In this setting, changes to documents can trigger changes downstream, e.g. the editing of a control would cause an update in the catalog, which could then flow down to an updated SSP.  These changes can occur automatically via actions that restrict the potential changes to the generated documents.  Examples are the <code>--set-parameters</code> option on the <code>-assemble</code> tools, and both <code>--required-sections</code> and <code>allowed-sections</code> for <code>profile-assemble</code>.  If a document change triggers an assemble action, changes to parameters can only occur if the action has <code>--set-parameters</code> in the command.  Similarly, <code>profile-assemble</code> will fail if the sections do not meet the requirements specified in the command options.  Another feature of the <code>-assemble</code> tools is that they won't create a new OSCAL file if the output already exists and its content would not be changed.  This prevents undesired triggering of downstream actions when there is no actual change in content.</p> <p>There is a standalone demonstration of the SSP generation process with trestle in the Trestle SSP Demo that captures the entire process of SSP authoring: from creation of a component definition from CSV file to a final formatted system security plan in Word (.docx) format.</p> Background on underlying concepts <p>In order to understand the specific operations handled by these commands, it is helpful to clarify some of the underlying OSCAL structures and how they can be edited in markdown form.  This tutorial should be viewed in the context of the extensive documentation provided by OSCAL.</p> <p>First, a Catalog is a collection of Controls, and a Profile imports controls and allows modification and additions to the controls, but it does not create new controls.  A Profile has one or more Imports that refer either to an actual Catalog, or another Profile that itself is importing from a Catalog or Profile.  The profiles can import controls selectively from each source and make additions or modifications to properties of the controls.  The final collection of selected and modified controls represents the profile's resolved profile catalog.</p> <p>For clarity, here is a simple depicton of a catalog as a collection of controls:</p> <p></p> <p>Here is a profile pulling controls from a catalog to make a resolved profile catalog:</p> <p></p> <p>And here is a more complex situation where a single profile pulls controls from catalogs and profiles:</p> <p></p> <p>From the diagram it's clear that the profile is performing many tasks under the covers.  This is shown in an expanded view of a profile:</p> <p></p> <p>It's important to note that each profile is importing a selection of controls from each source, then making its own suggested modifications to parameters and other content in those controls.  They are suggested in the sense that downstream profiles may override those settings - with priority given to the later profiles in the pipeline.  The changes made by upstream profiles may be accepted, or overridden by better choices for a given need.  This way the catalogs themselves can remain relatively static, and individual use cases can effectively create a custom catalog based on the original controls plus modifications by  other static profiles, and/or the user's custom profile.  The authoring tools here provide ways to make those modifications, both to the catalog controls and to the profiles, and to enter the implementation responses that are needed in a System Security Plan.</p> <p>The tools are designed to be used in a continuous <code>generate-edit-assemble</code> cycle, with previous edits retained in each cycle.  Each new edit phase can add or modify the current content, allowing a new <code>generate</code> of an OSCAL json document capturing those edits.</p> <p>NOTE: We use <code>json</code> format for specifying OSCAL files in this tutorial, but it is equally applicable to <code>yaml</code> format also.</p>"},{"location":"tutorials/Trestle_authoring/ssp_profile_catalog_authoring/#the-author-commands-for-markdown-generation-and-assembly-to-json","title":"The author commands for markdown generation and assembly (to JSON)","text":"trestle author catalog-generate and trestle author catalog-assemble <p><code>catalog-generate</code> takes an existing json catalog and writes it out as markdown files for each control in a user-specified directory.  That directory will contain subdirectories for each group in the catalog, and those directories may contain subdirectories for groups within groups.  But controls containing controls are always split out into a series of controls in the same directory - and each control markdown file corresponds to a single control.</p> <p>We now look at the contents of a typical control markdown file.</p> <p>A Control may contain many parts, but only one of them is a Statement, which describes the function of the control.  The statement itself is broken down into separate items, each of which may contain parameter id's in \"moustache\" (<code>{{}}</code>) brackets.  Below is an example of a control as generated in markdown form by the <code>catalog-generate</code> command.</p> Control example <pre><code>---\nx-trestle-set-params:\n  ac-1_prm_1:\n    values:\n      - new value\n  ac-1_prm_2:\n    values:\n  ac-1_prm_3:\n    values:\n      - added param 3 value\n  ac-1_prm_4:\n    values:\n  ac-1_prm_5:\n    values:\n  ac-1_prm_6:\n    values:\n  ac-1_prm_7:\n    values:\nx-trestle-global:\n  sort-id: ac-01\n---\n\n# ac-1 - \\[Access Control\\] Policy and Procedures\n\n## Control Statement\n\n- \\[a.\\] Develop, document, and disseminate to {{ insert: param, ac-1_prm_1 }}:\n\n  - \\[1.\\]  {{ insert: param, ac-1_prm_2 }} access control policy that:\n\n    - \\[(a)\\] Addresses purpose, scope, roles, responsibilities, management commitment, coordination among organizational entities, and compliance; and\n    - \\[(b)\\] Is consistent with applicable laws, executive orders, directives, regulations, policies, standards, and guidelines; and\n\n  - \\[2.\\] Procedures to facilitate the implementation of the access control policy and the associated access controls;\n\n- \\[b.\\] Designate an {{ insert: param, ac-1_prm_3 }} to manage the development, documentation, and dissemination of the access control policy and procedures; and\n\n- \\[c.\\] Review and update the current access control:\n\n  - \\[1.\\] Policy {{ insert: param, ac-1_prm_4 }} and following {{ insert: param, ac-1_prm_5 }}; and\n  - \\[2.\\] Procedures {{ insert: param, ac-1_prm_6 }} and following {{ insert: param, ac-1_prm_7 }}.\n- \\[d\\] My added item\n\n## Control guidance\n\nAccess control policy and procedures address the controls in the AC family that are implemented within systems and organizations. The risk management strategy is an important factor in establishing such policies and procedures. \n</code></pre> <p>The control markdown files rely on brackets around key items that are important in defining the control's properties and structure.  <code>\\[Access Control\\]</code> at the top indicates the title of the group containing the control.  The name of the control is already known from the name of the markdown file (<code>ac-1.md</code>) and the name of the group is already known from the name of the directory containing the group's controls (<code>ac</code>) - but the group title must be indicated in the control in a special manner, hence the brackets.  The text following the group title is the title of the control itself.  All controls in a group should have the same group title or a warning will be indicated in certain trestle operations.</p> <p>In addition, each part label corresponds to the label used in the OSCAL structure for the control statement, and so must be maintained in a special manner -  hence the need for brackets on <code>\\[(a)\\]</code>.</p> <p>The items in moustaches (<code>{{}}</code>) correspond to the original prose from the control description.  The moustaches represent places to substitue parameter values, but no substitutions are ever made until the final SSP generation.  The authoring process provides multiple ways to set and change the final parameter values, as described below.</p> <p><code>catalog-generate</code> is run with the command <code>trestle author catalog-generate --name catalog_name --output markdown_dir</code>, where <code>catalog_name</code> is the name of a catalog already loaded into the trestle workspace, and <code>markdown_dir</code> is the directory into which the markdown files for the controls will be written.  A separate directory is created for each group in the catalog.</p> <p>A user then may edit the control statement for the control and add or change the contents.  In this case an added item, <code>My added item</code> is shown as item <code>d</code>.  You can then assemble the edited controls into a new catalog with the command <code>trestle author catalog-assemble --markdown markdown_dir --output new_catalog</code>.  This will load the updated control statements for each control into a new json or yaml catalog named <code>new_catalog</code>.</p> <p>As with profile and ssp generation described below, a yaml header may be provided with the <code>--yaml</code> option that is inserted into the top of each control file.  If a control file already exists, as is expected in a continuous cycle of generate-edit-assemble, then the provided header will be merged with the existing header in each control.  If a given item in the header is already present in the control, by default the values in the markdown header will be given priority, though this can be overridden by the <code>--overwrite-header-values</code> option, which will give priority to any values coming from the provided yaml header.  In all cases, values in the yaml header not already present in the markdown header will be inserted.</p> <p>In the control markdown example above, the header contains some arbitrary values along with a special <code>x-trestle-set-params</code> section containing parameters for some of the parameters in the control.  Any parameters for the control in the catalog will appear in the markdown header automatically during <code>catalog-generate</code>.  These values may be changed and values for other parameters may be inserted into the markdown header for later use during <code>catalog-assemble</code>.</p> <p>Parameters in the header are shown with a subset of their full OSCAL attributes in order to convey any values they may have along with descriptive text.  This amounts to the parameter id, its label if present, any values if present, and any select if present.  When a select is present the list of choices is provided along with the how-many option.  Note that values is a list in OSCAL, but in many cases it is a list of only one item.  As a result, for convenience the values: dictionary may either have one string value (on the same line with <code>values:</code>) or as an indented <code>-</code> list of multiple values underneath <code>values:</code>.  Multiple examples are evident in the sample above, including ac-1_prm_3, which only has a label and no values.</p> <p>Another important item in the header is the sort-id for the control.  This specifies how the controls and their parameters are ordered in any aggregated list operation.  If it is not specified for a control, the control's id is used for sorting.</p> <p>As with the other -generate tools, the <code>--force-overwrite</code> option will cause the destination markdown directory to be erased prior to generating the new markdown, so that any prior edits to the markdown will be erased.</p> <p><code>catalog-assemble</code> is run with the command <code>catalog-assemble --markdown my_md --output my_new_catalog</code>.  This will read the markdown for each control and create a new catalog based on any edits to the markdown.  Note that you may optionally provide a <code>--name</code> option specifying an original json catalog into which the updated controls are inserted, and the resulting catalog can either replace the original one or output to a different json file.  New controls may be added but existing controls may not be removed and new groups cannot be added when you are updating an existing catalog.  The main benefit of updating an existing catalog is that the original metadata and other contents of the catalog json file will be retained.  Note that you cannot create new controls that contain controls, but if an original json catalog contains controls with child controls, you can edit and update all of them as individual markdown files.  You have the option to specify a new <code>--version</code> for the catalog, and an option to regenerate the uuid's in the catalog.  Finally, you have the option to use the parameters in the markdown header to update the values in the control.  Any parameters and their values present will be added to the control, and any not present will be removed.  The parameters themselves are still present but their values are removed.</p> <p>In a typical <code>generate-edit-assemble</code> cycle, the cycle would start with an original json file containing source content and metadata and use that to generate an initial markdown directory of controls.  After editing the controls they would be assembled into into a new json file with a different name.  But once that new file exists, it can be used as the source for the next generation and the original source document is no longer needed or referred to.  For the <code>catalog-</code> editing cycle it would go as:</p> <pre><code>trestle author catalog-generate --name orig_catalog --output md_catalog\n[user edits the markdown files]\ntrestle author catalog-assemble --name orig_catalog --markdown md_catalog --output assembled_catalog\n[user makes additional markdown edits]\ntrestle author catalog-assemble --markdown md_catalog --output assembled_catalog\n</code></pre> <p>The key point here is that the first <code>-assemble</code> needs to use the original catalog for its metadata, backmatter and other items not captured in the markdown controls.  But once the output catalog has been created, by default it will be used as the \"original\" or \"parent\" catalog into which changes will be incorporated, unless a different source catalog is specified via <code>--name</code>.</p> <p>Note that <code>catalog-assemble</code> can instantiate a catalog anew from a manually created directory of markdown controls in directories corresponding to groups, but the metadata in the assembled json catalog will contain many <code>REPLACE_ME</code> items that would need to be manually edited in the json file itself.  The trestle <code>split</code> and <code>merge</code> tools may help in that case.  Once the changes have been made they will be retained if a new <code>catalog-assemble</code> happens with that same output file as the target.</p> <p>Special Note about assemble: In order to avoid triggering actions when a new file is created that has no actual changes in it, <code>catalog-assemble</code> and the other <code>-assemble</code> tools below will check to see if the output file already exists, and if so it will be examined for changes relative to the newly assembled one.  If there are no changes the file will not be written out.  Note that the check happens before any possible <code>--regeneration</code> of uuid's, and after any possible <code>--version</code> change.  This avoids the creation of a new file and new uuid's if there is no change to the version or other file contents relative to the existing output file, but if the specified <code>--version</code> is different from the one in the existing output file, or there is any other difference in the model, a new file will be written out.</p> trestle author profile-generate and trestle author profile-assemble <p>The background text above conveys how a profile pulls controls from catalogs and makes modifications to them, and the <code>trestle profile</code> tools let you change the way those modifications are made.  In addition to selecting controls and setting parameters, a profile may add new parts to a control that provide additional guidance specific to a certain use case.  <code>profile-generate</code> is run with the command, <code>trestle author profile-generate --name profile_name --output markdown_dir</code>.  It will load the specified profile name from the trestle workspace (it must have been imported into the trestle workspace prior) and create its corresponding resolved profile catalog - but without applying any of its <code>Adds</code> of additonal guidance content or <code>SetParameters</code>.  It will make all other modifications, but the <code>Adds</code> and <code>SetParameters</code> are kept separate, as shown below:</p> Example of control markdown after `profile-generate` <pre><code>---\nx-trestle-set-params:\n  # You may set values for parameters in the assembled Profile by adding\n  #\n  # profile-values:\n  #   - value 1\n  #   - value 2\n  #\n  # in the section under a parameter name\n  # The values list refers to the values in the catalog, and the profile-values represent values\n  # in SetParameters of the Profile.\n  #\n  ac-1_prm_1:\n    label: label from edit\n    profile-values:\n      - all personnel\n    values:\n      - Param_1_value_in_catalog\n    display-name: Pretty ac-1 prm 1\n  ac-1_prm_2:\n    profile-values:\n      - Organization-level\n      - System-level\n    values:\n    display-name: Pretty ac-1 prm 2\n  ac-1_prm_3:\n    profile-values:\n      - new value\n    values:\n  ac-1_prm_4:\n    profile-values:\n    values:\n  ac-1_prm_5:\n    profile-values:\n      - all meetings\n    values:\n  ac-1_prm_6:\n    profile-values:\n      - monthly\n    values:\n  ac-1_prm_7:\n    values:\nx-trestle-global:\n  profile:\n    title: Trestle test profile\n  sort-id: ac-01\nx-trestle-sections:\n  guidance: Guidance\n  implgdn: Implementation Guidance\n  expevid: Expected Evidence\n  my_guidance: My Guidance\n  a_guidance: A Guidance\n  b_guidance: B Guidance\n  NeededExtra: Needed Extra\n  a_subpart: A Subpart\n  a_subsubpart: A Subsubpart\n  b_subpart: B Subpart\n  a_by_id_subpart: a by_id subpart\nx-trestle-add-props:\n  # Add or modify control properties here\n  # Properties may be at the control or part level\n  # Add control level properties like this:\n  #   - name: ac1_new_prop\n  #     value: new property value\n  #\n  # Add properties to a statement part like this, where \"b.\" is the label of the target statement part\n  #   - name: ac1_new_prop\n  #     value: new property value\n  #     smt-part: b.\n  #\n  - name: prop_with_ns\n    value: prop with ns\n    ns: https://my_new_namespace\n  - name: prop_with_no_ns\n    value: prop with no ns\n    ns: https://my_added_namespace\n---\n\n---\n\n# ac-1 - \\[Access Control\\] Policy and Procedures\n\n## Control Statement\n\n- \\[a.\\] Develop, document, and disseminate to {{ insert: param, ac-1_prm_1 }}:\n\n  - \\[1.\\]  {{ insert: param, ac-1_prm_2 }} access control policy that:\n\n    - \\[(a)\\] Addresses purpose, scope, roles, responsibilities, management commitment, coordination among organizational entities, and compliance; and\n    - \\[(b)\\] Is consistent with applicable laws, executive orders, directives, regulations, policies, standards, and guidelines; and\n\n  - \\[2.\\] Procedures to facilitate the implementation of the access control policy and the associated access controls;\n\n- \\[b.\\] Designate an {{ insert: param, ac-1_prm_3 }} to manage the development, documentation, and dissemination of the access control policy and procedures; and\n\n- \\[c.\\] Review and update the current access control:\n\n  - \\[1.\\] Policy {{ insert: param, ac-1_prm_4 }} and following {{ insert: param, ac-1_prm_5 }}; and\n  - \\[2.\\] Procedures {{ insert: param, ac-1_prm_6 }} and following {{ insert: param, ac-1_prm_7 }}.\n\n## Control guidance\n\nAccess control policy and procedures address the controls in the AC family that are implemented within systems and organizations. The risk management strategy is an important factor in establishing such policies and procedures. Policies and procedures contribute to security and privacy assurance. Therefore, it is important that security and privacy programs collaborate on the development of access control policy and procedures. Security and privacy program policies and procedures at the organization level are preferable, in general, and may obviate the need for mission- or system-specific policies and procedures. The policy can be included as part of the general security and privacy policy or be represented by multiple policies reflecting the complex nature of organizations. Procedures can be established for security and privacy programs, for mission or business processes, and for systems, if needed. Procedures describe how the policies or controls are implemented and can be directed at the individual or role that is the object of the procedure. Procedures can be documented in system security and privacy plans or in one or more separate documents. Events that may precipitate an update to access control policy and procedures include assessment or audit findings, security incidents or breaches, or changes in laws, executive orders, directives, regulations, policies, standards, and guidelines. Simply restating controls does not constitute an organizational policy or procedure.\n\n# Editable Content\n\n&lt;!-- Make additions and edits below --&gt;\n&lt;!-- The above represents the contents of the control as received by the profile, prior to additions. --&gt;\n&lt;!-- If the profile makes additions to the control, they will appear below. --&gt;\n&lt;!-- The above markdown may not be edited but you may edit the content below, and/or introduce new additions to be made by the profile. --&gt;\n&lt;!-- If there is a yaml header at the top, parameter values may be edited. Use --set-parameters to incorporate the changes during assembly. --&gt;\n&lt;!-- The content here will then replace what is in the profile for this control, after running profile-assemble. --&gt;\n&lt;!-- The added parts in the profile for this control are below.  You may edit them and/or add new ones. --&gt;\n&lt;!-- Each addition must have a heading either of the form ## Control my_addition_name --&gt;\n&lt;!-- or ## Part a. (where the a. refers to one of the control statement labels.) --&gt;\n&lt;!-- \"## Control\" parts are new parts added after the statement part. --&gt;\n&lt;!-- \"## Part\" parts are new subparts added into the existing top-level statement part with that label. --&gt;\n&lt;!-- Subparts may be added with nested hash levels of the form ### My Subpart Name --&gt;\n&lt;!-- underneath the parent ## Control or ## Part being added --&gt;\n&lt;!-- See https://oscal-compass.github.io/compliance-trestle/tutorials/ssp_profile_catalog_authoring/ssp_profile_catalog_authoring for guidance. --&gt;\n\n## Control Implementation Guidance\n\nDo it carefully.\n\n## Control Expected Evidence\n\nDetailed logs.\n\n## Control Needed Extra\n\nAdd prose here for required Section: Needed Extra\n\n## Control A Guidance\n\nControl level guidance\n\n### A Subpart\n\nA subpart prose\n\n#### A Subsubpart\n\nA subsubpart prose\n\n### B Subpart\n\nB subpart prose\n\n## Part a.\n\n### Subpart of top level Part a. of the control\n\nProse added as a sub-part to Part a. of the control\n</code></pre> <p>In the above markdown example, the fixed, uneditable parts of the control are output first (after the header, which can be edited), followed by a separate section marked, <code>Editable Content</code>.  And below the editable content are the individual <code>Adds</code> that the profile makes, with each one marked by a header of the form, <code>## Control guidance_name</code> or <code>## Part statement_part_label</code> followed by named subparts.  You may edit the editable content and you may add new Control guidance headers and statement sub-parts with your own new content. (Please refer to Markdown Specifications for Editable Content section below to learn more on which headers are valid in Trestle.) Then the command, <code>trestle author profile-assemble --name original_profile --markdown markdown_dir --output new_profile</code> will create a new OSCAL profile based on the original profile (specified) and the editable content in each control.</p> <p>It's important to distinguish <code>## Control My New Guidance</code> from <code>## Part a.</code>.  Parts added with <code>## Control</code> will be new parts in the control added after the control statement, along with any subparts indicated by lower hash levels in that section.  In contrast, parts added with e.g. <code>## Part c.</code> will be added by-id to the top level part in the control statement with label <code>c.</code>.  Thus \"My New Guidance\" is the title the user is assigning to a completely new part, while <code>c.</code> refers to a label corresponding the the desired control statement part.</p> <p>When new part names are created in the markdown file the title is captured along with its capitalization and spaces, but the corresponding part name will be converted to snake case by default.  However, the user may indicate a specific mapping of the long title of the part to its actual part name by providing an entry in the <code>sections</code> provided during <code>profile-assemble</code>.  For example, in the above, the <code>Needed Extra</code> part would be assigned the name <code>needed_extra</code> but if you had a section entry such as <code>n_ex:Needed Extra</code> the name <code>n_ex</code> would be assigned in the assembled json profile, so that if you used that same section entry <code>trestle</code> would know to replace the <code>n_ex</code> part with <code>Needed Extra</code> in any generated markdown.</p> <p>In a cyclic operation of <code>profile generate-edit-assemble</code> you would simply be re-writing from and to the same json profile, in which case the <code>--name</code> and <code>--output</code> are the same file.  For this reason the default value for <code>--name</code> is the given output file name specified by <code>--output</code> and you can just use <code>trestle author profile-assemble --markdown profile_md --output my_profile</code>.  This will assemble the markdown profile contents in directory <code>profile_md</code> into a json profile named <code>my_profile</code> but it will first use the existing <code>my_profile</code> json file as the parent profile and incorporate changes (due to user edits) in the markdown version of the profile.  Unlike <code>catalog-assemble</code> there must always be a parent json profile to reference during assemble, but like <code>catalog-assemble</code> an explicit value for <code>--name</code> is only needed if the parent file is different from the assembled output file.</p> <p>It's important to note that these operations only apply to the <code>Adds</code> and <code>SetParameters</code> in the profile itself - and nothing upstream of the profile is affected.  Nor is anything else in the original profile lost or altered.  In the example above, the section, <code>## Control Implementation Guidance</code> was added by editing the generated control - and after <code>profile-assemble</code> it ended up as new guidance in the assembled profile.</p> <p>As in the other commands, <code>profile-generate</code> allows specification of a yaml header with <code>--yaml-header</code>, support of the <code>--overwrite-header-values</code> flag and <code>--force-overwrite</code>.   Also, during assembly with <code>profile-assemble</code> the <code>--set-parameters</code> flag will set parameters in the profile for the control based on the header in the control markdown file.  But unlike with <code>catalog-assemble</code>, only those parameter values marked <code>profile-values</code> will be part of the assembled profile's SetParams when you assemble with the <code>--set-parameters</code> flag.  For each parameter, the \"incoming\" values for the parameters prior to any changes made by the profile are listed as <code>values:</code> and any pending changes made by the profile are listed as <code>profile-values:</code>.  If you don't use the <code>--set-parameters</code> flag then all the original SetParameters in the profile will be retained in the new, assembled profile.  But if you do set that flag, then only the header parameters with <code>profile-values:</code> will be added as SetParameters.  This lets you see all the incoming values for parameters along with any changes made by the current profile, and you can modify, add, or remove parameter settings as desired in the new profile.</p> <p>The <code>x-trestle-add-props</code> key of the yaml header allows addition of properties to the SetParameters of the profile, comprising <code>name</code>, <code>value</code>, and optionally a namespace <code>ns</code> value.  The properties may be added at the control level, or attached to a top level statment part by adding a value, <code>smt-part</code> with value <code>a.</code>, <code>b.</code> or any other label for one of the top level statement parts.</p> <p>For convenience, the <code>x-trestle-global</code> key of the yaml header contains the <code>profile-title</code> of the profile used to generate the markdown.</p> <p>Keep in mind that the header in the <code>profile-</code> tools corresponds to the <code>SetParameters</code> in the profile - and not simply the <code>Parameters</code> in the control.  For convenience the current incoming values of the control parameters, as set by any upstream profiles, are shown as <code>values</code> - but anything else associated with a parameter, such as <code>profile-values</code>, <code>label</code>, <code>choice</code> will be added to the profile's <code>SetParameters</code> during <code>profile-assemble</code> (if you use the <code>--set-parameters</code> flag.)  So entries should be set there only if you want the profile to enforce those entries as <code>SetParameters</code>.</p> <p>As with <code>catalog-assemble</code> described above, a new file is written out only if there are changes to the model relative to an existing output file, and during generate, <code>--force-overwrite</code> will first erase any existing markdown so that fresh markdown is created.</p> Use of Sections in profile-generate and profile-assemble <p>The addition of guidance sections in the <code>profile</code> tools requires special handling because the corresponding parts have both a name and a title, where the name is a short form used as an id in the json schema, while the title is the readable form intended for final presentation.  An example is <code>ImplGuidance</code> vs. <code>Implementation Guidance</code>.  The trestle authoring tools strive to make the markdown as readable as possible, therefore the headings for sections use the title - which means somehow there is a need for a mapping from the short name to the long title for each section.  This mapping is provided in several ways:  During <code>profile-generate</code> you may provide a <code>--sections \"ImplGuidance:Implementation Guidance,ExpEvidence:Expected Evidence\"</code> option that would provide title values for <code>ImplGuidance</code> and <code>ExpEvidence</code>.  This dictionary mapping is then inserted into the yaml header of each control's markdown.  You may also add this mapping directly to a yaml file that is passed in during <code>profile-generate</code>, which is preferable if the list of sections is long.  The sections should be entered in the yaml header in a section titled, <code>x-trestle-sections</code>.</p> <p>There is also a <code>--required-sections</code> option during both <code>profile-generate</code> and <code>profile-assemble</code>.  This option expects a list of sections as comma-separated short names, e.g. <code>--required-sections \"ImplGuidance,ExpEvidence\"</code>.  During <code>profile-generate</code> any required sections will have in the markdown a prompt created for guidance prose to be entered.  And during <code>profile-assemble</code> if required sections are specified, those sections must have prose filled in or it will fail with error.</p> <p>Finally, <code>profile-assemble</code> also has an <code>--allowed-sections</code> option that restricts any added guidance to only those allowed sections - and if disallowed sections are present it will fail with error.  If <code>--allowed-sections</code> is not specified then any sections found in the markdown will be added to the assembled profile.</p> <p>Note that these section options are all optional and there isn't a need to provide this form of restriction and enforcement.  But in order to have such sections read properly and mapped to the intended part names, a mapping must be provided in one of the ways described above.  And for certain workflows, if the allowed and required sections are specified by a command that is run as an action outside the user's control, it allows restriction of what changes can or must be made to a profile in terms of added guidance.</p> <p>(Note that the single quotes are required on Unix-like systems, but on Windows they are only needed if the contained string includes spaces, in which case double quotes should be used.)</p> Markdown Specifications for Editable Content. <p>For the ease of editing markdown in Github, Trestle's markdown parser follows Github Flavoured Markdown (GFM) specifications and therefore only certain Control headers will be parsed and added to the control.</p> <p>A valid control header in Trestle is the header that is correctly displayed as such when reading or previewing the edited markdown on Github website.</p> <p>In GFM, headers are considered to be any line of text that has any number of <code>#</code> symbols at the beginning. For example those are all valid headers and will be treated as such by Github:</p> <pre><code># Valid header\n## Valid header \n##### Valid header\n# Valid &lt;ins&gt; header &lt;/ins&gt; \n# Valid header &lt;!-- some comment here --&gt;\n</code></pre> <p>The headers above are valid Control headers and will be added to the control. However, there are multiple exceptions where the header will not be displayed. The header will not be displayed correctly if it is:</p> <ol> <li>Written in the HTML comments <code></code> or tags <code>&lt;ins&gt; # not a header &lt;/ins&gt;</code> as well as multi-line comments:    <pre><code>&lt;!--\n# not a header\n--&gt;\n</code></pre>    or multi-line HTML blocks:    <pre><code>&lt;dl&gt; # not a header\n# not a header\n  &lt;dt&gt;# not a header&lt;/dt&gt;\n&lt;/dl&gt;\n</code></pre></li> <li>Written in the single-line <code># not a header</code> and multi-line code blocks:    <pre><code># not a header \n</code></pre></li> <li>Written in the links <code>[# not a header](url)</code></li> <li>Trestle will also not support headers inside the blockquotes <code>&gt; # not a header</code></li> </ol> <p>In all cases above Trestle markdown parser will skip such headers and it will be not added to the control.</p> trestle author profile-resolve <p>The <code>trestle author profile-resolve</code> command is different from the <code>generate/assemble</code> commands because it doesn't involve markdown and instead it takes an input profile and creates the corresponding resolved profile catalog in <code>JSON</code> format.  In addition, it has several options for how parameters are represented in prose of the controls, and whether or not those values are substituted.</p> <p>As an example, the prose in the statement for control <code>AC-1</code> is:</p> <p><code>Develops, documents, and disseminates to {{ insert: param, ac-1_prm_1 }}:</code></p> <p>The parameter <code>ac-1_prm_1</code> has a label: <code>organization-defined personnel or roles</code> and it may or may not have a value assigned by the profile being resolved.  Suppose it has been assigned the value, <code>my prm 1 value</code>.  In that case we can either leave the prose as-is (with the parameter in \"moustache\" form) in the resolved catalog, or we can substitute the value, or we can substitute the descriptive label.  trestle supports all these options, along with an optional prefix to specify whether a value has been assigned or not - typically using the name of the organization responsible.</p> <p>The <code>--show-value -sv</code> option will cause the value for the parameter to be substituted in the prose if it is available - otherwise the list of selection options if it has any, or simply the label prose if it has no options.</p> <p>The <code>--value-assigned-prefix -vap</code> option adds a prefix to the value if the value is being assigned by the profile, and the <code>--value-not-assigned-prefix -vnap</code> will assign a prefix to parameters that do not have values assigned, along with the descriptive parameter label.</p> <p>Finally, the <code>--bracket-format -bf</code> option specifies how the parameter representation will be wrapped in braces.  The specification is done by placing characters around a single <code>.</code> symbol representing the parameter string, e.g. <code>[.]</code> will place square brackets around the parameter.</p> <p>Note that these options that specify how the parameter is represented all require <code>--show-value</code> to be True, otherwise the raw prose with the moustache is produced.</p> <p>As an example, if we use options</p> <p><code>trestle author profile-resolve -n my_profile -o my_resolved_catalog -sv -bf [.] -vap \"ACME Assignment:\" -vnap \"Assignment:\"</code></p> <p>the above prose would become:</p> <p><code>Develops, documents, and disseminates to [ACME Assignment: my prm 1 value]:</code></p> <p>(Note that you need appropriate use of quotation marks in the command for any strings that include spaces or special characters.)</p> <p>And if the parameter did not have a value assigned the result would be:</p> <p><code>Develops, documents, and disseminates to [Assignment: organization-defined personell or roles]:</code></p> <p>Finally, if the parameter already had a value specified in the catalog, the value would be shown by itself in braces:</p> <p><code>Develops, documents, and disseminates to [value in catalog]:</code></p> <p>Similar substitution happens when a parameter has choices that themselves reference a parameter, such as:</p> <pre><code>\"id\": \"ac-4.4_prm_1\",\n\"select\": {\n  \"how-many\": \"one-or-more\",\n  \"choice\": [\n    \"decrypting the information\",\n    \"blocking the flow of the encrypted information\",\n    \"terminating communications sessions attempting to pass encrypted information\",\n    \" {{ insert: param, ac-4.4_prm_2 }} \"\n  ]\n</code></pre> <p>If the statement prose for AC-4.4 is:</p> <p><code>The information system prevents encrypted information from bypassing content-checking mechanisms by {{ insert: param, ac-4.4_prm_1 }}.</code></p> <p>and if a value <code>pulling the plug</code> has been assigned to ac-4.4_prm_2, the prose will be:</p> <p><code>The information system prevents encrypted information from bypassing content-checking mechanisms by [Selection (one or more): decrypting the information, blocking the flow of the encrypted information, terminating the communications sessions attempting to pass encrypted information, [ACME Assignment: pulling the plug]].</code></p> <p>There is a separate option from <code>--show-values</code> that will instead show only the descriptive labels for the parameters - again with an optional prefix.  The options are <code>--show-labels -sl</code> and <code>--label-prefix -lp</code>.  Note that there is no need for \"assigned\" or \"not assigned\" because no values are being shown - just the labels.</p> <p>If we resolve the profile with options <code>--show-labels --label-prefix \"Label:\" --bracket-format [.]</code> the resulting prose from earlier would be:</p> <p><code>Develops, documents, and disseminates to [Label: organization-defined personnel or roles]:</code></p> <p>and any value present for the parameter would be ignored.</p> <p>Similar options apply to the <code>jinja</code> authoring commands.</p> trestle author profile-inherit <p>The <code>trestle author profile-inherit</code> command is different from the <code>generate/assemble</code> commands because it doesn't involve markdown and instead it takes an parent profile and ssp and creates child profile in <code>JSON</code> format.</p> <p>When utilizing a process with leveraged authorizations, use the command <code>trestle author profile-inherit</code> to create a profile with initial content using a parent profile and SSP with inheritable controls. The provided and responsibility statements for all <code>by-component</code> fields, as well as the implementation status, will be used to evaluate the leveraged SSP. To be filtered from the output profile (i.e. controls delta profile), all components must have exported provided statements, no exported responsibility statements, and an implementation status of <code>implemented</code>.</p> <p>The filter command is invoked as:</p> <p><code>trestle author profile-inherit --profile my_parent --ssp my_leveraged_ssp --output controls_delta_profile</code></p> <p>Both the parent profile and the SSP must be present in the trestle workspace. This command produces a new workspace profile that imports the parent profile and filters the inherited controls from the SSP using the <code>exclude-controls</code> and <code>include-controls</code> fields in the profile import.</p> Example imports generated from profile-inherit <pre><code>  \"imports\": [\n      {\n        \"href\": \"trestle://profiles/controls_delta/profile.json\",\n        \"include-controls\": [\n          {\n            \"with-ids\": [\n              \"ac-2\"\n            ]\n          }\n        ],\n        \"exclude-controls\": [\n          {\n            \"with-ids\": [\n              \"ac-1\"\n            ]\n          }\n        ]\n      }\n    ]\n</code></pre> trestle author component-generate and component-assemble <p>The <code>trestle author component-generate</code> command takes a JSON ComponentDefinition file and creates markdown for its controls in separate directories for each of the DefinedComponents in the file.  This allows specifying the implementation response and status for each component separately in separate markdown files for a control.  In addition, the markdown captures Rules in the control that specify descriptions and parameter values that apply to the expected responses.</p> <p>The command has few options compared to other author commands and only requires specifying <code>--name</code> and <code>--output</code> for the ComponentDefinition and output markdown directory, respectively.</p> <p>Here is an example of the generated markdown for the component <code>OSCO</code> in the ComponentDefinition file.  Note that this file will be under the subdirectory <code>OSCO/source_name</code> of the specified output directory - and any other DefinedComponents will have corresponding subdirectories level with the <code>OSCO</code> one.  Here <code>source_name</code> refers to the name of the profile or catalog in the ComponentDefinition that is the source for this control.  The control markdown files are written into directories split by both component name and source name.  If the source refers to a general uri and not a named profile or catalog in the trestle directory, then names such as <code>source_001</code> and <code>source_002</code> are assigned.  The actual source title can be found in the yaml header of any of the control markdown files.</p> Example of control markdown after component-generate <pre><code>---\nx-trestle-comp-def-rules:\n  comp_aa:\n    - name: top_shared_rule_1\n      description: top shared rule 1 in aa\n    - name: comp_rule_aa_1\n      description: comp rule aa 1\nx-trestle-rules-params:\n  comp_aa:\n    - name: shared_param_1\n      description: shared param 1 in aa\n      options: '[\"shared_param_1_aa_opt_1\", \"shared_param_1_aa_opt_2\"]'\n      rule-id: top_shared_rule_1\nx-trestle-comp-def-rules-param-vals:\n  # You may set new values for rule parameters by adding\n  #\n  # component-values:\n  #   - value 1\n  #   - value 2\n  #\n  # below a section of values:\n  # The values list refers to the values as set by the components, and the component-values are the new values\n  # to be placed in SetParameters of the component definition.\n  #\n  comp_aa:\n    - name: shared_param_1\n      values:\n        - shared_param_1_aa_opt_1\nx-trestle-param-values:\n  ac-1_prm_1:\n    - prof_aa val 1\n  ac-1_prm_2:\n  ac-1_prm_3:\n  ac-1_prm_4:\n  ac-1_prm_5:\n  ac-1_prm_6:\n  ac-1_prm_7:\nx-trestle-global:\n  profile:\n    title: comp prof aa\n    href: trestle://profiles/comp_prof_aa/profile.json\n  sort-id: ac-01\n---\n\n# ac-1 - \\[Access Control\\] Policy and Procedures\n\n## Control Statement\n\nThe organization:\n\n- \\[a.\\] Develop, document, and disseminate to prof_aa val 1:\n\n  - \\[1.\\] Organization-level; Mission/business process-level; System-level access control policy that:\n\n    - \\[(a)\\] Addresses purpose, scope, roles, responsibilities, management commitment, coordination among organizational entities, and compliance; and\n    - \\[(b)\\] Is consistent with applicable laws, executive orders, directives, regulations, policies, standards, and guidelines; and\n\n  - \\[2.\\] Procedures to facilitate the implementation of the access control policy and the associated access controls;\n\n- \\[b.\\] Designate an organization-defined official to manage the development, documentation, and dissemination of the access control policy and procedures; and\n\n- \\[c.\\] Review and update the current access control:\n\n  - \\[1.\\] Policy organization-defined frequency and following organization-defined events; and\n  - \\[2.\\] Procedures organization-defined frequency and following organization-defined events.\n\n## Control guidance\n\nAccess control policy and procedures address the controls in the AC family that are implemented within systems and organizations. The risk management strategy is an important factor in establishing such policies and procedures. Policies and procedures contribute to security and privacy assurance. Therefore, it is important that security and privacy programs collaborate on the development of access control policy and procedures. Security and privacy program policies and procedures at the organization level are preferable, in general, and may obviate the need for mission- or system-specific policies and procedures. The policy can be included as part of the general security and privacy policy or be represented by multiple policies reflecting the complex nature of organizations. Procedures can be established for security and privacy programs, for mission or business processes, and for systems, if needed. Procedures describe how the policies or controls are implemented and can be directed at the individual or role that is the object of the procedure. Procedures can be documented in system security and privacy plans or in one or more separate documents. Events that may precipitate an update to access control policy and procedures include assessment or audit findings, security incidents or breaches, or changes in laws, executive orders, directives, regulations, policies, standards, and guidelines. Simply restating controls does not constitute an organizational policy or procedure.\n\n______________________________________________________________________\n\n## What is the solution and how is it implemented?\n\n&lt;!-- For implementation status enter one of: implemented, partial, planned, alternative, not-applicable --&gt;\n\n&lt;!-- Note that the list of rules under ### Rules: is read-only and changes will not be captured after assembly to JSON --&gt;\n\nimp req prose for ac-1 from comp aa\n\n### Rules:\n\n  - top_shared_rule_1\n\n### Implementation Status: implemented\n\n______________________________________________________________________\n\n## Implementation for part a.\n\nstatement prose for part a. from comp aa\n\n### Rules:\n\n  - comp_rule_aa_1\n\n### Implementation Status: partial\n\n______________________________________________________________________\n</code></pre> <p>There is no direct way to specify rules in the ComponentDefinition, so they are specified via properties as shown here:</p> Representation of rules in the props of a ComponentDefinition <pre><code>[\n  {\n    \"name\": \"Rule_Id\",\n    \"ns\": \"http://comp_ns\",\n    \"value\": \"comp_rule_aa_1\",\n    \"class\": \"Rule_Id\",\n    \"remarks\": \"rule_2\"\n  },\n  {\n    \"name\": \"Rule_Description\",\n    \"ns\": \"http://comp_ns\",\n    \"value\": \"comp rule aa 1\",\n    \"remarks\": \"rule_2\"\n  },\n  {\n    \"name\": \"Rule_Id\",\n    \"ns\": \"http://comp_ns\",\n    \"value\": \"comp_rule_aa_2\",\n    \"class\": \"Rule_Id\",\n    \"remarks\": \"rule_3\"\n  },\n  {\n    \"name\": \"Rule_Description\",\n    \"ns\": \"http://comp_ns\",\n    \"value\": \"comp rule aa 2\",\n    \"class\": \"Rule_Description\",\n    \"remarks\": \"rule_3\"\n  },\n  {\n    \"name\": \"Parameter_Id\",\n    \"ns\": \"http://comp_ns\",\n    \"value\": \"shared_param_1\",\n    \"class\": \"Parameter_Id\",\n    \"remarks\": \"rule_1\"\n  },\n  {\n    \"name\": \"Parameter_Description\",\n    \"ns\": \"http://comp_ns\",\n    \"value\": \"shared param 1 in aa\",\n    \"class\": \"Parameter_Description\",\n    \"remarks\": \"rule_1\"\n  },\n  {\n    \"name\": \"Parameter_Value_Alternatives\",\n    \"ns\": \"http://comp_ns\",\n    \"value\": \"[\\\"shared_param_1_aa_opt_1\\\", \\\"shared_param_1_aa_opt_2\\\"]\",\n    \"class\": \"Parameter_Value_Alternatives\",\n    \"remarks\": \"rule_1\"\n  }\n],\n\"set-parameters\": [\n  {\n    \"param-id\": \"shared_param_1\",\n    \"values\": [\n      \"shared_param_1_aa_opt_1\"\n    ],\n    \"remarks\": \"set shared param aa 1\"\n  }\n]\n</code></pre> <p>In this scheme the rules have a <code>Rule_Id</code> (e.g. <code>comp_rule_aa_1</code> in this example) and an associated tag (<code>rule_2</code>) in the <code>remarks</code> section that binds the name to the description: <code>Rule_Description</code>=<code>comp rule aa 1</code>.  In addition, rules may be associated with parameters specified here with <code>Parameter_id</code>=<code>shared_param_1</code>, <code>Parameter_Description</code>=<code>shared param 1 in aa</code>, and <code>Parameter_Value_Alternatives</code>=<code>[\\\"shared_param_1_aa_opt_1\\\", \\\"shared_param_1_aa_opt_2\\\"]</code>.  <code>Parameter_Value_Alternatives</code> corresponds to possible Choices for the parameter value.</p> <p>Also shown in this JSON excerpt is a normal set-parameter used to set the value of a parameter associated with a rule id.  Thus the setting of the parameter follows the normal OSCAL schema for setting a parameter value, while the specification of the parameter and its options is specified via linked properties.</p> <p>The markdown header lists all the rules that apply to this control, along with their descriptions, and for each implementation response, the rules that apply to it are shown.  The association of an ImplementedRequirement with a rule is again done with properties as shown here:</p> Linking of ImplementedRequirement to a rule <pre><code>{\n  \"implemented-requirements\": [\n    {\n      \"uuid\": \"ca5ea4c5-ba51-4b1d-932a-5606891b7500\",\n      \"control-id\": \"ac-1\",\n      \"description\": \"imp req prose for ac-1 from comp aa\",\n      \"props\": [\n        {\n          \"name\": \"Rule_Id\",\n          \"value\": \"top_shared_rule_1\"\n        },\n        {\n          \"name\": \"implementation-status\",\n          \"value\": \"implemented\"\n        }\n      ]\n    }\n  ]\n}\n</code></pre> <p>The values for rule parameters are specified using the normal <code>SetParameter</code> mechanism in the ControlImplementation, but it's important to note that there are two different types of <code>SetParameter</code>: Those that apply to the normal parameters of the control, and those that apply strictly to the rules.</p> <p>Note that markdown is created for all of the controls in the <code>Component</code> control implementation. However, when processing control parts, the part is only written out if there are associated rules or pre-filled implementation descriptions.</p> <p>In addition, the rules should be regarded as read-only from the editing perspective, and you cannot change the rules associated with a control or its parts.  But you may edit the rule parameter values as described in the comments of the markdown file under <code>x-trestle-comp-def-rules-param-vals</code>.  You may also edit the prose and implementation status associated with a statement part at the bottom of the markdown file.</p> <p><code>trestle author component-assemble</code></p> <p>The <code>component-assemble</code> command will assemble the markdown into a ComponentDefinition file containing all the DefinedComponents in the markdown, and as usual it can either overwrite the original JSON file or create a new one.  Edits made to the prose, status and rule parameter values in the markdown and header will be captured in the assembled file, but the list of rules attached with each ImplementedRequirement is readonly and new rule associations cannot be made via markdown.</p> trestle author ssp-generate and trestle author ssp-assemble <p>The <code>ssp-generate</code> command creates markdown for an SSP (System Security Plan) from a profile, optional component definitions, and optional yaml header file.  <code>ssp-assemble</code> (described below) can then assemble the markdown files into a single json SSP file.  The profile contains a list of imports that are either a direct reference to a catalog, or an indirect reference via a profile. There may be multiple imports of either type, and referenced profiles may themselves import either catalogs or profiles.  Each profile involved may specify the controls that should be imported, along with any modifications to those controls.  This command internally creates a resolved profile catalog and generates a directory containing a set of markdown files, one for each control in the resolved catalog.  Each markdown file has the optional yaml header embedded at the start of the file.</p> <p>The component definitions specify the components of the SSP, along with metadata associated with rules and status for the implemented requirements.  The rules, rule parameters, and status values are encoded by properties within the components as described above for <code>component-generate</code>.</p> <p>Example usage for creation of the markdown:</p> <p><code>trestle author ssp-generate --profile my_prof --compdefs \"compdef_a,compdef_b\" --yaml /my_yaml_dir/header.yaml --output my_ssp</code></p> <p>In this example the profile and component definitions have previously been imported into the trestle directory.  The profile itself must be in the trestle directory, but the imported catalogs and profiles may be URI's with href's as described below.</p> <p>The generated markdown output will be placed in the trestle subdirectory <code>my_ssp</code> with a subdirectory for each control group.</p> <p>If the imported catalogs or profiles are not at the URI pointed to by the Import href of the profile then the href should be changed using the <code>trestle href</code> command.</p> <p>Similar to <code>catalog-generate</code>, the <code>--yaml</code> and <code>--overwrite-header-values</code> flag may be specified to let the input yaml header overwrite values already specified in the header of the control markdown file. Also, the <code>--force-overwrite</code> option can be used to overwrite markdowns with content from JSON.</p> <p>The resulting files look like this:</p> Example of control markdown after ssp-generate <pre><code>---\nx-trestle-comp-def-rules:\n  comp_aa:\n    - name: top_shared_rule_1\n      description: top shared rule 1 in aa\n    - name: comp_rule_aa_1\n      description: comp rule aa 1\n  comp_ab:\n    - name: top_shared_rule_1\n      description: top shared rule 1 in ab\n    - name: comp_rule_ab_1\n      description: comp rule ab 1\n  comp_ba:\n    - name: top_shared_rule_1\n      description: top shared rule 1 in ba\n  comp_bb:\n    - name: top_shared_rule_1\n      description: top shared rule 1 in bb\nx-trestle-rules-params:\n  comp_aa:\n    - name: shared_param_1\n      description: shared param 1 in aa\n      options: '[\"shared_param_1_aa_opt_1\", \"shared_param_1_aa_opt_2\"]'\n      rule-id: top_shared_rule_1\n  comp_ab:\n    - name: shared_param_1\n      description: shared param 1 in ab\n      options: '[\"shared_param_1_ab_opt_1\", \"shared_param_1_ab_opt_2\"]'\n      rule-id: top_shared_rule_1\n  comp_ba:\n    - name: shared_param_1\n      description: shared param 1 in ba\n      options: '[\"shared_param_1_ba_opt_1\", \"shared_param_1_ba_opt_2\"]'\n      rule-id: top_shared_rule_1\n  comp_bb:\n    - name: shared_param_1\n      description: shared param 1 in bb\n      options: '[\"shared_param_1_bb_opt_1\", \"shared_param_1_bb_opt_2\"]'\n      rule-id: top_shared_rule_1\nx-trestle-comp-def-rules-param-vals:\n  # You may set new values for rule parameters by adding\n  #\n  # ssp-values:\n  #   - value 1\n  #   - value 2\n  #\n  # below a section of values:\n  # The values list refers to the values as set by the components, and the ssp-values are the new values\n  # to be placed in SetParameters of the SSP.\n  #\n  comp_aa:\n    - name: shared_param_1\n      values:\n        - shared_param_1_aa_opt_1\n      ssp-values:\n        - shared_param_1_aa_opt_2\n  comp_ab:\n    - name: shared_param_1\n      values:\n        - shared_param_1_ab_opt_2\nx-trestle-set-params:\n  # You may set values for parameters in the assembled SSP by adding\n  #\n  # ssp-values:\n  #   - value 1\n  #   - value 2\n  #\n  # below a section of values:\n  # The values list refers to the values in the resolved profile catalog, and the ssp-values represent new values\n  # to be placed in SetParameters of the SSP.\n  #\n  ac-1_prm_1:\n    values:\n      - comp_prof val 1\n    display-name: AC-1 (a) (1)\n  ac-1_prm_2:\n    values:\n  ac-1_prm_3:\n    values:\n  ac-1_prm_4:\n    values:\n  ac-1_prm_5:\n    values:\n  ac-1_prm_6:\n    values:\n  ac-1_prm_7:\n    values:\nx-trestle-global:\n  profile:\n    title: comp prof aa\n    href: trestle://profiles/comp_prof/profile.json\n  sort-id: ac-01\nx-trestle-add-props:\n  # Add or modify control properties here\n  # Properties may be at the control or part level\n  # Add control level properties like this:\n  #   - name: ac1_new_prop\n  #     value: new property value\n  #\n  # Add properties to a statement part like this, where \"b.\" is the label of the target statement part\n  #   - name: ac1_new_prop\n  #     value: new property value\n  #     smt-part: b.\n  #\n  - name: prop_with_ns\n    value: prop with ns\n    ns: https://my_new_namespace\n  - name: prop_with_no_ns\n    value: prop with no ns\n    ns: https://my_added_namespace\n---\n\n# ac-1 - \\[Access Control\\] Policy and Procedures\n\n## Control Statement\n\nThe organization:\n\n- \\[a.\\] Develop, document, and disseminate to [comp_prof val 1]:\n\n  - \\[1.\\] [Organization-level; Mission/business process-level; System-level] access control policy that:\n\n    - \\[(a)\\] Addresses purpose, scope, roles, responsibilities, management commitment, coordination among organizational entities, and compliance; and\n    - \\[(b)\\] Is consistent with applicable laws, executive orders, directives, regulations, policies, standards, and guidelines; and\n\n  - \\[2.\\] Procedures to facilitate the implementation of the access control policy and the associated access controls;\n\n- \\[b.\\] Designate an [organization-defined official] to manage the development, documentation, and dissemination of the access control policy and procedures; and\n\n- \\[c.\\] Review and update the current access control:\n\n  - \\[1.\\] Policy [organization-defined frequency] and following [organization-defined events]; and\n  - \\[2.\\] Procedures [organization-defined frequency] and following [organization-defined events].\n\n## Control guidance\n\nAccess control policy and procedures address the controls in the AC family that are implemented within systems and organizations. The risk management strategy is an important factor in establishing such policies and procedures. Policies and procedures contribute to security and privacy assurance. Therefore, it is important that security and privacy programs collaborate on the development of access control policy and procedures. Security and privacy program policies and procedures at the organization level are preferable, in general, and may obviate the need for mission- or system-specific policies and procedures. The policy can be included as part of the general security and privacy policy or be represented by multiple policies reflecting the complex nature of organizations. Procedures can be established for security and privacy programs, for mission or business processes, and for systems, if needed. Procedures describe how the policies or controls are implemented and can be directed at the individual or role that is the object of the procedure. Procedures can be documented in system security and privacy plans or in one or more separate documents. Events that may precipitate an update to access control policy and procedures include assessment or audit findings, security incidents or breaches, or changes in laws, executive orders, directives, regulations, policies, standards, and guidelines. Simply restating controls does not constitute an organizational policy or procedure.\n\n______________________________________________________________________\n\n## What is the solution and how is it implemented?\n\n&lt;!-- For implementation status enter one of: implemented, partial, planned, alternative, not-applicable --&gt;\n\n&lt;!-- Note that the list of rules under ### Rules: is read-only and changes will not be captured after assembly to JSON --&gt;\n\n### This System\n\n&lt;!-- Add implementation prose for the main This System component for control: ac-1 --&gt;\n\n#### Implementation Status: planned\n\n### comp_aa\n\nimp req prose for ac-1 from comp aa\n\n#### Rules:\n\n  - top_shared_rule_1\n\n#### Implementation Status: implemented\n\n### comp_ab\n\n&lt;!-- Add control implementation description here for control: ac-1 --&gt;\n\n#### Rules:\n\n  - top_shared_rule_1\n\n#### Implementation Status: implemented\n\n______________________________________________________________________\n\n## Implementation for part a.\n\n### comp_aa\n\nstatement prose for part a. from comp aa\n\n#### Rules:\n\n  - comp_rule_aa_1\n\n#### Implementation Status: partial\n\n### comp_ab\n\n&lt;!-- Add control implementation description here for item a. --&gt;\n\n#### Rules:\n\n  - comp_rule_ab_1\n\n#### Implementation Status: partial\n\n______________________________________________________________________\n</code></pre> <p>\\ Each label in the ssp is wrapped in <code>\\[ \\]</code> to indicate it comes directly from the label in the control and is not generated by the markdown viewer.  Keep in mind that the actual label is the same but with the <code>\\[ \\]</code> removed.</p> <p>Note that for each statement in the control description there is a corresponding response section in which to provide a detailed response for later inclusion in the final ssp as the control implementation.</p> <p>Also note that the optional final sections are provided, and labeled using the title for the corresponding section.</p> <p>In addition, this is the only control markdown where the moustache (<code>{{}}</code>) items have been replaced by the corresponding parameter values in the final resolved profile catalog, surrounded by brackets, so that the prose corresponds to the final intended control and its implementation.</p> <p>The markdown can have guidance per-component in the control, as shown by the line, <code>### ACME Component</code>.  Any prose directly under a <code>##</code> implementation section will apply to the overall system component, but sections in a sub-header of the form <code>###</code> will only apply to that particular component.</p> <p>The <code>--include-all-parts</code> flag controls how the main system component (<code>This System</code>) is written in the markdown. By default, control parts are not written out unless a component has a rule associated with that particular control part or <code>statement</code>. When <code>--include-all-parts</code> is set, all control parts will be written with the main component present under the <code>## Implementation for part &lt;part&gt;</code> section. All other components will still be conditionally added based on the presence of rules.</p> <p>After generating the markdown for the resolved profile catalog you may then edit the files and provide text in the sections with <code>Add control implementation...</code> in them.  But do not remove the horizontal rule lines or modify/remove the lines with <code>###</code> in them, corresponding to system components.</p> <p>If you edit the control markdown files you may run <code>ssp-generate</code> again and your edits will not be overwritten.  When writing out the markdown for a control, any existing markdown for that control will be read and the response text for each part will be re-inserted into the new markdown file.  If the new markdown has added parts the original responses will be placed correctly in the new file, but if any part is removed from the source control json file then any corresponding prose will be lost after the next <code>ssp-generate</code>.</p> <p>The <code>x-trestle-add-props</code> key of the yaml header allows the addition of properties to the implemented requirements under the SSP control implementation, comprising <code>name</code>, <code>value</code>, and optionally a namespace <code>ns</code> value. Similarly to the <code>x-trestle-add-props</code> in profile authoring, the properties may be added at the control level, or attached to a top level statement part by adding a value, <code>smt-part</code> with value <code>a.</code>, <code>b.</code> or any other label for one of the top level statement parts.</p> <p><code>trestle author ssp-assemble</code></p> <p>After manually edting the markdown and providing the responses for the control implementation requirements, the markdown can be assembled into a single json SSP file with:</p> <p><code>trestle author ssp-assemble --markdown my_ssp --compdefs my_compdef_a,my_compdef_b --output my_json_ssp</code></p> <p>This will assemble the markdown files in the my_ssp directory and create a json SSP with name my_json_ssp in the system-security-plans directory.</p> <p>As indicated for <code>ssp-generate</code>, please do not alter any of the horizontal rule lines or lines indicating the part or control id, e.g. <code>### ACME Component</code>.  You may run <code>ssp-generate</code> and <code>ssp-assemble</code> repeatedly for the same markdown directory, allowing a continuous editing and updating cycle.</p> <p>As with all the <code>assemble</code> tools, you may optionally specify a <code>--name</code> for a corresponding json file into which the updates will be inserted, thereby preserving metadata and other aspects of the model.  The result can overwrite the provided model or get directed to a new model.  And the version may be updated and the uuid's regenerated.  As with the other <code>-assemble</code> tools, if an output file already exists, a new one will only be written if there are changes to the model relative to the existing file.  See <code>catalog-assemble</code> for more details.</p> <p>If you do not specify component-defintions during assembly, the markdown should not refer to any components other than <code>This System</code>.  Thus you may first generate markdown with <code>ssp-generate</code> and no component-definitions specified - and then you may assemble that ssp with <code>ssp-assemble</code> and no component-definitions specified - but only if there are no components other than <code>This System</code> referenced in the markdown.  You may add new component implementation details to the markdown later, but any new components must be defined in a component-defintion file, and that file must be specified when <code>ssp-assemble</code> is run.</p> <p><code>ssp inheritance view</code></p> <p>The inheritance view is generated by setting the <code>--leveraged-ssp</code> flag with <code>trestle author ssp-generate</code>. It contains information relating to exported information such as inherited capabilities and customer responsibilities that can be used to populate the inheritance information in the assembled SSP. When used, a directory named \"inheritance\" is created within the markdown directory. This directory serves as a designated space for  mapping inherited capabilities and responsibilities onto components in the assemble SSP and authoring satisfied statements for responsibilities.</p> <p>Example usage for creation of the markdown:</p> <p><code>trestle author ssp-generate --profile my_prof --compdefs \"compdef_a,compdef_b\" --yaml /my_yaml_dir/header.yaml --leveraged-ssp my_provider_ssp --output my_ssp</code></p> <p>In this example the leveraged ssp has previously been imported into the trestle directory, but it can be fetched from remote location.</p> <p>The generated markdown output with the inheritance view will be placed in the trestle subdirectory <code>my_ssp/inheritance</code> with a subdirectory for each component in the leveraged ssp with directories separated by control and statement id below.</p> <p>An example of this directory structure is below.</p> <pre><code>.\n\u251c\u2500\u2500 Application\n\u2502   \u251c\u2500\u2500 ac-1_stmt.a\n\u2502   \u2502   \u2514\u2500\u2500 11111111-0000-4000-9009-001001002006.md\n\u2502   \u251c\u2500\u2500 ac-2.1\n\u2502   \u2502   \u2514\u2500\u2500 11111111-0000-4000-9009-001001002004.md\n\u2502   \u2514\u2500\u2500 ac-2_stmt.a\n\u2502       \u2514\u2500\u2500 11111111-0000-4000-9009-002001002001_11111111-0000-4000-9009-002001002002.md\n\u2514\u2500\u2500 This System\n    \u251c\u2500\u2500 ac-1_stmt.a\n    \u2502   \u2514\u2500\u2500 11111111-0000-4000-9009-001002002001.md\n    \u251c\u2500\u2500 ac-2.1\n    \u2502   \u2514\u2500\u2500 11111111-0000-4000-9009-001001002001.md\n    \u2514\u2500\u2500 ac-2_stmt.a\n        \u2514\u2500\u2500 11111111-0000-4000-9009-002001001001.md\n</code></pre> <p>The leveraged components are used as the top level directory to allow any non-leveraged components to be easily skipped or removed. Each markdown file is named in accordance with the uuid of the exported statement to ensure statement description updates can be applied.</p> <p>There are three types of markdown files that can be generated from this process.</p> <p>The examples below demonstrate these types:</p> Example of inheritance provided only markdown after ssp-generate <pre><code>---\nx-trestle-statement:\n  # Add or modify leveraged SSP Statements here.\n  provided-uuid: 11111111-0000-4000-9009-001002002001\nx-trestle-leveraging-comp:\n  # Leveraged statements can be optionally associated with components in this system.\n  # Associate leveraged statements to Components of this system here:\n  - name: REPLACE_ME\n---\n\n# Provided Statement Description\n\nCustomer_appropriate description of what may be inherited.\n</code></pre> Example of inheritance customer responsibility only markdown after ssp-generate <pre><code>---\nx-trestle-statement:\n  # Add or modify leveraged SSP Statements here.\n  responsibility-uuid: 11111111-0000-4000-9009-002001001001\nx-trestle-leveraging-comp:\n  # Leveraged statements can be optionally associated with components in this system.\n  # Associate leveraged statements to Components of this system here:\n  - name: REPLACE_ME\n---\n\n# Responsibility Statement Description\n\nLeveraging system's responsibilities with respect to inheriting this capability.\n\n# Satisfied Statement Description\n\n&lt;!-- Use this section to explain how the inherited responsibility is being satisfied. --&gt;\n</code></pre> Example of inheritance shared responsibility markdown after ssp-generate <pre><code>---\nx-trestle-statement:\n  # Add or modify leveraged SSP Statements here.\n  provided-uuid: 11111111-0000-4000-9009-002001002001\n  responsibility-uuid: 11111111-0000-4000-9009-002001002002\nx-trestle-leveraging-comp:\n  # Leveraged statements can be optionally associated with components in this system.\n  # Associate leveraged statements to Components of this system here:\n  - name: REPLACE_ME\n---\n\n# Provided Statement Description\n\nConsumer-appropriate description of what may be inherited.\n\n# Responsibility Statement Description\n\nLeveraging system's responsibilities with respect to inheriting this capability.\n\n# Satisfied Statement Description\n\n&lt;!-- Use this section to explain how the inherited responsibility is being satisfied. --&gt;\n</code></pre> <p>Some additional information and tips about this markdown are below:</p> <ul> <li>Do not change the statement UUIDs in the YAML header. This is used in the assembled JSON to link the statements in the leveraged SSP to the components in the leveraging SSP.</li> <li>When mapping components in the YAML header, use the component title. If you do not wish to map a component to a particular inherited capability or responsibility, just leave the file as is. Files without mapped components or that contain the default \"REPLACE ME\" entry will be skipped.</li> <li>If the file exists, just the editable information will be preserved when regenerating existing inheritance view markdown. This includes the information under <code>Satisfied Statement Description</code> and the mapped components in the YAML header.</li> </ul> <p>After manually editing the inheritance view markdown, the <code>trestle author ssp-assemble</code> command can be run without modifications for the inheritance view use case. During assemble, the inheritance directory is detected and the information will be assembled into the SSP. The by-component assemblies will be updated or added under existing implemented requirement or statement sections with the information from the markdown.</p> trestle author ssp-filter <p>Once you have an SSP in the trestle directory you can filter its contents with a profile, list of components, list of implementation statuses, or list control origination values by using the command <code>trestle author ssp-filter</code>.  The SSP is assumed to contain a superset of the controls needed by the profile if a profile is specified, and the filter operation will generate a new SSP with only those controls needed by the profile.  If a list of component names is provided, only the specified components will appear in the system implementation of the ssp. If a list of implementation statuses is provided, controls with implementations including those statuses will appear in the control implementation of the ssp. Similarly, if a list of control origination values is provided, implemented requirements with a control origination property value included in the provided values will appear in the control implementation of the ssp.</p> <p>The filter command is invoked as:</p> <p><code>trestle author ssp-filter --name my_ssp --profile my_profile --components comp_a:comp_b --implementation-status \"planned,partial\" --control-origination \"customer-configured\" --output my_culled_ssp</code></p> <p>The SSP must be present in the trestle workspace and, if filtering by profile, that profile must also be in the trestle workspace. This command will generate a new SSP in the workspace. If the profile makes reference to a control not in the SSP then the routine will fail with an error message.  Similarly, if one of the components is not present in the ssp the routine will also fail. The implementation statuses must be one of the allowed values as defined in the OSCAL SSP JSON format reference. Those include the following: implemented, partial, planned, alternative, and not-applicable. If an invalid value is provided, an error is returned. The control origination values also must be one of the allowed values as defined in the OSCAL SSP JSON format reference. Those include the following: system-specific, inherited, customer-configured, customer-provided, and organization. If an invalid value is provided, an error is returned.</p> Summary of options used by the catalog, profile, component and ssp authoring tools. <p>The provided options for the generation and assembly of documents in the ssp workflow is rich and powerful, but can also be confusing.  To help see how they all relate please consult the following diagram showing the required and optional command line arguments for each command.  The checkboxes indicate required and the open circles represent optional.</p> <p>The options shown are fairly consistent across the <code>-generate</code> and <code>-assemble</code> functions, but some clarification may be needed.  For <code>catalog-assemble</code> and <code>profile-assemble</code> you have the option to use an existing json file as a parent model into which new content is inserted - in memory - and the final model may either be written back into that same json file, or a different one - based on <code>--output</code>.  If you just want to keep editing and modifying the same original json file you can specify <code>--name</code> and <code>--output</code> to be the same, original json file.  But you could also direct it to a new json file while still using an original file as the \"parent.\"  A key benefit of referencing an original json file is the resuse of metadata and backmatter - along with everything else separate from the controls.</p> <p><code>ssp-generate</code> is special because it starts with a profile rather than an ssp, whereas <code>catalog-generate</code> and <code>profile-generate</code> both start with a parent model of the same type.  Nonetheless, you still have an option during <code>ssp-assemble</code> to use a given json file as the template into which new content is inserted, and once again you may overwrite that original json file or direct it to a new one using <code>--output</code>.</p> <p></p>"},{"location":"tutorials/Trestle_authoring/trestle_author/","title":"Trestle CLI for Governance of Authored Documents","text":"<p>This document is organized in a multiple collapsable sections for ease of use. Start by reading the overview and setting up the Trestle workspace and then proceed to other sections, to learn more about Trestle authoring capabilities.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#contents","title":"Contents","text":"1. Overview 2. Setting up the Trestle workspace 3. Authoring of Documents Documents Structural Enforcement 4. Authoring of OSCAL Models"},{"location":"tutorials/Trestle_authoring/trestle_author/#overview","title":"Overview","text":"<p>The premise of trestle is to support managing compliance artifacts as code. When this is considered, many organisations using <code>{github|gitlab|bitbucket}</code> rely on markdown documents for documentary artifacts that may either directly or indirectly support compliance efforts.</p> <p>To support this, trestle has the concept of 'governing' documents that are authored documents: Where structural conditions are enforced on the markdown documents to allow automation and to ensure business processes are met.</p> <p>Living in the <code>GitOps</code> world this capability is anchored with <code>markdown</code> files as the core of the workflows. Currently <code>drawio</code> files are also supported for a subset of enforcement mechanisms.</p> Setting Up Templates and Documents Via CLI <p>Trestle allows the setup of templates and governed documents in a several different ways based on the nature of the needed governance.</p> <p>Definitions used in this section:</p> <ul> <li>document - a markdown or drawio file that needs to be validated against some template.</li> <li>template - an individual markdown or drawio file containing metadata and/or headings against which the documents will be validated.</li> <li>task - a name of the folders containing documents and their respective templates.</li> <li>template folder - an individual folder containing the templates that documents needs to be validated against.</li> </ul> <p>You can set up multiple different tasks and types of validations in the same workspace.</p> <p>Setup Trestle for:</p> docs - Validating documents against one specific template (one template per task) Template Versioning"},{"location":"tutorials/Trestle_authoring/trestle_author/#why-is-this-capability-in-trestle","title":"Why is this capability in trestle?","text":"<p>While trestle provides editing support for OSCAL there is an unfortunate truth that for some compliance workflows:</p> <ol> <li>OSCAL does not cover the lower level operational workflows.</li> <li>Some users will not be comfortable editing in json/yaml/xml formats</li> </ol> <p>The markdown centric workflows allow transition path where capability is being developed</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#setting-up-the-trestle-workspace","title":"Setting up the Trestle workspace","text":"<p>To work with governed documents, you would need to initialize the Trestle workspace and create your first governed document and template.</p> <p>To create a trestle workspace that will contain all your templates and governed documents:</p> <pre><code>mkdir my_workspace\ncd my_workspace\ntrestle init --govdocs\n&gt;&gt;&gt; Initialized trestle project successfully in [user_path]/my_workspace\n</code></pre> <p>The templates will be located in the <code>/my_workspace/.trestle/author/</code>. Please note that if you use MacOS or Linux distribution, by default <code>.trestle</code> will be hidden. You will need to reconfigure your system to show hidden folders if you want to see them listed.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#markdown-structural-enforcement","title":"Markdown structural enforcement","text":"<p>Trestle templating enforces the documents to follow a specific structure. There are two ways in which structure is enforced in a document against template:</p> <ol> <li>Enforcing a YAML header (metadata) structure at the top of the markdown document.</li> <li>Enforcing a heading structure within the markdown document.</li> </ol> <p>Each document is validated against a specific template, see CLI section below on information on how to specify which template the document should be validated against.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#enforcing-yaml-header-metadata-structure","title":"Enforcing YAML header (metadata) structure","text":"<p>Each template and document contains metadata in form of a YAML header that is placed on top. When the document is created (i.e. <code>trestle docs setup</code>) the metadata is copied from the template to the newly created document.</p> <p>Below is an example of a markdown file that contains YAML header:</p> <pre><code>---\ngroceries:\ngrocery1:\n  name: apple\n  type: fruit\n  bought-in: Local market\ngrocery2:\n  name: potato\n  type: vegetable\n  bought-in: Local market\ndate: 01-01-2022\nnot-important-field: not important\nx-trestle-version: 1.0.0\nx-trestle-ignore: not-important-field, bought-in\n---\n# The rest of my document\n</code></pre> <p>Each field in the YAML header follows the <code>key: value</code> format. For YAML header we validate the structure and the presence of the \"keys\" and not the \"values\".</p> <p>The document YAML header(metadata) is said to be valid against the template, if and only if:</p> <ol> <li>It contains all keys from the template EXCEPT the keys that either:</li> <li>Start with <code>x-trestle</code></li> <li>Are listed under the <code>x-trestle-ignore</code> key (i.e. <code>x-trestle-ignore: not-important-field, bought-in</code>)</li> <li>The version under <code>x-trestle-template-version:</code> key is matching the template.</li> <li>No new keys were added to the document.</li> </ol> <p>For example, this change to the YAML header above is acceptable:</p> <pre><code>---\ngroceries:\n  grocery1:\n      name: pear\n      type: fruit\n      bought-in: Superstore\n  grocery2:\n      name: potato\n      type: vegetable\n      bought-in: Local market\ndate: 10-10-2023\nnot-important-field: not important\nx-trestle-version: 1.0.0\nx-trestle-ignore: not-important-field, bought-in\n---\n# The rest of my document\n</code></pre>"},{"location":"tutorials/Trestle_authoring/trestle_author/#enforcing-heading-structure","title":"Enforcing heading structure","text":"<p>Markdown headings are considered to be nested based on the heading level (i.e. number of <code>#</code>). For example, <code>## 1.1 Lower level heading</code> is below <code># 1. top level heading</code>.</p> <p>The document body is said to be valid against the template, if and only if,</p> <ol> <li>It contains all the headings provided in the template.</li> <li>No new headings were added at the top level (i.e. <code># New heading</code> is not allowed).</li> <li>All original headings are in the same order as in the template.</li> <li>All headings must be in the hierarchical order (i.e. <code># Heading</code> then <code>### Heading</code> then <code>## Heading</code> is invalid).</li> <li>If the <code>--governed-heading</code> option is provided, then document is valid if no keys has changed in the specified governed section.</li> </ol> <p>For example, consider this template as our starting point:</p> <pre><code># Template heading 1\nSome text\n# Template heading 2\n## Template sub heading\n</code></pre> <p>Now we added new sections and ended up with the following document: (note: this document will be valid against the template above)</p> <pre><code># Template heading 1\nContent for heading one\n## Non-required sub header\nContent for non-required sub header\n# Template heading 2\nContent for heading two\n## Template sub heading\nContent for template sub heading\n### non required sub-sub heading\nThis sub-sub heading is okay\n</code></pre> <p>However, violations such as adding or removing a heading at the top level are not acceptable:</p> <pre><code># Template heading 1\nContent for heading one\n## Non-required sub header\nContent for non-required sub header\n# Template heading 2\nContent for heading two\n## Template sub heading\nContent for template sub heading\n# Top level heading that is not okay &lt;&lt;&lt; NOT OKAY\n</code></pre> <p>For each of the headings - the text of the heading is enforced with one caveat:</p> <ul> <li>If the template heading text is wrapped in curly brackets <code>{}</code> then the name is not measured e.g. <code># {Insert title here}</code>.</li> </ul> folders - Validating documents against multiple templates and ensuring folder structure (multiple individual templates per task)  headers - Validate only the headers against a global or a specific template"},{"location":"tutorials/Trestle_authoring/trestle_author/#drawio-enforcement-mechanisms","title":"Drawio enforcement mechanisms","text":"<p>Drawio or diagrams.net is a diagramming platform which has significant use for architecture diagrams. In the context of governance of content, trestle is supporting enforcement of metadata.</p> <p>Drawio (or <code>mxgraph</code>) files have a set of data fields. In a drawio file this is available in the edit menu as edit data. The diagram below shows how to access the (meta)data.</p> <p></p> <p>The data presents as a set of key-value pairs which can be edited (see below). The data is bound to each tab in a drawio file. The trestle CLI currently expects that metadata (whether from the template or file to be measured) is in the first tab when editing the draw io file.</p> <p></p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-documents-against-one-specific-template","title":"Validating documents against one specific template","text":"<p>In this section we describe the functionality of <code>trestle author docs</code> command.</p> <p><code>author docs</code> is designed to support enforcing and generating templating markdown files within a single folder based on a task name. Currently <code>author docs</code> supports markdown files only.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#creating-new-tasktemplate","title":"Creating new task/template","text":"<p>To create a new task with the necessary directory structures for running governed docs validation, run:</p> <p>trestle author docs setup -tn my_task_name</p> <p>This will create a template folder and a single template: <code>TRESTLE_ROOT/.trestle/author/my_task_name/0.0.1/template.md</code>. As well as an empty document folder: <code>TRESTLE_ROOT/my_task_name/</code> The template will be applied to all markdown files in the task i.e.: <code>TRESTLE_ROOT/my_task_name/*.md</code>.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options","title":"Extra options","text":"<ul> <li>You can create different versions of the template by specifying the version via <code>--template-version</code> flag. See <code>Template Versioning</code> section for more information.   By default if no version is provided <code>0.0.1</code> will be used.</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#creating-new-document-for-the-task","title":"Creating new document for the task","text":"<p>To create a new document that confirms to a template run:</p> <p>trestle author docs create-sample -tn my_task_name</p> <p>This will create a sample document in: <code>TRESTLE_ROOT/my_task_name/my_task_name_000.md</code>. Once created this document will be a complete copy of the template, however you can modify this file with your own content.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_1","title":"Extra options","text":"<ul> <li>This command has no extra options</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-the-template","title":"Validating the template","text":"<p>To ensure that the markdown in the template is parseable run:</p> <p>trestle author docs template-validate -tn my_task_name</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_2","title":"Extra options","text":"<ul> <li>If <code>--governed-heading 'heading name'</code> (<code>-gh</code>) is passed it ensures that the required heading exists.</li> <li>If <code>--header-validate</code> (<code>-hv</code>) is passed the header will be validated as well.</li> <li>If <code>--header-only-validate</code> (<code>-hov</code>) only the header and NOT the body will be validated</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-the-documents-against-the-template","title":"Validating the documents against the template","text":"<p>To validate the documents against a template run:</p> <p>trestle author docs validate -tn my_task_name</p> <p>This will take the <code>TRESTLE_ROOT/.trestle/author/my_task_name/template.md</code> template and validate all markdown files here: <code>TRESTLE_ROOT/my_task_name/*.md</code>.</p> <p>Running the command will validate that markdown body in the document is valid against the template. Please note that by default the header will not be validated. See extra options for more validation options. To learn more on what exactly is validated please refer to <code>Documents Structural Enforcement</code> section in this document.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_3","title":"Extra options","text":"<ul> <li>If <code>--governed-heading</code> (<code>-gh</code>) is passed it will ensure that the governed content was not modified. Governed content comes in the key: value format:</li> </ul> <pre><code>     # Governed section\n     **Content Type:**  Foo\n     **Author(s):**  Bah\n     **Executive Owner:**  Stuff\n     **Technical Approver:**   John Doe (approved)\n     **Version:** 1.0.1\n</code></pre> <p>Running <code>trestle author docs validate -tn docs_task -gh=\"Governed section\"</code> will ensure this content is present in the document.</p> <ul> <li>If <code>--ignore ^_.*</code> (<code>-ig</code>) is passed it will validate all files except folders and files that start with underscore <code>_</code>. Use this option when you would like to ignore any folders or files that match given regular expression.</li> <li>If <code>--header-validate</code> (<code>-hv</code>) is passed the header will be validated as well.</li> <li>If <code>--header-only-validate</code> (<code>-hov</code>) is passed only the header and NOT the body will be validated.</li> <li>If <code>--readme-validate</code> (<code>-rv</code>) is passed README.md will be validated as well, otherwise it is ignored.</li> <li>If <code>--recurse</code> (<code>-r</code>) is passed the documents in the subfolders will also be validated. By default <code>author docs</code> only indexes a flat directory.</li> <li>If <code>--template-version 1.0.0</code> (<code>-tv</code>) is passed the header field <code>x-trestle-template-version</code> will be ignored and document will be forcefully validated against template of version <code>1.0.0</code>.   Use this for testing purposes only when you need to validate the document against a specific template. By default the template version will be determined based on <code>x-trestle-template-version</code> in the document.</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-the-documents-against-different-templates","title":"Validating the documents against different templates","text":"<p>Validation against multiple templates can be done when there is a scenario where you have multiple templates that will have multiple instances. In this particular case you can have a 1:1 relationship between the template and the instance document you are creating out of it, so validation can be performed based on template type and version of that particular template defined in headers.</p> <p>For that to happen you will need to provide your template with the following parameter at the yaml header level, matching the type of template to be implemented so that the validation can occur:</p> <p>x-trestle-template-type: insert_template_type_here</p> <p>Please, take into consideration that for the validation to happen you will also need to provide each instance document in the task folder a field called <code>x-trestle-template-type: insert_template_type_here</code> in the yaml header matching with the template name.</p> <pre><code>---\nauthors: tmp\nowner: tmp\nvalid:\n  from: null\n  to: null\nx-trestle-template-type: insert_template_type_here\n---\n</code></pre> <p>With that, you will be able to create more than 1 instance document per template and give the instance the desired name.</p> <p>For instance, let\u00b4s consider the next folder structure:</p> <pre><code>trestle_root\n\u2523 .trestle\n\u2503 \u2523 author\n\u2503 \u2503 \u2523 my_task_2\n\u2503 \u2503 \u2503 \u2523 0.0.1\n\u2503 \u2503 \u2503 \u2503 \u2523 a_template.md\n\u2503 \u2503 \u2503 \u2503 \u2523 another_template.md\n\u2503 \u2503 \u2503 \u2503 \u2517 arhitecture.drawio\n\u2503 \u2517 config.ini\n\ntrestle_root\n \u2523 .trestle\n \u2523 my_task_2\n \u2503 \u2523 sample_folder_0\n \u2503 \u2503 \u2523 a_template_1.md\n \u2503 \u2503 \u2523 a_template_2.md\n \u2503 \u2503 \u2523 arhitecture_1.drawio\n \u2503 \u2503 \u2517 another_template_123.md\n</code></pre> <p>If you noticed, names are no longer needed to match with exact template names, and that\u00b4s because validation will run through <code>x-trestle-template-type</code> field defined at the instance header, not through the name.</p> <p>To validate the documents against their respective templates using <code>x-trestle-template-type</code>, run:</p> <p>trestle author docs validate -tn my_task_name -vtt</p> <p>Now, <code>-vtt</code> stands for validate template type. Validate template type option will provide you the ability to have more than 1 instance per template validated.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-against-multiple-templates","title":"Validating against multiple templates","text":"<p>In this section we describe the functionality of <code>trestle author folders</code> command.</p> <p><code>author folders</code> is designed to allow the assembly of groups of templates where each folder contains unique content. This command will validate that both: structure (i.e. all template documents are present) and content is preserved in the folder. Trestle author folders supports validation of both markdown and drawio files. Note that headers / metadata must be specified in each applicable template.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#creating-new-task-folder","title":"Creating new task folder","text":"<p>To create a new task folder run:</p> <p>trestle author folders setup -tn my_task_2</p> <p>This will create a template folder with the following structure:</p> <pre><code>trestle_root\n\u2523 .trestle\n\u2503 \u2523 author\n\u2503 \u2503 \u2523 my_task_2\n\u2503 \u2503 \u2503 \u2523 0.0.1\n\u2503 \u2503 \u2503 \u2503 \u2523 a_template.md\n\u2503 \u2503 \u2503 \u2503 \u2523 another_template.md\n\u2503 \u2503 \u2503 \u2503 \u2517 arhitecture.drawio\n\u2503 \u2517 config.ini\n</code></pre> <p>Each task folder is required to meet template requirements for all: <code>a_template.md</code>, <code>another_template.md</code>, and <code>template.drawio</code>. The names, numbers, and nesting of folders is user specifiable, however, unlike <code>docs</code> the names must be carried over to each instances.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_4","title":"Extra options","text":"<ul> <li>You can create different versions of the template by specifying the version via <code>--template-version</code> flag. See <code>Template Versioning</code> section for more information.   By default if no version is provided <code>0.0.1</code> will be used.</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#creating-new-documents-for-the-task","title":"Creating new documents for the task","text":"<p>Following the similar structure of <code>docs</code>, measurement occurs in the <code>my_task_2</code> where this structure is enforced for every directory.</p> <p>To create a new folder with documents for the task run:</p> <p>trestle author folders create-sample -tn my_task_2</p> <p>This will create a subfolder in the <code>my_task_2</code> with the same content as in template folder. Running it twice will result in:</p> <pre><code>trestle_root\n \u2523 .trestle\n \u2523 my_task_2\n \u2503 \u2523 sample_folder_0\n \u2503 \u2503 \u2523 a_template.md\n \u2503 \u2503 \u2523 arhitecture.drawio\n \u2503 \u2503 \u2517 another_template.md\n\n \u2503 \u2517 sample_folder_1\n \u2503 \u2503 \u2523 a_template.md\n \u2503 \u2503 \u2523 arhitecture.drawio\n \u2503 \u2503 \u2517 another_template.md\n</code></pre>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_5","title":"Extra options","text":"<ul> <li>This command has no extra options</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-the-templates","title":"Validating the templates","text":"<p>To validate the documents against the template run:</p> <p>trestle author folders template-validate -tn my_task_2</p> <p>This will ensure that the respective template files are parseable.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_6","title":"Extra options","text":"<ul> <li>This command has no extra options</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-the-documents-against-templates","title":"Validating the documents against templates","text":"<p>The validation in <code>trestle author folder</code> runs similarly as in <code>docs</code> but now each document will be validated against the template with the same name as in the template folder.</p> <p>To validate the documents against their respective templates, run:</p> <p>trestle author folders validate -tn my_task_name</p> <p>This will validate all files. Please note that all files from the template folder must be present in the individual document folders.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_7","title":"Extra options","text":"<ul> <li>If <code>--governed-heading</code> (<code>-gh</code>) is passed it will ensure that the governed content was not modified. Governed content comes in the key: value format:   <pre><code>   # Governed section\n   **Content Type:**  Foo\n   **Author(s):**  Bah\n   **Executive Owner:**  Stuff\n   **Technical Approver:**   John Doe (approved)\n   **Version:** 1.0.1\n</code></pre></li> </ul> <p>Running <code>trestle author docs validate -tn docs_task -gh=\"Governed section\"</code> will ensure this content is present in the document.</p> <ul> <li>If <code>--ignore ^_.*</code> (<code>-ig</code>) is passed it will validate all files except folders and files that start with underscore <code>_</code>. Use this option when you would like to ignore any folders or files that match given regular expression.</li> <li>If <code>--header-validate</code> (<code>-hv</code>) is passed the header will be validated as well.</li> <li>If <code>--header-only-validate</code> (<code>-hov</code>) is passed only the header and NOT the body will be validated.</li> <li>If <code>--readme-validate</code> (<code>-rv</code>) is passed README.md will be validated as well, otherwise it is ignored.</li> <li>If <code>--recurse</code> (<code>-r</code>) is passed the documents in the subfolders will also be validated. By default <code>author docs</code> only indexes a flat directory.</li> <li>If <code>--template-version 1.0.0</code> (<code>-tv</code>) is passed the header field <code>x-trestle-template-version</code> will be ignored and document will be forcefully validated against template of version <code>1.0.0</code>.   Use this for testing purposes only when you need to validate the document against a specific template. By default the template version will be determined based on <code>x-trestle-template-version</code> in the document.</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-the-documents-against-different-templates_1","title":"Validating the documents against different templates","text":"<p>Validation against multiple templates as stated before can be done, but there is another scenario that you can leverage on trestle to have multiple documents in the task folder corresponding to a single template.</p> <p>For that to happen you will need to provide your template with the following parameter at the yaml header level, matching the type of template to be implemented so the validation can occur:</p> <p>x-trestle-template-type: insert_template_type_here</p> <p>Please, take into consideration that for the validation to happen you will also need to provide each instance document in the task folder a field called <code>x-trestle-template-type: insert_template_type_here</code> in the yaml header matching with the template name.</p> <pre><code>---\nauthors: tmp\nowner: tmp\nvalid:\n  from: null\n  to: null\nx-trestle-template-type: insert_template_type_here\n---\n</code></pre> <p>With that, you will be able to create more than 1 instance document per template and give the instance the desired name.</p> <p>For instance, let\u00b4s consider the next folder structure:</p> <pre><code>trestle_root\n\u2523 .trestle\n\u2503 \u2523 author\n\u2503 \u2503 \u2523 my_task_2\n\u2503 \u2503 \u2503 \u2523 0.0.1\n\u2503 \u2503 \u2503 \u2503 \u2523 a_template.md\n\u2503 \u2503 \u2503 \u2503 \u2523 another_template.md\n\u2503 \u2503 \u2503 \u2503 \u2517 arhitecture.drawio\n\u2503 \u2517 config.ini\n\ntrestle_root\n \u2523 .trestle\n \u2523 my_task_2\n \u2503 \u2523 sample_folder_0\n \u2503 \u2503 \u2523 a_template_1.md\n \u2503 \u2503 \u2523 a_template_2.md\n \u2503 \u2503 \u2523 arhitecture_1.drawio\n \u2503 \u2503 \u2517 another_template_123.md\n</code></pre> <p>If you noticed, names are no longer needed to match with exact template names, and that\u00b4s because validation will run through <code>x-trestle-template-type</code> field defined at the instance header, not through the name.</p> <p>To validate the documents against their respective templates using <code>x-trestle-template-type</code>, run:</p> <p>trestle author folders validate -tn my_task_name -vtt</p> <p>Now, <code>-vtt</code> stands for validate template type. Validate template type option will provide you the ability to have more than 1 instance per template validated.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validate-only-the-headers-against-a-global-or-a-specific-template","title":"Validate only the headers against a global or a specific template.","text":"<p>In this section we describe the functionality of <code>trestle author headers</code> command.</p> <p>Trestle author headers supports a slightly different usecase than that of <code>docs</code> and <code>folders</code> above as only the YAML headers will be validated. This command can be useful when one does not care about the markdown structure and might want to use global templates (templates that are shared across multiple tasks).</p> <p>With <code>headers</code> template folder can contain both .md and .drawio files and each file will be validated against the template that matches the extension. Also <code>headers</code> allow user to have <code>global</code> templates that can be shared across multiple tasks.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#creating-new-tasktemplate_1","title":"Creating new task/template","text":"<p>To create a new task run:</p> <p>trestle author headers setup -tn my_task_3</p> <p>This will create a template folder with the following format:</p> <pre><code>trestle_root\n\u2523 .trestle\n\u2503 \u2523 author\n\u2503 \u2503 \u2523 my_task_3\n\u2503 \u2503 \u2503 \u2523 0.0.1\n\u2503 \u2503 \u2503 \u2503 \u2523 template.md\n\u2503 \u2503 \u2503 \u2503 \u2517 template.drawio\n\u2503 \u2517 config.ini\n</code></pre>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_8","title":"Extra options","text":"<ul> <li>If <code>--global</code> (<code>-g</code>) is passed then <code>__global__</code> then it will create <code>trestle_root/.trestle/author/__global__</code> folder. Use this when you would like to use same template for multiple tasks.   <pre><code>trestle_root\n\u2523 .trestle\n\u2503 \u2523 author\n\u2503 \u2503 \u2523 __global__\n\u2503 \u2503 \u2503 \u2523 0.0.1\n\u2503 \u2503 \u2503 \u2503 \u2523 template.md\n\u2503 \u2503 \u2503 \u2503 \u2517 template.drawio\n\u2503 \u2517 config.ini\n</code></pre></li> <li>You can create different versions of the template by specifying the version via <code>--template-version</code> flag. See <code>Template Versioning</code> section for more information.   By default if no version is provided <code>0.0.1</code> will be used.</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#creating-new-documents","title":"Creating new documents","text":"<p>As of now this command does not support the automatic creation of the sample documents.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-the-templates_1","title":"Validating the templates","text":"<p>To validate the documents against the template run:</p> <p>trestle author headers template-validate -tn my_task_3</p> <p>This will ensure that the respective template files are parseable.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_9","title":"Extra options","text":"<ul> <li>This command has no extra options</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#validating-the-documents","title":"Validating the documents","text":"<p>To validate the documents against the template run:</p> <p>trestle author headers validate -tn my_task_3</p> <p>This will validate all files within the directory against the templates (of the matching task name) by matching the extensions. Please note that only headers will be validated. There is no option to validate the body.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#extra-options_10","title":"Extra options","text":"<ul> <li>If <code>--global</code> (<code>-g</code>) is passed it will create <code>trestle_root/.trestle/author/__global__</code> folder. Use this when you would like to use same template for multiple tasks.</li> <li>If <code>--ignore ^_.*</code> (<code>-ig</code>) is passed it will validate all files except folders and files that start with underscore <code>_</code>. Use this option when you would like to ignore any folders or files that match given regular expression.</li> <li>If <code>--readme-validate</code> (<code>-rv</code>) is passed README.md will be validated as well, otherwise it is ignored.</li> <li>If <code>--recurse</code> (<code>-r</code>) is passed the documents in the subfolders will also be validated. By default <code>author docs</code> only indexes a flat directory.</li> <li>If <code>--template-version 1.0.0</code> (<code>-tv</code>) is passed the header field <code>x-trestle-template-version</code> will be ignored and document will be forcefully validated against template of version <code>1.0.0</code>.   Use this for testing purposes only when you need to validate the document against a specific template. By default the template version will be determined based on <code>x-trestle-template-version</code> in the document.</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author/#template-versioning","title":"Template versioning","text":""},{"location":"tutorials/Trestle_authoring/trestle_author/#prerequisite","title":"Prerequisite:","text":"<p>This section assumes that you have an existing Trestle workspace initialized, with existing template and governed documents. Please follow steps in the section <code>Setting up the Trestle Workspace</code> if you don't have one.</p> <p>Trestle provides the capability to version the templates and the documents via <code>x-trestle-template-version</code> field in the header.</p> <p>Consider an example where we have a governed document called <code>Decision 1</code> that we now need to update to contain a new header field <code>approved-status</code> and a new required heading <code>Heading n</code> at the end, as demonstrated in the Figure below: </p> <p>The intended workflow in this scenario is to:</p> <p>1.Create a new version of the <code>decisions</code> template:</p> <pre><code>cd my_workspace \ntrestle author docs setup -tn decisions -tv 0.1.1\n&gt;&gt;&gt; Set template version to 0.1.1.\n&gt;&gt;&gt; Template file setup for task decisions at .trestle/author/decisions/0.1.1/template.md\n&gt;&gt;&gt; Task directory is decisions\n</code></pre> <p>Add the new required content to the newly created template. In our example simply copy-paste all content from the <code>.trestle/author/decisions/0.1.0/template.md</code> and add the newly required fields.</p> <p>2.Create a new instance of that template.</p> <pre><code>trestle author docs create-sample -tn decisions -tv 0.1.1\n&gt;&gt;&gt; Set template version to 0.1.1.\n</code></pre> <p>This step will create a copy of the template of version 0.1.1.</p> <p>Now you will need to fill the documents with the updated information and new fields.</p> <p>3.(Optional) Delete the old document.</p> <p>Now that you have a new version of the document, you can delete the old one if you no longer need it. You can also keep it if you would like to maintain a history of updates.</p> <p>4.Run validation.</p> <p>After filling the contents to the new version of the template, you can run the validation to ensure that everything works as expected.</p> <pre><code>trestle author docs validate -tn decisions\n&gt;&gt;&gt; Instances will be validated against template version specified in their headers.\n&gt;&gt;&gt; VALID: decisions/decision_000.md\n</code></pre>"},{"location":"tutorials/Trestle_authoring/trestle_author/#oscal-authoring","title":"OSCAL Authoring","text":""},{"location":"tutorials/Trestle_authoring/trestle_author/#catalog-authoring","title":"Catalog authoring","text":"<p>CLI evocation:</p> <ol> <li>To generate markdowns for editing a catalog</li> </ol> <p>trestle author catalog-generate</p> <ol> <li>To assemble markdowns to a JSON catalog</li> </ol> <p>trestle author catalog-assemble</p> <p>The <code>catalog</code> author commands allow you to convert a control catalog to markdown and edit its control statement, then assemble markdown back into an OSCAL catalog with the modifications to the statement.  Items in the statement may be edited or added.  For more details on its usage please see the catalog authoring tutorial.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#profile-authoring","title":"Profile authoring","text":"<p>CLI evocation:</p> <ol> <li>To generate markdowns for editing a profile</li> </ol> <p>trestle author profile-generate</p> <ol> <li>To assemble markdowns to a JSON profile</li> </ol> <p>trestle author profile-assemble</p> <p>The <code>profile</code> author commands allow you to edit additions made by a profile to its imported controls that end up in the final resolved profile catalog.  Only the additions may be edited or added to the generated markdown control files - and those additions can then be assembled into a new version of the original profile, with those additions.  For more details on its usage please see the profile authoring tutorial.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#profile-generation-with-inheritance","title":"Profile generation with inheritance","text":"<p>CLI evocation:</p> <p>trestle author profile-inherit</p> <p>The <code>profile-inherit</code> sub-command takes a given parent profile and filters its imported controls based inherited controls from a given SSP.</p> <p>The leveraged SSP is evaluated based on whether provided and responsibility statements for all <code>by-component</code> fields are set for each applicable control, as well as the implementation status. All components must have exported provided statements, no exported responsibility statements, and an implementation status of <code>implemented</code> in order for a control to be filtered from the output profile (i.e. controls delta profile).</p> <p>As with the other related author commands, if an existing destination file already exists, it is not updated if no changes would be made.</p> <p>For more details on its usage please see the ssp-filter tutorial.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#ssp-authoring","title":"SSP authoring","text":"<p>CLI evocation:</p> <ol> <li>To generate markdowns for editing SSP</li> </ol> <p>trestle author ssp-generate</p> <ol> <li>To assemble markdowns to a JSON SSP</li> </ol> <p>trestle author ssp-assemble</p> <p>The <code>ssp-generate</code> sub-command creates a partial SSP (System Security Plan) from a profile and optional yaml header file.  <code>ssp-assemble</code> can then assemble the markdown files into a single json SSP file.</p> <p>For more details on its usage please see the ssp authoring tutorial.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author/#ssp-content-filtering","title":"SSP Content Filtering","text":"<p>CLI evocation:</p> <p>trestle author ssp-filter</p> <p>The <code>ssp-filter</code> sub-command takes a given SSP and filters its contents based on a given profile, list of components, control implementation status and/or control origination.</p> <p>If filtering by profile, the SSP is assumed to contain a superset of controls needed by the profile, and the filter operation generates a new SSP with just the controls needed by that profile.  If the profile references a control not in the SSP, the routine fails with an error.</p> <p>If filtering by components, a colon-delimited list of components should be provided, with <code>This system</code> as the default name for the overall required component for the entire system.  Case and spaces are ignored in the component names, so the names could be specified as <code>--components \"this system: my component\"</code>.  The resulting, filtered ssp will have updated implemented requirements with filtered by_components on each requirement, and filtered by_components on each statement.</p> <p>If filtering by control implementation status, a comma-delimited list of implementation status values should be provided. These values must comply with the OSCAL SSP format references's allowed values, which are as follows: implemented, partial, planned, alternative, and not-applicable.</p> <p>If filtering by control origination, a comma-delimited list of control origination values should be provided. These values must comply with the OSCAL SSP format references's allowed values for the control origination property, which are as follows: system-specific, inherited, organization, customer-configured, and customer-provided.</p> <p>You may filter by a combination of a profile, list of component names, implementation statuses, and control origination values.</p> <p>As with the other related author commands, if an existing destination file already exists, it is not updated if no changes would be made.</p> <p>For more details on its usage please see the ssp-filter tutorial.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/","title":"Trestle author jinja - output templating support for oscal documents.","text":"<p>Unfortunately OSCAL documents are not yet universally accepted. Therefore to support various OSCAL and non-OSCAL compliance workflows <code>trestle author jinja</code> is designed to provide end users with the ability to use jinja to produce customized output. This complements the more structured commands <code>trestle author catalog-{assemble|generate}</code>, <code>trestle author profile-{assemble|generate}</code> and <code>trestle author ssp-{assemble|generate}</code> and allows arbitrary use of jinja.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#jinja-and-jinja-extensions-provided-by-trestle","title":"Jinja and jinja extensions provided by trestle.","text":"<p>Jinja is a powerful templating engine that is both more flexible that pure 'Moustache' approaches, and not coupled to a particular web application server (as an example Django templates). Users are encouraged to review the template designer documentation for jinja as all core functionality is exposed.</p> <p>Trestle's implementation of the Jinja command works in the following way:</p> <ol> <li>The template search space, by default, is relative to the current working directory.</li> <li>Trestle can inject a lookup table, into the jinja variables to contain booleans / substitutions required by end users using Moustache style variable substitutions.</li> <li>Trestle can provide a number of interfaces to OSCAL objects, currently a resolved catalog and a SSP, into jinja.</li> <li>Trestle supports custom jinja tags for importing.</li> <li>The jinja templating is recursive, to ensure all jinja tags are resolved as appropriate.</li> </ol> <p>More details will be on each of these points below.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#cli-invocation","title":"CLI invocation","text":"<p>Note the examples here use markdown, however, jinja can quite easily target xml or html if used w/o specific markdown content. <code>trestle author jinja -i input_template.md.jinja -o output_file.md -ssp SSP_NAME -p PROFILE_NAME -lut lookup_table.yaml -elp lut.prefix</code></p> <ul> <li><code>-i</code> input file path, relative to cwd. Users are encouraged to use the <code>file_name.target_extension.jinja</code> best practice as it helps mitigate issues, however is not required.</li> <li><code>-o</code> final output path, relative to cwd.</li> <li><code>-ssp</code> (optional) ssp name (in the trestle project). When used the jinja template will have a <code>ssp_md_writer</code> variable exposed to use.</li> <li><code>-p</code> (optional) profile name (in the trestle project). When used the jinja template will have <code>resolved_catalog</code> and <code>catalog_interface</code> variables to use.</li> <li><code>-lut</code> (optional) loads yaml into a dictionary in python for which each (top level) variable is available in jinja.</li> <li><code>-elp</code> (optional) a period separated prefix for the variables in the lookup table. E.g. if the lut contained <code>banana: yellow</code> and the prefix was <code>fruit.tropical</code> using <code>{{ fruit.tropical.banana }}</code> would print out <code>yellow</code> in the jinja template.</li> <li><code>-bf</code> (optional) use to provide a custom formatting of the substituted parameters in the text with brackets or markup formatting. Use dot (.) to indicate where the parameter value will be written. E.g. <code>-bf *.*</code> to italicize all substituted parameters, <code>-bf Prefix:.</code> to add <code>Prefix:</code> to all parameters, and <code>-bf [.]</code> to put square brackets around the parameters.</li> <li><code>-vap</code> (optional) use to specify a <code>--value-assigned-prefix</code> in front of parameters that have values assigned by the profile.  An example would include the organization doing the   assignment, e.g. <code>-vap \"ACME Assignment:\"</code>  This is identical to the behavior of <code>profile-resolve</code>.</li> <li><code>-vnap</code> (optional) use to specify a <code>--value-not-assigned-prefix</code> in front of parameters that do not have values assigned by the profile.  An example would be <code>-vap \"Assignment:\"</code>  This is identical to the behavior of <code>profile-resolve</code>.</li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#sample-jinja-templates","title":"Sample jinja templates","text":"<p>Below is a sample jinja template for SSP.</p> template Description Optional args required Simple SSP template Sample ssp jinja template which prints out all control responses and includes a front-matter section <code>-ssp</code> and <code>-p</code> for the ssp json and corresponding profile, respectively. Also requires a <code>frontmatter.md</code> file"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#variable-availability-in-the-jinja-template","title":"Variable availability in the jinja template.","text":""},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#lut","title":"LUT","text":"<p>The lookup table is primarily used for string substitution and to provide variables for basic logic operations in jinja e.g.</p> <p>The LUT:</p> <pre><code>names:\n  OSCAL: Open Security Compliance Assessment Language\n  trestle_pip: compliance-trestle\n  trestle_module: trestle\nvariables:\n  mac_os: true\n</code></pre> <p>The Jinja template:</p> <pre><code>Install via pip install {{ names.trestle_pip }} and invoke at the python REPL by import {{ names.trestle_module }}\n\n{% if variables.mac_os %}\nUsers are recommended to use homebrew to install the latest python 3 and then install python within a venv.\n{% endif %}\n</code></pre> <p>The output:</p> <pre><code>Install via pip install compliance-trestle and invoke at the python REPL by import trestle\n\nUsers are recommended to use homebrew to install the latest python 3 and then install python within a venv.\n</code></pre> <p>Users are free to use the LUT to inject more complex variables (arrays of data etc) to use at their own will using standard jinja templating.</p>"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#resolved-catalog-interface-profile","title":"Resolved catalog interface (profile)","text":"<p>Passing <code>-p</code> exposes a catalog, resolved from the profile, at <code>catalog</code> and a <code>trestle.core.catalog_interface.CatalogInterface</code> at <code>catalog_interface</code>.</p> <p>This allows user to perform various task such as iterating ove reach group and printing the group title.</p> <pre><code>{% for group in catalog_interface.get_all_groups_from_catalog() +%}\n## {{ group.title }} {{ group.class }} \\({{ group.id|upper }}\\)\n</code></pre>"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#ssp-interface","title":"SSP interface.","text":"<p>If <code>-ssp</code> is passed a variable within the jinja template called <code>ssp_md_writer</code> is made available which is an instance of <code>trestle.core.ssp_io.SSPMarkdownWriter</code>. <code>-ssp</code> requires that <code>-p</code> has also been set.</p> <p>This as allows users, as an example to print out a control response, as markdown</p> <pre><code>#### What is the solution and how is it implemented?\n{{ ssp_md_writer.get_control_response('my_control_id', 3)}}\n</code></pre>"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#custom-jinja-tags","title":"Custom Jinja tags.","text":"<p>Trestle provides custom jinja tags for use specifically with markdown: <code>mdsection_include</code> and <code>md_clean_include</code>.</p> <p><code>md_clean_include</code> is similar to the native <code>{% include 'sub_template' %}</code> that jinja provides except for the following:</p> <ol> <li><code>md_clean_include</code> will look for yaml headers in the markdown content and exclude it from the template</li> <li><code>md_clean_include</code> can be used with an optional keyword argument <code>heading_level</code> argument</li> <li><code>{% md_clean_include 'path_to_file.md' heading_level=2 %}</code></li> <li>The heading level argument adjusts to (based on the number of hashes) the most significant heading in the document, if headings exist.</li> </ol> <p><code>mdsection_include</code> is similar to <code>md_clean_include</code> except that:</p> <ol> <li> <p><code>mdsection_include</code> requires an second positional argument which is the title of a heading, from a markdown file, which you want the content from.</p> </li> <li> <p>E.g:  <code>{% mdsection_include 'test_markdown.md' '# Header we want' %}</code></p> </li> <li> <p><code>mdsection_include</code> can be used with an optional keyword argument <code>heading_level</code> argument similar to <code>md_clean_include</code></p> </li> <li> <p><code>{% mdsection_include 'test_markdown.md' '# Header we want' %}</code></p> </li> <li>The heading level argument adjusts to (based on the number of hashes) the most significant heading in the chosen section, if headings exist.</li> </ol> <p><code>md_datestamp</code> inserts a date stamp into the output. By default the date is in the format '%Y-%m-%d', e.g. '2021-12-28' and is followed by a double newline to prevent subsequent headings failing to parse correctly. E.g: <code>{% md_datestamp %}</code> results in a date in the format '2021-12-28' being inserted. <code>md_datestamp</code> can be used with the following optional keyword arguments:</p> <ol> <li><code>format</code> where a python datetime strftime format string is provided to format the output. E.g. <code>{% md_datestamp format='%B %d, %Y' %}</code> results in <code>December 28, 2021</code> being inserted.</li> <li><code>newline</code> is a boolean to control the addition of a double newline after the inserted date string. For example <code>{% md_datestamp newline=false %}</code> inserts a date in the default format, without additional newlines.</li> </ol>"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#custom-jinja-filters","title":"Custom Jinja filters.","text":"<p>Trestle provides custom jinja filters for help processing SSP data.</p> <ul> <li><code>as_list</code> will return the passed value, or an empty list if <code>None</code> is passed in.</li> <li>Example: <code>{% for party in ssp.metadata.parties | as_list %}</code></li> <li><code>get_default</code> operates the same as the built-in Jinja <code>default</code> filter, with the optional second parameter set to <code>True</code></li> <li>Example: <code>{{ control_interface.get_prop(user, 'user-property') | get_default('[Property]') }}</code></li> <li><code>first_or_none</code> will return the first element of a list, or <code>None</code> if the list is empty or <code>None</code> itself.</li> <li>Example: <code>{% set address = party.addresses | first_or_none %}</code></li> <li><code>get_party</code> will return the <code>Party</code> found in <code>ssp.metadata.parties</code> for a given <code>uuid</code></li> <li>Example: <code>{% set organization = party.member_of_organizations | first_or_none | get_party(ssp) %}</code></li> <li><code>parties_for_role</code> will yield individual <code>Party</code> entries when given a list of <code>ResponsibleParty</code> and a <code>role-id</code></li> <li>Example: <code>{% for party in ssp.metadata.responsible_parties | parties_for_role(\"prepared-by\", ssp) %}</code></li> <li><code>diagram_href</code> will return the <code>Link.href</code> where <code>Link.rel == 'diagram'</code> when given a <code>Diagram</code> object</li> <li>Example: <code>![{{diagram.caption}}]({{ diagram | diagram_href }})</code></li> </ul>"},{"location":"tutorials/Trestle_authoring/trestle_author_jinja/#generate-controls-as-individual-markdown-pages","title":"Generate controls as individual markdown pages.","text":"<p>Trestle's Jinja functionality allows its users to generate individual markdown pages for each control from a resolved profile catalog. Such functionality can be used later on to pack individual pages into docs of various formats.</p> <p>When <code>--docs-profile</code> or <code>-dp</code> flag is provided as part of the <code>trestle author jinja</code> command, the provided Jinja template will be used to generate a markdown page for each control in each group.</p> <p>For example, suppose we would like to generate the markdown page for each control that would contain <code>Control Objective</code>, <code>Control Statement</code>, <code>Expected Evidence</code>, <code>Implementation Guidance</code> and say <code>Table of Parameters</code> used for this control. To achieve that, we can create a simple Jinja template that would be used to generate each page:</p> <pre><code># Control Page\n\n{{ control_writer.write_control_with_sections(\n   control,\n   profile,\n   group_title,\n   ['statement', 'objective', 'expected_evidence', 'implementation_guidance', 'table_of_parameters'],\n   {\n      'statement':'Control Statement',\n      'objective':'Control Objective',\n      'expected_evidence':'Expected Evidence',\n      'implementation_guidance':'Implementation Guidance',\n      'table_of_parameters':'Control Parameters'\n   }\n   )\n\n   | safe\n}}\n</code></pre> <p>The template above, would call a control writer that would print the required sections (specified in the list) with the provided headers (specified in the dictionary).</p> <p>We can then generate individual markdown pages by executing: <code>trestle author jinja -i profile_to_docs.md.jinja -o controls -p some_profile -dp</code></p> <p>This will create a folder named <code>controls</code>, that would contain a folder per each group and a markdown file per each control in that group. Each markdown file would be formatted using the Jinja template above.</p> <p>The generated markdown files can then be assembled to the docs of the desired format by adding an indexing page.</p>"}]}
\ No newline at end of file
diff --git a/latest/sitemap.xml b/latest/sitemap.xml
new file mode 100644
index 000000000..4e8096f27
--- /dev/null
+++ b/latest/sitemap.xml
@@ -0,0 +1,615 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/demos/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/installation/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/known_limitations/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/license/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/contributing/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/contributing/DCO/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/contributing/code_of_conduct/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/contributing/github_actions_setup/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/contributing/maintainers/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/contributing/oscal_object_model/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/contributing/plugins/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/contributing/website/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/plugins/fedramp/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/third-party-result-schema-IBM-SCC/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/cli/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/common_types/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/const/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/err/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/file_utils/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/list_utils/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/load_validate/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/log/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/model_utils/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/str_utils/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/trash/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/common/type_utils/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/all_validator/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/base_model/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog_validator/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_context/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_interface/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_reader/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/control_writer/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/docs_control_writer/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/draw_io/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/duplicates_validator/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/generators/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/generic_oscal/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/links_validator/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/object_factory/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/parser/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/pipeline/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/plugins/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/profile_resolver/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/refs_validator/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/repository/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/rule_parameters_validator/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/ssp_io/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/trestle_base_model/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/validator/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/validator_factory/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_api/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_interface/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_merger/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_reader/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/catalog/catalog_writer/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/add/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/assemble/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/command_docs/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/create/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/describe/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/href/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/import_/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/init/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/merge/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/partial_object_validate/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/remove/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/replicate/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/split/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/task/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/validate/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/version/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/catalog/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/command/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/common/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/component/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/consts/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/docs/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/folders/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/headers/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/jinja/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/prof/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/ssp/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/author/versioning/template_versioning/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/common/cmd_utils/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/commands/common/return_codes/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/bycomp_interface/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/export_reader/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/export_writer/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/leveraged_statements/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/crm/ssp_inheritance_api/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/base/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/ext/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/filters/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/jinja/tags/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/base_markdown_node/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/control_markdown_node/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/docs_markdown_node/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_api/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_const/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_processor/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/markdown_validator/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/markdown/md_writer/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/actions/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/elements/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/file_content_type/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/interfaces/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/models/plans/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/remote/cache/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/resolver/merge/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/resolver/modify/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/core/resolver/prune/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/assessment_plan/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/assessment_results/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/catalog/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/common/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/component/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/poam/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/profile/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/oscal/ssp/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/base_task/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/csv_to_oscal_cd/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/oscal_catalog_to_csv/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/oscal_profile_to_osco_profile/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/osco_result_to_oscal_ar/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/tanium_result_to_oscal_ar/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/transform/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xccdf_result_to_oscal_ar/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_helper/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_to_oscal_cd/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/tasks/xlsx_to_oscal_profile/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/results/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/transformer_factory/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/transformer_helper/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/transformer_singleton/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/implementations/osco/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/implementations/tanium/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/reference/API/trestle/transforms/implementations/xccdf/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/cli/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/compliance_posture/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/introduction_to_trestle/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/transformer_construction/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Trestle_authoring/trestle_author/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+    <url>
+         <loc>https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Trestle_authoring/trestle_author_jinja/</loc>
+         <lastmod>2024-12-05</lastmod>
+    </url>
+</urlset>
\ No newline at end of file
diff --git a/latest/sitemap.xml.gz b/latest/sitemap.xml.gz
new file mode 100644
index 0000000000000000000000000000000000000000..2748d0bfe4077412f392f4268ec1492bf107099b
GIT binary patch
literal 1392
zcmV-$1&{h4iwFn+?NDa||8r?{Wo=<_E_iKh0M(trZsRr(hVT0nf$z4mK?<}*l0}=M
zKn}$&u<4ngsj<a`A_Wc=J8$2iB+E{AH#uw%{0#(=WRd=cCWkZRjC}QJ-@3CWifn_w
zUVL1gFV4uDP+PyfUi^Fi_wv`pr<)H~eRNFeOm6mky=YSEey^(CZnt8asMQ^>Lflqt
z8ad%=x>%jBep}ppIFnbdU_2ULS1y>FTnkGzfsJ-c6WUHQueLTd{d#3Xm9IFfy`g1_
z#K}?RbdrPWs><b0tJ9p?P~TjfUtBIfUM$alkz1x~<L6g1!2gR<QyaJ>AnQ44CnxfS
zmc;ew!_F&bTbl;9q8iOvL!PN5Bolm!cHJi#iN$jLb^EzkHc?`v!bZu(x;Lp<&ar^f
zW*8Mp)NJ1s3)^bzll;kqQ7q$7T!r-mnWW^i$rX#*xqfSXxlOsFb)L&h;yX0ihU%!>
zqDD%j4Mnk@s7j5E^|I43Jul^+-lgSe8!hkt{Ac;~_O?vyKfc^mhc}J00Fa?=#mpK1
zsr1|t13~+;OxZVSDMlF9jdi3%fjOMc;4CLJ<e+Qyq@AsGSu?~t)LR(V!FB=b6`Ud%
zaf+H799o&<a2hyLrJXxyi4Z}U*P5w3&*2SVqmvfR2G`Jovk_eO(G%?x7`3><6gS!s
z7<VLH6IvJ9MR7z?pzB~*VUkC^Q&Jd&wwE#{-v+1pw&W>hUPc18Mh%sMFgxoX@w&#e
zbSX27Fh7GpcRDhRmg{Us(l<~h?gE#I-=d9SSb>pi!9BtB33&@oRYd9nTOc(Nd+8aX
zD|Aa@6yY^EbBALdO(zP@pGE5xGcVYrJ*^we>j%2CpyY7A_$&UF;ugmze+7@VpzsPF
z%017kz}nYb>AHqPW~O%S2#tF>P<c@Yj$MXkf@|@b*hIUA<8I_8G-lg&AtnWf?QKG1
z9_Dy7=p4jkkMVR!8~&$aL~6qmAoaAqjRwwA7H)hd&5vlzsN-=;If1ib`_zOu`w*b?
z<2f)rZpV>If+wF~`8_8Fg-3MYCiG2kHAPhVW>_CWrGK#gL4&gAy*N;G<_?s6vTbq#
zO(LmJDo`ia0GGdVx<Xq+#ht$9kCgi8Rn7{85h1qK`Z*WH+ujg#+7ByBSepY!ZmfL)
z;dUfSMsKNBoTNZ2RwhzUA9mJ#L(=TIG|*n;XdvWGb|_$+fa{TWV_m|rB1h(=w<y4^
zj*oTN`6>HhI#XUIOf(4&k=M{d3^C-;63p;8s{C7am^9t*(u@CRh#4l3>RSoWLcxv_
z)L16u5FaQ$tSRp4Jnuu3gEDs~>LE&cNPY8Zcz6L8{_K;2HGAhYO#jZ?)+xuVnTBAH
zr?7vdaEBvwsO{z%jk=3HLNd#kI+o)AnX|rDc_;#6kB{_W6mpo|>IoNQgLkGy+0h+=
zyP#Vb)-ja~1s7t=Dn~i-xX6PM@H7G&%WCg<uTmIOkQIztn*`ve6ZRSfJDBcL<;Fjx
zb)vTa8-n0`8K(`O1&~gK#s0GKgM!iUvk+l2|Bn4fM-=>|z3p3M0iyWsn-E(R;Jq>R
z2Drh8DYqfl5f(C_a(~H<qZkiEGN&tm_{As8^C1BxZ~uTFW}JQ>pRM0IN(jFHi3C<k
z4!aN2&l+SC0a}33NPre$m~~5%AoZeHtae=5bG1*v=6h5ZIQ5ar<g_`qBmbg<&5!&J
z>TqL`u=hvx#wsU~-w#v$=i4ur>h|s{gj4-9($r9b+#|S0?@CedLesnKr{=&Ac@xKh
yUaAn|^OeT9{~X(&gIEuvV1B61{4R(P>BSXHYW0&@JHtPwbn_qnt1|~8Z2$m81+ka_

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/demo-ocp4-cis-profile-to-oscal-catalog.config b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/demo-ocp4-cis-profile-to-oscal-catalog.config
new file mode 100644
index 000000000..dfb28cf8f
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/demo-ocp4-cis-profile-to-oscal-catalog.config
@@ -0,0 +1,4 @@
+[task.ocp4-cis-profile-to-oscal-catalog]
+
+input-dir = adjunct-data/cis-benchmarks
+output-dir = catalogs/ocp4-cis
diff --git a/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/index.html b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/index.html
new file mode 100644
index 000000000..0b5dc5cbc
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/index.html
@@ -0,0 +1,632 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Converting compliance as code profiles into an OSCAL catalog with compliance-trestle"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ rel=canonical><link href=../../introduction_to_trestle/ rel=prev><link href=../OCP4_CIS_profile_to_oscal_cd/ rel=next><link rel=icon href=../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>ComplianceAsCode profiles to OSCAL catalog - Compliance Trestle</title><link rel=stylesheet href=../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="ComplianceAsCode profiles to OSCAL catalog - Compliance Trestle"><meta property=og:description content="Converting compliance as code profiles into an OSCAL catalog with compliance-trestle"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="ComplianceAsCode profiles to OSCAL catalog - Compliance Trestle"><meta name=twitter:description content="Converting compliance as code profiles into an OSCAL catalog with compliance-trestle"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#tutorial-setup-for-and-use-of-complianceascode-profile-to-oscal-catalog-transformer class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4 checked> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=true> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-install-trestle-in-a-python-virtual-environment class=md-nav__link> <span class=md-ellipsis> Step 1: Install trestle in a Python virtual environment </span> </a> </li> <li class=md-nav__item> <a href=#step-2-transform-profile-data-cis-benchmarks class=md-nav__link> <span class=md-ellipsis> Step 2: Transform profile data (CIS benchmarks) </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-install-trestle-in-a-python-virtual-environment class=md-nav__link> <span class=md-ellipsis> Step 1: Install trestle in a Python virtual environment </span> </a> </li> <li class=md-nav__item> <a href=#step-2-transform-profile-data-cis-benchmarks class=md-nav__link> <span class=md-ellipsis> Step 2: Transform profile data (CIS benchmarks) </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=tutorial-setup-for-and-use-of-complianceascode-profile-to-oscal-catalog-transformer>Tutorial: Setup for and use of ComplianceAsCode profile to OSCAL Catalog transformer<a class=headerlink href=#tutorial-setup-for-and-use-of-complianceascode-profile-to-oscal-catalog-transformer title="Permanent link">¤</a></h1> <p>Here are step by step instructions for setup and transformation of <a href=https://github.com/ComplianceAsCode/content>ComplianceAsCode</a> profile data files into <a href=https://www.nist.gov/ >NIST</a> standard <a href=https://pages.nist.gov/OSCAL/ >OSCAL</a> <a href=https://pages.nist.gov/OSCAL-Reference/models/latest/catalog/json-outline/ >Catalog</a> using the <a href=../../../ >compliance-trestle</a> tool.</p> <h2 id=objective>Objective<a class=headerlink href=#objective title="Permanent link">¤</a></h2> <p>How to transform one or more <code>.profile</code> compliance files into a standardized <code>OSCAL.json</code> file.</p> <p>There are 2 short steps shown below. The first is a one-time check/set-up of your environment. The second is a one-command transformation from <code>.profile</code> to <code>OSCAL.json</code>.</p> <h2 id=step-1-install-trestle-in-a-python-virtual-environment>Step 1: Install trestle in a Python virtual environment<a class=headerlink href=#step-1-install-trestle-in-a-python-virtual-environment title="Permanent link">¤</a></h2> <p>Follow the instructions <a href=../../../installation/ >here</a> to install trestle in a virtual environment.</p> <h2 id=step-2-transform-profile-data-cis-benchmarks>Step 2: Transform profile data (CIS benchmarks)<a class=headerlink href=#step-2-transform-profile-data-cis-benchmarks title="Permanent link">¤</a></h2> <p>Linux, Mac</p> <details> <summary>Windows</summary> <p>Make these changes:</p> <ul> <li>use backslashes `\` for file paths <li>use `md` instead of mkdir -p <li>put the url in double quotes for `curl` <li>use `more` instead of cat </li> </li> </li> </li> </ul> </details> <ul> <li>Navigate to trestle workspace.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ cd trestle.workspace
+</code></pre></div> <ul> <li>View configuration information.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ trestle task ocp4-cis-profile-to-oscal-catalog -i
+trestle.core.commands.task:102 WARNING: Config file was not configured with the appropriate section for the task: &quot;[task.ocp4-cis-profile-to-oscal-catalog]&quot;
+Help information for ocp4-cis-profile-to-oscal-catalog task.
+
+Purpose: Create catalog from from standard (e.g. CIS benchmark).
+
+Configuration flags sit under [task.ocp4-cis-profile-to-oscal-catalog]:
+  input-dir              = (required) location to read the compliance-as-code profile files.
+  output-dir             = (required) location to write the generated catalog.json file.
+  output-overwrite       = (optional) true [default] or false; replace existing output when true.
+</code></pre></div> <ul> <li>Create data folders.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ mkdir -p adjunct-data/cis-benchmarks
+(venv.trestle)$ mkdir -p adjunct-data/task-files
+</code></pre></div> <ul> <li>Fetch ComplianceAsCode profile data.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ curl &#39;https://raw.githubusercontent.com/ComplianceAsCode/content/master/products/ocp4/profiles/cis-node.profile&#39; &gt; adjunct-data/cis-benchmarks/cis-node.profile
+(venv.trestle)$ curl &#39;https://raw.githubusercontent.com/ComplianceAsCode/content/master/products/ocp4/profiles/cis-node.profile&#39; &gt; adjunct-data/cis-benchmarks/cis.profile
+</code></pre></div> <ul> <li>Fetch trestle task file.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ curl &#39;https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/task.ocp4-cis-profile-to-oscal-catalog/demo-ocp4-cis-profile-to-oscal-catalog.config&#39; &gt; adjunct-data/task-files/demo-ocp4-cis-profile-to-oscal-catalog.config
+</code></pre></div> <details> <summary>demo-ocp4-cis-profile-to-oscal-catalog.config</summary> <div class=highlight><pre><span></span><code>[task.ocp4-cis-profile-to-oscal-catalog]
+
+input-dir = adjunct-data/cis-benchmarks
+output-dir = catalogs/ocp4-cis
+</code></pre></div> </details> <ul> <li>Perform and validate the transform.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ trestle task ocp4-cis-profile-to-oscal-catalog -c adjunct-data/task-files/demo-ocp4-cis-profile-to-oscal-catalog.config
+output: catalogs/ocp4-cis/catalog.json
+Task: ocp4-cis-profile-to-oscal-catalog executed successfully.
+
+(venv.trestle)$ trestle validate --all
+VALID: Model /home/&lt;user&gt;/trestle.workspace/catalogs/ocp4-cis/catalog.json passed the Validator to confirm the model passes all registered validation tests.
+</code></pre></div> <ul> <li>View the generated OSCAL.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ cat catlogs/ocp4-cis/catalog.json
+</code></pre></div> <details> <summary>catalog.json</summary> <div class=highlight><pre><span></span><code>{
+  &quot;catalog&quot;: {
+    &quot;uuid&quot;: &quot;19543ebf-4667-48b7-be47-d51154f16fda&quot;,
+    &quot;metadata&quot;: {
+      &quot;title&quot;: &quot;CIS Red Hat OpenShift Container Platform 4 Benchmark&quot;,
+      &quot;last-modified&quot;: &quot;2021-12-03T13:52:21+00:00&quot;,
+      &quot;version&quot;: &quot;0.29.0&quot;,
+      &quot;oscal-version&quot;: &quot;1.0.0&quot;,
+      &quot;links&quot;: [
+        {
+          &quot;href&quot;: &quot;https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis-node.profile&quot;
+        },
+        {
+          &quot;href&quot;: &quot;https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile&quot;
+        }
+      ]
+    },
+    &quot;groups&quot;: [
+      {
+        &quot;title&quot;: &quot;1 Control Plane Components&quot;,
+        &quot;groups&quot;: [
+          {
+            &quot;title&quot;: &quot;1.1 Master Node Configuration Files&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-1.1.1&quot;,
+                &quot;title&quot;: &quot;1.1.1 Ensure that the API server pod specification file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.2&quot;,
+                &quot;title&quot;: &quot;1.1.2 Ensure that the API server pod specification file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.3&quot;,
+                &quot;title&quot;: &quot;1.1.3 Ensure that the controller manager pod specification file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.4&quot;,
+                &quot;title&quot;: &quot;1.1.4 Ensure that the controller manager pod specification file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.5&quot;,
+                &quot;title&quot;: &quot;1.1.5 Ensure that the scheduler pod specification file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.6&quot;,
+                &quot;title&quot;: &quot;1.1.6 Ensure that the scheduler pod specification file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.7&quot;,
+                &quot;title&quot;: &quot;1.1.7 Ensure that the etcd pod specification file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.8&quot;,
+                &quot;title&quot;: &quot;1.1.8 Ensure that the etcd pod specification file ownership is set to root:root (Automated)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.9&quot;,
+                &quot;title&quot;: &quot;1.1.9 Ensure that the Container Network Interface file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.10&quot;,
+                &quot;title&quot;: &quot;1.1.10 Ensure that the Container Network Interface file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.11&quot;,
+                &quot;title&quot;: &quot;1.1.11 Ensure that the etcd data directory permissions are set to 700 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.12&quot;,
+                &quot;title&quot;: &quot;1.1.12 Ensure that the etcd data directory ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.13&quot;,
+                &quot;title&quot;: &quot;1.1.13 Ensure that the admin.conf file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.14&quot;,
+                &quot;title&quot;: &quot;1.1.14 Ensure that the admin.conf file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.15&quot;,
+                &quot;title&quot;: &quot;1.1.15 Ensure that the scheduler.conf file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.16&quot;,
+                &quot;title&quot;: &quot;1.1.16 Ensure that the scheduler.conf file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.17&quot;,
+                &quot;title&quot;: &quot;1.1.17 Ensure that the controller-manager.conf file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.18&quot;,
+                &quot;title&quot;: &quot;1.1.18 Ensure that the controller-manager.conf file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.19&quot;,
+                &quot;title&quot;: &quot;1.1.19 Ensure that the OpenShift PKI directory and file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.20&quot;,
+                &quot;title&quot;: &quot;1.1.20 Ensure that the OpenShift PKI certificate file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.1.21&quot;,
+                &quot;title&quot;: &quot;1.1.21 Ensure that the OpenShift PKI key file permissions are set to 600&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;1.2 API Server&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-1.2.1&quot;,
+                &quot;title&quot;: &quot;1.2.1 Ensure that the --anonymous-auth argument is set to false&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.2&quot;,
+                &quot;title&quot;: &quot;1.2.2 Ensure that the --basic-auth-file argument is not set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.3&quot;,
+                &quot;title&quot;: &quot;1.2.3 Ensure that the --token-auth-file parameter is not set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.4&quot;,
+                &quot;title&quot;: &quot;1.2.4 Ensure that the --kubelet-https argument is set to true&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.5&quot;,
+                &quot;title&quot;: &quot;1.2.5 Ensure that the --kubelet-client-certificate and --kubelet-client-key arguments are set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.6&quot;,
+                &quot;title&quot;: &quot;1.2.6 Ensure that the --kubelet-certificate-authority argument is set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.7&quot;,
+                &quot;title&quot;: &quot;1.2.7 Ensure that the --authorization-mode argument is not set to AlwaysAllow&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.8&quot;,
+                &quot;title&quot;: &quot;1.2.8 Ensure that the --authorization-mode argument includes Node&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.9&quot;,
+                &quot;title&quot;: &quot;1.2.9 Ensure that the --authorization-mode argument includes RBAC&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.10&quot;,
+                &quot;title&quot;: &quot;1.2.10 Ensure that the admission control plugin EventRateLimit is set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.11&quot;,
+                &quot;title&quot;: &quot;1.2.11 Ensure that the admission control plugin AlwaysAdmit is not set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.12&quot;,
+                &quot;title&quot;: &quot;1.2.12 Ensure that the admission control plugin AlwaysPullImages is set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.13&quot;,
+                &quot;title&quot;: &quot;1.2.13 Ensure that the admission control plugin SecurityContextDeny is not set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.14&quot;,
+                &quot;title&quot;: &quot;1.2.14 Ensure that the admission control plugin ServiceAccount is set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.15&quot;,
+                &quot;title&quot;: &quot;1.2.15 Ensure that the admission control plugin NamespaceLifecycle is set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.16&quot;,
+                &quot;title&quot;: &quot;1.2.16 Ensure that the admission control plugin PodSecurityPolicy is set (Automated)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.17&quot;,
+                &quot;title&quot;: &quot;1.2.17 Ensure that the admission control plugin NodeRestriction is set (Automated)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.18&quot;,
+                &quot;title&quot;: &quot;1.2.18 Ensure that the --insecure-bind-address argument is not set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.19&quot;,
+                &quot;title&quot;: &quot;1.2.19 Ensure that the --insecure-port argument is set to 0&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.20&quot;,
+                &quot;title&quot;: &quot;1.2.20 Ensure that the --secure-port argument is not set to 0&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.21&quot;,
+                &quot;title&quot;: &quot;1.2.21 Ensure that the --profiling argument is set to false&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.22&quot;,
+                &quot;title&quot;: &quot;1.2.22 Ensure that the --audit-log-path argument is set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.23&quot;,
+                &quot;title&quot;: &quot;1.2.23 Ensure that the audit logs are forwarded off the cluster for retention&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.24&quot;,
+                &quot;title&quot;: &quot;1.2.24 Ensure that the --audit-log-maxbackup argument is set to 10 or as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.25&quot;,
+                &quot;title&quot;: &quot;1.2.25 Ensure that the --audit-log-maxsize argument is set to 100 or as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.26&quot;,
+                &quot;title&quot;: &quot;1.2.26 Ensure that the --request-timeout argument is set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.27&quot;,
+                &quot;title&quot;: &quot;1.2.27 Ensure that the --service-account-lookup argument is set to true&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.28&quot;,
+                &quot;title&quot;: &quot;1.2.28 Ensure that the --service-account-key-file argument is set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.29&quot;,
+                &quot;title&quot;: &quot;1.2.29 Ensure that the --etcd-certfile and --etcd-keyfile arguments are set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.30&quot;,
+                &quot;title&quot;: &quot;1.2.30 Ensure that the --tls-cert-file and --tls-private-key-file arguments are set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.31&quot;,
+                &quot;title&quot;: &quot;1.2.31 Ensure that the --client-ca-file argument is set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.32&quot;,
+                &quot;title&quot;: &quot;1.2.32 Ensure that the --etcd-cafile argument is set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.33&quot;,
+                &quot;title&quot;: &quot;1.2.33 Ensure that the --encryption-provider-config argument is set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.34&quot;,
+                &quot;title&quot;: &quot;1.2.34 Ensure that encryption providers are appropriately configured&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.2.35&quot;,
+                &quot;title&quot;: &quot;1.2.35 Ensure that the API Server only makes use of Strong Cryptographic Ciphers&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;1.3 Controller Manager&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-1.3.1&quot;,
+                &quot;title&quot;: &quot;1.3.1 Ensure that garbage collection is configured as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.3.2&quot;,
+                &quot;title&quot;: &quot;1.3.2 Ensure that controller manager healthz endpoints are protected by RBAC. (Automated)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.3.3&quot;,
+                &quot;title&quot;: &quot;1.3.3 Ensure that the --use-service-account-credentials argument is set to true&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.3.4&quot;,
+                &quot;title&quot;: &quot;1.3.4 Ensure that the --service-account-private-key-file argument is set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.3.5&quot;,
+                &quot;title&quot;: &quot;1.3.5 Ensure that the --root-ca-file argument is set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.3.6&quot;,
+                &quot;title&quot;: &quot;1.3.6 Ensure that the RotateKubeletServerCertificate argument is set to true&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.3.7&quot;,
+                &quot;title&quot;: &quot;1.3.7 Ensure that the --bind-address argument is set to 127.0.0.1&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;1.4 Scheduler&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-1.4.1&quot;,
+                &quot;title&quot;: &quot;1.4.1 Ensure that the --profiling argument is set to false  (info only)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-1.4.2&quot;,
+                &quot;title&quot;: &quot;1.4.2 Ensure that the --bind-address argument is set to 127.0.0.1&quot;
+              }
+            ]
+          }
+        ]
+      },
+      {
+        &quot;title&quot;: &quot;2 etcd&quot;,
+        &quot;controls&quot;: [
+          {
+            &quot;id&quot;: &quot;CIS-2.1&quot;,
+            &quot;title&quot;: &quot;2.1 Ensure that the --cert-file and --key-file arguments are set as appropriate&quot;
+          },
+          {
+            &quot;id&quot;: &quot;CIS-2.2&quot;,
+            &quot;title&quot;: &quot;2.2 Ensure that the --client-cert-auth argument is set to true&quot;
+          },
+          {
+            &quot;id&quot;: &quot;CIS-2.3&quot;,
+            &quot;title&quot;: &quot;2.3 Ensure that the --auto-tls argument is not set to true&quot;
+          },
+          {
+            &quot;id&quot;: &quot;CIS-2.4&quot;,
+            &quot;title&quot;: &quot;2.4 Ensure that the --peer-cert-file and --peer-key-file arguments are set as appropriate&quot;
+          },
+          {
+            &quot;id&quot;: &quot;CIS-2.5&quot;,
+            &quot;title&quot;: &quot;2.5 Ensure that the --peer-client-cert-auth argument is set to true&quot;
+          },
+          {
+            &quot;id&quot;: &quot;CIS-2.6&quot;,
+            &quot;title&quot;: &quot;2.6 Ensure that the --peer-auto-tls argument is not set to true&quot;
+          },
+          {
+            &quot;id&quot;: &quot;CIS-2.7&quot;,
+            &quot;title&quot;: &quot;2.7 Ensure that a unique Certificate Authority is used for etcd&quot;
+          }
+        ]
+      },
+      {
+        &quot;title&quot;: &quot;3 Control Plane Configuration&quot;,
+        &quot;groups&quot;: [
+          {
+            &quot;title&quot;: &quot;3.1 Authentication and Authorization&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-3.1.1&quot;,
+                &quot;title&quot;: &quot;3.1.1 Client certificate authentication should not be used for users&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;3.2 Logging&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-3.2.1&quot;,
+                &quot;title&quot;: &quot;3.2.1 Ensure that a minimal audit policy is created&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-3.2.2&quot;,
+                &quot;title&quot;: &quot;3.2.2 Ensure that the audit policy covers key security concerns&quot;
+              }
+            ]
+          }
+        ]
+      },
+      {
+        &quot;title&quot;: &quot;4 Worker Nodes&quot;,
+        &quot;groups&quot;: [
+          {
+            &quot;title&quot;: &quot;4.1 Worker node configuration&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-4.1.1&quot;,
+                &quot;title&quot;: &quot;4.1.1 Ensure that the kubelet service file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.1.2&quot;,
+                &quot;title&quot;: &quot;4.1.2 Ensure that the kubelet service file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.1.3&quot;,
+                &quot;title&quot;: &quot;4.1.3 If proxy kubeconfig file exists ensure permissions are set to 644 or more restrictive (Automated)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.1.4&quot;,
+                &quot;title&quot;: &quot;4.1.4 If proxy kubeconfig file exists ensure ownership is set to root:root (Manual)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.1.5&quot;,
+                &quot;title&quot;: &quot;4.1.5 Ensure that the --kubeconfig kubelet.conf file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.1.6&quot;,
+                &quot;title&quot;: &quot;4.1.6 Ensure that the --kubeconfig kubelet.conf file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.1.7&quot;,
+                &quot;title&quot;: &quot;4.1.7 Ensure that the certificate authorities file permissions are set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.1.8&quot;,
+                &quot;title&quot;: &quot;4.1.8 Ensure that the client certificate authorities file ownership is set to root:root&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.1.9&quot;,
+                &quot;title&quot;: &quot;4.1.9 Ensure that the kubelet --config configuration file has permissions set to 644 or more restrictive&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.1.10&quot;,
+                &quot;title&quot;: &quot;4.1.10 Ensure that the kubelet configuration file ownership is set to root:root&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;4.2 Kubelet&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-4.2.1&quot;,
+                &quot;title&quot;: &quot;4.2.1 Ensure that the --anonymous-auth argument is set to false&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.2&quot;,
+                &quot;title&quot;: &quot;4.2.2 Ensure that the --authorization-mode argument is not set to AlwaysAllow&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.3&quot;,
+                &quot;title&quot;: &quot;4.2.3 Ensure that the --client-ca-file argument is set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.4&quot;,
+                &quot;title&quot;: &quot;4.2.4 Ensure that the --read-only-port argument is set to 0&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.5&quot;,
+                &quot;title&quot;: &quot;4.2.5 Ensure that the --streaming-connection-idle-timeout argument is not set to 0&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.6&quot;,
+                &quot;title&quot;: &quot;4.2.6 Ensure that the --protect-kernel-defaults argument is set to true&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.7&quot;,
+                &quot;title&quot;: &quot;4.2.7 Ensure that the --make-iptables-util-chains argument is set to true&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.8&quot;,
+                &quot;title&quot;: &quot;4.2.8 Ensure that the --hostname-override argument is not set&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.9&quot;,
+                &quot;title&quot;: &quot;4.2.9 Ensure that the --event-qps argument is set to 0 or a level which ensures appropriate event capture&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.10&quot;,
+                &quot;title&quot;: &quot;4.2.10 Ensure that the --tls-cert-file and --tls-private-key-file arguments are set as appropriate&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.11&quot;,
+                &quot;title&quot;: &quot;4.2.11 Ensure that the --rotate-certificates argument is not set to false&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.12&quot;,
+                &quot;title&quot;: &quot;4.2.12 Verify that the RotateKubeletServerCertificate argument is set to true&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-4.2.13&quot;,
+                &quot;title&quot;: &quot;4.2.13 Ensure that the Kubelet only makes use of Strong Cryptographic Ciphers&quot;
+              }
+            ]
+          }
+        ]
+      },
+      {
+        &quot;title&quot;: &quot;5 Policies&quot;,
+        &quot;groups&quot;: [
+          {
+            &quot;title&quot;: &quot;5.1 RBAC and Service Accounts&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-5.1.1&quot;,
+                &quot;title&quot;: &quot;5.1.1 Ensure that the cluster-admin role is only used where required&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.1.2&quot;,
+                &quot;title&quot;: &quot;5.1.2 Minimize access to secrets (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.1.3&quot;,
+                &quot;title&quot;: &quot;5.1.3 Minimize wildcard use in Roles and ClusterRoles (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.1.4&quot;,
+                &quot;title&quot;: &quot;5.1.4 Minimize access to create pods (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.1.5&quot;,
+                &quot;title&quot;: &quot;5.1.5 Ensure that default service accounts are not actively used. (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.1.6&quot;,
+                &quot;title&quot;: &quot;5.1.6 Ensure that Service Account Tokens are only mounted where necessary (info)&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;5.2 Pod Security Policies / Security Context Constraints&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-5.2.1&quot;,
+                &quot;title&quot;: &quot;5.2.1 Minimize the admission of privileged containers (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.2.2&quot;,
+                &quot;title&quot;: &quot;5.2.2 Minimize the admission of containers wishing to share the host process ID namespace (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.2.3&quot;,
+                &quot;title&quot;: &quot;5.2.3 Minimize the admission of containers wishing to share the host IPC namespace (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.2.4&quot;,
+                &quot;title&quot;: &quot;5.2.4 Minimize the admission of containers wishing to share the host network namespace (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.2.5&quot;,
+                &quot;title&quot;: &quot;5.2.5 Minimize the admission of containers with allowPrivilegeEscalation (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.2.6&quot;,
+                &quot;title&quot;: &quot;5.2.6 Minimize the admission of root containers (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.2.7&quot;,
+                &quot;title&quot;: &quot;5.2.7 Minimize the admission of containers with the NET_RAW capability (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.2.8&quot;,
+                &quot;title&quot;: &quot;5.2.8 Minimize the admission of containers with added capabilities (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.2.9&quot;,
+                &quot;title&quot;: &quot;5.2.9 Minimize the admission of containers with capabilities assigned (info)&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;5.3 Network Policies and CNI&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-5.3.1&quot;,
+                &quot;title&quot;: &quot;5.3.1 Ensure that the CNI in use supports Network Policies (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.3.2&quot;,
+                &quot;title&quot;: &quot;5.3.2 Ensure that all Namespaces have Network Policies defined&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;5.4 Secrets Management&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-5.4.1&quot;,
+                &quot;title&quot;: &quot;5.4.1 Prefer using secrets as files over secrets as environment variables (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.4.2&quot;,
+                &quot;title&quot;: &quot;5.4.2 Consider external secret storage (info)&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;5.5 Extensible Admission Control&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-5.5.1&quot;,
+                &quot;title&quot;: &quot;5.5.1 Configure Image Provenance using ImagePolicyWebhook admission controller&quot;
+              }
+            ]
+          },
+          {
+            &quot;title&quot;: &quot;5.6 General Policies&quot;,
+            &quot;controls&quot;: [
+              {
+                &quot;id&quot;: &quot;CIS-5.6.1&quot;,
+                &quot;title&quot;: &quot;5.6.1 Create administrative boundaries between resources using namespaces (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.6.2&quot;,
+                &quot;title&quot;: &quot;5.6.2 Ensure Seccomp Profile Pod Definitions (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.6.3&quot;,
+                &quot;title&quot;: &quot;5.6.3 Apply Security Context to your Pods and Containers (info)&quot;
+              },
+              {
+                &quot;id&quot;: &quot;CIS-5.6.4&quot;,
+                &quot;title&quot;: &quot;5.6.4 The Default Namespace should not be used (info)&quot;
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}
+</code></pre></div> </details> <p><br> <br></p> <p><span style=color:green> Congratulations! You have completed this tutorial. </span></p> <p><br> <br></p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">September 11, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/demo-ocp4-cis-profile-to-oscal-cd.config b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/demo-ocp4-cis-profile-to-oscal-cd.config
new file mode 100644
index 000000000..92e92f93a
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/demo-ocp4-cis-profile-to-oscal-cd.config
@@ -0,0 +1,30 @@
+[task.ocp4-cis-profile-to-oscal-cd]
+
+component-name = OSCO
+
+folder-cac = adjunct-data/cis-benchmarks/content
+
+org-name = International Business Machines
+org-remarks = IBM
+
+output-dir = component-definitions/ocp4-cis
+
+profile-name = OCP4 CIS-benchmark v4
+profile-mnemonic = ocp4-cis-node
+profile-ns = https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud
+profile-version = 1.1
+profile-check-version = 0.1.58
+
+profile-type = OCP4
+profile-list = cis-node cis
+
+profile-file.cis-node = ${folder-cac}/products/ocp4/profiles/cis-node.profile
+profile-url.cis-node = https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis-node.profile
+profile-title.cis-node = CIS Red Hat OpenShift Container Platform 4 Benchmark
+
+profile-file.cis = ${folder-cac}/products/ocp4/profiles/cis.profile
+profile-url.cis = https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile
+profile-title.cis = CIS Red Hat OpenShift Container Platform 4 Benchmark
+
+selected-rules  = adjunct-data/task-files/selected_rules.json
+enabled-rules  = adjunct-data/task-files/enabled_rules.json
diff --git a/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/enabled_rules.json b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/enabled_rules.json
new file mode 100644
index 000000000..22710cd51
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/enabled_rules.json
@@ -0,0 +1,32 @@
+[
+  "file_permissions_cni_conf",
+  "file_permissions_multus_conf",
+  "file_owner_cni_conf",
+  "file_groupowner_cni_conf",
+  "file_owner_multus_conf",
+  "file_groupowner_multus_conf",
+  "kubelet_eviction_thresholds_set_soft_memory_available",
+  "kubelet_eviction_thresholds_set_soft_nodefs_available",
+  "kubelet_eviction_thresholds_set_soft_nodefs_inodesfree",
+  "kubelet_eviction_thresholds_set_soft_imagefs_available",
+  "kubelet_eviction_thresholds_set_soft_imagefs_inodesfree",
+  "kubelet_eviction_thresholds_set_hard_memory_available",
+  "kubelet_eviction_thresholds_set_hard_nodefs_available",
+  "kubelet_eviction_thresholds_set_hard_nodefs_inodesfree",
+  "kubelet_eviction_thresholds_set_hard_imagefs_available",
+  "kubelet_eviction_thresholds_set_hard_imagefs_inodesfree",
+  "etcd_unique_ca",
+  "file_permissions_kubelet_conf",
+  "file_groupowner_kubelet_conf",
+  "file_owner_kubelet_conf",
+  "file_permissions_worker_ca",
+  "file_owner_worker_ca",
+  "file_groupowner_worker_ca",
+  "kubelet_anonymous_auth",
+  "kubelet_configure_client_ca",
+  "kubelet_enable_streaming_connections",
+  "kubelet_enable_iptables_util_chains",
+  "kubelet_disable_hostname_override",
+  "kubelet_configure_event_creation",
+  "kubelet_configure_tls_cipher_suites"
+]
diff --git a/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/index.html b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/index.html
new file mode 100644
index 000000000..d30c109ac
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/index.html
@@ -0,0 +1,328 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Tutorial on converting ComplianceAsCode profiles to OSCAL component definitions"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ rel=canonical><link href=../OCP4_CIS_profile_to_oscal_catalog/ rel=prev><link href=../Tanium_result_to_oscal_ar/ rel=next><link rel=icon href=../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Converting ComplianceAsCode profiles to component definitions - Compliance Trestle</title><link rel=stylesheet href=../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Converting ComplianceAsCode profiles to component definitions - Compliance Trestle"><meta property=og:description content="Tutorial on converting ComplianceAsCode profiles to OSCAL component definitions"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Converting ComplianceAsCode profiles to component definitions - Compliance Trestle"><meta name=twitter:description content="Tutorial on converting ComplianceAsCode profiles to OSCAL component definitions"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#tutorial-setup-for-and-use-of-complianceascode-profile-to-oscal-component-definition-transformer class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4 checked> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=true> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-install-trestle-in-a-python-virtual-environment class=md-nav__link> <span class=md-ellipsis> Step 1: Install trestle in a Python virtual environment </span> </a> </li> <li class=md-nav__item> <a href=#step-2-transform-profile-data-cis-benchmarks class=md-nav__link> <span class=md-ellipsis> Step 2: Transform profile data (CIS benchmarks) </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-install-trestle-in-a-python-virtual-environment class=md-nav__link> <span class=md-ellipsis> Step 1: Install trestle in a Python virtual environment </span> </a> </li> <li class=md-nav__item> <a href=#step-2-transform-profile-data-cis-benchmarks class=md-nav__link> <span class=md-ellipsis> Step 2: Transform profile data (CIS benchmarks) </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=tutorial-setup-for-and-use-of-complianceascode-profile-to-oscal-component-definition-transformer>Tutorial: Setup for and use of ComplianceAsCode profile to OSCAL Component Definition transformer<a class=headerlink href=#tutorial-setup-for-and-use-of-complianceascode-profile-to-oscal-component-definition-transformer title="Permanent link">¤</a></h1> <p>Here are step by step instructions for setup and transformation of <a href=https://github.com/ComplianceAsCode/content>ComplianceAsCode</a> profile data files into <a href=https://www.nist.gov/ >NIST</a> standard <a href=https://pages.nist.gov/OSCAL/ >OSCAL</a> <a href=https://pages.nist.gov/OSCAL-Reference/models/v1.1.2/complete/json-reference/#/component-definition>Component Definition</a> using the <a href=https://oscal-compass.github.io/compliance-trestle/ >compliance-trestle</a> tool.</p> <h2 id=objective>Objective<a class=headerlink href=#objective title="Permanent link">¤</a></h2> <p>How to transform one or more <code>.profile</code> compliance files into a standardized <code>OSCAL.json</code> file.</p> <p>There are 2 short steps shown below. The first is a one-time check/set-up of your environment. The second is a one-command transformation from <code>.profile</code> to <code>OSCAL.json</code>.</p> <h2 id=step-1-install-trestle-in-a-python-virtual-environment>Step 1: Install trestle in a Python virtual environment<a class=headerlink href=#step-1-install-trestle-in-a-python-virtual-environment title="Permanent link">¤</a></h2> <p>Follow the instructions <a href=https://oscal-compass.github.io/compliance-trestle/python_trestle_setup/ >here</a> to install trestle in a virtual environment.</p> <h2 id=step-2-transform-profile-data-cis-benchmarks>Step 2: Transform profile data (CIS benchmarks)<a class=headerlink href=#step-2-transform-profile-data-cis-benchmarks title="Permanent link">¤</a></h2> <p>Linux, Mac</p> <details> <summary>Windows</summary> <p>Make these changes:</p> <ul> <li>use backslashes `\` for file paths <li>use `md` instead of mkdir -p <li>put the url in double quotes for `curl` <li>use `more` instead of cat </li> </li> </li> </li> </ul> </details> <ul> <li>Navigate to trestle workspace.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span><span class=nb>cd</span><span class=w> </span>trestle.workspace
+</code></pre></div> <ul> <li>View configuration information.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>trestle<span class=w> </span>task<span class=w> </span>ocp4-cis-profile-to-oscal-cd<span class=w> </span>-i
+trestle.core.commands.task:99<span class=w> </span>WARNING:<span class=w> </span>Config<span class=w> </span>file<span class=w> </span>was<span class=w> </span>not<span class=w> </span>configured<span class=w> </span>with<span class=w> </span>the<span class=w> </span>appropriate<span class=w> </span>section<span class=w> </span><span class=k>for</span><span class=w> </span>the<span class=w> </span>task:<span class=w> </span><span class=s2>&quot;[task.ocp4-cis-profile-to-oscal-cd]&quot;</span>
+Help<span class=w> </span>information<span class=w> </span><span class=k>for</span><span class=w> </span>ocp4-cis-profile-to-oscal-cd<span class=w> </span>task.
+
+Purpose:<span class=w> </span>Create<span class=w> </span>component<span class=w> </span>definition<span class=w> </span>from<span class=w> </span>standard<span class=w> </span><span class=o>(</span>e.g.<span class=w> </span>CIS<span class=w> </span>benchmark<span class=o>)</span>.
+
+Configuration<span class=w> </span>flags<span class=w> </span>sit<span class=w> </span>under<span class=w> </span><span class=o>[</span>task.ocp4-cis-profile-to-oscal-cd<span class=o>]</span>:
+<span class=w>  </span>component-name<span class=w>         </span><span class=o>=</span><span class=w> </span>component<span class=w> </span>name,<span class=w> </span>e.g.<span class=w> </span>OSCO.
+<span class=w>  </span>org-name<span class=w>               </span><span class=o>=</span><span class=w> </span>organization<span class=w> </span>name,<span class=w> </span>e.g.<span class=w> </span>International<span class=w> </span>Business<span class=w> </span>Machines.
+<span class=w>  </span>org-remarks<span class=w>            </span><span class=o>=</span><span class=w> </span>organization<span class=w> </span>remarks,<span class=w> </span>e.g.<span class=w> </span>IBM.
+<span class=w>  </span>folder-cac<span class=w>             </span><span class=o>=</span><span class=w> </span>folder<span class=w> </span>containing<span class=w> </span>compliance-as-code<span class=w> </span>artifacts,<span class=w> </span>e.g<span class=w> </span>adjunct-data/cis-benchmarks/content.
+<span class=w>  </span>output-dir<span class=w>             </span><span class=o>=</span><span class=w> </span>location<span class=w> </span>to<span class=w> </span>write<span class=w> </span>the<span class=w> </span>generated<span class=w> </span>component-definition.json<span class=w> </span>file.
+<span class=w>  </span>profile-name<span class=w>           </span><span class=o>=</span><span class=w> </span>profile<span class=w> </span>name,<span class=w> </span>e.g.<span class=w> </span>OCP4<span class=w> </span>CIS-benchmark<span class=w> </span>v4.
+<span class=w>  </span>profile-mnemonic<span class=w>       </span><span class=o>=</span><span class=w> </span>profile<span class=w> </span>mnemonic,<span class=w> </span>e.g.<span class=w> </span>ocp4-cis-node.
+<span class=w>  </span>profile-ns<span class=w>             </span><span class=o>=</span><span class=w> </span>profile<span class=w> </span>ns,<span class=w> </span>e.g.<span class=w> </span>http://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud.
+<span class=w>  </span>profile-version<span class=w>        </span><span class=o>=</span><span class=w> </span>profile<span class=w> </span>version,<span class=w> </span>e.g.<span class=w> </span><span class=m>1</span>.1.
+<span class=w>  </span>profile-check-version<span class=w>  </span><span class=o>=</span><span class=w> </span>profile<span class=w> </span>check<span class=w> </span>version,<span class=w> </span>e.g.<span class=w> </span><span class=m>0</span>.1.58.
+<span class=w>  </span>profile-type<span class=w>           </span><span class=o>=</span><span class=w> </span>profile<span class=w> </span>type,<span class=w> </span>e.g.<span class=w> </span>OCP4.
+<span class=w>  </span>profile-list<span class=w>           </span><span class=o>=</span><span class=w> </span>profile<span class=w> </span>list<span class=w> </span>is<span class=w> </span>blank<span class=w> </span>separated<span class=w> </span>list<span class=w> </span>of<span class=w> </span><span class=s2>&quot;&lt;suffix&gt;&quot;</span><span class=w> </span><span class=k>for</span><span class=w> </span>config<span class=w> </span>entries:<span class=w> </span>
+<span class=w>                           </span>profile-file.&lt;suffix&gt;,<span class=w> </span>profile-title.&lt;suffix&gt;,<span class=w> </span>profile-url.&lt;suffix&gt;,<span class=w> </span>e.g.<span class=w> </span>cis<span class=w> </span>cis-node.
+<span class=w>  </span>profile-file.&lt;suffix&gt;<span class=w>  </span><span class=o>=</span><span class=w> </span>path<span class=w> </span>of<span class=w> </span>the<span class=w> </span>profile<span class=w> </span>file<span class=w> </span>to<span class=w> </span>ingest,<span class=w> </span>e.g.<span class=w> </span><span class=si>${</span><span class=nv>folder</span><span class=p>-cac</span><span class=si>}</span>/products/ocp4/profiles/cis-node.profile.
+<span class=w>  </span>profile-title.&lt;suffix&gt;<span class=w> </span><span class=o>=</span><span class=w> </span>title<span class=w> </span>of<span class=w> </span>the<span class=w> </span>profile,<span class=w> </span>e.g.<span class=w> </span>CIS<span class=w> </span>Red<span class=w> </span>Hat<span class=w> </span>OpenShift<span class=w> </span>Container<span class=w> </span>Platform<span class=w> </span><span class=m>4</span><span class=w> </span>Benchmark.
+<span class=w>  </span>profile-url.&lt;suffix&gt;<span class=w>   </span><span class=o>=</span><span class=w> </span>URL<span class=w> </span>of<span class=w> </span>the<span class=w> </span>profile,<span class=w> </span>e.g.<span class=w> </span>https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile.
+<span class=w>  </span>rule-to-parameters-map<span class=w> </span><span class=o>=</span><span class=w> </span>map<span class=w> </span>file<span class=w> </span><span class=k>for</span><span class=w> </span>set-parameters,<span class=w> </span>e.g.<span class=w> </span>adjunct-data/task-files/rule2var.json.
+<span class=w>  </span>selected-rules<span class=w>         </span><span class=o>=</span><span class=w> </span>file<span class=w> </span>with<span class=w> </span>list<span class=w> </span>of<span class=w> </span>selected<span class=w> </span>rules,<span class=w> </span>e.g.<span class=w> </span>adjunct-data/task-files/selected_rules.json.
+<span class=w>  </span>enabled-rules<span class=w>          </span><span class=o>=</span><span class=w> </span>file<span class=w> </span>with<span class=w> </span>list<span class=w> </span>of<span class=w> </span>enabled<span class=w> </span>rules,<span class=w> </span>e.g.<span class=w> </span>adjunct-data/task-files/enabled_rules.json.
+
+Notes:
+<span class=m>1</span>.<span class=w> </span>If<span class=w> </span>a<span class=w> </span>control<span class=w> </span>has<span class=w> </span>selected<span class=w> </span>rules<span class=w> </span>but<span class=w> </span>no<span class=w> </span>enabled<span class=w> </span>rules,<span class=w> </span><span class=k>then</span><span class=w> </span>all<span class=w> </span>those<span class=w> </span>selected<span class=w> </span>are<span class=w> </span>included.
+<span class=m>2</span>.<span class=w> </span>If<span class=w> </span>a<span class=w> </span>control<span class=w> </span>has<span class=w> </span>selected<span class=w> </span>and<span class=w> </span>enabled<span class=w> </span>rules,<span class=w> </span><span class=k>then</span><span class=w> </span>only<span class=w> </span>those<span class=w> </span>enabled<span class=w> </span>are<span class=w> </span>included.
+<span class=m>3</span>.<span class=w> </span>If<span class=w> </span>a<span class=w> </span>control<span class=w> </span>has<span class=w> </span>no<span class=w> </span>selected<span class=w> </span>rules,<span class=w> </span><span class=k>then</span><span class=w> </span>none<span class=w> </span>are<span class=w> </span>included<span class=w> </span>regardless<span class=w> </span>of<span class=w> </span>enabled.
+</code></pre></div> <ul> <li>Create data folders.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>mkdir<span class=w> </span>-p<span class=w> </span>adjunct-data/cis-benchmarks
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>mkdir<span class=w> </span>-p<span class=w> </span>adjunct-data/config-files
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>mkdir<span class=w> </span>-p<span class=w> </span>adjunct-data/task-files
+</code></pre></div> <ul> <li>Fetch ComplianceAsCode data.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span><span class=nb>cd</span><span class=w> </span>adjunct-data/cis-benchmarks/
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>git<span class=w> </span>clone<span class=w> </span>https://github.com/ComplianceAsCode/content.git
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span><span class=nb>cd</span><span class=w> </span>-
+</code></pre></div> <ul> <li>Fetch trestle config and task files.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>curl<span class=w> </span><span class=s1>&#39;https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/task.ocp4-cis-profile-to-oscal-cd/demo-ocp4-cis-profile-to-oscal-cd.config&#39;</span><span class=w> </span>&gt;<span class=w> </span>adjunct-data/config-files/demo-ocp4-cis-profile-to-oscal-cd.config
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>curl<span class=w> </span><span class=s1>&#39;https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/task.ocp4-cis-profile-to-oscal-cd/selected_rules.json&#39;</span><span class=w> </span>&gt;<span class=w> </span>adjunct-data/task-files/selected_rules.json
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>curl<span class=w> </span><span class=s1>&#39;https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/task.ocp4-cis-profile-to-oscal-cd/enabled_rules.json&#39;</span><span class=w> </span>&gt;<span class=w> </span>adjunct-data/task-files/enabled_rules.json
+</code></pre></div> <details> <summary>demo-ocp4-cis-profile-to-oscal-cd.config</summary> <div class=highlight><pre><span></span><code><span class=o>[</span>task.ocp4-cis-profile-to-oscal-cd<span class=o>]</span>
+
+component-name<span class=w> </span><span class=o>=</span><span class=w> </span>OSCO
+
+folder-cac<span class=w> </span><span class=o>=</span><span class=w> </span>adjunct-data/cis-benchmarks/content
+
+org-name<span class=w> </span><span class=o>=</span><span class=w> </span>International<span class=w> </span>Business<span class=w> </span>Machines
+org-remarks<span class=w> </span><span class=o>=</span><span class=w> </span>IBM
+
+output-dir<span class=w> </span><span class=o>=</span><span class=w> </span>component-definitions/ocp4-cis
+
+profile-name<span class=w> </span><span class=o>=</span><span class=w> </span>OCP4<span class=w> </span>CIS-benchmark<span class=w> </span>v4
+profile-mnemonic<span class=w> </span><span class=o>=</span><span class=w> </span>ocp4-cis-node
+profile-ns<span class=w> </span><span class=o>=</span><span class=w> </span>http://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud
+profile-version<span class=w> </span><span class=o>=</span><span class=w> </span><span class=m>1</span>.1
+profile-check-version<span class=w> </span><span class=o>=</span><span class=w> </span><span class=m>0</span>.1.58
+
+profile-type<span class=w> </span><span class=o>=</span><span class=w> </span>OCP4
+profile-list<span class=w> </span><span class=o>=</span><span class=w> </span>cis-node<span class=w> </span>cis
+
+profile-file.cis-node<span class=w> </span><span class=o>=</span><span class=w> </span><span class=si>${</span><span class=nv>folder</span><span class=p>-cac</span><span class=si>}</span>/products/ocp4/profiles/cis-node.profile
+profile-url.cis-node<span class=w> </span><span class=o>=</span><span class=w> </span>https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis-node.profile
+profile-title.cis-node<span class=w> </span><span class=o>=</span><span class=w> </span>CIS<span class=w> </span>Red<span class=w> </span>Hat<span class=w> </span>OpenShift<span class=w> </span>Container<span class=w> </span>Platform<span class=w> </span><span class=m>4</span><span class=w> </span>Benchmark
+
+profile-file.cis<span class=w> </span><span class=o>=</span><span class=w> </span><span class=si>${</span><span class=nv>folder</span><span class=p>-cac</span><span class=si>}</span>/products/ocp4/profiles/cis.profile
+profile-url.cis<span class=w> </span><span class=o>=</span><span class=w> </span>https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile
+profile-title.cis<span class=w> </span><span class=o>=</span><span class=w> </span>CIS<span class=w> </span>Red<span class=w> </span>Hat<span class=w> </span>OpenShift<span class=w> </span>Container<span class=w> </span>Platform<span class=w> </span><span class=m>4</span><span class=w> </span>Benchmark
+
+selected-rules<span class=w>  </span><span class=o>=</span><span class=w> </span>adjunct-data/task-files/selected_rules.json
+enabled-rules<span class=w>  </span><span class=o>=</span><span class=w> </span>adjunct-data/task-files/enabled_rules.json
+</code></pre></div> </details> <details> <summary>selected_rules.json</summary> <div class=highlight><pre><span></span><code><span class=p>[</span>
+<span class=w>  </span><span class=s2>&quot;file_permissions_kube_apiserver&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_owner_kube_apiserver&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_groupowner_kube_apiserver&quot;</span>
+<span class=p>]</span>
+</code></pre></div> </details> <details> <summary>enabled_rules.json</summary> <div class=highlight><pre><span></span><code><span class=p>[</span>
+<span class=w>  </span><span class=s2>&quot;file_permissions_cni_conf&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_permissions_multus_conf&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_owner_cni_conf&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_groupowner_cni_conf&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_owner_multus_conf&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_groupowner_multus_conf&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_soft_memory_available&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_soft_nodefs_available&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_soft_nodefs_inodesfree&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_soft_imagefs_available&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_soft_imagefs_inodesfree&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_hard_memory_available&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_hard_nodefs_available&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_hard_nodefs_inodesfree&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_hard_imagefs_available&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_eviction_thresholds_set_hard_imagefs_inodesfree&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;etcd_unique_ca&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_permissions_kubelet_conf&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_groupowner_kubelet_conf&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_owner_kubelet_conf&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_permissions_worker_ca&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_owner_worker_ca&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;file_groupowner_worker_ca&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_anonymous_auth&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_configure_client_ca&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_enable_streaming_connections&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_enable_iptables_util_chains&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_disable_hostname_override&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_configure_event_creation&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=s2>&quot;kubelet_configure_tls_cipher_suites&quot;</span>
+<span class=p>]</span>
+</code></pre></div> </details> <ul> <li>Perform and validate the transform.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>trestle<span class=w> </span>task<span class=w> </span>ocp4-cis-profile-to-oscal-cd<span class=w> </span>-c<span class=w> </span>adjunct-data/config-files/demo-ocp4-cis-profile-to-oscal-cd.config
+output:<span class=w> </span>component-definitions/ocp4-cis/component-definition.json
+Task:<span class=w> </span>ocp4-cis-profile-to-oscal-cd<span class=w> </span>executed<span class=w> </span>successfully.
+
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>trestle<span class=w> </span>validate<span class=w> </span>--all
+VALID:<span class=w> </span>Model<span class=w> </span>/home/&lt;user&gt;/trestle.workspace/component-definitions/ocp4-cis/component-definition.json<span class=w> </span>passed<span class=w> </span>the<span class=w> </span>Validator<span class=w> </span>to<span class=w> </span>confirm<span class=w> </span>the<span class=w> </span>model<span class=w> </span>passes<span class=w> </span>all<span class=w> </span>registered<span class=w> </span>validation<span class=w> </span>tests.
+</code></pre></div> <ul> <li>View the generated OSCAL.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>cat<span class=w> </span>component-definitions/ocp4-cis/component-definition.json
+</code></pre></div> <details> <summary>component-definition.json</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;component-definition&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;d1b961ee-188b-42b9-943d-e11dc260f9dc&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;metadata&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Component definition for OCP4 profiles&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;last-modified&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2022-01-06T22:43:59+00:00&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;0.33.0&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;oscal-version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;roles&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-by&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Indicates the organization that created this content.&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-for&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Indicates the organization for which this content was created..&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;content-approver&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Indicates the organization responsible for all content represented in the \&quot;document\&quot;.&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>],</span>
+<span class=w>      </span><span class=nt>&quot;parties&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;d00dff65-e4ae-4344-a206-1e298eff9066&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;organization&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;International Business Machines&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;IBM&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;851b55f0-5ba6-4684-8a48-5dad22ba2625&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;organization&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Customer&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;organization to be customized at account creation only for their Component Definition&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;150f9eb7-7fa5-4989-b9be-bc3cba220354&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;organization&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;ISV&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;organization to be customized at ISV subscription only for their Component Definition&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>],</span>
+<span class=w>      </span><span class=nt>&quot;responsible-parties&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-by&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;d00dff65-e4ae-4344-a206-1e298eff9066&quot;</span>
+<span class=w>          </span><span class=p>]</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-for&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;851b55f0-5ba6-4684-8a48-5dad22ba2625&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=s2>&quot;150f9eb7-7fa5-4989-b9be-bc3cba220354&quot;</span>
+<span class=w>          </span><span class=p>]</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;content-approver&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;d00dff65-e4ae-4344-a206-1e298eff9066&quot;</span>
+<span class=w>          </span><span class=p>]</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>]</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=nt>&quot;components&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>      </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;e2ee2b93-6103-42de-b615-65b0b3ff2dc4&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Service&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;OSCO&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;OSCO&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;control-implementations&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;f9c2699a-2d2c-4ee2-87f3-042d1a9b3a79&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;source&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis-node.profile&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;OSCO implemented controls for CIS Red Hat OpenShift Container Platform 4 Benchmark.&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;profile_name&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;OCP4 CIS-benchmark v4&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_profile_name&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;profile_mnemonic&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;ocp4-cis-node&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_profile_mnemonic&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;profile_version&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.1&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_profile_version&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;profile_check_version&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;0.1.58&quot;</span>
+<span class=w>              </span><span class=p>}</span>
+<span class=w>            </span><span class=p>],</span>
+<span class=w>            </span><span class=nt>&quot;implemented-requirements&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;97142b13-bc30-4e72-be7f-36de9149a679&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;control-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS-1.1.1&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Ensure that the API server pod specification file permissions are set to 644 or more restrictive&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;XCCDF_rule&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.ssgproject.content_rule_file_permissions_kube_apiserver&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_name_id&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Verify Permissions on the Kubernetes API Server Pod Specification File&quot;</span>
+<span class=w>                  </span><span class=p>}</span>
+<span class=w>                </span><span class=p>],</span>
+<span class=w>                </span><span class=nt>&quot;responsible-roles&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-by&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                      </span><span class=s2>&quot;d00dff65-e4ae-4344-a206-1e298eff9066&quot;</span>
+<span class=w>                    </span><span class=p>]</span>
+<span class=w>                  </span><span class=p>},</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-for&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                      </span><span class=s2>&quot;851b55f0-5ba6-4684-8a48-5dad22ba2625&quot;</span><span class=p>,</span>
+<span class=w>                      </span><span class=s2>&quot;150f9eb7-7fa5-4989-b9be-bc3cba220354&quot;</span>
+<span class=w>                    </span><span class=p>]</span>
+<span class=w>                  </span><span class=p>},</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;content-approver&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                      </span><span class=s2>&quot;d00dff65-e4ae-4344-a206-1e298eff9066&quot;</span>
+<span class=w>                    </span><span class=p>]</span>
+<span class=w>                  </span><span class=p>}</span>
+<span class=w>                </span><span class=p>]</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;0690e2a7-b228-4954-93fe-c1d55936cfa8&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;control-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS-1.1.2&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Ensure that the API server pod specification file ownership is set to root:root&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;XCCDF_rule&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.ssgproject.content_rule_file_owner_kube_apiserver&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_name_id&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Verify User Who Owns The Kubernetes API Server Pod Specification File&quot;</span>
+<span class=w>                  </span><span class=p>}</span>
+<span class=w>                </span><span class=p>],</span>
+<span class=w>                </span><span class=nt>&quot;responsible-roles&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-by&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                      </span><span class=s2>&quot;d00dff65-e4ae-4344-a206-1e298eff9066&quot;</span>
+<span class=w>                    </span><span class=p>]</span>
+<span class=w>                  </span><span class=p>},</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-for&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                      </span><span class=s2>&quot;851b55f0-5ba6-4684-8a48-5dad22ba2625&quot;</span><span class=p>,</span>
+<span class=w>                      </span><span class=s2>&quot;150f9eb7-7fa5-4989-b9be-bc3cba220354&quot;</span>
+<span class=w>                    </span><span class=p>]</span>
+<span class=w>                  </span><span class=p>},</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;content-approver&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                      </span><span class=s2>&quot;d00dff65-e4ae-4344-a206-1e298eff9066&quot;</span>
+<span class=w>                    </span><span class=p>]</span>
+<span class=w>                  </span><span class=p>}</span>
+<span class=w>                </span><span class=p>]</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;18c61fb2-8603-440d-9d9a-8d6d1e232cd3&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;control-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS-1.1.2&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Ensure that the API server pod specification file ownership is set to root:root&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;XCCDF_rule&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ibm-cloud&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.ssgproject.content_rule_file_groupowner_kube_apiserver&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_name_id&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Verify Group Who Owns The Kubernetes API Server Pod Specification File&quot;</span>
+<span class=w>                  </span><span class=p>}</span>
+<span class=w>                </span><span class=p>],</span>
+<span class=w>                </span><span class=nt>&quot;responsible-roles&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-by&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                      </span><span class=s2>&quot;d00dff65-e4ae-4344-a206-1e298eff9066&quot;</span>
+<span class=w>                    </span><span class=p>]</span>
+<span class=w>                  </span><span class=p>},</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;prepared-for&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                      </span><span class=s2>&quot;851b55f0-5ba6-4684-8a48-5dad22ba2625&quot;</span><span class=p>,</span>
+<span class=w>                      </span><span class=s2>&quot;150f9eb7-7fa5-4989-b9be-bc3cba220354&quot;</span>
+<span class=w>                    </span><span class=p>]</span>
+<span class=w>                  </span><span class=p>},</span>
+<span class=w>                  </span><span class=p>{</span>
+<span class=w>                    </span><span class=nt>&quot;role-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;content-approver&quot;</span><span class=p>,</span>
+<span class=w>                    </span><span class=nt>&quot;party-uuids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>                      </span><span class=s2>&quot;d00dff65-e4ae-4344-a206-1e298eff9066&quot;</span>
+<span class=w>                    </span><span class=p>]</span>
+<span class=w>                  </span><span class=p>}</span>
+<span class=w>                </span><span class=p>]</span>
+<span class=w>              </span><span class=p>}</span>
+<span class=w>            </span><span class=p>]</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>]</span>
+<span class=w>      </span><span class=p>}</span>
+<span class=w>    </span><span class=p>]</span>
+<span class=w>  </span><span class=p>}</span>
+<span class=p>}</span>
+</code></pre></div> </details> <p><br> <br></p> <p><span style=color:green> Congratulations! You have completed this tutorial. </span></p> <p><br> <br></p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">September 11, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/selected_rules.json b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/selected_rules.json
new file mode 100644
index 000000000..a0e8c0ce9
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/selected_rules.json
@@ -0,0 +1,5 @@
+[
+  "file_permissions_kube_apiserver",
+  "file_owner_kube_apiserver",
+  "file_groupowner_kube_apiserver"
+]
diff --git a/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/800px-Australia_scarsdale_nimons_bridge.copyright-info.txt b/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/800px-Australia_scarsdale_nimons_bridge.copyright-info.txt
new file mode 100644
index 000000000..868e9ac84
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/800px-Australia_scarsdale_nimons_bridge.copyright-info.txt
@@ -0,0 +1,10 @@
+Location:
+
+https://commons.wikimedia.org/wiki/File:Australia_scarsdale_nimons_bridge.jpg
+
+
+License:
+
+This work has beenThis work has been released into the public domain by its author, User: (WT-shared) Inas at wts wikivoyage. This applies worldwide.
+In some countries this may not be legally possible; if so:
+User: (WT-shared) Inas at wts wikivoyage grants anyone the right to use this work for any purpose, without any conditions, unless such conditions are required by law.
\ No newline at end of file
diff --git a/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/800px-Australia_scarsdale_nimons_bridge.jpg b/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/800px-Australia_scarsdale_nimons_bridge.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..cccab9729f607d8c23e7bf32307693dd875ea046
GIT binary patch
literal 111352
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
JlzzXA|JhFqE4u&y

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/index.html b/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/index.html
new file mode 100644
index 000000000..b175f4ec1
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/index.html
@@ -0,0 +1,772 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Tutorial on how to use compliance trestle to convert Tanium results output to OSCAL assessment results"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ rel=canonical><link href=../OCP4_CIS_profile_to_oscal_cd/ rel=prev><link href=../csv_to_oscal_cd/ rel=next><link rel=icon href=../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Coverting Tanium results to OSCAL - Compliance Trestle</title><link rel=stylesheet href=../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Coverting Tanium results to OSCAL - Compliance Trestle"><meta property=og:description content="Tutorial on how to use compliance trestle to convert Tanium results output to OSCAL assessment results"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Coverting Tanium results to OSCAL - Compliance Trestle"><meta name=twitter:description content="Tutorial on how to use compliance trestle to convert Tanium results output to OSCAL assessment results"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/Tanium_result_to_oscal_ar.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#tutorial-setup-for-and-use-of-tanium-to-oscal-transformer class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4 checked> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=true> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-environment-setup class=md-nav__link> <span class=md-ellipsis> Step 1: Environment setup </span> </a> </li> <li class=md-nav__item> <a href=#step-2-transform-sample class=md-nav__link> <span class=md-ellipsis> Step 2: Transform sample </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-environment-setup class=md-nav__link> <span class=md-ellipsis> Step 1: Environment setup </span> </a> </li> <li class=md-nav__item> <a href=#step-2-transform-sample class=md-nav__link> <span class=md-ellipsis> Step 2: Transform sample </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=tutorial-setup-for-and-use-of-tanium-to-oscal-transformer>Tutorial: Setup for and use of Tanium to OSCAL transformer<a class=headerlink href=#tutorial-setup-for-and-use-of-tanium-to-oscal-transformer title="Permanent link">¤</a></h1> <p>Here are step by step instructions for setup and transformation of <a href=https://www.tanium.com/ >Tanium</a> compliance data files into <a href=https://www.nist.gov/ >NIST</a> standard <a href=https://pages.nist.gov/OSCAL/ >OSCAL</a> using the <a href=https://oscal-compass.github.io/compliance-trestle/ >compliance-trestle</a> tool.</p> <h2 id=objective>Objective<a class=headerlink href=#objective title="Permanent link">¤</a></h2> <p>How to transform a <code>Tanium.results</code> compliance file into a standardized <code>OSCAL.json</code> file.</p> <p>There are 2 short steps shown below. The first is a one-time check/set-up of your environment. The second is a one-command transformation from <code>Tanium.results</code> to <code>OSCAL.json</code>.</p> <h2 id=step-1-environment-setup>Step 1: Environment setup<a class=headerlink href=#step-1-environment-setup title="Permanent link">¤</a></h2> <p>Linux, Mac</p> <details> <summary>Windows</summary> <p>Make these changes:</p> <ul> <li>use backslashes `\` for file paths <li>use `md` instead of mkdir -p <li>put the url in double quotes for `curl` <li>use `more` instead of cat </li> </li> </li> </li> </ul> </details> <ul> <li>Insure you have a modern <a href=https://www.python.org/downloads/ >Python</a> (3.9, 3.10, 3.11).</li> </ul> <div class=highlight><pre><span></span><code>$<span class=w> </span>python<span class=w> </span>-V
+Python<span class=w> </span><span class=m>3</span>.8.3
+</code></pre></div> <ul> <li>Setup a virtual environment.</li> </ul> <div class=highlight><pre><span></span><code>$<span class=w> </span><span class=nb>cd</span>
+$<span class=w> </span>python<span class=w> </span>-m<span class=w> </span>venv<span class=w> </span>venv.trestle
+$<span class=w> </span><span class=nb>source</span><span class=w> </span>venv.trestle/bin/activate
+<span class=o>(</span>venv.trestle<span class=o>)</span>$
+</code></pre></div> <ul> <li>Insure you have a modern <a href=https://pip.pypa.io/en/stable/installing/ >pip</a> (19.x or greater).</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>pip<span class=w> </span>--version
+pip<span class=w> </span><span class=m>19</span>.2.3<span class=w> </span>from<span class=w> </span>/home...
+</code></pre></div> <ul> <li>Install <a href=https://oscal-compass.github.io/compliance-trestle/ >compliance-trestle</a>.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>pip<span class=w> </span>install<span class=w> </span>compliance-trestle
+Looking<span class=w> </span><span class=k>in</span><span class=w> </span>indexes:<span class=w> </span>https://pypi.org/simple,...
+</code></pre></div> <ul> <li>Check trestle viability (and view help).</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>trestle<span class=w> </span>-h
+usage:<span class=w> </span>trestle<span class=w> </span><span class=o>[</span>-h<span class=o>]</span><span class=w> </span><span class=o>{</span>init,create,split,merge,replicate,add,remove,validate,import,task,assemble<span class=o>}</span><span class=w> </span>...
+</code></pre></div> <ul> <li>Create trestle workspace.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>mkdir<span class=w> </span>trestle.workspace
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span><span class=nb>cd</span><span class=w> </span>trestle.workspace
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>trestle<span class=w> </span>init
+Initialized<span class=w> </span>trestle<span class=w> </span>project<span class=w> </span>successfully<span class=w> </span><span class=k>in</span><span class=w> </span>/home/&lt;user&gt;/trestle.workspace
+</code></pre></div> <h2 id=step-2-transform-sample>Step 2: Transform sample<a class=headerlink href=#step-2-transform-sample title="Permanent link">¤</a></h2> <ul> <li>Create Tanium data folders.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>mkdir<span class=w> </span>-p<span class=w> </span>tanium/tests/data/tasks/tanium/input
+</code></pre></div> <ul> <li>Fetch sample Tanium data file. It is a "raw" Tanium result for which a transformation to OSCAL is desired.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>curl<span class=w> </span><span class=s1>&#39;https://raw.githubusercontent.com/oscal-compass/compliance-trestle/develop/tests/data/tasks/tanium/input-doc/Tanium.doc-json&#39;</span><span class=w> </span>&gt;<span class=w> </span>tanium/tests/data/tasks/tanium/input/Tanium.doc-json
+</code></pre></div> <details> <summary>sample: Tanium.doc-json</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;Computer Name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;RHEL8&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Tanium Client IP Address&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;192.168.0.125&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;IP Address&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=s2>&quot;192.168.0.125&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=s2>&quot;192.168.122.1&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=s2>&quot;fe80::3c47:1aff:fe33:601&quot;</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;Comply - Compliance Findings&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Check ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;State&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Rule ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Check ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;State&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Rule ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Check ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;State&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Rule ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Check ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;State&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Rule ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Check ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;State&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Rule ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Check ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;State&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Rule ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Check ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;State&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Rule ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Check ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;State&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Rule ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Check ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;State&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;notchecked&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Rule ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;Count&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1&quot;</span>
+<span class=p>}</span>
+</code></pre></div> </details> <ul> <li>Fetch sample trestle tanium-result-to-oscal-ar config file. It informs the trestle command where to read input and write output.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>curl<span class=w> </span><span class=s1>&#39;https://raw.githubusercontent.com/oscal-compass/compliance-trestle/develop/tests/data/tasks/tanium/demo-tanium-result-to-oscal-ar.config&#39;</span><span class=w> </span>&gt;<span class=w> </span>tanium/demo-tanium-result-to-oscal-ar.config
+</code></pre></div> <details> <summary>sample: demo-tanium-result-to-oscal-ar.config</summary> <div class=highlight><pre><span></span><code>[task.tanium-result-to-oscal-ar]
+
+input-dir =  tests/data/tasks/tanium/input
+output-dir = tests/data/tasks/tanium/runtime
+</code></pre></div> </details> <ul> <li>Perform the transform.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span><span class=nb>cd</span><span class=w> </span>tanium
+<span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>trestle<span class=w> </span>task<span class=w> </span>tanium-result-to-oscal-ar<span class=w> </span>-c<span class=w> </span>demo-tanium-result-to-oscal-ar.config<span class=w> </span>
+input:<span class=w> </span>tests/data/tasks/tanium/input/Tanium.doc-json
+output:<span class=w> </span>tests/data/tasks/tanium/runtime/Tanium.oscal.json
+inventory:<span class=w> </span><span class=m>1</span>
+observations:<span class=w> </span><span class=m>9</span>
+Task:<span class=w> </span>tanium-result-to-oscal-ar<span class=w> </span>executed<span class=w> </span>successfully.
+</code></pre></div> <ul> <li>View the generated OSCAL.</li> </ul> <div class=highlight><pre><span></span><code><span class=o>(</span>venv.trestle<span class=o>)</span>$<span class=w> </span>cat<span class=w> </span>tests/data/tasks/tanium/runtime/Tanium.oscal.json
+</code></pre></div> <details> <summary>sample: Tanium.oscal.json</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;results&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;f79add8e-488a-45f3-9024-72ecf95c7952&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;start&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;end&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;local-definitions&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;components&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;1ea447fe-a2af-4110-baae-c70ed5223261&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Operating System&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Red Hat Enterprise Linux 8&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Red Hat Enterprise Linux 8&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;status&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;state&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;operational&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=nt>&quot;inventory-items&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Computer Name&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;RHEL8&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium Client IP Address&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;192.168.0.125&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_inventory_item_id&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;IP Address&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;[&#39;192.168.0.125&#39;, &#39;192.168.122.1&#39;, &#39;fe80::3c47:1aff:fe33:601&#39;]&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Count&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1&quot;</span>
+<span class=w>              </span><span class=p>}</span>
+<span class=w>            </span><span class=p>],</span>
+<span class=w>            </span><span class=nt>&quot;implemented-components&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;component-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1ea447fe-a2af-4110-baae-c70ed5223261&quot;</span>
+<span class=w>              </span><span class=p>}</span>
+<span class=w>            </span><span class=p>]</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>]</span>
+<span class=w>      </span><span class=p>},</span>
+<span class=w>      </span><span class=nt>&quot;reviewed-controls&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;control-selections&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{}</span>
+<span class=w>        </span><span class=p>]</span>
+<span class=w>      </span><span class=p>},</span>
+<span class=w>      </span><span class=nt>&quot;observations&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;e67f5fd9-5b1f-4134-a67e-cebdc2e5735c&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.1_Ensure_mounting_of_cramfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46+00:00&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;6cb81459-9c25-4a8b-bf3c-d8ff08ee728c&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.3_Ensure_mounting_of_squashfs_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46+00:00&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;9453eaed-db41-4a20-b684-2887de2d9657&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1.4_Ensure_mounting_of_udf_filesystems_is_disabled&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46+00:00&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;a37c2569-8695-4cfe-8b5c-bd8d6eaf9df7&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.10_Ensure_noexec_option_set_on_vartmp_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46+00:00&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;b77e1b49-a818-4d43-adaf-69effcbd9219&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.14_Ensure_nodev_option_set_on_home_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46+00:00&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;ac25b329-7a4a-45f4-b42b-1cce470e237b&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.15_Ensure_nodev_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46+00:00&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;f9c0f033-f08b-431d-b411-fe1f63c2c98c&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.16_Ensure_nosuid_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46+00:00&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;149a814e-7f80-4e6d-a613-54f027e0d663&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.17_Ensure_noexec_option_set_on_devshm_partition&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46+00:00&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;a0e602b5-e587-41c5-846b-675b26cf3e18&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark;1.0.0-1;Level 1 - Server;1;xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Red Hat Enterprise Linux 8 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Version&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.0-1&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_predefined_profile_version&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Check ID Level&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Level 1 - Server&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_goal_description&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule ID&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.18_Ensure_nodev_option_set_on_removable_media_partitions&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_check_name_id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;State&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;notchecked&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_result&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://oscal-compass.github.io/compliance-trestle/schemas/oscal/ar/tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46+00:00&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;scc_timestamp&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2d33d2b0-af5c-4c37-85b1-e4f414183de2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-05-12T13:46:46.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>],</span>
+<span class=w>      </span><span class=nt>&quot;findings&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;00000000-0000-4000-8000-000000000000&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;No Finding.&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;No Finding.&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>]</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> </details> <p><br> <br></p> <p><span style=color:green> Congratulations! You have bridged Tanium data into an OSCAL Assessment Results using compliance-trestle. </span></p> <p><br> <br></p> <hr> <p><small>Newtown, Victoria</small></p> <p><img alt="Australia Scarsdale  Nimons Bridge" src=800px-Australia_scarsdale_nimons_bridge.jpg></p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">December 19, 2023</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/component-definition.json b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/component-definition.json
new file mode 100644
index 000000000..2ab34b72a
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/component-definition.json
@@ -0,0 +1,154 @@
+{
+  "component-definition": {
+    "uuid": "a0ab1f67-8804-489e-9dac-8a035ec27b5c",
+    "metadata": {
+      "title": "ocp4-sample",
+      "last-modified": "2022-11-18T15:58:52+00:00",
+      "version": "1.0",
+      "oscal-version": "1.0.2"
+    },
+    "components": [
+      {
+        "uuid": "005c4943-2fdf-4f3c-9816-95e40a47fa0b",
+        "type": "Service",
+        "title": "OSCO",
+        "description": "",
+        "control-implementations": [
+          {
+            "uuid": "1a534121-1452-48dc-aa3a-7070bb6e3dc9",
+            "source": "https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile",
+            "description": "ocp4",
+            "props": [
+              {
+                "name": "Rule_Id",
+                "value": "content_rule_api_server_anonymous_auth",
+                "remarks": "rule_set_0"
+              },
+              {
+                "name": "Rule_Description",
+                "value": "Ensure that the --anonymous-auth argument is set to false",
+                "remarks": "rule_set_0"
+              },
+              {
+                "name": "Check_Id",
+                "value": "xccdf_org.ssgproject.content_rule_api_server_anonymous_auth",
+                "remarks": "rule_set_0"
+              },
+              {
+                "name": "Check_Description",
+                "value": "Ensure that the --anonymous-auth argument is set to false",
+                "remarks": "rule_set_0"
+              },
+              {
+                "name": "Rule_Id",
+                "value": "content_rule_api_server_basic_auth",
+                "remarks": "rule_set_1"
+              },
+              {
+                "name": "Rule_Description",
+                "value": "Ensure that the --basic-auth-file argument is not set",
+                "remarks": "rule_set_1"
+              },
+              {
+                "name": "Check_Id",
+                "value": "xccdf_org.ssgproject.content_rule_api_server_basic_auth",
+                "remarks": "rule_set_1"
+              },
+              {
+                "name": "Check_Description",
+                "value": "Ensure that the --basic-auth-file argument is not set",
+                "remarks": "rule_set_1"
+              },
+              {
+                "name": "Rule_Id",
+                "value": "content_rule_api_server_token_auth",
+                "remarks": "rule_set_2"
+              },
+              {
+                "name": "Rule_Description",
+                "value": "Ensure that the --token-auth-file parameter is not set",
+                "remarks": "rule_set_2"
+              },
+              {
+                "name": "Check_Id",
+                "value": "xccdf_org.ssgproject.content_rule_api_server_token_auth",
+                "remarks": "rule_set_2"
+              },
+              {
+                "name": "Check_Description",
+                "value": "Ensure that the --token-auth-file parameter is not set",
+                "remarks": "rule_set_2"
+              },
+              {
+                "name": "Rule_Id",
+                "value": "content_rule_api_server_https_for_kubelet_conn",
+                "remarks": "rule_set_3"
+              },
+              {
+                "name": "Rule_Description",
+                "value": "Ensure that the --kubelet-https argument is set to true",
+                "remarks": "rule_set_3"
+              },
+              {
+                "name": "Check_Id",
+                "value": "xccdf_org.ssgproject.content_rule_api_server_https_for_kubelet_conn",
+                "remarks": "rule_set_3"
+              },
+              {
+                "name": "Check_Description",
+                "value": "Ensure that the --kubelet-https argument is set to true",
+                "remarks": "rule_set_3"
+              }
+            ],
+            "implemented-requirements": [
+              {
+                "uuid": "705bba7f-d095-45e3-a90a-c55a6565f3c2",
+                "control-id": "CIS-1.2.1",
+                "description": "",
+                "props": [
+                  {
+                    "name": "Rule_Id",
+                    "value": "content_rule_api_server_anonymous_auth"
+                  }
+                ]
+              },
+              {
+                "uuid": "9f4442df-5d25-4c1b-af89-4a4a43d8ebba",
+                "control-id": "CIS-1.2.2",
+                "description": "",
+                "props": [
+                  {
+                    "name": "Rule_Id",
+                    "value": "content_rule_api_server_basic_auth"
+                  }
+                ]
+              },
+              {
+                "uuid": "1f15348c-af22-4409-bb0e-cc96a99b9492",
+                "control-id": "CIS-1.2.3",
+                "description": "",
+                "props": [
+                  {
+                    "name": "Rule_Id",
+                    "value": "content_rule_api_server_token_auth"
+                  }
+                ]
+              },
+              {
+                "uuid": "32f2de53-00ae-4b13-8fbe-952972775b7d",
+                "control-id": "CIS-1.2.4",
+                "description": "",
+                "props": [
+                  {
+                    "name": "Rule_Id",
+                    "value": "content_rule_api_server_https_for_kubelet_conn"
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}
\ No newline at end of file
diff --git a/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/demo-csv-to-oscal-cd.config b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/demo-csv-to-oscal-cd.config
new file mode 100644
index 000000000..0aee805fd
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/demo-csv-to-oscal-cd.config
@@ -0,0 +1,6 @@
+[task.csv-to-oscal-cd]
+
+csv-file = adjunct-data/ocp4-sample-input.csv
+output-dir = component-definitions/ocp4-sample
+title = ocp4-sample
+version = 1.0
diff --git a/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/index.html b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/index.html
new file mode 100644
index 000000000..159562270
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/index.html
@@ -0,0 +1,213 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Tutorial on how to setup and convert CSV spreadsheets into OSCAL component definitions"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ rel=canonical><link href=../Tanium_result_to_oscal_ar/ rel=prev><link href=../transformer_construction/ rel=next><link rel=icon href=../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Converting CSVs to component definitions - Compliance Trestle</title><link rel=stylesheet href=../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Converting CSVs to component definitions - Compliance Trestle"><meta property=og:description content="Tutorial on how to setup and convert CSV spreadsheets into OSCAL component definitions"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/csv_to_oscal_cd.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Converting CSVs to component definitions - Compliance Trestle"><meta name=twitter:description content="Tutorial on how to setup and convert CSV spreadsheets into OSCAL component definitions"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/csv_to_oscal_cd.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#tutorial-setup-for-and-use-of-standard-format-csv-file-to-oscal-component-definition-json-file-transformer class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Converting CSVs to component definitions </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4 checked> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=true> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Converting CSVs to component definitions </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-install-trestle-in-a-python-virtual-environment class=md-nav__link> <span class=md-ellipsis> Step 1: Install trestle in a Python virtual environment </span> </a> </li> <li class=md-nav__item> <a href=#step-2-transform-profile-data-cis-benchmarks class=md-nav__link> <span class=md-ellipsis> Step 2: Transform profile data (CIS benchmarks) </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-install-trestle-in-a-python-virtual-environment class=md-nav__link> <span class=md-ellipsis> Step 1: Install trestle in a Python virtual environment </span> </a> </li> <li class=md-nav__item> <a href=#step-2-transform-profile-data-cis-benchmarks class=md-nav__link> <span class=md-ellipsis> Step 2: Transform profile data (CIS benchmarks) </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=tutorial-setup-for-and-use-of-standard-format-csv-file-to-oscal-component-definition-json-file-transformer>Tutorial: Setup for and use of standard format csv-file to OSCAL Component Definition json-file transformer<a class=headerlink href=#tutorial-setup-for-and-use-of-standard-format-csv-file-to-oscal-component-definition-json-file-transformer title="Permanent link">¤</a></h1> <p>Here are step by step instructions for setup and transformation of <a href=ocp4-sample-input.csv>trestle standard format csv-file</a> into OSCAL Component Definition <a href=component-definition.json>json-file</a> using the <a href=https://oscal-compass.github.io/compliance-trestle/ >compliance-trestle</a> tool.</p> <h2 id=objective><em>Objective</em><a class=headerlink href=#objective title="Permanent link">¤</a></h2> <p>How to transform trestle standard format csv-file into a <code>component-definition.json</code> file.</p> <p>There are 2 short steps shown below. The first is a one-time check/set-up of your environment. The second is a one-command transformation from <code>.csv</code> to <code>component-definition.json</code>.</p> <details> <summary>Table: expected .csv content</summary> <p>The below table represents the expectations of trestle task <code>csv-to-oscal-cd</code> for the contents of the input csv-file for synthesis of the output OSCAL Component Definition json-file.</p> <p><code>Column Name</code> is the name of the expected column in the input csv-file. Any additional columns not identified here, for example foobar, are also extracted and placed into the output json-file as component.control-implementation.prop["foobar"].</p> <p><code>Component Definition Locale</code> is the <code>path</code> within the output json-file into witch the value is stashed.</p> <table> <tr style=text-align:left;vertical-align:top> <th>Column Name <th>Value Type <th>Specification <th>Value Description <th>Component Definition Locale <th>Example Value <tr style=text-align:left;vertical-align:top> <td>Rule_Id <td>String <td>required <td>A textual label that uniquely identifies a policy (desired state) that can be used to reference it elsewhere in this or other documents. <td>component.control-implementation.prop["Rule_Id"] <td>password_policy_min_length_characters <tr style=text-align:left;vertical-align:top> <td>Rule_Description <td>String <td>required <td>A description of the policy (desired state) including information about its purpose and scope. <td>component.control-implementation.prop["Rule_Description"] <td>Ensure password policy requires minimum length of 12 characters <tr style=text-align:left;vertical-align:top> <td>Profile_Reference_URL <td>String <td>required <td>A URL reference to the source catalog or profile for which this component is implementing controls for. A profile designates a selection and configuration of controls from one or more catalogs <td>component.control-implementation.source <td>https://github.com/usnistgov/oscal-content/blob/main/nist.gov/SP800-53/rev5/json/NIST_SP-800-53_rev5_HIGH-baseline_profile.json <tr style=text-align:left;vertical-align:top> <td>Profile_Description <td>String <td>required <td>A description of the profile. <td>component.control-implementation.description <td>NIST Special Publication 800-53 Revision 5 HIGH IMPACT BASELINE <tr style=text-align:left;vertical-align:top> <td>Component_Type <td>String <td>required <td>A category describing the purpose of the component. <td>component.type <td>Validation <tr style=text-align:left;vertical-align:top> <td>Control_Mappings <td>String List (blank separated) <td>required <td>A list of textual labels that uniquely identify the controls or statements that the component implements. <td>component.control-implementation.implemented-requirement.statement.statement-id<br>*and*<br>component.control-implementation.implemented-requirement.control-id <td>ia-5.1_smt.a ia-5.1 <tr style=text-align:left;vertical-align:top> <td>Resource <td>String <td>required <td>A human readable name for the component. <td>component.title <td>Compliance Center <tr style=text-align:left;vertical-align:top> <td>Parameter_Id <td>String <td>optional <td>A textual label that uniquely identifies the parameter associated with that policy (desired state) or controls implemented by the policy (desired state). A description of the parameter including the purpose and use of the parameter. <td>component.control-implementation.prop["Parameter_Id"]<br>*and*<br>component.control-implementation.set-parameter.param-id <td>minimum_password_length <tr style=text-align:left;vertical-align:top> <td>Parameter_Description <td>String <td>optional <td>A description of the parameter including the purpose and use of the parameter. <td>component.control-implementation.prop["Parameter_Description"] <td>Minimum Password <tr style=text-align:left;vertical-align:top> <td>Parameter_Default_Value <td>String <td>optional <td>A value recommended in this profile for the parameter of the control or policy (desired state). <td>component.control-implementation.set-parameter.values <td>12 <tr style=text-align:left;vertical-align:top> <td>Parameter_Value_Alternatives <td>String List (blank separated) <td>optional <td>ONLY for the policy (desired state) parameters: A value or set of values the parameter can take. <td>component.control-implementation.prop["Parameter_Value_Alternatives"] <td>12 8 <tr style=text-align:left;vertical-align:top> <td>Check_Id <td>String <td>optional <td>A textual label that uniquely identifies a check of the policy (desired state) that can be used to reference it elsewhere in this or other documents. <td>component.control-implementation.prop["Check_Id"] <td>check_password_policy_min_length_characters <tr style=text-align:left;vertical-align:top> <td>Check_Description <td>String <td>optional <td>A description of the check of the policy (desired state) including the method (interview or examine or test) and procedure details. <td>component.control-implementation.prop["Check_Description"] <td>Check whether password policy requires minimum length of 12 characters <tr style=text-align:left;vertical-align:top> <td>Fetcher <td>String <td>optional <td>A textual label that uniquely identifies a collector of the actual state (evidence) associated with the policy (desired state) that can be used to reference it elsewhere in this or other documents. <td>component.control-implementation.prop["Fetcher"] <td>fetch_password_policy_min_length_characters <tr style=text-align:left;vertical-align:top> <td>Fetcher_Description <td>String <td>optional <td>A description of the collector of the actual state (evidence) associated with the policy (desired state) including the method (interview or examine or API) and questionaire <td>component.control-implementation.prop["Fetcher_Description"] <td>Fetch whether password policy requires minimum length of 12 characters <tr style=text-align:left;vertical-align:top> <td>Resource_Instance_Type <td>String <td>optional <td>A textual label that uniquely identifies a resource (component) type from the resource instance id. This text is part of all instance ids of a particular resource at runtime. For example the text 'db2' is part of all instance ids of resource DB2. <td>component.control-implementation.prop["Resource_Instance_Type"] <td>DB2 </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </td> </td> </td> </td> </td> </td> </tr> </th> </th> </th> </th> </th> </th> </tr> </table> </details> <h2 id=step-1-install-trestle-in-a-python-virtual-environment><em>Step 1: Install trestle in a Python virtual environment</em><a class=headerlink href=#step-1-install-trestle-in-a-python-virtual-environment title="Permanent link">¤</a></h2> <p>Follow the instructions <a href=https://oscal-compass.github.io/compliance-trestle/python_trestle_setup/ >here</a> to install trestle in a virtual environment.</p> <h2 id=step-2-transform-profile-data-cis-benchmarks><em>Step 2: Transform profile data (CIS benchmarks)</em><a class=headerlink href=#step-2-transform-profile-data-cis-benchmarks title="Permanent link">¤</a></h2> <p>Linux, Mac</p> <details> <summary>Windows</summary> <p>Make these changes:</p> <ul> <li>use backslashes `\` for file paths <li>use `md` instead of mkdir -p <li>put the url in double quotes for `curl` <li>use `more` instead of cat </li> </li> </li> </li> </ul> </details> <ul> <li>Navigate to trestle workspace.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ cd trestle.workspace
+</code></pre></div> <ul> <li>View configuration information.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ trestle task csv-to-oscal-cd -i
+trestle.core.commands.task:101 WARNING: Config file was not configured with the appropriate section for the task: &quot;[task.csv-to-oscal-cd]&quot;
+Help information for csv-to-oscal-cd task.
+
+Help information for csv-to-oscal-cd task.
+
+Purpose: From csv produce OSCAL component_definition file.
+
+
+Configuration flags sit under [task.csv-to-oscal-cd]:
+  title                = (required) the component definition title.
+  version              = (required) the component definition version.
+  csv-file             = (required) the path of the csv file. [1st row are column headings; 2nd row are column descriptions; 3rd row and beyond is data]
+  required columns:      $$Component_Title
+                         $$Component_Description
+                         $$Component_Type
+                         $$Rule_Id
+                         $$Rule_Description (see note 1)
+                         $$Profile_Source (see note 1)
+                         $$Profile_Description (see note 1)
+                         $$Control_Id_List (see note 1)
+                         $$Namespace
+  optional columns:      $Check_Id (see note 2)
+                         $Check_Description (see note 2)
+                         $Target_Component (see note 3)
+                         $Original_Risk_Rating (see note 1)
+                         $Adjusted_Risk_Rating (see note 1)
+                         $Risk_Adjustment (see note 1)
+                         $Parameter_Id (see notes 1, 5)
+                         $Parameter_Description (see notes 1, 5)
+                         $Parameter_Value_Alternatives (see notes 1, 5)
+  comment columns:       #Informational (see note 4)
+  output-dir           = (required) the path of the output directory for synthesized OSCAL .json files.
+  component-definition = (optional) the path of the existing component-definition OSCAL .json file.
+  class.column-name    = (optional) the class to associate with the specified column name, e.g. class.Rule_Id = scc_class
+  output-overwrite     = (optional) true [default] or false; replace existing output when true.
+  validate-controls    = (optional) on, warn, or off [default]; validate controls exist in resolved profile.
+
+Notes: [1] column is ignored for validation component type
+       [2] column is required for validation component type
+       [3] column is optional for validation component type, but may be needed to prevent Rule_Id collisions
+       [4] column name starting with # causes column to be ignored
+       [5] additional parameters are specified by adding a common suffix per set, for example: Parameter_Id_1, Parameter_Description_1, ...Parameter_Id_2...
+</code></pre></div> <ul> <li>Create data folder.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ mkdir -p adjunct-data
+</code></pre></div> <ul> <li>Fetch sample csv-file.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ curl &#39;https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ocp4-sample-input.csv&#39; &gt; adjunct-data/ocp4-sample-input.csv
+</code></pre></div> <ul> <li>Fetch trestle task file.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ curl &#39;https://raw.githubusercontent.com/oscal-compass/compliance-trestle/main/docs/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/demo-csv-to-oscal-cd.config&#39; &gt; adjunct-data/task-files/demo-csv-to-oscal-cd.config
+</code></pre></div> <details> <summary>demo-csv-to-oscal-cd.config</summary> <div class=highlight><pre><span></span><code>[task.csv-to-oscal-cd]
+
+csv-file = adjunct-data/ocp4-sample-input.csv
+output-dir = component-definitions/ocp4-sample
+title = ocp4-sample
+version = 1.0
+</code></pre></div> </details> <ul> <li>Perform and validate the transform.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ trestle task csv-to-oscal-cd -c demo-csv-to-oscal-cd.config 
+input: adjunct-data/ocp4-sample-input.csv
+output: component-definitions/ocp4-sample/component-definition.json
+Task: csv-to-oscal-cd executed successfully.
+</code></pre></div> <ul> <li>View the generated OSCAL.</li> </ul> <div class=highlight><pre><span></span><code>(venv.trestle)$ component-definitions/ocp4-sample/component-definition.json
+</code></pre></div> <details> <summary>component-definition.json</summary> <div class=highlight><pre><span></span><code>{
+  &quot;component-definition&quot;: {
+    &quot;uuid&quot;: &quot;83cc8984-b00a-4799-885c-60b689efebd0&quot;,
+    &quot;metadata&quot;: {
+      &quot;title&quot;: &quot;ocp4-sample&quot;,
+      &quot;last-modified&quot;: &quot;2022-11-18T17:06:49+00:00&quot;,
+      &quot;version&quot;: &quot;1.0&quot;,
+      &quot;oscal-version&quot;: &quot;1.0.2&quot;
+    },
+    &quot;components&quot;: [
+      {
+        &quot;uuid&quot;: &quot;c0080494-186a-421d-9afd-f51e0359cbd8&quot;,
+        &quot;type&quot;: &quot;Service&quot;,
+        &quot;title&quot;: &quot;OSCO&quot;,
+        &quot;description&quot;: &quot;&quot;,
+        &quot;control-implementations&quot;: [
+          {
+            &quot;uuid&quot;: &quot;43a69f86-a3ad-40fa-ada6-2f988b951728&quot;,
+            &quot;source&quot;: &quot;https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile&quot;,
+            &quot;description&quot;: &quot;ocp4&quot;,
+            &quot;props&quot;: [
+              {
+                &quot;name&quot;: &quot;Rule_Id&quot;,
+                &quot;value&quot;: &quot;content_rule_api_server_anonymous_auth&quot;,
+                &quot;remarks&quot;: &quot;rule_set_0&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Rule_Description&quot;,
+                &quot;value&quot;: &quot;Ensure that the --anonymous-auth argument is set to false&quot;,
+                &quot;remarks&quot;: &quot;rule_set_0&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Check_Id&quot;,
+                &quot;value&quot;: &quot;xccdf_org.ssgproject.content_rule_api_server_anonymous_auth&quot;,
+                &quot;remarks&quot;: &quot;rule_set_0&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Check_Description&quot;,
+                &quot;value&quot;: &quot;Ensure that the --anonymous-auth argument is set to false&quot;,
+                &quot;remarks&quot;: &quot;rule_set_0&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Rule_Id&quot;,
+                &quot;value&quot;: &quot;content_rule_api_server_basic_auth&quot;,
+                &quot;remarks&quot;: &quot;rule_set_1&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Rule_Description&quot;,
+                &quot;value&quot;: &quot;Ensure that the --basic-auth-file argument is not set&quot;,
+                &quot;remarks&quot;: &quot;rule_set_1&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Check_Id&quot;,
+                &quot;value&quot;: &quot;xccdf_org.ssgproject.content_rule_api_server_basic_auth&quot;,
+                &quot;remarks&quot;: &quot;rule_set_1&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Check_Description&quot;,
+                &quot;value&quot;: &quot;Ensure that the --basic-auth-file argument is not set&quot;,
+                &quot;remarks&quot;: &quot;rule_set_1&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Rule_Id&quot;,
+                &quot;value&quot;: &quot;content_rule_api_server_token_auth&quot;,
+                &quot;remarks&quot;: &quot;rule_set_2&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Rule_Description&quot;,
+                &quot;value&quot;: &quot;Ensure that the --token-auth-file parameter is not set&quot;,
+                &quot;remarks&quot;: &quot;rule_set_2&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Check_Id&quot;,
+                &quot;value&quot;: &quot;xccdf_org.ssgproject.content_rule_api_server_token_auth&quot;,
+                &quot;remarks&quot;: &quot;rule_set_2&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Check_Description&quot;,
+                &quot;value&quot;: &quot;Ensure that the --token-auth-file parameter is not set&quot;,
+                &quot;remarks&quot;: &quot;rule_set_2&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Rule_Id&quot;,
+                &quot;value&quot;: &quot;content_rule_api_server_https_for_kubelet_conn&quot;,
+                &quot;remarks&quot;: &quot;rule_set_3&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Rule_Description&quot;,
+                &quot;value&quot;: &quot;Ensure that the --kubelet-https argument is set to true&quot;,
+                &quot;remarks&quot;: &quot;rule_set_3&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Check_Id&quot;,
+                &quot;value&quot;: &quot;xccdf_org.ssgproject.content_rule_api_server_https_for_kubelet_conn&quot;,
+                &quot;remarks&quot;: &quot;rule_set_3&quot;
+              },
+              {
+                &quot;name&quot;: &quot;Check_Description&quot;,
+                &quot;value&quot;: &quot;Ensure that the --kubelet-https argument is set to true&quot;,
+                &quot;remarks&quot;: &quot;rule_set_3&quot;
+              }
+            ],
+            &quot;implemented-requirements&quot;: [
+              {
+                &quot;uuid&quot;: &quot;c2893d38-1be4-4b0e-a090-96e846e15a3b&quot;,
+                &quot;control-id&quot;: &quot;CIS-1.2.1&quot;,
+                &quot;description&quot;: &quot;&quot;,
+                &quot;props&quot;: [
+                  {
+                    &quot;name&quot;: &quot;Rule_Id&quot;,
+                    &quot;value&quot;: &quot;content_rule_api_server_anonymous_auth&quot;
+                  }
+                ]
+              },
+              {
+                &quot;uuid&quot;: &quot;3c2f7129-9724-47c0-aadb-3b3c9c44995c&quot;,
+                &quot;control-id&quot;: &quot;CIS-1.2.2&quot;,
+                &quot;description&quot;: &quot;&quot;,
+                &quot;props&quot;: [
+                  {
+                    &quot;name&quot;: &quot;Rule_Id&quot;,
+                    &quot;value&quot;: &quot;content_rule_api_server_basic_auth&quot;
+                  }
+                ]
+              },
+              {
+                &quot;uuid&quot;: &quot;a4e2862f-7a1b-4182-b827-f5e797f589db&quot;,
+                &quot;control-id&quot;: &quot;CIS-1.2.3&quot;,
+                &quot;description&quot;: &quot;&quot;,
+                &quot;props&quot;: [
+                  {
+                    &quot;name&quot;: &quot;Rule_Id&quot;,
+                    &quot;value&quot;: &quot;content_rule_api_server_token_auth&quot;
+                  }
+                ]
+              },
+              {
+                &quot;uuid&quot;: &quot;daec13ab-829e-4dd6-a9d6-9ad18391681e&quot;,
+                &quot;control-id&quot;: &quot;CIS-1.2.4&quot;,
+                &quot;description&quot;: &quot;&quot;,
+                &quot;props&quot;: [
+                  {
+                    &quot;name&quot;: &quot;Rule_Id&quot;,
+                    &quot;value&quot;: &quot;content_rule_api_server_https_for_kubelet_conn&quot;
+                  }
+                ]
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+}
+</code></pre></div> </details> <p><br> <br></p> <p><span style=color:green> Congratulations! You have completed this tutorial. </span></p> <p><br> <br></p> <hr> <h1 id=examples-csv-files-suitable-for-csv-to-oscsl-cd-transformation>Examples: csv files suitable for csv-to-oscsl-cd transformation<a class=headerlink href=#examples-csv-files-suitable-for-csv-to-oscsl-cd-transformation title="Permanent link">¤</a></h1> <p>The examples given here comprise csv files that can be transformed into OSCAL Component Definitions. The csv files comprise required headings and values expected by the trestle task transformer, and may present optional ones as well.</p> <ol> <li>OCP4 sample input</li> </ol> <p>This is a simple example csv that has just one rule per control and one check per rule: <a href=ocp4-sample-input.csv>ocp4-sample-input.csv</a></p> <ol> <li>Multiple occurrence sample input</li> </ol> <p>This is a simple example csv that has multiple checks per rule and multiple target-components per rule: <a href=rule-name-overlap.csv>rule-name-overlap.csv</a></p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">November 11, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ocp4-sample-input.csv b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ocp4-sample-input.csv
new file mode 100644
index 000000000..8f0c7ac41
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/ocp4-sample-input.csv
@@ -0,0 +1,5 @@
+Rule_Id,Rule_Description,Check_Id,Check_Description,Profile_Reference_URL,Profile_Description,Component_Type,Control_Mappings,Resource,Parameter_Id,Parameter_Description,Parameter_Default_Value,Parameter_Value_Alternatives
+content_rule_api_server_anonymous_auth,Ensure that the --anonymous-auth argument is set to false,xccdf_org.ssgproject.content_rule_api_server_anonymous_auth,Ensure that the --anonymous-auth argument is set to false,https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile,ocp4,Service,CIS-1.2.1,OSCO,,,,
+content_rule_api_server_basic_auth,Ensure that the --basic-auth-file argument is not set,xccdf_org.ssgproject.content_rule_api_server_basic_auth,Ensure that the --basic-auth-file argument is not set,https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile,ocp4,Service,CIS-1.2.2,OSCO,,,,
+content_rule_api_server_token_auth,Ensure that the --token-auth-file parameter is not set,xccdf_org.ssgproject.content_rule_api_server_token_auth,Ensure that the --token-auth-file parameter is not set,https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile,ocp4,Service,CIS-1.2.3,OSCO,,,,
+content_rule_api_server_https_for_kubelet_conn,Ensure that the --kubelet-https argument is set to true,xccdf_org.ssgproject.content_rule_api_server_https_for_kubelet_conn,Ensure that the --kubelet-https argument is set to true,https://github.com/ComplianceAsCode/content/blob/master/products/ocp4/profiles/cis.profile,ocp4,Service,CIS-1.2.4,OSCO,,,,
diff --git a/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/rule-name-overlap.csv b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/rule-name-overlap.csv
new file mode 100644
index 000000000..7a4140dcc
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/csv_to_oscal_cd/rule-name-overlap.csv
@@ -0,0 +1,7 @@
+$$Component_Title,$$Component_Description,$$Component_Type,$$Rule_Id,$$Rule_Description,Check_Id,Check_Description,$$Namespace,Target_Component,$$Control_Id_List,$$Profile_Source,$$Profile_Description
+OSCO,OSCO,validation,RULE-1.1,RULE1.1,Check.1,Check.1,http://oscal-compass/compliance-trestle/schemas/oscal/cd,Target-A,,,
+OSCO,OSCO,validation,RULE-1.1,RULE1.1,Check.2,Check.2,http://oscal-compass/compliance-trestle/schemas/oscal/cd,Target-A,,,
+OSCO,OSCO,validation,RULE-1.1,RULE1.1,Check.3,Check.3,http://oscal-compass/compliance-trestle/schemas/oscal/cd,Target-A,,,
+OSCO,OSCO,validation,RULE-1.1,RULE1.1,Check.1,Check.1,http://oscal-compass/compliance-trestle/schemas/oscal/cd,Target-B,,,
+OSCO,OSCO,validation,RULE-1.1,RULE1.1,Check.2,Check.2,http://oscal-compass/compliance-trestle/schemas/oscal/cd,Target-B,,,
+OSCO,OSCO,validation,RULE-1.1,RULE1.1,Check.3,Check.3,http://oscal-compass/compliance-trestle/schemas/oscal/cd,Target-B,,,
diff --git a/latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results-nist.png b/latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results-nist.png
new file mode 100644
index 0000000000000000000000000000000000000000..28b79f7bef9cc0b27c18561aa9a025feac0993a4
GIT binary patch
literal 56735
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

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results.drawio b/latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results.drawio
new file mode 100644
index 000000000..7c64488ad
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-03-15T16:02:57.041Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/13.9.9 Chrome/85.0.4183.121 Electron/10.1.5 Safari/537.36" etag="UJZRChKMV5c_t9k7e1Fn" version="13.9.9" type="device"><diagram id="SDr-ZQr7FIBgMitpbA9r" name="Page-1">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</diagram></mxfile>
\ No newline at end of file
diff --git a/latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results.jpg b/latest/tutorials/Transformers_and_Tasks/transformer_construction/assessment-results.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..335b9bf1c14f296249a848bebcf6a026e3fb6aa9
GIT binary patch
literal 43615
zcmb4qbzEG%v-bjp;;zND*y66GxVyW%yHlXJySux)6<eI*4#nNA_)DMXr}zHz-dR3p
zb0(QDImu))nK}Em`1T8cEFmH;0ssR80KncqfVUNZAOHgV5B<49yweA$4}S<63JMYm
z1{xL?1{wwi79I&677h^(1_l8I0TBrq83h>@9u*B08STA{{09W=k0itg=yyS6I2gEh
z?*EbAdI2cV;Edpm5MU$#a1<~I6tK5`0N#5iA;A6+;GgsX5(?rY7&!EME%skE|E_v(
z0tOE8;cXcJ4*>=MM}|OtXS|jIAh^s@aUIsc*m(i6U(kMjxB=tU)};%)Tywl5R}pPS
z64W!aC5XCy1FW_$B&l2S`S;!q-c|IAyGVW1HZ@;?TV1MoT=zDv@6Pg^=G<Qp`)60)
zzp<I!6P{JD?ovmmr%+gd$dW>+Qy&@xD3FxurV3V{x7QqhtZDh&j$^$694`?}$Eu>p
zy~>WHo|fAcn=M`!n7VEZ?R_NahaA8B8x;M)@h44f9NZgVfEIi~F>*Q?I=i%#vOg|#
z@rV`x9k(T!1{Z@Pt-CY&%9<C}t9nZ9Axqc>*OfNm*|_lOY<~uq;|@{#KLGbNt!O-C
zFnobR1TQ@RQt?RISUrGHGOE^3Ex#*%Ep(1-B@do;dwRF}F;b5{^#SEaN!(CH--qi*
z$7RAvLr&9mabYIanVNrh@lWZ4IU{+}zxqR<eZ&y;;4S^p2E%c4>24Ert3Q*ilaQ8i
z<~*?%b)`cXm7S$+Z2>%*pU#rD_r2@t`EN87W054W8UTr8D4iMI7op_c;G(|Nz2IV=
z=G^wCYioBp+vF>D7k97RV+Q5~(fr}->f+p&D@)R8ORL(@deb&wV47@bPUL5vHtbaz
zgiq){{|%2)FpwnoFK7ZTPgDY)b)Gx>2KSe5H3oOzQkrQ|a*}?5P3Ayc-yb*};k89i
z9{gJz3{}hAC>#Jz))Kepzw>eXj#D^`@(qBs&Ca$Sc<2mqVV6#rOTvHD(*5Pdl3BT1
zVL)JoyH)ioeJo#G3}=$<n1KfTuYbd#6b$~ygT8AJ!tddIULF&s^&DoNMnm#@wbMQ{
zPlx1j9}mrBTgL8%h~4igrIoX&dAz^#JJA0Fh<qR|f$qyc`t^s;b6fkUZ){;iNTdl8
zbB!gha{Ru3+?|Cn?i@|`BlF*q@1;lzmO5d-_eT?V6ma-cgYH1Jg@tN%Fe&ns+{P_2
zu34CV9dtP9I!Zq3wgT#3PD>(r!fnNS^!wBJZ-TDNla|CH`VSB&ivH=kwQ;Pma|p$I
zG&8f*35vppV!Ff`#1fv{aB`kF4>E;0@w?GNqvzwCw149K&k+GY;PyE%G^OdQhu_%8
zy;uwiHWm1oIe{1T)s$Dvv^k7j%r{bzn5VX8wP6@n0@ZV){Qdz2&XN*0iV652ZcjcA
zIrN9=KARamGhxN15HZkEUF5TJGW%lCjO=kWdOLl$&J=&nXR4m!NjOn2fTsPB%zZD=
zGod>XnyD70{ZB~1e=FuYB*gXgs7F=+&3JRMdg_FDaX@dy>`TR|Lbn@XRy5mj6(50f
zhsn|I;(gylz5HXpS7jdr*>Z_(i!02Rcj-U$zH*Ec{<U)caCoZSw0xL&$7NUf`y3}v
zsXU4wla3~693B)j69>YxzX168bN;mZi-eLtsgv{oLg~m_b6Wp!pyyQ3q~;<fgT9Wu
z;_$V3p;b?A7_fNK7i*M0%V^nfB3I;z@tf7j7BK1k1@PzczXyGcE!l8{{88^}cs-1#
zTC^5B<GccixnmKw?FH+Q(Y0xtpR4aiPRr?~0`IOncJ^OL?*?gH;=j~@K=kN^BbDnE
zNpRBH^>Q>#@&E?yG`aUP&eW)eX4!6C`HLfMo2r`MzaRkb6E{8lUlV6qRm<%kC8K#*
z94$MxzE`{_&5PlZ@~}W&$Z?mSqH|eT&4!thSu1ItQYWca`w(wByFyFVddz&XdYa4e
z4`7m!P*z$kzyDAN0>L8{DFe6r>$BHi9_h)cQuE#r=NXoa)2IF~T4(F-u5|g=QG3>l
zoyB}XU(azHzE)}O=#yto{j;b4yPy0V-mx=Do|$R%iK`VI&r=dfgF3c{&ey!;^!#{y
z)oyQq?{Nk5uE~Mb8RY2%dJ)kEN-O_FdtZfQbp!vo3US)u_=}iKG7NpW1u{!k!??V2
zde+R`F&rrFsdEk<3iw=f3nRf7MIY!dOj#y}AH5#`i3MGkFG;2bKq2o>X2BwQ=Ys9%
ze0SmTtgb@Bjz8`jp?n#0ho4j+u&!z+;9OWJ4?$tsNSL%=fL~qlA@g`T7$t1zGBH#|
z)cYqOk*p-{HLdUynaBgBveffvT0~rH=$*VFSseYaaYUThQl>A=Ov?g2(>lM1YDZKc
z|Hh~T5)JkBIk!bG{DjKB?gHOFqC;M>I-z^!)@V>uNjLO->e~B`{4e?s!-2Bnu9}C*
zQ~O{zTjbW5dsNG>RGRa$_mGCPCPgZb+exy15sKdaq-pdo;lBzf<b%)Sqk@ldQ+#MB
z9~$@z8e{|ec`6Q@K5e<Pm&9Sy|2TlhLi_o!)s-H^t{}dzd`XvoSESj+TOPX6h2Qhv
zV1L~~B+CYV1OF|5-5jrU!yOX0py^|TvAX9oQ)rz%_ibYGLUqaSnXnnL^bz)dNrNSi
zJjPG$U4>>Ptuw~5Pk2+8-*o)GoBXjvUKnpUuBUvsJcv}awh{$9DgT&^c5TDJ%=Wdd
ze|weue?WmrJE~~>58l6Tq2sQ&e*OFQze`}dAInP~oOaz8=#kWyX-XU`J=vcs;h29*
zOH^0$#n18@x2ie-V@WE@_kR|*{I~4;9XM@nU&}YmT-z+$+dK=q{Hgki-S4SXzc*+i
z%+EY4qFqRYnrPLM^7wIjvwr<AY5247{r}i^|5yG0h4Jp*F(L!NA>OSe<Oi@15bti_
zyXpM^1`Y{;LPJME#UNrvX80mUhDpq*M?%U%&cy2X?)O2zJBnbC;4h!m7-VP4o7#;`
zQ{&{FozabDUI@5v+|H-AyG5h^XR*m&UaNDKwJY*!fdMQ17U$&pN5M(;5xfN1oJF6l
zz;e}I?13vwL*R&p#z$Y`;BYO1oVlNtLL86At{f`vXVZ@h*k^X5nAORteh)A5-Oqv8
zA2wd}C9>E3qxl(L{hr&}g$WSdK8Z^ZRWCOPm!-iH@fY+<DS=gbfE^A&SZEQGseSD%
zAkO0Ydh`XPLnK&vs<BQlfm#PxPKFjANKlH`hrOQ0l1uPcz{K*K$ESMbIQ_Wp<K)Pm
zHoK=>O?9m*r@9wd-n$HLuCvwQim}~Vj6dLZMgww`;SRf8RgK!qcxSd$<BxNc9$I=<
zwov!B8=C1a)f{IQJZZwmBy6{smab+OgG#6dZW8h1Z19l|d3pKP7u}Qme(ll^a2k7b
zl;ue2+HKIcWOUKgHPe4rTu3fwN>a60Vd-qCORmf{5NoLtrqLC_$`o2udIRLnIUJCA
zYulN>0aV=}9urfxR>yxSwWjt3bxascVVxYUDf|`}$8(0+h9tY3qxTDitZwP1Z)>W|
zKlJ?Rymeo4C^?&Oq&V3>CZzPM8J%bpPh1%C*LQ65hd_KdS@99SM-$r=vAj<!^h~QB
zGO98MBx=y$H816pDLz}zU1zGhozJI{RRu--@~Ez0pZca59^ti$1nQf((21~^V1kPE
zC!d2`s5i+l#C&v8ynIXaZ%rd1pdZBRzk-giE)Sm~uU?*1=rt5R3VhIy;?}#z!-FtV
zf)2Kwr6-Vo3cq@4^~~he)vJ?;&^Qs%cpedHsahLVu-4G4wonz()~HZ)Xqp;dB%MCA
zfh+(8KPBbTVOfBDBTYiW<QW+soxQkp-g~*LAWsP-3($p^40CtL`<zFwp~$GemS8dL
zRz$MR$HtO_1?gC6v^VaOOrizpfbd9TVYlZVo>h{9{|1n0=nr4DO<rxcWLHEhAR~kd
z%d&VdnG10g5=RSK)26&u9q^WK`Zf9Wa=-X{11748kv{rz<MyOlHmjH0E&5ir%%yv$
zxa7<?2GSM(I%M7J<kZ-|pDXS(zQ({ws790SV=;5zFy>Km2O`G2ah};e<|F5WY_ujJ
zEtOU{`jYY&7$$VsjnB4$()!0x<7svou}$#=%>zQ}(wnFfaeD!v^jVURH1?_HpI+uV
zmQ~^)MM{48vbv=ZzEAXyoFRr!Ql+h0NQJ#TY|>UQ#wiL$^tc8I<Qe<unQh8Li`L?1
zMVsr=ob0Fc<-l=Cs}q!Xl(7Z4dfai#j;?Ne6K;XUPUZHf)nxiIpITkS<af~aVOdU5
zLHLj|WnL^Ul_o^x9v__%J*W}k5IR2lw5?YEx|@&RlL3j4^PO2Q2G@IkI<i{SLtj>Z
z$jMijy?vBguXjKK!g6PXm{;iv>`FB4RIu`f?5{ho7*1Oea5h!uR$-|>1yvc3O0v}_
zw00CLx9AB@i}_uvaL^!g)bpwGv-%Qbw`|a_zGgYVrN$UVOahNNT^u#)gNLWpRUL+R
z#)g=r2=Ny1nU+v!BJPEa)!;tt7EhG7RxkBjr5@xW&vJ8=wD?Ky1=sfu(Ma8YpfN@K
z)t0E{inm~Str|`FGVtK*Qynb1s+)WsZ(KHEGb%M}%bZ3VmetX_ai5L!^ej!h#agtg
zsoTF~rJdL<@wb+ouW<97sB-fK>k<-wrS+#84w&1LSB;u;FUAkkQ5WYHMpm=-Npw&B
zGawsP>(U##(rjZzXF8FNHzJQc`Yyqaa<0JwEOBAYk3SRWe+ENWK9X<gy)U$G-zFox
zzHHUf?u3ubp^L|zk)uNlg=#6mzGpdbx|pZT7*#Hn`bL?JNwV@5B|r*zWhc7R>A9Ti
zN%!Uh%#d%Mkyo$u4=)N``1JNZx?SfC%aP?B`KG!l@f_w2eCw>|PWvta+Utfj{u8-?
z8Sb*OF-O?C*~viH2vH1^S9#qs(vH0OO!RWiqf$-D5tYv67wFlqtE?4m3r&dzQw0%2
z!(V5vu(BE6$Ia(~0nWscQ(3F{<4E82qvChz!X*;N;5uBik8gmepQE!5W52WmRuF-j
zz8-gx=z=JFxs?Z`q;u@~nv(|!TT9Z2U8&+)Eo)*Co+?el*Rr{9fFF8w5U*cfdHL<T
zbT_L1vI{Ry7A?H1VHsR*o*oEhCL-k>t)m3y{f1Ai8Vk+94&2VX#G-a`Gmo<k|Armi
zS#1P?B1PQ!P++`3`)rz&hdnDUMyGsNVZ-7Pnp0okGO^)R;>Dq7_|?nnl+1RciW(}V
z|2Fo(7wWPOWaO_h9$n(dl|J0)UP;oDms3c=Ld*kSKA|;#&~4Nl{ECZ+rBiF1)Um(|
ztC~kZ$}9GH7syC*kGuQyYVmvEn8&sJz7Pl@X6=a^ni7&f663?T-LF$`Lo2Vkw15;J
zw%qi*yJz%gj(t*XJ=Rqi=P(hy7iNFH0Y>H0J~5~#BcoT<@LXhkc@bV>p|NY>I3=t+
z3C(HLRGG=*Mfx;jTB@}*KGZHOB2Z*N$IH<un9EApNP=Qmq&uub@$rm)^tWmuj9N5O
zWw7Mr`b9M1@ZW3y{=qRLvbwf9_t1TCohvL}^$Y83u358X>LXEM#|`n~QRw;Rj7UMN
zm<2C9`?Bb7m<VY;7BK-L&TGZ%xxa_%g0`);?VB@`H<-He^REM?)kahoPH({~Vma`H
z6G;hyME{U)2E}uxwXKTLr{G%K(`7np#)2{)<r!qpxBFxKe>AatxbuDIQBFMJJG3QF
z(aE<|<Ry^=RCX$I5#ajKAol=SIK+F#NR@)H3+QMEep6AR%;l^b+%z=&R784sgsfqZ
z9nl39zuU6=3r;fkPfuU<9=;A*1w=5*#9V2p6^xjPotc`oOeqqzMkpJkA8mIl7sKag
zKw@i*zX1*eOsIT@yPybGSbcdd8mUxV`7hLxN-2L>vp9sAy((Pp{#mEH%Z<(Tqq^)^
zg)q8>Le!JHG@H}+Si4Wpm1B5)xmEH?eZA-O{!LYZd)#A{72e*`EJS2Sfyv}ipJ9|l
z9wZFKX>ujmsX)<wK+mJgQnrZA$&fbyuX!leyZPD(3Hh~|5B`yUx2(=h-Au@6UuEyd
zh@Nt#xw=GiIxQSPf{p+>1=f86B_ZVETbV$&)=v4yujCktWdqN*e=ChIyDyCzsMdna
z1!_>We9xtMX*36ahI&I9;YN<v*|BQf=f0E=zd)jqjadTRwxmli-Ml0}E%o8bx}tEg
ztH>>Fdk%7%*q`zk7G`~3lCDz2u3p*1O~0(tcHnRIxxaj1|NQw&okXNnrP*+VHMV}o
znxax_TOX(n+~jn}EH;qS{kztr)ZuVl6P|376%sJMkf*+(sVhk^)FPo_chJ9_Qv+-2
zmqbcwL#~ZcTwVWRR%CF?cek<Y2pv-%r;eRGQ&OU5;XERpZLjX&SH6w3F8&<VzQT9a
zy?;<~@19%j49rcPlEl`~09XAoF+nhq?r)vh$$*@eCSSaYUvx5&2x*O}Diqbm;S?3m
z*xoF`Gx~*CjHG2EfOu}ZmzdbMzf?9=P-?|wtXc+0#G}VJ2YPn?TmO1e!bPPVC1`7U
zdo9>e!&LD7aL1E$_D(U5?O2nM(3Rzp^60@TYRZ%s3<FF}>%`S9vBLJLrm$%w;hiv`
z8^zumKdYf%C^8D|UoQOZ%{)ih56%DNEUA$k15|n9Ucoz_fZ3;e1Aex9^P*W%Ld`8D
zImIoML%kM_mykNsg~^0&W>$Suve{3WmY6eN599T8rKwfX9~A3&K{JZ*`G*#6jP0Ie
z#G4m#aUMB5hbSgZ)jBbR7n*YV?5nj_I;ZdU*5?YTA?94-x5Hnp$RcE<XSCw<kHe81
zv9!4m5+sPjjm8#IDct*&V?@GklzP;&<7<Qi*9CRs{;|pR_rH{_HwR?UK!1iKd32^i
z(^Q%2U#?}eSUF@b&<xjTsF0HK;hI6Ee>cJ1Ba2!?L0wBDO%l?LR<Ab&y_Uj<qVmlj
zlIn}mmMMPXrcPMIyMkAYyBmGgV&#lgMnKk0e(G~__bOn+jeP@90tW+`egMma1I?~P
zp%+!evTU`w`~$Wk0C&5C-#K-oI>w^kH{NSJ0n-CwcnH6!!p8_Dyi4N&M>`3n25?K@
z1NdhdqT4L)G&f1~kob8DB=r=7cu0dTcV5G&PA|RxS%W{$Lv|a*b$b~w?>4j%N$Snu
zzWC|!5ebf!-4!?Qevb>r@S3QH#1URvx>dO_OAj`U>d>sVqNtW@V9!m7ZT%pa^Uw={
z*$ziU+Eb+Ng<XTA{;}X}fl3kyZ>xC<Eu;Ps!mHbk2)6I>b5<N4UyPGd7bGm#=KQzU
zRGGY+T33W!+U*L5-%+!s?ktc27<w6X5FtxWRF00K>4H%GMlf<bB64juz_n_*xKDrz
zY&YS~GgOUj7%Dxw8|Fvw=WZ`}u(X#C5-F}`5T=JN3xw#M;yUDhKY}zcIf5WQ|JwW1
z8+sW%^T#B$4v+1e98C95YSIJY1wKSv<>RCSA)IY?XxyJ1+{<j@A;#6Dw8rB5zRV%i
z)4T!ZY~KJHRS&saw{;0-CfPH%yU%9W$F`MFjH*$q_%`s!HC*$JFPx>GvRA)fO$kT0
zAG~~-qjxW#yZBQ<?<`%yu`SOohVo8LZ%)&+TUHnBV<&fK*Yc>U_O4Xvg{5CIW`i^<
z(N!y&(Fn0tt=1;i7W8a-rlt6&$9q>H!CjzFOcFV8(tS_*5e5}+03Tw=gSZs+LzTtU
zyI(Dwdph=0X|1CRwlXb4^6`pg1QP|##vdRJM>S|Q%)c5$Ar_2SP&p4j*|K_h&20hI
zx5w23SdcIGs)Mo2AZidPsD7wHQ+zKxM?<@9Jd`zBZrlPPP&9>$o~TR|oY1Gd=(*EX
z8OvKhy-K%}P)eHY{tOWKq17MD>ind*{>aBD@CI<XCUO>3lEq6#Oz5LNSRYT8sFgod
z<vTVD52k#AV2aj|0CHXU4Y9rfY-b3wkL9D{PtxW$8YV43pC6fMFnn)>m*JRSBk~ip
z-vBojAx>`qq1`S!S5-sneDdU@84V;S6FASh(xI!-xh%c!6V|n016gj%ROWSJs$R4g
z0VYngDFJP=c=xx;&z|WRj7*jnBuRTS7Kg<*;&u4Ziy>f;x-x07GQ9K>28c0MtQy~t
zib(Y<9MF)BSjcx>TJtM^#D9S%@q_%fKA;X(=_`SS+I<;R*++sfs4YA+%~p6KL8mc7
zgHG$y0v{TE<CT48dt-})^al9G|0g7X@}A-O@B#8qvgz-<&wHK+0tJ;3jfhy_!+ShH
z9{sC6GKm6{UhWUl+Rcl<LIUpzBz~~RZ``!(ZfZ6cHEWyt?Y(`j-vdzN4$b(YqZVxn
zs+E35qyG%XoIWy2@BbK^=VZ5*Txx;x2H3dC?MDGlYbz*||M^p0holUpqJktUK<^5Q
zb;9d4;<8Yt^k>3_->vkX(Qj-zVjHqz68aW$RMg3rEc!jWm4Hwi@%qSR$YmH=sQg6g
zmhb#f5mO_Z@RlD-Lg~}N8-V;VvJMyVN0XrbBHNJ5uF3{=(}d!o%a9eP8ho1-X5AWn
zGjYwHBG!mmOzgqkkjozLZW5Z>#Isz)K1@&%PurF@(tCsb`Kh*k+eA&T3Ke&Oo|W`>
zxJibT;|eHJ$Y5jtNtl}D$(ivL;+0gCYNt{fn5R}~+mE-Tu*B`L!N^aEC_F`szg|F@
z?^0tFUoG)oX>j_MYa5`%gk8T!`C>%*qQisOt%CY$tYc2!duhe}@%>+(;2LqeAlV4&
z550@bHsB!3Z)vPV6OP<kJxE0nGIdIN(fUTe7#W5RGZA_9tmLc^*X#^YYi^2Bi7TM{
z1I^ohI{iUFcz^mH*eSCH5e*<_xNzPS>(4$hQth_wW}_CR=Q1B<>g+_>5i9C6ZN_4=
zlpWbJSNOi?cYAGTZT>UAk0rGzOsK2c*dXx`lt5(3nco*K?O|V40t4f-#;CENAiqWY
zjk8$9kWPj9GkMfFnid`f*S(-+#K@0e^Us2ofnmsLm}tJfzVE8V@UB`A;1EzBAR+$|
zr+QZ{6bMu_M)?ou#9svDkiRPE5s@(HUy$16*8ccQv%vpo)^9Q@*sn1KG=ZQ1%C>wP
zIA?o76MIo3JL~DpuS;9$LhWU188!Tc3aQ1}G}KC^3N3CDaRsH+UXUO%!Jhb0**Qeu
zFjszNwqCI=LR0TL$4<~3K5}(m$RU1Es&O}y&-v~fKzX(psL0T=TCVPUxO;Z2omV@>
zxOlmNoT)zX%M&=;Aj4$j!p6YO3<uLyVAfa!Bdcd4TBml35jCZ@J*Cetq#@$%r|dRt
z*a<s{uflvQQ?kE5G2^Jo4jDEPDSSdoMy-g$3L8P7{O%5{_VUS3f>B@sZfP;InR>TT
zBPot*L`(IM6iATH%uw}h&PW6VP3eY?pMg_v0Ha69a2JQ3r&p8j5UANwbuh;h!>ag7
ziA+`05{P!g_Iz7JlXY-8AhUoQ(lndty;rlS`7Mq>wqQVp4f7UA&Di#%kfmLS+CGQo
zk0~???=~vV@fPCxSqfsd_>CAf`cO3_;ld&$zU3%0zuN4KqRw$9l(MZ_?ep{ZDU*5+
z5WXjTA)sJCzE2y(`@H>0|Dpg;iP1<HA<>xx<n@t>NWa)Se2dMkW&SFs5MMWiLB?Y6
z<AOmiF3-__dh?Q8uoucNAiw?}u|p_+@Fz6GM(Nzg=7p2cMEyk401kJxBKd^H^}+3B
zD55MgW9^P0o~o(buaNik3=lG}9m1N~25}p7v)|qTh9{uQ8Xuzn)8z+A6}Tr`KBS(f
zMBXW`J;8^P@MOz{INeb$*kVlmTcFQJwAr;Fq0WUUnxFFnX;9I$>0j=~=h7(&;oZ5m
z@RUzN<0;ujy>i?5HcTj|Id_MNQ&_sBHIAG#GuJnyYo*RLYU8Dh;!TDfd@i~IT_L{P
zYpD>!+Zw}u+PS1&6*%LFjcdIsA2k|jT8o8jabfJ;Pul1hM(ZE*gT!hKmUx5+LzCAe
z%eYF-Y|x&^oHgGFOO%M`8RgkFCjDkh=?OVVeMG=<xED#6O1A9PGr(g|rOtM}w95%5
zpX}EaAiogibsGi~_eG-3#2JtEV51pVq@u3*Gfr#<Wc%HA%+cpK-g;YZT!;!_c&BBK
zhcR_CruB9E%iXpq(8ky!I8vD@Ru3`I>Dx>+y!0CYp-U~7CQ;^U5!XDq9%G{umPOSU
zSRDV;vMNQB&znoTrG&0qR2)(Az9G5U6zuHjqq(BGBHeeZC9V%g&7%&`Gm3q1in0X#
zRO7V~U<6i$;*IS{JqBDHnM))%ij1@La(8xb0Ql158NtXzGC1txQ$Ac2JNsDuFU69O
zgCK)czB6scI<uIZ$3mwbBvb|+EIbDMZ55iH*uGEwStr&mmf7c;TJR<LbOAEhOtcm_
zE$J5aiGD=4ct+0f#U&BYY3P(3blMEe{gKJvLGa)=Q;eVBa(e3rD-`qX`*5|>_Mhe#
z5OD4E4Zlz1iRf01&<BfL`HRplomTrTK<S-ghXyMG#0i<tuOGiXrCE{3@#GcrtW+mG
zaU+cfD(9C?QZ+~#b)@&3cdojv04Bw0h6Jo)i7;zESGGejR{|A5-ATgA^~T!^K3yH6
zs-O78=`GbCPX}xmZya86KvSc?O$kNmH#5BPx`XWhzgTu?H2$7)zki+JYOEWBs+-Ym
zY8dvTN$5J5bZ<b^N)Cax$T>s_Qx!}Qg)Lhi8f7X)LWN=SXc*R#e9Z*k&iV~Va@u#-
zv5p3`e8j90n9MwXZzWDA7Or4SD1EEPJhc2ppc?sFdSunjV@X-ldBfhq_S5+|fU7c@
zoBDon<wUh$$(;(nz<A8rU?~~|&Dn~}i(C-_d+ZI(+k#82sV;G|^1X5;%D#~VfJ-K(
zEwM`3dF|>97WthkrWsg{Nfz&5<GlS!OHlh<3_`me@$)ZHJ`vGsmvz2Gubr2zFLo!O
zjM6I4x<BgHp>dz2RFX+NHjnj>E>A9T(LXk-Ov_Uz5woSx35)XxzQz+8Y96LA;0;C_
ztLKTN-W@J%ua)Z95{uxJ{Lu88f#m8J<w!p_;<Q$8a?&e7O+Ja!)|6qhar<0TQXemg
zhr`rZHLY9ta`zHw8bakrW)J^@tlhhM54VBrV0>7VY?VyomN=J}vdcau07c|<)>G;u
zLxUGn5NpfGgsIGisp)*TA-Mvt85b5JUzpBZw*;Y<2ubI(P##38oDWGBD~GptXD(&7
z46LyB7Mp2CPRffcPRpc*J*^vrnq;gU^{FjltGO~U_SzzDTsHu4g`0!AgGft|ot6^o
zvc5+)j-fv@$g+BWnr}Pa03lhJa=KZtcVaiQ+eDt*gX&>COmSL{*u6PErgc?XYCD~8
zM;!Z*S*}`d_Z<_)UY=DzpIz+7_Ldxf?wRJSD{19jR7YM@(;_&rs;}}i8TGdQ)yf6|
zmt@5G$Y#Saj$4lS3HSF0DCK386!Kfr9-}m2Aw2cS;H(CPyf%h<8aRK(aS(-qRlVtO
ztyXKL<x10{Ilt+QiP2K+5^!XB{zemrIR6_Kl_ss8nOg*fjZ7goxsqgmdl?7VA`}~c
zJ(Y`Vmv-3l8(@iph8zzOVHk?R)`tUmrZ-lk0|T?iZDIM8JzdlF;&Ssgdg%A<YOd;t
z$om=BIMy8M&a$?aH*1W#Ukft}*#Q-y$^V(VmTtTZ@x-{ETW3WDVPgs+i29m)q@2Rc
zzagkkGCWhW8ogAU%pYoU*Q;FZ&dkR5G$fi*T!Hz@WlyV*rD^`|cr*9BUlJ$jb66Ha
z)=4nGb!E<Z=S3r$^_MhAXq$QZ?BG%4nCU8uR8+B$m?heIvdr~SH3Qq<)>i{4oQ_BI
z*4D{*ITjkq;oN(Sx*V8zz$z@@sWm+a!@csE4D-e$9uQ=0!r+bT^s=_<X3&t!rnV#4
zCX!>QpJJUWv|Q4aOlWi*U$BOV=jFz0_#m5tu5Z^10>iw+FZxZwIL#S3etY5A(WOc!
zwXns5@S*qM5yev%e#j5&kYJ<Ex^C&5E%|)=?|D9UNA<wL)KD)FPK5kfV!-;;ViLq~
z26dFw_|g(oGGlF$<QhyIgW$-pZF4pzRO?{BEH#25)hWXBYhx*7yEvC#VMS^R2N+LW
zZ+SRC$ed@s+^C*_1(ytLdAfw8mKTT<3r`=jEz*3^d3IFTH}j~=&VqzfT+$E;)#APP
z>&h<=wjo-cI#DSir4=<#yW2wQMxu2Y<IshZPGw?&f5CSI=hwp7D%wX48jY3FJlCvl
z*M(F9`w5bbb$S9R`Ud;WiKq^@nU42S=;3aL2i%Dq)vVhjS9rO38(#5ohiN#4o9&5?
za7nqv2MNdKlQ|_V5IoaTG!-d}yNqU3MOGWU0obVAGo?yMjK`LO^e{>MmtD6QF@%L2
zM6*X};7`+4Izc*A+RTV%5h3&|Hhd?-99e2cVZX3XOL#=`+k4`H!Xj#g=5e%rB(<H7
z-6>lcvr6J*H3RkFPoXQ;d~R;}O@_U{HP-DZjkVf&SDQ{YeJUJH)5O%8tftuVJ)XTV
zFh0_WCjwXOy@a1uPwRpGkxzGrbKivV#;KO`u~LrpiEMID1_Wg}o#V8os#i4;_=Z|y
zx~?s}4U3~cR`^m~E|r>!e`ORIabwtGn6_HG3f~oQuxpIjQ!?oDQuD76_#I&~23!eG
z!t58PRYYO_fLQMQAsy~F^2CNXi4bskT>p||)ZS-ITJi(kD1?!FRjZ>Ku6?%-!2%dA
za1!ER&}wTv1NJD0q5li_R=+1>BfI@#T70A!cCEgb@fiKmFLC%LbuRAWjf3-xQS7)=
zs44)(qN>W&0LWiBG<1ng<mdaUUHI`yq8~?-`oP+ke{QZhUHRts#Up6P%VR<_JAsTz
zX`D2~(2_hgvfgF0aOgZiml`fU%4{`L0p8g}oy4hWo|)4UagDK=C;juut8deu3f9s|
z-3EPiXEJ(h-_Z4dbeaicSwWqsPgJzCob!!g+#y+Rd6LuKIfc@AG7a2DH_Dvoh_ceK
zo)j2qbJLM52p$wqmSnQ~Nj)xylGs2Yd7*5cOJApqiY-)`w#YfqHh0`|IQ@Ib^qSf(
z71HNC(^7||2<`ll4({4fbo7i^dFYZDaagN5aCUydD7kJ5ll)j>60)exbj`D;nvQIG
z3h@c5d^yr2UK`f6-T}#>c+)X>F(Ry}F_;_uvcetrqwTa95Uep)m}D0F!G^SF?Ff>x
zbaOd+LobzEJV{ldcMAr}mE(wpn~bTP5@q8e?^)AR+s4YTkOHYE4c?e$`F{1SI5i<F
zra_;sBz_(oiz+Q)Y^WEP1q|7`7@DtT*j33m-C7Pl)1k$+QUzc;Q98-~l_5+_vtw5I
zidDd|BfeluPox|BLxa$|l%*pBHvN*pbyhuQrgK+Z_q&qvj%E5{Q1CoI={_f^u<{A`
zI%-tzw=G0kNWTl_0*i{rT8P5K3z`m#u}oBv@`FKTOo+(}QmT$+Lbc=VAIF3vUe0fT
z!$o(t$h_ncvH{%#kKqNhSxU&f$PC>U!@EK!rKO@JD+Qu`I!~vzNrK$qG%mauQTbZ>
znix7sT{BYd{kp~6h%lFZ##t=0;l^#6-e-;rj-3g$<#F^$a^88WRJkB~JC!@WRmB;F
zxfybvnD!kvaW0JG@r}R&v%IL(0<pOQm8;|vpAh~Lx8Iz6Hg*e1LP$C5UDT><Rt3i0
zDk;&KCwEICGp1AH3swTiiT+lZBT@CvFFxaICfwuGx6#o^6+WV%Wn&z_#*2#~x+vJ1
zGZ14OO%FPy=AGRF-p}4$h*L18F0ZxL^YrbI!*ND96xvoJy#*fEZ>`-rM1^rwLP|Zf
z5{alpn43Rp0f}T3=?9Bao52mZ**1_yF=&)}FKi=fcI37OUdVz9>Ua34QNvdpDXlFD
z7iWz%2|vR{KYf??JUs1Jw%8hqh$yh{?3S&!ZCtixYdYWj%W}T~Fm)t{1imxl@KxTl
zJwZ_2{R-1)DI|hgwLGw=zFxG29;f)dhW{IyCU;Dg0|z9k?elT%`=WCHLltCtWXmsQ
zaph0Ft9VVp=+D^@WJPWfO96+;kDGnULTnyv_wXcPDd!X=%=UdswBbZ34SrOIV4>z)
zzEm*vNar(QWhuo`j$+@}PzG*#EG$AyuF7E=0=_QB&DA`hxU&zQ7b8zsDljXNwjn#M
z5&3FaQ<;jZe*d|F(u4ZY$9mp7|6+I5V8RnMB*2>@5!qJ84?nnwrC$xNZME`4rh`7@
z5L}mwCAGQ-&Zo<}N+#Zk!~XKuZS*exR-u8)gO4Lw9n~XK6>MzpGt*P8C~1e0;+4lV
zn@$tv!c-A8fk%nju(Z4kOziE%h^njq#nFJaHf`<T^i&~_$Qma6{#pkkQN-($qEa=?
z*Q=0wa5fX0lf_&c*`@uRyEd{;OdQx-yKNB4Bw1}^UaT(ty6Jea3ocoBb|&i=oFzIW
zd76>|Zbj(aVe4GfRvsIXPC6bL1nyBNA%8W}#xqBJm;nLrtO-xHz&(TnI4=fsqqIyR
z76*kdqu$T+>%KP^3n;U*B&o%vML6bjVPy7<24ib&*+B@T;y7kX&=lqco=bCnMqHF@
zSWQ&NMiR8g=r!W_i$$uV)d(KEtM+8dbg6V~j5Nt8l`SS*uPNXB(OQW*8@kR3#w4gQ
ziL*pvj11heMM#wx(D1AgFWE*sUU(OSpj@uxPtKQFUKlWWPE&s(tmmw4@QCt>)83o}
z9w{LU5JYwJHI15fEbDgvt@+R2+A7%73y%p22-TjWQ)s<59kW#TnrgZx>+w?JW=rGp
zGy+r9bcWM5h@*6qGk{vNP0l95kR35xyC(x;rMr+7Hu_-8AK-3xPWs^-4e6TLjyS5M
z&aJ}MNOKp0O(-Q6XxV8p7`kSS4}N3*j6C(wt~1sRY7vU!u8#}tZlC7LHmDt(SH;;e
zv7^6bHa~g#wDt9Ay!19Ii|3E$KgPN8b0+nMTM>D@7{SgWE-2H)(2*#@<nv4bD?RzN
zATcHo54IrM1SUVvA1)j}L*MqS_Z)+A>3hv7Itqx)FMuRxJVZq-PWpR<angg>G5#x*
zj46~lm!JuIC&$QaOl;Bjk1F|lb~LCARW&D=y*=dTwzZAU)_Zf_d^~)$4}=Uhk~(q$
znZRlSd!J5TF1!AVnTa?@OKTi$F|4jMd=BR=+oeYPIUby9JQ-$O7oQG>Ic^-Hp_7Pu
zjU%Pwp4iAn+RL%vV^R}rvE_$?%_8y`%m!fWy-YA1u2}B+gHon!h>NvXLFvtJaPFlP
zEyPoP`8$IDu*-W$Y6;wG)Ou0OBz2LgDn3NVw{5kW+*h<UGqVL|WRn=p%*T2Q3k(BZ
z(!&)aGo$k8A&2J7xZk(!ytxb$I5}JSEI27ri$vT>IlslTX~P`NXfrATB_<-d1Cq3p
z<r+^3QVLq1-T<@?-?CCSQEQ!PN2?C-McdKG$5bRgUOnp25v+N(Ge}fUn%W=-C!2lX
zN^KYeqjS4Wr-PcaAQhp?V7cdlYW;Z|$G}X=yN7Bl3O*u<%5hv-9r;q$AdPIgd{&Bk
z2K4q&w<EVi&ILHF;ggIPKE=b;E#rpV<#djkEi_#mk1m8#YU8EJ`Hi^of)?3O64tGe
zDxCi^1$@@kOPUoR_coo{zg+%@K=j#!x<rfF!Z;Jz&+Aal-F1s<`9XGZm?%;sYz~Rr
z*0w8ip%xLWD2f9($yP^9bx~}!eA`vj)Sq+9i}$8Z!$$ltbxy74LTN~M%8u!UC2~v&
z-N09Q*+8G0*-A>{I+;aksRO3Q+?ukU<zz*NXJ&y$E2LA9Zf8d#cUckgifLSd7*b#k
z=w<0>3Fr1R-AFP&Cq`kE)0E}oNLHCGeQLkSn3pL_3%s9{ao935Y%hLr<Qv59mReP=
zwaMNLNU|8Wwj+ZhXgU%4w1_h?naDXbqZ|&3?<;-QwyUtfob1~TZ15{JQCLfQI4)vN
zouBU>+~E0CS+WE?1C=dWDpehjJ#lOU!*>yN=~1lOd|UMV%0zCXEbW@{S!OpuoRXmF
z`<4Bo53!ANErgt13+5fmE8W3=?Q>%&3keQ0<Z2bjCsmHO5eu79_A>fIg<*(R?E>jd
zGM_O-%Bsy88CVeFh;j6M>QSa`o|P3<9m-`aNEQR?V39Q=+a_A}ZW5{BR_I)!`Le<z
z9Hiu~{Mnh7={EEL%1evdj+S8-9G2=Pg(*t3C#lsG&19~79ED~NDwM6YNR@O}lLqwD
zo7M0Vt53A7#-GZF38ygtW<HfC3|JYNG!OTpT@Q95R6Kco<0nh%%(#nD`5R%QXb=+n
zCd;@sV7@^pWbtN4In2vT(Khf!GTgktd+Ey*6|*I_fX|XN$#?bxIQt)2KP@4&H2xra
zw7%@6RfgSX0*-l*lmdGnkFBgCDpO*#yY5~Mi+%XR*4t}Vr%#D|Uy1ZyZ`~2^3<-5+
z_-*T#{G>(a$6VbWzPtgZ7iHI7x0PWf4%2pOw-<baV71+ABES0abxs&wU1vHtrRVlV
z|K**(0f;n>>({O6H$Z<mRC~BMmffxvvEU@sOgA3D+dkI|5S8_VfxC;NH(JQ;m1R}9
zmz8OmxItEAS^m1zp$Wh&Uxo*U1EW!^mRV9+tPVa_gb7zyn(I<*as)|51ABah?(AS~
zjgZ$~0_i$Ch*R7~Mm-dZy=iMJ)%^-&_bMnk+P6~dY6I5{iNz6t5VI^)0KZb2cG|g)
z!N;L~MIjnRTLQ*C>3G$Ipg1duDkx<Vhg@!8Ta4muWhZYCPOCq#G|U}F=l!VP?P47l
zS2QBt0%Aq3yk<huWN7Zw5+jO%WDK|OGAE->dt&4X%aJME78!BCL`d+mXB%OODe{aP
z1X0N6oEwPNLxIT@&ZXx&Kx4l6U|Xdl!~*MM*5~CrUmoq7SVrp=6Dsek>n41qFiMpp
zuhm82xBBFeGSA8p_6|M%F?e|AX#>rTO|4Lt9`+OCESh#qr%dqkCtdI{@;`7{&r}#-
zy76e`N%AP`%EAE*y=iHbjv3>z;H!6AoQ`!V)t1hi)7WtcMG=NyV6fFcvC`vT)qaYG
znoRu>cRyN>*@ft#mUbMo_EEGR$3@)IxJjpK%p2AD*5$HKDkjJEkU?99%^!W-YhkqV
zw=V4JI!z9kj6lwh!2TfS0fz&7V}Ax-ou}uE!ozKYVx~2b;AR}upiEUZOK1?ms;*I{
zuWEA?aUzlO-b0hVu>VGM=Bk*kdm~@%3@BipKj9%rGyKlr$G6^}CLNWyk|!S^9)jTG
za4FBaI9uXJT-1KkxxteSlTV8b6;N$^8mxnV3o_o~=K07H1{~b)N3~X@B7#Vlb|QdC
z{8n4roNaNmGG6xh_bFJ<D2<BQajkA5Ccy29d2iDiXyss4E?QTDB=_0VGGVXr4X_fX
z&Tl*{W3Y1{l=n5qG?~ZS+Y6=(sUkZ?k7Brj`jgd*3Qe$e#`lO413On0UOGNEAPJj;
zTC@6=UD;(DfqS}}rXX+-r!^jijr2Yo4#g*moTcZK>1+iR+n|#2VbL}-mspj2{I^pr
z#qF16NpoywG(A6H<7w**1_n4vlOa6GmnL$b_BTLl=OSvV#W(Bp6+XX)g7+jp_2y2R
zVrtY?Te|(x!ftqNGI@6O8UDttR}ho<1bss|_dZuy@rxk(&sl41({Mf&z3rwQJaC;N
z#!R4TGnT=|X-&U~J2m)V>zuP?c%0I4X=6}J8>^YQYYdj9$jki^#G><ApE%m2YnQdH
z@iHPrGw`A#l{j&C$-185v9$re`Q~B%KQ~@uGPw~qe@6XH$SF;#mX^&|-qX_Sa_A9T
zw%~cL-xnUBt89kK9gQfNcvjjgqAbSN1jZ(tzR>c1ZtajRsrjzXmg>0b_}=la{@Q8d
zDO_2fR$6WiD0g-mFqD}Rg6Qmv<eJCEt+}4;A$jS^%az2NQAsBgNQJ(T+_4`TM7fpB
z&)J{Sv#gL44yVnJuYI@F*t$FU5lS|iW}U+6K?=OYyQ(rZSz7X`*I86cf?<y9iDb97
z+}H>qMPze;Y8kBr`FxI}{4O-rUPfV+TH$G5MXk@|&Jo8AY<qu`N%q54?*jqHD1_xj
zZ|yOmo=rXezZV~T!$pDqV!JVBD~}8{C9$z;3IGllk)ymQ%_B6@tf7v3?R1vIfagja
zt#@fViK3o(v$!5zYre{iv{?Kujy6kq`D@#1q#K^FM7+`uJbNo3UMATI`@?0g0O}H{
zTp2f@zjcLt2UX-?rDu69MMFRJt6J$tIZwMf@ZBKGI1kk=*>;rK>r_?aA0nDwwY)6T
z9U?A<X&>u>lkx+#yu$IuOhkva;Pi7gud77+&Y#JOw2ihs&$4$Hg6#%`S-DTi5_p>?
z``Eo(;H9P~w6&^)k0jx|zj;^9xHmTYBK_^?^0SnRyT}-N73cMZaI|t6TGS6J2I=)K
zqF#qw5g?>!f}3P9ME(djvxir9w(p-w7s0-qegn+FMlwP9gp7lxqL+&5_#DvLCLR~x
z0A36?Q%xoj+95>W)(-o=r@}-RcTU}GHaU_S9jdn&vM`lL&9V1>q`1N>H~y@}BuHV<
zxk0x9AxZomZSB`rdr%%rFY4DTt08v_zxYv7Vt|ayqA<9#XvRH3|0{_y+~iwb3#D*$
zb9Cl^g#wkYcIN7MZkfe4QNnUm3_<4xMW4jt#C5o-`60qumi-0b=g_NAwX<^7Oj@+L
zYFbNF)99&LMYNfA_U1b~y+p3AbUBK`EP5KY=?+}m7(U8i;V*zlnWwH(DUCWxXl1k_
zfYrEK2ByLBDf?0Q;S^&UgZrFZhjUi+l&}aD3Ny6i3v}DTo#Ri@eQ4u^<kIL0y(BAu
zq%rLC_n;D~pM%Sw8l{Q9IbC-LH&RsFaZnVZ3@#Pt=k%f4mS~pbO`jEAEu~X)HnAlK
zOkq_^#F{iud+|2_N;j!Nh9stdq>O&&qp9qp4+p2dKCp0kIQ`HDQU2=2&?qMEiC4)U
zXeB2~W{i(T^>J=M5eU^^58Ry@wYi+B4{CV>T>p3j+-i|Ps|V<u0ge0F^AlZ?#~r$4
z*4mzHHO3;IG*XDyPAPfLR)AU8=02}~yZSuqa@H$brX$QQznR3oCETL;!q9y3mmUw+
z{qMaA;|3!m%P7ykNLivQN)CI;Hyr_Og9Z*4m(Z;TeGbBkB2#&PoWkGa)3IZ*4<}YS
zG+X07DGoD(F2%SH`(tNIZkExN-@Kw28bdHs8=cFEPS=S*9WureR+4pmTfl*$GoEW>
zuLNwy5w6p!-awNxl6<^ik5N}j*jMJE^E#~Qy}Rx{I2j_Xd%LG)_@)<oX>(1QU`Vc7
z`SAkjx}hy*){)EO!Im<W*g6oNyUL@b=Wl9t{MaN4J*7o|DD<o!caZ(x@6#2J@p=9Z
zDXYQh=OjI7sV#+NyY(l;2r~)ORdDuaHvin4Sqe!?%k=wp7rU-%RZOQ%=Ls`7lUDg$
zI-C8{=X$?IX<XRWlg_eXx%1TAmEZD<gi={v@1qJi8s0GJM}QUvU;1`B_TZQueu{R6
z%dj2m>Gt;$uZNlZU2G)hOICd2q9}&}kjVW&5Jfp^m3XXDk+co{g3s$1k(y7GBG)-S
z-unKQJuf~fEw|NjjAkLI8chN}WlSmShrVqM>wg~7veKeTH7rccc0vw%0&K8N{29so
zY)Y+ivSs)!RH&!@CaU1}V3kKM?+ml9hweD*OkQm!WnD<iEEew^b%{UiHRCBtL$Wx|
z$Q%U8vsR`os%h%*c0nJqg<TJ`$eo;*O!Vk(dwu#)5ituFkvzX0G9YDlGQi46<4~Ph
z0oD!YyyY>UikkIt#OU)Bs6L9UG^$dALpsAxx)zIOHlRKR!mRoCCUw0(Ij17)^y5ms
z6lG<36v<-*sJwY9%97PdlJ4w~w}XMQpj?0(naMQ^q9^WzqP}XT+}Ts61%bB2?*I;0
zPq<NP-+x0(7CK1kC#7MZ8}7xu!N)iOLQY~sgn6;f4%EQNp3pH@wsq3T4&?H|9jPat
z-g(81z2&^BYqPHGzs;WP$b-~e{Mgkg;gJasx_$&D{%KpmBB2c=-jrfR&75P(DHZjr
zQfE|}J?K<YV1jd>bJ3I&ShsZ9Owhi9%mk96H8IzZQVA8e`N%MPyV3M}=T+Jt)}0{T
zz{rqM-ihe2*afwyQ2X7Pjc1d8+?>bo>jQdWd|w*ULoOVsd~T7hT^7WUN~B!fY-zGB
zwc(!M4%@RT&QNL?Hk?Zo={j*Jq;0sFy54_(NdU81NbT$mKu1HP7sbgo)n8J0b=2H>
za}GMO2>eD737)GCN29h;FZD^R)VzN>Htjkcm_pcI4bQ8@ppaZzxOYVshf7f`UzD$<
zI$com<e}k4V#2k~+BosyW(!@AMS<It`-in>F}Tyu!?|A}eaSxQdJmCxZvc-i&U~>Q
zI5gon!J?*x%^*|ajtukkYAL1Jp%4-`e~5H#W}lXP6rspGYvy!gO=s8N)Y}5?n0X2i
zS?uiCkI<EM-P68jE_Rz6VU%muq)H<F#GBSKEvTc2V{yx_x`KO6|8=}Ium0_BL%(!~
zc+B|kbcVhT4d^v-!ej~O(VNsNb3H?r8kb3AjF+va(xW*`yh&FcYLd0u_UYH$Ea#HK
z>~1pKBxA_8(%~GU^hYR2t2xilCa6{;#5j`SR4qr?=r>VE?GThkOXs+^`#ikZBmD?d
zq-qceT!8M^(al_~2ZJn*u*?_{May`{w8uj$xp7uA{>Q-3@e`gb<roj&>(HH~Ao8Vr
zCgXHY!-Ek<;8%wVXXzSoV2nF=y2;GZqbDOPk5+!uFgXX>jy7{+$czjj&wF}#1T`o>
zgW@N(|ELky;l^ATB~`0XJj=i*gA#EZwL8snsEn(sK7Hw?WhVMWo7Zzu8&1q7v;43;
z$>eSnH%%!cR+j)vJbgJDxMoFf%lk+kyp(&QQ_{y(TM&keRa=11`0Cfy1EsZ(NtjpJ
z<3%Y&UyG^xNCW0PtM5<yOtKhb{Tmm}WWg@`V@yOx^DBRQ*b6jxj+h%7rdEMulA9;!
z|1-#Xjaos6gc2DmJp6tfNCL4(WwC|_eaWY9hovsnPoYQ1gK9#>%nt++3P>4@9{iw(
zWn_aoUMlIGWkE?*&D#~xKLv5@O<DWA3Z!rR(#PO2&sG`9F}c|`#$XXk9#515^I7Fs
z`kZihIDNCJK<zeV$Szj~c>hh7?FR=VcCArQJZlR|^IhMLOMg4+Pg%^=2ZWSk?<Qz7
zjXXn$wn+IygxFHJwe<MuSuY5cnj{=jUJr_-Y~n{AJj*YE(|i4T0i1~+X-BN2-}=+}
z$*yiP0po}L*0AY);4|cpG46w{T+%-`L4Th=0-xjRtSpHVx0m=AMy#Dr`z9%@O6VLa
zCtD2anm(DY9V9dNs?ykXw?ia$n<(M#UU?w0{k9B=Xt>1{zcvaKb!XYKVnnN2wr<dL
zUJ_9|dA$cA%Yg*ssV7kqB=RL~-ro}ao}Xx<Fi{)4bY{W>c_}}<QGbM{r#gbGDer4S
z6PVMR;BG@ERgn)ov!}fZ-9jFusP7kKF<N23cgs>$-`?95B<&YGce3KXnEWL69ha0g
zJRu-ZDu7DV#qt8qb^+2j*u)_icVUgg6)mDRqJO2lxkLZhAY=$dQtizAw8t-}Hk!lo
z4dC74P)f4nkba;VeA5qyE^*3|&bvQq4bu&=w3%ugYG`J(bk?Qk^s&a}VXjG&cW?UT
z`R{X-KCd!4<;v{Pv^b4Le{FX=+7#^|Dbwx*SM3OjEG=7gw22V%Nv}=p%0|#mTUp8I
zE_5B4OJk)q{aTntTB`YSUJBPS%2JJ`vq`tyaX<P`Nm=Y5V9FIf+I>ub^Ziy-URI4Y
zRUSiaBC{#f0*^?0%f8nhUdJAF=7G&Nd9$FdKrsk)et^rW4Ez+is9Ap2HcHN7WQc%H
zUMi{-MS-@}iM>DLJ^`hWWh;$MtO78G9Y<fvDMG!g{?joblJ;^Bx8M@rwTmoF{4RBe
z4nqJAyJk%@z9<_{*qI#Ofs|0XX2o1^FG4t{>HQVQi4XL0&|)rBMn^Nz?Wl?(N9n@U
z;#j>{SfenIe$)5ZHulu56B4_c>K;K<WNJ%+@5jsVMPt&(%_fIIEb;{OuJ>123Gf%C
zD{5ow>(zm-r`vt)i2skWua1hNY5Lto7hl{7vN*xr-Q5C#5L|-06Wm>bySux)TOhbY
zkU$6?AVBWsd0zXz_ufD5IdjfVcXiiP?M%&dS6BbaBy?Uued=Lpy&duPy7~)r0|1N8
z-|K(_JKIl;g$N{^{TT&XG5Aqz3n)T@l@L4Ts*;^JB>1I$jT#PmII{X3Kpp;WP)a~c
zSRc3!z76H_0?!SA4%yq;c*XlaRz<IoA15ZBv*Et5cc^EdEt{A;wN>QcBxF-TK#w|K
zC6%=kW%t<#j$p(ALX21ndcBqU`0}f}T2&KfR-5xn8*ocg*bkj9qqMx9pA)9`<ftnx
ze+Fz^RkSjWY<3t2zO7M>=i#PKfq1ypmgHAgexxVb#<}8Bdb>psxo~8e%XLc*{3Nkf
z8cLJH|2S_&OW`)1>Sh^uGO%Rc7hB+zgq#jn&v|Z-*KUiapQp!s`{Hph$YpEV^%ya=
zE|>O=eI>5LRgmqSl#=FNJ8jO1V4^IJEit1RZLN~m#r4&u8MBrUr+6fy@AxRBU|G;5
ze4T%l!Wh-Nq%WZ&Y8}VCr>B8g#iD#%*j&aNvwljtBYG>FO^mZaF!ttHK?J+hfFY(;
zG9LeynI$r!>=D5_AH|z`#2j|ZAp%XK>9smo!KkZ~U1b!9Mwdz(d+W@#Iqtdst!`xX
zE#r_Ks_2~j)rg6HEv;NgTjm~d*#vzqeNXFD>r0x?)jFgS#V#lF?cg38C*5i^EhKOQ
zt@esHuaLRZtRPaccibBG;yUJ?o@euWmA^cXv*MbS@m=g=V;|QX>IMST5VX`5Sr-7#
z(4B85dwhDEGv@8R0Stu7pIOB-b9!?F3awW|Vj>W?Sh>N$6H(xEwLZ`Om|X^G^Gyxw
z_ea4SNgqRZ@9zw`<y>ugr5%nSouQ-SxnXt$rb#aE^Bf8xnFG(T!F<%)++>PR-fY-5
zUpM1x=g9`2w=vpjjz|YDz7IFZ%}>vXZ2qdtOtin)5FwjF7-z0dJ)R*sNOf3w;JElc
zh?-~@b%Ty$n&bgx83yS*930P$Ge<E^m7ct@_<!>eqFUfrBBY3nD($Tt)Eaa8EJrFO
z_?g@cJ|Qsad?=+6fstUROXmXM?MPXTJ@^K74i?YMX6zgxEX;Cn{55gWyk_K^=(dJ>
z{B}FMRs;G*bxa{;pL)TH4qEKYkT$(PV=gm^*9uP2HkbZ=dUPcAC&QAiI5mj_3GBr$
zNqlv%FSe}791=EH5Z#t2pXovOnEE$TuTibh_!M}P-br0fn0FK57EBD=5ior12{zVc
z<m0w{M~+KRW~fm7{Rcjg`(AlP86;9(KQ)d$Gjzv(5Wxf(Ih|TWKz1R684Sy;l$FSx
zalU>#NUc13yrft23A#;>z)D^ohi2Zco9jD4VhzDS2fa_jPcK#qJ||A8du#8wWpuL=
zOQ&{Kf}k|t?`+D+hpgtQ6wIxkhwfr$(Zn@zXb2l%qEZ!L*S!7u|2WBh10pF)BTU2=
z3kPXAN@QDVOq~#_Mk9C=V+$T2XZ%4!nBRvwKRkwIXvajaw}(o&!YUYjvHs@PFx{GH
z9o634jMrTK#YVJ#nsOW%UzM(TGrjV5skITul}2V-GB#?^o2&Mt8@+Y$bWVI?o`bzg
zVJw=8U^Z?ARXH1KyFzjGmyZ>!Px-it5zWYuIK^r^()-E`Kh+%98vRD;T_&mOMFBQS
zE$zjrSx~^chE1%Wbqj6A1+HZov}Ky=suz>qK9>wd(TAR>HE##K`W%Q{jcF%c#*Vkv
z{nD&E<<iCNedoW#Bq>n=$;Mf1zr2i)rA>^Hm{EJP#=56aGN#>TMzeZu>Cfo-t+^X#
z$R-I-*i5l}Nsc=WHPWDjNoRVU|7$CY;zRl?CQlIemWcO45X-#uEgDsIf5!p9$FKj-
zg8m`=$)Oxfy+rcX6mJ~zM83a~@7MaD#tc06jO>l%t>Bj4DGxotPh&Q|yy!8mwqh5^
z&g5&XZ3dktoVE^VU1*B0Cg`T5+Av^MILss$GmZDp{tC1)dN;{MQuG_ptwI&)G4nNw
z*!(+hg{1n_TpPeO(~#*YB})#+XO9gjA-i)FJCcDXzgj|m3?iZE)v3D9|Hw985F7vb
zEU}W`9x$HHlx0t5D3n&1fv%8Mu@E26#pj|?asmj9d0L6GOn*f_)!wMH9`bl$4w|AY
z?}W$a9=9WiaT;HkrmR(<uwKXf&b>!GrpZR7#J;^Bsn(eMb=rx_82;C#elt#@mb8K5
z+z9gwOP`^Y%^R=y-+-$DGAnhC3F9xkZ-0$Gxa@DS>8#UZ%}=yA+Tkx_DCak7d_{9C
zDR}h#%bkDi<|>8yOo>oBG>OH4K8$zaoE>Q^JJ~eZZ8v$3%7qC@XvKAH<K0w+4&C`V
zO<_tNAK6A&97hR!M@fu-k~l_fIF7u67Q6p0hCz#esL-O(UsMOr6OyGP^3)UCFVDGX
z?$nxBCS9Cgutu8IqUail5q<+&US%d@>A8!bzBbNq*3gWiabtFV|HJxfl*-v7;jorZ
zuqsSx#Cp57Fx-l~#9ymXlPNvxfEaJWcDbC2Btd<KKw)}lsC`BOb2;)L^b<l*(h_Za
zBgqtTOr0Cf9Fb{NU`!O-tUIHV$d_0XE>1OyltR@ri8|O4&PFeUwv@${3M@9+uAPQ)
zhrY69g}q8cZQXr0otDnRjynRv@0m3#W#KdHbot@oXRqB@oClsI`c*F`<~v5Fs`4yF
ze+=1d$Orl@L;pIIBt!n0*C7Y@cL_t0xK4a<!0l0-6XeMcZ)VXwbsI>Ey?#ZE&UYk0
z5)X9=h}%1@x5MetH;qe>sWh{fmUfqG7;p>Ck7Vm76f*17jDjoHAPy0GWroG)Q=giL
zuWr#C7=rE7P1!@%xJ8em;CFqM$r#u9Q-;*1^sMkvYiuLK8IYPKu$<TsMtgxW+G!az
zr-_ycua}Sye*-FEz1~rC_%b>^3$z(~d7$6)_asD|7|U2qB7$IUUx%&TO|e<Wuoa@}
zV+Nyd%kHt+ZM<h~4M^Eq#TT&3Bg?X-u#SR;u<l5uT%{9J{><XE_8A}9TWJ%<MeQ@^
z#uroxhh-&fBE4^%^8eWaOAkjX_R8vw_M&>A!ibR@X*jR3R1WQWNG?Z}#KZ>iyC1c0
zw8`WRRPZOs0mm2#N+Mr;oDxTsRLi-@HPORUeb0fuX{DtHLpVQL#AhliPCgGqUXNeV
zmnI)+0f*1r8*<WwpCl9eC=B^wD{-v|I!yzr*Uf3RQQs(FaoP(QaP6$ok<Ab^sZJ%2
zSpFn9UCvw`1T#5wnxzoC+8d(NE_|cC9YR6FR;PJKZU|KV&We|EC|ZAPVr~Bk@8<`H
zi^Hl3-4-eR4g0l&M=t0pOCh^Cmh9p8c>@65_j+Dam|~#2V&C0ZMayr%rz7mM^z(;1
zadE{+44L<_5X+JZ`{D_dZN-*Xq>l7D7Q6IudYEmvey00oFp5-)>o9U14_smoS-)7X
z2CmI*^P10bol$h$){cOt3G3?8)*Bdhy*9Q^%-(uj&6g;Ybg#?n_V=PE(3)R;(CUXo
z&Z_X~xrWqHzCdkUNJ8P$wen}wZV6H0_Xl#4kS#)PdsjyDIw8M=7n#cNLLT1Q)#z>m
zF^rqv0IIBnij8ft<rm571Fsy#_(-d-Vj2V+0H`1TNmENBQ;wkHWIHmZn^@+xu)1o;
zH{yU^R9G|t!D+ry%u4il!nQj-oKTO02s7Q}0qJX5<Pg~H;G@JM)V&AYdM3({4M|xh
z5?6BP3tss*Q8F&k+>YL@Xj{DH#fb@U4qqD)m(?QM8LblOPO?YLyf23G2GkPK9S~ft
zOB)0Fa^$%KbPyD$kjNj|U}TbQNkZG8o7`X0qHN0WN?td4dWB}Zx<w^jh52D-(;;lY
zJ*e52?(R%8=QvE2^(mWqVAHLKCgvoAE80I+wkgArz^ZV(siVST*U2`<2e)a#w41XZ
zpE*@LvhPXu&bLULAO%Pru4b!(9YJ?st`)D7vLE5rtRa}#z&*FNPv3E?2Y20mx9;aa
z{du?H>sfPk_^^JWN~12`xyMmU_XcMR7I#7s!|U|6EF~%hat;o*=AH()2UJ_n#feVM
zti0x^*VSJ(L#txl-{k=p6u9cuzUmKaIb9OJJ<$2NC+j)b(d8|qB^6d@M4?gi0mnFd
z-j2#iZyx%+^Pf0h#W(kVmO6Vdq5mWvBrNr-z3pj+uR(UQGl|E5z5w+dIihFvs*M7b
zrtF?LNV+*mxk``?VDN3yZx0<yjFC=n6TWIIOTueh&%$RJ<txj2=_KyLM4ofRV5yxN
z5zDm7>W>E6@%EUS*Ty1aPx<6dS`{&2sts{h!nx0Ze|8=*fuTE%V4$0i;Nky)bO^+x
z0I)%KuQ&!IfXPMk=T+<bcP|WCFaHH`BSP_vNgXdoGE4kSQ3*H1fKsg_!5l$i?Xn}+
z%*JaORaXeg*DR8iBKZyY_;dsfzBm%u{te)RKEDsMKcO?SkG(I>&rm0J?vLMqtbesZ
zAi@b^QQAe3<}vbu+}vw$bU6wJ3q$tFt?GandbK_Qg2s#T0Pi}QOAjO!9n9fYSs|T-
zM@=@0*DGh&fo(*PIE^xHv;ClplCgNn;mrOG2~n2B*Y6b}jj$ggxK>uWq~A7KSsI<&
zIf0_Vl8kkgVO}HCQikq+6Ri5{9KnW)h^f&jE5|>-#O7<Dnp((U`I6dHvS6TVVo!W$
zR_W!ogn@KtUn0+wN-|`&bu0b`XjH<e0fCS^durTbP}oZLWu$*vDd`tOJ&0SNdpqnB
zsfd`)2eQ0W@WD{4j(p{7At`SN&(D%FNgC~yxqvCS%8w5d!ML)*hmE!Vh-ICAbkQK0
zEJdaSAiuN(Vwi8oz#|=;mwCc2&wR$>Vr`gW$~z8rPpRiPn+U=KwuPAwbVcA}muYoI
z+JqzUf+@riVMG3v;-)wtP7$0w*b~irK?UZtCXANH_3bc}&7=sG$x1DEbWs!}^{;j<
zq$UETw1tOP0YpVj;l3fc;Ii{CR9K%*-=}YQHtXaBWR9^X-qHF;q-$sdsOaPB+CR^<
zQO3$EOD5r{i)uJ1a|4*c2O9GqeSRGkp5)rx`m&er=H6Ls3%yeOWl?#OqJsJx&?x+H
z{AjT*^j@*T!{Ryp=d8?v@anfmGmSx!vvJvAO5D!4Y<QK*-1USX$5HFTAN^hx5LebF
znm?G}XIN3?!WD*i8eZ9|V!6;NHnB^8P|oMy<IvR6Nz|;$2-LgxZ8~F#ZTrz}0se#m
z3+AJ29oiFbE|QoaX0pD~?fgN$W^P-18@=+L`V2v7mcF7t#Ia)>f3B?`H#d}X)bm3_
zg-%`PoGE1rQ|(J#2XE;S#n+jTsbeo?wwM$VNGsNomPS4&D1)4DT=*CU_@TX@|1~88
z#?kA0R?h6g9<*C53Ou7biTA(?R&aT+Q_B%OPAVp~G3D3q{`x2=U-}glHv~bwa|Sj{
z`GW5zHEp&CwL_fr7LjC6Jn3IWhnRn;55cF8C-rvONog6`?-A^6z8eYo1}_`!gG(6S
zHklx}so&R;`Rc*wL<3;KsX#pF+Vmwsx)3|PPIB<B=efQb@qMpImxc0gz^~SicK1tz
zz3aJa4j!4*iXzrO)+u(l<}G{ebAKK9*}sa*8BUbX<hfL<j}Kbj@mzC<wIg$inOOLA
zOcP|P=yFfVO8pLjfpQWU(RLauodTgP_CbKRWaAFq-^Ei3K<9q`;D`y=Le&ThV)HUA
z7|MzD!WyC1X@lWHu<|8UVnz70fNwXUxms-^R`u5Pmc1=Jcf&C%9VeJZS?PAX8qV}k
z2YGwys)?v+*1TKz<7v`;*NdNvMx{TymZPWZz<6xD^iq^@qvsk!OiWC{)k6^LApl|H
zoOkkMBM%ge%|29blMJRRkZ47K6KaDzDn{i89H@-GL0*vVd3eWV3c=MeNpd;5&(_5*
zqzP12ksB1?-(v0@-j`o=%BD*1^;zN<>AcP2rcn`NchmdHre&rFaK}E<rM~Rv3s;}`
zD0lv&&F|TJb{3^D($7EVGosqWUY&gR`jCzSWy(}9V&FQcMT~Qxp8pfig#u0R&I$Dh
z`wN&E?v?##1MNY#_4Do8+2<<}p19E&<|@>&Tspo|+Waww<Ni1sMa?0EqIgq9?<VXd
z<YL+%RZ2_f0-Cz@xXvRaOS<Y37M1H+HuuZ84wR)wEd(k4rGA+4*<38-aI*S2`56*<
zVrVc#f{*5jXjpFva^)oRUcGbKry)WiotlgA5=M+@r<0{$vD)6@D8`Ej$p~&7f^HC%
z&3cJPQ})=h@p1Y7O5}F@$>5_1FJ47-`8SfFs<?OYD$bOokH@W2432jS?MSZEG_u>#
zghzU?RtT!6k<lkSi{fO(PYuQmuW=H=gS`XJ1sf8d+Fu_QLZ;Sqse(618g&rH=t&X_
z;@3jX6P%MG)Y*o^kCd$ZfW<|e!Q<Zy_|q>>BM+M;t+T`+9TTMT<T8qWW9poEK?%O@
zkJ3$kbRS_2as`=V=^w^gMr~G<!;da>fr$Emy)0G8-qiC=B?3-UwJF0SV_!+JN?<m{
zp3aw>Aby-q13qW<d_Y6Ukm=PPoGN=e3-i3~+(;mdCn{{ymi-)nnN3DuENX%}Vg&1v
z<`Smp!<!4$D0)8rimJD@d*a&oA!+kouE7bE-z1ZEE(r<3Sk)=kciW8HrH#Zf-aY%I
ztngAgcyj&}{`e!|q03L$^(ZGM_V5+#vPf_d9iJm-p{HJYl$;Q2q}_YBP^yOnuB01K
z04BevL9uChy19I^b}W|wuku@kL4qI#UF0pPoRb0VSoN~c#yp^ktjb=3jNNgf(O>Zu
z$^7gIA*{w0!x=0h1T118MMmwS;S$4zs@OW8{i|}^&&Z#@AJz{45_TBs+S`c+8sn^i
zzVslb^LE|}p={gu$X#GNTHtsL4u2l&=>D~DY1XG8aAW*Pue)eQ&h_RaLOxaU3er~0
z&H&^h|2F`%>?0H%_^m*BPigno1BTG-gmzi%T~Z(|MykF0(M!8X)a=nWV>E}b`b$AX
zKmu!j008F|f;;)V7*_i|+q#CPRVslCCxBeI(@TW2H=*}^4!#V|(;k1VdSrw3lq)MH
zoMqW>03qA`=Myv<VlRRp!wF-e0GiB%w*DJR0x=MKR&b1C)NvV3kyr@#P?8)!Bl){R
zv9X=YU_xp2ygFUv)e8)x(11p*lW6qfC8@|gM+k68;SKfB?Wh`Ayr`0r!uyg^jac_g
z3{nA^e;Qey#vn1G=_8@NfNZk3_A3G8vJh%YF=yUP`T)?7CaUH|l~LG!%QhvRXMdyT
zp&-31h1nnsSX?t&EYNhyz=}C??f?QVn!ix2C%57pnR0fbgP_X|<1KK*pd>!-%C+Jm
z$xi!ac)mq@Ytd+s`wtU(Oe`iyq`Wdj(KBS5TSk9xW>Qdm%xWqi`q5~5GZV0L791zW
zPK8aNROUIMO|j#Wy*(J0tXlF+c2A$=54mOKMoM3gYr#l<M~ZPVN=}-vei>9};xop#
zEn!d4Z<B>nd^{EdI8&u@7qO1OSjAB(5xiIezm$mfR~R|0>Kjo-Z*cf8DPN?c`5wd_
z(csdH2ArClc6Oe>>NU8&9ys31eU?74(iA;l$Vdu0kk-y(EZ@2u4<6nbAdgh2>SAy&
zE)DI?+aotEKX!~Ljs@&v6|Ykp=WEIa)!e5A08#E;CP)rmA(>#(C6Xqc`tM-5DAOBH
zfaQEl$+0<;q?^IYO5nrjBvA00#R6JaBU@FZzlNFV5=@FcGC=$=2F3}2a=(EuA?7~D
zh{PZ*o`A^?5>qio#QGKvPV(5L+#!geBzQn<?g#%vsLddiZVN1{G1qao!2UH+ewhGq
z@xlFWgk)4$reQgiC7et8Dytnvji(;kx_zf#ugK4_r!A3J7l6g1n8VRg<#{MjwtnvL
z(e(}Z7wnI>9#LEHkz-?=d#rl|K2lh6r8*o@lk)16-5L${mU(cp2|Q%%iDhDK{MiWg
zna`m=k()XbPj{SZ1ZZUs4Z_E^h1FEm?q!cqnNhN2W%^idY%QNuUl6*5J>HRM+`u=S
zAb2x!jj;L?)`b``qWlQoRzj+m9AVZ;6l6r@ukAr-BO(qynnB}1n>*iU#tEPhqsixX
zy+`mws@C9)>KystCfnFQ5av2~1Yj)_E04oeV>$l(#&9R1|6pO`;Wwa1=J4|V5%HQ#
z(Z#hvDn($dMlRDvw!j&7X)m7O(1ulAs?hWYg>}$Ma0O!xksP_JPfDCiFr{lRLHFxb
z0Dp|Q0l}(d{5iU@O8g-WX5Z=srllR7_^)5v`ThUP%#ZP}EKraGKz!ENaK1%F34NNk
z(NUL808Bir5T1Cq0uH=x@%&caG5fU=VDz%rSUfdc*N*Bi1M-r7m4W`gOP=s6XYzhz
zdFlmbn@}#je)8Xdb80vz+0(S(p!}G``UZtn&UOMWLNqi#X|Q%TU66~3w{<j(Tr2VN
zHpCrC7eQ4oFxC<6J!L~Za>UqXoJigenL{Y1_UT_wZ!y>n)ffl%TGa9xlRwM3YsKSa
z?Vqn=e^^#IrrEjE#X%c;EKJ{+;6dz9+BENxSiKR=8FfCTm_=|GW5*922Aab4`3|o$
zP3?jqpi=iN+}{97Kbn|*LE^<a_DbaBnLJb@t9C-17_3mZv}rLz{PHU)&QroQaVJ<S
zK*3!9gHcLDw5FIhA>Gm^S{g(RU|P5f6GlW8pB%HGfJ;Y@H4N>##`c-$*Rj)cA(4kV
zoiT<m$V?&syrwLUR|KP*F+`}MN+U&q>Kv;caY}=<o7Kb+r6`NPo7v$NmPBs(|9Yc{
zJ|&9P-NIB!M)k1sL-M=d!sz6GYr7GnIq*<spjqp}Q;Ai?X*rvPL(t$`D98B8HsA^}
zT+;BwUZ5r)dCgGIDY?b*Af!aJtMFhNnXcd?Co1QnX;0OT(=k){<E}5D$)V>{(tanZ
z_%DzC&~~Z9=#ekHU2{M{8;<fmj8Lxs#jU=5ftQkI^t?`vkTwkdoKnfn-6si$0$@mU
z9c$)37EwpN=oVV+VC*yuY6}~;<xS>jd~pk{DNHlcTvslrd<)?r6cdR$N<tNF7zy0v
zygY4Zqhn!T{vX4sk2{Ddb(<}}T2G-y>k~J<e|ZBQk+pBw&1IgC#txyZs|OUHAfNI^
zhkVu%9p)k0V#Y(Ow$DMGwH)aZu=9~Hc&CiDqDVSn1cy|SoFcT0|A|+Ni6wPox(5T8
z3Z6NB=t5lg*hC&kMd{!?G;UyGTeC_bFEO7sJuc2%A+vj4<&<Sx89q*;c60FZXy^dO
zae0hr=4&R#BFgx%QD9NDpANzgtIDcf2p?L=3#KcQ5=u6In?aVu63?tFQ2vfrX@pfv
zfFPtZ71<0VM%KK^twbmlwC5J)cZ<t?Ja}Od$<5Pgb9h8<B!~~jRcVjjS3e()Zx8e_
z<iG?p0SnPU!9R$&e~x!iOUeeD4i3qf7@45j!RWeUU?cX?edA41l>R=}giD!F&FM1P
zQY;2q4uwdCqS;?L2f+G^3n{dMByyUIikBF?EZo#!Ows+fRP@d8^=KMf$Uz^2A4cUk
zH8V*`VgZz<uApt7Y|V*J#4pN@g67z;AoT6tFQ+nlVHaE{e;HVwko?*upS#!y&8TSN
zjn@p)8ft;|NYo4mF+MgnCYxh#AgzDOkh``-c|}Lp0n&yKwlZAir=oE#USz>3ER1+n
ztq^Kap|$Ho;^_`KY^281qMH7G?4a?|_J7~maiMsGA-hM3uKXN-_M?LgFH`(LM{MaI
zg9N-TY;Hgyv+(a3s5Sm6ep{wDO(x~)wJp&^+9(q$relvlHy+P)p0X|jm~WrF-G?t6
zcX)NM=?s7;;a3|<`g9yQs$3C<@B4!J&9s@nFTobmm&m16kWN%5Uw%Nxb=oJOfK4mA
zN?IHJyba8t?z_VG9OcKvD<Q_%=FXD`RP&vBdK0|M2NsPkZmS>R!V?$8(+VWimxNZu
z=~zY_tGw}J2R~*7<ZBrgR&Z~B`QIa?;|IV#MhO(1*#EvI(Uj1Y|Km9k#9ycNTWjI9
z!UOT`!>)^?${eD@#7b$Pkhif)9Z4Exv^{~z>1+ZCJLdchVf|Bb94s<?p>v2bvx{2f
zasOx@1(A3IH{>uGl_xyP45DIY961<ln0?-TX-*$Fcf$X9&%il*L&dy-@BJ=Prf(sr
zT9VVhAA>DXoZ?^-=!jnZ?g__MMGU)ign5qf`y-4i?~!NS<wBDW6f=nG+T+O=xFE`B
zrChOJiwu-8EUDu))I|c!VUV;bRkVGf$NEf3$%n+bqTYmMmMurxq$NOdh`D@awn0Gy
zhuES#H-}YWH0qh<l9<oPeahF7nXc#^X*So<DUh!8FiEW>Mw8*oDn=d1g7rZ+H9!2@
zodvy0!gofZmqCIP>0K&SSv1T(_sPVSG2}S9-aNr-gldk}T9tnq3|l{z78sq74bxw~
z%Pg}Kr$gD*{4BvnIIcy!I$y3Cy)o(aUTR*5tz)WgD(v179#FiH5`BTzjreLFrYJu#
z8|nZ6ehlI#n9F^y*r@^@dNi{Njt{(WA=ygdhNLAY=g0};1sUUEC|VI$!?=UlMlPc_
za8f!?A_nycL}41>30UE_)rC<x<(9A{K@trrmH+X+^7A**y6?lF^DN&hef1MW){e#{
zP`;%b>!~7yp)3I)lf!KL7)RW5|EshXR+WN)n`;ZV-u9f&h*ktUj4H@{Xub!X`f~uy
zYXm+dM^L@-YP_OG#1K^xF$`upg5$P3+Th#dF9KZD`;b)4{<OBTf=5%ZPGVMxGpcON
z*dDb<k1`J{IsTXEVK#A8Oj9u}+Z+oRM%F8chm!<W<h`@X1-~&;6@sThQzTKk`7d+?
z>9sQ$!M0Y9F-?G!m^r=-n<L9B?W-2zmTk9Zzkf_*8pysvXkH~c<blQaXZ!sQrG?X=
z9v>fwN}1HR>s!PB8dPEG%4iz&G0Zq;cJOxUc$vXyNWy7|W1xx<M@I&ySJ|o<INVjf
zML$>mJcSRB#X}v=q9+e$fGG+~1z8y1hJjIvA@ZW0zPlB-REaPen8*cJrtJd1CGR9G
z&LFhVN~%YX)~FU;6SN2_e3yAEjK_%y-N_&QSu59mj;rue;-2W{Z)<`bAolOS@@jJv
z6C$x1ME6XtlG92M+*?zfI(Zw3SveL!Ye-P8Q}>au-y7r#SI(p;(nkcaL`9Q~Hzb;j
zr9zYtW!F&sBy@?V$gW_N_+7OX!}bPv9G20AJ|6FXNT1sSgaabbVNr-DI=Xl_;D+^%
z2)#D28MBaL47W3|{vOyQ_Lc*&^cd^E#%d_A$uYELN#?X|LS1QWha?m%8^Onl%{7kn
zlb=o_f6QgA?DP1e)Ob0^O%cJlrV#P_5GvG1^H&DO<VP>49@CEDWwP_o+d}rR2{uhf
z&C)=1VrNG3gZUltGzWwIq}<0PNLM2SqS73ZDc_t7up}h{ditrG<Kg00_@5EOkPmUT
z>rnbzcS-B=i0>>Syp5Y!K?bRj;g0FfRk%uuoOs@?gvIx2(Vmh|xC0ZLfGIQ`AB@1^
zJgxMe!JD}^raKXXU)MLGBhMO@z3YcZV5@h95Imc}bKU7?tc&4j3$L$!N$;`J<`GkG
z^vm*8%>&~zKU;MCF;*&}dBhlNvrJObbXF5Hx%kHL;ht5n1a;&#Z?jZ7s6!9`^}*=g
zf+0@Hd;Je{1>}poieG<;eO{%;;Xf$m5d~D~VU~hvXdse;*`aS;UD-hfS@D+RQ_!`d
zlA4E^gah<2f;wEXS4dY&l;_LXiVmPWbZVhkZe13L?(-#X5_Yq^jL?%An;5lClewDK
zY@fmexSnc0`(}XmjH&dg`(49Y(`cTA%-dQ%TqSH>P#rOFSwx}xRmS@<sC(v*XD41&
zKIlL-!o4>4CqwU?M)|0~bXaV5;nB;(tIW~;V={Im${v$A8O2YDX=z9tR&MYh3K_wD
zf+r--Tl%@OTecqxP15Eoy3X;|(yT@x(BgM*He0knk~lV;D`N|(JaZUNH5~k?4Qg6|
z?xw$P#VPzPy+56$_x{c9?rlwAy<HdfjJ6&V_SYH$5d^noHtaTQUX;1yKIJUO8R8i$
zIcX$tpltIJWVePE%N=XSfKwW`PJJ;$MFibw6;pcC*8v=~hQoq8eh$`9F8S7Aa*bA?
zwuo<G!HXpfS1C7dgy@W;h8x9h=%~1dIh03`eTkI1^pgM8lFKS*+6($wSf;)7e0oN@
z#G#-xp_HGykWo~fp*t4fHBT$V9*`fgV$biSL}iNi*Hrc5cJB+TEAzIo&<ei>B5LOb
zNZAs~=-8uzha~9pH3W}9B;jjR6aGEvjANYqL3+Mdj@2wZw91lfFtJ=#p~hx)F5JR!
z{)2oA25efg44`naveSS?X}}ypbf^l1-ZWv6i>NQ;IK_&;2z<wevZZN^0?H>QHLV$;
zcNstWCh#AV+B|ISD4U{-v@Jq8(`ZsAgAu{x8)wBUz8){>H_<H;iGBy~C4d%=R9Tjl
zIm&Gku>Jv9K~e&Dg8(s22hyyJ*jPpih8KhQ6DCuGqDWoHwv?T>@oDe?mQKVtiE)Wc
zba*xG;t^T4Owc#HARL#iSX8Q2LWau}DTtRC{#n151^y(qB<J|g$)W+VwOZ9AZUaQw
zt)#nwiI&6o@VL#y<t-ykIe}x({@6}{Y{IcH$DJlMV6wl+S7TzuZrykN_FpqRpi%n)
zrl6iQr+z@{{P=)N7LZ~TFM|GSVy&KRM=_5zM=e}C4<?VhG3)oqHWasns(QuFLRkpm
z`GNd9-I+FTPs6y_YgY6Wno%9>aN%9q`|nv>2bpsTV{j%0h2>L{pJTCWfDtxeaxs(c
zDs|F}<@c-O)<D7QPPYNW;(qMr>QY6seHI{<y7>Yk)mxz~TAPwpvxYFiJ??1nVKQk>
z4$FjofsbKe_yDspLg|gJeP<y|$)S!~>C$fj<+H@oaerCLU;d(FU@#ZeZ$Ps8aAGEb
z;_iy5kn@z&BE@|HouOpd8{oPa#1A>#0pH$c8&-n#=3cg@q=|>r4+irq7y*VAqU=}r
zRs=^RpjPFNE9n`qm2)uAGhKZh`-?M<B81B2wS|zXNO?wqfjAY##1OwGFbW%jp0=2_
z72Iyb8Dh3wyr<`X>q;Di8tpQnE**iDeQA4GzlT3psCYNV9Y%PKL;T<}tFv)e*d{if
z@b=Jr9yypjeQ=XjzLsShI96@HIsDzxJz5+TeS%}9La4$tg#JdV<cPGZ*n_r&#@o;)
zvL0~2Th|kD7=S?GuWyvd3!tivcuredrxi1n;T<<LKF0d|bNqFokqxMTJ2O?yFIt@+
zC3~%FHGgCfWs_)vq*yDr`^@3jv*iEwC^r9u`5v>vwyuLn1_#U=WTLP@wJtm$I~z_q
zt%diYY*W{&3xbKcxu>U2wr)Z?$s%do?S}ovg|ePiH?F>6r|$#nO(GMv8HmMOe7zAV
za7v0+=6R<vLSdGRN^Ac5%m8Q>2SIeBKieWgad12<&H7RSS9K0rHZ$3MJAddSJoU}q
zE;i}ac$~kzN%+ODI&m4C9`6JhUz7Z14B-inA*RON;IrZGs6M9p1OM}3q0B)sJ9MGs
z>u`3y;_H<tfzwyWOK}{#cNQAnE-q;=ivJKNj!2xz`3Yml_T(a8!-KEp$>^<_`p~&N
z><ly0&$4`HNvb2XCxj4wn$ZcKC=F9o!<?B#2lue>FFz%?5O)&{v2>M$Y`=Ssjl^Y3
zuGS;{k_Ib6WUpk~zhiFWkn5`U46^Y=f9NaGr-G5~V1rCLsNe>0aFjVFU=X$OTk|YB
zCz7kjz%O@F4f*59mAujKS!qXS>FAy?YG^>LM5-zO$g7e7p9kw)iz=<j872PKizlF&
zL5>e-F|^__#QK@r(=Q16ZTNW0wU`z*<dE_#SZK|xhC>|=3IoAi2E>qtkl-j@P6pQx
zqm3+)&r5U;IDU%Qs4t?!#Px^H7U0N<YYOonLiAI}%#;sZ`GS-fW#D$`#7#mY5>W*O
zO+T<<7Jg3HjOdmN;Q}&JPW1arCPsh5of)Jwd^|1Egu~%9iO)Xo{Z*GR%3Kslx`8(m
zWLZ$F;APk*D6T248xt9YQ($=+XO31^O@PdM#Oqo{_H{Qp&2Vo6lDoPNpaYDS1)Wtc
z;S<70O3fmb#?5{F+n)qKC(jPf#@yd0q=I8%m~w|yyQ9Y)-p}dac3Pg__jSn<sRVp%
zu?^$h66Ft9%0<#6`7o_eBMhF?jwZDRBuXaT{9}<O@JXY-ty5;92iK5Y(}AFi1hBKO
z>RUhY^CgbYlltZ|qeV{pGlMSNcn$j-`(sPO0yKr`R%5yL71txUn1e$?n03X{BkxFX
zRJ@Xl6HkaUR#dLxWkUW=932+u$;g?dC^=C-1SF<H__D0%kbG}&Ra|?{QCWoKA7&2m
zGWr#?s~X{~a(n?@oI4p?E22OzK04@9uY>Dc?!#j#qy9nFI)G14=w)N=$>Q`0Q>3tl
z!zNVi>A68D?#fgmLrBFZ&iRRuZ1jPhVw$Y9N2dJ+HO}NI9efz4u}!t{8-O5F|DqV~
zEK~j?5Iu81Krj8(@wfXy8yI%^a{q7NXDEjtfwNr(QbrB9pA;(l#x*OdDTk4sr-Zmx
zco~pXUD_uG=82ANI<t2e0F;Y>2;i2~-ekTcCY;rVX?|yH1QQLns5c*@=_Yt=y1d|s
z9%G#pH@;X@{EK(=A{>aGHf>B>z*h8mLKr1vj}Q%RKMAW`=iBJF(+mwz;+u&|f8+(-
z&z$3XwdcbHj`HCVT*Z}x;b@Y#Nvv&49j4}KFlshB6n1iJmEVJ>274TWC6Q7ZILcXN
ze4xl+@;YKRvHA{0$tMtFb`Qah<!FXYW`A;Uj7@)<7+k}z-Tc+JMjl~zhC4OXEL=Uk
zA1aBq7RA;p@Wpf?-vuh;U267Qza7ib6gZ764V}`j?)Jk4S?+P5-*pZBGREpVbdXFK
zhc4=Cwc2IzDf6o*@=A}+_B{u)u8%M$8+TfJGe#r82<GBo@9pFpe(U??6UR!YP2DEc
zD4F4JqjBe(h5mzr()C&1lOT|sMQOh~i~L)Gu2>OKG+L;v0-Frd?Tp$*YPzgZz55mw
zAU|w{pr+OxB?;9ZYh`saeRl+m9`K1lr-nMl)MxMKuP-Y43Hm|meu{+)gyd<7K;{F@
zALxXud2?pJj4^4fkEo;w0={ASUiyDD5)u+;s~n9$bl~RmAF?h8_et+q`6eFw0t;7Q
zjls6&^>UA89!r5I<f(}27)2aitFma$F9|k#LM)fgPkb*GPHrR#ni!k0wGg$#-aBa@
zGVDa=<nWz(ssFA<|JhHHy}`ex_I;`YTJYfVt*kAQ=oo$lnaK-j=rE)J3x}Ed6q<z*
z)c%1d5FV*0G5t3nObqpmFex*wrFZvm0X8_Lb@qw+z50BhSHQ@lDGogO1{zluZ{Ma`
z$<bh!FES^)3W0$yYfIVf#zTrYYxH5$2i(ORhs}?&-_U*oXrvf}i4KbLd3QesCN!qs
z#NPh~yv)HF@!9sa;P@BM>h!A%DMlk6K&GrB`YAn-!KwbORpxRlwo#xX?)sPq*=?6|
z8b-t~%#oOsL2N$<zCDm+nY*qDIo@u7^F>WVqE2F;;Y}UInQwT4`zbu*f>sTXMd3Zu
zOK&M?jw!4PQ{KR=B~mzR?4x=4umDtfYV=_WY<n5d0x(JTVe%8lvYBKgO_I<?RhXQE
zVQ|&d8S@^-Dl5$DZE?%{qnw5@5yp82lcK)s%ChyH#=%oT4s39*c^B|#Ein@g64-2D
zCm4$4Snt;J6BB0SB|wp%@^acW!$lE*Bnedvs+z_HsCoNieUfsaG>0282JrY@yH&UX
z6EIB~XL}Hz*gliNNcXHQ<DoMQHE8}CmBzBj*9A{GzX2D!Na!7rv8(Prj=uru$N*>!
zEfk9Nuk@V&XznKf_<ELW5S4XMSZJBWZM4YYN1WjG>_3kPu3ySM3%$J;0Rnchx$OU{
zpB3Db;X3Vkx*qMij>1QO;=KNkUKf)j*OO1z(_PntN{_omi7Nl(_IGzEX}0TnEKCY3
zL0##;NTXd>v#ggxI0ZAGbE5u(I`bF9DbD@bHmG<U{~^gWlr#(Ng<1$tx8TdV|DQae
zB&dY5f|rvdH$PF?p!rAtt=o*?9}%I9MgY0en*Xl<!}{ruh|rTU0PB<6dM~u*pU0%&
z-yE-}S+A#g)k(W2MgB$lOGIePNmS^r&8r2Li{F6%p#9CUkF&qSdwuRx?!P(yL&obV
zkgo`JrpMyHFZQ?6(3aCo`zlZSasT87t@%soKP~%7L{$XiXE^^yufLSO9wliQMg8<(
z$N_Ek_wg^C`w4cge(g*Bv;GhD=^r|eu)>Jp)P+#RN#XpX*S~b0<(kbB+OF>X_qG1M
z&wsk(P@&S+4U;#j{FCS3_ZdnWW?~%`Wc>~BH;MZX+TS8hGC7Tsu)X=k8uBmFw%@~#
z&Y!t5BVbs6*8YZ}`G0YQ^7{Kv9EJ>Z4_^I`dgyIrpJZwnoZ{SzgCF?Q^1qJh!2kuq
zhB(3Bfd8hAZhH2Pd4I9{^<Sj@|El>XYm$GS{MVIY-JvO@pfO=t|3!f^8-2PwdgU_6
z<oy3+{D159|I-*6@y7TE#vK+B_D{Uq-(cH7044>S7&$cLEgy=`ESdlgsGr}xR5kny
zm-!EXJNTA@l~1P@-na`l@<N-jA9@M{<BB5p3`gSTi?mX}86EP4{Jm$)_;`QNJJp|`
zE10r}zf{fngW<3h0^;2rEOW+b0E7mzU?wZ48Zj_J3Wgv3njnk|x&DJGPJDvta~fP4
z6IW>6649V27=6Sz^gu3<+*o`-S<R3}KMhAyjMwl`qzpj42Kbs(cO|?~cLkQ==FH6G
zrA7au*5~G;G~9kK5Fl*gO{6p(aYnw)_JyDiHXiue(fcc&O?o;Bn&Qm-)yv+QMy#Q}
zG3vJe*dzLeO4`;?I}bN1BAzi_Uz-UD*+oDwj&!&@wnY{uA691{ktlMA!YmxK3&#jf
zFy)O$Xc6{~A7Xq5_D8!Nm9*`wu$m<2MWMW0wqCwh?`V#mfY8fh9c<i`aZChT&2ra0
zhv%|&$Iu)V69x)aJ$MPC<k#6pp=Q=$oAcBcZQLRScinv*8>EV-U5&UVUP+}nD#7eS
zK5f@T7IVh$J>k_{KmSpscE@Ztq?EQblH|Nh4HhTJdt(?%7m!62Ne&?h42l<0`%C3n
z{r%9AM#(F*1RkC~Q?wW~U8hE+&~c8txHh&_&A;^&q6`!Oz+H+#;T-nGbr{2yDX&r6
zHCLwmuV1B3<L}PKik1o#X1&}7Kg2wYd7bbG(JJTE(CnPcr+<h*mG8i=5>X@HCzB#V
z5?Q&Mc+3+A(k*8t!ohW5N&_i63VcSM4t!lQa|-VQeMau6$J@X0Skg|}o5;1FvYSi%
zL*<)^xIdM~`kA>GaH}zAR?v*l1ZCj>uqOyK9n+Up9|)EsM~*cv+|?op^>1p7RTT!C
zgJ2Q!SP-qgV1A)3;oWgJg-d(|U{0q_>N0Cn1O>vqErO*@`jQhLNeMSSg?&5p@E2SB
zs0JEHymKH;nkWQ>5FqWQ4i+9mf~~_o<f&&?ntj)aDQx2BMAo4+s~@Jc0)PRjxW6Cz
z>H75N$2Kr^KheA6g|@SH@83U^nUEPzm1&Ce{X()OeW;>8;egWb%}kj>(wIWx182ox
zjNg5YY5lQ53nGX|tx8<Dp)T>q>iel!vS*<3)GvgjBc7j-hvzUY?~%fdI>CvWIVVFo
z>*N8J&u|_v4BsOJgRpUcKpDmOA)McUY~DcKugIsc4F#4m><GI<7vkFqeUjwT3aM6v
z^#aPWc$70|I}y&C0D0kU`h}lWUnhBHSFiH1{GkadM8zC1X<?Xev;1aLaMyl)^9Qgh
zX1@FZY=_$YpEy@2#QwkR9uokydo?3+R?!PbC`$W0ST&&k(s1`LyZ-~P4}MIn<te$@
z%3Sc$;8K~}MXFU5F-FaIt^qQyOO8c$J80*q2Pg9H<Aq_7%aU8Dvjj^U8v+xhZU7mf
z9907#E-GF|rF_MTm<A+}C$B0@n=f^N<Pt<SV_^6Y1}%?5jHiHuhsv4|%pP4~N&(p}
zYLXp-BLg}Qc1a1!d(z}_+Lz4&+IPmj_$}T925`d2dxaDqZ%5f7vDxx_vh*)oCL1lT
zL@|%GeRJ+(_5d>IAu<K)l$?4fgH)et^|(It0boMZ+|6`$8111!WW~<acv>ja#$(=*
zM{igCyrM5qattGxqXc1&;yeBnw9T(lVkLUFVUD5fJm0`7Us}Qy^fo+?!p7x6<@kz`
zhuPaZ>(x&J!nTWp_DX}oBGrY1V>5h)@GZ7;W9I~rF8=De;}3@7CzoigAz*4)f`B-L
zZ(#V^ckl%-%eoQB(Izip-~7;#iq2u#dd<*_8#Y7|bN%On0pE~X=9+)ueP6n0<c&YJ
z-`}Dt`68@&r^?d%aUT1#_m77es1yg`J>gu^Uj%x5e7XD)V9D~lw1JQecUgMCN8yj)
zaIEAXy;J1m)P~_epAD!^#wQ$o%zphjK<8OsbPxDhCV7|i9efePKb*i~X{dk?H6N@#
zd=UK&ND1?Ymo-CXZym}*DHFK&TJ#(cWtH1B4bl7_j+Ee<-Lm1AMFU_|cdY|f=U)c1
z&IMXtAmP8!vF0j*k&5fyJ38{$ztY6^Hw4Jq1FDP|qp9236P@-bu^ny*p}PNkCH6-M
z%+XmY_Ig4cpt&|xRh2Xq5)2y0c&R+Ir!jNE&?t%HD43#lH6eU}90`9HxPF`kVUW?B
zbU;k-I`Zg3)ox=(h1JxX@%fSaNj*m)?$|NhS|<>M`uOvR2*Ak<1d9$C8>ze}Fv0sc
z6Rz{&<rSqVmoHGHP|qHn`3JUaXfSqLGvfJNNZx15AP*xCKi`7W%w*!bdouMh<ghDT
zTx=kv<)_yw0bl7#ON$_hQy+i)$$P>Gh8heEG)No{2AUG}PwErkKMV&NAMTj18eo{f
zT0igKfAP2BK$D<~fM2ji0%qWg=iwVm@1yRCY9p(^VhO_=?$<lXkCmhF6k2>Zu>xBe
zfLWe&SPlDw5KswN(H|1SzpxrGM(3&`kYg>TxT*HSW-^@77X|yHOX{5ncKD+g<Icgm
zn8c?BoMrK1mBcSFIx>SaK!_g{!c@+M&Z=cE%Mh}V0J>Fb$#Y_I(P0Vt(uwft2qe1C
zp9F53gq6gVz7q$g8U=m|4`I@zKP}Xi)(IRjEIuRCeV3ef0v=6T4+jmlj(LwVHRg2_
z3@Yzbut8*Yv+1J7i{TX87)(qmN;>R<i9<T0^0}<=3Z-2Atvz}|3qPPg6~Oc{$_I{|
zd(2{47KHDa0h!bSVNkZTelSS(SH<I~chF`DREViz-5I!6p8{UWGB7N6NUJe+R6E?_
ztKV{4gZC;2jRNVGL<LRzEs3zO4Bsqx8os}z`<e$%2xnZ0SVD}=w79x^d7lafmXS%G
z&8P%Pal<Kf-0hTM$bL8IZXJ<*wq^_;QyC$LfL$Ddmv1AOPiMbUzoZ2s%W35;e-Ku^
zF{Io{zUQ#03{8A*?$kFQ8i#=A4h-Ide_5gZOiqTm;BRXbdQr_MY+uqtMIl01#~yH#
z6=OZ(_(rD^CC|k*i#)>Aw)ic#$Cyb924+U?mJ|Of5rVKuv_QPtyI@*X=nO&--V_JH
zU+$sJu+JZiLBKu61}Be+hTH$jxAXZ&7JRZtwu5@nC%Q@_U(F_SE|o`UhE{y(lF-43
zA=Q{g#$xC1hNlYI-wG$x+O|~_V<ZJypc$FM!UEga;Wdd`=zjxBgF^Xs-rF<nTYDYa
zDecK~fzMZJU&zRicgAp4Kdh9#<e(EA1^9L~##EoCxAR2MElPA6_uhMWFb0upiB%fs
zK6>z)<iOuu&2YEYm>+CG3f0iRNB#!v?(Wo}252EvM}9on*^TwUU!UY%+iK5D@@y*A
zpgfD^wefmi4Uv$LkU8DY5)3@oQRic%#muste00Jc+E@z+=Ko66<0;hzB;nq0#F}Ru
z&AE4MhPm1ZbKacnQc9chCdWh+wYtX(y}f(!N4!yOTOrpGkS!NgZ?lOOs<Rw{=@ifY
z4M2v1bEriS%uAvG7O=I+ecWCTz$9yghBI#&j9XQ9ue&E$(%^-h8Rk<AaR1PGJ!H!D
z8<2Wu=e!`0nys+$IC_#cADFcC=AC9*9NR%B3>aHQnU&N5nk>?BNVd~DoES0O6pcd9
zsn9Tl+jsy9_S7~1*(^^Ki6zyeLyL&JwcOs&ey0Ja9}bPtDH;7|1ecu-HY0n}m+(}K
zk0?N11~;T)l?&-gO62MgId}$}&`F@_j&>q>-iHpe_9hB4uz6&F77-~Akl6=^{S}P}
z$Z_LJ8VkvBsTv*8Ue_aw8ID3N?lncUvo*0)AGjk}JB8x~l`a{vA|1~ki}@*jeEU}a
z8CE*meY-uu5=e8}uhjj~WmM!~AOidtl{lYfnWus~+92{)u3RZJmUeK#i){NnI$&NB
z=S<Rv>Y62i{Q$X13**OrQ09%4iYT*#vtKyH31+|i(0nzbTLM$EO4tQ_9(TosF+Ec8
zm_j~xmXXBq&Q)^q**&fSWKJtDFCW>*Sxt-q*<TBGjers~zx%5%I8QbR6CRT)Rudka
zNKz7FsWSx)+M^4%>%Tw(49m(XnC8{*Fw|UXBb9d;?2@-2z~TbCU|jo{deaBE*aty@
z@wEPEGotY}<o)V(YqcLW<t4uha&)`@@O!Ci#1lXznGGwsBkgGtjU<{#Avl|hNk=4P
zIu(WBc(gJ+uCRxmQWBBZ4{|(+Mly&S;^58!a_%>uyE(-f2&cu#$~H{K(B@_El{j@c
zp(%-)`Czm~liZh`n=8$->Yq;KmDQbs;Jh8Lmp{jkMA8;a?31~MnKIt~bPQLn>8HCZ
z6|5DQpd)|x#<qtHu=x5|`fbEAz03Jsux71Reta@2ef}HDwDx4U=DF&8L2k|$+Ly4m
zR*fUR-v4^yegVb;FF?5`Lth+;f4P3N!z4xJEZ5rkQ5zgTG(O2ROu(>InYFn$jY}_w
zHKbOM4wx91p3MU;U$W72v|P=!E?0X!epZsV;dB%x%bdG=+$f=1G;8vtH)ee^Cy0H6
za@b4YE$+`x2P2IW^|mAYSM$xiC{A)&KHP7Bb^#3EZk6tb=8HUkAUu;Hqw+555^zkE
zXSfmjGoS$)*!MFIsbH<FfGnE3Y3(bqs_2IR@TYk;YKTUV8eG>yAA%x$s*7qibNgUE
z0ZB$|AHEB*BDYOCrYfrD3O~sIjm5y%aRzxYmQDBqbbtkg=tZ2xB}!<IBe{3Qua`RA
zDAG`Li@^nN^lg2_;^~%{hEDrfRL73Zur=Dc+gS4rj@QkW_G)N!%jhO_#F`Df1f@7N
zqXk$QLk`BB^aJ-R$8TvC*F&d}P6^he=8%d8qxDkq&@(Y5>sROoe{Gi&>a;@OD5{nY
zT&Xa{vOGpcw#(jXA$1~^S)+ebPOl{Y2~cpLVCD;$3V^|)#9ho_7msM#my{`xx=PU(
zH!)P`D`H^~mQ3K6F3~e@X1N3n>F0?WokVye`+jV6&Pm_s`etynbdPX+ayTSu5-Cp{
z?5Fl7Dps5M6pa%jr^YMJ<@8~nYTY>Ul4QXn9cDF{^ZK$CHhr_57_p#@l1U3BIO7Bb
zfzad(&7OG23v89Z09fLWWm{N!;tH}L2(N%}08%j0`YKlXY)c-TGeEDgsBBz8{4554
z|FP6S!(dzqnZn#a5mbk~Ah#V(dvj3oz0W%|NO);vwuv(Jy(rsi`|RK&2@Z}L1NW$+
z>!m2ePcWw@p&7WQ=Y`P-0Opqv^~R`%ES3z)VDFxEW7yZ2wH8Z$HXh<7LWcn;!~O<5
znZxFq)v=?bAm;MXAW$-sjGZ|qSfQx6_-p%Hm5ewiwY+P>LN{-WR|SH*5P&p=UG6%D
zb}>n?UI=AFUTClLef$!c+nYmx<*Lt`uKpS2!$lTyoXiy3aSQ(8T>L_YI}#bgR<ccu
zOye28JBrheJW<%0q4`Du=c@`9j$Z}cT|rTmQBp<wxK(KAqQW4(Ml5Q*y3&AWM`Kqh
zf<OnHh^i(Pa&$KH2~`uX;pTP4@aCbd^S1uht+$75c$JE;0%jQCLHC$I+)ZX_6UUYi
zr=x|a6g0HhG8aqP09*4xD(uDYbj6ZxR6oDyA;A}a?)X2geP>h?ZM*d(5D1|K2t|s7
z4xt!&6AdvysD_R-sY>tNLg<7Vs&wg9dJzzi-a({^ph#0tKoLbzQ4i<Od!Dn-^XpsR
z?^$bR&AR8__qF%6=h`eQ_v~*;1aT-oWYj-Uy*H7?ABS2Zdj22;Fm9*K+ubbLpahgC
zwgjk*F|dA+SNqYW=wk%7Z9zyrwl1Py37ETgEX^*)${FTn5XpP<;MHzr@FkT8T_+Lq
z`U&$q^5hmeMt-@;GA?$Pjm+jh#@PNyf`;M9Y+txBuC$#}iem3_$4Wqto0|=J=l}!Y
zF<%~Fc&*y*?txt6H+ISi^hG@1cp)1%@LPpgcRio?8Od#+mxrV4L}vJRuY&T<v5Bn1
zb__=I$J5aUozr2^2h#q}3E>I_PNnnr*}HSk4H>Brtqd*=lMVHU1VVMhaDMr|)G1sT
z4rKCruv_vOb*cFCN7$>6+xaSN9(V9_C$zYF;wP%)x*;%%z#ORDmNWe*hwzSX$@8Nt
z$vI@hIqnWKogKlI@*J01?u-JEzmAVYHJ8q}PRyT(%XU~#&P%+b!{r7GL#i+CfB&>k
zEA7}cFnt>4ZNK)%LNBpjwcB|33b+2aR9(T5^k#}6?!C}iN1V=H!1hdz1vLHp#lpN{
z?ARIyaHy`rG+{gCKYUO<F+I%8s$r+o9)Mx~aO+5D^h<`x#4OyjSQ4Y<K>DqeTUsmh
zBQj>gm;*(F@)l@{+z;sQegjdT?U36GBqQ@<p9igI4Ov9xdZv=+@C|Vmd}rA1PBK=d
zTfcu`aKm{aI-DjU?E?t3xY{Sh{lrVfGt=?5ZniF1-9S5(@+M+PdoI$dKQx@f+}BAo
zOQ4x^x#b`)S~9(Akl5Gv>;J&}d6R!zs3>RTM`?SM!>*KM%ixh&h{8spY%<ubw*qn_
z&aCEwRB@z`S2AL1GhG~vAAC|1(OK53K9Q47YN3m!uF9Js?s4vNc7ctv(*h{v#3HkF
z6Q4t?gOrEN^!Hq=$@MfEO-*vaxPe$^_scEM!;OQ_&7&K15Vf)`jV&L+$!ZZbeugQ2
z4NB=A>AGwuN-Wf!G27aI;mA-0;4tbP?60Oa-uV9L&QRxrz<Wg9yBx0LMkUMxJN)hi
zWgbHIP!w2ryJxd?<-;3%MetfEjV^1YazJpo3HADL`Rv-1${XAE{e5kDv8Lz4=PP?{
z?F{7eVpfnb@Mie(Ki2yIn0nzDX14lSz*hjl3{QV$0{h~%mm%qj_RuL%^_41NQgC%P
zoId1`-3`^(CQM$~XQOz(l=oFCUOrXKWsh88?C8~X8Yp>{e7)jBsPb?y&ZYsz<#1xw
z6zSzK^#SDzc{(J(<QD;os}wpAJNYv+8+P08OU<2!c6t(#Eh}pf8+`}W=AYn2aDDtI
z;jm>#hz`PH`W}M|98=tM=eieos8tw=iBDCv3MjYAfBj@iPjKCmd!QuoS--1xhsK_Y
z>l1G!Q$YdPK<Xe&q4R#>@_1Av#DHq-sM!h%M9gzitlV?`$5xA4Frx6`c`*$p(mMN?
zI~>t+M@mQOY_qR$7e}k}b#guZBL4*Ia<WY|!Wjh*6qx<uKzo>wiDY>70`F~fs4prQ
z+OJehml!m_A@ks2$ve-_)@MUiZ-&=y&9#B-*gyYasIy15b(>@FFg}tPNg1M+J%{i(
z@22NJjp)8nJs`wp*Z$zk{k0N`vujKt@0VdI!YWm)CAf*->^j6q^9g)JW#XYxYf_jR
znw8_?=fI3PDqADcpw~W)21+r@U1vipR(fa}DaWo6XycS#yI#D~tXmq5zDnA{m)DBv
zs}C|z#gs22c*sE@S(+6MquOo~e^(fd1V^L=d-}N#eu_ol{I^|wfk`8A1L%0s1o$ri
zBxy`)XcpyV6vw^zrKtSAaB8;V<GtFgtqKXBJp+fE)uj-3hMQzs;7NFdb=K#2iY1m8
zC+YuF+5BSQ_2GibgYJM#aw~TO>88}9D{`b5&z|7{HZL2|fyB!mGIBAs9<ZJ<O*aT=
zBC=l1>+%*47OXQraBsGkIXZ4i!eLyUQJms<e`}SIR-3aJMl-KI^cV2>;z`vRVMOE3
zkzUUmbsk#nYJp2{6w!)b(HZptw<8croqLHw>G35lk;6fo+6OZd<oTUI!dt1850JOG
zC$o|%mi^TG_VB#buK0p|h1nN;TuR4h1+OL%Ch1^ue5RhVzljFzHD@I;eut9~3DRs9
zLgAAEjCKggSH7A1SOR6t(U33iW2}xc?q7r7=Xn@+`_;dr<^kk|Mg$BW-libTwysAm
z91muJe)oG+Ek@#Y%`#26tEA=CMI`{_PP-Yn2>AJYKH4@|(_nOi);AMZ(YORPGuAZe
zb8hovWKh;<tV7{EZa`|Ido;b`J9GA5K;tAW5zFX*A##d2nUDkVRNMFp(I<&%!U>|*
z>U$b!TRZe~ds0sQo0_G)z?#<s<!DiE5w`he8Wu{>*s-fUBCbi{R=r5c%X}tUjD$bw
zAuwPc(i4kQdi>PzMQ#gweD^i0TF#}|6>5wg<0t1SFCl}#rxquHM_g>QVuEaxuLD&1
zh;xN0tG}Q9W@uZuo%Hkje@@UpAm$8JZ;AbTVJ{m0S+g{?ctc}RnNd9;f9+RJxpf;<
zo|=jJQ-kPz9-7Z(e!`?_tEf`c1A&p0jAc%o>WZcF{2BwfHf&!x{kzh8Q79;88LqSB
z4O?CsNTs`$7LS4it|#frBVg4IR2o_wEdvg;nXml7U0gFx*UbmXB7+F8OTxA88ol{8
zBKX6M4Q8UrID&Ek%5I_4b9Qxt#}T~$_N{p!h{6E6nbFPOkM!sZaxA_wM;5iD=c=p7
z&$Dc^5E~t>B>KO-tx+#12YF5>zYQ{l7n5G}md6h^nxUwKZdb#9wGZ7?BC9Rk`wLk7
zb9)o=qCbn2F1B7gyjX-1nV;UZW@IM1WKCY8qNRr6xB(Y1M`enO7cTSA8?hyRgHK;1
z{?}-V=SiJr>ei_i)f~4BWD16B>bZ-<WOZMnfzegm-G~^HT>XBFazi-DRD3eJ8lNx}
z*=bl#8$sB2pq|*J9fC!G$SMs@5w0ZSo@AOI#y29mOO*C404fpdVezw#RM)AkSEwt9
zZur^|HF5T$a4Ra?z1G;VU18%3h3dYcnxC|j2dtRpHj)v!&X{Wc9?&SWTr>apJiZG<
z99m%hhBy~6Ztbecc7-nXK5P0a8&Q=zE6;~wEwYcwRGZ%0#s*zV+6_BzF`3lDFZwn4
z;Vssgu$`P48|zIe0BRfTI0L)FMX)`NpEUIfeF)M98P)DcIKNZkCsqk<BLFxU)joI8
z2gg)4bR2anq$3hVRK|G2O{lpB2=mwJGNKQ5e(lvq1DN;ppo1%I8Akc^+}GnOzpC~1
zBUE3#oAEmQRYvPVTFjUCU@Z{#GB)OsaHdUrH#ZfeW(7~P;WhO|TXZQ8`>;yFa<(C~
z9tl`eXZU+zm~9k+CiH32KEpeqG{P6%%iIkuyceh*^35w#XUg7+7#nr_IfCTQy1a@{
zT8n0B$%$VZOG;ir$uHR1>wNCbJUZILav(#+am@|{BnB&GvDofX_-<;D!M>c2(#K85
z7?vlxwSa9yvFI7;nu@-jZELFp($opnMr9lXZh{r1f|<aMx@%AGmQ4)Wm+o5u6doJs
ziMe2Lo(lDPhfhx6qgw|vt!_ntNYl^3X^R82|2chJ3Hl}NhNd_*D`5BtIxlp0M3`3Z
zksh~(e@Xm62UuM4Yd!uw|8E8EH>Rt)Z2EiZ)u-q;pt<GgV};A%q0A>xRyUF)4<Uv5
zo6ND7g+ULs-3nmz6wIdvf%w8{yHQNk8kvr)uinF5@fCT-gIj-rTsd<_q=9-!KV|7q
z`5yQqT6LL^^HmKuU5YX88J9IW>Uq~MbXVp*5qe&cZPq9XU0!w(7T4FtZWuPtQ`i0z
z7><dDS684Xu6u2g{S-2BlY^*cs1|<XA2g?_T4_tJ)voqaDCc?Bn{Br`j%S)^ag(P1
z7e$`DIkW<2P6YcwlpZj!E}-A#pkz2g+#GN)#2(1PJx+9&kcDc3SVeH^>=c)kdtuML
z6t^p5pdU?{>Y4O7y(QU*^dKZ94Zm=17@m{B6v?d>8Xi&XV^JFX%Lxn1y0Q9gv-(Rx
zo@#s__PWIR(2l3n;pHqDt)uhp&Z2y31RsBw9xe~&jhAn{kC?<*+Ky&V-t_+ZUke1a
z9enVkgpZ}(9S$ZFmCehTsH}Y6Wm`t~Zp7X=JveZrbSzPG3N@a_w1=g99#6-bUgDk=
zMHNTB2Cc0s{<L0|uB9A#S((zD#_ssxn35=ob5&e6Y<Rz$!^@tV-oc%nt-CNQqp0`D
z&*Z@}@5~hs{2crduoj&ob3Fh<64$>Ovp4Wo+0Ojv0>iT_)!r*&0*_d#<;VaRo)o49
zR|iOgnCRV64kAeO@lMcv-e^C6xCb-Xr04gW{{!mZD0!LbeBqF-cygVP;Q_nHo}zli
za87>KV+{RV@oq%;=6JCQRf_(Wk_+8(X<c_IAj-<zN7x2EM>yUxKj4wdEZ*zoY_Q@K
zZs6ftXflu<Kd@uifJ&;;l_cBpnTp_I(M$FR%E)A+6<Y4JPjlZ(2_R9jSkxWLOy9#w
ztVh>ff``8H69=#))d3E$uR5oqt%Kkgv*)`U#nA_|TZYN~NY$k1av#pPMrzOn*dq#A
z$`2Xw$j8^n3hs1r?NrK;dj?G~mBqFul%gG+bmfDPaM1dV<)0^wH~*=yg@|zo4-DG!
zhGWM+RNiGUeleV7U7crIWp|G5(ErwWW1QF``R88Ae7SP?ueCGFrjjA%14d*#bl9h+
zv0zT5P3h<7R+h4h(FKwAHU~>xW^x>en5f26iuJS=fY!ZTvcapPFKR?}+^OKG*14g$
z+_#(K*<N5!zQ#ICIM2?HL+)Cz<}`<AYoNOn-X-}WdftMQ;o{J{u*t!e!Xa4^;;(1w
z*C8M6FDwt}?$zb4_p#V0V(h%r?q&vTn^~(>Hy-_~8nWW$g^sMZ2{j$=5)JuL{yQ>s
z$Rxm}gl17xYDMTy$j<ZJqEVZ7$FYW@@VGQSLBuGmBo&TRb$}WUU2~ej$N>PibN30P
zrfmtHkku7PU7gbgsDt^f{4qv(Xl#?5$u1&v_&99Zj#@L%dAGr`%uvp#eVJ07xTo|C
zW)7VfH8o|_%YT@4EcK#L3y8iCy7PT^xe1zqH<yr2x*#g%rhA>YU&8|lrpCK4+Mkr?
zWv;kv-BnX8IsC@`jo$KQAM@xek3;zBYs~F%icz<v8%(c%&NpfF>qvXtV|@4*C`lR~
zxPL3gvM0o6D(X%_n_S7}m!spGg=Ep{T0Xv>r(|A$krt@-r1RC7H>_m<)m2iCnj8W0
z6Xhj~9zOdbe9>YxR5;iA&0AceL^_aHY|%#6;u|NE1wRwe%((4!Sn-?-6*g;B->yJK
zojDR&ZI!~#N;YwlbqHV_Bt`}7xkowbW|YBKhi-y2ZgThxm?W`Eb+f0?0U6o~REoC;
zJ~6^K*<%q)#a};dC@(phL>{1q=kiZwKfCFT+e2k84~2W0HjyoD#7orTmf0M}?4xpz
zzOD~FUU4-}jyQHn$g)~NXA4%%MNoI2*)b!%)w2OWj;Z>P)@{Y*(-}n>RN5$JVf*M(
zBpr+PkddwlT*q+u2emQ$C_Tw9FzHqi6G&W9gi4oGG9~7A^g@me644hn*OO|80jq9b
z{Hc-1QWM=1{fS+nqgujY9$UW5cg>29oXkuSJPL2i$z3I2U8<BS$F~A$Anl=F(uPF^
zljj81lBgQlgnK7F24+tUio@pA%^><S+s7~2Sd-HzSHA2JoTVO`%#|o?@0BAz&_TZy
zSx~>A&Aq_S%CzzjrXPfOJ3=Hn`3p;oj3>+(_=avNxYPx;sFWt)V{<lgZ}4zX;jT;F
zU*bs2Oh{If7g1+y{2ysnD~7=|ZmyHbsOTp3&!6*jX?Vla-BZ?oJyo(^BUScR)hK?x
z>+wZNb4t?-4&)f*Qrps_E)XiAItU}E$+cQxfN<NkE&D*BcF@X4uS{dSCtO1<bFk_&
z9qevA)#YbyFxps2r%G3Ob^i#Bm<_PmtFK=kD2V8e^?0viG;8C$^XnuQ`eKz7qN(8R
z^Cd?y$%fm0LxC<rKM(LwI`~oL&|PyYY1|7D_<QXHqS`GVG~@lxBiEB-izep~@<*wy
z=o$x^H`HK#(}c7K)`#6=O0u3joGA^5?f~)D8>nIchMY}ZltL}KKJU5Yn&J|d*`JT2
z5+%*b`W4IY*N~$+VT_MS_`<5#;D+Cy-u$mmsMGU2+%_dmWh}U3fixz!nC^gv){&`_
zT@^_-rV|+F4vJJN)&}keu!U1P?9f^mVx>ADGv#tHnpyz9R`Q8W+u{(O=Ydqj7M?L~
zcQhht-OV;nngJpdpka$De3ZAqMtb7V#z1#1+K&kiDmHQr9m|OcN8CQ<8oV|b-ef)4
z)Vtd;Ylgn&6}KI8E5G*wJ%xt7I~iZ1DM+ENe8n7$q>-Tn<Un*a_pI9lorJ_E5Exr-
z214PZmvvFX8}a09VGJ`MC`>zGwqlF2sO@nPzyId{=sCY2trZ&cv2p#h)l%H&@ew1@
zrv0!kO8G(35`YSzXSMI?7?$$vqi_(OG&kd8C<8M0UX1gYi}gJrV1tUwlHm&;;1Xgf
znM+hpM?SZ;0;3)w@CYY%?s+eM&mH-7c(TM_rWnGnu@02JAv!G6t&ojMwx7paTEz!z
z@<Su!bCf|B5YR2Cx`!#m!*4ir8#!MP%vz#r7ts2&t3~K})Adi%64v6dPD{jL`GRlh
zt=QFBj7zfbKs4c!`jAi&4+GkAM?r;HJP50NmI*4tGhxa?nAV=X#{H|9b3k|EtE@OY
zz|U1%Puu~Qb&Dy$Vk8I3Tw>f#ghw7PraWY>HdzP&qYJj2?b?Nrf+H&YDoSmsREvBU
zcDPWuEZ7_UF)|N_&C~mR%RwFz#=#<2GCt2ys84EzIqr{RquyGz4)>3N6^GCaM8aCM
zvf;hb0Sn{`M?t118x4#{4p>$=icZC+h&^5A&PPY^ud0YK@MV80S7G>5w&*vrx0lQs
z5OwQpqr+^_!szRKiv#I1WbYZX%C}fb{@2*OR}o>4x!vq!%K>KMO}Z!4Tr%wfIR5;Z
z2R2tcLX7xa*t&jI{5#cpGi@itk#|J;3otuVDPK@ui7(`LS_s%Dpq`st?Gd86SOv^q
zxt?or-S$Gj9Urz#%w<y5mQ{6gR>a#PY4XpAvB`ofee!iOEEcL!9vi0~1yYKrZpIJ?
zpq*k+?V-=P7(z*PG3P;3)j!0Lh+Igt(Ie<U1KB|>#A!kfTMk0D3V&T1Kx{tj7n>1$
z4a7f-x3DJELt^BBz6!##-dpb($EEiilv*b#j@hBjZP+i@@3z%1R_AyiV<gkN=RQz)
zFqs%PDY|=jfLAPQt<hE-NTteZmnGjz<Bjn^g*j4z1*tRfom!g~fwXw8m)Uj!ezqq#
z$j|O=u+io9QT9es#iJhy7a4q=b)yoE;{_(Pg1z$mwa^1QI%5JMOPabZ5h0D0H0fN3
zL|O=r?Q_!BhciAZLxQ{)i_Q%^5yM8z)TU-GY`7x7R#}#=3HHATvL&`1D=M?laz0HH
z!f>hwvGV^4`BwsV(l){t&xW7R3Q|^8swrk5QpkHt-tWnet-cwKsj5$gFEs(@NN^e)
zpRY&9gePEeym2&wu1qEO=ZbtH3Hi6PC3v{M-``vib9JCB!&&M(EiER0T)D5Z-r(&A
zXyutdR%<fC=*wrazw=P`{T6vd987+dlG5}o{U~xY**bQ#$q276ovFCx6pCJ?DBs%Q
z(l?kNnW(GbS}HyJUO4^do7$!G0YO{;@3)n;BExzHdsPoJ%#9T5G=6+i&Ha54cJta_
zVEDfu^SbFQu-7{LR(KvC1%9B{^oM}n+tqhVA6<;>h2nLT5nNp`6xReoaIwBk&gDh)
z2>xx{h3O|u#x!N0P=K*t5Y$Wv^l)=aUCyQ-<(x=;SHcyd_LVN(M85(1*qzc8-gRMz
zgF@dfHmYys-A+FO#H_hBbR&?j(VFjxd`VCi^KaKw^(b|}VyQ+n33M{Rk4EOs*M%_`
zqiPH2xpzAf{LPc))q7-auG@Fwb!>?Sn$)qYL=)~kBUfEcdlM+w$qL3+A|iG5d_I%|
za6mjj8}R7c3gJ;P&D-x1YuYEAEXrkuQa8f?L;rukaXL!6I-K`6C%-+p^Mm^5!L^xr
zzov+D_gTvE>-g96GEP@{`NR}->kHo}pXO;VJ7x+lFxm0gH|r5--go;+3naZ97c_mr
z>@u28Ym{@yr{*B*_BD{cUt6x+w|YWAT~wgl(N-62-JI_v-0`*(9NJ~0XMJDeQAgKI
zcbi;_sGyb0iCGEN(O|n<1N?zgykS*3#pRqcOKVYt*mS$M(&$w-(_(jnQN}>9Wg=i9
z`bA1H1evHLTsY@j&>G-aRv74*HN$D>X_NqAdk`^drmAl=tpo{N9s00+?OaxJNuG0O
z^sK+#iTyn8>G22hPg+W$YvE-MO?Y`MZl_ulDN@eOELF~CM9=MZiIz8g`EZ6RNdY<;
z9K9gEgwPrrYu3mCK1ck>*Y>4kV%a(sNfzB?D{<$!E75uBb^>_tFb}oYpCrSR%6PQ-
zkA_y9?1~S>7Y5Mw2s(}nfZ9zc82nlumrSloT-F1Q(Bg-k;x7K<P`Y&mjgNCFhEpa^
zEX5VAYqdc7w!h)A$%*Z;G4D_dC4$(}YQX{+A~N;_%|JIuJPCxZwLGs#S9G>^VeMk(
zYPV-B-+HpI4rwa~AU{ACT=}E&7pVCQWISD=?e{qoy!TuD-bS4HxuH!rg`(u>Vd9zM
zf26)|-x~4AG&Xwn)J$gK)+d&(C?e|c&MBlN&$l$M{_qNeR0J9<j}cO)R?;<e0VLiM
z?^B$H=;t`b&Q#ES9jqv9r2F<|EH(5OsLFf({$F5O-svFZ_T!?vKmR{o<L|3%agTj7
zrlx0j=k>(63wP|m@3X?DZf-WQEHPcwg%V7}MzrqG^ys^H#SOH>>ZKR}ZG6&EsUlQk
zU|`=pQAnPI*QVjE#VxzdmjkLo$d~(w#A=g(^R|XCVK0Ucr4O(@s)@+4>MfRxs9;%H
z(o_iw&Wo?YQeA)}>Af~ZOD**_@zKwe@@sF!2H?d!2m|z0nUV>EK=OV#tV<_Ew6BR&
zu}LbviXqg|`<(~mxDMtEZLTn)>LT@7FBbS<_X+`O;ECFXffHH0R_CqJm}pO`D^sl5
zscX4vgAJ6j9@@PNVA}ZWh&oLArbCU`5w!wHPAT!>S3$p|x75OKeQZE7r2X%40F)AD
zPgT9(D4oJ6R;*MIA=SL=$q2+)-SqmLEen^z5<*FD19oFDQj1Rx6ScwomzddiOrs3a
z0V>%?L&>%Lx<G7p<M9yGL%^GqDVHd8(fE;3kp#O|Xh1!PaVlX8`oTqu(rSb#Xc)D%
z0q`60C?zJg&mi-w+f$lvX3&WqS<dmKhBHVxB_ff}rXJPj2(J-{I<Gl{iMT}_k==K4
zYcbW{cClMw_erhei#911IRRH>f13#sZO1MrFGLI@nMGOf`7A$>T4HaFEMa0i7wPO0
zztUXO#5Jimxs{4;YgUNrRCGRNSjA*#Ex(%^{R<qvWca+UQT_Nr*^u{>6(6bwkh60U
zW&LR&3L%3yox^|l5YzF*ZYx60<?+;bzHIUEa^~rhu+)?yK`h0cuONhH)PXXgg>U=f
z(dT=2XN#-Ky&2Fj8rxu>>Szs~+92&+h<%$~#)wkwgFA^Yr&_8hw{4i4YMcVA-&Kxq
zZj;({^C<M`|70sc*}cPeoE(xVWA#aPTK0)((7mKFlY~ZtcWTwp0W+lGgfkhws@;Ub
z2DDvke8(y|E&n*gqxZ(wJB#gG;70HH?%1i+h!CAmZ;oRQM8)QQfH{M-&UlPcx(N~3
zb}Fd&AFA$v>V7(!Y!LeyH|p5B)+Jttqaya)4z;Fvr-n6lQGAN=2=8;}+h8=&vV6fy
zTH0Q2W7Saq$H4M1nY@DFbQzzYxdY@i_8uQ~4}_L};xo7k&T%!N=@q>eEm7G#9Ij;{
zLVq6<jB_`!F^*|RXg1Tv`sN9`(_kV>)-SzGG2ht0M}g6V-2Qq*Qej!{E5R1&9Q^u>
z<eQUhe(BgPA&84DH$O$i8x=M*n+O9_d{&&86|w-xjNEYCin1eX>4Z{UMee>1+^IM6
z>0J9`!gmc?tFJ}>ni-j9|2i#RL`j<o2Djb3@#hUmda!)k+$Mg*<7yiI*SIcV0$Huy
z7;Cx)5OlQ!NH`NWOmY&c?J?VGjf_1mLvx)*okN!uSw#$#)Ahm72{)Ph$Y{p^4|Flv
z2dnNBZBM?0h*J^$GT`MER?Lr>itW?Fq5gtdo23oSQrGz?)6+eVq%dZVlx%K8G>^*b
zd%7LOwzed-hqKVe8oIEp5V@{(9gra?tY4={6nEYaQe8G4vvNpAvH1U*Db*N!i4bv1
zgF4h8?Isho?Y@@9Ry7OpC(t6Ym*?$Asfx#d)S7j;#U68V0im0^{c5UEnG)6xhGW6A
eoN-S!YnDA%55n|c3m-_pqWbeg!%u1czWgs&mTQ^-

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Transformers_and_Tasks/transformer_construction/index.html b/latest/tutorials/Transformers_and_Tasks/transformer_construction/index.html
new file mode 100644
index 000000000..8b244a3d6
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/transformer_construction/index.html
@@ -0,0 +1,215 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Tutorial on how to build a lite verision of Oscal Assessment Results  with Trestle SDK from your posture result format"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/transformer_construction/ rel=canonical><link href=../csv_to_oscal_cd/ rel=prev><link href=../../Trestle_authoring/ssp_profile_catalog_authoring/ rel=next><link rel=icon href=../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Posture format with OSCAL assesment results - Compliance Trestle</title><link rel=stylesheet href=../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Posture format with OSCAL assesment results - Compliance Trestle"><meta property=og:description content="Tutorial on how to build a lite verision of Oscal Assessment Results  with Trestle SDK from your posture result format"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/transformer_construction.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Transformers_and_Tasks/transformer_construction/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Posture format with OSCAL assesment results - Compliance Trestle"><meta name=twitter:description content="Tutorial on how to build a lite verision of Oscal Assessment Results  with Trestle SDK from your posture result format"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Transformers_and_Tasks/transformer_construction.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#tutorial-how-to-build-an-oscal-assessment-results-lite-with-trestle-sdk-from-your-posture-result-format class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4 checked> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=true> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#why-nist-oscal class=md-nav__link> <span class=md-ellipsis> Why NIST OSCAL? </span> </a> </li> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#overview class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=#choose-mapping-strategy class=md-nav__link> <span class=md-ellipsis> Choose Mapping Strategy </span> </a> <nav class=md-nav aria-label="Choose Mapping Strategy"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#observations-only class=md-nav__link> <span class=md-ellipsis> Observations only </span> </a> </li> <li class=md-nav__item> <a href=#findings-with-observations class=md-nav__link> <span class=md-ellipsis> Findings with Observations </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#implement-mapping-strategy class=md-nav__link> <span class=md-ellipsis> Implement Mapping Strategy </span> </a> <nav class=md-nav aria-label="Implement Mapping Strategy"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#file-interfacing class=md-nav__link> <span class=md-ellipsis> File Interfacing </span> </a> </li> <li class=md-nav__item> <a href=#data-processing class=md-nav__link> <span class=md-ellipsis> Data Processing </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#examples class=md-nav__link> <span class=md-ellipsis> Examples </span> </a> </li> <li class=md-nav__item> <a href=#contributing class=md-nav__link> <span class=md-ellipsis> Contributing </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../../Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#why-nist-oscal class=md-nav__link> <span class=md-ellipsis> Why NIST OSCAL? </span> </a> </li> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#overview class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=#choose-mapping-strategy class=md-nav__link> <span class=md-ellipsis> Choose Mapping Strategy </span> </a> <nav class=md-nav aria-label="Choose Mapping Strategy"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#observations-only class=md-nav__link> <span class=md-ellipsis> Observations only </span> </a> </li> <li class=md-nav__item> <a href=#findings-with-observations class=md-nav__link> <span class=md-ellipsis> Findings with Observations </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#implement-mapping-strategy class=md-nav__link> <span class=md-ellipsis> Implement Mapping Strategy </span> </a> <nav class=md-nav aria-label="Implement Mapping Strategy"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#file-interfacing class=md-nav__link> <span class=md-ellipsis> File Interfacing </span> </a> </li> <li class=md-nav__item> <a href=#data-processing class=md-nav__link> <span class=md-ellipsis> Data Processing </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#examples class=md-nav__link> <span class=md-ellipsis> Examples </span> </a> </li> <li class=md-nav__item> <a href=#contributing class=md-nav__link> <span class=md-ellipsis> Contributing </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=tutorial-how-to-build-an-oscal-assessment-results-lite-with-trestle-sdk-from-your-posture-result-format>Tutorial: How to build an Oscal Assessment Results "lite" with Trestle SDK from your posture result format<a class=headerlink href=#tutorial-how-to-build-an-oscal-assessment-results-lite-with-trestle-sdk-from-your-posture-result-format title="Permanent link">¤</a></h1> <p>The compliance-trestle (trestle) project provides helpful modules to assist your standardization efforts. Discussed below are some best practices for automated bridging to NIST OSCAL.</p> <h2 id=why-nist-oscal>Why NIST OSCAL?<a class=headerlink href=#why-nist-oscal title="Permanent link">¤</a></h2> <p>The Open Security Controls Assessment Language <a href=https://pages.nist.gov/OSCAL>OSCAL</a> is a set of formats expressed in XML, JSON, and YAML that provide machine-readable representations of control catalogs, control baselines, system security plans, and assessment plans and results as adopted by the National Institute of Standards and Technology <a href=https://pages.nist.gov/ >NIST</a>.</p> <p>Standardizing to OSCAL facilitates data interchange and understandability.</p> <h2 id=objective>Objective<a class=headerlink href=#objective title="Permanent link">¤</a></h2> <p>The objective here is to transform your compliance data into valid OSCAL, in particular System Assessment Results <a href=https://pages.nist.gov/OSCAL/documentation/schema/assessment-results-layer/ >SAR</a>.</p> <p>Examples of existing transformers included with trestle are for the OpenShift Compliance Operator <a href=https://github.com/oscal-compass/compliance-trestle/blob/develop/trestle/tasks/xccdf_result_to_oscal_ar.py>OSCO</a> and <a href=https://github.com/oscal-compass/compliance-trestle/blob/develop/trestle/tasks/tanium_result_to_oscal_ar.py>Tanium</a>.</p> <h2 id=overview>Overview<a class=headerlink href=#overview title="Permanent link">¤</a></h2> <p>You have a source of compliance data that is in non-OSCAL format (spreadsheet, XML, JSON, database, object-store...) and you would like to transform into standardized form in terms of NIST OSCAL. Presumed is an existing method for obtaining the compliance data from the cloud and materializing on disk as one or more files.</p> <p><img alt=transformer-construction src=transformer-construction.jpg></p> <ul> <li>Source files on disk (pink) is our starting point.</li> <li>OSCAL files on disk (blue) is our ending point.</li> <li>OSCAL object management and emitter Python code are provided by trestle (green).</li> <li>Transformation Python code (yellow) is to be written by you.</li> </ul> <p>Other possible code stack configurations (not shown):</p> <ul> <li>write your own command module (file interface), but use trestle logic module (data processing)</li> <li>write your own command and logic modules, but rely on trestle OSCAL support and base</li> </ul> <p>For example, one could create an auditree-arboretum <a href=https://github.com/ComplianceAsCode/auditree-harvest#report-development>harvest</a> report (file interface) that employs the trestle xccdf-result-to-oscal-ar transformation (data processing) module.</p> <h2 id=choose-mapping-strategy>Choose Mapping Strategy<a class=headerlink href=#choose-mapping-strategy title="Permanent link">¤</a></h2> <p>There are 3 potential levels of OSCAL Assessment Results that can be emitted by your transformer. From most complex to least complex they are:</p> <ul> <li>a complete SAR</li> <li>a partial SAR comprising Findings with Observations</li> <li>a partial SAR comprising Observations only</li> </ul> <p>Below is a snippet from the <a href=https://pages.nist.gov/OSCAL/documentation/schema/assessment-results-layer/ >SAR</a> model with these three levels shown.</p> <p><img alt=assessment-results src=assessment-results.jpg></p> <p>Although producing a complete SAR is possible, this transformation is not covered here. We focus on partial results, either Observations only or Observations with Findings.</p> <p>Based on the data in hand from your compliance data source, and additional metadata that can be made available at the time of transformation, choose the best fit.</p> <h5 id=observations-only>Observations only<a class=headerlink href=#observations-only title="Permanent link">¤</a></h5> <p>Emitting Observations only requires just rudimentary source data. For example, if each instance of source data includes not much more than:</p> <ul> <li>inventory-name: ssg-ocp4-ds-cis-111.222.333.444-pod</li> <li>rule-name: xccdf_org.ssgproject.content_rule_scheduler_profiling_argument</li> <li>rule-result: fail</li> </ul> <p>then the best mapping would be to an Observations only.</p> <details> <summary>example snippet: instance suitable for mapping to Observation</summary> <div class=highlight><pre><span></span><code><span class=nt>data</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;rule-result idref=&quot;xccdf_org.ssgproject.content_rule_scheduler_profiling_argument&quot;</span>
+<span class=w>  </span><span class="l l-Scalar l-Scalar-Plain">time=&quot;2020-08-03T02:26:26+00:00&quot; severity=&quot;low&quot; weight=&quot;1.000000&quot;&gt; &lt;result&gt;fail&lt;/result&gt;</span>
+<span class=w>  </span><span class="l l-Scalar l-Scalar-Plain">&lt;/rule-result&gt;</span>
+<span class=nt>metadata</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>name</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">ssg-ocp4-ds-cis-111.222.333.444-pod</span>
+</code></pre></div> </details> <details> <summary>example snippet: instance OSCAL Observation</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;56666738-0f9a-4e38-9aac-c0fad00a5821&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.ssgproject.content_rule_scheduler_profiling_argument&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.ssgproject.content_rule_scheduler_profiling_argument&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;56666738-0f9a-4e38-9aac-c0fad00a5821&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;component&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Red Hat OpenShift Kubernetes&quot;</span>
+<span class=w>    </span><span class=p>},</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;46aADFAC-A1fd-4Cf0-a6aA-d1AfAb3e0d3e&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Pod&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;target&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cluster-name&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;ROKS-OpenSCAP-1&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cluster-type&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;openshift&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cluster-region&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;us-south&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>]</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;relevant-evidence&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;href&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://github.mycorp.com/degenaro/evidence-locker&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Evidence location.&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;id&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.ssgproject.content_rule_scheduler_profiling_argument&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;time&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;timestamp&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2020-08-03T02:26:26+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;target&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;target&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>]</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> </details> <h5 id=findings-with-observations>Findings with Observations<a class=headerlink href=#findings-with-observations title="Permanent link">¤</a></h5> <p>To additionally produce Findings, information about the controls associated with each rule-name is required. The control information can be part of the source data itself or can be provided as one or more supplemental metadata files.</p> <p>If each instance of source data includes:</p> <ul> <li>inventory-name: cmp-wn-2115.demo.tanium.local</li> <li>rule-name: xccdf_org.cisecurity.benchmarks_rule_19.7.44.2.1_L2_Ensure_Prevent_Codec_Download_is_set_to_Enabled</li> <li>rule-result: fail</li> <li>control-name: 800-53: SC-18</li> </ul> <p>then the best mapping wound be to Findings with Observations.</p> <details> <summary>example snippet: xml instance suitable for mapping to Finding with Observation</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;IP Address&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;10.8.68.218&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Computer Name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cmp-wn-2115.demo.tanium.local&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Comply - JovalCM Results[c2dc8749]&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.5.0.1&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Profile&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10 - NIST 800-53&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_19.7.44.2.1_L2_Ensure_Prevent_Codec_Download_is_set_to_Enabled&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Result&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Custom ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: SC-18&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;version: 1&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;Count&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Age&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;600&quot;</span>
+<span class=p>}</span>
+</code></pre></div> </details> <details> <summary>example snippet: instance OSCAL Finding</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;findings&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;99c0a0de-e34e-4e22-95a1-1d4f24826565&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-03-16T13:29:14.000+00:00&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;objective-status&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;profile&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;NIST 800-53&quot;</span>
+<span class=w>          </span><span class=p>},</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;id-ref&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;IA-5&quot;</span>
+<span class=w>          </span><span class=p>},</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;STRVALUE&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;FAIL&quot;</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>],</span>
+<span class=w>        </span><span class=nt>&quot;status&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;not-satisfied&quot;</span>
+<span class=w>      </span><span class=p>},</span>
+<span class=w>      </span><span class=nt>&quot;related-observations&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;observation-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;61092735-e365-4638-bc2c-ecd0ed407e73&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;observation-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;95a20b8e-ed0a-4b6c-bf87-8789265c7158&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>]</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> </details> <details> <summary>example snippet: instance OSCAL Observation</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;observations&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;61092735-e365-4638-bc2c-ecd0ed407e73&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;benchmark&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;id&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;time&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;timestamp&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-03-16T13:29:14+00:00&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>],</span>
+<span class=w>      </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>      </span><span class=p>],</span>
+<span class=w>      </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2650b9ba-e767-4381-9a3f-127d1552d7d2&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>]</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> </details> <details> <summary>example snippet: local definitions</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;results&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;98028241-8705-4211-bf36-71e1f7aa6192&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;start&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-03-16T13:29:14.000+00:00&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;local-definitions&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;inventory-items&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2650b9ba-e767-4381-9a3f-127d1552d7d2&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;computer-name&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot; inventory-item&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cmp-wn-2106.demo.tanium.local&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;computer-ip&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot; inventory-item&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fe80::3cd5:564b:940e:49ab&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;profile&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot; inventory-item&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10&quot;</span>
+<span class=w>              </span><span class=p>}</span>
+<span class=w>            </span><span class=p>]</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>]</span>
+<span class=w>      </span><span class=p>}</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> </details> <h2 id=implement-mapping-strategy><em>Implement Mapping Strategy</em><a class=headerlink href=#implement-mapping-strategy title="Permanent link">¤</a></h2> <p>The best practice for building a transformer is to employ layers. Recall that the top two layers (in yellow) are for you to implement, while the bottom two layers (in green) are provided by trestle to assist you.</p> <p>Trestle is a Python based multi-faceted platform that simplifies this task by providing a set of Python classes which enforce adherence to the OSCAL schema, insuring that the produced OSCAL validates.</p> <ul> <li>file interfacing (read/write files)</li> <li>data processing (in-memory object structure construction)</li> <li>use of OSCAL versioned platform objects (trestle base and oscal functionality)</li> </ul> <h5 id=file-interfacing><em>File Interfacing</em><a class=headerlink href=#file-interfacing title="Permanent link">¤</a></h5> <p>Write a command line tool, for example a trestle task or auditree-arboretum <a href=https://github.com/ComplianceAsCode/auditree-harvest#report-development>harvest</a> report that:</p> <ul> <li>imports the commensurate data processing module</li> <li>reads the input</li> <li>send input to data processing module</li> <li>receives transformed data from data processing module</li> <li>writes the output</li> </ul> <h5 id=data-processing><em>Data Processing</em><a class=headerlink href=#data-processing title="Permanent link">¤</a></h5> <p>Write a data processing module that receives data, and optionally metadata, for transformation from native form into OSCAL. Separation from the command line file read/write mechanism allows for module re-use.</p> <p>The module should:</p> <ul> <li>import the trestle oscal module</li> <li>receive input data to be transformed</li> <li>receive metadata, optionally</li> <li>transform input into trestle oscal classes hierarchy</li> <li>send transformed OSCAL data in return</li> </ul> <p>For the Observation only case, the transform is straight forward. Code should create one Observation for each rule/result pair.</p> <p>For the Findings case, a bit more logic is required. Code should accumulate Observations for each Finding and determine an overall status for it. For example, if 15 Observations are found for Finding control AC-3, where 14 have result=PASS and 1 has result=FAIL, then the overall status for the Finding would be <code>not satisfied</code> with overall result=FAIL.</p> <h2 id=examples><em>Examples</em><a class=headerlink href=#examples title="Permanent link">¤</a></h2> <p>There are 2 transformers in trestle. The <a href=https://github.com/oscal-compass/compliance-trestle/blob/develop/trestle/tasks/xccdf_result_to_oscal_ar.py>xccdf-result-to-oscal-ar</a> transformer emits OSCAL Observations, the simplest partial result.</p> <p>The <a href=https://github.com/oscal-compass/compliance-trestle/blob/develop/trestle/tasks/tanium_result_to_oscal_ar.py>tanium-result-to-oscal-ar</a> transformer emits OSCAL Findings, a more complex partial result.</p> <p>Table of approximate lines of code.</p> <table> <tr> <th style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;background-color: #f1f1c1;">task-name <th style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;background-color: #f1f1c1;">OSCAL type <th style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;background-color: #f1f1c1;">file interface <th style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;background-color: #f1f1c1;">data processing <th style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;background-color: #f1f1c1;">test cases <tr> <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">xccdf-result-to-oscal-ar <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">Observations only <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">275 <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">350 <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">400 <tr> <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">tanum-to-oscal <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">Findings, with Observations <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">200 <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">350 <td style="text-align:right;border: 1px solid black;border-collapse: collapse;padding: 15px;">300 </table> <h2 id=contributing><em>Contributing</em><a class=headerlink href=#contributing title="Permanent link">¤</a></h2> <p>Consider contributing your transformer to <a href=../../../contributing/ >trestle</a> or <a href=https://github.com/ComplianceAsCode/auditree-arboretum/blob/main/CONTRIBUTING.md>auditree-arboretum</a> or other appropriate open source repository.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">September 11, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/Transformers_and_Tasks/transformer_construction/transformer-construction.drawio b/latest/tutorials/Transformers_and_Tasks/transformer_construction/transformer-construction.drawio
new file mode 100644
index 000000000..af08e01e4
--- /dev/null
+++ b/latest/tutorials/Transformers_and_Tasks/transformer_construction/transformer-construction.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-03-15T15:16:15.496Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/13.9.9 Chrome/85.0.4183.121 Electron/10.1.5 Safari/537.36" etag="8xrmJZzOWGcl91b7WN-Q" version="13.9.9" type="device"><diagram id="v_407LseDMD1wecu3-XY" name="Page-1">7VjbcuI4EP0aHrMl2/jCI5AwmVqmkhlmd5N92RKWMFpkyyvLBObrt23L+BrCpGCSqpkqHqxWS7b6nD7dYmBNw90HieP1J0EoH5iI7AbW9cA0jaFpDrIfIvvC4npWYQgkI9qpMizYN6qNSFtTRmjScFRCcMXiptEXUUR91bBhKcVT020lePOtMQ5ox7DwMe9a/2JErQurZ6PKfktZsC7fbCA9E+LSWRuSNSbiqWaybgbWVAqhiqdwN6U8C14Zl2Ld7JnZw4dJGqlTFoh/NrPbTwv1cP/nDE2//PH4+ffNlaG3SdS+PDElEAA9FFKtRSAizG8q60SKNCI02xbBqPKZCxGD0QDjv1SpvUYTp0qAaa1CrmfpjqmH2vNjttVvth5d7/TO+WBfDiIl9w+VYzZ8rM9Vy/JRY909lSykikptXDHOp4ILmR/ZMpbYoADIJFFSbGhtBiHnZgwRnXSjXUZOpNLXoZutmUcmk601+dsyr3aTz7f/3V6NNGuxDKg64mdrxyz+tTdoMD9QAQeQe3CQlGPFtk2CYs3z4OBXUQEeNBv6mXHss7eYp/pNXyVNFBDARF8ljpKVkCE8T0UY4ojAEyR/mk23+NRky9OaKbqIcR6yJ9CMJjNawKxWK9P3+4AhztKxHZgJJCYMQGmsIiMnm1uJSGkSGugYiFsqFd0djXo5O9LprPXMLJXgqVIHC+ngrWvKUMrA2YEynA5SM5bD9DECxq+yUJtojvfAftPBYRbxaJnEh3jUsIIgqCYgzcBHIqItlLQJcxZEMJTFiSdZRBnI6FjbQ0ZILh59BGhS5BwouSASL8FkuGbp9WOAcjtAXWOFwXIvhU+ThEXBL6RM9x0g1RU/kLmYMxxlyeTwLG7LDKQgeyIFiroSdOop59CsZAGFDiDOjD4XKfl+LcRkROw+LcR0aFjmefAYNuXN6gGjTKU6FKNLQWF3obhbTMfzLgp3y4TKLVRGEXUnhezaZiwikHLJad7jJIEUDbPImugLTVKukg7WB4T3HDan0noZ5WWRUfPlwYD9TZDn2V2qYBta5rcuZHaXGkuDkBXqo4aBXGtEW6XQOA9VbLuZuVYPWbyetD0Q6Oxkce237GarDvaxNvNMNwuDdlP62g63RQbiIQC9jwxjG6HhUd1+sZl1rBO72ffVzJafXVMRqIZXzyiJ1vNMBRDdwv2zV/W58DdZoX4fEnBCdbhAN3wowVoCjL56gXrqhXsGCei90FpvoQDfn4GVZnhuXTVevAX36Mbrs9k49W5a5s/50lkvvRcsL6iaT47X4pPX4klxJL2q/mdHa6Nhp680nNZWxaE7W+WsO5zo9UTs3sr6789zETD/p7099zT7F7s998LUvZNVMOnygBZpHIMqXAYkYlOPDPtA8syl5TwD0sglyHV/EEijtwbp2H9RE5zQ/Nvg0+DgexKBAPk/GUSWcTmIYFj9SV2oY/VXv3XzPw==</diagram></mxfile>
\ No newline at end of file
diff --git a/latest/tutorials/Transformers_and_Tasks/transformer_construction/transformer-construction.jpg b/latest/tutorials/Transformers_and_Tasks/transformer_construction/transformer-construction.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..d29bb167f67610e96b8613f8a1b04d7c4209a174
GIT binary patch
literal 28213
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

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/complex_resolved_profile_catalog.drawio b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/complex_resolved_profile_catalog.drawio
new file mode 100644
index 000000000..b2613c2ee
--- /dev/null
+++ b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/complex_resolved_profile_catalog.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-10-13T02:25:25.123Z" agent="5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/15.4.0 Chrome/91.0.4472.164 Electron/13.5.0 Safari/537.36" etag="J0KnrX6GA98koCQSKY7p" version="15.4.0" type="device"><diagram id="0IL5Hela0vqbwbp7OC4j" name="Page-1">7Vtbc9o6EP41PB7GVwKPCUnTziHTTPPQZ8UWoBPZYmRx66/vypYwjsAxCa5JjxhmsNcrWdpvV/q0Ej1/nGzuOVrMH1iMac9z4k3Pv+15nusMh/AjJdtCMhoowYyTWCmVgifyC+uSSrokMc4qioIxKsiiKoxYmuJIVGSIc7auqk0Zrb51gWbYEDxFiJrSnyQW80I6DJ1S/hWT2Vy/2XXUkwRpZSXI5ihm6z2Rf9fzx5wxUVwlmzGm0njaLkW5L0ee7hrGcSqaFPj+9frlG1l+D1f3wd3tvw/ROLj+R9WyQnSpOvwtWTAuVJPFVtsBx2AWdQvP52zGUkTvSukNZ8s0xvJlDtyVOhPGFiB0QfgfFmKrMEZLwUA0FwlVT4t3yhcd7aESZWzJI1zTLU95CuIzLGr0rnY4gANjlmDBt1COY4oEWVXbgZQnzXZ6pbHhQtn7BNt7hu3HSCDKZobxszVJKEqllacsFRoHaedoTmg8QVu2lP3MBIpe9N3NnHHyC/SRtjA85kLZ33cqGk+ypKqT4wx0HrXd3VeiB7SpKE5QJnRrGKVokZHnvH2yYAIQkPSGCcESpTQllI4ZZTzvnB8jPJxGees4e8H6SYynaEnFzi9WmAu8qfcME0lVwPNVEKpRKNTDy7qMaTdQsvl+POvoPTv6vok+AMGZLOgaHgBdFzUm2jdpynJHQZTMUrileCo1pPkIDGvXSpyQOM7DNlugiKSzSa52G5SSH8oKUsSg+JTmo9ccCmKo4WbBSCpyq4Q38AU7jZ1+2AuhuWO4d8t7+Ep1LqCH0ANEctAwuM0aS9eBoUOA5z/vnLoR4sdjynQDBbvfEHW/LdCDGtBDC3oroA+6Bj2sAf2qGegKXot4I8RHXSM++OT06aohfXKPzLp/hj9dGXH1yBmECP7L+VN1aAAG5eQfk1lNhxGOovMwqCD0L41BDU38EUdJc/5kR9VGq6FLIU+jo3h7ljq1Annn1EkPMnuYX8dylvSc+yWJUQrTmEzq8J4Hc67vFmNoTq4yOwac3yE6Z1aumbD6gTNGV7lPyPm/D79jJPqWBBTyOMTDODgPCRgMqmmUoKk/uIPWHOJAFu3UPIodA5rR+kshAm5d7symUVqCvXsyUJc9G9lQbwHz7ud7M3lmAE1JDmABtN6kc6vJkXzGL+Zsr1WL7Za7b06JrZlsYDnzRQWR2/2EaaaZP1dC0h0dtnDjRKMq+ijdZy+pFVT5bDgY9Ud7n2G1wiIfqup4BcmuUR9AyUxo1WzGT9AzplWD6+iLwL6Y18VfvubY8/1qWN1WB0yg2DXRoQ5eqMp6u+MOb0fNkaWmqt7pu26gZvz3wqxV2HSa4XYwM5NSdhP/8Lq00fh62jb+IGg62baWhNYVf2QtYufTZqP9paw/PTMJdfKOrl1/ngp75+tPvfSw688/hnnn60/PTDX9HQckFbN6c4vf+yjz/pj5D6R8LL1qi17pBYieZ4fds6u6s1M2u/++s1PBhbMrM39VYm5m/yy7Ogvs3bMr8zhXCbtvQ70FzLtnVydlvD4Ru/o/pCu9A+ex7PnLts5fvk59XQA50y2yBzDPNl5feOLLNxNf9ghmy6B3Tsx8M+1l7ifbaD878J2zM//QMatkQaGfnlOeuhzk4fzM4Womr3YkwDmWqlHe0dLOpWR2mdq5PMEH33VC5I3jkq/m7MA5AOnwAKTh6ZDCbflX8oLilX/I9+9+Aw==</diagram></mxfile>
\ No newline at end of file
diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/complex_resolved_profile_catalog.png b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/complex_resolved_profile_catalog.png
new file mode 100644
index 0000000000000000000000000000000000000000..56ce9a696f12451975e2556ef47f89f0d099b489
GIT binary patch
literal 9520
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
SOMPp1Nwr(r%EdP=0{$O7<dQ@H

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/index.html b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/index.html
new file mode 100644
index 000000000..ef2dbc8e9
--- /dev/null
+++ b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/index.html
@@ -0,0 +1,688 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Documentation for compliance-trestle package."><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ rel=canonical><link href=../../Transformers_and_Tasks/transformer_construction/ rel=prev><link href=../trestle_author/ rel=next><link rel=icon href=../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring - Compliance Trestle</title><link rel=stylesheet href=../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring - Compliance Trestle"><meta property=og:description content="Documentation for compliance-trestle package."><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Trestle_authoring/ssp_profile_catalog_authoring.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring - Compliance Trestle"><meta name=twitter:description content="Documentation for compliance-trestle package."><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Trestle_authoring/ssp_profile_catalog_authoring.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#tutorial-catalog-profile-componentdefinition-and-ssp-authoring class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5 checked> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=true> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#introduction-and-background class=md-nav__link> <span class=md-ellipsis> Introduction and background </span> </a> </li> <li class=md-nav__item> <a href=#the-author-commands-for-markdown-generation-and-assembly-to-json class=md-nav__link> <span class=md-ellipsis> The author commands for markdown generation and assembly (to JSON) </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#introduction-and-background class=md-nav__link> <span class=md-ellipsis> Introduction and background </span> </a> </li> <li class=md-nav__item> <a href=#the-author-commands-for-markdown-generation-and-assembly-to-json class=md-nav__link> <span class=md-ellipsis> The author commands for markdown generation and assembly (to JSON) </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=tutorial-catalog-profile-componentdefinition-and-ssp-authoring>Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring<a class=headerlink href=#tutorial-catalog-profile-componentdefinition-and-ssp-authoring title="Permanent link">¤</a></h1> <h2 id=introduction-and-background>Introduction and background<a class=headerlink href=#introduction-and-background title="Permanent link">¤</a></h2> <p>In addition to core functionality for automated processing of OSCAL documents, Trestle has authoring tools that allow conversion of OSCAL documents to markdown for easy editing - and conversion back to OSCAL for validation and automation. A big part of compliance involves writing guidance prose associated with controls, along with the setting of parameters and properties for those controls. This cannot be completely automated because it requires human editing, along with human approvals of those edits. The purpose of the authoring tools is to allow selected edits of oscal documents guided by prompts for where content is required. This serves to streamline the edit/approval process whereby the author is presented with one markdown document per control, and it provides a view of the the key information needed during the editing process. This greatly simplifies the editing process compared to multiple authors working together on a single large JSON document.</p> <p>The key modes of authoring are <em>-generate</em> and <em>-assemble</em>. During <em>-generate</em> a JSON document is converted to markdown format, allowing authors to add or edit prose and parameter values. After editing, the markdown can then be <em>-assemble</em>d into the same or a new JSON document that captures the edit changes. In a normal authoring cycle, the markdown is generated for the first time from a given JSON file, and after that there is a continuous process of editing and reassembling to keep the JSON up to date with the markdown edits.</p> <p>A third mode of authoring is <em>-filter</em>, where parts of a document are removed. This allows one large master document to be represented in simpler ways with, e.g. proprietary prose culled in form intended for consumption outside a company.</p> <details> <summary>Integration with git and CI/CD</summary> <p>The command line interface in Trestle makes a powerful combination with git and CI/CD environments (Continuous Integration, Continuous Delivery or Deployment) when the trestle commands are performed via github actions or equivalent. This allows different classes of users based on 1) their access to the repository 2) the changes to documents they are allowed to commit, and 3) the changes they can make to actions that are triggered by a commit. As an example, a command line option may limit the type of content added to a profile, and if disallowed changes are detected during commit - the commit will be rejected. This, in combination with having all controls as individual markdown files organized by groups in directories, makes management and tracking of author edits robust and automatically controlled by the built-in features of the respository.</p> <p>For an example of actions triggered by a commit, a change to a control in a catalog could generate a pull request that is approved by someone with appropriate authority, and when it is later merged it triggers notification downstream to authors of profiles that import that catalog.</p> </details> <details> <summary>The author commands</summary> <p>The author commands are:</p> <ol> <li><code>catalog-generate</code> converts a control Catalog to individual controls in markdown format for addition or editing of guidance prose and parameters, with parameters stored in a yaml header at the top of the markdown file. <code>catalog-assemble</code> then gathers the prose and parameters and updates the controls in the Catalog to make a new OSCAL Catalog.</li> <li><code>profile-generate</code> takes a given Profile and converts the controls represented by its resolved profile catalog to individual controls in markdown format, with sections corresponding to the content that the Profile adds to the Catalog, along with both the current values of parameters in the resolved profile catalog - and the values that are being modified by the given profile's SetParameters. The user may edit the content or add more, and <code>profile-assemble</code> then gathers the updated content and creates a new OSCAL Profile that includes those changes.</li> <li><code>profile-resolve</code> is special as an authoring tool because it does not involve markdown and instead it simply creates a JSON resolved profile catalog from a specified JSON profile in the trestle directory. There are options to specify whether or not parameters get replace in the control prose or not, along with any special brackets that might be desired to indicate the parameters embedded in the prose.</li> <li><code>profile-inherit</code> takes a given parent profile and filters its contents based on the inherited controls included in a given ssp to be include in the final profile.</li> <li><code>component-generate</code> takes a given ComponentDefinition file and represents all the controls in markdown in separate directories for each Component in the file. This allows editing of the prose on a per-component basis. <code>component-assemble</code> then assembles the markdown for all controls in all component directories into a new, or the same, ComponentDefinition file.</li> <li><code>ssp-generate</code> takes a given Profile and an optional list of component-definitions, and represents the individual controls as markdown files with sections that prompt for prose regarding the implementation response for items in the statement of the control, with separate response sections for each component. <code>ssp-assemble</code> then gathers the response sections and creates an OSCAL System Security Plan comprising the resolved profile catalog and the implementation responses for each component. The list of component-definitions is optional, but without them the SSP will only have one component: <code>This System</code>. Rules, parameters and status associated with the implemented requirements are stored in the SetParameters and Properties of the components in the component definitions and represented in the markdown, allowing changes to be made to the parameter values and status. These edits are then included in the assembled SSP. Note that the rules themselves may not be edited and strictly correspond to what is in the component definitions.</li> <li><code>ssp-filter</code> takes a given ssp and filters its contents based on the controls included in a provided profile, or in a list of components to be included in the final ssp.</li> </ol> <p>In summary, the <code>catalog</code> tools allow conversion of a Catalog to markdown for editing - and back again to a Catalog. The <code>profile</code> tools similarly convert a Profile's resolved profile catalog to markdown and allow conversion to a new Profile with modified additions that get applied in resolving the profile catalog. <code>component</code> tools perform similarly for ComponentDefinitions. Finally, the <code>ssp</code> tools allow the addition of implementation prose to the markdown of a system security plan, which is then assembled into a JSON SSP on a by-component basis.</p> <p>Note that the original ssp implementation in trestle created SSP's by adding prose directly to the SSP markdown on a per-component basis, and there was no connection with separate ComponentDefinition JSON files. This is now changed so that control responses can be added to the ComponentDefinition and then merged to create the SSP markdown. In addition, rules and status are captured in the component definition as properties that propogate via markdown into the assembled SSP. The OSCAL schema doesn't include a form of implementation status for components in the component definition, which is why trestle embeds the status value in the properties. Similarly, rules and rule parameter values are not currently part of the schema, so they are also embedded in properties.</p> </details> <details> <summary>Some details of the author commands</summary> <p>The markdown files for controls usually have a YAML header at the top containing metadata about the control. Sometimes that information is read-only and intended as additional information useful during markdown editing, but in other cases the content may be edited and incorporated as new values for the control after <code>-assemble</code>. In addition, most <code>-generate</code> commands allow specifying a separate YAML header file containing information either needed by the command, or intended to be incorporated into the header of each control markdown file. When generating markdown a YAML header may be optionally provided, and if so, the option <code>--overwrite-header-values</code> will cause the values in the provided YAML header to overwrite the value in the markdown file's header for any items that are common. Otherwise the provided YAML header will simply insert any values not already in the markdown header. By default, Trestle will preserve the history of the changes in generated markdowns, however <code>--force-overwrite</code> option can be used to overwrite markdowns with content from JSON. Note that this option will completely delete all existing markdowns (in the given <code>output</code> folder) without saving any changes. To save the changes, run assemble first. Similarly, when assembling to JSON, the <code>--set-parameters</code> option will cause any changes in the header to take effect and change values in the assembled JSON for the control. The changes can including setting parameter and property values. The <code>--set-parameters</code> option is available only for <code>catalog-assemble</code> and <code>profile-assemble</code>.</p> <p>As described earlier, the authoring tools are designed to work well in a CI/CD environment where changes are made in a pipeline by people with different responsibilities and authority. In this setting, changes to documents can trigger changes downstream, e.g. the editing of a control would cause an update in the catalog, which could then flow down to an updated SSP. These changes can occur automatically via actions that restrict the potential changes to the generated documents. Examples are the <code>--set-parameters</code> option on the <code>-assemble</code> tools, and both <code>--required-sections</code> and <code>allowed-sections</code> for <code>profile-assemble</code>. If a document change triggers an assemble action, changes to parameters can only occur if the action has <code>--set-parameters</code> in the command. Similarly, <code>profile-assemble</code> will fail if the sections do not meet the requirements specified in the command options. Another feature of the <code>-assemble</code> tools is that they won't create a new OSCAL file if the output already exists and its content would not be changed. This prevents undesired triggering of downstream actions when there is no actual change in content.</p> <p>There is a standalone demonstration of the SSP generation process with trestle in the <a href=https://github.com/oscal-compass/compliance-trestle-ssp-demo>Trestle SSP Demo</a> that captures the entire process of SSP authoring: from creation of a component definition from CSV file to a final formatted system security plan in Word (.docx) format.</p> </details> <details> <summary>Background on underlying concepts</summary> <p>In order to understand the specific operations handled by these commands, it is helpful to clarify some of the underlying OSCAL structures and how they can be edited in markdown form. This tutorial should be viewed in the context of the extensive documentation provided by <a href=https://pages.nist.gov/OSCAL>OSCAL</a>.</p> <p>First, a <em>Catalog</em> is a collection of <em>Controls</em>, and a <em>Profile</em> imports controls and allows modification and additions to the controls, but it does not create new controls. A Profile has one or more <em>Imports</em> that refer either to an actual Catalog, or another Profile that itself is importing from a Catalog or Profile. The profiles can import controls selectively from each source and make additions or modifications to properties of the controls. The final collection of selected and modified controls represents the profile's <em>resolved profile catalog</em>.</p> <p>For clarity, here is a simple depicton of a catalog as a collection of controls:</p> <p><img alt="Simple catalog" src=simple_catalog.png></p> <p>Here is a profile pulling controls from a catalog to make a resolved profile catalog:</p> <p><img alt="Resolved profile catalog" src=resolved_profile_catalog.png></p> <p>And here is a more complex situation where a single profile pulls controls from catalogs and profiles:</p> <p><img alt="Complex resolved profile catalog" src=complex_resolved_profile_catalog.png></p> <p>From the diagram it's clear that the profile is performing many tasks under the covers. This is shown in an expanded view of a profile:</p> <p><img alt="What a profile does" src=profile_does.png></p> <p>It's important to note that each profile is importing a selection of controls from each source, then making its own <em>suggested</em> modifications to parameters and other content in those controls. They are suggested in the sense that downstream profiles may override those settings - with priority given to the later profiles in the pipeline. The changes made by upstream profiles may be accepted, or overridden by better choices for a given need. This way the catalogs themselves can remain relatively static, and individual use cases can effectively create a custom catalog based on the original controls plus modifications by other static profiles, and/or the user's custom profile. The authoring tools here provide ways to make those modifications, both to the catalog controls and to the profiles, and to enter the implementation responses that are needed in a System Security Plan.</p> <p>The tools are designed to be used in a continuous <code>generate-edit-assemble</code> cycle, with previous edits retained in each cycle. Each new edit phase can add or modify the current content, allowing a new <code>generate</code> of an OSCAL json document capturing those edits.</p> <p>NOTE: We use <code>json</code> format for specifying OSCAL files in this tutorial, but it is equally applicable to <code>yaml</code> format also.</p> </details> <h2 id=the-author-commands-for-markdown-generation-and-assembly-to-json>The author commands for markdown generation and assembly (to JSON)<a class=headerlink href=#the-author-commands-for-markdown-generation-and-assembly-to-json title="Permanent link">¤</a></h2> <details> <summary>trestle author catalog-generate and trestle author catalog-assemble</summary> <p><code>catalog-generate</code> takes an existing json catalog and writes it out as markdown files for each control in a user-specified directory. That directory will contain subdirectories for each group in the catalog, and those directories may contain subdirectories for groups within groups. But controls containing controls are always split out into a series of controls in the same directory - and each control markdown file corresponds to a single control.</p> <p>We now look at the contents of a typical control markdown file.</p> <p>A Control may contain many parts, but only one of them is a Statement, which describes the function of the control. The statement itself is broken down into separate items, each of which may contain parameter id's in "moustache" (<code>{{}}</code>) brackets. Below is an example of a control as generated in markdown form by the <code>catalog-generate</code> command.</p> <details> <summary>Control example</summary> <div class=highlight><pre><span></span><code>---
+x-trestle-set-params:
+  ac-1_prm_1:
+    values:
+<span class=w>      </span><span class=k>-</span><span class=w> </span>new value
+  ac-1_prm_2:
+    values:
+  ac-1_prm_3:
+    values:
+<span class=w>      </span><span class=k>-</span><span class=w> </span>added param 3 value
+  ac-1_prm_4:
+    values:
+  ac-1_prm_5:
+    values:
+  ac-1_prm_6:
+    values:
+  ac-1_prm_7:
+    values:
+x-trestle-global:
+<span class=gu>  sort-id: ac-01</span>
+<span class=gu>---</span>
+
+<span class=gh># ac-1 - \[Access Control\] Policy and Procedures</span>
+
+<span class=gu>## Control Statement</span>
+
+<span class=k>-</span><span class=w> </span>\[a.\] Develop, document, and disseminate to {{ insert: param, ac-1_prm_1 }}:
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[1.\]  {{ insert: param, ac-1_prm_2 }} access control policy that:
+
+<span class=w>    </span><span class=k>-</span><span class=w> </span>\[(a)\] Addresses purpose, scope, roles, responsibilities, management commitment, coordination among organizational entities, and compliance; and
+<span class=w>    </span><span class=k>-</span><span class=w> </span>\[(b)\] Is consistent with applicable laws, executive orders, directives, regulations, policies, standards, and guidelines; and
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[2.\] Procedures to facilitate the implementation of the access control policy and the associated access controls;
+
+<span class=k>-</span><span class=w> </span>\[b.\] Designate an {{ insert: param, ac-1_prm_3 }} to manage the development, documentation, and dissemination of the access control policy and procedures; and
+
+<span class=k>-</span><span class=w> </span>\[c.\] Review and update the current access control:
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[1.\] Policy {{ insert: param, ac-1_prm_4 }} and following {{ insert: param, ac-1_prm_5 }}; and
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[2.\] Procedures {{ insert: param, ac-1_prm_6 }} and following {{ insert: param, ac-1_prm_7 }}.
+<span class=k>-</span><span class=w> </span>\[d\] My added item
+
+<span class=gu>## Control guidance</span>
+
+Access control policy and procedures address the controls in the AC family that are implemented within systems and organizations. The risk management strategy is an important factor in establishing such policies and procedures. 
+</code></pre></div> </details> <p>The control markdown files rely on brackets around key items that are important in defining the control's properties and structure. <code>\[Access Control\]</code> at the top indicates the title of the group containing the control. The name of the control is already known from the name of the markdown file (<code>ac-1.md</code>) and the name of the group is already known from the name of the directory containing the group's controls (<code>ac</code>) - but the group title must be indicated in the control in a special manner, hence the brackets. The text following the group title is the title of the control itself. All controls in a group should have the same group title or a warning will be indicated in certain trestle operations.</p> <p>In addition, each part label corresponds to the label used in the OSCAL structure for the control statement, and so must be maintained in a special manner - hence the need for brackets on <code>\[(a)\]</code>.</p> <p>The items in moustaches (<code>{{}}</code>) correspond to the original prose from the control description. The moustaches represent places to substitue parameter values, but no substitutions are ever made until the final SSP generation. The authoring process provides multiple ways to set and change the final parameter values, as described below.</p> <p><code>catalog-generate</code> is run with the command <code>trestle author catalog-generate --name catalog_name --output markdown_dir</code>, where <code>catalog_name</code> is the name of a catalog already loaded into the trestle workspace, and <code>markdown_dir</code> is the directory into which the markdown files for the controls will be written. A separate directory is created for each group in the catalog.</p> <p>A user then may edit the control statement for the control and add or change the contents. In this case an added item, <code>My added item</code> is shown as item <code>d</code>. You can then assemble the edited controls into a new catalog with the command <code>trestle author catalog-assemble --markdown markdown_dir --output new_catalog</code>. This will load the updated control statements for each control into a new json or yaml catalog named <code>new_catalog</code>.</p> <p>As with profile and ssp generation described below, a yaml header may be provided with the <code>--yaml</code> option that is inserted into the top of each control file. If a control file already exists, as is expected in a continuous cycle of generate-edit-assemble, then the provided header will be merged with the existing header in each control. If a given item in the header is already present in the control, by default the values in the markdown header will be given priority, though this can be overridden by the <code>--overwrite-header-values</code> option, which will give priority to any values coming from the provided yaml header. In all cases, values in the yaml header not already present in the markdown header will be inserted.</p> <p>In the control markdown example above, the header contains some arbitrary values along with a special <code>x-trestle-set-params</code> section containing parameters for some of the parameters in the control. Any parameters for the control in the catalog will appear in the markdown header automatically during <code>catalog-generate</code>. These values may be changed and values for other parameters may be inserted into the markdown header for later use during <code>catalog-assemble</code>.</p> <p>Parameters in the header are shown with a subset of their full OSCAL attributes in order to convey any values they may have along with descriptive text. This amounts to the parameter id, its label if present, any values if present, and any select if present. When a select is present the list of choices is provided along with the how-many option. Note that values is a list in OSCAL, but in many cases it is a list of only one item. As a result, for convenience the values: dictionary may either have one string value (on the same line with <code>values:</code>) or as an indented <code>-</code> list of multiple values underneath <code>values:</code>. Multiple examples are evident in the sample above, including ac-1_prm_3, which only has a label and no values.</p> <p>Another important item in the header is the sort-id for the control. This specifies how the controls and their parameters are ordered in any aggregated list operation. If it is not specified for a control, the control's id is used for sorting.</p> <p>As with the other -generate tools, the <code>--force-overwrite</code> option will cause the destination markdown directory to be erased prior to generating the new markdown, so that any prior edits to the markdown will be erased.</p> <p><code>catalog-assemble</code> is run with the command <code>catalog-assemble --markdown my_md --output my_new_catalog</code>. This will read the markdown for each control and create a new catalog based on any edits to the markdown. Note that you may optionally provide a <code>--name</code> option specifying an original json catalog into which the updated controls are inserted, and the resulting catalog can either replace the original one or output to a different json file. New controls may be added but existing controls may not be removed and new groups cannot be added when you are updating an existing catalog. The main benefit of updating an existing catalog is that the original metadata and other contents of the catalog json file will be retained. Note that you cannot create new controls that contain controls, but if an original json catalog contains controls with child controls, you can edit and update all of them as individual markdown files. You have the option to specify a new <code>--version</code> for the catalog, and an option to regenerate the uuid's in the catalog. Finally, you have the option to use the parameters in the markdown header to update the values in the control. Any parameters and their values present will be added to the control, and any not present will be removed. The parameters themselves are still present but their values are removed.</p> <p>In a typical <code>generate-edit-assemble</code> cycle, the cycle would start with an original json file containing source content and metadata and use that to generate an initial markdown directory of controls. After editing the controls they would be assembled into into a new json file with a different name. But once that new file exists, it can be used as the source for the next generation and the original source document is no longer needed or referred to. For the <code>catalog-</code> editing cycle it would go as:</p> <div class=highlight><pre><span></span><code>trestle author catalog-generate --name orig_catalog --output md_catalog
+[user edits the markdown files]
+trestle author catalog-assemble --name orig_catalog --markdown md_catalog --output assembled_catalog
+[user makes additional markdown edits]
+trestle author catalog-assemble --markdown md_catalog --output assembled_catalog
+</code></pre></div> <p>The key point here is that the first <code>-assemble</code> needs to use the original catalog for its metadata, backmatter and other items not captured in the markdown controls. But once the output catalog has been created, by default it will be used as the "original" or "parent" catalog into which changes will be incorporated, unless a different source catalog is specified via <code>--name</code>.</p> <p>Note that <code>catalog-assemble</code> can instantiate a catalog anew from a manually created directory of markdown controls in directories corresponding to groups, but the metadata in the assembled json catalog will contain many <code>REPLACE_ME</code> items that would need to be manually edited in the json file itself. The trestle <code>split</code> and <code>merge</code> tools may help in that case. Once the changes have been made they will be retained if a new <code>catalog-assemble</code> happens with that same output file as the target.</p> <p><em>Special Note about assemble</em>: In order to avoid triggering actions when a new file is created that has no actual changes in it, <code>catalog-assemble</code> and the other <code>-assemble</code> tools below will check to see if the output file already exists, and if so it will be examined for changes relative to the newly assembled one. If there are no changes the file will not be written out. Note that the check happens <em>before</em> any possible <code>--regeneration</code> of uuid's, and <em>after</em> any possible <code>--version</code> change. This avoids the creation of a new file and new uuid's if there is no change to the version or other file contents relative to the existing output file, but if the specified <code>--version</code> is different from the one in the existing output file, or there is any other difference in the model, a new file will be written out.</p> </details> <details> <summary>trestle author profile-generate and trestle author profile-assemble</summary> <p>The background text above conveys how a profile pulls controls from catalogs and makes modifications to them, and the <code>trestle profile</code> tools let you change the way those modifications are made. In addition to selecting controls and setting parameters, a profile may add new parts to a control that provide additional guidance specific to a certain use case. <code>profile-generate</code> is run with the command, <code>trestle author profile-generate --name profile_name --output markdown_dir</code>. It will load the specified profile name from the trestle workspace (it must have been imported into the trestle workspace prior) and create its corresponding resolved profile catalog - but <em>without</em> applying any of its <code>Adds</code> of additonal guidance content or <code>SetParameters</code>. It will make all other modifications, but the <code>Adds</code> and <code>SetParameters</code> are kept separate, as shown below:</p> <details> <summary>Example of control markdown after `profile-generate`</summary> <div class=highlight><pre><span></span><code>---
+x-trestle-set-params:
+  # You may set values for parameters in the assembled Profile by adding
+  #
+  # profile-values:
+  #   - value 1
+  #   - value 2
+  #
+  # in the section under a parameter name
+  # The values list refers to the values in the catalog, and the profile-values represent values
+  # in SetParameters of the Profile.
+  #
+  ac-1_prm_1:
+    label: label from edit
+    profile-values:
+<span class=w>      </span><span class=k>-</span><span class=w> </span>all personnel
+    values:
+<span class=w>      </span><span class=k>-</span><span class=w> </span>Param_1_value_in_catalog
+    display-name: Pretty ac-1 prm 1
+  ac-1_prm_2:
+    profile-values:
+<span class=w>      </span><span class=k>-</span><span class=w> </span>Organization-level
+<span class=w>      </span><span class=k>-</span><span class=w> </span>System-level
+    values:
+    display-name: Pretty ac-1 prm 2
+  ac-1_prm_3:
+    profile-values:
+<span class=w>      </span><span class=k>-</span><span class=w> </span>new value
+    values:
+  ac-1_prm_4:
+    profile-values:
+    values:
+  ac-1_prm_5:
+    profile-values:
+<span class=w>      </span><span class=k>-</span><span class=w> </span>all meetings
+    values:
+  ac-1_prm_6:
+    profile-values:
+<span class=w>      </span><span class=k>-</span><span class=w> </span>monthly
+    values:
+  ac-1_prm_7:
+    values:
+x-trestle-global:
+  profile:
+    title: Trestle test profile
+  sort-id: ac-01
+x-trestle-sections:
+  guidance: Guidance
+  implgdn: Implementation Guidance
+  expevid: Expected Evidence
+  my_guidance: My Guidance
+  a_guidance: A Guidance
+  b_guidance: B Guidance
+  NeededExtra: Needed Extra
+  a_subpart: A Subpart
+  a_subsubpart: A Subsubpart
+  b_subpart: B Subpart
+  a<span class=ge>_by_</span>id_subpart: a by_id subpart
+x-trestle-add-props:
+  # Add or modify control properties here
+  # Properties may be at the control or part level
+  # Add control level properties like this:
+  #   - name: ac1_new_prop
+  #     value: new property value
+  #
+  # Add properties to a statement part like this, where &quot;b.&quot; is the label of the target statement part
+  #   - name: ac1_new_prop
+  #     value: new property value
+  #     smt-part: b.
+  #
+<span class=w>  </span><span class=k>-</span><span class=w> </span>name: prop_with_ns
+    value: prop with ns
+    ns: https://my_new_namespace
+<span class=w>  </span><span class=k>-</span><span class=w> </span>name: prop_with_no_ns
+    value: prop with no ns
+<span class=gu>    ns: https://my_added_namespace</span>
+<span class=gu>---</span>
+
+---
+
+<span class=gh># ac-1 - \[Access Control\] Policy and Procedures</span>
+
+<span class=gu>## Control Statement</span>
+
+<span class=k>-</span><span class=w> </span>\[a.\] Develop, document, and disseminate to {{ insert: param, ac-1_prm_1 }}:
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[1.\]  {{ insert: param, ac-1_prm_2 }} access control policy that:
+
+<span class=w>    </span><span class=k>-</span><span class=w> </span>\[(a)\] Addresses purpose, scope, roles, responsibilities, management commitment, coordination among organizational entities, and compliance; and
+<span class=w>    </span><span class=k>-</span><span class=w> </span>\[(b)\] Is consistent with applicable laws, executive orders, directives, regulations, policies, standards, and guidelines; and
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[2.\] Procedures to facilitate the implementation of the access control policy and the associated access controls;
+
+<span class=k>-</span><span class=w> </span>\[b.\] Designate an {{ insert: param, ac-1_prm_3 }} to manage the development, documentation, and dissemination of the access control policy and procedures; and
+
+<span class=k>-</span><span class=w> </span>\[c.\] Review and update the current access control:
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[1.\] Policy {{ insert: param, ac-1_prm_4 }} and following {{ insert: param, ac-1_prm_5 }}; and
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[2.\] Procedures {{ insert: param, ac-1_prm_6 }} and following {{ insert: param, ac-1_prm_7 }}.
+
+<span class=gu>## Control guidance</span>
+
+Access control policy and procedures address the controls in the AC family that are implemented within systems and organizations. The risk management strategy is an important factor in establishing such policies and procedures. Policies and procedures contribute to security and privacy assurance. Therefore, it is important that security and privacy programs collaborate on the development of access control policy and procedures. Security and privacy program policies and procedures at the organization level are preferable, in general, and may obviate the need for mission- or system-specific policies and procedures. The policy can be included as part of the general security and privacy policy or be represented by multiple policies reflecting the complex nature of organizations. Procedures can be established for security and privacy programs, for mission or business processes, and for systems, if needed. Procedures describe how the policies or controls are implemented and can be directed at the individual or role that is the object of the procedure. Procedures can be documented in system security and privacy plans or in one or more separate documents. Events that may precipitate an update to access control policy and procedures include assessment or audit findings, security incidents or breaches, or changes in laws, executive orders, directives, regulations, policies, standards, and guidelines. Simply restating controls does not constitute an organizational policy or procedure.
+
+<span class=gh># Editable Content</span>
+
+&lt;!-- Make additions and edits below --&gt;
+&lt;!-- The above represents the contents of the control as received by the profile, prior to additions. --&gt;
+&lt;!-- If the profile makes additions to the control, they will appear below. --&gt;
+&lt;!-- The above markdown may not be edited but you may edit the content below, and/or introduce new additions to be made by the profile. --&gt;
+&lt;!-- If there is a yaml header at the top, parameter values may be edited. Use --set-parameters to incorporate the changes during assembly. --&gt;
+&lt;!-- The content here will then replace what is in the profile for this control, after running profile-assemble. --&gt;
+&lt;!-- The added parts in the profile for this control are below.  You may edit them and/or add new ones. --&gt;
+&lt;!-- Each addition must have a heading either of the form ## Control my_addition_name --&gt;
+&lt;!-- or ## Part a. (where the a. refers to one of the control statement labels.) --&gt;
+&lt;!-- &quot;## Control&quot; parts are new parts added after the statement part. --&gt;
+&lt;!-- &quot;## Part&quot; parts are new subparts added into the existing top-level statement part with that label. --&gt;
+&lt;!-- Subparts may be added with nested hash levels of the form ### My Subpart Name --&gt;
+&lt;!-- underneath the parent ## Control or ## Part being added --&gt;
+&lt;!-- See https://oscal-compass.github.io/compliance-trestle/tutorials/ssp_profile_catalog_authoring/ssp_profile_catalog_authoring for guidance. --&gt;
+
+<span class=gu>## Control Implementation Guidance</span>
+
+Do it carefully.
+
+<span class=gu>## Control Expected Evidence</span>
+
+Detailed logs.
+
+<span class=gu>## Control Needed Extra</span>
+
+Add prose here for required Section: Needed Extra
+
+<span class=gu>## Control A Guidance</span>
+
+Control level guidance
+
+<span class=gu>### A Subpart</span>
+
+A subpart prose
+
+<span class=gu>#### A Subsubpart</span>
+
+A subsubpart prose
+
+<span class=gu>### B Subpart</span>
+
+B subpart prose
+
+<span class=gu>## Part a.</span>
+
+<span class=gu>### Subpart of top level Part a. of the control</span>
+
+Prose added as a sub-part to Part a. of the control
+</code></pre></div> </details> <p>In the above markdown example, the fixed, uneditable parts of the control are output first (after the header, which can be edited), followed by a separate section marked, <code>Editable Content</code>. And below the editable content are the individual <code>Adds</code> that the profile makes, with each one marked by a header of the form, <code>## Control guidance_name</code> or <code>## Part statement_part_label</code> followed by named subparts. You may edit the editable content and you may add new Control guidance headers and statement sub-parts with your own new content. (Please refer to Markdown Specifications for Editable Content section below to learn more on which headers are valid in Trestle.) Then the command, <code>trestle author profile-assemble --name original_profile --markdown markdown_dir --output new_profile</code> will create a new OSCAL profile based on the original profile (specified) and the editable content in each control.</p> <p>It's important to distinguish <code>## Control My New Guidance</code> from <code>## Part a.</code>. Parts added with <code>## Control</code> will be new parts in the control added after the control statement, along with any subparts indicated by lower hash levels in that section. In contrast, parts added with e.g. <code>## Part c.</code> will be added by-id to the <em>top level</em> part in the control statement with label <code>c.</code>. Thus "My New Guidance" is the title the user is assigning to a completely new part, while <code>c.</code> refers to a label corresponding the the desired control statement part.</p> <p>When new part names are created in the markdown file the title is captured along with its capitalization and spaces, but the corresponding part name will be converted to snake case by default. However, the user may indicate a specific mapping of the long title of the part to its actual part name by providing an entry in the <code>sections</code> provided during <code>profile-assemble</code>. For example, in the above, the <code>Needed Extra</code> part would be assigned the name <code>needed_extra</code> but if you had a section entry such as <code>n_ex:Needed Extra</code> the name <code>n_ex</code> would be assigned in the assembled json profile, so that if you used that same section entry <code>trestle</code> would know to replace the <code>n_ex</code> part with <code>Needed Extra</code> in any generated markdown.</p> <p>In a cyclic operation of <code>profile generate-edit-assemble</code> you would simply be re-writing from and to the same json profile, in which case the <code>--name</code> and <code>--output</code> are the same file. For this reason the default value for <code>--name</code> is the given output file name specified by <code>--output</code> and you can just use <code>trestle author profile-assemble --markdown profile_md --output my_profile</code>. This will assemble the markdown profile contents in directory <code>profile_md</code> into a json profile named <code>my_profile</code> but it will first use the existing <code>my_profile</code> json file as the parent profile and incorporate changes (due to user edits) in the markdown version of the profile. Unlike <code>catalog-assemble</code> there must always be a parent json profile to reference during assemble, but like <code>catalog-assemble</code> an explicit value for <code>--name</code> is only needed if the parent file is different from the assembled output file.</p> <p>It's important to note that these operations only apply to the <code>Adds</code> and <code>SetParameters</code> in the profile itself - and nothing upstream of the profile is affected. Nor is anything else in the original profile lost or altered. In the example above, the section, <code>## Control Implementation Guidance</code> was added by editing the generated control - and after <code>profile-assemble</code> it ended up as new guidance in the assembled profile.</p> <p>As in the other commands, <code>profile-generate</code> allows specification of a yaml header with <code>--yaml-header</code>, support of the <code>--overwrite-header-values</code> flag and <code>--force-overwrite</code>. Also, during assembly with <code>profile-assemble</code> the <code>--set-parameters</code> flag will set parameters in the profile for the control based on the header in the control markdown file. But unlike with <code>catalog-assemble</code>, only those parameter values marked <code>profile-values</code> will be part of the assembled profile's SetParams when you assemble with the <code>--set-parameters</code> flag. For each parameter, the "incoming" values for the parameters prior to any changes made by the profile are listed as <code>values:</code> and any pending changes made by the profile are listed as <code>profile-values:</code>. If you don't use the <code>--set-parameters</code> flag then all the original SetParameters in the profile will be retained in the new, assembled profile. But if you do set that flag, then only the header parameters with <code>profile-values:</code> will be added as SetParameters. This lets you see all the incoming values for parameters along with any changes made by the current profile, and you can modify, add, or remove parameter settings as desired in the new profile.</p> <p>The <code>x-trestle-add-props</code> key of the yaml header allows addition of properties to the SetParameters of the profile, comprising <code>name</code>, <code>value</code>, and optionally a namespace <code>ns</code> value. The properties may be added at the control level, or attached to a top level statment part by adding a value, <code>smt-part</code> with value <code>a.</code>, <code>b.</code> or any other label for one of the top level statement parts.</p> <p>For convenience, the <code>x-trestle-global</code> key of the yaml header contains the <code>profile-title</code> of the profile used to generate the markdown.</p> <p>Keep in mind that the header in the <code>profile-</code> tools corresponds to the <code>SetParameters</code> in the profile - and not simply the <code>Parameters</code> in the control. For convenience the current incoming values of the control parameters, as set by any upstream profiles, are shown as <code>values</code> - but anything else associated with a parameter, such as <code>profile-values</code>, <code>label</code>, <code>choice</code> will be added to the profile's <code>SetParameters</code> during <code>profile-assemble</code> (if you use the <code>--set-parameters</code> flag.) So entries should be set there only if you want the profile to enforce those entries as <code>SetParameters</code>.</p> <p>As with <code>catalog-assemble</code> described above, a new file is written out only if there are changes to the model relative to an existing output file, and during generate, <code>--force-overwrite</code> will first erase any existing markdown so that fresh markdown is created.</p> <details> <summary>Use of Sections in profile-generate and profile-assemble</summary> <p>The addition of guidance sections in the <code>profile</code> tools requires special handling because the corresponding parts have both a name and a title, where the name is a short form used as an id in the json schema, while the title is the readable form intended for final presentation. An example is <code>ImplGuidance</code> vs. <code>Implementation Guidance</code>. The trestle authoring tools strive to make the markdown as readable as possible, therefore the headings for sections use the title - which means somehow there is a need for a mapping from the short name to the long title for each section. This mapping is provided in several ways: During <code>profile-generate</code> you may provide a <code>--sections "ImplGuidance:Implementation Guidance,ExpEvidence:Expected Evidence"</code> option that would provide title values for <code>ImplGuidance</code> and <code>ExpEvidence</code>. This dictionary mapping is then inserted into the yaml header of each control's markdown. You may also add this mapping directly to a yaml file that is passed in during <code>profile-generate</code>, which is preferable if the list of sections is long. The sections should be entered in the yaml header in a section titled, <code>x-trestle-sections</code>.</p> <p>There is also a <code>--required-sections</code> option during both <code>profile-generate</code> and <code>profile-assemble</code>. This option expects a list of sections as <em>comma-separated short names</em>, e.g. <code>--required-sections "ImplGuidance,ExpEvidence"</code>. During <code>profile-generate</code> any required sections will have in the markdown a prompt created for guidance prose to be entered. And during <code>profile-assemble</code> if required sections are specified, those sections must have prose filled in or it will fail with error.</p> <p>Finally, <code>profile-assemble</code> also has an <code>--allowed-sections</code> option that restricts any added guidance to only those allowed sections - and if disallowed sections are present it will fail with error. If <code>--allowed-sections</code> is not specified then any sections found in the markdown will be added to the assembled profile.</p> <p>Note that these section options are all optional and there isn't a need to provide this form of restriction and enforcement. But in order to have such sections read properly and mapped to the intended part names, a mapping must be provided in one of the ways described above. And for certain workflows, if the allowed and required sections are specified by a command that is run as an action outside the user's control, it allows restriction of what changes can or must be made to a profile in terms of added guidance.</p> <p>(Note that the single quotes are required on Unix-like systems, but on Windows they are only needed if the contained string includes spaces, in which case <em>double</em> quotes should be used.)</p> </details> <details> <summary>Markdown Specifications for Editable Content.</summary> <p>For the ease of editing markdown in Github, Trestle's markdown parser follows <a href=https://github.github.com/gfm/ >Github Flavoured Markdown (GFM) specifications</a> and therefore only certain Control headers will be parsed and added to the control.</p> <p>A valid control header in Trestle is the header that is correctly displayed as such when reading or previewing the edited markdown on Github website.</p> <p>In GFM, headers are considered to be any line of text that has any number of <code>#</code> symbols at the beginning. For example those are all valid headers and will be treated as such by Github:</p> <div class=highlight><pre><span></span><code><span class=gh># Valid header</span>
+<span class=gu>## Valid header </span>
+<span class=gu>##### Valid header</span>
+<span class=gh># Valid &lt;ins&gt; header &lt;/ins&gt; </span>
+<span class=gh># Valid header &lt;!-- some comment here --&gt;</span>
+</code></pre></div> <p>The headers above are valid Control headers and will be added to the control. However, there are multiple exceptions where the header will not be displayed. The header will not be displayed correctly if it is:</p> <ol> <li>Written in the HTML comments <code></code> or tags <code>&lt;ins&gt; # not a header &lt;/ins&gt;</code> as well as multi-line comments: <div class=highlight><pre><span></span><code>&lt;!--
+<span class=gh># not a header</span>
+--&gt;
+</code></pre></div> or multi-line HTML blocks: <div class=highlight><pre><span></span><code>&lt;dl&gt; # not a header
+<span class=gh># not a header</span>
+  &lt;dt&gt;# not a header&lt;/dt&gt;
+&lt;/dl&gt;
+</code></pre></div></li> <li>Written in the single-line <code># not a header</code> and multi-line code blocks: <div class=highlight><pre><span></span><code><span class=gh># not a header </span>
+</code></pre></div></li> <li>Written in the links <code>[# not a header](url)</code></li> <li>Trestle will also not support headers inside the blockquotes <code>&gt; # not a header</code></li> </ol> <p>In all cases above Trestle markdown parser will skip such headers and it will be not added to the control.</p> </details> </details> <details> <summary>trestle author profile-resolve</summary> <p>The <code>trestle author profile-resolve</code> command is different from the <code>generate/assemble</code> commands because it doesn't involve markdown and instead it takes an input profile and creates the corresponding resolved profile catalog in <code>JSON</code> format. In addition, it has several options for how parameters are represented in prose of the controls, and whether or not those values are substituted.</p> <p>As an example, the prose in the statement for control <code>AC-1</code> is:</p> <p><code>Develops, documents, and disseminates to {{ insert: param, ac-1_prm_1 }}:</code></p> <p>The parameter <code>ac-1_prm_1</code> has a label: <code>organization-defined personnel or roles</code> and it may or may not have a value assigned by the profile being resolved. Suppose it has been assigned the value, <code>my prm 1 value</code>. In that case we can either leave the prose as-is (with the parameter in "moustache" form) in the resolved catalog, or we can substitute the value, or we can substitute the descriptive label. trestle supports all these options, along with an optional prefix to specify whether a value has been assigned or not - typically using the name of the organization responsible.</p> <p>The <code>--show-value -sv</code> option will cause the value for the parameter to be substituted in the prose if it is available - otherwise the list of selection options if it has any, or simply the label prose if it has no options.</p> <p>The <code>--value-assigned-prefix -vap</code> option adds a prefix to the value if the value is being assigned by the profile, and the <code>--value-not-assigned-prefix -vnap</code> will assign a prefix to parameters that do not have values assigned, along with the descriptive parameter label.</p> <p>Finally, the <code>--bracket-format -bf</code> option specifies how the parameter representation will be wrapped in braces. The specification is done by placing characters around a single <code>.</code> symbol representing the parameter string, e.g. <code>[.]</code> will place square brackets around the parameter.</p> <p>Note that these options that specify how the parameter is represented all require <code>--show-value</code> to be True, otherwise the raw prose with the moustache is produced.</p> <p>As an example, if we use options</p> <p><code>trestle author profile-resolve -n my_profile -o my_resolved_catalog -sv -bf [.] -vap "ACME Assignment:" -vnap "Assignment:"</code></p> <p>the above prose would become:</p> <p><code>Develops, documents, and disseminates to [ACME Assignment: my prm 1 value]:</code></p> <p>(Note that you need appropriate use of quotation marks in the command for any strings that include spaces or special characters.)</p> <p>And if the parameter did not have a value assigned the result would be:</p> <p><code>Develops, documents, and disseminates to [Assignment: organization-defined personell or roles]:</code></p> <p>Finally, if the parameter already had a value specified in the catalog, the value would be shown by itself in braces:</p> <p><code>Develops, documents, and disseminates to [value in catalog]:</code></p> <p>Similar substitution happens when a parameter has choices that themselves reference a parameter, such as:</p> <div class=highlight><pre><span></span><code>&quot;id&quot;: &quot;ac-4.4_prm_1&quot;,
+&quot;select&quot;: {
+  &quot;how-many&quot;: &quot;one-or-more&quot;,
+  &quot;choice&quot;: [
+    &quot;decrypting the information&quot;,
+    &quot;blocking the flow of the encrypted information&quot;,
+    &quot;terminating communications sessions attempting to pass encrypted information&quot;,
+    &quot; {{ insert: param, ac-4.4_prm_2 }} &quot;
+  ]
+</code></pre></div> <p>If the statement prose for AC-4.4 is:</p> <p><code>The information system prevents encrypted information from bypassing content-checking mechanisms by {{ insert: param, ac-4.4_prm_1 }}.</code></p> <p>and if a value <code>pulling the plug</code> has been assigned to ac-4.4_prm_2, the prose will be:</p> <p><code>The information system prevents encrypted information from bypassing content-checking mechanisms by [Selection (one or more): decrypting the information, blocking the flow of the encrypted information, terminating the communications sessions attempting to pass encrypted information, [ACME Assignment: pulling the plug]].</code></p> <p>There is a separate option from <code>--show-values</code> that will instead show only the descriptive labels for the parameters - again with an optional prefix. The options are <code>--show-labels -sl</code> and <code>--label-prefix -lp</code>. Note that there is no need for "assigned" or "not assigned" because no values are being shown - just the labels.</p> <p>If we resolve the profile with options <code>--show-labels --label-prefix "Label:" --bracket-format [.]</code> the resulting prose from earlier would be:</p> <p><code>Develops, documents, and disseminates to [Label: organization-defined personnel or roles]:</code></p> <p>and any value present for the parameter would be ignored.</p> <p>Similar options apply to the <code>jinja</code> authoring commands.</p> </details> <details> <summary>trestle author profile-inherit</summary> <p>The <code>trestle author profile-inherit</code> command is different from the <code>generate/assemble</code> commands because it doesn't involve markdown and instead it takes an parent profile and ssp and creates child profile in <code>JSON</code> format.</p> <p>When utilizing a process with leveraged authorizations, use the command <code>trestle author profile-inherit</code> to create a profile with initial content using a parent profile and SSP with inheritable controls. The provided and responsibility statements for all <code>by-component</code> fields, as well as the implementation status, will be used to evaluate the leveraged SSP. To be filtered from the output profile (i.e. controls delta profile), all components must have exported provided statements, no exported responsibility statements, and an implementation status of <code>implemented</code>.</p> <p>The filter command is invoked as:</p> <p><code>trestle author profile-inherit --profile my_parent --ssp my_leveraged_ssp --output controls_delta_profile</code></p> <p>Both the parent profile and the SSP must be present in the trestle workspace. This command produces a new workspace profile that imports the parent profile and filters the inherited controls from the SSP using the <code>exclude-controls</code> and <code>include-controls</code> fields in the profile import.</p> <details> <summary>Example imports generated from profile-inherit</summary> <div class=highlight><pre><span></span><code><span class=w>  </span><span class=nt>&quot;imports&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>      </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;href&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;trestle://profiles/controls_delta/profile.json&quot;</span><span class=p>,</span>
+<span class=w>        </span><span class=nt>&quot;include-controls&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;with-ids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=s2>&quot;ac-2&quot;</span>
+<span class=w>            </span><span class=p>]</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>],</span>
+<span class=w>        </span><span class=nt>&quot;exclude-controls&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;with-ids&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=s2>&quot;ac-1&quot;</span>
+<span class=w>            </span><span class=p>]</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>]</span>
+<span class=w>      </span><span class=p>}</span>
+<span class=w>    </span><span class=p>]</span>
+</code></pre></div> </details> </details> <details> <summary>trestle author component-generate and component-assemble</summary> <p>The <code>trestle author component-generate</code> command takes a JSON ComponentDefinition file and creates markdown for its controls in separate directories for each of the DefinedComponents in the file. This allows specifying the implementation response and status for each component separately in separate markdown files for a control. In addition, the markdown captures Rules in the control that specify descriptions and parameter values that apply to the expected responses.</p> <p>The command has few options compared to other author commands and only requires specifying <code>--name</code> and <code>--output</code> for the ComponentDefinition and output markdown directory, respectively.</p> <p>Here is an example of the generated markdown for the component <code>OSCO</code> in the ComponentDefinition file. Note that this file will be under the subdirectory <code>OSCO/source_name</code> of the specified output directory - and any other DefinedComponents will have corresponding subdirectories level with the <code>OSCO</code> one. Here <code>source_name</code> refers to the name of the profile or catalog in the ComponentDefinition that is the source for this control. The control markdown files are written into directories split by both component name and source name. If the source refers to a general uri and not a named profile or catalog in the trestle directory, then names such as <code>source_001</code> and <code>source_002</code> are assigned. The actual source title can be found in the yaml header of any of the control markdown files.</p> <details> <summary>Example of control markdown after component-generate</summary> <div class=highlight><pre><span></span><code>---
+x-trestle-comp-def-rules:
+  comp_aa:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: top_shared_rule_1
+      description: top shared rule 1 in aa
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: comp_rule_aa_1
+      description: comp rule aa 1
+x-trestle-rules-params:
+  comp_aa:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: shared_param_1
+      description: shared param 1 in aa
+      options: &#39;[&quot;shared_param_1_aa_opt_1&quot;, &quot;shared_param_1_aa_opt_2&quot;]&#39;
+      rule-id: top_shared_rule_1
+x-trestle-comp-def-rules-param-vals:
+  # You may set new values for rule parameters by adding
+  #
+  # component-values:
+  #   - value 1
+  #   - value 2
+  #
+  # below a section of values:
+  # The values list refers to the values as set by the components, and the component-values are the new values
+  # to be placed in SetParameters of the component definition.
+  #
+  comp_aa:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: shared_param_1
+      values:
+<span class=w>        </span><span class=k>-</span><span class=w> </span>shared_param_1_aa_opt_1
+x-trestle-param-values:
+  ac-1_prm_1:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>prof_aa val 1
+  ac-1_prm_2:
+  ac-1_prm_3:
+  ac-1_prm_4:
+  ac-1_prm_5:
+  ac-1_prm_6:
+  ac-1_prm_7:
+x-trestle-global:
+  profile:
+    title: comp prof aa
+    href: trestle://profiles/comp_prof_aa/profile.json
+<span class=gu>  sort-id: ac-01</span>
+<span class=gu>---</span>
+
+<span class=gh># ac-1 - \[Access Control\] Policy and Procedures</span>
+
+<span class=gu>## Control Statement</span>
+
+The organization:
+
+<span class=k>-</span><span class=w> </span>\[a.\] Develop, document, and disseminate to prof_aa val 1:
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[1.\] Organization-level; Mission/business process-level; System-level access control policy that:
+
+<span class=w>    </span><span class=k>-</span><span class=w> </span>\[(a)\] Addresses purpose, scope, roles, responsibilities, management commitment, coordination among organizational entities, and compliance; and
+<span class=w>    </span><span class=k>-</span><span class=w> </span>\[(b)\] Is consistent with applicable laws, executive orders, directives, regulations, policies, standards, and guidelines; and
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[2.\] Procedures to facilitate the implementation of the access control policy and the associated access controls;
+
+<span class=k>-</span><span class=w> </span>\[b.\] Designate an organization-defined official to manage the development, documentation, and dissemination of the access control policy and procedures; and
+
+<span class=k>-</span><span class=w> </span>\[c.\] Review and update the current access control:
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[1.\] Policy organization-defined frequency and following organization-defined events; and
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[2.\] Procedures organization-defined frequency and following organization-defined events.
+
+<span class=gu>## Control guidance</span>
+
+Access control policy and procedures address the controls in the AC family that are implemented within systems and organizations. The risk management strategy is an important factor in establishing such policies and procedures. Policies and procedures contribute to security and privacy assurance. Therefore, it is important that security and privacy programs collaborate on the development of access control policy and procedures. Security and privacy program policies and procedures at the organization level are preferable, in general, and may obviate the need for mission- or system-specific policies and procedures. The policy can be included as part of the general security and privacy policy or be represented by multiple policies reflecting the complex nature of organizations. Procedures can be established for security and privacy programs, for mission or business processes, and for systems, if needed. Procedures describe how the policies or controls are implemented and can be directed at the individual or role that is the object of the procedure. Procedures can be documented in system security and privacy plans or in one or more separate documents. Events that may precipitate an update to access control policy and procedures include assessment or audit findings, security incidents or breaches, or changes in laws, executive orders, directives, regulations, policies, standards, and guidelines. Simply restating controls does not constitute an organizational policy or procedure.
+
+______________________________________________________________________
+
+<span class=gu>## What is the solution and how is it implemented?</span>
+
+&lt;!-- For implementation status enter one of: implemented, partial, planned, alternative, not-applicable --&gt;
+
+&lt;!-- Note that the list of rules under ### Rules: is read-only and changes will not be captured after assembly to JSON --&gt;
+
+imp req prose for ac-1 from comp aa
+
+<span class=gu>### Rules:</span>
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>top_shared_rule_1
+
+<span class=gu>### Implementation Status: implemented</span>
+
+______________________________________________________________________
+
+<span class=gu>## Implementation for part a.</span>
+
+statement prose for part a. from comp aa
+
+<span class=gu>### Rules:</span>
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>comp_rule_aa_1
+
+<span class=gu>### Implementation Status: partial</span>
+
+______________________________________________________________________
+</code></pre></div> </details> <p>There is no direct way to specify rules in the ComponentDefinition, so they are specified via properties as shown here:</p> <details> <summary>Representation of rules in the props of a ComponentDefinition</summary> <div class=highlight><pre><span></span><code><span class=p>[</span>
+<span class=w>  </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule_Id&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;http://comp_ns&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;comp_rule_aa_1&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule_Id&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule_2&quot;</span>
+<span class=w>  </span><span class=p>},</span>
+<span class=w>  </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule_Description&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;http://comp_ns&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;comp rule aa 1&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule_2&quot;</span>
+<span class=w>  </span><span class=p>},</span>
+<span class=w>  </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule_Id&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;http://comp_ns&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;comp_rule_aa_2&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule_Id&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule_3&quot;</span>
+<span class=w>  </span><span class=p>},</span>
+<span class=w>  </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule_Description&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;http://comp_ns&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;comp rule aa 2&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule_Description&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule_3&quot;</span>
+<span class=w>  </span><span class=p>},</span>
+<span class=w>  </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Parameter_Id&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;http://comp_ns&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;shared_param_1&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Parameter_Id&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule_1&quot;</span>
+<span class=w>  </span><span class=p>},</span>
+<span class=w>  </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Parameter_Description&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;http://comp_ns&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;shared param 1 in aa&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Parameter_Description&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule_1&quot;</span>
+<span class=w>  </span><span class=p>},</span>
+<span class=w>  </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Parameter_Value_Alternatives&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;http://comp_ns&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;[\&quot;shared_param_1_aa_opt_1\&quot;, \&quot;shared_param_1_aa_opt_2\&quot;]&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Parameter_Value_Alternatives&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule_1&quot;</span>
+<span class=w>  </span><span class=p>}</span>
+<span class=p>],</span>
+<span class=nt>&quot;set-parameters&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>  </span><span class=p>{</span>
+<span class=w>    </span><span class=nt>&quot;param-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;shared_param_1&quot;</span><span class=p>,</span>
+<span class=w>    </span><span class=nt>&quot;values&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>      </span><span class=s2>&quot;shared_param_1_aa_opt_1&quot;</span>
+<span class=w>    </span><span class=p>],</span>
+<span class=w>    </span><span class=nt>&quot;remarks&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;set shared param aa 1&quot;</span>
+<span class=w>  </span><span class=p>}</span>
+<span class=p>]</span>
+</code></pre></div> </details> <p>In this scheme the rules have a <code>Rule_Id</code> (e.g. <code>comp_rule_aa_1</code> in this example) and an associated tag (<code>rule_2</code>) in the <code>remarks</code> section that binds the name to the description: <code>Rule_Description</code>=<code>comp rule aa 1</code>. In addition, rules may be associated with parameters specified here with <code>Parameter_id</code>=<code>shared_param_1</code>, <code>Parameter_Description</code>=<code>shared param 1 in aa</code>, and <code>Parameter_Value_Alternatives</code>=<code>[\"shared_param_1_aa_opt_1\", \"shared_param_1_aa_opt_2\"]</code>. <code>Parameter_Value_Alternatives</code> corresponds to possible Choices for the parameter value.</p> <p>Also shown in this JSON excerpt is a normal set-parameter used to set the value of a parameter associated with a rule id. Thus the setting of the parameter follows the normal OSCAL schema for setting a parameter value, while the specification of the parameter and its options is specified via linked properties.</p> <p>The markdown header lists all the rules that apply to this control, along with their descriptions, and for each implementation response, the rules that apply to it are shown. The association of an ImplementedRequirement with a rule is again done with properties as shown here:</p> <details> <summary>Linking of ImplementedRequirement to a rule</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;implemented-requirements&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;ca5ea4c5-ba51-4b1d-932a-5606891b7500&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;control-id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;ac-1&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;imp req prose for ac-1 from comp aa&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Rule_Id&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;top_shared_rule_1&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;implementation-status&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;implemented&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>]</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> </details> <p>The values for rule parameters are specified using the normal <code>SetParameter</code> mechanism in the ControlImplementation, but it's important to note that there are two different types of <code>SetParameter</code>: Those that apply to the normal parameters of the control, and those that apply strictly to the rules.</p> <p>Note that markdown is created for all of the controls in the <code>Component</code> control implementation. However, when processing control parts, the part is only written out if there are associated rules or pre-filled implementation descriptions.</p> <p>In addition, the rules should be regarded as read-only from the editing perspective, and you cannot change the rules associated with a control or its parts. But you may edit the rule parameter values as described in the comments of the markdown file under <code>x-trestle-comp-def-rules-param-vals</code>. You may also edit the prose and implementation status associated with a statement part at the bottom of the markdown file.</p> <p><code>trestle author component-assemble</code></p> <p>The <code>component-assemble</code> command will assemble the markdown into a ComponentDefinition file containing all the DefinedComponents in the markdown, and as usual it can either overwrite the original JSON file or create a new one. Edits made to the prose, status and rule parameter values in the markdown and header will be captured in the assembled file, but the list of rules attached with each ImplementedRequirement is <em>readonly</em> and new rule associations cannot be made via markdown.</p> </details> <details> <summary>trestle author ssp-generate and trestle author ssp-assemble</summary> <p>The <code>ssp-generate</code> command creates markdown for an SSP (System Security Plan) from a profile, optional component definitions, and optional yaml header file. <code>ssp-assemble</code> (described below) can then assemble the markdown files into a single json SSP file. The profile contains a list of imports that are either a direct reference to a catalog, or an indirect reference via a profile. There may be multiple imports of either type, and referenced profiles may themselves import either catalogs or profiles. Each profile involved may specify the controls that should be imported, along with any modifications to those controls. This command internally creates a resolved profile catalog and generates a directory containing a set of markdown files, one for each control in the resolved catalog. Each markdown file has the optional yaml header embedded at the start of the file.</p> <p>The component definitions specify the components of the SSP, along with metadata associated with rules and status for the implemented requirements. The rules, rule parameters, and status values are encoded by properties within the components as described above for <code>component-generate</code>.</p> <p>Example usage for creation of the markdown:</p> <p><code>trestle author ssp-generate --profile my_prof --compdefs "compdef_a,compdef_b" --yaml /my_yaml_dir/header.yaml --output my_ssp</code></p> <p>In this example the profile and component definitions have previously been imported into the trestle directory. The profile itself must be in the trestle directory, but the imported catalogs and profiles may be URI's with href's as described below.</p> <p>The generated markdown output will be placed in the trestle subdirectory <code>my_ssp</code> with a subdirectory for each control group.</p> <p>If the imported catalogs or profiles are not at the URI pointed to by the Import href of the profile then the href should be changed using the <code>trestle href</code> command.</p> <p>Similar to <code>catalog-generate</code>, the <code>--yaml</code> and <code>--overwrite-header-values</code> flag may be specified to let the input yaml header overwrite values already specified in the header of the control markdown file. Also, the <code>--force-overwrite</code> option can be used to overwrite markdowns with content from JSON.</p> <p>The resulting files look like this:</p> <details> <summary>Example of control markdown after ssp-generate</summary> <div class=highlight><pre><span></span><code>---
+x-trestle-comp-def-rules:
+  comp_aa:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: top_shared_rule_1
+      description: top shared rule 1 in aa
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: comp_rule_aa_1
+      description: comp rule aa 1
+  comp_ab:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: top_shared_rule_1
+      description: top shared rule 1 in ab
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: comp_rule_ab_1
+      description: comp rule ab 1
+  comp_ba:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: top_shared_rule_1
+      description: top shared rule 1 in ba
+  comp_bb:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: top_shared_rule_1
+      description: top shared rule 1 in bb
+x-trestle-rules-params:
+  comp_aa:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: shared_param_1
+      description: shared param 1 in aa
+      options: &#39;[&quot;shared_param_1_aa_opt_1&quot;, &quot;shared_param_1_aa_opt_2&quot;]&#39;
+      rule-id: top_shared_rule_1
+  comp_ab:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: shared_param_1
+      description: shared param 1 in ab
+      options: &#39;[&quot;shared_param_1_ab_opt_1&quot;, &quot;shared_param_1_ab_opt_2&quot;]&#39;
+      rule-id: top_shared_rule_1
+  comp_ba:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: shared_param_1
+      description: shared param 1 in ba
+      options: &#39;[&quot;shared_param_1_ba_opt_1&quot;, &quot;shared_param_1_ba_opt_2&quot;]&#39;
+      rule-id: top_shared_rule_1
+  comp_bb:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: shared_param_1
+      description: shared param 1 in bb
+      options: &#39;[&quot;shared_param_1_bb_opt_1&quot;, &quot;shared_param_1_bb_opt_2&quot;]&#39;
+      rule-id: top_shared_rule_1
+x-trestle-comp-def-rules-param-vals:
+  # You may set new values for rule parameters by adding
+  #
+  # ssp-values:
+  #   - value 1
+  #   - value 2
+  #
+  # below a section of values:
+  # The values list refers to the values as set by the components, and the ssp-values are the new values
+  # to be placed in SetParameters of the SSP.
+  #
+  comp_aa:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: shared_param_1
+      values:
+<span class=w>        </span><span class=k>-</span><span class=w> </span>shared_param_1_aa_opt_1
+      ssp-values:
+<span class=w>        </span><span class=k>-</span><span class=w> </span>shared_param_1_aa_opt_2
+  comp_ab:
+<span class=w>    </span><span class=k>-</span><span class=w> </span>name: shared_param_1
+      values:
+<span class=w>        </span><span class=k>-</span><span class=w> </span>shared_param_1_ab_opt_2
+x-trestle-set-params:
+  # You may set values for parameters in the assembled SSP by adding
+  #
+  # ssp-values:
+  #   - value 1
+  #   - value 2
+  #
+  # below a section of values:
+  # The values list refers to the values in the resolved profile catalog, and the ssp-values represent new values
+  # to be placed in SetParameters of the SSP.
+  #
+  ac-1_prm_1:
+    values:
+<span class=w>      </span><span class=k>-</span><span class=w> </span>comp_prof val 1
+    display-name: AC-1 (a) (1)
+  ac-1_prm_2:
+    values:
+  ac-1_prm_3:
+    values:
+  ac-1_prm_4:
+    values:
+  ac-1_prm_5:
+    values:
+  ac-1_prm_6:
+    values:
+  ac-1_prm_7:
+    values:
+x-trestle-global:
+  profile:
+    title: comp prof aa
+    href: trestle://profiles/comp_prof/profile.json
+  sort-id: ac-01
+x-trestle-add-props:
+  # Add or modify control properties here
+  # Properties may be at the control or part level
+  # Add control level properties like this:
+  #   - name: ac1_new_prop
+  #     value: new property value
+  #
+  # Add properties to a statement part like this, where &quot;b.&quot; is the label of the target statement part
+  #   - name: ac1_new_prop
+  #     value: new property value
+  #     smt-part: b.
+  #
+<span class=w>  </span><span class=k>-</span><span class=w> </span>name: prop_with_ns
+    value: prop with ns
+    ns: https://my_new_namespace
+<span class=w>  </span><span class=k>-</span><span class=w> </span>name: prop_with_no_ns
+    value: prop with no ns
+<span class=gu>    ns: https://my_added_namespace</span>
+<span class=gu>---</span>
+
+<span class=gh># ac-1 - \[Access Control\] Policy and Procedures</span>
+
+<span class=gu>## Control Statement</span>
+
+The organization:
+
+<span class=k>-</span><span class=w> </span>\[a.\] Develop, document, and disseminate to [comp_prof val 1]:
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[1.\] [Organization-level; Mission/business process-level; System-level] access control policy that:
+
+<span class=w>    </span><span class=k>-</span><span class=w> </span>\[(a)\] Addresses purpose, scope, roles, responsibilities, management commitment, coordination among organizational entities, and compliance; and
+<span class=w>    </span><span class=k>-</span><span class=w> </span>\[(b)\] Is consistent with applicable laws, executive orders, directives, regulations, policies, standards, and guidelines; and
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[2.\] Procedures to facilitate the implementation of the access control policy and the associated access controls;
+
+<span class=k>-</span><span class=w> </span>\[b.\] Designate an [organization-defined official] to manage the development, documentation, and dissemination of the access control policy and procedures; and
+
+<span class=k>-</span><span class=w> </span>\[c.\] Review and update the current access control:
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[1.\] Policy [organization-defined frequency] and following [organization-defined events]; and
+<span class=w>  </span><span class=k>-</span><span class=w> </span>\[2.\] Procedures [organization-defined frequency] and following [organization-defined events].
+
+<span class=gu>## Control guidance</span>
+
+Access control policy and procedures address the controls in the AC family that are implemented within systems and organizations. The risk management strategy is an important factor in establishing such policies and procedures. Policies and procedures contribute to security and privacy assurance. Therefore, it is important that security and privacy programs collaborate on the development of access control policy and procedures. Security and privacy program policies and procedures at the organization level are preferable, in general, and may obviate the need for mission- or system-specific policies and procedures. The policy can be included as part of the general security and privacy policy or be represented by multiple policies reflecting the complex nature of organizations. Procedures can be established for security and privacy programs, for mission or business processes, and for systems, if needed. Procedures describe how the policies or controls are implemented and can be directed at the individual or role that is the object of the procedure. Procedures can be documented in system security and privacy plans or in one or more separate documents. Events that may precipitate an update to access control policy and procedures include assessment or audit findings, security incidents or breaches, or changes in laws, executive orders, directives, regulations, policies, standards, and guidelines. Simply restating controls does not constitute an organizational policy or procedure.
+
+______________________________________________________________________
+
+<span class=gu>## What is the solution and how is it implemented?</span>
+
+&lt;!-- For implementation status enter one of: implemented, partial, planned, alternative, not-applicable --&gt;
+
+&lt;!-- Note that the list of rules under ### Rules: is read-only and changes will not be captured after assembly to JSON --&gt;
+
+<span class=gu>### This System</span>
+
+&lt;!-- Add implementation prose for the main This System component for control: ac-1 --&gt;
+
+<span class=gu>#### Implementation Status: planned</span>
+
+<span class=gu>### comp_aa</span>
+
+imp req prose for ac-1 from comp aa
+
+<span class=gu>#### Rules:</span>
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>top_shared_rule_1
+
+<span class=gu>#### Implementation Status: implemented</span>
+
+<span class=gu>### comp_ab</span>
+
+&lt;!-- Add control implementation description here for control: ac-1 --&gt;
+
+<span class=gu>#### Rules:</span>
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>top_shared_rule_1
+
+<span class=gu>#### Implementation Status: implemented</span>
+
+______________________________________________________________________
+
+<span class=gu>## Implementation for part a.</span>
+
+<span class=gu>### comp_aa</span>
+
+statement prose for part a. from comp aa
+
+<span class=gu>#### Rules:</span>
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>comp_rule_aa_1
+
+<span class=gu>#### Implementation Status: partial</span>
+
+<span class=gu>### comp_ab</span>
+
+&lt;!-- Add control implementation description here for item a. --&gt;
+
+<span class=gu>#### Rules:</span>
+
+<span class=w>  </span><span class=k>-</span><span class=w> </span>comp_rule_ab_1
+
+<span class=gu>#### Implementation Status: partial</span>
+
+______________________________________________________________________
+</code></pre></div> </details> <p>\ Each label in the ssp is wrapped in <code>\[ \]</code> to indicate it comes directly from the label in the control and is not generated by the markdown viewer. Keep in mind that the actual label is the same but with the <code>\[ \]</code> removed.</p> <p>Note that for each statement in the control description there is a corresponding response section in which to provide a detailed response for later inclusion in the final ssp as the control implementation.</p> <p>Also note that the optional final sections are provided, and labeled using the title for the corresponding section.</p> <p>In addition, this is the only control markdown where the moustache (<code>{{}}</code>) items have been replaced by the corresponding parameter values in the final resolved profile catalog, surrounded by brackets, so that the prose corresponds to the final intended control and its implementation.</p> <p>The markdown can have guidance per-component in the control, as shown by the line, <code>### ACME Component</code>. Any prose directly under a <code>##</code> implementation section will apply to the overall system component, but sections in a sub-header of the form <code>###</code> will only apply to that particular component.</p> <p>The <code>--include-all-parts</code> flag controls how the main system component (<code>This System</code>) is written in the markdown. By default, control parts are not written out unless a component has a rule associated with that particular control part or <code>statement</code>. When <code>--include-all-parts</code> is set, all control parts will be written with the main component present under the <code>## Implementation for part &lt;part&gt;</code> section. All other components will still be conditionally added based on the presence of rules.</p> <p>After generating the markdown for the resolved profile catalog you may then edit the files and provide text in the sections with <code>Add control implementation...</code> in them. But do not remove the horizontal rule lines or modify/remove the lines with <code>###</code> in them, corresponding to system components.</p> <p>If you edit the control markdown files you may run <code>ssp-generate</code> again and your edits will not be overwritten. When writing out the markdown for a control, any existing markdown for that control will be read and the response text for each part will be re-inserted into the new markdown file. If the new markdown has added parts the original responses will be placed correctly in the new file, but if any part is removed from the source control json file then any corresponding prose will be lost after the next <code>ssp-generate</code>.</p> <p>The <code>x-trestle-add-props</code> key of the yaml header allows the addition of properties to the implemented requirements under the SSP control implementation, comprising <code>name</code>, <code>value</code>, and optionally a namespace <code>ns</code> value. Similarly to the <code>x-trestle-add-props</code> in profile authoring, the properties may be added at the control level, or attached to a top level statement part by adding a value, <code>smt-part</code> with value <code>a.</code>, <code>b.</code> or any other label for one of the top level statement parts.</p> <p><code>trestle author ssp-assemble</code></p> <p>After manually edting the markdown and providing the responses for the control implementation requirements, the markdown can be assembled into a single json SSP file with:</p> <p><code>trestle author ssp-assemble --markdown my_ssp --compdefs my_compdef_a,my_compdef_b --output my_json_ssp</code></p> <p>This will assemble the markdown files in the my_ssp directory and create a json SSP with name my_json_ssp in the system-security-plans directory.</p> <p>As indicated for <code>ssp-generate</code>, please do not alter any of the horizontal rule lines or lines indicating the part or control id, e.g. <code>### ACME Component</code>. You may run <code>ssp-generate</code> and <code>ssp-assemble</code> repeatedly for the same markdown directory, allowing a continuous editing and updating cycle.</p> <p>As with all the <code>assemble</code> tools, you may optionally specify a <code>--name</code> for a corresponding json file into which the updates will be inserted, thereby preserving metadata and other aspects of the model. The result can overwrite the provided model or get directed to a new model. And the version may be updated and the uuid's regenerated. As with the other <code>-assemble</code> tools, if an output file already exists, a new one will only be written if there are changes to the model relative to the existing file. See <code>catalog-assemble</code> for more details.</p> <p>If you do not specify component-defintions during assembly, the markdown should not refer to any components other than <code>This System</code>. Thus you may first generate markdown with <code>ssp-generate</code> and no component-definitions specified - and then you may assemble that ssp with <code>ssp-assemble</code> and no component-definitions specified - but only if there are no components other than <code>This System</code> referenced in the markdown. You may add new component implementation details to the markdown later, but any new components must be defined in a component-defintion file, and that file must be specified when <code>ssp-assemble</code> is run.</p> <p><code>ssp inheritance view</code></p> <p>The inheritance view is generated by setting the <code>--leveraged-ssp</code> flag with <code>trestle author ssp-generate</code>. It contains information relating to exported information such as inherited capabilities and customer responsibilities that can be used to populate the inheritance information in the assembled SSP. When used, a directory named "inheritance" is created within the markdown directory. This directory serves as a designated space for mapping inherited capabilities and responsibilities onto components in the assemble SSP and authoring satisfied statements for responsibilities.</p> <p>Example usage for creation of the markdown:</p> <p><code>trestle author ssp-generate --profile my_prof --compdefs "compdef_a,compdef_b" --yaml /my_yaml_dir/header.yaml --leveraged-ssp my_provider_ssp --output my_ssp</code></p> <p>In this example the leveraged ssp has previously been imported into the trestle directory, but it can be fetched from remote location.</p> <p>The generated markdown output with the inheritance view will be placed in the trestle subdirectory <code>my_ssp/inheritance</code> with a subdirectory for each component in the leveraged ssp with directories separated by control and statement id below.</p> <p>An example of this directory structure is below.</p> <div class=highlight><pre><span></span><code>.
+├── Application
+│   ├── ac-1_stmt.a
+│   │   └── 11111111-0000-4000-9009-001001002006.md
+│   ├── ac-2.1
+│   │   └── 11111111-0000-4000-9009-001001002004.md
+│   └── ac-2_stmt.a
+│       └── 11111111-0000-4000-9009-002001002001_11111111-0000-4000-9009-002001002002.md
+└── This System
+    ├── ac-1_stmt.a
+    │   └── 11111111-0000-4000-9009-001002002001.md
+    ├── ac-2.1
+    │   └── 11111111-0000-4000-9009-001001002001.md
+    └── ac-2_stmt.a
+        └── 11111111-0000-4000-9009-002001001001.md
+</code></pre></div> <p>The leveraged components are used as the top level directory to allow any non-leveraged components to be easily skipped or removed. Each markdown file is named in accordance with the uuid of the exported statement to ensure statement description updates can be applied.</p> <p>There are three types of markdown files that can be generated from this process.</p> <p>The examples below demonstrate these types:</p> <details> <summary>Example of inheritance provided only markdown after ssp-generate</summary> <div class=highlight><pre><span></span><code>---
+x-trestle-statement:
+  # Add or modify leveraged SSP Statements here.
+  provided-uuid: 11111111-0000-4000-9009-001002002001
+x-trestle-leveraging-comp:
+  # Leveraged statements can be optionally associated with components in this system.
+  # Associate leveraged statements to Components of this system here:
+<span class=gu>  - name: REPLACE_ME</span>
+<span class=gu>---</span>
+
+<span class=gh># Provided Statement Description</span>
+
+Customer_appropriate description of what may be inherited.
+</code></pre></div> </details> <details> <summary>Example of inheritance customer responsibility only markdown after ssp-generate</summary> <div class=highlight><pre><span></span><code>---
+x-trestle-statement:
+  # Add or modify leveraged SSP Statements here.
+  responsibility-uuid: 11111111-0000-4000-9009-002001001001
+x-trestle-leveraging-comp:
+  # Leveraged statements can be optionally associated with components in this system.
+  # Associate leveraged statements to Components of this system here:
+<span class=gu>  - name: REPLACE_ME</span>
+<span class=gu>---</span>
+
+<span class=gh># Responsibility Statement Description</span>
+
+Leveraging system&#39;s responsibilities with respect to inheriting this capability.
+
+<span class=gh># Satisfied Statement Description</span>
+
+&lt;!-- Use this section to explain how the inherited responsibility is being satisfied. --&gt;
+</code></pre></div> </details> <details> <summary>Example of inheritance shared responsibility markdown after ssp-generate</summary> <div class=highlight><pre><span></span><code>---
+x-trestle-statement:
+  # Add or modify leveraged SSP Statements here.
+  provided-uuid: 11111111-0000-4000-9009-002001002001
+  responsibility-uuid: 11111111-0000-4000-9009-002001002002
+x-trestle-leveraging-comp:
+  # Leveraged statements can be optionally associated with components in this system.
+  # Associate leveraged statements to Components of this system here:
+<span class=gu>  - name: REPLACE_ME</span>
+<span class=gu>---</span>
+
+<span class=gh># Provided Statement Description</span>
+
+Consumer-appropriate description of what may be inherited.
+
+<span class=gh># Responsibility Statement Description</span>
+
+Leveraging system&#39;s responsibilities with respect to inheriting this capability.
+
+<span class=gh># Satisfied Statement Description</span>
+
+&lt;!-- Use this section to explain how the inherited responsibility is being satisfied. --&gt;
+</code></pre></div> </details> <p>Some additional information and tips about this markdown are below:</p> <ul> <li>Do not change the statement UUIDs in the YAML header. This is used in the assembled JSON to link the statements in the leveraged SSP to the components in the leveraging SSP.</li> <li>When mapping components in the YAML header, use the component title. If you do not wish to map a component to a particular inherited capability or responsibility, just leave the file as is. Files without mapped components or that contain the default "REPLACE ME" entry will be skipped.</li> <li>If the file exists, just the editable information will be preserved when regenerating existing inheritance view markdown. This includes the information under <code>Satisfied Statement Description</code> and the mapped components in the YAML header.</li> </ul> <p>After manually editing the inheritance view markdown, the <code>trestle author ssp-assemble</code> command can be run without modifications for the inheritance view use case. During assemble, the inheritance directory is detected and the information will be assembled into the SSP. The by-component assemblies will be updated or added under existing implemented requirement or statement sections with the information from the markdown.</p> </details> <details> <summary>trestle author ssp-filter</summary> <p>Once you have an SSP in the trestle directory you can filter its contents with a profile, list of components, list of implementation statuses, or list control origination values by using the command <code>trestle author ssp-filter</code>. The SSP is assumed to contain a superset of the controls needed by the profile if a profile is specified, and the filter operation will generate a new SSP with only those controls needed by the profile. If a list of component names is provided, only the specified components will appear in the system implementation of the ssp. If a list of implementation statuses is provided, controls with implementations including those statuses will appear in the control implementation of the ssp. Similarly, if a list of control origination values is provided, implemented requirements with a control origination property value included in the provided values will appear in the control implementation of the ssp.</p> <p>The filter command is invoked as:</p> <p><code>trestle author ssp-filter --name my_ssp --profile my_profile --components comp_a:comp_b --implementation-status "planned,partial" --control-origination "customer-configured" --output my_culled_ssp</code></p> <p>The SSP must be present in the trestle workspace and, if filtering by profile, that profile must also be in the trestle workspace. This command will generate a new SSP in the workspace. If the profile makes reference to a control not in the SSP then the routine will fail with an error message. Similarly, if one of the components is not present in the ssp the routine will also fail. The implementation statuses must be one of the allowed values as defined in the OSCAL SSP JSON format reference. Those include the following: implemented, partial, planned, alternative, and not-applicable. If an invalid value is provided, an error is returned. The control origination values also must be one of the allowed values as defined in the OSCAL SSP JSON format reference. Those include the following: system-specific, inherited, customer-configured, customer-provided, and organization. If an invalid value is provided, an error is returned.</p> </details> <details> <summary>Summary of options used by the catalog, profile, component and ssp authoring tools.</summary> <p>The provided options for the generation and assembly of documents in the ssp workflow is rich and powerful, but can also be confusing. To help see how they all relate please consult the following diagram showing the required and optional command line arguments for each command. The checkboxes indicate required and the open circles represent optional.</p> <p>The options shown are fairly consistent across the <code>-generate</code> and <code>-assemble</code> functions, but some clarification may be needed. For <code>catalog-assemble</code> and <code>profile-assemble</code> you have the option to use an existing json file as a parent model into which new content is inserted - in memory - and the final model may either be written back into that same json file, or a different one - based on <code>--output</code>. If you just want to keep editing and modifying the same original json file you can specify <code>--name</code> and <code>--output</code> to be the same, original json file. But you could also direct it to a new json file while still using an original file as the "parent." A key benefit of referencing an original json file is the resuse of metadata and backmatter - along with everything else separate from the controls.</p> <p><code>ssp-generate</code> is special because it starts with a profile rather than an ssp, whereas <code>catalog-generate</code> and <code>profile-generate</code> both start with a parent model of the same type. Nonetheless, you still have an option during <code>ssp-assemble</code> to use a given json file as the template into which new content is inserted, and once again you may overwrite that original json file or direct it to a new one using <code>--output</code>.</p> <p><img alt="Table of authoring tool options" src=trestle_ssp_author_options.png></p> </details> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">September 16, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/profile_does.drawio b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/profile_does.drawio
new file mode 100644
index 000000000..0df53e763
--- /dev/null
+++ b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/profile_does.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-10-13T02:29:33.698Z" agent="5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/15.4.0 Chrome/91.0.4472.164 Electron/13.5.0 Safari/537.36" etag="pllrF4yqJccUb3wys3R-" version="15.4.0" type="device"><diagram id="OxGCmetu4fi9Pe4N5NgC" name="Page-1">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</diagram></mxfile>
\ No newline at end of file
diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/profile_does.png b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/profile_does.png
new file mode 100644
index 0000000000000000000000000000000000000000..b08a230b43a594c3f991e1feefbae7bac36531ae
GIT binary patch
literal 37208
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
L-^sl7;N^b;EdAvZ

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_catalog.drawio b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_catalog.drawio
new file mode 100644
index 000000000..1d4ad7bda
--- /dev/null
+++ b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_catalog.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-10-13T02:23:13.716Z" agent="5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/15.4.0 Chrome/91.0.4472.164 Electron/13.5.0 Safari/537.36" etag="kejvZGcaOuXZaFfkrgWw" version="15.4.0" type="device"><diagram id="cSzIPa2XmoWb7lWSLNlD" name="Page-1">7VptT9swEP41/QjKW0v4SEthSEVCMG3aRxO7iYeTqxyHtvz6nVOnSUhTCmop24IqiB/fJfY9Z/vphZ47ihfXksyiW6BM9ByLLnruZc9xbMv38Y9GlivkfGCAUHJqjErggb+wwtOgGacsrRkqAKH4rA4GkCQsUDWMSAnzutkURP2pMxKyBvAQENFEf3KqohXq960S/8Z4GBVPti3TE5PC2ABpRCjMK5A77rkjCaBWV/FixIQOXhGXld9VS+96YJIlaheHX/7Ncuz59GSR/VDZ4g7GyfcTc5dnIjIz4Zt4BlKZIatlEQdGMSymif0RhJAQMS7RoYQsoUw/zMJWaTMBmCFoI/ibKbU0HJNMAUKRioXpXT1TP6h1hgZKIZMB2zItx2QKkSFTW+zO1jxgAjOImZJL9JNMEMWf6+MgJpPCtV0ZbLww8X5H7J1G7EdEEQFhI/jpnMeCJDrKU0hUwYOOcxBxQSdkCZmeZ6pI8FS0hhFI/oL2pIgwdktl4u9aNYsH7WnuKVmKNndF3O1X0C1Z1AwnJFXFaEAIMkv5Yz4+7RgjBTwZglIQG6MpF2IEAmQ+OZcS5k+DfHQSnlilx8p/1pnxzKRii+250eTSOBSrcFk0TXteLmrbM1hUXdCF497pd5v0IxMStKPdSAGcuWrEKIFVTlQCaiAieJhgU7CpdtOh47ipXRg45pTmizadkYAn4SQ3u/RK5N6EQEOA7lOR710ROjK8w3AGPFF5SPpD/GCQRtZpv9fHsY6wbZdt/GhzqXB6OHzCc8IYJs2c6cTBjUNh3j+uU3ontttXVDMFDOfujpS7h2Lc28K4sxvjlE1JJlRH+q6kD45Nen8L6W63zPfP+PmxGR/85eLpbEfxZLecuJ+jns4a6+pOAi4R9o+rp3aV9EpXTf2ABcGe1JPnfjX55Df5J5LEnXj66K7a8l3oq4in81a+O+l0GMqPLp2KGlCF8wuqT0nHus44JQkeY7qkI/H3qNNSB0iBo2spu1mgumcpiOc8C/SJf6rJJ+r0vz32i3leVVJ6816niy195lNvP6LA8+o1FXvXbFmD+0+XDTW1alHFmuv755PspMLHN4025f9VtIK9rbbmNNOgUxAHyoTjS4htNbdOMhyC8+NrhmbJrZONn5sD66/9byXBwcoD9uAt4ZiXigb5dv6IqTAI9VXbGziTFJWCW8F7gIFichvzueCrRL1OqOZMl/PSlcK035F6uaxduTl7ek3mOf26pttE5GADkf33E4nN8u133lf5HwJ3/Ac=</diagram></mxfile>
\ No newline at end of file
diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_catalog.png b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_catalog.png
new file mode 100644
index 0000000000000000000000000000000000000000..e1b4945873927361176edd655eecd33d8744cf79
GIT binary patch
literal 5773
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
b<bNB;%Kw)E9Bgp#J2-u9V=cnndr$uX@?<#f

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_diagram.drawio b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_diagram.drawio
new file mode 100644
index 000000000..b72fcfdfd
--- /dev/null
+++ b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_diagram.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-10-13T02:28:42.707Z" agent="5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/15.4.0 Chrome/91.0.4472.164 Electron/13.5.0 Safari/537.36" etag="zl1XbJTwD83N1LPMQNew" version="15.4.0" type="device"><diagram id="IQx40WlxW30_obFmMH3M" name="Page-1">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</diagram></mxfile>
\ No newline at end of file
diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_diagram.png b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/resolved_profile_diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..31099250e05d40d72a0b3d33ecf60bbdbf8085ab
GIT binary patch
literal 67327
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
Uu4aeVpaGY$k@>+w1E;9J0?m8YV*mgE

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/simple_catalog.drawio b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/simple_catalog.drawio
new file mode 100644
index 000000000..d3e2a40ab
--- /dev/null
+++ b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/simple_catalog.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-10-13T02:22:04.080Z" agent="5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/15.4.0 Chrome/91.0.4472.164 Electron/13.5.0 Safari/537.36" etag="5-gU89ZHjX_ICB3WgB1P" version="15.4.0" type="device"><diagram id="pAYV7LlPNfUgijbNdKD0" name="Page-1">7ZbBjpswEIafhmMrwFClx8Ju20O2qZpWPTtgwFrDIOMkJE/fMQwhlCbKSqn2shFSmN8zZjzfWLbD4rL9onldPEEqlOO7aeuwB8f3vTAM8M8qB1LYgpRcy5S0UVjLoyDRJXUrU9FMHA2AMrKeiglUlUjMRONaw37qloGafrXmuZgJ64Srufpbpqbo1UXojvpXIfNi+LLn0kjJB2cSmoKnsD+T2KPDYg1g+reyjYWy1Rvq0sd9vjB6SkyLytwS0G5WP3fuarf029VGfWt+HZeHdzTLjqstLTjmhivIKWdzGArR7GWpeIVWlEFl1jTiop0UUqVLfoCtTaQxPHkerKgALY/ozxUOeSjgsDbEmbkTj7WNpDm1aNDn+7A67y/pibcTxyVvzJANKMXrRm66/GxgyXUuqwiMgZKcMqlUDAp0tziWcrHIki47Dc/ibMTtfjhChRLaiPYiAe/EFXeEgFIYfUAXCvAD1ofQZmBhb+7HxvIC6pbivKmGFuLUzPlp6pE3vhDyF+D35/iRhAYb6M1aAFduZjWqoO+Js4KSxJXMKzSVyGyYLZ3EjfWJ5FKmqZ05amqeyCpfdm4Pwaj8oBJYCTA8U93+KTBQ4AxRDbIyXUnCCB8sUuy+D50Qc43R9kYbH+uuDS4P0+eyAyawafbCNk6kwWDfb04tfRPtyztq3gIDcvc25Ox/EWdXiPu3EU9FxrfKvEG/FfqH14YeXIHO3rb5/Yl/fG3i4Yz4WpY1rtt3Lx3whL0w5XBUD2QTLIXQ19h2h/BZXafILBW+NdD0p773gubqrhp9mH+nUzgYbmjEavEPVuF9WKE53u+6sbNrMnv8Aw==</diagram></mxfile>
\ No newline at end of file
diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/simple_catalog.png b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/simple_catalog.png
new file mode 100644
index 0000000000000000000000000000000000000000..af519685bc28ae01a7e9d0db221a3167717f70ba
GIT binary patch
literal 2771
zcma)7XH=7E7XCn)aRh9GU>FdUK}Hb>`9LIyw9q8dQIHbq7ekk(G^vY#5z$Z*2n;nK
z2qVhS5fKEDk5EmJViai!NI;sQF0*rX_RQJ+vG>P&%el|F_c`Z1_enG}F%aG_z8?Sp
zVIxC~1px3-cH<BG_Uyhx=J%<)ZZBT@iZ%dLJ`mh=7TC>CxEfkq0f5lc01y=i0PDM@
zs2KnVLIMEC2>{S!01)$|)|+1h0DdJitd-u*&W^f<=5E{Y%;sArTSHsl#u4iOxK#K0
zow3=ql4q}oY5BgvQ5UuJevwn?8sfa_`IMep(c1GV_FjhMajCYpw!*@~xw$zT8=Ik_
zp_rH$MMcHc)m1zm-`m@J?b<a8g`%&oZ(v|BF)^{Vwe{k~3u|lZBS(%XDJl8;`?FZA
z^73+3RaGL9$l-A6>+5@ZdO|}(!@|N65)udmf|Qh0ZEfxF@UW++XH`{IV`C$O!4MV}
z-q_gq`0=B$v9Y?k`sC!~z`%g1sp-tj%;x51e0)3tfoN)KqEe|cGBR{JoylZ^Ao$?H
zgO@K~>gwti7Z<OuuXl8Gn3<W$%gg8F<TNxiJbd_2R#tX<d;9L)yBQf7T3T8T4h~<x
zel;;MNlQ!P@pxCSUUhYK?eFhjUS3X5Pyh1e%fiCK{rmU7efyT3ot>YbucD$-QBg5J
zKW}eupPQRoSy_q2VuON$&}j72r%#iUlcS@fJv=-}B$B(kduwZ}ot@o{8#e+10{r~^
zyu7?FT)2>wloTEw-r3nXGBVQF*LUX3nVUCnE-o%QIyz!7n5n5LTU*=e>gtk`lHlOr
zh=_>p?(Twu0ve4L5)$I(=C-o3LMD@AV`F`Md?F(wo12@9ii$pb_<+OV^78VmtgK)d
zj*E+HX=#BVh|Oj%EiJjYxR{%pJ2^RZb#<krq;R?1_V#vPUtdj4&9bsG3kwTLNl7_5
zIZ;tjXJ_Y6pFWL`j|U&>Jh1y+_*{$)FhGKUq~UJzeW1}5z3->?@QIz0<`TN)cPqad
zVYIDo4}Zztz>%yaqF4unZlsKbv+C?7l~3B__Gh7RsTOgDtrpLP`HDo+8dFu@Dmb2f
zXaUOIfBNj+`>|&mIHnp`fTr}*cO$9OJoo9bsaamQRP%Hg{eAL)^6t$4$7;1}^+XQT
z<Vp*hTV2=}==2>(ZV`fzu?YCzp`{^|6rq!v8hXvWMzleGXNE-Xyi0Mxg_xW35(Hoo
zBEs%6A+h<5V%$R4-mgbT<lSji7?nY}qs+V?z@08E!Kg0lTus^;V-$WgU0FKfTXEXa
zjm;t%a%U4_XXYQQ^Pj6XWoo*Zg=#8KcuJ%i>Y36*9;b8R3-Xbjl9veO`Hd1FuME^X
zdZ+ofp>9Nt9$lnu6fO=g@fatY%X6?NpWxln--HZRsr$++tn%jlud@T56K=WEwAO&L
zXKi{!awyLT?5w?HXO__4$-#pzp?ui_<mBXKYM$a>yyIUS68@7toQf(CJV`8b6omKD
z90c%tsqu$jVdvqQPr0Ir;_t~ydm(>(`@?(}#Q<6HM2xOZ+$r<JFJwc1>vh+i$)T7n
zUxFv-SU*~pWXsd#6WJJP)IB%)8$lUe2c^u(*F>=(4e`F^p>q@+i+kSfDL)jI6~4kc
z2DGO@F(70lmV<bo#76ldNge1P6TWMt8ma2iCn9}B#UF!gs00kb^~6yPR8*gLWAgod
zXl2C9Sy|5U8UWlY20Kknf#AlrT3S9Q+9OQtltkl{cc86E$0-YG?%~L%s~kIKchflf
z*m)!=2zP1;6Mkn)m&RLI$+AU0_jlGk<<>6du<?bAFvT6Y8c`5#(^&X;z1bJ6rWio&
zQq~V1v}Y)^!f`9FjY;Cp_QjN`N%`{mLfpl8N+LM0TDw*2GWlaN&8fBtN=wk>4RTZ%
z!^J;Yhch)uRg9|QMl)vc&wAkzZa=%D8|t$e<HA3Mxs8P~M5Y3=CdMXoOg{JpaL*cB
z1$iyPUSn5f9!UmY;e=gMxLQ84E#*3sD%l-8H=35C)v_SCD0YimxjG+K@0|QQjy+VP
ztFc(<d3q>y&a}~r_Z3<@SYDl8Jf;}*GPLNV`LC(5pYt92HaylUm~b+tb(Ya`sRMpi
z)VYp{^q=Cl{d~ao?(F(VvJ-Spob@#B!q+J~jRGh$*<)C1q>?Y~K&*zv-O@SV=77yO
zZyMLh=IA;@)OP|^aqN3f)8ib{L2i;|g<(^v{+0^2{Gvw|;gWZC*X-H@Bg-FV_fQhP
zK=f{rBa{Zpb>$mxRe#p>T860vMwQmwoI&PlpY89$a`A&3oHifz!Ip&%6!rS84Appq
ztMxDH8vV0GXV!49DA%%vnc4H?;xIVGOAzmm@1zhzESn<k7wOA&5QiHD+vr7u)j8h!
zw_KV=eK_NzvX9z~)So=E+!YvyvdH?H%fw7J?_A|#BRkX9J7Ru)@Roey@as}3ka^;r
z$DPV|Dz1@Uhb`|&fS%VbKsv!C!ivI8x9_}v<cP1T3yUkEE?H;cX^X9e@S9J%^W{Oz
z0_7hQ)F2_4sJ&p=tiGlp{TZxAOyjnbe%}gSijjC%@v-fuul?+HDEBpoc6(N})FcF2
zwPPJm)ARZzfG*?=37JUj&?%G^VX5D`-P-*)*lbBo^!Z|Xcw}%{md{Az3Vd+NkL9yi
zx8%db_T*;!SKltC3$2>rpUoI^3~riSiNvdtyRtxvx$(xY_2=!YbR`qxC$Gy`yLubf
zt)&oLxP0(+kL?p_%WtPW@g;;<1qDNa)fjevWp%XNG}IbG%^Eut1TFQvx`@-<5$m%q
zb4LvvX$V)N@p~LJy*IuZdfHods_XXTtN3~z&6d=!;Dg-IWRESDWf}-oMT~ri$SYd%
zA8TaMM+WNqR<NY1!)i|$VDnBiMTru@_OeKy%Z|9N56<QoUEQuTGG^^DELGXs7rn=W
zva^UQ-CC1NV`OgB1V=R6dP<<m-#unnzmj-z{6-kuw342D)_ih~55p+ahzj^{?jZPC
zdVsNm=?jNC6=0Ec$~sqc#GMleLi@XjKJC?AnSm=EXtjI#3_PEXP8+{vCzg{ljrAQ-
zI|x0yB$!*qRlDo6y(yo1*i8b@mzr&KSsdO}7ypbFbc*C5Ks6MY^Bj;CS0c4iJIBvO
zVdaFux^mDqTcB6gH-jHUOhdL*0diHI5XiLYaSITAxowzKhX@16|Lbm2N^XoE!}GmC
ztm`QMM@jl#{;4aY6Mt;vv~PQjXP?=*eoo8JcLK+4g(vh}!|{AVCWHwXuBG#*fOX1X
z@^c_mJ4da79dJ5}CGgSBl0J(~Zx%!nSm+LHd!4Q5E*CVNIvJ`#ddKBI7K3g*4nQ-4
zf9Y4AB4*FOZvJT^ogclwH}MZ${(mg$af>DjnbI?_r*wO_UnWq`CeY0}&>ijS@4o8*
z6cUA!M}qQ5B`Xw&29?oDN^(df8i`Dd8T&iH+t-Z%h5R=Fsr)AZx^j8zkByA<OfVHX
HPBH%ku(&>S

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ssp_profile_options.docx b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/ssp_profile_options.docx
new file mode 100644
index 0000000000000000000000000000000000000000..dcbf91f9cdd3a6ea80cd64784bfe52ec70bfb4cd
GIT binary patch
literal 17256
zcmajH1wb6j5-yAecXxMp4-(wn-QC?KxVyW%1-AeJf)g~jySoMWfpcz7?s@OszhQfK
zdZxQ)zWS=Vx2tPqC4fPY0l>k*0VbTglmY%oP_LhL?2RlP=xE>a%E@kVU<UXPYaZG9
zsU9wkN`i*<9U&9xqF%l+BPSoyB}I$WS65^qTV<8IahdLScZmv?v7b8KixY6bK+9YG
z!u<6PdveyCZojk#OEsD5m{u1GUhL^t4M~586pp>~O&Jx{-c2J4w4ZXgP#<D|L2q!I
z0$y)5JE4C%^0l5+v#Rv}(m++>oE`f-7nvofL4yfHrrxjE7|%Xbs9EeM=x21P*?*r<
zBEhs~H1TkXf8t@X7dzUm5F<g$2?;9UoK;|ufwZitU<j-B^W{RYcm#X@Cau71WAU<k
zFpnpCJWVJ(K6~B^P*wsAeB1s;aPRf;Cx8F|WdEN4A-rB;Xk#F2Z)58~XJBJ*MC)p0
z=_Nlb-AfPOeu)x$TAKM8C@fA9Xc{RoMjd3sIK#>!jXkMjfAh3<iWIq|`FJeCL}!fj
zu@$mWx583UIuC&eko-r2e5L(GT}qG(am{z7!E#}KX;|ICg65&m(n1Dn^URpg;x&Fu
z@~kMFWEO&%^5%V*=GG$8x!5h1lA}KgjfGgyusVS-nVdga@M+s`O=AVQ+Y*xv%R?u%
zvM8CzLPDZU=S)nRBLA?V@h?5@1H*ABsvyB-)=aqB%30Ci0C#CyHcfVvpYsu1HI})w
zo|dKTq694XE*)9W10X^UY!ZVzd_7`uan_s?M`&z^EleFT?@zLS$7yuLli#)C(QB}j
zqHo^30CK6EcijVcn}%3HFQ3n4@*|cPAX!DTQoZRBNb!#Glo)ucTHP+3$>pW+^TqQT
zH?6Lh!!^XCPb;zECVeO>!sQgn;Jjl8zsmeq<p&#8!6vO4f?KP_n@uDTToX)0wES<7
zQMP!`_vw9TZvxw`Dxk3k1OV9mp8|vbQ($_wwr}#vj2*V_#fKNVeS(BC!ZKisx`Zb^
z_@pIdRoE)#g3yPQ4hal|NaCY|U7j>&#Nu)?f`R^hXL4u{dKRJ*GNB(LjL%LBLJ4iJ
z-ZPa}Zi`z1C0?E1uWD@~XeHLA97dJytB_xgrXS|%D5k*xmT78uK&8LKbfeKnQ4Iqx
zZb;biv}|=*+*LBMsPzqgC0VIa06`u*ubY=Z<usRDhqeoIpy)V6b)r<ThXp5b|6mY`
z29r8unh7D)ivU8ne$nn!xbR$!bF1}ZRtUNc>a2l%L#pY0`#bfWVD4~X(BQK;yfs{t
z!L4&*Ll!9r++NO$s#SKWT|30F$~8KX6*ZWspsJ7f9#&K$$sFBYf?1fx7`M4uW2g@P
zBJNwqfi@qZHvt(mj5f<+k%H8eHH<MuRK(cqWB8$c1bp5#g^Kq$oa+^MivI~b(x1Q^
zI5{}lSiNIERtwofj~uwZTns+Hs0bE2`6Zm4OYt^lr4i7<=DSq5mj{vmNmMZ2N9ie^
zr%x5|^9bfGbW{`oG%&DaG&WC#>|))6Yr43fbGAQFw>i&g5`l&c0)|uLTW}O3n-~5Z
zTZ2jFFrXz8vXRfSlV^?^>q$M@0F38UoROOkM7k&R<hVaSV0n^&HC#QtTd^VVu*&x~
zS$rqd`YeEN^6OonzrOz876AM8tc#7kA>Chg^3@nPSs7V7zCGK!%^Xc0m;Ou-AAI_V
zT;M{X;Iz#0RXbu(8|EWlARy*`_JsLTQ&VhY-C!$2P%pNLxX<N}-ek$n$B9oDQTZyf
z$k3A!B&Ozz<Wnd|E$;0LHCio0*|sqR-Wwj<o`|RDIyE0bT*h0fJ*Fp%XLCczDsdX1
zYq7ab44){uwg`u3Ju^&dE{K`t*+8*wVQLCE*?&niT4^Y422`#xr`Z~V+^*B-M2FfR
z(IZ=yO{MhS-Jk0Zo{JCYyrfpu%GsL>97x_`^|Am4VF5umfuPTVpr3%#TfY87(DMlc
z>dT2eqxt(&`uS7&`BVG()A;$*`uWrO`P2LPGk}5`KtlE-BS%n>qbtbL7pYFCRI=p8
z(e*-awK>_Xt171AehLX+^xWofre&lyAAvs|(_SynNVEN{y8X*AlbZLPTPj+a{+zGe
z3WWV%GC=u{46KX{&GhKZtn^Hb7-(&+O^#K(WEE6UqoEsA=e|zMs}Bw2D2sfw=%d7M
z#-s!hguf&JLDZ^HBoc)Bj2S{9pKfKvZ$y9!8V2vj9p_8Hk0dsY%49J;tsCO&NiJ~?
ziil4P0`3>NGB=<4)HTKH%ydb5`gGE=o3YB#<+19uN_rfrcAd1VL5^&W!ph2t5vYDM
zQ$B3e0$i#Rh7#3f#4*UwChISvU9;KE;b77uja=5?xZRV>hCNOt{jF##M;2jEWv&h^
zZb2V;=o+8Zo$N%SF4srNV73%_dwM!}qX|m=7R0e~ywzpzAz-ts3h9_4yc7NDroV}G
z<;C?rw_sx6N97?9Cr|cg=LQ@rD46DqU+iZ~tx!L*Y-}`LE`C*2pLSl#d{_@pcGOTE
z6HH07l%UWRl5%#}tkpTCZJ;7z#2d_%^Vv8p2hjj$)!#n3YrP;V@2dWZGx24;BL@$B
zFch!Q{o=43t}(DkpXk)n`^z!m=7_=QE}nYEVRQ8671i?^#MQRZQt;LGOT5eROPHTw
zab$r18ug&DNGWl;&1ZzrvX1#tCNixmaz|m2L3cbDsnvE?n;AUVoO3T*&pV9O=A8yB
zOBO#jo(z;a6p?QVy-7QUeNlPB$TA|cqq|Atnrte2$!0t(Q}_6@<eMSeA}<xOCgC*l
zNhy%45db@xp5*bWy>mxW#v}}zedlKshB?tW){}xpY*r+y_g8R4OiVahBSTl_r$l80
zqh#GyQ8gg*_vQqm?Si}fvQRAD-Ej=xgAV7mwmM)vP79cO?fZETg)}%BGGow+Puy1t
zB06sq^F11<a#<Tqi&S`hcT+mbwD<E44Aa`(I+u9MQ76~gL2O3pMW0uuBe92}e0pW-
z__G)aA;-~uu38xvC+?-T3{T4JaAWxhl)Z*rgVqA?V|=S?;dUr)7?3XH*QI=?Y$al<
zxj$F$=kQ^-57EsbWkG@glldogW}yezgE`GR4DvenC7JVQ9pyXVeJL?NVMhMGZ|==n
zYtFWbifHhtD?brcZzODC6GOOp$uXN2WRHhH{z2Wyo(K6$fR@1*#Sau`JIFNIWMMSN
zBA&46S8lGQX_OQdEmjA%4{)QO*s8{EA8+AoYS*cawYl>_KD$#EpU={LDV17rLAqaG
zlDngeA~C-E7*5<pZyacE)_Ts5o0tr<3S!7;XwP8a(_&W<=az^-rVTMpaA%ZVfIk#q
zPNX^5PLg<&lwR#y)+CI0{)IG>N9vn-nKTnI(}$R56q}8v4c)pNk-<gZWF^I60G`1!
z92$tB>zT+oGbD&<)oXnGSvEIqo39e{(-;kn38H<F7Jg4QtofagbVhO}S%+OS%I5vr
zKtMbnKf{ubr9Ii!vMk|`L~@!)3o)X6TO$R*Bo*5VTa7jTN>9k2m)<%n0O>~>N374H
zOop+60RdiBwW(%zX68MPZwEG3lN}qiR>t{V+;{L-7Mq)Rd!@f55TQ4{li2t-38Ye{
zdv%qb1NTf=_@C`sJ-Uflcq$({?#rpHeL7AkzFHkaJt`KZ=(^Unn8f5<ET`JWMpOjb
zEz@85<%2D6GOv6-!&D~!kYU2OTXfQfsO#nsZFaYS&#;bXh?$~iLBY*pV*f(wlWR<I
zD-LR;DeoGEzsy&7ipEQ2H7Ofe9qzy_(dTVihGNwuZ#zV%1*B%Aelw|70sn>X3rQV~
zXQ;ybk2K1;QEYI<qrtRITr3harcn}i47gcYGT&tUyWPTv2>M+}@#P-Sm#YmLP-2P1
zn`L(#Q?+OlP!b0{<Z)H%Pm9a2-(Mc)m(uJneXY3>(o7R7_H}^?CScm~P!W5xbz#T$
zeJ~(gi_3kf7k+Fx;6n|cfhMw=R<OgRTQ1G4ogofoFr|(fF1u1hlO|N0uHkD73wWWi
zxvt)F#hRpEoXT2Ld>_={be1*%cK>)H$8RCU^EABky}KR}%GfmD8F-v~!t0lDC`#O&
z3o`)OWP8ti8Y_))$;D5t>x?{QaU`D)Ox?y)Flc;X#-mp#5UYz6v3Q9+4cfeUM2HZ?
zV*r!)jt|ogNkP7}=J>N`%%EU`0aE=>D<&i1e69xZ@dJ*?_6f^YH$~n|S$a8RS7uF!
zKP@;D@PFkS@HW#XR^Hl~?<#E`r*3cU55bluq@b18Ms^u9;O^CrN73C5l97JqGC6HR
zONtlqI2NHswW4tbGW|3?Q*KD7r;;E3aAw|V96?O9Q4zW41r1taG{Z9$k{xz=>rMip
z|G>V@rmWD+$-n~=C(&bPOZ<~+FRT2Aj$Nv@bOQ6^>d@f9ilaO)?=Sih!5{^kJhxfq
z@#|A^gvD>}A;Ig=$iA3{Sxdd0qXguW&H2cwV6k=MZ9m(=S-*pm8>H7WROT~C)8tdh
zrxsrTv1oiXw|br*p9_tfl*22wE)HfMKJ1<AU2n-bA+oL#V)XYP!I6q}TT7_78R;$k
z4)2MpMT{Jy&>|idF-dL%y$Zt=LlA(~Dk=<(U>*eeG}ZnwZ<4nIT5gB{<<Xf~koc>@
zazA}#uaWM<DdEEr_9Lqb)cMF_2@}r)E)Cw$8aN^#lNuHp6LU`C#R#WfG=;B5JR`~n
z4<I|yk^-x-Zur#iN`|}<;?Wfz-5XIn{L0<#I%I^>!NF=_M3h>V$S-~J8Bt(qB+^8;
zo6W6BM3m7dX@SSi@${MYF*7vqBeZ7U+;f&bGdlhVsUE!Y1QQbfAhl((e4BpdRfRt&
zY+4`g!70K4B<SB5EljE$5w7}cDh{p7u2lDMKh{I)QL6C(3#d+^pg5LgreSbEY<swF
zlXG0(i3T6X_#4Z}gt`?W?Xhqbo9V)K?(Kw7)wgduSc_|lwsm&}Q$H$5GM@NMOxj`F
z69iSS5*97vj4C}orLK{S77j~nvbl+L^>p|V<p7yB+-h|pVI<9;3aa9;$A_d52hs-e
zGE8!MG#hx~FZLE3j{zr$4$h$O^Tb#RwB=t(S_Qp$KK*3Uy*fGHwbq%Wrt2c=E#*r@
zyk(ptq^e4|jU)OFb}ou1(}IIvKKEf_u1F>TRU(SLj`1M7ZFmSI#8503Rz*-^*yYKN
zljD2XD%Sy<T3)qNvK<KZH*xte3`SFi=Vi1AE`*XNwyr@*D?2`yR0LrBn{GV%Ppf<3
zO9LAfDt>g5<&aE@ko?cf*ap!0PCo;@9vKA#vXXX4{YME1zYGDMTi%@unt|&cdo_SC
z8E*dokqK;J{sx(hu|o|HnU+myuLkbe+zrU@-!I|)<m5}#+BG#S_8l&Ww(?lSxiOB*
z1SjTe$SN`&3E|1OR+KI2=9B^(i8uwgV$z}gVHtCg!}uOR!t(=w6fZ9I$c~aK+U_;t
zZARH@bR<c1m#rAlsMPG|U*65_$agPoyay*TFHsNG5I#G}qz6cM`oA{7K)ae1`<K$Z
zUQqm>9Bsbn&UG`re0ckwI7>FO1rG@TFbwy<rj)NI|C-i2IJ#LHIlN8hk2AGg7FiL4
zPH$Dt_RMby6G?{aG8LKzoHv}tNK3Iej#&f+P-l^IK}*@ks&(LrNn}6CV%yGI-F#t-
zBpCe!z;p`m>3nk_yQ^wr4N9dnX0T89s`m%}nix4zEVm}~$JNz#PAm|!{<x4n#&xs+
zlPp;8=Y1RAj~&wWyD7zfjWUySGH3xtNtHTq!Dh`{R7ubHbKF0&X$sV9C0|N$gJk4|
zEJ!|O6=8OT1#jl(@7wkXGM3QiLjY6?mKai^&BNtt!ffjk2w2N5csd$BH-u4rr97I9
zMNx=Ozor`1sFxfOqOLQUO69MC)amjNEzrMIjaI%jIg7`&Ans-J>}It~+VLslQhHW<
zHhOj;il>Ij(ynJl-q5!l)n`!A&(TOq7E`xbryiwM=r)hkb7w$T^z~TwSPn>>$ZQ!s
z4!1E>zDx`;uMtLau)G_jKed05@>z!pr~9yJH)Ef9($q)oR<huFad6?_1<<;GNo|vM
zc%liN;?B}G0u#JF0)4w{(eaYZac111%t=qnmfG&6P3Km3EK<bU4pJqN6NwIV`;B^2
zjFoCb!Dk5V)adSezFHA)Gdea*SpWFxNkWYH<Fmf4w>In8o%m81`9|n<pCJX|bKA+(
zZh}bLjgF0^WFk!N67j?8K(PW6qa9|)6Xu0eQD7mjl<J9ZbPIomj|Y)67~9TEscydg
zZ2D1h#`X}j@MDMrv;I<uXyrN@*gV!FxL3|*GUvorA*|ztJXl)iw4b!j0iOw-Q_khf
zwVxp3d37K>mn@uJzhH&|;n?R82Z3*?h<4JU>?VR4RdV|~hK!$wyBT26Di8!UYlz|P
zx*_?#fkI@5KwWSlpcOa}(tckN)QqWsXzo*{axFGWGVCyeqNo=%=Kg*+_spDRipnHK
z-0t~fGt4jsB!#d(5z5X+{rku&zCddgwbtAvb@d%k3pnbAUOrXq3eN5z8t&l+ldfEX
z3acYuUwx$bp1%4ys7mX>Zi1f_Sfo%-fMI<a(zl&7o|sx!L<AWfA!0GeMPK7|%hYmV
zc#!L`Kykz^PvIoImGCbwn%gmJ=12n>A=j~_-=NEVtaRz0B!C0<buiE+UwXb?V9X#V
zGUugInh7E)PloJNhRBq;QJD!|z8@4^XE%Ao_IdhXF&=oIoNy*l2=%0g27lg%;d|LG
z;x@rtV(7y~)}Rach0Kbsf4ZqTxX004tUA?5T;|mQ5o^I?9&7m^V;U(;QbiLjs;z+=
z`?azC8SycvY4HBTaZ*uMs@0BKzG<5ZC=;qp7>t!qLv4l6=VK6CB1Li10Ap%?5TB8z
z`X)h*4lTMz7t4VIy7H$A!G#V)v58^TplD{ZyBoLBMA~6ok9ccC>|rw89|$I?aY7aI
zad^>O63@rx9fqZ%fO(JdFTz3TN+%6)mdhS|E(}Nzk*h16>I?{Aj$9#&k8q~}9xY?T
zBcA%EzAB8vTVWAuSrES-Pd%UE(qOd@2-)38F^@@p>=OXDp@M`<^2Z?{h}kd+5sJ>r
z_CBKdWJweeVlHHE^c50dkP(jkG{;deli2Me%k%+v{uFeJr9j9_CrDD}ftcd7K)*cl
zGTQrGdXf(<ItKkzH#l-HQa^L7136>+)C9qz`9kA=UZjnCaYuq~2{Y$Y!-74dTWye3
zL`aNf)t8TH-ItGR^RiLBHK<zFM_QEr6;hNn042r}(x_dHgkn1cCffFEkO+@<PYeUM
zzk+?xtqchvqX{~CA{lhV5X=YRZD3#`C%zXdM{3oV;kV4f2@?GW>Q{fcK8*bfnJcPj
z(EKna;D28An{0qO)K{b_)}ggAiVP+M`>1Keo8=9Pk~~NRtNp+H5Hj#-OkKojFVfKr
z<u$)a)n+b_Fb$15`{mnToO(*nHe?9R)A=*yQAZULb2c?<*hUyV={J5d-g%B#(P|D?
z`<~1g)odS8+Mu0PsYbq5I(5RE)Q$!>Or1j0Wb$Y=a<!LZq*OCE0*hB;HdefeS`WvK
zn65M<=X!l~)!fF=Ea=S1VcEVYHcc(VsorBC4X1J9JjgOU6_s?BVuC}{-PbwA%G0iQ
zP|E->y|`hbvB}|o`sF(KeyI7p#>($YgC%75R3mwr7)dj9@2@$ay-e#gyG0kI=tbOo
zLN-t$GPc6{s-+NCKd%iP!3Ec-hp(rri{)f|E7^`?8C}+fAH0ijUAjsSGgsJ2DBv(T
z29|xA%ZxB?xt*oitOa-5H-#Og`K$$tCAXMG3W?bY9jxt%ILRp3fHEuB!hDC7CvcN1
zb2?-i{gJaRXAIERgdJC4n-NTN1whnGc$^`vLBvbGE=iQc_@hz^<^)2%p6P)>moAyW
zB~vs#B~lbUN1!bDtNg77yx;p}2Q5u5X&w+L@)H7q;9q13fM^tL9|`6Ee`-M@kmmw9
z(B%q1{%#2J1WXtbWnuF(<gwRhNQ#dFfyjR~7s3aHLinH7NfdQYNEAi+e;0Mb+=%81
zcx1@tc0|h(^ojg=`~TeLXULI`*GB((R`?&N+1oM+Rl`RjclB9gR5u8>_sE$KhO0wb
zT)_)CO4mc92i|l&i3!pCn~}i-1Iq;ZxKL)&a=gIM-6-%~nu{)Xt~~wuhq6N+1S2*@
zYsfnV<s|IIjAl@7i-^c>@r|NQG~HDWlSy7y5;f4$3vpFHjGW}cw4;3OG}3A#L|`u)
zEv-^}DXfQoBoSn+H;!0h^gvh-4<xON#gOfK9mYppGB0cEK!RJXn<7Xre{QV#+-aY+
zczVRlmRo+i^tsB~5lQyhQU5H;DSrajIsca?j8TwNLznC_NJTk8_wWqB=Bateg)@ub
zeG4Y3@M{_1q4~?!5vgknrtU8-7`c_IAaY)n-a_a@bJ4G@n20r1CoT9~49~B{HY%SI
zvdh<ZV1J(q0-;j@j_4{U7+Rcx-`+KsCCS%<flyWX1T;Gnv$k#Sd+x#_=+=grx1eb?
zmUpKjk;Gw*WQ?(aYB&s^oI&#`+I+C?rXq>j-=qP=Yg>h8Uiz{;$@27GNum+!sf=Vz
zrpvtaN3Hjae17ojVN<!?jC_3gQ{aIL4ND8A3Jr%=WO<VM?`)~6Ur9phuk1!<%zGwo
zYNpw|bml+V;IX-8!}Qia*+CXmole8_!CT2&w&l!HrEYHjUzvUDYex;gvzE8s(lq}o
z%XsUu@^^;!B^2KkWZJS%5p{xx?j)&jIO5ueeSKH(T(Mur6?p>on#Vk$w|L>O+P=|E
zF8$fNXqVatsMV=0?tV|puq%a<5*IRk(|)s^jQ^gn>O!KZcYC~HXLXyZJxh={`@*9+
zF+$2C*u@>i2ButnxI{V}OU}vS**0G${g;%bB-00@;XYkYeQ&j_-RP5zZKy9l2{*-E
z+FHNuuIdFw-V;*o79AbjJ`Od~qv^5GGf@=X$CexVpz7>xTayOqW&}#$nCe}x)lrTO
ziNM;Nrk3NfFCjWb6(gswoYu))AIr;d)grH!i-CgFTxYd560k@Vx8CS=ttxpSY)j(Z
zCKrf_i9IKb*YR{&aQR#nD;Pv)RP(BT;KDf;R4CQwF5TDnoE8H<?aL_NP_tx8Do8@b
z{5TIfB$7I4<xmx-)$7fi#Ui+=)|6v@^VNCwMytl-?23R)(T0FK!%ez)Y=p@yO>dPy
zH9htg%n&oZUmgzokR`O^(N3$=$Eb@+=`lCe3Vg#{Yk~@k4tG3@Q^1w^1hJ<_HT=+#
zcajt)mUSP=?7r8v%fFOdeUKFBxOu~ibOtHOMZ(>Q*W)k__edYoc<R!@lhf&zX_zg}
z1E*}C{iQvlZl^=!zI|||V|2%kq4xoAjysCCW`nL}wxU>mR;W0?x<ZrUnl|sw(a~}C
z?7rRAymCrA^`ajFeU^)9$+@oAbJk>nJ3`mzxndxmc?Zto0H<Dqr(dv;aKV}-YV4;W
z=SL^vAM#Bi$`2WqFEw=*G<#O7nqnwsaz~y9QE6Smx#-RFFvs$a4^k?sJ9w>7o^42!
zJiA71*Ja60+poUGT$SaJ)f=Xl(Q!}JZ0|19k^E7RSuyRAPRb$SlmPXr<qPPUGVZEi
zb4PA9MH7U*PczdR*;`X65_ze2jW}8yAqQBkA<jPe2F<G}FOnYy!#^M9IgRxUfRV6?
zF<;CG;GF^HUhy}Tm%!b}e0!*0ez-K@>MMOgNb>7g`rwW3P=x8&1#hRVmDz=}if!Xz
zXMm|zs@Qg|ozkR%r-B2180%Bq7^)lFB_Kehr)%|NM<^me<BK|ihbwLcj0VSaF3&9W
zuPmoa{qD?=W(NA<oAnhz=ct^)Ek{otJHZ$n>Q7wi*tJOYytIzb;*qN!S1BX;BKImg
z_W`{Z<JiP*VfQ}av8U|4zc>O6t8Vx5SDPuNyZNh~PiAJe+#hbfTt1gIW1+6jXq0w7
zmA1B)BbECU@;<%$aY~W;0l&Zi09b|muP=PReF%=GMpj02?>WQ!*FLpTn?+XSuG4CG
zN0;m4=p1RiVdr{Qvw;5N2_l*)L<4bVQO-~~Wb}n8THp_ky|7d@i?F>lKvXsQ$xjS`
z>XyrR4B{8TrV3V*q@Voy04?JlItK7oJv==Ts#n=VYn?$TJ`tN8%(5uV=_1Aui1!qE
zcdeFBUt=w1Yk_HS`!h^~aO!E~l!|1?G(rb}>Z8|K7y==kTMC*&H}6eOpv&7*fBE*a
zMylTY8vsdbk}o>zbz43HWX`ON(!nCswib0K;@G4gz*GQ!dM$aZUa$exlOEHKK^YF<
z(sUp9C;O#fGR--9T}^J&1LK<?k;jMq^5B<<^ZuH2k0aYVK)tn@gFkF*kR7$gD;tv@
zjx}FMt27Rk+hz(op#l8)DyHT4D&{-622lCj6mr`X4%w4F)9tyip3%@f#h;Bqo?5SY
z@c0<@0+HLeW4Tr@o4Oc2tw8E5f1Mjq9;g(%gGSa%h+vy2QgQm#XPz8`(9I?8+UwxK
z;sL9Z8zJDheE~ri-hhscxPat4(&C#hxLFT@?Z>y~>HEW%&<ZUu7Q7uo6db9y$m&K?
z#IxAPdUl8#vJszLboUeBBD(m!DRqu%Px=E*t`Z%ec9*-;!`AkG{Hjd$M;@<>L(dbb
z7Mz&RLM=_aUYFySbPZiTkLSnrHZ!iu-@5L%%h`N>-P2xc=3Os`v(f3aKR+LKd3zW6
zHj$$vuX`bXDq8j%Sl~en2c;zSeO<&1^#+lZ%S-$WO^lx?m(#`_H{oIo01R3MW5o3_
zhfu4;m#sJ$aXlbJnnNDIMx+*Gi3p?#LaA!snN#Hl<P@=@jC8Tk5)VL>qQj$w_K7qZ
z;YqA`As&C|&PP;QFak;Zxk(d4=v;v#0)aTKTUkB`BBClDL3J$rLa_(auQLK%<fz`M
zrQnc05{>g7ISmlXrKewsFeq+5e5Fi;moRRJD8l|G-jClev_-oX8@AOQ@gc4o11$@d
zfK=TD97ADnsgNo3#46T!+IqFOUR78=s-JR;7QZ0mD5e(A&oyr=BCaIlDI-!S1js7e
zmIQ+EH0BH4FMv3C7hb-YY#W<ZG&4~g{QY<eB`XNgtta+gA^@c!4dx_y%Wy&?$1laX
z$O~=o`nJ$P@aDI?D(i!vOT<>g1eNFgC>NK2>??|%Kp5qy3i~2^YD2^bJODn)_n6o;
zCb=5phXT?}d74lMOR8Wy)iP?^(I?4M<n0$J#WxS@+mcp3BE<Ai9y2+$kD1!9@Q@n9
z^74Ji(hw%TVOlJLqgMoz#0#PPlxQ9JU6Cfvx>(Y(ECFjU-Ff?iLFHbk+{Fr{Y30p1
zZS@TTO8+5VmX3Od!+D~#8lzgZ&5-S(Ql!ityw`(}6qsbZ7x`FhdD>1{(LL`hv(e*y
zSzJq*VHIWSOGTU-3Z3w|kW3K?t=A!w06N|oMo=3yl}F0Y$KEXT5zf?!3z8{f#L;_4
zMA`y;3yXv^I{0W<LVAQL)p=-w^m5o#Rsu<6Y4_5TinFwS55tsb_1TS%B6t8#7Fx*a
zzGm_%*N^IzmD+1GGbSA|C=jlxllAfBlBDsr$i(Jj^P;LdLbayks?(J&we*nM2*L3m
zCehZi(wPv~Nd??f9w?G^TyJ}Lw2UR)<{S0hU~YT3X=2Ggr%UF+2gR~;&j!=|oQn)v
zm}!g?uJp#}WMy>#mfp&8roPG8gkS+oVZM&NOBQ3^44oL5lmxYXJ@y@kc_K(P62LeG
zK;5o6lIwg%w-aTF&__5FVp}up8?Ce0DVC_x^L9^Sn$3h3AwoZki&awL9!@0B_9kXO
zjw!|Wf`^H20L+^7;6ooOS1Sb!4mmGm2@XN^_b}>faAa8xoAeqs4+r87{rXFgg7gwQ
zt0CDD^6+~~RrQc;sxABt?Z&iM*M#~cH3y%0q1w>}>^%^b$mo#5POI>;=PkwgIhcT-
zx|Y<aoB|aW7i|qbxugnBZMxRMXf!v>Z2m0ybfTKgrhYm!tk9N=U;}4g#&&hTwBY?Q
zT@~@AWK1M&-7v&l5i-lQNYR|V*Wx9W@$#Xv<^T(oQ}wo@de*M0);J@V)#EGL(fY%~
zyC<POH|Lh#HrbIjOUnb{@{j6#`T>ScHL(yTF1JZq-Y(SydZ{8xZF9Dm$L59WU))ie
zrm9phy&JUl6`$0L=gvFa^KVt>q8Muy?LC_oDpksoPF0r5QYWj~C|TwjHLNR@PFpJn
z95lic>AcZ)MqRC5px)LosRI}n6FvX{G~xfRVGZ#=>zKwi){csL`j+oIlp12YUw0@$
z2c2>YC2&bJ0SnBuLin-g;{0?4U~^EB2vz9QGqRDHwL<jAg~x3A)^+J~lYM{D%hfPI
zj@&#sC6<d)2cxl}Rk+GJ-gK)j2DIW26_NNcXK#DMcqLhCjhK?xgyK=WiNdLnL0{tv
zKYoJ1q!QxCr=huKCa;i1+7ID`^UGXJRAF43eyZ748#a~#Q!#zTx~n|)oT-A2F&7^u
z<;mRbvZSv`0>(ete9tdIxjA5QUCZrmga?i0@vu##g|rHCSsTQmonik1Cm=G|nEZfC
z$bWoBo{Dq?=IC|iWSd_x-=GH9Vua1onsh~cAu<g$gC1NngGs~!jH0P-biHxOW5dKc
zf3-ls?Vry%X$q|p>=g;9+Aq)UHN<=D{qg$-(i_Ua0xD{xuNx40fd3cDZ`;7$H-R`9
zIXaqIo4l_VHz;&lFVaJIoKitAV{u{3!t!Sla)B(@SOypTOs(AuN+E_s)Ea+!U>NiN
zfK~G;e2MrxHagm~wc~MH>-;kXQt*N#St12Jvn2)h?2cYr>w{?+H9R#ttZF)7eTznW
z+wm@j5ON|^CHzHu^{6)S*f1lT$5jj&HiK!!_7?wD8t!mbd}Jurh?+tNm5Gv*mV1sa
zs`^FhJlYetzB#?9Rh5mTn`_fgfn7tWwn$sWZ%EAxOCx0l=$z}11Sbr>B@qgm^1&i}
zy&wJCGgt>^QP97ZmuylUe~*Q>Xf$P>CV3EvD<-wuQ6^23w_lVG$R~Fo%=Bh2{*@l$
zG#N@=h8T>6fnCM^Jt)f#<0zRH%B)ZB8y4rC4lpO7(Q{S$JS>6=_$0~lp3!$|9|JXx
zFbna}sa;*Cax|j+#=Zg&5Pu6ND3X%_j#VO6mb*aLwg_Hi?((A3CWy4`Y}L<CsW>|0
zTnla7P1U9crm5BRjr2YAnlyN@V&G~?sX45{i%}JE&lGkK72&IIa#WYfqYZtP<N5!T
z<J%@BjZd$d^16dZN72pJ$U*CE3fPf2Y~4fux<SlSXv-=Qy|tt)>}y`M(Xf9N)m#=x
z)A^^y+_PI8GK4Z&d|6Yr*tk@WaZL^9{;7ttI23le$gx3ktT+&6Hh}|1vg*s?t0YOX
zfOAiSZnB@{Uec%pKe@ztbbR$cGNCdnLvA8N-5rRVW4suWOdPJC1=;5V@5Kb|@sn<X
zk^iiN9Nfg@Wz$TE-|E~CFUg>{pc+*B${4A%Q0gFi58RW8$~9GZY=}X5h}#u2t8+}I
zs&xWT5H`4RYuy(dXf3A2Hws1D6b}@K;jo@cVVPsY05M9NQ5;SToy}puV;vrFbk>8n
zCgf!P16(u478{{b1}rTv27AJwR5p%Z(-d$+kyYnGcY6M=e@FB#*)DH+z7nwUWq@{W
zFMFb1UW6@Tq}!t%jlR1vFJ-#JfgC>W#{+ysT^4Y|+_zvU(B}&|%+(cWz*A1sto-`m
z5-ayuP@tWoj)y*qW2laX6P%t;;3fCrfi{_o2p<g8Ukpj#CFd*%*zfi#x%gLG_y698
z^;-k~+<<kQdFqh&Juj$hwX5giv0@{dxJY_u+S1s>rQG;d`gkPk5(5G01m6~LbL-c2
zF&2DeTnwMc;uw<>5=yO^>B{c0_1QJv%dgrqE*I+zS3TRA2JZtGF6*_=OmxjH2hUH(
zQ*GhaWMap<#*cby+D@m-1&`ymFPG6X+tiLpP;8=Hd7trHpsQPl*_$OZG+gw^PEoUv
zg2mWnRyo!;7&FFs254|w`^YxRPpr~}lRLD}bF+KC!+i6&q}Tpg>WZ;?brJ1J-8h4F
z^=Q)Z^ZHnEnyuwJ&roY&Sz)nD<L>ZUd3^qWGQva-o6|Zj1i1F>@|f0=jy$~fVf?3_
zn)H3>9*0I&-;KFNJRH>pgO7uPew~V;T4c5$OIUt#BH>W|1J|}!M+1?I!h%%Wq<3Vm
z(HB~)b#4<IH0NJl7=uKpp{SYeoyjXET%Dx}EaocZ%LcO*?Uk1Um|YdV{Ayo&T7Er|
zf*W`oK#_!|Ic}Xe35G7;3dl~`I@94zmFjSNhK7^rOnIyxSJ0kXzLY&$9F2AkGWO&3
zt$W;d+kIxNu&!3UUDfBYi-UWJ4`q+g|KUa4$oi<aYw;_)o>s(rByxEC33uc|=7#EH
z;?fY?ZWi6gTf2+lwW%5n)Xlb=qJ;4quV%?%pq&*s7v)a3<A-NF=S~H^tGiiGm#m#r
z^{4Q#+hV=6pzr}+JP)=e8RUt@@`w@_bZ?zgIUhrl!Vl{<yigY?i{L#z+tn4;&g2`!
z9k5T^gyczg&T-EuRTjiLm8&Poc;8o=Se?kRR2xe@-HCAf2Etn5=*BK_+-vUgcuQ0{
zF(N3F)O)*Y%0dPU%(wlN8eADMRg$<%%a*p<TQT#?%vGQ4wilFF-Mbey4<2CpmD0Jf
zluue%s<?~d%Lqy1pNl}}V3K!eFwkf)Uv^M;b)AJXqw5v6ZmJ6vJ2SnV`}SkejzKQL
z4jLcQecE<MSJZCSs4G66_RJsYXqeP`?0#6R?py3SZtr+<@3@xnz*6tJbaM$1g1P0D
zYd=2&?(@^cV<UTM^S(Z%AvhZLyq&myoFxjb(s9_UK;m({K!2iM61rNw*lc!dFm6P8
z$lWuWA7(yE0>_IS1Dne~ih%@k;5C9e?h&Q@>V4aNYwho~xo3q*HS~-;j>kNlJ$d%j
zo|DK1r81`%)1R7Fce~q|-5fYdollP1`NThc)AYDE3ln#(Zq}|@jXWP^>*%K1{*{JU
z=_pH+u-zsBr=gVU0n^$J{J5pW!R;q2EqO<gZDjk!RG7OGZJYE>(oLAW`*v=~p}2Qz
zLSDs&C@%qm8RR3Ro9)Mhs#GhQvtM<f9A?_Cla?--0IqKS1KEN^g8?>VQM+1B)mE$N
z{o2M}c>Y`Kh-Q9xh~wTh69`0U0_clA)$zY%ho|hlGI)(%E)u)i?A-EDl*FIwwdv6-
zk}bb9YVR!0bHvg(1i0Wmd#f_l?wwZ8tF4a;9v|N=&%s@D(!up!I?K&vA~Aa5{e)se
zIvO@5=E|P{$K)q6Er=0bXN*iT1I9J#)%6950YK!F2Pfw6q4|c!%oms8A0P@3LC8-W
zC>XXO8`3qHLX-X!{8v$8KqD8McAs{uahxj0*x<$UYy&9sO>+1s&2qtD`;;kk4<9->
zupT9Xvkl!ZO!p2;R&#kL4lGGO3VP5YOan^0DKBv$XG=Ow0$<^$QirNdKuSK)k_7*<
zyH5W6s;LktxA&e41;duH*lZ2Bte72WZ6v|O`5?#vNeVYP$R5)SkcbDXCwz%xK;rn~
zCcP(L=sJF89*;9M_@O+J>4H}HChDuscj8qk)|-#ee5ip`?xt+0h(jRP!ymg5mW@*b
zdv7bJ09~BPWd%fx(WDR}mUW%S7E-#Kg8e!p^n%!&S>z)r6X-iq3Bm$UQH%3W3&Y{o
zZ5i|#z>>ZY^rgq7%Ry9$I*sX9xyT9r^0MM2g+;Z;p4AVe61dpU>?K>Dw1v-`$nDs|
z=Z0w4c*w%pR1%bO%byPqhB%X|+^OnZv55Bl${8Z>F~`8JVG279iW~7(jug83yzU!P
zztc@@j^`iN>x|*e8MIubqZOzu*VnUA%UfP4@f9L@uujr=*9db*(suA=v1g_x7p&G1
z5obSXetdlWm-smRapPHZ+XkG2x2pA%1wCd6O2*@b8=a2HN0-d2WY1B{T`sd5HZBCN
zsq6KSEgM9yP%iD2E5<g}XZ0|gWp`;2>XepHqL21ohn%a$>(SCT-%#RiCl{p=A66=e
z`c@L#R1y*s4}Q6+BwUDjC#%yo(7k>a_Jqwm6+3^VcMj0GAM{Zr2d}mfl4!w;6FsuN
z=OU1?={i<!3VR@jUsCJW4#*=M7fY_C5=R=R&9776P&=ITZ==(mMZ5@PM>fZ7rnXeD
z?nKd0=Cql3`Y=x&wrNWO%opdx#Y0`#q;gq$Dm00=g}QYq?YU1|RP{6d?slF}nL>wl
zRc7+1RHnwg;_NM5?X`BJz`gLPUhIVuq2NMl)ibz>Ma=N{OUeM$J^I*gCSI!M2~^8Z
zc@G)z>ZW^J;^y0OELzTs(2|-G8RcfLTMi2IM(x59b;Lvw{$Jy>KRJgRb#{wgrK2LK
zNMyB{(Uj2Gqh<`Qt1YgTHbWwLqaPlhxev12M`4{QxW5`l*3BouR3wkW*3LV#YGmg}
zk8jjNm+H81o`y7dKQC!$we#cvAo~KzP7jQIf)urL|8!fVvYR!1w5cR#k8t9Xz67d#
z>t(tX?ipKMbx}D^DAKi;9L0%qy+Cct2S^S8no}~q7la%GB+nQ2uqGl3NP!PpP%>Ws
zR}tjHUuR5W@>qv3<oO_9&mUYS5`Y%?BFAiC)DF-D@P7rnn}EY>^;^$Th<9S>DZz4b
z05g<QigE#V(E3SxA=F7`HFkA8vjm`)>;m=Hp(|5P3>*hRSQjXr^QG~?yjy)X+oDEn
z!-6WjVP#xH8A%TFYRim*TDfyvb9kxGQN>Jjyv~R0pz#xIm|z>#f|<;GQtgR42S-6V
zUBrSX;*g$Sg0Ihqv6$e|7+X|?5!JgK(#3!gC2YjrXsO%5h%I8sZl16nGPil{`n2!*
zWI6{a?Ajrxy;|pYeeuAcy*hTNR8*sXt;(aks%tEpFOekU*~_m7N%i)SJ+ks8BOah{
z2%|$n77o_EB4sP_RnG=OHsv<VGnVdx$F`=e2U+<l-22C=-gP<S0Q6Iy&WD8}*e^=P
z`2uf<Ns@qiy}jcL@lYuKE(;v8RD3H8%q?(zvQ#_+{P;CE_f9sg9`a2D^a;q6NLqlP
zufpy3&x3oz4FEZr5>acAk~V5Rt$qfWL*7cPfn?^U0Kf8nY_QEDpB<U(nX}EAYUZXN
zX6dJNbf&q)md_&WhDM#-CRYg7zBy(h%ZijdClTdvNlC>kt5g(cG33;a^Xe2ybq(Gg
z--lD#r|}SESG7Y<`3;@A2Zsvnd=Sfa-0Fctna9@g%}XE1ONaNn3i1~)^QL`;sNfiz
z^+<YsPU{s5p-wQ^HiZ<HS1jmooIY_KP%2pc_th~yit;6rGXcmk{(}L%(zqof<3e3~
zXir(z@*f|Bx~`_Bj!VlW8v@^Wmm&_CSlakTO~_AT=MSZgYrvj+!Eno8ZOg>Iyz-1m
z&-G`z7s^gAq0Ux$Hpf)c94#KIEC3{*-NGLX)2lq9?DhU=X(PmHZonTCDb8A!<U8rP
zt1M%bzaX|jTl8F8F9$Jhv&dn-0ZPLqB60;p%D*7vPd>sW*!exVR;tAW%gj8@#kCVF
z*oA*3SI#Y%21~WNy%*{NmSu?R+u^x;`?F*Fv;G_;=|8lBc&8O<(*Hp#eTv_-68=pq
zii$sI75O)<z*~F1$-mQTe<vkZ=k=2en+WnNxvs)r-ZF2v?32(}pwY@O>9>e!6-y;=
zKfl3-E*>@~a|?p^iWYhpT%lO*-w5V1#v{L>qeo5t@Ji=5oJtAf6TU2OpjUBd@Wc=$
zCu%C&tI0r4rkySwlxiy5)dfB;*BYn|R@f}^dP>lmd%oD_Yf9B;k+#Y4DQDM^<@aPQ
zG}dUF$tY(x7dzX@P%32Dc`V^J@!~Wk@2xTbL$$FDooKMt8hhKU-(m`J7~G+M4Dwk>
z_QA~tQ$z=Ow+8gc$l?LI?-nH}PQVDB`jzLtJ+iXoF#hi(Kz}7cZ2kNFe&Ww%UP66k
zgQy-Qg<}65|6j@#IP_KfU6D!)a%5f=>eYUc1rEXMzm|Q0K(J9-fjSYEM;{IMo*2iP
z8b1V^C8QL*e)U)}_oF=JWV03FC9W5J2fH^V%5FOE6{jQ;c_(r;fzEwQwbCz|kM&p}
zoMY+^yx?D&2tn%4&BVb;2~yhX<~Gtoceu#(c0PxbLkmivSuTckx7z`;HBK4q>c+*d
zG)_%^gHd-@kJ|eXq*J>bqB3VlZNbKBMo)?{Twz$zC{>}xIO}Uj?G;CV?(qw^i<h7a
z?<ln!!`milwaH3<^p|(Yszt)*(Dhf;yaV?86q-pij1Wox1CLbC-@=AW6ifLH4+PRX
zJmeILq<TP*uLd3(G;oqw@^5%#Q`JG=jY}djWjy^m=0$P-A3@(3nV0oPnSjv_+21s6
z_im-Q1HgM&|HMX*?PxBqcSCs~yj(Dj!_FPo$#cOnpRvDK-U2AEH}o#KjW7HJc=iIw
zK2X|6JM-%EN<mND8W-{52F*K`*JojpI*eX}S3DG=7M%{|#Y|qu#CB*3FF#W|f5G!F
z(r#!l$`|=7N`g{E?7it8g7%y49bo?8SQ@p#Ru^<kL-{e^7|Ig9hmG)~R8EjADEbv0
zGQ+!k9yWB{J7Wy*Mbg=kvjKE(u3nYYFX5}3w|8Cv90HNF>mSb};R40leyf5R+Pf-{
zlP8cKzZ+?2lE9$?tyjdF!}oGr5GY2w-t7{uau+4i)&$){VZODgh?W^8%{wlN@)O0c
zpaIEG#|s$!E-R5N{F}3{8dwPW9}R?P`rWO>U)}zrf%kFL%XZEyM<)9>%3I%AQ9(HB
zw!WJ~kdL}Zuc)OF%h`qREBhZsVl~%h;&SmP;bE9AGMH}w({KrkTmf<l4^&@YipWCN
zo4;Gx?JTQbT624?=hjuJ5v(MwV+DJyZ#;8c#`xicX*8q%rhhhj-}#Kblf3b0<FoJw
z6OUzKfl3%Gj4!X86aKIp0j(Ydt!Vsyts7JD(+o$T&fTjp(C%^BPo(s!s9vpfL=#MA
zibCok<lC_Hroc#sf0IeTs0#aUfJ#Qn{$s`eo<+F74yC`#64e@BQL&Bh<+rhSeF9Mv
zj4ZjX_gRj3QdH29V>{@tgY(d+?V(nF9oes$O!{{gjB4KrEsceIK|m&W-n7<djar^K
z`gCei8^@@L-OFN99;~wUBThsD_gIWy{W4R7CrQMDEVM1<VPGtuq@>Gg_l!o3Jf4q|
z)DOAn+v}Jy{IhDQK9bpK)Sq(|3KBCG)JPds@s&Z;PzV0h<dO3F44%+<y}SgyT|XTH
z7=mn)*5C9J+Q)yriODljZ~TtOJ9?EZg=l(j;}~i6t85A))Vp@Q4&9fgzlXhxzZmm6
zkC5zqHTeE*A+XqX)%4M*Z<gFc^{GtK@zdL!tTh+MsgR=fohk}q{Mm2Ao~WD*Wa96#
zTt<>N>$igeBM~Yz9fJADHuJ1RI`*5smKtv}y1?3;J>WOh2k6_DsIz*XUs=7*uMS`5
zS6i)dhkwtn3|guLAoI4dB&W+Hok%XateQ$fp}riU;`{)GK1H<>EVmG!Hl!2Si%1}^
zm(N>Zt<|QG3;0MOcPyW$*w6Q>SUlc7oZfU$3k(4czgEb*Y?i;J-FF18S|9^QzL~6N
zGo4#kPf}Su?>D=!WastM5G=8@>UF5szY4<a7*bSuzuDXz*|dY-GaiMv8ISJCnxlf&
z54u;P6{jDB{bwp6uAudQTCDdn-J7+qF0d3M>Teob%r?ER!#jiG=?izJNB%LPsP#8K
ze|Py0J|v}81+8ggTJl<pI@v$0cehZ|$zl6KUt`DoHP~(@KP20k$7}Y5)0<a`wu(4L
z@8M=T-|n5;DQZy@p8?>0-8>c)Qh(&|&pf1WJyj(ZPD?~DEh%Jyio%A+zF+8$b%fYM
zoFLKVmgB&XLnDRY_6@c>bB!ko>^68B03-sf7lsT|SFexliHQ{$juo)Fpf--4$1=Hz
zK!%MMhT`@Gd+lQ;KEVm1VFK8l4{lFx{<=h>67;p-v$K?&#^*Sr^B!1!tvH%A;i-Nn
zaL0Q0O8Wy@?l3m#b7(-=gkUJ19Iz{2+^fIdf=5OJaVL7&-S_$fKT&qFnxXaOyKW-O
z_^iwBw>_Sj;(U829L25V%c%i0UYmr^_gjXMhmS#dNwY_f=tP~-KQ1288yFTN7~h{N
zK~5-oVb5v}@a;xRf<*9K0pMN_4hUPfd#7zk8!i2oHcn_~!p*qdBqe9(voc<ns;o0b
z$5YW3R`lcu7&xinDPmOZWuRHRezJiA=A~D^4DNF@qeqR^#oIr%tFFUo?4S%UgqTO!
z;~Gx2rYExvf8q20)s7ySOb24iRzBKmTfe|8Ib|!?u4Z{KzP+KLJ##OB%<F(tZ3)Do
zcTNI3Jh(+OTd1G>(cPZ@C~!M;XJEDHezAVyp5?|E%ffc|W>RME_@WO9*v;>-zCwMh
z62}LHW`D>ANpdV~%FK)0qi&`C(bE;1b2yN1<?#jRZF#*f6M)6|bqfVHI>_rHEg%pw
zz&}4I@Mk1F6u`gJA3rbf?}~p$bib|d{*wp*|1V+p|E~ULT=HAk_djX!HB$L^)c)T=
z;Qy}uXY}uzTi~B00rE%fe<GRx-N2urt8YQV|0E*N{~a>?@0R|ISa{o}@=q#$T@!!z
zJN-NG_1{hWxd-MgwBeuh@CwaeuB+dH4*#zFr>F71`#;3}yYjy`&HTHGKiz0=F3EpV
z56Rz6{Fj6B-}V1=-~2Zf$jSb5|9`mN{$2e~AHshN^Njre>hbw^1Ap@Szxywv{JZ}@
Z9S^b+ps$hv0Dyk|1Ag^5$?&}${eLeei+un9

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/trestle_ssp_author_options.png b/latest/tutorials/Trestle_authoring/ssp_profile_catalog_authoring/trestle_ssp_author_options.png
new file mode 100644
index 0000000000000000000000000000000000000000..d086127757cf5d13711499fcedafa731955989cc
GIT binary patch
literal 75117
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

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/trestle_author/drawio_data_menu.png b/latest/tutorials/Trestle_authoring/trestle_author/drawio_data_menu.png
new file mode 100644
index 0000000000000000000000000000000000000000..d7967ffa36d0bbc62ed22d071eff0c0229b263da
GIT binary patch
literal 329379
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

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/trestle_author/drawio_editing_data.png b/latest/tutorials/Trestle_authoring/trestle_author/drawio_editing_data.png
new file mode 100644
index 0000000000000000000000000000000000000000..48667adf1c3e9d9dfa4ec835356a55d9442d673b
GIT binary patch
literal 264094
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

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/trestle_author/index.html b/latest/tutorials/Trestle_authoring/trestle_author/index.html
new file mode 100644
index 000000000..5d248602e
--- /dev/null
+++ b/latest/tutorials/Trestle_authoring/trestle_author/index.html
@@ -0,0 +1,171 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Tutorial on governing authored documents with trestle"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Trestle_authoring/trestle_author/ rel=canonical><link href=../ssp_profile_catalog_authoring/ rel=prev><link href=../trestle_author_jinja/ rel=next><link rel=icon href=../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Governance of Authored Documents - Compliance Trestle</title><link rel=stylesheet href=../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Governance of Authored Documents - Compliance Trestle"><meta property=og:description content="Tutorial on governing authored documents with trestle"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Trestle_authoring/trestle_author.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Trestle_authoring/trestle_author/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Governance of Authored Documents - Compliance Trestle"><meta name=twitter:description content="Tutorial on governing authored documents with trestle"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Trestle_authoring/trestle_author.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle-cli-for-governance-of-authored-documents class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Governance of Authored Documents </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5 checked> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=true> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Governance of Authored Documents </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Governance of Authored Documents </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#contents class=md-nav__link> <span class=md-ellipsis> Contents </span> </a> </li> <li class=md-nav__item> <a href=#overview class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> <nav class=md-nav aria-label=Overview> <ul class=md-nav__list> <li class=md-nav__item> <a href=#why-is-this-capability-in-trestle class=md-nav__link> <span class=md-ellipsis> Why is this capability in trestle? </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#setting-up-the-trestle-workspace class=md-nav__link> <span class=md-ellipsis> Setting up the Trestle workspace </span> </a> </li> <li class=md-nav__item> <a href=#markdown-structural-enforcement class=md-nav__link> <span class=md-ellipsis> Markdown structural enforcement </span> </a> <nav class=md-nav aria-label="Markdown structural enforcement"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#enforcing-yaml-header-metadata-structure class=md-nav__link> <span class=md-ellipsis> Enforcing YAML header (metadata) structure </span> </a> </li> <li class=md-nav__item> <a href=#enforcing-heading-structure class=md-nav__link> <span class=md-ellipsis> Enforcing heading structure </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#drawio-enforcement-mechanisms class=md-nav__link> <span class=md-ellipsis> Drawio enforcement mechanisms </span> </a> </li> <li class=md-nav__item> <a href=#validating-documents-against-one-specific-template class=md-nav__link> <span class=md-ellipsis> Validating documents against one specific template </span> </a> <nav class=md-nav aria-label="Validating documents against one specific template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#creating-new-tasktemplate class=md-nav__link> <span class=md-ellipsis> Creating new task/template </span> </a> <nav class=md-nav aria-label="Creating new task/template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#creating-new-document-for-the-task class=md-nav__link> <span class=md-ellipsis> Creating new document for the task </span> </a> <nav class=md-nav aria-label="Creating new document for the task"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_1 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-template class=md-nav__link> <span class=md-ellipsis> Validating the template </span> </a> <nav class=md-nav aria-label="Validating the template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_2 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents-against-the-template class=md-nav__link> <span class=md-ellipsis> Validating the documents against the template </span> </a> <nav class=md-nav aria-label="Validating the documents against the template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_3 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents-against-different-templates class=md-nav__link> <span class=md-ellipsis> Validating the documents against different templates </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-against-multiple-templates class=md-nav__link> <span class=md-ellipsis> Validating against multiple templates </span> </a> <nav class=md-nav aria-label="Validating against multiple templates"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#creating-new-task-folder class=md-nav__link> <span class=md-ellipsis> Creating new task folder </span> </a> <nav class=md-nav aria-label="Creating new task folder"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_4 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#creating-new-documents-for-the-task class=md-nav__link> <span class=md-ellipsis> Creating new documents for the task </span> </a> <nav class=md-nav aria-label="Creating new documents for the task"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_5 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-templates class=md-nav__link> <span class=md-ellipsis> Validating the templates </span> </a> <nav class=md-nav aria-label="Validating the templates"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_6 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents-against-templates class=md-nav__link> <span class=md-ellipsis> Validating the documents against templates </span> </a> <nav class=md-nav aria-label="Validating the documents against templates"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_7 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents-against-different-templates_1 class=md-nav__link> <span class=md-ellipsis> Validating the documents against different templates </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validate-only-the-headers-against-a-global-or-a-specific-template class=md-nav__link> <span class=md-ellipsis> Validate only the headers against a global or a specific template. </span> </a> <nav class=md-nav aria-label="Validate only the headers against a global or a specific template."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#creating-new-tasktemplate_1 class=md-nav__link> <span class=md-ellipsis> Creating new task/template </span> </a> <nav class=md-nav aria-label="Creating new task/template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_8 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#creating-new-documents class=md-nav__link> <span class=md-ellipsis> Creating new documents </span> </a> </li> <li class=md-nav__item> <a href=#validating-the-templates_1 class=md-nav__link> <span class=md-ellipsis> Validating the templates </span> </a> <nav class=md-nav aria-label="Validating the templates"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_9 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents class=md-nav__link> <span class=md-ellipsis> Validating the documents </span> </a> </li> <li class=md-nav__item> <a href=#extra-options_10 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#template-versioning class=md-nav__link> <span class=md-ellipsis> Template versioning </span> </a> <nav class=md-nav aria-label="Template versioning"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#prerequisite class=md-nav__link> <span class=md-ellipsis> Prerequisite: </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#oscal-authoring class=md-nav__link> <span class=md-ellipsis> OSCAL Authoring </span> </a> <nav class=md-nav aria-label="OSCAL Authoring"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#catalog-authoring class=md-nav__link> <span class=md-ellipsis> Catalog authoring </span> </a> </li> <li class=md-nav__item> <a href=#profile-authoring class=md-nav__link> <span class=md-ellipsis> Profile authoring </span> </a> </li> <li class=md-nav__item> <a href=#profile-generation-with-inheritance class=md-nav__link> <span class=md-ellipsis> Profile generation with inheritance </span> </a> </li> <li class=md-nav__item> <a href=#ssp-authoring class=md-nav__link> <span class=md-ellipsis> SSP authoring </span> </a> </li> <li class=md-nav__item> <a href=#ssp-content-filtering class=md-nav__link> <span class=md-ellipsis> SSP Content Filtering </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#contents class=md-nav__link> <span class=md-ellipsis> Contents </span> </a> </li> <li class=md-nav__item> <a href=#overview class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> <nav class=md-nav aria-label=Overview> <ul class=md-nav__list> <li class=md-nav__item> <a href=#why-is-this-capability-in-trestle class=md-nav__link> <span class=md-ellipsis> Why is this capability in trestle? </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#setting-up-the-trestle-workspace class=md-nav__link> <span class=md-ellipsis> Setting up the Trestle workspace </span> </a> </li> <li class=md-nav__item> <a href=#markdown-structural-enforcement class=md-nav__link> <span class=md-ellipsis> Markdown structural enforcement </span> </a> <nav class=md-nav aria-label="Markdown structural enforcement"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#enforcing-yaml-header-metadata-structure class=md-nav__link> <span class=md-ellipsis> Enforcing YAML header (metadata) structure </span> </a> </li> <li class=md-nav__item> <a href=#enforcing-heading-structure class=md-nav__link> <span class=md-ellipsis> Enforcing heading structure </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#drawio-enforcement-mechanisms class=md-nav__link> <span class=md-ellipsis> Drawio enforcement mechanisms </span> </a> </li> <li class=md-nav__item> <a href=#validating-documents-against-one-specific-template class=md-nav__link> <span class=md-ellipsis> Validating documents against one specific template </span> </a> <nav class=md-nav aria-label="Validating documents against one specific template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#creating-new-tasktemplate class=md-nav__link> <span class=md-ellipsis> Creating new task/template </span> </a> <nav class=md-nav aria-label="Creating new task/template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#creating-new-document-for-the-task class=md-nav__link> <span class=md-ellipsis> Creating new document for the task </span> </a> <nav class=md-nav aria-label="Creating new document for the task"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_1 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-template class=md-nav__link> <span class=md-ellipsis> Validating the template </span> </a> <nav class=md-nav aria-label="Validating the template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_2 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents-against-the-template class=md-nav__link> <span class=md-ellipsis> Validating the documents against the template </span> </a> <nav class=md-nav aria-label="Validating the documents against the template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_3 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents-against-different-templates class=md-nav__link> <span class=md-ellipsis> Validating the documents against different templates </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-against-multiple-templates class=md-nav__link> <span class=md-ellipsis> Validating against multiple templates </span> </a> <nav class=md-nav aria-label="Validating against multiple templates"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#creating-new-task-folder class=md-nav__link> <span class=md-ellipsis> Creating new task folder </span> </a> <nav class=md-nav aria-label="Creating new task folder"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_4 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#creating-new-documents-for-the-task class=md-nav__link> <span class=md-ellipsis> Creating new documents for the task </span> </a> <nav class=md-nav aria-label="Creating new documents for the task"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_5 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-templates class=md-nav__link> <span class=md-ellipsis> Validating the templates </span> </a> <nav class=md-nav aria-label="Validating the templates"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_6 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents-against-templates class=md-nav__link> <span class=md-ellipsis> Validating the documents against templates </span> </a> <nav class=md-nav aria-label="Validating the documents against templates"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_7 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents-against-different-templates_1 class=md-nav__link> <span class=md-ellipsis> Validating the documents against different templates </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validate-only-the-headers-against-a-global-or-a-specific-template class=md-nav__link> <span class=md-ellipsis> Validate only the headers against a global or a specific template. </span> </a> <nav class=md-nav aria-label="Validate only the headers against a global or a specific template."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#creating-new-tasktemplate_1 class=md-nav__link> <span class=md-ellipsis> Creating new task/template </span> </a> <nav class=md-nav aria-label="Creating new task/template"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_8 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#creating-new-documents class=md-nav__link> <span class=md-ellipsis> Creating new documents </span> </a> </li> <li class=md-nav__item> <a href=#validating-the-templates_1 class=md-nav__link> <span class=md-ellipsis> Validating the templates </span> </a> <nav class=md-nav aria-label="Validating the templates"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#extra-options_9 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#validating-the-documents class=md-nav__link> <span class=md-ellipsis> Validating the documents </span> </a> </li> <li class=md-nav__item> <a href=#extra-options_10 class=md-nav__link> <span class=md-ellipsis> Extra options </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#template-versioning class=md-nav__link> <span class=md-ellipsis> Template versioning </span> </a> <nav class=md-nav aria-label="Template versioning"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#prerequisite class=md-nav__link> <span class=md-ellipsis> Prerequisite: </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#oscal-authoring class=md-nav__link> <span class=md-ellipsis> OSCAL Authoring </span> </a> <nav class=md-nav aria-label="OSCAL Authoring"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#catalog-authoring class=md-nav__link> <span class=md-ellipsis> Catalog authoring </span> </a> </li> <li class=md-nav__item> <a href=#profile-authoring class=md-nav__link> <span class=md-ellipsis> Profile authoring </span> </a> </li> <li class=md-nav__item> <a href=#profile-generation-with-inheritance class=md-nav__link> <span class=md-ellipsis> Profile generation with inheritance </span> </a> </li> <li class=md-nav__item> <a href=#ssp-authoring class=md-nav__link> <span class=md-ellipsis> SSP authoring </span> </a> </li> <li class=md-nav__item> <a href=#ssp-content-filtering class=md-nav__link> <span class=md-ellipsis> SSP Content Filtering </span> </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=trestle-cli-for-governance-of-authored-documents>Trestle CLI for Governance of Authored Documents<a class=headerlink href=#trestle-cli-for-governance-of-authored-documents title="Permanent link">¤</a></h1> <p>This document is organized in a multiple collapsable sections for ease of use. Start by reading the overview and setting up the Trestle workspace and then proceed to other sections, to learn more about Trestle authoring capabilities.</p> <h2 id=contents>Contents<a class=headerlink href=#contents title="Permanent link">¤</a></h2> <details> <summary><b>1. Overview</b></summary> <h2 id=overview>Overview<a class=headerlink href=#overview title="Permanent link">¤</a></h2> <p>The premise of trestle is to support managing compliance artifacts as code. When this is considered, many organisations using <code>{github|gitlab|bitbucket}</code> rely on markdown documents for documentary artifacts that may either directly or indirectly support compliance efforts.</p> <p>To support this, trestle has the concept of 'governing' documents that are authored documents: Where structural conditions are enforced on the markdown documents to allow automation and to ensure business processes are met.</p> <p>Living in the <code>GitOps</code> world this capability is anchored with <code>markdown</code> files as the core of the workflows. Currently <code>drawio</code> files are also supported for a subset of enforcement mechanisms.</p> <h3 id=why-is-this-capability-in-trestle>Why is this capability in trestle?<a class=headerlink href=#why-is-this-capability-in-trestle title="Permanent link">¤</a></h3> <p>While trestle provides editing support for OSCAL there is an unfortunate truth that for some compliance workflows:</p> <ol> <li>OSCAL does not cover the lower level operational workflows.</li> <li>Some users will not be comfortable editing in json/yaml/xml formats</li> </ol> <p>The markdown centric workflows allow transition path where capability is <a href=https://github.com/oscal-compass/compliance-trestle/issues/555>being developed</a></p> </details> <details> <summary><b>2. Setting up the Trestle workspace</b></summary> <h2 id=setting-up-the-trestle-workspace>Setting up the Trestle workspace<a class=headerlink href=#setting-up-the-trestle-workspace title="Permanent link">¤</a></h2> <p>To work with governed documents, you would need to initialize the Trestle workspace and create your first governed document and template.</p> <p>To create a trestle workspace that will contain all your templates and governed documents:</p> <div class=highlight><pre><span></span><code>mkdir<span class=w> </span>my_workspace
+<span class=nb>cd</span><span class=w> </span>my_workspace
+trestle<span class=w> </span>init<span class=w> </span>--govdocs
+&gt;&gt;&gt;<span class=w> </span>Initialized<span class=w> </span>trestle<span class=w> </span>project<span class=w> </span>successfully<span class=w> </span><span class=k>in</span><span class=w> </span><span class=o>[</span>user_path<span class=o>]</span>/my_workspace
+</code></pre></div> <p>The templates will be located in the <code>/my_workspace/.trestle/author/</code>. Please note that if you use MacOS or Linux distribution, by default <code>.trestle</code> will be hidden. You will need to reconfigure your system to show hidden folders if you want to see them listed.</p> </details> <details> <summary><b>3. Authoring of Documents</b></summary> <details> <summary><b>Documents Structural Enforcement</b></summary> <h2 id=markdown-structural-enforcement>Markdown structural enforcement<a class=headerlink href=#markdown-structural-enforcement title="Permanent link">¤</a></h2> <p>Trestle templating enforces the documents to follow a specific structure. There are two ways in which structure is enforced in a document against template:</p> <ol> <li>Enforcing a YAML header (metadata) structure at the top of the markdown document.</li> <li>Enforcing a heading structure within the markdown document.</li> </ol> <p>Each document is validated against a specific template, see CLI section below on information on how to specify which template the document should be validated against.</p> <h3 id=enforcing-yaml-header-metadata-structure>Enforcing YAML header (metadata) structure<a class=headerlink href=#enforcing-yaml-header-metadata-structure title="Permanent link">¤</a></h3> <p>Each template and document contains metadata in form of a YAML header that is placed on top. When the document is created (i.e. <code>trestle docs setup</code>) the metadata is copied from the template to the newly created document.</p> <p>Below is an example of a markdown file that contains YAML header:</p> <div class=highlight><pre><span></span><code>---
+groceries:
+grocery1:
+  name: apple
+  type: fruit
+  bought-in: Local market
+grocery2:
+  name: potato
+  type: vegetable
+  bought-in: Local market
+date: 01-01-2022
+not-important-field: not important
+x-trestle-version: 1.0.0
+<span class=gu>x-trestle-ignore: not-important-field, bought-in</span>
+<span class=gu>---</span>
+<span class=gh># The rest of my document</span>
+</code></pre></div> <p>Each field in the YAML header follows the <code>key: value</code> format. For YAML header we validate the structure and the presence of the "keys" and not the "values".</p> <p>The document YAML header(metadata) is said to be <strong><em>valid</em></strong> against the template, if and only if:</p> <ol> <li>It contains <strong>all</strong> keys from the template EXCEPT the keys that either:</li> <li>Start with <code>x-trestle</code></li> <li>Are listed under the <code>x-trestle-ignore</code> key (i.e. <code>x-trestle-ignore: not-important-field, bought-in</code>)</li> <li>The version under <code>x-trestle-template-version:</code> key is matching the template.</li> <li>No new keys were added to the document.</li> </ol> <p>For example, this change to the YAML header above is acceptable:</p> <div class=highlight><pre><span></span><code>---
+groceries:
+  grocery1:
+      name: pear
+      type: fruit
+      bought-in: Superstore
+  grocery2:
+      name: potato
+      type: vegetable
+      bought-in: Local market
+date: 10-10-2023
+not-important-field: not important
+x-trestle-version: 1.0.0
+<span class=gu>x-trestle-ignore: not-important-field, bought-in</span>
+<span class=gu>---</span>
+<span class=gh># The rest of my document</span>
+</code></pre></div> <h3 id=enforcing-heading-structure>Enforcing heading structure<a class=headerlink href=#enforcing-heading-structure title="Permanent link">¤</a></h3> <p>Markdown headings are considered to be nested based on the heading level (i.e. number of <code>#</code>). For example, <code>## 1.1 Lower level heading</code> is below <code># 1. top level heading</code>.</p> <p>The document body is said to be <strong><em>valid</em></strong> against the template, if and only if,</p> <ol> <li>It contains <strong><em>all</em></strong> the headings provided in the template.</li> <li>No new headings were added at the top level (i.e. <code># New heading</code> is not allowed).</li> <li>All original headings are in the same order as in the template.</li> <li>All headings must be in the hierarchical order (i.e. <code># Heading</code> then <code>### Heading</code> then <code>## Heading</code> is invalid).</li> <li>If the <code>--governed-heading</code> option is provided, then document is valid if no keys has changed in the specified governed section.</li> </ol> <p>For example, consider this template as our starting point:</p> <div class=highlight><pre><span></span><code><span class=gh># Template heading 1</span>
+Some text
+<span class=gh># Template heading 2</span>
+<span class=gu>## Template sub heading</span>
+</code></pre></div> <p>Now we added new sections and ended up with the following document: (note: this document will be valid against the template above)</p> <div class=highlight><pre><span></span><code><span class=gh># Template heading 1</span>
+Content for heading one
+<span class=gu>## Non-required sub header</span>
+Content for non-required sub header
+<span class=gh># Template heading 2</span>
+Content for heading two
+<span class=gu>## Template sub heading</span>
+Content for template sub heading
+<span class=gu>### non required sub-sub heading</span>
+This sub-sub heading is okay
+</code></pre></div> <p>However, violations such as adding or removing a heading at the top level are not acceptable:</p> <div class=highlight><pre><span></span><code><span class=gh># Template heading 1</span>
+Content for heading one
+<span class=gu>## Non-required sub header</span>
+Content for non-required sub header
+<span class=gh># Template heading 2</span>
+Content for heading two
+<span class=gu>## Template sub heading</span>
+Content for template sub heading
+<span class=gh># Top level heading that is not okay &lt;&lt;&lt; NOT OKAY</span>
+</code></pre></div> <p>For each of the headings - the text of the heading is enforced with one caveat:</p> <ul> <li>If the template heading text is wrapped in curly brackets <code>{}</code> then the name is not measured e.g. <code># {Insert title here}</code>.</li> </ul> <h2 id=drawio-enforcement-mechanisms>Drawio enforcement mechanisms<a class=headerlink href=#drawio-enforcement-mechanisms title="Permanent link">¤</a></h2> <p>Drawio or <a href=https://app.diagrams.net/ >diagrams.net</a> is a diagramming platform which has significant use for architecture diagrams. In the context of governance of content, trestle is supporting enforcement of metadata.</p> <p>Drawio (or <code>mxgraph</code>) files have a set of data fields. In a drawio file this is available in the edit menu as <em>edit data</em>. The diagram below shows how to access the (meta)data.</p> <p><img alt="Accessing the drawio data editor" src=drawio_data_menu.png title="Accessing the drawio data editor"></p> <p>The data presents as a set of key-value pairs which can be edited (see below). The data is bound to each tab in a drawio file. The trestle CLI currently expects that metadata (whether from the template or file to be measured) is in the first tab when editing the draw io file.</p> <p><img alt="Editing drawio data" src=drawio_editing_data.png title="Editing drawio data"></p> </details> <details> <summary><b>Setting Up Templates and Documents Via CLI</b></summary> <p>Trestle allows the setup of templates and governed documents in a several different ways based on the nature of the needed governance.</p> <p>Definitions used in this section:</p> <ul> <li><em><strong>document</strong></em> - a markdown or drawio file that needs to be validated against some template.</li> <li><em><strong>template</strong></em> - an individual markdown or drawio file containing metadata and/or headings against which the documents will be validated.</li> <li><em><strong>task</strong></em> - a name of the folders containing documents and their respective templates.</li> <li><em><strong>template folder</strong></em> - an individual folder containing the templates that documents needs to be validated against.</li> </ul> <p>You can set up multiple different tasks and types of validations in the same workspace.</p> <p>Setup Trestle for:</p> <details> <summary><b>docs - Validating documents against one specific template (one template per task)</b></summary> <h2 id=validating-documents-against-one-specific-template>Validating documents against one specific template<a class=headerlink href=#validating-documents-against-one-specific-template title="Permanent link">¤</a></h2> <p>In this section we describe the functionality of <code>trestle author docs</code> command.</p> <p><code>author docs</code> is designed to support enforcing and generating templating markdown files within a single folder based on a task name. Currently <code>author docs</code> supports markdown files only.</p> <h3 id=creating-new-tasktemplate>Creating new task/template<a class=headerlink href=#creating-new-tasktemplate title="Permanent link">¤</a></h3> <p>To create a new task with the necessary directory structures for running governed docs validation, run:</p> <blockquote> <p>trestle author docs setup -tn my_task_name</p> </blockquote> <p>This will create a template folder and a single template: <code>TRESTLE_ROOT/.trestle/author/my_task_name/0.0.1/template.md</code>. As well as an empty document folder: <code>TRESTLE_ROOT/my_task_name/</code> The template will be applied to <strong>all</strong> markdown files in the task i.e.: <code>TRESTLE_ROOT/my_task_name/*.md</code>.</p> <h4 id=extra-options>Extra options<a class=headerlink href=#extra-options title="Permanent link">¤</a></h4> <ul> <li>You can create different versions of the template by specifying the version via <code>--template-version</code> flag. See <code>Template Versioning</code> section for more information. By default if no version is provided <code>0.0.1</code> will be used.</li> </ul> <h3 id=creating-new-document-for-the-task>Creating new document for the task<a class=headerlink href=#creating-new-document-for-the-task title="Permanent link">¤</a></h3> <p>To create a new document that confirms to a template run:</p> <blockquote> <p>trestle author docs create-sample -tn my_task_name</p> </blockquote> <p>This will create a sample document in: <code>TRESTLE_ROOT/my_task_name/my_task_name_000.md</code>. Once created this document will be a complete copy of the template, however you can modify this file with your own content.</p> <h4 id=extra-options_1>Extra options<a class=headerlink href=#extra-options_1 title="Permanent link">¤</a></h4> <ul> <li>This command has no extra options</li> </ul> <h3 id=validating-the-template>Validating the template<a class=headerlink href=#validating-the-template title="Permanent link">¤</a></h3> <p>To ensure that the markdown in the template is parseable run:</p> <blockquote> <p>trestle author docs template-validate -tn my_task_name</p> </blockquote> <h4 id=extra-options_2>Extra options<a class=headerlink href=#extra-options_2 title="Permanent link">¤</a></h4> <ul> <li>If <code>--governed-heading 'heading name'</code> (<code>-gh</code>) is passed it ensures that the required heading exists.</li> <li>If <code>--header-validate</code> (<code>-hv</code>) is passed the header will be validated as well.</li> <li>If <code>--header-only-validate</code> (<code>-hov</code>) only the header and NOT the body will be validated</li> </ul> <h3 id=validating-the-documents-against-the-template>Validating the documents against the template<a class=headerlink href=#validating-the-documents-against-the-template title="Permanent link">¤</a></h3> <p>To validate the documents against a template run:</p> <blockquote> <p>trestle author docs validate -tn my_task_name</p> </blockquote> <p>This will take the <code>TRESTLE_ROOT/.trestle/author/my_task_name/template.md</code> template and validate all markdown files here: <code>TRESTLE_ROOT/my_task_name/*.md</code>.</p> <p>Running the command will validate that markdown body in the document is valid against the template. Please note that by default the header will <strong>not</strong> be validated. See extra options for more validation options. To learn more on what exactly is validated please refer to <code>Documents Structural Enforcement</code> section in this document.</p> <h4 id=extra-options_3>Extra options<a class=headerlink href=#extra-options_3 title="Permanent link">¤</a></h4> <ul> <li>If <code>--governed-heading</code> (<code>-gh</code>) is passed it will ensure that the governed content was not modified. Governed content comes in the <strong>key:</strong> value format:</li> </ul> <div class=highlight><pre><span></span><code>     # Governed section
+     <span class=gs>**Content Type:**</span>  Foo
+     <span class=gs>**Author(s):**</span>  Bah
+     <span class=gs>**Executive Owner:**</span>  Stuff
+     <span class=gs>**Technical Approver:**</span>   John Doe (approved)
+     <span class=gs>**Version:**</span> 1.0.1
+</code></pre></div> <p>Running <code>trestle author docs validate -tn docs_task -gh="Governed section"</code> will ensure this content is present in the document.</p> <ul> <li>If <code>--ignore ^_.*</code> (<code>-ig</code>) is passed it will validate all files except folders and files that start with underscore <code>_</code>. Use this option when you would like to ignore any folders or files that match given regular expression.</li> <li>If <code>--header-validate</code> (<code>-hv</code>) is passed the header will be validated as well.</li> <li>If <code>--header-only-validate</code> (<code>-hov</code>) is passed only the header and NOT the body will be validated.</li> <li>If <code>--readme-validate</code> (<code>-rv</code>) is passed README.md will be validated as well, otherwise it is ignored.</li> <li>If <code>--recurse</code> (<code>-r</code>) is passed the documents in the subfolders will also be validated. By default <code>author docs</code> only indexes a flat directory.</li> <li>If <code>--template-version 1.0.0</code> (<code>-tv</code>) is passed the header field <code>x-trestle-template-version</code> will be ignored and document will be forcefully validated against template of version <code>1.0.0</code>. Use this for testing purposes <em>only</em> when you need to validate the document against a specific template. By default the template version will be determined based on <code>x-trestle-template-version</code> in the document.</li> </ul> <h3 id=validating-the-documents-against-different-templates>Validating the documents against different templates<a class=headerlink href=#validating-the-documents-against-different-templates title="Permanent link">¤</a></h3> <p>Validation against multiple templates can be done when there is a scenario where you have multiple templates that will have multiple instances. In this particular case you can have a 1:1 relationship between the template and the instance document you are creating out of it, so validation can be performed based on template type and version of that particular template defined in headers.</p> <p>For that to happen you will need to provide your template with the following parameter at the yaml header level, matching the type of template to be implemented so that the validation can occur:</p> <blockquote> <p>x-trestle-template-type: insert_template_type_here</p> </blockquote> <p>Please, take into consideration that for the validation to happen you will also need to provide each instance document in the task folder a field called <code>x-trestle-template-type: insert_template_type_here</code> in the yaml header matching with the template name.</p> <div class=highlight><pre><span></span><code><span class=nn>---</span>
+<span class=nt>authors</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">tmp</span>
+<span class=nt>owner</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">tmp</span>
+<span class=nt>valid</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>from</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
+<span class=w>  </span><span class=nt>to</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
+<span class=nt>x-trestle-template-type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">insert_template_type_here</span>
+<span class=nn>---</span>
+</code></pre></div> <p>With that, you will be able to create more than 1 instance document per template and give the instance the desired name.</p> <p>For instance, let´s consider the next folder structure:</p> <div class=highlight><pre><span></span><code>trestle_root
+┣ .trestle
+┃ ┣ author
+┃ ┃ ┣ my_task_2
+┃ ┃ ┃ ┣ 0.0.1
+┃ ┃ ┃ ┃ ┣ a_template.md
+┃ ┃ ┃ ┃ ┣ another_template.md
+┃ ┃ ┃ ┃ ┗ arhitecture.drawio
+┃ ┗ config.ini
+
+trestle_root
+ ┣ .trestle
+ ┣ my_task_2
+ ┃ ┣ sample_folder_0
+ ┃ ┃ ┣ a_template_1.md
+ ┃ ┃ ┣ a_template_2.md
+ ┃ ┃ ┣ arhitecture_1.drawio
+ ┃ ┃ ┗ another_template_123.md
+</code></pre></div> <p>If you noticed, names are no longer needed to match with exact template names, and that´s because validation will run through <code>x-trestle-template-type</code> field defined at the instance header, not through the name.</p> <p>To validate the documents against their respective templates using <code>x-trestle-template-type</code>, run:</p> <blockquote> <p>trestle author docs validate -tn my_task_name -vtt</p> </blockquote> <p>Now, <code>-vtt</code> stands for validate template type. Validate template type option will provide you the ability to have more than 1 instance per template validated.</p> </details> <details> <summary><b>folders - Validating documents against multiple templates and ensuring folder structure (multiple individual templates per task) </b></summary> <h2 id=validating-against-multiple-templates>Validating against multiple templates<a class=headerlink href=#validating-against-multiple-templates title="Permanent link">¤</a></h2> <p>In this section we describe the functionality of <code>trestle author folders</code> command.</p> <p><code>author folders</code> is designed to allow the assembly of groups of templates where each folder contains unique content. This command will validate that both: structure (i.e. all template documents are present) and content is preserved in the folder. Trestle author folders supports validation of both markdown and drawio files. Note that headers / metadata must be specified in each applicable template.</p> <h3 id=creating-new-task-folder>Creating new task folder<a class=headerlink href=#creating-new-task-folder title="Permanent link">¤</a></h3> <p>To create a new task folder run:</p> <blockquote> <p>trestle author folders setup -tn my_task_2</p> </blockquote> <p>This will create a template folder with the following structure:</p> <div class=highlight><pre><span></span><code>trestle_root
+┣ .trestle
+┃ ┣ author
+┃ ┃ ┣ my_task_2
+┃ ┃ ┃ ┣ 0.0.1
+┃ ┃ ┃ ┃ ┣ a_template.md
+┃ ┃ ┃ ┃ ┣ another_template.md
+┃ ┃ ┃ ┃ ┗ arhitecture.drawio
+┃ ┗ config.ini
+</code></pre></div> <p>Each task folder is required to meet template requirements for all: <code>a_template.md</code>, <code>another_template.md</code>, and <code>template.drawio</code>. The names, numbers, and nesting of folders is user specifiable, however, unlike <code>docs</code> the names must be carried over to each instances.</p> <h4 id=extra-options_4>Extra options<a class=headerlink href=#extra-options_4 title="Permanent link">¤</a></h4> <ul> <li>You can create different versions of the template by specifying the version via <code>--template-version</code> flag. See <code>Template Versioning</code> section for more information. By default if no version is provided <code>0.0.1</code> will be used.</li> </ul> <h3 id=creating-new-documents-for-the-task>Creating new documents for the task<a class=headerlink href=#creating-new-documents-for-the-task title="Permanent link">¤</a></h3> <p>Following the similar structure of <code>docs</code>, measurement occurs in the <code>my_task_2</code> where this structure is enforced for every directory.</p> <p>To create a new folder with documents for the task run:</p> <blockquote> <p>trestle author folders create-sample -tn my_task_2</p> </blockquote> <p>This will create a subfolder in the <code>my_task_2</code> with the same content as in template folder. Running it twice will result in:</p> <div class=highlight><pre><span></span><code>trestle_root
+ ┣ .trestle
+ ┣ my_task_2
+ ┃ ┣ sample_folder_0
+ ┃ ┃ ┣ a_template.md
+ ┃ ┃ ┣ arhitecture.drawio
+ ┃ ┃ ┗ another_template.md
+
+ ┃ ┗ sample_folder_1
+ ┃ ┃ ┣ a_template.md
+ ┃ ┃ ┣ arhitecture.drawio
+ ┃ ┃ ┗ another_template.md
+</code></pre></div> <h4 id=extra-options_5>Extra options<a class=headerlink href=#extra-options_5 title="Permanent link">¤</a></h4> <ul> <li>This command has no extra options</li> </ul> <h3 id=validating-the-templates>Validating the templates<a class=headerlink href=#validating-the-templates title="Permanent link">¤</a></h3> <p>To validate the documents against the template run:</p> <blockquote> <p>trestle author folders template-validate -tn my_task_2</p> </blockquote> <p>This will ensure that the respective template files are parseable.</p> <h4 id=extra-options_6>Extra options<a class=headerlink href=#extra-options_6 title="Permanent link">¤</a></h4> <ul> <li>This command has no extra options</li> </ul> <h3 id=validating-the-documents-against-templates>Validating the documents against templates<a class=headerlink href=#validating-the-documents-against-templates title="Permanent link">¤</a></h3> <p>The validation in <code>trestle author folder</code> runs similarly as in <code>docs</code> but now each document will be validated against the template with the same name as in the template folder.</p> <p>To validate the documents against their respective templates, run:</p> <blockquote> <p>trestle author folders validate -tn my_task_name</p> </blockquote> <p>This will validate all files. Please note that all files from the template folder must be present in the individual document folders.</p> <h4 id=extra-options_7>Extra options<a class=headerlink href=#extra-options_7 title="Permanent link">¤</a></h4> <ul> <li>If <code>--governed-heading</code> (<code>-gh</code>) is passed it will ensure that the governed content was not modified. Governed content comes in the <strong>key:</strong> value format: <div class=highlight><pre><span></span><code>   # Governed section
+   <span class=gs>**Content Type:**</span>  Foo
+   <span class=gs>**Author(s):**</span>  Bah
+   <span class=gs>**Executive Owner:**</span>  Stuff
+   <span class=gs>**Technical Approver:**</span>   John Doe (approved)
+   <span class=gs>**Version:**</span> 1.0.1
+</code></pre></div></li> </ul> <p>Running <code>trestle author docs validate -tn docs_task -gh="Governed section"</code> will ensure this content is present in the document.</p> <ul> <li>If <code>--ignore ^_.*</code> (<code>-ig</code>) is passed it will validate all files except folders and files that start with underscore <code>_</code>. Use this option when you would like to ignore any folders or files that match given regular expression.</li> <li>If <code>--header-validate</code> (<code>-hv</code>) is passed the header will be validated as well.</li> <li>If <code>--header-only-validate</code> (<code>-hov</code>) is passed only the header and NOT the body will be validated.</li> <li>If <code>--readme-validate</code> (<code>-rv</code>) is passed README.md will be validated as well, otherwise it is ignored.</li> <li>If <code>--recurse</code> (<code>-r</code>) is passed the documents in the subfolders will also be validated. By default <code>author docs</code> only indexes a flat directory.</li> <li>If <code>--template-version 1.0.0</code> (<code>-tv</code>) is passed the header field <code>x-trestle-template-version</code> will be ignored and document will be forcefully validated against template of version <code>1.0.0</code>. Use this for testing purposes <em>only</em> when you need to validate the document against a specific template. By default the template version will be determined based on <code>x-trestle-template-version</code> in the document.</li> </ul> <h3 id=validating-the-documents-against-different-templates_1>Validating the documents against different templates<a class=headerlink href=#validating-the-documents-against-different-templates_1 title="Permanent link">¤</a></h3> <p>Validation against multiple templates as stated before can be done, but there is another scenario that you can leverage on trestle to have multiple documents in the task folder corresponding to a single template.</p> <p>For that to happen you will need to provide your template with the following parameter at the yaml header level, matching the type of template to be implemented so the validation can occur:</p> <blockquote> <p>x-trestle-template-type: insert_template_type_here</p> </blockquote> <p>Please, take into consideration that for the validation to happen you will also need to provide each instance document in the task folder a field called <code>x-trestle-template-type: insert_template_type_here</code> in the yaml header matching with the template name.</p> <div class=highlight><pre><span></span><code><span class=nn>---</span>
+<span class=nt>authors</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">tmp</span>
+<span class=nt>owner</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">tmp</span>
+<span class=nt>valid</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>from</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
+<span class=w>  </span><span class=nt>to</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">null</span>
+<span class=nt>x-trestle-template-type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">insert_template_type_here</span>
+<span class=nn>---</span>
+</code></pre></div> <p>With that, you will be able to create more than 1 instance document per template and give the instance the desired name.</p> <p>For instance, let´s consider the next folder structure:</p> <div class=highlight><pre><span></span><code>trestle_root
+┣ .trestle
+┃ ┣ author
+┃ ┃ ┣ my_task_2
+┃ ┃ ┃ ┣ 0.0.1
+┃ ┃ ┃ ┃ ┣ a_template.md
+┃ ┃ ┃ ┃ ┣ another_template.md
+┃ ┃ ┃ ┃ ┗ arhitecture.drawio
+┃ ┗ config.ini
+
+trestle_root
+ ┣ .trestle
+ ┣ my_task_2
+ ┃ ┣ sample_folder_0
+ ┃ ┃ ┣ a_template_1.md
+ ┃ ┃ ┣ a_template_2.md
+ ┃ ┃ ┣ arhitecture_1.drawio
+ ┃ ┃ ┗ another_template_123.md
+</code></pre></div> <p>If you noticed, names are no longer needed to match with exact template names, and that´s because validation will run through <code>x-trestle-template-type</code> field defined at the instance header, not through the name.</p> <p>To validate the documents against their respective templates using <code>x-trestle-template-type</code>, run:</p> <blockquote> <p>trestle author folders validate -tn my_task_name -vtt</p> </blockquote> <p>Now, <code>-vtt</code> stands for validate template type. Validate template type option will provide you the ability to have more than 1 instance per template validated.</p> </details> <details> <summary><b>headers - Validate only the headers against a global or a specific template </b></summary> <h2 id=validate-only-the-headers-against-a-global-or-a-specific-template>Validate only the headers against a global or a specific template.<a class=headerlink href=#validate-only-the-headers-against-a-global-or-a-specific-template title="Permanent link">¤</a></h2> <p>In this section we describe the functionality of <code>trestle author headers</code> command.</p> <p>Trestle author headers supports a slightly different usecase than that of <code>docs</code> and <code>folders</code> above as only the YAML headers will be validated. This command can be useful when one does not care about the markdown structure and might want to use global templates (templates that are shared across multiple tasks).</p> <p>With <code>headers</code> template folder can contain both .md and .drawio files and each file will be validated against the template that matches the extension. Also <code>headers</code> allow user to have <code>global</code> templates that can be shared across multiple tasks.</p> <h3 id=creating-new-tasktemplate_1>Creating new task/template<a class=headerlink href=#creating-new-tasktemplate_1 title="Permanent link">¤</a></h3> <p>To create a new task run:</p> <blockquote> <p>trestle author headers setup -tn my_task_3</p> </blockquote> <p>This will create a template folder with the following format:</p> <div class=highlight><pre><span></span><code>trestle_root
+┣ .trestle
+┃ ┣ author
+┃ ┃ ┣ my_task_3
+┃ ┃ ┃ ┣ 0.0.1
+┃ ┃ ┃ ┃ ┣ template.md
+┃ ┃ ┃ ┃ ┗ template.drawio
+┃ ┗ config.ini
+</code></pre></div> <h4 id=extra-options_8>Extra options<a class=headerlink href=#extra-options_8 title="Permanent link">¤</a></h4> <ul> <li>If <code>--global</code> (<code>-g</code>) is passed then <code>__global__</code> then it will create <code>trestle_root/.trestle/author/__global__</code> folder. Use this when you would like to use same template for multiple tasks. <div class=highlight><pre><span></span><code>trestle_root
+┣ .trestle
+┃ ┣ author
+┃ ┃ ┣ __global__
+┃ ┃ ┃ ┣ 0.0.1
+┃ ┃ ┃ ┃ ┣ template.md
+┃ ┃ ┃ ┃ ┗ template.drawio
+┃ ┗ config.ini
+</code></pre></div></li> <li>You can create different versions of the template by specifying the version via <code>--template-version</code> flag. See <code>Template Versioning</code> section for more information. By default if no version is provided <code>0.0.1</code> will be used.</li> </ul> <h3 id=creating-new-documents>Creating new documents<a class=headerlink href=#creating-new-documents title="Permanent link">¤</a></h3> <p>As of now this command does not support the automatic creation of the sample documents.</p> <h3 id=validating-the-templates_1>Validating the templates<a class=headerlink href=#validating-the-templates_1 title="Permanent link">¤</a></h3> <p>To validate the documents against the template run:</p> <blockquote> <p>trestle author headers template-validate -tn my_task_3</p> </blockquote> <p>This will ensure that the respective template files are parseable.</p> <h4 id=extra-options_9>Extra options<a class=headerlink href=#extra-options_9 title="Permanent link">¤</a></h4> <ul> <li>This command has no extra options</li> </ul> <h3 id=validating-the-documents>Validating the documents<a class=headerlink href=#validating-the-documents title="Permanent link">¤</a></h3> <p>To validate the documents against the template run:</p> <blockquote> <p>trestle author headers validate -tn my_task_3</p> </blockquote> <p>This will validate all files within the directory against the templates (of the matching task name) by matching the extensions. Please note that <strong>only</strong> headers will be validated. There is no option to validate the body.</p> <h3 id=extra-options_10>Extra options<a class=headerlink href=#extra-options_10 title="Permanent link">¤</a></h3> <ul> <li>If <code>--global</code> (<code>-g</code>) is passed it will create <code>trestle_root/.trestle/author/__global__</code> folder. Use this when you would like to use same template for multiple tasks.</li> <li>If <code>--ignore ^_.*</code> (<code>-ig</code>) is passed it will validate all files except folders and files that start with underscore <code>_</code>. Use this option when you would like to ignore any folders or files that match given regular expression.</li> <li>If <code>--readme-validate</code> (<code>-rv</code>) is passed README.md will be validated as well, otherwise it is ignored.</li> <li>If <code>--recurse</code> (<code>-r</code>) is passed the documents in the subfolders will also be validated. By default <code>author docs</code> only indexes a flat directory.</li> <li>If <code>--template-version 1.0.0</code> (<code>-tv</code>) is passed the header field <code>x-trestle-template-version</code> will be ignored and document will be forcefully validated against template of version <code>1.0.0</code>. Use this for testing purposes <em>only</em> when you need to validate the document against a specific template. By default the template version will be determined based on <code>x-trestle-template-version</code> in the document.</li> </ul> </details> </details> <details> <summary><b>Template Versioning</b></summary> <h2 id=template-versioning>Template versioning<a class=headerlink href=#template-versioning title="Permanent link">¤</a></h2> <h3 id=prerequisite>Prerequisite:<a class=headerlink href=#prerequisite title="Permanent link">¤</a></h3> <p>This section assumes that you have an existing Trestle workspace initialized, with existing template and governed documents. Please follow steps in the section <code>Setting up the Trestle Workspace</code> if you don't have one.</p> <p>Trestle provides the capability to version the templates and the documents via <code>x-trestle-template-version</code> field in the header.</p> <p>Consider an example where we have a governed document called <code>Decision 1</code> that we now need to update to contain a new header field <code>approved-status</code> and a new required heading <code>Heading n</code> at the end, as demonstrated in the Figure below: <img alt="Decision document update" src=template_versioning.png></p> <p>The intended workflow in this scenario is to:</p> <p>1.Create a new version of the <code>decisions</code> template:</p> <div class=highlight><pre><span></span><code><span class=nb>cd</span><span class=w> </span>my_workspace<span class=w> </span>
+trestle<span class=w> </span>author<span class=w> </span>docs<span class=w> </span>setup<span class=w> </span>-tn<span class=w> </span>decisions<span class=w> </span>-tv<span class=w> </span><span class=m>0</span>.1.1
+&gt;&gt;&gt;<span class=w> </span>Set<span class=w> </span>template<span class=w> </span>version<span class=w> </span>to<span class=w> </span><span class=m>0</span>.1.1.
+&gt;&gt;&gt;<span class=w> </span>Template<span class=w> </span>file<span class=w> </span>setup<span class=w> </span><span class=k>for</span><span class=w> </span>task<span class=w> </span>decisions<span class=w> </span>at<span class=w> </span>.trestle/author/decisions/0.1.1/template.md
+&gt;&gt;&gt;<span class=w> </span>Task<span class=w> </span>directory<span class=w> </span>is<span class=w> </span>decisions
+</code></pre></div> <p>Add the new required content to the newly created template. In our example simply copy-paste all content from the <code>.trestle/author/decisions/0.1.0/template.md</code> and add the newly required fields.</p> <p>2.Create a new instance of that template.</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>author<span class=w> </span>docs<span class=w> </span>create-sample<span class=w> </span>-tn<span class=w> </span>decisions<span class=w> </span>-tv<span class=w> </span><span class=m>0</span>.1.1
+&gt;&gt;&gt;<span class=w> </span>Set<span class=w> </span>template<span class=w> </span>version<span class=w> </span>to<span class=w> </span><span class=m>0</span>.1.1.
+</code></pre></div> <p>This step will create a copy of the template of version 0.1.1.</p> <p>Now you will need to fill the documents with the updated information and new fields.</p> <p>3.(Optional) Delete the old document.</p> <p>Now that you have a new version of the document, you can delete the old one if you no longer need it. You can also keep it if you would like to maintain a history of updates.</p> <p>4.Run validation.</p> <p>After filling the contents to the new version of the template, you can run the validation to ensure that everything works as expected.</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>author<span class=w> </span>docs<span class=w> </span>validate<span class=w> </span>-tn<span class=w> </span>decisions
+&gt;&gt;&gt;<span class=w> </span>Instances<span class=w> </span>will<span class=w> </span>be<span class=w> </span>validated<span class=w> </span>against<span class=w> </span>template<span class=w> </span>version<span class=w> </span>specified<span class=w> </span><span class=k>in</span><span class=w> </span>their<span class=w> </span>headers.
+&gt;&gt;&gt;<span class=w> </span>VALID:<span class=w> </span>decisions/decision_000.md
+</code></pre></div> </details> </details> </details> <details> <summary><b>4. Authoring of OSCAL Models</b></summary> <h2 id=oscal-authoring>OSCAL Authoring<a class=headerlink href=#oscal-authoring title="Permanent link">¤</a></h2> <h3 id=catalog-authoring>Catalog authoring<a class=headerlink href=#catalog-authoring title="Permanent link">¤</a></h3> <p>CLI evocation:</p> <ol> <li>To generate markdowns for editing a catalog</li> </ol> <blockquote> <p>trestle author catalog-generate</p> </blockquote> <ol> <li>To assemble markdowns to a JSON catalog</li> </ol> <blockquote> <p>trestle author catalog-assemble</p> </blockquote> <p>The <code>catalog</code> author commands allow you to convert a control catalog to markdown and edit its control statement, then assemble markdown back into an OSCAL catalog with the modifications to the statement. Items in the statement may be edited or added. For more details on its usage please see <a href=https://oscal-compass.github.io/compliance-trestle/tutorials/ssp_profile_catalog_authoring/ssp_profile_catalog_authoring>the catalog authoring tutorial</a>.</p> <h3 id=profile-authoring>Profile authoring<a class=headerlink href=#profile-authoring title="Permanent link">¤</a></h3> <p>CLI evocation:</p> <ol> <li>To generate markdowns for editing a profile</li> </ol> <blockquote> <p>trestle author profile-generate</p> </blockquote> <ol> <li>To assemble markdowns to a JSON profile</li> </ol> <blockquote> <p>trestle author profile-assemble</p> </blockquote> <p>The <code>profile</code> author commands allow you to edit additions made by a profile to its imported controls that end up in the final resolved profile catalog. Only the additions may be edited or added to the generated markdown control files - and those additions can then be assembled into a new version of the original profile, with those additions. For more details on its usage please see <a href=https://oscal-compass.github.io/compliance-trestle/tutorials/ssp_profile_catalog_authoring/ssp_profile_catalog_authoring>the profile authoring tutorial</a>.</p> <h3 id=profile-generation-with-inheritance>Profile generation with inheritance<a class=headerlink href=#profile-generation-with-inheritance title="Permanent link">¤</a></h3> <p>CLI evocation:</p> <blockquote> <p>trestle author profile-inherit</p> </blockquote> <p>The <code>profile-inherit</code> sub-command takes a given parent profile and filters its imported controls based inherited controls from a given SSP.</p> <p>The leveraged SSP is evaluated based on whether provided and responsibility statements for all <code>by-component</code> fields are set for each applicable control, as well as the implementation status. All components must have exported provided statements, no exported responsibility statements, and an implementation status of <code>implemented</code> in order for a control to be filtered from the output profile (i.e. controls delta profile).</p> <p>As with the other related author commands, if an existing destination file already exists, it is not updated if no changes would be made.</p> <p>For more details on its usage please see <a href=https://oscal-compass.github.io/compliance-trestle/tutorials/ssp_profile_catalog_authoring/ssp_profile_catalog_authoring>the ssp-filter tutorial</a>.</p> <h3 id=ssp-authoring>SSP authoring<a class=headerlink href=#ssp-authoring title="Permanent link">¤</a></h3> <p>CLI evocation:</p> <ol> <li>To generate markdowns for editing SSP</li> </ol> <blockquote> <p>trestle author ssp-generate</p> </blockquote> <ol> <li>To assemble markdowns to a JSON SSP</li> </ol> <blockquote> <p>trestle author ssp-assemble</p> </blockquote> <p>The <code>ssp-generate</code> sub-command creates a partial SSP (System Security Plan) from a profile and optional yaml header file. <code>ssp-assemble</code> can then assemble the markdown files into a single json SSP file.</p> <p>For more details on its usage please see <a href=https://oscal-compass.github.io/compliance-trestle/tutorials/ssp_profile_catalog_authoring/ssp_profile_catalog_authoring>the ssp authoring tutorial</a>.</p> <h3 id=ssp-content-filtering>SSP Content Filtering<a class=headerlink href=#ssp-content-filtering title="Permanent link">¤</a></h3> <p>CLI evocation:</p> <blockquote> <p>trestle author ssp-filter</p> </blockquote> <p>The <code>ssp-filter</code> sub-command takes a given SSP and filters its contents based on a given profile, list of components, control implementation status and/or control origination.</p> <p>If filtering by profile, the SSP is assumed to contain a superset of controls needed by the profile, and the filter operation generates a new SSP with just the controls needed by that profile. If the profile references a control not in the SSP, the routine fails with an error.</p> <p>If filtering by components, a colon-delimited list of components should be provided, with <code>This system</code> as the default name for the overall required component for the entire system. Case and spaces are ignored in the component names, so the names could be specified as <code>--components "this system: my component"</code>. The resulting, filtered ssp will have updated implemented requirements with filtered by_components on each requirement, and filtered by_components on each statement.</p> <p>If filtering by control implementation status, a comma-delimited list of implementation status values should be provided. These values must comply with the OSCAL SSP format references's allowed values, which are as follows: implemented, partial, planned, alternative, and not-applicable.</p> <p>If filtering by control origination, a comma-delimited list of control origination values should be provided. These values must comply with the OSCAL SSP format references's allowed values for the control origination property, which are as follows: system-specific, inherited, organization, customer-configured, and customer-provided.</p> <p>You may filter by a combination of a profile, list of component names, implementation statuses, and control origination values.</p> <p>As with the other related author commands, if an existing destination file already exists, it is not updated if no changes would be made.</p> <p>For more details on its usage please see <a href=https://oscal-compass.github.io/compliance-trestle/tutorials/ssp_profile_catalog_authoring/ssp_profile_catalog_authoring>the ssp-filter tutorial</a>.</p> </details> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">December 19, 2023</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/Trestle_authoring/trestle_author/sample_ssp.md.jinja b/latest/tutorials/Trestle_authoring/trestle_author/sample_ssp.md.jinja
new file mode 100644
index 000000000..b6056a2bb
--- /dev/null
+++ b/latest/tutorials/Trestle_authoring/trestle_author/sample_ssp.md.jinja
@@ -0,0 +1,48 @@
+# SSP template 
+<!--
+This produces an SSP analog. 
+-->
+
+# Frontmatter
+<!-- This includes frontmatter.md showing how arbitrary prose can be inserted into a document --> 
+{% md_clean_include 'frontmatter.md' heading_level=2 %}
+
+
+
+
+
+
+<!-- This iterates over the controls in a resolved catalog and prints out the control statement, summary table,
+and implemented requirements in a format similar to a FedRAMP .docx
+
+The groups are sorted by id and the controls are sorted within each group by sort-id if defined for the control.
+
+The control tables for parameters are output with the param_id in the first column followed either by a single
+'Values' column, or two columns: 'Values' and 'Label or Choices'.  In the one-column case, values are listed if available
+and if not the descriptive label is shown, unless the parameter has a Select defined, in which case the choice options
+are shown.
+
+In the two-column case the Values column is empty if no values are defined, and the Label or Choices column is either the
+list of optional choices if the parameter has a Select defined, else just the descriptive label for the parameter.
+
+To choose the one- or two- column option, specify false or true, respectively, as the final parameter in
+get_fedramp_control_tables().
+-->
+# Control responses and guidance
+{% for group in catalog_interface.get_all_groups_from_catalog() +%}
+## {{ group.title }} {{ group.class }} \({{ group.id|upper }}\)
+
+{% for control in catalog_interface.get_sorted_controls_in_group(group.id) %}
+{# ### {{ control_interface.get_label(control) }}: {{ control.title}}
+
+#### Control Statement #}
+{{ ssp_md_writer.get_control_statement(control.id, 2) }}
+
+
+#### {{ control_interface.get_label(control) }} Summary information
+{{ ssp_md_writer.get_fedramp_control_tables(control.id, 4, true) }}
+
+#### What is the solution and how is it implemented?
+{{ ssp_md_writer.get_control_response(control.id, 4)}}
+{% endfor %}
+{% endfor %}
diff --git a/latest/tutorials/Trestle_authoring/trestle_author/template_versioning.png b/latest/tutorials/Trestle_authoring/trestle_author/template_versioning.png
new file mode 100644
index 0000000000000000000000000000000000000000..4f6701e6a9723b9424f33677bb4515ca17b8c3bb
GIT binary patch
literal 44185
zcmcG$2UJwsvNmeA1wkaLBoP&nD48bOA|N?PP68s5M1__Nq6861g5(B~93<x`2!cd~
zCMU_z<ShBG#=Xzk=idL_amRb(dBz#LZC9@~*PJ!Ks`~1y>7%3|MMQ9k;K-39ME9g6
zRE``u#svS5MI3`~km(2S;Xfx#Z_D34awI2!aM$o8{Qa`Aw2J(ZBaYXP9C_(+<j6LB
z^>X^i5j5wKBe)0ftMDU7sGdfbDhtCuoHCM?k~ngJ|KG=o<Y2h+$UTYM_wD=UFb=wY
zGY1D*HVXZM$$CydAAMK(l>Z=?{Q9@|)tb4)M)x<AjUI;2)%0vOzsd2kyk_<0s*L<6
z61EqT_hw66-E@ab+@@?=nZJeK$m$;3tDn)&v>DczLW{Mb^%iH59w?F%x0UpKJ`!9;
zyt=G(`qgE`G4$nWUu?QY*3FwYMSs<%9sW7zI*h~N+-w{NQ_|9KU7vLX1qDBR`0zVL
z{3G$2er{e~M@NU##@xl7yp)tTB+sW>F^aB+@lpXXTqZJ@iou`pQq}{-40+GS8-n1r
zsi~>-O0CmB<C7II+tuA<7cK}qY7XBN7U1G)|M4T6Jze=q5UWn1+*Q)lw6qm_VPoSl
z<9dIWfktm}+7!dauC7oLF2kA=X1Ir@rfw^QO$`mj=vj44g<crDo_dBRLq%eFd360)
z-M4S9nu76?e%t)mGYG^55yv$ry4|&zj^g6t(u{8uEb5QV%_Suy?yISZxbE6dHb=nN
zw6wJ7(^nXjPMbGiFN!)Bi(i(Ok@*xtNlEz}drwZz_QeZ6F0M;FkAIBS2f$0u&(Ft-
zxhXKyB5hM*W9bvu;8iy^HWXt;CkS-Q?Ux5iY<4ym#jN^xd?a#hXWAdNMDkj6S&r0r
zlKOb4IPPp%@$>U@bLTOuCao<D3f;Q3yt}n3;<WKFxxTg*hU%@dz1k+0#}pJ5)nAI9
z?aMbKqo+TZ>&;uN+-dFU>FMm`y?OJk-ov&S5x3oCDQ<3VMa8z1loVoG<OOQ#(<e{n
z95Y#XrGj+Z-*s4>bZ~UU&CYJlbWC-oYxq*Kk@~_MeS?J?c~aZa5lmuaVG#w(8XVkF
z;bccd<QK}O1M{OKlcihIo~#(_Nk~;_+52ATZfUe~yyW`gaFuCWjH9EY%g%<&-ZpRI
z{rznd0e**-hlGTL=gtM}@9l8oZU|2l4ZG$Q7UHK(%+=Y<Y^KhaN<>72IdOAgkXrD0
zLQIT)6rWXVj0lUK-%3$ncz92iLDkEbN8nv_bozh)w)ebt!*cqug~jR9r)_j#iFS8)
zTVusIRM}QO80hOSOih`Znf2zHH1+10Hr<b`Id}F1PMpXOY0;fYE9P2WQQ@MdMj?fH
z_3Buhl7Q>(@064qc6N4DRADPC&vP_sE?(5q)@~eIURz&hPCQLalU-OC%Kmh;*2g1o
zsKTkfzTUbw_pYq0#b7Dgo0!%doAMLana-Su5whFIrDyrm3Uy@}h@l$32QvlG2pSm~
z)hLKL|ISWKyk^0&yY%&3h>De!6)$f=s%kPN1w~0&nUH{hgoMQIT8ARMN=ZpcP*9LZ
zps35Xho|R7YHBi6D63ZP!|$Z1h6<<6@x@mk<Pch5N3i7z3JNr`^f4HWm4(IZ*jR8_
zSp8tb*6P$5hBCWF*S&3YQz#oII$9xCwBqRq%EV+sr|8LDDJe2kB%f93lR@MH`ONd4
zvSu*XdVgA2wYa#r5S6Xju*}j#*|1z~uuDn?4`r$S5G?jST|f~S>zg+S7M66Y{=&PG
zlDTf)MMZX1u6ykI<<qmX7Ut$RgQPWi)ipGlhL5Eq!Ri_sq@|>!)CE_rHMl*Z6LpqG
z+>@3L9KNQ<M!@2>j_aJ9oRkWn6L~i3p>*S&zkg^Zk0<>F1lIl1Wps?FOImt**^7B?
ze<T9~gC8~jqjQ*d@6Mv6U0q!lhboRAKRz}(3h$AYl=Nb@>oe>Yxfo$BFQippzF`*Z
zK`_o%eGbj+FP)w1VA?V=GW^y<2_cpC%cCNxc`zL^Gq7L?1^@^nsY3J4n>;)`TwL$l
zrl_c>RAs!0s3*tAC73^FW>OM(Dl01!EE-``l!u*HiC7-izBw-{DoP;aFjVQ%lr}nA
z=j#y|9ZgeMao3kpHjLdQKx0ev+6-MG7)zet9dF|G<z;32z4oaW^L^{dv93m0w6wJF
z-k+C3zyy#&LV0Yk;<MdZQz;!VYOtS2j~<1Fg~bZlW#;C-SBtOFdGqeweRcKy*{rG?
ziRaIsFD)%4kPSR&PDoBBLy`N}N^AJmG%Cu-l-kay+`W5OT|M-}2a0r-%=U3H&Zjq0
zj`Pall<=>gk(wG28QDlzF!s%l(PPP8m@YsH!QhdQl;q{*^<t)dBFw-wLfGMX(UZYK
z>)|IB7EWu^$`^5R(E>pgT|a&Vve)+YZ39S0Mn(?sKX!3(xrmz^t}=*0{`~nfq#XvI
z$1*~27J-1_@^ErKnDVFQSJ?inh(RVUu}k`0nwXt!B90Pv;G)jY@<di0>^lJx7te!L
z!)iO)+UEQF`#ZbHsCrX>ixqe_8h*=|Twl!2NJ}dsH<znB6@D({xc1mHd2MmnZJ_vB
zyLF>7lZZ$KpqK{<3k%DJwMl2n5@mu7iIK7K-77&gq~mHTDkwy6@w51~Z(y@^b#?a+
zXG&Jq292gboPc?RSK-129enu`_mLR;AXQaQZ+?2Zr@%sEBL#EI*bAWI8UD|*FBJ#u
z<i^HEE^cm5RGhcBl)b(E)2B~|D_u%Bn%c33pHIt}!L+*VZ<(q~D=4&r%_&9;#AReO
zSKbZ_3nM&nOp<nC8TOEh1Fp8VR!JuK{d)w%#fuj+zKoBLmzS5rX7SgAJB$rQDoc&%
zNe8Sd#t28CA9kWJU>opzKF&ML1-ZG%r@zE)ZFwwcuqfIEz3U3m0{BVk=5WbOOq|%5
z@9&+}uW;<NZHyMQaa_mM5to6j+uI9BVc;?C?d=&E86`GTH<_75?3Z5RZ7VPn>5p8w
zc4N0kQ&ZF4!Qq*ksOzrgy?Zk&6HV=%pR!j(goR7(7F(YTeE)vW3%NpnL4X|Vj*GZ*
z<qAA#T@-7mNV9?A5fa+@y*%bDDt7ZGt|f~9=+UFw+uLU;l9G}#(yy|!`;)Y%sxn0!
zOHAc{KHdO3VX(^W0Ng=lW+vHnxrVkj4Q1uta)&&LD_RBS6tjl1_wF%xNZh>(9y$dU
zm{&O&Tr{|tjwE>&Ha0(he|1$=-?wkmFi3($6ayLtNO$2vN+5F1OaL5PZf-6i6+7a@
zD=H3stORW)jRWpRx$BG#L>GNI#`S=X`sMb@dU_Q}sy##D;o<cG^hIVJk6`v`(0v6K
zRHURTV0BSZEF=iHRk3+U)k#lm5C?;Zh|5fSB3Ds~X&c?OYl#MKdw6UC$OcznF<dD!
zYdDs6*Knf0x3?vN+gs%l1w~>;M!97#*NjXs*jUX+;`_0%ktGqzDk=m71Zh4ZFJ8Q8
zr)6fPdMRSgq!=TIP*zjp<>Er3apXb|n!|6sBd{K>R8vzkVPxmRjz~JLtgiMKTEVbR
z9J>u4=tUeQn287px%v62d?X-{P*qhG0&jcwu4hyfHG_n#EJSVk8M_dI<hgPJ>`2m{
zQYIoIf;)=Fw$UYVVIz3VNTo2aby>=N;VQ)_K6x)>)$R%*gM{Pn$j+hp{vzf?p%-&X
zfPoqsQ>$BZp=}r;ra{v>9~P-?y$fh^{i=MJqvq!36UW@s(#!!n%#n$urQ2nTmB##?
z5b?FQt7Jwk2Z-(e0Q2kY>}+p0DyUbB-(_o1l47M~VKwZ|)B|{4vAaZ0p77~YO=VKP
zMfXCR*g;4Z<yPZ4LP9d%I&E!jK0dy$UPNR*5)dSe-IO0Wed-wc<90%UMfY2YD?!p%
zDSa&r73IN$%E-&Jv9ay_B23B5tVGX-Hm5kLsdWO_UnTX4iyHyAEGPjXO-0@pyhlh%
z0w?UUR%XAwX2#Y;vb)}G0Kw>@s(V40>drds+~nlsu#k}Q)eta}Jk}Q%DX6HJu3cj;
z@7*l-)RqaX3Zv$Kg59qQ%-S6tHDY(j`uOoB(aN(ANlV9%yCaoc%oiX|$>T_%aRQTD
zj?j(aLE|Ipj|aNCj%{u?-NnCDQ2N#lXs$7JH-2Cd^X|0!*k({&T}{9AeQMc01*vp;
zd)V#xmi58;6)Ozv1Q$^&T0~m+{ws0XVw8IO7;<&8WhZ$INpiyN_D5pf<#U&i86S=h
zNzaaDK6PFg5CnjX+!!i%Sp8M~8f{~ME|=loJ?V~o>UoS-=*8Lcpr7@6BgIKRLUI5y
zroL;iv+X}T`Av8X{p;;17SD9XrYyyB^Uk!zs)HDn?O)Z$ot$<c&Q+Ch+nMK|p-*#|
zBB*C)X9tUs1$%@)=jen5jA{|bkH4l9aTJEV2o?kvfDeZSgqRtw3QqFhHE#^#FyQ0m
zrSOp$8XCI)^H_7Vu&}VESx7qob&lD=O1*5>)ZSuPm{%1fAy{{E*%4gB$}AaJ{C(KB
zX=yiwg`-JoChrqp;*oYN$+OFR%1TZkFE4L5-v?Wg10@aUa*jse!Gj0c&Rfq5_rn1l
z!QH-k{n~_*InY3UYoaM^e}A7%JHPnFd}PhZa6$QKf#vk9N~0`2J-y?{j*-)GRK#pn
z8R%ca&$ZI&v>@b4I%9YK$MyBu?qs<Lh>R^vO{JK5IXMAx%5BXGvhYK&TO5*S7I{97
zU>FB@3sJGQUOYo~ofG$TjE9(**lBZNA|?JQuSur2{K&E9fol+LuWapt+ovQaU$QTc
z;<vsjtnVnY=vGzEgI^~=3`X?0hLn1-=rah?y0Z+13$6Oa_J6<LyN}UiW#{0~kf!y#
zhVVpn9Yuo)&rAfvWlbr;K|$4g#22|9wkO=9L6c`DHG@;ZKTu6WBPu+64p0tu)7emh
zfH3{Gona0RBE0#e9PgB--9q1_$W$zUQ2h#G(3I5F522xjPX<c?t_K1J8dRkW&!FO#
zYCH+wA$6m~Bar~H<B{jx-QEB3n05_b$Zt3}I3TPpyqr`smZ+h=x7j57)qo`BI8OZF
zC6b_<>Cv8SM%J7+z3XL<46QuLr2IY&0aqrpq(2R0T;I2cKgGuj;%?~5I{@Z`M+uX@
z%KLewWd?Q$Y;y3#bM+@-jpQ-^o~ku{tYJDMi*9UjZmx=~tgi^(0>lx977ViK8x;O`
zubhu>jo>yd&b(=c%Qx$g1en}Q;rpO%qBUaP$p2)3#782dB>pLpwV9TVj@?YV=Z@;W
z{mgp#!QM*y64eRZOXLr+j?-C+yM`<@-1t;;xXR67vS=<GKfjLOd%n4qdfCm_AM8vd
zj&ML6%kr^Jg9fccf&c9niXU#7Z{NN>Nk}Q|v~gDL=;3xfdYfeTBu@P4$rIK1snHOJ
zzryA`dE)jGRm$;diobUC|NSx&-J}1w3@wZC<NkUcP2xdv|JbpkZZ78!{OwejIPwt7
z2B#TLe0VAT#ehf@P~({U%PJCp3U~3#zc`dmAJw=_vP5+ZMhjjA26Oor!HHx0sFyGb
zxC;aR2bq7aJiO#L;ZdBkxNcQo5XN!Q7hSjat|prLoapbhrd!>=C{LukPEo~$M}(gj
zobPv-j@PZ<*YiHZK=w^erFgS-y<D(ka=+B5<8)Z;i{-ZKel1xB4G-K3A3w5rtXO+G
zBo95<+Tq>y%&jqmF>f=r^c6<PxuN0w9m&q;<7bC^jisCqV(KLC);`g#;N{4BJoRn(
z>>82SuNotTs~4s(+CE>{&DrlpNYK_}W*xwzq<C*jVV*HEo&EjjW4fvo>P=42_m|eE
zh<`u&RWi0rKY`qs7nVR=6zh{38G6T3bcO*FE#&re>+5N!1J3Gz3I$;sEgjjZCyx84
zL&oN&k#=3Xk&Qt^J4dmGQ^fRhA}};<f6I>cjZLea;k=&M*Qma}z5{C93AuBZ_#W5B
z4g2$&S?*hF%OYx%-!_j6T?s<0D;YTTY*?OQ^042S{<{B8l(M^bf`!&fuZ(Xas@t-y
zi4{rmBEdz+o0)7^sLZ)DA!qB=%UG%w!kpafLbIWjh9NSCh`VBPOMpEG9nqd_I{D^9
z`E}bLqD)d?3O$U=i2ZD-(T^8tcxIE!n?Ef)S@0lXlm85pFm6KmSwA<^p@R~Cg`G_m
zxeLtUjXjmFb7Z^CQJOpj=6vQo;X>W330Yf{6PE7cf%Y2&J2v|P)yH>;L<<-1+wpJC
zs6OH?Fb@sW$~Ww!WFfT3kse62DI!$<KDYBT{QTJ3rJ0%8nVol-Xq&NWxhi@Hl-*;h
zao1*xpBLK&4GA^5wT7J87b#u8#Q(eo4Cm#{ZAy7own$BdSgu)DNkjcdKmCcEbTLSC
zGjse9FNN`SEJ~peLSgZ(e!daI&Vy~@Z6959P7`y78E2ZMSd0(YlTe)RZyHq9NDc~q
z-4t3Nq)F@AnL{YV>Rew9Z-0JA;nJlGsi|iwDz{#My}$_ls0FLVhqLc;M}4iL*RT(O
z2~{9wuXgv1;<tKsc}`mYk@8L<u@L`0yyio*C+pUcQTPR<rs6Kh&sRQ2<c{p^UbsXZ
z0qIly3)<Q%w_@AGayM)7kDiJOio4}hJ+^$7=pBNgC91HYi4`}vN{vFqw(;NMGjVF8
z@fk_65sUvJKCGmr)m!1~T^S?FFfQH`wC_@mV1Sj`QjBc%$0~I{&9=Mh!E?*vIlsuT
z-ROOkv_adx|2&ceg>u!t?$RQ)5u>C^CQ~HMm(^Qow?pqivU;5o-a(OGw0>&U``m_T
z@zi6}uq;cRqKa7M=_zh`9a+<#<$<)+8;>n!z(U`OIK;sejNFmr!sa|LHcH$Cla@!!
zY<$>p&t{aRWbIb!MiA?kGuuWLhPLj~zs}2?G`E=9<uM(x*4gasFQlFo5#1O+i9*=1
z$15;RwHAJ!E8Hu!z>Qx7X!bE>pE99ji==Ar&J%lmJK#wL@w`tsSG9qG;=#uHj!xIY
zFKuoxcx%f(0g;)mp7X;xTAEUH!eusN)*gYGm@;eKiq4#h;MWz#`j3KkMJ7!s&CDOC
zrKR|<)4B1ovt1L_V<pX7&W;(Z+AlmHu|K7}ctvo*3nmj6$Dm}olT~(xp<+NJxHa)a
z%eD^*mr=tFN!l*N(sWlaNv`ckBOn$JFOOP?ngA|i+oT0d5hj8ZB@p_Kem>Zh*`o2p
z!3W=NiMzFjwxm+(-7*_xeTJdQRsVx6yC-_nb5US={1*ywk^ecWXR@MdH=oCHRe#1p
ze`7W6QCCaJQMx##a5Qh2GSj5Qu~}gNiBQ_78`BOb>CuR$Q`=rPNi8PSdrb1Cr=Pk!
z))ge!8TLB2@#sxU6RWvN$M%jgS?{cwShMAD*T}Z#Szg|e@#RW0s)KSGoB8p$8(VaR
zzg5E!3>oO~FfD9z>6W4mB}|YDn7zf*44uklb6xF6E0`9GLNXM)BvX^BRFbz}{g}!1
z;qOhXeYr1A@8FV`=y-W~k`*KB_}KM|bHmD*oJ5{AKkV<a8o4M@;R_o&>D!|eZ!dAo
zNq66e?+Hs?CR$U*rnuQS@)~x^etHDnsiJLaV&&rHBSV~^L2J5occF#OFx)BklG)65
z5i|dkmUhYF)OXc-Si|Nhc7uG!!4*G1<T*U%Z!QR2c4-kcW-3GD8uhaPl**!<VCxUf
zyFE5D&+!9%7(KOQoj6X4+D8ao!LZ~!U%te6$Ji|M=>%2+GxEBkS29PM)ullGQdHh`
z-%?FX{TLqdauySW(KURFA4*!jkGXJX4ghn*&tb|PlG}CFf~!%<bg!{x1#6bj|7L!$
zZ0u!Z<WlRpu;*q<YFr8IAj^0sssOdB48ts{*1fv+0fLy@*s?bw4%MH0t{ocHd@fPO
zXPZfBx$)|}9XncoQA!O$wC1HV@vWs3)T>;+ldX|$G08M&*Wtog5+m#Wh323Ou{psL
zsU3Mc-5KZRn}fpRM}pv&3O<Tr`AkNuk@I4wJ&Vye8HAZthvar-vfNUU+0grnjk%wu
z_m<us#J3LXRj6M7ZG-R;wpUlX%PX`V<3L8Z;4ZYa!|dX?{$Y|pL%|QbCB*opr{SU3
z;+$Bp&AwdgJpqjEXh6qISZ*twh})FoP$kA2DQNe?a`CDn21ei!IBooFu6ArkQSWVK
zsq4gKE4#sj31wn!GH@sd0=!FY<I%D|H3V_fyzOHuN5)gX-ttj~FhY7n#N7O`*P;Me
zT?m?2<0|Q3ark#$tbjcu$@+~?SBy%Ah$Z%t6h?blZZ_V;8LfjuEPb({fY>r?t<g@2
z2PQ<hzAtxXd@&i8`8>+Czce78c*lQnsGuIKr?<HE?cF%H>r*5sIlmV0kp?77+zhqV
zL(5YiNyv;<-Nm2YLYCZdG8K&#JE;G)&ceTHUmnV)ea~PO+@B{3?>y#bH|wq}cNX(p
z#L*B1ko(qVc=B{P2~!8ti}lriubxm@>jXdC6)GRbt{VY+=VwU=IKPCZ@A6K+$FN^|
zf~krtxUd&{?365`_^9H8IV72itY<kbf4qSWcVF$kR*dbh=B;;cJV<724&+*YcD3UH
zV56YSspuds?bG&7;ohF(IZc7hFz~&rLBJQQdVjKcB79+1B&L9t@mw^6$8M#Sn~Za5
zVhKfjD~A|c0Z&nBtTONx1dBoOt>8nVX>^OtX<!8M_q-6bQ#3)RTc7Gpzj2KHT4>lA
z%ExA<MHOfoAPO#s3-?<wGA2xm=lOJaWJ*U@R}6;NyywD`%GTdMMeRCP=dJqBqwa^O
zX@2#j{Q)L;%>4^YCPXtHw}Qb9<`}zfnK3)P<KwexCb0b3>?Oi;aG+^4hekC_gj*O!
zZT9sSj>VMsX(I>D%5-^<`qm=*N-YUmw;Ck4$++FcKc=O1#Z}liwtt3q?NvRFVEB5<
z?^mOt$a7ZTck`G7<E5qQp`l^FN2hfKWBYRNvH;;QwW?G2_ycJye$+j)LUaMi-O_Ch
zKkR2qG4GIEQ%`o#VVYOfmDNX<?HRrOOQK@3QsW{3a4GteH4IElOoF6&enq)Y%Cpk+
z3r!5zfB9C#gXJASqD`=ZF2AEABeOq$t~iUn;6*VMADTp&{)IvR&Qy#37d2y{vJDnW
z&l>JGj#S_|ADed5K_r$M&q>;*J9+&<CHDn10A+G*a<V~Vn%Nr1PM=<cpO%IVV92Aa
z#iS`Idf#Aui(jsiBfarc!DCNuux9sbEU?~A50yrSky4yz5xI7af8OxE1Z$J#*yy(B
zJME;;HwK&*A63I_g_eA&tD7F@mNL@3!W-|uTT-O*T#@drk>5>Es^*)3LFL%mD4Ovn
z22~s`7iQzrXI{bZYus|YN+snFI8Kb(`0tew3kj8eqPs+n-dBE#O>NqNz|qv)^7^X4
ze#R)bL5^{4pt3vn)K|_oj^rAx$wOsYfni!}{ar2?y}=&It*pE^UWyn44a=3)h;Iej
zIM%|0(j6OpxjF7+g$Bi@Y|f*fTs<LlgtgY`o*&3DRD@8^;tW62yO`Q*Kdw|>#$CoS
zqDf%#%J>g5KV@7Yef#dLUkkMkRQ_(Vu;hg(K-hl-E(oCaYl+MjrWK7<L@2AO83*T{
z|44icd;2mlils)u(~D+($11;6$ezQV`SXK=n+r)({Oz5_SY<V3KQZ(f^fBCJaoQ83
zV(;o!L*IB@F}XHjy>m{|>Ln7PblUy5^%z7CC|-uxwk$I)`eWFmXc9zi{kyxXq2)I3
z1wIWaF<DT<(~43S3v1m-e!kS(IG=KdP?h9O8`Gsz=p{D^p8H|$$b*|#PinBNu)Afn
ziyA2}9ZxxKTCGJCi!9`mCkuFT@RC}f)Of;gdI_Ta-W|hhJND<Ic~<(h{dXNUt{yCU
zSDNPVw=IelqnX*{d<OEq)haE1&6J<yQ*GO4Crzt3n7I<Cy&Lp-rJr##;}*7KZ!`9$
zIzycuDP>#4K%Q^Yxbo`-ebJ<)hL)ydRC@yVTz7V&3327;(7#v(W@8ujuA~G<k^hvI
zO2>_SI9Ke>&OWcv9ILG=*zP1&Jnl23FFJJGLNK@DvplwPeNk&}+rZT}*Lu&ooWU*X
z084%AG+)K<)$-kqWd61~+M$(2F|`boq-%eFkGS=nhUi;&DsOS~-KY${?9#lRQsL_w
zoxn~?O#MT)(xb2KBzh<q`IIvH8d<^O-m8>6r2TfvZI{gGfx-HU)fz2PwkYi%H6dbr
z9A<`AnGBRJgPrR`AI9=I6L($T4;L?<UAOgHqi%^2&b_j@@`;|w$J6}VDMzO+w(-W1
z1$oECQNiG;?ST2=^rrkXUttBpTGy=}^%h5%jCtlc!{5ye8-22WJfWpU=kshA+p(8E
zlib#ArEcSDb?MIX&T)@Pf6Zp<<;~1gz=MU=8y2n_Zpurq%q)zuDP!!{fT69P=HHwf
zt#P5*DYmPmDe1>b8(h7=N;mzza$hcrv$<BOtt)A!&RD1?Xoa8MWx2g*t3OMuzmLbN
zKP}>5^G*am`H=RD(UGj^dEU;tm_ekzNQF0Lk}VotOji&_nZz1?D=xysnA`Yu$-eQm
zlNua!{Ug1f<7?8AJek?&`!jTSn!1uwBXX)?uI9{5WPaTozvsxqaCN4Zy-O<YDv5`+
zChMwIx`ATR^(4ua*!?iAoPt<bdM5nR%T|6+Z5rZugVfXQqaUgic04$Rl2#?mL;F4&
zd_zpNv_)1?LF#Y0`n&P_&&<SxU%2wrVgB}?eI#5{5}J=0X+J00xa5(YgSS~<rV9_F
z`TpVSVAR?W7z|V`2ZieBdrM8WblHg3;fAz*g&9HqUASK}*93k1Z1YjCO{0kn76&q0
zu*-K$T1|$YE)G;zw_Z1zYK%<^&`?%ylz;otlbISdd3Js{m@=st*|V|Od2M-m11192
z{KH_G?ZX{{1)=Vd`6f2%sPg8w>j$on2`yGFOkD#8^1Mh!dq0m=f0h*z>b0}YkN0FI
zu-4rkE$MGAA+Kh9So7v+RM^Q&GyFzFfmH=*-WryX+H21iX>1;J6jhXQXAyMXA0xKD
zCy*<zs3Ekl6pBfAQ=vKoTNQ3CX`m5Bnbe@cE7bHcs5Q>2$@PNB8<G{yi3H~}x}LhQ
zfKt*EuMcL)ium})=C0C?d2IwAtW`~wd~6j;#qWE9_>BtK`)%CDwWxyk(Grt>8Ncu3
zbDH#d7|vT+^;}D;pJVbEzkWCT0*>v>nhEukB6S<_FYQ@fLEeIi{`~Am)bl$0v7&|o
zo1QhD)f+P{Hn9C)E{0D<+&ZVKkQB40S4sb?wJzQxP`2JKmrRE@?<`TwZ9-MY7teZ&
zmZ`MENh=MX{q*C`vaW|^k0yC8w&hXI|8V>0Z{eZY{^fkmiG~e|(!NOE!Q!<#o1zki
zhr~NL8A8?2lUui}8;1M9oDmG?G9}w<LTYAB;q6oAhOSNeWfxRmiR()p?p7byQxIJ3
z{~8h;%}=ggpd`<0X~oGVm)feRuBs-uSueRoT1+6AZIW6l-LS`4infjB{k|h2wzufO
zo}wy*w@gB;vSonCEak?tML9y%Pn*_1ezrdd>#WkCdJ?`Y-+B@yy*u(*7}ZKY(9E|$
zp!eXB<>kFIlZ~n0sljA>B#Cm~kkl}GK%ud=Z{VFvz>oV>s}AL`$2g=GLN~w7RLu6g
zl^gImT4}uB=ubx2sXzD@45VM9m7AOI*ZKBZtn?7|4!>uE)7Otd#QjbS0e*8|+1$p$
z{1>5^yTDg9Ke)GJxYzs5gR#G7W~HdmZqJA)M><J6oIj0D|6+UhoqLymv@6AO8j0Ui
zxUwp_wRhE1jqSdwyg;s>6}F>ObgTaoehL7|y`&oY%cy#nTj%>M^(lYH#O`kjQ(;pv
zcuYKryHQvV)@ZFqS6g0P`2o-dY`^5(b^&))dTLsEg;P$dXYT@UwdGhebNp$yF$Vk`
zI7}6r7?XXCHC4P>8LZ^Y#4x2&+u7lyzw00>^2lv#F98s%%x>XF?|1$EfdsNLC<x}b
zWs?OfdQM!ES{NoDUH(AECg%|HLjA55^VJ73%NURHap_iS-O<MOlFF5#U(sJ3?u_`!
z8VK7(iS2WyX>=dV_6=1&rxViK?^0>q{Wi56?i6eKjWvclVn;I6hWW}tU#jWFsf`Ss
z$0^BW8&g^X{9K3AQ9+WU*GIi_?I}e~r9$pvcjwmk?b1F1?o@Ku?cr5jrQ{d5FIrD2
zQ{unSnQXF~y}5grzqP@h5ulAIXL^918o(Q{Lo0UXoe$$cbUzHgvXa)i18da()&V?(
z6H~o-)vfl4`=Z4(q@34;mN|<wzELy6;$_PF?tEujV2XW;&c<*WeZlxjb>3Ig<eOS?
z*nhzm)flVe%oGP;1wKQ@hC^a;_+wHUX@T`#_R$JgJz?1U12O^<h!VPjBJesegfk3w
z9Q3k+tJDlv&4;(8%uJ(ncnybo@_9a%sFB^PR`VQEvL73$lO3LforAqw)8W)DA|o_A
zIpB|BceBXntZVMM+~B4QGi^rZg`S;maADLTo$l}K9MSq#g4=yK^};H&b$y~dE<0_a
zg2CXJ1_S&iH|KlL;x@doShrh7sq}B0dh}YA<bDT7g~q<F(iFY&>DE_y<VZp+L-J;(
z&694g9cP~QpQDowM88W}7$oknw(n3+7LgKbg<oVja{|TN3ERWqQ621QgUMZSL<DDz
zFN-&CtX3vre;IgX3G1xy@uzZ*uVi7&!F9cC1NUI1!|N3CB9t=e-Cia~Y&|!&gO{5R
z0-3}b8^#xzSQ6j+Y9U*~L+9d8tBI6<`kdN|d;x0~SV?!YQ3iKq<c+%le*x$0+(UyP
zyWW-(TBse~snF1%n)IXoIdUZ~GT6o9qV<~tg%3eh&lZj)q^BdrN&=irQE%Rh|42_K
z6w({{Jg-%xq;^;9%Tzy4!2=?PASE`y>Q~r~B+2cxn~g~AO9~sGV+Y<%mR<)Ol1};N
zaK}Jn2fJutB69;=eJSd_!d!d1($x7Yq-i-m<n0HS7COWRW-YedqIUtU#Xb>7pEPB*
z4c*nxkY5s8{$)PivbvKvbxK3D*m-r=HB^HULuk;nYv}2ez8Y+OjmGHneReP_X`!Nk
zYs_7?3sKR8sitnG!#?EtoK0OERk3U1k9bV$a-G5+CW&{69=*H&&El;PRluZy(0Z$m
zlhfwt-Z<Gxa#e-Xt@#1b2vYM@oZJ0lO>=Sqy&N_>i(*W>uOVW><D&)HgBjuz>b2Ex
z1rQJki$k#b=RXkqvL8p2K!o|%m&bL0PY22!DhdC-ay9co6aDQUViW-+N~a57iN<}#
zv7iwS^-i|~QRff8N&PHNi`Y1Ve!v1n1(Cyg82&cL(C{^g^We+RqW<k29d}TuOoJ)~
z=FaYJ>y9KM+=;)g-pa~%*?EC#m~4q+PP}yKl6(~3UCc{l_Gx@c<3P^G#|MK%b8&M1
z2KkbDrtWt>q@W<tMJ|tu7j|}wgJqjgP}3>2yoUfy)dUoYd3ku6TUwYDq8~qgJUu>M
zdr6$s=i%~bT~}Avm7s>+-YrnXgtU8joM2)~Hfah4p^ruNtCJKI6i_5;3ghs`zYT=$
zl>$2Vu9A|Gkx@{5u&&(t*3j^Vgp{71BS;#-0A;xc_0!YSpjb;zOcX>SNl|@8)^01~
z_n>->k_O!f=ooq=Wy~HwzQG`Il{AO36N`o7cmS=?H+g-K_T6A+X7B((!x#0B#Q3)~
zi2e-q*IRZA1A1jI20>^5IyH~L!7@9R1b^pq02X3mRT&v_P(YND@>c09cd$VrEH-~{
zZJkF^a_Bdw7@L`a7E6}-b4G@4fq5s0bRMuAt^kJPr#h6+sR%qhNJL|^0+CPzAV}><
zxJUNlWkf`TCTpnlRbakAXJR>4{rdD71`rt-W0zM~U*o6Y7`oC{2P8Y^QPCJoM|=CD
zwwRWbJIqj@=jG;(52<wBi>x1GP9P4Ge*p3-N?+zgQ0I9B*3^J}iKA*4g@AGvaeOP3
zcVRfm41~-vP{dmmMY?SBFeHF<0AxlcV@M&pg@lkovkos3uIJ;@)YL#o$G5g(fU$dh
zim23P${&RT@l*uK=;$aH%n(R*&ZF4%O0V9*K<(bjY91<%HR>M~UX!W_-=<ZXashed
z#N6DWSYf_1or>XMV+eCddv-P_j2rbPK0Y3VJU%{W64yYE0<toXz#l)9pd{a_4l*v#
z5q%61b=qkD`t|iSVpt|Nox*o2jVau2`_3<xp#F(qP*+#arbtme=RvLrrQa<MThM#K
zKqCAmCMHgvJW1*!;b;tEwqPbjpqkB@=fNbQco)b)VlXL=alD>j{|d^c_(exE{p0h^
ze|*0BkI#RuQ5duU1?DmLUkyQw1e-F7$}hz+UVm<-FgOdUtt%ch!uCod`ZEeA5m>Wu
z)LSN~WbSs~<lxxc+_Y{_@X5<t1zBTL3S*Eoh$Oo}5CW#n!I9O|qZtA5?oj#i`nuIX
zaZW+OdUFJKdRp3zL=Zj@o;@pUGkMk$ihxl6)9G9i=qnCdKg#oDAbkBaJdyL(tsoLm
z9<^7wxzPofg1K|wbzj#8<wChxN0LXNR^B6J8K`;RMQknC(;I?KLb19>CTDwnRtix9
z@;NlRAR^*oyn?gyE+|hqbc;!-sFG7t?;$`-K-B&9dXO|0i>)<!rl6o8Dd{DC`3I;z
zrLThJrmKIJk(Pe>$4VctoJ`Bigtg-YU6-3e1ed2W6YLleR6;e8q-JdSVT!7zru6uI
z6_sN;?jT0MeNkUjf?J$8Rt>@e=EUQti60({O&A_-%=LPDdRj)DGsA^^_^`a?%*OT^
z#*m+%56aF$TLjDnk8=T(XYbuhO{xH`?71^%Qbp>H0034#)oH;9g^{duY8XJdUKvC>
z%BCO%V`b*Kdey_CQCd-X8k<TM^-u(?i7uc!$5=|n%-+7Zu<*sxr=0j3YZic9wSKHK
zKa4GLb+nF<^Av!mdHdeZrcVCj+X!WK^@a9C!uZw?EE*vHJi{O#$&*u5#N<&6+A&4t
zhSt`Nl@%3bWxy649Y7|S`^6zY%VSE(M{hDQ)qnl^wYK&l2n9n!L*F4m@=Gh~Y!4eA
z&{Oc)Xf2faGqnre$|L666Po~mKuZSVs<pK>r0w+6-%Ez-_W`j$v2gqL(K)EHelLVM
zZ*6T2y%?SfG9sHPg?Ux-7%{h);NaJlyh_RL>7eKIAORg78ja?|-eX?h+%#pG&K_4V
zFc^kyb>YGV64a@)7nC$Ldy1bKi^dLv1PkyJsMMMEYcgiAt<ErjKFCu<oYs~BblY=r
z;-Ha(>Uv>e;k9emsMvLXrQ{iY^#W6wn4DzS%Jm=t(J%cB9be&D_pq?;*Qd{cySRtI
zi-;1}Ko|%M?zsE=77YF+63p4@#t%^2lyp8jRNgSeD?EI7HOl-8Wy-=}SrHGqD^rgp
zc;Y+pOL%?{!7=oMfW8orE!>LF&%Y0)`T8+%51?5B@lHcS1Gp0h+}vPUSOFSjM45VJ
zl+@HwK|x2Iz>iUYxzR1E=RIl(2?@C_7yf0%%3fIC#3T`LC^K^bFtSI<FFBbhaSard
z*F7>cb4Ed41SkehL$}Jc0{%(1CN2cz5)wK(J59QGsPG<DPHcDSIKw!|;1-2*%gdd=
zzrVJ#F`qv3(yQnVZ%PLz`q!7Eyu7@HqWK{0jcrQ~Vb{)oBhS0Ewg$U^i<g&;gJU?`
z@OYFiCN}n<p586rdN>B1<+3whWJ#ptl@by{4(N6iJ)~-RvM?bb!H#aL+raHSYG82C
z0{L--&4>uB^+QO=Kq)%Cv{c)13?zu49~cjC-d<x4>jib%&f1Ksuz)yb+k|C{;v;h+
zxL4T4AmRlHja5fd3+PXn6G3=y^ZYphG4aOQT7GtRI1+uc>G=XSwWHRD4CHXQ(NPq$
zpRccttu6VXf(%SGLgGqqj<GjrzO$<KWtiD++<5x@`K4P%9yObveUPBZ#kD8;f|Bav
z?blBRif=Q|cO;)<kdTrx1ugoD4fR9HoJU1AQ?0Zzpp}ya{V}W;_}=puF7$xt0<aO_
z124x{(N<Q5FN;B*gID-KL^CB8v`g?Kr2Y2mQ|D2ja0|XJuSqAbt=&iOwp)E^4g7-T
z9?u4$iY1bXApzhI_MV9w#40&YUPDNuSLKS?TVdF9nwkFi@v`S)dLR<SXrs&apg^LB
z(SwN8V)!h*Xf%n@g9n@d5L+cgT)vul{f2q+5X^u$Sx)XO0l^iIv$V(%HqS5GcVQ2B
zkbrXi-@~h+_}FXg2nsY(pW6C*@1tJI-Yql_#EuVtx=ZMf1RXNeP{4=LF<j;33{+{%
zweC@zE`0nGb(y5xaoxNp+t4ErM9iLxP0FUAPqOF&;me~IP$c%WT`MjrftG>CAlrx4
zOHWA&TrgA>D7szhEzf`+7#Kh>fDA^+WqU12J_-cg^8biL{)z=L2NDDtFCPWWfV@#f
z26WXjP@jB412vWcT^|W3$u+tvXxzP92XWR1KHF&}6k=z-ps`T~i1ioEuTByo7(mSq
zQDk00!RHwlL0onyf$T*#R@VH&!bff(#s=S^^hj4~WWWn#C7{0Y>&`{nK@{Qr3}R6g
z&dIgO7HYh|exp)+jK@jN+uK`JMk7P>HUh%22iWD6l}{l<Rc^66$}b=k?3#`XQNSQS
z6gb^TEV3S+^#9)2c*VnZ`iDEoN)tyFcCC^I4gX#MVH)&4M2oqJ!p!pVZEOy^(TlkX
z>+p=jlWEZAk^PtDX|1iTQ3xF#k86?F5C4GF+<tF+ea>{Qzrf-&4$F-z=MGw?|3Cr}
z93n!{<`Hdq7OFF*dMouk7ij4H{QSgZltGyYqSenjMTG?gdc{xUYC1ECK|f|?<pP0$
zn<KCx0ifJE`B;(`fJe|~5~5QQ6!a)GrNn>wgb$k_N+Lyl3!vw?gIS$wBSW1fBARN6
zn)>w%5;##8WPcsy_EnGZ$;qy@N`iVc$oHiX7x^qTLHZA{qIUm2Z0@(dzGoOf6%SI-
z`>^(o=Vzh8f)qtVL(`MR#))%Y@6<Tv{s01M@QR?t%wWm}sMOJksyKxfwfpNOzlfG`
zKWa{Sy{VSc$1NbHrZNdlBVt{VWe|Fs8kbnE8$>waEggaQ(bYBSC_8ij*}W^M!w7!7
zLjrzeEc&wbRHqo5nlh34XpX&Pdjhdaqw-&EC$8M5UV?HjcOEZvH{LHO=UBxw7gc~R
z&B@V`z!UW?4@B@e^T$t}RZ>yG_2k6Yln}N1Y7SR8b=TCqnkdhyECcm3paZm6<j&^9
z<oo!<g;YAMdRfG}BV)snAhrfgFsvRtbsNN(AjZ?;jtI8BVvIt)0!V_c4v;k$fI1Cg
zpx@iud`|{?`uZH9RR@C4kap0!IyyPc&d!#Vl+5=P$R<Hg&<)+6S|d9uGMjU~u!pEY
znh3(S@rj8XViOIG?!dr6Sc|gaV%X45PEJt~5e^Oxx5NYl1^vL%R>r@>df?k{W<JoM
z$5(|+-g8k5(K2}o#uH?zCbg3%p&jk*vx8Kina6$^uL%s29-o_YULL*s$QbVa@#9AT
z(LR8{?(R(hqL6lonNFTM)%YbI5)p_um&fYCb_{(@WfzGE2)KB79tujYU{m*CQHIdE
zO<6};QfvS!Adr71HdURHXH@qVZU*b$t?~<y1^{@u^)7-UQ&=xpMpia2H}@eiJ2UeZ
zIJ(C~hgi&h<HiHg(W^nyu(bipsE3}K-TCM*am8@U6GWMimq0=YqRl{8gBc0Q!pqlH
z#l?>};V1WB0VYTW`+Iu8-hco89Ud8(mYPaIPA(nxML8L)Z{%$&!EhKRF)^_dqAdtf
zO-x`R>b&^3oGatv7^sV|ot+fEbsi*LLbaKyii!a)1=gUJ#y8;5ZtW^WB*<-*1y>6H
zV?LjYSb`7pAPJJL&6EHwub9{Y1k7``Ha0e=-a$LXvqhE;X_$l2_B)V?UgCekdY}cV
zpQ<#*E`|_?-5gQzN48T7;vRTVU{mAi3dIg~gJqlXt~l{NvP`)&*;hmyvJqor<7=co
z@cx>tt>3?YZ)gDd8zd_bnhMh?8i2HWd)@mS{SfSGzy$J*Y-Zh`B}tnm#$Nr9h%Ws)
zy3_J1Jp6(rhKxx8q7F!8m|0lF99BHo)@J7CTT<d7bgS&hp|o>!L`u<mZeeuKMb(sn
ztX*rh2pZ_dZ6qo5lWie@q)0+P$C?e53o>{RvEJfi)h`cMu5W3X2V-GfoZeZiGWDxd
zOIN>k_3G1uMku&-S+wm#cLj-W-QqpWrXUcMi`ZU(P{;u_xnHSDN`8Y+<MmsY!JX1{
zUle-5x-;6=SJK|=2lUwLYCOJijZ_c<i?a~!I0oUd=0<{l4F$%+aTqYQiKg7Ro>-DL
zlqWSgxjv>(BU6{b1MfAJ>#M78mrmG%$kZQ6uqp)F%<?kW?9Z~`(TuU&X-mjN7C)6V
z&d<ThQdfdtLd?v~a~Z+38c206qVbvS;74c}l8+?|l1|9VYSYev^o<~x+}wP&92mya
zsc|GJtLNu}Vq@DX=WLii9F8~woM~cyM#j6gDGM{RL}({SOss<ztonK}$Z??!M_AZ-
ze|HO{?~ESMCMCfDTGwgajve9)oG+^{!!pCVfZKo+aq$jqoYL>@bql_4ckr3frNdPL
z(dv*M%vnqoSnajH-@<RIDH;9TiWY1Hg_sT4hsGELgUw{KA=Z#=ZRj2beDI2W`O3-)
zXu@S}HeFIyTWugSPNqw}tswpQGIplFh=bwbTu)Ah4K(JNwmX$beB(B4Z4egkZSaVV
z9fpoR2Vs2>>e7okrz9j`)6~+JmYy0I7;FfHvb)E(0xv<4Ii0cO(w(7o2Qkx=GY0uw
z6pz`bgalgv1MQTrl&_6wXrbqDY2<5fLkpNBEJyQVh(cpXmC%;kTe;Shn%R(49#1n2
z4Z3Hdq`0^l@}|Ae4QT8#|D^DDN|e2JE$6O;v$HdZZojixeM(L?wX)J9Ll;*N0Jp`-
zFoLP^IHA4j;bFJ1H=6SG6e%Q0kaP(`#|f$d;(e2$NZE%E&nYb!hF~!B6BBjcJTg9i
zzIX(Pruys7prc=(>ka1REhY^Y(Ik!n8>6VShNv61vsTwjXd8ujoE{EN1gv3}#{hK8
z1k6G=MtD>d8H$IO7y4(aMY=c)Dl<5%RFTZ8BZJ?iubbW<K{rBAU%mpQ1~2v?JXl>?
zdf){1++({8ITa~tvK1rCEU%z&-QyjN;Cq!)r_Co@majg2x*{Ybr2Y!hbnwp1iNMJ~
z`w!Pcc&&Lgd-jyqXU;5=U%!gwVu;(QAYVnBo256t6MyaqU6Kk4{ye*~GBS{KT)z_(
zDU;%I*K{TiHZkOHTJ1|hbtz-Of(@ar=e)mX=$b62lC(Qmp}JV!YL|o-bzGbN=10A9
z!PN~GRq;C2ay(RfAE1t1zq;FT=1jrjN%STEgw*3M?}?{5B9P&MFJT;2R9G{CNHI6p
zJKHl%;GEa94e>vCiIgsM7snuJyQ@7;$Vnf;(|_1h#y@v^dB}NSX<^lll98JC65<I3
zc&YHfrC2#>rD8~FfH)*09b%J{{{8FB8TzKbn6dD{Bkq4wfqwAge=&@hwiqPInjz$6
zEYoCt1kiS1(1=geP&%hKUjB=JgbW5xK*GHX4`uR)q+}tml0C;EiGr{H`?ddt!NgyT
zr!fEXTFCbC-~K;edzdl&;XwaqY7{34@g}LyiS;A+DOpYIZ>+7o%FkZ}E)}+K*wDiG
zI5|0a?OsH1FaQJOy51GOK+-_w%A5!|CMvrBI%@+$1Ufo8yh0u{`3e>HwY4J)3eflN
z`9P-&5FCkiz)_w8x2^;oX?q4LOxLeZLQ^ZfQVkdzzh%#lN*5=0@gslIVjNb?)5{CE
zu_C~AU<W$7yU!65XQrh&(&MgPzYZON)E6%jUE-OB*dU}GdQ!#2#AIcmms1DA%_z)s
zXb}coJt3j*z2NIW)ZD_^LSrES1n{`vv<MLhPG}!4C@}dP3n>qP3S3#~vUBRh2@fwX
z83QYDa?rFH9Uc95-r$%D@eS}9ZP9{x5Sf9CB|3L5%xu;chc&An2G?qgWxjEPguoLT
zKLXyqeGU(Q_AD+WQ@^5bU|<(u0J10eS9}wo%IVXPL?EGa6+PSKM^cl*NKOEKnpYSZ
z&oIQq#6X`Tq~sZaMAUr1>_UdHv$I2n0{j`z+5%Ac_w+*U?&b9jc-8s2Id<LR%X!^!
z_kn@(o#E#%UOd8{IdjHrp!k+75fB5HJ;tY|pd&}G)HW41ISWe@kb-q@DFW!lCYSA@
z!7ij75~4;`DJ`un2*o~yK>zYI4yPgmy%-fHO_Uo8(1Z2&lfUM4g2O*WOasyu<fG;b
zsD?M^86R?;G{+f2n-2|xNB!8cy)X*Fa1}CtHnx_|PPNM<a5r;v^GwYgBRn>1YY)so
zJ0%zP7Q}L8hpmXp@H&x^+9=eqe&}nIz$Zy6cye<}Hd_s{TX=*Q5j8Y`jE{~!2WR&F
z{rk<h)^``V=jP{q5C0fI`b<Wqs;)jcGV&ApCCkf&Wl|v+eoMikqN4KKc^_hX=0rfs
z@zpJOFmQ%R#EJJ=DZM>CbNs+2j-$mfiX4ZeXRB05S=kPxoV$B_P%jwY?2^F1x~^{R
zLXS8^eJ4(wfM#9|b@jgg*2Lx`VPtNOG;NKBXdgPSn>MpS;R%#iOAAmPi?Dv+&++v0
zOjRU99T@<Fs8N(YD`l1QR(osf0`zUHoQ4GNcAq*l%te2`{-5n`i9D>Va;%i#<a>L1
z&QkM1t3LpyHKf$X+{N$R`~K})5}5m(G<13?(&lK&F;_s3IrKC^Cl`?Rv@|r(13sRG
z19uBUP^J3A&pN9Enf0e1Y@(2yifU?dGPfHj<cz3oaLcfFAn99ForJz1XkmkHURmb#
zwY350s7Ger#wh+p|Gw@93J7@rP<B0}S^HH;Nc;`)uX*MVKW(-I8mRs<yR3kKHprsE
zCs1#+yh6qn1dg8hd%t7;@j3O+=h)X!`T)NTo%`HCfI=Q#_;YyJ4M-*+^=P39ewP`l
zD!-RTU{@0mX1H(w-RyknuX!bdcQ^_A+1nd(im?73i1;9_AiBW$0Q@0WJw5OUKtg&1
zGD`V3gsJc7gT<w0{Y6<jO-xO}>gnj{Kxo#}+gk#e93-GZP8*gG`3KbNWIu2RPzzyJ
zeK`5u0qS70-HMk<Zj8&!J3)wZdiwx>pVh=(98@!az<`Fu!2*jgaOThi&!JZu5*Wy7
z*~1C=I@6I14_WLhNYBnz+Si4{1GI}(cJzA)u<keR;_q>{4+kxyu*z+%t<W46`XtK|
z7$hhpL0=aAHwrxKf_E$1^uPns)5qcg^YPD5Fg=ozl0g1Lab&wE#~8TJs{L&XNNph9
zf-XNi`G1JgtyOAh^g6V|gMAcP_Co(@GNkRgmChw8DUX3;0jhxY+2r{5V4#ssf-g<5
zzw*awUjgNi6c+~_kA{|(&Ol@pK7%GZM#*>5a&q}aMOhQNW|`1>4KGU$Mt<qzp9Q5?
zmhz{Wfl?X32@qGs_|ES^z}-)GeIK<(Yc-WXs(~-ZWC2^Bn2>P413wd~VSiQy$k!BA
zyMKI6{>SIPjQM}O<{!Vsdnn=)f06Kq{Z{x1sm8nef03pC`ugA39x}E#{6qd+3qipl
zulipv{ZloJRsa9$RKF778?*7<m0{g+cf1>$n(*cY;RD7oDL<bFPBeJ`o)i`kz(#iQ
zxvlNlvu8u%6dWD5s}dCC<eGsE75(S|ePO;5pMc<f(w7e@+>NVOPv8R*yuB+D5D|gJ
zSOX^w0a$WY7CjA(u9_M&ECc)TABT1@CqiKfjuimX9$52e5hp$&d?WS3!UCj9u#~W+
zjj=O*1+&oj2Q{6Y^;s$sk_XVFZ(-4-Ee7;iWo0E?33x<=Kp=>SK2-J{J$?%C(7R$E
ziZWoZM1KPT(|m7U{U5plOqCAyDTLy3I?1ZZ3WWQia9l{d!tLAcN;hc4T%GUV2c$0Z
z^(9QS1;*#UoRyFif)o${G-Y6A%{Z(ANJ4gV0nRSCc<~-$d2Q|8yLYy>whuimd$Oy0
zdIW@p2Zo1ZNk+%U7+pkw@^5JazFOw$d#Ligqvj|6*PNwgWMF^%fL_>C3}z6xr-vIz
zBr-B8%I-i13K8%AK8hjrDEL*6K!98zt^q%Qy?SV30&RPrfm(;CMVO9*k@2+(5T$z1
zc@461AaX+RherT-9@ZUTKh_KlwzevGA?1Ln+@6fGt~FYQUfzGjB=JCE6VV7Lsi~o%
z585N}Jfmd8Ljo-JD-b>cC`16>5qprJq`~t-ES8?04y7wVb0G9{jOu{-hGw1O4k&h*
zq!>Sb-0%YWEZ<6e0+fY=H=vYI2-O&$6_5>Y1G`z6o<0kfQgs6=S46tf%O}v4Cv<?&
z@Vju!2q@dzw{JrO>r`7T2Q#w+Jq||mb!ey(+R=-Pe?yE1-WE&%f<ruzH8sVD03i+2
zaOK)H&$cP>eeYGaS0-ddV>#~7g7KKaNep#H&onhJ^uwVhVi$4INVLoia!4%-4SUG2
zsq}yLy|V<I3qmjSqIr1Oz))0E9xLd&D-hcT(U;@uq`bKJ%gRbu2r4ibT5248siLl~
zf5_Y4;^oCaq6rb{>({R*oO;Gn$3{j*CMV%I3A@SWi!jiOxHSN3fIR*Kbr<V}m&o<8
z^oxJ$x{QT0bw<k&N<h$+satZzO&nsm1gj5GQBA$(K!kaaK#t7F7!Ss(Ec3Odrq(D2
zwv3-&OSa)xi7WWH1o}j8k|2N%v9z>|<T0!9hnm6)_PlRhNIUFA@Hd*!^#rv(=x=Uo
zQ`~k0{?8|bm6a7%eM*e{&nWVsyrvARYG%e<lvrFWz|S96f#<OH@V>37xj7><(>0b0
z4wV4UzrHcABLh6e6eN;Ao)O`kx&AoFOXZ;)22V^(3gE~Rh#F>axaVgNW1!22F_6M*
z4HyR;&*9?iOv$Pl7!lE%ZB2>Y%J4j_IO9tZ$qRqH`{8GWe|+!%kMD;NhxPWulwgk%
zKm0#stWvUneLja*I^gjLe<OTt7E1mP(hn5iSQ&vAa~E)sZXKc(;rha$)AWzHl+%Y-
z{Uz?e{}%5r@oo@b*FAoiT^)W4*%f@dVV{imK3~-FD2+V~GyZ)3H;(^LnE&r<J05tP
zIRh2Iqxke@@C+I0e>@F8e!SiRKL&iE?%!|q;M|{Y$3zb2=r9NTYwrHn`QTq~_Xqq>
zG2%1ZKTp6ZKynJDz5jGUf7h4cTc^X<JoI7kno6J3pll+26+efc$YE((!>m}y$bzAI
z0=?(}sk)A3!NICZN+g@63JSyw<3Ll;Z?J=G1vs#T5Woj0K*MxzeZs%Xly3n9=l`25
z55x+`Z+~p1GEM*S0}{O*I8DYJiqdfY1=u-knZ-Mp+FA)yQ&ZSGP}+i%rNULT|I0B&
zd8$u_E9Vy$o){Y5f*=!4I+DZyDCk$Yirl)DV^HM^wF&Sz09G06_&fm4+c7l!3AEqK
zmoGtGF_VrFgC=x`Rbdg4_4ReA46fojVZjc~E?LwJwhp`|Aj8~1$?A`|I}o*-^dUj@
zqrFrFD1HGAr%`yIMj#x6Vg^(o^>lS_BmyDB$ImYY42BOGlLyKWP8~^vtqabY*wD}r
zNL)q_P8`Cs27nL_FG0Nl_UPfmg!p(ymWR+=4nh@x9th<;Na*S5XJ#+*nv*l&WkTSt
zI=i~y>=0hC*~6eF_P&-@YFykh)H8*I%HZUVhB-7mjGupTzbG1mxrj!gP{8vxs~qRz
z;zBTNZEfAVcMlHkf#q&!Y=qEV8!#V|7~s?-B~K;7u~}s+SSaQH^T3>pEGNjI=LP}W
z##2{Y_=mH*A)*Tep5#y9<J{E;nco-p<FH`$?=Id!T!fOLT#~rFh$W=x|9M&taF8W%
z1kZ_M;LhabTj1C*{4qGta4s|mYvF~2^v_bm(lSH(D)`g;s;aWm(hsO1Nxq>-i|6<p
z0ZWa)y*qly-yB8b{D91se0Sj%_-ZIz!ZB398Q_ncIERKa&<w4u4RrB;c0pAI+!&<v
zaF7<f;nc*0vJ6yL;dry4_wQ?_Rt+kh?=ib<tw1e0EDrQHK0N3fiAFgBtgP>>=DM?D
zh0#e0m_}t&DAePFJp4v?dH?@&E_nEquQ_T^&evph-C6;UH3-s*@pAxmuX)hVZEQ+t
z3V~@MLqRp(@7+5n`Q61IX!75W{D8C0z{NvRDK{s_tUck3kjhok@2YTsh^h?eoZv8<
z2jJY`_!CHNfGz=ZgOg*R-28Vu!J!N)D<CAntq+8P&S_vkccT=J>PV!9ZhThYOCaTO
zX%t4|;CPlU@Kwx-Kv%#aWUu}bs{v-qfM+ZMTZ2=U67B^<SAd|`VNeYQl-*hXUp>kh
zJWPRsA42Rua0+j3a2nbF64LNOn*S~Q{olj&Ln+R`p7zfypj=}Kal++|{YPTUlP)Sc
zof^2yBxn+YOVG%(J;4PkMX`UX6puSWV-ED-K%Wo373a@?u(!XMfXLDHUtd08IRWqd
z|N6=Y=MI1V>p!24?;(OtpF<fXmKt|iR7P%Q$DdwMilV}e=Lr1$$rtt5fTn#mGzpsQ
z&*=v`yf5)i<ixQ;ILH9ebKD)TV>&Shr>&^N=r_bKlK^PHeknqN=pi@?Qw-<n01Zi!
zefro@SU2#4_$%KalZZ!y|2jKCohV_Fd9Bx%WH;(EqR{-t|0(WGz_DE0cyA3WLj$Fh
zBvToaDaunQ4MZqYk|BhYDSF6UGStdU6e06irVuiOGE?R$DkM_MJlp?UYpr*^!`}Pd
z`#Zkxa~x}Bc!vAA@9Vy<^E%J}|96V|^4^lbcf^uDb!%mn#-io=D~pNWuVg@7|4?k=
zVZ=E4-#_mE!NXjMqxt7|{l}}Vtl29E_g_4WSm~pKlmQ33%HUgZeA}_N6=X(;r#@WU
zzV?_UBld^1bZbL^3t6BzMyIt7gPGWECN{C+-ceUpcD27ngfu3H@-08QA}`>u+Yyxz
zEGDgW?oc?$o<DDknYcR`$)?({gK1a}kmoxu8-qexZG^-{X9w)=kk~<q(`C4sXQ2Y*
z#nog<A+oBfYR~uww&NbDI)(Y>`%O#Ts8P-h>=7mpH$#t!q`=gdcV%5&7wy}K7fjW7
zhuaiEUQH0dcnPoug0zS*|NiSws0h+8-#~U5Suv$>5IN33k%H|T61b3KL<eCFx4|rl
zA9Zwez&Gj6GWNxs4#^7^LS+>dh_-P1LkJTZ5FkyYj2??#19I(wyZdWAl{>B>Qi?_J
z(k;{%Qc|v&n(m7`z{ZA9;8jV<CCq#HYe<n7v{RZFFEZ`eQTteY9H|lngxJ5Jpt*sT
z)|gTjl2(mf+qRwLDRi98L^*U~2wIl0pFdF^_fM!t5u9W*QmKQQJ2t-5_$;m~9|fct
z6lisDWXQ_8`5~+^?aFzIoG$o@o7S&~$Y&oP-`C#aWh5oA;l|@gsJ&o^jbn<G_!0&X
z<w|z(B?LDaNKOYe?v)RAT%2q}GIbNS({H2J#5H$!J7VoOF)_iO2kU&_v#6IZwJu(C
zKoSYNLR7V(p3p;ljkG2LEMyYj_}I<-U}KBLbi1+_A{c%}wS}o#dCC!_UYF%XH){G9
zt&IpiekysgD(;Z@jV!sB><oBi&byKlR)9r?gfM*@BBsJw;@-bMURlC44cTYp2Q4kr
z@86fl2iZYxPppb`Swhx~I}UqQ6xU*c)KSyp;zDwm+PxI98NP@!^zfl&n<b>gsP<3I
zp%jNCg7I^W%*)iaXAnO4RzP{6??SWIb!21&d042NoKc3Enj4IC365u8+w!Pp=fW4B
z`K#?QGPDZ?$HHBXhU0x7nH>-lE3z7(iJL&C6MIGiM5y{9u@4*f&!2NZJi|D%Yz6@F
zNsy7T@p^Y@k7rotRpj<=ISqp7*8>-4bHR;l&@RJX1}LQVuPA2m#wx0*J&@f4_>N@U
z1lCFEsB~hXN~GViMHuPnsX5?tsHmx5Niol<?ss5msd%R%H-uWnVe)W!(RJx3^_0rS
z-@EfL_JSH0794LM{egTJK%wTyGh$32K|VAzG?E&cC<1yaa%{-pVgMkufKc+3w)P?}
z;Ff!P_UyS_a%)w$D9R*vUw?v{I4C$6DvO4PLdPRWL5-*yBlY|ewP}c+Hnt!gFM`al
zXBQdxDTLpUiy*by)!ZE9z2VqfuIm?$GfUtzp>_*V=vw4^T;5Ja3hI?&OtzoG<H4ze
zumRb!Oy5J-RMNBy)Va4JexE=oysfPba8wp#M}vb~acg7120wf#OXPyZ=KCS*ZYnR2
z1tkvIm=z=;5;lMx?SR68iAlG>Mqy4ES?7J2^j{%zHfp|rl0j`8_L{>GHw+C4eg4){
z*aex&;Y%&aYLHs#rR8ZO93*6p=g$LB_i^1#)-Nhfx!3$+63(Eoj4*24LhZr@J19*s
zn^|6j%<a{>^Qf3~Tx!4`9B{yt9}_4PB40nmk0cZB52Ve;D7P~(U<}kuhgCg}c<?}N
zUWn!aG=eif4Hk|^DJh1p6St>Xi4&aSn@#XuM7VbB?BWx}GUDEV;O~b;Nvg>g`Dn$m
z-4X+d91Qn=j;<r3$+^^)OQ)1DVPbPgH8+x!b=~Mt^d?t2SGl8(Y(IaKH2$fy99i-H
zFdyIFu|S3d7HDSG?OQd#0xjGE>}O^DWu>!Z1Qv(|x(H12tRE=XuHJwA7U{>D)vH3-
zh$lGzdgRJOUTlD1HMO$HX8O(RT3?-!r$OD%@4J-J5;ljK^UWCm8!YgPis}j2Ho)#2
z*|ON37je+Ivm35t`-Z-G`zc!OIX(x8GTSM@KwL_~eo=lN%v*zN02_Chrf5xm=z1wu
z9O0+3q^9Uc8`;Xi<S70o6`QTVBz^Z@hKbE^VZ)%a@Uw1CHv$DDNjduddP#NZTu<HV
zDdVu<oMMZv<y97Q)@NlgS$$Vhuh$s;*(Wn!^6MCLn@<-9JqWpQ19X-QZA$6NVZUsk
zVO&NeO}p}+hK9b4zGqnCWj8HC1J=W{H*u3gEp118-&Vcad!<zgzXjC-dMf8C*8x0>
zYw6H?{LnM<8-4(`Wy4Ov%U^QK6uj%^CWajj9BF*j^RB%8z$JS+hp#R2t)dp4(f;N!
z;MIggrvc?r_ed-k5Fp@j0Qku?dv7!FNfa;i{(Uz!n`WqH-zi0aWi<0{dS}I?=x`MF
zNE8$P_u4w!`D%$vZ;njOS=EYeBzuE$0-S*Bn(YTIIzNFi<JNSVIsEXwlb_<%>%eNc
z&z$!!6raD-a@6x5!?Lcb)&isiF$T_3{@k1x2;;upOGq0Qu0)n+oripznhpK{H8oXg
zHUfeokd+8JkF@N4BQfbHKf264H(z_GU8G`jmTb~cxkFb<%ARqQWQ+AT=TP6oR^DFe
zR(Qzvh;wiKaW}e+<c*XLGSag2S)70u6f+(2V!mY75k$wn<(_$5|I}#T>*}A82NoSK
zv$Mr2$ak&k-2jzsfCUBP&K=*nXP6ucujmkr9Gs@mouSFR$p(cLy5cT{NooKMPXT8D
z#1O<cLyng}4V4X|Vg@<^<@By^BV!NDzUG*OWWMp4>8UOyjeWQ<WCbsNL*Gvuv$>5J
z;zyawE20QigJJuR@kghqX7yZk!J2p_Aw$iE%R{m~5<%Bk9X|<(jKRF3_~HEeu}GEm
z@Gxg*s*JktUwlB<2u6~_!S(Al?f{H5L$da7ESc9WNgQl@94n5U3eU^>3}%i{`$)%@
z{qM_iZZ2(+z6+#L{9Ch>kkpI$mWK7-l--5hFCW+Wy;)jFHrOt<Gd3wo+^ISh00y9p
zxZL(UR@A4|xS&A^02R0t81kky02WZQ0mmahoql})45&vt!+xuOO#ACb>N{)v>0y<d
zUv`by#N<fB?m3*jJQG@IDazS@ey=O0m-e{1@qu&ka#a14RBV!gp<Z~%h4N5QQw}~C
zFdKZng;y?LosDksB4NPSG3OaLJv=}T=rccHVp{J5Af?w{t;aKca6tD}n~Ck*vz5j|
zr{1W!qhQe&hb$`JcJ11btZfB&G5R0`o!Y?odT;V(X`c~^SLbB%AHS?+=c3%+dr##f
zCZ6VFj%$azUpzE<VtkY;kM6+{U_IFO9J0I)T2pt@{Z#r9X;opi@|cSacx8-CPT%SG
zFYLcg>Dtmu7qN&6ffn{U`Yl%T99`SVktI>KJ^cxW#y;i1gmf2wwUl!t#ne|FKiBQw
z<?^0iA^agdH9##oSvMBnT6o?+!48XSl6-gJV@XFJx-AZ4(zyPBj)2hhI_KJ-Oq3hL
zXAeX+G@L0a%Q+}?E%W+hD<ED41$m(RQZ^(fCmJR6^d)j=E8>V%QjCBS`t8?6&^?z>
z5LV!@omOF^g7jT*$~JAY_nugAjPJ<F?0eBzo1b@-_2Gb2LX0(6ux&~Hd-x;@i<#=y
zIrMmv)~|NvbUW03cxl&GeSK4;UV*XTi>;5W5_h9hG02j*SbAs8c6#Z#$=&JS+O*9y
zJ5j3C^_HJs79lH-La&x}J>0pFa^K_m`y0q(!uP$r&n$2$6gw?00bcfVc40#Pf=n3)
zkSaaQl=$--d*5Y@yVj;FCgx<Rn6vqh=Na9B{KT~J$3#yxP6io*a^sHDfh%=C!s~=r
zQ?Y3uwpCKf$ISYi=LXa9^=$oNY4h)koR@p*TqO(VGWo-`i`d<~CU-}MT-ZZLwS&CW
z?(~qZRQT<o;BJM6NI|0j9S#ZUyT51B$g5py)_Y{q?T=9^QQ*Q)N40B&StM}u#<y;)
z(%ze|$M^aQ9~^CeRt8)Zs2#X6oZ<3%OxXvr4-N0reXfc6#GWlE-?tvKm5T8beOb<)
z;gj<{N@8<rM{GRj^J`6*^J1-e+~}SqtzEe`?4y0p6fF7nPEUNaZrieC+;atM3}(g4
zoPqJW)%qH9GS?4ENX=<<&!3^K&JV3wXNt3wnfBgW+`mLP&rrWb;F{^hjza6zZ;7#W
zcB4#C;$4lQZa08>E(gS}F|HpS_)h(66ck4*7T(7sfyZZj&-7)=P3r|5>*2<ouU3{P
z3i6TwD0h~NCM-e$^>LP2a=-41zc0twvKl^7H0zt{qWToGmMw8D*6VAmKYNwIFkoGB
zqH_&B!TKT7<KNbJB1wTa(ej`m6Knh`5HeQ6fD%JY`j`L_24Jg<CE&#dY{UNy1IP?<
zdD|llAJ3=t#=#2;SVcoMt&;hvkoN^^JuzvXIR2!*Gt&5a@p61j+&geD;MVM2j{e2O
zP<wH0;)6xJ7vsWazAIOjBZ?R2L>v~!M@}#G(k|YT?&&Ffu@u5`e{|1+Zd?V6u-Mx`
zN!GU(wGY{PUnZ~&f0!~e3$35{8FAz)-7Z(;9>8R~#!!Div{B%tGbbF*Fu#YBo^PXW
zf&cSn!+mG_ajou;{4}<P<xAK3KEAC;4!3qOHPtiI36HE@GPSry4?nSIHWL+_U6ubx
z13(H~UOQNwj>5(N?oMwAX?gP7Am>RKcI_Requn3<jO#nBw*_&{6{=>TgQB07QtfZP
z?ry#UVgTIwa0!pjO$v&=wI-(z?EZ;QmX)3N$lp2UXBlPCXPp-}O+Afseegh_GvI%I
znvn87-hHy;$7HH_rv8$u=EDGMo@fUynT;8VhAQ{(hVz-|$$fhFZP7mew;3O>JJPdF
zcDh_nDcuqqV>_)_<GRrP^)Dnwfq3r4+$-u~46WEYRTr=4KQn7E9>CE0d8hunHf`-u
zZE?l*Dq75@Sh&J8x4u6F0%3Pn{DN~Mm?ZmZy(EgPhI>=i$0#b~Dp4h6b?Gu6acX`d
z`CJhA_U@w%=7Q9ihYuVWhW9<AcXD#3`W{daw%<QoGN#Y49#CqkNa5xi;5-={u^28>
z34i+L!{;?ch2H1r>-0y6!c7jNw8InQ;t2EYzTbW@ABMAESJ{$`caZYhtr{NLotfkw
z==2qaZ2rdsF{!aP_&%P+6W!<<%$YH4u0Ovv)L7(=51v-tEGuQzuye{DM3bmRhsM&a
zW(s6cwFgOko(!=O0WKl%EU%VyiOxM=>TkANS6sX^J7}wxM3DpLeaEs-u>9_h3vZ#j
zPmHr0&ny7XXnECStT4uje0KAVc{e{&!6LXTv=+KJUsKO?Q<L^Tb1I=Gl3tSmq%2N5
z+u^rU1k-`;+4%%Dk(#$37*#50$?$bEHEJx^_;wrQ`Z^5y_}DzUPFX$56+UlZFmR`4
zB*Won`zC4G`Zy{Zb+9oo&hW9$sVmR%9rj^}KQW?}l=3tweeL%EAP_j*78qUp7CUg`
z6nPg54)1$B0FcerB7&XL+0~iOKO{6y&6an1bEAZ5mwN5^*a(;q`T3-U15QT{H@<r|
z@a0u+v(<bpE!lGZFSZ2+mm{wiU1{hwA}qghws|(kcADiBEve9!SzhSF=F*}Mlrug<
zAhf)QTD+V|-EMFYm;&n*PB*#~&iHFC5hvHHv>QxM>uwiqd>8PYJ4{mV#RRM4NK_ph
z;-y<&ys)>YWpk5=U;Y#1V9<Q8r}#EQJhx-WQepm?owNL1W1NGlW9}Xx7ybP5(m}zp
zqfowDPEIQ!c(k1j*aVfDZ#9?c7i@Ejjo+6_eh=@^^KGo(BHdX3?T!*AuIOXu2JMWz
zWD|3o244QjOW4|b8bBLAN8Wt`;#T!R?+Wwt(>VlAn9}y9KXe%3jHKbKEA-pua^=~w
z#@^c>UbV<hwHNNrK3_6eT*TZ^pLtc^{!&e2rNp%}8zwLBE&u}IJeh;^m@Xjv=0k?~
zk>0JPBnn2d{wC9CU`u)p@habwoW9kLUQOn;7}e=dR0#-7+`lDL)wJdfC#V$$GE>9D
z!uCH7W_L@DA7}1f`U4s<z-ifil9(44<9+T$^<Xw^GMI|&DX5Q6a@Vejx3Joe&v7L-
zM%1h{y|H`!yZM8ONy#U^U39^iA^Qt{E{U%gI%lS-VWG99M8c*k+hp?=!ML$k1KqJy
zt0E(}x!je2pI;8JiP@$%n1gSy=@;B;aQQiC=kBXLyCt?MTrKE9`-}Qt*o2E7B%0p6
z{{nAtu(__MvDZz@x6=VImxF^gBi*>6Y;HU+aG2du@ao;2;-rBoYBmfglXvq6%Gra*
zj;>en8P$2;UQWk(>=x;+$5CeUBA=*;@0Mw4qdJmrY))cGvoRzkb3^SsMe(#=Y3Z3R
zt@PdG->qm54&p=lJGAaN(5Tm;ueoy=h!gz3$iOq5ns4N_kJ>nnxA~;Bq;G|X9xjVM
zF~DMDR6KK1?j)T5MKBP(bL07eL&KHD_kqK?l~%At8b>9e{jEHvtHWP$>M4MPb5k1G
zmv$b!R#Dr2v}7<PncEgbhfHco^l0fR@L`e$X(WZ=%zS<d-x*>dnT#N1SNsA63>IC_
zy7_qb<PnimOCLTRrasMO^Wd|NU+?638?E7v-i}LW_|M5x7qqQC+}_dboL_2dXDK@N
zd3JG|T}a%)>a^=;ouzmrjHH<I(-w)7<}&YN!+&8lkh;UHJB7)Tk%{$6HtAV<?+tZB
zSunV)GA;N6<$MTs07~J{p3EHAa_QVY;E9DQX!n3L1`aag2o?T$5yoB|yLJpJvsa6y
z8wV*DK5zWBe%HHfsjzv<?&h}t@z1I6C#7X^pGB=VPB%PyPJCrMe~ZK--aZy1Evm+^
zK$gB69G`zyL5=l8u{F)6UoTnidBSh`P*gH6p?Taa?UtNuy;u>g`Nsh)r3mP=NA1kD
z_xmzRPTTy)OD=!gF68*z@s<2Rb5enT{tS%=5tKmNB%@n?LR$16f4qP5=isc4wzlqq
z-EOs&$faH;W|QyHx1M)Bc?K*QRb8~E7|(gqN%J6~$Zs17845(I$VzcKS)lg_GCI87
zqNq%w@5fu0C}i*iV7`=&e3b4-t+lR&BgDz38P+=Qq$CrRDxvLxu@-Jes1)Gz?ajK1
zh7&vCgSI>m=|AiplBsWy4J*3xjvay{7+yb)!!>3*Tw(~lu#_{zY=hNlkb56I7%679
zGj0Of!Ct57@QjQM<abq7w;ulR-!`<7=UJQ`j3iufJatu7Lp_BB9v-KV4d-BI=Z^aq
z{jRsKZ^-ge3l5A^A+&@R*&jfg*WD)lzIc=e?DkYoPs+IF_wV1odd0@h{s|U!2q&uQ
z>Y#QT_<0ke9Phh#(=#(s)x3zRY*CS9Tys}f0V>HzXv5kJ{VI}hL@T6^o-A<p!S^}T
z-w$`k5M)2tCiLc$`OpuA?$gi^vQ|S#kbU|T{llojn~4&2p^d&IOUAXs3%)E!s<%K{
zhom4K!3-!D`_)SY+TkQ*VYNVKoct;-1q)gN8a6?3i7Xf_sVS+cmz`hS{K?L?hl|TI
zyal;GI1`Y<$2<RBEHtwU)%e7wA6n`<Iz^YO0+6IXCkMa)vT`nSLkYf<{)F3-Y1{nb
zbZ-X(G=S1~VQA87#dZ6Z+q;BrJMdgD6|2(h_T>-RN=Nq=T_>*hy*bTNJBwxxf3^-u
zf$&IK?h%Xg^5Qh$2iGfL@N~eLXpD)$H3qjCac>d#@PQ*CNQLXV(Ln$$Hw4ic6&ozK
zEMGacLq5(sj8yCs!d#Ong`@kJX|EIx%@EXSs5u}5y;&NyYxw){6&M&eJ~jr&S`$F^
zHvKr?rDbK}QaBSK!NEp`hOoGwN2&t)%350F=C@O=#TYO$#`cBzkR>ZRVwIPJ?7>oW
zX1JLn<n*2ZFgCKy-*>`SS5pIzWU#V560cxyK+J|lO*)0c{r%5@@Q3LweM2E^vqHnL
z{**&3g?u=M#ETaXmFJKahBN`m;GwTyX_-kAkWB_PB4Z63oLSGyj@H&G5aa*i6?h#%
zef|dI$vkoJNEx{Z597{!)7F-YbNfqYkeZzAS_4lalI`6u?L;7o#}I(X6XHn1?XiEq
zIoc+nJ`2wpE+=GL(b3W9BZQU>yXoo2Q3?<<>oo0t;Xi&HxqX!XF)rZ$`fc?wb#;dE
zHF3}JM#!EE@bRI&iR)2TboKcS^P{6lb5g>7`7>wsxZ#b_CnmC@FXK%Usu{<q2qzH-
z9a}j>woui&(ZL3Y4=FNCC#{)l&d&hjCGMHHAe)hP02iP_hGSk@76XAN4myDkJ00N>
z!=bRdEzI=!jx|H*8FG{rwTK9D>v*JaArNIGuSl9<<syjn)NCjvt(*c&5o%aLah{wZ
zhnvzt{~pX<ND4bjMml9exK=#>{cvkKL9swh1-I($+pFeTA%B8u3ICs+n^Ts9ZnRDZ
zMYQ86Vry%MHw?my>o>VWcK+BthPHmsk7b^HJha28g*K~%z#WAS9n%2xqgI40x|<(T
z({Ok>(q2SO1P!fdckgjSOCKS$Q6W0zs9;>3JNK$2Fg(0&<*t!*obgi*ee@^~V`jy5
zzfU9m79G^eO;C;Ftwe@Vox=2yq45|a+25ayjtU5aJzJ=?re>8BY;aR?LS&biC~Myb
zO~!>LjZ;M9oztgLdZ(FpM2TLv(B54}EOGod<%FgDeScvj=EZk04#P&?b|M`2ma-i5
zwV<=3_lQ3S;9;l}N$}ZK`mwqBp}HqR7$u6VwFcpTl8&;(DaQ$gR@|WZ<C~kYX#2A|
z1odpf?xCwPXx)lJAQc<xDf{7O&dk(r7KikT?K1B0phn0rTTd_tE0mlY#3^(0Lop*O
z0R5w=*^uD(BH@yZ#@0j9h>8j%)g025kT2{YqfRp8SQH$rz9K)=goDA+@kl4>Nj(>X
z6$v`l!7>m$4oS;`kRvNg)#f#WmTlB*C<sEgY*Z!&RSeFF8=bZFI5aujvGq_K)Daz2
zUcuiib+wrrK1vf4To$(D;V_0F#romHCHH1nmpQ*W>=O_ed_zWym=jd+^M%10?OS0W
z;ecKGIFI{dMI`@c1-0|6PU`AL(xLkUeJknS{rf4nu|N~4nVS0XgVpT})N{(DOC=O&
zVuR8t^v>v?XZu}Cj;E%H364Rgy~1K*M(cz`L|}W0b}^>6T;GJ+NI|@*E2^}+4q4u!
z`!qZ($7A*``nP%WkQMJ&Ty(TFRYp$Ev%(I7y~47;{|2Pkip+_bnPWJqV@~P<D33q_
zQu_wNUNM1ePE3=A=%G;LRDhaRpUxm|XrKyq9_`(kI6g}w9!``!qGVPzCmm)>AnXK0
zRr!DS{gOA-x|k*uYCg&~9GsCsnUq-g_wn<4ZeWD&hTeSs_8Ll<)Nlu}x>T2W(o$~N
zaY;`P8c7Cb<~lPM9H6)N#v1oPm^KEW;q7{EGLA_fPKpN*DyzaE?GqAm9=AL6Je7s>
zP@2B)?#3cpfGG$SHXNdzz^}u_p$H3WNG6mPHcG4=O~VQaPbBqPSCr?h6JQX6AqTBt
z=%p_!AAPionVFgm;x1TE)zonB;Ooll*Z?%J55CU@t6#drn#Ehw)RAYMP-?{;H$nlG
zOU~F^jOZ2nN70INd_9Ii@k2_S`_a8C=e}O51?6Z+>J2b}Mn@aYaY0H3@h0lpx=xcV
zC{yypHI8rOjzhaYEDPSZZy$@4bb_mqI}TN<U$CZ-{g25<Aj?PF#p-wO{44rUh~wtw
zu7u7Bfd(77-FJiC&6}7IZ06u$fofF$%9X^J7!`UlJ`&WV7}${#4yULv7oF1}e2oao
zJvYS#p=^DRE)z~}EM6HI8geF>X=fcJ3pj|{6@(^(9A8oH+&Ag*^vNp%sdMJc8Pxxa
zW<N7=aBxV=Iy%0baJ+*7LobbdC{YXV`w1cxCIR^RG{hSRP_T}mvzi=MlN-V<r9_qI
zI4j%*=R<-YDRo{C2$~6(Kqu}v7>PvBalzsRaaFev6yG#8cC%xKi0S4F58JFla8ZOl
zl6YqvKPs^h5FKUp`%aCj<qE<|G87?$?NrzGAi`aMRS*_%lv}Y*<lBwI@hY*>i7)uO
z-uToMr<-YS(IOUg6weI;*J43C|5P&@UfZEDRJB2$P*O?=BFH*)R**f|4QmzHnAP>7
z#*K0dOhI0I-TZ_M-c+g#qNv%;gGqbj7EW$fWL_7hWnAa0yq?NvgQbH@=PwKO0!I#d
zPnlxQGR<VRZ~t|?OZ481A|Bqil;vQ`da*kPQ5g!+M0<je1Vw~phMW|YB_2%>59EzO
z`^ziw6AfNceed7n9~3gI-a0qkxEoW~SaTlQZP`{spU54DIx8$sra8OfCJ;l=)WDyE
z?lc^1AgP4aaNb;)$p{Rj56kE3WuhfYnn*S}?#dXdg(b^q%@HpWw7zb1#>RuViioOf
zRE$w*PPO3u)3_UaO{ntj#xX$1LX?L;e?CQp0QW(HqLI<(h~ftjUr-J87E8rV0Gu)q
zyxu=b@$_kGTRC)JLokWr6x0+jqm^%hQzXCCYKIj<n2N>tcQ|bqv#-9UdmYeANSegM
zb>$Sf5>+blulKD(RjU0aupBTNdyx=3a=J}?>zc+1G1W503Bv8tp4LbnX}=Cv71%)N
z<AvJ1vx!L(5JT{k#MKyoRTV#U2oe=d;EQ07?tT{fh7A4<hE8Z`CmMF{*q}kF{jHA#
zeVM6t3f5Cv7Rm043K>0dglhWqRgh8C_;hC&P=-|{L`4ZLSQr`^xsr5AWWT0acjCS#
zr(r?NbmkSy{(v4^5GxRtxU4#&+1sSb_3@3k31Bz@8LiT%16HQE3G9wm8sss$LFeMW
zci$BglZ<C#oWa5gZw(<4xt#SCodB7v1B}`ccMT}%MGQd18I!)N)hm!#IW?;9JO_d5
zXt+QSsd8wc5er<nQgkWm<gTk9dE>qfT)w9~G`kMdIpTYW@tlljp$9-mFx-)j%kqRu
zv$8VL$^5u>Fs}aQ=3|P3+aESjuPo11Zjb8)1Tnos%{&-LEgqiQFTne^A17*RhSm~J
z(Amq<e>|;uJ;eNSv{zfBZR@Yjd@!M%l+9LJpdd?P-W``G9zN`@0kZ<5NRM6rVPjFp
z_UE2+ah+Vww@8uUIEg2-7mtN&?vXP703a6TbBH5wEfBb4YUJnRTM_X86Z!$<rA=Qm
zZLF+-h0A*S^cw=<2y`*L@|G1%OP!n+A&8Ykqbn>0cr}nOKCF|3E)(-;e{U}5uok-U
zL6ig}Q(c|6_Z7K@tB@#T%ZK)%+1T-6F@aLFb`_>uJbUCSWUYwT%bjU1Bie?i5iY`A
z@Ogur*6si{0nib0QoFVWFZ(7Z;&`zd!$6Qsm_$^Ien;&3vA>^y94X7Kr=fwx6SC4*
znj#SD!1M|2)ur)WS2og19c7+4bo`0p;uD`z@iilqofi&AWOot<2Y=c2Q}|4+_2~CR
z2BKk}%-#ADhxNTZgM+QSu`v^2x0@ftrz&!gUYw$WuID3!T@d_-9<+G&!)cpxLVkYd
zn>VLqWZ=;EB(q{?B-?QH(&8$Zt+4Y(M>FWCf|Q5WtlPM=eDNww81xrh8?XZhuL%QR
z#%l-BF){mhI7jO09R0pq`0*^WsBNDA$R{m}pqeLcOs)LXWyV0rX--m6)6ig|08<Su
zSVo(Z0`byESzp{33MjqDLc|WYNt4KP4Q@!6xr%k|#qLf9e$8~5WCR=NN{3iP&%~r^
z-6lqI(c)AW?n0<~H%r5~fSDN`rrK3R4<B~G#A}*50VdqO0p*YLR?Yqq=l#GZSm_Om
ztr@YCz#5H{C7-{BUsBQ;lRv0gckkbCYHq$<EF|D`OL~~t#?XEG{MiQDFXS)?MOJjQ
zt1^-o?;x=v)Zi)X?gPs)y!y=-a?Q0dvn!}IgC_*B4xAduMyzZd356RKAUgIxKD@%p
zeWCZoKR#uWr-E}mg+uIqp!7sNprpmb*Ur)M>ecP=*E{Jkiy1ZRHLcm9`l3Gs^0{;a
zgh<qEkZyq}u!YU7PAt$x7s!lp8idhh)q2AqJ|awwjS2v%0G%*{h08iuLBkH{An+#Y
z@i>2ol&>YTtQ<6w4no4h`b^i7*@G{_!GLYG1Z;nD@Jn4YT&D|@t#(s6OagFMAS@sI
z#R&RXlu%R4c*$24EyCo6FfcAiZE=XDaWBO=&04iVx)Qe-1YIJFe}&|w9RfuOv9V|6
z&|(e(cVLOI`@ClV>$rDIIq!nTeD`kLhK{W&xoDPak|-EZ7a>uQp8gi5p9qra@6%Wl
zzVtqd#65>ojD3Ca@)FUq68m6kHq#BKbZBapWz>iUgaetasweRnH$SW%bkfeV1KZ_z
z!j60&7(gpDjJ#}gStck>xRJtL20UFNN4d32WzLi@2reSw(8%|xk{c&s&z^pyKFA9P
z+FDz&@m=CR362Wo+O^NIRc~#z0aS>_<w!yNgPdN1v`pE2?vU{<31v8`z%Qt2jbsMp
z=-?HhD{r4*iOAaQ1HqD<${=zHZ~*`t12Gf}1ogfZS<jzemN-vzY&;yEO}n)yt@L_0
z1~VFb0#k`5dEISoAre7x#-i|fp?JM>XLT#~f4F01S<=xNv~{iCR}aBqc*uN2i_y{(
zl+84pg5YXq;mdaskUr<zM$9#`p`>ip%^Y+G%SLhcV}-%S5&|dVbnI-^4*guyJbT`G
zW_s4Aaj#?fiCWqwgaXuT*z?g$!`2X9cjT$T@R>--MNrTdxKHxy7Cqkh9Brp-dgZ_I
znYB6N^B?@<^FyA0f_-zCuGZPJCA*U_Yd}2bMhB5SX1cR-jAZkkmsQ@bFpp;?B!Fu;
z{js60&QL;idbBrf$f=|4gk4#E*g;=W8JLXhr$(wYw{)j^@ST5_?t2zSzV<s|<fGT2
zqHqZDF8uoCOZv$UShA23`!+OGl|O^evYlUZPq;!!r}3FzqXC*W35&FNUWmSVt}S1e
zA^d!}2F5bZz_{%zQ+NJEnWz%R0ztW!wl<7`=V36!^oxyNX3ie2A;$`Ap#O=2isZ+?
zav;AHDD%c8#RyWK1ElC=jr^~s#iD!m#KJ=l=h@GnKYMz5aM>Y7H5F%cXAA_0C{Tb9
zKxP`sOUq&{frT#l$M-`mK^i<R;ldB55Y3j9lt4&GH0QqPQ3BScw=3*^u&d$TgrEUt
zl$_u%*vjIt@3^`a!9Xi7FAsA<Fpo0^cuC1o#+&HEsmMxq1oIQW?fW?S?L&pxY0tIi
z^PVVb*SGmU62bN1Q%~jQ=Qs4b6v+UwN+A7lS$=s<%s>Cw*0B^?e0yJtr7TeVVOR^A
zUfID<JNr3v;<+cnhuLfUVWO|DR&GBP66`ojRzI1Vi0Mks;v6xi&W%vsJ3+LKm6ny2
zy^DwpNC0T@Vtdb%di~=p1>t~B=emilSV!9H+ECH2;XFVzZT-wj0JcIxjQEnlmJ~Y|
zRMCe_O6KgtR9jiSH+w)G>aT&nbSgUq$wY)d0HzGps65n2`av?}1?%qaV(qFFo7RXA
z_U+Qgfs<zUzpD*QkfyV<<i*s`Nkzd+>Dz4E=c^9{AZC5BHy3m5F9uPv$w?1_K;)SG
zPUX8lZ{fK)e;Uz;ymRdK?Mn;eO8Xt0Fy#gjsL8CYRY-=Op1zSmnHU#mi1q&j`#BXA
zm>!^YMYa`=cO|8?^z`(pAUUvhtm!b(x!1^x3_m_J?|j9df`TLV^oe7t*P~-&Pv9m4
z*Z_Ma(`*IwnhX`@1PSI$QNMjVz&3JnG$BVc39t?E@qp)9Dx`zGy@}`ujvXHoDe@|w
z{OWc2>5NP(m|Lh-r(k`>`e-#PhG-7vSwKMjmWtk39qow3#!)|GMj~lkau5dh-$^)B
zoc%zS-;soHes4?V5^+^fZ6eO=s~7X(V5gtP{OVID!v=n<R;g%c@XhAF_ZXYAt4c}z
zi5Tn|@zZKAULJ_q#3bC()MTLa4R<M>v<EGVjtX&++^a$eG|zh^hGPR|2I%?zpe4b$
z1fg|@4(!2@HD7PWb^|Yp*=VE^Lj(LZZ>EaGGUr&&e`XC84M6R}cSboe>FElp=ko8+
z#>zZV#6_LYRHCA$rA-KmAd!EMlLcQ>CxU3I8WRLb_dnA~!M~cp@NA7xt~w{9w@F`N
zG{w?xXgbQr@o$F=n$Ws`KIz_r!2A$EI@6LIR5KdQn8ji*XlPW%?I5}YpW_k~{Na??
z^xQ;cx9@o!oh8UXO}-b=l6$Z&z|^PfbbFj$Qg;~pkPtdyq%&H@v3(U8Dr}tf5vDyW
zCj4=5@Zg`g(+b;oRjcN65ASF+&GTyM<TDJzR}>xZbsEDcP@to<;Sb>N!uzUamCIX*
zvw9{DxqyGd%9+}k`jAG(;5oul)P<y%SV9!%Fkk~%{*ic)*WGfFx*Fl#KubDHP!oWG
zNc!9(b?dleRA6IVtCYCLiF2I3ColJ-is!~x*)Z*+kNM(U2ewfl2G!X92VxM0MUY~-
z>ccyUh$8n3)FqZR9v3HKXEl2*8A*eHKR7_MV;G%?WxY<(j4GZIzV~1S!iMxx#kxmS
zL;}TB&*V=okU>?58yygiV*aj+8>SHJ^TZ*C>*j~ulQMyA<&RW23*WM_afO_vjg9lt
zf_R)N?j|UGJ<ja<1A&As>%&Mu56*n%YAy=VFY+mMlwky1_6Qf3Oz2d0f@+ZnMsik<
zi=D}wGh-l4Af&Z?kw@%G)l<}N+Kx6KPE%p`2P+`U{D3<V@F9%v5xK1vg+-Jr@czuX
zdQg_6R*lntDGrM~3r<7A?)9hRBJF&~x1Yp$ELm`y?gi4!fGufj^Q@zN`^sanm0wLB
zzM(}qPLH37jZ=b8;+<LQhmk9Q8x`B;R|{)#5e$KhfGx2icGG9BOU}{+z5!2^eAT)3
zVdRe`vRdyTSF<;YheUN_XON)OM-kf<Z^skG<Mf}o2xSqG$D>15_Z+3G<e3tpu(mxU
z>gk$~7k6}$=-hUT;pKikoyg4HCRD?&EJwG#*znh{p%}XT;g_RzX4PN6{p-QR?)$Ib
z{(3B=#<%}`XN>+8e<z$KYg@$05CL$w9qPyp?rCpnxlI>f^*Psf$!2h=Jux9=<F7|L
zMK$MbX0C6&Ssdx;YKFcE!De~(_6;&F1z#4KZe)w%4B*2)5eOx1vJvBR34N1es<{*T
zl``Ns<LN@C%)BO;oVp4Qb2KfO^bIO3_GDd@ank+<A%gBoR|-7KWN<2D3ltca-!P*k
z3K{`TkBua!rF{F`{T+=uesQPi66qDGE==_8L9>8%hUt1{hQ&ko&LyBR2VQJod;yJP
zem=-rJYgZA`B3=kSr+L^^v22EPutk43e8P8Lp;^Y!uri!7pTE7-dxl2D#s;l|2>)9
zhDnxdvAslpk3UZv(JtbL-OHE#m1y^a+#>WQJIE2;UOffQLi}fV@~?j;T4VfZKpP+E
zEov26gnnFO8NH2^7i2KeOvXCBK2k58#J`rW`O~93_NieU+9_>Ff6%!BpBKUe!C|zw
zxc;Vmb7$x<Z?zn!hy5<HW5p)D1f|`gS8Dw%Vv|%Rf6$DM_T+uz8+^pb^n=Po|0+Cg
zzxH6uktCGt3(zuV<kOZdg6=VjGaj$?qdK9YO4+S*VYcaj4+-j-fkYAeAIs;smMYaD
zQwiJps@~~e+Ftzmp=XzytK@z9H<xnkK_3a3@YmLyx#?nQl?7Ti7rmY;s8Ajb3r#fW
zXfL-N@oUTNbHb4h_WXw?5o^ejEC{!eyKF`asAFU~W-;ACL-l?9XNKP9s6j;aTo9D&
zfm#c6SJ8aPc<t^<$f(d^!u@J8)MmRRX2Q@RqUx+MlutL^aK+GNhq^_zLo1TaNkWwn
zFO+UxQ*3@!ueGCU2^}(+hOXQuW!L;)v!@8-)ol_B7dj<neWF$C*GAVNfu$qMoP*K|
zGD{Dbr~8eb*S?`V&w-M91VemKuTlW!j!HfRSe>2uh!kMwK<cou0EyW(Yt|Sh21Z0I
z2_zu^1_%2-E%!%M!<fWOuk;ob9%Us&1ys#wXfUY+^AQ3ivzFwR7uWkxI0je%IVXru
zv5`WB7d2a~DFpR7?)l4?-3<*5NE0Bbi`=wPLN|OLs8E-d>Z1^W2-b^)^{>!*(H{9E
zFsN3qUX3h~shQb@uL;=p!`)F@8jS=Jyv}&n#`9qj5j}t;z`^rJRyaZD>i_Rf=GkkK
z0Ji@zH>n7~{_+2|bvdXJRu_woO!vY903TM~xjw;bc%dJyl8%P^#{Czh4AYH;D~R<2
zSl!UO4^_vcq&%QR5sZSkbUlFy`@*voZ{PZT``z0cJ=qasp|XYSxM?3!G$?2#yh1^S
ze3}`P*^3L2kT0&ZGzuG>E*>vOXBX4o6H9+}O|v{ZxQK1Cn11<Pq%MFd0(%hn-lEvp
zey2ncgEt${KpxvAd_jkRk~Pw_C?EjwFCie{t4x%taadquOGYjOn;|y@(=AA%8^|aC
z#3mi*0ZJ5t4pRe+9->M>PbD4>EyDZ5;!A?|bkl?1)}vH7Bs3bYcx!Y=u-H?<{1?x4
zg<N<O$9?<1e|H{f7jkh~_Vc5gEfhUBh|RyFq!cgjFcPE~a`5ZpW1~O~&|_2(nu8-`
z6u6jkhTR{YI`j=E67R?rj!BpTq=~AWwRKHR&0*`$Ua(~2qBy#a>LWdBm1sSdE6TCX
zSwgRz;<$wNdCH5eb3Db72ke?z*NYhVrahjU9xhE(ah9sG=(Y{^R?rm7ekftLhyM(*
zU}T)FL!-8aeD?s?6#2n9u`JW>+RUHmCx)M&C@Ls8W@s$nw7?~gaJiBNPJT+05U|;;
z_J<)O$#!Cel@0{H%1S$i42@K5FANMs0A%u)CE6$;(+1l*f+8@Cp(;t|ILYpRgj}vK
zw9>1AFgmHLi;0SoEiHeHj|Ubf<1Q{Wd{Xbi-hac{q`6~TJ_>&lZ^tp6IlK^`9v+rP
zBPz6Ui;c-fTbk6<J#KWT!l9+CQ}Firu3^W%Pc<=qXQ9h+n@@Td!{X7oZajb^cVA>m
zTvU<yyVT=d!5P-a!k4B0vo(8CQ|f<d&6buDBbZ6Z3d=G_g$|>26B^pQuc<(z8z_fi
z(3~-uyJ-^}qb+|b99qHs%)J-<ZN>SP{M6`GS~K2Erg!9;OFETW+ElwT(nA${EPO6{
zpeE$vg$w-1yJEt^E`C=TMp?psB&j{*!lCQ+Q>3|ct$(YIR2JWjV>R&%TKS>38hks8
zbuOG9GM%x{d1pI<Gw|Gc9<TSCBYM-t$LDK!kap^CW^>~oJ4KZtc5n@O_&&<VQ{Ufz
z?d!_|#~4$fhf~&*`ax9f#4Zi5ZFqd8Et6;37|SF{b0=Dno&U00g~KUF2y!wuEP3gM
z27y>;GrS>m6db<kIM7@eXrN<-5p*3Qvg6@zI6b5qB2>{fX+}}HKJM=FC(jHb@HwW)
zWkveBkz7Br_&}!ev*B$BxEl?o4(47(cQ%d~@Gua-pdnnJCoSa51}QRV)duNb`%0fA
z=~K)F!3u+C7!}Y0Z0hNGb!AP4{tD9f)r)T+2lnrsGH;82jfOeXflBBOr?^9i;#V2(
zy|kk7@wiP;A{*AzLT%Q%gZ%tjRq#;vw)`jlKEeLZ98-bj3C_Cm>s2y8(IR-DnsHRy
zHh?aGjO5bRb@$z`LKP^c!0)l~%ib-??+dIJLd2!$q}3^v8j5X_%~Fh3OX`*k=9;yP
zoa?-Rsv$2*oLH`~N}!tx=nI#b78e&oK!!yw1%ZEcB)h*XHklC*A10=kbWX2Ss8My;
z7)C;uD#$4(9xkHc;Ps0(?)$HFC0}SM<3n2}wLvcHu9{J<xQY>hs?$M|g*dV1%4;38
z{p>^IWTXo1eE8M1!y_FbSXN(Pt8JV80-Od7SWvXIqaeZNW&kRQ6bO^xr4p3dFZ)OV
z+?04OhKdcuFn@ukQ-z3>R4g#a8X`$!uM+Q&+a)jl_msByx__gz4c><gVfpKe&CEq6
zCKQR||JSfK1m&~R?vLx0cE1wg!k%9p#7s;h4mLJ9$e`YEFho)wB(ACH>1DxZ1cG!T
z?(2AL{h))I?kyC(e0`OW)dw{8-P4N)K|ev70@*evC|PiC0kNEoiU#0I*uP<kA?Pw^
z2YZS9JWRPr_YjgaG%9#3ZoOZ(NJ~}qxmlMO!j)hdYZUTPK*YtX-@fNpsoNz1q<GZ4
zP^v|8us6@z(+s+!ad?m+T!Eb9n)vxpKB$|Z@gW?P9;|;p4TwAdk@zs90u<E!2DKby
zES=s(pM)?YbwCT5M<hcs+fdR)sXf_509MFm+W(0jLFI41U;nr7|E^#7`(yt0`#-ly
z|8YyjOl+w>P_Cea{<fw1505>%^3bEqU)IMdLh>ox{4s~v!oj2eqpZTqpg?`IwDk7+
zn-0@((T()Py>%C%VuMWI_0Px1_?*xEM8)=Rve5i(5JU?6En1FrpuPAX^r4>LIR206
zs{amx`-q+7YVuOxXCK+bQ%k|JiBq!&ZtT2O15OH*8<3=cDUNZ(Us&_*osgg)h%30V
z%K;>yxS%naxwS>iqG#Whd#HlunKW@?++oEh&fC%O<($0nJkcA&1vSX+VQ6-Nyo{O_
zL~lrJAbDFzOU8H!4-W^61SP5o<YMGZ?CkO)BO|erBGZadR;QQ;#t+bJu=}Gtis^d?
zIp5}+JrX>KX8<KcUh*N3Qk|WdtxD)nla`j|?tT)3YR&4^c-Ocz8`QWFW9X&1Ec~p1
z8l(&gS!gM9>%tqJMyd2_=NLEaMt%z-D4XxycBmSGqa$n<4mJw^%tdHfy+{bFpn6)E
z`HAv5L<>j~2Q`8`7#0@B0(}M|Ht8rqaNCrJKYT!l;E7Bk3VNHRcaTBxL0SiGSlG&&
znnWNagr;L#re4`P1A{(<G%hYK(szA*eJ3W7c@dS8id5$Hmj&-c7-FVBPGEW-$ChL#
z^Nrzi-!oBJ0o4&1F|a~m`aforhPrWHp51gY+C$Y6CiO<B=z@3p`THNEssix~%;g(H
z%2@8z)sb9l0lpNao7%pg5Xx}JAtm!5!3Sy~ObjP^pk4(JAub5(<X_;P%ZX*kp~RqB
z*r|OC@N;iOceN)1UL<lNp=lj%`C9g7jilDbPD51UnGRW^MfLDQAp<Hl0`yb0H8BZu
z0(u4I-5Ic@lLp2CD+JQtzpcKFh6C~OpK&x(C?kL`9&V04OUIdyA3vT0J*E1dEo$oO
zpxy()p6-o0L{LIKgcE2S0sIekE8e3vPZT9E;eHJuO(x|qJtxNL{|7vu4Mc;Cy<2Ip
zvUCY{(+oStBNiGQ@r3NNy{pUG7^nHPOYYOt=%x0;YT);UDO7lCyms?7gMwS_k#_AJ
z)GhG$w;?9P$Ei7T`jH}l+uk>8zM$fSVdR&fSYH2t#xrO*y9P)ov{w5(I+`ZPlFB&@
zme%8jL79^$39%n5>rq|Z;>=7yUVS!B;+Ow@+?=_A4B0{p=JGI?l%j*SN5dN?3U*kL
zigyh!Kqrl~?&y*CKtMoGIAs8OQ75D>&=P<KaMQs-e$*ZcK3p}B=79LMn573IqZ8$V
zskK4z#O&urcl#F6ka2^<a9RyOupkWng4=Cfl0nBM)^C}h0M#3!*2(Dx-tSIEMgXyX
zSKi6Mz{zkQ{6N%#p=sjWau3<MT*!d1af*$-Y+$g`+$~miPe6i?#=iI<zzrOTqHJ|F
z)~rpNHsKC!Y>RpNR3Y}Vo*vN&iAAMyD7BbS?|la80^3~_xiGBdd7MDQf^z(tk&&3?
zhocZSO?jao7!->53KhM^5ZBz(6H(FU1l93MKRwJ*P_6!w8$5Pck8;iJqn98N#XW)0
z{hx3m-9l)SwvPc<<D48J#@M)95LN0LROMg4J{dt;X<uXfq2%^hbCf#|(ivNmlW5e`
zE-0_5h!DtODM(D@#yNlfJg7@qOY1QJfI6t;r#q)(`hy$=G=yTMN08OwGuzKk@y9hc
zHCZDP_)@WsJgm6#VNt2heEz()stPfHF^@9T4G>xup?JE|Xa-FMph*PetN>vd6fjJp
zSA(Ed2nvct*94DM=q`v+2{ANq$Dm>f4h@DP6M*~#(9S>xq7({}^gGmuA)S`9_1`Rw
zXsg|FbxnFe-Ye9!cul{al~Ykx-l|Nb-1s+=r})DR8tzLq7)(rXT!pL-n;gUe;Rj3t
zo;}-NA&BHc5|-=nrn!$!&rz5G2TV>S0T>A{(t3t{mzW4pG;~@QFLnV~k<J+d9*5O{
z9Gn7}a&hya*+@!!JhT@=&pf{Y6^yy}0P%GLfEq0+uN$;o2z$go0MLduC!f0sbmo!W
zzSkJnuMkFP(Gs5D`ocxiv9k^P_oFBQ7TSM66TU=rX#dd@968ADo{e9|42N0Ei=;(+
z8KWND()fgg?JErm(Wb4XrO;}i8aFj++k>@_=y&f%W#8Ilco#a@fxa`)tBIypN63&^
z_kaBOiXfh<hms)QVfX(65lc`bs$x{`(zD;gX-&UgSyH;lRq3(|8Q;V^j}`lGw1%_j
z6xu^u_VQZWesyo8fK=ko=n*?&=vqK_hPWAkHhQ$-64b-a?lnIA1zM;mn_j+riAnx@
z_huS*2$69qF+%aCsED4!c(NOhKf#WK10%pW6WNSAcXICCi#8+w${U$`h+y$A+DJOC
z76CR{fD#am9BZG2CUQtTqwkm6)Q7_jbX_^#Y!+_d!Jfp&8^P^>!Z&b$_yDgH(L)fW
zw|xxvq3e?8DZJk25fPz-hhRF<H!=!-{Md1Ej*K+`TV?g9n&@PZ1-S;E1KF2e%oS9>
z4<g>cb%x@8=-I^BSYvDJeqP?tBX*fbS%F{nM{Ik>T^GwDB+oK3GH87=@NlH3@FHoz
z<WIbap$$mD>5jZ6!|A)kr0*WEAhK>Ihp<&Mc8c2c^#E><;2ZIeAUwrH1kVa@xW^KL
z7U-(5^bReLK~LH76;~@gy4`Xok$*daU<W$f&z*pyVeh^~OXKd|(a}LO9s}GDn#1&n
zkdsd>j*ixdzMTC-jK`LcwLghN;8eKB+0BHf11c%G${|M=LV)P)9lgR4KFY$~e}nyl
zFpx<sE4h9mbB|m<QBZ(33k<t6|2@$1R|Na_ME^>BO5|XlY}zBR5}5zdzVRR5uMo_L
z6e#@A|3x%xl32R1_ScRAG|E|!ErF=|GdYj4!rxx$j|#@$;_8_w&i@>||6+I&sZnRx
zns7)`D>?30MEnL*%)fHo6pwEs>L~a%(TcKGX{DpV-)W$Kd!=95@;_hcZzRjX_1jhy
z<(`4}?wvL_H%F=8hec|C;rps8K>6>^i@-laXN7ttt;2Q%je*N)+F9#Ol4(EuaB0%(
z;x!ap*jH@6@5<VG)d23nI_^TMJC~oZ2hh|<Q*mvxXA9Ug!OLEt>35?o<n+EX^5@o`
zWB8p_gX*;G$L2@-6P5}N?J;mzW7lh6<+wZIewq0Ep@UMp#p>^GSC$J`oQ9T1{S<kM
z;YibIa-xqb`t>O(>0<VR#|BLce(cTa=zjZ_PB|Qb-D1V?#MBhz_vymPYmSnqw8$`Y
z(X3yOPlGOSdIxrfg@zLD5an>J6yPoaDTxf>?5rKn0A~9U8wW6Yuzg2&+h;Eg?d?1D
zGXNe|J%1j?8lDz$pn6c5g=pd2IsdYcvT|||1V0@6S}{5e?M-}a>{bQ_(k?U}@cB?s
zhy@4fzNhLb@2-ISH-g>-d@-b><ivXOPtfLKAAuPic|FLv^^q&Bv<OFdAhuLup3B#Q
zmU~TCvyme-&+XFB0H#Qmr>m<A9tiY_T3DF1eyTo?og@zyNF&6zH3KB%2I-`eeAH8*
zz8(clT3X|2D-fSq9jT6$SPnsBhVp%Qcz6Y@`)XQ6Q<K;2in;mskrA(Z_e?A-j15&O
z6F0SVD6Cx#(fTGdy6Lzqym8Ye4=vF!*vG17rO=R4JsEMV6@*s<?{1;#DqA_W=$`oU
z@MvvoONft0F#1?=aAD!4TwLhGhknXMU`f3s?esP>F*z+a3q|~$S5FouosfVX=u+TR
zxk<(Zo3N|PG{-MR)pMA_;R(s*0OU2mi-Jh4ioFnBsZo~u5uP7eF6{`a+~{~8$i*pB
zv$@fsTh4A@E&!U?*-I}8VzGHUbOZfQxJe}Y`EN)Uu(jOt_Ey^u`PR^l{G+Vth@Ek9
zdASIXx=wg!r{=&5L{KkZK7MeH`3XtYxb4Hwo2FtH0slwY)XK^VFw{asMu9|GcoNB5
z$;gJmaVWtsvgQ_-TwPtU5Oj20;28j=4IlZ-mqg8{Q}%_*a%pWT>M6&Q1F;R%f&)e;
z%{EV~x(be?AH!Njj&=nk%<8FL!xSx1qyp;uug73jLVf~l;~yzfDfO5~o3CbfeOp3L
zva*kYJH267ye!<()+W#M-aPkIjER}q`_4|eGiOrM(sXrn%&%UhS@z_ANo>*(B87&B
zgUK0pDkh3VT+Ag2K1e~^zE0|-wOtm*F4L`;6(!>rBm_fU4e2mKQL*8`F!)jBjt$x$
zBA?cV#RFhftXyAi<U=eBb~##DoH%vL=<?-Vl8zd7af%7+(|mN&LX;J817g96c?Wk4
zMq%f-sSopr#tVQY!)GH#xlTVsAGlDc0CX8UO7_;)dRZMgcrf9J`48kiF{bM3>cSn3
zl$07!FX-$H4QjlajeJkY$|b3+cHR#C9Xv6(ZU{fbc5LX{Xs|L!Gc$F4dq<&%)WedF
z&18T7o|XH`@4>1TJzBi;rnAh+YesGlQ=Da{NIp)!HGG!1#*`Y2Evu$(rEW;v<goH<
zyw4?CRmxk$<C5190}uyZQk}So`1jA3A+8n1<v*VF$BX^@v(hOq8y+PuU3fq-b1*S+
z6W^WpS(#Faq`P-#+T_V}oBfAb+1c^Jckjxs{B)N2#EIB{`l<V5%drzDHcTB<r`){x
z`k?aP9<VuS6FWQcixbIr?%q|!-;*}s!R5<&c!j&g)uWeBF=lH~h~`jGP@FK-IBle$
zK*5XesVG)?noz98cdPK<PW(qfvF6DtiZ%Fm74f?#tN;A#YOW`1{`x+Wc%XWu{3QO_
zd*h_WjmvsB3`qu7hWLj<SWsA)U+^Hmu%N2Y0g}ie(t(3~f`TMLLEa}k#1sGV1T%}v
zCPsGu;R%Ajo)Dp#_7qRpOuU2PO%o&1aSKxmD-}yU149ZS+OXB9@y9KH{qZCop=4xa
zZFqx1SWJZ}+7N%;@z-C^n%p!*heH!HLvw2r3v&ulQ6YKxeft0Ym<#`SjMzb;&j&U)
zP*6~^*{f>YFuQ4FVv1Lly{D!w6PTL6X-QOtJo@R3e_6m|rqB&x7yI8Hr4Re@HBww8
z?EG&zd;4imtN++uJt@<1<MsB{Eu)5u(z60<Prvzj*dpMn;@p4(w|dFy-g(=eAO-*B
zN>)18h1-=<f+N!H+p9|s>^S==?8(O&8OfyIKW?X6_Mqrv;iwALa}t=`UcFkAu{C;)
z$fY~)Zj{iuZueNa^K-e<<y8P<#WSkkRj=LJ#J=id?~j9Cy=Oy5cFt`ty-jX=X+9ap
z?oc?Y;4CCi=Rm=9X<?qhCP4U6*z%eelYFhQbLSc!^o!i)blARY>g~mP68krq&*S$e
zuZ<m?@LqJ(XvmoP`1y50)$d{VX>_@#zaC_5T(BRuejZ1ivGw&`SD6U8in%h{O23I>
zRtC#fmKjR7iMAtqH=KFSI<xIm+}rif42ItQwr>Z!@I#&Ry&Jygx!utpRFim4yM|)5
zZ{~PSDj&o3_|x_#0a9uPk9dQ#A8g(jxq0Irzaa|2^(mU9_nO<zum|tf95~f{i=R(<
zio!bJpg<1q4<5h0pQAt6dbPGD@MKqw81<ETos}wbFxvc^ki&-2xJSvaOjPP84!XF0
zIOO-U>Vba46Ix}bL)Y@wET<Q$uk%oNwnyIABY)HWAoFA&t>4?pz8X$>W%sTa6igga
zWSOejYgNo65ozIg!s?4%&Gsjnn{>*`I!7*y^W3Z1GrKR1;YnKU(FSgXdmICrU2$1i
z!O5PPug+x&PgTC4ig$Fhv^NzyST(dyFrjAn{x-J4TWJFwnGdQSOFO<3J0`=WD<j98
zbw0<(b<1pN&-kk*2D{M8WLkT%D18y5ty|=q&kFxO{iY&UV|Qj~EO(u3;3EUZLy63Z
z{u`^!B_sO_t|V%!WNuXp56pJ@{kD^D)cMFkov3d|7A)@s-G8`oQ&HpigPR-OBg*{v
z3qFZzY<sEMBgVpz#&=cQgr${HR8cX;KUrwQoasxu^ec`({KUyiBG2^%PF+1UaqHFT
z7W*N3F(F%CiO%=$XMtKMs#dyLRk5gP%DKMhWd&WE%456cs^^2uXF|oo?dkbt(hgf$
z^IJBmP@8OO-)qH3#d$sRk?M2u>##@kraL0+3|wb*j8i2f<%^Xp*i%Icxuynp_gvuq
zem|RehOcIP?~~7$_npa=PWa@1-7CUoEPef)s`|EsMlr+4ru?FPfyY!8_lkZvQW?&F
zmh;4WCdFuRahn~XONLw$8K<{!xYp9Ix%lF^^gT+&8)Wet^G~12nOu~Pwz<m@G-ANZ
zdxLv>u+z7q>y8mcVI7`j>`_!1>!&L%E614y1a*zJ9oAp)(j5=Kbbd=E+nWrMaoE{Q
zhqg#)DU|wn*8Cp(pfhJzy8eago&$VbJ^HJ**>27@5iDG5@#-}>F4QN!&5ZFD*^f8c
zMk?$&)x5AI6>l1an3>gYN1lu<jU0-tXJZrDIX|AHag{3dz~W4{%8t()L_b!PWzc2|
zHvZ@q(XTu>TKYC`-`%{cx)mN@)7=hp-*W7k<vKj+c8~X2-5zF1h0c;mtIYeWRJfxn
zE^RyXJ^Xo6mN+*L=M%yEl-yCbf3mMre)L0U--g7`lDB2LSgO5qvu=G7_0cTa@%{zP
z>)U<&$3hj2ve&zO>ZSk9q{ky+P?F!a)8<62yJ${)xJ}Zv^}PIMl%-yC!U_tPsdCvQ
zYiApU26}1KjBR*06lDX+15uR}VL_WjSlD?oPxkYB=vn2j<EpN8Wm<o{f8S<v3K97u
zIXw4f&iLLxZ&tqlzW%g6A4}(<w#UDTXWu(KYV^UkGec!2x?;7*c~9v>zqQF0-N_Lg
z`X+s%Q_$wSezQuY+!oVs+H>x_r~3m0$Df@&D|kWZoTpom^pJ^o<pn0YosTZEggFM$
z&hdN^b}Q<txUY2b(0Arg4y}-;$Lnt!osv+EQ>1&vmCPA4!9J1S_9gDHaKGh#fBK&<
z=pMW@*dLNT*`aiT$Jny>^%a#!J9?%7N{f$MDON=UUa}SyT&1()==XEB)*)HUHzoGl
zl+dp-%czbyA#QXfDkn*#(%<R#B39k@4<`K)EWDxjJxy=NSAVLm7B}8{YJI>w@7o40
zg|+9Bc3&&(@vq7DRQml1)1DZ+S`Go0h1)?ncCAeXuQfWDcDZR-GA4NyHQGG2Wc#kY
z<LY?1rGN8S@wbjUv?PY(ngz#$${5}*mn-u!IYl&m*}qlPQ!HX&=-y{O1O4)oNsq*;
zJ{;LSb5g9e*+{DO3GKDxC!_b+9L%JP<ktOmHMOsvHBRvIg-nOL0>`(l+wZ6S{9EFa
zCTcH<W3rhQYn!+DTUYn~*j%EWBHCBcEStP-PQ38LkK<J7PQ4NlZ@O(GPsLXX?cKKf
z_1GN;Tk-A56YLh=A*s0=Upbd~SC79uoo67N8#_Z6%AR8575_M2S;I!yh>AXNJD<~w
v`S;7Co&{lDqwhbCo?QL5_`Hbf49mgHjpg;EmXlaeDNdhMJn>BWlI#BfPC>u=

literal 0
HcmV?d00001

diff --git a/latest/tutorials/Trestle_authoring/trestle_author_jinja/index.html b/latest/tutorials/Trestle_authoring/trestle_author_jinja/index.html
new file mode 100644
index 000000000..8e29c7e28
--- /dev/null
+++ b/latest/tutorials/Trestle_authoring/trestle_author_jinja/index.html
@@ -0,0 +1,37 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Tutorial on how to use jinja for output templating support when converting oscal documents to markdown or word documents"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Trestle_authoring/trestle_author_jinja/ rel=canonical><link href=../trestle_author/ rel=prev><link rel=icon href=../../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Output templating with trestle author jinja - Compliance Trestle</title><link rel=stylesheet href=../../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../../assets/_mkdocstrings.css><script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Output templating with trestle author jinja - Compliance Trestle"><meta property=og:description content="Tutorial on how to use jinja for output templating support when converting oscal documents to markdown or word documents"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Trestle_authoring/trestle_author_jinja.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/Trestle_authoring/trestle_author_jinja/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Output templating with trestle author jinja - Compliance Trestle"><meta name=twitter:description content="Tutorial on how to use jinja for output templating support when converting oscal documents to markdown or word documents"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/Trestle_authoring/trestle_author_jinja.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle-author-jinja-output-templating-support-for-oscal-documents class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Output templating with trestle author jinja </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../../Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5 checked> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=true> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Output templating with trestle author jinja </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#jinja-and-jinja-extensions-provided-by-trestle class=md-nav__link> <span class=md-ellipsis> Jinja and jinja extensions provided by trestle. </span> </a> </li> <li class=md-nav__item> <a href=#cli-invocation class=md-nav__link> <span class=md-ellipsis> CLI invocation </span> </a> </li> <li class=md-nav__item> <a href=#sample-jinja-templates class=md-nav__link> <span class=md-ellipsis> Sample jinja templates </span> </a> </li> <li class=md-nav__item> <a href=#variable-availability-in-the-jinja-template class=md-nav__link> <span class=md-ellipsis> Variable availability in the jinja template. </span> </a> <nav class=md-nav aria-label="Variable availability in the jinja template."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#lut class=md-nav__link> <span class=md-ellipsis> LUT </span> </a> </li> <li class=md-nav__item> <a href=#resolved-catalog-interface-profile class=md-nav__link> <span class=md-ellipsis> Resolved catalog interface (profile) </span> </a> </li> <li class=md-nav__item> <a href=#ssp-interface class=md-nav__link> <span class=md-ellipsis> SSP interface. </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#custom-jinja-tags class=md-nav__link> <span class=md-ellipsis> Custom Jinja tags. </span> </a> </li> <li class=md-nav__item> <a href=#custom-jinja-filters class=md-nav__link> <span class=md-ellipsis> Custom Jinja filters. </span> </a> </li> <li class=md-nav__item> <a href=#generate-controls-as-individual-markdown-pages class=md-nav__link> <span class=md-ellipsis> Generate controls as individual markdown pages. </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#jinja-and-jinja-extensions-provided-by-trestle class=md-nav__link> <span class=md-ellipsis> Jinja and jinja extensions provided by trestle. </span> </a> </li> <li class=md-nav__item> <a href=#cli-invocation class=md-nav__link> <span class=md-ellipsis> CLI invocation </span> </a> </li> <li class=md-nav__item> <a href=#sample-jinja-templates class=md-nav__link> <span class=md-ellipsis> Sample jinja templates </span> </a> </li> <li class=md-nav__item> <a href=#variable-availability-in-the-jinja-template class=md-nav__link> <span class=md-ellipsis> Variable availability in the jinja template. </span> </a> <nav class=md-nav aria-label="Variable availability in the jinja template."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#lut class=md-nav__link> <span class=md-ellipsis> LUT </span> </a> </li> <li class=md-nav__item> <a href=#resolved-catalog-interface-profile class=md-nav__link> <span class=md-ellipsis> Resolved catalog interface (profile) </span> </a> </li> <li class=md-nav__item> <a href=#ssp-interface class=md-nav__link> <span class=md-ellipsis> SSP interface. </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#custom-jinja-tags class=md-nav__link> <span class=md-ellipsis> Custom Jinja tags. </span> </a> </li> <li class=md-nav__item> <a href=#custom-jinja-filters class=md-nav__link> <span class=md-ellipsis> Custom Jinja filters. </span> </a> </li> <li class=md-nav__item> <a href=#generate-controls-as-individual-markdown-pages class=md-nav__link> <span class=md-ellipsis> Generate controls as individual markdown pages. </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=trestle-author-jinja-output-templating-support-for-oscal-documents>Trestle author jinja - output templating support for oscal documents.<a class=headerlink href=#trestle-author-jinja-output-templating-support-for-oscal-documents title="Permanent link">¤</a></h1> <p>Unfortunately OSCAL documents are not yet universally accepted. Therefore to support various OSCAL and non-OSCAL compliance workflows <code>trestle author jinja</code> is designed to provide end users with the ability to use jinja to produce customized output. This complements the more structured commands <code>trestle author catalog-{assemble|generate}</code>, <code>trestle author profile-{assemble|generate}</code> and <code>trestle author ssp-{assemble|generate}</code> and allows arbitrary use of jinja.</p> <h2 id=jinja-and-jinja-extensions-provided-by-trestle>Jinja and jinja extensions provided by trestle.<a class=headerlink href=#jinja-and-jinja-extensions-provided-by-trestle title="Permanent link">¤</a></h2> <p><a href=https://jinja.palletsprojects.com/en/3.0.x/ >Jinja</a> is a powerful templating engine that is both more flexible that pure 'Moustache' approaches, and not coupled to a particular web application server (as an example Django templates). Users are encouraged to review the <a href=https://jinja.palletsprojects.com/en/3.0.x/templates/ >template designer documentation</a> for jinja as all core functionality is exposed.</p> <p>Trestle's implementation of the Jinja command works in the following way:</p> <ol> <li>The template search space, by default, is relative to the current working directory.</li> <li>Trestle can inject a lookup table, into the jinja variables to contain booleans / substitutions required by end users using Moustache style variable substitutions.</li> <li>Trestle can provide a number of interfaces to OSCAL objects, currently a resolved catalog and a SSP, into jinja.</li> <li>Trestle supports custom jinja tags for importing.</li> <li>The jinja templating is recursive, to ensure all jinja tags are resolved as appropriate.</li> </ol> <p>More details will be on each of these points below.</p> <h2 id=cli-invocation>CLI invocation<a class=headerlink href=#cli-invocation title="Permanent link">¤</a></h2> <p>Note the examples here use markdown, however, jinja can quite easily target xml or html if used w/o specific markdown content. <code>trestle author jinja -i input_template.md.jinja -o output_file.md -ssp SSP_NAME -p PROFILE_NAME -lut lookup_table.yaml -elp lut.prefix</code></p> <ul> <li><code>-i</code> input file path, relative to cwd. Users are encouraged to use the <code>file_name.target_extension.jinja</code> best practice as it helps mitigate issues, however is not required.</li> <li><code>-o</code> final output path, relative to cwd.</li> <li><code>-ssp</code> (optional) ssp name (in the trestle project). When used the jinja template will have a <code>ssp_md_writer</code> variable exposed to use.</li> <li><code>-p</code> (optional) profile name (in the trestle project). When used the jinja template will have <code>resolved_catalog</code> and <code>catalog_interface</code> variables to use.</li> <li><code>-lut</code> (optional) loads yaml into a dictionary in python for which each (top level) variable is available in jinja.</li> <li><code>-elp</code> (optional) a period separated prefix for the variables in the lookup table. E.g. if the lut contained <code>banana: yellow</code> and the prefix was <code>fruit.tropical</code> using <code>{{ fruit.tropical.banana }}</code> would print out <code>yellow</code> in the jinja template.</li> <li><code>-bf</code> (optional) use to provide a custom formatting of the substituted parameters in the text with brackets or markup formatting. Use dot (.) to indicate where the parameter value will be written. E.g. <code>-bf *.*</code> to italicize all substituted parameters, <code>-bf Prefix:.</code> to add <code>Prefix:</code> to all parameters, and <code>-bf [.]</code> to put square brackets around the parameters.</li> <li><code>-vap</code> (optional) use to specify a <code>--value-assigned-prefix</code> in front of parameters that have values assigned by the profile. An example would include the organization doing the assignment, e.g. <code>-vap "ACME Assignment:"</code> This is identical to the behavior of <code>profile-resolve</code>.</li> <li><code>-vnap</code> (optional) use to specify a <code>--value-not-assigned-prefix</code> in front of parameters that do <em>not</em> have values assigned by the profile. An example would be <code>-vap "Assignment:"</code> This is identical to the behavior of <code>profile-resolve</code>.</li> </ul> <h2 id=sample-jinja-templates>Sample jinja templates<a class=headerlink href=#sample-jinja-templates title="Permanent link">¤</a></h2> <p>Below is a sample jinja template for SSP.</p> <table> <thead> <tr> <th>template</th> <th>Description</th> <th>Optional args required</th> </tr> </thead> <tbody> <tr> <td><a href=../trestle_author/sample_ssp.md.jinja>Simple SSP template</a></td> <td>Sample ssp jinja template which prints out all control responses and includes a front-matter section</td> <td><code>-ssp</code> and <code>-p</code> for the ssp json and corresponding profile, respectively. Also requires a <code>frontmatter.md</code> file</td> </tr> </tbody> </table> <h2 id=variable-availability-in-the-jinja-template>Variable availability in the jinja template.<a class=headerlink href=#variable-availability-in-the-jinja-template title="Permanent link">¤</a></h2> <h3 id=lut>LUT<a class=headerlink href=#lut title="Permanent link">¤</a></h3> <p>The lookup table is primarily used for string substitution and to provide variables for basic logic operations in jinja e.g.</p> <p>The LUT:</p> <div class=highlight><pre><span></span><code><span class=nt>names</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>OSCAL</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">Open Security Compliance Assessment Language</span>
+<span class=w>  </span><span class=nt>trestle_pip</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">compliance-trestle</span>
+<span class=w>  </span><span class=nt>trestle_module</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">trestle</span>
+<span class=nt>variables</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>mac_os</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+</code></pre></div> <p>The Jinja template:</p> <div class=highlight><pre><span></span><code><span class=x>Install via pip install </span><span class=cp>{{</span> <span class=nv>names.trestle_pip</span> <span class=cp>}}</span><span class=x> and invoke at the python REPL by import </span><span class=cp>{{</span> <span class=nv>names.trestle_module</span> <span class=cp>}}</span>
+
+<span class=cp>{%</span> <span class=k>if</span> <span class=nv>variables.mac_os</span> <span class=cp>%}</span>
+<span class=x>Users are recommended to use homebrew to install the latest python 3 and then install python within a venv.</span>
+<span class=cp>{%</span> <span class=k>endif</span> <span class=cp>%}</span>
+</code></pre></div> <p>The output:</p> <div class=highlight><pre><span></span><code>Install via pip install compliance-trestle and invoke at the python REPL by import trestle
+
+Users are recommended to use homebrew to install the latest python 3 and then install python within a venv.
+</code></pre></div> <p>Users are free to use the LUT to inject more complex variables (arrays of data etc) to use at their own will using standard jinja templating.</p> <h3 id=resolved-catalog-interface-profile>Resolved catalog interface (profile)<a class=headerlink href=#resolved-catalog-interface-profile title="Permanent link">¤</a></h3> <p>Passing <code>-p</code> exposes a catalog, resolved from the profile, at <code>catalog</code> and a <code>trestle.core.catalog_interface.CatalogInterface</code> at <code>catalog_interface</code>.</p> <p>This allows user to perform various task such as iterating ove reach group and printing the group title.</p> <div class=highlight><pre><span></span><code><span class=cp>{%</span> <span class=k>for</span> <span class=nv>group</span> <span class=k>in</span> <span class=nv>catalog_interface.get_all_groups_from_catalog</span><span class=o>()</span> <span class=o>+</span><span class=cp>%}</span>
+<span class=x>## </span><span class=cp>{{</span> <span class=nv>group.title</span> <span class=cp>}}</span><span class=x> </span><span class=cp>{{</span> <span class=nv>group.class</span> <span class=cp>}}</span><span class=x> \(</span><span class=cp>{{</span> <span class=nv>group.id</span><span class=o>|</span><span class=nf>upper</span> <span class=cp>}}</span><span class=x>\)</span>
+</code></pre></div> <h3 id=ssp-interface>SSP interface.<a class=headerlink href=#ssp-interface title="Permanent link">¤</a></h3> <p>If <code>-ssp</code> is passed a variable within the jinja template called <code>ssp_md_writer</code> is made available which is an instance of <code>trestle.core.ssp_io.SSPMarkdownWriter</code>. <code>-ssp</code> requires that <code>-p</code> has also been set.</p> <p>This as allows users, as an example to print out a control response, as markdown</p> <div class=highlight><pre><span></span><code><span class=x>#### What is the solution and how is it implemented?</span>
+<span class=cp>{{</span> <span class=nv>ssp_md_writer.get_control_response</span><span class=o>(</span><span class=s1>&#39;my_control_id&#39;</span><span class=o>,</span> <span class=m>3</span><span class=o>)</span><span class=cp>}}</span>
+</code></pre></div> <h2 id=custom-jinja-tags>Custom Jinja tags.<a class=headerlink href=#custom-jinja-tags title="Permanent link">¤</a></h2> <p>Trestle provides custom jinja tags for use specifically with markdown: <code>mdsection_include</code> and <code>md_clean_include</code>.</p> <p><code>md_clean_include</code> is similar to the native <code>{% include 'sub_template' %}</code> that jinja provides except for the following:</p> <ol> <li><code>md_clean_include</code> will look for yaml headers in the markdown content and exclude it from the template</li> <li><code>md_clean_include</code> can be used with an optional keyword argument <code>heading_level</code> argument</li> <li><code>{% md_clean_include 'path_to_file.md' heading_level=2 %}</code></li> <li>The heading level argument adjusts to (based on the number of hashes) the most significant heading in the document, if headings exist.</li> </ol> <p><code>mdsection_include</code> is similar to <code>md_clean_include</code> except that:</p> <ol> <li> <p><code>mdsection_include</code> requires an second positional argument which is the title of a heading, from a markdown file, which you want the content from.</p> </li> <li> <p>E.g: <code>{% mdsection_include 'test_markdown.md' '# Header we want' %}</code></p> </li> <li> <p><code>mdsection_include</code> can be used with an optional keyword argument <code>heading_level</code> argument similar to <code>md_clean_include</code></p> </li> <li> <p><code>{% mdsection_include 'test_markdown.md' '# Header we want' %}</code></p> </li> <li>The heading level argument adjusts to (based on the number of hashes) the most significant heading in the chosen section, if headings exist.</li> </ol> <p><code>md_datestamp</code> inserts a date stamp into the output. By default the date is in the format '%Y-%m-%d', e.g. '2021-12-28' and is followed by a double newline to prevent subsequent headings failing to parse correctly. E.g: <code>{% md_datestamp %}</code> results in a date in the format '2021-12-28' being inserted. <code>md_datestamp</code> can be used with the following optional keyword arguments:</p> <ol> <li><code>format</code> where a python <a href=https://docs.python.org/3/library/datetime.html#strftime-and-strptime-format-codes>datetime strftime format string</a> is provided to format the output. E.g. <code>{% md_datestamp format='%B %d, %Y' %}</code> results in <code>December 28, 2021</code> being inserted.</li> <li><code>newline</code> is a boolean to control the addition of a double newline after the inserted date string. For example <code>{% md_datestamp newline=false %}</code> inserts a date in the default format, without additional newlines.</li> </ol> <h2 id=custom-jinja-filters>Custom Jinja filters.<a class=headerlink href=#custom-jinja-filters title="Permanent link">¤</a></h2> <p>Trestle provides custom jinja filters for help processing SSP data.</p> <ul> <li><code>as_list</code> will return the passed value, or an empty list if <code>None</code> is passed in.</li> <li>Example: <code>{% for party in ssp.metadata.parties | as_list %}</code></li> <li><code>get_default</code> operates the same as the built-in Jinja <code>default</code> filter, with the optional second parameter set to <code>True</code></li> <li>Example: <code>{{ control_interface.get_prop(user, 'user-property') | get_default('[Property]') }}</code></li> <li><code>first_or_none</code> will return the first element of a list, or <code>None</code> if the list is empty or <code>None</code> itself.</li> <li>Example: <code>{% set address = party.addresses | first_or_none %}</code></li> <li><code>get_party</code> will return the <code>Party</code> found in <code>ssp.metadata.parties</code> for a given <code>uuid</code></li> <li>Example: <code>{% set organization = party.member_of_organizations | first_or_none | get_party(ssp) %}</code></li> <li><code>parties_for_role</code> will yield individual <code>Party</code> entries when given a list of <code>ResponsibleParty</code> and a <code>role-id</code></li> <li>Example: <code>{% for party in ssp.metadata.responsible_parties | parties_for_role("prepared-by", ssp) %}</code></li> <li><code>diagram_href</code> will return the <code>Link.href</code> where <code>Link.rel == 'diagram'</code> when given a <code>Diagram</code> object</li> <li>Example: <code>![{{diagram.caption}}]({{ diagram | diagram_href }})</code></li> </ul> <h2 id=generate-controls-as-individual-markdown-pages>Generate controls as individual markdown pages.<a class=headerlink href=#generate-controls-as-individual-markdown-pages title="Permanent link">¤</a></h2> <p>Trestle's Jinja functionality allows its users to generate individual markdown pages for each control from a resolved profile catalog. Such functionality can be used later on to pack individual pages into docs of various formats.</p> <p>When <code>--docs-profile</code> or <code>-dp</code> flag is provided as part of the <code>trestle author jinja</code> command, the provided Jinja template will be used to generate a markdown page for each control in each group.</p> <p>For example, suppose we would like to generate the markdown page for each control that would contain <code>Control Objective</code>, <code>Control Statement</code>, <code>Expected Evidence</code>, <code>Implementation Guidance</code> and say <code>Table of Parameters</code> used for this control. To achieve that, we can create a simple Jinja template that would be used to generate each page:</p> <div class=highlight><pre><span></span><code># Control Page
+
+{{ control_writer.write_control_with_sections(
+   control,
+   profile,
+   group_title,
+   [&#39;statement&#39;, &#39;objective&#39;, &#39;expected_evidence&#39;, &#39;implementation_guidance&#39;, &#39;table_of_parameters&#39;],
+   {
+      &#39;statement&#39;:&#39;Control Statement&#39;,
+      &#39;objective&#39;:&#39;Control Objective&#39;,
+      &#39;expected_evidence&#39;:&#39;Expected Evidence&#39;,
+      &#39;implementation_guidance&#39;:&#39;Implementation Guidance&#39;,
+      &#39;table_of_parameters&#39;:&#39;Control Parameters&#39;
+   }
+   )
+
+   | safe
+}}
+</code></pre></div> <p>The template above, would call a control writer that would print the required sections (specified in the list) with the provided headers (specified in the dictionary).</p> <p>We can then generate individual markdown pages by executing: <code>trestle author jinja -i profile_to_docs.md.jinja -o controls -p some_profile -dp</code></p> <p>This will create a folder named <code>controls</code>, that would contain a folder per each group and a markdown file per each control in that group. Each markdown file would be formatted using the Jinja template above.</p> <p>The generated markdown files can then be assembled to the docs of the desired format by adding an indexing page.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">October 22, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/cli/index.html b/latest/tutorials/cli/index.html
new file mode 100644
index 000000000..0e82412c4
--- /dev/null
+++ b/latest/tutorials/cli/index.html
@@ -0,0 +1,750 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="An introductory tutorial into trestle's CLI and OSCAL use cases"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/cli/ rel=canonical><link href=../../reference/API/trestle/transforms/implementations/xccdf/ rel=prev><link href=../compliance_posture/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>trestle CLI Overview - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="trestle CLI Overview - Compliance Trestle"><meta property=og:description content="An introductory tutorial into trestle's CLI and OSCAL use cases"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/cli.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/cli/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="trestle CLI Overview - Compliance Trestle"><meta name=twitter:description content="An introductory tutorial into trestle's CLI and OSCAL use cases"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/cli.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#trestle-cli-overview-and-oscal-usecases class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> trestle CLI Overview </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=./ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> trestle CLI Overview </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> trestle CLI Overview </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#opinionated-directory-structure class=md-nav__link> <span class=md-ellipsis> Opinionated directory structure </span> </a> <nav class=md-nav aria-label="Opinionated directory structure"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#support-for-subdivided-document-structures class=md-nav__link> <span class=md-ellipsis> Support for subdivided document structures </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#specifying-attributes-elements-within-trestle-commands class=md-nav__link> <span class=md-ellipsis> Specifying attributes / elements within trestle commands. </span> </a> <nav class=md-nav aria-label="Specifying attributes / elements within trestle commands."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#rules-for-element-path class=md-nav__link> <span class=md-ellipsis> Rules for element path </span> </a> </li> <li class=md-nav__item> <a href=#a-note-for-software-developers-using-trestle class=md-nav__link> <span class=md-ellipsis> A note for software developers using trestle. </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle-version class=md-nav__link> <span class=md-ellipsis> trestle version </span> </a> </li> <li class=md-nav__item> <a href=#trestle-init class=md-nav__link> <span class=md-ellipsis> trestle init </span> </a> </li> <li class=md-nav__item> <a href=#trestle-create class=md-nav__link> <span class=md-ellipsis> trestle create </span> </a> </li> <li class=md-nav__item> <a href=#trestle-import class=md-nav__link> <span class=md-ellipsis> trestle import </span> </a> </li> <li class=md-nav__item> <a href=#trestle-replicate class=md-nav__link> <span class=md-ellipsis> trestle replicate </span> </a> </li> <li class=md-nav__item> <a href=#trestle-split class=md-nav__link> <span class=md-ellipsis> trestle split </span> </a> </li> <li class=md-nav__item> <a href=#trestle-merge class=md-nav__link> <span class=md-ellipsis> trestle merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle-describe class=md-nav__link> <span class=md-ellipsis> trestle describe </span> </a> </li> <li class=md-nav__item> <a href=#trestle-partial-object-validate class=md-nav__link> <span class=md-ellipsis> trestle partial-object-validate </span> </a> <nav class=md-nav aria-label="trestle partial-object-validate"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-valid-element-paths class=md-nav__link> <span class=md-ellipsis> Example valid element-paths </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle-href class=md-nav__link> <span class=md-ellipsis> trestle href </span> </a> </li> <li class=md-nav__item> <a href=#trestle-assemble class=md-nav__link> <span class=md-ellipsis> trestle assemble </span> </a> </li> <li class=md-nav__item> <a href=#trestle-remove class=md-nav__link> <span class=md-ellipsis> trestle remove </span> </a> </li> <li class=md-nav__item> <a href=#trestle-validate class=md-nav__link> <span class=md-ellipsis> trestle validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle-tasks class=md-nav__link> <span class=md-ellipsis> trestle tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle-task-xccdf-result-to-oscal-ar class=md-nav__link> <span class=md-ellipsis> trestle task xccdf-result-to-oscal-ar </span> </a> </li> <li class=md-nav__item> <a href=#trestle-task-tanium-result-to-oscal-ar class=md-nav__link> <span class=md-ellipsis> trestle task tanium-result-to-oscal-ar </span> </a> </li> <li class=md-nav__item> <a href=#trestle-task-xlsx-to-oscal-cd class=md-nav__link> <span class=md-ellipsis> trestle task xlsx-to-oscal-cd </span> </a> <nav class=md-nav aria-label="trestle task xlsx-to-oscal-cd"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#spreadsheet-to-component-definition-mapping class=md-nav__link> <span class=md-ellipsis> spreadsheet to component definition mapping </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle-task-xlsx-to-oscal-profile class=md-nav__link> <span class=md-ellipsis> trestle task xlsx-to-oscal-profile </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class=md-nav__item> <a href=../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#opinionated-directory-structure class=md-nav__link> <span class=md-ellipsis> Opinionated directory structure </span> </a> <nav class=md-nav aria-label="Opinionated directory structure"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#support-for-subdivided-document-structures class=md-nav__link> <span class=md-ellipsis> Support for subdivided document structures </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#specifying-attributes-elements-within-trestle-commands class=md-nav__link> <span class=md-ellipsis> Specifying attributes / elements within trestle commands. </span> </a> <nav class=md-nav aria-label="Specifying attributes / elements within trestle commands."> <ul class=md-nav__list> <li class=md-nav__item> <a href=#rules-for-element-path class=md-nav__link> <span class=md-ellipsis> Rules for element path </span> </a> </li> <li class=md-nav__item> <a href=#a-note-for-software-developers-using-trestle class=md-nav__link> <span class=md-ellipsis> A note for software developers using trestle. </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle-version class=md-nav__link> <span class=md-ellipsis> trestle version </span> </a> </li> <li class=md-nav__item> <a href=#trestle-init class=md-nav__link> <span class=md-ellipsis> trestle init </span> </a> </li> <li class=md-nav__item> <a href=#trestle-create class=md-nav__link> <span class=md-ellipsis> trestle create </span> </a> </li> <li class=md-nav__item> <a href=#trestle-import class=md-nav__link> <span class=md-ellipsis> trestle import </span> </a> </li> <li class=md-nav__item> <a href=#trestle-replicate class=md-nav__link> <span class=md-ellipsis> trestle replicate </span> </a> </li> <li class=md-nav__item> <a href=#trestle-split class=md-nav__link> <span class=md-ellipsis> trestle split </span> </a> </li> <li class=md-nav__item> <a href=#trestle-merge class=md-nav__link> <span class=md-ellipsis> trestle merge </span> </a> </li> <li class=md-nav__item> <a href=#trestle-describe class=md-nav__link> <span class=md-ellipsis> trestle describe </span> </a> </li> <li class=md-nav__item> <a href=#trestle-partial-object-validate class=md-nav__link> <span class=md-ellipsis> trestle partial-object-validate </span> </a> <nav class=md-nav aria-label="trestle partial-object-validate"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#example-valid-element-paths class=md-nav__link> <span class=md-ellipsis> Example valid element-paths </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle-href class=md-nav__link> <span class=md-ellipsis> trestle href </span> </a> </li> <li class=md-nav__item> <a href=#trestle-assemble class=md-nav__link> <span class=md-ellipsis> trestle assemble </span> </a> </li> <li class=md-nav__item> <a href=#trestle-remove class=md-nav__link> <span class=md-ellipsis> trestle remove </span> </a> </li> <li class=md-nav__item> <a href=#trestle-validate class=md-nav__link> <span class=md-ellipsis> trestle validate </span> </a> </li> <li class=md-nav__item> <a href=#trestle-tasks class=md-nav__link> <span class=md-ellipsis> trestle tasks </span> </a> </li> <li class=md-nav__item> <a href=#trestle-task-xccdf-result-to-oscal-ar class=md-nav__link> <span class=md-ellipsis> trestle task xccdf-result-to-oscal-ar </span> </a> </li> <li class=md-nav__item> <a href=#trestle-task-tanium-result-to-oscal-ar class=md-nav__link> <span class=md-ellipsis> trestle task tanium-result-to-oscal-ar </span> </a> </li> <li class=md-nav__item> <a href=#trestle-task-xlsx-to-oscal-cd class=md-nav__link> <span class=md-ellipsis> trestle task xlsx-to-oscal-cd </span> </a> <nav class=md-nav aria-label="trestle task xlsx-to-oscal-cd"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#spreadsheet-to-component-definition-mapping class=md-nav__link> <span class=md-ellipsis> spreadsheet to component definition mapping </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#trestle-task-xlsx-to-oscal-profile class=md-nav__link> <span class=md-ellipsis> trestle task xlsx-to-oscal-profile </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=trestle-cli-overview-and-oscal-usecases>trestle CLI Overview and OSCAL usecases<a class=headerlink href=#trestle-cli-overview-and-oscal-usecases title="Permanent link">¤</a></h1> <p>The trestle CLI has three primary use cases:</p> <ul> <li>Serve as tooling to generate and manipulate OSCAL files directly by an end user. The objective is to reduce the complexity of creating and editing workflows. Example commands are: <code>trestle import</code>, <code>trestle create</code>, <code>trestle split</code>, <code>trestle merge</code>.</li> <li>Act as an automation tool that, by design, can be an integral part of a CI/CD pipeline e.g. <code>trestle validate</code>, <code>trestle tasks</code>.</li> <li>Allow governance of markdown documents so they conform to specific style or structure requirements.</li> </ul> <p>To support each of these use cases trestle creates an opinionated directory structure to manage governed documents.</p> <h2 id=opinionated-directory-structure>Opinionated directory structure<a class=headerlink href=#opinionated-directory-structure title="Permanent link">¤</a></h2> <p>Trestle relies on an opinionated directory structure (trestle workspace), similar to <code>git</code>, <code>go</code>, or <code>auditree</code>, to manage the workflow. Most trestle commands are restricted to working within an initialized directory tree.</p> <p>The directory structure setup by trestle has three major elements:</p> <ul> <li>A <code>.trestle</code> hidden folder.</li> <li>A <code>dist</code> folder.</li> <li>Folders for each of the top level OSCAL models.</li> </ul> <p>The outline of the schema is below:</p> <div class=highlight><pre><span></span><code>.
+├── .trestle
+├── dist
+│   ├── catalogs
+│   ├── profiles
+│   ├── component-definitions
+│   ├── system-security-plans
+│   ├── assessment-plans
+│   ├── assessment-results
+│   └── plan-of-action-and-milestones
+├── catalogs
+├── profiles
+├── component-definitions
+├── system-security-plans
+├── assessment-plans
+├── assessment-results
+└── plan-of-action-and-milestones
+</code></pre></div> <p><code>.trestle</code> directory is a special directory containing various trestle artefacts to help run various other commands. Examples include configuration files, caches and templates.</p> <p><code>dist</code> directory will contain the assembled version of the top level models located on the source model directories.</p> <p>The bulk of the folder structure is used to represent each of the <em>top level schemas</em> or <em>top level models</em> such as <code>catalogs</code> and <code>profiles</code>. For each of these directories the following root structure is maintained:</p> <div class=highlight><pre><span></span><code>├── .trestle
+└── TOP_LEVEL_MODEL_PLURAL
+    └── NAME_OF_MODEL_INSTANCE
+        └── TOP_LEVEL_MODEL_NAME.{json,yaml,yml}
+</code></pre></div> <p>which appears, for a catalog a user decides is titled nist-800-53, as:</p> <div class=highlight><pre><span></span><code>├── .trestle
+└── catalogs
+    └── nist-800-53
+        └── catalog.json
+</code></pre></div> <p>In most of the places in the documentation we use <code>json</code> format for specifying model files, but they are equally applicable to <code>yaml</code> format also. The default format is <code>json</code>, and <code>yaml</code> is supported on best effort basis. Within one model directory the two different formats should not be mixed.</p> <h3 id=support-for-subdivided-document-structures>Support for subdivided document structures<a class=headerlink href=#support-for-subdivided-document-structures title="Permanent link">¤</a></h3> <p>The files constructed by OSCAL can run into tens of thousands of lines of yaml or formatted json. At this size the files become completely unmanageable for users. To combat this, trestle can <code>trestle split</code> a file into many smaller files and later merge those split files together.</p> <p>Directory structures such as the one below can represent OSCAL document structures. Users are strongly encourage to rely on split and merge to code these structures.</p> <p>Users can query the contents of files using <code>trestle describe</code>, and probe the contents more deeply using it in combination with element paths.</p> <div class=highlight><pre><span></span><code>.
+├── .trestle
+├── dist 
+│   └── catalogs
+│       └── nist800-53.json 
+└── catalogs
+    └── nist800-53
+        ├── catalog.json
+        └── catalog
+            ├── metadata.json
+            ├── metadata
+            │   ├── revision-history
+            │   │   ├── 00000__revision-history.json
+            │   │   ├── 00001__revision-history.json
+            │   │   └── 00002__revision-history.json   
+            │   └── responsible-parties
+            │       ├── creator__responsible-party.json
+            │       └── contact__responsible-party.json       
+            └── groups
+                ├── 00000__group.json        
+                ├── 00000__group
+                │   └── controls
+                │       ├── 00000__control.json
+                │       └── 00001__control.json
+                ├── 00001__group.json 
+                └── 00001__group
+                    └── controls
+                        ├── 00000__control.json
+                        └── 00001__control.json
+...
+</code></pre></div> <h2 id=specifying-attributes-elements-within-trestle-commands>Specifying attributes / elements within trestle commands.<a class=headerlink href=#specifying-attributes-elements-within-trestle-commands title="Permanent link">¤</a></h2> <p>OSCAL models are rich and contain multiple nested data structures. Given this, a mechanism is required to address <em>elements</em> /<em>attributes</em> within an oscal object.</p> <p>This accessing method is called 'element path' and is similar to <em>jsonPath</em>. Commands provide element path by a <code>-e</code> argument where available, e.g. trestle split -f catalog.json -e 'catalog.metadata.*'. This path is used whenever specifying an attribute or model, rather than exposing trestle's underlying object model name. Users can refer to <a href=https://pages.nist.gov/OSCAL-Reference/models/latest/complete/json-outline/ >NIST's json outline</a> to understand object names in trestle.</p> <h3 id=rules-for-element-path>Rules for element path<a class=headerlink href=#rules-for-element-path title="Permanent link">¤</a></h3> <ol> <li>Element path is an expression of the attribute names, <a href=https://pages.nist.gov/OSCAL-Reference/models/latest/complete/json-outline/ >in json form</a> , concatenated by a period (<code>.</code>).</li> <li>E.g. The metadata in a catalog is referred to as <code>catalog.metadata</code></li> <li>Element paths are relative to the file.</li> <li>e.g. For <code>metadata.json</code> roles would be referred to as <code>metadata.roles</code>, from the catalog file that would be <code>catalog.metadata.roles</code></li> <li>Arrays can be handled by a wild card <code>*</code> or a numerical index for a specific index.</li> <li><code>catalog.groups.*</code> to refer to each group in a catalog</li> <li><code>catalog.groups.*.controls.*</code> to refer to 'for each control under a top level group'</li> <li>For NIST 800-53 <code>catalog.groups.0.controls.0.</code></li> <li>On *nix platforms if using the wildcard the element path argument should be wrapped in quotes to prevent problems with the shell interpreting the wild card before trestle can</li> <li>When dealing with an array based object, the array syntax may be skipped when passing a model</li> <li>e.g. a control could be <code>catalog.controls.control</code> or <code>catalog.groups.controls.control</code></li> <li>This syntax is required as OSCAL, across the schema, has conflicting element definitions.</li> </ol> <h3 id=a-note-for-software-developers-using-trestle>A note for software developers using trestle.<a class=headerlink href=#a-note-for-software-developers-using-trestle title="Permanent link">¤</a></h3> <p>Trestle provides utilities for converting from element path to trestle's python object model. The (slightly simplified) model is:</p> <ol> <li>Class attributes are converted from <code>dash-case</code> to <code>dash_case</code> (aka snake_case)</li> <li>Class names are converted from <code>dash-case</code> to <code>DashCase</code> (aka CamelCase)</li> </ol> <h2 id=trestle-version><code>trestle version</code><a class=headerlink href=#trestle-version title="Permanent link">¤</a></h2> <p>This command will return the current version of Trestle and OSCAL it is using.</p> <p>Running <code>trestle version</code> will return:</p> <blockquote> <p>Trestle version v2.0.0 based on OSCAL version 1.0.4</p> </blockquote> <p>It can also be used to retrieve the metadata version of the OSCAL object:</p> <div class=highlight><pre><span></span><code><span class=nt>&quot;catalog&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+
+<span class=w>    </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fa3f44a8-25cd-4f6a-8175-7afe647df7ed&quot;</span><span class=p>,</span>
+
+<span class=w>    </span><span class=nt>&quot;metadata&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Catalog1&quot;</span><span class=p>,</span>
+
+<span class=w>      </span><span class=nt>&quot;last-modified&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2023-01-11T17:04:02.840910+00:00&quot;</span><span class=p>,</span>
+
+<span class=w>      </span><span class=nt>&quot;version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;0.1.10&quot;</span><span class=p>,</span><span class=w> </span><span class=err>&lt;&lt;&lt;</span><span class=w> </span><span class=kc>t</span><span class=err>his</span><span class=w> </span><span class=err>versio</span><span class=kc>n</span><span class=w> </span><span class=err>here</span>
+
+<span class=w>      </span><span class=nt>&quot;oscal-version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.0.4&quot;</span>
+
+<span class=w>    </span><span class=p>},</span>
+<span class=err>...</span>
+</code></pre></div> <ul> <li><code>-t or --type</code> - a type of the OSCAL object (can be either catalog, profile, component-definition, system-security-plan, etc)</li> <li><code>-n or --name</code> - a name of the OSCAL object</li> </ul> <p>Running <code>trestle version -n nist -t catalog</code> will return:</p> <blockquote> <p>Version of OSCAL object of nist catalog is: 1.0.0</p> </blockquote> <h2 id=trestle-init><code>trestle init</code><a class=headerlink href=#trestle-init title="Permanent link">¤</a></h2> <p>This command will create (initialize) a trestle workspace in the current directory with the necessary directory structure and trestle artefacts. This command has multiple modes that it can run in:</p> <ul> <li><code>--full</code></li> <li><code>--local</code></li> <li><code>--govdocs</code></li> </ul> <p>By default <code>trestle init</code> will run in the <code>--full</code> mode.</p> <p><code>--full</code> mode is meant to be used when full functionality of Trestle is used i.e. managing OSCAL models locally, govern documents or using Trestle for API purposes. <code>dist</code> repository will be used when <code>trestle assemble</code> command is used. Running <code>trestle init --full</code> will create the directory structure below for different artefacts:</p> <div class=highlight><pre><span></span><code>.
+├── .trestle
+├── dist
+│   ├── catalogs
+│   ├── profiles
+│   ├── component-definitions
+│   ├── system-security-plans
+│   ├── assessment-plans
+│   ├── assessment-results
+│   └── plan-of-action-and-milestones
+├── catalogs
+├── profiles
+├── component-definitions
+├── system-security-plans
+├── assessment-plans
+├── assessment-results
+└── plan-of-action-and-milestones
+</code></pre></div> <p><code>--local</code> mode is meant to be used when Trestle is used to only manage OSCAL models locally. Running <code>trestle init --local</code> will create the directory structure below for different artefacts:</p> <div class=highlight><pre><span></span><code>.
+├── .trestle
+├── catalogs
+├── profiles
+├── component-definitions
+├── system-security-plans
+├── assessment-plans
+├── assessment-results
+└── plan-of-action-and-milestones
+</code></pre></div> <p><code>--govdocs</code> mode is meant to be used when Trestle is only used to govern documents. Running <code>trestle init --govdocs</code> will create the directory structure below:</p> <div class=highlight><pre><span></span><code>.
+├── .trestle
+</code></pre></div> <p><code>.trestle</code> directory is a special directory containing various trestle artefacts to help run various other commands.</p> <p><code>dist</code> directory will contain the merged or assembled version of the top level models located on the source model directories which are: <code>catalogs</code>, <code>profiles</code>, <code>component-definitions</code>, <code>system-security-plans</code>, <code>assessment-plans</code>, <code>assessment-results</code> and <code>plan-of-action-and-milestones</code>.</p> <p>Notice that trestle is a highly opinionated tool and, therefore, the names of the files and directories that are created by any of the <code>trestle</code> commands and subcommands MUST NOT be changed manually.</p> <h2 id=trestle-create><code>trestle create</code><a class=headerlink href=#trestle-create title="Permanent link">¤</a></h2> <p>This command will create a bare-bones sample file for one of the top level OSCAL models, and it can also create new elements within an existing file. For example, <code>trestle create -t catalog -o nist800-53</code> will create a sample catalog file, <code>catalog.json</code> in the catalog subdirectory, <code>nist800-53</code> as shown below:</p> <div class=highlight><pre><span></span><code>.
+├── .trestle
+└── catalogs
+    └── nist800-53
+        └── catalog.json
+...
+</code></pre></div> <p>The <code>-t</code> specifies the type of the model to create, which can be one of catalog, profile, component-definition, system-security-plan, assessment-plan, assessment-results, plan-of-action-and-milestones. Each type will be created in its corresponding directory, such as catalogs, profiles, etc.</p> <p>The following additional options are supported:</p> <ul> <li><code>-o or --output</code>: specifies the name/alias of a model. It is used as the prefix for the output filename under the <code>dist</code> directory and for naming the source subdirectories under <code>catalogs</code>, <code>profiles</code>, <code>component-definitions</code>, <code>system-security-plans</code>, <code>assessment-plans</code>, <code>assessment-results</code> or <code>plan-of-action-and-milestones</code>.</li> </ul> <p>The user can edit the parts of the generated OSCAL model by modifying the sample content in those directories.</p> <p>Passing <code>-iof</code> or <code>--include-optional-fields</code> will make <code>trestle create</code> generate a richer model containing all optional fields until finding recursion in the model (e.g controls within control).</p> <p>In addition, <code>trestle create</code> can create new components within an existing file by specifying the existing file name and the corresponding element path to create within that file.</p> <p>For example,</p> <p><code>$TRESTLE_BASEDIR/catalogs/nist800-53$ trestle create -f ./catalog.json -e catalog.metadata.roles</code></p> <p>will add the following property under the <code>metadata</code> property for a catalog that will be written to the appropriate file under <code>catalogs/nist800-53</code> directory:</p> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;roles&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;id&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;REPLACE_ME&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;REPLACE_ME&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> <p>Default values for mandatory datatypes will be like below. All UUID's will be populated by default whether or not they are mandatory.</p> <div class=highlight><pre><span></span><code><span class=w>  </span><span class="p p-Indicator">-</span><span class=w> </span><span class=nt>DateTime</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;Current date-time&gt;</span>
+<span class=w>  </span><span class="p p-Indicator">-</span><span class=w> </span><span class=nt>Boolean</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">false</span>
+<span class=w>  </span><span class="p p-Indicator">-</span><span class=w> </span><span class=nt>Integer</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">0</span>
+<span class=w>  </span><span class="p p-Indicator">-</span><span class=w> </span><span class=nt>String</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">REPLACE_ME</span>
+<span class=w>  </span><span class="p p-Indicator">-</span><span class=w> </span><span class=nt>Float/Double</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">0.00</span>
+<span class=w>  </span><span class="p p-Indicator">-</span><span class=w> </span><span class=nt>Id field</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">Auto generated UUID</span>
+</code></pre></div> <p>Again, passing <code>-iof</code> or <code>--include-optional-fields</code> will make <code>trestle create</code> generate a richer version of the element being created, by including optional fields.</p> <h2 id=trestle-import><code>trestle import</code><a class=headerlink href=#trestle-import title="Permanent link">¤</a></h2> <p>This command allows users to import existing OSCAL files so that they can be managed using trestle. For example <code>trestle import -f /local_dir/existing_catalog.json -o my_existing_catalog</code> will import <code>existing_catalog.json</code> into a new folder under <code>catalogs</code> as shown below:</p> <div class=highlight><pre><span></span><code>.
+├── .trestle
+└── catalogs
+    └── my_existing_catalog
+        └── catalog.json
+...
+</code></pre></div> <p>The following options are supported:</p> <ul> <li><code>-f or --file</code>: specifies the path of an existing OSCAL file or URL to a remote file.</li> <li><code>-o or --output</code>: specifies the name/alias of a model. It is used as the prefix for the output filename under the <code>dist</code> directory and for naming the source subdirectories under <code>catalogs</code>, <code>profiles</code>, <code>component-definitions</code>, <code>system-security-plans</code>, <code>assessment-plans</code>, <code>assessment-results</code> or <code>plan-of-action-and-milestones</code>.</li> </ul> <p>The <code>--file</code> option may be an absolute or relative path, and it may be a URL. For details on allowed formats please see the documentation for the <code>href</code> command. The file must be imported from outside the current trestle directory or an error will result.</p> <p>The import subcommand can determine the type of the model that is to be imported by the contents of the file. But the file name must end with an allowed json or yaml extension: <code>.json, .yaml, .yml</code></p> <p>During the import process the file must pass the <code>validate</code> test described below for the command, <code>validate</code>. If the file does not pass validation a warning will be given describing the nature of the problem and the import will fail.</p> <p>Once a file has been imported it can be split into a rich tree of sub-components as shown at the top of this document. But the file must be imported first.</p> <h2 id=trestle-replicate><code>trestle replicate</code><a class=headerlink href=#trestle-replicate title="Permanent link">¤</a></h2> <p>This command allows users to replicate a certain OSCAL model (file and directory structure). For example <code>trestle replicate catalog -n cat1 -o cat11</code> will replicate the Catalog cat1 into <code>cat11</code> directory. It can also regenerate all the UUIDs as required.</p> <h2 id=trestle-split><code>trestle split</code><a class=headerlink href=#trestle-split title="Permanent link">¤</a></h2> <p>This command allows users to further decompose a trestle model into additional subcomponents.</p> <p>The following options are currently supported:</p> <ul> <li><code>-f or --file</code>: this is optional and specifies the file path of the json/yaml file containing the elements that will be split.</li> <li><code>-e or --elements</code>: specifies the model subcomponent element(s) (JSON/YAML property path) that is/are going to be split. Multiple elements can be specified at once using a comma-separated value, e.g <code>-e 'catalog.metadata,catalog.groups'</code>. Make sure to include the quotes that enclose the comma-separated paths.</li> </ul> <p>If the element is of JSON/YAML type array list and you want trestle to create a separate subcomponent file per array item, the element needs to be suffixed with <code>.*</code>, e.g. <code>-e 'catalog.groups.*'</code>. If the suffix is not specified, split will place all array items in only one separate subcomponent file, e.g. <code>'groups.json'</code>. Again, make sure to include the quotes around the elements.</p> <p>If you just want to split a file into all its constituent parts and the file does not contain a simple list of objects, you can still use <code>*</code> and the file will be split into all its non-trivial elements. Thus if you split a catalog with <code>-e catalog.*</code> the result will be a new directory, <code>catalog</code>, containing files representing the large items, <code>back-matter.json, groups.json and metadata.json</code>, but there will still be a <code>catalog.json</code> file containing just the catalog's <code>uuid</code>. Small items such as strings and dates cannot be split off and will remain in the original model file that is being split.</p> <p>Here are some examples. Starting with a single catalog file, <code>my_catalog/catalog.json</code>, if you do <code>trestle split -f catalog.json -e 'catalog.*'</code> you end up with:</p> <div class=highlight><pre><span></span><code>catalogs
+ ┗ my_catalog
+ ┃ ┣ catalog
+ ┃ ┃ ┣ back-matter.json
+ ┃ ┃ ┣ groups.json
+ ┃ ┃ ┗ metadata.json
+ ┃ ┗ catalog.json
+</code></pre></div> <p>If you then split roles out of metadata as a single file containing a list of roles, <code>trestle split -f catalog/metadata.json -e 'metadata.roles'</code> you would end up with:</p> <div class=highlight><pre><span></span><code>catalogs
+ ┗ my_catalog
+ ┃ ┣ catalog
+ ┃ ┃ ┣ metadata
+ ┃ ┃ ┃ ┗ roles.json
+ ┃ ┃ ┣ back-matter.json
+ ┃ ┃ ┣ groups.json
+ ┃ ┃ ┗ metadata.json
+ ┃ ┗ catalog.json
+</code></pre></div> <p>If instead you had specified <code>-e 'metadata.roles.*'</code> you would get:</p> <div class=highlight><pre><span></span><code>my_catalog
+ ┣ catalog
+ ┃ ┣ metadata
+ ┃ ┃ ┗ roles
+ ┃ ┃ ┃ ┣ 00000__role.json
+ ┃ ┃ ┃ ┗ 00001__role.json
+ ┃ ┣ back-matter.json
+ ┃ ┣ groups.json
+ ┃ ┗ metadata.json
+ ┗ catalog.json
+</code></pre></div> <p>You can see there is no <code>roles.json</code> file anymore and instead there is a subdirectory, <code>roles</code> containing a list of files, one for each <code>role</code>.</p> <p>If the <code>-f or --file</code> option is not specified, the file to split will be determined from the elements specified, in the context of the current working directory. The current directory must be within a specific model (e.g. <code>catalog</code> or <code>profile</code>), and the element paths must either be absolute (e.g. <code>catalog.metadata.roles</code>) or relative to the current working directory. For example, if you are in <code>catalogs/mycat/catalog/groups</code> and you want to split the file <code>00000__group.json</code>, you must use <code>-f</code> to specify the filename, and the element path can either be absolute, as <code>catalog.group.*</code>, or you can set the current working directory to where the file is and use element path <code>group.*</code>. This makes it easier to specify splits when deep in a directory structure.</p> <p>Every subdirectory in a trestle directory model should have a corresponding <code>.json</code> or <code>.yaml</code> file with the same name, except when that subdirectory corresponds to a list of items, such as <code>catalog.groups</code>. When those subcomponents are split/expanded each file or subdirectory under them represents an item of the collection. Because of that, if a corresponding <code>groups.json | groups.yaml</code> file were to exist, its contents would just be an empty representation of that collection and the user would need to be careful never to edit that file. Therefore, we decided not to create that corresponding file in those cases. Following the same logic, another exception is when all the fields from a <code>.json | .yaml</code> file are split, leaving the original file as an empty object. In that case, the file would be deleted as well.</p> <p>To inspect a file to see what elements can be split from it, use the <code>describe</code> command described below. It is also useful for inspection of files created by the split operation.</p> <h2 id=trestle-merge><code>trestle merge</code><a class=headerlink href=#trestle-merge title="Permanent link">¤</a></h2> <p>The trestle merge command is the reversal of <code>trestle split</code>. This command allows users to reverse the decomposition of a trestle model by aggregating subcomponents scattered across multiple files or directories into the parent JSON/YAML file. To merge a model, you have to first change working directory to the root model component directory that you want to merge a sub-component model into. The following option is required:</p> <ul> <li><code>-e or --elements</code>: specifies the properties (JSON/YAML path) that will be merged, relative to the current working directory. This must contain at least 2 elements, where the last element is the model/sub-component to be merged into the second from last component.</li> </ul> <p>For example, in the command <code>trestle merge -e 'catalog.metadata'</code>, executed in the same directory where <code>catalog.json</code> or the split <code>catalog</code> directory exists, the property <code>metadata</code> from <code>metadata.json</code> would be moved/merged into <code>catalog.json</code>. If the <code>metadata</code> model has already been split into smaller sub-component models previously, those smaller sub-components are first recusively merged into <code>metadata</code>, before merging <code>metadata</code> subcomponent into <code>catalog</code>. To specify merging every sub-component split from a component, <code>.*</code> can be used. For example, <code>trestle merge -e 'catalog.*'</code> command, issued from the directory where <code>catalog.json</code> or<code>catalog</code> directory exists, will merge every single sub-component of that catalog back into the <code>catalog.json</code>.</p> <h2 id=trestle-describe><code>trestle describe</code><a class=headerlink href=#trestle-describe title="Permanent link">¤</a></h2> <p>This command lets users inspect model files to explore contents using an optional element path. The command can work well in concert with <code>split</code> to show what each file contains, and probe within the contents to determine sub-components that can be extracted as separate files.</p> <p>Unlike split, describe only describes the contents of a single item, so the element path may not contain wildcards (<code>*</code>) or commas.</p> <p>For example, if a catalog file has been imported to <code>catalogs/my_catalog/catalog.json</code> then the commmand, <code>trestle describe -f catalog.json</code> might yield:</p> <div class=highlight><pre><span></span><code><span class=c1>#Model file catalog.json is of type catalog.Catalog and contains</span>
+<span class=nt>uuid</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">613fca2d-704a-42e7-8e2b-b206fb92b456</span>
+<span class=nt>metadata</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">common.Metadata</span>
+<span class=nt>params</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">None</span>
+<span class=nt>controls</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">None</span>
+<span class=nt>groups</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">list of 20 items of type catalog.Group</span>
+<span class=nt>back_matter</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">common.BackMatter</span>
+</code></pre></div> <p>Note that contents are listed even when they are empty (and therefore optional) so the full potential contents can be seen. Also note that if an item corresponds to a list of elements, the number and type of elements is provided. Finally, if an item is a simple string such as <code>id</code>, <code>uuid</code> or <code>title</code>, the string is shown directly up to a maximum of 100 characters. If the string is clipped it will be indicated by <code>[truncated]</code> at the end of the string.</p> <p>An element path can be specified to probe the contents, as in <code>trestle describe -f catalog.json -e 'catalog.metadata.roles'</code>. A possible response is:</p> <div class=highlight><pre><span></span><code>Model file catalog.json at element path catalog.metadata.roles is a list of 2 items of type common.Role
+</code></pre></div> <p>You can also query individual elements, and elements of an element, e.g. <code>trestle describe -f catalog.json -e 'catalog.groups.5.controls.3'</code></p> <div class=highlight><pre><span></span><code><span class=c1># Model file catalog.json at element path catalog.groups.5.controls.3 is of type catalog.Control and contains:</span>
+<span class=nt>id</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">cp-4</span>
+<span class=nt>class_</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">SP800-53</span>
+<span class=nt>title</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">Contingency Plan Testing</span>
+<span class=nt>params</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">list of 2 items of type common.Parameter</span>
+<span class=nt>props</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">list of 2 items of type common.Property</span>
+<span class=nt>links</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">list of 14 items of type common.Link</span>
+<span class=nt>parts</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">list of 2 items of type common.Part</span>
+<span class=nt>controls</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">list of 5 items of type catalog.Control</span>
+</code></pre></div> <p>(Note that the numbering starts at 0, so the <code>.3</code> corresponds to the 4th element.)</p> <p>In all output from <code>describe</code> the type of the item shown corresponds to the python file and class of the corresponding OSCAL model in trestle.</p> <p>If you split items off a model so they end up in a subdirectory, the original file is referred to as a "stripped" model, with parts of it stripped off and only some elements remaining. For example, if you do <code>trestle split -f catalog.json -e 'catalog.metadata'</code> it will split off metadata from the original <code>catalog.json</code> file and place it in <code>catalog/metadata.json</code>. If you then do <code>trestle describe -f catalog.json</code> on the new file, it will say something like:</p> <div class=highlight><pre><span></span><code><span class=c1># Model file catalog.json is of type stripped.Catalog and contains:</span>
+<span class=nt>uuid</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">613fca2d-704a-42e7-8e2b-b206fb92b456</span>
+<span class=nt>params</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">None</span>
+<span class=nt>controls</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">None</span>
+<span class=nt>groups</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">list of 20 items of type catalog.Group</span>
+<span class=nt>back_matter</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">common.BackMatter</span>
+</code></pre></div> <p>Note that the type of the file is now <code>stripped.Catalog</code> and it no longer contains <code>metadata</code>. Even though metadata is no longer in the original <code>.json</code> file, trestle is still aware it is present in the model since it is properly placed as its own file in the subdirectory, <code>catalog</code>.</p> <h2 id=trestle-partial-object-validate><code>trestle partial-object-validate</code><a class=headerlink href=#trestle-partial-object-validate title="Permanent link">¤</a></h2> <p>OSCAL objects may be extremely large. Some systems may only be able to produce partial OSCAL objects. For example, the tanium-result-to-oscal-ar task produces the <code>results</code> attribute of an <code>assessment-results</code> object.</p> <p><code>trestle partial-object-validate</code> allows the validation of any sub-element/attribute using element path.</p> <p>Using the example above <code>trestle partial-object-validate -f results.json -e assessment-results.results</code>.</p> <p>The file is not required to be in the trestle directory or required to be a specific file name.</p> <h3 id=example-valid-element-paths>Example valid element-paths<a class=headerlink href=#example-valid-element-paths title="Permanent link">¤</a></h3> <p>All element paths must be absolute e.g.: <code>catalog.metadata</code> <code>catalog</code> <code>catalog.groups</code> <code>catalog.groups.group.controls.control.controls.control</code> Remembering in the end you only care about the end type. So in this scenario <code>catalog.groups.group.controls.control.controls.control</code> is equivalent to <code>catalog.controls.control</code>.</p> <h2 id=trestle-href><code>trestle href</code><a class=headerlink href=#trestle-href title="Permanent link">¤</a></h2> <p>This command changes the href of an Import in a profile and is needed when generating an SSP (system security plan) with the author tool, <code>ssp-generate</code>. The Imports in a profile are used to load associated catalogs of controls and profiles, and must be available at the corresponding href uri. If an imported catalog is in the trestle directory then the href should be changed with a command of the form:</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>href<span class=w> </span>-n<span class=w> </span>my_profile<span class=w> </span>-hr<span class=w> </span>trestle://catalogs/my_catalog/catalog.json
+</code></pre></div> <p>Similarly, if the item imported is a profile, a corresponding href should point to a json file in the <code>profiles</code> directory.</p> <p>Note that catalogs or profiles in the trestle directory are indicated by the <code>trestle://</code> prefix, followed by the path from the top level models directory to the actual catalog file. The profile itself, which is having its imports modified, is just indicated by its name with the <code>-n</code> option.</p> <p>If the profile has more than one import, you can display the corresponding hrefs with:</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>href<span class=w> </span>-n<span class=w> </span>my_profile
+</code></pre></div> <p>This will give a numbered list of the hrefs. You can then change them individually by providing the corresponding item number:</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>href<span class=w> </span>-n<span class=w> </span>my_profile<span class=w> </span>-i<span class=w> </span><span class=m>1</span><span class=w> </span>-hr<span class=w> </span>trestle://catalogs/my_catalog/catalog.json
+</code></pre></div> <p>This will change the href indexed as <code>1</code> when the list was displayed. The href's are indexed starting from 0.</p> <p>The <code>trestle href</code> command can also be used to change the value back to the intended one prior to distribution of the profile.</p> <p>The provided href can be of form <code>trestle://</code>, <code>https://</code>, <code>sftp://</code>, or <code>file:///</code>. If <code>file:///</code> is used, the path provided must be absolute - and on Windows it must include the drive letter followed by a slash. The only time a relative path is allowed is with the <code>trestle://</code> heading.</p> <p>A username and password may be embedded in the url for <code>https://</code>, and a CA certificate path will be searched from environment variables <code>REQUESTS_CA_BUNDLE</code> and <code>CURL_CA_BUNDLE</code> in that order.</p> <p>Authorization for <code>sftp://</code> access relies on the user's private key being either active via <code>ssh-agent</code> or supplied via the environment variable <code>SSH_KEY</code>. In the latter case it must not require a passphrase prompt.</p> <h2 id=trestle-assemble><code>trestle assemble</code><a class=headerlink href=#trestle-assemble title="Permanent link">¤</a></h2> <p>This command assembles all contents (files and directories) representing a specific model into a single OSCAL file located under <code>dist</code> folder. For example,</p> <p><code>$TRESTLE_BASEDIR$ trestle assemble catalog -n nist800-53</code></p> <p>will traverse the <code>catalogs/nist800-53</code> directory and its children and combine all data into a OSCAL file that will be written to <code>dist/catalogs/nist800-53.json</code>. Note that the parts of catalog <code>nist800-53</code> can be written in either YAML/JSON (e.g. based on the file extension), however, the output will be generated as YAML/JSON as desired. Trestle will infer the content type from the file extension and create the model representation appropriately in memory and then output in the desired format. Trestle assemble will also validate content as it assembles the files and make sure the contents are syntactically correct.</p> <h2 id=trestle-remove><code>trestle remove</code><a class=headerlink href=#trestle-remove title="Permanent link">¤</a></h2> <p>The trestle remove command is the reversal of <code>trestle create -f filename.json -e element_path</code>, as it will remove the corresponding element from the specified file.</p> <h2 id=trestle-validate><code>trestle validate</code><a class=headerlink href=#trestle-validate title="Permanent link">¤</a></h2> <p>Trestle validate checks the integrity of one or more OSCAL files in a number of ways.</p> <p><code>validate</code> returns a non-zero return code if there is any validation problem detected in a file.</p> <p>The current list of validation modes that get checked internally are:</p> <table> <thead> <tr> <th>Mode</th> <th>Purpose</th> </tr> </thead> <tbody> <tr> <td>duplicates</td> <td>Detect whether disallowed duplicate uuid's are present</td> </tr> <tr> <td>oscal_version</td> <td>Confirm that the oscal version of the file is supported</td> </tr> <tr> <td>refs</td> <td>Confirm that all references in responsible parties are found in roles</td> </tr> <tr> <td>catalog</td> <td>Confirm all parameter ids in a catalog are unique</td> </tr> <tr> <td>links</td> <td>Confirm referenced resources are 1:1 with resources in backmatter</td> </tr> </tbody> </table> <p>You can validate a single model file by specifying its full path:</p> <p><code>trestle validate -f catalogs/my_cat/catalog.json</code></p> <p>or by specifying its model name and type:</p> <p><code>trestle validate -t catalog -n my_cat</code></p> <p>In addition to validating a single file you can validate all files of a given type with the <code>-t</code> option and no file name:</p> <p><code>trestle validate -t catalog</code></p> <p>And you can validate all models with the <code>-a</code> option:</p> <p><code>trestle validate -a</code></p> <p>Note that when you <code>Import</code> a file it will perform a full validation on it first, and if it does not pass validation the file cannot be imported.</p> <p>By default validate will display warning messages and a message indicating the file is valid, but you can suppress those messages with the <code>-q --quiet</code> option.</p> <p>The links validator is special because it always returns success that the file is valid - but it will list any inconsistencies it finds between the references to links, and corresponding links in the backmatter.</p> <h2 id=trestle-tasks><code>trestle tasks</code><a class=headerlink href=#trestle-tasks title="Permanent link">¤</a></h2> <p>Open Shift Compliance Operator and Tanium are supported as 3rd party tools.</p> <h2 id=trestle-task-xccdf-result-to-oscal-ar><code>trestle task xccdf-result-to-oscal-ar</code><a class=headerlink href=#trestle-task-xccdf-result-to-oscal-ar title="Permanent link">¤</a></h2> <p>The <em>trestle task xccdf-result-to-oscal-ar</em> command facilitates transformation of XCCDF results, e.g. OpenShift Compliance Operator (OSCO) scan results, <em>.yaml</em> files into OSCAL partial results <em>.json</em> files. Specify required config parameters to indicate the location of the input and the output. Specify optional config parameters to indicate the name of the oscal-metadata.yaml file, if any, and whether overwriting of existing output is permitted.</p> <p><span style=color:green> Example command invocation: </span></p> <p><code>$TRESTLE_BASEDIR$ trestle task xccdf-result-to-oscal-ar -c /home/user/task.config</code></p> <p><span style=color:green> Example config: </span></p> <p><em>/home/user/task.config</em></p> <div class=highlight><pre><span></span><code>[task.xccdf-result-to-oscal-ar]
+
+input-dir =  /home/user/git/evidence/xccdf/input
+output-dir = /home/user/git/evidence/oscal/output
+oscal-metadata = oscal-metadata.yaml
+output-overwrite = true
+</code></pre></div> <p><strong>input</strong></p> <p><span style=color:green> Example input directory contents listing: </span></p> <p><em>/home/user/git/evidence/xccdf/input</em></p> <div class=highlight><pre><span></span><code>-rw-rw-r--.<span class=w> </span><span class=m>1</span><span class=w> </span>user<span class=w> </span>user<span class=w>  </span><span class=m>3832</span><span class=w> </span>Feb<span class=w>  </span><span class=m>2</span><span class=w> </span><span class=m>09</span>:36<span class=w> </span>oscal-metadata.yaml
+-rw-rw-r--.<span class=w> </span><span class=m>1</span><span class=w> </span>user<span class=w> </span>user<span class=w> </span><span class=m>49132</span><span class=w> </span>Feb<span class=w>  </span><span class=m>2</span><span class=w> </span><span class=m>06</span>:12<span class=w> </span>ssg-ocp4-ds-cis-111.222.333.444-pod.yaml
+-rw-rw-r--.<span class=w> </span><span class=m>1</span><span class=w> </span>user<span class=w> </span>user<span class=w> </span><span class=m>52747</span><span class=w> </span>Feb<span class=w>  </span><span class=m>2</span><span class=w> </span><span class=m>06</span>:41<span class=w> </span>ssg-ocp4-ds-cis-111.222.333.555-pod.yaml
+</code></pre></div> <p><span style=color:green> Example input OSCO scan result file contents (snippet): </span></p> <p><em>ssg-ocp4-ds-cis-111.222.333.444-pod.yaml</em></p> <details> <summary>display sample</summary> <div class=highlight><pre><span></span><code><span class=nt>apiVersion</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">v1</span>
+<span class=nt>data</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>exit-code</span><span class=p>:</span><span class=w> </span><span class=s>&#39;2&#39;</span>
+<span class=w>  </span><span class=nt>results</span><span class=p>:</span><span class=w> </span><span class="p p-Indicator">|</span>
+<span class=w>    </span><span class=no>&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;</span>
+<span class=w>    </span><span class=no>&lt;TestResult xmlns=&quot;https://checklists.nist.gov/xccdf/1.2&quot; </span>
+<span class=w>                </span><span class=no>id=&quot;xccdf_org.open-scap_testresult_xccdf_org.ssgproject.content_profile_cis&quot;</span>
+<span class=w>                </span><span class=no>start-time=&quot;2020-08-03T02:26:26+00:00&quot; end-time=&quot;2020-08-03T02:26:26+00:00&quot;</span>
+<span class=w>                </span><span class=no>version=&quot;0.1.52&quot;</span>
+<span class=w>                </span><span class=no>test-system=&quot;cpe:/a:redhat:openscap:1.3.3&quot;&gt;</span>
+<span class=w>              </span><span class=no>&lt;benchmark href=&quot;/content/ssg-ocp4-ds.xml&quot; id=&quot;xccdf_org.ssgproject.content_benchmark_OCP-4&quot;/&gt;</span>
+<span class=w>              </span><span class=no>&lt;title&gt;OSCAP Scan Result&lt;/title&gt;</span>
+<span class=w>              </span><span class=no>&lt;profile idref=&quot;xccdf_org.ssgproject.content_profile_cis&quot;/&gt;</span>
+<span class=w>              </span><span class=no>&lt;target&gt;kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp&lt;/target&gt;</span>
+<span class=w>              </span><span class=no>&lt;target-facts&gt;</span>
+<span class=w>                </span><span class=no>&lt;fact name=&quot;urn:xccdf:fact:identifier&quot; type=&quot;string&quot;&gt;chroot:///host&lt;/fact&gt;</span>
+<span class=w>                </span><span class=no>&lt;fact name=&quot;urn:xccdf:fact:scanner:name&quot; type=&quot;string&quot;&gt;OpenSCAP&lt;/fact&gt;</span>
+<span class=w>                </span><span class=no>&lt;fact name=&quot;urn:xccdf:fact:scanner:version&quot; type=&quot;string&quot;&gt;1.3.3&lt;/fact&gt;</span>
+<span class=w>              </span><span class=no>&lt;/target-facts&gt;</span>
+<span class=w>              </span><span class=no>&lt;target-id-ref system=&quot;https://scap.nist.gov/schema/asset-identification/1.1&quot; name=&quot;asset0&quot; href=&quot;&quot;/&gt;</span>
+<span class=w>              </span><span class=no>&lt;platform idref=&quot;cpe:/a:redhat:openshift_container_platform:4.1&quot;/&gt;</span>
+<span class=w>              </span><span class=no>&lt;platform idref=&quot;cpe:/a:machine&quot;/&gt;</span>
+<span class=w>              </span><span class=no>&lt;set-value idref=&quot;xccdf_org.ssgproject.content_value_ocp_data_root&quot;&gt;/kubernetes-api-resources&lt;/set-value&gt;</span>
+<span class=w>              </span><span class=no>&lt;set-value idref=&quot;xccdf_org.ssgproject.content_value_var_kube_authorization_mode&quot;&gt;Webhook&lt;/set-value&gt;</span>
+<span class=w>              </span><span class=no>&lt;set-value idref=&quot;xccdf_org.ssgproject.content_value_var_streaming_connection_timeouts&quot;&gt;5m&lt;/set-value&gt;</span>
+<span class=w>              </span><span class=no>&lt;rule-result idref=&quot;xccdf_org.ssgproject.content_rule_ocp_idp_no_htpasswd&quot; time=&quot;2020-08-03T02:26:26+00:00&quot; severity=&quot;medium&quot; weight=&quot;1.000000&quot;&gt;</span>
+<span class=w>                </span><span class=no>&lt;result&gt;notselected&lt;/result&gt;</span>
+<span class=w>                </span><span class=no>&lt;ident system=&quot;https://nvd.nist.gov/cce/index.cfm&quot;&gt;CCE-84209-6&lt;/ident&gt;</span>
+<span class=w>              </span><span class=no>&lt;/rule-result&gt;</span>
+<span class=w>              </span><span class=no>&lt;rule-result idref=&quot;xccdf_org.ssgproject.content_rule_accounts_restrict_service_account_tokens&quot; time=&quot;2020-08-03T02:26:26+00:00&quot; severity=&quot;medium&quot; weight=&quot;1.000000&quot;&gt;</span>
+<span class=w>                </span><span class=no>&lt;result&gt;notchecked&lt;/result&gt;</span>
+<span class=w>                </span><span class=no>&lt;message severity=&quot;info&quot;&gt;No candidate or applicable check found.&lt;/message&gt;</span>
+<span class=w>              </span><span class=no>&lt;/rule-result&gt;</span>
+<span class=w>              </span><span class=no>&lt;rule-result idref=&quot;xccdf_org.ssgproject.content_rule_accounts_unique_service_account&quot; time=&quot;2020-08-03T02:26:26+00:00&quot; severity=&quot;medium&quot; weight=&quot;1.000000&quot;&gt;</span>
+<span class=w>                </span><span class=no>&lt;result&gt;notchecked&lt;/result&gt;</span>
+<span class=w>                </span><span class=no>&lt;message severity=&quot;info&quot;&gt;No candidate or applicable check found.&lt;/message&gt;</span>
+<span class=w>              </span><span class=no>&lt;/rule-result&gt;</span>
+
+<span class=w>              </span><span class=no>...</span>
+
+<span class=w>           </span><span class=no>&lt;/TestResult&gt;</span>
+<span class=nt>kind</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">ConfigMap</span>
+<span class=nt>metadata</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>annotations</span><span class=p>:</span>
+<span class=w>    </span><span class=nt>compliance-remediations/processed</span><span class=p>:</span><span class=w> </span><span class=s>&#39;&#39;</span>
+<span class=w>    </span><span class=nt>compliance.openshift.io/scan-error-msg</span><span class=p>:</span><span class=w> </span><span class=s>&#39;&#39;</span>
+<span class=w>    </span><span class=nt>compliance.openshift.io/scan-result</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">NON-COMPLIANT</span>
+<span class=w>    </span><span class=nt>openscap-scan-result/node</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">111.222.333.444</span>
+<span class=w>  </span><span class=nt>creationTimestamp</span><span class=p>:</span><span class=w> </span><span class=s>&#39;2020-08-03T02:26:34Z&#39;</span>
+<span class=w>  </span><span class=nt>labels</span><span class=p>:</span>
+<span class=w>    </span><span class=nt>compliance-scan</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">ssg-ocp4-ds-cis</span>
+<span class=w>  </span><span class=nt>name</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">ssg-ocp4-ds-cis-111.222.333.444-pod</span>
+<span class=w>  </span><span class=nt>namespace</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">openshift-compliance</span>
+<span class=w>  </span><span class=nt>resourceVersion</span><span class=p>:</span><span class=w> </span><span class=s>&#39;22693328&#39;</span>
+<span class=w>  </span><span class=nt>selfLink</span><span class=p>:</span><span class=w> </span>
+<span class=w>    </span><span class="l l-Scalar l-Scalar-Plain">/api/v1/namespaces/openshift-compliance/configmaps/ssg-ocp4-ds-cis-111.222.333.444-pod</span>
+<span class=w>  </span><span class=nt>uid</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">1da3ea81-0a25-4512-ad86-7ac360246b5d</span>
+</code></pre></div> </details> <p><br></p> <p><span style=color:green> Example input OSCAL metadata file contents: </span></p> <p><em>oscal-metadata.yaml</em></p> <details> <summary>display sample</summary> <div class=highlight><pre><span></span><code><span class=nt>ssg-ocp4-ds-cis-111.222.333.444-pod</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>locker</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">https://github.mycorp.com/degenaro/evidence-locker</span>
+<span class=w>  </span><span class=nt>namespace</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">xccdf</span>
+<span class=w>  </span><span class=nt>benchmark</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">CIS Kubernetes Benchmark</span>
+<span class=w>  </span><span class=nt>subject-references</span><span class=p>:</span>
+<span class=w>    </span><span class=nt>component</span><span class=p>:</span>
+<span class=w>      </span><span class=nt>uuid-ref</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">56666738-0f9a-4e38-9aac-c0fad00a5821</span>
+<span class=w>      </span><span class=nt>type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">component</span>
+<span class=w>      </span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">Red Hat OpenShift Kubernetes</span>
+<span class=w>    </span><span class=nt>inventory-item</span><span class=p>:</span>
+<span class=w>      </span><span class=nt>uuid-ref</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">46aADFAC-A1fd-4Cf0-a6aA-d1AfAb3e0d3e</span>
+<span class=w>      </span><span class=nt>type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">inventory-item</span>
+<span class=w>      </span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">Pod</span>
+<span class=w>      </span><span class=nt>properties</span><span class=p>:</span>
+<span class=w>        </span><span class=nt>target</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp</span>
+<span class=w>        </span><span class=nt>target-ip</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">111.222.333.444</span>
+<span class=w>        </span><span class=nt>cluster-name</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">ROKS-OpenSCAP-1</span>
+<span class=w>        </span><span class=nt>cluster-type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">openshift</span>
+<span class=w>        </span><span class=nt>cluster-region</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">us-south</span>
+
+<span class=nt>ssg-rhel7-ds-cis-111.222.333.444-pod</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>locker</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">https://github.mycorp.com/degenaro/evidence-locker</span>
+<span class=w>  </span><span class=nt>namespace</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">xccdf</span>
+<span class=w>  </span><span class=nt>benchmark</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">CIS Kubernetes Benchmark</span>
+<span class=w>  </span><span class=nt>subject-references</span><span class=p>:</span>
+<span class=w>    </span><span class=nt>component</span><span class=p>:</span>
+<span class=w>      </span><span class=nt>uuid-ref</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">89cfe7a7-ce6b-4699-aa7b-2f5739c72001</span>
+<span class=w>      </span><span class=nt>type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">component</span>
+<span class=w>      </span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">RedHat Enterprise Linux 7.8</span>
+<span class=w>    </span><span class=nt>inventory-item</span><span class=p>:</span>
+<span class=w>      </span><span class=nt>uuid-ref</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">46aADFAC-A1fd-4Cf0-a6aA-d1AfAb3e0d3e</span>
+<span class=w>      </span><span class=nt>type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">inventory-item</span>
+<span class=w>      </span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">VM</span>
+<span class=w>      </span><span class=nt>properties</span><span class=p>:</span>
+<span class=w>        </span><span class=nt>target</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp</span>
+<span class=w>        </span><span class=nt>target-ip</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">111.222.333.444</span>
+<span class=w>        </span><span class=nt>cluster-name</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">ROKS-OpenSCAP-1</span>
+<span class=w>        </span><span class=nt>cluster-type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">openshift</span>
+<span class=w>        </span><span class=nt>cluster-region</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">us-south</span>
+</code></pre></div> </details> <p><strong>metadata format</strong></p> <p>The <em>oscal-metadata.yaml</em> file comprises one or more mappings. Below is shown the format of a single mapping. The items in angle brackets are to be replaced with desired values for augmenting the produced OSCAL.</p> <p>The mapping whose <em>name</em> matches the <code>[metadata][name]</code> in the evidence for the corresponding embedded XML, if any, will be used for augmenting the produced OSCAL.</p> <div class=highlight><pre><span></span><code><span class=nt>name</span><span class=p>:</span>
+<span class=w>  </span><span class=nt>locker</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;locker&gt;</span>
+<span class=w>  </span><span class=nt>namespace</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;namespace&gt;</span>
+<span class=w>  </span><span class=nt>benchmark</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;benchmark&gt;</span>
+<span class=w>  </span><span class=nt>subject-references</span><span class=p>:</span>
+<span class=w>    </span><span class=nt>component</span><span class=p>:</span>
+<span class=w>      </span><span class=nt>uuid-ref</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;uuid-ref-component&gt;</span>
+<span class=w>      </span><span class=nt>type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;component-type&gt;</span>
+<span class=w>      </span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;component-title&gt;</span>
+<span class=w>    </span><span class=nt>inventory-item</span><span class=p>:</span>
+<span class=w>      </span><span class=nt>uuid-ref</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;uuid-ref-inventory-item&gt;</span>
+<span class=w>      </span><span class=nt>type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;inventory-item-type&gt;</span>
+<span class=w>      </span><span class=nt>title</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;inventory-item-title&gt;</span>
+<span class=w>      </span><span class=nt>properties</span><span class=p>:</span>
+<span class=w>        </span><span class=nt>target</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;target&gt;</span>
+<span class=w>        </span><span class=nt>cluster-name</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;cluster-name&gt;</span>
+<span class=w>        </span><span class=nt>cluster-type</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;cluster-type&gt;</span>
+<span class=w>        </span><span class=nt>cluster-region</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">&lt;cluster-region&gt;</span>
+</code></pre></div> <p><strong>output</strong></p> <p><span style=color:green> Example output directory contents listing: </span></p> <p><em>/home/user/git/evidence/oscal/output</em></p> <div class=highlight><pre><span></span><code>-rw-rw-r--.<span class=w> </span><span class=m>1</span><span class=w> </span>user<span class=w> </span>user<span class=w> </span><span class=m>49132</span><span class=w> </span>Feb<span class=w>  </span><span class=m>3</span><span class=w> </span><span class=m>10</span>:59<span class=w> </span>ssg-ocp4-ds-cis-111.222.333.444-pod.json
+-rw-rw-r--.<span class=w> </span><span class=m>1</span><span class=w> </span>user<span class=w> </span>user<span class=w> </span><span class=m>52747</span><span class=w> </span>Feb<span class=w>  </span><span class=m>3</span><span class=w> </span><span class=m>10</span>:59<span class=w> </span>ssg-ocp4-ds-cis-111.222.333.555-pod.json
+</code></pre></div> <p><span style=color:green> Example output OSCAL Observations file contents (snippet): </span></p> <p><em>ssg-ocp4-ds-cis-111.222.333.444-pod.json</em></p> <details> <summary>display sample</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;observations&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;56666738-0f9a-4e38-9aac-c0fad00a5821&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.ssgproject.content_rule_ocp_idp_no_htpasswd&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.ssgproject.content_rule_ocp_idp_no_htpasswd&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;benchmark&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://osco&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Kubernetes Benchmark&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>],</span>
+<span class=w>      </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>      </span><span class=p>],</span>
+<span class=w>      </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;56666738-0f9a-4e38-9aac-c0fad00a5821&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;component&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Red Hat OpenShift Kubernetes&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;46aADFAC-A1fd-4Cf0-a6aA-d1AfAb3e0d3e&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Pod&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;target&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://osco&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;kube-br7qsa3d0vceu2so1a90-roksopensca-default-0000026b.iks.mycorp&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;target-ip&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://osco&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;111.222.333.444&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cluster-name&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://osco&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;ROKS-OpenSCAP-1&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cluster-type&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://osco&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;openshift&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cluster-region&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://osco&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;us-south&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>]</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>],</span>
+<span class=w>      </span><span class=nt>&quot;relevant-evidence&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;href&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;https://github.mycorp.com/degenaro/evidence-locker&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Evidence location.&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;id&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.ssgproject.content_rule_ocp_idp_no_htpasswd&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;time&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;timestamp&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2020-08-03T02:26:26+00:00&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;notselected&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>]</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>]</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> </details> <h2 id=trestle-task-tanium-result-to-oscal-ar><code>trestle task tanium-result-to-oscal-ar</code><a class=headerlink href=#trestle-task-tanium-result-to-oscal-ar title="Permanent link">¤</a></h2> <p>The <em>trestle task tanium-result-to-oscal-ar</em> command facilitates transformation of Tanuim reports, each input file comprising individual lines consumable as <em>json</em>, into OSCAL partial results <em>.json</em> files. Specify required config parameters to indicate the location of the input and the output. Specify optional config parameter <em>output-overwrite</em> to indicate whether overwriting of existing output is permitted. Specify optional config parameter <em>timestamp</em> as ISO 8601 formated string (e.g., 2021-02-24T19:31:13+00:00) to override the timestamp attached to each Observation.</p> <p><span style=color:green> Example command invocation: </span></p> <p><code>$TRESTLE_BASEDIR$ trestle task tanium-result-to-oscal-ar -c /home/user/task.config</code></p> <p><span style=color:green> Example config: </span></p> <p><em>/home/user/task.config</em></p> <div class=highlight><pre><span></span><code>[task.tanium-result-to-oscal-ar]
+
+input-dir =  /home/user/git/compliance/tanium/input
+output-dir = /home/user/git/compliance/oscal/output
+output-overwrite = true
+</code></pre></div> <p><strong>input</strong></p> <p><span style=color:green> Example input directory contents listing: </span></p> <p><em>/home/user/git/compliance/tanium/input</em></p> <div class=highlight><pre><span></span><code>-rw-rw-r--.<span class=w> </span><span class=m>1</span><span class=w> </span>degenaro<span class=w> </span>degenaro<span class=w> </span><span class=m>1830</span><span class=w> </span>Mar<span class=w>  </span><span class=m>7</span><span class=w> </span><span class=m>08</span>:23<span class=w> </span>Tanium.comply-nist-results
+</code></pre></div> <p><em>Tanium.comply-nist-results</em></p> <details> <summary>display sample</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;IP Address&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fe80::3cd5:564b:940e:49ab&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Computer Name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cmp-wn-2106.demo.tanium.local&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Comply - JovalCM Results[c2dc8749]&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.5.0.1&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Profile&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10 - NIST 800-53&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Result&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Custom ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;version: 1&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;Count&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Age&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;600&quot;</span>
+<span class=p>}</span>
+</code></pre></div> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;IP Address&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;10.8.69.11&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Computer Name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Comply - JovalCM Results[c2dc8749]&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.5.0.1&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Profile&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10 - NIST 800-53&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.2_L1_Ensure_Maximum_password_age_is_set_to_60_or_fewer_days_but_not_0&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Result&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Custom ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;version: 1&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;Count&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Age&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;600&quot;</span>
+<span class=p>}</span>
+</code></pre></div> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;IP Address&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;10.8.69.11&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Computer Name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cmp-wn-2106.demo.tanium.local&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Comply - JovalCM Results[c2dc8749]&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.5.0.1&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Profile&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10 - NIST 800-53&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.3_L1_Ensure_Minimum_password_age_is_set_to_1_or_more_days&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Result&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Custom ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;version: 1&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;Count&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Age&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;600&quot;</span>
+<span class=p>}</span>
+</code></pre></div> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;IP Address&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;10.8.69.11&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Computer Name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cmp-wn-2106.demo.tanium.local&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Comply - JovalCM Results[c2dc8749]&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Benchmark Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1.5.0.1&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Profile&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10 - NIST 800-53&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.4_L1_Ensure_Minimum_password_length_is_set_to_14_or_more_characters&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Result&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Custom ID&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;Version&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;version: 1&quot;</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>],</span>
+<span class=w>  </span><span class=nt>&quot;Count&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;1&quot;</span><span class=p>,</span>
+<span class=w>  </span><span class=nt>&quot;Age&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;600&quot;</span>
+<span class=p>}</span>
+</code></pre></div> </details> <p><strong>output</strong></p> <p><span style=color:green> Example output directory contents listing: </span></p> <p><em>/home/user/git/compliance/oscal/output</em></p> <div class=highlight><pre><span></span><code>-rw-rw-r--.<span class=w> </span><span class=m>1</span><span class=w> </span>degenaro<span class=w> </span>degenaro<span class=w> </span><span class=m>6479</span><span class=w> </span>Mar<span class=w>  </span><span class=m>7</span><span class=w> </span><span class=m>08</span>:25<span class=w> </span>Tanium.oscal.json
+</code></pre></div> <p><em>Tanium.oscal.json</em></p> <details> <summary>display sample</summary> <div class=highlight><pre><span></span><code><span class=p>{</span>
+<span class=w>  </span><span class=nt>&quot;results&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>    </span><span class=p>{</span>
+<span class=w>      </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;0ed0791e-5454-4d07-919f-15a0d806a5a8&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Tanium&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;start&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-04-13T00:16:20.000+00:00&quot;</span><span class=p>,</span>
+<span class=w>      </span><span class=nt>&quot;local-definitions&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;inventory-items&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;da8b87f6-2068-415f-94bb-e14e31b4f5c2&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;computer-name&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;cmp-wn-2106.demo.tanium.local&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot; inventory-item&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;computer-ip&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fe80::3cd5:564b:940e:49ab&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot; inventory-item&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;profile&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot; inventory-item&quot;</span>
+<span class=w>              </span><span class=p>}</span>
+<span class=w>            </span><span class=p>]</span>
+<span class=w>          </span><span class=p>},</span>
+<span class=w>          </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;f3ab87b2-70c1-4332-991e-c003d4314c0b&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;computer-name&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot; inventory-item&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;computer-ip&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;10.8.69.11&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot; inventory-item&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;profile&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;Windows 10&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot; inventory-item&quot;</span>
+<span class=w>              </span><span class=p>}</span>
+<span class=w>            </span><span class=p>]</span>
+<span class=w>          </span><span class=p>}</span>
+<span class=w>        </span><span class=p>]</span>
+<span class=w>      </span><span class=p>},</span>
+<span class=w>      </span><span class=nt>&quot;reviewed-controls&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>        </span><span class=nt>&quot;control-selections&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>          </span><span class=p>{}</span>
+<span class=w>        </span><span class=p>]</span>
+<span class=w>      </span><span class=p>},</span>
+<span class=w>      </span><span class=nt>&quot;observations&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;b3250b66-fe6f-4ac0-be99-cb4ff093dc31&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.1_L1_Ensure_Enforce_password_history_is_set_to_24_or_more_passwords&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;da8b87f6-2068-415f-94bb-e14e31b4f5c2&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-04-13T00:16:20.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;5ae9c133-c32d-44c5-b52e-5af4513cb94a&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.2_L1_Ensure_Maximum_password_age_is_set_to_60_or_fewer_days_but_not_0&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.2_L1_Ensure_Maximum_password_age_is_set_to_60_or_fewer_days_but_not_0&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;f3ab87b2-70c1-4332-991e-c003d4314c0b&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-04-13T00:16:20.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;8d021edc-176e-4373-a3c4-a19e954c1e4d&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.3_L1_Ensure_Minimum_password_age_is_set_to_1_or_more_days&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.3_L1_Ensure_Minimum_password_age_is_set_to_1_or_more_days&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;fail&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;f3ab87b2-70c1-4332-991e-c003d4314c0b&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-04-13T00:16:20.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>},</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;36aa7551-d047-4f4a-9853-6ac63cfc9e48&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.4_L1_Ensure_Minimum_password_length_is_set_to_14_or_more_characters&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;CIS Microsoft Windows 10 Enterprise Release 1803 Benchmark&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;rule&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;xccdf_org.cisecurity.benchmarks_rule_1.1.4_L1_Ensure_Minimum_password_length_is_set_to_14_or_more_characters&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;id&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;pass&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;methods&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=s2>&quot;TEST-AUTOMATED&quot;</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;subjects&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;uuid-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;f3ab87b2-70c1-4332-991e-c003d4314c0b&quot;</span><span class=p>,</span>
+<span class=w>              </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;inventory-item&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>],</span>
+<span class=w>          </span><span class=nt>&quot;collected&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;2021-04-13T00:16:20.000+00:00&quot;</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>],</span>
+<span class=w>      </span><span class=nt>&quot;findings&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>        </span><span class=p>{</span>
+<span class=w>          </span><span class=nt>&quot;uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;ba4e264f-0aee-4ead-9ee3-6161c5cc4ecb&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;title&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;description&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>          </span><span class=nt>&quot;target&quot;</span><span class=p>:</span><span class=w> </span><span class=p>{</span>
+<span class=w>            </span><span class=nt>&quot;type&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;objective-id&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;id-ref&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>            </span><span class=nt>&quot;props&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;profile&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;NIST 800-53&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;id-ref&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://tanium&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;800-53: IA-5&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;source&quot;</span>
+<span class=w>              </span><span class=p>},</span>
+<span class=w>              </span><span class=p>{</span>
+<span class=w>                </span><span class=nt>&quot;name&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;result&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;ns&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;dns://xccdf&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;value&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;FAIL&quot;</span><span class=p>,</span>
+<span class=w>                </span><span class=nt>&quot;class&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;STRVALUE&quot;</span>
+<span class=w>              </span><span class=p>}</span>
+<span class=w>            </span><span class=p>],</span>
+<span class=w>            </span><span class=nt>&quot;status&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;not-satisfied&quot;</span>
+<span class=w>          </span><span class=p>},</span>
+<span class=w>          </span><span class=nt>&quot;related-observations&quot;</span><span class=p>:</span><span class=w> </span><span class=p>[</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;observation-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;b3250b66-fe6f-4ac0-be99-cb4ff093dc31&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;observation-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;5ae9c133-c32d-44c5-b52e-5af4513cb94a&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;observation-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;8d021edc-176e-4373-a3c4-a19e954c1e4d&quot;</span>
+<span class=w>            </span><span class=p>},</span>
+<span class=w>            </span><span class=p>{</span>
+<span class=w>              </span><span class=nt>&quot;observation-uuid&quot;</span><span class=p>:</span><span class=w> </span><span class=s2>&quot;36aa7551-d047-4f4a-9853-6ac63cfc9e48&quot;</span>
+<span class=w>            </span><span class=p>}</span>
+<span class=w>          </span><span class=p>]</span>
+<span class=w>        </span><span class=p>}</span>
+<span class=w>      </span><span class=p>]</span>
+<span class=w>    </span><span class=p>}</span>
+<span class=w>  </span><span class=p>]</span>
+<span class=p>}</span>
+</code></pre></div> </details> <h2 id=trestle-task-xlsx-to-oscal-cd><code>trestle task xlsx-to-oscal-cd</code><a class=headerlink href=#trestle-task-xlsx-to-oscal-cd title="Permanent link">¤</a></h2> <p>The <em>trestle task xlsx-to-oscal-cd</em> command facilitates transformation of an excel spreadsheet into an OSCAL component-definition.json file. Specify in the config:</p> <ul> <li> location of catalog file <li> location of spreadsheet file <li> work sheet name in the spreadsheet file <li> output directory to write the component-definition.json file <li> whether or not to overwrite an existing component-definition.json file <li> the organization name <li> the organization remarks <li> the namespace <li> comma separated mappings from name to class <li> the catalog URL <li> the catalog title </ul> <p><span style=color:green> Example command invocation: </span></p> <p><code>$TRESTLE_BASEDIR$ trestle task xlsx-to-oscal-cd -c /home/user/task-xlsx-to-oscal-cd.config</code></p> <p><span style=color:green> Example config: </span></p> <p><em>/home/user/task-xlsx-to-oscal-cd.config</em></p> <div class=highlight><pre><span></span><code>[task.xlsx-to-oscal-cd]
+
+catalog-file = nist-content/nist.gov/SP800-53/rev4/json/NIST_SP-800-53_rev4_catalog.json
+spread-sheet-file = /home/user/compliance/data/spread-sheet/good.xlsx
+work-sheet-name = example_best_practices_controls
+output-dir = /home/user/compliance/data/tasks/xlsx/output
+output-overwrite = true
+
+org-name = International Business Machines
+org-remarks = IBM
+namespace = https://oscal-compass.github.io/compliance-trestle/schemas/oscal/cd/ibm-cloud
+property-name-to-class = goal_name_id:scc_goal_name_id, goal_version:scc_goal_version
+catalog-url = https://github.com/usnistgov/oscal-content/blob/master/nist.gov/SP800-53/rev4/json/NIST_SP-800-53_rev4_catalog.json
+catalog-title = NIST Special Publication 800-53 Revision 4
+</code></pre></div> <p><strong>catalog-file</strong></p> <p><span style=color:green> Example catalog-file: </span></p> <p><a href=https://github.com/usnistgov/oscal-content/blob/58af5c83ad7ab5620809c5701877a4b959516d25/nist.gov/SP800-53/rev4/json/NIST_SP-800-53_rev4_catalog.json>nist-content/nist.gov/SP800-53/rev4/json/NIST_SP-800-53_rev4_catalog.json</a></p> <p><strong>spread-sheet-file</strong></p> <p><span style=color:green> Example spread-sheet-file: </span></p> <p><a href=https://github.com/oscal-compass/compliance-trestle/tree/main/tests/data/spread-sheet/good.xlsx>/home/user/compliance/data/spread-sheet/good.xlsx</a></p> <p><strong>output</strong></p> <p><span style=color:green> Example component-definition.json: </span></p> <p><a href=https://github.com/oscal-compass/compliance-trestle/tree/main/tests/data/tasks/xlsx/output/component-definition.json>/home/user/compliance/data/tasks/xlsx/output/component-definition.json</a></p> <h3 id=spreadsheet-to-component-definition-mapping>spreadsheet to component definition mapping<a class=headerlink href=#spreadsheet-to-component-definition-mapping title="Permanent link">¤</a></h3> <details> <summary>display mapping table</summary> <style>
+table, th, td {
+  border: 1px solid black;
+  border-collapse: collapse;
+}
+th, td {
+  padding: 5px;
+}
+</style> <table> <tr> <th>spreadsheet column name <th>component definition path <th>comments <tr> <td>ControlId <td><ul> <li>implemented_requirement.property[name='goal_name_id'].value </ul> <td><ul> <li>only used if column 'goal_name_id' is empty </ul> <tr> <td>ControlText <td><ul> <li>implemented_requirement.property[name='goal_name_id'].remarks </ul> <td><ul> <li>transformation code replaces "Check whether" with "Ensure" in text </ul> <tr> <td>Nist Mappings <td><ul> <li>implemented_requirement.description </ul> <td><ul> <li>heading may span multiple columns <li>one value expected per column <li>each entry is separated into control + statements (if any) </ul> <tr> <td>ResourceTitle <td><ul> <li>component.title <li>component.description <li>component.control-implementation.description + {text} </ul> <td><ul> </ul> <tr> <td>goal_name_id <td><ul> <li>implemented_requirement.property[name='goal_name_id'].value </ul> <td><ul> </ul> <tr> <td>Version <td><ul> <li>implemented_requirement.property[name='goal_version'].value </ul> <td><ul> <li>Value from spreadsheet is not currently used. <li>Value '1.0' is hard coded. </ul> <tr> <td>Parameter [optional parameter] <td><ul> <li>implemented_requirement.set_parameter.param_id </ul> <td><ul> <li>The expected text is in two parts separated by '\n'. <li>The text following the '\n' is the value used. </ul> <tr> <td>Values [alternatives] <td><ul> <li>implemented_requirement.set_parameter.values </ul> <td><ul> <li>The expected text is of the following format: <li>v0, [v1, v2...] <li>The value v0 is used. </ul> </td> </td> </td> </tr> </td> </td> </td> </tr> </td> </td> </td> </tr> </td> </td> </td> </tr> </td> </td> </td> </tr> </td> </td> </td> </tr> </td> </td> </td> </tr> </td> </td> </td> </tr> </th> </th> </th> </tr> </table> </details> <h2 id=trestle-task-xlsx-to-oscal-profile><code>trestle task xlsx-to-oscal-profile</code><a class=headerlink href=#trestle-task-xlsx-to-oscal-profile title="Permanent link">¤</a></h2> <p>The <em>trestle task xlsx-to-oscal-profile</em> command facilitates transformation of an excel spreadsheet into an OSCAL profile.json file. Specify in the config:</p> <ul> <li> the href URL of the spreadsheet <li> file system location of spreadsheet file <li> work sheet name in the spreadsheet file <li> output directory to write the profile.json file <li> whether or not to overwrite an existing profile.json file <li> the profile title </ul> <p><span style=color:green> Example command invocation: </span></p> <p><code>$TRESTLE_BASEDIR$ trestle task xlsx-to-oscal-profile -c /home/user/task-xlsx-to-oscal-profile.config</code></p> <p><span style=color:green> Example config: </span></p> <p><em>/home/user/task-xlsx-to-oscal-profile.config</em></p> <div class=highlight><pre><span></span><code>[task.xlsx-to-oscal-profile]
+
+spread-sheet-url = https://github.mycorp.com/spread-sheets/good.xlsx
+spread-sheet-file = /home/user/compliance/data/spread-sheet/good.xlsx
+work-sheet-name = example_best_practices_controls
+output-dir = /home/user/compliance/data/tasks/xlsx/output
+output-overwrite = true
+
+profile-title = IBM Best Practices SCC GOALS
+</code></pre></div> <p><strong>spread-sheet-file</strong></p> <p><span style=color:green> Example spread-sheet-file: </span></p> <p><a href=https://github.com/oscal-compass/compliance-trestle/tree/main/tests/data/spread-sheet/good.xlsx>/home/user/compliance/data/spread-sheet/good.xlsx</a></p> <p><strong>output</strong></p> <p><span style=color:green> Example profile.json: </span></p> <p><a href=https://github.com/oscal-compass/compliance-trestle/tree/main/tests/data/tasks/xlsx/output/profile.json>/home/user/compliance/data/tasks/xlsx/output/profile.json</a></p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">September 11, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/compliance_posture/ContinuousCompliance.drawio b/latest/tutorials/compliance_posture/ContinuousCompliance.drawio
new file mode 100644
index 000000000..9b00a8e93
--- /dev/null
+++ b/latest/tutorials/compliance_posture/ContinuousCompliance.drawio
@@ -0,0 +1 @@
+<mxfile host="Electron" modified="2021-03-25T13:59:51.649Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/13.9.9 Chrome/85.0.4183.121 Electron/10.1.5 Safari/537.36" etag="3o0jrN5YX1PCQ8ZisUjC" version="13.9.9" type="device"><diagram id="OWs6azfwRi4c3axYXint" name="Page-1">7Zpdc9o4FIZ/DZdh/I19GShsZ5tMOqUzm/RmR9jCaCtbriwH6K9fyZY/RVJIAJO0yQXWsSSs9+g50pEZmJNo8xcFyeqWBBAPDC3YDMwPA8PQdc3gH8KyLSwj0yoMIUWBrFQb5ugnlEZNWjMUwLRVkRGCGUraRp/EMfRZywYoJet2tSXB7W9NQAgVw9wHWLX+gwK2KqyurdX2jxCFK1YNWN6JQFlZGtIVCMi6YTKnA3NCCWHFVbSZQCzEK3Up2s2euFs9GIUx26eBFfx99+3f2+hTdr+Zfrr1r7xreqVrsp+Ubcshw4ArIIuEshUJSQzwtLaOKcniAIp+NV6q69wQknCjzo3/Qca20p0gY4SbVizC8i7cIHYvmg9tWXqQnYnrD5tmYVsWYka392UHovBQ9yCKdbO8VLZLGSXf4YRgQvPxmZo2ms24SuNi5GK4T0paqkMy6sNndHSlkxmgIWTPVPScyvWcGUgiyJ+VN6QQA4Ye208C5OQNq3q1f/mFdPEB7i4f8xHgTH6V4v62c9crxOA8Afno15zxtiNld5AyuHleRHXIsoFTsrStECrK6wZv0rRqoFY2O7pIhqLRBJMsGBgO5l89XlB+FYqrOaSPiAujAIQxD08CFM58Iox+3sE51DTaYo5ULb0dWnqn0tIe9Rle9GZwqULNE+GFFz5Divi4Ie2GHO2VIWc20/jfcUOO7uwZcky3z5BTPmYTJxIlGIFYoNNlKgAMqFb++SMTC+WYgnVdUOZWxdsWIz6FqPlr5hbFZLtZVAbgfw/zKXiXMd4NlPa0mG26fRxQdbNNqmfwadVldWSrrLr2qVj1/rB6ou1Buen9JauW0Ser5WO+itW7+eT65i2TadoXR6b7Zsh8IYV5qYv0edB0911GrV7RdBU0GbmSrHUR/EpBnC4JjbiUr9reLxHGDf0DG7qBtcszrrEwHedIW1jzwhKC6hDj/fJ3FtQsY0/UPK9P1MrH3HMV/AIT7tw3SZp1aam37fQJmjZ0R/YhsB1xG7rfAniKPNLaN4/Uez26snbkkW/2WMbr+VjGGr0jMXdFrfOqqe7NHkimSFYKlUX42mcC6bGQAfk8VIEFxJ9JihgiMa+yIIyRqFHhGqNQ3GCkIycpMqFJ9fpDO47Go+7SoKk5kLlDZOdUIju2IrKicEJQzKPn9JEPMpUCVa9dtDxjTVfVStFQsR1oYyJSy+6SbGvin9txx1k+jPOQ/VJv7nQhkFWqzsvZE21C8aZtSJZLzuUwgALPdIhBUvR2BN87jt4BzFF8X6akTd+Xxwcn2IBriq/PuS940Qa8XvIfmvcuLgH29j5H7jUB9g47R+Y0LVGYUZAz+FQoDoifRbliBx9GHYEzuxNjrd7zXLNPzN5Nnut5exLlarvnx5mI8g4iii9oLKPqTvAyWeo9la0e4Hc4sbO64qsbhjOLr/8+4ndnvjHa8b7iSPLzYv2Lpfxe43df5vR/</diagram></mxfile>
\ No newline at end of file
diff --git a/latest/tutorials/compliance_posture/ContinuousCompliance.jpg b/latest/tutorials/compliance_posture/ContinuousCompliance.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..1d702b7928cd8c6ca80a3be38c8bb3b62eb5945b
GIT binary patch
literal 25984
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

literal 0
HcmV?d00001

diff --git a/latest/tutorials/compliance_posture/index.html b/latest/tutorials/compliance_posture/index.html
new file mode 100644
index 000000000..c61bd0210
--- /dev/null
+++ b/latest/tutorials/compliance_posture/index.html
@@ -0,0 +1 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="High level tutorial on measuring your compliance posture with compliance-trestle"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/compliance_posture/ rel=canonical><link href=../cli/ rel=prev><link href=../introduction_to_trestle/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>What's your compliance posture - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="What's your compliance posture - Compliance Trestle"><meta property=og:description content="High level tutorial on measuring your compliance posture with compliance-trestle"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/compliance_posture.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/compliance_posture/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="What's your compliance posture - Compliance Trestle"><meta name=twitter:description content="High level tutorial on measuring your compliance posture with compliance-trestle"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/compliance_posture.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#tutorial-whats-your-compliance-posture class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> What's your compliance posture </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> What's your compliance posture </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> What's your compliance posture </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#introduction class=md-nav__link> <span class=md-ellipsis> Introduction </span> </a> </li> <li class=md-nav__item> <a href=#simple-continuous-compliance-architecture class=md-nav__link> <span class=md-ellipsis> Simple Continuous Compliance Architecture </span> </a> </li> <li class=md-nav__item> <a href=#step-1-transformation class=md-nav__link> <span class=md-ellipsis> Step 1 – Transformation </span> </a> </li> <li class=md-nav__item> <a href=#step-2-reporting class=md-nav__link> <span class=md-ellipsis> Step 2 – Reporting </span> </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../introduction_to_trestle/ class=md-nav__link> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#introduction class=md-nav__link> <span class=md-ellipsis> Introduction </span> </a> </li> <li class=md-nav__item> <a href=#simple-continuous-compliance-architecture class=md-nav__link> <span class=md-ellipsis> Simple Continuous Compliance Architecture </span> </a> </li> <li class=md-nav__item> <a href=#step-1-transformation class=md-nav__link> <span class=md-ellipsis> Step 1 – Transformation </span> </a> </li> <li class=md-nav__item> <a href=#step-2-reporting class=md-nav__link> <span class=md-ellipsis> Step 2 – Reporting </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=tutorial-whats-your-compliance-posture>Tutorial: What’s your compliance posture?<a class=headerlink href=#tutorial-whats-your-compliance-posture title="Permanent link">¤</a></h1> <h4 id=introduction>Introduction<a class=headerlink href=#introduction title="Permanent link">¤</a></h4> <p>The cloud with its continuous integration and continuous deployment is the modern computing paradigm. There is a plethora of cloud environments: public, private, on-premise, hybrid-cloud, multi-cloud, etc. along with a corresponding contingent of vendors. The cloud offers great flexibility where you can choose just one or some combination optimal for each application. But, as demonstrated from time to time, the cloud can be a dangerous place. Hackers, bots, malware, and more are constant threats seeking to find and exploit weakness in your computing solution. To combat them there are strategies to avoid embarrassment and financial ruin from security breeches. Educating your workforce is of paramount importance. Moreover, employing a trust-but-verify strategy will go a long way toward deflecting trouble.</p> <p>The time has come for continuous auditing, and giving stakeholders (such as account owners, application owners, system owners and compliance officers) a current picture of their compliance posture:</p> <ul> <li>Are password rules being followed?</li> <li>Are deployed applications using compromised encryption algorithms?</li> <li>Has a user gotten elevated privileges?</li> <li>Are unauthorized open source projects wrongfully part of your application stack?</li> </ul> <p>Getting answers to these questions only quarterly or annually is leaving you exposed.</p> <p>Moreover, assuring continuous compliance across multiple cloud vendors can complicate matters. If each has its own compliance regime, then one must become expert in each domain’s compliance solution space, or else be wedded to a single or few providers. That is not an ideal prospect.</p> <p>Common sense dictates that standardization would simplify matters. The National Institute of Standards and Technologies (NIST) is developing the Open Security Controls Assessment Language (<a href=https://pages.nist.gov/OSCAL>OSCAL</a>).</p> <p>The compliance-<a href=../../ >trestle</a> open source github project is an effort to employ <a href=https://pages.nist.gov/OSCAL>OSCAL</a> for compliance standardization and automation. Of great utility is the <a href=../../ >trestle</a> oscal module that facilitates transformation of data to/from Python object representations in accordance with the <a href=https://pages.nist.gov/OSCAL>OSCAL</a> schemas.</p> <h4 id=simple-continuous-compliance-architecture>Simple Continuous Compliance Architecture<a class=headerlink href=#simple-continuous-compliance-architecture title="Permanent link">¤</a></h4> <p><img alt="Continuous Compliance Reporting" src=ContinuousCompliance.jpg></p> <p>Cloud Services can often be configured to monitor (and sometimes enforce) policies. Examples include OpenShift Compliance Operator and Tanium. However, the compliance reporting “raw” data produced is unique to each.</p> <p>Two steps are needed to ascertain your compliance posture. Step 1 is to transform available compliance “raw” data into standardized form (<a href=https://pages.nist.gov/OSCAL>OSCAL</a>). Step 2 is to examine the <a href=https://pages.nist.gov/OSCAL>OSCAL</a> data and assemble a compliance posture for the controls and components of interest. And <a href=../../ >trestle</a> is the go-to solution.</p> <h4 id=step-1-transformation>Step 1 – Transformation<a class=headerlink href=#step-1-transformation title="Permanent link">¤</a></h4> <p>The bad news is that a transformer to <a href=https://pages.nist.gov/OSCAL>OSCAL</a> is needed for each Cloud Service type.</p> <p>However, there is plenty of good news:</p> <ul> <li>a transformer for your Cloud Service type may already exist, such as: <a href=https://github.com/oscal-compass/compliance-trestle/blob/main/trestle/tasks/tanium_result_to_oscal_ar.py>Tanium to OSCAL</a>, <a href=https://github.com/oscal-compass/compliance-trestle/blob/main/trestle/tasks/xccdf_result_to_oscal_ar.py>OpenShift Compliance Operator to OSCAL</a></li> <li>once a transformer for a Cloud Service type has been written, it can be open-sourced/re-used</li> <li>writing a transformer is fairly easy: just a few lines of Python code using <a href=../../ >trestle</a> as a foundation</li> </ul> <p>In the case of Tanium, the <a href=https://pages.nist.gov/OSCAL>OSCAL</a> compliance data document is a <em>System Assessment Results</em> fragment with <em>Findings</em> and <em>Observations</em>, while in the case of OpenShift Compliance Operator there are <em>Observations</em> only.</p> <p>Tutorials are available to show you: how to <a href=../Transformers_and_Tasks/Tanium_result_to_oscal_ar/ >run a transformer</a>, how to <a href=../Transformers_and_Tasks/transformer_construction/ >write a transformer</a>.</p> <h4 id=step-2-reporting>Step 2 – Reporting<a class=headerlink href=#step-2-reporting title="Permanent link">¤</a></h4> <p>Coming soon is a <a href=../../ >trestle</a> tool to assemble the <a href=https://pages.nist.gov/OSCAL>OSCAL</a> fragments documents together using <a href=https://pages.nist.gov/OSCAL>OSCAL</a> compliance configuration data (<em>System Assessment Plan</em> and <em>System Security Plan</em>) into a complete <em>System Assessment Results</em>.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">September 11, 2024</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/latest/tutorials/introduction_to_trestle/index.html b/latest/tutorials/introduction_to_trestle/index.html
new file mode 100644
index 000000000..a63536c75
--- /dev/null
+++ b/latest/tutorials/introduction_to_trestle/index.html
@@ -0,0 +1,499 @@
+<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Introductory Tutorial to trestle workflows for managing OSCAL objects as code"><link href=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/introduction_to_trestle/ rel=canonical><link href=../compliance_posture/ rel=prev><link href=../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.47"><title>Introduction to trestle workflows - Compliance Trestle</title><link rel=stylesheet href=../../assets/stylesheets/main.6f8fc17f.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><link rel=stylesheet href=../../assets/_mkdocstrings.css><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script><script id=__analytics>function __md_analytics(){function e(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],e("js",new Date),e("config","G-XT3KGMHSY8"),document.addEventListener("DOMContentLoaded",(function(){document.forms.search&&document.forms.search.query.addEventListener("blur",(function(){this.value&&e("event","search",{search_term:this.value})}));document$.subscribe((function(){var t=document.forms.feedback;if(void 0!==t)for(var a of t.querySelectorAll("[type=submit]"))a.addEventListener("click",(function(a){a.preventDefault();var n=document.location.pathname,d=this.getAttribute("data-md-value");e("event","feedback",{page:n,data:d}),t.firstElementChild.disabled=!0;var r=t.querySelector(".md-feedback__note [data-md-value='"+d+"']");r&&(r.hidden=!1)})),t.hidden=!1})),location$.subscribe((function(t){e("config","G-XT3KGMHSY8",{page_path:t.pathname})}))}));var t=document.createElement("script");t.async=!0,t.src="https://www.googletagmanager.com/gtag/js?id=G-XT3KGMHSY8",document.getElementById("__analytics").insertAdjacentElement("afterEnd",t)}</script><script>if("undefined"!=typeof __md_analytics){var consent=__md_get("__consent");consent&&consent.analytics&&__md_analytics()}</script><meta property=og:type content=website><meta property=og:title content="Introduction to trestle workflows - Compliance Trestle"><meta property=og:description content="Introductory Tutorial to trestle workflows for managing OSCAL objects as code"><meta property=og:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/introduction_to_trestle.png><meta property=og:image:type content=image/png><meta property=og:image:width content=1200><meta property=og:image:height content=630><meta content=https://oscal-compass.github.io/compliance-trestle/latest/tutorials/introduction_to_trestle/ property=og:url><meta name=twitter:card content=summary_large_image><meta name=twitter:title content="Introduction to trestle workflows - Compliance Trestle"><meta name=twitter:description content="Introductory Tutorial to trestle workflows for managing OSCAL objects as code"><meta name=twitter:image content=https://oscal-compass.github.io/compliance-trestle/latest/assets/images/social/tutorials/introduction_to_trestle.png></head> <body dir=ltr data-md-color-scheme=slate data-md-color-primary=black data-md-color-accent=purple> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#tutorial-introduction-to-trestle-workflow class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class=md-header data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title="Compliance Trestle" class="md-header__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> Compliance Trestle </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> Introduction to trestle workflows </span> </div> </div> </div> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap tabindex=0 data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <nav class=md-tabs aria-label=Tabs data-md-component=tabs> <div class=md-grid> <ul class=md-tabs__list> <li class=md-tabs__item> <a href=../.. class=md-tabs__link> Overview </a> </li> <li class=md-tabs__item> <a href=../../demos/ class=md-tabs__link> Demos </a> </li> <li class=md-tabs__item> <a href=../../installation/ class=md-tabs__link> Installation </a> </li> <li class=md-tabs__item> <a href=../../known_limitations/ class=md-tabs__link> Known Limitations </a> </li> <li class=md-tabs__item> <a href=../../license/ class=md-tabs__link> License </a> </li> <li class=md-tabs__item> <a href=../../contributing/ class=md-tabs__link> Contributing </a> </li> <li class=md-tabs__item> <a href=../../plugins/fedramp/ class=md-tabs__link> Plugins </a> </li> <li class=md-tabs__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-tabs__link> Reference </a> </li> <li class="md-tabs__item md-tabs__item--active"> <a href=../cli/ class=md-tabs__link> Tutorials </a> </li> </ul> </div> </nav> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary md-nav--lifted" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title="Compliance Trestle" class="md-nav__button md-logo" aria-label="Compliance Trestle" data-md-component=logo> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg> </a> Compliance Trestle </label> <div class=md-nav__source> <a href=https://github.com/oscal-compass/compliance-trestle title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.7.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2024 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81"/></svg> </div> <div class=md-source__repository> oscal-compass/compliance-trestle </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../demos/ class=md-nav__link> <span class=md-ellipsis> Demos </span> </a> </li> <li class=md-nav__item> <a href=../../installation/ class=md-nav__link> <span class=md-ellipsis> Installation </span> </a> </li> <li class=md-nav__item> <a href=../../known_limitations/ class=md-nav__link> <span class=md-ellipsis> Known Limitations </span> </a> </li> <li class=md-nav__item> <a href=../../license/ class=md-nav__link> <span class=md-ellipsis> License </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_6> <label class=md-nav__link for=__nav_6 id=__nav_6_label tabindex=0> <span class=md-ellipsis> Contributing </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_6_label aria-expanded=false> <label class=md-nav__title for=__nav_6> <span class="md-nav__icon md-icon"></span> Contributing </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../contributing/ class=md-nav__link> <span class=md-ellipsis> Overview </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/code_of_conduct/ class=md-nav__link> <span class=md-ellipsis> Code of Conduct </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/oscal_object_model/ class=md-nav__link> <span class=md-ellipsis> OSCAL object model </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/website/ class=md-nav__link> <span class=md-ellipsis> Website development </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/plugins/ class=md-nav__link> <span class=md-ellipsis> Developing trestle plugins </span> </a> </li> <li class=md-nav__item> <a href=https://github.com/oscal-compass/compliance-trestle/graphs/contributors class=md-nav__link> <span class=md-ellipsis> Contributors </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/maintainers/ class=md-nav__link> <span class=md-ellipsis> Maintainers </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/DCO/ class=md-nav__link> <span class=md-ellipsis> Developer Certificate of Originality </span> </a> </li> <li class=md-nav__item> <a href=../../contributing/github_actions_setup/ class=md-nav__link> <span class=md-ellipsis> GitHub actions </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_7> <label class=md-nav__link for=__nav_7 id=__nav_7_label tabindex=0> <span class=md-ellipsis> Plugins </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_7_label aria-expanded=false> <label class=md-nav__title for=__nav_7> <span class="md-nav__icon md-icon"></span> Plugins </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../plugins/fedramp/ class=md-nav__link> <span class=md-ellipsis> FedRAMP plugin </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8> <label class=md-nav__link for=__nav_8 id=__nav_8_label tabindex=0> <span class=md-ellipsis> Reference </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_8_label aria-expanded=false> <label class=md-nav__title for=__nav_8> <span class="md-nav__icon md-icon"></span> Reference </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/third-party-result-schema-IBM-SCC/ class=md-nav__link> <span class=md-ellipsis> IBM SCC assessment results integration </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2> <label class=md-nav__link for=__nav_8_2 id=__nav_8_2_label tabindex=0> <span class=md-ellipsis> API </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_8_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2> <span class="md-nav__icon md-icon"></span> API </label> <ul class=md-nav__list data-md-scrollfix> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1> <label class=md-nav__link for=__nav_8_2_1 id=__nav_8_2_1_label tabindex=0> <span class=md-ellipsis> Trestle </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=3 aria-labelledby=__nav_8_2_1_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1> <span class="md-nav__icon md-icon"></span> Trestle </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/cli/ class=md-nav__link> <span class=md-ellipsis> trestle.cli </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_2> <label class=md-nav__link for=__nav_8_2_1_2 id=__nav_8_2_1_2_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_2_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_2> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/common/common_types/ class=md-nav__link> <span class=md-ellipsis> trestle.common.common_types </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/const/ class=md-nav__link> <span class=md-ellipsis> trestle.common.const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/err/ class=md-nav__link> <span class=md-ellipsis> trestle.common.err </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/file_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.file_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/list_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.list_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/load_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.common.load_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/log/ class=md-nav__link> <span class=md-ellipsis> trestle.common.log </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/model_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.model_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/str_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.str_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/trash/ class=md-nav__link> <span class=md-ellipsis> trestle.common.trash </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/common/type_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.common.type_utils </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3> <label class=md-nav__link for=__nav_8_2_1_3 id=__nav_8_2_1_3_label tabindex=0> <span class=md-ellipsis> Core </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_3_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3> <span class="md-nav__icon md-icon"></span> Core </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/all_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.all_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_context/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_context </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/docs_control_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.docs_control_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/draw_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.draw_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/duplicates_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.duplicates_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generators/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generators </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/generic_oscal/ class=md-nav__link> <span class=md-ellipsis> trestle.core.generic_oscal </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/links_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.links_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/object_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.object_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/parser/ class=md-nav__link> <span class=md-ellipsis> trestle.core.parser </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/pipeline/ class=md-nav__link> <span class=md-ellipsis> trestle.core.pipeline </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/plugins/ class=md-nav__link> <span class=md-ellipsis> trestle.core.plugins </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/profile_resolver/ class=md-nav__link> <span class=md-ellipsis> trestle.core.profile_resolver </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/refs_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.refs_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/repository/ class=md-nav__link> <span class=md-ellipsis> trestle.core.repository </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/rule_parameters_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.rule_parameters_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/ssp_io/ class=md-nav__link> <span class=md-ellipsis> trestle.core.ssp_io </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/trestle_base_model/ class=md-nav__link> <span class=md-ellipsis> trestle.core.trestle_base_model </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/validator_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.core.validator_factory </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_26> <label class=md-nav__link for=__nav_8_2_1_3_26 id=__nav_8_2_1_3_26_label tabindex=0> <span class=md-ellipsis> Catalog </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_26_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_26> <span class="md-nav__icon md-icon"></span> Catalog </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_merger/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_merger </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/catalog/catalog_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.catalog.catalog_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27> <label class=md-nav__link for=__nav_8_2_1_3_27 id=__nav_8_2_1_3_27_label tabindex=0> <span class=md-ellipsis> Commands </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_27_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27> <span class="md-nav__icon md-icon"></span> Commands </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/add/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.add </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/assemble/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.assemble </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/command_docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.command_docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/create/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.create </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/describe/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.describe </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/href/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.href </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/import_/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.import_ </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/init/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.init </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/partial_object_validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.partial_object_validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/remove/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.remove </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/replicate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.replicate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/split/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.split </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/task/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/validate/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.validate </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/version/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.version </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17> <label class=md-nav__link for=__nav_8_2_1_3_27_17 id=__nav_8_2_1_3_27_17_label tabindex=0> <span class=md-ellipsis> Author </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_17_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17> <span class="md-nav__icon md-icon"></span> Author </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/command/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.command </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/common/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/component/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/consts/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.consts </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/docs/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.docs </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/folders/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.folders </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/headers/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.headers </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/jinja/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.jinja </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/prof/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.prof </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.ssp </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_17_12> <label class=md-nav__link for=__nav_8_2_1_3_27_17_12 id=__nav_8_2_1_3_27_17_12_label tabindex=0> <span class=md-ellipsis> Versioning </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=7 aria-labelledby=__nav_8_2_1_3_27_17_12_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_17_12> <span class="md-nav__icon md-icon"></span> Versioning </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/author/versioning/template_versioning/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.author.versioning.template_versioning </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_27_18> <label class=md-nav__link for=__nav_8_2_1_3_27_18 id=__nav_8_2_1_3_27_18_label tabindex=0> <span class=md-ellipsis> Common </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=6 aria-labelledby=__nav_8_2_1_3_27_18_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_27_18> <span class="md-nav__icon md-icon"></span> Common </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/cmd_utils/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.cmd_utils </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/commands/common/return_codes/ class=md-nav__link> <span class=md-ellipsis> trestle.core.commands.common.return_codes </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_28> <label class=md-nav__link for=__nav_8_2_1_3_28 id=__nav_8_2_1_3_28_label tabindex=0> <span class=md-ellipsis> Crm </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_28_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_28> <span class="md-nav__icon md-icon"></span> Crm </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/bycomp_interface/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.bycomp_interface </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_reader/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_reader </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/export_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.export_writer </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/leveraged_statements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.leveraged_statements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/crm/ssp_inheritance_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.crm.ssp_inheritance_api </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_29> <label class=md-nav__link for=__nav_8_2_1_3_29 id=__nav_8_2_1_3_29_label tabindex=0> <span class=md-ellipsis> Jinja </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_29_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_29> <span class="md-nav__icon md-icon"></span> Jinja </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/base/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.base </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/ext/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.ext </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/filters/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.filters </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/jinja/tags/ class=md-nav__link> <span class=md-ellipsis> trestle.core.jinja.tags </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_30> <label class=md-nav__link for=__nav_8_2_1_3_30 id=__nav_8_2_1_3_30_label tabindex=0> <span class=md-ellipsis> Markdown </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_30_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_30> <span class="md-nav__icon md-icon"></span> Markdown </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/base_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.base_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/control_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.control_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/docs_markdown_node/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.docs_markdown_node </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_api/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_api </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_const/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_const </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_processor/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_processor </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/markdown_validator/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.markdown_validator </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/markdown/md_writer/ class=md-nav__link> <span class=md-ellipsis> trestle.core.markdown.md_writer </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_31> <label class=md-nav__link for=__nav_8_2_1_3_31 id=__nav_8_2_1_3_31_label tabindex=0> <span class=md-ellipsis> Models </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_31_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_31> <span class="md-nav__icon md-icon"></span> Models </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/actions/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.actions </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/elements/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.elements </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/file_content_type/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.file_content_type </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/interfaces/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.interfaces </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/models/plans/ class=md-nav__link> <span class=md-ellipsis> trestle.core.models.plans </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_32> <label class=md-nav__link for=__nav_8_2_1_3_32 id=__nav_8_2_1_3_32_label tabindex=0> <span class=md-ellipsis> Remote </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_32_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_32> <span class="md-nav__icon md-icon"></span> Remote </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/remote/cache/ class=md-nav__link> <span class=md-ellipsis> trestle.core.remote.cache </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_3_33> <label class=md-nav__link for=__nav_8_2_1_3_33 id=__nav_8_2_1_3_33_label tabindex=0> <span class=md-ellipsis> Resolver </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_3_33_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_3_33> <span class="md-nav__icon md-icon"></span> Resolver </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/merge/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.merge </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/modify/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.modify </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/core/resolver/prune/ class=md-nav__link> <span class=md-ellipsis> trestle.core.resolver.prune </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_4> <label class=md-nav__link for=__nav_8_2_1_4 id=__nav_8_2_1_4_label tabindex=0> <span class=md-ellipsis> Oscal </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_4_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_4> <span class="md-nav__icon md-icon"></span> Oscal </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_plan/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_plan </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/assessment_results/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.assessment_results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/common/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.common </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/component/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.component </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/poam/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.poam </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/profile/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/oscal/ssp/ class=md-nav__link> <span class=md-ellipsis> trestle.oscal.ssp </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_5> <label class=md-nav__link for=__nav_8_2_1_5 id=__nav_8_2_1_5_label tabindex=0> <span class=md-ellipsis> Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_5> <span class="md-nav__icon md-icon"></span> Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/base_task/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.base_task </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/cis_xlsx_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.cis_xlsx_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.csv_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_catalog </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/ocp4_cis_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.ocp4_cis_profile_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_catalog_to_csv/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_catalog_to_csv </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/oscal_profile_to_osco_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.oscal_profile_to_osco_profile </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/osco_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.osco_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.tanium_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/transform/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.transform </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xccdf_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xccdf_result_to_oscal_ar </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_cd </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/tasks/xlsx_to_oscal_profile/ class=md-nav__link> <span class=md-ellipsis> trestle.tasks.xlsx_to_oscal_profile </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6> <label class=md-nav__link for=__nav_8_2_1_6 id=__nav_8_2_1_6_label tabindex=0> <span class=md-ellipsis> Transforms </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=4 aria-labelledby=__nav_8_2_1_6_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6> <span class="md-nav__icon md-icon"></span> Transforms </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/results/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.results </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_factory/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_factory </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_helper/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_helper </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/transformer_singleton/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.transformer_singleton </span> </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_8_2_1_6_5> <label class=md-nav__link for=__nav_8_2_1_6_5 id=__nav_8_2_1_6_5_label tabindex=0> <span class=md-ellipsis> Implementations </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=5 aria-labelledby=__nav_8_2_1_6_5_label aria-expanded=false> <label class=md-nav__title for=__nav_8_2_1_6_5> <span class="md-nav__icon md-icon"></span> Implementations </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/osco/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.osco </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/tanium/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.tanium </span> </a> </li> <li class=md-nav__item> <a href=../../reference/API/trestle/transforms/implementations/xccdf/ class=md-nav__link> <span class=md-ellipsis> trestle.transforms.implementations.xccdf </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9 checked> <label class=md-nav__link for=__nav_9 id=__nav_9_label tabindex> <span class=md-ellipsis> Tutorials </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_9_label aria-expanded=true> <label class=md-nav__title for=__nav_9> <span class="md-nav__icon md-icon"></span> Tutorials </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../cli/ class=md-nav__link> <span class=md-ellipsis> trestle CLI Overview </span> </a> </li> <li class=md-nav__item> <a href=../compliance_posture/ class=md-nav__link> <span class=md-ellipsis> What's your compliance posture </span> </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> <span class=md-ellipsis> Introduction to trestle workflows </span> <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> <span class=md-ellipsis> Introduction to trestle workflows </span> </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-create-a-trestle-workspace-if-you-dont-have-one-already class=md-nav__link> <span class=md-ellipsis> Step 1: Create a trestle workspace if you don't have one already </span> </a> </li> <li class=md-nav__item> <a href=#step-2-import-a-catalog-from-the-trestle-sample-data-directory-into-your-trestle-workspace class=md-nav__link> <span class=md-ellipsis> Step 2: Import a catalog from the trestle sample data directory into your trestle workspace </span> </a> </li> <li class=md-nav__item> <a href=#step-3-split-the-file-into-smaller-parts class=md-nav__link> <span class=md-ellipsis> Step 3: Split the file into smaller parts </span> </a> </li> <li class=md-nav__item> <a href=#step-4-split-the-metadata-into-constituent-files class=md-nav__link> <span class=md-ellipsis> Step 4: Split the metadata into constituent files </span> </a> </li> <li class=md-nav__item> <a href=#step-5-split-metadata-further-using-wildcards class=md-nav__link> <span class=md-ellipsis> Step 5: Split metadata further using wildcards </span> </a> </li> <li class=md-nav__item> <a href=#step-6-split-groups-and-controls-with-two-wildcards class=md-nav__link> <span class=md-ellipsis> Step 6: Split groups and controls with two wildcards </span> </a> </li> <li class=md-nav__item> <a href=#step-7-collapse-the-entire-directory-structure-back-into-a-single-catalogjson-file-possibly-after-modifying-individual-files class=md-nav__link> <span class=md-ellipsis> Step 7: Collapse the entire directory structure back into a single catalog.json file - possibly after modifying individual files </span> </a> </li> <li class=md-nav__item> <a href=#conclusion class=md-nav__link> <span class=md-ellipsis> Conclusion </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_4> <label class=md-nav__link for=__nav_9_4 id=__nav_9_4_label tabindex=0> <span class=md-ellipsis> Transformers and Tasks </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_4_label aria-expanded=false> <label class=md-nav__title for=__nav_9_4> <span class="md-nav__icon md-icon"></span> Transformers and Tasks </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_catalog/ class=md-nav__link> <span class=md-ellipsis> ComplianceAsCode profiles to OSCAL catalog </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/OCP4_CIS_profile_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting ComplianceAsCode profiles to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/Tanium_result_to_oscal_ar/ class=md-nav__link> <span class=md-ellipsis> Coverting Tanium results to OSCAL </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/csv_to_oscal_cd/ class=md-nav__link> <span class=md-ellipsis> Converting CSVs to component definitions </span> </a> </li> <li class=md-nav__item> <a href=../Transformers_and_Tasks/transformer_construction/ class=md-nav__link> <span class=md-ellipsis> Posture format with OSCAL assesment results </span> </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_9_5> <label class=md-nav__link for=__nav_9_5 id=__nav_9_5_label tabindex=0> <span class=md-ellipsis> Trestle authoring </span> <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=2 aria-labelledby=__nav_9_5_label aria-expanded=false> <label class=md-nav__title for=__nav_9_5> <span class="md-nav__icon md-icon"></span> Trestle authoring </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../Trestle_authoring/ssp_profile_catalog_authoring/ class=md-nav__link> <span class=md-ellipsis> Tutorial: Catalog, Profile, ComponentDefinition, and SSP Authoring </span> </a> </li> <li class=md-nav__item> <a href=../Trestle_authoring/trestle_author/ class=md-nav__link> <span class=md-ellipsis> Governance of Authored Documents </span> </a> </li> <li class=md-nav__item> <a href=../Trestle_authoring/trestle_author_jinja/ class=md-nav__link> <span class=md-ellipsis> Output templating with trestle author jinja </span> </a> </li> </ul> </nav> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#objective class=md-nav__link> <span class=md-ellipsis> Objective </span> </a> </li> <li class=md-nav__item> <a href=#step-1-create-a-trestle-workspace-if-you-dont-have-one-already class=md-nav__link> <span class=md-ellipsis> Step 1: Create a trestle workspace if you don't have one already </span> </a> </li> <li class=md-nav__item> <a href=#step-2-import-a-catalog-from-the-trestle-sample-data-directory-into-your-trestle-workspace class=md-nav__link> <span class=md-ellipsis> Step 2: Import a catalog from the trestle sample data directory into your trestle workspace </span> </a> </li> <li class=md-nav__item> <a href=#step-3-split-the-file-into-smaller-parts class=md-nav__link> <span class=md-ellipsis> Step 3: Split the file into smaller parts </span> </a> </li> <li class=md-nav__item> <a href=#step-4-split-the-metadata-into-constituent-files class=md-nav__link> <span class=md-ellipsis> Step 4: Split the metadata into constituent files </span> </a> </li> <li class=md-nav__item> <a href=#step-5-split-metadata-further-using-wildcards class=md-nav__link> <span class=md-ellipsis> Step 5: Split metadata further using wildcards </span> </a> </li> <li class=md-nav__item> <a href=#step-6-split-groups-and-controls-with-two-wildcards class=md-nav__link> <span class=md-ellipsis> Step 6: Split groups and controls with two wildcards </span> </a> </li> <li class=md-nav__item> <a href=#step-7-collapse-the-entire-directory-structure-back-into-a-single-catalogjson-file-possibly-after-modifying-individual-files class=md-nav__link> <span class=md-ellipsis> Step 7: Collapse the entire directory structure back into a single catalog.json file - possibly after modifying individual files </span> </a> </li> <li class=md-nav__item> <a href=#conclusion class=md-nav__link> <span class=md-ellipsis> Conclusion </span> </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <h1 id=tutorial-introduction-to-trestle-workflow>Tutorial: Introduction to trestle workflow<a class=headerlink href=#tutorial-introduction-to-trestle-workflow title="Permanent link">¤</a></h1> <p>Here are step-by-step instructions to manipulate a <a href=https://www.nist.gov/ >NIST</a> standard <a href=https://pages.nist.gov/OSCAL/ >OSCAL</a> catalog using the <a href=https://oscal-compass.github.io/compliance-trestle/ >compliance-trestle</a> (<code>"trestle"</code>) tool.</p> <h2 id=objective><em>Objective</em><a class=headerlink href=#objective title="Permanent link">¤</a></h2> <p>Learn how to split and merge an OSCAL catalog json file using trestle commands and its command line interface (CLI). Trestle simplifies the manipulation and management of large OSCAL documents by allowing controlled deconstruction into smaller components, and later reconstruction after editing those components. And all operations guarantee that the individual files conform to the corresponding OSCAL schema to maintain integrity of the document in the process.</p> <p>This tutorial assumes you have installed Python and installed trestle in a virtual environment per the directions found <a href=../../installation/ >here</a>.</p> <p>The examples shown will work for linux and mac, but Windows will require the following modifications:</p> <ul> <li>use backslashes `\` for file paths (this is optional in most cases) <li>use copy instead of cp (unless you have cp installed) <li>use md instead of mkdir (unless you have mkdir installed) <li>quotes (') are often not needed unless the text includes spaces, but if quotes are needed they should be double quotes (") </ul> <p>Commands are shown without prompts so they are easy to cut and paste, and responses by trestle are shown with &gt;&gt;&gt; at the start of the line. In actual usage the &gt;&gt;&gt; would not appear.</p> <p>Be sure to include the quotes (' ') as shown in the examples, e.g. <code>merge -e 'catalog.*'</code> [On windows you should probably use double quotes (") as needed.]</p> <p>In this tutorial you will see sections that contain dropdown that is revealed when you click on them. Below is an example ("Like this"). Be sure to click on those sections to see their contents - and then close them if you like.</p> <p><br></p> <details> <summary>Like this</summary> <div class=highlight><pre><span></span><code>more
+information
+in
+here
+</code></pre></div> </details> <p><br></p> <h2 id=step-1-create-a-trestle-workspace-if-you-dont-have-one-already>Step 1: Create a trestle workspace if you don't have one already<a class=headerlink href=#step-1-create-a-trestle-workspace-if-you-dont-have-one-already title="Permanent link">¤</a></h2> <div class=highlight><pre><span></span><code>mkdir<span class=w> </span>my_workspace
+<span class=nb>cd</span><span class=w> </span>my_workspace
+trestle<span class=w> </span>init
+&gt;&gt;&gt;<span class=w> </span>Initialized<span class=w> </span>trestle<span class=w> </span>project<span class=w> </span>successfully<span class=w> </span><span class=k>in</span><span class=w> </span><span class=o>[</span>user_path<span class=o>]</span>/my_workspace
+</code></pre></div> <h2 id=step-2-import-a-catalog-from-the-trestle-sample-data-directory-into-your-trestle-workspace>Step 2: Import a catalog from the trestle sample data directory into your trestle workspace<a class=headerlink href=#step-2-import-a-catalog-from-the-trestle-sample-data-directory-into-your-trestle-workspace title="Permanent link">¤</a></h2> <p>For this tutorial we will use a catalog file from NIST, but we first must <code>import</code> it into the trestle workspace. This can be done either by first downloading the file locally and then importing it, or you can download it directly using its url address.</p> <p>We will import the file directly from the <a href=https://github.com/usnistgov/OSCAL>NIST OSCAL github site</a>. The specific catalog is <a href=https://raw.githubusercontent.com/usnistgov/oscal-content/master/nist.gov/SP800-53/rev5/json/NIST_SP-800-53_rev5_catalog.json>NIST_SP-800-53_rev5_catalog.json</a></p> <p>Import the file from the url with the following command:</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>import<span class=w> </span>-f<span class=w> </span>https://raw.githubusercontent.com/usnistgov/oscal-content/master/nist.gov/SP800-53/rev5/json/NIST_SP-800-53_rev5_catalog.json<span class=w> </span>-o<span class=w> </span>mycatalog
+</code></pre></div> <p>As a reminder, you could also have imported the file from a local directory on your file system, or an sftp:// address. But the file must first be imported to the trestle workspace in order for it to be directly manipulated by trestle as in this tutorial.</p> <p>The <code>import</code> command will also check the validity of the file including the presence of any duplicate uuid's. If the file is manually created please be sure it conforms with the current OSCAL schema (OSCAL version 1.0.4) and has no defined uuid's that are duplicates. If there are any errors the Import will fail and the file must be corrected.</p> <p><br></p> <details> <summary>Your initial workspace will look like this</summary> <div class=highlight><pre><span></span><code>my_workspace
+ ┣ .trestle
+ ┃ ┣ .keep
+ ┃ ┗ config.ini
+ ┣ assessment-plans
+ ┃ ┗ .keep
+ ┣ assessment-results
+ ┃ ┗ .keep
+ ┣ catalogs
+ ┃ ┣ mycatalog
+ ┃ ┃ ┗ catalog.json
+ ┃ ┗ .keep
+ ┣ component-definitions
+ ┃ ┗ .keep
+ ┣ dist
+ ┃ ┣ assessment-plans
+ ┃ ┃ ┗ .keep
+ ┃ ┣ assessment-results
+ ┃ ┃ ┗ .keep
+ ┃ ┣ catalogs
+ ┃ ┃ ┗ .keep
+ ┃ ┣ component-definitions
+ ┃ ┃ ┗ .keep
+ ┃ ┣ plan-of-action-and-milestones
+ ┃ ┃ ┗ .keep
+ ┃ ┣ profiles
+ ┃ ┃ ┗ .keep
+ ┃ ┣ system-security-plans
+ ┃ ┃ ┗ .keep
+ ┃ ┗ target-definitions
+ ┃ ┃ ┗ .keep
+ ┣ plan-of-action-and-milestones
+ ┃ ┗ .keep
+ ┣ profiles
+ ┃ ┗ .keep
+ ┣ system-security-plans
+ ┃ ┗ .keep
+ ┗ target-definitions
+ ┃ ┗ .keep
+</code></pre></div> </details> <p><br></p> <p>You will see that the directory now shows your catalog file in <code>my_workspace/catalogs/mycatalog/catalog.json</code>. Note that the <code>.keep</code> files are simply to make sure git does not remove the directories - and can be ignored. Also note that the json file itself is <em>singular</em> (catalog) while the directory above is plural (catalogs). This convention is used throughout trestle because a given model directory like catalogs may contain several individual models - each of which is singular. The imported catalog file size may be larger than the original due to a change in formatting, but the contents should be the same.</p> <p>From here on in this tutorial we will just focus on the catalogs directory since the others are not directly involved.</p> <p>You have now populated your trestle workspace with an OSCAL catalog that you can manipulate. Let's start.</p> <h2 id=step-3-split-the-file-into-smaller-parts>Step 3: Split the file into smaller parts<a class=headerlink href=#step-3-split-the-file-into-smaller-parts title="Permanent link">¤</a></h2> <p>The OSCAL schema specifies that a catalog must contain metadata, groups, and back-matter - so this command will pull them out of the original file and place them in separate json files for additional manipulations.</p> <p>To begin splitting the file, first cd to the directory where <code>catalog.json</code> has been placed.</p> <div class=highlight><pre><span></span><code><span class=nb>cd</span><span class=w> </span>catalogs/mycatalog
+trestle<span class=w> </span>split<span class=w> </span>-f<span class=w> </span>./catalog.json<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;catalog.metadata,catalog.groups,catalog.back-matter&#39;</span>
+</code></pre></div> <p>Here the <code>-f</code> refers to the filename of the json catalog file, and <code>-e</code> refers to the comma-separated list of <code>elements</code> you would like to split from the file. This list does not represent the full file contents of the source <code>catalog.json</code> file, so some contents will be left behind in a much smaller <code>catalog.json</code> file after the split. The elements that were split off will be placed in separate json files next to the new and smaller <code>catalog.json</code> file.</p> <p><br></p> <details> <summary>Your new catalogs directory with json files split out</summary> <div class=highlight><pre><span></span><code>catalogs
+ ┗ mycatalog
+ ┃ ┣ catalog
+ ┃ ┃ ┣ back-matter.json
+ ┃ ┃ ┣ groups.json
+ ┃ ┃ ┗ metadata.json
+ ┃ ┗ catalog.json
+</code></pre></div> </details> <p><br></p> <p>Note there still remains a catalog.json file, but it is much smaller since the bulk of its contents have been split off.</p> <p>Any split step can be reversed by a corresponding <code>merge</code> operation. In this case we can go backwards with:</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>merge<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;catalog.metadata,catalog.groups,catalog.back-matter&#39;</span>
+</code></pre></div> <p>or simply</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>merge<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;catalog.*&#39;</span>
+</code></pre></div> <p>You can go back and forth splitting and merging, but for the next step please start with the above files split so that <code>metadata.json</code> can be further split.</p> <h2 id=step-4-split-the-metadata-into-constituent-files>Step 4: Split the metadata into constituent files<a class=headerlink href=#step-4-split-the-metadata-into-constituent-files title="Permanent link">¤</a></h2> <div class=highlight><pre><span></span><code><span class=nb>cd</span><span class=w> </span>catalog
+trestle<span class=w> </span>split<span class=w> </span>-f<span class=w> </span>./metadata.json<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;metadata.roles,metadata.parties,metadata.responsible-parties&#39;</span>
+</code></pre></div> <p><br></p> <details> <summary>The directory will now look like this, with metadata split into files</summary> <div class=highlight><pre><span></span><code>catalogs
+ ┗ mycatalog
+ ┃ ┣ catalog
+ ┃ ┃ ┣ metadata
+ ┃ ┃ ┃ ┣ parties.json
+ ┃ ┃ ┃ ┣ responsible-parties.json
+ ┃ ┃ ┃ ┗ roles.json
+ ┃ ┃ ┣ back-matter.json
+ ┃ ┃ ┣ groups.json
+ ┃ ┃ ┗ metadata.json
+ ┃ ┗ catalog.json
+</code></pre></div> </details> <p><br></p> <p>Again there remains a metadata.json file but it is smaller than the original.</p> <p>And this step can be reversed with the following:</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>merge<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;metadata.roles,metadata.parties,metadata.responsible-parties&#39;</span>
+</code></pre></div> <p>or simply</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>merge<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;metadata.*&#39;</span>
+</code></pre></div> <h2 id=step-5-split-metadata-further-using-wildcards>Step 5: Split metadata further using wildcards<a class=headerlink href=#step-5-split-metadata-further-using-wildcards title="Permanent link">¤</a></h2> <div class=highlight><pre><span></span><code><span class=nb>cd</span><span class=w> </span>metadata
+trestle<span class=w> </span>split<span class=w> </span>-f<span class=w> </span>./roles.json<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;roles.*&#39;</span>
+trestle<span class=w> </span>split<span class=w> </span>-f<span class=w> </span>./responsible-parties.json<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;responsible-parties.*&#39;</span>
+</code></pre></div> <p><br></p> <details> <summary>The directory now looks like this, with new subdirectories containing multiple roles and responsible-parties</summary> <div class=highlight><pre><span></span><code>catalogs
+ ┗ mycatalog
+ ┃ ┣ catalog
+ ┃ ┃ ┣ metadata
+ ┃ ┃ ┃ ┣ responsible-parties
+ ┃ ┃ ┃ ┃ ┣ contact__responsible-party.json
+ ┃ ┃ ┃ ┃ ┗ creator__responsible-party.json
+ ┃ ┃ ┃ ┣ roles
+ ┃ ┃ ┃ ┃ ┣ 00000__role.json
+ ┃ ┃ ┃ ┃ ┗ 00001__role.json
+ ┃ ┃ ┃ ┗ parties.json
+ ┃ ┃ ┣ back-matter.json
+ ┃ ┃ ┣ groups.json
+ ┃ ┃ ┗ metadata.json
+ ┃ ┗ catalog.json
+</code></pre></div> </details> <p><br></p> <p>Note that the presence of wildcards caused new directories to be created containing the full lists of roles and responsible parties. You can read the wildcard as <em>split off </em><em>all</em><em> roles</em> from <code>roles.json</code>.</p> <p>This split can be reversed with</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>merge<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;roles.*,responsible-parties.*&#39;</span>
+</code></pre></div> <h2 id=step-6-split-groups-and-controls-with-two-wildcards>Step 6: Split groups and controls with two wildcards<a class=headerlink href=#step-6-split-groups-and-controls-with-two-wildcards title="Permanent link">¤</a></h2> <p>This single command will split off <em>all</em> controls in <em>all</em> groups. To do it you need to go back up into the catalog directory where the <code>groups.json</code> file is found:</p> <div class=highlight><pre><span></span><code><span class=nb>cd</span><span class=w> </span>..
+trestle<span class=w> </span>split<span class=w> </span>-f<span class=w> </span>./groups.json<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;groups.*.controls.*&#39;</span>
+</code></pre></div> <p><br></p> <details> <summary>Your directory is now very large with that one command!</summary> <div class=highlight><pre><span></span><code>catalogs
+ ┗ mycatalog
+ ┃ ┣ catalog
+ ┃ ┃ ┣ groups
+ ┃ ┃ ┃ ┣ 00000__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00011__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00012__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00013__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00014__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00015__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00016__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00017__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00018__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00019__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00020__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00021__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00022__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00023__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00024__control.json
+ ┃ ┃ ┃ ┣ 00001__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00005__control.json
+ ┃ ┃ ┃ ┣ 00002__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00011__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00012__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00013__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00014__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00015__control.json
+ ┃ ┃ ┃ ┣ 00003__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00008__control.json
+ ┃ ┃ ┃ ┣ 00004__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00011__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00012__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00013__control.json
+ ┃ ┃ ┃ ┣ 00005__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00011__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00012__control.json
+ ┃ ┃ ┃ ┣ 00006__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00011__control.json
+ ┃ ┃ ┃ ┣ 00007__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00009__control.json
+ ┃ ┃ ┃ ┣ 00008__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00006__control.json
+ ┃ ┃ ┃ ┣ 00009__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00007__control.json
+ ┃ ┃ ┃ ┣ 00010__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00011__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00012__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00013__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00014__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00015__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00016__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00017__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00018__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00019__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00020__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00021__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00022__control.json
+ ┃ ┃ ┃ ┣ 00011__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00010__control.json
+ ┃ ┃ ┃ ┣ 00012__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00011__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00012__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00013__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00014__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00015__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00016__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00017__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00018__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00019__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00020__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00021__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00022__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00023__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00024__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00025__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00026__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00027__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00028__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00029__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00030__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00031__control.json
+ ┃ ┃ ┃ ┣ 00013__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00008__control.json
+ ┃ ┃ ┃ ┣ 00014__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00007__control.json
+ ┃ ┃ ┃ ┣ 00015__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00009__control.json
+ ┃ ┃ ┃ ┣ 00016__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00011__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00012__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00013__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00014__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00015__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00016__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00017__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00018__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00019__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00020__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00021__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00022__control.json
+ ┃ ┃ ┃ ┣ 00017__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00011__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00012__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00013__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00014__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00015__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00016__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00017__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00018__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00019__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00020__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00021__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00022__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00023__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00024__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00025__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00026__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00027__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00028__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00029__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00030__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00031__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00032__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00033__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00034__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00035__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00036__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00037__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00038__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00039__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00040__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00041__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00042__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00043__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00044__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00045__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00046__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00047__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00048__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00049__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00050__control.json
+ ┃ ┃ ┃ ┣ 00018__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00011__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00012__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00013__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00014__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00015__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00016__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00017__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00018__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00019__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00020__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00021__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00022__control.json
+ ┃ ┃ ┃ ┣ 00019__group
+ ┃ ┃ ┃ ┃ ┗ controls
+ ┃ ┃ ┃ ┃ ┃ ┣ 00000__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00001__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00002__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00003__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00004__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00005__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00006__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00007__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00008__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00009__control.json
+ ┃ ┃ ┃ ┃ ┃ ┣ 00010__control.json
+ ┃ ┃ ┃ ┃ ┃ ┗ 00011__control.json
+ ┃ ┃ ┃ ┣ 00000__group.json
+ ┃ ┃ ┃ ┣ 00001__group.json
+ ┃ ┃ ┃ ┣ 00002__group.json
+ ┃ ┃ ┃ ┣ 00003__group.json
+ ┃ ┃ ┃ ┣ 00004__group.json
+ ┃ ┃ ┃ ┣ 00005__group.json
+ ┃ ┃ ┃ ┣ 00006__group.json
+ ┃ ┃ ┃ ┣ 00007__group.json
+ ┃ ┃ ┃ ┣ 00008__group.json
+ ┃ ┃ ┃ ┣ 00009__group.json
+ ┃ ┃ ┃ ┣ 00010__group.json
+ ┃ ┃ ┃ ┣ 00011__group.json
+ ┃ ┃ ┃ ┣ 00012__group.json
+ ┃ ┃ ┃ ┣ 00013__group.json
+ ┃ ┃ ┃ ┣ 00014__group.json
+ ┃ ┃ ┃ ┣ 00015__group.json
+ ┃ ┃ ┃ ┣ 00016__group.json
+ ┃ ┃ ┃ ┣ 00017__group.json
+ ┃ ┃ ┃ ┣ 00018__group.json
+ ┃ ┃ ┃ ┗ 00019__group.json
+ ┃ ┃ ┣ metadata
+ ┃ ┃ ┃ ┣ responsible-parties
+ ┃ ┃ ┃ ┃ ┣ contact__responsible-party.json
+ ┃ ┃ ┃ ┃ ┗ creator__responsible-party.json
+ ┃ ┃ ┃ ┣ roles
+ ┃ ┃ ┃ ┃ ┣ 00000__role.json
+ ┃ ┃ ┃ ┃ ┗ 00001__role.json
+ ┃ ┃ ┃ ┗ parties.json
+ ┃ ┃ ┣ back-matter.json
+ ┃ ┃ ┗ metadata.json
+ ┃ ┗ catalog.json
+</code></pre></div> </details> <p><br></p> <p>All 20 groups of controls have been split off, and each one has a corresponding directory with its full list of controls in it.</p> <p>You can then reverse the split with</p> <div class=highlight><pre><span></span><code>trestle<span class=w> </span>merge<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;groups.*&#39;</span>
+</code></pre></div> <h2 id=step-7-collapse-the-entire-directory-structure-back-into-a-single-catalogjson-file-possibly-after-modifying-individual-files>Step 7: Collapse the entire directory structure back into a single <code>catalog.json</code> file - possibly after modifying individual files<a class=headerlink href=#step-7-collapse-the-entire-directory-structure-back-into-a-single-catalogjson-file-possibly-after-modifying-individual-files title="Permanent link">¤</a></h2> <p>You can collapse everything back to a single <code>catalog.json</code> file after first going up one directory to the mycatalog directory</p> <div class=highlight><pre><span></span><code><span class=nb>cd</span><span class=w> </span>..
+trestle<span class=w> </span>merge<span class=w> </span>-e<span class=w> </span><span class=s1>&#39;catalog.*&#39;</span>
+</code></pre></div> <p><br></p> <details> <summary>After all that splitting and merging you are back to this directory structure</summary> <div class=highlight><pre><span></span><code>catalogs
+ ┗ mycatalog
+ ┃ ┗ catalog.json
+</code></pre></div> </details> <p><br></p> <h2 id=conclusion>Conclusion<a class=headerlink href=#conclusion title="Permanent link">¤</a></h2> <p>This completes the tutorial on using <code>trestle</code> to split and merge an OSCAL catalog file. Not shown here are modifications of the individual files that would be done in an actual use case, but note that if any changes are made that violate the OSCAL schema, <code>trestle</code> will notice them and flag them in the merge. This way not only does <code>trestle</code> allow user-driven decomposition and aggregation of these large, complex files; it also does constant checks on the contents against the required schema to make sure no errors are introduced in the process.</p> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">December 19, 2023</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <div class=md-consent data-md-component=consent id=__consent hidden> <div class=md-consent__overlay></div> <aside class=md-consent__inner> <form class="md-consent__form md-grid md-typeset" name=consent> <h4>Cookie consent</h4> <p>We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.</p> <input class=md-toggle type=checkbox id=__settings> <div class=md-consent__settings> <ul class=task-list> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=analytics checked> <span class=task-list-indicator></span> Google Analytics </label> </li> <li class=task-list-item> <label class=task-list-control> <input type=checkbox name=github checked> <span class=task-list-indicator></span> GitHub </label> </li> </ul> </div> <div class=md-consent__controls> <button class="md-button md-button--primary">Accept</button> <label class=md-button for=__settings>Manage settings</label> </div> </form> </aside> </div> <script>var consent=__md_get("__consent");if(consent)for(var input of document.forms.consent.elements)input.name&&(input.checked=consent[input.name]||!1);else"file:"!==location.protocol&&setTimeout((function(){document.querySelector("[data-md-component=consent]").hidden=!1}),250);var form=document.forms.consent;for(var action of["submit","reset"])form.addEventListener(action,(function(e){if(e.preventDefault(),"reset"===e.type)for(var n of document.forms.consent.elements)n.name&&(n.checked=!1);__md_set("__consent",Object.fromEntries(Array.from(new FormData(form).keys()).map((function(e){return[e,!0]})))),location.hash="",location.reload()}))</script> <script id=__config type=application/json>{"base": "../..", "features": ["content.code.annotate", "navigation.tabs"], "search": "../../assets/javascripts/workers/search.6ce7567c.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.83f73b43.min.js></script> </body> </html>
\ No newline at end of file
diff --git a/versions.json b/versions.json
new file mode 100644
index 000000000..497f517f2
--- /dev/null
+++ b/versions.json
@@ -0,0 +1,7 @@
+[
+  {
+    "version": "latest",
+    "title": "latest",
+    "aliases": []
+  }
+]